diff --git a/.travis.yml b/.travis.yml
index 729ad08c2c1..98d5f989f74 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -11,4 +11,8 @@ install:
   - npm install gitbook-cli -g
   - gitbook install
 
-script: gitbook build
\ No newline at end of file
+script: gitbook build
+
+branches:
+  except:
+  - crowdin_master
diff --git a/am-ET/GLOSSARY.md b/am-ET/GLOSSARY.md
new file mode 100644
index 00000000000..7f93ea7643a
--- /dev/null
+++ b/am-ET/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+''ኮድ አስተካካይ ማለት ምልክቶችን ለኋላ ጥቅም ለማዋል የሚረዳ መተግበሪያ ነው''. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/am-ET/README.md b/am-ET/README.md
new file mode 100644
index 00000000000..121da8f55bf
--- /dev/null
+++ b/am-ET/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/am-ET/SUMMARY.md b/am-ET/SUMMARY.md
new file mode 100644
index 00000000000..d9741b4f21c
--- /dev/null
+++ b/am-ET/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/am-ET/chromebook_setup/README.md b/am-ET/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/am-ET/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/am-ET/chromebook_setup/instructions.md b/am-ET/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..2df2048e6ec
--- /dev/null
+++ b/am-ET/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/am-ET/code_editor/README.md b/am-ET/code_editor/README.md
new file mode 100644
index 00000000000..0a401fb1f52
--- /dev/null
+++ b/am-ET/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/am-ET/code_editor/instructions.md b/am-ET/code_editor/instructions.md
new file mode 100644
index 00000000000..82fbac15aad
--- /dev/null
+++ b/am-ET/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/am-ET/css/README.md b/am-ET/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/am-ET/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/am-ET/deploy/README.md b/am-ET/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/am-ET/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/am-ET/deploy/install_git.md b/am-ET/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/am-ET/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/am-ET/deploy/signup_pythonanywhere.md b/am-ET/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/am-ET/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/am-ET/django/README.md b/am-ET/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/am-ET/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/am-ET/django_admin/README.md b/am-ET/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/am-ET/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/am-ET/django_forms/README.md b/am-ET/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/am-ET/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/am-ET/django_installation/README.md b/am-ET/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/am-ET/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/am-ET/django_installation/instructions.md b/am-ET/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/am-ET/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/am-ET/django_models/README.md b/am-ET/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/am-ET/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/am-ET/django_orm/README.md b/am-ET/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/am-ET/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/am-ET/django_start_project/README.md b/am-ET/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/am-ET/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/am-ET/django_templates/README.md b/am-ET/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/am-ET/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/am-ET/django_urls/README.md b/am-ET/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/am-ET/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/am-ET/django_views/README.md b/am-ET/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/am-ET/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/am-ET/dynamic_data_in_templates/README.md b/am-ET/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/am-ET/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/am-ET/extend_your_application/README.md b/am-ET/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/am-ET/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/am-ET/how_the_internet_works/README.md b/am-ET/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/am-ET/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/am-ET/html/README.md b/am-ET/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/am-ET/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/am-ET/installation/README.md b/am-ET/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/am-ET/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/am-ET/intro_to_command_line/README.md b/am-ET/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/am-ET/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/am-ET/intro_to_command_line/open_instructions.md b/am-ET/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/am-ET/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/am-ET/python_installation/README.md b/am-ET/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/am-ET/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/am-ET/python_installation/instructions.md b/am-ET/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/am-ET/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/am-ET/python_introduction/README.md b/am-ET/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/am-ET/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/am-ET/template_extending/README.md b/am-ET/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/am-ET/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/am-ET/whats_next/README.md b/am-ET/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/am-ET/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/am/GLOSSARY.md b/am/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/am/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/am/README.md b/am/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/am/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/am/SUMMARY.md b/am/SUMMARY.md
new file mode 100644
index 00000000000..7a45700a27d
--- /dev/null
+++ b/am/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/am/chromebook_setup/README.md b/am/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/am/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/am/chromebook_setup/instructions.md b/am/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/am/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/am/code_editor/README.md b/am/code_editor/README.md
new file mode 100644
index 00000000000..404011f1b7d
--- /dev/null
+++ b/am/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/am/code_editor/instructions.md b/am/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/am/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/am/css/README.md b/am/css/README.md
new file mode 100644
index 00000000000..04d5996ae52
--- /dev/null
+++ b/am/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/am/deploy/README.md b/am/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/am/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/am/deploy/install_git.md b/am/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/am/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/am/deploy/signup_pythonanywhere.md b/am/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/am/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/am/django/README.md b/am/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/am/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/am/django_admin/README.md b/am/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/am/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/am/django_forms/README.md b/am/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/am/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/am/django_installation/README.md b/am/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/am/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/am/django_installation/instructions.md b/am/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/am/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/am/django_models/README.md b/am/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/am/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/am/django_orm/README.md b/am/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/am/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/am/django_start_project/README.md b/am/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/am/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/am/django_templates/README.md b/am/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/am/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/am/django_urls/README.md b/am/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/am/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/am/django_views/README.md b/am/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/am/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/am/dynamic_data_in_templates/README.md b/am/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/am/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/am/extend_your_application/README.md b/am/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/am/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/am/how_the_internet_works/README.md b/am/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/am/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/am/html/README.md b/am/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/am/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/am/install_git.md b/am/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/am/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/am/installation/README.md b/am/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/am/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/am/instructions.md b/am/instructions.md
new file mode 100644
index 00000000000..30bd493b11b
--- /dev/null
+++ b/am/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command dnf is not found. In that case you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/am/intro_to_command_line/README.md b/am/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/am/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/am/python_installation/README.md b/am/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/am/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/am/python_installation/instructions.md b/am/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/am/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/am/python_introduction/README.md b/am/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/am/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/am/signup_pythonanywhere.md b/am/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/am/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/am/template_extending/README.md b/am/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/am/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/am/whats_next/README.md b/am/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/am/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/ar-SA/GLOSSARY.md b/ar-SA/GLOSSARY.md
new file mode 100644
index 00000000000..5857b137396
--- /dev/null
+++ b/ar-SA/GLOSSARY.md
@@ -0,0 +1,3 @@
+# محرر الكود
+
+محرر الكود هو التطبيق الذي يسمح لك بحفظ التعليمات البرمجية الخاصة بك بحيث تكون قادر على العودة إليها في وقت لاحق. ويمكنك معرفة أين يمكن الحصول على واحد من الفصل الخاص [بمحرر الكود](./code_editor/README.md)
\ No newline at end of file
diff --git a/ar-SA/README.md b/ar-SA/README.md
new file mode 100644
index 00000000000..76bf2808dc3
--- /dev/null
+++ b/ar-SA/README.md
@@ -0,0 +1,51 @@
+# الدليل التطبيقي Django Girls
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> تم ترخيص هذا العمل تحت نَسب المُصنَّف - غير تجاري - الترخيص بالمثل 4.0 بموجب ترخيص المشاع الإبداعي الدولي. لعرض نسخة من هذا الترخيص، تفضلوا بزيارة 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).
+
+في كل فصل تم تغطيته، هناك ارتباط يشير إلى الفيديو الصحيح.
+
+## عن Django Girls والمساهمة
+
+هذا الدليل التعليمي يدار بواسطة [DjangoGirls](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) لإضافتها.
\ No newline at end of file
diff --git a/ar-SA/SUMMARY.md b/ar-SA/SUMMARY.md
new file mode 100644
index 00000000000..819c808e85a
--- /dev/null
+++ b/ar-SA/SUMMARY.md
@@ -0,0 +1,35 @@
+# الملخص
+
+* [المقدمة](README.md)
+* [التثبيت](installation/README.md) 
+  * [سطر الأوامر](installation/README.md#command-line)
+  * [بايثون](installation/README.md#python)
+  * [محرر الكود](installation/README.md#code-editor)
+  * [البيئة الإفتراضية](installation/README.md#virtualenv)
+  * [جانغو](installation/README.md#django)
+  * [جيت (Git)](installation/README.md#git)
+  * [جيتهاب (GitHub)](installation/README.md#github-account)
+  * [بايثون في كل مكان](installation/README.md#pythonanywhere-account)
+* [التثبيت (كروم بوك)](chromebook_setup/README.md)
+* [كيف يعمل الإنترنت](how_the_internet_works/README.md)
+* [مقدمة لسطر الأوامر](intro_to_command_line/README.md)
+* [تركيب بايثون](python_installation/README.md)
+* [محرر الكود](code_editor/README.md)
+* [مقدمة إلى بايثون](python_introduction/README.md)
+* [ما هو جانغو؟](django/README.md)
+* [تركيب جانغو](django_installation/README.md)
+* [مشروعك الأول في جانغو!](django_start_project/README.md)
+* [نماذج جانغو](django_models/README.md)
+* [مشرف جانغو](django_admin/README.md)
+* [الإعداد!](deploy/README.md)
+* [روابط جانغو](django_urls/README.md)
+* [واجهات جانغو - وقت الإنشاء!](django_views/README.md)
+* [مقدمة إلى HTML](html/README.md)
+* [ORM جانغو (Querysets)](django_orm/README.md)
+* [البيانات الديناميكية في القوالب](dynamic_data_in_templates/README.md)
+* [قوالب جانغو](django_templates/README.md)
+* [إجعله جميلا بإستخدام CSS](css/README.md)
+* [تمديد القالب](template_extending/README.md)
+* [توسيع التطبيق الخاص بك](extend_your_application/README.md)
+* [نماذج جانغو](django_forms/README.md)
+* [ما هي الخطوة التالية؟](whats_next/README.md)
\ No newline at end of file
diff --git a/ar-SA/chromebook_setup/README.md b/ar-SA/chromebook_setup/README.md
new file mode 100644
index 00000000000..e72101085fe
--- /dev/null
+++ b/ar-SA/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# إعداد جهاز كروم بوك
+
+> **ملاحظة** اذا كنت قد مررت من هذه المرحلة من قبل ، لا تحتاج للقيام بذلك مرة أخرى--يمكنك تخطي هذه المرحلة والإنتقال إلى [مقدمة بايثون](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ar-SA/chromebook_setup/instructions.md b/ar-SA/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..bd807d529f8
--- /dev/null
+++ b/ar-SA/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+يمكنك [تخطي هذا القسم ](http://tutorial.djangogirls.org/en/installation/#install-python) إذا كنت لا تستخدم كروم بوك. إذا كنت كذلك، تجربة التثبيت الخاص بك سوف تكون مختلفة قليلاً. يمكنك تجاهل بقية إرشادات التثبيت.
+
+### بيئة التطوير المتكاملة السحابية (PaizaCloud Cloud IDE, AWS Cloud9)
+
+بيئة التطوير المتكاملة السحابية هي أداة توفر لك تحرير الأكواد البرمجية والوصول إلى جهاز كمبيوتر يعمل على شبكة الإنترنت حيث يمكنك تثبيت، وكتابة، وتشغيل البرامج. خلال مدة البرنامج التعليمي، بيئة التطوير المتكاملة السحابية ستكون بمثابة *الجهاز المحلي* الخاص بك. سوف تقوم بتنفيذ الأوامر في موجه الأوامر مثل زملائك الذين يعملون على أنظمة OS X, Ubuntu, أو Windows, لكن موجه الأوامر في السحابة سيكون متصل بجهاز حاسوبي يعمل في مكان اخر تقوم بيئة التطوير المتكاملة السحابية بإعداده لك. وإليك الإرشادات الخاصة ببيئات التطوير المتكاملة السحابية (PaizaCloud Cloud IDE, AWS Cloud9). يمكنك اختيار إحدى بيئات التطوير المتكاملة السحابية، واتباع تعليمات بيئة التطوير المتكاملة السحابية.
+
+#### بيئة التطوير المتكاملة السحابية PaizaCloud
+
+1. الذهاب إلى [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. إنشاء حساب جديد
+3. إنشاء خادم بالضغط على *New Server* واختيار Django
+4. الضغط على زر Terminal (على الجانب الأيسر من النافذة)
+
+الآن سترى واجهة مع قائمة جانبية، وأزرار على اليسار. اضغطي زر "Terminal" لفتح نافذة موجه الأوامر مثل هذا:
+
+{% filename %} Terminal{% endfilename %}
+
+    $
+    
+
+موجه الأوامر في PaizaCloud IDE مستعد لأوامرك. يمكنك تغيير حجم النافذة أو تكبيرها لجعلها أكبر قليلاً.
+
+#### AWS Cloud9
+
+حالياً Cloud 9 تتطلب تسجيلك في AWS وإدخال معلومات بطاقتك البنكية.
+
+1. ثبت Cloud 9 من [ متجر كروم](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 dashboard، اضغط *Create environment*
+6. سمه *django-girls*
+7. أثناء تعديل الإعدادات، من "Environment Type" اختر *Create a new instance for environment (EC2)*، ومن "Instance type" اختر *t2.micro*. (المفترض يظهر لك "Free-tier eligible." أي أنها متوفرة في الفئة المجانية). إعدادات cost-saving الافتراضية لا بأس بها، وتستطيع إبقاء الإعدادات الافتراضية الأخرى على ما هي عليه.
+8. اضغط على *Next step*
+9. اضغط *Create environment*
+
+الآن يفترض أن تشاهد واجهة وقائمة جانبية، ونافذة رئيسية كبيرة تحتوي نص، ونافذة صغيرة في الجزء السفلي التي تبدو مثل هذا:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+هذه المساحة السفلية تحتوي موجه الأوامر الخاص بك. يمكنك استخدام موجه الأوامر لإرسال التعليمات إلى الكمبيوتر البعيد في Cloud 9. يمكنك تغيير حجم تلك النافذة لجعلها أكبر قليلاً.
+
+#### معرف Glitch.com السحابي
+
+1. انتقل إلى [Glitch.com](https://glitch.com/)
+2. قم بالتسجيل للحصول على حساب (https://glitch.com/signup) أو استخدم حساب GitHub الخاص بك إذا كان لديك حساب. (انظر تعليمات GitHub أدناه)
+3. انقر فوق *New Project* واختر *hello-webpage*
+4. انقر على قائمة الأدوات المنسدلة (في الجزء السفلي الأيسر من النافذة)، ثم على زر المحطة الطرفية لفتح علامة التبويب الطرفية مع توجيه مثل هذا:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+عند استخدام Glitch.com كقاعدة بيانات سحابية، لا تحتاج إلى إنشاء بيئة افتراضية. بدلاً من ذلك، قم بإنشاء الملفات التالية يدوياً:
+
+{% 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
+```
+
+بمجرد إنشاء هذه الملفات، انتقل إلى المحطة الطرفية وتنفيذ الأوامر التالية لإنشاء أول مشروع جانغو الخاص بك:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    قم بالتحديث
+    
+
+من أجل رؤية رسائل الخطأ المفصلة، يمكنك تفعيل سجلات التصحيح جانغو لتطبيق Glitch الخاص بك. ببساطة إضافة ما يلي في نهاية ملف `mysite/settings.py`.
+
+{% 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,
+        },
+    },
+}
+```
+
+سيؤدي هذا إلى إنشاء `debug.log` ملف يفصل عمليات جانغو وأي رسائل خطأ قد تظهر، يجعل من الأسهل إصلاح ما إذا كان موقع الويب الخاص بك لا يعمل.
+
+يجب أن تفشل عملية إعادة التشغيل الأولية لمشروع Glitch. (إذا قمت بالنقر على زر القائمة المنسدلة العلوية `Show` وبعدها على `In a New Window`، سوف تتلقى رسالة خطأ `DisallowedHost` .) لا تقلق بشأن ذلك في هذه المرحلة، هذا البرنامج التعليمي سوف يصلح هذا بمجرد أن تحدث إعدادات جانغو للمشروع الخاص بك في ملف `mysite/settings.py`.
+
+### البيئة الافتراضية
+
+البيئة افتراضية (وتسمى أيضا virtualenv) مثل صندوق خاص يمكننا ملئه بأكواد برمجية مفيدة من اجل مشروع نعمل عليه. نستخدم البيئة الإفتراضية لنحافظ على الأكواد البرمجية التي نريدها لمشاريع مختلفة في بيئات منفصلة، حتى لا تختلط مع مشاريع اخرى.
+
+تشغيل:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(لاحظ أنه بالسطر الأخير إستخدمنا علامة المد تليها علامة يساوي: `~=`).
+
+### GitHub
+
+أنشئ حساب في [GitHub](https://github.com).
+
+### بايثون في كل مكان
+
+يتضمن البرنامج التعليمي للفتيات في جانغو قسما عما يسمى بالنشر، وهي عملية أخذ التعليمات البرمجية التي تعمل على تطبيق الويب الجديد ونقلها إلى جهاز كمبيوتر متاح للجمهور (يسمى الخادم) حتى يتمكن أشخاص آخرين من رؤية عملك.
+
+هذا الجزء غريب نوعاً ما عند تنفيذ البرنامج التعليمي على جهاز كروم بوك لأننا نستخدم جهاز كمبيوتر موجود على الإنترنت أساساً (ليس مثل أي كمبيوتر محمول آخر). ومع ذلك، فإنه لا يزال مفيدا، إذا فكرنا في مساحة عمل Cloud 9 كمكان لعملنا "تحت الإنشاء" و Python Anywhere كمكان لعرض أشيائنا إذا اكتملت.
+
+بالتالي، قم بتسجيل حساب جديد في Python Anywhere عبر هذا الرابط [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ar-SA/code_editor/README.md b/ar-SA/code_editor/README.md
new file mode 100644
index 00000000000..b17536a4faa
--- /dev/null
+++ b/ar-SA/code_editor/README.md
@@ -0,0 +1,11 @@
+# محرر الكود
+
+> للقراء في المنزل: هذا الفصل تم التكلم عنه في [تثبيت بايثون & محرر التعليمات البرمجية](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+أنت على وشك كتابة أول سطر كود خاص بك، لذا حمل برنامج محرر الكود!
+
+> **ملاحظة** إذا كنت تستخدم كروم بوك، تخطي هذا الفصل وتأكد من اتباع [تعليمات إعداد كروم بوك](../chromebook_setup/README.md). بيئة التطوير المتكاملة IDE السحابية التي اخترتها (PaizaCloud Cloud IDE or AWS Cloud9) تحتوي على محرر أكواد، وعندما تفتح ملف في بيئة التطوير خاصتك عن طريق قائمة ملف، سوف تقوم تلقائياً باستخدام المحرر.
+> 
+> **لاحظ** ربما فعلت ذلك في وقت سابق في [فصل التثبيت](../installation/README.md) - إذا كان الأمر كذلك يمكنك التخطي مباشرة إلى الفصل التالي!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ar-SA/code_editor/instructions.md b/ar-SA/code_editor/instructions.md
new file mode 100644
index 00000000000..286bccd5df5
--- /dev/null
+++ b/ar-SA/code_editor/instructions.md
@@ -0,0 +1,37 @@
+يوجد العديد من برامج التحرير لكن الخيار الاخير يعود للشخص. اغلب مبرمجي البايثون يستخدمون بيئات تطوير متكاملة (IDEs) معقدة لكنها قوية مثل PyCharm. كمبتدئ على الأرجح هذا الخيار أقل ملائمة؛ نحن نوصي ببرامج قوية على نفس المستوى، ولكن أبسط بكثير.
+
+اقتراحاتنا مدرجة بالاسفل، لكن لا تتردد أن تسأل المدرب عن برنامجه المفضل - سوف يكون من الأسهل الحصول على مساعدة منهم.
+
+## Visual Studio Code
+
+Visual Studio Code هو محرر أكواد من مايكروسوفت لنظام Windows و Linux و macOS. ويشمل دعمًا للتصحيح، والتحكم في Git، وتمييز بناء الجملة، وإكمال الكود الذكي، واقتباس الأكواد، وتعديلها.
+
+[يمكنك تحميل البرنامج هنا](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit محرر أكواد مجاني، ومفتوح المصدر، ومتاح لجميع أنظمة التشغيل.
+
+[يمكنك تحميل البرنامج هنا](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text هو محرر شائع جدا مع فترة مجانية للتقييم، ومتاح لجميع أنظمة التشغيل.
+
+[يمكنك تحميل البرنامج هنا](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom محرر أكواد آخر. مجاني، ومفتوح المصدر، ومتوفر لأنظمة Windows و OS X و Linux. تم تطويره من قبل [GitHub](https://github.com/).
+
+[يمكنك تحميل البرنامج هنا](https://atom.io/)
+
+## لماذا نقوم بتحميل محرر الأكواد؟
+
+قد تتساءل عن سبب قيامنا بتحميل برنامج محرر الأكواد بدلاً من استخدام شيء مثل Word أو Notepad.
+
+السبب الأول هو أن الكود البرمجي يجب أن يكون ** نصًا عاديًا ** ، والمشكلة في برامج مثل Word و Textedit هي أنها لا تنتج فعليًا نصًا عاديًا ، ولكنها تنتج نصًا منسقًا (مع خطوط وتنسيقات) ، باستخدام تنسيقات مخصصة مثل [ RTF (Rich Text Format) ](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+السبب الثاني هو أن برامج تحرير الأكواد مخصصة لهذا الغرض، حتى يتمكنون من توفير ميزات مفيدة مثل تلوين الكود حسب معناه، أو إغلاق الأقواس تلقائيًا.
+
+سترى بنفسك لاحقاً. قريباً، ستتفكر في محرر الأكواد كأحد برامجك المفضلة. :)
\ No newline at end of file
diff --git a/ar-SA/css/README.md b/ar-SA/css/README.md
new file mode 100644
index 00000000000..5b2592e39c2
--- /dev/null
+++ b/ar-SA/css/README.md
@@ -0,0 +1,330 @@
+# CSS – اجعل الأمر رائعاً!
+
+لا تزال مدونتنا تبدو قبيحة جداً، أليس كذلك؟ حان الوقت لجعلها جميلة! سنستخدم CSS لذلك.
+
+## ما هي تقنية CSS؟
+
+CSS هي لغة تجميل المواقع, تخيل HTML هي هيكل المنزل يعني الحائط و السارية و السقف و CSS هي الصباغة و الصقل والديكور... و ما إلى ذلك , يعني مثل المكياج 
+
+لكننا لا نريد أن نبدأ من الصفر مرة أخرى، أليس كذلك؟ مرة أخرى، سنستخدم شيئا خلقه المبرمجون على الإنترنت مجانا. إعادة اختراع العجلة ليس ممتعا، كما تعلمون.
+
+## لنستخدم Bootstrap!
+
+Bootstrap اطار عمل الأكثر شعبية لـ HTML و CSS لتطوير مواقع جميلة: https://getbootstrap.com/
+
+كتب بواسطة المبرمجين الذين عملوا على تويتر والآن يتم تطويره من قبل المتطوعين من جميع أنحاء العالم!
+
+## تثبيت Bootstrap
+
+لتحميل Bootstrap ، افتح ملف `.html` خاصتك في محرر الكود وأضف هذا في جزء `<head>`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+هذا لا يضيف أي ملفات إلى المشروع الخاص بك. بل يشير فقط إلى الملفات الموجودة على شبكة الإنترنت. افتح موقع الويب الخاص بك وقم بتحديث الصفحة. لاحظت الفرق!
+
+![الرقم 14.1](images/bootstrap1.png)
+
+يبدو اجمل الان!
+
+## الملفات الثابتة في Django
+
+اخيراً سوف نمعن بالنظر على ما اسميناه **بالملفات الثابتة**. الملفات الثابتة هي كل CSS والصور. محتواهم لا يعتمد على خاصية الطلب وسيكون مشابها عند الجميع.
+
+### اين توضع الملفات الثابتة لمشروع Django
+
+جانغو عرف مسبقا أين يجد الملفات الثابتة للتطبيق المضمن "admin". الان لايلزمنا سوى اضافة بعض الملفات الثابتة للتطبيق الخاص بنا,`blog`.
+
+نقوم بذلك بانشاء مجلد نسميه `static` داخل تطبيق المدونة:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+جانغو سيجد تلقائيا أي مجلد باسم "static" داخل اي مجلد يحتويه تطبيقك. وسيستطيع استعمال محتوياته كملفات ثابتة.
+
+## الأن مع ملفات CSS
+
+لنقم بانشاء ملف نمطي CSS. لتظيف تعديلاتك الخاصة لموقعك. قم بانشاء مجلد باسم `css` داخل مجلد `static`. قم بانشاء ملف باسم `blog.css` داخل المجلد `css`. مستعد ؟
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+حان الوقت للقيام بكتابة بعض CSS,قم بفتح الملف `blog/static/css/blog.css` داخل المحرر.
+
+لن نذهب عميقاً في تخصيص وتعلم CSS هنا. هناك توصية بدورة CSS مجانية في نهاية هذه الصفحة إذا كنت ترغب في معرفة المزيد.
+
+لكن لنقم بالقليل على الاقل. ربما نريد تغيير لون الترويسة؟ لفهم الالوان, الحاسوب يستعمل شيفرات خاصة. الشيفرات تبتدأ ب `#` و تليها 6 حروف (A-F) و أرقام (0-9). مثلا ، رمز اللون الأزرق هو `#0000FF`. يمكنك العثور على هذه الشيفرات في هذا الموقع: http://www.colorpicker.com/. يمكنك استعمال الالوان المحددة مسبقا ك `red` و `green`.
+
+داخل الملف `blog/static/css/blog.css` يجب عليك اضافة التعليمات البرمجية التالية:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` هو محدد CSS. وهذا يعني أننا تقوم بتطبيق أنماط لدينا إلى أي عنصر من عناصر `a` داخل عنصر `h1`؛ محدد `h2 a` يفعل الشيء نفسه لعناصر `h2`. حتى عندما يكون لدينا شيء مثل `<h1><a href="">link</a></h1>`، `h1` سيتم تطبيق النمط. في هذه الحالة نأمرها بتغيير الون الى `#Fca205`, وهو اللون البرتقالي الداكن. أو يمكنك وضع اللون الذي تريده هنا، ولكن تأكد من تباين هذا اللون عن الخلفية البيضاء!
+
+داخل ملف CSS نحدد أنماط العناصر التي توجد داخل ملف HTML. الطريقة الأولى التي نستخدمها لتحديد العناصر هي عبر الإسم. يمكن أن تذكر هذه tags من قسم HTML. أشياء مثل`a`, `h1` و `body` هي كلها امثلة لأسماء العناصر. نحن نحدد العناصر ايضا عبر `class` او عبر `id`. Class و id هي الأسماء التي يمكنك إعطائها للعنصر بنفسك. تحدد class مجموعات من العناصر، و id تشير إلى عناصر محددة. على سبيل المثال، يمكنك تحديد العنصر التالي باستخدام اسم العنصر `a`، الفئة `external_link` أو المعرف `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+اقرأ عن [محددات CSS في w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+نحن بحاجة إلى أن نقول أيضا لقالب HTML أننا أضفنا بعض ال CSS. افتح الملف `blog/templates/blog/post_list.html` في محرر الأكواد وأضف هذا السطر في البداية:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+نحن فقط نحمل الملفات الثابتة هنا ما بين علامات `<head>` و `</head>` بعد الارتباطات بملفات بوتستراب CSS ، قم بإضافة هذا السطر:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+المتصفح يقرأ الأوامر بالترتيب الذي اعطي له ، لذا يجب علينا التأكد من ان هذا في المكان الصحيح. وإلا فإن الكود في الملف الخاص بك قد يتم تجاوزه بواسطة الكود في ملفات بوتستراب. قمنا لتونا بإعلام القالب أين توجد ملفات التنسيق CSS.
+
+الآن يجب أن يبدو الملف الخاص بك مثل هذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+حسنا، قم بحفظ الملف وقم بتحديث الموقع!
+
+![الرقم 14.2](images/color2.png)
+
+عمل جيد! ربما نود أيضا إعطاء موقعنا متنفس وزيادة الهامش على الجانب الأيسر؟ دعونا نحاول هذا!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+قم بإضافة التعديل أعلاه لملف التنسيق CSS, احفض الملف و أنظر النتيجة!
+
+![الرقم 14.3](images/margin2.png)
+
+ربما يمكننا تخصيص الخط في عنوان الصفحة لدينا؟ ألصق هذا `< header >` في ملف `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+كما من قبل، تحقق من الأمر والمكان قبل الارتباط بـ `blog/static/css/blog.css`. هذا السطر سيطلب خط يسمى *Lobster* من "خطوط جوجل " (https://www.google.com/fonts).
+
+أعثر على `h1` إعلان كتلة (التعليمات البرمجية بين الأقواس `{` `}`) في ملف CSS `blog/static/css/blog.css`. الآن قم بإضافة السطر `font-family: 'Lobster';` بين أقواس، وحدث الصفحة:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![الرقم 14.3](images/font.png)
+
+عظيم!
+
+كما ذكر أعلاه، CSS لديها مفهوم طبقات. هذه تسمح لك بتسمية جزء من التعليمات البرمجية ل HTML وتطبيق الأنماط فقط لهذا الجزء، دون التأثير على الأجزاء الأخرى. هذا يمكن ان يكون مفيد جدا! ربما يكون لديك اثنين من divs اللذان يقومان بشيء مختلف (مثل الهيدر او الموضوع الخاص بك). الكلآس يمكن اي يساعدك في جعلها تبدو مختلفة.
+
+امضي قدماً وقم بتسمية بعض أجزاء من كود HTML. استبدل `header` الذي يحتوي على رأس الصفحة الخاص بك بما يلي:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+الان أضف Class `post` إلى `div` الذي يحتوي مقال مدونة.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+سنقوم الآن بإضافة كتل إعلان لمحددات مختلفة. المحددات التي تبدأ ب `.` تتعلق بالفصول. هناك العديد من الدروس والشروحات التي تتكلم عن CSS في الأنترنت والتي يمكنها مساعدتك على فهم الأكواد التالية. الآن، فقط قم بنسخ ولصق في ملف `blog/static/css/blog.css` خاصتك:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+تم قم بإحاطة تعليمات HTML التي تظهر المقالات:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+في `blog/templates/blog/post_list.html` بهذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+إحفظ الملفات الأن، وقم بتحديث موقع الويب الخاص بك.
+
+![الرقم 14.4](images/final.png)
+
+وووهووو! يبدو رائعا أليس كذالك؟ انظر إلى التعليمات البرمجية التي ألصقناها للتو للعثور على الأماكن التي أضفنا فيها كلاسات في HTML واستخدمناها في CSS. أين يمكن عمل تعديل ان اردت للوقت ان يكون turquoise؟
+
+لا تخافوا من العبث مع هذه CSS قليلا ومحاولة تغيير بعض الأشياء. اللعب ب CSS يمكن أن يساعدك على فهم ما تقوم به الأشياء المختلفة. إذا كسرت شيء لا تقلق يمكنك اصلاحه دائما!
+
+نوصي بشدة بالدورات التدريبية المجانية أونلاين "Basic HTML & HTML5" و "Basic CSS" في [freeCodeCamp](https://learn.freecodecamp.org/). يمكن أن تساعدك على تعلم كل شيء عن جعل مواقعك أجمل باستخدام HTML و CSS.
+
+جاهز للفصل التالي؟! :)
\ No newline at end of file
diff --git a/ar-SA/deploy/README.md b/ar-SA/deploy/README.md
new file mode 100644
index 00000000000..7bf14a2c8a5
--- /dev/null
+++ b/ar-SA/deploy/README.md
@@ -0,0 +1,246 @@
+# تدشين!
+
+> **ملاحظه** الفصل التالي قد يكون في بعض الأحيان صعبا. استمر و اعزم على الانتهاء منه؛ التدشين جزء هام من عملية تطوير موقع على شبكة الإنترنت. ويوضع هذا الفصل في منتصف البرنامج التعليمي حتى يمكن لمدربك أن يساعدك في العمليات الأصعب قليلاً لنشر موقع الويب الخاص بك على الإنترنت. وهذا يعني أنه لا يزال يمكنك الانتهاء من البرنامج التعليمي الخاص بك بمفردك إذا نفذ الوقت منك.
+
+حتى الأن موقعك كان متاحا فقط على حاسوبك. الأن سوف تتعلم كيف تنشره! النشر هو عملية اتاحة التطبيق الخاص بك على شبكة الإنترنت حيث يمكن للناس الذهاب إلى التطبيق الخاص بك و مشاهدته. :)
+
+كما تعلمت، موقع على شبكة الإنترنت يجب أن يتواجد في خادم. هناك الكثير من مقدمي الخدمة متاحين على شبكة الإنترنت، ونحن سنستخدم [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere متوفر مجانا للتطبيقات الصغيرة التي لا تحتوي على عدد كبير من الزائرين فالآن بالتأكيد ستكون كافية بالنسبة لك.
+
+الخدمات الخارجية الأخرى ستقوم باستخدام [GitHub](https://www.github.com)، وهي خدمة استضافة التعليمات البرمجية. هناك آخرون ، ولكن تقريبا جميع المبرمجين لديهم حساب GitHub في هذه الأيام، والآن أنت سوف يمكنك أيضا الحصول على حساب!
+
+سوف تكون هذه الأماكن الثلاثة هامة بالنسبة لك. الكمبيوتر الخاص بك سوف يكون المكان حيث يمكنك القيام بالتطوير والإختبار. عندما تكون راضيا عن التغييرات، ستقوم بوضع نسخة من التعليمات البرمجية على GitHub. موقعك سيكون على بايثون في كل مكان ، وستقوم بتحديثه عبر استقدام نسخة جديدة من GitHub.
+
+# جيت (Git)
+
+> **ملاحظة** إذا كنت قمت بإجراء خطوات التثبيت سابقا، لا تحتاج للقيام بذلك مرة أخرى -يمكنك التخطي إلى الجزء التالي والبدء في إنشاء مستودع Git الخاص بك.
+
+{% include "/deploy/install_git.md" %}
+
+## ابتداء مستودعك في Git
+
+Git يتعقب التغييرات التي تحدث لمجموعة معينة من الملفات في ما يسمى بمستودع الكود (أو "الريبو" للاختصار). لنبدأ انشاء مستودع (ريبو) لمشروعنا. افتح وحدة التحكم الخاص بك ، وشغل هذه الأوامر في دليل `djangogirls`:
+
+> **ملاحظة** تحقق من دليل العمل الحالي الخاص بك مع `pwd` (Mac OS X/لينكس) أو `cd` (في Windows) قبل تهيئة المستودع. يجب أن تكون في المجلد `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+تهيئة المستودع هو شيء نحتاج القيام به مرة واحدة فقط لكل مشروع (ولن تضطر إلى إعادة إدخال اسم المستخدم والبريد الإلكتروني مرة أخرى).
+
+Git سوف يتعقب التغييرات لكافة الملفات والمجلدات الموجودة في هذا الدليل، ولكن هناك بعض الملفات التي نريد Git أن يتجاهلها. نحن نقوم بهذا عبر انشاء ملف يسمى `.gitignore` في الدليل الرئيسي. افتح المحرر الخاص بك وقم بإنشاء ملف جديد مع محتويات التالية:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+واحفظه ك `.gitignore` في مجلد "djangogirls".
+
+> **ملاحظة** النقطه في بداية اسم الملف مهمه! إذا كنت تواجه أي صعوبة في انشائه (على سبيل المثال ،أجهزة ماكينتوش لا تمكنك من إنشاء الملفات التي تبدأ بنقطة عن طريق الباحث)، إذا قم باستخدام ميزة "حفظ باسم" في المحرر الخاص بك. تأكد من عدم إضافة `.txt`، `py` أو أي امتداد اخر إلى اسم الملف -- سوف يتعرف عليها Git اذا كان الاسم فقط `.gitignore`. يتعامل لينكس وماك مع الملفات التي تبدأ بـ `.` (مثل `.gitignore`) كملفات مخفية و `ls` لن تظهر هذه الملفات. بدلاً من ذلك، استخدم `ls -a` لمشاهدة الملف `.gitignore`.
+> 
+> **ملاحظة** أحد الملفات التي قمت بتحديدها في ملف `.gitignore` هي `db.sqlite3`. هذا الملف هو قاعدة البيانات المحلية الخاصة بك، حيث يتم تخزين جميع المستخدمين والوظائف الخاصة بك. سوف نتابع الممارسات الموحدة في برمجة الويب، بمعنى أنه سوف نستخدم قواعد بيانات منفصلة لموقع الاختبار المحلي الخاص بك وموقع الويب الخاص بك مباشرة في PythonAnywhere. قاعدة بيانات PythonAnywhere يمكن أن تكون SQLite، مثل الة التطوير خاصتك، ولكن عادة ما تستخدم واحدة تدعى MySQL والتي يمكنها التعامل مع عدد زوار أكبر بكثير من SQLite. وفي كلتا الحالتين، بتجاهل قاعدة بيانات SQLite لنسخة GitHub، يعني أن جميع المشاركات التي قمت بإنشائها حتى الآن ستكون متاحة محلياً فقط، وسيكون عليك إنشاء مشاركات جديدة عند الإنتاج. ينبغي أن تفكر في قاعدة البيانات المحلية الخاصة بك كملعب جيد حيث يمكنك اختبار أشياء مختلفة وولا تخف من فكرة انك ستحدف مشاركاتك الحقيقية من المدونة.
+
+انها فكرة جيدة استخدام الأمر `git status` قبل `git add` أو كلما وجدت نفسك غير متأكد من ما تغير. وهذا سيساعد على منع أي مفاجآت من الحدوث، مثل إضافة ملفات خاطئة. الأمر `git status` يرجع المعلومات عن اي ملف لم يتم اتباعه تعديله او تنظيمه, حالة الفرع، وأكثر من ذلك بكثير. يجب أن يكون المخرج مشابه لما يلي:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+وأخيرا نحفظ التغييرات التي قمنا بها, اذهب الى لوحة التحكم الخاصة بك وأدخل هذه الأوامر:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## ارسال برنامجك الى GitHub
+
+زر [GitHub.com](https://www.github.com) وسجل حساب مستخدم جديد مجاني. (لو فعلت هذا مسبقاً في التحضير للورشة، هذا شيء عظيم!) تأكد من حفظ كلمة السر (أضفها إلى مدير كلمات السر الخاص بك اذا كنت تستخدم احدهم).
+
+بعدها أنشئ مستودع جديد. واعطه اسم "my-first-blog". اترك خانة "initialize with a README" دون اختيارها واترك الخيار.gitignore فارغ (لقد فعلنا ذلك يدوياً) وأترك الترخيص على أنه لا شيء.
+
+![](images/new_github_repo.png)
+
+> ** * * ملاحظة * * اسم 'my-first-blog' مهم – يمكن أن تختار شيئا آخر، لكن هذا سيأخد الكثير من الوقت في الإرشادات الموجودة أدناه، وسيكون عليك استبداله كل مرة. ربما من الأسهل الإبقاء على اسم 'my-first-blog'.</p> </blockquote> 
+> 
+> في الشاشة التالية، سوف يظهر لك URL استنساخ الريبو الخاص بك، الذي سيتم استخدامه في بعض الأوامر التالية:
+> 
+> ![](images/github_get_repo_url_screenshot.png)
+> 
+> الآن نحن بحاجة إلى ربط مستودع Git على جهاز الكمبيوتر الخاص بك مع المستودع الذي أنشأته على GitHub.
+> 
+> اكتب الأمر التالي في وحدة التحكم الخاصة بك (استبدل `<your-github-username>` مع اسم المستخدم الذي قمت بإدخاله عند إنشاء حساب GitHub الخاص بك، ولكن دون أقواس -- هذا الURL يجب أن يشابه الURL المنسوخ الذي رأيته قبل قليل):
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+>     $ git push -u origin master
+>     
+> 
+> عند الرفع إلى GitHub، سيطلب منك GitHub اسم المستخدم وكلمة المرور (أما في نافذة سطر الأوامر أو في نافذة منبثقة)، وبعد إدخال بيانات الاعتماد يجب أن ترى شيئا مثل هذا:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Counting objects: 6, done.
+>     Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+>     Total 3 (delta 0), reused 0 (delta 0)
+>     To https://github.com/ola/my-first-blog.git
+>     
+>      * [new branch]      master -> master
+>     Branch master set up to track remote branch master from origin.
+>     
+> 
+> <!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+> 
+> برنامجك الان في GitHub. اذهب وتحقق من ذلك! ستجد في النهاية – \[Django\] (https://github. com/django/django) وفي \[Django Girls Tutorial\] (https://github. com/DjangoGirls/tutorial)، والعديد من مشاريع البرمجيات الكبيرة مفتوحة المصدر تستضيف برامجها الخاصة في GitHub. :)
+> 
+> # اعداد مدونتنا على PythonAnywhere
+> 
+> ## انشئ حساب على PythonAnywhere
+> 
+> > * * ملاحظة * * قد تكون انشأت حساب ب PythonAnywhere في وقت سابق أثناء خطوات التثبيت – إذا كان الأمر كذلك، لا حاجة للقيام بذلك مرة أخرى.
+> 
+> {% include "/deploy/signup_pythonanywhere.md" %}
+> 
+> ## اعداد موقع على PythonAnywhere
+> 
+> عد الى لوحة التحكم بالنقر على شعار الموقع, وحدد خيار بدئ الطرفية (bash-console) هي نسخة الموقع من الطرفية تماما كتلك اللتي لديك بجهازك.
+> 
+> ![جزء ""وحدة التحكم الجديدة" على موقع PythonAnywhere، مع زر "bash"](images/pythonanywhere_bash_console.png)
+> 
+> > **ملاحظة** PythonAnywhere يعتمد ومبني على اللينكس. لذا ان كنت على ويندوز فالطرفية ستظهر مختلفة قليلا.
+> 
+> نشر تطبيق ويب على PythonAnywhere يتضمن سحب التطبيق من GitHub ومن ثم اعداد PythonAnywhere للتعرف عليه وبدء العمل به كتطبيق ويب. هناك طرق يدوية للقيام بذلك, لكن PythonAnywhere يوفر أدوات تقوم بالمهمة عنك. أولا لنثبت لنثبته:
+> 
+> {% filename %}PythonAnywhere command-line{% endfilename %}
+> 
+>     $ pip3.8 install --user pythonanywhere
+>     
+> 
+> يجب أنت ترى بعض الملاحظات ك`Collecting pythonanywhere` و تنتهي بالعبارة `Successfully installed (...) pythonanywhere- (...)`.
+> 
+> الان نستخدم الادات المساعدة, لإعداد التطبيق مباشرة من GitHub و بشكل ألي. اكتب الأمر التالي في وحدة التحكم على PythonAnywhere(لا تنسى أن استخدام اسم المستخدم الخاص بك في GitHub بدلاً من `<your-github-username>`، حتى يتشابه الURL بالURL المنسوخ من Github):
+> 
+> {% filename %}PythonAnywhere command-line{% endfilename %}
+> 
+>     $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+>     
+> 
+> بينما تشاهد ذلك يعمل، سوف يمكنك رؤية ماذا يفعل:
+> 
+> - تحميل الكود خاصتك من Github
+> - إنشاء virtualenv على PythonAnywhere، تماما مثل الذي على جاهز الكمبيوتر خاصتك
+> - تحديث ملف الإعدادات مع بعض إعدادات النشر
+> - إعداد قاعدة بيانات على PythonAnywhere باستخدام الأمر `manage.py migrate`
+> - إعداد الملفات الثابتة (سوف نتعلم عن هذه في وقت لاحق)
+> - وتهيئة PythonAnywhere لخدمة التطبيق الويب الخاص بك عبر API،
+> 
+> في PythonAnywhere جميع تلك الخطوات أتوماتيكية، بل أنهم نفس الخطوات التي عليك أن تذهب من خلالها مع أي موفر خدمة آخر.
+> 
+> الشيء الرئيسي الذي يجب ملاحظته الآن هو أن قاعدة البيانات الخاصة بك في PythonAnywhere في الواقع منفصلة تماما من قاعدة البيانات على جهاز الكمبيوتر الخاص بك، حتى تتمكن من أن يكون لها وظائف وحسابات المسؤول(admin) مختلفين. نتيجة لذلك، تماما كما فعلت على جهاز الكمبيوتر خاصتك، علينا بدأ حساب المسؤول(admin) ب `createsuperuser`. قام PythonAnywhere بتفعيل Virtualenv خاصتك أتوماتيكيا، لذلك كل ما تحتاج لفعله هو تشغيل:
+> 
+> {% filename %}PythonAnywhere command-line{% endfilename %}
+> 
+>     (ola.pythonanywhere.com) $ python manage.py createsuperuser
+>     
+> 
+> اكتب التفاصيل للمستخدم المسؤول(admin) الخاص بك. أفضل الطرق لاستخدام نفس الذي تستخدمه على الكمبيوتر الخاص بك لتجنب أي التباس، إلا إذا كنت تريد أن تجعل كلمة المرور على PythonAnywhere أكثر أمنا.
+> 
+> الان، اذا أردت، يمكنك النظر إلى الكود خاصتك على PythonAnywhere باستخدام `ls`:
+> 
+> {% filename %}PythonAnywhere command-line{% endfilename %}
+> 
+>     ola.pythonanywhere.com) $ ls)
+>     blog  db.sqlite3  manage.py  mysite requirements.txt static
+>     ola.pythonanywhere.com) $ ls /blog)
+>     __init__.py  __pycache__  admin.py  apps.py  migrations  models.pytests.py  static
+>     templates  views.py
+>     
+> 
+> يمكنك أيضا الذهاب إلى صفحة "ملف" وتصفح حولها باستخدام متصفح الملفات المبني في PythonAnywhere. (من صفحة وحدة التحكم، يمكنك الحصول على صفحات أخرى في PythonAnywhere من زر القائمة في الزاوية العلوية اليمنى. وعند تواجدك في إحدى الصفحات، هناك روابط لبعضها الآخر بالقرب من الأعلى.)
+> 
+> ## أنت على الهواء الأن!
+> 
+> يجب أن يكون موقعك الآن مباشرًا على الإنترنت العام! انقر من خلال صفحة PythonAnywhere "Web" للحصول على رابط له. يمكنك مشاركة هذا مع أي شخص تريده. :)
+> 
+> > **ملاحظة** هذا برنامج تعليمي للمبتدئين، وفي نشر هذا الموقع لقد اتخذنا بعض التجاوزات التي لم تكن مثالية من وجهة نظر أمنية. إذا قررت البناء على هذا المشروع، أو البدء في مشروع جديد، يجب عليك مراجعة [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) للحصول على بعض النصائح حول رفع مستوى أمان موقعك.
+> 
+> ## نصائح لتصحيح الأخطاء
+> 
+> إذا كنت ترى خطأ أثناء تشغيل البرنامج النصي `pa_autoconfigure_django.py`، فيما يلي بعض الأسباب الشائعة:
+> 
+> - نسيان إنشاء رمز API الخاص بPythonAnywhere.
+> - إرتكاب خطأ في عنوان Github URL الخاص بك
+> - إذا كنت ترى خطأ يقول *"تعذر العثور على settings.py الخاص بك"*، على الأرجح لأنك لم تتمكن من إضافة كافة الملفات الخاصة بك إلى Git، و/أو لم ترفعهم إلى GitHub بنجاح. ألقي نظرة أخرى على قسم Git أعلاه
+> - إذا كنت مسجل سابقاً في PythonAnywhere وحصلت لك مشكلة في collectstatic، فغالباً لديك في حسابك نسخة أقدم من SQLite (مثل 3.8.2). في هذه الحالة، سجل في حساب جديد وجرب الأوامر البرمجية الموجودة في قسم PythonAnywhere في الأعلى.
+> 
+> إذا كنت ترى خطأ عند محاولة زيارة موقع الويب الخاص بك، المكان الأول للبحث عن بعض معلومات التصحيح هو **سجل الأخطاء** الخاص بك. ستجد رابط لهذا في PythonAnywhere [صفحة "الويب"](https://www.pythonanywhere.com/web_app_setup/). إذا كان هناك أية رسائل أخطاء هناك؛ أحدثها يوجد في الأسفل.
+> 
+> وهناك أيضا بعض [نصائح عامة لتصحيح الأخطاء في موقع المساعدة لPythonAnywhere](http://help.pythonanywhere.com/pages/DebuggingImportError).
+> 
+> وتذكر أن المدرب هنا للمساعدة!
+> 
+> # تحقق من موقع الويب الخاص بك!
+> 
+> الصفحة الرئيسية لموقعك يجب ان تقول "لقد نجح!" تماما كما تقول على حاسوبك الخاص. حاول إضافة `/admin/` إلى نهاية عنوان URL، وسوف يتم نقلك إلى موقع المشرف. قم بتسجيل الدخول باستخدام اسم المستخدم وكلمة المرور، وسترى أنه يمكنك إضافة وظائف جديدة على الخادم -- تذكر، مشاركاتك من قاعدة البيانات المحلية الخاصة بك لم يتم إرسالها إلى مدونتك المباشرة.
+> 
+> وبمجرد الانتهاء من إنشاء عدد قليل من المشاركات، يمكنك العودة إلى الإعداد المحلي الخاص بك (ليس PythonAnywhere). من هنا يجب أن تعمل على الإعدادات المحلية خاصتك لإجراء التغييرات. هذا سير عمل مشترك في تطيور المواقع -- قم بالتغييرات محلياً، ارفع تلك التغييرات إلى GitHub، وارسل هذه التغييرات إلى خادم الويب المباشر خاصتك. هذا يسمح لك بالعمل والتجربة دون تخريب موقع الويب الخاص بك. رائع! اليس كذالك؟
+> 
+> إعطي نفسك تربيت *كبير* على الظهر! عمليات نشر الخوادم واحدة من أصعب أجزاء تطوير المواقع، وكثيراً ما يأخذ الناس عدة أيام قبل أن تتمكن من فعلها. ولكنك قد نشرت موقعك الخاص على شبكة الانترنت!
\ No newline at end of file
diff --git a/ar-SA/deploy/install_git.md b/ar-SA/deploy/install_git.md
new file mode 100644
index 00000000000..5f86ecba4b1
--- /dev/null
+++ b/ar-SA/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git عباره عن "نظام تحكم في الإصدار" مستخدم من قبل الكثير من المبرمجين. هذا النظام يمكنه تعقب التغييرات في الملفات مع مرور الوقت حتى أنه يمكنك استرجاع إصدارات محددة في وقت لاحق. قليلاً مثل ميزة "تعقب التغييرات" في برامج معالج النصوص (على سبيل المثال، Microsoft Word أو Writer LibreOffice)، ولكن أقوى بكثير.
+
+## تثبيت Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+يمكنك تحميل Git من [ git-scm.com](https://git-scm.com/). يمكنك الضغط على "التالي" في جميع الخطوات باستثناء خطوتين: في الخطوة التي يطلب منك اختيار محررك، عليك اختيار Nano, وفي الخطوة بعنوان "ضبط بيئة المسار (PATH) الخاص بك"، اختر "استخدام Git وأدوات يونيكس المرتبطة بها من سطر الأوامر في ويندوز" (الخيار الأسفل). بخلاف ذلك، الإعدادات الافتراضية كافيه. راجع نهايات السطور في نمط ويندوز ، و ارتكاب نمط يونكس.
+
+لا تنس إعادة تشغيل موجه الأوامر أو powershell بعد انتهاء عملية التثبيت بنجاح. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+تحميل Git من [.git-scm.com](https://git-scm.com/) واتبع التعليمات.
+
+> **ملاحظة** إذا كنت تستخدم نضظم ماك بهذه الإصدارات OS X 10.6, 10.7, or 10.8, يجب عليك تنصيب نسخة git من هذا الرابط [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ar-SA/deploy/signup_pythonanywhere.md b/ar-SA/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..616262b0905
--- /dev/null
+++ b/ar-SA/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere هي خدمة لتشغيل أكواد بايثون على خوادم سحابية. سوف نستخدمها لنشر موقعك، مباشرة وعلى الانترنت.
+
+سوف نقوم بنشر المدونة التي سنبنيها على PythonAnywhere. أنشئ حساب "مبتدأ" على PythonAnywhere (الحساب المجاني كافي، لا تحتاج بطاقة ائتمان).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![صفحة إنشاء الحساب في PythonAnywhere تظهر زر لإنشاء حساب مجاني للمبتدئين](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **ملاحظة** عندما تقوم باختيار اسم المستخدم (username) هنا، تذكر ان رابط مدونتك سوف يأخذ الشكل `yourusername.pythonanywhere.com`، لذلك قم باختيار اسم مستعارا لك او اسم يدل علآ محتوى المدونة خاصتك. أيضا، تأكد من تذكر كلمة المرور الخاصة بك (اضفها الى مدير كلمات السر خاصتك، إذا كنت تستخدم أحدهم).
+
+## إنشاء قطعة واجهة التطبيق البرمجية (API) من PythonAnywhere
+
+هذا شيء تحتاج لفعله مرة واحدة فقط. عندما تنتهي من إنشاء حساب PythonAnywhere، سوف يتم أخذك إلى اللوحة الرئيسية. ابحث عن رابط في أعلى الصفحة، على يمين صفحة الحساب:
+
+![رابط الحساب يوجد في أعلى يمين الصفحة](../deploy/images/pythonanywhere_account.png)
+
+ثم اختر خلية تسمى قطعة واجهة التطبيق البرمجية (API token)، واضغط على الزر الذي يقول: "أنشىء قطعة واجهة تطبيق برمجية جديدة" (Create new API token).
+
+![خلية قطعة واجهة التطبيق البرمجية (API token) في صفحة الحساب](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ar-SA/django/README.md b/ar-SA/django/README.md
new file mode 100644
index 00000000000..c3abb2773a0
--- /dev/null
+++ b/ar-SA/django/README.md
@@ -0,0 +1,27 @@
+# ما هو جانغو؟
+
+جانغو (/ˈdʒæŋɡoʊ/*جانغ-جوه*) إطار تطبيق ويب حر ومفتوح المصدر مكتوب بلغة بايثون. أطار العمل مكون من مجموعه من المكونات التى سوف تساعدك على تطوير المواقع بطريقة اسهل واسرع.
+
+عندما تقوم ببناء موقع على شبكة الإنترنت، تحتاج دائماً مجموعة مماثلة من المكونات: طريقة للتعامل مع مصادقة المستخدم (التسجيل، الدخول، والخروج)، وصفحة إدارية لموقع الويب الخاص بك، والاستمارات، وطريقة لتحميل الملفات، إلخ.
+
+لحسن الحظ لاحظ أشخاص آخرين منذ وقت طويل أن مطوري الويب تواجههم مشاكل مماثلة عند إنشاء موقع جديد، فتعاونوا في إنشاء أطارات عمل (جانغو واحد منهم) التي تعطيك مكونات جاهزة يمكنك استخدامها.
+
+اطارات العمل موجودة لتنقدكم من إعادة اختراع ما تم اختراعه من قبل، وتساعد في تخفيف بعض النفقات العامة عندما تقوم ببناء موقع جديد.
+
+## لماذا تحتاج إلى إطار عمل؟
+
+لفهم ما هو جانغو في الواقع ، علينا أن نلقي نظرة فاحصة على الملقمات. أول شيء أن الملقم يحتاج إلى معرفة أن كنت تريد منه ان يعطيك صفحة انترنت.
+
+تخيل علبة بريد (ميناء) التي يتم ضبطها للرسائل الواردة (الطلبات). وهذا يتم عن طريق خادم ويب. خادم الويب يقوم بقراءة الرسالة وثم يرسل استجابة مع صفحة ويب. ولكن عندما تريد أن ترسل شيئا، فأنت بحاجة إلى بعض المحتوى. وجانغو هو الشيء الذي يساعدك في إنشاء المحتوى.
+
+## ماذا يحدث عندما يطلب شخص ما موقع انترنت من خادمك؟
+
+عندما يصل طلب إلى الخادم ، يتم تمريره لدجانغو ، والذي سيحاول ما الذي تم طلبه. إنه يأخذ عنوان صفحة ويب أولا ويحاول معرفة ما يجب القيام به. يتم هذا الجزء من قبل دجانغو ** urlresolver** (لاحظ أن عنوان موقع ويب يسمى URL - محدد مواقع الموارد - لذلك الاسم * urlresolver * منطقي). أنه ليس ذكية جدا - فإنه يأخذ قائمة من الأنماط ويحاول مطابقة عنوان URL. جانغو يتحقق من الأنماط من أعلى إلى أسفل، وإذا تم مطابقة شيء، يقوم جانغو بتمرير الطلب إلى الدالة المرتبطة بها (والتي تسمى *view*).
+
+تخيل ناقل البريد مع رسالة. تتمشى في الشارع وتفحص جميع ارقام البيوت مع الرقم الموجود في الرسالة. اذا كان مطابقا ، تضع الرسالة هناك. هذه هي الطريقة التي يعمل urlresolver بها!
+
+في الدالة *view*، تتم جميع الأمور المثيرة للاهتمام: يمكننا أن ننظر إلى قاعدة بيانات للبحث عن بعض المعلومات. ربما طلب المستخدم بتغيير شيء ما في البيانات؟ مثلما تقول الرسالة: "يرجى تغيير وصف وظيفتي". يمكن ل * view* التحقق مما إذا كان مسموحا لك القيام بذلك، ثم تحديث الوصف الوظيفي لك وإرسال رسالة مرة أخرى: "تم!" ثم * view* يولد استجابة و جانغو يمكن أن يرسلها إلى متصفح الويب الخاص بالمستخدم.
+
+بالطبع الوصف اعلاه مبسط كثيرا ، لكنك لست في حاجة لمعرفة كل المعلومات التقنية حاليا، الحصول على فكرة عامة كافي.
+
+لذلك بدلا من الغوص كثيرا في التفاصيل، نحن سوف نبدأ ببساطة بصناعة شيء باستخدام جانغو وسنتعلم كل الأجزاء المهمة على طول الطريق!
\ No newline at end of file
diff --git a/ar-SA/django_admin/README.md b/ar-SA/django_admin/README.md
new file mode 100644
index 00000000000..8acd42ffa88
--- /dev/null
+++ b/ar-SA/django_admin/README.md
@@ -0,0 +1,57 @@
+# مشرف Django
+
+لإضافة وتعديل وحذف المشاركات التي قمنا بإضافتها، سوف نستخدم دجانغو المشرف.
+
+دعنا نفتح ملف `blog/admin.py` في محرر الأكواد ونبدل محتوياته بهذا:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+كما ترون، نقوم باستيراد (تضمين) نموذج المشاركة المحدد في الفصل السابق. لجعل نموذجنا مرئيا على صفحة المشرف، نحن بحاجة إلى تسجيل النموذج مع `admin.site.register(Post)`.
+
+حسنا حان الوقت للنظر في نموذجنا. تذكر أن تقوم بتشغيل `python manage.py runserver` في وحدة التحكم لتشغيل خادم ويب. اذهب إلى المتصفح واكتب http://127.0.0.1:8000/admin/. ستظهر لك صفحة تسجيل دخول مثل هذه:
+
+![صفحة تسجيل الدّخول](images/login_page2.png)
+
+لتسجيل الدخول، تحتاج إلى إنشاء مستخدم *superuser*-حساب مستخدم له السيطرة على كل شيء في الموقع. ارجع إلى سطر الأوامر، واكتب `python manage.py createsuperuser`,، ثم اضغط على إنتر.
+
+> تذكر، لكتابة الأوامر الجديدة أثناء تشغيل خادم الويب، إفتح نافذة جديدة وفعل البيئة الإفتراضية الخاصة بك. علينا إعادة النظر في كيفية كتابة أوامر جديدة خلال فصل **أول مشروع جانغو لك!** ، في المقطع **بدء تشغيل خادم ويب**.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+عند الطلب، اكتب اسم المستخدم (أحرف صغيرة، لا مسافات)، وعنوان البريد الإلكتروني، وكلمة المرور. **لا تقلق لأنك لا تستطيع رؤية كلمة السر التي تكتبها- هذا ما يجب ان يحصل. ** اكتبها واضغط `ادخل` لتكمل. يجب أن يظهر الناتج على هذا النحو (حيث يجب أن يكون اسم المستخدم والبريد الإلكتروني هو اسم المستخدم الخاص بك):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+ارجع إلى المتصفح. سجل الدخول باستخدام بيانات اعتماد المستخدم الخارق التي اخترتها؛ يجب أن ترى لوحة قيادة دجانغو المشرف.
+
+![دجانغو المشرف](images/django_admin3.png)
+
+اذهب إلى Posts وجرب. أضف خمس أو ست مقالات. لا تقلق بشأن المحتوى –- سيكون في جهازك الشخصي فقط – تستطيع نسخ النص الموجود في هذه الصفحة لاختصار الوقت. :)
+
+تأكد من أن اثنين أو ثلاث مشاركات على الأقل (ليس جميعها) لها تاريخ نشر. سوف يكون هذا مفيد لنا في وقت لاحق.
+
+![دجانغو المشرف](images/edit_post3.png)
+
+إذا كنت تريد معرفة المزيد حول مشرف دجانغو من خلال قراءة دليل جانقو: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+ربما تكون هذه لحظة جيدة لشرب كوب من القهوة (أو الشاي) أو لتناول الطعام لإعادة تنشيط نفسك. لقد قمت بإنشاء أول نموذج جانغو خاص بك أنت تستحق الإستراحة قليلا!
\ No newline at end of file
diff --git a/ar-SA/django_forms/README.md b/ar-SA/django_forms/README.md
new file mode 100644
index 00000000000..3b8941efd18
--- /dev/null
+++ b/ar-SA/django_forms/README.md
@@ -0,0 +1,480 @@
+# نماذج جانغو
+
+الشيء الأخير الذي نريد القيام به على موقعنا هو خلق وسيلة لطيفة لإضافة وتحرير مشاركات مدونتنا. دجانغو `admin` جميل ، لكن من الصعب تخصيصه وجعله جميلا. مع `forms` سيكون لدينا سلطة مطلقة على واجهتنا – يمكن أن نفعل أي شيء تقريبا يمكن أن نتصور!
+
+الشيء الجميل حول أشكال جانغو هو أنه يمكننا تخصيص واحد من الصفر أو إنشاء `ModelForm` الذي سيحفظ نتيجة النموذج في الشكل.
+
+هذا بالضبط ما نريد فعله سننشئ شكل لنمودج `Post`.
+
+مثل كل جزء مهم من دجانغو، فإن النماذج لها ملف خاص بها `forms.py`.
+
+نحن بحاجة إلى إنشاء ملف بهذا الاسم في دليل `blog`.
+
+    blog
+       └── forms.py
+    
+
+حسنًا، دعونا نفتحه في محرر التعليمات البرمجية (أي في البرنامج الذي تكتب فيه الأكواد) ونكتب التعليمات البرمجية التالية:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+نحتاج أولا الى جلب و احضار نماذج جانغو (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`,، كما كنت تظن ربما، هو اسم النموذج. نحن بحاجة إلى أن نقول لدجانغو ان هذا النموذج هو `ModelForm`(لذلك جانغو ستقوم ببعض السحر `forms.ModelForm` هو المسؤول عن ذلك.
+
+تاليا ، لدينا `class Meta` والذي يقول لدجانغو اي نمودج يجب استخدامه لإنشاء الشكل (`model = Post`).
+
+وأخيراً، يمكننا أن نقول ياي حقول يجب ان تنتهي في شكلنا. في هذا السيناريو نريد فقط `title` و `text` عرضه – – `author` ينبغي أن يكون الشخص الذي قام بتسجيل هو (أنت!) ويجب تعيين `created_date` تلقائياً عندما نقوم بإنشاء مشاركة (أي في التعليمات البرمجية)، اليس كذالك؟
+
+وهذا كل شيء! كل ما يتعين علينا فعله الآن هو استخدام الشكل في *view* وعرضه في نموذج.
+
+لذلك مرة أخرى سنقوم بإنشاء رابط إلى صفحة، UR، والعرض والقالب.
+
+## رابط لصفحة مع الشكل
+
+قبل أن نضيف الرابط، نحتاج إلى بعض الأيقونات لاستخدامها كأزرار للرابط. لهذا البرنامج التعليمي، قم بتنزيل [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) وحفظه في المجلد `blog/templates/blog/icons/`
+
+> ملاحظة: لتنزيل صورة SVG، قم بفتح قائمة السياق على الرابط (عادة بالنقر على اليمين عليه) واختر "حفظ الرابط ك". في مربع الحوار الذي يسألك أين تحفظ الملف، انتقل إلى دليل `djangogirl` لمشروع جانغو الخاص بك. وفي ذلك إلى الدليل الفرعي `blog/templates/blog/icons`، وحفظ الملف هناك.
+
+حان الوقت لفتح `blog/templates/blog/base.html` في محرر التعليمات البرمجية. الآن يمكننا استخدام ملف الأيقونة هذا داخل قالب القاعدة كما يلي. في عنصر `div` داخل قسم `header` ، سنضيف رابط قبل عنصر `h1`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+لاحظ أننا نريد تسمية العرض الجديد `post_new`. الـ SVG icon [](https://icons.getbootstrap.com/icons/file-earmark-plus/) مقدم من [Bootstrap Icons](https://icons.getbootstrap.com/) وسوف يعرض أيقونة صفحة مع علامة زائد. نحن نستخدم موجه قالب جانغو يسمى `include`. سيؤدي هذا إلى حقن محتوى الملف في قالب جانغو. متصفح الويب يعرف كيفية التعامل مع هذا النوع من المحتوى دون أي معالجة أخرى.
+
+> يمكنك تنزيل جميع أيقونات Bootstrap [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). فك ضغط الملف وانسخ جميع ملفات صور SVG في مجلد جديد داخل `blog/templates/blog/` يسمى `icons`. بهذه الطريقة يمكنك الوصول إلى أيقونة مثل `pencil-fill.svg` باستخدام مسار الملف `blog/templates/blog/icons/pencil-fill.svg`
+
+بعد تعديل السطر ، يجب أن يبدو ملف HTML الخاص بك مثل هذا:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+
+```
+
+بعد حفظ و تحديث الصفحة : http://127.0.0.1:8000 سوف ترى خطأ مألوف! `NoReverseMatch` هل هذا ما حدث معك/معكي؟ جيد !!
+
+## عنوان الموقع URL
+
+نقوم بفتح `blog/urls.py` في محرر التعليمات البرمجية وإضافة سطر:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+وسوف تبدو التعليمات البرمجية النهائية هكذا:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+بعد تحديث الموقع، نرى `AttributeError`، حيث أننا ليس لدينا `post_new` طريقة عرض منفذة. دعونا نضيفها الآن.
+
+## عرض post_new
+
+حان الوقت لفتح `blog/views. y` الملف في محرر التعليمات البرمجية وإضافة الأسطر التالية مع بقية صفوف `from`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+عندها *view* الخاصة بنا:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+لإنشاء نموذج `Post` جديد، نحن بحاجة إلى استدعاء `PostForm()` وتمريرها إلى القالب. سنعود لهذا *view* لكن الأن دعونا ننشئ شكل نمودج سريعا.
+
+## القالب
+
+نحن بحاجة إلى إنشاء ملف `post_edit.html` في الدليل `blog/templates/blog`، وفتحه في محرر التعليمات البرمجية. لجعل النموذج يعمل نحن بحاجة إلى عدة أشياء:
+
+* علينا عرض الشكل. يمكننا أن نفعل ذلك عبر (على سبيل المثال{% raw %}`{{ form.as_p }}`{% endraw %}.
+* يجب تغليف السطر أعلاه مع عنصر نموذج HTML: `<form method="POST">...</form>`.
+* ونحن بحاجة إلى زر `Save`. ونحن نفعل ذلك مع زر HTML: `<button type="submit">Save</button>`.
+* وأخيراً، فقط بعد افتتاح العلامة `<form ...>` نحن بحاجة إلى إضافة {% raw %} `{% csrf_token %}`{% endraw %}. هذا أمر مهم جداً، لأنه يجعل النماذج الخاصة بك آمنة! إذا كنت قد نسيت هذا قليلاً، سيشكو جانغو عند محاولة حفظ النموذج:
+
+![صفحة الـ CSFR المحظورة](images/csrf2.png)
+
+حسنًا، دعونا نرى كيف يجب أن تبدو HTML في `post_edit.html`:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+حان وقت التحديث! ياي! يتم عرض النموذج الخاص بك!
+
+![نموذج جديد](images/new_form2.png)
+
+ولكن انتظر لحظة! عندما تكتب شيئا في حقول `title` و `text` ومحاولة حفظه، ما الذي سيحدث؟
+
+لا شيء! نحن مرة أخرى في نفس الصفحة و النص الخاص بنا يذهب… و لم تتم إضافة أي مشاركة جديدة. إذاً ماذا خطأ؟
+
+الجواب: لا شيء. نحن بحاجة إلى العمل أكثر قليلاً في *view*.
+
+## حفظ الشكل
+
+افتح `blog/views.py` مرة أخرى في محرر التعليمات البرمجية. حاليا كل ما لدينا في العرض `post_new` هو التالي:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+عندما نسلم الشكل، يتم أخذنا إلى نفس المكان، ولكن هذه المرة لدينا بيانات أكثر في `request`، وبشكل أكثر تحديداً في `request.POST` (التسمية ليس لها علاقة بمشاركات المدونة؛ إنها تتعلق بحقيقة أننا "ننشر" البيانات). تذكر كيف في ملف HTML ، تعريفنا `<form>` لديه المتغير `method="POST"`؟ جميع الحقول من النموذج الآن في `request.POST`. لا يجب إعادة تسمية `POST` الى أي شيء آخر (القيمة الوحيدة الصالحة ل `method` هي`GET`، ولكن ليس لدينا وقت لشرح الفرق).
+
+لذا في *view* الخاص بنا لدينا حالتين منفصلتين للتعامل معهما: أولا، عندما نصل إلى الصفحة لأول مرة ونريد نموذج فارغ، وثانيا، عندما نعود إلى *view* مع جميع بيانات النموذج التي كتبناها للتو. لذا نحن بحاجة إلى إضافة شرط (سنستخدم `if` لذلك):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+حان الوقت لملء النقاط `[...]`. إذا كانت الطريقة `` `POST` إذاً نريد بناء `PostForm` مع بيانات من النموذج، أليس كذلك؟ سوف نفعل ذلك على النحو التالي:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+الشيء التالي هو التحقق مما إذا كان النموذج صحيح (تم تعيين جميع الحقول المطلوبة ولم يتم تقديم أية قيم غير صحيحة). ونحن نفعل ذلك عبر `form.is_valid()`.
+
+نتحقق مما إذا كان النموذج صالح وإذا كان كذلك، يمكننا حفظه!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+في الأساس، لدينا أمرين هنا: نحفظ النموذج مع `form.save` ونضيف مؤلف (بما انه لم يكن هناك مجال ل `author` في `PostForm` وهذا الحقل مطلوب). `commit=False` يعني أننا لا نريد حفظ نموذج `Post` بعد--نريد إضافة الكاتب أولاً. في غالب الوقت ستستخدم `form.save()` بدون `commit=False` ولكن في هذه الحالة، نحن بحاجة لتوريده. `post.save()` سوف يحافظ على التغييرات (إضافة المؤلف) ويتم إنشاء مشاركة مدونة جديدة!
+
+وأخيرا، سيكون أمرا رائعا إذا تمكنا من الانتقال مباشرة إلى صفحة `post_detail` لمشاركتنا التي تم إنشاؤها حديثا في المدونة، أليس كذلك؟ ولتحقيق ذلك، نحتاج إلى استيراد:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+أضفه في بداية الملف. والآن يمكننا أن نقول: "انتقل إلى صفحة `post_detail` للمشاركة التي تم إنشاؤها حديثا":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` هو اسم العرض الذي نريد الذهاب اليه. تذكر أن هذا *view* يتطلب متغير `pk`؟ لتمريرها إلى العرض، نستخدم `pk=post.pk`، حيث `post` هي مشاركة المدونة التي تم إنشاؤها حديثا!
+
+حسنا، لقد تحدثنا كثيرا، ولكن ربما نريد أن نرى ما يبدو عليه *view* الآن، أليس كذلك؟
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+دعونا نرى ما إذا كان يعمل. اذهب إلى صفحة http://127.0.0.1:8000/post/new/,، اضف `title` و `text`،احفظه ، ها انت الآن! تم إضافة مشاركة المدونة الجديدة وسيتم إعادة توجيهك إلى الصفحة `post_detail`!
+
+ربما لاحظتم أننا نضع تاريخ النشر قبل حفظ المشاركة. وفي وقت لاحق سوف نقدم *publish button* في **Django Girls Tutorial: Extensions**.
+
+هذا رائع!
+
+> وبما أننا استخدمنا مؤخرا واجهة المشرف في جانغو، فإن النظام يعتقد حاليا أننا لا نزال مسجلين الدخول. هناك بعض الحالات التي يمكن أن تؤدي بنا إلى تسجيل الخروج (إغلاق المتصفح، إعادة تشغيل DB، إلخ.). إذا وجدت عند إنشاء مشاركة، أنك تحصل على أخطاء تشير إلى عدم وجود مستخدم مسجل الدخول، انتقل إلى صفحة المشرف http://127.0.0.1:8000/admin وسجل الدخول مرة أخرى. وهذا سيحل المشكلة مؤقتاً. هناك إصلاح دائم في انتظاركم في فصل **Homework: add security to your website!** بعد البرنامج التعليمي الرئيسي.
+
+![خطأ في تسجيل الدخول](images/post_create_error.png)
+
+## التحقق من صحة النموذج
+
+الآن، سوف نريكم كيف أن أشكال جانغو رائعة. يجب أن تحتوي مشاركة المدونة على حقول `title` و `text`. في نموذج `Post` لدينا لم نقل أن هذه الحقول (على عكس `published_date` غير مطلوبة. لذلك جانغو، بشكل افتراضي، يتوقع أن يتم تعيينهم.
+
+حاول حفظ النموذج بدون `title` و `text`. خمن ما سيحدث!
+
+![التحقق من صحة النموذج](images/form_validation2.png)
+
+جانغو يحرص على التحقق من صحة جميع الحقول في شكلنا ان كانت صحيحة. أليس هذا رائع؟
+
+## تحرير النموذج
+
+الآن نحن نعرف كيفية إضافة مشاركة جديدة. ولكن ماذا لو أردنا تعديل واحدة موجودة بالفعل؟ هذا مشابه جدا لما قمنا به. لنقم بإنشاء بعض الأمور الهامة بسرعة. (إذا كنت لا تفهم شيئا، يجب أن تسأل المدرب الخاص بك أو تنظر في الفصول السابقة، لأننا غطينا جميع هذه الخطوات مسبقاً.)
+
+أولا، دعونا نحفظ الرمز الذي يمثل زر التحرير. قم بتنزيل [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) وحفظه في الموقع `blog/templates/blog/icons/`.
+
+افتح `blog/templates/blog/post_detail.html` في محرر التعليمات البرمجية وأضف التعليمات البرمجية التالية داخل عنصر `article`:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+بحيث يبدو القالب كما يلي:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+افتح `blog/urls.py` في محرر التعليمات البرمجية، وأضف هذا السطر:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+سنقوم بإعادة استخدام القالب `blog/templates/blog/post_edit.html`، لذلك آخر شيء مفقود هو *view*.
+
+دعونا نفتح `blog/views.py` وإضافة هذا في نهاية الملف:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+يبدو هذا بالضبط تقريبا نفس عرض `post_new`، أليس كذلك؟ ولكن ليس تماما. لسبب واحد، نحن نمرر عامل `pk` إضافي من `urls`. بعد ذلك، نحصل على نموذج `Post` الذي نريد تعديله مع `get_object_or_404(Post, pk=pk)` وثم عندما نقوم بإنشاء نموذج، فإننا نمرر هذا المنشور كـ `instance`، كلاهما عندما نحفظ النموذج…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…وعندما نكون قد فتحنا للتو نموذج مع هذا المنشور للتحرير:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+حسنا، دعونا نختبر إذا كان يعمل! لننتقل إلى صفحة `post_detail`. يجب أن يكون هناك زر تعديل في الركن العلوي الأيسر:
+
+![زر التعديل](images/edit_button2.png)
+
+عند النقر عليه سترى النموذج مع مشاركة مدونتنا:
+
+![تعديل النموذج](images/edit_form2.png)
+
+لا تتردد في تغيير العنوان أو النص وحفظ التغييرات!
+
+تهانينا! أصبح تطبيقك أكثر وأكثر اكتمالاً!
+
+إذا كنت بحاجة إلى مزيد من المعلومات حول نماذج جانغو، فيجب عليك قراءة الوثائق: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## الحماية
+
+التمكن من إنشاء مشاركات جديدة بالنقر على رابط رائع! ولكن في الوقت الراهن، أي شخص يقوم بزيارة موقع الويب الخاص بك سوف يكون قادر على انشاء مشاركة جديدة، وهذا شيء ربما لا تريده. دعونا تجعل الزر يظهر لك و ليس لأي شخص آخر.
+
+افتح `blog/templates/blog/base.html` في محرر التعليمات البرمجية، ابحث عن `div` في داخل `header` وعلامة المرساة التي وضعتها سابقاً. يجب أن تبدو هكذا:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+سوف نضيف علامة `{% if %}` أخرى إلى هذا، والذي سيجعل الرابط يظهر فقط للمستخدمين الذين تم تسجيل دخولهم كمشرفين. الآن، إنه أنت فقط! قم بتغيير عنصر `<a>` ليبدو هكذا:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+سيؤدي هذا `{% if %}` إلى إرسال الرابط إلى المتصفح فقط إذا كان المستخدم الذي يطلب الصفحة مسجل الدخول. هذا لا يحمي إنشاء مشاركات جديدة تماماً، ولكنها خطوة أولى جيدة. سنقوم بتغطية المزيد من الأمان في دروس الإضافة.
+
+تذكر رمز التحرير الذي أضفناه للتو إلى صفحة التفاصيل؟ نحن أيضا نريد إضافة نفس التغيير هناك، لذلك لن يتمكن الأشخاص الآخرون من تحرير المشاركات الموجودة.
+
+افتح `blog/templates/blog/post_detail.html` في محرر التعليمات البرمجية وابحث عن هذا السطر:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+غيره إلى هذا:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+نظرا لأنك مسجل الدخول، إذا قمت بتحديث الصفحة، فلن ترى شيئا مختلفا. حمل الصفحة في متصفح مختلف أو نافذة متخفية (تسمى "InPrivate" في Windows Edge)، على الرغم من ذلك، وسترى أن الرابط لا يظهر، ولا تعرض الأيقونة أيضا!
+
+## شيء اخر: وقت النشر!
+
+دعونا نرى ما إذا كان كل هذا يعمل على PythonAnywhere. حان الوقت لنشر آخر!
+
+* أولاً، فوّض التعليمات البرمجية الخاصة بك، وادفعها إلى GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* وبعد ذلك، في وحدة [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(تذكر أن تستبدل `<your-pythonanywhere-domain>` بالمجال الفرعي لـ PythonAnywhere الفعلي، بدون أقواس الزاوية. )
+
+* أخيراً، اقفز إلى ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (استخدم زر القائمة في الجزء العلوي الأيمن من وحدة التحكم) واضغط على **Reload**. قم بتحديث مدونة https://subdomain.pythonanywhere.com لرؤية التغييرات.
+
+هذا ينبغي ان يكون كل شيء! مبروك:)
\ No newline at end of file
diff --git a/ar-SA/django_installation/README.md b/ar-SA/django_installation/README.md
new file mode 100644
index 00000000000..a0039c83b8e
--- /dev/null
+++ b/ar-SA/django_installation/README.md
@@ -0,0 +1,7 @@
+# تثبيت جانغو
+
+> **ملاحظة** إذا كنت تستخدم كروم بوك، تخطي هذا الفصل وتأكد من اتباع [تعليمات إعداد كروم بوك](../chromebook_setup/README.md).
+> 
+> **ملاحظة** إذا كنت قد عملت بالفعل على [خطوات التثبيت](../installation/README.md) إذاً لقد أنهيت هذا بالفعل - يمكنك الانتقال مباشرة إلى الفصل التالي!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ar-SA/django_installation/instructions.md b/ar-SA/django_installation/instructions.md
new file mode 100644
index 00000000000..a966a271c66
--- /dev/null
+++ b/ar-SA/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> هذا القسم يستند على دورة تعليمية من فتيات الجزر المهووسات (https://github.com/ggcarrots/django-carrots).
+> 
+> جزء من هذا القسم يستند [django-marcador tutorial](http://django-marcador.keimlink.de/) المرخص لها بمرخصة بموجب المشاع الإبداعي   إسناد-على غرار 4.0 الترخيص الدولي. البرنامج التعليمي django-marcador حقوق الطبع والنشر من قبل Markus Zapke-Gründemann وآخرون.
+
+## البيئة الافتراضية
+
+قبل تنصيب دجانغو ، سوف نقوم بتنصيب اداة جد مهمة وستساعدنا كثيرا،في الحفاظ على بيئة كتابة التعليمات البرمجية الخاصة بك مرتبة على جهاز الكمبيوتر. من الممكن تخطي هذه الخطوة، ولكن نحن يوصي بشدة بها. بدءاً من الإعداد الأفضل والذي سيحميك من الكثير من المتاعب في المستقبل!
+
+هيا لننشئ **بيئة افتراضية** ، تسمى ايضا ب *virtualenv*. سوف تعزل البيئة الإفتراضية إعدادات بايثون / دجانغو الخاص بك على أساس كل مشروع. وهذا يعني أن أية تغييرات تقوم بإجرائها على موقع واحد لن تؤثر على المواقع الأخرى التي تطورها. أنيق، أليس كذالك؟
+
+كل ما عليك القيام به هو العثور على الدليل الذي تريد إنشاء `virtualenv`؛ فيه الدليل الرئيسي الخاص بك، على سبيل المثال. في Windows قد تبدو مثل `C:\Users\Name` (حيث `Name` هو اسم تسجيل الدخول الخاص بك).
+
+> **ملاحظة:** في Windows، تأكد من أن هذا الدليل لا يحتوي على أحرف هجائية أو خاصة؛ إذا كان اسم المستخدم الخاص بك يحتوي على أحرف هجائية، استخدام دليل مختلف، على سبيل المثال `C:\djangogirls`.
+
+في هذا البرنامج التعليمي سوف نستخدم دليل جديد `djangogirls` من الدليل الرئيسي الخاص بك:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+سوف نقوم بإنشاء بيئة افتراضية تسمى `myvenv`. سوف تكون القيادة العامة في التنسيق:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+لإنشاء `virtualenv`, جديد، تحتاج إلى فتح موجه الأوامر وتشغيل `python -m venv myvenv`. وسوف تبدو كما يلي:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+حيث `myvenv` هو اسم خاص ب `virtualenv`. يمكنك استخدام أي اسم آخر، لكن حافض على الحروف الصغيرة ولا تستخدم مسافات أو لهجات أو أحرف خاصة. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+يمكننا إنشاء `virtualenv` على لينكس ونظام التشغيلOS X عن طريق تشغيل `python3 -m venv myvenv`:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+حيث `myvenv` هو اسم خاص ب `virtualenv`. يمكنك استخدام أي اسم آخر، لكن حافض على الحروف الصغيرة ولا تستخدم مسافات. كما أنها فكرة جيدة الحفاظ على الاسم قصير – سوف تستخدمه كمرجع كثيرا!
+
+> **ملاحظة:** في بعض الإصدارات من ديبيان/أوبونتو قد تتلقى الخطأ التالي:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     لم يتم إنشاء البيئة الإفتراضية بنجاح لأن ensurepip غير متوفر.  على أنظمة ديبيان/أوبونتو، تحتاج إلى تثبيت حزمة python3-venv باستخدام الأمر التالي.
+>        apt-get install python3-venv
+>     غالبا ستحتاج إستعمال sudo لتنفيد الأمر.  بعد تثبيت حزمة python3-venv، قم بإعادة إنشاء البيئة الإفتراضية الخاصة بك.
+>     
+> 
+> في هذه الحالة اتبع التعليمات تحت وثبت حزمة `python3-venv` {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **ملاحظة:** في بعض إصدارات ديبيان/أوبونتو اعداد البيئة الإفتراضية بهذه الطريقة قد يعطي هذا الخطأ:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> للالتفاف على هذا، استخدم الأمر `virtualenv` بدلاً من ذلك.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **ملاحظة:** إذا حصلت على خطأ مثل
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> قم بتنفيد الأمر:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## العمل مع virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+بدء تشغيل البيئة الإفتراضية الخاصة بك عن طريق تشغيل:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. وفي هذه الحالة، قم بفتح Windows PowerShell آخر باستخدام الخيار "تشغيل كمسؤول". ثم حاول كتابة الأمر التالي قبل تشغيل البيئة الإفتراضية الخاصة بك:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. تغيير سياسة التنفيذ قد يعرضك للمخاطر الأمنية الموضحة في موضوع التعليمات about_Execution_Policies في http://go.microsoft.com/fwlink/?LinkID=135170. هل تريد تغيير نهج التنفيذ؟ [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> الميزة هي أنه ليس عليك التبديل بين نوافذ المحرر ونوافذ سطر الأوامر
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+ابدأ بيئتك الافتراضية بتشغيل:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+تذكر أن تستبدل `myvenv` باسم `virtualenv` الذي اخترته!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+سوف تعرف أنك قمت بتفعيل الـ `virtualenv` الخاصة بك عندما ترى أن الموجه في وحدة التحكم الخاصة بك مسبوقاً بـ `(myvenv)`.
+
+عند العمل ضمن بيئة افتراضية، سيشير `python` تلقائياً إلى الإصدار الصحيح حيث يمكنك استخدام `python` بدلاً من `python3`.
+
+حسنا، لدينا كافة التبعيات الهامة في المكان. وأخيراً يمكننا تثبيت جانغو!
+
+## تثبيت جانغو {#django}
+
+الآن بما انه لديك `virtualenv` مشغل، يمكنك تثبيت جانغو.
+
+قبل أن نفعل ذلك، يجب علينا التأكد من لدينا أحدث إصدار من `pip`، البرامج التي نستخدمها لتثبيت جانغو:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### تثبيت الحزم مع المتطلبات
+
+ملف المتطلبات يحتفظ بقائمة من التبعيات ليتم تثبيتها باستخدام `pip install`:
+
+أولاً قم بإنشاء ملف `requirements.txt` داخل مجلد `djangogirls` باستخدام محرر التعليمات البرمجية الذي قمت بتثبيته سابقاً. تفعل ذلك عن طريق فتح ملف جديد في محرر التعليمات البرمجية وحفظه بإسم `requirements.txt` في مجلد `djangogirls/` سيبدو الدليل الخاص بك هكذا:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+في ملف `djangogirls/requirements.txt` يجب عليك إضافة النص التالي:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+الآن، قم بتشغيل `pip install -r requirements.txt` لتثبيت جانغو.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). إذا كان كذالك، يرجى التفكير في استخدام مكان آخر دون مسافات، علامات نطقية أو أحرف خاصة (اقتراح: `C:\djangogirls`). أنشئ virtualenv جديدة في الدليل الجديد، ثم إحذف القديمة وحاول تنفيذ الأمر أعلاه مرة أخرى. (نقل دليل virtualenv لن يعمل لأن virtualenv يستخدم مسارات مطلقة.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> إذا كنت تحصل على خطأ عند استدعاء برنامج pip على أوبونتو 12.04 الرجاء تشغيل `python -m pip install -U --force-reinstall pip` لإصلاح تثبيت برنامج pip في virtualenv.
+
+<!--endsec-->
+
+هذا كل شيء! أنت الآن على استعداد لإنشاء تطبيق جانغو (أخيرا)!
\ No newline at end of file
diff --git a/ar-SA/django_models/README.md b/ar-SA/django_models/README.md
new file mode 100644
index 00000000000..4f817ffdb62
--- /dev/null
+++ b/ar-SA/django_models/README.md
@@ -0,0 +1,201 @@
+# نماذج جانغو
+
+ما نريد أن نخلق الآن هو شيء من شأنه أن يخزن جميع المشاركات في مدونتنا. ولكن لكي نكون قادرين على القيام بذلك، نحتاج إلى الحديث قليلا عن الأشياء المسماة `objects`.
+
+## الكائنات
+
+هناك مفهوم في البرمجة يسمى `object-oriented programming`. والفكرة هي أنه بدلاً من كتابة كل شيء كتسلسل ممل من تعليمات البرمجة، يمكننا نمذجة الأشياء وتحديد كيفية تفاعلها مع بعضها البعض.
+
+ما هو الكائن؟ عبارة عن مجموعة من الخصائص واﻹجراءات. قد تبدو غريبة في البداية، لكن سنقدم لكم المثال التالي.
+
+إذا أردنا نمذجة قط، سنقوم بإنشاء كائن `Cat` يحتوي على بعض الخصائص مثل `اللون`, `العمر`, `المزاج` (مثل جيد أو سيئ، أو النعاس;))، و `المالك`(التي يمكن أن تسند إلى الكائن `الشخص` – أو ربما، في حالة قط ضآل، يمكن أن تكون الخاصية فارغة).
+
+ثم يحتوي `القط` على بعض الإجراءات: `مواء` أو `خدش` أو `إطعام` (وفي بعض الحالات نعطي القط ` طعام القط`، والتي يمكن أن تكون كائن منفصل مع خصائص، مثل `المذاق`).
+
+    القط
+    --------
+    اللون
+    العمر
+    المزاج
+    المالك
+    مواء()
+    خدش()
+    إطعام(طعام_القط)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+مبدأيا الفكرة هي وصف الأشياء الحقيقة بإستعمال البرمجة بالخصائص(تسمى` خصائص الشيئ`) و الإجراءات (تسمى`الأساليب`).
+
+كيف سننشئ مشاركات المدونة بعد ذلك؟ نحن نريد بناء مدونة، أليس كذلك؟
+
+نحن بحاجة إلى الإجابة على السؤال: ما هي وظيفة المدونة؟ ما هي الخصائص التي يجب ان تحملها؟
+
+حسنا، بالتأكيد لدينا مشاركة في مدونتنا تحتاج بعض النصوص مع محتوى وعنوان، أليس كذلك؟ سيكون جيدا ايضا معرفة من كتبها ، لذا نحن بحاجة لكاتب. وأخيرا نود معرفة متى تم إنشاء ونشر المشاركة.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+ما نوع الأشياء التي يمكن إجراؤها على مشاركة في المدونة؟ سيكون من الجميل أن يكون لديك بعض `method` التي تنشر المشاركة، أليس كذلك؟
+
+لذلك سوف نحتاج إلى أسلوب `publish`.
+
+نظراً لأننا نعرف ما نريد أن نحققه، دعونا نبدأ النمذجة في جانغو!
+
+## نماذج جانغو
+
+بمعرفة ما هو الكائن ، يمكننا انشاء نمودج للمشاركة على مدونتنا.
+
+النموذج في جانغو هو كائن من نوع خاص يتم حفظه في `database`. قاعدة بيانات هي مجموعة من البيانات. هذا هو المكان الذي ستحفض فيه معلومات حول المستخدمين ،مشاركاتك ومدونتك. سيتم استخدام قاعدة بيانات SQLite لتخزين البيانات الخاصة بنا. هذه قاعدة البيانات الإفتراضية الخاصة بجانغو-- سوف تكون كافية بالنسبة لنا الآن.
+
+يمكنك التفكير في نموذج في قاعدة البيانات كجدول مع الصفوف (بيانات) والأعمدة (الحقول).
+
+### إنشاء تطبيق
+
+لإبقاء كل شيء مرتباً، سننشئ تطبيق منفصل داخل مشروعنا. انه من الجميل ان يكون كل شيء مرتب من البداية. لإنشاء تطبيق نحن بحاجة إلى تشغيل الأمر التالي في وحدة التحكم (من `djangogirls` حيث يوجد الملف `manage.py`):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+ستلاحظ أنه تم إنشاء دليل `blog` جديد ويحتوي على عدد من الملفات الآن. يجب أن تبدو الدلائل والملفات في مشروعنا كما يلي:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+بعد إنشاء التطبيق، نحتاج أيضا أن نقول لدجانغو أنه ينبغي استخدامه. نقوم بذلك في الملف `mysite/settings.py` -- قم بفتحه في محرر التعليمات البرمجية الخاص بك. نحن بحاجة إلى العثور على `INSTALLED_APPS` وإضافة سطر يحتوي على `'blog.apps.BlogConfig',` فقط فوق `]`. المنتج النهائي ينبغي أن يبدو هكذا:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### إنشاء نمودج مشاركة في المدونة
+
+في ملف `blog/models.py` نحدد كافة كائنات تسمى `Models`--وهذا هو المكان الذي سنحدد فيه مشاركات مدونتنا.
+
+دعونا نفتح `blog/models.py` في محرر التعليمات البرمجية، وإزالة كل شيء منه، وكتابة التعليمات البرمجية مثل هذا:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> تحقق جيدا من استخدام حرفين أسفل السطر (`_`) على كل جانب من `str`.  . هذه الاتفاقية تستخدم كثيرا في بايثون وأحيانا كما نسميها "dunder" (اختصارا ل "double-underscore").
+
+يبدو مخيفا، أليس كذلك؟ ولكن لا تقلق--سوف نشرح ماذا تعني هذه السطور!
+
+جميع الخطوط بدءاً `from` أو `import` هي سطور تضيف بعض أجزاء من ملفات أخرى. بدلاً من نسخ ولصق نفس الأشياء في كل ملف، يمكن أن ندرج بعض الأجزاء مع `من... import ...`.
+
+`class Post(models.Model):` --هذا السطر يحدد نموذج لدينا (و هو`الكائن`).
+
+- `class` هي كلمة أساسية خاصة التي تشير إلى أنه علينا تحديد كائن.
+- `Post` هو اسم نموذجنا. ويمكننا أن نعطيه اسما مختلفا (ولكن يجب علينا تجنب الأحرف الخاصة والمسافاة). ابدأ دائما بإسم فئة مع حرف كبير.
+- `models.Model` يعني أن المشاركة هي نموذج لجانغو، لذلك دجانغو يعرف أنه يجب حفظها في قاعدة البيانات.
+
+والآن علينا أن نحدد الخصائص التي كنا نتحدث عنها`title`, `text`, `created_date`, `published_date` و `author`. للقيام بذالك نحن بحاجة إلى تحديد نوع كل حقل (النص؟ رقم؟ تاريخ؟ علاقة لكائن آخر، مثل مستخدم)
+
+- `models.CharField` –--وهكذا يمكنك تحديد نص مع عدد محدود من الأحرف.
+- `models.TextField` – هذا لنص طويل دون حد. يبدو مثاليا لمدونة لمشاركة المحتوى، أليس كذلك؟
+- `models.DateTimeField` --هذا هو التاريخ والوقت.
+- `models.ForeignKey`--وهذا ارتباط إلى نموذج آخر.
+
+نحن لن شرح كل شيء من التعليمات البرمجية هنا لأنه سوف يستغرق الكثير من الوقت. ينبغي أن نلقي نظرة على وثائق جانغو إذا كنت ترغب في معرفة المزيد عن حقول النموذج وكيفية تحديد الأشياء غير تلك المذكورة أعلاه (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+وماذا عن `def publish(self):`؟ هذا هو بالضبط الأسلوب `publish` الذي كنا نتحدث عنه. `def` يعني أن هذا أسلوب دالة و `publish` اسم الأسلوب. يمكنك تغيير اسم الأسلوب إذا أردت. حكم التسمية أن نستخدم حروف صغيرة وتسطيرات أسفل السطر بدلاً من المسافات. على سبيل المثال، يمكن استدعاء أسلوب والذي يقوم بحساب متوسط السعر `calculate_average_price`.
+
+أساليب كثيرا ما `return` شيئا. هناك مثال على ذلك في أسلوب `__str__`. في هذا السيناريو، عندما ندعو `__str__()` سوف تحصل على نص (**string**) مع عنوان البريد.
+
+كما لاحظ أن كلا `def publish(self):` و `def __str__(self):` يتم فصلها داخل فئتنا. نظراً لأن بايثون حساسة للمسافة البيضاء، نحن بحاجة لوضع مسافة بادئة لأساليب عملنا داخل الفئة. بخلاف ذلك، الأساليب التي لا تنتمي إلى الفئة، ويمكنك الحصول على بعض السلوك الغير متوقع.
+
+إذا كان هناك شيء لا يزال غير واضح حول النماذج، لا تتردد بسؤال المدرب الخاص بك! نحن نعلم أنها معقدة، لا سيما عندما كنت تتعلم ما الأشياء والمهام في نفس الوقت. ولكن نأمل أن يبدو أقل سحرا قليلا الآن!
+
+### إنشاء جداول للنماذج في قاعدة البيانات الخاصة بك
+
+الخطوة الأخيرة هنا لإضافة نموذجنا الجديد إلى قاعدة البيانات الخاصة بنا. أولاً يجب أن تجعل جانغو يعرف أن لدينا بعض التغييرات في نموذجنا. (لقد أنشئناه للتو!) إذهب إلى إطار وحدة التحكم الخاصة بك واكتب `python manage.py makemigrations blog`. ستبدو كالشكل التالي:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**ملاحظة:** تذكر أن تقوم بحفظ الملفات التي يمكنك تحريرها. وبخلاف ذلك، سيقوم الكمبيوتر بتنفيد النسخة السابقة والتي قد تعطيك رسائل خطأ غير متوقعة.
+
+أعدت دجانغو ملف ترحيل لنا وعلينا الآن أن نطبقه على قاعدة البيانات الخاصة بنا. اكتب `python manage.py migrate blog` ويكون الإخراج كما يلي:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+يا هلا! الآن لدينا نموذج آخر في قاعدة بياناتنا! سيكون من الجميل أن نراه ، اليس كذالك؟ انتقل إلى الفصل التالي لمعرفة الشكل الذي تبدو عليه مشاركتك!
\ No newline at end of file
diff --git a/ar-SA/django_orm/README.md b/ar-SA/django_orm/README.md
new file mode 100644
index 00000000000..983e701b9e6
--- /dev/null
+++ b/ar-SA/django_orm/README.md
@@ -0,0 +1,221 @@
+# ORM جانغو و Querysets
+
+في هذا الفصل سوف تتعلم كيف تتصل جانغو بقاعدة البيانات وتقوم بتخزين البيانات فيها. دعونا نغوص في الشرح!
+
+## ما هو QuerySet؟
+
+QuerySet هو، في جوهره، قائمة الكائنات من نموذج معين. QuerySet تسمح لك بقراءة البيانات من قاعدة البيانات، وتصفيها وتطلبها.
+
+من السهل التعلم عبر الأمثلة ، دعونا نجرب ذالك. هيا بنا؟
+
+## Django shell
+
+إفتح وحدة التحكم المحلية الخاصة بك (ليس على PythonAnywhere) واكتب هذا الأمر:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+التأثير يجب أن يكون مثل:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+أنت الآن في وحدة التحكم التفاعلية لجانغو. إنها تماماً مثل موجه بايثون، ولكن مع بعض سحر جانغو الإضافي. :) يمكنك استخدام جميع أوامر بايثون هنا أيضاً.
+
+### كل الكائنات
+
+دعونا نحاول عرض جميع المشاركات لدينا أولاً. يمكنك القيام بذلك باستخدام الأمر التالي:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+اووبس! ظهر خطأ. يقول لنا أنه لا يوجد أي مشاركة. هذا صحيح لقد نسينا استيراده أولا!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+نستورد النموذج `Post` من`blog.models`. لنحاول عرض جميع المشاركات مرة أخرى:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+هذه قائمة باالمشاركات التي أنشأنا في وقت سابق! قمنا بإنشاء هذه المشاركات باستخدام واجهة المشرف جانغو. ولكن الآن نحن نريد انشاء مشاركات جديدة باستخدام بيثون، فكيف نفعل ذلك؟
+
+### إنشاء كائن
+
+هذه هي الطريقة التي تقوم بها بإنشاء مشاركة كائن جديد في قاعدة البيانات:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+ولكن لدينا عنصر واحد في عداد المفقودين هنا `me`. نحن بحاجة إلى تمرير مثيل من نموذج `User` كمؤلف. كيف نفعل ذلك؟
+
+دعونا نسترد نموذج المستخدم الأول:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+اية مستخدمين لدينا في قاعدة البيانات الخاصة بنا؟ جرب هذا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+هذا هو المستخدم المتميز الذي أنشأناه سابقاً! دعونا نحصل على مثيل للمستخدم الآن (قم بضبط هذا السطر لاستخدام اسم المستخدم الخاص بك):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+كما ترون، نحن الآن `نحصل على` `مستخدم` مع `اسم مستخدم` يساوي 'ola'. رائع!
+
+الآن يمكننا أخيرا إنشاء مشاركة:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+يا هلا! هل تريد التحقق من ما إذا كان يعمل؟
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+هاهي ذا! مشاركة آخرى في القائمة!
+
+### إضافة المزيد من المشاركات
+
+يمكنك الآن الحصول على القليل من المرح وإضافة المزيد من المشاركات لنرى كيف يعمل. أضف اثنين أو ثلاثة آخرين ثم انتقل إلى الجزء التالي.
+
+### تصفية الكائنات
+
+جزء كبير من QuerySets هو القدرة على تصفيتهم. لنفترض أننا نريد العثور على جميع المشاركات التي قام المستخدم ola بتأليفها. سنقوم باستخدام `filter` بدلاً من `all` في `Post.objects.all()`. بين قوسين نوضح ما هي الشروط التدوينة تحتاج إلى تلبية في نهاية المطاف في queryset لدينا. وفي حالتنا، الشرط أن `author` يجب أن يكون متساوي مع `me`. طريقة كتابتها في دجانغو `author=me`. الأن قطعتنا من الكود تبدو بهذا الشكل:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+أو ربما نريد أن نرى جميع المشاركات التي تحتوي على كلمة 'title' في الحقل `title`؟
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **ملاحظة** هناك شرطتين أسفل السطر (`_`) بين `title` و `contains`. يستخدم ORM دجانغو هذه القاعدة لفصل أسماء الحقول ("title") والعمليات أو الفلاتر ("contains"). إذا قمت باستخدام تسطير واحد فقط، سوف تحصل على خطأ مثل "FieldError: Cannot resolve keyword title_contains".
+
+يمكنك أيضا الحصول على قائمة بجميع المشاركات المنشورة. علينا القيام بذلك بتصفية جميع المشاركات التي قد `published_date` في الماضي:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+للأسف، لم يتم نشر المشاركة التي أضفناها من وحدة تحكم بايثون بعد. ولكن يمكننا تغيير ذلك! احصل أولا على مثال لمشاركة نريد نشرها:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+ثم أنشرها باستخدام طريقة `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+الآن في محاولة للحصول على قائمة المشاركات المنشورة مرة أخرى (اضغط على مفتاح السهم لأعلى ثلاث مرات واضغط `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### العناصر الصادرة
+
+QuerySets تسمح لك أيضا بترتيب قائمة الكائنات. دعونا نحاول ترتيبها حسب الحقل `created_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+يمكننا أيضا عكس الترتيب بإضافة `-` في البداية:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### الاستفسارات المعقدة من خلال سلسلة الأساليب
+
+كما رأيت، بعض الطرق في `Post.objec` تعيد QuerySet. نفس الأساليب يمكن أيضاً استدعاؤها على QuerySet، وبعد ذلك ستعيد QuerySet جديدة. وهكذا، يمكنك الجمع بين تأثيرها من خلال **سلسلة** بعضها البعض:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+هذا حقا قوي ويتيح لك كتابة استفسارات معقدة جدا.
+
+رائع! أنت الآن جاهز للجزء التالي! لإغلاق الشل shell، اكتب هذا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ar-SA/django_start_project/README.md b/ar-SA/django_start_project/README.md
new file mode 100644
index 00000000000..51e0cc45adf
--- /dev/null
+++ b/ar-SA/django_start_project/README.md
@@ -0,0 +1,260 @@
+# مشروعك الأول في جانغو!
+
+> هذا القسم يستند على دورة تعليمية من فتيات الجزر المهووسات (https://github.com/ggcarrots/django-carrots).
+> 
+> جزء من هذا القسم يستند [django-marcador tutorial](http://django-marcador.keimlink.de/) المرخص لها بمرخصة بموجب المشاع الإبداعي   إسناد-على غرار 4.0 الترخيص الدولي. البرنامج التعليمي django-marcador حقوق الطبع والنشر من قبل Markus Zapke-Gründemann وآخرون.
+
+سنقوم بإنشاء مدونة صغيرة!
+
+الخطوة الأولى هي إنشاء مشروع جانغو جديد. في الأساس، وهذا يعني أننا سوف نشغل بعض البرامج النصية التي تقدمها جانغو والتي من شأنها أن تخلق الهيكل العظمي لمشروع دجانغو بالنسبة لنا. هذه مجرد حفنة من الدلائل والملفات التي سوف نستخدمها في وقت لاحق.
+
+أسماء بعض الملفات والدلائل مهمة جداً لجانغو. يجب عدم إعادة تسمية الملفات التي نحن على وشك إنشائها. نقلهم إلى مكان مختلف ليست فكرة جيدة. جانغو تحتاج إلى الحفاظ على بنية معينة لتكون قادرة على العثور على أشياء مهمة.
+
+> تذكر أن تقوم بتشغيل كل شيء في virtualenv. إذا كنت لا ترى بادئة `(myvenv)` في وحدة التحكم الخاصة بك، تحتاج إلى تنشيط virtualenv الخاص بك. قمنا بشرح طريقة فعل ذالك في **Django installation** في قسم **Working with virtualenv**. كتابة `myvenv\Scripts\activate` في وندوز ، او `source myvenv/bin/activate` في ماك ولينكس سيقوم لك بذالك.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+في وحدة التحكم الخاصة بك ماكنتوش أو لينكس، يجب أن تقوم بتشغيل الأمر التالي. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> الفاصلة `.` أمر بالغ الأهمية لأنه يخبر السكريبت لتثبيت دجانغو في الدليل الحالي الخاص بك (`.` الفاصلة هي إشارة قصيرة).
+> 
+> **ملاحظة** عند كتابة الأمر أعلاه، تذكر أن تكتب فقط الجزء الذي يبدأ ب `django-admin`. الجزء `(myvenv) ~/djangogirls$` الموضح هنا هو مجرد مثال من الموجه الذي سيدعو المدخلات الخاصة بك على سطر الأوامر الخاص بك.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+في وحدة التحكم الخاصة بوندوز، يجب أن تقوم بتشغيل الأمر التالي. **Don't forget to add the period (or dot) `.` at the end!**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> الفاصلة `.` أمر بالغ الأهمية لأنه يخبر السكريبت لتثبيت دجانغو في الدليل الحالي الخاص بك (`.` الفاصلة هي إشارة قصيرة).
+> 
+> **ملاحظة** عند كتابة الأمر أعلاه، تذكر أن تكتب فقط الجزء الذي يبدأ ب `django-admin.py`. الجزء (myvenv) C:\Users\Name\djangogirls>` الموضح هنا هو مجرد مثال من الموجه الذي سيدعو المدخلات الخاصة بك على سطر الأوامر الخاص بك.
+
+<!--endsec-->
+
+`django-admin.py` هو البرنامج النصي الذي سينشئ الدلائل والملفات بالنسبة لك. يجب أن يكون لديك الآن هيكل دليل يشبه هذا:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **ملاحظة** في بنية الدليل، سترى أيضا `venv` الذي أنشأناه من قبل.
+
+`manage.py` هو سكريبت يساعد في إدارة الموقع. مع أنه سوف نتمكن من (ضمن أمور أخرى) لبدء تشغيل خادم الويب على جهاز الكمبيوتر بدون تثبيت أي شيء آخر.
+
+يحتوي الملف `settings.py` على إعدادات موقعك.
+
+تذكر عندما تكلمنا عن ساعي البريد الذي يبحث اين يرمي الرسائل? `urls.py` ملف يحتوي على قائمة أنماط مستخدمة من قبل `urlresolver`.
+
+دعونا نتجاهل الملفات الأخرى في الوقت الراهن فنحن لن نغييرها. الشيء الوحيد الذي يجب تذكره هو عدم حذفها عن طريق الصدفة!
+
+## تغيير الإعدادات
+
+دعونا نجري بعض التغييرات في `mysite/settings.py`. قم بفتح الملف باستخدام محرر التعليمات البرمجية يالذي قمنا بتثبيته في وقت سابق.
+
+**ملاحظة**: ضع في اعتبارك أن `settings.py` هو ملف عادي، مثل أي ملف آخر. يمكنك فتحه من داخل محرر التعليمات البرمجية، وذلك باستخدام "ملف > فتح" قائمة الإجراأت. سيؤدي هذا بك إلى الحصول على النافذة المعتادة التي يمكنك فيها الانتقال إلى ملف `settings.py` وتحديده. بدلا من ذلك، يمكنك فتح الملف عن طريق الانتقال إلى مجلد djangogirls على سطح المكتب الخاص بك والنقر بزر الماوس الأيمن عليه. ثم، حدد محرر التعليمات البرمجية الخاصة بك من القائمة. اختيار المحرر مهم كما قد يكون لديك برامج أخرى مثبتة يمكنها فتح الملف ولكن لن تسمح لك بتحريره.
+
+سيكون من الجميل أن يكون الوقت صحيح على موقعنا على الانترنت. اذهب الى [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) وانسخ الوقت في منطقتك الزمنية (TZ) (e.g. `Europe/Berlin`).
+
+في `settings.py`، أعثر على السطر الذي يحتوي على `TIME_ZONE` وعدله لاختيار المنطقة الزمنية الخاصة بك. على سبيل المثال:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+رمز اللغة يتكون من اللغة، مثل `en` للغة الإنجليزية أو `de` للألمانية، ورمز البلد، مثل `de` لألمانيا أو `ch` لسويسرا. إذا لم تكن اللغة الإنجليزية لغتك الأصلية، يمكنك إضافة هذا لتغيير الأزرار والإشعارات الافتراضية من جانغو لتكون بلغتك. لذلك سيكون لديك زر "إلغاء" ترجم إلى اللغة التي حددتها هنا. [جانغو يأتي مع الكثير من الترجمات المعدة](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+إذا كنت تريد لغة مختلفة، قم بتغيير رمز اللغة بتغيير السطر التالي:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+سوف نحتاج أيضا إلى إضافة مسار للملفات الثابتة. ( سوف نعرف كل شيء عن الملفات الثابتة والمغلقة في وقت لاحق في البرنامج التعليمي). الانتقال إلى أسفل إلى *end* الملف، وتحت `STATIC_URL`، أضف وحدة جديدة تسمى `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+عندما يكون `DEBUG` هو `True` و `ALLOWED_HOSTS</ 0> فارغ، يتم التحقق من المضيف مع <code>['localhost', '127.0.0.1', '[::1]']`. هذا لن يطابق اسم المضيف لدينا على PythonAnywhere بمجرد نشر التطبيق لدينا لذلك سوف نقوم بتغيير الإعداد التالي:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **ملاحظة**: إذا كنت تستخدم Chromebook، أضف هذا السطر في الجزء السفلي من الملف settings.py: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> أضف أيضا `.amazonaws.com` إلى `ALLOWED_HOSTS` إذا كنت تستخدم Cloud9
+> 
+> إذا كنت تستضيف مشروعك على `Glitch.com`، دعونا نحمي مفتاح جانغو السري الذي يحتاج أن يبقى سرياً (عدا ذلك، أي شخص يعيد تعديل مشروعك يمكنه رؤيته):
+> 
+> - أولا، سنقوم بإنشاء مفتاح سري عشوائي. افتح المحطة الطرفية Glitch مرة أخرى، واكتب الأمر التالي:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     هذا يجب أن يعرض سلسلة عشوائية طويلة، مثالية لاستخدامها كمفتاح سري لموقع جانغو الجديد الخاص بك. سوف نلصق هذا المفتاح الآن في ملف `.env` الذي سيقوم Glitch بعرضه لك فقط إذا كنت مالك الموقع.
+> 
+> - أنشئ ملف `.env` في جذر مشروعك وأضف الخاصية التالية فيه:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # هنا، داخل الاقتباس الفردي، يمكنك قطع ولصق المفتاح العشوائي المنشأ أعلاه
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - ثم قم بتحديث ملف إعدادات جانغو لحقن هذه القيمة السرية وتعيين اسم موقع جانغو:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - وفي الأسفل قليلاً في نفس الملف، نقوم بحقن اسم موقع Glitch الجديد الخاص بك:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     قيمة `PROJECT_DOMAIN` يتم إنشاؤها تلقائيًا بواسطة Glitch. سوف تتوافق مع اسم مشروعك.
+
+## إعداد قاعدة البيانات
+
+هناك الكثير من برامج قواعد البيانات المختلفة التي يمكنها تخزين البيانات لموقعك. سنستخدم الإعداد الافتراضي، `sqlite3`.
+
+تم إعداد هذا بالفعل في هذا الجزء الخاص بك من الملف `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+لإنشاء قاعدة بيانات مدونتنا، دعونا تشغل الأمر التالي في وحدة التحكم: `python manage.py migrate`(نحن بحاجة إلى أن تكون في الدليل `djangogirls` الذي يحتوي على الملف `manage.py`. اذا مر كل شيء على ما يرام، سترى شيئا مثل هذا:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+ها قد انتهينا! حان الوقت لتشغيل خادم الويب ومعرفة ما إذا كان موقعنا يعمل!
+
+## بدء تشغيل خادم الويب
+
+يجب أن تكون في الدليل الذي يحتوي على ملف `manage.py`(دليل `djangogirls`). في وحدة التحكم، يمكننا أن نبدأ خادم الويب بتشغيل `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+إذا كنت في كروم بوك، استخدم هذا الأمر بدلاً من ذلك:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+أو هذا إذا كنت تستخدم Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+إذا كنت على ويندوز، و فشل هذا مع `UnicodeDecodeError`, ، استخدم هذا الأمر بدلاً من ذلك:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+الآن تحتاج إلى التحقق من أن موقعك قيد التشغيل. افتح المتصفح الخاص بك (Firefox, Chrome, Safari, Internet Explorer أو أي شيء تستخدمه) وأدخل هذا العنوان:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+إذا كنت تستخدم Chromebook و Cloud9، بدلاً من ذلك، انقر فوق عنوان URL في النافذة المنبثقة التي كان ينبغي أن تظهر في الزاوية اليمنى العليا من نافذة الأوامر حيث يعمل خادم الويب. سيبدو عنوان URL شيئًا مثل:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+أو على Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+تهانينا! لقد قمت بإنشاء موقعك الأول وتشغيله باستخدام خادم ويب! أليس هذا رائعاً؟
+
+![تم التثبيت بنجاح!](images/install_worked.png)
+
+لاحظ أن نافذة الأوامر يمكنها تشغيل شيء واحد فقط في كل مرة، وأن نافذة الأوامر التي فتحتها في وقت سابق تقوم بتشغيل خادم الويب. طالما أن خادم الويب يعمل وينتظر طلبات إضافية واردة ، ستقبل المحطة الطرفية نصا جديدا ولكنها لن تنفذ أوامر جديدة.
+
+> لقد استعرضنا كيف تعمل خادمات الويب في الفصل **How the Internet works**.
+
+لكتابة أوامر إضافية أثناء تشغيل خادم الويب، قم بفتح نافذة طرفية جديدة وتفعيل virtualenv الخاصة بك -- لمراجعة التعليمات حول كيفية فتح نافذة طرفية ثانية، انظر [Introduction to the command line](../intro_to_command_line/README.md). لإيقاف خادم الويب، قم بالتبديل مرة أخرى إلى النافذة التي يعمل فيها واضغط على CTRL+C - مفاتيح التحكم و C معا (على ويندوز، قد تضطر إلى الضغط على Ctrl+Break).
+
+مستعد للخطوة التالية؟ لقد حان الوقت لإنشاء بعض المحتوى!
\ No newline at end of file
diff --git a/ar-SA/django_templates/README.md b/ar-SA/django_templates/README.md
new file mode 100644
index 00000000000..15347850fe5
--- /dev/null
+++ b/ar-SA/django_templates/README.md
@@ -0,0 +1,108 @@
+# قوالب دجانغو
+
+حان الوقت لكي نظهر بعض المعلومات! جانغو يعطينا بعضا من شعارات القوالب المفيدة المثبتة فية.
+
+## ما هي شعارات القوالب؟
+
+كما تعرف في لغة الHTML لا يمكنك كتابة كود مكتوب بلغة Python وذلك لأن متصفحات الانترنت لا تفهمة. المتصفحات تفهم الHTML فقط. نحن نعلم أن الHTML نوعا ما جامدة لكن الPython أكثر ديناميكية.
+
+**Django template tags** تسمح لنا بنقل أشياء مثل بيثون إلى HTML، حتى نتمكن من بناء مواقع ديناميكية بشكل أسرع. رائع!
+
+## عرض قالب قائمة المشاركات
+
+في الفصل السابق، قدمنا لقالبنا قائمة بالمشاركات في متغير `posts`. الآن سوف نقوم بعرضه في HTML.
+
+لطباعة متغير في قوالب جانغو، نحن نستخدم أقواس مزدوجة مع اسم المتغير في الداخل، هكذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+جرب هذا في قالبك `blog/templates/blog/post_list.html`. قم بفتحه في محرر التعليمات البرمجية، واستبدل كل شي من `<div>` الثاني إلى `</div>` الثالث بـ `{{ posts }}`. قم بحفظ الملف، وقم بتحديث الصفحة لمشاهدة النتائج:
+
+![الرقم 13.1](images/step1.png)
+
+كما ترون، كل ما لدينا هو هذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+هذا يعني أن جانغو يفهم ذلك كقائمة من الكائنات. هل تتذكر من **Introduction to Python** كيف نضهر القوائم؟ نعم، مع حلقات! في قالب جانغو يمكنك القيام بها هكذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+جرب هذا في قالبك.
+
+![الرقم 13.2](images/step2.png)
+
+إنه كان مجديًا! ولكننا نريد أن يتم عرض المشاركات مثل المشاركات الثابتة التي أنشأناها سابقا في فصل **مقدمة إلى HTML**. يمكنك خلط علامات HTML والقالب. `body` سيبدو هكذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %} كل شيء تضعه بين `{% for %}` و `{% endfor %}` سوف يتكرر لكل كائن في القائمة. حدث الصفحة:{% endraw %}
+
+![الرقم 13.3](images/step3.png)
+
+هل لاحظت أننا استخدمنا تدوين مختلف قليلا هذه المرة (`{{ post.title }}` او `{{ post.text }})`؟ يمكننا الوصول إلى البيانات في كل حقل من الحقول المعرفة في نموذج `Post`. ايضا `|linebreaksbr` يربط نص المشاركات من خلال مرشح لتحويل فواصل الأسطر إلى فقرات.
+
+## شيء واحد آخر
+
+سيكون جيدا معرفة ما إذا كان موقع الويب الخاص بك لا يزال يعمل على شبكة الإنترنت العامة، اليس كذالك؟ دعونا نحاول نشره في PythonAnywhere مرة أخرى. هنا خلاصة للخطوات…
+
+* أولاً، ادفع التعليمات البرمجية الخاصة بك إلى Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* افتح [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) واذهب الى **Bash console** او افتح واحدة جديدة وشغل هذا الأمر:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(تذكر أن تستبدل `<your-pythonanywhere-domain>` بالمجال الفرعي لـ PythonAnywhere الفعلي، بدون أقواس الزاوية. )
+
+* وأخيراً، انتقل إلى ["Web" page](https://www.pythonanywhere.com/web_app_setup/) واضغط على **Reload** في تطبيق الويب الخاص بك. (للوصول إلى صفحات PythonAnywhere الأخرى من وحدة التحكم ، استخدم زر القائمة في الزاوية اليمنى العلوية. يجب أن يكون تحديثك مباشرًا على https://subdomain.pythonanywhere.com -- تحقق من ذلك في المتصفح! إذا كانت مشاركات المدونة على موقع PythonAnywhere لا تتطابق مع المشاركات التي تظهر على المدونة المستضافة على الخادم المحلي، فلا بأس بذالك. قواعد البيانات على جهاز الكمبيوتر المحلي وبايثون في أي مكان لا يتزامنان مع بقية الملفات الخاصة بك.
+
+تهانينا! الآن امضي قدما وحاول إضافة مشاركة جديدة عبر إدارة جانغو الخاصة بك (تذكر من إضافة published_date!) تأكد من أنك في صفحة المشرف لجانغو لموقع pythonanywhere الخاص بك، https://subdomain.pythonanywhere.com/admin. ثم حدث الصفحة لمعرفة ما إذا كانت المشاركة تظهر هناك أم لا.
+
+تعمل مثل السحر؟ نحن فخورون! ابتعدوا قليلا عن جهاز الكمبيوتر الخاص بك - لقد حصلت على استراحة. :)
+
+![الشكل 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ar-SA/django_urls/README.md b/ar-SA/django_urls/README.md
new file mode 100644
index 00000000000..6821d466b31
--- /dev/null
+++ b/ar-SA/django_urls/README.md
@@ -0,0 +1,103 @@
+# روابط جانغو
+
+نحن على وشك بناء صفحتنا الأولى على الإنترنت: الصفحة الرئيسية لمدونتك! ولكن أولاً، دعونا نتعلم قليلاً عن "روابط مواقع جانغو".
+
+## ما هو الرابط (URL) ؟
+
+ببساطة الرابط (URL) هو عنوان صفحة الويب. يمكنك أن ترى عنوان الرابط (URL) في كل مرة تقوم بزيارة الموقع على شبكة الإنترنت --إنها مرئية في شريط العناوين في المتصفح الخاص بك. (نعم! `127.0.0.1:8000` هو عنوان الرابط (URL)! و `https://djangogirls.org` أيضا الرابط (URL))
+
+![عنوان صفحة الويب](images/url.png)
+
+كل صفحة على شبكة الإنترنت تحتاج إلى عنوان رابط (URL) خاص بها. بهذه الطريقة يستطيع تطبيقك ان يعلم ماذا يفتح للمستخدم الذي فتح الرابط. في جانغو نستخدم ما يسمى `URLconf` (URL configuration). URLconf هو مجموعة من الأنماط التي ستحاول جانغو مطابقتها مع عنوان URL المطلوب للعثور على طريقة العرض الصحيح.
+
+## كيف تعمل عناوين Url في جانغو؟
+
+دعونا نفتح الملف `mysite/urls.py` في محرر التعليمات البرمجية الخاصة بك للاختيار ونرى ما يبدو عليه:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+كما ترون، جانغو قد وضعت بالفعل شيء هنا بالنسبة لنا.
+
+الخطوط بين علامات الاقتباس الثلاثي (`'' '` أو `"""`) تسمى docstrings – ييمكنك كتابتها في أعلى ملف أو فئة أو طريقة لوصف ما يفعله. هي لا تعمل عبر بايثون.
+
+عنوان URL المشرف، الذي زرته في الفصل السابق، موجود هنا:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+هذا السطر يعني أن لكل عنوان URL الذي يبدأ ب `admin/`، سوف تجد جانغو مقابله *view*. في هذه الحالة نحن ، نضع الكثير من روابط المدير ، لذالك هي ليست مجموعة كلها في هذا الملف الصغير ، انها اكثر قابلية للقراءة وانضف.
+
+## رابط جانغو الأول الخاص بك!
+
+حان الوقت لإنشاء أول عنوان URL لنا! نريد 'http://127.0.0.1:8000/' أن تكون الصفحة الرئيسية لمدونتنا وأن تعرض قائمة من المشاركات.
+
+نريد أيضا الاحتفاظ بالملف `mysite/urls.py` نظيف، حيث أننا سوف نسترد عناوين Url من تطبيق `blog` لدينا إلى الملف الرئيسي `mysite/urls.py`.
+
+امضي قدما ، واضف السطر الذي سيسترد `blog.urls`. ستحتاج أيضاً إلى تغيير السطر `from django.urls…` لأننا نستخدم الدالة `include` هنا، لذا ستحتاج إلى إضافة ذلك الاستيراد إلى السطر.
+
+ملف `mysite/urls.py` الخاص بك يجب أن يبدو مثل هذا:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+جانغو سيقوم الآن بإعادة توجيه كل ما يأتي إلى 'http://127.0.0.1:8000/' إلى `blog.urls` والبحث عن المزيد من التعليمات هناك.
+
+## blog.urls
+
+قم بإنشاء ملف فارغ جديد يسمى `urls.py` في الدليل `blog`، وقم بفتحه في محرر الكود. حسنًا! أضف هذين السطرين الأوليين:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+نحن هنا نستورد وظائف جانغو `path` وجميع الـ `views` من تطبيق الـ `blog`. (ليس لدينا أي شي حتى الآن، ولكننا سنصل إلى ذلك في دقيقة!)
+
+بعد ذلك، يمكننا إضافة أول نمط URL لدينا:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+كما ترون، نحن الآن نقوم بتعيين `view` يسمى `post_list` لعنوان URL الجذر. سيطابق نمط الرابط هذا سلسلة فارغة وسيتجاهل محلل URL جانغو اسم النطاق (i. ., http://127.0.0.1:8000/) الذي يبادئ مسار الرابط الكامل. سيخبر هذا النمط جانغو أن `views.post_list` هو المكان المناسب للذهاب إليه إذا دخل شخص ما موقعك على الويب على العنوان "http://127.0.0.1:8000/".
+
+الجزء الأخير، `name='post_list'`, هو اسم عنوان URL الذي سيتم استخدامه لتحديد طريقة العرض. وهذا يمكن أن يكون نفس اسم العرض ولكن أيضا يمكن أن يكون شيئا مختلفاً تماما. سنستخدم عناوين URLs المسماة لاحقا في المشروع، لذلك من المهم تسمية كل عنوان URL في التطبيق. يجب أن نحاول أيضا الحفاظ على أسماء عناوين URL فريدة وسهلة التذكر.
+
+إذا حاولت زيارة http://127.0.0.1:8000/ الآن، ستجد نوعا من رسائل الخطأ "صفحة ويب غير متوفرة". وذلك لأن الخادم (تذكر كتابة `runserver`?) لم يعد قيد التشغيل. ألق نظرة على نافذة وحدة تحكم الخادم لمعرفة السبب.
+
+![خطأ](images/error1.png)
+
+وحدة التحكم الخاصة بك تظهر خطأ، ولكن لا تقلق - إنه في الواقع مفيد جدا: إنه يخبرك أن **no attribute 'post_list'**. هذا هو اسم *view* الذي تحاول جانغو العثور عليه واستخدامه، ولكن لم نقم بإنشاءه بعد. في هذه المرحلة،`/admin/` لن يعمل أيضا. لا تقلق – سوف نصل إلى هناك. إذا رأيت رسالة خطأ مختلفة، حاول إعادة تشغيل خادم الويب الخاص بك. للقيام بذلك، في نافذة وحدة التحكم التي تقوم بتشغيل خادم الويب، أوقفها بالضغط على Ctrl+C (مفتاحي التحكم و C معا). على ويندوز، قد تضطر إلى الضغط على Ctrl+Break. ثم تحتاج إلى إعادة تشغيل خادم الويب عن طريق تشغيل أمر `python manage.py runserver`.
+
+> إذا كنت ترغب في معرفة المزيد عن URLconfs، انظر إلى الوثائق الرسمية: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ar-SA/django_views/README.md b/ar-SA/django_views/README.md
new file mode 100644
index 00000000000..c0d686f94d3
--- /dev/null
+++ b/ar-SA/django_views/README.md
@@ -0,0 +1,44 @@
+# وجهات نظر جانغو -وقت الإنشاء!
+
+حان الوقت للتخلص من الشوائب التي انشأناها في الفصل الأخير! :)
+
+*view* هو المكان الذي وضعنا فيه المنطق الخاص بتطبيقنا. وسوف تطلب معلومات من `model` قمت بإنشائها من قبل وتمريرها إلى `template`. سوف ننشئ قالب في الفصل التالي. وجهات النظر هي مجرد وظائف بيثون والتي هي اكثر تعقيد قليلا من التي قمنا بكتابتها في هذا الفصل **مقدمة بيثون**.
+
+Views توضع في الملف `views.py`. وسوف نضيف *views* الخاصة بنا الى `blog/views.py`.
+
+## blog/views.py
+
+حسنًا، دعونا نفتح هذا الملف في محرر التعليمات البرمجية الخاص بنا ونرى ما هو هناك:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+ليس هناك كثيرا من الأشياء هنا حتى الآن.
+
+تدكر ان الأسطر التي تبدأ ب`#` هي مجرد تعليقات وهذا يعني انها لن يتم استخدامها عبر بايثون.
+
+دعونا ننشء *view * كما يوحي التعليق. أضف الأسطر التالية أدناه:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+كما ترون، أنشأنا دالة (`def`) تسمى `post_list` التي تأخذ `request` وسوف ترجع `return` القيمة من خلال الاتصال بدالة أخرى `render` التي سوف توفر (تضع سوياً) قالبنا `blog/post_list.html`.
+
+قم بحفظ الملف، انتقل إلى http://127.0.0.1:8000/وانظر ماذا لدينا.
+
+خطأ آخر! اقرأ ما يجري الآن:
+
+![خطأ](images/error.png)
+
+هذا يبين أن الملقم قيد التشغيل مرة أخرى، على الأقل، ولكن لا يزال يبدو وكأنه ليس على ما يرام أليس كذالك؟ لا تقلق، انها مجرد صفحة خطأ، لا تخف! تماما مثل رسائل الخطأ في وحدة التحكم، هذه في الواقع مفيدة جدا. يمكن أن تقرأ أن*TemplateDoesNotExist*. دعونا نصلح هذا الخطأ وننشئ قالب في الفصل التالي!
+
+> إعرف المزيد حول الـ views في جانغو من خلال قراءة الوثائق الرسمية: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ar-SA/dynamic_data_in_templates/README.md b/ar-SA/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..657a180faff
--- /dev/null
+++ b/ar-SA/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# البيانات الديناميكية في قوالب
+
+لدينا قطع مختلفة في المكان: تم تحديد نموذج `Post` في `models.py`,، لدينا `post_list` في `views.py` والقالب المضاف. ولكن كيف سنظهر مشاركاتك في نموذج HTML ؟ لأن هذا ما نريد أن نفعله – اتخاذ بعض المحتويات (النماذج التي تم حفظها في قاعدة البيانات) وعرضها بشكل جميل ، اليس كذالك؟
+
+وهذا بالضبط ما يفترض ب *views* القيام به: ربط النماذج والقوالب. وفي `post_list` *view* سوف نحتاج إلى أن النماذج التي نريد عرضها وتمريرها إلى القالب. في *view* نقرر اية (نمادج) سيتم عرضها في قالب.
+
+حسنا، كيف سوف نحقق ذلك؟
+
+نحن بحاجة إلى فتح `blog/views.py`. وحتى الآن `post_list` *view* يبدو مثل هذا:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+تذكر عندما تحدثنا عن تضمين التعليمات البرمجية المكتوبة في ملفات مختلفة؟ الآن هي اللحظة التي يتعين علينا فيها ادخال النمودج الذي كتبنا في `models.py`. سوف نقوم بإضافة سطر `from .models import Post` مثل هذا:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+النقطة قبل `models` تعني *current directory* أو *current application*. `Views.py` و `models.py` في نفس الدليل. وهذا يعني أننا يمكن أن تستخدم `.` واسم الملف (بدون `.py`). ثم نقوم باستيراد اسم النموذج (`Post`).
+
+ولكن ما هي الخطوة التالية؟ لأخد المشاركات الفعلية للمدونة من `Post` نحن بحاجة إلى ما يسمى `QuerySet`.
+
+## QuerySet
+
+يجب ان تكون مألوف مع طريقة عمل QuerySets ، لقد تكلمنا عنهم في [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+لذا نريد الآن نشر مشاركات مدونة مرتبة حسب `published_date`، أليس كذلك؟ فعلنا ذلك بالفعل في فصل QuerySets!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+إذاً، دعونا نفتح الملف `blog/views.py` في محرر التعليمات البرمجية، ونضيف هذه القطعة من التعليمات البرمجية إلى الدالة `def post_list(request)` -- ولكن لا تنسى أولاً إضافة `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+لعرض QuerySet الخاص بنا في قائمة منشورات مدونتنا، لدينا شيئان متبقيان للقيام بهما:
+
+1. مرر الـ `posts` QuerySet إلى سياق القالب، عن طريق تغيير إستدعاء الدالة `render`. سنقوم بذلك الآن.
+2. قم بتعديل القالب لعرض الـ `posts` QuerySet. سنقوم بتغطية هذا في فصل لاحق.
+
+يرجى ملاحظة أننا ننشئ *variable* لأعمالا QuerySet: `posts`.. عالج هذا كاسم QuerySet لدينا. من الآن فصاعدا يمكن أن نشير إليه بهذا الاسم.
+
+في دالة `render` لدينا معلمة واحد `request`(كل شيء نتلقاه من المستخدم عبر شبكة الإنترنت) والأخرى تعطي ملف القالب (`'blog/post_list.html'`). المعلمة الأخيرة، `{}`، هو مكان الذي يمكن أن نضيف فيه بعض الأشياء للقالب المطلوب استخدامه. نحن بحاجة لإعطائهم أسماء (ونحن سوف تلتزم ب `'posts'` الآن). :) ينبغي أن تبدو مثل هذا: `{'posts': posts}`. يرجى ملاحظة أن الجزء قبل `:` سلسلة; تحتاج إلى الإلتفاف مع علامات اقتباس: `''`.
+
+في النهاية ملف `blog/views.py` يجب اين يبدو مثل هذا:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+هذا كل شيء ، حان الوقت للعودة إلى قالبنا وإضهار QuerySet!
+
+هل تريد قراءة المزيد حول QuerySets في جانغو؟ يجب أن تنظر هنا: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ar-SA/extend_your_application/README.md b/ar-SA/extend_your_application/README.md
new file mode 100644
index 00000000000..5b126f6e577
--- /dev/null
+++ b/ar-SA/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# توسيع التطبيق الخاص بك
+
+لقد أكملنا بالفعل جميع الخطوات المختلفة اللازمة لإنشاء موقعنا على الويب: 
+
+حان الوقت للتدريب!
+
+أول شيء نحتاجه في مدونتنا هو، على الأرجح، صفحة لعرض مشاركة واحدة، أليس كذلك؟
+
+لدينا بالفعل نموذج `Post` ، لذلك لا نحتاج إلى إضافة أي شيء إلى `models.py`.
+
+## إنشاء رابط نموذج لتفاصيل المشاركة
+
+سنبدأ بإضافة رابط داخل ملف `blog/templates/blog/post_list.html` افتحه في محرر التعليمات البرمجية، وحتى الآن يجب أن يبدوا هكذا: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %} نريد الحصول على رابط من عنوان المشاركة في قائمة المشاركات إلى صفحة تفاصيل المشاركة. دعونا نغير `<h2><a href="">{{ post.title }}</a></h2>` بحيث يربط صفحة تفاصيل المشاركة:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %} حان الوقت لشرح `{% url 'post_detail' pk=post.pk %}`. كما قد تظن، فإن علامات `{% %}` تعني أننا نستخدم علامات قالب جانغو. هذه المرة سوف نستخدم واحدة منهم والتي ستقوم بإنشاء عنوان URL لنا!{% endraw %}
+
+الجزء `post_detail` يعني أن جانغو سوف يتوقع عنوان URL في `blog/urls.py` مع name=post_detail.
+
+وماذا عن `pk=post.pk`؟ `pk` هو اختصار للمفتاح الأساسي، وهو اسم فريد لكل سجل في قاعدة البيانات. كل نموذج جانغو لديه حقل يعمل كمفتاح رئيسي له، وأياً كان اسمه الآخر، فإنه يمكن أن يشار إليه أيضاً باسم "pk". ونظرا لأننا لم نحدد مفتاحا أساسيا في نموذج `Post`، فإن جانغو ينشئ واحدا لنا (بشكل افتراضي، هو حقل يسمى "id" يحتوي على رقم يزيد لكل سجل، أي 1 و 2 و 3) ويضيفه كحقل لكل واحدة من مشاركاتنا. نصل إلى المفتاح الأساسي من خلال كتابة `post.pk`، بنفس الطريقة التي نصل بها إلى الحقول الأخرى (`title`, `author`, etc.) في الكائن `Post`!
+
+الآن عندما ننتقل إلى http://127.0.0.1:8000/ سيكون لدينا خطأ (كما هو متوقع، نظرا لأنه لا يوجد لدينا عنوان URL أو *view* ل `post_detail`). وسوف تبدو كما يلي:
+
+![خطأ NoReverseMatch](images/no_reverse_match2.png)
+
+## إنشاء عنوان URL لتفاصيل المشاركة
+
+لنقم بإنشاء عنوان URL في `urls.py` من أجل `post_detail` *view* الخاص بنا!
+
+نريد عرض تفاصيل مشاركتنا الأولى في هذا الرابط ****: http://127.0.0.1:8000/post/1/
+
+دعونا ننشئ عنوان URL في ملف `blog/urls.py` لتوجيه جانغو إلى *view* باسم `post_detail`، الذي سوف يعرض مشاركة بأكملها. افتح ملف `blog/urls.py` في محرر التعليمات البرمجية، وأضف السطر `path('post/<int:pk>/', views.post_detail, name='post_detail'),` بحيث يبدو الملف كهذا:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+يحدد هذا الجزء `post/<int:pk>/` نمط عنوان URL - وسوف نشرحه لك:
+
+- `post/` يعني أن عنوان URL يجب أن يبدأ بكلمة **post** يتبعه **/**. حتى الآن كل شيء جيد.
+- `<int:pk>` - هذا الجزء أكثر صعوبة. وهو يعني أن جانغو يتوقع قيمة صحيحة وسيقوم بتحويلها إلى عرض كمتغير يسمى `pk`.
+- `/` - ثم نحتاج إلى **/** مرة أخرى قبل الانتهاء من عنوان URL.
+
+هذا يعني إذا قمت بإدخال `http://127.0.0.1:8000/post/5/` في المتصفح، جانغو سيفهم أنك تبحث عن *view* يسمى `post_detail` وسينقل معلومة أن `pk` تساوي `5` إلى ذلك الـ *view*.
+
+حسنا، لقد أضفنا نمط عنوان URL جديد إلى `blog/urls.py`! دعونا نقم بتحديث الصفحة http://127.0.0.1:8000/ بوم! توقف الخادم عن العمل مرة أخرى. ألقي نظرة على وحدة التحكم – كما هو متوقع، هناك خطأ آخر!
+
+![AttributeError](images/attribute_error2.png)
+
+هل تذكر ما الخطوة التالية؟ إنها إضافة طريقة عرض!
+
+## إضافة مشاركة لعرض التفاصيل
+
+هذه المرة *view* الخاص بنا يُعطى معلمة إضافية، `pk`. الـ *view* الخاص بنا يحتاج إلى الإمساك به، أليس كذلك؟ لذلك سنقوم بتعريف وظيفتنا كـ `def post_detail(request, pk):`. لاحظ أن هذا العامل يجب أن يكون له نفس الاسم بالضبط الذي حددناه في `urls` (`pk`). لاحظ أيضا أن حذف هذا المتغير غير صحيح وسوف يؤدي إلى خطأ!
+
+الآن، نريد أن نحصل على مشاركة مدونة واحدة فقط. للقيام بذلك، يمكننا استخدام مجموعات الاستعلامات، مثل هذا:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)Post.objects.get(pk=pk)
+```
+
+ولكن توجد مشكلة في التعليمات البرمجية هذه. إذا لم يكن هناك `Post` مع الـ `primary key` (`pk`) المُعطى سيكون لدينا خطأ قبيح جداً!
+
+![خطأ DoesNotExist](images/does_not_exist2.png)
+
+نحن لا نريد ذلك! لكن لحسن الحظ جانغو يأتي مع شيء سوف يتعامل مع ذلك لنا: `get_object_or_404`. في حالة عدم وجود `Post` مع `pk` المعطى، سيتم عرض صفحة أفضل بكثير، صفحة `Page Not Found 404`.
+
+![لم يتم العثور على الصفحة](images/404_2.png)
+
+الخبر الجيد هو أنه يمكنك في الواقع إنشاء صفحة `Page not found` الخاصة بك وجعلها جميلة كما تريد. لكنها ليست مهمة جداً الآن، لذلك سنتخطى ذلك.
+
+طيب، حان الوقت لإضافة *view* لملف `views.py` لدينا!
+
+في `blog/urls.py` قمنا بإنشاء قاعدة عنوان URL اسمها `post_detail` التي تشير إلى طريقة عرض تسمى `views.post_detail`. وهذا يعني أن جانغو سوف يتوقع وظيفة عرض تسمى `post_detail` داخل `blog/views.py`.
+
+يجب علينا فتح `blog/views.py` في محرر التعليمات البرمجية وإضافة التعليمات البرمجية التالية بالقرب من أسطر `from` الأخرى:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+وفي نهاية الملف سوف نقوم بإضافة *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+نعم. لقد حان الوقت لتحديث الصفحة: http://127.0.0.1:8000/
+
+![عرض قائمة المشاركات](images/post_list2.png)
+
+لقد نجحت! ولكن ماذا يحدث عند النقر على رابط في عنوان مشاركة المدونة؟
+
+![خطأ TemplateDoesNotExist](images/template_does_not_exist2.png)
+
+أوه لا! خطأ آخر! لكننا نعرف بالفعل كيفية التعامل معه، أليس كذلك؟ نحن بحاجة إلى إضافة قالب!
+
+## إنشاء قالب لتفاصيل المشاركة
+
+سنقوم بإنشاء ملف في `blog/templates/blog` يسمى `post_detail.html` وفتحه في محرر التعليمات البرمجية.
+
+أدخل الأمر التالي:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+مرة أخرى نحن نوسع `base.html`. في الكتلة `content` نريد عرض تاريخ نشر المشاركة (إذا كان موجودا) والعنوان والنص. لكن علينا أن نناقش بعض الأشياء الهامة، أليس كذلك؟
+
+{% raw %}`{% if ... %} ... {% endif %}` علامة قالب يمكننا استخدامها عندما نريد التحقق من شيء. (تذكر `if ... else ...` من فصل **Introduction to Python**؟) في هذا السيناريو نريد أن نتحقق إذا كان الـ `published_date` الخاص بالمشاركة ليس خالياً. {% endraw %}
+
+حسنًا، يمكننا تحديث صفحتنا ومعرفة ما إذا كانت `TemplateDoesNotExist` قد ذهبت الآن.
+
+![صفحة تفاصيل المشاركة](images/post_detail2.png)
+
+ياي! إنه يعمل!
+
+# وقت النشر!
+
+سيكون من الجيد معرفة ما إذا كان موقع الويب الخاص بك لا يزال يعمل على PythonAnywhere، أليس كذلك؟ دعونا نحاول النشر مرة أخرى.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+وبعد ذلك، في [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(تذكر أن تستبدل `<your-pythonanywhere-domain>` بالمجال الفرعي لـ PythonAnywhere الفعلي، بدون أقواس الزاوية. )
+
+## تحديث الملفات الثابتة على الخادم
+
+الخوادم مثل PythonAnywhere تحب معاملة "الملفات الثابتة" (مثل ملفات CSS) بشكل مختلف عن ملفات بايثون لأنها يمكن أن تحسن تحميلها بشكل أسرع. ونتيجة لذلك، كلما قمنا بتغيير ملفات CSS الخاصة بنا، نحن بحاجة إلى تشغيل أمر إضافي على الخادم لإخباره بتحديثهم. الأمر يسمى `collectstatic`.
+
+ابدأ بتفعيل الـ virtualenv الخاص بك إذا لم يكن يزال نشطا من قبل (PythonAnywhere يستخدم أمر يسمى `workon` للقيام بذلك. إنه تماما مثل أمر `source myenv/bin/activate` الذي تستخدمه على جهاز الكمبيوتر الخاص بك:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+الأمر `manage.py collectstatic` يشبه قليلاً `manage.py migrate`. نحن نقوم ببعض التغييرات على تعليماتنا، ومن ثم نقول لجانغو *apply* لهذه التغييرات، إما إلى مجموعة الملفات الثابتة للخادم، أو إلى قاعدة البيانات.
+
+وعلى أية حال، نحن الآن مستعدون للانتقال إلى ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (من زر القائمة في الجزء العلوي الأيمن من وحدة التحكم) و الضغط على **Reload**، ثم انظر إلى صفحة https://subdomain.pythonanywhere.com لرؤية النتيجة.
+
+هذا ينبغي ان يكون كل شيء! مبروك:)
\ No newline at end of file
diff --git a/ar-SA/how_the_internet_works/README.md b/ar-SA/how_the_internet_works/README.md
new file mode 100644
index 00000000000..8e8c8b490d3
--- /dev/null
+++ b/ar-SA/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# كيف يعمل الإنترنت
+
+> للقراء في المنزل: هذا الفصل تم التكلم عنه في [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> هذا الفصل مستوحى من حديث "كيف تعمل شبكة الإنترنت" جيسيكا مك كيلار (http://web.mit.edu/jesstess/www/).
+
+نحن نراهن انك تستخدم الأنترنت كل يوم. ولكن هل تعرف فعلا ما يحدث عند كتابة عنوان مثل https://djangogirls.org في متصفحك والضغط على `enter`؟
+
+أول شيء تحتاج إلى فهمه هو أن الموقع يتكون من مجموعة من الملفات المحفوظة على قرص صلب، تماما مثل أفلامك، الموسيقى، أو الصور. ومع ذلك، هناك جزء واحد فريد للمواقع: وهي تعليمات كمبيوتر برمجية تسمى HTML.
+
+إذا كنت لا تعرف البرمجة فإنه سيكون من الصعب فهم HTML في البداية، ولكن متصفحات الويب الخاص بك (مثل كروم، سفاري، فايرفوكس، الخ) تحبها. تم تصميم متصفحات الويب لفهم هذا الكود، اتباع التعليمات الخاصة به، وتقديم هذه الملفات التي تشكل موقع الويب الخاص بك، بالطريقة التي تريدها.
+
+كما هو الحال مع كل ملف، نحن بحاجة إلى تخزين ملفات HTML في مكان ما على قرص الثابت. بالنسبة إلى الإنترنت، نستخدم أجهزة كمبيوتر خاصة وقوية تسمى *خوادم*. أنهم لا يملكون شاشة أو ماوس أو لوحة مفاتيح، لأن الغرض الرئيسي منها هو لتخزين البيانات وخدمتها. لذالك يسمون *servers* لأنهم *serve* خدم ينقلون بياناتك.
+
+حسنا! لكنك تريد ان ترى كيف تعمل الأنترنت أليس كذالك؟
+
+لقد رسمنا لك صورة ، ستبدو هكذا:
+
+![الرقم 1.1](images/internet_1.png)
+
+تبدو كفوضى ، اليس كذالك؟ في الواقع هي شبكة أجهزة متصلة (*ملقمات* المشار إليها أعلاه). مئات الآلاف من آلات! كيلومترات عديدة من الكابلات حول العالم! يمكنك زيارة موقع "خريطة غواصات الكابلات" (http://submarinecablemap.com) لمعرفة مدى تعقيد الشبكة. هنا لقطة شاشة من الموقع:
+
+![الرقم 1.2](images/internet_3.png)
+
+أنها رائعة، أليس كذلك؟ ولكن ليس من الممكن أن يكون هناك سلك بين كل آلة متصلة بالإنترنت. إذا ، للوصول إلى جهاز (على سبيل المثال، حيث يتم حفظ https://djangogirls.org) نحن بحاجة لتمرير طلب من خلال آلات مختلفة كثيرة.
+
+ستبدو كالشكل التالي:
+
+![الرقم 1.3](images/internet_2.png)
+
+تخيل عند كتابة https://djangogirls.org، يمكنك إرسال رسالة تقول: "عزيزي جانغو الفتيات، أريد أن أرى الموقع djangogirls.org. أرسله لي، رجاء! "
+
+رسالتك تذهب إلى مكتب البريد الأقرب إليك. ثم تذهب إلى آخر أقرب قليلا إلى المرسل إليه، ثم إلى آخر، وآخر حتى يتم تسليمها إلى وجهتها. الشيء الفريد هنا إذا قمت بإرسال العديد من الرسائل (*حزم البيانات*) إلى نفس المكان، يمكن أن تذهب من خلال مكاتب بريد مختلفة تماما (*أجهزة التوجيه*). وهذا يعتمد على كيفية التوزيع في كل مكتب.
+
+![الرقم 1.4](images/internet_4.png)
+
+هذه هي الطريقة التي تعمل بها - ترسل رسائل وتتوقع بعض الاستجابة. بدلاً من الورق والقلم يمكنك استخدام وحدات البايت من البيانات، ولكن الفكرة هي نفسها!
+
+بدلاً من عناوين مع اسم الشارع، والمدينة، والرمز البريدي واسم البلد، نحن نستخدم عناوين IP. يسأل الكمبيوتر أولاً DNS (نظام اسم المجال) لترجمة djangogirls.org إلى عنوان IP. وهي تعمل قليلا مثل كتب الهاتف القديمة حيث يمكنك البحث عن اسم الشخص الذي تريد الاتصال به والعثور على رقم الهاتف وعنوانه.
+
+عندما تقوم بإرسال رسالة، فإنها تحتاج إلى بعض الميزات لتسليمها بشكل صحيح: عنوان، ختم، إلخ. انت ايضا تستخدم لغة يفهمها المتلقي، اليس كذالك؟ وينطبق نفس الشيء على *حزم البيانات* انت ترسل لترى موقع انترنت. نحن نستخدم بروتوكول يسمى HTTP (بروتوكول نقل النص التشعبي).
+
+لذلك، أساسا، عندما يكون لديك موقع على شبكة الإنترنت، تحتاج إلى يكون لديك *ملقم* (آلة) حيث يعيش. عندما يستلم *الملقم* *طلب* وارد (في رسالة)، يرسل إلى موقع الويب الخاص بك (في رسالة أخرى).
+
+بما ان هذا برنامج تعليمي لدجانغو ، قد تسأل ماذا يفعل دجانغو. عندما تقوم بإرسال استجابة، لا تريد دائماً إرسال نفس الشيء للجميع. من الأفضل بكثير ان تكون احرفك مشخصة، وخاصة للشخص الذي كتب للتو لك، أليس كذلك؟ جانغو يساعدك في إنشاء هذه الرسائل الشخصية، والمثيرة للاهتمام. :)
+
+يكفي الحديث--وقت البناء!
\ No newline at end of file
diff --git a/ar-SA/html/README.md b/ar-SA/html/README.md
new file mode 100644
index 00000000000..f88f9dd1c2c
--- /dev/null
+++ b/ar-SA/html/README.md
@@ -0,0 +1,227 @@
+# مقدمة إلى HTML
+
+قد تسأل ما هو القالب؟
+
+القالب هو ملف يمكننا إعادة استخدامه لتقديم معلومات مختلفة بتنسيق ثابت - على سبيل المثال، يمكنك استخدام قالب لمساعدتك على كتابة رسالة، على الرغم من أن كل رسالة قد تحتوي على مضمون مختلف ويتم توجيهها إلى شخص مختلف ، باستعمال القالب ستظهر بفس الشكل.
+
+تم وصف تنسيق قالب جانغو في لغة تسمى HTML (وهذا هو ال HTML التي ذكرناها في الفصل الأول،**How the Internet works**).
+
+## ما هي HTML؟
+
+HTML هو رمز يتم تفسيره بواسطة متصفح الويب - مثل كروم أو فايرفوكس أو سفاري - لعرض صفحة ويب للمستخدم.
+
+نقصد ب HTML "HyperText Markup Language". **HyperText** هو نص يعتمد على الإرتباطات التشعبية بين الصفحات. **Markup** يعني أننا اتخذنا وثيقة ووضعنا علامة عليها مع رمز لنقول ل (في هذه الحالة، متصفح) كيفية تفسير الصفحة. تم إنشاء شفرة HTML باستخدام علامات **tags**، حيث يبدأ كل منها باستخدام `<` وينتهي ب `>`. تمثل هذه العلامات علامات **elements**.
+
+## قالبك الأول!
+
+إنشاء قالب يعني إنشاء ملف قالب. كل شيء هو ملف، هو؟ ربما كنت قد لاحظت هذا بالفعل.
+
+يتم حفظ قوالب في `blog/templates/blog` الدليل. لذا أولاً أنشئ دليل يسمى `templates` داخل دليل المدونة الخاص بك. قم بإنشاء دليل آخر يسمى `blog` داخل دليل القوالب الخاصة بك:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(قد تتساءل لماذا نحتاج إلى دليلي `blog` - كما سوف تكتشف في وقت لاحق، وهذا هو مجرد تسمية اصطلاح مفيدة تجعل الحياة أسهل عندما تبدأ الأمور أكثر تعقيدا)
+
+والآن قم بإنشاء ملف `post_list.html` (فقط اتركه فارغاً للآن) داخل دليل `blog/templates/blog`.
+
+انظر كيف يبدو موقع الويب الخاص بك الآن: http://127.0.0.1:8000/
+
+> إذا كان لا يزال لديك خطأ `TemplateDoesNotExist`,، حاول إعادة تشغيل الخادم الخاص بك. انتقل الى سطر الأوامر حاول ايقاف الخادم (بالضغط على Ctrl+C - مفتاح التحكم و C معا) وإعادة تشغيله من خلال الأمر ` python manage.py runserver `.
+
+![الرقم 11.1](images/step1.png)
+
+لم يعد هناك خطأ! تهانينا! :) ومع ذلك، لا يقوم موقعك بنشر أي شيء إلا صفحة فارغة، لأن قالبك فارغ أيضا. نحن بحاجة إلى إصلاح ذلك.
+
+افتح الملف الجديد في محرر التعليمات البرمجية، وأضف ما يلي:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+كيف يبدو موقعك الآن؟ يرجى زيارة الموقع لمعرفة ذالك: http://127.0.0.1:8000/
+
+![الرقم 11.2](images/step3.png)
+
+لقد نجحت. عمل جيد هناك! :)
+
+* السطر `<!DOCTYPE html>` ليس علامة HTML. هي تعلن فقط نوع المستند. هنا، إنها تبلغ المتصفح بأن نوع المستند هو [HTML5](https://html.spec.whatwg.org/#the-doctype). هذا هو دائما بداية أي ملف HTML5.
+* إن العلامة الأساسية، `<html>`، هي دائما بداية أي صفحة ويب و `</html>` هي دائما النهاية. كما ترون، المحتوى الكامل للموقع يقع بين علامة البداية `<html>` وعلامة الإغلاق `</html>`
+* `<p>`علامة لعناصر الفقرة؛ `</p>` يغلق كل فقرة
+
+## الرأس والجسم
+
+كل صفحة HTML تنقسم إلى عنصرين هما **head** و **body**.
+
+* **head** هو عنصر يحتوي على معلومات حول المستند الذي لا يتم عرضه على الشاشة.
+
+* **body** هو عنصر يحتوي على كل شيء يتم عرضه كجزء من صفحة ويب.
+
+نحن نستخدم `<head>` لإخبار المتصفح عن إعدادات الصفحة، و `<body>` ليقول ما هو موجود فعلا في الصفحة.
+
+على سبيل المثال، يمكنك وضع عنصر عنوان صفحة ويب داخل `<head>`، مثل هذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+قم بحفظ الملف وقم بتحديث الصفحة الخاصة بك.
+
+![الرقم 11.3](images/step4.png)
+
+لاحظ كيف أن المستعرض قد فهم أن "Ola's blog" هو عنوان الصفحة الخاصة بك؟ لقد فسرت `<title>Ola's blog</title>` ووضعت النص في شريط عنوان المتصفح (سيتم استخدامه أيضا للإشارات المرجعية وما إلى ذلك).
+
+ربما كنت قد لاحظت أيضا أن كل علامة افتتاح تقابلها *closing tag* مع `/` وذالك العنصر هو *nested* (بمعنى أنه لا يمكنك إغلاق علامة معينة حتى يتم إغلاق كل العلامات الموجودة داخلها).
+
+أنها مثل وضع الأمور في صناديق. لديك صندوق واحد كبيرة ، `<html></html>`؛ يوجد داخله `<body></body>`، والذي يحتوي على صناديق صغيرة `<p></p>`.
+
+تحتاج إلى اتباع قواعد *الإغلاق* هذه ، و *تداخل* العناصر – إذا لم تقم بذالك، المستعرض قد لا يكون قادراً على تفسيرها بشكل صحيح وسيتم عرض الصفحة الخاصة بك بشكل غير صحيح.
+
+## تخصيص القالب الخاص بك
+
+يمكنك الآن الحصول الأن على بعض المتعة ومحاولة تخصيص القالب الخاص بك! وإليك بعض العلامات المفيدة لذلك:
+
+* `<h1>A heading</h1>` لأهم عنوان لديك
+* `<h2>A sub-heading</h2>` لعنوان في المستوى التالي
+* `<h3>A sub-sub-heading</h3>` ومع ذالك إلى `<h6>`
+* `<p>فقرة من النص</p>`
+* ويؤكد `<em>text</em>` على النص الخاص بك
+* ويؤكد `<strong>text</strong>` بشدة على النص الخاص بك
+* `<br>`يذهب إلى سطر آخر (لا يمكنك وضع أي شيء داخل br وليس هناك أي علامة إغلاق)
+* `<a href="https://djangogirls.org">link</a>` إنشاء رابط
+* `<ul><li>first item</li><li>second item</li></ul>` أنشئ قائمة مثل هذه!
+* `<div></div>` تعرف جزء من الصفحة
+* `<nav></nav>` يحدد مجموعة من روابط التنقل
+* `<article></article>` يحدد محتوى مستقل ومحتفظ بذاته
+* `<section></section>` يحدد القسم في مستند
+* `<header></header>` يحدد رأس المستند أو القسم
+* `<main></main>` يحدد المحتوى الرئيسي للمستند
+* `<aside></aside>` يحدد بعض المحتوى بعيداً عن المحتوى الذي يتم وضعه فيه (مثل الشريط الجانبي)
+* `<footer></footer>` يحدد تذييل المستند أو المقطع
+* `<time></time>` يحدد الوقت المحدد (أو التاريخ والوقت)
+
+هنا مثال لقالب كامل انسخه والصقه `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+لقد قمنا بإنشاء قسم `header` واحد وقسمان `article` اثنان هنا.
+
+* يحتوي العنصر `header` على عنوان مدونتنا - إنه عنوان ورابط
+* العنصران `article` يحتويان مشاركات مدونتنا مع تاريخ نشر في عنصر `time`، عنصر `h2` مع عنوان مشاركة قابل للنقر وعنصر (فقرة) `p` لنص مشاركة المدونة الخاص بنا.
+
+هو يتيح لنا هذا التأثير:
+
+![الرقم 11.4](images/step6.png)
+
+يااي! ولكن حتى الآن، يعرض نموذجنا تماما **نفس المعلومات** - بينما كنا نتحدث عن النماذج في وقت سابق للسماح لنا بعرض معلومات ** مختلفة ** في **نفس التنسيق**.
+
+ما كنا نريد فعله حقا هو اضهار مشاركات حقيقية في ادارة دجانغو ، وذالك اين سنذهب لاحقا ،.
+
+## شيء اخر: أنشر الوقت!
+
+سيكون من الجيد أن نرى كل هذا على الإنترنت، ايس كذالك؟ دعونا ننشر بايثون في كل مكان اخر:
+
+### فوض وادفع التعليمات البرمجية الخاصة بك الى Github
+
+أولاً، دعونا نرى ما هي الملفات التي تغيرت منذ آخر نشر (شغل هذه الأوامر محليا ، ليس في بايثون في كل مكان):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+تأكد من أنك في مجلد `djangogirls` ودعنا نخبر `git` بتضمين جميع التغييرات ضمن هذا المجلد:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+قبل رفع جميع الملفات دعنا نرى ماذا سترفع `git` ( جميع الملفات التي ترفعها `git` يجب ان تضهر باللون الأخضر):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+شارفنا على الانتهاء ، الآن حان الوقت لنقول لها ان تحفض هذه التغييرات بتاريخها. سنعطيه "رسالة التزام" حيث نصف ما قمنا بتغييره. يمكنك كتابة ما تريد في هذه الحالة ، لكن من الأفضل ان تكتب شيء يدل على ما قمت بفعله حتى تتذكر في المستقبل.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **ملاحظة** تأكد من استخدام علامات الاقتباس المزدوجة حول رسالة التفويض.
+
+عندما نقوم بذالك نرفع او ندفع بتعديلاتنا إلى GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### اسحب التعليمات الجديدة إلى PythonAnywhere، وأعد تحميل تطبيق الويب
+
+* افتح [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) واذهب الى **Bash console** او افتح واحدة جديدة وشغل هذا الأمر:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+ستحتاج إلى استبدال `<your-pythonanywhere-domain>` باسم النطاق الفرعي الخاص بك PythonAnywhere بدون أقواس الزاوية. اسم المجال الفرعي الخاص بك عادة هو اسم المستخدم PythonAnywhere الخاص بك، ولكن في بعض الحالات قد يكون مختلفا بعض الشيء (مثل إذا كان اسم المستخدم الخاص بك يحتوي على أحرف كبرى). إذا كان هذا الأمر لا يعمل، استخدم أمر `ls` (قائمة الملفات) للعثور على النطاق الفرعي/المجلد الفعلي الخاص بك، ثم `cd` إلى هناك.
+
+الآن شاهد التعليمات البرمجية الخاصة بك يتم تنزيلها. إذا كنت ترغب في التحقق من أنه وصل، يمكنك الانتقال إلى صفحة **"الملفات"** وعرض التعليمات البرمجية الخاصة بك على PythonAnywhere (يمكنك الوصول إلى صفحات بايثون في كل مكان الأخرى من زر القائمة على صفحة وحدة التحكم).
+
+* وأخيراً، انتقل إلى ["Web" page](https://www.pythonanywhere.com/web_app_setup/) واضغط على **Reload** في تطبيق الويب الخاص بك.
+
+تحديثك يجب ان يكون متاح, قم بعمل تحديث صفحة الموقع في المتصفح. التغييرات يجب ان تظهر لك الان
\ No newline at end of file
diff --git a/ar-SA/installation/README.md b/ar-SA/installation/README.md
new file mode 100644
index 00000000000..f1a3aff5161
--- /dev/null
+++ b/ar-SA/installation/README.md
@@ -0,0 +1,68 @@
+# إذا كنتم تتبعون الدليل التطبيقي من منازلكم
+
+إذا كنتم تتبعون الدليل التطبيقي من منازلكم وليس في أحد [فعاليات Django Girls](https://djangogirls.org/events/)، يمكنك تخطي هذا الفصل الآن والانتقال مباشرة إلى فصل ["كيف يعمل الإنترنت" ](../how_the_internet_works/README.md).
+
+وذلك لأننا سنغطي جزئية تحميل بعض البرامج التي نحتاجونها في الدليل التطبيقي - هذه مجرد صفحة إضافية تجمع جميع التعليمات لتحميل البرامج في صفحة واحدة (ستكون مفيدة لبعض ورش العمل). تستطيعون اختيار تحميل جميع البرامج في هذه الصفحة من الآن إن أردتم. لكن إذا أردنم البدء في التعلم قبل تحميل البرامج اللازمة على أجهزتكم، فيمكنكم تجاهل هذا الفصل وسنشرح لك جزئية التحميل لاحقاً كلما احتجناها.
+
+بالتوفيق!
+
+# إذا كنتم حاضرين لورشة العمل
+
+إذا كنتم حاضرين لأحد [فعاليات Django Girls](https://djangogirls.org/events/):
+
+* ورشة العمل قد تبدأ بـ "حفلة التحميل" قبل الورشة الأساسية. إذا كنتم في حقلة التحميل، فهذه الصفحة لكم! اتبعوا التعليمات هنا لتحصلوا على كل ما تحتاجونه للورشة، بمساعدة المرشدات إذا احتجتم. ثم في الورشة الأساسية، يمكنكم تجاهل جزئية التحميل التي ستمر بكم أثناء قرائتكم للدليل التطبيقي.
+* قد يكون منظموا الورشة طلبوا منكم تحميل كل شيء على أجهزتكم من منازلكم قبل بدء الورشة. إذا كان طلب منكم هذا، فهذه الصفحة لكم! اتبعوا التعليمات هنا، بأفضل قدرنكم. ثم في الورشة الأساسية، عندما تصلون لخطوة تحميل في الدليل التطبيقي، إذا لم تستطعون تحميل المطلوب فيمكنكم طلب المساعدة من المرشدات. 
+* إذا لم تبدأ ورشة العمل بحفلة التثبيت (أو لم تستطيعوا الحضور)، ولم يطلبوا منكم المنظمين تحميل المتطلبات قبل الحضور، تجاهلوا هذه الصفحة واذهبوا مباشرة إلى فصل [كيف يعمل الانترنت](../how_the_internet_works/README.md). ستحملون جميع ما تحتاجونه خلال اتباعكم للدليل التطبيقي.
+
+# التحميل
+
+في هذا الدليل التطبيقي ستبنون مدونة. ولعمل ذلك، أثناء تتبعكم للدليل التطبيقي ستمرون بتعليمات لتحميل برامج مختلفة على أجهزتكم وإعداد بعض الحسابات على الإنترنت كلما تطلب ذلك. هذه الصفحة تجمع جميع التعليمات لتحميل البرامج وتسجيل الحسابات في مكان واحد (ستكون مفيدة لبعض ورش العمل)
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# مقدمة مختصرة عن موجه الأوامر {#command-line}
+
+العديد من الخطوات أدناه تشير إلى "وحدة التحكم"، "الطرف"، "نافذة الأوامر"، أو "سطر الأوامر" -- هذه كلها تعني نفس الشيء: نافذة على جهاز الكمبيوتر الخاص بك حيث يمكنك إدخال الأوامر. عندما تصل إلى البرنامج التعليمي الرئيسي، سوف تتعلم المزيد عن سطر الأوامر. الآن، الشيء الرئيسي الذي تحتاج إلى معرفته هو كيفية فتح نافذة أمر وكيف تبدو: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# تثبيت بايثون {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# تثبيت محرر التعليمات البرمجية {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# إعداد virtualenv وتثبيت Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# تثبيت Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# إنشاء حساب Github {#github-account}
+
+انتقل إلى [GitHub.com](https://www.github.com) وقم بالتسجيل للحصول على حساب مستخدم مجاني جديد. تأكد من تذكر كلمة المرور الخاصة بك (أضفها إلى مدير كلمات المرور الخاصة بك، إذا كنت تستخدم أحدهم).
+
+# قم بإنشاء حساب بايثون في كل مكان {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# ابدأ بالقراءة
+
+تهانينا، انت جاهز الأن وعلى استعداد للإنطلاق! إذا كان لا يزال لديك بعض الوقت قبل انعقاد حلقة العمل، سيكون من المفيد بدء قراءة عدد قليل من فصول البداية:
+
+* [كيف يعمل الإنترنت](../how_the_internet_works/README.md)
+
+* [مقدمة لسطر الأوامر](../intro_to_command_line/README.md)
+
+* [مقدمة إلى بايثون](../python_introduction/README.md)
+
+* [ما هو جانغو؟](../django/README.md)
+
+# استمتع بورشة العمل!
+
+عند بدء ورشة العمل، ستتمكن من الانتقال مباشرة إلى [أول مشروع جانغو الخاص بك!](../django_start_project/README.md) لأنك قمت بالفعل بتغطية المادة في الفصول السابقة.
\ No newline at end of file
diff --git a/ar-SA/intro_to_command_line/README.md b/ar-SA/intro_to_command_line/README.md
new file mode 100644
index 00000000000..026f8f30e70
--- /dev/null
+++ b/ar-SA/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# مقدمة لواجهة سطر الأوامر
+
+> للقراء في المنزل: هذا الفصل تم التكلم عنه في [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+أنه مثير، أليس كذلك؟! عليك كتابة السطر الأول الخاص بك من التعليمات البرمجية في بضع دقائق فقط! :)
+
+**دعونا نقدم لكم صديقكم الأول: سطر الأوامر!**
+
+الخطوات التالية سوف تظهر لك كيفية استخدام النافدة السوداء التي يستخدمها جميع الهكر. قد تبدو مخيفه قليلاً في البداية ولكن حقاً أنها مجرد موجه تنتظر الأوامر منك.
+
+> **ملاحظة** يرجى ملاحظة أن طوال هذا الكتاب يمكننا استخدام عبارات 'الدليل' و 'مجلد' بالتبادل ولكنها واحدة ونفس الشيء.
+
+## ما هو سطر الأوامر؟
+
+النافذة، والتي عادة ما تسمى **سطر الأوامر** أو **واجهة سطر الأوامر**، هو تطبيق يستند إلى النص للعرض، والمناولة، ومعالجة الملفات الموجودة على جهاز الكمبيوتر الخاص بك. أنه يشبه إلى حد كبير ويندوز إكسبلورر أو الباحث في Mac، ولكن دون واجهة رسومية. أسماء أخرى لسطر الأوامر هي: *cmd*, *CLI*, *prompt*, *console* أو *terminal*.
+
+## إفتح واجهة سطر الأوامر
+
+لبدء بعض التجارب نحن بحاجة إلى فتح واجهة سطر الأوامر لدينا أولاً.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## موجه
+
+يجب أن تشاهد الآن نافذة بيضاء أو سوداء تنتظر الأوامر الخاصه بك.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+إذا كنت على Mac أو Linux، ربما ترى `$`، مثل هذا:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+على Windows، ربما ترى `>`، مثل هذا:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+ألقي نظرة على قسم لينكس أعلاه مباشرة -- سترى شيئا مثل هذا عندما تصل إلى PythonAnywhere لاحقا في البرنامج التعليمي.
+
+<!--endsec-->
+
+سيتم إرفاق كل أمر مسبقاً بواسطة `$` أو `>` ومسافة واحدة، ولكن يجب ألا تكتبها. الكمبيوتر الخاص بك سوف يفعله من أجلك. :)
+
+> ملاحظة صغيرة: في حالتك قد يكون هناك شيء مثل `C:\Users\ola>` أو `Olas-MacBook-Air:~ ola$` قبل علامة الطلب، وهذا هو 100% على ما يرام.
+
+الجزء الذي يصل إلى ويحتوي على `$` أو `>` يسمى *موجه سطر الأوامر*، أو *الموجه* بإختصار. إنه يطالبك بإدخال شيء هناك.
+
+في البرنامج التعليمي، عندما نريد منك كتابة أمر ما، سنقوم بتضمين `$` أو `>`، وأحيانا أكثر إلى اليسار. تجاهل الجزء الأيسر واكتب فقط في الأمر، الذي يبدأ بعد الموجه.
+
+## الأمر الأول الخاص بك (ياي!)
+
+دعونا نبدأ بكتابة هذا الأمر:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+ثم اضغط على `enter`. هذه هي النتيجة لدينا:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+كما ترون، الكمبيوتر قد طبع اسم المستخدم الخاص بك. أنيق، هاه؟ :)
+
+> حاول كتابة كل أمر؛ لا تنسخ وتلصق. سوف تتذكر أكثر بهذه الطريقة!
+
+## الأساسيات
+
+كل نظام تشغيل يحتوي على مجموعة مختلفة قليلاً من أوامر سطر الأوامر، لذا تأكد من اتباع التعليمات لنظام التشغيل الخاص بك. دعونا نحاول هذا،هيا بنا؟
+
+### الدليل الحالي
+
+سيكون من الجميل أن نعرف أين نحن الآن، اليس كذالك؟ لنرى. اكتب هذا الأمر وإضغط `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> ملاحظة: 'pwd' تعني 'طباعة دليل العمل'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> ملاحظة: 'cd' تعني 'تغيير الدليل'. مع PowerShell يمكنك استخدام pwd تماما مثل Linux أو Mac OS X.
+
+<!--endsec-->
+
+ربما سترى شيئا مشابها على الجهاز الخاص بك. عندما تقوم بفتح سطر الأوامر تبدأ عادة في الدليل الرئيسي للمستخدم الخاص بك.
+
+* * *
+
+### معرفة المزيد حول الأمر
+
+العديد من الأوامر التي يمكنك كتابتها في موجه الأوامر لها مساعدة مدمجة يمكنك عرضها وقراءتها! على سبيل المثال، لمعرفة المزيد عن أمر الدليل الحالي:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X و Linux لديهما أمر `man` الذي يعطيك المساعدة في الأوامر. جرب `man pwd` وشاهد ما يقوله، أو ضع `man` قبل أوامر أخرى لمشاهدة مساعدتهم. ناتج `man` هو عادة صفحة استخدم زر المسافة للإنتقال إلى الصفحة التالية، و `q` للخروج من النظر إلى المساعدة.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+إضافة `/?` لاحقة لمعظم الأوامر سوف يطبع صفحة المساعدة. قد تحتاج إلى تمرير نافذة الأوامر الخاصة بك لرؤية كل شيء. جرب `cd /?`.
+
+<!--endsec-->
+
+### قائمة الملفات والدلائل
+
+اذاً ماذا فيها؟ سيكون من الرائع معرفة ذلك، دعونا نرى:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> ملاحظة: في PowerShell يمكنك أيضا استخدام 'ls' مثل Linux و Mac OS X. <!--endsec-->
+
+* * *
+
+### تغيير الدليل الحالي
+
+الآن، دعونا نذهب إلى دليل سطح المكتب لدينا:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+لاحظ أن اسم الدليل "سطح المكتب" قد يترجم إلى لغة حساب لينكس الخاص بك. إذا كان الأمر كذلك، ستحتاج إلى استبدال `Desktop` بالاسم المترجم؛ على سبيل المثال، `Schreibtisch` بالألمانية.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+تحقق إذا كان تم تغييره حقا:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+ها هي!
+
+> نصيحة المحترفين: إذا كتبت `cd D` ثم ضغطت على `tab` في لوحة المفاتيح، فسيملأ سطر الأوامر تلقائيا بقية الاسم حتى تتمكن من التنقل بشكل أسرع. إذا كان هناك أكثر من مجلد واحد يبدأ بـ "D"، اضغط على مفتاح `tab` مرتين للحصول على قائمة الخيارات.
+
+* * *
+
+### إنشاء دليل
+
+ماذا عن إنشاء دليل تدريب على سطح المكتب الخاص بك؟ يمكنك القيام بذلك بهذه الطريقة:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+سيؤدي هذا الأمر الصغير إلى إنشاء مجلد باسم `practice` على سطح المكتب. يمكنك التحقق إذا كان هناك من خلال النظر في سطح المكتب الخاص بك أو بواسطة تشغيل أمر `dir` أو `ls`! جربها. :)
+
+> نصيحة للمحترفين: إذا كنت لا ترغب في كتابة نفس الأوامر مراراً وتكراراً، حاول الضغط على `سهم للأعلى` و `سهم للأسفل` على لوحة المفاتيح للتنقل عبر الأوامر المستخدمة مؤخرا.
+
+* * *
+
+### تمرين!
+
+تحدي صغيرة بالنسبة لك: في الدليل الذي تم إنشاؤه حديثا `practice` ، قم بإنشاء دليل يسمى `test`(استخدم الأمرين `cd` و `mkdir`.)
+
+#### الحل:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+تهانينا! :)
+
+* * *
+
+### التنظيف
+
+لا نريد أن تترك فوضى، لذلك دعونا نزيل كل ما قمنا به حتى هذه النقطة.
+
+أولاً، نحن بحاجة للعودة إلى سطح المكتب:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+استخدام `..` مع أمر `cd` سيغير الدليل الحالي الخاص بك إلى الدليل الأصلي (وهو، الدليل الذي يحتوي على الدليل الحالي الخاص بك).
+
+تحقق أين أنت:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+حان الوقت الآن لحذف دليل `practice`:
+
+> **انتباه**: حذف الملفات بإستخدام `del`، `rmdir` أو `rm` غير قابل للإسترداد، مما يعني أن *الملفات المحذوفة ستزول للأبد*! لذا كن حدرا جدا مع هذه الأوامر.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+تم! للتأكد دعونا نتحقق من انك حدفته فعليا:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### الخروج
+
+هذا كل شيء الأن! يمكنك إغلاق سطر الأوامر الآن بأمان. دعونا نفعل ذلك بطريقة القراصنة، حسناً؟ :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+رائع، هاه؟ :)
+
+## الملخص
+
+هنا ملخص لبعض الأوامر المفيدة:
+
+| الأوامر (في Windows) | الأوامر في (ماك/لينكس) | الوصف                 | أمثلة                                              |
+| -------------------- | ---------------------- | --------------------- | -------------------------------------------------- |
+| exit                 | exit                   | أغلق النافذة          | **exit**                                           |
+| cd                   | cd                     | تغيير الدليل          | **cd test**                                        |
+| cd                   | pwd                    | إظهار الدليل الحالي   | **cd** (Windows) o **pwd** (Mac OS / Linux)        |
+| dir                  | ls                     | قائمة الدلائل/ملفات   | **dir**                                            |
+| copy                 | cp                     | نسخ ملف               | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move                 | mv                     | نقل الملف             | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir                | mkdir                  | إنشاء دليل جديد       | **mkdir testdirectory**                            |
+| rmdir (or del)       | rm                     | حذف الملف             | **del c:\test\test.txt**                         |
+| rmdir /S             | rm -r                  | حذف الدليل            | **rm -r testdirectory**                            |
+| [CMD] /?             | man [CMD]              | احصل على مساعدة للأمر | **cd /?** (Windows) أو **man cd** (Mac OS / Linux) |
+
+هذه فقط عدد قليل جداً من الأوامر التي يمكنك تشغيلها في سطر الأوامر الخاصة بك، ولكنك لن تستخدم أي شيء اكثر من ذلك اليوم.
+
+إذا كنت فضولياً، [ss64.com](http://ss64.com) يحتوي على مرجع كامل للأوامر لجميع أنظمة التشغيل.
+
+## مستعد ؟
+
+دعونا نغوص في بايثون!
\ No newline at end of file
diff --git a/ar-SA/intro_to_command_line/open_instructions.md b/ar-SA/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..e50bd708d81
--- /dev/null
+++ b/ar-SA/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+اعتماداً على إصدارك من Windows ولوحة المفاتيح الخاصة بك، واحد مما يلي يجب أن يفتح نافذة أمر (قد تضطر إلى تجربة قليلًا)، ولكن ليس عليك تجربة كل هذه المقترحات:
+
+- انتقل إلى قائمة أو شاشة البدء وأدخل "طلب الأوامر" في حقل البحث.
+- اذهب إلى قائمة البدء → نظام ويندوز → طلب الأوامر.
+- اذهب إلى قائمة البدء → جميع البرامج → الملحقات → أمر الدفع.
+- اذهب إلى شاشة البدء، وقفل الفأرة في الزاوية اليسرى السفلى من الشاشة، وانقر فوق السهم لأسفل الذي يظهر (على شاشة اللمس، بدلا من ذلك ارتفع من أسفل الشاشة). يجب فتح صفحة التطبيقات. انقر على توجيه الأوامر في قسم نظام ويندوز.
+- امسك مفتاح ويندوز الخاص على لوحة المفاتيح الخاصة بك واضغط على مفتاح "X". اختر "طلب الأوامر" من القائمة المنبثقة.
+- امسك مفتاح ويندوز واضغط على مفتاح "R" للحصول على نافذة "تشغيل". اكتب "cmd" في المربع، وانقر فوق مفتاح OK.
+
+![أكتب "cmd" في نافدة "Run&quot](../python_installation/images/windows-plus-r.png)
+
+في وقت لاحق من هذا البرنامج التعليمي، ستحتاج إلى وجود نافذتين للأوامر مفتوحة في نفس الوقت. ومع ذلك، في بعض إصدارات Windows، إذا كان لديك بالفعل نافذة أمر واحدة مفتوحة وتحاول فتح واحدة ثانية باستخدام نفس الطريقة، وبدلا من ذلك سيوجهك إلى نافذة الأوامر التي لديك بالفعل مفتوحة. جرب الآن على جهاز الكمبيوتر الخاص بك وشاهد ما يحدث! إذا حصلت على نافذة أمر واحدة فقط، جرب إحدى الطرق الأخرى في القائمة أعلاه. وينبغي أن يؤدي واحد منها على الأقل إلى فتح نافذة أوامر جديدة.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+انتقل إلى التطبيقات → الأدوات المساعدة → تيرمينال.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+ربما تحت التطبيقات → الملحقات → الطرفية، أو التطبيقات → System → Terminal, ولكن هذا قد يعتمد على النظام الخاص بك. إذا لم يكن هناك ، يمكنك محاولة جوجل. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ar-SA/python_installation/README.md b/ar-SA/python_installation/README.md
new file mode 100644
index 00000000000..1cf443314aa
--- /dev/null
+++ b/ar-SA/python_installation/README.md
@@ -0,0 +1,15 @@
+# لنبدأ مع بايثون
+
+وأخيراً نحن هنا!
+
+ولكن أولاً، دعونا نقول لكم ما هي بايثون. بايثون هي لغة برمجة شعبية جداً والتي يمكن استخدامها لإنشاء المواقع والألعاب والبرامج العلمية، والرسومات والكثير، أكثر بكثير.
+
+بايثون نشأت في أواخر الثمانينات، وهدفها الرئيسي أن يتمكن البشر من قراءتها (ليس فقط آلألات!). هذا هو السبب في أنها تبدو أبسط من لغات البرمجة الأخرى، ولكن لا تقلق - بايثون قوية ايضا!
+
+# تركيب بايثون
+
+> **ملاحضة**إذا كنت تستخدم كروم بوك تخطى هذا القسم وتابع الإرشادات الموجودة في [التركيب على كروم بوك](../chromebook_setup/README.md).
+> 
+> **ملاحظة** إذا كنت قد عملت بالفعل من خلال [خطوات التثبيت](../installation/README.md)، ليس هناك حاجة للقيام بذلك مرة أخرى - يمكنك التخطي مباشرة إلى الفصل التالي!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ar-SA/python_installation/instructions.md b/ar-SA/python_installation/instructions.md
new file mode 100644
index 00000000000..78d464ffba0
--- /dev/null
+++ b/ar-SA/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> للقراء في المنزل: هذا الفصل تم التكلم عنه في [تثبيت بايثون محرر التعليمات البرمجية](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> هذا القسم يستند على دورة تعليمية من فتيات الجزر المهووسات (https://github.com/ggcarrots/django-carrots)
+
+دجانغو مكتوب في بايتون. نحتاج إلى بايثون للقيام بأي شيء في دجانغو. دعونا نبدأ بتثبيته! نريد منك تثبيت أحدث إصدار من Python 3، لذا إذا كان لديك أي إصدار سابق، فستحتاج إلى ترقيته. إذا كان لديك بالفعل الإصدار {{ book.py_min_version }} أو أعلى يجب أن تكون على ما يرام.
+
+الرجاء تثبيت بايثون العادية كما يلي، حتى عندما يكون لديك أناكوندا مثبت على جهاز الكمبيوتر الخاص بك.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+أولاً تحقق مما إذا كان جهاز الكمبيوتر الخاص بك يقوم بتشغيل إصدار 32 بت أو إصدار 64 بت من Windows، على سطر "نوع النظام" من صفحة معلومات النظام. للوصول إلى هذه الصفحة، حاول أحد هذه الأساليب:
+
+* اضغط على مفتاح ويندوز ومفتاح الإيقاف/الاستراحة في نفس الوقت
+* افتح لوحة التحكم الخاصة بك من قائمة ويندوز، ثم انتقل إلى النظام & الأمان، ثم النظام
+* اضغط على زر Windows ، ثم انتقل إلى الإعدادات > النظام > حول
+* ابحث في قائمة بدء تشغيل ويندوز عن "معلومات النظام". للقيام بذلك، انقر فوق زر البدء أو اضغط على مفتاح ويندوز، ثم ابدأ في كتابة `معلومات النظام`. سوف تبدأ في تقديم الاقتراحات بمجرد أن تكتب. يمكنك اختيار الإدخال بمجرد ظهوره.
+
+يمكنك تحميل بايثون ل Windows من https://www.python.org/downloads/windows/. انقر فوق "Latest Python 3 Release - Python x.x.x". إذا كان جهاز الكمبيوتر الخاص بك يقوم بتشغيل إصدار **64 بت** من Windows، حمل **Windows x86-64 executable installer**. وبخلاف ذلك، حمل **Windows x86 executable installer**. بعد تحميل المثبت، ينبغي تشغيله (انقر نقراً مزدوجاً على الملف) واتبع الإرشادات الموجودة هناك.
+
+شيء واحد يجب مراقبته: أثناء التثبيت، ستلاحظ علامة نافذة "الإعداد". تأكد من تحديد مربع الاختيار "إضافة بايثون {{ book.py_version }} إلى باث" أو "إضافة بايثون إلى متغيرات البيئة الخاصة بك" وانقر على "تثبيت الآن"، كما يظهر هنا (قد يبدو مختلفا بعض الشيء إذا كنت تقوم بتثبيت إصدار مختلف):
+
+![لا تنسى إضافة بايثون إلى المسار](../python_installation/images/python-installation-options.png)
+
+عند اكتمال التثبيت، قد ترى مربع حوار مع رابط يمكنك متابعته لمعرفة المزيد عن بايثون أو عن الإصدار الذي قمت بتثبيته. إغلاق أو إلغاء مربع الحوار هذا -- سوف تتعلم المزيد في هذا البرنامج التعليمي!
+
+ملاحظة: إذا كنت تستخدم نسخة قديمة من ويندوز (7، فيستا، أو أي إصدار قديم) وتثبيت Python {{ book.py_version }} فشل بخطأ، قم بتثبيت كافة تحديثات ويندوز وحاول تثبيت بايثون مرة أخرى. إذا كنت لا تزال تعاني من الخطأ، حاول تثبيت إصدار بايثون {{ book.py_min_release }} من [Python.org](https://www.python.org/downloads/windows/).
+
+> جانغو {{ book.django_version }} يحتاج Python {{ book.py_min_version }} أو أكثر، الذي لا يدعم Windows XP أو الإصدارات السابقة.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **ملاحظة** قبل تثبيت Python على OS X، يجب التأكد من أن إعدادات Mac تسمح بتثبيت الحزم التي ليست من متجر التطبيق. انتقل إلى تفضيلات النظام (هو في مجلد التطبيقات)، انقر فوق "الأمان & الخصوصية"، ثم علامة التبويب "الجنرال". إذا تم تعيين "السماح للتطبيقات التي تم تنزيلها من:" إلى "Mac App Store،" قم بتغييره إلى "Mac App Store والمطورين المحددين."
+
+يجب عليك زيارة هذا الموقع وتحميل مثبت بايثون https://www.python.org/downloads/mac-osx/:
+
+* تحميل ملف *مثبت Ma c OS X 64-بت/32-بت * ،
+* انقر نقراً مزدوجاً فوق *python-3.6.1-macosx10.6.pkg* لتشغيل المثبت.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+من المحتمل جدا ان لديك نسخة بايثون مثبتة بالفعل ، للتحقق ادخل الأوامر التالية في وحدة التحكم:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+إذا كان لديك نسخة مختلفة من Python مثبتة، على الأقل {{ book.py_min_version }} ( {{ book.py_min_release }}مثلاً)، فلن تحتاج إلى الترقية. إذا لم يكن لديك Python مثبت، أو إذا كنت تريد إصدار مختلف، فتحقق أولاً من توزيع لينكس الذي تستخدمه مع الأمر التالي:
+
+{% filename %}command-line{% endfilename %}
+
+    $ تنبيه '^NAME=' /etc/os-release
+    
+
+وبعد ذلك، ووفقا للنتيجة، اتبع أحد أدلة التثبيت التالية تحت هذا القسم.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+استخدم هذا الأمر في وحدة التحكم الخاصة بك:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+استخدم هذا الأمر في وحدة التحكم الخاصة بك:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+إذا كنت تستخدم إصدار فيدورا قديم قد تحصل على خطأ لم يتم العثور على الأمر dnf. في هذه الحالة تحتاج إلى استخدام yum بدلاً من ذلك.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+استخدم هذا الأمر في وحدة التحكم الخاصة بك:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+تحقق من أن عملية التثبيت كانت ناجحة بفتح موجه الأوامر ثم تشغيل الأمر `python3`:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+قد يكون الإصدار المعروض مختلفا عن {{ book.py_release }} -- يجب أن يتطابق مع الإصدار الذي قمت بتثبيته.
+
+**ملاحظة:** إذا كنت على Windows وتحصل على رسالة خطأ التي `python3` لم يتم العثور عليها، حاول استخدام `بايثون` (دون `3`) وتحقق مما إذا كان لا يزال إصدار بايثون {{ book.py_min_version }} أو أعلى. إذا لم ينجح ذلك أيضاً، فيمكنك فتح موجه أوامر جديد والمحاولة مرة أخرى؛ يحدث هذا إذا كنت تستخدم موجه أوامر تم فتحه قبل تثبيت بايثون.
+
+* * *
+
+إذا كان لديك أي شكوك، أو إذا حدث خطأ ما، وليس لديك أي فكرة عما تفعله بعد ذلك، يرجى سؤال مدربك! أحيانا لا تسير الأمور بسلاسة، لذا من الأفضل أن تطلب المساعدة من شخص لديه خبرة أكبر.
\ No newline at end of file
diff --git a/ar-SA/python_introduction/README.md b/ar-SA/python_introduction/README.md
new file mode 100644
index 00000000000..68f6eebc54a
--- /dev/null
+++ b/ar-SA/python_introduction/README.md
@@ -0,0 +1,1073 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# مقدمة إلى بايثون
+
+> هذا القسم يستند على دورة تعليمية من فتيات الجزر المهووسات (https://github.com/ggcarrots/django-carrots).
+
+دعونا نكتب بعض الأكواد!
+
+## موجه بايثون
+
+> للقراء في المنزل: تم تغطية هذا الجزء في فيديو [ أساسيات بايثون: عدد صحيح، سلاسل، قوائم، متغيرات وأخطاء ](https://www.youtube.com/watch?v=MO63L4s-20U).
+
+من أجل تعلم واللعب بـ بايثون ، علينا أن نفتح *command line* على جهاز الكمبيوتر. من المفترض أنكم تعرفوا كيف تفعلوا ذلك - لقد تعلمتم ذلك في فصل [Intro to Command Line](../intro_to_command_line/README.md)
+
+بمجرد أن تكونوا جاهزون ، تتبعوا التعليمات التي بالأسفل.
+
+نريد أن نفتح وحدة تحكم بايثون ، اكتبوا `python` على وندوز أو `python3` على ماك أو لينكس واضغطوا `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## أمر بايثون الأول الخاص بك!
+
+بعد تشغيل أمر Python ، تغير الموجه إلى `>>>`. هذا يعني أنه حالياً يمكننا فقط إستخدام الأوامر الخاصة بلغة البايثون. لا يتوجب عليكم أن تكتبوا `>>>` - بايثون سوف يفعل ذلك
+
+إذا كنتم تريدون أن تخرجوا من وحدة تحكم باثون في أي وقت ، اكتبوا `exit()` أو استخدموا الإختصار `Ctrl + Z` في وندوز أو `Ctrl + D` في ماك أو لينكس. لن تروا `>>>` مجدداً
+
+الآن ، نحن لا نريد الخروج من وحدة تحكم بايثون. نريد أن نتعلم أكثر عنه. دعونا نبدأ بكتابة بعض الرياضيات ، مثل `2 + 3` ونضغط `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+جميل! هل ترون كيف برزت الإجابة؟ بايثون يعرف الرياضيات! يمكنكم تجربة أوامر أخرى مثل:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+إذا كنتم تريدون كتابة معادلات أسية ، مثل 2 أس 3 ، نكتب: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+استمتعوا بهذا لبعض الوقت ثم عودوا إلى هنا. :)
+
+كما ترون، بايثون آلة حاسبة رائعة. إذا كنت تتساءل عما يمكنك فعله…
+
+## سلسلة
+
+ماذا عن اسمك؟ اكتب اسمك الأول في اقتباسات مثل هذا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+لقد أنشأت الآن السلسلة الأولى! هو تسلسل أحرف يمكن معالجتها بواسطة جهاز الكمبيوتر. يجب ان تبدأ السلسلة وتنتهي بنفس الحرف. قد يكون هذا واحد (`'`) أو الضعف (`"`) اقتباس (لا فرق!) الإقتباس يقول لبايثون انه هناك سلسلة.
+
+السلاسل يمكن أن تكون مربوطة معا. جرب هذا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+يمكنك أيضا ضرب السلاسل مع عدد:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+إذا كنت بحاجة إلى وضع علامة اقتباس أحادية داخل السلسلة الخاصة بك, لديك طريقتين للقيام بذلك.
+
+استخدام علامات الاقتباس المزدوجة:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+أو الهروب من الفاصلة بخط مائل (`` \):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+لطيف، هاه؟ لرؤية اسمك بالأحرف الكبيرة، اكتب:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+لقد استخدمت `upper` **method** للتو في السلسلة الخاصة بك! طريقة (مثل `upper()`) هي سلسلة من التعليمات التي يجب على بايثون تنفيذها على شيء معين (`"Ola"`) بمجرد أن تستدعيها.
+
+إذا كنت تريد أن تعرف عدد الحروف الواردة في اسمك، هناك **function** لذلك أيضا!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+هل تتسائلون في بعض الأحيان لماذا تستدعون الدوال مع `.` في نهاية السلسلة مثل `"Ola".upper()` وفي بعض الأحيان تقومون بإستدعاء الدالة وتضعون السلسلة بين قوسين؟ حسنًا، في بعض الحالات، تنتمي الدوال إلى أشياء، مثل `upper()`، والتي لا يمكن القيام بها إلا على السلاسل. في هذه الحالة نسمي المهام ب **method**. مرات أخرى، الدوال لا تنتمي إلى أي شيء محدد ويمكن استخدامها على أنواع مختلفة من الأشياء، تماما مثل `len()`. لهذا نحن نعطي `"Ola"` كعامل متغير إلى الدالة `len`.
+
+### مُلخّص
+
+طيب، يكفينا سلآسل ، حتى الأن لقد تعلمت:
+
+- **the prompt** كتابة الأوامر (كودات) في موجه اوامر بايثون يعطينا اجابات في بايثون
+- **numbers and strings** - في بايثون تستخدم الأرقام للرياضيات والسلاسل للكائنات النصية
+- **operators** مثل `+` و `*`, تجمع بين القيم لتنتج واحدة جديدة
+- **functions** مثل `upper()` و `len()` تنفذ إجراأت على الكائنات.
+
+هذه هي أساسيات كل لغة برمجة تتعلمها. مستعد لشيء أصعب؟ نحن نراهن بأنك!
+
+## أخطاء
+
+لنجرب شيئا جديدا. هل يمكننا الحصول على طول رقم بنفس الطريقة التي يمكننا بها معرفة طول اسمنا؟ اكتب `len(304023)` واضغط `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+لقد حصلنا على أول خطأ! أيقونة {{ warning_icon }} هي طريقتنا لتنبيهك أن الكود الذي أنت على وشك تشغيله لن يعمل كما هو متوقع. إن ارتكاب الأخطاء (حتى الأخطاء المتعمدة) جزء هام من التعلم!
+
+يقول أن الأشياء من نوع "int" (الأعداد الصحيحة، الأعداد الكاملة) ليس لها أي طول. إذن ماذا يمكننا أن نفعل الآن؟ ربما يمكننا كتابة رقمنا كسلسلة؟ السلاسل لها طول، أليس كذلك؟
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+لقد كان مجدياً! استخدمنا الدالة `str` داخل الدالة `len`. الدالة `str()` تحول كل شي إلى سلاسل.
+
+- الدالة `str` تحول الأشياء إلى **strings</1 ></li> 
+    
+    - الدالة `int` تحول الأشياء إلى **integers**</ul> 
+    
+    > هام: علينا تحويل الأرقام إلى نص، ولكن لا يمكن بالضرورة تحويل النص إلى أرقام – ماذا ستكون `int('hello')` على أي حال؟
+    
+    ## المتغيرات
+    
+    مفهوم هام في البرمجة وهو المتغيرات. المتغير ليس أكثر من اسم لشيء يمكن استخدامه في وقت لاحق. يستخدم المبرمجون هذه المتغيرات لتخزين البيانات، وجعل التعليمات البرمجية الخاصة بهم أكثر قابلية للقراءة، لذا لا يتوجب عليهم أن يتذكروا ماهية الأشياء.
+    
+    لنفرض أننا نريد إنشاء متغير جديد يسمى `name`:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> name = "Ola"
+    ```
+    
+    نكتب الاسم يساوي Ola.
+    
+    كما لاحظت، لم يعيد برنامجك أي شيء كما فعل من قبل. إذاً كيف نعرف أن المتغير موجود بالفعل؟ أدخل `name` واضغط `enter`:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> name
+    'Ola'
+    ```
+    
+    يآآاي! المتغير الأول الخاص بك! :) يمكنك دائماً تغيير ما يشير إليه:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> name = "Sonja"
+    >>> name
+    'Sonja'
+    ```
+    
+    يمكنك استخدامه في الوظائف أيضا:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> len(name)
+    5
+    ```
+    
+    رائع، أليس كذلك؟ بالطبع، المتغيرات يمكن أن تكون أي شيء أرقام أيضا! جرب هذا:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> a = 4
+    >>> b = 6
+    >>> a * b
+    24
+    ```
+    
+    ولكن ماذا لو استخدمنا اسم خاطئ؟ هل يمكنك تخمين ما يمكن أن يحدث؟ دعونا نحاول!
+    
+    {% filename %}{{ warning_icon }} command-line{% endfilename %}
+    
+    ```python
+    >>> city = "Tokyo"
+    >>> ctiy
+    Traceback (most recent call last):
+      File "<stdin>", line 1, in <module>
+    NameError: name 'ctiy' is not defined
+    ```
+    
+    خطأ! كما ترون، بايثون لديه أنواع مختلفة من الأخطاء ويسمى هذا **NameError**. سوف يعطيك بايثون هذا الخطأ إذا حاولت استخدام متغير لم يتم تعريفه بعد. إذا واجهت هذا الخطأ في وقت لاحق، تحقق من التعليمات البرمجية الخاصة بك لمعرفة إذا كنت أخطأت في أي أسماء.
+    
+    العب مع هذا لبعض الوقت و شاهد ما يمكنك فعله!
+    
+    ## وظيفة الطباعة
+    
+    جرب هذا:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> name = 'Maria'
+    >>> name
+    'Maria'
+    >>> print(name)
+    Maria
+    ```
+    
+    عندما تكتب فقط `name`، يستجيب مترجم بايثون بالسلسلة *representation* للمتغير 'name', والتي هي الحروف M-a-r-i-a محاطة بعلامة إقتباس واحدة، ''. عندما تقول `print(name)`، بايثون سيقوم ب "طباعة" محتويات المتغير إلى الشاشة، دون علامات الاقتباس، وهو أكثر إتقاناً.
+    
+    كما سنرى لاحقا، `print()` مفيد أيضا عندما نريد طباعة الأشياء من داخل الدوال، أو عندما نريد طباعة الأشياء على خطوط متعددة.
+    
+    ## القوائم
+    
+    بجانب السلاسل والأعداد الصحيحة، بايثون لديه كل الأنواع المختلفة من الكائنات. الآن سوف نقدم واحدة تسمى **list**. القوائم هي بالضبط ما تعتقده: الأشياء التي هي قوائم أشياء أخرى. :)
+    
+    امضي قدما وأنشئ قائمة:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> []
+    []
+    ```
+    
+    نعم، هذه القائمة فارغة. ليست مفيدة جدا، أليس كذلك؟ دعونا ننشئ قائمة من أرقام اليانصيب. نحن لا نريد أن نكرر ذالك طوال الوقت، لذلك سنضعها في متغير أيضا:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> lottery = [3, 42, 12, 19, 30, 59]
+    ```
+    
+    حسنا، لدينا قائمة! ماذا يمكننا أن نفعل حيال ذلك؟ دعونا نرى كم عدد اليانصيب هناك في القائمة. هل لديك أي فكرة عن أي وظيفة يجب عليك استخدامها لذلك؟ أنت تعرف هذا بالفعل!
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> len(lottery)
+    6
+    ```
+    
+    نعم! `len()` يمكن أن تعطيك عددا من الكائنات في قائمة. مفيد، أليس كذلك؟ ربما سنقوم بترتيبها الآن:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> lottery.sort()
+    ```
+    
+    هذا لا يعيد أي شيء، انها مجرد تغييرات للترتيب الذي يظهر الأرقام في القائمة. دعونا نطبعه مرة أخرى ونرى ما يحدث:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> print(lottery)
+    [3, 12, 19, 30, 42, 59]
+    ```
+    
+    كما ترون، الأرقام في قائمتك الآن مصنفة من أدنى قيمة إلى أعلى قيمة. تهانينا!
+    
+    ربما نريد عكس هذا الترتيب؟ دعونا نفعل ذلك!
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> lottery.reverse()
+    >>> print(lottery)
+    [59, 42, 30, 19, 12, 3]
+    ```
+    
+    إذا كنت ترغب في إضافة شيء إلى القائمة الخاصة بك، يمكنك فعل ذلك عن طريق كتابة هذا الأمر:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> lottery.append(199)
+    >>> print(lottery)
+    [59, 42, 30, 19, 12, 3, 199]
+    ```
+    
+    إذا كنت ترغب في إظهار الرقم الأول فقط، يمكنك القيام بذلك باستخدام **indexes**. الفهرس هو الرقم الذي يقول أين يوجد عنصر في القائمة. المبرمجون يفضلون بدء العد عند 0، لذلك الكائن الأول في قائمتك هو في الفهرس 0، والعنصر التالي هو في 1، وما إلى ذلك. جرب هذا:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> print(lottery[0])
+    59
+    >>> print(lottery[1])
+    42
+    ```
+    
+    كما ترون، يمكنك الوصول إلى كائنات مختلفة في قائمتك باستخدام اسم القائمة وفهرس الكائن داخل الأقواس المعقوفة.
+    
+    لحذف شيء من القائمة الخاصة بك سوف تحتاج إلى استخدام **indexes** كما تعلمنا أعلاه وأسلوب `pop()`. دعونا نجرب مثالا ونعزز ما تعلمناه سابقا، سنقوم بحذف العدد الأول من قائمتنا.
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> print(lottery)
+    [59, 42, 30, 19, 12, 3, 199]
+    >>> print(lottery[0])
+    59
+    >>> lottery.pop(0)
+    59
+    >>> print(lottery)
+    [42, 30, 19, 12, 3, 199]
+    ```
+    
+    عمل هذا كالسحر !
+    
+    للمتعة الإضافية، حاول بعض الفهارس الأخرى: 6، 7، 1000، -1، -6 أو -1000. انظر إذا كان يمكنك التنبؤ بالنتيجة قبل محاولة الأمر. هل النتائج منطقية؟
+    
+    يمكن أن تجد قائمة بجميع أساليب القائمة المتوفرة في هذا الفصل من وثائق بايثون: https://docs.python.org/3/tutorial/datastructures.html
+    
+    ## القواميس
+    
+    > للقراء في المنزل: هذا الفصل تم التكلم عنه في [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+    
+    القاموس مماثل للقائمة، ولكن يمكنك الوصول إلى القيم عن طريق البحث عن مفتاح بدلا من فهرس رقمي. المفتاح يمكن أن يكون أي سلسلة أو عدد. بناء الجملة لتعريف القاموس الفارغ هو:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> {}
+    {}
+    ```
+    
+    هذا يدل على أنك قمت بإنشاء قاموس فارغ للتو. يآآاي!
+    
+    الآن، حاول كتابة الأمر التالي (حاول استبدال معلوماتك الخاصة أيضا):
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+    ```
+    
+    مع هذا الأمر، قمت للتو بإنشاء متغير يسمى `participant` مع ثلاثة أزواج من القيمة المفتاحية:
+    
+    - المفتاح `name` يشير إلى قيمة`'Ola'`(كائن `string`)،
+    - `country` يشير إلى `'Poland'` (`string` أخرى)،
+    - ويشير `favorite_numbers` إلى `[7، 42، 92]` (`list` بثلاثة أرقام).
+    
+    يمكنك التحقق من محتوى المفاتيح الفردية مع هذه الجملة:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> print(participant['name'])
+    Ola
+    ```
+    
+    انظر، إنها مشابهة للقائمة. لكنك لست بحاجة إلى تذكر الفهرس - مجرد الاسم.
+    
+    ماذا يحدث إذا طلبنا من بايثون قيمة مفتاح غير موجود؟ هل يمكنك التخمين؟ دعونا نحاول ونرى!
+    
+    {% filename %}{{ warning_icon }} command-line{% endfilename %}
+    
+    ```python
+    >>> participant['age']
+    Traceback (most recent call last):
+      File "<stdin>", line 1, in <module>
+    KeyError: 'age'
+    ```
+    
+    انضر، خطأ آخر! هذا **KeyError**. بايثون مفيد ويخبرك بأن مفتاح `'age'` غير موجود في هذا القاموس.
+    
+    متى يجب عليك استخدام القاموس أو القائمة؟ حسناً، هذه نقطة جيدة للتفكير. فكر في الإجابة قبل النظر إليها في السطر التالي.
+    
+    - هل تحتاج فقط إلى تسلسل أمر من العناصر؟ انتقل إلى القائمة.
+    - هل تحتاج إلى ربط القيم مع مفاتيح، حتى تتمكن من البحث عنها بكفاءة (عن طريق مفتاح) في وقت لاحق؟ إستخدم المعجم.
+    
+    القواميس، مثل القوائم، هي *mutable*، مما يعني أنه يمكن تغييرها بعد إنشائها. يمكنك إضافة أزواج مفتاح-قيمة جديدة إلى القاموس بعد إنشائه، مثل هذا:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> participant['favorite_language'] = 'Python'
+    ```
+    
+    مثل القوائم، باستخدام طريقة `len()` على القواميس ترجع عدد أزواج القيمة الرئيسية في القاموس. إمضي قدما واكتب هذا الأمر:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> len(participant)
+    4
+    ```
+    
+    آمل أن يكون الأمر منطقيا حتى الآن. :) مستعد لمزيد من المتعة مع القواميس؟ استمر بالقراءة من أجل بعض الأشياء المذهلة.
+    
+    يمكنك استخدام طريقة `pop()` لحذف عنصر في القاموس. لنفترض أنك تريد حذف المدخل المقابل للمفتاح `'favorite_numbers'`, ، اكتب فقط الأمر التالي:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> participant.pop('favorite_numbers')
+    [7, 42, 92]
+    >>> participant
+    {'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+    ```
+    
+    كما ترون من المخرج، تم حذف زوج مفتاح القيمة المقابلة لمفتاح 'favorite_numbers'.
+    
+    فضلا عن ذلك، يمكنك أيضا تغيير قيمة مرتبطة بمفتاح تم إنشاؤه مسبقاً في القاموس. اكتب هذا الأمر:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> participant['country'] = 'Germany'
+    >>> participant
+    {'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+    ```
+    
+    كما ترون، تم تغيير قيمة المفتاح `'country'` من `'Poland'` إلى `'Germany'`. :) مثير؟ مرحى! لقد تعلمت للتو شيء آخر مدهش.
+    
+    ### الملخص
+    
+    مدهش! أنت تعرف الكثير عن البرمجة الآن. لقد تعلمت في هذا الجزء الأخير حول:
+    
+    - **أخطاء** – يمكنك الآن معرفة كيفية قراءة وفهم الأخطاء التي تظهر إذا كان بايثون لم يفهم امر اعطيته له
+    - **المتغيرات** –أسماء الكائنات التي تسمح لك بتكويد أكثر سهولة وجعل التعليمات البرمجية الخاصة بك أكثر قابلية للقراءة
+    - **قوائم** – قوائم الكائنات المخزنة في ترتيب معين
+    - **قواميس** – الكائنات المخزنة كقيمة مفتاح-أزواج
+    
+    متحمس للجزء القادم؟ :)
+    
+    ## مقارنة الأشياء
+    
+    > للقراء في المنزل: هذا الفصل تم التكلم عنه في فيديو [Python Basics: Dictionaries](https://www.youtube.com/watch?v=7bzxqIKYgf4).
+    
+    جزء كبير من البرمجة ينطوي على مقارنة الأشياء. ما هو أسهل شيء للمقارنة؟ أرقام، بالطبع. دعونا نرى كيف يعمل:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> 5 > 2
+    True
+    >>> 3 < 1
+    False
+    >>> 5 > 2 * 2
+    True
+    >>> 1 == 1
+    True
+    >>> 5 != 2
+    True
+    >>> len([1, 2, 3]) > len([4, 5])
+    True
+    ```
+    
+    أعطينا بايثون بعض الأرقام للمقارنة. كما ترون، ليس فقط بايثون يمكن مقارنة الأرقام، ولكن يمكن أيضا مقارنة قيم التعبيرات الرياضية مثل `2 * 2` ونتائج الدالة مثل `2` التي تم إرجاعها بواسطة `len([4, 5]`. رائع، هاه؟
+    
+    هل تتساءل لماذا وضعنا اثنين من العلامات المتساوية `==` بجانب بعضها البعض للمقارنة إذا كانت الأرقام متساوية؟ نحن نستخدم `=` لتعيين القيم للمتغيرات. أنت دائما، **دائما** بحاجة إلى وضع اثنين منها - `==` - إذا كنت ترغب في التحقق مما إذا كانت الأشياء تساوي بعضها البعض. يمكننا أن نقول أيضا أن الأمور غير متساوية مع بعضها البعض. لذالك نستخدم هذه الرموز `!=` كما هو مبين في المثال أعلاه.
+    
+    أعطي بايثون مهمتان اخرتان:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> 6 >= 12 / 2
+    True
+    >>> 3 <= 2
+    False
+    ```
+    
+    لقد رأينا `>` و `<`، ولكن ماذا يعني `>=` و `<=` ؟ اقرأهم بهذه الطريقة:
+    
+    - `x_>` y يعني: x أكبر من y
+    - `x_<` y يعني: x أقل من y
+    - x `<=` y يعني: x أقل من أو يساوي y
+    - x `> =` يعني y: x أكبر من أو يساوي y
+    
+    رائع! تريد القيام بذالك مرة اخرى؟ جرب هذا:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> 6 > 2 and 2 < 3
+    True
+    >>> 3 > 2 and 2 < 1
+    False
+    >>> 3 > 2 or 2 < 1
+    True
+    ```
+    
+    يمكنك أن تعطي بايثون العديد من الأرقام للمقارنة كما تريد، وسوف يعطيك الجواب! ذكي جدا، أليس كذلك؟
+    
+    - **و**-إذا قمت باستخدام عامل التشغيل `and`، كل المقارنات يجب أن تكون صحيحة في النظام لكي يكون الأمر كله صحيح
+    - **أو** – إذا كنت تستخدم عامل التشغيل `or`، واحد فقط من المقارنات يجب أن يكون صحيحاً في النظام لكي يكون الأمر كله صحيح
+    
+    هل سمعت عبارة "مقارنة التفاح بالبرتقال"؟ دعونا نجرب ما يعادل هذه العبارة في بايثون:
+    
+    {% filename %}{{ warning_icon }} command-line{% endfilename %}
+    
+    ```python
+    >>> 1 > 'django'
+    Traceback (most recent call last):
+      File "<stdin>", line 1, in <module>
+    TypeError: '>' not supported between instances of 'int' and 'str'
+    ```
+    
+    هنا ترى أنه كما هو الحال في التعبير، بايثون غير قادر على مقارنة عدد (`int`) وسلسلة (`str`). بدلاً من ذلك، فإنه يظهر **TypeError** ويقول لنا لا يمكن مقارنة هذين النوعين معا.
+    
+    ## Boolean
+    
+    وبالمناسبة، لقد تعلمت للتو نوع جديد من الكائنات في بايثون. تسمى **Boolean**.
+    
+    هناك نوعين فقط من كائنات Boolean:
+    
+    - صحيح
+    - خطأ
+    
+    ولكن لكي يفهم بايثون هذا، تحتاج دائما إلى كتابته كـ 'صحيح' (الحرف الأول الكبير، مع بقية الأحرف السفلية). **true, TRUE,، وtRUE لن تنجح – الوحيدة التي ستنجح هي True.** (نفس الأمر ينطبق على 'False' كذلك، بطبيعة الحال.)
+    
+    Booleans يمكن أن تكون متغيرات، أيضا! انظر هنا:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> a = True
+    >>> a
+    True
+    ```
+    
+    يمكنك أيضا القيام بذلك بهذه الطريقة:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> a = 2 > 5
+    >>> a
+    False
+    ```
+    
+    تدرب واستمتع مع Booleans بمحاولة تشغيل الأوامر التالية:
+    
+    - `True and True`
+    - `False and True`
+    - `True or 1 == 1`
+    - `1 != 2`
+    
+    تهانينا! Booleans هي واحدة من أروع ميزات البرمجة، وقد تعلمت للتو كيفية استخدامها!
+    
+    # احفظه!
+    
+    > للقراء في المنزل: هذا الفصل تم التكلم عنه في فيديو [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk).
+    
+    حتى الآن كنا نكتب كل ما لدينا من تعليمات بايثون في المترجم، مما يحدنا من إدخال سطر واحد من التعليمات البرمجية في وقت واحد. يتم حفظ البرامج العادية في الملفات ويتم تنفيذها من قبل لغتنا البرمجية **interpreter** أو **compiler**. حتى الآن كنا نقوم بتشغيل برامجنا سطر واحد في كل مرة في بايثون **interpreter**. سنحتاج إلى أكثر من سطر واحد من التعليمات البرمجية للمهام القليلة التالية، لذلك سنحتاج بسرعة إلى:
+    
+    - قم بإنهاء مترجم بايثون
+    - فتح محرر التعليمات البرمجية لدينا الاختيار
+    - حفظ بعض التعليمات البرمجية في ملف بايثون جديد
+    - تشغيله!
+    
+    للخروج من مترجم بايثون الذي كنا نستخدمه، ببساطة اكتب دالة `exit()`
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    >>> exit()
+    $
+    ```
+    
+    هذا سيضعك مرة أخرى في موجه الأوامر.
+    
+    في وقت سابق، اخترنا محرر التعليمات البرمجية من قسم [code editor](../code_editor/README.md). سنحتاج إلى فتح المحرر الآن وكتابة بعض التعليمات البرمجية في ملف جديد (أو إذا كنت تستخدم كروم بوك، أنشئ ملف جديد في قاعدة البيانات السحابية وافتح الملف، الذي سيكون في محرر التعليمات البرمجية المضمنة):
+    
+    {% filename %}editor{% endfilename %}
+    
+    ```python
+    print('Hello, Django girls!')
+    ```
+    
+    من الواضح أنك مطور بايثون متقن الآن، لذا لا تتردد في كتابة بعض التعليمات البرمجية التي تعلمتها اليوم.
+    
+    الآن نحن بحاجة إلى حفظ الملف وإعطائه اسماً وصفياً. دعونا نسمي الملف **python_intro.py** وحفظه إلى سطح المكتب الخاص بك. يمكننا تسمية الملف أي شيء نريده، ولكن الجزء المهم هنا هو التأكد من انتهاء الملف ب **.py**. ويقول امتداد **.py** لنظام التشغيل أن هذا **Python executable file</0 وبايثون يمكن ان يشغله.</p> 
+    
+    > يجب أن تلاحظ واحدة من أروع شيء عن المحررين الأكواد: الألوان! في وحدة تحكم بايثون، كان كل شيء بنفس اللون. الآن يجب أن ترى أن الدالة `print` هي لون مختلف عن السلسلة. وهذا ما يسمى "syntax highlighting"، وهي ميزة مفيدة حقاً عند الترميز. سيعطيك لون الأشياء تلميحات مثل السلاسل غير المغلقة أو الأخطاء المطبعية في اسم الكلمة الرئيسية (مثل `def` في إحدى الدالات، والتي سنراها أدناه). وهذا أحد الأسباب التي تجعلنا نستخدم محرر تعليمات برمجية. :)
+    
+    مع حفظ الملف، حان الوقت لتشغيله! باستخدام المهارات التي تعلمتها في قسم سطر الأوامر، استخدم المحطة الطرفية إلى **change directories** إلى سطح المكتب.
+    
+    <!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+    
+    على نظام التشغيل ماك، سيبدو الأمر على هذا النحو:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        $ cd ~/Desktop
+        
+    
+    <!--endsec-->
+    
+    <!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+    
+    على لينوكس، سيكون مثل هذا:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        $ cd ~/Desktop
+        
+    
+    (تذكر أن كلمة "سطح المكتب" قد تترجم إلى لغتك المحلية.)
+    
+    <!--endsec-->
+    
+    <!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+    
+    في موجه أوامر Windows، فإنه سيكون مثل هذا:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        > cd %HomePath%\Desktop
+        
+    
+    <!--endsec-->
+    
+    <!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+    
+    وفي Windows Powershell، فإنه سيكون مثل هذا:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        > cd $Home\Desktop
+        
+    
+    <!--endsec-->
+    
+    إذا علقت، اطلب المساعدة. لهذا بالضبط يتواجد المدربون هنا!
+    
+    الآن استخدم بايثون لتنفيذ التعليمات البرمجية في ملف مثل هذا:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        $ python3 python_intro.py
+        Hello, Django girls!
+        
+    
+    ملاحظة: في ويندوز 'python3' غير معروف كأمر. بدلاً من ذلك، استخدم 'python' لتنفيذ الملف:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    > python python_intro.py
+    ```
+    
+    حسناً! لقد قمت بتشغيل برنامج بايثون الأول الخاص بك والذي تم حفظه في ملف. هذا احساس رائع؟
+    
+    يمكنك الآن الانتقال إلى أداة أساسية في البرمجة:
+    
+    ## If … elif … else
+    
+    يجب تنفيذ الكثير من الأشياء في التعليمات البرمجية فقط عند استيفاء شروط معينة. وهذا هو السبب في أن بايثون لديها ما يسمى **if statements**.
+    
+    استبدال التعليمات البرمجية في ملف **python_intro.py** بهذا:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    if 3 > 2:
+    ```
+    
+    إذا كان لنا أن نحفظ ونشغل هذا، كنا لنرى خطأ مثل هذا:
+    
+    {% filename %}{{ warning_icon }} command-line{% endfilename %}
+    
+        $ python3 python_intro.py
+        File "python_intro.py", line 2
+                 ^
+        SyntaxError: unexpected EOF while parsing
+        
+    
+    بايثون يتوقع منا إعطاءه مزيد من التعليمات ليتم تنفيذها إذا كان الشرط `3 > 2` يتحول إلى أن يكون صحيحاً (أو `True` لهذه المسألة). دعونا نحاول جعل بايثون يطبع "إنها تعمل!". استبدل التعليمات البرمجية في ملف **python_intro.py** بهذا:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    if 3 > 2:
+        print('It works!')
+    ```
+    
+    لاحظ كيف قمنا بفصل السطر التالي من التعليمات البرمجية ب 4 مسافات؟ نحن بحاجة إلى القيام بذلك حتى يعرف بايثون ما هي التعليمات البرمجية التي يجب عليه تشغيلها ، إذا كانت النتيجة صحيحة. يمكنك وضع مسافة واحدة لكن اغلب مبرمجي بايثون يستخدمون 4 مسافات ، لجعل الأمور اكثر اناقة. سيتم إحتساب ضغطة Tab واحدة كـ 4 مسافات أيضاً طالما تم تعيين محرر النصوص الخاص بك للقيام بذلك. عندما قمت باختيارك، لا تقم بتغييره! إذا وضعت فراغ بـ 4 مسافات، قم بوضع 4 مسافات لأي فراغ تعمله في المستقبل، أيضاً - عدا ذلك يمكن أن تواجه مشاكل.
+    
+    احفظه وقم بتشغيله مرة أخرى:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+    $ python3 python_intro.py
+    It works!
+    ```
+    
+    ملاحظة: تذكر أن 'python3' في Windows، لا يعتبر كأمر. من الآن فصاعدا، غير 'python3' ب 'python' لتشغيل الملف.
+    
+    ### ماذا إذا كان الشرط غير صحيح؟
+    
+    في الأمثلة السابقة، تم تنفيذ التعليمات البرمجية فقط عندما كانت الظروف صحيحة. ولكن بايثون تحتوى ايضا على `elif` و `else`:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    if 5 > 2:
+        print('5 is indeed greater than 2')
+    else:
+        print('5 is not greater than 2')
+    ```
+    
+    عند تشغيل هذا سيتم طباعة:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        $ python3 python_intro.py
+        5 is indeed greater than 2
+        
+    
+    إذا كان عدد 2 أكبر من 5، فسيتم تنفيذ الأمر الثاني. دعونا نرى كيف يعمل `elif`:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    name = 'Sonja'
+    if name == 'Ola':
+        print('Hey Ola!')
+    elif name == 'Sonja':
+        print('Hey Sonja!')
+    else:
+        print('Hey anonymous!')
+    ```
+    
+    وتنفذ:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        $ python3 python_intro.py
+        Hey Sonja!
+        
+    
+    اترى ما حدث هناك؟ `elif` يسمح لك بإضافة الشروط الإضافية التي يتم تشغيلها في حالة فشل الشروط السابقة.
+    
+    يمكنك إضافة العديد من بيانات `elif` كما تريد بعد العبارة الأولى `if` الخاص بك. على سبيل المثال:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    volume = 57
+    if volume < 20:
+        print("It's kinda quiet.")
+    elif 20 <= volume < 40:
+        print("It's nice for background music")
+    elif 40 <= volume < 60:
+        print("Perfect, I can hear all the details")
+    elif 60 <= volume < 80:
+        print("Nice for parties")
+    elif 80 <= volume < 100:
+        print("A bit loud!")
+    else:
+        print("My ears are hurting! :(")
+    ```
+    
+    بايثون يمر من خلال كل اختبار في التسلسل ويطبع:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        $ python3 python_intro.py
+        Perfect, I can hear all the details
+        
+    
+    ## التعليقات
+    
+    التعليقات هي سطور تبدأ ب `#`. يمكنك كتابة ما تريد بعد `#` وسيتجاهل بايثون ذلك. يمكن للتعليقات ان تجعل تعليماتك البرمجية سهلة ليفهمها الأخرين.
+    
+    دعونا نرى كيف يبدو ذلك:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    # Change the volume if it's too loud or too quiet
+    if volume < 20 or volume > 80:
+        volume = 50
+        print("That's better!")
+    ```
+    
+    لا تحتاج إلى كتابة تعليق لكل سطر من التعليمات البرمجية، لكنها مفيدة لشرح سبب عمل التعليمات البرمجية الخاصة بك لشيء ما، أو تقديم ملخص عندما تقوم بعمل شيء معقد.
+    
+    ### الملخص
+    
+    لقد تعلمت في التدريبات القليلة الماضية حول:
+    
+    - **مقارنة الأشياء** – في بايثون يمكنك مقارنة الأشياء باستخدام `>`، `> =`, `= =`، `< =`، `<` و `and` مشغلي `or`
+    - **Boolean** نوع من العناصر التي لا يمكن أن تحتوي إلا على قيمتين: `True` أو `False`
+    - **حفظ الملفات** – تخزين التعليمات البرمجية في ملفات حيث يمكنك تنفيذ برامج أكبر.
+    - **if … elif … else** – البيانات التي تسمح لك بتنفيذ التعليمات البرمجية فقط عند استيفاء شروط معينة.
+    - **التعليقات**-الأسطر التي لن تشغلها بايثون والتي تمكنك من توثيق التعليمات البرمجية الخاصة بك
+    
+    حان الوقت للجزء الأخير من هذا الفصل!
+    
+    ## الدالات الخاصة بك!
+    
+    > للقراء في المنزل: هذا الفصل تم التكلم عنه في فيديو [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0).
+    
+    تذكر الدوال مثل `len()` التي يمكنك تنفيذها في بايتون؟ حسنًا، أخبار جيدة - سوف تتعلم كيفية كتابة وظائفك الآن!
+    
+    الدالة هي سلسلة من التعليمات التي يجب على بايثون تنفيذها. تبدأ كل وظيفة في بايثون بالكلمة الرئيسية `def`، وتعطى اسما، ويمكن أن تحتوي على بعض المعلمات. لنحاول. استبدل التعليمة البرمجية في **python_intro.py** بما يلي:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    def hi():
+        print('Hi there!')
+        print('How are you?')
+    
+    hi()
+    ```
+    
+    حسنا، الدالة الأولى جاهزة!
+    
+    قد تتساءل لماذا قمنا بكتابة اسم الدالة في الجزء السفلي من الملف. عندما نكتب `def hi():` والخطوط المعبأة التالية ، هذا هو أننا نكتب تعليمات لما ينبغي أن تقوم به الدالة `H()`. بايثون سيقوم بقراءة وتذكر هذه التعليمات، ولكن لن يتم تشغيل الدالة بعد. لإخبار بايثون أننا نريد تشغيل الدالة، علينا أن نستدعي الدالة بواسطة `hi()`. بايثون يقرأ الملف وينفذه من الأعلى إلى الأسفل، لذا علينا أن نحدد الدالة في الملف قبل أن نسميها.
+    
+    لنختبر و نرى ماذا يحدث:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        $ python3 python_intro.py
+        Hi there!
+        How are you؟
+        
+    
+    ملاحظة: إذا كان لا يعمل، لا داعي للذعر! المخارج سوف تساعدك على معرفة السبب:
+    
+    - إذا حصلت على `NameError`، فهذا يعني أنك كتبت شيئا خاطئا، لذا يجب عليك التحقق من أنك استخدمت نفس الاسم عند إنشاء الدالة باستخدام `def hi():` وعند الاتصال به `hi()`.
+    - إذا حصلت على `IndentationError`، تحقق من أن كلا من خطوط <`print` لها نفس المسافة البيضاء في بداية السطر: بايثون يريد أن تكون كل شفرة داخل الدالة محاذية بدقة.
+    - إذا لم يكن هناك أي إخراج على الإطلاق، تحقق من أن آخر `hi()` *isn't* مسنن - إذا كان كذلك، فسيصبح هذا السطر جزءا من الوظيفة أيضا، ولن يتم تشغيله ابدا.
+    
+    دعونا نبني أول وظيفة لدينا مع المعلمات. سوف نغير المثال السابق - الدالة التي تقول "مرحبا" للشخص الذي يديرها - باسم:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    def hi(name):
+    ```
+    
+    كما ترون، أعطينا الآن وظيفتنا معلمة قمنا بتسميتها `name`:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    def hi(name):
+        if name == 'Ola':
+            print('Hi Ola!')
+        elif name == 'Sonja':
+            print('Hi Sonja!')
+        else:
+            print('Hi anonymous!')
+    
+    hi()
+    ```
+    
+    تذكر: الدالة `print` معبأة بأربعة مسافات داخل `if` . هذا لأن الدالة تعمل عند استيفاء الشرط. لنرى كيف تعمل الآن:
+    
+    {% filename %}{{ warning_icon }} command-line{% endfilename %}
+    
+        $ python3 python_intro.py
+        Traceback (most recent call last):
+        File "python_intro.py", line 10, in <module>
+          hi()
+        TypeError: hi() missing 1 required positional argument: 'name'
+        
+    
+    عفوا، خطأ. لحسن الحظ، بايثون يعطينا رسالة إعلام خطأ مفيدة جداً. يخبرنا أن الدالة `hi()` (التي حددنا) تحتوي على حجة واحدة مطلوبة (تسمى `name`) وأننا نسينا تمريرها عند إستدعاء الدالة. دعونا نصلحه في الجزء السفلي من الملف:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    hi("Ola")
+    ```
+    
+    وشغله مرة أخرى:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        $ python3 python_intro.py
+        Hi Ola!
+        
+    
+    وإذا قمنا بتغيير الاسم؟
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    hi("Sonja")
+    ```
+    
+    و قم بتشغيلها:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        $ python3 python_intro.py
+        Hi Sonja!
+        
+    
+    والآن، ما رأيك سوف يحدث إذا قمت بكتابة اسم آخر هناك؟ (لا Ola أو Sonja). جرب وانظر إذا كنت على حق. يجب طباعة هذا:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        Hi anonymous!
+        
+    
+    يبدو رائعا أليس كذالك؟ بهذه الطريقة لا يتوجب عليك أن تكرر نفسك في كل مرة تريد فيها تغيير اسم الشخص الذي يفترض أن تستقبله الدالة. وهذا هو بالضبط لماذا نحن بحاجة إلى وظائف--لا تريد ابدأ تكرار التعليمات البرمجية الخاصة بك!
+    
+    دعونا نفعل شيئا أذكى - هناك أسماء أكثر من اثنين، وكتابة شرط لكل واحد سيكون صعبا، أليس كذلك؟ استبدل محتوى الملف الخاص بك بما يلي:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    def hi(name):
+        print('Hi ' + name + '!')
+    
+    hi("Rachel")
+    ```
+    
+    دعونا نستدعي التعليمات البرمجية الآن:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        $ python3 python_intro.py
+        Hi Rachel!
+        
+    
+    تهانينا! لقد تعلمت للتو كيفية كتابة الوظائف! :)
+    
+    ## الحلقات
+    
+    > للقراء في المنزل: هذا الفصل تم التكلم عنه في فيديو [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0).
+    
+    هذا هو الجزء الأخير بالفعل. كان ذلك سريعا، أليس كذلك؟ :)
+    
+    المبرمجين لا يحبون تكرار أنفسهم. البرمجة هي جعل كل شيء يعمل أوتوماتيكيا، لذلك نحن لا نريد تحية كل شخص باسمه يدويا، أليس كذلك؟ هنا حيث تأتي الحلقات في متناول اليدين.
+    
+    لا تزال تذكر القوائم؟ دعونا ننشئ قائمة من الفتيات:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+    ```
+    
+    نحن نريد أن نحيي كل منهم باسمه. لدينا وظيفة `hi` للقيام بذلك، لذلك دعونا نستخدمها في حلقة:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    for name in girls:
+    ```
+    
+    يتصرف بيان `for` بنفس الطريقة التي يتصرف بها بيان `if` ؛ الرمز أدناه يجب أن يكون هناك أربعة مسافات.
+    
+    هنا التعليمات البرمجية الكاملة التي سوف تكون في الملف:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    def hi(name):
+        print('Hi ' + name + '!')
+    
+    girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+    for name in girls:
+        hi(name)
+        print('Next girl')
+    ```
+    
+    وعند تشغيله:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        $ python3 python_intro.py
+        Hi Rachel!
+        Next girl
+        Hi Monica!
+        Next girl
+        Hi Phoebe!
+        Next girl
+        Hi Ola!
+        Next girl
+        Hi You!
+        Next girl
+        
+    
+    كما ترون، سيتم تكرار كل ما تضعه داخل بيان `for` مع مسافة بادئة لكل عنصر من القائمة `girls`.
+    
+    يمكنك أيضا استخدام `for` على الأرقام باستخدام الدالة `range`:
+    
+    {% filename %}python_intro.py{% endfilename %}
+    
+    ```python
+    for i in range(1, 6):
+        print(i)
+    ```
+    
+    والتي ستطبع:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        1
+        2
+        3
+        4
+        5
+        
+    
+    `range` هي دالة تنشئ قائمة أرقام تتبع واحدة تلو الأخرى (هذه الأرقام مقدمة من قبل كمعلمات).
+    
+    لاحظ أن ثاني هذين الرقمين غير مدرجين في القائمة التي يتم إخراجها بواسطة بايثون (بمعنى `range(1, 6)` من 1 إلى 5، ولكن لا يشمل الرقم 6). وذلك لأن "range" نصف مفتوح، وهذا يعني أنه يشمل القيمة الأولى، ولكن ليس الأخيرة.
+    
+    ## الملخص
+    
+    هذا كل شيء. **You totally rock!** كان هذا فصل صعب، لذلك يجب أن تشعر بالفخر من نفسك. لما وصلت اليه حتى الأن!
+    
+    لدروس بايثون الرسمية والكاملة زر https://docs.python.org/3/tutorial/. هذا سوف يعطيك دراسة أكثر شمولا وكاملة للغة. في صحتك:)
+    
+    قد ترغب في القيام بشيء آخر لبعض الوقت - تمتد، تتجول قليلا، إراحة عينيك - قبل الذهاب إلى الفصل التالي. :)
+    
+    ![كب كيك](images/cupcake.png)
\ No newline at end of file
diff --git a/ar-SA/template_extending/README.md b/ar-SA/template_extending/README.md
new file mode 100644
index 00000000000..ae172cc4da1
--- /dev/null
+++ b/ar-SA/template_extending/README.md
@@ -0,0 +1,151 @@
+# تمديد القالب
+
+شيء جميل آخر يقدمه جانغو لك هو **تمديد القالب **. ماذا يعني هذا؟ هذا يعني أنه يمكنك استخدام الأجزاء نفسها من HTML لصفحات مختلفة من موقعك على الويب.
+
+القوالب تساعدك عندما تريد استخدام نفس الشكل او المعلومات اكثر من مرة او في اكثر من مكان. ليس عليك تكرار نفسك في كل ملف. وإذا كنت ترغب في تغيير شيء ما، ليس عليك تغيره في كل قالب, بل ستغيره في قالب واحد!
+
+## أنشئ القالب الرئيسي
+
+القالب الرئيسي هو قالب اساسي والذي ستقوم بتمديده اثناء استخدامه في اي صفحة من موقعك.
+
+لنقم بإنشاء ملف `base.html` في `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+بعد ذلك افتحه في محرر الأكواد وانسخ كل شي من `post_list.html` إلى ملف `base.html` ، هكذا:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+ثم في `base.html`، استبدل 1 (كل شيء بين 1 و `</body>`) مع هذا:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}قد تلاحض ان هذا قد غير `{% for post in posts %}` إلى `{% endfor %}` ب: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}{% endblock %}
+```
+
+لكن لماذا؟ لقد انشأت `كتلة`! استخدمت علامة القالب `{% block %}` لإنشاء منطقة التي ستضع فيها إتش تي أم ال HTML. ذاك HTML قادم من قالب اخر الذي قام بتمديد هذا القالب (`base.html`). نحن سنريك طريقة فعل ذالك خلال لحضات.
+
+والآن احفظ `base.html` وافتح ملفك `blog/templates/blog/post_list.html` مرة أخرى في محرر الأكواد {% raw %}ستحتاج لحدف كل شي فوق `{% for post in posts %}` وتحت `{% endfor %}`. عند الانتهاء من ذلك، الملف سيبدو هكذا:{% endraw %}
+
+{% filename %}blog/templates/blog/list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+نريد أن نستخدم هذه كجزء من قالبنا لجميع كتل المحتوى. حان الوقت لإضافة علامات الكتل لهذا الملف!
+
+{% raw %}You تريد لعلامة كتلتك ان تطابق العلامة في ملف `base.html`. تحتاج أيضا ان تشمل كافة التعليمات البرمجية التي تنتمي إليها في كتل المحتوى الخاص بك. للقيام بذلك، ضع كل شيء بين `{% block content %}` و `{% endblock %}`. مثل هذا: {% endraw %}
+
+{% filename %}blog/templates/blog/list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+بقي شيء واحد فقط. نحن بحاجة إلى ربط هذين القالبين معا. هذا ما نقصد به توسيع القوالب! سنفعل ذلك عن طريق إضافة علامة تمديد إلى بداية الملف. مثال:
+
+{% filename %}blog/templates/blog/list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+هذا كل شي! احفظ الملف ، وتحقق إذا كان موقعك الإلكتروني ما زال يعمل جيداً. :)
+
+> اذا حصلت على هذا الخطأ `TemplateDoesNotExist`، وهذا يعني انه ليس هناك ملف`blog/base.html` ولديك `runserver` يشتغل في الكونسول. حاول إيقافه (بالضغط على Ctrl+C - مفتاح التحكم و C معا) وإعادة تشغيله من خلال تشغيل أمر  python manage.py runserver </ 0>.</p>
+</blockquote>
\ No newline at end of file
diff --git a/ar-SA/whats_next/README.md b/ar-SA/whats_next/README.md
new file mode 100644
index 00000000000..bf4dfc8a2e6
--- /dev/null
+++ b/ar-SA/whats_next/README.md
@@ -0,0 +1,43 @@
+# ما هي الخطوة التالية؟
+
+هنئ نفسك ** أنت رائع تماما ** نحن فخورون بك! <3
+
+### ماذا يجب ان تفعل الأن؟
+
+خذ راحة واسترخِ! لقد قمت بشيء ضخم حقا.
+
+بعد ذلك، تأكد من اتباع Django Girls على [ الفيسبوك ](http://facebook.com/djangogirls) أو [ تويتر ](https://twitter.com/djangogirls) للبقاء مطلعا على كل الأحداث.
+
+### هل يمكنك التوصية بأي موارد إضافية؟
+
+نعم! وهناك *الكثير* من الموارد على الإنترنت لتعلم جميع أنواع مهارات البرمجة-- قد يكون شيئاً شاقاً فعلاً أن تعرف الى أين تذهب الآن، لكننا سنوفر لك كل شيء. مهما كانت اهتماماتك قبل أن تأتي إلى Django Girls، ومهما كانت الاهتمامات التي طورتها خلال المحتوى التعليمي، هذه بعض الموارد المجانية (أو الموارد مع مكونات مجانية كبيرة) يمكن أن تستخدمها للوصول إلى حيث تريد.
+
+#### جانغو
+
+- كتابنا الآخر، ["جانغو الفتيات التعليمي": ملحقات](https://tutorial-extensions.djangogirls.org/)
+- [المحتوى التعليمي الخاص بDjango](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [ابدأ مع دروس الفيديو لDjango](http://www.gettingstartedwithdjango.com/)
+- [جانغو لكل الإختصاصات](https://www.coursera.org/specializations/django) - يمكن تدقيق بعض دروس الفيديو مجاناً ويمكنك الحصول على شهادة من كورسيرا عن طريق أخذ هذه الدروس
+
+#### إتش تي أم ال، سي اس اس وجافا سكريبت
+
+- [دورة Codecademy في تطوير الويب](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### بايثون
+
+- [دورة Codecademy بالبايثون](https://www.codecademy.com/learn/learn-python)
+- [دورة جوجل بالبايثون](https://developers.google.com/edu/python/)
+- [كتاب "تعلم بايثون الطريقة الصعبة"](http://learnpythonthehardway.org/book/) –التدريبات الأولية مجانية
+- [دروس المبرمج الجديد](http://newcoder.io/tutorials/) – هذا مجموعة متنوعة من أمثلة عملية عن كيف يمكنك استخدام بايثون
+- [edX](https://www.edx.org/course?search_query=python) – يمكنك أخذ معظم الدورات مجاناً، لكن إذا كنت تريد شهادة أو تصديق نحو مؤهل تعليم عالي هذا سيكلف المال
+- [مجموعة كورسات بايثون على كورسيرا](https://www.coursera.org/specializations/python)--يمكن أن يكون حضور بعض محاضرات الفيديو مجاناً، ويمكنك الحصول على شهادة كورسيرا بأخذ هذه الدورات
+- [بايثون للجميع](https://www.py4e.com/)--نسخة مجانية ومفتوحة من مجموعة كورسات بايثون للجميع على كورسيرا
+
+#### التعامل مع البيانات
+
+- [كورس Codecademy في علم البيانات](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – يمكنك أخذ معظم الدورات مجاناً، لكن إذا كنت تريد شهادة أو تصديق نحو مؤهل تعليم عالي هذا سيكلف المال
+- [Dataquest](https://www.dataquest.io/)- أول ٣٠ مهمة مجانية
+
+لا يسعنا إنتظار ما ستفعل بعد!
\ No newline at end of file
diff --git a/ar/GLOSSARY.md b/ar/GLOSSARY.md
new file mode 100644
index 00000000000..5857b137396
--- /dev/null
+++ b/ar/GLOSSARY.md
@@ -0,0 +1,3 @@
+# محرر الكود
+
+محرر الكود هو التطبيق الذي يسمح لك بحفظ التعليمات البرمجية الخاصة بك بحيث تكون قادر على العودة إليها في وقت لاحق. ويمكنك معرفة أين يمكن الحصول على واحد من الفصل الخاص [بمحرر الكود](./code_editor/README.md)
\ No newline at end of file
diff --git a/ar/README.md b/ar/README.md
new file mode 100644
index 00000000000..7456fc51b15
--- /dev/null
+++ b/ar/README.md
@@ -0,0 +1,51 @@
+# دجانغو لتعليم الفتيات
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> تم ترخيص هذا العمل بموجب ترخيص المشاع الإبداعي Attribution-ShareAlike 4.0 الدولي.  لعرض نسخة من هذا الترخيص، تفضل بزيارة https://creativecommons.org/licenses/by-sa/4.0/
+
+## مرحبًا
+
+مرحبا بكم في البرنامج التعليمي فتيات جانغو! نحن سعداء لرؤيتك هنا :) في هذا البرنامج التعليمي، سوف نأخذك في رحلة في عمق وداخل تقنيات الويب، ونقدم لك لمحة عن كل القطع والقطع التي تحتاج تركيبها معا لجعل الويب يعمل هو الأن .
+
+كما هو الحال مع كل الأشياء غير المعروفة، هذا سيكون مغامرة ولكن لا تقلق، بما انك استخدمت شجاعتك للوصول الى هنا ، فستكون على ما يرام :)
+
+## المقدمة
+
+هل شعرت أن العالم يدور أكثر وأكثر حول التكنولوجيا التي لا يمكنك (حتى الآن) فهمها؟ هل تساءلت كيف يمكن إنشاء موقع على شبكة الإنترنت ولكن لم يكن لديك الدافع الكافي للبدء؟ هل فكرت يوما أن عالم البرمجيات معقد للغاية لدرجة انك لن تتمكن من حتى محاولة القيام بشيء بمفردك؟
+
+حسنا، لدينا أخبار جيدة لك! البرمجة ليست صعبة كما يبدو وإننا نريد أن نظهر لكم كيف يمكن أن يكون الموضوع مرح.
+
+هذا التدريب لن يحولك لمبرمج بطريقة سحرية. إذا كنت تريد أن تكون جيد في ذلك، أنت تحتاج إلى أشهر أو حتى سنوات من التعلم والممارسة. ولكن نحن نريد أن نظهر لك أن البرمجة أو إنشاء مواقع الكترونية ليس معقد كما يبدو. سوف نحاول في شرح مختلف الاجزاء، بكل وسعنا، حتى لا تشعر بالخوف تجاه التكنولوجيا.
+
+ونأمل أن نكون قادرين على أن نجعلكم تحبون التكنولوجيا بقدر ما نحبها نحن!
+
+## ماذا ستتعلم خلال هذه التدريبات؟
+
+بمجرد الانتهاء من البرنامج التعليمي، سيكون لديك تجربة، تطبيق ويب: مدونة خاصة بك. ونحن سوف نعلمك كيفية وضعه على الانترنت،حتى يرى الأخرون عملك!
+
+سوف تبدو (أكثر أو أقل) مثل هذا:
+
+![الرقم 0.1](images/application.png)
+
+> إذا كنت تعمل مع البرنامج التعليمي لوحدك وليس لديك مدرب الذي سوف يساعدك في حالة وجود أي مشكلة، لدينا نظام دردشة بالنسبة لك: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). لقد طلبنا من مدربينا والمتعلمين السابقين ان يحضرو لبعض الوقت ، لتقديم المساعدة للمتعلمين الجدد! لا تتردد في طرح سؤالك هنا!
+
+حسنا، [ لنبدأ من البداية... ](./how_the_internet_works/README.md)
+
+## إتبع البرنامج التعليمي في المنزل
+
+من المدهش أن تشارك في ورشة عمل جانغو للبنات، ولكن نحن ندرك أنه ليس من الممكن دائما الحضور لواحدة. هذا هو السبب في أننا نشجعكم على محاولة اتباع هذا البرنامج التعليمي في المنزل. للقراء في المنزل نحن حاليا نعد أشرطة فيديو التي من شأنها أن تجعل من آلسهل متابعة البرنامج التعليمي لوحدك. نحن لا نزال نعمل على ذالك ، لكن سيكون هناك المزيد من التحديثات في قناة يوتيوب [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed).
+
+في كل فصل تم تغطيته، هناك ارتباط يشير إلى الفيديو الصحيح.
+
+## حول المساهمة
+
+هذا البرنامج التعليمي من طرف [DjangoGirls](https://djangogirls.org/). إذا قمت بالبحث عن أي أخطاء أو ترغب في تحديث البرنامج التعليمي يرجى [اتباع المبادئ التوجيهية للمساهمة](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## هل تريد أن تساعدنا على ترجمة البرنامج التعليمي للغات أخرى؟
+
+حاليا، يجري الاحتفاظ بالترجمات على منصة crowdin.com في:
+
+https://crowdin.com/project/django-girls-tutorial
+
+إذا لم تكن لغتك موجودة نرجو منك [مراسلتنا](https://github.com/DjangoGirls/tutorial/issues/new) لإضافتها.
\ No newline at end of file
diff --git a/ar/SUMMARY.md b/ar/SUMMARY.md
new file mode 100644
index 00000000000..a11c7b28fc3
--- /dev/null
+++ b/ar/SUMMARY.md
@@ -0,0 +1,27 @@
+# الملخص
+
+* [المقدمة](README.md)
+* [التثبيت](installation/README.md)
+* [التثبيت (كروم بوك)](chromebook_setup/README.md)
+* [كيف تعمل الإنترنت](how_the_internet_works/README.md)
+* [مقدمة لسطر الأوامر](intro_to_command_line/README.md)
+* [تركيب بايثون](python_installation/README.md)
+* [محرر الكود](code_editor/README.md)
+* [مقدمة إلى بايثون](python_introduction/README.md)
+* [ما هو جانغو؟](django/README.md)
+* [تركيب دجانغو](django_installation/README.md)
+* [مشروعك الأول في دجانغو!](django_start_project/README.md)
+* [نماذج دجانغو](django_models/README.md)
+* [دجانغو المشرف](django_admin/README.md)
+* [الإعداد!](deploy/README.md)
+* [روابط دجانغو](django_urls/README.md)
+* [وجهات نظر جانغو -وقت الإنشاء!](django_views/README.md)
+* [مقدمة إلى HTML](html/README.md)
+* [ORM جانغو (Querysets)](django_orm/README.md)
+* [البيانات الديناميكية في قوالب](dynamic_data_in_templates/README.md)
+* [قوالب دجانغو](django_templates/README.md)
+* [إجعله جميلا بإستخدام CSS](css/README.md)
+* [تمديد القالب](template_extending/README.md)
+* [توسيع التطبيق الخاص بك](extend_your_application/README.md)
+* [روابط دجانغو](django_forms/README.md)
+* [ما هي الخطوة التالية؟](whats_next/README.md)
\ No newline at end of file
diff --git a/ar/chromebook_setup/README.md b/ar/chromebook_setup/README.md
new file mode 100644
index 00000000000..e72101085fe
--- /dev/null
+++ b/ar/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# إعداد جهاز كروم بوك
+
+> **ملاحظة** اذا كنت قد مررت من هذه المرحلة من قبل ، لا تحتاج للقيام بذلك مرة أخرى--يمكنك تخطي هذه المرحلة والإنتقال إلى [مقدمة بايثون](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ar/chromebook_setup/instructions.md b/ar/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..c645cba496f
--- /dev/null
+++ b/ar/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+يمكنك [تخطي هذا القسم ](http://tutorial.djangogirls.org/en/installation/#install-python) إذا كنت لا تستخدم كروم بوك. إذا كنت كذالك، تجربة التثبيت الخاص بك سوف تكون مختلفة قليلاً. يمكنك تجاهل بقية إرشادات التثبيت.
+
+### Cloud 9
+
+Cloud 9 هو أداة توفر لك محرر للشفرة البرمجية والوصول إلى جهاز كمبيوتر يعمل على شبكة الإنترنت حيث يمكنك تثبيت، وكتابة، وتشغيل البرامج. خلال مدة البرنامج التعليمي، Cloud 9 سيكون بمثابة *الجهاز المحلي* الخاص بك. ستظل تشغل الأوامر في واجهة التيرمينال تماما مثل زملائك على أوس X، أوبونتو، أو ويندوز، ولكن سيتم توصيل التيرمينال بجهاز كمبيوتر قيد التشغيل في مكان آخر سينشئه لك Cloud 9.
+
+1. تثبيت 9 Cloud من [مخزن ويب الكروم ](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. اذهب إلى [c9.io](https://c9.io)
+3. سجل حساب
+4. انقر *إنشاء مساحة عمل جديدة*
+5. سمه *django-girls*
+6. حدد *Blank* (الثاني من اليمين في الصف السفلي مع الشعار البرتقالي)
+
+الآن سترى واجهة مع الشريط جانبي ونافذة رئيسية كبيرة مع بعض النصوص، ونافذة صغيرة في الجزء السفلي التي تبدو كالتالي:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+هذه المنطقة السفلية هي *الطرفية*، الخاصة بك التي ستحصل فيها علي Cloud 9 مستعدا بتوجيهاتك. يمكنك تغيير حجم هذه النافذة لجعلها أكبر قليلاً.
+
+### البيئة الافتراضية
+
+بيئة افتراضية (وتسمى أيضا فيرتوالينف) هو مثل مربع خاص يمكننا ملئه بأشياء مفيدة مثل اكواد البرمجة من اجل مشروع نعمل عليه. نستخدم البيئة الإفتراضية للحفاض على مجموعة من اكواد البرمجة من مشروع ما ، حتى لا تختلط مع مشاريع اخرى.
+
+في التيرمينال في الجزء السفلي من واجهة Cloud 9، قم بتشغيل ما يلي:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+اذا لم يعمل معك هذا، اسأل المدرب الخاص بك للحصول على بعض المساعدة.
+
+وبعد ذلك، قم بتشغيل:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(لاحظ أنه على السطر الأخير نستخدم تيلد تليها علامة متساوية:~=).
+
+### Github
+
+إنشاء حساب </a>Github.</p> 
+
+### بايثون في كل مكان
+
+يتضمن برنامج جانغو لتعليم الفتيات قسما حول ما يسمى النشر، وهي عملية أخذ الكود البرمجي الذي يشغل تطبيق الويب ونقلها إلى جهاز كمبيوتر يمكن الوصول إليه بشكل عام (يسمى الخادم) حتى يتمكن غيرك من للناس من أن يرو عملك.
+
+هذا الجزء غريب بعض الشيء عند تنفيذ البرنامج التعليمي على جهاز كروم بوك بما أننا نستخدم جهاز كمبيوتر موجود على الإنترنت (على سبيل المثال، جهاز كمبيوتر محمول). ومع ذلك، فإنه لا يزال مفيدا، كما يمكننا أن نفكر في Cloud 9 كمساحة عملنا أو جاري العمل او بايثون في كل مكان كمكان لإضهار اشيائنا كلما اصبحت افضل.
+
+وبالتالي، قم بالتسجيل لحساب "بيثون في أي مكان" جديد في [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ar/code_editor/README.md b/ar/code_editor/README.md
new file mode 100644
index 00000000000..100d22833c1
--- /dev/null
+++ b/ar/code_editor/README.md
@@ -0,0 +1,11 @@
+# محرر الكود
+
+> للقراء في المنزل: هذا الفصل تم التكلم عنه في [تثبيت بايثون & محرر التعليمات البرمجية](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+أنت على وشك كتابة أول سطر كود خاص بك، لذا حمل برنامج محرر الكود!
+
+> **ملاحضة**إذا كنت تستخدم كروم بوك تخطى هذا القسم وتابع الإرشادات الموجودة في [التركيب على كروم بوك](../chromebook_setup/README.md).
+> 
+> **ملاحظة** من الممكن أنك فعلت هذا بوقت سابق في فصل التثبيت، بأمكانك تخطي هذا إلى الفصل التالي!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ar/code_editor/instructions.md b/ar/code_editor/instructions.md
new file mode 100644
index 00000000000..7e6607883de
--- /dev/null
+++ b/ar/code_editor/instructions.md
@@ -0,0 +1,31 @@
+يوجد العديد من برامج التحرير لكن الخيار الاخير يعود للشخص. اغلب مبرمجي البايثون (Python) يستخدمون بيئات تطوير مدمجة (او IDEs) مثل PyCharm. كمبتدئ على الأرجح هذا الخيار أقل ملائمة؛ نحن نوصي ببرامج قوية على نفس المستوى، ولكن أبسط بكثير.
+
+اقتراحاتنا مدرجة بالاسفل، لكن لا تتردد أن تسأل المدرب عن برنامجه المفضل - سوف يكون من الأسهل الحصول على مساعدة منهم.
+
+## Gedit
+
+Gedit محرر مفتوح المصدر ومجاني ايضاً, وهو متاح لكافة أنظمة التشغيل.
+
+[يمكنك تحميل البرنامج هنا](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3 
+
+Sublime Text هو محرر شائع جدا مع فترة مجانية للتقييم. سهل التركيب والاستخدام ومتاح لجميع أنظمة التشغيل.
+
+[يمكنك تحميل البرنامج هنا](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom محرر برمجة جديد للغاية تم إنشاؤه بواسطة [GitHub](https://github.com/). هو حر ومفتوح المصدر، وسهل التركيب والاستخدام. متاح لويندوز وماك و لينكس.
+
+[يمكنك تحميل البرنامج هنا](https://atom.io/)
+
+## لماذا نثبت محرر تعليمات البرمجة؟
+
+كنت قد تتسائل لماذا يتم تثبيت برنامج تحريرالنصوص البرمجية بدلاً من استخدام Word أو المفكرة.
+
+السبب الأول هو أن نص البرمجة يجب أن يكون ** نص عادي**، والمشكلة مع برامج مثل Word و Textedit (المفكرة) أنها لا تنتج في الواقع نص عادي، وأنها تنتج نص منسق (مع الخطوط والتنسيقات)، باستخدام تنسيقات مخصصة مثل تنسيق النص الغني [RTF - Rich Text Format](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+والسبب الثاني هو أن محررات البرمجة مخصصة لتحرير النصوص البرمجية، حيث يمكن أن توفر الميزات المفيدة مثل تسليط الضوء على النصوص البرمجية مع اللون لتناسب معناها، أو إغلاق علامات الاقتباس تلقائياً لك.
+
+سنرى كل ذلك في وقت لاحق. قريبا، ستبدأ بالتفكير في ان محرر تعليمات البرمجة القديم الذي اخترته كواحد من افضل الأدوات لديك. :)
\ No newline at end of file
diff --git a/ar/css/README.md b/ar/css/README.md
new file mode 100644
index 00000000000..63916c7c6b7
--- /dev/null
+++ b/ar/css/README.md
@@ -0,0 +1,303 @@
+# إجعله جميلا بإستخدام CSS!
+
+مدونتنا لا تزال تبدو قبيحة جداً، أليس كذلك؟ حان الوقت لجعلها جميلة! سوف نجعلها جميلة بإستخدام CSS.
+
+## ما هي تقنية CSS؟
+
+CSS هي لغة تجميل المواقع, تخيل HTML هي هيكل المنزل يعني الحائط و السارية و السقف و CSS هي الصباغة و الصقل والديكور... و ما إلى ذلك , يعني مثل المكياج 
+
+لكننا لا نريد أن نبدأ من الصفر مرة أخرى، أليس كذلك؟ مرة أخرى، سنستخدم شيئا خلقه المبرمجون على الإنترنت مجانا. إعادة اختراع العجلة ليس ممتعا، كما تعلمون.
+
+## لنستخدم Bootstrap!
+
+Bootstrap اطار عمل الأكثر شعبية لـ HTML و CSS لتطوير مواقع جميلة: https://getbootstrap.com/
+
+كتب بواسطة المبرمجين الذين عملوا على تويتر والآن يتم تطويره من قبل المتطوعين من جميع أنحاء العالم!
+
+## تثبيت Bootstrap
+
+لتثبيت بوتستراب، يجب إضافة هذا إلى `<head>` في ملف `.html </ 1>:</p>
+
+<p>{% filename %}blog/templates/blog/post_list.html{% endfilename %}</p>
+
+<pre><code class="html"><link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+`</pre> 
+
+هذا لا يضيف أي ملفات إلى المشروع الخاص بك. بل يشير فقط إلى الملفات الموجودة على شبكة الإنترنت. افتح موقع الويب الخاص بك وقم بتحديث الصفحة. لاحظت الفرق!
+
+![الرقم 14.1](images/bootstrap1.png)
+
+يبدو اجمل الان!
+
+## الملفات الثابتة في Django
+
+اخيراً سوف نمعن بالنظر على ما اسميناه **بالملفات الثابتة**. الملفات الثابتة هي كل CSS والصور. محتواهم لا يعتمد على خاصية الطلب وسيكون مشابها عند الجميع.
+
+### اين توضع الملفات الثابتة لمشروع Django
+
+جانغو عرف مسبقا أين يجد الملفات الثابتة للتطبيق المضمن المدير "admin". الأن لايلزمنا سوى اضافة بعض الملفات الثابتة للتطبيق الخاص بنا,`blog`.
+
+نقوم بذلك بانشاء مجلد نسميه `static` داخل تطبيق المدونة:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+جانغو سيجد تلقائيا أي مجلد باسم "static" داخل اي مجلد يحتويه تطبيقك. وسيستطيع استعمال محتوياته كملفات ثابتة.
+
+## الأن مع ملفات CSS
+
+لنقم بانشاء ملف نمطي CSS. لتظيف تعديلاتك الخاصة لموقعك. قم بانشاء مجلد باسم `css` داخل مجلد `static`. قم بانشاء ملف باسم `blog.css` داخل المجلد `css`. مستعد ؟
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+حان الوقت للقيام بكتابة بعض CSS,قم بفتح الملف `blog/static/css/blog.css` داخل المحرر.
+
+لن نذهب عميقاً في تخصيص وتعلم CSS هنا. هناك توصية بدورة CSS مجانية في نهاية هذه الصفحة إذا كنت ترغب في معرفة المزيد.
+
+لكن لنقم بالقليل على الاقل. ربما نريد تغيير لون الترويسة؟ لفهم الالوان, الحاسوب يستعمل شيفرات خاصة. الشيفرات تبتدأ ب `#` و تليها 6 حروف (A-F) و أرقام (0-9). مثلا ، رمز اللون الأزرق هو `#0000FF`. يمكنك العثور على هذه الشيفرات في هذا الموقع: http://www.colorpicker.com/. يمكنك استعمال الالوان المحددة مسبقا ك `red` و `green`.
+
+داخل الملف `blog/static/css/blog.css` يجب عليك اضافة التعليمات البرمجية التالية:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` هو محدد CSS. وهذا يعني أننا تقوم بتطبيقالأنماط لدينا لأي ` عنصر داخل عنصر <code>h1`</code>. حتى عندما يكون لدينا شيء مثل `<h1><a href="">link</a></h1>`، `h1` سيتم تطبيق النمط. في هذه الحالة نأمرها بتغيير الون الى `#FCA205`,وهو اللون البرتقالي. بالطبع تستطيع وضع أي لون تريد!
+
+داخل ملف CSS نحدد أنماط العناصر التي توجد داخل ملف HTML. الطريقة الأولى التي نستخدمها لتحديد العناصر هي عبر الإسم. يمكن أن تذكر هذه tags من قسم HTML. أشياء مثل`a`, `h1` و `body` هي كلها امثلة لأسماء العناصر. نحن نحدد العناصر ايضا عبر `class` او عبر `id`. Class و id هي الأسماء التي يمكنك إعطائها للعنصر بنفسك. تحدد class مجموعات من العناصر، و id تشير إلى عناصر محددة. على سبيل المثال، يمكن تحديد tag التالية باستخدام سمة `a`, المصنف `external_link` (class), أو المعرف `link_to_wiki_page` (id):
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+اقرأ عن [محددات CSS في w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+نحن بحاجة إلى أن نقول أيضا لقالب HTML أننا أضفنا بعض ال CSS. افتح الملف `blog/templates/blog/post_list.html` وأضف هذا السطر في البداية:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+نحن فقط نحمل الملفات الثابتة هنا ما بين علامات `<head>` و `</head>` بعد الارتباطات بملفات بوتستراب CSS ، قم بإضافة هذا السطر:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+المتصفح يقرأ الأوامر بالترتيب الذي اعطي له ، لذا يجب علينا التأكد من ان هذا في المكان الصحيح. وإلا فإن الكود في الملف الخاص بك قد يتم تجاوزه بواسطة الكود في ملفات بوتستراب. قمنا لتونا بإعلام القالب أين توجد ملفات التنسيق CSS.
+
+الآن يجب أن يبدو الملف الخاص بك مثل هذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+حسنا، قم بحفظ الملف وقم بتحديث الموقع!
+
+![الرقم 14.2](images/color2.png)
+
+عمل جيد! ربما نود أيضا إعطاء موقعنا متنفس وزيادة الهامش على الجانب الأيسر؟ دعونا نحاول هذا!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+قم بإضافة التعديل أعلاه لملف التنسيق CSS, احفض الملف و أنظر النتيجة!
+
+![الرقم 14.3](images/margin2.png)
+
+ربما يمكننا تخصيص الخط في عنوان الصفحة لدينا؟ ألصق هذا `< header >` في ملف `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+كما من قبل، تحقق من الأمر والمكان قبل الارتباط بـ `blog/static/css/blog.css`. هذا السطر سيطلب خط يسمى *Lobster* من "خطوط جوجل " (https://www.google.com/fonts).
+
+أعثر على `h1` إعلان كتلة (التعليمات البرمجية بين الأقواس `{` `}`) في ملف CSS `blog/static/css/blog.css`. الآن قم بإضافة السطر `font-family: 'Lobster';` بين أقواس، وحدث الصفحة:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![الرقم 14.3](images/font.png)
+
+عظيم!
+
+كما ذكر أعلاه، CSS لديها مفهوم طبقات. هذه تسمح لك بتسمية جزء من التعليمات البرمجية ل HTML وتطبيق الأنماط فقط لهذا الجزء، دون التأثير على الأجزاء الأخرى. هذا يمكن ان يكون مفيد جدا! ربما يكون لديك اثنين من divs اللذان يقومان بشيء مختلف (مثل الهيدر او الموضوع الخاص بك). الكلآس يمكن اي يساعدك في جعلها تبدو مختلفة.
+
+أمضي قدما وقم بتسمية بعض أجزاء من التعليمات البرمجية ل HTML. إضافة فئة تدعي `page-header` إلى `div` الذي يحتوي الهيدر الخاص بك ، مثل هذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+الان أضف Class `post` إلى `div` الذي يحتوي مقالات المدونة.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+سنقوم الآن بإضافة كتل إعلان لمحددات مختلفة. المحددات التي تبدأ ب `.` تتعلق بالفصول. هناك العديد من الدروس والشروحات التي تتكلم عن CSS في الأنترنت والتي يمكنها مساعدتك على فهم الأكواد التالية. الآن، فقط قم بنسخ ولصق في ملف `blog/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+تم قم بإحاطة تعليمات HTML التي تظهر المقالات:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+في `blog/templates/blog/post_list.html` بهذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+إحفظ الملفات الأن، وقم بتحديث موقع الويب الخاص بك.
+
+![الرقم 14.4](images/final.png)
+
+وووهووو! يبدو رائعا أليس كذالك؟ انظر إلى التعليمات البرمجية التي ألصقناها للتو للعثور على الأماكن التي أضفنا فيها كلاسات في HTML واستخدمناها في CSS. أين يمكن عمل تعديل ان اردت للوقت ان يكون turquoise؟
+
+لا تخافوا من العبث مع هذه CSS قليلا ومحاولة تغيير بعض الأشياء. اللعب ب CSS يمكن أن يساعدك على فهم ما تقوم به الأشياء المختلفة. إذا كسرت شيء لا تقلق يمكنك اصلاحه دائما!
+
+نحن ننصحك بأخد هذه الحصة التعليمية المجانية [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). يمكن أن تساعدك على تعلم كل شيء عن جعل مواقع الويب الخاصة بك أجمل مع CSS.
+
+جاهز للفصل التالي؟! :)
\ No newline at end of file
diff --git a/ar/deploy/README.md b/ar/deploy/README.md
new file mode 100644
index 00000000000..5b823135332
--- /dev/null
+++ b/ar/deploy/README.md
@@ -0,0 +1,227 @@
+# الإعداد!
+
+> **ملاحظه** الفصل التالي قد يكون في بعض الأحيان صعبا. استمر و أعزم على الانتهاء منه؛ الإعداد جزء هام من عملية تطوير موقع شبكة الإنترنت. ويوضع هذا الفصل في منتصف البرنامج التعليمي حتى يمكن لمدربك أن يساعدك في العمليات الأصعب قليلاً لنشر موقع الويب الخاص بك على الإنترنت. وهذا يعني أنه لا يزال يمكنك الانتهاء من البرنامج التعليمي الخاص بك بمفردك إذا نفذ الوقت منك.
+
+حتى الأن موقعك كان متاحا فقط على حاسوبك. الأن سوف تتعلم كيف تنشره! الإعداد هو عملية نشر التطبيق الخاص بك على شبكة الإنترنت حيث يمكن للناس الذهاب إلى التطبيق الخاص بك و مشاهدته. :)
+
+كما تعلمت، موقع على شبكة الإنترنت يجب أن يتواجد في خادم. هناك الكثير من مقدمي الخدمة متاحين على شبكة الإنترنت، ونحن سنستخدم [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere متوفر مجانا للتطبيقات الصغيرة التي لا تحتوي على عدد كبير من الزائرين فالآن بالتأكيد ستكون كافية بالنسبة لك.
+
+الخدمات الخارجية الأخرى ستقوم باستخدام [GitHub](https://www.github.com)، وهي خدمة استضافة التعليمات البرمجية. هناك آخرون ، ولكن تقريبا جميع المبرمجين لديهم حساب GitHub في هذه الأيام، والآن أنت سوف يمكنك أيضا الحصول على حساب!
+
+سوف تكون هذه الأماكن الثلاثة هامة بالنسبة لك. الكمبيوتر الخاص بك سوف يكون المكان حيث يمكنك القيام بالتطوير والإختبار. عندما تكون راضيا عن التغييرات، ستقوم بوضع نسخة من التعليمات البرمجية على GitHub. موقعك سيكون على بايثون في كل مكان ، وستقوم بتحديثه عبر استقدام نسخة جديدة من GitHub.
+
+# جيت (Git)
+
+> **ملاحظة** إذا كنت قمت بإجراء خطوات التثبيت سابقا، لا تحتاج للقيام بذلك مرة أخرى -يمكنك التخطي إلى الجزء التالي والبدء في إنشاء مستودع Git الخاص بك.
+
+{% include "/deploy/install_git.md" %}
+
+## ابتداء مستودعك في Git
+
+Git يتعقب التغييرات التي تحدث لمجموعة معينة من الملفات في ما يسمى بمستودع الكود (أو "الريبو" للاختصار). لنبدأ انشاء مستودع (ريبو) لمشروعنا. افتح وحدة التحكم الخاص بك ، وشغل هذه الأوامر في دليل `djangogirls`:
+
+> **ملاحظة** تحقق من دليل العمل الحالي الخاص بك مع `pwd` (Mac OS X/لينكس) أو `cd` (في Windows) قبل تهيئة المستودع. يجب أن تكون في المجلد `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+تهيئة المستودع هو شيء نحتاج القيام به مرة واحدة فقط لكل مشروع (ولن تضطر إلى إعادة إدخال اسم المستخدم والبريد الإلكتروني مرة أخرى).
+
+Git سوف يتعقب التغييرات لكافة الملفات والمجلدات الموجودة في هذا الدليل، ولكن هناك بعض الملفات التي نريد Git أن يتجاهلها. نحن نقوم بهذا عبر انشاء ملف يسمى `.gitignore` في الدليل الرئيسي. افتح المحرر الخاص بك وقم بإنشاء ملف جديد مع محتويات التالية:
+
+{% filename %}.gitignore{% endfilename %}
+
+    * .pyc * ~
+     __pycache__ 
+    myvenv db.sqlite3 / static .DS_Store
+    
+
+واحفظه ك `.gitignore` في مجلد "djangogirls".
+
+> **ملاحظة** النقطه في بداية اسم الملف مهمه! إذا كنت تواجه أي صعوبة في انشائه (على سبيل المثال ،أجهزة ماكينتوش لا تمكنك من إنشاء الملفات التي تبدأ بنقطة عن طريق الباحث)، إذا قم باستخدام ميزة "حفظ باسم" في المحرر الخاص بك.
+> 
+> **ملاحظة** أحد الملفات التي قمت بتحديدها في ملف `.gitignore` هي `db.sqlite3`. هذا الملف هو قاعدة البيانات المحلية الخاصة بك، حيث يتم تخزين جميع المشاركات الخاصة بك. لا نريد اضافة هذا الى المستودع الخاص بك ، لأن موقعك على بايثون في كل مكان سيكون يستخدم قاعدة بيانات مختلفة. قاعدة البيانات تلك يمكن ان تكون SQLite, مثل جهاز التطوير الخاص بك ، لكن في العادة ستستخدم واحدة تسمى MySQL, والتي يمكنها التعامل مع الكثير من الزوار اكثر من SQLite. وفي كلتا الحالتين، بتجاهل قاعدة بيانات SQLite للنسخة GitHub، يعني أن جميع المشاركات التي قمت بإنشائها حتى الآن ستبقى و تكون متاحة محلياً، ولكن سيكون عليك اضافتهم مرة اخرى للإنتاج. ينبغي أن تفكر في قاعدة البيانات المحلية الخاصة بك كملعب جيد حيث يمكنك اختبار أشياء مختلفة وولا تخف من فكرة انك ستحدف مشاركاتك الحقيقية من المدونة.
+
+انها فكرة جيدة استخدام الأمر `git status` قبل `git add` أو كلما وجدت نفسك غير متأكد من ما تغير. وهذا سيساعد على منع أي مفاجآت من الحدوث، مثل إضافة ملفات خاطئة. الأمر `git status` يرجع المعلومات عن اي ملف لم يتم اتباعه تعديله او تنظيمه, حالة الفرع، وأكثر من ذلك بكثير. يجب أن يكون المخرج مشابه لما يلي:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+وأخيرا نحفض التغييرات التي قمنا بها, اذهب الى لوحة التحكم الخاصة بك وشغل هذه الأوامر:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    ## Wypychanie kodu na GitHuba
+    
+    Przejdź na [GitHub.com](https://www.github.com) i załóż nowe, darmowe konto użytkonika. (إذا كنت قد سبق أن فعلت ذلك في ورشة العمل الإعدادية، هذا عظيم!) قم بإنشاء مستودع جديد، وإعطائه اسم "my-first-blog". اترك خانة "initialize with a README" دون اختيارها واترك الخيار.gitignore فارغ (لقد فعلنا ذلك يدوياً) وأترك الترخيص على أنه لا شيء.
+    
+    <img src="images/new_github_repo.png" /> > * * ملاحظة * * اسم 'my-first-blog' مهم – يمكن أن تختار شيئا آخر، لكن هذا سيأخد الكثير من الوقت في الإرشادات الموجودة أدناه، وسيكون عليك استبداله كل مرة. ربما من الأسهل الإبقاء على اسم 'بmy-first-blog'.
+    
+    في الشاشة التالية، سوف يظهر لك رابط استنساخ المستودع الخاص بك. اختر إصدار "HTTPS"، إنسخه ، وسوف نلصقه في التيرمينال قريبا: <img src="images/github_get_repo_url_screenshot.png" /> الآن نحن بحاجة إلى ربط المستودع على جهاز الكمبيوتر الخاص بك بالمستودع الموجود على GitHub.
+    
+    اكتب الأمر التالي في وحدة التحكم الخاصة بك (استبدل '<your-github-username>' مع اسم المستخدم الذي قمت بإدخاله عند إنشاء حساب GitHub الخاص بك، ولكن دون أقواس الزاوية):{% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />أدخل اسم المستخدم في GitHub الخاص بك وكلمة المرور، ويجب أن ترى شيئا من هذا القبيل:{% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': votre-nom Password for 'https://votre-nom@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    تعليماتك البرمجية موجودة الأن على GitHub. الذهاب والتحقق من ذلك!  ستجد أنها في نهاية الشركة – [Django] (https://github.com/django/django) وفي [دروس جانغو الفتيات] (https://github.com/DjangoGirls/tutorial)، والعديد من مشاريع البرمجيات الكبيرة مفتوحة المصدر الأخرى أيضا تستضيف التعليمات البرمجية الخاصة بهم في GitHub. :) # إنشاء مدونتنا على بايثون في كل مكان &gt; * * ملاحظة * * قد تم إنشاء حساب ببايثون في كل مكان في وقت سابق أثناء خطوات التثبيت – إذا كان الأمر كذلك، لا حاجة للقيام بذلك مرة أخرى.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## سحب التعليمات البرمجية لدينا من بايثون في كل مكان
+    
+    عندما تسجل في بايثون في كل مكان سوف يتم اخدك للوحة التحكم. اختر هذا الخيار لتشغيل وحدة تحكم "Bash" – والذي هو اصدار من بايثون في كل مكان للوحة التحكم، تماما مثل الموجود على حاسوبك.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt; &gt; * * ملاحظة * * "بايثون في كل مكان " يستند على لينكس، حتى إذا كنت على ويندوز، وحدة التحكم سوف تبدو مختلفة قليلاً من التي تتواجد على حاسوبك الخاص.
+    
+    دعونا نسحب تعليماتنا البرمجية من GitHub وعلى بايثون في كل مكان عن طريق إنشاء "استنساخ" لمستودعنا. اكتب الأمر التالي في وحدة التحكم على بايثون في كل مكان (لا تنسى أن استخدام اسم المستخدم الخاص بك في GitHub بدلاً من `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />هذا سيستنسخ نسخة من تعليماتك البرمجية في بايثون في كل مكان ، يمكنك تفقد ذالك عبر كتابة `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### إنشاء بيئة افتراضية على بايثون في كل مكان
+    فقط كما فعلت على حاسوبك ، يمكنك انشاء بيئة افتراضية على بايثون في كل مكان. في نافذة وحدة التحكم، اكتب
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; * * ملاحظة * * الخطوة 'pip install' يمكن أن تستغرق بضع دقائق.  الصبر والصبر!  ولكن إذا إستغرق الأمر أكثر من خمس دقائق، هناك خطأ ما.  اسأل المدرب الخاص بك.
+    
+    &lt;!-TODO: التفكير في استخدام requirements.txt بدلاً من pip install.--&gt; # # # إنشاء قاعدة بيانات بايثون في كل مكان
+     هنا شيء آخر مختلف بين الكمبيوتر الخاص بك والخادم: إنه يستخدم قاعدة بيانات مختلفة. حيث يمكن أن تكون حسابات المستخدم ومشاركاته مختلفة على الملقم وعلى الكمبيوتر الخاص بك.
+    
+    تماما كما فعلنا على جهاز الكمبيوتر الخاص بك، نحن سنكرر الخطوة لتهيئة قاعدة البيانات على الملقم، عبر `migrate` و `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br /># # نشر مدونتنا كتطبيق ويب
+    
+     الآن التعليمات البرمجية الخاصة بنا في PythonAnywhere,، وبيئتنا الإفتراضية على استعداد، وقاعدة البيانات مهيئة. نحن مستعدون لنشره كتطبيق ويب!
+    
+    انقر فوق العودة إلى لوحة معلومات PythonAnywhere عن طريق النقر على الشعار ومن ثم انقر فوق **Web**. وأخيراً، إضغط ***Add a new web app**.
+    
+    بعد التأكد من اسم النطاق الخاص بك، اختر ***manual configuration** (ملحوظة:-*not* الخيار "Django") في مربع الحوار. بعد اختيار **Python 3.6**، انقر فوق التالي لإنهاء المعالج.
+    
+    &gt; * *ملاحظة* * "تأكد من" اختيار الخيار "Manual configuration"، وليس "Django". نحن نحب جداً الإعداد الافتراضي لدجانغو بايثون في كل مكان. ;-)
+    ### تعيين البيئة الافتراضية
+    
+    سيتم نقلك لصفحة تعديل بايثون في كل مكان لتطبيقك ، والذي يمكنك من الذهاب لأي مكان والقيام بالتعديلا لتطبيقك على السيرفر.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+     في المقطع "Virtualenv"، انقر فوق النص الأحمر الذي يقول "Enter the path to a virtualenv"، وأدخل `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. انقر فوق المربع الأزرق مع علامة اختيار لحفظ المسار قبل الانتقال.
+    
+    &gt; * *ملاحظة* * استبدال اسم المستخدم الخاص بك PythonAnywhere حسب الحاجة. إذا قمت بخطأ، PythonAnywhere سوف تظهر لك تحذير.
+    
+    
+    # # # تكوين الملف WSGI
+    
+     جانغو يعمل باستخدام "بروتوكول WSGI"، معياراً لخدمة مواقع الويب باستخدام بيثون، الذي يدعم بايثون في كل مكان. الطريقة التي يمكننا تتعديل PythonAnywhere بها للإعتراف بمدونتنا جانغو عن طريق تحرير ملف تعديل WSGI.
+    
+    انقر فوق "ملف التكوين WSGI" (في المقطع "تعليمات برمجية" بالقرب من أعلى الصفحة – فإنه سوف يكون المسمى شيئا مثل '/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py')، وسوف يتم نقلك إلى المحرر.
+    
+    حدف كافة المحتويات وتغييرها ب
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+عمل الملف هو اخبار بايثون في كل مكان اين يكون تطبيق الويب الخاص بنا ، وما هو اسم ملف اعدادات دجانغو.
+
+`StaticFilesHandler` هو للتعامل مع CSS. هذا سيهتم بك تلقائيا اثناء التطوير المحلي بواسطة الأمر `runserver`. سنعرف المزيد عن الملفات الثابتة لاحقا في البرنامج التعليمي، عندما نقوم بتحرير CSS لموقعنا.
+
+إضغط **Save** وثم العودة إلى علامة التبويب **Web**.
+
+لقد انتهينا جميعا! اضغط على الزر الأخضر الكبير **Reload** وستتمكن من عرض تطبيقك. ستجد رابطا إليه أعلى الصفحة.
+
+## نصائح لتصحيح الأخطاء
+
+إذا ضهرت لك اي اخطاء عندما تزور موقعك ، المكان الأول الذي يجب ان تبحث فيه عن معلومات الخطأ لتصحيحه هو **error log**. ستجد رابط لهذا في بايثون في كل مكان [علامة التبويب](https://www.pythonanywhere.com/web_app_setup/). انضر ان كان هناك اي رسائل اخطاء ، الأحدث ستجدهم في الأسفل. وتشمل المشاكل الشائعة:
+
+- نسيان واحدة من الخطوات التي قمنا بها في وحدة التحكم: إنشاء بيئة افتراضية، وتفعيلها، تثبيت جانغو فيها ، ونقل قاعدة بيانات.
+
+- القيام بخطأ في البيئة الإفتراضية في علامة التبويب ويب – ستكون هناك عادة ما رسالة خطأ حمراء قليلاً هناك، إذا كان هناك مشكلة.
+
+- خطأ في ملف التكوين WSGI-هل حصلت على مسار مجلد my-first-blog folder الصحيح؟
+
+- هل اخترت نفس نسخة بايثون لبيئتك الإفتراضية ، كما فعلت لتطبيق الويب الخاص بك؟ ينبغي أن يكون 3.6.
+
+وهناك أيضا بعض [النصائح العامة لتصحيح الأخطاء على ويكي PythonAnywhere](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+وتذكر أن المدرب هنا للمساعدة!
+
+# أنت على الهواء الأن!
+
+الصفحة الرئيسية لموقعك يجب ان تقول "لقد عمل" تماما كما تقول على حاسوبك الخاص. حاول إضافة `/admin/` إلى نهاية عنوان URL، وسوف يتم نقلك إلى موقع المشرف. سجل الدخول باستخدام اسم المستخدم وكلمة المرور، وسترى انه يمكنك إضافة منشورات جديدة على الملقم.
+
+وبمجرد الانتهاء من إنشاء عدد قليل من المنشورات، يمكنك العودة إلى الإعدادات المحلية الخاصه بك (ليس بيثون في كل مكان). من هنا يجب أن تعمل على الإعدادات المحليه لإجراء التغييرات. هذا هو سير العمل المشترك في تطوير الإنترنت ـ إجراء تغييرات محليا، ودفع تلك التغييرات إلى GitHub، وسحب التغييرات الخاصة بك وصولا إلى خادم الويب الحي. هذا يسمح لك بالعمل والتجربة دون تحطيم موقع الويب الخاص بك. رائع! اليس كذالك؟
+
+إعطي نفسك تربيت *كبير* على الظهر! النشر علي الملقم هو واحد من أصعب أجزاءتطوير الشبكة، وغالبا ما يستغرق الناس عدة أيام قبل أن يجعلوه يعمل. لكنك قد وضعت موقعك على الهواء ، بهذا النحو!
\ No newline at end of file
diff --git a/ar/deploy/install_git.md b/ar/deploy/install_git.md
new file mode 100644
index 00000000000..390a900f486
--- /dev/null
+++ b/ar/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git عباره عن "نظام تحكم إصدار" مستخدم من قبل الكثير من المبرمجين. هذا النظام يمكنه تعقب التغييرات في الملفات مع مرور الوقت حتى أنه يمكنك استرجاع إصدارات محددة في وقت لاحق. يشبع قليلاً ميزة "تعقب التغييرات" في Microsoft Word، لكن أقوى بكثير.
+
+## تثبيت Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+يمكنك تحميل Git من [ git-scm.com](https://git-scm.com/). يمكنك الضغط على "التالي" في جميع الخطوات باستثناء خطوة واحدة؛ في الخطوة الخامسة بعنوان "التكيف مع بيئة المسار الخاص بك"، اختر "تشغيل Git وأدوات يونيكس المرتبطة بها من سطر الأوامر في ويندوز" (الخيار الأسفل). بخلاف ذلك، الإعدادات الافتراضية كافيه. راجع نهايات السطور في نمط ويندوز ، و ارتكاب نمط يونكس.
+
+لا تنس إعادة تشغيل موجه الأوامر أو powershell بعد انتهاء عملية التثبيت بنجاح. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+تحميل Git من [.git-scm.com](https://git-scm.com/) واتبع التعليمات.
+
+> **ملاحضة** إذا كنت تستخدم نضام ماك بهذه الإصدارات OS X 10.6, 10.7, or 10.8, يجب عليك تنصيب نسخة جيت من هذا الرابط [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ar/deploy/signup_pythonanywhere.md b/ar/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..86fb69565a3
--- /dev/null
+++ b/ar/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+التالي،حان الوقت للتسجيل للحصول على حساب مجاني "مبتدئ" في PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **ملاحظة** عند اختيار اسم المستخدم الخاص بك هنا، ضع في اعتبارك أن الموقع (URL) الخاص بك سوف يتخذ شكل `yourusername.pythonanywhere.com`،إذا أما أن تختار الاسم المستعار الخاص بك، أو اسم يليق بالموقع الخاص بك.
\ No newline at end of file
diff --git a/ar/django/README.md b/ar/django/README.md
new file mode 100644
index 00000000000..5e2d4539b63
--- /dev/null
+++ b/ar/django/README.md
@@ -0,0 +1,27 @@
+# ما هو جانغو؟
+
+جانغو (/ˈdʒæŋɡoʊ/*جانغ-جوه*) إطار تطبيق ويب حر ومفتوح المصدر مكتوب بلغة بايثون. أطار العمل مكون من مجموعه من المكونات التى سوف تساعدك على تطوير المواقع بطريقة اسهل واسرع.
+
+عندما تقوم ببناء موقع على شبكة الإنترنت، تحتاج دائماً مجموعة مماثلة من المكونات: طريقة للتعامل مع مصادقة المستخدم (التسجيل، الدخول، والخروج)، وصفحة إدارية لموقع الويب الخاص بك، والاستمارات، وطريقة لتحميل الملفات، إلخ.
+
+لحسن الحظ لاحظ أشخاص آخرين منذ وقت طويل أن مطوري الويب تواجههم مشاكل مماثلة عند إنشاء موقع جديد، فتعاونوا في إنشاء أطارات عمل (جانغو واحد منهم) التي تعطيك مكونات جاهزة يمكنك استخدامها.
+
+اطارات العمل موجودة لتنقدكم من إعادة اختراع ما تم اختراعه من قبل، وتساعد في تخفيف بعض النفقات العامة عندما تقوم ببناء موقع جديد.
+
+## لماذا تحتاج إلى إطار عمل؟
+
+لفهم ما هو جانغو في الواقع ، علينا أن نلقي نظرة فاحصة على الملقمات. أول شيء أن الملقم يحتاج إلى معرفة أن كنت تريد منه ان يعطيك صفحة انترنت.
+
+تخيل علبة بريد (ميناء) التي يتم ضبطها للرسائل الواردة (الطلبات). وهذا يتم عن طريق خادم ويب. خادم الويب يقوم بقراءة الرسالة وثم يرسل استجابة مع صفحة ويب. ولكن عندما تريد أن ترسل شيئا، فأنت بحاجة إلى بعض المحتوى. وجانغو هو الشيء الذي يساعدك في إنشاء المحتوى.
+
+## ماذا يحدث عندما يطلب شخص ما موقع انترنت من خادمك؟
+
+عندما يصل طلب إلى الخادم ، يتم تمريره لدجانغو ، والذي سيحاول ما الذي تم طلبه. إنه يأخذ عنوان صفحة ويب أولا ويحاول معرفة ما يجب القيام به. يتم هذا الجزء من قبل دجانغو ** urlresolver** (لاحظ أن عنوان موقع ويب يسمى URL - محدد مواقع الموارد - لذلك الاسم * urlresolver * منطقي). أنه ليس ذكية جدا - فإنه يأخذ قائمة من الأنماط ويحاول مطابقة عنوان URL. جانغو يتحقق من الأنماط من أعلى إلى أسفل، وإذا تم مطابقة شيء، يقوم جانغو بتمرير الطلب إلى الدالة المرتبطة بها (والتي تسمى *view*).
+
+تخيل ناقل البريد مع رسالة. تتمشى في الشارع وتفحص جميع ارقام البيوت مع الرقم الموجود في الرسالة. اذا كان مطابقا ، تضع الرسالة هناك. هذه هي الطريقة التي يعمل urlresolver بها!
+
+في الدالة *view*، تتم جميع الأمور المثيرة للاهتمام: يمكننا أن ننظر إلى قاعدة بيانات للبحث عن بعض المعلومات. ربما طلب المستخدم بتغيير شيء ما في البيانات؟ مثلما تقول الرسالة: "يرجى تغيير وصف وظيفتي". يمكن ل * view* التحقق مما إذا كان مسموحا لك القيام بذلك، ثم تحديث الوصف الوظيفي لك وإرسال رسالة مرة أخرى: "تم!" ثم * view* يولد استجابة و جانغو يمكن أن يرسلها إلى متصفح الويب الخاص بالمستخدم.
+
+بالطبع الوصف اعلاه مبسط كثيرا ، لكنك لست في حاجة لمعرفة كل المعلومات التقنية حاليا ، الحصول على فكرة عامة كافي.
+
+لذلك بدلا من الغوص كثيرا في التفاصيل، نحن سوف نبدأ ببساطة بخلق شيء عبر جانغو وسوف نتعلم كل الأجزاء الهامة على طول الطريق!
\ No newline at end of file
diff --git a/ar/django_admin/README.md b/ar/django_admin/README.md
new file mode 100644
index 00000000000..6db3cfe861d
--- /dev/null
+++ b/ar/django_admin/README.md
@@ -0,0 +1,57 @@
+# دجانغو المشرف
+
+لإضافة وتعديل وحذف المشاركات التي قمنا بإضافتها، سوف نستخدم دجانغو المشرف.
+
+دعونا نفتح `blog/admin.py` ونغير محتواه بهذا:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+كما ترون، نقوم باستيراد (تضمين) نموذج المشاركة المحدد في الفصل السابق. لجعل نموذجنا مرئيا على صفحة المشرف، نحن بحاجة إلى تسجيل النموذج مع `admin.site.register(Post)`.
+
+حسنا حان الوقت للنظر في نموذجنا. تذكر أن تقوم بتشغيل `python manage.py runserver` في وحدة التحكم لتشغيل خادم ويب. اذهب إلى المتصفح واكتب http://127.0.0.1:8000/admin/. ستظهر لك صفحة تسجيل دخول مثل هذه:
+
+![صفحة تسجيل الدّخول](images/login_page2.png)
+
+لتسجيل الدخول، تحتاج إلى إنشاء مستخدم *superuser*-حساب مستخدم له السيطرة على كل شيء في الموقع. ارجع إلى سطر الأوامر، واكتب `python manage.py createsuperuser`,، ثم اضغط على إنتر.
+
+> تذكر، لكتابة الأوامر الجديدة أثناء تشغيل خادم الويب، إفتح نافذة جديدة وفعل البيئة الإفتراضية الخاصة بك. علينا إعادة النظر في كيفية كتابة أوامر جديدة خلال فصل **أول مشروع جانغو لك!** ، في المقطع **بدء تشغيل خادم ويب**.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+عند الطلب، اكتب اسم المستخدم (أحرف صغيرة، لا مسافات)، وعنوان البريد الإلكتروني، وكلمة المرور. **لا تقلق أن كنت لا تستطيع رؤية كلمة المرور التي تكتبها – هكذا يجب ان تعمل-** اكتب فقط واضغط `إدخال` للمواصلة. يجب أن يظهر الناتج على هذا النحو (حيث يجب أن يكون اسم المستخدم والبريد الإلكتروني هو اسم المستخدم الخاص بك):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+ارجع إلى المتصفح. سجل الدخول باستخدام بيانات اعتماد المستخدم الخارق التي اخترتها؛ يجب أن ترى لوحة قيادة دجانغو المشرف.
+
+![دجانغو المشرف](images/django_admin3.png)
+
+انتقل إلى المشاركات وقم ببعض الإختبارات هناك. أضف خمس أو ست مشاركات مدونة. لا تقلق بشأن المحتوى - يمكنك ببساطة نسخ ولصق بعض النص من هذا البرنامج التعليمي لتوفير الوقت. :)
+
+تأكد من أن اثنين أو ثلاث مشاركات على الأقل (ليس جميعها) لها تاريخ نشر. سوف يكون هذا مفيد لنا في وقت لاحق.
+
+![دجانغو المشرف](images/edit_post3.png)
+
+إعرف المزيد حول لوحة تحكم دجانغو من خلال قراءة الوثائق الرسمية: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+ربما تكون هذه لحظة جيدة لشرب كوب من القهوة (أو الشاي) أو لتناول الطعام لإعادة تنشيط نفسك. لقد قمت بإنشاء أول نموذج جانغو خاص بك أنت تستحق الإستراحة قليلا!
\ No newline at end of file
diff --git a/ar/django_forms/README.md b/ar/django_forms/README.md
new file mode 100644
index 00000000000..73883e794d0
--- /dev/null
+++ b/ar/django_forms/README.md
@@ -0,0 +1,447 @@
+# أشكال دجانغو
+
+الشيء الأخير الذي نريد القيام به على موقعنا هو خلق وسيلة لطيفة لإضافة وتحرير مشاركات مدونتنا. دجانغو `admin` جميل ، لكن من الصعب تخصيصه وجعله جميلا. مع `forms` سيكون لدينا سلطة مطلقة على واجهتنا – يمكن أن نفعل أي شيء تقريبا يمكن أن نتصور!
+
+الشيء الجميل حول أشكال جانغو هو أنه يمكننا تخصيص واحد من الصفر أو إنشاء `ModelForm` الذي سيحفظ نتيجة النموذج في الشكل.
+
+هذا بالضبط ما نريد فعله سننشئ شكل لنمودج `Post`.
+
+مثل كل جزء مهم من دجانغو، فإن النماذج لها ملف خاص بها `forms.py`.
+
+نحن بحاجة إلى إنشاء ملف بهذا الاسم في دليل `blog`.
+
+    blog
+       └── forms.py
+    
+
+حسنا، دعونا نفتحه ونكتب التعليمة البرمجية التالية:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+نحتاج إلى استيراد أشكال دجانغو أولا (`from django import forms`)، ومن الواضح أن نموذج `Post` من .(`from .models import Post`).
+
+`PostForm`,، كما كنت تظن ربما، هو اسم النموذج. نحن بحاجة إلى أن نقول لدجانغو ان هذا النموذج هو `ModelForm`(لذلك جانغو ستقوم ببعض السحر `forms.ModelForm` هو المسؤول عن ذلك.
+
+تاليا ، لدينا `class Meta` والذي يقول لدجانغو اي نمودج يجب استخدامه لإنشاء الشكل (`model = Post`).
+
+وأخيراً، يمكننا أن نقول ياي حقول يجب ان تنتهي في شكلنا. في هذا السيناريو نريد فقط `title` و `text` عرضه – – `author` ينبغي أن يكون الشخص الذي قام بتسجيل هو (أنت!) ويجب تعيين `created_date` تلقائياً عندما نقوم بإنشاء مشاركة (أي في التعليمات البرمجية)، اليس كذالك؟
+
+وهذا كل شيء! كل ما يتعين علينا فعله الآن هو استخدام الشكل في *view* وعرضه في نموذج.
+
+لذلك مرة أخرى سنقوم بإنشاء رابط إلى صفحة، UR، والعرض والقالب.
+
+## رابط لصفحة مع الشكل
+
+حان الوقت لفتح `blog/templates/blog/base.html` سنضيف رابط في `div` بإسم `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+علما اننا سنستدعي العرض الجديد `post_new` كلاس `"glyphicon glyphicon-plus"` موفرة لنا عبر قالب البوستراب الذي نستخدمه. وسوف يضهر علامة + لنا.
+
+بعد إضافة السطر، الآن يجب أن يبدو ملف HTML الخاص بك مثل هذا:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+سوف تشاهد بعد حفظ وتحديث الصفحة http://127.0.0.1:8000 من الواضح أن خطأ `NoReverseMatch` مألوف، اليس كذالك؟
+
+## عنوان الموقع URL
+
+نفتح `blog/urls.py` وإضافة سطر:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+سوف تبدو هذه التعليمة البرمجية في النهاية هكذا:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+بعد تحديث الموقع نرى `AttributeError` بما انه ليس لدينا `post_new` عرض تنفيدي دعونا نضفه الأن.
+
+## عرض post_new
+
+حان الوقت لفتح `blog/views.py` واضافة الأسطر التالية مع بقية اسطر `from`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+عندها *view*: الخاصة بنا:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+لإنشاء نموذج `Post` جديد، نحن بحاجة إلى استدعاء `PostForm()` وتمريرها إلى القالب. سنعود لهذا *view* لكن الأن دعونا ننشئ شكل نمودج سريعا.
+
+## القالب
+
+نحن بحاجة إلى إنشاء ملف `post_edit.html` في الدليل `blog/templates/blog`. لإنشاء نموذج العمل نحن بحاجة إلى عدة أشياء:
+
+* علينا عرض الشكل. يمكننا أن نفعل ذلك عبر (على سبيل المثال{% raw %}`{{ form.as_p }}`{% endraw %}.
+* السطر أعلاه يحتاج إلى أن يكون ملفوف مع علامة نموذج HTML: `<form method="POST">...</form>`.
+* ونحن بحاجة إلى زر `Save`. ونحن نفعل ذلك مع زر HTML: `<button type="submit">Save</button>`.
+* وأخيراً، فقط بعد افتتاح العلامة `<form ...>` نحن بحاجة إلى إضافة {% raw %} `{% csrf_token %}`{% endraw %}. هذا أمر مهم جداً، لأنه يجعل النماذج الخاصة بك آمنة! إذا كنت قد نسيت هذا قليلاً، سيشكو جانغو عند محاولة حفظ النموذج:
+
+![صفحة "CSFR "](images/csrf2.png)
+
+حسنا، دعونا نرى كيف يجب ان يبدو `post_edit.html` HTML:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+حان الوقت للتحديث! ياي! تم عرض الشكل الخاص بك!
+
+![نموذج جديد](images/new_form2.png)
+
+ولكن انتظر لحظة! عندما تكتب شيئا في حقول `title` و `text` ومحاولة حفظه، ما الذي سيحدث؟
+
+لا شيء! نحن مرة أخرى على نفس الصفحة ونصنا قد اختفى.. ولم يتم إضافة أي وظيفة جديدة. ما هو الخطأ؟
+
+الجواب: لا شيء. نحن بحاجة إلى العمل أكثر قليلاً في *view*.
+
+## حفظ الشكل
+
+أفتح `blog/views.py` مرة أخرى. حاليا كل ما لدينا في `post_new` هو ما يلي:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+عندما نقدم الشكل، نعود الى نفس المنضر، ولكن هذه المرة لدينا بعض البيانات أكثر في `request`، وبشكل أكثر تحديداً في `request.POST`(التسمية ليس لها علاقة بمشاركات المدونة بل بنشرنا للمعلومات بيانات). تذكر كيف كان تعريفنا `<form>`في ملف HTML، المتغير `method="POST"`؟ كافة الحقول من الشكل الآن في `request.POST`. لا يجب إعادة تسمية `POST` الى أي شيء آخر (القيمة الوحيدة الصالحة ل `method` هي`GET`، ولكن ليس لدينا وقت لشرح الفرق).
+
+لذا في *view* الخاص بنا لدينا حالتين منفصلتين للتعامل معهما: أولا، عندما نصل إلى الصفحة لأول مرة ونريد نموذج فارغ، وثانيا، عندما نعود إلى *view* مع جميع اشكال البيانات التي كتبنا. لذلك نحتاج إلى إضافة شرط (سنستخدم `if` لذلك(:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+حان الوقت لملئ النقاط `[...]`. إذا كانت `method` `POST` فإننا نريد إنشاء `PostForm` مع بيانات من النموذج، أليس كذلك؟ سوف نفعل ذلك على النحو التالي:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+الشيء التالي هو التحقق مما إذا كان النموذج صحيح (تم تعيين جميع الحقول المطلوبة ولم يتم تقديم أية قيم غير صحيحة). ونحن نفعل ذلك عبر `form.is_valid()`.
+
+نتحقق مما إذا كان النموذج صالح وإذا كان كذلك، يمكننا حفظه!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+في الأساس، لدينا أمرين هنا: نحفظ النموذج مع `form.save` ونضيف مؤلف (بما انه لم يكن هناك مجال ل `author` في `PostForm` وهذا الحقل مطلوب). `commit=False` يعني أننا لا نريد حفظ نموذج `Post` بعد--نريد إضافة الكاتب أولاً. في غالب الوقت ستستخدم `form.save()` بدون `commit=False` ولكن في هذه الحالة، ونحن بحاجة لتوريده. `post.save()` سيتم الاحتفاظ بتغييرات (إضافة المؤلف) ويتم إنشاء تدوينة جديدة!
+
+وأخيرا، سيكون أمرا رائعا إذا تمكنا من الانتقال مباشرة إلى صفحة `post_detail` لمشاركتنا التي تم إنشاؤها حديثا في المدونة، أليس كذلك؟ ولتحقيق ذلك، نحتاج إلى استيراد:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+أضفه في بداية الملف. والآن يمكننا أن نقول: "انتقل إلى صفحة `post_detail` للمشاركة التي تم إنشاؤها حديثا":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` هو اسم العرض الذي نريد الذهاب اليه. تذكر أن هذا *view* يتطلب متغير `pk`؟ لتمريرها إلى العرض، نستخدم `pk=post.pk`، حيث `post` هي مشاركة المدونة التي تم إنشاؤها حديثا!
+
+حسنا، لقد تحدثنا كثيرا، ولكن ربما نريد أن نرى ما يبدو عليه *view* الآن، أليس كذلك؟
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+دعونا نرى ما إذا كان يعمل. اذهب إلى صفحة http://127.0.0.1:8000/post/new/,، اضف `title` و `text`،احفضه ، ها انت الأن! تم إضافة مشاركة المدونة الجديدة وسيتم إعادة توجيهك إلى الصفحة `post_detail`!
+
+ربما لاحظتم أننا نضع تاريخ النشر قبل حفظ المشاركة. وفي وقت لاحق سوف نقدم *publish button* في **Django Girls Tutorial: Extensions**.
+
+هذا رائع!
+
+> كما استخدمنا مؤخرا واجهة المسؤول دجانغو، النظام يعتقد حاليا أننا لازلنا مسجلين. وهناك بعض الحالات التي يمكن أن تؤدي بالنسبة إلى تسجيل الخروج (إغلاق المستعرض، إعادة تشغيل DB، إلخ.). إذا، عند إنشاء مشاركة، أن كنت تحصل على أخطاء في اشارة الى عدم وجود مستخدم سجل الدخول، توجه إلى صفحة المشرف http://127.0.0.1:8000/admin وسجل الدخول مرة أخرى. وهذا سيحل المشكلة مؤقتاً. هناك إصلاح دائم في انتظاركم في فصل **Homework: add security to your website!** بعد البرنامج التعليمي الرئيسي.
+
+![خطأ في تسجيل الدخول](images/post_create_error.png)
+
+## التحقق من صحة النموذج
+
+الأن سنضهر لك كم هي رائعة اشكال دجانغو. المشاركة او التدوينة يجب ان تحتوى على `title` `text`. في نموذج `Post` لم نقول إن هذه الحقول (على عكس `published_date`) غير مطلوبة، لذا يتوقع دجانغو افتراضيا تعيينها.
+
+حاول حفظ النموذج بدون `title` و `text`. خمن ما سيحدث!
+
+![التحقق من صحة النموذج](images/form_validation2.png)
+
+جانغو يحرص على التحقق من صحة جميع الحقول في شكلنا ان كانت صحيحة. أليس هذا رائع؟
+
+## تحرير النموذج
+
+الأن نعرف كيف نضيف شكل جديد. لكن ماذا لو اردنا تحرير شكل موجود مسبقا؟ هذا مشابه جدا لما قمنا به. لنقم بإنشاء بعض الأمور الهامة بسرعة. (إذا كنت لا تفهم شيئا، يجب أن تسأل المدرب الخاص بك أو تنظر في الفصول السابقة، لأننا غطينا جميع هذه الخطوات مسبقاً.)
+
+افتح `blog/templates/blog/post_detail.html` واضف السطر
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+بحيث يبدو القالب كما يلي:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+وفي `blog/urls.py` نضيف هذا السطر:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+سوف نعيد استخدام القالب `blog/templates/blog/post_edit.html`، آخر شيء مفقود هو طريقة*view*.
+
+دعونا نفتح `blog/views.py` وإضافة هذا في نهاية الملف:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+يبدو هذا بالضبط تقريبا نفس عرض `post_new`، أليس كذلك؟ ولكن ليس تماما. لواحد، يتم تمرير إعدادات `pk` إضافية من عناوين urls. بعد ذلك، نحصل على نموذج `Post` نريد تحرير `get_object_or_404(Post, pk=pk)` وبعد ذلك، عندما نقوم بإنشاء نموذج، نمرر هذه المشاركة باعتبارها `instance`، معا عند حفض النمودج…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+وعنما فتحنا نمودج من هذه المشاركة لتحريره:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+حسنا، دعونا نختبر إذا كان يعمل! لننتقل إلى صفحة `post_detail`. يجب أن يكون هناك زر تعديل في الركن العلوي الأيسر:
+
+![زر تحرير](images/edit_button2.png)
+
+عند النقر عليه سترى النموذج مع مشاركة مدونتنا:
+
+![تحرير النموذج](images/edit_form2.png)
+
+لا تتردد في تغيير العنوان أو النص وحفظ التغييرات!
+
+تهانينا! التطبيق الخاص بك يصبح اكثر كمالاً!
+
+إعرف المزيد حول حول اشكال دجانغو من خلال قراءة الوثائق الرسمية: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## الحماية
+
+أن تكون قادر على خلق مشاركات جديدة فقط عن طريق النقر على رابط رائع! ولكن في الوقت الراهن، أي شخص يقوم بزيارة موقع الويب الخاص بك سوف يكون قادر على انشاء مشاركة جديدة، وهذا شيء ربما لا تريده. دعونا تجعل الزر يظهر لك و ليس لأي شخص آخر.
+
+في `blog/templates/blog/base.html`، تجد لدينا `page-header` `div` وعلامة مرساة كانت قد وضعت هناك مسبقا. ينبغي أن تبدو مثل هذا:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+سنضيف علامة `{% if %}` أخرى ، مما سيجعل الرابط يظهر فقط للمستخدمين الذين سجلوا الدخول إلى المشرف. هذا يعني انت وحدك فقط! غير العلامة `<a>`لتبدو مثل هذا:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+هذا `{% if %}` سيؤدي إلى إرسال الرابط إلى المتصفح فقط إذا تم تسجيل دخول المستخدم الذي يطلب الصفحة. هذا لا يحمي إنشاء مشاركات جديدة ، ولكنها خطوة أولى جيدة. سنغطي المزيد عن الأمان في الدروس الملحقة القادمة.
+
+هل تذكر رمز التعديل الذي أضفناه للتو إلى صفحة التفاصيل؟ نريد أيضا إضافة التغيير نفسه هناك، حتى لا يتمكن الأشخاص الآخرون من تعديل المشاركات الحالية.
+
+افتح `blog/templates/blog/post_detail.html` واضف السطر:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+غيره إلى هذا:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+نظرا لأنك مسجل الدخول، إذا قمت بتحديث الصفحة، فلن ترى شيئا مختلفا. تحميل الصفحة في متصفح مختلف أو نافذة التصفح المتخفي (تسمى "InPrivate" في ويندوز إدج)، على الرغم من ذلك، وسترى أن الرابط لا يضهر والرمز لا يعرض ايضا!
+
+## شيء اخر: أنشر الوقت!
+
+دعونا نرى ما إذا كان كل هذا يعمل على PythonAnywhere. حان الوقت لنشر آخر!
+
+* أولا، التزم بالتعليمات البرمجية الجديدة، وإدفعها إلى جيت هاب:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* وبعد ذلك، في وحدة [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* وأخيرا، انتقل إلى علامة التبويب [Web tab](https://www.pythonanywhere.com/web_app_setup/) واضغط على **Reload**.
+
+هذا ينبغي ان يكون كل شيء! مبروك:)
\ No newline at end of file
diff --git a/ar/django_installation/README.md b/ar/django_installation/README.md
new file mode 100644
index 00000000000..b8628506b74
--- /dev/null
+++ b/ar/django_installation/README.md
@@ -0,0 +1,7 @@
+# تركيب دجانغو
+
+> **ملاحضة**إذا كنت تستخدم كروم بوك تخطى هذا القسم وتابع الإرشادات الموجودة في [التركيب على كروم بوك](../chromebook_setup/README.md).
+> 
+> **ملاحضة** اذا كنت قد عملت على تعليمات التركيب من قبل ، يمكنك الإنتقال الى المستوى الأخر!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ar/django_installation/instructions.md b/ar/django_installation/instructions.md
new file mode 100644
index 00000000000..02ce37f87da
--- /dev/null
+++ b/ar/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> هذا القسم يستند على دورة تعليمية من فتيات الجزر المهووسات (https://github.com/ggcarrots/django-carrots).
+> 
+> جزء من هذا القسم يستند [django-marcador tutorial](http://django-marcador.keimlink.de/) المرخص لها بمرخصة بموجب المشاع الإبداعي   إسناد-على غرار 4.0 الترخيص الدولي. البرنامج التعليمي django-marcador حقوق الطبع والنشر من قبل Markus Zapke-Gründemann وآخرون.
+
+## البيئة الافتراضية
+
+قبل تنصيب دجانغو ، سوف نقوم بتنصيب اداة جد مهمة وستساعدنا كثيرا،في الحفاظ على بيئة كتابة التعليمات البرمجية الخاصة بك مرتبة على جهاز الكمبيوتر. من الممكن تخطي هذه الخطوة، ولكن نحن يوصي بشدة بها. بدءاً من الإعداد الأفضل والذي سيحميك من الكثير من المتاعب في المستقبل!
+
+هيا لننشئ **بيئة افتراضية** ، تسمى ايضا ب *virtualenv*. سوف تعزل البيئة الإفتراضية إعدادات بايثون / دجانغو الخاص بك على أساس كل مشروع. وهذا يعني أن أية تغييرات تقوم بإجرائها على موقع واحد لن تؤثر على المواقع الأخرى التي تطورها. أنيق، أليس كذالك؟
+
+كل ما عليك القيام به هو العثور على الدليل الذي تريد إنشاء `virtualenv`؛ فيه الدليل الرئيسي الخاص بك، على سبيل المثال. في Windows قد تبدو مثل `C:\Users\Name` (حيث `Name` هو اسم تسجيل الدخول الخاص بك).
+
+> **ملاحظة:** في Windows، تأكد من أن هذا الدليل لا يحتوي على أحرف هجائية أو خاصة؛ إذا كان اسم المستخدم الخاص بك يحتوي على أحرف هجائية، استخدام دليل مختلف، على سبيل المثال `C:\djangogirls`.
+
+في هذا البرنامج التعليمي سوف نستخدم دليل جديد `djangogirls` من الدليل الرئيسي الخاص بك:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+سوف نقوم بإنشاء بيئة افتراضية تسمى `myvenv`. سوف تكون القيادة العامة في التنسيق:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+لإنشاء `virtualenv`, جديد، تحتاج إلى فتح موجه الأوامر وتشغيل `python -m venv myvenv`. وسوف تبدو كما يلي:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+حيث `myvenv` هو اسم خاص ب `virtualenv`. يمكنك استخدام أي اسم آخر، لكن حافض على الحروف الصغيرة ولا تستخدم مسافات أو لهجات أو أحرف خاصة. كما أنها فكرة جيدة الحفاظ على الاسم قصير – سوف تستخدمه كمرجع كثيرا!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+يمكننا إنشاء `virtualenv` على لينكس ونظام التشغيلOS X عن طريق تشغيل `python3 -m venv myvenv`:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+حيث `myvenv` هو اسم خاص ب `virtualenv`. يمكنك استخدام أي اسم آخر، لكن حافض على الحروف الصغيرة ولا تستخدم مسافات. كما أنها فكرة جيدة الحفاظ على الاسم قصير – سوف تستخدمه كمرجع كثيرا!
+
+> **ملاحظة:** في بعض الإصدارات من ديبيان/أوبونتو قد تتلقى الخطأ التالي:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     لم يتم إنشاء بالبيئة الإفتراضية بنجاح لأن ensurepip غير متوفر.  على أنظمة ديبيان/أوبونتو، تحتاج إلى تثبيت حزمة python3-venv باستخدام الأمر التالي.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  بعد تثبيت حزمة python3-venv، قم بإعادة إنشاء البيئة الإفتراضية الخاصة بك.
+>     
+> 
+> في هذه الحالة اتبع التعليمات تحت وثبت حزمة `python3-venv` {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **ملاحظة:** في بعض الإصدارات من ديبيان/أوبونتو اعداد البيئة الإفتراضية بهذه الطريقة قد يعطي هذا الخطأ:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> للالتفاف على هذا، استخدم الأمر `virtualenv` بدلاً من ذلك.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **ملاحظة:** إذا حصلت على خطأ مثل
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> قم بتشغيل هذا الأمر:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## العمل مع virtualenv
+
+الأمر أعلاه سينشئ دليل يسمى `myvenv` (أو أيا كان الاسم الذي تختاره) الذي يحتوي على بيئتنا الإفتراضية (أساسا حفنة من الدلائل والملفات).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+بدء تشغيل البيئة الإفتراضية الخاصة بك عن طريق تشغيل:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **ملاحظة:** على Windows 10 قد تحصل على خطأ في Windows PowerShell يقول `execution of scripts is disabled on this system`. وفي هذه الحالة، قم بفتح Windows PowerShell آخر باستخدام الخيار "تشغيل كمسؤول". ثم حاول كتابة الأمر التالي قبل تشغيل البيئة الإفتراضية الخاصة بك:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. تغيير سياسة التنفيذ قد يعرضك للمخاطر الأمنية الموضحة في موضوع التعليمات about_Execution_Policies في http://go.microsoft.com/fwlink/?LinkID=135170. هل تريد تغيير نهج التنفيذ؟ [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+بدء تشغيل البيئة الإفتراضية الخاصة بك عن طريق تشغيل:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+تذكر أن تقوم باستبدال `myvenv` مع الاسم الذي اخترته ل `virtualenv` الخاص بك!
+
+> **ملاحظة:** في بعض الأحيان قد يكون `source` غير متوفر. وفي تلك الحالات حاول القيام بهذا بدلاً من ذلك:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+سوف تعرف أن لديك `virtualenv` بدأت عندما ترى أن الموجه في وحدة التحكم الخاصة بك مسبوقاً ب `(myvenv)`.
+
+عند العمل ضمن بيئة افتراضية، سيشير `python` تلقائياً إلى الإصدار الصحيح حيث يمكنك استخدام `python` بدلاً من `python3`.
+
+حسنا، لدينا كافة التبعيات الهامة في المكان. وأخيراً يمكننا تثبيت جانغو!
+
+## تثبيت جانغو
+
+الآن بما انه لديك `virtualenv` مشغل، يمكنك تثبيت جانغو.
+
+قبل أن نفعل ذلك، يجب علينا التأكد من لدينا أحدث إصدار من `pip`، البرامج التي نستخدمها لتثبيت جانغو:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+قم بتشغيل `pip install django~=1.11.0`(علما بأننا نستخدم تيلدا متبوعاً بعلامة يساوي: `~ =`) لتثبيت جانغو.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> إذا كنت تحصل على خطأ عند استدعاء برنامج pip على منصة Windows، الرجاء التحقق إذا كان اسم مسار المشروع الخاص بك يحتوي على مسافات أو لهجات أو أحرف خاصة (على سبيل المثال، `C:\Users\User Name\djangogirls`). إذا كان كذالك، يرجى النظر في استخدام مكان آخر دون مسافات أو لهجات أو أحرف خاصة (اقتراح: `C:\djangogirls`). إنشاء virtualenv جديدة في الدليل الجديد، ثم إحذف القديم وحاول تنفيذ الأمر أعلاه مرة أخرى. (نقل دليل virtualenv لن يعمل بما ان virtualenv يستخدم مسارات مطلقة.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> سطر الأوامر الخاصة بك قد تجمد بعد محاولة تثبيت جانغو. إذا حدث هذا، بدلاً من الأمر أعلاه استخدم:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> إذا كنت تحصل على خطأ عند استدعاء برنامج pip على أوبونتو 12.04 الرجاء تشغيل `python -m pip install -U --force-reinstall pip` لإصلاح تثبيت برنامج pip في virtualenv.
+
+<!--endsec-->
+
+هذا كل شيء! أنت الآن على استعداد لإنشاء تطبيق جانغو (أخيرا)!
\ No newline at end of file
diff --git a/ar/django_models/README.md b/ar/django_models/README.md
new file mode 100644
index 00000000000..cbb69f06c9c
--- /dev/null
+++ b/ar/django_models/README.md
@@ -0,0 +1,199 @@
+# نماذج دجانغو
+
+ما نريد أن نخلق الآن هو شيء من شأنه أن يخزن جميع المشاركات في مدونتنا. ولكن لكي نكون قادرين على القيام بذلك، نحتاج إلى الحديث قليلا عن الأشياء المسماة `objects`.
+
+## الكائنات
+
+هناك مفهوم في البرمجة يسمى `object-oriented programming`. والفكرة هي أنه بدلاً من كتابة كل شيء كتسلسل ممل من تعليمات البرمجة، يمكننا نمذجة الأشياء وتحديد كيفية تفاعلها مع بعضها البعض.
+
+ما هو الكائن؟ عبارة عن مجموعة من الخصائص واﻹجراءات. أنها تبدو غريبة، ولكن سوف نقدم لكم بعض الأمثلة.
+
+إذا أردنا نمذجة قط، سنقوم بإنشاء كائن `Cat` يحتوي على بعض الخصائص مثل `color`, `age`, `mood` (مثل جيد أو سيئ، أو النعاس;))، و `owner`(التي يمكن أن تسند إلى كائن `Person` – أو ربما، في حالة قط ضآل، يمكن أن تكون الخاصية فارغة).
+
+ثم يحتوي `Cat` على بعض الإجراءات: ` purr</ 0> أو <code> scratch</ 0> أو <code> feed</ 0> (وفي بعض الحالات نعطي القط <code> CatFood </ 0>، والتي يمكن أن تكون كائن منفصل مع خصائص، مثل <code> taste </ 0>).</p>
+
+<pre><code>Cat
+--------
+color
+age
+mood
+owner
+purr()
+scratch()
+feed(cat_food)
+`</pre> 
+
+    CatFood
+    --------
+    taste
+    
+
+لذا فإن الفكرة الأساسية هي وصف الأشياء الحقيقية في الشفرة مع خصائص (تسمى ` object properties </ 0>) والإجراأت (تسمى <code> methods</ 0>).</p>
+
+<p>كيف سننشئ مشاركات المدونة بعد ذلك؟ نحن نريد بناء مدونة، أليس كذلك؟</p>
+
+<p>نحن بحاجة إلى الإجابة على السؤال: ما هي وظيفة المدونة؟ ما هي الخصائص التي يجب ان تحملها؟</p>
+
+<p>حسنا، بالتأكيد لدينا مشاركة في مدونتنا تحتاج بعض النصوص مع محتوى وعنوان، أليس كذلك؟ سيكون جيدا ايضا معرفة من كتبها ، لذا نحن بحاجة لكاتب. وأخيرا نود معرفة متى تم إنشاء ونشر المشاركة.</p>
+
+<pre><code>Post
+--------
+title
+text
+author
+created_date
+published_date
+`</pre> 
+
+ما نوع الأشياء التي يمكن إجراؤها على مشاركة في المدونة؟ سيكون من الجميل أن يكون لديك بعض `method` التي تنشر المشاركة، أليس كذلك؟
+
+لذلك سوف نحتاج إلى أسلوب `publish`.
+
+نظراً لأننا نعرف ما نريد أن نحققه، دعونا نبدأ النمذجة في جانغو!
+
+## نماذج دجانغو
+
+بمعرفة ما هو الكائن ، يمكننا انشاء نمودج للمشاركة على مدونتنا.
+
+النموذج في جانغو هو كائن من نوع خاص يتم حفظه في `database`. قاعدة بيانات هي مجموعة من البيانات. هذا هو المكان الذي ستحفض فيه معلومات حول المستخدمين ،مشاركاتك ومدونتك. سيتم استخدام قاعدة بيانات SQLite لتخزين البيانات الخاصة بنا. هذه قاعدة البيانات الإفتراضية الخاصة بجانغو-- سوف تكون كافية بالنسبة لنا الآن.
+
+يمكنك التفكير في نموذج في قاعدة البيانات كجدول مع الصفوف (بيانات) والأعمدة (الحقول).
+
+### إنشاء تطبيق
+
+لإبقاء كل شيء مرتباً، سننشئ تطبيق منفصل داخل مشروعنا. انه من الجميل ان يكون كل شيء مرتب من البداية. لإنشاء تطبيق نحن بحاجة إلى تشغيل الأمر التالي في وحدة التحكم (من `djangogirls` حيث يوجد الملف `manage.py`):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+ستلاحظ أنه تم إنشاء دليل `blog` جديد ويحتوي على عدد من الملفات الآن. يجب أن تبدو الدلائل والملفات في مشروعنا كما يلي:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+بعد إنشاء التطبيق، نحتاج أيضا أن نقول لدجانغو أنه ينبغي استخدامه. نحن نفعل ذلك في ملف `mysite/settings.py`. نحن بحاجة إلى البحث عن `INSTALLED_APPS` وإضافة خط يحتوي على `'blog',` فقط فوق `]`. المنتج النهائي ينبغي أن يبدو هكذا:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### إنشاء نمودج مشاركة في المدونة
+
+في ملف `blog/models.py` نحدد كافة كائنات تسمى `Models`--وهذا هو المكان الذي سنحدد فيه مشاركات مدونتنا.
+
+دعونا نفتح `blog/models.py`، وإزالة كل شيء منه، وكتابة التعليمات البرمجية التالية:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User')
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> تحقق جيدا من استخدام حرفين أسفل السطر (`_`) على كل جانب من `str`.  . هذه الاتفاقية تستخدم كثيرا في بايثون وأحيانا كما نسميها "dunder" (قصيرة ل "double-underscore").
+
+يبدو مخيفا، أليس كذلك؟ ولكن لا تقلق--سوف نشرح ماذا تعني هذه السطور!
+
+جميع الخطوط بدءاً `from` أو `import` هي سطور تضيف بعض أجزاء من ملفات أخرى. بدلاً من نسخ ولصق نفس الأشياء في كل ملف، يمكن أن ندرج بعض الأجزاء مع `من... استيراد...`.
+
+`class Post(models.Model):` --هذا الخط يحدد نموذج لدينا (و هو`object`).).
+
+- `class` هي كلمة أساسية خاصة التي تشير إلى أنه علينا تحديد كائن.
+- `Post` هو اسم نموذجنا. ويمكننا أن نعطيه اسما مختلفا (ولكن يجب علينا تجنب الأحرف الخاصة والمسافاة). ابدأ دائما بإسم فئة مع حرف كبير.
+- `models.Model` يعني أن المشاركة هي نموذج لجانغو، لذلك دجانغو يعرف أنه يجب حفظها في قاعدة البيانات.
+
+والآن علينا أن نحدد الخصائص التي كنا نتحدث عنها`title`, `text`, `created_date`, `published_date` و `author`. للقيام بذالك نحن بحاجة إلى تحديد نوع كل حقل (النص؟ رقم؟ تاريخ؟ علاقة لكائن آخر، مثل مستخدم)
+
+- `models.CharField` –--وهكذا يمكنك تحديد نص مع عدد محدود من الأحرف.
+- `models.TextField` – هذا لنص طويل دون حد. يبدو مثاليا لمدونة لمشاركة المحتوى، أليس كذلك؟
+- `models.DateTimeField` --هذا هو التاريخ والوقت.
+- `models.ForeignKey`--وهذا ارتباط إلى نموذج آخر.
+
+نحن لن شرح كل شيء من التعليمات البرمجية هنا لأنه سوف يستغرق الكثير من الوقت. ينبغي أن نلقي نظرة على وثائق جانغو إذا كنت ترغب في معرفة المزيد عن حقول النموذج وكيفية تحديد الأشياء غير تلك المذكورة أعلاه (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+وماذا عن `def publish(self):`؟ هذا هو بالضبط الأسلوب `publish` الذي كنا نتحدث عنه. `def` يعني أن هذا أسلوب دالة و `publish` اسم الأسلوب. يمكنك تغيير اسم الأسلوب إذا أردت. حكم التسمية أن نستخدم حروف صغيرة وتسطيرات أسفل السطر بدلاً من المسافات. على سبيل المثال، يمكن استدعاء أسلوب والذي يقوم بحساب متوسط السعر `calculate_average_price`.
+
+أساليب كثيرا ما `return` شيئا. هناك مثال على ذلك في أسلوب `__str__`. في هذا السيناريو، عندما ندعو `__str__()` سوف تحصل على نص (**string**) مع عنوان البريد.
+
+كما لاحظ أن كلا `def publish(self):` و `def __str__(self):` يتم فصلها داخل فئتنا. نظراً لأن بايثون حساسة للمسافة البيضاء، نحن بحاجة لوضع مسافة بادئة لأساليب عملنا داخل الفئة. بخلاف ذلك، الأساليب التي لا تنتمي إلى الفئة، ويمكنك الحصول على بعض السلوك الغير متوقع.
+
+إذا كان هناك شيء لا يزال غير واضح حول النماذج، لا تتردد بسؤال المدرب الخاص بك! نحن نعلم أنها معقدة، لا سيما عندما كنت تتعلم ما الأشياء والمهام في نفس الوقت. ولكن نأمل أن يبدو أقل سحرا قليلا الآن!
+
+### إنشاء جداول للنماذج في قاعدة البيانات الخاصة بك
+
+الخطوة الأخيرة هنا لإضافة نموذجنا الجديد إلى قاعدة البيانات الخاصة بنا. أولاً يجب أن تجعل جانغو يعرف أن لدينا بعض التغييرات في نموذجنا. (لقد أنشئناه للتو!) إذهب إلى إطار وحدة التحكم الخاصة بك واكتب `python manage.py makemigrations blog`. ستبدو كالشكل التالي:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**ملاحظة:** تذكر أن تقوم بحفظ الملفات التي يمكنك تحريرها. وبخلاف ذلك، سيقوم الكمبيوتر بتنفيد النسخة السابقة والتي قد تعطيك رسائل خطأ غير متوقعة.
+
+أعدت دجانغو ملف ترحيل لنا وعلينا الآن أن نطبقه على قاعدة البيانات الخاصة بنا. اكتب `python manage.py migrate blog` ويكون الإخراج كما يلي:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+يا هلا! الآن لدينا نموذج آخر في قاعدة بياناتنا! سيكون من الجميل أن نراه ، اليس كذالك؟ انتقل إلى الفصل التالي لمعرفة الشكل الذي تبدو عليه مشاركتك!
\ No newline at end of file
diff --git a/ar/django_orm/README.md b/ar/django_orm/README.md
new file mode 100644
index 00000000000..2942903611f
--- /dev/null
+++ b/ar/django_orm/README.md
@@ -0,0 +1,218 @@
+# ORM جانغو و Querysets
+
+في هذا الفصل سوف تتعلم كيف تتصل جانغو بقاعدة البيانات وتقوم بتخزين البيانات فيها. دعونا نغوص في الشرح!
+
+## ما هو QuerySet؟
+
+QuerySet هو، في جوهره، قائمة الكائنات من نموذج معين. QuerySet تسمح لك بقراءة البيانات من قاعدة البيانات، وتصفيها وتطلبها.
+
+من السهل التعلم عبر الأمثلة ، دعونا نجرب ذالك. هيا بنا؟
+
+## Django shell
+
+إفتح وحدة التحكم المحلية الخاصة بك (ليس على PythonAnywhere) واكتب هذا الأمر:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+التأثير يجب أن يكون مثل:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+أنت الآن في جانغو في وحدة التحكم التفاعلية. أنها تماما مثل موجه بيثون، ولكن مع بعض سحر جانغو الإضافي. :) يمكنك استخدام كافة اوامر بيثون هنا أيضا، بطبيعة الحال.
+
+### كل الكائنات
+
+دعونا نحاول عرض جميع المشاركات لدينا أولاً. يمكنك القيام بذلك باستخدام الأمر التالي:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+اووبس! ظهر خطأ. يقول لنا أنه لا يوجد أي مشاركة. هذا صحيح لقد نسينا استيراده أولا!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+نستورد النموذج `Post` من`blog.models`. لنحاول عرض جميع المشاركات مرة أخرى:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+هذه قائمة باالمشاركات التي أنشأنا في وقت سابق! قمنا بإنشاء هذه المشاركات باستخدام واجهة المشرف جانغو. ولكن الآن نحن نريد انشاء مشاركات جديدة باستخدام بيثون، فكيف نفعل ذلك؟
+
+### إنشاء كائن
+
+هذه هي الطريقة التي تقوم بها بإنشاء مشاركة كائن جديد في قاعدة البيانات:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+ولكن لدينا عنصر واحد في عداد المفقودين هنا `me`. نحن بحاجة إلى تمرير مثيل من نموذج `User` كمؤلف. كيف نفعل ذلك؟
+
+دعونا نسترد نموذج المستخدم الأول:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+اية مستخدمين لدينا في قاعدة البيانات الخاصة بنا؟ جرب هذا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+هذا هو المستخدم الخارق الذي أنشأنا في وقت سابق! دعونا نحصل على مثيل للمستخدم الآن:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+كما ترون، نحن الآن`get` ا `User` مع `username` يساوي 'ola'. أنيق! بطبيعة الحال، عليك ضبط هذا الخط لاستخدام اسم المستخدم الخاص بك.
+
+الآن يمكننا أخيرا إنشاء مشاركة:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+يا هلا! هل تريد التحقق من ما إذا كان يعمل؟
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+هاهي ذا! مشاركة آخرى في القائمة!
+
+### إضافة المزيد من المشاركات
+
+يمكنك الآن الحصول على القليل من المرح وإضافة المزيد من المشاركات لنرى كيف يعمل. أضف اثنين أو ثلاثة آخرين ثم انتقل إلى الجزء التالي.
+
+### تصفية الكائنات
+
+جزء كبير من QuerySets هو القدرة على تصفيتهم. لنفترض أننا نريد العثور على جميع المشاركات التي قام المستخدم ola بتأليفها. سنقوم باستخدام `filter` بدلاً من `all` في `Post.objects.all()`. بين قوسين نوضح ما هي الشروط التدوينة تحتاج إلى تلبية في نهاية المطاف في queryset لدينا. وفي حالتنا، الشرط أن `author` يجب أن يكون متساوي مع `me`. طريقة كتابتها في دجانغو `author=me`. الأن قطعتنا من الكود تبدو بهذا الشكل:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+أو ربما نريد أن نرى جميع المشاركات التي تحتوي على كلمة 'title' في الحقل `title`؟
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **ملاحظة** هناك حرفان أسفل السطر (`_`) بين `title` و `contains`. يستخدم ORM دجانغو هذه القاعدة لفصل أسماء الحقول ("title") والعمليات أو الفلاتر ("contains"). إذا قمت باستخدام تسطير واحد فقط، سوف تحصل على خطأ مثل "FieldError: Cannot resolve keyword title_contains".
+
+يمكنك أيضا الحصول على قائمة بجميع المشاركات المنشورة. علينا القيام بذلك بتصفية جميع المشاركات التي قد `published_date` في الماضي:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+للأسف، لم يتم نشر المشاركة التي أضفناها من وحدة تحكم بايثون بعد. ولكن يمكننا تغيير ذلك! احصل أولا على مثال لمشاركة نريد نشرها:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+ثم أنشرها باستخدام طريقة `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+الآن في محاولة للحصول على قائمة المشاركات المنشورة مرة أخرى (اضغط على مفتاح السهم لأعلى ثلاث مرات واضغط `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### العناصر الصادرة
+
+QuerySets تسمح لك أيضا بترتيب قائمة الكائنات. دعونا نحاول ترتيبها حسب الحقل `created_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+يمكننا أيضا عكس الترتيب بإضافة `-` في البداية:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### مجموعات الاستعلام المتسلسلة
+
+يمكنك أيضا دمج QuerySets من خلال **chaining** معا:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+هذا حقا قوي ويتيح لك كتابة استفسارات معقدة جدا.
+
+رائع! أنت الآن جاهز للجزء التالي! لإغلاق الشل shell، اكتب هذا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ar/django_start_project/README.md b/ar/django_start_project/README.md
new file mode 100644
index 00000000000..222379c217b
--- /dev/null
+++ b/ar/django_start_project/README.md
@@ -0,0 +1,202 @@
+# مشروعك الأول في دجانغو!
+
+> هذا القسم يستند على دورة تعليمية من فتيات الجزر المهووسات (https://github.com/ggcarrots/django-carrots).
+> 
+> جزء من هذا القسم يستند [django-marcador tutorial](http://django-marcador.keimlink.de/) المرخص لها بمرخصة بموجب المشاع الإبداعي   إسناد-على غرار 4.0 الترخيص الدولي. البرنامج التعليمي django-marcador حقوق الطبع والنشر من قبل Markus Zapke-Gründemann وآخرون.
+
+سنقوم بإنشاء مدونة صغيرة!
+
+الخطوة الأولى هي إنشاء مشروع جانغو جديد. في الأساس، وهذا يعني أننا سوف نشغل بعض البرامج النصية التي تقدمها جانغو والتي من شأنها أن تخلق الهيكل العظمي لمشروع دجانغو بالنسبة لنا. هذه مجرد حفنة من الدلائل والملفات التي سوف نستخدمها في وقت لاحق.
+
+أسماء بعض الملفات والدلائل مهمة جداً لجانغو. يجب عدم إعادة تسمية الملفات التي نحن على وشك إنشائها. نقلهم إلى مكان مختلف ليست فكرة جيدة. جانغو تحتاج إلى الحفاظ على بنية معينة لتكون قادرة على العثور على أشياء مهمة.
+
+> تذكر أن تقوم بتشغيل كل شيء في virtualenv. إذا كنت لا ترى بادئة `(myvenv)` في وحدة التحكم الخاصة بك، تحتاج إلى تنشيط virtualenv الخاص بك. قمنا بشرح طريقة فعل ذالك في **Django installation** في قسم **Working with virtualenv**. كتابة `myvenv\Scripts\activate` في وندوز ، او `source myvenv/bin/activate` في ماك ولينكس سيقوم لك بذالك.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+في وحدة التحكم الخاصة بك ماكنتوش أو لينكس، يجب أن تقوم بتشغيل الأمر التالي. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> الفاصلة `.` أمر بالغ الأهمية لأنه يخبر السكريبت لتثبيت دجانغو في الدليل الحالي الخاص بك (`.` الفاصلة هي إشارة قصيرة).
+> 
+> **ملاحظة** عند كتابة الأمر أعلاه، تذكر أن تكتب فقط الجزء الذي يبدأ ب `django-admin`. الجزء `(myvenv) ~/djangogirls$` الموضح هنا هو مجرد مثال من الموجه الذي سيدعو المدخلات الخاصة بك على سطر الأوامر الخاص بك.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+في وحدة التحكم الخاصة بوندوز، يجب أن تقوم بتشغيل الأمر التالي. **Don't forget to add the period (or dot) `.` at the end!**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> الفاصلة `.` أمر بالغ الأهمية لأنه يخبر السكريبت لتثبيت دجانغو في الدليل الحالي الخاص بك (`.` الفاصلة هي إشارة قصيرة).
+> 
+> **ملاحظة** عند كتابة الأمر أعلاه، تذكر أن تكتب فقط الجزء الذي يبدأ ب `django-admin.py`. الجزء (myvenv) C:\Users\Name\djangogirls>` الموضح هنا هو مجرد مثال من الموجه الذي سيدعو المدخلات الخاصة بك على سطر الأوامر الخاص بك.
+
+<!--endsec-->
+
+`django-admin.py` هو البرنامج النصي الذي سينشئ الدلائل والملفات بالنسبة لك. يجب أن يكون لديك الآن هيكل دليل يشبه هذا:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **ملاحظة** في بنية الدليل، سترى أيضا `venv` الذي أنشأناه من قبل.
+
+`manage.py` هو سكريبت يساعد في إدارة الموقع. مع أنه سوف نتمكن من (ضمن أمور أخرى) لبدء تشغيل خادم الويب على جهاز الكمبيوتر بدون تثبيت أي شيء آخر.
+
+يحتوي الملف `settings.py` على إعدادات موقعك.
+
+تذكر عندما تكلمنا عن ساعي البريد الذي يبحث اين يرمي الرسائل? `urls.py` ملف يحتوي على قائمة أنماط مستخدمة من قبل `urlresolver`.
+
+دعونا نتجاهل الملفات الأخرى في الوقت الراهن فنحن لن نغييرها. الشيء الوحيد الذي يجب تذكره هو عدم حذفها عن طريق الصدفة!
+
+## تغيير الإعدادات
+
+دعونا نجري بعض التغييرات في `mysite/settings.py`. قم بفتح الملف باستخدام محرر التعليمات البرمجية يالذي قمنا بتثبيته في وقت سابق.
+
+**ملاحظة**: ضع في اعتبارك أن `settings.py` هو ملف عادي، مثل أي ملف آخر. يمكنك فتحه من داخل محرر التعليمات البرمجية، وذلك باستخدام "ملف > فتح" قائمة الإجراأت. سيؤدي هذا بك إلى الحصول على النافذة المعتادة التي يمكنك فيها الانتقال إلى ملف `settings.py` وتحديده. بدلا من ذلك، يمكنك فتح الملف عن طريق الانتقال إلى مجلد djangogirls على سطح المكتب الخاص بك والنقر بزر الماوس الأيمن عليه. ثم، حدد محرر التعليمات البرمجية الخاصة بك من القائمة. اختيار المحرر مهم كما قد يكون لديك برامج أخرى مثبتة يمكنها فتح الملف ولكن لن تسمح لك بتحريره.
+
+سيكون من الجميل أن يكون الوقت صحيح على موقعنا على الانترنت. اذهب الى [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) وانسخ الوقت في منطقتك الزمنية (TZ) (e.g. `Europe/Berlin`).
+
+في `settings.py`، أعثر على السطر الذي يحتوي على `TIME_ZONE` وعدله لاختيار المنطقة الزمنية الخاصة بك. على سبيل المثال:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+كود لغة يتكون من لغة، مثل `en` للغة الإنكليزية أو `de` للالمانية، ورمز البلد، مثل `de` لألمانيا أو `ch` لسويسرا. سوف تحتاج إلى إضافة هذا إذا كنت تريد الأزرار الافتراضية والإخطارات من جانغو أن تكون بلغتك. لذلك سيكون لديك زر "إلغاء" ترجم إلى اللغة التي حددتها هنا. [جانغو يأتي مع الكثير من الترجمات ](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+تغيير رمز اللغة عن طريق تغيير السطر التالي:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+سوف نحتاج أيضا إلى إضافة مسار للملفات الثابتة. ( سوف نعرف كل شيء عن الملفات الثابتة والمغلقة في وقت لاحق في البرنامج التعليمي). الانتقال إلى أسفل إلى *end* الملف، وتحت `STATIC_URL`، أضف وحدة جديدة تسمى `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+عندما يكون `DEBUG` هو `True` و `ALLOWED_HOSTS</ 0> فارغ، يتم التحقق من المضيف مع <code>['localhost', '127.0.0.1', '[::1]']`. هذا لن يطابق اسم المضيف لدينا على PythonAnywhere بمجرد نشر التطبيق لدينا لذلك سوف نقوم بتغيير الإعداد التالي:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **ملاحظة**: إذا كنت تستخدم Chromebook، أضف هذا السطر في الجزء السفلي من الملف settings.py: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> اضف ايضا `.c9users.io` الى `ALLOWED_HOSTS` اذا كنت تستخدم cloud9
+
+## إعداد قاعدة البيانات
+
+هناك الكثير من برامج قواعد البيانات المختلفة التي يمكنها تخزين البيانات لموقعك. سنستخدم الإعداد الافتراضي، `sqlite3`.
+
+تم إعداد هذا بالفعل في هذا الجزء الخاص بك من الملف `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+لإنشاء قاعدة بيانات مدونتنا، دعونا تشغل الأمر التالي في وحدة التحكم: `python manage.py migrate`(نحن بحاجة إلى أن تكون في الدليل `djangogirls` الذي يحتوي على الملف `manage.py`. اذا مر كل شيء على ما يرام، سترى شيئا مثل هذا:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+ها قد انتهينا! حان الوقت لتشغيل خادم الويب ومعرفة ما إذا كان موقعنا يعمل!
+
+## بدء تشغيل خادم الويب
+
+يجب أن تكون في الدليل الذي يحتوي على ملف `manage.py`(دليل `djangogirls`). في وحدة التحكم، يمكننا أن نبدأ خادم الويب بتشغيل `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+إذا كنت في كروم بوك، استخدم هذا الأمر بدلاً من ذلك:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+إذا كنت على ويندوز، و فشل هذا مع `UnicodeDecodeError`, ، استخدم هذا الأمر بدلاً من ذلك:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+الآن كل ما عليك القيام به هو الاختيار الذي يقوم بتشغيل موقع الويب الخاص بك. قم بفتح المتصفح (فايرفوكس، كروم، سفاري، إنترنت إكسبلورر أو مهما كنت تستخدم) وأدخل هذا العنوان:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+إذا كنت تستخدم Chromebook، عليك دائماً زيارة خادم الاختبار الخاص بك عن طريق الوصول إلى:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+تهانينا! قمت بإنشاء موقعك الأول وتشغيله باستخدام خادم الويب! أليس هذا رائع؟
+
+![إنه كان مجديًا!](images/it_worked2.png)
+
+بينما يتم تشغيل خادم الويب، لن تشاهد موجه سطر أوامر جديدة لإدخال أوامر إضافية. لوحة التحكم تقبل نصوص جديدة ولكن لن يتم تنفيذ الأوامر الجديدة. وهذا لأن خادم الويب يعمل بشكل مستمر للاستماع للطلبات الواردة.
+
+> لقد استعرضنا كيف تعمل خادمات الويب في الفصل **How the Internet works**.
+
+لكتابة أوامر إضافية أثناء تشغيل خادم الويب، افتح نافذة طرفية جديدة وقم بتنشيط virtualenv الخاص بك. لإيقاف خادم الويب، قم بالتبديل مرة أخرى إلى النافذة التي يتم تشغيلها واضغط على CTRL+C - مفاتيح التحكم و C معا (على ويندوز، قد تضطر إلى الضغط على Ctrl+Break).
+
+أنت مستعد للخطوة التالية؟ لقد حان الوقت لإنشاء بعض المحتوى!
\ No newline at end of file
diff --git a/ar/django_templates/README.md b/ar/django_templates/README.md
new file mode 100644
index 00000000000..844a153d6ba
--- /dev/null
+++ b/ar/django_templates/README.md
@@ -0,0 +1,106 @@
+# قوالب دجانغو
+
+حان الوقت لكي نظهر بعض المعلومات! جانغو يعطينا بعضا من شعارات القوالب المفيدة المثبتة فية.
+
+## ما هي شعارات القوالب؟
+
+كما تعرف في لغة الHTML لا يمكنك كتابة كود مكتوب بلغة Python وذلك لأن متصفحات الانترنت لا تفهمة. المتصفحات تفهم الHTML فقط. نحن نعلم أن الHTML نوعا ما جامدة لكن الPython أكثر ديناميكية.
+
+**Django template tags** تسمح لنا بنقل أشياء مثل بيثون إلى HTML، حتى نتمكن من بناء مواقع ديناميكية بشكل أسرع. رائع!
+
+## عرض قالب قائمة المشاركات
+
+في الفصل السابق، قدمنا لقالبنا قائمة بالمشاركات في متغير `posts`. الآن سوف نقوم بعرضه في HTML.
+
+لطباعة متغير في قوالب جانغو، نحن نستخدم أقواس مزدوجة مع اسم المتغير في الداخل، هكذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+جرب هذا في قالبك `blog/templates/blog/post_list.html`. استبدل كل شيء من `<div>` الثاني الى `</div>` الثالت ب `{{ posts }}`. قم بحفظ الملف، وقم بتحديث الصفحة لمشاهدة النتائج:
+
+![الرقم 13.1](images/step1.png)
+
+كما ترون، كل ما لدينا هو هذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+هذا يعني أن جانغو يفهم ذلك كقائمة من الكائنات. هل تتذكر من **Introduction to Python** كيف نضهر القوائم؟ نعم، مع حلقات! في قالب جانغو يمكنك القيام بها هكذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+جرب هذا في قالبك.
+
+![الرقم 13.2](images/step2.png)
+
+إنه كان مجديًا! ولكننا نريد أن يتم عرض المشاركات مثل المشاركات الثابتة التي أنشأناها سابقا في فصل **مقدمة إلى HTML**. يمكنك خلط علامات HTML والقالب. `body` سيبدو هكذا:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %} كل شيء تضعه بين `{% for %}` و `{% endfor %}` سوف يتكرر لكل كائن في القائمة. حدث الصفحة:{% endraw %}
+
+![الرقم 13.3](images/step3.png)
+
+هل لاحظت أننا استخدمنا تدوين مختلف قليلا هذه المرة (`{{ post.title }}` او `{{ post.text }})`؟ يمكننا الوصول إلى البيانات في كل حقل من الحقول المعرفة في نموذج `Post`. ايضا `|linebreaksbr` يربط نص المشاركات من خلال مرشح لتحويل فواصل الأسطر إلى فقرات.
+
+## شيء واحد آخر
+
+سيكون جيدا معرفة ما إذا كان موقع الويب الخاص بك لا يزال يعمل على شبكة الإنترنت العامة، اليس كذالك؟ دعونا نحاول نشره في PythonAnywhere مرة أخرى. هنا خلاصة للخطوات…
+
+* أولاً، ادفع التعليمات البرمجية الخاصة بك إلى Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* افتح [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) واذهب الى **Bash console** او افتح واحدة جديدة وشغل هذا الأمر:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* وأخيرا، انتقل إلى علامة التبويب [Web tab](https://www.pythonanywhere.com/web_app_setup/) واضغط على **Reload**. على تطبيق الويب. يجب أن يكون التحديث مباشر! إذا كانت مشاركات المدونة على موقع PythonAnywhere لا تتطابق مع المشاركات التي تظهر على المدونة المستضافة على الخادم المحلي، فلا بأس بذالك. قواعد البيانات على جهاز الكمبيوتر المحلي وبايثون في أي مكان لا يتزامنان مع بقية الملفات الخاصة بك.
+
+مبروك! الآن امضي قدما وحاول إضافة مشاركة جديدة عبر إدارة جانغو الخاصة بك (تذكر لإضافة publication_date!) تأكد من أنك في إدارة جانغو لموقع pythonanywhere الخاص بك، https://yourname.pythonanywhere.com/admin. ثم حدث الصفحة لمعرفة ما إذا كانت المشاركة تظهر هناك أم لا.
+
+تعمل كالحصان ! نحن فخورون بك ، ابتعد قليلا عن الحاسوب الخاص بك ، انت تستحق استراحة
+
+![الرقم 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ar/django_urls/README.md b/ar/django_urls/README.md
new file mode 100644
index 00000000000..b26e948e011
--- /dev/null
+++ b/ar/django_urls/README.md
@@ -0,0 +1,129 @@
+# روابط دجانغو
+
+نحن على وشك بناء صفحتنا الأولى على الأنترنت: الصفحة الرئيسية لمدونتك! ولكن أولاً، دعونا نتعلم قليلاً عن "روابط مواقع جانغو".
+
+## ما هو عنوان URL؟
+
+ببساطة URL هو عنوان ويب. يمكنك أن ترى عنوان URL في كل مرة تقوم بزيارة موقع على شبكة الإنترنت--أنها مرئية في شريط العناوين في المتصفح الخاص بك. (نعم! `127.0.0.1:8000` هو عنوان URL! و `https://djangogirls.org` أيضا عنوان URL)
+
+![عنوان Url](images/url.png)
+
+كل صفحة على شبكة الإنترنت تحتاج إلى عنوان URL الخاص بها. وبهذه الطريقة التطبيق الخاص بك يعلم ما يجب أن يظهر للمستخدم الذي يقوم بفتح عنوان URL هذا. في جانغو نستخدم ما يسمى `URLconf` (URL configuration). URLconf هو مجموعة من الأنماط التي ستحاول جانغو مطابقتها مع عنوان URL المطلوب للعثور على طريقة العرض الصحيح.
+
+## كيف تعمل عناوين Url في جانغو؟
+
+دعونا نفتح الملف `mysite/urls.py` في محرر التعليمات البرمجية الخاصة بك للاختيار ونرى ما يبدو عليه:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+كما ترون، جانغو قد وضعت بالفعل شيء هنا بالنسبة لنا.
+
+الخطوط بين علامات الاقتباس الثلاثي (`'' '` أو `"""`) تسمى docstrings – ييمكنك كتابتها في أعلى ملف أو فئة أو طريقة لوصف ما يفعله. هي لا تعمل عبر بايثون.
+
+عنوان URL المشرف، الذي زرته في الفصل السابق، موجود هنا:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+هذا السطر يعني أن لكل عنوان URL الذي يبدأ ب `admin/`، سوف تجد جانغو مقابله *view*. في هذه الحالة نحن ، نضع الكثير من روابط المشرفين ، لذالك هي ليست مجموعة كلها في هذا الملف الصغير ، انها اكثر قابلية للقراءة وانضف.
+
+## Regex
+
+هل كنت تتساءل كيف تطابق جانغو عناوين Url للواجهات ؟ حسنا، هذا الجزء صعب. يستخدم جانغو `regex`، اختصار ل "التعبيرات العادية". Regex لديه الكثير (الكثير!) من القواعد التي تشكل نمط بحث. بما ان regexes موضوع متقدم، نحن لن تمر بالتفصيل على كيفية عمله.
+
+إذا كنت لا تزال ترغب معرفة كيف قمنا بإنشاء الأنماط، هنا مثال للعملية – سوف نحتاج فقط مجموعة فرعية محدودة من القواعد للتعبير عن النمط الذي نتطلع اليه وهي:
+
+* `^` في بداية النص
+* `$` في نهاية النص
+* `\d` لرقم
+* `+` للإشارة إلى أن العنصر السابق ينبغي أن يتكرر مرة واحدة على الأقل
+* `()` لالتقاط جزء من النمط
+
+أي شيء آخر في تعريف عنوان URL سوف تؤخذ حرفيا.
+
+الآن تخيل أن لديك موقع على شبكة الإنترنت بعنوان مثل `http://www.mysite.com/post/12345/`، حيث يكون `12345` هو عدد مشاركاتك.
+
+كتابة آراء منفصلة لجميع أرقام المشاركات سيكون مزعج حقاً. مع التعابير العادية، يمكننا إنشاء الأنماط التي تتطابق مع عنوان URL واستخراج العدد لنا: `^ post/(\d+)/$`. دعونا نكسر هذا قطعة قطعة لمعرفة ما نقوم به هنا:
+
+* **^post/** تخبر دجانغو عن اتخاذ أي شيء يحتوي على `post/` في بداية عنوان url (مباشرة بعد `^`)
+* **(\d+)** يعني أنه سيكون هناك عدد (رقم واحد أو أكثر)، وأننا نريد الرقم الذي تم التقاطه واستخراجه
+* **/** يخبر دجانغو أن حرف آخر `/` يجب أن يتبع
+* **$** يشير إلى نهاية عنوان url الخاص بمعنى أن السلاسل التي تنتهي مع `/` سوف تتطابق مع هذا النمط
+
+## عنوان URL جانغو الأول!
+
+حان الوقت لإنشاء URL الأول لدينا! ونحن نريد 'http://127.0.0.1:8000/' لتكون الصفحة الرئيسية لمدونتنا وتعرض قائمة من المشاركات.
+
+نريد أيضا الاحتفاظ بالملف `mysite/urls.py` نظيف، حيث أننا سوف نسترد عناوين Url من تطبيق `blog` لدينا إلى الملف الرئيسي `mysite/urls.py`.
+
+امضي قدما ،واضع هذا السطر الذي سيسترد `blog.urls`.. لاحظ أننا نستخدم الدالة `include` هنا، لذا ستحتاج إلى إضافة هذا الاستيراد.
+
+الآن يجب أن تبدو الملف `mysite/urls.py` الخاص بك مثل هذا:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+جانغو سيقوم بإعادة توجيه كل شيء يأتي في 'http://127.0.0.1:8000/' إلى`blog.urls` والبحث عن مزيد من التعليمات هناك.
+
+يتم كتابة التعبيرات العادية في بايثون دائماً مع `r` أمام السلسلة. هذا تلميح مفيد لبايثون أن السلسلة قد تحتوي على الأحرف الخاصة التي ليست معنية ببايثون نفسه، ولكن للتعبير العادي بدلاً من ذلك.
+
+## روابط المدونة
+
+قم بإنشاء ملف فارغ جديد يسمى `urls.py` في الدليل `blog`. حسنًا! أضف هذه الأسطر الأولى والثانية:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+نحن هنا نستورد وضائف دجانغو `url` وجميع `views` من تطبيق `blog` (ليس لدينا أي حتى الآن، ولكننا سوف نحصل على ذلك في دقيقة واحدة)
+
+بعد ذلك، يمكننا أن نضيف لدينا نمط URL الأول:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+كما ترون، نحن الآن تعيين طريقة `عرض` تسمى `post_list` `^ $` لعنوان URL. هذا التعبير العادي وسيطابق `^` (بداية) تليها `$` (نهاية) – لذلك سلسلة فارغة فقط سوف تتطابق. وهذا صحيح، لأن في URL جانغو resolvers، 'http://127.0.0.1:8000/' ليست جزءا من عنوان URL. سيعلم هذا النمط دجانغو أن `views.post_list` هو المكان المناسب للذهاب إليه إذا دخل شخص ما موقعك على الويب على العنوان "http://127.0.0.1:8000/".
+
+الجزء الأخير، `name='post_list'`, هو اسم عنوان URL الذي سيتم استخدامه لتحديد طريقة العرض. وهذا يمكن أن يكون نفس اسم العرض ولكن أيضا يمكن أن يكون شيئا مختلفاً تماما. سنستخدم عناوين URLs المسماة لاحقا في المشروع، لذلك من المهم تسمية كل عنوان URL في التطبيق. يجب أن نحاول أيضا الحفاظ على أسماء عناوين URL فريدة وسهلة التذكر.
+
+إذا حاولت زيارة http://127.0.0.1:8000/ الآن، ستجد نوعا من رسائل الخطأ "صفحة ويب غير متوفرة". وذلك لأن الخادم (تذكر كتابة `runserver`?) لم يعد قيد التشغيل. ألق نظرة على نافذة وحدة تحكم الخادم لمعرفة السبب.
+
+![خطأ](images/error1.png)
+
+تعرض وحدة التحكم الخاصة بك خطأ، ولكن لا تقلق - إنها مفيدة حقا: إنها تخبرك بوجود **no attribute 'post_list'**. هذا هو اسم *view* الذي تحاول جانغو العثور عليه واستخدامه، ولكن لم نقم بإنشاءه بعد. في هذه المرحلة، لن يعمل `/admin/` أيضا. لا تقلق – سوف نصل إلى هناك.
+
+> إعرف المزيد حول URLconfs من خلال قراءة الوثائق الرسمية: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/ar/django_views/README.md b/ar/django_views/README.md
new file mode 100644
index 00000000000..40910a5905e
--- /dev/null
+++ b/ar/django_views/README.md
@@ -0,0 +1,43 @@
+# وجهات نظر جانغو -وقت الإنشاء!
+
+حان الوقت للتخلص من الشوائب التي انشأناها في الفصل الأخير! :)
+
+*view* هو المكان الذي وضعنا فيه المنطق الخاص بتطبيقنا. وسوف تطلب معلومات من `model` قمت بإنشائها من قبل وتمريرها إلى `template`. سوف ننشئ قالب في الفصل التالي. وجهات النظر هي مجرد وظائف بيثون والتي هي اكثر تعقيد قليلا من التي قمنا بكتابتها في هذا الفصل **مقدمة بيثون**.
+
+Views توضع في الملف `views.py`. وسوف نضيف *views* الخاصة بنا الى `blog/views.py`.
+
+## blog/views.py
+
+حسنا، دعونا نفتح هذا الملف، ونرى ما هو في موجود:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+من django.shortcuts استرد المحول
+إنشاء طرق العرض الخاصة بك هنا.
+```
+
+ليس هناك كثيرا من الأشياء هنا حتى الآن.
+
+تدكر ان الأسطر التي تبدأ ب`#` هي مجرد تعليقات وهذا يعني انها لن يتم استخدامها عبر بايثون.
+
+دعونا ننشء *view * كما يوحي التعليق. أضف الأسطر التالية أدناه:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+كما ترون، أنشأنا دالة (`def`) يسمى `post_list` يأخذ `request` و `return` وظيفة `render` التي ستكون (مجتمعة) لدينا قالب `blog/post_list.html`.
+
+قم بحفظ الملف، انتقل إلى http://127.0.0.1:8000/وانظر ماذا لدينا.
+
+خطأ آخر! اقرأ ما يجري الآن:
+
+![خطأ](images/error.png)
+
+هذا يبين أن الملقم قيد التشغيل مرة أخرى، على الأقل، ولكن لا يزال يبدو وكأنه ليس على ما يرام أليس كذالك؟ لا تقلق، انها مجرد صفحة خطأ، لا تخف! تماما مثل رسائل الخطأ في وحدة التحكم، هذه في الواقع مفيدة جدا. يمكن أن تقرأ أن*TemplateDoesNotExist*. دعونا نصلح هذا الخطأ وننشئ قالب في الفصل التالي!
+
+> إعرف المزيد حول آراء جانغو من خلال قراءة الوثائق الرسمية: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/ar/dynamic_data_in_templates/README.md b/ar/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/ar/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/ar/extend_your_application/README.md b/ar/extend_your_application/README.md
new file mode 100644
index 00000000000..9ee70d41a57
--- /dev/null
+++ b/ar/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# توسيع التطبيق الخاص بك
+
+لقد أنجزنا فعلا جميع الخطوات المختلفة اللازمة لإنشاء موقعنا على الإنترنت: نحن نعرف كيفية كتابة نموذج، url وطريقة العرض والقالب. نحن نعلم أيضا كيفية جعل موقع الويب الخاص بنا جميلا.
+
+حان الوقت للتدريب!
+
+أول شيء نحتاجه في مدونتنا هو، على الأرجح، صفحة لعرض مشاركة واحدة، أليس كذلك؟
+
+لدينا بالفعل نموذج `Post` ، حتى لا تحتاج إلى إضافة أي شيء إلى `models.py`.
+
+## إنشاء رابط نموذج لتفاصيل المشاركة
+
+سوف نبدأ بإضافة رابط داخل الملف `blog/templates/blog/post_list.html`. حتى الآن ينبغي له ان يبدو هكذا:{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %} نريد الحصول على رابط من عنوان المشاركة في قائمة المشاركات إلى صفحة تفاصيل المشاركة. دعونا نغيير `<h1><a href="">{{ post.title }}</a></h1>` بحيث يرتبط بصفحة تفاصيل المشاركة :{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %} حان الوقت لشرح `{% url 'post_detail' pk=post.pk %}`. كما قد تضن، فإن `{% %}` يعني أننا نستخدم علامات قالب جانغو. هذه المرة سوف نستخدم واحد واحد منهم والذي سيقوم بإنشاء عنوان URL لنا!{% endraw %}
+
+`post_detail` يعني أن جانغو سيتوقع عنوان URL في `blog/urls.py` ب name=post_detail
+
+وماذا عن `pk=post.pk`؟ `pk` هو اختصار للمفتاح الأساسي، وهو اسم فريد لكل سجل في قاعدة البيانات. ونظرا لأننا لم نحدد مفتاحا أساسيا في نموذج `Post`، فإن دجانغو ينشئ واحدا لنا (بشكل افتراضي، وهو رقم يزيد بمقدار واحد لكل سجل، أي 1 و 2 و 3) ويضيفه كحقل يدعى`pk` إلى كل من مشاركاتنا. نصل إلى المفتاح الأساسي من خلال كتابة `post.pk`,، بنفس الطريقة التي نصل بها إلى الحقول الأخرى (`title`, `author`, etc.) في `Post`!
+
+الآن عندما ننتقل إلى http://127.0.0.1:8000/ سيكون لدينا خطأ (كما هو متوقع، نظرا لأنه لا يوجد لدينا عنوان URL أو *view* ل `post_detail`). وسوف تبدو كما يلي:
+
+![خطأ NoReverseMatch](images/no_reverse_match2.png)
+
+## إنشاء عنوان URL لتفاصيل المشاركة
+
+لنقم بإنشاء عنوان URL في `urls.py` من اجل `post_detail` *view*!
+
+نريد عرض تفاصيل المشاركة الأولى على هذا العنوان **URL**: http://127.0.0.1:8000/post/1/
+
+دعونا ننشئ عنوان URL في ملف `blog/urls.py` لتوجيه دجانغو إلى *view* باسم `post_detail`,، سيتم عرض إحدى المشاركات بأكملها. أضف السطر `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` إلى الملف `blog/urls.py`. الآن يجب أن يبدو الملف الخاص بك مثل هذا:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+هذا الجزء `^post/(?P<pk>\d+)/$` يبدو مخيفا، ولكن لا تقلق – سوف نشرح لك:
+
+- أنه يبدأ ب `^` مرة أخرى – "البداية".
+- `post/` يعني فقط أنه بعد البداية، يجب أن يحتوي عنوان URL على كلمة **post** و **/**. حتى الان جيد جدا.
+- `(?P<pk>\d+)` -هذا الجزء أصعب. وهذا يعني أن جانغو سوف تأخذ كل ما تضعه هنا وتنقله إلى عرض كمتغير يسمى `pk`. (لاحظ أن هذا يطابق الاسم الذي قدمناه لمتغير المفتاح الأساسي مرة أخرى في `blog/templates/blog/post_list.html`!) `\d` يخبرنا أيضا أنه يمكن أن يكون فقط رقم، وليس حرف ( كل شيء بين 0 و 9). `+` يعني أن هناك حاجة إلى رقم واحد أو أكثر هناك. شيء مثل `http://127.0.0.1:8000/post//` غير صالح، ولكن `http://127.0.0.1:8000/post/1234567890/` هو جيد تماما!
+- `/` – وبعدها نحتاج **/** مرة اخرى.
+- `$` – "نهاية"!
+
+هذا يعني إذا قمت بإدخال `http://127.0.0.1:8000/post/5/` في المتصفح، جانغو ستفهم انك تبحث عن *view* تسمى `post_detail` ونقل معلومة أن `pk` تساوي `5` إلى ذالك *view*.
+
+حسنا، لقد أضفنا نمط عنوان URL جديد إلى `blog/urls.py`! دعونا نقم بتحديث الصفحة http://127.0.0.1:8000/ بوم! توقف الخادم عن العمل مرة أخرى. ألقي نظرة على وحدة التحكم – كما هو متوقع، هناك خطأ آخر!
+
+![AttributeError](images/attribute_error2.png)
+
+هل تذكر ما الخطوة التالية؟ بطبيعة الحال: إضافة طريقة عرض!
+
+## إضافة مشاركة لعرض التفاصيل
+
+هذه المرة لدينا *view* تعطي معلمة إضافية، `pk`. *view* تحتاج الى القبض عليه ، اليس كذالك؟ لذا فإننا سوف نحدد وظيفتنا ك `def post_detail(request, pk):`. لاحظ أننا بحاجة إلى استخدام نفس الاسم بالضبط الذي حددناه في عناوين urls (`pk`). حذف هذا المتغير غير صحيح وسوف ينتج خطأ!
+
+الآن، نريد الحصول على مشاركة مدونة واحدة فقط. لإجراء ذلك، يمكننا استخدام مجموعة طلبات بحث، كما يلي:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+ولكن توجد مشكلة في التعليمات البرمجية هذه. إذا لم يكن هناك `Post` بعينها `primary key` (`pk`) سيكون لدينا خطأ سوبر قبيح!
+
+![خطأ DoesNotExist](images/does_not_exist2.png)
+
+نحن لا نريد ذلك! ولكن، بطبيعة الحال، جانغو تأتي بشيء أنها ستعالج ذلك لنا:: `get_object_or_404`. في حالة عدم وجود `Post` مع `pk`,، سيعرض صفحة أجمل بكثير، صفحة `Page Not Found 404`.
+
+![الصفحة غير موجودة](images/404_2.png)
+
+والخبر السار هو أنه يمكنك فعلا إنشاء صفحة `Page not found` الخاصة بك وجعلها جميلة كما تريد. لكنها ليست مهمة الأن ، لذالك سوف نتخطاها.
+
+طيب، حان الوقت لإضافة *view* لملف `views.py` لدينا!
+
+في `blog/urls.py` أنشأنا قاعدة عنوانURL اسمها `post_detail` تشير إلى ملف شخصي يسمى `views.post_detail`. وهذا يعني أن جانغو تتوقع عرض دالة تسمى `post_detail` داخل `blog/views.py`.
+
+ينبغي أن نفتح `blog/views.py` وإضافة التعليمة البرمجية التالية بالقرب `from` من الخطوط الأخرى:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+وفي نهاية الملف سوف نقوم بإضافة *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+نعم. لقد حان الوقت لتحديث الصفحة: http://127.0.0.1:8000/
+
+![عرض قائمة المشاركات](images/post_list2.png)
+
+إنه كان مجديًا! ولكن ماذا يحدث عندما تقوم بالنقر فوق رابط في عنوان احدى المشاركات على المدونة؟
+
+![خطأ TemplateDoesNotExist](images/template_does_not_exist2.png)
+
+أوه لا! خطأ آخر! ولكن نحن نعلم بالفعل كيفية التعامل معه، اليس كذالك؟ نحن بحاجة لإضافة قالب!
+
+## إنشاء قالب لتفاصيل المشاركة
+
+سننشئ ملفا في `blog/templates/blog` يسمى `post_detail.html`.
+
+ستبدو كالشكل التالي:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+مرة أخرى نحن نوسع `base.html`. في الكتلة `content` نريد عرض تاريخ نشر المشاركة (إذا كان موجودا) والعنوان والنص. ولكن يجب أن نناقش بعض الأمور الهامة، اليس كذالك؟
+
+إذا... {% raw %} `{%... %} ... {% endif %}` هو علامة قالب يمكن أن نستخدمها عندما نريد أن تحقق شيئا. (تذكر `إذا... ايضا. ` من فصل **Introduction to Python** ؟) في هذا السيناريو، نريد التحقق مما إذا كان `published_date` غير فارغ. {% endraw %}
+
+حسنا، يمكننا تحديث الصفحة ومعرفة ما إذا كان `TemplateDoesNotExist` قد انتهى الآن.
+
+![صفحة تفاصيل المشاركة](images/post_detail2.png)
+
+ياي! إنه يعمل!
+
+## شيء اخر: أنشر الوقت!
+
+سيكون من الجيد معرفة ما إذا كان موقع الويب الخاص بك لا يزال يعمل على PythonAnywhere، أليس كذلك؟ دعونا نحاول النشر مرة أخرى.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+وبعد ذلك، في وحدة [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+وأخيرا، انتقل إلى علامة التبويب [Web tab](https://www.pythonanywhere.com/web_app_setup/) واضغط على **Reload**.
+
+هذا ينبغي ان يكون كل شيء! مبروك:)
\ No newline at end of file
diff --git a/ar/how_the_internet_works/README.md b/ar/how_the_internet_works/README.md
new file mode 100644
index 00000000000..ac559adb2e6
--- /dev/null
+++ b/ar/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# كيف تعمل الإنترنت
+
+> للقراء في المنزل: هذا الفصل تم التكلم عنه في [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> هذا الفصل مستوحى من حديث "كيف تعمل شبكة الإنترنت" جيسيكا مك كيلار (http://web.mit.edu/jesstess/www/).
+
+نحن نراهن انك تستخدم الأنترنت كل يوم. ولكن هل تعرف فعلا ما يحدث عند كتابة عنوان مثل https://djangogirls.org في متصفحك والضغط على `enter`؟
+
+اول شيء يجب ان تعرفه هو ان المواقع هي مجرد مجموعة من الملفات محفوضة في اقراص تخزين صلبة. تماما مثل الأفلام، والموسيقى، أو الصور. ومع ذلك، هناك جزء واحد فريد للمواقع: وهي تعليمات كمبيوتر برمجية تسمى HTML.
+
+إذا كنت لا تعرف البرمجة فإنه سيكون من الصعب فهم HTML في البداية، ولكن متصفحات الويب الخاص بك (مثل كروم، سفاري، فايرفوكس، الخ) تحبها. تم تصميم متصفحات الويب لفهم هذا الكود، اتباع التعليمات الخاصة به، وتقديم هذه الملفات التي تشكل موقع الويب الخاص بك، بالطريقة التي تريدها.
+
+كما هو الحال مع كل ملف، نحن بحاجة إلى تخزين ملفات HTML في مكان ما على قرص الثابت. بالنسبة إلى الإنترنت، نستخدم أجهزة كمبيوتر خاصة وقوية تسمى *خوادم*. أنهم لا يملكون شاشة أو ماوس أو لوحة مفاتيح، لأن الغرض الرئيسي منها هو لتخزين البيانات وخدمتها. لذالك يسمون *servers* لأنهم *serve* خدم ينقلون بياناتك.
+
+حسنا! لكنك تريد ان ترى كيف تعمل الأنترنت أليس كذالك؟
+
+لقد رسمنا لك صورة ، ستبدو هكذا:
+
+![الرقم 1.1](images/internet_1.png)
+
+تبدو كفوضى ، اليس كذالك؟ في الواقع هي شبكة أجهزة متصلة (*ملقمات* المشار إليها أعلاه). مئات الآلاف من آلات! كيلومترات عديدة من الكابلات حول العالم! يمكنك زيارة موقع "خريطة غواصات الكابلات" (http://submarinecablemap.com) لمعرفة مدى تعقيد الشبكة. هنا لقطة شاشة من الموقع:
+
+![الرقم 1.2](images/internet_3.png)
+
+أنها رائعة، أليس كذلك؟ ولكن من الواضح أنه من غير الممكن أن يكون هناك سلك بين كل جهاز متصل بالإنترنت. إذا ، للوصول إلى جهاز (على سبيل المثال، حيث يتم حفظ https://djangogirls.org) نحن بحاجة لتمرير طلب من خلال آلات مختلفة كثيرة.
+
+ستبدو كالشكل التالي:
+
+![الرقم 1.3](images/internet_2.png)
+
+تخيل عند كتابة https://djangogirls.org، يمكنك إرسال رسالة تقول: "عزيزي جانغو الفتيات، أريد أن أرى الموقع djangogirls.org. أرسله لي، رجاء! "
+
+رسالتك تذهب إلى مكتب البريد الأقرب إليك. ثم تذهب إلى آخر أقرب قليلا إلى المرسل إليه، ثم إلى آخر، وآخر حتى يتم تسليمها إلى وجهتها. الشيء الفريد هنا إذا قمت بإرسال العديد من الرسائل (*حزم البيانات*) إلى نفس المكان، يمكن أن تذهب من خلال مكاتب بريد مختلفة تماما (*أجهزة التوجيه*). وهذا يعتمد على كيفية التوزيع في كل مكتب.
+
+![الرقم 1.4](images/internet_4.png)
+
+هذه هي طريقة عملها يمكنك إرسال الرسائل وتتوقع بعض الاستجابة. وبطبيعة الحال، بدلا من الورق والقلم يتم استخدام بيتات من البيانات، ولكن الفكرة هي نفسها!
+
+بدلاً من عناوين مع اسم الشارع، والمدينة، والرمز البريدي واسم البلد، نحن نستخدم عناوين IP. يسأل الكمبيوتر أولاً DNS (نظام اسم المجال) لترجمة djangogirls.org إلى عنوان IP. وهي تعمل قليلا مثل كتب الهاتف القديمة حيث يمكنك البحث عن اسم الشخص الذي تريد الاتصال به والعثور على رقم الهاتف وعنوانه.
+
+عندما تقوم بإرسال رسالة، فإنها تحتاج إلى بعض الميزات لتسليمها بشكل صحيح: عنوان، ختم، إلخ. انت ايضا تستخدم لغة يفهمها المتلقي، اليس كذالك؟ وينطبق نفس الشيء على *حزم البيانات* انت ترسل لترى موقع انترنت. نحن نستخدم بروتوكول يسمى HTTP (بروتوكول نقل النص التشعبي).
+
+لذلك، أساسا، عندما يكون لديك موقع على شبكة الإنترنت، تحتاج إلى يكون لديك *ملقم* (آلة) حيث يعيش. عندما يستلم *الملقم* *طلب* وارد (في رسالة)، يرسل إلى موقع الويب الخاص بك (في رسالة أخرى).
+
+بما ان هذا برنامج تعليمي لدجانغو ، قد تسأل ماذا يفعل دجانغو. عندما تقوم بإرسال استجابة، لا تريد دائماً إرسال نفس الشيء للجميع. من الأفضل بكثير ان تكون احرفك مشخصة، وخاصة للشخص الذي كتب للتو لك، أليس كذلك؟ جانغو يساعدك في إنشاء هذه الرسائل الشخصية، والمثيرة للاهتمام. :)
+
+يكفي الحديث--وقت البناء!
\ No newline at end of file
diff --git a/ar/html/README.md b/ar/html/README.md
new file mode 100644
index 00000000000..1acea5b2f72
--- /dev/null
+++ b/ar/html/README.md
@@ -0,0 +1,213 @@
+# مقدمة إلى HTML
+
+قد تسأل ما هو القالب؟
+
+القالب هو ملف يمكننا إعادة استخدامه لتقديم معلومات مختلفة بتنسيق ثابت - على سبيل المثال، يمكنك استخدام قالب لمساعدتك على كتابة حرف، لأنه على الرغم من أن كل حرف قد يحتوي على رسالة مختلفة ويتم توجيهها إلى شخص مختلف ، وسوف تشترك في نفس الشكل.
+
+تم وصف تنسيق قالب جانغو في لغة تسمى HTML (وهذا هو ال HTML التي ذكرناها في الفصل الأول،**How the Internet works**).
+
+## ما هي HTML؟
+
+HTML هو رمز يتم تفسيره بواسطة متصفح الويب - مثل كروم أو فايرفوكس أو سفاري - لعرض صفحة ويب للمستخدم.
+
+نقصد ب HTML "HyperText Markup Language". **HyperText** هو نص يعتمد على الإرتباطات التشعبية بين الصفحات. **Markup** يعني أننا اتخذنا وثيقة ووضعنا علامة عليها مع رمز لنقول ل (في هذه الحالة، متصفح) كيفية تفسير الصفحة. تم إنشاء شفرة HTML باستخدام علامات **tags**، حيث يبدأ كل منها باستخدام `<` وينتهي ب `>`. تمثل هذه العلامات علامات **elements**.
+
+## قالبك الأول!
+
+إنشاء قالب يعني إنشاء ملف قالب. كل شيء هو ملف، هو؟ ربما كنت قد لاحظت هذا بالفعل.
+
+يتم حفظ قوالب في `blog/templates/blog` الدليل. لذا أولاً أنشئ دليل يسمى `templates` داخل دليل المدونة الخاص بك. قم بإنشاء دليل آخر يسمى `blog` داخل دليل القوالب الخاصة بك:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(قد تتساءل لماذا نحتاج إلى دليلي `blog` - كما سوف تكتشف في وقت لاحق، وهذا هو مجرد تسمية اصطلاح مفيدة تجعل الحياة أسهل عندما تبدأ الأمور أكثر تعقيدا)
+
+والآن قم بإنشاء ملف `post_list.html` (فقط اتركه فارغاً للآن) داخل دليل `blog/templates/blog`.
+
+انظر كيف يبدو موقع الويب الخاص بك الآن: http://127.0.0.1:8000/
+
+> إذا كان لا يزال لديك خطأ `TemplateDoesNotExist`,، حاول إعادة تشغيل الخادم الخاص بك. انتقل الى سطر الأوامر حاول ايقاف الخادم عبر (بالضغط على Ctrl+C - مفتاح التحكم و C معا) وإعادة تشغيله من خلال تشغيل الأمر ` python manage.py runserver </ 0>.</p>
+</blockquote>
+
+<p><img src="images/step1.png" alt="الرقم 11.1" /></p>
+
+<p>لا يوجد خطأ بعد الآن! تهاني:) ومع ذلك، موقع الويب الخاص بك لم ينشر أي شيء ما عدا صفحة فارغة، نظراً لأن القالب فارغ . نحن بحاجة إلى إصلاح ذلك.</p>
+
+<p>أضف ما يلي إلى ملف القالب الخاص بك:</p>
+
+<p>{% filename %}blog/templates/blog/post_list.html{% endfilename %}</p>
+
+<pre><code class="html"><html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+`</pre> 
+> 
+> كيف يبدو موقعك الآن؟ يرجى زيارة الموقع لمعرفة ذالك: http://127.0.0.1:8000/
+> 
+> ![الرقم 11.2](images/step3.png)
+> 
+> إنه كان مجديًا! لقد قمت بعمل جيد هناك:)
+> 
+> * إن العلامة الأساسية، `<html>`، هي دائما بداية أي صفحة ويب و `</html>` هي دائما النهاية. كما ترون، يذهب كامل محتوى الموقع بين بداية الوسم `<html>`وعلامة إغلاق `</html>`
+> * `<p>`علامة لعناصر الفقرة؛ `</p>` يغلق كل فقرة
+> 
+> ## الرأس والجسم
+> 
+> كل صفحة HTML تنقسم إلى عنصرين هما **head** و **body**.
+> 
+> * **head** هو عنصر يحتوي على معلومات حول المستند الذي لا يتم عرضه على الشاشة.
+> 
+> * **body** هو عنصر يحتوي على كل شيء يتم عرضه كجزء من صفحة ويب.
+> 
+> نحن نستخدم `<head>` لإخبار المتصفح عن إعدادات الصفحة، و `<body>` ليقول ما هو موجود فعلا في الصفحة.
+> 
+> على سبيل المثال، يمكنك وضع عنصر عنوان صفحة ويب داخل `<head>`، مثل هذا:
+> 
+> {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+> 
+> ```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+قم بحفظ الملف وقم بتحديث الصفحة الخاصة بك.
+
+![الرقم 11.3](images/step4.png)
+
+لاحظ كيف أن المستعرض قد فهم أن "Ola's blog" هو عنوان الصفحة الخاصة بك؟ لقد فسرت `<title>Ola's blog</title>` ووضعت النص في شريط عنوان المتصفح (سيتم استخدامه أيضا للإشارات المرجعية وما إلى ذلك).
+
+ربما كنت قد لاحظت أيضا أن كل علامة افتتاح تقابلها *closing tag* مع `/` وذالك العنصر هو *nested* (بمعنى أنه لا يمكنك إغلاق علامة معينة حتى يتم إغلاق كل العلامات الموجودة داخلها).
+
+أنها مثل وضع الأمور في صناديق. لديك صندوق واحد كبيرة ، `<html></html>`؛ يوجد داخله `<body></body>`، والذي يحتوي على صناديق صغيرة `<p></p>`.
+
+تحتاج إلى اتباع قواعد *الإغلاق* هذه ، و *تداخل* العناصر – إذا لم تقم بذالك، المستعرض قد لا يكون قادراً على تفسيرها بشكل صحيح وسيتم عرض الصفحة الخاصة بك بشكل غير صحيح.
+
+## تخصيص القالب الخاص بك
+
+يمكنك الآن الحصول الأن على بعض المتعة ومحاولة تخصيص القالب الخاص بك! وإليك بعض العلامات المفيدة لذلك:
+
+* `<h1>A heading</h1>` لأهم عنوان لديك
+* `<h2>A sub-heading</h2>` لعنوان في المستوى التالي
+* `<h3>A sub-sub-heading</h3>` ومع ذالك إلى `<h6>`
+* `<p>فقرة من النص</p>`
+* ويؤكد `<em>text</em>` على النص الخاص بك
+* ويؤكد `<strong>text</strong>` بشدة على النص الخاص بك
+* `<br>`يذهب إلى سطر آخر (لا يمكنك وضع أي شيء داخل br وليس هناك أي علامة إغلاق)
+* `<a href="https://djangogirls.org">link</a>` إنشاء رابط
+* `<ul><li>first item</li><li>second item</li></ul>` أنشئ قائمة مثل هذه!
+* `<div></div>` تعرف جزء من الصفحة
+
+هنا مثال لقالب كامل انسخه والصقه `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+لقد أنشأنا ثلاثة أقسام `div` هنا.
+
+* يحتوي العنصر `div` الأول على عنوان مدونتنا - إنه عنوان ورابط
+* هناك عنصرا `div` آخران يحتويان على مدوناتنا التي تحتوي على تاريخ منشور، `h2` مع عنوان مشاركة قابل للنقر واثنين من `p` (فقرة) ، أحدهما للتاريخ والآخر لمدونتنا.
+
+هو يتيح لنا هذا التأثير:
+
+![الرقم 11.4](images/step6.png)
+
+يااي! ولكن حتى الآن، يعرض نموذجنا تماما **نفس المعلومات** - بينما كنا نتحدث عن النماذج في وقت سابق للسماح لنا بعرض معلومات ** مختلفة ** في **نفس التنسيق**.
+
+ما كنا نريد فعله حقا هو اضهار مشاركات حقيقية في ادارة دجانغو ، وذالك اين سنذهب لاحقا ،.
+
+## شيء اخر: أنشر الوقت!
+
+سيكون من الجيد أن نرى كل هذا على الإنترنت، ايس كذالك؟ دعونا ننشر بايثون في كل مكان اخر:
+
+### التزم وادفع التعليمات البرمجية الخاصة بك الى Github
+
+أولاً، دعونا نرى ما هي الملفات التي تغيرت منذ آخر نشر (شغل هذه الأوامر محليا ، ليس في بايثون في كل مكان):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+تأكد من أنك في دليل `djangogirls` ودعنا نخبر `git` بتضمين جميع التغييرات ضمن هذا الدليل:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **ملاحظة** `--al` تعني أن `git` ستعرف أيضا إذا كنت قد حذفت الملفات (بشكل افتراضي، فإنها ستعرف فقط الملفات الجديدة / المعدلة). تذكر أيضا (من الفصل 3) أن `.` تعني الدليل الحالي.
+
+قبل رفع جميع الملفات دعنا نرى ماذا سترفع `git` ( جميع الملفات التي ترفعها `git` يجب ان تضهر باللون الأخضر):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+نحن تقريبا هناك، الآن حان الوقت لنقول لها ان تحفض هذه التغييرات في تاريخها. سنعطيه "رسالة التزام" حيث نصف ما قمنا بتغييره. يمكنك كتابة ما تريد في هذه الحالة ، لكن من الأفضل ان تكتب شيء يدل على ما قمت بفعله حتى تتذكر في المستقبل.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **ملاحظة** تأكد من استخدام علامات الاقتباس المزدوجة حول رسالة الالتزام.
+
+عندما نقوم بذالك نرفع او ندفع بتعديلاتنا إلى GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### اسحب التعليمات الجديدة إلى PythonAnywhere، وأعد تحميل تطبيق الويب
+
+* افتح [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) واذهب الى **Bash console** او افتح واحدة جديدة وشغل هذا الأمر:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+وشاهد تعليماتك البرمجية يتم تحميلها ،اذا اردت ان ترى ان كانت قد وصلت ، يمكنك الإنتقال الى **Files tab** ورؤية تعليماتك في PythonAnywhere.
+
+* وأخيرا، انتقل إلى علامة التبويب [Web tab](https://www.pythonanywhere.com/web_app_setup/) واضغط على **Reload**.
+
+يجب أن يكون التحديث مباشر! امضي قدما وحدث موقع الويب الخاص بك في المتصفح. يجب أن تكون التغييرات مرئية. :)
\ No newline at end of file
diff --git a/ar/install_git.md b/ar/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ar/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ar/installation/README.md b/ar/installation/README.md
new file mode 100644
index 00000000000..c32e07b34b5
--- /dev/null
+++ b/ar/installation/README.md
@@ -0,0 +1,58 @@
+# إذا كنت تستخدم البرنامج التعليمي في المنزل
+
+إذا كنت تستخدم البرنامج التعليمي في المنزل وليس في أحد [أحداث "جانغو للفتيات"](https://djangogirls.org/events/)، يمكنك تخطي هذا الفصل الآن والانتقال مباشرة إلى الفصل ["كيف يعمل الإنترنت" ](../how_the_internet_works/README.md).
+
+وهذا يرجع إلى أننا نغطي هذه الأشياء في البرنامج التعليمي كله على أي حال، وهذه مجرد صفحة إضافية تقوم بجمع كافة إرشادات التثبيت في مكان واحد. يشمل حدث دجانغو للفتيات امسية للتثبيت بحيث نقوم بتثبيت كل شيء، حتى لا نعاني اثناء حلقات العمل، هذا سيكون مفيدا بالنسبة لنا.
+
+إذا وجدت أنها مفيدة، يمكنك المتابعة من خلال هذا الفصل أيضا. ولكن إذا كنت تريد البدء في تعلم الأشياء قبل تثبيت مجموعة من الأشياء على جهاز الكمبيوتر الخاص بك، انتقل من هذا الفصل وسوف نشرح جزء التثبيت لكم في وقت لاحق.
+
+حظا سعيدا!
+
+# التثبيت
+
+في حلقة العمل سوف نبني مدونة، هناك عدد قليل من مهام الإعداد في البرنامج التعليمي الذي سيكون جيدا للعمل سلفا حتى أن كنت على استعداد لبدء التكويد في ذاك اليوم.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# تثبيت بايثون
+
+{% include "/python_installation/instructions.md" %}
+
+# قم بإعداد بيئة افتراضية وتثبيت جانغو
+
+{% include "/django_installation/instructions.md" %}
+
+# ركب محرر اكواد
+
+{% include "/chromebook_setup/instructions.md" %}
+
+# تثبيت Git
+
+{% include "/django_installation/git.md" %}
+
+# إنشاء حساب Github
+
+زر [GitHub.com](https://www.github.com) وسجل حساب مستخدم جديد، مجاناً.
+
+# قم بإنشاء حساب بايثون في كل مكان
+
+{% include "/django_installation/pythonanywhere.md" %}
+
+# ابدأ بالقراءة
+
+تهانينا، انت جاهز الأن وعلى استعداد للإنطلاق! إذا كان لا يزال لديك بعض الوقت قبل انعقاد حلقة العمل، سيكون من المفيد بدء قراءة عدد قليل من فصول البداية:
+
+* [كيف تعمل الإنترنت](../how_the_internet_works/README.md)
+
+* [مقدمة لسطر الأوامر](../intro_to_command_line/README.md)
+
+* [مقدمة إلى بايثون](../python_introduction/README.md)
+
+* [ما هو جانغو؟](../django/README.md)
+
+# استمتع بالحلقة!
+
+عند البدء في حلقة العمل، عليك أن تكون قادر على الذهاب مباشرة إلى [أول مشروع جانغو!](../django_start_project/README.md) لأنك غطيت كل الموارد في الفصول السابقة.
\ No newline at end of file
diff --git a/ar/instructions.md b/ar/instructions.md
new file mode 100644
index 00000000000..be0a284adad
--- /dev/null
+++ b/ar/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Creating a `virtualenv` on both Linux and OS X is as simple as running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ar/intro_to_command_line/README.md b/ar/intro_to_command_line/README.md
new file mode 100644
index 00000000000..8bff2ce6a68
--- /dev/null
+++ b/ar/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# مقدمة لواجهة سطر الأوامر
+
+> للقراء في المنزل: هذا الفصل تم التكلم عنه في [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+أنه مثير، أليس كذلك؟! عليك كتابة السطر الأول الخاص بك من التعليمات البرمجية في بضع دقائق فقط! :)
+
+**دعونا نقدم لكم صديقكم الأول: سطر الأوامر!**
+
+الخطوات التالية سوف تظهر لك كيفية استخدام النافدة السوداء التي يستخدمها جميع الهكر. قد تبدو مخيفه قليلاً في البداية ولكن حقاً أنها مجرد موجه تنتظر الأوامر منك.
+
+> **ملاحظة** يرجى ملاحظة أن طوال هذا الكتاب يمكننا استخدام عبارات 'الدليل' و 'مجلد' بالتبادل ولكنها واحدة ونفس الشيء.
+
+## ما هو سطر الأوامر؟
+
+النافذة، والتي عادة ما تسمى **سطر الأوامر** أو **واجهة سطر الأوامر**، هو تطبيق يستند إلى النص للعرض، والمناولة، ومعالجة الملفات الموجودة على جهاز الكمبيوتر الخاص بك. أنه يشبه إلى حد كبير ويندوز إكسبلورر أو الباحث في Mac، ولكن دون واجهة رسومية. أسماء أخرى لسطر الأوامر هي: *cmd*, *CLI*, *prompt*, *console* أو *terminal*.
+
+## إفتح واجهة سطر الأوامر
+
+لبدء بعض التجارب نحن بحاجة إلى فتح واجهة سطر الأوامر لدينا أولاً.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+إذهب الى نافدة البداية ← نضام وندوز ← موجه الأوامر.
+
+> على الإصدارات القديمة من ويندوز، ابحث في قائمة ابدأ > كافة البرامج > ملحقات > موجه الأوامر.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+انتقل إلى التطبيقات → الأدوات المساعدة → تيرمينال.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+أنها على الأرجح تحت تطبيقات ← اكسسوارات ← تيرمينال، ولكن قد تعتمد على النظام الخاص بك. إذا لم يكن هناك، فقط بحث في جوجل
+
+<!--endsec-->
+
+## موجه
+
+يجب أن تشاهد الآن نافذة بيضاء أو سوداء تنتظر الأوامر الخاصه بك.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+إذا كنت على ماك أو لينكس، ربما تشاهد `` $، تماما مثل هذا:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+في Windows، انها علامة `>`، مثل هذا:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+سيتم إرفاق كل أمر قبل هذه الإشارة ومسافة واحدة، ولكن ليس عليك كتابته. سيقوم جهاز الكمبيوتر بالقيام بذلك نيابة عنك. :)
+
+> مجرد ملاحظة صغيرة: في الحالة الخاصة بك قد يكون هناك شيء من هذا القبيل `C:\Users\ola >` أو `Olas-MacBook-Air:~ ola$` قبل التوقيع الفوري، وهذا موافق 100 ٪.
+
+يطلق على الجزء`$` أو `>` أو *موجه سطر الأوامر*، أو *موجه* كإسم قصير. فإنه يطالبك بإدخال شيء هناك.
+
+في البرنامج التعليمي، عندما نريد منك أن تكتب أمر ما ، سوف نشمل `$` أو `>`، وأحيانا أكثر إلى اليسار. يمكنك تجاهل الجزء الأيسر وما عليك سوى كتابة الأمر الذي يبدأ بعد الموجه.
+
+## الأمر الأول الخاص بك (ياي!)
+
+لنبدأ بكتابة هذا الأمر:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+ثم اضغط على `enter`. هذه هي النتيجة لدينا:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+كما ترون، الكمبيوتر قد طبع اسم المستخدم الخاص بك. أنيق، هاه؟ :)
+
+> حاول كتابة كل أمر؛ لا نسخ ولصق. عليك أن تتذكر هذه الطريقة أكثر!
+
+## الأساسيات
+
+كل نظام تشغيل يحتوي على مجموعة مختلفة قليلاً من أوامر سطر الأوامر، لذا تأكد من اتباع التعليمات لنظام التشغيل الخاص بك. دعونا نحاول هذا،هيا بنا؟
+
+### الدليل الحالي
+
+سيكون من الجميل أن نعرف أين نحن الآن، اليس كذالك؟ لنرى. اكتب هذا الأمر وإضغط `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> ملاحظة: 'pwd' تعني 'دليل عمل الطباعة'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> ملاحظة: 'cd' تعني 'تغيير الدليل'. تماما مثل pwd مع powershell يمكنك استخدامه في لينكس أو نظام التشغيل Mac OS X.
+
+<!--endsec-->
+
+ربما سترى شيئا مشابها على الجهاز الخاص بك. عندما تقوم بفتح سطر الأوامر تبدأ عادة في الدليل الرئيسي للمستخدم الخاص بك.
+
+* * *
+
+### قائمة الملفات والدلائل
+
+اذا ماذا فيها ؟ سيكون من الرائع معرفة ذالك ، دعونا نرى:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> ملاحظة: في powershell يمكنك أيضا استخدام 'ls' مثل لينكس، ونظام التشغيل Mac OS X. <!--endsec-->
+
+* * *
+
+### تغيير الدليل الحالي
+
+الآن، دعنا نذهب إلى دليل سطح المكتب:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+تحقق إذا كان تم تغييره حقا:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+ها هي ذا!
+
+> نصيحة المحترفين: إذا كتبت <`cd D`، ثم ضغطت في `tab` على لوحة المفاتيح، فسيملأ سطر الأوامر تلقائيا بقية الاسم حتى تتمكن من التنقل بشكل أسرع. إذا كان هناك أكثر من مجلد واحد بدءاً من"D"، اضغط مفتاح `tab` مرتين للحصول على قائمة الخيارات.
+
+* * *
+
+### إنشاء دليل
+
+ماذا عن إنشاء دليل للتدرب على سطح المكتب؟ يمكنك القيام بذلك بهذه الطريقة:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+سيؤدي هذا الأمر الصغير إلى إنشاء مجلد باسم `practice` على سطح المكتب. يمكنك التحقق إذا كان هناك من خلال النظر في سطح المكتب الخاص بك أو بواسطة تشغيل أمر `dir` أو `ls`! جربها. :)
+
+> نصيحة للمحترفين: إذا كنت لا تريد كتابة الأوامر نفسها مرارا وتكرارا، فجرب الضغط على `up arrow` و `down arrow` على لوحة المفاتيح للتنقل عبر الأوامر المستخدمة مؤخرا.
+
+* * *
+
+### تمارين!
+
+تحدي صغيرة بالنسبة لك: في الدليل الذي تم إنشاؤه حديثا `practice` ، قم بإنشاء دليل يسمى `test`(استخدم الأمرين `cd` و `mkdir`.)
+
+#### الحل:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+مبروك
+
+* * *
+
+### التنظيف
+
+لا نريد أن تترك فوضى، لذلك دعونا نزيل كل ما قمنا به حتى هذه النقطة.
+
+أولاً، نحن بحاجة للعودة إلى سطح المكتب:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+باستخدام `.` مع الأمر `cd` سيتم تغيير الدليل الحالي الخاص بك إلى الدليل الأصل (أي، الدليل الذي يحتوي على الدليل الحالي الخاص بك).
+
+تحقق أين أنت:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+حان الوقت الآن لحذف دليل `practice`:
+
+> **انتباه**: حذف الملفات باستخدام `del`, `rmdir` أو `rm` غير قابلة للاسترداد، مما يعني * الملفات ستزول إلى الأبد*! لذا كن حدرا جدا مع هذه الأوامر.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+تم! للتأكد دعونا نتحقق من انك حدفته فعليا:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### خروج
+
+هذا كل شيء الأن! يمكنك إغلاق سطر الأوامر الآن بأمان. دعونا نفعل ذلكبطريقة الهكر، حسنا؟ :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+جيد ، هاه
+
+## الملخص
+
+هنا ملخص لبعض الأوامر المفيدة:
+
+| الأوامر (في Windows) | الأوامر في (ماك/لينكس) | الوصف               | أمثلة                                             |
+| -------------------- | ---------------------- | ------------------- | ------------------------------------------------- |
+| exit                 | exit                   | أغلق النافذة        | **exit**                                          |
+| cd                   | cd                     | تغيير الدليل        | **cd test**                                       |
+| cd                   | pwd                    | إظهار الدليل الحالي | **cd** (Windows) o **pwd** (Mac OS / Linux)       |
+| dir                  | ls                     | قائمة الدلائل/ملفات | **dir**                                           |
+| copy                 | cp                     | نسخ ملف             | **copy c:\test\test.txt c:\windows\test.txt** |
+| move                 | mv                     | نقل الملف           | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir                | mkdir                  | إنشاء دليل جديد     | **mkdir testdirectory**                           |
+| rmdir (or del)       | rm                     | حذف الملف           | **del c:\test\test.txt**                        |
+| rmdir /S             | rm -r                  | حذف الدليل          | **rm -r testdirectory**                           |
+
+هذه فقط عدد قليل جداً من الأوامر يمكنك تشغيلها في سطر الأوامر الخاصة بك، ولكن انت لن تستخدم اي شيء اكثر من ذالك هذا اليوم.
+
+إذا كنت فضولي، [ss64.com](http://ss64.com) يحتوي على مرجع كامل لأوامر لكافة أنظمة التشغيل.
+
+## مستعد ؟
+
+دعونا نغوص في بايثون!
\ No newline at end of file
diff --git a/ar/python_installation/README.md b/ar/python_installation/README.md
new file mode 100644
index 00000000000..2f9998046a7
--- /dev/null
+++ b/ar/python_installation/README.md
@@ -0,0 +1,15 @@
+# لنبدأ مع بايثون
+
+وأخيراً نحن هنا!
+
+ولكن أولاً، دعونا نقول لكم ما هي بايثون. بايثون هي لغة برمجة شعبية جداً والتي يمكن استخدامها لإنشاء المواقع والألعاب والبرامج العلمية، والرسومات والكثير، أكثر بكثير.
+
+بايثون نشأت في أواخر الثمانينات، وهدفها الرئيسي أن يتمكن البشر من قراءتها (ليس فقط آلألات!). هذا هو السبب في أنها تبدو أبسط من لغات البرمجة الأخرى، ولكن لا تقلق - بايثون قوية ايضا!
+
+# تركيب بايثون
+
+> **ملاحضة**إذا كنت تستخدم كروم بوك تخطى هذا القسم وتابع الإرشادات الموجودة في [التركيب على كروم بوك](../chromebook_setup/README.md).
+> 
+> **ملاحضة** اذا كنت قد عملت على تعليمات التركيب من قبل ، يمكنك الإنتقال الى المستوى الأخر!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ar/python_installation/instructions.md b/ar/python_installation/instructions.md
new file mode 100644
index 00000000000..35e7cfa4a6a
--- /dev/null
+++ b/ar/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> للقراء في المنزل: هذا الفصل تم التكلم عنه في [تثبيت بايثون محرر التعليمات البرمجية](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> هذا القسم يستند على دورة تعليمية من فتيات الجزر المهووسات (https://github.com/ggcarrots/django-carrots)
+
+دجانغو مكتوبة ببايثون.. نحن بحاجة إلى بايثون للقيام بأي شيء في جانغو. دعونا نبدأ بتثبيته! نحن نريد منك تثبيت "بايثون 3،6"، حتى إذا كان لديك أي إصدار سابق، سوف تحتاج إلى ترقية.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+أولا تحقق ان كان حاسوبك يستخدم نسخة 32 بت او 64 بت من وندوز, ، عن طريق الضغط على مفتاح ويندوز + مفتاح Pause/Break الذي سيقوم بفتح معلومات النظام الخاص بك، وإلقاء نظرة على السطر "نوع النظام". يمكنك تحميل بايثون ل Windows من https://www.python.org/downloads/windows/. انقر فوق "Latest Python 3 Release - Python x.x.x". إذا كان جهاز الكمبيوتر الخاص بك يقوم بتشغيل إصدار **64 بت** من Windows، حمل **Windows x86-64 executable installer**. وبخلاف ذلك، حمل **Windows x86 executable installer**. بعد تحميل المثبت، ينبغي تشغيله (انقر نقراً مزدوجاً على الملف) واتبع الإرشادات الموجودة هناك.
+
+شيء واحد يجب عليك الإنتباه له أثناء التثبيت ستلاحظ علامة نافذة "إعداد". تأكد من وضع علامة في خانة الاختيار "Add Python 3.6 to PATH" وانقر فوق "التثبيت الآن"، كما هو موضح هنا:
+
+![لا تنس إضافة بيثون إلى المسار](../python_installation/images/python-installation-options.png)
+
+في الخطوات المقبلة، عليك استخدام سطر أوامر Windows (والذي سنتكلم عنه ايضا). الآن، إذا كنت بحاجة لكتابة بعض الأوامر، انتقل إلى قائمة ابدأ ← نظام Windows ← موجه الأوامر. يمكنك أيضا الضغط على مفتاح Windows واضغط مفتاح "R"- حتى تضهر نافدة "Run". لفتح سطر الأوامر، اكتب "cmd" وإضغط على أدخل في "Run". (في الإصدارات الأحدث من Windows، قد تحتاج إلى البحث عن "موجه الأوامر"، نظراً لأنه في بعض الأحيان مخفي.)
+
+![أكتب "cmd" في نافدة "Run&quot](../python_installation/images/windows-plus-r.png)
+
+ملاحضة: اذا كنت تستخدم نسخة قديمة من وندوز ( 7، فيستا، او اي نسخة قديمة) وبايثون 3.6 فشلت في التنصيب يكنك تجريب هذا:
+
+1. تثبيت كافة تحديثات Windows ومحاولة تثبيت بايثون 3.6 مرة أخرى؛ أو
+2. تثبيت [نسخة اقدم من بايثون](https://www.python.org/downloads/windows/) مثال [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+إذا قمت بتثبيت إصدار قديم من بايثون، شاشة التثبيت قد تبدو مختلفة بعض الشيء مما هو مبين أعلاه. تأكد من أنك قمت بالتمرير لأسفل لرؤية "Add python.exe to Path"، ثم انقر فوق الزر الموجود على الجانب الأيسر واختر "Will be installed on local hard drive":
+
+![إضافة بايثون إلى المسار، الإصدارات القديمة](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **ملاحظة** قبل أن تقوم بتثبيت بايثون على نظام التشغيل OS X، عليك التأكد من إعدادات ماك إذا كانت تسمح بتثبيت الحزم التي ليست من المتجر. إذهب إلى "تفضيلات النظام" (في مجلد التطبيقات)، انقر فوق "الأمان الخصوصية"، ثم علامة التبويب "عام". إذا كانت " السمحاح بالتطبيقات للتحميل من " موضوعة على تطبيقات أبستور فقط غيرها إلى " تطبيقات أبستور و المطورين الغير المعرفين "
+
+يجب عليك زيارة هذا الموقع وتحميل مثبت بايثون https://www.python.org/downloads/release/python-361/:
+
+* تحميل ملف *مثبت Ma c OS X 64-بت/32-بت * ،
+* انقر نقراً مزدوجاً فوق *python-3.6.1-macosx10.6.pkg* لتشغيل المثبت.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+من المحتمل جدا ان لديك نسخة بايثون مثبتة بالفعل ، للتحقق ادخل الأوامر التالية في وحدة التحكم:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+إذا كان لديك 'نسخة مايكرو' مختلفة من بايثون منصبة، مثل 3.6.0، إذا ليس عليك الترقية. إذا لم تنصب بايثون ، أي انك تريد نسخة مغايرة ، يمكنك تثبيته على النحو التالي:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+استخدم هذا الأمر في وحدة التحكم الخاصة بك:
+
+{% filename %} baris perintah {% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+استخدم هذا الأمر في وحدة التحكم الخاصة بك:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+إذا كنت تستخدم إصدار فيدورا قديم قد تحصل على خطأ لم يتم العثور على الأمر dnf. في هذه الحالة تحتاج إلى استخدام yum بدلاً من ذلك.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+استخدم هذا الأمر في وحدة التحكم الخاصة بك:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+تحقق من أن عملية التثبيت كانت ناجحة بفتح موجه الأوامر ثم تشغيل الأمر `python3`:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**ملاحظة:** إذا كنت على ويندوز، و حصلت على رسالة خطأ أنه لم يتم العثور على `python3`، حاول استخدام `python` (دون `3`) وتجربة اذا كان لا يزال هنا نسخة من 3.6 بيثون.
+
+* * *
+
+إذا كان لديك اي سؤال ، او حصل شي ما وليس لديه اي فكرة عن ما حصل ، رجاء إستشر مدربك! أحيانا لا تسير الأمور بسلاسة، لذا من الأفضل أن تطلب المساعدة من شخص لديه خبرة أكبر.
\ No newline at end of file
diff --git a/ar/python_introduction/README.md b/ar/python_introduction/README.md
new file mode 100644
index 00000000000..f22d975b62e
--- /dev/null
+++ b/ar/python_introduction/README.md
@@ -0,0 +1,1063 @@
+# مقدمة إلى بايثون
+
+> هذا القسم يستند على دورة تعليمية من فتيات الجزر المهووسات (https://github.com/ggcarrots/django-carrots).
+
+دعنا نكتب بعض التعليمات البرمجية!
+
+## موجه بايثون
+
+> للقراء في المنزل: تم تغطية هذا الجزء في فيديو [ أساسيات بايثون: عدد صحيح، سلاسل، قوائم، متغيرات وأخطاء ](https://www.youtube.com/watch?v=MO63L4s-20U).
+
+لبدء العمل ببايثون، نحتاج إلى فتح *سطر الأوامر* على جهاز الكمبيوتر. يجب عليك ان تعرف كيف تفعل ذالك - لقد تعلمته في [مقدمة لسطر الأوامر](../intro_to_command_line/README.md).
+
+عندما تكون مستعدا، اتبع الإرشادات أدناه.
+
+نريد فتح وحدة تحكم بيثون، لذلك اكتب في `python` على ويندوز أو `python3` على نظام التشغيل ماك / لينوكس واضغط على `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## أمر بايثون الأول الخاص بك!
+
+بعد تشغيل الطلب في بايثون ، تغير الطلب إلى `>>>`. وهذا يعني بالنسبة لنا الآن انه يمكننا استخدام الأوامر في لغة بايثون فقط. ليس عليك الكتابة في `>>>` بايثون سيقوم بذالك.
+
+إذا كنت ترغب في إنهاء وحدة تحكم بايثون ، فقط اكتب `exit()` أو استخدام الاختصار `Ctrl + Z` ل Windows و `Ctrl + D` ماك/لينكس. فإنك لن ترى `>>>`أبدا.
+
+في الوقت الحالي، نحن لا نريد الخروج من وحدة تحكم بايثون. نريد أن نتعلم المزيد. دعونا نبدأ بكتابة بعض الرياضيات، مثل `2 + 3` و `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+لطيف! انظر كيف برز الجواب؟ بيثون يعرف الرياضيات! يمكنك محاولة الأوامر الأخرى مثل:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+لإجراء حساب ، قل 2 إلى القوة 3، نكتب: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+استمتع لبعض الوقت مع هذا ، وعد إلى هنا 
+
+كما ترون، بايثون هي الة حاسبة عضيمة. إذا كنت تتساءل ماذا يمكنك أن تفعل…
+
+## سلسلة
+
+ماذا عن اسمك؟ اكتب الاسم الأول في علامات اقتباس مثل هذا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+لقد أنشأت الآن السلسلة الأولى! هو تسلسل أحرف يمكن معالجتها بواسطة جهاز الكمبيوتر. يجب ان تبدأ السلسلة وتنتهي بنفس الحرف. قد يكون هذا واحد(`'`)) أو الضعف (`"`)) اقتباس (لا فرق!) الإقتباس يقول لبايثون انه هناك سلسلة.
+
+السلاسل يمكن أن تكون مربوطة معا. جرب هذا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+يمكنك أيضا ضرب السلاسل مع عدد:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+إذا كنت بحاجة إلى وضع علامة اقتباس أحادية داخل السلسلة الخاصة بك, لديك طريقتين للقيام بذلك.
+
+استخدام علامات الاقتباس المزدوجة:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+أو الهروب من الفاصلة بخط مائل (`` \):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+لطيف، هاه؟ لرؤية اسمك بالأحرف الكبيرة، اكتب:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+لقد استخدمت `upper` **method** للتو في السلسلة الخاصة بك! وهناك طريقة (مثل `upper()`) عبارة عن سلسلة من التعليمات التي يجب على بايثون تنفيذها على كائن معين (`"Ola"`) بمجرد استدعائه.
+
+إذا كنت تريد أن تعرف عدد الحروف الواردة في اسمك، هناك **function** لذلك أيضا!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+أتساءل لماذا في بعض الأحيان أستدعي الدالات بواسطة `.` في نهاية سلسلة (مثل `"Ola".upper()`)، وفي بعض الأحيان يمكنك استدعاء دالة أولاً ووضع السلسلة في الأقواس؟ حسنا، في بعض الحالات، تنتمي المهام إلى أشياء، مثل `upper()`, ، والتي لا يمكن تنفيذها إلا على السلاسل. في هذه الحالة نسمي المهام ب **method**. مرات اخرى، المهام لا تنتمي إلى أي شيء محدد، ويمكن استخدامها على أنواع مختلفة من الكائنات، مثل `len()`. لهذا نحن نعطي `"Ola"` اعدادات الى المهمة `len`.
+
+### مُلخّص
+
+طيب، يكفينا سلآسل ، حتى الأن لقد تعلمت:
+
+- **the prompt** كتابة الأوامر (كودات) في موجه اوامر بايثون يعطينا اجابات في بايثون
+- **numbers and strings** - في بايثون تستخدم الأرقام للرياضيات والسلاسل للكائنات النصية
+- **operators** مثل `+` و `*`, تجمع بين القيم لتنتج واحدة جديدة
+- **functions** مثل `upper()` و `len()` تنفذ إجراأت على الكائنات.
+
+هذه هي الأساسيات لكل لغة برمجة تتعلمها. أنت مستعد لشيء أكثر صعوبة؟ ونحن نراهن على ذالك!
+
+## أخطاء
+
+دعنا نجرب شيئا جديداً. يمكن أن نحصل على طول عدد بنفس الطريقة التي يمكن أن نجد بها طول اسمنا؟ اكتب في `len(304023)` واضغط `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+حصلنا على الخطأ الأول! ويقول أن الكائنات من نوع "إنت" (الأعداد الصحيحة، أرقام كاملة) ليس لها طول. فماذا يمكننا أن نفعل الآن؟ ربما يمكننا كتابة رقمنا كسلسلة؟ سلاسل لها طول، أليس كذلك؟
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+لقد كان مجديًا! قمنا باستخدام الدالة `str` داخل الدالة `len`. `str ()` تحويل كل شيء إلى سلاسل.
+
+- الدالة `str` تحول الأشياء إلى **strings</1 ></li> 
+    
+    - الدالة `int` تحول الأشياء إلى **integers**</ul> 
+    
+    > هام: علينا تحويل الأرقام إلى نص، ولكن لا يمكن بالضرورة تحويل النص إلى أرقام – ماذا ستكون `int('hello')` على أي حال؟
+    
+    ## المتغيرات
+    
+    مفهوم هام في البرمجة وهو المتغيرات. المتغير ليس أكثر من اسم لشيء يمكن استخدامه في وقت لاحق. يستخدم المبرمجون هذه المتغيرات لتخزين البيانات، وجعل التعليمات البرمجية الخاصة بهم أكثر قابلية للقراءة، لذالك هم ليسو بحاجة لتدكر كل شيء.
+    
+    لنفرض أننا نريد إنشاء متغير جديد يسمى `name`:
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+>>> name = "Ola"
+```
+
+اكتب اسم يساوي Ola.
+
+كما لاحظت، فإن البرنامج لم يعد أي شيء كما فعل من قبل. فكيف نعرف أن المتغير موجود بالفعل؟ ما عليك سوى إدخال `name` واضغط على `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+يآآاي! المتغير الأول الخاص بك! :) يمكنك دائماً تغيير ما يشير إليه:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+يمكنك استخدامه في وظائف ايضا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+رائع، أليس كذلك؟ بالطبع، المتغيرات يمكن أن تكون أي شيء أرقام أيضا! جرب هذا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+ولكن ماذا لو استخدمنا اسم خاطئ؟ هل يمكنك تخمين ما يمكن أن يحدث؟ دعونا نحاول!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+خطأ! كما ترون، بيثون لديه أنواع مختلفة من الأخطاء ويسمى هذا **NameError**. سيعطيك بايثون هذا الخطأ إذا حاولت استخدام متغير لم يتم تعريفه حتى الآن. إذا واجهت هذا الخطأ في وقت لاحق، تحقق من التعليمات البرمجية الخاصة بك لمعرفة إذا كنت أخطأت في أي أسماء.
+
+العب بهذه التعليمات لبعض الوقت، وانضر ما يمكن ان تفعله!
+
+## وظيفة الطباعة
+
+جرب هذا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+عندما تكتب `name`, فقط، يستجيب مترجم بايثون مع*representation* المتغير 'نيم'، وهو الحرف M-a-r-i-a، المحاط بعلامات اقتباس مفردة، ''. عندما تقول `print(name)`, بايثون ستقوم ب "طباعة" محتويات المتغير إلى الشاشة، دون علامات الاقتباس، وهو أكثرإتقانا.
+
+وكما سنرى لاحقاً، `print()` مفيد أيضا عندما نريد طباعة الأشياء من داخل المهام، أو عندما نريد طباعة الأشياء في أسطر متعددة.
+
+## القوائم
+
+بجانب السلاسل والأعداد الصحيحة، بايثون لديه كل الأنواع المختلفة من الكائنات. الآن نحن بصدد إدخال واحد يسمى **list**. القوائم هي بالضبط ما تعتقد: الكائنات التي هي قوائم لكائنات الأخرى. :)
+
+امضي قدما وأنشئ قائمة:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+نعم، هذه القائمة فارغة. ليست مفيدة جدا، أليس كذلك؟ دعونا ننشئ قائمة من أرقام اليانصيب. نحن لا نريد أن نكرر ذالك طوال الوقت، لذلك سنضعها في متغير أيضا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+حسنا، لدينا قائمة! ماذا يمكننا أن نفعل حيال ذلك؟ دعونا نرى كم عدد اليانصيب هناك في القائمة. هل لديك أي فكرة عن أي وظيفة يجب عليك استخدامها لذلك؟ أنت تعرف هذا بالفعل!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+نعم! `len()` يمكن أن تعطيك عددا من الكائنات في قائمة. مفيد، أليس كذلك؟ ربما سنقوم بترتيبها الآن:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+هذا لا يعيد أي شيء، انها مجرد تغييرات للترتيب الذي يظهر الأرقام في القائمة. دعونا نطبعه مرة أخرى ونرى ما يحدث:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+كما ترون، يتم فرز الأرقام في القائمة الخاصة بك الآن من أدنى إلى أعلى القيمة. مبروك!
+
+ربما نريد عكس هذا الترتيب؟ دعونا نفعل ذلك!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+إذا كنت ترغب في إضافة أي شيء إلى القائمة الخاصة بك، يمكنك القيام بذلك عن طريق كتابة هذا الأمر:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+إذا كنت ترغب في إظهار الرقم الأول فقط، يمكنك القيام بذلك باستخدام **indexes**. الفهرس هو العدد الذي يقول أين يحدث عنصر في قائمة. المبرمجين يفضلون بدء العد من 0، وبالتالي فإن الكائن الأول في قائمتك هو في مؤشر 0، والكائن القادم هو في 1، وما إلى ذلك. جرب هذا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+كما ترون، يمكنك الوصول إلى كائنات مختلفة في القائمة الخاصة بك باستخدام الاسم في قائمة الفهرس للكائن داخل أقواس معقوفة.
+
+لحذف شيء من القائمة الخاصة بك سوف تحتاج إلى استخدام **indexes** كما تعلمنا أعلاه وأسلوب `pop()`. دعونا احد الأمثلة ونعزز ما تعلمناه سابقا. سنقوم بحذف الرقم الأول من قائمتنا.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+انه يعمل كالحصان!
+
+للمتعة الإضافية، حاول بعض الفهارس الأخرى: 6، 7، 1000،-1 أو-6-1000. انظر إذا كان يمكنك التنبؤ بالنتيجة قبل محاولة الأمر. منطقي؟
+
+يمكن أن تجد قائمة بجميع الأساليب القائمة المتوفرة في هذا الفصل من وثائق بايثون: https://docs.python.org/3/tutorial/datastructures.html
+
+## القواميس
+
+> للقراء في المنزل: هذا الفصل تم التكلم عنه في [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+
+القاموس مماثل للقائمة، ولكن يمكنك الوصول إلى القيم عن طريق البحث عن المفتاح بدلا من الفهرس الرقمي. المفتاح يمكن أن يكون أي سلسلة أو رقم. تعريف جملة لبنآء قاموس فارغ:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+هذا يدل على أنك قمت بإنشاء قاموس فارغ للتو. يآآاي!
+
+والآن، حاول كتابة الأمر التالي (محاولة استبدال المعلومات الخاصة بك، ايضا):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+مع هذا الأمر، الذي أنشأته للتو متغير يسمى `participant` مع ثثلاثة أزواج القيمة الرئيسية:
+
+- المفتاح `name` يشير إلى قيمة`'Ola'`(كائن `string`)،
+- `country` يشير إلى `'Poland'` (`string` أخرى)،
+- ويشير `favorite_numbers` إلى `[7، 42، 92]` (`list` بثلاثة أرقام).
+
+يمكنك التحقق من محتوى المفاتيح الفردية مع بناء الجملة التالي:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+انظر، انها مماثلة للقائمة. ولكن لا تحتاج إلى تذكر الفهرس - فقط الاسم.
+
+ماذا يحدث إذا طلبنا من بايثون قيمة مفتاح غير موجود؟ هل يمكنك التخمين؟ دعونا نحاول ونرى!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+انضر، خطأ آخر! هذا **KeyError**. بايثون مفيد ويخبرك بأن مفتاح `'age'` غير موجود في هذا القاموس.
+
+متى يجب استخدام قاموس أو قائمة؟ حسنا، هذه نقطة جيدة للتفكير. فقط فكر في حل قبل النظر في الجواب في السطر التالي.
+
+- هل تحتاج فقط إلى تسلسل أمر من العناصر؟ انتقل إلى القائمة.
+- هل تحتاج إلى ربط القيم مع مفاتيح، حتى تتمكن من البحث عنها بكفاءة (عن طريق مفتاح) في وقت لاحق؟ إستخدم المعجم.
+
+القواميس، مثل القوائم، و *mutable*، بمعنى أنه يمكن تغييرها بعد إنشائها. يمكنك إضافة أزواج مفتاح – القيمة الجديدة إلى قاموس بعد إنشائه، هكذا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+مثل القوائم، باستخدام طريقة `len()` على القواميس ترجع عدد أزواج القيمة الرئيسية في القاموس. إمضي قدما واكتب هذا الأمر:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+آمل أن يكون هذا منطقيا حتى الآن. :) هل انت على استعداد لمتعة أكثر مع القواميس؟ قراءة لبعض الأشياء المدهشة.
+
+يمكنك استخدام الأسلوب `pop()` لحدف عنصر من القاموس. لنفترض أنك تريد حذف المدخل المقابل للمفتاح `'favorite_numbers'`, ، اكتب فقط الأمر التالي:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+كما ترون من المخرج، تم حذف زوج مفتاح القيمة المقابلة لمفتاح 'favorite_numbers'.
+
+فضلا عن ذلك، يمكنك أيضا تغيير قيمة مرتبطة بمفتاح تم إنشاؤه مسبقاً في القاموس. اكتب هذا الأمر:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+كما ترون، تم تغيير قيمة المفتاح `'country'` من `'Poland'` إلى `'Germany'`. :) مثير؟ مرحى! لقد تعلمت للتو شيء آخر مدهش.
+
+### الملخص
+
+مدهش! أنت تعرف الكثير عن البرمجة الآن. لقد تعلمت في هذا الجزء الأخير حول:
+
+- **أخطاء** – يمكنك الآن معرفة كيفية قراءة وفهم الأخطاء التي تظهر إذا كان بايثون لم يفهم امر اعطيته له
+- **المتغيرات** –أسماء الكائنات التي تسمح لك بتكويد أكثر سهولة وجعل التعليمات البرمجية الخاصة بك أكثر قابلية للقراءة
+- **قوائم** – قوائم الكائنات المخزنة في ترتيب معين
+- **قواميس** – الكائنات المخزنة كقيمة مفتاح-أزواج
+
+متحمس للجزء القادم؟ :)
+
+## مقارنة الأشياء
+
+> للقراء في المنزل: هذا الفصل تم التكلم عنه في فيديو [Python Basics: Dictionaries](https://www.youtube.com/watch?v=7bzxqIKYgf4).
+
+جزء كبير من البرمجة ينطوي على مقارنة الأشياء. ما هو أسهل شيء للمقارنة؟ أرقام، بالطبع. دعونا نرى كيف يعمل:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+أعطينا بايثون بعض الأرقام للمقارنة. كما ترون،بايثون لا يمكنها مقارنة الأرقام فقط، ولكن يمكنها أيضا مقارنة نتائج الأسلوب. لطيف، هاه؟
+
+هل تتساءل لماذا وضعنا اثنين من العلامات المتساوية `==` بجانب بعضها البعض للمقارنة إذا كانت الأرقام متساوية؟ ونحن نستخدم `=` واحد لتعيين القيم للمتغيرات. دائماً، تحتاج **دائماً** إلى وضع اثنين من--= = ``--إذا كنت ترغب في معرفة ما إذا كانت الأمور مساوية لبعضها البعض. يمكننا أن نقول أيضا أن الأمور غير متساوية مع بعضها البعض. لذالك نستخدم هذه الرموز `!=` كما هو مبين في المثال أعلاه.
+
+أعطي بايثون مهمتان اخرتان:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+لقد شهدنا `>` و `<`، ولكن ما فعله `> =` و `< =` يعني؟ اقرأهم بهذه الطريقة:
+
+- `x_>` y يعني: x أكبر من y
+- `x_<` y يعني: x أقل من y
+- x `<=` y يعني: x أقل من أو يساوي y
+- x `> =` يعني y: x أكبر من أو يساوي y
+
+رائع! تريد القيام بذالك مرة اخرى؟ جرب هذا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+يمكنك أن تعطي بايثون العديد من الأرقام للمقارنة كما تريد، وسوف تعطيك الجواب! ذكية جدا، أليس كذلك؟
+
+- **و**-إذا قمت باستخدام عامل التشغيل `and`، كل المقارنات يجب أن تكون صحيحة في النظام لكي يكون الأمر كله صحيح
+- **أو** – إذا كنت تستخدم عامل التشغيل `or`، واحد فقط من المقارنات يجب أن يكون صحيحاً في النظام لكي يكون الأمر كله صحيح
+
+هل سمعت عبارة "مقارنة التفاح بالبرتقال"؟ دعونا نحاول ما يعادل بايثون:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+هنا ترى أنه كما هو الحال في التعبير، بايثون غير قادرة على مقارنة عدد(`int`) وسلسلة (`str`). بدلاً من ذلك، فإنه يظهر **TypeError** ويقول لنا لا يمكن مقارنة هذين النوعين معا.
+
+## Boolean
+
+وبالمناسبة، لقد تعلمت للتو نوع جديد من الكائنات في بايثون. تسمى **Boolean**.
+
+هناك اثنين فقط من كائنات Boolean :
+
+- صحيح
+- خطأ
+
+لتفهم بايثون ذالك ، تحتاج الى كتابتها دائما ك "صحيح" (الحرف الأول كبير، مع بقية الحروف صغيرة). **true, TRUE,، وtRUE لن تنجح – الوحيدة التي ستنجح هي True.** (نفس الأمر ينطبق على 'False' كذلك، بطبيعة الحال.)
+
+يمكن أن تكون Booleans متغيرات، أيضا! انظر هنا:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+يمكنك أيضا القيام بذلك بهذه الطريقة:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+تدرب واستمتع مع Booleans قبل محاولة تشغيل الأوامر التالية:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+مبروك! Booleans واحدة من أروع ملامح البرمجة، وانت تعلمت للتو كيفية استخدامها!
+
+# احفظه!
+
+> للقراء في المنزل: هذا الفصل تم التكلم عنه في فيديو [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk).
+
+حتى الآن كنا نكتب كل ما لدينا من تعليمات بايثون في المترجم، مما يحدنا من إدخال سطر واحد من التعليمات البرمجية في وقت واحد. يتم حفظ البرامج العادية في الملفات ويتم تنفيذها من قبل لغتنا البرمجية **interpreter** أو **compiler**. حتى الآن كنا نقوم بتشغيل برامجنا سطر واحد في كل مرة في بايثون **interpreter**. سنحتاج إلى أكثر من سطر واحد من التعليمات البرمجية للمهام القليلة التالية، لذلك سنحتاج بسرعة إلى:
+
+- قم بإنهاء مترجم بايثون
+- فتح محرر التعليمات البرمجية لدينا الاختيار
+- حفظ بعض التعليمات البرمجية في ملف بايثون جديد
+- تشغيله!
+
+للخروج من مترجم بايثون كنا نستعمل، ببساطة اكتب دالة `exit()`
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+سيؤدي ذلك إلى إعادة توجيهك إلى موجه الأوامر.
+
+في وقت سابق، اخترنا محرر رموز من قسم [code editor](../code_editor/README.md). سنحتاج إلى فتح المحرر الآن وكتابة بعض الأكواد في ملف جديد:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+ومن الواضح أنك مطور بايثون محنك جداً الآن، لذا لا تتردد في كتابة بعض التعليمات البرمجية التي تعلمتها اليوم.
+
+الآن نحن بحاجة إلى حفظ الملف وإعطائه اسماً وصفياً. دعونا نسمي الملف **python_intro.py** وحفظه إلى سطح المكتب الخاص بك. يمكننا تسمية الملف أي شيء نريده، ولكن الجزء المهم هنا هو التأكد من انتهاء الملف ب **.py**. ويقول امتداد **.py** لنظام التشغيل أن هذا **Python executable file</0 وبايثون يمكن ان يشغله.</p> 
+
+> يجب أن تلاحظ واحدة من أروع شيء عن المحررين الأكواد: الألوان! في وحدة تحكم بايثون، كان كل شيء بنفس اللون. الآن يجب أن ترى أن الدالة `print` هي لون مختلف عن السلسلة. وهذا ما يسمى "syntax highlighting"، وهي ميزة مفيدة حقاً عند الترميز. سيعطيك لون الأشياء تلميحات مثل السلاسل غير المغلقة أو الأخطاء المطبعية في اسم الكلمة الرئيسية (مثل `def` في إحدى الدالات، والتي سنراها أدناه). وهذا أحد الأسباب التي تجعلنا نستخدم محرر تعليمات برمجية. :)
+
+مع الملف المحفوظ، حان الوقت لتشغيله! استخدم المهارات التي كنت قد تعلمت في قسم سطر الأوامر، استخدام التيرمينال **change directories** إلى سطح المكتب.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ar/signup_pythonanywhere.md b/ar/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/ar/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ar/template_extending/README.md b/ar/template_extending/README.md
new file mode 100644
index 00000000000..84d30c776be
--- /dev/null
+++ b/ar/template_extending/README.md
@@ -0,0 +1,147 @@
+# تمديد القالب
+
+شيء جميل آخر يقدمه جانغو لك هو **تمديد القالب **. ماذا يعني هذا؟ هذا يعني أنه يمكنك استخدام الأجزاء نفسها من HTML لصفحات مختلفة من موقعك على الويب.
+
+القوالب تساعدك عندما تريد استخدام نفس الشكل او المعلومات اكثر من مرة او في اكثر من مكان. ليس عليك تكرار نفسك في كل ملف. وإذا كنت ترغب في تغيير شيء ما، ليس عليك تغيره في كل قالب, بل ستغيره في قالب واحد!
+
+## أنشئ القالب الرئيسي
+
+القالب الرئيسي هو قالب اساسي والذي ستقوم بتمديده اثناء استخدامه في اي صفحة من موقعك.
+
+لنقم بإنشاء ملف `base.html` في `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+ثم افتحه وانسخ كل شيء من `post_list.html` إلى ملف `base.html`، مثل هذا:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+ثم في `base.html`، استبدل 1 (كل شيء بين 1 و `</body>`) مع هذا:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}قد تلاحض ان هذا قد غير `{% for post in posts %}` إلى `{% endfor %}` ب: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}{% endblock %}
+```
+
+لكن لماذا؟ لقد انشأت `كتلة`! استخدمت علامة القالب `{% block %}` لإنشاء منطقة التي ستضع فيها إتش تي أم ال HTML. ذاك HTML قادم من قالب اخر الذي قام بتمديد هذا القالب (`base.html`). نحن سنريك طريقة فعل ذالك خلال لحضات.
+
+الآن إحفظ `base.html` وإفتح `blog/templates/blog/post_list.html` مرة أخرى. {% raw %}ستحتاج لحدف كل شي فوق `{% for post in posts %}` وتحت `{% endfor %}`. عند الانتهاء من ذلك، الملف سيبدو هكذا:{% endraw %}
+
+{% filename %}blog/templates/blog/list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+نريد أن نستخدم هذه كجزء من قالبنا لجميع كتل المحتوى. حان الوقت لإضافة علامات الكتل لهذا الملف!
+
+{% raw %}You تريد لعلامة كتلتك ان تطابق العلامة في ملف `base.html`. تحتاج أيضا ان تشمل كافة التعليمات البرمجية التي تنتمي إليها في كتل المحتوى الخاص بك. للقيام بذلك، ضع كل شيء بين `{% block content %}` و `{% endblock %}`. مثل هذا: {% endraw %}
+
+{% filename %}blog/templates/blog/list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+بقي شيء واحد فقط. نحن بحاجة إلى ربط هذين القالبين معا. هذا ما نقصد به توسيع القوالب! سنفعل ذلك عن طريق إضافة علامة تمديد إلى بداية الملف. مثال:
+
+{% filename %}blog/templates/blog/list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+هذا كل شء! تحقق ان كان موقعك يعمل
+
+> اذا حصلت على هذا الخطأ `TemplateDoesNotExist`، وهذا يعني انه ليس هناك ملف`blog/base.html` ولديك `runserver` يشتغل في الكونسول. حاول إيقافه (بالضغط على Ctrl+C - مفتاح التحكم و C معا) وإعادة تشغيله من خلال تشغيل أمر  python manage.py runserver </ 0>.</p>
+</blockquote>
\ No newline at end of file
diff --git a/ar/whats_next/README.md b/ar/whats_next/README.md
new file mode 100644
index 00000000000..1b55afca08e
--- /dev/null
+++ b/ar/whats_next/README.md
@@ -0,0 +1,25 @@
+# ما هي الخطوة التالية؟
+
+هنئ نفسك ** أنت رائع تماما ** نحن فخورون بك! <3
+
+### ماذا يجب ان تفعل الأن؟
+
+خذ قسط من الراحة والاسترخاء. لقد فعلت للتو شيء ضخم حقا.
+
+بعد ذلك، تأكد من اتباع Django Girls على [ الفيسبوك ](http://facebook.com/djangogirls) أو [ تويتر ](https://twitter.com/djangogirls) للبقاء مطلعا على كل الأحداث.
+
+### هل يمكنك التوصية بأي موارد إضافية؟
+
+نعم! أولا، أمضي قدما وحاول تجربة هذا الكتاب [ Django Girls Tutorial: Extensions ](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+لاحقا، يمكنك تجربة الموارد المدرجة أدناه. نحن نوصي بها كلها!
+
+- [دجانغو البرنامج التعليمي الرسمي](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [دروس المبرمج المبتدئ](http://newcoder.io/tutorials/)
+- [كود أكاديمي: دروس بايثون](https://www.codecademy.com/en/tracks/python)
+- [كود أكاديمي دروس HTML & CSS](https://www.codecademy.com/tracks/web)
+- [دجانغو دروس الجزر](https://github.com/ggcarrots/django-carrots)
+- [كتاب تعلم بايثون بالطريقة الصعبة](http://learnpythonthehardway.org/book/)
+- [إبدأ مع دجانغو دروس الفيديو](http://www.gettingstartedwithdjango.com/)
+- [ملعقتان من جانغو 1.11: أفضل الممارسات لجانغو كتاب إطار الويب](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [ تطبيق مرحبا بالويب: تعلم كيفية بناء تطبيق على شبكة الإنترنت ](https://hellowebapp.com/) - يمكنك أيضا طلب ترخيص الكتاب الإلكتروني مجانا عن طريق الاتصال بتراسي أوسبورن في <tracy@limedaring.com>
\ No newline at end of file
diff --git a/az-AZ/GLOSSARY.md b/az-AZ/GLOSSARY.md
new file mode 100644
index 00000000000..5f7452b317e
--- /dev/null
+++ b/az-AZ/GLOSSARY.md
@@ -0,0 +1,3 @@
+# kod redaktoru
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/az-AZ/README.md b/az-AZ/README.md
new file mode 100644
index 00000000000..9878e43a938
--- /dev/null
+++ b/az-AZ/README.md
@@ -0,0 +1,51 @@
+# Django Girls Dərsliyi
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Bu iş Creative Commons Attribution-ShareAlike 4.0 Beynəlxalq Lisenziyası altında lisenziyalanmışdır. Bu lisenziyanın bir kopyasına baxmaq üçün, https://creativecommons.org/licenses/by-sa/4.0/ ünvanını ziyarət edin.
+
+## Xoş Gəldiniz
+
+Django Girls Dərsliyinizə xoş gəldiniz! Sizi burada görməyə şadıq. :) Bu dərslikdə, sizi veb texnologiyalar başlığı altında bir səyahətə aparacağıq, internetin bildiyimiz kimi işləməsi üçün bir araya gəlməsi lazım olan bütün hissə və parçalara nəzər salacağıq.
+
+Bütün bilinməyən şeylərdə olduğu kimi, bu da bir macəra dolu səyahət olacaq - ancaq narahat olmayın, çünki cəsarətiniz sayəsində buradasınız və daha da yaxşı olacaqsınız. :)
+
+## Giriş
+
+Heç (hələ də) əlaqə qurmadığınız texnologiyanın getdikcə dünya ilə daha çox əlaqəli olduğunu hiss etməmisiniz? Heç bir veb saytın necə hazırlandığı ilə maraqlanıb başlamaq üçün lazım olan motivasiyaya sahib olmamısınız? Proqram təminatı (kod) dünyasının sizin üçün özbaşına bir şeylərə cəhd etmək üçün çox mürəkkəb olduğunu düşünmüsünüz?
+
+Onda, sizə yaxşı xəbərimiz var! Proqramlaşdırma göründüyü qədər çətin deyil və biz sizə nə qədər əyləncəli ola biləcəyini göstərmək istəyirik.
+
+Bu dərslik bir sehrlə sizi proqramçıya çevirməyəcək. Əgər bu mövzuda yaxşı olmaq istəyirsinizsə, aylarla, hətta illərlə öyrənməyə və pratika etməyə ehtiyacınız var. Ancaq yenə də sizə göstərmək istəyirik ki, proqramlaşdırma və ya veb sayt yaratmaq göründüyü qədər mürəkkəb deyil. Müxtəlif hissələri bacardığımız qədər izah etməyə çalışacağıq ki, texnologiyadan artıq gözünüz qorxmasın.
+
+Ümid edirik ki, texnologiyanı sizə bizim qədər sevdirə biləcəyik!
+
+## Təlim boyunca nələr öyrənəcəksiniz?
+
+Dərsliyi bitirdikdən sonra kiçik bir işləyən veb tətbiqiniz olacaq: öz bloqunuz. Başqalarının işlərinizi görməsi üçün bloqunuzu necə onlayn edəcəyinizi göstərəcəyik!
+
+Aşağı yuxarı, belə bir görünüşü olacaq:
+
+![Şəkil 0.1](images/application.png)
+
+> Dərsliklə təkbaşına işləyirsinizsə və hər hansı bir problem zamanı sizə kömək edəcək bir məşqçiniz yoxdursa, sizin üçün bir söhbət sistemimiz var: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Məşqçilərimizdən və daha əvvəl qoşulan şəxslərdən vaxtaşırı orada olmalarını və dərslikdə başqalarına kömək etmələrini xahiş etdik! Orada suallarınızı verməkdən çəkinməyin!
+
+Yaxşı, [gəlin ən başdan başlayaq...](./how_the_internet_works/README.md)
+
+## Dərsi evdən izləmək
+
+Django Girls atelyesində iştirak etmək möhtəşəmdir, ancaq qoşulmağın həmişə mümkün ola bilməyəcəyini də anlayırıq. Buna görə də, bu dərsliyi evdə izləməyini tövsiyə edirik. Evdə oxuyanlar üçün, hazırda dərsliyi təkbaşına izləməyi asanlaşdıracaq videolar hazırlayırıq. Bu hələ də davam edən bir işdir, ancaq daha çoxu tezliklə [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube kanalında işıqlandırılacaq.
+
+Artıq əhatə olunmuş hər fəsildə, doğru videoya işarə edən bir bağlantı var.
+
+## Haqqında və töhfə vermə
+
+Bu dərs [DjangoGirls](https://djangogirls.org/) tərəfindən aparılır. Əgər səhv tapsanız və ya dərsliyi yeniləmək istəsəniz, zəhmət olmasa [töhfə təlimatlarını izləyin](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Bu dərsliyi başqa dillərə tərcümə etməyimizə kömək etmək istərdinizmi?
+
+Hal-hazırda, tərcümələr crowdin.com platformasında saxlanılır:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Əgər diliniz [crowdin](https://crowdin.com/)-dəki siyahıda yoxdursa, dili əlavə etməyimiz üçün zəhmət olmasa [yeni bir mövzu aç](https://github.com/DjangoGirls/tutorial/issues/new) vasitəsilə bizi məlumatlandırın.
\ No newline at end of file
diff --git a/az-AZ/SUMMARY.md b/az-AZ/SUMMARY.md
new file mode 100644
index 00000000000..d29ea6916c9
--- /dev/null
+++ b/az-AZ/SUMMARY.md
@@ -0,0 +1,35 @@
+# İcmal
+
+* [Giriş](README.md)
+* [Quraşdırma](installation/README.md) 
+  * [Əmr Sətri](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Kod Redaktoru](installation/README.md#code-editor)
+  * [Virtual Mühit](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Quraşdırma (chromebook)](chromebook_setup/README.md)
+* [İnternet necə işləyir](how_the_internet_works/README.md)
+* [Əmrlər sətrinə giriş](intro_to_command_line/README.md)
+* [Python-un quraşdırılması](python_installation/README.md)
+* [Kod redaktoru](code_editor/README.md)
+* [Python-a giriş](python_introduction/README.md)
+* [Django nədir?](django/README.md)
+* [Django-nun quraşdırılması](django_installation/README.md)
+* [İlk Django layihəniz!](django_start_project/README.md)
+* [Django modelləri](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Yerləşdir!](deploy/README.md)
+* [Django URL-ləri](django_urls/README.md)
+* [Django views – yaratmaq vaxtıdır!](django_views/README.md)
+* [HTML-ə giriş](html/README.md)
+* [Django ORM (Sorğu setləri)](django_orm/README.md)
+* [Şablon içində dinamik verilənlər](dynamic_data_in_templates/README.md)
+* [Django şablonları](django_templates/README.md)
+* [CSS – gözəlləşdirin](css/README.md)
+* [Şablonu genişləndirmə](template_extending/README.md)
+* [Tətbiqetmənizi genişləndirin](extend_your_application/README.md)
+* [Django Formları](django_forms/README.md)
+* [Növbədə nədir?](whats_next/README.md)
\ No newline at end of file
diff --git a/az-AZ/chromebook_setup/README.md b/az-AZ/chromebook_setup/README.md
new file mode 100644
index 00000000000..33cc417f7b5
--- /dev/null
+++ b/az-AZ/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook qurulumu
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/az-AZ/chromebook_setup/instructions.md b/az-AZ/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..89a515f0dce
--- /dev/null
+++ b/az-AZ/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Əgər Chromebook istifadə etmirsinizsə, [bu hissəni birbaşa keçə bilərsiniz.](http://tutorial.djangogirls.org/en/installation/#install-python) İstifadə edirsinizsə, qurulum biraz fərqli olacaq. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/az-AZ/code_editor/README.md b/az-AZ/code_editor/README.md
new file mode 100644
index 00000000000..84f5f961a3b
--- /dev/null
+++ b/az-AZ/code_editor/README.md
@@ -0,0 +1,11 @@
+# Kod redaktoru
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+Siz kodunuzun birinci sətrini yazmağa balamaq üzrəsiniz, odur ki, kod redaktoru yükləmək vaxtıdır!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/az-AZ/code_editor/instructions.md b/az-AZ/code_editor/instructions.md
new file mode 100644
index 00000000000..527c8232a60
--- /dev/null
+++ b/az-AZ/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Çoxlu müxtəlif editor proqramları (düzənləyici) var və hansını istifadə etmək şəxsi seçimdən asılıdır. Əksər Python proqramçıları qarışıq, amma çox güclü IDE(inteqrallaşdırılmış (birləşdirilmiş) proqramlaşdırma mühiti)-lərdən istifadə edir, məsələn PyCharm kimi. Lakin yeni başlayanlar üçün bu bir qədər az əlverişlidir. Bizim tövsiyə etdiklərimiz isə eyni dərəcədə güclü, amma çox daha sadədır.
+
+Bizim tövsiyyələrimiz aşağıdakılardır, amma öz müəlliminizdən də soruşa bilərsiniz.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Buradan yükləyin](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Buradan yükləyin](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Buradan yükləyin](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/az-AZ/css/README.md b/az-AZ/css/README.md
new file mode 100644
index 00000000000..8b2a1665260
--- /dev/null
+++ b/az-AZ/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Bizim blogumuz hələ də son dərəcə eybəcər görünür, hə? Onu gözəlləşdirmək vaxtıdır. Biz bunun üçün CSS istifadə edəcəyik.
+
+## CSS nədir?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Gəlin Bootstrap istifadə edək!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Bootstrapı Quraşdır
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Artıq çox gözəl görünür!
+
+## Django-da statik sənələr
+
+Nəhayət, biz **static files** adlandırılan sənədlərə daha yaxından baxacağıq. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Statik sənədləri (<0>static files</0>) Djangoda hara yerləşdirək
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/az-AZ/deploy/README.md b/az-AZ/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/az-AZ/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/az-AZ/deploy/install_git.md b/az-AZ/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/az-AZ/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/az-AZ/deploy/signup_pythonanywhere.md b/az-AZ/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/az-AZ/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/az-AZ/django/README.md b/az-AZ/django/README.md
new file mode 100644
index 00000000000..8c8e4236afe
--- /dev/null
+++ b/az-AZ/django/README.md
@@ -0,0 +1,27 @@
+# Django nədir?
+
+Django Python-da yazılmış ödənişsiz və açıq qaynaqlı internet tətbiq freymvörküdür. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/az-AZ/django_admin/README.md b/az-AZ/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/az-AZ/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/az-AZ/django_forms/README.md b/az-AZ/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/az-AZ/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/az-AZ/django_installation/README.md b/az-AZ/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/az-AZ/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/az-AZ/django_installation/instructions.md b/az-AZ/django_installation/instructions.md
new file mode 100644
index 00000000000..f654aae7361
--- /dev/null
+++ b/az-AZ/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual mühit(Virtual environment)
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Virtualenv ilə işləmək
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/az-AZ/django_models/README.md b/az-AZ/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/az-AZ/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/az-AZ/django_orm/README.md b/az-AZ/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/az-AZ/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/az-AZ/django_start_project/README.md b/az-AZ/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/az-AZ/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/az-AZ/django_templates/README.md b/az-AZ/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/az-AZ/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/az-AZ/django_urls/README.md b/az-AZ/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/az-AZ/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/az-AZ/django_views/README.md b/az-AZ/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/az-AZ/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/az-AZ/dynamic_data_in_templates/README.md b/az-AZ/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/az-AZ/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/az-AZ/extend_your_application/README.md b/az-AZ/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/az-AZ/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/az-AZ/how_the_internet_works/README.md b/az-AZ/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/az-AZ/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/az-AZ/html/README.md b/az-AZ/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/az-AZ/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/az-AZ/installation/README.md b/az-AZ/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/az-AZ/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/az-AZ/intro_to_command_line/README.md b/az-AZ/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/az-AZ/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/az-AZ/intro_to_command_line/open_instructions.md b/az-AZ/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/az-AZ/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/az-AZ/python_installation/README.md b/az-AZ/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/az-AZ/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/az-AZ/python_installation/instructions.md b/az-AZ/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/az-AZ/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/az-AZ/python_introduction/README.md b/az-AZ/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/az-AZ/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/az-AZ/template_extending/README.md b/az-AZ/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/az-AZ/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/az-AZ/whats_next/README.md b/az-AZ/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/az-AZ/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/az/GLOSSARY.md b/az/GLOSSARY.md
new file mode 100644
index 00000000000..5f7452b317e
--- /dev/null
+++ b/az/GLOSSARY.md
@@ -0,0 +1,3 @@
+# kod redaktoru
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/az/README.md b/az/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/az/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/az/SUMMARY.md b/az/SUMMARY.md
new file mode 100644
index 00000000000..c5543050c28
--- /dev/null
+++ b/az/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Kod redaktoru](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/az/chromebook_setup/README.md b/az/chromebook_setup/README.md
new file mode 100644
index 00000000000..03285106dfd
--- /dev/null
+++ b/az/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook qurulumu
+
+> **Not: **Yükləmə addımlarını tamamlamısınızsa, bunu yenidən etməyə ehtiyyac yoxdur. Birbaşa [Python-a Giriş](../python_introduction/README.md) qisminə keçə bilərsiniz.
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/az/chromebook_setup/instructions.md b/az/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..1b15cbaf97d
--- /dev/null
+++ b/az/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+Əgər Chromebook istifadə etmirsinizsə, [bu hissəni birbaşa keçə bilərsiniz.](http://tutorial.djangogirls.org/en/installation/#install-python) İstifadə edirsinizsə, qurulum biraz fərqli olacaq. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/az/code_editor/README.md b/az/code_editor/README.md
new file mode 100644
index 00000000000..da9d77ccdc2
--- /dev/null
+++ b/az/code_editor/README.md
@@ -0,0 +1,11 @@
+# Kod redaktoru
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+Siz kodunuzun birinci sətrini yazmağa balamaq üzrəsiniz, odur ki, kod redaktoru yükləmək vaxtıdır!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/az/code_editor/instructions.md b/az/code_editor/instructions.md
new file mode 100644
index 00000000000..fcaa89b9015
--- /dev/null
+++ b/az/code_editor/instructions.md
@@ -0,0 +1,31 @@
+Çoxlu müxtəlif editor proqramları (düzənləyici) var və hansını istifadə etmək şəxsi seçimdən asılıdır. Əksər Python proqramçıları qarışıq, amma çox güclü IDE(inteqrallaşdırılmış (birləşdirilmiş) proqramlaşdırma mühiti)-lərdən istifadə edir, məsələn PyCharm kimi. Lakin yeni başlayanlar üçün bu bir qədər az əlverişlidir. Bizim tövsiyə etdiklərimiz isə eyni dərəcədə güclü, amma çox daha sadədır.
+
+Bizim tövsiyyələrimiz aşağıdakılardır, amma öz müəlliminizdən də soruşa bilərsiniz.
+
+## Gedit
+
+Gedit açıq-qaynaq, ödənişsiz, bütün əməliyyat sistemlərini dəstəkləyən editordur.
+
+[Buradan yükləyin](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Buradan yükləyin](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Buradan yükləyin](https://atom.io/)
+
+## Biz nəyə görə kod editor quraşdırırıq?
+
+Sizə maraqlı gələ bilər ki, biz nəyə görə Word yaxud Notepad istifadə etmək yerinə bu xüsusi kod editor proqramı quraşdırırıq.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/az/css/README.md b/az/css/README.md
new file mode 100644
index 00000000000..fa7a6036195
--- /dev/null
+++ b/az/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Bizim blogumuz hələ də son dərəcə eybəcər görünür, hə? Onu gözəlləşdirmək vaxtıdır. Biz bunun üçün CSS istifadə edəcəyik.
+
+## CSS nədir?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Gəlin Bootstrap istifadə edək!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Bootstrapı Quraşdır
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Artıq çox gözəl görünür!
+
+## Django-da statik sənələr
+
+Nəhayət, biz **static files** adlandırılan sənədlərə daha yaxından baxacağıq. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Statik sənədləri (<0>static files</0>) Djangoda hara yerləşdirək
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/az/deploy/README.md b/az/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/az/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/az/deploy/install_git.md b/az/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/az/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/az/deploy/signup_pythonanywhere.md b/az/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/az/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/az/django/README.md b/az/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/az/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/az/django_admin/README.md b/az/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/az/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/az/django_forms/README.md b/az/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/az/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/az/django_installation/README.md b/az/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/az/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/az/django_installation/instructions.md b/az/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/az/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/az/django_models/README.md b/az/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/az/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/az/django_orm/README.md b/az/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/az/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/az/django_start_project/README.md b/az/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/az/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/az/django_templates/README.md b/az/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/az/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/az/django_urls/README.md b/az/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/az/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/az/django_views/README.md b/az/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/az/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/az/dynamic_data_in_templates/README.md b/az/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/az/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/az/extend_your_application/README.md b/az/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/az/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/az/how_the_internet_works/README.md b/az/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/az/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/az/html/README.md b/az/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/az/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/az/install_git.md b/az/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/az/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/az/installation/README.md b/az/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/az/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/az/instructions.md b/az/instructions.md
new file mode 100644
index 00000000000..30bd493b11b
--- /dev/null
+++ b/az/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command dnf is not found. In that case you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/az/intro_to_command_line/README.md b/az/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/az/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/az/python_installation/README.md b/az/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/az/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/az/python_installation/instructions.md b/az/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/az/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/az/python_introduction/README.md b/az/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/az/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/az/signup_pythonanywhere.md b/az/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/az/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/az/template_extending/README.md b/az/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/az/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/az/whats_next/README.md b/az/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/az/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/bg-BG/GLOSSARY.md b/bg-BG/GLOSSARY.md
new file mode 100644
index 00000000000..e066787b75e
--- /dev/null
+++ b/bg-BG/GLOSSARY.md
@@ -0,0 +1,3 @@
+# редактор на код
+
+Редакторът на код е приложение, което ти позволява да съхраняваш своя код за да можеш да продължиш с него по-късно. Може да научиш къде да намериш един от [главата Редактор на код](./code_editor/README.md)
\ No newline at end of file
diff --git a/bg-BG/README.md b/bg-BG/README.md
new file mode 100644
index 00000000000..c6d374c37b3
--- /dev/null
+++ b/bg-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! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Въведение
+
+Чувстваше ли някога, че светът все повече е свързан с технологиите, а ти оставаш в сянка? Мислеше как да създадеш уеб-сайт, но никога нямаше достатъчно мотивация да започнеш? Струвало ли ти се, че светът на софтуера е прекалено труден за теб да започнеш да правиш нещо сама?
+
+Имаме добра новина за теб! Програмирането не е толкова трудно, колкото изглежда, и ние искаме да ти покажем колко забавно може да бъде то.
+
+Това ръководство няма магически да те превърне в програмист. Ако искаш да си добра ще ти трябват месеци или даже години учене и упражняване. Но ние искаме да покажем, че програмирането или създаването на уебсайтове не е толкова сложно, колкото изглежда. Ще се постараем да обясним в детайли, колкото се може по-добре, за да не се чувстваш уплашена от технологиите.
+
+Надяваме се да те накараме да заобичаш технологиите толкова, колкото и ние ги обичаме!
+
+## Какво ще научиш от това ръководство?
+
+След като приключиш с ръководството, ще имаш малко работещо уеб-приложение: твоя собствен блог. Ще ти покажем как да го пуснеш в мрежата, така че другите да ти видят работата!
+
+Това ще изглежда (горе-долу) ето така:
+
+![Фигура 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), информирайки ни за езика, за да можем да го добавим.
\ No newline at end of file
diff --git a/bg-BG/SUMMARY.md b/bg-BG/SUMMARY.md
new file mode 100644
index 00000000000..7bba63767d5
--- /dev/null
+++ b/bg-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-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Инсталиране (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)
\ No newline at end of file
diff --git a/bg-BG/chromebook_setup/README.md b/bg-BG/chromebook_setup/README.md
new file mode 100644
index 00000000000..f6e4ee94c21
--- /dev/null
+++ b/bg-BG/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Настройка на Chromebook
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/bg-BG/chromebook_setup/instructions.md b/bg-BG/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..634a1224600
--- /dev/null
+++ b/bg-BG/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Можеш да [пропуснеш този раздел](http://tutorial.djangogirls.org/en/installation/#install-python), ако не използваш Chromebook. Ако използваш, опитът ти в инсталацията ще бъде малко по-различен. Можеш да игнорираш останалата част от инструкциите за инсталиране.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Облачна IDE е инструмент, която ти дава редактор на код и достъп до компютър, работещ в Интернет, където можеш да инсталираш, да пишеш и да пускаш софтуер. За продължителността на ръководството, облачната IDE ще ти служи като твоя *локална машина*. Все пак ще пишеш команди в терминал, също като твоите съученици на OS X, Ubuntu или Windows, но твоят терминал ще бъде свързан с компютър, работещ някъде другаде, който облачната IDE настройва за теб. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Можеш да избереш един от облачни IDE интерфейси и да следваш инструкциите за тази облачна 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. Можеш да промениш размера на прозореца, за да го направиш малко по-голям.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Виртуална среда
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/bg-BG/code_editor/README.md b/bg-BG/code_editor/README.md
new file mode 100644
index 00000000000..9d3b5025765
--- /dev/null
+++ b/bg-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, автоматично ще използваш редактора.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/bg-BG/code_editor/instructions.md b/bg-BG/code_editor/instructions.md
new file mode 100644
index 00000000000..b9ac32e5ccf
--- /dev/null
+++ b/bg-BG/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Има много различни редактори и това до голяма степен се свежда до личните предпочитания. Повечето програмисти на Python използват сложни, но изключително мощни IDE (интегрирани среди за разработка), като PyCharm. Като начинаещ обаче това вероятно е по-малко подходящо; нашите препоръки са еднакво мощни, но много по-прости.
+
+Нашите предложения са по-долу, но не се колебай да попиташ ментора си какви са техните предпочитания - по-лесно ще получиш помощ от тях.
+
+## Visual Studio Code
+
+Visual Studio Code е редактор на изходен код, разработен от Microsoft за Windows, Linux и macOS. Той включва поддръжка за отстраняване на грешки, вграден Git контрол, подчертаване на синтаксис, интелигентно попълване на код, фрагменти и рефакторинг на код.
+
+[Изтегли го тук](https://code.visualstudio.com/)
+
+## Gedit 
+
+Gedit е безплатен редактор с отворен код, достъпен за всички операционни системи.
+
+[Изтегли го тук](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text е много популярен редактор на код с безплатен период за оценка и е достъпен за всички операционни системи.
+
+[Изтегли го тук](https://www.sublimetext.com/3)
+
+## Atom 
+
+Atom е друг популярен редактор. Той е безплатен, с отворен код и се предлага за Windows, OS X и Linux. Atom е разработен от [GitHub](https://github.com/).
+
+[Изтегли го тук](https://atom.io/)
+
+## Защо инсталираме редактор на код?
+
+Може би се чудиш защо инсталираме този специален софтуер за редактиране на код, вместо да използваме нещо като Word или Notepad.
+
+Първата причина е, че кодът трябва да бъде **обикновен текст**, а проблемът с програми като Word и Textedit е, че те всъщност не произвеждат обикновен текст, те създават богат текст (с шрифтове и форматиране), използвайки персонализирани формати като [RTF (формат на обогатен текст)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+Втората причина е, че редакторите на код са специализирани за редактиране на код, така че те могат да предоставят полезни функции като подчертаване на код с цвят според значението му или автоматично затваряне на кавички за теб.
+
+Ще видим всичко това в действие по-късно. Скоро ще помислиш за надеждния си стар редактор на код като за един от любимите си инструменти. :)
\ No newline at end of file
diff --git a/bg-BG/css/README.md b/bg-BG/css/README.md
new file mode 100644
index 00000000000..e0dd41cb8a3
--- /dev/null
+++ b/bg-BG/css/README.md
@@ -0,0 +1,330 @@
+# CSS - направи го красиво!
+
+Блогът ни все още изглежда доста грозен, нали? Време е да го направиш хубав! За това ще използваме CSS.
+
+## Какво е CSS?
+
+Cascading Style Sheets (CSS) е език, използван за описание на външния вид и форматирането на уебсайт, написан на език за маркиране (като HTML). Отнасяй се към него като грим за нашата уеб страница. ;)
+
+Но не искаме отново да започнем от нулата, нали? Още веднъж ще използваме нещо, което програмистите пуснаха в интернет безплатно. Преосмислянето на колелото не е забавно.
+
+## Нека използваме Bootstrap!
+
+Bootstrap е една от най-популярните фреймуорки за HTML и CSS за разработване на красиви уебсайтове: https://getbootstrap.com/
+
+Той е написан от програмисти, които са работили за Twitter. Сега той е разработен от доброволци от цял свят!
+
+## Инсталирай Bootstrap
+
+За да инсталираш Bootstrap, отвори твоя `.html` файл в редактора на кода и го добави в секцията `<head>`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Това не добавя никакви файлове към твоя проект. То просто сочи файлове, които съществуват в Интернет. Затова продължи напред, отвори уебсайта си и актуализирай страницата. Ето го!
+
+![Фигура 14.1](images/bootstrap1.png)
+
+Вече изглежда по-хубав!
+
+## Статични файлове в Django
+
+Накрая ще разгледаме по-подробно тези неща, които наричахме **статични файлове**. Статичните файлове са всички ваши CSS и изображения. Съдържанието им не зависи от контекста на заявката и ще бъде едно и също за всеки потребител.
+
+### Къде да сложа статични файлове за Django
+
+Django вече знае къде да намери статичните файлове за вграденото приложение "admin". Сега трябва да добавим статични файлове за нашето собствено приложение, `blog`.
+
+Правим това, като създаваме папка, наречена `static` в блог приложението:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django автоматично ще открива всички папки, наречени 'static', в която и да е от папките на вашите приложения. Тогава то ще може да използва тяхното съдържание като статични файлове.
+
+## Твоят първи CSS файл!
+
+Нека сега създадем CSS файл, за да добавим свой собствен стил към твоята уеб страница. Създай нова директория, наречена `css` във твоята `static` директория. След това създай нов файл, наречен `blog.css` вътре в тази директория `css`. Готова?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Време е да напишеш малко CSS! Отвори файла `blog/static/css/blog.css` в твоя редактор на код.
+
+Тук няма да навлизаме твърде дълбоко в персонализирането и научаването на CSS. Има препоръка за безплатен CSS курс в края на тази страница, ако искаш да научиш повече.
+
+Но нека направим поне малко. Може би бихме могли да променим цвета на заглавията ни? За да разберат цветовете, компютрите използват специални кодове. Тези кодове започват с `#`, последвани от 6 букви (A–F) и цифри (0–9). Например кодът за синьо е `#0000FF`. Можеш да намериш цветовите кодове за много от цветовете тук: http://www.colorpicker.com/. Можеш също така да използваш [предварително определени цветове](http://www.w3schools.com/colors/colors_names.asp), като `red` и `green`.
+
+Във твоя `blog/static/css/blog.css` файл трябва да добавиш следния код:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` е CSS селектор. Това означава, че прилагаме стиловете си към всеки `a` елемент вътре в елемент `h1`; селекторът `h2 a` прави същото за елементи `h2`. Така че, когато имаме нещо като `<h1><a href="">връзка</a></h1>`, ще се прилага стилът `h1 a`. В този случай ние му казваме да промени цвета си на `#C25100`, което е тъмно оранжево. Или можеш да поставиш свой собствен цвят тук, но се увери, че той има добър контраст на бял фон!
+
+В CSS файл определяме стилове за елементи в HTML файла. Първият начин да идентифицираме елементите е с името на елемента. Може да ги запомниш като тагове от секцията HTML. Нещата като `a`, `h1` и `body` са примери за имена на елементи. Ние също така идентифицираме елементи по атрибут `class` или атрибут `id`. Class и id са имена, които сама даваш на елемента. Класовете определят групи от елементи, а идентификаторите сочат конкретни елементи. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Можеш да прочететеш повече за [CSS селектори в w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+Трябва също така да кажем на нашия HTML шаблон, че добавихме някои CSS. Отвори файла `blog/templates/blog/post_list.html` в редактора на кода и добави този ред в самото начало:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Тук просто зареждаме статични файлове. :) Между таговете `<head>` и `</head>`, след връзките към CSS файловете на Bootstrap, добави този ред:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Браузърът чете файловете в реда, в който са зададени, така че трябва да се уверим, че това е на правилното място. В противен случай кодът в нашия файл може да бъде отменен с кода във файлове Bootstrap. Току-що казахме на нашия шаблон къде се намира нашият CSS файл.
+
+Твоят файл сега трябва да изглежда така:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+ОК, запази файла и актуализирай сайта!
+
+![Фигура 14.2](images/color2.png)
+
+Добра работа! Може би също бихме искали да дадем на нашия уебсайт малко въздух и да увеличим полето от лявата страна? Нека опитаме това!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Добави това към твоя CSS, запиши файла и виж как работи!
+
+![Фигура 14.3](images/margin2.png)
+
+Може би можем да персонализираме шрифта в заглавието ни? Постави това в твоя `<head>` в `blog/templates/blog/post_list.html` файл:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Както и преди, провери поръчката и постави преди връзката към `blog/static/css/blog.css`. Този ред ще импортира шрифт, наречен *Lobster* от Google Fonts (https://www.google.com/fonts).
+
+Намери блока за деклариране `h1 a` (кодът между скобите `{` и `}`) в CSS файла `blog/static/css/blog.css`. Сега добави ред `font-family: 'Lobster';` между скобите и актуализирай страницата:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Фигура 14.3](images/font.png)
+
+Страхотно!
+
+Както бе споменато по-горе, CSS има концепция за класове. Те ви позволяват да назовете част от HTML кода и да приложите стилове само към тази част, без да засягате другите. Това може да бъде супер полезно! Може би имаш два div (от division, разделяне), които правят нещо различно (като заглавието и публикацията ти). Един клас може да ти помогне да ги накараш да изглеждат различно.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Сега ще добавим декларационни блокове към различни селектори. Селектори, започващи с `.`, се отнасят за класове. Има много страхотни ръководства и обяснения за CSS в мрежата, които могат да ти помогнат да разбереш следния код. Засега го копирай и постави във твоя `blog/static/css/blog.css` файл:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+След това заобиколи HTML кода, който показва публикациите с декларации за класове. Замени това:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+в `blog/templates/blog/post_list.html` с това:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Запази тези файлове и актуализирай уебсайта си.
+
+![Фигура 14.4](images/final.png)
+
+Ура! Изглежда страхотно, нали? Виж кода, който току-що поставихме, за да намериш местата, където добавихме класове в HTML и ги използвахме в CSS. Къде би направила промяната, ако искаш датата да е тюркоазена?
+
+Не се страхувай да се поинтересуваш с този CSS малко и се опитай да промениш някои неща. Играта с CSS може да ти помогне да разбереш какво правят различните неща. Ако счупиш нещо, не се притеснявай - винаги можеш да го отмениш!
+
+Наистина препоръчваме да вземеш безплатните онлайн курсове "Basic HTML & HTML5" и "Basic CSS" на [freeCodeCamp](https://learn.freecodecamp.org/). Те могат да ти помогнат да научиш всичко за правенето на уебсайтовете ти по-красиви с HTML и CSS.
+
+Готова ли си за следващата глава?! :)
\ No newline at end of file
diff --git a/bg-BG/deploy/README.md b/bg-BG/deploy/README.md
new file mode 100644
index 00000000000..1463edcbcc8
--- /dev/null
+++ b/bg-BG/deploy/README.md
@@ -0,0 +1,246 @@
+# Внедряване!
+
+> **Забележка** Следващата глава понякога може да бъде малко трудна за преминаване. Продължи и я завърши; внедряването е важна част от процеса на разработване на уебсайтове. Тази глава е поставена в средата на ръководството, така че твоят ментор да ти помогне с малко по-сложния процес на вдигане на уебсайта ти онлайн. Това означава, че все още можеш да завършиш ръководството самостоятелно, ако ти липсва време.
+
+Досега твоят уебсайт беше достъпен само на твоя компютър. Сега ще научите как да го прехвърлите в онлайн пространството! Разгръщането е процесът на публикуване на приложението ви в Интернет, така че хората най-накрая да могат да отидат и да видят приложението ви. :)
+
+Както научихте, уебсайт трябва да бъде разположен на сървър. В интернет има много доставчици на сървъри, ще използваме [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere е безплатен за малки приложения, които нямат твърде много посетители, така че определено засега ще ви бъде достатъчно.
+
+Другата външна услуга, която ще използваме е [GitHub](https://www.github.com), която е услуга за хостинг на код. Има и други, но почти всички програмисти имат GitHub акаунт в наши дни, а сега и вие!
+
+Тези три места ще бъдат важни за вас. Вашият локален компютър ще бъде мястото, където правите разработка и тестване. Когато сте доволни от промените, ще поставите копие на програмата си в GitHub. Вашият уебсайт ще бъде на PythonAnywhere и ще го актуализирате, като получите ново копие на вашия код от GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Стартираме нашето Git хранилище
+
+Git проследява промените в определен набор от файлове в т.нар. склад (или за кратко "репо"). Нека започнем еднo за нашия проект. Отворете конзолата и стартирайте тези команди в директорията `djangogirls`:
+
+> **Забележка** Проверете текущата си работна директория с команда `pwd` (Mac OS X / Linux) или `cd` (Windows), преди да инициализирате хранилището. Трябва да сте в папката `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Инициализирането на git хранилището е нещо, което трябва да направим само веднъж за всеки проект (и няма да се налага да въвеждате отново потребителското име и имейла).
+
+Git ще проследи промените във всички файлове и папки в тази директория, но има някои файлове, които искаме да игнорира. Правим това чрез създаване на файл, наречен `.gitignore` в основната директория. Отворете редактора си и създайте нов файл със следното съдържание:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+И го запишете като `.gitignore` в папката "djangogirls".
+
+> **Забележка** Точката в началото на името на файла е важна! Ако имате проблеми с създаването му (Macs не харесва да създавате файлове, които започват с точка чрез Finder, например), след това използвайте функцията "Save As" в редактора си; това е бронеустойчиво. И не забравяйте да добавите `.txt`, `.py` или друго разширение към името на файла - той ще бъде разпознат от Git само ако името е просто `.gitignore`. Linux и MacOS взимат файловете с име, което започва с `.` (като `.gitignore`) за скрити и нормалната команда `ls` няма да показва тези файлове. Вместо това използвайте `ls -a`, за да видите файла `.gitignore`.
+> 
+> **Забележка** Един от файловете, които сте посочили във вашия `.gitignore` файл е `db.sqlite3`. Този файл е вашата локална база данни, където се съхраняват всички ваши потребители и публикации. Ще следваме стандартната практика за уеб програмиране, което означава, че ще използваме отделни бази данни за вашия локален тестващ сайт и вашия уеб сайт на живо в PythonAnywhere. Базата данни на PythonAnywhere може да бъде SQLite, като вашата разработваща машина, но обикновено ще използвате такава, наречена MySQL, която може да се справи с много повече посетители на сайта, отколкото SQLite. Така или иначе, като игнорирате вашата SQLite база данни за копието на GitHub, това означава, че всички публикувани досега публикации и superuser ще бъдат достъпни само локално и ще трябва да създавате нови в производството. Трябва да мислите за вашата локална база данни като за добра площадка, където можете да тествате различни неща и да не се страхувате, че ще изтриете истинските си публикации от блога.
+
+Добра идея е да използвате команда `git status` преди `git add` или винаги, когато се окажете несигурни какво се е променило. Това ще ви помогне да предотвратите появата на изненади, като например добавяне или поемане на грешни файлове. Командата `git status` връща информация за всички непроследени/модифицирани/поетапни файлове, състоянието на клона и много други. Изходът трябва да бъде подобен на следното:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+И накрая спестяваме промените си. Отидете на конзолата си и изпълнете следните команди:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Избутване на кода ви към GitHub
+
+Отидете на [GitHub.com](https://www.github.com) и се регистрирайте за нов безплатен потребителски акаунт. (Ако вече сте го направили в подготвителната работилница, това е чудесно!) Не забравяйте да запомните паролата си (добавете я към вашия мениджър на пароли, ако използвате такъв).
+
+След това създайте ново хранилище, като му дадете името "my-first-blog". Оставете квадратчето за „инициализация с README“ отместено, оставете опцията .gitignore празна (направихме това ръчно) и оставете лиценза като None.
+
+![](images/new_github_repo.png)
+
+> **Забележка** Името `my-first-blog` е важно - бихте могли да изберете нещо друго, но това ще се случва много пъти в инструкциите по-долу и ще трябва да го замествате всеки път. Вероятно е по-лесно да се придържаме към името `my-first-blog`.
+
+На следващия екран ще се покаже URL за клониране на вашия склад, което ще използвате в някои от следващите команди:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Сега трябва да свържем Git хранилището на вашия компютър към това в GitHub.
+
+Въведете следното в конзолата си (заменете `<your-github-username>` с потребителското име, което сте въвели, когато сте създали акаунта си в GitHub, но без скобите - URL адресът трябва да съответства на клонирания URL адрес, който току-що видяхте):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Когато избутате кода към GitHub, ще бъдете попитани за вашето потребителско име и парола за GitHub (било то в прозореца на командния ред или в изскачащ прозорец), а след въвеждане на идентификационните данни трябва да видите нещо подобно:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Кодът ви вече е на GitHub. Отидете и го вижте! Ще откриете, че е в добра компания - [Django](https://github.com/django/django), [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial) и много други страхотни софтуерни проекти с отворен код също са домакини на кода си в GitHub. :)
+
+# Настройване на нашия блог на PythonAnywhere
+
+## Регистрирайте се за акаунт в PythonAnywhere
+
+> **Забележка** Може би вече сте създали акаунт в PythonAnywhere по-рано по време на стъпките за инсталиране - ако е така, няма нужда да го правите отново.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Конфигуриране на нашия сайт на PythonAnywhere
+
+Върнете се към главното табло [PythonAnywhere Dashboard](https://www.pythonanywhere.com/), като кликнете върху логото и изберете опцията за стартиране на конзола "Bash" - това е версията на командния ред PythonAnywhere, точно като тази на вашия компютър.
+
+![Секцията 'Нова конзола' в уеб интерфейса на PythonAnywhere, с бутон за 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Забележка** PythonAnywhere е базиран на Linux, така че ако сте на Windows, конзолата ще изглежда малко по-различна от тази на вашия компютър.
+
+Внедряването на уеб приложение в PythonAnywhere включва сваляне на кода от GitHub и конфигуриране на PythonAnywhere да го разпознае и да започне да го обслужва като уеб приложение. Има ръчни начини за това, но PythonAnywhere предоставя помощен инструмент, който ще свърши всичко за вас. Нека го инсталираме първо:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+Това трябва да отпечата някои неща като `Collecting pythonanywhere` и в крайна сметка да завърши с ред, който казва `Successfully installed (...) pythonanywhere- (...)`.
+
+Сега стартираме помощника за автоматично конфигуриране на приложението ви от GitHub. Въведете следното в конзолата на PythonAnywhere (не забравяйте да използвате потребителското си име на GitHub вместо `<your-github-username>`, така че URL адресът да съответства на клонираният URL от GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+Докато гледаш това да работи, ще можеш да видиш какво прави:
+
+- Изтегляне на вашия код от GitHub
+- Създаване на virtualenv на PythonAnywhere, точно като този на вашия собствен компютър
+- Актуализиране на вашия файл с настройки с някои настройки за внедряване
+- Настройка на база данни на PythonAnywhere с помощта на командата `manage.py migrate`
+- Настройка на статичните ви файлове (за тях ще научим по-късно)
+- И конфигуриране на PythonAnywhere да обслужва вашето уеб приложение чрез неговия API
+
+На PythonAnywhere всички тези стъпки са автоматизирани, но те са същите стъпки, които би трябвало да преминете с всеки друг доставчик на сървъри.
+
+Основното, което трябва да забележите в момента, е, че вашата база данни в PythonAnywhere всъщност е напълно отделена от вашата база данни на вашия собствен компютър, така че може да има различни публикации и администраторски акаунти. В резултат на това, точно както направихме на вашия собствен компютър, трябва да инициализираме администраторския акаунт с `createsuperuser`. PythonAnywhere автоматично активира вашия virtualenv за вас, така че всичко, което трябва да направите, е да стартирате:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Въведете данните за вашия администратор потребител. Най-добре е да използвате същите, които използвате на собствения си компютър, за да избегнете объркване, освен ако не искате да направите паролата на PythonAnywhere по-сигурна.
+
+Сега, ако желаете, можете също да разгледате кода си на PythonAnywhere, като използвате `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+Можете също да отидете на страницата „Файлове“ и да се придвижвате наоколо, използвайки вградения файлов браузър на PythonAnywhere. (От страницата на конзолата можете да стигнете до други страници на PythonAnywhere от бутона на менюто в горния десен ъгъл. След като сте на една от страниците, има връзки към другите в горната част.)
+
+## Вече сте на живо!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Забележка** Това е ръководство за начинаещи и при разгръщането на този сайт взехме няколко преки пътища, които не са идеални от гледна точка на сигурността. Ако и когато решите да надградите този проект или да започнете нов проект, трябва да прегледате [контролния списък за разгръщане на Django](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) за някои съвети относно осигуряването на вашия сайт.
+
+## Съвети за отстраняване на грешки
+
+Ако видиш грешка при изпълнението на скрипта `pa_autoconfigure_django.py`, ето няколко често срещани причини:
+
+- Забравяйки да създадете своя маркер за API на PythonAnywhere API.
+- Грешка в URL адреса ви в GitHub
+- Ако видите грешка, която казва *"Could not find your settings.py"*, вероятно защото не успяхте да добавите всичките си файлове в Git и/или не ги избутахте до GitHub успешно. Погледнете още един път раздела Git по-горе
+- Ако преди това сте се регистрирали за акаунт в PythonAnywhere и имате грешка с collectstatic, вероятно имате по-стара версия на SQLite (например 3.8.2) за вашия акаунт. В такъв случай се регистрирайте за нов акаунт и опитайте командите в секцията PythonAnywhere по-горе.
+
+Ако видите грешка, когато се опитвате да посетите вашия сайт, първото място за търсене на информация за отстраняване на грешки е във вашия **error log**. Ще намерите линк към това на страницата на PythonAnywhere ["Web"](https://www.pythonanywhere.com/web_app_setup/). Вижте дали има съобщения за грешки там; най-новите са най-отдолу.
+
+Също така има някои [общи съвети за отстраняване на грешки на помощния сайт на PythonAnywhere](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+И не забравяйте, че вашият ментор е тук, за да ви помогне!
+
+# Вижте вашия сайт!
+
+Страницата по подразбиране за вашия сайт трябва да гласи „It worked!“, точно както прави на вашия локален компютър. Опитайте да добавите `/admin/` в края на URL адреса и ще бъдете отведени до администраторския сайт. Влезте с потребителското име и паролата и ще видите, че можете да добавяте нови публикации на сървъра - не забравяйте, че публикациите от вашата локална база данни за тестове не бяха изпратени във вашия блог на живо.
+
+След като създадете няколко публикации, можете да се върнете към вашата локална настройка (не PythonAnywhere). От тук трябва да работите върху вашата локална настройка, за да направите промени. Това е често срещан работен процес в уеб разработката - правете промени локално, бутате тези промени в GitHub и изтегляте промените надолу към вашия уеб сървър на живо. Това ви позволява да работите и да експериментирате, без да нарушавате уеб сайта си на живо. Доста готино, а?
+
+Заслужавате *огромни* похвали! Сървърните внедрения са едни от най-трудните части на уеб разработката и често отнемат на хората няколко дни, преди да ги накарат да работят. Но вие имате своя сайт на живо, в реалния Интернет!
\ No newline at end of file
diff --git a/bg-BG/deploy/install_git.md b/bg-BG/deploy/install_git.md
new file mode 100644
index 00000000000..5d78ab9ce57
--- /dev/null
+++ b/bg-BG/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git е "система за контрол на версиите", използвана от много програмисти. Този софтуер може да проследява промените във файловете с течение на времето, така че да можете да заредите конкретни версии по-късно. Нещо като функцията „проследяване на промените“ в програми за текстообработка (например, Microsoft Word или LibreOffice Writer), но много по-мощна.
+
+## Инсталиране на Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Можете да свалите Git от [git-scm.com](https://git-scm.com/). Можеш да натиснеш „next“ на всички стъпки, с изключение на две: в стъпката, където се изисква да избереш твоя редактор, трябва да избереш Nano, и в стъпката, озаглавена „Настройка на вашата PATH среда“, избери "Използване на Git и незадължителни Unix инструменти от командния ред на Windows" (най-долната опция). Освен това, настройките по подразбиране са добре. Разгледайте Windows стил, Unix стил за окончанията на редовете е добре.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Свалете Git от [git-scm.com](https://git-scm.com/) и следвайте инструкцията.
+
+> **Забележка** Ако използвате OS X 10.6, 10.7 или 10.8, ще трябва да инсталирате версията на git от тук: [Инсталатор на Git за OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/bg-BG/deploy/signup_pythonanywhere.md b/bg-BG/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..007eba2cfe2
--- /dev/null
+++ b/bg-BG/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere е услуга за ползване на Python код на сървъри „в облака“. Ще използваме нея за хостинг на нашия сайт, на живо и в интернет.
+
+Ще направим блог, който изграждаме на PythonAnywhere. Регистрирайте се за акаунт за начинаещи в PythonAnywhere (безплатното ниво е добре, нямате нужда от кредитна карта).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![Страницата за регистрация в PythonAnywhere показва бутон за създаване на безплатен акаунт за начинаещи](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Забележка** Когато избирате вашето потребителско име тук, имайте предвид, че URL адресът на вашия блог ще приеме формата `yourusername.pythonanywhere.com`, така че изберете свой собствен прякор или име на блога. Също така, запомнете вашата парола (добавете я към вашия мениджър на пароли, ако използвате такъв).
+
+## Създаване на PythonAnywhere API токен
+
+Това е нещо, което трябва да направите само веднъж. Когато се регистрирате за PythonAnywhere, ще бъдете отведени до таблото си за управление. Намерете линка в горния десен ъгъл до страницата си „ Account“:
+
+![Връзка към акаунта в горния десен ъгъл на страницата](../deploy/images/pythonanywhere_account.png)
+
+след това изберете раздела, наречен "API token", и натиснете бутона с надпис "Create new API token".
+
+![Раздел на API токен на страницата „Акаунт“](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/bg-BG/django/README.md b/bg-BG/django/README.md
new file mode 100644
index 00000000000..b6f4ebe0064
--- /dev/null
+++ b/bg-BG/django/README.md
@@ -0,0 +1,27 @@
+# Какво е Django?
+
+Django (/ ˈdʒæŋɡoʊ / *jang-goh*) е безплатна и отворена уеб рамка, написана на Python. Уеб рамката е набор от компоненти, които ви помагат да развивате уеб сайтове по-бързо и по-лесно.
+
+Когато създавате уебсайт, винаги се нуждаете от подобен набор от компоненти: начин за справяне с удостоверяването на потребителя (регистрация, влизане, излизане), панел за управление на вашия уебсайт, формуляри, начин за качване на файлове и т. н.
+
+За ваше щастие, други хора отдавна забелязаха, че уеб разработчиците са изправени пред подобни проблеми при изграждането на нов сайт, така че те се обединиха и създадоха рамки (Django е една от тях), които ви дават готови компоненти за използване.
+
+Рамките съществуват за да ви спестяват нуждата да преоткривате колелото и да помогнат за облекчаване на част от разходи, когато създавате нов сайт.
+
+## Защо имате нужда от рамка?
+
+За да разберем за какво всъщност е Django, трябва да разгледаме по-отблизо сървърите. Първото нещо е, че сървърът трябва да знае, че искате той да ви обслужва уеб страница.
+
+Представете си пощенска кутия (порт), която се следи за входящи писма (заявки). Това се прави от уеб сървър. Уеб сървърът чете писмото и след това изпраща отговор с уеб страница. Но когато искате да изпратите нещо, трябва да имате някакво съдържание. А Django е нещо, което ви помага да създавате съдържанието.
+
+## Какво се случва, когато някой поиска уебсайт от вашия сървър?
+
+Когато заявката стигне до уеб сървър, тя се предава на Django, който се опитва да разбере какво всъщност се иска. Първо взема адреса на уеб страница и се опитва да разбере какво да прави. Тази част се прави от **urlresolver** на Django (обърнете внимание, че адресът на уебсайт се нарича URL - Uniform Resource Locator - така че името *urlresolver* има смисъл). Не е много умно - взема списък от модели и се опитва да съответства на URL адреса. Django проверява шаблоните отгоре надолу и ако нещо съвпада, Django предава заявката на свързаната функция (която се нарича *view*).
+
+Представете си пощенски превозвач с писмо. Тя върви по улицата и проверява всеки домашен номер спрямо този на писмото. Ако съвпада, тя поставя писмото там. Ето как работи urlresolver!
+
+Във функцията *view* се правят всички интересни неща: можем да разгледаме база данни, за да потърсим някаква информация. Може би потребителят иска да промени нещо в данните? Като писмо, в което се казва: „Моля, променете описанието на моята работа“. *view* може да провери дали ви е позволено да го направите, след това актуализира описанието на работата за вас и изпраща обратно съобщение: „Готово!“ Тогава *view* генерира отговор и Django може да го изпрати до уеб браузъра на потребителя.
+
+Описанието по-горе е малко опростено, но все още не е необходимо да знаете всички технически неща. Наличието на обща идея е достатъчно.
+
+Така че вместо да се гмурнем твърде много в детайли, ще започнем да създаваме нещо с Django и ще научим всички важни части по пътя!
\ No newline at end of file
diff --git a/bg-BG/django_admin/README.md b/bg-BG/django_admin/README.md
new file mode 100644
index 00000000000..6620805eda7
--- /dev/null
+++ b/bg-BG/django_admin/README.md
@@ -0,0 +1,57 @@
+# Администратор на Django
+
+За добавяне, редактиране и изтриване на публикациите, които току-що моделирахме, ще използваме администратора на Django.
+
+Нека отворим файла `blog/admin.py` в редактора на кода и заменим съдържанието му с това:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Както можете да видите, ние импортираме (включваме) модела Post, дефиниран в предишната глава. За да направим модела ни видим на страницата на администратора, трябва да регистрираме модела с `admin.site.register(Post)`.
+
+Добре, време да разгледаме нашия модел Post. Не забравяйте да стартирате `python manage.py runserver` в конзолата, за да стартирате уеб сървъра. Отидете до вашия браузър и напишете адреса http://127.0.0.1:8000/admin/. Ще видите страница за вход като тази:
+
+![Страница за вход](images/login_page2.png)
+
+За да влезете, трябва да създадете *superuser* - потребителски акаунт, който има контрол върху всичко в сайта. Върнете се в командния ред, напишете `python manage.py createsuperuser` и натиснете enter.
+
+> Не забравяйте, че за да пишете нови команди, докато уеб сървърът работи, отворете нов прозорец на терминала и активирайте своя virtualenv. Прегледахме как да пишете нови команди във **Вашия първи проект на Django!**, в секцията **Стартиране на уеб сървъра**.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Когато бъдеш подканена, въведи потребителското си име (малки букви, без интервали), имейл адрес и парола. **Не се притеснявайте, че не можете да видите паролата, която въвеждате - така трябва да бъде.** Въведете я и натиснете `enter`, за да продължите. Резултатът трябва да изглежда така (където потребителското име и имейл трябва да са ваши собствени):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Върнете се в браузъра си. Влезте с избраните от вас име и парола на superuser; трябва да видите таблото за управление на Django.
+
+![Django администратор](images/django_admin3.png)
+
+Отидете на постове и експериментирайте малко с тях. Добавете пет или шест публикации в блога. Не се притеснявайте за съдържанието - вижда се само на вашия локален компютър - можете да копирате и поставите някакъв текст от това ръководство, за да спестите време. :)
+
+Уверете се, че поне две или три публикации (но не всички) имат зададена дата на публикуване. По-късно ще бъде полезно.
+
+![Django администратор](images/edit_post3.png)
+
+Ако искате да знаете повече за администратора на Django, трябва да проверите документацията на Django: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Това вероятно е подходящ момент да вземете кафе (или чай) или нещо за хапване, за да се "заредите". Създадохте първия си модел Django - заслужавате малка почивка!
\ No newline at end of file
diff --git a/bg-BG/django_forms/README.md b/bg-BG/django_forms/README.md
new file mode 100644
index 00000000000..487e7b6a043
--- /dev/null
+++ b/bg-BG/django_forms/README.md
@@ -0,0 +1,481 @@
+# Django форми
+
+Последното нещо, което искаме да направим в нашия уеб сайт е да създадем начин за добавяне и редактиране на публикации в блога. Django администратора е супер, но е по-трудно да се персонализира и направи приятно на външен вид. С формите ще имаме абсолютно надмощие над нашия изглед - можем да правим почти всичко което може да си представим!
+
+Хубавото на Django формите е, че може да дефинираме форма от самото начало или да създадем ModelForm, в която ще съхраняваме резултатът от формата на модела.
+
+Точно това искаме да направим: ще създадем форма за нашия `Post` модел.
+
+Като всяка важна част от Django, формите също имат собствен файл: `forms.py`.
+
+Трябва да създадем файл с това наименование в директорията на `blog`.
+
+    blog
+       └── forms.py
+    
+
+И така, нека да отворим IDE и напишем следният код:
+
+{% filename %}blog/forms.py{% endfilename %} 
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Първо трябва да въведем Django формите (`from django import forms`) и нашия `Post` модел (`from .models import Post`).
+
+`PostForm`, както забелязахте е името на нашата форма. Трябва да кажем на Django, че тази форма е `ModelForm` (така че Django да направи малко магия за нас) - `forms.ModelForm` отговаря за това.
+
+След това с `class Meta`, казваме на Django кой модел трябва да се използва за да се създаде тази форма (`model = Post`).
+
+Най-накрая трябва да кажем с какви полета ще разполагаме в нашата форма. При този сценарий искаме само title и text да бъдат показани – author ще бъде този, който в момента е влязъл с профила си (ти!) и created_date трябва автоматично да се създаде, когато започнем нова публикация (като в кода), нали?
+
+И това е! Всичко от което имаме нужда в момента е да използваме формата във изгледа и да я покажем в шаблона.
+
+И така още веднъж, ще създадем връзка до страницата чрез URL, view и template.
+
+## Връзка до страницата чрез формата
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new изглед
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Шаблон (Template)
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* Трябва да покажем формата. Можем да направим това чрез (например) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Трябва ни бутон `Save`. Това правим с HTML button: `<button type="submit">Save</button>`.
+* И най-накрая, точно след отварящия `<form ...>` tag трябва да добавим {% raw %}`{% csrf_token %}`{% endraw %}. Това е много важно, тъй като прави нашата форма надеждна! Ако забравите за това, Django ще се оплаче когато се опитате да запазите формата.
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Запазване на формата
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Проверка на формите (Form validation)
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Редактиране на формата
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Сигурност
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Още едно нещо: време за deploy
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* Първо съхранете новия си код и го пратете към GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* След това в [PythonAnywhere Bash конзолата](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Накрая отидете на ["Web" страница](https://www.pythonanywhere.com/web_app_setup/), използвайте бутона от менюто в горният десен ъгъл на конзолата) и натиснете **Reload**. Опреснете блога си https://subdomain.pythonanywhere.com за да видите промените.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/bg-BG/django_installation/README.md b/bg-BG/django_installation/README.md
new file mode 100644
index 00000000000..9af34473be4
--- /dev/null
+++ b/bg-BG/django_installation/README.md
@@ -0,0 +1,7 @@
+# Инсталиране на Django
+
+> **Забележка** Ако използвате Chromebook, пропуснете тази глава и се уверете, че следвате инструкциите [Настройка на Chromebook](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/bg-BG/django_installation/instructions.md b/bg-BG/django_installation/instructions.md
new file mode 100644
index 00000000000..745b3163121
--- /dev/null
+++ b/bg-BG/django_installation/instructions.md
@@ -0,0 +1,231 @@
+> Част от този раздел е базирана на ръководства от Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Част от този раздел е базирана на [django-marcador ръководство](http://django-marcador.keimlink.de/) лицензиранo съгласно Creative Commons Attribution-ShareAlike 4.0 International License. Ръководството django-marcador е защитено с авторско право от Markus Zapke-Gründemann et al.
+
+## Виртуална среда
+
+Преди да инсталираме Django, ще ви накараме да инсталирате изключително полезен инструмент, който да ви помогне да поддържате средата си на кодиране подредена на вашия компютър. Възможно е да пропуснете тази стъпка, но силно се препоръчва. Като започнете с възможно най-добрата настройка, ще ви спести много проблеми в бъдеще!
+
+Така че, нека създадем **виртуална среда** (наричана още *virtualenv*). Virtualenv ще изолира вашата настройка на Python/Django на база проект. Това означава, че всички промени, които правите в един уебсайт, няма да засегнат други, които също разработвате. Яко, нали?
+
+Всичко, което трябва да направите, е да намерите директория, в която искате да създадете `virtualenv`; вашата начална директория, например. В Windows може да изглежда като `C:\Users\Name` (където `Name` е името на вашия логин).
+
+> **ЗАБЕЛЕЖКА:** В Windows се уверете, че тази директория не съдържа акцентирани или специални знаци; ако вашето потребителско име съдържа символи с ударение, използвайте друга директория, например, `C:\djangogirls`.
+
+За това ръководство ще използваме нова директория `djangogirls` от вашата домашна директория:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Ще направим virtualenv, наречен `myvenv`. Общата команда ще бъде във формата:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+За да създадеш нов `virtualenv`, трябва да отвориш командния ред и да стартираш `python -m venv myvenv`. Ще изглежда така:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Където `myvenv` е името на вашата `virtualenv`. Можете да използвате всяко друго име, но се придържайте към малки букви и не използвайте интервали, ударения или специални знаци. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Можем да създадем `virtualenv` и в Linux и OS X, като пуснем `python3 -m venv myvenv`. Ще изглежда така:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` е името на вашата `virtualenv`. Можете да използвате всяко друго име, но се придържайте към малки букви и не използвайте интервали. Също така е добре името да бъде кратко, понеже ще го използвате често!
+
+> **ЗАБЕЛЕЖКА:** В някои версии на Debian/Ubuntu може да получите следната грешка:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> В този случай следвайте инструкциите по-горе и инсталирайте пакета `python3-venv`: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **ЗАБЕЛЕЖКА:** При някои версии на Debian/Ubuntu инициирането на виртуалната среда като тази в момента дава следната грешка:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> За да заобиколите това, използвайте вместо това командата `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **ЗАБЕЛЕЖКА:** Ако получите грешка като
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> вместо това стартирайте:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Работа с virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Стартирайте виртуалната си среда като напишете:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. В този случай трябва да отворите нов прозорец на PowerShell като изберете "Run as Administrator." След това напишете следната команда преди да стартирате виртуалната си среда:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Промяна при политиката на изпълнението
+>         Политиката на изпълнението ви предпазва от скриптове на които нямате доверие. При промяна на политиката на изпълнение може да бъдете изложени на опасен риск описан в темата about_Execution_Policies help в http://go.microsoft.com/fwlink/?LinkID=135170. Искате ли да промените политиката на изпълнението? [Y] ДА [A] Да на всичко [N] Не [L] Не на всичко [S] Прекрати [?] Помощ (по подразбиране е "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> Предимството е, че не е необходимо да сменяте между прозорците на IDE и командния ред.
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Стартирайте виртуалната си среда като напишете:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Помнете, че трябва да заместите `myvenv` с името на вашата избрана `virtualenv`.
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %} 
+> 
+>     $ . myvenv/bin/activate
+>     
+>     
+
+<!--endsec-->
+
+Ще разбереш, че `virtualenv` е стартирана като видиш че подканата в конзолата ти започва с `(myvenv)`.
+
+Когато работите от виртуална среда, `python` автоматично ще се насочи към правилната версия, така че може да използвате команда `python` вместо `python3`.
+
+Добре, сега имаме всичкo необходимо на едно място. Най-накрая може да инсталираме Django!
+
+## Инсталиране на Django {#django}
+
+Сега след като имате стартирана `virtualenv` може да инсталирате Django.
+
+Преди да направим това обаче ще проверим дали имаме инсталирана последната версия на `pip`, софтуерът, който използваме да инсталираме Django:
+
+{% filename %}command-line{% endfilename %} 
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+    
+
+### Инсталиране на пакети с изисквания
+
+Файла съдържа лист от зависимости, които да се инсталират с командата `pip install`:
+
+Първо създайте файл с име `requirements.txt` в папка `djangogirls`, като използвате IDE инсталиран по-рано. Това става като отворите нов файл в редактора и след това го запазите като `requirements.txt` в папка `djangogirls/`. Вашата директория трябва да изглежда така:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+Във вашият `djangogirls/requirements.txt` файл трябва да добавите следното:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Сега напишете команда `pip install -r requirements.txt` за да инсталирате Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). Ако съдържа, моля помислете за друго място без разстояние, знак за ударение или други специални знаци (предложение: `C:\djangogirls`). Създайте нова виртуална среда в новата директория, след това изтрийте старата и опитайте отново командата. (Преместването на папката с виртуална среда няма да работи, тъй като виртуалната среда използва абсолютни пътеки.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> Ако получите грешка при извикване на pip при Ubuntu 12.04 напишете следната команда `python -m pip install -U --force-reinstall pip` за да оправите инсталацията на pip във виртуалната среда.
+
+<!--endsec-->
+
+Това е! Сега вече (най-накрая) сте готови да създадете Django апликация!
\ No newline at end of file
diff --git a/bg-BG/django_models/README.md b/bg-BG/django_models/README.md
new file mode 100644
index 00000000000..85aed520255
--- /dev/null
+++ b/bg-BG/django_models/README.md
@@ -0,0 +1,201 @@
+# Модели на Django
+
+Това, което искаме да създадем сега, е нещо, което ще съхранява всички публикации в нашия блог. Но за да можем да направим това, трябва да поговорим малко за неща, наречени `обекти`.
+
+## Обекти
+
+Има концепция в програмирането, наречена `обектно-ориентирано програмиране`. Идеята е, че вместо да пишем всичко като скучна последователност от инструкции за програмиране, можем да моделираме нещата и да определим как те си взаимодействат помежду си.
+
+И така, какво е обект? Това е съвкупност от свойства и действия. Звучи странно, но ще ви дадем пример.
+
+Ако искаме да моделираме котка, ще създадем обект `Cat`, който има някои свойства като `color`, `age`, `mood` (като добър, лош или сънен;)) и `owner` (на който може да бъде назначен обект `Person` - или може би в случай на бездомна котка, този свойство може да бъде празно).
+
+Тогава `Cat` има някои действия: `purr`, `scratch` или `feed` (в този случай ще дадем на котката `CatFood`, който може да бъде отделен обект със свойства, като `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+Така че в общи линии идеята е да се опишат реални неща в код със свойства (наречени `свойства на обекта`) и действия (наречени `методи`).
+
+Как ще моделираме публикации в блогове тогава? Искаме да изградим блог, нали?
+
+Трябва да отговорим на въпроса: Какво е публикация в блога? Какви свойства трябва да има?
+
+Е, със сигурност нашата публикация в блога се нуждае от текст с нейното съдържание и заглавие, нали? Също така би било хубаво да знаем кой го е написал - така че се нуждаем от автор. И накрая, искаме да знаем кога публикацията е създадена и публикувана.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Какви неща могат да се направят с публикация в блог? Би било хубаво да има някакъв `метод`, който публикува публикацията, нали?
+
+Така че ще се нуждаем от метод `publish`.
+
+Тъй като вече знаем какво искаме да постигнем, нека започнем да го моделираме в Django!
+
+## Django model
+
+Знаейки какво е обект, можем да създадем модел на Django за нашата публикация в блога.
+
+Моделът в Django е специален вид обект - той се записва в `database`. База данни е съвкупност от данни. Това е място, на което ще съхранявате информация за потребители, публикации в блога си и т.н. Ще използваме база данни SQLite, за да съхраняваме нашите данни. Това е адаптерът за база данни Django по подразбиране - това ще ни бъде достатъчно в момента.
+
+Можете да мислите за модел в базата данни като електронна таблица с колони (полета) и редове (данни).
+
+### Създаване на приложение
+
+За да поддържаме всичко подредено, ние ще създадем отделно приложение вътре в нашия проект. Много е хубаво да се организира всичко от самото начало. За да създадем приложение, трябва да стартираме следната команда в конзолата (от директорията `djangogirls`, където е файлът ` manage.py`):
+
+{% filename %}Mac OS X и Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Ще забележите, че се създава нова директория `blog` и сега съдържа редица файлове. Директориите и файловете в нашия проект трябва да изглеждат така:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+След създаването на приложение също трябва да кажем на Django, че трябва да го използва. Правим това във файла `mysite/settings.py` -- отваряме го във вашия редактор на кодове. Трябва да намерим `INSTALLED_APPS` и да добавим ред, съдържащ `'blog.apps.BlogConfig'`. Така че крайният продукт трябва да изглежда така:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Създаване на модел на блог публикация
+
+Във файла `blog/models.py` дефинираме всички обекти, наречени `Models` - това е място, на което ще дефинираме нашата публикация в блога.
+
+Нека да отворим `blog/models.py` в редактора на кода, да премахнем всичко от него и да напишем код така:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Проверете двукратно дали използвате два знака за подчертаване (`_`) от всяка страна на `str`. Тази конвенция се използва често в Python и понякога ги наричаме и „dunder“ (съкратено от „двойно-подчертаване“, "double-underscore").
+
+Изглежда страшно, нали? Но не се притеснявайте - ще ви обясним какво означават тези редове!
+
+Всички редове, започващи с `from` или `import`, са редове, които добавят части от други файлове. Така че вместо да копираме и поставяме едни и същи неща във всеки файл, можем да включим някои части с `from  ... import ...`.
+
+`class Post (models.Model):` - този ред дефинира нашия модел (това е `object`).
+
+- `class` е специална ключова дума, която показва, че дефинираме обект.
+- `Post` е името на нашия модел. Можем да му дадем различно име (но трябва да избягваме специални символи и бяло пространство). Винаги започвайте име на клас с главна буква.
+- `models.Model` означава, че публикацията е модел на Django, така че Django знае, че трябва да бъде записана в базата данни.
+
+Сега дефинираме свойствата, за които говорихме: `title`, `text`, `created_date`, `published_date` и `author`. За целта трябва да определим типа на всяко поле (текст ли е? Число? Дата? Отношение към друг обект, като User?)
+
+- `models.CharField` -- по този начин определяте текст с ограничен брой знаци.
+- `models.TextField` -- това е за дълъг текст без ограничение. Звучи идеално за съдържание в блог, нали?
+- `models.DateTimeField` -- това е дата и час.
+- `models.ForeignKey` -- това е връзка към друг модел.
+
+Тук няма да обясняваме всяка част от кода, тъй като това ще отнеме твърде много време. Трябва да разгледате документацията на Django, ако искате да знаете повече за моделните полета и как да дефинирате неща, различни от описаните по-горе (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field -types).
+
+Какво ще кажете за `def publish(self):`? Това е точно методът `publish`, за който говорихме преди. `def` означава, че това е функция/метод и `publish` е името на метода. Можете да промените името на метода, ако искате. Правилото за именуване е, че използваме малки букви и подчертавки вместо интервали (прасни места). Например метод, който изчислява средна цена, може да се нарече `calculate_average_price`.
+
+Методите често `връщат` нещо. Има пример за това в метода `__str__`. В този сценарий, когато извикаме `__str __ ()`, ще получим текст (**string**) със заглавие на публикацията.
+
+Също така забележете, че и двете `def publish(self):` и `def __str__(self):` са отредени в нашия клас. Тъй като Python е чувствителен към бялото пространство, трябва да отстъпим методите си вътре в класа. В противен случай методите няма да принадлежат към класа и можете да получите някакво неочаквано поведение.
+
+Ако нещо все още не е ясно за моделите, не се колебайте да попитате своя ментор! Знаем, че е сложно, особено когато научиш едновременно какво са обекти и функции. Но да се надяваме, че сега изглежда малко по-малко вълшебно за вас!
+
+### Създайте таблици за модели във вашата база данни
+
+Последната стъпка тук е да добавим нашия нов модел към базата данни. Първо трябва да накараме Django да разбере, че имаме някои промени в нашия модел. (Току-що го създадохме!) Отидете до прозореца на вашата конзола и напишете `python manage.py makemigrations blog`. Ще изглежда така:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Забележка:** Не забравяйте да запазите файловете, които редактирате. В противен случай компютърът ви ще изпълни предишната версия, която може да ви даде неочаквани съобщения за грешка.
+
+Django подготви миграционен файл за нас, който сега трябва да приложим към нашата база данни. Въведете `python manage.py migrate blog` и изходът трябва да бъде както следва:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Ура! Моделът ни на публикация вече е в нашата база данни! Би било хубаво да го видите, нали? Преминете към следващата глава, за да видите как изглежда вашата публикация!
\ No newline at end of file
diff --git a/bg-BG/django_orm/README.md b/bg-BG/django_orm/README.md
new file mode 100644
index 00000000000..411c10c96a7
--- /dev/null
+++ b/bg-BG/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM и QuerySets
+
+В тази глава ще научите как Django се свързва с базата данни и съхранява данни в нея. Нека се потопим!
+
+## Какво е QuerySet?
+
+QuerySet е по същество списък на обекти на даден Модел. QuerySets ви позволяват да четете данните от базата данни, да ги филтрирате и да ги подредите..
+
+Най-лесно е да се учи чрез пример. Нека опитаме това, нали?
+
+## Django shell
+
+Отворете вашата локална конзола (не на PythonAnywhere) и въведете тази команда:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Ефектът трябва да бъде такъв:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Вече си в интерактивната конзола на Django. Това е точно като Python подкана, но с допълнителна магия на Django. :) Тук можеш да използваш всички Python команди.
+
+### Всички обекти
+
+Нека се опитаме първо да покажем всички наши публикации. Можете да направите това със следната команда:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Ами сега! Появи се грешка. Това ни казва, че няма Post. Правилно е - забравихме да го внесем първо!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+Импортираме модела `Post` от `blog.models`. Нека опитаме отново да покажем всички публикации:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Това е списък на публикациите, които създадохме по-рано! Създадохме тези публикации чрез администраторския интерфейс на Django. Но сега искаме да създаваме нови публикации с помощта на Python, така че как да направим това?
+
+### Създаване на обект
+
+Ето как създавате нов обект Post в базата данни:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Но тук имаме една липсваща съставка: `me`. Трябва да предадем инстанция на модел `User` като автор. Как да направим това?
+
+Нека първо да импортираме модел User:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Какви потребители имаме в нашата база данни? Опитайте това:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+Това е суперпотребителят, който създадохме по-рано! Нека сега вземем потребителя (коригирайте този ред, за да използвате вашето потребителско име):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Както можете да видите, сега `get` a `User` с `username`, което се равнява на „ola“. Яко!
+
+Сега най-накрая можем да създадем нашия пост:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Ура! Искате ли да проверите дали работи?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Ето, още една публикация в списъка!
+
+### Добавете още публикации
+
+Вече можете да се позабавлявате малко и да добавяте още публикации, за да видите как работи. Добавете още две или три и след това преминете към следващата част.
+
+### Филтрирайте обекти
+
+Голяма част от QuerySets е възможността да ги филтрирате. Да речем, че искаме да намерим всички публикации, на които потребителят ola е автор. Ще използваме `filter` вместо `all` в `Post.objects.all()`. В скобите посочваме на кое условие(я) трябва да отговаря блог публикацията, за да се озове в нашия набор от заявки. В нашия случай условието е `author/0> да бъде равен на <code>me`. Начинът да го напишем в Django е `author=me`. Сега нашата част от кода изглежда така:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Или може би искаме да видим всички публикации, които съдържат думата 'title' в полето `title`?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Забележка** Има два знака за подчертаване (`_`) между `title` и `contains`. ORM на Django използва това правило за разделяне на имена на полета ("title") и операции или филтри ("contains"). Ако използвате само една долна черта, ще получите грешка като "FieldError: Не може да разреши ключовата дума title_contains".
+
+Можете също така да получите списък с всички публикувани публикации. Правим това, като филтрираме всички публикации, които имат `published_date` са зададени в миналото:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+За съжаление, публикацията, която добавихме от конзолата Python, все още не е публикувана. Но можем да променим това! Първо получете екземпляр от публикация, която искаме да публикуваме:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+И след това го публикувате с нашия метод `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Сега опитайте отново да получите списък с публикувани публикации (натиснете клавиша със стрелка нагоре три пъти и натиснете `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Подреждане на обекти
+
+QuerySets също ви позволяват да поръчате списъка с обекти. Нека се опитаме да ги поръчаме от полето `created_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Можем също да обърнем подреждането, като добавим `-` в началото:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Сложни заявки чрез свързване на методи
+
+Както видяхте, някои методи на `Post.objects` връщат QuerySet. Същите методи от своя страна могат също да бъдат извикани на QuerySet и след това ще върнат нов QuerySet. По този начин можете да комбинирате ефекта им, като ги **свържете** заедно:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Това е наистина мощно и ви позволява да пишете доста сложни заявки.
+
+Готино! Вече сте готови за следващата част! За да затворите конзолата, въведете това:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/bg-BG/django_start_project/README.md b/bg-BG/django_start_project/README.md
new file mode 100644
index 00000000000..da642fee45a
--- /dev/null
+++ b/bg-BG/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Вашият първи проект с Django!
+
+> Част от тази глава е базирана на ръководства от Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Части от тази глава са базирани на [django-marcador ръководство](http://django-marcador.keimlink.de/), лицензирано съгласно лиценза Creative Commons Attribution-ShareAlike 4.0 International. Ръководството на django-marcador е защитено с авторско право от Markus Zapke-Gründemann et al.
+
+Ще създадем малък блог!
+
+Първата стъпка е да започнете нов проект на Django. По принцип това означава, че ще изпълним някои скриптове, предоставени от Django, които ще създадат скелета на проект на Django за нас. Това е само куп директории и файлове, които ще използваме по-късно.
+
+Имената на някои файлове и директории са много важни за Django. Не трябва да преименувате файловете, които предстои да създадем. Преместването им на друго място също не е добра идея. Django трябва да поддържа определена структура, за да може да намери важни неща.
+
+> Не забравяйте да стартирате всичко във virtualenv (виртуалната среда). Ако не видите префикс `(myvenv)` в конзолата си, трябва да активирате своята virtualenv. Обяснихме как да направим това в главата **Инсталация на Django** в частта **Работа с virtualenv**. Въвеждането `myvenv\Scripts\activate`` в Windows или <0>source myvenv/bin/activate` в Mac OS X или Linux ще направи това вместо вас.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+Във вашата Mac OS X или Linux конзола трябва да изпълните следната команда. ** Не забравяйте да добавите точка `.` в края!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Точката `.` е от решаващо значение, тъй като казва на скрипта да инсталира Django във вашата текуща директория (за която точката `.` е препратка).
+> 
+> **Забележка** Когато пишете командата по-горе, не забравяйте, че въвеждате само частта, която започва от `django-admin`. Частта `(myvenv) ~/djangogirls$`, показана тук, е само пример за подкана, която ще покани твоето въвеждане във твоя команден ред.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+В Windows трябва да изпълните следната команда. **(Не забравяйте да добавите точка `.` в края)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Точката `.` е от решаващо значение, тъй като казва на скрипта да инсталира Django във вашата текуща директория (за която точката `.` е препратка).
+> 
+> **Забележка** Когато пишете командата по-горе, не забравяйте, че въвеждате само частта, която започва от `django-admin.exe`. Частта `(myvenv) C:\Users\Name\djangogirls>`, показана тук, е само пример за подкана, която ще покани твоето въвеждане във твоя команден ред.
+
+<!--endsec-->
+
+`django-admin.py` е скрипт, който ще създаде директории и файлове за вас. Сега трябва да имате структура на директория, която изглежда така:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Забележка**: в структурата на вашата директория ще видите и вашата `venv` директория, която създадохме преди.
+
+`manage.py` е скрипт, който помага при управлението на сайта. С него ще можем (освен всичко друго) да стартираме уеб сървър на нашия компютър, без да инсталираме нищо друго.
+
+Файлът `settings.py` съдържа конфигурацията на вашия уебсайт.
+
+Спомняте ли си, когато говорихме за пощенски превозвач, проверяващ къде да достави писмо? `urls.py` файлът съдържа списък от модели, използвани от `urlresolver`.
+
+За сега игнорираме останалите файлове, тъй като няма да ги променяме. Единственото нещо, което трябва да запомните, е да не ги изтриете случайно!
+
+## Промяна на настройките
+
+Нека направим някои промени в `mysite/settings.py`. Отворете файла с помощта на редактора на кода, който сте инсталирали по-рано.
+
+**Забележка**: Имайте предвид, че `settings.py` е обикновен файл, като всеки друг. Можете да го отворите от редактора на кода, като използвате "file -> open" от менюто. Това трябва да ви изведе обичайния прозорец, в който можете да се придвижите до вашия файл `settings.py` и да го изберете. Освен това можете да отворите файла, като отворите папката djangogirls на вашия работен плот и щракнете с десния бутон върху него. След това изберете редактора на кода от списъка. Изборът на редактора е важен, тъй като може да имате инсталирани други програми, които могат да отворят файла, но няма да ви позволят да го редактирате.
+
+Би било хубаво да имаме точното време на нашия уебсайт. Отидете в [списъка на часовите зони на Wikipedia](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) и копирайте съответната часова зона (ЧЗ) (напр. `Европа/Берлин`).
+
+В `settings.py` намерете реда, който съдържа `TIME_ZONE` и го модифицирайте, за да изберете своя собствена часова зона. Например:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+Езиков код се състои от езика, напр. `en` за английски или `de` за немски, и кодът на държавата, напр. `de` за Германия или `ch` за Швейцария. Ако английският не е вашият роден език, можете да добавите това, за да промените бутоните по подразбиране и известията от Django, за да бъдат на вашия език. Така че ще имате бутон „Отказ“, преведен на езика, който сте дефинирали тук. [Django идва с много подготвени преводи](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+Ако искате друг език, променете езиковия код, като промените следния ред:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Ще трябва също да добавим път за статични файлове. (Ще разберем всичко за статичните файлове и CSS по-късно в ръководството.) Слезте до *края* на файла и точно под надписа `STATIC_URL` добавете нов, наречен `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Когато `DEBUG` е `True` и `ALLOWED_HOSTS` е празен, хостът е валидиран срещу `['localhost', '127.0.0.1', '[::1]']`. Това няма да съвпада с името на хоста ни в PythonAnywhere, след като разширим нашето приложение, така че ще променим следната настройка:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Забележка**: Ако използвате Chromebook, добавете този ред в долната част на вашия settings.py файл:    `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Също така добавете `.amazonaws.com` към `ALLOWED_HOSTS`, ако използвате cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Създаване на база данни
+
+Има много различни софтуерни бази данни, които могат да съхраняват данни за вашия сайт. Ще използваме тази по подразбиране `sqlite3`.
+
+Това вече е настроено в тази част на вашия `mysite/settings.py` файл:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+За да създадем база данни за нашия блог, нека пуснем следното в конзолата: `python manage.py migrate` (трябва да бъдем в директорията `djangogirls`, която съдържа ` manage.py` файл). Ако това върви добре, трябва да видите нещо подобно:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... ОК
+    
+
+И ние сме готови! Време е да стартирате уеб сървъра и да видите дали уебсайтът ни работи!
+
+## Стартиране на уеб сървъра
+
+Трябва да сте в директорията, която съдържа файла `manage.py` (директорията `djangogirls`). В конзолата можем да стартираме уеб сървъра, като пуснем `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Ако сте на Chromebook, използвайте вместо това тази команда:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> Прегледахме как работят уеб сървърите в главата **Как работи Интернет**.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/bg-BG/django_templates/README.md b/bg-BG/django_templates/README.md
new file mode 100644
index 00000000000..2faa3f72cbf
--- /dev/null
+++ b/bg-BG/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django шаблони
+
+Време е да покажем на екран малко данни! Django има вградени **template tags** за тази цел.
+
+## Какви са тези шаблонни етикети?
+
+Виждате, в HTML не може наистина да пишете Python код, защото търсачките не го разбират. Те знаят само HTML. Знаем, че HTML е статичен, докато Python е по-динамичен.
+
+**Django template tags** ни позволяват да прехвърлим Python нещата към HTML, така че да изграждаме динамични сайтове по-бързо. Супер!
+
+## Показване на шаблон за лист от публикации
+
+В предишната глава дадохме на нашия шаблон лист от публикации с променливата `posts`. Сега ще го покажем на екран с HTML.
+
+За да отпечатаме променливата в шаблоните на Django, използваме къдрави скоби с името на променливата вътре ето така:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Пробвайте това във вашия шаблон `blog/templates/blog/post_list.html`. Отворете го в редактора си и заместете всичко от вторият `<div>` до третият `</div>` с `{{ posts }}`. Запазете файла и опреснете страницата за да видите резултатите:
+
+![Фигура 13.1](images/step1.png)
+
+Както може да видите, всичко което имаме е това:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Това означава, че Django го разбира като лист от обекти. Помните ли от **Въведение в Python** как показваме листове? Да, с for цикли! При Django шаблоните ги правим така:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Пробвайте това във вашия шаблон.
+
+![Фигура 13.2](images/step2.png)
+
+Работи! Но ние искаме публикациите ни да се показват като статичните публикации, които създадохме по-рано в главата **Въведение в HTML**. Можете да смесвате HTML с шаблони. Нашето `body` ще изглежда така:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %} 
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Всичко, което сложите между `{% for %}` и `{% endfor %}` ще се повтаря за всеки обект в листа. Опреснете страницата си: {% endraw %}
+
+![Фигура 13.3](images/step3.png)
+
+Забелязахте ли, че този път използвахме малко по-различно означение (`{{ post.title }}` или `{{ post.text }}`)? Достъпваме данните във всяко едно поле дефинирано в нашия `Post` модел. Също така `|linebreaksbr` изпраща текста на публикациите през филтър и превръща в абзаци.
+
+## Още едно нещо
+
+Ще е хубаво да видим дали уеб страницата ви работи в Internet, нали? Нека го прехвърлим отново на PythonAnywhere. Ето преглед на стъпките:
+
+* Първо, изпратете кода си към GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* След това влезте пак в [PythonAnywhere](https://www.pythonanywhere.com/consoles/) акаунта си и отидете на **Bash console** (или стартирайте нова) и напишете командите:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Не забравяйте да заместите `<your-pythonanywhere-domain>` с вашия актуален PythonAnywhere субдомейн, без скобите.)
+
+* Накрая отидете на ["Web" страница](https://www.pythonanywhere.com/web_app_setup/) и натиснете **Reload** на вашата апликация. (За да достигнете други PythonAnywhere страници от конзолата, използвайте бутона от менюто в горния десен ъгъл.) Вашете обновление трябва да съществува на https://subdomain.pythonanywhere.com -- проверете в търсачката си! Ако публикациите на вашата PythonAnywhere страница не съвпадат с тези, които се появяват на локалния ви сървър, това е нормално. Базата от данни на локалния ви компютър не са синхронизирани с останалите ви файлове на PythonAnywhere.
+
+Поздравления! Сега добавете нова публикация в администрацията на Django (помнете да добавите published_date!) Бъдете сигурни, че сте администрацията на Django на своята страница в pythonanywhere, https://subdomain.pythonanywhere.com/admin. След това презаредете страницата за да видите дали публикациите са налице.
+
+Работи безупречно? Горди сме с теб! Сега отстъпи от компютъра си за малко – заслужи си почивка. :)
+
+![Фигура 13.4](images/donut.png)
\ No newline at end of file
diff --git a/bg-BG/django_urls/README.md b/bg-BG/django_urls/README.md
new file mode 100644
index 00000000000..be16809c102
--- /dev/null
+++ b/bg-BG/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+Готови сме да създадем нашата първа уеб страница: начална страница на твоя блог! Но първо нека научим малко повече за Django URLs.
+
+## Какво е URL?
+
+URL е уеб адрес. Може да видиш URL всеки път когато посещаваш уебсайт – видимо е в полето за адрес на твоята търсачка. (Да! `127.0.0.1:8000` е URL! И `https://djangogirls.org` също е URL.)
+
+![URL](images/url.png)
+
+Всяка страница в Internet има нужда от собствен URL. По този начин твоето приложение знае какво трябва да покаже на потребителя, който отваря този URL. В Django използваме нещо наречено `URLconf` (URL конфигурация). URLconf е пакет от примери, които Django се опитва да съпостави със запитания URL за да намери правилния изглед.
+
+## Как работят URL в Django?
+
+Нека отворим файла `mysite/urls.py` в редактора си и видим как изглежда:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Както може да видите, Django вече е сложил нещо за нас тук.
+
+Редовете между трите кавички (`'''` or `"""`) се наричат docstrings – може да ги изписвате в началото на файла, класове или методи за да обясните какво прави кода - като коментар. Те няма да се изпълнят от Python.
+
+Администртивния URL, който посетихте в предната глава е вече тук:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Този ред означава, че за всеки URL, който започва с `admin/`, Django ще намери съответстващ изглед *view*. В този случай въвеждаме много администраторски URL, така че да не е претъпкано в този малък файл – по-четимо и по-чисто.
+
+## Твоя първи Django URL!
+
+Време е да създадете вашия първи URL! Искаме 'http://127.0.0.1:8000/' да бъде началната страница на нашия блог и да показва лист от публикации.
+
+Също така искаме да задържим файла `mysite/urls.py` чист, така че да въведем URL от нашата `blog` апликация към главният файл `mysite/urls.py`.
+
+Давайте напред, като добавите ред с който ще въведете `blog.urls`. Също ще искате да направите промени в `from django.urls…` реда, защото използваме функция `include`, така че вие трябва да добавите `import` към този ред.
+
+Вашият файл `mysite/urls.py` трябва да изглежда ето така:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django сега ще пренасочва всичко, което идва към 'http://127.0.0.1:8000/' до `blog.urls` и търси за следващи инструкции тук.
+
+## blog.urls
+
+Създайте нов файл с име `urls.py` в директория на `blog` и го отворете с редактора си. И така! Добавете следните два реда:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Тук въвеждаме функцията на Django `path` и всички наши изгледи ( `views`) от `blog` апликацията. (Все още нямаме никакви, но ще стигнем до там след минута!)
+
+След това можем да добавим наши първи URL образец:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+Както виждате, сега приписваме изгледа наречен `post_list` към началния (root) URL. Този URL образец ще съвпадне с празен низ и преобразувателя в Django URL ще игнорира домейн името (т.е.,http://127.0.0.1:8000/), което започва с пълния път на URL. Този образец казва на Django, че `views.post_list` е правилното място да отиде, ако някой влезе в сайта ви на адрес 'http://127.0.0.1:8000/'.
+
+Последната част, `name='post_list'</0, е името на URL, което ще бъде използване за идентифициране на изгледа. Това може да е също като името на изгледа, но може да е и нещо съвсем различно. Ние ще използваме именованите URL по-късно в нашият проект, тъй като е важно да се дадат имена на всеки URL в приложението. Също трябва да се опитаме да запазим имената на URL униканлни и лесни за запомняне.</p>
+
+<p>Ако сега се опитате да посетите http://127.0.0.1:8000/, ще видите съобщение от рода на 'web page not available' . Това е така, защото сървърът (помните командата <code>runserver`?) вече не е активен. Погледнете в конзолата на сървъра си и разберете защо.
+
+![Error (Грешка)](images/error1.png)
+
+Конзолата ви показва грешка, но не се тревожете – това всъщност е много полезно: Казва ви, **че няма атрибут с име 'post_list'**. Това е името на изгледа, който Django се опитва да намери и използва, но ние не сме го създали все още. На този етап, вашият `/admin/` също няма да работи. Не се тревожете – ще стигнем и до там. Ако виждате съобщение с друга греша, опитайте се да презаредите уеб сървъра. За да направите това, в конзолния прозорец, където сте пуснали сървъра, натиснете Ctrl+C за да го спрете (Ctrl + C заедно). На Windows може би трябва да натиснете Ctrl+Break. След това трябва да презаредите уеб сървъра като напишете командата `python manage.py runserver`.
+
+> Ако искате да научите повече за Django URLconfs, вижте в официалната документация: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/bg-BG/django_views/README.md b/bg-BG/django_views/README.md
new file mode 100644
index 00000000000..02efa058ccc
--- /dev/null
+++ b/bg-BG/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views - време за създаване!
+
+Време е да премахнем пречката, която създадохме в последната глава! :)
+
+*view* е мястото, където поставяме "логиката" на приложението ни. Ще изиска информация от моделът, който създадохме по-рано и ще го подаде на шаблона. Ще създадем шаблон в следващата глава. Изгледите са просто Python фукнции, които са малко по-сложни от тези, които написахме в главата **Въведение в Python**.
+
+Изгледите са във файла `views.py`. Ние ще добавим първи си изглед към файла `blog/views.py`.
+
+## blog/views.py
+
+И така, нека отворим файла в редактора си видим какво има в него:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Няма почти нищо все още.
+
+Помнете, че редовете, които започват с `#` са коментари – което означава, че тези редове няма да се четат от Python.
+
+Нека създадем *view* както коментара предлага да направим. Добавете следният минимален изглед под него:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Както забелязвате, създаваме фукнция (`def`) наречена `post_list`, която взима за стойност `request` ще върне друга функция `render`, взимайки стойността, шаблона и контекста.
+
+Запазете файла и отидете на http://127.0.0.1:8000/ за да видите какво имаме там.
+
+Друга грешка! Прочетете какво се случва сега:
+
+![Error (Грешка)](images/error.png)
+
+Това показва, че сървърът отново работи, но все още не изглежда както трябва, нали? Не се тревожете. Това е само страница с грешка, няма от какво да се страхувате! Също като съобщение с грешка в конзолата, тези са всъщност от голяма полза. Можете да прочетете, че *TemplateDoesNotExist*. Нека отстраним тази грешка и създадем шаблон в следващата глава!
+
+> Научете повече за Django изгледите като прочетете официалната документация: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/bg-BG/dynamic_data_in_templates/README.md b/bg-BG/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..bd03e45ec39
--- /dev/null
+++ b/bg-BG/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Динамични данни в шаблоните
+
+Имаме различни парчета на места: `Post` моделът е дефиниран в `models.py`, имаме `post_list` във `views.py` и добавен шаблон. Но как всъщност ще направим, така че нашите публикации да се показват на HMTL шаблон? Защото това е, което искаме да направим – да вземем някакво съдържание (запазените модели в базата от данни) и да се показват хубаво на нашия шаблон, нали?
+
+Това е точно, което *views* трябва да правят: свързват моделите с шаблоните. В нашия изглед за `post_list` ще трябва да вземем моделите, които искаме да показваме и да ги предадем на шаблоните. В изгледа ние определяме какво (модел) ще се изобразява в шаблона.
+
+Добре, как ще го постигнем?
+
+Трябва да отворим `blog/views.py` в редактора си. До момента `post_list` изгледа е такъв: 
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Помните ли когато говорихме за вмъкване на код написан в различни файлове? Сега е моментът, в който трябва да вмъкнем модела, който създадохме в `models.py`. Ще добавим реда `from .models import Post` така:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+Точката преди `models` означава настояща директория или настояща апликация. Двата файла `views.py` и `models.py` са в една и съща директория. Това означава, че можем да използваме `.` и името на файла (без разширението `.py`). Тогава въвеждаме името на модела (`Post`).
+
+Но след това какво? За да вземем всъщност публикация от `Post` модела ни трябва нещо наречено `QuerySet`.
+
+## QuerySet
+
+Вече трябва да сте запознати как работят QuerySets. Говорихме за тях в главата [Django ORM (QuerySets)](../django_orm/README.md).
+
+Сега искаме публикуваните ни блог постове сортирани по дата на публикуване, нали? Вече направихме това в главата QuerySets!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+И така, нека да отворим файла `blog/views.py` в редактора и добавим този код към функцията `def post_list(request)` -- но нека не забравяме първо да добавим `from django.utils import timezone`: 
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+За да покажем нашия QuerySet в списъка с публикации на нашия блог, ни остават две неща:
+
+1. Натиснете `posts` QuerySet в контекста на шаблона, като промените функцията `render`. Ще направим това сега.
+2. Променете шаблона да показва `posts` QuerySet. Ще разгледаме това в следващата глава.
+
+Моля забележете, че създадохме променлива за нашия QuerySet: `posts`. Ползвайте това като име на нашия QuerySet. От сега нататък можем да се отнасяме към него с това име.
+
+В `render` функцията имаме един параметър `request` (всичко се получава от потребителят чрез Internet) и друг даващ файла на шаблона (`'blog/post_list.html'`). Последният параметър, `{}`, е място в което може да добавим някакви неща, така че шаблона да ги използва. Трябва да им дадем имена (ще се придържаме към `'posts'` засега). :) Трябва да изглежда ето така: `{'posts': posts}`. Забележете, че частта преди `:` е низ; трябва да го заградите с кавички: `''`.
+
+И така накрая нашия файл `blog/views.py` трябва да изглежда така:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+Това е! Време е да се върнем към нашия шаблон и да покажем на екрана QuerySet!
+
+Искате да прочетете малко повече за QuerySets в Django? Трябва да погледнете тук: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/bg-BG/extend_your_application/README.md b/bg-BG/extend_your_application/README.md
new file mode 100644
index 00000000000..1017da252ae
--- /dev/null
+++ b/bg-BG/extend_your_application/README.md
@@ -0,0 +1,215 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Продължете апликацията си
+
+Вече завършихме всички различни стъпки необходими за създаването на нашия уеб сайт: знаем как да напишем модел, URL, изглед и шаблон. Знаем също и как да направим сайта ни хубав.
+
+Време е за практика!
+
+Първото нешо, което ни е необходимо за блога е очевидно страница, която да показва една публикация, нали така?
+
+Вече разполагаме с `Post` модел, така че няма нужда да правим промени в `models.py`.
+
+## Създайте връзка към шаблона със съдържанието на поста.
+
+Ще започнем като добавим връзка във файла `blog/templates/blog/post_list.html`. Отворете го в редактора си, като до момента трябва да изглежда по този начин: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %} Искаме да имаме връзка от заглавието на поста в листа с публикациите до страницата със съдържанието на поста. Нека променим `<h2><a href="">{{ post.title }}</a></h2>`, така че да се свързва със съдържанието на страницата:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %} Време е да обясним мистериозния код `{% url 'post_detail' pk=post.pk %}`. Може би забелязахте, че означението `{% %}` означава, че използваме Django шаблонни етикети. Този път ще изполваме такъв, който създава URL за нас! {% endraw %}
+
+`post_detail` частта означава, че Django трябва да очаква URL в `blog/urls.py` с име name=post_detail
+
+А какво за `pk=post.pk`? `pk` идва накратко от primary key, което е уникален идентификатор за всеки един запис в базата данни. Всеки Django модел има поле, което служи за негов първоначален код (primary key), и каквото и друго име да има, то може също да се съотнесе като "pk". Тъй като не уточнихме първоначалната стойност в нашия `Post` модел, Django създава един за нас (по подразбиране, полето "id" , съдържащо номер, който се увеличава при всеки запис, т.е. 1, 2, 3) и го добавя към полето на всеки от нашите постове. Можем да достигнем primary key като напишем `post.pk`, по същия начин достъпваме други полета (`title`, `author`, и т.н.) в нашия `Post` обект!
+
+Сега като отидем на http://127.0.0.1:8000/ ще видим грешка ( както се очаквкаше, тъй като все още нямаме URL или *view* за `post_detail`). Ще изглежда така:
+
+![NoReverseMatch грешка](images/no_reverse_match2.png)
+
+## Създаване на URL към съдържанието на поста
+
+Нека създадем URL в `urls.py` за нашия `post_detail` *view*!
+
+Искаме първия ни пост да бъде показван на този **URL**: http://127.0.0.1:8000/post/1/ 
+
+Сега да направим URL във файла `blog/urls.py`, който да насочва Django към *view* наречен `post_detail`, който ще показва целия блог пост. Отворете файла `blog/urls.py` в редактора си и добавете следния ред `path('post/<int:pk>/', views.post_detail, name='post_detail'),`, така че файлът да изглежда по този начин:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %} 
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+Тази част `post/<int:pk>/` уточнява URL образеца -- ще ви го обясним:
+
+- `post/` означава, че URL трябва да започва с думата **post** последвана от **/**. Дотук добре.
+- `<int:pk>` -- тази част е по-сложна. Означава, че Django очаква стойност цяло число и ще го преведе към изгледа (view) като променлива наречена `pk`.
+- `/` – след това ни е необходима **/** преди да завършим URL.
+
+Това означава, че когато напишем в търсачката си `http://127.0.0.1:8000/post/5/`, Django ще разбере, че търсите за *view* наречен `post_detail` и изпраща информацията, че този `pk` съответства на `5` спрямо този *view* (изглед).
+
+И така, добавихме нов URL образец към `blog/urls.py`! Нека презаредим страницата: http://127.0.0.1:8000/ Бум! Сървърът отново спря да работи. Погледнете в конзолата -- както се очакваше, има нова грешка!
+
+![AttributeError](images/attribute_error2.png)
+
+Помните ли каква е следващата стъпка? Добавяне на нов изглед (view)!
+
+## Добавяне на изглед за съдържанието на поста
+
+Този път на нашето *view* даваме допълнителен параметър, `pk`. Нашето *view* трябва да го прихване, нали? Така, ще дефинираме нашата функция като `def post_detail(request, pk):`. Забележете, че този параметър трябва да има точно същото име като на `urls` (`pk`), който уточнихме по-рано. Също така забележете, че пропускането на тази променлива е неправилно и в резултат ще доведе до грешка!
+
+Сега, искаме да вземем само и единствено една публикация. За да направим това, можем да използваме querysets ето така:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Но този код има проблем. Ако нямаме `Post` с даден `primary key` (`pk`) ще имаме много грозна грешка!
+
+![DoesNotExist грешка](images/does_not_exist2.png)
+
+Ние не искаме това! За щастие Django идва с нещо, с което да се справи вместо нас: `get_object_or_404`. В случай, че няма `Post` със зададен `pk`, ще се покаже на екрана много по-добре, `Page Not Found 404` страница. 
+
+![Page not found](images/404_2.png)
+
+Хубавото е, че всъщност и вие можете да си създадете такава страница `Page not found` и да я направите колкото си искате хубава. Но не е чак толкова важно в момента, затова ще го пропуснем.
+
+ОК, време е да добавим *view* към нашия файл `views.py`!
+
+В 0>blog/urls.py</code> създадохме URL правило наречено `post_detail`, което се отнася до изглед с име `views.post_detail`. Това означава, че Django ще очаква изглед функция наречена `post_detail` вътре в `blog/views.py`.
+
+Трябва да отворим `blog/views.py` в редактора и да добавим следния код близо до другите редове `from` :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+
+```
+
+И накрая на файла ще добавим нашия изглед (*view*):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Да. Време е да презаредим страницата: http://127.0.0.1:8000/
+
+![Post list view (Изглед с лист от постове)](images/post_list2.png)
+
+Работи! Но сега какво става, когато кликнете върху връзката със заглавието на поста?
+
+![TemplateDoesNotExist грешка](images/template_does_not_exist2.png)
+
+Оо, не! Друга грешка! Но вече знаем как да се справим с това, нали? Трябва да добавим нов шаблон!
+
+## Създайте шаблон за съдържанието на поста
+
+Ще създадем файл в `blog/templates/blog` наречен `post_detail.html`, и ще го отворим в редактора.
+
+Впишете следния код:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Още веднъж удължаваме `base.html`. В блока `content` искаме да покажем датата на публикуване на поста (ако същестрвува), заглавието и текста. Но трябва да обсъдим други важни работи, нали?
+
+{% raw %}`{% if ... %} ... {% endif %}` е шаблонен етикет, който използваме, когато искаме да проверим нещо. (Помните ли `if ... else ...` от главата ** Въведение в Python**?) В този случай искаме да проверим дали `published_date` (датата на публикване) на поста не е празна.{% endraw %}
+
+ОК, можем да отворим страницата ни наново и ще видим, че `TemplateDoesNotExist` сега го няма.
+
+![Post detail page (Страница със съдържанието на поста)](images/post_detail2.png)
+
+Ихаа! Работи!
+
+# Време за прехвърляне на файловете!
+
+Би било добре да видите дали сайта ви работи на PythonAnywhere нали? Нека опитаме да прехвърлим всичко отново.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Тогава, в [PythonAnywhere Bash конзолата](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Не забравяйте да замените `<your-pythonanywhere-domain>` с вашият актуален PythonAnywhere субдомейн, без скобите.)
+
+## Обновяване на статичните файлове на сървърът:
+
+Сървъри като PythonAnywhere обичат да се отнасят към "статичните файлове" (като CSS файлове) различно от Python файловете, защото те могат да оптимизират зареждането им по-бързо. В резултат, когато правим промени на нашите CSS файлове трябва да напишем допълнителни команди на сървъра за да му кажем да ги обнови. Командата се казва `collectstatic`.
+
+Започнете като активирате виртуалната си среда, ако не е активна от преди това (PythonAnywhere използва команда наречена `workon` да направи това, същото е както когато използваме команда `source myenv/bin/activate` на своя компютър.
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+Командата `manage.py collectstatic` е нещо като `manage.py migrate`. Правим промени на кода си, след това казваме на Django да приложи тези промени или към събраните статизни файлове на сървъра или към базата данни.
+
+Във всеки случай сега сме готови да отидем на ["Web" страницата](https://www.pythonanywhere.com/web_app_setup/) (от бутона на менюто в горния десен ъгъл) и натиснем **Reload**, след това погледнете страницата https://subdomain.pythonanywhere.com за да видите резултата.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/bg-BG/how_the_internet_works/README.md b/bg-BG/how_the_internet_works/README.md
new file mode 100644
index 00000000000..580b879e95f
--- /dev/null
+++ b/bg-BG/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Как работи интернет
+
+> За читателите у дома: тази глава е разгледана във видеото [Как работи интернет](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> Тази глава е вдъхновена от беседата "Как работи Интернет" от Джесика Маккелар (http://web.mit.edu/jesstess/www/).
+
+Обзалагаме се, че използвате интернет всеки ден. Но всъщност знаете ли какво се случва, когато въведете адрес като https://djangogirls.org в браузъра си и натиснете `enter`?
+
+Първото нещо, което трябва да разберете е, че уебсайтът се състои от куп файлове, записани на твърд диск - точно като вашите филми, музика или снимки. Има обаче една част, която е уникална за уебсайтовете: те включват компютърен код, наречен HTML.
+
+Ако не сте запознати с програмирането, в началото може да е трудно да разберете HTML, но вашите уеб браузъри (като Chrome, Safari, Firefox и др.) го харесват. Уеб браузърите са създадени да разбират този код, да следват неговите инструкции и да представят тези файлове, от които е направен уебсайтът ви, точно по начина, по който искате.
+
+Както при всеки файл, ние трябва да съхраняваме HTML файлове някъде на твърд диск. За интернет използваме специални, мощни компютри, наречени *сървъри*. Те нямат екран, мишка или клавиатура, защото основната им цел е да съхраняват данни и да ги предоставят. Ето защо те се наричат *сървъри* - защото те *предоставят* вашите данни.
+
+Добре, но искате да знаете как изглежда интернет, нали?
+
+Нарисувахме ви снимка! Изглежда така:
+
+![Фигура 1.1](images/internet_1.png)
+
+Прилича на каша, нали? Всъщност това е мрежа от свързани машини (гореспоменатите *сървъри*). Стотици хиляди машини! Много, много километри кабели по света! Можете да посетите уебсайта на Submarine Cable Map (http://submarinecablemap.com), за да видите колко сложна е мрежата. Ето екранна снимка от уебсайта:
+
+![Фигура 1.2](images/internet_3.png)
+
+Очарователно е, нали? Но не е възможно да има жица между всяка машина, свързана към Интернет. И така, за да достигнем машина (например тази, на която е записан https://djangogirls.org), трябва да предадем заявка през много, много различни машини.
+
+Изглежда така:
+
+![Фигура 1.3](images/internet_2.png)
+
+Представете си, че когато въвеждате https://djangogirls.org, изпращате писмо, което гласи: "Скъпи момичета на Django, искам да видя уебсайта djangogirls.org. Изпратете ми го, моля!"
+
+Вашето писмо отива до най-близката до вас поща. След това преминава към друга, която е малко по-близо до вашия адресат, след това към друга и друга, докато не бъде доставено до местоназначението си. Единственото уникално нещо е, че ако изпратите много писма (*пакети данни*) на едно и също място, те могат да преминат през напълно различни пощенски станции (*рутери*). Това зависи от начина, по който се разпределят във всеки офис.
+
+![Фигура 1.4](images/internet_4.png)
+
+Така става - изпращате съобщения и очаквате някакъв отговор. Вместо хартия и химикалка използвате байтове с данни, но идеята е същата!
+
+Вместо адреси с име на улица, град, пощенски код и име на държавата, използваме IP адреси. Вашият компютър първо пита DNS (система за имена на домейни) да преведе djangogirls.org в IP адрес. Тя работи малко като старомодни телефонни книжки, където можете да потърсите името на човека, с когото искате да се свържете, и да намерите техния телефонен номер и адрес.
+
+Когато изпращате писмо, то трябва да има определени функции, за да бъде доставено правилно: адрес, печат и т.н. Използвате и език, който приемникът разбира, нали? Същото се отнася и за *пакетите данни*, които изпращате, за да видите уебсайт. Ние използваме протокол, наречен HTTP (Hypertext Transfer Protocol).
+
+Така че, когато имате уебсайт, трябва да имате *сървър* (машина), където живее. Когато *сървърът* получи входяща *заявка* (с писмо), той изпраща обратно вашия уебсайт (с друго писмо).
+
+Тъй като това е ръководството на Django, може да попитате какво прави Django. Когато изпращате отговор, не винаги искате да изпращате едно и също нещо на всички. Много по-добре е, ако вашите писма са персонализирани, особено за човека, който току-що ви е писал, нали? Django ви помага при създаването на тези персонализирани, интересни писма. :)
+
+Достатъчно беседа - време за създаване!
\ No newline at end of file
diff --git a/bg-BG/html/README.md b/bg-BG/html/README.md
new file mode 100644
index 00000000000..f32488d74fa
--- /dev/null
+++ b/bg-BG/html/README.md
@@ -0,0 +1,227 @@
+# Въвeдение в HTML
+
+Може би се питате какво е шаблон (template)?
+
+Шаблонът е файл който, можем да използваме неколкократно за да представим различна информация в последователен формат -- например, можете да използвате шаблон, който да ви помага да напишете писмо, защото макар че всяко писмо да може да съдържа различно съобщение и да бъде адресирано до различен човек, те ще споделят същия формат.
+
+Django формат шаблона е описан в език наречен HTML (Това е HTML, който споменахме в главата **Как работи Internet**).
+
+## Какво е HTML?
+
+HTML е код, който се интерпретира от търсачките -- като Chrome, Firefox, Safari -- за да покаже на екран страницата на потребителя.
+
+HTML идва от "HyperText Markup Language". **HyperText** означава, че е тип от текст който подпомага хипервръзки между страници. **Markup** означава, че сме взели документа и сме го означили с код за да кажем нещо (в този случай, търсачка) как да подразбира страницата. HTML кода е изграден от **tags** (етикети), всеки от които стартира с `<` и завършва с `>`. Тези етикети представляват маркирани елементи (**elements**).
+
+## Първият ви шаблон!
+
+Създаване на шаблон означава създаване на шаблонен файл. Всичко е файл, нали? Може би вече забелязахте това.
+
+Шаблоните се запазват в директория `blog/templates/blog`. Така че, първо създайте директория наречена `templates` в директорията на блога ви. След това създайте друга директория наречена `blog` вътре при вашите шаблони:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(Може би се чудите защо са ни нужни две директории наречени `blog` -- както ще откриете по-късно, това е много лесно установена практика, която прави живота ни по-лесен, когато нещата започват да стават по-сложни.)
+
+И сега създайте файл `post_list.html` (оставете го празен засега) в директорията `blog/templates/blog`.
+
+Вижте как изглежда сайта ви: http://127.0.0.1:8000/
+
+> Ако все още имате грешка `TemplateDoesNotExist`, опитайте се да заредите сървъра си отново. Отидете в командния си ред, спрете сървъра като натиснете едновременно Ctrl+C (Клавишите Control и C заедно) и го стартирайте отново като напишете команда `python manage.py runserver` .
+
+![Фигура 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Отворете новият файл в редактора и добавете следното:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+Така, как изглежда уебсайта ви в момента? Отидете на: http://127.0.0.1:8000/ за да разберете
+
+![Фигура 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Глава и тяло на страницата (head и body)
+
+Всяка HTML страница е разделена на два елемена: **head** и **body**.
+
+* **head** е елемент, който съдържа информация относно документа, който е показан на екрана.
+
+* **body** е елемент, който съдържа всичко, което е показано като част от уеб страницата.
+
+Използваме `<head>` за да кажем на търсачката за конфигурацията на страницата и `<body>` какво точно е на страницата.
+
+Например, може да сложите заглавие на елемента вътре в `<head>` ето така: 
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Запазете файла и презаредете страницата.
+
+![Фигура 11.3](images/step4.png)
+
+Забелязахте ли как търсачката ви разбра, че заглавието на блога е "Ola's blog"? Тълкува `<title>Ola's blog</title>` и показва текст с името на заглавието в лентата на търсачката (също така ще се използва за отметка (bookmarks) и т.н.).
+
+Вероятно забелязахте и, че отварящия етикет съвпада със затварящия с `/`, като тези елементи са вложени (например не можете да затворите определен етикет, докато не затворите всички, които са преди него).
+
+Също като да слагаме неща в кутии. Имате една голяма кутия, `<html></html>`; в нея е `<body></body>` и това съдържа други по-малки кутии: `<p></p>`.
+
+Трябва да следвате тези правила със затварящите етикети и вложените елементи - ако ли не, търсачката ви може и да не ги представи както трябва и страницата ви ще изглежда неправилно.
+
+## Персонализиране на шаблон
+
+Може малко да се позабавлявате и да опитате да направите свой шаблон! Ето няколко полезни етикета за целта:
+
+* `<h1>Заглавие</h1>` за най-важното ви заглавие
+* `<h2>Подзаглавие</h2>` за заглавие от следващо ниво
+* `<h3>Под-подзаглавие</h3>` …и т.н. до `<h6>`
+* `<p>Абзац</p>`
+* `<em>текст</em>` набляга на текста 
+* `<strong>текст</strong>` удебелява текста
+* `<br>` отива на нов ред (не може да сложите нищо в br, както и няма затварящ етикет )
+* `<a href="https://djangogirls.org">връзка</a>` създава връзка 
+* `<ul><li>първи елемент</li><li>втори елемент</li></ul>` прави лист, точно като този! 
+* `<div></div>` дефинира секция от страницата
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Ето пример на пълен шаблон, копирайте и пренесете в `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Дава ни този ефект:
+
+![Фигура 11.4](images/step6.png)
+
+Ихаа! Но дотук, нашият шаблон показва точно **същата информация** -- там където говорихме по-рано за шаблоните, които ни позволяват да показваме **различна** информация в **същия формат**.
+
+Това, което искаме е да показва истински публикации добавени в администратора на Django -- и там е където отиваме след това.
+
+## Още нещо: прехвърляне на файловете (deploy)!
+
+Би било добре да видим всичко това на живо в Internet, нали? Нека направим още едно прехвърляне на файлове към PythonAnywhere:
+
+### Запазете, and избутайте кода си към GitHub
+
+Първо, нека видим кои файлове се промениха след последното прехвърляне (напишете следните команди на локалния компютър, не на PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Бъдете сигурни, че сте в директорията на `djangogirls` и нека кажем на git да включи всички промени в тази директория:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Преди да качим всички файлове, нека проверим какво ще качи `git` (всички файлове, които `git` ще качи ще се появят в зелено):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Почти сме там, сега е време да кажем да запази тези промени в хронологията си. Ще дадем съобщение за запазване ("commit message"), където описваме накратко какво сме променили. Може да напишете каквото си поискате на този етап, но е важно да се знае, че би трябвало да е нещо описващо от това, което сте направили, така че да се знае в бъдеще.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+След като сме направили това, качваме (push) нашите промени на GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Издърпайте новия код на PythonAnywhere и презаредете страницата
+
+* Отворете [PythonAnywhere страницата](https://www.pythonanywhere.com/consoles/) и отидете на **Bash конзолата** (или стартирайте нова). След това напишете команда:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+Трябва да заместите `<your-pythonanywhere-domain>` с актуалния си PythonAnywhere субдомейн без скобите. Вашият субдомейн е потребителско ви име в PythonAnywhere, но в някои случай може да е различно (като например ако потребителското ви име съдържа главни букви). Така че, ако тази команда не работи, използвайте команда `ls` (показване на лист от файлове) за да намерите вашия субдомейн/име на папката, и след това да отидете в нея `cd`.
+
+Сега гледайте как се сваля кода ви. Ако искате да проверите дали е пристигнал, отидете на **"Files" страница** и вижте кода си на PythonAnywhere (може да достигнете други страници на PythonAnywhere от бутона на менюто в страницата на конзолата).
+
+* Накрая, отидете на ["Web" страницата](https://www.pythonanywhere.com/web_app_setup/) и натиснете **Reload** на вашата апликация.
+
+Обновлението трябва да е на живо! Отидете и презаредете страницата си в търсачката. Промените трябва да са видими. :)
\ No newline at end of file
diff --git a/bg-BG/installation/README.md b/bg-BG/installation/README.md
new file mode 100644
index 00000000000..588df0983d6
--- /dev/null
+++ b/bg-BG/installation/README.md
@@ -0,0 +1,68 @@
+# Ако правите ръководството у дома
+
+Ако правите ръководството у дома, а не на някое от събитията на [Django Girls](https://djangogirls.org/events/), можете напълно да пропуснете тази глава сега и да отидете направо към главата [Как работи Интернет](../how_the_internet_works/README.md).
+
+Това е така, защото покриваме инсталирането на неща, каквито са необходими в ръководството - това е само допълнителна страница, която събира всички инструкции за инсталиране на едно място (което е полезно за някои формати на работилницата). Можете да изберете да инсталирате всичко, което е на тази страница в момента, ако желаете. Но ако искате да започнете да научавате неща, преди да инсталирате куп неща на вашия компютър, пропуснете тази глава и ние ще ви обясним по-късно инсталационните части, тъй като те са необходими.
+
+Късмет!
+
+# Ако посещавате уъркшоп
+
+Ако присъствате на някое от събитията на [Django Girls](https://djangogirls.org/events/):
+
+* Вашата работилница може да има "парти за инсталиране" преди основната работилница. Ако сте на парти за инсталиране, тази страница е за вас! Следвайте инструкциите тук, за да получите всичко необходимо за работния процес, с помощта на менторите, ако е необходимо. След това в основната работилница ще можете да пропуснете инструкциите за инсталиране, които ще срещнете в главното ръководство, когато стигнете до тях.
+* Организаторите на вашата работилница може би са ви помолили да опитате у дома, за да инсталирате всичко на вашия компютър, преди да започне уъркшопът. Ако сте били помолени да направите това, тази страница е за вас! Следвайте инструкциите тук, както можете най-добре. След това в основната работилница, когато стигнете до стъпка за инсталиране в основното ръководство, ако не сте успели да инсталирате тази част, можете да получите помощ от вашия ментор.
+* Ако вашият уъркшоп няма парти за инсталиране (или не можете да присъствате) и ако организаторите не са ви помолили да опитате да инсталирате всичко преди да сте пристигнали, пропуснете тази страница и отидете направо към главата [Как работи Интернет](../how_the_internet_works/README.md). Ще инсталирате всичко необходимо, докато работите през ръководството.
+
+# Инсталиране
+
+В това ръководство ще изграждате блог. За да направите това, докато преминавате през ръководството, ще бъдете инструктирани как да инсталирате различен софтуер на вашия компютър и да настроите някои онлайн акаунти, тъй като са необходими. Тази страница събира на едно място всички инструкции за инсталиране и регистрация (което е полезно за някои формати на работилницата).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Кратко въведение в командния ред {#command-line}
+
+Много от стъпките по-долу се споменават "конзолата", "терминала", "командния прозорец" или "командния ред" - всичко това означава едно и също нещо: прозорец на вашия компютър, в който можете да въведете команди. Когато стигнете до главното ръководство, ще научите повече за командния ред. Засега основното, което трябва да знаете, е как да отворите командния прозорец и как изглежда: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Инсталиране на Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Инсталиране на редактор на код {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Настройте virtualenv и инсталирайте Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Инсталиране на Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Отидете на [GitHub.com](https://www.github.com) и се регистрирайте за нов безплатен потребителски акаунт. Не забравяйте да запомните паролата си (добавете я към вашия мениджър на пароли, ако използвате такъв).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Започнете да четете
+
+Поздравления, вече сте подготвени и готови да продължите! Ако все още имате известно време преди уъркшопа, би било полезно да започнете да четете няколко от началните глави:
+
+* [Как работи интернет](../how_the_internet_works/README.md)
+
+* [Въведение в командния ред](../intro_to_command_line/README.md)
+
+* [Въведение в Python](../python_introduction/README.md)
+
+* [Какво е Django?](../django/README.md)
+
+# Насладете се на уъркшопа!
+
+Когато започнете семинара, ще можете да преминете направо към [първия си проект на Django!](../django_start_project/README.md), защото вече сте обхванали материала в по-ранните глави.
\ No newline at end of file
diff --git a/bg-BG/intro_to_command_line/README.md b/bg-BG/intro_to_command_line/README.md
new file mode 100644
index 00000000000..fa7f4f13ce2
--- /dev/null
+++ b/bg-BG/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Въведение в интерфейса на командния ред
+
+> За читателите у дома: тази глава е разгледана във видеото [Вашият нов приятел: Командният ред](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+Вълнуващо е, нали ?! Ще напишете първия си ред код само за няколко минути! :)
+
+**Нека ви запознаем с първия ви нов приятел: командният ред!**
+
+Следващите стъпки ще ти покажат как да използваш черния прозорец, който използват всички хакери. В началото може да изглежда малко страшно, но всъщност тази подкана просто чака команди от теб.
+
+> **Забележка** Моля, имайте предвид, че в тази книга използваме взаимозаменяемите термини „директория“ и „папка“, но те са едно и също нещо.
+
+## Какво е командният ред?
+
+Прозорецът, който обикновено се нарича **команден ред** или **интерфейсът на командния ред**, е текстово приложение за преглед, обработка и манипулиране на файлове на вашия компютър. Прилича много на Windows Explorer или Finder на Mac, но без графичния интерфейс. Други имена на командния ред са: *cmd*, *CLI*, *подкана*, *конзола* или *терминал*.
+
+## Отворете интерфейса на командния ред
+
+За да започнем някои експерименти, първо трябва да отворим интерфейса на командния ред.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Подкана
+
+Сега трябва да видите бял или черен прозорец, който чака вашите команди.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Ако сте на Mac или Linux, вероятно виждате `$`, ето така:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+На Windows, вероятно виждате `>`, ето така:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Погледнете раздела за Linux малко по-горе - ще видите нещо подобно, когато стигнете до PythonAnywhere по-късно в урока.
+
+<!--endsec-->
+
+Всяка команда ще бъде предварително обозначена с `$` или `>` и един интервал, но не бива да го въвеждате. Вашият компютър ще го направи вместо вас. :)
+
+> Само малка забележка: във твоя случай може да има нещо като `C:\Users\ola>` или `Olas-MacBook-Air:~ ola$` преди знака на подкана и това е 100% ОК.
+
+Частта до и включително `$` или `>` се нарича *командния ред* или *подкана* за кратко. То те подканва да въведеш нещо там.
+
+В ръковдството, когато искаме да въведете команда, ще включим `$` или `>`, а понякога и повече вляво. Игнорирай лявата част и въведи само командата, която започва след подканата.
+
+## Вашата първа команда (УРА!)
+
+Нека започнем с въвеждането на тази команда:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+И след това натиснете `enter`. Това е нашият резултат:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+Както можете да видите, компютърът току-що отпечата вашето потребителско име. Яко, а? :)
+
+> Опитайте да въведете всяка команда; не копирайте-поставете. Ще запомните повече по този начин!
+
+## Основи
+
+Всяка операционна система има малко по-различен набор от команди за командния ред, така че не забравяйте да следвате инструкциите за вашата операционна система. Нека опитаме това, става ли?
+
+### Текуща директория
+
+Би било хубаво да знаем къде сме сега, нали? Да видим. Въведете тази команда и натиснете `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Забележка: 'pwd' означава 'print working directory' (принтиране работна директория).
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+Вероятно ще видите нещо подобно на вашата машина. След като отворите командния ред, обикновено стартирате в домашната директория на вашия потребител.
+
+* * *
+
+### Научете повече за команда
+
+Много команди, които можеш да въведеш в командния ред, имат вградена помощ, която можеш да показваш и да четеш! Например, за да научиш повече за текущата команда на директория:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X и Linux имат команда `man`, която ви предоставя помощ за команди. Опитайте `man pwd` и вижте какво пише, или поставете `man` преди други команди, за да видите помощта им. Изходът на `man` обикновено се изписва на страницата. Използвайте интервала, за да преминете към следващата страница, и `q`, за да прекратите прегледа на помощта.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Добавянето на `/?` суфикс към повечето команди ще отпечата помощната страница. Може да се наложи да превъртите прозореца на вашата команда нагоре, за да видите всичко. Опитайте `cd /?`.
+
+<!--endsec-->
+
+### Списък на файлове и директории
+
+И така, какво има в него? Ще е готино да разберем. Да видим:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Промяна на текущата директория
+
+Сега, нека да отидем на вашата директория Desktop:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Отбележи, че името на директорията "Desktop" може да се преведе на езика на вашия Linux акаунт. В такъв случай ще трябва да замените ` Desktop ` с преведеното име; например, `Работен плот` за български език.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Проверете дали наистина е променена:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Ето го!
+
+> PRO съвет: ако напишете `cd D` и след това натиснете `tab` на клавиатурата си, командният ред автоматично ще попълни останалото име, за да можете да навигирате по-бързо. Ако има повече от една папка, започваща с „D“, натиснете два пъти клавиша `tab`, за да получите списък с опции.
+
+* * *
+
+### Създаване на директория
+
+Какво ще кажете за създаването на тестова директория на вашия работен плот? Можете да го направите по този начин:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+Тази малка команда ще създаде папка с името `practice` на вашия работен плот. Можете да проверите дали е там, като погледнете на работния си плот или като изпълните команда `ls` или `dir`! Опитайте. :)
+
+> PRO съвет: Ако не искате да въвеждате едни и същи команди отново и отново, опитайте да натиснете `стрелката нагоре` и `стрелка надолу` на клавиатурата си, за да преминете през последните използвани команди.
+
+* * *
+
+### Упражнение!
+
+Малко предизвикателство за вас: в новосъздадената си директория `practice` създайте директория, наречена `test`. (Използвайте командите `cd` и `mkdir`.)
+
+#### Решение:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Поздравления! :)
+
+* * *
+
+### Почистване
+
+Не искаме да оставим бъркотия, така че нека премахнем всичко, което направихме до този момент.
+
+Първо, трябва да се върнем към Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Използването на `..` с командата `cd` ще промени текущата ви директория на родителската директория (тоест директорията, която съдържа текущата ви директория).
+
+Проверете къде се намирате:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Сега е време за изтриване на директорията `practice`:
+
+> **Внимание**: Изтриването на файлове с помощта на `del`, `rmdir` или `rm` е безвъзвратно, което означава, че *изтритите файлове ще изчезнат завинаги*! Затова бъдете много внимателни с тази команда.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Готово! За да сме сигурни, че е действително изтрита, нека проверим:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Изход
+
+Това е засега! Можете спокойно да затворите командния ред. Да го направим по хакерския начин, окей? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Готино, а? :)
+
+## Обобщение
+
+Ето обобщение на някои полезни команди:
+
+| Команда (Windows) | Команда (Mac OS / Linux) | Описание                         | Пример                                              |
+| ----------------- | ------------------------ | -------------------------------- | --------------------------------------------------- |
+| exit              | exit                     | затваряне на прозореца           | **exit**                                            |
+| cd                | cd                       | промяна на директория            | **cd test**                                         |
+| cd                | pwd                      | показване на текущата директория | **cd** (Windows) или **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | списък директории / файлове      | **dir**                                             |
+| copy              | cp                       | копие на файл                    | **copy c:\test\test.txt c:\windows\test.txt**   |
+| move              | mv                       | преместване на файл              | **move c:\test\test.txt c:\windows\test.txt**   |
+| mkdir             | mkdir                    | създаване на нова директория     | **mkdir testdirectory**                             |
+| rmdir (или del)   | rm                       | изтриване на файл                | **del c:\test\test.txt**                          |
+| rmdir /S          | rm -r                    | изтриване на директория          | **rm -r testdirectory**                             |
+| [CMD] /?          | man [CMD]                | получете помощ за команда        | **cd /?** (Windows) или **man cd** (Mac OS / Linux) |
+
+Това е само една малка част от командите, които можете да изпълнявате във вашия команден ред, но днес няма да използвате нищо повече от това.
+
+Ако ви е любопитно, [ss64.com](http://ss64.com) съдържа пълна справка с команди за всички операционни системи.
+
+## Готови?
+
+Нека се потопим в Python!
\ No newline at end of file
diff --git a/bg-BG/intro_to_command_line/open_instructions.md b/bg-BG/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..0bd822d8119
--- /dev/null
+++ b/bg-BG/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+В зависимост от вашата версия на Windows и клавиатурата ви, едно от следните трябва да отвори команден прозорец (може да се наложи да експериментирате малко, но не е нужно да изпробвате всички тези предложения):
+
+- Отиди в менюто или екрана "Старт" и въведи "Команден ред" в полето за търсене.
+- Отиди в менюто "Старт" → Windows Система → Команден ред.
+- Отиди в менюто Старт → Всички програми → Аксесоари → Команден ред.
+- Отидете на стартовия екран, задръжте мишката в долния ляв ъгъл на екрана и щракнете върху стрелката надолу, която се появява (на сензорен екран, вместо това натиснете нагоре от долната част на екрана). Страницата с приложения трябва да се отвори. Кликнете върху командния ред в секцията Windows.
+- Задръжте специалния клавиш Windows на клавиатурата си и натиснете клавиша "X". Изберете „Команден ред“ от изскачащото меню.
+- Задръжте клавиша на Windows и натиснете клавиша "R", за да получите прозорец "Изпълнение". Въведете "cmd" в полето и щракнете върху бутона OK.
+
+![Напишете "cmd" в прозореца "Изпълнение"](../python_installation/images/windows-plus-r.png)
+
+По-късно в това ръководство ще трябва да имате отворени два командни прозореца едновременно. Въпреки това, при някои версии на Windows, ако вече имате един отворен команден прозорец и се опитате да отворите втори, използвайки същия метод, той вместо това ще ви насочи към командния прозорец, който вече имате отворен. Опитайте го сега на вашия компютър и вижте какво ще се случи! Ако получите само един команден прозорец, опитайте някой от другите методи в списъка по-горе. Поне един от тях трябва да доведе до отваряне на нов команден прозорец.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Отидете на Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Вероятно е под Applications → Accessories → Terminal или Applications → System → Terminal, но това може да зависи от вашата система. Ако не е там, можете да опитате да го потърсите в Google. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/bg-BG/python_installation/README.md b/bg-BG/python_installation/README.md
new file mode 100644
index 00000000000..bb84a606d3b
--- /dev/null
+++ b/bg-BG/python_installation/README.md
@@ -0,0 +1,15 @@
+# Да започнем с Python
+
+Най-накрая сме тук!
+
+Но първо нека ви разкажем какво е Python. Python е много популярен език за програмиране, който може да се използва за създаване на уебсайтове, игри, научен софтуер, графика и много, много други.
+
+Python възниква в края на 80-те години и основната му цел е да бъде четен от хора (не само от машини!). Ето защо той изглежда по-прост от другите езици за програмиране, но не се притеснявайте - Python също е наистина мощен!
+
+# Инсталиране на Python
+
+> **Забележка** Ако използвате Chromebook, пропуснете тази глава и се уверете, че следвате инструкциите [Настройка на Chromebook](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/bg-BG/python_installation/instructions.md b/bg-BG/python_installation/instructions.md
new file mode 100644
index 00000000000..fba59ce88ae
--- /dev/null
+++ b/bg-BG/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> За читателите у дома: тази глава е разгледана във видеото [Инсталиране на Python & Редактор на код](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> Част от този раздел е базирана на ръководства от Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django е написан на Python. Имаме нужда от Python, за да направим нещо в Django. Нека започнем с инсталирането му! Искаме да инсталирате най-новата версия на Python 3, така че ако имате някоя по-ранна версия, ще трябва да я актуализирате. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Моля, инсталирайте нормален Python по следния начин, дори когато на вашия компютър е инсталиран Anaconda.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Първо проверете дали вашият компютър използва 32-битова версия или 64-битова версия на Windows, в реда "Тип система" на страницата Информация за системата. За да стигнете до тази страница, опитайте един от следните методи:
+
+* Натиснете едновременно клавиша Windows и клавиша за Пауза/Прекъсване
+* Отворете контролния панел от менюто на Windows, след което отворете Система & Сигурност, след това Система
+* Натиснете бутона на Windows, след това отворете Настройки> Система> Информация
+* Потърсете в менюто "Старт" на Windows "Система информация" За целта щракнете върху бутона Старт или натиснете клавиша Windows, след което започнете да въвеждате `Информация за системата`. То ще започне да прави предложения веднага щом въведете. Изберете правилното, след като се появи.
+
+Можете да изтеглите Python за Windows от уебсайта https://www.python.org/downloads/windows/. Кликнете върху връзката "Последно издание на Python 3 - Python x.x.x“. Ако вашият компютър работи с **64-битова** версия на Windows, изтеглете **изпълнителния инсталатор Windows x86-64**. В противен случай изтеглете **изпълнителния инсталатор Windows x86**. След като изтеглите инсталатора, трябва да го стартирате (щракнете двукратно върху него) и следвайте инструкциите там.
+
+Едно нещо, за което трябва да внимавате: По време на инсталацията ще забележите прозорец с надпис „Настройка“. Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Не забравяйте да добавите Python към Path](../python_installation/images/python-installation-options.png)
+
+Когато инсталацията приключи, може да видите диалогов прозорец с връзка, която можете да следвате, за да научите повече за Python или за версията, която сте инсталирали. Затворете или отменете този диалог - в това ръководство ще научите повече!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Изтеглете *Mac OS X 64-битов/32-битов инсталатор* файл,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/bg-BG/python_introduction/README.md b/bg-BG/python_introduction/README.md
new file mode 100644
index 00000000000..1d07ec54917
--- /dev/null
+++ b/bg-BG/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Въведение в Python
+
+> Част от тази глава е базирана на ръководства от Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Да напишем малко код!
+
+## Python подкана
+
+> За читателите у дома: тази част е разгледана във видеото [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U).
+
+За да започнем да играем с Python, трябва да отворим *командния ред* на вашия компютър. Вече трябва да знаете как да го направите - научихте го в главата [Въведение в командния ред](../intro_to_command_line/README.md).
+
+След като сте готови, следвайте инструкциите по-долу.
+
+Искаме да отворим конзола на Python, затова въведете `python` в Windows или `python3` в Mac OS/Linux и натиснете `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Вашата първа Python команда!
+
+След като изпълниш командата Python, подканата се променя в `>>>`. За нас това означава, че засега можем да използваме само команди на езика Python. Не е нужно да пишете `>>>` - Python ще направи това вместо вас.
+
+Ако искате да излезете от конзолата на Python във всеки момент, напишете `exit()` или използвайте прекия път `Ctrl + Z` за Windows и `Ctrl + D` за Mac/Linux. Тогава вече няма да виждате `>>>`.
+
+Засега не искаме да излизаме от конзолата Python. Искаме да научим повече за него. Нека започнем с въвеждане на някаква математика, като `2 + 3` и натискане на `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Хубаво! Вижте как отговорът изскочи? Python знае математика! Можете да опитате и други команди като:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+За да извършим експоненциално изчисление, да кажем 2 на степен 3, пишем: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Забавлявайте се с това за малко и след това се върнете тук. :)
+
+Както можете да видите, Python е чудесен калкулатор. Ако се чудите какво още можете да направите...
+
+## Низове
+
+Какво ще кажете за вашето име? Въведете първото си име в кавички така:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+Сега създадохте първия си низ! Това е поредица от знаци, които могат да бъдат обработени от компютър. Низът винаги трябва да започва и завършва с един и същ символ. Това могат да бъдат единични (`'`) или двойни (`"`) кавички (няма разлика!) Кавичките казват на Python, че това, което е вътре в тях, е низ.
+
+Низовете могат да бъдат нанизани заедно. Опитайте това:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+Можете също да умножите низове с число:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Ако трябва да поставите апостроф във вашия низ, имате два начина да го направите.
+
+Използвайки двойни кавички:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+или да избягате от апострофа с обратна черта (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Хубаво, а? За да видите името си с главни букви, напишете:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Току що използвахте метода `upper` върху вашия низ! Методът (като `upper()`) е поредица от инструкции, които Python изпълнява върху даден обект (`"Ola"`) след като е повикан.
+
+Ако искате да знаете, от колко на брой букви е вашето име, има функция и за това!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Чудите ли се понякога защо, когато извиквате функции с `.` на края на низа (като `"Ola".upper()`), като понякога извиквате първо функцията и поставяте низа в скоби? Е, в някои случаи функциите принадлежат на обекти, като `upper()`, които могат да се използват само върху низове. В този случай, наричам функцията метод. В други случаи, функциите които не принадлежат към определени типове и могат да бъдат използвани при различни обекти, също като `len()`. Затова даваме `"Ola"` като параметър на функцията `len`.
+
+### Обобщение
+
+Добре, достатъчно за низове. Досега научихте за:
+
+- **подкана** -- писане на команди (код) в Python подкана в резултат дава отговори на езика Python.
+- **числа и низове** -- в Python числата се използват за математически операции а низовете за текстови обекти.
+- **оператори** – като `+` и `*`, събират стойности за да получат нова
+- **функции** – като `upper()` и `len()`, извършващи се върху обектите.
+
+Това са основите на всеки програмен език, който учите. Готови ли сте за нещо по-сложно? Залагаме, че сте!
+
+## Грешки
+
+Нека опитаме нещо ново. Можем ли да вземем дължината на числото по същият начин, по който взехме дължината на нашето име? Напишете `len(304023)` и натиснете `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Показа се първата ни грешка! {{ warning_icon }} е начина, по който ще ви показваме, че кода който се опитвате да пуснете няма да работи както се очаква. Грешките (дори и тези, които правим нарочно) са важна част от процеса на учене!
+
+Казва, че обектът от тип "int" (integers, или още цели числа) нямат дължина. Какво можем да направим сега? Може би да напишем числото ни като низ? Низовете имат дължина, нали така?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Работи! Използвахме функцията `str` във функцията `len`. `str()` преобразува всичко в низове.
+
+- Функцията `str` преобразува нещата в **низове**
+- Функцията `int` преобразува нещата като **цели числа**
+
+> Важно: можем да преобразуваме числа в текст, но не можем да направим обратното -- както и да е какво би било `int('hello')`?
+
+## Променливи
+
+Важно понятие в програмирането са променливите. Променливата е нищо повече от име, което може да се използва по-късно в програмата. Програмистите ползват тези променливи да запазват данни. Това прави кода им по-четлив, така че не се налага да запомнят какви са тези неща.
+
+Нека кажем, че искаме да създаде променлива с име `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+Пишем name равно на Ola.
+
+Ако забелязахте, програмата ви не върна нищо както преди това. Как да разберем, че променливата съществува? Напишете `name` и натиснете бутона `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Ихууу! Първата ти променлива! :) Винаги може да я промениш към какво се отнася:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+Може да я използвате и във функции:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Страхотно, нали? Сега, променливите могат да са какво ли не -- също така и числа! Пробвайте това:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Но какво ако използваме грешното име Можете ли да отгатнете какво ще се случи? Нека опитаме!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Грешка! Както виждате, Python има различни видове грешки, като тази се казва **NameError**. Python винаги ще ви дава тази грешка, ако се опитвате да използвате променлива, която все още не е дефинирана. Ако попаднете на тази грешка по-късно, вижте дали не сте сбъркали при писането на някое от имената.
+
+Поиграйте се малко с това и вижте какво може да правите!
+
+## Фунцкията print
+
+Пробвайте това:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Когато напишете `name`, интерпретатор на Python отговаря със низово *образ* на променливата 'name', което е буквите M-a-r-i-a, обградени от единични кавички. Когато кажем `print(name)`, Python ще "отпечата" съдържанието на променливата на екрана, без кавичките, което е по-прилежно.
+
+Както ще видим по-късно `print()` също е полезен, когато искаме да отпечатаме неща от функциите, или когато искаме да отпечатаме неща на няколко реда.
+
+## Листове
+
+Освен низовете и целите числа, Python има всякакви видове типове обекти. Сега ще въведем една от тях наречена **list**. Листоверте са точно това, което си мислите, че са: обекти, които са листове от други обекти. :)
+
+Давайте нататък и създайте лист:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Да, това е празен лист. Не е много полезен нали? Нека създадем лист с лотарийни номера. Не искаме да се повтаряме постоянно, така че ще използваме променлива:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+И така, имаме лист! Какво можем да правим с него? Нека видим колко лотарийни числа има в листа? Имате ли си на идея коя функция може да се използва за това? Това вече го знаете!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Да! `len()` може да ви даде броя на обектите в листа. Много удобно, нали? Може би и ще го сортираме:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Това не връща нищо, само променя реда, в който числата са показани в листа. Нека го отпечатаме отново и видим какво се случва:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Както се вижда, числата в листа са вече подредени от по-малката към по-голямата стойност. Поздравления!
+
+Може би искаме да направим обратното?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+Ако искате да добавите нещо към вашия лист, може да го направите като напишете следната команда:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Ако искате да покажете само първото число, може да направите това като използвате **индекси**. Индекса е номерът, който казва къде в листа се появява елемента. Програмистите предпочитат да започват броенето от 0, така че първият обект в листа е с индекс 0, следващия е с 1 и т.н. Опитайте това:
+
+{% filename %}command-line{% endfilename %} 
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Както може да видите, можете да достъпите различни обекти от листа си като използвате името на листа и индекс със квадратни скоби.
+
+За да премахнете нещо от листа си ще трябва да използвате **индексите**, които научихме по-горе и метода `pop()`. Нека пробваме пример и затвърдим това, което научихме до момента: ще отстраним първото число от листа ни.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Работи безупречно!
+
+За повече веселба, пробвайте други индекси: 6, 7, 1000, -1, -6 or -1000. Пробвайте се да предположите какъв би могъл да е резултата от командата. Имат ли смисъл резултатите?
+
+Можете да намерите лист с всички възможни методи в тази глава от документацията на Python: https://docs.python.org/3/tutorial/datastructures.html
+
+## Речници
+
+> За читателите у дома: тази част е показана във видеото [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+
+Речникът е подобен на лист, но вие получавате достъп до стойности, като търсите ключ вместо числов индекс. Ключът може да бъде всеки низ или число. Синтаксисът за дефиниране на празен речник е:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Това показва, че в момента създадохте празен речник. Ура!
+
+Сега, опитайте се да напишете следната команда (опитайте се да заместите със своя информация):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+С тази команда, току що създадохте променлива с име `participant` с три елемент-стойност (keys-value) двойки.
+
+- Ключът `name` се сочи към стойността `'Ola'` (`низов` обект),
+- `country` сочи към `'Poland'` (друг `низ`),
+- and `favorite_numbers` се отнася за `[7, 42, 92]` (`лист` с три числа в него).
+
+Може да проверите съдържанието на всеки от елементите с този синтаксис:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Виждате ли, подобно е на лист. Но не е необходимо да помните индекса -- само името.
+
+Какво се случва, когато попитаме Python за стойността на елемент, който не съществува? Можете ли да познаете? Нека опитаме и видим:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Вижте, друга грешка! Тази е **KeyError**. Python е много услужлив и ти казва, че елемент `'age'` не съществува в този речник.
+
+Кога да използвате речник и кога лист? Това е добър въпрос. Помислете за отговор преди да видите следващия ред.
+
+- Ако имате нужда просто от подредена последователност от елементи? Ползвайте лист.
+- Ако трабва да асоциирате стойности с елементи, които искате да може да ги видите на по-късен етап (чрез елемент - by key)? Използвайте речник.
+
+Речниците са като листове, но *непостоянни*, което означава, че могат да бъдат променени след като бъдат създадени. Може да добавяте нови двойки елемент-стойност към речника след като е създаден ето така:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Надявам се да има смисъл това което правим досега. :) Готови ли сте за още веселба с речниците? Прочетете някои невероятни неща.
+
+Можете да използвате метода `pop()` да изтриете елемент от речника. Да кажем, че искаме да премахнем въведението, което се отанся за елемента `'favorite_numbers'`, напишете следната команда:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Както се вижда, двойката елемент-стойност отнасяща се за 'favorite_numbers' беше премахната.
+
+Както и това, можете да промените стойността, която отговаря на вече създаден елемент в речника. Напишете това:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Както виждате, стойността на елемента `'country'` беше променен от `'Poland'` на `'Germany'`. :) Вълнуващо? Ураа! Току що научихте още едно невероятно нещо.
+
+### Обобщение
+
+Страхотно! Вече знаете много за програмирането. В тази последна част научихте за:
+
+- **грешки** -- знаете как да четете и разбирате грешките които се показват, ако Python не разбира командата която сте задали
+- **променливи** – имена на обектите, които ви позволяват да пишете код по-лесно и да правят кода ви по-четлив
+- **листове** –листовете са обекти запазени в определен ред
+- **речници** – обекти запазени като двойки от елемент-стойност (key-value pairs)
+
+Вълнувате ли се за следващата част? :)
+
+## Сравняване на неща
+
+> За читателите у вома: тази част е показана във видеото [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4).
+
+Голяма част от програмирането включва сравняване на неща. Какво е най-лесното нещо което може да се сравни? Числата! Нека видим как работи:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Чудите ли се защо използвахме два знака за равно `==` един до друг за да сравним дали числата са равни? Използваме едно равно `=` за да причислим стойност на променливите. Винаги, ама **винаги** трябва да иползваме две от тях – `==` – ако искаме да проверим дали две неща са равни едно на друго. Можем също така да кажем, че не искаме двете неща да са равни едно на друго. Затова, използваме символа `!=`, както е показано в примера по-горе.
+
+Дайте на Python още две задачки:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+Виждали сме `>` и `<`, но какво означават `>=` и `<=`? Четем ги по този начин:
+
+- x `>` y означава: x е по-голямо от y
+- x `>` y означава: x е по-малко от y
+- x `<=` y означава: x е по-малко или равно на y
+- x `>=` y означава: x е по-голямо или равно на y
+
+Страхотно! Искате ли да направите още нещо? Пробвайте това:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Може да дадете на Python колкото си искате числа да сравнява и ще ви даде отговор! Много умно, нали?
+
+- **and** – ако използвате оператора `and`, двете сравнения трябва да са True за да бъде цялата команда True
+- **or** – ако използвате оператора `or`, само едното сравнение трябва да е True за да бъде цялата команда True
+
+Чували ли сте за израза "сравнение на ябълки и портокали"? Нека пробваме подобно нещо в Python:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Тук виждате, че точно както в израза, Python не е в състояние да сравни число (`int`) и низ (`str`). Вместо това ни показва грешка **TypeError** и ни казва, че двата типа не могат да бъдат сравнени.
+
+## Булеви променливи
+
+По между другото, току що научихте за нов тип обект в Python. Нарича се **Булев (Boolean)**.
+
+Има само два вида булеви променливи:
+
+- True
+- False
+
+Но за Python да разбере това, винаги трябва да пишете 'True' (като първата буква е главна, а следващите малки). **true, TRUE, and tRUE няма да работят – само True е правилно.** (Същото се отнася и до 'False'.)
+
+Булевите стойности могат също да са променливи! Вижте тук:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Може също да го направите по този начин:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Практикувайте и се повеселете с булевите стойности като се опитате да напишете следните команди:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Поздраления! Булевите стойности са едни от най-готините неща в програмирането, и ти току що се научи как да ги използваш!
+
+# Запази!
+
+> За читателите у дома: тази част е показана във видеото [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk)
+
+До тук писахме всичкия си python код в интерпретатора, който ни ограничава да използваме само едни ред да впишем кода. Обикновено програмите са запазени във файлове и после изпълнени от **интерпретатора** или **компилатора** ни. Досега пускахме нашите програми по една на ред в Python интерпретатора. Ще са ни необходими малко повече редове от код за следващите няколко задачи, затова бързо ще направим това:
+
+- Излезем от Python интерпретатора
+- Отворим редактор за текс по избор
+- Запазим малко код в нов python файл
+- Пуснете го!
+
+За да излезнем от Python интерпретатора, който използвахме, пише следната функция `exit()`
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Това ще те завърне обратно в командния ред.
+
+По-рано избрахме нашия редактор от секцията за [code editor](../code_editor/README.md). Сега ще трябва да отворим редактора и да запишем малко код в нов файл (или ако използваш Chromebook, създай нов файл в облачната IDE и отвори файла, който ще бъде във включения редактор на код):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Очевидно, вече сте по-обиграни Python разработчици, така че напишете код, който научихте днес.
+
+Сега трябва да запазим файла и да му дадем описателно име. Нека наречем файла **python_intro.py** и го запазим на началния си екран. Можем да именуваме файла си както пожелаем, но е важно да сме сигурни, че завършва на **.py**. Разширението **.py** казва на операционната система, че това е **Python executable file** и Python може да го обработи. 
+
+> **Забележка:** Трябва да забелязахте, че едни от най-готините неща в редактора са: цветовете! В конзолата Python всичко беше в един и същ цвят; сега трябва да видите, че функцията `print` е различен цвят от низа. Това се нарича "syntax highlighting", и е много полезна добавка когато пишем код. Цветът на нещата ще ви даде подсказки, като например незатворени низове или печатни грешки в име на ключова дума (като `def` във функция, както ще видим по-долу). Това е една от причините да изполваме редактор за писане на код. :) :)
+
+Файлът е записан, време е да го стартираш! Използвайки уменията, които си научила в секцията за командния ред, използвай терминала за да **промениш директориите** на работния плот.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+На Mac, командата ще излгежда по този начин:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+На Linux, ще изглежда така:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Помнете, че думата "Desktop" може да е преведена на вашия език.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+На Windows Command Prompt ще изглежда ето така:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+И на Windows Powershell ще изглежда така:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Ако се затруднявате, поискайте помощ. Затова са менторите!
+
+Сега ползвайте Python за да изпълни кода във файла ето така:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Забележка: на Windows 'python3' не е разпознат като команда. Вместо това, използвайте 'python' за да стартирате файла:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Браво! Току що пуснахте първата си програма на Python, която беше запазена на файл. Чувствате ли се страхотно?
+
+Сега може да се прехвърлим на по-важно средство в програмирането:
+
+## If … elif … else
+
+Много неща в кода трябва да се изпълнят само ако са преминали определени условия. Затова Python има нещо, наречено **if условна конструкция**.
+
+Заместете кода във файла си **python_intro.py** с това:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Ако запазим и стартираме файла ще видим грешка като тази:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python очаква от нас да дадем следващи инсктрукции какво да се изпълни в условието `3 > 2` за да бъде вярно (или `True` за същата цел). Нека накараме Python да отпечата “It works!”. Променете кода си във файла с това:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Забелязахте ли как изписахме следващия ред от код с 4 празни места навътре? Трябва да направим това за да може Python да знае, кой код да изпълни в случай, че е вярно условието. Може да използвате едно празно място, но почти всеки Python програмист използва 4, тъй като изглежда по-прилежно. Използването на бутона Tab също се равнява на 4 места, ако сте направили редактора си да прави така. Когато направите избор не го променяйте! Ако вече сте използвали 4 места за в бъдеще ползвайте 4 места - в противен случай може да попаднете на затруднения.
+
+Запазете и го стартирайте отново:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Забележка: Помнете, че на Windows, 'python3' не се разпознава като команда. От сега нататък, заместете 'python3' с 'python' за да изпълните файла.
+
+### Какво ако условието не е вярно (True)?
+
+В предходните примери, кода се изпълняваше само ако условието е вярно (True). Но Python има също `elif` и `else` условия:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+Когато това се изпълни ще се отпечата:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+Ако 2 беше по-голямо число от 5, тогава втората команда щеше да се изпълни. Нека видим как работи `elif` :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+и се изпълнява:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+Видяхте ли какво се случи там? `elif` ви даде възможност да добавите още едно условие в случай, че предното се провали.
+
+Може да добавяте колкото си искате `elif` условия след първоначалното `if` условие. Например:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python преминава и тества през всеки ред и отпечатва:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Коментари
+
+Коментрите са редове, започващи с `#`. Може да пишете каквото искате след `#` и Python ще го игнорира. Коментарите са направени да правят кода по-лесен за четене и разбиране от другите хора.
+
+Нека видим как изглежда:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+Не е необходимо да пишете коментар за всеки ред от код, но те са много подходящи да обяснят какво прави самия код, или да дадат обобщение, когато се прави нещо сложно.
+
+### Обобщение
+
+В последните няколко упражнения научихте как да:
+
+- **сравнявате** – в Python може да сравнявате като използвате `>`, `>=`, `==`, `<=`, `<` и `and`, `or` оператори
+- използвате **булеви променливи** – типа на обекта може да приема само две стойности: `True` или `False`
+- **запазвате файлове** – запазване на кода във файлове, така че да могат да се изпълняват по-големи програми.
+- използвате **if … elif … else** – условна конструкция, която ви позволява да изпълнявате код когато определени условия се изпълнят.
+- пишете **коментари** - редовете в Python, които не се изпълняват и дават пояснения за кода ви
+
+Време е за последната част от тази глава!
+
+## Вашите собствени функции!
+
+> За читателите у дома: тази част е показана във видеото [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0).
+
+Помните ли функциите като `len()`, които изпълнихте в Python? Така, добри новини - сега ще научите как да напишете свои фукции!
+
+Функцията е последователност от инструкции, така че Python да може да я изпълнин. Всяка функция в Python започяа с ключовата дума `def`, с което се дава име на функцията и може да има няколко параметъра. Нека пробваме. Заместете кода във файла **python_intro.py** със следното:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Добре, първата ви функция е готова!
+
+Може би се чудите защо написахме името на функцията в края на файла. Когато пишем `def hi():` и следващите редове започват по-навътре, това оказва какво трябва да направи функцията `hi()`. Python ще прочете и запомни тези инструкции, но няма да изпълни все още функцията. За да кажем на Python да изпълни функцията, трябва да извикаме вункцията с `hi()`. Python чете файла и изпълнява от горе до долу, затова трябва да дефинираме функцията преди да сме я повикали.
+
+Нека го стартираме и видим какво се случва:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Забележка: ако не работи не се паникьосвайте! Резултатът ще ви помогне да разберете защо:
+
+- Ако получите грешка `NameError`, това най-вероятно означава, че сте направили грешка при писането, такаче трябва да проверите дали имената са същите при създаването на функцията `def hi():` и когато я извиквате `hi()`.
+- Ако получите грешка `IndentationError`, вижте дали двата реда с функцията `print` са отместени на едно и също растояние: python иска кода във функцията да бъде безупречно подреден.
+- Ако на изхода няма нищо, проверете дали последното `hi()` *не е* отместено - ако е , тази част също ще се превърне в част от функцията и никога няма да се изпълни
+
+Нека съставим първата си функция с параметри. Ще променим предния пример - функцията, която казва 'hi' на човека, който пуска програмата - с име:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+Както се вижда, дадохме на функцията си стойност, която нарекохме `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Запомнете: `print` функцията е поместена 4 места навътре спрямо `if` условието. Това е така, защото функцията се изпълнява, ако е изпълнено условието. Нека видим как работи:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Опаа, грешка. За щастие, Python ни показва много полезно съобщение за грешката. Казва ни, че фукнцията `hi()` (която ние дефинирахме) има аргумент, който се изисква (с име `name`) и че сме забравили да го приложим, когато извикваме фунцкията. Нека оправим това в края на файла:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+И да стартираме отначало:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+А ако сменим името?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+И стартираме отново:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Сега, какво мислите, че ще стане ако напишете ново име? (Не Ola или Sonja.) Опитайте и вижте дали сте прави. Трябва да отпечата това:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+Това е страхотно, нали? При това не трбва да се повтаряте всеки път, когато смените името на човека, който функцията трябва да поздрави. Затова са ни необходими функциите - никога да не повтаряш кода си!
+
+Нека опитаме нещо по-хитро - имаме повече от две имена и писането на условия за всяко едно от тях ще отнеме много време, нали така? Заместете съдържание на файла си със следното:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Нека извикаме кода:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Поздравления! Току що научихте как да пишете функции! :)
+
+## Цикли
+
+> За читателите у дома: тази част е показана във видеото [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0)
+
+Това вече е последната част. Мина бързо, нали? :)
+
+Програмистите не обичат да е повтарят. Програмирането се отнася до автоматизация, така че не искаме да поздравяваме всеки човек по име като изписваме за всеки по отделно, нали? Ето къде циклите идват в употреба.
+
+Все още си спомняте листовете? Нека направим лист с момичета:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+Искаме да поздравим всяка една от тях по име. Имаме функцията `hi` да направи това, така че нека я използваме в цикъл:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+Конструкцията `for` се държи подобно на конструкцията `if`; кода под него трябва да е отместен с четири места навътре.
+
+Ето целия код, който трябва да е във файла:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+И когато го стартираме:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+Както виждате всичко, което сложите вътре във `for` конструкцията с отместването ще бъде повторено за всеки елемент от листа `girls`.
+
+Може също да използвате `for` цикъл за числа като използвате фунцкията `range` :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Което ще отпечата:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` е функция, която създава лист от номера едно след друго (тези номера са дадени от вас като стойности). 
+
+Забележете, че втория параметър, който сте дали не се включва в листа с показаните числа от Python (което означава, че `range(1, 6)` брои от 1 до 5, без да включва числото 6). Това е така, защото "range" е полу-отворена функция, което означава, че включва първата стойност, но не и последната.
+
+## Обобщение
+
+Това е! **Ти си върха!** Това беше сложна глава, така че трябва да сте горди със себе си. Ние определено сме горди с това, което постигнахте досега!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+Може би искате да направите нещо друго за кратко - разтягане, разходка, да ви отпочинат очите - преди да отидем към следващата глава. :)
+
+![Кексче](images/cupcake.png)
\ No newline at end of file
diff --git a/bg-BG/template_extending/README.md b/bg-BG/template_extending/README.md
new file mode 100644
index 00000000000..57c12c2da81
--- /dev/null
+++ b/bg-BG/template_extending/README.md
@@ -0,0 +1,151 @@
+# Разширяване на шаблона
+
+Друго хубаво нещо, което Django има за вас, е **разширяване на шаблона**. Какво означава това? Това означава, че можете да използвате същите части на вашия HTML за различни страници на вашия уебсайт.
+
+Шаблоните помагат, когато искате да използвате една и съща информация или оформление на повече от едно място. Не е нужно да се повтаряте във всеки файл. И ако искате да промените нещо, не е необходимо да го правите във всеки шаблон, само в един!
+
+## Създайте основен шаблон
+
+Базовият шаблон е най-основният шаблон, който разширявате на всяка страница от вашия уебсайт.
+
+Нека създадем `base.html` файл в `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+След това го отворете в редактора на кода и копирайте всичко от `post_list.html` във `base.html` файл, като този:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+След това в `base.html` заменете съдържанието в секцията `<body>` (всичко между `<body>` и `</body>`) с това:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Може да забележите, че това замени всичко от `{% for post in posts %}` до `{% endfor %}` с: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Но защо? Току-що създадохте `block`! Използвахте шаблонния маркер `{% block %}`, за да направите област, в която да бъде вмъкнат HTML код. Този HTML код ще идва от друг шаблон, който разширява този шаблон (`base.html`). Ще ви покажем как да направите това след малко.
+
+Сега запишете `base.html` и отворете вашия `blog/templates/blog/post_list.html` отново в редактора на кода. {% raw %} Ще премахнете всичко по-горе `{% for post in posts %}` и под `{% endfor %}`. Когато приключите, файлът ще изглежда така:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Искаме да използваме това като част от нашия шаблон за всички съдържателни блокове. Време е да добавите блокови тагове към този файл!
+
+{% raw %}Искате вашият маркер за блока да съвпада с маркера във вашия `base.html` файл. Освен това искате той да включва всички кодове, които принадлежат във вашите блокове на съдържание. За целта поставете всичко между `{% block content %}` и `{% endblock %}`. Ето така:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Остана само едно нещо. Трябва да свържем тези два шаблона заедно. За това става въпрос в разширяващите се шаблони! Ще направим това, като добавим маркер за разширения в началото на файла. Ето така:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Това е! Запазете файла и проверете дали уебсайтът ви все още работи правилно. :)
+
+> Ако получите грешката `TemplateDoesNotExist`, това означава, че няма `blog/base.html` файл и имате `runserver` работещ в конзолата. Опитайте се да го спрете (като натиснете Ctrl + C - клавишите Control и C заедно) и го рестартирайте, като изпълните команда `python manage.py runserver`.
\ No newline at end of file
diff --git a/bg-BG/whats_next/README.md b/bg-BG/whats_next/README.md
new file mode 100644
index 00000000000..896922a2b32
--- /dev/null
+++ b/bg-BG/whats_next/README.md
@@ -0,0 +1,43 @@
+# Какво следва?
+
+Поздравете се! **Ти си напълно страхотен**. Гордеем се! <3
+
+### Какво да правим сега?
+
+Направете почивка и се отпуснете! Току-що направихте нещо наистина огромно.
+
+След това, не забравяйте да следвате Django Girls във [ Facebook ](http://facebook.com/djangogirls) или [ Twitter ](https://twitter.com/djangogirls).
+
+### Можете ли да препоръчате допълнителни ресурси?
+
+Да! Има *много* онлайн ресурси за научаване на всякакви умения за програмиране - може да бъде доста трудно да разберете как да продължите по-натам, но не се безспокойте. Каквито и да бяха интересите ви преди да дойдете на Django Girls и каквито и интереси сте развили по време на ръководството, ето някои безплатни ресурси (или ресурси с големи безплатни компоненти), които можете да използвате, за да стигнете до това, което искате.
+
+#### Django
+
+- Другата ни книга, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Официалното ръководство на Django](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Първи стъпки с видео уроци на Django](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) - някои видео лекции могат да бъдат одитирани безплатно и можете да спечелите сертификат Coursera, като вземете тези курсове
+
+#### HTML, CSS и JavaScript
+
+- [Курс за уеб разработка на Codecademy](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Курс по Python на Codecademy](https://www.codecademy.com/learn/learn-python)
+- [Курс по Python на Google](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – първоначалните упражнения са безплатни
+- [New Coder tutorials](http://newcoder.io/tutorials/) - това са различни практически примери за това как можете да използвате Python
+- [ edX ](https://www.edx.org/course?search_query=python) - можете да участвате в повечето курсове безплатно, но ако искате сертификат или по-голяма квалификация, това ще струва пари
+- [Python специализация на Coursera](https://www.coursera.org/specializations/python) - можете да участвате в няколко видео лекции безплатно и можете да спечелите сертификат на Coursera, като вземете тези курсове
+- [Python for Everybody](https://www.py4e.com/) - безплатна и отворена версия на специализирания Python Coursera за всеки
+
+#### Работа с данни
+
+- [Курсът по научни данни на Codecademy](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) - можете да участвате в повечето курсове безплатно, но ако искате сертификат или по-голяма квалификация, това ще струва пари
+- [Dataquest](https://www.dataquest.io/) - първите 30 "мисии" са безплатни
+
+Нямаме търпение да видим какво ще изградите след това!
\ No newline at end of file
diff --git a/bg/GLOSSARY.md b/bg/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/bg/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/bg/README.md b/bg/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/bg/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/bg/SUMMARY.md b/bg/SUMMARY.md
new file mode 100644
index 00000000000..7a45700a27d
--- /dev/null
+++ b/bg/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/bg/chromebook_setup/README.md b/bg/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/bg/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/bg/chromebook_setup/instructions.md b/bg/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/bg/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/bg/code_editor/README.md b/bg/code_editor/README.md
new file mode 100644
index 00000000000..404011f1b7d
--- /dev/null
+++ b/bg/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/bg/code_editor/instructions.md b/bg/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/bg/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/bg/css/README.md b/bg/css/README.md
new file mode 100644
index 00000000000..04d5996ae52
--- /dev/null
+++ b/bg/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/bg/deploy/README.md b/bg/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/bg/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/bg/deploy/install_git.md b/bg/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/bg/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/bg/deploy/signup_pythonanywhere.md b/bg/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/bg/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/bg/django/README.md b/bg/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/bg/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/bg/django_admin/README.md b/bg/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/bg/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/bg/django_forms/README.md b/bg/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/bg/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/bg/django_installation/README.md b/bg/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/bg/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/bg/django_installation/instructions.md b/bg/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/bg/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/bg/django_models/README.md b/bg/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/bg/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/bg/django_orm/README.md b/bg/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/bg/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/bg/django_start_project/README.md b/bg/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/bg/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/bg/django_templates/README.md b/bg/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/bg/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/bg/django_urls/README.md b/bg/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/bg/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/bg/django_views/README.md b/bg/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/bg/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/bg/dynamic_data_in_templates/README.md b/bg/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/bg/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/bg/extend_your_application/README.md b/bg/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/bg/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/bg/how_the_internet_works/README.md b/bg/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/bg/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/bg/html/README.md b/bg/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/bg/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/bg/install_git.md b/bg/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/bg/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/bg/installation/README.md b/bg/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/bg/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/bg/instructions.md b/bg/instructions.md
new file mode 100644
index 00000000000..30bd493b11b
--- /dev/null
+++ b/bg/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command dnf is not found. In that case you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/bg/intro_to_command_line/README.md b/bg/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/bg/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/bg/python_installation/README.md b/bg/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/bg/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/bg/python_installation/instructions.md b/bg/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/bg/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/bg/python_introduction/README.md b/bg/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/bg/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/bg/signup_pythonanywhere.md b/bg/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/bg/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/bg/template_extending/README.md b/bg/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/bg/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/bg/whats_next/README.md b/bg/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/bg/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/bn-BD/GLOSSARY.md b/bn-BD/GLOSSARY.md
new file mode 100644
index 00000000000..8c6897995f8
--- /dev/null
+++ b/bn-BD/GLOSSARY.md
@@ -0,0 +1,3 @@
+# কোড এডিটর
+
+কোড এডিটর এমন একটি অ্যাপ্লিকেশন যা আপনাকে আপনার কোড সংরক্ষণ করতে দেয় যাতে আপনি পরে এটিকে ফিরে পেতে সক্ষম হন। আপনি [কোড এডিটর অধ্যায়](./code_editor/README.md) থেকে শিখা শুরু করতে পারেন।
\ No newline at end of file
diff --git a/bn-BD/README.md b/bn-BD/README.md
new file mode 100644
index 00000000000..202baf6e444
--- /dev/null
+++ b/bn-BD/README.md
@@ -0,0 +1,51 @@
+# জ্যাঙ্গো গার্লস টিউটোরিয়াল 
+
+[![গিটার ](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> এই টিউটোরিয়ালটি Creative Common Attribution-ShareAlike 4.0 International লাইসেন্স-এর মাধ্যমে প্রকাশিত হয়েছে। লাইসেন্সটির প্রতিলিপি দেখতে ভিজিট করুনঃ https://creativecommons.org/licenses/by-sa/4.0 
+
+## স্বাগতম 
+
+সবাইকে জ্যাঙ্গো গার্লস বাংলা টিউটোরিয়াল এ স্বাগত! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## ভূমিকা
+
+তোমার কি এই রকম মনে হয়েছে যে, পৃথিবীতে প্রযুক্তি অনেক এগিয়ে চলছে , আর তুমি এটা থেকে অনেক পিছিয়ে পড়ছো? তুমি কি কখনো অবাক হয়েছো যে, কিভাবে একটি ওয়েবসাইট তৈরি হয়, কিন্তু কোন ভাল অনুপ্রেরণা না থাকায় তুমি এটা তৈরি করতে পারছো না? বর্তমান সফটওয়্যার শিল্প কি আপনার নিজের সামান্য কোনো সফটওয়্যার বানানোর জন্যও অনেক জটিল মনে হয়েছে?
+
+ঠিক আছে, তোমার জন্য আমাদের পক্ষ থেকে একটি সুখবর আছে !! প্রোগ্রামিং যতটা কঠিন ভাবছো আসলে তা এত কঠিন নয় বরং এটি কিভাবে আরো আনন্দদায়ক করা যায় তা তোমাকে আমরা দেখাবো। 
+
+এই টিউটোরিয়ালটি তোমাকে রাতারাতি প্রোগ্রামার বানিয়ে দিবে না। তুমি যদি এই বিষয়ে ভাল হয়ে চাও, তোমাকে এটি শিখতে হবে এবং অনুশীলন করতে হবে, এরজন্য তোমার অনেক মাস বা বছর লাগতে পারে । কিন্তু আমরা তোমাকে দেখাবো প্রোগ্রামিং বা ওয়েবসাইট তৈরি করা আসলে এত জটিল কিছু নয় যা তুমি ভাবছো । আমরা প্রতিটি ক্ষুদ্র ক্ষুদ্র জিনিস তোমাকে ব্যাখা করার চেষ্টা করবো, যাতে তুমি এই প্রযুক্তি রিলেটেড কোন কিছুকে আর ভয় না পাও । 
+
+আমরা আশা করি, আমরা যেভাবে এই প্রযুক্তির প্রতিটি স্পন্দনকে ভালবাসি, সেভাবে তুমি ভালবাসবে । 
+
+## তুমি এই টিউটোরিয়াল জুড়ে কি শিখবে? 
+
+যখন তুমি এই টিউটোরিয়াল শেষ করবে, তখন তোমার কাছে তোমার ওয়েব এপ্লিকেশন থাকবেঃ তোমার নিজের ব্লগ। এরপর তোমাকে দেখাবো তুমি কিভাবে এটি অনলাইনে প্রকাশ করবে, যাতে সবাই তোমার এই তৈরি করা কাজ দেখতে পারে সবাই ! 
+
+এটি দেখতে মোটামুটি এমনঃ 
+
+![ফিগার ০.১ ](images/application.png)
+
+> তুমি যদি এই টিউটোরিয়াল নিজে নিজে কাজ করো এবং তোমার যদি কোচ না থাকে যে তোমাকে কোন সমস্যা পড়লে তোমাকে সাহায্য করবে । এই সমস্যা থেকে উত্তরণের জন্য আছে আমাদের চ্যাট সিস্টেম । আমরা আমাদের সকল কোচ এবং পূর্বে যারা এই টিউটোরিয়াল শেষ করেছে, তারা সেখানে থাকবে বিভিন্ন বিষয়ে সাহায্য করার জন্য। সেখানে প্রশ্ন করতে সংকোচবোধ করো না । 
+
+ঠিক আছে,[ তাহলে শুরু করি ](./how_the_internet_works/README.md) 
+
+## বাড়িতে বসে এই টিউটোরিয়াল অনুসরণ 
+
+জাঙ্গো গার্লস ওয়ার্কশপে অংশ নেওয়া ভাল , তবে আমরা সচেতন যে সবসময় এটিতে অংশ নেওয়া সম্ভব নয়। এজন্যই আমরা তোমাদেরকে বাসায় বসে এই টিউটোরিয়াল অনুসরণ করার তাগিদ দিচ্ছি । যারা বাসায় বসে পড়বে, তাদের জন্য আমরা এখন ভিডিও তৈরি করছি যাতে এই টিউটোরিয়াল অনুসরণ করতে আরো সহজ হবে । এটির কাজ এখনো চলছে, তবে শীঘ্রই এই সকল বিষয় কাভার করা হবে ইউটিউবের এই চ্যানেলেঃ [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed)
+
+প্রতিটি চ্যাপ্টার অলরেডি কভার হয়েছে এবং এর ভিডিওগুলো তোমরা লিংকে ক্লিক করলেই পেয়ে যাবে । 
+
+## আমাদের সম্পর্কে এবং যাদের অবদান 
+
+এই টিউটোরিয়ালটি মেইন্টেইন করে [জ্যাঙ্গোগার্লস](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) আমাদেরকে এই সম্পর্কে জানাও যাতে আমরা এটিকে যুক্ত করতে পারি ।
\ No newline at end of file
diff --git a/bn-BD/SUMMARY.md b/bn-BD/SUMMARY.md
new file mode 100644
index 00000000000..a4afb15cdd6
--- /dev/null
+++ b/bn-BD/SUMMARY.md
@@ -0,0 +1,35 @@
+# সারসংক্ষেপ
+
+* [ভূমিকা](README.md)
+* [ইনস্টলেশন / স্থাপন](installation/README.md) 
+  * [কমান্ড লাইন](installation/README.md#command-line)
+  * [পাইথন](installation/README.md#python)
+  * [কোড সম্পাদনকারী](installation/README.md#code-editor)
+  * [ভার্চুয়াল পরিবেশ](installation/README.md#virtualenv)
+  * [জ্যাঙ্গো](installation/README.md#django)
+  * [গিট](installation/README.md#git)
+  * [গিটহাব](installation/README.md#github-account)
+  * [পাইথনসবখানে](installation/README.md#pythonanywhere-account)
+* [স্থাপন (ক্রোমবুক)](chromebook_setup/README.md)
+* [ইন্টারনেট কিভাবে কাজ করে](how_the_internet_works/README.md)
+* [কমান্ড লাইনের পরিচয়](intro_to_command_line/README.md)
+* [পাইথন স্থাপনা](python_installation/README.md)
+* [কোড এডিটর](code_editor/README.md)
+* [পাইথন-এর পরিচিতি](python_introduction/README.md)
+* [জ্যাঙ্গো কি?](django/README.md)
+* [জ্যাঙ্গো স্থাপনা](django_installation/README.md)
+* [আপনার প্রথম জ্যাঙ্গো প্রজেক্ট!](django_start_project/README.md)
+* [জ্যাঙ্গো models](django_models/README.md)
+* [জ্যাঙ্গো admin](django_admin/README.md)
+* [প্রয়োগ!](deploy/README.md)
+* [জ্যাঙ্গো URLs](django_urls/README.md)
+* [জ্যাঙ্গো views - সময় প্রণয়ন করার!](django_views/README.md)
+* [HTML এর পরিচিতি](html/README.md)
+* [জ্যাঙ্গো ORM (অনুসন্ধানের ঝাঁক)](django_orm/README.md)
+* [প্রগতিশীল ডেটা templates -এর মধ্যে](dynamic_data_in_templates/README.md)
+* [জ্যাঙ্গো templates](django_templates/README.md)
+* [CSS - এটি সুন্দর করুন ](css/README.md)
+* [template বর্ধণ ](template_extending/README.md)
+* [আপনার এপ্লিকেশনটি বড় করুন ](extend_your_application/README.md)
+* [জ্যাঙ্গো Forms](django_forms/README.md)
+* [এরপর কি? ](whats_next/README.md)
\ No newline at end of file
diff --git a/bn-BD/chromebook_setup/README.md b/bn-BD/chromebook_setup/README.md
new file mode 100644
index 00000000000..bb84bd8c198
--- /dev/null
+++ b/bn-BD/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# ক্রোমবুক সেটআপ
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/bn-BD/chromebook_setup/instructions.md b/bn-BD/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..4463b1e840a
--- /dev/null
+++ b/bn-BD/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+আপনি [এই বিভাগটি বাদ দিয় যেতে](http://tutorial.djangogirls.org/en/installation/#install-python) পারেন যদি আপনি ক্রোমবুক ব্যবহার না করে থাকেন। আর যদি আপনি করতে চান, তবে আপনা ক্রোমবুক স্থাপনের প্রক্রিয়াটির অভিজ্ঞনা একটু ভিন্ন হয়ে পারে। আপনি চাইলে বাকি স্থাপন নির্দেশনাবলী এড়িয়ে যেতে পারেন। 
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+ক্লাউড আইডিই হচ্ছে এমন একটি টুল যটি আপনাকে ইন্টারনেটে কোড এডিটর এবং একটি কমিউটারের এক্সেস দিবে যেখানে আপনি সফটওয়্য্যার স্থাপন (install) , লিখতে ও পরিচালনা করতে পারবেন। টিউটোরিয়ালের সময় জুড়ে, ক্লাউড আইডিই আপনার *লোকাল মেশিন* এর মত ভূমিক পালন করবে। You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### ভার্চুয়াল পরিবেশ
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### গিটহাব
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/bn-BD/code_editor/README.md b/bn-BD/code_editor/README.md
new file mode 100644
index 00000000000..82fdfaf0e9f
--- /dev/null
+++ b/bn-BD/code_editor/README.md
@@ -0,0 +1,11 @@
+# কোড এডিটর
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+যেহেতু আপনি কোড লিখতে যাচ্ছেন তাই আপনার কোড এডিটর দরকার যেটা ডাউনলোড করার সময় এখনই!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/bn-BD/code_editor/instructions.md b/bn-BD/code_editor/instructions.md
new file mode 100644
index 00000000000..dd7c73b883d
--- /dev/null
+++ b/bn-BD/code_editor/instructions.md
@@ -0,0 +1,37 @@
+অনেক ধরণের কোড এডিটর পাওয়া যায় এবং আপনি কোনটা ব্যবহার করবেন সেটা নির্ভর করে পুরোপুরি আপনার উপর। সাধারণত পাইথন প্রোগ্রামাররা জটিল কিন্তু অনেক পাওয়ারফুল IDE (Integrated Development Environment) ব্যবহার করে থাকেন, যেমন পাইচার্ম। কিন্তু নতুনদের জন্য আমরা যেসব কোড এডিটর ব্যবহার করার পরামর্শ দেব সেগুলো একটু কম সুবিধাজনক হলেও সমান ক্ষমতাসম্পন্ন ও ব্যবহার করা অনেক সহজ।
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[ডাউনলোড করতে এখানে ক্লিক করুন](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[এখান থেকে ডাউনলোড করুন](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[এখান থেকে ডাউনলোড করুন](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+তার প্রথম কারন হলো কোড **সাধারন টেক্সট** কিন্তু ওয়ার্ড বা টেক্সটএডিট- ধরনের সফ্টওয়্যারগুলো সাধারন টেক্সট তৈরী না করে রিচ টেক্সট(Rich Text) তৈরী করে যেটা RTF(Rich Text Format) বা এই ধরনের কোন ফর্মাটে থাকে। </p> 
+
+দ্বিতীয় কারন হলো কোডএডিটরের বিশেষ পারদর্শীতা হলো কোড এডিটিং, যাতে অনেক প্রয়োজনীয় জিনিস যেমন কোডকে তার বৈশিষ্ঠ্য অনুযায়ী রঙিন ভাবে দেখানো এবং বন্ধনীর(braces) কে নিজে থেকে শেষ করা ইত্যাদি। 
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/bn-BD/css/README.md b/bn-BD/css/README.md
new file mode 100644
index 00000000000..9b47bd8c274
--- /dev/null
+++ b/bn-BD/css/README.md
@@ -0,0 +1,330 @@
+# CSS - এটি সুন্দর করুন 
+
+আমাদের ব্লগ তেমন সুন্দর দেখা যাচ্ছে না, তাই না? এখনি সুন্দর করার সময়! আমরা এইজন্য CSS ব্যাবহার করব।
+
+## CSS কি?
+
+CSS এর পূর্ণরুপ হচ্ছে Cascading Style Sheets এবং এটি একধরনের মার্কঅাপ ল্যাঙ্গুয়েজ(যেমন: HTML). যেটি ব্যবহার করা হয় ওয়েবসাইটের সৌন্দর্য্য এবং বিন্যাসের জন্য . এটিকে ওয়েবপেইজের সৌন্দয্য বলে ও ধরা হয় ;) .
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+OK, save the file and refresh the site!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/bn-BD/deploy/README.md b/bn-BD/deploy/README.md
new file mode 100644
index 00000000000..00bc9abc351
--- /dev/null
+++ b/bn-BD/deploy/README.md
@@ -0,0 +1,246 @@
+# স্থাপন!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# গিট
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "আপনার নাম"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/bn-BD/deploy/install_git.md b/bn-BD/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/bn-BD/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/bn-BD/deploy/signup_pythonanywhere.md b/bn-BD/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/bn-BD/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/bn-BD/django/README.md b/bn-BD/django/README.md
new file mode 100644
index 00000000000..f72f5f12bd8
--- /dev/null
+++ b/bn-BD/django/README.md
@@ -0,0 +1,27 @@
+# Django কি?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. ওয়েব ফ্রেমওয়ার্ক হল উপকরনের সমষ্টি যা অাপনাকে দ্রুত ও সহজে ওয়েবসাইট বানাতে সাহায্য করে।.
+
+ওয়েবসাইট বানাতে হলে অামাদের সবসময়ই একই টাইপের উপকরন প্রয়োজন হয় । যেমন সাইন অাপ, সাইন ইন, ওয়েব সাইটের জন্য ম্যানেজমেন্ট প্যানেল, ফর্ম, ফাইল অাপলোডের জন্য ব্যাবস্থা করা ইত্যাদি।
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## ফ্রেমওয়ার্ক কেন প্রয়োজন?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+মনে কর একটা মেইলবক্স (পোর্ট) যেটার উপর প্রেরিত চিঠির(রিকুয়েস্ট) জন্য মনিটর করা হয়। এই সার্ভার একই কাজ করে। The web server reads the letter and then sends a response with a webpage. কিন্তু তুমি কিছু পাঠাতে চাইলে তোমার নকটেন্ট লাগবে। অার জ্যাঙ্গো হল সেটা যা তোমাকে কনটেন্ট তৈরিতে সাহাযা করবে।
+
+## কেউ তোমার সার্ভার থেকে রিকুয়েস্ট পাঠালে কি ঘটবে?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+চিঠিসহ একজন পত্রবাহককে কল্পনা কর। সে রাস্তা দিয়ে হাটছে অার চিঠির নাম্বারের সাথে বাড়ীর নাম্বার মিলিয়ে দেখছে। যদি এটা মিলে যায় তবে সে চিঠি রেখে অাসছে। একই ভাবে ইউঅার এল সার্ভার কাজ করে।
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. অাবার ইউজার ডাটাতে কোন পরিবর্তনের জন্য অনুরোধ করতে পারে। Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/bn-BD/django_admin/README.md b/bn-BD/django_admin/README.md
new file mode 100644
index 00000000000..164d44e398e
--- /dev/null
+++ b/bn-BD/django_admin/README.md
@@ -0,0 +1,57 @@
+# জ্যাঙ্গো এডমিন ( Django admin) 
+
+আমরা জ্যাঙ্গো এডমিন ব্যবহার করে মডেলকৃত পোষ্ট যোগ , সংযুক্ত বা সম্পাদন এবং ডিলিট করতে পারবো।
+
+চলুন, তাহলে আমরা কোড এডিটরে `blog/admin.py` ফাইলটি ওপেন করি এবং ফাইলের বিষয়বস্তু পরিবর্তন করি ।
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+আগের চ্যাপ্টারে যে পোষ্ট মডেলটি (Post model ) সংজ্ঞায়িত করেছিলাম সেটি এখানে আমরা ইম্পোর্ট(যুক্ত) করেছি। এডমিন প্যানেলে যাতে আমরা আমাদের মডেল দেখতে পারি সেইজন্য আমাদেরকে এইভাবে `admin.site.register(Post)` নিবন্ধন করতে হবে ।
+
+চলুন, এখন তাহলে আমাদের পোষ্ট মডেলটি খেয়াল করে দেখি । মনে রাখতে হবে , ওয়েব সার্ভার রান করার জন্য কনসোলে(console ) এই `python manage.py runserver` কমান্ডটি দিতে হবে । এখন ব্রাউজারটি ওপেন করে http://127.0.0.1:8000/admin/ এই এড্রেসটি টাইপ করবো। তাহলে, আমরা একটি লগইন পেইজ এভাবে দেখবো :
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/bn-BD/django_forms/README.md b/bn-BD/django_forms/README.md
new file mode 100644
index 00000000000..622df8798c1
--- /dev/null
+++ b/bn-BD/django_forms/README.md
@@ -0,0 +1,479 @@
+# জ্যাঙ্গো ফর্ম
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/bn-BD/django_installation/README.md b/bn-BD/django_installation/README.md
new file mode 100644
index 00000000000..421af3ff2de
--- /dev/null
+++ b/bn-BD/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django সংস্থাপন
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/bn-BD/django_installation/instructions.md b/bn-BD/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/bn-BD/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/bn-BD/django_models/README.md b/bn-BD/django_models/README.md
new file mode 100644
index 00000000000..bcd473c08ea
--- /dev/null
+++ b/bn-BD/django_models/README.md
@@ -0,0 +1,201 @@
+# Django মডেল
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/bn-BD/django_orm/README.md b/bn-BD/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/bn-BD/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/bn-BD/django_start_project/README.md b/bn-BD/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/bn-BD/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/bn-BD/django_templates/README.md b/bn-BD/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/bn-BD/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/bn-BD/django_urls/README.md b/bn-BD/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/bn-BD/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/bn-BD/django_views/README.md b/bn-BD/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/bn-BD/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/bn-BD/dynamic_data_in_templates/README.md b/bn-BD/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/bn-BD/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/bn-BD/extend_your_application/README.md b/bn-BD/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/bn-BD/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/bn-BD/how_the_internet_works/README.md b/bn-BD/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/bn-BD/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/bn-BD/html/README.md b/bn-BD/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/bn-BD/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/bn-BD/installation/README.md b/bn-BD/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/bn-BD/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/bn-BD/intro_to_command_line/README.md b/bn-BD/intro_to_command_line/README.md
new file mode 100644
index 00000000000..8a83f910ec6
--- /dev/null
+++ b/bn-BD/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## সারাংশ
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/bn-BD/intro_to_command_line/open_instructions.md b/bn-BD/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/bn-BD/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/bn-BD/python_installation/README.md b/bn-BD/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/bn-BD/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/bn-BD/python_installation/instructions.md b/bn-BD/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/bn-BD/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/bn-BD/python_introduction/README.md b/bn-BD/python_introduction/README.md
new file mode 100644
index 00000000000..ecafd5e6058
--- /dev/null
+++ b/bn-BD/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### সারাংশ
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### সারাংশ
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### সারাংশ
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## সারাংশ
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/bn-BD/template_extending/README.md b/bn-BD/template_extending/README.md
new file mode 100644
index 00000000000..d1c6d29d98e
--- /dev/null
+++ b/bn-BD/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template বর্ধন
+
+আপনার জন্য জাঙ্গো-এর আরেকটি আকর্ষণ হচ্ছে **template বর্ধন**। এর মানে কি? এর মানে হল আপনি আপনার ওয়েবসাইটে একই HML-এর অংশ ভিন্ন ভিন্ন ওয়েবপেজে ব্যবহার করতে পারবেন।
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+বেস টেমপ্লেট হল বেসিক টেমপ্লেট যা আপনি আপনার ওয়েবসাইটের প্রতিটি পৃষ্ঠায় বর্ধিত করে ব্যবহার করেন।
+
+এবার চলুন `blog/templates/blog/` এর ভিতরে `base.html` নামে একটি ফাইল তৈরি করি।
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+তারপর `base.html` `<body>` এবং `</body>` এর ভিতরে সব পরিবর্তন করি এটির সাথেঃ
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). আমরা এখন দেখব এটি কীভাবে কাজ করে।
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. এভাবে:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/bn-BD/whats_next/README.md b/bn-BD/whats_next/README.md
new file mode 100644
index 00000000000..3795850d941
--- /dev/null
+++ b/bn-BD/whats_next/README.md
@@ -0,0 +1,43 @@
+# এরপর কি?
+
+নিজেকে অভিনন্দন দিন! **আপনি অসাধারণ **। আমরা গর্বিত! <3
+
+### এখন কি করা যায়? 
+
+বিরতি নিন এবং আরাম করুন! আপনি আসলেই ইতিমধ্যে অনেক কিছু করে ফেলেছেন। 
+
+তদন্তর, আপ টু ডেট থাকার জন্য নিশ্চিত করুন আপনি জ্যাঙ্গো গার্লস এর [ফেসবুক](http://facebook.com/djangogirls) অথবা [টুইটার](https://twitter.com/djangogirls) একাউন্ট অনুসরণ করছেন। 
+
+### আপনি কি আরও কোনো রিসোর্স সুপারিশ করতে পারেন?
+
+হ্যাঁ! অনলাইনে *অনেক * রিসোর্স আছে সকল প্রকার প্রোগ্রামিং স্কিল শেখার জন্য - এটা বেস ভয়ংকর কাজ যে একটা শেখার পর আরেকটা শিখতে কোথায় যাব, কিন্তু আমরা আপনাকে সয়ংসম্পূর্ণ করব। যাই হোক, জ্যাঙ্গো গার্লস-এ আসার পূর্বে আপনার আগ্রহ কেমন ছিল, এবং টিউটোরিয়াল-এর মাধ্যমে যে আগ্রহই তৈরি করুন, এখানে কিছু ফ্রি রিসোর্স দেওয়া হল ( যে রিসোর্স অনেক উপাদানে সয়ংসম্পূর্ণ) আপনি এগুলো ব্যবহার করতে পারেন যেখানে চাইবেন। 
+
+#### জ্যাঙ্গো
+
+- আমাদের অন্যান্য বই, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [জ্যাঙ্গো-এর অফিশিয়াল টিউটোরিয়াল](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [শুরু করুন জ্যাঙ্গো ভিডিও পাঠের মাধ্যমে](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS এবং JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### পাইথন
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) - প্রাথমিক অনুশীলনগুলো পাবেন একদম বিনামূল্যে 
+- [New Coder tutorials](http://newcoder.io/tutorials/) - এটি কিভাবে পাইথন প্রয়োগ করতে পারেন তার বৈচিত্রপূর্ণ ব্যবহারিক উদাহরণসমূহ
+- [edX](https://www.edx.org/course?search_query=python) - আপনি এখান থেকে বেশিভাগ কোর্সই বিনামূল্যে পেতে পারেন, কিন্তু আপনি যদি উচ্চ শিক্ষার যোগ্যতার সনদ বা ক্রেডিট নিতে চান তাহলে আপনাকে টাকা প্রদান করতে হবে
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) - কিছু ভিডিও লেকচার বিনামূল্যে পেতে পারেন এবং আপনি কোর্সগুলোর জন্য Coursera-থেকে সনদও নিতে পারবেন । 
+- পাইথন সবার জন্য ([Python for Everybody](https://www.py4e.com/)) - সবাইকে পাইথন-এ দক্ষ করার জন্য Coursera- এর পক্ষ থেকে একটি ফ্রি ও উন্মুক্ত কোর্স। 
+
+#### ডেটা নিয়ে যত কাজ
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) - আপনি এখান থেকে বেশিভাগ কোর্সই বিনামূল্যে পেতে পারেন, কিন্তু আপনি যদি উচ্চ শিক্ষার যোগ্যতার সনদ বা ক্রেডিট নিতে চান তাহলে আপনাকে টাকা প্রদান করতে হবে
+- [Dataquest](https://www.dataquest.io/) - প্রথম ৩০ "missions" একদম বিনামূল্যে
+
+আপনি পরবর্তীতে কি তৈরি করছেন সেটা দেখার জন্য আমরা আর অপেক্ষা করতে পারছিনা!
\ No newline at end of file
diff --git a/bn/GLOSSARY.md b/bn/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/bn/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/bn/README.md b/bn/README.md
new file mode 100644
index 00000000000..a402ff95c48
--- /dev/null
+++ b/bn/README.md
@@ -0,0 +1,51 @@
+# Django মেয়েরা টিউটোরিয়াল
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## ভূমিকা
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? আপনি কি ওয়েবসাইট বানানো শিখতে চান, কিন্তু বিভিন্ন কারনে পারছেন না? বর্তমান সফটওয়্যার শিল্প কি আপনার নিজের সামান্য কোনো সফটওয়্যার বানানোর জন্যও অনেক জটিল মনে হয়?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/bn/SUMMARY.md b/bn/SUMMARY.md
new file mode 100644
index 00000000000..65e95596268
--- /dev/null
+++ b/bn/SUMMARY.md
@@ -0,0 +1,27 @@
+# সারাংশ
+
+* [ভূমিকা](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [কোড এডিটর](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [Django কি?](django/README.md)
+* [Django সংস্থাপন](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django মডেল](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [স্থাপন!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [টেম্পলেট বর্ধন](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [জ্যাঙ্গো ফর্ম](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/bn/chromebook_setup/README.md b/bn/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/bn/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/bn/chromebook_setup/instructions.md b/bn/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/bn/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/bn/code_editor/README.md b/bn/code_editor/README.md
new file mode 100644
index 00000000000..fb33bbdb9be
--- /dev/null
+++ b/bn/code_editor/README.md
@@ -0,0 +1,11 @@
+# কোড এডিটর
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+যেহেতু আপনি কোড লিখতে যাচ্ছেন তাই আপনার কোড এডিটর দরকার যেটা ডাউনলোড করার সময় এখনই!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/bn/code_editor/instructions.md b/bn/code_editor/instructions.md
new file mode 100644
index 00000000000..8c4542de99e
--- /dev/null
+++ b/bn/code_editor/instructions.md
@@ -0,0 +1,31 @@
+অনেক ধরণের কোড এডিটর পাওয়া যায় এবং আপনি কোনটা ব্যবহার করবেন সেটা নির্ভর করে পুরোপুরি আপনার উপর। সাধারণত পাইথন প্রোগ্রামাররা জটিল কিন্তু অনেক পাওয়ারফুল IDE (Integrated Development Environment) ব্যবহার করে থাকেন, যেমন পাইচার্ম। কিন্তু নতুনদের জন্য আমরা যেসব কোড এডিটর ব্যবহার করার পরামর্শ দেব সেগুলো একটু কম সুবিধাজনক হলেও সমান ক্ষমতাসম্পন্ন ও ব্যবহার করা অনেক সহজ।
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit ওপেন সোর্স ও ফ্রি এডিটর এবং সকল অপারেটিং সিস্টেম সাপোর্ট করে (যেমন লিনাক্স, উইন্ডোজ ইত্যাদি)।
+
+[ডাউনলোড করতে এখানে ক্লিক করুন](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[এখান থেকে ডাউনলোড করুন](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[এখান থেকে ডাউনলোড করুন](https://atom.io/)
+
+## আমরা কেন কোড এডিটর ইন্সটল করব?
+
+আপনি হয়ত অবাক হচ্ছেন কেন আমরা কোড এডিটর নামে বিশেষ সফটওয়্যার ইন্সটল করছি , সাধারন ওয়ার্ড বা নোটপ্যাড ব্যবহার না করে।
+
+তার প্রথম কারন হলো কোড **সাধারন টেক্সট** কিন্তু ওয়ার্ড বা টেক্সটএডিট- ধরনের সফ্টওয়্যারগুলো সাধারন টেক্সট তৈরী না করে রিচ টেক্সট(Rich Text) তৈরী করে যেটা RTF(Rich Text Format) বা এই ধরনের কোন ফর্মাটে থাকে। </p> 
+
+দ্বিতীয় কারন হলো কোডএডিটরের বিশেষ পারদর্শীতা হলো কোড এডিটিং, যাতে অনেক প্রয়োজনীয় জিনিস যেমন কোডকে তার বৈশিষ্ঠ্য অনুযায়ী রঙিন ভাবে দেখানো এবং বন্ধনীর(braces) কে নিজে থেকে শেষ করা ইত্যাদি। 
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/bn/css/README.md b/bn/css/README.md
new file mode 100644
index 00000000000..6e04ae8507c
--- /dev/null
+++ b/bn/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+আমাদের ব্লগ তেমন সুন্দর দেখা যাচ্ছে না, তাই না? এখনি সুন্দর করার সময়! আমরা এইজন্য CSS ব্যাবহার করব।
+
+## CSS কি?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+OK, save the file and refresh the site!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/bn/deploy/README.md b/bn/deploy/README.md
new file mode 100644
index 00000000000..c2b032bb740
--- /dev/null
+++ b/bn/deploy/README.md
@@ -0,0 +1,260 @@
+# স্থাপন!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/bn/deploy/install_git.md b/bn/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/bn/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/bn/deploy/signup_pythonanywhere.md b/bn/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/bn/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/bn/django/README.md b/bn/django/README.md
new file mode 100644
index 00000000000..6a17a644184
--- /dev/null
+++ b/bn/django/README.md
@@ -0,0 +1,27 @@
+# Django কি?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. ওয়েব ফ্রেমওয়ার্ক হল উপকরনের সমষ্টি যা অাপনাকে দ্রুত ও সহজে ওয়েবসাইট বানাতে সাহায্য করে।.
+
+ওয়েবসাইট বানাতে হলে অামাদের সবসময়ই একই টাইপের উপকরন প্রয়োজন হয় । যেমন সাইন অাপ, সাইন ইন, ওয়েব সাইটের জন্য ম্যানেজমেন্ট প্যানেল, ফর্ম, ফাইল অাপলোডের জন্য ব্যাবস্থা করা ইত্যাদি।
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## ফ্রেমওয়ার্ক কেন প্রয়োজন?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+মনে কর একটা মেইলবক্স (পোর্ট) যেটার উপর প্রেরিত চিঠির(রিকুয়েস্ট) জন্য মনিটর করা হয়। এই সার্ভার একই কাজ করে। The web server reads the letter and then sends a response with a webpage. কিন্তু তুমি কিছু পাঠাতে চাইলে তোমার নকটেন্ট লাগবে। অার জ্যাঙ্গো হল সেটা যা তোমাকে কনটেন্ট তৈরিতে সাহাযা করবে।
+
+## কেউ তোমার সার্ভার থেকে রিকুয়েস্ট পাঠালে কি ঘটবে?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+চিঠিসহ একজন পত্রবাহককে কল্পনা কর। সে রাস্তা দিয়ে হাটছে অার চিঠির নাম্বারের সাথে বাড়ীর নাম্বার মিলিয়ে দেখছে। যদি এটা মিলে যায় তবে সে চিঠি রেখে অাসছে। একই ভাবে ইউঅার এল সার্ভার কাজ করে।
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. অাবার ইউজার ডাটাতে কোন পরিবর্তনের জন্য অনুরোধ করতে পারে। Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+তারপর <0>view</0> রিকুয়েস্ট তৈরি করে অার জ্যাঙ্গো সেটাকে ইউজারের ওয়েব ব্রাউজারের পাঠাতে পারে।
+
+অামার অার গভীরে না গিয়ে জ্যাঙ্গো দিয়ে সহজ কিছু তৈরি করব অার এভাবেই অামরা গুরুত্বপুর্ন অংশ গুলো শিখে ফেলব।
\ No newline at end of file
diff --git a/bn/django_admin/README.md b/bn/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/bn/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/bn/django_forms/README.md b/bn/django_forms/README.md
new file mode 100644
index 00000000000..6523c130238
--- /dev/null
+++ b/bn/django_forms/README.md
@@ -0,0 +1,447 @@
+# জ্যাঙ্গো ফর্ম
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/bn/django_installation/README.md b/bn/django_installation/README.md
new file mode 100644
index 00000000000..38eb16f0918
--- /dev/null
+++ b/bn/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django সংস্থাপন
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/bn/django_installation/instructions.md b/bn/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/bn/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/bn/django_models/README.md b/bn/django_models/README.md
new file mode 100644
index 00000000000..c367f4dbab6
--- /dev/null
+++ b/bn/django_models/README.md
@@ -0,0 +1,199 @@
+# Django মডেল
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/bn/django_orm/README.md b/bn/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/bn/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/bn/django_start_project/README.md b/bn/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/bn/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/bn/django_templates/README.md b/bn/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/bn/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/bn/django_urls/README.md b/bn/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/bn/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/bn/django_views/README.md b/bn/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/bn/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/bn/dynamic_data_in_templates/README.md b/bn/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/bn/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/bn/extend_your_application/README.md b/bn/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/bn/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/bn/how_the_internet_works/README.md b/bn/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/bn/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/bn/html/README.md b/bn/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/bn/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/bn/install_git.md b/bn/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/bn/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/bn/installation/README.md b/bn/installation/README.md
new file mode 100644
index 00000000000..ccdfcd6f042
--- /dev/null
+++ b/bn/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [Django কি?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/bn/instructions.md b/bn/instructions.md
new file mode 100644
index 00000000000..30bd493b11b
--- /dev/null
+++ b/bn/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command dnf is not found. In that case you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/bn/intro_to_command_line/README.md b/bn/intro_to_command_line/README.md
new file mode 100644
index 00000000000..927cc65f7e5
--- /dev/null
+++ b/bn/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## সারাংশ
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/bn/python_installation/README.md b/bn/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/bn/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/bn/python_installation/instructions.md b/bn/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/bn/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/bn/python_introduction/README.md b/bn/python_introduction/README.md
new file mode 100644
index 00000000000..d1252c4408a
--- /dev/null
+++ b/bn/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### সারাংশ
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### সারাংশ
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### সারাংশ
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## সারাংশ
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/bn/signup_pythonanywhere.md b/bn/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/bn/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/bn/template_extending/README.md b/bn/template_extending/README.md
new file mode 100644
index 00000000000..c6e50445eb4
--- /dev/null
+++ b/bn/template_extending/README.md
@@ -0,0 +1,147 @@
+# টেম্পলেট বর্ধন
+
+জাঙ্গোর আরেকটি সুন্দর বিষয় হচ্ছে **টেম্পলেট বর্ধন**। এর মানে কি? এর মানে হল আপনি আপনার ওয়েবসাইটে একই এইচটিএমএল এর অংশ ভিন্ন ভিন্ন ওয়েবপেজে ব্যবহার করতে পারবেন।
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+বেস টেমপ্লেট হল বেসিক টেমপ্লেট যা আপনি আপনার ওয়েবসাইটের প্রতিটি পৃষ্ঠায় বর্ধিত করে ব্যবহার করেন।
+
+এবার চলুন `blog/templates/blog/` এর ভিতরে `base.html` নামে একটি ফাইল তৈরি করি।
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+এটি ওপেন করার পর `post_list.html` থেকে সবকিছু `base.html` ফাইলে কপি করি, নিচের মত করেঃ
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+তারপর `base.html` `<body>` এবং `</body>` এর ভিতরে সব পরিবর্তন করি এটির সাথেঃ
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). আমরা এখন দেখব এটি কীভাবে কাজ করে।
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. এভাবে:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+ব্যাস! চেক করুন আপনার ওয়েব সাইটের এখনো সঠিকভাবে কাজ করছে কিন. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/bn/whats_next/README.md b/bn/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/bn/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/ca-ES/GLOSSARY.md b/ca-ES/GLOSSARY.md
new file mode 100644
index 00000000000..808f592bd33
--- /dev/null
+++ b/ca-ES/GLOSSARY.md
@@ -0,0 +1,3 @@
+# editor de codi
+
+L'editor de codi és una aplicació que et permet guardar el teu codi de manera que puguis tornar-hi més tard. Pots saber on aconseguir-ne un al [Capítol sobre l'editor de codi](./code_editor/README.md)
\ No newline at end of file
diff --git a/ca-ES/README.md b/ca-ES/README.md
new file mode 100644
index 00000000000..acb370a8988
--- /dev/null
+++ b/ca-ES/README.md
@@ -0,0 +1,51 @@
+# Tutorial de les Django Girls
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Aquest treball té una llicència Internacional Creative Commons de Reconeixement - Compartir Igual 4.0. Per a veure una còpia d'aquesta llicència, visita https://creativecommons.org/licenses/by-sa/4.0/
+
+## Benvinguda
+
+Benvingudes al Tutorial Noies Django! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introducció
+
+Alguna vegada has sentit que al món cada vegada hi ha més tecnologia que et resulta (de moment) estranya? Alguna vegada t'has preguntat com crear una pàgina web però t'ha faltat motivació per començar? Alguna vegada has pensat que el món del software és massa complicat com per ni tan sols provar-ho pel teu compte?
+
+Bé, tenim bones notícies! Programar no és pas tan difícil com sembla i et volem ensenyar com pot ser de divertit.
+
+Aquest tutorial no et convertirà en programador com per art de màgia. Per a fer-ho bé, cal mesos o anys de pràctica. Però et volem demostrar que programar o crear llocs web no és tan dicícil com sembla. Intentarem explicar diferents parts tan bé com poguem, perquè no et sentis intimidada per la tecnologia.
+
+Esperem ser capaços de transmetre't el nostre amor per la tecnologia!
+
+## Què aprendràs en aquest tutorial?
+
+Un cop hauràs acabat el tutorial, tindràs una petita web en funcionament: el teu propi blog. T'ensenyarem com posar-lo en línia, de manera que altra gent pugui veure la teva feina!
+
+Tindrà (més o menys) aquest aspecte:
+
+![Figura 0.1](images/application.png)
+
+> Si treballes amb el tutorial pel teu compte i no tens ajuda t'ajudarem en cas de problema, tenim un xat:[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Hem demanat als nostres instructors i antics alumnes que vinguin per aquí de tan en tant per ajudar amb el tutorial! No tinguis por de preguntar!
+
+D'acord, [comencem perl principi...](./how_the_internet_works/README.md)
+
+## Seguint el tutorial des de casa
+
+És increïble participar a un taller de Noies Django, però som conscients que no sempre és fàcil assistir. Per això t'animem a seguir el tutorial des de casa. Per als que ens llegeixen des de casa, ara estem preparant vídeos que faran més fàcil seguir el tutorial pel vostre compte. És una feina que encara està en curs, però s'aniran cobrint cada vegada més continguts al canal de Youtube [Programar és cosa de noies](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed).
+
+A cada capítol ja cobert, hi ha un enllaç que dirigeix al vídeo corresponent.
+
+## Sobre nosaltres i Contribució
+
+Aquest tutorial és mantingut per [Noies Django](https://djangogirls.org/). Si trobes algun error o vols actualitzar el tutorial si us plau [segueix les guies de contribució](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## T'agradaria ajudar-nos a traduir el tutorial a altres llengües?
+
+En aquest moment, les traduccions es guarden a la plataforma crowdin.com a:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Si la teva llengua no és a la llista a [crowdin](https://crowdin.com/), si us plau[obre un nou assumpte](https://github.com/DjangoGirls/tutorial/issues/new)informant-nos de la llengua que falta per a que la poguem afegir.
\ No newline at end of file
diff --git a/ca-ES/SUMMARY.md b/ca-ES/SUMMARY.md
new file mode 100644
index 00000000000..401d2e90f12
--- /dev/null
+++ b/ca-ES/SUMMARY.md
@@ -0,0 +1,35 @@
+# Resum
+
+* [Introducció](README.md)
+* [Instal·lació](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Instal·lació (chromebook)](chromebook_setup/README.md)
+* [Com funciona Internet](how_the_internet_works/README.md)
+* [Introducció a línia d'ordres](intro_to_command_line/README.md)
+* [Instal·lació de Python](python_installation/README.md)
+* [Editor de codi](code_editor/README.md)
+* [Introducció a Python](python_introduction/README.md)
+* [Què és Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/ca-ES/chromebook_setup/README.md b/ca-ES/chromebook_setup/README.md
new file mode 100644
index 00000000000..c4a4c860b13
--- /dev/null
+++ b/ca-ES/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Instal·lació en Chromebook
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ca-ES/chromebook_setup/instructions.md b/ca-ES/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..b48dc92b80b
--- /dev/null
+++ b/ca-ES/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Pots [saltar fins aquesta secció](http://tutorial.djangogirls.org/en/installation/#install-python) si no fas servir un Chromebook. Si el fas servir, la teva experiència d'instal·lació serà una mica diferent. Pots ignorar la resta d'instruccions d'instal·lació.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+L'entorn de desenvolupament integrat (IDE) en núvol és una eina que t'ofereix un editor de codi i accés a un ordinador funcionant a Internet, on pots instal·lar, escriure i executar el programari. Durant la resta del tutorial, aquest IDE en núvol actuarà com la teva *màquina local*. Executaràs comandes des d'una interfície de terminal, com les teves companyes de classe fan amb OS X, Ubuntu o Windows, però la teva estarà conectada a un ordinador executant-se en algun altre lloc de la xarxa. El IDE en núvol la prepararà per a tu. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Pots elegir-ne un i seguir les seves instruccions.
+
+#### PaizaCloud Cloud IDE
+
+1. Ves a [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Registra't
+3. Click *New Server* and choose the Django app
+4. Clica el botò Terminal (a la part esquerra de la finestra)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Entorn Virtual
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ca-ES/code_editor/README.md b/ca-ES/code_editor/README.md
new file mode 100644
index 00000000000..ebbf0bef58d
--- /dev/null
+++ b/ca-ES/code_editor/README.md
@@ -0,0 +1,11 @@
+# Editor de codi
+
+> Per les lectores que són a casa: el vídeo [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) tracta sobre aquest tema.
+
+En breu escriuràs la teva primera línia de codi, així que ha arribat l'hora de descarregar un editor de codi!
+
+> **Nota** Si estàs fent servir un Chromebook, salta't aquest capítol i segueix les instruccions que trobaràs a [Chromebook Setup](../chromebook_setup/README.md). L'IDE cloud que has triat (PaizaCloud Cloud IDE o AWS Cloud9) inclou un editor de codi. Així doncs, quan obris un fitxer al teu IDE des del menú d'arxiu ja estaràs emprant l'editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ca-ES/code_editor/instructions.md b/ca-ES/code_editor/instructions.md
new file mode 100644
index 00000000000..55d19377660
--- /dev/null
+++ b/ca-ES/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Hi ha molts editors de codi diferents. L'elecció d'un o d'altre editor dependrà bàsicament de preferències personals. La majoria de programadores en Python van més enllà i utilitzen IDEs (entorns de desenvolupament integrat -Integrated Development Environments-) complexos però extremadament potents, com ara PyCharm. Aquesta darrera opció, però, és segurament poc adient per algú que tot just comença a programar. Les nostres recomanacions són igual de potents, però molt més simples.
+
+A continuació trobaràs les nostres recomanacions. Pots demanar a la teva instructora si té alguna preferència, així li serà més fàcil ajudar-te.
+
+## Visual Studio Code
+
+Visual Studio Code és un editor de codi desenvolupat per Microsoft per als sistemes Windows, Linux i macOS. Inclou suport per deupració, control de Git encastat, sintaxi reslatada, completació intel·ligent de codi, snippets i refactorització de codi.
+
+[Descarrega'l aquí](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit és un editor gratuit, de programari lliure, disponible per tots els sistemes operatius.
+
+[Descarrega'l aquí](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text és un editor molt popular amb un període d'avaluació gratuït i disponible per tots els sistemes operatius.
+
+[Descarrega'l aquí](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom és un altre editor popular. És gratiut, de programari lliure i disponible per Windows, OS X i Linux. Atom és desenvolupat per [GitHub](https://github.com/).
+
+[Descarrega'l aquí](https://atom.io/)
+
+## Per què estem instal·lant un editor de codi?
+
+Et pots estar demanant per què estem instal·lant programari específic per codi, en lloc d'usar alternatives com Word o Notepad.
+
+La primera raó és que el codi s'ha d'emmagatzemar en **text pla**. El problema amb programes com el Word o el TextEdit és que, per defecte, no produeixen text pla. Produeixen text enriquit (amb fonts i format), utilitzant formats personalitzats com el [RTF (Format de Text Enriquit -Rich Text Format -)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+La segona raó és que els editors de codi s'han especialitzat precisament en això, en editar codi. Així doncs, proporcionen característiques útils com acolorir el text del codi en funció del seu significat o tancar-te automàticament els parèntesis.
+
+Més endavant veurem tot això a la pràctica. Aviat consideraràs el teu antic i fidel editor de codi com una de les teves eines favorites. :)
\ No newline at end of file
diff --git a/ca-ES/css/README.md b/ca-ES/css/README.md
new file mode 100644
index 00000000000..f2f78b2317a
--- /dev/null
+++ b/ca-ES/css/README.md
@@ -0,0 +1,330 @@
+# CSS - fes-lo maco!
+
+El nostre blog encara sembla una mica lleig, oi? És hora de fer-lo maco! Per a això farem servir els CSS.
+
+## Què són els CSS?
+
+Els fulls d’estil en cascada (Cascading Style Sheets -CSS-) es fan servir per definir com es formatarà i veurà un lloc web escrit en un llenguatge de marcat (com l'HTML). Els pots considerar com el maquillatge de la nostra pàgina web. ;)
+
+Però no volem tornar a començar des de zero, oi? Un cop més, farem servir una eina gratuïta distribuïda per Internet. Saps, reinventar la roda no és divertit.
+
+## Utilitzem Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/ca-ES/deploy/README.md b/ca-ES/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/ca-ES/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/ca-ES/deploy/install_git.md b/ca-ES/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/ca-ES/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ca-ES/deploy/signup_pythonanywhere.md b/ca-ES/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/ca-ES/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ca-ES/django/README.md b/ca-ES/django/README.md
new file mode 100644
index 00000000000..f87d87954c4
--- /dev/null
+++ b/ca-ES/django/README.md
@@ -0,0 +1,27 @@
+# Què és Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) és un entorn de treball per aplicacions web (framework web) de codi lliure i gratuït escrit en Python. Un framework web consta d'un seguit de components que ens ajuda a desenvolupar llocs web d'una forma més fàcil i ràpida.
+
+En la construcció d'un lloc web necessitem sempre un conjunt de components semblant: una forma de gestionar l'autenticació d'usuaris (registre, inici i tancament de sessió), un panell de control, formularis, un sistema per carregar fitxers, etc.
+
+Afortunadament per nosaltres, algú es va adonar fa molt de temps que les desenvolupadores web s'enfronten un i altre cop als mateixos problemes quan construeixen un lloc web. Així doncs, es van unir i crearen frameworks (com ara Django) amb components llestos per ser emprats.
+
+Els frameworks existeixen per estalviar-nos haver de reinventar la roda i ajudar-nos a disminuir el treball addicional que això implica quan estem construint un nou lloc web.
+
+## Per què necessitem un framework?
+
+Per entendre la finalitat de Django necessitem entendre una mica els servidors. La primera cosa de la que un servidor se n'ha d'adonar és que volem que ens proporcioni una determinada pàgina web.
+
+Imagina una bústia de correu (port) que s'observa per saber quan arriben cartes (peticions). Això mateix és el que fa un servidor web. El servidor web llegeix la carta i envia una resposta amb la pàgina web. Per enviar alguna cosa, però, necessitem un contingut. Contingut que Django ens ajuda a crear.
+
+## Què és el que passa quan algú demana per un lloc web al teu servidor?
+
+Quan una petició arriba al servidor web, s'envia a Django, que tracta d'entendre que és el que se li està demanant. Primer agafa l'adreça de la pàgina web i intenta esbrinar què n'ha de fer. D'això s'encarrega un component de Django anomenat **urlresolver** (fixa't que l'adreça d'un lloc web es diu URL (localitzador uniforme de recursos – Uniform Resource Locator –. Per tant, el mot *urlresolver* sembla ben triat). Aquest component no és gaire llest: disposa d'un llistat de patrons i mira d'esbrinar a quin d'ells s'ajusta la URL en qüestió. Django revisa els patrons d'adalt a baix i si en troba un de coincident, aleshores envia la petició a la funció associada (que anomenem *view* – vista –).
+
+Imagina una cartera que ha d'entregar una carta. Va caminant pel carrer tot mirant els números dels edificis per trobar el que coincideix amb el que duu la carta. Si en troba un que coincideix, allà l'entrega. Així és com funciona l'urlresolver!
+
+A la funció *view* és on es fan les coses interessants: podem buscar informació en una base de dades. L'usuari potser demana que es canviï alguna dada? Com una carta que digui: "Si us plau, canvia la descripció de la meva feina." La *view* pot comprovar si s'està autoritzat a fer-ho i, si és el cas, actualitzar la descripció i enviar un missatge de confirmació: "Fet!" Aleshores la *view* genera una resposta i Django la pot enviar al navegador de l'usuari.
+
+L'anterior explicació s'ha simplificat una mica ja que encara no cal que sàpigues tots els detalls tècnics. Amb que tinguis una idea general ja n'hi ha prou.
+
+Així doncs, enlloc d'aprofundir massa en els detalls, començarem creant alguna cosa amb Django i així aprendrem com funcionen els components importants!
\ No newline at end of file
diff --git a/ca-ES/django_admin/README.md b/ca-ES/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/ca-ES/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ca-ES/django_forms/README.md b/ca-ES/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/ca-ES/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ca-ES/django_installation/README.md b/ca-ES/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/ca-ES/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ca-ES/django_installation/instructions.md b/ca-ES/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/ca-ES/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ca-ES/django_models/README.md b/ca-ES/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/ca-ES/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ca-ES/django_orm/README.md b/ca-ES/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/ca-ES/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ca-ES/django_start_project/README.md b/ca-ES/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/ca-ES/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ca-ES/django_templates/README.md b/ca-ES/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/ca-ES/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ca-ES/django_urls/README.md b/ca-ES/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/ca-ES/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ca-ES/django_views/README.md b/ca-ES/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/ca-ES/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ca-ES/dynamic_data_in_templates/README.md b/ca-ES/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/ca-ES/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ca-ES/extend_your_application/README.md b/ca-ES/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/ca-ES/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ca-ES/how_the_internet_works/README.md b/ca-ES/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/ca-ES/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ca-ES/html/README.md b/ca-ES/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/ca-ES/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ca-ES/installation/README.md b/ca-ES/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/ca-ES/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ca-ES/intro_to_command_line/README.md b/ca-ES/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/ca-ES/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ca-ES/intro_to_command_line/open_instructions.md b/ca-ES/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/ca-ES/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ca-ES/python_installation/README.md b/ca-ES/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/ca-ES/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ca-ES/python_installation/instructions.md b/ca-ES/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/ca-ES/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ca-ES/python_introduction/README.md b/ca-ES/python_introduction/README.md
new file mode 100644
index 00000000000..320bba5ae1e
--- /dev/null
+++ b/ca-ES/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introducció a Python
+
+> Algunes parts d'aquest capítol es basen en els tutorials de les Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Anem a escriure una mica de codi!
+
+## Línia de comandes (prompt) de Python
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ca-ES/template_extending/README.md b/ca-ES/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/ca-ES/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ca-ES/whats_next/README.md b/ca-ES/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/ca-ES/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/ca/GLOSSARY.md b/ca/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/ca/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/ca/README.md b/ca/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/ca/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ca/SUMMARY.md b/ca/SUMMARY.md
new file mode 100644
index 00000000000..7a45700a27d
--- /dev/null
+++ b/ca/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/ca/chromebook_setup/README.md b/ca/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/ca/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ca/chromebook_setup/instructions.md b/ca/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/ca/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ca/code_editor/README.md b/ca/code_editor/README.md
new file mode 100644
index 00000000000..404011f1b7d
--- /dev/null
+++ b/ca/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ca/code_editor/instructions.md b/ca/code_editor/instructions.md
new file mode 100644
index 00000000000..cc66fde0da0
--- /dev/null
+++ b/ca/code_editor/instructions.md
@@ -0,0 +1,31 @@
+Existeixen gran quantitat d'editors diferents, i l'elecció d'un de particular es redueix principalment a gustos personals. La majoria de programdors de Python utilitzen IDEs (Entorns de Desenvolupament Integrat) complexos però extremadament potents, com ara PyCharm. Com a principiant, això és segurament menys adequat; les nostres recomanacions són igualment potents, però molt més simples.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+El Gedit és un editor gratuït, open-source, disponible per a tots els sistemes operatius.
+
+[Descarrega'l aquí](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Descarrega'l aquí](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Descarrega'l aquí](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ca/css/README.md b/ca/css/README.md
new file mode 100644
index 00000000000..04d5996ae52
--- /dev/null
+++ b/ca/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/ca/deploy/README.md b/ca/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/ca/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/ca/deploy/install_git.md b/ca/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ca/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ca/deploy/signup_pythonanywhere.md b/ca/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/ca/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ca/django/README.md b/ca/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/ca/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/ca/django_admin/README.md b/ca/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/ca/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ca/django_forms/README.md b/ca/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/ca/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/ca/django_installation/README.md b/ca/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/ca/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ca/django_installation/instructions.md b/ca/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/ca/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ca/django_models/README.md b/ca/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/ca/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ca/django_orm/README.md b/ca/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/ca/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ca/django_start_project/README.md b/ca/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/ca/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ca/django_templates/README.md b/ca/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/ca/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ca/django_urls/README.md b/ca/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/ca/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/ca/django_views/README.md b/ca/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/ca/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/ca/dynamic_data_in_templates/README.md b/ca/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/ca/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/ca/extend_your_application/README.md b/ca/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/ca/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/ca/how_the_internet_works/README.md b/ca/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/ca/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ca/html/README.md b/ca/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/ca/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ca/install_git.md b/ca/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ca/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ca/installation/README.md b/ca/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/ca/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ca/instructions.md b/ca/instructions.md
new file mode 100644
index 00000000000..30bd493b11b
--- /dev/null
+++ b/ca/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command dnf is not found. In that case you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ca/intro_to_command_line/README.md b/ca/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/ca/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ca/python_installation/README.md b/ca/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/ca/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ca/python_installation/instructions.md b/ca/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/ca/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ca/python_introduction/README.md b/ca/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/ca/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ca/signup_pythonanywhere.md b/ca/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/ca/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ca/template_extending/README.md b/ca/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/ca/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ca/whats_next/README.md b/ca/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/ca/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/cs-CZ/GLOSSARY.md b/cs-CZ/GLOSSARY.md
new file mode 100644
index 00000000000..3107893bace
--- /dev/null
+++ b/cs-CZ/GLOSSARY.md
@@ -0,0 +1,3 @@
+# editor zdrojového kódu
+
+Editor kódu je aplikace, která umožňuje uložit váš kód, takže bude možné vrátit se k němu později. Kde ho můžeš získat se dozvíš v [Kapitole editor kódu](./code_editor/README.md).
\ No newline at end of file
diff --git a/cs-CZ/README.md b/cs-CZ/README.md
new file mode 100644
index 00000000000..1ac284e7d6e
--- /dev/null
+++ b/cs-CZ/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutoriál
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Tento návod je licencován pod Creative Commons Attribution-ShareAlike 4.0 mezinárodní licencí. Chcete-li zobrazit kopii této licence, navštivte https://creativecommons.org/licenses/by-sa/4.0/
+
+## Vítej
+
+Vítej v Django Girls Tutoriálu! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Úvod
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Přemýšlela jsi někdy, jak vytvořit webové stránky, ale nikdy jsi neměla dostatek motivace začít? Přemýšlela jsi někdy, že svět softwaru je pro tebe příliš složitý, aby jsi zkusila něco naprogramovat sama?
+
+Máme pro tebe dobrou zprávu! Programování není tak těžké jak se zdá, a zde ti chceme ukázat, jak zábavné to může být.
+
+This tutorial will not magically turn you into a programmer. Jestli chceš být dobrý programátor, budeš potřebovat měsíce nebo dokonce roky učení a praxe. Ale chceme ti ukázat, že programování nebo tvorba webových stránek není tak složitá, jak se zdá. Budeme se snažit ti vysvětlit různé kousky a střípky, tak jednoduše jak dokážeme, aby jsi se necítila zastrašena technologií.
+
+Doufáme, že se nám podaří ti přiblížit tuto technologii tak, aby jsi ji měla stejně ráda jako my!
+
+## Co se naučíš během kurzu?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+Tvá aplikace (více či méně) bude vypadat takto:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Požádali jsme kouče a předchozí účastníky kurzu, aby čas od času pomáhali ostatním s tímto kurzem! Neboj se zde zeptat na jakoukoliv otázku!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## O kurzu a přispěvatelích
+
+Tento kurz je provozován [DjangoGirls](https://djangogirls.org/). Pokud najdeš nějaké chyby, nebo chceš aktualizovat návod, prosím,[postupuj podle pokynů pro přispívající](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/cs-CZ/SUMMARY.md b/cs-CZ/SUMMARY.md
new file mode 100644
index 00000000000..080c990996d
--- /dev/null
+++ b/cs-CZ/SUMMARY.md
@@ -0,0 +1,35 @@
+# Shrnutí
+
+* [Úvod](README.md)
+* [Instalace](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [Jak funguje Internet](how_the_internet_works/README.md)
+* [Úvod do příkazové řádky](intro_to_command_line/README.md)
+* [Instalace Pythonu](python_installation/README.md)
+* [Editor zdrojového kódu](code_editor/README.md)
+* [Úvod do Pythonu](python_introduction/README.md)
+* [Co je Django?](django/README.md)
+* [Instalace Django](django_installation/README.md)
+* [Tvůj první Django projekt!](django_start_project/README.md)
+* [Django modely](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Nasazení!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Úvod do HTML](html/README.md)
+* [Django ORM (tvorba dotazů)](django_orm/README.md)
+* [Dynamická data v šablonách](dynamic_data_in_templates/README.md)
+* [Django šablony](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Rozšiřování šablon](template_extending/README.md)
+* [Rozšíření tvé aplikace](extend_your_application/README.md)
+* [Django formuláře](django_forms/README.md)
+* [Co dál?](whats_next/README.md)
\ No newline at end of file
diff --git a/cs-CZ/chromebook_setup/README.md b/cs-CZ/chromebook_setup/README.md
new file mode 100644
index 00000000000..802d9c77ac9
--- /dev/null
+++ b/cs-CZ/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Poznámka** Pokud jsi již prošla [instalačními kroky](../installation/README.md), není třeba to znovu dělat – můžeš přeskočit přímo vpřed na [Úvod do Pythonu](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/cs-CZ/chromebook_setup/instructions.md b/cs-CZ/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..2079bce2c8b
--- /dev/null
+++ b/cs-CZ/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Pokud nepoužíváš Chromebook, můžeš [přeskočit přímo na tuto sekci](http://tutorial.djangogirls.org/en/installation/#install-python). Pokud Chromebook používáš, postup instalace se bude trochu lišit. Takže zbytek návodu k instalaci můžeš ignorovat.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE je nástroj, který ti umožňuje využívat editor kódu a přístup k počítači běžícím na internetu, kde můžeš instalovat, psát a spouštět software. V průběhu tutoriálu se Cloud IDE bude chovat jako tvůj *lokální počítač*. Příkazy budeš psát stále pomocí příkazové řádky v terminálu stejně jako tví spolužáci na OS X, Ubuntu nebo Windows, ale tvůj terminál bude propojený s počítačem běžícím někde jinde, což je řešeno pomocí Cloud IDE. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Můžeš si vybrat jedno z Cloud IDE řešení a následovat instrukce nastavení pro zvolený typ.
+
+#### PaizaCloud ID
+
+1. Jdi na [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Zaregistruj se nebo se přihlaš ke svému účtu, pokud již registrovaná jsi.
+3. Klikni na *Nový Server* a vyber možnost Django App.
+4. Klikni na tlačítko Terminál (na levé straně okna).
+
+Nyní bys měla vidět rozhraní s postranním panelem a tlačítka nalevo. Klikni na tlačítko Terminál, kde po otevření příkazové řádky uvidíš něco jako:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+Terminál v PaizaCloud IDE je připraven a čeká na tvé příkazy. Můžeš měnit velikost okna, pokud ti nevyhovuje velikost zobrazení.
+
+#### AWS Cloud9
+
+Momentálně Cloud9 vyžaduje, aby ses přihlásila pomocí AWS účtu a zadala jako platební metodu tvou platební kartu.
+
+1. Nainstaluj si Cloud9 z odkazu [Chrome webový obchod](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Běž na [c9.io](https://c9.io) a klikni na *Get started with AWS Cloud9*
+3. Přihlaš se pomocí svého AWS účtu (vyžaduje zadání platebních údajů, ale bude možné využívat jej zdarma bez placení).
+4. V AWS nástěnce vlož *Cloud9* ve vyhledávacím políčku a dej vyhledat.
+5. Na Cloud9 nástěnce klikni na *Vytvořit prostředí*
+6. Pojmenuj to jako *django-girls*
+7. Zatímco se konfiguruje nastavení, pro "Typ prostředí" vyber možnost *Vytvořit novou instanci pro prostředí (EC2)* a jako "Typ instance" zvol *t2.micro* (mělo by zmiňovat ""Free-tier eligible."). Výchozí nastavení plateb a výdajů lze nechat tak, jak je a stejně pokračovat i u dalších nastavení.
+8. Klikni na *Další krok*
+9. Klikni na *Vytvořit prostředí*
+
+Nyní bys měla vidět rozhraní s postranním panelem a velkým hlavním oknem, kde bude nějaký text a malé okno v dolní části stránky, které vypadá přibližně takto:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+Tato dolní část je tvůj terminál. Můžeš jej použít pro zadání příkazů pro vzdálený Cloud9 počítač. Můžeš měnit velikost okna, jak potřebuješ.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtuální prostředí
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### Python Anywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/cs-CZ/code_editor/README.md b/cs-CZ/code_editor/README.md
new file mode 100644
index 00000000000..8ce898b2940
--- /dev/null
+++ b/cs-CZ/code_editor/README.md
@@ -0,0 +1,11 @@
+# Editor zdrojového kódu
+
+> Čtení na doma: tato kapitola je pokryta ve videu [Instalujeme pro Python & Editor kódu](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+Právě se chystáš napsat svůj první řádek kódu, takže je čas sáhnout po editoru kódu!
+
+> **Poznámka** POkud používáš Chromebook přeskoč tuto kapitolu a ujisti se, že následuješ pokyny pro [Nastavení Chromebooku](../chromebook_setup/README.md). Cloudové IDE, které si vybereš (Paiza Cloud nebo AWS Cliud9) zahrnuje editor kódu a když otevřeš soubor ve tvém IDE z nabídky souborů, automaticky použije editor kódu.
+> 
+> **Poznámka** Je možné, že jsi to již udělala dříve v [kapitole o instalaci](../installation/README.md) – pokud ano, můžeš přeskočit rovnou an další kapitolu!!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/cs-CZ/code_editor/instructions.md b/cs-CZ/code_editor/instructions.md
new file mode 100644
index 00000000000..9131a89dca5
--- /dev/null
+++ b/cs-CZ/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Existuje mnoho různých editorů a z velké části se výběr scvrkává na osobní preference. Většina programátorů v Pythonu používá složité, ale mimořádně mocné IDE (integrovaná vývojová prostředí), například PyCharm. Pro začátečníka to může být pravděpodobně méně vhodné, naše doporučení jsou stejně mocná, ale mnohem jednodušší.
+
+Naše návrhy jsou napsané níže, ale neváhejte se zeptat svého kouče, jaké jsou jeho preference - poté bude i jednodušší získat od něj pomoc s prací v editoru.
+
+## Visual Studio Code
+
+XPath: /p[3]. Zahrnuje technickou podporu pro tzv. debugging, kompletní možnost práce s Gitem, zvýrazňování syntaxe jazyka, inteligentní pomoc pro psaní kódu, napovědu a možnost refactorovat kód.
+
+[Stáhnout si jej můžeš zde](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit je open-source editor. Je k dispozici zdarma pro všechny operační systémy.
+
+[Stáhnout si jej můžeš zde](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime je velmi oblíbený a známý editor s možností využít zkušební verzi zdarma a je dostupný pro všechny operační systémy.
+
+[Stáhnout si jej můžeš zde](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom je další populární editor. Je zdarma, open-source a je k dispozici pro Windows, OS X a Linux. Atom byl vyvinut firmou [GitHub](https://github.com/).
+
+[Stáhnout si jej můžete zde](https://atom.io/)
+
+## Proč instalujeme editor kódu?
+
+Možná přemýšlíte, proč instalujeme speciální editor a proč raději nezvolíme něco jako Notepad nebo Word.
+
+První důvod je, že kód musí být **prostý text** a problém s programy jako Word a Textedit je ten, že ve skutečnosti neprodukují prostý text ale bohatý text (s fonty a formátováním), používají vlastní formáty jako [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+Druhým důvodem je, že editory kódu jsou pro tuto práci uzpůsobené tak, že poskytují užitečné pomůcky jako je barevné zvýrazňování různých částí kódu podle jejich významu či automatické uzavírání uvozovek.
+
+V akci to uvidíme později. Brzy budeš na svůj editor kódu nahlížet jako na jeden ze svých oblíbených nástrojů. :)
\ No newline at end of file
diff --git a/cs-CZ/css/README.md b/cs-CZ/css/README.md
new file mode 100644
index 00000000000..0d4ec82b563
--- /dev/null
+++ b/cs-CZ/css/README.md
@@ -0,0 +1,330 @@
+# CSS - zkrášli svou stránku!
+
+Náš blog nevypadá stále dost pěkně, že? Je na čase ho udělat hezčí! Použijeme na to CSS.
+
+## Co je to CSS?
+
+Kaskádové styly (Cascading Style Sheets, CSS) je jazyk používáný pro popis vzhledu a formátu webové stránky napsané ve značkovacím jazyce (jako například HTML). Berte to jako make-up pro naši webovou stránku. ;)
+
+Ale nechceme začínat od nuly, že? Znovu použijeme něco, co už někdo vytvořil a umístil na Internet aby to mohli ostatní programátoři používat zdarma. Vymýšlení už vymyšlených věcí není zábava.
+
+## Použijme Bootstrap!
+
+Bootstrap je jeden z nejpopulárnějších frameworků pro HTML a CSS na vytváření krásných webových stránek: https://getbootstrap.com/
+
+Byl vytvořen programátory, kteří pracovali pro Twitter. Nyní je Bootstrap vyvíjen dobrovolníky po celém světě!
+
+## Instalace Bootstrapu
+
+Pro instalaci Bootstrapu otevři svůj `.html` soubor v kódovém editoru a přidej tohle do `<head>` sekce:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Nepřidá to žádné soubory do tvého projektu. Jen to ukazuje na soubory, které existují na Internet. Takže do toho, otevři svoji webovou stránku a obnov ji. To je ono!
+
+![Obrázek 14.1](images/bootstrap1.png)
+
+Hned to vypadá lépe!
+
+## Statické soubory v Djangu
+
+Konečně se podíváme zblízka na téma, které jsme již zmínili, **statické soubory**. Statické soubory jsou všechna tvá CSS a obrázky. Jejich obsah nezávisí na kontextu požadavku a bude stejný pro každého uživatele.
+
+### Kam umístit statické soubory pro Django
+
+Django již ví, kde najít statické soubory pro vestavěnou "admin" aplikaci. Nyní potřebujeme přidat nějaké statické soubory do naší vlastní aplikace, `blog`.
+
+Uděláš to tak, že vytvoříš složku s názvem `static` uvnitř aplikace blog:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django bude automaticky hledat jakékoliv složky nazvané "static" uvnitř tvých složek v aplikaci. Poté bude schopný použít jejich obsah jako statické soubory.
+
+## Tvůj první soubor CSS!
+
+Pojďme vytvořit nějaký CSS soubor a přidat vlastní styly pro tvou webovou stránku. Vytvoř nový adresář s názvem `css` uvnitř adresáře `static`. Vytvoř nový soubor s názvem `blog.css` uvnitř tohoto adresáře `css`. Připraveno?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Čas k napsání nějakého CSS! Otevři soubor `blog/static/css/blog.css` v editoru kódu.
+
+Zde nebudeme zacházet příliš do detailů a učit se CSS nebo jej přizpůsobovat. Pokud se budeš chtít naučit více o CSS, na konci této stránky najdeš doporučení na CSS kurz zdarma.
+
+Ale pojďme něco málo udělat. Možná bychom mohli změnit barvu našich nadpisů? Pro interpretaci barev, počítače používají speciální kódy. Tyto kódy začínají `#` a následuje 6 písmen(A-F) a číslic(0-9). Například kód pro modrou barvu bude vypadat takto: `#0000FF`. Kódy všech barev můžeš najít například zde: http://www.colorpicker.com/. Můžeš také použít [předdefinované barvy](http://www.w3schools.com/colors/colors_names.asp), `červená/red` a `zelená/green`.
+
+V souboru `blog/static/css/blog.css` přidej následující kód:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1` je CSS selector. Toto znamená, že aplikujeme naše styly na každý element `a` uvnitř elementu `h1` , selektor `h2` dělá to samé pro elementy `h2`. Takže když máme něco jako `<h1><a href="">odkaz</a></h1>`, použije se styl `h1`. V tomto případě říkáme, že barvu elementu měníme na `#C25100`, což je oranžová. Nebo zde můžeš vložit vlastní barvu, ale ujisti se, že bude kontrastní vůči bílé barvě pozadí stránky.
+
+V CSS souboru určujeme styly pro prvky v souboru HTML. První způsob, jak identifikovat prvky je pomocí názvu elementu. Možná si vzpomeneš na tyto tagy ze sekce HTML. Věci jako `a`, `h1` a `body`jsou všechny příklady názvů elementů. Také identifikujeme elementy podle atributu `class` nebo atributu `id`. Třídy/Class a id jsou jména, které pojmenovávají samotný prvek. Třídy definují skupiny prvků a Id poukazují na konkrétní prvky. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Více si můžeš přečíst [CSS Selectoryna w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+Pak je třeba také říct naší HTML šabloně, že jsme přidali nějaké CSS. Otevři soubor `blog/templates/blog/post_list.html` a přidej tento řádek na úplný začátek:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Právě zde načítáme statické soubory. :) mezi značkami `<head>` a `</head>` , po odkazech na Bootstrap CSS soubory přidejte tento řádek:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Prohlížeč čte soubory v pořadí, ve kterém jsou zadány, takže se musíme ujistit, že jsme na správném místě. V opačném případě může být kód v našem souboru přepsán kódem z Bootstrap souborů. Právě jsi řekla naší šabloně, kde je umístěn náš soubor CSS.
+
+Soubor by měl nyní vypadat takto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, ulož soubor a aktualizuj stránky!
+
+![Obrázek 14.2](images/color2.png)
+
+Dobrá práce! Možná bychom také chtěli provzdušnit náš web a zvětšit okraj na levé straně? Pojďme to zkusit!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Přidej toto do svého CSS souboru, ulož soubor a koukni se, jak to funguje!
+
+![Obrázek 14.3](images/margin2.png)
+
+Možná můžeme také chtít přizpůsobit písmo v našem záhlaví? Vlož mezi tag `< head >` v souboru `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Stejně jako předtím, zkontroluj pořadí a místo před odkazem na `blog/static/css/blog.css`. Tento řádek importuje font s názvem *Lobster* z Google Fonts (https://www.google.com/fonts).
+
+Najdi blok `h1 deklarací` (kód mezi závorkami `{` a `}`) v CSS souboru `blog/static/css/blog.css`. Nyní přidej řádek `font-family: 'Lobster';` mezi závorkami a obnov stránku:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Obrázek 14.3](images/font.png)
+
+Skvěle!
+
+Jak bylo uvedeno výše, CSS má koncepci tříd. Ty ti umožňují pojmenovat část HTML kódu a aplikovat styly pouze na danou část, aniž by to ovlivnilo ostatní části. To může být super užitečné! Možná máš dva prvky 'div' , které dělají něco jiného (jako je hlavička a tvůj příspěvek). Třída ti může pomoci, aby element vypadal jinak.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Nyní přidáme deklaraci bloků pro jiné selektory. Selektory začínající `.` se týkají tříd. Existuje mnoho skvělých návodů a vysvětlení CSS na webu, které ti pomohou pochopit následující kód. Pro tuto chvíli stačí zkopírovat a vložit do souboru `blog/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Pak obklopující HTML kód, který zobrazuje příspěvek s deklaracemi tříd. Nahraď tímto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+v `blog/templates/blog/post_list.html` tímto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Tyto soubory ulož a aktualizuj své webové stránky.
+
+![Obrázek 14.4](images/final.png)
+
+Jupí! To je paráda, co? Podívej se na kód, který jsme právě vložili, abychom našli místa, kde jsme přidali třídy v HTML a používali je v CSS. Kde bys provedla změnu, pokud chceš, aby datum bylo tyrkysové?
+
+Neboj se trochu pohrát s tímto CSS a pokus se některé věci změnit. Hraní s CSS ti pomůže pochopit, co dělají různé věci. Pokud něco rozbiješ, nedělej si starosti - vždy to můžeš vrátit zpět!
+
+Opravdu doporučujeme vzít zdarma online kurzy "Základní HTML & HTML5" a "Základní CSS" na [freeCodeCamp](https://learn.freecodecamp.org/). Mohou ti pomoci naučit se, jak udělat tvé webové stránky hezčí pomocí HTML a CSS.
+
+Připravena na další kapitolu?! :)
\ No newline at end of file
diff --git a/cs-CZ/deploy/README.md b/cs-CZ/deploy/README.md
new file mode 100644
index 00000000000..0fcff61f8ba
--- /dev/null
+++ b/cs-CZ/deploy/README.md
@@ -0,0 +1,246 @@
+# Nasazení!
+
+> **Poznámka:** Projití následující kapitoly, může být někdy trochu těžké. Vydrž a dokonči to; nasazení je důležitou součástí procesu vývoje webových stránek. Tato kapitola je umístěna uprostřed kurzu, aby ti tvůj kouč mohl pomoci s mírně složitějším procesem nasazení tvého webu online. To znamená, že stále můžeš dokončit kurz později sama, pokud ti dojde čas.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Nasazení je proces publikování aplikace na internetu, takže lidé konečně mohou najít a vidět tvou webovou aplikaci. :)
+
+Jak jsi se dozvěděla, webové stránky musí být umístěny na serveru. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+Další externí službu, kterou budeme používa je [GitHub](https://www.github.com), což je hostingová služba pro zdrojové kódy. Na interntu existují i jiné služby, ale téměř všichni programátoři mají účet na GitHubu nyní ho budeš mít také!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Spuštění Git repositáře
+
+Git sleduje změny v sadě souborů v takzvaném úložišti kódu/repository (nebo zkráceně "repo"). Založme si jeden pro náš projekt. Otevři konzoli a v `djangogirls` adresáři spusť tyto příkazy:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. Měla by jsi být ve složce `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+     Initialized empty Git repository in ~/djangogirls/.git/ 
+    $ git config --global user.name "Your Name" 
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git bude sledovat změny souborů a složek v tomto adresáři, ale jsou tam některé soubory, které chceme ignorovat. Uděláme to tak, že vytvoříš soubor s názvem `.gitignore` v základním adresáři. Otevři editor a vytvoř nový soubor s následujícím obsahem:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Poznámka:** Tečka na začátku názvu souboru je důležitá! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+Je vhodné použít příkaz `git status` před použitím příkazu `git add` nebo vždy, když si nejste jisti, co se změnilo. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+A nakonec uložíme naše změny. Přejdi do konzole a spusť tyto příkazy:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/cs-CZ/deploy/install_git.md b/cs-CZ/deploy/install_git.md
new file mode 100644
index 00000000000..50b1f48a566
--- /dev/null
+++ b/cs-CZ/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git je "systém pro správu verzí" používaný spoustou programátorů. Tento software může sledovat změny v souborech v průběhu času tak, že konkrétní verze můžeš později znovu zobrazit. Trochu jako funkce "sledovat změny" ve slovních procesorových programech (např. Microsoft Word nebo LibreOffice spisovatel), ale mnohem silnější.
+
+## Instalace Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Git si můžeš stáhnout z [git-scm.com](https://git-scm.com/). Klikej na "další další další" ve všech krocích s vyjímkou 5. kroku s názvem "Nastavení prostředí PATH", zvol "Spustit Git a související Unixové nástroje, z příkazového řádku systému Windows" (spodní možnost). Ostatní výchozí hodnoty jsou v pořádku. Odškrtni Windows-style konce řádků, pro commit je Unixový styl konce řádků správný.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/cs-CZ/deploy/signup_pythonanywhere.md b/cs-CZ/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/cs-CZ/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/cs-CZ/django/README.md b/cs-CZ/django/README.md
new file mode 100644
index 00000000000..ae991cd6c8d
--- /dev/null
+++ b/cs-CZ/django/README.md
@@ -0,0 +1,27 @@
+# Co je Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. Webový framework je sada komponent, která pomáhá vyvíjet webové stránky rychleji a snadněji.
+
+Když vytváříš webové stránky, vždy potřebuješ podobnou sadu komponent: způsob, jak zpracovat ověření uživatele (registraci, přihlášení, odhlášení), administrační panel pro tvé webové stránky, formuláře, způsob jak nahrávat soubory, atd.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Proč potřebuješ framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Představ si poštovní schránku (port). Ta sleduje příchozí zprávy (požadavky). Podobně se chová webový server. The web server reads the letter and then sends a response with a webpage. Ale když chceš něco poslat, musíš mít nějaký obsah. A Django je něco, co ti pomůže vytvořit tento obsah.
+
+## Co se stane, když někdo požaduje webové stránky ze serveru?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Představ si pošťáka s dopisem. Kráčí po ulici a kontroluje každé číslo domu jestli odpovídá adrese na dopisu. Pokud adresa odpovídá, dopis vloží do schránky. Stejným způsobem funguje urlresolver!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Možná, že uživatel chtěl změnit něco v datech? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/cs-CZ/django_admin/README.md b/cs-CZ/django_admin/README.md
new file mode 100644
index 00000000000..099983c4ea0
--- /dev/null
+++ b/cs-CZ/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Jak vidíš, importujeme (vkládáme) Post model definovaný v předchozí kapitole. Pro zviditelnění našeho modelu na admin stránce, musíme zaregistrovat model pomocí `admin.site.register(Post)`.
+
+OK čas se podívat na náš Post model. Nezapomeň spustit `Pythonu manage.py runserver` v konzoli www serveru. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/cs-CZ/django_forms/README.md b/cs-CZ/django_forms/README.md
new file mode 100644
index 00000000000..b8570890ca5
--- /dev/null
+++ b/cs-CZ/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django formuláře
+
+Poslední věc, kterou chceme udělat na našich webových stránkách, je vytvořit příjemný způsob, jak přidávat a upravovat příspěvky na blogu. Django `admin` je super, ale je to dost těžko přizpůsobitelné a upravitelné do hezčí podoby. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+Pěkná věc na Django formulářích je, že je můžeme definovat úplně od počátku nebo vytvořit `ModelForm`, který uloží výsledek z formuláře pomocí modelu.
+
+To je přesně to, co chceme udělat: vytvoříme formulář pro náš model `Post`.
+
+Stejně jako všechny důležité části Djanga, formuláře mají své vlastní soubory: `forms.py`.
+
+Potřebujeme vytvořit soubor s tímto názvem v našem adresáři `blog`.
+
+    blog
+     └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, jak asi předpokládáš, je jméno našeho formuláře. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Dále zde máme `třídu Meta`, kde řekneme Djangu, který model by měl být použít k vytvoření tohoto formuláře (`model = Post`).
+
+Nakonec můžeme Djangu říct co se má stát s jednotlivými poli našeho formuláře. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+A je to! Vše, co musíme udělat, je použít formulář ve *view* a zobrazit ho v šabloně.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Odkaz na stránku s formulářem
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Šablona
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Potřebujeme tlačítko `Uložit`. Vytvoříme HTML tlačítko: `< button type="submit"> Uložit < / button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. Toto je velmi důležité, protože tak vytvoříme bezpečnější formulář! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Ukládání formuláře
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Ověření formuláře
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Upravit formulář
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Zabezpečení
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Ještě jedna věc: čas nasadit aplikaci!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Pak v [Bash konzoli PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/cs-CZ/django_installation/README.md b/cs-CZ/django_installation/README.md
new file mode 100644
index 00000000000..e16030a81af
--- /dev/null
+++ b/cs-CZ/django_installation/README.md
@@ -0,0 +1,7 @@
+# Instalace Django
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/cs-CZ/django_installation/instructions.md b/cs-CZ/django_installation/instructions.md
new file mode 100644
index 00000000000..e024bc9bca1
--- /dev/null
+++ b/cs-CZ/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Ochranou známku pro Django-marcador drží Markus Zapke-Gründemann et al.
+
+## Virtuální prostředí
+
+Než začneme instalovat Django, nainstalujeme si velmi užitečný nástroj, který pomůže udržet pořádek ve vývojovém prostředí na tvém počítači. Je možné tento krok přeskočit, ale je doporučován. Začít s nejlepším možným nastavením ti ušetří spoustu starostí v budoucnosti!
+
+Takže pojď vytvořit **virtuální prostředí** (tzv. *virtualenv*). Virtualenv bude izolovat nastavení Python/Django na základě projektu. To znamená, že změny provedené v jedné webové stránce neovlivní ostatní, které vyvíjíš. Elegantní, že?
+
+Vše, co musíš udělat je jít do adresáře, ve kterém chceš vytvořit `virtualenv`; Například tvůj domovský adresář. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+Pro tento kurz budeme používat nový adresář `djangogirls` vytvořený v domovském adresáři:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Vytvoříme virtualenv, s názvem `myvenv`. Obecný příkaz bude vypadat takto:
+
+{% filename %}command-line{% endfilename %}
+
+    $ Python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. Můžeš použít i jiné jméno, ale používej malá písmena a nepoužívej mezery, diakritiku nebo speciální znaky. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ Python3 -m venv myvenv
+    
+
+`myvenv` je název `virtualenv`. Můžeš použít i jiné jméno, ale drž se těchto pravidel - používej v názvech malá písmena a bez mezer. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Chceš-li se tomuto vyhnout, použij tento příkaz `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Práce s virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Spusť virtuální prostředí:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/cs-CZ/django_models/README.md b/cs-CZ/django_models/README.md
new file mode 100644
index 00000000000..835c360b5ce
--- /dev/null
+++ b/cs-CZ/django_models/README.md
@@ -0,0 +1,201 @@
+# Django modely
+
+Nyní chceme vytvořit něco, co bude ukládat všechny příspěvky na našem blogu. Ale aby jsme to mohli udělat, musíme si nejdříve říct něco o `objektech`.
+
+## Objekty
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+Co tedy je objekt? Je to kolekce vlastností a činností. Zní to divně, ale dáme ti příklad.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+Základní představa je popsat skutečné věci v kódu vlastnostmi (nazývané `vlastnosti objektu/object properties`) a akcemi (nazývané `metody/methods`).
+
+Jak tedy bude vypadat model blogu? Chceme vytvořit blog, ne?
+
+Musíme odpovědět na otázku: Co je blog post/příspěvek? Jaké by měl mít vlastnosti?
+
+Určitě budeme v naše blogu potřebovat nějaký text s jeho obsahem a titulkem, že? It would be also nice to know who wrote it – so we need an author. Nakonec také chceme vědět, kdy byl příspěvek vytvořen a publikován.
+
+    Post 
+    -------- 
+    title 
+    text 
+    author 
+    created_date 
+    published_date
+    
+
+Jaký druh věcí můžeme s příspěvkem dělat? Bylo by hezké mít nějakou `metodu`, která publikuje příspěvek, že ano?
+
+Takže budeme potřebovat metodu `publish`.
+
+Vzhledem k tomu, že už víme, co chceme dosáhnout, můžeme začít modelování v Django!
+
+## Django model
+
+Nyní víme jaký objekt chceme vytvořit, tak můžeme přistoupit k tvorbě Django modelu pro náš příspěvek v blogu.
+
+A model in Django is a special kind of object – it is saved in the `database`. Databáze je soubor dat. Je to místo, ve kterém budeš ukládat informace o uživatelích a tvých příspěvcích v blogu, atd. Budeme používat SQLite databázi k ukládání dat. This is the default Django database adapter – it'll be enough for us right now.
+
+Model v databázi si lze představit jako tabulku s řádky (data) a sloupci (údaje).
+
+### Vytvoření aplikace
+
+Abychom udrželi pořádek, vytvoříme si samostatnou aplikaci uvnitř našeho projektu. Je velmi příjemné mít všechno zorganizované od samého začátku. Chceš-li vytvořit novou aplikaci, je třeba spustit následující příkaz v konzoli (z `djangogirls` adresáře, kde je `manage.py` soubor):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Vytvoření modelu pro blog post
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. Tato konvence se v Pythonu používá často. Někdy je také nazýváme "dunder" (zktratka pro "Double-UNDERscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` je speciální klíčové slovo, které říká, že definujeme objekt.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models. Model` znamená, že Post je Django Model, takže Django ví, že by to mělo být uloženo v databázi.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Vytvoření tabulek pro modely v databázi
+
+The last step here is to add our new model to our database. Nejprve musíme dát Djangu vědět, že máme nějaké změny v modelu (které jsme právě vytvořili). (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/cs-CZ/django_orm/README.md b/cs-CZ/django_orm/README.md
new file mode 100644
index 00000000000..2104d6e5fe1
--- /dev/null
+++ b/cs-CZ/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM a QuerySets
+
+V této kapitole se naučíš jak se Django spojuje s databází a jak do ní ukládá data. Pojďme na to!
+
+## Co je QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+Je snazší naučit se to na příkladu. Pojďme to zkusit, můžeme?
+
+## Django shell
+
+Otevři svou lokání konzoli (ne na Python Anywhere) a napiš tento příkaz:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Mělo by to mít takovýto efekt:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### Všechny objekty
+
+Pojďme zkusit zobrazit všechny naše příspěvky. To můžeš udělat následujícím příkazem:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Vytvoř objekt
+
+Takhle vytvoříš nový Post objekt v databázi:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=ja, title='titulek', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Nejdříve pojďme importovat User model:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Jaké uživatele máme v naší databázi? Zkus tohle:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Teď můžeme konečně vytvořit příspěvek:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurá! Chceš se podívat jestli to fungovalo?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+A je to tu, další příspěvek v seznamu!
+
+### Přidej více příspěvků
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filtrování objektů
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. V `Post.objects.all()` použijeme `filter` místo `all`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Teď náš kus kódu vypadá takhle:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Poznámka** Mezi `title` a `contains` jsou dvě podtržítka (`_`). Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+A ten publikujeme pomocí naší metody `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Řazení objektů
+
+QuerySety ti také umožňují seřadit seznam objektů. Pojďme je zkusit seřadit podle data vytvoření (`created_date`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Můžeme je také seřadit obráceně přidáním `-` na začátek:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Je to mocný nástroj který ti umožňuje psát docela komplexní query.
+
+Cool! Teď jsi připravená na další část! Pro zavření shell konzoli zadej toto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/cs-CZ/django_start_project/README.md b/cs-CZ/django_start_project/README.md
new file mode 100644
index 00000000000..cc4936f3775
--- /dev/null
+++ b/cs-CZ/django_start_project/README.md
@@ -0,0 +1,259 @@
+# Tvůj první Django projekt!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Ochranou známku pro Django-marcador drží Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+Prvním krokem je začít s novým projektem Django. V podstatě to znamená, že budeš spouštět některé skripty z Django, které vytvoří kostru Django projektu pro tebe. To je jen halda adresářů a souborů, které budeme později používat.
+
+Názvy některých souborů a adresářů jsou pro Django velmi důležité. Neměla by jsi přejmenovávat soubory, které vytvoříme. Přesouvat je na jiné místo také není dobrý nápad. V Django je třeba zachovat určitou strukturu, aby jsme mohli najít důležité věci.
+
+> Nezapomeň spouštět vše ve svém virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. Jak se to dělá jsme vysvětlili v kapitole **Django instalace** v části **práce s virtualenv**. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Tečka `.` je zásadní, protože říká že skript pro instalaci Django se má provést v aktuálním adresáři (pro který je tečka `.` zkratkou - odkazem).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Tečka `.` je zásadní, protože říká že skript pro instalaci Django se má provést v aktuálním adresáři (pro který je tečka `.` zkratkou - odkazem).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` je skript, který za tebe vytvoří adresáře a soubory. Nyní bys měla mít adresářovou strukturu, která vypadá následovně:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+Soubor `settings.py` obsahuje konfiguraci tvé webové stránky.
+
+Pamatuješ, jak jsme mluvili o pošťákovi který zjišťuje kam doručit dopis? Soubor `urls.py` obsahuje seznam vzorů, které používá `urlresolver`.
+
+Prozatím budeme ignorovat ostatní soubory - nechceme v nich nic měnit. Jediná věc, kterou nezapomeň, žádný ze souborů se nemaže!
+
+## Změna nastavení
+
+Pojďme udělat nějaké změny v `mysite/settings.py`. Otevři soubor pomocí editoru kódu, který jsi si nainstalovala dříve.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+Bylo by hezké mít správný čas na našich stránkách. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+Existuje mnoho různých databázových softwarů, které mohou ukládat data pro tvůj web. My budeme používat výchozí `sqlite3`.
+
+Ta je již nastavena v konfiguračním souboru `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Chceš-li vytvořit databázi pro náš blog, spusť následující příkaz v konzoli: `python manage.py migrate` (pro spuštění musíš být v adresáři `djangogirls`, který obsahuje soubor `manage.py`). Pokud vše půjde dobře, měla bys vidět něco takového:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE   Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+       Applying contenttypes.0002_remove_content_type_name... OK
+       Applying auth.0002_alter_permission_name_max_length... OK
+       Applying auth.0003_alter_user_email_max_length... OK
+       Applying auth.0004_alter_user_username_opts... OK
+       Applying auth.0005_alter_user_last_login_null... OK
+       Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+A máme hotovo! Čas spustit webový server a měla by jsi vidět naše fungující webové stránky!
+
+## Starting the web server
+
+Pro spuštění musíš být v adresáři, který obsahuje soubor `manage.py` (adresář `djangogirls`). V konzoli spustíš webový server zadáním `pythonu manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/cs-CZ/django_templates/README.md b/cs-CZ/django_templates/README.md
new file mode 100644
index 00000000000..ee5edfa740e
--- /dev/null
+++ b/cs-CZ/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django šablony
+
+Je čas zobrazit nějaká data! Django nám k tomuto účelu poskytuje užitečné, vestavěné **šablonové tagy**.
+
+## Co jsou šablonové tagy?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Zobraz šablonu se seznamem příspěvků
+
+V předchozí kapitole jsme dali naší šabloně seznam příspěvků v proměnné `posts`. Teď to zobrazíme v HTML.
+
+V Django šabloně se proměnná vypíše pomocí dvojitých složených závorek s názvem proměnné uvnitř. Takhle:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Zkus to ve své šabloně `blog/templates/blog/post_list.html`. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Ulož soubor a obnov stránku, abys viděla výsledek:
+
+![Figure 13.1](images/step1.png)
+
+Jak vidíš, dostali jsme toto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+To znamená, že to Django chápe jako seznam objektů. Vzpomínáš si z kapitoly **Úvod do pythonu**, jak můžeme zobrazit seznam? Ano, pomocí for smyček! V Django šabloně je použiješ takto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Zkus udělat tohle ve své šabloně.
+
+![Figure 13.2](images/step2.png)
+
+Funguje to! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. Můžeš smíchat HTML tagy se šablonovými. Naše `body` bude vypadat takhle:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Všechno co dáš mezi `{% for %}` a `{% endfor %}` se zopakuje pro každý objekt v seznamu. Obnov svou stránku:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? Přistupujeme k datům v každém poli defnovaném v našem `Post` modelu. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## Ještě jedna věc
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Pak se přihlaš do [PythonAnywhere](https://www.pythonanywhere.com/consoles/) s jdi do **Bash konzole** (nebo vytvoř novou) a zadej:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/cs-CZ/django_urls/README.md b/cs-CZ/django_urls/README.md
new file mode 100644
index 00000000000..012bb932275
--- /dev/null
+++ b/cs-CZ/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## Co je adresa URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` je adresa URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Každá stránka na internetu potřebuje svou vlastní URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## Jak fungují URL v Djangu?
+
+Pojďme otevřít `mysite/urls.py` soubor v tvém zvoleném editoru kódu a uvidíme, jak vypadá:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/cs-CZ/django_views/README.md b/cs-CZ/django_views/README.md
new file mode 100644
index 00000000000..39cab33e993
--- /dev/null
+++ b/cs-CZ/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Nejdříve se musíme zbavit chyb, které jsme vytvořili v předchozí kapitole! :)
+
+*View* je místo, kam píšeme "logiku" naší aplikace. Bude požadovat informace z `modelu` který jsi vytvořila dříve a předá je `šabloně`. Šablonu vytvoříme v příští kapitole. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+View se dávají do souboru `views.py`. My si teď přidáme naše vlastní *view* do souboru `blog/views.py`.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Další chyba! Přečti si, co je špatně nyní:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/cs-CZ/dynamic_data_in_templates/README.md b/cs-CZ/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..9e1b2f6ee94
--- /dev/null
+++ b/cs-CZ/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamická data v šablonách
+
+Máme různé části na svém místě: `Post` model je definován v `models.py`, `post_list` máme v `views.py` a máme přidanou šablonu. Ale jak skutečně přinutíme naše příspěvky objevit se v naší HTML šabloně? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+To je přesně to, co *views* mají dělat: spojovat modely a šablony. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Vzpomínáš si, jak jsme mluvili o zahrnování kódu napsaného v různých souborech? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Potom importujeme název modelu (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Vezmi, prosím, na vědomí, že jsme vytvořili *proměnnou* pro QuerySet: `posts`. Považuj to za název našeho QuerySetu. Od teď k němu budeme referovat tímto názvem.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. Potřebujeme je pojmenovat (teď zůstaneme u `'posts'`). :) Mělo by to vypadat takhle: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+A nakonec by náš `blog/views.py` soubor měl vypadat takhle:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+A je to! Čas jít zpět do šablony a zobrazit tento QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/cs-CZ/extend_your_application/README.md b/cs-CZ/extend_your_application/README.md
new file mode 100644
index 00000000000..9d14b557357
--- /dev/null
+++ b/cs-CZ/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Rozšíření tvé aplikace
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Vytvoření šablony odkazu na post detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Vytváříme adresu URL na detail příspěvku
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Přidání view pro detail příspěvku
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+     post = get_object_or_404(Post, pk=pk)
+     return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/cs-CZ/how_the_internet_works/README.md b/cs-CZ/how_the_internet_works/README.md
new file mode 100644
index 00000000000..14d703d6b28
--- /dev/null
+++ b/cs-CZ/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Jak funguje internet
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Webové prohlížeče jsou navrženy tak, aby tomuto kódu rozuměly, následovaly instrukce a prezentovaly soubory, ze kterých je tvá stránka vytvořena, přesně tak jak chceš.
+
+Jako s každým souborem, potřebujeme HTML soubory ukládat někam na hard disk. Pro internet používáme speciální, mocné počítače nazývané *servery*. Nemají obrazovku, myš ani klávesnici, protože jejich hlavním účelem je skladovat data a servírovat je. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+Nakreslili jsme pro tebe obrázek! Vypadá takhle:
+
+![Figure 1.1](images/internet_1.png)
+
+Vypadá to jako pěkný bordel, že? In fact it is a network of connected machines (the above-mentioned *servers*). Stovek tisíc strojů! Mnoho, mnoho kilometrů kabelů kolem celého světa! Můžeš navštívit stránku mapování podmořských kabelů (http://submarinecablemap.com/) abys viděla jak komplikovaná tato síť je. Tady je screenshot z té stránky:
+
+![Figure 1.2](images/internet_3.png)
+
+Není to fascinující? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+Vypadá to takhle:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Tvůj dopis se pošle na tobě nejbližší poštu. Potom se pošle na jinou poštu, která je trochu blíže tvému adresátovi, potom na další a další, až se doručí do cílové destinace. Jediná unikátní věc je, že když pošleš hodně dopisů (*data paketů*) na stejné místo, můžou se tam dostat přes naprosto jiné pošty (*routery*). To závisí na tom, jak jsou na každé poště distribuovány.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Místo adres s názvem ulice, města a poštovním kódem používáme IP adresy. Tvůj počítač nejprve požádá DNS server (Domain Name System) o překlad djangogirls.org do IP adresy. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Také používáš jazyk kterému adresát rozumí, že ano? Stejné platí o *data paketech* které posíláš abys viděla webovou stránku. My používáme protokol zvaný HTTP (Hypertext Transfer Protocol).
+
+Takže když máš webovou stránku, potřebuješ *server* (stroj) na kterém může žít. Když *server* přijme přicházející *požadavek/request* (v dopise), pošle zpátky tvoji webovou stránku (v dalším dopise).
+
+Since this is a Django tutorial, you might ask what Django does. Když odesíláš odpověď, ne vždy chceš, aby se všem odeslala stejná věc. Je mnohem lepší, když jsou tvé dopisy personalizované, obzvláště pro osobu, která ti právě napsala, že? Django ti pomáhá s vytvářením těchto personalizovaných, zajímavých dopisů. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/cs-CZ/html/README.md b/cs-CZ/html/README.md
new file mode 100644
index 00000000000..e87a7908033
--- /dev/null
+++ b/cs-CZ/html/README.md
@@ -0,0 +1,227 @@
+# Úvod do HTML
+
+Co je to šablona, se ami ptáš?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## Co je HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML je zkratka od "HyperText Markup Language". **HyperText** znamená, že je to typ textu, který podporuje hypertextové odkazy mezi stránkami. **Markup** znamená, že jsme vzali dokument a označili ho kódem, abychom něčemu (v tomto případě prohlížeči) řekli, jak interpretovat stránku. HTML kód se vytváží pomocí **tagů**. Každý začíná znakem `<` a končí znakem `>`. Tyto tagy representují **elementy** značkovacího jazyka (Markup.
+
+## Tvá první šablona!
+
+Vytvoření šablony znamená vytvoření souboru šablony. Všechno je soubor, dobře? Toho sis už asi všimla.
+
+Šablony jsou uloženy v adresáři `blog/templates/blog`. Takže nejdříve vytvoř adresář `templates` uvnitř tvé blog složky. Potom vytvoř další složku nazvanou `blog` uvnitř templates složky:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+A teď vytvoř soubor `post_list.html` (pro teď ho nech prázdný) uvnitř adresáře `blog/templates/blog`.
+
+Podívej se jak tvá stránka vypadá teď: http://127.0.0.1:8000/
+
+> Pokud se ti stále zobrazuje chyba`TemplateDoesNotExists`, zkus restartovat server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Každá HTML stránka je také rozdělena na dva elementy: **head** (hlavu) a **body** (tělo.
+
+* **head** je element, který obsahuje informace o dokumentu, které se nezobrazují na webu.
+
+* **body** je element který obsahuje vše ostatní, co se zobrazuje jakou součást webové stránky.
+
+`<head>` používáme abychom prohlížeči sdělili konfiguraci stránky, `<body>` abychom sdělili co na té stránce skutečně je.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Ulož soubor a načti znovu svou stránku.
+
+![Figure 11.3](images/step4.png)
+
+Všimla sis, že prohlížeč už ví, že "Ola's blog" je titulek stránky? Interpretoval `<title>Ola's blog</title>` a umístil text jako název záložky.
+
+Pravděpodobně jsi si také všimla, že každý otevírací tag je doplněn *zavíracím tagem* se znakem `/`, a že elementy jsou *vnořené* (tzn. že nemůžeš zavřít daný tag dokud nejsou zavřeny všechny tagy uvnitř).
+
+Je to jako dávat věci do krabic. Máš jednu velkou krabici, `<html></html>`; uvnitř je `<body></body>`, A ta obsahuje další, menší krabice: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Přizpůsob si šablonu
+
+Teď si můžeš užít trochu zábavy a pokusit se přizpůsobit si svou šablonu! Tady je pár užitečných tagů:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>Pod-nadpis</h2>` pro nadpis na nižší úrovni
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` zvýrazňuje tvůj text
+* `<strong>text</strong>` hodně zvýrazňuje tvůj text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` vytváří odkaz
+* `<ul><li>První položka seznamu</li><li>second item</li></ul>` vytváří seznam, zrovna jako tento!
+* `<div></div>` definuje sekce stránky
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+To nám dá následující efekt:
+
+![Figure 11.4](images/step6.png)
+
+Jupííí! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## Ještě jedna věc: nasaďme to!
+
+Bylo by fajn vidět všecho tohle venku a živé na internetu, že jo? Pojďme udělat další PythonAnywhere nasazení (deploy):
+
+### Commit, and push your code up to GitHub
+
+Nejdříve se podívejme které soubory se změnily od posledního nasazení (deploy). Zadej tyto příkazy lokálně (ne na PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Než nahrajeme všechny soubory, zkontrolujme co bude `git` nahrávat (všechny soubory, které bude `git` nahrávat, se zobrazí zeleně):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Jsme skoro u konce, teď je čas uložit změny do historie. Vytvoříme "commit zprávu" kde popíšeme co jsme změnili. Můžeš napsat cokoli tě napadne, ale je užitečné napsat něco popisného, aby sis v budoucnosti mohla vzpomenout cos udělala.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Změněn HTML kód stránek."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Stáhni svůj nový kód na PythonAnywhere a načti webovou aplikaci
+
+* Otevři [stránku s konzolí na PythonAnywhere](https://www.pythonanywhere.com/consoles/) a jdi do své **Bash konzole** (nebo začni novou). Potom zadej:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/cs-CZ/installation/README.md b/cs-CZ/installation/README.md
new file mode 100644
index 00000000000..0cee7612e07
--- /dev/null
+++ b/cs-CZ/installation/README.md
@@ -0,0 +1,68 @@
+# Pokud děláš tutoriál doma
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/cs-CZ/intro_to_command_line/README.md b/cs-CZ/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b5de37b6941
--- /dev/null
+++ b/cs-CZ/intro_to_command_line/README.md
@@ -0,0 +1,440 @@
+# Úvod k příkazové řádce
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Dovol nám, abychom ti představili tvého prvního nového přítele: příkazovou řádku! **
+
+Následující kroky ti ukážou, jak používat černé okno, které všichni počítačoví odborníci používají. Může to na první pohled vypadat trochu děsivě, ale opravdu je to jen okno, které čeká na tvé příkazy.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## Co je příkazová řádka?
+
+Okno, které se obvykle nazývá **příkazová řádka** nebo **rozhraní příkazové řádky**, je textová aplikace pro zobrazování, zpracovávání a manipulaci se soubory na tvém počítači. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Další jména pro příkazovou řádku jsou: *cmd*, *prompt*, *command line*, *konzole* nebo *terminál*.
+
+## Otevři rozhraní příkazové řádky
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Příkazová řádka
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Tvůj první příkaz (hurá!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami 
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Základy
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Aktuální složka
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd 
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls 
+    Aplikace 
+    Desktop 
+    Stažené soubory
+    Hudba...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Řešení:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Shrnutí
+
+Here is a summary of some useful commands:
+
+| Příkaz (Windows)        | Příkaz (Mac OS / Linux) | Popis                      | Příklad                                            |
+| ----------------------- | ----------------------- | -------------------------- | -------------------------------------------------- |
+| zavření příkazové řádky | zavření příkazové řádky | Zavřít okno                | **zavření příkazové řádky**                        |
+| cd                      | cd                      | změnit adresář             | **cd test**                                        |
+| cd                      | pwd                     | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir                     | ls                      | seznam adresářů/souborů    | **dir**                                            |
+| copy                    | cp                      | kopírovat soubor           | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move                    | mv                      | přesunout soubor           | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir                   | mkdir                   | vytvořit nový adresář      | **mkdir testdirectory**                            |
+| rmdir (or del)          | rm                      | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S                | rm -r                   | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?                | man [CMD]               | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Připraveno?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/cs-CZ/intro_to_command_line/open_instructions.md b/cs-CZ/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/cs-CZ/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/cs-CZ/python_installation/README.md b/cs-CZ/python_installation/README.md
new file mode 100644
index 00000000000..84715c1173f
--- /dev/null
+++ b/cs-CZ/python_installation/README.md
@@ -0,0 +1,15 @@
+# Začněme s Pythonem
+
+Konečně jsme u něj!
+
+Nejdříve si pojďme říci co Python je. Python je velmi populární programovací jazyk, který lze použít k vytváření webových stránek, her, vědeckého software, grafického software a mnoho, mnoho dalšího.
+
+Python vznikl na konci 80. let a jeho hlavním cílem je být čitelný lidským bytostem (nejen strojům!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Instalace Pythonu
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/cs-CZ/python_installation/instructions.md b/cs-CZ/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/cs-CZ/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/cs-CZ/python_introduction/README.md b/cs-CZ/python_introduction/README.md
new file mode 100644
index 00000000000..6ac95a12d78
--- /dev/null
+++ b/cs-CZ/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Úvod do Pythonu
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Interaktivní režim Pythonu
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Tvůj první příkaz v Pythonu!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3 
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Řetězce
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" 
+"Ola"
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ahoj" + "Ola" 
+'Ahoj Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3 
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill" 
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill' 
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper() 
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola") 
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Shrnutí
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Chyby
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023) 
+Traceback (most recent call last):   
+File "<stdin>", 
+line 1, in <module> 
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023)) 
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- Funkce `str`převede věci do **řetězců**
+- Funkce `int` převede věci na **celá čísla**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Proměnné
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name 
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name 
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name) 
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4 
+>>> b = 6 
+>>> a * b 
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo" 
+>>> ctiy 
+Traceback (most recent call last):   File "<stdin>", line 1, in <module> 
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Hraj si s tím chvilku, ať vidíš co se s tím dá dělat!
+
+## Funkce print
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria' 
+>>> name 
+'Maria' 
+>>> print(name) 
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Seznamy
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> [] 
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery) 
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery) 
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse() 
+>>> print(lottery) 
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0]) 
+59 
+>>> print(lottery[1]) 
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Slovníky
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {} 
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- Klíč `name` odkazuje na hodnotu `"Ola"` (`string/řetězcový` objekt),
+- Klíč`country`, ukazuje na `"Polsko"` (další `řetězec`),
+- a `favorite_numbers` ukazuje `[7, 42, 92]` (`list/seznam` obsahující 3 čísla).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name']) 
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age'] 
+Traceback (most recent call last):  
+File "<stdin>", line 1, in <module> 
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Potřebuješ jen seřazenou sekvenci položek? Použij seznam.
+- Pokud potřebuješ přiřadit hodnotám klíče, aby jsi je mohla později efektivně vyhledávat (klíčem)? Používej slovník.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant) 
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Shrnutí
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Porovnávání věcí
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2 
+True 
+>>> 3 <= 2 
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y znamená: x je větší než y
+- x `<` y znamená: x je menší než y
+- x `<=` y znamená: x je menší nebo rovno y
+- x `>=` y znamená: x je větší nebo rovno y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3 
+True 
+>>> 3 > 2 and 2 < 1 
+False 
+>>> 3 > 2 or 2 < 1 
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Logic hodnoty/Booleany
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True 
+>>> a 
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5 
+>>> a 
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Ulož to!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Ukončit interaktivní režim Pythonu
+- Otevřít tvůj zvolený editor kódu
+- Ulož nějaký kód do nového pythnovského souboru
+- Spusť ho!
+
+Chceš-li opustit interaktivní režim Pythonu, který jsme dosud používali jednoduše zadej funkci `exit()`
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. To se nazývá "zvýrazňování syntaxe" a je to opravdu užitečná funkce při kódování. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). To je jeden z důvodů, proč používáme editory kódu. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    File "python_intro.py", line 2
+              ^ 
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py 
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### Co když podmínka není pravdivá?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+Pokud je výraz pravdivý po spuštění se vytiskne:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+     dokonalé, můžete slyšet všechny detaily
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Shrnutí
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Vlastní funkce!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hi there! 
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Traceback (most recent call last): 
+    File "python_intro.py", line 10, in <module>
+       hi() 
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Smyčky/Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+Příkaz `for` se chová podobně jako příkaz `if ` v následujícím kódu musíme oba řádky odsadit o čtyři mezery.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hi Rachel! 
+    Next girl 
+    Hi Monica! 
+    Next girl 
+    Hi Phoebe! 
+    Next girl 
+    Hi Ola! 
+    Next girl 
+    Hi You! 
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+     print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1 
+    2
+    3 
+    4 
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Shrnutí
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/cs-CZ/template_extending/README.md b/cs-CZ/template_extending/README.md
new file mode 100644
index 00000000000..2d933811652
--- /dev/null
+++ b/cs-CZ/template_extending/README.md
@@ -0,0 +1,151 @@
+# Rozšiřování šablon
+
+Další pěknou věcí, kterou pro nás Django má je **rozšiřování šablon**. Co to znamená? To znamená, že můžeš použít stejné HTML pro různé stránky na svém blogu.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+Základní šablona je šablona, kterou rozšíříme na každé stránce našich webových stránek.
+
+Vytvoříme soubor `base.html` v `blog/templates/blog/`:
+
+    blog 
+    └───templates
+         └───blog
+                 base.html
+                 post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Pak v `base.html`, nahraď celé `< body >` (vše mezi `< body >` a `< / body >`) tímto:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). Hned ti ukážeme jak to udělat.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Takto:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/cs-CZ/whats_next/README.md b/cs-CZ/whats_next/README.md
new file mode 100644
index 00000000000..319212081e2
--- /dev/null
+++ b/cs-CZ/whats_next/README.md
@@ -0,0 +1,43 @@
+# Co dál?
+
+Můžeš si pogratulovat! **Jsi naprosto úžasná**. Jsme na tebe hrdí! <3
+
+### Co mám dělat teď?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Můžete mi doporučit nějaké další zdroje?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/cs/README.md b/cs/README.md
index 5ad33b27ddd..0334d39dd10 100755
--- a/cs/README.md
+++ b/cs/README.md
@@ -1,53 +1,51 @@
 # Django Girls Tutoriál
-[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
-> Tento návod je licencován pod Creative Commons Attribution-ShareAlike 4.0 mezinárodní licencí. Chcete-li zobrazit kopii této licence, navštivte https://creativecommons.org/licenses/by-sa/4.0/
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
 
-## Úvod
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
 
-Už jsi někdy měla pocit, že svět stále více a více používá technologie a ty zůstáváš nějak pozadu? Přemýšlela jsi někdy, jak vytvořit webové stránky, ale nikdy jsi neměla dostatek motivace začít? Přemýšlela jsi někdy, že svět softwaru je pro tebe příliš složitý na to, abys zkusila něco naprogramovat sama?
+## Welcome
 
-Máme pro tebe dobrou zprávu! Programování není tak těžké, jak se zdá, a zde ti chceme ukázat, jak zábavné to může být.
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
 
-Tento návod tě magicky nepromění v programátora. Jestli chceš být dobrá programátorka, budeš potřebovat měsíce nebo dokonce roky učení a praxe. Ale chceme ti ukázat, že programování nebo tvorba webových stránek není tak složitá, jak se zdá. Budeme se snažit ti vysvětlit různé kousky a střípky tak jednoduše, jak dokážeme, aby ses necítila technologiemi zastrašena.
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
 
-Doufáme, že se nám podaří přiblížit ti tuto technologii tak, abys ji měla stejně ráda jako my!
+## Úvod
 
-## Co se naučíš během kurzu?
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Přemýšlela jsi někdy, jak vytvořit webové stránky, ale nikdy jsi neměla dostatek motivace začít? Přemýšlela jsi někdy, že svět softwaru je pro tebe příliš složitý, aby jsi zkusila něco naprogramovat sama?
 
-Po dokončení kurzu budeš mít jednoduchou, fungující webovou aplikaci: vlastní blog. Ukážeme ti, jak ho zprovoznit online tak, aby se ostatní mohli na tvoji práci podívat!
+Máme pro tebe dobrou zprávu! Programování není tak těžké jak se zdá, a zde ti chceme ukázat, jak zábavné to může být.
 
-Tvá aplikace bude (více či méně) vypadat takto:
+This tutorial will not magically turn you into a programmer. Jestli chceš být dobrý programátor, budeš potřebovat měsíce nebo dokonce roky učení a praxe. Ale chceme ti ukázat, že programování nebo tvorba webových stránek není tak složitá, jak se zdá. Budeme se snažit ti vysvětlit různé kousky a střípky, tak jednoduše jak dokážeme, aby jsi se necítila zastrašena technologií.
 
-![Figure 0.1][2]
+Doufáme, že se nám podaří ti přiblížit tuto technologii tak, aby jsi ji měla stejně ráda jako my!
 
- [2]: images/application.png
+## Co se naučíš během kurzu?
 
-> Pokud budeš procházet kurz sama bez učitele, který ti by ti pomáhal v případě, že narazíš na nějaký problém, máme pro tebe chat: [![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge). Požádali jsme kouče a předchozí účastníky kurzu, aby čas od času pomáhali ostatním s tímto kurzem. Neboj se zde zeptat na jakoukoliv otázku!
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
 
-OK, [začněme od začátku...][3]
+Tvá aplikace (více či méně) bude vypadat takto:
 
- [3]: ./how_the_internet_works/README.md
+![Figure 0.1](images/application.png)
 
-## O kurzu a přispěvatelích
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Požádali jsme kouče a předchozí účastníky kurzu, aby čas od času pomáhali ostatním s tímto kurzem! Neboj se zde zeptat na jakoukoliv otázku!
 
-Tento kurz je provozován organizací [DjangoGirls][4]. Pokud najdeš nějaké chyby, nebo chceš aktualizovat návod, prosím, [postupuj podle pokynů pro přispívající][5].
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
 
- [4]: https://djangogirls.org/
- [5]: https://github.com/DjangoGirls/tutorial/blob/master/README.md
+## Following the tutorial at home
 
-## Český překlad
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
 
-Původní DjangoGirls tutoriál přeložila do češtiny skupina dobrovolníků. Poděkování patří hlavně:
-Davidovi (dakf), Kristýně Kumpánové, Veronice Gabrielové, Tomáši Ehrlichovi,
-Aničce Jaegerové, Matějovi Stuchlíkovi, Filipovi Sivákovi a Juraji M. Bezručkovi.
+In every chapter already covered, there is a link that points to the correct video.
 
-## Chtěla bys nám pomoci přeložit návod do jiných jazyků?
+## O kurzu a přispěvatelích
 
-V současné době jsou překlady provozovány na platformě crowdin.com na adrese:
+Tento kurz je provozován [DjangoGirls](https://djangogirls.org/). Pokud najdeš nějaké chyby, nebo chceš aktualizovat návod, prosím,[postupuj podle pokynů pro přispívající](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
 
-https://crowdin.com/project/django-girls-tutorial
+## Would you like to help us translate the tutorial into other languages?
 
-Pokud tvůj jazyk není uveden v seznamu na crowdin, prosím, [založ nový požadavek][6] pro přidání dalšího jazyka.
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
 
- [6]: https://github.com/DjangoGirls/tutorial/issues/new
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/cs/SUMMARY.md b/cs/SUMMARY.md
index 44793ad9d19..e1eafb7ecaa 100755
--- a/cs/SUMMARY.md
+++ b/cs/SUMMARY.md
@@ -1,26 +1,27 @@
 # Shrnutí
 
-*   [Úvod](README.md)
-*   [Instalace](installation/README.md)
-*   [Jak funguje internet](how_the_internet_works/README.md)
-*   [Úvod do příkazové řádky](intro_to_command_line/README.md)
-*   [Instalace Pythonu](python_installation/README.md)
-*   [Editor zdrojového kódu](code_editor/README.md)
-*   [Úvod do Pythonu](python_introduction/README.md)
-*   [Co je Django?](django/README.md)
-*   [Instalace Django](django_installation/README.md)
-*   [Tvůj první Django projekt!](django_start_project/README.md)
-*   [Django modely](django_models/README.md)
-*   [Django admin](django_admin/README.md)
-*   [Nasazení!](deploy/README.md)
-*   [Django URL](django_urls/README.md)
-*   [Django views -- je čas začít tvořit!](django_views/README.md)
-*   [Úvod do HTML](html/README.md)
-*   [Django ORM (tvorba dotazů)](django_orm/README.md)
-*   [Dynamická data v šablonách](dynamic_data_in_templates/README.md)
-*   [Django šablony](django_templates/README.md)
-*   [CSS - udělejte svou aplikaci hezčí](css/README.md)
-*   [Rozšíření šablon](template_extending/README.md)
-*   [Rozšíření vaší aplikace](extend_your_application/README.md)
-*   [Django formuláře](django_forms/README.md)
-*   [Co dál?](whats_next/README.md)
+* [Úvod](README.md)
+* [Instalace](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [Jak funguje Internet](how_the_internet_works/README.md)
+* [Úvod do příkazové řádky](intro_to_command_line/README.md)
+* [Instalace Pythonu](python_installation/README.md)
+* [Editor zdrojového kódu](code_editor/README.md)
+* [Úvod do Pythonu](python_introduction/README.md)
+* [Co je Django?](django/README.md)
+* [Instalace Django](django_installation/README.md)
+* [Tvůj první Django projekt!](django_start_project/README.md)
+* [Django modely](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Nasazení!](deploy/README.md)
+* [Django URL](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Úvod do HTML](html/README.md)
+* [Django ORM (tvorba dotazů)](django_orm/README.md)
+* [Dynamická data v šablonách](dynamic_data_in_templates/README.md)
+* [Django šablony](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Rozšiřování šablon](template_extending/README.md)
+* [Rozšíření tvé aplikace](extend_your_application/README.md)
+* [Django formuláře](django_forms/README.md)
+* [Co dál?](whats_next/README.md)
\ No newline at end of file
diff --git a/cs/chromebook_setup/README.md b/cs/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/cs/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/cs/chromebook_setup/instructions.md b/cs/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/cs/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/cs/code_editor/README.md b/cs/code_editor/README.md
index f91d7968087..a84ad55e645 100755
--- a/cs/code_editor/README.md
+++ b/cs/code_editor/README.md
@@ -1,7 +1,11 @@
 # Editor zdrojového kódu
 
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
 Právě se chystáš napsat svůj první řádek kódu, takže je čas sáhnout po editoru kódu!
 
+> **Poznámka:** Pokud používš Chromebook, pak tuto kapitolu vynechej a řiď se instrukcemi v návodu [Chromebook Setup](../chromebook_setup/README.md).
+> 
 > **Poznámka** Mohla jsi to udělat už dříve v kapitole o instalaci - jestli je to tak, prostě jen tuhle kapitolu přeskoč a vrhni se na další!
 
 {% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/cs/code_editor/instructions.md b/cs/code_editor/instructions.md
index 9666843aff6..04899c17afe 100755
--- a/cs/code_editor/instructions.md
+++ b/cs/code_editor/instructions.md
@@ -10,22 +10,22 @@ Gedit je open-source editor. Je k dispozici zdarma pro všechny operační syst
 
 ## Sublime Text 3
 
-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.
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
 
 [Stáhnout si jej můžeš zde](https://www.sublimetext.com/3)
 
 ## Atom
 
-Atom je velmi nový editor kódu vytvořen [GitHub](https://github.com/)em. Je zdarma, je open-source a má snadnou instalaci a snadné použití. Je k dispozici pro Windows, OS X a Linux.
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
 
 [Stáhnout si jej můžeš zde](https://atom.io/)
 
-## Proč jsme instalovali editor kódu?
+## Proč instalujeme editor kódu?
 
 Možná přemýšlíš, proč instalujeme speciální editor kódu a proč raději nezvolíme něco jako Notepad nebo Word.
 
-První důvod je, že kód musí být **prostý text** a programy jako Word a Textedit ve skutečnosti produkují bohatý text (s fonty a formátováním), používají vlastní formáty jako [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+Prvním důvoden je, že kód musí být psán v **prostém textu** a programy jako Word a Textedit ve skutečnosti produkují bohatý text (s fonty a formátováním) a používají vlastní formáty jako [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
 
-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.
+Druhým důvodem je, že editory kódu jsou pro tuto práci uzpůsobené tak, že poskytují užitečné pomůcky jako je barevné zvýrazňování různých částí kódu podle jejich významu či automatické uzavírání uvozovek.
 
-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ů :)
\ No newline at end of file
+V akci to uvidíme později. Brzy budeš na svůj editor kódu nahlížet jako na jeden ze svých oblíbených nástrojů. :)
\ No newline at end of file
diff --git a/cs/css/README.md b/cs/css/README.md
index ab915ee6046..1f496afff78 100755
--- a/cs/css/README.md
+++ b/cs/css/README.md
@@ -1,114 +1,115 @@
-# CSS - aby byla tvoje aplikace krásná!
+# CSS – make it pretty!
 
 Náš blog nevypadá stále dost pěkně, že? Je na čase ho udělat hezčí! Použijeme na to CSS.
 
 ## Co je to CSS?
 
-CSS (neboli Cascading Style Sheets) je jazyk používaný pro popis vzhledu a formátování webové stránky. Je to značkovací jazyk (jako HTML). Ber ho jako make-up pro náš web ;).
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
 
-Nechceme ale zase začínat úplně od začátku, že? Opět použijeme něco, co již bylo vytvořeno jinými programátory a sdíleno zdarma na internetu. Vymýšlet znovu, co již před námi někdo vymyslel, to by nebyla žádná legrace.
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
 
 ## Použijme Bootstrap!
 
-Bootstrap je jedním z nejpopulárnějších HTML a CSS frameworků pro vývoj pěkné webové stránky: https://getbootstrap.com/
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
 
-Napsali ho programátoři, kteří pracovali pro Twitter, a nyní ho vyvíjí dobrovolníci z celého světa.
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
 
 ## Instalace Bootstrapu
 
-Chceš-li nainstalovat Bootstrap, je třeba přidat do `< head >` v souboru `.html` (`blog/templates/blog/post_list.html`):
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
 ```
 
-To nepřidá žádné soubory do projektu. Jen to odkazuje na soubory, které existují na internetu. Jen do toho, otevři tvůj web a aktualizuj stránku. Hurá!
-
-![Obrázek 14.1][1]
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
 
- [1]: images/bootstrap1.png
+![Obrázek 14.1](images/bootstrap1.png)
 
 Hned to vypadá lépe!
 
 ## Statické soubory v Djangu
 
-Konečně se podíváme zblízka na téma, které jsme již zmínili, **statické soubory**. Statické soubory jsou všechny naše CSS soubory a obrázky, které nejsou dynamické, takže jejich obsah není závislý na kontextu požadavku a budou pro každého uživatele stejné.
+Konečně se podíváme zblízka na téma, které jsme již zmínili, **statické soubory**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
 
 ### Kam umístit statické soubory pro Django
 
-Jak jsi viděla, když jsme spustili `collectstatic` na serveru, Django už ví, kde najít statické soubory pro vestavěnou aplikaci "admin". Teď jen musíme přidat nějaké statické soubory pro vlastní aplikaci, `blog`.
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
 
 Uděláš to tak, že vytvoříš složku s názvem `static` uvnitř aplikace blog:
 
-```
-djangogirls
-├── blog
-│   ├── migrations
-│   └── static
-└── mysite
-```    
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
 
-Django automaticky najde všechny složky s názvem "static" uvnitř vašich složek aplikací a bude moci využívat jejich obsah jako statické soubory.
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
 
 ## Tvůj první soubor CSS!
 
-Pokud chceš na webovou stránku přidat svůj vlastní styl, vytvoř css soubor. Vytvoř nový adresář s názvem `css` uvnitř adresáře `static`. Vytvoř nový soubor s názvem `blog.css` uvnitř tohoto adresáře `css`. Připraveno?
-
-```
-djangogirls
-└─── blog
-     └─── static
-          └─── css
-               └─── blog.css
-```
+Let's create a CSS file now, to add your own style to your web page. Vytvoř nový adresář s názvem `css` uvnitř adresáře `static`. Vytvoř nový soubor s názvem `blog.css` uvnitř tohoto adresáře `css`. Připraveno?
 
-Čas napsat nějaké CSS! Otevři soubor `blog/static/css/blog.css` v editoru kódu.
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
 
-Nepůjdeme příliš hluboko do tématu přizpůsobení webu a učení o CSS, protože je to docela snadné a můžeš se o tom naučit více sama po tomto workshopu. Opravdu můžeme doporučit [Codeacademy HTML & CSS kurz][2], kde se dozvíš vše, co potřebuješ vědět, aby tvoje stránky s CSS vypadaly dobře.
+Čas k napsání nějakého CSS! Otevři soubor `blog/static/css/blog.css` v editoru kódu.
 
- [2]: https://www.codecademy.com/tracks/web
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
 
-Ale pojďme něco málo udělat. Co třeba změnit barvu našeho záhlaví? Pro interpretaci barev počítače používají speciální kódy. Začínají `#` a následuje 6 písmen (A-F) a číslic (0-9). Kódy barev můžeš najít například zde: http://www.colorpicker.com/. Můžeš také použít [předdefinované barvy][3], `červená/red` a `zelená/green`.
-
- [3]: http://www.w3schools.com/cssref/css_colornames.asp
+Ale pojďme něco málo udělat. Možná bychom mohli změnit barvu našeho záhlaví? Pro interpretaci barev, počítače používají speciální kódy. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. Můžeš také použít [předdefinované barvy](http://www.w3schools.com/colors/colors_names.asp), `červená/red` a `zelená/green`.
 
 V souboru `blog/static/css/blog.css` přidej následující kód:
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 h1 a {
     color: #FCA205;
 }
-```  
+```
 
-`h1` je CSS selector. To znamená, že budeme aplikovat naše styly na jakýkoliv `a` element uvnitř `h1` (např. když máme v kódu něco jako: `< h1 ><a href = "" > odkaz < /a >< / h1 >`). V takovém případě sdělujeme, že barvu elementu měníme na `#FCA205`, což je oranžová. Samozřejmě sem můžeš vložit vlastní barvu!
+`h1` je CSS selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. V takovém případě sdělujeme, že barvu elementu měníme na `#FCA205`, což je oranžová. Samozřejmě zde můžeš vložit vlastní barvu!
 
-V CSS souboru určujeme styly pro prvky v souboru HTML. Prvky jsou identifikovány pomocí názvu prvku (tj, `a`,`h1`, `body`), atributem `class` nebo atributem `id`. Třídy/Class a id jsou jména, která pojmenovávají samotný prvek. Třídy definují skupiny prvků a id poukazují na konkrétní prvky. Například následující tag může identifikovat pomocí CSS tag `a`, třídu `external_link` nebo id `link_to_wiki_page`:
+V CSS souboru určujeme styly pro prvky v souboru HTML. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Třídy/Class a id jsou jména, které pojmenovávají samotný prvek. Třídy definují skupiny prvků a Id poukazují na konkrétní prvky. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
 
 ```html
 <a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
-```  
+```
 
-Přečti si o [CSS selektorech ve w3schools][4].
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
 
- [4]: http://www.w3schools.com/cssref/css_selectors.asp
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
 
-Pak je třeba také říct naší HTML šabloně, že jsme přidali nějaké CSS. Otevři soubor `blog/templates/blog/post_list.html` a přidej tento řádek na samý začátek:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
-```  
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
 
-Právě nahráváme statické soubory :). Pak mezi `< head >` a `< / head >` za odkazy na soubory Bootstrap CSS (prohlížeč načte soubory v pořadí, ve kterém jsou zapsány, takže kód v našem souboru může přepsat kód v Bootstrap souborech) přidejte tento řádek:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <link rel="stylesheet" href="{% static 'css/blog.css' %}">
 ```
 
-Právě jsi řekla naší šabloně, kde je umístěn náš soubor CSS.
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. Právě jsi řekla naší šabloně, kde je umístěn náš soubor CSS.
 
 Soubor by měl nyní vypadat takto:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -136,161 +137,168 @@ Soubor by měl nyní vypadat takto:
 
 OK, ulož soubor a aktualizuj stránky!
 
-![Obrázek 14.2][5]
+![Obrázek 14.2](images/color2.png)
 
- [5]: images/color2.png
+Dobrá práce! Možná bychom také chtěli provzdušnit náš web a zvětšit okraj na levé straně? Pojďme to zkusit!
 
-Dobrá práce! Co kdybychom také chtěli provzdušnit náš web a zvětšit okraj na levé straně? Pojďme to zkusit!
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 body {
     padding-left: 15px;
 }
-```  
+```
 
-Přidej toto do svého CSS souboru, ulož soubor a koukni se, jak to funguje!
+Add that to your CSS, save the file and see how it works!
 
-![Obrázek 14.3][6]
+![Obrázek 14.3](images/margin2.png)
 
- [6]: images/margin2.png
+Možná můžeme také chtít přizpůsobit písmo v našem záhlaví? Vlož mezi tag `< head >` v souboru `blog/templates/blog/post_list.html`:
 
-Možná můžeme také chtít přizpůsobit písmo v našem záhlaví. Vlož za tag `< head >` v souboru `blog/templates/blog/post_list.html`:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-<link href="https://fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
-```  
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
 
-Tento řádek bude importovat písmo s názvem *Lobster* z Google písem (https://www.google.com/fonts).
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
 
-Nyní přidej řádek `font-family: "Lobster";` do CSS souboru `blog/static/css/blog.css` uvnitř deklarace `h1` bloku (kód mezi závorkami `{` a `}`) a aktualizuj stránky:
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 h1 a {
     color: #FCA205;
     font-family: 'Lobster';
 }
-```  
-
-![Obrázek 14.3][7]
+```
 
- [7]: images/font.png
+![Obrázek 14.3](images/font.png)
 
 Skvěle!
 
-Jak jsme si řekli výše, CSS má koncept tříd, který v podstatě umožňuje pojmenovat části kódu HTML a styly aplikovat pouze na tyto části bez ovlivnění ostatních částí. Je to zvlášť užitečné, pokud máš dva div tagy, ale každý dělá něco jiného (jako záhlaví a příspěvek), takže nechceš, aby vypadaly stejně.
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
 
 Pokračuj a pojmenuj některé části kódu HTML. Přidáš třídu s názvem `page-header` do tvého `div` tagu, který obsahuje záhlaví, jako je tento:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="page-header">
-     <h1><a href="/">Django Girls Blog</a></h1>
+    <h1><a href="/">Django Girls Blog</a></h1>
 </div>
 ```
 
-A nyní přidej třídu `post` do svého `div` obsahující blog post.
+A nyní přidej třídu, `post` do svého `div` obsahující blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <div class="post">
-     <p>published: {{ post.published_date }}</p>
-     <h1><a href="">{{ post.title }}</a></h1>
-     <p>{{ post.text|linebreaksbr }}</p>
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
 </div>
-```    
+```
+
+Nyní přidáme deklaraci bloků pro jiné selektory. Selektory začínající `.` se týkají tříd. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. Pro tuto chvíli stačí zkopírovat a vložit do souboru `blog/static/css/blog.css`:
 
-Nyní přidáme deklaraci bloků pro jiné selektory. Selektory začínající `.` se týkají tříd. Existuje mnoho skvělých návodů a vysvětlení CSS na webu, které ti pomohou pochopit následující kód. Pro tuto chvíli stačí zkopírovat a vložit do souboru `blog/static/css/blog.css`:
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 .page-header {
-     background-color: #ff9400;
-     margin-top: 0;
-     padding: 20px 20px 20px 40px;
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
 }
 
 .page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
-     color: #ffffff;
-     font-size: 36pt;
-     text-decoration: none;
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
 }
 
 .content {
-     margin-left: 40px;
+    margin-left: 40px;
 }
 
 h1, h2, h3, h4 {
-     font-family: 'Lobster', cursive;
+    font-family: 'Lobster', cursive;
 }
 
- .date {
-     float: right;
-     color: #828282;
+.date {
+    color: #828282;
 }
 
 .save {
-     float: right;
+    float: right;
 }
 
- .post-form textarea, .post-form input {
-     width: 100%;
+.post-form textarea, .post-form input {
+    width: 100%;
 }
 
- .top-menu, .top-menu:hover, .top-menu:visited {
-     color: #ffffff;
-     float: right;
-     font-size: 26pt;
-     margin-right: 20px;
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
 }
 
- .post {
-     margin-bottom: 70px;
+.post {
+    margin-bottom: 70px;
 }
 
- .post h1 a, .post h1 a:visited {
-     color: #000000;
+.post h1 a, .post h1 a:visited {
+    color: #000000;
 }
-```  
+```
+
+Pak obklopující HTML kód, který zobrazuje příspěvek s deklaracemi tříd. Nahraď tímto:
 
-Pak obklopující HTML kód, který zobrazuje příspěvek s deklaracemi tříd, nahraď tímto:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
-     <div class="post">
-         <p>published: {{ post.published_date }}</p>
-         <h1><a href="">{{ post.title }}</a></h1>
-         <p>{{ post.text|linebreaksbr }}</p>
-     </div>
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endfor %}
-```    
+```
 
 v `blog/templates/blog/post_list.html` tímto:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="content container">
-     <div class="row">
-         <div class="col-md-8">
-             {% for post in posts %}
-                 <div class="post">
-                     <div class="date">
-                         {{ post.published_date }}
-                     </div>
-                     <h1><a href="">{{ post.title }}</a></h1>
-                     <p>{{ post.text|linebreaksbr }}</p>
-                 </div>
-             {% endfor %}
-         </div>
-     </div>
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
 </div>
-```    
+```
 
 Tyto soubory ulož a aktualizuj své webové stránky.
 
-![Obrázek 14.4][8]
-
- [8]: images/final.png
+![Obrázek 14.4](images/final.png)
 
-Woohoo! Vypadá to super, ne? Kód, který jsme vložili, opravdu není tak těžké pochopit. Měla bys být schopna pochopit většinu z něj jen jeho čtením.
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
 
-Neobávej se trochu poupravit CSS a pokusit se změnit některé věci. Když něco rozbiješ, můžeš to vždy vrátit zpět!
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
 
-Mimochodem opravdu doporučujeme tento bezplatný online [Codeacademy HTML & CSS kurz][2] jako post-workshop úkol, naučíš se vše, co potřebuješ vědět, aby tvoje stránky byly díky CSS hezčí.
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
 
-Připravena na další kapitolu?! :)
+Připravena na další kapitolu?! :)
\ No newline at end of file
diff --git a/cs/deploy/README.md b/cs/deploy/README.md
index 380ebd21346..ac34738941f 100755
--- a/cs/deploy/README.md
+++ b/cs/deploy/README.md
@@ -1,317 +1,259 @@
 # Nasazení!
 
-> **Poznámka:** Projít následující kapitolu může být někdy trochu těžké. Vydrž a dokonči to; nasazení je důležitou součástí procesu vývoje webových stránek. Tato kapitola je umístěna uprostřed kurzu, aby ti tvůj kouč mohl pomoci s mírně složitějším procesem nasazení tvého webu online. To znamená, že stále můžeš dokončit kurz později sama, pokud to nestihneš teď.
+> **Poznámka:** Projití následující kapitoly, může být někdy trochu těžké. Vydrž a dokonči to; nasazení je důležitou součástí procesu vývoje webových stránek. Tato kapitola je umístěna uprostřed kurzu, aby ti tvůj kouč mohl pomoci s mírně složitějším procesem nasazení tvého webu online. To znamená, že stále můžeš dokončit kurz později sama, pokud ti dojde čas.
 
-Až dosud byly tvoje webové stránky k dispozici pouze ve tvém počítači, nyní se naučíš je nasadit! Nasazení je proces publikování aplikace na internetu, takže si lidé konečně mohou prohlédnout tvou webovou aplikaci :).
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Nasazení je proces publikování aplikace na internetu, takže lidé konečně mohou najít a vidět tvou webovou aplikaci. :)
 
-Jak jsi se dozvěděla, webové stránky musí být umístěny na serveru. Na internetu existuje mnoho poskytovatelů serverů. My budeme používat jednoho, který má relativně jednoduchý proces nasazení: [PythonAnywhere][1]. PythonAnywhere je zdarma pro malé aplikace, které nemají příliš mnoho návštěvníků, takže to pro tebe bude teď stačit.
+Jak jsi se dozvěděla, webové stránky musí být umístěny na serveru. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
- [1]: https://pythonanywhere.com/
+Další externí službu, kterou budeme používa je [GitHub](https://www.github.com), což je hostingová služba pro zdrojové kódy. Na interntu existují i jiné služby, ale téměř všichni programátoři mají účet na GitHubu nyní ho budeš mít také!
 
-Další externí službu, kterou budeme používat, je [GitHub][2], což je hostingová služba pro zdrojové kódy. Na internetu existují i jiné služby, ale téměř všichni programátoři mají účet na GitHubu. Nyní ho budeš mít také!
-
- [2]: https://www.github.com
-
-Budeme používat GitHub jako odrazový můstek k přesunu našeho kódu do a z PythonAnywhere.
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
 
 # Git
 
-Git je "systém pro správu verzí" používaný spoustou programátorů. Tento software může sledovat změny v souborech v průběhu času tak, že konkrétní verze můžeš později znovu zobrazit. Trochu jako funkce "sledování změn" v aplikaci Microsoft Word, ale mnohem mocnější.
-
-## Instalace Git
-
-> **Poznámka:** Pokud jsi již prošla instalační kroky, není třeba se k tomu vracet - můžeš přeskočit k další části a začít vytvářet Git repozitář.
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
 
 {% include "/deploy/install_git.md" %}
 
 ## Spuštění Git repositáře
 
-Git sleduje změny v sadě souborů v takzvaném úložišti kódu/repository (nebo zkráceně "repo"). Založme si jedno repo pro náš projekt. Otevři konzoli a v `djangogirls` adresáři spusť tyto příkazy:
-
-> **Poznámka:** Zkontroluj si svůj aktuální pracovní adresář pomocí `pwd` (OS x/Linux) nebo příkazem `cd` (Windows) před inicializací úložiště. Měla bys být ve složce `djangogirls`.
-
-```
-$ git init
- Initialized empty Git repository in ~/djangogirls/.git/
-$ git config --global user.name "Your Name"
-$ git config --global user.email you@example.com
-```    
-
-Inicializace úložiště git je něco, co musíme udělat jednou za projekt (a nebudeš muset znovu zadávat uživatelské jméno a e-mailovou adresu).
-
-Git bude sledovat změny souborů a složek v tomto adresáři, ale jsou tam některé soubory, které chceme ignorovat. Uděláme to tak, že vytvoříš soubor s názvem `.gitignore` v základním adresáři. Otevři editor a vytvoř nový soubor s následujícím obsahem:
-
-```
-*.pyc
-__pycache__
- myvenv
- db.sqlite3
-.DS_Store
-```    
-
-A ulož ho jako `.gitignore` ve složce nejvyšší úrovně "djangogirls".
+Git sleduje změny v sadě souborů v takzvaném úložišti kódu/repository (nebo zkráceně "repo"). Založme si jeden pro náš projekt. Otevři konzoli a v `djangogirls` adresáři spusť tyto příkazy:
 
-> **Poznámka:** Tečka na začátku názvu souboru je důležitá! Pokud budeš mít jakékoliv potíže s vytvořením (například Mac nerad vytváří soubory, které začínají tečkou, přes Finder), tak použij funkci "Uložit jako" v editoru, což je neprůstřelné.
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. Měla by jsi být ve složce `djangogirls`.
 
-Je vhodné použít příkaz `git status` před použitím příkazu `git add`, anebo vždy, když si nejsi jistá, co se změnilo. To pomůže předejít jakýmkoliv překvapením, například přidání nesprávných souborů. Příkaz `git status` vrátí informace o všech souborech nesledovaných (untracked), upravených (modified) a připravených ke commitu (staged), stav větve a mnoho dalšího. Výstup by měl být podobný tomuto:
+{% filename %}command-line{% endfilename %}
 
-```
-$ git status
- On branch master
+    $ git init
+     Initialized empty Git repository in ~/djangogirls/.git/ 
+    $ git config --global user.name "Your Name" 
+    $ git config --global user.email you@example.com
+    
 
- Initial commit
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
 
-Untracked files:
-   (use "git add <file>..." to include in what will be committed)
-         .gitignore
-         blog/
-         manage.py
-         mysite/
+Git bude sledovat změny souborů a složek v tomto adresáři, ale jsou tam některé soubory, které chceme ignorovat. Uděláme to tak, že vytvoříš soubor s názvem `.gitignore` v základním adresáři. Otevři editor a vytvoř nový soubor s následujícím obsahem:
 
- nothing added to commit but untracked files present (use "git add" to track)
-```    
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Poznámka:** Tečka na začátku názvu souboru je důležitá! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+Je vhodné použít příkaz `git status` před použitím příkazu `git add` nebo vždy, když si nejste jisti, co se změnilo. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+     On branch master
+    
+     Initial commit 
+    
+    Untracked files:
+       (use "git add <file>..." to include in what will be committed)
+             .gitignore
+             blog/
+             manage.py
+             mysite/
+    
+     nothing added to commit but untracked files present (use "git add" to track)
+    
 
 A nakonec uložíme naše změny. Přejdi do konzole a spusť tyto příkazy:
 
-```
-$ git add --all .
-$ git commit -m "My Django Girls app, first commit"
-[...]
-13 files changed, 200 insertions(+)
- create mode 100644 .gitignore
-[...]
-create mode 100644 mysite/wsgi.py
-```  
-
-## Přenesení našeho kódu na GitHub
-
-Přejdi na [GitHub.com][2] a zaregistruj si zdarma nový uživatelský účet. (Pokud jsi to již dříve ve workshopu udělala, tak je to skvělé!)
-
-Potom vytvoř nové úložiště, dej mu název "my-first-blog". Ponech zaškrtávací políčko "initialise with a README" nezaškrtlé, ponechej prázdnou možnost .gitignore (to už jsme udělaly ručně) a ponech licenci jako None.
-
-![][3]
-
- [3]: images/new_github_repo.png
-
-> **Poznámka:** Název `my-first-blog` je důležitý – mohla by sis vybrat něco jiného, ale použijeme ho ještě mnohokrát později a musela bys ho pokaždé nahrazovat. Tak je zatím snazší se držet názvu `my-first-blog`.
-
-Na další obrazovce se zobrazí klon URL tvého repo. Zvol verzi "HTTPS", zkopíruj ji a za chvilku ji použijeme v terminálu:
-
-![][4]
-
- [4]: images/github_get_repo_url_screenshot.png
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Můžeš jít a mrknout se na to!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Pojďme natáhnout náš kód z GitHubu na PythonAnywhere vytvořením "klonu" našeho repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-Teď potřebujeme spojit úložiště Git na tvém počítači s úložištěm na GitHub.
-
-Zadej následující příkaz do konzole (nahraď `< your-github-username >` uživatelským jménem, které jsi zadala, když jsi vytvořila svůj účet na GitHub, ale bez ostrých závorek):
-
-```
-$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
-$ git push -u origin master
-```    
-
-Zadej své uživatelské jméno a heslo pro GitHub a měla bys vidět něco takového:
-
-```
-Username for 'https://github.com': hjwp
-Password for 'https://hjwp@github.com':
-Counting objects: 6, done.
-Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
-Total 3 (delta 0), reused 0 (delta 0)
-To https://github.com/hjwp/my-first-blog.git
-* [new branch] master -> master
-Branch master set up to track remote branch master from origin.
-```    
-
-<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extention -->
-
-Tvůj kód je nyní na GitHubu. Můžeš se na něj jít podívat! Zjistíš, že je v dobré společnosti - [Django][5], [Django girls tutorial][6] a mnoha dalších velkých open source software projektů, které také hostí svůj kód na GitHubu :)
-
- [5]: https://github.com/django/django
- [6]: https://github.com/DjangoGirls/tutorial
-
-# Vytvoření našeho blogu na PythonAnywhere
-
-> **Poznámka:** Možná, že jsi vytvořila účet PythonAnywhere již dříve během instalačních kroků - pokud ano, nemusíš to nyní dělat znovu.
-
-{% include "/deploy/signup_pythonanywhere.md" %}
-
-## Natáhnutí našeho kódu na PythonAnywhere
-
-Jakmile se zaregistruješ na PythonAnywhere, budeš přesměrována na dashboard nebo na stránku "Konzole". Zvol možnost spustit konzoli "Bash" – je to PythonAnywhere verze konzole, stejná jako na tvém počítači.
-
-> **Poznámka:** PythonAnywhere je založen na Linuxu, takže pokud jsi na Windows, konzole bude vypadat trochu jinak, než ta, která je na tvém počítači.
-
-Pojďme natáhnout náš kód z GitHubu na PythonAnywhere vytvořením "klonu" našeho repo. Zadej následující příkaz do konzole na PythonAnywhere (nezapomeň používat GitHub uživatelské jméno namísto `<your-github-username>`):
-
-```
-    $ git clone https://github.com/<your-github-username>/my-first-blog.git
-```    
-
-Tento příkaz nahraje kopii tvého kódu na PythonAnywhere. Zkontroluj to zadáním `tree my-first-blog`:
-
-```
-$ tree my-first-blog
-my-first-blog/
-├── blog
-│   ├── __init__.py
-│   ├── admin.py
-│   ├── migrations
-│   │   ├── 0001_initial.py
-│   │   └── __init__.py
-│   ├── models.py
-│   ├── tests.py
-│   └── views.py
-├── manage.py
-└── mysite
-    ├── __init__.py
-    ├── settings.py
-    ├── urls.py
-    └── wsgi.py
-```    
-
-### Vytvoření virtualenv na PythonAnywhere
-
-Stejně jako na tvém počítači můžeš na PythonAnywhere vytvořit virtualenv. V Bash konzoli zadej postupně následující příkazy:
-
-```
 $ cd my-first-blog
 
-$ virtualenv --python=python3.4 myvenv
-Running virtualenv with interpreter /usr/bin/python3.4
-[...]
-Installing setuptools, pip...done.
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
 
 $ source myvenv/bin/activate
 
-(mvenv) $ pip install django whitenoise
-Collecting django
-[...]
-Successfully installed django-1.8.2 whitenoise-2.0
-```    
-
-> **Poznámka:** Krok `pip install` může trvat několik minut. Trpělivost, trpělivost! Ale pokud to trvá déle než 5 minut, něco není v pořádku. Zeptej se svého kouče.
-
-<!--TODO: think about using requirements.txt instead of pip install.-->
-
-### Shromažďování statických souborů
-
-Byla jsi zvědavá, co bylo to "whitenoise" vlastně zač? Je to nástroj pro obsluhu takzvaných "statických souborů". Statické soubory jsou soubory, které se pravidelně nemění nebo nespouštějí programový kód, například soubory HTML nebo CSS. Na serverech fungují odlišně než na tvém osobním počítači a proto potřebujeme nástroj jako "whitenoise" k jejich obsloužení.
-
-O statických souborech zjistíme trochu více později v tomto kurzu, až budeme upravovat CSS pro naše stránky.
-
-Nyní jen musíme spustit další příkaz na serveru s názvem `collectstatic`. Ten řekne Djangu, aby posbíral všechny statické soubory, které potřebuje na serveru. V současnosti jsou to hlavně soubory, které upravují vzhled admin stránky.
-
-```
-(mvenv) $ python manage.py collectstatic
-
-You have requested to collect static files at the destination
-location as specified in your settings:
-     /home/edith/my-first-blog/static
-
-This will overwrite existing files!
-Are you sure you want to do this?
-
-Type 'yes' to continue, or 'no' to cancel: yes
-```    
-
-Zadej "yes" a pokračujeme! Také máš ráda, když ti počítač začne vypisovat ty dlouhé stránky kódu? Já jsem to vždy doprovázela tichými zvuky. Brp, brp, brp...
-
-```
-Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/actions.min.js' Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/inlines.min.js' [...] Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/changelists.css' Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/base.css' 62 static files copied to '/home/edith/my-first-blog/static'.
-```    
-
-### Vytvoření databáze na PythonAnywhere
-
-Zde je další věc, která se liší mezi tvým počítačem a serverem: server používá jinou databázi. Takže uživatelské účty a příspěvky mohou být jiné na serveru a na tvém počítači.
-
-Můžeme inicializovat databázi na serveru, stejně jako jsi to udělala v počítači, pomocí příkazů `migrate` a `createsuperuser`:
-
-```
-(mvenv) $ python manage.py migrate
-Operations to perform:
-[...]
-   Applying sessions.0001_initial... OK
-
-
-(mvenv) $ python manage.py createsuperuser
-```    
-
-## Publikování našeho blogu jako webové aplikace
-
-Nyní je náš kód na PythonAnywhere a náš virtualenv je připraven, statické soubory jsou shromážděny a databáze inicializována. Jsme připraveni zveřejnit blog jako webovou aplikaci!
-
-Běž zpět na dashboard PythonAnywhere kliknutím na logo a poté klikni na kartu **Web**. Nakonec klikni na **Add a new web app**.
-
-Po potvrzení tvého názvu domény zvol **manual configuration** (NB *není* "Django" volba) v dialogovém okně. Dále zvol **Python 3.4** a klepni na tlačítko Next pro dokončení průvodce.
-
-> **Poznámka:** Ujisti se, že volíš možnost "Manual configuration", nikoliv "Django". Jsme příliš cool na to, abychom používali výchozí nastavení PythonAnywhere Django ;-)
-
-### Nastavení virtualenv
-
-Budeš přesměrována na PythonAnywhere konfigurační obrazovku pro tvou webovou aplikaci, sem budeš muset jít pokaždé, když budeš chtít provést změny aplikace na serveru.
-
-![][7]
-
- [7]: images/pythonanywhere_web_tab_virtualenv.png
-
-V části "Virtualenv" klepni na červený text, který říká "Enter the path to a virtualenv" a zadej: `/home/ <your-username>/my-first-blog/myvenv/`. Klikni na modré zaškrtávací políčko, čímž uložíš cestu předtím, než budeš pokračovat.
-
-> **Poznámka:** Nahraď své vlastní uživatelské jméno podle potřeby. Pokud uděláš chybu, PythonAnywhere Ti zobrazí malé varování.
-
-### Konfigurace souboru WSGI
-
-Django používá "WSGI protokol", standard pro obsluhu webových stránek pomocí Pythonu, který PythonAnywhere podporuje. Aby PythonAnywhere poznal a mohl používat náš Django blog, upravme WSGI konfigurační soubor.
-
-Klikni na odkaz "WSGI configuration file" (v sekci "Code" v horní části stránky – bude pojmenována nějak takto `/var/www/<your-username>_pythonanywhere_com_wsgi.py`) a budeš přesměrována do editoru.
-
-Odstraň veškerý obsah a nahraď jej upraveným následujícím kódem:
-
-```python
-import os
-import sys
-
-path = '/home/<your-username>/my-first-blog' # use your own username here
-if path not in sys.path:
-     sys.path.append(path)
-
-os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
-
-from django.core.wsgi import get_wsgi_application
-from whitenoise.django import DjangoWhiteNoise
-application = DjangoWhiteNoise(get_wsgi_application())
-```    
-
-> **Poznámka:** Nezapomeň nahradit své vlastní uživatelské jméno za `<your-username>`
-
-Úkolem tohoto souboru je říct PythonAnywhere, kde je naše webová aplikace a jaký je název souboru nastavení Djanga. Také nastavuje nástroj pro statické soubory "whitenoise".
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. O statických souborech zjistíme trochu více později v tomto kurzu, až budeme upravovat CSS pro naše stránky.
 
 Klikni na **Save** a přejdi zpět na kartu **Web**.
 
-Zvládly jsme to! Klikni na velké zelené tlačítko **Reload**, čímž zobrazíš svou aplikaci. Odkaz na to najdeš v horní části stránky.
+Zvládli jsme to! Klikni na velké zelené tlačítko **Reload** a budeš mít možnost zobrazit svou aplikaci. Odkaz na to najdeš v horní části stránky.
 
 ## Ladící tipy
 
-Pokud se ti zobrazí chyba při pokusu zobrazit web, první místo, kam se podívat na nějaké informace o ladění, je v **error log**. Odkaz na něj najdeš na PythonAnywhere v [kartě Web][8]. Zkontroluj, jestli tam nejsou nějaké chybové zprávy; nejnovější záznamy jsou na konci. Mezi běžné problémy patří:
-
- [8]: https://www.pythonanywhere.com/web_app_setup/
+Pokud se ti zobrazí chyba při pokusu navštívit web, první místo kam se podívat na nějaké informace o ladění je v **error log**. Odkaz na něj najdeš na PythonAnywhere v [kartě Web](https://www.pythonanywhere.com/web_app_setup/). Zkontroluj jestli tam nejsou nějaké chybové zprávy; nejnovější záznamy jsou na konci. Mezi běžné problémy patří:
 
-*   Často zapomínané kroky jsou ty, které jsme dělaly v konzoly: vytvoření virtualenv, aktivace, instalace Djanga, spuštění collectstatic, přenesení databáze.
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
 
-*   Chyba k cestě virtualenv na kartě Web – bude obvykle označená malou červenou zprávou na stejném místě.
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
 
-*   Chyba v konfiguračním souboru WSGI – máš cestu do složky my-first-blog v pořádku?
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
 
-*   Vybrala jsi stejnou verzi Pythonu pro svůj virtualenv stejně jako pro svoji webovou aplikaci? Obe verze by měly být 3.4.
+- Vybrala jsi stejnou verzi Pythonu pro svůj virtualenv stejně jako pro svoji webovou aplikaci? Obe verze by měly být 3.6.
 
-*   Existují některé [obecné tipy ladění na PythonAnywhere wiki][9].
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
 
- [9]: https://www.pythonanywhere.com/wiki/DebuggingImportError
-
-A pamatuj si, že tvůj kouč je tady, aby ti pomohl!
+A pamatuj si, že tvůj coach je tady, aby ti pomohl!
 
 # Jsme online!
 
-Výchozí stránka tvé webové aplikace by měla ukázat "Welcome to Django", stejně jako to dělá na tvém počítači. Zkus přidat `/admin/` na konec adresy URL a budeš přesměrována na admin stránku. Přihlas se pomocí uživatelského jména a hesla a uvidíš, že můžeš přidávat nové příspěvky na server.
+The default page for your site should say "It worked!", just like it does on your local computer. Zkus přidat `/admin/` na konec adresy URL, a budeš přesměrována na admin stránku. Přihlas se pomocí uživatelského jména a hesla, a uvidíš, že můžeš přidávat nové příspěvky na server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
 
-Poplácej sama sebe *po zádech*! Nasazení serveru je jednou z nejsložitější částí vývoje webových aplikací a trvá lidem často i několik dní, než je funkční. Ale ty máš své stránky online na internetu už teď!
+Poplácej sama sebe *ohromně* po zádech! Nasazení serveru je jednou z nejsložitější částí vývoje webových aplikací a trvá lidem často i několik dní, než je funkční. Ale ty máš své stránky online na Internetu, právě teď!
\ No newline at end of file
diff --git a/cs/deploy/install_git.md b/cs/deploy/install_git.md
index 6cc2682b85d..51d68d31688 100755
--- a/cs/deploy/install_git.md
+++ b/cs/deploy/install_git.md
@@ -1,19 +1,52 @@
-### Windows
+Git je "systém pro správu verzí" používaný spoustou programátorů. Tento software může sledovat změny v souborech v průběhu času tak, že konkrétní verze můžeš později znovu zobrazit. Trochu jako funkce "sledování změn" v aplikaci Microsoft Word, ale mnohem silnější.
 
-Git si můžeš stáhnout z [git-scm.com](https://git-scm.com/). Klikej na "další" ve všech krocích s výjimkou 5. kroku s názvem "Nastavení prostředí PATH", zvol "Spustit Git a související Unixové nástroje z příkazového řádku systému Windows" (spodní možnost). Ostatní výchozí hodnoty jsou v pořádku. Odškrtni Windows-style konce řádků, pro commit je Unixový styl konce řádků správný.
+## Instalace Git
 
-### MacOS
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
 
-Stáhni Git z [git-scm.com](https://git-scm.com/) a postupuj podle pokynů.
+Git si můžeš stáhnout z [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Ostatní výchozí hodnoty jsou v pořádku. Odškrtni Windows-style konce řádků, pro commit je Unixový styl konce řádků správný.
 
-### Linux
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
 
-Pokud ho již nemáš nainstalovaný, git měl by být k dispozici pomocí Správce balíčků, zkus:
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
 
+Stáhni Git z [git-scm.com](https://git-scm.com/) a postupujte podle pokynů.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
 ```
-sudo apt-get install git
-# or
-sudo yum install git
-# or
-sudo zypper install git
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
 ```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/cs/deploy/signup_pythonanywhere.md b/cs/deploy/signup_pythonanywhere.md
index fe6e67a8fe7..ca66bd0de69 100755
--- a/cs/deploy/signup_pythonanywhere.md
+++ b/cs/deploy/signup_pythonanywhere.md
@@ -1,5 +1,5 @@
-Dále je čas přihlásit se zdarma k účtu "Beginner" na PythonAnywhere.
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
 
-  * [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
 
-> **Poznámka:** Při výběru svého uživatelského jména měj na paměti, že adresa URL tvého blogu bude mít tvar `yourusername.pythonanywhere.com`, takže si pro svůj blog zvol vlastní přezdívku nebo jiné jméno.
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/cs/django/README.md b/cs/django/README.md
index 3663ae96264..ec5bf1d2e49 100755
--- a/cs/django/README.md
+++ b/cs/django/README.md
@@ -1,27 +1,27 @@
 # Co je Django?
 
-Django (*jang-goh/ˈdʒæŋɡoʊ /*) je svobodný a open source webový aplikační framework napsaný v Pythonu. Webový framework je sada komponent, která pomáhá vyvíjet webové stránky rychleji a snadněji.
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. Webový framework je sada komponent, která pomáhá vyvíjet webové stránky rychleji a snadněji.
 
-Když vytváříš webové stránky, vždy potřebuješ podobnou sadu komponent: způsob, jak zpracovat ověření uživatele (registraci, přihlášení, odhlášení), administrační panel pro tvé webové stránky, formuláře, způsob, jak nahrávat soubory, atd.
+Když vytváříš webové stránky, vždy potřebuješ podobnou sadu komponent: způsob, jak zpracovat ověření uživatele (registraci, přihlášení, odhlášení), administrační panel pro tvé webové stránky, formuláře, způsob jak nahrávat soubory, atd.
 
-Naštěstí si ostatní lidé již dávno všimli, že vývojáři čelí stejným problémům při vytváření nových stránek. Takže se spojili a vytvořili frameworky (Django je jedním z nich), které obsahují sadu hotových, snadno použitelných komponent.
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
 
-Frameworky existují, aby ti ušetřily čas a ty jsi nemusela znovu vynalézat, co už někdo zdlouhavě vymýšlel. Stejně tak by ti měly ušetřit čas při vytváření nových webových stránek.
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
 
 ## Proč potřebuješ framework?
 
-Abychom pochopili, co ve skutečnosti Django je, musíme se blíže podívat na to, co dělá server. První věcí je, že server musí vědět, že chceš obsloužit tebou zvolenou webovou stránkou.
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
 
-Představ si poštovní schránku (port), která na zvoleném portu sleduje příchozí zprávy (požadavky). Podobně se chová webový server. Webový server čte požadavky od uživatele a odešle odpověď v podobě webové stránky. Ale když chceš něco poslat, musíš mít nějaký obsah. A Django je to, co ti pomůže vytvořit tento obsah.
+Představ si poštovní schránku (port), která na zvoleném portu sleduje příchozí zprávy (požadavky). Podobně se chová webový server. The web server reads the letter and then sends a response with a webpage. Ale když chceš něco poslat, musíš mít nějaký obsah. A Django je něco, co ti pomůže vytvořit tento obsah.
 
 ## Co se stane, když někdo požaduje webové stránky ze serveru?
 
-Pokud přijde žádost na webový server, je předána Django frameworku, který se snaží přijít na to, co vlastně uživatel požaduje. Nejprve vezme adresu webové stránky a snaží se přijít na to, co udělat. Tuto část provádí Django **urlresolver** (všimni si, že adresa webové stránky se nazývá URL - Uniform Resource Locator - proto jméno *urlresolver* dává smysl). Tato činnost není složitá - bere si seznam vzorů a v něm se pokouší vyhledat shodu s URL. Django kontroluje seznam vzorů od shora dolů a pokud některý odpovídá, pak Django předá žádost související funkci, která se nazývá *view*.
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
 
-Představ si pošťáka s dopisem. Kráčí po ulici a kontroluje každé číslo domu, jestli odpovídá adrese na dopisu. Pokud adresa odpovídá, dopis vloží do schránky. Stejným způsobem funguje urlresolver!
+Představ si pošťáka s dopisem. Kráčí po ulici a kontroluje každé číslo domu jestli odpovídá adrese na dopisu. Pokud adresa odpovídá, dopis vloží do schránky. Stejným způsobem funguje urlresolver!
 
-Ve funkci *view* se provádí všechny zajímavé věci: můžeme se podívat do databáze a vyhledat nějaké informace. Co když chce uživatel změnit něco v datech? Dopis může říkat "prosím změňte popis mé práce." *View* může zkontrolovat, zda máš povolení tuto změnu provést, pak aktualizuje popis práce a odešle ti zprávu: "Hotovo!". V tuto chvíli *view* vygeneruje odpověď a Django ji může odeslat tvému webovému prohlížeci.
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Možná, že uživatel chtěl změnit něco v datech? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
 
-Samozřejmě, že výše uvedený popis je trochu zjednodušený, ale prozatím není nutné znát všechny technické detaily. Pro obecnou představu to postačí.
+Samozřejmě výše uvedený popis je trochu zjednodušený, ale prozatím není nutné znát všechny technické detaily. Pro obecnou představu to postačí.
 
-Takže místo studování přílišných podrobností jednoduše začneme něco vytvářet pomocí Djanga, čímž se naučíme všechny důležité části!
+Takže místo studování přílišných podrobností, jednoduše začneme něco vytvářet pomocí Django a touto cestou se naučíme všechny důležité části!
\ No newline at end of file
diff --git a/cs/django_admin/README.md b/cs/django_admin/README.md
index 7ddfc186a3e..1d4abd83791 100755
--- a/cs/django_admin/README.md
+++ b/cs/django_admin/README.md
@@ -1,49 +1,57 @@
 # Django admin
 
-Chceš-li přidávat, upravovat a mazat příspěvky, které jsme právě vymodelovaly, použijeme Django admin.
+To add, edit and delete the posts we've just modeled, we will use Django admin.
 
-Otevřeme soubor `blog/admin.py` a nahradíme jeho obsah následujícím kódem:
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
 
 ```python
 from django.contrib import admin
 from .models import Post
 
 admin.site.register(Post)
-```  
+```
 
-Jak vidíš, importujeme (vkládáme) Post model definovaný v předchozí kapitole. Pro zviditelnění našeho modelu na admin stránce musíme zaregistrovat model pomocí `admin.site.register(Post)`.
+Jak vidíš, importujeme (vkládáme) Post model definovaný v předchozí kapitole. Pro zviditelnění našeho modelu na admin stránce, musíme zaregistrovat model pomocí `admin.site.register(Post)`.
 
-OK, je čas se podívat na náš Post model. Nezapomeň spustit `Pythonu manage.py runserver` v konzoli www serveru. Přejdi do prohlížeče a zadej adresu http://127.0.0.1:8000/admin/. Uvidíš přihlašovací stránku jako je tato:
+OK čas se podívat na náš Post model. Nezapomeň spustit `Pythonu manage.py runserver` v konzoli www serveru. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
 
-![Login page][1]
+![Login page](images/login_page2.png)
 
- [1]: images/login_page2.png
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
 
-Chceš-li se přihlásit, musíš vytvořit *superusera* - uživatele, který má kontrolu nad celou webovou stránkou. Vrať se do příkazového řádku, zadej `python manage.py createsuperuser` a stiskni klávesu enter. Po zobrazení výzvy zadej své uživatelské jméno (malá písmena, bez mezer), e-mailovou adresu a heslo. Nedělej si starosti, že nevidíš heslo, které zadáváš - tak to má být. Jen ho napiš a stiskni `enter` pro pokračování. Výstup by měl vypadat takto (kde uživatelské jméno a e-mail by měly být tvé vlastní):
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
 
-```
-(myvenv) ~/djangogirls$ python manage.py createsuperuser
-Username: admin
-Email address: admin@admin.com
-Password:
-Password (again):
-Superuser created successfully.
-```    
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
 
-Vrať se do svého prohlížeče. Přihlas se pomocí pověření superuživatele, kterého jsi právě vytvořila; měla bys vidět Django admin dashboard/nástěnku.
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
 
-![Django admin][2]
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
 
- [2]: images/django_admin3.png
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
 
-Klikni na příspěvky/Posts a trochu si s nimi pohraj. Přidej pět nebo šest příspěvků blogu. Nedělej si starosti s obsahem - pro ušetření času můžeš jednoduše kopírovat a vložit nějaký text z tohoto kurzu :).
+![Django admin](images/django_admin3.png)
 
-Ujisti se, že alespoň dva nebo tři příspěvky (ale ne všechny) mají nastavené datum publikování. Později to bude užitečné.
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
 
-![Django admin][3]
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
 
- [3]: images/edit_post3.png
+![Django admin](images/edit_post3.png)
 
-Pokud chceš vědět více o Django admin, koukni se do Django dokumentace: https://docs.djangoproject.com/en/1.8/ref/contrib/admin/
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
 
-V tuto chvíli je asi dobrý čas dát si pro trochu vzpruhy kávu, čaj nebo něco k jídlu. Vytvořila jsi svůj první model Django - zasloužíš si malý oddech!
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/cs/django_forms/README.md b/cs/django_forms/README.md
index f70ecd1a30d..0e9c24d7935 100755
--- a/cs/django_forms/README.md
+++ b/cs/django_forms/README.md
@@ -1,222 +1,248 @@
 # Django formuláře
 
-Poslední věc, kterou chceme udělat na našich webových stránkách, je vytvořit pohodlný způsob, jak přidávat a upravovat příspěvky na blogu. Django `admin` je super, ale je těžké ho přizpůsobit a upravit do hezčí podoby. S `formuláři` budeme mít absolutní moc nad naším rozhraním - můžeme dělat téměř cokoliv, co si dokážeme představit!
+Poslední věc, kterou chceme udělat na našich webových stránkách, je vytvořit příjemný způsob, jak přidávat a upravovat příspěvky na blogu. Django `admin` je super, ale je to dost těžko přizpůsobitelné a upravitelné do hezčí podoby. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
 
 Pěkná věc na Django formulářích je, že je můžeme definovat úplně od počátku nebo vytvořit `ModelForm`, který uloží výsledek z formuláře pomocí modelu.
 
 To je přesně to, co chceme udělat: vytvoříme formulář pro náš model `Post`.
 
-Stejně jako všechny důležité části Djanga mají formuláře své vlastní soubory: `forms.py`.
+Stejně jako všechny důležité části Djanga, formuláře mají své vlastní soubory: `forms.py`.
 
-V našem adresáři potřebujeme vytvořit soubor s názvem `blog`.
+Potřebujeme vytvořit soubor s tímto názvem v našem adresáři `blog`.
 
-```
-blog
- └── forms.py
-```  
+    blog
+     └── forms.py
+    
+
+OK, let's open it and type the following code:
 
-OK, otevři ho a zadej následující kód:
+{% filename %}blog/forms.py{% endfilename %}
 
 ```python
- from django import forms
+from django import forms
+
+from .models import Post
 
- from .models import Post
+class PostForm(forms.ModelForm):
 
- class PostForm(forms.ModelForm):
-     class Meta:
-         model = Post
-         fields = ('title', 'text',)
-```    
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
 
-Musíme nejdříve importovat Django formuláře (`from django import forms`) a samozřejmě náš `Post` model (`from .models import Post`).
+Musíme nejdříve importovat Django formuláře (`z django import forms`) a samozřejmě náš `Post` model (`from .models import Post`).
 
-`PostForm`, jak asi předpokládáš, je jméno našeho formuláře. Musíme říct Djangu, že tento formulář je `ModelForm` (tak pro nás bude moci Django udělat něco magického) - zodpovědný za to bude `forms.ModelForm`.
+`PostForm`, jak asi předpokládáš, je jméno našeho formuláře. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
 
-Dále zde máme `třídu Meta`, kde řekneme Djangu, který model by měl být použit k vytvoření tohoto formuláře (`model = Post`).
+Dále zde máme `třídu Meta`, kde řekneme Djangu, který model by měl být použít k vytvoření tohoto formuláře (`model = Post`).
 
-Nakonec můžeme Djangu říct, co se má stát s jednotlivými poli našeho formuláře. V tomto případě chceme pouze zobrazit pole `nadpis/title` a `text` - `autor` by měl být člověk, který je aktuálně přihlášen (ty!) a `created_date` by mělo být automaticky nastaveno, když vytvoříme příspěvek (tj. v kódu).
+Nakonec můžeme Djangu říct co se má stát s jednotlivými poli našeho formuláře. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
 
-A je to! Vše, co teď musíme udělat, je použít formulář ve *view* a zobrazit ho v šabloně.
+A je to! Vše, co musíme udělat, je použít formulář ve *view* a zobrazit ho v šabloně.
 
-Takže ještě jednou: budeme vytvářet odkaz na stránky, URL, pohled a šablonu.
+So once again we will create a link to the page, a URL, a view and a template.
 
 ## Odkaz na stránku s formulářem
 
-Je tedy čas otevřít soubor `blog/templates/blog/base.html`. Přidáme odkaz do `div` s názvem `page-header`:
+Je tedy čas k otevření souboru `blog/templates/blog/base.html`. Přidáme odkaz do `div` s názvem `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
-```    
+```
 
-Všimni si, že chceme zavolat náš nový view `post_new`.
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
 
-Po přidání řádku by měl tvůj html soubor vypadat takto:
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
 <html>
-      <head>
-         <title>Django Girls blog</title>
-         <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-         <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
-         <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
-         <link rel="stylesheet" href="{% static 'css/blog.css' %}">
-      </head>
-      <body>
-         <div class="page-header">
-             <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
-             <h1><a href="/">Django Girls Blog</a></h1>
-         </div>
-         <div class="content container">
-             <div class="row">
-                 <div class="col-md-8">
-                     {% block content %}
-                     {% endblock %}
-                 </div>
-             </div>
-         </div>
-      </body>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
 </html>
-```    
+```
 
-Po uložení a obnovení stránky http://127.0.0.1:8000 patrně uvidíš známou `NoReverseMatch` chybu.
+Po uložení a obnovení stránky http://127.0.0.1:8000 patrně uvidíš známou `NoReverseMatch` chybu, dobrá?
 
 ## URL
 
 Otevři `blog/urls.py` a přidej řádek:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 url(r'^post/new/$', views.post_new, name='post_new'),
-```  
+```
+
+A výsledný kód bude vypadat takto:
 
-Výsledný kód bude vypadat takto:
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
- from django.conf.urls import url
- from . import views
+from django.conf.urls import url
+from . import views
 
 urlpatterns = [
-     url(r'^$', views.post_list, name='post_list'),
-     url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
-     url(r'^post/new/$', views.post_new, name='post_new'),
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
 ]
-```    
+```
 
-Po aktualizaci webu vidíme `AttributeError`, protože nemáme implementovaný `post_new` view. Přidáme ho právě teď.
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
 
 ## post_new view
 
 Musíme otevřít soubor `blog/views.py` a přidat následující řádky:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from .forms import PostForm
-```  
+```
 
-a náš *view*:
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
-     form = PostForm()
-     return render(request, 'blog/post_edit.html', {'form': form})
-```    
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
 
-Chceš-li vytvořit nový formulář `Post`, musíš zavolat `PostForm()` a předat ho do šablony. Za chvilku se vrátíme k tomuto *view*, ale teď pojďme rychle vytvořit šablonu formuláře.
+Chceš-li vytvořit nový formulář `Post`, musíš zavolat `PostForm()` a předat ho do šablony. We will go back to this *view*, but for now, let's quickly create a template for the form.
 
 ## Šablona
 
 Musíme vytvořit soubor `post_edit.html` v adresáři `blog/templates/blog`. Pro vytvoření formuláře potřebujeme udělat několik věcí:
 
-*   musíme zobrazit formulář. Můžeme to udělat například jednoduchým `{% raw %}{{ form.as_p }}{% endraw %}`.
-*   formulář musíme obalit HTML značkou (přidej řádek nad formulář): `< method="POST" >... < / form >`
-*   potřebujeme tlačítko `Uložit`. Vytvoříme HTML tlačítko: `< button type="submit"> Uložit < / button>`
-*   a nakonec těsně za otevírací značku `< form... >` musíme přidat `{% raw %}{% csrf_token %}{% endraw %}`. Toto je velmi důležité, protože tak vytvoříme bezpečnější formulář! Django si bude stěžovat v okamžiku, kdy se pokusíš uložit formulář, pokud zapomeneš na tuto část:
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* Formulář musíme obalit HTML značkou (přidej řádek nad Formulář): `< method="POST" >... < / form >`.
+* Potřebujeme tlačítko `Uložit`. Vytvoříme HTML tlačítko: `< button type="submit"> Uložit < / button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. Toto je velmi důležité, protože tak vytvoříme bezpečnější formulář! If you forget about this bit, Django will complain when you try to save the form:
 
-![CSFR zakázaná stránka][1]
+![CSFR zakázaná stránka](images/csrf2.png)
 
- [1]: images/csrf2.png
+OK, so let's see how the HTML in `post_edit.html` should look:
 
-Pojďme se nyní podívat, jak by mělo vypadat HTML v `post_edit.html`:
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
 
 {% block content %}
-     <h1>New post</h1>
-     <form method="POST" class="post-form">{% csrf_token %}
-         {{ form.as_p }}
-         <button type="submit" class="save btn btn-default">Save</button>
-     </form>
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
 {% endblock %}
-```    
+```
 
 Čas aktualizovat naší stránku! Hurá! Zobrazil se formulář!
 
-![Nový formulář][2]
-
- [2]: images/new_form2.png
+![Nový formulář](images/new_form2.png)
 
-Ale ještě chvilku počkej! Když něco zadáš do polí `titulek` a `text` a pokusíš se formulář uložit - co se stane?
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
 
-Nic! Jsme opět na stejné stránce, náš text je pryč... a nepřidal se žádný nový příspěvek. Tak co se stalo?
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
 
 Odpověď je: nic. Musíme ještě trochu zapracovat na našem *view*.
 
 ## Ukládání formuláře
 
-Otevři znovu `blog/views.py`. Vše, co máme aktuálně v `post_new`, je toto:
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
-     form = PostForm()
-     return render(request, 'blog/post_edit.html', {'form': form})
-```    
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? Všechna pole z formuláře jsou nyní k dispozici v proměnné `request.POST`. Neměla by jsi přejmenovávat `POST` na něco jiného (jediná další platná hodnota proměnné `method` je `GET`, ale nyní nemáme čas vysvětlovat rozdíly).
 
-Když odešleme formulář, vrátíme se zpět na ten samý view, ale tentokrát obdržíme nějaká další data v `request`, přesněji v `request.POST` (pojmenování nemá nic společného s naším "post" v blogu, vychází to z toho, že "zasíláme" data). Pamatuješ si, že v našem HTML souboru ve `<form>` jsme definovali proměnnou `method="POST"`? Všechna pole z formuláře jsou nyní k dispozici v proměnné `request.POST`. Neměla bys přejmenovávat `POST` na něco jiného (jediná další platná hodnota proměnné `method` je `GET`, ale teď tady nebudeme vysvětlovat rozdíly).
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. Takže musíme přidat podmínku (použijeme na to `-if`):
 
-Takže v našem *view* máme dvě samostatné situace ke zpracování. První: když načteme stránku poprvé a chceme dostat prázdný formulář. Druhou: když se vrátíme zpět do našeho *view* s vyplněnými daty formuláře. Takže musíme přidat podmínku (použijeme na to `if`).
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 if request.method == "POST":
-     [...]
+    [...]
 else:
-     form = PostForm()
-```    
+    form = PostForm()
+```
 
-Teď je čas k vyplnění mezer `[...]`. Je-li `method` `POST`, chceme vytvořit `PostForm` s údaji z formuláře, že? Udělejme to:
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST)
-```  
+```
 
-Snadné! Další věcí je zjistit, zda-li je formulář v pořádku (všechna požadovaná pole jsou vyplněna a neobsahují špatné hodnoty). Uděláme to pomocí `form.is_valid()`.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
 
 Zkontrolujeme, je-li formulář platný, a pokud ano, můžeme ho uložit!
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 if form.is_valid():
-     post = form.save(commit=False)
-     post.author = request.user
-     post.published_date = timezone.now()
-     post.save()
-```    
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+V podstatě, tady máme dvě věci: ukládáme formulář pomocí `form.save` a přidáváme autora (vzhledem k tomu, že v `PostForm` nebylo žádné pole `Autor` v a toto pole je požadováno). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
 
-V podstatě, tady máme dvě věci: ukládáme formulář pomocí `form.save` a přidáváme autora (vzhledem k tomu, že v `PostForm` nebylo žádné pole `Autor` a toto pole je požadováno!). `commit=False` znamená, že ještě nechceme `Post` uložit pomocí modelu - chceme nejdříve přidat autora. Většinu času budeš používat `form.save()`, bez `commit=False`, ale v tomto případě to potřebujeme takto udělat. `post.save()` zachová změny (přidá autora) a vytvoří nový příspěvek na blogu!
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
 
-A nakonec by bylo úžasné, pokud bychom okamžitě přešli na stránku `post_detail` s nově vytvořeným příspěvkem, že ano? K tomu potřebujeme jeden další import:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import redirect
-```    
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
 
-Přidej to na samý začátek souboru. A nyní můžeš říci: Jdi na stránku `post_detail` s nově vytvořeným příspěvkem.
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 return redirect('post_detail', pk=post.pk)
-```  
+```
+
+`post_detail` is the name of the view we want to go to. Pamatuj si, že tento *view* vyžaduje proměnnou `pk`. To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
 
-`post_detail` je název pohledu, na který chceme jít. Pamatuj si, že tento *view* vyžaduje proměnnou `pk`. Pro předání do view použijeme `pk=post.pk`, kde `post` je nově vytvořený příspěvek!
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
 
-Už jsme si toho řekly hodně, ale pravděpodobně chceš vidět, jak nyní celý *view* vypadá nyní, nemám pravdu?
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -231,165 +257,191 @@ def post_new(request):
     else:
         form = PostForm()
     return render(request, 'blog/post_edit.html', {'form': form})
-```    
-
-Pojďme se podívat, jestli to funguje. Přejdi na stránku http://127.0.0.1:8000/post/new/, přidej `title` a `text`, ulož jej... a hle! Byl přidán nový příspěvek na blog a my jsme přesměrovány na stránku `post_detail`!
+```
 
-Možná jsi si všimla, že jsme nastavili proměnnou publish_date před uložením postu. Později si ukážeme *tlačítko Publikovat* v **Django girls tutorial: rozšíření**.
+Pojďme se podívat, jestli to funguje. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
 
-## Ověření formuláře
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
 
-A teď ti ukážeme, jak cool jsou formuláře v Djangu. Blog příspěvek musí mít `title` a `text` pole. V našem modelu `Post` jsme neřekly (na rozdíl od `published_date`), že jsou tato pole nepovinná, takže Django ve výchozím nastavení očekává, že budou vyplněná.
+To je úžasné!
 
-Pokus se uložit formulář bez `nadpisu` a `textu`. Hádej, co se stane!
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. Tím se dočasně vyřeší tento problém. Existuje trvalá oprava, která na tebe čeká v **domácím úkolu: zabezpeč svůj web!** kapitola za hlavním tutorialem.
 
-![Ověření formuláře][3]
+![Chyba přihlášení](images/post_create_error.png)
 
- [3]: images/form_validation2.png
+## Ověření formuláře
 
-Django se stará o ověřování, že všechna pole v našem formuláři jsou správně. Není to skvělé?
+A teď ti ukážeme jak cool jsou formuláře v Djangu. Blog příspěvek musí mít `title` a `text` pole. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
 
-> Jelikož jsme nedávno použily Django admin rozhraní, systém si v současné době myslí, že jsme přihlášeni. Existuje několik situací, které by mohly vést k našemu odhlášení (zavření prohlížeče, restartováním DB, atd.). Pokud při vytváření příspěvku dostaneš chybu, upozorňující na nepřihlášeného uživatele, zamiř na http://127.0.0.1:8000/admin a přihlas se znovu. Tím se dočasně vyřeší tento problém. Existuje trvalá oprava, která na tebe čeká v **domácím úkolu: zabezpeč svůj web!** v kapitole za hlavním tutorialem.
+Try to save the form without `title` and `text`. Guess what will happen!
 
-![Chyba přihlášení][4]
+![Ověření formuláře](images/form_validation2.png)
 
- [4]: images/post_create_error.png
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
 
 ## Upravit formulář
 
-Teď víme, jak přidat nový formulář. Ale co když chceme upravit stávající? Je to velmi podobné tomu, co jsme před chvílí dělaly. Vytvoříme teď rychle některé důležité věci (pokud něčemu neporozumíš, měla bys požádat svého kouče nebo se podívat do předchozích kapitol, protože jsme již všechny tyto kroky probíraly).
+Teď víme, jak přidat nový formulář. Ale co když chceme upravit stávající? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
 
-Otevři `blog/templates/blog/post_detail.html` a přidej následující řádek:
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
-```  
+```
 
-tak, aby šablona vypadala takto:
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
+
 {% block content %}
-     <div class="post">
-         {% if post.published_date %}
-             <div class="date">
-                 {{ post.published_date }}
-             </div>
-         {% endif %}
-         <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
-         <h1>{{ post.title }}</h1>
-         <p>{{ post.text|linebreaksbr }}</p>
-     </div>
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endblock %}
-```  
+```
 
 V `blog/urls.py` přidej tento řádek:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-     url(r'^post/(?P<pk>[0-9]+)/edit/$', views.post_edit, name='post_edit'),
-```  
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
 
-Znovu použijeme šablonu `blog/templates/blog/post_edit.html`, takže jediné, co chybí, je *view*.
+Znovu použijeme šablonu `blog/templates/blog/post_edit.html`, takže jediné, co chybí je *view*.
 
-Otevři `blog/views.py` a přidej na samý konec souboru:
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_edit(request, pk):
-     post = get_object_or_404(Post, pk=pk)
-     if request.method == "POST":
-         form = PostForm(request.POST, instance=post)
-         if form.is_valid():
-             post = form.save(commit=False)
-             post.author = request.user
-             post.published_date = timezone.now()
-             post.save()
-             return redirect('blog.views.post_d etail', pk=post.pk)
-     else:
-         form = PostForm(instance=post)
-     return render(request, 'blog/post_edit.html', {'form': form})
-```    
-
-Vypadá to téměř úplně stejně jako náš view `post_new`. Ale ne zcela. Za prvé: máme navíc parametr `pk` z adresy URL. Za druhé: získáme model `Post`, který chceme upravit, pomocí `get_object_or_404 (Post, pk = pk)`. Když potom vytvoříme formulář, předáme tento post jako parametr `instance`, když ukládáme formulář:
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Vypadá to téměř úplně stejně jako náš view `post_new`? Ale ne zcela. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST, instance=post)
-```  
+```
+
+…and when we've just opened a form with this post to edit:
 
-a když jsme otevřely formulář s tímto příspěvkem pro úpravu:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(instance=post)
-```    
-
-Ok, vyzkoušejme si, jestli to funguje! Pojďme na stránku `post_detail`. Tam by mělo být tlačítko Edit v pravém horním rohu:
+```
 
-![Tlačítko Upravit][5]
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
 
- [5]: images/edit_button2.png
+![Tlačítko Upravit](images/edit_button2.png)
 
 Po klepnutí na něj se zobrazí formulář s naším příspěvkem:
 
-![Upravit formulář][6]
-
- [6]: images/edit_form2.png
+![Upravit formulář](images/edit_form2.png)
 
-Neboj se změnit název nebo text a ulož změny!
+Feel free to change the title or the text and save the changes!
 
-Blahopřejeme! Tvoje aplikace je skoro kompletní!
+Blahopřejeme! Tvoje aplikace je čím dál více kompletní!
 
-Pokud potřebuješ více informací o Django formulářích, měla by sis přečíst dokumentaci: https://docs.djangoproject.com/en/1.8/topics/forms/
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
 
 ## Zabezpečení
 
-Být schopná vytvářet nové příspěvky pouhým klepnutím na odkaz je super! Právě teď ale každý, kdo přijde na tvé stránky, je schopen odeslat nový příspěvek na blog a to asi nechceš. Udělejme to tak, že se tlačítko zobrazí tobě, ale nezobrazí se nikomu jinému.
+Být schopna vytvářet nové příspěvky pouhým klepnutím na odkaz je super! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
 
-V `blog/templates/blog/base.html` najdeš naši `page-header`, `div` a tag `a`, který jsme tam dali dříve. Řádek by měl vypadat nějak takto:
+V `blog/templates/blog/base.html` najdeš naši `page-header` `div` a kotevní tag, který jsme tam dali dříve. Řádek by měl vypadat nějak takto:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
-```  
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Změň tag `< a >`, aby vypadal takto:
 
-Chceme přidat další `{% if %}` příkaz, který zajistí, že se odkaz zobrazí pouze pro uživatele, kteří jsou přihlášeni jako admin. Ve skutečnosti jsi jím pouze ty! Změň tag `< a >`, aby vypadal takto:
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% if user.is_authenticated %}
-     <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 {% endif %}
-```  
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. To zcela nezabrání možnosti vytvářet nové záznamy, ale je to dobrý první krok. Lepší zabezpečení vysvětlíme v rozšířené lekci.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
 
-Tento `{% if %}` způsobí, že odkaz bude odeslán do prohlížeče, pouze pokud je uživatel, který požaduje stránku, přihlášený. To zcela nezabrání možnosti vytvářet nové záznamy, ale je to dobrý první krok. Lepší zabezpečení vysvětlíme v rozšířené lekci.
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
 
-Vzhledem k tomu, že jsi pravděpodobně přihlášená, neuvidíš žádnou změnu, pokud aktualizuješ stránku. Při načtení stránky v novém prohlížeči nebo anonymním okně se odkaz již neukáže!
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
 
 ## Ještě jedna věc: čas nasadit aplikaci!
 
 Uvidíme, jestli to funguje na PythonAnywhere. Čas na další nasazení!
 
-*   Za prvé commitni nový kód a pošli ho na Github
+* Za prvé commitni nový kód a pošli ho na Github:
 
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added views to create/edit blog post inside the site."
-$ git push
-```  
+{% filename %}command-line{% endfilename %}
 
-*   Pak v [Bash konzoli PythonAnywhere][7]:
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
 
- [7]: https://www.pythonanywhere.com/consoles/
+* Pak v [Bash konzoli PythonAnywhere](https://www.pythonanywhere.com/consoles/):
 
-```
-$ cd my-first-blog
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```  
+{% filename %}command-line{% endfilename %}
 
-*   Nakonec skoč na [kartu Web][8] a klikni na **Reload**.
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
- [8]: https://www.pythonanywhere.com/web_app_setup/
+* Nakonec, skoč na [kartu Web](https://www.pythonanywhere.com/web_app_setup/) a klikni na **Reload**.
 
-A mělo by to být! Gratulujeme :)
+A mělo by to být! Gratulujeme :)
\ No newline at end of file
diff --git a/cs/django_installation/README.md b/cs/django_installation/README.md
index 1c0841641c6..df771f1898d 100755
--- a/cs/django_installation/README.md
+++ b/cs/django_installation/README.md
@@ -1,5 +1,7 @@
 # Instalace Django
 
-> **Poznámka:** Pokud ses již propracovala přes kroky instalace - můžeš jít rovnou na další kapitolu!
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
 
-{% include "/django_installation/instructions.md" %}
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/cs/django_installation/instructions.md b/cs/django_installation/instructions.md
index e8d4352485e..88dc01c000a 100755
--- a/cs/django_installation/instructions.md
+++ b/cs/django_installation/instructions.md
@@ -1,99 +1,150 @@
-> Část této kapitoly je založena na tutorialu Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
->
-> Další část této kapitoly je založena na [django-marcador tutorial](http://django-marcador.keimlink.de/) licencováno pod Creative Commons Attribution-ShareAlike 4.0, mezinárodní licenci. Ochranou známku pro Django-marcador drží Markus Zapke-Gründemann et al.
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Ochranou známku pro Django-marcador drží Markus Zapke-Gründemann et al.
 
 ## Virtuální prostředí
 
 Než začneme instalovat Django, nainstalujeme si velmi užitečný nástroj, který pomůže udržet pořádek ve vývojovém prostředí na tvém počítači. Je možné tento krok přeskočit, ale je doporučován. Začít s nejlepším možným nastavením ti ušetří spoustu starostí v budoucnosti!
 
-Takže pojďme vytvořit **virtuální prostředí** (tzv. *virtualenv*). Virtualenv bude izolovat nastavení Python/Django na základě projektu. To znamená, že změny provedené v jedné webové stránce neovlivní ostatní, které vyvíjíš. Elegantní, že?
+Takže pojď vytvořit **virtuální prostředí** (tzv. *virtualenv*). Virtualenv bude izolovat nastavení Python/Django na základě projektu. To znamená, že změny provedené v jedné webové stránce neovlivní ostatní, které vyvíjíš. Elegantní, že?
 
-Vše, co musíš udělat je jít do adresáře, ve kterém chceš vytvořit `virtualenv`; Například tvůj domovský adresář. V systému Windows by to mohlo vypadat takto `C:\Users\Name` (kde `Name` je jméno tvého uživatelského účtu).
+Vše, co musíš udělat je jít do adresáře, ve kterém chceš vytvořit `virtualenv`; Například tvůj domovský adresář. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
 
 Pro tento kurz budeme používat nový adresář `djangogirls` vytvořený v domovském adresáři:
 
-```
-mkdir djangogirls
-cd djangogirls
-```  
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
 
 Vytvoříme virtualenv, s názvem `myvenv`. Obecný příkaz bude vypadat takto:
 
-```
-python3 -m venv myvenv
-```  
+{% filename %}command-line{% endfilename %}
+
+    $ Python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
 
-### Windows
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
 
-Chceš-li vytvořit nový `virtualenv`, je potřeba otevřít konzoli (mluvili jsme o tom v dřívější kapitole - vzpomínáš?) a spusť `C:\Python34\python -m venv myvenv`. Celý příkaz bude vypadat takto:
+{% filename %}command-line{% endfilename %}
 
-```
-C:\Users\Name\djangogirls > C:\Python34\python -m venv myvenv
-```  
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
 
-kde `C:\Python34\python` je adresář, kam jsme dříve nainstalovali Python a `myvenv` je název `virtualenv`. Můžeš použít i jiné jméno, ale používej malá písmena a nepoužívej mezery, diakritiku nebo speciální znaky. Je také dobrý nápad, abys zvolila krátké jméno - budeš ho používat častokrát!
+Where `myvenv` is the name of your `virtualenv`. Můžeš použít i jiné jméno, ale používej malá písmena a nepoužívej mezery, diakritiku nebo speciální znaky. It is also good idea to keep the name short – you'll be referencing it a lot!
 
-### Linux a OS X
+<!--endsec-->
 
-Vytvoření `virtualenv` na Linux a OS X je stejně jednoduché - spusť`python3 -m venv myvenv`. Celý příkaz bude vypadat takto:
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
 
-```
-~/djangogirls$ python3 -m venv myvenv
-```  
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
 
-`myvenv` je název `virtualenv`. Můžeš použít i jiné jméno, ale drž se těchto pravidel - používej v názvech malá písmena a bez mezer. Je dobrý nápad zvolit krátké jméno - budeš ho používat častokrát!
+{% filename %}command-line{% endfilename %}
 
-> **POZNÁMKA:** Vytvoření virtuálního prostředí na Ubuntu 14.04, v současné době vyhazuje následující chybu:
->
+    $ Python3 -m venv myvenv
+    
+
+`myvenv` je název `virtualenv`. Můžeš použít i jiné jméno, ale drž se těchto pravidel - používej v názvech malá písmena a bez mezer. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
 >     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
 >     
->
+> 
 > Chceš-li se tomuto vyhnout, použij tento příkaz `virtualenv`.
->
->     ~/djangogirls$ sudo apt-get install python-virtualenv
->     ~/djangogirls$ virtualenv --python=python3.4 myvenv
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
 >     
 
+<!--endsec-->
+
 ## Práce s virtualenv
 
 Výše uvedený příkaz vytvoří adresář s názvem `myvenv` (či jiným jménem, které jsi zvolila), který obsahuje tvé virtuální prostředí (v podstatě svazek adresářů a souborů).
 
-#### Windows
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
 
 Spusť virtuální prostředí:
 
-```
-C:\Users\Name\djangogirls> myvenv\Scripts\activate
-```  
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
 
-#### Linux a OS X
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
 
 Spusť virtuální prostředí:
 
-```
-~/djangogirls$ source myvenv/bin/activate
-```  
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
 
 Nezapomeň nahradit `myvenv` tvým zvoleným jménem `virtualenv`!
 
 > **Poznámka:** někdy příkaz `source` nemusí být k dispozici. V těchto případech, zkus raději:
->
->     ~/djangogirls$ . myvenv/bin/activate
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
 >     
 
-Že je `virtualenv` spuštěné, poznáš pokud vidíš výzvu konzole vypadající takto:
-
-```
-(myvenv) C:\Users\Name\djangogirls>
-```  
-
-nebo:
-
-```
-(myvenv) ~/djangogirls$
-```  
+<!--endsec-->
 
-Upozornění předpona `(myvenv)` se zobrazí!
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
 
 Pracuješ-li ve virtuálním prostředí, `python` bude automaticky odkazovat na správnou verzi, takže můžeš použít `python` místo `python3`.
 
@@ -101,22 +152,50 @@ OK máme všechny důležité závislosti na místě a konečně můžeme nainst
 
 ## Instalace Django
 
-Máš své `virtualenv` nastartované a můžeš nainstalovat Django pomocí příkazu `pip`. V konzoli, spusť `pip install django == 1.8` (<0>Poznámka:</0> , používáme zde dvojité rovnítko: `==`).
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
 
-```
-(myvenv) ~$ pip install django==1.8
-Downloading/unpacking django==1.8
-Installing collected packages: django
-Successfully installed django
-Cleaning up...
-```  
+{% filename %}command-line{% endfilename %}
 
-v systému Windows
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
 
-> Pokud se ti ukáže chyba při volání pip na platformě Windows, zkontroluj prosím, zda tvoje cesta k projektu neobsahuje mezery, diakritiku a speciální znaky (tj. `C:\Users\User Name\djangogirls`). Pokud ano zvaž přesunutí do jiného místa bez mezer, diakritiky a speciálních znaků (návrh je: `C:\djangogirls`). Po přesunutí opakuj výše uvedený příkaz.
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
 
-na Linuxu
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
 
 > Pokud se zobrazí chyba při volání pip na Ubuntu 12.04, prosím zkus spustit `python -m pip install -U --force-reinstall pip` k opravě instalace pip ve virtualenv.
 
-A je to! Teď jsi (konečně) připravena k vytvoření aplikace Django!
+<!--endsec-->
+
+A je to! Teď jsi (konečně) připravena k vytvoření aplikace Django!
\ No newline at end of file
diff --git a/cs/django_models/README.md b/cs/django_models/README.md
index 44977a6ed93..99eff380670 100755
--- a/cs/django_models/README.md
+++ b/cs/django_models/README.md
@@ -1,113 +1,122 @@
 # Django modely
 
-Nyní chceme vytvořit něco, co bude ukládat všechny příspěvky na náš blog. Ale abychom to mohly udělat, musíme si nejdříve říct něco o `objektech`.
+Nyní chceme vytvořit něco, co bude ukládat všechny příspěvky na našem blogu. Ale aby jsme to mohli udělat, musíme si nejdříve říct něco o `objektech`.
 
 ## Objekty
 
-V programování se používá koncept zvaný `objektově orientované programování`. Tato myšlenka předpokládá, že místo psaní všeho jako nudný sled programovacích instrukcí můžeme modelovat věci a definovat, jak komunikují mezi sebou navzájem.
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
 
 Co tedy je objekt? Je to kolekce vlastností a činností. Zní to divně, ale dáme ti příklad.
 
-Pokud chceme modelovat kočku, vytvoříme objekt `kočka`, který má nějaké vlastnosti, například `barva`, `věk`, `nálada` (ta je dobrá, špatná, ospalá ;)), `vlastník` (který je objektem `osoba` nebo je možný případ zatoulané kočky, kde bude tato vlastnost prázdná).
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
 
-`Kočka` má také některé akce: `předení`, `škrábání` nebo `žraní` (v němž dáváme kočce nějaké `kočičí granule`, které by mohlo být samostatný objekt s vlastnostmi, například `chuť`).
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
 
-```
-Cat
---------
-color
-age
-mood
-owner
-purr()
-scratch()
-feed(cat_food)
-
-
-CatFood
---------
-taste
-```  
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
 
 Základní představa je popsat skutečné věci v kódu vlastnostmi (nazývané `vlastnosti objektu/object properties`) a akcemi (nazývané `metody/methods`).
 
-Jak tedy bude vypadat model blogu?
+Jak tedy bude vypadat model blogu? Chceme vytvořit blog, ne?
 
 Musíme odpovědět na otázku: Co je blog post/příspěvek? Jaké by měl mít vlastnosti?
 
-Určitě budeme v naše blogu potřebovat nějaký text s jeho obsahem a titulkem, že? Bylo by také dobré vědět, kdo příspěvek napsal, takže potřebujeme autora. Nakonec také chceme vědět, kdy byl příspěvek vytvořen a publikován.
+Určitě budeme v naše blogu potřebovat nějaký text s jeho obsahem a titulkem, že? It would be also nice to know who wrote it – so we need an author. Nakonec také chceme vědět, kdy byl příspěvek vytvořen a publikován.
 
-```
-Post
---------
-title
-text
-author
-created_date
-published_date
-```  
+    Post 
+    -------- 
+    title 
+    text 
+    author 
+    created_date 
+    published_date
+    
 
-Jaký druh věcí můžeme s příspěvkem dělat? Bylo by hezké mít nějakou `metodu`, která publikuje příspěvek.
+Jaký druh věcí můžeme s příspěvkem dělat? Bylo by hezké mít nějakou `metodu`, která publikuje příspěvek, že ano?
 
 Takže budeme potřebovat metodu `publish`.
 
-Vzhledem k tomu, že už víme, čeho chceme dosáhnout, můžeme začít modelování v Djangu!
+Vzhledem k tomu, že už víme, co chceme dosáhnout, můžeme začít modelování v Django!
 
 ## Django model
 
-Nyní víme, jaký objekt chceme vytvořit, takže můžeme přistoupit k tvorbě Django modelu pro náš příspěvek v blogu.
+Nyní víme jaký objekt chceme vytvořit, tak můžeme přistoupit k tvorbě Django modelu pro náš příspěvek v blogu.
 
-Model v Django je zvláštní druh objektu - který je uložen v `databázi`. Databáze je soubor dat. Je to místo, kam budeš ukládat informace o uživatelích a tvých příspěvcích v blogu, atd. Budeme používat SQLite databázi k ukládání dat. To je výchozí databázový adaptér v Djangu – to nám bude nyní stačit.
+A model in Django is a special kind of object – it is saved in the `database`. Databáze je soubor dat. Je to místo, ve kterém budeš ukládat informace o uživatelích a tvých příspěvcích v blogu, atd. Budeme používat SQLite databázi k ukládání dat. This is the default Django database adapter – it'll be enough for us right now.
 
 Model v databázi si lze představit jako tabulku s řádky (data) a sloupci (údaje).
 
 ### Vytvoření aplikace
 
-Abychom udržely pořádek, vytvoříme si samostatnou aplikaci uvnitř našeho projektu. Je velmi příjemné mít všechno zorganizované od samého začátku. Chceš-li vytvořit novou aplikaci, je třeba spustit následující příkaz v konzoli (z `djangogirls` adresáře, kde je `manage.py` soubor):
+Abychom udrželi pořádek, vytvoříme si samostatnou aplikaci uvnitř našeho projektu. Je velmi příjemné mít všechno zorganizované od samého začátku. Chceš-li vytvořit novou aplikaci, je třeba spustit následující příkaz v konzoli (z `djangogirls` adresáře, kde je `manage.py` soubor):
 
-```
-(myvenv) ~/djangogirls$ python manage.py startapp blog
-```  
+{% filename %}Mac OS X and Linux:{% endfilename %}
 
-Zjistíš, že nový adresář `blog` nyní obsahuje řadu souborů. Adresáře a soubory v našem projektu by měly vypadat následovně:
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
 
-```
-djangogirls
-├── mysite
-|       __init__.py
-|       settings.py
-|       urls.py
-|       wsgi.py
-├── manage.py
-└── blog
-    ├── migrations
-    |       __init__.py
-    ├── __init__.py
-    ├── admin.py
-    ├── models.py
-    ├── tests.py
-    └── views.py
-```    
-
-Po vytvoření aplikace musíš také Djangu říct, že by ji měl použít. Uděláme to v souboru `mysite/settings.py`. Musíme najít `INSTALLED_APPS` a přidat řádek, který bude obsahovat `"blog",` `)`. Takže konečná konfigurace by měla vypadat takto:
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-INSTALLED_APPS = (
-     'django.contrib.admin',
-     'django.contrib.auth',
-     'django.contrib.contenttypes',
-     'django.contrib.sessions',
-     'django.contrib.messages',
-     'django.contrib.staticfiles',
-     'blog',
-)
-```  
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
 
 ### Vytvoření modelu pro blog post
 
-V souboru `blog/models.py` budeme definovat všechny objekty nazývané `modely` - na tomto místě budeme definovat náš blog post.
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
 
-Otevři `blog/models.py`, odstraň vše, co v něm je, a vlož následující kód:
+{% filename %}blog/models.py{% endfilename %}
 
 ```python
 from django.db import models
@@ -115,7 +124,7 @@ from django.utils import timezone
 
 
 class Post(models.Model):
-    author = models.ForeignKey('auth.User')
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
     created_date = models.DateTimeField(
@@ -131,53 +140,60 @@ class Post(models.Model):
         return self.title
 ```
 
-> Dvakrát si zkontroluj, že jsi použila dva znaky podtržítko(`_`) na každé straně `str`. Tato konvence se v Pythonu používá často. Někdy je také nazýváme "dunder" (zkratka pro "Double-UNDERscore").
+> Double-check that you use two underscore characters (`_`) on each side of `str`. Tato konvence se v Pythonu používá často. Někdy je také nazýváme "dunder" (zktratka pro "Double-UNDERscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
 
-Vypadá to děsivě, že? Ale žádný strach, vysvětlíme ti, co tyto řádky znamenají!
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
 
-Všechny řádky začínající `from` nebo `import` jsou řádky, které přidávají některé kousky z jiných souborů. Takže namísto kopírování a vkládání stejných věcí v každém souboru, můžeš zahrnout některé části s `from... import...`.
+`class Post(models.Model):` – this line defines our model (it is an `object`).
 
-`class Post(models.Model):` - Tento řádek definuje náš model (Jedná se o `objekt`).
+- `class` je speciální klíčové slovo, které říká, že definujeme objekt.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models. Model` znamená, že Post je Django Model, takže Django ví, že by to mělo být uloženo v databázi.
 
-*   `class` je speciální klíčové slovo, které říká, že definujeme objekt.
-*   `Post` je jméno našeho modelu, můžeme mu dát jiné jméno (ale musíme se vyvarovat speciálních znaků a bílých znaků). Název třídy vždy začínej velkým písmenem.
-*   `models. Model` znamená, že Post je Django Model, takže Django ví, že by to mělo být uloženo v databázi.
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
 
-Nyní definujeme vlastnosti, mluvily jsme o: `title`, `text`, `created_date`, `published_date` a `autor`. To uděláš tak, že definuješ typ každého pole (Je to text? Číslo? Datum? Vztah k jinému objektu, například uživateli?).
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
 
-*   `models. CharField` - takto definuješ text s omezeným počtem znaků.
-*   `models. TextField` - toto použiješ na dlouhý text bez omezení. To zní ideálně pro obsah blog post, ne?
-*   `models. DateTimeField` - definuje datum a čas.
-*   `models. ForeignKey` - definuje odkaz do jiného modelu.
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
 
-Nebudeme vysvětlovat každý kousek kódu, vzhledem k tomu, že by trvalo příliš dlouho. Měla bys se podívat do Django dokumentace, pokud se chceš dozvědět víc o polích modelu a jak definovat jiné věci než výše uvedené (https://docs.djangoproject.com/en/1.8/ref/models/fields/#field-types).
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
 
-Co je `def publish(self):`? Je to `publish` metoda, o které jsme mluvili dříve. `def` znamená, že definuješ funkci/metodu, a `publish` je název metody. Název metody můžeš změnit, pokud chceš. Pravidlo pro pojmenovávání je, že používáme malá písmena a podtržítka místo mezer. Například metoda, která vypočítá průměrnou cenu, se bude jmenovat `calculate_average_price`.
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
 
-Metody často něco `vrací/return`. Zde je příklad metoda `__str__`. V tomto případě, když zavoláme metodu `__str__()`, dostaneme text (**řetězec/string**) s názvem Postu.
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
 
-Pokud ti něco stále ještě není jasné o modelech, neváhej se zeptat svého kouče! Víme, že je to složité, zvláště, když se dozvíte, co jsou objekty a funkce takto naráz. Doufejme, že to je nyní pro tebe trochu méně magické!
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
 
 ### Vytvoření tabulek pro modely v databázi
 
-V posledním kroku přidáš náš nový model do databáze. Nejprve musíme dát Djangu vědět, že mám nějaké změny v modelu (které jsme právě vytvořily!). Napiš `Python manage.py makemigrations blog`. Celý příkaz bude vypadat takto:
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
 
-```
-(myvenv) ~/djangogirls$ python manage.py makemigrations blog
-Migrations for 'blog':
-  0001_initial.py:
-  - Create model Post
-```  
+{% filename %}command-line{% endfilename %}
 
-Django pro nás připravil soubor migrace, který budeme muset aplikovat na naši databázi. Napiš `Python manage.py migrate blog` a výstup by měl vypadat takto:
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
 
-```
-(myvenv) ~/djangogirls$ python manage.py migrate blog
-Operations to perform:
-  Apply all migrations: blog
-Running migrations:
-  Rendering model states... DONE
-  Applying blog.0001_initial... OK
-```  
-
-Hurá! Náš Post model je nyní v naší databázi! Bylo by hezké vidět ho v akci, že ano? Přeskoč na další kapitolu a podívej se, jak vypadá tvůj příspěvek!
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/cs/django_orm/README.md b/cs/django_orm/README.md
index 5f8e383fea2..eabef7672a2 100755
--- a/cs/django_orm/README.md
+++ b/cs/django_orm/README.md
@@ -1,180 +1,218 @@
 # Django ORM a QuerySets
 
-V této kapitole se naučíš, jak se Django spojuje s databází a jak do ní ukládá data. Pojďme na to!
+V této kapitole se naučíš jak se Django spojuje s databází a jak do ní ukládá data. Pojďme na to!
 
 ## Co je QuerySet?
 
-QuerySet je v podstatě seznam objektů daného modelu. QuerySet ti umožňuje číst data z databáze, filtrovat je a řadit je.
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
 
-Je snazší naučit se to na příkladu. Pojďme to zkusit.
+Je snazší naučit se to na příkladu. Pojďme to zkusit, můžeme?
 
 ## Django shell
 
-Otevři svou lokální konzoli (ne na Python Anywhere) a napiš tento příkaz:
+Otevři svou lokání konzoli (ne na Python Anywhere) a napiš tento příkaz:
 
-```
-(myvenv) ~/djangogirls$ python manage.py shell
-```  
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
 
 Mělo by to mít takovýto efekt:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 (InteractiveConsole)
 >>>
-```  
+```
 
-Nyní jsi v Django interaktivní konzoli. Je to stejné jako Python konzole, ale s nějakými přídavnými Django kouzly :). Tady můžeš samozřejmě používat i všechny Python příkazy.
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
 
 ### Všechny objekty
 
 Pojďme zkusit zobrazit všechny naše příspěvky. To můžeš udělat následujícím příkazem:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.all()
 Traceback (most recent call last):
       File "<console>", line 1, in <module>
 NameError: name 'Post' is not defined
-```  
+```
 
-Ale ne! Ukázala se chybová hláška. Říká nám, že tu není žádný Post objekt (příspěvek). To je správně – zapomněly jsme je importovat!
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> from blog.models import Post
-```  
+```
 
-Tohle je jednoduché: importujeme model `Post` z `blog.models`. Pojďme znovu zkusit zobrazit všechny příspěvky:
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.all()
-<QuerySet [<Post: titulek mého prvního příspěvku>, <Post: titulky dalších příspěvků>]>
-```  
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
 
-To je seznam příspěvků, které jsme dříve vytvořily pomocí Django administrátorského rozhraní. Teď nicméně chceme vytvořit příspěvky použitím Pythonu, tak jak na to?
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
 
 ### Vytvoř objekt
 
 Takhle vytvoříš nový Post objekt v databázi:
 
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=ja, title='titulek', text='Test')
 ```
->>> Post.objects.create(author=me, title='titulek', text='Test')
-```  
 
-Ale chybí nám tu jedna ingredience: proměnná `me`. Jako autorku potřebujeme vložit instanci `User` (tj. "uživatelka") modelu. Jak to uděláme?
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
 
 Nejdříve pojďme importovat User model:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> from django.contrib.auth.models import User
-```  
+```
 
 Jaké uživatele máme v naší databázi? Zkus tohle:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> User.objects.all()
 <QuerySet [<User: ola>]>
-```  
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
 
-Tohle je superuser, kterého jsme vytvořily dříve! Pojďme si teď vzít instanci tohoto uživatele:
+{% filename %}command-line{% endfilename %}
 
 ```python
-me = User.objects.get(username='ola')
+>>> me = User.objects.get(username='ola')
 ```
 
-Jak vidíš, dostaly (tj. `get`) jsme uživatele (tj. `user`) s uživatelským jménem (tj. `username`) 'ola'. Pěkný! Samozřejmě ty si to musíš upravit na své jméno.
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
 
 Teď můžeme konečně vytvořit příspěvek:
 
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=ja, title='titulek', text='Test')
 ```
->>> Post.objects.create(author=me, title='titulek', text='Test')
-```  
 
-Hurá! Chceš se podívat, jestli to fungovalo?
+Hurá! Chceš se podívat jestli to fungovalo?
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.all()
 <QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
-```  
+```
 
 A je to tu, další příspěvek v seznamu!
 
 ### Přidej více příspěvků
 
-Teď si můžeš trochu pohrát a přidat více příspěvků, abys viděla, jak to funguje. Přidej 2 až 3 nové příspěvky a pusť se do další části.
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
 
 ### Filtrování objektů
 
-Důležitá součást QuerySetů je možnost je filtrovat. Řekněme, že chceme najít všechny příspěvky, jejichž autorem je uživatel (user) ola. V `Post.objects.all()` použijeme `filter` místo `all`. V závorkách stanovíme podmínky, které musí příspěvek splňovat, aby skončil v našem querysetu. V našem případě je to tak, že `author` se rovná `ja`. Způsob, jakým se to v Django zapisuje, je: `author=ja`. Teď náš kus kódu vypadá takhle:
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. V `Post.objects.all()` použijeme `filter` místo `all`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Teď náš kus kódu vypadá takhle:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.filter(author=ja)
 [<Post: titulek>, <Post: Příspěvek číslo 2>, <Post: Můj 3. příspěvek!>, <Post: 4. titulek příspěvku>]
-```  
+```
 
-Nebo možná chceme vidět všechny příspěvky, jež mají slovo 'titulek' v poli `title`?
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.filter(title__contains='titulek')
 [<Post: titulek>, <Post: 4. titulek příspěvku>]
-```  
+```
 
-> **Poznámka** Mezi `title` a `contains` jsou dvě podtržítka (`_`). Django ORM používá tuto syntaxi k rozlišení názvů ("title") a operací nebo filterů ("contains"). Pokud použiješ pouze jedno podtržítko, dostaneš chybovou hlášku "FieldError: Cannot resolve keyword title_contains".
+> **Poznámka** Mezi `title` a `contains` jsou dvě podtržítka (`_`). Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
 
-Také můžeš získat seznam všech publikovaných příspěvků. Uděláme to vyfiltrováním všech příspěvků, které mají nastavené `published_date` na nějaké uplynulé datum:
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> from django.utils import timezone
 >>> Post.objects.filter(published_date__lte=timezone.now())
 []
 ```
 
-Bohužel příspěvek, který jsme přidali pomocí Python konzole, ještě není publikován. To můžeme změnit! Nejdřív vezmeme instanci příspěvku, který chceme publikovat:
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> post = Post.objects.get(title="Sample title")
-```  
+```
 
-A ten publikujeme pomocí naší metody `publish`!
+A ten publikujeme pomocí naší metody `publish`:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> post.publish()
-```  
+```
 
-Teď se znovu pokus získat seznam publikovaných příspěvků (3krát zmáčkni šipku nahoru a zmáčkni `enter`):
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.filter(published_date__lte=timezone.now())
 [<Post: Sample title>]
-```  
+```
 
 ### Řazení objektů
 
 QuerySety ti také umožňují seřadit seznam objektů. Pojďme je zkusit seřadit podle data vytvoření (`created_date`):
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.order_by('created_date')
 [<Post: titulek>, <Post: Příspěvek číslo 2>, <Post: Můj 3. příspěvek!>, <Post: 4. titulek příspěvku>]
-```  
+```
 
 Můžeme je také seřadit obráceně přidáním `-` na začátek:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.order_by('-created_date')
 [<Post: 4. titulek příspěvku>,  <Post: Můj 3. příspěvek!>, <Post: Příspěvek číslo 2>, <Post: titulek>]
-```  
+```
 
 ### Řetězení QuerySetů
 
 QuerySety můžeš také kombinovat dohromady pomocí **řetězení**:
 
-```
->>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-```  
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
 
-Je to mocný nástroj, který ti umožňuje psát docela komplexní query.
+Je to mocný nástroj který ti umožňuje psát docela komplexní query.
 
-Cool! Teď jsi připravená na další část! Pro zavření shell konzole zadej toto:
+Cool! Teď jsi připravená na další část! Pro zavření shell konzoli zadej toto:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> exit()
 $
-```
+```
\ No newline at end of file
diff --git a/cs/django_start_project/README.md b/cs/django_start_project/README.md
index 89cab58e432..16a51ff3bc0 100755
--- a/cs/django_start_project/README.md
+++ b/cs/django_start_project/README.md
@@ -1,84 +1,123 @@
 # Tvůj první Django projekt!
 
-> Část této kapitoly je založena na kurzu Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
->
-> Části této kapitoly jsou založeny na [django-marcador tutorial][1] licencováno pod Creative Commons Attribution-ShareAlike 4.0 mezinárodní licencí. Ochranou známku pro Django-marcador drží Markus Zapke-Gründemann et al.
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Ochranou známku pro Django-marcador drží Markus Zapke-Gründemann et al.
 
- [1]: http://django-marcador.keimlink.de/
+We're going to create a small blog!
 
-Chceme vytvořit jednoduchý blog!
+Prvním krokem je začít s novým projektem Django. V podstatě to znamená, že budeš spouštět některé skripty z Django, které vytvoří kostru Django projektu pro tebe. To je jen halda adresářů a souborů, které budeme později používat.
 
-Prvním krokem je začít s novým projektem Django. V podstatě to znamená, že budeš spouštět některé skripty z Djanga, které vytvoří kostru Django projektu pro tebe. To je jen halda adresářů a souborů, které budeme později používat.
+Názvy některých souborů a adresářů jsou pro Django velmi důležité. Neměla by jsi přejmenovávat soubory, které vytvoříme. Přesouvat je na jiné místo také není dobrý nápad. V Django je třeba zachovat určitou strukturu, aby jsme mohli najít důležité věci.
 
-Názvy některých souborů a adresářů jsou pro Django velmi důležité. Neměla bys přejmenovávat soubory, které vytvoříme. Přesouvat je na jiné místo také není dobrý nápad. V Django je třeba zachovat určitou strukturu, abychom mohli najít důležité věci.
+> Nezapomeň spouštět vše ve svém virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. Jak se to dělá jsme vysvětlili v kapitole **Django instalace** v části **práce s virtualenv**. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
 
-> Nezapomeň spouštět vše ve svém virtualenv. Pokud nevidíš předponu `(myvenv)` ve své konzoli, je potřeba aktivovat virtualenv. Jak se to dělá jsme si vysvětlily v kapitole **Django instalace** v části **práce s virtualenv**. Napiš `myvenv\Scripts\activate` na systému Windows nebo `source myvenv/bin/activate` na systému Mac OS / Linux.
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
 
-V MacOS a Linux konzoli bys měla spustit následující příkaz; **nezapomeň přidat tečku `.` na konci**:
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
 
-```
-(myvenv) ~/djangogirls$ django-admin startproject mysite .
-```  
+{% filename %}command-line{% endfilename %}
 
-V systému Windows; **nezapomeň přidat tečku `.` na konci**:
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
 
-```
-(myvenv) C:\Users\Name\djangogirls> django-admin.py startproject mysite .
-```  
+> Tečka `.` je zásadní, protože říká že skript pro instalaci Django se má provést v aktuálním adresáři (pro který je tečka `.` zkratkou - odkazem).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
 
-> Tečka `.` je zásadní, protože říká, že skript pro instalaci Django se má provést v aktuálním adresáři (pro který je tečka `.` zkratkou - odkazem)
->
-> **Poznámka:** Při zadávání těchto příkazů nezapomeň zadat pouze část, která začíná `django admin` nebo `django-admin.py`. `(myvenv) ~/djangogirls$` a `(myvenv) C:\Users\Name\djangogirls>` – tyto části jsou jen příklad cesty, kam budeš zadávat své příkazy.
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Tečka `.` je zásadní, protože říká že skript pro instalaci Django se má provést v aktuálním adresáři (pro který je tečka `.` zkratkou - odkazem).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
 
 `django-admin.py` je skript, který za tebe vytvoří adresáře a soubory. Nyní bys měla mít adresářovou strukturu, která vypadá následovně:
 
-```
-djangogirls
-├───manage.py
-└───mysite
-        settings.py
-        urls.py
-        wsgi.py
-        __init__.py
-```  
+    djangogirls
+    ├───manage.py 
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
 
-`manage.py` je skript, který slouží k řízení tvé webové stránky. S ním bude možné kromě jiného spustit webový server na tvém počítači bez instalovaní čehokoli jiného.
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
 
 Soubor `settings.py` obsahuje konfiguraci tvé webové stránky.
 
-Pamatuješ, jak jsme mluvili o pošťákovi, který zjišťuje kam doručit dopis? Soubor `urls.py` obsahuje seznam vzorů, které používá `urlresolver`.
+Pamatuješ, jak jsme mluvili o pošťákovi který zjišťuje kam doručit dopis? Soubor `urls.py` obsahuje seznam vzorů, které používá `urlresolver`.
 
-Prozatím budeme ignorovat ostatní soubory - nechceme v nich nic měnit. Jediná věc, na kterou nezapomeň, je, že žádný ze souborů se nemaže!
+Prozatím budeme ignorovat ostatní soubory - nechceme v nich nic měnit. Jediná věc, kterou nezapomeň, žádný ze souborů se nemaže!
 
 ## Změna nastavení
 
 Pojďme udělat nějaké změny v `mysite/settings.py`. Otevři soubor pomocí editoru kódu, který jsi si nainstalovala dříve.
 
-Bylo by hezké mít na svých stránkách správný čas. Přejdi na [wikipedia timezones list][2] a zkopíruj příslušné časové pásmo (TZ). (např. `Europe/Prague`)
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+Bylo by hezké mít správný čas na našich stránkách. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
 
- [2]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
 
-V settings.py najdi řádek, který obsahuje `TIME_ZONE`, a uprav jej tak, aby obsahoval tvoje vlastní časové pásmo:
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-TIME_ZONE = 'Europe/Prague'
-```  
+TIME_ZONE = 'Europe/Berlin'
+```
 
-Uprav "Europe/Prague" podle potřeby.
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
 
-Budeme také muset přidat cestu pro statické soubory (o statických souborech a CSS se dozvíme dále v tutorialu). Přejdi na *konec* souboru a pod položkou `STATIC_URL`, přidej nový název `STATIC_ROOT`:
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 STATIC_URL = '/static/'
 STATIC_ROOT = os.path.join(BASE_DIR, 'static')
-```  
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
-## Nastavení databáze
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
 
 Existuje mnoho různých databázových softwarů, které mohou ukládat data pro tvůj web. My budeme používat výchozí `sqlite3`.
 
 Ta je již nastavena v konfiguračním souboru `mysite/settings.py`:
 
+{% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 DATABASES = {
     'default': {
@@ -86,58 +125,77 @@ DATABASES = {
         'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
     }
 }
-```  
+```
 
-Chceš-li vytvořit databázi pro náš blog, spusť následující příkaz v konzoli: `python manage.py migrate` (pro spuštění musíš být v adresáři `djangogirls`, který obsahuje soubor `manage.py`). Pokud vše půjde dobře, měla bys uvidět něco takového:
+Chceš-li vytvořit databázi pro náš blog, spusť následující příkaz v konzoli: `python manage.py migrate` (pro spuštění musíš být v adresáři `djangogirls`, který obsahuje soubor `manage.py`). Pokud vše půjde dobře, měla bys vidět něco takového:
 
-```
-(myvenv) ~/djangogirls$ python manage.py migrate
-Operations to perform:
-  Synchronize unmigrated apps: messages, staticfiles
-  Apply all migrations: contenttypes, sessions, admin, auth
-Synchronizing apps without migrations:
-   Creating tables...
-      Running deferred SQL...
-   Installing custom SQL...
-Running migrations:
-  Rendering model states... DONE   Applying contenttypes.0001_initial... OK
-  Applying auth.0001_initial... OK
-  Applying admin.0001_initial... OK
-   Applying contenttypes.0002_remove_content_type_name... OK
-   Applying auth.0002_alter_permission_name_max_length... OK
-   Applying auth.0003_alter_user_email_max_length... OK
-   Applying auth.0004_alter_user_username_opts... OK
-   Applying auth.0005_alter_user_last_login_null... OK
-   Applying auth.0006_require_contenttypes_0002... OK
-  Applying sessions.0001_initial... OK
-```  
-
-A máme hotovo! Čas spustit webový server a měla bys vidět naše fungující webové stránky!
-
-Pro spuštění musíš být v adresáři, který obsahuje soubor `manage.py` (adresář `djangogirls`). V konzoli spustíš webový server zadáním `python manage.py runserver`:
+{% filename %}command-line{% endfilename %}
 
-```
-(myvenv) ~/djangogirls$ python manage.py runserver
-```  
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE   Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+       Applying contenttypes.0002_remove_content_type_name... OK
+       Applying auth.0002_alter_permission_name_max_length... OK
+       Applying auth.0003_alter_user_email_max_length... OK
+       Applying auth.0004_alter_user_username_opts... OK
+       Applying auth.0005_alter_user_last_login_null... OK
+       Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+A máme hotovo! Čas spustit webový server a měla by jsi vidět naše fungující webové stránky!
+
+## Starting the web server
+
+Pro spuštění musíš být v adresáři, který obsahuje soubor `manage.py` (adresář `djangogirls`). V konzoli spustíš webový server zadáním `pythonu manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
 
 Pokud pracuješ v systému Windows a nezdaří se to s chybovou zprávou `UnicodeDecodeError`, použij tento příkaz:
 
-```
-(myvenv) ~/djangogirls$ python manage.py runserver 0:8000
-```  
+{% filename %}command-line{% endfilename %}
 
-Nyní vše, co musíš udělat, je zkontrolovat, zda naše webové stránky běží - otevři svůj prohlížeč (Firefox, Chrome, Safari, Internet Explorer nebo co používáš) a zadej adresu:
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
 
-```
-http://127.0.0.1:8000/
-```  
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
 
-Webový server ti znemožní použít příkazovou řádkou, dokud jej nezastavíš. Chceš-li zadat další příkazy, spusť nové okno terminálu a aktivuj svůj virtualenv. Chceš-li zastavit server WWW, přepni se zpět do okna, ve kterém je spuštěn, a kombinací kláves CTRL + C - tlačítka CTRL a C, které stiskneš dohromady (na Windows, možná musíš stisknout kombinaci kláves Ctrl + Break) – ukončíš proces.
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
 
 Blahopřejeme! Právě jsi vytvořila svůj první web a spustila jej pomocí webového serveru! Není to super?
 
-![Fungovalo to!][3]
+![Fungovalo to!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
 
- [3]: images/it_worked2.png
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
 
-Připravena pro další krok? Je tu čas k vytvoření nějakého obsahu!
+Připravena pro další krok? Je tu čas k vytvoření nějakého obsahu!
\ No newline at end of file
diff --git a/cs/django_templates/README.md b/cs/django_templates/README.md
index 187fa29351d..fa3aaaefd44 100755
--- a/cs/django_templates/README.md
+++ b/cs/django_templates/README.md
@@ -1,50 +1,54 @@
 # Django šablony
 
-Je čas zobrazit nějaká data! Django nám k tomuto účelu poskytuje užitečné vestavěné **šablonové tagy**.
+Je čas zobrazit nějaká data! Django nám k tomuto účelu poskytuje užitečné, vestavěné **šablonové tagy**.
 
 ## Co jsou šablonové tagy?
 
-V HTML ve skutečnosti nemůžeš použít Python kód, protože prohlížeče mu nerozumí. Znají pouze HTML. Víme, že HTML je spíše statické, zatímco Python je mnohem dynamičtější.
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
 
-**Django šablonové tagy** nám umožňují přenést věci podobné Pythonu do HTML, abys mohla postavit dynamickou webovou stránku rychleji a snadněji.
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
 ## Zobraz šablonu se seznamem příspěvků
 
-V předchozí kapitole jsme daly naší šabloně seznam příspěvků v proměnné `posts`. Teď to zobrazíme v HTML.
+V předchozí kapitole jsme dali naší šabloně seznam příspěvků v proměnné `posts`. Teď to zobrazíme v HTML.
 
 V Django šabloně se proměnná vypíše pomocí dvojitých složených závorek s názvem proměnné uvnitř. Takhle:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {{ posts }}
-```  
-
-Zkus to ve své šabloně `blog/templates/blog/post_list.html`. Nahraď vše od druhého `<div>` do třetího `</div>` řádkou `{{ posts }}`. Ulož soubor a obnov stránku, aby sis prohlédla výsledek:
+```
 
-![Figure 13.1][1]
+Zkus to ve své šabloně `blog/templates/blog/post_list.html`. Nahraď vše od druhého `<div>` do třetího `</div>` řádkou `{{ posts }}`. Ulož soubor a obnov stránku, abys viděla výsledek:
 
- [1]: images/step1.png
+![Figure 13.1](images/step1.png)
 
 Jak vidíš, dostali jsme toto:
 
-```
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
 <QuerySet [<Post: My second post>, <Post: My first post>]>
-```  
+```
 
 To znamená, že to Django chápe jako seznam objektů. Vzpomínáš si z kapitoly **Úvod do pythonu**, jak můžeme zobrazit seznam? Ano, pomocí for smyček! V Django šabloně je použiješ takto:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     {{ post }}
 {% endfor %}
-```  
+```
 
 Zkus udělat tohle ve své šabloně.
 
-![Figure 13.2][2]
+![Figure 13.2](images/step2.png)
 
- [2]: images/step2.png
+Funguje to! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. Můžeš smíchat HTML tagy se šablonovými. Naše `body` bude vypadat takhle:
 
-Funguje to! Ale chceme, aby se zobrazovaly jako ty statické příspěvky, které jsme vytvořili dříve v kapitole **Úvod do HTML**. Můžeš smíchat HTML tagy se šablonovými. Naše `body` bude vypadat takhle:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <div>
@@ -58,51 +62,45 @@ Funguje to! Ale chceme, aby se zobrazovaly jako ty statické příspěvky, kter
         <p>{{ post.text|linebreaksbr }}</p>
     </div>
 {% endfor %}
-```  
-
-{% raw %}Všechno, co dáš mezi `{% for %}` a `{% endfor %}`, se zopakuje pro každý objekt v seznamu. Obnov svou stránku:{% endraw %}
+```
 
-![Figure 13.3][3]
+{% raw %}Všechno co dáš mezi `{% for %}` a `{% endfor %}` se zopakuje pro každý objekt v seznamu. Obnov svou stránku:{% endraw %}
 
- [3]: images/step3.png
+![Figure 13.3](images/step3.png)
 
-Všimla sis, že jsme tentokrát použily lehce odlišnou notaci (`{{ post.title }}` nebo `{{ post.text }}`)? Přistupujeme k datům v každém poli definovaném v našem `Post` modelu. Dále `|linebreaksbr` posílá text příspěvku filtrem, aby převedl zalomení řádků na odstavce.
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? Přistupujeme k datům v každém poli defnovaném v našem `Post` modelu. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
 
 ## Ještě jedna věc
 
-Bylo by dobré vidět, jestli tvá webová stránka bude stále fungovat i na webu, že? Pojďme zkusit další nasazení/deploy na PythonAnywhere. Tady je rekapitulace postupu...
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
 
-*   Nejdřív hoď svůj kód na Github
+* Nejdřív hoď svůj kód na Github
 
-```
-$ git status
-[...]
-$ git add --all .
-$ git status
-[...]
-$ git commit -m "Modified templates to display posts from database."
-[...]
-$ git push
-```  
-
-*   Pak se přihlaš do [PythonAnywhere][4] a jdi do **Bash konzole** (nebo vytvoř novou) a zadej:
+{% filename %}command-line{% endfilename %}
 
- [4]: https://www.pythonanywhere.com/consoles/
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
 
-```
-$ cd my-first-blog
-$ git pull
-[...]
-```  
+* Pak se přihlaš do [PythonAnywhere](https://www.pythonanywhere.com/consoles/) s jdi do **Bash konzole** (nebo vytvoř novou) a zadej:
 
-*   Nakonec jdi na záložku [Web][5] a klikni na **Reload**. Tvá stránka by měla být aktuální!
+{% filename %}PythonAnywhere command-line{% endfilename %}
 
- [5]: https://www.pythonanywhere.com/web_app_setup/
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
-Gratulujeme! Teď zkus přidat nové příspěvky ve tvém Django administračním rozhraní (nezapomeň přidat published_date!), potom obnov stránku a podívej se, jestli se nové příspěvky zobrazí.
+* Konečně, jdi na záložku [Web](https://www.pythonanywhere.com/web_app_setup/) a klikni na **Reload**. Tvá stránka by měla být aktuální! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. Databáze v místním počítači a Python Anywhere není synchronizována.
 
-Funguje to dokonale? Jsme hrdí! Odpočiň si na chvíli od počítače, zasloužíš si přestávku :)
+Gratulujeme! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
 
-![Figure 13.4][6]
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
 
- [6]: images/donut.png
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/cs/django_urls/README.md b/cs/django_urls/README.md
index 456b3d95a5b..7efc203025c 100755
--- a/cs/django_urls/README.md
+++ b/cs/django_urls/README.md
@@ -1,126 +1,129 @@
-# Django URL
+# Django URLs
 
-Chystáme se napsat naši první webovou stránku: homepage pro tvůj blog! Ale nejdřív si něco málo řekneme o Django URL.
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
 
 ## Co je adresa URL?
 
-Adresa URL je jednoduše webová adresa. Adresu URL můžeš vidět pokaždé, když navštívíš webové stránky - je vidět v adresním řádku tvého prohlížeče (Ano! `127.0.0.1:8000` je adresa URL! A `https://djangogirls.org` je také adresa URL):
+Adresa URL je jednoduše webová adresa. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` je adresa URL! And `https://djangogirls.org` is also a URL.)
 
-![Url][1]
+![Url](images/url.png)
 
- [1]: images/url.png
-
-Každá stránka na internetu potřebuje svou vlastní URL. Tímto způsobem aplikace ví, co by měla ukázat uživateli, který otevře URL. V Djangu používáme takzvaný `URLconf` (URL konfigurace). URLconf je sada vzorů, podle kterých Django zpracuje URL a pokusí se najít správné view.
+Každá stránka na internetu potřebuje svou vlastní URL. This way your application knows what it should show to a user who opens that URL. V Djangu používáme takzvaný `URLconf` (URL konfigurace). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
 
 ## Jak fungují URL v Djangu?
 
-Pojďme otevřít soubor `mysite/urls.py` v tvém zvoleném editoru kódu a uvidíme, jak vypadá:
+Pojďme otevřít `mysite/urls.py` soubor v tvém zvoleném editoru kódu a uvidíme, jak vypadá:
+
+{% filename %}mysite/urls.py{% endfilename %}
 
 ```python
-from django.conf.urls import include, url
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
-    # Examples:
-    # url(r'^$', 'mysite.views.home', name='home'),
-    # url(r'^blog/', include('blog.urls')),
-
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
 ]
-```  
+```
+
+As you can see, Django has already put something here for us.
 
-Jak vidíš, Django už má tady něco pro nás připravené.
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
 
-Řádky, které začínají na `#`, jsou komentáře - to znamená, že tyto řádky nebudou spuštěny v Pythonu. Docela užitečný nástroj, ne?
+The admin URL, which you visited in previous chapter, is already here:
 
-Admin URL, které jsi navštívila v předchozí kapitole, už je tady:
+{% filename %}mysite/urls.py{% endfilename %}
 
 ```python
-     url(r'^admin/', include(admin.site.urls)),
-```  
+    url(r'^admin/', admin.site.urls),
+```
 
-To znamená, že pro každou adresu URL, která začíná na `admin/`, bude Django hledat odpovídající *view*. V tomto případě je zde vložen odkaz na soubor s admin URL, takže není vše zabaleno v jednom souboru – je to mnohem čitelnější a jednodušší.
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
 
 ## Regex
 
-Zajímá tě, jak Django porovnává URL pro views? No, tato část je složitější. Django používá `regex`, což je zkratka pro "regulární výrazy". Regex má hodně (hodně!) pravidel, ze kterých tvoří vzorek pro vyhledávání. Vzhledem k tomu, že regex jsou hodně pokročilou záležitostí, nepůjdeme do podrobností, jak fungují.
+Zajímá tě, jak Django porovnává URL pro views? No, tato část je složitější. Django používá `regex`, což je zkratka pro "regulární výrazy". Regex má hodně (hodně!) pravidel, ze kterých tvoří vzorek pro vyhledávání. Vzhledem k tomu, že regex jsou hodně pokročilou záležitostí, nepůjdeme do podrobností jak fungují.
 
-Pokud chceš porozumět tomu, jak jsme vytvořili vzory, zde je příklad procesu - budeme potřebovat pouze omezenou sadu pravidel pro vyjádření vzoru, který hledáme, jmenovitě:
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
 
-```
-^ pro začátek textu
-$ pro konec textu
-\d číslice
-+ označuje poslední položku, které by měla být zopakována
-() k zachycení/ohraničení části vzoru
-```  
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
 
-Cokoliv jiného v definici URL budeme brát doslovně.
+Anything else in the URL definition will be taken literally.
 
-Nyní si představ, že máš webové stránky s adresou: `http://www.mysite.com/post/12345/`, kde `12345` je číslo tvého příspěvku.
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
 
-Psaní oddělených views pro všechna čísla příspěvků by bylo opravdu otravné. S regulárními výrazy můžeme vytvořit vzor, který bude odpovídat adrese URL a extrahovat z něj číslo, které potřebujeme: `^ post/(\d+) / $`. Pojďme si rozebrat kousek po kousku, co zde děláme:
+Psaní oddělených views pro všechna čísla příspěvků by bylo opravdu otravné. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
 
-*   **^ post/** říká Djangu: vezmi cokoliv, co má začátku adresy URL text `post/` (hned za `^`)
-*   **(\d+)** znamená, že bude následovat číslo (jedno nebo více číslic) a že chceme číslo zachytit a extrahovat
-*   **/** říká djangu, že by měl následovat další znak `/`
-*   **$** pak označuje konec adresy URL, což znamená, že pouze řetězce s `/` na konci budou odpovídat tomuto vzoru
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** znamená, že bude následovat číslo (jedeno nebo více číslic) a že chceme číslo zachytit a extrahovat
+* **/** říká djangu, že by měl následovat další znak `/`
+* **$** pak označuje konec adresy URL, což znamená, že pouze řetězce s `/` na konci budou odpovídat tomuto vzoru
 
-## Tvoje první Django URL!
+## Your first Django URL!
 
-Čas na vytvoření našeho prvního URL! Chceme, aby ' http://127.0.0.1:8000 /' bylo domovskou stránkou našeho blogu a zobrazilo seznam postů.
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
 
-Chceme také, aby soubor `mysite/urls.py` zůstal čistý, takže budeme importovat adresy URL z našeho `blogu` do hlavního souboru `mysite/urls.py`.
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
 
-Odstraň zakomentované řádky (řádky začínající `#`) a přidej řádek, který bude importovat `blog.urls` do hlavní URL('').`''`).
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
 
 Tvůj `Mysite/urls.py` soubor by měl nyní vypadat takto:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import include
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
-     url(r'^admin/', include(admin.site.urls)),
-     url(r'', include('blog.urls')),
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
 ]
-```  
+```
 
-Django nyní bude přesměrovávat vše, co přichází na ' http://127.0.0.1:8000/', do `blog.urls ` a hledat zde další instrukce.
+Django nyní bude přesměrovávat vše, co přichází na ' http://127.0.0.1:8000/' do `blog.urls ` a hledat zde další instrukce.
 
-Při psaní regulárních výrazů v Pythonu se vždy přidává `r` před řetězec. To je užitečný tip pro Python, že řetězec může obsahovat zvláštní znaky, které nejsou určeny přímo pro Python samotný, ale pro regulární výraz namísto toho.
+Writing regular expressions in Python is always done with `r` in front of the string. To je užitečný tip pro Python, že řetězec může obsahovat zvláštní znaky, které nejsou určeny přímo pro Python samotný, ale pro regulární výraz namísto toho.
 
 ## blog.urls
 
-Vytvoř nový prázdný soubor `blog/urls.py`. Přidej tyto dvě první řádky:
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
 from . import views
 ```
 
-Zde jsme jen importovaly Django metody a všechny naše `views` z aplikace `blogu` (zatím žádné nemáme, ale dostaneme se k tomu za chvíli).
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
 
 Poté můžeme přidat náš první URL vzor:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 urlpatterns = [
-     url(r'^$', views.post_list, name='post_list'),
+    url(r'^$', views.post_list, name='post_list'),
 ]
-```  
-
-Jak vidíš, právě jsme přiřadili `view` nazvané `post_list`, k URL `^$`. Tento regulární výraz znamená `^` (začátek řetězce), následuje `$` (konec řetězce) - výrazu bude odpovídat pouze prázdný řetězec. Tak je to správně, protože v Django URL překladači/resolveru, část adresy ' http://127.0.0.1:8000 /' není součástí adresy URL. Tento vzor řekne Djangu, že `views.post_list` je správné místo, kam jít, když někdo vstoupí na tvé webové stránky na adrese ' http://127.0.0.1:8000 /'.
-
-Poslední část `name = 'post_list'` je název adresy URL, která bude použita k identifikaci view. Název URL může být stejný jako název view, ale také může být úplně jiný. Pojmenované URL budeme používat později v projektu, proto je důležité pojmenovat všechny adresy URL v aplikaci. Také by ses měla snažit udržet názvy adres URL jedinečné a snadno zapamatovatelné.
+```
 
-Všechno v pořádku? Otevři http://127.0.0.1:8000 / v prohlížeči a uvidíš výsledek.
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. Tak je to správně, protože v Django URL překladači/resolveru, část adresy ' http://127.0.0.1:8000 /' není součástí adresy URL. Tento vzor řekne Djangu, že `views.post_list` je správné místo, kam jít, když někdo vstoupí na tvé webové stránky na adresu' http://127.0.0.1:8000 /'.
 
-![Error][2]
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. Název URL může být stejný jako název view, ale také může být úplně jiný. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
 
- [2]: images/error1.png
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
 
-Stránka přestala fungovat, co? Neboj se, je to chyba, které se nemusíš obávat! Tyto hlášky jsou vlastně docela užitečné:
+![Error](images/error1.png)
 
-Můžeš si v ní přečíst, že neexistuje **žádný atribut/no attribute "post_list"**. Připomíná ti *post_list* něco? Tak jsme nazvali naše view! Znamená to, že vše je na svém místě, ale prostě jsme ještě nevytvořili naše *view*. Žádný strach, vytvoříme ho za chvilku.
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
 
-> Pokud chceš vědět více o Django URLconfs, podívej se na oficiální dokumentaci: https://docs.djangoproject.com/en/1.8/topics/http/urls/
+> Pokud chceš vědět více o Django URLconfs, podívej se na oficiální dokumentaci: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/cs/django_views/README.md b/cs/django_views/README.md
index 18d8e531d5a..5a7f88ef507 100755
--- a/cs/django_views/README.md
+++ b/cs/django_views/README.md
@@ -1,38 +1,44 @@
-# Django views – je čas začít tvořit!
+# Django views – time to create!
 
-Nejdříve se musíme zbavit chyb, které jsme vytvořily v předchozí kapitole :)
+Nejdříve se musíme zbavit chyb, které jsme vytvořili v předchozí kapitole! :)
 
-*View* je místo, kam píšeme "logiku" naší aplikace. Bude požadovat informace z `modelu`, který jsi vytvořila dříve, a předá je `šabloně`. Šablonu vytvoříme v příští kapitole. View jsou vlastně jen Python funkce, které jsou o trochu složitější než funkce z kapitoly **Úvod do Pythonu**.
+*View* je místo, kam píšeme "logiku" naší aplikace. Bude požadovat informace z `modelu` který jsi vytvořila dříve a předá je `šabloně`. Šablonu vytvoříme v příští kapitole. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
 
 View se dávají do souboru `views.py`. My si teď přidáme naše vlastní *view* do souboru `blog/views.py`.
 
 ## blog/views.py
 
-OK, pojďme otevřít tento soubor a podívat se, co tam je:
+OK, pojďme otevřít tento soubor a podívat se co tam je:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
 
 # Create your views here.
-```  
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
 
-Zatím zde není příliš informací. Nejjednodušší *view* může vypadat následovně.
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_list(request):
     return render(request, 'blog/post_list.html', {})
-```  
+```
 
-Jak vidíš vytvořily, jsme metodu (`def`) nazvanou `post_list`, která přebírá `request`(žádost) a `return` (vrací) metodu `render`, která bude vykreslovat naši šablonu `blog/post_list.html`.
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
 
-Ulož soubor, přejdi na http://127.0.0.1:8000/ a podívej se, co se nám nyní zobrazí.
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
 
 Další chyba! Přečti si, co je špatně nyní:
 
-![Error][1]
-
- [1]: images/error.png
+![Error](images/error.png)
 
-Je to jednoduché: *TemplateDoesNotExist*. Musíme opravit tuto chybu a v následující kapitole vytvořit šablonu!
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
 
-> Další informace ohledně Django views získáš v oficiální dokumentaci na: https://docs.djangoproject.com/en/1.8/topics/http/views/
+> Další informace ohledně Django views získáš v oficiální dokumentaci na: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/cs/dynamic_data_in_templates/README.md b/cs/dynamic_data_in_templates/README.md
index a75c2805c2e..6bc6323d13a 100755
--- a/cs/dynamic_data_in_templates/README.md
+++ b/cs/dynamic_data_in_templates/README.md
@@ -1,44 +1,50 @@
 # Dynamická data v šablonách
 
-Máme různé části na svém místě: `Post` model je definován v `models.py`, `post_list` máme v `views.py` a máme přidanou šablonu. Ale jak skutečně přinutíme naše příspěvky objevit se v naší HTML šabloně? Protože to je to, co chceme: Vzít nějaký obsah (modely uložené v databázi) a zobrazit je hezky v naší šabloně, správně?
+Máme různé části na svém místě: `Post` model je definován v `models.py`, `post_list` máme v `views.py` a máme přidanou šablonu. Ale jak skutečně přinutíme naše příspěvky objevit se v naší HTML šabloně? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
 
-To je přesně to, co *views* mají dělat: spojovat modely a šablony. Do našeho `post_list` *view* budeme potřebovat vzít modely, které chceme zobrazit a předat je šabloně. Takže v podstatě se ve *view* rozhodneme, co (model) bude zobrazeno v šabloně.
+To je přesně to, co *views* mají dělat: spojovat modely a šablony. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
 
-OK, tak jak toho dosáhneme?
+OK, so how will we achieve this?
 
 Potřebujeme otevřít `blog/views.py`. Prozatím `post_list` *view* vypadá takhle:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
 def post_list(request):
     return render(request, 'blog/post_list.html', {})
-```  
+```
+
+Vzpomínáš si, jak jsme mluvili o zahrnování kódu napsaného v různých souborech? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
 
-Vzpomínáš si, jak jsme mluvily o zahrnování kódu napsaného v různých souborech? Teď je ten moment, kdy musíme zahrnout model, který jsme napsaly do `models.py`. Přidáme tuto řádku `from .models import Post`:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
 from .models import Post
-```  
+```
 
-Tečka po `from` znamená *aktuální adresář* nebo *aktuální aplikace*. Protože se `views.py` a `models.py` nachází ve stejném adresáři, můžeme jednoduše použít `.` a jméno souboru (bez `.py`). Potom importujeme název modelu (`Post`).
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Potom importujeme název modelu (`Post`).
 
-Ale co dál? Abychom mohly vzít skutečné příspěvky z `Post`, potřebujeme něco, čemu říkáme `QuerySet`.
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
 
 ## QuerySet
 
-Už bys měla mít povědomí o tom, jak QuerySety fungují. To jsme probraly v kapitole [Django ORM (QuerySets)][1].
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
 
- [1]: ../django_orm/README.md
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
 
-Takže teď nás zajímá seznam příspěvků, které jsou publikovány a setříděny podle `published_date`, že? To jsme už udělaly v kapitole na QuerySety!
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-```    
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
 
-Teď tento kousek kódu vložíme do souboru `blog/views.py` do funkce `def post_list(request)`:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
@@ -48,18 +54,18 @@ from .models import Post
 def post_list(request):
     posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
     return render(request, 'blog/post_list.html', {})
-```  
+```
 
-Vezmi, prosím, na vědomí, že jsme vytvořily *proměnnou* pro QuerySet: `posts`. Považuj to za název našeho QuerySetu. Od teď k němu budeme referovat tímto názvem.
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
 
-Kód také používá funkci `timezone.now()`, takže potřebujeme přidat import pro `timezone`.
+Vezmi, prosím, na vědomí, že jsme vytvořili *proměnnou* pro QuerySet: `posts`. Považuj to za název našeho QuerySetu. Od teď k němu budeme referovat tímto názvem.
 
-Poslední chybějící část je předat `posts` QuerySet do šablony (jak ho zobrazit si ukážeme v další kapitole).
-
-Ve funkci `render` už máme parametr `request` (všechno, co přijmeme od uživatele přes internet) a šablonu `'blog/post_list.html'`. Poslední parametr, který vypadá takhle: `{}`, je místo, kam můžeme přidat nějaké věci, u kterých chceme, aby je šablona mohla používat. Potřebujeme je pojmenovat (teď zůstaneme u `'posts'` :)). Mělo by to vypadat takhle: `{'posts': posts}`. Všimni si, prosím, že část před `:` je string: musíš ho obalit uvozovkami `''`.
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. Potřebujeme je pojmenovat (teď zůstaneme u `'posts'`). :) Mělo by to vypadat takhle: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
 
 A nakonec by náš `blog/views.py` soubor měl vypadat takhle:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from django.utils import timezone
@@ -68,8 +74,8 @@ from .models import Post
 def post_list(request):
     posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
     return render(request, 'blog/post_list.html', {'posts': posts})
-```  
+```
 
 A je to! Čas jít zpět do šablony a zobrazit tento QuerySet!
 
-Pokud si chceš přečíst něco víc o QuerySetech v Django, měla by ses podívat sem: https://docs.djangoproject.com/en/1.8/ref/models/querysets/
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/cs/extend_your_application/README.md b/cs/extend_your_application/README.md
index 55c33681cff..b9917a4fd4d 100755
--- a/cs/extend_your_application/README.md
+++ b/cs/extend_your_application/README.md
@@ -1,16 +1,16 @@
 # Rozšíření tvé aplikace
 
-Dokončily jsme již všechny kroky potřebné k vytvoření našeho webu: víme, jak napsat model, url, view a šablonu. Víme také, jak udělat naše webové stránky pěkné.
+Dokončili jsme již všechny kroky potřebné k vytvoření našeho webu: víme, jak napsat model, url, view a šablonu. Víme také, jak udělat naše webové stránky pěkné.
 
 Čas na procvičení!
 
-První věc, kterou potřebujeme v našem blogu, je pochopitelně stránka, která zobrazí jeden příspěvek, že ano?
+První věc, kterou potřebujeme v našem blogu je pochopitelně stránka, která zobrazí jeden příspěvek, že ano?
 
 Již máme `Post` model, takže nebudeme muset přidávat nic k `models.py`.
 
 ## Vytvoření šablony odkazu na post detail
 
-Začneme s přidáním odkazu do `blog/templates/blog/post_list.html` souboru. Zatím by měl vypadat takto:
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -26,117 +26,124 @@ Začneme s přidáním odkazu do `blog/templates/blog/post_list.html` souboru. Z
         </div>
     {% endfor %}
 {% endblock %}
-```  
-
+```
 
 {% raw %}Chceme mít odkaz ze seznamu příspěvků na stránku detail příspěvku. Změňme `< h1 >< href ="">{{ post.title }}< /a></h1>` tak, aby odkazoval na stránku detailu příspěvku:{% endraw %}
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
-```  
+```
 
-{% raw %}Čas k vysvětlení tajemného `{% url 'post_detail' pk=post.pk %}`. Jak asi tušíš, `{% %}` tato notace znamená, že používáme Django šablonovací značky. Tentokrát použijeme jednu, která pro nás vytvoří adresu URL.{% endraw %}
+{% raw %}Čas k vysvětlení tajemného `{% url 'post_detail' pk=post.pk %}`. Jak asi tušíš, `{% %}` tato notace znamená, že používáme Django šablonovací značky. Tentokrát použijeme jednu, která pro nás vytvoří adresu URL!{% endraw %}
 
-`blog.views.post_detail` je cesta k `post_detail` *view*, který chceme vytvořit. Poznámka: `blog` je název naší aplikace (adresář `blog`), `views` je jméno ze souboru, `views.py` a poslední kousek - `post_detail` - je název *view*.
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
 
-Teď, když půjdeme na: http://127.0.0.1:8000/, dostaneme chybu (což očekáváme, protože nemáme adresu URL nebo *view* pro `post_detail`). View bude vypadat takto:
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
 
-![NoReverseMatch error][1]
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
 
- [1]: images/no_reverse_match2.png
+![NoReverseMatch error](images/no_reverse_match2.png)
 
 ## Vytváříme adresu URL na detail příspěvku
 
 Pojďme vytvořit adresu URL v `urls.py` pro náš `post_detail` *view*!
 
-Chceme, aby se detail našeho prvního příspěvku zobrazil na této **URL**: http://127.0.0.1:8000/post/1/
+Chceme, aby se detail našeho prvního příspěvku zobrazil na této **URL**: http://127.0.0.1:8000/post/1 /
+
+Pojďme vytvořit adresu URL v souboru `blog/urls.py` odkazující Django na *view* s názvem `post_detail`, který bude zobrazovat celý příspěvek blogu. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. Tento soubor by měl vypadat takto:
 
-Pojďme vytvořit adresu URL v souboru `blog/urls.py` odkazující Django na *view* s názvem `post_detail`, který bude zobrazovat celý příspěvek blogu. Přidej řádek `url (r'^post/(?)P< pk>[0-9]+)/$', views.post_detail, name='post_detail'),` do souboru `blog/urls.py`. Tento soubor by měl vypadat takto:
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
- from django.conf.urls import url
- from . import views
+from django.conf.urls import url
+from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
- ]
-```  
-
-Tato část `^post/(?)P<pk>[0-9] +)/$` vypadá děsivě, ale bez obav - my ti to vysvětlíme: - začíná to `^` – "to znamená začátek řetězce" - `post/` znamená pouze to, že po začátku by adresa URL měla obsahovat slovo **post** a **/**. Zatím dobré. - `(?P<pk>[0-9]+)` - Tato část je složitější. Znamená to, že Django vezme vše, co zde bude umístěné, a přesune to do view do proměnné s názvem `pk`. `[0-9]` nám také říká, že to může být pouze číslo, ne písmeno (takže cokoliv mezi 0 a 9). `+` znamená, že je zde má být jedna nebo více číslic. Takže něco jako `http://127.0.0.1:8000/post //` není platné URL, ale `http://127.0.0.1:8000/post/1234567890/` je naprosto v pořádku! -`/` - pak potřebujeme **/** znovu znak / - `$` - znamená "konec" řetězce!
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
 
-Znamená to, že pokud zadáte `http://127.0.0.1:8000/post/5/` do prohlížeče, Django pochopí, že hledáte *view* s názvem `post_detail` a přenese informaci, že `pk` se rovná `5` do *view*.
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
 
-`pk` je zkratka pro `primární klíč`. Tento název se často používá v Django projektech. Ale můžeš si své proměnné pojmenovat jak chceš (nezapomeň: malá písmena a `_` namísto mezer!). Například namísto `(?. P <pk>[0-9]+)` máme proměnnou `post_id`, takže tento kousek pak vypadá takto: `(?P< post_id> [0-9]+)`.
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. Znamená to, že Django vezme vše, co zde bude umístěné a přesune to do view do proměnné s názvem `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` znamená, že je zde má být jedna nebo více číslic. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
 
-OK, přidaly jsme nový vzor adresy URL do `blog/urls.py`! Musíme obnovit stránku: http://127.0.0.1:8000/. Ještě další chyba, jak jsme čekaly!
+Znamená to, že pokud zadáte `http://127.0.0.1:8000/post/5/` do prohlížeče, Django pochopí, že hledáte *view* s názvem `post_detail` a přenese informaci, že `pk` se rovná `5` do *view*.
 
-![AttributeError][2]
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
 
- [2]: images/attribute_error2.png
+![AttributeError](images/attribute_error2.png)
 
 Pamatuješ si, jaký je další krok? Jistě: Přidat view!
 
 ## Přidání view pro detail příspěvku
 
-Tentokrát má náš *view* uveden dodatečný parametr `pk`. Náš *view* potřebuje tento parametr zachytit, že? Takže definujeme naši funkci jako `def post_detail (request, pk):`. Všimni si, že musíme použít přesně stejný název jako ten, který jsme určili v URL (`pk`). Vynechání této proměnné je nesprávné a bude mít za následek chybu!
+This time our *view* is given an extra parameter, `pk`. Náš *view* potřebuje tento parametr zachytit, že? Takže definujeme naši funkci jako `def post_detail (request, pk):`. Všimni si, že musíme použít přesně stejný název jako ten, který jsme určili v Url (`pk`). Vynechání této proměnné je nesprávné a bude mít za následek chybu!
 
-A teď chceme dostat jeden a pouze jeden příspěvek z blogu. K tomu můžeme použít querysets jako je tento:
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 Post.objects.get(pk=pk)
-```    
+```
 
-Ale tento kód má problém. Pokud neexistuje žádný `Post` s `primárním klíčem` (`pk`), dostaneme velice nepěknou chybu!
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
 
-![DoesNotExist error][3]
+![DoesNotExist error](images/does_not_exist2.png)
 
- [3]: images/does_not_exist2.png
+A to my nechceme! Ale, samozřejmě, Django přichází s něčím, co nám to pomůže ošetřit za nás: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
 
-A to my nechceme! Ale samozřejmě Django přichází s něčím, co nám to pomůže ošetřit za nás: `get_object_or_404`. V případě, že neexistuje žádný `Post` s daným `pk`, zobrazí se mnohem hezčí stránka (nazývaná `Page Not Found 404`).
+![Page not found](images/404_2.png)
 
-![Page not found][4]
+Dobrou zprávou je, že můžeš skutečně vytvořit vlastní stránku, `Page Not Found 404` a udělat jí tak krásnou, jak jen chceš. Ale to není nyní super důležité, takže to přeskočíme.
 
- [4]: images/404_2.png
+OK, time to add a *view* to our `views.py` file!
 
-Dobrou zprávou je, že můžeš skutečně vytvořit vlastní stránku `Page Not Found 404` a udělat ji tak pěkně, jak jen chceš. Ale to teď není tak důležité, takže to přeskočíme.
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
 
-Ok, čas k přidání *view* do našeho souboru `views.py`!
+We should open `blog/views.py` and add the following code near the other `from` lines:
 
-Měla bys otevřít `blog/views.py` a přidat následující kód:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render, get_object_or_404
-```    
+```
+
+And at the end of the file we will add our *view*:
 
-Poblíž jiné řádky `from`. A na konec souboru přidáme náš *view*:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_detail(request, pk):
      post = get_object_or_404(Post, pk=pk)
      return render(request, 'blog/post_detail.html', {'post': post})
-```    
+```
 
 Ano. Je na čase aktualizovat stránku: http://127.0.0.1:8000 /
 
-![Post list view][5]
-
- [5]: images/post_list2.png
+![Post list view](images/post_list2.png)
 
 Fungovalo to! Ale co se stane, když klepneš na odkaz v názvu příspěvku?
 
-![TemplateDoesNotExist error][6]
-
- [6]: images/template_does_not_exist2.png
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
 
-Ach ne! Další chyba! Ale my už víme, jak s tím naložit správně. Musíme přidat šablonu.
+Ach ne! Další chyba! Ale my už víme jak s tím naložit správně? Musíme přidat šablonu!
 
-## Vytvoření šablony pro detail příspěvku
+## Create a template for the post details
 
 Vytvoříme soubor `blog/templates/blog` s názvem `post_detail.html`.
 
 Celý příkaz bude vypadat takto:
 
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -151,47 +158,40 @@ Celý příkaz bude vypadat takto:
         <p>{{ post.text|linebreaksbr }}</p>
     </div>
 {% endblock %}
-```  
-
-Opět rozšiřujeme `base.html`. V bloku `content` chceme zobrazit published_date příspěvku (pokud existuje), název a text. Ale měli bychom probrat některé důležité věci.
+```
 
-{% raw %} `{% if ... %} ... {% endif %}` je značka šablony, kterou můžeme použít, když chceme něco zkontrolovat (nezapomeň `, if... else...` v kapitole **Úvod do Pythonu**?). V tomto případě chceme zjistit, jestli `published_date` příspěvku není prázdný.{% endraw %}
+Opět rozšiřujeme `base.html`. V bloku `content` chceme zobrazit published_date příspěvku (pokud existuje), název a text. Ale měli bychom probrat, některé důležité věci, že?
 
-OK, teď můžeme aktualizovat naše stránky a uvidíš, jestli `Page Not Found` je pryč.
+{% raw %} `{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
 
-![Post detail page][7]
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
 
- [7]: images/post_detail2.png
+![Post detail page](images/post_detail2.png)
 
 Hurá! Funguje to!
 
 ## Ještě jedna věc: čas nasadit aplikaci!
 
-Bylo by dobré zjistit, jestli naše webové stránky budou stále fungovat na PythonAnywhere. Zkusme je znovu nasadit.
+Bylo by dobré zjistit, jestli naše webové stránky budou stále fungovat na PythonAnywhere? Zkusme je znovu nasadit.
 
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
-$ git push
-```  
+{% filename %}command-line{% endfilename %}
 
-*   Pak v [Bash konzoli PythonAnywhere][8]:
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
 
- [8]: https://www.pythonanywhere.com/consoles/
+Pak v [Bash konzoli PythonAnywhere](https://www.pythonanywhere.com/consoles/):
 
-```
-$ cd my-first-blog
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```  
+{% filename %}command-line{% endfilename %}
 
-*   Nakonec jdi na [kartu Web][9] a klikni na **Reload**.
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
- [9]: https://www.pythonanywhere.com/web_app_setup/
+Nakonec, skoč na [kartu Web](https://www.pythonanywhere.com/web_app_setup/) a klikni na **Reload**.
 
-A mělo by to být! Gratulujeme :)
+A mělo by to být! Gratulujeme :)
\ No newline at end of file
diff --git a/cs/how_the_internet_works/README.md b/cs/how_the_internet_works/README.md
index 3543d4bd56a..6590f0434fc 100755
--- a/cs/how_the_internet_works/README.md
+++ b/cs/how_the_internet_works/README.md
@@ -1,53 +1,47 @@
 # Jak funguje internet
 
-> Tato kapitola je inspirována přednáškou "How the Internet works", kterou přednesla Jessica McKellar (http://web.mit.edu/jesstess/www/).
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
 
-Internet jistě používáš každý den. Ale víš ve skutečnosti co se stane, když do prohlížeče napíšeš adresu jako https://djangogirls.org a zmáčkneš `enter`?
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
 
-První věc, které musíš rozumět, je, že webová stránka je jen pár souborů uložených na hard disku. Přesně jako tvé filmy, hudba nebo obrázky. Je tu ale něco, co dělá webové stránky unikátními: obsahují počítačový kód nazývaný HTML.
+První věc, které potřebuješ rozumět je, že webová stránka je jen pár souborů uložených na hard disku. Přesně jako tvé filmy, hudba nebo obrázky. Je tu ale něco, co dělá unikátními webové stránky: obsahují počítačový kód nazývaný HTML.
 
-Pokud je ti programování zcela cizí, z počátku pro tebe může být těžké HTML pochopit, ale tvé webové prohlížeče (jako Chrome, Safari, Firefox atd.) jej milují. Webové prohlížeče jsou navrženy tak, aby tomuto kódu rozuměly, plnily instrukce a zobrazovaly soubory, ze kterých je tvá stránka vytvořena, přesně tak, jak chceš.
+Pokud je ti programování zcela cizí, z počátku pro tebe může být těžké pochopit HTML, ale tvé webové prohlížeče (jako Chrome, Safari, Firefox, atd.) jej milují. Webové prohlížeče jsou navrženy tak, aby tomuto kódu rozuměly, následovaly instrukce a prezentovaly soubory, ze kterých je tvá stránka vytvořena, přesně tak jak chceš.
 
-Jako každý soubor potřebujeme HTML soubory ukládat někam na hard disk. Pro internet používáme speciální, mocné počítače nazývané *servery*. Nemají obrazovku, myš ani klávesnici, protože jejich hlavním účelem je skladovat data a servírovat je. Proto je nazýváme *servery* -- protože ti *servírují* data.
+Jako s každým souborem, potřebujeme HTML soubory ukládat někam na hard disk. Pro internet používáme speciální, mocné počítače nazývané *servery*. Nemají obrazovku, myš ani klávesnici, protože jejich hlavním účelem je skladovat data a servírovat je. That's why they're called *servers* – because they *serve* you data.
 
-OK, ale chceš vědět jak internet vypadá, že ano?
+OK, but you want to know how the Internet looks, right?
 
 Nakreslili jsme pro tebe obrázek! Vypadá takhle:
 
-![Figure 1.1][1]
+![Figure 1.1](images/internet_1.png)
 
- [1]: images/internet_1.png
+Vypadá to jako pěkný bordel, že? In fact it is a network of connected machines (the above-mentioned *servers*). Stovek tisíc strojů! Mnoho, mnoho kilometrů kabelů kolem celého světa! Můžeš navštívit stránku mapování podmořských kabelů (http://submarinecablemap.com/) abys viděla jak komplikovaná tato síť je. Tady je screenshot z té stránky:
 
-Vypadá to jako pěkný bordel, že? Ve skutečnosti je to síť propojených strojů (výše zmíněných *serverů*). Stovek tisíc strojů! Mnoho, mnoho kilometrů kabelů kolem celého světa! Můžeš navštívit stránku mapování podmořských kabelů (http://submarinecablemap.com/), abys viděla, jak komplikovaná tato síť je. Tady je screenshot z té stránky:
+![Figure 1.2](images/internet_3.png)
 
-![Figure 1.2][2]
-
- [2]: images/internet_3.png
-
-Není to fascinující? Samozřejmě není možné mít dráty mezi každými dvěma stroji připojenými k internetu. Proto abychom získaly přístup ke konkrétnímu počítači (třeba k tomu, na kterém je uložena stránka https://djangogirls.org), musí být požadavek postupně předáván mezi mnoha různými stroji.
+Není to fascinující? Samozřejmě není možné mít dráty mezi každými dvěma stroji připojenými k internetu. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
 
 Vypadá to takhle:
 
-![Figure 1.3][3]
-
- [3]: images/internet_2.png
-
-Představ si, že když napíšeš https://djangogirls.org, pošleš dopis, ve kterém stojí "Drahé Django Girls, chci si prohlédnout stránku djangogirls.org. Pošlete mi ji, prosím!"
+![Figure 1.3](images/internet_2.png)
 
-Tvůj dopis se pošle na tvou nejbližší poštu. Potom se pošle na jinou poštu, která je trochu blíže tvému adresátovi, potom na další a další, až se doručí do cílové destinace. Jediná unikátní věc je, že když pošleš hodně dopisů (*data paketů*) na stejné místo, můžou se tam dostat přes naprosto jiné pošty (*routery*). To závisí na tom, jak jsou na každé poště distribuovány.
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
 
-![Figure 1.4][4]
+Tvůj dopis se pošle na tobě nejbližší poštu. Potom se pošle na jinou poštu, která je trochu blíže tvému adresátovi, potom na další a další, až se doručí do cílové destinace. Jediná unikátní věc je, že když pošleš hodně dopisů (*data paketů*) na stejné místo, můžou se tam dostat přes naprosto jiné pošty (*routery*). To závisí na tom, jak jsou na každé poště distribuovány.
 
- [4]: images/internet_4.png
+![Figure 1.4](images/internet_4.png)
 
-Ano, je to takhle jednoduché. Odešleš zprávu a očekáváš nějakou odpověď. Samozřejmě, místo papíru a pera používáš byty dat, ale princip je stejný!
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
 
-Místo adres s názvem ulice, města a poštovním kódem používáme IP adresy. Tvůj počítač nejprve požádá DNS server (Domain Name System) o překlad djangogirls.org do IP adresy. Funguje to trochu jako staromódní telefonní seznam, kde sis mohla vyhledat jméno člověka, na kterého potřebuješ kontakt, a najít jeho telefonní číslo a adresu.
+Místo adres s názvem ulice, města a poštovním kódem používáme IP adresy. Tvůj počítač nejprve požádá DNS server (Domain Name System) o překlad djangogirls.org do IP adresy. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
 
-Když posíláš dopis, musí mít určité náležitosti, aby mohl být správně doručen: adresu, známku atp. Také používáš jazyk, kterému adresát rozumí, že? Stejné platí o *data paketech*, které posíláš, abys viděla webovou stránku. My používáme protokol zvaný HTTP (Hypertext Transfer Protocol).
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Také používáš jazyk kterému adresát rozumí, že ano? Stejné platí o *data paketech* které posíláš abys viděla webovou stránku. My používáme protokol zvaný HTTP (Hypertext Transfer Protocol).
 
-Takže když máš webovou stránku, potřebuješ *server* (stroj), na kterém může žít. Když *server* přijme přicházející *požadavek/request* (v dopise), pošle zpátky tvoji webovou stránku (v dalším dopise).
+Takže když máš webovou stránku, potřebuješ *server* (stroj) na kterém může žít. Když *server* přijme přicházející *požadavek/request* (v dopise), pošle zpátky tvoji webovou stránku (v dalším dopise).
 
-Jelikož je toto Django tutoriál, budeš se ptát, co Django dělá. Když odesíláš odpověď, ne vždy chceš, aby se všem odeslala stejná věc. Je mnohem lepší, když jsou tvé dopisy personalizované, obzvláště pro osobu, která ti právě napsala, že? Django ti pomáhá s vytvářením těchto personalizovaných, zajímavých dopisů :).
+Since this is a Django tutorial, you might ask what Django does. Když odesíláš odpověď, ne vždy chceš, aby se všem odeslala stejná věc. Je mnohem lepší, když jsou tvé dopisy personalizované, obzvláště pro osobu, která ti právě napsala, že? Django ti pomáhá s vytvářením těchto personalizovaných, zajímavých dopisů. :)
 
-Dost řečí, je čas tvořit!
+Enough talk – time to create!
\ No newline at end of file
diff --git a/cs/html/README.md b/cs/html/README.md
index 503feb1e10e..8e4f108c64e 100755
--- a/cs/html/README.md
+++ b/cs/html/README.md
@@ -1,74 +1,73 @@
 # Úvod do HTML
 
-Co je to šablona?
+Co je to šablona, se ami ptáš?
 
-Šablona je soubor, který můžeme opakovaně použít pro prezentaci různých informací v konzistentním formátu - například bys mohla šablonu použít pro psaní dopisu, protože ačkoli každý dopis může obsahovat jinou zprávu a být adresován jiné osobě, všechny dopisy budou sdílet stejný formát.
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
 
-Formát Django šablony je popsán v jazyku nazývaném HTML (Je to to stejné HTML, které jsme zmínili v první kapitole **Jak funguje internet**).
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
 
 ## Co je HTML?
 
-HTML je jednoduchý kód, který je interpretován tvým webovým prohlížečem - jako je Chrome, Firefox nebo Safari - aby se uživateli zobrazila webová stránka.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
-HTML je zkratka od "HyperText Markup Language". **HyperText** znamená, že je to typ textu, který podporuje hypertextové odkazy mezi stránkami. **Markup** znamená, že jsme vzali dokument a označili ho kódem, abychom něčemu (v tomto případě prohlížeči) řekli, jak interpretovat stránku. HTML kód se vytváží pomocí **tagů**. Každý začíná znakem `<` a končí znakem `>`. Tyto tagy představují **elementy** značkovacího jazyka (Markup).
+HTML je zkratka od "HyperText Markup Language". **HyperText** znamená, že je to typ textu, který podporuje hypertextové odkazy mezi stránkami. **Markup** znamená, že jsme vzali dokument a označili ho kódem, abychom něčemu (v tomto případě prohlížeči) řekli, jak interpretovat stránku. HTML kód se vytváží pomocí **tagů**. Každý začíná znakem `<` a končí znakem `>`. Tyto tagy representují **elementy** značkovacího jazyka (Markup.
 
 ## Tvá první šablona!
 
-Vytvoření šablony znamená vytvoření souboru šablony. Všechno je soubor, že? Toho sis už asi všimla.
+Vytvoření šablony znamená vytvoření souboru šablony. Všechno je soubor, dobře? Toho sis už asi všimla.
 
 Šablony jsou uloženy v adresáři `blog/templates/blog`. Takže nejdříve vytvoř adresář `templates` uvnitř tvé blog složky. Potom vytvoř další složku nazvanou `blog` uvnitř templates složky:
 
-```
-blog
-└───templates
-    └───blog
-```  
-
-(Mohlo by tě zajímat proč potřebujeme dva adresáře s názvem `blog` - jak později zjistíš, je to pouze užitečná konvence, která dělá život jednodušším, když věci začnou být komplikovanější.)
+    blog
+    └───templates
+        └───blog
+    
 
-A teď vytvoř soubor `post_list.html` uvnitř adresáře `blog/templates/blog`. Prozatím ho nech prázdný.
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
 
-Podívej se, jak tvá stránka vypadá teď: http://127.0.0.1:8000/
+A teď vytvoř soubor `post_list.html` (pro teď ho nech prázdný) uvnitř adresáře `blog/templates/blog`.
 
-> Pokud máš stále chybu `TemplateDoesNotExists`, zkus restartovat server. Běž do příkazové řádky, zastav server zmáčknutím Ctrl+C (Control a C zároveň) a znovu ho rozběhni pomocí příkazu `python manage.py runserver`.
+Podívej se jak tvá stránka vypadá teď: http://127.0.0.1:8000/
 
-![Figure 11.1][1]
+> Pokud se ti stále zobrazuje chyba`TemplateDoesNotExists`, zkus restartovat server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
 
- [1]: images/step1.png
+![Figure 11.1](images/step1.png)
 
-Žádná chybová hláška! Gratulujeme :) Nicméně na tvé stránce se ještě nezveřejnilo nic kromě prázdné stránky, protože tvá šablona je také prázdná. To musíme napravit.
+Žádná chybová hláška! Gratulujeme :) Nicméně, na tvé stránce se ještě nezveřejnilo nic kromě prázdné stránky, protože tvá šablona je také prázdná. To musíme napravit.
 
 Do souboru šablony (template) přidej následující:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
-    <p>Ahoj!</p>
-    <p>Funguje to!</p>
+    <p>Hi there!</p>
+    <p>It works!</p>
 </html>
-```  
-
-Tak jak tvá stránka vypadá teď? Klikni a zjisti to: http://127.0.0.1:8000/
+```
 
-![Figure 11.2][2]
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
 
- [2]: images/step3.png
+![Figure 11.2](images/step3.png)
 
 Fungovalo to! Pěkná práce :)
 
-*   Nejzákladnější tag, `<html>`, je vždy na začátku jakékoli stránky a `</html>` na jejím konci. Jak vidíš, celý obsah stránky je mezi otevíracím tagem `<html>` a zavíracím tagem `</html>`
-*   `<p>` je tag pro element paragraf; `</p>` každý paragraf ukončuje
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. Jak vidíš, celý obsah stránky je mezi otevíracím tagem `<html>` a zavíracím tagem `</html>`
+* `<p>` je tag pro element paragraf; `</p>` každý paragraf ukončuje
+
+## Head and body
 
-## Head & body
+Každá HTML stránka je také rozdělena na dva elementy: **head** (hlavu) a **body** (tělo.
 
-Každá HTML stránka je také rozdělena na dva elementy: **head** (hlavu) a **body** (tělo).
+* **head** je element, který obsahuje informace o dokumentu, které se nezobrazují na webu.
 
-*   **head** je element, který obsahuje informace o dokumentu, které se nezobrazují na webu.
+* **body** je element který obsahuje vše ostatní, co se zobrazuje jakou součást webové stránky.
 
-*   **body** je element, který obsahuje vše ostatní, co se zobrazuje jakou součást webové stránky.
+`<head>` používáme abychom prohlížeči sdělili konfiguraci stránky, `<body>` abychom sdělili co na té stránce skutečně je.
 
-`<head>` používáme, abychom prohlížeči sdělili konfiguraci stránky, `<body>`, abychom řekli, co na té stránce skutečně je.
+For example, you can put a web page title element inside the `<head>`, like this:
 
-Například dovnitř `<head>` můžeš dát element title (titulek), třeba takhle:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -76,41 +75,42 @@ Například dovnitř `<head>` můžeš dát element title (titulek), třeba takh
         <title>Ola's blog</title>
     </head>
     <body>
-        <p>Ahoj!</p>
-        <p>Funguje to!</p>
+        <p>Hi there!</p>
+        <p>It works!</p>
     </body>
 </html>
-```  
+```
 
 Ulož soubor a načti znovu svou stránku.
 
-![Figure 11.3][3]
-
- [3]: images/step4.png
+![Figure 11.3](images/step4.png)
 
 Všimla sis, že prohlížeč už ví, že "Ola's blog" je titulek stránky? Interpretoval `<title>Ola's blog</title>` a umístil text jako název záložky.
 
-Pravděpodobně sis také všimla, že každý otevírací tag je doplněn *zavíracím tagem* se znakem `/`, a že elementy jsou *vnořené* (tzn. že nemůžeš zavřít daný tag, dokud nejsou zavřeny všechny tagy uvnitř).
+Pravděpodobně jsi si také všimla, že každý otevírací tag je doplněn *zavíracím tagem* se znakem `/`, a že elementy jsou *vnořené* (tzn. že nemůžeš zavřít daný tag dokud nejsou zavřeny všechny tagy uvnitř).
 
-Je to jako dávat věci do krabic. Máš jednu velkou krabici, `<html></html>`; uvnitř je `<body></body>`. A ta obsahuje další, menší krabice: `<p></p>`.
+Je to jako dávat věci do krabic. Máš jednu velkou krabici, `<html></html>`; uvnitř je `<body></body>`, A ta obsahuje další, menší krabice: `<p></p>`.
 
-Musíš dodržovat pravidlo *zavíracích* tagů a *vnořených* elementů - pokud ne, prohlížeč je nemusí správně interpretovat a tvá webová stránka se bude zobrazovat nesprávně.
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
 
 ## Přizpůsob si šablonu
 
 Teď si můžeš užít trochu zábavy a pokusit se přizpůsobit si svou šablonu! Tady je pár užitečných tagů:
 
-*   `<h1>Hlavní nadpis</h1>` - Pro tvůj nejdůležitější nadpis
-*   `<h2>Pod-nadpis</h2>` pro nadpis na nižší úrovni
-*   `<h3>Pod-pod-nadpis</h3>` ... a tak dále, až k `<h6>`
-*   `<em>text</em>` zvýrazňuje tvůj text
-*   `<strong>text</strong>` zvýrazňuje tvůj text silnějji
-*   `<br />` vkládá novou řádku (dovnitř br nemůžeš nic dát)
-*   `<a href="https://djangogirls.org">link</a>` vytváří odkaz
-*   `<ul><li>První položka seznamu</li><li>druhá položka seznamu</li></ul>` vytváří seznam, zrovna jako tento!
-*   `<div></div>` definuje sekce stránky
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>Pod-nadpis</h2>` pro nadpis na nižší úrovni
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` zvýrazňuje tvůj text
+* `<strong>text</strong>` hodně zvýrazňuje tvůj text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` vytváří odkaz
+* `<ul><li>První položka seznamu</li><li>second item</li></ul>` vytváří seznam, zrovna jako tento!
+* `<div></div>` definuje sekce stránky
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
 
-Zde je příklad celé šablony:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -119,98 +119,95 @@ Zde je příklad celé šablony:
     </head>
     <body>
         <div>
-            <h1><a href="">Django Girls Blog</a></h1>
+            <h1><a href="/">Django Girls Blog</a></h1>
         </div>
 
         <div>
             <p>published: 14.06.2014, 12:14</p>
-            <h2><a href="">Můj první příspěvek</a></h2>
+            <h2><a href="">My first post</a></h2>
             <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
         </div>
 
         <div>
             <p>published: 14.06.2014, 12:14</p>
             <h2><a href="">Můj druhý příspěvek</a></h2>
-            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh.</p>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
         </div>
     </body>
 </html>
-```  
+```
 
 Tady vytvoříme tři `div` sekce.
 
-*   První `div` element obsahuje titulek našeho blogu - jeho nadpis a odkaz
-*   Další dva `div` elementy obsahují naše příspěvky s datem zveřejnění, na `h2` s titulkem příspěvku se dá kliknout a dva `p` (paragrafy) obsahují text, jeden datum a druhý samotný příspěvek.
-
-To nám dá následující výsledek:
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Další dva `div` elementy obsahují naše příspěvky s datem zveřejnění, na `h2` s titulkem příspěvku se dá kliknout a dva `p` (paragrafy) obsahují text, jeden datum a druhý samotný příspěvek.
 
-![Figure 11.4][4]
+To nám dá následující efekt:
 
- [4]: images/step6.png
+![Figure 11.4](images/step6.png)
 
-Jupííí! Ale teď naše šablona zobrazuje jen **neměnné informace** - dříve jsme ovšem mluvily o tom, že šablony nám umožňují zobrazovat **různé** informace ve **stejném formátu**.
+Jupííí! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
 
-Co ve skutečnosti chceme, je zobrazit opravdové příspěvky přidané v našem Django administrátorském rozhraní - a to se chystáme udělat za chvilku.
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
 
 ## Ještě jedna věc: nasaďme to!
 
-Bylo by fajn vidět všecho tohle venku a živě na internetu, že ano? Pojďme udělat další PythonAnywhere nasazení (deploy):
+Bylo by fajn vidět všecho tohle venku a živé na internetu, že jo? Pojďme udělat další PythonAnywhere nasazení (deploy):
 
-### Commitni a hoď svůj kód na Github
+### Commitni, a pushni svůj kód na Github
 
-Nejdříve se podívejme, které soubory se změnily od posledního nasazení (deploy). Zadej tyto příkazy lokálně (ne na PythonAnywhere):
+Nejdříve se podívejme které soubory se změnily od posledního nasazení (deploy). Zadej tyto příkazy lokálně (ne na PythonAnywhere):
 
-```
-$ git status
-```  
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
 
 Ujisti se, že jsi v `djangogirls` adresáři a řekni `gitu`, ať zahrne všechny nové změny v adresáři:
 
-```
-$ git add --all .
-```  
+{% filename %}command-line{% endfilename %}
 
-> **Poznámka** `-A` (zkratka pro "all", tj. "vše") znamená, že `git` také rozpozná, jestli jsi smazala nějaké soubory (defaultně rozpoznává pouze nové a modifikované soubory). Taky si vzpomeň (ze 3. kapitoly), že `.` znamená aktuální adresář.
+    $ git add --all .
+    
 
-Než nahrajeme všechny soubory, zkontrolujme, co bude `git` nahrávat (všechny soubory, které bude `git` nahrávat, se zobrazí zeleně):
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Taky si vzpomeň (ze 3. kapitoly), že `.` znamená aktuální adresář.
 
-```
-$ git status
-```  
+Než nahrajeme všechny soubory, zkontrolujme co bude `git` nahrávat (všechny soubory, které bude `git` nahrávat, se zobrazí zeleně):
 
-Jsme skoro u konce, teď je čas uložit změny do historie. Vytvoříme "commit zprávu", kde popíšeme, co jsme změnily. Můžeš napsat, cokoli tě napadne, ale je užitečné napsat něco popisného, aby sis v budoucnosti mohla vzpomenout, cos udělala.
+{% filename %}command-line{% endfilename %}
 
-```
-$ git commit -m "Změněn HTML kód stránek."
-```  
+    $ git status
+    
+
+Jsme skoro u konce, teď je čas uložit změny do historie. Vytvoříme "commit zprávu" kde popíšeme co jsme změnili. Můžeš napsat cokoli tě napadne, ale je užitečné napsat něco popisného, aby sis v budoucnosti mohla vzpomenout cos udělala.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Změněn HTML kód stránek."
+    
 
 > **Poznámka** Ujisti se, že používáš dvojité uvozovky kolem zprávy.
 
-Jakmile jsme s tímto hotovy, nahrajeme (push) naše změny na Github:
+Once we've done that, we upload (push) our changes up to GitHub:
 
-```
-git push
-```  
+{% filename %}command-line{% endfilename %}
 
-### Stáhni svůj nový kód na PythonAnywhere a načti webovou aplikaci
+    $ git push
+    
 
-*   Otevři [stránku s konzolí na PythonAnywhere][5] a jdi do své **Bash konzole** (nebo začni novou). Potom zadej:
+### Stáhni svůj nový kód na PythonAnywhere a načti webovou aplikaci
 
- [5]: https://www.pythonanywhere.com/consoles/
+* Otevři [stránku s konzolí na PythonAnywhere](https://www.pythonanywhere.com/consoles/) a jdi do své **Bash konzole** (nebo začni novou). Potom zadej:
 
-```
-$ cd ~/my-first-blog
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```  
+{% filename %}command-line{% endfilename %}
 
-A sleduj svůj kód, jak se stahuje. Pokud si chceš zkontrolovat, že se kód opravdu nahrál, můžeš skočit do záložky **Files** a podívat se na svůj kód na PythonAnywhere.
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
 
-*   A konečně, skoč na záložku [Web][6] a klikni na **Reload** (Znovu načíst).
+A sleduj svůj kód jak se stahuje. Pokud si chceš zkontrolovat, že se kód opravdu nahrál, můžeš skočit do záložky **Files** a podívat se na svůj kód na PythonAnywhere.
 
- [6]: https://www.pythonanywhere.com/web_app_setup/
+* A konečně, skoč na záložku [Web](https://www.pythonanywhere.com/web_app_setup/) a klikni na **Reload** (Znovu načíst).
 
-Tvůj update by měl běžet živě! Obnov svou stránku v prohlížeči. Měla bys vidět změny :)
+Obnov svou stránku v prohlížeči. Měla bys vidět změny. :)
\ No newline at end of file
diff --git a/cs/install_git.md b/cs/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/cs/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/cs/installation/README.md b/cs/installation/README.md
index cdd38b9c502..79212ff2974 100755
--- a/cs/installation/README.md
+++ b/cs/installation/README.md
@@ -1,16 +1,21 @@
 # Pokud děláš tutoriál doma
 
-Pokud děláš tento tutorial doma, ne na jedné z [Django girls akcí](https://djangogirls.org/events/), můžeš zcela vynechat tuto kapitolu a jít rovnou na kapitolu [jak funguje Internet](../how_the_internet_works/README.md).
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
 
-To proto, že zde uvedené věci stejně vysvětlíme v průběhu celého kurzu a tato stránka pouze shromažďuje všechny pokyny pro instalaci na jednom místě. Jedna z Django Girls událostí "Instalační večer" se zaobírá instalováním všeho, co budeme potřebovat, což nás už nebude zdržovat během samotného worshopu. To je pro nás užitečná úspora času.
+To proto, že zde uvedené věci stejně vysvětlíme v průběhu celého kurzu a tato stránka, pouze shromažďuje všechny pokyny pro instalaci na jednom místě. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
 
-Pokud myslíš, že je pro tebe tato kapitola užitečná, můžeš si ji projít. Ale pokud se chceš začít učit ještě před instalací hromady věcí do tvého počítače, přeskoč tuto kapitolu a my ti vysvětlíme proces instalace později.
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
 
 Hodně štěstí!
 
 # Instalace
 
-Při workshopu budeme vytvářet blog, přičemž zde existuje několik nastavení, která se budou během kurzu hodit před tím, než začneš programovat.
+Při workshopu budeme vytvářet blog a existuje zde několik nastavení, které se budou během kurzu hodit před tím než začneš programovat.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
 
 # Instalace Pythonu
 
@@ -38,12 +43,16 @@ Přejděte na [GitHub.com](https://www.github.com) a vytvořte si zdarma uživat
 
 # Začni číst
 
-Gratulujeme, právě sis zřídila všechny účty a nastavila vše, co potřebuješ! Pokud máš ještě nějaký čas před workshopem, bylo by užitečné začít číst některou z prvních kapitol:
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [Jak funguje internet](../how_the_internet_works/README.md)
+
+* [Úvod do příkazového řádku](../intro_to_command_line/README.md)
 
-  * [Jak funguje internet](../how_the_internet_works/README.md)
+* [Úvod do Pythonu](../python_introduction/README.md)
 
-  * [Úvod do příkazového řádku](../intro_to_command_line/README.md)
+* [Co je Django?](../django/README.md)
 
-  * [Úvod do Pythonu](../python_introduction/README.md)
+# Enjoy the workshop!
 
-  * [Co je Django?](../django/README.md)
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/cs/instructions.md b/cs/instructions.md
new file mode 100644
index 00000000000..30bd493b11b
--- /dev/null
+++ b/cs/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command dnf is not found. In that case you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/cs/intro_to_command_line/README.md b/cs/intro_to_command_line/README.md
index 2bdd6c0f5de..65f6c62e7eb 100755
--- a/cs/intro_to_command_line/README.md
+++ b/cs/intro_to_command_line/README.md
@@ -1,127 +1,178 @@
 # Úvod k příkazové řádce
 
-Hm, to je vzrušující, že? Napíšeš svůj první řádek kódu za pouhých pár minut :)
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
 
 **Dovol nám, abychom ti představili tvého prvního nového přítele: příkazovou řádku! **
 
 Následující kroky ti ukážou, jak používat černé okno, které všichni počítačoví odborníci používají. Může to na první pohled vypadat trochu děsivě, ale opravdu je to jen okno, které čeká na tvé příkazy.
 
-> **Poznáma** Ber, prosím, na vědomí, že v tomto tutoriálu používáme termíny 'adresář' a 'složka', ale je to jedna a ta samá věc.
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
 
 ## Co je příkazová řádka?
 
-Okno, které se obvykle nazývá **příkazová řádka** nebo **rozhraní příkazové řádky**, je textová aplikace pro zobrazování, zpracovávání a manipulaci se soubory na tvém počítači. Docela jako Windows Explorer nebo Finder na Mac, ale bez grafického rozhraní. Další jména pro příkazovou řádku jsou: *cmd*, *prompt*, *command line*, *konzole* nebo *terminál*.
+Okno, které se obvykle nazývá **příkazová řádka** nebo **rozhraní příkazové řádky**, je textová aplikace pro zobrazování, zpracovávání a manipulaci se soubory na tvém počítači. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Další jména pro příkazovou řádku jsou: *cmd*, *prompt*, *command line*, *konzole* nebo *terminál*.
 
 ## Otevři rozhraní příkazové řádky
 
-Chceš-li začít experimentovat, je třeba nejprve otevřít naše rozhraní příkazové řádky.
+Chceš-li začít experimentovat je třeba nejprve otevřít naše rozhraní příkazové řádky.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
 
-### Windows
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
 
-Jdi na menu Start → Všechny programy → Příslušenství → Příkazová řádka.
+Go to Applications → Utilities → Terminal.
 
-### Mac OS X
+<!--endsec-->
 
-Aplikace → Nástroje → Terminál.
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
 
-### Linux
+Pravděpodobně ji nalezneš pod Aplikace → Příslušenství → Terminál, ale závisí to na tvém systému. Pokud to tam není, jen to vygoogli. :)
 
-Pravděpodobně ji nalezneš pod Aplikace → Příslušenství → Terminál, ale závisí to na tvém systému. Pokud to tam není, prostě to vygoogli :)
+<!--endsec-->
 
 ## Příkazová řádka
 
 Nyní bys měla vidět bílé nebo černé okno, které čeká na tvé příkazy.
 
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
 Pokud jsi na Mac nebo na Linuxu, pravděpodobně uvidíš výzvu začínající tímto znakem `$`, právě takhle:
 
-```
-$
-```  
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+V systému Windows je to `>` tento znak:
 
-V systému Windows je to tento znak `>`:
+{% filename %}command-line{% endfilename %}
 
-```
->
-```  
+    >
+    
 
-Každý příkaz budeš psát za tento znak a jednu mezeru, ale není nutné to zadávat. Tvůj počítač to udělá za tebe :)
+<!--endsec-->
 
-> Jen malá Poznámka: někteří mohou vidět něco jako `C:\Users\ola >` nebo `Olas-MacBook-Air: ~ ola$` před znakem $. To je naprosto v pořádku. V tomto kurzu se jen snažíme vše zjednodušit na minimum.
+Každý příkaz budeš psát za tento znak a jednu mezeru, ale není nutné to zadávat. Tvůj počítač to udělá za tebe. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
 
 ## Tvůj první příkaz (hurá!)
 
-Pojďme začít s něčím jednoduchým. Zadej tento příkaz:
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-```
-$ whoami
-```  
+    $ whoami
+    
 
-nebo
+<!--endsec-->
 
-```
-> whoami
-```  
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
 
 A zmáčkni `enter`. Tohle je výsledek:
 
-```
-$ whoami
-olasitarska
-```  
+{% filename %}command-line{% endfilename %}
 
-Jak vidíš, počítač právě vypsal tvé uživatelské jméno. Pěkný, co?:)
+    $ whoami 
+    olasitarska
+    
 
-> Zkus každý příkaz zadat, nekopíruj ho prostým vyjmout/vložit. Zapamatuješ si tak více!
+Jak vidíš, počítač právě vypsal tvé uživatelské jméno. Pěkný, co? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
 
 ## Základy
 
-Každý operační systém má mírně odlišnou sadu příkazů na příkazové řádce, takže se ujisti, že sleduješ pokyny pro tvůj operační systém. Zkusme to, ano?
+Každý operační systém má mírně odlišnou sadu příkazů na příkazové řádce, ujisti se, že sleduješ pokyny pro tvůj operační systém. Zkusme to, ano?
 
 ### Aktuální složka
 
 Bylo by hezké vědět, kde právě jsme, ne? Podívejme se. Zadej následující příkaz a stiskni `enter`:
 
-```
-$ pwd
-/Users/olasitarska
-```  
-
-Pokud jsi v systému Windows:
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
 
-```
-> cd
-C:\Users\olasitarska
-```  
+{% filename %}command-line{% endfilename %}
 
-Pravděpodobně se ti zobrazí něco podobného. Jakmile otevřeš příkazovou řádku, obvykle začínáš ve svém domovském adresáři.
+    $ pwd
+    /Users/olasitarska
+    
 
 > Poznámka: 'pwd' je zkratka pro "print working directory / zobrazení cesty pro pracovní adresář".
 
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd 
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+Pravděpodobně se ti zobrazí něco podobného. Jakmile otevřeš příkazovou řádku, obvykle začínáš ve svém domovském adresáři.
+
 * * *
 
 ### Seznam souborů a adresářů
 
-Tak co je v něm? Bylo by fajn zjistit, co je v našem adresáři. Podívejme se:
+Tak co je v něm? Bylo by fajn zjistit co je v našem adresáři. Podívejme se:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
 
-```
-$ ls
-Aplikace
-Desktop
-Stažené soubory
-Hudba...
-```  
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ ls 
+    Aplikace 
+    Desktop 
+    Stažené soubory
+    Hudba...
+    
 
-```
-> dir
-Directory of C:\Users\olasitarska
-05/08/2014 07:28 PM <DIR> Applications
-05/08/2014 07:28 PM <DIR> Desktop
-05/08/2014 07:28 PM <DIR> Downloads
-05/08/2014 07:28 PM <DIR> Music
-...
-```  
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir  
+    Directory of C:\Users\olasitarska 
+    05/08/2014 07:28 PM <DIR> Applications 
+    05/08/2014 07:28 PM <DIR> Desktop 
+    05/08/2014 07:28 PM <DIR> Downloads 
+    05/08/2014 07:28 PM <DIR> Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
 
 * * *
 
@@ -129,33 +180,49 @@ Directory of C:\Users\olasitarska
 
 Teď pojďme do adresáře plochy:
 
-```
-$ cd Desktop
-```  
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ cd Desktop
+    
 
-```
-> cd Desktop
-```  
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
 
 Zkontroluj, zda-li se adresář skutečně změnil:
 
-```
-$ pwd
-/Users/olasitarska/Desktop
-```  
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ pwd 
+    /Users/olasitarska/Desktop
+    
 
-```
-> cd
-C:\Users\olasitarska\Desktop
-```  
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd 
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
 
 A je to!
 
-> PRO tip: Pokud zadáš `cd D` a poté stiskneš klávesu `tab` na klávesnici, příkazová řádka automaticky předvyplní zbytek názvu, tak můžeš adresáře procházet rychleji. Pokud existuje více než jedna složka od "D", musíš tlačítko `tab` zmáčknout dvakrát a zobrazí se ti seznam dostupných možností.
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
 
 * * *
 
@@ -163,17 +230,25 @@ A je to!
 
 Co si vytvořit pokusnou složku na ploše? Můžeš to udělat tímto způsobem:
 
-```
-$ mkdir pokus
-```  
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ mkdir pokus
+    
 
-```
-> mkdir pokus
-```  
+<!--endsec-->
 
-Tento malý příkaz vytvoří složku s názvem `pokus` na ploše. Zda se na ploše složka vytvořila můžeš zkontrolovat pouhým pohledem na pracovní plochu nebo spuštěním příkazu `ls` nebo `dir`! Zkus to :)
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir pokus
+    
+
+<!--endsec-->
+
+Tento malý příkaz vytvoří složku s názvem `pokus` na ploše. Jestli se na ploše složka vytvořila můžeš zkontrolovat pouhým pohledem na pracovní plochu nebo spuštěním příkazu `ls` nebo `dir`! Zkus to. :)
 
 > PRO tip: Pokud nechceš znovu a znovu zadávat stejné příkazy, zkus stisknutím `šipka nahoru` a `šipka dolů` na klávesnici přepínat mezi nedávno použitými příkazy.
 
@@ -181,25 +256,33 @@ Tento malý příkaz vytvoří složku s názvem `pokus` na ploše. Zda se na pl
 
 ### Cvičení!
 
-Malá výzva: v nově vytvořeném adresáři `pokus` vytvoř adresář s názvem `test`. Použij příkazy `cd` a `mkdir`.
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
 
 #### Řešení:
 
-```
-$ cd pokus
-$ mkdir test
-$ ls
-test
-```  
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ cd pokus
+    $ mkdir test
+    $ ls
+    test
+    
 
-```
-> cd pokus
-> mkdir test
-> dir
-05/08/2014 07:28 PM <DIR>      test
-```  
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd pokus
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
 
 Gratulujeme! :)
 
@@ -207,76 +290,116 @@ Gratulujeme! :)
 
 ### Jak odstranit složku
 
-Nechceme si nechat nepořádek v počítači, takže musíme odstranit vše, co jsme až do tohoto okamžiku dělaly.
+Nechceme si nechat nepořádek v počítači, takže musíme odstranit vše, co jsme až do tohoto okamžiku dělali.
+
+Zaprvé potřebujeme se dostat zpátky na plochu:
 
-Za prvé se potřebujeme dostat zpátky na plochu:
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
 
-```
-$ cd ..
-```  
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ cd ..
+    
 
-```
-> cd ..
-```  
+<!--endsec-->
 
-Použití `..` s příkazem `cd` změní tvůj aktuální adresář na rodičovský adresář (adresář, který obsahuje tvůj aktuální adresář).
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
 
 Zkontroluj, kde se nacházíš:
 
-```
-$ pwd
-/Users/olasitarska/Desktop
-```  
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ pwd 
+    /Users/olasitarska/Desktop
+    
 
-```
-> cd
-C:\Users\olasitarska\Desktop
-```  
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd 
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
 
 Teď je čas vymazat adresář `pokus`:
 
-> **Pozor**: odstraňování souborů pomocí `del`, `rmdir` nebo `rm` je nevratné, což znamená, *že odstraněné soubory budou navždy pryč*! Takže buď s tímto příkazem velmi opatrná.
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
 
-```
-$ rm -r pokus
-```  
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ rm -r pokus
+    
 
-```
-> rmdir /S pokus
-Are you sure <Y/N>? Y
-```  
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S pokus
+    Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
 
 Hotovo! Vše je skutečně odstraněno. Pojďme to zkontrolovat:
 
-```
-$ ls
-```  
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ ls
+    
 
-```
-> dir
-```  
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
 
 ### Zavření příkazové řádky
 
-To je pro tuto chvíli vše! Bezpečně můžeš nyní zavřít příkazovou řádku. Uděláme to hackerským stylem, ano? :)
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
 
-```
-$ exit
-```  
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ exit
+    
 
-```
-> exit
-```  
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
 
 Suprový, co? :)
 
@@ -284,22 +407,22 @@ Suprový, co? :)
 
 Zde je přehled některých užitečných příkazů:
 
-| Příkaz (Windows) | Příkaz (Mac OS / Linux) | Popis                    | Příklad                                           |
-| ---------------- | ----------------------- | ------------------------ | ------------------------------------------------- |
-| exit             | exit                    | Zavřít okno              | **exit**                                          |
-| cd               | cd                      | změnit adresář           | **cd test**                                       |
-| dir              | ls                      | seznam adresářů/souborů  | **dir**                                           |
-| copy             | cp                      | kopírovat soubor         | **copy c:\test\test.txt c:\windows\test.txt** |
-| move             | mv                      | přesunout soubor         | **move c:\test\test.txt c:\windows\test.txt** |
-| mkdir            | mkdir                   | vytvořit nový adresář    | **mkdir testdirectory**                           |
-| del              | rm                      | odstranit adresář/soubor | **del c:\test\test.txt**                        |
+| Příkaz (Windows)        | Příkaz (Mac OS / Linux) | Popis                      | Příklad                                           |
+| ----------------------- | ----------------------- | -------------------------- | ------------------------------------------------- |
+| zavření příkazové řádky | zavření příkazové řádky | Zavřít okno                | **zavření příkazové řádky**                       |
+| cd                      | cd                      | změnit adresář             | **cd test**                                       |
+| cd                      | pwd                     | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir                     | ls                      | seznam adresářů/souborů    | **dir**                                           |
+| copy                    | cp                      | kopírovat soubor           | **copy c:\test\test.txt c:\windows\test.txt** |
+| move                    | mv                      | přesunout soubor           | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir                   | mkdir                   | vytvořit nový adresář      | **mkdir testdirectory**                           |
+| rmdir (or del)          | rm                      | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S                | rm -r                   | delete a directory         | **rm -r testdirectory**                           |
 
 Toto je jen velmi malá část příkazů, které lze spustit v příkazovém řádku, ale pro dnešek to bude stačit.
 
-Pokud jsi zvědavá, na [ss64.com][1] je úplný přehled příkazů pro všechny operační systémy.
-
- [1]: http://ss64.com
+Pokud jsi zvědavá, na [ss64.com](http://ss64.com) je úplný přehled příkazů pro všechny operační systémy.
 
-## Připravena?
+## Připraveno?
 
-Pojďme se ponořit do Pythonu!
+Pojďme se ponořit do Pythonu!
\ No newline at end of file
diff --git a/cs/python_installation/README.md b/cs/python_installation/README.md
index 42f150debad..e19dfa4dcd6 100755
--- a/cs/python_installation/README.md
+++ b/cs/python_installation/README.md
@@ -2,12 +2,14 @@
 
 Konečně jsme u něj!
 
-Nejdříve si pojďme říci, co Python je. Python je velmi populární programovací jazyk, který lze použít k vytváření webových stránek, her, vědeckého software, grafického software a mnoho, mnoho dalšího.
+Nejdříve si pojďme říci co Python je. Python je velmi populární programovací jazyk, který lze použít k vytváření webových stránek, her, vědeckého software, grafického software a mnoho, mnoho dalšího.
 
-Python vznikl na konci 80. let a jeho hlavním cílem je být pro lidské bytosti čitelný (nejen pro stroje!). Právě proto vypadá mnohem jednodušeji než jiné programovací jazyky. Díky tomu je snadné se ho naučit, ale neboj, Python je opravdu mocný!
+Python vznikl na konci 80. let a jeho hlavním cílem je být čitelný lidským bytostem (nejen strojům!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
 
 # Instalace Pythonu
 
-> **Poznámka:** Pokud jsi již prošla přes kroky instalace, není třeba se k tomu znovu vracet - můžeš přeskočit přímo vpřed na další kapitolu!
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
 
-{% include "/python_installation/instructions.md" %}
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/cs/python_installation/instructions.md b/cs/python_installation/instructions.md
index 52466b1d549..deae1aee6df 100755
--- a/cs/python_installation/instructions.md
+++ b/cs/python_installation/instructions.md
@@ -1,64 +1,106 @@
-> Tato podkapitola čerpá z Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
 
-Django je napsán v Pythonu. Na to, abys mohla cokoliv dělat v Djangu, potřebuješ Python. Začněme s instalací! Chceme, aby sis nainstalovala verzi Python 3.4, takže pokud máš starší verzi, musíš ji upgradovat.
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
 
-### Windows
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
 
-Python pro Windows můžeš stáhnout z webové stránky https://www.python.org/downloads/release/python-343/. Po stažení **msi** souboru, bys jej měla spustit (poklepáním na něj) a postupovat podle uvedených pokynů. Je důležité si zapamatovat cestu (k adresáři), kam jsi Python nainstalovala. Později jej budeš potřebovat!
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
 
-Pozor na jednu věc: na druhé obrazovce průvodce instalací, označené "Přizpůsobit", se ujisti, že máš zvolenou možnost "Add python.exe to the Path":
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
 
-![Nezapomeň přidat Python do cesty](../python_installation/images/add_python_to_windows_path.png)
+![Nezapomeň přidat Python do cesty](../python_installation/images/python-installation-options.png)
 
-### Linux
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+Musíte jít na web https://www.python.org/downloads/release/python-361/ a stáhněte si instalátor Python:
+
+* Stáhni *Mac OS X 64-bit/32-bit installer* soubor,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
 
 Je velmi pravděpodobné, že již máš Python nainstalován v základní instalaci. Chceš-li zkontrolovat, zda jej máš nainstalován (a o jakou verzi se jedná), otevři konzoli a zadej následující příkaz:
 
-```
-$ python3 --version
-Python 3.4.2
-```  
+{% filename %}command-line{% endfilename %}
 
-Pokud Python nemáš nainstalovaný nebo pokud chceš nainstalovat jinou verzi, můžeš postupovat takto:
+    $ python3 – version 
+    Python 3.6.1
+    
 
-#### Debian nebo Ubuntu
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. Pokud Python nemáš nainstalovaný, nebo pokud chceš nainstalovat jinou verzi, můžeš postupovat takto:
 
-Použij tento příkaz v konzoli:
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Zadej tento příkaz do konzole:
+
+{% filename %}command-line{% endfilename %}
 
-```
-sudo apt-get install python3.4
-```
+    $ sudo apt-get install python3.6
+    
 
-#### Fedora
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
 
 Použij tento příkaz v konzoli:
 
-```
-$ sudo dnf nainstalovat python3.4
-```
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf nainstalovat python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
 
-#### openSUSE
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
 
 Použij tento příkaz v konzoli:
 
-```
-$ sudo zypper install python3
-```
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
 
-### OS X
+<!--endsec-->
 
-Musíš jít na web https://www.python.org/downloads/release/python-342/ a stáhnout si instalátor Python:
+Verify the installation was successful by opening a command prompt and running the `python3` command:
 
-  * Stáhni *Mac OS X 64-bit/32-bit installer* soubor,
-  * Poklepej na *python-3.4.3-macosx10.6.pkg*, chceš-li spustit instalační program.
+{% filename %}command-line{% endfilename %}
 
-Ověř, zda instalace proběhla úspěšně, otevři aplikaci *Terminal* a spusť příkaz `python3`:
+    $ python3 – version 
+    Python 3.6.1
+    
 
-```
-$ python3 – version
-Python 3.4.2
-```
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
 
 * * *
 
-Pokud máš nějaké pochybnosti nebo se něco při instalaci nepovedlo a ty nemáš ponětí, co dělat dál - zeptej se svého kouče! Někdy se věci nevyvíjejí hladce a je lepší požádat o pomoc někoho s více zkušenostmi.
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Někdy se věci nevyvíjejí hladce a je lepší požádat o pomoc někoho s více zkušenostmi.
\ No newline at end of file
diff --git a/cs/python_introduction/README.md b/cs/python_introduction/README.md
index 3448c09a381..5753f17b976 100755
--- a/cs/python_introduction/README.md
+++ b/cs/python_introduction/README.md
@@ -1,67 +1,87 @@
 # Úvod do Pythonu
 
-> Část této kapitoly je založena na kurzu Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 
 Pojďme napsat nějaký kód!
 
 ## Interaktivní režim Pythonu
 
-Chceš-li si začít hrát s Pythonem, musíme otevřít *příkazový řádek* v počítači. Již bys měla vědět jak na to – naučily jsme se to v kapitole [Úvod do příkazového řádku][1].
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
 
- [1]: ../intro_to_command_line/README.md
+Chceš-li si začít hrát s Pythonem, musíme otevřít *příkazový řádek* v počítači. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
 
 Jakmile budeš připravena, postupuj podle níže uvedených pokynů.
 
-Chceme otevřít Python konzoli, takže napiš `python` na Windows nebo `python3` na Mac a OS/Linuxu a zmáčkni `enter`.
+Chceme otevřít Python konzoli, tak napiš `python` na Windows nebo `python3` na Mac a OS/Linuxu a zmáčkni `enter`.
 
-```
-$ python3
-Python 3.4.3 (...)
-Type "help", "copyright", "credits" or "license" for more information.
->>>
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
 
 ## Tvůj první příkaz v Pythonu!
 
-Po spuštění interaktivního režimu Python se výzva na řádku změní na `>>>`. Pro nás to znamená, že pro tuto chvíli můžeme používat pouze příkazy v jazyce Python. Není nutné zadávat `>>>` - Python to udělá za tebe.
+Po spuštění interaktivního režimu Python, se výzva na řádku změní na `>>>`. Pro nás to znamená, že pro tuto chvíli můžeme používat pouze příkazy v jazyce Python. You don't have to type in `>>>` – Python will do that for you.
 
 Pokud chceš ukončit Python konzoli, kdykoliv stačí zadat `exit()` nebo použít zkratku `Ctrl + Z` na Windows a `Ctrl + D` pro Mac/Linux. Pak již neuvidíš `>>>`.
 
-Pro tuto chvíli nechceme Python konzoli opustit. Chceme se o ní naučit více. Začněme s něčím opravdu jednoduchým. Například zkusme napsat nějakou matematiku. Napiš třeba `2 + 3` a zmáčkni `enter`.
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
 
-```
->>> 2 + 3
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3 
 5
 ```
 
-Hezké! Vidíš, jak se zobrazila odpověď? Python umí matematiku! Můžeš zkusit jiné příkazy typu: `4 * 5` ; `5-1` ; `40 / 2`
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
 
-Chvíli si s tím hraj a pak se sem vrať zpátky :).
+```python
+>>> 2 ** 3
+8
+```
 
-Jak vidíš, Python je skvělá kalkulačka. Pokud tě zajímá, co jiného můžeš dělat...
+Chvíli si s tím hraj a pak se sem vrať zpátky. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
 
 ## Řetězce
 
 A co tvé jméno? Zadej své jméno do uvozovek, jak vidíš níže:
 
-```
->>> "Ola"
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" 
 "Ola"
 ```
 
-Nyní jsi vytvořila svůj první řetězec! Je to posloupnost znaků, které mohou být zpracovány počítačem. Řetězec musí vždy začínat a končit stejným znakem. To může být jednoduchá (`'`) nebo dvojitá (`"`) uvozovka (neexistuje žádný rozdíl!) Uvozovkami Pythonu říkáš, že co je uvnitř, je řetězec.
+Nyní jsi vytvořila svůj první řetězec! Je to posloupnost znaků, které mohou být zpracovány počítačem. Řetězec musí vždy začínat a končit stejným znakem. To může být jednoduchá (`'`) nebo dvojitá (`"`) uvozovka (neexistuje žádný rozdíl!) Uvozovkami Pythonu říkáš, že to co je uvnitř, je řetězec.
 
 Řetězce mohou být spojovány. Zkus toto:
 
-```
->>> "Ahoj " + "Ola"
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ahoj" + "Ola" 
 'Ahoj Ola'
 ```
 
 Také můžeš násobit řetězce s číslem:
 
-```
->>> "Ola" * 3
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3 
 'OlaOlaOla'
 ```
 
@@ -69,31 +89,39 @@ Pokud budeš chtít dát apostrof dovnitř svého řetězce, máš dvě možnost
 
 Pomocí dvojité uvozovky:
 
-```
->>> "Runnin' down the hill"
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill" 
 "Runnin' down the hill"
 ```
 
-nebo použít escape sekvenci - před apostrof napsat zpětné lomítko (\`):
+nebo použít escape sekvenci - před apostrof napsat zpětné lomítko (``):
 
-```
->>> 'Runnin\' down the hill'
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill' 
 "Runnin' down the hill"
 ```
 
 Pěkné, co? Chceš-li vidět své jméno velkými písmeny, jednoduše zadej:
 
-```
->>> "Ola".upper()
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper() 
 'OLA'
 ```
 
-Právě jsi použila `upper` **funkci** na svém řetězci! Funkce (jako `upper()`) je sled instrukcí, které Python provádí na daném objektu (`"Ola"`) poté, co ji zavoláš.
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
 
-Pokud chceš znát počet písmen ve svém jméně, tak pro to má Python také funkci!
+If you want to know the number of letters contained in your name, there is a **function** for that too!
 
-```
->>> len("Ola")
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola") 
 3
 ```
 
@@ -101,12 +129,12 @@ Zajímá tě, proč někdy voláš funkce s `.` na konci řetězce (jako `"Ola".
 
 ### Shrnutí
 
-OK, dost bylo řetězců. Co ses zatím naučila:
+OK dost řetězců. Co jsi se zatím naučila:
 
-*   **interaktivní režim Pythonu** - zadávání příkazů (kódu) do Pythonového interaktivního režimu a zobrazení výsledku/odpovědi v Pythonu
-*   **čísla a řetězce** - v Pythonu se čísla používají pro matematiku a řetězce pro textové objekty
-*   **operátor** - jako + a * kombinuje hodnoty a vytvoří nové
-*   **funkce** - jako upper() a len() provádí akce u objektů.
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
 
 To jsou základy každého programovacího jazyka. Připravena na něco dalšího? Vsadíme se, že ano!
 
@@ -114,709 +142,896 @@ To jsou základy každého programovacího jazyka. Připravena na něco dalšíh
 
 Pojďme zkusit něco nového. Můžeme zkusit zjistit délku čísla stejným způsobem, jakým jsme zjišťovali délku našeho jména? Zadej `len(304023)` a stiskni klávesu `Enter`:
 
-```
->>> len(304023)
-Traceback (most recent call last):
-File "<stdin>",
-line 1, in <module>
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023) 
+Traceback (most recent call last):   
+File "<stdin>", 
+line 1, in <module> 
 TypeError: object of type 'int' has no len()
 ```
 
 Zobrazila se ti naše první chyba! Ta říká, že objekty typu "int" (integers, celá čísla) nemají délku. Tak co můžeme udělat teď? Možná můžeme zkusit napsat naše číslo jako řetězec? Řetězce mají délky, že?
 
-```
->>> len(str(304023))
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023)) 
 6
 ```
 
 Funguje to! Použili jsme funkci `str` uvnitř funkce `len`. `str()` vše převádí na řetězec.
 
-*   Funkce `str`převede věci do **řetězců**
-*   Funkce `int` převede věci na **celá čísla**
+- Funkce `str`převede věci do **řetězců**
+- Funkce `int` převede věci na **celá čísla**
 
-> Důležité upozornění: můžeme převést čísla na text, ale nemůžeme jen tak převést text na čísla - co by se stalo, kdybychom se pokusily o toto: `int('hello')`?
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
 
 ## Proměnné
 
-Důležitým konceptem v programování jsou proměnné. Proměnná není nic jiného než pojmenování něčeho, co budeme chtít použít později. Programátoři proměnné používají k ukládání dat, aby byl jejich kód čitelnější a nemuseli si pamatovat, co dané věci jsou.
+Důležitým konceptem v programování jsou proměnné. Proměnná není nic jiného než pojmenování něčeho co budeme chtít použít později. Programátoři proměnné používají k ukládání dat, aby jejich kód byl čitelnější a nemusejí si pamatovat co dané věci jsou.
 
 Řekněme, že chceme vytvořit novou proměnnou s názvem `name`:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> name = "Ola"
 ```
 
-Vidíš? Je to snadné! Jednoduše napíšeš: name se rovná Ola.
+We type name equals Ola.
 
-Jak sis jistě všimla, tvůj program nevrátil nic jako předtím. Jak tedy víme, že proměnná skutečně existuje? Jednoduše zadejte `name` a stiskni klávesu `Enter`:
+Jak jsi si jistě všimla, tvůj program nic nevrátil jako to dělal před tím. Jak tedy víme, že proměnná skutečně existuje? Jednoduše zadejte `name` a stiskni klávesu `Enter`:
 
-```
->>> name
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name 
 'Ola'
 ```
 
-Hurá! První proměnná :)! Kdykoli můžeš změnit to, na co daná proměnná ukazuje:
+Yippee! Your first variable! :) You can always change what it refers to:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> name = "Sonja"
->>> name
+>>> name 
 'Sonja'
 ```
 
 Můžeš ji také použít ve funkcích:
 
-```
->>> len(name)
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name) 
 5
 ```
 
-Super, ne? Samozřejmě proměnná může obsahovat cokoliv, například také čísla! Zkus tohle:
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
 
-```
->>> a = 4
->>> b = 6
->>> a * b
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4 
+>>> b = 6 
+>>> a * b 
 24
 ```
 
 Ale co když použijeme nesprávné jméno? Dokážeš odhadnout, co se stane? Pojďme to zkusit!
 
-```
->>> city = "Tokyo"
->>> ctiy
-Traceback (most recent call last):   File "<stdin>", line 1, in <module>
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo" 
+>>> ctiy 
+Traceback (most recent call last):   File "<stdin>", line 1, in <module> 
 NameError: name 'ctiy' is not defined
 ```
 
-Chyba! Jak vidíš, Python má různé typy chyb a tato se nazývá **NameError**. Python ti vrátí tuto chybu, pokud se pokusíš použít proměnnou, která nebyla dosud definována. Pokud někdy dojde k této chybě, zkontroluj svůj kód, abys zjistila, jestli jsi nezadala nějaké jméno nesprávně.
+Chyba! Jak vidíš, Python má různé typy chyb a tato se nazývá **NameError**. Python ti vrátí tuto chybu pokud se pokusíš použít proměnnou, která nebyla dosud definována. Pokud někdy dojde k této chybě, zkontrolujte svůj kód, aby jsi zjistila jestli jsi nesprávně nezadala nějaké jméno.
 
-Chvilku si s tím, ať vidíš, co se s tím dá dělat!
+Hraj si s tím chvilku ať vidíš co se s tím dá dělat!
 
 ## Funkce print
 
-Zkus toto:
+Zkuste toto:
 
-```
->>> name = 'Maria'
->>> name
-'Maria'
->>> print(name)
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria' 
+>>> name 
+'Maria' 
+>>> print(name) 
 Maria
 ```
 
 Zadáš-li jen `name`, interpretr Pythonu reaguje na řetězcovou *reprezentaci* proměnné "name", což jsou písmena M-a-r-i-a, obklopená jednoduchými uvozovkami ''. Když napíšeš `print(name)`, Python vypíše obsah proměnné na obrazovku bez uvozovek, což vypadá lépe.
 
-Jak uvidíme později, funkce `print()` je také užitečná, když chceme vypsat věci uvnitř funkce nebo na více řádcích.
+Jak uvidíme později, funkce `print()` je také užitečná, když chceme vypsat věci uvnitř funkce, nebo když chceme tisknout věci na více řádcích.
 
 ## Seznamy
 
-Vedle řetězců a celých čísel má Python další druhy různých typů objektů. Teď se podíváme na jeden, který se nazývá **list**. Seznamy jsou přesně to, co si myslíš, že jsou: jsou to objekty, které obsahují seznam ostatních objektů :)
+Vedle řetězců a celých čísel má Python další druhy různých typů objektů. Teď se podíváme na jeden co se nazývá **list**. Seznamy jsou přesně to, co si myslíš, že jsou: jsou to objekty, které obsahují seznam ostatních objektů. :)
 
 Nestyď se a vytvoř seznam:
 
-```
->>> []
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> [] 
 []
 ```
 
-Ano, tento seznam je prázdný. Není moc užitečný, že? Pojďme vytvořit seznam čísel z loterie. Nechceme se stále opakovat, takže seznam uložíme také do proměnné:
+Ano, tento seznam je prázdný. Není velmi užitečný, že? Pojďme vytvořit seznam čísel z loterie. Nechceme se stále opakovat, takže seznam uložíme také do proměnné:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> lottery = [3, 42, 12, 19, 30, 59]
 ```
 
 Dobrá máme seznam! Co s ním můžeme dělat? Uvidíme, kolik čísel loterie je v seznamu. Máš nějakou představu, jakou funkci bys měla použít? Už to přeci víš!
 
-```
->>> len(lottery)
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery) 
 6
 ```
 
-Ano! Funkce `len()` ti zjistí počet objektů v seznamu. Šikovné, že? Možná bychom je teď měli zkusit seřadit:
+Ano! Funkce `len()` ti zjistí počet objektů v seznamu. Šikovné, že? Možná by jsme je teď měli zkusit seřadit:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> lottery.sort()
 ```
 
 Tato funkce nic nevrátí, jen změní pořadí čísel v seznamu. Pojďme ho znovu vypsat a uvidíme co se stalo:
 
-```
->>> print(lottery)
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery) 
 [3, 12, 19, 30, 42, 59]
 ```
 
-Jak můžeš vidět, čísla v seznamu jsou nyní seřazena od nejnižší k nejvyšší hodnotě. Gratulujeme!
+Jak můžeš vidět, čísla v seznamu jsou nyní seřazeny od nejnižší do nejvyšší hodnoty. Gratulujeme!
 
-Můžeme také zkusit obrátit pořadí? Udělejme to!
+Také můžeme zkusit obrátit pořadí? Udělejme to!
 
-```
->>> lottery.reverse()
->>> print(lottery)
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse() 
+>>> print(lottery) 
 [59, 42, 30, 19, 12, 3]
 ```
 
-Snadné, že? Pokud chceš něco přidat do svého seznamu, můžeš to provést zadáním tohoto příkazu:
+If you want to add something to your list, you can do this by typing this command:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> lottery.append(199)
 >>> print(lottery)
 [59, 42, 30, 19, 12, 3, 199]
 ```
 
-Pokud chceš zobrazit pouze první číslo, můžeš to udělat pomocí **indexů**. Index je číslo, které říká, kde se v seznamu položka najde. Programátoři preferují počítání od 0, takže první objekt v seznamu je v indexu 0, druhý je v indexu 1 a tak dále. Zkus toto:
+Pokud chceš zobrazit pouze první číslo, můžeš to udělat pomocí **indexů**. Index je číslo, které říká, kde v seznamu položky najde. Programátoři preferují počítání od 0, takže první objekt v seznamu je v indexu 0, další je v 1 a tak dále. Zkuste toto:
 
-```
->>> print(lottery[0])
-59
->>> print(lottery[1])
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0]) 
+59 
+>>> print(lottery[1]) 
 42
 ```
 
-Jak vidíš, pro přístup k různým objektům ve tvém seznamu použiješ jméno seznamu a index objektu uvnitř hranatých závorek.
+Jak můžeš vidět, pro přístup k různým objektům ve tvém seznamu použiješ jméno seznamu a index objektu uvnitř hranatých závorek.
 
-Chceš-li odstranit něco ze svého seznamu, budeš muset použít **indexy**, jak jsme se dozvěděli výše, a příkaz `pop()`. Zkusme to, co jsme se naučily dříve; budeme odstraňovat první číslo našeho seznamu.
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> print(lottery)
 [59, 42, 30, 19, 12, 3, 199]
 >>> print(lottery[0])
 59
 >>> lottery.pop(0)
+59
 >>> print(lottery)
 [42, 30, 19, 12, 3, 199]
 ```
 
 Funguje to všechno skvěle!
 
-Pro další zábavu zkus nějaké jiné indexy: 6, 7, 1000, -1, -6 nebo -1000. Pokus se předpovědět výsledek před zadáním příkazu. Jsou výsledky správné?
+Pro další zábavu, zkus nějaké jiné indexy: 6, 7, 1000, -1, -6 nebo -1000. Pokus se předpovědět výsledek před zadáním příkazu. Jsou výsledky správné?
 
 Seznam všech dostupných metod pro seznam nalezneš v této kapitole Python dokumentace: https://docs.python.org/3/tutorial/datastructures.html
 
 ## Slovníky
 
-Slovník je podobný seznamu, ale pro přístup k hodnotám se používá klíč místo indexu. Klíč může být jakýkoli řetězec nebo číslo. Syntaxe pro definování prázdného slovníku je:
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
 
-```
->>> {}
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {} 
 {}
 ```
 
 Vidíš, že jsi právě vytvořila prázdný slovník. Hurá!
 
-A teď zkus napsat následující příkaz (zkus nahradit vlastními informacemi):
+Now, try writing the following command (try substituting your own information, too):
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
 ```
 
-Tímto příkazem jsi právě vytvořila proměnnou s názvem `participant` s třemi dvojicemi klíčů hodnot:
+With this command, you just created a variable named `participant` with three key–value pairs:
 
-*   Klíč `name` odkazuje na hodnotu `"Ola"` (`string/řetězcový` objekt),
-*   klíč`country`, ukazuje na `"Polsko"` (další `řetězec`)),
-*   a `favorite_numbers` ukazuje `[7, 42, 92]` (`list/seznam` obsahující 3 čísla).
+- Klíč `name` odkazuje na hodnotu `"Ola"` (`string/řetězcový` objekt),
+- Klíč`country`, ukazuje na `"Polsko"` (další `řetězec`),
+- a `favorite_numbers` ukazuje `[7, 42, 92]` (`list/seznam` obsahující 3 čísla).
 
 Můžeš zkontrolovat obsah jednotlivých klíčů následující syntaxí:
 
-```
->>> print(participant['name'])
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name']) 
 Ola
 ```
 
-Je to podobné seznamu. Ale není nutné si pamatovat index - jen jméno.
+See, it's similar to a list. But you don't need to remember the index – just the name.
 
-Co se stane, když se zeptáme Pythonu na hodnotu klíče, který neexistuje? Zkus hádat! Pojďme to vyzkoušet a uvidíš!
+Co se stane, když se zeptáme Pythonu na hodnotu klíče, který neexistuje? Můžeš hádat? Pojďme to vyzkoušet a uvidíš!
 
-```
->>> participant['age']
-Traceback (most recent call last):
-File "<stdin>", line 1, in <module>
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age'] 
+Traceback (most recent call last):  
+File "<stdin>", line 1, in <module> 
 KeyError: 'age'
 ```
 
-Podívej, další chyba! Toto je **KeyError**. Python ti napomáhá a řekne ti, že klíč `"věk"` v tomto slovníku neexistuje.
+Podívej, další chyba! Toto je **KeyError**. Python ti napomáhá a řekne ti, že klíč `"věk"` neexistuje v tomto slovníku.
 
 Kdy použít slovník a kdy seznam? To je dobrý postřeh k zamyšlení. Kdy použít jakou variantu pochopíš, až si přečteš následující řádky.
 
-*   Potřebuješ jen seřazenou sekvenci položek? Použij seznam.
-*   Pokud potřebuješ přiřadit hodnotám klíče, abys je mohla později efektivně vyhledávat (klíčem)? Používej slovník.
+- Potřebuješ jen seřazenou sekvenci položek? Použij seznam.
+- Pokud potřebuješ přiřadit hodnotám klíče, aby jsi je mohla později efektivně vyhledávat (klíčem)? Používej slovník.
 
-Slovníky stejně jako seznamy jsou *mutable/proměnlivé*, což znamená, že je lze změnit po jejich vytvoření. Do slovníku můžeš přidat nové páry klíč/hodnota po jeho vytvoření:
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> participant['favorite_language'] = 'Python'
 ```
 
-Stejně jako u seznamů můžeš použít metodu `len()` na slovníky, vrací počet párů klíč/hodnota ve slovníku. Nestyď se a zadej příkaz:
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
 
-```
->>> len(participant)
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant) 
 4
 ```
 
-Doufám, že ti to nyní dává větší smysl. :) Připravena na více zábavy se slovníky? Pojďme na další řádek a další úžasné věci.
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
 
-Příkazem `pop()` odstraníš položky ve slovníku. Například pokud chceš odstranit záznam, kterému odpovídá klíč `"favorite_numbers"`, zadej následující příkaz:
+You can use the `pop()` method to delete an item in the dictionary. Například pokud chceš odstranit záznam, kterému odpovídá klíč `"favorite_numbers"`, zadej následující příkaz:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> participant.pop('favorite_numbers')
+[7, 42, 92]
 >>> participant
 {'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
 ```
 
-Jak vidíš, z výstupu byla odstraněna odpovídající dvojice klíč hodnota 'favorite_numbers'.
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
 
-Kromě toho můžeš také změnit hodnotu přidruženou k již vytvořenému klíči ve slovníku. Napiš:
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> participant['country'] = 'Germany'
 >>> participant
 {'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
 ```
 
-Jak můžeš vidět, hodnota klíče `'country'` se změnila z `"Poland"` na `"Germany"`. :) Úžasné? Hurá! Právě jsi se naučila další úžasnou věc.
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
 
 ### Shrnutí
 
 Skvělé! Nyní víš o programování hodně. V této poslední části jsi se naučila o:
 
-*   **errors/chyby** - nyní víš jak číst a pochopit chyby, které ti Python zobrazí, pokud nerozumí příkazu, který jsi zadala
-*   **proměnné/variables** - názvy pro objekty, které umožňují psát kód snadněji tak, aby byl čitelnější
-*   **seznamy/lists** - seznamy objektů uložených v určitém pořadí
-*   **slovníky/dictionaries** - objekty, které jsou uloženy jako dvojice klíč–hodnota
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
 
-Jsi připravena na další část?
+Jsi připravena na další část? :)
 
 ## Porovnávání věcí
 
-Velká část programování zahrnuje porovnání věci. Co je nejjednodušší věc k porovnání? Čísla, samozřejmě. Podívejme se, jak to funguje:
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
 
-```
->>> 5 > 2
-True
->>> 3 < 1
-False >>> 5 > 2 * 2
-True
->>> 1 == 1
-True
->>> 5 != 2
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2 
+True 
+>>> 3 < 1 
+False >>> 5 > 2 * 2 
+True 
+>>> 1 == 1 
+True 
+>>> 5 != 2 
 True
 ```
 
-Dali jsme Pythonu nějaká čísla na porovnání. Jak vidíš, Python může porovnávat nejen čísla, ale může také porovnat výsledky metod. Pěkný, co?
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
 
-Zajímá tě, proč jsme daly dva symboly rovná se `==` vedle sebe pro porovnání, zda jsou čísla stejná? Jedno rovnítko `=` používáme pro přiřazení hodnoty do proměnné. Vždy, **vždy** musíte dát dvě rovnítka `==`, pokud chcete zkontrolovat, jestli se věci navzájem rovnají. Můžeme také zjišťovat, že se věci navzájem nerovnají. Pro takové porovnání můžeme použít symbol `!=`, jak je uvedeno v příkladu výše.
+Zajímá tě, proč jsme dali dva symboly rovná se `==` vedle sebe, pro porovnání zda-li jsou čísla stejná? Jedno rovná se `=` používáme pro přiřazení hodnoty do proměnné. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. Můžeme také zjišťovat, že se věci navzájem nerovnají. Pro takové porovnání můžeme použít symbol `!=`, jak je uvedeno v příkladu výše.
 
 Dejme Pythonu dva další úkoly:
 
-```
->>> 6 >= 12 / 2
-True
->>> 3 <= 2
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2 
+True 
+>>> 3 <= 2 
 False
 ```
 
-`>` a `<` jsou pro použití snadné, ale co `> =` a `< =` - víš, co se tím myslí? Podívejme se na to:
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
 
-*   x `>` y znamená: x je větší než y
-*   x `<` y znamená: x je menší než y
-*   x `<=` y znamená: x je menší nebo rovno y
-*   x `>=` y znamená: x je větší nebo rovno y
+- x `>` y znamená: x je větší než y
+- x `<` y znamená: x je menší než y
+- x `<=` y znamená: x je menší nebo rovno y
+- x `>=` y znamená: x je větší nebo rovno y
 
 Úžasné! Chceš zkusit ještě něco? Zkuste tohle:
 
-```
->>> 6 > 2 and 2 < 3
-True
->>> 3 > 2 and 2 < 1
-False
->>> 3 > 2 or 2 < 1
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3 
+True 
+>>> 3 > 2 and 2 < 1 
+False 
+>>> 3 > 2 or 2 < 1 
 True
 ```
 
 Pythonu můžeš dát porovnat tolik čísel kolik chceš a na vše ti dá odpověď! Je docela chytrý, že?
 
-*   **and** - Pokud použiješ operátor `and`, obě strany musí být pravdivé, aby celý příkaz byl pravdivý
-*   **or** - Pokud použiješ operátor `or`, stačí, aby jen jedna strana z porovnání byla pravdivá, aby celý příkaz byl pravdivý
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
 
 Už jsi někdy slyšela výraz "srovnávat jablka a hrušky"? Zkusme v Pythonu ekvivalent:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> 1 > 'django'
 Traceback (most recent call last):
-File "<stdin>", line 1, in <module>
-TypeError: unorderable types: int() > str()
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
 ```
 
 Zde vidíš, že stejně jako nelze srovnávat "jablka a hrušky", Python není schopen porovnávat řetězce (`str`) a čísla (`int`). Místo toho zobrazí **TypeError** a říká nám, že tyto dva typy nelze srovnávat společně.
 
 ## Logic hodnoty/Booleany
 
-Mimochodem právě jste se dozvěděly o novém typu objektu v Pythonu. Říká se mu **boolean** a je to asi nejjednodušší typ.
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
 
-Existují pouze dva logické objekty: - True - False
+- True
+- False
 
-Aby Python pochopil, že se jedná o tento typ, je potřeba vždy psát jako True (první písmeno velké, zbytek malý). **true, TRUE, tRUE nebude fungovat – jedině True je správně.** (Totéž samozřejmě platí pro False.)
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
 
 Pravdivostní hodnoty mohou být také v proměnné! Viz zde:
 
-```
->>> a = True
->>> a
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True 
+>>> a 
 True
 ```
 
 Rovněž to můžete provést takto:
 
-```
->>> a = 2 > 5
->>> a
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5 
+>>> a 
 False
 ```
 
 Zkoušej a bav se s logickými hodnotami. Zkus spustit následující příkazy:
 
-*   `True and True`
-*   `False and True`
-*   `True or 1 == 1`
-*   `1 != 2`
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
 
-Gratulujeme! Logické hodnoty jsou jedny z nejbezvadnějších vlastností v programování a vy jste se je právě naučily používat!
+Gratulujeme! Logické hodnoty jsou jedny z nejbezvdnějších vlastností v programování, a právě jste se je naučili používat!
 
 # Ulož to!
 
-Zatím jsme psaly všechny naše programy v konzoli v interaktivním režimu Pythonu, který nás omezuje na jeden řádek kódu v jednu chvíli. Normální programy jsou uloženy v souborech a spouští je **konzole** nebo **překladač** programovacího jazyku. Zatím jsme spouštěly naše programy po jednom řádku v **konzoli, v interaktivním režimu** Python. Pro příštích několik úkolů budeme potřebovat více než jeden řádek kódu, takže rychle musíme:
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
 
-*   Ukončit interaktivní režim Pythonu
-*   Otevřít náš zvolený editor kódu
-*   Uložit nějaký kód do nového pythonovského souboru
-*   Spustit ho!
+Zatím jsme psali všechny naše programy v konzoli v interaktivním režimu Pythonu, který nás omezuje na jeden řádek kódu v jednu chvíli. Normální programy jsou uloženy v souborech a spouští je **konzole** nebo **překladač** programovacího jazyku. Zatím jsme spouštěli naše programy po jednom řádku v **konzoli, v interaktivním režimu** Python. Pro příštích několik úkolů budeme potřebovat více než jeden řádek kódu, takže rychle musíme:
 
-Chceš-li opustit interaktivní režim Pythonu, který jsme dosud používaly, jednoduše zadejte ~ ~ ~ exit() ~ ~ ~ funkci:
+- Ukončit interaktivní režim Pythonu
+- Otevřít tvůj zvolený editor kódu
+- Ulož nějaký kód do nového pythnovského souboru
+- Spusť ho!
 
-```
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> exit()
 $
 ```
 
 Tak se dostaneš zpět do příkazové řádky.
 
-Dříve sis vybrala editor kódu v části [editor kódu][2]. Nyní potřebujeme editor otevřít a napsat vlastní kód do nového souboru:
+Dříve jsi si vybrala editor kódu v části [editor kódu](../code_editor/README.md). Nyní potřebujeme otevřít editor a napsat vlastní kód do nového souboru:
 
- [2]: ../code_editor/README.md
+{% filename %}editor{% endfilename %}
 
 ```python
 print('Hello, Django girls!')
 ```
 
-> **Poznámka:** Měla bys objevit jednu z nejúžasnější věcí na editorech kódu: barvy! V interaktivním režimu Pythonu mělo vše stejnou barvu, ale nyní bys měla vidět, že funkce `print` je jinou barvou než řetězec uvnitř. To se nazývá "zvýrazňování syntaxe" a je to opravdu užitečná funkce při kódování. Barvy ti napoví, že máš neuzavřený řetězce nebo překlep v názvu slova (jako `def` ve funkci, kterou uvidíš níže). To je jeden z důvodů, proč používáme editory kódu :)
+Samozřejmě teď jsi již pěkně ostřílená python programátorka, tak neváhej napsat nějaký kód, který jsi se dnes naučila.
 
-Samozřejmě teď jsi již pěkně ostřílená python programátorka, tak neváhej napsat nějaký kód, který ses dnes naučila.
+Teď potřebujeme uložit vytvořený soubor a dát mu popisný název. Pojďme ho nazvat **python_intro.py** a uložte jej na plochu. Soubor můžeš pojmenovat jakkoliv chceš, ale důležitá věc je, aby jsi se ujistila, že soubor končí na **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
 
-Teď potřebujeme uložit vytvořený soubor a dát mu popisný název. Pojďme ho nazvat **python_intro.py** a uložit jej na plochu. Soubor můžeš pojmenovat jakkoliv chceš, ale důležitá věc je, aby ses ujistila, že soubor končí na **.py**. Přípona **.py** říká našemu operačnímu systému, že jde o **spustitelný soubor Pythonu** a Python ho může spustit.
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. To se nazývá "zvýrazňování syntaxe" a je to opravdu užitečná funkce při kódování. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). To je jeden z důvodů, proč používáme editory kódu. :)
 
-Pokud máš soubor uložen, je čas jej spustit! Pomocí dovedností, které jsi se naučila v sekci příkazová řádka, **změň adresář**  pomocí terminálu na plochu.
+Pokud máš soubor uložen je čas jej spustit! Pomocí dovedností, které jsi se naučila v sekci příkazová řádka, pomocí terminálu **změň adresář** na plochu.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
 
 Na Macu bude příkaz vypadat přibližně takto:
 
-```
-$ cd ~/Desktop
-```
+{% filename %}command-line{% endfilename %}
 
-Na Linuxu to bude vypadat takto (slovo "Desktop" (Plocha) může být přeloženo do tvého jazyka):
+    $ cd ~/Desktop
+    
 
-```
-$ cd ~/Desktop
-```
+<!--endsec-->
 
-A na Windows to bude vypadat takto:
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
 
-```
-> cd %HomePath%\Desktop
-```
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
 
 Pokud nevíš jak dál, stačí požádat o pomoc kouče.
 
 Nyní pomocí Pythonu spustíš kód v souboru takto:
 
-```
-$ python3 python_intro.py
-Hello, Django girls!
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
 ```
 
 V pořádku! Právě jsi spustila svůj první program v Pythonu, který byl uložen do souboru. Cítíš se úžasně?
 
 Nyní můžeme přejít k základním nástrojům pro programování:
 
-## If...elif...else
+## If … elif … else
 
-Spousty věcí v kódu chceme provádět, jen pokud jsou splněny určité podmínky. To je důvod, proč Python má něco, čemu se říká **if statements**.
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
 
 Nahraďte kód v souboru **python_intro.py** tímto:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
 ```
 
-Pokud jsi soubor uložila a spustila, pravděpodobně uvidíš následující chybu:
+If we were to save and run this, we'd see an error like this:
 
-```
-$ python3 python_intro.py
-File "python_intro.py", line 2
-          ^
-SyntaxError: unexpected EOF while parsing
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    File "python_intro.py", line 2
+              ^ 
+    SyntaxError: unexpected EOF while parsing
+    
 
-Python očekává, že mu dáš další pokyny, které mají být provedeny, pokud bude podmínka `3 > 2` splněna (`True`). Řekněme tedy Pythonu, ať vypíše "Funguje to!". Změň svůj kód v souboru **python_intro.py** na tento:
+Python očekává, že mu dáš další pokyny, které mají být provedeny pokud bude podmínka `3 > 2` splněna (`True`). Řekněme tedy Pythonu, ať vypíše "Funguje to!". Změň svůj kód v souboru **python_intro.py** na tento:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 if 3 > 2:
-     print('It works!')
+    print('It works!')
 ```
 
-Všimla sis, jak jsme odsadily poslední řádek kódu o 4 mezery? Musíme to udělat, podle toho Python pozná, jakou část kódu má spustit, pokud vyhodnotí předchozí výraz jako pravdivý. Můžete udělat jen jednu mezeru, ale téměř všichni programátoři v Pythonu dělají 4, aby kód vypadal upraveně a čitelně. Jeden `Tab` bude také počítán jako 4 mezery.
+Všimla sis, jak jsme odsadili poslední řádek kódu o 4 mezery? Musíme to udělat, podle toho Python pozná, jakou část kódu má spustit pokud vyhodnotí předchozí výraz jako true. Můžete udělat jen jednu mezeru, ale téměř všichni programátoři v Pythonu dělají 4, aby kód vypadal upraveně a čitelně. Jeden `Tab` bude také počítán jako 4 mezery.
 
 Ulož a spusť:
 
-```
-$ python3 python_intro.py
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py 
 It works!
 ```
 
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
 ### Co když podmínka není pravdivá?
 
 V předchozích příkladech byl kód proveden pouze v případě, že podmínky byly splněny. Python má také příkazy `elif` a `else`:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 5 > 2:
-     print('5 is indeed greater than 2')
+    print('5 is indeed greater than 2')
 else:
-     print('5 is not greater than 2')
+    print('5 is not greater than 2')
 ```
 
-Pokud je výraz pravdivý, po spuštění se vytiskne:
+Pokud je výraz pravdivý po spuštění se vytiskne:
 
-```
-$ python3 python_intro.py
-5 is not greater than 2
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    5 is indeed greater than 2
+    
 
-Kdyby 2 bylo větší než 5, spustil by se první příkaz. Jak snadné! Podívejme se, jak funguje `elif`:
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 name = 'Sonja'
 if name == 'Ola':
-     print('Hey Ola!')
+    print('Hey Ola!')
 elif name == 'Sonja':
-     print('Hey Sonja!')
+    print('Hey Sonja!')
 else:
-     print('Hey anonymous!')
+    print('Hey anonymous!')
 ```
 
 a spusť:
 
-```
-$ python3 python_intro.py
-Hey Sonja!
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
 
-Viděla jsi co se tam stalo? `elif` umožňuje přidat další podmínky, které se spustí, pokud se předchozí podmínky nezdaří.
+Viděla jsi co se tam stalo? `elif` umožňuje přidat další podmínky, které se spustí pokud se předchozí podmínky nezdaří.
 
-Můžeš po počátečním `if` přidat tolik `elif` příkazů, kolik se ti zlíbí. Například:
+Můžeš přidat tolik `elif` příkazů, kolik se ti zlíbí po počátečním `if`. Například:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 volume = 57
 if volume < 20:
-     print("Je to dost potichu.")
+    print("It's kinda quiet.")
 elif 20 <= volume < 40:
-     print("Jako hudba v pozadí dobré.")
+    print("It's nice for background music")
 elif 40 <= volume < 60:
-     print("Skvělé, slyším všechny detaily.")
+    print("Perfect, I can hear all the details")
 elif 60 <= volume < 80:
-     print("Dobré na party.")
+    print("Nice for parties")
 elif 80 <= volume < 100:
-     print("Trochu moc nahlas!")
+    print("A bit loud!")
 else:
-    print("Krvácí mi uši!")
+    print("My ears are hurting! :(")
 ```
 
 Python prochází a testuje každou položku v posloupnosti a vypíše:
 
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+     dokonalé, můžete slyšet všechny detaily
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
 ```
-$ python3 python_intro.py
-  Skvělé, slyším všechny detaily.
-```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
 
 ### Shrnutí
 
-V posledních třech cvičeních ses dozvěděla o:
+In the last few exercises you learned about:
 
-*   **Porovnání věcí** - v Pythonu můžeš porovnat věci pomocí operátorů `>`, `> =`, `==` `< =`, `<` a `and`, `or`
-*   **Logické hodnoty / Booleany** - typy, které mohou mít pouze jednu ze dvou hodnot: `True` nebo `False`
-*   **Ukládání do souborů** - pokud uložíme kód do souboru, můžeme spouštět velké programy
-*   **if...elif...else** - příkazy, které umožňují spouštět kód pouze v případě, kdy jsou splněny určité podmínky.
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
 
 Čas na poslední část této kapitoly!
 
 ## Vlastní funkce!
 
-Pamatuješ na funkci `len()`, kterou jsi spouštěla v Pythonu? Máme pro tebe dobrou zprávu. Nyní se dozvíš, jak napsat své vlastní funkce!
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+Funkce je sled instrukcí, které by měl Python provést. Každá funkce v Pythonu začíná s klíčovým slovem `def`, dále je uveden název a funkce může mít také nějaké parametry. Let's give it a go. Nahraď kód v **python_intro.py** následujícím:
 
-Funkce je sled instrukcí, které by měl Python provést. Každá funkce v Pythonu začíná klíčovým slovem `def`, dále je uveden název a funkce může mít také nějaké parametry. Začněme u té nejlehčí. Nahraď kód v **python_intro.py** následujícím:
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi():
-     print('Hi there!')
-     print('How are you?')
+    print('Hi there!')
+    print('How are you?')
 
 hi()
 ```
 
 Naše první funkce je připravena!
 
-Asi se divíš, proč jsme napsaly název funkce v dolní části souboru. To je proto, že Python přečte soubor a spustí ho od shora dolů. Pokud chceš využívat svou funkci, musíš její název znovu napsat dole (tím ji zavoláš/spustíš).
+Asi se divíš, proč jsme napsali název funkce v dolní části souboru. To je proto, že Python přečte soubor a spustí ho od shora dolů. Pokud chceš využívat svou funkci, musíš její název znovu napsat dole (tím jí zavoláš/spustíš).
 
-Tak to teď zkus a uvidíš, co se stane:
+Tak to teď zkus a uvidíš co se stane:
 
-```
-$ python3 python_intro.py
-Hi there!
-How are you?
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hi there! 
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
 
-To bylo snadné! Napišme naši první funkci s parametry. Použijeme předchozí příklad - napíšeme funkci, která nás pozdraví podle toho, jaké zadáme jméno při jejím spuštění:
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi(name):
 ```
 
-Jak vidíš, nyní jsme přidaly naší funkci parametr, `name`:
+Jak vidíš, nyní jsme přidali naší funkci parametr, `name`:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi(name):
-     if name == 'Ola':
-         print('Hi Ola!')
-     elif name == 'Sonja':
-         print('Hi Sonja!')
-     else:
-         print('Hi anonymous!')
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
 
 hi()
 ```
 
 Pamatuj si: Funkce `print` je odsazená čtyři mezery v příkazu `if`. To je proto, aby se funkce spustila, pokud je splněna podmínka. Podívej se, jak to funguje nyní:
 
-```
-$ python3 python_intro.py
-Traceback (most recent call last):
-File "python_intro.py", line 10, in <module>
-   hi()
-TypeError: hi() missing 1 required positional argument: 'name'
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Traceback (most recent call last): 
+    File "python_intro.py", line 10, in <module>
+       hi() 
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
 
-Jejda, chyba. Naštěstí nám Python vypsal docela užitečnou chybovou zprávu. Jak vidíš, funkce `hi()` (kterou jsme definovaly) má jeden povinný parametr `(s názvem name)`, který jsme zapomněly při volání funkce předat. Pojďme to opravit v následující části:
+Jejda chyba. Naštěstí Python nám vypsal docela užitečné chybovou zprávu. Jak můžeš vidět nyní funkce `hi()` (kterou jsme definovali) má jeden povinný parametr `(s názvem name)` a zapomněli jsme ho předat při volání funkce. Pojďme to opravit v následující části:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 hi("Ola")
 ```
 
-A znovu jej spusť:
+A znovu jej spusťte:
 
-```
-$ python3 python_intro.py
-Hi Ola!
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hi Ola!
+    
 
-A co když změníme jméno?
+Pokud změníme jméno?
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 hi("Sonja")
 ```
 
-Spustíme:
+S SpuStíme:
 
-```
-$ python3 python_intro.py
-Hi Sonja!
-```
+{% filename %}command-line{% endfilename %}
 
-C myslíš, že se stane, když tam napíšeš jiné jméno než Ola nebo Sonja? Zkus to a uvidíme, jestli máš pravdu. Mělo by to vypsat toto:
+    $ python3 python_intro.py 
+    Hi Sonja!
+    
 
-```
-Hi anonymous!
-```
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+To je paráda, co? Nemusíš se opakovat a měnit touto cestou jméno pokaždé, když chceš aby funkce pozdravila jinou osobu. And that's exactly why we need functions – you never want to repeat your code!
 
-To je paráda, co? Nemusíš se opakovat a měnit takto jméno pokaždé, když chceš, aby funkce pozdravila jinou osobu. To je přesně důvod, proč potřebujeme funkce: abychom nikdy neopakovaly náš kód!
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
 
-Udělejme to ještě chytřeji – existuje více jmen než dvě a psaní podmínky pro každé jméno by bylo těžké, že?
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi(name):
-     print('Hi ' + name + '!')
+    print('Hi ' + name + '!')
 
 hi("Rachel")
 ```
 
 Pojďme zavolat náš nový kód:
 
-```
-$ python3 python_intro.py
-Hi Rachel!
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hi Rachel!
+    
 
-Blahopřejeme! Právě ses naučila, jak psát funkce :)
+Blahopřejeme! Právě jste se naučili, jak psát funkce! :)
 
 ## Smyčky/Loops
 
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
 Nyní pojďme na poslední část. To bylo rychlé, co? :)
 
-Programátoři se neradi opakují. Programování je o automatizaci věci, takže nechceme zdravit každého člověka podle jeho jména manuálně, že? Zde se budou smyčky hodit.
+Programátoři se neradi opakují. Programování je o automatizaci věci, takže nechceme zdravit každého člověka podle jeho jména, manuálně, že? Zde se budou smyčky hodit.
 
 Ještě si vzpomínáš na seznamy? Udělejme seznam dívek:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
 ```
 
-Chceme pozdravit všechny s použitím jejich jména. Máme funkci `hi`, která to umí udělat. Tak ji použijeme ve smyčce:
+Chceme pozdravit všechny s použitím jejich jména. Máme funkci `hi` která to umí udělat. Tak ji použijeme ve smyčce:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 for name in girls:
 ```
 
-Příkaz ~ ~ ~ for ~ ~ ~ se chová podobně jako příkaz ~ ~ ~ if ~ ~ ~, v následujícím kódu musíme oba řádky odsadit o čtyři mezery.
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
 
 Zde je celý kód, který umístíme do souboru:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
-     print('Hi ' + name + '!')
+    print('Hi ' + name + '!')
 
 girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
 for name in girls:
-     hi(name)
-     print('Next girl')
+    hi(name)
+    print('Next girl')
 ```
 
 A když ho spustíme:
 
-```
-$ python3 python_intro.py
-Hi Rachel!
-Next girl
-Hi Monica!
-Next girl
-Hi Phoebe!
-Next girl
-Hi Ola!
-Next girl
-Hi You!
-Next girl
-```
+{% filename %}command-line{% endfilename %}
 
-Jak vidíš, vše, co jsi vložila dovnitř příkazu `for` s odsazením, se zopakuje pro každý prvek seznamu `girls`.
+    $ python3 python_intro.py 
+    Hi Rachel! 
+    Next girl 
+    Hi Monica! 
+    Next girl 
+    Hi Phoebe! 
+    Next girl 
+    Hi Ola! 
+    Next girl 
+    Hi You! 
+    Next girl
+    
+
+Jak můžeš vidět, vše co jsi vložila dovnitř příkazu `for` s odsazením, se zopakuje pro každý element seznamu `girls`.
 
 Ve funkci `for` můžeš také použít čísla pomocí funkce `range`:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 for i in range(1, 6):
      print(i)
@@ -824,24 +1039,23 @@ for i in range(1, 6):
 
 Což ti vypíše:
 
-```
-1
-2
-3
-4
-5
-```
+{% filename %}command-line{% endfilename %}
 
-`range` je funkce, která vytvoří seznam s posloupností čísel (tato čísla zadáváš jako parametry funkce).
+    1 
+    2
+    3 
+    4 
+    5
+    
 
-Všimni si, že druhé z těchto dvou čísel není zahrnuto v seznamu, který je výstupem Pythonu (`range (1, 6)` počítá od 1 do 5, ale nezahrnuje číslo 6). To je proto, že "range" je z poloviny otevřený, čímž myslíme, že obsahuje první hodnotu, ale ne poslední.
+`range` je funkce, která vytvoří seznam s posloupností čísel (tyto čísla zadáváš jako parametry funkce).
 
-## Shrnutí
+Všimni si, že druhé z těchto dvou čísel není zahrnuto v seznamu, který je výstupem Pythonu (`range (1, 6)` počítá od 1 do 5, ale nezahrnuje číslo 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
 
-A je to. **Jsi naprosto skvělá!** To byla složitá kapitola, takže bys na sebe měla být hrdá. My jsme na tebe velmi hrdí za to, že ses dostala tak daleko!
+## Shrnutí
 
-Můžeš si jít krátce odpočinout - protáhnout se, projít se, zavřít oči - než se pustíme do další kapitoly. :)
+A je to. **Jsi naprosto skvělá!** To byla složitá kapitola, takže měla bys být na sebe hrdá. My jsme na tebe velmi hrdí za to, že jsi se dostala tak daleko!
 
-![Hrnek][3]
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
 
- [3]: images/cupcake.png
+![Hrnek](images/cupcake.png)
\ No newline at end of file
diff --git a/cs/signup_pythonanywhere.md b/cs/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/cs/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/cs/template_extending/README.md b/cs/template_extending/README.md
index 184c85aa05b..2228fed2070 100755
--- a/cs/template_extending/README.md
+++ b/cs/template_extending/README.md
@@ -1,106 +1,130 @@
 # Rozšiřování šablon
 
-Další pěknou věcí, kterou pro nás Django má, je **rozšiřování šablon**. Co to znamená? To znamená, že můžeš použít stejné HTML pro různé stránky na svém blogu.
+Další pěknou věcí, kterou pro nás Django má je **rozšiřování šablon**. Co to znamená? To znamená, že můžeš použít stejné HTML pro různé stránky na svém blogu.
 
-Tímto způsobem nemusíš opakovat v každém souboru stejný kód, když chceš použít stejné informace/rozvržení. A pokud chceš něco změnit, není nutné to dělat v každé šabloně, stačí jen v jedné!
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
 
-## Vytvoření základní šablony
+## Create a base template
 
-Základní šablona je šablona, kterou použijeme na každé stránce našich webových stránek.
+Základní šablona je šablona, kterou rozšíříme na každé stránce našich webových stránek.
 
 Vytvoříme soubor `base.html` v `blog/templates/blog/`:
 
-```
-blog
-└───templates
-     └───blog
-             base.html
-             post_list.html
-```  
+    blog 
+    └───templates
+         └───blog
+                 base.html
+                 post_list.html
+    
+
+Pak jej otevři a zkopírujte vše z `post_list.html` do `base.html` souboru, jako je to níže:
 
-Pak jej otevři a zkopíruj vše z `post_list.html` do `base.html` souboru, jako je to níže:
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
 <html>
-     <head>
-         <title>Django Girls blog</title>
-         <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-         <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
-         <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
-         <link rel="stylesheet" href="{% static 'css/blog.css' %}">
-     </head>
-     <body>
-         <div class="page-header">
-             <h1><a href="/">Django Girls Blog</a></h1>
-         </div>
-         <div class="content container">
-             <div class="row">
-                 <div class="col-md-8">
-                 {% for post in posts %}
-                     <div class="post">
-                         <div class="date">
-                             {{ post.published_date }}
-                         </div>
-                         <h1><a href="">{{ post.title }}</a></h1>
-                         <p>{{ post.text|linebreaksbr }}</p>
-                     </div>
-                 {% endfor %}
-                 </div>
-             </div>
-         </div>
-     </body>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
 </html>
-```  
+```
+
+Pak v `base.html`, nahraď celé `< body >` (vše mezi `< body >` a `< / body >`) tímto:
 
-Pak v `base.html` nahraď celé `<body>` (vše mezi `<body>` a `</body>`) tímto:
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 <body>
-     <div class="page-header">
-          <h1><a href="/">Django Girls Blog</a></h1>
-     </div>
-     <div class="content container">
-         <div class="row">
-             <div class="col-md-8">
-             {% block content %}
-             {% endblock %}
-             </div>
-         </div>
-     </div>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
 </body>
 ```
 
-Nahradili jsme v podstatě všechno, co bylo mezi `{% for post in posts %}{% endfor %}`, za:
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% block content %}
 {% endblock %}
-```    
+```
 
-Co to znamená? Právě jsi vytvořila `block`, což je šablonovací značka, která umožňuje vkládat HTML kód do tohoto bloku v jiných šablonách, které rozšiřují `base.html`. Hned ti ukážeme, jak to udělat.
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). Hned ti ukážeme jak to udělat.
 
-Nyní ulož a znovu otevři svůj `blog/templates/blog/post_list.html`. Odstraň vše, co není uvnitř body, a pak také odstraň `< div class="page-header" >< / div >`, takže soubor bude vypadat takto:
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
-     <div class="post">
-         <div class="date">
-             {{ post.published_date }}
-         </div>
-         <h1><a href="">{{ post.title }}</a></h1>
-         <p>{{ post.text|linebreaksbr }}</p>
-     </div>
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endfor %}
-```    
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
 
-A teď přidej na začátek souboru tento řádek:
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Takto:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-{% extends 'blog/base.html' %}
-```    
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
 
-{% raw %} to znamená, že nyní rozšiřujeme šablonu `base.html` v `post_list.html`. Jen jedna věc zbývá: vše dát (kromě řádku, který jsme právě přidaly) mezi `{% block content %}` a `{% endblock %}`. Takto: {% endraw %}
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -116,8 +140,8 @@ A teď přidej na začátek souboru tento řádek:
         </div>
     {% endfor %}
 {% endblock %}
-```  
+```
 
-To je ono! Zkontroluj, zda tvoje stránky stále správně fungují :)
+To je ono! Zkontroluj, zda tvoje stránky stále správně fungují. :)
 
-> Jestliže dostaneš chybu `TemplateDoesNotExists`, která říká, že neexistuje žádný soubor `blog/base.html` a máš `runserver` v konzoli, zkus ho zastavit (stisknutím kombinace kláves Ctrl + C - ctrl a tlačítka C společně) a restartovat spuštěním příkazu `pythonu manage.py runserver`.
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/cs/whats_next/README.md b/cs/whats_next/README.md
index 5c52f3bfb88..061da70e702 100755
--- a/cs/whats_next/README.md
+++ b/cs/whats_next/README.md
@@ -1,40 +1,25 @@
 # Co dál?
 
-Můžeš si pogratulovat! **Jsi naprosto úžasná**. Jsme na tebe hrdí! < 3
+Můžeš si pogratulovat! **Jsi naprosto úžasná**. Jsme na tebe hrdí! <3
 
 ### Co mám dělat teď?
 
 Odpočiň si a relaxuj. Právě jsi udělala něco opravdu obrovského.
 
-Poté nezapomeň:
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
 
-*   Sleduj Django Girls na [Facebooku][1] nebo [Twitteru][2] a zůstaň v obraze
+### Můžete mi doporučit nějaké další zdroje?
 
- [1]: http://facebook.com/djangogirls
- [2]: https://twitter.com/djangogirls
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
 
-### Můžete mi doporučit nějaké další zdroje?
+Later on, you can try the resources listed below. They're all very recommended!
 
-Ano! Zaprvé, jdi a zkus naši další knihu, jmenuje se [Django Girls Tutorial: Extensions][3].
-
- [3]: https://tutorial-extensions.djangogirls.org
-
-Později můžeš zkusit, některý ze zdrojů uvedených níže. Všechny můžeme velmi doporučit!
-
-- [Django's official tutorial][4]
-- [New Coder tutorials][5]
-- [Code Academy Python course][6]
-- [Code Academy HTML & CSS course][7]
-- [Django Carrots tutorial][8]
-- [Learn Python The Hard Way book][9]
-- [Getting Started With Django video lessons][10]
-- [Two Scoops of Django: Best Practices for Django 1.8 book][11]
-
- [4]: https://docs.djangoproject.com/en/1.8/intro/tutorial01/
- [5]: http://newcoder.io/tutorials/
- [6]: https://www.codecademy.com/en/tracks/python
- [7]: https://www.codecademy.com/tracks/web
- [8]: https://github.com/ggcarrots/django-carrots/
- [9]: http://learnpythonthehardway.org/book/
- [10]: http://www.gettingstartedwithdjango.com/
- [11]: https://twoscoopspress.com/products/two-scoops-of-django-1-8
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/de-DE/GLOSSARY.md b/de-DE/GLOSSARY.md
new file mode 100644
index 00000000000..26a8c07100e
--- /dev/null
+++ b/de-DE/GLOSSARY.md
@@ -0,0 +1,3 @@
+# Code-Editor
+
+Ein Code-Editor ist eine Anwendung, die es dir erlaubt, deinen Code zu speichern, um später daran weiterzuarbeiten. Du kannst in dem [Code-Editor Kapitel](./code_editor/README.md) erfahren, woher du einen bekommst.
\ No newline at end of file
diff --git a/de-DE/README.md b/de-DE/README.md
new file mode 100644
index 00000000000..517f362d1bb
--- /dev/null
+++ b/de-DE/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Dieses Werk ist unter der Creative Commons Attribution-ShareAlike 4.0 International License lizensiert. Eine Kopie dieser Lizenz finden Sie auf http://creativecommons.org/licenses/by-sa/4.0/
+
+## 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.
+
+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
+
+Hattest du auch schon einmal das Gefühl, dass Technik in der Welt immer wichtiger wird und du da nicht ganz mithalten kannst? Wolltest du schon immer einmal eine Website bauen, aber hattest dann nicht genug Motivation, damit anzufangen? Hast du dir irgendwann schon einmal gedacht, dass die Computerwelt zu kompliziert für dich ist, so dass du noch nicht einmal den Versuch unternommen hast, dort selbst etwas zu tun?
+
+Dann haben wir hier gute Neuigkeiten für dich! Programmieren ist nicht so schwer, wie du denkst, und wir zeigen dir hier, wie viel Spaß es machen kann.
+
+Dieses Tutorial wird dich nicht auf zauberhafte Weise in eine Programmiererin verwandeln. Wenn du gut darin sein willst, brauchst du Monate oder sogar Jahre des Lernens und Übens. Aber wir wollen dir zeigen, dass Programmieren oder Webseitenerstellen nicht so kompliziert ist, wie es scheint. Wir versuchen, dir auf einfache Art verschiedene, kleine Teile zu zeigen, so dass du davon nicht eingeschüchtert wirst.
+
+Wir hoffen, dass du danach diese Technik und Technologien so sehr mögen wirst wie wir!
+
+## Was lernst du in diesem Tutorial?
+
+Wenn du mit dem Tutorial fertig bist, hast du eine einfache, aber funktionierende Webanwendung: deinen eigenen Blog. Wir zeigen dir, wie man ihn online stellt, andere können dein Werk also sehen!
+
+Es wird (in etwa) so aussehen:
+
+![Abbildung 0.1](images/application.png)
+
+> Wenn du allein mit diesem Tutorial arbeitest und keinen Coach in der Nähe hast, kannst du in diesem Chat nachfragen, wenn du ein Problem hast: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Wir haben unsere Coaches und frühere Teilnehmer unserer Workshops gebeten, hin und wieder dort vorbei zu schauen und anderen mit dem Tutorial zu helfen! Hab keine Angst, dort deine Fragen zu stellen!
+
+Okay, [lass uns ganz am Anfang starten...](./how_the_internet_works/README.md)
+
+## Das Tutorial daheim durcharbeiten
+
+An einem Django-Girls-Workshop teilzunehmen ist toll, aber uns ist klar, dass das nicht immer allen möglich ist. Darum wollen wir dich ermutigen, das Tutorial auch zu Hause zu erarbeiten. Für Leser zu Hause erstellen wir gerade Video-Tutorials, die es erleichtern sollen, diesem Tutorial zu folgen. Diese Arbeit ist noch nicht abgeschlossen, aber mehr und mehr Themen werden als Video erfasst und können im [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed)-YouTube-Kanal angesehen werden.
+
+In jedem Kapitel, das bereits mit Video unterstützt wird, gibt es einen Link auf das jeweilige Video dazu.
+
+## Über uns und wie du mithelfen kannst
+
+Dieses Tutorial wird von [DjangoGirls](https://djangogirls.org/) betreut. Solltest du Fehler finden oder das Tutorial aktualisieren wollen, dann folge den [Richtlinien zum Mitarbeiten](https://github.com/DjangoGirls/tutorial/blob/master/CONTRIBUTING.md).
+
+## Möchtest du uns helfen, das Tutorial in andere Sprachen zu übersetzen?
+
+Zur Zeit haben wir die Übersetzungen auf der crowdin.com Plattform:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Sollte deine Sprache nicht aufgeführt sein, dann öffne ein neues [Issue](https://github.com/DjangoGirls/tutorial/issues/new), mit der betreffenden Sprache, dann können wir sie hinzufügen.
\ No newline at end of file
diff --git a/de-DE/SUMMARY.md b/de-DE/SUMMARY.md
new file mode 100644
index 00000000000..28b069b3a29
--- /dev/null
+++ b/de-DE/SUMMARY.md
@@ -0,0 +1,35 @@
+# Zusammenfassung
+
+* [Einleitung](README.md)
+* [Installation](installation/README.md) 
+  * [Kommandozeile](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code-Editor](installation/README.md#code-editor)
+  * [Virtuelle Umgebung](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [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)
+* [Python-Installation](python_installation/README.md)
+* [Der Code-Editor](code_editor/README.md)
+* [Einführung in Python](python_introduction/README.md)
+* [Django - Was ist das?](django/README.md)
+* [Django-Installation](django_installation/README.md)
+* [Dein erstes Django-Projekt!](django_start_project/README.md)
+* [Django-Models](django_models/README.md)
+* [Django-Administration](django_admin/README.md)
+* [Veröffentlichen!](deploy/README.md)
+* [Django-URLs](django_urls/README.md)
+* [Django-Views - leg los!](django_views/README.md)
+* [Einführung in HTML](html/README.md)
+* [Django-ORM und QuerySets](django_orm/README.md)
+* [Dynamische Daten in Templates](dynamic_data_in_templates/README.md)
+* [Django-Templates](django_templates/README.md)
+* [CSS - mach es hübsch!](css/README.md)
+* [Erweiterung der Templates](template_extending/README.md)
+* [Erweitere deine Anwendung](extend_your_application/README.md)
+* [Django-Formulare](django_forms/README.md)
+* [Wie geht es weiter?](whats_next/README.md)
\ No newline at end of file
diff --git a/de-DE/chromebook_setup/README.md b/de-DE/chromebook_setup/README.md
new file mode 100644
index 00000000000..4e1c50d4085
--- /dev/null
+++ b/de-DE/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook-Installation
+
+> **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" %}
\ No newline at end of file
diff --git a/de-DE/chromebook_setup/instructions.md b/de-DE/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..8503cc13236
--- /dev/null
+++ b/de-DE/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+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, Glitch.com)
+
+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
+
+1. Gehe zu [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Lege dir dort ein Benutzerkonto an
+3. Klicke auf *New Server* und wähle die Django-App
+4. Klicke auf die Schaltfläche "Terminal" (links im Browserfenster)
+
+Jetzt solltest du links eine Schnittstelle mit einer Seitenleiste und Schaltflächen sehen. Klicke auf den "Terminal"-Button und öffne das Terminal-Fenster mit einer Eingabeaufforderung wie folgt:
+
+{% filename %}browser{% endfilename %}
+
+    $
+    
+
+Das Terminal auf der PaizaCloud Cloud IDE steht für deine Anweisungen bereit. Du kannst die Größe des Fensters frei einstellen.
+
+#### AWS Cloud9
+
+Zur Zeit verlangt Cloud 9, dass du dich mit AWS anmeldest und Kreditkarten-Informationen angibst.
+
+1. Installiere Cloud 9 aus dem [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Gehe zu [c9.io](https://c9.io) und klicke auf *Get started with AWS Cloud9*
+3. Erstelle ein AWS-Benutzerkonto (benötigt Angabe der Kreditkarte, kann aber kostenlos verwendet werden)
+4. Gib im AWS-Dashboard *Cloud9* in die Suchzeile ein und klicke es an
+5. Klicke im Cloud-9-Dashboard *Create environment* an
+6. Gib ihm den Namen *django-girls*
+7. Wähle beim Konfigurieren der Einstellungen *Create a new instance for environment (EC2)* als "Environment Type" und den "Instance type" *t2.micro* ("Free-tier eligible." sollte angezeigt werden). Die Voreinstellung bzgl. "cost-saving" ist in Ordnung und auch die anderen Voreinstellungen kannst du belassen.
+8. Klicke auf *Next step*
+9. Klicke auf *Create environment*
+
+Jetzt solltest du eine Benutzeroberfläche mit Seitenleiste, ein grosses Fenster mit Text und am unteren Rand ein Feld sehen, das wie folgt aussieht:
+
+{% filename %}bash{% endfilename %}
+
+    deinbenutzername:~/workspace $
+    
+
+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.
+
+Führe Folgendes aus:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(Beachte, dass wir im letzten Befehl eine Tilde gefolgt von einem Gleichheitssymbol benutzen: `~=`).
+
+### GitHub
+
+Erstelle einen [GitHub](https://github.com)-Account.
+
+### PythonAnywhere
+
+Das Django Girls-Tutorial enthält ein Kapitel zum Thema Deployment. Beim Deployment nimmst du den Code, der deiner Web-Anwendung zu Grunde liegt, und packst ihn auf einen öffentlich zugänglichen Computer (Server), damit auch andere Leute deine Arbeit sehen können.
+
+Es mag seltsam scheinen, das auf einem Chromebook zu tun. Denn wir sind mit Cloud 9 ja bereits auf einem anderen Computer im Internet (anstatt z.B. auf einem lokalen Laptop). Es ist aber trotzdem sinnvoll, denn wir können uns unseren Cloud-9-Arbeitsplatz als Ort für "Dinge in Arbeit" vorstellen und PythonAnywhere als Ort, wo wir unser "fertiges" Projekt der Öffentlichkeit zeigen.
+
+Melde dich deshalb auf [www.pythonanywhere.com](https://www.pythonanywhere.com) für ein PythonAnywhere-Benutzerkonto an.
\ No newline at end of file
diff --git a/de-DE/code_editor/README.md b/de-DE/code_editor/README.md
new file mode 100644
index 00000000000..9ff0e2c9c79
--- /dev/null
+++ b/de-DE/code_editor/README.md
@@ -0,0 +1,11 @@
+# Der Code-Editor
+
+> Für die Leser zu Hause: Dieses Kapitel wird im Video [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) behandelt.
+
+Gleich geht's los! Du wirst deine erste Zeile Programmcode schreiben! Daher ist es jetzt an der Zeit, einen entsprechenden Editor herunterzuladen!
+
+> **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 im [Kapitel "Installation"](../installation/README.md) erledigt hast. In diesem Fall kannst du direkt zum nächsten Kapitel übergehen!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/de-DE/code_editor/instructions.md b/de-DE/code_editor/instructions.md
new file mode 100644
index 00000000000..4583934fabf
--- /dev/null
+++ b/de-DE/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Es gibt viele verschiedene Editoren. Welcher für dich am besten ist, ist weitestgehend Geschmackssache. Die meisten Python-Programmiererinnen verwenden komplexe, aber extrem leistungsfähige IDEs (Integrated Development Environments), z. B. PyCharm. Für Anfängerinnen sind diese jedoch weniger gut geeignet. Unsere Empfehlungen sind ebenso leistungsfähig, aber viel einfacher zu bedienen.
+
+Unsere Vorschläge siehst du unten. Aber fühl dich ganz frei, deine Trainerin zu fragen, was ihre Vorlieben sind - wenn sie sich mit dem Editor auskennt, wird es leichter sein, Hilfe zu erhalten.
+
+## Visual Studio Code
+
+Visual Studio Code ist ein von Microsoft entwickelter Quellcode-Editor für Windows, Linux und Mac. Es enthält Unterstützung für Debugging, eingebaute Git-Steuerung, Syntax-Highlighting, intelligente Code-Vervollständigung, Snippets und Code-Refactoring.
+
+[Du kannst ihn hier herunterladen](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit ist ein kostenloser Open-Source-Editor. Es gibt ihn für alle Betriebssysteme.
+
+[Du kannst ihn hier herunterladen](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+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)
+
+## Atom
+
+Atom ist ein weiterer beliebter Editor. Er ist gratis, Open-Source und für Windows, OS X und Linux verfügbar. Atom wird von [GitHub](https://github.com/) entwickelt.
+
+[Du kannst ihn hier herunterladen](https://atom.io/)
+
+## Warum installieren wir einen Code-Editor?
+
+Vielleicht wunderst du dich, warum wir so spezielle Code-Editor-Software installieren, statt einfach etwas wie Word oder Notepad zu benutzen.
+
+Erstens muss Code "plain text" (unformatierter Text) sein. Das Problem mit Programmen wie Word und Textedit ist, dass sie nicht "plain text" sondern "rich text" (mit Schriftarten und Formatierungen) produzieren und besondere Formate wie RTF (Rich Text Format) verwenden.
+
+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. :)
\ No newline at end of file
diff --git a/de-DE/css/README.md b/de-DE/css/README.md
new file mode 100644
index 00000000000..f439d56e9e9
--- /dev/null
+++ b/de-DE/css/README.md
@@ -0,0 +1,330 @@
+# CSS - mach es hübsch!
+
+Unser Blog sieht immer noch ziemlich unfertig aus, oder? Zeit, das zu ändern! Dafür nutzen wir CSS.
+
+## Was ist CSS?
+
+Cascading Style Sheets (CSS) ist eine Sprache, die das Aussehen und die Formatierung einer Website beschreibt. Es handelt sich wie bei HTML um eine Auszeichnungssprache (Markup Language). Sie ist sowas wie das "Make-up" unserer Website. ;)
+
+Aber wir wollen nicht nochmal bei Null anfangen, oder? Einmal mehr werden wir etwas verwenden, dass ProgrammiererInnen entwickelt haben und gratis im Internet zur Verfügung stellen. Wir wollen ja nicht das Rad neu erfinden.
+
+## Lass uns Bootstrap verwenden!
+
+Bootstrap ist eines der bekanntesten HTML- und CSS-Frameworks für die Entwicklung von schönen Webseiten: https://getbootstrap.com/
+
+Es wurde ursprünglich von ProgrammiererInnen bei Twitter geschrieben. Heute wird es von Freiwilligen aus der ganzen Welt weiterentwickelt!
+
+## Bootstrap installieren
+
+Öffne deine `.html`-Datei in deinem Code-Editor und füge Folgendes zum `<head>`-Abschnitt hinzu, um Bootstrap zu installieren:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Dadurch werden deinem Projekt keine Dateien hinzugefügt. Der Code verweist nur auf Dateien, die im Internet vorhanden sind. Öffne und aktualisiere also deine Webseite. Da ist sie!
+
+![Abbildung 14.1](images/bootstrap1.png)
+
+Sie sieht jetzt schon viel schöner aus!
+
+## Statische Dateien in Django
+
+Endlich werden wir einen genaueren Blick auf die Dinge werfen, die wir bisher **statische Dateien** genannt haben. Statische Dateien sind alle deine CSS- und Bilddateien. Ihr Inhalt hängt nicht vom Requestkontext ab, sondern gilt für alle Benutzer gleichermaßen.
+
+### Wohin kommen die statischen Dateien für Django
+
+Django weiss schon, wo die statischen Dateien für die integrierte "admin"-App zu finden sind. Wir müssen noch die statischen Dateien für unsere `blog`-App hinzufügen.
+
+Dies tun wir, indem wir einen Ordner namens `static` in der Blog-App erstellen:
+
+    djangogirls 
+    ├── blog 
+    │ ├── migrations 
+    │ ├── static 
+    │ └── templates 
+    └── mysite
+    
+
+Django findet automatisch alle Ordner mit dem Namen "static" in all unseren App-Ordnern. So ist es in der Lage, ihre Inhalte als statische Dateien zu nutzen.
+
+## Deine erste CSS-Datei!
+
+Erstellen wir nun eine CSS-Datei, um deiner Website deinen eigenen Stil zu verleihen. Erstelle ein neues Verzeichnis namens `css` in deinem `static`-Verzeichnis. Dann erstelle eine neue Datei namens `blog.css` in diesem `css`-Verzeichnis. Fertig?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Zeit, ein wenig CSS zu schreiben! Öffne die `blog/static/css/blog.css` Datei in Deinem Code-Editor.
+
+Wir gehen nicht zu sehr auf die Details von CSS ein. Für diejenigen, die mehr über CSS lernen möchten, haben wir am Ende des Kapitels einen Link auf eine Empfehlung für einen kostenlosen CSS-Kurs angefügt.
+
+Aber lass uns wenigstens etwas Kleines probieren. Beispielsweise könnten wir die Farbe unserer Kopfzeile ändern. Computer benutzen spezielle Codes, um Farben zu verstehen. Diese Codes starten immer mit `#`, danach folgen sechs Buchstaben (A-F) und Zahlen (0-9). Blau zum Beispiel ist `#0000FF`. Beispiele für solche Farbcodes findest du hier: http://www.colorpicker.com/. Du kannst auch [vordefinierte Farben](http://www.w3schools.com/colors/colors_names.asp) wie `red` und `green` benutzen.
+
+In deiner `blog/static/css/blog.css` Datei änderst du den folgenden Code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` ist ein CSS-Selektor. Das bedeutet, dass wir für ein `a`-Element innerhalb eines `h1`-Elements einen Style hinzufügen; der `h2 a`-Selektor macht das selbe für `h2`-Elemente. Wenn wir also etwas haben wie: `<h1><a href="">link</a></h1>` wird der `h1 a` Style angewandt. In diesem Fall sagen wir, dass die Farbe in `#C25100` geändert werden soll. Das ist ein dunkles Orange. Du kannst hier auch deine eigene Farbe verwenden, aber stelle sicher, dass sie einen guten Kontrast zum weißen Hintergrund hat!
+
+In einer CSS-Datei werden Stile für Elemente der HTML-Datei festgelegt. Ein Weg, HTML-Elemente zu identifizieren, ist der Name des Elements. Du erinnerst dich vielleicht an diese Namen, die wir als 'Tags' im HTML Kapitel bezeichnet haben. Zum Beispiel sind `a`, `h1` und `body` solche Elementnamen. Wir identifizieren Elemente auch über die Attribute `class` oder `id`. Klassen (`class`) und IDs (`id`) sind Namen, die du den Elementen selbst gibst. Klassen definieren dabei Gruppen von Elementen und IDs verweisen auf bestimmte Elemente. Du könntest zum Beispiel das folgende Element anhand des Elementnamens `a`, anhand der Klasse `external_link` oder anhand der ID `link_to_wiki_page` identifizieren:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+[Auf w3schools](http://www.w3schools.com/cssref/css_selectors.asp) erfährst du mehr über CSS-Selektoren.
+
+Wir müssen der HTML-Vorlage noch sagen, dass wir CSS eingefügt haben. Öffne die Datei `blog/templates/blog/post_list.html` im Code-Editor und füge diese Zeile ganz oben ein:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Wir laden hier die statischen Dateien. :) Füge zwischen den Tags `<head>` und `</head>`, direkt nach den Links zu den Bootstrap-Dateien, noch diese Zeile ein:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Der Browser liest die Dateien in der Reihenfolge, in der sie aufgeschrieben wurden. Darum müssen wir sicherstellen, dass die Zeile am richtigen Ort steht. Sonst könnte der Code der Bootstrap-Dateien den Code aus unserer Datei überschreiben. Wir haben also unserem Template gerade gesagt, wo sich die CSS-Datei befindet.
+
+Deine Datei sollte jetzt so aussehen:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, speichere die Datei und lade die Seite neu!
+
+![Abbildung 14.2](images/color2.png)
+
+Gut gemacht! Vielleicht wollen wir unserer Webseite etwas mehr Luft geben, indem wir den Abstand auf der linken Seite vergrößern? Probieren wir es aus!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Füge dies zu deinem CSS hinzu, speichere die Datei und schau dir an, was passiert.
+
+![Abbildung 14.3](images/margin2.png)
+
+Vielleicht können wir auch die Schrift in unserem HTML-Kopf anpassen? Füge dies zu `<head>` in `blog/templates/blog/post_list.html` hinzu:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Wie eben bereits gemacht, prüfe die Reihenfolge und platziere die Anweisung vor dem Link `blog/static/css/blog.css`. Sie importiert eine Schriftart (engl. "Font") namens *Lobster* von Google Fonts (https://www.google.com/fonts).
+
+Suche den Anweisungsblock: `h1 a` (der Code zwischen den geschweiften Klammern `{` und `}`) in der CSS Datei `blog/static/css/blog.css`. Nun füge die Zeile `font-family: 'Lobster';` zwischen den geschweiften Klammern hinzu und aktualisiere die Seite:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Abbildung 14.3](images/font.png)
+
+Super!
+
+Wie oben erwähnt, basiert CSS auf dem Konzept von Klassen. Diese erlauben dir, einen Teil des HTML-Codes mit einem Namen zu versehen und die Darstellung dieses Teils separat von anderen Teilen mit einem Stil zu steuern. Das kann sehr hilfreich sein! Eventuell hast Du zwei 'div's die etwas vollkommen Verschiedenes auszeichnen (wie einen Seitentitel oder Post Beitrag). Die Klasse hilft dir, sie unterschiedlich aussehen zu lassen.
+
+Geben wir also einigen Teilen deines HTML-Codes solche Namen. Ersetze den `header`, der deine Kopfzeile enthält, mit folgendem:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+Jetzt fügen wir dem `article` für den Blog-Inhalt (Post) noch eine Klasse `post` hinzu.
+
+{% filename %}blog/templates/blog/post_list{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Wir erweitern jetzt unser CSS mit entsprechenden Selektoren. Selektoren, die mit `.` anfangen, beziehen sich auf Klassen im HTML. Es gibt im Internet viele gute Tutorials und Informationen über CSS, die dir helfen können, den folgenden Code besser zu verstehen. Kopiere zunächst folgenden Text in deine `blog/static/css/blog.css`-Datei:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Der HTML-Code, der für die Anzeige der Blogposts verantwortlich ist, soll durch Klassen erweitert werden. Ersetze den folgenden Code:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in `blog/templates/blog/post_list.html` durch diesen:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Speichere die geänderten Dateien und aktualisiere die Webseite.
+
+![Abbildung 14.4](images/final.png)
+
+Juhuu! Sieht super aus, oder? Schau dir den Code an, den wir gerade eingefügt haben. Da siehst du, wo wir überall Klassen zu den HTML-Objekten hinzugefügt haben, um sie in CSS zu referenzieren. Wo würdest du eine Änderung machen, um das Datum in Türkis anzuzeigen?
+
+Hab keine Angst, etwas mit dieser CSS-Datei herumzuspielen, und versuche, ein paar Dinge zu ändern. Mit CSS herumzuspielen, kann dir helfen zu verstehen, was die verschiedenen Dinge genau machen. Mach dir keine Sorgen, wenn etwas kaputt geht, du kannst deine Änderungen immer rückgängig machen!
+
+Wir empfehlen die kostenlosen online-Kurse "Basic HTML & HTML5" und "Basic CSS" auf [freeCodeCamp](https://learn.freecodecamp.org/). Sie werden dir helfen, deine Webseiten mit HTML und CSS schöner zu gestalten.
+
+Bereit für das nächste Kapitel? :)
\ No newline at end of file
diff --git a/de-DE/deploy/README.md b/de-DE/deploy/README.md
new file mode 100644
index 00000000000..f1478c9bd20
--- /dev/null
+++ b/de-DE/deploy/README.md
@@ -0,0 +1,246 @@
+# Veröffentlichen!
+
+> **Hinweis:** Durch das folgende Kapitel muss man sich manchmal durchbeißen. Bleib dran und gib nicht auf; die Website zu veröffentlichen, ist ein sehr wichtiger Schritt. Dieses Kapitel ist in der Mitte des Tutorials platziert, damit dir dein Mentor mit dem etwas anspruchsvolleren Vorgang der Veröffentlichung deiner Website helfen kann. Den Rest des Tutorials kannst du dann auch alleine beenden, sollte die Zeit nicht ausreichen.
+
+Bis jetzt war deine Webseite nur auf deinem Computer verfügbar. Jetzt wirst du lernen wie du sie 'deployst'! Deployen bedeutet, dass du deine Anwendung im Internet veröffentlichst, so dass endlich jeder darauf zugreifen kann. :)
+
+Wie du schon gelernt hast, muss eine Webseite auf einem Server liegen. Es gibt eine Vielzahl von Hosting (Server)-Anbietern im Internet, wir werden [PythonAnywhere](https://www.pythonanywhere.com/) verwenden. PythonAnywhere ist kostenlos für kleine Anwendungen, die nicht von vielen Besuchern aufgerufen werden. Also erstmal genau das Richtige für dich.
+
+Als weiteren externen Dienst werden wir [GitHub](https://www.github.com) nutzen, einen "Code Hosting"-Dienst. Es gibt noch andere solcher Dienste, aber die meisten Programmierer haben heute ein Konto bei GitHub, und du auch gleich!
+
+Diese drei Orte werden für dich wichtig sein. Die Entwicklung und das Testen wirst du auf deinem lokalen Rechner durchführen. Wenn du mit deinen Änderungen zufrieden bist, wirst du eine Kopie deines Programms auf GitHub veröffentlichen. Deine Website wird auf PythonAnywhere gehostet werden. Ändern kannst du sie, indem du eine neue Version deines Codes von GitHub herunter lädst.
+
+# Git
+
+> **Hinweis:** Falls du die [Installationsschritte](../installation/README.md) bereits durchgeführt hast, kannst du mit dem nächsten Abschnitt fortfahren und anfangen, dein Git-Repository zu erstellen.
+
+{% include "/deploy/install_git.md" %}
+
+## Unser Git-Repository
+
+Git verwaltet die Veränderungen an einer Sammlung von Dateien in einem sogenannten Repository (oder kurz "Repo"). Legen wir eines für unser Projekt an. Öffne deine Konsole und gibt folgende Kommandos im `djangogirls`-Verzeichnis ein:
+
+> **Hinweis:** Überprüfe dein aktuelles Arbeitsverzeichnis mit dem Befehl `pwd` (OSX/Linux) oder `cd` (Windows) bevor du das Repository initialisierst. Du musst dich im `djangogirls`-Verzeichnis befinden, bevor du fortfährst.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Dein Name"
+    $ git config --global user.email du@example.com
+    
+
+Die Initialisierung des Git-Repositorys müssen wir für jedes Projekt nur einmal machen (danach musst Du Benutzernamen und Mail-Adresse nie wieder eingeben).
+
+Git wird die Änderungen an all den Dateien und Ordnern in diesem Verzeichnis aufzeichnen. Wir wollen aber, dass einige Dateien ignoriert werden. Dazu legen wir eine Datei `.gitignore` im Hauptordner (`djangogirls`) des Repos an. Öffne deinen Editor und erstelle eine neue Datei mit dem folgenden Inhalt:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Datenbank
+    db.sqlite3
+    
+    # Static Ordner im Projektverzeichnis
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+Speichere die Datei mit dem Namen `.gitignore` im "djangogirls"-Root-Verzeichnis.
+
+> **Hinweis:** Der Punkt vor dem Dateinamen ist wichtig! Wenn du Schwierigkeiten beim Erstellen hast (z.B. lassen Macs im Finder keine Dateien mit Punkt am Anfang erzeugen, Punkt-Dateien sind auf Linux und OS X "versteckte Dateien"), dann verwende die "Speichern unter"-Funktion im Editor, das sollte immer funktionieren. Wichtig ist, dass du den Dateinamen nicht mit `.txt`, `.py` oder einer anderen Dateinamen-Erweiterung ergänzt -- die Datei wird von Git nur erkannt, wenn ihr Name exakt nur `.gitignore` ist. Linux und MacOS behandeln Dateien mit Namen, die mit `.` beginnen (wie `.gitignore`), als versteckt und der normale `ls`-Befehl zeigt diese Dateien nicht an. Verwende stattdessen `ls -a` um die Datei `.gitignore` anzuzeigen.
+> 
+> **Hinweis:** Eine der Dateien, die du in deiner `.gitignore`-Datei defniniert hast, ist `db.sqlite3`. Diese Datei ist deine lokale Datenbank, in welcher alle deine Benutzer und Posts gespeichert werden. Wir werden die gängige Web-Entwicklungs-Praxis befolgen, was heißt, dass wir separate Datenbanken für unsere lokale Test-Website und unsere öffentliche Website auf PythonAnywhere verwenden werden. Die Datenbank für letztere könnte SQLite sein, wie auf deiner Entwicklungsmaschine, aber normalerweise wirst du eine sogenannte MySQL-Datenbank nutzen, welche mit viel mehr Besuchern umgehen kann als SQLite. So oder so, dadurch, dass du deine SQLite-Datenbank für die GitHub-Kopie nicht verwendest, werden alle deine bisherigen Posts der Superuser nur lokal zur Verfügung stehen und du musst in der produktiven Umgebung neue hinzufügen. Betrachte deine lokale Datenbank als tollen Spielplatz, auf welchem du verschiedene Dinge ausprobieren kannst, ohne Angst zu haben, dass du deine wirklichen Post auf deinem Blog löschst.
+
+Es ist hilfreich den Befehl `git status` vor `git add` auszuführen oder immer dann, wenn du dir unsicher bist, was geändert wurde. Das schützt vor manchen Überraschungen, wie z. B. das falsche Hinzufügen oder Übertragen von Dateien. Das `git status`-Kommando gibt Informationen über unbeobachtete/veränderte/hinzugefügte Dateien, den Status der Verzweigung und einiges mehr wieder. Deine Ausgabe sollte dem hier ähneln:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Nun speichern wir unsere Änderungen durch folgende Eingabe in der Konsole:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "Meine Django-Girls-App, erster Commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Den Code auf GitHub veröffentlichen
+
+Gehe auf [GitHub.com](https://www.github.com) eröffne ein neues, kostenloses Nutzerkonto. (Falls Du es bereits während der Workshop-Vorbereitung eingerichtet hast, ist das großartig!) Stelle sicher, dass Du Dein Passwort nicht vergisst (füge es zu zu Deinem Passwort-Manager hinzu, falls Du einen solchen verwendest).
+
+Erstelle dann ein neues Repository und gib ihm den Namen "my-first-blog". Lass das Kontrollkästchen "initialise with a README" deaktiviert und die Einstellung der Option .gitignore leer (das haben wir schon von Hand gemacht) und lass die Lizenz auf "None".
+
+![](images/new_github_repo.png)
+
+> **Achtung:** Der Name `my-first-blog` ist wichtig -- du kannst auch einen anderen wählen, aber er wird im Folgenden noch sehr oft vorkommen und du wirst immer daran denken müssen, ihn in den Anweisungen entsprechend anzupassen. Es ist wahrscheinlich einfacher, bei `my-first-blog` zu bleiben.
+
+In der nächsten Ansicht wirst du die clone-URL deines Repositorys sehen, die du in manchen der folgenden Kommandozeilenbefehlen verwenden wirst:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Nun müssen wir das Git-Repository auf deinem Computer mit dem auf GitHub verbinden.
+
+Gib das Folgende auf der Kommandozeile ein (ersetzte `<your-github-username>` mit dem Benutzernamen, den du beim Erstellen deines GitHub-Accounts gewählt hast, aber ohne die spitzen Klammern -- die URL sollte der clone-URL entsprechen, die du vorhin gerade gesehen hast):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Wenn du zu GitHub pushst, wirst du nach deinem Benutzernamen und Passwort gefragt (entweder direkt im Kommandozeilen-Fenster oder in einem Pop-Up-Fenster), und nach der Eingabe deiner Zugangsdaten solltest du etwas Ähnliches wie das hier sehen:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Dein Code ist jetzt auf GitHub. Schau gleich mal nach! Dort ist dein Code in guter Gesellschaft - [Django](https://github.com/django/django), das [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial) und viele andere großartige Open Source Software-Projekte haben ihren Code auf GitHub. :)
+
+# Deinen Blog auf PythonAnywhere einrichten
+
+## Registriere dich für ein PythonAnywhere Konto
+
+> **Hinweis:** Es ist möglich, dass du bereits ein PythonAnywhere Konto angelegt hast. Wenn ja, dann brauchst du das nicht noch einmal zu tun.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Unsere Site auf PythonAnywhere konfigurieren
+
+Gehe zurück zum [Haupt-Dashboard PythonAnywhere](https://www.pythonanywhere.com/), indem du auf das Logo klickst. Dann wähle die Option zum Start einer "Bash"-Konsole – die PythonAnywhere Version einer Kommandozeile wie du sie auf deinen Computer hast.
+
+![Der 'New Console"-Abschnitt auf der PythonAnywhere-Weboberfläche, mit einem Knopf für 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Hinweis:** PythonAnywhere basiert auf Linux. Wenn du Windows benutzt, dann sieht die Konsole etwas anders aus als die Konsole auf deinem Computer.
+
+Um eine Web App auf PythonAnywhere publizieren zu können, muss dein Code von GitHub heruntergeladen und PythonAnyhwere dazu gebracht werden, diesen zu erkennen und als Web Applikation anzubieten. Du kannst das auch manuell machen. Aber PythonAnywhere stellt ein Hilfstool zur Verfügung, das das alles für dich erledigt. Lass es uns installieren:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+Nach diesem Befehl solltest du in etwa Folgendes sehen: `Collecting pythonanywhere`, und irgendwann den Schluss `Successfully installed (...) pythonanywhere- (...)`.
+
+Nun können wir mit dem Hilfstool unsere App von GitHub automatisch konfigurieren. Gib das Folgende in der Konsole auf PythonAnywhere ein (vergiss nicht, deinen GitHub-Benutzernamen an Stelle von `<your-github-username>` zu benutzen, so dass die URL der clone-URL von GitHub entspricht):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+Während du die Ausführung verfolgst, wirst du sehen, was passiert:
+
+- Den Code von GitHub herunterladen
+- Eine virtuelle Umgebung auf PythonAnywhere einrichten, genau wie die auf deinem eigenen Computer
+- Deine Einstellungen mit ein paar Veröffentlichungseinstellungen aktualisieren
+- Eine Datenbank auf PythonAnywhere einrichten mit dem Befehl `manage.py migrate`
+- Deine statischen Dateien einrichten (darüber lernen wir später etwas)
+- PythonAnywhere so einrichten, dass es deine Web-App über seine Schnittstelle (API) präsentieren kann
+
+Diese Schritte wurden auf PythonAnywhere automatisiert, aber es sind die selben Schritte, die du bei jedem anderen Server-Provider machen müsstest.
+
+Das Wichtigste im Moment ist, dass du weißt, dass Deine Datenbank auf PythonAnywhere vollständig unabhängig von deiner Datenbank auf deinem eigenen PC ist, so dass sie unterschiedliche Posts und Administratorenkonten haben kann. Aus diesem Grund müssen wir das Administratorenkonto mittels `createsuperuser` initialisieren - wie wir das auf deinem eigenen Computer getan haben. PythonAnywhere hat deine virtualenv automatisch für dich aktiviert. Du musst nur noch Folgendes ausführen:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Trage die Informationen für deinen Administrator ein. Am Besten verwendest du die selben Daten wie auf deinem eigenen Computer, um Verwechslungen zu vermeiden - es sei denn, du willst das Passwort auf PythonAnywhere sicherer machen.
+
+Nun kannst auch einen Blick auf deinen Code auf PythonAnywhere werfen mittels `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+Du kannst auch auf die "Files"-Seite gehen und mit PythonAnywheres eingebautem Datei-Manager navigieren. (Von der "Console"-Seite gelangst du über das Menü in der rechten oberen Ecke zu anderen PythonAnywhere-Seiten. Sobald du auf einer dieser Seiten bist, findest du die Links zu den anderen Seiten oben über dem Seiteninhalt.)
+
+## Du bist jetzt live!
+
+Nun ist deine Site also live im öffentlichen Internet! Klick dich zur PythonAnywhere "Web"-Seite durch und hole dir den Link. Teile ihn, mit wem du willst. :)
+
+> **Hinweis:** Da es sich hier um ein Anfänger-Tutorial handelt, haben wir ein paar Abkürzungen genommen, um die Site zu veröffentlichen, welche sicherheitstechnisch nicht ideal sind. Falls du dich entscheidest, dieses Projekt weiterzubauen oder ein neues Projekt anzufangen, dann solltest du die [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) durchgehen, um einige Tipps zur Absicherung deiner Seite zu erhalten.
+
+## Debugging Tipps
+
+Solltest du beim Ausführen des `pa_autoconfigure_django.py` Skripts eine Fehlermeldung erhalten, findest du folgend ein paar bekannte Gründe hierfür:
+
+- Du hast vergessen deinen PythonAnywhere API-Token zu erstellen.
+- Du hast in deiner GitHub-URL einen Fehler gemacht.
+- Falls du die Fehlermeldung *"Could not find your settings.py"* erhältst, liegt das wahrscheinlich daran, dass du nicht alle Files zum Git hinzugefügt und/oder diese nicht erfolgreich auf GitHub veröffentlicht hast. Schau dir nochmals den Git-Abschnitt weiter oben an.
+- Falls du ein bestehendes PythonAnywhere-Benutzerkonto verwendest und eine Fehlermeldung bzgl. collectstatic erhalten hast, hast du dort vermutlich eine alte SQLite-Version (z.B. 3.8.2). Wenn das der Fall ist, erstelle ein neues Benutzerkonto und versuche dort, die Kommandos aus dem obenstehenden PythonAnywhere-Abschnitt erneut auszuführen.
+
+Falls du eine Fehlermeldung erhältst, wenn du versuchst, deine Site aufzurufen, solltest du als Erstes die Debugging-Informationen im **error log** anschauen. Den Link dazu findest du über [die PythonAnywhere-Seite "Web"](https://www.pythonanywhere.com/web_app_setup/). Schau nach, ob darin Fehlermeldungen enthalten sind; die neuesten findest du ganz unten.
+
+Du findest einige [Allgemeine Debugging Tipps im PythonAnywhere Wiki](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+Und denke daran, dein Coach ist da, um zu helfen!
+
+# Schau dir deine Website an!
+
+Auf der Defaultseite deiner Site sollte "It worked!" stehen - genau so wie auf deinem lokalen Computer. Füge nun `/admin/` ans Ende deiner URL an und du kommst auf die Admin-Site. Logge dich mit Benutzername und Passwort ein, und du wirst sehen, dass du auf dem Server neue Posts hinzufügen kannst -- die Posts aus deiner lokalen Test-Datenbank wurden ja nicht auf deinen öffentlichen Blog geschickt.
+
+Wenn du ein paar Posts erstellt hast, kannst du zurück auf dein lokales Setup (nicht PythonAnywhere) wechseln. Ab jetzt solltest du für Änderungen auf deinem lokalen Setup arbeiten. So wird in der Web-Entwicklung gearbeitet - Änderungen lokal machen und diese dann auf GitHub veröffentlichen und dann deine Änderungen auf den produktiven Webserver ziehen. So kannst du Sachen ausprobieren, ohne deine produktive Website kaputt zu machen. Ziemlich cool, oder?
+
+Klopf dir *kräftig* auf die Schulter! Server-Deployment ist eines der kompliziertesten Dinge der Web-Entwicklung und es dauert oftmals mehrere Tage, bis alles läuft. Aber du hast deine Site jetzt live, im echten Internet!
\ No newline at end of file
diff --git a/de-DE/deploy/install_git.md b/de-DE/deploy/install_git.md
new file mode 100644
index 00000000000..f6e5cae703d
--- /dev/null
+++ b/de-DE/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git ist ein "Versionsverwaltungssystem" für Dateien und Code, das von vielen Programmierern benutzt wird. Diese Software kann Änderungen an Dateien über die Zeit verfolgen, so dass du bestimmte Versionen im Nachhinein wieder aufrufen kannst. Sie hat Ähnlichkeit mit der Funktion "Änderungen nachverfolgen" in Textverarbeitungsprogrammen (z. B. Microsoft Word oder LibreOffice Writer), ist jedoch weitaus leistungsfähiger.
+
+## Git installieren
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Du kannst Git von [git-scm.com](https://git-scm.com/) herunterladen. Du kannst bei allen Schritten außer zweien "next" klicken: Wähle im Schritt, in dem du einen Editor aussuchen sollst, "Nano"; und bei der Anweisung "Adjusting your PATH environment", wähle die Einstellung "Run Git and associated Unix tools from the Windows command-line" (die letzte Option). Die anderen Voreinstellungen sind ok. "Checkout"-Stil "Windows" und "Commit" mit "Unix line endings" (Zeilenende im Unix-Format) sind die richtigen Einstellungen.
+
+Vergiss nicht, die Eingabeaufforderung oder PowerShell nach erfolgreicher Installation neu zu starten.<!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Lade Git von [git-scm.com](https://git-scm.com/) herunter und folge dann den Anweisungen.
+
+> **Hinweis:** Falls du OS X 10.6, 10.7, oder 10.8 verwendest, muss du die Git-Version unter folgendem Link installieren: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/de-DE/deploy/signup_pythonanywhere.md b/de-DE/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..b94d9d975a9
--- /dev/null
+++ b/de-DE/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere ist ein Dienst, mittels dem Python auf Servern "in der Cloud" ausgeführt werden kann. Wir werden ihn verwenden, um unsere Seite zu hosten, live und im Internet.
+
+Wir werden den Blog, den wir bauen, auf PythonAnywhere hosten. Registriere dich auf PythonAnywhere für ein "Beginner"-Konto (die kostenfreie Stufe ist ausreichend, du brauchst keine Kreditkarte).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![Die PythonAnywhere-Anmelde-Seite mit einem Knopf, um ein kostenloses 'Beginner'-Benutzerkonto anzulegen](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Hinweis** Beachte bei der Wahl deines PythonAnywhere-Benutzernamens, dass die URL deines Blogs die Form `deinbenutzername.pythonanywhere.com` haben wird. Wähle also einen Namen, unter dem du veröffentlichen willst, oder einen Namen, der den Inhalt deines Blogs beschreibt. Und vergiss dein Passwort nicht (füge es deinem Passwortmanager hinzu, wenn du einen benutzt).
+
+## Erstellen eines PythonAnywhere API-Tokens
+
+Das Folgende musst du nur einmal machen. Wenn du dich auf PythonAnywhere angemeldet hast, kommst du aufs "Dashboard". Oben rechts findest du den Link zu deiner "Account"-Seite:
+
+!["Account"-Link oben rechts auf der Seite](../deploy/images/pythonanywhere_account.png)
+
+Klicke dort auf den Reiter namens "API token" und dann auf den Knopf, der mit "Create new API token" beschriftet ist.
+
+![Der API-Token-Reiter auf der "Account"-Seite](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/de-DE/django/README.md b/de-DE/django/README.md
new file mode 100644
index 00000000000..5238cee1750
--- /dev/null
+++ b/de-DE/django/README.md
@@ -0,0 +1,27 @@
+# Django - Was ist das?
+
+Django (*/ˈdʒæŋɡoʊ/*) ist ein freies, quelloffenes Web-Anwendungs-Framework, geschrieben in Python. Ein Web-(Anwendungs-)Framework ist eine Art Baukastensystem, das dir mit vielen vorgefertigten Teilen die Entwicklung von Web-Anwendungen stark erleichtert.
+
+Wenn du eine Website entwickelst, brauchst du immer wieder sehr ähnliche Elemente: Einen Weg, Benutzer zu verwalten (Registrierung, Anmeldung, Abmeldung etc.), einen Administrationsbereich, Formulare, Upload von Dateien usw.
+
+Glücklicherweise wurde schon vor einiger Zeit erkannt, dass Web-Entwickler immer wieder die gleichen Probleme zu lösen haben. Gemeinsam entstanden so verschiedene Frameworks (Django ist so eines), welche die Web-Entwicklung durch vorgefertigte Elemente erleichtern.
+
+Frameworks sind dazu da, damit du das Rad nicht neu erfinden musst. Du kannst dich auf die konkret zu erfüllenden Anforderungen der Webseite kümmern. Die grundlegende Basis der Webseite stellt dir das Framework zur Verfügung.
+
+## Warum brauchst du ein Framework?
+
+Um besser zu verstehen, welche Vorteile dir Django bietet, werfen wir einen Blick auf Server im Allgemeinen. Als Erstes muss der Server wissen, dass er eine Webseite ausliefern soll.
+
+Der Server hat mehrere "Ports". Ein Port ist vergleichbar mit einem Briefkasten, der auf eingehende Briefe ("Anfragen", "requests") überwacht wird. Das macht der Webserver. Der Webserver liest die eingeworfenen Briefe (requests) und beantwortet sie mit der Webseite (response). Um etwas ausliefern zu können, brauchen wir Inhalte. Und Django hilft dir dabei, diese Inhalte zu erstellen.
+
+## Was passiert, wenn jemand eine Webseite beim Server anfordert?
+
+Wenn die Anfrage beim Web-Server ankommt, reicht er diese an Django weiter. Und Django versucht herauszufinden, welche Seite genau angefordert wurde. Django wertet zuerst die Adresse der Webseite aus und versucht herauszufinden, was getan werden soll. Dafür ist der **urlresolver** von Django verantwortlich (Hinweis: URL - Uniform Resource Locator ist ein anderer Name für die Web-Adresse, daher der Name *urlresolver*). Sehr schlau ist er aber nicht. Er hat eine Musterliste und vergleicht diese mit der URL. Der Vergleich der Muster erfolgt von oben nach unten. Wenn ein Muster auf die URL zutrifft, wird der damit verknüpften Funktion (der sogenannten *view*) der Request/die Anfrage übergeben.
+
+Stell dir eine Postbotin mit einem Brief vor. Sie geht die Straße entlang und prüft jede Hausnummer mit der Adresse auf dem Brief. Wenn beide passen, dann steckt sie den Brief in den Briefkasten. So funktioniert der urlresolver!
+
+In der *view* Funktion passieren all die interessanten Dinge: wir können in eine Datenbank gucken und dort nach Informationen suchen. Vielleicht wollte die Benutzerin irgendetwas in den Daten ändern? So, als ob der Brief sagen würde: "Bitte ändere meine Stellenbeschreibung!" Die Funktion *view* kann nun prüfen, ob du dazu berechtigt bist, im positiven Fall die Änderungen durchführen und im Anschluss eine Bestätigungs-Nachricht zurücksenden. Die *view* generiert dann eine Antwort und Django kann diese an den Webbrowser der Benutzerin senden.
+
+Die Beschreibung oben ist ein wenig vereinfacht, aber du musst noch nicht all die technischen Details wissen. Eine generelle Vorstellung zu haben, reicht erstmal.
+
+Anstatt zu sehr ins Detail zu gehen, fangen wir lieber an, mit Django etwas zu erschaffen, und du wirst dabei alles Wichtige lernen!
\ No newline at end of file
diff --git a/de-DE/django_admin/README.md b/de-DE/django_admin/README.md
new file mode 100644
index 00000000000..476448ead45
--- /dev/null
+++ b/de-DE/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django-Administration
+
+Wir benutzen den Django-Admin, um die soeben modellierten Posts hinzuzufügen, zu ändern oder zu löschen.
+
+Öffne die Datei `blog/admin.py` im Code-Editor und ersetze den Inhalt wie folgt:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Wie du siehst, importieren wir hier das Model "Post", das wir im vorherigen Kapitel erstellt haben. Damit unser Model auf der Admin-Seite sichtbar wird, müssen wir es mit `admin.site.register(Post)` registrieren.
+
+Okay, wir sehen uns nun unser Post-Model an. Denk daran, `python manage.py runserver` in die Konsole einzugeben, um den Webserver zu starten. Öffne deinen Browser und gib die Adresse http://127.0.0.1:8000/admin/ ein. Du siehst eine Anmeldeseite:
+
+![Login Seite](images/login_page2.png)
+
+Um dich einloggen zu können, musst du zunächst einen *superuser* erstellen - einen User, der alles auf der Website steuern darf. Geh zurück zur Kommandozeile, tippe `python manage.py createsuperuser` und drücke Enter.
+
+> Denke daran, damit du neue Kommandos eingeben kannst während der Webserver läuft, musst du ein neues Terminal öffnen und deine virtualenv aktivieren. Wie man neue Kommandos eingeben kann, haben wir im Kapitel **Dein erstes Django-Projekt!** unter **Den Webserver starten** behandelt.
+
+{% filename %}Mac OS X oder Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Wenn du dazu aufgefordert wirst, gib einen Benutzernamen (Kleinbuchstaben, keine Leerzeichen), eine Mailadresse und ein Passwort ein. **Mach dir keine Gedanken, wenn du das Passwort bei der Eingabe nicht sehen kannst - so soll es sein.** Tippe weiter und drücke `Enter`, um weiterzumachen. Du solltest nun Folgendes sehen (wobei Benutzername und Email deine eigenen sein sollten):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Geh nochmal in deinen Browser und log dich mit den Daten des Superusers ein, den du gerade erstellt hast. Du solltest nun das Django-Admin-Dashboard sehen.
+
+!["Django Admin"-Weboberfläche](images/django_admin3.png)
+
+Gehe auf Posts und experimentiere ein bisschen damit. Füge fünf oder sechs Blogeinträge hinzu. Mach dir keine Sorgen wegen des Inhalts -- der ist nur auf deinem lokalen Computer sichtbar. Um Zeit zu sparen kannst du etwas Text aus diesem Tutorial kopieren und einfügen. :-)
+
+Achte darauf, dass bei wenigstens zwei oder drei Posts (aber nicht bei allen) das Veröffentlichungsdatum (publish date) eingetragen ist. Das werden wir später noch brauchen.
+
+!["Django Admin"-Weboberfläche](images/edit_post3.png)
+
+Mehr zum Django-Admin-Dashboard kannst du in der Django-Dokumentation erfahren: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Jetzt ist wahrscheinlich ein guter Moment, um dir einen Kaffee (oder Tee) zu gönnen und neue Kraft zu tanken. Du hast dein erstes Django-Model erstellt - du hast dir eine kleine Pause verdient!
\ No newline at end of file
diff --git a/de-DE/django_forms/README.md b/de-DE/django_forms/README.md
new file mode 100644
index 00000000000..9968e6ea163
--- /dev/null
+++ b/de-DE/django_forms/README.md
@@ -0,0 +1,478 @@
+# Django-Formulare
+
+Als Letztes möchten wir auf unserer Website noch die Möglichkeit haben, Blogposts hinzuzufügen und zu editieren. Die Django `admin`-Oberfläche ist cool, aber eher schwierig anzupassen und hübsch zu machen. Mit Formularen, `forms`, haben wir die absolute Kontrolle über unser Interface - wir können fast alles machen, was man sich vorstellen kann!
+
+Das Gute an Django-Forms ist, dass man sie entweder vollständig selbst definieren oder eine `ModelForm` erstellen kann, welche den Inhalt des Formulars in das Model speichert.
+
+Genau das wollen wir jetzt machen: Wir erstellen ein Formular für unser `Post`-Model.
+
+So wie die anderen wichtigen Django-Komponenten haben auch die Forms ihre eigene Datei: `forms.py`.
+
+Wir erstellen nun eine Datei mit diesem Namen im `blog`-Verzeichnis.
+
+    blog
+       └── forms.py
+    
+
+So, jetzt lass uns diese im Code-Editor öffnen und folgenden Code hinzufügen:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+         model = Post
+         fields = ('title', 'text',)
+```
+
+Zuerst müssen wir die Django-Forms importieren (`from django import forms`) und auch unser `Post`-Model (`from .models import Post`).
+
+Wie du wahrscheinlich schon vermutet hast, `PostForm` ist der Name unseres Formulars. Wir müssen Django mitteilen, dass unser Formular ein `ModelForm` ist (so kann Django ein bisschen für uns zaubern) - `forms.ModelForm` ist dafür verantwortlich.
+
+Als Nächstes sehen wir uns `class Meta` an, damit sagen wir Django, welches Model benutzt werden soll, um das Formular zu erstellen (`model = Post`).
+
+Nun können wir bestimmen, welche(s) Feld(er) unser Formular besitzen soll. Wir wollen hier nur den `title` und `text` sichtbar machen - der `author` sollte die Person sein, die gerade eingeloggt ist (Du!) und `created_date` sollte automatisch generiert werden, wenn der Post erstellt wird (also im Code). Stimmt's?
+
+Und das war's schon! Jetzt müssen wir das Formular nur noch in einem *view* benutzen und im Template darstellen.
+
+Also erstellen wir hier auch wieder einen Link auf die Seite, eine URL, eine View und ein Template.
+
+## Link auf eine Seite mit dem Formular
+
+Bevor wir den Link hinzufügen, benötigen wir einige Icons als Buttons für den Link. Lade für dieses Tutorial [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) herunter und speicher es im Ordner `blog/templates/blog/blog/icons/`
+
+> Hinweis: Um das SVG-Bild herunterzuladen, öffne das Kontextmenü auf dem Link (normalerweise durch einen Rechtsklick darauf) und wähle "Link speichern unter". Im Dialog, in dem du gefragt wirst, wo du die Datei speichern willst, navigiere zum `djangogirls`-Verzeichnis deines Django-Projekts und innerhalb davon in das Unterverzeichnis `blog/templates/blog/icons/` und speicher die Datei dort.
+
+Es ist an der Zeit, `blog/templates/blog/base.html` im Code-Editor zu öffnen. Jetzt können wir diese Icon-Datei im Basis-Template wie folgt verwenden. Im `div`-Element innerhalb des `header`-Abschnitts werden wir einen Link vor dem `h1`-Element hinzufügen:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Beachte, dass wir unsere neue View `post_new` nennen wollen. Das [SVG-Icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) wird von [Bootstrap Icons](https://icons.getbootstrap.com/) zur Verfügung gestellt und zeigt ein Seitensymbol mit Pluszeichen an. Wir verwenden eine Django-Template-Direktive namens `include`. Dadurch wird der Inhalt der Datei in das Django-Template eingefügt. Der Web-Browser weiß, wie man diese Art von Inhalt ohne weitere Verarbeitung handhabt.
+
+> Alle Bootstrap-Icons kannst du [hier herunterladen](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Entpacke die Datei und kopiere alle SVG-Bilddateien in einen neuen Ordner namens `icons` innerhalb von `blog/templates/blog/`. So kannst du auf ein Symbol wie `pencil-fill.svg` mit dem Dateipfad `blog/templates/blog/icons/pencil-fill.svg` zugreifen
+
+Nach dem Bearbeiten der Zeile sieht deine HTML-Datei so aus:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Nach dem Speichern und Neuladen von http://127.0.0.1:8000 solltest du den bereits bekannten `NoReverseMatch`-Fehler sehen. Ist dem so? Gut!
+
+## URL
+
+Wir öffnen `blog/urls.py` im Code-Editor und fügen eine Zeile hinzu:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+Der finale Code sieht dann so aus:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views 
+urlpatterns = [     
+    path('', views.post_list, name='post_list'),     
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),     
+    path('post/new/', views.post_new, name='post_new'), 
+]
+```
+
+Nach dem Neuladen der Site sehen wir einen `AttributeError`, weil wir noch keine `post_new`-View eingefügt haben. Fügen wir sie gleich hinzu!
+
+## Die post_new-View
+
+Jetzt wird es Zeit, die Datei `blog/views.py` im Code-Editor zu öffnen und die folgenden Zeilen zu den anderen `from` Zeilen hinzuzufügen:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+Und dann unsere *View*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Um ein neues `PostForm` zu erstellen, rufen wir `PostForm()` auf und übergeben es an das Template. Wir kommen gleich nochmal zu dem *View* zurück, aber jetzt erstellen wir schnell ein Template für das Form.
+
+## Template
+
+Wir müssen eine Datei `post_edit.html` im Verzeichnis `blog/templates/blog` erstellen und im Code-Editor öffnen. Damit ein Formular funktioniert, benötigen wir einige Dinge:
+
+* Wir müssen das Formular anzeigen. Wir können das zum Beispiel mit einem einfachen `{{ form.as_p }}` tun.
+* Die Zeile oben muss von einem HTML-Formular-Element eingeschlossen werden `<form method="POST">...</form>`.
+* Wir benötigen einen `Save`-Button. Wir erstellen diesen mit einem HTML-Button: `<button type="submit">Save</button>`.
+* Und schließlich fügen wir nach dem öffnenden `<form ...>` Tag `{% raw %}{% csrf_token %}{% endraw %}` hinzu. Das ist sehr wichtig, da es deine Formulare sicher macht! Wenn du diesen Teil vergisst, wird sich Django beim Speichern des Formulars beschweren.
+
+![CSFR Forbidden page](images/csrf2.png)
+
+Ok, also schauen wir mal, wie der HTML-Code in `post_edit.html` aussehen sollte:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+So, jetzt aktualisieren wir die Seite! Yay! Das Formular wird angezeigt!
+
+![Neues Formular](images/new_form2.png)
+
+Aber Moment! Wenn du in das `title`- oder `text`-Feld etwas eintippst und versuchst es zu speichern - was wird wohl passieren?
+
+Nichts! Wir landen wieder auf der selben Seite und unser Text ist verschwunden... und kein neuer Post wurde hinzugefügt. Was lief denn hier schief?
+
+Die Antwort ist: nichts. Wir müssen einfach noch etwas mehr Arbeit in unsere *View* stecken.
+
+## Speichern des Formulars
+
+Öffne `blog/views.py` erneut im Code-Editor. Derzeit ist alles, was wir in der View `post_new` haben, das hier:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Wenn wir das Formular übermitteln, werden wir zur selben Ansicht weitergeleitet, aber dieses Mal haben wir mehr Daten in `request`, genauer in `request.POST` (der Name hat nichts zu tun mit einem "Blogpost", sondern damit, dass wir Daten "posten"). Erinnerst du dich daran, dass in der HTML-Datei unsere `<form>` Definition die Variable `method="POST"` hatte? Alle Felder aus dem Formular sind jetzt in `request.POST`. Du solltest `POST` nicht umbenennen (der einzige andere gültige Wert für `method` ist `GET`, wir wollen hier jetzt aber nicht auf den Unterschied eingehen).
+
+Somit müssen wir uns in unserer *View* mit zwei verschiedenen Situationen befassen: erstens, wenn wir das erste Mal auf die Seite zugreifen und ein leeres Formular wollen und zweitens, wenn wir zur *View* mit allen soeben ausgefüllten Formular-Daten zurück wollen. Wir müssen also eine Bedingung hinzufügen (dafür verwenden wir `if`):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+Es wird Zeit, die Lücken zu füllen `[...]`. Falls die `Methode` `POST` ist, wollen wir das `PostForm` mit Daten vom Formular erstellen. Oder? Das machen wir folgendermaßen:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+Als Nächstes müssen wir testen, ob das Formular korrekt ist (alle benötigten Felder sind ausgefüllt und keine ungültigen Werte werden gespeichert). Wir tun das mit `form.is_valid()`.
+
+Wir überprüfen also, ob das Formular gültig ist und wenn ja, können wir es speichern!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Im Grunde passieren hier zwei Dinge: Wir speichern das Formular mit `form.save` und wir fügen einen Autor hinzu (da es bislang kein `author` Feld in der `PostForm` gab und dieses Feld notwendig ist). `commit=False` bedeutet, dass wir das `Post` Model noch nicht speichern wollen - wir wollen erst noch den Autor hinzufügen. Meistens wirst du `form.save()` ohne `commit=False` benutzen, aber in diesem Fall müssen wir es so tun. `post.save()` wird die Änderungen sichern (den Autor hinzufügen) und ein neuer Blogpost wurde erstellt!
+
+Wäre es nicht grossartig, wenn wir direkt zu der `post_detail` Seite des neu erzeugten Blogposts gehen könnten? Um dies zu tun, benötigen wir noch einen zusätzlichen Import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Füge dies direkt am Anfang der Datei hinzu. Jetzt können wir endlich sagen: "Gehe zu der `post_detail` Seite unseres neu erstellten Posts":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` ist der Name der View, zu der wir springen wollen. Erinnerst du dich daran, dass diese *view* einen `pk` benötigt? Um diesen an die View weiterzugeben, benutzen wir `pk=post.pk`, wobei `post` unser neu erstellter Blogpost ist!
+
+Ok, wir haben jetzt eine ganze Menge geredet, aber du willst bestimmt sehen, wie die gesamte *View* aussieht, richtig?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Schauen wir mal, ob es funktioniert. Gehe zur Seite http://127.0.0.1:8000/post/new/, füge einen `title` und `text` hinzu und speichere es...voilà! Der neue Blogpost wird hinzugefügt und wir werden auf die `post_detail` Seite umgeleitet!
+
+Du hast vielleicht bemerkt, dass wir das Veröffentlichungsdatum festlegen, bevor wir den Post veröffentlichen. Später werden wir einen *publish button* in **Django Girls Tutorial: Extensions** einführen.
+
+Das ist genial!
+
+> Da wir vor Kurzem das Django-Admin-Interface benutzt haben, denkt das System, dass wir noch angemeldet sind. Es gibt einige Situationen, welche dazu führen können, dass wir ausgeloggt werden (Schließen des Browsers, Neustarten der Datenbank etc). Wenn du feststellst, dass du bei dem Erstellen von Posts Fehlermeldungen bekommst, die auf nicht angemeldete Nutzer zurückzuführen sind, dann gehe zur Admin Seite http://127.0.0.1:8000/admin und logge dich erneut ein. Dies wird das Problem vorübergehend lösen. Es gibt eine permanente Lösung dafür, die im Kapitel **Homework: add security to your website!** nach dem Haupttutorial auf dich wartet.
+
+![Anmeldefehler](images/post_create_error.png)
+
+## Formularvalidierung
+
+Jetzt zeigen wir dir, wie cool Django-Formulare sind. Ein Blogpost muss `title`- und `text`-Felder besitzen. In unserem `Post`-Model haben wir (im Gegensatz zu dem `published_date`) nicht festgelegt, dass diese Felder nicht benötigt werden, also nimmt Django standardmäßig an, dass sie definiert werden.
+
+Versuch, das Formular ohne `title` und `text` zu speichern. Rate, was passieren wird!
+
+![Formularvalidierung](images/form_validation2.png)
+
+Django kümmert sich darum sicherzustellen, dass alle Felder in unserem Formular richtig sind. Ist das nicht großartig?
+
+## "Bearbeiten"-Formular
+
+Jetzt wissen wir, wie ein neuer Blogpost hinzugefügt wird. Aber was ist, wenn wir einen bereits bestehenden bearbeiten wollen? Das funktioniert so ähnlich wie das, was wir gerade getan haben. Lass uns schnell ein paar wichtige Dinge erstellen. (Falls du etwas nicht verstehst, solltest du deinen Coach fragen oder in den vorherigen Kapiteln nachschlagen, da wir all die Schritte bereits behandelt haben.)
+
+Lass uns zunächst das Symbol speichern, das den Bearbeiten-Button darstellt. Lade [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) herunter und speichere es in `blog/templates/blog/icons/`.
+
+Öffne `blog/templates/blog/post_detail.html` im Code-Editor und füge folgenden Code innerhalb des Elements `article` hinzu:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+damit die Vorlage so aussieht:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Öffne `blog/urls.py` im Code-Editor und fügen diese Zeile hinzu:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+Wir werden die Vorlage `blog/templates/blog/post_edit.html` wiederverwenden, daher ist das einzig Fehlende eine neue *View*.
+
+Öffne `blog/views.py` im Code-Editor und füge ganz am Ende der Datei Folgendes hinzu:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Sieht genauso aus wie unsere `post_new`-View, oder? Aber nicht ganz. Zum einen übergeben wir einen zusätzliche `pk`-Parameter aus `urls`. Und: Wir bekommen das `Post`-Model, welches wir bearbeiten wollen, mit `get_object_or_404(Post, pk=pk)` und wenn wir dann ein Formular erstellen, übergeben wir diesen Post als `instance`, wenn wir das Formular speichern…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+als auch, wenn wir ein Formular mit post zum Editieren öffnen:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+Ok, lass uns mal schauen, ob das funktioniert! Geh auf die `post_detail`-Seite. Dort sollte sich ein Editier-Button in der oberen rechten Ecke befinden:
+
+![Schaltfläche "Bearbeiten"](images/edit_button2.png)
+
+Wenn du darauf klickst, siehst du das Formular mit unserem Blogpost:
+
+!["Bearbeiten"-Formular](images/edit_form2.png)
+
+Probier doch einmal, den Titel oder den Text zu ändern und die Änderungen zu speichern!
+
+Herzlichen Glückwunsch! Deine Anwendung nimmt immer mehr Gestalt an!
+
+Falls du mehr Informationen über Django-Formulare benötigst, solltest du die offizielle Dokumentation lesen: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Sicherheit
+
+Neue Posts durch Klick auf einen Link zu erstellen ist großartig! Aber im Moment ist jeder, der deine Seite besucht, in der Lage, einen neuen Blogpost zu veröffentlichen, und das ist etwas, was du garantiert nicht willst. Lass es uns so machen, dass der Button für dich angezeigt wird, aber für niemanden sonst.
+
+Öffne die Datei `blog/templates/blog/base.html` im Code-Editor, finde darin unseren `header` und das Anchor-Element, welches du zuvor eingefügt hast. Es sollte so aussehen:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Wir fügen ein weiteres `{% if %}`-Tag ein, was dafür sorgt, dass der Link nur für angemeldete Nutzer angezeigt wird. Im Moment bist das also nur du! Ändere das `<a>`-Element zu Folgendem:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+Dieses `{% if %}` sorgt dafür, dass der Link nur zu dem Browser geschickt wird, wenn der anfragende Nutzer auch angemeldet ist. Das verhindert das Erzeugen neuer Posts nicht komplett, ist aber ein sehr guter erster Schritt. In der Erweiterungslektion kümmern wir uns ausgiebiger um Sicherheit.
+
+Erinnerst du dich an den Editier-Button, den wir gerade zu unserer Seite hinzugefügt haben? Wir wollen dort dieselbe Anpassung machen, damit andere Leute keine existierenden Posts verändern können.
+
+Öffne `blog/templates/blog/post_detail.html` im Code-Editor und finde folgende Zeile:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Ändere es wie folgt:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Da du wahrscheinlich angemeldet bist, wirst du beim Refresh der Seite keinen Veränderung feststellen. Lade jedoch die Seite in einem anderen Browser oder einem Inkognito-Fenster ("In Private" im Windows Edge) und du wirst sehen, dass dieser Link nicht auftaucht und das Icon ebenfalls nicht angezeigt wird!
+
+## Eins noch: Zeit für das Deployment!
+
+Mal sehen, ob das alles auch auf PythonAnywhere funktioniert. Zeit für ein weiteres Deployment!
+
+* Commite als Erstes deinen neuen Code und schiebe ihn auf GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Dann führe Folgendes in der [PythonAnywhere Bash-Konsole](https://www.pythonanywhere.com/consoles/) aus:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<deine-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Denk daran, `<deine-pythonanywhere-domain>` durch deine tatsächliche PythonAnywhere-Subdomain zu ersetzen - ohne die spitzen Klammern.)
+
+* Gehe schließlich noch rüber [auf die Seite "Web"](https://www.pythonanywhere.com/web_app_setup/) (benutze den Menü-Knopf in der rechten oberen Ecke der Konsole) und klicke **Reload**. Lade deinen Blog https://subdomain.pythonanywhere.com neu, um die Änderungen zu sehen.
+
+Und das war's. Glückwunsch! :)
\ No newline at end of file
diff --git a/de-DE/django_installation/README.md b/de-DE/django_installation/README.md
new file mode 100644
index 00000000000..e2fe6b6e527
--- /dev/null
+++ b/de-DE/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django-Installation
+
+> **Hinweis** Wenn du ein Chromebook verwendest, überspringe bitte dieses Kapitel und folge den Anweisungen im [Chromebook Setup](../chromebook_setup/README.md).
+> 
+> **Hinweis:** Falls du dich bereits durch die [Installationsschritte](../installation/README.md) gearbeitet hast, gibt es keinen Grund dies erneut zu tun – du kannst direkt zum nächsten Kapitel springen!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/de-DE/django_installation/instructions.md b/de-DE/django_installation/instructions.md
new file mode 100644
index 00000000000..dba55f4f989
--- /dev/null
+++ b/de-DE/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Ein Teil dieses Kapitels basiert auf den Tutorials von Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Teile dieses Kapitels basieren auf dem [django-marcador Tutorial](http://django-marcador.keimlink.de/) lizenziert unter der Creative Commons Attribution-ShareAlike 4.0 International License. Für das "django-marcador Tutorial" liegt das Urheberrecht bei Markus Zapke-Gründemann et al.
+
+## Virtuelle Umgebung
+
+Bevor wir mit der Installation von Django beginnen, lernen wir ein sehr hilfreiches Tool kennen, das uns hilft, unsere Arbeitsumgebung zum Coden sauber zu halten. Es ist möglich, diesen Schritt zu überspringen, aber wir legen ihn dir dennoch besonders ans Herz. Mit dem bestmöglichen Setup zu starten, wird dir in der Zukunft eine Menge Frust ersparen!
+
+Wir erzeugen eine virtuelle Arbeitsumgebung - ein **virtual environment** oder auch *virtualenv*. Das isoliert die Python-/Django-Setups verschiedener Projekte voneinander. Das bedeutet, dass deine Änderungen an einem Website-Projekt keine anderen Projekte beeinträchtigen, an welchen du sonst noch entwickelst. Klingt nützlich, oder?
+
+Du musst nur das Verzeichnis festlegen, in dem du das `virtualenv` erstellen willst; zum Beispiel dein Home-Verzeichnis. Auf Windows ist dies `C:\Users\Name` (`Name` ist dein Anmeldename/Login).
+
+> **HINWEIS:** Stelle auf Windows sicher, dass dieser Verzeichnisname keine Umlaute oder Sonderzeichen enthält. Falls dein Benutzername Umlaute enthält, verwende ein anderes Verzeichnis, zum Beispiel `C:\djangogirls`.
+
+In diesem Tutorial erstellen wir darin ein neues Verzeichnis `djangogirls`:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Wir erstellen eine virtuelle Umgebung namens `myvenv`. Das Kommando dazu lautet dann:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Um ein neues `virtualenv` zu erzeugen, musst du auf der Kommandozeile von Windows `python -m venv myvenv` ausführen. Das wird so aussehen:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+wobei `myvenv` der Name deines `virtualenv` ist. Du kannst auch irgend einen anderen Namen wählen, aber bleibe bei Kleinbuchstaben und verwende keine Leerzeichen, Umlaute oder Sonderzeichen. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Auf Linux oder OS X kann ein `virtualenv` durch das Ausführen von `python3 -m venv myvenv` erzeugt werden. Das wird so aussehen:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` ist der Name deiner neuen virtuellen Arbeitsumgebung, deines neuen `virtualenv`. Du kannst auch irgend einen anderen Namen wählen, aber bleibe bei Kleinbuchstaben und verwende keine Leerzeichen. Eine Gute Idee ist, den Namen kurz zu halten. Du wirst ihn oft benutzen bzw. eingeben müssen!
+
+> **Hinweis:** Bei manchen Versionen von Debian/Unbuntu kann folgender Fehler auftreten:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> Falls das auftritt, folge den Anweisungen in der Fehlermeldung und installiere das `python3-venv`-Paket: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **HINWEIS:** In manchen Debian/Ubuntu-Versionen kann das zu folgendem Fehler führen:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Falls das eintritt, verwende stattdessen den `virtualenv`-Befehl.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **HINWEIS:** Wenn du einen Fehler wie
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> erhältst, führe stattdessen Folgendes aus:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Mit der virtuellen Umgebung arbeiten
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Starte deine virtuelle Umgebung, indem du Folgendes eingibst:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. Öffne in diesem Fall eine weitere Windows PowerShell über "Als Administrator ausführen". Versuche dann, das folgende Kommando einzugeben, bevor du das virtualenv noch einmal aktivierst:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> Der Vorteil davon ist, dass du nicht zwischen den Editor-Fenstern und den Kommandozeilen-Fenstern wechseln musst
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Starte deine virtuelle Umgebung, indem du eingibst:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Der Name `myvenv` muss mit dem von Dir gewählten Namen des `virtualenv` übereinstimmen!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+Du erkennst, dass dein `virtualenv` gestartet ist, wenn du vor der Eingabeaufforderung eine Klammer mit dem Namen deiner Umgebung siehst, `(myvenv)`.
+
+In deiner neuen virtuellen Umgebung wird automatisch die richtige Version von `python` verwendet. Du kannst also `python` statt `python3` eingeben.
+
+Ok, jetzt ist die erforderliche Umgebung startklar und wir können endlich Django installieren!
+
+## Django-Installation {#django}
+
+Da du nun dein `virtualenv` gestartet hast, kannst du Django installieren.
+
+Bevor wir damit loslegen, sollten wir jedoch sicherstellen, dass wir die neueste Version von `pip` haben, eine Software, mit Hilfe derer wir Django installieren werden:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Pakete mittels requirements-Datei installieren
+
+Eine requirements-Datei enthält eine Liste von Abhängigkeiten, die von `pip install` installiert werden sollen:
+
+Erstelle mit dem zuvor installierten Code-Editor eine Datei namens `requirements.txt` im Verzeichnis `djangogirls/`. Das machst du, indem du eine neue Datei in deinem Code-Editor öffnest und als `requirements.txt` im Ordner `djangogirls/` abspeicherst. Dein Ordner sieht jetzt so aus:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+Schreibe in die Datei `djangogirls/requirements.txt` folgenden Text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Führe nun `pip install -r requirements.txt` aus, um Django zu installieren.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). Ist das der Fall, dann verwende bitte einen anderen Ordner ohne Sonderzeichen, Umlaute oder Leerzeichen. (Vorschlag: `C:\djangogirls`). Erstelle ein neues virtualenv in einem neuen Verzeichnis, lösche danach das alte und wiederhohle den oben genannten Befehl. (Das Verzeichnis des virtualenv zu verschieben funktioniert dabei nicht, da virtualenv absolute Pfade verwendet.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> Falls der pip-Aufruf auf Ubuntu 12.04 zu einer Fehlermeldung führt, rufe `python -m pip install -U --force-reinstall pip` auf, um die Installation von pip im virtualenv zu reparieren.
+
+<!--endsec-->
+
+Das war's! Du bist nun (endlich) bereit, deine erste Django-Anwendung zu starten!
\ No newline at end of file
diff --git a/de-DE/django_models/README.md b/de-DE/django_models/README.md
new file mode 100644
index 00000000000..7aa3e065463
--- /dev/null
+++ b/de-DE/django_models/README.md
@@ -0,0 +1,201 @@
+# Django-Models
+
+Wir erstellen jetzt etwas, damit wir alle Posts von unserem Blog speichern können. Aber um das zu tun, müssen wir zunächst über `Objekte` sprechen.
+
+## Objekte
+
+Eine Herangehensweise an das Programmieren ist das so genannte `objektorientierte Programmieren`. Die Idee dahinter ist, dass wir Dinge und ihre Interaktionen untereinander modellieren können und nicht alles als langweilige Kette von Programmbefehlen hintereinander aufschreiben müssen.
+
+Was ist denn nun ein Objekt? Ein Objekt ist eine Sammlung von Eigenschaften und Aktionsmöglichkeiten, das anhand einer Vorlage (Klasse) erstellt wird. Das klingt erst einmal komisch, aber hier haben wir gleich ein Beispiel.
+
+Wenn wir zum Beispiel eine Katze modellieren wollen, erschaffen wir eine Objektvorlage `Katze`, eine Art Blaupause oder Schema, nach welcher zukünftig jedes spezifische Katzenobjekt erstellt werden kann. Die Vorlage beschreibt typische Eigenschaften von Katzen, z.B. `farbe`, `alter`, `stimmung` (also gut, schlecht oder müde ;)), `besitzerin` (die ein `Person`-Objekt ist oder – im Falle einer Streunerkatze – leer bleibt).
+
+Jedes Objekt einer `Katze` soll natürlich auch einige Aktionsmöglichkeiten besitzen: `schnurren`, `kratzen` oder `füttern` (hier bekäme die Katze ein bisschen `Katzenfutter`, welches wieder durch ein eigenes Objekt mit Eigenschaften wie `Geschmack` repräsentiert sein könnte).
+
+    Katze
+    --------
+    farbe
+    alter
+    stimmung
+    besitzerin
+    schnurren()
+    kratzen()
+    fuettern(katzen_futter)
+    
+
+    Katzenfutter
+    --------
+    geschmack
+    
+
+Der Gedanke dahinter ist also, echte Dinge mit Hilfe von Eigenschaften (genannt `Objekteigenschaften`) und Aktionsmöglichkeiten (genannt `Methoden`) im Programmcode zu beschreiben.
+
+Wie also modellieren wir Blogposts? Schließlich wollen wir ja einen Blog bauen, nicht wahr?
+
+Wir müssen folgende Fragen beantworten: Was ist ein Blogpost? Welche Eigenschaften sollte er haben?
+
+Nun, zum einen braucht unser Blogpost Text mit einem Inhalt und einen Titel, oder? Außerdem wäre es schön zu wissen, wer ihn geschrieben hat – wir brauchen also noch einen Autor. Schließlich wollen wir wissen, wann der Post geschrieben und veröffentlicht wurde.
+
+    Post 
+    -------- 
+    title 
+    text
+    author
+    created_date
+    published_date
+    
+
+Was für Dinge könnte man mit einem Blogpost machen? Es wäre schön, wenn wir eine `Methode` hätten, die den Post veröffentlicht, nicht wahr?
+
+Wir brauchen also eine `veröffentlichen`-Methode.
+
+Da wir jetzt wissen, was wir erreichen wollen, können wir nun damit anfangen, es in Django zu formulieren!
+
+## Ein Django-Model erstellen
+
+Da wir jetzt in etwa wissen, was ein Objekt ist, wollen wir ein Django-Model, eine Vorlage, für unsere Blogposts anlegen, nach welcher wir zukünftig unsere Blogpostobjekte erstellen können.
+
+Ein "Modell" ist in Django ein Objekt einer speziellen Sorte – eines das in der `Datenbank` gespeichert wird. Eine Datenbank ist eine Sammlung von Daten. Dies ist ein Ort, an dem du Informationen zu Benutzern, deinen Blogposts usw. speichern wirst. Wir benutzen dafür eine SQLite-Datenbank. Das ist die Voreinstellung in Django – für uns wird das erst einmal ausreichen.
+
+Du kannst dir ein Model wie eine Tabelle mit Spalten ("Feldern", englisch "fields") und Zeilen (Datensätzen) vorstellen.
+
+### Eine Applikation für unseren Blog
+
+Um unsere Webseite aufgeräumt zu halten, werden wir eine eigene Anwendung für unser Projekt erstellen, wir nennen das eine Applikation. Wir wollen uns gleich daran gewöhnen, alles ordentlich und sortiert zu halten. Um eine Applikation zu erstellen, müssen wir das folgende Kommando in der Konsole ausführen (wieder in dem `djangogirls`-Verzeichnis, in dem die `manage.py`-Datei liegt):
+
+{% filename %}Mac OS X und Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Wie du sehen kannst, wurde ein neues `blog`-Verzeichnis erstellt, welches schon einige Dateien enthält. Das Verzeichnis und die Dateien unseres Projektes sollten jetzt so aussehen:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+Nach dem Erstellen der Applikation müssen wir Django noch sagen, dass diese auch genutzt werden soll. Das tun wir in der Datei `mysite/settings.py` -- öffne diese in deinem Code-Editor. Wir suchen den Eintrag `INSTALLED_APPS` und fügen darin die Zeile `'blog.apps.BlogConfig',` direkt über der schließenden Klammer `]` ein. Danach sollte es also so aussehen:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Das Blogpost-Model
+
+Alle `Models` unserer Applikation werden in der `blog/models.py`-Datei definiert. Dies ist also der richtige Platz für unser Blogpost-Model.
+
+Öffnen wir also `blog/models.py` im Code-Editor, löschen alles darin und schreiben Code wie diesen:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Kontrolliere nochmal, dass du zwei Unterstriche (`__`) vor und hinter dem `str` gesetzt hast. Diese Konvention wird häufig in Python benutzt und manchmal nennen wir es "dunder" (kurz für "double-underscore").
+
+Es sieht kompliziert aus, oder? Aber keine Sorge, wir werden erklären, was diese Zeilen bedeuten!
+
+Die Zeilen, die mit `from` oder `import` beginnen, sind Anweisungen, um Sachen aus anderen Dateien mitzunutzen. Anstatt häufig genutzten Code in jede Datei einzeln zu kopieren, binden wir ihn ein mit: `from... import ...`.
+
+`class Post(models.Model):` – Diese Zeile definiert unser Model (eine Objekt-Vorlage).
+
+- `class` ist ein spezielles Schlüsselwort, das angibt, dass wir hier eine Klasse, eine Vorlage für zukünftige Objekte, definieren wollen.
+- `Post` ist der Name unseres Models. Wir können ihm auch einen anderen Namen geben (aber wir müssen Sonderzeichen und Leerzeichen vermeiden). Beginne einen Klassennamen immer mit einem Großbuchstaben.
+- `models.Model` gibt an, dass das Post-Model ein Django-Model ist, so weiß Django, dass es in der Datenbank gespeichert werden soll.
+
+Jetzt definieren wir die Eigenschaften, über welche wir gesprochen haben: `title`, `text`, `created_date`, `published_date` und `author`. Um dies zu tun, müssen wir den Typ jedes Felds definieren. (Ist es Text? Eine Zahl? Ein Datum? Eine Beziehung zu einem anderen Objekt, z.B. einem Benutzer?)
+
+- `models.CharField` – so definierst du ein Textfeld mit einer limitierten Anzahl von Zeichen.
+- `models.TextField` – so definierst du ein langes Textfeld ohne Grössenbeschränkung. Klingt doch perfekt für unsere Blogpostinhalte, oder?
+- `models.DateTimeField` – ein Feld für einen Zeitpunkt (ein Datum und eine Uhrzeit).
+- `models.ForeignKey` – definiert eine Verknüpfung/Beziehung zu einem anderen Model.
+
+Wir werden nicht den gesamten Code hier erklären, da das zu lange dauern würde. Du solltest einen Blick in die offizielle Django-Dokumentation werfen, wenn du mehr über Modelfelder und darüber wissen möchtest, wie man auch andere Dinge als die oben beschriebenen definiert (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+Was ist mit `def publish(self):`? Das ist genau die `publish`-Methode zum Veröffentlichen unserer Blogposts, über die wir vorher bereits sprachen. `def` zeigt an, dass es sich nachfolgend um eine Funktion/Methode handelt, und `publish` ist der Name der Methode. Du kannst den Namen der Methode auch ändern, wenn du möchtest. Die Benennungsregel ist, dass wir Kleinbuchstaben verwenden, und anstatt Leerzeichen (die in Funktionsnamen nicht vorkommend dürfen) Unterstriche. Eine Methode, die einen Durchschnittspreis berechnet, könnte zum Beispiel `calculate_average_price` genannt werden.
+
+Oft geben Methoden einen Wert zurück (englisch: `return`). Ein Beispiel dafür ist die Methode `__str__`. In diesem Szenario, wenn wir `__str__()` aufrufen, bekommen wir einen Text (**string**) mit einem Blogpost-Titel zurück.
+
+Beachte, dass sowohl `def publish(self):` als auch `def __str__(self):` in unserer Klasse eingerückt sind. Mit der Einrückung sagen wir Python, dass diese Methoden Teil der Klasse sind. Ohne die Einrückung wären es für Python Funktionen ausserhalb der Klasse, was zu anderem Verhalten führen würde.
+
+Wenn dir über Methoden noch etwas nicht klar ist, dann zögere nicht, deinen Coach zu fragen! Wir wissen, dass es kompliziert ist, vor allem, wenn du gleichzeitig lernst, was Objekte und Funktionen sind. Aber hoffentlich sieht es für dich jetzt etwas weniger nach Magie aus!
+
+### Tabellen für Models in deiner Datenbank erstellen
+
+Als letzten Schritt wollen wir unser neues Model der Datenbank hinzufügen. Dazu müssen wir Django erst 'mal mitteilen, dass wir einige Änderungen an unserem Model vorgenommen haben. (Wir haben es eben erst erstellt!) Scheibe `python manage.py makemigrations blog` in dein Kommandozeilen-Fenster. Das sieht dann so aus:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Hinweis:** Denke daran, die Dateien nach dem Editieren zu speichern. Ansonsten führt dein Computer die vorherige Version aus, was zu unerwarteten Fehlermeldungen führen kann.
+
+Django hat eine Migrationsdatei für uns vorbereitet, die wir nun auf unsere Datenbank anwenden müssen. Schreibe `python manage.py migrate blog`. Die Ausgabe sollte so aussehen:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:   
+       Apply all migrations: blog
+    Running migrations:
+       Applying blog.0001_initial... OK
+    
+
+Hurra! Unser Post-Model ist ab sofort in unserer Datenbank gespeichert! Es wäre doch schön, zu wissen, wie es aussieht, oder? Springe zum nächsten Kapitel, um es dir anzusehen!
\ No newline at end of file
diff --git a/de-DE/django_orm/README.md b/de-DE/django_orm/README.md
new file mode 100644
index 00000000000..6621b90a1d9
--- /dev/null
+++ b/de-DE/django_orm/README.md
@@ -0,0 +1,219 @@
+# Django-ORM und QuerySets
+
+In diesem Kapitel lernst du, wie sich Django mit der Datenbank verbindet und Daten darin speichert. Lass uns loslegen!
+
+## Was ist ein QuerySet?
+
+Zusammengefasst ist ein QuerySet eine Liste von Objekten eines bestimmten Models. QuerySets erlauben es dir, Daten aus der Datenbank zu lesen, zu filtern und zu sortieren.
+
+Am besten wir sehen uns das an einem Beispiel an. Versuchen wir's?
+
+## Django-Shell
+
+Öffne deine lokale Konsole (nicht in PythonAnywhere) und tippe dieses Kommando ein:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Das sollte angezeigt werden:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole) >>>
+```
+
+Nun bist du in der interaktiven Konsole von Django. Die funktioniert wie der Python-Prompt, aber hat noch etwas zusätzliche Django-Magie. :) Du kannst hier auch alle Python-Befehle verwenden.
+
+### Alle Objekte
+
+Zunächst wollen wir alle unsere Blogposts ansehen. Das kannst du mit folgendem Kommando erreichen:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Hoppla! Eine Fehlermeldung ist erschienen. Sie sagt uns, dass Python "Post" nicht kennt. Und sie hat recht: Wir haben vergessen zu importieren!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+Wir importieren das Model `Post` aus `blog.models`. Versuchen wir nochmal, alle Posts anzuzeigen:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Das ist eine Liste all der Posts, die wir zuvor lokal erstellt haben! Wir haben diese Posts mit der Django-Admin-Oberfläche erstellt. Aber nun wollen wir weitere Posts mit Python erstellen! Wie geht das also?
+
+### Objekt erstellen
+
+So erstellst du ein neues Post-Objekt in der Datenbank:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Allerdings fehlt noch eine Zutat: `me`. Wir müssen eine Instanz des Models `User` als Autor übergeben. Wie macht man das?
+
+Als Erstes müssen wir das User-Model importieren:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Welche User sind in unserer Datenbank vorhanden? Finde es damit heraus:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+Das ist der Superuser, den wir vorhin erstellt haben! Lass uns jetzt eine Instanz des Users erstellen (passe diese Zeile an, so dass dein eigener Benutzername verwendet wird):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Wie du siehst, holen (`get`) wir jetzt ein `User`-Objekt mit einem `username` 'ola'. Prima!
+
+Jetzt können wir schließlich unseren Post erstellen:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Super! Wollen wir nachsehen, ob es funktioniert hat?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Da ist er, ein weiterer Post in der Liste!
+
+### Mehrere Posts hinzufügen
+
+Du kann jetzt nach Belieben weitere Blogposts hinzufügen, um ein Gefühl dafür zu bekommen, wie es funktioniert. Füge doch noch zwei, drei hinzu bevor du zum nächsten Teil übergehst.
+
+### Objekte filtern
+
+Eine wichtige Eigenschaft von QuerySets ist, dass die Einträge gefiltert werden können. Zum Beispiel wollen wir alle Posts finden, die der User Ola geschrieben hat. Dafür nehmen wir `filter` statt `all` in `Post.objects.all()`. In Klammern schreiben wir die Bedingung(en), die ein Blogpost erfüllen muss, damit ein er in unser Queryset kommt. So soll jetzt z.B. `author` gleich `me` sein, damit nur die Blogposts des Autors "me" herausgefiltert werden. In Django schreiben wir deshalb: `author=me`. Jetzt sieht unser Code folgendermaßen aus:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Oder vielleicht wollen wir alle Posts haben, die das Wort "title" im `title`-Feld haben?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Anmerkung:** Zwischen `title` und `contains` befinden sich zwei Unterstriche (`__`). Das ORM von Django nutzt diese Regel, um Feldnamen ("title") und Operationen oder Filter ("contains") voneinander zu trennen. Wenn du nur einen Unterstrich benutzt, bekommst du einen Fehler wie "FieldError: Cannot resolve keyword title_contains".
+
+Du kannst auch eine Liste aller bereits publizierten Posts erhalten, indem wir nach allen Posts suchen, deren `published_date` in der Vergangenheit liegt:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unglücklicherweise ist der Post, den wir über die Python-Konsole hinzugefügt haben, noch nicht veröffentlicht. Aber das können wir ändern! Als Erstes holen wir eine Instanz des Posts, den wir veröffentlichen wollen:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+Dann publizieren wir ihn mit unserer `publish`-Methode:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Jetzt versuch nochmal, eine Liste von veröffentlichten Posts zu bekommen (drücke dreimal "Pfeil nach oben" und `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Objekte ordnen
+
+Mit den QuerySets kannst du eine Liste auch nach bestimmten Kriterien ordnen. Lass uns das mit dem `created_date` Feld ausprobieren:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Wir können die Reihenfolge auch umdrehen, indem wir "`-`" davor schreiben:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Komplexe Queries durch Methoden-Verkettung
+
+Wie du gesehen hast, geben einige Methoden auf `Post.objects` ein QuerySet zurück. Die selben Methoden können wiederum auch auf einem QuerySet aufgerufen werden und geben dann ein neues QuerySet zurück. Das ermöglicht es, ihre Wirkung zu kombinieren, indem du die Methoden **verkettest**:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Dies ist wirklich mächtig und lässt dich ziemlich komplexe Abfragen schreiben.
+
+Cool! Jetzt bist du bereit für den nächsten Teil! Um die Konsole zu schließen, schreib das:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+```
\ No newline at end of file
diff --git a/de-DE/django_start_project/README.md b/de-DE/django_start_project/README.md
new file mode 100644
index 00000000000..737db5e3a8c
--- /dev/null
+++ b/de-DE/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Dein erstes Django-Projekt!
+
+> Ein Teil dieses Kapitels basiert auf Tutorials der Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Teile dieses Kapitels basieren auf dem [django-marcador Tutorial](http://django-marcador.keimlink.de/) lizenziert unter Creative Commons Attribution-ShareAlike 4.0 International License. Für das "django-marcador Tutorial" liegt das Urheberrecht bei Markus Zapke-Gründemann et al.
+
+Wir werden einen kleinen Blog erstellen!
+
+Der erste Schritt ist, ein neues Django-Projekt zu starten. Im Grunde bedeutet das, dass wir einige Skripte ausführen werden, die Django zur Verfügung stellt, um ein Skelett eines Django-Projekts für uns zu erzeugen. Das Projekt beinhaltet einen Haufen von Verzeichnissen und Dateien, die wir später verwenden werden.
+
+Die Namen einiger Dateien und Verzeichnisse sind sehr wichtig für Django. Die Dateien, die erstellt werden, solltest du nicht umbenennen. Sie an eine andere Stelle zu verschieben, ist auch keine gute Idee. Django muss zwingend eine gewisse Struktur erhalten, um wichtige Dinge wiederzufinden.
+
+> Denk daran, alles in der "Virtualenv"-Umgebung auszuführen. Wenn du kein Präfix `(myvenv)` in deiner Konsole siehst, musst du deine Virtualenv-Umgebung aktivieren. Wie das gemacht wird, erklären wir im Kapitel **Django-Installation**, im Abschnitt **Arbeiten mit Virtualenv**. Zur Erinnerung: Gib dazu auf Windows `myvenv\Scripts\activate` ein, bzw. auf OS X oder Linux `source myvenv/bin/activate`.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In deiner OS X- oder Linux-Konsole solltest du den folgenden Befehl ausführen; **vergiss den Punkt (`.`) am Ende nicht!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Der Punkt `.` ist sehr wichtig, weil er dem Skript mitteilt, dass Django in deinem aktuellen Verzeichnis installiert werden soll. (Der Punkt `.` ist eine Schnellreferenz dafür.)
+> 
+> **Hinweis:** Wenn du das oben angegebene Kommando eingibst, denk daran, nur das einzutippen, was mit `django-admin` anfängt. Der `(myvenv) ~/djangogirls$`-Teil hier ist nur ein Beispiel für die Eingabeaufforderung (den "Prompt") auf der Kommandozeile.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Auf Windows solltest du den folgenden Befehl ausführen. **(Vergiss den Punkt (`.`) am Ende nicht!)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Der Punkt `.` ist sehr wichtig, weil er dem Skript mitteilt, dass Django in deinem aktuellen Verzeichnis installiert werden soll. (Der Punkt `.` ist eine Schnellreferenz dafür.)
+> 
+> **Hinweis:** Wenn du das oben angegebene Kommando eingibst, denk daran, nur das einzutippen, was mit `django-admin.exe` anfängt. Der `(myvenv) C:\Users\Name\djangogirls>`-Teil hier ist nur ein Beispiel für die Eingabeaufforderung (den "Prompt") auf der Kommandozeile.
+
+<!--endsec-->
+
+`django-admin.py` ist ein Skript, welches Verzeichnisse und Dateien für dich erstellt. Du solltest jetzt eine Verzeichnisstruktur haben, die folgendermaßen aussieht:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Hinweis:** In deiner Verzeichnisstruktur wirst du auch den `venv`-Ordner sehen, den wir vorhin erzeugt haben.
+
+`manage.py` ist ein Script, das das Management deines Projektes unterstützt. Mit dem Script bist du unter anderem in der Lage, den Webserver auf deinem Rechner zu starten, ohne etwas Weiteres installieren zu müssen.
+
+Die Datei `settings.py` beinhaltet die Konfiguration deiner Website.
+
+Erinnerst du dich, als wir über den Postboten gesprochen haben, der überlegt, wohin er den Brief liefern soll? Die `urls.py` Datei beinhaltet eine Liste von Patterns (Mustern), die vom `urlresolver` benutzt werden.
+
+Lass uns kurz die anderen Dateien vergessen - wir werden sie nicht verändern. Denk aber dran, sie nicht versehentlich zu löschen!
+
+## Einstellungen anpassen
+
+Wir machen nun ein paar Änderungen in `mysite/settings.py`. Öffne die Datei mit dem Code-Editor, den du schon installiert hast.
+
+**Hinweis**: `settings.py` ist eine Datei wie jede andere. Du kannst sie aus deinem Code-Editor heraus öffnen, in dem du im "Datei"-Menü die "Öffnen"-Aktion wählst. So solltest du das normale Fenster zur Dateiauswahl bekommen, in dem du zur `settings.py`-Datei navigieren und sie auswählen kannst. Stattdessen kannst du die Datei aber auch öffnen, in dem du im Dateimanager zum "djangogirls"-Ordner navigierst und auf die Datei rechtsklickst. Wähle dann deinen Code-Editor aus der Liste der "Öffnen mit"-Programme. Das ist wichtig, da du andere Programme installiert haben könntest, die diese Datei zwar öffnen können, aber die dich die Datei nicht editieren lassen würden.
+
+Es wäre schön, wenn die richtige Zeit auf deiner Webseite eingestellt ist. Gehe zur [Zeitzonen-Liste auf Wikipedia](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) und kopiere die für dich geltende Zeitzone (Spalte "TZ"), z.B. `Europe/Berlin`.
+
+Suche in `settings.py` die Zeile, die `TIME_ZONE` enthält und ändere sie ab, um deine eigene Zeitzone auszuwählen. Zum Beispiel:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+Ein Sprachkennung besteht aus einem Kürzel für die Sprache, z.B. `en` für Englisch oder `de` für Deutsch, und einem Länder-Kürzel z.B. `de` für Deutschland oder `ch` für die Schweiz. Falls Englisch nicht deine Muttersprache ist, kannst du damit die Standard-Knöpfe und -Meldungen von Django auf deine Sprache wechseln. Der "Cancel"-Knopf würde dann in diese Sprache übersetzt (und z.B. bei Deutsch mit "Abbrechen" beschriftet). [Django enthält viele fix-fertige Übsersetzungen](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+Wenn du eine andere Sprache als Englisch willst, ändere die Sprachkennung, indem du die folgende Zeile änderst:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Ausserdem müssen wir einen Pfad für statische Dateien festlegen. (Über statische Dateien und CSS lernst du später in diesem Tutorial etwas.) Geh hinunter zum *Ende* der Datei und füge direkt unter dem `STATIC_URL`-Eintrag einen neuen Eintrag namens `STATIC_ROOT` ein:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Wenn `DEBUG` auf `True` gesetzt ist und `ALLOWED_HOSTS` leer, dann wird der "Host" gegen `['localhost', '127.0.0.1', '[::1]']` validiert. Unser Hostname auf PythonAnywhere, wo wir unsere Anwendung deployen werden, würde da nicht passen. Deswegen ändern wir folgende Einstellung:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Hinweis**: Wenn du ein Chromebook verwendest, füge noch diese Zeile am Ende deiner settings.py-Datei hinzu: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Falls du Cloud9 benutzt, füge auch `.amazonaws.com` zu den `ALLOWED_HOSTS` hinzu
+> 
+> Wenn du dein Projekt auf `Glitch.com` hostest, dann lass uns den Django-Sekret-Key schützen, der vertraulich bleiben muss (andernfalls könnte jeder, der dein Projekt remixt, diesen sehen):
+> 
+> - Zuerst erstellen wir einen zufälligen geheimen Schlüssel. Öffne erneut das Glitch-Terminal und gib den folgenden Befehl ein:
+>     
+>     {% filename %}Kommandozeile{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     Das sollte einen langen zufälligen String ausgeben, der perfekt für die Verwendung als geheimer Schlüssel für deine brandneue Django-Website geeignet ist. Wir werden diesen Schlüssel jetzt in eine Datei namens `.env` einfügen, die Glitch nur dir als Besitzerin der Website anzeigen wird.
+> 
+> - Erstelle eine Datei namens `.env` im Wurzelverzeichnis deines Projekts und füge folgenden Inhalt ein:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Hier, innerhalb der einfachen Anführungszeichen, kannst den oben erzeugten zufälligen Schlüssel einfügen
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Aktualisiere dann die Django-Einstellungen-Datei, um diesen geheimen Wert einzufügen zu lassen und lege den Django-Webseitennamen fest:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - Und etwas weiter unten in derselben Datei geben wir den Namen deiner neuen Glitch-Website ein:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     Der Wert `PROJECT_DOMAIN` wird automatisch von Glitch generiert. Er wird dem Namen deines Projekts entsprechen.
+
+## Eine Datenbank erstellen
+
+Es gibt viele verschiedene Datenbank Programme, welche die Daten unserer Website verwalten können. Wir werden die Standard-Datenbanksoftware nehmen, `sqlite3`.
+
+Das sollte schon in der `mysite/settings.py`-Datei eingestellt sein:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Um eine Datenbank für unseren Blog zu erstellen, müssen wir folgenden Befehl in der Konsole ausführen (Dazu müssen wir in dem `djangogirls`-Verzeichnis sein, in dem sich auch die `manage.py`-Datei befindet). Wenn alles glatt läuft, sollte das so aussehen:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE 
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK 
+      Applying contenttypes.0002_remove_content_type_name... OK 
+      Applying auth.0002_alter_permission_name_max_length... OK 
+      Applying auth.0003_alter_user_email_max_length... OK 
+      Applying auth.0004_alter_user_username_opts... OK  
+      Applying auth.0005_alter_user_last_login_null... OK 
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+Und wir sind fertig! Zeit, unseren Webserver zu starten, um zu sehen, ob unsere Website funktioniert!
+
+## Den Webserver starten
+
+Kontrolliere, dass du in dem Verzeichnis bist, in dem die `manage.py`-Datei liegt (das `djangogirls`-Verzeichnis). Wir starten den Webserver, indem wir in der Konsole `python manage.py runserver` ausführen:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Wenn du ein Chromebook verwendest, benutze stattdessen diesen Befehl:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+oder wenn du Glitch verwendest, diesen:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+Wenn du Windows benutzt und dies mit dem `UnicodeDecodeError` fehlschläft, verwende diesen Befehl:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Jetzt wollen wir schauen, ob unsere Website funktioniert: Öffne deinen Browser (Firefox, Chrome, Safari, Edge oder was du sonst nutzt) und gib diese Adresse ein:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+Wenn du ein Chromebook und Cloud9 verwendest, dann klicke stattdessen die URL im erschienenen Fenster in der oberen rechten Ecke des Kommandozeilenfensters, in dem der Webserver läuft. Die URL sollte etwa so aussehen:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+oder auf Glitch:
+
+    https://name-deines-glitch-projects.glitch.me
+    
+
+Glückwunsch! Du hast gerade deine erste Website erstellt und sie auf deinem Webserver laufen! Ist das nicht toll?
+
+![Installation hat funktioniert!](images/install_worked.png)
+
+Beachte, dass ein Terminalfenster immer nur eine Sache zur selben Zeit erledigen kann, und in dem Terminalfenster, was du vorhin geöffnet hast, läuft gerade der Webserver. Und solange der Webserver läuft und auf einkommende Anfragen wartet, akzeptiert das Terminal zwar Texteingaben, aber es wird keine neuen Befehle ausführen.
+
+> Wie Webserver funktionieren, haben wir im Kapitel **"Wie das Internet funktioniert"** angesehen.
+
+Um weitere Kommandos einzugeben, während der Webserver läuft, öffne ein neues Kommandozeilen-Fenster und aktiviere dort deine Virtualenv-Umgebung. Siehe [Einführung in die Kommandozeile](../intro_to_command_line/README.md), um nachzulesen, wie du ein zweites Kommandozeilen-Fenster öffnen kannst. Um den Webserver zu stoppen, wechsel zurück in das Fenster, in dem er läuft, und drücke STRG+C - Steuerung und C gleichzeitig. (In Windows kann es sein, dass du STRG und "Pause"-Taste drücken musst).
+
+Bereit für den nächsten Schritt? Es wird Zeit, ein paar Inhalte hinzuzufügen!
\ No newline at end of file
diff --git a/de-DE/django_templates/README.md b/de-DE/django_templates/README.md
new file mode 100644
index 00000000000..470a6e09043
--- /dev/null
+++ b/de-DE/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django-Templates
+
+Es wird Zeit, ein paar Daten anzuzeigen! Django bringt dafür bereits ein paar sehr hilfreiche **Template-Tags** mit.
+
+## Was sind Template-Tags?
+
+Also, in HTML kann man nicht wirklich Python-Code schreiben, weil es der Browser nicht verstehen würde. Denn der kennt nur HTML. Wir wissen, dass HTML ziemlich statisch ist, während Python dynamischer ist.
+
+Die **Django-Template-Tags** erlauben uns, Python-artige Dinge ins HTML zu bringen, so dass man einfach und schnell dynamische Websites erstellen kann. Super!
+
+## Anzeigen des Post-List-Templates
+
+Im vorangegangen Kapitel haben wir unserem Template in der `posts`-Variable eine Liste von Posts übergeben. Diese wollen wir jetzt in HTML anzeigen.
+
+Um eine Variable in einem Django-Template darzustellen, nutzen wir doppelte, geschweifte Klammern mit dem Namen der Variable darin, so wie hier:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Versuche das in deinem `blog/templates/blog/post_list.html` Template. Öffne es in deinem Code-Editor und ersetze alles vom zweiten `<div>` bis zum dritten `</div>` mit `{{ posts }}`. Speichere die Datei und aktualisiere die Seite, um die Ergebnisse anzuzeigen.
+
+![Abbildung 13.1](images/step1.png)
+
+Wie du siehst, haben wir nun das:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Das heißt, Django versteht es als Liste von Objekten. Kannst du dich noch an die Einführung von Python erinnern, wie man Listen anzeigen kann? Ja, mit for-Schleifen! In einem Django-Template benutzt du sie so:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Versuch das in deinem Template.
+
+![Abbildung 13.2](images/step2.png)
+
+Es funktioniert! Aber wir wollen, dass die Posts so wie die statischen Posts angezeigt werden, die wir vorhin im **Einführung in HTML**-Kapitel erstellt haben. Du kannst HTML und Template Tags mischen. Unser `body` sollte dann so aussehen:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Alles, was du zwischen `{% for %}`und `{% endfor %}` schreibst, wird für jedes Objekt in der Liste wiederholt. Aktualisiere deine Seite:{% endraw %}
+
+![Abbildung 13.3](images/step3.png)
+
+Ist dir aufgefallen, dass wir diesmal eine etwas andere Notation benutzen haben (`{{ post.title }}` oder `{{ post.text }}`)? Wir greifen auf Daten von jedem Feld unseres `Post`-Models zu. Außerdem leitet das `|linebreaksbr` den Text der Posts durch einen Filter, um Zeilenumbrüche in Absätze umzuwandeln.
+
+## Und zum Schluss
+
+Es wäre gut zu sehen, ob deine Website noch immer im öffentlichen Internet funktioniert, richtig? Lass uns versuchen, unsere Aktualisierungen wieder zu PythonAnywhere hochzuladen. Hier ist eine Zusammenfassung der Schritte…
+
+* Schiebe zuerst deinen Code auf GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Dann logg dich wieder bei [PythonAnywhere](https://www.pythonanywhere.com/consoles/) ein, geh zu deiner **Bash-Konsole** (oder starte eine neue) und gib ein:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <deine-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Denk daran, `<deine-pythonanywhere-domain>` durch deine tatsächliche PythonAnywhere-Subdomain zu ersetzen - ohne die spitzen Klammern.)
+
+* Spring anschließend rüber zur [Seite "Web"](https://www.pythonanywhere.com/web_app_setup/) und klick auf **Neu laden** in deinem Browser. (Um von der Konsolen-Seite aus zu anderen PythonAnywhere-Seiten zu gelangen, benutze den Menü-Knopf in der rechten oberen Ecke.) Ein Update sollte auf https://subdomain.pythonanywhere.com live sein -- guck's dir im Browser an! Wenn die Blogposts auf deiner PythonAnywhere-Seite anders sind als die auf deinem lokalen Server, ist das in Ordnung so. Die Datenbanken auf deinem lokalen Computer und auf PythonAnywhere werden nicht zusammen mit den restlichen Dateien abgeglichen.
+
+Glückwunsch! Nun kannst du dich daran machen, neue Posts in deinem Django Admin zu erstellen (denk daran, auch ein published_date einzufügen!). Stell sicher, dass du im Django-Admin der PythonAnywhere-Seite https://subdomain.pythonanywhere.com/admin arbeitest. Dann aktualisiere die Seite und schau nach, ob die Posts dort erscheinen.
+
+Funktioniert super? Wir sind so stolz auf dich! Steh kurz auf und geh ein Stück weg vom Computer. Du hast dir eine Pause verdient :)
+
+![Abbildung 13.4](images/donut.png)
\ No newline at end of file
diff --git a/de-DE/django_urls/README.md b/de-DE/django_urls/README.md
new file mode 100644
index 00000000000..728b50c8461
--- /dev/null
+++ b/de-DE/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django-URLs
+
+Gleich werden wir unsere erste Website basteln: eine Homepage für deinen Blog! Zuerst sollten wir uns jedoch mit Django URLs beschäftigen.
+
+## Was ist eine URL?
+
+Eine URL ist eine Web-Adresse. Jedes Mal, wenn du eine Website besuchst, kannst du eine URL sehen - sie ist in der Adressleiste des Browsers sichtbar. (Ja! `127.0.0.1:8000` ist eine URL! Und `https://djangogirls.org` ist auch eine URL.)
+
+![URL](images/url.png)
+
+Jede Seite im Internet braucht ihre eigene URL. Dadurch weiß deine Applikation, was sie dem Nutzer, der eine URL öffnet, zeigen soll. In Django verwenden wir eine sogenannte `URLconf` (URL-Konfiguration). URLconf ist eine Ansammlung von Mustern, die Django mit der empfangenen URL abgleicht, um die richtige View zu finden, das heißt, um letztlich die richtige Seite für den Nutzer anzuzeigen.
+
+## Wie funktionieren URLs in Django?
+
+Öffne die `mysite/urls.py`-Datei in deinem Code-Editor nach Wahl und schaue dir an, wie sie aussieht:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Wie du siehst, hat Django hier schon etwas für uns eingefügt.
+
+Zeilen zwischen dreifachen Gänsefüßchen (`'''` oder `"""`) heißen Docstrings (Kommentare) - man kann sie am Anfang der Datei, Klasse oder Methode platzieren, um zu beschreiben, was sie tut. Sie werden von Python nicht ausgeführt.
+
+Die admin-URL, die du im vorangegangenen Kapitel bereits besucht hast, ist schon da:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Diese Zeile bedeutet, dass Django für jede URL, die mit `admin/` beginnt, die entsprechende *View* finden wird. Hier wird mit admin-site.urls eine ganze Sammlung von admin-URLs referenziert. Dadurch müssen nicht alle in dieser kleinen Datei aufgeführt werden und sie bleibt lesbarer und übersichtlicher.
+
+## Deine erste Django-URL!
+
+Es wird Zeit, unsere erste URL zu erstellen! Wir wollen, dass 'http://127.0.0.1:8000/' die Homepage unseres Blogs wird und eine Liste unserer Posts zeigt.
+
+Wir wollen auch, dass die `mysite/urls.py`-Datei sauber bleibt. Deshalb importieren wir die URLs unserer `Blog`-Applikation in die `mysite/urls.py`-Hauptdatei.
+
+Also los: Füge eine Zeile hinzu, die `blog.urls` importiert. Ausserdem wirst du die Zeile `from django.urls…` ändern müssen, da wir hier die Funktion `include` verwenden, die du in dieser Zeile noch importieren musst.
+
+Deine `mysite/urls.py`-Datei sollte jetzt so aussehen:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django wird nun alle Aufrufe von 'http://127.0.0.1:8000/' auf `blog.urls` umleiten und dort nach weiteren Anweisungen schauen.
+
+## blog.urls
+
+Erstelle eine neue leere Datei namens `urls.py` im Verzeichnis `blog` und öffne sie im Code-Editor. Alles klar! Füge folgende zwei Zeilen ein:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Hier importieren wir die Django-Funktion `path` und alle unsere `views` aus unserer `blog`-Applikation. (Wir haben noch keine, aber dazu kommen wir gleich!)
+
+Jetzt können wir unser erstes URL-Muster hinzufügen:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+Wie du siehst, fügen wir nun eine `view` mit dem Namen `post_list` zur Root-URL hinzu. Leere Zeichenfolgen passen auf dieses Muster und der Django-URL-Resolver ignoriert den Domain-Namen (z.B. http://127.0.0.1:8000/), der im vollständigen Pfad voransteht. Dieses Muster sagt Django also, dass `views.post_list` das gewünschte Ziel ist, wenn jemand deine Website über 'http://127.0.0.1:8000/' aufruft.
+
+Der letzte Teil `name='post_list'` ist der Name der URL, der genutzt wird, um die View zu identifizieren. Er kann identisch mit dem Namen der View sein, aber es kann auch ein komplett anderer sein. Wir werden später die Namen der URLs im Projekt benutzen. Daher ist es wichtig, jede URL in der App zu benennen. Wir sollten außerdem versuchen, eindeutige und einfach zu merkende URL-Namen zu wählen.
+
+Wenn du jetzt versuchst, http://127.0.0.1:8000/ aufzurufen, dann erscheint eine Meldung der Art "Webseite nicht verfügbar". Das erscheint deshalb, weil der Server nicht mehr läuft. (Erinnerst du dich noch, `runserver` eingegeben zu haben?) Schau mal in deiner Server-Konsole nach und finde heraus, warum der Server nicht mehr läuft.
+
+![Error](images/error1.png)
+
+Die Konsole zeigt einen Fehler, aber keine Sorge – der ist eigentlich ziemlich nützlich: Er sagt dir, dass **kein Attribut 'post_list'** vorhanden ist. Das ist der Name der *View*, die Django zu finden und zu verwenden versucht, aber wir haben sie noch gar nicht erstellt. In diesem Zustand wird dein `/admin/` auch nicht funktionieren. Keine Sorge, das regeln wir gleich. Wenn du eine andere Fehlermeldung siehst, versuche es nochmal nach einem Neustart des Webservers. Stoppe dazu den Webserver, indem du Strg+C drückst (die Strg- bzw. Ctrl- und die C-Taste zusammen). Auf Windows musst du evtl. Strg+Untbr (bzw. Ctrl+Break) drücken. Dann musst du den Webserver mittels des Kommandos `python manage.py runserver` erneut starten.
+
+> Wenn du mehr über Django-URLconfs lernen willst, dann öffne die offizielle Dokumentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/de-DE/django_views/README.md b/de-DE/django_views/README.md
new file mode 100644
index 00000000000..ac71c660d35
--- /dev/null
+++ b/de-DE/django_views/README.md
@@ -0,0 +1,44 @@
+# Django-Views - leg los!
+
+Es wird jetzt Zeit, den Bug, den wir im letzten Kapitel erzeugt haben, zu beheben! :)
+
+In der *View* schreiben wir die Logik unserer Anwendung. So werden Informationen aus dem `Model` abgefragt werden, welches du zuvor erzeugt hast und diese werden an ein `Template` weitergeben. Ein Template erzeugen wir im nächsten Kapitel. Views sind Python-Funktionen, die ein bisschen komplizierter sind als die, die wir im Kapitel **Einführung in Python** kennengelernt haben.
+
+Views kommen in die `views.py` Datei. Wir fügen nun also unsere *Views* zur Datei `blog/views.py` hinzu.
+
+## blog/views.py
+
+OK, wir öffnen jetzt diese Datei in unserem Code-Editor und schauen, was darin steht:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+OK, hier steht noch nicht so viel.
+
+Denk daran, Zeilen mit einem `#` am Anfang sind Kommentare – das bedeutet, dass diese Zeilen von Python nicht ausgeführt werden.
+
+Lass uns eine *View* erstellen, wie der Kommentar das vorschlägt. Füge die folgende Mini-View unter dem Kommentar ein:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Wie du siehst, definieren wir eine Funktion (`def`) mit dem Namen `post_list`, die den Parameter `request` entgegen nimmt und die mit `return` den Rückgabewert einer anderen Funktion namens `render` zurück gibt. Letztere wird unser Template `blog/post_list.html` "rendern" (zu einer fertigen HTML-Seite zusammensetzen).
+
+Speichere die Datei, öffne http://127.0.0.1:8000/ im Browser und schau nach, was wir jetzt haben.
+
+Einen anderen Fehler! Lies, was da jetzt los ist:
+
+![Error](images/error.png)
+
+Das zeigt, dass der Server zumindest wieder läuft, aber es sieht immer noch nicht richtig aus, oder? Mach dir keine Sorgen, es ist nur eine Fehlerseite, nichts zu befürchten! Genau wie die Fehlermeldungen in der Konsole sind auch die hier ziemlich nützlich. Du erhältst den Hinweis *TemplateDoesNotExist*, also dass es das Template nicht gibt. Lass uns diesen Bug beheben, indem wir im nächsten Kapitel ein Template erstellen!
+
+> Erfahre mehr über Django Views in der offiziellen Dokumentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/de-DE/dynamic_data_in_templates/README.md b/de-DE/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..4af9e9bf509
--- /dev/null
+++ b/de-DE/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamische Daten in Templates
+
+Wir haben nun schon einige Dinge an verschiedenen Orten fertiggestellt: das `Post`-Model ist in der `models.py` definiert, wir haben die `post_list` in der `views.py` und das Template hinzugefügt. Aber wie schaffen wir es nun, dass unsere Posts wirklich im HTML-Template erscheinen? Denn wir wollen ja erreichen, dass bestimmte Inhalte (die in der Datenbank gespeicherten Models) auf schöne Weise in unserem Template anzeigt werden, richtig?
+
+Genau dafür sind die *Views* zuständig: die Verbindung zwischen den Models und den Templates. In unserer `post_list`-View müssen wir die Models, die wir anzeigen wollen, hernehmen und diese dem Template übergeben. In einer *View* entscheiden wir, was (welches Model) wir in einem Template anzeigen werden.
+
+Okay, und wie machen wir das jetzt?
+
+Wir öffnen unsere Datei `blog/views.py` in unserem Code-Editor. Bisher sieht unsere `post_list`-*View* folgendermaßen aus:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Erinnerst du dich, als wir davon gesprochen haben, dass wir den Code in verschiedene Dateien einfügen müssen? Jetzt ist es an der Zeit, das Model, dass wir in `models.py` beschrieben haben, einzufügen. Wir fügen den Befehl `from .models import Post` folgendermaßen ein:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+Der Punkt vor `models` bedeutet *aktuelles Verzeichnis* oder *aktuelle Anwendung*. Die Dateien `views.py` und `models.py` liegen im selben Verzeichnis. Deswegen können wir `.` und den Namen der Datei (ohne `.py`) benutzen. Dann ergänzen wir für den Import den Namen des Models (`Post`).
+
+Und nun? Um vom `Post`-Model die tatsächlichen Blogposts zu erhalten, brauchen wir etwas, das `QuerySet` heißt.
+
+## QuerySet
+
+Dir sollte schon ungefähr klar sein, wie QuerySets funktionieren. Wir haben darüber im Kapitel [Django-ORM und QuerySets](../django_orm/README.md) gesprochen.
+
+Wir wollen nun also eine Liste von publizierten Blogposts ausgeben, sortiert nach dem `published_date`, oder? Das haben wir bereits im Kapitel QuerySets gemacht!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Öffnen wir also die Datei `blog/views.py` im Code-Editor und setzen wir dieses Stück Code in die Funktion `def post_list(request)` ein. Aber vergiss nicht, zuerst `from django.utils import timezone` hinzufügen:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+Um unser QuerySet auf der Blogpost-Liste unseres Blogs anzuzeigen, bleiben noch zwei Dinge zu tun:
+
+1. Das QuerySet `posts` dem Template-Kontext übergeben, in dem wir den `render`-Funktionsaufruf ändern. Das werden wir jetzt tun.
+2. Das Template abändern, um das QuerySet `posts` anzuzeigen. Das werden wir in einem späteren Kapitel behandeln.
+
+Beachte, dass wir eine *Variable* für unser QuerySet erstellt haben: `posts`. Das ist sozusagen der Name unseres QuerySets. Ab jetzt bezeichnen wir das QuerySet mit diesem Namen.
+
+In der `render`-Funktion haben wir einen Parameter `request` (also alles, was wir vom User über das Internet bekommen) und einen weiteren Parameter, der den Template-Namen (`'blog/post_list.html'`) angibt. Der letzte Parameter, `{}`, ist eine Stelle, in der wir weitere Dinge hinzufügen können, die das Template dann benutzen kann. Wir müssen diesen einen Namen geben (wir verwenden einfach wieder `'posts'`). :) Es sollte nun so aussehen: `{'posts': posts}`. Bitte achte darauf, dass der Teil vor `:` ein String ist; das heißt, du musst ihn mit Anführungszeichen `''` umschliessen.
+
+Schließlich sollte deine `blog/views.py` Datei folgendermaßen aussehen:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+Das war's! Zeit, zurück zum Template zu gehen und das QuerySet anzuzeigen!
+
+Wenn du mehr über QuerySets in Django erfahren willst, dann sieh unter diesem Link nach: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/de-DE/extend_your_application/README.md b/de-DE/extend_your_application/README.md
new file mode 100644
index 00000000000..546a3170994
--- /dev/null
+++ b/de-DE/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Erweitere deine Anwendung
+
+Wir haben bereits die verschiedenen Schritte für die Erstellung unserer Website abgeschlossen: Wir wissen, wie man Models, URLs, Views und Templates schreibt. Wir wissen auch, wie wir unsere Website verschönern.
+
+Zeit zu üben!
+
+Das erste, was unser Blog braucht, ist eine Seite, auf der ein einzelner Blogpost dargestellt wird, oder?
+
+Wir haben bereits ein `Post`-Model, deshalb brauchen wir nichts zur `models.py` hinzufügen.
+
+## Erstelle eine Template-Verknüpfung
+
+Wir beginnen damit, einen Link in der `blog/templates/blog/post_list.html`-Datei zu erstellen. Öffne sie im Code-Editor, und bisher sollte sie etwa so aussehen: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}Wir wollen einen Link vom Titel eines Posts in der Post-Liste zur Detailseite des jeweiligen Posts haben. Ändern wir `<h2><a href="">{{ post.title }}</a></h2>`, so dass es zu der Detailseite verlinkt:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Es ist an der Zeit, das mysteriöse `{% url 'post_detail' pk=post.pk %}` zu erklären. Wie du dir wahrscheinlich schon denkst, bedeutet `{% %}`, dass wir Django-Template-Tags verwenden. Dieses Mal verwenden wir eines, das eine URL für uns erzeugen wird! {% endraw %}
+
+Der `post_detail`-Teil bedeutet, dass Django eine URL in `blog/urls.py` mit dem Namen name=post_detail erwartet.
+
+Und was ist mit `pk=post.pk`? `pk` ist die Abkürzung für primary key (zu Deutsch: Primär-Schlüssel), ein eineindeutiges Identifikationsmerkmal zu jedem Eintrag in einer Datenbank. Jedes Django-Modell hat ein Feld, das als Primär-Schlüssel dient. Welchen Namen dieses Feld auch haben mag, es kann ebenfalls als "pk" referenziert werden. Da wir keinen Primär-Schlüssel in unserem `Post`-Modell angelegt haben, erstellt Django einen für uns (standardmäßig ist dies ein Feld namens "id", welches eine Zahl enthält, die mit jedem weiteren Eintrag nach oben gezählt wird, z.B. 1, 2, 3) und fügt ihn als Feld zu jedem unserer Posts hinzu. Wir greifen auf den Primär-Schlüssel zu, indem wir `post.pk` schreiben, genauso wie wir auf andere Felder (`title`, `author`, usw.) in unserem `Post`-Objekt zugreifen!
+
+Wenn wir jetzt http://127.0.0.1:8000/ aufrufen, erhalten wir einen Fehler (wie erwartet, da wir ja noch keine URL oder *View* für `post_detail` erstellt haben). Er wird so aussehen:
+
+![NoReverseMatch Error](images/no_reverse_match2.png)
+
+## Erstelle eine URL für die Post-Detailseite
+
+Lass uns eine URL in `urls.py` für unsere `post_detail`-*View* erstellen!
+
+Wir wollen, dass unsere erste Blogpost-Detailseite unter dieser **URL** angezeigt wird: http://127.0.0.1:8000/post/1/
+
+Lass uns eine URL in der Datei `blog/urls.py` anlegen, um Django auf die *View* `post_detail` zu verweisen, welche dann den ganzen Blogpost anzeigen wird. Öffne die Datei `blog/urls.py` im Code-Editor und füge die Zeile `path('post/<int:pk>/', views.post_detail, name='post_detail'),` hinzu, so dass die Datei wie folgt aussieht:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+Der Teil `post/<int:pk>/` definiert ein URL-Muster – wir erklären es dir:
+
+- `post/` heißt, dass die URL mit dem Wort **post** beginnen sollte, gefolgt von einem **/**. So weit, so gut.
+- `<int:pk>` – Dieser Teil ist schwieriger. Er bedeutet, dass Django eine Ganzzahl (einen Integer-Wert) erwartet und diese in Form einer Variablen namens `pk` einer View weitergibt.
+- `/` – dann brauchen wir vor dem Abschluss der URL wieder einen **/**.
+
+Wenn du also `http://127.0.0.1:8000/post/5/` in deinen Browser eingibst, wird Django verstehen, dass du nach einer *View* suchst, die `post_detail` heißt, und wird der *View* die Information weitergeben, dass `pk` dabei `5` sein soll.
+
+So, jetzt haben wir der `blog/urls.py` ein neues URL-Muster hinzugefügt! Lass uns die Seite http://127.0.0.1:8000/ neu laden - Bumm! Der Server läuft wieder nicht mehr. Schau in die Konsole - wie erwartet gibt es noch einen anderen Fehler!
+
+![AttributeError](images/attribute_error2.png)
+
+Erinnerst du dich, was der nächste Schritt ist? Eine View hinzufügen!
+
+## Füge eine View hinzu
+
+Dieses Mal bekommt unsere *View* den extra Parameter `pk`. Unsere *View* muss diesen entgegennehmen, richtig? Also definieren wir unsere Funktion als `def post_detail(request, pk)`. Beachte, dass der Parameter genau den gleichen Variablennamen haben muss, wie wir in `urls` festgelegt haben (`pk`). Beachte zudem, dass das Weglassen dieser Variable unzulässig ist und zu einem Fehler führt!
+
+Jetzt benötigen wir also genau einen bestimmten Blogpost. Diesen finden wir, indem wir ein QuerySet folgendermaßen schreiben:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Aber bei diesem Code gibt es ein Problem. Wenn es kein `Post`-Objekt mit diesem `primary key` (`pk`) gibt, bekommen wir einen super-hässlichen Fehler!
+
+![DoesNotExist Error](images/does_not_exist2.png)
+
+Das wollen wir nicht! Zum Glück stellt uns Django etwas zur Verfügung, das uns dieses Problem abnimmt: `get_object_or_404`. Wenn es kein `Post`-Objekt mit einem gegebenen `pk` gibt, wird eine schöne Seite angezeigt, die sogenannte `Page Not Found 404`-Seite ("Seite nicht gefunden"-Seite).
+
+![Page not found](images/404_2.png)
+
+Die gute Neuigkeit ist, dass du auch deine eigene `Page not found`-Seite erstellen und diese so hübsch gestalten kannst, wie du willst. Aber das ist jetzt gerade nicht so wichtig, deshalb überspringen wir das.
+
+Okay, es wird Zeit, die *View* zu unserer `views.py`-Datei hinzuzufügen!
+
+In `blog/urls.py` haben wir eine URL-Regel namens `post_detail` erstellt, die auf eine View namens `views.post_detail` verweist. Das heißt, dass Django eine View-Funktion erwartet, die `post_detail` heißt und in `blog/views.py` angelegt wurde.
+
+Wir sollten also `blog/views.py` im Code-Editor öffnen und den folgenden Code zu den anderen `from` Zeilen hinzufügen:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+Und am Ende der Datei werden wir unsere *View*-Funktion ergänzen:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Super. Lass uns nun http://127.0.0.1:8000/ neu laden.
+
+![Die post_list-View](images/post_list2.png)
+
+Es hat funktioniert! Aber was passiert, wenn du auf den Link im Blog-Titel klickst?
+
+![TemplateDoesNotExist Error](images/template_does_not_exist2.png)
+
+Oh nein! Ein anderer Fehler! Aber wir wissen ja schon, wie wir mit diesem umgehen, oder? Wir müssen ein Template hinzufügen!
+
+## Erstelle ein Template für die Post-Detailseite
+
+Wir erstellen eine Datei in `blog/templates/blog` mit dem Namen `post_detail.html` und öffnen sie im Code-Editor.
+
+Gib den folgenden Code ein:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Wir erweitern wieder `base.html`. Im `content`-Block wollen wir das Publikationsdatum eines Posts (published_date), falls es existiert, anzeigen und auch den Titel und den Text. Aber wir müssen noch ein paar wichtige Dinge klären, oder?
+
+{% raw %}`{% if ... %} ... {% endif %}` ist ein Template-Tag, das wir benutzen können, wenn wir etwas überprüfen möchten. (Erinnerst du dich an `if ... else ...` vom Kapitel **Einführung in Python**?) In diesem Fall hier wollen wir prüfen, ob das `published_date`-Feld eines Post-Objektes nicht leer ist. {% endraw %}
+
+OK, aktualisieren wir unsere Seite und sehen, ob `TemplateDoesNotExist` jetzt weg ist.
+
+![Blogpost-Detailseite](images/post_detail2.png)
+
+Yay! Es funktioniert!
+
+# Veröffentlichen!
+
+Es wäre schön zu sehen, ob deine Website noch auf PythonAnywhere funktioniert, richtig? Lass sie uns erneut veröffentlichen.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "View und Template für Blogpost-Details sowie CSS für die Website hinzugefügt"
+    $ git push
+    
+
+Dann führe Folgendes in der [PythonAnywhere-Bash-Konsole](https://www.pythonanywhere.com/consoles/) aus:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<deine-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Denk daran, `<deine-pythonanywhere-domain>` durch deine tatsächliche PythonAnywhere-Subdomain zu ersetzen - ohne die spitzen Klammern.)
+
+## Die statischen Dateien auf dem Server aktualisieren
+
+Server wie PythonAnywhere behandeln statische Dateien ("static files", z.B. CSS-Dateien) anders als Python-Dateien, weil statische Dateien noch optimiert und dadurch dann schneller geladen werden können. Deswegen müssen wir, nachdem wir Änderungen an den CSS Dateien vorgenommen haben, einen zusätzlichen Befehl auf dem Server ausführen, um diese Dateien zu aktualisieren. Der Befehl heißt `collectstatic`.
+
+Aktiviere also deine virtuelle Umgebung, wenn sie nicht vom letzten Mal noch aktiv ist (PythonAnywhere benutzt dazu das Kommando `workon`, das ist ähnlich wie `source myenv/bin/activate`, das du auf deinem Computer verwendest):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <deine-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+Der `manage.py collectstatic` Befehl ist ein bisschen wie `manage.py migrate`. Wir machen ein paar Änderungen in unserem Code und dann sagen wir Django, dass es diese übernehmen (*apply*) soll, entweder zu der servereigenen Sammlung von statischen Dateien oder in die Datenbank.
+
+Auf jeden Fall sind wir nun soweit, dass wir [auf die Seite "Web"](https://www.pythonanywhere.com/web_app_setup/) wechseln können (mittels dem Menü-Knopf in der Ecke oben rechts) und **Reload** klicken können. Schau dir dann die Seite https://subdomain.pythonanywhere.com an, um das Ergebnis zu sehen.
+
+Und das war's. Glückwunsch! :)
\ No newline at end of file
diff --git a/de-DE/how_the_internet_works/README.md b/de-DE/how_the_internet_works/README.md
new file mode 100644
index 00000000000..ab728a10ce6
--- /dev/null
+++ b/de-DE/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Wie das Internet funktioniert
+
+> Für die Leser zu Hause: Dieses Kapitel wird im Video [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) behandelt.
+> 
+> Dieses Kapitel wurde inspiriert durch den Vortrag "How the Internet works" von Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+Wahrscheinlich nutzt du das Internet jeden Tag. Aber weißt du, was passiert, wenn du eine Adresse wie https://djangogirls.org im Browser eingibst und `enter` drückst?
+
+Als Erstes solltest du wissen, dass eine Webseite meist nur ein paar Dateien auf der Festplatte sind -- so wie deine Filme, deine Musik oder deine Bilder. Das Besondere an Webseiten ist, dass sie aus speziellem Computer-Code bestehen, das sogenannte HTML.
+
+Wenn du noch nie etwas mit Programmierung zu tun hattest, kann auch HTML zuerst abschreckend aussehen, aber dein Browser (Chrome, Safari, Firefox, etc.) liebt es. Browser sind so entworfen, dass sie diesen Code verstehen, seinen Anweisungen folgen können und diese Dateien, aus denen deine Website besteht, genau so darstellen, wie du es möchtest.
+
+Wie jede andere Datei auch, muss die HTML-Datei irgendwo auf einer Festplatte gespeichert werden. Für das Internet verwenden wir spezielle, leistungsstarke Computer, sogenannte *Server*. An ihnen sind normalerweise weder Bildschirm, Maus oder Tastatur angeschlossen, weil der Hauptzweck der Server darin besteht, Daten zu speichern und zur Verfügung zu stellen. Darum nennt man sie *Server* - sie *bedienen* (serve) dich mit Daten.
+
+OK, aber du willst wissen, wie das Internet aussieht oder?
+
+Wir haben ein Bild gemalt. So sieht es aus:
+
+![Abbildung 1.1](images/internet_1.png)
+
+Ziemliches Durcheinander, oder? Eigentlich ist es ein Netzwerk aus verbundenen Maschinen (den oben genannten *Servern*). Hunderttausende von Rechnern! Kilometer über Kilometer Kabel rund um die Welt. Auf einer Webseite über Unterseekabel (https://submarinecablemap.com/) kannst du dir ein Bild von der Komplexität des Netzes machen. Hier ist ein Screenshot der Seite:
+
+![Abbildung 1.2](images/internet_3.png)
+
+Faszinierend, oder? Es ist jedoch nicht möglich, Kabel zwischen allen Servern des Internets zu schalten. Damit wir eine Maschine (z.B. diejenige, auf welcher https://djangogirls.org abgespeichert ist) erreichen können, muss unsere Anfrage über viele verschiedene andere Maschinen weitergeleitet werden.
+
+Das sieht ungefähr so aus:
+
+![Abbildung 1.3](images/internet_2.png)
+
+Stell dir vor, wenn du https://djangogirls.org in den Browser eingibst, würdest du einen Brief versenden, in dem steht; "Hallo Django Girls, ich möchte die djangogirls.org Webseite ansehen. Bitte schickt sie mir!"
+
+Der Brief kommt ins Postamt in deiner Nähe. Von da aus gelangt er zu einem anderen Postamt näher an der Zieladresse und näher und näher, bis der Brief zugestellt werden kann. Die einzigartige Sache ist, dass, wenn du mehrere Briefe (*Datenpakete*) zu der selben Adresse abschickst, jeder einzelne Brief durch komplett unterschiedliche Poststellen (*Router*) laufen könnte. Dies hängt davon ab, wie sie an jedem Standort verteilt werden.
+
+![Abbildung 1.4](images/internet_4.png)
+
+So einfach ist das im Prinzip. Du sendest Nachrichten und erwartest eine Antwort. Anstelle von Papier und Stift verwendest du Daten, aber die Idee ist dieselbe!
+
+Anstelle von Adressen mit Straße, Ort und Postleitzahl verwenden wir IP-Adressen. IP steht für Internet Protocol. Dein Computer fragt erst das DNS (Domain Name System), um die (von Menschen besser lesbare) Adresse djangogirls.org in die (besser von Maschinen lesbare) IP-Adresse umzuwandeln. Das DNS ist ein bisschen wie ein altmodisches Telefonbuch aus Papier, in dem du den Namen einer Person, die Du kontaktieren willst, suchen und die Telefonnummer und Adresse nachgucken kannst.
+
+Wenn du einen Brief versenden willst, brauchst du spezielle Eigenschaften wie: Postanschrift, Briefmarke etc. Außerdem musst du eine Sprache verwenden, die der Empfänger versteht. Das gleiche gilt für die *Datenpakete*, die du sendest, um eine Website betrachten zu können. Wir verwenden ein Protokoll namens HTTP (Hypertext Transfer Protocol).
+
+Grundsätzlich brauchst du also für eine Website auch einen *Server*, auf dem sie abgelegt ist. Wenn der *Server* eine eingehende *Anforderung* (in einem Brief) empfängt, sendet er deine Website zurück (in einem weiteren Brief).
+
+Da dies hier ein Django-Tutorial ist, fragst du dich vielleicht, was Django in diesem Zusammenhang macht. Wenn dein Server eine Antwort zurück sendet, soll nicht an jeden dasselbe gesendet werden. Es wäre besser, wenn die Antworten individuell personalisiert würden, entsprechend der Anfragen des jeweiligen Briefes, oder? Django hilft dir, diese personalisierten und interessanten Antworten zu erstellen. :)
+
+Genug der Theorie, lass uns loslegen!
\ No newline at end of file
diff --git a/de-DE/html/README.md b/de-DE/html/README.md
new file mode 100644
index 00000000000..6f6cbd62cbb
--- /dev/null
+++ b/de-DE/html/README.md
@@ -0,0 +1,227 @@
+# Einführung in HTML
+
+Vielleicht fragst du dich, was ein Template (Vorlage) ist?
+
+Ein Template (zu deutsch "Vorlage") ist eine Textdatei und ermöglicht es uns, verschiedene Inhalte in einer einheitlichen Darstellung zu erzeugen. Eine Vorlage für z.B. einen Brief hilft uns, immer gleich aussehende Nachrichten zu versenden, in denen sich Empfänger, Betreff und Text jeweils ändern, das äußere Format jedoch bestehen bleibt.
+
+Ein Django-Template wird mit einer Sprache namens HTML beschrieben. (Genau das HTML aus dem ersten Kapitel: **Wie das Internet funktioniert**).
+
+## Was ist HTML?
+
+HTML ist recht einfacher Code, der von deinem Browser – z.B. Chrome, Firefox oder Safari – interpretiert wird, um dem Benutzer eine Website darzustellen.
+
+HTML steht für "HyperText Markup Language". Als **HyperText** wird Text bezeichnet, der über markierte Textstellen, den "Hyperlinks" (die umgangssprachlichen "Links"), auf andere (meist ebenfalls in HTML geschriebene) Seiten verweist. **Markup** bedeutet, dass wir ein Dokument nehmen und mit Code versehen, um einem Empfänger mitzuteilen (in diesem Fall dem Browser), wie diese Seite interpretiert werden muss. HTML-Code besteht aus **Tags**, wovon jeder mit `<` beginnt und mit `>` endet. Diese Tags stellen die Markup-**Elemente** dar.
+
+## Dein erstes Template!
+
+Ein Template zu erstellen, heißt, eine entsprechende Datei dafür zu erstellen. Alles ist eine Datei, wie du vielleicht schon bemerkt hast.
+
+Templates werden im Verzeichnis `blog/templates/blog` gespeichert. Als Erstes erzeugen wir das Verzeichnis `templates` in deinem Blog-Verzeichnis. Im Template-Verzeichnis selbst erstellen wir ein weiteres Verzeichnis `blog`:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(Falls du dich wunderst, warum wir zwei `blog`-Verzeichnisse brauchen – das hängt mit den nützlichen Namenskonventionen von Django zusammen, die das Leben einfacher machen, wenn deine Projekte immer komplizierter und komplexer werden.)
+
+Als nächstes erstellen wir eine Datei `post_list.html` (erst mal ohne Inhalt) innerhalb des Verzeichnisses `blog/templates/blog`.
+
+Kontrolliere deine überarbeitete Webseite unter: http://127.0.0.1:8000
+
+> Falls du die Fehlermeldung `TemplateDoesNotExist` angezeigt bekommst, versuche den Server neu zu starten. Auf der Kommandozeile drückst du dafür Strg+C bzw. Ctrl+C (Strg-/Ctrl- und die C-Taste C zusammen) und startest danach den Server erneut mit dem Kommando `python manage.py runserver`.
+
+![Abbildung 11.1](images/step1.png)
+
+Der Fehler sollte weg sein! Gratulation! :) Deine Webseite ist allerdings noch leer, weil dein Template leer ist. Das müssen wir ändern.
+
+Öffne die neue Datei im Code-Editor, und füge Folgendes hinzu:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Halli-Hallo!</p>
+    <p>Es funktioniert!</p>
+</body>
+</html>
+```
+
+Hat sich die Seite geändert? Besuche http://127.0.0.1:8000/, um nachzusehen.
+
+![Abbildung 11.2](images/step3.png)
+
+Es funktioniert. Gute Arbeit! :)
+
+* Die Zeile `<!DOCTYPE html>` ist kein HTML-Tag. Es deklariert nur den Dokumententyp. Hier informiert sie den Browser, dass der Dokumententyp [HTML5](https://html.spec.whatwg.org/#the-doctype) ist. Jede HTML5-Datei muss so anfangen.
+* Der eigentliche HTML-Teil beginnt immer mit `<html>` und endet immer mit `</html>`. Zwischen den beiden Tags `<html>` und `</html>` steht der gesamte Inhalt der Webseite
+* `<p>` ist der Tag für ein Absatz-Element (paragraph), `</p>` beendet einen Absatz
+
+## "Head" und "body"
+
+Jede HTML-Seite gliedert sich in zwei Teile: **head** und **body**.
+
+* Das Element **head** speichert im "Kopf" der Seite Informationen über die Seite, die dir nicht angezeigt werden.
+
+* Das Element **body** enthält den "Körper" - also den dargestellten Inhalt der Seite.
+
+Im `<head>` informieren wir den Browser über Einstellungen und Konfigurationen der Webseite, z.B. wie sie dargestellt werden soll, und im `<body>` darüber, was tatsächlich dargestellt werden soll.
+
+In den `<head>` können wir z.B. noch den Titel (title) der Seite mit aufnehmen:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Olas blog</title>
+    </head>
+    <body>
+        <p>Halli-Hallo!</p>
+        <p>Es funktioniert!</p>
+    </body>
+</html>
+```
+
+Speichere die Datei und aktualisiere die Seite im Browser.
+
+![Abbildung 11.3](images/step4.png)
+
+Der Titel "Olas Blog" wird nun im Browser angezeigt. Hast du es bemerkt? Der Browser hat `<title>Olas Blog</title>` interpretiert und in die Titelleiste übernommen (dieser Titel wird auch in den Lesezeichen usw. verwendet).
+
+Wie du vielleicht bemerkt hast, hat jedes Element zu Beginn einen öffnenden Tag und einen zugehörigen *schließenden Tag* mit `/` und innerhalb davon sind Elemente *eingebettet*. Ein innerer Tag kann nicht außerhalb des umschließenden Tags geschlossen werden, die Reihenfolge muss immer stimmen.
+
+Es ist, wie wenn man Sachen in Kisten steckt. Du hast eine große Kiste, `<html></html>`. In der ist als weitere, etwas kleinere Kiste `<body></body>` drin, und in der wiederum weitere kleine Kistchen: `<p></p>`.
+
+Die Regeln und Reihenfolgen von *schließenden* Tags und *Verschachtelung* der Elemente musst du immer einhalten. Anderenfalls können Browser die Seite nicht richtig interpretieren und darstellen.
+
+## Dein Template anpassen
+
+Jetzt kannst du ein bisschen rumprobieren und dein Template umgestalten! Hier sind ein paar nützliche Tags dafür:
+
+* `<h1>Überschrift</h1>` (headline) für wichtigste Überschriften
+* `<h2>Unter-Überschrift</h2>` die nächst tiefere Überschiftenebene
+* `<h3>Unter-Unter-Überschrift</h3>` ... und so weiter bis `<h6>`
+* `<p>Ein Fliesstext-Absatz</p>`
+* `<em>Text</em>` hebt deinen Text hervor
+* `<strong>Text</strong>` hebt deinen Text stark hervor
+* `<br>` fängt eine neue Zeile an (du kannst nichts in das br schreiben und es gibt keinen schließenden Tag)
+* `<a href="https://djangogirls.org">link</a>` erstellt einen Link
+* `<ul><li>Erster Punkt</li><li>second item</li></ul>` generiert eine Liste so wie diese hier!
+* `<div></div>` definiert einen Abschnitt auf einer Seite
+* `<nav></nav>` definiert eine Reihe von Navigationslinks
+* `<article></article>` definiert voneinander unabhängige, eigenständige Inhalts-Teile
+* `<section></section>` definiert einen Abschnitt in einem Dokument
+* `<header></header>` gibt eine Kopfzeile für ein Dokument oder einen Abschnitt an
+* `<main></main>` enthält den Hauptinhalt eines Dokuments
+* `<aside></aside>` definiert eine Nebenbemerkung (wie den Inhalt einer Rand-Leiste) zum Inhaltsteil, in dem es platziert wird
+* `<footer></footer>` definiert eine Fußzeile für ein Dokument oder einen Abschnitt
+* `<time></time>` definiert eine bestimmte Zeit (oder einen Zeitpunkt samt Datum)
+
+Hier ist ein vollständiges Beispiel eines Templates. Kopiere es und füge es in `blog/templates/blog/post_list.html` ein:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+Wir haben hier einen `header`-Abschnitt und zwei `article`-Abschnitte erstellt.
+
+* Das `header`-Element enthält den Titel unseres Blogs – eine Überschrift und einen Link
+* Die beiden `Artikel` Elemente enthalten unsere Blogeinträge mit einem veröffentlichten Datum in einem `time` Element, ein `h2` Element mit einem anklickbaren Beitragstitel und einem `p` (Absatz) Element für den Text unseres Blogeintrags.
+
+Wir bekommen das Folgende:
+
+![Abbildung 11.4](images/step6.png)
+
+Yaaay! Bis jetzt zeigt unser Template aber immer genau die **gleichen Inhalte** – obwohl wir aber vorhin davon gesprochen haben, dass Templates uns erlauben, **verschiedene** Informationen im **gleichen Format** darzustellen.
+
+Eigentlich wollen wir richtige Posts anzeigen, die in unserer Django-Admin-Oberfläche hinzugefügt wurden – und das wollen wir als Nächstes tun.
+
+## Noch eine Sache: Deployment!
+
+Es wäre gut, das alles live draußen im Internet zu sehen, oder? Lass uns noch eine PythonAnywhere-Anwendung erstellen:
+
+### Committe und pushe deinen Code auf GitHub
+
+Lass uns nachsehen, welche Dateien sich nach dem letzten Veröffentlichen (Deployment) geändert haben. (Führe diese Befehle lokal aus und nicht auf PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Stelle sicher, dass du im `Djangogirls` Verzeichnis bist und sag `git`, dass alle Änderungen in diesem Verzeichnis hinzugefügt werden sollen:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Bevor wir alle Dateien hochladen, prüfen wir noch einmal, was `git` hochladen will (alle Dateien, die `git` hochladen wird, sind jetzt grün):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Fast fertig, wir sagen nun noch, dass diese Änderung in der Verlaufsübersicht gespeichert werden soll. Wir erstellen eine "Commit Message", die beschreibt, was wir verändert haben. Du kannst an diesem Punkt hier alles reinschreiben, aber es ist sehr nützlich, etwas Sinnvolles einzutragen, damit du dich in Zukunft erinnern kannst, was du geändert hast.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "HTML der Site geändert."
+    
+
+> **Beachte:** Du musst Anführungszeichen um den Commit-Kommentar setzen.
+
+Nachdem wir das gemacht haben, laden (push) wir unsere Änderungen auf GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Hol dir den neuen Code auf PythonAnywhere und aktualisiere deinen Browser
+
+* Öffne die [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) und gehe zu deiner **Bash-Konsole** (oder starte eine neue). Dann, führe Folgendes aus:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<deine-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+Du musst `<deine-pythonanywhere-domain>` durch deine tatsächliche PythonAnywhere-Subdomain zu ersetzen - ohne die spitzen Klammern. Normalerweise ist deine Subdomain dein PythonAnywhere-Benutzername, aber in manchen Fällen ist sie leicht anders (z.B. wenn dein Benutzername Großbuchstaben enthält). Wenn dieser Befehl also nicht funktioniert, verwende den Befehl `ls` (listet Dateien auf), um den tatsächlichen Subdomain-/Ordner-Name herauszufinden, und verwende dann `cd`, um dorthin zu wechseln.
+
+Nun sieh zu, wie dein Code heruntergeladen wird. Wenn du überprüfen willst, dass er angekommen ist, geh' hinüber zur **Seite "Files"** and schau deinen Code auf PythonAnywhere an (du kannst andere PythonAnywhere-Seiten über den Menü-Knopf auf der Konsolen-Seite erreichen).
+
+* Spring anschließend rüber zur [Seite "Web"](https://www.pythonanywhere.com/web_app_setup/) und klick auf **Neu laden** in deinem Browser.
+
+Dein Update sollte live sein! Lade die Seite neu in deinem Browser. Es sollten nun Änderungen zu sehen sein. :)
\ No newline at end of file
diff --git a/de-DE/installation/README.md b/de-DE/installation/README.md
new file mode 100644
index 00000000000..ed709da2433
--- /dev/null
+++ b/de-DE/installation/README.md
@@ -0,0 +1,68 @@
+# Wenn du dieses Tutorial zu Hause bearbeitest
+
+Wenn du das Tutorial zu Hause bearbeitest, und nicht auf einer der [Django Girls Veranstaltungen](https://djangogirls.org/events/), kannst du dieses Kapitel komplett überspringen und direkt mit dem Kapitel [Wie funktioniert das Internet?](../how_the_internet_works/README.md) fortfahren.
+
+Dem ist so, weil wir die Dinge jeweils installieren werden, wenn sie im Tutorial benötigt werden. Das hier ist nur eine zusätzliche Seite, die alle Installationsanleitungen an einem Ort bündelt (was für manche Veranstaltungsformate nützlich ist). Falls du willst, kannst du alles auf dieser Seite bereits jetzt installieren. Wenn du jedoch mit dem Lernen beginnen willst, bevor du eine Hand voll Sachen auf deinem Computer installierst, überspringe dieses Kapitel und lies unsere Erklärungen zur Installation später im Tutorial.
+
+Viel Erfolg!
+
+# Wenn du an einem Workshop teilnimmst
+
+Wenn du an einer [Django Girls Veranstaltung](https://djangogirls.org/events/) teilnimmst:
+
+* Vielleicht hat deine Veranstaltung eine "Installationsparty" vor dem eigentlichen Workshoptag. Wenn du gerade auf einer Installationsparty bist, ist das deine Seite! Folge den Anweisungen hier, um alles Notwendige für den Workshop zu installieren. Frage deinen Coach, wenn du Hilfe brauchst. Am Workshoptag kannst du dann die Installationsanweisungen überspringen, auf die du im Tutorial stößt.
+* Vielleicht haben die Organisatoren des Workshops dich gebeten, zu versuchen, schon zu Hause möglichst alles Benötigte auf deinem Computer zu installieren. Wenn du dazu aufgefordert wurdest, dann bist du hier auf der richtigen Seite! Folge den Anweisungen hier so gut, wie du kannst. Wenn du am Workshoptag dann im Tutorial auf einen Installationsschritt triffst, der dir zu Hause nicht gelungen ist, frage deinen Coach um Hilfe.
+* Wenn dein Workshop keine Installationsparty hat (oder du nicht teilnehmen konntest) und die Organisatorien dich nicht gebeten haben, alles zu Hause zu installieren, dann überspring die Seite und geh direkt zum Kapitel [Wie das Internet funktioniert](../how_the_internet_works/README.md). Denn du wirst dann alles installieren, während du das Tutorial durcharbeitest.
+
+# Installation
+
+In diesem Tutorial wirst du einen Blog bauen. Dafür wirst du während des Tutorials aufgefordert, verschiedene Software auf deinem Computer zu installieren und auch einige Online-Konten anzulegen, wenn sie gebraucht werden. Diese Seite fasst alle Installations- und Kontoeinrichtungs-Anweisungen an einer Stelle zusammen (das ist für einige Workshopformate sinnvoll).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Kurze Einführung in die Kommandozeile {#command-line}
+
+Viele der folgenden Schritte beziehen sich auf die "Konsole", das "Terminal", das "Kommandozeilen-Fenster" oder die "Kommandozeile" -- all diese Begriffe bezeichnen dasselbe: Ein Fenster auf deinem Computer, in das du Kommandos eingeben kannst. Im Hauptteil des Tutorials wirst du mehr über die Kommandozeile lernen. Vorerst musst du nur wissen, wie du ein Kommandozeilenfester öffnen kannst und wie eines aussieht: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Python installieren {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Einen Code-Editor installieren {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Virtualenv einrichten und Django installieren {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Git installieren {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Einen GitHub-Account erstellen {#github-account}
+
+Gehe zu [GitHub.com](https://www.github.com) und registriere dich für ein neues, kostenfreies Benutzerkonto. Achte darauf, dass du dein Passwort nicht vergisst (füge es deinem Passwortmanager hinzu, wenn du einen benutzt).
+
+# Einen PythonAnywhere-Account erstellen {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Fang an zu lesen!
+
+Herzlichen Glückwunsch, du hast alles eingerichtet und bist nun bereit loszulegen! Wenn du vor dem Workshop noch etwas Zeit hast, wäre es hilfreich, einige der einführenden Kapitel zu lesen:
+
+* [Wie das Internet funktioniert](../how_the_internet_works/README.md)
+
+* [Einführung in die Kommandozeile](../intro_to_command_line/README.md)
+
+* [Einführung in Python](../python_introduction/README.md)
+
+* [Django - Was ist das?](../django/README.md)
+
+# Viel Spaß beim Workshop!
+
+Wenn du mit dem Workshop anfängst, kannst du direkt zum Kapitel [Dein erstes Django-Projekt!](../django_start_project/README.md) gehen, weil du den Inhalt der vorhergehenden Kapitel schon bearbeitet hast.
\ No newline at end of file
diff --git a/de-DE/intro_to_command_line/README.md b/de-DE/intro_to_command_line/README.md
new file mode 100644
index 00000000000..08b504e69bc
--- /dev/null
+++ b/de-DE/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Einführung in die Kommandozeile
+
+> Für die Leser zu Hause: Dieses Kapitel wird im Video [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) behandelt.
+
+Aufregend, oder?! In ein paar Minuten wirst du deine erste Zeile Code schreiben! :)
+
+**Erstmal stellen wir dir deine neue Freundin vor: Die Konsole!**
+
+Im Folgenden zeigen wir dir, wie du das schwarze Fenster benutzt, das alle Hackerinnen nutzen. Es sieht vielleicht erstmal etwas unheimlich aus, aber es ist nur ein Programm, das darauf wartet, Anweisungen von dir zu bekommen.
+
+> **Hinweis:** Bitte beachte, dass wir in dem gesamten Buch die Begriffe "Verzeichnis" und "Ordner" abwechselnd gebrauchen, aber sie stehen für ein und dasselbe.
+
+## Was ist die Konsole?
+
+Das Fenster, welches gewöhnlich die **Kommandokonsole** (command line) oder **Kommandozeilen-Interface** (command-line interface) genannt wird, ist eine textbasierte Applikation zum Betrachten, Bearbeiten und Manipulieren von Dateien auf deinem Computer. Es ist dem Windows Explorer oder Finder auf dem Mac ähnlich, aber ohne die grafische Benutzeroberfläche. Andere Bezeichnungen dafür sind: *CMD*, *CLI*, *Prompt (Eingabeaufforderung)*, *Konsole* oder *Terminal*.
+
+## Öffnen der Konsole
+
+Um mit unserem Tutorial zu starten, musst du als Erstes das Kommandozeilenprogramm starten.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Eingabeaufforderung (Prompt)
+
+Du solltest nun ein weißes oder schwarzes Fenster sehen, das auf deine Anweisungen wartet.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Auf einem Mac- oder Linux-Rechner siehst du wahrscheinlich ein `$`, also so:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Auf einem Windows-Rechner siehst du wahrscheinlich ein `>`, so hier:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Schau 'mal in den Linux-Abschnitt hier obendrüber -- so etwas wirst du wieder im Abschnitt PythonAnywhere später im Tutorial antreffen.
+
+<!--endsec-->
+
+Vor jedem Kommando wird das Zeichen `$` oder `>` und ein Leerzeichen vorangestellt, aber du musst das nicht hinschreiben. Dein Computer macht das für dich. :)
+
+> Ein kleiner Hinweis: Falls du etwas in der Art wie `C:\Users\ola>` oder `Olas-MacBook-Air:~ ola$` sehen solltest, ist das auch 100%ig korrekt.
+
+Der Teil bis und einschließlich `$` oder `>` heißt *Kommandozeilen-Eingabeaufforderung* oder kurz *Eingabeaufforderung*. Sie fordert dich auf, hier etwas einzugeben.
+
+Wenn wir im Tutorial wollen, dass du einen Befehl eingibst, schreiben wir `$` oder `>` mit hin, gelegentlich auch noch die anderen Angaben links davon. Ignoriere den linken Teil und gib nur das Kommando ein, welches rechts der Eingabeaufforderung steht.
+
+## Dein erstes Kommando (YAY!)
+
+Lass uns mit diesem Kommando beginnen:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+Und dann bestätige mit `Enter`. Das ist unser Ergebnis:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+Wie du sehen kannst, hat der Computer gerade deinen Benutzernamen ausgegeben. Toll, was? :)
+
+> Versuch, jeden Befehl abzuschreiben und nicht zu kopieren und einzufügen. Auf diese Weise wirst du dir mehr merken!
+
+## Grundlagen
+
+Jedes Betriebssystem hat einen geringfügig anderen Bestand an Befehlen für die Kommandozeile, beachte daher die Anweisungen für dein Betriebssystem. Lass uns das ausprobieren.
+
+### Aktuelles Verzeichnis
+
+Es wäre schön zu sehen, wo wir uns befinden, oder? Lass uns nachsehen. Gib diesen Befehl in die Konsole ein und bestätige ihn mit `Enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Hinweis: 'pwd' steht für 'print working directory' (zeige derzeitiges Arbeitsverzeichnis).
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Hinweis: "cd" steht für "change directory". Mit PowerShell kannst du auch 'pwd' verwenden, wie auf Linux oder Mac OS X.
+
+<!--endsec-->
+
+Du wirst wahrscheinlich etwas Ähnliches auf deinem Gerät sehen. Wenn du die Konsole öffnest, befindest du dich normalerweise im Heimverzeichnis deines Benutzers.
+
+* * *
+
+### Mehr über ein Kommando lernen
+
+Viele Befehle, die du in der Kommandozeile nutzen kannst, haben eine eingebaute Hilfe, die du anzeigen und lesen kannst! Zum Beispiel kannst du etwas über den eben verwendeten Befehl lernen:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X und Linux haben einen `man`-Befehl, mit dem du die Hilfe über die Kommandos aufrufen kannst. Gib `man pwd` ein und schau, was angezeigt wird oder setzte `man` vor andere Kommandos und sieh dir deren Hilfe an. Das Ergebnis von `man` wird in der Regel seitenweise ausgegeben. Du kannst die Leertaste benutzen, um auf die nächste Seite zu gelangen und `q` (für engl. "quit", was "verlassen"/"rausgehen" heisst), um die Hilfeseiten zu schließen.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Wenn du Windows benutzt, dann wird dir der Suffix `/?` für die meisten Kommandos die Hilfeseite ausgeben. Gegebenenfalls musst du nach oben scrollen, um alles zu sehen. Versuch es mal mit `cd /?`.
+
+<!--endsec-->
+
+### Anzeigen von Dateien und Unterordnern
+
+Nun, was befindet sich in deinem Verzeichnis? Es wäre toll, das herauszufinden. Lass uns mal schauen:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Anwendungen
+    Desktop
+    Downloads
+    Musik
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Hinweis: PowerShell kannst du auch 'ls' verwenden, wie auf Linux oder Mac OS X.<!--endsec-->
+
+* * *
+
+### Wechseln des Verzeichnisses
+
+Lass uns jetzt zu unserem Desktop-Verzeichnis wechseln:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Wenn dein Linux-Benutzerkonto auf Deutsch eingestellt ist, kann es sein, dass auch der Name des Desktop-Verzeichnisses übersetzt ist. Wenn dem so ist, musst du im obigen Befehl `Desktop` durch den übersetzten Verzeichnisnamen `Schreibtisch` ersetzen.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Schau, ob das Wechseln des Verzeichnisses funktioniert hat:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Passt!
+
+> Profi-Tipp: Wenn du `cd D` tippst und dann `tab` auf deiner Tastatur drückst, wird die Kommandozeile automatisch den Rest des Namens vervollständigen, wodurch du schneller navigieren kannst. Wenn es mehr als einen Ordner gibt, dessen Name mit "D" beginnt, drücke die `tab`-Taste zweimal, um eine Liste der Möglichkeiten anzuzeigen.
+
+* * *
+
+### Erstellen eines Verzeichnisses
+
+Wie wär's damit, ein Übungsverzeichnis auf deinem Desktop zu erstellen? So kannst du das tun:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+Dieser kleine Befehl erstellt einen Ordner mit dem Namen `practice` auf deinem Desktop. Du kannst nun überprüfen, ob er wirklich dort ist, indem du auf deinem Desktop nachschaust oder indem du den Befehl `ls` oder `dir` ausführst! Versuch es. :)
+
+> Profi-Tipp: Wenn du die selben Befehle nicht immer wieder und wieder schreiben willst, verwende die `Pfeil aufwärts`- und `Pfeil abwärts`-Tasten deiner Tastatur, um durch die zuletzt verwendeten Befehle zu blättern.
+
+* * *
+
+### Übung!
+
+Eine kleine Herausforderung für dich: Erstelle in deinem neu erstellten `practice`-Ordner ein Verzeichnis namens `test`. (Verwende dazu die Kommandos `cd` und `mkdir`.)
+
+#### Lösung:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Glückwunsch! :)
+
+* * *
+
+### Aufräumen
+
+Wir wollen kein Chaos hinterlassen, also lass uns das bislang Geschaffene wieder löschen.
+
+Zuerst müssen wir zurück zum Desktop wechseln:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Durch Verwendung von `..` mit dem `cd`-Kommando wechselst du von deinem aktuellen Verzeichnis zum übergeordneten Verzeichnis (dies ist das Verzeichnis, das das aktuelle Verzeichnis enthält).
+
+Schau nach, wo du gerade bist:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Jetzt ist es an der Zeit, dein `practice`-Verzeichnis zu löschen:
+
+> **Achtung**: Wenn du Daten mit `del`, `rmdir` oder `rm` löschst, kannst du das nicht mehr rückgängig machen, das bedeutet, *die gelöschten Dateien sind für immer weg*! Sei also sehr vorsichtig mit diesem Befehl.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Geschafft! Lass uns schauen, ob es wirklich gelöscht ist:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Beenden
+
+Das wärs fürs Erste. Du kannst nun beruhigt deine Konsole schließen. Lass es uns wie die Hacker machen, okay? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, was? :)
+
+## Zusammenfassung
+
+Hier ist eine Zusammenfassung einiger nützlicher Kommandos:
+
+| Befehl (Windows) | Befehl (Mac OS / Linux) | Beschreibung                    | Beispiel                                             |
+| ---------------- | ----------------------- | ------------------------------- | ---------------------------------------------------- |
+| exit             | exit                    | Fenster schließen               | **exit**                                             |
+| cd               | cd                      | Verzeichnis wechseln            | **cd test**                                          |
+| cd               | pwd                     | aktuelles Verzeichnis anzeigen  | **cd** (Windows) oder **pwd** (Mac OS / Linux)       |
+| dir              | ls                      | Unterordner/Dateien zeigen      | **dir**                                              |
+| copy             | cp                      | Datei kopieren                  | **copy c:\test\test.txt c:\windows\test.txt**    |
+| move             | mv                      | Datei verschieben               | **move c:\test\test.txt c:\windows\test.txt**    |
+| mkdir            | mkdir                   | neues Verzeichnis erstellen     | **mkdir testdirectory**                              |
+| rmdir (oder del) | rm                      | Datei löschen                   | **del c:\test\test.txt**                           |
+| rmdir /S         | rm -r                   | Verzeichnis löschen             | **rm -r testdirectory**                              |
+| [CMD] /?         | man [CMD]               | Hilfe für ein Kommando aufrufen | **cd /?** (Windows) oder **man cd** (Mac OS / Linux) |
+
+Das sind nur sehr wenige der Befehle, welche du in deiner Konsole verwenden kannst, aber du wirst heute nicht mehr brauchen.
+
+Falls du neugierig bist, findest du auf [ss64.com](http://ss64.com) eine vollständige Übersicht über alle Kommandozeilen-Befehle für alle Betriebssysteme.
+
+## Fertig?
+
+Lass uns mit Python anfangen!
\ No newline at end of file
diff --git a/de-DE/intro_to_command_line/open_instructions.md b/de-DE/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..26e86572959
--- /dev/null
+++ b/de-DE/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Abhängig von deiner Windows-Version und deiner Tastatur sollte eine der folgenden Methoden ein Kommandozeilen-Fenster öffnen (du musst vielleicht etwas herumexperimentieren, aber du musst nicht jeden dieser Vorschläge ausprobieren):
+
+- Gehe zum Start-Menü oder Start-Bildschirm und gib "Eingabeaufforderung" in das Suchfeld ein.
+- Klicke Start-Menü → Windows System → Eingabeaufforderung.
+- Geh ins Start Menü → Alle Programme → Zubehör → Eingabeaufforderung.
+- Gehe zum Startbildschirm, bewege deinen Mauszeiger zur unteren linken Bildschirmecke und klicke auf den nach unten zeigenden Pfeil, der erschienen ist (auf einem Touch-Screen streichst du mit dem Finger vom unteren Bildschirmrand nach oben). Die Apps-Seite sollte sich öffnen. Klicke auf Eingabeaufforderung im Abschnitt Windows System.
+- Drücke die Windows-Taste und gleichzeitig "x" auf deiner Tastatur. Wähle "Eingabeaufforderung" aus dem Menü aus.
+- Drücke die Windows-Taste und gleichzeitig "r", um das "Ausführen"-Fenster zu erhalten. Tippe "cmd" in das Feld und klicke OK.
+
+![Tippe "cmd" in das "Ausführen"-Fenster](../python_installation/images/windows-plus-r.png)
+
+Später im Tutorial wirst du zwei offene Kommandozeilen-Fenster gleichzeitig brauchen. Wenn du aber schon ein Kommandozeilen-Fenster offen hast, wirst du bei manchen Windows-Versionen einfach zu diesem geschickt, wenn du mit derselben Methode versuchst, ein zweites Fenster zu öffnen. Probiere das nun aus und achte darauf, was passiert! Wenn du nur ein Kommandozeilen-Fenster bekommst, versuche eine der anderen Methoden aus der Liste oben. Mindestens eine der Methoden sollte dazu führen, dass ein neues (zweites) Kommandozeilen-Fenster geöffnet wird.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Öffne das Launchpad → Andere → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Wahrscheinlich ist es unter Programme → Zubehör → Terminal, aber das ist von deinem System abhängig. Wenn es nicht da ist, kannst du versuchen, danach zu googlen. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/de-DE/python_installation/README.md b/de-DE/python_installation/README.md
new file mode 100644
index 00000000000..6ed46093a8a
--- /dev/null
+++ b/de-DE/python_installation/README.md
@@ -0,0 +1,15 @@
+# Lass uns mit Python anfangen
+
+Wir sind endlich da!
+
+Aber lass uns zuerst erklären, was Python ist. Python ist eine sehr beliebte Programmiersprache, die du zur Erstellung von Webseiten, Spielen, wissenschaftlichen Programmen, Computergrafiken und vielem, vielem mehr verwenden kannst.
+
+Python entstand in den späten 1980ern mit dem Hauptziel, von Menschen lesbar zu sein (nicht nur von Computern). Darum sieht es einfacher aus als andere Programmiersprachen. Aber keine Sorge - Python ist auch sehr mächtig!
+
+# Python-Installation
+
+> **Hinweis** Wenn du ein Chromebook verwendest, überspringe bitte dieses Kapitel und folge den Anweisungen im Kapitel [Chromebook Installation](../chromebook_setup/README.md).
+> 
+> **Hinweis:** Falls du dich bereits durch die [Installationsschritte](../installation/README.md) gearbeitet hast, gibt es keinen Grund dies erneut zu tun – du kannst direkt zum nächsten Kapitel springen!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/de-DE/python_installation/instructions.md b/de-DE/python_installation/instructions.md
new file mode 100644
index 00000000000..c27dcfb7ff7
--- /dev/null
+++ b/de-DE/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Für Leserinnen zuhause: Dieses Kapitel wird auch im Video [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) behandelt.
+> 
+> Dieses Kapital basiert auf einem Tutorial der Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Django ist in Python geschrieben. Wir brauchen Python für alles in Django. Fangen wir mit der Installation an! Wir möchten, dass du Python 3 installierst. Solltest du also bereits eine ältere Version installiert haben, musst du diese aktualisieren. Wenn du schon Version {{ book.py_min_version }} oder höher hast, ist das in Ordnung.
+
+Bitte installiere ein gewöhnliches Python wie folgt, selbst falls auf deinem Computer bereits Anaconda installiert ist.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Bitte schau zuerst auf der "Systemtyp"-Zeile der Systeminformationsseite nach, ob auf deinem Computer eine 32-Bit-Version oder eine 64-Bit-Version von Windows läuft. Um diese Seite zu finden, versuche eine der folgenden Methoden:
+
+* Drücke die Windows-Taste und die Pause/Break-Taste zur selben Zeit
+* Öffne dein Control Panel über das Windows Menü und navigiere dann zu System & Sicherheit, dann System
+* Drücke die Windows-Taste und navigiere dann zu Einstellungen > System > Über
+* Suche im Windows-Startmenü nach "Systeminformationen". Klicke dazu auf Start oder drücke die Windows-Taste, dann beginne `Systeminformationen` zu tippen. Sobald du etwas eingegeben hast, bekommst du passende Vorschläge. Wähle den Eintrag "Systeminformationen" an, sobald er erscheint.
+
+Du kannst Python für Windows von der Webseite https://www.python.org/downloads/windows/ herunterladen. Klicke auf den "Latest Python 3 Release - Python x.x.x" Link. Wenn du eine **64-bit**-Version von Windows benutzt, lade die Datei **Windows x86-64 executable installer** herunter. Andernfalls lade den **Windows x86 executable installer** herunter. Führe den Installer nach dem Download (per Doppelklick) aus und folge den Anweisungen des Installationsprogramms.
+
+Auf eine Sache solltest du achten: Während der Installation wird ein Setup-Fenster auftauchen. Stell sicher, dass du die Checkbox mit "Add Python {{ book.py_version }} to PATH" oder "Add Python to your environment variables" aktiviert hast und klicke dann auf "Install Now" wie hier gezeigt (es kann bei dir etwas anders aussehen, wenn du eine andere Version installierst):
+
+![Vergiss nicht, Python zum Pfad hinzuzufügen](../python_installation/images/python-installation-options.png)
+
+Wenn die Installation abgeschlossen ist, siehst du vielleicht ein Dialogfeld mit einem Link, wo du mehr über Python oder über die Version lernen kannst. Schließe es oder brich den Dialog ab -- du wirst darüber mehr in diesem Tutorial lernen!
+
+Hinweis: Falls du eine ältere Version von Windows verwendest (7, Vista oder älter) und die Installation von Python {{ book.py_version }} mit einer Fehlermeldung fehlschlägt, dann installiere alle Windows-Updates und versuche erneut, Python zu installieren. Falls der Fehler dann immer noch auftritt, installiere Python-Version {{ book.py_min_release }} von [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} benötigt Python {{ book.py_min_version }} oder höher, das weder Windows XP noch frühere Windows-Versionen unterstützt.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Hinweis** Bevor du Python auf Mac OS X installierst, musst du sicherstellen, dass deine Mac-Einstellungen es erlauben, Pakete zu installieren, die nicht aus dem App Store stammen. Geh auf Systemeinstellungen (im Ordner "Programme"), klicke auf "Sicherheit", und dann auf die Registerkarte "Allgemein". Wenn "Apps-Download erlauben von:" auf "Mac App Store" gestellt ist, ändere die Einstellung auf "Mac App Store und verifizierte Entwickler".
+
+Auf der Website https://www.python.org/downloads/mac-osx/ findest du aktuellen Python-Installer:
+
+* Lade die Datei *Mac OS X 64-bit/32-bit installer* herunter,
+* Doppelklicke auf *python-{{ book.py_release }}-macosx10.9.pkg*, um die Installation zu starten.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Es ist ziemlich wahrscheinlich, dass du Python schon automatisch installiert hast. Um herauszufinden, ob das so ist (und wenn ja, welche Version du hast), öffne eine Konsole und gib das folgende Kommando ein:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+Wenn du eine andere Version von Python installiert hast, die {{ book.py_min_version }} oder höher ist, z.B. {{ book.py_min_release }}, dann musst du die Version nicht aktualisieren. Wenn du Python noch nicht installiert hast oder wenn du eine andere Python-Version willst, prüfe zuerst mit folgendem Befehl, welche Linux-Distribution du benutzt:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Folge danach je nach Ergebnis einer der unterhalb dieses Abschnitts folgenden Installationsanweisungen.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Gib diesen Befehl in die Konsole ein:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Gib diesen Befehl in die Konsole ein:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+Auf älteren Fedora-Versionen kann es sein, dass du eine Fehlermeldung bekommst, dass das Kommando `dnf` nicht gefunden wird. Falls das passiert, musst du stattdessen `yum` verwenden.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Gib diesen Befehl in die Konsole ein:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Prüfe, ob die Installation erfolgreich war, indem du ein Kommandozeilenfenster öffnest und den `python3`-Befehl ausführst:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+Die angezeigte Version kann bei dir eine andere sein als {{ book.py_release }} -- sie sollte aber der entsprechen, die du installiert hast.
+
+**Hinweis:** Wenn du unter Windows eine Fehlermeldung bekommst, dass `python3` nicht gefunden wurde, versuche es mit `python` (ohne die `3`) und prüfe, ob es dennoch eine Version von Python {{ book.py_min_version }} oder höher ist. Wenn auch das nicht funktioniert, kannst du ein neues Kommandozeilenfenster öffnen und es dort erneut versuchen; dies geschieht, wenn du ein Kommandozeilenfenster verwendet, das schon vor der Python-Installation geöffnet war.
+
+* * *
+
+Wenn es Unklarheiten gibt oder wenn etwas schief ging und du nicht weiter weißt, frage bitte deinen Coach! Manchmal laufen die Dinge einfach nicht so glatt und dann ist es besser, jemanden mit mehr Erfahrung um Hilfe zu bitten.
\ No newline at end of file
diff --git a/de-DE/python_introduction/README.md b/de-DE/python_introduction/README.md
new file mode 100644
index 00000000000..45fae0bbc8d
--- /dev/null
+++ b/de-DE/python_introduction/README.md
@@ -0,0 +1,1071 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Einführung in Python
+
+> Ein Teil dieses Kapitels basiert auf dem Tutorial der Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Fangen wir an, schreiben wir Code!
+
+## Der Python-Prompt
+
+> Für Leserinnen, die sich bereits mit Python auskennen: Dieser Teil befindet sich im [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) Video.
+
+Um Python zu starten, musst du an die *Kommandozeile* deines Computers. Wie das geht, weißt du bereits - denn du hast es im Kapitel [Einführung in die Kommandozeile](../intro_to_command_line/README.md) gelernt.
+
+Also öffne die Konsole, dann fangen wir an.
+
+Wir wollen eine Python Konsole öffnen, also tippe unter Windows `python` oder im Mac OS/Linux Terminal `python3` und drücke `Enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Dein erster Python-Befehl!
+
+Nach Eingabe von python3 in der Konsole ändert sich das Prompt-Zeichen zu `>>>`. Für uns bedeutet das, dass wir ab nun nur noch Python-Code eingeben können. Den Python-Prompt `>>>` musst du nicht jedesmal eingeben - dies macht Python für dich.
+
+Wenn du die Python-Konsole wieder verlassen möchtest, gib `exit()` ein oder nutze das Tastatur-Kürzel `Strg + Z` unter Windows bzw. `Strg + D`, wenn du einen Mac hast oder Linux verwendest. Dann bist du wieder in der normalen Konsole und der Python-Prompt `>>>` ist weg.
+
+Fürs Erste bleiben wir in der Python Konsole, wir wollen mehr darüber lernen. Lass uns mit ein wenig Mathematik anfangen, gib `2 + 3` ein und drück `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3 
+5
+```
+
+Cool! Schon ist das Ergebnis da. Python kann rechnen! Probier einfach einige andere Befehle aus, wie z.B.: 
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Um Potenzen zu berechnen, sagen wir 2 hoch 3, müssen wir Folgendes eingeben: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Spiel ein wenig herum, dann machen wir weiter. :)
+
+Wie du siehst, kann Python richtig toll rechnen. Aber Python kann noch viel mehr ...
+
+## Strings
+
+Strings sind Zeichenketten. Das ist eine Folge von Buchstaben, die von Anführungszeichen umgeben sind. Gib einfach mal deinen Namen ein (bei mir "Ola"):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+Nun hast du deinen ersten String erzeugt! Dies ist eine Folge von Zeichen (also nicht nur Buchstaben, wie ich oben schrieb, sondern Zeichen aller Art), die von einem Computer verarbeitet werden können. Ein String muss stets mit dem gleichen Zeichen beginnen und enden. Dies kann entweder ein einzelnes Gänsefüßchen sein (`'`) oder ein doppeltes (`"`), da gibt es keinen Unterschied! Die Anführungszeichen zeigen Python nur an, dass alles dazwischen ein String ist.
+
+Strings können zusammengesetzt werden. Versuch es einmal:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+Du kannst Strings auch vervielfältigen:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Brauchst du einen Apostroph in einem String, so hast du zwei Möglichkeiten.
+
+Du kannst für den String doppelte Anführungszeichen verwenden:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+oder du kannst den Apostroph mit einem Backslash (``) markieren:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Toll, was? Um deinen Namen in Großbuchstaben anzuzeigen, gib Folgendes ein:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Hier hast du die `upper`-**Methode** auf den String angewendet! Eine Methode (wie `upper()`) ist eine Abfolge von Anweisungen, die Python für ein gegebenes Objekt (hier `"Ola"`) ausführt, wenn sie aufgerufen wird.
+
+Nehmen wir an, du möchtest die Zahl der Buchstaben in deinem Namen wissen. Auch dafür gibt es eine **Funktion**!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Nun fragst du dich sicher, warum du manchmal eine Methode mit einem `.` am Ende des Strings (wie bei `"Ola".upper()`) schreibst und manchmal eine Funktion direkt aufrufst und den String dahinter in Klammern setzt? Im ersten Fall gehören solche Methoden, wie `upper()`, zu Objekten (hier: ein String) und funktionieren auch nur bei diesen. In solchen Fällen bezeichnen wir eine Funktion als **Methode**. Andere Funktionen sind dagegen allgemeiner und können auf unterschiedliche Datentypen angewendet werden, wie beispielsweise `len()`. Daher übergeben wir `"Ola"` als Parameter an die `len` Funktion.
+
+### Zusammenfassung
+
+Ok, genug über Strings. Bisher haben wir Folgendes kennengelernt:
+
+- **Der Prompt** - Wenn wir beim Python-Prompt Anweisungen (oder Programm-Code) in Python eingeben, dann erhalten wir auch Ergebnisse in Python. Man sagt zu dieser Python-Umgebung auch "Python-Shell".
+- **Zahlen und Strings** - In Python nutzen wir Zahlen für Berechnungen und Strings für Text-Objekte.
+- **Operatoren**, wie + und &#42;, verarbeiten mehrere Werte und erzeugen als Ergebnis einen neuen Wert.
+- **Funktionen** - wie upper() und len(), tun etwas mit Objekten (in unserem Beispiel ändern sie diese, wie bei upper(), oder sie geben eine Eigenschaft zurück, wie bei len()).
+
+Das sind Grundlagen jeder Programmiersprache, die Du lernen wirst. Bist Du bereit für mehr? Bestimmt!
+
+## Fehler
+
+Probieren wir etwas Neues: Errors. Können wir die Länge einer Zahl auf die gleiche Weise ermitteln, wie die Länge eines Namens? Gib dazu `len(304023)` ein und drücke auf Enter:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Wir haben unsere erste Fehlermeldung (Error) erhalten! Mit dem Icon {{ warning_icon }} teilen wir dir in diesem Tutorial jeweils mit, dass der einzugebende Code nicht wie erwartet funktionieren wird. Fehler zu machen (selbst absichtlich) ist ein wesentlicher Teil beim Lernen!
+
+Unser erster Fehler sagt, dass Objekte vom Typ "int" (Integers, das sind ganze Zahlen) keine Länge haben. Was also nun? Vielleicht sollten wir unsere Zahl als String schreiben? Denn bei Strings funktioniert es ja, wie wir wissen.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Ja, das funktioniert! Hier haben wir die `str`-Funktion innerhalb der Funktion `len` aufgerufen. `str()` konvertiert alles zu einem String.
+
+- Die `str`-Funktion wandelt den übergebenen Wert in einen **String** um.
+- Die `int`-Funktion wandelt den übergebenen Wert in einen **Integer** um.
+
+> Wichtig: Zwar können wir Zahlen in Text umwandeln, aber nicht immer auch Text in Zahlen - was beispielsweise sollte `int('hello')` ergeben?
+
+## Variablen
+
+Ein wichtiger Bestandteil beim Programmieren sind Variablen. Eine Variable ist einfach ein Name für etwas, das wir später unter genau diesem Namen wieder verwenden können. Programmiererinnen nutzen Variablen, um Daten zu speichern, den Code lesbar zu halten und um sich nicht immer alles merken zu müssen.
+
+Lass uns eine Variable mit der Bezeichnung `name` anlegen:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+Wir geben ein: name ist gleich "Ola".
+
+Du hast sicher schon bemerkt, dass Python diesmal kein Ergebnis zurückgegeben hat. Woher sollen wir nun wissen, dass es die Variable jetzt auch tatsächlich gibt? Gib `name` ein und drücke wieder auf `Enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Hurra! Deine erste Variable :)! Nun kannst du auch stets ändern, was sie enthalten soll:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+Du kannst die Variable auch in Funktionen verwenden:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Das ist toll, oder? Variablen können alles enthalten, also auch Zahlen. Versuche Folgendes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Was aber, wenn wir für eine Variable den falschen Namen verwenden? Uns einfach vertippen. Hast du schon eine leise Ahnung, was dann passiert? Probieren wir es aus!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Ein Fehler! Wie du siehst, kennt Python verschiedene Arten von Fehlern. In unserem Fall hier ist es ein **NameError**. Python liefert diesen Fehler immer dann, wenn du versuchst, eine Variable zu verwenden, die es noch gar nicht gibt. Wenn du einen solchen Fehler erhältst, prüfe einfach in deinem Code, ob du dich irgendwo vertippt hast.
+
+Spiel einfach ein wenig rum und schaue, was alles so passiert.
+
+## Die print-Funktion
+
+Gib einmal Folgendes ein:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Wenn du in der zweiten Zeile `name` eintippst, dann gibt der Python-Interpreter die String-*Darstellung* (engl. 'representation') der Variable 'name' aus. In unserem Beispiel die Buchstaben M-a-r-i-a, umschlossen von einfachen Anführungszeichen ('). Wenn du hingegen `print(name)` schreibst, dann gibt Python den Inhalt der Variablen ohne die Anführungszeichen zurück, was etwas schöner aussieht.
+
+Wie wir später sehen werden, ist `print()` auch recht nützlich, wenn wir etwas aus Funktionen heraus ausgeben möchten oder auch eine Ausgabe über mehrere Zeilen darstellen wollen.
+
+## Listen
+
+Außer Strings (Zeichenketten) und Integern (ganze Zahlen) hat Python noch viele andere Arten von Datentypen. Von denen wollen wir uns nun **Listen** anschauen. Listen sind genau das, was du wahrscheinlich schon vermutest: Es sind Objekte, die Listen von anderen Objekten enthalten. :)
+
+Legen wir los und erzeugen eine Liste:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Ja, dies ist eine leere Liste. Für uns noch nicht sehr nützlich. Legen wir nun eine Liste von Lottozahlen an. Da wir uns nicht dauernd wiederholen wollen, ordnen wir diese Liste auch direkt einer Variablen zu:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+So, nun haben wir eine Liste mit Lottozahlen! Was aber können wir damit tun? Zuerst einmal wollen wir feststellen, wie viele Zahlen in ihr enthalten sind. Hast du schon eine Idee, wie dies geht? Klar, das weißt du ja bereits!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Genau! `len()` liefert die Anzahl von Objekten in einer Liste zurück. Praktisch, nicht wahr? Nun wollen wir die Liste sortieren:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Diese Anweisung gibt nichts zurück, sie hat aber die Reihenfolge der Objekte in der Liste geändert. Um zu sehen, was passiert ist, müssen wir die Liste ausgeben:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Wie du siehst, sind die Zahlen in der Liste nun aufsteigend sortiert. Super!
+
+Aber vielleicht wollten wir es genau andersherum haben? Nichts leichter als das!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+Einfach, oder? Du kannst auch etwas zu deiner Liste hinzufügen:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Falls du nicht immer die gesamte Liste, sondern beispielsweise nur den ersten Eintrag sehen möchtest, kannst du dafür **Indizes** benützen. Ein Index gibt die Stelle innerhalb einer Liste an, die uns interessiert. Programmierer bevorzugen es, bei 0 mit dem Zählen anzufangen. Also hat das erste Objekt in deiner Liste den Index 0, das nächste die 1 und so weiter. Gib einmal Folgendes ein:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Wie du siehst, kannst du auf die einzelnen Objekte in deiner Liste zugreifen, indem du den Namen der Liste verwendest und anschließend den Index in eckigen Klammern anfügst.
+
+Um etwas aus deiner Liste zu löschen, musst du die **Indizes** wie gerade gelernt benutzen und die `pop()`-Methode. Lass uns ein Beispiel versuchen und das festigen, was wir zuvor gelernt haben; wir werden die erste Nummer aus unserer Liste löschen.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Das hat doch super geklappt!
+
+Probier einmal andere Indizes aus: 6, 7, 1000, -1, -6 oder -1000 und versuch dir das Ergebnis vorzustellen, bevor du den jeweiligen Index verwendest. Sind die Ergebnisse sinnvoll?
+
+Eine Liste aller Methoden, die du auf Listen anwenden kannst, findest du in der Python-Dokumentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> Für die Leser zu Hause: Dieses Kapitel wird im Video [Installing Python Code Editor](https://www.youtube.com/watch?v=ZX1CVvZLE6c) behandelt.
+
+Ein Wörterbuch (von nun an mit dem englischen Begriff 'Dictionary' bezeichnet) verhält sich ähnlich wie eine Liste, jedoch greifen wir auf die enthaltenen Objekte nicht mit einem Index, sondern mit einem Schlüssel zu (auf englisch 'key', und auch hier verwenden wir im weiteren den englischen Begriff). Ein 'key' kann ein String oder eine Zahl sein. Ein leeres Dictionary legen wir wie folgt an:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Und schon hast du ein leeres Dictionary erstellt. Super!
+
+Nun gib einmal Folgendes ein (verwende statt 'Ola' usw. deine eigenen Informationen):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+Du hast nun soeben die Variable mit dem Namen `participant` angelegt, die ein Dictionary mit drei key-value Paaren enthält (values, also Werte, sind die Objekte in einem Dictionary, - aber auch hier bleiben wir beim englischen Begriff):
+
+- Der key `name` verweist auf den value `'Ola'` (welches ein `string` Objekt ist),
+- `country` verweist auf `'Poland'` (ebenfalls ein `string` Objekt),
+- und `favorite_numbers` schließlich verweist auf `[7, 42, 92]` (eine `Liste` mit drei Zahlen).
+
+Auf die einzelnen Objekte in einem Dictionary kannst du wie folgt zugreifen:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Also ganz ähnlich wie bei einer Liste. Aber statt dir einen Index merken zu müssen, benutzt du bei einem Dictionary einfach einen key (hier: den String 'name').
+
+Was aber geschieht, wenn wir Python nach dem Wert eines keys fragen, den es gar nicht gibt? Errätst du es schon? Probieren wir es einfach aus und schauen was passiert!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Ah, wieder ein Fehler! Diesmal ein **KeyError**. Python hilft uns auch hier und sagt uns, dass es den key `'age'` in diesem Dictionary gar nicht gibt.
+
+Wenn du zwischen Dictionaries und Listen wählen kannst, wann sollte welche Datenstruktur verwendet werden? Das ist eine gute Frage, über die es sich nachzudenken lohnt; und vielleicht möchtest du dies kurz tun, bevor du weiterliest.
+
+- Du brauchst nur eine geordnete Folge von Elementen? Dann wähle eine Liste.
+- Du brauchst eine Sammlung von Elementen, auf die du später einzeln, gezielt und effizient mit Hilfe eines Namens (d.h. keys) zugreifen kannst? Dann wähle ein Dictionary.
+
+Dictionaries sind, so wie auch Listen, *mutable*, d. h. nachträglich veränderbar. So kannst du bei Dictionaries später noch weitere key-value Paare hinzufügen:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Wie bei Listen können wir auch bei Dictionaries die `len()`-Funktion verwenden, um die Zahl der enthaltenen Einträge (das sind die key-value Paare) zu ermitteln. Probier es gleich aus und tippe dieses Kommando ein:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Wir hoffen, dass das Alles für dich bisher Sinn ergibt. :) Bist du bereit für mehr Spaß mit Dictionaries? Machen wir weiter.
+
+Zum Löschen von Elementen kannst du den `pop()`-Befehl verwenden. Nehmen wir an, du möchtest den Eintrag mit dem key `'favorite_numbers'` entfernen, dann tippe:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Wie du an der Ausgabe erkennst, ist nun das key-value Paar von 'favorite_numbers' gelöscht.
+
+Ebenso kannst du auch den Wert eines bestehenden Eintrages ändern:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Wie du siehst, hast du nun im key-value Paar mit dem key `'country'` den Wert von `'Poland'` nach `'Germany'` geändert. :) Hurra! Schon wieder was gelernt.
+
+### Zusammenfassung
+
+Großartig! Inzwischen hast du schon einiges über Programmierung gelernt und die folgenden Dinge sind dir vertraut:
+
+- **Errors** - Du weißt, wie sie zu lesen sind und dass Python sie dann ausgibt, wenn es eine Anweisung von dir nicht ausführen kann.
+- **Variablen** - sind Namen für Objekte, die dir dabei helfen, deinen Code leichter zu schreiben und ihn dabei auch gut lesbar zu halten.
+- **Listen** - können Objekte in einer geordneten Reihenfolge speichern.
+- **Dictionaries** - speichern Objekte als key-value Paare.
+
+Schon gespannt auf den nächsten Teil? :)
+
+## Vergleichen
+
+> Für die Leser zu Hause: Dieses Kapitel wird im Video [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) behandelt.
+
+Ein großer Teil beim Programmieren besteht darin, Dinge zu vergleichen. Was lässt sich am besten vergleichen? Zahlen! Schauen wir uns mal an, wie das funktioniert:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+Hier haben wir Python einige Zahlen zum Vergleichen gegeben. Wie du siehst, kann Python nicht nur die Zahlen vergleichen, sondern auch die Ergebnisse von mathematischen Ausdrücken wie `2 * 2` und Funktionswerte wie die `2`, die von `len([4, 5])` zurückgegeben wird. Cool, nicht wahr?
+
+Womöglich wunderst du dich aber über die beiden `==` Gleichheitszeichen zum Vergleich, ob zwei Zahlen den selben Wert haben? Ein einfaches Gleichheitszeichen `=` verwenden wir bereits, um Variablen bestimmte Werte zuzuweisen. Da beim Programmieren alle Anweisungen eindeutig sein müssen, benötigst du in Python daher **stets** zwei `==` Zeichen, um Dinge auf Gleichheit zu testen. Wir können auch feststellen, ob Werte unterschiedlich sind. Dafür verwenden wir das Symbol `!=`, wie im obigen Beispiel.
+
+Nun noch zwei weitere Vergleiche:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+`>` und `<` sind klar, was aber sollen `>=` und `<=` bedeuten? Vergleiche liest du folgendermaßen:
+
+- x `>` y bedeutet: x ist größer als y
+- x `<` y bedeutet: x ist kleiner als y
+- x `<=` y bedeutet: x ist kleiner oder gleich y
+- x `>=` y bedeutet: x ist größer oder gleich y
+
+Sensationell! Lust auf mehr? Dann probier das:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Du kannst Python beliebig viele Vergleiche vornehmen lassen und wirst ein Ergebnis erhalten. Das ist wirklich cool, oder?
+
+- **and** - wenn Du den `and`-Operator verwendest, müssen beide Vergleiche True (d.h. wahr) ergeben, damit das Gesamtergebnis auch True ist
+- **or** - wenn Du den `or`-Operator verwendest, genügt es, wenn einer der beiden Vergleiche True ergibt, damit das Gesamtergebnis True ergibt
+
+Die Redewendung "Äpfel mit Birnen zu vergleichen" hast du bestimmt schon einmal gehört. Machen wir dies doch einmal in Python:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Unterschiedliche Dinge, hier die Datentypen Zahlen (`int`) und Strings (`str`), lassen sich auch in Python nicht miteinander vergleichen. In solch einem Fall liefert uns Python einen **TypeError** und sagt uns, dass diese zwei Datentypen nicht miteinander verglichen werden können.
+
+## Boolean
+
+Du hast gerade einen neuen Typ von Python-Objekten kennen gelernt. Er heisst **Boolean**.
+
+Es gibt zwei Boolean-Objekte:
+
+- True (wahr)
+- False (falsch)
+
+Damit Python diese beiden Werte versteht, musst du sie auch genau so schreiben (den ersten Buchstaben groß, alle weiteren klein). **true, TRUE und tRUE funktionieren nicht – nur True ist korrekt.** (Dasselbe gilt auch für False.)
+
+Auch Booleans können Variablen zugewiesen werden:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Auch Folgendes geht:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Übe ein wenig, indem du mit Booleans rumspielst, zum Beispiel mit diesen Anweisungen:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Glückwunsch! Booleans sind echt eine der coolsten Features beim Programmieren und du hast gerade gelernt, damit umzugehen!
+
+# Speicher es!
+
+> Für die Leser zu Hause: Dieses Kapitel wird im Video [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) behandelt.
+
+Bisher haben wir den Python-Code nur im Interpreter eingegeben, wodurch wir immer nur eine Zeile Code auf einmal ausführen konnten. Richtige Programme dagegen werden in Dateien gespeichert und, je nach Programmiersprache, durch einen **Interpreter** ausgeführt oder durch einen **Compiler** übersetzt. Unseren bisherigen Code haben wir dagegen im Python-**Interpreter** Zeile für Zeile eingegeben und einzeln ausgeführt. Für die nächsten Beispiele brauchen wir mehr als eine Zeile, daher werden wir nun:
+
+- Den Python-Interpreter beenden
+- Einen Code-Editor unserer Wahl öffnen
+- Code eingeben und diesen in einer Python-Datei sichern
+- Und diesen dann laufen lassen!
+
+Um den Python-Interpreter zu beenden, nutze die `exit()`-Funktion
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+```
+
+Nun siehst du wieder den normalen Kommandozeilen-Prompt.
+
+Im Kapitel [Code-Editor](../code_editor/README.md) haben wir uns bereits einen Code-Editor ausgesucht. Nun öffnen wir den Code-Editor und schreiben folgenden Code in eine neue Datei (wenn du ein Chromebook benutzt, dann erstelle eine neue Datei in der Cloud-IDE, öffne sie und du befindest dich automatisch im integrierten Code-Editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Da du nun schon einige Python-Erfahrung hast, schreibe ein wenig Code mit dem, was du bislang gelernt hast.
+
+Als nächstes wollen wir diesen Code in einer Datei mit einem aussagekräftigen Namen speichern. Lass uns die Datei **python_intro.py** nennen und auf dem Desktop speichern. Wir können der Datei jeden Namen geben, den wir wollen, aber es ist wichtig sicherzustellen, dass der Dateiname auf **.py** endet. Die Erweiterung **.py** gibt unserem Betriebssystem an, dass dies ein **Python executable file** ist und Python diese ausführen kann.
+
+> **Hinweis:** Du wirst eines der coolsten Eigenschaften von Code-Editoren bemerken: Farben! In der Python-Konsole hatte alles die gleiche Farbe. Der Code-Editor dagegen sollte dir nun die `print`-Funktion in einer anderen Farbe anzeigen als der von ihr auszugebende Text. Dies wird "Syntax Hervorhebung" ("syntax highlighting") genannt und ist ein wirklich sehr nützliches Werkzeug beim Programmieren. Die Farbe von Dingen gibt dir Hinweise auf z.B. nicht geschlossene Zeichenfolgen oder Tippfehler in einem Schlüsselwort (wie das `def` in einer Funktion, das wir weiter unten sehen werden). Dies ist einer der Gründe, warum wir Code-Editoren verwenden. :)
+
+Nun, da die Datei gesichert ist, wollen wir sie ausführen! Nutze, was du bisher über die Kommandozeile (das mit dem Prompt) gelernt hast, um in der Konsole in das Desktop-Verzeichnis zu wechseln.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Auf einem Mac sieht das etwa so aus:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Unter Linux ist es ähnlich:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Denk daran, dass das "Desktop"-Verzeichnis bei dir "Schreibtisch" heißen kann.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+In der Eingabeaufforderung von Windows wird's so sein:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+Und in der Powershell von Windows so:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Wenn du nicht weiterkommst, frag' um Hilfe. Denn genau dafür sind die Coaches da!
+
+Benutze jetzt Python, um den Code in der Datei auszuführen:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hello, Django girls!
+    
+
+Hinweis: Unter Windows gibt es den 'python3'-Befehl nicht. Verwende stattdessen 'python', um die Datei auszuführen:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Prima! Du hast soeben dein erstes Python-Programm aus einer Datei heraus ausgeführt. Großartig, oder?
+
+Nun wollen wir uns einem wichtigen Teil der Programmierung zuwenden:
+
+## Wenn ... sonst-wenn ... sonst (If … elif … else)
+
+Oft sollen manche Programmteile nur ausgeführt werden, wenn bestimmte Vorbedingungen erfüllt sind. Dafür gibt es in Python sogenannte **if-Anweisungen**.
+
+Nun ändere den Code in deiner **python_intro.py** Datei:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Würden wir das nun speichern und anschließend ausführen, würden wir einen Fehler erhalten:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python erwartet hier noch weiteren Programmcode, der ausgeführt werden soll, wenn die Bedingung `3 > 2` wahr ist (also `True` ergibt). Versuchen wir, Python “It works!” ausgeben zu lassen. Ändere den Code in **python_intro.py** zu:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Du fragst dich nun, warum wir die angefügte Zeile mit 4 Leerzeichen eingerückt haben? Damit teilen wir Python mit, dass dieser Code ausgeführt werden soll, wenn die vorhergehende Bedingung True ergeben hat. Du könntest auch eine andere Anzahl von Leerzeichen wählen, aber fast alle Python-Programmier nutzen 4 Leerzeichen, damit's gut aussieht. Ein einfaches Tab zählt auch wie 4 Leerzeichen, sofern dies in deinem Editor so eingestellt ist. Wenn du dich einmal entschieden hast, bleib dabei! Wenn du mit 4 Leerzeichen angefangen hast, solltest du alle weiteren Einrückungen auch mit 4 Leerzeichen machen, anderweitig könnte das Probleme verursachen.
+
+Nun sichere die Datei und führe sie noch einmal aus:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py 
+It works!
+```
+
+Hinweis: Denk daran, dass Windows den 'python3'-Befehl nicht kennt. Falls du auf Windows arbeitest, verwende ab jetzt immer 'python', wenn in dieser Anleitung 'python3' steht.
+
+### Was passiert, wenn eine Bedingung nicht wahr (not True) ist?
+
+In den vorigen Beispielen wurde Code ausgeführt, wenn eine vorhergehende Bedingung True (wahr) ergab. Aber Python kennt auch `elif`- und `else`-Anweisungen:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 ist wirklich größer als 2')
+else:
+    print('5 ist nicht größer als 2')
+```
+
+Wenn dies ausgeführt wird, wird es anzeigen:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    5 ist wirklich größer als 2
+    
+
+Wenn 2 größer als 5 wäre, würde die zweite Anweisung (die nach dem else) ausgeführt. Schauen wir uns nun an, wie `elif` funktioniert:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+und ausgeführt erhalten wir:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+Hast du bemerkt, was passiert ist? `elif` lässt dich zusätzliche Bedingungen hinzufügen, die geprüft werden, falls die vorherige fehlschlägt.
+
+Du kannst so viele `elif`-Bedingungen nach der anfänglichen `if`-Anweisung hinzufügen, wie du magst. Zum Beispiel:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57  # "volume" ist Englisch für "Lautstärke"
+if volume < 20:
+    print("Das ist etwas leise.")
+elif 20 <= volume < 40:
+    print("Das ist gut für Hintergrund-Musik.")
+elif 40 <= volume < 60:
+    print("Perfekt, ich kann alle Details hören.")
+elif 60 <= volume < 80:
+    print("Gut für Partys.")
+elif 80 <= volume < 100:
+    print("Etwas laut!")
+else:
+    print("Mir tun die Ohren weh! :(")
+```
+
+Python läuft durch jeden Test der Reihe nach und gibt dann aus:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Perfekt, ich kann alle Details hören.
+    
+
+## Kommentare
+
+Kommentare sind Zeilen, die mit `#` beginnen. Du kannst nach dem `#` schreiben, was auch immer du willst, und Python wird es ignorieren. Kommentare können deinen Code für andere Leute einfacher zu verstehen machen.
+
+Schauen wir, wie das aussieht:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Ändert die Lautstärke, wenn sie zu leise oder zu laut ist
+if volume < 20 or volume > 80:
+    volume = 50
+    print("So ist's besser!")
+```
+
+Du musst nicht für jede Codezeile einen Kommentar schreiben, aber Kommentare sind nützlich um zu erklären, wieso dein Code etwas macht, oder um zusammenzufassen, wenn er etwas Komplexes tut.
+
+### Zusammenfassung
+
+In den letzten paar Übungen hast du gelernt:
+
+- **Vergleiche vorzunehmen** – in Python kannst du Vergleiche mit den folgenden Operatoren `>`, `>=`, `==`, `<=`, `<` sowie `and` und `or` vornehmen
+- **Boolsche Datentypen** zu verwenden – dies sind Objekte, die nur zwei Werte annehmen können: `True` bzw. `False`
+- **Dateien zu speichern** – also Programmcode in Dateien abzulegen, so dass du auch umfangreichere Programme schreiben kannst.
+- **if … elif … else** – Anweisungen, die dir erlauben, bestimmte Programmteile nur auszuführen, wenn bestimmte Bedingungen erfüllt sind.
+- **Kommentare** – Zeilen, die Python nicht ausführt und die dir ermöglichen deinen Code zu dokumentieren
+
+Zeit für den letzten Teil dieses Kapitels!
+
+## Deine eigenen Funktionen!
+
+> Für die Leser zu Hause: Dieses Kapitel wird im Video [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) behandelt.
+
+Erinnerst du dich an Funktionen wie `len()`, die du in Python aufrufen kannst? Prima! Du wirst nun lernen, eigene Funktionen zu schreiben!
+
+Eine Funktion ist eine Folge von Anweisungen, die Python ausführen soll. Jede Funktions-Definition beginnt mit dem Schlüsselwort (engl. "Keyword") `def`, bekommt einen Namen und kann Argumente (manchmal auch "Parameter" genannt) haben. Probieren wir's aus! Ersetze den Code in der Datei **python_intro.py** mit dem folgenden:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hallo():
+    print("Halli-hallo!")
+    print("Wie geht's?")
+
+hallo()
+```
+
+Und schon hast du deine erste Funktion erstellt!
+
+Nun fragst du dich vielleicht, warum wir am Ende der Datei den Namen der Funktion nochmal hingeschrieben haben. Wenn wir `def hallo():` und die darauf folgenden, eingerückten Zeilen schreiben, dann schreiben wir Anweisungen, was die `hallo()` Funktion tun soll. Python wird diese Anweisungen lesen und speichern, die Funktion jedoch noch nicht ausführen. Um Python zu sagen, dass wir die Funktion ausführen wollen, müssen wir die Funktion mit `hallo()` aufrufen. Python liest und führt die Datei von oben nach unten aus, daher müssen wir die Funktion in der Datei erst definieren bevor wir sie aufrufen.
+
+Schauen wir, was passiert, wenn wir die Datei ausführen:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Halli-hallo!
+    Wie geht's?
+    
+
+Falls das nicht funktionert hat, keine Panik! Die Ausgabe wird dir dabei helfen, herauszufinden wieso:
+
+- Wenn du einen `NameError` erhältst, hast du dich vermutlich irgendwo im Code vertippt. Prüfe also, ob du bei der Funktionsdefinition `def hallo():` und beim Funktionsaufruf `hallo()` den Funktionsnamen gleich geschrieben hast.
+- Wenn du einen `IndentationError` bekommst, prüfe, ob beide `print`-Zeilen die gleichen Whitespaces am Zeilenanfang haben: Python will den ganzen Code in einer Funktion hübsch ausgerichtet haben.
+- Wenn du gar keine Ausgabe erhältst, stelle sicher, dass `hallo()` am Datei-Ende *nicht* eingerückt ist. Wenn es eingerückt ist, ist dieser Aufruf selbst Teil der Funktion und sie wird gar nicht ausgeführt.
+
+Als Nächstes bauen wir Funktionen mit sogenannten Argumenten. Wir werden das gerade gebaute Beispiel benutzen – eine Funktion, die die ausführende Person begrüßt – aber diesmal mit Namen:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hallo(name):
+```
+
+Wie du siehst, geben wir der Funktion jetzt einen Parameter, den wir `name` nennen:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hallo(name):
+    if name == 'Ola':
+        print('Hallo Ola!')
+    elif name == 'Sonja':
+        print('Hallo Sonja!')
+    else:
+        print('Hallo Unbekannte(r)!')
+
+hallo()
+```
+
+Denk daran: Die `print`-Funktion ist 4 Leerzeichen innerhalb der `if`-Anweisung eingerückt. Das ist sinnvoll, da die Funktion ausgeführt wird, wenn die Bedingung eintritt. Mal sehen, wie das jetzt funktioniert:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Traceback (most recent call last): 
+    File "python_intro.py", line 10, in <module>
+       hallo() 
+    TypeError: hallo() missing 1 required positional argument: 'name'
+    
+
+Hoppla, ein Fehler. Zum Glück gibt uns Python eine recht nützliche Fehlermeldung. Diese besagt, dass die Funktion `hallo()` (welche wir definiert haben) ein erforderliches Argument (namens `name`) hat und dass wir vergessen haben, dieses beim Funktionsaufruf mitzugeben. Lass uns das am unteren Ende der Datei schnell beheben:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hallo("Ola")
+```
+
+Und wir führen sie erneut aus:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hallo Ola!
+    
+
+Und wenn wir den Namen ändern?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hallo("Sonja")
+```
+
+Und ausgeführt:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hallo Sonja!
+    
+
+Nun, was denkst du, wird passieren, wenn du einen anderen Namen dort hinein schreibst? (Weder Ola noch Sonja.) Probier es aus und schau, ob du richtig liegst. Es sollte das Folgende herauskommen:
+
+{% filename %}command-line{% endfilename %}
+
+    Hallo Unbekannte(r)!
+    
+
+Das ist genial, oder? Auf diese Weise musst du dich nicht jedesmal wiederholen, wenn du den Namen der Person änderst, die die Funktion grüßen soll. Und das ist genau der Grund, warum wir Funktionen brauchen – du willst auf keinem Fall deinen Code wiederholen!
+
+Lass uns noch etwas Schlaueres probieren – es gibt schließlich mehr als zwei Namen und für jeden eine eigene Bedingung aufzuschreiben, wäre ziemlich aufwendig, oder? Ersetze also deinen Code in der Datei durch den folgenden:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hallo(name):
+    print('Hallo ' + name + '!')
+
+hallo("Rachel")
+```
+
+Lass uns den Code aufrufen:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hallo Rachel!
+    
+
+Herzlichen Glückwunsch! Du hast gerade gelernt, wie du Funktionen schreibst! :)
+
+## Schleifen
+
+> Für die Leser zu Hause: Dieses Kapitel wird im Video [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) behandelt.
+
+Dies ist bereits der letzte Teil. Das ging doch schnell, oder? :)
+
+Programmierer wiederholen sich nicht gerne. Beim Programmieren geht es darum, Dinge zu automatisieren. Wir wollen also nicht jede Person mit ihrem Namen manuell grüßen müssen, oder? Für so etwas kommen Schleifen gelegen.
+
+Erinnerst du dich noch an Listen? Lass uns eine Liste mit Mädchennamen erstellen:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+Wir wollen alle mit ihrem Namen grüßen. Wir besitzen bereits die `hallo`-Funktion, um dies zu tun, also lass sie uns in einer Schleife verwenden:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+Die `for`-Anweisung verhält sich ähnlich wie die `if`-Anweisung; Code unter beiden muss 4 Leerzeichen eingerückt werden.
+
+Hier ist der vollständige Code für die Datei:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hallo(name):
+    print('Hallo ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'du']
+for name in girls:
+    hallo(name)
+    print('Nächstes Mädchen')
+```
+
+Und wenn wir es ausführen:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hallo Rachel!
+    Nächstes Mädchen
+    Hallo Monica!
+    Nächstes Mädchen
+    Hallo Phoebe!
+    Nächstes Mädchen
+    Hallo Ola!
+    Nächstes Mädchen
+    Hallo du!
+    Nächstes Mädchen
+    
+
+Wie du sehen kannst, wird alles, was du innerhalb einer `for`-Anweisung eingerückt hast, für jedes Element der Liste `girls` wiederholt.
+
+Du kannst auch `for` auf Ganzzahlen beziehen, wenn du die `range`-Funktion benutzt:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Das würde ausgeben:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` ist eine Funktion, die eine Liste von aufeinander folgenden Zahlen erschafft (die Randwerte werden von dir als Argumente bereitgestellt).
+
+Beachte, dass der zweite der Werte, die du als Argumente übergibst, nicht in der Liste enthalten ist, die von Python ausgegeben wird. (Das bedeutet, dass `range(1, 6)` von 1 bis 5 zählt, aber nicht die Zahl 6 enthält). Das liegt daran, dass "range" halboffen ist, was wiederum bedeutet, dass es den ersten Wert enthält, aber nicht den letzten.
+
+## Zusammenfassung
+
+Das ist alles. **Du rockst total!** Das war ein kniffliges Kapitel, du darfst also ruhig stolz auf dich sein. Wir sind definitiv stolz auf dich und darauf, dass du es so weit geschafft hast!
+
+Wenn du zum offiziellen und vollständigen Python-Tutorial willst, besuche https://docs.python.org/3/tutorial/. Dort gibt's (bislang jedoch noch nicht auf Deutsch) eine gründlichere und umfassendere Einführung in diese Programmiersprache. Viel Erfolg! :)
+
+Bevor du zum nächsten Kapitel übergehst, mach kurz 'was anderes – streck dich, lauf etwas 'rum, ruh' deine Augen aus. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/de-DE/template_extending/README.md b/de-DE/template_extending/README.md
new file mode 100644
index 00000000000..5362ae574b6
--- /dev/null
+++ b/de-DE/template_extending/README.md
@@ -0,0 +1,151 @@
+# Erweiterung der Templates
+
+Eine weitere praktische Sache von Django ist das **template extending**, Erweiterungen des Templates. Was bedeutet das? Damit kannst du Teile deines HTML-Codes für andere Seiten deiner Website nutzen.
+
+Templates helfen, wenn du die selben Informationen oder das selbe Layout an mehreren Stellen verwenden willst. Du musst dich so nicht in jeder Datei wiederholen. Und wenn du etwas ändern willst, dann musst du es nicht in jedem einzelnen Template tun, sondern nur in einem!
+
+## Ein Basis-Template erstellen
+
+Ein Basis-Template ist das grundlegende Template, welches dann auf jeder einzelnen Seite deiner Website erweitert wird.
+
+Wir erstellen jetzt eine `base.html`-Datei in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Öffne sie im Code-Editor, kopiere alles von `post_list.html` und füge es wie folgt in die `base.html`-Datei ein:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Dann ersetze in `base.html` den gesamten `<body>` (alles zwischen `<body>` und `</body>`) hiermit:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Vielleicht hast du bemerkt, dass das alles von `{% for post in posts %}` bis `{% endfor %}` mit dem Folgenden ersetzt: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Aber warum? Du hast gerade einen `block` erstellt! Du hast den Template-Tag `{% block %}` benutzt, um einen Bereich zu schaffen, der HTML aufnehmen kann. Dieses HTML kommt aus einem anderen Template, welches das Template hier (`base.html`) erweitert. Wir zeigen dir gleich, wie das geht.
+
+Speichere nun die Datei `base.html` und öffne wieder `blog/templates/blog/post_list.html` im Code-Editor. {% raw %}Du löschst alles oberhalb von `{% for post in posts %}` und unterhalb von `{% endfor %}`. Wenn du das gemacht hast, sieht die Datei so aus:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Dieser Teil unseres Templates soll nun das Basis-Template erweitern. Wir müssen daher Block-Tags ergänzen!
+
+{% raw %}Deine Block-Tags müssen mit den Tags in der `base.html`-Datei übereinstimmen. Stelle sicher, dass die Block-Tags den ganzen Code deines content-Blocks umschließen. Um das zu erreichen, umschließt du ihn mit `{% block content %}` und `{% endblock %}`. So hier:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Nur eine Sache noch. Wir müssen die beiden Templates miteinander verknüpfen. Darum geht es ja bei der Template-Erweiterung! Dafür ergänzen wir einen Tag für Erweiterung (extends tag) ganz oben in der Datei. Und zwar so:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Das war's! Speichere die Datei und probier aus, ob deine Website noch richtig funktioniert. :)
+
+> Wenn du den Fehler `TemplateDoesNotExist` erhältst, dann heißt das, dass es die Datei `blog/base.html` nicht gibt und dass `runserver` in der Konsole läuft. Halte ihn an (durch Drücken von Ctrl+C bzw. Strg+C – Control- und die C-Taste gleichzeitig) und starte ihn neu, indem du den Befehl `python manage.py runserver` ausführst.
\ No newline at end of file
diff --git a/de-DE/whats_next/README.md b/de-DE/whats_next/README.md
new file mode 100644
index 00000000000..caa79e6cb03
--- /dev/null
+++ b/de-DE/whats_next/README.md
@@ -0,0 +1,43 @@
+# Wie geht es weiter?
+
+Herzlichen Glückwunsch! **Du bist der Hammer!** Wir sind echt stolz! <3
+
+### Was jetzt?
+
+Mach eine Pause und entspanne! Du hast gerade etwas wirklich Großes geleistet.
+
+Und dann folge Django Girls doch auf [Facebook](http://facebook.com/djangogirls) oder [Twitter](https://twitter.com/djangogirls), um auf dem Laufenden zu bleiben.
+
+### Könnt ihr weiteres Lernmaterial empfehlen?
+
+Ja! Es gibt *sehr* viele Online-Ressourcen zum Erlernen aller möglichen Programmierfähigkeiten – es kann ziemlich entmutigend sein, herauszufinden, was man als Nächstes machen sollte, aber wir helfen dir dabei. Was auch immer du für Interessen hattest, bevor du zu Django Girls gekommen bist und was auch immer du für Interessen während des Tutorials entwickelt hast, hier sind einige kostenfreie Ressourcen (oder solche mit größeren kostenlosen Teilen), die du nutzen kannst, um auf deinem Weg voranzukommen.
+
+#### Django
+
+- Unser anderes Buch, [Django Girls Tutorial: Erweiterungen](https://tutorial-extensions.djangogirls.org/)
+- [Das offizielle Django-Tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Video-Lektionen "Getting Started With Django"](http://www.gettingstartedwithdjango.com/)
+- Spezialisierung [Django for Everybody](https://www.coursera.org/specializations/django) – einige Video-Lektionen können kostenlos getestet werden und du kannst ein Coursera-Zertifikat erlangen, wenn du diesen Kurs belegst
+
+#### HTML, CSS und JavaScript
+
+- [Web-Development-Kurs auf Codeacademy](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Python-Kurs auf Codecademy](https://www.codecademy.com/learn/learn-python)
+- [Googles Python-Kurs](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way](http://learnpythonthehardway.org/book/) – die ersten Übungen sind kostenlos
+- [New Coder Tutorials](http://newcoder.io/tutorials/) – eine Vielzahl von praktischen Beispielen, wie Python verwendet werden kann
+- [edX](https://www.edx.org/course?search_query=python) – die meisten Kurse kannst du kostenfrei testen, aber wenn du ein Zertifikat oder Credits für eine Weiterbildung erhalten willst, dann kostet das etwas
+- [Courseras Python-Spezialisierung](https://www.coursera.org/specializations/python) – einige Video-Lektionen können kostenlos getestet werden und du kannst ein Coursera-Zertifikat erlangen, wenn du diesen Kurs belegst
+- [Python for Everybody](https://www.py4e.com/) - eine kostenlose und offene Version der Coursera-Python-Spezialisierung
+
+#### Mit Daten arbeiten
+
+- [Der Data-Science-Kurs von Codecademy](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – die meisten Kurse kannst du kostenfrei testen, aber wenn du ein Zertifikat oder Credits für eine Weiterbildung erhalten willst, dann kostet das etwas
+- [Dataquest](https://www.dataquest.io/) – die ersten 30 "Missionen" sind frei
+
+Wir sind gespannt darauf, was du als Nächstes baust!
\ No newline at end of file
diff --git a/de/README.md b/de/README.md
index 324783fea2c..619388aaebb 100644
--- a/de/README.md
+++ b/de/README.md
@@ -1,22 +1,28 @@
-# Django Girls Tutorial
+# Django Girls Anleitung
 
 [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
 
-> Dieses Werk ist unter der Creative Commons Attribution-ShareAlike 4.0 International License lizensiert. Eine Kopie dieser Lizenz findest du auf http://creativecommons.org/licenses/by-sa/4.0/
+> Dieses Werk ist unter der Creative Commons Attribution-ShareAlike 4.0 International License lizensiert. Eine Kopie dieser Lizenz finden Sie auf http://creativecommons.org/licenses/by-sa/4.0/
+
+## Willkommen
+
+Willkommen bei der Django Girls Anleitung! Wir freuen uns, dass du hier bist :) In dieser Anleitung 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.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
 
 ## Einleitung
 
-Hattest du auch schon einmal das Gefühl, dass Technik in der Welt immer wichtiger wird und du da nicht ganz mithalten kannst? Wolltest du schon immer einmal eine Website bauen, aber hattest dann nicht genug Motivation, damit anzufangen? Hast du dir irgendwann schon einmal gedacht, dass die Computerwelt zu kompliziert für dich ist, so dass du noch nicht einmal den Versuch unternommen hast, dort selbst etwas zu tun?
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Wolltest du schon immer einmal eine Website bauen, aber hattest dann nicht genug Motivation, damit anzufangen? Hast du dir irgendwann schon einmal gedacht, dass die Computerwelt zu kompliziert für dich ist, so dass du noch nicht einmal den Versuch unternommen hast, dort selbst etwas zu tun?
 
 Dann haben wir hier gute Neuigkeiten für dich! Programmieren ist nicht so schwer, wie du denkst und wir zeigen dir hier, wie viel Spaß es machen kann.
 
-Dieses Tutorial wird dich nicht auf zauberhafte Weise in eine Programmiererin verwandeln. Wenn du gut darin sein willst, brauchst du Monate oder sogar Jahre des Lernens und Übens. Aber wir wollen dir zeigen, dass Programmieren oder Webseitenerstellen nicht so kompliziert ist, wie es scheint. Wir versuchen, dir auf einfache Art verschiedene, kleine Teile zu zeigen, so dass du davon nicht eingeschüchtert wirst.
+This tutorial will not magically turn you into a programmer. Wenn du gut darin sein willst, brauchst du Monate oder sogar Jahre des Lernens und Übens. Aber wir wollen dir zeigen, dass Programmieren oder Webseitenerstellen nicht so kompliziert ist, wie es scheint. Wir versuchen, dir auf einfache Art verschiedene, kleine Teile zu zeigen, so dass du davon nicht eingeschüchtert wirst.
 
 Wir hoffen, dass du danach diese Technik und Technologien so sehr mögen wirst wie wir!
 
 ## Was lernst du in diesem Tutorial?
 
-Wenn du mit dem Tutorial fertig bist, hast du eine einfache, aber funktionierende Webanwendung: deinen eigenen Blog. Wir zeigen dir, wie man ihn online stellt, andere können dein Werk also sehen!
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
 
 Es wird (in etwa) so aussehen:
 
@@ -24,20 +30,22 @@ Es wird (in etwa) so aussehen:
 
 > Wenn du allein mit diesem Tutorial arbeitest und keinen Coach in der Nähe hast, kannst du in diesem Chat nachfragen, wenn du ein Problem hast: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Wir haben unsere Coaches und frühere Teilnehmer unserer Workshops gebeten, hin und wieder dort vorbei zu schauen und anderen mit dem Tutorial zu helfen! Hab keine Angst, dort deine Fragen zu stellen!
 
-Okay, [lass uns ganz am Anfang anfangen...](./how_the_internet_works/README.md)
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
 
-## Mit dem Tutorial zu Hause arbeiten
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
 
-Na klar ist es aufregend, bei einem Django Girls Workshop dabei zu sein, aber es ist auch verständlich, dass das nicht immer klappt. Deswegen möchten wir es dir erleichtern, das Tutorial auch von Hause aus zu erarbeiten. Dafür erstellen wir Videos zu einzelnen Themen, die dir helfen können, die Inhalte besser zu verstehen. Wir arbeiten noch daran, aber einige sind schon verfügbar und du kannst sie dir gern auf dem "[Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed)"-YouTube-Channel anschauen.
+In every chapter already covered, there is a link that points to the correct video.
 
 ## Über uns und wie du mithelfen kannst
 
-Dieses Tutorial wird von [DjangoGirls](http://djangogirls.org/) betreut. Solltest du Fehler finden oder das Tutorial aktualisieren wollen, dann folge den [Richtlinien zum Mitarbeiten](https://github.com/DjangoGirls/tutorial/blob/master/CONTRIBUTING.md).
+Dieses Tutorial wird von [DjangoGirls](https://djangogirls.org/) betreut. Solltest du Fehler finden oder das Tutorial aktualisieren wollen, dann folge den [Richtlinien zum Mitarbeiten](https://github.com/DjangoGirls/tutorial/blob/master/CONTRIBUTING.md).
 
-## Möchtest du uns helfen, das Tutorial in andere Sprachen zu übersetzen?
+## Would you like to help us translate the tutorial into other languages?
 
-Zur Zeit haben wir die Übersetzungen auf der crowdin.com Plattform:
+Currently, translations are being kept on crowdin.com platform at:
 
 https://crowdin.com/project/django-girls-tutorial
 
-Sollte deine Sprache nicht aufgeführt sein, dann öffne ein neues [Issue](https://github.com/DjangoGirls/tutorial/issues/new), mit der betreffenden Sprache, dann können wir sie hinzufügen.
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/de/SUMMARY.md b/de/SUMMARY.md
index 51d4ba518f2..6e8d88c782d 100644
--- a/de/SUMMARY.md
+++ b/de/SUMMARY.md
@@ -1,26 +1,27 @@
 # Zusammenfassung
 
-*   [Einleitung](README.md)
-*   [Installation](installation/README.md)
-*   [Wie das Internet funktioniert](how_the_internet_works/README.md)
-*   [Einführung in die Kommandozeile](intro_to_command_line/README.md)
-*   [Python-Installation](python_installation/README.md)
-*   [Der Editor](code_editor/README.md)
-*   [Einführung in Python](python_introduction/README.md)
-*   [Django - Was ist das?](django/README.md)
-*   [Django Installation](django_installation/README.md)
-*   [Dein erstes Django-Projekt!](django_start_project/README.md)
-*   [Django Models](django_models/README.md)
-*   [Django Administration](django_admin/README.md)
-*   [Veröffentlichen!](deploy/README.md)
-*   [Django URLs](django_urls/README.md)
-*   [Django Views - Zeit zum Gestalten!](django_views/README.md)
-*   [Einführung in HTML](html/README.md)
-*   [Django ORM (Querysets)](django_orm/README.md)
-*   [Dynamische Daten in Templates](dynamic_data_in_templates/README.md)
-*   [Django Templates](django_templates/README.md)
-*   [CSS - mach es hübsch!](css/README.md)
-*   [Template Erweiterung](template_extending/README.md)
-*   [Erweitere deine Anwendung](extend_your_application/README.md)
-*   [Django Formulare](django_forms/README.md)
-*   [Was kommt als Nächstes?](whats_next/README.md)
+* [Einleitung](README.md)
+* [Installation](installation/README.md)
+* [Installation (Chromebook)](chromebook_setup/README.md)
+* [Wie funktioniert das Internet](how_the_internet_works/README.md)
+* [Einführung in die Kommandozeile](intro_to_command_line/README.md)
+* [Python-Installation](python_installation/README.md)
+* [Der Code-Editor](code_editor/README.md)
+* [Einführung in Python](python_introduction/README.md)
+* [Django - Was ist das?](django/README.md)
+* [Django Installation](django_installation/README.md)
+* [Dein erstes Django-Projekt!](django_start_project/README.md)
+* [Django Models](django_models/README.md)
+* [Django Administration](django_admin/README.md)
+* [Veröffentlichen!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views - leg los!](django_views/README.md)
+* [Einführung in HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamische Daten in Templates](dynamic_data_in_templates/README.md)
+* [Django Templates](django_templates/README.md)
+* [CSS - mach es hübsch](css/README.md)
+* [Erweiterung der Templates](template_extending/README.md)
+* [Erweitere deine Anwendung](extend_your_application/README.md)
+* [Django Formulare](django_forms/README.md)
+* [Wie geht es weiter?](whats_next/README.md)
\ No newline at end of file
diff --git a/de/chromebook_setup/README.md b/de/chromebook_setup/README.md
new file mode 100644
index 00000000000..0340021beb5
--- /dev/null
+++ b/de/chromebook_setup/README.md
@@ -0,0 +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.
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/de/chromebook_setup/instructions.md b/de/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..c53224bd8e8
--- /dev/null
+++ b/de/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+Du kannst diese [Section](http://tutorial.djangogirls.org/en/installation/#install-python) direkt ü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 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. Während des Tutorials wird dir Cloud 9 als dein *lokaler Rechner* dienen. Du wirst die gleichen Befehle ausführen, wie deine Klassenkameradinnin, die OS X, Ubuntu oder Windows benutzen, jedoch ist dein Terminal verbunden mit einem Computer, der von Cloud 9 gehostet wird.
+
+1. Installiere Cloud 9 aus dem [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Gehe auf [c9.io](https://c9.io)
+3. Erstelle dir einen Account
+4. Klicke auf *Create a New Workspace*
+5. Gib ihm den Namen *django-girls*
+6. Wähle *Blank* aus( das zweite von links in der untersten Reihe mit dem orangen Logo)
+
+Jetzt solltest du ein Interface mit Sidebar, ein grosses Fenster mit Text und am unteren Rand ein Feld sehen, das wie folgt aussieht:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    deinbenutzername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtuelle Umgebung
+
+Eine virtuelle Umgebung (auch virtualenv genannt) ist ein privater Behälter, in den wir nützlichen Code packen können, um an einem Projekt arbeiten zu können. Wir benutzen diese, um Code für verschiedene Projekte getrennt aufzubewahren, damit diese nicht vermischt werden.
+
+Führe im Terminal den folgenden Code aus( das Terminal befindet sich am unteren Rand des Cloud 9 Interface):
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+Wenn du Probleme hast frag deinen Coach nach Hilfe.
+
+Als nächstes führe die folgenden Befehle aus:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(beachte, dass wir im letzten Befehl eine Tilde gefolgt von einem Gleichheitssymbol benutzen: ~=).
+
+### Github
+
+Erstelle einen [Github](https://github.com) Account.
+
+### PythonAnywhere
+
+Das Django Girls tutorial beinhaltet einen Teil zu Deployment. Beim Deployment nimmst du den Code, der deiner Web Anwendung zu Grunde liegt und packst ihn auf einen öffentlich zugänglichen Computer (Server), damit auch andere Leute deine Arbeit betrachten können.
+
+Dieser Teil ist ein bisschen seltsam, wenn du ihn auf einem Chromebook ausführst, da er bereits nur in der Cloud ist( im Gegensatz zu einem Laptop). Es ist aber trotzdem sinnvoll mitzumachen, wir stellen uns dann einfach unseren Cloud 9 Arbeitsplatz als "work in progress" vor und Python Anywhere als Platz auf dem wir unser Projekt vorführen können.
+
+Deshalb solltest du dich auf [www.pythonanywhere.com](https://www.pythonanywhere.com) für einen Python Anywhere Account anmelden.
\ No newline at end of file
diff --git a/de/code_editor/README.md b/de/code_editor/README.md
index a5f09e4cf20..26c7539741e 100644
--- a/de/code_editor/README.md
+++ b/de/code_editor/README.md
@@ -1,7 +1,11 @@
-# Der Editor
+# Der Code-Editor
 
-Gleich geht's los! Du wirst deine erste Zeile Programmcode schreiben! Daher ist es jetzt an der Zeit, einen entsprechenden Editor herunterzuladen.
+> Für die Leser zu Hause: Dieses Kapitel wird im Video [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) behandelt.
 
-> **Hinweis:** Es kann sein, dass du diesen Schritt bereits im Kapitel "Installation" erledigt hast. In diesem Fall kannst du direkt zum nächsten Kapitel übergehen.
+Gleich geht's los! Du wirst deine erste Zeile Programmcode schreiben! Daher ist es jetzt an der Zeit, einen entsprechenden Editor herunterzuladen!
 
-{% include "/code_editor/instructions.md" %}
+> **Hinweis** Wenn du ein Chromebook verwendest, überspringe bitte dieses Kapitel und folgen den Anweisungen im [Chromebook Setup](../chromebook_setup/README.md).
+> 
+> **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!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/de/code_editor/instructions.md b/de/code_editor/instructions.md
index fe8d0da3867..cc5385eb469 100644
--- a/de/code_editor/instructions.md
+++ b/de/code_editor/instructions.md
@@ -1,4 +1,4 @@
-Es gibt viele verschiedene Editoren. Welcher für dich am besten ist, ist weitestgehend Geschmackssache. Die meisten Python-Programmiererinnen verwenden komplexe, aber extrem leistungsfähige IDEs (Integrated Development Environments), z. B. PyCharm. Für Anfängerinnen sind diese jedoch wahrscheinlich weniger gut geeignet. Unsere Empfehlungen sind ebenso leistungsfähig, aber viel einfacher zu bedienen.
+Es gibt viele verschiedene Editoren. Welcher für Dich am besten ist, ist weitestgehend Geschmackssache. Die meisten Python-Programmiererinnen verwenden komplexe, aber extrem leistungsfähige IDEs (Integrated Development Environments), z. B. PyCharm. Für Anfängerinnen sind diese jedoch wahrscheinlich weniger gut geeignet. Unsere Empfehlungen sind ebenso leistungsfähig, aber viel einfacher zu bedienen.
 
 Unsere Vorschläge siehst du unten. Aber fühl dich ganz frei, deine Trainerin zu fragen, was ihre Vorlieben sind - wenn sie sich mit dem Editor auskennt, wird es leichter sein, Hilfe zu erhalten.
 
@@ -6,19 +6,19 @@ Unsere Vorschläge siehst du unten. Aber fühl dich ganz frei, deine Trainerin z
 
 Gedit ist ein kostenloser Open-Source-Editor. Es gibt ihn für alle Betriebssysteme.
 
-[Hier herunterladen:](https://wiki.gnome.org/Apps/Gedit#Download)
+[Du kannst ihn hier herunterladen](https://wiki.gnome.org/Apps/Gedit#Download)
 
-## Sublime Text 2
+## Sublime Text 3
 
-Sublime Text ist ein sehr beliebter Editor mit einem kostenlosen Testzeitraum. Er ist einfach zu installieren und zu verwenden, und er ist für alle Betriebssysteme verfügbar.
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
 
-[Hier herunterladen:](http://www.sublimetext.com/2)
+[Du kannst ihn hier herunterladen](https://www.sublimetext.com/3)
 
 ## Atom
 
-Atom ist ein ganz neuer Code-Editor, der von [GitHub](http://github.com/) ins Leben gerufen wurde. Er ist kostenlos, quelloffen (Open Source), einfach zu installieren und einfach zu bedienen. Atom ist verfügbar für Windows, OS X und Linux.
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
 
-[Hier herunterladen:](https://atom.io/)
+[Du kannst ihn hier herunterladen](https://atom.io/)
 
 ## Warum installieren wir einen Code-Editor?
 
@@ -28,4 +28,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.
 
-Einige 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 :)
\ No newline at end of file
+Einige 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. :)
\ No newline at end of file
diff --git a/de/css/README.md b/de/css/README.md
index dba188ef932..c2a3f8110d7 100644
--- a/de/css/README.md
+++ b/de/css/README.md
@@ -1,25 +1,27 @@
 # CSS - mach es hübsch!
 
-Unser Blog sieht immer noch ziemlich unfertig aus, oder? Zeit, das zu ändern! Dafür nutzen wir CSS.
+Unser Blog sieht immer noch ziemlich unfertig aus, oder? Zeit das zu ändern! Dafür nutzen wir CSS.
 
 ## Was ist CSS?
 
-Cascading Style Sheets (CSS) ist eine Sprache, die das Aussehen und die Formatierung einer Website beschreibt. Es handelt sich wie bei HTML um eine Auszeichnungssprache (Markup Language). Sie ist sowas wie das "Make-up" unserer Website ;).
+Cascading Style Sheets (CSS) ist eine Sprache, die das Aussehen und die Formatierung einer Website beschreibt. Es handelt sich wie bei HTML um eine Auszeichnungssprache (Markup Language). Sie ist sowas wie das "Make-up" unserer Website. ;)
 
-Aber wir wollen nicht wieder von vorne anfangen, nicht wahr? Ein weiteres Mal werden wir von dem profitieren, was andere Programmiererinnen vor uns erstellt und im Internet veröffentlicht haben. Das Rad neu zu erfinden, macht ja keinen Spaß.
+Aber wir wollen nicht nochmal bei Null anfangen, oder? Einmal mehr werden wir etwas verwenden, dass ProgrammiererInnen entwickelt haben und gratis im Internet zur Verfügung stellen. Wir wollen ja nicht das Rad neu erfinden.
 
 ## Lass uns Bootstrap verwenden!
 
-Bootstrap ist eines der bekanntesten HTML- und CSS-Frameworks für die Entwicklung von schönen Websites: http://getbootstrap.com/
+Bootstrap ist eines der bekanntesten HTML- und CSS-Frameworks für die Entwicklung von schönen Websites: https://getbootstrap.com/
 
-Bootstrap hat seinen Ursprung im Umfeld von Twitter und wird heute von Freiwilligen weltweit weiterentwickelt.
+Es wurde ursprünglich von ProgrammiererInnen bei Twitter geschrieben. Heute wird es von Freiwilligen aus der ganzen Welt weiterentwickelt!
 
 ## Bootstrap installieren
 
-Um Bootstrap zu installieren, musst du das Folgende in den `<head>`-Bereich in deiner `HTML`-Datei einfügen (`blog/templates/blog/post_list.html`):
+Um Bootstrap zu installieren, müssen Sie das hinzufügen, um Ihre `<head>`in Ihre `Html`-Datei:
 
-```html 
-<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css"> 
+{% filename %}blog/templates/blog/post_list{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
 ```
 
@@ -31,78 +33,85 @@ Sie sieht jetzt schon viel schöner aus!
 
 ## Statische Dateien in Django
 
-Schlussendlich werden wir einen genaueren Blick auf die Dinge werfen, die wir bisher **statische Dateien** genannt haben. Statische Dateien sind Bilder und dein CSS-Code. Diese Dateien sind nicht dynamisch, sie reagieren nicht auf Anfragen auf der Nutzerseite und sehen für jeden gleich aus.
+Schlussendlich werden wir einen genaueren Blick auf die Dinge werfen, die wir bisher **statische Dateien** genannt haben. Statische Dateien sind alle deine CSS- und Bilddateien. Ihr Inhalt hängt nicht vom Requestkontext ab sondern gilt für alle Benutzer gleichermassen.
 
 ### Wohin kommen die statischen Dateien für Django
 
-Wie du gesehen hast, als wir `collectstatic` auf dem Server ausgeführt haben, weiß Django bereits, wo die statischen Dateien für die eingebaute `admin`-App zu finden sind. Nun müssen wir nur ein paar statische Dateien für unsere eigene App, `blog`, hinzufügen.
+Django weiss schon wo die statischen Dateien für die integrierte "admin" App zu finden sind. Wir müssen nur noch die statischen Dateien für unsere `blog` App hinzufügen.
 
 Dies tun wir, indem wir einen Ordner namens `static` in der Blog-App erstellen:
 
-```
-djangogirls
-├── blog
-│   ├── migrations
-│   └── static
-└── mysite
-```
+    djangogirls
+    ├── blog
+    |     ├── migrationen
+    |     ├── statisch
+    |     └── vorlagen
+    └── meineseite
+    
 
-Django findet automatisch alle Ordner mit dem Namen "static" in allen Ordnern unserer Apps und ist in der Lage, ihre Inhalte als statische Dateien zu nutzen.
+Django findet automatisch jede datei mit dem namen "static" in jeder ihrer apps ordner. Danach wird er in der lage sein ihr Inhalt als statische dateien zu benutzen.
 
 ## Deine erste CSS-Datei!
 
-Nun erstellen wir eine CSS-Datei, um deiner Website deinen eigenen Stil zu verleihen. Erstelle ein neues Verzeichnis namens `css` in deinem `static`-Verzeichnis. Dann erstelle eine neue Datei namens `blog.css` in diesem `css`-Verzeichnis. Fertig?
+Lassen Sie uns jetzt eine CSS-Datei erstellen, um einen eigenen Stil zu Ihrer Webseite hinzuzufügen. Erstelle ein neues Verzeichnis namens `css` in deinem `static`-Verzeichnis. Dann erstelle eine neue Datei namens `blog.css` in diesem `css`-Verzeichnis. Fertig?
 
-```
-djangogirls
-└─── blog
-     └─── static
-          └─── css
-               └─── blog.css
-```
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
 
-Zeit, ein wenig CSS zu schreiben! Öffne die `blog/static/css/blog.css` Datei in einem Code-Editor.
+Zeit ein wenig CSS zu schreiben! Öffne die `blog/static/css/blog.css` Datei in Deinem Code-Editor.
 
-Wir werden an dieser Stelle nicht weiter auf das Anpassen und Erlernen von CSS eingehen, weil es ziemlich einfach ist und du es nach dem Workshop selbst erlernen kannst. Wir empfehlen diesen [Codeacademy HTML- & CSS-Kurs](http://www.codecademy.com/tracks/web), um alles zu erlernen, was du wissen musst, um deine Website mit CSS noch hübscher zu machen.
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
 
-Aber lass uns wenigstens etwas Kleines probieren. Beispielsweise könnten wir die Farbe unserer Kopfzeile ändern. Computer benutzen spezielle Codes, um Farben zu verstehen. Ein solcher (hexadezimal) Code beginnt mit einer `#`, gefolgt von 6 Buchstaben (A-F) und Zahlen (0-9). Beispiele für solche Farbcodes findest du hier: http://www.colorpicker.com/. Du kannst auch [vordefinierte Farben](http://www.w3schools.com/cssref/css_colornames.asp) wie `red` und `green` benutzen.
+Aber lass uns wenigstens etwas Kleines probieren. Beispielsweise könnten wir die Farbe unserer Kopfzeile ändern. Computer benutzen spezielle Codes, um Farben zu verstehen. Diese Codes beginnen mit `#` gefolgt von 6 Buchstaben (A-F) und nummern (0-9). Blau zum Beispiel ist `#0000FF`. Beispiele für solche Farbcodes findest Du hier: http://www.colorpicker.com/. Du kannst auch [vordefinierte Farben](http://www.w3schools.com/colors/colors_names.asp) wie `red` und `green` benutzen.
 
 In deiner `blog/static/css/blog.css` Datei änderst du den folgenden Code:
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 h1 a {
-    color: #FCA205;
+color: #FCA205;
 }
 ```
 
-`h1 a` ist ein CSS-Selektor. Das bedeutet, dass wir jedem `a`-Element innerhalb eines `h1`-Elements unsere Stilvorgaben zuordnen (z. B. wenn wir in unserem Code so etwas wie `<h1><a href="">link</a></h1>` haben). In diesem Fall sagen wir, dass es seine Farbe in `#FCA205` ändern soll, was für Orange steht. Du kannst hier natürlich deine eigene Farbe angeben!
+`h1 a` ist ein CSS-Selektor. Das bedeutet, sass wir unsere Styles auf alle `a` Elemente innerhalb von einem `h1` Element anwenden. Also wenn wir so etwas wie `<h1><a href="">link</a></h1>`, der `h1 a` stil wird gelten. In diesem Fall sagen wir, dass es seine Farbe in `#FCA205` ändern soll, was für Orange steht. Du kannst hier natürlich deine eigene Farbe angeben!
 
-In einer CSS-Datei werden Stile für Elemente der HTML-Datei festgelegt. Die Elemente werden durch den Elementnamen (in der Regel `a`, `h1`, `body`), das Attribut `class` oder das Attribut `id` bestimmt. Klassen (`class`) und IDs (`id`) sind Namen, die du den Elementen selbst gibst. Klassen definieren dabei Gruppen von Elementen und IDs verweisen auf bestimmte Elemente. Beispielsweise kann das folgende HTML-Tag von CSS mittels des Tag-Namens `a`, der Klasse `external_link` oder der ID `link_to_wiki_page` identifiziert werden:
+In einer CSS-Datei werden Stile für Elemente der HTML-Datei festgelegt. Ein Weg HTML-Elemente zu identifizieren ist der Name des Elements. Du erinnerst dich vielleicht an diese Namen als 'Tags' aus dem HTML Kapitel. Zum Beispiel sind `a`, `h1` und `body` solche Elementnamen. Wir identifizieren Elemente auch über die Attribute `class` oder `id`. Klassen (`class`) und IDs (`id`) sind Namen, die du den Elementen selbst gibst. Klassen definieren dabei Gruppen von Elementen und IDs verweisen auf bestimmte Elemente. Du könntest zum Beispiel den folgenden Tag anhand des Elementnamen `a`, der Klasse `external_link` oder der Id `link_to_wiki_page` identifizieren:
 
 ```html
 <a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
-```    
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
 
-[Auf w3schools](http://www.w3schools.com/cssref/css_selectors.asp) erfährst du mehr über CSS-Selektoren.
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
 
-Dann musst du auch deiner HTML-Vorlage sagen, dass wir CSS aus einer externen Datei laden wollen. Öffne dazu die Datei `blog/templates/blog/post_list.html` und füge folgende Zeile ganz am Anfang der Datei an:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
 ```
 
-Hier laden wir nur statische Dateien :). Dann fügst du zwischen `<head>` und `</head>`, nach dem Link auf die Bootstrap-CSS-Dateien die folgenden Zeilen an (Der Browser liest die Dateien in der Reihenfolge, wie sie angegeben sind, ein, so dass dein CSS möglicherweise den Code in den Bootstrap-Dateien überschreibt.):
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
 
-```html 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
 <link rel="stylesheet" href="{% static 'css/blog.css' %}">
 ```
 
-Wir haben unserer Vorlage gerade gesagt, wo sich die CSS-Datei befindet.
+Der Browser liest die Dateien in der Reihenfolge in der sie im File stehen. Darum müssen wir sicherstellen, dass die Zeile am richtigen Ort steht. Otherwise the code in our file may be overriden by code in Bootstrap files. Wir haben unserer Vorlage gerade gesagt, wo sich die CSS-Datei befindet.
 
 Deine Datei sollte jetzt so aussehen:
 
-```html 
-{% load staticfiles %} 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
 <html>
     <head>
         <title>Django Girls blog</title>
@@ -132,29 +141,35 @@ OK, speicher die Datei und lade die Seite neu!
 
 Gut gemacht! Vielleicht wollen wir unserer Webseite etwas mehr Luft geben, indem wir den Abstand auf der linken Seite vergrößern? Probieren wir es aus!
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
-body {     
-    padding-left: 15px; 
+body {
+    padding-left: 15px;
 }
 ```
 
-Füge dies zu deinem CSS hinzu, speicher die Datei und guck dir die Veränderung an!
+Add that to your CSS, save the file and see how it works!
 
 ![Abbildung 14.3](images/margin2.png)
 
 Vielleicht können wir auch die Schrift in unserem HTML-Kopf anpassen? Füge dies zu `<head>` in `blog/templates/blog/post_list.html` hinzu:
 
-```html 
-<link href="http://fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
 ```
 
-Diese Zeile importiert die Schriftart *Lobster* von Google Fonts (https://www.google.com/fonts).
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
 
-Nun füge die Zeile `font-family: 'Lobster';` in die CSS-Datei `blog/static/css/blog.css` ein. Sie gehört in den `h1 a` Deklaration-Block (der Code zwischen den Klammern `{` und `}`) und lade die Seite neu:
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 h1 a {
-    color: #FCA204;
+    color: #FCA205;
     font-family: 'Lobster';
 }
 ```
@@ -163,104 +178,69 @@ h1 a {
 
 Super!
 
-CSS hat - wie schon gesagt - ein Klassen-Konzept. Das erlaubt dir, Teile des HTML-Codes mit Namen zu versehen und die Stile (Styles) nur auf diese Teile anzuwenden. Die anderen Teile bleiben davon unberührt. Das ist sehr hilfreich, wenn du z.B. zwei div-Container hast, die ganz verschiedene Sachen bewirken sollen, einer für die Kopfzeile, einer für den Inhalt. Sie sollen dann ja nicht gleich aussehen.
+Wie oben erwähnt basiert CSS auf dem Konzept von Klassen. Dies erlaubt Dir einen Teil des HTML Codes mit einem Namen zu versehen und nur für diesen Teil einen Stil hinzuzufügen ohne Auswirkungen auf andere Teile des Codes. Dies kann sehr hilfreich sein! Eventuell hast Du zwei divs die etwas vollkommen Verschiedenes auszeichnen (wie einen Seitentitel oder Post Beitrag). Die Klasse hilft dir sie unterschiedlich aussehen zu lassen.
 
 Im nächsten Schritt werden wir den HTML-Code einteilen. Füge eine Klasse (class) names `page-header` dem `div` hinzu, der die Kopfzeilen (header) enthalten soll:
 
-```html 
-<div class="page-header">     
-    <h1><a href="/">Django Girls Blog</a></h1> 
-</div>
-```
-Jetzt fügen wir noch eine Klasse `post` für den Blog-Inhalt (Post) dem `div` hinzu.
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-```html 
-<div class="post">     
-    <p>published: {{ post.published_date }}</p>     
-    <h1><a href="">{{ post.title }}</a></h1>     
-    <p>{{ post.text|linebreaks }}</p> 
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
 </div>
 ```
 
-Gemäß der Änderungen im HTML erweitern wir unser CSS mit entsprechenden Selektoren. Selektoren, die mit `.` anfangen, beziehen sich auf Klassen im HTML. Wenn du dich weiter mit dem folgenden CSS-Code auseinandersetzen willst, helfen dir die zahlreichen Anleitungen im Internet weiter. Für den Anfang reicht es aus, folgenden Text in deine `blog/static/css/blog.css`-Datei zu kopieren:
-
-```css
-.page-header {
-    background-color: #ff9400;
-    margin-top: 0;
-    padding: 20px 20px 20px 40px;
-}
-
-.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
-    color: #ffffff;
-    font-size: 36pt;
-    text-decoration: none;
-}
-
-.content {
-    margin-left: 40px;
-}
-
-h1, h2, h3, h4 {
-    font-family: 'Lobster', cursive;
-}
-
-.date {
-    float: right;
-    color: #828282;
-}
+Jetzt fügen wir noch eine Klasse `post` für den Blog-Inhalt (Post) dem `div` hinzu.
 
-.save {
-    float: right;
-}
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-.post-form textarea, .post-form input {
-    width: 100%;
-}
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
 
-.top-menu, .top-menu:hover, .top-menu:visited {
-    color: #ffffff;
-    float: right;        
-    font-size: 26pt;
-    margin-right: 20px;
-}
+Gemäß der Änderungen im HTML erweitern wir unser CSS mit entsprechenden Selektoren. Selektoren, die mit `.` anfangen, beziehen sich auf Klassen im HTML. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. Für den Anfang reicht es aus, folgenden Text in deine `blog/static/css/blog.css`-Datei zu kopieren:
 
-.post {
-    margin-bottom: 70px;
-}
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
-.post h1 a, .post h1 a:visited {
-    color: #000000;
-}
+```css
+.page-header {     background-color: #ff9400;     margin-top: 0;     padding: 20px 20px 20px 40px; } .page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {     color: #ffffff;     font-size: 36pt;     text-decoration: none; } .content {     margin-left: 40px; } h1, h2, h3, h4 {     font-family: 'Lobster', cursive; } .date {     color: #828282; } .save {     float: right; } .post-form textarea, .post-form input {     width: 100%; } .top-menu, .top-menu:hover, .top-menu:visited {     color: #ffffff;     float: right;     font-size: 26pt;     margin-right: 20px; } .post {     margin-bottom: 70px; } .post h1 a, .post h1 a:visited {     color: #000000; }
 ```
 
 Der HTML-Code, der für die Anzeige der Blogposts verantwortlich ist, soll durch Klassen erweitert werden. Ersetze den folgenden Code:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
-<div class="post">
-    <p>published: {{ post.published_date }}</p>
-    <h1><a href="">{{ post.title }}</a></h1>
-    <p>{{ post.text|linebreaks }}</p>
-</div>
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endfor %}
 ```
 
 in `blog/templates/blog/post_list.html` durch diesen:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="content container">
     <div class="row">
         <div class="col-md-8">
-        {% for post in posts %}
-            <div class="post">
-                <div class="date">
-                    {{ post.published_date }}
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
                 </div>
-                <h1><a href="">{{ post.title }}</a></h1>
-                <p>{{ post.text|linebreaks }}</p>
-            </div>
-        {% endfor %}
+            {% endfor %}
         </div>
     </div>
 </div>
@@ -269,11 +249,11 @@ in `blog/templates/blog/post_list.html` durch diesen:
 Speichere die geänderten Dateien und aktualisiere die Webseite.
 
 ![Abbildung 14.4](images/final.png)
- 
-Und?! Sieht viel besser aus, oder!? Der verwendete Code ist nicht allzu schwer zu verstehen. Wenn du ihn liest, sollte schon fast alles klar sein.
 
-Ändere ruhig das eine oder andere im CSS und probiere ein paar Sachen aus. Geht etwas kaputt, mach deine Änderungen im Editor rückgängig und starte von vorn.
+Juhuu! Sieht super aus, oder? Schau dir den Code an den wir gerade eingefügt haben. Da siehst du wo wir überall Klassen zu den HTML Objekten hinzugefügt haben um sie in CSS zu referenzieren. Wo würdest du eine Änderung machen um das Datum in Türkis anzuzeigen?
+
+Hab keine Angst, etwas mit dieser CSS Datei herumzuspielen und versuche ein paar Dinge zu ändern. Mit CSS herumzuspielen kann dir helfen zu verstehen was die verschiedenen Dinge genau machen. Mach dir keine Sorgen wenn etwas kaputt geht, du kannst deine Änderungen immer rückgängig machen!
 
-Wir empfehlen den freien Online-Kurs [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web) als Hausaufgabe. So kannst du alles lernen, was du über das Verschönern von Webseiten mit CSS wissen willst.
+Wir empfehlen diesen kostenlosen [Codeacademy HTML & CSS Kurs](https://www.codecademy.com/tracks/web). Er wird dir helfen deine Webseiten mit CSS schöner zu gestalten.
 
-Bereit für das nächste Kapitel? :)
+Bereit für das nächste Kapitel? :)
\ No newline at end of file
diff --git a/de/deploy/README.md b/de/deploy/README.md
index b383e1d939f..1ee02245419 100644
--- a/de/deploy/README.md
+++ b/de/deploy/README.md
@@ -2,285 +2,234 @@
 
 > **Hinweis:** Durch das folgende Kapitel muss man sich manchmal durchbeißen. Bleib dran und gib nicht auf; die Website zu veröffentlichen ist ein sehr wichtiger Schritt. Dieses Kapitel ist in der Mitte des Tutorials platziert, damit dir dein Mentor mit dem etwas anspruchsvolleren Vorgang der Veröffentlichung deiner Website helfen kann. Den Rest des Tutorials kannst du dann auch alleine beenden, sollte die Zeit nicht ausreichen.
 
-Bis jetzt lief die Website nur auf deinem Computer, jetzt wollen wir sie veröffentlichen! Auf Englisch sagt man dazu deploy. Deployen bedeutet, dass du deine Anwendung im Internet veröffentlichst, so dass endlich jeder darauf zugreifen kann :).
+Bis jetzt war deine Webseite nur auf deinem Computer verfügbar. Jetzt wirst du lernen wie du sie 'deployst'! Deployen bedeutet, dass du deine Anwendung im Internet veröffentlichst, so dass endlich jeder darauf zugreifen kann. :)
 
-Wie du schon gelernt hast, muss eine Webseite auf einem Server liegen. Es sind eine Menge Server-Anbieter im Internet verfügbar. Wir werden einen verwenden, der einen relativ einfachen Veröffentlichungsprozess (deployment process) hat: [PythonAnywhere](http://pythonanywhere.com/). PythonAnywhere ist kostenlos für kleine Anwendungen, die nicht von vielen Besuchern aufgerufen werden. Also erstmal genau das Richtige für dich.
+Wie du schon gelernt hast, muss eine Webseite auf einem Server liegen. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
-Als weiteren externen Dienst werden wir [GitHub](http://www.github.com) nutzen, einen "Code Hosting"-Dienst. Es gibt noch andere solcher Dienste, aber die meisten Programmierer haben heute ein Konto bei GitHub, und du gleich auch!
-
-GitHub wird unsere Basis für die Übertragung unseres Code von und nach PythonAnywhere sein.
+Als weiteren externen Dienst werden wir [GitHub](https://www.github.com) nutzen, einen "Code Hosting"-Dienst. Es gibt noch andere solcher Dienste, aber die meisten Programmierer haben heute ein Konto bei GitHub, und du gleich auch!
 
+Diese drei Orte werden für dich wichtig sein. Die Entwicklung und das Testing wirst du auf deinem lokalen Rechner durchführen. Wenn du mit deinen Änderungen zufrieden bist, wirst du eine Kopie deines Programms auf GitHub veröffentlichen. Deine Website wird auf PythonAnywhere gehostet werden. Ändern kannst du sie, indem du eine neue Version deines Codes von GitHub herunter lädst.
 
 # Git
 
-Git ist ein "Versionsverwaltungssystem", das von vielen Programmierern benutzt wird. Diese Software kann Änderungen an Dateien über die Zeit verfolgen, so dass du bestimmte Versionen im Nachhinein wieder aufrufen kannst. Ein bisschen wie die "Track Changes" Funktion in Microsoft Word, aber viel leistungsfähiger.
-
-## Git installieren
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
 
-> **Hinweis:** Falls du die Installationsschritte bereits durchgeführt hast, kannst du mit dem nächsten Abschnitt fortfahren und anfangen, dein Git-Repository zu erstellen.
-
-{% include "/code_editor/instructions.md" %}
+{% include "/deploy/install_git.md" %}
 
 ## Unser Git-Repository
 
-Git verwaltet die Veränderungen an einer Sammlung von Dateien in einem sogenannten Repository (oder kurz "Repo"). Wir legen eins für unser Projekt an. Öffne deine Konsole und gibt folgende Kommandos im `djangogirls`-Verzeichnis ein:
-
-> **Hinweis:** Überprüfe dein aktuelles Arbeitsverzeichnis mit dem Befehl `pwd` (OSX/Linux) oder `cd` (Windows) bevor du das Repository initialisierst. Du musst dich im `djangogirls`-Verzeichnis befinden, bevor du fortfährst.
+Git verwaltet die Veränderungen an einer Sammlung von Dateien in einem sogenannten Repository (oder kurz "Repo"). Legen wir eines für unser Projekt an. Öffne deine Konsole und gibt folgende Kommandos im `djangogirls`-Verzeichnis ein:
 
-```
-$ git init 
-Initialized empty Git repository in ~/djangogirls/.git/ 
-$ git config --global user.name "Dein Name" 
-$ git config --global user.email du@beispiel.com
-```
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. Du musst dich im `djangogirls`-Verzeichnis befinden, bevor du fortfährst.
 
-Die Initialisierung eines Git-Repository müssen wir nur einmal pro Projekt machen (und du musst nicht noch einmal Deinen Benutzernamen und E-Mail-Adresse eingeben).
+{% filename %}command-line{% endfilename %}
 
-Git wird die Änderungen an all den Dateien und Ordnern in diesem Verzeichnis aufzeichnen. Wir wollen aber, dass einige Dateien ignoriert werden. Dazu legen wir eine Datei `.gitignore` im Basisverzeichnis des Repos an. Öffne deinen Editor und erstelle eine neue Datei mit dem folgenden Inhalt:
+    $ git init 
+    Initialized empty Git repository in ~/djangogirls/.git/ 
+    $ git config --global user.name "Dein Name" 
+    $ git config --global user.email du@beispiel.com
+    
 
-```
-*.pyc
-__pycache__
-myvenv
-db.sqlite3
-.DS_Store
-```
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
 
-Speichere die Datei mit dem Namen `.gitignore` im "djangogirls"-Verzeichnis.
+Git wird die Änderungen an all den Dateien und Ordnern in diesem Verzeichnis aufzeichnen. Wir wollen aber, dass einige Dateien ignoriert werden. Dazu legen wir eine Datei `.gitignore` im Basisverzeichnis des Repos an. Öffne deinen Editor und erstelle eine neue Datei mit dem folgenden Inhalt:
 
-> **Hinweis:** Der Punkt vor dem Dateinamen ist wichtig! Wenn du Schwierigkeiten beim Erstellen hast (z.B. lassen Macs im Finder keine Dateien mit Punkt am Anfang erzeugen, Punkt-Dateien sind auf Linux und OS X "versteckte Dateien"), dann verwende die "Speichern unter"-Funktion im Editor, das sollte immer funktionieren.
+{% filename %}.gitignore{% endfilename %}
 
-Es ist hilfreich den Befehl `git status` vor `git add` auszuführen oder immer dann, wenn du dir unsicher bist, was geändert wurde. Das schützt vor manchen Überraschungen, wie z. B. das falsche Hinzufügen oder Übertragen von Dateien. Das `git status`-Kommando gibt Informationen über unbeobachtete/veränderte/hinzugefügte Dateien, den Verzweigungsstatus und einiges mehr wieder. Die Ausgabe sollte so oder so ähnlich sein:
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
 
-```
-$ git status 
-On branch master 
+And save it as `.gitignore` in the "djangogirls" folder.
 
-Initial commit 
+> **Hinweis:** Der Punkt vor dem Dateinamen ist wichtig! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
 
-Untracked files:
-    (use "git add <file>..." to include in what will be committed) 
+Es ist hilfreich den Befehl `git status` vor `git add` auszuführen oder immer dann, wenn du dir unsicher bist, was geändert wurde. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. Deine Ausgabe sollte dem hier ähneln:
 
-        .gitignore
-        blog/
-        manage.py
-        mysite/ 
+{% filename %}command-line{% endfilename %}
 
-nothing added to commit but untracked files present (use "git add" to track)
-```
+    $ git status 
+    On branch master 
+    
+    Initial commit 
+    
+    Untracked files:
+       (use "git add <file>..." to include in what will be committed) 
+    
+            .gitignore
+             blog/
+             manage.py
+             mysite/ 
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
 
 Nun speichern wir unsere Änderungen durch folgende Eingabe in der Konsole:
 
-```
-$ git add -A .
-$ git commit -m "Meine Django Girls App, erster Commit"
- [...]
- 13 files changed, 200 insertions(+)
- create mode 100644 .gitignore
- [...]
- create mode 100644 mysite/wsgi.py
-```
-
-## Den Code auf GitHub veröffentlichen
-
-Öffne [GitHub.com](https://www.github.com) und registriere dich für ein neues, kostenloses Benutzerkonto. (Wenn du das bereits in deiner Vorbereitung auf den Workshop getan hast, dann ist das großartig!)
+{% filename %}command-line{% endfilename %}
 
-Erstelle dann ein neues Repository und gib ihm den Namen "my-first-blog". Lass das Kontrollkästchen "initialise with a README" deaktiviert, die Einstellung der Option .gitignore frei (das haben wir schon von Hand gemacht) und lass die Lizenz auf "None".
-
-![](images/new_github_repo.png)
-
-
-> **Achtung:** Der Name `my-first-blog` ist wichtig -- du kannst auch einen anderen wählen, aber er wird im Folgenden noch sehr oft vorkommen und du wirst immer daran denken müssen, ihn in den Anweisungen entsprechend anzupassen. Lass es besser erst mal bei `my-first-blog`.
-
-Auf der nächsten Seite wird dir die Clone-URL des Repos angezeigt. Nimm die HTTPS-Variante, kopiere sie und füge sie in der Konsole ein:
-
-![](images/github_get_repo_url_screenshot.png)
-
-Nun müssen wir das Git-Repository auf deinem Computer mit dem auf GitHub verbinden.
-
-Gib Folgendes in deine Konsole ein (Ersetze dabei `<your-github-username>` durch deinen Benutzernamen, den du bei der Erstellung deines GitHub-Kontos benutzt hast, aber ohne die eckigen Klammern.):
-
-```
-$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
-$ git push -u origin master
-``` 
-
-Gibt deinen GitHub-Benutzernamen und dein Passwort ein und du solltest etwas Ähnliches wie das hier sehen:
-
-```
-Username for 'https://github.com': hjwp
-Password for 'https://hjwp@github.com':
-Counting objects: 6, done.
-Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
-Total 3 (delta 0), reused 0 (delta 0)
-To https://github.com/hjwp/my-first-blog.git
- * [new branch]      master -> master
-Branch master set up to track remote branch master from origin.
-```
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
 
-<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extention -->
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
 
-Dein Code ist jetzt auf GitHub. Schau gleich mal nach! Dort ist dein Code du in guter Gesellschaft - [Django](https://github.com/django/django), das [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial) und viele andere großartige Open Source Software-Projekte haben ihren Code auf GitHub :)
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
 
-# Deinen Blog auf PythonAnywhere einrichten
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
 
-> **Hinweis:** Es ist möglich, dass du bereits ein PythonAnywhere Konto angelegt hast. Wenn ja, dann brauchst du das nicht noch einmal zu tun.
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
 
-{% include "/deploy/signup_pythonanywhere.md" %}
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Schau gleich mal nach!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Lass uns den Code von GitHub auf PythonAnywhere übertragen, indem wir einen "Klon" unseres Repositorys erzeugen. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-## Den Code nach PythonAnywhere übertragen
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
 
-Sobald du dich für PythonAnywhere angemeldet hast, wirst du zu deinem Dashboard bzw. deiner "Konsole" weitergeleitet. Wähle die Option zum Starten einer "Bash", das ist die PythonAnywhere-Version einer Konsole, genau wie die auf deinem Computer.
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-> **Hinweis:** PythonAnywhere basiert auf Linux. Wenn du Windows benutzt, dann sieht die Konsole etwas anders aus als die Konsole auf deinem Computer.
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
 
-Lass uns den Code von GitHub auf PythonAnywhere übertragen, indem wir einen "Klon" unseres Repositorys erzeugen. Tippe das Folgende in die Konsole auf PythonAnywhere (vergiss nicht deinen GitHub-Benutzernamen an Stelle von `<your-github-username>` zu benutzen):
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-```
-$ git clone https://github.com/<your-github-username>/my-first-blog.git
-```
-
-Dies wird eine Kopie deines Codes auf PythonAnywhere übertragen. Überprüfe es, indem du eingibst `tree my-first-blog`:
-
-```
-$ tree my-first-blog
-my-first-blog/
-├── blog
-│   ├── __init__.py
-│   ├── admin.py
-│   ├── migrations
-│   │   ├── 0001_initial.py
-│   │   └── __init__.py
-│   ├── models.py
-│   ├── tests.py
-│   └── views.py
-├── manage.py
-└── mysite
-    ├── __init__.py
-    ├── settings.py
-    ├── urls.py
-    └── wsgi.py
-```
-
-### Erstelle ein virtualenv auf PythonAnywhere
-
-Genauso wie du auf deinem eigenen Computer ein virtualenv erstellt hast, kannst du auch eins auf PythonAnywhere erstellen. Schreibe Folgendes in die Bash:
-
-```
 $ cd my-first-blog
 
-$ virtualenv --python=python3.5 myvenv
-Running virtualenv with interpreter /usr/bin/python3.5
-[...]
-Installing setuptools, pip...done.
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
 
 $ source myvenv/bin/activate
 
-(myvenv) $  pip install django~=1.10.0
-Collecting django
-[...]
-Successfully installed django-1.10.4
-```
-
-> **Hinweis:** Der Schritt `pip install` kann ein paar Minuten dauern. Hab etwas Geduld! Aber, wenn es länger als 5 Minuten dauern sollte, dann ist etwas falsch gelaufen. Frag am besten deinen Coach.
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
 
-<!--TODO: think about using requirements.txt instead of pip install.-->
-
-<!-- ### Statische Dateien einsammeln
-
-Hast du dich gefragt, was die "whitenoise" Sache war? Es ist ein Werkzeug, um so genannte "statische Dateien" zu betreuen. Statische Dateien, wie z. B. HTML oder CSS Dateien, sind Daten, welche sich nicht regelmäßig verändern oder Programmcode ausführen. Sie funktionieren anders auf Servern als auf unseren eigenen Computern und wir brauchen ein Werkzeug wie "whitenoise", um sie zu betreuen.
-
-Wir werden später im Tutorial ein wenig mehr über statische Dateien erfahren, wenn wir das CSS für unsere Seite bearbeiten.
-
-Für`s Erste müssen wir nur ein extra Kommando auf dem Server ausführen, genannt `collectstatic`. Es befiehlt Django, alle statischen Dateien, die es auf dem Server braucht, einzusammeln. Im Moment sind dies hauptsächlich Dateien, welche die Admin Site hübsch aussehen lassen.
-
-```
-(mvenv) $ python manage.py collectstatic
-
-You have requested to collect static files at the destination
-location as specified in your settings:
-
-    /home/edith/my-first-blog/static
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
     
-This will overwrite existing files!
-Are you sure you want to do this?
-
-Type 'yes' to continue, or 'no' to cancel: yes
-```
-
-Tippe "yes" ein und es verschwindet! Liebst du es nicht auch, Computer dazu zu bringen, Seiten über Seiten von undurchdringbaren Text auszugeben? Ich mache immer kleine Geräusche, um das zu begleiten. Brp, brp brp...
-
-```
-Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/actions.min.js'
-Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/inlines.min.js'
-[...]
-Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/changelists.css'
-Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/base.css'
-62 static files copied to '/home/edith/my-first-blog/static'.
-``` -->
-
-### Erstellen einer Datenbank auf PythonAnywhere
-
-Hier ist ein weiterer Unterschied zwischen deinem Computer und einem Server: unterschiedliche Datenbanken werden benutzt. Dadurch können sich Benutzerkonten und Posts auf dem Server und auf deinem Computer unterscheiden.
-
-Wir initialisieren die Datenbank auf dem Server genauso, wie wir es auf deinen Computer mit `migrate` und `createsuperuser` gemacht haben:
-
-```
-(mvenv) $ python manage.py migrate 
-Operations to perform: 
-[...]
-    Applying sessions.0001_initial... OK 
-
-
-(mvenv) $ python manage.py createsuperuser
-```
-
-## Veröffentlichen unseres Blogs als Web-App
-
-Jetzt ist unser Code auf PythonAnywhere, unser virtualenv ist bereit, die statischen Dateien sind gesammelt und die Datenbank ist initialisiert. Wir sind bereit es als Web-App zu veröffentlichen!
-
-Gehe zurück zum PythonAnywhere Dashboard, indem du auf das Logo klickst und klicke anschließend auf den **Web** Menüpunkt. Dort wählst du **Add a new web app** aus.
-
-Nach der Bestätigung deines Domainnamens wählst du **manual configuration** (NB *nicht* die "Django"-Option) im Dialogfeld aus. Entscheide dich als Nächstes für **Python 3.4** und klicke "Next", um den Assistenten zu beenden.
-
-> **Hinweis:** Versichere dich, dass du die Option "Manual configuration" ausgewählt hast und nicht "Django". Wir sind einfach zu cool für das Standard PythonAnywhere Django Setup :-)
-
-### Angeben des Virtualenv
-
-Du wirst auf den PythonAnywhere-Konfigurationsschirm für deine Web-App weitergeleitet. Dorthin musst du immer gehen, wenn du Änderungen an deiner App auf dem Server vornehmen willst.
-
-![](images/pythonanywhere_web_tab_virtualenv.png)
-
-In der "Virtualenv"-Sektion, klicke auf den roten Text, welcher sagt: "Enter the path to a virtualenv" und gieb ein: `/home/<your-username>/my-first-blog/myvenv/`. Klicke auf die blaue Box mit dem Häkchen, um den Pfad zu speichern, bevor es weitergeht.
-
-> **Hinweis:** Ersetze deinen eigenen Benutzernamen soweit erforderlich. Falls du einen Fehler machst, wird dir PythonAnywhere eine kleine Warnung anzeigen.
-
-### Konfigurieren der WSGI-Datei
-
-Django funktioniert durch Verwendung des "WSGI Protokolls", ein Standard für Python-Webseiten, der von PythonAnywhere unterstützt wird. Um PythonAnywhere so zu konfigurieren, dass es unseren Django-Blog erkennt, editieren wir eine WSGI-Konfigurationsdatei.
-
-Klicke auf den "WSGI configuration file"-Link (in der "Code"-Sektion im oberen Teil der Seite -- es sollte ungefähr so benannt sein `/var/www/<your-username>_pythonanywhere_com_wsgi.py`) und du wirst zu einem Editor geführt.
-
-Lösche alle Inhalte und ersetze sie durch:
-
-```python
-import os
-import sys
-
-path = os.path.expanduser('~/my-first-blog')
-if path not in sys.path:
-    sys.path.append(path)
 
-os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
 
-from django.core.wsgi import get_wsgi_application
-from django.contrib.staticfiles.handlers import StaticFilesHandler
-application = StaticFilesHandler(get_wsgi_application())
-```
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
 
-> **Hinweis:** Vergiss nicht deinen Benutzernamen an der Stelle `<your-username>` einzusetzen
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
 
-Die Aufgabe dieser Datei ist es, PythonAnywhere zu sagen, wo unsere Web-App lebt und wie der Django Einstellungsdateiname ist. Es richtet außerdem das "whitenoise" Werkzeug für statische Dateien ein.
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. Wir werden später im Tutorial ein wenig mehr über statische Dateien erfahren, wenn wir das CSS für unsere Seite bearbeiten.
 
 Klicke auf **Save** und gehe dann zu dem **Web**-Tab zurück.
 
@@ -290,21 +239,22 @@ Wir sind fertig! Drücke auf den großen, grünen **Reload**-Knopf und du kannst
 
 Falls du beim Versuch deine Seite zu besuchen, einen Fehler siehst, ist der erste Ort, an dem man nach Debugging-Infos schauen sollte, dein **error log**. Einen Link dazu findest du auf dem PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). Schau nach, ob Fehlermeldungen enthalten sind; die neuesten findest du unten. Häufige Probleme sind:
 
-*   Einen der Schritte vergessen, die wir in der Konsole erledigt haben: das virtualenv kreieren, es aktivieren, Django darin installieren, collectstatic auszuführen, die Datenbank zu migrieren.
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
 
-*   Einen Fehler in dem virutalenv-Pfad auf dem Web-Tab machen -- falls es ein Problem gibt, wird dann dort normalerweise eine kleine rote Fehlermeldung erscheinen.
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
 
-*   Einen Fehler in der WSGI-Konfigurationsdatei machen -- ist der Pfad zu deinem my-first-blog Ordner richtig?
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
 
-*   Hast du die selbe Pythonversion für dein virtualenv gewählt wie für deine Web-App? Beide sollten 3.4 sein.
+- Hast du die selbe Pythonversion für dein virtualenv gewählt wie für deine Web-App? Beide sollten 3.6 sein.
 
-*   Es gibt einige [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
 
 Und denk dran, dein Coach ist da, um dir zu helfen!
 
-
 # Du bist live!
 
-Die Standardseite für deine Site sollte "Welcome to Django" anzeigen, genauso wie auf deinem lokalen Computer. Versuch `/admin/` am Ende der URL hinzuzufügen und du gelangst zur Adminseite. Melde dich mit deinen Benutzernamen und Passwort an. Wie du siehst, kannst du neue Posts auf dem Server hinzufügen.
+The default page for your site should say "It worked!", just like it does on your local computer. Versuch `/admin/` am Ende der URL hinzuzufügen und du gelangst zur Adminseite. Melde dich mit deinen Benutzernamen und Passwort an. Wie du siehst, kannst du neue Posts auf dem Server hinzufügen.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Ziemlich cool, oder?
 
-Klopf dir *kräftig* auf die Schulter! Das Deployment ist eines der kompliziertesten Dinge der Web-Entwicklung und es dauert oftmals mehrere Tage, bis alles läuft. Aber du hast deine Site jetzt live, im echten Internet, einfach so!
+Klopf dir *kräftig* auf die Schulter! Das Deployment ist eines der kompliziertesten Dinge der Web-Entwicklung und es dauert oftmals mehrere Tage, bis alles läuft. Aber du hast deine Site jetzt live, im echten Internet, einfach so!
\ No newline at end of file
diff --git a/de/deploy/install_git.md b/de/deploy/install_git.md
index 3d8a8d77b4c..2203830d774 100644
--- a/de/deploy/install_git.md
+++ b/de/deploy/install_git.md
@@ -1,19 +1,52 @@
-### Windows
+Git ist ein "Versionsverwaltungssystem", das von vielen Programmierern benutzt wird. Diese Software kann Änderungen an Dateien über die Zeit verfolgen, so dass du bestimmte Versionen im Nachhinein wieder aufrufen kannst. Ein bisschen wie die "Track Changes" Funktion in Microsoft Word, aber viel leistungsfähiger.
 
-Du kannst Git von [git-scm.com](http://git-scm.com/) herunterladen. Du kannst immer "weiter" klicken - "next next next" - an allen bis auf einer Stelle; im 5. Schritt "Adjusting your PATH environment", nimm "Run Git and associated Unix tools from the Windows command-line" (die letzte Option). Die anderen Voreinstellungen sind ok. "Checkout"-Stil "Windows" und "Commit" mit "Unix line endings" (Zeilenende im Unix-Format) sind die richtigen Einstellungen.
+## Git installieren
 
-### OS X (Mac)
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
 
-Git von [git-scm.com](http://git-scm.com/) herunterladen und dann den Anweisungen folgen.
+Du kannst Git von [git-scm.com](https://git-scm.com/) herunterladen. You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Die anderen Voreinstellungen sind ok. "Checkout"-Stil "Windows" und "Commit" mit "Unix line endings" (Zeilenende im Unix-Format) sind die richtigen Einstellungen.
 
-### Linux
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
 
-Falls es noch nicht installiert sein sollte, sollte git als Paket im Paketmanager enthalten sein. Versuche je nach Distribution:
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Git von [git-scm.com](https://git-scm.com/) herunterladen und dann den Anweisungen folgen.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
 ```bash
-sudo apt-get install git
+$ sudo dnf install git
 ```
-    # oder
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
 ```bash
-sudo yum install git
+$ sudo zypper install git
 ```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/de/deploy/signup_pythonanywhere.md b/de/deploy/signup_pythonanywhere.md
index aada52a2cbf..ca66bd0de69 100644
--- a/de/deploy/signup_pythonanywhere.md
+++ b/de/deploy/signup_pythonanywhere.md
@@ -1,5 +1,5 @@
-Als Nächstes erstellst du ein kostenfreies "Beginner"-Konto auf PythonAnywhere.
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
 
-  * [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
 
-> **Beachte:** Wenn du dort deinen Benutzernamen aussuchst, dann denke daran, dass sich die URL zu deinem Blog folgendermaßen zusammensetzt: `deinbenutzername.pythonanywhere.com`. Wähle demnach deinen eigenen Nicknamen oder einen Namen, der deinen Blog umschreibt.
\ No newline at end of file
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/de/django/README.md b/de/django/README.md
index 80be5ea27f6..563c745bffa 100644
--- a/de/django/README.md
+++ b/de/django/README.md
@@ -1,26 +1,26 @@
 # Django - Was ist das?
 
-Django (*/ˈdʒæŋɡoʊ/ jang-goh*) ist ein freies, Open-Source Web-Anwendungs-Framework, geschrieben in Python. Ein Web-(Anwendungs-)Framework ist eine Art Baukastensystem, das dir mit vielen vorgefertigten Teilen die Entwicklung von Webseiten stark erleichtert.
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. Ein Web-(Anwendungs-)Framework ist eine Art Baukastensystem, das dir mit vielen vorgefertigten Teilen die Entwicklung von Webseiten stark erleichtert.
 
 Wenn du eine Website entwickelst, brauchst du immer wieder sehr ähnliche Elemente: Einen Weg Benutzer zu verwalten (Registrierung, Anmeldung, Abmeldung etc.), einen Administrationsbereich, Formulare, Upload von Dateien usw.
 
-Glücklicherweise wurde schon vor einiger Zeit erkannt, dass Web-Entwickler diese Probleme immer wieder zu lösen hatten und haben. Gemeinsam entstanden so verschiedene Frameworks (Django ist so eines), die die Web-Entwicklung durch vorgefertigte Elemente erleichtern.
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
 
-Frameworks sind da, damit du das Rad nicht neu erfinden musst. Du kannst dich auf die konkret zu erfüllenden Anforderungen der Webseite kümmern. Die grundlegende Basis der Webseite stellt dir das Framework zur Verfügung.
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
 
 ## Warum brauchst du ein Framework?
 
-Um besser zu verstehen, welchen Vorteil dir Django bietet, werfen wir einen Blick auf Server im Allgemeinen. Als Erstes muss der Server wissen, dass er eine Webseite ausliefern soll.
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
 
-Der Server hat mehrere "Ports", vergleichbar einem Briefkasten, der auf eingehende Briefe "Anfragen"/"requests" überwacht wird. Das macht der Webserver. Der Webserver liest die eingeworfenen Briefe (requests) und beantwortet sie mit der Webseite (response). Um etwas ausliefern zu können, brauchen wir Inhalte. Und Django hilft dir dabei, diese Inhalte zu erstellen.
+Der Server hat mehrere "Ports", vergleichbar einem Briefkasten, der auf eingehende Briefe "Anfragen"/"requests" überwacht wird. Das macht der Webserver. The web server reads the letter and then sends a response with a webpage. Um etwas ausliefern zu können, brauchen wir Inhalte. Und Django hilft dir dabei, diese Inhalte zu erstellen.
 
 ## Was passiert, wenn jemand eine Webseite beim Server anfordert?
 
-Wenn der request beim Web-Server ankommt, reicht dieser die Anfrage an Django weiter. Und Django versucht herauszufinden, welche Seite genau angefordert wurde. Django wertet zuerst die Adresse der Webseite aus und versucht herauszufinden, was geliefert werden soll. Dafür ist der **urlresolver** von Django verantwortlich. URL - Uniform Resource Locator ist ein anderer Name für die Web-Adresse, daher der Name *urlresolver*. Sehr schlau ist er aber nicht. Er hat eine Musterliste und vergleicht diese mit der URL. Der Vergleich der Muster erfolgt von oben nach unten. Wenn ein Muster auf die URL zutrifft, wird der damit verknüpften Funktion (der sogenannten *view*) der request/die Anfrage übergeben).
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
 
 Stell dir eine Postbotin mit einem Brief vor. Sie geht die Straße entlang und prüft jede Hausnummer mit der Adresse auf dem Brief. Wenn beide passen, dann steckt sie den Brief in den Briefkasten. So funktioniert der urlresolver!
 
-In der *view* Funktion passieren all die interessanten Dinge: wir können in eine Datenbank gucken und dort nach Informationen suchen. Vielleicht wollte die Benutzerin irgendetwas in den Daten ändern? So, als ob der Brief sagen würde: "Bitte ändere meine Stellenbeschreibung!" Die Funktion *view* kann nun prüfen, ob du dazu berechtigt bist, im positiven Fall die Änderungen durchführen und im Anschluss eine Nachricht zurücksenden. Die *view* erzeugt eine Antwort und Django sendet diese an den Browser zurück, wo sie dargestellt wird.
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Vielleicht wollte die Benutzerin irgendetwas in den Daten ändern? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
 
 Natürlich, ist die Beschreibung oben ein wenig vereinfacht, aber du musst noch nicht all die technischen Details wissen. Eine generelle Vorstellung zu haben, reicht erstmal.
 
diff --git a/de/django_admin/README.md b/de/django_admin/README.md
index cec1f84a41f..35f18a49f5a 100644
--- a/de/django_admin/README.md
+++ b/de/django_admin/README.md
@@ -1,8 +1,10 @@
 # Django Administration
 
-Zum Hinzufügen, Bearbeiten und Löschen von Blogposts benutzen wir den Django Admin, das eingebaute Administrations-Backend von Django.
+To add, edit and delete the posts we've just modeled, we will use Django admin.
 
-Öffne die Datei `blog/admin.py` und ersetze den Inhalt wie folgt:
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
 
 ```python
 from django.contrib import admin
@@ -13,31 +15,43 @@ admin.site.register(Post)
 
 Wie du siehst, importieren wir hier das Model "Post", das wir im vorigen Kapitel erstellt haben. Damit unser Model auf der Admin-Seite sichtbar wird, müssen wir es mit `admin.site.register(Post)` registrieren.
 
-Okay, wir sehen uns nun unser Post-Model an. Denk daran, `python manage.py runserver` in die Konsole einzugeben, um den Webserver zu starten. Öffne dann deinen Browser und gib die Adresse http://127.0.0.1:8000/admin/ ein. Du solltest nun eine Login-Seite wie diese sehen:
+Okay, wir sehen uns nun unser Post-Model an. Denk daran, `python manage.py runserver` in die Konsole einzugeben, um den Webserver zu starten. Go to your browser and type the address http://127.0.0.1:8000/admin/. Du siehst eine Anmeldeseite:
 
 ![Login Seite](images/login_page2.png)
 
-Um dich einzuloggen, musst du einen *superuser* erzeugen - einen Benutzer, welcher Kontrolle über alles auf der Site hat. Geh zurück zu der Kommandozeile und tippe `python manage.py createsuperuser`, und drücke Enter. Wenn gefordert, gibst du deinen Benutzernamen (Kleinbuchstaben, keine Leerzeichen), E-Mail-Adresse und Passwort ein. Keine Sorge, dass du das Passwort nicht siehst, das du gerade eingibst - das soll so sein. Tipp es einfach ein und drücke `Enter` um fortzufahren. Du solltest nun Folgendes sehen (wobei Username und Email deine sein sollten):
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
 
-```
-(myvenv) ~/djangogirls$ python manage.py createsuperuser
-Username: admin
-Email address: admin@admin.com
-Password:
-Password (again):
-Superuser created successfully.
-```
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
 
-Geh nochmal in deinen Browser und log dich mit den Daten des Superusers ein, den du gerade erstellt hast. Du solltest nun das Django Admin Dashboard sehen.
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
 
-![Django Administration](images/django_admin3.png)
+![Django admin](images/django_admin3.png)
 
-Gehe zu Posts und experimentiere ein wenig damit. Füge 5 oder 6 Blogposts hinzu. Mach dir keine Sorgen wegen des Inhalts - du kannst einfach etwas Text aus diesem Tutorial kopieren und einfügen, um Zeit zu sparen :-).
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
 
-Achte darauf, dass bei wenigstens zwei oder drei Posts (aber nicht bei allen) das Veröffentlichungsdatum (publish date) eingetragen ist. Das werden wir später noch brauchen.
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
 
-![Django Administration](images/edit_post3.png)
+![Django admin](images/edit_post3.png)
 
-Wenn du mehr über Django Admin wissen willst, solltest du dir die Django Dokumentation ansehen: https://docs.djangoproject.com/en/1.8/ref/contrib/admin/
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
 
-Jetzt ist wahrscheinlich ein guter Moment, um dir einen Kaffee (oder Tee) zu gönnen und neue Kraft tanken. Du hast dein erstes Django-Model erstellt - du hast dir eine kleine Pause verdient!
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/de/django_forms/README.md b/de/django_forms/README.md
index cf60e48fed2..0f61c473cc2 100644
--- a/de/django_forms/README.md
+++ b/de/django_forms/README.md
@@ -1,6 +1,6 @@
 # Django Formulare
 
-Als Letztes möchten wir auf unserer Website noch die Möglichkeit haben, Blogposts hinzuzufügen und zu editieren. Die Django `admin`-Oberfläche ist cool, aber eher schwierig anzupassen und hübsch zu machen. Mit Formularen, `forms` , haben wir die absolute Kontrolle über unser Interface, wir können fast alles machen, was man sich vorstellen kann!
+Als Letztes möchten wir auf unserer Website noch die Möglichkeit haben, Blogposts hinzuzufügen und zu editieren. Die Django `admin`-Oberfläche ist cool, aber eher schwierig anzupassen und hübsch zu machen. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
 
 Das Gute an Django Forms ist, dass man sie entweder vollständig selbst definieren oder eine `ModelForm` erstellen kann, welche den Inhalt des Formulars in das Model speichert.
 
@@ -10,12 +10,13 @@ So wie die anderen wichtigen Django-Komponenten haben auch die Forms ihre eigene
 
 Wir erstellen nun eine Datei mit diesem Namen im `blog` Verzeichnis.
 
-```
-blog
-   └── forms.py
-```
+    blog
+       └── forms.py
+    
 
-So, jetzt lass uns diese öffnen und folgenden Code hinzufügen:
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
 
 ```python
 from django import forms
@@ -25,33 +26,37 @@ from .models import Post
 class PostForm(forms.ModelForm):
 
     class Meta:
-        model = Post
-        fields = ('title', 'text',)
+         model = Post
+         fields = ('title', 'text',)
 ```
 
 Zuerst müssen wir die Django Forms importieren (`from django import forms`) und natürlich auch unser `Post` Model (`from .models import Post`).
 
-Wie du wahrscheinlich schon vermutet hast, `PostForm` ist der Name unseres Formulars. Wir müssen Django mitteilen, dass unser Formular ein `ModelForm` ist (so kann Django ein bisschen für uns zaubern) - `forms.ModelForm` ist dafür verantwortlich.
+Wie du wahrscheinlich schon vermutet hast, `PostForm` ist der Name unseres Formulars. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
 
 Als Nächstes sehen wir uns `class Meta` an, damit sagen wir Django, welches Model benutzt werden soll, um das Formular zu erstellen (`model = Post`).
 
-Nun können wir bestimmen, welche(s) Feld(er) unser Formular besitzen soll. Wir wollen hier nur den `title` und `text` sichtbar machen - der `author` sollte die Person sein, die gerade eingeloggt ist (Du!) und `created_date` sollte automatisch generiert werden, wenn der Post erstellt wird (also im Code). Stimmt's?
+Nun können wir bestimmen, welche(s) Feld(er) unser Formular besitzen soll. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
 
 Und das war's schon! Jetzt müssen wir das Formular nur noch in einem *view* benutzen und im Template darstellen.
 
-Also erstellen wir hier auch wieder einen Link auf die Seite, eine URL, einen View und ein Template.
+So once again we will create a link to the page, a URL, a view and a template.
 
 ## Link auf eine Seite mit dem Formular
 
 Jetzt ist es an der Zeit, `blog/templates/blog/base.html` zu öffnen. Wir fügen einen Link in `div` hinzu mit dem Namen `page-header`:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Merk dir, dass wir unseren neuen View `post_new` nennen wollen.
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
 
-Nach Hinzufügen der Zeile sieht deine HTML-Datei so aus:
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
@@ -86,12 +91,16 @@ Nach dem Speichern und Neuladen von http://127.0.0.1:8000 siehst du den bekannte
 
 Wir öffnen `blog/urls.py` und fügen eine Zeile hinzu:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 url(r'^post/new/$', views.post_new, name='post_new'),
 ```
 
 Der finale Code sieht dann so aus:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
@@ -103,17 +112,21 @@ urlpatterns = [
 ]
 ```
 
-Nach dem Neuladen der Seite sehen wir einen `AttributeError`, weil wir noch keinen `post_new` View erstellt haben. Fügen wir ihn gleich hinzu!
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
 
 ## Der post_new View
 
 Jetzt wird es Zeit, die `blog/views.py` Datei zu öffnen und die folgenden Zeilen zu den anderen `from` Zeilen hinzuzufügen:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from .forms import PostForm
 ```
 
-und unseren *view*:
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -121,20 +134,22 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Um ein neues `PostForm` zu erstellen, rufen wir die `PostForm()` Methode auf und übergeben sie an das Template. Wir kommen gleich nochmal zu dem *view* zurück, aber jetzt erstellen wir schnell ein Template für das Form.
+Um ein neues `PostForm` zu erstellen, rufen wir die `PostForm()` Methode auf und übergeben sie an das Template. We will go back to this *view*, but for now, let's quickly create a template for the form.
 
 ## Template
 
 Wir müssen eine Datei `post_edit.html` im Verzeichnis `blog/templates/blog` erstellen. Damit ein Formular funktioniert, benötigen wir einige Dinge:
 
-*   Wir müssen das Formular anzeigen. Wir können das, zum Beispiel, mit einem simplen `{% raw %}{{ form.as_p }}{% endraw %}` tun.
-*   Die Zeile oben muss von einem HTML-Formular-Tag eingeschlossen werden `<form method="POST">...</form>`.
-*   Wir benötigen einen `Save`-Button. Wir erstellen diesen mit einem HTML-Button: `<button type="submit">Save</button>`.
-*   Und schließlich fügen wir nach dem öffnenden `<form ...>` Tag `{% raw %}{% csrf_token %}{% endraw %}` hinzu. Das ist sehr wichtig, da es deine Formulare sicher macht! Django wird sich beschweren, wenn du dies vergisst und trotzdem versuchst, das Formular zu speichern:
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. Das ist sehr wichtig, da es deine Formulare sicher macht! If you forget about this bit, Django will complain when you try to save the form:
 
 ![CSFR Forbidden page](images/csrf2.png)
 
-Ok, also schauen wir mal, wie der HTML-Code in `post_edit.html` aussehen sollte:
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -152,15 +167,17 @@ So, jetzt aktualisieren wir die Seite! Yay! Das Formular wird angezeigt!
 
 ![Neues Formular](images/new_form2.png)
 
-Aber Moment! Wenn du irgendetwas eintippst in das `title`- oder `text`-Feld und versuchst zu speichern - was wird wohl passieren?
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
 
-Nichts! Wir landen wieder auf der selben Seite und unser Text ist verschwunden... und kein neuer Post wurde hinzugefügt. Was lief denn hier schief?
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
 
 Die Antwort ist: nichts. Wir müssen einfach noch etwas mehr Arbeit in unseren *view* stecken.
 
 ## Speichern des Formulars
 
-Öffne `blog/views.py` erneut. Derzeit ist alles, was wir in dem View `post_new` haben, das hier:
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -168,9 +185,11 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Wenn wir das Formular übermitteln, werden wir zur selben Ansicht weitergeleitet, aber dieses Mal haben wir mehr Daten in `request`, genauer in `request.POST` (der Name hat nichts zu tun mit einem "Blogpost", sondern damit dass wir Daten "posten"). Erinnerst du dich daran, dass in der HTML-Datei unsere `<form>` Definition die Variable `method="POST"` hatte? Alle Felder aus dem Formular sind jetzt in `request.POST`. Du solltest `POST` nicht umbenennen (der einzige andere gültige Wert für `method` ist `GET`, wir wollen hier jetzt aber nicht auf den Unterschied eingehen).
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? Alle Felder aus dem Formular sind jetzt in `request.POST`. Du solltest `POST` nicht umbenennen (der einzige andere gültige Wert für `method` ist `GET`, wir wollen hier jetzt aber nicht auf den Unterschied eingehen).
 
-Wir haben also in unserem *view* zwei separate Situationen zu bearbeiten. Erstens: Wenn wir zum ersten Mal auf die Seite zugreifen und wir ein leeres Formular haben wollen. Zweitens: Wenn wir zurück zu der *view* gehen, mit all den Formulardaten, die wir gerade eingegeben haben. Wir müssen also eine Bedingung hinzufügen (dafür verwenden wir `if`).
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. Wir müssen also eine Bedingung hinzufügen (dafür verwenden wir `if`):
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 if request.method == "POST":
@@ -179,16 +198,20 @@ else:
     form = PostForm()
 ```
 
-Jetzt ist es an der Zeit, die Punkte `[...]` auszufüllen. Wenn `method` `POST` ist, dann wollen wir die `PostForm` mit den Daten aus dem Formular konstruieren, richtig? Wir tun das mit:
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST)
 ```
 
-Super einfach! Als Nächstes müssen wir testen, ob das Formular korrekt ist (alle benötigten Felder sind ausgefüllt, keine inkorrekten Werte werden gespeichert). Wir tun das mit `form.is_valid()`.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
 
 Wir überprüfen also, ob das Formular gültig ist und wenn ja, können wir es speichern!
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 if form.is_valid():
     post = form.save(commit=False)
@@ -197,23 +220,29 @@ if form.is_valid():
     post.save()
 ```
 
-Im Grunde passieren hier zwei Dinge: Wir speichern das Formular mit `form.save` und wir fügen einen Autor hinzu (da es bislang kein `author` Feld in der `PostForm` gab und dieses Feld notwendig ist!). `commit=False` bedeutet, dass wir das `Post` Model noch nicht speichern wollen - wir wollen erst noch den Autor hinzufügen. Meistens wirst du `form.save()` ohne `commit=False` benutzen, aber in diesem Fall müssen wir es so tun. `post.save()` wird die Änderungen sichern (den Autor hinzufügen) und ein neuer Blogpost ist kreiert!
+Im Grunde passieren hier zwei Dinge: Wir speichern das Formular mit `form.save` und wir fügen einen Autor hinzu (da es bislang kein `author` Feld in der `PostForm` gab und dieses Feld notwendig ist). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
 
-Nun wäre es noch genial, wenn wir direkt zu der `post_detail` Seite unseres neu erstellten Blogposts gehen könnten, richtig? Um dies zu tun, benötigen wir einen weiteren Import:
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import redirect
-``` 
+```
 
-Füge dies direkt am Anfang der Datei hinzu. Jetzt können wir endlich sagen: Gehe zu der `post_detail` Seite für unsere neu erstellten Posts.
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 return redirect('post_detail', pk=post.pk)
 ```
 
-`blog.views.post_detail` ist der Name unseres Views, zu dem wir springen wollen. Erinnerst du dich, dass dieser *view* einen `pk` benötigt? Um diesen an den View weiterzugeben, benutzen wir `pk=post.pk`, wobei `post` unser neu erstellter Blogpost ist!
+`post_detail` is the name of the view we want to go to. Erinnerst du dich, dass dieser *view* einen `pk` benötigt? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
 
-Ok, wir haben jetzt eine ganze Menge geredet, aber du willst bestimmt sehen, wie die gesamte *view* aussieht, richtig?
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -230,37 +259,41 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Schauen wir mal, ob es funktioniert. Gehe zu der Seite http://127.0.0.1:8000/post/new/, füge einen `title` und `text` hinzu und speichere es... und voilà! Der neue Blogpost wird hinzugefügt und wir werden auf die `Post_detail` Seite umgeleitet!
+Schauen wir mal, ob es funktioniert. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
 
-Du hast vielleicht bemerkt, dass wir das Veröffentlichungsdatum festlegen, bevor wir den Post veröffentlichen. Später werden wir einen *publish button* in **Django Girls Tutorial: Extensions** einführen.
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
 
 Das ist genial!
 
-## Formularvalidierung
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. Dies wird das Problem vorübergehend lösen. Es gibt eine permanente Lösung dafür, die im Kapitel **Homework: add security to your website!** nach dem Haupttutorial auf dich wartet.
 
-Jetzt zeigen wir dir, wie cool Django Formulare sind. Ein Blogpost muss `title`- und `text`-Felder besitzen. In unserem `Post`-Model haben wir (im Gegensatz zu dem `published_date`) nicht festgelegt, dass diese Felder nicht benötigt werden, also nimmt Django standardmäßig an, dass sie definiert werden.
+![Logged in error](images/post_create_error.png)
 
-Versuch das Formular ohne `title` und `text` zu speichern. Rate, was passieren wird!
+## Formularvalidierung
 
-![Formularvalidierung](images/form_validation2.png)
+Jetzt zeigen wir dir, wie cool Django Formulare sind. Ein Blogpost muss `title`- und `text`-Felder besitzen. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
 
-Django kümmert sich darum sicherzustellen, dass alle Felder in unserem Formular richtig sind. Ist das nicht großartig?
+Try to save the form without `title` and `text`. Guess what will happen!
 
-> Da wir vor Kurzem das Django Admin Interface benutzt haben, denkt das System, dass wir noch angemeldet sind. Es gibt einige Situationen, welche dazu führen können, dass wir ausgeloggt werden (Schließen des Browsers, Neustarten der Datenbank etc). Wenn du feststellst, dass du bei dem Erstellen von Posts Fehlermeldungen bekommst, die auf nicht angemeldete Nutzer zurückzuführen sind, dann gehe zu der Admin Seite http://127.0.0.1:8000/admin und logge dich erneut ein. Dies wird das Problem vorübergehend lösen. Es gibt eine permanente Lösung dafür, die im Kapitel **Homework: add security to your website!** nach dem Haupttutorial auf dich wartet.
+![Formularvalidierung](images/form_validation2.png)
 
-![Logged in error](images/post_create_error.png)
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
 
 ## Formular bearbeiten
 
-Jetzt wissen wir, wie ein neues Formular hinzugefügt wird. Aber was ist, wenn wir ein bereits bestehendes bearbeiten wollen? Das funktioniert so ähnlich wie das, was wir gerade getan haben. Lass uns schnell ein paar wichtige Dinge erstellen (falls du etwas nicht verstehst, solltest du deinen Coach fragen oder in den vorherigen Kapiteln nachschlagen, da wir all die Schritte bereits behandelt haben).
+Jetzt wissen wir, wie ein neues Formular hinzugefügt wird. Aber was ist, wenn wir ein bereits bestehendes bearbeiten wollen? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
 
-Öffne `blog/templates/blog/post_detail.html` und füge diese Zeile hinzu:
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
 
-damit die Vorlage so aussieht:
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -281,13 +314,17 @@ damit die Vorlage so aussieht:
 
 In `blog/urls.py` fügen wir folgende Zeile ein:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
     url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
 ```
 
 Wir werden die Vorlage `blog/templates/blog/post_edit.html` wiederverwenden, daher ist das einzig Fehlende eine neue *view*.
 
-Öffne `blog/views.py` und füge ganz am Ende der Datei Folgendes hinzu:
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_edit(request, pk):
@@ -305,19 +342,23 @@ def post_edit(request, pk):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Sieht genauso aus wie unsere `post_new` view, oder? Aber nicht ganz. Der Unterschied: Wir übergeben einen zusätzlichen `pk` Parameter von den Urls. Und: Wir bekommen das `Post`-Model, welches wir bearbeiten wollen, mit `get_object_or_404(Post, pk=pk)` und wenn wir dann ein Formular erstellen, übergeben wir post als `instance`, wenn wir das Formular speichern:
+Sieht genauso aus wie unsere `post_new` view, oder? Aber nicht ganz. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST, instance=post)
 ```
 
-als auch, wenn wir ein Formular mit post zum Editieren öffnen:
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(instance=post)
 ```
 
-Ok, lass uns mal schauen, ob das funktioniert! Geh auf die `post_detail`-Seite. Dort sollte sich ein Editier-Button in der oberen rechten Ecke befinden:
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
 
 ![Schaltfläche "Bearbeiten"](images/edit_button2.png)
 
@@ -325,23 +366,27 @@ Wenn du darauf klickst, siehst du das Formular mit unserem Blogpost:
 
 ![Formular bearbeiten](images/edit_form2.png)
 
-Probier doch einmal den Titel oder den Text zu ändern und die Änderungen zu speichern!
+Feel free to change the title or the text and save the changes!
 
 Herzlichen Glückwunsch! Deine Anwendung nimmt mehr Gestalt an!
 
-Falls du mehr Informationen über Django Formulare benötigst, solltest du die offizielle Dokumentation lesen: https://docs.djangoproject.com/en/1.8/topics/forms/
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
 
 ## Sicherheit
 
-Neue Posts mit nur einem Linkklick zu erstellen, ist großartig! Aber im Moment ist jeder, der deine Seite besucht in der Lage, einen neuen Blogpost zu veröffentlichen und das ist etwas, dass du garantiert nicht willst. Lass es uns so einrichten, dass der Button nur für dich sichtbar ist und nicht für jeden.
+Neue Posts mit nur einem Linkklick zu erstellen, ist großartig! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Lasst es uns so machen, das der Button für dich angezeigt wird aber für niemanden sonst. 
 
 Finde in der Datei `blog/templates/blog/base.html` unseren `page-header` `div` und das Anchor-Tag, welches du zuvor eingefügt hast. Es sollte so aussehen:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Wir fügen ein weiteres `{% if %}`-Tag ein, was dafür sorgt, dass der Link nur für angemeldete Nutzer angezeigt wird. Im Moment bist das also nur du! Ändere den `<a>`-Tag zu Folgendem:
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Ändere den `<a>`-Tag zu Folgendem:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% if user.is_authenticated %}
@@ -349,36 +394,54 @@ Wir fügen ein weiteres `{% if %}`-Tag ein, was dafür sorgt, dass der Link nur
 {% endif %}
 ```
 
-Dieses `{% if %}` sorgt dafür, dass der Link nur zu dem Browser geschickt wird, wenn der anfragende Nutzer auch angemeldet ist. Das verhindert das Erzeugen neuer Posts nicht komplett, ist aber ein sehr guter erster Schritt. In der Erweiterungslektion kümmern wir uns ausgiebiger um Sicherheit.
-
-Da du wahrscheinlich angemeldet bist, wirst du nichts Neues sehen, wenn du die Seite aktualisierst. Lade die Seite in einem neuen Browser oder im Inkognito-Modus und du wirst sehen, dass der Link nicht auftaucht!
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. Das verhindert das Erzeugen neuer Posts nicht komplett, ist aber ein sehr guter erster Schritt. In der Erweiterungslektion kümmern wir uns ausgiebiger um Sicherheit.
 
-## Noch eine Sache: Zeit für das Deployment!
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
 
-Mal sehen, ob das alles auch auf PythonAnywhere funktioniert. Zeit für ein weiteres Deployment!
+Open `blog/templates/blog/post_detail.html` and find this line:
 
-* Checke als Erstes deinen neuen Code ein und lade ihn auf GitHub hoch
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added views to create/edit blog post inside the site."
-$ git push
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
 
-* Dann führe Folgendes in der [PythonAnywhere Bash Konsole](https://www.pythonanywhere.com/consoles/) aus:
+Change it to this:
 
-```
-$ cd my-first-blog 
-$ source myvenv/bin/activate 
-(myvenv)$ git pull 
-[...] 
-(myvenv)$ python manage.py collectstatic 
-[...]
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
 ```
 
-* Springe nun noch schnell auf den [Web-Tab](https://www.pythonanywhere.com/web_app_setup/) und klicke auf **Reload**.
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Eins noch: Zeit für das Deployment!
+
+Mal sehen, ob das alles auch auf PythonAnywhere funktioniert. Zeit für ein weiteres Deployment!
+
+* Checke als Erstes deinen neuen Code ein und lade ihn auf GitHub hoch:
+
+{% filename %}command-line{% endfilename %}
 
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Dann führe Folgendes in der [PythonAnywhere Bash-Konsole](https://www.pythonanywhere.com/consoles/) aus:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull 
+    [...]
+    
+
+* Springe nun noch schnell auf den [Web-Tab](https://www.pythonanywhere.com/web_app_setup/) und klicke auf **Reload**.
 
-Und das war's! Glückwunsch :)
+Und das war's! Glückwunsch :)
\ No newline at end of file
diff --git a/de/django_installation/README.md b/de/django_installation/README.md
index d67d2c5853c..c9c5a8fd17f 100644
--- a/de/django_installation/README.md
+++ b/de/django_installation/README.md
@@ -1,5 +1,7 @@
 # Django Installation
 
-> **Hinweis:** Falls du dich bereits durch die Installationsschritte gearbeitet hast, dann hast du das Folgende bereits getan - du kannst direkt mit dem nächsten Kapitel fortfahren!
+> **Hinweis** Wenn du ein Chromebook verwendest, überspringe bitte dieses Kapitel und folgen den Anweisungen im [Chromebook Setup](../chromebook_setup/README.md).
+> 
+> **Hinweis:** Falls du dich bereits durch die Installationsschritte gearbeitet hast, gibt es keinen Grund dies erneut zu tun - du kannst direkt zum nächsten Kapitel springen!
 
-{% include "/django_installation/instructions.md" %}
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/de/django_installation/instructions.md b/de/django_installation/instructions.md
index 00e8468643d..0a8074d2495 100644
--- a/de/django_installation/instructions.md
+++ b/de/django_installation/instructions.md
@@ -1,98 +1,150 @@
-> Ein Teil dieses Kapitels basiert auf dem Tutorial der Geek Girls Carrots (http://django.carrots.pl/).
+> Ein Teil dieser Sektion basiert auf den Tutorials von Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 > 
-> Teile dieses Kapitels basieren auf dem [django-marcador Tutorial](http://django-marcador.keimlink.de/) lizenziert unter Creative Commons Attribution-ShareAlike 4.0 International License. Das django-marcador Tutorial von Markus Zapke-Gründemann et al. ist urheberrechtlich geschützt.
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Für das "django-marcador Tutorial" liegt das Urheberrecht bei Markus Zapke-Gründemann et al.
 
 ## Virtuelle Umgebung
 
-Bevor wir mit der Installation von Django beginnen, lernen wir ein sehr hilfreiches Tool kennen, das uns hilft, unsere Arbeitsumgebung zum Coden sauber zu halten. Es ist möglich, diesen Schritt zu überspringen, aber wir legen ihn dir dennoch besonders ans Herz. Mit dem bestmöglichen Setup zu starten, wird dir in der Zukunft eine Menge Frust ersparen!
+Bevor wir mit der Installation von Django beginnen, lernen wir ein sehr hilfreiches Tool kennen, das uns hilft, unsere Arbeitsumgebung zum Coden sauber zu halten. Es ist möglich diesen Schritt zu überspringen, aber wir legen ihn dir dennoch besonders ans Herz. Mit dem bestmöglichen Setup zu starten, wird dir in der Zukunft eine Menge Frust ersparen!
 
 Wir erzeugen eine virtuelle Arbeitsumgebung - ein **virtual environment** oder auch *virtualenv*. Eine virtuelle Umgebung wird dein Python/Django-Setup für ein einzelnes Projekt isolieren. Das bedeutet, dass deine Änderungen an einem Website-Projekt keine anderen Projekte, an welchen du auch gerade entwickelst, beeinträchtigen. Klingt nützlich, oder?
 
-Du musst nur das Verzeichnis festlegen, in dem du das `virtualenv` erstellen willst; zum Beispiel dein Home-Verzeichnis. Auf Windows ist dies `C:\Users\Name` (`Name` ist dein Anmeldename/Login).
+Du musst nur das Verzeichnis festlegen, in dem du das `virtualenv` erstellen willst; zum Beispiel dein Home-Verzeichnis. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
 
 In diesem Tutorial erstellen wir darin ein neues Verzeichnis `djangogirls`:
 
-```bash
-$ mkdir djangogirls
-$ cd djangogirls
-```
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
 
 Wir nennen die virtuelle Umgebung `myvenv`. Das Kommando dazu lautet dann:
 
-```bash
-$ python3 -m venv myvenv
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
 
-### Windows
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
 
-Um ein neues `virtualenv` zu erstellen, öffnest Du die Konsole (das kennst Du schon aus einem vorangegangenen Kapitel) und gibst `C:\Python35\python -m venv myvenv` ein. Das sieht dann so aus:
+Where `myvenv` is the name of your `virtualenv`. Du kannst auch andere Namen benutzen. Aber denk daran: nur Kleinbuchstaben, keine Leerzeichen, Akzente oder andere Sonderzeichen. It is also good idea to keep the name short – you'll be referencing it a lot!
 
-```bash
-C:\Users\Name\djangogirls> C:\Python35\python -m venv myvenv
-```
+<!--endsec-->
 
-`C:\Python35\python` ist das Verzeichnis in das Du zuvor Python installiert hast. `myvenv` ist der Name deiner neuen virtuellen Arbeitsumgebung, deinem neuen `virtualenv`. Du kannst auch andere Namen benutzen. Aber denk daran: nur Kleinbuchstaben, keine Leerzeichen, Akzente oder andere Sonderzeichen. Kurze Namen eignen sich gut, denn Du wirst sie oft benutzen bzw. eingeben müssen!
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
 
-### Linux und OS X
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
 
-Eine `virtualenv` auf Linux oder OS X anzulegen, heißt lediglich `python3 -m venv myvenv` einzugeben. Fertig. So sieht das dann aus:
+{% filename %}command-line{% endfilename %}
 
-```bash
-~/djangogirls$ python3 -m venv myvenv
-```
+    $ python3 -m venv myvenv
+    
 
-`myvenv` ist der Name deiner neuen virtuellen Arbeitsumgebung, deines neuen `virtualenv`. Andere Namen sind natürlich möglich. Bleibe bei Kleinbuchstaben und verwende keine Leerzeichen. Es ist hilfreich, die Namen kurz zu halten, denn du wirst sie oft benutzen bzw. eingeben müssen!
+`myvenv` ist der Name deiner neuen virtuellen Arbeitsumgebung, deines neuen `virtualenv`. Andere Namen sind natürlich möglich. Bleibe bei Kleinbuchstaben und verwende keine Leerzeichen. It is also a good idea to keep the name short as you'll be referencing it a lot!
 
-> **Anmerkung:** Die Einrichtung eines Virtualenv unter Ubuntu wie beschrieben, wird möglicherweise mit der folgenden Fehlermeldung quittiert:
->```bash
->Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
->```
+> **Hinweis:** Bei manchen Versionen von Debian/Unbuntu kann folgender Fehler auftauchen:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
 > 
 > Das zu umgehen, kannst du den `virtualenv`-Befehl verwenden.
->```bash
->~/djangogirls$ sudo apt-get install python-virtualenv
->~/djangogirls$ virtualenv --python=python3.4 myvenv
->```
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
 
 ## Mit der virtuellen Umgebung arbeiten
 
 Die obigen Kommandos erstellen ein Verzeichnis `myvenv` (bzw. den von Dir vergebenen Namen). Es enthält unsere virtuelle Arbeitsumgebung (im Wesentlichen ein paar Verzeichnisse und Dateien).
 
-#### Windows
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
 
 Starte deine virtuelle Umgebung, indem du eingibst:
-```bash
-C:\Users\Name\djangogirls> myvenv\Scripts\activate
-```
 
-#### Linux und OS X
+{% filename %}command-line{% endfilename %}
 
-Starte deine virtuelle Umgebung, indem du eingibst:
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
 
-```bash
-~/djangogirls$ source myvenv/bin/activate
-```
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
 
-Der Name `myvenv` muss mit dem von Dir gewählten Namen des `virtualenv` übereinstimmen!
+<!--endsec-->
 
-> **Anmerkung:** Manchmal ist das Kommando `source` nicht verfügbar. In diesen Fällen geht es auch so:
->```bash
->~/djangogirls$ . myvenv/bin/activate
->```
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
 
-Dein `virtualenv` wurde erfolgreich erstellt, wenn der Prompt der Konsole so aussieht:
+Starte deine virtuelle Umgebung, indem du eingibst:
 
-```bash
-(myvenv) C:\Users\Name\djangogirls>
-```
+{% filename %}command-line{% endfilename %}
 
-oder:
+    $ source myvenv/bin/activate
+    
 
-```bash
-(myvenv) ~/djangogirls$
-```
+Der Name `myvenv` muss mit dem von Dir gewählten Namen des `virtualenv` übereinstimmen!
+
+> **Anmerkung:** Manchmal ist das Kommando `source` nicht verfügbar. In diesen Fällen geht es auch so:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
 
-Die Zeile sollte mit dem Prefix `(myvenv)` beginnen!
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
 
 In Deiner neuen virtuellen Umgebung wird automatisch die richtige Version von `python` verwendet. Du kannst also `python` statt `python3` eingeben.
 
@@ -100,30 +152,50 @@ Ok, jetzt ist die erforderliche Umgebung startklar und wir können endlich Djang
 
 ## Django Installation
 
-Da dein `virtualenv` jetzt gestartet ist, kannst du Django mit `pip` installieren.
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
 
-Bevor wir das tun, versichern wir uns, dass wir die neueste Version von `pip` installiert haben, die Software, mit welcher wir Django installieren werden:
+{% filename %}command-line{% endfilename %}
 
-```bash
-(myvenv) ~$ pip install --upgrade pip
-```
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
 
-Gib in die Konsole `pip install django~=1.10.0` ein.
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
 
-```bash
-(myvenv) ~$ pip install django~=1.10.0
-Collecting django~=1.10.0
-  Downloading Django-1.10.4-py2.py3-none-any.whl (6.8MB)
-Installing collected packages: django
-Successfully installed django-1.10.4
-```
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Erstelle ein neues virtualenv in einem neuen Verzeichnis, lösche danach das alte und wiederhohle den oben genannten Befehl. (Das Verzeichnis des virtualenv zu verschieben funktioniert dabei nicht da virtualenv absolute Pfade verwendet.)
 
-Für Windows
+<!--endsec-->
 
-> Wenn du auf einem Windows-Rechner einen Fehler bekommst beim Aufruf von pip, dann prüfe, ob dein Pfad Leerzeichen, Akzente oder Sonderzeichen enthält (`C:\Users\User Name\djangogirls`). Wenn das der Fall ist, dann verschiebe es an einen anderen Ort ohne Leerzeichen, Akzente oder Sonderzeichen (empfohlen: `C:\djangogirls`). Danach versuchst du die Installation am neuen Ort noch einmal.
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
 
-Für Linux
+> Es kann sein das deine Befehlszeile einfriert wenn du versuchst Django zu installieren. Sollte das passieren nutze folgenden Befehl anstelle des oben angegebenen:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
 
 > Für pip mit Ubuntu 12.04 kann es zu folgendem Fehler kommen. Ruf dann `python -m pip install -U --force-reinstall pip` auf, um die Installation von pip im virtualenv zu reparieren.
 
-Das war's! Du bist nun (endlich) bereit, deine erste Django Anwendung zu starten!
+<!--endsec-->
+
+Das war's! Du bist nun (endlich) bereit, deine erste Django Anwendung zu starten!
\ No newline at end of file
diff --git a/de/django_models/README.md b/de/django_models/README.md
index 5e30ba31426..7dc27a73939 100644
--- a/de/django_models/README.md
+++ b/de/django_models/README.md
@@ -4,31 +4,29 @@ Wir erstellen jetzt etwas, damit wir alle Posts von unserem Blog speichern könn
 
 ## Objekte
 
-Eine Herangehensweise an das Programmieren ist das so genannte `objektorientierte Programmieren`. Die Idee dahinter ist, dass wir Dinge und ihre Interaktionen untereinander modellieren können und nicht alles als langweilige Kette von Programmbefehlen hintereinander aufschreiben müssen.
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
 
 Was ist denn nun ein Objekt? Ein Objekt ist eine Sammlung von Eigenschaften und Aktionsmöglichkeiten, das anhand einer Vorlage (Klasse) erstellt wird. Das klingt erst einmal komisch, aber hier haben wir gleich ein Beispiel.
 
-Wenn wir zum Beispiel eine Katze modellieren wollen, erschaffen wir eine Objektvorlage `Katze`, eine Art Blaupause oder Schema, nach welcher zukünftig jedes spezifische Katzenobjekt erstellt werden kann. Die Vorlage beschreibt typische Eigenschaften von Katzen, z.B. `farbe`, `alter`, `stimmung` (beispielsweise gut, schlecht oder müde ;)), `besitzer` (der wiederum durch ein `Person`-Objekt repräsentiert wird oder die Eigenschaft bleibt, im Falle eines Streuners, leer).
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
 
-Jedes Objekt einer `Katze` soll natürlich auch einige Aktionsmöglichkeiten besitzen: `schnurren`, `kratzen` oder `füttern` (hier bekäme die Katze ein bisschen `Katzenfutter`, welches wieder durch ein eigenes Objekt mit Eigenschaften, wie zum Beispiel `Geschmack`, repräsentiert sein könnte).
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
 
-```
-Katze
---------
-farbe
-alter
-stimmung
-besitzerin
-schnurren()
-kratzen()
-fuettern(katzen_futter)
-```
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
 
-```
-Katzenfutter
---------
-geschmack
-```
+    CatFood
+    --------
+    taste
+    
 
 Der Gedanke dahinter ist also, echte Dinge mit Hilfe von Eigenschaften (genannt `Objekteigenschaften`) und Aktionsmöglichkeiten (genannt `Methoden`) im Programmcode zu beschreiben).
 
@@ -36,17 +34,16 @@ Wie also modellieren wir Blogposts? Schließlich wollen wir ja einen Blog bauen,
 
 Wir müssen folgende Fragen beantworten: Was ist ein Blogpost? Welche Eigenschaften sollte er haben?
 
-Nun, zum einen braucht unser Blogpost Text mit einem Inhalt und einen Titel, oder? Außerdem wäre es schön zu wissen, wer ihn geschrieben hat - wir brauchen also noch einen Autor. Schließlich wollen wir wissen, wann der Post geschrieben und veröffentlicht wurde.
+Nun, zum einen braucht unser Blogpost Text mit einem Inhalt und einen Titel, oder? It would be also nice to know who wrote it – so we need an author. Schließlich wollen wir wissen, wann der Post geschrieben und veröffentlicht wurde.
 
-```
-Post
---------
-title
-text
-author
-created_date
-published_date
-```
+    Post 
+    -------- 
+    title 
+    text
+    author
+    created_date
+    published_date
+    
 
 Was für Dinge könnte man mit einem Blogpost machen? Es wäre schön, wenn wir eine `Methode` hätten, die den Post veröffentlicht, nicht wahr?
 
@@ -58,41 +55,48 @@ Da wir jetzt wissen, was wir erreichen wollen, können wir nun damit anfangen, e
 
 Da wir jetzt in etwa wissen, was ein Objekt ist, wollen wir ein Django-Model, eine Vorlage, für unsere Blogposts anlegen, nach welcher wir zukünftig unsere Blogpostobjekte erstellen können.
 
-Ein Model in Django ist ein spezielles Konstrukt, das in unserer Datenbank gespeichert werden kann. Eine Datenbank ist eine Sammlung von Daten. Dies ist ein Ort, an dem du Informationen zu Benutzern, deinen Blogposts usw. speichern wirst. Wir benutzen dafür eine SQLite-Datenbank. Das ist die Voreinstellung in Django - für uns wird das erst einmal ausreichen.
+A model in Django is a special kind of object – it is saved in the `database`. Eine Datenbank ist eine Sammlung von Daten. Dies ist ein Ort, an dem du Informationen zu Benutzern, deinen Blogposts usw. speichern wirst. Wir benutzen dafür eine SQLite-Datenbank. This is the default Django database adapter – it'll be enough for us right now.
 
-Du kannst dir ein Model wie eine Tabelle mit Spalten ("Feldern", Englisch "fields") und Zeilen (Datensätzen) vorstellen.
+Du kannst dir ein Model wie eine Tabelle mit Spalten ("Feldern", englisch "fields") und Zeilen (Datensätzen) vorstellen.
 
 ### Eine Applikation für unseren Blog
 
 Um unsere Webseite aufgeräumt zu halten, werden wir eine eigene Anwendung für unser Projekt erstellen, wir nennen das eine Applikation. Wir wollen uns gleich daran gewöhnen, alles ordentlich und sortiert zu halten. Um eine Applikation zu erstellen, müssen wir das folgende Kommando in der Konsole ausführen (wieder in dem `djangogirls`-Verzeichnis, in dem die `manage.py`-Datei liegt):
 
-```
-(myvenv) ~/djangogirls$ python manage.py startapp blog
-```
+{% filename %}Mac OS X and Linux:{% endfilename %}
 
-Wie du sehen kannst, wurde ein neues `blog`-Verzeichnis erstellt, welches schon einige Dateien enthält. Das Verzeichnis und die Dateien unseres Projektes sollten jetzt so aussehen:
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
 
-```
-djangogirls
-├── blog
-│   ├── __init__.py
-│   ├── admin.py
-│   ├── apps.py
-│   ├── migrations
-│   │   └── __init__.py
-│   ├── models.py
-│   ├── tests.py
-│   └── views.py
-├── db.sqlite3
-├── manage.py
-└── mysite
-    ├── __init__.py
-    ├── settings.py
-    ├── urls.py
-    └── wsgi.py
-```
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
 
-Nach dem Erstellen der Applikation müssen wir Django noch sagen, dass diese auch genutzt werden soll. Das können wir in der Datei `mysite/settings.py` einstellen. Wir suchen den Eintrag `INSTALLED_APPS` und fügen darin die Zeile `'blog',` direkt über der schließenden Klammer `)` ein. Das sollte dann so aussehen:
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 INSTALLED_APPS = [
@@ -108,9 +112,11 @@ INSTALLED_APPS = [
 
 ### Das Blogpost-Model
 
-Alle Models unserer Applikation werden in der `blog/models.py`-Datei definiert. Dies ist also der richtige Platz für unser Blogpost-Model.
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
 
-Lass uns `blog/models.py` öffnen, lösche alles darin und schreibe Code wie diesen:
+{% filename %}blog/models.py{% endfilename %}
 
 ```python
 from django.db import models
@@ -118,7 +124,7 @@ from django.utils import timezone
 
 
 class Post(models.Model):
-    author = models.ForeignKey('auth.User')
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
     created_date = models.DateTimeField(
@@ -134,53 +140,60 @@ class Post(models.Model):
         return self.title
 ```
 
-> Kontrolliere nochmal, dass du zwei Unterstriche (`__`) vor und hinter dem `str` gesetzt hast. Diese Konvention wird häufig in Python benutzt und manchmal nennen wir es "dunder" (kurz für "double-underscore").
+> Double-check that you use two underscore characters (`_`) on each side of `str`. Diese Konvention wird häufig in Python benutzt und manchmal nennen wir es "dunder" (kurz für "double-underscore").
 
-Es sieht kompliziert aus, oder? Aber keine Sorge, wir werden erklären, was diese Zeilen bedeuten!
+It looks scary, right? But don't worry – we will explain what these lines mean!
 
-Die Zeilen, die mit `from` oder `import` beginnen, sind Anweisungen, um Sachen aus anderen Dateien mitzunutzen. Anstatt häufig genutzten Code in jede Datei einzeln zu kopieren, binden wir ihn ein mit: `from... import ...`.
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
 
-`class Post(models.Model):` - Diese Zeile definiert unser Model).
+`class Post(models.Model):` – this line defines our model (it is an `object`).
 
-* `class` ist ein spezielles Schlüsselwort, womit wir angeben, dass wir hier eine Klasse, eine Vorlage für zukünftige Objekte, definieren wollen.
-* `Post` ist der Name unseres Models. Wir können ihm auch einen anderen Namen geben (aber wir müssen Sonderzeichen und Leerzeichen vermeiden). Beginne einen Klassennamen immer mit einem Großbuchstaben.
-* `models.Model` gibt an, dass das Post-Model ein Django-Model ist, so weiß Django, dass es in der Datenbank gespeichert werden soll.
+- `class` ist ein spezielles Schlüsselwort, womit wir angeben, dass wir hier eine Klasse, eine Vorlage für zukünftige Objekte, definieren wollen.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` gibt an, dass das Post-Model ein Django-Model ist, so weiß Django, dass es in der Datenbank gespeichert werden soll.
 
-Jetzt definieren wir die Eigenschaften, über welche wir gesprochen haben: `title`, `text`, `created_date`, `published_date` und `author`. Um dies zu tun, müssen wir einen Typen für jedes Feld definieren. (Ist es Text? Eine Zahl? Ein Datum? Eine Beziehung zu einem anderen Objekt, z.B. ein Benutzer?).
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
 
-* `models.CharField` - so definierst du ein Textfeld mit einer limitierten Anzahl von Zeichen.
-* `models.TextField` - so definierst du ein langes Textfeld ohne Limit. Klingt doch perfekt für unsere Blogpostinhalte, oder?
-* `models.DateTimeField` - ein Feld für ein Datum und eine Uhrzeit.
-* `models.ForeignKey` - definiert eine Verlinkung zu einem anderen Model.
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
 
-Wir werden nicht den gesamten Code hier erklären, da es einfach zu lange dauern würde. Du solltest einen Blick in die offizielle Django-Dokumentation werfen, wenn du mehr über Modelfelder und darüber wissen möchtest, wie man auch andere Dinge als die oben beschriebenen definiert (https://docs.djangoproject.com/en/1.8/ref/models/fields/#field-types).
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
 
-Was ist mit `def publish(self):`? Es ist genau die `publish`-Methode zum Veröffentlichen unserer Blogposts, über die wir vorher bereits sprachen. `def` zeigt an, dass es sich nachfolgend um eine Funktion/Methode handelt und `publish` ist der Name der Methode. Du kannst den Namen der Methode auch ändern, wenn du das möchtest. Die Benennungsregel ist, dass wir Kleinbuchstaben und Unterstriche statt Leerzeichen verwenden. Eine Methode, welche den Durchschnittspreis berechnet, könnte zum Beispiel `calculate_average_price` genannt werden.
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
 
-Methoden geben oftmals etwas zurück (english: `return`). Es gibt ein Beispiel dafür in der `__str__` Methode. In diesem Szenario, wenn wir `__str__()` aufrufen bekommen wir einen Text (**string**) mit einem Post-Titel zurück.
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
 
-Wenn dir über Methoden noch etwas nicht klar ist, dann zögere nicht, deinen Coach zu fragen! Wir wissen, dass es kompliziert ist, vor allem, wenn du gleichzeitig lernst, was Objekte und Funktionen sind. Aber hoffentlich sieht es für dich jetzt etwas weniger nach Magie aus!
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
 
 ### Tabellen für Models in deiner Datenbank erstellen
 
-Als letzten Schritt wollen wir unser neues Model der Datenbank hinzufügen. Dazu müssen wir Django klarmachen, dass wir einige Änderungen an unserem Model vorgenommen haben (wir haben es gerade erst kreiert!). Gib in deine Konsole `python manage.py makemigrations blog` ein. Das sieht dann so aus:
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
 
-```
-(myvenv) ~/djangogirls$ python manage.py makemigrations blog
-Migrations for 'blog':
-  blog/migrations/0001_initial.py:
-  - Create model Post
-```
+{% filename %}command-line{% endfilename %}
 
-Django hat für uns eine Migrationsdatei (mit allen aktuellen Informationen über unser Model) vorbereitet, welche wir jetzt auf unsere Datenbank anwenden müssen. Tippe `python manage.py migrate blog` und der Output sollte sein:
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
 
-```
-(myvenv) ~/djangogirls$ python manage.py migrate blog
-Operations to perform:
-  Apply all migrations: blog
-Running migrations:
-  Rendering model states... DONE
-  Applying blog.0001_initial... OK
-```
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
 
-Hurra! Unser Post-Model ist ab sofort in unserer Datenbank gespeichert! Es wäre doch schön, zu wissen, wie es aussieht, oder? Springe zum nächsten Kapitel und schau es dir an!
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/de/django_orm/README.md b/de/django_orm/README.md
index 234d6b15cfb..e5c87af1954 100644
--- a/de/django_orm/README.md
+++ b/de/django_orm/README.md
@@ -4,7 +4,7 @@ In diesem Kapitel lernst du, wie sich Django mit der Datenbank verbindet und Dat
 
 ## Was ist ein QuerySet?
 
-Ein QuerySet ist im Wesentlichen eine Liste von Objekten eines bestimmten Models. Mit dem QuerySet kann man Daten aus der Datenbank auslesen, filtern und ordnen.
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
 
 Am besten wir sehen uns das an einem Beispiel an. Versuchen wir's?
 
@@ -12,23 +12,27 @@ Am besten wir sehen uns das an einem Beispiel an. Versuchen wir's?
 
 Öffne deine lokale Konsole (nicht in PythonAnywhere) und tippe dieses Kommando ein:
 
-```
-(myvenv) ~/djangogirls$ python manage.py shell
-```
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
 
 Das sollte angezeigt werden:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
-(InteractiveConsole)
->>>
+(InteractiveConsole) >>>
 ```
 
-Du befindest dich jetzt in Djangos interaktiver Konsole. Das ist fast das gleiche wie die Python-Prompt, aber besitzt etwas zusätzliche Django-Magie :) . Natürlich sind alle Python Kommandos hier trotzdem vorhanden.
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
 
 ### Alle Objekte
 
 Zunächst wollen wir alle unsere Blogposts ansehen. Das kannst du mit folgendem Kommando erreichen:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.all()
 Traceback (most recent call last):
@@ -36,60 +40,76 @@ Traceback (most recent call last):
 NameError: name 'Post' is not defined
 ```
 
-Ups! Das gibt einen Fehler. Die Konsole sagt uns, dass es noch keine Posts gibt. Das stimmt! Wir haben vergessen, diese vorher zu importieren!
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> from blog.models import Post
 ```
 
-Das lässt sich einfach ändern: Wir importieren `Post` aus `blog.models`. Jetzt versuchen wir nochmal, alle Posts anzeigen zu lassen:
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> Post.objects.all()
 <QuerySet [<Post: my post title>, <Post: another post title>]>
 ```
 
-Das ist die Liste, die wir vorhin erstellt haben! Wir haben diese Posts über die Django Admin Oberfläche erstellt. Aber jetzt wollen wir mit Python neue Einträge erstellen, also wie machen wir das?
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
 
 ### Objekt erstellen
 
 So erstellst du ein neues Post-Objekt in der Datenbank:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.create(author=me, title='Sample title', text='Test')
 ```
 
-Allerdings fehlt noch eine Zutat: `me`. Wir müssen eine Instanz des Models `User` als Autor übergeben. Wie macht man das?
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
 
 Als Erstes müssen wir das User Model importieren:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> from django.contrib.auth.models import User
 ```
 
 Welche User sind in unserer Datenbank vorhanden? Finde es damit heraus:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> User.objects.all()
 <QuerySet [<User: ola>]>
 ```
 
-Das ist der Superuser, den wir vorhin erstellt haben! Lass uns jetzt eine Instanz des Users erstellen:
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> me = User.objects.get(username='ola')
 ```
 
-Wie du siehst, haben wir jetzt ein `User`-Objekt mit einem `username` 'ola'. Schön! Natürlich verwendest du hier deinen eigenen Benutzernamen.
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
 
 Jetzt können wir schließlich unseren Post erstellen:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.create(author=me, title='Sample title', text='Test')
 ```
 
 Super! Wollen wir nachsehen, ob es funktioniert hat?
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.all()
 <QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
@@ -99,27 +119,33 @@ Da ist er, ein weiterer Post in der Liste!
 
 ### Mehrere Posts hinzufügen
 
-Du kannst jetzt noch ein bisschen damit rumprobieren und noch weitere Posts hinzufügen. Erstelle noch zwei oder drei weitere und geh dann zum nächsten Punkt.
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
 
 ### Objekte filtern
 
-Eine wichtige Eigenschaft von QuerySets ist, dass die Einträge gefiltert werden können. Zum Beispiel wollen wir alle Posts des Users Ola finden. Dafür nehmen wir `filter` statt `all` in `Post.objects.all()`. In Klammern schreiben wir die Bedingung(en), die erfüllt werden müssen, damit ein Blogpost in unser Queryset kommt. So soll jetzt z.B. `author` gleich `me` sein, damit nur die Blogposts des Autors "me" herausgefiltert werden. In Django schreiben wir deshalb: `author=me`. Jetzt sieht unser Code folgendermaßen aus:
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. Dafür nehmen wir `filter` statt `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Jetzt sieht unser Code folgendermaßen aus:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> Post.objects.filter(author=me)
 [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
 ```
 
-Oder vielleicht wollen wir alle Posts haben, die das Wort "title" im `title`-Feld haben?
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> Post.objects.filter(title__contains='title')
 [<Post: Sample title>, <Post: 4th title of post>]
 ```
 
-> **Anmerkung:** Zwischen `title` und `contains` befinden sich zwei Unterstriche (`__`). Das ORM von Django nutzt diese Syntax, um Feldnamen ("title") und Operationen oder Filter ("contains") voneinander zu trennen. Wenn du nur einen Unterstrich benutzt, bekommst du einen Fehler wie "FieldError: Cannot resolve keyword title_contains".
+> **Anmerkung:** Zwischen `title` und `contains` befinden sich zwei Unterstriche (`__`). Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
 
-Du kannst auch eine Liste aller bereits publizierten Posts erhalten, indem wir nach allen Posts suchen, deren `published_date` in der Vergangenheit liegt:
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> from django.utils import timezone
@@ -127,19 +153,25 @@ Du kannst auch eine Liste aller bereits publizierten Posts erhalten, indem wir n
 []
 ```
 
-Unglücklicherweise ist der Post, den wir über die Python-Konsole hinzugefügt haben, noch nicht veröffentlicht. Das können wir ändern! Als Erstes holen wir eine Instanz des Posts, den wir veröffentlichen wollen:
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> post = Post.objects.get(title="Sample title")
 ```
 
-Dann publizieren wir ihn mit unserer `publish`-Methode!
+Dann publizieren wir ihn mit unserer `publish`-Methode:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> post.publish()
 ```
 
-Jetzt versuch, eine Liste von veröffentlichten Posts zu bekommen (drücke dreimal "Pfeil nach oben" und `enter`):
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> Post.objects.filter(published_date__lte=timezone.now())
@@ -150,6 +182,8 @@ Jetzt versuch, eine Liste von veröffentlichten Posts zu bekommen (drücke dreim
 
 Mit den QuerySets kannst du eine Liste auch nach bestimmten Kriterien ordnen. Lass uns das mit dem `created_date` Feld ausprobieren:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.order_by('created_date')
 [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
@@ -157,6 +191,8 @@ Mit den QuerySets kannst du eine Liste auch nach bestimmten Kriterien ordnen. La
 
 Wir können die Reihenfolge auch umdrehen, indem wir "`-`" davor schreiben:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.order_by('-created_date')
 [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
@@ -166,15 +202,15 @@ Wir können die Reihenfolge auch umdrehen, indem wir "`-`" davor schreiben:
 
 Du kannst auch QuerySets kombinieren, indem du sie **verkettest**:
 
-```
->>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-``` 
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
 
 Dies ist wirklich mächtig und lässt dich ziemlich komplexe Abfragen schreiben.
 
 Cool! Jetzt bist du bereit für den nächsten Teil! Um die Konsole zu schließen, schreib das:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> exit()
-$
-```
+```
\ No newline at end of file
diff --git a/de/django_start_project/README.md b/de/django_start_project/README.md
index 7c442e9f1b6..a4e518fe360 100644
--- a/de/django_start_project/README.md
+++ b/de/django_start_project/README.md
@@ -1,47 +1,61 @@
 # Dein erstes Django-Projekt!
 
-> Teile dieses Kapitels basieren auf den Tutorials der Geek Girls Carrots (http://django.carrots.pl/).
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 > 
-> Teile dieses Kapitels basieren auf dem [django-marcador Tutorial](http://django-marcador.keimlink.de/) lizenziert unter Creative Commons Attribution-ShareAlike 4.0 International License. Für das "django-marcador Tutorial" liegt das Urheberrecht bei Markus Zapke-Gründemann et al.
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Für das "django-marcador Tutorial" liegt das Urheberrecht bei Markus Zapke-Gründemann et al.
 
-
-Wir werden einen einfachen Blog erstellen!
+We're going to create a small blog!
 
 Der erste Schritt ist, ein neues Django-Projekt zu starten. Im Grunde bedeutet das, dass wir einige Skripte ausführen werden, die Django zur Verfügung stellt, um ein Skelett eines Django-Projekts für uns zu erzeugen. Das Projekt beinhaltet einen Haufen von Verzeichnissen und Dateien, die wir später verwenden werden.
 
 Die Namen einiger Dateien und Verzeichnisse sind sehr wichtig für Django. Die Dateien, die erstellt werden, solltest du nicht umbenennen. Sie an eine andere Stelle zu verschieben, ist auch keine gute Idee. Django muss zwingend eine gewisse Struktur erhalten, um wichtige Dinge wiederzufinden.
 
-> Denk daran, alles in der "Virtualenv"-Umgebung auszuführen. Wenn du kein Präfix `(Myvenv)` in deiner Konsole siehst, musst du deine Virtualenv-Umgebung aktivieren. Wie das gemacht wird, erklären wir im Kapitel **Django-Installation**, im Abschnitt **Arbeiten mit Virtualenv**. Gib `myvenv\Scripts\activate` in Windows oder `source myvenv/bin/activate` in Mac OS / Linux ein, um die Umgebung zu aktivieren.
+> Denk daran, alles in der "Virtualenv"-Umgebung auszuführen. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. Wie das gemacht wird, erklären wir im Kapitel **Django-Installation**, im Abschnitt **Arbeiten mit Virtualenv**. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
 
-In deiner MacOS- oder Linux-Konsole solltest du den folgenden Befehl ausführen; **vergiss nicht, den Punkt `.` am Ende** einzufügen:
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
 
-```
-(myvenv) ~/djangogirls$ django-admin startproject mysite .
-```
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
 
-Unter Windows; **vergiss nicht, den Punkt `.` am Ende** einzufügen:
+{% filename %}command-line{% endfilename %}
 
-```
-(myvenv) C:\Users\Name\djangogirls> django-admin.py startproject mysite .
-```
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
 
-> Der Punkt `.` ist sehr wichtig, weil er dem Skript mitteilt, dass Django in deinem aktuellen Verzeichnis installiert werden soll. (der Punkt `.` ist eine Schnellreferenz dafür)
+> Der Punkt `.` ist sehr wichtig, weil er dem Skript mitteilt, dass Django in deinem aktuellen Verzeichnis installiert werden soll. (der Punkt `.` ist eine Schnellreferenz dafür).
 > 
-> **Hinweis:** Wenn du die oben angegebenen Kommandos eingibst, denk dran, tippe nur das ein, was mit `django-admin` oder `django-admin.py` anfängt. `(myvenv) ~/djangogirls$` und `(myvenv) C:\Users\Name\djangogirls>` sind nur Teile von dem, was dir in der Eingabeaufforderung angezeigt wird, wenn die Konsole auf deine Eingabe wartet.
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Der Punkt `.` ist sehr wichtig, weil er dem Skript mitteilt, dass Django in deinem aktuellen Verzeichnis installiert werden soll. (der Punkt `.` ist eine Schnellreferenz dafür).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
 
 `django-admin.py` ist ein Skript, welches Verzeichnisse und Dateien für dich erstellt. Du solltest jetzt eine Verzeichnisstruktur haben, die folgendermaßen aussieht:
 
-```
-djangogirls
-├───manage.py
-└───mysite
-        settings.py
-        urls.py
-        wsgi.py
-        __init__.py
-```
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
 
-`manage.py` ist ein Script, das das Management deines Projektes unterstützt. Mit dem Script bist du unter anderem in der Lage, den Webserver auf deinem Rechner zu starten, ohne etwas Weiteres installieren zu müssen.
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
 
 Die Datei `settings.py` beinhaltet die Konfiguration deiner Website.
 
@@ -51,31 +65,59 @@ Lass uns kurz die anderen Dateien vergessen - wir werden sie nicht verändern. D
 
 ## Einstellungen anpassen
 
-Wir werden die Einstellungen in `mysite/settings.py` anpassen. Öffne dazu den zuvor installierten Editor.
+Wir machen nun ein paar Änderungen in `mysite/settings.py`. Öffne die Datei mit dem Codeeditor, den du vorhin installiert hast.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
 
-Es wäre schön, wenn die richtige Zeit auf deiner Webseite eingestellt ist. Gehe zu der [wikipedia timezones list](http://en.wikipedia.org/wiki/List_of_tz_database_time_zones) und kopiere deine zutreffende Zeitzone (time zone, TZ). (z.B. `Europe/Berlin`)
+Es wäre schön, wenn die richtige Zeit auf deiner Webseite eingestellt ist. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
 
-Finde in der settings.py die Zeile, welche `TIME_ZONE` enthält und ändere sie zu deiner Zeitzone:
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 TIME_ZONE = 'Europe/Berlin'
 ```
 
-Ändere "Europe/Berlin", wenn zutreffend.
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
 
-Des Weiteren brauchen wir einen Dateipfad für sogenannte "statische" Dateien (static files). Wir werden später im Tutorial genauer klären, was wir darunter verstehen. Gehe ganz ans Ende der Datei und füge unter `STATIC_URL` einen neuen Eintrag `STATIC_ROOT` ein.
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 STATIC_URL = '/static/'
 STATIC_ROOT = os.path.join(BASE_DIR, 'static')
 ```
 
-## Eine Datenbank erstellen
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
 
-Es gibt viele verschiedene Datenbanksysteme, in denen wir Daten für unsere Website speichern können. Wir werden das Standard-System `sqlite3` nutzen..
+## Set up a database
+
+Es gibt viele verschiedene Datenbank Programme, welche die Daten unserer Website verwalten können. Wir werden die Standard Datenbanksoftware nehmen, `sqlite3`.
 
 Das sollte schon in der `mysite/settings.py`-Datei eingestellt sein:
 
+{% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 DATABASES = {
     'default': {
@@ -87,50 +129,74 @@ DATABASES = {
 
 Um eine Datenbank für unseren Blog zu erstellen, müssen wir folgenden Befehl in der Konsole ausführen (Dazu müssen wir in dem `djangogirls`-Verzeichnis sein, in dem sich auch die `manage.py`-Datei befindet). Wenn alles glatt läuft, sollte das so aussehen:
 
-```
-(myvenv) ~/djangogirls$ python manage.py migrate
-Operations to perform:
-  Apply all migrations: auth, admin, contenttypes, sessions
-Running migrations:
-  Rendering model states... DONE
-  Applying contenttypes.0001_initial... OK
-  Applying auth.0001_initial... OK
-  Applying admin.0001_initial... OK
-  Applying admin.0002_logentry_remove_auto_add... OK
-  Applying contenttypes.0002_remove_content_type_name... OK
-  Applying auth.0002_alter_permission_name_max_length... OK
-  Applying auth.0003_alter_user_email_max_length... OK
-  Applying auth.0004_alter_user_username_opts... OK
-  Applying auth.0005_alter_user_last_login_null... OK
-  Applying auth.0006_require_contenttypes_0002... OK
-  Applying auth.0007_alter_validators_add_error_messages... OK
-  Applying sessions.0001_initial... OK
-```
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE 
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK 
+      Applying contenttypes.0002_remove_content_type_name... OK 
+      Applying auth.0002_alter_permission_name_max_length... OK 
+      Applying auth.0003_alter_user_email_max_length... OK 
+      Applying auth.0004_alter_user_username_opts... OK  
+     Applying auth.0005_alter_user_last_login_null... OK 
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
 
 Und wir sind fertig! Zeit, unseren Webserver zu starten, um zu sehen, ob unsere Website funktioniert!
 
+## Starting the web server
+
 Kontrolliere, dass du in dem Verzeichniss bist, in dem die `manage.py`-Datei liegt (das `djangogirls`-Verzeichnis). Wir starten den Webserver, indem wir in der Konsole `python manage.py runserver` ausführen:
 
-```
-(myvenv) ~/djangogirls$ python manage.py runserver
-```
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
 
 Wenn du Windows benutzt und dies mit dem `UnicodeDecodeError` fehlschläft, verwende diesen Befehl:
 
-```
-(myvenv) ~/djangogirls$ python manage.py runserver 0:8000
-```
+{% filename %}command-line{% endfilename %}
 
-Jetzt wollen wir schauen, ob unsere Website funktioniert: Öffne deinen Browser (Firefox, Chrome, Safari, Edge oder was du sonst nutzt) und gib folgende Adresse ein:
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
 
-```
-http://127.0.0.1:8000/
-```
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
 
-Der Webserver wird deine Eingabeaufforderung übernehmen, bis du ihn wieder stoppst. Um weiterhin Kommandos einzugeben, während er läuft, öffne eine neue Konsole und aktiviere dein Virtualenv. Um den Webserver zu stoppen, wechsel zurück in das Fenster, in dem er läuft und drücke STRG+C - Steuerung und C gleichzeitig (in Windows kann es sein, dass du STRG und Pause drücken musst).
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
 
 Glückwunsch! Du hast gerade deine erste Website erstellt und sie auf deinem Webserver laufen! Ist das nicht toll?
 
 ![Es hat funktioniert!](images/it_worked2.png)
 
-Bereit für den nächsten Schritt? Es wird Zeit, ein paar Inhalte hinzuzufügen!
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Bereit für den nächsten Schritt? Es wird Zeit, ein paar Inhalte hinzuzufügen!
\ No newline at end of file
diff --git a/de/django_templates/README.md b/de/django_templates/README.md
index 8a0e14d01b0..659c89e07a0 100644
--- a/de/django_templates/README.md
+++ b/de/django_templates/README.md
@@ -4,9 +4,9 @@ Es wird Zeit, ein paar Daten anzuzeigen! Django bringt dafür bereits ein paar s
 
 ## Was sind Template Tags?
 
-Also, in HTML kann man nicht wirklich Python-Code schreiben, weil es der Browser nicht verstehen würde. Er kennt nur HTML. Wir wissen, dass HTML, im Gegensatz zum dynamischeren Python, eher statisch ist.
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
 
-Die **Django Template Tags** helfen dabei, Python-Dinge in HTML auszudrücken, so dass man einfach und schnell dynamische Websites erstellen kann. Super!
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
 ## Anzeigen des Post-List-Templates
 
@@ -14,6 +14,8 @@ Im vorangegangen Kapitel haben wir unserem Template in der `posts`-Variable eine
 
 Um eine Variable in einem Django-Template darzustellen, nutzen wir doppelte, geschweifte Klammern mit dem Namen der Variable darin, so wie hier:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {{ posts }}
 ```
@@ -24,15 +26,19 @@ Versuche dies in deinem `blog/templates/blog/post_list.html` Template. Ersetze a
 
 Wie du siehst, haben wir nun das:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <QuerySet [<Post: My second post>, <Post: My first post>]>
 ```
 
 Das heißt, Django versteht es als Liste von Objekten. Kannst du dich noch an die Einführung von Python erinnern, wie man Listen anzeigen kann? Ja, mit for-Schleifen! In einem Django-Template benutzt du sie so:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
-    {{ post }}
+    {{ post }}
 {% endfor %}
 ```
 
@@ -40,19 +46,21 @@ Versuch das in deinem Template.
 
 ![Abbildung 13.2](images/step2.png)
 
-Es funktioniert! Aber wir wollen, dass die Posts so angezeigt werden, wie die statischen Posts, die wir vorhin im **Introduction to HTML** Kapitel erstellt haben. Du kannst HTML und Template Tags mischen. Unser `body` sollte dann so aussehen:
+Es funktioniert! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. Du kannst HTML und Template Tags mischen. Unser `body` sollte dann so aussehen:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <div>
-    <h1><a href="/">Django Girls Blog</a></h1>
+    <h1><a href="/">Django Girls Blog</a></h1>
 </div>
 
 {% for post in posts %}
-    <div>
-        <p>published: {{ post.published_date }}</p>
-        <h1><a href="">{{ post.title }}</a></h1>
-        <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endfor %}
 ```
 
@@ -60,37 +68,39 @@ Es funktioniert! Aber wir wollen, dass die Posts so angezeigt werden, wie die st
 
 ![Abbildung 13.3](images/step3.png)
 
-Ist dir aufgefallen, dass wir diesmal eine etwas andere Notation benutzen bei `{{ post.title }}` oder `{{ post.text }}`? Wir greifen auf Daten von jedem Feld unseres `Post`-Models zu. In den Posttexten konvertiert außerdem der `|linebreaks`-Befehl ("pipe") Zeilenumbrüche in Absätze.
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? Wir greifen auf Daten von jedem Feld unseres `Post`-Models zu. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
 
 ## Und zum Schluss
 
-Es wäre gut zu sehen, ob deine Website noch immer im öffentlichen Internet funktioniert, richtig? Lass uns versuchen, unsere Aktualisierungen wieder zu PythonAnywhere hochzuladen. Hier ist eine Zusammenfassung der Schritte...
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
 
 * Schiebe zuerst deinen Code auf GitHub
 
-```bash
-$ git status
-[...]
-$ git add --all .
-$ git status
-[...]
-$ git commit -m "Modified templates to display posts from database."
-[...]
-$ git push
-```
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
 
 * Dann logg dich wieder bei [PythonAnywhere](https://www.pythonanywhere.com/consoles/) ein und geh zu deiner **Bash-Konsole** (oder starte eine neue) und gib ein:
 
-```bash
-$ cd my-first-blog
-$ git pull
-[...]
-```
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull 
+    [...]
+    
 
-* Zum Schluss hüpf noch einmal kurz rüber zum [Web-Tab](https://www.pythonanywhere.com/web_app_setup/) und drück auf **Reload**. Deine Änderungen sollten jetzt live sein!
+* Zum Schluss hüpf noch einmal kurz rüber zum [Web-Tab](https://www.pythonanywhere.com/web_app_setup/) und drück auf **Reload**. Deine Änderungen sollten jetzt live sein! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
 
-Herzlichen Glückwunsch! Du kannst jetzt in der Django Admin Oberfläche neue Posts hinzufügen (denk daran published_date hinzuzufügen!), dann aktualisiere die Site, um zu sehen, ob der neue Post auch erscheint.
+Glückwunsch! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
 
-Funktioniert super? Wir sind stolz auf dich! Steh kurz ein bisschen vom Computer auf. Du hast dir eine Pause verdient :)
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
 
-![Abbildung 13.4](images/donut.png)
+![Abbildung 13.4](images/donut.png)
\ No newline at end of file
diff --git a/de/django_urls/README.md b/de/django_urls/README.md
index 445ebe0a8c9..4f0aeecade0 100644
--- a/de/django_urls/README.md
+++ b/de/django_urls/README.md
@@ -1,19 +1,21 @@
 # Django URLs
 
-Wir sind dabei, unsere erste Website zu erstellen --eine Homepage für unseren Blog! Aber zunächst lernen wir etwas über Django URLs.
+Gleich werden wir unsere erste Website basteln: eine Homepage für deinen Blog! Zuerst sollten wir uns jedoch mit Django URLs beschäftigen.
 
 ## Was ist eine URL?
 
-Eine URL ist einfach eine Web-Adresse. Jedes Mal, wenn du eine Website besuchst, kannst du eine URL sehen - sie ist in der Adressleiste des Browsers sichtbar (ja! `127.0.0.1:8000` ist eine URL! Und `https://djangogirls.com` ist auch eine URL!).
+Eine URL ist einfach eine Web-Adresse. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` ist eine URL! Und `https://djangogirls.org` ist auch eine URL.)
 
 ![URL](images/url.png)
 
-Jede Seite im Internet braucht ihre eigene URL. Dadurch weiß deine Applikation, was sie dem Nutzer, der eine URL öffnet, zeigen soll. In Django verwenden wir eine sogenannte `URLconf` (URL- Konfiguration). URLconf ist eine Ansammlung von Mustern, die Django mit der empfangenen URL abgleicht, um die richtige View zu finden, das heißt, um letztlich die richtige Seite für den Nutzer anzuzeigen.
+Jede Seite im Internet braucht ihre eigene URL. This way your application knows what it should show to a user who opens that URL. In Django verwenden wir eine sogenannte `URLconf` (URL- Konfiguration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
 
 ## Wie funktionieren URLs in Django?
 
 Öffne die `mysite/urls.py`-Datei in deinem Code-Editor nach Wahl und schaue dir an, wie sie aussieht:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
 """mysite URL Configuration
 
@@ -27,37 +29,39 @@ urlpatterns = [
 ]
 ```
 
-Wie du siehst, hat Django hier schon etwas für uns eingefügt.
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
 
-Zeilen, die mit `#` anfangen sind Kommentare - das bedeutet, dass diese Zeilen von Python nicht ausgeführt werden. Praktisch, oder?
+The admin URL, which you visited in previous chapter, is already here:
 
-Die admin-URL, die du im vorangegangenen Kapitel bereits besucht hast, ist schon da:
+{% filename %}mysite/urls.py{% endfilename %}
 
 ```python
-url(r'^admin/', admin.site.urls),
+    url(r'^admin/', admin.site.urls),
 ```
 
-Für jede URL, die mit `admin/` beginnt, wird Django die entsprechende View finden. Hier wurden einige admin-URLs eingefügt, dadurch wird nicht alles in eine Datei gepackt --es bleibt lesbarer und sauberer.
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
 
 ## Regex
 
 Du fragst dich, WIE Django die richtige View zu einer URL findet? Nun, das ist ein bisschen komplizierter. Django benutzt `regex` kurz für "regular expressions" (reguläre Ausdrücke). Regex besteht aus vielen Regeln (wirklich vielen!), aus denen ein Suchschema aufgebaut ist. Da Regexes ein fortgeschrittenes Thema sind, werden wir jetzt nicht im Detail darauf eingehen, wie sie genau funktionieren.
 
-Wenn du trotzdem immer noch verstehen willst, wie wir die Muster erstellt haben, folgt hier ein kleines Beispiel. Wir brauchen nur eine eingeschränkte Menge der vorhandenen Regeln, um das Muster, nach dem wir suchen, auszudrücken, nämlich:
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
 
-* `^` für den Anfang eines Textes
-* `$` für das Ende eines Textes
-* `\d` für eine Nummer
-* `+` um anzuzeigen, dass das vorhergehende Element mind. 1 mal wiederholt werden soll
-* `()` um Teile des Musters zu erfassen
+* `^` für den Anfang des Textes
+* `$` für den Ende des Textes
+* `\d` für eine Zahl
+* `+` um zu zeigen, dass das vorherige Objekt mindestens einmal wiederholt werden soll
+* `()` to capture part of the pattern
 
-Alles andere in der URL-Definition wird wörtlich genommen.
+Anything else in the URL definition will be taken literally.
 
-Jetzt stell dir vor, du hast eine Website mit der Adresse: `http://www.mysite.com/post/12345/` wobei `12345` die Nummer deines Posts ist.
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
 
-Eigene Views für jeden einzelnen Post zu schreiben, wäre ziemlich nervig. Mit regulären Asudrücken können wir ein Muster erstellen, welches auf die URL passt und die Nummer extrahieren wird: `^post/(\d+)/$`. Lass es uns in kleine Häppchen aufteilen, um zu verstehen, was wir hier genau tun:
+Eigene Views für jeden einzelnen Post zu schreiben, wäre ziemlich nervig. Mit regulären Ausdrücken können wir Ausdrücke schreiben, die aus einer URL die Zahlen herausfiltern: `^post/(\d+)/$`. Lass es uns in kleine Häppchen aufteilen, um zu verstehen, was wir hier genau tun:
 
-* **^post/** veranlasst Django, alles in Betracht zu ziehen, das `post/` am Anfang der URL hat (gleich nach `^`)
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
 * **(\d+)** steht für eine Zahl (eine oder mehrere Ziffern) und wir wollen diese Zahl erfassen und auswerten
 * **/** sagt Django, dass ein weiteres `/` Zeichen folgen soll
 * **$** steht für das Ende der URL mit der Bedeutung, dass nur Zeichenfolgen, die auf `/` enden, dem Muster entsprechen
@@ -66,14 +70,17 @@ Eigene Views für jeden einzelnen Post zu schreiben, wäre ziemlich nervig. Mit
 
 Es wird Zeit, deine erste URL zu erstellen! Wir wollen, dass 'http://127.0.0.1:8000/' die Homepage unseres Blogs wird und eine Liste unserer Posts zeigt.
 
-Wir wollen auch, dass die `mysite/urls.py`-Datei sauber bleibt. Deshalb importieren wir die URLs unserer Blog-Applikation in die `mysite/urls.py`-Hauptdatei.
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
 
-Fang damit an, die auskommentierten Zeilen (Zeilen mit `#`) zu löschen und füge die Zeile hinzu, die unsere `blog.urls` in die Haupt-URL importieren wird (`''`).
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
 
 Deine `mysite/urls.py`-Datei sollte jetzt so aussehen:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import include
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
@@ -88,33 +95,35 @@ Beim Schreiben von regulären Ausdrücken in Python benutzt man immer das `r` vo
 
 ## blog.urls
 
-Erstelle eine neue, leere Datei `blog/urls.py`. Alles klar! Füge nun diese beiden Zeilen hinzu:
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
 from . import views
 ```
 
-Hier importieren wir erstmal nur die Methoden von Django und alles aus den `views` unserer `blog` Applikation (wir haben noch keine, aber dazu kommen wir gleich!).
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
 
 Danach können wir unser erstes URL-Pattern hinzufügen:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
 ]
 ```
 
-Hier haben wir nun einen `view` mit dem Namen `post_list` zur `^$`-URL hinzugefügt. Dieser reguläre Ausdruck passt auf einen Anfang `^` gefolgt von einem Ende `$` - das heißt, nur eine leere Zeichenfolge kann dieses Muster erfüllen. Und das ist auch richtig so! Denn die Django URL-Auflösung erkennt 'http://127.0.0.1:8000/' nicht als Teil der URL an. Wenn jemand deine Website mit der Adresse 'http://127.0.0.1:8000/' aufruft, passt dieses Muster (leere Zeichenkette) und Django weiß so, dass `views.post_list` das gewünschte Ziel ist.
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. Und das ist auch richtig so! Denn die Django URL-Auflösung erkennt 'http://127.0.0.1:8000/' nicht als Teil der URL an. Wenn jemand deine Website mit der Adresse 'http://127.0.0.1:8000/' aufruft, passt dieses Muster (leere Zeichenkette) und Django weiß so, dass `views.post_list` das gewünschte Ziel ist.
 
-Der letzte Teil `name='post_list'` ist der Name der URL, die genutzt wird, die View zu identifizieren. Dieser kann identisch mit dem Namen der View sein, kann aber auch etwas total Anderes sein. Wir werden später die benannten URLs in dem Projekt benutzen, daher ist es wichtig, jede URL in der App zu benennen. Wir sollten außerdem versuchen, solche Namen für URLs zu wählen, die einzigartig und einfach zu merken sind.
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. Dieser kann identisch mit dem Namen der View sein, kann aber auch etwas total Anderes sein. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
 
-Alles klar? Öffne http://127.0.0.1:8000/ in deinem Browser, um das Ergebnis zu sehen.
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
 
 ![Fehler](images/error1.png)
 
-Dort steht nicht mehr "It works"? Keine Sorge, es ist nur eine Fehlerseite. Nichts, wovor man Angst haben muss! Diese Seiten sind eigentlich sehr hilfreich:
-
-Dort steht, es gibt **no attribute 'post_list'**. Erinnert dich *post_list* an etwas? So haben wir unsere View genannt! Das heißt, dass alles bereits an Ort und Stelle ist, aber wir haben bislang einfach noch keine *View* erzeugt. Keine Sorge, das machen wir gleich.
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
 
-> Wenn du mehr über Django URLconfs lernen willst, dann öffne die offizielle Dokumentation: https://docs.djangoproject.com/en/1.8/topics/http/urls/
+> Wenn du mehr über Django URLconfs lernen willst, dann öffne die offizielle Dokumentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/de/django_views/README.md b/de/django_views/README.md
index f14762cef4c..7b139237d3a 100644
--- a/de/django_views/README.md
+++ b/de/django_views/README.md
@@ -1,8 +1,8 @@
-# Django Views - Zeit zum Gestalten!
+# Django views – time to create!
 
-Es wird jetzt Zeit, den Bug, den wir im letzten Kapitel erzeugt haben, zu beheben :)
+Es wird jetzt Zeit, den Bug, den wir im letzten Kapitel erzeugt haben, zu beheben! :)
 
-In der *View* schreiben wir die Logik unserer Anwendung. So werden Informationen aus dem `Model` abgefragt werden, welches du zuvor erzeugt hast und diese werden an ein `Template` weitergeben. Ein Template erzeugen wir im nächsten Kapitel. Views sind Python-Methoden, die ein bisschen komplizierter sind als die, die wir im Kapitel **Introduction to Python** kennengelernt haben.
+In der *View* schreiben wir die Logik unserer Anwendung. So werden Informationen aus dem `Model` abgefragt werden, welches du zuvor erzeugt hast und diese werden an ein `Template` weitergeben. Ein Template erzeugen wir im nächsten Kapitel. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
 
 Views kommen in die `views.py` Datei. Wir fügen nun also unsere *Views* zur Datei `blog/views.py` hinzu.
 
@@ -10,27 +10,35 @@ Views kommen in die `views.py` Datei. Wir fügen nun also unsere *Views* zur Dat
 
 OK, wir öffnen nun diese Datei und schauen was darin steht:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
 # Create your views here.
 ```
 
-Es steht noch nicht viel da. Die einfachste *View* kann folgendermaßen aussehen:
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Du siehst hier, dass wir eine Methode (`def`) mit dem Namen `post_list` definiert haben. Sie hat den Parameter `request`. In der Methode weisen wir mit `return` eine Rückgabe einer anderen Funktion namens `render` an. Diese wird unser Template `blog/post_list.html` erstellen (man sagt auch "rendern").
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
 
-Speichere die Datei, öffne http://127.0.0.1:8000/ im Browser und schau nach, was wir jetzt bekommen.
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
 
 Einen anderen Fehler! Lies dir durch, was da steht:
 
 ![Fehler](images/error.png)
 
-Logisch: *TemplateDoesNotExist*. Wir haben ja noch kein Template erstellt. Lass uns diesen Bug im nächsten Kapitel beheben!
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
 
-> Erfahre mehr über Django Views in der offiziellen Dokumentation: https://docs.djangoproject.com/en/1.10/topics/http/views/
+> Erfahre mehr über Django Views in der offiziellen Dokumentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/de/dynamic_data_in_templates/README.md b/de/dynamic_data_in_templates/README.md
index 5ac20a5d49c..ed5a6c0f278 100644
--- a/de/dynamic_data_in_templates/README.md
+++ b/de/dynamic_data_in_templates/README.md
@@ -1,42 +1,51 @@
 # Dynamische Daten in Templates
 
-Wir haben nun schon einige Dinge an verschiedenen Orten fertiggestellt: das `Post`-Model ist in der `models.py` definiert, wir haben die `post_list` in der `views.py` und das Template hinzugefügt. Aber wie schaffen wir es nun, dass unsere Posts wirklich im HTML-Template erscheinen? Denn wir wollen ja erreichen, dass bestimmte Inhalte (die in der Datenbank gespeicherten Models) auf schöne Weise in unserem Template anzeigt werden, richtig?
+Wir haben nun schon einige Dinge an verschiedenen Orten fertiggestellt: das `Post`-Model ist in der `models.py` definiert, wir haben die `post_list` in der `views.py` und das Template hinzugefügt. Aber wie schaffen wir es nun, dass unsere Posts wirklich im HTML-Template erscheinen? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
 
-Genau dafür sind die *Views* zuständig: die Verbindung zwischen den Models und den Templates. In unserer `post_list`-View müssen wir die Models adressieren, die wir anzeigen wollen und diese dem Template übergeben. Im Grunde entscheiden wir in der *View*, was (also welches Model) im Template angezeigt wird.
+Genau dafür sind die *Views* zuständig: die Verbindung zwischen den Models und den Templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
 
-Okay, und wie machen wir das jetzt?
+OK, so how will we achieve this?
 
 Wir öffnen unsere Datei `blog/views.py`. Bisher sieht unsere `post_list`-View folgendermaßen aus:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
 def post_list(request):
     return render(request, 'blog/post_list.html', {})
+
 ```
 
-Erinnerst du dich, als wir davon gesprochen haben, dass wir den Code in verschiedene Dateien einfügen müssen? Jetzt ist es an der Zeit, das Model, dass wir in `models.py` beschrieben haben, einzufügen. Wir fügen den Befehl `from .models import Post` folgendermaßen ein:
+Erinnerst du dich, als wir davon gesprochen haben, dass wir den Code in verschiedene Dateien einfügen müssen? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
 from .models import Post
 ```
 
-Der Punkt nach dem `from` bedeutet *current directory*, also das aktuelle Verzeichnis oder *current application*, aktuelle Anwendung. Da `views.py` und `models.py` im gleichen Verzeichnis liegen, können wir einfach den Punkt `.` und den Namen der Datei (ohne `.py`) benutzen. Dann ergänzen wir für den Import den Namen des Models (`Post`).
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Dann ergänzen wir für den Import den Namen des Models (`Post`).
 
-Und als nächstes? Um tatsächlich Blogposts aus dem `Post` Model anzusprechen, brauchen wir etwas, das `QuerySet` heißt.
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
 
 ## QuerySet
 
-Dir sollte jetzt schon ungefähr klar sein, wie QuerySets funktionieren. Wir haben darüber im Kapitel [Django ORM (QuerySets)](../django_orm/README.md) gesprochen.
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
 
-Wir wollen nun also eine Liste von Blogposts, die publiziert und nach `published_date` sortiert sind, ausgeben, oder? Das haben wir bereits im Kapitel QuerySets gemacht!
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-``` 
+```
 
-Diesen Code fügen wir jetzt in `blog/views.py` ein, indem wir es zur Funktion `def post_list(request)` hinzufügen:
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
@@ -48,16 +57,16 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Beachte, dass wir eine *Variable* für unser QuerySet erstellen: `posts`. Es ist sozusagen der Name unseres QuerySets. Ab jetzt bezeichnen wir das QuerySet mit diesem Namen.
-
-Ferner benutzt der Code die `timezone.now()`-Funktion, also müssen wir einen Import für `timezone` hinzufügen.
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
 
-Als Letztes fehlt noch, dass wir das `posts`-QuerySet dem Template übergeben (wie wir es dann anzeigen, wird im nächsten Kapitel erklärt).
+Beachte, dass wir eine *Variable* für unser QuerySet erstellen: `posts`. Es ist sozusagen der Name unseres QuerySets. Ab jetzt bezeichnen wir das QuerySet mit diesem Namen.
 
-In der `render`-Funktion haben wir schon einen Parameter `request` (also alles, was wir vom User über das Internet bekommen) und einen Template-Namen`'blog/post_list.html'` angegeben. Der letzte Parameter, der so aussieht: `{}` ist ein Ort, wo wir Informationen, welche das Template nutzt, einfügen können. Wir müssen diesen einen Namen geben (wir verwenden einfach wieder `'posts'` :) ). Es sollte nun so aussehen: `{'posts': posts}`. Bitte achte darauf, dass der Teil vor `:` ein String ist; das heißt, du musst ihn mit Anführungszeichen umschliessen `''`.
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. Wir müssen diesen einen Namen geben (wir verwenden einfach wieder `'posts'`). :) Es sollte nun so aussehen: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
 
 Am Ende sollte deine `blog/views.py` Datei folgendermaßen aussehen:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from django.utils import timezone
@@ -70,4 +79,4 @@ def post_list(request):
 
 Das war's! Nun gehen wir zurück ins Template und zeigen das QuerySet an!
 
-Wenn du mehr über QuerySets in Djago erfahren willst, dann sieh unter diesem Link nach: https://docs.djangoproject.com/en/1.10/ref/models/querysets/
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/de/extend_your_application/README.md b/de/extend_your_application/README.md
index 547329f4bce..a709b1a7d22 100644
--- a/de/extend_your_application/README.md
+++ b/de/extend_your_application/README.md
@@ -10,35 +10,39 @@ Wir haben bereits ein `Post`-Model, deshalb brauchen wir dieses nicht mehr zur `
 
 ## Erstelle eine Template-Verknüpfung
 
-Wir beginnen damit, einen Link in der `blog/templates/blog/post_list.html`-Datei zu erstellen. Bis jetzt sieht sie so aus:
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
 
 {% block content %}
-    {% for post in posts %}
-        <div class="post">
-            <div class="date">
-                {{ post.published_date }}
-            </div>
-            <h1><a href="">{{ post.title }}</a></h1>
-            <p>{{ post.text|linebreaksbr }}</p>
-        </div>
-    {% endfor %}
-{% endblock content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
 ```
 
 {% raw %}Wir wollen einen Link von einem Post-Titel in der Post-Liste zu einer Post-Detailseite haben. Ändern wir `<h1><a href="">{{ post.title }}</a></h1>`, so dass es zu der Detailseite verlinkt:{% endraw %}
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
 ```
 
 {% raw %}Es ist an der Zeit, das mysteriöse `{% url 'post_detail' pk=post.pk %}` zu erklären. Wie du dir wahrscheinlich schon denkst, bedeutet `{% %}`, dass wir Django Template Tags verwenden. Dieses Mal verwenden wir eines, dass eine URL für uns erzeugen wird! {% endraw %}
 
-`blog.views.post_detail` ist der Pfad zu einer `post_detail`-View, die wir erstellen wollen. Beachte bitte: `blog` ist der Name unserer App (das Verzeichnis `blog`), `views` kommt aus der `views.py`-Datei und der letzte Teil - `post_detail` - ist der Name der View.
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
 
-Wenn wir jetzt auf http://127.0.0.1:8000/ gehen, bekommen wir einen Fehler (so wie erwartet, da wir ja noch keine URL oder View für `post_detail` haben). Er wird folgendermaßen aussehen:
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
 
 ![NoReverseMatch error](images/no_reverse_match2.png)
 
@@ -48,7 +52,9 @@ Lass uns eine URL in `urls.py` für unsere `post_detail`-View erstellen!
 
 Wir wollen, dass Details unseres ersten Blogposts unter dieser URL angezeigt werden: http://127.0.0.1:8000/post/1/
 
-Lass uns eine URL in der Datei `blog/urls.py` anlegen, um Django auf die *View* hinzuweisen, genannt `post_detail`, welche einen ganzen Blogpost anzeigen wird. Füge die Zeile `url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail')` zu der Datei `blog/urls.py` hinzu. Die Datei sollte so aussehen:
+Lass uns eine URL in der Datei `blog/urls.py` anlegen, um Django auf die *View* hinzuweisen, genannt `post_detail`, welche einen ganzen Blogpost anzeigen wird. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. Die Datei sollte so aussehen:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
@@ -60,13 +66,17 @@ urlpatterns = [
 ]
 ```
 
-Dieser Teil `^post/(?P<pk>[0-9]+)/$` sieht beängstigend aus, aber hab keine Angst - wir erklären es dir: - es beginnt mit `^` --"Der Anfang" -`post/` bedeutet lediglich, die URL sollte nach dem Anfang das Wort **post** und **/** enthalten. So weit, so gut. `(?P<pk>[0-9]+)` - dieser Teil ist schwieriger. Er bedeutet, dass Django alles, was hier steht, in einer Variable namens `pk` zu einem View transferiert. `[0-9]` sagt uns, dass hier nur eine Zahl, kein Buchstabe, stehen darf (also alles zwischen 0 und 9). `+`bedeutet, dass hier mindestens eine (oder mehrere) Ziffer(n) stehen müssen. Also so etwas wie `http://127.0.0.1:8000/post//` geht nicht, aber `http://127.0.0.1:8000/post/1234567890/` ist genau richtig! Dann folgt ein `/` - wir brauchen also wieder einen **/** und `$` - "Ende"!
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
 
-Also wenn du `http://127.0.0.1:8000/post/5/` in deinen Browser eingibst, wird Django verstehen, dass du nach einer *View* suchst, die `post_detail` heißt und wird der *View* übergeben, dass die Variable `pk` gleich `5` lautet.
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. Er bedeutet, dass Django alles, was hier steht, in einer Variable namens `pk` zu einem View transferiert. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+`bedeutet, dass hier mindestens eine (oder mehrere) Ziffer(n) stehen müssen. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
 
-`pk` ist eine Abkürzung für `primary key`. Diese Bezeichnung wird oft in Django-Projekten benutzt. Du kannst deine Variable aber nennen, wie du willst (denk aber daran: Kleinbuchstaben und `_` anstelle von Leerzeichen). Zum Beispiel anstelle von `(?P<pk>[0-9]+)` können wir die Variable `post_id` nehmen, dieser Teil würde also `(?P<post_id>[0-9]+)` lauten.
+Also wenn du `http://127.0.0.1:8000/post/5/` in deinen Browser eingibst, wird Django verstehen, dass du nach einer *View* suchst, die `post_detail` heißt und wird der *View* übergeben, dass die Variable `pk` gleich `5` lautet.
 
-Ok, wir haben ein neues URL-Muster zu der Datei `blog/urls.py` hinzugefügt! Lass uns die Seite http://127.0.0.1:8000/ aktualisieren. Boom! Erneut ein Fehler! Wie erwartet!
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
 
 ![AttributeError](images/attribute_error2.png)
 
@@ -74,38 +84,46 @@ Erinnerst du dich, was der nächste Schritt ist? Natürlich: eine View hinzufüg
 
 ## Füge eine View hinzu
 
-Dieses Mal bekommt unsere *View* den extra Parameter `pk`. Unsere *View* muss diesen abfangen, richtig? Also definieren wir unsere Funktion mit `def post_detail(request, pk)`. Beachte, dass wir genau den gleichen Variablennamen benutzen müssen, wie in den URLs festgelegt (`pk`). Eine fehlerhafte Variable führt zu einem Fehler!
+This time our *view* is given an extra parameter, `pk`. Unsere *View* muss diesen abfangen, richtig? Also definieren wir unsere Funktion mit `def post_detail(request, pk)`. Beachte, dass wir genau den gleichen Variablennamen benutzen müssen, wie in den URLs festgelegt (`pk`). Eine fehlerhafte Variable führt zu einem Fehler!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
 
-Jetzt benötigen wir also genau einen bestimmten Blogpost. Diesen finden wir, indem wir ein Queryset folgendermaßen schreiben:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 Post.objects.get(pk=pk)
 ```
 
-Aber bei diesem Code gibt es ein Problem. Wenn es kein `Post`-Objekt mit diesem `primary key` (`pk`) gibt, bekommen wir einen schlimmen Fehler!
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
 
 ![DoesNotExist error](images/does_not_exist2.png)
 
-Das wollen wir nicht! Natürlich stellt uns Django etwas zur Verfügung, um dieses Problem zu umgehen: `get_object_or_404`. Wenn es kein `Post`-Objekt mit einem gegebenen `pk` gibt, wird eine schöne Seite angezeigt (die sogenannte `Page Not Found 404` Seite).
+Das wollen wir nicht! Natürlich stellt uns Django etwas zur Verfügung, um dieses Problem zu umgehen: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
 
 ![Page not found](images/404_2.png)
 
 Die gute Neuigkeit ist, dass du auch deine eigene `Page not found`-Seite ("Seite nicht gefunden"-Seite) erstellen und diese so hübsch gestalten kannst, wie du willst. Aber da das gerade nicht so wichtig ist, überspringen wir das erst einmal.
 
-Okay, es wird Zeit, die *View* zu unserer `views.py`-Datei hinzuzufügen!
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
 
-Wir öffnen `blog/views.py` und fügen folgenden Code zu den anderen "from"-Zeilen hinzu:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render, get_object_or_404
 ```
 
-Am Ende der Datei fügen wir unsere *View* hinzu:
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_detail(request, pk):
-    post = get_object_or_404(Post, pk=pk)
-    return render(request, 'blog/post_detail.html', {'post': post})
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
 ```
 
 Super. Lass uns nun http://127.0.0.1:8000/ aktualisieren.
@@ -118,33 +136,35 @@ Es hat funktioniert! Aber was passiert, wenn du auf den Link im Blog-Titel klick
 
 Oh nein! Ein anderer Fehler! Aber wir wissen ja schon, wie wir mit diesem umgehen, oder? Wir müssen ein Template hinzufügen!
 
-## Erzeuge ein Template
+## Create a template for the post details
 
 Wir erstellen eine Datei in `blog/templates/blog` mit dem Namen `post_detail.html`.
 
 Das sieht dann so aus:
 
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
 {% block content %}
-    <div class="post">
-        {% if post.published_date %}
-            <div class="date">
-                {{ post.published_date }}
-            </div>
-        {% endif %}
-        <h1>{{ post.title }}</h1>
-        <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endblock %}
 ```
 
 Wir erweitern wieder `base.html`. Im `content`-Block wollen wir das Publikationsdatum eines Posts (published_date), falls es existiert, anzeigen und auch den Titel und den Text. Aber wir müssen noch ein paar wichtige Dinge klären, oder?
 
-{% raw %}`{% if ... %} ... {% endif %}` ist ein Template-Tag, das wir nutzen können, um etwas zu überprüfen (erinnerst du dich: `if ...else ..</1> aus dem Kapitel <strong>Einführung in Python</strong>? In diesem Szenario wollen wir prüfen, ob ein <code>published_date` eines Blogposts leer ist. {% endraw %}
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
 
-Okay, wir aktualisieren die Seite und sehen, dass `Page not found` nun weg ist.
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
 
 ![Post Detailseite](images/post_detail2.png)
 
@@ -154,25 +174,24 @@ Yeah! Es funktioniert!
 
 Es wäre schön zu sehen, ob deine Website noch auf PythonAnywhere funktioniert, richtig? Lass sie uns erneut bereitstellen.
 
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
-$ git push
-```
+{% filename %}command-line{% endfilename %}
 
-* Dann führe Folgendes in der [PythonAnywhere Bash-Konsole](https://www.pythonanywhere.com/consoles/) aus:
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
 
-```
-$ cd my-first-blog 
-$ source myvenv/bin/activate 
-(myvenv)$ git pull 
-[...] 
-(myvenv)$ python manage.py collectstatic 
-[...]
-```
+Dann führe Folgendes in der [PythonAnywhere Bash-Konsole](https://www.pythonanywhere.com/consoles/) aus:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull 
+    [...]
+    
 
-* Springe nun noch schnell auf den [Web-Tab](https://www.pythonanywhere.com/web_app_setup/) und klicke auf **Reload**.
+Springe nun noch schnell auf den [Web-Tab](https://www.pythonanywhere.com/web_app_setup/) und klicke auf **Reload**.
 
-Und das war's! Glückwunsch :)
+Und das war's! Glückwunsch :)
\ No newline at end of file
diff --git a/de/how_the_internet_works/README.md b/de/how_the_internet_works/README.md
index 0cbd3642233..75440c77c09 100644
--- a/de/how_the_internet_works/README.md
+++ b/de/how_the_internet_works/README.md
@@ -1,49 +1,47 @@
 # Wie das Internet funktioniert
 
-> Tipp: Für dieses Kapitel existiert ein Video: [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
 
-> Inspiriert durch den Vortrag "How the Internet works" von Jessica McKellar (http://web.mit.edu/jesstess/www/).
-
-Wahrscheinlich nutzt du das Internet jeden Tag. Aber weißt du, was passiert, wenn du eine Adresse wie https://djangogirls.org im Browser aufrufst?
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
 
 Als Erstes solltest du wissen, dass eine Webseite meist nur ein paar Dateien auf der Festplatte sind. Genau wie deine Filme, Mp3s oder Bilder. Das Besondere an Webseiten ist, dass sie aus speziellem Computer-Code bestehen, das sogenannte HTML.
 
 Wenn du noch nie etwas mit Programmierung zu tun hattest, kann auch HTML zuerst abschreckend aussehen, aber dein Browser (Chrome, Safari, Firefox, etc.) liebt es. Browser sind so entworfen, dass sie diesen Code verstehen, seinen Anweisungen folgen können und diese Dateien, aus denen deine Website besteht, genau so darstellen, wie du es möchtest.
 
-Wie jede andere Datei auch, muss die HTML-Datei irgendwo auf einer Festplatte gespeichert werden. Für das Internet verwenden wir spezielle, leistungsstarke Computer, sogenannte *Server*. An ihnen sind normalerweise weder Bildschirm, Maus oder Tastatur angeschlossen, weil der Hauptzweck der Server darin besteht, Daten zu speichern und zur Verfügung zu stellen. Sie heißen *Server*, weil sie dem Internet und uns dienen - Englisch: to *serve*.
+Wie jede andere Datei auch, muss die HTML-Datei irgendwo auf einer Festplatte gespeichert werden. Für das Internet verwenden wir spezielle, leistungsstarke Computer, sogenannte *Server*. An ihnen sind normalerweise weder Bildschirm, Maus oder Tastatur angeschlossen, weil der Hauptzweck der Server darin besteht, Daten zu speichern und zur Verfügung zu stellen. That's why they're called *servers* – because they *serve* you data.
 
-Okay, aber wie funktioniert dieses Internet jetzt genau?
+OK, but you want to know how the Internet looks, right?
 
 Wir haben ein Bild gemalt. So sieht es aus:
 
 ![Abbildung 1.1](images/internet_1.png)
 
-Ziemliches Durcheinander, oder? Eigentlich ist es ein Netzwerk aus verbundenen Computern (den oben genannten *Servern*). Hunderttausende von Rechnern! Kilometer über Kilometer Kabel rund um die Welt. Auf einer Webseite über Unterseekabel (https://submarinecablemap.com/) kannst du dir ein Bild von der Komplexität des Netzes machen. Hier ist ein Screenshot der Seite:
+Ziemliches Durcheinander, oder? In fact it is a network of connected machines (the above-mentioned *servers*). Hunderttausende von Rechnern! Kilometer über Kilometer Kabel rund um die Welt. Auf einer Webseite über Unterseekabel (http://submarinecablemap.com/) kannst du dir ein Bild von der Komplexität des Netzes machen. Hier ist ein Screenshot der Seite:
 
 ![Abbildung 1.2](images/internet_3.png)
 
-Faszinierend, oder? Offensichtlich ist es nicht möglich, Kabel zwischen allen Servern des Internet zu schalten. Um den Server, auf dem z.B. https://djangogirls.org gespeichert ist, zu erreichen, muss unsere Anfrage sehr viele andere Maschinen passieren.
+Faszinierend, oder? Offensichtlich ist es nicht möglich, Kabel zwischen allen Servern des Internet zu schalten. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
 
 Das sieht ungefähr so aus:
 
 ![Abbildung 1.3](images/internet_2.png)
 
-Stell dir vor, wenn du https://djangogirls.org in den Browser eingibst, würdest du einen Brief versenden, in dem steht; "Hallo Django Girls, ich möchte die djangogirls.org Webseite ansehen. Bitte schickt sie mir!"
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
 
 Der Brief kommt ins Postamt in deiner Nähe. Von da aus kommt der Brief zu einem anderen Postamt näher an der Zieladresse und näher und näher, bis der Brief zugestellt werden kann. Die einzigartige Sache ist, dass wenn du mehrere Briefe zu der selben Adresse abschickst (*Datenpakete*), jeder einzelne durch komplett unterschiedliche Poststellen laufen könnte (*Router*). Dies hängt davon ab, wie sie an jedem Standort verteilt werden.
 
 ![Abbildung 1.4](images/internet_4.png)
 
-So einfach ist das im Prinzip. Du sendest Nachrichten und erwartest eine Antwort. Anstelle von Papier und Stift verwendest du Daten (Byte für Byte), aber die Idee ist dieselbe.
-
-Anstelle von Adressen mit Straße, Ort und Postleitzahl verwenden wir IP-Adressen. IP steht für Internet Protocol. Ein Protokoll kann man mit einer Vereinbarung vergleichen, darin wird festgelegt, wie etwas funktionieren soll, ein allgemein gültiger Standard also. Im Internet Protocol steht zum Beispiel auch, wie eine IP-Adresse aufgebaut werden muss.
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
 
-Um die von Menschen besser lesbare Adresse "djangogirls.org" in eine IP-Adresse, die von Maschinen besser lesbar ist, umzuwandeln, fragt dein Computer das DNS (Domain Name System). Das DNS ist ein bisschen wie ein altmodisches Telefonbuch aus Papier, in dem du zu einem bestimmten Namen Telefonnummer und Adresse nachgucken kannst.
+Anstelle von Adressen mit Straße, Ort und Postleitzahl verwenden wir IP-Adressen. IP steht für Internet Protocol. Dein Computer fragt erst das DNS (Domain Name System), um die (von Menschen besser lesbare) Adresse djangogirls.org in die (besser von Maschinen lesbare) IP-Adresse umzuwandeln. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
 
-Wenn du einen Brief versenden willst, brauchst du spezielle Dinge wie: Postanschrift, Briefmarke etc. Außerdem musst du eine Sprache verwenden, die der Empfänger versteht, logisch. Das gleiche gilt auch für die *Datenpakete*, die du sendest, um eine Website betrachten zu können. Wir verwenden einen vereinbarten Standard, ein Protokoll namens HTTP (Hypertext Transfer Protocol) oder HTTPS (Hypertext Transfer Protocol Secure).
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Außerdem musst du eine Sprache verwenden, die der Empfänger versteht. Das gleiche gilt für die *Datenpakete*, die du sendest, um eine Website betrachten zu können. Wir verwenden ein Protokoll namens HTTP (Hypertext Transfer Protocol).
 
-Grundsätzlich brauchst du also für eine Website auch einen *Server*, auf dem sie abgelegt ist. Wenn der *Server* eine eingehende *Anforderung (Request)* (in einem Brief) empfängt, sendet er deine Website zurück (in einem weiteren Brief).
+Grundsätzlich brauchst du also für eine Website auch einen *Server*, auf dem sie abgelegt ist. Wenn der *Server* eine eingehende *Anforderung* (in einem Brief) empfängt, sendet er deine Website zurück (in einem weiteren Brief).
 
-Da dies hier ein Django-Tutorial ist, fragst du dich sicher, was Django in diesem Zusammenhang macht!? Wenn du (bzw. dein Webserver) eine Antwort zurück sendest, willst du nicht an jeden dasselbe senden. Es ist besser, wenn die Antworten individuell personalisiert sind, entsprechend dem an dich gerichteten Anliegen. Django hilft dir, diese personalisierten Antworten zu erstellen.
+Since this is a Django tutorial, you might ask what Django does. Wenn du (bzw. dein Webserver) eine Antwort zurück sendest, willst du nicht an jeden dasselbe senden. Es ist besser, wenn die Antworten individuell personalisiert sind, entsprechend dem an dich gerichteten Anliegen. Django helps you with creating these personalized, interesting letters. :)
 
-Genug der Theorie, lass uns loslegen!
+Enough talk – time to create!
\ No newline at end of file
diff --git a/de/html/README.md b/de/html/README.md
index 382ec828e8c..26a4a0e66e6 100644
--- a/de/html/README.md
+++ b/de/html/README.md
@@ -2,15 +2,15 @@
 
 Vielleicht fragst du dich, was ein Template (Vorlage) ist?
 
-Ein Template (zu deutsch "Vorlage") ist eine Textdatei und ermöglicht es uns, verschiedene Inhalte in einer einheitlichen Darstellung zu erzeugen. Eine Vorlage für z.B. einen Brief hilft uns, immer gleich aussehende Nachrichten zu versenden, in denen sich Empfänger, Betreff und Text jeweils ändern, das äußere Format jedoch bestehen bleibt.
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
 
-Ein Django-Template wird mit einer Sprache namens HTML beschrieben. (Genau das HTML aus dem ersten Kapitel: **Wie das Internet funktioniert**).
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
 
 ## Was ist HTML?
 
-HTML ist recht einfacher Code, der von deinem Browser - z.B. Chrome, Firefox oder Safari - interpretiert wird, um dem Benutzer eine Website darzustellen.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
-HTML bedeutet "HyperText Markup Language". Als **HyperText** wird Text bezeichnet, der über markierte Textstellen, den "Hyperlinks" (die umgangssprachlichen "Links") auf andere (meist ebenfalls in HTML geschriebene) Seiten verweist. **Markup** bedeutet, dass wir ein Dokument nehmen und mit Code versehen, um einem Empfänger mitzuteilen (in diesem Fall dem Browser), wie diese Seite interpretiert werden muss. HTML-Code besteht aus **Tags**. Jeder Tag startet mit `<` und endet mit `>`. Diese Tags stellen die Markup-**Elemente** dar.
+HTML bedeutet "HyperText Markup Language". Als **HyperText** wird Text bezeichnet, der über markierte Textstellen, den "Hyperlinks" (die umgangssprachlichen "Links") auf andere (meist ebenfalls in HTML geschriebene) Seiten verweist. **Markup** bedeutet, dass wir ein Dokument nehmen und mit Code versehen, um einem Empfänger mitzuteilen (in diesem Fall dem Browser), wie diese Seite interpretiert werden muss. HTML-Code besteht aus **Tags**, wovon jeder mit `<` beginnt und mit `>` endet. Diese Tags stellen die Markup-**Elemente** dar.
 
 ## Dein erstes Template!
 
@@ -18,19 +18,18 @@ Ein Template zu erstellen, heißt, eine entsprechende Datei dafür zu erstellen.
 
 Templates werden im Verzeichnis `blog/templates/blog` gespeichert. Als Erstes erzeugen wir das Verzeichnis `templates` in deinem Blog-Verzeichnis. Im Template-Verzeichnis selbst erstellen wir ein weiteres Verzeichnis `blog`:
 
-```
-blog
-└───templates
-    └───blog
-```
+    blog
+    └───templates
+        └───blog
+    
 
-(Falls du dich wunderst, warum wir zwei `blog`-Verzeichnisse brauchen - das hängt mit den nützlichen Namenskonventionen von Django zusammen, die das Leben einfacher machen, wenn deine Projekte immer komplizierter und komplexer werden.)
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
 
 Als nächstes erstellen wir eine Datei `post_list.html` (erst mal ohne Inhalt) innerhalb des Verzeichnisses `blog/templates/blog`.
 
 Kontrolliere deine überarbeitete Webseite unter: http://127.0.0.1:8000
 
-> Falls du die Fehlermeldung `TemplateDoesNotExists` angezeigt bekommst, versuche den Server neu zu starten. Öffne die Konsole, stoppe den Server mit Strg+C (Steuerung and C Tasten zusammen drücken) und starte ihn neu mit dem `python manage.py runserver` Kommando.
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
 
 ![Abbildung 11.1](images/step1.png)
 
@@ -38,6 +37,8 @@ Der Fehler sollte weg sein! Toll :) Deine Webseite ist allerdings noch leer, wei
 
 Füge folgenden Text in deine Template-Datei ein:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <p>Hi there!</p>
@@ -45,16 +46,16 @@ Füge folgenden Text in deine Template-Datei ein:
 </html>
 ```
 
-Hat sich die Seite geändert? Sieh nach: http://127.0.0.1:8000/
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
 
 ![Abbildung 11.2](images/step3.png)
 
 Es funktioniert! Gute Arbeit! :)
 
-* Jede Webseite sollte mit dem Tag `<html>` beginnen. Und `</html>` steht immer am Ende. Zwischen den beiden Tags `<html>` und `</html>` steht der gesamte Inhalt der Webseite
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. Zwischen den beiden Tags `<html>` und `</html>` steht der gesamte Inhalt der Webseite
 * `<p>` ist der Tag für ein Absatz-Element (paragraph), `</p>` beendet einen Absatz
 
-## Head & body
+## Head and body
 
 Jede HTML Seite gliedert sich in zwei Teile: **head** und **body**.
 
@@ -64,7 +65,9 @@ Jede HTML Seite gliedert sich in zwei Teile: **head** und **body**.
 
 Im `<head>` informieren wir den Browser über Einstellungen und Konfigurationen der Webseite, z.B. wie sie dargestellt werden soll, und im `<body>` darüber, was tatsächlich dargestellt werden soll.
 
-In den `<head>` können wir z.B. noch den Titel (title) der Seite mit aufnehmen:
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -86,24 +89,30 @@ Der Titel "Ola's blog" wird nun im Browser angezeigt. Hast du es bemerkt? Der Br
 
 Wie du vielleicht bemerkt hast, hat jedes Element zu Beginn einen öffnenden Tag und einen zugehörigen *schließenden Tag* mit `/` und die Elemente sind darin *eingebettet*. Ein Tag in einem zweiten kann nicht außerhalb von diesem geschlossen werden, die Reihenfolge muss immer stimmen.
 
-Es ist wie Sachen in Kisten stecken. In die größte Box: `<html></html>` kommt eine kleinere Box: `<body></body>`, und dort wiederum packen wir viele kleine Kisten hinein: `<p></p>`.
+Es ist wie Sachen in Kisten stecken. In die größte Box: `<html></html>` kommt eine kleinere Box: `<body></body>`, und dort wiederum packen wir viele kleine Kisten hinein: </code>`&lt;p&gt;&lt;/p&gt;</0>.</p>
+
+<p>You need to follow these rules of <em>closing</em> tags, and of <em>nesting</em> elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.</p>
 
-Die Regeln und Reihenfolgen von _schließenden_ Tags und _Verschachtelung_ der Elemente musst du immer einhalten. Anderenfalls können Browser die Seite nicht richtig interpretieren und darstellen.
+<h2>Dein Template anpassen</h2>
 
-## Dein Template anpassen
+<p>Jetzt kannst du ein bisschen rumprobieren und dein Template umgestalten! Hier sind ein paar nützliche Tags dafür:</p>
 
-Jetzt kannst du ein bisschen rumprobieren und dein Template umgestalten! Hier sind ein paar nützliche Tags dafür:
+<ul>
+<li><code><h1>A heading</h1>` for your most important heading</li> 
 
-* `<h1>Überschrift</h1>` - (headline) für wichtigste Überschriften
 * `<h2>Unter-Überschrift</h2>` die nächst tiefere Überschiftenebene
-* `<h3>Unter-Unter-Überschrift</h3>` ... und so weiter bis `<h6>`
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
 * `<em>Text</em>` hebt deinen Text hervor
 * `<strong>Text</strong>` macht deinen Text fett
-* `<br />` fängt eine neue Zeile an (du kannst nichts zwischen br schreiben)
-* `<a href="http://djangogirls.org">link</a>` erstellt einen Link
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` erstellt einen Link
 * `<ul><li>Erster Punkt</li><li>second item</li></ul>` generiert eine Liste so wie diese hier!
 * `<div></div>` definiert einen Abschnitt auf einer Seite</ul> 
-Hier ein Beispiel eines vollständigen Templates:
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -112,36 +121,36 @@ Hier ein Beispiel eines vollständigen Templates:
     </head>
     <body>
         <div>
-            <h1><a href="">Django Girls Blog</a></h1>
+            <h1><a href="/">Django Girls Blog</a></h1>
         </div>
 
         <div>
             <p>published: 14.06.2014, 12:14</p>
             <h2><a href="">My first post</a></h2>
             <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
-        </div>
-
-        <div>
-            <p>published: 14.06.2014, 12:14</p>
-            <h2><a href="">My second post</a></h2>
-            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
-        </div>
-    </body>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
 </html>
 ```
 
 Wir haben hier drei verschiedene `div` Abschnitte erstellt.
 
-* Das erste `div` Element enthält den Titel unseres Blogs - eine Überschrift und einen Link
+* The first `div` element contains the title of our blog – it's a heading and a link
 * Zwei weitere `div` Elemente beinhalten unsere Blogposts und ein Publikationsdatum, `h2` mit dem Titel des Posts und zwei `p` (paragraph) Tags mit Text, eines für das Datum und eines für den Blogpost.
 
 Wir bekommen das Folgende:
 
 ![Abbildung 11.4](images/step6.png)
 
-Yaaay! Bis jetzt zeigt unser Template aber immer genau die **gleichen Inhalte** - obwohl wir aber vorhin davon gesprochen haben, dass Templates uns erlauben, **verschiedene** Informationen im **gleichen Format** darzustellen.
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
 
-Eigentlich wollen wir richtige Posts anzeigen, die in unserer Django Admin Oberfläche hinzugefügt wurden - und das wollen wir als Nächstes tun.
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
 
 ## Noch eine Sache: Deployment!
 
@@ -151,53 +160,56 @@ Es wäre gut, das alles live draußen im Internet zu sehen, oder? Lass uns noch
 
 Lass uns nachsehen, welche Dateien sich nach dem letzten Veröffentlichen (Deployment) geändert haben. (Führe diese Befehle lokal aus und nicht auf PythonAnywhere):
 
-```bash
-$ git status
-```
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
 
 Überprüfe, ob du im `Djangogirls` Verzeichnis bist und sag `git`, dass alle Änderungen in diesem Verzeichnis hinzugefügt werden sollen:
 
-```bash
-$ git add --all .
-```
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
 
-> **Beachte:** `-A` (kurz für "all") bedeutet, dass `git` auch Dateien berücksichtigt, die du gelöscht hast (in der Standardeinstellung werden nur neue/geänderte Dateien hinzugefügt). Denk auch daran (Kapitel 3), dass `.` das aktuelle Verzeichnis meint.
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Denk auch daran (Kapitel 3), dass `.` das aktuelle Verzeichnis meint.
 
 Bevor wir alle Dateien hochladen prüfen wir noch einmal, was `git` hochladen will (alle Dateien, die `git` hochladen wird, sind jetzt grün):
 
-```bash
-$ git status
-```
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
 
 Fast fertig, wir sagen nun noch, dass diese Änderung in der Verlaufsübersicht gespeichert werden soll. Wir erstellen eine "Commit Message", die beschreibt, was wir verändert haben. Du kannst an diesem Punkt hier alles reinschreiben, aber es ist sehr nützlich, etwas zu Sinnvolles einzutragen, damit du dich in Zukunft erinnern kannst, was du geändert hast.
 
-```bash
-$ git commit -m "HTML der Site geändert."
-```
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "HTML der Site geändert."
+    
 
 > **Beachte:** Du musst Anführungszeichen um den Commit-Kommentar setzen.
 
-Nachdem wir das gemacht haben, laden (push) wir unsere Änderungen auf GitHub:
+Once we've done that, we upload (push) our changes up to GitHub:
 
-```bash
-$ git push
-``` 
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
 
 ### Hol dir den neuen Code auf PythonAnywhere und aktualisiere deinen Browser
 
 * Öffne die [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) und gehe zu deiner **Bash-Konsole** (oder starte eine neue). Dann, führe Folgendes aus:
 
-```bash
-$ cd ~/my-first-blog 
-$ source myvenv/bin/activate 
-(myvenv)$ git pull 
-[...] 
-(myvenv)$ python manage.py collectstatic 
-[...]
-```bash
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
 
 Schau zu, wie dein Code runtergeladen wird! Wenn du prüfen willst, ob der Code angekommen ist, kannst du zum **Files Tab** rüberspringen und deinen Code auf PythonAnywhere sehen.
 
 * Spring anschließend rüber zum [Web Tab](https://www.pythonanywhere.com/web_app_setup/) und klick auf **Neu laden** in deinem Browser.
 
-Dein Update sollte live sein! Lade die Seite neu in deinem Browser. Es sollten nun Änderungen zu sehen sein. :)
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/de/install_git.md b/de/install_git.md
new file mode 100644
index 00000000000..1532e55778e
--- /dev/null
+++ b/de/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Git installieren
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/de/installation/README.md b/de/installation/README.md
index dd0a0958e48..c37c66a4893 100644
--- a/de/installation/README.md
+++ b/de/installation/README.md
@@ -1,10 +1,10 @@
 # Wenn Du dieses Tutorial zu Hause bearbeitest
 
-Wenn Du dieses Tutorial zu Hause bearbeitest, und nicht auf einer der ["Django Girls"-Veranstaltungen](http://djangogirls.org/events/), kannst du dieses Kapitel komplett überspringen und gleich zum Kapitel [Wie funktioniert das Internet?](../how_the_internet_works/README.md) gehen.
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
 
-Wir werden die folgenden Punkte so oder so im vollständigen Tutorial betrachten. Das hier ist nur eine zusätzliche Seite, die alle Installationsanleitungen an einem Ort bündelt. Die "Django Girls"-Veranstaltung enthält einen "Installationsabend", an dem wir alles installeren, damit wir uns während des Workshops nicht damit beschäftigen müssen. Diese Seite ist für uns daher sehr hilfreich.
+Wir werden die folgenden Punkte so oder so im vollständigen Tutorial betrachten. Das hier ist nur eine zusätzliche Seite, die alle Installationsanleitungen an einem Ort bündelt. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
 
-Wenn es Dir sinnvoll erscheint, kannst du dieses Kapitel natürlich auch bearbeiten. Wenn Du jedoch mit dem Lernen beginnen willst, bevor du eine handvoll Sachen auf deinem Computer installierst, überspringe dieses Kapitel und lies unsere Erklärungen zur Installation später im Tutorial.
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
 
 Viel Erfolg!
 
@@ -12,38 +12,47 @@ Viel Erfolg!
 
 Im Workshop wirst Du einen Blog erstellen und es gibt einige Dinge, bei denen es besser ist, wenn Du sie vorher vorbereitest, so dass Du gleich mit dem Programmieren loslegen kannst.
 
-## Python installieren
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Python installieren
 
 {% include "/python_installation/instructions.md" %}
 
-## Virtualenv einrichten und Django installieren
+# Virtualenv einrichten und Django installieren
 
 {% include "/django_installation/instructions.md" %}
 
-## Einen Code Editor installieren
+# Einen Code Editor installieren
 
-{% include "/code_editor/instructions.md" %}
+{% include "code_editor/instructions.md" %}
 
-## Git installieren
+# Git installieren
 
-{% include "/code_editor/instructions.md" %}
+{% include "/deploy/install_git.md" %}
 
-## Einen GitHub-Account einrichten
+# Einen GitHub-Account einrichten
 
-Öffne [GitHub.com](http://www.github.com) und richte Dir einen neuen, kostenfreien Nutzeraccount ein.
+Gehe auf [GitHub.com](https://www.github.com) eröffne ein neues, kostenloses Konto.
 
-## Einen PythonAnywhere-Account erstellen
+# Einen PythonAnywhere-Account erstellen
 
 {% include "/deploy/signup_pythonanywhere.md" %}
 
-## Fang an zu lesen!
+# Fang an zu lesen!
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [Wie funktioniert das Internet?](../how_the_internet_works/README.md)
 
-Herzlichen Glückwunsch, Du hast alles eingerichtet und bist nun bereit, loszulegen. Wenn Du vor dem Workshop noch etwas Zeit hast, wäre es hilfreich, einige der einführenden Kapitel zu lesen:
+* [Einführung in die Kommandozeile](../intro_to_command_line/README.md)
 
-  * [Wie funktioniert das Internet?](../how_the_internet_works/README.md)
+* [Einführung in Python](../python_introduction/README.md)
 
-  * [Einführung in die Kommandozeile](../intro_to_command_line/README.md)
+* [Django - Was ist das?](../django/README.md)
 
-  * [Einführung in Python](../intro_to_command_line/README.md)
+# Enjoy the workshop!
 
-  * [Was ist Django?](../django/README.md)
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/de/instructions.md b/de/instructions.md
new file mode 100644
index 00000000000..207e154185c
--- /dev/null
+++ b/de/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Runteraden der *Mac OS X 64-bit/32-bit installer*-Datei,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/de/intro_to_command_line/README.md b/de/intro_to_command_line/README.md
index b009c41245b..6d14c8bbe6f 100644
--- a/de/intro_to_command_line/README.md
+++ b/de/intro_to_command_line/README.md
@@ -1,77 +1,110 @@
 # Einführung in die Kommandozeile
 
-Uuh, aufregend, oder?! In ein paar Minuten wirst du deine erste Zeile Code schreiben :)
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
 
 **Erstmal stellen wir dir deine neue Freundin vor: Die Konsole!**
 
 Im Folgenden zeigen wir dir, wie du das schwarze Fenster benutzt, das alle Hackerinnen nutzen. Es sieht vielleicht erstmal etwas unheimlich aus, aber es ist nur ein Programm, das darauf wartet, Anweisungen von dir zu bekommen.
 
-> **Hinweis:** Bitte beachte, dass wir in dem gesamten Buch die Begriffe "Verzeichnis" und "Ordner" abwechselnd gebrauchen, aber sie stehen für ein und dasselbe.
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
 
 ## Was ist die Konsole?
 
-Das Fenster, welches gewöhnlich die **Kommandokonsole** (command line) oder **Kommandoleisten-Interface** (command-line interface) genannt wird, ist eine textbasierte Applikation zum Betrachten, Bearbeiten und Manipulieren von Dateien auf deinem Computer. Ähnlich wie der Windows Explorer oder der Finder auf dem Mac, aber ohne die grafische Benutzeroberfläche. Andere Bezeichnungen dafür sind: cmd, CLI, prompt, Eingabeaufforderung, Kommandozeile, Konsole, Terminal.
+Das Fenster, welches gewöhnlich die **Kommandokonsole** (command line) oder **Kommandoleisten-Interface** (command-line interface) genannt wird, ist eine textbasierte Applikation zum Betrachten, Bearbeiten und Manipulieren von Dateien auf deinem Computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Andere Bezeichnungen dafür sind: cmd, CLI, prompt, Eingabeaufforderung, Kommandozeile, Konsole, Terminal.
 
 ## Öffnen der Konsole
 
 Um mit unserem Tutorial zu starten, musst du als Erstes das Kommandozeilenprogramm starten.
 
-### Windows
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
 
-Geh ins Start Menü → Alle Programme → Zubehör → Eingabeaufforderung.
+<!--endsec-->
 
-### Mac OS X
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
 
-Programme → Zubehör → Terminal.
+Go to Applications → Utilities → Terminal.
 
-### Linux
+<!--endsec-->
 
-Wahrscheinlich ist es unter Programme → Zubehör → Terminal, aber das ist von deinem System abhängig. Wenn es nicht da ist, google einfach schnell danach :)
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Wahrscheinlich ist es unter Programme → Zubehör → Terminal, aber das ist von deinem System abhängig. Wenn es nicht da ist, google einfach schnell danach. :)
+
+<!--endsec-->
 
 ## Eingabeaufforderung (Prompt)
 
 Du solltest nun ein weißes oder schwarzes Fenster sehen, das auf deine Anweisungen wartet.
 
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
 Auf einem Mac oder Linux, siehst du wahrscheinlich `$`, also so:
 
-```bash
-$
-```
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
 
 Auf Windows siehst du ein `>` Zeichen, also das hier:
 
-```bash
->
-```
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
 
-Vor jedem Kommando wird dieses Zeichen und ein Leerzeichen vorangestellt, aber du musst das nicht hinschreiben. Dein Computer macht das für dich :)
+Vor jedem Kommando wird dieses Zeichen und ein Leerzeichen vorangestellt, aber du musst das nicht hinschreiben. Dein Computer macht das für dich. :)
 
-> Ein kleiner Hinweis: Falls du etwas in der Art wie `C:\Users\ola>` oder `Olas-MacBook-Air:~ ola$` sehen solltest, ist das auch 100%ig korrekt. In diesem Tutorial werden wir das Ganze auf das einfachste Minimum herunterbrechen.
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
 
 ## Dein erstes Kommando (YAY!)
 
-Fangen wir mit etwas Einfachem an. Schreibe folgenden Befehl:
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
 
-```bash
-$ whoami
-```
+<!--endsec-->
 
-oder
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
 
-```bash
-> whoami
-```
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
 
 Und dann betätige mit `Enter`. Das ist unser Ergebnis:
 
-```bash
-$ whoami
-olasitarska
-```
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
 
-Wie du sehen kannst, hat der Computer gerade deinen Benutzernamen ausgegeben. Toll, was? :)
+As you can see, the computer has just printed your username. Neat, huh? :)
 
-> Versuch, jeden Befehl abzuschreiben und nicht zu kopieren und einzufügen. Auf diese Weise wirst du dir mehr merken!
+> Try to type each command; do not copy-paste. You'll remember more this way!
 
 ## Grundlagen
 
@@ -81,194 +114,293 @@ Jedes Betriebssystem hat einen geringfügig anderen Bestand an Befehlen für die
 
 Es wäre schön zu sehen, wo wir uns befinden, oder? Lass uns nachsehen. Gib diesen Befehl in die Konsole ein und bestätige ihn mit `Enter`:
 
-```bash
-$ pwd
-/Users/olasitarska
-```
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
 
-Wenn du Windows benutzt, schreibe Folgendes:
+> Hinweis: 'pwd' steht für 'print working directory' (zeige derzeitiges Arbeitsverzeichnis).
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
 
-```bash
-> cd
-C:\Users\olasitarska
-```
+<!--endsec-->
 
 Du wirst wahrscheinlich etwas Ähnliches auf deinem Gerät sehen. Wenn du die Konsole öffnest, befindest du dich normalerweise im Heimverzeichnis deines Benutzers.
 
-> Hinweis: 'pwd' steht für 'print working directory' (zeige derzeitiges Arbeitsverzeichnis).
+* * *
 
 ### Anzeigen von Dateien und Unterordnern
 
 Nun, was befindet sich in deinem Verzeichnis? Es wäre toll, das herauszufinden. Lass uns mal schauen:
 
-```bash
-$ ls
-Anwendungen
-Desktop
-Downloads
-Musik
-...
-```
-
-Windows:
-
-```bash
-> dir
- Directory of C:\Users\olasitarska
- 05/08/2014 07:28 PM <DIR> Applications 
- 05/08/2014 07:28 PM <DIR> Desktop
- 05/08/2014 07:28 PM <DIR> Downloads
- 05/08/2014 07:28 PM <DIR> Music
- ...
-```
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Anwendungen
+    Desktop
+    Downloads
+    Musik
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+     05/08/2014 07:28 PM <DIR> Applications 
+     05/08/2014 07:28 PM <DIR> Desktop
+     05/08/2014 07:28 PM <DIR> Downloads
+     05/08/2014 07:28 PM <DIR> Music ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
 
 ### Wechseln des Verzeichnisses
 
 Lass uns jetzt zu unserem Desktop-Verzeichnis wechseln:
 
-```bash
-$ cd Desktop
-```
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ cd Desktop
+    
 
-```bash
-> cd Desktop
-```
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
 
 Schau, ob das Wechseln des Verzeichnisses funktioniert hat:
 
-```bash
-$ pwd
-/Users/olasitarska/Desktop
-```
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ pwd
+    /Users/olasitarska/Desktop
+    
 
-```bash
-> cd
-C:\Users\olasitarska\Desktop
-```
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
 
 Hier ist es!
 
-> Profi-Tipp: Wenn du `cd D` tippst und dann `tab` auf deiner Tastatur drückst, wird die Kommandozeile automatisch den Rest des Namens vervollständigen, wodurch du schneller navigieren kannst. Wenn es mehr als einen Ordner gibt, dessen Name mit "D" beginnt, drücke die `tab`-Taste zweimal, um eine Liste der Möglichkeiten anzuzeigen.
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
 
 ### Erstellen eines Verzeichnisses
 
 Wie wärs damit, ein Probeverzeichnis auf deinem Desktop zu erstellen? So kannst du das tun:
 
-```bash
-$ mkdir practice
-```
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ mkdir practice
+    
 
-```bash
-> mkdir practice
-```
+<!--endsec-->
 
-Dieser kleine Befehl erstellt einen Ordner mit dem Namen `practice` auf deinem Desktop. Du kannst nun überprüfen, ob er wirklich dort ist, indem du auf deinem Desktop nachschaust oder indem du den Befehl `ls` oder `dir` ausführst! Versuch es :)
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+Dieser kleine Befehl erstellt einen Ordner mit dem Namen `practice` auf deinem Desktop. Du kannst nun überprüfen, ob er wirklich dort ist, indem du auf deinem Desktop nachschaust oder indem du den Befehl `ls` oder `dir` ausführst! Versuch es. :)
 
 > Profi-Tipp: Wenn du die selben Befehle nicht immer wieder und wieder schreiben willst, verwende die `Pfeil aufwärts`- und `Pfeil abwärts`-Tasten deiner Tastatur, um durch die zuletzt verwendeten Befehle zu blättern.
 
+* * *
+
 ### Übung!
 
-Eine kleine Herausforderung für dich: Erstelle in deinem neu erstellten `practice`-Ordner ein Verzeichnis namens `test`. Verwende dazu die `cd` und `mkdir`-Kommandos.
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
 
 #### Lösung:
 
-```bash
-$ cd practice
-$ mkdir test 
-$ ls test
-```
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
 
-Windows:
+{% filename %}command-line{% endfilename %}
 
-```bash
-> cd practice 
-> mkdir test 
-> dir 
-05/08/2014 07:28 PM <DIR>   test
-```
+    $ cd practice
+    $ mkdir test 
+    $ ls test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice 
+    > mkdir test 
+    > dir 
+    05/08/2014 07:28 PM <DIR>   test
+    
+
+<!--endsec-->
 
 Glückwunsch! :)
 
+* * *
+
 ### Aufräumen
 
 Wir wollen kein Chaos hinterlassen, also lass uns das bislang Geschaffene wieder löschen.
 
 Zuerst müssen wir zurück zum Desktop wechseln:
 
-```bash
-$ cd ..
-```
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
 
-Windows:
+{% filename %}command-line{% endfilename %}
 
-```bash
-> cd ..
-```
+    > cd ..
+    
 
-Durch Verwendung von `..` mit dem `cd` Kommando wechselst du von deinem aktuellen Verzeichnis zum übergeordneten Verzeichnis (dies ist das Verzeichnis, das das aktuelle Verzeichnis enthält).
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
 
 Schau nach, wo du gerade bist:
 
-```bash
-$ pwd
-/Users/olasitarska/Desktop
-```
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    > cd
+    C:\Users\olasitarska\Desktop
+    
 
-```bash
-> cd
-C:\Users\olasitarska\Desktop
-```
+<!--endsec-->
 
 Jetzt ist es an der Zeit, dein `practice`-Verzeichnis zu löschen:
 
-> **Achtung**: Wenn du Daten mit `del`, `rmdir` oder `rm` löschst, kannst du das nicht mehr rückgängig machen, das bedeutet *die gelöschten Dateien sind für immer weg*! Sei also sehr vorsichtig mit diesem Befehl.
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-```bash
     $ rm -r practice
-```
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    > rmdir /S practice 
+    practice, Are you sure <Y/N>? Y
+    
 
-```bash
-> rmdir /S practice 
-practice, Are you sure <Y/N>? Y
-```
+<!--endsec-->
 
 Geschafft! Lass uns schauen, ob es wirklich gelöscht ist:
 
-```bash
-$ ls
-```
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
 
-Windows:
+{% filename %}command-line{% endfilename %}
 
-```bash
-> dir
-```
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
 
 ### Beenden
 
-Das wärs fürs Erste. Du kannst nun beruhigt deine Konsole schließen. Lass es uns wie die Hacker machen, okay? :)
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
 
-```bash
-$ exit
-```
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    > exit
+    
 
-```bash
-> exit
-```
+<!--endsec-->
 
-Cool, was? :)
+Cool, huh? :)
 
 ## Zusammenfassung
 
@@ -276,18 +408,20 @@ Hier ist eine Zusammenfassung einiger nützlicher Kommandos:
 
 | Befehl (Windows) | Befehl (Mac OS / Linux) | Beschreibung                | Beispiel                                          |
 | ---------------- | ----------------------- | --------------------------- | ------------------------------------------------- |
-| exit             | exit                    | Fenster schließen           | **exit**                                          |
+| beenden          | beenden                 | Fenster schließen           | **beenden**                                       |
 | cd               | cd                      | Verzeichnis wechseln        | **cd test**                                       |
+| cd               | pwd                     | show the current directory  | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
 | dir              | ls                      | Unterordner/Dateien zeigen  | **dir**                                           |
 | copy             | cp                      | Datei kopieren              | **copy c:\test\test.txt c:\windows\test.txt** |
 | move             | mv                      | Datei verschieben           | **move c:\test\test.txt c:\windows\test.txt** |
 | mkdir            | mkdir                   | neues Verzeichnis erstellen | **mkdir testdirectory**                           |
-| del              | rm                      | Ordner/eine Datei löschen   | **del c:\test\test.txt**                        |
+| rmdir (or del)   | rm                      | delete a file               | **del c:\test\test.txt**                        |
+| rmdir /S         | rm -r                   | delete a directory          | **rm -r testdirectory**                           |
 
 Das sind nur sehr wenige aller Befehle, die du in deiner Konsole verwenden kannst, heute aber wirst du keine weiteren brauchen.
 
-Falls du neugierig bist, findest du auf [ss64.com](http://ss64.com) eine vollständige Übersicht über alle Kommandozeilen-Befehle für alle Betriebssysteme. 
+Falls du neugierig bist, findest du auf [ss64.com](http://ss64.com) eine vollständige Übersicht über alle Kommandozeilen-Befehle für alle Betriebssysteme.
 
 ## Fertig?
 
-Lass uns mit Python anfangen!
+Lass uns mit Python anfangen!
\ No newline at end of file
diff --git a/de/python_installation/README.md b/de/python_installation/README.md
index aa4bdaf4d4f..aea48342251 100644
--- a/de/python_installation/README.md
+++ b/de/python_installation/README.md
@@ -4,10 +4,12 @@ Wir sind endlich da!
 
 Aber lass uns zuerst erklären, was Python ist. Python ist eine sehr beliebte Programmiersprache, die du zur Erstellung von Webseiten, Spielen, wissenschaftlichen Programmen, Computergrafiken und vielem, vielem mehr verwenden kannst.
 
-Python entstand in den späten 1980ern mit dem Hauptziel, von Menschen lesbar zu sein (nicht nur von Computern). Darum sieht es auch um Längen einfacher als andere Programmmiersprachen aus. Daher ist es einfach, Python zu lernen, aber keine Sorge, Python ist auch sehr mächtig!
+Python entstand in den späten 1980ern mit dem Hauptziel, von Menschen lesbar zu sein (nicht nur von Computern). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
 
 # Python-Installation
 
-> **Hinweis:** Falls du dich bereits durch die Installationsschritte gearbeitet hast, gibt es keinen Grund dies erneut zu tun - du kannst direkt zum nächsten Kapitel springen!
+> **Hinweis** Wenn du ein Chromebook verwendest, überspringe bitte dieses Kapitel und folge den Anweisungen im [Chromebook Setup](../chromebook_setup/README.md).
+> 
+> **Hinweis:** Wenn du die Installation bereits hinter dir hast, gibt es keinen Grund dies erneut zu tun - du kannst direkt zum nächsten Kapitel springen!
 
-{% include "/python_installation/instructions.md" %}
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/de/python_installation/instructions.md b/de/python_installation/instructions.md
index c52ba5a0825..fd091d317c2 100644
--- a/de/python_installation/instructions.md
+++ b/de/python_installation/instructions.md
@@ -1,62 +1,106 @@
-> Dieses Unterkapital basiert auf einem Tutorial der Geek Girls Carrots (http://django.carrots.pl/).
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
 
-Django ist in Python geschrieben. Wir brauchen Python für alles in Django. Fangen wir mit der Installation an! Wir möchten, dass du Python 3.5 installierst, solltest du also bereits eine ältere Version installiert haben, musst du diese aktualisieren.
+Django ist in Python geschrieben. Um mit Django zu arbeiten müssen wir also erst Python installieren. Lass uns also zunächst Python installieren! Für das Tutorial brauchen wir Python 3.6, falls du eine Vorgängerversion benutzt upgrade diese bitte.
 
-### Windows
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
 
-Python für Windows kannst du auf der Webseite https://www.python.org/downloads/windows/ herunterladen. Nachdem du die ***.msi**-Datei heruntergeladen hast, solltest du diese ausführen (doppelklicke die Datei) und den Anweisungen folgen. Es ist wichtig, dass du dir den Pfad (das Verzeichnis) merkst, wo du Python installierst. Du wirst das später brauchen!
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. Python für Windows kannst du auf der Webseite https://www.python.org/downloads/release/python-343/ herunterladen. Klicke auf den "Latest Python 3 Release - Python x.x.x" Link. Wenn du eine **64-bit** Version von Windows benutzt, downloade die Datei **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
 
-Worauf du besonders achten solltest: im zweiten Schritt des Installationsassistenten ("Anpassen") solltest du nach unten scrollen und die Option "Add python.exe to the Path" auswählen, wie hier:
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
 
-![Vergiss nicht, Python zu dem Pfad hinzuzufügen](../python_installation/images/add_python_to_windows_path.png)
+![Vergiss nicht, Python zu dem Pfad hinzuzufügen](../python_installation/images/python-installation-options.png)
 
-### Linux
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+Auf der Website https://www.python.org/downloads/release/python-361/ findest du den passenden Python-Installer:
+
+* Runteraden der *Mac OS X 64-bit/32-bit installer*-Datei,
+* Doppelklicke auf *Python.mpkg* um die Installation zu starten.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
 
 Es ist ziemlich wahrscheinlich, dass du Python schon automatisch installiert hast. Um herauszufinden, ob das so ist (und wenn ja, welche Version du hast), öffne eine Konsole und gib das folgende Kommando ein:
 
-```bash
-$ python3 --version
-Python 3.5.1
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. Wenn Python bei dir nicht installiert ist, oder du eine andere Version willst, kannst du es folgendermaßen installieren:
 
-Wenn Python bei dir nicht installiert ist, oder du eine andere Version willst, kannst du es folgendermaßen installieren:
+<!--endsec-->
 
-#### Debian oder Ubuntu
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
 
 Gib diesen Befehl in die Konsole ein:
 
-```bash
-$ sudo apt-get install python3.5
-```
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
 
-#### Fedora (bis zu 21)
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
 
 Gib diesen Befehl in die Konsole ein:
 
-```bash
-    $ sudo yum install python3.5
-```
+{% filename %}command-line{% endfilename %}
 
-#### Fedora (22+)
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
 
 Gib diesen Befehl in die Konsole ein:
 
-```bash
-$ sudo dnf install python3.5
-```
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
 
-### OS X
+Verify the installation was successful by opening a command prompt and running the `python3` command:
 
-Auf der Website https://www.python.org/downloads/release/python-343/ findest du den passenden Python-Installer:
+{% filename %}command-line{% endfilename %}
 
-  * Runteraden der *Mac OS X 64-bit/32-bit installer*-Datei,
-  * Doppelklick auf *python-3.5.1-macosx10.6.pkg*, um das Installationsprogramm auszuführen.
+    $ python3 --version
+    Python 3.6.1
+    
 
-Um zu überprüfen, ob die Installation erfolgreich war, öffne eine Konsole und gib das `python3`-Kommando ein:
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
 
-```bash
-$ python3 --version
-Python 3.5.1
-```
+* * *
 
-Falls du irgendwelche Zweifel hast oder falls etwas falsch gelaufen ist und du keine Ahnung hast, was als Nächstes zu tun ist - frag einfach deinen Coach! Manchmal laufen die Dinge einfach nicht so glatt und dann ist es besser, jemanden mit mehr Erfahrung zu fragen.
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Manchmal laufen die Dinge einfach nicht so glatt und dann ist es besser, jemanden mit mehr Erfahrung zu fragen.
\ No newline at end of file
diff --git a/de/python_introduction/README.md b/de/python_introduction/README.md
index 1f6dedd089b..5387b92c33e 100644
--- a/de/python_introduction/README.md
+++ b/de/python_introduction/README.md
@@ -1,50 +1,65 @@
 # Einführung in Python
 
-> Ein Teil dieses Kapitels basiert auf dem Tutorial der Geek Girls Karotten (http://django.carrots.pl/).
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 
 Fangen wir an, schreiben wir Code!
 
 ## Der Python-Prompt
 
-Um Python zu starten, musst du an die *Kommandozeile* deines Computers. Wie das geht, weißt du bereits -- denn du hast es im Kapitel [Einführung in die Kommandozeile](../intro_to_command_line/README.md) gelernt.
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+Um Python zu starten, musst du an die *Kommandozeile* deines Computers. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
 
 Also öffne die Konsole, dann fangen wir an.
 
 Wir wollen eine Python Konsole öffnen, also tippe in Windows `python` ein oder in Mac OS/Linux `python3` und drücke `Enter`.
 
-```
-$ python3
-Python 3.5.1 (...)
-Type "help", "copyright", "credits" or "license" for more information.
->>>
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
 
 ## Dein erster Python-Befehl!
 
-Nach Eingabe von python3 in der Konsole ändert sich das Prompt-Zeichen zu `>>>`. Für uns bedeutet das, dass wir ab nun nur noch Python-Code eingeben können. Den Python-Prompt `>>>` musst du nicht jedesmal eingeben - dies macht Python für dich.
+Nach Eingabe von python3 in der Konsole ändert sich das Prompt-Zeichen zu `>>>`. Für uns bedeutet das, dass wir ab nun nur noch Python-Code eingeben können. You don't have to type in `>>>` – Python will do that for you.
 
 Wenn du die Python-Konsole wieder verlassen möchtest, gib einfach `exit()` ein oder nutze das Tastatur-Kürzel `Strg + Z` unter Windows bzw. `Strg + D`, wenn du einen Mac hast oder Linux verwendest. Dann bist Du wieder in der normalen Konsole und der Python-Prompt `>>>` ist weg.
 
-Aber jetzt wollen wir die Python-Konsole ja noch nicht beenden. Wir wollen mehr darüber erfahren. Fangen wir mit etwas wirklich Einfachem an. Zum Beispiel: Versuch mal etwas Mathematisches einzugeben, wie `2 + 3` und drücke `Enter`.
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
 
 ```python
->>> 2 + 3
+>>> 2 + 3 
 5
 ```
 
-Cool! Schon ist das Ergebnis da. Python kann rechnen! Probier einfach auch einige andere Befehle aus, wie z.B.:
-* `4 * 5`
-* `5 - 1`
-* `40 / 2`
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
 
-Spiel ein wenig herum, dann machen wir weiter :).
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
 
-Wie du siehst, kann Python richtig toll rechnen. Aber Python kann noch viel mehr ...
+Spiel ein wenig herum, dann machen wir weiter. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
 
 ## Strings
 
 Strings sind Zeichenketten. Das ist eine Folge von Buchstaben, die von Anführungszeichen umgeben sind. Gib einfach mal deinen Namen ein (bei mir "Ola"):
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Ola"
 'Ola'
@@ -54,6 +69,8 @@ Nun hast du deinen ersten String erzeugt! Dies ist eine Folge von Zeichen (also
 
 Strings können zusammengesetzt werden. Versuch es einmal:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Hi there " + "Ola"
 'Hi there Ola'
@@ -61,6 +78,8 @@ Strings können zusammengesetzt werden. Versuch es einmal:
 
 Du kannst Strings auch vervielfältigen:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Ola" * 3
 'OlaOlaOla'
@@ -70,6 +89,8 @@ Brauchst du ein Apostroph in einem String, so hast du zwei Möglichkeiten.
 
 Du kannst für den String doppelte Anführungszeichen verwenden:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Runnin' down the hill"
 "Runnin' down the hill"
@@ -77,21 +98,27 @@ Du kannst für den String doppelte Anführungszeichen verwenden:
 
 oder du kannst den Apostroph mit einem Backslash (``) markieren:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> 'Runnin\' down the hill'
 "Runnin' down the hill"
 ```
 
-Toll, was? Um deinen Namen in Großbuchstaben anzuzeigen, gib einfach Folgendes ein:
+Toll, was? Um deinen Namen in Großbuchstaben anzuzeigen, gib einfach folgendes ein:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> "Ola".upper()
 'OLA'
 ```
 
-Hier hast du die `upper`-**Funktion** des Strings verwendet! Eine Funktion (wie `upper()`) ist eine Abfolge von Anweisungen, die Python ausführt, wenn die Funktion bei einem gegebenen Objekt (hier `"Ola"`) aufgerufen wird.
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
 
-Nehmen wir an, du möchtest die Zahl der Buchstaben in deinem Namen wissen. Auch dafür gibt es eine Funktion!
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> len("Ola")
@@ -104,10 +131,10 @@ Nun fragst du dich sicher, warum du manchmal eine Funktion mit einem `.` am Ende
 
 Ok, genug über Strings. Bisher haben wir Folgendes kennengelernt:
 
-* **Der Prompt** - Wenn wir beim Python-Prompt Anweisungen (oder Programm-Code) in Python eingeben, dann erhalten wir auch Ergebnisse in Python
-* **Zahlen und Strings** - In Python nutzen wir Zahlen für Berechnungen und Strings für Text-Objekte
-* **Operatoren** - wie + und *, verarbeiten mehrere Werte und erzeugen als Ergebnis einen neuen Wert
-* **Funktionen** - wie upper() und len(), tun etwas mit Objekten (in unserem Beispiel ändern sie sie, wie bei upper(), oder geben eine Eigenschaft zurück, wie bei len()).
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
 
 Das sind Grundlagen jeder Programmiersprache, die Du lernen wirst. Bist Du bereit für mehr? Bestimmt!
 
@@ -115,6 +142,8 @@ Das sind Grundlagen jeder Programmiersprache, die Du lernen wirst. Bist Du berei
 
 Probieren wir etwas Neues: Errors. Können wir die Länge einer Zahl auf die gleiche Weise ermitteln, wie die Länge eines Namens? Gib dazu `len(304023)` ein und drücke auf Enter:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(304023)
 Traceback (most recent call last):
@@ -124,6 +153,8 @@ TypeError: object of type 'int' has no len()
 
 Ha, unser erster Fehler! Dieser sagt, dass Objekte vom Typ "int" (Integers, das sind ganze Zahlen) keine Länge haben. Was also nun? Vielleicht sollten wir unsere Zahl als String schreiben? Denn bei Strings funktioniert es ja, wie wir wissen.
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(str(304023))
 6
@@ -131,10 +162,10 @@ Ha, unser erster Fehler! Dieser sagt, dass Objekte vom Typ "int" (Integers, das
 
 Ja, das funktioniert! Hier haben wir die `str`-Funktion innerhalb der `len`-Funktion aufgerufen. `str()` konvertiert alles zu einem String.
 
-* Die `str`-Funktion wandelt den übergebenen Wert in einen **String** um
-* Die `int`-Funktion wandelt den übergebenen Wert in einen **Integer** um
+- Die `str`-Funktion wandelt den übergebenen Wert in einen **String** um
+- Die `int`-Funktion wandelt den übergebenen Wert in einen **Integer** um
 
-> Wichtig: Zwar können wir Zahlen in Text umwandeln, aber nicht immer auch Text in Zahlen - was beispielsweise sollte `int('hello')` ergeben?
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
 
 ## Variablen
 
@@ -142,20 +173,26 @@ Ein wichtiger Bestandteil beim Programmieren sind Variablen. Eine Variable ist e
 
 Legen wir eine Variable mit der Bezeichnung `name` an:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> name = "Ola"
 ```
 
-Das war es schon! Einfach name gleich Ola.
+We type name equals Ola.
 
 Du hast sicher schon bemerkt, dass Python diesmal kein Ergebnis zurückgegeben hat. Woher sollen wir nun wissen, dass es die Variable jetzt auch tatsächlich gibt? Zum Test geben wir `name` ein und drücken wieder auf Enter:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> name
 'Ola'
 ```
 
-Hurra! Deine erste Variable :)! Nun kannst du auch stets ändern, was sie enthalten soll:
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> name = "Sonja"
@@ -165,12 +202,16 @@ Hurra! Deine erste Variable :)! Nun kannst du auch stets ändern, was sie enthal
 
 Du kannst sie auch in Funktionen verwenden:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(name)
 5
 ```
 
-Das ist toll, oder? Variable können alles sein, also auch Zahlen. Versuche Folgendes:
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> a = 4
@@ -181,6 +222,8 @@ Das ist toll, oder? Variable können alles sein, also auch Zahlen. Versuche Folg
 
 Was aber, wenn wir für eine Variable den falschen Namen verwenden? Uns einfach vertippen. Hast du schon eine leise Ahnung, was dann passiert? Probieren wir es aus!
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> city = "Tokyo"
 >>> ctiy
@@ -197,6 +240,8 @@ Spiel einfach ein wenig rum und schaue, was alles so passiert.
 
 Gib einmal Folgendes ein:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> name = 'Maria'
 >>> name
@@ -211,10 +256,12 @@ Wie wir später sehen werden, ist `print()` auch recht nützlich, wenn wir etwas
 
 ## Listen
 
-Außer Strings (Zeichenketten) und Integern (ganze Zahlen) hat Python noch einige andere Arten von Daten-Objekten. Von denen wollen wir uns nun **Listen** anschauen. Listen sind genau das, was du wahrscheinlich schon vermutest: Objekte, welche Listen von anderen Objekten enthalten :)
+Außer Strings (Zeichenketten) und Integern (ganze Zahlen) hat Python noch einige andere Arten von Daten-Objekten. Von denen wollen wir uns nun **Listen** anschauen. Listen sind genau das, was du wahrscheinlich schon vermutest: Objekte, welche Listen von anderen Objekten enthalten. :)
 
 Legen wir los und erzeugen eine Liste:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> []
 []
@@ -222,12 +269,16 @@ Legen wir los und erzeugen eine Liste:
 
 Ja, dies ist eine leere Liste. Für uns noch nicht sehr nützlich. Legen wir nun eine Liste von Lottozahlen an. Da wir uns nicht dauernd wiederholen wollen, ordnen wir diese Liste auch direkt einer Variablen zu:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery = [3, 42, 12, 19, 30, 59]
 ```
 
 So, nun haben wir eine Liste mit Lottozahlen! Was aber können wir damit tun? Zuerst einmal wollen wir feststellen, wie viele Zahlen in ihr enthalten sind. Hast du schon eine Idee, wie dies geht? Klar, das weißt du ja bereits!
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(lottery)
 6
@@ -235,12 +286,16 @@ So, nun haben wir eine Liste mit Lottozahlen! Was aber können wir damit tun? Zu
 
 Genau! `len()` liefert die Anzahl von Objekten in einer Liste zurück. Praktisch, nicht wahr? Nun wollen wir die Liste sortieren:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery.sort()
-``` 
+```
 
 Diese Anweisung gibt nichts zurück. Was passiert, ist, dass die Reihenfolge der Objekte in der Liste geändert werden. Nun wollen wir die Liste ausgeben um nachzusehen, was geschehen ist:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(lottery)
 [3, 12, 19, 30, 42, 59]
@@ -250,13 +305,17 @@ Wie du siehst, sind die Zahlen in der Liste nun aufsteigend sortiert. Super!
 
 Aber vielleicht wollten wir es genau andersherum haben? Nichts leichter als das!
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery.reverse()
 >>> print(lottery)
 [59, 42, 30, 19, 12, 3]
 ```
 
-Einfach, oder? Du kannst auch etwas zu deiner Liste hinzufügen:
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> lottery.append(199)
@@ -266,6 +325,8 @@ Einfach, oder? Du kannst auch etwas zu deiner Liste hinzufügen:
 
 Falls du nicht immer die gesamte Liste, sondern beispielsweise nur den ersten Eintrag sehen möchtest, kannst du dafür **Indizes** benützen. Ein Index gibt die Stelle innerhalb einer Liste an, die uns interessiert. Programmierer bevorzugen es, bei 0 mit dem Zählen anzufangen. Also hat das erste Objekt in deiner Liste den Index 0, das nächste die 1 und so weiter. Gib einmal Folgendes ein:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(lottery[0])
 59
@@ -275,7 +336,9 @@ Falls du nicht immer die gesamte Liste, sondern beispielsweise nur den ersten Ei
 
 Wie Du siehst, kannst Du auf die einzelnen Objekte in Deiner Liste zugreifen, indem Du den Namen der Liste verwendest und anschließend den Index in eckigen Klammern anfügst.
 
-Um etwas aus deiner Liste zu löschen, musst du **Indizes** und die **del**-Anweisung benutzen, wie wir es weiter oben gelernt haben (del ist eine Abkürzung für delete). Lass uns ein Beispiel versuchen und das festigen, was wir zuvor gelernt haben; wir werden die erste Nummer aus unserer Liste löschen.
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> print(lottery)
@@ -296,7 +359,11 @@ Eine Liste aller Methoden, die du auf Listen anwenden kannst, findest du in der
 
 ## Dictionaries
 
-Ein Wörterbuch (von nun an mit dem englischen Begriff 'Dictionary' bezeichnet) verhält sich ähnlich wie eine Liste, jedoch greifen wir auf die enthaltenen Objekte nicht mit einem Index, sondern mit einem Schlüssel zu (auf englisch 'key', und auch hier verwenden wir im weiteren den englischen Begriff). Ein 'key' kann ein String oder eine Zahl sein. Ein leeres Dictionary legen wir wie folgt an:
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> {}
@@ -305,29 +372,35 @@ Ein Wörterbuch (von nun an mit dem englischen Begriff 'Dictionary' bezeichnet)
 
 Und schon hast du ein leeres Dictionary erstellt. Super!
 
-Nun gib einmal Folgendes ein (verwende statt 'Ola' usw. deine eigenen Informationen):
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
 ```
 
-Du hast nun soeben die Variable mit dem Namen `participant` angelegt, die ein Dictionary mit drei key-value Paaren enthält (values, also Werte - aber auch hier bleiben wir beim englischen Begriff - sind die Objekte in einem Dictionary):
+With this command, you just created a variable named `participant` with three key–value pairs:
 
-* Der key `name` verweist auf den value `'Ola'` (welches ein `string` Objekt ist),
-* `country` verweist auf `'Poland'` (ebenfalls ein `string` Objekt),
-* und `favorite_numbers` schließlich verweist auf `[7, 42, 92]` (eine `Liste` mit drei Zahlen drin).
+- Der key `name` verweist auf den value `'Ola'` (welches ein `string` Objekt ist),
+- `country` verweist auf `'Poland'` (ebenfalls ein `string` Objekt),
+- und `favorite_numbers` schließlich verweist auf `[7, 42, 92]` (eine `Liste` mit drei Zahlen drin).
 
 Auf die einzelnen Objekte in einem Dictionary kannst du wie folgt zugreifen:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(participant['name'])
 Ola
 ```
 
-Also ganz ähnlich wie bei einer Liste. Aber statt dir einen Index merken zu müssen, benutzt du bei einem Dictionary einfach einen Namen (hier: den String 'name').
+See, it's similar to a list. But you don't need to remember the index – just the name.
 
 Was aber geschieht, wenn wir Python nach dem Wert eines keys fragen, den es gar nicht gibt? Errätst du es schon? Probieren wir es einfach aus und schauen was passiert!
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> participant['age']
 Traceback (most recent call last):
@@ -339,58 +412,71 @@ Ah, wieder ein Fehler! Diesmal ein **KeyError**. Python hilft uns auch hier und
 
 Wenn du zwischen Dictionaries und Listen wählen kannst, wann sollte welche Datenstruktur verwendet werden? Das ist eine gute Frage, über die es sich nachzudenken lohnt; und vielleicht möchtest du dies kurz tun, bevor du weiterliest.
 
-* Du brauchst nur eine geordnete Folge von Elementen? Dann wähle eine Liste.
-* Du brauchst eine Sammlung von Elementen, auf die du später einzeln, gezielt und effizient mit Hilfe eines Namens (d.h. keys) zugreifen kannst? Dann wähle ein Dictionary.
+- Du brauchst nur eine geordnete Folge von Elementen? Dann wähle eine Liste.
+- Du brauchst eine Sammlung von Elementen, auf die du später einzeln, gezielt und effizient mit Hilfe eines Namens (d.h. keys) zugreifen kannst? Dann wähle ein Dictionary.
 
-Dictionaries sind, so wie auch Listen, *mutable*, d. h. nachträglich veränderbar. So kannst du bei Dictionaries später noch weitere key-value Paare hinzufügen:
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> participant['favorite_language'] = 'Python'
 ```
 
-Wie bei Listen können wir auch bei Dictionaries die `len()`-Funktion verwenden, um die Zahl der enthaltenen Einträge (das sind die key-value Paare) zu ermitteln: Probier es gleich aus und tippe dieses Kommando ein:
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> len(participant)
 4
 ```
 
-Wir hoffen, dass das Alles für dich bisher Sinn ergibt. :) Bist du bereit für mehr Spaß mit Dictionaries? Machen wir weiter.
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
 
-Zum Löschen von Elementen kannst du den `del`-Befehl (oder im Englischen: statement) verwenden. Nehmen wir an, du möchtest den Eintrag mit dem key `'favorite_numbers'` entfernen:
+You can use the `pop()` method to delete an item in the dictionary. Nehmen wir an, du möchtest den Eintrag mit dem key `'favorite_numbers'` entfernen:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
->>> del participant['favorite_numbers']
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
 >>> participant
 {'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
 ```
 
-Wie du an der Ausgabe erkennst, ist nun das key-value Paar von 'favorite_numbers' gelöscht.
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
 
-Ebenso kannst du auch den Wert eines bestehenden Eintrages ändern:
+{% filename %}command-line{% endfilename %}
 
 ```python
-    >>> participant['country'] = 'Germany'
-    >>> participant
-    {'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
 ```
 
-Wie du siehst, hast du nun im key-value Paar mit dem key `'country'` den value von `'Poland'` nach `'Germany'` geändert. :) Hurra! Schon wieder was gelernt.
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
 
 ### Zusammenfassung
 
 Großartig! Inzwischen hast du schon einiges über Programmierung gelernt und die folgenden Dinge sind dir vertraut:
 
-* **Errors** - Du weißt wie sie zu lesen sind und dass Python sie dann ausgibt, wenn es eine Anweisung von dir nicht ausführen kann
-* **Variable** - sind Namen für Objekte, die dir dabei helfen, deinen Code leichter zu schreiben und ihn dabei auch gut lesbar zu halten
-* **Listen** - können Objekte in einer geordneten Reihenfolge speichern
-* **Dictionaries** - speichern Objekte als key-value Paare
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
 
 Schon gespannt auf den nächsten Teil? :)
 
 ## Vergleichen
 
-Ein wichtiger Teil beim Programmieren besteht darin, Dinge zu vergleichen. Was lässt sich leicht vergleichen? Zahlen sicherlich. Schauen wir uns mal an, wie das funktioniert:
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> 5 > 2
@@ -405,12 +491,14 @@ True
 True
 ```
 
-Hier haben wir Python einige Zahlen zum Vergleichen gegeben. Wie du siehst, kann Python nicht nur die Zahlen vergleichen, sondern auch die Ergebnisse von Berechnungen. Cool, nicht wahr?
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
 
-Womöglich wunderst du dich aber über die beiden `==` Gleichheitszeichen zum Vergleich, ob zwei Zahlen den selben Wert haben? Ein einfaches Gleichheitszeichen `=` verwenden wir bereits, um Werte Variablen zuzuweisen. Da beim Progammieren alle Anweisungen eindeutig sein müssen, benötigst du in Python daher **stets** zwei `==` Zeichen, um Dinge auf Gleichheit zu testen. Wir können auch festsetellen, ob Werte unterschiedlich sind. Dafür verwenden wir das Symbol `!=`, wie in obigen Beispiel.
+Womöglich wunderst du dich aber über die beiden `==` Gleichheitszeichen zum Vergleich, ob zwei Zahlen den selben Wert haben? Ein einfaches Gleichheitszeichen `=` verwenden wir bereits, um Werte Variablen zuzuweisen. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. Wir können auch festsetellen, ob Werte unterschiedlich sind. Dafür verwenden wir das Symbol `!=`, wie in obigen Beispiel.
 
 Nun noch zwei weitere Vergleiche:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> 6 >= 12 / 2
 True
@@ -418,15 +506,17 @@ True
 False
 ```
 
-`>` und `<` sind klar, was aber sollen `>=` und `<=` bedeuten? Vergleiche liest du folgendermaßen:
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
 
-* x `>` y bedeutet: x ist größer als y
-* x `<` y bedeutet: x ist kleiner als y
-* x `<=` y bedeutet: x ist kleiner oder gleich y
-* x `>=` y bedeutet: x ist größer oder gleich y
+- x `>` y bedeutet: x ist größer als y
+- x `<` y bedeutet: x ist kleiner als y
+- x `<=` y bedeutet: x ist kleiner oder gleich y
+- x `>=` y bedeutet: x ist größer oder gleich y
 
 Sensationell! Lust auf mehr? Dann probier das:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> 6 > 2 and 2 < 3
 True
@@ -438,30 +528,37 @@ True
 
 Du kannst Python beliebig viele Vergleiche vornehmen lassen und wirst ein Ergebnis erhalten. Das ist wirklich cool, oder?
 
-* **and** - wenn Du den `and`-Operator verwendest, müssen beide Vergleiche True (d.h. wahr) ergeben, damit das Gesamtergebnis auch True ist
-* **or** - wenn Du den `or`-Operator verwendest, genügt es, wenn einer der beiden Vergleiche True ergibt, damit das Gesamtergebnis True ergibt
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
 
 Die Redewendung "Äpfel mit Birnen zu vergleichen" hast du bestimmt schon einmal gehört. Machen wir dies doch einmal in Python:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> 1 > 'django'
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
-TypeError: unorderable types: int() > str()
+TypeError: '>' not supported between instances of 'int' and 'str'
 ```
 
 Unterschiedliche Dinge, hier die Datentypen Zahlen (`int`) und Strings (`str`), lassen sich auch in Python nicht miteinander vergleichen. In solch einem Fall liefert uns Python einen **TypeError** und sagt uns, dass diese zwei Datentypen nicht miteinander verglichen werden können.
 
 ## Boolean
 
-Zusammen mit den Vergleichen hast du auch einen weiteren Datentyp in Python kennengelernt. Ein **Boolean** -- dies ist ein Wahrheitswert (und wir bleiben auch hier bei der englischen Bezeichnung 'boolean') und es ist zudem auch der einfachste Datentyp überhaupt.
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
 
-Es gibt nur zwei boolsche Werte: - True - False (also wahr und falsch).
+There are only two Boolean objects:
 
-Damit Python diese beiden Werte versteht, musst du sie auch genau so schreiben (den ersten Buchstaben groß, alle weiteren klein). **true, TRUE, tRUE funktionieren nicht -- nur True ist korrekt.** (Dasselbe gilt natürlich auch für False.)
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
 
 Boolsche Werte können auch mit Variablen bezeichnet werden:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> a = True
 >>> a
@@ -470,6 +567,8 @@ True
 
 Auch Folgendes geht:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> a = 2 > 5
 >>> a
@@ -478,73 +577,109 @@ False
 
 Übe ein wenig, indem du mit Booleans rumspielst, zum Beispiel mit diesen Anweisungen:
 
-* `True and True`
-* `False and True`
-* `True or 1 == 1`
-* `1 != 2`
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
 
 Glückwunsch! Booleans sind echt eine der coolsten Features beim Programmieren und du hast gerade gelernt, damit umzugehen!
 
 # Sichern!
 
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
 Bisher haben wir den Python-Code nur im Interpreter eingegeben, wodurch wir immer nur eine Zeile Code auf einmal ausführen konnten. Richtige Programme dagegen werden in Dateien gespeichert und, je nach Programmiersprache, durch einen **Interpreter** ausgeführt oder durch einen **Compiler** übersetzt. Unseren bisherigen Code haben wir dagegen im Python-**Interpreter** Zeile für Zeile eingegeben und einzeln ausgeführt. Für die nächsten Beispiele brauchen wir mehr als eine Zeile, daher werden wir nun:
 
-*   Den Python-Interpreter beenden
-*   Einen Code-Editor unserer Wahl öffnen
-*   Code eingeben und diesen in einer Python-Datei sichern
-*   Und diesen dann laufen lassen!
+- Den Python-Interpreter beenden
+- Einen Code-Editor unserer Wahl öffnen
+- Code eingeben und diesen in einer Python-Datei sichern
+- Und diesen dann laufen lassen!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
 
-Um den Python-Interpreter zu beenden, nutze einfach die ~~~ exit()~~~ Funktion:
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> exit()
-$
 ```
 
 Nun siehst du wieder den normalen Kommandozeilen-Prompt.
 
 Ein paar Kapitel zuvor hatten wir uns bereits einen [Code-Editor](../code_editor/README.md) ausgesucht. Diesen öffnest du nun und gibst Folgendes ein:
 
+{% filename %}editor{% endfilename %}
+
 ```python
 print('Hello, Django girls!')
 ```
 
-> **Hinweis:** Achte auf eines der tollsten Features von Code-Editoren: Farben! In der Python-Konsole hatte alles die gleiche Farbe. Der Code-Editor dagegen sollte dir nun die `print`-Funktion in einer anderen Farbe anzeigen als der von ihr auszugebende Text. Dies wird "Syntax Hervorhebung" ("syntax highlighting") genannt und ist ein wirklich sehr nützliches Werkzeug beim Coden. Die Farbe von Dingen gibt dir Hinweise auf z.B. nicht geschlossene Zeichenfolgen oder Tippfehler in einem Schlüsselwort (wie das `def` in einer Funktion, was wir weiter unten sehen werden). Dies ist einer der Gründe, warum wir Code-Editoren verwenden :)
-
 Da du nun schon einige Python-Erfahrung hast, schreibe ein wenig Code mit dem, was du bislang gelernt hast.
 
-Als nächstes wollen wir diesen Code in einer Datei mit einem aussagekräftigen Namen speichern. Lass uns die Datei **python_intro.py** nennen und auf dem Desktop speichern. Wir können der Datei jeden Namen geben, den wir wollen, aber es ist wichtig sicherzustellen, dass die Datei auf **.py** endet. Die **.py** Erweiterung gibt unserem Betriebssystem an, dass dies ein **python executable file** ist und Python diese ausführen kann.
+Als nächstes wollen wir diesen Code in einer Datei mit einem aussagekräftigen Namen speichern. Lass uns die Datei **python_intro.py** nennen und auf dem Desktop speichern. Wir können der Datei jeden Namen geben, den wir wollen, aber es ist wichtig sicherzustellen, dass die Datei auf **.py** endet. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. Dies wird "Syntax Hervorhebung" ("syntax highlighting") genannt und ist ein wirklich sehr nützliches Werkzeug beim Coden. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). Dies ist einer der Gründe, warum wir Code-Editoren verwenden. :)
 
 Nun, da die Datei gesichert ist, wollen wir sie ausführen! Mit dem, was du bisher über die Kommandozeile (das mit dem Prompt) gelernt hast, öffnest du die Konsole und gehst in das Desktop-Verzeichnis.
 
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
 Auf einem Mac sieht das etwa so aus:
 
-```bash
-$ cd /Users/<your_name>/Desktop
-```
+{% filename %}command-line{% endfilename %}
 
-Unter Linux ist es ähnlich ("Desktop" könnte bei Dir allerdings "Schreibtisch" heißen):
+    $ cd ~/Desktop
+    
 
-```bash
-$ cd /home/<your_name>/Desktop
-```
+<!--endsec-->
 
-Nutzt Du dagegen Windows, schaut es wie folgt aus:
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
 
-```bash
-> cd C:\Users\<your_name>\Desktop
-```
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
 
 Kommst du hier nicht weiter, frag jemanden um Hilfe.
 
 Benutze jetzt Python, um den Code in der Datei auszuführen:
 
-```bash
-$ python3 python_intro.py 
-Hello, Django girls!
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hello, Django girls!
+    
 
-Hinweis: in Windows wird 'python3' nicht als Kommando erkannt. Nutze dafür einfach 'python' um die Datei auszuführen:
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 > python python_intro.py
@@ -554,27 +689,32 @@ Prima! Du hast soeben dein erstes Python-Programm aus einer Datei heraus ausgef
 
 Nun wollen wir uns einem wichtigen Teil der Programmierung zuwenden:
 
-## If...elif...else
+## If … elif … else
 
-Oft sollen manche Programmteile nur ausgeführt werden, wenn bestimmte Vorbedingungen erfüllt sind. Dafür gibt es in Python sogenannte **if Anweisungen**.
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
 
 Nun ändere den Code in deiner **python_intro.py** Datei:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
 ```
 
-Wenn wir dieses nun sichern und anschließend ausführen, erhalten wir einen Fehler:
+If we were to save and run this, we'd see an error like this:
 
-```bash
-$ python3 python_intro.py
-File "python_intro.py", line 2
-         ^
-SyntaxError: unexpected EOF while parsing
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    File "python_intro.py", line 2   
+             ^ 
+    SyntaxError: unexpected EOF while parsing
+    
 
 Python erwartet hier noch weiteren Programmcode, der ausgeführt werden soll, wenn die Bedingung `3 > 2` wahr ist (also `True` ergibt). Lassen wir Python “It works!” ausgeben. Dafür ändere erneut den Code in **python_intro.py**:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
     print('It works!')
@@ -584,15 +724,21 @@ Du fragst dich nun, warum wir die angefügte Zeile mit 4 Leerzeichen eingerückt
 
 Nun sichere die Datei und führe sie noch einmal aus:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
-$ python3 python_intro.py
+$ python3 python_intro.py 
 It works!
 ```
 
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
 ### Was passiert, wenn eine Bedingung nicht True ist?
 
 In den vorigen Beispielen wurde Code ausgeführt, wenn eine vorhergehende Bedingung True ergab. Aber Python kennt auch `elif` und `else` Anweisungen:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 5 > 2:
     print('5 is indeed greater than 2')
@@ -602,12 +748,15 @@ else:
 
 Wenn dies ausgeführt wird, wird es anzeigen:
 
-```bash
-$ python3 python_intro.py
-5 is indeed greater than 2
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    5 is indeed greater than 2
+    
 
-Wenn 2 größer als 5 wäre, würde die zweite Anweisung (die nach dem else) ausgeführt. Einfach, nicht wahr? Schauen wir uns nun an, wie `elif` funktioniert:
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 name = 'Sonja'
@@ -621,15 +770,18 @@ else:
 
 und ausgeführt erhalten wir:
 
-```bash
-$ python3 python_intro.py
-Hey Sonja!
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hey Sonja!
+    
 
 Hast du bemerkt was passiert ist? `elif` lässt dich zusätzliche Bedingungen hinzufügen, die geprüft werden, falls die vorherige fehlschlägt.
 
 Du kannst so viele `elif` Bedingungen nach der anfänglichen `if` Anweisung hinzufügen, wie du magst. Zum Beispiel:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 volume = 57
 if volume < 20:
@@ -648,27 +800,50 @@ else:
 
 Python läuft durch jeden Test der Reihe nach und gibt dann aus:
 
-```bash
-$ python3 python_intro.py
-Perfect, I can hear all the details
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
 ```
 
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
 ### Zusammenfassung
 
-In den letzten drei Übungen hast du gelernt:
+In the last few exercises you learned about:
 
-* **Vergleiche vorzunehmen** - in Python kannst du Vergleiche mit den folgenden Operatoren `>`, `>=`, `==`, `<=`, `<` sowie `and` und `or` vornehmen
-* **Boolsche Datentypen** zu verwenden - Dies sind Objekte, die nur zwei Werte annehmen können: `True` bzw. `False`
-* **Dateien zu speichern** - also Programmcode in Dateien abzulegen, so dass du auch umfangreichere Programme schreiben kannst.
-* **if...elif...else** - Anweisungen zu verwenden, so dass nur bestimmte Programmteile ausgeführt werden.
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
 
 Und nun zum letzten Kapitel!
 
 ## Deine eigenen Funktionen!
 
-Erinnerst du dich an Funktionen wie `len()`, die du in Python aufrufen kannst? Genau sowas kannst du auch selbst schreiben, und das schauen wir uns nun an!
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
 
-Eine Funktion ist eine Folge von Anweisungen, die Python ausführen soll. Jede Funktion beginnt mit dem Keyword (auf deutsch 'Schlüsselwort', aber diese Übersetzung ist nicht gebräuchlich) `def`, gefolgt von einem Funktionsnamen und Parametern. Aber nicht alle Funktionen brauchen Parameter. Beginnen wir mit einem einfachen Beispiel ohne Parameter. Ändere den Code in der Datei **python_intro.py** wie folgt:
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+Eine Funktion ist eine Folge von Anweisungen, die Python ausführen soll. Jede Funktion beginnt mit dem Keyword (auf deutsch 'Schlüsselwort', aber diese Übersetzung ist nicht gebräuchlich) `def`, gefolgt von einem Funktionsnamen und Parametern. Aber nicht alle Funktionen brauchen Parameter. Let's give it a go. Ändere den Code in der Datei **python_intro.py** wie folgt:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi():
@@ -684,13 +859,21 @@ Nun magst du dich fragen, warum wir am Ende der Datei den Namen der Funktion ein
 
 Schauen wir, was passiert, wenn wir die Datei ausführen:
 
-```bash
-$ python3 python_intro.py
-Hi there!
-How are you?
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hi there! How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
 
-Das war einfach! Als Nächstes bauen wir Funktionen mit sogenannten Parametern. Wir werden das gerade gebaute Beispiel benutzen - eine Funktion, die die ausführende Person begrüßt - aber diesmal mit Namen:
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi(name):
@@ -698,6 +881,8 @@ def hi(name):
 
 Wie du siehst geben wir der Funktion jetzt einen Parameter, den wir `name` nennen:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
     if name == 'Ola':
@@ -712,49 +897,59 @@ hi()
 
 Denk daran: Die `print` Funktion ist 4 Leerzeichen innerhalb der `if`-Anweisung eingerückt. Das ist sinnvoll, da die Funktion ausgeführt wird, wenn die Bedingung eintritt. Mal sehen, wie das jetzt funktioniert:
 
-```bash
-$ python3 python_intro.py
-Traceback (most recent call last):
-File "python_intro.py", line 10, in <module>
-  hi()
-TypeError: hi() missing 1 required positional argument: 'name'
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Traceback (most recent call last): 
+    File "python_intro.py", line 10, in <module>
+       hi() 
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
 
 Hoppla, ein Fehler. Zum Glück gibt uns Python eine recht nützliche Fehlermeldung. Diese besagt, dass die Funktion `hi()` (welche wir definiert haben) ein erforderliches Argument hat (genannt `name`) und dass wir vergessen haben, dieses zu übermitteln, als wir die Funktion aufriefen. Lass uns das am unteren Ende der Datei schnell beheben:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 hi("Ola")
 ```
 
 Und wir führen sie erneut aus:
 
-```bash
-$ python3 python_intro.py
-Hi Ola!
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hi Ola!
+    
 
 Und wenn wir den Namen ändern?
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 hi("Sonja")
 ```
 
 Und ausgeführt:
 
-```bash
-$ python3 python_intro.py
-Hi Sonja!
-```
+{% filename %}command-line{% endfilename %}
 
-Nun, was denkst du, wird passieren, wenn du einen anderen Namen dort hinein schreibst? (Nicht Ola oder Sonja!) Probier es aus und schau, ob du richtig liegst. Es sollte das Folgende herauskommen:
+    $ python3 python_intro.py 
+    Hi Sonja!
+    
 
-```bash
-Hi anonymous!
-```
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
 
-Das ist genial, oder? Auf diese Weise musst du dich nicht jedesmal wiederholen, wenn du den Namen der Person änderst, die die Funktion grüßen soll. Und das ist genau der Grund, warum wir Funktionen brauchen - du willst auf keinem Fall deinen Code wiederholen!
+{% filename %}command-line{% endfilename %}
 
-Lass uns etwas Klügeres machen -- es gibt mehr Namen als nur zwei und für jeden eine Bedingung zu schreiben, wäre recht schwierig, richtig?
+    Hi anonymous!
+    
+
+Das ist genial, oder? Auf diese Weise musst du dich nicht jedesmal wiederholen, wenn du den Namen der Person änderst, die die Funktion grüßen soll. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi(name):
@@ -765,35 +960,44 @@ hi("Rachel")
 
 Lass uns den Code aufrufen:
 
-```bash
-$ python3 python_intro.py
-Hi Rachel!
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py 
+    Hi Rachel!
+    
 
 Herzlichen Glückwunsch! Du hast gerade gelernt, wie du Funktionen schreibst! :)
 
 ## Schleifen
 
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
 Dies ist bereits der letzte Teil. Das ging doch schnell, oder? :)
 
 Programmierer wiederholen sich nicht gerne. Beim Programmieren geht es darum, Dinge zu automatisieren, so dass wir nicht jede Person mit ihrem Namen manuell grüßen müssen, richtig? Dies ist der Punkt an dem Schleifen nützlich werden.
 
 Erinnerst du dich noch an Listen? Lass uns eine Liste mit Mädchennamen erstellen:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
 ```
 
 Wir wollen alle mit ihrem Namen grüßen. Wir besitzen bereits die `hi`-Funktion, um dies zu tun, also lass sie uns in einer Schleife verwenden:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 for name in girls:
 ```
 
-Die `for`-Anweisung verhält sich ähnlich der `if`-Anweisung; Code unter beiden muss 4 Leerzeichen eingerückt werden.
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
 
 Hier ist der vollständige Code für die Datei:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
     print('Hi ' + name + '!')
@@ -806,47 +1010,51 @@ for name in girls:
 
 Und wenn wir es ausführen:
 
-```bash
-$ python3 python_intro.py
-Hi Rachel!
-Next girl
-Hi Monica!
-Next girl
-Hi Phoebe!
-Next girl
-Hi Ola!
-Next girl
-Hi You!
-Next girl
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
 
 Wie du sehen kannst, wird alles, was du innerhalb einer `for`-Anweisung eingerückt hast, für jedes Element der Liste `girls` wiederholt.
 
 Du kannst auch `for` auf Nummern beziehen, wenn du die `range`-Funktion benutzt:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 for i in range(1, 6):
-    print(i)
+     print(i)
 ```
 
 Das würde ausgeben:
 
-```
-1
-2
-3
-4
-5
-```
+{% filename %}command-line{% endfilename %}
+
+    1 
+    2 
+    3 
+    4 
+    5
+    
 
 `range` ist eine Funktion, die eine Liste von Nummern (eine nach der anderen) erschafft (die Nummern werden von dir als Parameter bereitgestellt).
 
-Merk dir, dass die zweite dieser Nummern, die du als Parameter übergibst, nicht in der Liste enthalten ist, die von Python ausgegeben wird (das bedeutet, dass `range(1, 6)` von 1 bis 5 zählt, aber nicht die Nummer 6 enthält). Die liegt daran, weil "range" halb offen ist, was widerum bedeutet, dass es den ersten Wert enthält, aber nicht den letzten.
+Merk dir, dass die zweite dieser Nummern, die du als Parameter übergibst, nicht in der Liste enthalten ist, die von Python ausgegeben wird (das bedeutet, dass `range(1, 6)` von 1 bis 5 zählt, aber nicht die Nummer 6 enthält). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
 
 ## Zusammenfassung
 
 Das ist alles. **You totally rock!** Das war ein heikles Kapitel, darum kannst du jetzt stolz auf dich sein. Wir sind definitiv stolz auf dich, dass du es so weit geschafft hast!
 
-Du möchtest jetzt vielleicht kurz etwas anderes tun - stretchen, etwas herumlaufen, deine Augen ausruhen - bevor es weiter zum nächsten Kapitel geht. :)
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
 
-![Cupcake](images/cupcake.png)
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/de/signup_pythonanywhere.md b/de/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/de/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/de/template_extending/README.md b/de/template_extending/README.md
index bfb8e0668bb..3e500b6f209 100644
--- a/de/template_extending/README.md
+++ b/de/template_extending/README.md
@@ -2,109 +2,113 @@
 
 Eine weitere praktische Sache von Django ist das **template extending**, Erweiterungen des Templates. Was bedeutet das? Damit kannst du Teile deiner HTML-Site für verschiedene Seiten deiner Website nutzen.
 
-Dadurch musst du dich nicht in jeder Datei wiederholen, wenn du das gleiche Layout oder den gleichen Inhalt nutzen möchtest. Und wenn du etwas ändern willst, musst du das nicht in jedem Template machen, sondern nur einmal!
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
 
-## Base-Template erstellen
+## Create a base template
 
 Ein Base-Template ist das grundlegende Template, welches dann auf jeder einzelnen Seite deiner Website erweitert wird.
 
 Wir erstellen jetzt eine `base.html`-Datei in `blog/templates/blog/`:
 
-```
-blog
-└───templates
-    └───blog
-            base.html
-            post_list.html
-```
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
 
 Öffne sie, kopiere alles von `post_list.html` und füge es wie folgt in die `base.html`-Datei ein:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
-    <head>
-        <title>Django Girls blog</title>
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
-        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
-        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
-    </head>
-    <body>
-        <div class="page-header">
-            <h1><a href="/">Django Girls Blog</a></h1>
-        </div>
-
-        <div class="content container">
-            <div class="row">
-                <div class="col-md-8">
-                {% for post in posts %}
-                    <div class="post">
-                        <div class="date">
-                            {{ post.published_date }}
-                        </div>
-                        <h1><a href="">{{ post.title }}</a></h1>
-                        <p>{{ post.text|linebreaksbr }}</p>
-                    </div>
-                {% endfor %}
-                </div>
-            </div>
-        </div>
-    </body>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
 </html>
 ```
 
 Dann ersetze in `base.html` den gesamten `<body>` (alles zwischen `<body>` und `</body>`) hiermit:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <body>
-    <div class="page-header">
-        <h1><a href="/">Django Girls Blog</a></h1>
-    </div>
-    <div class="content container">
-        <div class="row">
-            <div class="col-md-8">
-            {% block content %}
-            {% endblock %}
-            </div>
-        </div>
-    </div>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
 </body>
 ```
 
-Wir haben nun also alles zwischen `{% for post in posts %}{% endfor %}` ersetzt mit:
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% block content %}
 {% endblock %}
 ```
 
-Was bedeutet das jetzt? Du hast gerade einen `block` erstellt. Dies ist ein Template Tag, mithilfe dessen du HTML innerhalb dieses Blocks in anderen Templates einsetzen kannst, die sich auf `base.html` beziehen. Wir zeigen dir gleich, wie das geht.
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). Wir zeigen dir gleich, wie das geht.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
 
-Speichere nun und öffne wieder `blog/templates/blog/post_list.html`. Lösche hier alles, was nicht im Body steht und lösche auch `<div class="page-header"></div>`, die Datei sollte dann so aussehen:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
-    <div class="post">
-        <div class="date">
-            {{ post.published_date }}
-        </div>
-        <h1><a href="">{{ post.title }}</a></h1>
-        <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endfor %}
 ```
 
-Schreibe nun diese Zeile an den Anfang:
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
 
-    {% extends 'blog/base.html' %}
-    
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. So hier:
 
-Das heißt, dass das `post_list.html`-Template nun das `base.html`-Template erweitert ("extend"). Als Letztes müssen wir noch Folgendes machen: Verschiebe alles (außer der Zeile, die wir gerade hinzugefügt haben) zwischen `{% block content %}` und `{% endblock content %}`. So hier:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-{% extends 'blog/base.html' %}
-
 {% block content %}
     {% for post in posts %}
         <div class="post">
@@ -118,6 +122,26 @@ Das heißt, dass das `post_list.html`-Template nun das `base.html`-Template erwe
 {% endblock %}
 ```
 
-Das war's! Probier aus, ob deine Website noch richtig funktioniert :)
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Das war's! Probier aus, ob deine Website noch richtig funktioniert. :)
 
-> Wenn du einen Fehler `TemplateDoesNotExists` bekommst, mit dem Hinweis, dass es keine `blog/base.html`-Datei gibt und der Server in der Konsole noch läuft: Stoppe ihn mit Ctrl+C (Control und C zusammen drücken) und starte ihn nochmal neu mit dem Befehl `python manage.py runserver`.
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/de/whats_next/README.md b/de/whats_next/README.md
index df46f6dd36c..694921834cd 100644
--- a/de/whats_next/README.md
+++ b/de/whats_next/README.md
@@ -6,21 +6,20 @@ Herzlichen Glückwunsch! **Du bist der Hammer!** Wir sind echt stolz! <3
 
 Mach eine Pause und entspanne. Du hast gerade etwas wirklich Großes geleistet.
 
-Danach:
-
-* Folge den Django Girls auf [Facebook](http://facebook.com/djangogirls) oder [Twitter](http://twitter.com/djangogirls), um auf dem Laufenden zu bleiben.
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
 
 ### Gibt es Empfehlungen für weiteren Quellen?
 
-Ja! Auf dieser Seite gibt es noch empfehlenswerte Erweiterungen [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org). Schau mal rein..
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
 
-Später kannst du die unten aufgeführten Ressourcen versuchen. Alles sehr empfehlenswert!
+Later on, you can try the resources listed below. They're all very recommended!
 
-- [Django's official tutorial](https://docs.djangoproject.com/en/1.8/intro/tutorial01/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
 - [New Coder tutorials](http://newcoder.io/tutorials/)
-- [Code Academy Python course](http://www.codecademy.com/en/tracks/python)
-- [Code Academy HTML & CSS course](http://www.codecademy.com/tracks/web)
-- [Django Carrots tutorial](http://django.carrots.pl/en/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
 - [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
-- [Getting Started With Django video lessons](http://gettingstartedwithdjango.com/)
-- [Two Scoops of Django: Best Practices for Django 1.8 book](http://twoscoopspress.com/products/two-scoops-of-django-1-8)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/dv-MV/GLOSSARY.md b/dv-MV/GLOSSARY.md
new file mode 100644
index 00000000000..ee563bd7588
--- /dev/null
+++ b/dv-MV/GLOSSARY.md
@@ -0,0 +1,3 @@
+# ކޯޑު އެޑިޓަރ
+
+ކޯޑު އެޑިޓަރ އަކީ ފަހުން ބޭނުންކުރެވޭ ގޮތަށް ކޯޑު ލިޔެ ރައްކާ ކުރެވޭ އެޕްލިކޭޝަންއެއް. ކޯޑު އެޑިޓަރ އެއް ހޯދުމަށް[Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/dv-MV/README.md b/dv-MV/README.md
new file mode 100644
index 00000000000..121da8f55bf
--- /dev/null
+++ b/dv-MV/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/dv-MV/SUMMARY.md b/dv-MV/SUMMARY.md
new file mode 100644
index 00000000000..2b9bb97a2a0
--- /dev/null
+++ b/dv-MV/SUMMARY.md
@@ -0,0 +1,35 @@
+# ޚުލާސާ
+
+* [ތައާރަފު](README.md)
+* [އިންސްޓޮލޭޝަން](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [ކްރޯމްބުކް އިންސްޓޮލޭޝަން](chromebook_setup/README.md)
+* [އިންޓަރނެޓް މަސައްކަތް ކުރާގޮތް](how_the_internet_works/README.md)
+* [ކޮމާންޑްލައިންގެ ތައާރަފު](intro_to_command_line/README.md)
+* [ޕައިތަން އިންސްޓޮލޭޝަން](python_installation/README.md)
+* [ކޯޑު އެޑިޓަރ](code_editor/README.md)
+* [ޕައިތަންގެ ތައާރަފު](python_introduction/README.md)
+* [ޖޭންގޯ އަކީ ކޯއްޗެއް?](django/README.md)
+* [ޖޭންގޯ އިންސްޓޮލޭޝަން](django_installation/README.md)
+* [މަގޭ ފުރަތަމަ ޖޭންގޯ ޕްރޮޖެކްޓް!](django_start_project/README.md)
+* [ޖޭންގޯ މޮޑެލްސް](django_models/README.md)
+* [ޖޭންގޯ އެޑްމިން](django_admin/README.md)
+* [ޑިޕްލޯއި!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [ޖޭންގޯ ވިއުސް!](django_views/README.md)
+* [އެޗްޓީއެމްއެލްގެ ތައާރަފް](html/README.md)
+* [ޖޭންގޯ އޯއާރުއެމް ( ކުއެރީ ސެޓްސް)](django_orm/README.md)
+* [ޓެމްޕްލޭޓްސް ގައިވާ ބަދަލުވާ ޑޭޓާ](dynamic_data_in_templates/README.md)
+* [ޖޭންގޯ ޓެމްޕްލޭޓްސް](django_templates/README.md)
+* [ސީއެސްއެސް - ރީތިކުރުމަށް](css/README.md)
+* [ޓެމްޕްލޭޓް އެކްސްޓެންޑިންގް](template_extending/README.md)
+* [އެޕްލިކޭޝަން އެކްސްޓެންޑު ކުރުމަށް](extend_your_application/README.md)
+* [ޖޭންގޯ ފޯރމުތައް](django_forms/README.md)
+* [ދެން އޮތީ ކޯއްޗެއް?](whats_next/README.md)
\ No newline at end of file
diff --git a/dv-MV/chromebook_setup/README.md b/dv-MV/chromebook_setup/README.md
new file mode 100644
index 00000000000..1dbeb4dd38d
--- /dev/null
+++ b/dv-MV/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# ކްރޯމްބުކް ސެޓަޕްކުރުން
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/dv-MV/chromebook_setup/instructions.md b/dv-MV/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..70540afe0b5
--- /dev/null
+++ b/dv-MV/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+ކްރޯމްބުކް ބޭނުންނުކުރާނަމަ[މިސެކްޝަން ](http://tutorial.djangogirls.org/en/installation/#install-python)ދޫކޮށްލާ. ބޭނުންކުރާނަމަ، އިންސްޓޮލޭޝަންގެ ތަޖުރިބާ ތަންކޮޅެއް ތަފާތުވާނެ. ދެންބާކީހުރި އިންސްޓޮލޭޝަން އިރުޝާދުތައް ދޫކޮށްލެވިދާނެ.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+ކްލައުޑް އައިޑީއީ ނުވަތަ ކްލައުޑުގައި ސޮްފްޓްވެއަރ ތައްޔާރުކުރުމަށް ބޭނުންކުރާ އެޕްލިކޭޝަން އަކީ ކޯޑު ލިޔެ އަދި އިންޓަރނެޓުގައިވާ ކޮމްޕިއުޓަރކަށް ވަދެ ، ސޮފްޓްވެއަރ އިންސްޓޯލްކޮށް، ލިޔެ އަދި ސޮފްޓްވެއަރ ރަން ކުރެވޭނެ ގޮތް ހަދާއެއްޗެއް. މިޓިއުޓޯރިއަލް ހަދާއިރު،*local machine* އަކީ ކްލައުޑް އައިޑީއީ. ކްލާހުގައިތިބި OS X, Ubuntu, or Windows ބޭނުންކުރާ އެހެންބައިވެރިންނެކޭ އެއްގޮތަށް ތިބާވެސް ކޮމާންޑުތައް ޖައްސާނީ ޓަރމިނަލް އިންޓަރފޭސްގައި. އެކަމަކު މިޓަރމިނަލް ގުޅިފައި އިންނާނީ ކްލައުޑް އަޑީއީއިން ހަމަޖައްސައިދޭ އެހެންތަނެއްގައި އިން ކޮމްޕިއުޓަރަކާއެވެ. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). ކޮންމެވެސް 1 ކްލައުޑު އައިޑީއީެއް ނަގާ، އަދި ނެގި ކްލައުޑު އައިޑީއީގެ އިރުޝާދުތައް ބަަލަމުންދޭ.
+
+#### PaizaCloud Cloud IDE
+
+1. 1. paizaCloud Cloud IDE [](https://paiza.cloud/)ނަގާ
+2. އެކައުންޓެއްހަދާ
+3. Click *New Server* and choose the Django app
+4. ޓާރމިނަލް ބަޓަން( ވިންޑޯގެ ވާތްފަރާތުގައި) އަށް ފިތާލާ
+
+މީހާރު ސައިޑްބާރ އާއެކު އިންޓަރފޭސްއެއް ފެންނާނެ، ބަޓަންތައް ވާތްފަރާތުގައި. މި މެސެޖް ފެންނަ ޓަރމިނަލް ހުޅުވުމަށް "Terminal" ބަޓަން އަށް ފިތާލާ:
+
+{% filename %} ޓަރމިނަލް{% endfilename %}
+
+    $
+    
+
+PaizaCloud Cloud IDE ގައިވާ ޓާރމިނަލްވަނީ ތިޔަފަރާތުގެ އިރުޝާދުތަކަށް ތައްޔާރުވެފައި. ވިންޑޯގެ ސައިޒުބޮޑުކޮށް ނުވަތަ ބަދަލުކުރެވޭނެ.
+
+#### އެމޭޒަން ވެބްސަރަވިސް ކްލައުޑު 9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    $ yourusername:~/workspace
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### ވާރޗުއަލް އެންވަރމަންޓް
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### ގިޓްހަބް
+
+Make a [GitHub](https://github.com) account.
+
+### ޕައިތަންއެނީވެއަރ
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/dv-MV/code_editor/README.md b/dv-MV/code_editor/README.md
new file mode 100644
index 00000000000..7ab3cc714f6
--- /dev/null
+++ b/dv-MV/code_editor/README.md
@@ -0,0 +1,11 @@
+# ކޯޑު އެޑިޓަރ
+
+> ކިޔުންތެރިންނަށް: [އިންސްޓޯލިން ޕައިތަން & ކޯޑު އެޑިޓަރ ](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) ވީޑިއޯގައި މިޗެޕްޓަރ ހިމެނިފައިވާނެއެވެ.
+
+މިހާރު ތިއުޅެނީ އެންމެ ފުރަމަ ކޯޑުގެ ލައިން ލިޔާށެވެ. ކޯޑު އެޑިޓަރ އެއް ޑައުންލޯޑު ކުރާ ވަގުތު ޖެހުނީއެވެ!
+
+> **ނޯޓު** ކްރޯމްބުކް ބޭނުންކުރާނަމަ، މިޗެޕްޓަރ ދޫކޮށްލާށެވެ. އަދި [ކްރޯމްބުކް ސެޓަޕް](../chromebook_setup/README.md) ގެ އިރުޝާދުތައް ބަލާށެވެ. ކުރިން ނަގާފައިވާ ކްލައުޑު އައިޑީއީ ( ޕައިޒާ ކްލައުޑު އައިޑީއީ އަދި އޭޑަބްލިއުއެސް ކްލައުޑު 9) ގައި ކޯޑު އެޑިޓަރއެއް ހިމެނޭއެވެ، އައިޑީއީގެ ފައިލް މެނޫއިން ފައިލްއެއް ހުޅުވީމާ އެޑިޓަރ އޮޓޯއިން ބޭނުންކުރެވުނީއެވެ.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/dv-MV/code_editor/instructions.md b/dv-MV/code_editor/instructions.md
new file mode 100644
index 00000000000..00e7ebb9ccc
--- /dev/null
+++ b/dv-MV/code_editor/instructions.md
@@ -0,0 +1,37 @@
+ވަރަށް ގިނަ އެޑިޓަރތައް ހުންނައިރު ބޭނުންކުރާނެ އެޑިޓަރ އެއްއޮންނަނީ އަމިއްލަ އިޚްތިޔާރުގައެވެ. ގިނަ ޕައިތަން ޕްރޮގްރާމް ހަދާ މީހުން ބޭނުންކުރަނީ PyCharm ފަދަ އުނދަގޫ އެކަމަކު ވަރަށް ބާރުގަދަ އައިޑީއީ ތަކެއް( Integrated Development Environments). ފަށައިގަންނަ މީހަކަށް އެފަދަ އައިޑީއެއް ބޭނުން ނުވާނެ: އަހަރެމެން ކިޔައިދޭނީ ހަމަ އެފަދަ ބާރުގަދަ އެކަމަކު އާދައިގެ އައީޑީތަކެކެވެ.
+
+ތިރީގައި އެވަނީ އަހަރެމެންނަށް ފެންނަ އެޑިތަރުތަކެވެ. ކޯޗު ބޭނުން ވަކި އެޑިޓަރ އެއް އިންތޯ އަހާށެވެ. އެއީ ކޯޗުގެ އެހީ ހޯދަން ފަސޭހަވާނެތީވެ.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[މިތަނުން ޑައުންލޯޑު ކުރޭ](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[މިތަނުން ޑައުންލޯޑު ކުރޭ](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[މިތަނުން ޑައުންލޯޑު ކުރޭ](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/dv-MV/css/README.md b/dv-MV/css/README.md
new file mode 100644
index 00000000000..11b2b7aa7f8
--- /dev/null
+++ b/dv-MV/css/README.md
@@ -0,0 +1,330 @@
+# ސީއެސް އެސް - ރީތިކުރުމަށް!
+
+އަހަރެމެންގެ ބްލޮގް ހަޑިދޯ؟ މިއީ ބްލޮގް ރީތި ކޮށްލާ ވަގުތު! މިކަމަށް ބޭނުން ކުރާނީ ސީއެސްއެސް.
+
+## ސީ އެސް އެސް އަކީ ކޯއްޗެއް؟
+
+ކެސްކޭޑިން ސްޓައިލްޝީޓްސް ( ސީއެސް އެސް) އަކީ މާރކްއަޕް ލެންގުއޭޖުން ( އެޗްޓީއެމްއެލް ފަދަ) ލިޔަފައި ހުންނަ ވެބްސައިޓް ފެންނަގޮތް އަދި ފޯރމެޓިން އިންނަންވާގޮތް ކިޔައިދޭ ލެންގުއޭޖެކެވެ. ވެބްޕޭޖްގެ މޭކަޕް ގެ ގޮތަށް ގެންގުޅުން ރަނގަޅުވާނެ :)
+
+އެކަމަކު އަލުން ފަށާކަށް ބޭނުމެއް ނޫންދޯ؟ އަދި އެއްފަހަރު، އެކި ޕްރޮގްރާމަރުން އިންޓަރނެޓްއަށް ދޫކޮށްފައިހުރި ހިލޭ ބޭނުންކުރެވޭ ތަކެތި ބޭނުންކޮށްލާނަމެވެ. އަލުން ހުރިހާ އެއްޗެއް ހެދުމަކީ މަޖާކަމެއް ނޫން.
+
+## ބޫްޓް ސްޓްރެޕް ބޭނުންކުރަން ހިނގާ!
+
+ބޫޓްސްޓްރެޕްއަކީ ރީތި ވެބްސައިޓް ހެދުމަށްޓަކައި ބޭނުންކުރާ އެޗްޓީއެމްއެލް އަދި ސީއެސްއެސް ފްރޭމްވޯރކްއެވެ.: /https://getbootstrap.com
+
+މީތި ލިޔެފައިވަނީ ޓުވިޓާއަށް ކުރިން މަސައްކަތްކުރި ޕްރޮގްރާމަރުން ތަކެކެވެ. މިހާރު މީތި ތައްޔާރުކުރަނީ ދުނިޔޭގެ އެކިތަންތަނުގައި ތިބި ހިލޭ ސާބަހަށް މަސައްކަތްކުރާ މީހުންނެވެ!
+
+## ބޫޓްސްޓްރެޕް އިންސްޓޯލް ކުރޭ
+
+ބޫޓްސްޓްރެޕް އިންސްޓޯލްކުރުމަށް، `.html` ފައިލް ކޯޑު އެޑިޓަރގައި ހުޅުވާ އަދި `<head>` މީތި ސެކްޝަން އަށް ލާށެވެ:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+މީގެއިން ޕްރޮޖެކްޓްއަށް އެއްވެސް ފައިލްއެއް ނޭޅޭނެއެވެ. މީގެއިން އިންޓަރނެޓްގައި ވާ ފައިލްތަކަށް ޕޮއިންޓްކުރާނެއެވެ. އެހެންވީމާ، ވެބްސައިޓް ހުޅުވާފައި ޕޭޖް ރީފްރެޝް ކޮށްލާށެވެ. މިއޮތީ!
+
+![Figure 14.1](images/bootstrap1.png)
+
+މިހާރުވެސް ރީތިވެއްޖެ!
+
+## ޖެންގޯގައިވާ ސްޓެޓިކް ( ބަދަލުނުވާ) ފައިލްތައް
+
+**ސްޓެޓިިިކް ފައިލްސް** އޭ މިކިޔާ އެއްޗަށް ތަންކޮޅެއް ކައިރިން ބަލާލާނަމެވެ. ސްޓެޓިކް ފައިލްސް އަކީ ސީއެސް އެސް އަދި އިމޭޖް ތައް. މީގެ ކޮންޓެންޓުތައް ކޮންމެ ރިކުއެސްޓަކަށް (ސަރވާއަށް ފޮނުވާ ރިކުއެސްޓް) ނުބަލާނެ އަދި ބޭނުންކުރާމީހަކަށްވެސް ތަފާތެއް ނުވާނެއެވެ.
+
+### ޖެންގޯގައި ސްޓެޓިކް ފައިލްތައް ލާނީ ކޮންތަނަކަށް
+
+"އެޑްމިން" އެޕްގެ ސްޓެޓިކް ފައިލްތައް ލާން ޖެހޭތަން ޖެންގޯއަށް އިނގޭނެއެވެ. އަހަރެމެންގެ އަމިއްލަ `blog` އެޕްއަށް ސްޓެޓިކް ފައިލްތައް ލާންވީ.
+
+ފައިލްތައް ލާނީ ބްލޮގް އެޕްގައި `static`ނަމުގައި ފޯލްޑަރ އެއް ހަދައިގެން:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+އެއްވެސް އެޕް ފޯލްޑަރ އެއްގައި "static" ފޯލްޑަރ އެއް އިންތޯ ޖެންގޯއިން ހޯދާނެ. ސްޓެޓިކް ފައިލްގައި ހުރި އެއްޗެއް ބޭނުންކުރެވޭނެ.
+
+## އެންމެ ފުރަތަމަ ސީއެސްއެސް ފައިލް!
+
+އެންމެ ފުރަތަމަ ހިނގާ ސީއެސްއެސް ފައިލް އެއް ހަދަން، ވެބް ޕޭޖަށް އަމިއްލަ ސްޓައިލް އެއް ލާން. `static` ޑިރެކްޓްރީ ތެރޭގައި `css` ޖަހާފައި އާ ޑިރެކްޓްރީ އެއް ހަދާ. ދެން `css` ޑިރެކްޓްރީ ތެރޭގައި `blog.css` ނަމުގައި އާ ފައިލް އެއް ހަދާ. ތައްޔާރުތަ?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+މިއީ ސީއެސް އެސް ތަކެއް ލިޔަންވީ ވަގުތު! ކޯޑު އެޑިޓަރުގައި `blog/static/css/blog.css` ފައިލް ހުޅުވާ.
+
+މިތަނުގައި ސީއެސްއެސް ތަފްސީލުކޮށް ކަސްޓަމައިޒްކޮށް ދަސްކުރަން ކިޔައެއް ނުދޭނެ. އިތުރަށް ދަސްކުރަން ބޭނުންނަމަ މި ޕޭޖްގެ ތިރީގައި ހިލޭ ކިޔެވޭ ސީއެސްއެސް ކޯސްތައް ކިޔައިދީފައި ހުންނާނެ.
+
+އެކަމަކު ކުޑަކޮށް ކަސްޓަމައިޒް ކުރެވިދާނެ. ހެޑަރސްގެ ކުލަ ބަދަލުކޮށްލެވިދާނެ ދޯ? ކުލަ ދަސްކުރުމަށް، ޚާއްސަ ކޯޑުތަކެއް ކޮމްޕިއުޓަރ ގެންގުޅޭ. މިކޯޑުތައް ފެށޭނީ `#` އިން ދެން ފަހަތަށް 6 އަކުރު (A–F) އަދި ނަމްބަރު(0–9). މިސާލަކަށް، ނޫކުލައިގެ ކޯޑަކީ0000FF `#` ގިނަ ކުލަތަކުގެ ކޯޑު ލިބޭނީ http://www.colorpicker.com. `green ` އަދި `red` ފަދަ [ޕްރީޑިފައިންޑް ކުލަތައް](http://www.w3schools.com/colors/colors_names.asp) ބޭނުންކުރެވޭނެ.
+
+`blog/static/css/blog.css` ފައިލް އަށް ތިރީގައިވާ ކޯޑު އިތުރުކުރޭ:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` އަކީ ސީއެސްއެސް ސިލެކްޓަރ އެއް. މީގެ މާނައަކީ އަހަރެމެންގެ ސްޓައިލްތައް `h1` ތެރޭގައި ހިމެނޭ `a` ބަޔަކަށް ލަނީއޭ: `h2 a` ސިލެކްޓަރ ވެސް `h2` ގެ ބައިތަކަށް ހަމަ މިގޮތަށް ހަަދަނީ. އެހެންވީމާ `<h1><a href="">link</a></h1>` ގޮތަށް ހުންނަ ތަންތަނަށް`h1 a` ސްޓައިލް އެޕްލައިވާނެ. މިހާރު، މިބުނަނީ ކުލަ `C25100</0#> ކަޅު އޮރެންޖް ކުަލައަށް ބަދަލުކުރުމަށް. ނޫނީ އަމިއްލަޔަށް ބޭނުންވާ ކުަލައެއްވެސް ލިޔެވިދާނެ، އެކަމަކު ހުދު ބެކްގްރައުންޑެއްގައި ބޭނުންކުރީމައި ރަނގަޅަށް ފެންނަ ކުލައެއްތޯ ބަލާތި!</p>
+
+<p>އެޗްޓީއެމްއެލްގައިވާ ބައިތަކަށް ބޭނުންވާ ސްޓްއިލްތައް ސީއެސްއެސް ފައިލް އިން ކިޔައިދޭ. ކޮންމެ އެލިމެންޓް ( ބައެއް) ވެސް ވަކިކުރަނީ އެބަޔަކަށް ކިޔާނަމުން. އެޗްޓީއެމްއެލް ސެކްޝަންއިން ޓެގްސްގެ ގޮތުގައި ހަނދާން ވެދާނެ. މިގޮތުން <code>a`، `h1` އަދި `body` އަކީ މިފަދަ ބައިތަކުގެ ނަންތައް. އެޓްރިބިއުޓު `class` ނުވަތަ އެޓްރިބިއުޓު `id<0>އިންވެސް އެލިމެންޓްއެއް ވަކިކުރެވިދާނެ. އެލިމެންޓެއްގެ ކްލާސް އަދި އައިޑީ ނަމަކީ އެމީހަކު އަމިއްލަޔަށް ދޭ ނަމެއް. ކްލާހެއްގައި ހިމެނެނީ ގުރޫޕްކުރެވިފައިވާ އެލިމެންޓްތަކެއް، އަދި އައިޑީއިން ޕޮއިންޓުކުރަނީ ވަކި ވަކި އެލިމެންޓުތަކަށް. For example, you could identify the following element by using the element name <code>a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+އިތުރަށް ކިޔާލަން [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+ސީއެސް އެސް އިތިރުކުރި އެޗްޓީއެމްއެލް ޓެމްޕްލޭޓް އާއި ގުޅޭގޮތުން ކިޔައިދޭން އެބަޖެހޭ. `blog/templates/blog/post_list.html` ފައިލް ކޯޑު އެޑިޓަރގައި ހުޅުވާ އަދި ފަށާބަޔަށް މިލައިން އިތުރުކުރޭ:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+މިތަނުން ލޯޑު މިކުރަނީ ހަމައެކަނި ސްޓެޓިކް ފައިލްސް :) `<head>`and`</head>` ޓެގުތަކުގެ ދޭތެރޭ އަދި ބޫޓުސްޓްރެޕް ސީއެސް އެސް ފައިލްސްގެ ލިންކު ފަހަތަށް މިލައިން އިތުރުކުރޭ:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+ބްރައުޒާއިން ނަގާނީ ފައިލްތައް ދޭ ތަރުތީބުން، އެހެންވީމާ ރަނގަޅަށް ދޭން ޔަގީންކުރަންޖެހޭ. ނޫނީ އަހަރެމެންގެ ފައިލްގެ މައްޗަށް ބޫޓްސްޓްރެޕް ފައިލް ލެވިދާނެ. އަހަރެމެންގެ ޓެމްޕްލޭޓަށް މިކިޔައިދިނީ ސީއެސްއެސް ފައިލް އިންތަން.
+
+މިހާރު ފައިލް އިންނަންވާނީ މިހެން:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+އޯކޭ، ފައިލް ސޭވްކޮށްފައި ސައިޓް ރީފްރެށްކޮށްލާ!
+
+![Figure 14.2](images/color2.png)
+
+ސަޅި: މިހާރު ކުޑަކޮށް ވެބްސައިޓް ބޮޑުކޮށްލާ އަދި ކަނާތްފަރާތުގެ މާރޖިން ބޮޑުކޮށްލަން މަސައްކަތްކޮށްލަންވީ. މިހެން ހަދަން ހިނގާ!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+ސީއެސްއެސް ފައިލް އަށް ކޯޑުކޮޅު އިތުރުކޮށްފައި ސޭވްކޮށްލީމާ މަސައްކަތްކުރޭތޯ ބަލަންވީއެންނު!
+
+![Figure 14.3](images/margin2.png)
+
+ހެޑަރގައި އިން ފޮންޓު ކަސްޓަމައިޒްކޮށްލަން ވީއެންނު؟ މިލައިން ޕޭޖުގެ `<head>` in `blog/templates/blog/post_list.html` file ހިމަނާލަންވީނު:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+ކުރިންވެސް ހެދި ގޮތށް، އޯރޑަރޗެކްކޮށްފައި މިލިންކު `blog/static/css/blog.css` ގެ ކުރިޔަށް އިތުރުކުރޭ. މިލައިންއިން *Lobster* ނަމުގައި އިން ފޮންޓެއް ގޫގުލް ފޮންޓް އިން އިމްޕޯރޓް ކުރާނެ. (https://www.google.com/fonts).
+
+`blog/static/css/blog.css` ސީއެސް އެސްފައިލްގެ ޑިކްލެރޭޝަން ބްލޮކް ( ބްރެކެޓް ދޭތެރޭގައިވާ ކޯޑުތައް `{` and `}`) އިން `h1 a` ހޯދާ. ދެން `font-family: 'Lobster';` މިލައިން ބްރެކެޓްތަކުގެ ދޭތެރެއަށް އިތުރުކޮށްފައި ޕޭޖު ރިފްރެޝްކޮށްލާ:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+ގަދަ!
+
+މަތީގައިވެސް ބުނިގޮތަށް، ސީއެސްއެސްގައި އިންނަނީ ކްލާސްތަކުގެ ކޮންސެޕްޓް. އެޗްޓީއެމްއެލްގެ ކޯޑުގެ ވަކިބަޔަކަށް ސްޓައިލް އެޕްލައިކުރާއިރު އަނެއް ބަޔަށް އަސަރު ނުކުރާ ގޮތަށް އެޕްލައިކުރެވޭނެ. މިއީ ވަރަށް ބޮޑު އެހީއެއް! ފަހަރެއްގައި ދެ ޑިވް އެއް އިނދެފާނެ ތަފާތު ދެކަމެއް ކުރާ ( ހެޑަރ އަދި ޕޯސްޓް ގޮތައް). ކިލާހަކުން މިދޭތި ފެންނަގޮތް ތަފާތުކުރަން އެހީތެރިވޭ.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+ދެން އެކި ސެލެކްޓަރސް އަށް ވަކިވަކި ޑެކްލެރޭޝަން ބްލޮކް ލާނީ. ފުރަތަމަ `.` އާއި ގުުޅުންހުރި ސެލެކްޓަރސް އިން ފަށާނީ. މިކޯޑުތައް ދަސްކުރުމަށް އިންޓަރނެޓުގައި ސީއެސްއެސްއާއި ގުޅުންހުރި ވަރަށްގިނަ ޓިއުޓޯރިއަލްއާއި ތަފްސީލުތައް އެބަހުރި. މިހާރަށް، `blog/static/css/blog.css` file: ކޮޕީކޮށްފައި ޕޭސްޓުކޮށްލާ:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+ނަ ކްލާސް ޑިކްލެރޭޝަންތައް ހިމެނޭ އެޗްޓީއެމްއެލް ކޯޑުތައް ނަގާފައި، މިގޮތަށް ބަދަލުކޮށްލާ:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+`blog/templates/blog/post_list.html` މިގޮތަށް:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+ފައިލް ސޭވްކޮށްފައ ވެބްސައިޓް ރީފްރެޝްކޮށްލާ.
+
+![Figure 14.4](images/final.png)
+
+ސާބަހޭ! ރީތިދޯ? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/dv-MV/deploy/README.md b/dv-MV/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/dv-MV/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/dv-MV/deploy/install_git.md b/dv-MV/deploy/install_git.md
new file mode 100644
index 00000000000..9641950fdc8
--- /dev/null
+++ b/dv-MV/deploy/install_git.md
@@ -0,0 +1,52 @@
+ގިޓް އަކީ ގިނަ ޕްރޮގްރާމަރުން ބޭނުންކުރާ " ވާރޝަން ކޮންޓްރޯލް ސިސްޓަމް". މި ސޮފްޓްވެއަރ އިން ފައިލަކަށް ގެންނަ ބަދަލު ބަލަމުންގެންދާނެ އަދި ބޭނުންވާ ވާރޝަންއެއް ހޯދައިދޭނެ. ވޯރޑު ޕްރޮސެސަރ ( މައިކްރޮސޮފްޓް ވޯޑު ނުވަތަ ލިބްރޭ އޮފީސް ރައިޓަރ ފަދަ) ގައި އިންނަ " ޓްރެކް ޗޭންޖެސް" ފީޗަރ ގޮތައް އެކަމަކު އެއަށްވުރެ ބާރުގަދަ އެއްޗެއް.
+
+## ގިޓު އިންސްޓޯލްކުރުން
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+</a>git-scm.com އިން ގިޓު ޑައުންލޯޑު ކުރެވޭނެ. ދެ ސްޓެޕް ފިޔަވައި ދެން ހުރި ހުރިހާ ބަޔަކަށް"ނެކްސްޓް" ނެގޭނެ: އެޑިޓަރ އެއް ނަގަން ބުނާ ސްޓެޕްގައި ، ނެނޯ ނަގާފައި އަދި " އެޖަސްޓިން ޔުައަރ ޕާތް އެންވަޔަރމަންޓް" ގައި " ޔޫޒް ގިޓް އެންޑް އޮޕްޝަނަލް ޔުނިކްސް ޓޫލްސް ފްރޮމް ވިންޑޯސް ކޮމާންޑް ޕްރޮމްޕުޓް" ( ތިރީގައިވާ އޮޕްޝަން) ނަގާ. އެބައިތައް ނުލާ، އެހެން ހުރިހާތަނަކަށް ޑީފޯލްޓް ރަނަގޅުވާނެ. ވިންޑޯސް-ސްޓައިލްގެ ، ކޮމިޓް ޔުނިކްސް-ސްޓައިލް ލައިންގެ ނިންމުން ރަނގަޅު.</p> 
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+[git-scm.com](https://git-scm.com/) ގިޓު ޑައުންލޯޑުކޮށްފައ އިރުޝާދުތައް ބަލާ.
+
+> **ނޯޓު** އޯއެސް އެކްސް 10.6، 10.7، ނުވަތަ 10.8 ބޭނުންކުރާނަމަ، ގިޓުގެ ވާރޝަން މިތަނުން ޑައުންލޯޑުކުރޭ:[Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/dv-MV/deploy/signup_pythonanywhere.md b/dv-MV/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..34ba026af22
--- /dev/null
+++ b/dv-MV/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+ޕައިތަން އެނީވެއަރ އަކީ ކްލައުޑުގައި ވާ ސާރވާރތަކުގައި ޕައިތަން ކޯޑު ރަންކުރުމަށް ބޭނުންކުރާ ޚިދުމަތެއް. އަހަރެމެން ޕައިތަން އެނީވެއަރ ބޭނުންކުރާނީ ސައިޓު ހޮސްޓުކޮށް އިންޓަނެޓުގައި ލައިވްކުރުމަށް.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/dv-MV/django/README.md b/dv-MV/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/dv-MV/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/dv-MV/django_admin/README.md b/dv-MV/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/dv-MV/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/dv-MV/django_forms/README.md b/dv-MV/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/dv-MV/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/dv-MV/django_installation/README.md b/dv-MV/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/dv-MV/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/dv-MV/django_installation/instructions.md b/dv-MV/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/dv-MV/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/dv-MV/django_models/README.md b/dv-MV/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/dv-MV/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/dv-MV/django_orm/README.md b/dv-MV/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/dv-MV/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/dv-MV/django_start_project/README.md b/dv-MV/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/dv-MV/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/dv-MV/django_templates/README.md b/dv-MV/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/dv-MV/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/dv-MV/django_urls/README.md b/dv-MV/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/dv-MV/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/dv-MV/django_views/README.md b/dv-MV/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/dv-MV/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/dv-MV/dynamic_data_in_templates/README.md b/dv-MV/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/dv-MV/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/dv-MV/extend_your_application/README.md b/dv-MV/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/dv-MV/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/dv-MV/how_the_internet_works/README.md b/dv-MV/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/dv-MV/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/dv-MV/html/README.md b/dv-MV/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/dv-MV/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/dv-MV/installation/README.md b/dv-MV/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/dv-MV/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/dv-MV/intro_to_command_line/README.md b/dv-MV/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/dv-MV/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/dv-MV/intro_to_command_line/open_instructions.md b/dv-MV/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/dv-MV/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/dv-MV/python_installation/README.md b/dv-MV/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/dv-MV/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/dv-MV/python_installation/instructions.md b/dv-MV/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/dv-MV/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/dv-MV/python_introduction/README.md b/dv-MV/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/dv-MV/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/dv-MV/template_extending/README.md b/dv-MV/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/dv-MV/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/dv-MV/whats_next/README.md b/dv-MV/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/dv-MV/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/el-GR/GLOSSARY.md b/el-GR/GLOSSARY.md
new file mode 100644
index 00000000000..b1bce01c323
--- /dev/null
+++ b/el-GR/GLOSSARY.md
@@ -0,0 +1,3 @@
+# Επεξεργαστής Κώδικα
+
+Ο επεξεργαστής κώδικα είναι μια εφαρμογή που σου επιτρέπει να επεξεργάζεσαι και να αποθηκεύεις τον κώδικα σου, ώστε να είσαι σε θέση να επιστρέψεις σε αυτό αργότερα. Επίσης σου προσφέρει διάφορα εργαλεία όπως εύκολη αναζήτηση, αυτόματη συμπλήρωση κώδικα, απ' ευθείας μετάβαση σε κάποιο σημείο κλπ. Μπορείς να μάθεις πού μπορείς να βρείς ένα από το [κεφάλαιο επεξεργαστής κώδικα](./code_editor/README.md)
\ No newline at end of file
diff --git a/el-GR/README.md b/el-GR/README.md
new file mode 100644
index 00000000000..c179ba84d8e
--- /dev/null
+++ b/el-GR/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! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Εισαγωγή
+
+Έχεις νιώσει ποτέ ότι ο κόσμος γίνεται όλο και περισσότερο σχετικός με την τεχνολογία και δεν μπορείς (ακόμα) να συσχετιθείς; Έχεις ποτέ αναρωτηθεί πώς να δημιουργήσεις μια ιστοσελίδα, αλλά ποτέ δεν είχες αρκετό κίνητρο για να ξεκινήσεις; Έχεις ποτέ σκεφτεί οτι ο κόσμος του software είναι πολύ περίπλοκος για σένα για να προσπαθήσεις να κάνεις κάτι από μόνη σου;
+
+Λοιπόν, έχουμε καλά νέα για σένα! Ο προγραμματισμός δεν είναι τόσο δύσκολος όσο φαίνεται και θέλουμε να σου δείξουμε πόσο διασκεδαστικός μπορεί να είναι.
+
+Αυτός ο οδηγός δεν θα σε μετατρέψει σε προγραμματιστή ως δια μαγείας. Αν θέλεις να γίνεις καλή προγραμματίστρια, χρειάζεται μήνες ή ακόμη και χρόνια εκμάθησης και πρακτικής εξάσκησης. Όμως θέλουμε να σου δείξουμε οτι ο προγραμματισμός ή η δημιουργία ιστιοσελίδων δεν είναι τόσο περίπλοκο όσο φαίνεται. Θα προσπαθήσουμε να σου εξηγήσουμε τα διάφορα κομμάτια όσο καλύτερα μπορούμε, ούτως ώστε να μην σε φοβίζει η τεχνολογία.
+
+Ελπίζουμε να μπορέσουμε να σε κάνουμε να αγαπήσεις την τεχνολογία, όπως εμείς!
+
+## Τι θα μάθεις κατα τη διάρκεια του οδηγού;
+
+Μόλις ολοκληρώσεις τον οδηγό, θα έχεις μία μικρή λειτουργική εφαρμογή ιστού (web application): το δικό σου blog. Θα σου δείξουμε πως να το ανεβάσεις ηλεκτρονικά, ώστε άλλοι να δουν την δουλειά σου!
+
+Θα φαίνεται έτσι (πάνω κάτω):
+
+![Σχήμα 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, αλλά γνωρίζουμε ότι δεν είναι πάντα εφικτό να παρακολουθήσετε ένα. Για αυτό σας ενθαρρύνουμε να προσπαθήσετε να ακολουθήσετε αυτό το σεμινάριο στο σπίτι. Για τους αναγνώστες στο σπίτι, προς το παρόν ετοιμάζουμε βίντεο που θα το κάνουν ευκολότερο να παρακολουθήσετε τον οδηγό από μόνοι σας. Είναι ακόμα ένα έργο σε εξέλιξη, αλλά όλο και περισσότερα πράγματα θα καλυφθούν σύντομα στο κανάλι του YouTube [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed).
+
+Σε κάθε κεφάλαιο που έχει ήδη καλυφθεί, υπάρχει ένας σύνδεσμος που οδηγεί στο αντίστοιχο βίντεο.
+
+## Σχετικά με μας και πως να συνεισφέρετε
+
+Αυτό το σεμινάριο συντηρείται από την κοινότητα [DjangoGirls](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) ενημερώνοντας μας για την γλώσσα ώστε να την προσθέσουμε.
\ No newline at end of file
diff --git a/el-GR/SUMMARY.md b/el-GR/SUMMARY.md
new file mode 100644
index 00000000000..71f57d59051
--- /dev/null
+++ b/el-GR/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-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Εγκατάσταση (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 project!](django_start_project/README.md)
+* [Μοντέλα (models) του Django](django_models/README.md)
+* [Διαχείριση μέσω Django admin](django_admin/README.md)
+* [Ανεβάστε!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views - ώρα να δημιουργήσετε!](django_views/README.md)
+* [Εισαγωγή στην HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Δυναμικά δεδομένα στα templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS - κάντε το όμορφο](css/README.md)
+* [Επεκτείνοντας τα templates](template_extending/README.md)
+* [Επεκτείνοντας την εφαρμογή σας](extend_your_application/README.md)
+* [Φόρμες Django](django_forms/README.md)
+* [Τι υπάρχει μετά;](whats_next/README.md)
\ No newline at end of file
diff --git a/el-GR/chromebook_setup/README.md b/el-GR/chromebook_setup/README.md
new file mode 100644
index 00000000000..f53690448d9
--- /dev/null
+++ b/el-GR/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Ρυθμίσεις για χρήστες Chromebook
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/el-GR/chromebook_setup/instructions.md b/el-GR/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..988b083f74c
--- /dev/null
+++ b/el-GR/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Μπορείτε [ να παραλείψετε αυτή την ενότητα](http://tutorial.djangogirls.org/en/installation/#install-python) εάν δεν χρησιμοποιείτε το Chromebook. Εάν το χρησιμοποιείτε, η διαδικασία εγκατάστασης θα είναι λίγο διαφορετική. Σε αυτή την περίπτωση μπορείτε να αγνοήσετε τις υπόλοιπες οδηγίες εγκατάστασης.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Το CloudIDE είναι ένα εργαλείο το οποίο σου παρέχει έναν επεξεργαστή κώδικα καθώς και πρόσβαση σε έναν υπολογιστή στο internet στον οποίο μπορείς να εγκαταστήσεις, να γράψεις και να τρέξεις το λογισμικό. Κατά τη διάρκεια του οδηγού, το CloudIDE θα παίζει το ρόλο του *local machine* (δηλαδή του τοπικού υπολογιστή σας). Παραταύτα, θα χρειαστεί να γράφετε εντολές στο τερματικό όπως ακριβώς οι συμμαθητές σας που χρησιμοποιούν OS X, Ubuntu ή Windows, με την μόνη διαφορά ότι το τερματικό δεν θα τρέχει στον υπολογιστή που κάθεστε αλλά στο cloud (σύννεφο), εκεί που το όρισε το CloudIDE (σε κάποιον εικονικό υπολογιστή, δηλαδή, στο internet). Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Μπορείτε να επιλέξετε ένα από τα cloud IDEs και να ακολουθήσετε τις αντίστοιχες οδηγίες του.
+
+#### PaizaCloud Cloud IDE
+
+1. Πηγαίνετε στο [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Δημιούργησε λογαριασμό
+3. Click *New Server* and choose the Django app
+4. Κάντε κλικ στο κουμπί Terminal (στην αριστερή πλευρά του παραθύρου)
+
+Τώρα θα πρέπει να δείτε μια σελίδα με πλαϊνή μπάρα εργασίων και κουμπιά στα αριστερά. Κάντε κλικ στο κουμπί «Terminal» για να ανοίξετε το παράθυρο του τερματικού (ή αλλιώς "κοσνόλα" ή "γραμμή εντολών") όπως παρακάτω:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+Το τερματικό στο PaizaCloud Cloud IDE είναι έτοιμο να δεχτεί τις εντολές σας. Μπορείτε να αλλάξετε το μέγεθος του παραθύρου ή να το μεγιστοποιήσετε, αν θέλετε.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+Αυτή η κάτω περιοχή είναι το τερματικό σας. Μπορείτε να χρησιμοποιήσετε το τερματικό για να στείλετε οδηγίες στον απομακρυσμένο υπολογιστή Cloud 9. Μπορείτε να αλλάξετε το μέγεθος αυτού του παραθύρου για να το κάνετε μεγαλύτερο.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Εικονικό Περιβάλλον
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/el-GR/code_editor/README.md b/el-GR/code_editor/README.md
new file mode 100644
index 00000000000..063b14ea2e9
--- /dev/null
+++ b/el-GR/code_editor/README.md
@@ -0,0 +1,11 @@
+# Προγράμματα Επεξεργασίας Κώδικα
+
+> Για τους αναγνώστες στο σπίτι: αυτό το κεφάλαιο καλύπτεται στο [ Εγκαθιστώντας την Python& Πρόγραμμα επεξεργασίας κώδικα](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s)βίντεο.
+
+Σύντομα πρόκειται να γράψετε την πρώτη σας γραμμή κώδικα, οπότε ήρθε η ώρα να κατεβάσετε ένα πρόγραμμα επεξεργασίας κώδικα (code editor)!
+
+> **Σημείωση** εάν χρησιμοποιείτε Chromebook, παρακάμψτε αυτό το κεφάλαιο και σιγουρευτείτε ότι ακολουθείτε τις οδηγίες [Εγκατάστασης Chromebook](../chromebook_setup/README.md). Η επιλογή σας ως προς το cloud IDE (PaizaCloud cloud IDE ή AWS Cloud9) περιλαμβάνει ήδη ένα πρόγραμμα επεξεργασίας κώδικα και όταν ανοίγετε ένα αρχείο στο IDE σας από το μενού "Αρχείο", θα χρησιμοποιείτε αυτόματα εκείνον τον επεξεργαστή.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/el-GR/code_editor/instructions.md b/el-GR/code_editor/instructions.md
new file mode 100644
index 00000000000..eea5b05f839
--- /dev/null
+++ b/el-GR/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Υπάρχουν πολλά code editors (επεξεργαστές κώδικα) διαθέσιμοι και για αυτό είστε ελεύθεροι να διαλέξετε αυτόν που σας αρέσει περισσότερο (ή ανάλογα την τσέπη σας αν θέλετε να αγοράσετε κάποιον). Οι περισσότεροι προγραμματιστές της Python χρησιμοποιούν περίπλοκα, αλλά εξαιρετικά ισχυρά IDEs (Integrated Development Environments - Ολοκληρωμένα Περιβάλλοντα Ανάπτυξης), όπως το PyCharm. Για αρχάριους, ωστόσο, αυτή η επιλογή είναι ίσως η λιγότερο κατάλληλη· για αυτό σας προτείνουμε προγράμματα εξίσου ισχυρά, αλλά πολύ απλούστερα.
+
+Οι προτάσεις μας φαίνονται παρακάτω αλλά μην διστάσεις να ρωτήσεις τον "coach" (εκπαιδευτή) σου ποιες είναι οι προτιμήσεις του. Θα είναι ευκολότερο αργότερα να σε βοηθήσει σε όποιο ζήτημα μπορεί να προκύψει.
+
+## Visual Studio Code
+
+Το Visual Studio Code είναι ένας κειμενογράφος κώδικα που αναπτύσσεται απ' τη Microsoft για Windows, Linux και macOS. Περιλαμβάνει υποστήριξη για αποσφαλμάτωση, ενσωματωμένο έλεγχο για το Git, χρωματική απεικόνιση του κώδικα, έξυπνη αυτόματη συμπλήρωση του κώδικα, κλπ.
+
+[Κατεβάστε το εδώ](https://code.visualstudio.com/)
+
+## Gedit
+
+Το Gedit είναι ένας ανοιχτού κώδικα, ελεύθερος κειμενογράφος, διαθέσιμος για όλα τα λειτουργικά συστήματα.
+
+[Κατεβάστε το εδώ](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Το Sublime Text είναι ένας πολύ δημοφιλής κειμενογράφος με δωρεάν δοκιμαστική περίοδο και διατίθεται για όλα τα λειτουργικά συστήματα.
+
+[Κατεβάστε το εδώ](https://www.sublimetext.com/3)
+
+## Atom
+
+Το Atom είναι άλλος ένας δημοφιλής κειμενογράφος. Είναι δωρεάν, ανοιχτού κώδικα και διαθέσιμος για Windows, OS X και Linux. Το Atom αναπτύσσεται από το [GitHub](https://github.com/).
+
+[Κατεβάστε το εδώ](https://atom.io/)
+
+## Γιατί χρειαζόμαστε τους code editors (Προγράμματα Επεξεργασίας Κώδικα);
+
+Μπορεί να αναρωτιέσαι γιατί χρειάζεται να εγκαταστήσουμε κάποιο ειδικό πρόγραμμα επεξεργασίας κώδικα λογισμικού, αντί να χρησιμοποιήσουμε κάτι σαν το Word ή το Notepad.
+
+Ο πρώτος λόγος είναι ότι ο κώδικας πρέπει να είναι **απλό κείμενο** (δίχως bold, italic, πίνακες, εικόνες κλπ, όπως θα χρησιμοποιούσε κανείς σε έναν κοινό επεξεργαστή κειμένου). Το πρόβλημα με τα προγράμματα όπως το Word και το Textedit είναι ότι δεν παράγουν στην ουσία απλό κείμενο αλλά "πλούσιο" (με γραμματοσειρές, φορμάρισμα κειμένου και αυτά που αναφέραμε παραπάνω), χρησιμοποιώντας σύνθετες μορφές όπως το [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+Δεύτερον, τα προγράμματα επεξεργασίας κώδικα είναι ειδικά σχεδιασμένα για την σύνταξη κώδικα, ούτως ώστε να μπορούν να παρέχουν χρήσιμα εργαλεία όπως η επισήμανση του κώδικα με διαφορετικό χρώμα ανάλογα την σημασία του, το αυτόματο κλείσιμο εισαγωγικών κλπ.
+
+Θα τα δούμε όλα αυτά στην πράξη αργότερα. Σύντομα, θα αρχίσετε να βλέπετε τον παλιό σας, έμπιστο επεξεργαστή κώδικα ως ένα από τα αγαπημένα σας εργαλεία. :)
\ No newline at end of file
diff --git a/el-GR/css/README.md b/el-GR/css/README.md
new file mode 100644
index 00000000000..2d8d4322c51
--- /dev/null
+++ b/el-GR/css/README.md
@@ -0,0 +1,330 @@
+# CSS - κάντε το όμορφο!
+
+Το blog μας φαίνεται αρκετά άσχημο, έτσι δεν είναι; Ωρα να το κάνουμε όμορφο! Γι'αυτή τη δουλειά θα χρειαστούμε το CSS.
+
+## Τι είναι το CSS;
+
+Το CSS (Cascading Style Sheets - Διαδοχικά Φύλλα Στυλ) είναι μια γλώσσα που χρησιμοποιείται για να περιγράψει την εμφάνιση και την μορφοποίηση μιας ιστοσελίδας που έχει γραφτεί σε γλώσσα σήμανσης (όπως η HTML). Δείτε το σαν το μακιγιάζ για την ιστοσελίδα μας ;)
+
+Άλλα δεν θέλουμε να ξεκινήσουμε από την αρχή ξανά, έτσι; Για ακόμα μια φορά θα χρησιμοποιήσουμε κάτι που οι προγραμματιστές χρησιμοποιούν ήδη και είναι δωρεάν στο διαδίκτυο. Το να ανακαλύπτουμε τον τροχό δεν έχει πλάκα, ξέρετε.
+
+## Ας χρησιμοποιήσουμε το Bootstrap!
+
+Το Bootstrap είναι μια από τις πιο δημοφιλή HTML / CSS εργαλειοθήκες (framework) που αποσκοπούν στην εύκολη και γρήγορη ανάπτυξη όμορφων ιστοσελίδων: https://getbootstrap.com/
+
+Γράφτηκε από προγραμματιστές που εργάστηκαν στο Twitter. Τώρα αναπτύσσεται από εθελοντές από ολόκληρο το κόσμο!
+
+## Εγκατάσταση του Bootstrap
+
+Για την εγκατάσταση του Bootstrap, ανοίξτε το αρχείο `.html` στον επεξεργαστή κώδικα και προσθέστε αυτό στην ενότητα `<head>`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Αυτό δεν προσθέτει κάποια αρχεία στο project σας. Απλώς, δείχνει σε αρχεία που υπάρχουν στο διαδίκτυο. Πηγαίνετε, λοιπόν, επισκεφτείτε την ιστοσελίδα σας και ανανεώστε τη σελίδα. Νάτο!
+
+![Σχήμα 14.1](images/bootstrap1.png)
+
+Δείχνει ήδη πολύ καλύτερο!
+
+## Στατικά αρχεία στο Django
+
+Τέλος, ας ρίξουμε μια πιο προσεκτική ματιά στα λεγόμενα **στατικά αρχεία**. Τα στατικά αρχεία (static files) είναι όλα τα αρχεία CSS και όλα τα αρχεία εικόνας (φωτογραφίες). Το περιεχόμενο τους δεν εξαρτάται από το εκάστοτε request και έτσι μένει ίδιο για κάθε χρήστη.
+
+### Πού να τοποθετήσετε τα στατικά αρχεία στο Django
+
+Το Django ήδη ξέρει πού να βρει τα στατικά αρχεία για την ενσωματωμένη εφαρμογή «admin». Τώρα πρέπει να προσθέσουμε κάποια στατικά αρχεία για την δική μας εφαρμογή, `blog`.
+
+Για να το κάνουμε αυτό πρέπει να δημιουργήσουμε ένα φάκελο με το όνομα `static` μέσα στο φάκελο blog της εφαρμογής μας:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Το Django θα βρίσκει αυτόματα οποιοδήποτε φάκελο ονομάζεται "static" μέσα στους φακέλους οποιασδήποτε εφαρμογή σας. Έπειτα θα μπορεί να χρησιμοποιεί το περιεχόμενο τους ως στατικά αρχεία.
+
+## Το πρώτο CSS αρχείο σας!
+
+Ας δημιουργήσουμε ένα CSS αρχείο τώρα, για να προσθέσετε το δικό σας στυλ στην ιστοσελίδα σας. Δημιουργήστε έναν νέο φάκελο που ονομάζεται `css` μέσα στο `static` φάκελο. Στη συνέχεια, δημιουργήστε ένα νέο αρχείο που ονομάζεται `blog.css` μέσα σε αυτόν τον φάκελο `css`. Είστε έτοιμοι;
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Ώρα να γράψουμε λίγο CSS! Άνοιξτε το αρχείο `blog/static/css/blog.css` στον επεξεργαστή.
+
+Δεν θα εμβαθύνουμε πολύ σχετικά με την γλώσσα CSS. Υπάρχει μια πρόταση σχετικά με μάθημα CSS στο τέλος αυτής της σελίδας αν θέλετε να μάθετε περισσότερα.
+
+Αλλά ας δοκιμάσουμε μερικά πράγματα. Ίσως θα μπορούσαμε να αλλάξουμε το χρώμα των τίτλων της σελίδας μας; Για να καταλάβετε τη λογική των χρωμάτων, οι υπολογιστές χρησιμοποιούν ειδικούς κώδικες. Αυτοί οι κώδικες ξεκινάνε με `#` και ακολουθούνται από 6 γράμματα (A-F) και αριθμούς (0-9). Για παράδειγμα, ο κωδικός για το μπλε είναι `#0000FF`. Μπορείτε να βρείτε τους κωδικούς των χρωμάτων για πολλά χρώματα εδώ: http://www.colorpicker.com/. Μπορείτε επίσης να χρησιμοποιήσετε [προκαθορισμένα χρώματα](http://www.w3schools.com/colors/colors_names.asp) με το αγγλικό όνομά τους, όπως το `red` (κόκκινο) και το `green` (πράσινο).
+
+Στο αρχείο `blog/static/css/blog.css` πρέπει να προσθέσετε τον παρακάτω κώδικα:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+Το `h1 a` είναι ένας επιλογέας CSS (CSS selector). Αυτό σημαίνει ότι θέλουμε να εφαρμόσουμε τα στυλ (στη συγκεκριμένη περίπτωση έχουμε ένα στυλ, το χρώμα) σε κάθε `a` στοιχείο μέσα σε κάθε `h1` στοιχείο. Ο επιλογέας `h2 a` κάνει το ίδιο πράγμα αλλά για τα `h2` στοιχεία. Έτσι όταν έχουμε κάτι σαν `<h1><a href="">σύνδεσμο</a></h1>`, το `h1 a ` στυλ θα εφαρμοστεί. Σε αυτή τη περίπτωση, του λέμε να αλλάξει το χρώμα του σε `#C25100`, που είναι το σκούρο πορτοκαλί. Ή μπορείτε να βάλετε το δικό σας χρώμα εδώ, αλλά σιγουρευτείτε ότι έχει καλή αντίθεση σε λευκό φόντο!
+
+Μέσα σε ενα αρχείο CSS καθορίζουμε τα στύλ για τα στοιχεία μέσα στο HTML αρχείο. Ο πρώτος τρόπος που αναγνωρίζουμε στοιχεία είναι με το όνομα στοιχείου. Μπορεί να τα θυμάστε αυτά ως ετικέτες από την HTML. Πράγματα όπως `a`, `h1` και το `body` είναι όλα τα παραδείγματα των ονομάτων στοιχείων (HTML elements). Μπορούμε επίσης να προσδιορίσουμε στοιχεία από το χαρακτηριστικό `class` ή το χαρακτηριστικό `id`. Η τάξη (class) και η ταυτότητα (id) είναι ονόματα που δίνεις εσύ στο κάθε στοιχείο. Οι τάξεις αναφέρονται σε ομάδες στοιχείων και οι ταυτότητες σε συγκεκριμένα στοιχεία. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Διαβάστε περισσότερα για τους επιλογείς CSS στο [w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+Στη συνέχεια, πρέπει να πούμε στο HTML αρχείο οτι θέλουμε να συμπεριλάβουμε αρχείο/α CSS. Ανοίξτε το αρχείο `blog/templates/blog/post_list.html` και προσθέστε αυτή τη γραμμή στην αρχή:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Απλά "φορτώνουμε" στατικά αρχεία σε αυτό το σημείο :) Μεταξύ του `<head>` και `</head>` ετικετών (tags), μετά τα links με τα Bootstrap αρχεία CSS, προσθέστε αυτή τη γραμμή:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Ο browser διαβάζει τα αρχεία με την σειρά που δίνονται, οπότε πρέπει να σιγουρευτούμε ότι αυτή είναι η σωστή θέση. Διαφορετικά ο κώδικας στο αρχείο μας μπορεί να παρακαμφθεί από τον κώδικα στα αρχεία Bootstrap. Μόλις είπαμε στο template μας που βρίσκεται το CSS αρχείο μας.
+
+Το αρχείο σας πρέπει τώρα να μοιάζει κάπως έτσι:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Εντάξει, αποθηκεύστε το αρχείο και ανανεώστε τη σελίδα!
+
+![Σχήμα 14.2](images/color2.png)
+
+Πολύ καλά! Θα θέλατε να δώσουμε λίγο αέρα στην ιστοσελίδα μας και να αυξήσουμε το περιθώριο στα αριστερά; Ας το δοκιμάσουμε!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Προσθέστε αυτό στο CSS σας, αποθηκεύστε τον αρχείο και δείτε πως λειτουργεί!
+
+![Σχήμα 14.3](images/margin2.png)
+
+'Ισως μπορούμε να αλλάξουμε την γραμματοσειρά της επικεφαλίδας μας. Μεσα στο `<head>` που βρίσκεται μεσα στο αρχείο `blog/templates/blog/post_list.html` βάλτε αυτό:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Όπως πριν, ελέγξτε τη σειρά και τοποθετήστε το πριν τον σύνδεσμο `blog/static/css/blog.css`. Αυτή η γραμμή θα εισάγει μια γραμματοσειρά που λέγεται *Lobster* από τα Google Fonts (https://www.google.com/fonts).
+
+Βρείτε το `h1 a` μπλοκ (τον κώδικα μεταξύ `{` και `}`) μέσα στο αρχείο CSS `blog/static/css/blog.css`. Τώρα προσθέστε την γραμμή `font-family: 'Lobster';` μεταξύ των αγκύλων και ανανεώστε τη σελίδα:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Σχήμα 14.3](images/font.png)
+
+Τέλεια!
+
+Όπως αναφέρθηκε παραπάνω, το CSS έχει την έννοια των κλάσεων (classes). Αυτές σας επιτρέπουν να ονομάσετε ένα μέρος του κώδικα HTML και να εφαρμόσετε στυλ μόνο σε αυτό το μέρος, χωρίς να επηρεάσετε άλλα μέρη. Αυτό μπορεί να είναι εξαιρετικά χρήσιμο! Ίσως να έχετε δύο divs τα οποία περιγράφουν κάτι διαφορετικό το καθένα (όπως πχ μια επικεφαλίδα και ένα post). Μια class μπορεί να σας βοηθήσει να τα κάνετε να μοιάζουν διαφορετικά.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Τώρα θα προσθέσουμε κώδικα στους επιλογείς (selectors) που μόλις δημιουργήσαμε. Οι επιλογείς που ξεκινούν με `.` αναφέρονται σε κλάσεις. Υπάρχουν πολλοί σπουδαίοι οδηγοί (tutorials) και εξηγήσεις σχετικά με το CSS στο διαδίκτυο τα οποία θα σας βοηθήσουν να καταλάβετε τον παρακάτω κώδικα. Για αρχή, αντιγράψτε το στο αρχείο `blog/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Μετά, περιβάλλετε τον κώδικα HTML που προβάλει τα posts με κλάσεις. Αντικατάστησε αυτό:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+μέσα στο αρχείο `blog/templates/blog/post_list.html` με αυτό:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Αποθήκευσε τα αρχεία και ανανέωστε την ιστοσελίδα σας.
+
+![Σχήμα 14.4](images/final.png)
+
+Ουάου! Φαίνεται τέλειο, έτσι δεν είναι; Κοιτάξτε τον κώδικα που μόλις κάναμε επικόλληση για να βρείτε τα σημεία που προσθέσαμε κλάσεις στην HTML και τις χρησιμοποιήσαμε στο CSS. Που θα κάνατε την αλλαγή αν θέλατε την ημερομηνία να είναι τιρκουάζ;
+
+Μην φοβάστε να πειραματιστείτε με το CSS λίγο και να προσπαθήσετε να αλλάξετε μερικά πράγματα. Παίζοντας με το CSS μπορεί να σε κάνει να καταλάβεις τι κάνουν τα διάφορα πράγματα. Εάν κάτι πάει στραβά μην ανησυχείτε - μπορείτε πάντα να το αναιρέσετε!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Είστε έτοιμοι για το επόμενο κεφάλαιο; :)
\ No newline at end of file
diff --git a/el-GR/deploy/README.md b/el-GR/deploy/README.md
new file mode 100644
index 00000000000..b6b1194c7a1
--- /dev/null
+++ b/el-GR/deploy/README.md
@@ -0,0 +1,246 @@
+# Ανεβάστε!
+
+> **Σημείωση** Το ακόλουθο κεφάλαιο μπορεί να είναι μερικές φορές λίγο δύσκολο να ολοκληρωθεί. Επιμένετε και τελειώστε το, το ανέβασμα είναι ένα σημαντικό μέρος της διαδικασίας ανάπτυξης της ιστοσελίδας. Άλλωστε όταν αναπτύσετε ένα website θα θέλατε στο τέλος να το δει όλος ο κόσμος, όχι μόνο εσείς στον υπολογιστή σας. Το κεφάλαιο αυτό τοποθετείται στη μέση του οδηγού, έτσι ώστε ο μέντορας σας να μπορεί να σας βοηθήσει με την περίπλοκη διαδικασία του "ανεβάσματος" της ιστοσελίδας στο διαδίκτυο. Αυτό σημαίνει ότι μπορείτε ακόμη να ολοκληρώσετε τον οδηγό μόνοι σας ακόμα και αν σας τελειώσει ο χρόνος.
+
+Μέχρι τώρα, η ιστοσελίδα σου ήταν μόνο διαθέσιμη στον υπολογιστή σου. Τώρα θα μάθεις πως να την ανεβάσεις σε κάποιον server! "Ανεβάζω στο server" (ή άλλιώς deploy) είναι η διαδικασία της δημοσίευσης την εφαρμογής σας στο διαδίκτυο, έτσι ώστε οι άνθρωποι τελικά να πάνε και να δουν την εφαρμογή σας (μέσα από κάποιο url, πχ https://www.mypage. gr). :)
+
+Όπως μάθατε, μια ιστοσελίδα πρέπει να βρίσκεται σε ένα διακομιστή (server). Υπάρχουν εκατοντάδες υπηρεσίες διακομιστών (server providers) εκεί έξω. Εμείς θα χρησιμοποιήσουμε το [PythonAnywhere](https://www.pythonanywhere.com/). Το PythonAnywhere είναι δωρεάν για μικρές εφαρμογές που δεν έχουν πολλούς επισκέπτες, καθιστώντας το ιδανικό για την περίπτωση μας.
+
+Η άλλη υπηρεσία που θα χρησιμοποιήσουμε είναι το [GitHub](https://www.github.com), το οποίο είναι μια υπηρεσία φιλοξενίας κώδικα. Υπάρχουν και άλλες υπηρεσίες φιλοξενίας κώδικα εκεί έξω (όπως το BitBucket και άλλες), αλλά σχεδόν όλοι οι προγραμματιστές έχουν λογαριασμό GitHub αυτές τις μέρες όπως και εσείς τώρα!
+
+Αυτά τα τρία μέρη θα είναι σημαντικά για εσάς. Ο τοπικός σας υπολογιστής θα είναι το μέρος όπου θα κάνετε ανάπτυξη και δοκιμή. Όταν είστε ικανοποιημένοι με τις αλλαγές, θα τοποθετήσετε ένα αντίγραφο του προγράμματος σας στο GitHub. Η ιστοσελίδα σας θα είναι στο PythonAnywhere και θα την ενημερώσετε με το να πάρετε ένα καινούριο αντίγραφο του κωδικού σας από το GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Ξεκινώντας με το Git repo
+
+Το Git παρακολουθεί τις αλλαγές σε ένα συγκεκριμένο σύνολο αρχείων που αποκαλείται αρχείο αποθήκευσης κώδικα (ή «repo» εν συντομία, όπως είπαμε παραπάνω). Ας δημιουργήσουμε ένα για την εφαρμογή μας. Ανοίξτε την κονσόλα σας, μεταβείτε στον φάκελο`djangogirls` και εκτελέστε αυτές τις εντολές:
+
+> **Σημείωση** Ελέγξτε που βρίσκεστε στην κονσόλα (δηλαδή σε ποιον φάκελο) με την εντολή `pwd` (Mac OS X/Linux) ή `cd` (Windows) πριν αρχικοποιήσετε το repo σας. Θα πρέπει να βρίσκεστε στο φάκελο `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Η αρχικοποίηση του repo είναι κάτι που πρέπει να γίνεται μόνο μια φορά ανά project (δίχως να χρειάζεται να εισάγετε το όνομα χρήστη και το email σας, ποτέ ξανά).
+
+Το Git θα παρακολουθήσει τις αλλαγές σε όλα τα αρχεία και τους φακέλους σε αυτόν τον φάκελο (σε αυτό το project). Ωστόσο υπάρχουν ορισμένα αρχεία που θέλουμε να τα αγνοήσει και να μην συμπεριληφθούν στο repo. Το κάνουμε αυτό δημιουργώντας ένα αρχείο που ονομάζεται `.gitignore` στον αρχικό φάκελο. Ανοίξτε το πρόγραμμα επεξεργασίας κειμένου και δημιουργήστε ένα νέο αρχείο με το ακόλουθο περιεχόμενο:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+Αποθηκεύστε το ως `.gitignore` μέσα στον φάκελο "djangogirls".
+
+> **Σημείωση** Η τελεία στην αρχή του ονόματος του αρχείου είναι σημαντική! Αν έχετε κάποιο πρόβλημα στη δημιουργία του (στο Finder, για παράδειγμα, των Mac υπολογιστών, δεν αρέσει να δημιουργούνται αρχεία με την τελεία ως πρώτο χαρακτήρα), τότε χρησιμοποιήστε το "Αποθήκευση ως...". Σιγουρευτείτε, πάντως, να μην προσθέσετε `.txt`, `.py`, ή οποιοδήποτε άλλη κατάληξη στο όνομα του αρχείου. Θα αναγνωριστεί από το Git μόνο αν το όνομα του είναι ακριβώς `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Σημείωση** Ένα από τα ονόματα αρχείων που συμπεριλάβατε στο αρχείο `.gitignore` είναι το αρχείο `db.sqlite3`. Αυτό το αρχείο είναι μια τοπική βάση δεδομένων (database), όπου όλοι οι χρήστες και τα posts σας είναι αποθηκευμένα. Ακολουθούμε μια κοινή πρακτική όσον αφορά τον προγραμματισμό ιστού (web programming) η οποία απαιτεί την χρήση ξεχωριστής βάσης δεδομένων τοπικά στον υπολογιστή μας και στον server όπου θα ανεβάσουμε την εφαρμογή μας (PythonAnywhere). Η βάση δεδομένων του PythonAnywhere θα μπορούσε να είναι και αυτή SQLite, όπως στον υπολογιστή σας αλλά συχνά θα χρησιμοποιείτε μια πιο ευρέως διαδεδομένη και εμπλουτισμένη με πιο πολλά χαρακτηριστικά και δυνατότητες όπως η PostgresQL ή η MySQL. Όπως και να 'χει, μη συμπεριλαμβάνοντας την SQLite βάση στο repo, σημαίνει ότι όλα τα posts και οι χρήστες που δημιουργήσατε μέχρι τώρα θα είναι διαθέσιμα τοπικά στον υπολογιστή σας και θα χρειαστεί να τα ξαναδημιουργήσετε όταν ανεβάσετε το project σας. Να σκέφτεστε την τοπική βάση δεδομένων σας ως ένα παιδότοπο όπου μπορείτε να δοκιμάσετε διαφορετικά πράγματα και να μην φοβάστε ότι πρόκειται να διαγράψετε τις αληθινές σας δημοσιεύσεις από το blog σας.
+
+Είναι καλή ιδέα να χρησιμοποιήσετε την εντολή `git status` πριν από την εντολή`git add` ή όποτε δεν είστε βέβαιοι για το τι έχει αλλάξει. Αυτό θα βοηθήσει να αποτραπούν οποιεσδήποτε εκπλήξεις, όπως το να προστεθούν ή να αποθηκευτούν λανθασμένα αρχεία. Η εντολή `git status` επιστρέφει πληροφορίες σχετικά με το ποια αρχεία είναι untracked/modified/staged files, το status του branch και πολλές ακόμη πληροφορίες. Η έξοδος πρέπει να είναι παρόμοια με τα ακόλουθα:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Και τέλος αποθηκεύουμε τις αλλαγές μας. Πηγαίνετε στην κονσόλα σας και εκτελέστε αυτές τις εντολές:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Ανεβάζοντας τον κώδικα σας στο GitHub
+
+Πηγαίνετε στο [https://github.com](https://www.github.com) και δημιουργήστε έναν δωρεάν λογαριασμό. (Αν το έχετε ήδη κάνει αυτό, τέλεια!). Σιγουρευτείτε ότι θυμάστε τον κωδικό πρόσβασης σας (προσθέστε τον σε κάποιον διαχειριστή κωδικών πρόσβασης, αν έχετε κάποιον).
+
+Έπειτα, δημιουργήστε ένα νέο repo, δίνοντας του το όνομα "my-first-blog". Αφήστε το κουτάκι "initialize with a README" κενό. Αφήστε, επίσης την επιλογή .gitignore κενή (το έχουμε ήδη αυτό το αρχείο) και τέλος αφήστε το License ως None.
+
+![](images/new_github_repo.png)
+
+> **Σημείωση** Το όνομα `my-first-blog` είναι σημαντικό. Θα μπορούσατε να διαλέξετε ένα άλλο, αλλά επειδή θα το χρησιμοποιείτε αρκετά στις ακόλουθες εντολές, καλό να είναι χρησιμοποιήσετε το ίδιο εκτός και αν είστε λάτρης του πληκτρολογίου και σας αρέσει να γράφετε! Είναι πιο εύκολο να μείνετε με το όνομα `my-first-blog`.
+
+Στην επόμενη οθόνη θα δείτε το url (την διεύθυνση) του repo σας την οποία θα χρησιμοποιήσουμε παρακάτω:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Τώρα το μόνο που μένει είναι να συνδέσουμε το τοπικό repo μας με το remote (απομακρυσμένο).
+
+Πληκτρολογήστε τα ακόλουθα στην κονσόλα σας (αντικαταστήστε το `<your-github-username>` με το όνομα χρήστη σας στο GitHub αλλά χωρίς τα "<>". Το url θα πρέπει να είναι το ίδιο με το url που είδατε πριν:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Όταν ανεβάζετε στο GitHub, θα ερωτηθείτε για το όνομα χρήστη και τον κωδικό πρόσβασης σας (είτε μέσω κονσόλας είτε μέσω ενός χωριστού παράθυρου). Αφού τα εισάγετε, θα δείτε κάτι σαν το παρακάτω:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Ο κώδικας σας είναι πλέον στο GitHub. Πηγαίνετε να τον δείτε! Θα διαπιστώσετε ότι και άλλο δημοφιλή ανοιχτού λογισμικού projects φιλοξενούνται στο GitHub, όπως το ίδιο το [Django](https://github.com/django/django), το [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial) και άλλα πολλά. :)
+
+# Ανεβάζοντας το blog μας στο PythonAnywhere
+
+## Δημιουργήστε έναν δωρεάν λογαριασμό στο PythonAnywhere
+
+> **Σημείωση** Αν έχετε δημιουργήσει ήδη έναν τότε παραλείψτε αυτό το βήμα.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Παραμετροποιώντας το site μας στο PythonAnywhere
+
+Μεταβείτε πίσω στο [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) κλικάροντας στο logo και επιλέξτε να εκκινήσετε μια κονσόλα "Bash". Αυτή είναι η έκδοση της κονσόλας του PythonAnywhere σαν και αυτή που έχετε στον υπολογιστή σας.
+
+![Η ενότητα 'New Console' στο PythonAnywhere με ένα κουμπί για το 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Σημείωση** Το PythonAnywhere είναι βασισμένο στο Linux, οπότε αν τρέχετε Windows, η κονσόλα ίσως να σας φανεί διαφορετική από αυτή που έχετε συνηθίσει.
+
+Η διαδικασία του ανεβάσματος της εφαρμογή σας (το blog) στο PythonAnywhere περιλαμβάνει τα εξής βήματα: το PythonAnywhere να μπορεί να "διαβάσει" τον κώδικα σας στο GitHub, να τον "κατεβάσει" και να τον αποθηκεύσει σε κάποιον από τους σκληρούς του δίσκους (pull) και στο τέλος να κάνει serve την εφαρμογή αυτή. Υπάρχουν οι χειροκίνητοι τρόποι για να επιτευχθούν αυτά τα βήματα αλλά το PythonAnywhere προσφέρει εργαλεία για αυτόν ακριβώς το λόγο. Ας το εγκαταστήσουμε πρώτα:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+Αυτό θα εμφανίσει κάτι σαν `Collecting pythonanywhere` και στο τέλος θα τελειώσει με μια γραμμή η οποία θα λέει `Successfully installed (...) pythonanywhere- (...)`.
+
+Τώρα θα τρέξουμε το βοηθητικό εργαλείο ούτως ώστε να παραμετροποιήσει την εφαρμογή μας από το GitHub. Πληκτρολογήστε τα ακόλουθα στην κονσόλα του PythonAnywhere (μην ξεχάσετε να χρησιμοποιήσετε αντί του `<your-github-username>` το όνομα χρήστη σας του GitHub ούτως ώστε τα urls να είναι τα ίδια):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+Μπορείτε να βλέπετε τι γίνεται καθώς το πρόγραμμα τρέχει:
+
+- Κατεβάζει τον κώδικα σας από το GitHub
+- Δημιουργεί ένα virtualenv στο PythonAnywhere όπως ακριβώς αυτό στον υπολογιστή σας
+- Εμπλουτίζει το αρχείο settings.py με κάποιες ρυθμίσεις για το deployment
+- Ρυθμίζει τη βάση δεδομένων στο PythonAnywhere χρησιμοποιώντας την εντολή `manage.py migrate`
+- Ρυθμίζει τα στατικά αρχεία (θα μάθουμε γι'αυτά αργότερα)
+- Τέλος ρυθμίζει το PythonAnywhere για να εξυπηρετήσει την εφαρμογή σας
+
+Παρόλο που στο PythonAnywhere όλα αυτά τα βήματα είναι αυτοματοποιημένα, όλα αυτά δεν αλλάζουν αν επιλέξετε κάποιον άλλον server provider.
+
+Αυτό που πρέπει να τονίσουμε είναι ότι η βάση δεδομένων στο PythonAnywhere είναι διαφορετική από αυτήν στον υπολογιστή σας. Ως αποτέλεσμα αυτού, θα χρειαστεί να αρχικοποιήσουμε τον λογαριασμό διαχειριστή με την εντολή `createsuperuser`. Το PythonAnywhere έχει ενεργοποιήσει το virtualenv για σας, οπότε το μόνο που μένει είναι να τρέξουμε:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Εισάγετε τα στοιχεία του χρήστη admin. Καλό είναι να χρησιμοποιήσετε τα ίδια με αυτά στον τοπικό υπολογιστή σας για να μην μπερδεύεστε εκτός και αν θέλετε να κάνετε να φτιάξετε ένα πιο ρεαλιστικό σενάριο όπου ο κωδικός αυτός θα πρέπει να είναι πιο δύσκολος ως προς την μαντεψιά.
+
+Τώρα, αν θέλετε, μπορείτε να δείτε τον κώδικα σας στο PythonAnywhere δίνοντας την εντολή `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+Μπορείτε, επίσης, να μεταβείτε στη σελίδα "Files" και απο κει να περιηγηθείτε χρησιμοποιώντας τον browser του PythonAnywhere. (Από την σελίδα Console, μπορείτε να μεταβείτε στις άλλες σελίδες του PythonAnywhere από το κουμπί menu στην πάνω δεξιά γωνία. Μόλις είστε σε μία από τις σελίδες, υπάρχουν συνδέσεις με τις άλλες πάνω στην κορυφή.)
+
+## Τώρα είστε ζωντανά!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Σημείωση** Αυτός είναι ένας οδηγός για αρχάριους και κατά τη διάρκεια του deploying παρακάμψαμε κάποια βήματα τα οποία είναι πολύ σημαντικά από άποψη ασφάλειας. Αν και όταν θελήσετε να εμπλουτίσετε ή να φτιάξετε ένα νέο project, καλό θα ήταν να συμβουλευτείτε το [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) για μερικές συμβουλές ασφάλειας.
+
+## Συμβουλές debugging
+
+Αν λάβετε κάποιο σφάλμα καθώς τρέχετε το script `pa_autoconfigure_django.py`, δείτε τα ακόλουθα:
+
+- Έχετε ξεχάσει να δημιουργήσετε ένα PythonAnywhere API token.
+- Έχετε κάνει λάθος στο GitHub URL
+- Αν δείτε ένα σφάλμα που λέει *«Could not find your settings.py»*, είναι πιθανώς επειδή δεν συμπεριλάβατε όλα τα αρχεία σας στο repo ή/και δεν έχετε κάνει push τις αλλαγές σας στο GitHub επιτυχώς. Δείτε ξανά την ενότητα Git παραπάνω
+- Αν προηγουμένως έχετε εγγραφεί για λογαριασμό PythonAnywhere και έχετε παρουσιάσει σφάλμα στο collectstatic, πιθανόν να έχετε μια παλαιότερη έκδοση του SQLite (π. χ. 3.8.2) στο λογαριασμό σας. Σε αυτή την περίπτωση, εγγραφείτε με νέο λογαριασμό και δοκιμάστε τις εντολές στην ενότητα PythonAnywhere παραπάνω.
+
+Αν δείτε ένα σφάλμα όταν προσπαθείτε να επισκεφθείτε την ιστοσελίδα σας, το πρώτο μέρος για debbuging είναι το αρχείο **error log**. Θα βρείτε ένα σύνδεσμο για το error log στο ["Web" page](https://www.pythonanywhere.com/web_app_setup/) του PythonAnywhere. Δείτε εάν υπάρχουν μηνύματα σφάλματος εκεί. Τα πιο πρόσφατα είναι στο κάτω μέρος.
+
+Υπάρχουν επίσης ορισμένες [γενικές συμβουλές εντοπισμού σφαλμάτων στο PythonAnywhere](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+Και θυμηθείτε, ο εκπαιδευτής σας είναι είδω να σας βοηθήσει!
+
+# Δείτε το site σας!
+
+Η αρχική σελίδα του site σας θα λέει "Δούλεψε", όπως ακριβώς εμφανίστηκε στον υπολογιστή σας. Μεταβείτε στη διαχειριστική σελίδα προσθέτοντας το `/admin/` στο τέλος του URL. Κάντε login χρησιμοποιώντας το όνομα χρήστη και τον κωδικό σας και θα δείτε την γνώριμη σελίδα που σας επιτρέπει να προσθέστε χρήστες, posts και άλλα. Θημηθείτε, ο λόγος που δεν βλέπετε τα posts σας είναι διότι η βάση δεδομένων στο PythonAnywhere είναι "κενή" από αυτή του τοπικού υπολογιστή σας.
+
+Μόλις δημιουργήσετε μερικά posts, πηγαίνετε πάλι στην αρχική σελίδα του site σας. Από αυτό εδώ το σημείο και ύστερα θα πρέπει να εργάζεστε πρώτα τοπικά στον υπολογιστή σας για τυχόν αλλαγές και μετά να τις ανεβάζετε στον server. Αυτό είναι μια κοινή καλή πρακτική. Όταν λέμε αλλαγές, δεν εννοούμε προσθήκη posts, users κλπ αλλά αλλαγές στον κώδικα. Αυτό επιτρέπει να εργάζεστε και να πειραματίζεστε τοπικά δίχως να χαλάσετε κάτι στο site σας που είναι στον αέρα. Πολύ καλό, εε;
+
+Πείτε στον εαυτό σας ένα *ΜΕΓΑΛΟ* "ΣΥΓΧΑΡΗΤΗΡΙΑ"! Το ανέβασμα σε κάποιον server αποτελεί ένα από τα δυσκολότερα βήματα του web development και συνήθως παίρνει αρκετές μέρες για να επιτευχθεί. Όμως εσείς έχετε το site σας live, στο internet!
\ No newline at end of file
diff --git a/el-GR/deploy/install_git.md b/el-GR/deploy/install_git.md
new file mode 100644
index 00000000000..faf291c6030
--- /dev/null
+++ b/el-GR/deploy/install_git.md
@@ -0,0 +1,52 @@
+Το Git είναι ένα «σύστημα ελέγχου έκδοσης» και χρησιμοποιείται από πολλούς προγραμματιστές. Αυτό το εργαλείο μπορεί να παρακολουθήσει τις αλλαγές στα αρχεία με την πάροδο του χρόνου έτσι ώστε να μπορείτε να ανακαλέσετε συγκεκριμένες εκδόσεις σε μεταγενέστερο στάδιο. Είναι κάπως σαν την δυνατότητα "παρακολούθηση αλλαγών" σε προγράμματα επεξεργασίας κειμένου (όπως το Microsoft Word ή το LibreOffice Writer) αλλά πολύ πιο δυνατό.
+
+## Εγκαθιστώντας το Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Μπορείτε να κατεβάσετε το Git από το [git-scm.com](https://git-scm.com/). Μπορείτε να πατάτε "επόμενο" σε όλα τα στάδια εκτός από δύο: στο στάδιο που ρωτάει για τον προτιμώμενο επεξεργαστή κειμένου θα πρέπει να επιλέξετε το Nano και στο στάδιο με το όνομα "Adjusting your PATH environment", θα πρέπει να επιλέξετε το "Use Git and optional Unix tools from the Windows Command Prompt" (την τελευταία επιλογή). Εκτός από αυτό, οι προκαθορισμένες ρυθμίσεις είναι μια χαρά. Επίσης, οι επιλογές Checkout Windows-style και Commit Unix-style είναι μια χαρά.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Κατεβάστε το Git από το [git-scm.com](https://git-scm.com/) και ακολουθήστε τις οδηγίες.
+
+> **Σημείωση** Αν έχετε OS X 10.6, 10.7, ή 10.8, θα χρειαστεί να εγκαταστήσετε την έκδοση του git από εδώ: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/el-GR/deploy/signup_pythonanywhere.md b/el-GR/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..1cbb413340e
--- /dev/null
+++ b/el-GR/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+Το PythonAnywhere είναι μια υπηρεσία για την εκτέλεση Python κώδικα σε διακομιστές «στο σύννεφο» (cloud). Θα το χρησιμοποιήσουμε για τη φιλοξενία του site μας στο internet.
+
+Θα φιλοξενήσουμε το blog που χτίσαμε στο PythonAnywhere. Δημιουργήστε έναν "Beginner" λογαριασμό (δεν χρειάζεστε πιστωτική κάρτα).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![H σελίδα εγγραφής του PythonAnywhere δείχνει ένα κουμπί για να δημιουργήσετε έναν δωρεάν «Beginner» λογαριασμό - λογαριασμό αρχάριων](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Σημείωση** Όταν επιλέξετε όνομα χρήστη θυμηθείτε ότι τα urls του blog σας θα έχουν τη μορφή `yourusername.pythonanywhere.com`. Οπότε επιλέξτε είτε το συνηθισμένο σας όνομα χρήστη (πχ αυτό που βάλατε στο GitHub) είτε κάποιο που να ταιριάζει με τη θεματολογία του blog σας. Επίσης, σιγουρευτείτε ότι θα θυμάστε τον κωδικό πρόσβασης σας.
+
+## Δημιουργώντας ένα PythonAnywhere API token
+
+Αυτό είναι κάτι που πρέπει να κάνετε μόνο μια φορά. Μετά την εγραφή σας στο  PythonAnywhere θα μεταφερθείτε στο ταμπλό σας. Βρείτε το σύνδεσμο "Λογαριασμός" πάνω δεξιά στη σελίδα σας:
+
+![Σύνδεσμος λογαριασμού πάνω δεξιά στη σελίδα](../deploy/images/pythonanywhere_account.png)
+
+στη συνέχεια επιλέξτε την καρτέλα που ονομάζεται "API Token" και πατήστε το κουμπί που λεει "Δημιουργία νέου  API Token".
+
+![Η καρτέλα "API Token" στη σελίδα λογαριασμού](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/el-GR/django/README.md b/el-GR/django/README.md
new file mode 100644
index 00000000000..c615f899a96
--- /dev/null
+++ b/el-GR/django/README.md
@@ -0,0 +1,27 @@
+# Τι είναι το Django;
+
+Το Django (*goh/ˈdʒæŋɡoʊ/jang-goh*) είναι ένα δωρεάν και ανοικτού κώδικα web framework γραμμένο σε Python. Ένα web framework είναι ένα σύνολο από στοιχεία που σας βοηθά να αναπτύξετε ιστοσελίδες πιο γρήγορα και εύκολα.
+
+Όταν κατασκευάζετε μία ιστοσελίδα, χρειάζεστε πάντα ένα παρόμοιο σύνολο στοιχείων: έναν τρόπο για να χειρίζεστε τον έλεγχο ταυτότητας χρήστη (εγγραφή, σύνδεση, αποσύνδεση), ένα πάνελ διαχείρισης για την ιστοσελίδα σας, φόρμες, έναν τρόπο για να ανεβάσετε αρχεία κλπ.
+
+Ευτυχώς για εσάς, άλλα άτομα πριν από αρκετό καιρό παρατήρησαν ότι οι προγραμματιστές ιστού αντιμετωπίζουν παρόμοια προβλήματα κατά τη δημιουργία ενός νέου ιστοτόπου και έτσι συνεργάστηκαν και δημιούργησαν τα frameworks (το Django είναι ένα από αυτά) που σας δίνουν έτοιμα συστατικά που μπορείτε να χρησιμοποιήσετε.
+
+Τα πλαίσια υπάρχουν για να μην χρειάζεται να "επανεφεύρετε τον τροχό" και να σας ελαφρύνουν από αρκετές εργασίες κατά την διάρκεια της κατασκευής μίας νέας ιστοσελίδας.
+
+## Γιατί χρειάζεστε ένα framework;
+
+Για να καταλάβουμε τι είναι πραγματικά το Django, πρέπει να ρίξουμε μία πιο προσεκτική ματιά στους διακομιστές (servers). Το πρώτο πράγμα είναι ότι ο διακομιστής θα πρέπει να ξέρει τι θέλετε να εξυπηρετήσει σε μια ιστοσελίδα.
+
+Φανταστείτε ένα γραμματοκιβώτιο (θύρα), το οποίο παρακολουθείται για εισερχόμενα γράμματα (αιτήματα). Αυτό γίνεται από έναν διακομιστή διαδικτύου (web server). Ο διακομιστής διαδικτύου διαβάζει το γράμμα και αποκρίνεται με μια ιστοσελίδα. Αλλά όταν θέλετε να στείλετε κάτι, πρέπει να έχει και κάποιο περιεχόμενο. Και το Django είναι κάτι που σας βοηθάει να δημιουργήσετε αυτό το περιεχόμενο.
+
+## Τι συμβαίνει όταν κάποιος ζητά μια ιστοσελίδα από το διακομιστή σας;
+
+Όταν ένα αίτημα φτάσει σε ένα διακομιστή δικτύου, περνάει στο Django το οποίο προσπαθεί να καταλάβει τι ζητάει αυτό το αίτημα στην ουσία. Λαμβάνει πρώτα μια διεύθυνση σελίδας δικτύου και προσπαθεί να καταλάβει τι να κάνει. Αυτό το κομμάτι γίνεται από τον **urlresolver** του Django (σημειώστε ότι η διεύθυνση ενός ιστότοπου ονομάζεται URL - Uniform Resource Locator - και έτσι το όνομα *urlresolver* βγάζει νόημα). Παρόλαυτα δεν είναι πολύ έξυπνο. Παίρνει μια λίστα από μοτίβα και προσπαθεί να ταιριάξει την διεύθυνση URL. Το Django ελέγχει τα μοτίβα από πάνω προς τα κάτω και αν κάτι ταιριάζει, μεταβιβάζει το αίτημα στην σχετική λειτουργία (η οποία ονομάζεται *view*).
+
+Φανταστείτε έναν ταχυδρόμο με ένα γράμμα. Περπατάει στην οδό και ελέγχει κάθε αριθμό σπιτιού αν είναι ίδιος με τον αντίστοιχο αριθμό στο γράμμα. Αν ταιριάζει, βάζει το γράμμα εκεί. Αυτός είναι ο τρόπος που λειτουργεί ο urlresolver!
+
+Στο *view*, γίνονται όλα τα ενδιαφέροντα πράγματα: μπορούμε να δούμε μια βάση δεδομένων για να ψάξουμε για μερικές πληροφορίες. Μήπως ο χρήστης ζήτησε να αλλάξει κάτι στα δεδομένα; Όπως ένα γράμμα που λέει "Παρακαλώ, αλλάξτε την περιγραφή της δουλειάς μου.» Το *view* μπορεί να ελέγξει αν επιτρέπεται να το κάνετε αυτό και στη συνέχεια ενημερώνει την περιγραφή της δουλειάς σας και στείλνει πίσω ένα μήνυμα: "Έγινε!". Έπειτα το *view* παράγει ένα response και το Django το στέλνει πίσω στον web browser του χρήστη και προβάλεται στην οθόνη.
+
+Φυσικά, η παραπάνω περιγραφή είναι λίγο απλοποιημένη, αλλά δεν χρειάζεται να γνωρίζετε όλα τα τεχνικά ζητήματα ακόμη. Μια γενική ιδέα είναι αρκετή.
+
+Έτσι αντί να αφιερώνουμε πάρα πολύ χρόνο σε λεπτομέρειες, θα ξεκινήσουμε απλά δημιουργώντας κάτι με το Django και θα μάθουμε όλα τα σημαντικά κομμάτια καθοδόν!
\ No newline at end of file
diff --git a/el-GR/django_admin/README.md b/el-GR/django_admin/README.md
new file mode 100644
index 00000000000..587f82fca01
--- /dev/null
+++ b/el-GR/django_admin/README.md
@@ -0,0 +1,57 @@
+# Διαχείριση μέσω Django admin
+
+Για να προσθέσουμε, επεξεργαστούμε και να διαγράψουμε τις δημοσιεύσεις που έχουμε αναρτήσει, θα χρησιμοποιήσουμε την εφαρμογή Django admin.
+
+Ας ανοίξουμε το αρχείο `blog/admin.py` μέσα σε έναν code editor και ας αντικαταστήσουμε τα περιεχόμενα του με τα ακόλουθα:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Με τον παραπάνω κώδικα, εισάγουμε το μοντέλο Post (δηλαδή τον πίνακα της βάσης δεδομένων με το όνομα Post) όπως ορίστηκε από το προηγούμενο κεφάλαιο. Για να κάνουμε το μοντέλο μας ορατό στην σελίδα διαχείρισης θα πρέπει να το "εγγράψουμε" (να το κάνουμε register) με την συνάρτηση `admin.site.register(Post)`.
+
+Εντάξει λοιπόν, ας ρίξουμε μια ματιά στο Post μοντέλο μας. Θυμηθείτε ότι πρέπει πρώτα να πληκτρολογήσουμε `python manage.py runserver` στην κονσόλα μας ώστε να ξεκινήσει ο development server. Πηγαίνετε στον browser και πληκτρολογήστε http://127.0.0.1:8000/admin/. Θα δείτε μία σελίδα σύνδεσης όπως αυτή:
+
+![Login page](images/login_page2.png)
+
+Για να συνδεθείτε, χρειάζεται να δημιουργήσετε έναν *superuser*, δηλαδή έναν χρήστη ο οποίος θα έχει δικαιώματα σε οτιδήποτε σε αυτή την σελίδα. Πηγαίνετε πίσω στην γραμμή εντολών, πατήστε Ctrl + c για να σταματήσετε τον development server Που ήδη τρέχει, πληκτρολογήστε `python manage.py createsuperuser` και πατήστε enter.
+
+> Θυμηθείτε, για να γράψετε νέες εντολές ενώ ο server εκτελείται, ανοίξτε μια νέα κονσόλα και ενεργοποιήστε το virtualenv. Είδαμε πως να γράφετε νέες εντολές μέσα στο κεφάλαιο **Το πρώτο σας Django project!**, στην ενότητα **Ξεκινώντας τον web server**.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Όταν σας ζητηθεί, πληκτρολογήστε το όνομα χρήστη σας (πεζά, δίχως κενά), το email σας και ένα password. **Μην ανησυχείτε όταν πληκτρολογείτε τον κωδικό σας και δεν βλέπετε κάτι στην οθόνη. Έτσι πρέπει να είναι.** Πληκτρολογήστε τον και μετά πατήστε `enter` για να συνεχίσετε. Η απόκριση από το τερματικό θα μοιάζει κάπως έτσι (όπου "όνομα χρήστη" και "email" θα είναι τα δικά σας):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Αν ο server δεν τρέχει κάντε το τώρα: <0>python manage.py runserver</0>. Μετά, επιστρέψτε στον browser σας. Κάντε login και εισάγετε το όνομα χρήστη και τον κωδικό σας. Θα πρέπει να δείτε, επιτέλους, την κεντρική σελίδα διαχείρισης του Django.
+
+![Django admin](images/django_admin3.png)
+
+Πηγαίνετε στα Posts και πειραματιστείτε με αυτά. Προσθέστε πέντε ή έξι posts. Μην ανησυχείτε για το περιεχόμενο των posts. Είναι μονάχα ορατό σε εσάς, στον υπολογιστή σας. Μπορείτε να κάνετε αντιγραφή-επικόλληση κείμενο από αυτόν εδώ τον οδηγό για να γλυτώσετε χρόνο. :)
+
+Σιγουρευτείτε ότι δύο ή τρία posts (αλλά όχι όλα) έχουν συμπληρώσει το πεδίο "publish date". Θα μας βοηθήσει αυτό αργότερα.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Αυτή είναι μάλλον μια καλή στιγμή να πιείτε μια γουλιά καφέ (ή τσάι) ή κάτι να φάτε για να γεμίσετε ενέργεια. Μόλις δημιουργήσατε το πρώτο σας Django model. Αξίζετε ένα μικρό διάλλειμα!
\ No newline at end of file
diff --git a/el-GR/django_forms/README.md b/el-GR/django_forms/README.md
new file mode 100644
index 00000000000..a2127c1305c
--- /dev/null
+++ b/el-GR/django_forms/README.md
@@ -0,0 +1,479 @@
+# Φόρμες Django
+
+Το τελευταίο που έμεινε για την ιστοσελίδα μας είναι να δημιουργήσουμε μια όμορφη φόρμα για την εισαγαγωγή και τροποποίηση των post μας. Θα μπορούσαμε να χρησιμοποιήσουμε το Django `admin` αλλά είναι αρκετά πολύπλοκο να τροποποιήσουμε και να κάνουμε όμορφη τη φόρμα εισαγωγής εκεί. Με τις `φόρμες` έχουμε τον πλήρη έλεγχο στο περιβάλλον του χρήστη. Μπορούμε να κάνουμε ότι μπορούμε να φανταστούμε!
+
+Μία από τις ευκολίες των Django φορμών είναι ότι μπορούμε να ξεκινήσουμε από το μήδεν ή να χρησιμοποιήσουμε το `ModelForm` που ουσιαστικά αποθηκεύει τα δεδομένα της φόρμας στο μοντέλο (ή διαφορετικά στο σωστό πίνακα της βάσης μας).
+
+Αυτό είναι ακριβώς που θέλουμε να κάνουμε: δηλαδή να δημιουργήσουμε εύκολα μια φόρμα εισαγωγής δεδομένων για το ήδη υπάρχων `Post` μοντέλο.
+
+Οπώς κάθε άλλο σημαντικό τμήμα του Django, οι φόρμες εισαγωγής "ζούν" στο δικό τους αρχείο: `forms.py`.
+
+Πρέπει να δημιουργήσουμε το αρχείο forms.py μέσα στο φάκελο `blog`.
+
+    blog
+       └── forms.py
+    
+
+Ωραία. Ας ανοίξουμε τον επεξεργαστή κώδικα και ας γράψουμε τον ακόλουθο κώδικα:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Θα χρειαστεί να κάνουμε import τις Django forms πρώτα (`from django import forms`) καθώς και το μοντέλο μας `Post` (`from .models import Post`).
+
+Οπώς πιθανόν να υποψιάζεστε το `PostForm`, είναι το όνομα της φόρμας εισαγωγής. Θα χρειαστεί να πούμε στο Django ότι αυτή η φόρμα είναι μια `ModelForm` (ούτως ώστε το Django να κάνει τα "μαγικά" του για εμάς). Η κλάση `forms.ModelForm` είναι υπεύθυνη γι'αυτό.
+
+Στην συνέχεια, έχουμε `class Meta`, όπου "λέμε" στο Django για ποιο μοντέλο πρέπει να δημιουργήσει την φόρμα εισαγωγής δεδομένων (`model = Post`).
+
+Τέλος, πρέπει να ορίσουμε ποιο/α πεδίο/α πρέπει να διαθέσουμε στην φόρμα μας. Σε αυτό το σενάριο θέλουμε μόνο το `title` και το `text` να εμφανίζονται. Το `author` θα πρέπει να είναι το πρόσωπο που είναι συνδεδεμένο εκείνη τη στιγμή (εσείς!) και το `created_date` θα παράγεται αυτόματα όταν δημιουργούμε ένα post (πχ μέσω κώδικα), σωστά;
+
+Αυτό ήταν! Αυτό που μας απομένει είναι να χρησιμοποιήσουμε την φόρμα μας μέσα σε ένα *view* ώστε να είναι διαθεσίμη μέσω ενός template.
+
+Οπότε, για ακόμα μια φορά, θα χρειαστεί να συνδέσουμε τη σελίδα με ένα url, ένα view και ένα template.
+
+## Πως συνδέουμε μια σελίδα με την φόρμα μας
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* Πρέπει να εμφανίσουμε τη φόρμα. Μπορούμε να το κάνουμε αυτό (για παράδειγμα) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Χρειαζόμαστε ένα κουμπί `Αποθήκευση`. Το κάνουμε αυτό με ένα κουμπί HTML: `<button type="submit">Αποθήκευση</button>`.
+* Και στο τέλος, ακριβώς μετά το tag `<form ...>` πρέπει να προσθέσουμε {% raw %}`{% csrf_token %}`{% endraw %}. Αυτό είναι πολύ σημαντικό, αφού καθιστά τις φόρμες σας ασφαλείς! Εάν ξεχάσετε αυτό το κομμάτι, το Django θα παραπονεθεί όταν προσπαθήσετε να αποθηκεύσετε τη φόρμα:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Αποθηκεύοντας τη φόρμα
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Επεξεργασία φόρμας
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Ασφάλεια
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Ένα πράγμα ακόμα: ώρα να το ανεβάσετε!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* Πρώτα κάντε commit τον νέο σας κώδικα και έπειτα push στο GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Έπειτα, στην [κονσόλα Bash του PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Τέλος, επισκεφτείτε τη σελίδα σας ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (χρησιμοποιήστε το κουμπί του menu στην πάνω δεξιά γωνία της κονσόλας) και κλικάρετε **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/el-GR/django_installation/README.md b/el-GR/django_installation/README.md
new file mode 100644
index 00000000000..43e94971103
--- /dev/null
+++ b/el-GR/django_installation/README.md
@@ -0,0 +1,7 @@
+# Εγκατάσταση του Django
+
+> **Σημείωση** Αν χρησιμοποιείτε ένα Chromebook, παραλείψτε αυτό το κεφάλαιο και σιγουρευτείτε ότι ακουλουθείτε τις [Chromebook Setup](../chromebook_setup/README.md) οδηγίες.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/el-GR/django_installation/instructions.md b/el-GR/django_installation/instructions.md
new file mode 100644
index 00000000000..9b8893494fe
--- /dev/null
+++ b/el-GR/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Μέρος αυτής της ενότητας βασίζεται στους οδηγούς των Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Μέρος αυτής της ενότητας βασίζεται στον οδηγό [django-marcador](http://django-marcador.keimlink.de/) υπό την άδεια χρήσης Creative Commons Attribution-ShareAlike 4.0 International License. Τα πνευματικά δικαιώματα του οδηγού django-marcador ανήκουν στον Markus Zapke-Gründemann.
+
+## Εικονικό περιβάλλον
+
+Πριν την εγκατάσταση του Django, θα εγκαταστήσουμε ενα εξαιρετικά χρήσιμο εργαλείο για να κρατήσουμε το περιβάλλον του υπολογιστή σας τακτοποιημένο και καθαρό. Μπορείτε να παραβλέψετε αυτό το βήμα, αλλά προτείνουμε να το ακολουθήσετε καθώς αν δεν το ακολουθήσετε υπάρχει σοβαρή πιθανότητα να προκύψουν σφάλματα αργότερα. Ξεκινώντας με την καλύτερη δυνατή εγκατάσταση, θα αποφύγετε πολλά προβλήματα στο μέλλον!
+
+Ας δημιουργήσουμε λοιπόν ενα **εικονικό περιβάλλον** (το αποκαλούμενο *virtualenv*). Το virtualenv θα απομονώσει την κάθε εγκατάσταση Python/Django ανά έργο (project). Αυτό σημαίνει ότι οι αλλαγές που κάνετε σε μια ιστοσελίδα (έργο - project) δεν θα επηρεάζουν οποιεσδήποτε άλλες ιστοσελίδες που αναπτύσσετε παράλληλα. Κάθε ιστοσελίδα θα έχει τα δικά της πακέτα και κάθε πακέτο την δική του έκδοση (version). Καλό, ε;
+
+Το μόνο που χρειάζεται να κάνετε είναι να βρείτε έναν φάκελο στον οποίο θέλετε να δημιουργήσετε το `virtualenv`. Για παράδειγμα, το home directory σας. Στα Windows, θα μοιάζει κάπως έτσι `C:\Users\Name` ( όπου `Name` είναι το όνομα της σύνδεσης σας).
+
+> **ΣΗΜΕΙΩΣΗ:** Στα Windows, σιγουρευτείτε ότι αυτός ο κατάλογος δεν περιέχει χαρακτήρες που τονίζονται ή ειδικούς χαρακτήρες. Αν το όνομα χρήστη σας περιέχει χαρακτήρες που τονίζονται, χρησιμοποιείστε ένα διαφορετικό φάκελο, για παράδειγμα `C:\djangogirls`.
+
+Για αυτό το tutorial θα χρησιμοποιήσουμε ένα νεο φάκελο `djangogirls` από το home directory σας:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Θα δημιουργήσουμε ένα virtualenv με το όνομα `myvenv`. Η γενική εντολή είναι:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Για την δημιουργία ενός νέου `virtualenv`, θα χρειαστεί να ανοίξετε την γραμμή εντολών στον υπολογιστή σας (κονσόλα) και να τρέξετε την εντολή `python -m venv myvenv`. Θα μοιάζει κάπως έτσι:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Όπου `myvenv` είναι το όνομα του `virtualenv` σας. Μπορείτε να χρησιμοποιήσετε οποιοδήποτε άλλο όνομα, αλλά πρέπει να είναι αγγλικοί χαρακτήρες, πεζά, χωρίς κενά, εμφάσεις ή άλλους ειδικούς χαρακτήρες. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Μπορούμε να δημιουργήσουμε ένα `virtualenv` σε Linux και σε OS X τρέχοντας την εντολή `python3 -m venv myvenv`. Θα μοιάζει κάπως έτσι:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+Το `myvenv` είναι το όνομα του `virtualenv` σας. Μπορείτε να χρησιμοποιήσετε οποιοδήποτε άλλο όνομα, αλλα πρέπει να είναι αγγλικοί χαρακτήρες, πεζά, χωρίς κενά και χωρίς άλλους ειδικούς χαρακτήρες. Είναι επίσης καλή ιδέα να κρατήσετε το όνομα μικρό - θα το αναφέρετε συχνά!
+
+> **ΣΗΜΕΙΩΣΗ:** Σε μερικές εκδόσεις των Debian/Ubuntu ίσως εμφανιστεί το ακόλουθο σφάλμα:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  Στα λειτουργικά συστήματα Debian/Ubuntu, θα χρειαστεί να εγκαταστήσετε το πακέτο python3-venv χρησιμοποιώντας την ακόλουθη εντολή.
+>        apt install python3-venv
+>     Ίσως χρειαστεί να χρηιμοποιήσετε sudo με αυτή την εντολή.  Αφού εγκατασταθεί επιτυχώς το πακέτο python3-venv, επαναδημιουργήστε το εικονικό σας περιβάλλον.
+>     
+> 
+> Σε αυτή την περίπτωση, ακολουθήστε τις οδηγίες παραπάνω και εγκαταστήστε το πακέτο `python3-venv`: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **ΣΗΜΕΙΩΣΗ:** Σε μερικές εκδόσεις των Debian/Ubuntu η ενεργοποίηση του virtual environment με αυτόν τον τρόπο, παράγει το ακόλουθο σφάλμα:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Για την επίλυση του χρησιμοποιήστε την εντολή `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **ΣΗΜΕΙΩΣΗ:** Αν λάβετε κάποιο σφάλμα όπως
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> τότε τρέξτε:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Δουλεύοντας με το virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Ξεκινήστε το εικονικό σας περιβάλλον εκτελώντας:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. Σε αυτή την περίπτωση, ανοίξτε ένα άλλο Windows PowerShell με την επιλογή "Εκτέλεση ως διαχειριστής". Έπειτα δοκιμάστε να πληκτρολογήσετε την ακόλουθη εντολή πριν ξεκινήσετε το εικονικό σας περιβάλλον:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Εγκατάσταση πακέτων με τα requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/el-GR/django_models/README.md b/el-GR/django_models/README.md
new file mode 100644
index 00000000000..dca03e1d57a
--- /dev/null
+++ b/el-GR/django_models/README.md
@@ -0,0 +1,201 @@
+# Django μοντέλα (models)
+
+Αυτό που θέλουμε να δημιουργήσουμε τώρα είναι κάτι που θα αποθηκεύει όλες τις αναρτήσεις του blog μας. Αλλά για να είμαστε σε θέση να το κάνουμε, πρέπει να μιλήσουμε λίγο για το τι ονομάζουμε `"αντικείμενα" (objects)`.
+
+## Objects
+
+Υπάρχει μια έννοια στον προγραμματισμό που ονομάζεται `"Αντικειμενοστραφής προγραμματισμός`. Η ιδέα είναι ότι αντί να γράφετε τα πάντα ως μια βαρετή ακολουθία από προγραμματιστικές εντολές, μπορούμε να μοντελοποιήσουμε τα πράγματα και να καθορίσουμε πως αλληλεπιδρούν μεταξύ τους.
+
+Άρα, τι είναι ένα αντικείμενο; Είναι μια συλλογή από ιδιότητες και συμπεριφορές. Ακούγεται παράξενο, αλλά θα σας δώσουμε ένα παράδειγμα.
+
+Εάν θέλουμε να μοντελοποιήσουμε μια γάτα, θα δημιουργήσουμε ένα αντικείμενο `Γάτα` το οποίο έχει κάποιες ιδιότητες όπως `χρώμα`, `ηλικία`, `διάθεση` (όπως καλή, κακή, νυσταγμένη :)), και `ιδιοκτήτης`(που θα μπορεί να ανατεθεί σε ένα αντικείμενο `άτομο` ή ίσως, στην περίπτωση μιας αδέσποτης γάτας, αυτή η ιδιότητα θα μπορούσε να είναι άδεια).
+
+Έπειτα η `γάτα` έχει κάποιες δράσεις `γουργούρισμα`, `ξύσιμο` ή `τάισμα`( σε αυτή την περίπτωση, θα δώσουμε στην γάτα λίγη `γατοτροφή`, που θα μπορούσε να είναι ένα ξεχωριστό αντικείμενο με ιδιότητες, όπως `γεύση`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+Βασικά η ιδέα είναι να περιγράψουμε τα αληθινά πράγματα στον κώδικα με ιδιότητες (που ονομάζονται `object properties`) και συμπεριφορές (που ονομάζονται `methods`).
+
+Πώς θα μοντελοποιήσουμε τότε τις αναρτήσεις του blog; Θέλουμε να κατασκευάσουμε ένα blog, σωστά;
+
+Πρέπει να δώσουμε απάντηση στο ερώτημα: τι είναι μία ανάρτηση στο blog; Τι ιδιότητες πρέπει να έχει;
+
+Λοιπόν, σίγουρα μία ανάρτηση στο blog μας χρειάζεται κάποιο κείμενο με το περιεχόμενό του και έναν τίτλο, σωστά; Θα ήταν επίσης ωραίο να ξέρουμε ποιος το έγραψε αυτό. Έτσι χρειαζόμαστε έναν συγγραφέα. Τέλος, θέλουμε να γνωρίζουμε πότε δημιουργήθηκε και δημοσιεύτηκε η συγκεκριμένη ανάρτηση.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Τι είδους πράγματα θα μπορούσαν να γίνουν με μια ανάρτηση στο blog; Θα ήταν ωραίο να έχουμε κάποια `method` που δημοσιεύει την ανάρτηση, σωστά;
+
+Έτσι, θα χρειαστούμε μια μέθοδο `publish`.
+
+Δεδομένου ότι γνωρίζουμε ήδη τι θέλουμε να επιτύχουμε, ας ξεκινήσουμε τη μοντελοποίηση στο Django!
+
+## Django model
+
+Γνωρίζοντας τι είναι ένα αντικείμενο, μπορούμε να δημιουργήσουμε ένα μοντέλο Django για την ανάρτηση στο blog μας.
+
+Ένα μοντέλο στο Django είναι ένα ιδιαίτερο είδος αντικειμένου το οποίο αποθηκεύεται στη βάση δεδομένων `database`. Η βάση δεδομένων είναι μια συλλογή δεδομένων. Είναι εκεί όπου θα αποθηκευτούν όλες οι πληροφορίες για τους χρήστες, τις αναρτήσεις στο blog, κλπ. Θα χρησιμοποιήσουμε την βάση δεδομένων SQLite για την αποθήκευση των δεδομένων μας. Αυτός είναι η προεπιλεγμένη βάση δεδομένων του Django. Είναι αρκετό για εμάς για την ώρα.
+
+Μπορείτε να σκεφτείτε ένα μοντέλο της βάσης δεδομένων ως ένα υπολογιστικό φύλλο με στήλες (πεδία) και γραμμές (δεδομένα).
+
+### Δημιουργία μιας εφαρμογής
+
+Για να κρατήσουμε τα πάντα τακτοποιημένα, θα δημιουργήσουμε μια ξεχωριστή εφαρμογή μέσα στο project μας. Είναι πολύ ωραίο να έχουμε τα πάντα οργανωμένα από την αρχή. Για την δημιουργία μιας εφαρμογής θα χρειαστεί να τρέξουμε την ακόλουθη εντολή στην κονσόλα (από τον φάκελο `djangogirls` όπου βρίσκεται το αρχείο `manage.py`):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Θα παρατηρήσετε ότι ένας νέος φάκελος με το όνομα `blog` δημιουργήθηκε και περιέχει έναν αριθμό αρχείων. Οι φάκελοι και τα αρχεία στο project μας πρέπει να μοιάζουν κάπως έτσι:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+Μετά την δημιουργία μίας εφαρμογής, πρέπει επίσης να πούμε στο Django ότι πρέπει να τη χρησιμοποιήσει. Το κάνουμε αυτό μέσα στο αρχείο `mysite/settings.py`. Ανοίξτε το. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. Έτσι το τελικό προϊόν πρέπει να μοιάζει κάπως έτσι:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Δημιουργία ενός post model
+
+Μέσα στο αρχείο `blog/models.py` ορίζουμε όλα τα objects με το όνομα `Models`. Αυτό είναι ένα μέρος όπου θα ορίσουμε το post μοντέλο μας.
+
+Ας ανοίξουμε το αρχείο `blog/models.py`, διαγράψτε τα περιεχόμενα του και γράψτε τα εξής:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Σιγουρευτείτε ότι χρησιμοποιείτε δύο φορές την κάτω παύλα (`_`) σε κάθε πλευρά του `str`. Αυτό είναι απαραίτητο και συχνά θα το συναντάτε στην Python. Συνηθίζεται να ονομάζεται "dunder" (σύντμηση για "double-underscore").
+
+Μη φοβάστε. Θα εξηγήσουμε τι συμβαίνει!
+
+Όλες οι γραμμές που ξεκινούν με τις λέξεις `from` ή `import` είναι γραμμές που εισάγουν λειτουργίες από άλλα Python αρχεία (αυτά με την κατάληξη .py). Έτσι αντί να κάνουμε αντιγραφή-επικόλληση κώδικα, πολύ απλά συμπεριλαμβάνουμε κώδικα από άλλα αρχεία με τη χρήση του `from ... import ...`.
+
+`class Post(models.Model):` – αυτή η γραμμή ορίζει το μοντέλο μας (είναι μια κλάση που με τη σειρά της είναι και αυτή ένα `object`).
+
+- Η λέξη `class` είναι μια ιδιαίτερη λέξη-κλειδί που καθορίζει τον ορισμό μιας κλάσης.
+- Η λέξη `Post` είναι το όνομα του μοντέλου μας. Μπορούμε να του δώσουμε όποιο όνομα θέλουμε (αλλά πρέπει να αποφεύγουμε ιδιαίτερους χαρακτήρες και κενά). Πάντα το όνομα μιας κλάσης να ξεκινάει με ένα κεφαλαίο γράμμα.
+- Η γραμμή `models.Model` σημαίνει ότι το Post είναι ένα Django Model. Με αυτό τον τρόπο το Django θα ξέρει ότι θα πρέπει να αποθηκεύεται σε μια βάση δεδομένων.
+
+Τώρα ορίζουμε τα properties που λέγαμε: `title`, `text`, `created_date`, `published_date` και `author`. Για να το κάνουμε αυτό θα πρέπει να ορίσουμε τον τύπο τιμών που θα δέχεται το κάθε πεδίο (είναι κείμενο; αριθμός; ημερομηνία; κάποια συσχέτιση με ένα άλλο object, όπως ένας χρήστης;)
+
+- `models.CharField` – έτσι δηλώνετε ότι θέλετε να ορίσετε ένα κείμενο με συγκεκριμένο αριθμό χαρακτήρων.
+- `models.TextField`- αυτό είναι για μεγάλα κείμενα χωρίς όριο. Ακούγεται ιδανικό για περιεχόμενο δημοσιεύσεων blog, έτσι δεν είναι;
+- `models.DateTimeField`- αυτό είναι για ημερομηνία και ώρα.
+- `models.ForeignKey`- αυτό είναι ένας σύνδεσμος για ένα άλλο μοντέλο.
+
+Δεν θα εξηγήσουμε κάθε κομμάτι του κώδικα διότι θα πάρει αρκετό χρόνο. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+Τι γίνεται με την μέθοδο `def publish(self):`; Αυτή είναι ακριβώς η μέθοδος `publish` για την οποία μιλούσαμε πριν. `def` σημαίνει ορίζουμε μια συνάρτηση/μέθοδο (ανάλογα αν είναι μέρος τηε κλάσης ή όχι) και `publish` είναι το όνομα της. Μπορείτε να αλλάξετε το όνομα της μεθόδου αν θέλετε. Ο κανόνας ονομασίας είναι ότι χρησιμοποιούμε πεζά γράμματα και κάτω παύλες αντί για κενά. Αν χρησιμοποιήσετε κενά τότε λάβετε σφάλμα. Για παράδειγμα, μια μέθοδος που υπολογίζει την μέση τιμή θα λεγόταν `calculate_average_price`.
+
+Οι μέθοδοι συχνά κάνουν `return` κάτι, δηλαδή επιστρέφουν μια τιμή ή οτιδήποτε άλλο. Μπορεί όμως και όχι. Υπάρχει ένα παράδειγμα αυτού στη μέθοδο `__str__`. Σε αυτό το σενάριο, όταν καλούμε την `__str__()` θα λάβουμε ένα κείμενο (**string**) με τον τίτλο του post.
+
+Επίσης προσέξτε ότι και το `def publish(self):` και το `def __str__(self):` είναι δηλωμένα μέσα στην κλάση μας (με κενά ή με tab). Επειδή η Python είναι ευαίσθητη στα κενά (στους κενούς χαρακτήρες), θα πρέπει να "βάλουμε" τις μεθόδους μας μέσα στην κλάση. Αλλιώς, οι μέθοδοι δεν θα ανήκουν στην κλάση και μπορεί να συναντήσετε απρόοπτη συμπεριφορά.
+
+Εάν κάτι ακόμα δεν είναι ξεκάθαρο σχετικά με τα μοντέλα, μη διστάσετε να ρωτήσετε τον επιτηρητή σας! Ξέρουμε ότι είναι περίπλοκο, ειδικά όταν μαθαίνετε τι είναι τα αντικείμενα και συναρτήσεις ταυτόχρονα. Αλλά ελπίζουμε να μοιάζει λιγότερο μαγικό για εσάς τώρα!
+
+### Δημιουργία πινάκων για μοντέλα στην βάση δεδομένων σας
+
+Το τελευταίο βήμα εδώ είναι να προσθέσουμε το νέο μοντέλο μας στην βάση δεδομένων μας. Πρώτα πρέπει να ενημερώσουμε το Django ότι έχουμε κάποιες αλλαγές στο μοντέλο μας. (Μόλις το δημιουργήσαμε!) Πηγαίνετε στο παράθυρο της κονσόλας σας και πληκτρολογήστε `python manage.py makemigrations blog`. Θα μοιάζει κάπως έτσι:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Σημείωση:** Θυμηθείτε να αποθηκεύετε τα αρχεία που επεξεργάζεστε. Αλλιώς, ο υπολογιστής σας θα εκτελέσει τις προηγούμενες εκδόσεις που μπορεί να σας δώσει μηνύματα απρόοπτων σφαλμάτων.
+
+Το Django προετοίμασε ένα αρχείο migration για εμάς που πρέπει τώρα να εφαρμόσουμε στην βάση δεδομένων μας. Πληκτρολογήστε `python manage.py migrate blog` και τo αποτελέσματα πρέπει να είναι όπως παρακάτω:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Ζήτω! Το Post μοντέλο μας είναι στην βάση δεδομένων! Θα ήταν ωραίο να το δούμε, σωστά; Πηγαίνετε στο επόμενο κεφάλαιο για να δείτε πως μοιάζει η ανάρτηση σας!
\ No newline at end of file
diff --git a/el-GR/django_orm/README.md b/el-GR/django_orm/README.md
new file mode 100644
index 00000000000..170d5109fa0
--- /dev/null
+++ b/el-GR/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM και QuerySets
+
+Σε αυτό το κεφάλαιο θα μάθετε πως το Django συνδέεται στην βάση δεδομένων και αποθηκεύει δεδομένα μέσα της. Ας ξεκινήσουμε!
+
+## Τι είναι ένα QuerySet;
+
+Ένα QuerySet είναι, στην ουσία, μία λίστα αντικειμένων ενός Μοντέλου. Τα QuerySets σας επιτρέπουν να διαβάσετε τα δεδομένα από την βάση δεδομένων, να τα φιλτράρετε και να τα ταξινομήσετε.
+
+Είναι πιο εύκολο να μάθεις κάνοντας το. Πάμε να δοκιμάσουμε;
+
+## Παράθυρο εντολών Django (django shell)
+
+Άνοιξτε την κονσόλα (όχι στο PythonAnywhere) και πληκτρολογήστε αυτήν την εντολή:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Το αποτέλεσμα πρέπει να είναι σαν αυτό:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Είστε τώρα στην διαδραστική κονσόλα του Django. Είναι ακριβώς όπως το παράθυρο εντολών της Python, αλλά με μια μικρή επιπρόσθετη μαγεία του Django. :) Φυσικά, μπορείτε να χρησιμοποιήσετε όλες τις εντολές Python εδώ.
+
+### Όλα τα αντικείμενα
+
+Ας προσπαθήσουμε να εμφανίσουμε όλες τις δημοσιεύσεις του blog μας πρώτα. Μπορείτε να το κάνετε με την ακόλουθη εντολή:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Ωχ! Εμφανίστηκε ένα λάθος, μας λέει ότι δεν υπάρχει καμία δημοσίευση. Είναι σωστό. Ξεχάσαμε να το εισάγουμε πρώτα (να το κάνουμε, δηλαδή, import)!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+Εισάγουμε το μοντέλο `Post` από το module `blog.models`. Ας προσπαθήσουμε να εμφανίσουμε όλες τις αναρτήσεις ξανά:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Αυτή είναι μια λίστα των αναρτήσεων που δημιουργήσαμε νωρίτερα! Δημιουργήσαμε αυτές τις αναρτήσεις χρησιμοποιώντας το περιβάλλον διαχειριστή Django. Αλλά τώρα θέλουμε να δημιουργήσουμε νέες αναρτήσεις χρησιμοποιώντας την Python, οπότε πως το κάνουμε αυτό;
+
+### Δημιουργία αντικειμένου
+
+Έτσι δημιουργείται ένα νέο αντικείμενο Post στην βάση δεδομένων:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Αλλά μας λείπει ένα συστατικό εδώ: `εγώ`. Χρειαζόμαστε να περάσουμε μία παρουσία του μοντέλου `User` ως τον author. Πως το κάνουμε αυτό;
+
+Ας εισάγουμε το μοντέλο User πρώτα:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Τι χρήστες έχουμε στην βάση δεδομένων μας; Δοκιμάστε αυτό:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+Αυτός είναι ο χρήστης superuser που δημιουργήσαμε νωρίτερα! Ας πάρουμε ένα instance από την κλάση User τώρα (αντικαταστείστε το όνομα με το όνομα χρήστη που βάλατε νωρίτερα ως superuser):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Όπως βλέπετε, κάνουμε ένa `get` για έναν `User` με ένα `username` το οποίο ισούται με 'ola'. Καλό!
+
+Τώρα μπορούμε, επιτέλους να δημιουργήσουμε το post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Ζήτω! Θέλετε να ελέγξετε αν λειτούργησε;
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Αυτό είναι, άλλη ένα post στη λίστα!
+
+### Προσθέστε περισσότερα posts
+
+Τώρα μπορείτε να διασκεδάσετε λίγο και να προσθέσετε περισσότερες δημοσιεύσεις για να δείτε πως δουλεύει. Προσθέστε δυο-τρεις ακόμα και μετά προχωρήστε στο επόμενο μέρος.
+
+### Φιλτράρισμα αντικειμένων
+
+Ένα μεγάλο μέρος των χαρακτηριστικών των QuerySets είναι η δυνατότητα να τα φιλτράρουμε. Ας υποθέσουμε ότι θέλουμε να βρούμε όλα τα posts όπου ο χρήστης ola έγραψε. Θα χρησιμοποιήσουμε την μέθοδο `filter` αντί της `all` στην εντολή `Post.objects.all()`. Μέσα στις παρενθέσεις της μεθόδου filter δηλώνουμε τα κριτήρια αναζήτησης για αυτό που ψάχνουμε. Στην περίπτβση μας, το κριτήριο είναι ένα `author` και θέλουμε να είναι ίσο με `me`. Ο τρόπος που το γράφουμε στο Django είναι `author=me`. Τώρα ο κώδικας μοιάζει κάπως έτσι:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Ή ίσως θα θέλαμε να δούμε όλα τα posts τα οποία περιέχουν τη λέξη 'title' μέσα στο πεδίο `title`;
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Σημείωση** Υπάρχουν δύο κάτω παύλες (`_`) μεταξύ του `title` και του `contains`. Το Django ORM χρησιμοποιεί αυτόν τον κανόνα για να διαχωρίσει τα ονόματα των πεδίων των μοντέλων ("title") με τους διαχωριστές ή τα φίλτρα ("contains"). Αν χρησιμποιούσατε μόνο μια κάτω παύλα θα λαμβάνατε το σφάλμα "FieldError: Cannot resolve keyword title_contains".
+
+Μπορείτε επίσης να πάρετε μια λίστα από δημοσιευμένα posts. Το κάνουμε αυτό φιλτράροντας όλα τα posts που έχουν παρελθοντική ημ/νια `published_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Δυστυχώς, το post που αναρτήσαμε από την Python κονσόλα δεν είναι δημοσιευμένο ακόμα. Αλλά μπορούμε να το αλλάξουμε αυτό. Πρώτα, πάρτε ένα instance από το post που θέλετε να δημοσιεύσετε:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+Και έπειτα δημοσιεύστε το με την μέθοδο `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Τώρα προσπαθήστε να πάρετε μια λίστα από δημοσιευμένα posts ξανά (πιέστε το πάνω βελάκι στο πληκτρολόγιο 3 φορές και έπειτα `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ταξινόμηση objects
+
+Τα QuerySets επίσης σου επιτρέπουν να ταξινομήσεις την λίστα των αντικειμένων. Ας προσπαθήσουμε να τα ταξινομήσουμε ως προς πεδίο `created_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Μπορούμε επίσης να αντιστρέψουμε την ταξινόμηση προσθέτοντας `-` στην αρχή:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Αυτό είναι πολύ ισχυρό και σας επιτρέπει να γράψετε αρκετά σύνθετα ερωτήματα.
+
+Ωραία! Τώρα είστε έτοιμοι για το επόμενο μέρος! Για να κλείσετε το κέλυφος, πληκτρολογήστε αυτό:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/el-GR/django_start_project/README.md b/el-GR/django_start_project/README.md
new file mode 100644
index 00000000000..e36331e55a9
--- /dev/null
+++ b/el-GR/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Το πρώτο σας Django project!
+
+> Μέρος αυτού του κεφαλαίου είναι βασισμένο στους οδηγούς από την κοινότητα Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Μέρος αυτού του κεφαλαίου είναι βασισμένο στους οδηγούς από την κοινότητα [django-marcador tutorial](http://django-marcador.keimlink.de/) υπό την άδεια χρήσης Creative Commons Attribution-ShareAlike 4.0 International License. Τα πνευματικά δικαιώματα του οδηγού django-marcador ανήκουν στον Markus Zapke-Gründemann.
+
+Πρόκειται να δημιουργήσουμε ένα μικρό blog!
+
+Το πρώτο βήμα είναι να ξεκινήσουμε ένα νέο Django project. Βασικά αυτό σημαίνει ότι θα εκτελέσουμε μερικά scripts (εντολές) που παρέχονται από το Django τα οποία θα δημιουργήσουν τον σκελετό ενός Django project για εμάς. Αυτά είναι ένα σύμπλεγμα φακέλων και αρχείων που θα χρησιμοποιήσουμε αργότερα.
+
+Τα ονόματα μερικών αρχείων και φακέλων είναι πολύ σημαντικά για το Django. Δεν πρέπει να μετονομάσετε τα αρχεία που πρόκειται να δημιουργήσουμε. Μετακινώντας τα σε ένα διαφορετικό μέρος δεν είναι επίσης καλή ιδέα. Το Django χρειάζεται να διατηρήσει μία συγκεκριμένη δομή για να μπορεί να βρει σημαντικά πράγματα.
+
+> Θυμηθείτε να εκτελείτε τα πάντα μέσα σε κάποιο εικονικό περιβάλλον. Εάν δεν δείτε ένα πρόθεμα `(myenv)` στην κονσόλα σας, θα πρέπει να ενεργοποιήσετε το εικονικό περιβάλλον σας. Εξηγήσαμε πως να το κάνετε αυτό στο κεφάλαιο **Εγκατάσταση Django** στην ενότητα **Δουλεύοντας με το εικονικό περιβάλλον**. Σε Windows δοκιμάστε να γράψετε `myvenv\Scripts\activate` ή αν έχετε Lixux/OS X γράψτε `source myvenv/bin/activate`.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+Στην κονσόλα σας Mac OS X ή Linux, πρέπει να εκτελέσετε την ακόλουθη εντολή. ** Μην ξεχάσετε να προσθέσετε την τελεία `. ` στο τέλος!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Η τελεία `.` είναι ζωτικής σημασίας επειδή λέει στην εντολή να εγκαταστήσει το Django στο τρέχον φάκελο σας ( για το οποίο η τελεία `.` είναι μία συντόμευση).
+> 
+> **Σημείωση** Όταν πληκτρολογείτε την παραπάνω εντολή, θυμηθείτε ότι πληκτρολογείτε το κομμάτι που ξεκινά με `django-admin`. Το κομμάτι κονσόλας που εμφανίζεται εδώ `(myvenv) ~/djangogirls$` είναι απλώς ένα παράδειγμα.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Στα Windows πρέπει να εκτελέσετε την ακόλουθη εντολή. **(Μην ξεχάσετε να προσθέσετε την τελεία `.` στο τέλος)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Η τελεία `.` είναι ζωτικής σημασίας επειδή λέει στην εντολή να εγκαταστήσει το Django στο τρέχον φάκελο σας ( για το οποίο η τελεία `.` είναι μία συντόμευση).
+> 
+> **Σημείωση** Όταν πληκτρολογείτε την παραπάνω εντολή, θυμηθείτε ότι πληκτρολογείτε το κομμάτι που ξεκινά με `django-admin.exe`. Το κομμάτι κονσόλας που εμφανίζεται εδώ `(myvenv) ~/djangogirls$` είναι απλώς ένα παράδειγμα.
+
+<!--endsec-->
+
+Η εντολή `django-admin.py` μπορεί να δημιουργήσει τους φακέλους και τα αρχεία για εσάς. Θα πρέπει τώρα να έχετε μια δομή φακέλων που μοιάζει κάπως έτσι:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Σημείωση**: Στην δομή φακέλων σας, θα δείτε επίσης τον `venv` φάκελο σας που δημιουργήσαμε προηγουμένως.
+
+Το `manage.py` είναι ένα script που βοηθά με την διαχείριση του project σας. Με αυτό θα μπορούμε να (μεταξύ άλλων πραγμάτων) ξεκινήσουμε έναν server στον υπολογιστή μας χωρίς να εγκαταστήσουμε οτιδήποτε άλλο.
+
+Το αρχείο `settings.py` περιέχει τις διάφορες παραμέτρους του project σας.
+
+Θυμάστε όταν μιλήσαμε σχετικά με ένα μεταφορέα αλληλογραφίας που ελέγχει που να παραδώσει ένα γράμμα; Το αρχείο `urls.py` περιέχει μία λίστα από σχέδια που χρησιμοποιούνται από τον `urlresolver`.
+
+Ας αφνοήσουμε τα υπόλοιπα αρχεία προς το παρόν καθώς δεν θα τα αλλάξουμε καθόλου. Το μόνο πράγμα που πρέπει να θυμάστε είναι να μην τα διαγράψετε κατά λάθος!
+
+## Αλλάζοντας τις ρυθμίσεις
+
+Ας κάνουμε μερικές αλλαγές στο αρχείο `mysite/settings.py`. Ανοίξτε το.
+
+**Σημείωση**: Κρατήστε στο μυαλό σας ότι το αρχείο `settings.py` είναι ένα κοινό Python αρχείο όπως όλα τα άλλα Python αρχεία (έχουν, δηλαδή, την κατάληξη .py). Μπορείτε να το ανοίξετε μέσα από τον επεξεργαστή κώδικα που χρησιμοποιείτε, κλικάροντας στο "File -> Open". Αυτό θα εμφανίσει ένα παράθυρο εξερεύνησης αρχείων μέσα από το οποίο επιλέγετε το αρχείο `settings.py` και το ανοίγετε. Εναλλακτικά, μπορείτε να μεταβείτε μέσα από τον φάκελο djangogirls και με δεξί κλικ να το ανοίξετε. Έπειτα, επιλέξτε τον επεξεργαστή κώδικα από την προτινώμενη λίστα προγραμμάτων. Η επιλογή του επεξεργαστή κώδικα είναι σημαντική καθώς μπορεί να έχετε άλλα προγράμματα εγκατεστημένα.
+
+Θα ήτνα καλό να έχουμε τη σωστή ώρα στην ιστοσελίδα μας. Πηγαίνετε στο [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) και αντιγράψτε την ζώνη ώρας σας (TZ) (πχ `Europe/Athens`).
+
+Στο αρχείο `settings.py`, βρείτε τη γραμμή που λέει `TIME_ZONE` και αλλάξτε την τιμή της σε αυτή που αντιγράψατε. Για παράδειγμα:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+Ο κωδικό γλώσσας (language code) αποτελείται από την γλώσσα, πχ `en` για Αγγλικά ή `el` για Ελληνικά και τον κωδικό χώρας πχ `gr` για Ελλάδα ή `ch` για την Ελβετία. Αν τα Ελληνικά είναι η μητρική σας γλώσσα, μπορείτε να προσθέσετε το παρακάτω για να αλλάξετε την γλώσσα σε Ελληνικά: Μπορείτε, δηλαδή, να έχετε ένα κουμπί "Άκυρο" μεταφρασμένο στην γλώσσα σας. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+Αν θέλετε κάποια διαφορετική γλώσσα, αλλάξτε το string LANGUAGE_CODE όπως παρακάτω με την τική που εσείς επιθυμείτε:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'el-GR'
+```
+
+Χρειάζεται επίσης να ρυθμίσουμε τα στατικά αρχεία μας. (Θα βρείτε τα πάντα για τα στατικά αρχεία και το CSS αργότερα στον οδηγό.) Πηγαίνετε προς τα κάτω μέχρι το *τέλος* του αρχείου και ακριβώς κάτω από την καταχώρηση `STATIC_URL`, προσθέστε μια νέα που ονομάζεται `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Όταν το flag `DEBUG` είναι `True` και η λίστα `ALLOWED_HOSTS` είναι κενή, ο host επικυρώνεται μέσα από την ακόλουθη λίστα `[«localhost', '127.0.0.1', ' [:: 1]']`. Αυτό δεν θα ταιριάξει το hostname μας στο PythonAnywhere μόλις κάνουμε deploy την εφαρμογή μας. Οπότε θα χρειαστεί να κάνουμε την ακόλουθη αλλαγή:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Σημείωση**: Αν χρησιμοποιείτε ένα Chromebook, προσθέστε αυτή τη γραμμή στο τέλος του αρχείου settings.py: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Επίσης προσθέστε `".amazonaws.com"` στη λίστα `ALLOWED_HOSTS` αν χρησιμοποιείτε το cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Δημιουργία μιας βάσης δεδομένων
+
+Υπάρχουν πολλές διαφορετικές βάσεις δεδομένων που μπορούν να αποθηκεύσουν δεδομένα για την σελίδα σας. Θα χρησιμοποιήσουμε την προεπιλεγμένη, `sqlite3`.
+
+Αυτό έχει ήδη δηλωθεί στο αρχείο `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Για να δημιουργήσετε μία βάση δεδομένων για το blog σας, ας εκτελέσουμε το ακόλουθο στην κονσόλα: `python manage.py migrate` ( χρειάζεται να είμαστε στον φάκελο `djangogirls` που περιέχει το αρχείο `manage.py`). Αν αυτό πάει καλά, θα πρέπει να δείτε κάτι σαν αυτό:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... ΟΚ
+    
+
+Και τελειώσαμε! Ώρα να ξεκινήσουμε τον server και να δούμε εάν η ιστοσελίδα μας λειτουργεί!
+
+## Εκκίνηση του development server
+
+Θα πρέπει να είστε στον φάκελο που περιέχει το αρχείο `manage.py` (στον φάκελο `djangogirls`). Στην κονσόλα, μπορούμε να ξεκινήσουμε τον server εκτελώντας `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Εάν είστε σε ένα Chromebook, χρησιμοποιείστε αυτή την εντολή:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> Είδαμε πως λειτουργούν οι web servers στο κεφάλαιο **Πως λειτουργεί το internet**.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/el-GR/django_templates/README.md b/el-GR/django_templates/README.md
new file mode 100644
index 00000000000..f52e9840338
--- /dev/null
+++ b/el-GR/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Ήρθε η ώρα να παρουσιάσουμε ορισμένα δεδομένα! Το Django μας δίνει κάποια προεγκατεστημένα **template tags**.
+
+## Τι είναι τα template tags;
+
+Βλέπετε, στην HTML δεν μπορείτε να γράψετε κώδικα σε Python επειδή οι browsers δεν καταλαβαίνουν αυτή τη γλώσσα. Εκείνοι ξέρουν μόνο HTML, CSS και Javascript. Ξέρουμε ότι η HTML είναι στατική γλώσσα ενώ η Python περισσότερο δυναμική.
+
+Τα **Django template tags** μας επιτρέπουν να μεταφέρουμε πράγματα της Python μέσα στην HTML, ούτως ώστε να χτίσετε δυναμικές ιστοσελίδες γρηγορότερα. Τέλεια!
+
+## Template προβολή λίστας των post
+
+Σε προηγούμενο κεφάλαιο δώσαμε στο template μας μια λίστα από posts μέσα σε μια μεταβλητή με το όνομα `posts`. Τώρα θα την προβάλουμε στην HTML. Άλλωστε αυτό θέλαμε να κάνουμε από την αρχή.
+
+Για να εκτυπώσουμε μια μεταβλητή μέσα στα Django templates, χρησιμοποιούμε διπλές αγκύλες ({% raw %}{{ }}{% endraw %}) με το όνομα της μεταβλητής ανάμεσα:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Δοκιμάστε αυτό μέσα στο template `blog/templates/blog/post_list.html`. Ανοίξτε το και αντικαταστήστε τα πάντα από το δεύτερο `<div>` to the third `</div>` με το `{{ posts }}`. Αποθηκεύστε το αρχείο και ανανεώστε τη σελίδα για να δείτε τα αποτελέσματα:
+
+![Σχήμα 13.1](images/step1.png)
+
+Όπως βλέπετε, το μόνο που έχουμε είναι το εξής:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Αυτό σημαίνει ότι το Django το εκλαμβάνει ως μια λίστα από objects. Θυμηθείτε στο κεφάλαιο **Εισαγωγή στην Python** πως προβάλαμε λίστες; Ναι, με επαναλήψεις! Στα Django template το κάνετε ως εξής:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Δοκιμάστε αυτό στο template.
+
+![Σχήμα 13.2](images/step2.png)
+
+Δούλεψε! Αλλά θέλουμε τα posts μα εμφανίζονται όπως τα στατικά posts που φτιάξαμε νωρίτερα στο κεφάλαιο **Εισαγωγή στην HTML**. Μπορείτε να μιξάρετε HTML και template tags μαζί. Έτσι, το `body` θα μοιάζει κάπως έτσι:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Οτιδήποτε βάζετε ανάμεσα στο `{% for %}` και το `{% endfor %}` θα επαναληφθεί για κάθε object στη λίστα. Ανανεώστε τη σελίδα:{% endraw %}
+
+![Σχήμα 13.3](images/step3.png)
+
+Παρατηρήσατε ότι χρησιμοποιούμε έναν διαφορετικό τρόπο πρόσβασης αυτή τη φορά (`{{ post.title }}` ή `{{ post.text }}`); Αποκτούμε πρόσβαση στα δεδομένα κάθε πεδίου που είναι ορισμένα στο μοντέλο `Post`. Επίσης, η κάθετη γραμμή `|linebreaksbr` φιλτράρει το κείμενο του posts όπου μετατρέπει τις αλλαγές γραμμής σε παράγράφους.
+
+## Ένα ακόμα πράγμα
+
+Θα ήταν καλό να βλέπαμε αν το site σας εξακολουθεί να λειτουργεί ακόμα στο internet, σωστά; Ας το κάνουμε deploy στο PythonAnywhere για ακόμη μια φορά. Παρακάτω φαίνεται μια περίληψη των βημάτων…
+
+* Πρώτα κάντε push τον κώδικα σας στο GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Έπειτα συνδεθείτε στο [PythonAnywhere](https://www.pythonanywhere.com/consoles/), μεταβείτε στο **Bash console** (ή ανοίξτε ένα νέο) και τρέξτε:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Θυμηθείτε να αντικαταστήσετε με το `<your-pythonanywhere-domain>`πραγματικό όνομα χρήστη σας του PythonAnywhere χωρίς τα <>)
+
+* Τέλος, πηγαίνετε στο ["Web" page](https://www.pythonanywhere.com/web_app_setup/) και κλικάρετε **Reload** στην εφαρμογή σας. (Για να δείτε άλλες σελίδες του PythonAnywhere από την κονσόλα χρησιμοποιήστε το κουμπί του μενού στην πάνω δεξιά γωνία). Η αλλαγή σας θα πρέπει να φαίνεται στο https://subdomain.pythonanywhere.com. Δείτε το στο browser! Δεν πειράζει αν τα posts στο PythonAnywhere δεν είναι τα ίδια με τα posts που εμφανίζονται τοπικά στον υπολογιστή σας. Οι βάσεις δεδομένων στον τοπικό υπολογιστή σας και στο PythonAnywhere δεν είναι συγχρονισμένες μεταξύ τους.
+
+Συγχαρητήρια! Τώρα προχωρήστε και προσθέστε μερικά posts μέσω του Django admin (θυμηθείτε να προσθέσετε το published_date! -ημερομηνία δημοσίευσης). Σιγουρευτείτε ότι βρίσκεστε στο Django admin της ιστοσελίδας pythonanywhere, https://subdomain.pythonanywhere.com/admin. Έπειτα, ανανεώστε τη σελίδα και δείτε αν αυτά τα posts εμφανίστηκαν.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Σχήμα 13.4](images/donut.png)
\ No newline at end of file
diff --git a/el-GR/django_urls/README.md b/el-GR/django_urls/README.md
new file mode 100644
index 00000000000..6f279ae6908
--- /dev/null
+++ b/el-GR/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+Είμαστε έτοιμοι να χτίσουμε την πρώτη μας σελίδα: μια αρχική σελίδα (homepage) για το blog μας! Αλλά πρώτα πρέπει να μάθουμε λίγα πράγματα για τα Django URLs.
+
+## Τι είναι ένα URL;
+
+Ένα URL είναι μια διεύθυνση ιστού. Μπορείτε να δείτε ένα URL κάθε φορά που επισκέπτεστε μια σελίδα. Είναι ορατό στην γραμμή διεύθυνσης. (Ναι! `127.0.0.1:8000` είναι ένα URL! Και το `https://djangogirls.org` είναι, επίσης, ένα URL.)
+
+![URL](images/url.png)
+
+Κάθε σελίδα στο ιντερνετ χρειάζεται το δικό της URL. Με αυτό τον τρόπο η εφαρμογή σας θα ξέρει τι να δείξει στον χρήστη που ανοίγει αυτό το URL. Στο Django, χρησιμοποιούμε κάτι που το ονομάζουμε `URLconf` (URL configuration). Το URLconf είναι ένα σετ από μοτίβα που το Django θα προσπαθήσει να ταιριάξει με το ζητούμενο URL ούτως ώστε να βρει το κατάλληλο view.
+
+## Πως δουλεύουν τα URLs στο Django;
+
+Ας ανοίξουμε το αρχείο `mysite/urls.py` και να δούμε τι έχει μέσα:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Όπως βλέπετε, το Django έχει γράψει μέσα κάποια πράγματα για εμάς.
+
+Οι γραμμές μεταξύ των τριπλών εισαγωγικών (`'''` ή `"""`) ονομάζονται docstrings. Μπορείτε να τα γράψετε στην αρχή κάθε Python αρχείου, κλάσης, μεθόδου ή συνάρτησης για να περιγράψετε το τι κάνει. Δεν θα εκτελεστούν από την Python.
+
+Το admin URL, το οποίο επισκεφτήκατε σε προηγούμενο κεφάλαιο, είναι ήδη εκεί:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Η γραμμή αυτή σημαίνει ότι για κάθε URL που ξεκινά με τη λέξη `admin/`, το Django θα ψάξει να βρει το αντίστοιχο *view*. Σε αυτή την περίπτωση συμπεριλαμβάνουμε αρκετά admin URLs ούτως ώστε να μην εμφανίζονται όλα σε αυτό το αρχείο. Είναι περισσότερο ευανάγνωστο κατ' αυτό τον τρόπο.
+
+## Το πρώτο σας Django URL!
+
+Ώρα να δημιουργήσουμε το πρώτο σας URL! Θέλουμε η διεύθυνση 'http://127.0.0.1:8000/' να είναι η αρχική μας σελίδα για το blog, η οποία θα εμφανίζει όλα τα posts.
+
+Θέλουμε, επίσης, να κρατήσουμε το αρχείο `mysite/urls.py` καθαρό. Οπότε, θα κάνουμε import τα URLs από το `blog` application στο αρχείο `mysite/urls.py`.
+
+Πηγαίνετε λοιπόν, και προσθέστε αυτή τη γραμμή στο αρχείο `blog.urls`. Θα χρειαστεί, επίσης, να αλλάξετε την γραμμή `from django.urls…` επειδή χρησιμοποιούμε την συνάρτηση `include`. Επομένως, θα χρειαστεί να προσθέσετε αυτή τη γραμμή.
+
+Το αρχείο σας `mysite/urls.py` θα μοιάζει κάπως έτσι:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Το Django, τώρα, θα ανακατευθύνει οτιδήποτε έρχεται στο 'http://127.0.0.1:8000/' προς το αρχείο `blog.urls` και από κει και πέρα θα πράττει αναλόγως.
+
+## blog.urls
+
+Δημιουργήστε ένα κενό αρχείο `urls.py` μέσα στο φάκελο `blog` και ανοίξτε το. Τέλεια! Προσθέστε αυτές τις δύο γραμμές:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Εδώ κάνουμε import τη συνάρτηση `path` του Django και όλα τα `views` από το `blog` application. (Δεν κάποια views ακόμα αλλά θα φτάσουμε εκεί σε λίγο!)
+
+Μετά από αυτό, μπορούμε να προσθέσουμε το πρώτο μας URL μοτίβο (URL pattern):
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+Όπως μπορείτε να δείτε, αναθέτουμε ένα `view` με το όνομα `post_list` στο πηγαίο URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. Αυτό το μοτίβο θα πει στο Django ότι το view `views.post_list` είναι το σωστό μέρος να πας αν κάποιος επισκεφτεί τη διεύθυνση 'http://127.0.0.1:8000/'.
+
+Το τελευταίο μέρος, `name='post_list'`, είναι το όνομα του URL το οποίο θα χρησιμοποιηθεί για να αναγνωρίσουμε αυτό το URL. Αυτό μπορεί να είναι το ίσιο όπως το όνομα του view αλλά μπορεί να είναι κάτι τελείως το διαφορετικό αν θέλετε. Θα χρησιμοποιούμε τα URLs με όνομα (named URLs) αργότερα στο project, οπότε είναι σημαντικό να ονομάσετε κάθε URL στην εφαρμογή σας. Θα προσπαθήσουμε, επίσης, να κρατήσουμε τα ονόματα μοναδικά μεταξύ τους και εύκολα να τα θυμόμαστε.
+
+Αν προσπαθήσετε να επισκεφτείτε τη διεύθυνση http://127.0.0.1:8000/, τότε θα δείτε ένα σφάλμα τύπου 'web page not available'. Αυτό προκύπτει επειδή ο server (θυμάστε όταν γράψατε `runserver`?) δεν τρέχει. Δείτε στην κονσόλα που έτρεχε ο server σας και δείτε το γιατί.
+
+![Σφάλμα](images/error1.png)
+
+Η κονσόλα, σας εμφάνισε σφάλμα αλλά μην ανησυχείτε. Είναι στην ουσία πολύ χρήσιμο: σας λέει **no attribute 'post_list'**. Αυτό είναι το όνομα του *view* το οποίο προσπαθεί να βρει και να χρησιμοποιήσει το Django αλλά δεν το έχουμε δημιουργήσει ακόμα. Σε αυτό το σημείο, ούτε η σελίδα `/admin/` δεν θα λειτουργεί. Μην ανησυχείτε. Θα φτάσουμε και εκεί. Αν δείτε κάποιο διαφορετικό σφάλμα προσπαθείστε να επανεκκινήσετε τον τοπικό server σας. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/el-GR/django_views/README.md b/el-GR/django_views/README.md
new file mode 100644
index 00000000000..1c4f2f1358f
--- /dev/null
+++ b/el-GR/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – ώρα να δημιουργήσουμε!
+
+Ώρα να ξεφορτωθούμε το σφάλμα που δημιουργήσαμε στο προηγούμενο κεφάλαιο! :)
+
+Ένα *view* είναι το μέρος όπου βάζουμε την "λογική" της εφαρμογής μας. Θα ζητήσει πληροφορίες από το μοντέλο μας (`model`) που δημιουργήσαμε νωρίτερα και θα το περάσει στο `template`. Θα δημιουργήσουμε ένα template στο επόμενο κεφάλαιο. Τα views είναι απλώς Python συναρτήσεις οι οποίες είναι ελαφρώς πιο περίπλοκες από αυτές που γράψαμε στο κεφάλαιο **Εισαγωγή στην Python**.
+
+Τα views τοποθετούνται σε ένα αρχείο (ανα εφαρμογή) με το όνομα `views.py`. Θα προσθέσουμε τα δικά μας *views* στο αρχείο `blog/views.py`.
+
+## blog/views.py
+
+Ωραία. Ας ανοίξουμε το αρχείο να δούμε τι έχει μέσα:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Όχι και πολλά πράγματα, ακόμα.
+
+Θυμηθείτε ότι οι γραμμές που ξεκινούν με δίεση `#` είναι σχόλια. Αγνοούνται πλήρως από την Python.
+
+Ας δημιουργήσουμε ένα *view* όπως προτείνει και το σχόλιο. Προσθέστε τα επόμενα από κάτω:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Όπως βλέπετε, δημιουργήσαμε μια συνάρτηση (`def`) με το όνομα `post_list` η οποία παίρνει την παράμετρο `request` και επιστρέφει `return` την τιμή που παίρνει από άλλη συνάρτηση, την `render`, η οποία κάνει render ("χτίζει") το template `blog/post_list.html`.
+
+Αποθηκεύστε το αρχείο και επισκεφτείτε τη σελίδα http://127.0.0.1:8000/ να δούμε τι εμφανίζεται.
+
+Κι άλλο σφάλμα! Διαβάστε το γιατί:
+
+![Σφάλμα](images/error.png)
+
+Αυτή τη φορά δείχνει ότι ο server, τουλάχιστον, τρέχει αλλά κάτι δεν πάει καλά, σωστά; Μην ανησυχείτε. Είναι απλώς μια σελίδα σφάλματος! Όπως ακριβώς τα μηνύματα σφάλματος στην κονσόλα, αυτά τα σφάλματα στον browser είναι στην πραγματικότητα πολύ χρήσιμα. Διαβάζετε ότι *TemplateDoesNotExist*. Ας το φτιάξουμε δημιουργώντας ένα template στο επόμενο κεφάλαιο!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/el-GR/dynamic_data_in_templates/README.md b/el-GR/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..97a8351986c
--- /dev/null
+++ b/el-GR/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Δυναμικά δεδομένα στα templates
+
+Μέχρι τώρα έχουμε διαφορετικά κομμάτια έτοιμα να συναρμολογηθούν: το μοντέλο `Post` είναι δηλωμένο στο αρχείο `models.py`, την συνάρτηση `post_list` στο αρχείο `views.py` το template. Αλλά πως θα κάνουμε τα posts να εμφανιστούν στο HTML template; Επειδή αυτό θέλουμε να κάνουμε. Να αντλήσουμε δεδομένα (αποθηκευμένα μοντέλα στη βάση δεδομένων) και να τα παρουσιάσουμε όμορφα μέσα από ένα template, σωστά;
+
+Αυτό ακριβώς κάνουν τα *views*: συνδέουν τα μοντέλα με τα templates. Μέσα στη συνάρτηση `post_list` *view* πρέπει να προσπελάσουμε τα μοντέλα που θέλουμε και να τα δώσουμε στο template. Μέσα στο *view* αποφασίσαμε τι (μοντέλο) θα εμφανιστεί στο template.
+
+Ωραία, πως το κάνουμε αυτό;
+
+Πρέπει να ανοίξουμε το αρχείο `blog/views.py`. Μέχρι τώρα η συνάρτηση `post_list` *view* δείχνει κάπως έτσι:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Θυμάστε όταν είπαμε να συμπεριλαμβάνουμε κώδικα γραμμένο σε διαφορετικά αρχεία; Τώρα είναι η στιγμή να συπεριλάβουμε το μοντέλο που είχαμε γράψει στο αρχείο `models.py`. Θα προσθέσουμε τη γραμμή `from .models import Post`, όπως κάτωθι:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+Η τελεία πριν τη λέξη `models` σημαίνει ο *παρόν φάκελος* ή το *παρόν application*. Και τα δύο αρχεία `views.py` και `models.py` βρίσκονται στον ίδιο φάκελο. Αυτό σημαίνει ότι μπορούμε να χρησιμοποιήσουμε την τελεία `.` και μετά το όνομα του αρχείου (δίχως την κατάληξη `.py`). Έπειτα κάνουμε import το όνομα του μοντέλου, δηλαδή της κλάσης (`Post`).
+
+Και μετά; Για να εξάγουμε τα posts από το μοντέλο `Post` χρειαζόμαστε κάτι που ονομάζεται `QuerySet`.
+
+## QuerySet
+
+Θα πρέπει να είστε ήδη εξοικειωμένοι με τον όρο QuerySet και πως αυτό λειτουργεί. Μιλήσαμε γι'αυτά στο κεφάλαιο [Django ORM (QuerySets)](../django_orm/README.md).
+
+Οπότε τώρα θέλουμε δημοσιευμένα posts ταξινομημένα κατά `published_date`, σωστά; Αυτό το κάναμε ήδη στο κεφάλαιο με τα QuerySets!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Επομένως, ας ανοίξουμε το αρχείο `blog/views.py` και ας προσθέσουμε αυτό το κομμάτι κώδικα στη συνάρτηση `def post_list(request)`. Αλλά μην παραλείψετε να προσθέσετε `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Παρακαλούμε σημειώστε ότι δημιουργούμε μια *μεταβλητή* για το QuerySet: `posts`. Μεταχειριστείτε τη ως το όνομα του QuerySet. Απο δω και στο εξής μπορούμε να αναφερόμαστε σε αυτό με το όνομα αυτό.
+
+Στη συνάρτηση `render` έχουμε μια παράμετρο `request` (οτιδήποτε λαμβάνουμε από το χρήστη μέσω του Internet) και άλλη μια ακόμα, εκείνη του αρχείου template (`'blog/post_list.html'`). Η τελευταία παράμετρος `{}`, είναι το σημείο που μπορούμε να προσθέσουμε πράγματα για να τα αξιοποιήσει το template. Χρειαζόμαστε να τους δώσουμε ονόματα (θα μείνουμε με το όνομα `'posts'`). :) Θα δείχνει κάπως έτσι: `{'posts': posts}`. Παρακαλούμε σημειώστε ότι το κομμάτι πριν το `:` είναι ένα string; πρέπει να το περικυκλώσετε με "αυτάκια": `''`.
+
+Εν τέλει, το αρχείο `blog/views.py` θα δείχνει κάπως έτσι:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+Αυτό ήταν! Ήρθε η ώρα να πάμε πίσω στο template και να εμφανίσουμε αυτό το QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/el-GR/extend_your_application/README.md b/el-GR/extend_your_application/README.md
new file mode 100644
index 00000000000..9e5d29aba40
--- /dev/null
+++ b/el-GR/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Επεκτείνετε την εφαρμογή σας
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Ώρα για εξάσκηση!
+
+Το πρώτο πράγμα που χρειαζόμαστε στο blog μας είναι, προφανώς, μια σελίδα για το εκάστοτε post (της οποίας η εμφάνιση θα είναι η ίδια για όλα post και το μόνο που θα αλλάζει θα είναι το περιεχόμενο), σωστά;
+
+Έχουμε ήδη ένα μοντέλο `Post`, έτσι δεν χρειάζεται να προσθέσετε τίποτα στο αρχείο `models.py`.
+
+## Δημιουργία ενός συνδέσμου template με τις λεπτομέρειες του post
+
+Θα ξεκινήσουμε με την προσθήκη ενός συνδέσμου στο αρχείο `blog/templates/blog/post_list.html`. Ανοίξτε το. Θα δείχνει κάπως έτσι: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}Θέλουμε να έχουμε έναν σύνδεσμο (link) για κάθε τίτλο του post μέσα στη λίστα ο οποίος όταν κλικάρετε να μεταβαίνει στη σελίδα λεπτομερειών του post. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Ώρα να εξηγήσουμε το μυστηριώδης `{% url 'post_detail' pk=post.pk %}`. Όπως υποψιάζεστε, το `{% %}` σημαίνει ότι χρησιμοποιούμε τα Django template tags. Αυτή τη φορά θα χρησιμοποιήσουμε ένα που δημιουργεί μια διεύθυνση URL για εμάς!{% endraw %}
+
+Το μέρος `post_detail` σημαίνει ότι θα πρέπει το Django θα περιμένει μια διεύθυνση URL με το όνομα αυτό στο αρχείο `blog/urls.py` με το όνομα=post_detail
+
+Τι γίνεται όμως με το `pk=post.pk`; `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Τώρα, όταν πάμε στη διεύθυνση http://127.0.0.1:8000 / θα εμφανιστεί σφάλμα (όπως ήταν αναμενόμενο, καθώς δεν έχουμε ακόμη διεύθυνση URL ή κάποιο *view* για το `post_detail`). Αυτό θα μοιάζει κάπως έτσι:
+
+![Σφάλμα NoReverseMatch](images/no_reverse_match2.png)
+
+## Δημιουργία ενός URL για τις λεπτομέρειες του post
+
+Ας δημιουργήσουμε μια διεύθυνση URL στο αρχείο `urls.py` για το `post_detail` *view* μας!
+
+Θέλουμε οι λεπτομέρειες του πρώτου μας post να εμφανίζονται σε αυτό το **URL**: http://127.0.0.1:8000/θέση/1 /
+
+Ας δημιουργήσουμε ένα URL μέσα στο αρχείο `blog/urls.py` που θα κατευθύνει το Django στο *view* με το όνομα `post_detail`, που με τη σειρά του θα δείξει ένα ολόκληρο blog post. Ανοίξτε το αρχείο `blog/urls.py` και προσθέστε τη γραμμή `path('post/<int:pk>/', views.post_detail, name='post_detail'),` έτσι ώστε το αρχείο να μοιάζει κάπως έτσι:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+Το μέρος `post/<int:pk>/` καθορίζει ένα URL μοτίβο. Θα σας το εξηγήσουμε:
+
+- Το μέρος `post/` σημαίνει ότι το URL θα πρέπει να ξεκινά με τη λέξη **post** ακολουθούμενο από μια κάθετο **/**. Μέχρι τώρα όλα καλά.
+- `<int:pk>` – Αυτό το μέρος είναι πιο δύσκολο. Σημαίνει ότι το Django περιμένει έναν ακέραιο όπου με την σειρά του θα το μεταφέρει ως παράμετρο με το όνομα `pk` στο αντίστοιχο view.
+- `/` – έπειτα χρειαζόματε άλλη μια κάθετο **/** πριν να κλείσει το URL.
+
+Αυτό σημαίνει ότι αν μεταβείτε στο `http://127.0.0.1:8000/post/5/` στον browser σας, το Django θα καταλάβει ότι ψάχνετε το *view* με το όνομα `post_detail` και θα μεταφέρει την πληροφορία του `pk` που ισούται με το `5` σε αυτό το *view*.
+
+Ωραία. Προσθέσαμε ένα νέο URL μοτίβο στο αρχείο `blog/urls.py`! Ας ανανεώσουμε τη σελίδα: http://127.0.0.1:8000/ Μπαμ! Ο server σταμάτησε να τρέχει ξανά. Ρίξτε μια ματιά στην κονσόλα. Όπως ήταν αναμενόμενο, υπάρχει ακόμα ένα σφάλμα!
+
+![AttributeError](images/attribute_error2.png)
+
+Θυμάστε το επόμενο βήμα; Προσθήκη ενός view!
+
+## Προσθήκη ενός view για τις λεπτομέρειες του post
+
+Αυτή τη φορά το *view* δέχεται μια έξτρα παράμετρο, το `pk`. Το *view* μας χρειάζεται με κάποιο τρόπο να αιχμαλωτίσει αυτή την παράμετρο, σωστά; Έτσι, λοιπόν, θα ορίσουμε την συνάρτηση μας ως `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Τώρα, θέλουμε να πάρουμε ένα και μόνο ένα post. Για να το κάνουμε αυτό, μπορούμε να χρησιμοποιήσουμε τα querysets, όπως παρακάτω:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Αλλά αυτός ο κώδικας έχει πρόβλημα. Αν δεν υπάρχει κάποιο `Post` με το δεδομένο `primary key` (`pk`) θα έχουμε ένα άσχημο σφάλμα!
+
+![Σφάλμα DoesNotExist](images/does_not_exist2.png)
+
+Δεν το θέλουμε αυτό! Αλλά ευτυχώς το Django περιλαμβάνει με κάτι που θα μας φανεί χρήσιμο: `get_object_or_404`. Σε αυτή την περίπτωση δεν υπάρχει κάποιο `Post` με αυτό το `pk`, θα εμφανίσει μια πολύ πιο όμορφη σελίδα, την σελίδα `Page Not Found 404`.
+
+![Page not found](images/404_2.png)
+
+Τα καλά νέα είναι ότι μπορείτε να δημιουργήσετε τη δική σας σελίδα `Page not found` και να την κάνετε όσο όμορφη θέλετε. Αλλά δεν είναι εξαιρετικά σημαντικό αυτή τη στιγμή, οπότε θα το παραλείψουμε τώρα.
+
+Ωραία, ώρα να προσθέσουμε ένα *view* στο αρχείο `views.py`!
+
+Στο αρχείο `blog/urls.py` δημιουργήσαμε ένα URL με το όνομα `post_detail`, που αναφέρεται σε ένα view με το όνομα `views.post_detail`. Αυτό σημαίνει ότι το Django θα περιμένει να υπάρχει μια συνάρτηση με το όνομα `post_detail` μέσα στο αρχείο `blog/views.py`.
+
+Ανοίξτε το αρχείο`blog/views.py` και προσθέστε τις ακόλουθες γραμμές μαζί με τις γραμμές `from`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+Και στο τέλος του αρχείου θα προσθέσουμε το *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Ναι. Ήρθε η ώρα να ανανεώσουμε τη σελίδα: http://127.0.0.1:8000/
+
+![view για την λίστα των post](images/post_list2.png)
+
+Δούλεψε! Αλλά τι συμβαίνει όταν κλικάρετε στον σύνδεσμο σε κάποιον τίτλο ενός post;
+
+![Σφάλμα TemplateDoesNotExist](images/template_does_not_exist2.png)
+
+Ω όχι! Άλλο ένα άλλο σφάλμα! Αλλά ήδη γνωρίζουμε πώς να το αντιμετωπίσουμε, έτσι; Πρέπει να προσθέσουμε ένα template!
+
+## Δημιουργία template για τις λεπτομέρειες του post
+
+Θα δημιουργήσoυμε ένα αρχείο μέσα στο φάκελο `blog/πρότυπα/blog` με το όνομα `post_detail.html`. Ανοίξτε το.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Για μια ακόμη φορά θα επεκτείνουμε το template `base.html`. Στο block`content` θέλουμε να εμφανίσουμε την ημ/νια έκδοσης του post (αν υπάρχει) τον τίτλο και το κυρίως κείμενο. Αλλά θα πρέπει να συζητήσουμε ορισμένα σημαντικά πράγματα, έτσι;
+
+{% raw %}`{% if ... %} ... {% endif %}` είναι ένα template tag που μας επιτρέπει να ελέγξουμε κάτι - με άλλα λόγια είναι μια συνθήκη. (Θυμάστε το `if ... else ..` από το κεφάλαιο **Εισαγωγή στην Python**?) Σε αυτό το σενάριο θέλουμε να δούμε αν το πεδίο `published_date` του post έχει κάποια τιμή.{% endraw %}
+
+Ωραία, μπορούμε να ανανεώσουμε τη σελίδα και να δούμε, για αρχή, αν το σφάλμα `TemplateDoesNotExist` έχει φύγει.
+
+![Σελίδα λεπτομέρειας του post](images/post_detail2.png)
+
+Ναι! Έφυγε!
+
+# Ώρα για deploy!
+
+Θα ήταν καλό να δούμε εάν η σελίδα σας εξακολουθεί να λειτουργεί στο PythonAnywhere, σωστά; Ας δοκιμάσουμε να το κάνουμε deploy ξανά.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Έπειτα, στην [κονσόλα Bash του PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Θυμηθείτε να αντικαταστήσετε με το `<your-pythonanywhere-domain>`πραγματικό όνομα χρήστη σας του PythonAnywhere χωρίς τα <>)
+
+## Ενημέρωση των στατικών αρχείων στο διακομιστή
+
+Οι διακομιστές όπως το PythonAnywhere τους αρέσει να διαχειρίζονται τα «στατικά αρχεία» (όπως τα αρχεία CSS) διαφορετικά από τα αρχεία της Python επειδή μπορεί να βελτιστοποιηθούν ούτως ώστε να φορτώνονται πιο γρήγορα. Ως αποτέλεσμα, κάθε φορά που μπορούμε να κάνουμε αλλαγές στα αρχεία CSS, θα πρέπει να εκτελούμε μια πρόσθετη εντολή στο διακομιστή η οποία του λέει να τα ενημερώσει. Η εντολή ονομάζεται `collectstatic`.
+
+Ξεκινήστε με το να ενεργοποιήσετε το virtualenv σας, αν δεν είναι ήδη ενεργό (το PythonAnywhere χρησιμοποιεί μια εντολή που ονομάζεται `workon` για να γίνει αυτό, είναι ακριβώς σαν την εντολή `source myenv/bin/activate` που χρησιμοποιείτε στον υπολογιστή σας):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+Η εντολή `manage.py collectstatic` είναι λίγο σαν την `manage.py migrate`. Κάνουμε κάποιες αλλαγές στον κώδικα και στη συνέχεια λέμε στο Django να *εφαρμόσει* αυτές τις αλλαγές είτε στον αντίστοιχο φάκελο στατικών αρχείων του server είτε στη βάση δεδομένων.
+
+Σε κάθε περίπτωση, είμαστε τώρα έτοιμοι να κλικάρουμε ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (από το κουμπί του μενού στην επάνω δεξιά μεριά της κονσόλας) και κλικάρουμε στο **Reload**. Δείτε τη σελίδα https://subdomain.pythonanywhere.com με το αποτέλεσμα.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/el-GR/how_the_internet_works/README.md b/el-GR/how_the_internet_works/README.md
new file mode 100644
index 00000000000..726bc1842a6
--- /dev/null
+++ b/el-GR/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Πως λειτουργεί το internet
+
+> Για τους αναγνώστες στο σπίτι: αυτή η ενότητα καλύπτεται στο βίντεο [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> Αυτό το κεφάλαιο είναι εμπνευσμένο από την ομιλία της Jessica McKellar με τίτλο "How the Internet works" (http://web.mit.edu/jesstess/www/).
+
+Στοιχηματίζουμε ότι δουλεύετε το Internet κάθε μέρα. Αλλά ξέρετε τι συμβαίνει όταν πληκτρολογείτε μια διεύθυνση όπως https://djangogirls.org στο browser σας και μετά πατήσετε `enter`;
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Οι web browsers σχεδιάστηκαν για να κατανοούν αυτό τον κώδικα, να ακολουθούν τις εντολές του και να παρουσιάζουν αυτά τα αρχεία από τα οποία είναι φτιαγμένα το website σας με τον τρόπο που εσείς θέλετε.
+
+Όπως με κάθε αρχείο, χρειαζόμαστε να αποθηκεύουμε τα HTML αρχεία κάπου στον σκληρό δίσκο. Για το Internet, χρησιμοποιούμε ειδικούς υπολογιστές γι'αυτό, με το όνομα *servers*. Δεν έχουν οθόνη, ποντίκι ή πληκτρολόγιο επειδή ο μοναδικός σκοπός τους είναι να αποθηκεύουν δεδομένα και να τα εξυπηρετούν. Γι' αυτό το λόγο ονομάζονται *εξυπηρετητές*. Επειδή *εξυπηρετούν την μεταφορά* δεδομένων.
+
+ΟΚ, αλλά θέλετε να μάθετε πως φαίνεται το Internet, σωστά;
+
+Ζωγραφίσαμε μια εικόνα! Φαίνεται κάπως έτσι:
+
+![Σχήμα 1.1](images/internet_1.png)
+
+Λίγο χαοτική, έτσι; Στην πραγματικότητα είναι ένα δίκτυο συνδεδεμένων συσκευών (των προαναφερομένων *servers*). Εκατοντάδες χιλιάδες συσκευές! Πολλά πολλά χιλιόμετρα καλωδίων γύρω από ολόκληρο τον κόσμο! Μπορείτε να επισκεφτείτε την ιστοσελίδα του Submarine Cable Map (http://submarinecablemap.com) και να δείτε πόσο περίπλοκο είναι το δίκτυο. Παρακάτω φαίνεται ένα στιγμιότυπο από το website:
+
+![Σχήμα 1.2](images/internet_3.png)
+
+Φανταστικό, έτσι; Αλλά δεν είναι δυνατόν να έχουμε καλώδια ανάμεσα σε κάθε ζευγάρι συσκευών που είναι συνδεδμένο στο Internet. Οπότε, για να συνδεθούμε με μία συσκευή (για παράδειγμα, αυτή που είναι αποθηκευμένο το site https://djangogirls.org) θα χρειαστεί να περάσουμε ένα αίτημα (request) μέσα από πολλές πολλές διαφορετικές συσκευές.
+
+Δείχνει κάπως έτσι:
+
+![Σχήμα 1.3](images/internet_2.png)
+
+Φανταστείτε ότι όταν πληκτρολογείτε https://djangogirls.org, στέλνετε ένα γράμμα που λέει: "Αγαπητά Django Girls, θα ήθελα να δω την σελίδα djangogirls.org. Στείλτε τη μου, παρακαλώ!"
+
+Το γράμμα σας πηγαίνει στο πλησιέστερο ταχυδρομικό γραφείο. Μετά το γράμμα σας πηγαίνει σε άλλο γραφείο που είναι πιο κοντά στον παραλήπτη, μετά σε άλλον κοκ μέχρις ότου φτάσει στον προορισμό του. Το μόνο μοναδικό πράγμα είναι ότι αν στέλνετε πολλά γράμματα (*data packets*) στο ίδιο σημείο, τότε ίσως φτάσουν στον προορισμό τους μέσα από διαφορετικές διαδρομές και ταχυδρομικά γραφεία (*routers*). Αυτό εξαρτάται από το πως είναι ταξινομημένα σε κάθε γραφείο.
+
+![Σχήμα 1.4](images/internet_4.png)
+
+Έτσι λειτουργεί. Μπορείτε να στείλετε μηνύματα και να περιμένετε κάποια απάντηση. Αντί για χαρτί και στυλό χρησιμοποιείτε byte δεδομένων αλλά η ιδέα είναι η ίδια!
+
+Αντί για διευθύνσεις με όνομα οδού, πόλη, ταχυδρομικό κώδικα και χώρα, χρησιμοποιούμε διευθύνσεις IP. Ο υπολογιστής σας ρωτά πρώτα το DNS (Domain Name System) για να μεταφραστεί η λέξη djangogirls.org σε μια διεύθυνση IP. Λειτουργεί λίγο σαν τους παλιούς τηλεφωνικούς καταλόγους όπου μπορείτε να αναζητήσετε το όνομα του ατόμου που θέλετε να επικοινωνήσετε και να βρείτε τον αριθμό τηλεφώνου και τη διεύθυνση τους.
+
+Όταν στέλνετε ένα γράμμα, πρέπει να έχει ορισμένα χαρακτηριστικά πρέπει για να παραδοθεί σωστά: μια διεύθυνση, μια σφραγίδα, κλπ. Χρησιμοποιείτε επίσης μια γλώσσα που κατανοεί ο παραλήπτης, σωστά; Το ίδιο ισχύει για τα *data packets* που μπορείτε να στείλετε για να δείτε μια ιστοσελίδα. Χρησιμοποιούμε ένα πρωτόκολλο που ονομάζεται HTTP (Hypertext Transfer Protocol).
+
+Έτσι, βασικά, όταν έχετε μια ιστοσελίδα, θα πρέπει να έχετε έναν *server* (συσκευή). Όταν ο *server* λαμβάνει μια εισερχόμενη *αίτηση* (σε ένα γράμμα), στέλνει πίσω την ιστοσελίδα σας (σε άλλη επιστολή).
+
+Δεδομένου ότι αυτό είναι ένας Django οδηγός, μπορείτε να ρωτήσετε τι κάνει Django. Όταν στέλνετε μια απάντηση, δεν θέλετε να στέλνετε την ίδια σε όλους. Είναι πολύ καλύτερα αν τα γράμματα είναι εξατομικευμένα, ειδικά για το πρόσωπο που έχει γράψει αποκλειστικά για εσάς, σωστά; Το Django, σας βοηθά με τη δημιουργία αυτών των εξατομικευμένων, ενδιαφέροντων γραμμάτων. :)
+
+Αρκετά μιλήσαμε. Πάμε να δημιουργήσουμε!
\ No newline at end of file
diff --git a/el-GR/html/README.md b/el-GR/html/README.md
new file mode 100644
index 00000000000..32de9f995f3
--- /dev/null
+++ b/el-GR/html/README.md
@@ -0,0 +1,227 @@
+# Εισαγωγή στην HTML
+
+Ίσως αναρρωτιέστε, τι είναι ένα template;
+
+Ένα template είναι ένα αρχείο που μπορούμε να επαναχρησιμοποιούμε για να παρουσιάζουμε διαφορετικές πληροφορίες μέσα από μια συνεπή μορφή. Για παράδειγμα, θα μπορούσατε να χρησιμοποιήσετε ένα πρότυπο (template) για να σας βοηθήσει να γράψετε μια επιστολή, γιατί αν και κάθε επιστολή μπορεί να περιέχει διαφορετικό μήνυμα και να απευθύνεται σε ένα διαφορετικό πρόσωπο, μερικά σημεία θα μοιραστούν την ίδια μορφή.
+
+Η μορφή ενός Django template περιγράφεται με μια γλώσσα που ονομάζεται HTML (που είναι η HTML που αναφέραμε στο πρώτο κεφάλαιο, **Πώς λειτουργεί το Internet**).
+
+## Τι είναι η HTML;
+
+Η HTML είναι ένας κώδικας που ερμηνεύεται από τον web browser σας – όπως ο Chrome, Firefox ή Safari - για να εμφανιστεί μια ιστοσελίδα στον χρήστη.
+
+HTML σημαίνει "HyperText Markup Language". Η λέξη **HyperText** σημαίνει ότι είναι ένας τύπος κειμένου που υποστηρίζει υπερ-συνδέσεις μεταξύ των σελιδών. **Markup** σημαίνει ότι έχουμε λάβει ένα έγγραφο και το έχουμε επισημάνει με κώδικα ούτως ώστε να πει κάτι (στην προκειμένη περίπτωση, ένας browser) πώς να ερμηνεύσει τη σελίδα. Ο HTML κώδικας είναι χτισμένος με **tags**, όπου καθένα αρχίζει με `<` και τελειώνει με `>`. Αυτά τα tags αντιπροσωπεύουν τα markup **elements**.
+
+## Το πρώτο σας template!
+
+H δημιουργία ενός template σημαίνει τη δημιουργία ενός αρχείου template. Τα πάντα είναι ένα αρχείο, σωστά; Πιθανώς να το έχετε παρατηρήσει αυτό.
+
+Τα templates αποθηκεύονται στο φάκελο `blog/templates/blog`. Άρα, πρώτα δημιουργήστε έναν φάκελο με το όνομα `templates` μέσα στον φάκελο blog. Στη συνέχεια, δημιουργήστε έναν άλλο φάκελο που ονομάζεται `blog` μέσα στον φάκελο templates:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(Ίσως να αναρωτηθείτε γιατί χρειαζόμαστε δύο φακέλους που και οι δύο ονομάζονται `blog`. Όπως θα ανακαλύψετε αργότερα, αυτό είναι μια τεχνική ονομασίας που κάνει τη ζωή ευκολότερη όταν τα πράγματα αρχίζουν να περιπλέκονται.)
+
+Και τώρα δημιουργήστε ένα αρχείο `post_list.html` (απλά αφήστε το κενό για τώρα) μέσα στον φάκελο `blog/templates/blog`.
+
+Δείτε πώς εμφανίζεται η ιστοσελίδα σας στο: http://127.0.0.1:8000 /
+
+> Αν παρουσιάζεται ακόμα το σφάλμα `TemplateDoesNotExist`, δοκιμάστε να επανεκκινήσετε τον server σας. Προσπαθήστε να τον σταματήσετε (πιέζοντας Ctrl + C) και επανεκκινήστε τον τρέχοντας την εντολή `python manage.py runserver`.
+
+![Σχήμα 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Ανοίξτε το νέο αρχείο και προσθέστε τα εξής:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+Οπότε πως φαίνεται τώρα η ιστοσελίδα μας; Επισκεφθείτε το για να μάθετε: http://127.0.0.1:8000/
+
+![Σχήμα 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head και body
+
+Κάθε σελίδα HTML χωρίζεται σε δύο στοιχεία: το **head** και το **body**.
+
+* To **head** είναι ένα στοιχείο (element) που περιέχει πληροφορίες σχετικά με το έγγραφο αλλά αυτές οι πληροφορίες δεν εμφανίζονται στην οθόνη.
+
+* Το **body** είναι ένα στοιχείο που περιέχει όλα τα υπόλοιπα που εμφανίζονται ως μέρος της ιστοσελίδας.
+
+Χρησιμοποιούμε το tag `<head>`για να πούμε στον browser σχετικά με τη διαμόρφωση της σελίδας και το tag `<body>` για να πούμε για το περιεχόμενο της.
+
+Για παράδειγμα, μπορείτε να προσθέσετε τίτλο στην ιστοσελίδα σας μέσα από το tag `<head>`, όπως παρακάτω:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Αποθηκεύστε το αρχείο και ανανέωστε την σελίδα σας.
+
+![Σχήμα 11.3](images/step4.png)
+
+Παρατηρήσατε πως ο browser κατάλαβε το "Ola's blog" ως τίτλο για την σελίδα σας; Ερμήνευσε το κείμενο `<title>Ola's blog</title>` και το τοποθέτησε στην μπάρα τίτλων του browser σας (το ίδιο κείμενο θα λειτουργήσει και ως όνομα σελιδοδείκτη κλπ).
+
+Πιθανώς να έχετε παρατηρήσει ότι κάθε tag αντιστοιχίζεται με ένα *tag κλεισίματος*, με μια κάθετο `/` και ότι τα στοιχεία είναι *ένθετα* (δηλαδή δεν μπορείτε να κλείσετε μια συγκεκριμένη ετικέτα μέχρι να έχουν κλείσει όλα αυτά που ήταν μέσα σε αυτό).
+
+Είναι σαν να βάζουμε πράγματα μέσα σε κουτιά. Έχετε ένα μεγάλο κουτί, `<html></html>`. Στο εσωτερικό του υπάρχει το `<body></body>` το οποίο με τη σειρά του περιέχει ακόμα μικρότερα κουτιά: `<p></p>`.
+
+Θα πρέπει να ακολουθείτε αυτούς τους κανόνες *κλεισίματος ετικέτας* και *"φωλιάσματος"* των elements. Αν δεν το κάνετε, ο browser ενδέχεται να μην μπορεί να τα ερμηνεύσει ορθά και η σελίδα να μην εμφανίζεται σωστά.
+
+## Παραμετροποιώντας το template
+
+Μπορείτε, τώρα, να διασκεδάσετε λιγάκι και να τροποιήσετε το template σας! Παρακάτω παρουσιάζονται μερικά χρήσιμα tags γι'αυτό:
+
+* `<h1>A heading</h1>` για επικεφαλίδες
+* `<h2>A sub-heading</h2>` για επικεφαλίδες χαμηλότερου επιπέδου
+* `<h3>A sub-sub-heading</h3>` …κοκ μέχρι την `<h6>`
+* `<p>Μια παράγραφος κειμένου</p>`
+* `<em>text</em>` δίνει έμφαση στο κείμενο σας
+* `<strong>text</strong>` κάνει τα γράμματα πιο έντονα
+* `<br>` αλλάζει γραμμή (δεν μπορείτε να βάλετε τίποτα ανάμεσα και δεν υπάρχει αντίστοιχο tag που να το κλείνει)
+* `<a href="https://djangogirls.org">link</a>` δημιουργεί έναν σύνδεσμο
+* `<ul><li>first item</li><li>second item</li></ul>` δημιουργεί μια λίστα, όπως αυτή εδώ που διαβάζετε τώρα!
+* `<div></div>` ορίζει ένα τμήμα στη σελίδα
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Παρακάτω φαίνεται ένα πλήρες παράδειγμα ενός template. Αντιγράψτε-επικολλήστε το μέσα στο αρχείο `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Δίνει αυτή την αίσθηση:
+
+![Σχήμα 11.4](images/step6.png)
+
+Ναιιι! Αλλά μέχρι στιγμής, το template μας εμφανίζει **τις ίδιες πληροφορίες** – ενώ προηγουμένως μιλούσαμε για templates που μας επέτρεπαν να εμφανίσουμε **διαφορετικές/δυναμικές** πληροφορίες με την **ίδια μορφή**.
+
+Αυτό που θέλουμε να κάνουμε είναι να εμφανίσουμε πραγματικά posts τα οποία θα τα προσθέτουμε μέσω του Django admin. Και αυτό ακριβώς θα κάνουμε μετά.
+
+## Ένα πράγμα ακόμα: ώρα να το ανεβάσετε!
+
+Θα ήταν καλό να το δούμε όλο αυτό στο internet, σωστά; Ας κάνουμε άλλο ένα deploy στο PythonAnywhere:
+
+### Κάντε commit και έπειτα push τον κώδικα σας στο GitHub
+
+Πρώτ'απ'όλα ας δούμε ποια αρχεία έχουν αλλάξει από την τελευταία φορά που κάναμε deploy (τρέξτε αυτές τις εντολές τοπικά, όχι στο PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Σιγουρευτείτε ότι βρίσκεστε μέσα στο φάκελο `djangogirls` και ας πούμε στο `git` να συμπεριλάβει όλες τις αλλαγές μέσα σε αυτό το φάκελο:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Πριν ανεβάσουμε όλα τα αρχεία, ας δούμε τι επρόκειτο να ανεβάσει το `git` (όλα τα αρχεία που επρόκειτο να ανεβούν από το `git` θα εμφανίζονται με πράσινο χρώμα):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Σχεδόν φτάσαμε. Τώρα είναι η ώρα να του πούμε να αποθηκεύσει αυτή την αλλαγή στο ιστορικό του. Θα του δώσουμε ένα "commit message" όπου θα περιγράψουμε τι άλλαξε. Μπορείτε να γράψετε ότι θέλετε σε αυτό το σημείο αλλά είναι χρήσιμο να γράψετε κάτι περιγραφικό ούτως ώστε να το θυμάστε στο μέλλον.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Μόλις τελειώσουμε με αυτό, θα ανεβάσουμε (push) τις αλλαγές μας στο GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Κάντε pull τον νέο σας κώδικα στο PythonAnywhere και ανανεώστε την εφαρμογή
+
+* Έπειτα συνδεθείτε στο [PythonAnywhere](https://www.pythonanywhere.com/consoles/), μεταβείτε στο **Bash console** (ή ανοίξτε ένα νέο) και τρέξτε:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. Αν θέλετε να δείτε ότι ολοκληρώθηκε, μεταβείτε στη σελίδα **"Files" page** και δείτε τον κώδικα σας στο PythonAnywhere (μπορείτε να ανοίξετε και άλλες σελίδες του PythonAnywhere από το κουμπί του μενού στην σελίδα της κονσόλας).
+
+* Τέλος, πηγαίνετε στο ["Web" page](https://www.pythonanywhere.com/web_app_setup/) και κλικάρετε **Reload** στην εφαρμογή σας.
+
+Οι αλλαγές θα πρέπει να είναι ορατές τώρα! Πηγαίνετε και ανανεώστε τη σελίδα στον browser σας. :)
\ No newline at end of file
diff --git a/el-GR/installation/README.md b/el-GR/installation/README.md
new file mode 100644
index 00000000000..6ea2876af00
--- /dev/null
+++ b/el-GR/installation/README.md
@@ -0,0 +1,68 @@
+# Για σένα που κάνεις το tutorial από το σπίτι
+
+Αν κάνεις το tutorial στο σπίτι και όχι στο πλαίσιο ενός από τα [Django Girls events](https://djangogirls.org/events/), μπορείς να αγνοήσεις εντελώς αυτό το κεφάλαιο και να πας κατευθείαν στο κεφάλαιο [Πώς δουλεύει το internet](../how_the_internet_works/README.md).
+
+Αυτό οφείλεται στο γεγονός ότι καλύπτουμε γνωστικά ένα αντικείμενο καθώς το συναντάμε και όχι όλα μαζεμένα. Αυτή είναι μια σελίδα που συγκεντρώνει όλες τις οδηγίες εγκατάστασης σε ένα μέρος (το οποίο είναι χρήσιμο για ορισμένες μορφές των εργαστηρίων). Μπορείτε να διαλέξετε να τα εγκαταστήσετε όλα όσα είναι σε αυτή τη σελίδα αν θέλετε. Αλλά αν θέλετε να μαθαίνετε πράγματα καθώς εγκαθιστάτε πράγματα στον υπολογιστή σας, αγνοήστε αυτό το κεφάλαιο και θα εξηγήσουμε τη διαδικασία εγκατάστασης διαφόρων εργαλείων καθώς τα συναντάμε μπροστά μας.
+
+Καλή τύχη!
+
+# Αν παρακαλουθείτε ένα εργαστήριο
+
+Εάν παρακολουθείτε ένα από τα [Django Girls events](https://djangogirls.org/events/):
+
+* Το εργαστήριο μπορεί να έχει μια "ομάδα εγκατάστασης" πριν το κυρίως εργαστήριο. Αν ανήκετε στην ομάδα εγκατάστασης, τότε αυτή η σελίδα είναι για εσάς! Ακολουθήστε τις οδηγίες εδώ, για να έχετε όλα όσα χρειάζεστε για το εργαστήριο εγκατεστημένα, με τη βοήθεια των βοηθών αν χρειαστεί. Στη συνέχεια, στο κυρίως εργαστήριο, θα είστε σε θέση να παρακάμψετε τις οδηγίες εγκατάστασης που θα συναντήσετε στον οδηγό.
+* Μπορεί να σας έχουν ζητήσει οι διοργανωτές του εργαστηρίου να δοκιμάσετε στο σπίτι να εγκαταστήσετε τα πάντα στον υπολογιστή σας, πριν ξεκινήσει το εργαστήρι. Εάν σας έχει ζητηθεί να το κάνετε αυτό, η σελίδα αυτή είναι για εσάς! Ακολουθήστε τις οδηγίες εδώ, όσο καλύτερα μπορείτε. Στη συνέχεια, στο κυρίως εργαστήριο, όταν φτάνετε σε ένα βήμα εγκατάσταση στον οδηγό, αν δεν έχει συμπεριληφθεί από εμάς μπορείτε να λάβετε βοήθεια από το λεωφορείο.
+* Αν το εργαστήριο σας δεν έχει ομάδα εγκατάστασης (ή δεν μπορούσατε να παρευρεθείτε) και οι διοργανωτές δεν σας ζήτησαν να εγκαταστήσετε όσα χρειάζεται πριν φτάσετε, αγνοήστε αυτή τη σελίδα και πηγαίνετε στον κεφάλαιο [Πως δουλεύει το internet](../how_the_internet_works/README.md). Θα εγκαθιστάτε οτιδήποτε χρειάζεται καθώς το συναντάτε στον οδηγό.
+
+# Εγκατάσταση
+
+Σε αυτό τον οδηγό θα φτιάξουμε ένα blog. Για να το κάνουμε αυτό, καθώς προχωράμε θα σας ζητηθεί να εγκαταστήσετε διάφορα προγράμματα στον υπολογιστή σας και να δημιουργήσετε μερικούς λογαριασμούς. Αυτή η σελίδα συγκεντρώνει όλες τις εγκαταστάσεις και τις δημιουργίες λογαριασμών σε ένα μέρος (το οποίο είναι χρήσιμο για μερικούς τύπους εργαστηρίων).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [Πως λειτουργεί το internet](../how_the_internet_works/README.md)
+
+* [Εισαγωγή στην γραμμή εντολών](../intro_to_command_line/README.md)
+
+* [Εισαγωγή στην Python](../python_introduction/README.md)
+
+* [Τι είναι το Django;](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/el-GR/intro_to_command_line/README.md b/el-GR/intro_to_command_line/README.md
new file mode 100644
index 00000000000..99132d95208
--- /dev/null
+++ b/el-GR/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Εισαγωγή στην γραμμή εντολών
+
+> Για τους αναγνώστες στο σπίτι: αυτή η ενότητα καλύπτεται στο βίντεο [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+Είναι φοβερό έτσι; Θα γράψετε την πρώτη γραμμή κώδικα σε μερικά λεπτά! :)
+
+**Αφήστε μας να σας παρουσιάσουμε το νέο σας φίλο πρώτα: τη γραμμή εντολών!**
+
+Τα επόμενα βήματα θα σας δείξουν πώς να χρησιμοποιήσετε το μαύρο παράθυρο που όλοι οι χάκερ χρησιμοποιούν. Αυτό μπορεί να μοιάζει λίγο τρομακτικό στην αρχή αλλά πραγματικά αυτό είναι απλά ένα prompt σε αναμονή για εντολές από εσάς.
+
+> **Σημείωση** Παρακαλούμε να σημειώσετε ότι σε όλο το βιβλίο αυτό χρησιμοποιούμε το τους όρους «φάκελος» και «κατάλογος» αλλά στην ουσία είναι το ίδιο πράγμα.
+
+## Τι είναι η γραμμή εντολών;
+
+Το παράθυρο, το οποίο συνήθως ονομάζεται **γραμμή εντολών** ή **περιβάλλον γραμμής εντολών**, είναι μια εφαρμογή που βασίζεται σε κείμενο για προβολή, διαχείριση και χειρισμό αρχείων στον υπολογιστή σας. Είναι κάπως σαν το Windows Explorer ή το Finder στα Mac αλλά χωρίς το γραφικό κομμάτι (κουμπιά, βελάκια, σχήματα κλπ). Άλλα ονόματα για την γραμμή εντολών είναι: *cmd*, *CLI*, *prompt*, *console* ή *terminal*.
+
+## Άνοιγμα της γραμμής εντολών
+
+Για να πειραματιστείτε πρέπει πρώτα να ανοίξετε μια γραμμή εντολών (ή κονσόλα, πιο σύντομα).
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Η πρώτη σας εντολή (ΝΑΙ!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Βασικά
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Παρόν φάκελος
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Μάθετε περισσότερα σχετικά με μια εντολή
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### Προβολή αρχείων και φακέλων
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Αλλαγή του τρέχοντος φακέλου
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Δημιουργία φακέλου
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Εξασκηθείτε!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Λύση:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Διαγραφή
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Έξοδος
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Περίληψη
+
+Here is a summary of some useful commands:
+
+| Εντολή (Windows) | Εντολή (Mac OS / Linux) | Περιγραφή                              | Παράδειγμα                                        |
+| ---------------- | ----------------------- | -------------------------------------- | ------------------------------------------------- |
+| exit             | exit                    | κλείσιμο παραθύρου                     | **exit**                                          |
+| cd               | cd                      | αλλαγή φακέλου                         | **cd test**                                       |
+| cd               | pwd                     | προβολή τρέχοντος φακέλου              | **cd** (Windows) ή **pwd** (Mac OS / Linux)       |
+| dir              | ls                      | προβολή λίστας φακέλων/αρχείων         | **dir**                                           |
+| copy             | cp                      | αντιγραφή αρχείου                      | **copy c:\test\test.txt c:\windows\test.txt** |
+| move             | mv                      | μετακίνηση/μετονομασία αρχείου/φακέλου | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir            | mkdir                   | δημιουργία φακέλου                     | **mkdir testdirectory**                           |
+| rmdir (ή del)    | rm                      | διαγραφή αρχείου                       | **del c:\test\test.txt**                        |
+| rmdir /S         | rm -r                   | διαγραφή φακέλου                       | **rm -r testdirectory**                           |
+| [CMD] /?         | man [CMD]               | προβολή βοήθειας για μια εντολή        | **cd /?** (Windows) ή **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Είστε έτοιμοι;
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/el-GR/intro_to_command_line/open_instructions.md b/el-GR/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..95a4ec5db81
--- /dev/null
+++ b/el-GR/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Ανάλογα με την έκδοση των Windows και το πληκτρολόγιό σας, μια από τις παρακάτω επιλογές ανοίγει ένα παράθυρο εντολών (ίσως χρειαστεί να πειραματιστείτε λίγο, αλλά δεν χρειάζεται να δοκιμάσετε όλες αυτές τις προτάσεις):
+
+- Μεταβείτε στο μενού "Έναρξη" ή στην οθόνη και πληκτρολογήστε "Command Prompt" ("γραμμή εντολών") στο πεδίο αναζήτησης.
+- Πηγαίνετε στο Start menu → Windows System → Command Prompt.
+- Πηγαίνετε στο Start menu → All Programs → Accessories → Command Prompt.
+- Μεταβείτε στην οθόνη έναρξης (Start screen), τοποθετήστε το δείκτη του ποντικιού στην κάτω αριστερή γωνία της οθόνης και κάντε κλικ στο κάτω βέλος που εμφανίζεται (σε μια οθόνη αφής, μετακινείστε το δάχτυλο σας από το κάτω μέρος της οθόνης προς τα επάνω). Η σελίδα "εφαρμογές" (Apps) πρέπει να ανοίξει. Κάντε κλικ στη γραμμή εντολών στην ενότητα Σύστημα των Windows (Windows System).
+- Κρατήστε πατημένο το ειδικό πλήκτρο των Windows στο πληκτρολόγιό σας και πατήστε το πλήκτρο "X". Επιλέξτε "γραμμή εντολών" ("Command Prompt") από το αναδυόμενο μενού.
+- Κρατήστε πατημένο το πλήκτρο Windows και πατήστε το πλήκτρο "R" για να εμφανιστεί το παράθυρο "εκτέλεση" ("Run"). Πληκτρολογήστε "cmd" στο πλαίσιο και πατήστε το κουμπί ΟΚ.
+
+![Πληκτρολογήστε "cmd" στο παράθυρο "Run"](../python_installation/images/windows-plus-r.png)
+
+Αργότερα σε αυτό το tutorial, θα χρειαστεί να έχετε δύο παράθυρα εντολών ανοιχτά την ίδια στιγμή. Ωστόσο, σε ορισμένες εκδόσεις των Windows, αν έχετε ήδη ανοίξει ένα παράθυρο εντολών και προσπαθήσετε να ανοίξετε ένα δεύτερο χρησιμοποιώντας την ίδια μέθοδο, θα οδηγηθείτε στο παράθυρο εντολών που έχετε ήδη ανοίξει. Δοκιμάστε το τώρα στον υπολογιστή σας και δείτε τι συμβαίνει! Εάν σας ανοίξει μόνο ένα παράθυρο εντολών, δοκιμάστε μία από τις άλλες μεθόδους της παραπάνω λίστας. Τουλάχιστον μία από αυτές θα πρέπει να οδηγήσει σε άνοιγμα ενός νέου παραθύρου εντολών.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Πηγαίνετε στο Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Το πιο πιθανό να βρίσκεται στο Applications → Accessories → Terminal, or Applications → System → Terminal αλλά εξαρτάται και από το σύστημα. Αν δεν βρίσκεται εκεί, δοκιμάστε να ψάξετε στο Google. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/el-GR/python_installation/README.md b/el-GR/python_installation/README.md
new file mode 100644
index 00000000000..f085cc8cd00
--- /dev/null
+++ b/el-GR/python_installation/README.md
@@ -0,0 +1,15 @@
+# Ας ξεκινήσουμε με την Python
+
+Είμαστε επιτέλους εδώ!
+
+Αλλά πρώτα θα θέλαμε να σας εξηγήσουμε τι είναι η Python. Η Python είναι μια πολύ δημοφιλής γλώσσα προγραμματισμού η οποία μπορεί να χρησιμοποιηθεί σε πολλούς τομείς όπως δημιουργία ιστοσελίδων, παιχνίδια, επιστημονικό λογισμικό, γραφικά και πολλά πολλά άλλα.
+
+Η Python δημιουργήθηκε στα τέλη της δεκαετίας του 1980 και ο κύριος σκοπός της είναι να είναι ευανάγνωστη από ανθρώπους (και όχι από μηχανές!). Γι'αυτό το λόγο φαίνεται απλούστερη από άλλες γλώσσες προγραμματισμού, αλλά μην ανησυχείτε. Η Python είναι πραγματικά δυνατή!
+
+# Εγκατάσταση Python
+
+> **Σημείωση** Αν χρησιμοποιείτε Chromebook, μεταβείτε στο κεφάλαιο [Εγκατάσταση Chromebook](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/el-GR/python_installation/instructions.md b/el-GR/python_installation/instructions.md
new file mode 100644
index 00000000000..59dacebabc1
--- /dev/null
+++ b/el-GR/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Για τους αναγνώστες στο σπίτι: αυτό το κεφάλαιο καλύπτεται στο βίντεο [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> Αυτή η ενότητα βασίζεται σε tutorials από tην κοινότητα Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Το Django είναι γραμμένο σε Python. Χρειαζόμαστε την Python για να κάνουμε το οτιδήποτε στο Django. Ακόμη και να το εγκαταστήσουμε. Ας ξεκινήσουμε εγκαθιστώντας την Python! Θέλουμε να εγκαταστήσετε την τελευταία έκδοση της Python 3. Αν έχετε κάποια παλαιότερη έκδοση θα θέλαμε να την αναβαθμίσετε. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Πιέστε το κουμπί των Windows (δίπλα από το αριστερό Alt) και το Pause/Break ταυτόχρονα.
+* Ανοίξτε τον πίνακα ελέγχου (Control Panel) από το Windows μενού και περιηγηθείτε στο System & Security, έπειτα επιλέξτε System
+* Πιέστε το πλήκτρο των Windows και έπειτα περιηγηθείτε στο Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Κατεβάστε το αρχείο *Mac OS X 64-bit/32-bit installer*,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/el-GR/python_introduction/README.md b/el-GR/python_introduction/README.md
new file mode 100644
index 00000000000..f0f1f532da0
--- /dev/null
+++ b/el-GR/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Εισαγωγή στην Python
+
+> Μέρος αυτού του κεφαλαίου είναι βασισμένο στους οδηγούς από την κοινότητα Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Ας γράψουμε λίγο κώδικα!
+
+## Παράθυρο εντολών Python
+
+> Για τους αναγνώστες στο σπίτι: αυτό το μέρος που καλύπτεται από το βίντεο [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U).
+
+Για να αρχίσετε να παίζετε με την Python, πρέπει να ανοίξετε μια *γραμμή εντολών* στον υπολογιστή σας. Πρέπει ήδη να ξέρετε πως το κάνουμε αυτό. Το μάθαμε στο κεφάλαιο [Εισαγωγή στη γραμμή εντολών](../intro_to_command_line/README.md).
+
+Μόλις είστε έτοιμοι, ακολουθήστε τις παρακάτω οδηγίες.
+
+Θέλουμε να ανοίξουμε μια κονσόλα Python. Πληκτρολογήστε `python` αν είστε σε Windows ή `python3` αν είστε σε Mac OS/Linux και πατήστε `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Η πρώτη σας Python εντολή!
+
+Αφού εκτελέσετε την εντολή Python, το prompt θα αλλάξει σε `>>>`. Για εμάς αυτό σημαίνει ότι τώρα μπορεί να χρησιμοποιούμε μόνο εντολές για τη γλώσσα Python. Δεν χρειάζεται να πληκτρολογήσετε `>>>`. Θα το κάνει η Python για σας.
+
+Εάν θέλετε να τερματίσετε την κονσόλα Python σε οποιοδήποτε σημείο, απλά πληκτρολόγηστε `exit()` ή `Ctrl + Z` για Windows και `Ctrl + D` για Mac/Linux. Τότε δεν θα μπορείτε να δείτε το `>>>` πια.
+
+Για τώρα δεν θέλουμε να φύγουμε από αυτό το περιβάλλον. Θέλουμε να μάθουμε περισσότερα γι'αυτό. Ας ξεκινήσουμε να γράφουμε μερικές μαθηματικές πράξεις, όπως `2 + 3` και μετά πατάμε `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Ωραία! Είδατε την απάντηση από κάτω; Η Python ξέρει μαθηματικά! Μπορείτε να δοκιμάσετε και άλλες εντολές, όπως:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Για να εκτελέσετε εκθετικούς υπολογισμούς, πχ 2 στη δύναμη του 3, γράφουμε: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Διασκέδασε με αυτό για λίγο και στη συνέχεια συνεχίστε πίσω εδώ. :)
+
+Όπως μπορείτε να δείτε, η Python είναι μια πολύ καλή αριθμομηχανή. Αν αναρωτιέστε τι άλλο μπορείτε να κάνετε…
+
+## Strings
+
+Τι θα λέγατε για το όνομα σας; Πληκτρολογήστε το μικρό σας όνομα μέσα σε "αυτάκια", όπως παρακάτω:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+"Ola"
+```
+
+Μόλις δημιουργήσατε το πρώτο σας string! Είναι μια ακολουθία χαρακτήρων η οποία επεξεργάζεται από τον υπολογιστή. Ένα string πρέπει πάντα να ξεκινά και να τελειώνει με τον ίδιο χαρακτήρα. Αυτό μπορεί να είναι είτε μονά "αυτάκια" (`'`) ή διπλά (`"`) (καμία διαφορά!). Τα "αυτάκια" λένε στην Python το εξής: ότι υπάρχει ανάμεσα θεώρησε το ως ένα string.
+
+Τα strings μπορούν να ενωθούν. Δοκιμάστε το ακόλουθο:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+"Hi there Ola"
+```
+
+Μπορείτε επίσης να πολλαπλασιάσετε strings με αριθμό:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Αν χρειαστεί να βάλετε κάποια απόστροφο μέσα στο string, υπάρχουν δύο τρόποι να το κάνετε.
+
+Χρησιμοποιώντας διπλά "αυτάκια":
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+ή κάνοντας escape την απόστροφο με ένα backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Ωραίο εε; Για να δείτε το όνομα σας σε κεφαλαία, γράψτε:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Μόλις χρησιμοποιήσατε την `upper` **method** πάνω στο string σας! Η μέθοδος (όπως η `upper()`) είναι μια ακολουθία από οδηγίες/εντολές που η Python πρέπει να εκτελέσει πάνω σε ένα συγκεκριμένο object (`"Ola"`) μόλις την καλέσετε.
+
+Αν θέλετε να μάθετε τον αριθμό των γραμμάτων που περιέχονται στο όνομα σας, υπάρχει συνάρτηση **function** και γι'αυτό!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Αναρρωτιέστε γιατί μερικές φορές καλείτε συναρτήσεις με την τελεία `.` στο τέλος ενός string (όπως `"Ola".upper()`) και άλλες καλείτε μια συνάρτηση και τοποθετείτε μέσα στις παρενθέσεις το string; Λοιπόν, σε κάποια σημεία οι συναρτήσεις ανήκουν σε objects, όπως η `upper()` η οποία επιδρά μόνο πάνω σε strings. Σε αυτή την περίπτωση, ονομάζουμε τις συναρτήσεις αυτές μεθόδους (**method**). Άλλες, πάλι, φορές οι συναρτήσεις δεν ανήκουν σε κάτι συγκεκριμένο και μπορούν να χρησιμοποιηθούν σε οποιουδήποτε τύπου object, όπως η `len()`. Γι'αυτό δίνουμε το string `"Ola"` ως παράμετρο στη συνάρτηση `len`.
+
+### Περίληψη
+
+Αρκετά με τα strings. Μέχρι τώρα μάθατε:
+
+- **το prompt** – γράφοντας εντολές (κώδικα) μέσα σε περειβάλλον της Python έχει ως αποτέλεσμα να παίρνετε απαντήσεις από την Python
+- **αριθμούς και strings** – στην Python οι αριθμοί χρησιμοποιούνται για μαθηματικά και τα strings για χαρακτήρες
+- **operators** – όπως `+` και `*`, συνδυάζουν τιμές και παράγουν μια νέα τιμή
+- **functions** – όπως η `upper()` και η `len()`, εκτελούν κάποιες ενέργειες στα objects.
+
+Αυτά είναι τα βασικά για κάθε γλώσσα προγραμματισμού. Είστε έτοιμοι για κάτι πιο δύσκολο; Είμαστε σίγουροι ότι είστε!
+
+## Σφάλματα
+
+Ας δοκιμάσουμε κάτι καινούργιο. Μπορούμε να βρούμε το μήκος ενός αριθμού ακριβώς όπως κάναμε με το όνομα σας νωρίτερα; Πληκτρολογήστε `len(304023)` και πατήστε `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Μόλις λάβατε το πρώτο σας σφάλμα! Το εικονίδιο {{ warning_icon }} είναι ο δικός μας τρόπος να σας πούμε ότι ο κώδικάς που πρόκειται να τρέξετε δεν θα έχει τα αναμενόμενα αποτελέσματα. Κάνοντας λάθη (ακόμα και εσκεμμένα) είναι σημαντικό κομμάτι κατά τη διάρκεια της εκμάθησης!
+
+Το συγκεκριμένο σφάλμα λέει ότι τα objects τύπου "int" (από τη λέξη integers, που σημαίνει ακέραιοι αριθμοί) δεν έχουν μήκος. Οπότε τι κάνουμε τώρα; Μήπως να γράψουμε τον αριθμό ως ένα string; Τα strings έχουν μήκος, έτσι;
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Δούλεψε! Χρησιμοποιήσαμε τη συνάρτηση `str` μέσα στην `len`. Η `str()` μετατρέπει τα πάντα σε strings.
+
+- Η συνάρτηση `str` μετατρέπει πράγματα σε **strings**
+- Η συνάρτηση `int` μετατρέπει πράγματα σε **integers**
+
+> Σημαντικό: μπορούμε να μετατρέψουμε αριθμούς σε κείμενο (strings) αλλά όχι απαραίτητα το αντίστροφο. Τι θα συνέβαινε αν τρέχατε `int('hello')`;
+
+## Μεταβλητές
+
+Ένα σημαντικό έννοια στον προγραμματισμό είναι οι μεταβλητές. Μια μεταβλητή δεν είναι τίποτε άλλο από ένα όνομα που μπορεί να επαναχρησιμοποιηθεί αργότερα. Οι προγραμματιστές χρησιμοποιούν τις μεταβλητές για την αποθήκευση δεδομένων, κάνοντας τον κώδικα πιο ευανάγνωστο χωρίς να χρειάζεται να θυμούνται τι ήταν τι.
+
+Ας υποθέσουμε ότι θέλετε να δημιουργήσετε μια μεταβλητή με το όνομα `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+Γράφουμε name ίσον με Ola.
+
+Όπως θα παρατηρήσατε, το πρόγραμμα δεν επέστρεψε τίποτα όπως πριν. Πως ξέρουμε, λοιπόν, ότι η μεταβλητή υπάρχει; Πληκτρολογήστε`name` και μετά πιέστε `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Ναιιι! Η πρώτη σας μεταβλητή! :) Μπορείτε πάντα να αλλάξετε την τιμή αυτής της μεταβλητής:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+Μπορείτε να χρησιμοποιήσετε μεταβλητές σε συναρτήσεις:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Φοβερό, έτσι; Οι μεταβλητές μπορεί να είναι οτιδήποτε (ακόμα και αριθμοί). Δοκιμάστε το εξής:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Αλλά τι θα γινόταν αν χρησιμοποιούσαμε λάθος όνομα; Τι θα συμβεί; Ας το δοκιμάσουμε!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Ένα σφάλμα! Όπως μπορείτε να δείτε, η Python έχει διαφορετικού τύπου σφάλματα (τα έχει κατατάξει σε κατηγορίες). Αυτό εδώ ονομάζεται **NameError**. Η Python θα σας εμφανίσει αυτό το σφάλμα αν προσπαθήσετε να χρησιμοποιήσετε κάποια μεταβλητή της οποίας το όνομα δεν έχει δηλωθεί. Αν εμφανίστηκε αυτό το σφάλμα νωρίτερα σε εσάς, δείτε τον κώδικά σας μήπως και έχετε κάνει λάθος σε κάποιο όνομα μεταβλητής.
+
+Παίξτε για λίγο με αυτό και δείτε τι μπορείτε να κάνετε!
+
+## Η συνάρτηση print
+
+Δοκιμάστε αυτό:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Όταν απλώς πληκτρολογείτε `name`, η Python ανταποκρίνεται με το λεγόμενο string *representation* της τιμής της μεταβλητής 'name', η οποία είναι τα γράμματα M-a-r-i-a, περικυκλωμένα με τα μονά "αυτάκια", ''. Όταν λέτε `print(name)`, η Python θα "εκτυπώσει στην οθόνη" τα περιεχόμενα της μεταβλητής, χωρίς τα "αυτάκια", κάτι το οποίο είναι πιο ωραίο.
+
+Όπως θα δούμε και αργότερα, η συνάρτηση `print()` είναι χρήσιμη όταν θέλουμε να εκτυπώσουμε πράγματα μέσα σε συναρτήσεις ή όταν θέλουμε να εκτυπώσουμε πράγματα σε πολλαπλές γραμμές αντί μιας.
+
+## Λίστες
+
+Πέρα από τα strings και τους αριθμούς, η Python προσφέρει αρκετά ακόμα διαφορετικούς τύπους objects. Παρακάωτ θα περιγράψουμε αυτό που αποκαλούμε λίστα (**list**). Οι λίστες είναι αυτό που φαντάζεστε: objects τα οποία είναι λίστες άλλων objects. :)
+
+Πηγαίνετε και δημιουργήστε μια λίστα:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Ναι, αυτή είναι μια κενή λίστα. Όχι πολύ χρήσιμη έτσι; Ας δημιουργήσουμε μια λίστα με αριθμούς. Δεν θέλουμε να επαναλαμβανόμαστε όλη την ώρα, οπότε θα βάλουμε τη λίστα μέσα σε μια μεταβλητή:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+Τέλεια, έχουμε μια λίστα! Τι μπορούμε να κάνουμε με αυτή; Ας δούμε πόσοι αριθμοί υπάρχουν μέσα στη λίστα. Ξέρετε, μήπως, ποια συνάρτηση μπορούμε να χρησιμοποιήσουμε γι'αυτό; Το ξέρετε ήδη!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Ναι! Η συνάρτηση `len()` σας δίνει τον αριθμό των objects μέσα σε μια λίστα. Ωραίο, έτσι; Ίσως να μπορούμε να ταξινομήσουμε τους αριθμούς:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Αυτό δεν επιστρέφει τίποτα, απλώς άλλαξε τη σειρά με την οποία εμφανίζονται οι αριθμοί στη λίστα. Ας εκτυπώσουμε τη λίστα να δούμε πως άλλαξαν τα δεδομένα της:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Όπως βλέπετε, οι αριθμοί μέσα στη λίστα είναι πλέον ταξινομημένοι κατά αύξοντα αριθμό. Συγχαρητήρια!
+
+Ίσως να θέλουμε να αντιστρέψουμε αυτή τη σειρά. Ας το κάνουμε!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+Αν θέλετε να προσθέσετε κάτι στη λίστα σας, μπορείτε να το κάνετε με την ακόλουθη εντολή:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Αν θέλετε να εμφανίσετε μόνο το πρώτο στοιχείο της λίστας, μπορείτε να το κάνετε χρησιμοποιώντας τα λεγόμενα **indexes**. Ένα index είναι ένας αριθμός ο οποίος δηλώνει σε ποιο σημείο ένα στοιχείο υπάρχει σε μια λίστα. Οι προγραμματιστές προτιμούν να ξεκινούν από το 0, οπότε το πρώτο στοιχείο θα βρίσκεται στη θέση (index) 0, το επόμενο στη θέση 1 κοκ. Δοκιμάστε αυτό:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Όπως μπορείτε να δείτε, μπορείτε να έχετε πρόσβαση στα διαφορετικά στοιχεία μια λίστας γνωρίζοντας το όνομα της λίστας και τη θέση (index) του κάθε στοιχείου, δηλώνοντας το μέσα σε αγκύλες ([]).
+
+Για να διαγράψετε κάτι από τη λίστα, θα χρειαστεί να χρησιμοποιήσετε τα **indexes** καθώς και την μέθοδο `pop()`. Δηλαδή, θα πρέπει να ξέρετε ποιο στοιχείο να διαγράψετε. Ας δοκιμάσουμε ένα παράδειγμα. Θα διαγράψουμε το πρώτο στοιχείο της λίστας.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Δούλεψε μια χαρά!
+
+Παίξτε λίγο παραπάνω: δοκιμάστε μερικές άλλες θέσεις (αριθμός μέσα στην αγκύλη) όπως 6, 7, 1000, -1, -6 ή -1000. Δείτε αν μπορείτε να προβλέψετε το αποτέλεσμα πριν πατήσετε enter. Συμφωνούν τα αποτελέσματα με την πρόβλεψη σας;
+
+Μπορείτε να βρείτε την λίστα με όλες διαθέσιμες μεθόδους για μια λίστα στο Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Λεξικά
+
+> Για τους αναγνώστες στο σπίτι: αυτή η ενότητα καλύπτεται στο βίντεο [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+
+Ένα λεξικό (dictionary ή όπως έχει επικρατήσει, dict εν συντομία) είναι όμοιο με μια λίστα αλλά έχετε πρόσβαση στις τιμές όχι κατά θέση (index) αλλά κατά ένα κλειδί (key). Ένα κλειδί μπορεί να είναι ένα string ή ένας αριθμός. Η σύνταξη για ένα κενό λεξικό είναι:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Αυτό σηλώνει ότι μόλις δημιουργήσατε ένα κενό dict. Συγχαρητήρια!
+
+Τώρα, προσπαθήστε να εκτελέσετε την ακόλουθη εντολή (αντικαθιστώντας με δικά σας στοιχεία):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+Με αυτή την εντολή μόλις δημιουργήσατε μια μεταβλητή με το όνομα `participant` με τρια ζευγάρια κλειδι-τιμή (key value pairs):
+
+- Το πρώτο κλειδί είναι το `name` το οποίο αντιστοιχεί την τιμή `'Ola'` (είναι ένα `string` object),
+- Το δεύτερο κλειδί με το όνομα `country` αντιστοιχεί στην τιμή `'Poland'` (άλλο ένα `string`),
+- και το τρίτο κλειδί `favorite_numbers` αντιστοιχεί στην τιμή `[7, 42, 92]` (μια λίστα `list` με τρεις αριθμούς μέσα της).
+
+Μπορείτε να δείτε τις τιμές κάθε κλειδιού με την ακόλουθη σύνταξη:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Βλέπετε ότι είναι όμοια με μια λίστα. Απλώς δεν χριάζεται να θυμάστε τη θέση - μόνο το όνομα.
+
+Τι θα συμβεί αν ζητήσουμε μια τιμή ενός κλειδιού η οποία δεν υπάρχει; Μπορείτε να μαντέψετε; Ας δοκιμάσουμε να δούμε!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Είδατε, άλλο ένα σφάλμα το οποίο λέγεται **KeyError**. Η Python είναι αρκετά καλή σε αυτό. Δηλαδή στην περιγραφικότητα των σφαλμάτων της. Σας λέει ότι το κλειδί `'age'` δεν υπάρχει στο λεξικό.
+
+Πότε πρέπει να χρησιμοποιείτε λεξικό έναντι μιας λίστας; Αυτό είναι ένα καλό ερώτημα. Σκεφτείτε λίγο την απάντηση πριν προχωρήσετε.
+
+- Χρειάζεστε μια ταξινομημένη ακολουθία από στοιχεία; Η απάντηση είναι λίστα.
+- Χρειάζεστε να συσχετίζετε κλειδιά ούτως ώστε να τα αναζητείτε αργότερα μόνο με το όνομα τους και όχι με τη θέση τους; Η απάντηση είναι dict.
+
+Τα dicts όπως και οι λίστες είναι *mutable*, που σημαίνει ότι μπορούν να αλλάξουν μετά τη δημιουργία τους. Μπορείτε να προσθέσετε ένα νέο κλειδί-τιμή στο λεξικό αφού δημιουργηθεί, όπως παρακάτω:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Ελπίζουμε να βγάζουν νόημα όλα αυτά μέχρι τώρα. :) Είστε έτοιμοι για περισσότερη διασκέδαση με τα λεξικά; Συνεχίστε να διαβάζετε για περισσότερα πράγματα που μπορείτε να κάνετε.
+
+Μπορείτε να χρησιμοποιήσετε την μέθοδο `pop()` για να διαγράψετε ένα στοιχείο (ζευγάρι από κλειδί-τιμή) από ένα dict. Για παράδειγμα, αν θέλετε να διαγράψετε το ζευγάρι με το κλειδί `'favorite_numbers'`, γράψτε την ακόλουθη εντολή:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Όπως μπορείτε να δείτε από την έξοδο, το ζευγάρι του κλειδιού 'favorite_numbers' διαγράφηκε επιτυχώς.
+
+Επίσης, μπορείτε να αλλάξετε την τιμή σε μια τιμή μέσα σε ένα λεξικό (αλλά όχι το ίδιο το κλειδί). Δοκιμάστε το εξής:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Όπως βλέπετε, η τιμή του κλειδιού `'country'` αλλάξε από `'Poland'` σε `'Germany'`. :) Φοβερό έτσι; Μπράβο! Μόλις μάθατε άλλο ένα απίθανο πράγμα.
+
+### Περίληψη
+
+Τέλεια! Ξέρετε πολλά σχετικά με τον προγραμματισμό τώρα. Στην τελευταία ενότητα μάθατε τα εξής:
+
+- **errors** – μάθατε πως να διαβάζετε και να καταλαβαινέτε τα σφάλματα τα οποία εμφανίζονται αν η Python δεν καταλαβαίνει κάποια εντολή που της δώσατε
+- **variables** – ονόματα για objects τα οποία σας επιτρέπουν να γράφετε κώδικα πιο εύκολα αλλά και να είναι ο κώδικας σας πιο ευανάγνωστος
+- **lists** – λίστες από objects που αποθηκεύονται σε μια συγκεκριμένη σειρά
+- **dictionaries** – αντικείμενα τα οποία αποθηκεύονται υπό τη μορφή ζευγαριού κλειδί-τιμή
+
+Ενθουσιασμένοι για το επόμενο μέρος; :)
+
+## Σύγκριση πραγμάτων
+
+> Για τους αναγνώστες στο σπίτι: αυτή η ενότητα καλύπτεται στο βίντεο [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4).
+
+Ένα μεγάλος μέρος του προγραμματισμού περιλαμβάνει τη σύγκριση πραγμάτων. Ποιο είναι το πιο εύκολο πράγμα να συγκρίνουμε; Οι αριθμοί! Ας δούμε πως:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Αναρρωτιέστε γιατί βάλαμε `==` (δύο ίσον σύμβολα) για να εξακριβώσουμε αν οι αριθμοί είναι ίσοι; Χρησιμοποιούμε το μονό ίσον `=` για να αναθέσουμε μια τιμή σε μια μεταβλητή. Πάντα, **πάντα** θα χρειάζεται να βάζετε διπλό ίσον – `==` – αν θέλετε να δείτε αν δύο πράγματα είναι ίσα μεταξύ τους. Αν οι τιμές τους, δηλαδή, είναι ίδιες. Μπορούμε επίσης να εξακριβώσουμε αν οι τιμές τους δεν είναι ίσες. Γι'αυτό χρησιμοποιούμε το σύμβολο `!=`, όπως φαίνεται παραπάνω.
+
+Ας δώσουμε στην Python δύο ακόμα εντολές:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+Είδαμε ότι τα σύμβολα `>` και `<`, αλλά τα ακόλουθα σύμβολα τι σημαίνουν: `>=`, `<=`; Διαβάστε τα κάπως έτσι:
+
+- x `>` y σημαίνει: το x είναι μεγαλύτερο το y
+- x `<` y σημαίνει: το x είναι μικρότερο του y
+- x `<=` y σημαίνει: το x είναι μικρότερο ή ίσο του y
+- x `>=` y σημαίνει: το x είναι μεγαλύτερο ή ίσο του y
+
+Τέλεια! Θέλετε να δοκιμάσετε άλλο ένα; Δοκιμάστε αυτό:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Μπορείτε να δώσετε στην Python όσα νούμερα θέλετε προς σύγκριση και θα σας δώσει την απάντηση! Πολύ καλό, έτσι;
+
+- **and** – αν χρησιμοποιήσετε τον operator `and`, τότε και οι δύο συγκρίσεις θα πρέπει να είναι αληθείς (True) για να είναι όλη η εντολή True
+- **and** – αν χρησιμοποιήσετε τον operator `or`, τότε αρκεί μόνο μια από τις συγκρίσεις να είναι αληθής (True) για να είναι όλη η εντολή True
+
+Έχετε ακούσει την έκφραση "συγκρίνω μήλα με πορτοκάλια"; Ας το δοκιμάσουμε με την Python:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Όπως ισχύει με την παραπάνω έκφραση στην καθομιλουμένη, έτσι και στην Python δεν είναι δυνατόν να συγκριθεί ένας αριθμός (`int`) με ένα string (`str`). Αντ' αυτού, εμφανίζεται ένα σφάλμα τύπου **TypeError** το οποίο μας λέει ότι οι δύο τύποι objects δεν μπορούν να συγκριθούν μεταξύ τους.
+
+## Λογικές τιμές
+
+Χωρίς να το θέλετε, μόλις μάθατε έναν νέο τύπο object στην Python. Ονομάζεται **Boolean**.
+
+Υπάρχουν μόνο δύο ειδών Boolean objects:
+
+- True
+- False
+
+Αλλά για να το καταλάβει η Python θα πρέπει πάντα να το γράφετε ως 'True' (το πρώτο γράμμα κεφαλαίο με τα υπόλοιπα πεζά). Τα **true, TRUE, και tRUE δεν θα δουλέψουν – μόνο το True είναι σωστό.** (Το ίδιο ισχύει και για το 'False'.)
+
+Τα booleans μπορούν να είναι και μεταβλητές! Δείτε εδώ:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Μπορείτε να το κάνετε και έτσι:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Εξασκηθείτε και διασκεδάστε με τα Booleans δοκιμάζοντας τις ακόλουθες εντολές:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Συγχαρητήρια! Τα Booleans είναι ένα από τα πιο διασκεδαστικά πράγματα στον προγραμματισμό και μόλις μάθατε πως να τα χρησιμοποιείτε!
+
+# Αποθήκευση!
+
+> Για τους αναγνώστες στο σπίτι: αυτή η ενότητα καλύπτεται στο βίντεο [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk).
+
+Τόση ώρα γράφαμε τον κώδικα στην κονσόλα η οποία μας περιορίζει στο να εισάγουμε μια γραμμή κάθε φορά. Τα περισσότερα προγράμματα αποθηκεύονται σε αρχεία και τρέχουν όταν τους ζητηθεί από τον **interpreter** ή τον **compiler** της αντίστοιχης γλώσσας προγραμματισμού. Τόση ώρα τρέχαμε τα προγράμματα μας σε μια γραμμή κάθε φορά μέσα στον Python **interpreter**. Θα χρειαστούμς περισσότερες από μια γραμμές κώδικα για τα επόμενα στάδια. Οπότε θα χρειαστεί εν συντομία να κάνουμε τα εξής:
+
+- Να φύγουμε από τον Python interpreter
+- Να ανοίξουμε τον επεξεργαστή κώδικα της αρέσκειας μας
+- Να αποθηκεύσουμε κάποιο κομμάτι κώδικα σε ένα python αρχείο (με την κατάληξη .py)
+- Να το τρέξουμε!
+
+Για να φύγουμε από τον Python interpreter θα γράψουμε `exit()`
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Αυτό θα σας επαναφέρει στη γραμμή εντολών.
+
+Νωρίτερα, επιλέξαμε έναν επεξεργαστή κώδικα από την ενότητα [επεξεργαστής κώδικα](../code_editor/README.md). Θα χρειαστεί να ανοίξουμε τον επεξεργαστή κώδικα και να γράψουμε κώδικα σε ένα νέο αρχείο (ή αν χρησιμοποιείτε Chromebook, δημιουργήστε ένα νέο αρχείο μέσω του Cloud IDE και ανοίξτε το αρχείο):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Προφανώς, είστε ένας αρκετά έμπειρος Python developer τώρα, οπότε γράφτε κάποιον κώδικα μέσα στο αρχείο.
+
+Τώρα θέλουμε να αποθηκεύσουμε το αρχείο και να του δώσουμε ένα περιγραφικό όνομα. Ας το ονομάσουμς **python_intro.py** και ας το αποθηκεύσουμε στην επιφάνεια εργασίας. Μπορούμε να ονομάσουμε το αρχείο όπως θέλουμε αλλά το σημαντικό εδώ είναι η κατάληξηξ **.py** που πρέπει να έχει. Η κατάληξη **.py** λέει στο λειτουργικό μας σύστημα ότι αυτό το αρχείο αποτελεί ένα **εκτελέσιμο Python αρχείο** και έτσι η Python μπορεί να το τρέξει.
+
+> **Σημείωση** Θα πρέπει να είδατε ήδη ένα από τα πιο ωραία πράγματα στους επεξεργαστές κώδικα: τα χρώματα! Στην Python κονσόλα, όλα ήταν το ίδιο χρώμα. Τώρα βλέπετε ότι η συνάρτηση `print` έχει διαφορετικό χρώμα από ένα string. Αυτό ονομάζεται "syntax highlighting" και είναι ένα πολύ χρήσιμο χαρακτηριστικό καθώς προγραμματίζετε. Τα χρώματα θα σας δίνουν βοήθεια, όπως ένα string που του λείπει ένα "αυτάκι" ή ένα τυπογραφικό λάθος (typo) σε κάποια λέξε κλειδί της Python όπως `def` κλπ). Αυτός είναι ένας λόγος που χρησιμοποιούμε έναν επεξεργαστή κώδικα. :) :)
+
+Με αποθηκευμένο το αρχείο, είναι ώρα να το τρέξουμε! Χρησιμοποιώντας τις δεξιότητες που μάθατε στη γραμμή εντολών, χρησιμοποιήστε την κονσόλα για να **αλλάξετε φάκελο** και να μεταβείτε στην επιφάνεια εργασίας.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Σε Mac, η εντολή θα μοιάζει κάπως έτσι:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### Αν όμως η συνθήκη δεν είναι True;
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Σχόλια
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Περίληψη
+
+In the last few exercises you learned about:
+
+- **να συγκρίνετε πράγματα** – στην Python μπορείτε να συγκρίνετε πράγματα χρησιμοποιώντας `>`, `>=`, `==`, `<=`, `<` και `and`, `or`
+- **Boolean** – ένας τύπος object το οποίο μπορεί να πάρει μόνο δύο τιμές: `True` ή `False`
+- **Αποθήκευση αρχείων** – αποθήκευση κώδικα σε αρχεία ούτως ώστε να τρέχετε μεγαλύτερου όγκου προγράμματα.
+- **if … elif … else** – αυτά τα statements σας επιτρέπουν να εκτελείτε κώδικα υπό συγκεκριμένες συνθήκες.
+- **σχόλια** - γραμμές στην Python οι οποίες δεν εκτελούνται και σας επιτρέπουν να κάνετε τον κώδικα σας πιο περιγραφικό και ευανάγνωστο
+
+Time for the last part of this chapter!
+
+## Οι δικές σας συναρτήσεις!
+
+> Για τους αναγνώστες στο σπίτι: αυτή η ενότητα καλύπτεται στο βίντεο [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0).
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- Αν λέβετε ένα σφάλμα τύπου `NameError`, τότε ίσως γράψατε κάτι λάθος όπως το όνομα της συνάρτηση στο τέλος του αρχείου. Επιβεβαιώστε ότι το όνομα στη δήλωση της συνάρτηση `def hi():` είναι το ίδιο με το όνομα όταν την καλείτε `hi()`.
+- Αν λάβατε ένα σφάλμα τύπου `IndentationError`, ελέγξτε ότι και οι γραμμές που καλούνται οι δύο συναρτήσεις `print` έχουν τον ίδιο αριθμό κενών στην αρχή: η Python απαιτεί όλος ο κώδικας μέσα στις συναρτήσεις να είναι στοιχισμένος το ίδιο.
+- Αν δεν βλέπετε κάποια έξοδο τότε είτε έχετε παραλείψει να καλέσετε την συνάρτηση χρησιμοποιώντας τις παρενθέσεις `hi()` είτε το έχετε κάνει αλλά η κλήση της συνάρτησης (hi()) έχει *κενό* στην αρχή και αποτελεί μέρος του κυρίου σώματος της συνάρτησης (def hi():).
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Επαναλήψεις
+
+> Για τους αναγνώστες στο σπίτι: αυτή η ενότητα καλύπτεται στο βίντεο [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0).
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Περίληψη
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/el-GR/template_extending/README.md b/el-GR/template_extending/README.md
new file mode 100644
index 00000000000..16df5df6a05
--- /dev/null
+++ b/el-GR/template_extending/README.md
@@ -0,0 +1,151 @@
+# Επεκτείνοντας τα template
+
+Ένα άλλο ωραίο πράγμα που προσφέρει το Django είναι η **επέκταση των templates**. Τι σημαίνει αυτό; Αυτό σημαίνει ότι μπορείτε να χρησιμοποιείτε τα ίδια κομμάτια HTML για διαφορετικές σελίδες του διαδυκτιακού σας τόπου.
+
+Τα templates σας βοηθάνε στο να επαναχρησιμοποιήσετε το ίδιο τμήμα HTML (την ίδια, δηλαδή, πληροφορία) σε περισσότερα από ένα μέρη. Δεν χρειάζεται να επαναλαμβάνεται τον εαυτό σας σε κάθε αρχείο. Και αν χρειαστεί να αλλάξετε κάτι, δεν χρειάζεται να το κάνετε σε κάθε template παρά μόνο σε ένα!
+
+## Δημιουργία ενός βασικού (base) template
+
+Το base template είναι το πιο βασικό template που μπορείτε να επεκτείνετε σε κάθε σελίδα του ιστότοπού σας.
+
+Ας δημιουργήσουμε ένα αρχείο `base.html` μέσα στο `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Στη συνέχεια, άνοιξε το και να αντίγραψε τα πάντα από το αρχείο `post_list.html` στο `base.html`, όπως ακολούθως:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Στη συνέχεια στο αρχείο `base.html`, αντικαταστήστε τα περιεχόμενα των: `<body>`(τα πάντα μεταξύ `<body>` και `</body>`) με αυτό:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Ίσως παρατηρήσατε ότι αυτό αντικατέστησε τα πάντα από το `{% for post in posts %}` μέχρι το `{% endfor %}` με αυτό: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Αλλά γιατί; Μόλις δημιουργήσατε ένα `block`! Χρησιμοποιήσατε ένα template tag με το όνομα `{% block %}` για να δημιουργήσετε μια περιοχή όπου μέσα θα εισαχθεί HTML. Η HTML θα έρθει από άλλο αρχείο template το οποίο κάνει extend (επεκτείνει) αυτό το template (`base.html`). Θα σας δείξουμε πως να το κάνετε αυτο σε λίγο.
+
+Αποθηκεύστε το template `base.html` και ανοίξτε το αρχείο `blog/templates/blog/post_list.html` ξανά. {% raw %}Θα χρειαστεί να διαγράψετε τα πάντα πάνω από το `{% for post in posts %}` και κάτω από το `{% endfor %}`. Όταν είστε έτοιμοι, το αρχείο θα δείχνει κάπως έτσι:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Θέλουμε να χρησιμοποιήσουμε αυτό το κομμάτι ως μέρος του template μας για όλα τα blocks με περιεχόμενο. Ήρθε η ώρα να προσθέσουμε blocks σε αυτό το αρχείο!
+
+{% raw %}Πρέπει το όνομα του block να είναι το ίδιο με αυτό που δηλώσαμε στο template `base.html`. Πρέπει επίσης να συμπεριλάβουμε όλο τον κώδικα που ανήκει σε αυτά τα blocks. Για να γίνει αυτό, βάλτε τα όλα μεταξύ `{% block content %}` και `{% endblock %}`. Έτσι:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Μόνο ένα πράγμα έμεινε. Πρέπει να "συνδέσουμε" αυτά τα δύο templates μαζί. Αυτή είναι η έννοια της επέκτασης των template! Θα το κάνουμε αυτό προσθέτοντας τη λέξη-κλειδί "extends" στην αρχή του αρχείου. Κάπως έτσι:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Αυτό ήταν! Αποθηκεύστε το αρχείο και επιβεβαιώστε ότι η ιστοσελίδα σας λειτουργεί όπως πριν. :)
+
+> Αν λέβετε κάποιο σφάλμα όπως `TemplateDoesNotExist`, αυτό σημαίνει ότι δεν υπάρχει το αρχείο `blog/base.html` και ότι ο `server` τρέχει στην κονσόλα. Προσπαθήστε να τον σταματήσετε (πιέζοντας Ctrl + C) και επανεκκινήστε τον τρέχοντας την εντολή `python manage.py runserver`.
\ No newline at end of file
diff --git a/el-GR/whats_next/README.md b/el-GR/whats_next/README.md
new file mode 100644
index 00000000000..f10b39463e0
--- /dev/null
+++ b/el-GR/whats_next/README.md
@@ -0,0 +1,43 @@
+# Τι υπάρχει μετά;
+
+Επιβράβευσε τον εαυτό σου! **Είσαι φοβερή**. Είμαστε περήφανοι! <3
+
+### Τι μπορείς να κάνεις τώρα;
+
+Κάνε ένα διάλλειμα και χαλάρωσε! Μόλις έφερες εις πέρας κάτι πραγματικά μεγάλο.
+
+Μετά, ακολούθησε την κοινότητα Django Girls στο [Facebook](http://facebook.com/djangogirls) ή/και στο [Twitter](https://twitter.com/djangogirls) ούτως ώστε να μένεις ενημερωμένος.
+
+### Μπορείς να προτείνεις τυχόν επιπρόσθετες πηγές;
+
+Ναι! Υπάρχουν *πολλές* πηγές στο διαδίκτυο σχετικά με την εκμάθηση γλωσσών προγραμματισμού όλων των ειδών. Ίσως να είναι δύσκολη η επιλογή του επόμενου βήματος αλλά μην ανησυχείτε. Σας καλύπτουμε. Όποια και αν ήταν τα ενδιαφέροντα σας προτού έρθετε στην κοινότητα των Django Girls και οποιαδήποτε ενδιαφέροντα αναπτύξατε κατά τη διάρκεια του οδηγού, παρακάτω σας παρουσιάζουμε μερικές δωρεάν πηγές (κάποιες από τις οποίες δεν είναι αμιγώς δωρεάν αλλά περιέχουν δωρεάν κομμάτια) τις οποίες μπορείτε να χρησιμοποιήσετε προκειμένου να πετύχετε τον στόχο σας.
+
+#### Django
+
+- Το άλλο μας βιβλίο, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Ο επίσημος οδηγός του Django](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Ξεκινώντας με το Django με μαθήματα βίντεο](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS και JavaScript
+
+- [Μάθημα web development από την εταιρεία Codecademy](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Μάθημα Python από την εταιρεία Codecademy](https://www.codecademy.com/learn/learn-python)
+- [Μάθημα Python από την Google](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – οι πρώτες ασκήσεις είναι δωρεάν
+- [New Coder tutorials](http://newcoder.io/tutorials/) – είναι μια ποικιλία πρακτικών παραδειγμάτων του πως μπορεί να χρησιμοποιηθεί η γλώσσα προγραμματισμού Python
+- [edX](https://www.edx.org/course?search_query=python) – σε αυτό το γνωστό site, μπορείτε να παρακολουθήσετε τα περισσότερα μαθήματα δωρεάν αλλά για την απόκτηση κάποιου πιστοποιητικού τότε θα χρειαστεί να καταβάλετε κάποιο ποσό ανάλογα το μάθημα και το πιστοποιτικό
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Δουλεύοντας με δεδομένα
+
+- [Μάθημα επιστημονικών δεδομένων από την εταιρία Codecademy](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – σε αυτό το γνωστό site, μπορείτε να παρακολουθήσετε τα περισσότερα μαθήματα δωρεάν αλλά για την απόκτηση κάποιου πιστοποιητικού τότε θα χρειαστεί να καταβάλετε κάποιο ποσό ανάλογα το μάθημα και το πιστοποιτικό
+- [Dataquest](https://www.dataquest.io/) – οι πρώτες 30 "αποστολές" είναι δωρεάν
+
+Ανυπομονούμε να δούμε το επόμενο σας project!
\ No newline at end of file
diff --git a/el/GLOSSARY.md b/el/GLOSSARY.md
new file mode 100644
index 00000000000..c055917f508
--- /dev/null
+++ b/el/GLOSSARY.md
@@ -0,0 +1,3 @@
+# Επεξεργαστής Κώδικα
+
+Ο επεξεργαστής κώδικα είναι μια εφαρμογή που σου επιτρέπει να αποθηκεύσεις τον κώδικα σου, ώστε να είσαι σε θέση να επιστρέψεις σε αυτό αργότερα. Μπορείς να μάθεις πού μπορείς να βρείς ένα από το [κεφάλαιο επεξεργαστής κώδικα](./code_editor/README.md)
\ No newline at end of file
diff --git a/el/README.md b/el/README.md
new file mode 100644
index 00000000000..08a1731aa9f
--- /dev/null
+++ b/el/README.md
@@ -0,0 +1,51 @@
+# Φροντιστήριο Django Girls
+
+[![Γκλιτερ](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Καλώς ήρθατε
+
+Καλώς ήρθατε στο φροντιστήριο Django Girls! Χαιρόμαστε που σε βλέπουμε εδώ :) Σε αυτό το σεμινάριο, θα σε πάμε ένα ταξίδι κάτω από την κουκούλα των τεχνολογιών ιστοσελίδων. προσφέροντας σου μία γεύση από όλα τα κομμάτια που πρέπει να συγκεντρωθούν ώστε να κάνουν τον ιστό να δουλέψει όπως το γνωρίζουμε.
+
+Όπως με όλα τα άγνωστα πράγματα, αυτό πρόκειται είναι μία εμπειρία- αλλά μην ανησυχείς, αφού ήδη πήρες την απόφαση να είσαι εδώ, θα είσαι μια χαρά :)
+
+## Εισαγωγή
+
+Έχεις νιώσει ποτέ ότι ο κόσμος γίνεται όλο και περισσότερο σχετικός με την τεχνολογία και δεν μπορείς (ακόμα) να σχετιθείς; Έχεις ποτέ αναρωτηθεί πώς να δημιουργήσεις μια ιστοσελίδα, αλλά ποτέ δεν είχες αρκετό κίνητρο για να ξεκινήσεις; Έχεις ποτέ σκεφτεί οτι ο κόσμος του software είναι πολύ περίπλοκος για σένα για να προσπαθήσεις να κάνεις κάτι από μόνη σου;
+
+Λοιπόν, έχουμε καλά νέα για 'σένα! Ο προγραμματισμός δεν είναι τόσο δύσκολος όσο φαίνεται, και θέλουμε να σου δείξουμε πόσο διασκεδαστικός μπορεί να είναι.
+
+Αυτό το σεμινάριο δεν θα σε μετατρέψει σε προγραμματιστή ως δια μαγείας. Αν θέλεις να γίνεις καλή προγραμματίστρια, χρειάζεται μήνες ή ακόμη και χρόνια εκμάθησης και πρακτικής εξάσκησης. Όμως θέλουμε να σου δείξουμε οτι ο προγραμματισμός ή η δημιουργία ιστιοσελίδων δεν είναι τόσο περίπλοκο όσο φαίνεται. Θα προσπαθήσουμε να σου εξηγήσουμε τα διάφορα κομμάτια όσο καλύτερα μπορούμε, ούτως ώστε να μην σε φοβίζει η τεχνολογία.
+
+Ελπίζουμε να μπορέσουμε να σε κάνουμε να αγαπήσεις την τεχνολογία, όπως εμείς!
+
+## Τι θα μάθεις κατα τη διάρκεια του tutorial;
+
+Μόλις τελειώσετε το σεμινάριο, θα έχετε μία μικρή λειτουργική εφαρμογή ιστού: το δικό σας blog. Θα σας δείξουμε πως να το ανεβάσετε ηλεκτρονικά, ώστε άλλοι να δουν την δουλειά σας!
+
+Θα φαίνεται έτσι (πάνω κάτω):
+
+![Σχήμα 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, αλλά γνωρίζουμε ότι δεν είναι πάντα δυνατό να παρακολουθήσετε ένα. Για αυτό σας ενθαρρύνουμε να προσπαθήσετε να ακολουθήσετε αυτό το σεμινάριο στο σπίτι. Για τους αναγνώστες στο σπίτι, προς το παρόν ετοιμάζουμε βίντεο που θα το κάνουν ευκολότερο να παρακολουθήσετε το σεμινάριο από μόνοι σας. Είναι ακόμα έργο σε εξέλιξη, αλλά όλο και περισσότερα πράγματα θα καλυφθούν σύντομα στο [ ](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) κανάλι του YouTube.
+
+Σε κάθε κεφάλαιο που έχει ήδη καλυφθεί, υπάρχει ένας σύνδεσμος που οδηγεί στο σωστό βίντεο.
+
+## Σχετικά και συμβάλλοντας
+
+Αυτό το σεμινάριο συντηρείται από [DjangoGirls](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) ενημερώνοντας μας για την γλώσσα ώστε να την προσθέσουμε.
\ No newline at end of file
diff --git a/el/SUMMARY.md b/el/SUMMARY.md
new file mode 100644
index 00000000000..afeababe25c
--- /dev/null
+++ b/el/SUMMARY.md
@@ -0,0 +1,27 @@
+# Περίληψη
+
+* [Εισαγωγή](README.md)
+* [Εγκατάσταση](installation/README.md)
+* [Εγκατάσταση (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)
+* [Μοντέλα (models) του Django](django_models/README.md)
+* [Διαχείριση μέσω Django admin](django_admin/README.md)
+* [Ανεβάστε!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Προβολές Django - ώρα να δημιουργήσετε!](django_views/README.md)
+* [Εισαγωγή στο HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](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)
\ No newline at end of file
diff --git a/el/chromebook_setup/README.md b/el/chromebook_setup/README.md
new file mode 100644
index 00000000000..322e9ede763
--- /dev/null
+++ b/el/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Εγκατάσταση του Chromebook
+
+> **Σημείωση** Εάν έχετε ήδη τελειώσει με τα βήματα της εγκατάστασης, δεν χρειάζεται να επαναλάβετε αυτή την ενότητα - μπορείτε να πάτε απευθείας στην ενότητα [ Εισαγωγή στην Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/el/chromebook_setup/instructions.md b/el/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..f031097fb2b
--- /dev/null
+++ b/el/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+Μπορείτε [ να παραλείψετε αυτή την ενότητα](http://tutorial.djangogirls.org/en/installation/#install-python) εάν δεν χρησιμοποιείτε το Chromebook. Εάν το χρησιμοποιείτε, η διαδικασία εγκατάστασης θα είναι λίγο διαφορετική. Σε αυτή την περίπτωση μπορείτε να αγνοήσετε τις υπόλοιπες οδηγίες εγκατάστασης.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. Για τη διάρκεια του workshop, το Cloud 9 θα είναι *το τοπικό σας μηχάνημα*. Με αυτόν τον τρόπο θα μπορείτε να τρέχετε εντολές σε ένα τερματικό περιβάλλον ακριβώς όπως και οι συμμαθητές σας με OS X, Ubuntu ή Windows, αλλά το δικό σας τερματικό θα είναι συνδεδεμένο με έναν υπολογιστή που τρέχει σε server του Cloud 9.
+
+1. Εγκαταστήστε το Cloud 9 από το [ web store του Chrome](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Πηγαίντε στο [c9.io](https://c9.io)
+3. Δημιουργήστε λογαριασμό
+4. Κάντε κλικ στο * Create a New Workspace*
+5. Ονομάστε το *django-girls*
+6. Επιλέξτε το *Βlank*(Δεύτερο από δεξιά στην κάτω γραμμή με το πορτοκαλί λογότυπο)
+
+Τώρα πρέπει να βλέπετε μια σελίδα με ένα μεγάλο κύριο παράθυρο με κείμενο, μία πλαϊνή μπάρα και ένα μικρό παράθυρο στο τέλος που μοιάζει κάπως έτσι:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Εικονικό Περιβάλλον
+
+Ένα εικονικό περιβάλλον( γνωστό και ως virtualenv) είναι σαν ένα ιδιωτικό κουτί που μπορούμε να χωρέσουμε χρήσιμο υπολογιστικό κώδικα για ένα πρότζεκτ στο οποίο εργαζόμαστε. Τα χρησιμοποιούμε για να κρατήσουμε διάφορα κομμάτια κώδικα που θέλουμε για τα διαφορετικά πρότζεκτ μας χωριστά ώστε τα πράγματα να μην μπερδεύονται μεταξύ τους μεταξύ πρότζεκτ.
+
+Εάν ο ακροδέκτης σας είναι στο κάτω μέρος της διεπαφής του Cloud 9, εκτελέστε το ακόλουθο:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+Εάν εξακολουθεί να μην λειτουργεί, ζήτησε βοήθεια από τον προπονητή σας.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+Το φροντιστήριο Django Girls συμπεριλαμβάνει μια ενότητα στο τι αποκαλείται Ανάπτυξη, το οποίο είναι η διαδικασία όπου παίρνεις τον κώδικα που τροφοδοτεί την νέα σου εφαρμογή δικτύου και την μετακινεί σε ένα δημόσια προσιτό υπολογιστή (που ονομάζεται διακομιστής) έτσι ώστε άλλα άτομα μπορούν να δουν την εργασία σου.
+
+Αυτό το μέρος είναι λίγο περίεργο όταν κάνεις το φροντιστήριο σε ένα Chromebook μιας και χρησιμοποιούμε ήδη έναν υπολογιστή ο οποίος είναι στο διαδίκτυο ( σε αντίθεση, ας πούμε, με ένα φορητό υπολογιστή). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/el/code_editor/README.md b/el/code_editor/README.md
new file mode 100644
index 00000000000..cba0e64763d
--- /dev/null
+++ b/el/code_editor/README.md
@@ -0,0 +1,11 @@
+# Επεξεργαστής Κώδικα
+
+> Για τους αναγνώστες στο σπίτι: αυτό το κεφάλαιο καλύπτεται στο [ Εγκαθιστώντας την Python& Πρόγραμμα επεξεργασίας κώδικα](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s)βίντεο.
+
+Είσαι έτοιμη να γράψεις την πρώτη σου γραμμή κώδικα, οπότε ήρθε η ώρα για να κατεβάσεις ένα πρόγραμμα επεξεργασίας κώδικα (code editor)!
+
+> **Σημείωση** εάν χρησιμοποιείτε ένα Chromebook, πηδήξτε αυτό το κεφάλαιο και σιγουρευτείτε ότι ακολουθείτε τις οδηγίες [Εγκατάστασης Chromebook](../chromebook_setup/README.md).
+> 
+> **Σημείωση** Μπορεί να το έχετε ήδη κάνει αυτό νωρίτερα στο κεφάλαιο εγκατάστασης- αν ναι, μπορείτε να παραλείψετε κατευθείαν στο επόμενο κεφάλαιο!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/el/code_editor/instructions.md b/el/code_editor/instructions.md
new file mode 100644
index 00000000000..bdb6ca1d6cb
--- /dev/null
+++ b/el/code_editor/instructions.md
@@ -0,0 +1,31 @@
+Υπάρχουν πολλά code editors διαθέσιμοι και για αυτό είστε ελεύθεροι να διαλέξετε αυτόν που σας αρέσει περισσότερο. Οι περισσότεροι προγραμματιστές της Python χρησιμοποιούν περίπλοκα, αλλά εξαιρετικά ισχυρά IDEs (Integrated Development Environments-Ολοκληρωμένα Περιβάλλοντα Ανάπτυξης), όπως το PyCharm. Για αρχάριους, ωστόσο, αυτή η επιλογή είναι ίσως λιγότερο κατάλληλη· οι συστάσεις μας είναι προγράμματα εξίσου ισχυρά, αλλά πολύ απλούστερα.
+
+Οι προτάσεις μας είναι παρακάτω, αλλά μην διστάσετε να ρωτήσετε τον προπονητή σας ποιες είναι οι προτιμήσεις του- θα είναι ευκολότερο να σας βοηθήσουν.
+
+## Gedit
+
+Το Gedit είναι ένα ανοικτού κώδικα (open source), δωρεάν πρόγραμμα επεξεργασίας (free editor), διαθέσιμο για όλα τα λειτουργικά συστήματα.
+
+[Κατέβασέ το εδώ](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Κατέβασέ το εδώ](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Κατέβασέ το εδώ](https://atom.io/)
+
+## Γιατί χρειαζόμαστε τον Επεξεργαστή Κώδικα;
+
+Μπορεί να αναρωτιέσαι γιατί εγκαθιστούμε αυτό το ειδικό πρόγραμμα επεξεργασίας κώδικα λογισμικού, αντί να χρησιμοποιήσουμε κάτι σαν το Word ή το Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+Δεύτερον, τα προγράμματα επεξεργασίας κώδικα είναι εξειδικευμένα στην σύνταξη κώδικα, έτσι μπορούν να παρέχουν χρήσιμα χαρακτηριστικά όπως η επισήμανση κώδικα με χρώμα σύμφωνα με την σημασία του, η αυτόματο κλείσιμο εισαγωγικών.
+
+Θα τα δούμε όλα αυτά αργότερα σε δράση. Σύντομα, θα αρχίσεις να βλέπεις τον παλιό, έμπιστο επεξεργαστή σου κώδικα ως ένα από τα αγαπημένα σου εργαλεία. :)
\ No newline at end of file
diff --git a/el/css/README.md b/el/css/README.md
new file mode 100644
index 00000000000..4f8d9fb7bf7
--- /dev/null
+++ b/el/css/README.md
@@ -0,0 +1,304 @@
+# CSS- κάνε το όμορφο!
+
+Το blog μας φαίνεται ακόμα αρκετά άσχημο, έτσι δεν είναι; Ωρα να το κάνουμε όμορφο! Γι'αυτή τη δουλειά θα χρησιμοποιούμε τη CSS.
+
+## Τι είναι η CSS;
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+Άλλα δεν θέλουμε να ξεκινήσουμε από την αρχή ξανά, έτσι; Άλλη μια φορά, θα χρησιμοποιήσουμε κάτι που οι προγραμματιστές κυκλοφόρησαν δωρεάν στο διαδίκτυο. Το να ανακαλύπτουμε τον τροχό δεν έχει πλάκα, ξέρετε.
+
+## Ας χρησιμοποιήσουμε το Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+Γράφτηκε από προγραμματιστές που εργάστηκαν στο Twitter. Τώρα αναπτύσσεται από εθελοντές από ολόκληρο το κόσμο!
+
+## Εγκατάσταση του Bootstrap
+
+Για να εγκαταστήσετε το Bootstrap, πρέπει να προσθέσετε αυτό στο `<head>` στο `html`αρχείο σας:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Σχήμα 14.1](images/bootstrap1.png)
+
+Δείχνει ήδη πολύ καλύτερο!
+
+## Στατικά αρχεία στο Django
+
+Τέλος, ας ρίξουμε μια πιο προσεκτική ματιά στα λεγόμενα **στατικά αρχεία**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Πού βρίσκονται τα στατικά αρχεία στο Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+Για να το κάνουμε αυτό πρέπει να δημιουργήσουμε ένα φάκελο με το όνομα `static` μέσα στο φάκελο του app blog:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Το Django θα βρίσκει αυτόματα οποιοδήποτε φάκελο ονομάζεται "static" μέσα στους φακέλους οποιασδήποτε εφαρμογή σας. Έπειτα θα μπορεί να χρησιμοποιεί το περιεχόμενο τους ως στατικά αρχεία.
+
+## Το πρώτο CSS αρχείο σας!
+
+Ας δημιουργήσουμε ένα CSS αρχείο τώρα, για να προσθέσετε το δικό σας στυλ στην ιστοσελίδα σας. Δημιουργήστε έναν νέο κατάλογο που ονομάζεται `css` μέσα στο `static` κατάλογο. Στη συνέχεια, δημιουργήστε ένα νέο αρχείο που ονομάζεται `blog.css` μέσα σε αυτόν τον κατάλογο `css`. Είστε έτοιμη;
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Ώρα να γράψουμε λίγη CSS! Άνοιξε το αρχείο `blog/static/css/blog.css` στον επεξεργαστή.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+Αλλά ας δοκιμάσουμε μερικά πράγματα. Ίσως θα μπορούσαμε να αλλάξουμε το χρώμα του τίτλου της σελίδας μας; Για να καταλάβουν τα χρώματα, οι υπολογιστές χρησιμοποιούν ειδικούς κώδικες. Αυτοί οι κώδικες ξεκινάνε με `` και ακολουθούνται από 6 γράμματα (A-F) και αριθμούς (0-9). Για παράδειγμα, ο κωδικός για το μπλε είναι `#0000FF`. Μπορείτε να βρείτε τους κωδικούς των χρωμάτων για πολλά χρώματα εδώ: http://www.colorpicker.com/. Context | Request Context. Μπορείς επίσης να χρησιμοποιήσεις [προκαθορισμένα χρώματα](http://www.w3schools.com/colors/colors_names.asp) με το αγγλικό όνομά τους, όπως το `red` (κόκκινο) και το `green` (πράσινο.
+
+Στο αρχείο `blog/static/css/blog.css` πρέπει να προσθέσεις τον παρακάτω κώδικα:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+Το `h1 a` είναι ένας επιλογέας CSS. This means we're applying our styles to any `a` element inside of an `h1` element. Έτσι όταν έχουμε κάτι σαν `<h1><a href="">σύνδεσμο</a></h1>`, το `h1 a ` στυλ θα εφαρμοστεί. Σε αυτή τη περίπτωση, του λέμε να αλλάξει το χρώμα του σε `#FCA205`, που είναι πορτοκαλί. Φυσικά μπορείς να βάλεις το δικό σου χρώμα εδώ!
+
+Μέσα σε ενα αρχείο CSS καθορίζουμε τα στύλ για τα στοιχεία μέσα στο HTML αρχείο. Ο πρώτος τρόπος που αναγνωρίζουμε στοιχεία είναι με το όνομα στοιχείου. Μπορεί να τα θυμάστε αυτά ως ετικέτες από το τμήμα HTML. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Η τάξη (class) και η ταυτότητα (id) είναι ονόματα που δίνεις εσύ στο κάθε στοιχείο. Οι τάξεις αναφέρονται σε ομάδες στοιχείων και οι ταυτότητες σε συγκεκριμένα στοιχεία. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Ο browser διαβάζει τα αρχεία με την σειρά που δίνονται, οπότε πρέπει να σιγουρευτούμε ότι αυτή είναι η σωστή θέση. Διαφορετικά ο κωδικός στο αρχείο μας μπορεί να παρακαμφθεί από τον κώδικα στα αρχεία Bootstrap. Είπαμε στο template μας που βρίσκεται το CSS αρχείο μας.
+
+Το αρχείο σου πρέπει τώρα να μοιάζει κάπως έτσι:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Εντάξει, αποθηκεύσε το αρχείο και να ανανεώσε την σελίδα!
+
+![Σχήμα 14.2](images/color2.png)
+
+Πολύ καλά! Ίσως να θέλουμε να δώσουμε λίγο αέρα στην ιστιοσελίδα μας και να αυξήσουμε το περιθώριο στα αριστερά; Ας το δοκιμάσουμε!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Προσθέστε αυτό στο CSS σας, αποθηκεύστε τον φάκελο και δείτε πως λειτουργεί!
+
+![Σχήμα 14.3](images/margin2.png)
+
+'Ισως μπορούμε να αλλάξουμε την γραμματοσειρά της επικεφαλίδας μας. Μεσα στο `<head>` που βρίσκεται μεσα στο αρχείο `blog/templates/blog/post_list.html` βάλε αυτό:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Σχήμα 14.3](images/font.png)
+
+Τέλεια!
+
+Όπως αναφέρθηκε παραπάνω, CSS έχει μια έννοια των τάξεων. Αυτά σας επιτρέπουν να ονομάσετε ένα μέρος του κώδικα HTML και να εφαρμόσετε στυλ μόνο σε αυτό το μέρος, χωρίς να επηρεάσετε άλλα μέρη. Αυτό μπορεί να είναι εξαιρετικά χρήσιμο! Maybe you have two divs that are doing something different (like your header and your post). Μια κατηγορία μπορεί να σε βοηθήσει να τα κάνετε να μοιάζουν διαφορετικά.
+
+Ονόμασε μερικά μέρη του HTML. Πρόσθεσε μια τάξη που ονομάζεται `page-header` στο `div` που περιέχει την επικεφαλίδα σου, έτσι:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+Και τώρα να προσθέσετε μια τάξη `post` στο `div` που περιέχει ένα blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+Τώρα θα προσθέσουμε κώδικα σε διάφορους επιλογείς (selectors). Οι επιλογείς που ξεκινούν με `.` αναφέρονται σε τάξεις. Υπάρχουν πολλά σπουδαία σεμινάρια και εξηγήσεις σχετικά με την CSS στο δίκτυο τα οποία θα σε βοηθήσουν να καταλάβεις τον παρακάτω κώδικα. Προς το παρών, απλά αντίγραψε τα παρακάτω στο αρχείο `blog/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Μετά, βάλε τάξεις στον κώδικα HTML των posts. Αντικατάστησε αυτό:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+μέσα στο αρχείο `blog/templates/blog/post_list.html` με αυτό:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Αποθήκευσε τα αρχεία και ανανέωσε την ιστοσελίδα σου.
+
+![Σχήμα 14.4](images/final.png)
+
+Woohoo! Φαίνεται τέλειο, έτσι δεν είναι; Κοιτάξτε στον κωδικό που μόλις κάναμε επικόλληση για να βρείτε τα σημεία που προσθέσαμε τάξεις στο HTML και τα χρησιμοποιήσαμε στο CSS. Που θα κάνατε την αλλαγή αν θέλατε την ημερομηνία να είναι τιρκουάζ;
+
+Μην φοβάστε να πειραματιστείτε με το CSS λίγο και να προσπαθήσετε να αλλάξετε μερικά πράγματα. Παίζοντας με το CSS μπορεί να σε κάνει να καταλάβεις τι κάνουν τα διάφορα πράγματα. Εάν σπάσεις κάτι, μην ανησυχείς- μπορείς πάντα να το αναιρέσεις!
+
+Πραγματικά συστήνουμε να πάρετε αυτή την δωρεάν online σειρά μαθημάτων  Codeacademy HTML &amp. Μπορεί να σε βοηθήσει να μάθεις τα πάντα σχετικά με το να κάνεις τις ιστοσελίδες σου ομορφότερες με το CSS.</p> 
+
+Είσαι έτοιμη για το επόμενο κεφάλαιο; :)
\ No newline at end of file
diff --git a/el/deploy/README.md b/el/deploy/README.md
new file mode 100644
index 00000000000..609e0972a80
--- /dev/null
+++ b/el/deploy/README.md
@@ -0,0 +1,255 @@
+# Ανεβάστε!
+
+> **Σημείωση** Το ακόλουθο κεφάλαιο μπορεί να είναι μερικές φορές λίγο δύσκολο να ολοκληρωθεί. Επιμένετε και τελειώστε το, το ανέβασμα είναι ένα σημαντικό μέρος της διαδικασίας ανάπτυξης της ιστοσελίδας. Το κεφάλαιο αυτό τοποθετείται στη μέση του εκπαιδευτικού εγγράφου, έτσι ώστε να μέντορας σας να μπορεί να σας βοηθήσει με την ελαφρώς πιο περίπλοκη διαδικασία "ανεβάσματος" της ιστοσελίδας στο διαδίκτυο. Αυτό σημαίνει ότι μπορείτε να ολοκληρώσετε την εκπαίδευση μόνοι σας ακόμα και αν σας τελειώσει ο χρόνος.
+
+Μέχρι τώρα, η ιστοσελίδα σου ήταν μόνο διαθέσιμη στον υπολογιστή σου. Τώρα θα μάθεις πως να την αναπτύσσεις! Ανεβάζω στο διαδίκτυο" είναι η διαδικασία της δημοσίευσης την εφαρμογής σας στο διαδίκτυο, έτσι ώστε οι άνθρωποι τελικά να πάνε και να δουν την εφαρμογή σας. :)
+
+Όπως μάθατε, μια ιστοσελίδα πρέπει να βρίσκεται σε ένα διακομιστή. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+Η άλλη εξωτερική υπηρεσία που θα χρησιμοποιήσουμε είναι το [GitHub](https://www.github.com), το οποίο είναι μια υπηρεσία φιλοξενίας κώδικα. Υπάρχουν και άλλοι διαθέσιμοι έξω, αλλά σχεδόν όλοι οι προγραμματιστές έχουν λογαριασμό GitHub αυτές τις μέρες, και έτσι και εσείς θα έχετε τώρα!
+
+Αυτά τα τρία μέρη θα είναι σημαντικά για εσάς. Ο τοπικός σας υπολογιστής θα είναι το μέρος όπου θα κάνετε ανάπτυξη και δοκιμή. Όταν είστε ικανοποιημένοι με τις αλλαγές, θα τοποθετήσετε ένα αντίγραφο του προγράμματος σας στο GitHub. Η ιστοσελίδα σας θα είναι στο PythonAnywhere και θα την ενημερώσετε με το να πάρετε ένα καινούριο αντίγραφο του κωδικού σας από το GitHub.
+
+# Git
+
+> **Σημείωση** Αν κάνατε ήδη τα βήματα εγκατάστασης, δεν χρειάζεται να τα ξανακάνετε- μπορείτε να παραλείψετε στην επόμενη ενότητα και να ξεκινήσετε να δημιουργείτε το αρχείο αποθήκευσης του Git.
+
+{% include "/deploy/install_git.md" %}
+
+## Ξεκινώντας το αρχείο αποθήκευσής μας του Git
+
+Το Git παρακολουθεί τις αλλαγές σε ένα συγκεκριμένο σύνολο αρχείων που αποκαλείται αρχείο αποθήκευσης κώδικα (ή «ρεπό» εν συντομία). Ας ξεκινήσουμε ένα για την εφαρμογή μας. Ανοίξτε την κονσόλα σας και να εκτελέσετε αυτές τις εντολές, στον φάκελο`djangogirls`:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. Θα πρέπει να βρίσκεστε στο φάκελο `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Το όνομά σας"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Το Git θα παρακολουθείσει τις αλλαγές σε όλα τα αρχεία και τους φακέλους σε αυτόν τον κατάλογο, ωστόσο υπάρχουν ορισμένα αρχεία που θέλουμε να τα αγνοήσει. Το κάνουμε αυτό δημιουργώντας ένα αρχείο που ονομάζεται `.gitignore` στον αρχικό κατάλογο. Ανοίξτε το πρόγραμμα επεξεργασίας κειμένου και δημιουργήστε ένα νέο αρχείο με το ακόλουθο περιεχόμενο:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Σημείωση** Η τελεία στην αρχή του ονόματος του αρχείου είναι σημαντική! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. Αυτό το αρχείο είναι η τοπική σου βάση δεδομένων, όπου όλες οι δημοσιεύσεις σου αποθηκεύονται. Δεν θέλουμε να προσθέσουμε αυτό στην αποθήκη σας επειδή η ιστοσελίδα σας στο PythonAnywhere πρόκειται να χρησιμοποιεί διαφορετική βάση δεδομένων. Η βάση δεδομένων μπορεί να είναι SQLite, όπως η μηχανή ανάπτυξης σας, αλλά συνήθως θα χρησιμοποιείται μία που ονομάζεται MySQL η οποία μπορεί να ασχοληθεί με πολύ περισσότερους επισκέπτες από την SQLite. Έτσι και αλλιώς, αγνοώντας την βάση δεδομένων σας SQLite για την αντιγραφή στο GitHub, σημαίνει ότι όλες οι δημοσιεύσεις σας που έχετε δημιουργήσει μέχρι τώρα πρόκειται να μείνουν και να είναι διαθέσιμες τοπικά, αλλά θα πρέπει να τις προσθέσετε ξανά στην παραγωγή. Να σκέφτεστε την τοπική βάση δεδομένων σας ως ένα παιδότοπο όπου μπορείτε να δοκιμάσετε διαφορετικά πράγματα και να μην φοβάστε ότι πρόκειται να διαγράψετε τις αληθινές σας δημοσιεύσεις από το blog σας.
+
+Είναι καλή ιδέα να χρησιμοποιήσετε την εντολή `git status` πριν από την εντολή`git add` ή όποτε δεν είστε βέβαιοι για το τι έχει αλλάξει. Αυτό θα βοηθήσει να αποτραπούν οποιεσδήποτε εκπλήξεις, όπως το να προστεθούν ή να αποθηκευτούν λανθασμένα αρχεία. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. Τα δεδομένα εξόδου πρέπει να είναι παρόμοια με τα ακόλουθα:
+
+{% filename %}command-line{% endfilename %}
+
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Και τέλος σώζουμε τις αλλαγές μας. Πηγαίνετε στην κονσόλα σας και να εκτελέσετε αυτές τις εντολές:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (Αν το κάνατε ήδη στην προετοιμασία εργαστηρίου, θαυμάσια!)
+    
+    Έπειτα, δημιουργήστε ένα νέο χώρο αποθήκευσης, ονομάζοντας το "το πρώτο μου blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. Είναι πιθανώς ευκολότερο να παραμείνετε στο όνομα "το πρώτο μου blog".
+    
+    Στην επόμενη οθόνη, θα δείτε την διεύθυνση URL του κλώνου του αποθηκευτικού χώρου σας. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Πληκτρολογήστε τα ακόλουθα στην κονσόλα σας (Αντικαταστήστε '<your-github-username>; με το όνομα χρήστη που εισάγατε όταν δημιουργήσατε τον λογαριασμό GitHub σας, αλλά χωρίς τις αγκύλες)
+    
+    {% filename %}Γραμμή εντολών{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Εισάγετε το GitHub όνομα χρήστη και κωδικό σας και θα πρέπει να δείτε κάτι σαν αυτό:
+    
+    {% filename %}γραμμή εντολών{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Πηγαίνετε και τσεκάρετέ το!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Διαλέξτε την επιλογή να ξεκινήσετε μία κονσόλα "Bash" - αυτή είναι η PythonAnywhere έκδοση της κονσόλας, όπως αυτή στον υπολογιστή σας.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Ας τραβήξουμε μας κώδικά μας από το GitHub στο PythonAnywhere, δημιουργώντας έναν «κλώνο» του αρχείου αποθήκευσής μας. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Υπομονή, υπομονή!  Αλλά αν πάρει πάνω από πέντε λεπτά, κάτι είναι λάθος.  Ρωτήστε τον προπονητή σας.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. Έτσι οι λογαριασμοί χρήστη και οι δημοσιεύσεις μπορούν να είναι διαφορετικά στον διακομιστή και τον υπολογιστή σας.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. Είμαστε έτοιμοι να το δημοσιεύσουμε ως μία εφαρμογή δικτύου!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Μετά επιλέξτε **Python 3.6**, και κάντε κλικ στο κουμπί Next για να ολοκληρώσετε τον οδηγό.
+    
+    &gt; **Σημείωση** Σιγουρευτείτε να επιλέξετε την επιλογή "Manual configuration", όχι την "Django". Είμαστε πολύ κουλ για την προεπιλεγμένη PythonAnywhere Django εγκατάσταση. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Κάντε κλικ στο τσεκαρισμένο μπλε κουτί για να αποθηκεύσετε το μονοπάτι πριν συνεχίσετε.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. Εάν κάνετε ένα λάθος, το PythonAnywhere θα σας δείξει μια μικρή προειδοποίηση.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. Ο τρόπος που ρυθμίζουμε το PythonAnywhere να αναγνωρίζει τα Django blog μας είναι τροποποιώντας ένα αρχείο ρύθμισης παραμέτρων WSGI.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+Η δουλειά αυτού του αρχείου είναι να πει στο PythonAnywhere που ζει η εφαρμογή δικτύου μας και ποιο είναι το όνομα του αρχείου ρυθμίσεων Django.
+
+The `StaticFilesHandler` is for dealing with our CSS. Αυτό τακτοποιείται αυτόματα κατά την διάρκεια της τοπικής ανάπτυξης από την εντολή `runserver`. Θα μάθουμε λίγο περισσότερα για τα στατικά αρχεία αργότερα στο εγχειρίδιο, όταν θα επεξεργαστούμε το CSS για την ιστοσελίδα μας.
+
+Πατήστε **Save** και στη συνέχεια, επιστρέψτε στην καρτέλα **Web**.
+
+Είμαστε καθ'όλα έτοιμοι! Κλικάρετε το μεγάλο πράσινο κουμπί **Reload** και θα είστε σε θέση να δείτε την εφαρμογή σας. Θα βρείτε έναν σύνδεσμο σε αυτό στην κορυφή της σελίδας.
+
+## Συμβουλές για τον εντοπισμό σφαλμάτων
+
+Εάν εμφανιστεί ένα σφάλμα κατά την προσπάθειά σας να επισκεφθείτε την ιστοσελίδα σας, το πρώτο μέρος για να ψάξετε ορισμένες πληροφορίες εντοπισμού σφαλμάτων είναι στο αρχείο **error log**. Θα βρείτε ένα σύνδεσμο προς αυτό στην καρτέλα [Web](https://www.pythonanywhere.com/web_app_setup/) του PythonAnywhere. Δείτε εάν υπάρχουν κάποια μηνύματα σφάλματος εκεί. Τα πλέον συχνά εμφανίζονται στο κάτω μέρος. Τα πιο συνηθισμένα προβλήματα περιλαμβάνουν:
+
+- Ξεχνώντας ένα από τα βήματα που κάναμε στην κονσόλα: δημιουργία του virtualenv, ενεργοποίηση του, εγκατάσταση του Django σε αυτό, μετεγκατάσταση της βάσης δεδομένων.
+
+- Κάνοντας ένα λάθος στο μονοπάτι virtualenv στην καρτέλα Web- θα υπάρχει συνήθως ένα μικρό κόκκινο μήνυμα σφάλματος, εάν υπάρχει ένα πρόβλημα.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Πήρατε την ίδια έκδοση της Python για το virtualenv, όπως κάνατε για την εφαρμογή διαδικτύου; Και οι δύο θα πρέπει να είναι 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+Και να θυμάστε, ο εκπαιδευτής σας είναι εδώ να βοηθήσει!
+
+# Είστε συνδεδεμένοι!
+
+Η προεπιλεγμένη σελίδα για τον ιστότοπο σας πρέπει να λέει "Λειτουργεί!", όπως και στον τοπικό υπολογιστή σας. Δοκιμάστε να προσθέσετε το `/admin/` στο τέλος του URL, και θα μεταφερθείτε στην ιστοσελίδα διαχείρισης. Συνδεθείτε με το όνομα χρήστη και τον κωδικό πρόσβασης, και θα δείτε ότι μπορείτε να προσθέσετε νέες αναρτήσεις στο διακομιστή.
+
+Μόλις δημιουργήσετε μερικές δημοσιεύσεις, μπορείτε να πάτε πίσω στην τοπική σας εγκατάσταση (όχι το PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. Αυτό σας επιτρέπει να εργάζεστε και να πειραματίζεστε χωρίς να σπάσετε την ζωντανή σελίδα σας Web. Pretty cool, huh?
+
+Δώστε στον εαυτό σας ένα *ΜΕΓΑΛΟ* ελαφρύ χτύπημα στην πλάτη! Η εγκατάσταση σε έναν διακομιστή είναι ένα από τα πιο πολύπλοκα κομμάτια της ανάπτυξης εφαρμογών διαδικτύου και παίρνει συχνά αρκετές ημέρες στους ανθρώπους προτού να τις κάνουν λειτουργικές. Αλλά έχετε την ιστοσελίδα σας ζωντανή, στο πραγματικό Διαδίκτυο, ακριβώς όπως αυτό!
\ No newline at end of file
diff --git a/el/deploy/install_git.md b/el/deploy/install_git.md
new file mode 100644
index 00000000000..869f21b3f4f
--- /dev/null
+++ b/el/deploy/install_git.md
@@ -0,0 +1,52 @@
+Το Git είναι ένα «σύστημα ελέγχου έκδοσης» και χρησιμοποιείται από πολλούς προγραμματιστές. Αυτό το λογισμικό μπορεί να παρακολουθήσει τις αλλαγές στα αρχεία με την πάροδο του χρόνου έτσι ώστε να μπορείτε να ανακαλέσετε συγκεκριμένες εκδόσεις σε μεταγενέστερο στάδιο. Είναι κάτι σαν την δυνατότητα "παρακολούθησης αλλαγών" στο Microsoft Word, αλλά πολύ πιο ισχυρό.
+
+## Εγκαθιστώντας το Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Εκτός από αυτό, οι προκαθορισμένες ρυθμίσεις είναι σωστές. Επίσης η επιλογές Checkout Windows-style και Commit Unix-style κατά το τέλος μίας γραμμής είναι προτεινόμενες.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/el/deploy/signup_pythonanywhere.md b/el/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/el/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/el/django/README.md b/el/django/README.md
new file mode 100644
index 00000000000..5f271803f30
--- /dev/null
+++ b/el/django/README.md
@@ -0,0 +1,27 @@
+# Τι είναι το Django;
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. Ένα πλαίσιο διαδικτύου είναι ένα σύνολο από στοιχεία που σας βοηθά να αναπτύξετε ιστοσελίδες πιο γρήγορα και εύκολα.
+
+Όταν κατασκευάζετε μία ιστοσελίδα, χρειάζεστε πάντα ένα παρόμοιο σύνολο στοιχείων: έναν τρόπο για να χειρίζεστε τον έλεγχο ταυτότητας χρήστη (εγγραφή, σύνδεση, αποσύνδεση), ένα πάνελ διαχείρισης για την ιστοσελίδα σας, φόρμες, έναν τρόπο για να ανεβάσετε αρχεία, κ.λπ.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Γιατί χρειάζεστε ένα πλαίσιο;
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Φανταστείτε ένα γραμματοκιβώτιο (θύρα), το οποίο παρακολουθείται για εισερχόμενα γράμματα (αιτήματα). Αυτό γίνεται από έναν διακομιστή διαδικτύου. The web server reads the letter and then sends a response with a webpage. Αλλά όταν θέλετε να στείλετε κάτι, πρέπει να έχει και κάποιο περιεχόμενο. Και το Django είναι κάτι που σας βοηθάει να δημιουργήσετε αυτό το περιεχόμενο.
+
+## Τι συμβαίνει όταν κάποιος ζητά μια ιστοσελίδα από το διακομιστή σας;
+
+Όταν ένα αίτημα φτάσει σε ένα διακομιστή δικτύου, περνάει στο Django το οποίο προσπαθεί να καταλάβει τι ζητείται στην πραγματικότητα. Λαμβάνει πρώτα μια διεύθυνση σελίδας δικτύου και προσπαθεί να καταλάβει τι να κάνει. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). Δεν είναι πολύ έξυπνο- παίρνει μια λίστα από μοτίβα και προσπαθεί να ταιριάξει την διεύθυνση URL. Το Django ελέγχει πρότυπα από πάνω προς τα κάτω και αν κάτι ταιριάζει, το Django μεταβιβάζει το αίτημα στην σχετική λειτουργία ( η οποία ονομάζεται *view*).
+
+Φανταστείτε μια ταχυδρόμο με ένα γράμμα. Περπατάει στην οδό και ελέγχει κάθε αριθμό σπιτιού αν είναι ίδιος με τον αντίστοιχο αριθμό στο γράμμα. Αν ταιριάζει, βάζει το γράμμα εκεί. Αυτός είναι ο τρόπος που λειτουργεί το urlresolver!
+
+Στην λειτουργία *view*, γίνονται όλα τα ενδιαφέροντα πράγματα: μπορούμε να δούμε μια βάση δεδομένων για να ψάξουμε για μερικές πληροφορίες. Μήπως ο χρήστης ζήτησε να αλλάξει κάτι στα δεδομένα; Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Φυσικά, η παραπάνω περιγραφή είναι λίγο απλοποιημένη, αλλά δεν χρειάζεται να γνωρίζετε όλα τα τεχνικά ζητήματα ακόμη. Έχοντας μια γενική ιδέα είναι αρκετό.
+
+Έτσι αντί να αφιερώνουμε πάρα πολύ χρόνο σε λεπτομέρειες, θα ξεκινήσουμε απλά δημιουργώντας κάτι με το Django και θα μάθουμε όλα τα σημαντικά κομμάτια κατά μήκος του δρόμου!
\ No newline at end of file
diff --git a/el/django_admin/README.md b/el/django_admin/README.md
new file mode 100644
index 00000000000..a9d81fa62ce
--- /dev/null
+++ b/el/django_admin/README.md
@@ -0,0 +1,57 @@
+# Διαχείριση μέσω Django admin
+
+Για να προσθέσουμε, επεξεργαστούμε και να διαγράψουμε τις δημοσιεύσεις που έχουμε αναπτύξει, θα χρησιμοποιήσουμε τον διαχειριστή Django.
+
+Ας ανοίξουμε το αρχείο `blog/admin.py` και ας αντικαταστήσουμε τα περιεχόμενα του με αυτό:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Με τον παραπάνω κώδικα, εισάγουμε το μοντέλο Post (δηλαδή τον πίνακα της βάσης με όνομα Post) όπως ορίστηκε από το προηγούμενο κεφάλαιο. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+Εντάξη λοιπόν αγαπητοί κύριοι και κυρίες, ας ρίξουμε μια ματία στο Post μοντέλο μας. Θυμηθείτε ότι πρέπει πρώτα να πληκτρολογήσουμε `python manage.py runserver` στην κονσόλα μας ώστε να ξεκινήσει ο σερβερ μας. Go to your browser and type the address http://127.0.0.1:8000/admin/. Θα δείτε μία σελίδα σύνδεσης όπως αυτή:
+
+![Login page](images/login_page2.png)
+
+Για να συνδεθείτε, χρειάζεται να δημιουργήσετε ένα *superuser*- ένα λογαριασμό χρήστη ο οποίος έχει δικαιώματα σε οτιδήποτε σε αυτή την σελίδα. Πηγαίνετε πίσω στην γραμμή εντολών, πληκτρολογήστε `python manage.py createsuperuser`, και πατήστε enter.
+
+> Θυμηθείτε, για να γράψετε νέες εντολές ενώ ο διακομιστής του ιστότοπου εκτελείται, ανοίξτε ένα νέο παράθυρο ακροδέκτη και ενεργοποιήστε το virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/el/django_forms/README.md b/el/django_forms/README.md
new file mode 100644
index 00000000000..ce838756499
--- /dev/null
+++ b/el/django_forms/README.md
@@ -0,0 +1,447 @@
+# Φόρμες Django
+
+Το τελευταίο που έμεινε για την ιστοσελίδα μας είναι να δημιουργήσουμε μια όμορφη φόρμα για την εισαγαγωγή και τροποποίηση των blog post μας. Θα μπορούσαμε να χρησιμοποιήσουμε το Django `admin` αλλά είναι αρκετά πολύπλοκο να τροποποιήσουμε και να ωραιοποιήσουμε την φόρμα εισαγωγής. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+Μία από τις ευκολίες των Django φορμών είναι ότι μπορούμε να ξεκινήσουμε από το μήδεν ή να χρησιμοποιήσουμε το `ModelForm` που ουσιαστικά αποθηκεύει τα δεδομένα της φόρμας στο μοντέλο (ή διαφορετικά στο σωστό πίνακα της βάσης μας).
+
+Αυτό είναι ακριβώς που θέλουμε να κάνουμε δηλαδή να δημιουργήσουμε εύκολα μια φόρμα εισαγωγής δεδομένων για το ήδη προυπάρχων `Post` μοντέλο.
+
+Οπώς κάθε άλλο σημαντικό τμήμα του Django, οι φόρμες εισαγωγής "ζούν" στο δικό τους αρχείο: `forms.py`.
+
+Πρέπει να δημιουργήσουμε το αρχείο forms. py μέσα στην ντερέκτρορη `blog`.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Πρέπει να εισάγουμε αρχικά το module forms του Django (`from django import forms`) και φυσικά το μοντέλο `Post` (`from .models import Post`).
+
+Οπώς πιθανόν να υποψιάζεστε το `PostForm`, είναι το όνομα της φόρμας εισαγωγής. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Στην συνέχεια, έχουμε `class Meta`, όπου "λέμε" στο Django για ποίο μοντέλο πρέπει να δημιουργήσει την φόρμα εισαγωγής δεδομένων).
+
+Τέλος, πρέπει να ορίσουμε ποίο/α πεδίο/α πρέπει να διαθέσουμε στην φόρμα μας. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+Αυτό ήταν! Αυτό που μας απομένει είναι να χρησιμοποιήσουμε την φόρμα μας μέσα σε ένα *view* ώστε να είναι διαθεσίμη μέσω ενός template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Πως συνδέουμε μια σελίδα με την φόρμα μας
+
+Ανοίξτε το αρχείο `blog/templates/blog/base.html`. Θα προσθέσουμε το λινκ μέσα στο `div` με όνομα `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. Θα επιστρέψουμε σε αυτή την *άποψη*, αλλά για τώρα, ας δημιουργήσουμε γρήγορα ένα πρότυπο για την αίτηση.
+
+## Πρότυπο
+
+Πρέπει να δημιουργήσουμε ένα αρχείο `post_edit.html` στο κατάλογο `blog/templates/blog`. Για να κάνουμε μια αίτηση εργασίας χρειαζόμαστε αρκετά πράγματα:
+
+* Πρέπει να εμφανίσουμε την αίτηση. Μπορούμε να το κάνουμε αυτό με (για παράδειγμα) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* Η παραπάνω γραμμή πρέπει να τυλιχθεί με μία ετικέτα αίτησης HTML: `<form method="POST">...</form>`.
+* Χρειαζόμαστε ένα κουμπί `Αποθήκευση`. Το κάνουμε αυτό με ένα κουμπί HTML: `<button type="submit">Αποθήκευση</button>`.
+* Και στο τέλος, ακριβώς μετά την ετικέτα ανοίγματος `<form ...>` πρέπει να προσθέσουμε {% raw %}`{% csrf_token %}`{% endraw %}. Αυτό είναι πολύ σημαντικό, αφού καθιστά τις αιτήσεις σας ασφαλείς! Εάν ξεχάσετε αυτό το κομμάτι, το Django θα παραπονεθεί όταν προσπαθήσετε να αποθηκεύσετε την αίτηση:
+
+![CSFR Απαγορευμένη σελίδα](images/csrf2.png)
+
+Εντάξει, ας δούμε πως το HTML στο `post_edit.html` πρέπει να δείχνει:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Ώρα να ανανεώσετε! Ναι! Η αίτηση σας εμφανίζεται!
+
+![Νέα αίτηση](images/new_form2.png)
+
+Αλλά, περιμένετε ένα λεπτό! Όταν πληκτρολογείτε κάτι στα πεδία `τίτλο` και `κείμενο`και προσπαθήσετε να το αποθηκεύσετε, τι θα συμβεί;
+
+Τίποτα! Είμαστε άλλη μια φορά στην ίδια σελίδα και το κείμενο μας έχει εξαφανιστεί... και δεν έχει προστεθεί καμία νέα δημοσίευση, Οπότε τι πήγε λάθος;
+
+Η απάντηση είναι: τίποτα. Πρέπει να κάνουμε λίγη περισσότερη δουλειά στο *προβολή* μας.
+
+## Αποθηκεύοντας την αίτηση
+
+Ανοίξτε `blog/views.py` ξανά. Προς το παρόν αυτό που έχουμε στο `post_new` θέα είναι τα ακόλουθα:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Όταν υποβάλουμε την αίτηση, επανερχόμαστε στην ίδια θέα, αλλά αυτή τη φορά έχουμε περισσότερα δεδομένα στο `αίτημα`, πιο συγκεκριμένα στο `αίτηση.POST` (το όνομα δεν έχει να κάνει με μία "δημοσίευση" blog, έχει να κάνει με το γεγονός ότι "δημοσιεύουμε" δεδομένα). Θυμηθείτε πως στον φάκελο HTML, ο `<form>` ορισμός μας είχε την μεταβλητή `method="POST"`; Όλα τα πεδία από την αίτηση είναι στο `request.POST`. Δεν πρέπει να μετονομάσετε το `POST` σε οτιδήποτε άλλο ( η μόνο άλλη έγκυρη τιμή για το `method` είναι `GET`, αλλά δεν έχουμε χρόνο για να εξηγήσουμε ποια είναι η διαφορά).
+
+Έτσι στο *view* έχουμε δύο ξεχωριστές καταστάσεις να διαχειριστούμε: πρώτον, όταν αποκτούμε πρόσβαση στην σελίδα για πρώτη φορά και θέλουμε μία άδεια αίτηση, και δεύτερον, όταν πάμε πίσω στο *view* με όλα τα δεδομένα αίτησης που μόλις πληκτρολογήσαμε. Επομένως, πρέπει να προσθέσουμε μια συνθήκη ( θα χρησιμοποιήσουμε `if` για αυτό):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+Είναι καιρός να συμπληρώσουμε τις τελείες `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? Θα το κάνουμε αυτό όπως ακολουθεί:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+Το επόμενο πράγμα είναι να ελέγξουμε αν η αίτηση είναι σωστή ( όλα τα απαιτούμενα πεδία έχουν οριστεί και δεν έχουν υποβληθεί εσφαλμένες τιμές). Το κάνουμε αυτό με `form.is_valid()`.
+
+Ελέγχουμε αν η αίτηση είναι έγκυρη και αν ναι, μπορούμε να την αποθηκεύσουμε!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Βασικά, έχουμε δύο πράγματα εδώ: αποθηκεύουμε την αίτηση με `form.save` και προσθέτουμε έναν συγγραφέα ( μιας και δεν υπήρχε πεδίο `συγγραφέα` στο `PostForm` και αυτό το πεδίο είναι απαραίτητο). `commit=False` σημαίνει ότι δεν θέλουμε να αποθηκεύσουμε το μοντέλο `Post` ακόμα - θέλουμε να προσθέσουμε τον αναγνώστη πρώτα. Τις περισσότερες φορές θα χρησιμοποιήσετε το `form.save()` χωρίς το `commit=False`, αλλά σε αυτή την περίπτωση, πρέπει να το προμηθεύσουμε. `post.save()` θα διατηρήσει τις αλλαγές (προσθέτοντας τον συγγραφέα) και δημιουργείται ένα νέο blog post!
+
+Τέλος, θα ήταν τρομερό εάν μπορούσαμε να πάμε αμέσως στην `post_detail` σελίδα για το νεοσυσταθέν blog post μας, σωστά; Για να το κάνουμε αυτό χρειαζόμαστε μια ακόμα είσοδο:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+από ανακατεύθυνση εισαγωγής django.shortcuts
+```
+
+Προσθέστε το στην αρχή του αρχείου σας. Και τώρα μπορούμε να πούμε, "πηγαίνετε στη `post_detail` σελίδα για το νεοσυσταθέν post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` είναι το όνομα της προβολής στο οποίο θέλουμε να πάμε. Θυμηθείτε ότι αυτή η *άποψη * απαιτεί μία μεταβλητή `pk`; Για να το περάσουμε στις απόψεις, χρησιμοποιούμε `pk=post.pk`, όπου `post` είναι το νεοσύστατο blog post!
+
+Εντάξει. έχουμε μιλήσει πολύ. αλλά μάλλον θέλουμε να δούμε πως μοιάζει το *view*, σωστά;
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Ας δούμε αν λειτουργεί. Πηγαίνετε στην σελίδα http://127.0.0.1:8000/post/new/, προσθέστε ένα `τίτλο` και `κείμενο`, αποθηκεύστε το… και voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Αυτό μοιάζει σχεδόν ίδιο με την `post_new` προβολή, σωστά; Αλλά όχι εντελώς. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+… και όταν έχουμε μόλις ανοίξει μία αίτηση με αυτή τη δημοσίευση για να επεξεργαστούμε:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+Εντάξει, ας δοκιμάσουμε αν λειτουργεί! Πάμε στην σελίδα `post_detail`. Θα πρέπει να υπάρχει ένα κουμπί επεξεργασίας στην πάνω δεξιά γωνία:
+
+![Κουμπί επεξεργασίας](images/edit_button2.png)
+
+Όταν κάνετε κλικ θα δείτε την φόρμα με την δημοσίευση στο blog μας:
+
+![Επεξεργαστείτε αίτηση](images/edit_form2.png)
+
+Νιώστε ελεύθεροι να αλλάξετε τον τίτλο η το κείμενο και να αποθηκεύσετε τις αλλαγές!
+
+Συγχαρητήρια! Η εφαρμογή σας γίνεται όλο και πιο πλήρης!
+
+Εάν χρειάζεστε περισσότερες πληροφορίες για τις φόρμες Django, θα πρέπει να διαβάσετε τα έγγραφα: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Ασφάλεια
+
+Το να μπορείς να δημιουργήσεις νέες δημοσιεύσεις κάνοντας απλώς ένα κλικ σε ένα σύνδεσμο είναι φοβερό! Αλλά τώρα, οποιοσδήποτε επισκεφθεί την σελίδα σας θα μπορεί να φτιάξει μία καινούρια δημοσίευση blog, και αυτό είναι κάτι που πιθανώς δεν θέλετε. Ας το κάνουμε έτσι ώστε το κουμπί εμφανίζεται για εσάς αλλά για κανέναν άλλο.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Πρόκειται να προσθέσουμε άλλη μία ετικέτα `{% if %}` σε αυτό, το οποίο θα κάνει τον σύνδεσμο να εμφανίζεται μόνο για χρήστες που είναι συνδεδεμένοι στον διαχειριστή. Προς το παρόν, είστε μόνο εσείς! Αλλάξτε την ετικέτα `<a>` να μοιάζει σαν αυτό:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+Αυτό `{% if %}` θα προκαλέσει τον σύνδεσμο να σταλθεί στο πρόγραμμα περιήγησης μόνο αν ο χρήστης που ζητά την σελίδα είναι συνδεδεμένος. Αυτό δεν προστατεύει την δημιουργία νέων δημοσιεύσεων εντελώς, αλλά είναι ένα καλό πρώτο βήμα. Θα καλύψουμε περισσότερη ασφάλεια στα μαθήματα επέκτασης.
+
+Θυμάστε το εικονίδιο επεξεργασίας που μόλις προσθέσαμε στην σελίδα λεπτομερειών; Θέλουμε επίσης να προσθέσουμε την ίδια αλλαγή εκεί, ώστε άλλα άτομα δεν θα μπορούν να επεξεργαστούν τις υπάρχουσες δημοσιεύσεις.
+
+Ανοίξτε το `blog/templates/blog/post_detail.html` και βρείτε αυτή τη γραμμή:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Αλλάξτε το σε αυτό:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Μιας και είστε πιθανότατα συνδεδεμένοι, εάν ανανεώσετε την σελίδα, δεν θα δείτε τίποτα διαφορετικό. Φορτώστε την σελίδα σε ένα διαφορετικό πρόγραμμα περιήγησης ή ένα παράθυρο ανώνυμης περιήγησης ( που ονομάζεται "InPrivate" στο Windows Edge), όμως, και θα δείτε ότι ο σύνδεσμος δεν εμφανίζεται, ούτε και το εικονίδιο!
+
+## Ένα πράγμα ακόμα: ώρα να αναπτύξετε!
+
+Για να δούμε αν όλα αυτά λειτουργούν στο PythonAnywhere. Ώρα για άλλη μια ανάπτυξη!
+
+* Πρώτα, δεσμεύστε τον νέο σας κωδικό, και βάλτε τον στο GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+Και αυτό είναι! Συγχαρητήρια :)
\ No newline at end of file
diff --git a/el/django_installation/README.md b/el/django_installation/README.md
new file mode 100644
index 00000000000..8bd1a1f96a1
--- /dev/null
+++ b/el/django_installation/README.md
@@ -0,0 +1,7 @@
+# Εγκατάσταση του Django
+
+> **Σημείωση** Αν χρησιμοποιείτε ένα Chromebook, παραλείψτε αυτό το κεφάλαιο και σιγουρευτείτε ότι ακουλουθείτε τις [Chromebook Setup](../chromebook_setup/README.md) οδηγίες.
+> 
+> **Σημείωση** αν έχετε ήδη περάσει τα βήματα εγκατάστασης τότε το έχετε ήδη κάνει αυτό - μπορείτε να πάτε απευθείας στο επόμενο κεφάλαιο!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/el/django_installation/instructions.md b/el/django_installation/instructions.md
new file mode 100644
index 00000000000..f69041c8c8a
--- /dev/null
+++ b/el/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Μέρος αυτής της ενότητας βασίζεται στα σεμινάρια από τα Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Εικονικό περιβάλλον
+
+Πρίν να εγκαταστήσουμε το Django, θα εγκαταστήσουμε ενα εξαιρετικά χρήσιμο εργαλείο για να κρατίσουμε το περιβάλλον του υπολογιστή σου τακτοποιημένο. Μπορείς να παραλείψεις αυτό το βήμα, αλλά συστήνουμε να το ακολουθήσεις. Ξεκινώντας με το καλύτερο δυνατό περιβάλλον, θα αποφύγεις πολλά προβλήματα στο μέλλον!
+
+Λοιπόν, ας δημιουργήσουμε ενα ** εικονικό περιβάλλον** (το αποκαλούμενο *virtualenv*). Το virtualenv θα απομονώσει την κάθε εγκατάσταση Python/Django ανά έργο. Αυτό σημαίνει οι αλλαγές που κάνεις σε μια ιστιοσελίδα δεν επηρεάζουν οποιεσδήποτε άλλες ιστιοσελίδες που επίσης αναπτύσσεις παράλληλα. Καλό, ε;
+
+Το μόνο που χρειάζεται να κάνεις είναι να βρείς έναν κατάλογο στον οποίο θέλεις να δημιουργήσεις το `virtualenv`. Το home directory σου, για παράδειγμα. Στα Windows, θα μοιάζει κάπως έτσι `C:\Users\Name` ( όπου `Name` είναι το όνομα της σύνδεσης σας).
+
+> **ΣΗΜΕΙΩΣΗ:** Στα Windows, σιγουρευτείτε ότι αυτός ο κατάλογος δεν περιέχει χαρακτήρες που τονίζονται ή ειδικούς χαρακτήρες, αν το όνομα χρήστη σας περιέχει χαρακτήρες που τονίζονται, χρησιμοποιείστε ένα διαφορετικό κατάλογο, για παράδειγμα, `C:\djangogirls`.
+
+Για αυτό το tutorial θα χρησιμοποιήσουμε ένα νεο κατάλογο `djangogirls` από το home directory σου:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Θα δημιουργήσουμε ένα virtualenv που ονομάζεται `myvenv`. Η γενική εντολή είναι:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Όπου `myvenv` είναι το όνομα του `virtualenv` σας. Μπορείς να χρησιμοποιήσεις οποιοδήποτε άλλο όνομα, αλλά πρέπει να είναι σε πεζά, χωρίς κενά, εμφάσεις ή ειδικούς χαρακτήρες. Είναι επίσης καλή ιδέα να κρατήσετε το όνομα μικρό - θα το αναφέρετε συχνά!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+Το `myvenv` είναι το όνομα του `virtualenv` σου. Μπορείς να χρησιμοποιήσεις οποιοδήποτε άλλο όνομα, αλλα πρέπει να είναι σε πεζά και χωρίς κενά. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Το εικονικό περιβάλλον δεν δημιουργήθηκε επιτυχώς επειδή το ensurepip δεν είναι διαθέσιμο.  Στα συστήματα Debian/Ubuntu, πρέπει να εγκαταστήσετε το πακέτο python3-venv χρησιμοποιώντας την ακόλουθη εντολή.
+>        apt-get install python3-venv
+>     Μπορεί να χρειαστεί να χρησιμοποιήσετε το sudo με αυτή την εντολή.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Δουλεύοντας με το virtualenv
+
+Η παραπάνω εντολή θα δημιουργήσει ένα κατάλογο που ονομάζεται `myvenv` (ή όποιο άλλο όνομα διαλέξετε) που περιέχει το εικονικό μας περιβάλλον (βασικά ένα μάτσο καταλόγων και αρχείων).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Ξεκινήστε το εικονικό σας περιβάλλον εκτελώντας:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **ΣΗΜΕΙΩΣΗ:** στα Windows 10 μπορεί να λάβετε ένα σφάλμα στο Windows PowerShell που λέει ` η εκτέλεση των σεναρίων έχει απενεργοποιηθεί σε αυτό το σύστημα `. Σε αυτή την περίπτωση, ανοίξτε ένα άλλο Windows PowerShell με την επιλογή "Εκτέλεση ως διαχειριστής". Έπειτα δοκιμάστε να πληκτρολογήσετε την ακόλουθη εντολή πριν ξεκινήσετε το εικονικό περιβάλλον σας:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Αλλάζοντας την πολιτική εκτέλεσης μπορεί να σας εκθέσει σε ρίσκα ασφάλειας που περιγράφονται στο θέμα βοήθειας about_Execution_Policies στο http://go.microsoft.com/fwlink/?LinkID=135170. Θέλετε να αλλάξετε την πολιτική εκτέλεσης; [Y] Ναι [A] Ναι σε όλα [N] Όχι [L] Όχι σε όλα [S] Διακοπή [?] Βοήθεια (προεπιλεγμένο είναι το "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Ξεκινήστε το εικονικό σας περιβάλλον εκτελώντας:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Θυμηθείτε να αντικαταστήσετε το `myvenv` με το επιλεγμένο `virtualenv` όνομα σας!
+
+> **ΣΗΜΕΙΩΣΗ:** μερικές φορές `πηγή` μπορεί να μην είναι διαθέσιμη. Σε αυτές τις περιπτώσεις προσπαθήστε να κάνετε αυτό:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+Θα ξέρετε ότι έχετε ξεκινήσει το `virtualenv` όταν δείτε ότι γραμμή εντολών στην κονσόλα σας είναι προκαθορισμένη με `(myvenv)`.
+
+Όταν δουλεύετε μέσα σε ένα εικονικό περιβάλλον, `python` θα αναφέρετε αυτόματα στην σωστή έκδοση ώστε να μπορείτε να χρησιμοποιήσετε `python` αντί για `python3`.
+
+Εντάξει, έχουμε τοποθετήσει όλες τις σημαντικές εξαρτήσεις. Μπορούμε επιτέλους να εγκαταστήσουμε το Django!
+
+## Εγκατάσταση Django
+
+Τώρα που έχετε ξεκινήσει το `virtualenv` σας, μπορείτε να εγκαταστήσετε το Django.
+
+Πριν κάνουμε αυτό, πρέπει να σιγουρευτούμε ότι έχουμε την τελευταία έκδοση του `pip`, το λογισμικό που χρησιμοποιούμε για να εγκαταστήσουμε το Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> Εάν λάβετε ένα σφάλμα όταν καλείται το μπιπ στην πλατφόρμα Windows, παρακαλούμε ελέγξτε εάν το μονοπάτι ονόματος του έργου σας περιέχει κενά, εμφάσεις ή ειδικούς χαρακτήρες (για παράδειγμα,`C:\Users\User Name\djangogirls`). Εάν το κάνει, παρακαλώ σκεφτείτε να χρησιμοποιήσετε μία άλλη θέση χωρίς κενά, εμφάσεις ή ειδικούς χαρακτήρες (πρόταση: `C:\djangogirls`). Δημιουργήστε ένα νέο virtualenv στον νέο κατάλογο, μετά σβήστε τον παλιό και δοκιμάστε την παραπάνω εντολή ξανά. (Το να μετακινήσετε τον κατάλογο virtualenv δεν θα δουλέψει μιας και το virtualenv χρησιμοποιεί απόλυτες διαδρομές.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Η γραμμή εντολών σας μπορεί να παγώσει αφού προσπαθήσετε να εγκαταστήσετε το Django. Εάν γίνει αυτό, αντί για την παραπάνω εντολή χρησιμοποιήστε:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+Αυτό είναι! Είστε (επιτέλους) έτοιμοι να δημιουργήσετε μια εφαρμογή Django!
\ No newline at end of file
diff --git a/el/django_models/README.md b/el/django_models/README.md
new file mode 100644
index 00000000000..7ba4cd1e323
--- /dev/null
+++ b/el/django_models/README.md
@@ -0,0 +1,200 @@
+# Μοντέλα (models) του Django
+
+Αυτό που θέλουμε να δημιουργήσουμε τώρα είναι κάτι που θα αποθηκεύει όλες τις αναρτήσεις του blog μας. Αλλά για να είμαστε σε θέση να το κάνουμε, πρέπει να μιλήσουμε λίγο για το τι ονομάζουμε `"αντικείμενα" (objects)`.
+
+## Αντικείμενα (objects)
+
+Υπάρχει μια έννοια στον προγραμματισμό που ονομάζεται `"Αντικειμενοστραφής προγραμματισμός`. Η ιδέα είναι ότι αντί να γράφετε τα πάντα ως μια βαρετή ακολουθία από προγραμματιστικές εντολές, μπορούμε να μοντελοποιήσουμε τα πράγματα και να καθορίσουμε πως αλληλεπιδρούν μεταξύ τους.
+
+Άρα, τι είναι ένα αντικείμενο; Είναι μια συλλογή από ιδιότητες και συμπεριφορές. Ακούγεται παράξενο, αλλά θα σας δώσουμε ένα παράδειγμα.
+
+Εάν θέλουμε να μοντελοποιήσουμε μια γάτα, θα δημιουργήσουμε ένα αντικείμενο `Γάτα` το οποίο έχει κάποιες ιδιότητες όπως `χρώμα`, `ηλικία`, `διάθεση` (όπως καλή, κακή, νυσταγμένη :)), και `ιδιοκτήτης`(που θα μπορεί να ανατεθεί σε ένα αντικείμενο `άτομο` - ή ίσως, στην περίπτωση μιας αδέσποτης γάτας, αυτή η ιδιότητα θα μπορούσε να είναι άδεια).
+
+Έπειτα η `γάτα` έχει κάποιες δράσεις `γουργούρισμα`, `ξύσιμο` ή `τάισμα`( σε αυτή την περίπτωση, θα δώσουμε στην γάτα λίγη `γατοτροφή`, που θα μπορούσε να είναι ένα ξεχωριστό αντικείμενο με ιδιότητες, όπως `γεύση`).
+
+    Γάτα
+    _________
+    χρώμα
+    ηλικία
+    συμπεριφορά
+    ιδιοκτήτης
+    γουργούρισμα()
+    ξύσιμο()
+    τάισμα(γατο_τροφή)
+    
+
+    Γατοτροφή
+    __________
+    
+    γεύση
+    
+
+Έτσι, βασικά η ιδέα είναι να περιγράψουμε τα αληθινά πράγματα στον κώδικα με ιδιότητες (που ονομάζονται `ιδιότητες αντικειμένου`) και συμπεριφορές (που ονομάζονται `μέθοδοι αντικειμένου`).
+
+Πώς θα μοντελοποιήσουμε τότε τις αναρτήσεις του blog; Θέλουμε να κατασκευάσουμε ένα blog, σωστά;
+
+Πρέπει να δώσουμε απάντηση στο ερώτημα: τι είναι μία ανάρτηση στο blog; Τι ιδιότητες πρέπει να έχει;
+
+Λοιπόν, σίγουρα μία ανάρτηση στο blog μας χρειάζεται κάποιο κείμενο με το περιεχόμενό του και έναν τίτλο, σωστά; Θα ήταν επίσης ωραίο να ξέρουμε ποιος το έγραψε αυτό - έτσι χρειαζόμαστε ένα συγγραφέα. Τέλος, θέλουμε να γνωρίζουμε πότε δημιουργήθηκε και δημοσιεύτηκε η συγκεκριμένη ανάρτηση.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Τι είδους πράγματα θα μπορούσαν να γίνουν με μια ανάρτηση στο blog; Θα ήταν ωραίο να έχουμε κάποια `μέθοδο` που δημοσιεύει την ανάρτηση, σωστά;
+
+Έτσι, θα χρειαστούμε μια μέθοδο `publish`.
+
+Δεδομένου ότι γνωρίζουμε ήδη τι θέλουμε να επιτύχουμε, ας ξεκινήσουμε τη μοντελοποίηση στο Django!
+
+## Μοντέλο του Django
+
+Γνωρίζοντας τι είναι ένα αντικείμενο, μπορούμε να δημιουργήσουμε ένα μοντέλο Django για την ανάρτηση στο blog μας.
+
+Ένα μοντέλο στο Django είναι ένα ιδιαίτερο είδος αντικειμένου- αποθηκεύεται στο `database`. Η βάση δεδομένων είναι μια συλλογή δεδομένων. Είναι εκεί όπου θα αποθηκεύεις πληροφορίες για τους χρήστες σου, τις αναρτήσεις στο blog, κλπ. Θα χρησιμοποιήσουμε την βάση δεδομένων SQLite για την αποθήκευση των δεδομένων μας. Αυτός είναι ο προεπιλεγμένος μετασχηματιστής βάσης δεδομένων Django - είναι αρκετό για εμάς για τώρα.
+
+Μπορείς να σκεφτείς ένα μοντέλο της βάσης δεδομένων ως ένα υπολογιστικό φύλλο με στήλες (πεδία) και γραμμές (δεδομένα).
+
+### Δημιουργία μιας εφαρμογής
+
+Για να κρατήσουμε τα πάντα τακτοποιημένα, θα δημιουργήσουμε μια ξεχωριστή εφαρμογή μέσα στο project μας. Είναι πολύ ωραίο να έχουμε τα πάντα οργανωμένα από την αρχή. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Θα παρατηρήσετε ότι ένας νέος`blog` κατάλογος δημιουργείται και περιέχει έναν αριθμό αρχείων. Οι κατάλογοι και τα αρχεία στο έργο μας πρέπει να μοιάζουν κάπως έτσι:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+Μετά την δημιουργία μίας εφαρμογής, πρέπει επίσης να πούμε στο Django ότι πρέπει να το χρησιμοποιήσει. Αυτό το κάνουμε στο αρχείο `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. Έτσι το τελικό προϊόν πρέπει να μοιάζει κάπως έτσι:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField`- αυτό είναι για μεγάλα κείμενα χωρίς ένα όριο. Ακούγεται ιδανικό για περιεχόμενο δημοσιεύσεων blog, έτσι δεν είναι;
+- `models.DateTimeField`- αυτό είναι μια ημερομηνία και ώρα.
+- `models.ForeignKey`- αυτό είναι ένας σύνδεσμος για ένα άλλο μοντέλο.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? Αυτή είναι ακριβώς η μέθοδος `publish` για την οποία μιλούσαμε πριν. `def` σημαίνει ότι είναι αυτή είναι μια λειτουργία/μέθοδος και `publish` είναι το όνομα της μεθόδου. Μπορείτε να αλλάξετε το όνομα της μεθόδου αν θέλετε. Ο κανόνας ονομασίας είναι ότι χρησιμοποιούμε μικρά γράμματα και κάτω παύλες αντί για κενά. Για παράδειγμα, μια μέθοδος που υπολογίζει την μέση τιμή θα λεγόταν `υπολογισμός_μέσης_τιμής`.
+
+Οι μέθοδοι συχνά `επιστρέφουν` κάτι. Υπάρχει ένα παράδειγμα αυτού στη μέθοδο `__str__`. Σε αυτό το σενάριο, όταν καλούμε την `__str__()` θα λάβουμε ένα κείμενο (**string**) με ένα τίτλο θέσης.
+
+Επίσης προσέξτε ότι και το `def publish(self):` και το `def __str__(self):` "χτυπημένα" μέσα στην κλάση μας. Επειδή η Python είναι ευαίσθητη στο whitespace, πρέπει να "χτυπήσουμε" τις μεθόδους μας μέσα στην κλάση. Αλλιώς, οι μέθοδοι δεν θα ανήκουν στην κλάση, και μπορεί να συναντήσετε απρόοπτη συμπεριφορά.
+
+Εάν κάτι ακόμα δεν είναι ξεκάθαρο σχετικά με τα μοντέλα, μη διστάσετε να ρωτήσετε τον καθηγητή σας! Ξέρουμε ότι είναι περίπλοκο, ειδικά όταν μαθαίνετε τι είναι τα αντικείμενα και οι λειτουργίες ταυτόχρονα. But hopefully it looks slightly less magic for you now!
+
+### Δημιουργήστε πίνακες για πρότυπα στην βάση δεδομένων σας
+
+Το τελευταίο βήμα εδώ είναι να προσθέσουμε το νέο μοντέλο μας στην βάση δεδομένων μας. Πρώτα πρέπει να ενημερώσουμε το Django ότι έχουμε κάποιες αλλαγές στο μοντέλο μας. (Μόλις το δημιουργήσαμε!) Πηγαίνετε στο παράθυρο της κονσόλας σας και πληκτρολογήστε `python manage.py makemigrations blog`. Θα μοιάζει κάπως έτσι:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Σημείωση:** Θυμηθείτε να αποθηκεύετε τα αρχεία που επεξεργάζεστε. Αλλιώς, ο υπολογιστής σας θα εκτελέσει τις προηγούμενες εκδόσεις που μπορεί να σας δώσει μηνύματα απρόοπτων σφαλμάτων.
+
+Το Django προετοίμασε ένα φάκελο μετανάστευσης για εμάς που πρέπει τώρα να εφαρμόσουμε στην βάση δεδομένων μας. Πληκτρολογήστε `python manage.py migrate blog` και τα αποτελέσματα πρέπει να είναι όπως ακολουθεί:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Ζήτω! Το μοντέλο ανάρτησης μας είναι στην βάση δεδομένων μας! Θα ήταν ωραίο να το δούμε, σωστά; Πηγαίνετε στο επόμενο κεφάλαιο για να δείτε πως μοιάζει η ανάρτηση σας!
\ No newline at end of file
diff --git a/el/django_orm/README.md b/el/django_orm/README.md
new file mode 100644
index 00000000000..4fb48d881d2
--- /dev/null
+++ b/el/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM και QuerySets
+
+Σε αυτό το κεφάλαιο θα μάθετε πως το Django συνδέεται στην βάση δεδομένων και αποθηκεύει δεδομένα μέσα της. Ας ξεκινήσουμε!
+
+## Τι είναι ένα QuerySet;
+
+Ένα QuerySet είναι, στην ουσία, μία λίστα αντικειμένων ενός δοθέν Μοντέλου. Τα QuerySets σας επιτρέπουν να διαβάσετε τα δεδομένα από την βάση δεδομένων, να τα φιλτράρετε και να τα ταξινομήσετε.
+
+Είναι πιο εύκολο να μάθεις κάνοντας. Πάμε να δοκιμάσουμε;
+
+## Παράθυρο εντολών Django
+
+Άνοιξε την τοπική σου κονσόλα (όχι στο PythonAnywhere) και πληκτρολόγησε αυτήν την εντολή:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Το αποτέλεσμα πρέπει να είναι σαν αυτό:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Είστε τώρα στην διαδραστική κονσόλα του Django. Είναι ακριβώς όπως το παράθυρο εντολών της Python, αλλά με μερική επιπρόσθετη μαγεία Django. :) Μπορείτε να χρησιμοποιήσετε όλες τις εντολές Python εδώ επίσης, φυσικά.
+
+### Όλα τα αντικείμενα
+
+Ας προσπαθήσουμε να εμφανίσουμε όλες τις δημοσιεύσεις του blog μας πρώτα. Μπορείς να το κάνεις με την ακόλουθη εντολή:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Ωχ! Εμφανίστηκε ένα λάθος, μας λέει ότι δεν υπάρχει καμία δημοσίευση. Είναι σωστό- ξεχάσαμε να το εισάγουμε πρώτα!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+Εισάγουμε το μοντέλο `Post` from `blog.models`. Ας προσπαθήσουμε να εμφανίσουμε όλες τις αναρτήσεις ξανά:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Αυτή είναι μια λίστα των αναρτήσεων που δημιουργήσαμε νωρίτερα! Δημιουργήσαμε αυτές τις αναρτήσεις χρησιμοποιώντας το περιβάλλον διαχειριστή Django. Αλλά τώρα θέλουμε να δημιουργήσουμε νέες αναρτήσεις χρησιμοποιώντας την Python, οπότε πως το κάνουμε αυτό;
+
+### Δημιουργία αντικειμένου
+
+Έτσι δημιουργείτε ένα νέο αντικείμενο Ανάρτηση στην βάση δεδομένων:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Αλλά μας λείπει ένα συστατικό εδώ: `εγώ`. Χρειαζόμαστε να περάσουμε μία παρουσία του μοντέλου `Χρήστη` ως συγγραφέα. Πως το κάνουμε αυτό;
+
+Ας εισάγουμε το μοντέλο Χρήστη πρώτα:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Τι χρήστες έχουμε στην βάση δεδομένων μας; Δοκιμάστε αυτό:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+Αυτός είναι ο υπέρ-χρήστης που δημιουργήσαμε νωρίτερα! Ας λάβουμε μία παρουσία του χρήστη τώρα:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Ζήτω! Θέλετε να ελέγξετε αν λειτούργησε;
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Αυτό είναι, άλλη μια δημοσίευση στην λίστα!
+
+### Προσθέστε περισσότερες δημοσιεύσεις
+
+Τώρα μπορείτε να διασκεδάσετε λίγο και να προσθέσετε περισσότερες δημοσιεύσεις για να δείτε πως δουλεύει. Προσθέστε δυο-τρεις ακόμα και μετά προχωρήστε στο επόμενο μέρος.
+
+### Φιλτράρισμα αντικειμένων
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+Τα QuerySets επίσης σου επιτρέπουν να ταξινομήσεις την λίστα των αντικειμένων. Ας προσπαθήσουμε να τα ταξινομήσουμε με το πεδίο `ημερομηνία_δημιουργίας`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Μπορούμε επίσης να αντιστρέψουμε την ταξινόμηση προσθέτοντας `-` στην αρχή:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Αλυσιδωτά QuerySets
+
+Μπορείτε επίσης να συνδυάσετε QuerySets με το να τα **αλυσοδέσετε** μαζί:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+Αυτό είναι πολύ ισχυρό και σας επιτρέπει να γράψετε αρκετά σύνθετα ερωτήματα.
+
+Ωραία! Τώρα είστε έτοιμοι για το επόμενο μέρος! Για να κλείσετε το κέλυφος, πληκτρολογήστε αυτό:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/el/django_start_project/README.md b/el/django_start_project/README.md
new file mode 100644
index 00000000000..5717d039951
--- /dev/null
+++ b/el/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Το πρώτο σας έργο Django!
+
+> Μέρος αυτού του κεφαλαίου είναι βασισμένο στα σεμινάρια από τα Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+Πρόκειται να δημιουργήσουμε ένα μικρό blog!
+
+Το πρώτο βήμα είναι να ξεκινήσουμε ένα νέο έργο Django. Βασικά, αυτό σημαίνει ότι θα εκτελέσουμε μερικά σενάρια που παρέχονται από το Django τα οποία θα δημιουργήσουν τον σκελετό ενός πρότζεκτ Django για εμάς. Αυτά είναι ένα μάτσο καταλόγων και αρχείων που θα χρησιμοποιήσουμε αργότερα.
+
+Τα ονόματα μερικών αρχείων και καταλόγων είναι πολύ σημαντικά για το Django. Δεν πρέπει να μετονομάσετε τα αρχεία που πρόκειται να δημιουργήσουμε. Μετακινώντας τα σε ένα διαφορετικό μέρος δεν είναι επίσης καλή ιδέα. Το Django χρειάζεται να διατηρήσει μία συγκεκριμένη δομή για να μπορεί να βρει σημαντικά πράγματα.
+
+> Θυμηθείτε να εκτελέσετε τα πα΄ντα στο εικονικό περιβάλλον. Εάν δεν δείτε ένα πρόθημα `(περιβάλλον)` στην κονσόλα σας, θα πρέπει να ενεργοποιήσετε το εικονικό περιβάλλον σας. Εξηγήσαμε πως να το κάνετε αυτό στο κεφάλαιο **Εγκατάσταση Django** στο κομμάτι **Δουλεύοντας με το εικονικό περιβάλλον**. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+Στην κονσόλα σας Mac OS X ή Linux, πρέπει να εκτελέσετε την ακόλουθη εντολή. ** Μην ξεχάσετε να προσθέσετε την περίοδο (ή τελεία)`. ` στο τέλος!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Η τελεία `.` είναι ζωτικής σημασίας επειδή λέει στο σενάριο να εγκαταστήσει το Django στο τρέχον κατάλογο σας ( για το οποίο η τελεία `.` είναι μία βραχυπρόθεσμη αναφορά).
+> 
+> **Σημείωση** Όταν πληκτρολογείτε την παραπάνω εντολή, θυμηθείτε ότι πληκτρολογείτε το κομμάτι που ξεκινά με `διαχειριστής-django`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Στα Windows πρέπει να εκτελέσετε την ακόλουθη εντολή. **(Μην ξεχάσετε να προσθέσετε την περίοδο (ή τελεία)`.` στο τέλος)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`διαχειριστής-django.py` είναι ένα σενάριο που θα δημιουργήσει τους καταλόγους και τα αρχεία για εσάς, Θα πρέπει τώρα να έχετε μια δομή καταλόγου που μοιάζει κάπως έτσι:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Σημείωση**: Στην δομή καταλόγου σας, θα δείτε επίσης τον κατάλογο σας `εικονικό περιβάλλον` που δημιουργήσαμε προηγουμένως.
+
+`διαχείριση.py` είναι ένα σενάριο που βοηθά με την διαχείριση της σελίδας. Με αυτό θα μπορούμε να (μεταξύ άλλων πραγμάτων) ξεκινήσουμε ένα διακομιστή ιστού στον υπολογιστή μας χωρίς να εγκαταστήσουμε οτιδήποτε άλλο.
+
+Το αρχείο `ρυθμίσεις.py` περιέχει την διαμόρφωση παραμέτρων της ιστοσελίδας σας.
+
+Θυμάστε όταν μιλήσαμε σχετικά με ένα μεταφορέα αλληλογραφίας που ελέγχει που να παραδώσει ένα γράμμα; Το αρχείο `urls.py` περιέχει μία λίστα από σχέδια που χρησιμοποιούνται από το `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Σημείωση**: Αν χρησιμοποιείτε ένα Chromebook, προσθέστε αυτή τη γραμμή στο τέλος του αρχείου σας settings.py: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Δημιουργία μιας βάσης δεδομένων
+
+Υπάρχουν πολλά διαφορετικά λογισμικά βάσης δεδομένων που μπορούν να αποθηκεύσουν δεδομένα για την σελίδα σας. Θα χρησιμοποιήσουμε το προεπιλεγμένο, `sqlite3`.
+
+Αυτό έχει ήδη εγκατασταθεί σε αυτό το τμήμα του αρχείου σας `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Για να δημιουργήσετε μία βάση δεδομένων για το blog μας, ας εκτελέσουμε το ακόλουθο στην κονσόλα: `python manage.py migrate` ( χρειάζεται να είμαστε στον κατάλογο `djangogirls` που περιέχει το αρχείο `manage.py`). Αν αυτό πάει καλά, θα πρέπει να δείτε κάτι σαν αυτό:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+Και τελειώσαμε! Ώρα να ξεκινήσουμε τον διακομιστή ιστού και να δούμε εάν η ιστοσελίδα μας λειτουργεί!
+
+## Εκκίνηση του διακομιστή ιστού
+
+Θα πρέπει να είστε στον κατάλογο που περιέχει το αρχείο `manage.py` ( στον κατάλογο `djangogirls`). Στην κονσόλα, μπορούμε να ξεκινήσουμε τον διακομιστή ιστού εκτελώντας `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Εάν είστε σε ένα Chromebook, χρησιμοποιείστε αυτή την εντολή:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+Αν είστε σε Windows και αυτή η ενέργεια αποτύχει με το `UnicodeDecodeError`, χρησιμοποιείστε αντί για αυτό, αυτή την εντολή:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/el/django_templates/README.md b/el/django_templates/README.md
new file mode 100644
index 00000000000..688d2245260
--- /dev/null
+++ b/el/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Σχήμα 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Σχήμα 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Σχήμα 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Σχήμα 13.4](images/donut.png)
\ No newline at end of file
diff --git a/el/django_urls/README.md b/el/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/el/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/el/django_views/README.md b/el/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/el/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/el/dynamic_data_in_templates/README.md b/el/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/el/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/el/extend_your_application/README.md b/el/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/el/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/el/how_the_internet_works/README.md b/el/how_the_internet_works/README.md
new file mode 100644
index 00000000000..76af208ee6a
--- /dev/null
+++ b/el/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Σχήμα 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Σχήμα 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Σχήμα 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Σχήμα 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/el/html/README.md b/el/html/README.md
new file mode 100644
index 00000000000..538a404ee9d
--- /dev/null
+++ b/el/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Σχήμα 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Σχήμα 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Σχήμα 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Σχήμα 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/el/install_git.md b/el/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/el/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/el/installation/README.md b/el/installation/README.md
new file mode 100644
index 00000000000..23cc9661962
--- /dev/null
+++ b/el/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Εισαγωγή στην Python](../python_introduction/README.md)
+
+* [Τι είναι το Django;](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/el/instructions.md b/el/instructions.md
new file mode 100644
index 00000000000..d042926b29a
--- /dev/null
+++ b/el/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for you instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/el/intro_to_command_line/README.md b/el/intro_to_command_line/README.md
new file mode 100644
index 00000000000..ff8927b678c
--- /dev/null
+++ b/el/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Έγινε! Για να βεβαιωθείς οτι έχει διαγραφεί, ας το ελέγξουμε:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### $ rm -r practice
+
+Αυτά για τώρα! Μπορείς να κλείσεις τη γραμμή εντολών με ασφάλεια τώρα. Ας το κάνουμε με τον τρόπο του χάκερ, εντάξει? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Ωραίο, ε? :)
+
+## Περίληψη
+
+Μια περίληψη κάποιων χρήσιμων εντολών:
+
+| Εντολή (Windows) | Εντολή (Mac OS / Linux) | Περιγραφή                     | Παράδειγμα                                        |
+| ---------------- | ----------------------- | ----------------------------- | ------------------------------------------------- |
+| exit             | exit                    | κλείσιμο παραθύρου            | **exit**                                          |
+| cd               | cd                      | αλλάξτε κατάλογο              | **cd test**                                       |
+| cd               | pwd                     | show the current directory    | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir              | ls                      | λίστα καταλόγων/αρχείων       | **dir**                                           |
+| copy             | cp                      | αντιγραφή αρχείου             | **copy c:\test\test.txt c:\windows\test.txt** |
+| move             | mv                      | move file                     | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir            | mkdir                   | δημιούργησε έναν νέο κατάλογο | **mkdir testdirectory**                           |
+| rmdir (or del)   | rm                      | delete a file                 | **del c:\test\test.txt**                        |
+| rmdir /S         | rm -r                   | delete a directory            | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Είστε έτοιμη;
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/el/python_installation/README.md b/el/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/el/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/el/python_installation/instructions.md b/el/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/el/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/el/python_introduction/README.md b/el/python_introduction/README.md
new file mode 100644
index 00000000000..010f97ff08b
--- /dev/null
+++ b/el/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Εισαγωγή στην Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Ας γράψουμε λίγο κώδικα!
+
+## Παράθυρο εντολών Python
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+Για να αρχίσεις να παίζεις με την Python, πρέπει να ανοίξεις μια *γραμμή εντολών* στον υπολογιστή σου. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Μόλις είσαι έτοιμη, ακολούθησε τις παρακάτω οδηγίες.
+
+Θέλουμε να ανοίξουμε μια κονσόλα Python, έτσι πληκτρολόγησε `python` σε Windows ή `python3` σε Mac OS/Linux και πατήστε `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Η πρώτη σου Python εντολή!
+
+Αφού εκτέλεσες την εντολή Python, το παράθυρο εντολών άλλαξε σε `>>>`. Για εμάς αυτό σημαίνει ότι τώρα μπορούμε να χρησιμοποιούμε μόνο εντολές για τη γλώσσα Python. You don't have to type in `>>>` – Python will do that for you.
+
+Εάν θέλεις να τερματίσεις την κονσόλα Python σε οποιοδήποτε σημείο, απλά πληκτρολόγησε `exit()` ή `Ctrl + Z` για Windows και `Ctrl + D` για το Mac/Linux. Τότε δεν θα μπορείς να δείς το `>>>` πια.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Διασκέδασε με αυτό για λίγο και στη συνέχεια έλα πίσω εδώ. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Περίληψη
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Περίληψη
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Περίληψη
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Περίληψη
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/el/signup_pythonanywhere.md b/el/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/el/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/el/template_extending/README.md b/el/template_extending/README.md
new file mode 100644
index 00000000000..ca905372bc5
--- /dev/null
+++ b/el/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Ένα άλλο ωραίο πράγμα που προσφέρει το Django είναι η **επέκταση των templates**. Τι σημαίνει αυτό; Αυτό σημαίνει ότι μπορείς να χρησιμοποιήσεις τα ίδια κομμάτια HTML για διαφορετικές σελίδες του διαδυκτιακού σου τόπου.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+Το base template είναι το πιο βασικό template που μπορείς να επεκτείνεις σε κάθε σελίδα του ιστιότοπού σου.
+
+Ας δημιουργήσουμε ένα αρχείο `base.html` μεσα στο `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Στη συνέχεια, άνοιξε το και να αντίγραψε τα πάντα από `post_list.html` στο `base.html`, έτσι:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Στη συνέχεια στο `base.html`, αντικατάστησε τα περιεχόμενα `<body>`(τα πάντα μεταξύ `<body>`και `</body>`) με αυτό:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). Θα σου δείξουμε πως να το κάνεις αυτο σε μια στιγμή.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Έτσι:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Αυτό είναι! Έλεγξε εάν η ιστοσελίδα σου εξακολουθεί να λειτουργεί σωστά. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/el/whats_next/README.md b/el/whats_next/README.md
new file mode 100644
index 00000000000..91c16a4bb0d
--- /dev/null
+++ b/el/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Να συγχαρείς τον εαυτό σου! **Είσαι φοβερή**. Είμαστε περήφανοι! <3
+
+### Τι μπορείς να κάνεις τώρα;
+
+Κάνε ένα διάλειμμα και χαλάρωσε. Μόλις έχεις κάνει κάτι πραγματικά τεράστιο.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/en/README.md b/en/README.md
index d639cc1e3d5..147df99bf89 100644
--- a/en/README.md
+++ b/en/README.md
@@ -5,9 +5,9 @@
 > To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
 
 ## Welcome
-Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
 
-As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
 
 ## Introduction
 
@@ -21,7 +21,7 @@ We hope that we'll be able to make you love technology as much as we do!
 
 ## What will you learn during the tutorial?
 
-Once you've finished the tutorial, you will have a simple, working web application: your own blog. We will show you how to put it online, so others will see your work!
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
 
 It will (more or less) look like this:
 
@@ -33,7 +33,7 @@ OK, [let's start at the beginning…](./how_the_internet_works/README.md)
 
 ## Following the tutorial at home
 
-It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
 
 In every chapter already covered, there is a link that points to the correct video.
 
@@ -42,10 +42,10 @@ In every chapter already covered, there is a link that points to the correct vid
 
 This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
 
-## Would you like to help us translate the tutorial to other languages?
+## Would you like to help us translate the tutorial into other languages?
 
 Currently, translations are being kept on crowdin.com platform at:
 
 https://crowdin.com/project/django-girls-tutorial
 
-If your language is not listed on crowdin, please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
diff --git a/en/SUMMARY.md b/en/SUMMARY.md
index ffa1b240450..59e8d01d2ae 100644
--- a/en/SUMMARY.md
+++ b/en/SUMMARY.md
@@ -2,6 +2,14 @@
 
 * [Introduction](README.md)
 * [Installation](installation/README.md)
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github)
+  * [PythonAnywhere](installation/README.md#pythonanywhere)
 * [Installation (chromebook)](chromebook_setup/README.md)
 * [How the Internet works](how_the_internet_works/README.md)
 * [Introduction to command line](intro_to_command_line/README.md)
@@ -14,7 +22,7 @@
 * [Django models](django_models/README.md)
 * [Django admin](django_admin/README.md)
 * [Deploy!](deploy/README.md)
-* [Django urls](django_urls/README.md)
+* [Django URLs](django_urls/README.md)
 * [Django views – time to create!](django_views/README.md)
 * [Introduction to HTML](html/README.md)
 * [Django ORM (Querysets)](django_orm/README.md)
diff --git a/en/chromebook_setup/README.md b/en/chromebook_setup/README.md
index a4843977603..cadeff050a0 100644
--- a/en/chromebook_setup/README.md
+++ b/en/chromebook_setup/README.md
@@ -1,5 +1,5 @@
 # Chromebook setup
 
-> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
 
-{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
+{% include "/chromebook_setup/instructions.md" %}
diff --git a/en/chromebook_setup/instructions.md b/en/chromebook_setup/instructions.md
index d7c8e4384c8..973e368c6a0 100644
--- a/en/chromebook_setup/instructions.md
+++ b/en/chromebook_setup/instructions.md
@@ -2,67 +2,173 @@ You can [skip right over this section](http://tutorial.djangogirls.org/en/instal
 are, your installation experience will be a little different. You can ignore the
 rest of the installation instructions.
 
-### Cloud 9
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
 
-Cloud 9 is a tool that gives you a code editor and access to a computer running
-on the Internet where you can install, write, and run software. For the duration
-of the tutorial, Cloud 9 will act as your _local machine_. You'll still be
+Cloud IDE is a tool that gives you a code editor and access to a computer running
+on the Internet where you can install, write, and run the software. For the duration
+of the tutorial, cloud IDE will act as your _local machine_. You'll still be
 running commands in a terminal interface just like your classmates on OS X,
 Ubuntu, or Windows, but your terminal will be connected to a computer running
-somewhere else that Cloud 9 sets up for you.
+somewhere else that cloud IDE sets up for you.
+Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com).
+You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click _New Server_ and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left.
+Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+```
+$
+```
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions.
+You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+Currently Cloud 9 requires you to sign up with AWS and enter credit card
+information.
 
 1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
-2. Go to [c9.io](https://c9.io)
-3. Sign up for an account
-4. Click _Create a New Workspace_
-5. Name it _django-girls_
-6. Select the _Blank_ (second from the right on the bottom row with orange logo)
+2. Go to [c9.io](https://c9.io) and click _Get started with AWS Cloud9_
+3. Sign up for an AWS account (requires credit card information, but you can
+   use it for free)
+4. In the AWS Dashboard, enter _Cloud9_ in the search bar and click it
+5. In the Cloud 9 dashboard, click _Create environment_
+6. Name it _django-girls_
+7. While configuring settings, select _Create a new instance for environment
+   (EC2)_ for "Environment Type" and the _t2.micro_ "Instance type" (it should
+   say "Free-tier eligible."). The default cost-saving setting is fine and you
+   can keep the other defaults.
+8. Click _Next step_
+9. Click _Create environment_
 
 Now you should see an interface with a sidebar, a big main window with some
 text, and a small window at the bottom that looks something like this:
 
-{% filename %}Cloud 9{% endfilename %}
+{% filename %}bash{% endfilename %}
 ```
 yourusername:~/workspace $
 ```
 
-This bottom area is your _terminal_, where you will give the computer Cloud 9
-has prepared for you instructions. You can resize that window to make it a bit
+This bottom area is your terminal. You can use the terminal to send instructions
+to the remote Cloud 9 computer. You can resize that window to make it a bit
 bigger.
 
-### Virtual Environment
+#### Glitch.com Cloud IDE
 
-A virtual environment (also called a virtualenv) is like a private box we can
-stuff useful computer code into for a project we're working on. We use them to
-keep the various bits of code we want for our various projects separate so
-things don't get mixed up between projects.
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click _New Project_ and choose _hello-webpage_
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
 
-In your terminal at the bottom of the Cloud 9 interface, run the following:
+{% filename %}Terminal{% endfilename %}
+```
+app@name-of-your-glitch-project:~
+```
 
-{% filename %}Cloud 9{% endfilename %}
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment.
+Instead, create the following files manually:
+
+{% filename %}glitch.json{% endfilename %}
+```json
+{
+  "install": "pip3 install -r requirements.txt --user",
+  "start": "bash start.sh",
+  "watch": {
+    "throttle": 1000
+  }
+}
+```
+
+{% filename %}requirements.txt{% endfilename %}
 ```
-sudo apt update
-sudo apt install python3.6-venv
+Django~={{ book.django_version }}
 ```
 
-If this still doesn't work, ask your coach for some help.
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+```
+django-admin.py startproject mysite .
+refresh
+```
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application.
+Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail.
+(If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.)
+Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can
+stuff useful computer code into for a project we're working on. We use them to
+keep the various bits of code we want for our various projects separate so
+things don't get mixed up between projects.
 
-Next, run:
+Run:
 
 {% filename %}Cloud 9{% endfilename %}
 ```
 mkdir djangogirls
 cd djangogirls
-python3.6 -mvenv myvenv
+python3 -m venv myvenv
 source myvenv/bin/activate
-pip install django~=1.11.0
+pip install django~={{ book.django_version }}
 ```
 
-(note that on the last line we use a tilde followed by an equal sign: ~=).
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
 
-### Github
+### GitHub
 
-Make a [Github](https://github.com) account.
+Make a [GitHub](https://github.com) account.
 
 ### PythonAnywhere
 
@@ -74,7 +180,7 @@ people can see your work.
 This part is a little odd when doing the tutorial on a Chromebook since we're
 already using a computer that is on the Internet (as opposed to, say, a laptop).
 However, it's still useful, as we can think of our Cloud 9 workspace as a place
-or our "in progress" work and Python Anywhere as a place to show off our stuff
+for our "in progress" work and Python Anywhere as a place to show off our stuff
 as it becomes more complete.
 
 Thus, sign up for a new Python Anywhere account at
diff --git a/en/code_editor/README.md b/en/code_editor/README.md
index e9f908b2936..c1ff8c58248 100644
--- a/en/code_editor/README.md
+++ b/en/code_editor/README.md
@@ -4,8 +4,8 @@
 
 You're about to write your first line of code, so it's time to download a code editor!
 
-> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
 
-> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
 
 {% include "/code_editor/instructions.md" %}
diff --git a/en/code_editor/instructions.md b/en/code_editor/instructions.md
index f00c716f82f..4255dfc4754 100644
--- a/en/code_editor/instructions.md
+++ b/en/code_editor/instructions.md
@@ -2,6 +2,12 @@ There are a lot of different editors and it largely boils down to personal prefe
 
 Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
 
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
 ## Gedit
 
 Gedit is an open-source, free editor, available for all operating systems.
@@ -10,14 +16,14 @@ Gedit is an open-source, free editor, available for all operating systems.
 
 ## Sublime Text 3
 
-Sublime Text is a very popular editor with a free evaluation period. It's easy to install and use, and it's available for all operating systems.
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
 
 [Download it here](https://www.sublimetext.com/3)
 
 
 ## Atom
 
-Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source, easy to install and easy to use. It's available for Windows, OS X and Linux.
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
 
 [Download it here](https://atom.io/)
 
diff --git a/en/css/README.md b/en/css/README.md
index 9a0051f2ca6..5a89a14b4c2 100644
--- a/en/css/README.md
+++ b/en/css/README.md
@@ -16,15 +16,14 @@ It was written by programmers who worked for Twitter. Now it's developed by volu
 
 ## Install Bootstrap
 
-To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
-<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
 ```
 
-This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
 
 ![Figure 14.1](images/bootstrap1.png)
 
@@ -38,7 +37,7 @@ Finally we will take a closer look at these things we've been calling __static f
 
 ### Where to put static files for Django
 
-Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
 
 We do that by creating a folder called `static` inside the blog app:
 
@@ -46,7 +45,8 @@ We do that by creating a folder called `static` inside the blog app:
 djangogirls
 ├── blog
 │   ├── migrations
-│   └── static
+│   ├── static
+│   └── templates
 └── mysite
 ```
 
@@ -67,24 +67,25 @@ djangogirls
 
 Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
 
-We won't be going too deep into customizing and learning about CSS here. It's pretty easy and you can learn it on your own after this workshop. There is a recommendation for a free course to learn more at the end of this page.
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
 
-But let's do at least a little. Maybe we could change the color of our header?
+But let's do at least a little. Maybe we could change the color of our headers?
 To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
 
 In your `blog/static/css/blog.css` file you should add the following code:
 
 {% filename %}blog/static/css/blog.css{% endfilename %}
 ```css
-h1 a {
-    color: #FCA205;
+h1 a, h2 a {
+    color: #C25100;
 }
+
 ```
 
-`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
 
 In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names.
-We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
 
 ```html
 <a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
@@ -92,11 +93,11 @@ We also identify elements by the attribute `class` or the attribute `id`. Class
 
 You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
 
-We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
-{% load staticfiles %}
+{% load static %}
 ```
 
 We're just loading static files here. :)
@@ -106,32 +107,32 @@ Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS fi
 ```html
 <link rel="stylesheet" href="{% static 'css/blog.css' %}">
 ```
-The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may override code in Bootstrap files.
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files.
 We just told our template where our CSS file is located.
 
 Your file should now look like this:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
-{% load staticfiles %}
+{% load static %}
+<!DOCTYPE html>
 <html>
     <head>
         <title>Django Girls blog</title>
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
         <link rel="stylesheet" href="{% static 'css/blog.css' %}">
     </head>
     <body>
-        <div>
+        <header>
             <h1><a href="/">Django Girls Blog</a></h1>
-        </div>
+        </header>
 
         {% for post in posts %}
-            <div>
-                <p>published: {{ post.published_date }}</p>
-                <h1><a href="">{{ post.title }}</a></h1>
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
                 <p>{{ post.text|linebreaksbr }}</p>
-            </div>
+            </article>
         {% endfor %}
     </body>
 </html>
@@ -167,8 +168,8 @@ Find the `h1 a` declaration block (the code between braces `{` and `}`) in the C
 
 {% filename %}blog/static/css/blog.css{% endfilename %}
 ```css
-h1 a {
-    color: #FCA205;
+h1 a, h2 a {
+    color: #C25100;
     font-family: 'Lobster';
 }
 ```
@@ -180,47 +181,52 @@ Great!
 
 As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post).  A class can help you make them look different.
 
-Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
-<div class="page-header">
-    <h1><a href="/">Django Girls Blog</a></h1>
-</div>
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
 ```
 
-And now add a class `post` to your `div` containing a blog post.
+And now add a class `post` to your `article` containing a blog post.
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
-<div class="post">
-    <p>published: {{ post.published_date }}</p>
-    <h1><a href="">{{ post.title }}</a></h1>
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
     <p>{{ post.text|linebreaksbr }}</p>
-</div>
+</article>
 ```
 
-We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
 
 {% filename %}blog/static/css/blog.css{% endfilename %}
 ```css
 .page-header {
-    background-color: #ff9400;
+    background-color: #C25100;
     margin-top: 0;
+    margin-bottom: 40px;
     padding: 20px 20px 20px 40px;
 }
 
-.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
     color: #ffffff;
     font-size: 36pt;
     text-decoration: none;
 }
 
-.content {
-    margin-left: 40px;
-}
-
-h1, h2, h3, h4 {
+h1,
+h2,
+h3,
+h4 {
     font-family: 'Lobster', cursive;
 }
 
@@ -232,11 +238,14 @@ h1, h2, h3, h4 {
     float: right;
 }
 
-.post-form textarea, .post-form input {
+.post-form textarea,
+.post-form input {
     width: 100%;
 }
 
-.top-menu, .top-menu:hover, .top-menu:visited {
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
     color: #ffffff;
     float: right;
     font-size: 26pt;
@@ -247,9 +256,27 @@ h1, h2, h3, h4 {
     margin-bottom: 70px;
 }
 
-.post h1 a, .post h1 a:visited {
+.post h2 a,
+.post h2 a:visited {
     color: #000000;
 }
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
 ```
 
 Then surround the HTML code which displays the posts with declarations of classes. Replace this:
@@ -257,11 +284,11 @@ Then surround the HTML code which displays the posts with declarations of classe
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
 {% for post in posts %}
-    <div class="post">
-        <p>published: {{ post.published_date }}</p>
-        <h1><a href="">{{ post.title }}</a></h1>
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
         <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    </article>
 {% endfor %}
 ```
 
@@ -269,21 +296,21 @@ in the `blog/templates/blog/post_list.html` with this:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
-<div class="content container">
+<main class="container">
     <div class="row">
-        <div class="col-md-8">
+        <div class="col">
             {% for post in posts %}
-                <div class="post">
-                    <div class="date">
-                        <p>published: {{ post.published_date }}</p>
-                    </div>
-                    <h1><a href="">{{ post.title }}</a></h1>
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
                     <p>{{ post.text|linebreaksbr }}</p>
-                </div>
+                </article>
             {% endfor %}
         </div>
     </div>
-</div>
+</main>
 ```
 
 Save those files and refresh your website.
@@ -295,7 +322,6 @@ Look at the code we just pasted to find the places where we added classes in the
 
 Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
 
-We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
 
 Ready for the next chapter?! :)
-
diff --git a/en/deploy/README.md b/en/deploy/README.md
index 202528bd62c..c6c4c6dde4d 100644
--- a/en/deploy/README.md
+++ b/en/deploy/README.md
@@ -4,7 +4,7 @@
 
 Until now, your website was only available on your computer.  Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
 
-As you learned, a website has to be located on a server. There are a lot of server providers available on the internet. We will use one that has a relatively simple deployment process: [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
 The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
 
@@ -12,7 +12,7 @@ These three places will be important to you.  Your local computer will be the pl
 
 # Git
 
-> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
 
 {% include "/deploy/install_git.md" %}
 
@@ -36,20 +36,48 @@ Git will track changes to all the files and folders in this directory, but there
 
 {% filename %}.gitignore{% endfilename %}
 ```
+# Python
 *.pyc
 *~
 __pycache__
-myvenv
+
+# Env
+.env
+myvenv/
+venv/
+
+# Database
 db.sqlite3
-/static
+
+# Static folder at project root
+/static/
+
+# macOS
+._*
 .DS_Store
+.fseventsd
+.Spotlight-V100
+
+# Windows
+Thumbs.db*
+ehthumbs*.db
+[Dd]esktop.ini
+$RECYCLE.BIN/
+
+# Visual Studio
+.vscode/
+.history/
+*.code-workspace
 ```
 
 And save it as `.gitignore` in the "djangogirls" folder.
 
-> **Note** The dot at the beginning of the file name is important!  If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> **Note** The dot at the beginning of the file name is important!  If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`.
+Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden
+and the normal `ls` command won't show these files.
+Instead use `ls -a` to see the `.gitignore` file.
 
-> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database.  That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
 
 It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
 
@@ -58,7 +86,7 @@ It's a good idea to use a `git status` command before `git add` or whenever you
 $ git status
 On branch master
 
-Initial commit
+No commits yet
 
 Untracked files:
   (use "git add <file>..." to include in what will be committed)
@@ -67,6 +95,7 @@ Untracked files:
         blog/
         manage.py
         mysite/
+        requirements.txt
 
 nothing added to commit but untracked files present (use "git add" to track)
 ```
@@ -75,33 +104,33 @@ And finally we save our changes. Go to your console and run these commands:
 
 {% filename %}command-line{% endfilename %}
 ```
-$ git add --all .
+$ git add .
 $ git commit -m "My Django Girls app, first commit"
  [...]
  13 files changed, 200 insertions(+)
  create mode 100644 .gitignore
  [...]
  create mode 100644 mysite/wsgi.py
- ```
+```
 
 
 ## Pushing your code to GitHub
 
-Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
 
 Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
 
-<img src="images/new_github_repo.png" />
+![](images/new_github_repo.png)
 
-> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
 
-On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
 
-<img src="images/github_get_repo_url_screenshot.png" />
+![](images/github_get_repo_url_screenshot.png)
 
 Now we need to hook up the Git repository on your computer to the one up on GitHub.
 
-Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
 
 {% filename %}command-line{% endfilename %}
 ```
@@ -109,16 +138,14 @@ $ git remote add origin https://github.com/<your-github-username>/my-first-blog.
 $ git push -u origin master
 ```
 
-Enter your GitHub username and password and you should see something like this:
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
 
 {% filename %}command-line{% endfilename %}
 ```
-Username for 'https://github.com': hjwp
-Password for 'https://hjwp@github.com':
 Counting objects: 6, done.
 Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
 Total 3 (delta 0), reused 0 (delta 0)
-To https://github.com/hjwp/my-first-blog.git
+To https://github.com/ola/my-first-blog.git
  * [new branch]      master -> master
 Branch master set up to track remote branch master from origin.
 ```
@@ -130,168 +157,102 @@ Your code is now on GitHub. Go and check it out!  You'll find it's in fine compa
 
 # Setting up our blog on PythonAnywhere
 
+## Sign up for a PythonAnywhere account
+
 > **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
 
 {% include "/deploy/signup_pythonanywhere.md" %}
 
 
-## Pulling our code down on PythonAnywhere
+## Configuring our site on PythonAnywhere
 
-When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
 
-<img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" />
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
 
 > **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
 
-Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`):
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application.  There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
 
 {% filename %}PythonAnywhere command-line{% endfilename %}
 ```
-$ git clone https://github.com/<your-github-username>/my-first-blog.git
+$ pip3.8 install --user pythonanywhere
 ```
 
-This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
 
 {% filename %}PythonAnywhere command-line{% endfilename %}
 ```
-$ tree my-first-blog
-my-first-blog/
-├── blog
-│   ├── __init__.py
-│   ├── admin.py
-│   ├── migrations
-│   │   ├── 0001_initial.py
-│   │   └── __init__.py
-│   ├── models.py
-│   ├── tests.py
-│   └── views.py
-├── manage.py
-└── mysite
-    ├── __init__.py
-    ├── settings.py
-    ├── urls.py
-    └── wsgi.py
+$ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
 ```
 
+As you watch that running, you'll be able to see what it's doing:
 
-### Creating a virtualenv on PythonAnywhere
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
 
-Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
 
 {% filename %}PythonAnywhere command-line{% endfilename %}
 ```
-$ cd my-first-blog
-
-$ virtualenv --python=python3.6 myvenv
-Running virtualenv with interpreter /usr/bin/python3.6
-[...]
-Installing setuptools, pip...done.
-
-$ source myvenv/bin/activate
-
-(myvenv) $  pip install django~=1.11.0
-Collecting django
-[...]
-Successfully installed django-1.11.3
+(ola.pythonanywhere.com) $ python manage.py createsuperuser
 ```
 
+Type in the details for your admin user.  Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
 
-> **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
-
-<!--TODO: think about using requirements.txt instead of pip install.-->
-
-### Creating the database on PythonAnywhere
-
-Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
-
-Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
 
 {% filename %}PythonAnywhere command-line{% endfilename %}
 ```
-(mvenv) $ python manage.py migrate
-Operations to perform:
-[...]
-  Applying sessions.0001_initial... OK
-(mvenv) $ python manage.py createsuperuser
+(ola.pythonanywhere.com) $ ls
+blog  db.sqlite3  manage.py  mysite requirements.txt static
+(ola.pythonanywhere.com) $ ls blog/
+__init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+tests.py  views.py
 ```
 
-## Publishing our blog as a web app
-
-Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
-
-Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
 
-After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
-
-> **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
-
-
-### Setting the virtualenv
-
-You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
-
-<img src="images/pythonanywhere_web_tab_virtualenv.png" />
-
-In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/<your-PythonAnywhere-username>/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
-
-> **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
-
-
-### Configuring the WSGI file
-
-Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
-
-Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/<your-PythonAnywhere-username>_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
-
-Delete all the contents and replace them with the following:
-
-{% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
-```python
-import os
-import sys
-
-path = os.path.expanduser('~/my-first-blog')
-if path not in sys.path:
-    sys.path.append(path)
-
-os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
-
-from django.core.wsgi import get_wsgi_application
-from django.contrib.staticfiles.handlers import StaticFilesHandler
-application = StaticFilesHandler(get_wsgi_application())
-```
 
-This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+## You are now live!
 
-The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+Your site should now be live on the public Internet!  Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
 
-Hit **Save** and then go back to the **Web** tab.
 
-We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view.  If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
 
 
 ## Debugging tips
 
-If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
 
-- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
 
-- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully.  Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
 
-- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
 
-- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
 
-There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
 
 And remember, your coach is here to help!
 
 
-# You are live!
+# Check out your site!
 
-The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
 
 Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
 
 
-Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
diff --git a/en/deploy/install_git.md b/en/deploy/install_git.md
index 211407c2775..0208d483d93 100644
--- a/en/deploy/install_git.md
+++ b/en/deploy/install_git.md
@@ -1,19 +1,19 @@
-Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
 
 ## Installing Git
 
 <!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
 data-collapse=true ces-->
 
-You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
 
-Do not forget to restart the command prompt or powershell after the installation finished successfully.
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully.
 <!--endsec-->
 
 <!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
 data-collapse=true ces-->
 
-Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
 
 > **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
 
@@ -24,7 +24,7 @@ data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
 ```bash
-$ sudo apt-get install git
+$ sudo apt install git
 ```
 
 <!--endsec-->
diff --git a/en/deploy/signup_pythonanywhere.md b/en/deploy/signup_pythonanywhere.md
index 1c45f14224b..f4eefc3bf7c 100644
--- a/en/deploy/signup_pythonanywhere.md
+++ b/en/deploy/signup_pythonanywhere.md
@@ -1,7 +1,21 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use
+it for hosting our site, live and on the Internet.
 
-Next it's time to sign up for a free "Beginner" account on PythonAnywhere. 
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
 
 * [www.pythonanywhere.com](https://www.pythonanywhere.com/)
 
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
 
-> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once.  When you've signed up for PythonAnywhere, you'll be taken to your dashboard.  Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
diff --git a/en/django/README.md b/en/django/README.md
index f57843e8c97..acb6a9f2358 100644
--- a/en/django/README.md
+++ b/en/django/README.md
@@ -22,6 +22,6 @@ Imagine a mail carrier with a letter. She is walking down the street and checks
 
 In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job."  The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
 
-Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
 
-So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
diff --git a/en/django_admin/README.md b/en/django_admin/README.md
index 5aa41f3a5e7..c6ae54059d9 100644
--- a/en/django_admin/README.md
+++ b/en/django_admin/README.md
@@ -2,7 +2,7 @@
 
 To add, edit and delete the posts we've just modeled, we will use Django admin.
 
-Let's open the `blog/admin.py` file and replace its contents with this:
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
 
 {% filename %}blog/admin.py{% endfilename %}
 ```python
@@ -22,13 +22,21 @@ To log in, you need to create a *superuser* - a user account that has control ov
 
 > Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the <b>Your first Django project!</b> chapter, in the <b>Starting the web server</b> section.
 
-When prompted, type your username (lowercase, no spaces), email address, and password. Don't worry that you can't see the password you're typing in – that's how it's supposed to be. Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
-
-{% filename %}command-line{% endfilename %}
+{% filename %}Mac OS X or Linux:{% endfilename %}
 ```
 (myvenv) ~/djangogirls$ python manage.py createsuperuser
-Username: admin
-Email address: admin@admin.com
+```
+
+{% filename %}Windows:{% endfilename %}
+```
+(myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+```
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+```
+Username: ola
+Email address: ola@example.com
 Password:
 Password (again):
 Superuser created successfully.
@@ -38,12 +46,12 @@ Return to your browser. Log in with the superuser's credentials you chose; you s
 
 ![Django admin](images/django_admin3.png)
 
-Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
 
 Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
 
 ![Django admin](images/edit_post3.png)
 
-If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
 
 This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
diff --git a/en/django_forms/README.md b/en/django_forms/README.md
index d6d6693cf6a..fee437dc6b1 100644
--- a/en/django_forms/README.md
+++ b/en/django_forms/README.md
@@ -15,7 +15,7 @@ blog
    └── forms.py
 ```
 
-OK, let's open it and type the following code:
+OK, let's open it in the code editor and type the following code:
 
 {% filename %}blog/forms.py{% endfilename %}
 ```python
@@ -30,7 +30,7 @@ class PostForm(forms.ModelForm):
         fields = ('title', 'text',)
 ```
 
-We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
 
 `PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
 
@@ -44,67 +44,79 @@ So once again we will create a link to the page, a URL, a view and a template.
 
 ## Link to a page with the form
 
-It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
 ```html
-<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
 ```
 
-Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
 
-After adding the line, your HTML file should now look like this:
+After editing the line, your HTML file should now look like this:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
 ```html
-{% load staticfiles %}
+{% load static %}
+<!DOCTYPE html>
 <html>
     <head>
         <title>Django Girls blog</title>
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
         <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
         <link rel="stylesheet" href="{% static 'css/blog.css' %}">
     </head>
     <body>
-        <div class="page-header">
-            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
-            <h1><a href="/">Django Girls Blog</a></h1>
-        </div>
-        <div class="content container">
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
             <div class="row">
-                <div class="col-md-8">
+                <div class="col">
                     {% block content %}
                     {% endblock %}
                 </div>
             </div>
-        </div>
+        </main>
     </body>
 </html>
 ```
 
-After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
 
 ## URL
 
-We open `blog/urls.py` and add a line:
+We open `blog/urls.py` in the code editor and add a line:
 
 {% filename %}blog/urls.py{% endfilename %}
 ```python
-url(r'^post/new/$', views.post_new, name='post_new'),
+path('post/new/', views.post_new, name='post_new'),
 ```
 
 And the final code will look like this:
 
 {% filename %}blog/urls.py{% endfilename %}
 ```python
-from django.conf.urls import url
+from django.urls import path
 from . import views
 
 urlpatterns = [
-    url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
-    url(r'^post/new/$', views.post_new, name='post_new'),
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
 ]
 ```
 
@@ -112,7 +124,7 @@ After refreshing the site, we see an `AttributeError`, since we don't have the `
 
 ## post_new view
 
-Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
 
 {% filename %}blog/views.py{% endfilename %}
 ```python
@@ -132,10 +144,10 @@ To create a new `Post` form, we need to call `PostForm()` and pass it to the tem
 
 ## Template
 
-We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
 
-- We have to display the form. We can do that with (for example) a simple {% raw %}`{{ form.as_p }}`{% endraw %}.
-- The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+- We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+- The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
 - We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
 - And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
 
@@ -148,7 +160,7 @@ OK, so let's see how the HTML in `post_edit.html` should look:
 {% extends 'blog/base.html' %}
 
 {% block content %}
-    <h1>New post</h1>
+    <h2>New post</h2>
     <form method="POST" class="post-form">{% csrf_token %}
         {{ form.as_p }}
         <button type="submit" class="save btn btn-default">Save</button>
@@ -168,7 +180,7 @@ The answer is: nothing. We need to do a little bit more work in our *view*.
 
 ## Saving the form
 
-Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
 
 {% filename %}blog/views.py{% endfilename %}
 ```python
@@ -196,7 +208,7 @@ It's time to fill in the dots `[...]`. If `method` is `POST` then we want to con
 form = PostForm(request.POST)
 ```
 
-Easy! The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
 
 We check if the form is valid and if so, we can save it!
 
@@ -269,13 +281,19 @@ Django is taking care to validate that all the fields in our form are correct. I
 
 ## Edit form
 
-Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
 
-Open `blog/templates/blog/post_detail.html` and add the line
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 ```html
-<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
 ```
 
 so that the template will look like this:
@@ -285,29 +303,33 @@ so that the template will look like this:
 {% extends 'blog/base.html' %}
 
 {% block content %}
-    <div class="post">
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
         {% if post.published_date %}
-            <div class="date">
+            <time class="date">
                 {{ post.published_date }}
-            </div>
+            </time>
         {% endif %}
-        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
-        <h1>{{ post.title }}</h1>
+        <h2>{{ post.title }}</h2>
         <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    </article>
 {% endblock %}
 ```
 
-In `blog/urls.py` we add this line:
+Open `blog/urls.py` in the code editor, and add this line:
 
 {% filename %}blog/urls.py{% endfilename %}
 ```python
-    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
 ```
 
 We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
 
-Let's open `blog/views.py` and add this at the very end of the file:
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
 
 {% filename %}blog/views.py{% endfilename %}
 ```python
@@ -326,7 +348,7 @@ def post_edit(request, pk):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
 
 {% filename %}blog/views.py{% endfilename %}
 ```python
@@ -352,25 +374,29 @@ Feel free to change the title or the text and save the changes!
 
 Congratulations! Your application is getting more and more complete!
 
-If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
 
 ## Security
 
-Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
 
-In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
 ```html
-<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
 ```
 
-We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
 ```html
 {% if user.is_authenticated %}
-    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
 {% endif %}
 ```
 
@@ -378,11 +404,13 @@ This `{% if %}` will cause the link to be sent to the browser only if the user r
 
 Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
 
-Open `blog/templates/blog/post_detail.html` and find this line:
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 ```html
-<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
 ```
 
 Change it to this:
@@ -390,7 +418,9 @@ Change it to this:
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 ```html
 {% if user.is_authenticated %}
-     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
 {% endif %}
 ```
 
@@ -400,12 +430,12 @@ Since you're likely logged in, if you refresh the page, you won't see anything d
 
 Let's see if all this works on PythonAnywhere. Time for another deploy!
 
-* First, commit your new code, and push it up to Github:
+* First, commit your new code, and push it up to GitHub:
 
 {% filename %}command-line{% endfilename %}
 ```
 $ git status
-$ git add --all .
+$ git add .
 $ git status
 $ git commit -m "Added views to create/edit blog post inside the site."
 $ git push
@@ -413,14 +443,17 @@ $ git push
 
 * Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
 
-{% filename %}command-line{% endfilename %}
+{% filename %}PythonAnywhere command-line{% endfilename %}
 ```
-$ cd my-first-blog
+$ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
 $ git pull
 [...]
 ```
 
-* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
 
 
-And that should be it! Congrats :)
+And that should be it. Congrats! :)
diff --git a/en/django_installation/README.md b/en/django_installation/README.md
index a7dd67281c8..e5e8b62d653 100644
--- a/en/django_installation/README.md
+++ b/en/django_installation/README.md
@@ -2,6 +2,6 @@
 
 > **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
 
-> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
 
 {% include "/django_installation/instructions.md" %}
diff --git a/en/django_installation/instructions.md b/en/django_installation/instructions.md
index 993b5da4165..0ec9a69cacb 100644
--- a/en/django_installation/instructions.md
+++ b/en/django_installation/instructions.md
@@ -12,9 +12,9 @@ Before we install Django we will get you to install an extremely useful tool to
 
 So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
 
-All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows it might look like `C:\Users\Name\` (where `Name` is the name of your login).
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name\` (where `Name` is the name of your login).
 
-> __NOTE:__ On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example `C:\djangogirls`.
+> __NOTE:__ On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
 
 For this tutorial we will be using a new directory `djangogirls` from your home directory:
 
@@ -48,7 +48,7 @@ Where `myvenv` is the name of your `virtualenv`. You can use any other name, but
 <!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
 data-collapse=true ces-->
 
-Creating a `virtualenv` on both Linux and OS X is as simple as running `python3 -m venv myvenv`.
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`.
 It will look like this:
 
 {% filename %}command-line{% endfilename %}
@@ -56,21 +56,21 @@ It will look like this:
 $ python3 -m venv myvenv
 ```
 
-`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also good idea to keep the name short as you'll be referencing it a lot!
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
 
 > __NOTE:__ On some versions of Debian/Ubuntu you may receive the following error:
 
 >{% filename %}command-line{% endfilename %}
 >```
 >The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
->    apt-get install python3-venv
+>    apt install python3-venv
 >You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
 >```
 >
 > In this case, follow the instructions above and install the `python3-venv` package:
 >{% filename %}command-line{% endfilename %}
 >```
->$ sudo apt-get install python3-venv
+>$ sudo apt install python3-venv
 >```
 
 > __NOTE:__ On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
@@ -84,8 +84,8 @@ $ python3 -m venv myvenv
 
 >{% filename %}command-line{% endfilename %}
 >```
->$ sudo apt-get install python-virtualenv
->$ virtualenv --python=python3.6 myvenv
+>$ sudo apt install python-virtualenv
+>$ virtualenv --python=python{{ book.py_version }} myvenv
 >```
 
 > __NOTE:__ If you get an error like
@@ -99,7 +99,7 @@ $ python3 -m venv myvenv
 >
 >{% filename %}command-line{% endfilename %}
 >```
->sudo apt install python3.6-venv
+>sudo apt install python{{ book.py_version }}-venv
 >```
 
 <!--endsec-->
@@ -127,6 +127,15 @@ C:\Users\Name\djangogirls> myvenv\Scripts\activate
 >     The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
 >```
 
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> __NOTE:__ For users of the popular editor VS Code, which come with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+>
+>```
+>$ . myvenv\Scripts\activate.ps1
+>```
+>The advantage is that you don't have to switch between editor windows and command-line windows
+
 <!--endsec-->
 
 <!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
@@ -156,7 +165,7 @@ When working within a virtual environment, `python` will automatically refer to
 
 OK, we have all important dependencies in place. We can finally install Django!
 
-## Installing Django
+## Installing Django {#django}
 
 Now that you have your `virtualenv` started, you can install Django.
 
@@ -164,18 +173,39 @@ Before we do that, we should make sure we have the latest version of `pip`, the
 
 {% filename %}command-line{% endfilename %}
 ```
-(myvenv) ~$ pip install --upgrade pip
+(myvenv) ~$ python -m pip install --upgrade pip
+```
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using
+`pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+```
+djangogirls
+├── myvenv
+│   └── ...
+└───requirements.txt
+```
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+```
+Django~={{ book.django_version }}
 ```
 
-Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+Now, run `pip install -r requirements.txt` to install Django.
 
 {% filename %}command-line{% endfilename %}
 ```
-(myvenv) ~$ pip install django~=1.11.0
-Collecting django~=1.11.0
-  Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
-Installing collected packages: django
-Successfully installed django-1.11.3
+(myvenv) ~$ pip install -r requirements.txt
+Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+  Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+Installing collected packages: Django
+Successfully installed Django-{{ book.django_version }}
 ```
 
 <!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
@@ -192,7 +222,7 @@ data-collapse=true ces-->
 >
 >{% filename %}command-line{% endfilename %}
 >```
->C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
 >```
 
 <!--endsec-->
diff --git a/en/django_models/README.md b/en/django_models/README.md
index 13069ed5e15..cab8f68e264 100644
--- a/en/django_models/README.md
+++ b/en/django_models/README.md
@@ -66,19 +66,24 @@ You can think of a model in the database as a spreadsheet with columns (fields)
 
 To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
 
-{% filename %}command-line{% endfilename %}
+{% filename %}Mac OS X and Linux:{% endfilename %}
 ```
 (myvenv) ~/djangogirls$ python manage.py startapp blog
 ```
 
+{% filename %}Windows:{% endfilename %}
+```
+(myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+```
+
 You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
 
 ```
 djangogirls
 ├── blog
-│   ├── __init__.py
 │   ├── admin.py
 │   ├── apps.py
+│   ├── __init__.py
 │   ├── migrations
 │   │   └── __init__.py
 │   ├── models.py
@@ -86,14 +91,18 @@ djangogirls
 │   └── views.py
 ├── db.sqlite3
 ├── manage.py
-└── mysite
-    ├── __init__.py
-    ├── settings.py
-    ├── urls.py
-    └── wsgi.py
+├── mysite
+│   ├── __init__.py
+│   ├── settings.py
+│   ├── urls.py
+│   └── wsgi.py
+├── myvenv
+│   └── ...
+└── requirements.txt
+
 ```
 
-After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
 
 {% filename %}mysite/settings.py{% endfilename %}
 ```python
@@ -104,7 +113,7 @@ INSTALLED_APPS = [
     'django.contrib.sessions',
     'django.contrib.messages',
     'django.contrib.staticfiles',
-    'blog',
+    'blog.apps.BlogConfig',
 ]
 ```
 
@@ -112,22 +121,21 @@ INSTALLED_APPS = [
 
 In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
 
-Let's open `blog/models.py`, remove everything from it, and write code like this:
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
 
 {% filename %}blog/models.py{% endfilename %}
 ```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')
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
-    created_date = models.DateTimeField(
-            default=timezone.now)
-    published_date = models.DateTimeField(
-            blank=True, null=True)
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
 
     def publish(self):
         self.published_date = timezone.now()
@@ -155,7 +163,7 @@ Now we define the properties we were talking about: `title`, `text`, `created_da
 - `models.DateTimeField` – this is a date and time.
 - `models.ForeignKey` – this is a link to another model.
 
-We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
 
 What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example,  a method that calculates average price could be called `calculate_average_price`.
 
@@ -187,7 +195,6 @@ Django prepared a migration file for us that we now have to apply to our databas
 Operations to perform:
   Apply all migrations: blog
 Running migrations:
-  Rendering model states... DONE
   Applying blog.0001_initial... OK
 ```
 
diff --git a/en/django_orm/README.md b/en/django_orm/README.md
index ff8118e2506..54ec2a1d2ae 100644
--- a/en/django_orm/README.md
+++ b/en/django_orm/README.md
@@ -27,7 +27,7 @@ The effect should be like this:
 >>>
 ```
 
-You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :)  You can use all the Python commands here too, of course.
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :)  You can use all the Python commands here too.
 
 
 ### All objects
@@ -49,7 +49,7 @@ Oops! An error showed up. It tells us that there is no Post. It's correct – we
 >>> from blog.models import Post
 ```
 
-This is simple: we import the model `Post` from `blog.models`. Let's try displaying all posts again:
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
 
 {% filename %}command-line{% endfilename %}
 ```python
@@ -86,20 +86,21 @@ What users do we have in our database? Try this:
 <QuerySet [<User: ola>]>
 ```
 
-This is the superuser we created earlier! Let's get an instance of the user now:
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
 
 {% filename %}command-line{% endfilename %}
 ```python
 >>> me = User.objects.get(username='ola')
 ```
 
-As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
 
 Now we can finally create our post:
 
 {% filename %}command-line{% endfilename %}
 ```python
 >>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
 ```
 
 Hurray! Wanna check if it worked?
@@ -125,7 +126,7 @@ A big part of QuerySets is the ability to filter them. Let's say we want to find
 {% filename %}command-line{% endfilename %}
 ```python
 >>> Post.objects.filter(author=me)
-[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
 ```
 
 Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
@@ -133,7 +134,7 @@ Or maybe we want to see all the posts that contain the word 'title' in the `titl
 {% filename %}command-line{% endfilename %}
 ```python
 >>> Post.objects.filter(title__contains='title')
-[<Post: Sample title>, <Post: 4th title of post>]
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
 ```
 
 > **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
@@ -144,7 +145,7 @@ You can also get a list of all published posts. We do this by filtering all the
 ```python
 >>> from django.utils import timezone
 >>> Post.objects.filter(published_date__lte=timezone.now())
-[]
+<QuerySet []>
 ```
 
 Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
@@ -166,7 +167,7 @@ Now try to get list of published posts again (press the up arrow key three times
 {% filename %}command-line{% endfilename %}
 ```python
 >>> Post.objects.filter(published_date__lte=timezone.now())
-[<Post: Sample title>]
+<QuerySet [<Post: Sample title>]>
 ```
 
 
@@ -177,7 +178,7 @@ QuerySets also allow you to order the list of objects. Let's try to order them b
 {% filename %}command-line{% endfilename %}
 ```python
 >>> Post.objects.order_by('created_date')
-[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
 ```
 
 We can also reverse the ordering by adding `-` at the beginning:
@@ -185,16 +186,21 @@ We can also reverse the ordering by adding `-` at the beginning:
 {% filename %}command-line{% endfilename %}
 ```python
 >>> Post.objects.order_by('-created_date')
-[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
 ```
 
 
-### Chaining QuerySets 
+### Complex queries through method-chaining
 
-You can also combine QuerySets by **chaining** them together:
+As you saw, some methods on `Post.objects` return a QuerySet.
+The same methods can in turn also be called on a QuerySet,
+and will then return a new QuerySet.
+Thus,
+you can combine their effect by **chaining** them together:
 
-```
+```python
 >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
 ```
 
 This is really powerful and lets you write quite complex queries.
diff --git a/en/django_start_project/README.md b/en/django_start_project/README.md
index 87106f097a9..8e4a3a7fcfc 100644
--- a/en/django_start_project/README.md
+++ b/en/django_start_project/README.md
@@ -7,7 +7,7 @@ tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commo
 Attribution-ShareAlike 4.0 International License. The django-marcador tutorial
 is copyrighted by Markus Zapke-Gründemann et al.
 
-We're going to create a simple blog!
+We're going to create a small blog!
 
 The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
 
@@ -42,8 +42,8 @@ On Windows you should run the following command. **(Don't forget to add the peri
 ```
 > The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
 
-> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.py`.
-The (myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`.
+The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
 
 <!--endsec-->
 
@@ -51,12 +51,15 @@ The (myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the
 
 ```
 djangogirls
-├───manage.py
-└───mysite
-        settings.py
-        urls.py
-        wsgi.py
-        __init__.py
+├── manage.py
+├── mysite
+│   ├── __init__.py
+│   ├── settings.py
+│   ├── urls.py
+│   └── wsgi.py
+├── myvenv
+│   └── ...
+└── requirements.txt
 ```
 > **Note**: in your directory structure, you will also see your `venv` directory that we created before.
 
@@ -84,9 +87,9 @@ In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choos
 TIME_ZONE = 'Europe/Berlin'
 ```
 
-A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
 
-Change the language code by changing the following line:
+If you want a different language, change the language code by changing the following line:
 
 {% filename %}mysite/settings.py{% endfilename %}
 ```python
@@ -107,13 +110,49 @@ match our hostname on PythonAnywhere once we deploy our application so we will c
 
 {% filename %}mysite/settings.py{% endfilename %}
 ```python
-ALLOWED_HOSTS = ['127.0.0.1', '<your_username>.pythonanywhere.com']
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
 ```
 
 > **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file:
 > `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
 
-> Also add `django-girls-<your_username>.c9users.io` to the ALLOWED_HOSTS if you are using cloud9
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to 
+> remain confidential (otherwise, anyone remixing your project could see it):
+>
+>   * First, we are going to create a random secret key.
+>     Open the Glitch terminal again, and type the following command:
+>
+>     {% filename %}command-line{% endfilename %}
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site.
+>     We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.    
+>   
+>   * Create a file `.env` at the root of your project and add the following property in it:
+>
+>     {% filename %}.env{% endfilename %}
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+>   * Then update the Django settings file to inject this secret value and set the Django web site name:
+>
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+>   * And a little further down in the same file, we inject the name of your new Glitch website:
+>
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch.
+>     It will correspond to the name of your project.
 
 ## Set up a database
 
@@ -151,6 +190,8 @@ Running migrations:
   Applying auth.0005_alter_user_last_login_null... OK
   Applying auth.0006_require_contenttypes_0002... OK
   Applying auth.0007_alter_validators_add_error_messages... OK
+  Applying auth.0008_alter_user_username_max_length... OK
+  Applying auth.0009_alter_user_last_name_max_length... OK
   Applying sessions.0001_initial... OK
 ```
 
@@ -170,6 +211,13 @@ If you are on a Chromebook, use this command instead:
 {% filename %}Cloud 9{% endfilename %}
 ```
 (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+```
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+```
+$ refresh
+
 ```
 
 If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
@@ -180,28 +228,32 @@ If you are on Windows and this fails with `UnicodeDecodeError`, use this command
 ```
 
 
-Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
 
 {% filename %}browser{% endfilename %}
 ```
 http://127.0.0.1:8000/
 ```
 
-If you're using a Chromebook, you'll always visit your test server by accessing:
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
 
 {% filename %}browser{% endfilename %}
 ```
-https://django-girls-<your cloud9 username>.c9users.io
+https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+```
+or on Glitch:
+```
+https://name-of-your-glitch-project.glitch.me
 ```
 
 Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
 
-![It worked!](images/it_worked2.png)
+![Install worked!](images/install_worked.png)
 
-While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
 
 > We reviewed how web servers work in the <b>How the Internet works</b> chapter.
 
-To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
 
 Ready for the next step? It's time to create some content!
diff --git a/en/django_templates/README.md b/en/django_templates/README.md
index f65a0836d81..fda0459b795 100644
--- a/en/django_templates/README.md
+++ b/en/django_templates/README.md
@@ -6,7 +6,7 @@ Time to display some data! Django gives us some helpful built-in __template tags
 
 You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
 
-__Django template tags__ allow us to transfer Python-like things into HTML, so you can build dynamic websites faster and easier. Cool!
+__Django template tags__ allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
 ## Display post list template
 
@@ -19,7 +19,7 @@ To print a variable in Django templates, we use double curly brackets with the v
 {{ posts }}
 ```
 
-Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
 
 ![Figure 13.1](images/step1.png)
 
@@ -47,16 +47,16 @@ It works! But we want the posts to be displayed like the static posts we created
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
-<div>
+<header>
     <h1><a href="/">Django Girls Blog</a></h1>
-</div>
+</header>
 
 {% for post in posts %}
-    <div>
-        <p>published: {{ post.published_date }}</p>
-        <h1><a href="">{{ post.title }}</a></h1>
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
         <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    </article>
 {% endfor %}
 ```
 
@@ -64,20 +64,20 @@ It works! But we want the posts to be displayed like the static posts we created
 
 ![Figure 13.3](images/step3.png)
 
-Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
 
 
 ## One more thing
 
 It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
 
-* First, push your code to Github
+* First, push your code to GitHub
 
 {% filename %}command-line{% endfilename %}
 ```
 $ git status
 [...]
-$ git add --all .
+$ git add .
 $ git status
 [...]
 $ git commit -m "Modified templates to display posts from database."
@@ -89,15 +89,17 @@ $ git push
 
 {% filename %}PythonAnywhere command-line{% endfilename %}
 ```
-$ cd my-first-blog
+$ cd <your-pythonanywhere-domain>.pythonanywhere.com
 $ git pull
 [...]
 ```
 
-* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
 
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
 
-Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
 
 Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
 
diff --git a/en/django_urls/README.md b/en/django_urls/README.md
index 2ae25239758..25c680513fe 100644
--- a/en/django_urls/README.md
+++ b/en/django_urls/README.md
@@ -4,11 +4,11 @@ We're about to build our first webpage: a homepage for your blog! But first, let
 
 ## What is a URL?
 
-A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
 
-![Url](images/url.png)
+![URL](images/url.png)
 
-Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
 
 ## How do URLs work in Django?
 
@@ -21,11 +21,11 @@ Let's open up the `mysite/urls.py` file in your code editor of choice and see wh
 
 [...]
 """
-from django.conf.urls import url
 from django.contrib import admin
+from django.urls import path
 
 urlpatterns = [
-    url(r'^admin/', admin.site.urls),
+    path('admin/', admin.site.urls),
 ]
 ```
 
@@ -33,37 +33,14 @@ As you can see, Django has already put something here for us.
 
 Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
 
-The admin URL, which you visited in previous chapter, is already here:
+The admin URL, which you visited in the previous chapter, is already here:
 
 {% filename %}mysite/urls.py{% endfilename %}
 ```python
-    url(r'^admin/', admin.site.urls),
+    path('admin/', admin.site.urls),
 ```
 
-This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
-
-## Regex
-
-Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
-
-If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
-
-* `^` for the beginning of the text
-* `$` for the end of the text
-* `\d` for a digit
-* `+` to indicate that the previous item should be repeated at least once
-* `()` to capture part of the pattern
-
-Anything else in the URL definition will be taken literally.
-
-Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
-
-Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
-
-* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
-* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
-* **/** tells django that another `/` character should follow
-* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
 
 
 ## Your first Django URL!
@@ -72,48 +49,45 @@ Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home pa
 
 We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
 
-Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so **you will need** to add that to the import on the first line of the file.
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
 
 Your `mysite/urls.py` file should now look like this:
 
 {% filename %}mysite/urls.py{% endfilename %}
 ```python
-from django.conf.urls import include, url
 from django.contrib import admin
+from django.urls import path, include
 
 urlpatterns = [
-    url(r'^admin/', admin.site.urls),
-    url(r'', include('blog.urls')),
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
 ]
 ```
 
-Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
-
-Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
-
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
 
 ## blog.urls
 
-Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
 
 {% filename %}blog/urls.py{% endfilename %}
 ```python
-from django.conf.urls import url
+from django.urls import path
 from . import views
 ```
 
-Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
 
 After that, we can add our first URL pattern:
 
 {% filename %}blog/urls.py{% endfilename %}
 ```python
 urlpatterns = [
-    url(r'^$', views.post_list, name='post_list'),
+    path('', views.post_list, name='post_list'),
 ]
 ```
 
-As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
 
 The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
 
@@ -121,6 +95,8 @@ If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'w
 
 ![Error](images/error1.png)
 
-Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is __no attribute 'post_list'__. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is __no attribute 'post_list'__. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there.
+If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
 
-> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
diff --git a/en/django_views/README.md b/en/django_views/README.md
index 909aa5230a4..e46bb4b380c 100644
--- a/en/django_views/README.md
+++ b/en/django_views/README.md
@@ -8,7 +8,7 @@ Views are placed in the `views.py` file. We will add our *views* to the `blog/vi
 
 ## blog/views.py
 
-OK, let's open up this file and see what's in there:
+OK, let's open up this file in our code editor and see what's in there:
 
 {% filename %}blog/views.py{% endfilename %}
 ```python
@@ -21,7 +21,7 @@ Not too much stuff here yet.
 
 Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
 
-The simplest *view* can look like this:
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
 
 {% filename %}blog/views.py{% endfilename %}
 ```python
@@ -29,7 +29,7 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
 
 Save the file, go to http://127.0.0.1:8000/ and see what we've got.
 
@@ -39,4 +39,4 @@ Another error! Read what's going on now:
 
 This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
 
-> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
diff --git a/en/dynamic_data_in_templates/README.md b/en/dynamic_data_in_templates/README.md
index 3f9a14c0bfb..d297f4ed3db 100644
--- a/en/dynamic_data_in_templates/README.md
+++ b/en/dynamic_data_in_templates/README.md
@@ -6,7 +6,7 @@ This is exactly what *views* are supposed to do: connect models and templates. I
 
 OK, so how will we achieve this?
 
-We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
 
 {% filename %}blog/views.py{% endfilename %}
 ```python
@@ -39,7 +39,7 @@ So now we want published blog posts sorted by `published_date`, right? We alread
 Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
 ```
 
-Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
 
 {% filename %}blog/views.py{% endfilename %}
 ```python
@@ -52,7 +52,9 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+To display our QuerySet on our blog's post list, we have two things left to do:
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
 
 Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
 
@@ -73,4 +75,4 @@ def post_list(request):
 
 That's it! Time to go back to our template and display this QuerySet!
 
-Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
diff --git a/en/extend_your_application/README.md b/en/extend_your_application/README.md
index fa54a1d3b70..ffb250bfda5 100644
--- a/en/extend_your_application/README.md
+++ b/en/extend_your_application/README.md
@@ -1,6 +1,8 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
 # Extend your application
 
-We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
 
 Time to practice!
 
@@ -10,36 +12,36 @@ We already have a `Post` model, so we don't need to add anything to `models.py`.
 
 ## Create a template link to a post's detail
 
-We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this:
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this:
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
 {% extends 'blog/base.html' %}
 
 {% block content %}
     {% for post in posts %}
-        <div class="post">
-            <div class="date">
+        <article class="post">
+            <time class="date">
                 {{ post.published_date }}
-            </div>
-            <h1><a href="">{{ post.title }}</a></h1>
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
             <p>{{ post.text|linebreaksbr }}</p>
-        </div>
+        </article>
     {% endfor %}
 {% endblock %}
 ```
 
-{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
 
-{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
 ```html
-<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
 ```
 
 {% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
 
 The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
 
-And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields  (`title`, `author`, etc.) in our `Post` object!
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields  (`title`, `author`, etc.) in our `Post` object!
 
 Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
 
@@ -51,25 +53,23 @@ Let's create a URL in `urls.py` for our `post_detail` *view*!
 
 We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
 
-Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
 
-{% filename %}blog/urls.py{% endfilename %}
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
 ```python
-from django.conf.urls import url
+from django.urls import path
 from . import views
 
 urlpatterns = [
-    url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
 ]
 ```
 
-This part ``^post/(?P<pk>\d+)/$`` looks scary, but no worries – we will explain it for you:
-- it starts with `^` again – "the beginning".
-- `post/` just means that after the beginning, the URL should contain the word __post__ and a __/__. So far so good.
-- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
-- `/` – then we need a __/__ again.
-- `$` – "the end"!
+This part ``post/<int:pk>/`` specifies a URL pattern – we will explain it for you:
+- `post/` means that the URL should begin with the word __post__ followed by a __/__. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a __/__ again before finishing the URL.
 
 That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
 
@@ -77,15 +77,16 @@ OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: htt
 
 ![AttributeError](images/attribute_error2.png)
 
-Do you remember what the next step is? Of course: adding a view!
+Do you remember what the next step is? It's adding a view!
 
 ## Add a post's detail view
 
-This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
 
 Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
 
-{% filename %}blog/views.py{% endfilename %}
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
 ```python
 Post.objects.get(pk=pk)
 ```
@@ -94,7 +95,7 @@ But this code has a problem. If there is no `Post` with the given `primary key`
 
 ![DoesNotExist error](images/does_not_exist2.png)
 
-We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
 
 ![Page not found](images/404_2.png)
 
@@ -104,7 +105,7 @@ OK, time to add a *view* to our `views.py` file!
 
 In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called  `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
 
-We should open `blog/views.py` and add the following code near the other `from` lines:
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
 
 {% filename %}blog/views.py{% endfilename %}
 ```python
@@ -132,30 +133,30 @@ Oh no! Another error! But we already know how to deal with it, right? We need to
 
 ## Create a template for the post details
 
-We will create a file in `blog/templates/blog` called `post_detail.html`.
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
 
-It will look like this:
+Enter the following code:
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 ```html
 {% extends 'blog/base.html' %}
 
 {% block content %}
-    <div class="post">
+    <article class="post">
         {% if post.published_date %}
-            <div class="date">
+            <time class="date">
                 {{ post.published_date }}
-            </div>
+            </time>
         {% endif %}
-        <h1>{{ post.title }}</h1>
+        <h2>{{ post.title }}</h2>
         <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    </article>
 {% endblock %}
 ```
 
 Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
 
-{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from __Introduction to Python__ chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from __Introduction to Python__ chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
 
 OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
 
@@ -163,14 +164,15 @@ OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
 
 Yay! It works!
 
-## One more thing: deploy time!
 
-It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
 
 {% filename %}command-line{% endfilename %}
 ```
 $ git status
-$ git add --all .
+$ git add .
 $ git status
 $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
 $ git push
@@ -178,13 +180,31 @@ $ git push
 
 Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
 
-{% filename %}command-line{% endfilename %}
+{% filename %}PythonAnywhere command-line{% endfilename %}
 ```
-$ cd my-first-blog
+$ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
 $ git pull
 [...]
 ```
 
-Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster.  As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them.  The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+```
+$ workon <your-pythonanywhere-domain>.pythonanywhere.com
+(ola.pythonanywhere.com)$ python manage.py collectstatic
+[...]
+```
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`.  We make some changes to our code, and then we tell Django to _apply_ those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
 
-And that should be it! Congrats :)
+And that should be it. Congrats! :)
diff --git a/en/how_the_internet_works/README.md b/en/how_the_internet_works/README.md
index cfcc8482452..035d6a2ddfb 100644
--- a/en/how_the_internet_works/README.md
+++ b/en/how_the_internet_works/README.md
@@ -6,10 +6,10 @@
 
 We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
 
-The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures.
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures.
 However, there is one part that is unique for websites: they include computer code called HTML.
 
-If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code,
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code,
 follow its instructions, and present these files that your website is made of, exactly the way you want.
 
 As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have
@@ -25,7 +25,7 @@ Looks like a mess, right? In fact it is a network of connected machines (the abo
 
 ![Figure 1.2](images/internet_3.png)
 
-It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
 
 It looks like this:
 
@@ -37,7 +37,7 @@ Your letter goes to the post office closest to you. Then it goes to another that
 
 ![Figure 1.4](images/internet_4.png)
 
-Yes, it is as simple as that. You send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
 
 Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
 
diff --git a/en/html/README.md b/en/html/README.md
index c4deb1206e0..075f29732a9 100644
--- a/en/html/README.md
+++ b/en/html/README.md
@@ -2,13 +2,13 @@
 
 What's a template, you may ask?
 
-A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
 
 A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, __How the Internet works__).
 
 ## What is HTML?
 
-HTML is a simple code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
 HTML stands for "HyperText Markup Language". __HyperText__ means it's a type of text that supports hyperlinks between pages. __Markup__ means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with __tags__, each one starting with `<` and ending with `>`. These tags represent markup __elements__.
 
@@ -24,25 +24,28 @@ blog
     └───blog
 ```
 
-(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
 
 And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
 
 See how your website looks now: http://127.0.0.1:8000/
 
-> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
 
 ![Figure 11.1](images/step1.png)
 
-No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
 
-Add the following to your template file:
+Open the new file in the code editor, and add the following:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
+<!DOCTYPE html>
 <html>
+<body>
     <p>Hi there!</p>
     <p>It works!</p>
+</body>
 </html>
 ```
 
@@ -50,9 +53,10 @@ So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
 
 ![Figure 11.2](images/step3.png)
 
-It worked! Nice work there :)
+It worked. Nice work there! :)
 
-- The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+- The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+- The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
 - `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
 
 ## Head and body
@@ -69,6 +73,7 @@ For example, you can put a web page title element inside the `<head>`, like this
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
+<!DOCTYPE html>
 <html>
     <head>
         <title>Ola's blog</title>
@@ -102,43 +107,52 @@ You can now have a little fun and try to customize your template! Here are a few
 - `<p>A paragraph of text</p>`
 - `<em>text</em>` emphasizes your text
 - `<strong>text</strong>` strongly emphasizes your text
-- `<br />` goes to another line (you can't put anything inside br)
+- `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
 - `<a href="https://djangogirls.org">link</a>` creates a link
 - `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
 - `<div></div>` defines a section of the page
+- `<nav></nav>` defines a set of navigation links
+- `<article></article>` specifies independent, self-contained content
+- `<section></section>` defines a section in a document
+- `<header></header>` specifies a header for a document or section
+- `<main></main>` specifies the main content of a document
+- `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+- `<footer></footer>` defines a footer for a document or section
+- `<time></time>` defines a specific time (or datetime)
 
 Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
+<!DOCTYPE html>
 <html>
     <head>
         <title>Django Girls blog</title>
     </head>
     <body>
-        <div>
+        <header>
             <h1><a href="/">Django Girls Blog</a></h1>
-        </div>
+        </header>
 
-        <div>
-            <p>published: 14.06.2014, 12:14</p>
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
             <h2><a href="">My first post</a></h2>
             <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
-        </div>
+        </article>
 
-        <div>
-            <p>published: 14.06.2014, 12:14</p>
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
             <h2><a href="">My second post</a></h2>
             <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
-        </div>
+        </article>
     </body>
 </html>
 ```
 
-We've created three `div` sections here.
+We've created one `header` section and two `article` section here.
 
-- The first `div` element contains the title of our blog – it's a heading and a link
-- Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+- The `header` element contains the title of our blog – it's a heading and a link
+- The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
 
 It gives us this effect:
 
@@ -152,7 +166,7 @@ What we really want to do is display real posts added in our Django admin – an
 
 It'd be good to see all this out and live on the Internet, right?  Let's do another PythonAnywhere deploy:
 
-### Commit, and push your code up to Github
+### Commit, and push your code up to GitHub
 
 First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
 
@@ -161,15 +175,13 @@ First off, let's see what files have changed since we last deployed (run these c
 $ git status
 ```
 
-Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
 
 {% filename %}command-line{% endfilename %}
 ```
-$ git add --all .
+$ git add .
 ```
 
-> __Note__ `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
-
 Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
 
 {% filename %}command-line{% endfilename %}
@@ -197,16 +209,18 @@ $ git push
 
 * Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
 
-{% filename %}command-line{% endfilename %}
+{% filename %}PythonAnywhere command-line{% endfilename %}
 ```
-$ cd ~/my-first-blog
+$ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
 $ git pull
 [...]
 ```
 
-And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
 
 
-* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
 
 Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
diff --git a/en/installation/README.md b/en/installation/README.md
index cefbd6d645f..9c9c995267a 100644
--- a/en/installation/README.md
+++ b/en/installation/README.md
@@ -2,36 +2,45 @@
 
 If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
 
-This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
-
-If you find it useful, you can follow through this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
 
 Good luck!
 
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+- Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+- The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+- If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
 # Installation
-In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
 
 <!--sec data-title="Chromebook setup (if you're using one)"
 data-id="chromebook_setup" data-collapse=true ces-->
 {% include "/chromebook_setup/instructions.md" %}
 <!--endsec-->
 
-# Install Python
-{% include "/python_installation/instructions.md" %}
+# Brief intro to the command line {#command-line}
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like:
+{% include "/intro_to_command_line/open_instructions.md" %}
 
-# Set up virtualenv and install Django
-{% include "/django_installation/instructions.md" %}
+# Install Python {#python}
+{% include "/python_installation/instructions.md" %}
 
-# Install a code editor
+# Install a code editor {#code-editor}
 {% include "/code_editor/instructions.md" %}
 
-# Install Git
+# Set up virtualenv and install Django {#virtualenv}
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
 {% include "/deploy/install_git.md" %}
 
-# Create a GitHub account
-Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+# Create a GitHub account {#github}
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
 
-# Create a PythonAnywhere account
+# Create a PythonAnywhere account {#pythonanywhere}
 {% include "/deploy/signup_pythonanywhere.md" %}
 
 
diff --git a/en/intro_to_command_line/README.md b/en/intro_to_command_line/README.md
index 5d7b2bbfd4c..b7c67bb6f03 100644
--- a/en/intro_to_command_line/README.md
+++ b/en/intro_to_command_line/README.md
@@ -18,27 +18,7 @@ The window, which is usually called the __command line__ or __command-line inter
 
 To start some experiments we need to open our command-line interface first.
 
-
-<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
-
-Go to Start menu → Windows System → Command Prompt.
-
-> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
-
-<!--endsec-->
-
-
-<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
-
-Go to Applications → Utilities → Terminal.
-
-<!--endsec-->
-
-<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
-
-It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
-
-<!--endsec-->
+{% include "/intro_to_command_line/open_instructions.md" %}
 
 ## Prompt
 
@@ -47,7 +27,7 @@ You now should see a white or black window that is waiting for your commands.
 <!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
 
 
-If you're on Mac or Linux, you probably see `$`, just like this:
+If you're on Mac or Linux, you probably see a `$`, like this:
 
 {% filename %}command-line{% endfilename %}
 ```
@@ -58,25 +38,28 @@ $
 <!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
 
 
-On Windows, it's a `>` sign, like this:
+On Windows, you probably see a `>`, like this:
 
 {% filename %}command-line{% endfilename %}
 ```
 >
 ```
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
 <!--endsec-->
 
-Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
 
 > Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
 
 The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
 
-In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
 
 ## Your first command (YAY!)
 
-Let's start with something simple. Type this command:
+Let's start by typing this command:
 
 <!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
 
@@ -138,7 +121,7 @@ $ pwd
 > cd
 C:\Users\olasitarska
 ```
-> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
 
 <!--endsec-->
 
@@ -146,6 +129,24 @@ You'll probably see something similar on your machine. Once you open the command
 
 ---
 
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+
 ### List files and directories
 
 So what's in it? It'd be cool to find out. Let's see:
@@ -170,13 +171,13 @@ Music
 ```
 > dir
  Directory of C:\Users\olasitarska
-05/08/2014 07:28 PM <DIR>      Applications
-05/08/2014 07:28 PM <DIR>      Desktop
-05/08/2014 07:28 PM <DIR>      Downloads
-05/08/2014 07:28 PM <DIR>      Music
+05/08/2020 07:28 PM <DIR>      Applications
+05/08/2020 07:28 PM <DIR>      Desktop
+05/08/2020 07:28 PM <DIR>      Downloads
+05/08/2020 07:28 PM <DIR>      Music
 ...
 ```
-> Note: In powershell you can also use 'ls' like on Linux and Mac OS X.
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X.
 <!--endsec-->
 
 ---
@@ -185,7 +186,7 @@ Music
 
 Now, let's go to our Desktop directory:
 
-<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
 ```
@@ -193,6 +194,22 @@ $ cd Desktop
 ```
 <!--endsec-->
 
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+```
+$ cd Desktop
+```
+
+Note that
+the directory name "Desktop" might be translated
+to the language of your Linux account.
+If that's the case, you'll need to replace `Desktop`
+with the translated name;
+for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
 <!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
 
 
@@ -249,7 +266,7 @@ $ mkdir practice
 ```
 <!--endsec-->
 
-This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
 
 > PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
 
@@ -280,7 +297,7 @@ test
 > cd practice
 > mkdir test
 > dir
-05/08/2014 07:28 PM <DIR>      test
+05/08/2020 07:28 PM <DIR>      test
 ```
 <!--endsec-->
 
@@ -413,6 +430,7 @@ move              | mv                       | move file                  | **mo
 mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**
 rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**
 rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**
+[CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux)
 
 These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
 
diff --git a/en/intro_to_command_line/open_instructions.md b/en/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..4b5c86ee008
--- /dev/null
+++ b/en/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
diff --git a/en/python_installation/README.md b/en/python_installation/README.md
index 2b674d8d2c9..c2d343ec52b 100644
--- a/en/python_installation/README.md
+++ b/en/python_installation/README.md
@@ -4,13 +4,13 @@ We're finally here!
 
 But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
 
-Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks much simpler than other programming languages. This makes it easy to learn, but don't worry – Python is also really powerful!
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
 
 # Python installation
 
 > **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
 
-> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
 
 {% include "/python_installation/instructions.md" %}
 
diff --git a/en/python_installation/instructions.md b/en/python_installation/instructions.md
index 91e1666ade0..4365eea826d 100644
--- a/en/python_installation/instructions.md
+++ b/en/python_installation/instructions.md
@@ -2,28 +2,29 @@
 
 > This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
 
-Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
 
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
 
 <!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
 
-First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
 
-One thing to watch out for: During the installation you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
 
-![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
-
-In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
 
-![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
 
-Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
-1. install all Windows Updates and try to install Python 3.6 again; or
-2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
 
-If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
 
-![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
 
 <!--endsec-->
 
@@ -32,10 +33,10 @@ data-collapse=true ces-->
 
 > **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
 
-You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
 
 * Download the *Mac OS X 64-bit/32-bit installer* file,
-* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
 
 <!--endsec-->
 
@@ -47,11 +48,17 @@ It is very likely that you already have Python installed out of the box. To chec
 {% filename %}command-line{% endfilename %}
 ```
 $ python3 --version
-Python 3.6.1
+Python {{ book.py_release }}
 ```
 
-If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+```
+$ grep '^NAME=' /etc/os-release
+```
 
+Afterwards, depending on the result, follow one of the following installation guides below this section.
 
 <!--endsec-->
 
@@ -61,7 +68,7 @@ Type this command into your console:
 
 {% filename %}command-line{% endfilename %}
 ```
-$ sudo apt-get install python3.6
+$ sudo apt install python3
 ```
 
 <!--endsec-->
@@ -76,7 +83,7 @@ Use this command in your console:
 $ sudo dnf install python3
 ```
 
-If you're on older Fedora versions you might get an error that the command dnf is not found. In that case you need to use yum instead.
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
 
 <!--endsec-->
 
@@ -97,10 +104,11 @@ Verify the installation was successful by opening a command prompt and running t
 {% filename %}command-line{% endfilename %}
 ```
 $ python3 --version
-Python 3.6.1
+Python {{ book.py_release }}
 ```
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
 
-**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
 
 ----
 
diff --git a/en/python_introduction/README.md b/en/python_introduction/README.md
index efeed11dc59..b10aec32908 100644
--- a/en/python_introduction/README.md
+++ b/en/python_introduction/README.md
@@ -1,3 +1,5 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
 # Introduction to Python
 
 > Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
@@ -17,7 +19,7 @@ We want to open up a Python console, so type in `python` on Windows or `python3`
 {% filename %}command-line{% endfilename %}
 ```
 $ python3
-Python 3.6.1 (...)
+Python {{ book.py_release }} (...)
 Type "help", "copyright", "credits" or "license" for more information.
 >>>
 ```
@@ -26,9 +28,9 @@ Type "help", "copyright", "credits" or "license" for more information.
 
 After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
 
-If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
 
-For now, we don't want to exit the Python console. We want to learn more about it. Let's start with something really simple. For example, try typing some math, like `2 + 3` and hit `enter`.
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
 
 {% filename %}command-line{% endfilename %}
 ```python
@@ -99,7 +101,7 @@ or escaping the apostrophe with a backslash (`\`):
 "Runnin' down the hill"
 ```
 
-Nice, huh? To see your name in uppercase letters, simply type:
+Nice, huh? To see your name in uppercase letters, type:
 
 {% filename %}command-line{% endfilename %}
 ```python
@@ -134,7 +136,7 @@ These are the basics of every programming language you learn. Ready for somethin
 
 Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
 
-{% filename %}command-line{% endfilename %}
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
 ```python
 >>> len(304023)
 Traceback (most recent call last):
@@ -142,7 +144,9 @@ Traceback (most recent call last):
 TypeError: object of type 'int' has no len()
 ```
 
-We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+ It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
 
 {% filename %}command-line{% endfilename %}
 ```python
@@ -168,9 +172,9 @@ Let's say we want to create a new variable called `name`:
 >>> name = "Ola"
 ```
 
-You see? It's easy! It's simply: name equals Ola.
+We type name equals Ola.
 
-As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
 
 {% filename %}command-line{% endfilename %}
 ```python
@@ -195,7 +199,7 @@ You can use it in functions too:
 5
 ```
 
-Awesome, right? Of course, variables can be anything – numbers too! Try this:
+Awesome, right? Now, variables can be anything – numbers too! Try this:
 
 {% filename %}command-line{% endfilename %}
 ```python
@@ -207,7 +211,7 @@ Awesome, right? Of course, variables can be anything – numbers too! Try this:
 
 But what if we used the wrong name? Can you guess what would happen? Let's try!
 
-{% filename %}command-line{% endfilename %}
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
 ```python
 >>> city = "Tokyo"
 >>> ctiy
@@ -292,7 +296,7 @@ Maybe we want to reverse that order? Let's do that!
 [59, 42, 30, 19, 12, 3]
 ```
 
-Easy, right? If you want to add something to your list, you can do this by typing this command:
+If you want to add something to your list, you can do this by typing this command:
 
 {% filename %}command-line{% endfilename %}
 ```python
@@ -372,7 +376,7 @@ See, it's similar to a list. But you don't need to remember the index – just t
 
 What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
 
-{% filename %}command-line{% endfilename %}
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
 ```python
 >>> participant['age']
 Traceback (most recent call last):
@@ -382,7 +386,7 @@ KeyError: 'age'
 
 Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
 
-When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
 
 - Do you just need an ordered sequence of items? Go for a list.
 - Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
@@ -394,7 +398,7 @@ Dictionaries, like lists, are *mutable*, meaning that they can be changed after
 >>> participant['favorite_language'] = 'Python'
 ```
 
-Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
 
 {% filename %}command-line{% endfilename %}
 ```python
@@ -404,7 +408,7 @@ Like lists, using the `len()` method on the dictionaries returns the number of k
 
 I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
 
-You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
 
 {% filename %}command-line{% endfilename %}
 ```python
@@ -442,7 +446,7 @@ Excited for the next part? :)
 
 > For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
 
-A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
 
 {% filename %}command-line{% endfilename %}
 ```python
@@ -456,9 +460,11 @@ True
 True
 >>> 5 != 2
 True
+>>> len([1, 2, 3]) > len([4, 5])
+True
 ```
 
-We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
 
 Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, __always__ need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
 
@@ -472,7 +478,7 @@ True
 False
 ```
 
-`>` and `<` are easy, but what do `>=` and `<=` mean? Read them like this:
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
 
 - x `>` y means: x is greater than y
 - x `<` y means: x is less than y
@@ -498,12 +504,12 @@ You can give Python as many numbers to compare as you want, and it will give you
 
 Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
 
-{% filename %}command-line{% endfilename %}
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
 ```python
 >>> 1 > 'django'
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
-TypeError: unorderable types: int() > str()
+TypeError: '>' not supported between instances of 'int' and 'str'
 ```
 
 Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`).
@@ -511,13 +517,13 @@ Instead, it shows a **TypeError** and tells us the two types can't be compared t
 
 ## Boolean
 
-Incidentally, you just learned about a new type of object in Python. It's called __Boolean__,  and it is probably the easiest type there is.
+Incidentally, you just learned about a new type of object in Python. It's called __Boolean__.
 
 There are only two Boolean objects:
 - True
 - False
 
-But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). __true, TRUE, and tRUE won't work – only True is correct.__ (The same applies to 'False' as well, of course.)
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). __true, TRUE, and tRUE won't work – only True is correct.__ (The same applies to 'False' as well.)
 
 Booleans can be variables, too! See here:
 
@@ -558,7 +564,7 @@ So far we've been writing all our python code in the interpreter, which limits u
 - Save some code into a new python file
 - Run it!
 
-To exit from the Python interpreter that we've been using, simply type the `exit()` function
+To exit from the Python interpreter that we've been using, type the `exit()` function
 
 {% filename %}command-line{% endfilename %}
 ```python
@@ -568,7 +574,7 @@ $
 
 This will put you back into the command prompt.
 
-Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
 
 {% filename %}editor{% endfilename %}
 ```python
@@ -598,13 +604,15 @@ $ cd ~/Desktop
 <!--sec data-title="Change directory: Linux" data-id="python_linux"
 data-collapse=true ces-->
 
-On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+On Linux, it will be like this:
 
 {% filename %}command-line{% endfilename %}
 ```
 $ cd ~/Desktop
 ```
 
+(Remember that the word "Desktop" might be translated to your local language.)
+
 <!--endsec-->
 
 <!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
@@ -629,7 +637,7 @@ And on Windows Powershell, it will be like this:
 <!--endsec-->
 
 
-If you get stuck, just ask for help.
+If you get stuck, ask for help. That's exactly what the coaches are here for!
 
 Now use Python to execute the code in the file like this:
 
@@ -663,7 +671,7 @@ if 3 > 2:
 
 If we were to save and run this, we'd see an error like this:
 
-{% filename %}command-line{% endfilename %}
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
 ```
 $ python3 python_intro.py
 File "python_intro.py", line 2
@@ -679,7 +687,7 @@ if 3 > 2:
     print('It works!')
 ```
 
-Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
 
 Save it and give it another run:
 
@@ -711,7 +719,7 @@ $ python3 python_intro.py
 5 is indeed greater than 2
 ```
 
-If 2 were a greater number than 5, then the second command would be executed. Easy, right? Let's see how `elif` works:
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
 
 {% filename %}python_intro.py{% endfilename %}
 ```python
@@ -796,7 +804,7 @@ Time for the last part of this chapter!
 
 Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
 
-A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's start with an easy one. Replace the code in **python_intro.py** with the following:
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
 
 {% filename %}python_intro.py{% endfilename %}
 ```python
@@ -809,7 +817,7 @@ hi()
 
 Okay, our first function is ready!
 
-You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
 
 Let's run this now and see what happens:
 
@@ -825,7 +833,7 @@ Note: if it didn't work, don't panic! The output will help you to figure why:
 - If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
 - If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
 
-Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
 
 {% filename %}python_intro.py{% endfilename %}
 ```python
@@ -849,7 +857,7 @@ hi()
 
 Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
 
-{% filename %}command-line{% endfilename %}
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
 ```
 $ python3 python_intro.py
 Traceback (most recent call last):
@@ -899,7 +907,7 @@ Hi anonymous!
 
 This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
 
-Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
 
 {% filename %}python_intro.py{% endfilename %}
 ```python
@@ -941,7 +949,7 @@ We want to greet all of them by their name. We have the `hi` function to do that
 for name in girls:
 ```
 
-The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
 
 Here is the full code that will be in the file:
 
@@ -1002,6 +1010,9 @@ Note that the second of these two numbers is not included in the list that is ou
 
 That's it. __You totally rock!__ This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
 
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
 You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
 
+
 ![Cupcake](images/cupcake.png)
diff --git a/en/template_extending/README.md b/en/template_extending/README.md
index 56efeafa4a2..bbf0644d799 100644
--- a/en/template_extending/README.md
+++ b/en/template_extending/README.md
@@ -18,39 +18,41 @@ blog
             post_list.html
 ```
 
-Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
 ```html
-{% load staticfiles %}
+{% load static %}
+<!DOCTYPE html>
 <html>
     <head>
         <title>Django Girls blog</title>
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
         <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
         <link rel="stylesheet" href="{% static 'css/blog.css' %}">
     </head>
     <body>
-        <div class="page-header">
-            <h1><a href="/">Django Girls Blog</a></h1>
-        </div>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
 
-        <div class="content container">
+        <main class="container">
             <div class="row">
-                <div class="col-md-8">
+                <div class="col">
                 {% for post in posts %}
-                    <div class="post">
-                        <div class="date">
+                    <article class="post">
+                        <time class="date">
                             {{ post.published_date }}
-                        </div>
-                        <h1><a href="">{{ post.title }}</a></h1>
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
                         <p>{{ post.text|linebreaksbr }}</p>
-                    </div>
+                    </article>
                 {% endfor %}
                 </div>
             </div>
-        </div>
+        </main>
     </body>
 </html>
 ```
@@ -60,17 +62,19 @@ Then in `base.html`, replace your whole `<body>` (everything between `<body>` an
 {% filename %}blog/templates/blog/base.html{% endfilename %}
 ```html
 <body>
-    <div class="page-header">
-        <h1><a href="/">Django Girls Blog</a></h1>
-    </div>
-    <div class="content container">
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
         <div class="row">
-            <div class="col-md-8">
+            <div class="col">
             {% block content %}
             {% endblock %}
             </div>
         </div>
-    </div>
+    </main>
 </body>
 ```
 
@@ -83,19 +87,19 @@ Then in `base.html`, replace your whole `<body>` (everything between `<body>` an
 ```
 But why?  You just created a `block`!  You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
 
-Now save `base.html` and open your `blog/templates/blog/post_list.html` again.
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor.
 {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
 {% for post in posts %}
-    <div class="post">
-        <div class="date">
+    <article class="post">
+        <time class="date">
             {{ post.published_date }}
-        </div>
-        <h1><a href="">{{ post.title }}</a></h1>
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
         <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    </article>
 {% endfor %}
 ```
 
@@ -108,13 +112,13 @@ Time to add block tags to this file!
 ```html
 {% block content %}
     {% for post in posts %}
-        <div class="post">
-            <div class="date">
+        <article class="post">
+            <time class="date">
                 {{ post.published_date }}
-            </div>
-            <h1><a href="">{{ post.title }}</a></h1>
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
             <p>{{ post.text|linebreaksbr }}</p>
-        </div>
+        </article>
     {% endfor %}
 {% endblock %}
 ```
@@ -127,17 +131,17 @@ Only one thing left. We need to connect these two templates together.  This is w
 
 {% block content %}
     {% for post in posts %}
-        <div class="post">
-            <div class="date">
+        <article class="post">
+            <time class="date">
                 {{ post.published_date }}
-            </div>
-            <h1><a href="">{{ post.title }}</a></h1>
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
             <p>{{ post.text|linebreaksbr }}</p>
-        </div>
+        </article>
     {% endfor %}
 {% endblock %}
 ```
 
-That's it! Check if your website is still working properly. :)
+That's it! Save the file, and check if your website is still working properly. :)
 
 > If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
diff --git a/en/whats_next/README.md b/en/whats_next/README.md
index 52f050703a5..cb3f8012800 100644
--- a/en/whats_next/README.md
+++ b/en/whats_next/README.md
@@ -4,21 +4,37 @@ Congratulate yourself! __You're totally awesome__. We're proud! <3
 
 ### What to do now?
 
-Take a break and relax. You have just done something really huge.
+Take a break and relax! You have just done something really huge.
 
 After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
 
 ### Can you recommend any further resources?
 
-Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+Yes! There are a _lot_ of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
 
-Later on, you can try the resources listed below. They're all very recommended!
-- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
-- [New Coder tutorials](http://newcoder.io/tutorials/)
-- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
-- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
-- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
-- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+#### Django
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
 - [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
-- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
-- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+
+#### HTML, CSS and JavaScript
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
diff --git a/eo-UY/GLOSSARY.md b/eo-UY/GLOSSARY.md
new file mode 100644
index 00000000000..3f33fe11092
--- /dev/null
+++ b/eo-UY/GLOSSARY.md
@@ -0,0 +1,3 @@
+# kodredaktilo
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/eo-UY/README.md b/eo-UY/README.md
new file mode 100644
index 00000000000..7edeaa56cdc
--- /dev/null
+++ b/eo-UY/README.md
@@ -0,0 +1,51 @@
+# Django-Knabinoj-Lernilo
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Ĉi-tiu verko estas licencita laŭ la tutmonda licenco Krea Komunaĵ-Atribuad-Divido Samkondiĉa 4.0. Por vidi kopion de ĉi-tiu licenco vizitu https://creativecommons.org/licenses/by-sa/4.0/
+
+## Bonvenon
+
+Bonvenon al la Django-Knabino-Lernilo! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+Ni esperas, ke ni povos igi, ke vi amu teĥnikaron tiom ege kiom ni!
+
+## Kion vi lernos dum la lernilo?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+Bone, [ni komencu ĉe la komenco…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Ĉu vi ŝatus helpi nin traduki la memlernilon al aliajn lingvojn?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/eo-UY/SUMMARY.md b/eo-UY/SUMMARY.md
new file mode 100644
index 00000000000..aa4fba0c740
--- /dev/null
+++ b/eo-UY/SUMMARY.md
@@ -0,0 +1,35 @@
+# Enhavo
+
+* [Enkonduko](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Kodredaktilo](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [Kiel la interreto funkcias](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Kodredaktilo](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [Kio estas Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/eo-UY/chromebook_setup/README.md b/eo-UY/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/eo-UY/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/eo-UY/chromebook_setup/instructions.md b/eo-UY/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..9ddf3dca4ca
--- /dev/null
+++ b/eo-UY/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Vi povas [salti ĉi-tiun ĉapitron](http://tutorial.djangogirls.org/en/installation/#install-python), se vi ne uzas kromiolibron. Se vi uzas, via instalado estos iomete malsama. Vi povas ignori la reston de la instalinstrukcioj.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE estas ilo, kiu disponigas al vi kodoredaktilon kaj aliron al komputilo funkciante en la reto, kie vi povas instali, skribi kaj funkciigi la programaron. Dum la daŭro de la lernsesio, Cloud IDE agas kiel via *loka maŝino*. Vi ankoraŭ estos lanĉante komandojn en terminala interfaco same kiel viaj samklasanoj en OS X, Ubuntu, aŭ Vindozo, sed via terminalo estos konektita al komputilo funkciante aliloke, tiu cloud IDE estos agordita por vi. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/eo-UY/code_editor/README.md b/eo-UY/code_editor/README.md
new file mode 100644
index 00000000000..2e98f817cac
--- /dev/null
+++ b/eo-UY/code_editor/README.md
@@ -0,0 +1,11 @@
+# Kodredaktilo
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+Vi baldaŭ skribas vian unuan lineon de kodo, tial estas tempo elŝuti kodredaktilon!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/eo-UY/code_editor/instructions.md b/eo-UY/code_editor/instructions.md
new file mode 100644
index 00000000000..678ecb96ae5
--- /dev/null
+++ b/eo-UY/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Estas multaj diversaj redaktiloj kaj la elekto esence okazas surbaze de persona prefero. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. Por komencanto tamen tio verŝajne malpli taŭgas; nia rekomendoj estas same potenca, sed multe pli simpla.
+
+Nia sugestoj troviĝas sube, sed bonvolu demandi al via trejnisto, kio estas ilia prefero – plifalicos ricevi helpon de ili.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Elŝutu ĝin ĉi tie](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit estas malfermitfonta, senpaga redaktilo, havebla por ĉiuj operaciumoj.
+
+[Elŝutu ĝin ĉi tie](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Elŝutu ĝin ĉi tie](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom estas alia populara redaktilo. Ĝi estas senpaga, malfermitfonta kaj havebla por Vindozo, OS X kaj Linukso. Atom estas programata de [GitHub](https://github.com/).
+
+[Elŝutu ĝin ĉi tie](https://atom.io/)
+
+## Kial instalu kodredaktilon?
+
+Vi eble scivolas, kial ni instalas tion speciala kodredaktila programaro anstataŭ uzi iel kiel Vordo (angle: Microsoft Word) aŭ Notepado (angle: Notepad).
+
+La unua kialo estas, ke kodo devas esti **pura teksto**, kaj la problemo de programoj kiel Vordo kaj TekstEdito (angle: TextEdit) estas, ke ili ne vere faras puran tekston. Ili faras riĉan tekston (kun tiparo kaj formatado), uzante tajloritajn formatojn kiel [RTF (Riĉtekstformato, angle: Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+La dua kialo estas, ke kodredaktiloj estas speciale farita por redakti kodon, do ili havas helpemajn funkciojn kiel markadigi kodon kun koloroj laŭ ĝia signifo aŭ aŭtomate fermi citilojn por vi.
+
+Ni spertos tion poste. Baldaŭ vi iĝos pensanta pri via fidinda malnova redaktilo kiel unu el viaj plej ŝatataj iloj. :)
\ No newline at end of file
diff --git a/eo-UY/css/README.md b/eo-UY/css/README.md
new file mode 100644
index 00000000000..cf783590b6e
--- /dev/null
+++ b/eo-UY/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+&lt;link rel="stylesheet" href="{% static 'css/blog.css' %}"&gt;
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+&lt;link href="//fonts.googleapis.com/css?family=Lobster&amp;subset=latin,latin-ext" rel="stylesheet" type="text/css"&gt;
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Bonega!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/eo-UY/deploy/README.md b/eo-UY/deploy/README.md
new file mode 100644
index 00000000000..18ad585d6e5
--- /dev/null
+++ b/eo-UY/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Krei nian Git-deponejon
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/eo-UY/deploy/install_git.md b/eo-UY/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/eo-UY/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/eo-UY/deploy/signup_pythonanywhere.md b/eo-UY/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/eo-UY/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/eo-UY/django/README.md b/eo-UY/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/eo-UY/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/eo-UY/django_admin/README.md b/eo-UY/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/eo-UY/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/eo-UY/django_forms/README.md b/eo-UY/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/eo-UY/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/eo-UY/django_installation/README.md b/eo-UY/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/eo-UY/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/eo-UY/django_installation/instructions.md b/eo-UY/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/eo-UY/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/eo-UY/django_models/README.md b/eo-UY/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/eo-UY/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/eo-UY/django_orm/README.md b/eo-UY/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/eo-UY/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/eo-UY/django_start_project/README.md b/eo-UY/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/eo-UY/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/eo-UY/django_templates/README.md b/eo-UY/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/eo-UY/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/eo-UY/django_urls/README.md b/eo-UY/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/eo-UY/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/eo-UY/django_views/README.md b/eo-UY/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/eo-UY/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/eo-UY/dynamic_data_in_templates/README.md b/eo-UY/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/eo-UY/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/eo-UY/extend_your_application/README.md b/eo-UY/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/eo-UY/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/eo-UY/how_the_internet_works/README.md b/eo-UY/how_the_internet_works/README.md
new file mode 100644
index 00000000000..bf9484bc4bb
--- /dev/null
+++ b/eo-UY/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Kiel la interreto funkcias
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+Ni desegnis bildon por vi. Ĝi aspektas tiel:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+Ĝi fascinas, ĉu? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+Ĝi aspektas tiel:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/eo-UY/html/README.md b/eo-UY/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/eo-UY/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/eo-UY/installation/README.md b/eo-UY/installation/README.md
new file mode 100644
index 00000000000..0467fcad4ac
--- /dev/null
+++ b/eo-UY/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). Se vi volas, vi povas elekti instali tuj ĉion, kio estas en ĉi tio paĝo. Sed se vi volas komenci lerni aferojn antaŭ ol instali aron da aĵoj en vian komputilon, preterlasu ĉi tion ĉapitron kaj ni ekspliku al vi la instalerojn poste, kiam ili bezonatos.
+
+Bonŝancon!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [Kiel la interreto funkcias](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [Kio estas Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/eo-UY/intro_to_command_line/README.md b/eo-UY/intro_to_command_line/README.md
new file mode 100644
index 00000000000..e1f8097b348
--- /dev/null
+++ b/eo-UY/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (aŭ del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/eo-UY/intro_to_command_line/open_instructions.md b/eo-UY/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/eo-UY/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/eo-UY/python_installation/README.md b/eo-UY/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/eo-UY/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/eo-UY/python_installation/instructions.md b/eo-UY/python_installation/instructions.md
new file mode 100644
index 00000000000..7897de54338
--- /dev/null
+++ b/eo-UY/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django estas skribita en Python. Ni bezonas Python por fari iu ajn en Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/eo-UY/python_introduction/README.md b/eo-UY/python_introduction/README.md
new file mode 100644
index 00000000000..fca9040b58f
--- /dev/null
+++ b/eo-UY/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Ni skribu kelkan kodon!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Saluton " + "Ola"
+'Saluton Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ho, mia kor'."
+"Ho, mia kor'."
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Ho, mia kor\'.'
+"Ho, mia kor'."
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y signifas: x estas pli ol y
+- x `<` y signifas: x estas malpli ol y
+- x `<=` y signifas: x estas malpli ol aŭ egala al y
+- x `>=` y signifas: x estas pli ol aŭ egala al y
+
+Bonege! Ĉu vi volas fari plu? Provu ĉi-tio:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True (vera)
+- False (malvera)
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Saluton, Djangoaj virinoj!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Saluton, Djangoaj virinoj!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('Ĝi funkcias!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+Ĝi funkcias!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 ja estas pli granda ol 2')
+else:
+    print('5 ne estas pli granda ol 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 ja estas pli granda ol 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/eo-UY/template_extending/README.md b/eo-UY/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/eo-UY/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/eo-UY/whats_next/README.md b/eo-UY/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/eo-UY/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/es-ES/GLOSSARY.md b/es-ES/GLOSSARY.md
new file mode 100644
index 00000000000..9a6912eacf6
--- /dev/null
+++ b/es-ES/GLOSSARY.md
@@ -0,0 +1,3 @@
+# editor de código
+
+Un editor de código es una aplicación que te permite escribir código y guardarlo en ficheros del disco de tu ordenador. Puedes ver dónde descargar uno en el [capítulo Editor de código](./code_editor/README.md)
\ No newline at end of file
diff --git a/es-ES/README.md b/es-ES/README.md
new file mode 100644
index 00000000000..7914b968aac
--- /dev/null
+++ b/es-ES/README.md
@@ -0,0 +1,51 @@
+# Tutorial de Django Girls
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Este trabajo está bajo la licencia internacional Creative Commons Attribution-ShareAlike 4.0. Para ver una copia de esta licencia, visita el siguiente enlace https://creativecommons.org/licenses/by-sa/4.0/
+
+## Bienvenido/a
+
+¡Bienvenido/a al tutorial de las Django Girls! Estamos felices de verte por aquí. :) En este tutorial, te llevaremos en un viaje a las entrañas de las tecnologías web, dándote una idea de todos los fragmentos y piezas que necesitan encajarse para hacer que las redes funcionen tal y como conocemos.
+
+Con todo lo que hay por conocer, esto va a ser sin duda una aventura, pero no te preocupes. Ya has tenido el coraje de venir aquí, así que todo irá bien. :)
+
+## Introducción
+
+¿Alguna vez has tenido la sensación de que el mundo es cada vez más tecnológico? ¿que cada vez lo entiendes menos? ¿Alguna vez te has planteado crear un sitio web pero no sabías por donde empezar? ¿Has pensado alguna vez que el mundo del software es demasiado complicado como para intentar hacer algo por tu cuenta?
+
+Bueno, ¡tenemos buenas noticias! Programar no es tan difícil como parece y queremos demostrarte lo divertido que puede llegar a ser.
+
+Este tutorial no te convertirá en programadora de la noche a la mañana. Sí quieres ser buena en esto, necesitarás meses o incluso años de aprendizaje y práctica. Sin embargo queremos enseñarte que programar o crear sitios web no es tan complicado como parece. Intentaremos explicar las cosas lo mejor que podamos, para perderle el miedo a la tecnología.
+
+¡Esperamos conseguir que te guste la tecnología tanto como a nosotras!
+
+## ¿Qué aprenderás con este tutorial?
+
+Cuando termines el tutorial, tendrás una aplicación web sencilla y funcional: tu propio blog. Te mostraremos como ponerla en línea, ¡para que otros puedan ver tu trabajo!
+
+Tendrá (más o menos) esta pinta:
+
+![Figure 0.1](images/application.png)
+
+> Si estás siguiendo este tutorial por tu cuenta y no tienes un mentor que te ayude en caso de dificultades, tenemos un chat para ti: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). ¡Hemos pedido a mentores y asistentes de ediciones anteriores, que pasen por allí de vez en cuando para echar una mano a otras con el tutorial! ¡No tengas miedo de preguntar ahí!
+
+Bien, [empecemos por el comienzo...](./how_the_internet_works/README.md)
+
+## Seguir el tutorial desde casa
+
+Participar en un taller de Django Girls en vivo es genial, pero somos conscientes de que no siempre es posible hacerlo. Por eso, te recomendamos hacer este tutorial en casa. Para las que estáis en casa, estamos preparando videos que facilitarán seguir el tutorial por tu cuenta. Todavía está en progreso, pero cada vez hay más cosas explicadas en el canal de YouTube [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) (Nota: en inglés).
+
+En cada capítulo hay un enlace que lleva al video correspondiente (si lo hay).
+
+## Sobre nosotras y Cómo contribuir
+
+Este tutorial lo mantiene [DjangoGirls](https://djangogirls.org/). Si encuentras algún error o quieres actualizar el tutorial, por favor [sigue la guía de cómo contribuir](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## ¿Te gustaría ayudarnos a traducir el tutorial a otros idiomas?
+
+Actualmente, las traducciones se hacen en la plataforma crowdin.com, en el siguiente enlace:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Si tu idioma no aparece en la lista de [crowdin](https://crowdin.com/), por favor [abre un nuevo issue](https://github.com/DjangoGirls/tutorial/issues/new) con el idioma para que podamos añadirlo.
\ No newline at end of file
diff --git a/es-ES/SUMMARY.md b/es-ES/SUMMARY.md
new file mode 100644
index 00000000000..9feb1f3c8b4
--- /dev/null
+++ b/es-ES/SUMMARY.md
@@ -0,0 +1,35 @@
+# Contenido
+
+* [Introducción](README.md)
+* [Instalación](installation/README.md) 
+  * [Línea de Comandos](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Editor de texto](installation/README.md#code-editor)
+  * [Entorno Virtual](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Instalación (chromebook)](chromebook_setup/README.md)
+* [Cómo funciona Internet](how_the_internet_works/README.md)
+* [Introducción a la línea de comandos](intro_to_command_line/README.md)
+* [Instalación de Python](python_installation/README.md)
+* [Editor de código](code_editor/README.md)
+* [Introducción a Python](python_introduction/README.md)
+* [¿Qué es Django?](django/README.md)
+* [Instalación de Django](django_installation/README.md)
+* [¡Tu primer proyecto en Django!](django_start_project/README.md)
+* [Modelos en Django](django_models/README.md)
+* [Administrador de Django](django_admin/README.md)
+* [¡Despliega!](deploy/README.md)
+* [URLs en Django](django_urls/README.md)
+* [Vistas en Django - ¡Hora de crear!](django_views/README.md)
+* [Introducción a HTML](html/README.md)
+* [ORM de Django (QuerySets)](django_orm/README.md)
+* [Datos dinámicos en las plantillas](dynamic_data_in_templates/README.md)
+* [Plantillas de Django](django_templates/README.md)
+* [CSS - ¡Que quede bonito!](css/README.md)
+* [Extendiendo plantillas](template_extending/README.md)
+* [Amplía tu aplicación](extend_your_application/README.md)
+* [Formularios de Django](django_forms/README.md)
+* [¿Y ahora qué?](whats_next/README.md)
\ No newline at end of file
diff --git a/es-ES/chromebook_setup/README.md b/es-ES/chromebook_setup/README.md
new file mode 100644
index 00000000000..842f198d5ee
--- /dev/null
+++ b/es-ES/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Configuración de Chromebook
+
+> **Nota** Si ya has trabajado en los [pasos de instalación](../installation/README.md), no es necesario que hagas esto de nuevo - puedes ir directamente a [Introducción a Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/es-ES/chromebook_setup/instructions.md b/es-ES/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..e4ad4c9f89c
--- /dev/null
+++ b/es-ES/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Puedes [saltarte esta sección](http://tutorial.djangogirls.org/en/installation/#install-python) en caso de que no estés usando un Chromebook. Si lo usas, tu experiencia de instalación será algo diferente. Puedes ignorar el resto de las instrucciones de instalación.
+
+### IDE en la nube (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE es una herramienta que te da un editor de código y acceso a un ordenador conectado a internet en el que puedes instalar, escribir y ejecutar software. Durante este tutorial, el IDE en la nube te servirá como tu *máquina local*. Seguirás corriendo comandos en una interfaz de terminal justo como tus compañeros de clase en OS X, Ubuntu, o Windows, pero tu terminal será conenctada a una computadora corriendo en algún otro lugar que cloud IDE establecerá por tí. Aquí tienes las instrucciones para varios IDEs de la nube (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Puedes elegir uno de los IDEs en la nube, y seguir sus instrucciones.
+
+#### PaizaCloud Cloud IDE
+
+1. Ve a [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Crea una cuenta
+3. Haga clic en *New Server* y elija la aplicación Django
+4. Haga clic en el botón Terminal (al lado izquierdo de la ventana)
+
+Ahora deberías ver una interfaz con una barra y botones en la izquierda. Haz click en al botón "Terminal" para abrir la ventana de la terminal con un símbolo de sistema como este:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+La terminal en el Cloud IDE de PaizaCloud está preparada para ejecutar tus instrucciones. Puedes redimensionar o maximizar la ventana para hacerla un poco más grande.
+
+#### AWS Cloud9
+
+Actualmente Cloud 9 requiere que te registres con AWS e ingreses la información de una tarjeta de crédito.
+
+1. Instala Cloud 9 desde la [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Ve a [c9.io](https://c9.io) y haz clic en *Get started with AWS Cloud9*
+3. Regístrate en una cuenta AWS (requiere información de tarjeta de crédito, pero puedes usar gratis)
+4. En el panel de control AWS, introduzca *Cloud9* en la barra de búsqueda y haga clic en ella
+5. En el panel de control de Cloud 9, haga clic en *Create environment*
+6. Nómbralo *django-girls*
+7. Mientras configura los ajustes, seleccione *Create a new instance for environment (EC2)* para "Environment Type" y seleccione el valor *t2.micro* para "Instance type" (debería decir "Free-tier eligible."). La configuración por defecto de ahorro de costes está bien y puede mantener los otros valores por defecto.
+8. Haz clic en *Next step*
+9. Haz clic en *Create environment*
+
+Ahora deberías ver una interfaz con una barra, una gran ventana principal con algún texto y una ventana pequeña en la parte inferior que se vería así:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+El área de abajo es tu terminal. Puedes usar el terminal para enviar instrucciones al ordenador remoto Cloud 9. Puedes redimensionar la ventana para hacerla un poco mas grande
+
+#### IDE en la nube de Glitch.com
+
+1. Entra en [Glitch.com](https://glitch.com/)
+2. Regístrate y crea una cuenta (https://glitch.com/signup) o usa tu cuenta de GitHub si tienes una (lee las instrucciones para GitHub a continuación)
+3. Haz clic en *Proyecto nuevo* y selecciona *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Entorno Virtual
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/es-ES/code_editor/README.md b/es-ES/code_editor/README.md
new file mode 100644
index 00000000000..c801a8819f6
--- /dev/null
+++ b/es-ES/code_editor/README.md
@@ -0,0 +1,11 @@
+# Editor de código
+
+> Para los lectores en casa: este capitulo se explica en el video [Instalando Python & Editor de Código](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+Estás a punto de escribir tu primera línea de código, así que ¡es hora de descargar un editor de código!
+
+> **Nota** Si estas usando un Chromebook, omite este capitulo y asegurate de seguir las instrucciones de [Instalacion de Chromebook](../chromebook_setup/README.md). El cloud IDE que elegiste (Paizacloud Cloud IDE o AWS cloud9) incluye un editor de código, y cuando tu abres un archivo en tu IDE desde el menú de archivos, tu estarás automáticamente usando el editor.
+> 
+> **Nota** Quizás ya hayas hecho esto en el [Capítulo de instalación](../installation/README.md) - si es así, ¡Puedes ir directamente al siguiente capítulo!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/es-ES/code_editor/instructions.md b/es-ES/code_editor/instructions.md
new file mode 100644
index 00000000000..398cbd64c64
--- /dev/null
+++ b/es-ES/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Hay muchos diferentes editores y se reduce en gran parte a la preferencia personal La mayoría de programadores de Python usan complejos pero muy potentes IDEs (Entornos de Desarrollo Integrados), como PyCharm. Como principiante, de cualquier manera, es probable que sea menos adecuado; nuestras recomendaciones son igual de poderosas, pero más simples.
+
+Nuestras sugerencias están abajo, pero siéntete libre de preguntarle a tu tutor cuales son sus preferencias - será mucho mas simple obtener ayuda de ellos.
+
+## Visual Studio Code
+
+Visual Studio Code es un editor de código fuente desarrollado por Microsoft para Windows, Linux y macOS. Incluye soporte para depuración, control Git embebido, resaltado de sintaxis, finalización inteligente de código, fragmentos y refactorización de código.
+
+[Descárgalo aquí](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit es un editor gratuito de código abierto, disponible para todos los sistemas operativos.
+
+[Descárgalo aquí](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text es un editor muy popular con un periodo de prueba gratis, y está disponible para todos los sistemas operativos.
+
+[Descárgalo aquí](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom es otro editor popular. Es gratis, de código abierto y está disponible para Windows, OS X and Linux. Atom esta desarrollado por [Github](https://github.com/).
+
+[Descárgalo aquí](https://atom.io/)
+
+## ¿Por qué estamos instalando un editor de código?
+
+Tú podrías estar preguntándote por qué estamos instalando éste especial software editor de código, en vez de usar algo como Word o Notepad.
+
+La primera razón es que el código necesita ser **texto plano**, y el problema con programas como Word y Textedit es que ellos actualmente no produce texto plano, ellos producen texto rico (con fuentes y formatos), usando formatos personalizados como [RTF ( Formato del Texto Enriquecido, del inglés Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+La segunda razón es que los editores de código son especializados para editar código, así ellos pueden proveer características útiles como destacar código con color acorde a su significado, o automáticamente cerrando citas para ti.
+
+Veremos todo esto en acción más adelante. Pronto, llegarás a pensar que tu viejo confiable editor de código es una de tus herramientas favoritas :)
\ No newline at end of file
diff --git a/es-ES/css/README.md b/es-ES/css/README.md
new file mode 100644
index 00000000000..ceeec475c62
--- /dev/null
+++ b/es-ES/css/README.md
@@ -0,0 +1,330 @@
+# CSS - ¡Que quede bonito!
+
+Nuestro blog todavía es un poco feo, ¿no te parece? ¡Es hora de ponerlo bonito! Para eso, vamos a usar CSS.
+
+## ¿Qué es CSS?
+
+El lenguaje CSS (las siglas en inglés de hojas de estilos en cascada, o Cascading Style Sheets), sirve para describir la apariencia y el formato de un sitio web escrito en un lenguaje de marcado (como HTML). Has de cuenta que es como aplicar maquillaje a nuestra página web. ;)
+
+Pero no queremos empezar de cero otra vez, ¿verdad? Una vez más vamos a utilizar algo que otros programadores ya han publicaron gratis en internet. Reinventar la rueda todo el tiempo no es nada divertido.
+
+## ¡Comenzemos a usar Bootstrap!
+
+Bootstrap es uno de los frameworks de HTML y CSS mas populares para desarrollar para sitios web atractivos: https://getbootstrap.com/
+
+Fue escrito por programadores que trabajaban en Twitter. ¡Ahora lo mantienen y desarrollan voluntarios de todo el mundo!
+
+## Instala Bootstrap
+
+Para instalar Bootstrap, abre tu fichero `.html` en el editor de código y añade esto a la sección `<head>`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Esto no añade ningún archivo a tu proyecto. Solo apunta a archivos que ya existen en Internet. Así que adelante, accede a tu sitio web y actualiza la página ¡Aquí la tienes!
+
+![Figura 14.1](images/bootstrap1.png)
+
+¡Ya luce mucho mejor!
+
+## Archivos estáticos en Django
+
+Finalmente vamos a mirar más de cerca esto que hemos estado llamando **archivos estáticos**. Los archivos estáticos son todas tus imágenes y archivos CSS. Su contenido no depende del contexto requerido y siempre será el mismo para cada usuario.
+
+### Dónde poner los archivos estáticos para Django
+
+Django ya sabe dónde encontrar los archivos estáticos para la incorporación de la aplicación "admin". Ahora necesitamos añadir los archivos estáticos de nuestra aplicación, `blog`.
+
+Hacemos eso creando una carpeta llamada `static` dentro de la aplicación blog:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django automáticamente encontrará cualquier carpeta llamada "static" dentro de cualquiera de las carpetas de tus aplicaciones. Entonces va a ser posible usar su contenido como archivos estáticos.
+
+## ¡Tu primer archivo CSS!
+
+Vamos a crear un archivo CSS, para añadir tu propio estilo a la página. Crea un nuevo directorio llamado `css` dentro de la carpeta `static`. A continuación, crea un nuevo archivo llamado `blog.css` dentro de la carpeta `css`. ¿Listos?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+¡Vamos a escribir algo de CSS! Abre el archivo `blog/static/css/blog.css` en el editor de código.
+
+No vamos a profundizar demasiado en cómo personalizar y aprender CSS. Pero te podemos recomendar un un curso gratuito de CSS al final de esta página por si quieres aprender más.
+
+Pero vamos a hacer al menos un poco. ¿Quizas podamos cambiar el color de nuestros encabezados? Los ordenadores utilizan códigos especiales para expresar los colores. Estos códigos empiezan con `#` seguidos por 6 letras (A-F) y números (0-9). Por ejemplo, el código del color azul es `#0000FF`. Puedes encontrar los códigos de muchos colores aquí: http://www.colorpicker.com/ y en otras páginas web. También puedes utilizar [colores predefinidos](http://www.w3schools.com/colors/colors_names.asp) utilizando su nombre en inglés, como `red` y `green`.
+
+En el archivo `blog/static/css/blog.css` deberías añadir el siguiente código:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` es un selector CSS. Esto significa que estamos aplicando nuestros estilos a cualquier elemento de `a` dentro de un elemento de `h1`; el selector `h2 a` hace lo mismo para los elementos de `h2`. Así, cuando tenemos algo como `<h1><a href="">link</a></h1>`, se aplicará el estilo `h1 a`. En este caso, le estamos diciendo que cambie el color a un `#C25100`, que es un naranjo oscuro. O puedes poner tu propio color aqui, ¡pero asegurate que tenga un buen contraste contra un fondo blanco!
+
+En un archivo CSS se definen los estilos de los elementos que aparecen en el archivo HTML. La primera forma de identificar los elementos es por su nombre. Puede que los recuerdes como 'tags' de la sección de HTML. Cosas como `a`, `h1`, y `body` son algunos ejemplos de nombres de elementos. También podemos identificar elementos por el atributo `class` o el atributo `id`. Los valores de "class" e "id" son nombres que das al elemento para poderlo identificar. Con el atributo "class" identificamos grupos de elementos del mismo tipo y con el atributo "id" identificamos un elemento específico. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Si quieres aprender más sobre los selectores CSS puedes consultar en [Selectores de CSS en w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+También necesitamos decirle a nuestra plantilla HTML que hemos añadido código CSS. Abre el archivo `blog/templates/blog/post_list.html` en el editor de código y añade esta línea al principio del todo:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Aquí solo estamos cargando archivos estáticos. :) Entre las etiquetas `<head>` y `</head>`, después de los enlaces a los archivos CSS de Bootstrap, añade esta línea:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+El navegador lee los archivos en el orden que le son dados, por lo que debemos asegurarnos de que está en el lugar correcto. De lo contrario, el código en nuestro archivo podría ser reemplazado por código en nuestros archivos Bootstrap. Le acabamos de decir a nuestra plantilla dónde se encuentra nuestro archivo CSS.
+
+Ahora tu archivo debe tener este aspecto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+De acuerdo, ¡guarda el archivo y actualiza el sitio!
+
+![Figura 14.2](images/color2.png)
+
+¡Buen trabajo! ¿Tal vez nos gustaría también dar un poco de aire a nuestro sitio web y aumentar el margen en el lado izquierdo?. ¡Vamos a intentarlo!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Añade esto a tu CSS, guarda el archivo y ¡mira cómo funciona!
+
+![Figura 14.3](images/margin2.png)
+
+¿Quizá podríamos personalizar la tipografía del título? Pega esto en la sección `<head>` del archivo `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Como antes, revisa el orden y pon antes del enlace a `blog/static/css/blog.css`. Esta línea importará un estilo de letra llamada *Lobster* de Google Fonts (https://www.google.com/fonts).
+
+Encuentra el bloque de declaración (el código entre las llaves `{` y `}`) `h1 a` en el archivo CSS `blog/static/css/blog.css`. Ahora añade la línea `font-family: 'Lobster';` entre las llaves y actualiza la página:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figura 14.3](images/font.png)
+
+¡Genial!
+
+Como ya hemos dicho, CSS tiene un concepto de clases. Las clases te permiten dar un nombre a una parte del código HTML para aplicar estilos solo a esta parte, sin afectar a otras. ¡Esto puede ser súper útil! Quizá tienes dos divs haciendo algo diferente (como el encabezado y el texto de tu publicación). Las clases pueden ayudarte a asignarles estilos distintos.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Ahora añadiremos bloques de declaración a varios selectores. Los selectores que comienzan con `.` hacen referencia a clases. Hay muchos tutoriales y explicaciones excelentes sobre CSS en la Web que te pueden ayudar a entender el código que sigue a continuación. Por ahora, copia y pega lo siguiente en tu archivo `blog/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Luego rodea el código HTML que muestra los posts con declaraciones de clases. Cambia esto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+en `blog/templates/blog/post_list.html` por esto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Guarda estos archivos y recarga tu sitio.
+
+![Figura 14.4](images/final.png)
+
+¡Woohoo! Queda genial, ¿Verdad? Mira el código que acabamos de pegar para encontrar los lugares donde añadimos clases en el HTML y las usamos en el CSS. ¿Qué cambiarías si quisieras que la fecha fuera color turquesa?
+
+No tengas miedo a experimentar con este CSS un poco y tratar de cambiar algunas cosas. Jugar con el CSS te puede ayudar a entender lo que hacen las distintas secciones. Si algo deja de funcionar, no te preocupes, ¡siempre puedes deshacerlo!
+
+Realmente recomendamos hacer cursos gratuitos online de "básico HTML & HTML5" y "CSS básico" en [freeCodeCamp](https://learn.freecodecamp.org/). Pueden ayudarte a aprender todo acerca de hacer tus sitios web más bonitos con HTML y CSS.
+
+¡¿Lista para el siguiente capítulo?! :)
\ No newline at end of file
diff --git a/es-ES/deploy/README.md b/es-ES/deploy/README.md
new file mode 100644
index 00000000000..6c05d6fcc80
--- /dev/null
+++ b/es-ES/deploy/README.md
@@ -0,0 +1,246 @@
+# ¡Despliega!
+
+> **Nota** El siguiente capítulo puede ser, a veces, un poco difícil de seguir. Ten paciencia y acábalo. El despliegue es una parte importante del proceso en el desarrollo de un sitio web. Este capítulo está a mitad del tutorial para que tu mentor pueda ayudarte a conseguir que tu sitio web esté online, algo que puede ser un poco complicado. Así, aunque se te acabe el tiempo, podrás terminar el tutorial por tu cuenta.
+
+Hasta ahora, tu sitio web sólo está disponible en tu ordenador. ¡Ahora aprenderás como desplegarlo! El despliegue es el proceso de publicar tu aplicación en internet para que la gente pueda acceder y ver tu sitio web. :)
+
+Como ya has aprendido, un sitio web tiene que estar en un servidor. Hay muchos proveedores de servidores disponibles en internet, nosotros vamos a usar [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere es gratuito para aplicaciones pequeñas que no tienen muchos visitantes, y con eso tendrás más que suficiente por ahora.
+
+El otro servicio externo que vamos a utilizar es [GitHub](https://www.github.com), un servicio de almacenamiento de código. Hay otras opciones por ahí, pero hoy en día casi todas las programadoras y programadores tenemos una cuenta de GitHub, ¡y ahora tú también la vas a tener!
+
+Estos tres lugares serán importantes para ti. Tu ordenador local será el lugar donde desarrollas y pruebas. Cuando estés contento con los cambios, subirás una versión de tu programa a GitHub. Tu sitio web estará en PythonAnywhere y para actualizarlo descargarás la última versión de tu código desde GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Crear nuestro repositorio Git
+
+Git sigue los cambios realizados a un grupo determinado de archivos en lo que llamamos un repositorio de código (abreviado "repo"). Vamos a crear uno para nuestro proyecto. Abre la consola y ejecuta los siguientes comandos en el directorio de `djangogirls`:
+
+> **Nota** Comprueba en qué directorio estás ahora mismo (es decir, el directorio de trabajo actual) con el comando `pwd` (OSX/Linux) o `cd` (Windows) antes de inicializar el repositorio. Deberías estar en la carpeta `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Tu nombre"
+    $ git config --global user.email tu@ejemplo.com
+    
+
+Inicializar el repositorio de git es algo que sólo tenemos que hacer una vez por proyecto (y no tendrás que volver a teclear tu nombre de usuario y correo electrónico nunca más).
+
+Git llevará un seguimiento de los cambios realizados en todos los archivos y carpetas en este directorio, pero hay algunos archivos que queremos que ignore. Esto lo hacemos creando un archivo llamado `.gitignore` en el directorio base. Abre tu editor y crea un nuevo archivo con el siguiente contenido:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+Y guárdalo como `.gitignore` en la carpeta "djangogirls".
+
+> **Nota** ¡El punto al principio del nombre del archivo es importante! Si tienes problemas para crearlo (a los Mac no les gusta que crees ficheros con un punto al principio del nombre usando el Finder por ejemplo), entonces usa la opción "Save As" o "Guardar como" de tu editor, esto funcionará seguro. Asegúrate de no añadir `.txt`, `.py`, o ninguna otra extensión al nombre de fichero -- Git solo lo reconocerá si se llama exactamente `.gitignore`, sin nada más. Linux y MacOS usan archivos con nombres que comienzan con `.` (como `.gitignore`) y aparecen ocultos, por lo que el comando normal `ls` no te mostrará esos archivos. En su lugar, usa `ls -a` para ver el archivo `.gitignore`.
+> 
+> **Nota** Uno de los archivos especificados en tu `.gitignore` es `db.sqlite3`. Ese fichero es tu base de datos local, donde se almacenan los usuarios y publicaciones de tu blog. Vamos a seguir las buenas prácticas de programación web: vamos a usar bases de datos separadas para tu sitio local y tu sitio en producción en PythonAnywhere. La base de datos en PythonAnywhere podría ser SQLite, como en tu máquina de desarrollo, pero también podrías usar otro gestor de base de datos como MySQL o PostgreSQL que pueden soportar muchas más visitas que SQLite. En cualquier caso, al ignorar la base de datos SQLite en tu copia de GitHub, todos los posts y el super usuario que has creado hasta el momento solo estarán disponibles en local, y tendrás que crear nuevos usuarios y publicaciones en producción. Tu base de datos local es un buen campo de pruebas donde puedes probar diferentes cosas sin miedo a estropear o borrar las publicaciones reales de tu blog.
+
+Te recomendamos utilizar el comando `git status` antes de `git add` o en cualquier momento en que no sepas muy bien lo que ha cambiado. Esto te ayudará a evitar sorpresas, como subir cambios o archivos que no queríamos subir. El comando `git status` muestra información sobre cualquier archivo no seguido ("untracked"), modificado ("modified"), preparado ("staged"), el estado de la rama y muchas cosas más. La salida debería ser parecida a esto:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Y finalmente guardamos nuestros cambios. Ve a la consola y ejecuta estos comandos:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Subiendo tu código a Github
+
+Vaya a [GitHub.com](https://www.github.com) y regístrese para obtener una cuenta de usuario nueva y gratuita. (Si ya lo hiciste en la preparación del taller, ¡eso es genial!) Asegúrate de recordar tu contraseña (agrégala a tu administrador de contraseñas, si usas uno).
+
+A continuación, crea un nuevo repositorio con el nombre "my-first-blog". Deja el checkbox "initialize with a README" sin marcar, deja la opción de .gitignore vacía (ya lo hemos hecho manualmente) y deja la licencia como None.
+
+![](images/new_github_repo.png)
+
+> **Nota** El nombre `my-first-blog` es importante - podrías escoger otro, pero va a salir muchas veces en las instrucciones que vienen a continuación, y vas a tener que acordarte de cambiarlo cada vez. Lo más fácil es quedarse con el nombre `my-first-blog`.
+
+En la siguiente pantalla, verás la URL para clonar el repo, que tendrás que usar en los comandos que van a continuación:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Ahora necesitas enlazar el repositorio Git en tu ordenador con el repositorio de GitHub.
+
+Escribe lo siguiente en la consola (cambia `<your-github-username>` por tu nombre de usuario de GitHub, pero sin los símbolos < y > -- fíjate en que la URL debería coincidir con la URL para clonar el repo que acabas de ver):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Cuando hagas push a GitHub, te preguntará tu usuario y password de GitHub, y después de introducirlos, deberías ver algo como esto:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Tu código ya está subido a GitHub. ¡Ve y compruébalo! Encontrarás que está en buena compañía - [Django](https://github.com/django/django), [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial) y muchos otros proyectos de software libre están alojados en GitHub. :)
+
+# Configurar nuestro blog en PythonAnywhere
+
+## Crea una cuenta en PythonAnywhere
+
+> **Nota** A lo mejor ya has creado una cuenta en PythonAnywhere durante los pasos de instalación. Si es así, no necesitas hacerlo otra vez.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configurar nuestro sitio en PythonAnywhere
+
+Vuelve al [dashboard de PythonAnywhere](https://www.pythonanywhere.com/) haciendo click en el logo, y escoge la opción de iniciar una consola "Bash" – esta terminal es como la que hay en tu ordenador, pero en el servidor de PythonAnywhere.
+
+![La sección 'New Console' en la interfaz de PythonAnywhere con un botón para 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Nota** PythonAnywhere está basado en Linux, así que si estás en Windows, la consola será un poco distinta a la de tu ordenador.
+
+Para desplegar una aplicación web en PythonAnywhere necesitas descargar tu código de GitHub y configurar PythonAnywhere para que lo reconozca y lo sirva como una aplicación web. Hay formas de hacerlo manualmente, pero PythonAnywhere tiene una herramienta automática que lo hará todo por nosotros. Lo primero, vamos a instalar la herramienta:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+Eso debería mostrar en pantalla algunos mensajes como `Collecting pythonanywhere`, y finalmente una linea diciendo que ha terminado bien: `Successfully installed (...) pythonanywhere- (...)`.
+
+Ahora ejecutaremos el asistente para configurar automáticamente nuestra aplicación desde GitHub. Teclea lo siguiente en la consola de PythonAnywhere (no te olvides de usar tu propio nombre de usuario de GitHub en lugar de `<your-github-username>`, para que la URL sea como la URL de clonar el repo de GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+A medida que se ejecuta, podrás ver lo que hace:
+
+- Se descarga tu código de GitHub
+- Crear un virtualenv en PythonAnywhere, como el de tu propia computadora
+- Actualiza tus ficheros de settings con algunos settings de despliegue
+- Crea la base de datos en PythonAnywhere ejecutando el comando `manage.py migrate`
+- Configura los archivos estáticos (static) (luego hablaremos de éstos con más detalle)
+- Y configura PythonAnywhere para publicar tu aplicación web a través de su API
+
+En PythonAnywhere todos estos pasos están automatizados, pero son los mismos que tendrías que seguir en cualquier otro proveedor de servidores.
+
+Lo más importante que debes notar en este momento es que tu base de datos en PythonAnywhere está totalmente separada de tu base de datos en tu propia computadora, por lo que puedes tener diferentes publicaciones y cuentas de administrador. Como consecuencia, igual que lo hicimos en tu ordenador, tenemos que crear la cuenta de administrador con el comando `createsuperuser`. PythonAnywhere ya ha activado el virtualenv automáticamente, así que lo único que tienes que hacer es ejecutar:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Teclea las credenciales para tu usuario admin. Para evitar confusiones, te recomendamos usar el mismo nombre de usuario que usaste en tu ordenador local; aunque a lo mejor prefieres que la contraseña en PythonAnywhere sea más segura.
+
+Ahora, si quieres, también puedes ver tu código en PythonAnywhere con el comando `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+También puedes ir a la página de ficheros ("Files") y navegar por los ficheros y directorios usando el visor de PythonAnywhere. (Desde la página de la consola ("Console"), puedes ir a cualquier otra página de PythonAnywhere usando el botón de la esquina superior derecha. Desde el resto de páginas, también hay enlaces a las otras en la parte superior.)
+
+## ¡Ya estás en vivo!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Nota** Este es un tutorial para principiantes, y al desplegar este sitio hemos tomado algunos atajos que tal vez no sean las mejores prácticas desde el punto de vista de la seguridad. Si decide construir sobre este proyecto, o comenzar un nuevo proyecto, debe revisar la [lista de verificación de despliegue de Django](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) para obtener algunos consejos sobre cómo proteger su sitio.
+
+## Consejos de depuración
+
+Si te sale un error al ejecutar el script `pa_autconfigure_django.py`, aquí hay algunas causas comunes:
+
+- Te has olvidado de crear el token de API de PythonAnywhere.
+- No has puesto bien la URL de GitHub
+- Si ves un error diciendo *"Could not find your settings.py*, es probable que no añadieras todos tus archivos a Git, y/o no los subiste a GitHub correctamente. Repasa la sección de Git más arriba
+- Si anteriormente se suscribió a una cuenta de PythonAnywhere y tuvo un error con collectstatic, probablemente tenga una versión anterior de SQLite (por ejemplo, 3.8.2) para su cuenta. En ese caso, regístrese para una nueva cuenta e intente los comandos en la sección PythonAnywhere anterior.
+
+Si ves un error al visitar tu sitio, el primer lugar para ver qué está pasando es el **log de errores**. Encontrará un enlace en la página ["Web"](https://www.pythonanywhere.com/web_app_setup/) de PythonAnywhere. Mira si hay algún mensaje de error allí; los más recientes están en la parte inferior.
+
+Hay también algunos [ consejos generales de depuración en la página de ayuda de PythonAnywhere](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+Y recuerda, ¡tu mentor está aquí para ayudar!
+
+# ¡Comprueba tu página!
+
+La página por defecto debería decir "It worked!", tal como dice en tu ordenador local. Prueba a añadir `/admin/` al final de la URL y llegarás a la página de administración. Entra con tu usuario y password, y verás que puedes añadir nuevas publicaciones en el servidor -- recuerda, los post que tenías en tu base de datos local no se han subido a al blog publicado en producción.
+
+Después de crear algunas publicaciones, puedes volver a tu instalación local (no la de PythonAnywhere). A partir de ahora, trabaja en tu instalación local para hacer los siguientes cambios. Este es un flujo de trabajo típico en el desarrollo web – haz cambios localmente, sube (push) esos cambios a GitHub, y descarga (pull) tus cambios al servidor de publicación. Esto te permite trabajar y experimentar en local sin romper tu página publicada. Mola, ¿eh?
+
+¡Date una *GRAN* palmada en la espalda! Desplegar a un servidor es una de las partes más complicadas de desarrollo web y a menudo la gente necesita varios días para que funcione del todo. Pero tu ya tienes tu sitio publicado, ¡en internet de verdad!
\ No newline at end of file
diff --git a/es-ES/deploy/install_git.md b/es-ES/deploy/install_git.md
new file mode 100644
index 00000000000..d9e3b5c5e62
--- /dev/null
+++ b/es-ES/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git es un "sistema de control de versiones" que utilizan muchos programadores. Este software puede seguir los cambios realizados en archivos a lo largo del tiempo de forma que más tarde puedas volver a cualquier versión anterior. Algo similar a la herramienta de "Control de Cambios" en los programas de tipo Word (por ejemplo, Microsoft Word o LibreOffice Writer), pero mucho más potente.
+
+## Instalar Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Puedes descargar Git desde [git-scm.com](https://git-scm.com/). Puedes hacer click en "Next" en todos los pasos excepto en dos: cuando se te pregunte que selecciones tu editor, selecciona Nano, y en el paso "adjusting your PATH environment", selecciona "Use Git and optional Unix tools from the Windows Command Prompt" (la última opción). Aparte de eso, los valores por defecto son correctos. "Checkout Windows-style, commit Unix-style line endings" tampoco necesita corrección.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Descarga Git de [git-scm.com](https://git-scm.com/) y sigue las instrucciones.
+
+> **Nota** Si estas usando OS X 10.6, 10.7 o 10.8, tendrás que instalar git desde aquí: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/es-ES/deploy/signup_pythonanywhere.md b/es-ES/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..2ba4197a81d
--- /dev/null
+++ b/es-ES/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere es un servicio para ejecutar código Python en servidores "en la nube". Lo vamos a usar para alojar nuestro sitio para que esté disponible en Internet.
+
+Almacenaremos del blog que estamos construyendo sobre Python Anywhere. Crea una cuenta como "Principiante/Beginner" en Python Anywhere (el modo gratuito esta bien, no necesitas una tarjeta de crédito).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![La pagina de entrada de Python Anywhere muestra el botón para crear una cuenta "Principiante"](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Nota** Cuando elijas un nombre de usuario, recuerda que la URL de tu blog tendrá la forma `tunombredeusuario.pythonanywhere.com`, así que lo mejor será usar tu apodo o elegir un nombre que indique de qué trata tu blog. Asegúrate también de recordar tu contraseña (añádela a tu gestor de contraseñas, si usas uno).
+
+## Crear un token para la API de PythonAnywhere
+
+Este paso solo necesita ser completado una vez. Una vez que te hayas registrado en PythonAnywhere, serás llevado a tu tablón principal. Encontrarás el enlace a la página de tu "Cuenta" en la esquina superior derecha:
+
+![Enlace de cuenta en la parte superior derecha de la pagina](../deploy/images/pythonanywhere_account.png)
+
+Después selecciona la lengueta llamada "API token", y haz click en el botón que dice "Crear nueva API token"
+
+![Lengüeta de la API token en la pagina de cuenta](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/es-ES/django/README.md b/es-ES/django/README.md
new file mode 100644
index 00000000000..110fd6ec950
--- /dev/null
+++ b/es-ES/django/README.md
@@ -0,0 +1,27 @@
+# ¿Qué es Django?
+
+Django (*gdh/ˈdʒæŋɡoʊ/jang-goh*) es un framework de aplicaciones web gratuito y de código abierto (open source) escrito en Python. Un framework web es un conjunto de componentes que te ayudan a desarrollar sitios web más fácil y rápidamente.
+
+Cuando construyes un sitio web, siempre necesitas un conjunto de componentes similares: una manera de manejar la autenticación de usuarios (registrarse, iniciar sesión, cerrar sesión), un panel de administración para tu sitio web, formularios, una forma de subir archivos, etc.
+
+Por suerte para nosotros, hace tiempo que otros desarrolladores se dieron cuenta de que siempre se enfrentaban a los mismos problemas cuando construían sitios web, y por eso se unieron y crearon frameworks (Django es uno de ellos) con componentes listos para usarse.
+
+Los frameworks sirven para que no tengamos que reinventar la rueda cada vez y que podamos avanzar más rápido al construir un nuevo sitio.
+
+## ¿Por qué necesitas un framework?
+
+Para entender para que sirve realmente Django, necesitamos fijarnos en cómo funcionan los servidores. Lo primero es que el servidor necesita enterarse de que tu quieres que te sirva una página web.
+
+Imagina un buzón (puerto) en el que alguien está constantemente mirando si hay cartas entrantes (peticiones). Esto es lo que hace un servidor web. El servidor web lee la carta, y envía una respuesta con la página web. Pero para enviar algo, tenemos que tener algún contenido. Y Django nos ayuda a crear ese contenido.
+
+## ¿Qué sucede cuando alguien solicita una página web de tu servidor?
+
+Cuando llega una petición a un servidor web, es pasada a Django quien intenta averiguar que es realmente solicitado. Toma primero una dirección de página web e intenta averiguar qué hacer. Esta parte es realizada por el **urlresolver** de Django (ten en cuenta que la dirección de un sitio web es llamada URL - Uniform Resource Locator; así que el nombre *urlresolver* tiene sentido). Este no es muy inteligente - toma una lista de patrones y trata de hacer coincidir la URL. Django comprueba los patrones de arriba hacia abajo y si algo coincide entonces Django le pasa la solicitud a la función asociada (que se llama *view (vista)*).
+
+Imagina a un cartero llevando una carta. Él está caminando por la calle y comprueba cada número de casa con el que está en la carta. Si coincide, deja la carta allí. Así es como funciona el urlresolver!
+
+En la función de *view (vista)* se hacen todas las cosas interesantes: podemos mirar a una base de datos para buscar alguna información. ¿Tal vez el usuario pidió cambiar algo en los datos? Como una carta diciendo "Por favor cambia la descripción de mi trabajo." La *vista* puede comprobar si tienes permiso para hacerlo, actualizar la descripción de tu trabajo y devolver un mensaje: "¡Hecho!". Luego la *vista* genera una respuesta y Django puede enviarla al navegador del usuario.
+
+Esta descripción es un poco simplista, pero de momento no necesitas saber todos los detalles técnicos, con tener una idea general es más que suficiente.
+
+Así que en lugar de detenernos demasiado en los detalles, vamos a empezar a crear algo con Django y ¡así aprenderemos las cosas importantes sobre la marcha!
\ No newline at end of file
diff --git a/es-ES/django_admin/README.md b/es-ES/django_admin/README.md
new file mode 100644
index 00000000000..ff8a68dfb8c
--- /dev/null
+++ b/es-ES/django_admin/README.md
@@ -0,0 +1,57 @@
+# Administrador de Django
+
+Para agragar, editar y borrar los posts que hemos modelado, usaremos el administrador (admin) de Django.
+
+Abre el fichero `blog/admin.py` en el editor y reemplaza su contenido con esto:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Como puedes ver, importamos (incluimos) el modelo Post definido en el capítulo anterior. Para hacer nuestro modelo visible en la página del administrador, tenemos que registrar el modelo con `admin.site.register(Post)`.
+
+Ok, es hora de ver nuestro modelo Post. Recuerda ejecutar `python manage.py runserver` en la consola para correr el servidor web. Ve a tu navegador y escribe la dirección http://127.0.0.1:8000/admin/. Veras una página de inicio de sesión como esta:
+
+![Página de inicio de sesión](images/login_page2.png)
+
+Para iniciar sesión, deberás crear un *superusuario (superuser)*, que es un usuario que tiene control sobre todo el sitio. Vuelve a la línea de comandos, escribe `python manage.py createsuperuser` y pulsa enter.
+
+> Recuerda, para escribir comandos mientras el servidor web esta funcionando, abre una nueva terminal y activa el virtualenv. Revisamos como escribir nuevos comandos en el capitulo **Tu primer proyecto de Django!**, al inicio de la sección **Iniciando el servidor web**.
+
+{% filename %}Mac OS X o Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Cuando te lo pida, escribe tu nombre de usuario (en minúscula, sin espacios), email y contraseña. **No te preocupes si no puedes ver la password que estás tecleando - así es como debe ser.** Tecléalo y pulsa `intro` para continuar. Luego, verás algo así (Donde username y email serán los que escribiste anteriormente):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Vuelve a tu navegador. Entra con las credenciales de super usuario que tu escogiste; verás el panel de administrador de Django.
+
+![Administrador de Django](images/django_admin3.png)
+
+Ve a 'Posts' y curiosea un poco. Añade cinco o seis publicaciones en tu blog. No te preocupes por el contenido -- solo será visible para tí en tu ordenador -- puedes copiar y pegar texto de este tutorial para ir más rápido. :)
+
+Asegúrate de que al menos dos o tres posts (pero no todos) tengan la fecha de publicación definida. Esto será muy poderoso después.
+
+![Administrador de Django](images/edit_post3.png)
+
+Si desea saber más sobre el administrador de Django, debe consultar la documentación de Django: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Este posiblemente sea un buen momento para tomar un café (o te) o algo para comer y re energizar tu cuerpo. Has creado tu primer modelo en Django - ¡Mereces un pequeño descanso!
\ No newline at end of file
diff --git a/es-ES/django_forms/README.md b/es-ES/django_forms/README.md
new file mode 100644
index 00000000000..7a7057981a3
--- /dev/null
+++ b/es-ES/django_forms/README.md
@@ -0,0 +1,479 @@
+# Formularios de Django
+
+Lo último que haremos en nuestro sitio web será crear una forma agradable de agregar y editar posts en el blog. El `admin` de Django está bien, pero es bastante difícil de personalizar y hacerlo bonito. Con `forms` tendremos un poder absoluto sobre nuestra interfaz; ¡podemos hacer casi cualquier cosa que podamos imaginar!
+
+Lo bueno de los formularios de Django es que podemos definirlos desde cero o crear un `ModelForm`, el cual guardará el resultado del formulario en el modelo.
+
+Esto es exactamente lo que queremos hacer: crearemos un formulario para nuestro modelo `Post`.
+
+Como cada parte importante de Django, los formularios tienen su propio archivo: `forms.py`.
+
+Necesitamos crear un archivo con este nombre en el directorio `blog`.
+
+    blog
+       └── forms.py
+    
+
+Vale, ábrelo en el editor de código y teclea lo siguiente:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Lo primero, necesitamos importar Django forms (`from django import forms`) y nuestro modelo `Post` (`from .models import Post`).
+
+`PostForm`, como probablemente sospechas, es el nombre de nuestro formulario. Necesitamos decirle a Django que este formulario es un `ModelForm` (así Django hará algo de magia por nosotros) - `forms.ModelForm` es responsable de ello.
+
+Luego, tenemos `class Meta`, donde le decimos a Django que modelo debe ser utilizado para crear este formulario (`model = Post`).
+
+Finalmente, podemos decir que campo(s) deberían estar en nuestro formulario. En este escenario sólo queremos `title` y `text` para ser mostrados - `author` será la persona que esta conectada (¡tú!) y `created_date` se definirá automáticamente cuando creemos un post (es decir, en el código), ¿cierto?
+
+¡Y eso es todo! Todo lo que necesitamos hacer ahora es usar el formulario en una *view* y mostrarla en una plantilla.
+
+Una vez más vamos a crear: un enlace a la página, una dirección URL, una vista y una plantilla.
+
+## Enlace a una página con el formulario
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## Vista post_new
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Plantilla
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* Tenemos que mostrar el formulario. Podemos hacerlo, por ejemplo, con un sencillo {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Necesitamos un botón `Guardar`. Lo hacemos con un botón HTML: `<button type='submit'>Save</button>`.
+* Finalmente justo después de abrir la etiqueta `<form ...>` tenemos que añadir {% raw %}`{% csrf_token %}`{% endraw %}. ¡Esto es muy importante ya que hace que tus formularios sean seguros! Si olvidas este pedazo, Django se molestará cuando intentes guardar el formulario:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Guardar el formulario
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Validación de formularios
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Editar formulario
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Botón "Editar"](images/edit_button2.png)
+
+Cuando hagas clic en él, verás el formulario con nuestra publicación de blog:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Seguridad
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Una cosa más: ¡Tiempo de despliegue!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* Lo primero, haz commit de tus últimos cambios y súbelo (push) a GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Luego, en una [consola Bash de PythonAnywhere](https://www.pythonanywhere.com/consoles/)
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Para terminar ve a ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (usa el botón del menú de la esquina superior derecha, encima de la consola) y haz click en **Reload**. Recarga tu https://subdomain.pythonanywhere.com blog para ver los cambios.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/es-ES/django_installation/README.md b/es-ES/django_installation/README.md
new file mode 100644
index 00000000000..5e540787896
--- /dev/null
+++ b/es-ES/django_installation/README.md
@@ -0,0 +1,7 @@
+# Instalacion de Django
+
+> **Nota** Si usas un Chromebook, omite este capítulo y asegúrate de seguir las instrucciones de [Chromebook Setup](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/es-ES/django_installation/instructions.md b/es-ES/django_installation/instructions.md
new file mode 100644
index 00000000000..e4de5cd18ee
--- /dev/null
+++ b/es-ES/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Parte de esta sección está basada en tutoriales por Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parte de este capítulo está basada en el [django-marcador tutorial](http://django-marcador.keimlink.de/) bajo la licencia Creative Commons Attribution-ShareAlike 4.0 internacional. El tutorial de django-marcador tiene derechos de autor de Markus Zapke-Gündemann et al.
+
+## Entorno virtual
+
+Antes de instalar Django, instalaremos una herramienta extremadamente útil que ayudará a mantener tu entorno de desarrollo ordenado en tu computadora. Es posible saltarse este paso, pero es altamente recomendable. ¡Empezar con la mejor configuración posible te ahorrará muchos problemas en el futuro!
+
+Así que, vamos a crear un **entorno virtual** (también llamado un *virtualenv*). Virtualenv aísla tu configuración de Python/Django por cada proyecto. Esto quiere decir que cualquier cambio que hagas en un sitio web no afectará a ningún otro que estés desarrollando. Genial, ¿no?
+
+Todo lo que necesitas hacer es encontrar un directorio en el que quieras crear el `virtualenv`; tu directorio home, por ejemplo. En Windows, puede verse como `C:\Users\Name` (donde `Name` es el nombre de tu usuario).
+
+> **NOTA:** En Windows, asegúrate de que este directorio no contiene caracteres especiales o acentuados; si tu nombre de usuario contiene caracteres acentuados, usa un directorio distinto, por ejemplo `C:\djangogirls`.
+
+Para este tutorial usaremos un nuevo directorio `djangogirls` en tu directorio home:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Haremos un virtualenv llamado `myvenv`. El comando general estará en el formato:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Para crear un nuevo `virtualenv`, necesitas abrir una terminal "command prompt" y ejecutar `python -m venv myvenv`. Se verá así:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Donde `myvenv` es el nombre de tu `virtualenv`. Puedes utilizar cualquier otro nombre, pero asegúrate de usar minúsculas y no usar espacios, acentos o caracteres especiales. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Podemos crear un `virtualenv` en Linux y OS X, es tan sencillo como ejecutar `python3 -m venv myvenv`. Se verá así:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` es el nombre de tu `virtualenv`. Puedes usar cualquier otro nombre, pero sólo utiliza minúsculas y no incluyas espacios. También es una buena idea mantener el nombre corto. ¡Vas a referirte muchas veces a él!
+
+> **NOTA:** En algunas versiones de Debian/Ubuntu, puede que obtengas el siguiente error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  En sistemas Debian/Ubuntu, tendrás que instalar el paquete python3-venv usando el siguiente comando.
+>        apt-get install python3-venv
+>     Puede que tengas que usar sudo con este comando.  Después de instalar el paquete python3-venv, vuelve a crear tu entorno virtual.
+>     
+> 
+> En este caso, sigue las instrucciones anteriores e instala el paquete `python3-venv`: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTA:** En algunas versiones de Debian/Ubuntu inicializar el entorno virtual de esta manera da el siguiente error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Para evitar esto, utiliza directamente el comando `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTA:** Si obtienes un error como
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> entonces ejecuta:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Trabajar con virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Inicia el entorno virtual ejecutando:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. En este caso, abre otro Windows PowerShell con la opción "Ejecutar como administrador". Luego intenta escribir el siguiente comando antes de inicializar tu entorno virtual:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32 > Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>        Execution Policy Change
+>        The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> La ventaja es que tu no tienes que cambiar las ventanas entre el editor de código y la línea de comandos
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Inicia el entorno virtual ejecutando:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+¡Recuerda reemplazar `myvenv` con tu nombre de `virtualenv` que hayas elegido!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+Sabrás que tienes `virtualenv` iniciado cuando veas que la línea de comando en tu consola tiene el prefijo `(myvenv)`.
+
+Cuando trabajes en un entorno virtual, `python` automáticamente se referirá a la versión correcta, de modo que puedes utilizar `python` en vez de `python3`.
+
+Ok, tenemos todas las dependencias importantes en su lugar. ¡Finalmente podemos instalar Django!
+
+## Instalar Django {#django}
+
+Ahora que tienes tu `virtualenv` iniciado, puedes instalar Django.
+
+Antes de hacer eso, debemos asegurarnos que tenemos la última versión de `pip`, el software que utilizamos para instalar Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Instalar paquetes con un fichero de requisitos (requirements)
+
+Un fichero de requisitos (requirements) tiene una lista de dependencias que se deben instalar mediante `pip install`:
+
+Primero crea un archivo `requirements.txt` dentro de tu directorio `djangogirls`, usando el editor de código que instalaste previamente. Lo puedes hacer mediante abriendo un nuevo archivo en el editor de código y guardandolo como `requirements.txt` en el directorio `djangogirls`. Tu directorio se verá así:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+Dentro del fichero `djangogirls/requirements.txt` deberías tener el siguiente texto:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Ahora, ejecuta `pip install -r requirements.txt` para instalar Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). Si los tiene, por favor considera usar otro lugar sin espacios, acentos o caracteres especiales (sugerencia: `C:\djangogirls`). Crea un nuevo virtualenv en el nuevo directorio, luego borra el viejo y trata de escribir el comando anterior otra vez. (Moviendo el directorio virtualenv no funcionará debido a que usa rutas absolutas.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> Si tu obtienes un error cuando llamas pip en Ubuntu 12.04, por favor corre `python -m pip install -U --force-reinstall pip` para reparar la instalación de pip en el virtualenv.
+
+<!--endsec-->
+
+¡Eso es todo! Ahora estás lista (por fin) para crear una aplicación Django!
\ No newline at end of file
diff --git a/es-ES/django_models/README.md b/es-ES/django_models/README.md
new file mode 100644
index 00000000000..3280cc34823
--- /dev/null
+++ b/es-ES/django_models/README.md
@@ -0,0 +1,203 @@
+# Modelos en Django
+
+Lo que queremos crear ahora es algo que almacene todas las entradas de nuestro blog. Pero para poder hacerlo tenemos que hablar un poco sobre algo llamado `objetos`.
+
+## Objetos
+
+Hay un concepto en el mundo de la programación llamado `programación orientada a objetos`. La idea es que en lugar de escribir todo como una aburrida secuencia de instrucciones de programación podemos modelar cosas y definir cómo interactúan entre ellas.
+
+Entonces, ¿qué es un objeto? Es un conjunto de propiedades y acciones. Suena raro, pero te daremos un ejemplo.
+
+Si queremos modelar un gato crearemos un objeto `Gato` que tiene algunas propiedades como: `color`, `edad`, `temperamento` (como bueno, malo, o dormilón ;)), y `dueño` (este es un objeto `Persona` o en caso de un gato callejero, esta propiedad está vacía).
+
+Luego, el `Gato` tiene algunas acciones como: `ronronear`, `arañar` o `alimentar` (en cuyo caso daremos al gato algo de `ComidaDeGato`, el cual debería ser un objeto aparte con propiedades como `sabor`).
+
+    Gato
+    ---------
+    color
+    edad
+    humor
+    dueño
+    ronronear()
+    rasguñar()
+    alimentarse(comida_de_gato)
+    
+    
+
+    ComidaDeGato
+    --------
+    sabor
+    
+
+Básicamente se trata de describir cosas reales en el código con propiedades (llamadas `propiedades del objeto`) y las acciones (llamadas `métodos`).
+
+Y ahora, ¿cómo modelamos las entradas en el blog? Queremos construir un blog, ¿no?
+
+Necesitamos responder a la pregunta: ¿Qué es una entrada de un blog? ¿Qué propiedades debería tener?
+
+Bueno, seguro que nuestras entradas de blog necesitan un texto con su contenido y un título, ¿cierto? También sería bueno saber quién lo escribió, así que necesitamos un autor. Por último, queremos saber cuándo se creó y publicó la entrada.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+¿Qué tipo de cosas podría hacerse con una entrada del blog? Sería bueno tener algún `método` que publique la entrada, ¿no?
+
+Así que vamos a necesitar el método `publicar`.
+
+Puesto que ya sabemos lo que queremos lograr, ¡podemos empezar a modelarlo en Django!
+
+## Modelos en Django
+
+Sabiendo qué es un objeto, podemos crear un modelo en Django para nuestros entradas de blog.
+
+Un modelo en Django es un tipo especial de objeto que se guarda en la `base de datos`. Una base de datos es una colección de datos. Es un lugar en el cual almacenarás la información sobre usuarios, tus entradas de blog, etc. Utilizaremos una base de datos SQLite para almacenar nuestros datos. Este es el adaptador de base de datos predeterminado en Django -- será suficiente para nosotros por ahora.
+
+Puedes pensar el modelo en la base de datos, como una hoja de cálculo con columnas (campos) y filas (datos).
+
+### Crear una aplicación
+
+Para mantener todo en orden, crearemos una aplicación separada dentro de nuestro proyecto. Es muy bueno tener todo organizado desde el principio. Para crear una aplicación, necesitamos ejecutar el siguiente comando en la consola (dentro de la carpeta de `djangogirls` donde está el archivo `manage.py`):
+
+{% filename %}Mac OS X y Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Notarás que se ha creado un nuevo directorio `blog` y ahora contiene una cantidad de archivos. Los directorios y archivos en nuestro proyecto deberían verse así:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+Después de crear una aplicación, también necesitamos decirle a Django que debe utilizarla. Eso se hace en el fichero `mysite/settings.py` -- ábrelo en el editor. Tenemos que encontrar `INSTALLED_APPS` y agregar una línea que contiene `'blog.apps.BlogConfig',` justo por encima de `]`. El producto final debe tener este aspecto:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Crear el modelo del Post
+
+En el archivo `blog/models.py` definimos todos los objetos llamados `Models`. Este es un lugar en el cual definiremos nuestra entrada del blog.
+
+Abre `blog/models.py` en el editor, borra todo, y escribe código como este:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User', on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Comprueba nuevamente que usas dos guiones bajos (`_`) en cada lado de `str`. Esta convención se usa en Python con mucha frecuencia y a veces también se llaman "dunder" (abreviatura de "double-underscore" o, en español, "doble guión bajo").
+
+Da un poco de miedo, ¿no? Pero no te preocupes, ¡vamos a explicar qué significan estas líneas!
+
+Todas las líneas que comienzan con `from` o `import` son líneas para agregar algo de otros archivos. Así que en vez de copiar y pegar las mismas cosas en cada archivo, podemos incluir algunas partes con `from... import ...`.
+
+`class Post(models.Model):`, esta línea define nuestro modelo (es un `objeto`).
+
+- `class` es una palabra clave que indica que estamos definiendo un objeto.
+- `Post` es el nombre de nuestro modelo. Podemos darle un nombre diferente (pero debemos evitar espacios en blanco y caracteres especiales). Siempre inicia el nombre de una clase con una letra mayúscula.
+- `models.Model` significa que Post es un modelo de Django, así Django sabe que debe guardarlo en la base de datos.
+
+Ahora definimos las propiedades de las que hablábamos: `title`, `text`, `created_date`, `published_date` y `author`. Para ello tenemos que definir el tipo de cada campo (¿es texto? ¿un número? ¿una fecha? ¿una relación con otro objeto como un User (usuario)?)
+
+- `models.CharField`, así es como defines un texto con un número limitado de caracteres.
+- `models.TextField`, este es para texto largo sin límite. Suena perfecto para el contenido de la entrada del blog, ¿no?
+- `models.DateTimeField`, este es fecha y hora.
+- `modelos.ForeignKey`, este es una relación (link) con otro modelo.
+
+No vamos a explicar aquí cada pedacito de código porque nos tomaría demasiado tiempo. Debería echar un vistazo a la documentación de Django si desea obtener más información sobre los campos Modelo y cómo definir otras cosas distintas a las descritas anteriormente (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+¿Y qué sobre `def publish(self):`? Es exactamente el método `publish` que mencionábamos antes. `def` significa que es una función/método y `publish` es el nombre del método. Puedes cambiar el nombre del método, si quieres. La regla de nomenclatura es utilizar minúsculas y guiones bajos en lugar de espacios. Por ejemplo, un método que calcule el precio medio se podría llamar `calcular_precio_medio`.
+
+Los métodos suelen devolver (`return`, en inglés) algo. Hay un ejemplo de esto en el método `__str__`. En este escenario, cuando llamemos a `__str__()` obtendremos un texto (**string**) con un título de Post.
+
+También, nota que ambos `def publish(self):`, y `def __str__(self):` son indentados dentro de nuestra clase. Porque Python es sensible a los espacios en blancos, necesitamos indentar nuestros métodos dentro de la clase. De lo contrario, los métodos no pertenecen a la clase, y puedes obtener un comportamiento inesperado.
+
+Si algo todavía no está claro sobre modelos, ¡no dudes en preguntar a tu guía! Sabemos que es complicado, sobre todo cuando aprendes lo que son funciones y objetos al mismo tiempo. Pero con suerte, ¡todo tiene un poco más de sentido para ti ahora!
+
+### Crear tablas para los modelos en tu base de datos
+
+El último paso aquí es agregar nuestro nuevo modelo a la base de datos. Primero tenemos que hacer saber a Django que hemos hecho cambios en nuestro modelo. (Lo acabamos de crear!) Ve a tu terminal y escribe `python manage.py makemigrations blog`. Se verá así:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Nota:** Recuerda guardar los archivos que edites. De otro modo, tu computador ejecutara las versiones anteriores lo que puede ocasionar errores inesperados.
+
+Django preparó un archivo de migración que ahora tenemos que aplicar a nuestra base de datos. Escribe `python manage.py migrate blog` y el resultado debería ser:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+¡Hurra! ¡Nuestro modelo Post ya está en nuestra base de datos! Estaría bien verlo, ¿no? ¡Salta al siguiente capítulo para ver qué aspecto tiene tu Post!
\ No newline at end of file
diff --git a/es-ES/django_orm/README.md b/es-ES/django_orm/README.md
new file mode 100644
index 00000000000..431c4474201
--- /dev/null
+++ b/es-ES/django_orm/README.md
@@ -0,0 +1,221 @@
+# ORM de Django y QuerySets
+
+En este capítulo aprenderás cómo Django se conecta a la base de datos y almacena los datos en ella. ¡Vamos a sumergirnos!
+
+## ¿Qué es un QuerySet?
+
+Un QuerySet es, en esencia, una lista de objetos de un modelo determinado. Un QuerySet te permite leer los datos de la base de datos, filtrarlos y ordenarlos.
+
+Es más fácil de aprender con ejemplos. Vamos a intentarlo, ¿de acuerdo?
+
+## Django shell
+
+Abre tu consola local (no la de PythonAnywhere) y escribe este comando:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+El resultado debería ser:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Ahora estás en la consola interactiva de Django. Es como una consola de Python normal, pero con un poco de magia de Django. :) Aquí también se pueden usar todos los comandos de Python.
+
+### Todos los objetos
+
+Vamos a mostrar todos nuestros posts primero. Puedes hacerlo con el siguiente comando:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+¡Uy! Apareció un error. Nos dice que Post no existe. Esto es correcto, ¡olvidamos importarlo!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+Vamos a importar el modelo `Post` de `blog.models`. Y probamos de nuevo a mostrar todas las publicaciones (posts):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+¡Es la lista de posts que creamos anteriormente! Creamos estos posts usando la interfaz de administración de Django. Pero, ahora queremos crear nuevos posts usando Python, ¿cómo lo hacemos?
+
+### Crear objetos
+
+Esta es la forma de crear un nuevo objeto Post en la base de datos:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Pero nos falta un ingrediente aquí: `me`. Tenemos que pasar una instancia del modelo `User` como autor. ¿Eso cómo se hace?
+
+Primero importemos el modelo User:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+¿Qué usuarios tenemos en nuestra base de datos? Prueba esto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+¡Este es el superusuario que hemos creado antes! Ahora, vamos a obtener una instancia de éste usuario (cambia el código para usar tu propio nombre de usuario):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Como vés, ya hemos obtenido (`get`) un usuario (`User`) cuyo `username` es igual a 'ola'. ¡Mola!
+
+Ahora, finalmente, podemos crear nuestra entrada:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+¡Hurra! ¿Quieres probar si funcionó?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+¡Ahí está, una entrada de blog más en la lista!
+
+### Agrega más entradas
+
+Ahora puedes divertirte un poco y agregar más entradas para ver cómo funciona. Agrega dos o tres más y avanza a la siguiente parte.
+
+### Filtrar objetos
+
+Una parte importante de los QuerySets es la habilidad para filtrar los resultados. Digamos que queremos encontrar todos los post del usuario ola. Usaremos `filter` en vez de `all` en `Post.objects.all()`. Entre paréntesis estableceremos qué condición (o condiciones) debe cumplir un post del blog para aparecer como resultado en nuestro queryset. En nuestro caso sería `author` es igual a `me`. La forma de escribirlo en Django es: `author=me`. Ahora nuestro bloque de código tiene este aspecto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+¿O quizá queremos ver todas las entradas que contengan la palabra 'title' en el campo `title`?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Nota** Hay dos guiones bajos (`_`) entre `title` y `contains`. El ORM de Django utiliza esta sintaxis para separar los nombres de los campos ("title") de las operaciones o filtros ("contains"). Si sólo utilizas un guión bajo, obtendrás un error como "FieldError: Cannot resolve keyword title_contains".
+
+También puedes obtener una lista de todos los post publicados. Lo hacemos filtrando los post que tienen la fecha de publicación, `published_date`, en el pasado:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Por desgracia, el post que hemos añadido desde la consola de Python aún no está publicado. Pero lo podemos cambiar! Primero obtén una instancia de la entrada que queremos publicar:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+Y luego publícala con nuestro método `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Ahora vuelve a intentar obtener la lista de posts publicados (pulsa la tecla de "flecha arriba" tres veces y pulsa `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordenar objetos
+
+Los QuerySets también te permiten ordenar la lista de objetos. Intentemos ordenarlos por el campo `created_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+También podemos invertir el orden agregando `-` al principio:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Consultas complejas a través de encadenamiento de métodos
+
+Como ves, algunos métodos en `Post.objects` devuelven un QuerySet. Los mismos métodos pueden ser llamados también en un QuerySet, y entonces devolverán un nuevo QuerySet. También puedes combinar QuerySets **encadenando** uno con otro:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Es muy potente y te permite escribir consultas bastante complejas.
+
+¡Genial! ¡Ahora estás lista para la siguiente parte! Para cerrar la consola, escribe esto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/es-ES/django_start_project/README.md b/es-ES/django_start_project/README.md
new file mode 100644
index 00000000000..745e1af7ddb
--- /dev/null
+++ b/es-ES/django_start_project/README.md
@@ -0,0 +1,261 @@
+# ¡Tu primer proyecto en Django!
+
+> Parte de este capítulo se basa en tutoriales por Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parte de este capítulo está basado en el [ tutorial django-marcador](http://django-marcador.keimlink.de/) bajo licencia de Creative Commons Attribution-ShareAlike 4.0 internacional. El tutorial de django-marcador tiene derechos de autor de Markus Zapke-Gündemann et al.
+
+¡Vamos a crear un blog sencillo!
+
+El primer paso es iniciar un nuevo proyecto de Django. Básicamente, significa que vamos a lanzar unos scripts proporcionados por Django que nos crearán el esqueleto de un proyecto de Django. Son solo un montón de directorios y archivos que usaremos más tarde.
+
+Los nombres de algunos archivos y directorios son muy importantes para Django. No deberías renombrar los archivos que estamos a punto de crear. Moverlos a un lugar diferente tampoco es buena idea. Django necesita mantener una cierta estructura para poder encontrar cosas importantes.
+
+> Recuerda ejecutar todo en el virtualenv. Si no ves un prefijo `(myvenv)` en tu consola tienes que activar tu virtualenv. Explicamos cómo hacerlo en el capítulo de **Instalación de Django** en la sección **Trabajar con virtualenv**. Basta con escribir `myvenv\Scripts\activate` en Windows o `source myvenv/bin/activate` en Mac OS / Linux.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+En MacOS o Linux deberías ejecutar el siguiente comando en la consola. **no te olvides de añadir el punto `.` al final**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> El punto `.` es crucial porque le dice al script que instale Django en el directorio actual (para el cual el punto `.` sirve de abreviatura).
+> 
+> **Nota** Cuando escribas los comandos de arriba acuérdate de que sólo tienes que escribir la parte que empieza por `django-admin`. La parte de `(myvenv) ~/djangogirls$` que mostramos aquí es sólo un ejemplo del mensaje que aparecerá en tu línea de comandos.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+En Windows debes ejecutar el siguiente comando. **(No olvides incluir el punto `.` al final)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> El punto `.` es crucial porque le dice al script que instale Django en el directorio actual (para el cual el punto `.` sirve de abreviatura).
+> 
+> **Nota** Cuando teclees los comandos de arriba, recuerda que sólo tienes que escribir la parte que empieza por `django-admin.exe`. La parte de `(myvenv) C:\Users\Name\djangogirls>` que mostramos aquí es sólo un ejemplo del mensaje que aparecerá en tu línea de comandos.
+
+<!--endsec-->
+
+`django-admin.py` es un script que creará los archivos y directorios para ti. Ahora deberías tener una estructura de directorios parecida a esta:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Nota**: en tu estructura de directorios, también verás el directorio `venv` que creamos anteriormente.
+
+`manage.py` es un script que ayuda con la administración del sitio. Con él podremos iniciar un servidor web en nuestro ordenador sin necesidad de instalar nada más, entre otras cosas.
+
+El archivo `settings.py` contiene la configuración de tu sitio web.
+
+Recuerdas cuando hablamos de una cartera que debía comprobar dónde entregar una carta? El archivo `urls.py` contiene una lista de los patrones utilizados por `urlresolver`.
+
+Por ahora vamos a ignorar el resto de archivos porque no los vamos a cambiar. ¡Sólo acuérdate de no borrarlos accidentalmente!
+
+## Cambiar la configuración
+
+Vamos a hacer algunos cambios en `mysite/settings.py`. Abre el archivo usando el editor de código que has instalado anteriormente.
+
+**Nota**: Ten en cuenta que `settings.py` es un archivo normal, como cualquier otro. Puedes abrirlo con el editor de texto, usando "file -> open" en el menu de acciones. Esto te debería llevar a la típica ventana donde puedes buscar el archivo `settings.py` y seleccionarlo. Como alternativa, puedes abrir el archivo haciendo click derecho en la carpeta djangogirls en tu escritorio. Luego, selecciona tu editor de texto en la lista. Elegir el editor es importante puesto que puede que tengas otros programas que pueden abrir el archivo pero que no te dejaran editarlo.
+
+Sería bueno tener el horario correcto en nuestro sitio web. Ve a [lista de Wikipedia de las zonas horarias](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) y copia tu zona horaria (TZ) (e.g. `Europa/Berlín`).
+
+En `settings.py`, encuentra la línea que contiene `TIME_ZONE` y modifícala para elegir tu zona horaria. Por ejemplo:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+Un código de idioma tiene dos partes: el idioma, p.ej. `en` para inglés o `de` para alemán, y el código de país, p.ej. `de` para Alemania o `ch` para Suiza. Si tu idioma nativo no es el inglés, puedes añadir lo siguiente para cambiar el idioma de los botones y notificaciones de Django. Así tendrás el botón "Cancel" traducido al idioma que pongas aquí. [Django viene con muchas traducciones preparadas](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+Si quieres un idioma diferente, cambia el código de idioma cambiando la siguiente línea:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'es-es'
+```
+
+También tenemos que añadir una ruta para archivos estáticos. (Veremos todo acerca de archivos estáticos y CSS más adelante.) Ve al *final* del archivo, y justo debajo de la entrada `STATIC_URL`, añade una nueva llamada `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Cuando `DEBUG` es `True` y `ALLOWED_HOST` esta vacío, el host es validado contra `['localhost', '127,0.0.1', '[::1]']`. Una vez despleguemos nuestra aplicación este no sera el mismo que nuestro nombre de host en PythonAnywhere asi que cambiaremos la siguiente opción:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Nota**: si estas usando un Chromebook, añade esta linea al final del archivo settings.py: `MESSAGE_STORAGE =
+'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Añade también `.c9users.io` a `ALLOWED_HOSTS` si estás usando cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Configurar una base de datos
+
+Hay una gran variedad de opciones de bases de datos para almacenar los datos de tu sitio. Utilizaremos la que viene por defecto, `sqlite3`.
+
+Esta ya está configurado en esta parte de tu archivo `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Para crear una base de datos para nuestro blog, ejecutemos lo siguiente en la consola: `python manage.py migrate` (necesitamos estar en el directorio de `djangogirls` que contiene el archivo `manage.py`). Si eso va bien, deberías ver algo así:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+Y, ¡terminamos! Es hora de iniciar el servidor web y ver si está funcionando nuestro sitio web!
+
+## Iniciar el servidor
+
+Debes estar en el directorio que contiene el archivo `manage.py` (en la carpeta `djangogirls`). En la consola, podemos iniciar el servidor web ejecutando `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Si estas usando un Chromebook, utiliza este comando:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![¡La instalación ha funcionado!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> Miramos como funcionan los servidores web en el capítulo **Cómo funciona el internet**.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/es-ES/django_templates/README.md b/es-ES/django_templates/README.md
new file mode 100644
index 00000000000..51032f4e55a
--- /dev/null
+++ b/es-ES/django_templates/README.md
@@ -0,0 +1,106 @@
+# Plantillas de Django
+
+¡Es hora de mostrar algunos datos! Para ello Django incorpora unas etiquetas de plantillas, **template tags**, muy útiles.
+
+## ¿Qué son las etiquetas de plantilla?
+
+Verás, en HTML no se puede escribir código en Python porque los navegadores no lo entienden. Sólo saben HTML. Sabemos que HTML es bastante estático, mientras que Python es mucho más dinámico.
+
+Las **etiquetas de plantilla de Django** nos permiten insertar elementos de Python dentro del HTML, para que puedas construir sitios web dinámicos más rápida y fácilmente. ¡Genial!
+
+## Mostrar la plantilla lista de posts
+
+En el capítulo anterior le dimos a nuestra plantilla una lista de entradas en la variable `posts`. Ahora la vamos a mostrar en HTML.
+
+Para imprimir una variable en una plantilla de Django, utilizamos llaves dobles con el nombre de la variable dentro, algo así:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Prueba esto en la plantilla `blog/templates/blog/post_list.html`. Ábrela en el editor de código, y cambia todo desde el segundo `<div>` hasta el tercer `</div>` por `{{ posts }}`. Guarda el archivo y refresca la página para ver los resultados:
+
+![Figura 13.1](images/step1.png)
+
+Como puedes ver, lo que hemos conseguido es esto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>] >
+```
+
+Significa que Django lo entiende como una lista de objetos. ¿Recuerdas de **Introducción a Python** cómo podemos mostrar listas? Sí, ¡con bucles for! En una plantilla de Django se hacen así:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %} {{ post }}{% endfor %}
+```
+
+Prueba esto en tu plantilla.
+
+![Figura 13.2](images/step2.png)
+
+¡Funciona! Pero queremos que se muestren como los post estáticos que creamos anteriormente en el capítulo de **Introducción a HTML**. Usted puede mezclar HTML y etiquetas de plantilla. Nuestro `body` se verá así:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Todo lo que pongas entre `{% for %}` y `{% endfor %}` se repetirá para cada objeto de la lista. Refresca la página:{% endraw %}
+
+![Figura 13.3](images/step3.png)
+
+¿Has notado que utilizamos una notación diferente esta vez (`{{ post.title }}` o `{{ post.text }}`)? Estamos accediendo a los datos en cada uno de los campos definidos en nuestro modelo `Post`. También el `|linebreaksbr` está pasando el texto de los post a través de un filtro para convertir saltos de línea en párrafos.
+
+## Una cosa más
+
+Sería bueno ver si tu sitio web seguirá funcionando en la Internet pública, ¿no? Vamos a intentar desplegar de nuevo en PythonAnywhere. Aquí va un resumen de los pasos…
+
+* Lo primero, sube tu código a GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Luego, vuelve a entrar en [PythonAnywhere](https://www.pythonanywhere.com/consoles/) y ve a tu **consola Bash** (o inicia una nueva), y ejecuta:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Recuerda sustituir `<your-pythonanywhere-domain>` con tu subdominio de PythonAnywhere real, sin los paréntesis angulares.)
+
+* Y finalmente, dirígete a la [página "Web"](https://www.pythonanywhere.com/web_app_setup/) y haz click en **Reload** en tu aplicación web. (Para ir a otras páginas de PythonAnywhere desde la consola, haz click en el botón de la esquina superior derecha.) Los cambios deberían estar visibles en https://subdomain.pythonanywhere.com -- ¡compruébalo en en navegador! Si ves distintas publicaciones en el sitio en PythonAnywhere de las que tienes en tu servidor local, es lo normal. Tienes dos bases de datos, una en tu ordenador local y otra en PythonAnywhere y no tienen por qué tener el mismo contenido.
+
+¡Felicidades! Ahora intenta añadir un nuevo post en tu administrador de Django (recuerda añadir published_date!) Asegúrate de que estas en el administrador de Django de PytonAnywhere, https://tunombre.pythonanywhere.com/admin. Luego actualiza tu página para ver si los posts aparecen.
+
+¿Funciona de maravilla? ¡Estamos orgullosas! Aléjate un rato del ordenador, te has ganado un descanso. :)
+
+![Figura 13.4](images/donut.png)
\ No newline at end of file
diff --git a/es-ES/django_urls/README.md b/es-ES/django_urls/README.md
new file mode 100644
index 00000000000..c2e15fdb712
--- /dev/null
+++ b/es-ES/django_urls/README.md
@@ -0,0 +1,103 @@
+# URLs en Django
+
+Estamos a punto de construir nuestra primera página web: ¡una página de inicio para el blog! Pero primero, vamos a aprender un poco acerca de las urls en Django.
+
+## ¿Qué es una URL?
+
+Una URL es una dirección de la web. Puedes ver una URL cada vez que visitas una página. Se ve en la barra de direcciones del navegador. (Sí! ¡`127.0.0.1:8000` es una URL! Y `https://djangogirls.org` también es una URL.)
+
+![URL](images/url.png)
+
+Cada página en Internet necesita su propia URL. De esta manera tu aplicación sabe lo que debe mostrar a un usuario que abre una URL. En Django utilizamos algo que se llama `URLconf` (configuración de URL). URLconf es un conjunto de patrones que Django intentará comparar con la URL recibida para encontrar la vista correcta.
+
+## ¿Cómo funcionan las URLs en Django?
+
+Vamos a abrir el archivo `mysite/urls.py` en el editor de código de tu elección y veamos lo que tiene:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Como puedes ver, Django ya puso algo aquí por nosotros.
+
+Líneas entre triples comillas (`'''` o `"""`) son llamadas docstrings - puedes escribirlos en la parte superior de un archivo, clase o método para describir lo que hace. No serán ejecutadas por Python.
+
+La URL de admin, que hemos visitado en el capítulo anterior ya está aquí:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Esta linea dice que para cada URL que empieza con `admin/` Django encontrará su correspondiente *view*. En este caso estamos incluyendo muchas URLs admin así que no todo está empaquetado en este pequeño archivo. Es más limpio y legible.
+
+## ¡Tu primera URL de Django!
+
+¡Es hora de crear nuestra primera URL! Queremos que 'http://127.0.0.1:8000/' sea la página de inicio del blog y que muestre una lista de post.
+
+También queremos mantener limpio el archivo `mysite/urls.py`, así que vamos a importar las urls de nuestra aplicación `blog` en el archivo principal `mysite/urls.py`.
+
+Vamos, añade la línea para importar `blog.urls`. Tú también necesitarás cambiar la línea `desde django.urls...` porque estaremos usando la función `include` aquí, así que se necesitará añadir ese import a la línea.
+
+El archivo `mysite/urls.py` debería verse ahora así:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Ahora Django redirigirá todo lo que entre a 'http://127.0.0.1:8000/' hacia `blog.urls` y buscará más instrucciones allí.
+
+## blog.urls
+
+Crea un nuevo fichero vacío llamado `urls.py` el el directorio `blog`, y ábrelo en el editor de código. ¡Vale! Añade las dos primeras líneas:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Aquí estamos importando la función de Django `path` y todos nuestras `views` desde la aplicación `blog` (no tenemos una aun, pero veremos eso en un minuto!)
+
+Luego de esto, podemos agregar nuestro primer patrón URL:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+Como puedes ver, estamos asociando una vista (`view`) llamada `post_list` a la URL raíz. Este patrón de URL coincidirá con una cadena vacía y el solucionador de URL de Django ignorará el nombre de dominio (es decir, http://127.0.0.1:8000/) que prefija la ruta de URL completa. Este patrón le dirá a Django que `views.post_list` es el lugar correcto al que ir si alguien entra a tu sitio web con la dirección 'http://127.0.0.1:8000/'.
+
+La última parte `name='post_list'` es el nombre de la URL que se utilizará para identificar a la vista. Puede coincidir con el nombre de la vista pero también puede ser algo completamente distinto. Utilizaremos las URL con nombre más delante en el proyecto así que es importante darle un nombre a cada URL de la aplicación. También deberíamos intentar mantener los nombres de las URL únicos y fáciles de recordar.
+
+Si tratas de visitar http://127.0.0.1:8000/ ahora, encontrarás un mensaje de error 'web page not available' a algo así. Esto es porque el servidor (¿recuerdas que escribimos `runserver`?) ya no está funcionando. Mira la ventana de la consola del servidor para saber por qué.
+
+![Error](images/error1.png)
+
+La consola esta mostrando un error, pero no te preocupes - de hecho es muy útil: está diciendote que **no existe el atributo 'post_list'**. Ese es el nombre del *view* que Django está tratando de encontrar y usar, pero aun no lo hemos creado. En esta etapa tu `/admin/` tampoco funcionará. No te preocupes, ya llegaremos a eso. Si ves un error diferente, intenta reiniciar el servidor web. Para hacerlo, en la ventana de la consola que ejecuta el servidor web, deténgalo presionando Ctrl+C (las teclas juntas Control y C). En Windows, es posible que deba presionar Ctrl+Break. Luego, debe reiniciar el servidor web ejecutando un comando `python manage.py runserver`.
+
+> Si quieres saber más sobre URLconfs de Django, mira la documentación oficial: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/es-ES/django_views/README.md b/es-ES/django_views/README.md
new file mode 100644
index 00000000000..505951e21b5
--- /dev/null
+++ b/es-ES/django_views/README.md
@@ -0,0 +1,44 @@
+# Vistas en Django - ¡Hora de crear!
+
+Es hora de deshacerse del error que hemos creado en el capítulo anterior! :)
+
+Una *View* es un lugar donde ponemos la "lógica" de nuestra aplicación. Pedirá información del `modelo` que has creado antes y se la pasará a la `plantilla`. Crearemos una plantilla en el próximo capítulo. Las vistas son sólo métodos de Python que son un poco más complicados que los que escribimos en el capítulo **Introducción a Python**.
+
+Las Vistas se colocan en el archivo `views.py`. Agregaremos nuestras *views* al archivo `blog/views.py`.
+
+## blog/views.py
+
+Vale, abre éste fichero en el editor y mira lo que hay en él:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+No hay demasiadas cosas aquí todavía.
+
+Recuerda que las lineas que comienzan con `#` son comentarios - significa que Python no las ejecutará.
+
+Creemos una *vista (view)* como sugiere el comentario. Añade la siguiente mini-vista por debajo:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Como puedes ver, hemos creado una función (`def`) llamada `post_list` que acepta `request` y `return` una función `render` que reproduce (construye) nuestra plantilla `blog/post_list.html`.
+
+Guarda el archivo, ve a http://127.0.0.1:8000/ y mira lo que hemos hecho.
+
+¡Otro error! Leamos lo que está pasando ahora:
+
+![Error](images/error.png)
+
+Esto demuestra que el servidor está funcionando otra vez, al menos, pero todavía no se ve bien, ¿No? No te preocupes, es sólo una página de error, ¡nada a que temer! Al igual que los mensajes de error en la consola, estos son realmente muy útiles. Puedes leer que la *TemplateDoesNotExist*. Vamos a corregir este error y crear una plantilla en el próximo capítulo!
+
+> Obtenga más información sobre las vistas de Django leyendo la documentación oficial: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/es-ES/dynamic_data_in_templates/README.md b/es-ES/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..cf1a91c6c84
--- /dev/null
+++ b/es-ES/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Datos dinámicos en plantillas
+
+Tenemos diferentes piezas en su lugar: el modelo `Post` está definido en `models.py`, tenemos a `post_list` en `views.py` y la plantilla agregada. ¿Pero cómo haremos realmente para que nuestros posts aparezcan en nuestra plantilla HTML? Porque eso es lo que queremos, tomar algún contenido (modelos guardados en la base de datos) y mostrarlo adecuadamente en nuestra plantilla, ¿no?
+
+Esto es exactamente lo que las *views* se supone que hacen: conectar modelos con plantillas. En nuestra *view* `post_list` necesitaremos tomar los modelos que deseamos mostrar y pasarlos a una plantilla. En una *vista* decidimos que (modelo) se mostrará en una plantilla.
+
+Muy bien, entonces ¿cómo lo logramos?
+
+Tenemos que abrir `blog/views.py` en el editor. De momento `post_list` *view* tiene esto:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+¿Recuerdas cuando hablamos de incluir código en diferentes archivos? Ahora tenemos que incluir el modelo que definimos en el archivo `models.py`. Agregaremos la línea `from .models import Post` de la siguiente forma:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+El punto antes de `models` indica el *directorio actual* o la *aplicación actual*. Ambos, `views.py` y `models.py` están en el mismo directorio. Esto significa que podemos utilizar `.` y el nombre del archivo (sin `.py`). Ahora importamos el nombre del modelo (`Post`).
+
+¿Pero ahora qué sigue? Para tomar posts reales del modelo `Post`, necesitamos algo llamado `QuerySet`.
+
+## QuerySet
+
+Ya debes estar familiarizada con la forma en que funcionan los QuerySets. Hablamos de ellos en el capítulo [Django ORM (QuerySets)](../django_orm/README.md).
+
+Así que ahora nos interesa tener una lista de post publicados ordenados por `published_date` (fecha de publicación), ¿no? ¡Ya lo hicimos en el capítulo QuerySets!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Abre `blog/views.py` en el editor, y añade este trozo de código a la función `def post_list(request)` -- pero no te olvides de añadir `from django.utils import timezone` antes:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+Para mostrar nuestro QuerySet en nuestra lista de posts, nos quedan dos cosas que hacer:
+
+1. Pasar el QuerySet de `posts` al contexto de la plantilla, cambiando la llamada a la función `render`.
+2. Modificar la plantilla para mostrar el QuerySet de `posts`. Llegaremos a eso más adelante en un próximo capítulo.
+
+Fíjate en que creamos una *variable* para el QuerySet: `posts`. Trátala como si fuera el nombre de nuestro QuerySet. De aquí en adelante vamos a referirnos al QuerySet con ese nombre.
+
+En la función `render` tenemos el parámetro `request` (todo lo que recibimos del usuario via Internet) y otro parámetro dándole el archivo de la plantilla (`'blog/post_list.html'`). El último parámetro, que se ve así: `{}` es un lugar en el que podemos agregar algunas cosas para que la plantilla las use. Necesitamos nombrarlos (los seguiremos llamando `'posts'` por ahora). :) Se debería ver así: `{'posts': posts}`. Fíjate en que la parte antes de `:` es una cadena; tienes que envolverla con comillas: `"`.
+
+Finalmente nuestro archivo `blog/views.py` debería verse así:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+¡Terminamos! Ahora regresemos a nuestra plantilla y mostremos este QuerySet.
+
+¿Quieres leer un poco más sobre QuerySets en Django? Debería mirar aquí: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/es-ES/extend_your_application/README.md b/es-ES/extend_your_application/README.md
new file mode 100644
index 00000000000..5143617e802
--- /dev/null
+++ b/es-ES/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extiende tu aplicación
+
+Ya hemos completado todos los diferentes pasos necesarios para la creación de nuestro sitio web: sabemos cómo escribir un modelo, URL, vista y plantilla. También sabemos cómo hacer que nuestro sitio web sea bonito.
+
+¡Hora de practicar!
+
+Lo primero que necesitamos en nuestro blog es, obviamente, una página para mostrar un post, ¿cierto?
+
+Ya tenemos un modelo `Post`, así que no necesitamos añadir nada a `models.py`.
+
+## Crea un enlace a la página de detalle de una publicación
+
+Empezaremos añadiendo un enlace al fichero `blog/templates/blog/post_list.html`. Ábrelo en el editor; de momento debería tener este contenido: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}Queremos tener un link del titulo de una publicación en la lista de publicaciones al detalle de la misma. Cambiemos `<h2><a href="">{{ post.title }}</a></h2>` para enlazarla a la página detalle del post:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Es hora de explicar el misterioso`{% url 'post_detail' pk=post.pk %}`. Como probablemente sospeches, la notación `{% %}` significa que estamos utilizando Django template tags. ¡Esta vez usaremos uno que creará un URL para nosotros!{% endraw %}
+
+La parte de`post_detail` significa que Django estará esperando un URL en `blog/urls.py` con el nombre=post_detail
+
+¿Y ahora qué pasa con `pk=post.pk`? `pk` abrevia clave primaria (primary key), la cual es un identificador único para cada registro en una base de datos. Cada modelo de Django tiene un campo que sirve como clave primaria, y cualquier otro nombre que tiene, también se puede llamar "pk". Porque no especificamos una clave primaria en nuestro modelo `Post`, Django creará una por nosotros (por defecto, un campo llamado "id" con un número que se incrementará por cada registro, por ejemplo 1, 2, 3) y lo agregará como un campo en cada uno de nuestros posts. Accedemos a la clave primaria escribiendo `post.pk`, del mismo modo en que accedemos a otros campos (`title`, `author`, etc.) en nuestro objeto `Post`!
+
+Ahora cuando vayamos a: http://127.0.0.1:8000/ tendremos un error (como era de esperar, ya que no tenemos una URL o una *vista* para `post_detail`). Se verá así:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Crea una URL al detalle de una publicación
+
+Vamos a crear una URL en `urls.py` para nuestra *view* `post_detail`!
+
+Queremos que el detalle de la primera entrada se visualice en esta **URL**: http://127.0.0.1:8000/post/1/
+
+Vamos a crear una URL en el fichero `blog/urls.py` que dirija a Django hacia una *vista* llamada `post_detail`, que mostrará una entrada de blog completa. Abre el fichero `blog/urls.py` en el editor, y añade la línea `path('post/<int:pk>/', views.post_detail, name='post_detail'),` para que el fichero quede así:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+Esta parte `post/<int:pk>/` especifica un patrón de URL – ahora lo explicamos:
+
+- `post/` significa que la URL debería empezar con la palabra **post** seguida por una **/**. Hasta aquí bien.
+- `<int:pk>` – esta parte tiene más miga. Significa que Django buscará un número entero y se lo pasará a la vista en una variable llamada `pk`.
+- `/` – necesitamos otra **/** al final de la URL.
+
+Esto quiere decir que si pones `http://127.0.0.1:8000/post/5/` en tu navegador, Django entenderá que estás buscando una *vista* llamada `post_detail` y transferirá la información de que `pk` es igual a `5` a esa *vista*.
+
+OK, hemos añadido un nuevo patrón de URL a `blog/urls.py`! Actualizamos la pagina: http://127.0.0.1:8000/ y boom! El servidor vuelve a dejar de funcionar. Echa un vistazo a la consola – como era de esperar, hay otro error!
+
+![AttributeError](images/attribute_error2.png)
+
+¿Recuerdas cual es el próximo paso? ¡Añadir una vista!
+
+## Añade la vista de detalle de la publicación
+
+Esta vez nuestra *vista* tomará un parámetro adicional `pk`. Nuestra *vista* necesita recibirlo, ¿verdad? Así que definiremos nuestra función como `def post_detail (request, pk):`. Tenga en cuenta que este parametro debe tener exactamente el mismo nombre que el que especificamos en `urls` (`pk`). ¡También tenga en cuenta que omitir esta variable es incorrecto y resultará en un error!
+
+Ahora, queremos obtener solo un post. Para ello podemos usar querysets como este:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Pero este código tiene un problema. Si no hay ningún `Post` con esa `clave primaria` (`pk`), ¡tendremos un error muy feo!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+¡No queremos eso! Por suerte, Django tiene una función que se encarga de eso: `get_object_or_404`. En caso de que no haya ningún `Post` con el `pk` dado se mostrará una página mucho más agradable, `Page Not Found 404`.
+
+![Page not found](images/404_2.png)
+
+La buena noticia es que puedes crear tu propia página `Page Not Found` y diseñarla como desees. Pero por ahora no es tan importante, así que lo omitiremos.
+
+¡Es hora de agregar una *view* a nuestro archivo `views.py`!
+
+En `blog/urls.py` creamos un regla de URL denominada `post_detail` que hace referencia a una vista llamada `view.post_detail`. Esto significa que Django va a estar esperando una función llamada `post_detail` de vista en `blog/views.py`.
+
+Deberíamos abrir `blog/views.py` en el editor y añadir el siguiente código cerca de los otros import `from`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+Y al final del archivo agregamos nuestra *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Sí. Es hora de actualizar la página: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+¡Funcionó! Pero ¿qué pasa cuando haces click en un enlace en el título del post?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+¡Oh no! ¡Otro error! Pero ya sabemos cómo lidiar con eso, ¿no? ¡Tenemos que añadir una plantilla!
+
+## Crear una plantilla para post detail
+
+Vamos crear un fichero en `blog/templates/blog` llamado `post_detail.html`, y abrirlo en el editor de código.
+
+Introduzca el siguiente código:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Una vez más estamos extendiendo `base.html`. En el bloque `content` queremos mostrar la fecha de publicación (si existe), título y texto de nuestros posts. Pero deberíamos discutir algunas cosas importantes, ¿cierto?
+
+{% raw %}`{% if ... %} ... {% endif %}` es un template tag que podemos usar cuando querramos ver algo. (Recuerdas `if ... else ..` del capítulo **Intruducción a Python**?) Ahora queremos mirar si la `published_date` de un post no esta vacía.{% endraw %}
+
+Bien, podemos actualizar nuestra página y ver si `TemplateDoesNotExist` se ha ido.
+
+![Post detail page](images/post_detail2.png)
+
+¡Yay! ¡Funciona!
+
+# Hora de despliegue!
+
+Sería bueno verificar que tu sitio web aún funcionará en PythonAnywhere, ¿cierto? Intentemos desplegar de nuevo.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Luego, en una [consola Bash de PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Recuerda sustituir `<your-pythonanywhere-domain>` con tu subdominio de PythonAnywhere real, sin los paréntesis angulares.)
+
+## Actualizar los ficheros estáticos (static files) en el servidor
+
+Normalmente, los servidores como PythonAnywhere tratan los ficheros estáticos (como los ficheros CSS) de manera diferente a los ficheros de Python. Se llaman estáticos porque el servidor no debe ejecutarlos, sino servirlos tal cual. Y por ello se tratan por separado para servirlos más rápido. Como consecuencia, si cambiamos nuestros ficheros CSS, tenemos que ejecutar un comando extra en el servidor para decirle que los actualice. Este comando se llama `collectstatic`.
+
+Activa el virtualenv si no estaba activado de antes (en PythonAnywhere se usa el comando `workon`, es igual que el comando `source myenv/bin/activate` que usamos en local):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+El comando `manage.py collectstatic` es un poco como el comando `manage.py migrate`. Hacemos cambios en nuestro código y luego le decimos a Django que los *aplique*, bien a la colección de ficheros estáticos o bien a la base de datos.
+
+En cualquier caso, ahora estaremos listos para saltar sobre la [página "Web"](https://www.pythonanywhere.com/web_app_setup/) (desde el botón del menú en el lado superior derecho de la consola), realizar la **Recarga**, y mirar en la página https://subdomain.pythonanywhere.com para ver el resultado.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/es-ES/how_the_internet_works/README.md b/es-ES/how_the_internet_works/README.md
new file mode 100644
index 00000000000..b773953ae67
--- /dev/null
+++ b/es-ES/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# ¿Cómo funciona Internet?
+
+> Para lectores en casa: este capítulo está cubierto en el video [¿Cómo funciona Internet?](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> Este capitulo está inspirado en la charla "How the Internet works" de Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+Apostamos a que utilizas Internet todos los días. Pero, ¿sabes lo que pasa cuando escribes una dirección como http://djangogirls.org en tu navegador y presionas `enter`?
+
+La primera cosa que necesitas entender, es que una página web consiste de un puñado de archivos guardados en el disco duro -- como tus películas, música, o imágenes. Sin embargo, hay una parte que es única para los sitios web: ellos incluyen código computarizado llamado HTML.
+
+Si tu no estás familiarizado con la programación, puede ser difícil de comprender HTML a la primera, pero tus navegadores web (como Chrome, Safari, Firefox, etc.) lo aman. Los navegadores están diseñados para entender este código, seguir sus instrucciones y presentar estos archivos de los cuales está hecho tu sitio web, exactamente de la forma que quieres.
+
+Como cualquier otro archivo, tenemos que guardar los archivos HTML en algún lugar de un disco duro. Para Internet, utilizamos equipos especiales, de gran alcance llamados *servidores*. Estos no tienen una pantalla, ratón o teclado, debido a que su propósito es almacenar datos y servirlos. Por esa razón son llamados *servidores* -- porque *sirven* los datos.
+
+OK, pero quieres saber cómo Internet se ve, ¿cierto?
+
+¡Te hemos hecho una imagen! Luce algo así:
+
+![Figura 1.1](images/internet_1.png)
+
+Parece un lío, ¿no? De hecho, es una red de máquinas interconectadas (los *servidores* que nombramos anteriormente). ¡Cientos de miles de máquinas! ¡Muchos, muchos kilómetros de cables alrededor del mundo! Puedes visitar el sitio web Submarine Cable Map (http://submarinecablemap.com/) y ver lo complicada que es la red. Aquí hay una captura de pantalla de la página web:
+
+![Figura 1.2](images/internet_3.png)
+
+Es fascinante, ¿no? Pero sería imposible tener un cable entre todas y cada una de las máquinas conectadas a internet. Así que, para llegar a una máquina (por ejemplo la que aloja http://djangogirls.org) tenemos que elevar una solicitud mediante una gran cantidad de máquinas diferentes.
+
+Se parece a esto:
+
+![Figura 1.3](images/internet_2.png)
+
+Imagina que cuando escribes http://djangogirls.org, estas enviando una carta que dice: "Estimadas Django Girls, me gustaría ver su sitio web djangogirls.org. Por favor, envíenmelo!"
+
+Tu carta va hacia la oficina de correo más cercana. Luego va a otra que es un poco más cerca de su destinatario, luego otra y otra hasta que es entregada a su destino. La única cosa diferente es que si envías muchas cartas (*paquetes de datos*) al mismo lugar, cada una podría ir a través de oficinas de correos totalmente distintas (*routers*). Esto depende de cómo se distribuyen en cada oficina.
+
+![Figura 1.4](images/internet_4.png)
+
+Así es como funciona - se envían mensajes y se espera una respuesta. En lugar de papel y lápiz, se usan bytes de datos, pero ¡la idea es la misma!
+
+En lugar de direcciones con el nombre de la calle, ciudad, código postal y nombre del país, utilizamos direcciones IP. Tu computadora pide primero el DNS (Domain Name System - en español Sistema de Nombres de Dominio) para traducir djangogirls.org a una dirección IP. Funciona en cierta manera como los viejos directorios telefónicos donde puedes buscar el nombre de la persona que se deseas contactar y encontrar su número de teléfono y dirección.
+
+Cuando envías una carta, ésta necesita tener ciertas características para ser entregada correctamente: una dirección, sello, etc. También utilizas un lenguaje que el receptor pueda entender, ¿cierto? Lo mismo se aplica a los *paquetes de datos* que envía para ver un sitio Web. Utilizamos un protocolo llamado HTTP (Protocolo de transferencia de hipertexto).
+
+Así que, básicamente, cuando tienes un sitio web necesitas tener un *servidor* (la máquina) donde este vive. Cuando el *servidor* recibe una *petición* entrante (en una carta), este envía su sitio de Internet (en otra carta).
+
+Ya que este es un tutorial de Django, puede que te preguntes que lo que Django hace. Bueno, cuando envías una respuesta, no siempre quieres enviar lo mismo a todo el mundo. Es mucho mejor si tus cartas son personalizadas, especialmente para la persona que acaba de escribir, ¿cierto? Django nos ayuda con la creación de estas cartas personalizadas. :)
+
+Suficiente conversación - tiempo de crear!
\ No newline at end of file
diff --git a/es-ES/html/README.md b/es-ES/html/README.md
new file mode 100644
index 00000000000..03e17644fec
--- /dev/null
+++ b/es-ES/html/README.md
@@ -0,0 +1,227 @@
+# Introducción a HTML
+
+Te estarás preguntando, ¿qué es una plantilla?
+
+Una plantilla es un archivo que podemos reutilizar para presentar información diferente de forma consistente - por ejemplo, podrías utilizar una plantilla para ayudarte a escribir una carta, porque aunque cada carta puede contener un mensaje distinto y dirigirse a una persona diferente, compartirán el mismo formato.
+
+El formato de una plantilla de Django se describe en un lenguaje llamado HTML (el HTML que mencionamos en el primer capítulo **Cómo funciona Internet**).
+
+## ¿Qué es HTML?
+
+HTML es un código simple que es interpretado por tu navegador web - como Chrome, Firefox o Safari - para mostrar una página web al usuario.
+
+HTML significa HyperText Markup Language - en español, Lenguaje de Marcas de HyperTexto. **HyperText** -hipertexto en español- significa que es un tipo de texto que soporta hipervínculos entre páginas. **Markup** significa que hemos tomado un documento y lo hemos marcado con código para decirle a algo (en este caso, un navegador) cómo interpretar la página. El código HTML está construido con **etiquetas**, cada una comenzando con `<` y terminando con `>`. Estas etiquetas representan **elementos** de marcado.
+
+## ¡Tu primera plantilla!
+
+Crear una plantilla significa crear un archivo de plantilla. Todo es un archivo, ¿verdad? Probablemente hayas notado esto ya.
+
+Las plantillas se guardan en el directorio de `blog/templates/blog`. Así que primero crea un directorio llamado `templates` dentro de tu directorio blog. Luego crea otro directorio llamado `blog` dentro de tu directorio de templates:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(Tal vez te estés preguntando por qué necesitamos dos directorios llamados `blog` – como verás más adelante, es una convención de nombres que nos facilitará la vida cuando las cosas se pongan más complicadas.)
+
+Y ahora crea un archivo `post_list.html` (déjalo en blanco por ahora) dentro de la carpeta `blog/templates/blog`.
+
+Mira cómo se ve su sitio web ahora: http://127.0.0.1:8000/
+
+> Si todavía tienes un error `TemplateDoesNotExist`, intenta reiniciar tu servidor. Ve a la consola, para el servidor pulsando Ctrl+C (las teclas Control y C a la vez) y reinicialo ejecuntado el comando `python manage.py runserver`.
+
+![Figura 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Abre un fichero nuevo en el editor y escribe lo siguiente:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+Ahora, cómo luce tu sitio web? Haz click para ver: http://127.0.0.1:8000/
+
+![Figura 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Cabeza y cuerpo
+
+Cada página HTML también se divide en dos elementos: **head** y **body**.
+
+* **head** es un elemento que contiene información sobre el documento que no se muestra en la pantalla.
+
+* **body** es un elemento que contiene todo lo que se muestra como parte de la página web.
+
+Usamos `<head>` para decirle el navegador acerca de la configuración de la página y `<body>` para decir lo que realmente está en la página.
+
+Por ejemplo, puedes ponerle un título a la página web dentro de la `<head>`, así:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Guarda el archivo y actualiza tu página.
+
+![Figura 11.3](images/step4.png)
+
+¿Observas cómo el navegador ha comprendido que "Ola's blog" es el título de tu página? Ha interpretado `<title>Ola's blog</title>` y colocó el texto en la barra de título de tu navegador (también se utilizará para marcadores y así sucesivamente).
+
+Probablemente también hayas notado que cada etiqueta de apertura coincide con una *etiqueta de cierre*, con un `/`, y que los elementos son *anidados* (es decir, no puedes cerrar una etiqueta particular hasta que todos los que estaban en su interior se hayan cerrado también).
+
+Es como poner cosas en cajas. Tienes una caja grande, `<html></html>`; en su interior hay `<body></body>`, y que contiene las cajas aún más pequeñas: `<p></p>`.
+
+Tienes que seguir estas reglas de etiquetas de *cierre* y de *anidación* de elementos - si no lo haces, el navegador puede no ser capaz de interpretarlos apropiadamente y tu página se mostrará incorrectamente.
+
+## Personaliza tu plantilla
+
+¡Ahora puedes divertirte un poco y tratar de personalizar tu plantilla! Aquí hay algunas etiquetas útiles para eso:
+
+* `<h1>Un título</h1>` - para tu título más importante
+* `<h2>Un subtítulo</h2>` - para el título del siguiente nivel
+* `<h3>Un subsubtítulo</h3>` - ... y así hasta `<h6>`
+* `<p>Un párrafo de texto</p>`
+* `<em>texto</em>` - pone en cursiva tu texto
+* `<strong>texto</strong>` - pone en negrita tu texto
+* `<br>` va en otra línea (no puedes poner nada dentro de br y no hay etiqueta de cierre)
+* `<a href="https://djangogirls.org">link</a>` - crea un vínculo
+* `<ul><li>primer elemento</li><li>segundo elemento</li></ul>` - crea una lista, ¡igual que esta!
+* `<div></div>` - define una sección de la página
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Aca va un ejemplo de una plantilla completa, copialo y pegalo en `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Nos da este efecto:
+
+![Figura 11.4](images/step6.png)
+
+¡Yaaay! Pero hasta el momento, nuestra plantilla sólo muestra exactamente **la misma información** - considerando que antes hablábamos de plantillas como permitiéndonos mostrar información **diferente** en el **mismo formato**.
+
+Lo que queremos realmente es mostrar posts reales añadidos en nuestra página de administración de Django - y ahí es a donde vamos a continuación.
+
+## Una cosa más: ¡despliega!
+
+Sería bueno ver todo esto disponible en Internet, ¿no? Hagamos otro despliegue en PythonAnywhere:
+
+### Haz commit, y sube tu código a GitHub
+
+En primer lugar, vamos a ver qué archivos han cambiado desde la última puesta en marcha (ejecute estos comandos localmente, no en PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Asegúrate de que estás en el directorio `djangogirls` y vamos a decirle a `git` que incluya todos los cambios en este directorio:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Antes de que subamos todos los archivos, vamos a ver qué es lo que `git` subirá (todos los archivos que `git` cargará deberían aparecer en verde):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Ya casi estamos, ahora es tiempo de decirle que guarde este cambio en su historial. Vamos a darle un "mensaje de commit" donde describimos lo que hemos cambiado. Puedes escribir cualquier cosa que te gustaría en esta etapa, pero es útil escribir algo descriptivo para que puedes recordar lo que has hecho en el futuro.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Cambie el HTML para la página."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Una vez hecho esto, subimos (push) los cambios a Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Descarga tu nuevo código a PythonAnywhere y actualiza tu aplicación web
+
+* Abre la [página de consolas de PythonAnywhere](https://www.pythonanywhere.com/consoles/) y ve a tu **consola Bash** (o comienza una nueva). Luego, ejecuta:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+Tú necesitarás sustituir `<your-pythonanywhere-domain>` con tu actual nombre de subdominio PythonAnywhere, sin los paréntesis angulares o corchetes. Tu nombre de subdominio es normalmente tu nombre de usuario PythonAnywhere, pero en algunos casos ésto puede ser un poco diferente (tal como si tu nombre de usuario contiene letras mayúsculas). Así si éste comando no funciona, usa el comando `ls`(listar archivos) para encontrar tu actual subdominio/nombre-carpeta, y muévete allí con `cd `.
+
+Ahora mira cómo se descarga tu código. Si quieres comprobar que efectivamente ha llegado bien, puedes ir a la **página "Files"** y ver tu código en PythonAnywhere (puedes ir a otras páginas de PythonAnywhere desde el botón de la esquina superior derecha de la página de la consola).
+
+* Finalmente, ve a la [página "Web"](https://www.pythonanywhere.com/web_app_setup/) y pulsa **Reload** en tu aplicación web.
+
+¡Tu nueva versión ya debería estar publicada! Ve al navegador y refresca tu sitio web. Deberías ver los cambios. :)
\ No newline at end of file
diff --git a/es-ES/install_git.md b/es-ES/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/es-ES/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/es-ES/installation/README.md b/es-ES/installation/README.md
new file mode 100644
index 00000000000..17bf41cfe56
--- /dev/null
+++ b/es-ES/installation/README.md
@@ -0,0 +1,68 @@
+# Si estás haciendo el tutorial en casa
+
+Si estás haciendo el tutorial en casa, y no en uno de los [eventos de Django Girls](https://djangogirls.org/events/), puedes saltar este capítulo por completo e ir directamente al capítulo [¿cómo funciona Internet?](../how_the_internet_works/README.md).
+
+Esto es porque cubrimos las instalaciones de cosas a medida que se requieran en el tutorial -- esta es solamente una página adicional que reúne toda la información de instalación en un solo lugar (Lo que es útil para algunos formatos de taller). Puedes escoger instalar todo lo que está en esta página ya mismo si lo deseas. Pero si tu quieres empezar a aprender cosas antes de instalar un grupo de materiales en tu computadora, salta éste capítulo y nosotros te explicaremos las partes de la instalación luego, como éstos sean necesarios.
+
+¡Buena suerte!
+
+# Si tu estás asistiendo a un workshop
+
+Si tu estás asistiendo a uno de los [Django Girls events](https://djangogirls.org/events/):
+
+* Tu workshop puede tener una "fiesta de instalación" antes del workshop principal. Si tu estás en un equipo de instalación, ¡ésta página es para ti! Sigue las instrucciones aquí para obtener todo lo que tu necesitas para el workshop de instalación, con la ayuda de los entrenadores si lo necesitas. Entonces en el workshop principal, tu estarás preparado para saltar las instrucciones de instalación que encontrarás en el tutorial principal cuando llegues a ellos.
+* Los organizadores de tu taller pueden preguntarte que en casa intentes instalar todo en tu computadora antes de iniciar el taller. Si tu has estado preguntando para hacer esto, ¡ésta página es para ti! Sigue las instrucciones aquí, como mejor puedas. Entonces en el taller principal, cuando estés en uno de los pasos de la instalación del tutorial; y si tu no tenías esa pieza instalada, puedes pedir ayuda a uno de tus entrenadores.
+* Si tu taller no tiene una estación de instalación ( o tu no podías asistir), y si los organizadores no te preguntan para que intentes instalar todo antes de tu llegada, salta ésta página y ve al capítulo [Cómo el internet funciona](../how_the_internet_works/README.md). Tú estarás instalando todo lo que necesitas para trabajar a través de el tutorial.
+
+# Instalación
+
+En este tutorial vas a construir un blog. Según, cómo vayas a través de el tutorial tu serás instruido en cómo instalar varios softwares en tu computadora y configurar algunas cuentas online como sean necesarias. Ésta página reune todas las instalaciones e instrucciones del registro en un lugar ( el cual es útil para algunos formatos del taller).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Breve introducción a la línea de comandos {#command-line}
+
+Muchos de los pasos citados abajo hacen referencia a la "consola", "terminal", "ventana de comandos", o "línea de comandos" -- todos éstos términos significan la misma cosa: una ventana en tu computadora donde tu puedes entrar comandos. Cuando tu estás en el tutorial principal, tu aprenderás más acerca de la línea de comandos. Por ahora, la parte principal que tu necesitas es saber cómo abrir una ventana de comandos y cómo luce: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Instalar Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Instala un Editor de Código {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Crea un entorno virtual (virtualenv) e instala Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Instalar Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Ve a [GitHub.com](https://www.github.com) y registrate para una nueva y gratuita cuenta de usuario. Asegúrate de recordar tu contraseña ( añadela a tu manejador de contraseñas, si tu usas uno).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Comienza a leer
+
+Felicitaciones, ¡tú tienes todo configurado y listo para avanzar! si tú aún tienes algún tiempo antes de el taller, sería útil empezar a leer un poco de los capítulos iniciales:
+
+* [¿Cómo funciona internet?](../how_the_internet_works/README.md)
+
+* [Introducción a la línea de comandos](../intro_to_command_line/README.md)
+
+* [Introducción a Python](../python_introduction/README.md)
+
+* [¿Qué es Django?](../django/README.md)
+
+# ¡Disfrutar el taller!
+
+Cuando tú comiences el taller, estarás habilitada para ir directamente a [¡Tu primer proyecto en Django!](../django_start_project/README.md) porque tú ya cubriste el material en los capítulos anteriores.
\ No newline at end of file
diff --git a/es-ES/instructions.md b/es-ES/instructions.md
new file mode 100644
index 00000000000..30bd493b11b
--- /dev/null
+++ b/es-ES/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command dnf is not found. In that case you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/es-ES/intro_to_command_line/README.md b/es-ES/intro_to_command_line/README.md
new file mode 100644
index 00000000000..a2c5a581396
--- /dev/null
+++ b/es-ES/intro_to_command_line/README.md
@@ -0,0 +1,436 @@
+# Introducción a la interfaz de línea de comandos
+
+> Para los lectores en casa: este capítulo puede verse en el vídeo [Tu nuevo amigo: Línea de Comandos](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+Es emocionante, ¿verdad? ¡Vas a escribir tu primera línea de código en pocos minutos! :)
+
+**Permítenos presentarte a tu primer amigo nuevo: ¡la línea de comandos!**
+
+Los siguientes pasos te mostrarán cómo usar aquella ventana negra que todos los hackers usan. Puede parecer un poco aterrador al principio pero es solo un mensaje en pantalla que espera a que le des órdenes.
+
+> **Nota** Ten en cuenta que a lo largo de este libro usamos los términos 'directorio' y 'carpeta' indistintamente pero son la misma cosa.
+
+## ¿Qué es la línea de comandos?
+
+La ventana, que generalmente es llamada **línea de comandos** ó **interfaz de línea de comandos**, es una aplicación basada en texto para ver, manejar y manipular archivos en tu ordenador. Similar a Windows Explorer o Finder en Mac, pero sin la interfaz gráfica. Otros nombres para la línea de comandos son: *cmd*, *CLI*, *prompt* -símbolo de sistema-, *console* -consola- o *terminal*.
+
+## Abrir la interfaz de línea de comandos
+
+Para empezar con algunos experimentos necesitarás abrir nuestra interfaz de línea de comandos en primer lugar.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Símbolo del Sistema (Prompt)
+
+Ahora deberías ver una pantalla blanca o negra que espera a que introduzcas tus comandos.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Si estás en Mac o Linux, probablemente veas una `$`, como ésta:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+En Windows, probablemente veas un `>`, como éste:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Echa un vistazo a la sección anterior sobre Linux -- podrás consultar más cuando llegues a PythonAnywhere más adelante en este tutorial.
+
+<!--endsec-->
+
+Cada comando vendrá precedido por un `$` o un `>` y un espacio, pero no debes escribirlos tú mismo. El ordenador lo hará por ti. :)
+
+> Solo una pequeña anotación: en tu caso puede que haya algo como `C:\Users\ola>` o `Olas-MacBook-Air:~ ola$` antes del símbolo de introducción, lo cual es 100% NORMAL.
+
+La parte superior incluye el `$` o el `>` que es llamado en la *línea de comandos*, o mas corto *prompt*. Introduce algo allí.
+
+En el tutorial, cuando queramos introducir un comando, incluye el `$` o `>`, y ocasionalmente más a la izquierda. Ignora la parte izquierda solamente escribiendo el comando, el cuál inicia después de el prompt.
+
+## Tu primer comando (¡BIEN!)
+
+Iniciemos por teclear este comando:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+Y luego presiona `enter`. Esto será nuestro resultado:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami olasitarska
+    
+
+Como puedes ver, el computador ha solo impreso tu nombre de usuario. Ordenado, ¿ah? :)
+
+> Intenta escribir cada comando; no copies y pegues. ¡De ésta manera lo recordarás!
+
+## Fundamentos
+
+Cada sistema operativo tiene un poco diferente la configuración de los comandos para la consola, así que asegurate de seguir las instrucciones para tu sistema operativo. Intentemos esto, ¿Verdad?
+
+### Directorio actual
+
+Sería bueno saber dónde estamos ahora, ¿Correcto? Veamos. Escribe éste comando y presiona `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Nota: 'pwd' es para imprimir el directorio de trabajo (print working directory).
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd 
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+Probablemente veremos algo similar en tu computador. Una vez que abres la consola o la línea de comandos, usualmente inicias en tu directorio principal.
+
+* * *
+
+### Aprende más sobre un comando
+
+¡Muchos comandos pueden escribirse en el prompt que tiene construído una ayuda que puedes leer! Por ejemplo, aprende más acerca de el comando del directorio actual:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X y Linux tienen un comando `man`, el cuál te da una ayuda en comandos. Intenta `man pwd` y ve que dice, o coloca `man` antes de otro comando para ver su ayuda. La salida de `man` nomalmentes es paginada. Usa la barra de espacio para moverte a la siguiente página, y `q` para sallir de la ayuda.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Añade un sufijo `/?` para mas comandos que se imprimirán en la página de ayuda. Tú puedes hacer scroll a la ventana de comandos para verlos todos. Intenta `cd /?`.
+
+<!--endsec-->
+
+### Listar ficheros y directorios
+
+Así que, ¿en qué estamos? Estaría bien saberlo. Veamos:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Cambiar el directorio actual
+
+Ahora, vamos a nuestro directorio de escritorio:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Escritorio
+    
+
+Nota que el nombre del directorio "Escritorio" puede ser traducido al lenguaje de tu cuenta de Linux. Si ese es el caso, tu necesitarás reemplazar `Escritorio` con la traducción del nombre; por ejemplo, `Schreibtisch` para el alemán.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Escritorio
+    
+
+<!--endsec-->
+
+Verifica si está cambiado actualmente:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+¡Aquí está!
+
+> PRO tip: si tu escribes `cd D` y luego presionas `tab` en tu teclado, la línea de comandos automáticamente llenará el resto de el nombre por el que puedes navegar. Si hay mas que una carpeta iniciando con "D", presiona la tecla `tab` dos veces para obtener una lista de opciones.
+
+* * *
+
+### Crear un directorio
+
+¿Cómo crear un práctico directorio para tu escritorio? Tú puedes hacerlo de esta manera:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+Éste pequeño comando creará una carpeta con el nombre `práctica` en tu computador. ¡Tú puedes verificar si está allí en tu Escritorio o ejecutando uno de los siguientes comandos `ls` o `dir`! Intentalo. :)
+
+> PRO tip: Si tu no quieres escribir el mismo comando una y otra vez, intenta presionando la `flecha arriba` y `flecha abajo` en tu teclado para regresar a través de los comandos recientemente usados.
+
+* * *
+
+### ¡Ejercicio!
+
+Un pequeño reto para ti: en tu nuevo directorio creado `práctica`, crea un directorio llamado `prueba`. (Usa los comandos `cd` y `mkdir`.)
+
+#### Solución:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practica
+    $ mkdir prueba
+    $ ls
+    prueba
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+¡Felicidades! :)
+
+* * *
+
+### Limpieza
+
+No queremos dejar un enredo, así que removamos todo lo que hicimos hasta este momento.
+
+Primero, necesitamos regresar al Escritorio:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Usando los `..` con el comando `cd` cambiaremos tu actual directorio al directorio padre( que es, el directorio que contiene tu directorio actual).
+
+Verifica dónde estás:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Es hora de eliminar el directorio `practica`:
+
+> **Atención**: Si eliminas los archivos usando `del`, `rmdir` o `rm` no se podrán recuperar, esto significa ¡*el borrado de los archivos será para siempre*! Sé muy cuidados@ coon este comando.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practica
+    practica, ¿Estás segur@<Y/N>? Y
+    
+
+<!--endsec-->
+
+¡Hecho! Estás seguro que lo eliminaste realmente, verifica:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Salir
+
+¡Eso es todo por ahora! Tú puedes ahora cerrar la línea de comandos o consola sin problemas. Hazlo como un hacker, ¿vale? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Genial, ¿no? :)
+
+## Resumen
+
+Aquí está un resumen de algunos comandos útiles:
+
+| Comando (Windows) | Comando (Mac OS / Linux) | Descripción                   | Ejemplo                                           |
+| ----------------- | ------------------------ | ----------------------------- | ------------------------------------------------- |
+| exit              | exit                     | Cierra la ventana             | **exit**                                          |
+| cd                | cd                       | Cambia el directorio          | **cd test**                                       |
+| cd                | pwd                      | Mostrar el directorio actual  | **cd** (Windows) o **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | Lista directorios/archivos    | **dir**                                           |
+| copy              | cp                       | Copia de archivos             | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | Mueve archivos                | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | Crea un nuevo directorio      | **mkdir testdirectory**                           |
+| rmdir (o del)     | rm                       | Eliminar un archivo           | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | Eliminar un Directorio        | **rm -r testdirectory**                           |
+| [CMD] /?          | man [CMD]                | Obtener ayuda para un comando | **cd /?** (Windows) o **man cd** (Mac OS / Linux) |
+
+Estos son solo algunos de los comandos que tu puedes ejecutar en tu línea de comando o consola, pero no usarás ninguno más por hoy.
+
+Si eres curios@, [ss64.com](http://ss64.com) contiene una referencia completa de comandos para todos los sistemas operativos.
+
+## ¿Listo?
+
+¡Vamos a bucear en Python!
\ No newline at end of file
diff --git a/es-ES/intro_to_command_line/open_instructions.md b/es-ES/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..08dd61eb1f1
--- /dev/null
+++ b/es-ES/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Dependiendo de tu versión de Windows y tu teclado, una de las opciones siguientes debería abrir una ventana de comandos (puede que necesites experimentar un poco, pero no se necesita probar todas estas sugerencias):
+
+- Ve al menú o pantalla de Inicio, y escribe "Símbolo del Sistema" en el cuadro de búsqueda.
+- Ve a Menú de inicio → Windows System → Command Prompt.
+- Ve al menú de Inicio → Todos los Programas → Accessorios → Símbolo del Sistema.
+- Ve a la pantalla de Inicio, pasa el ratón sobre la esquina inferior izquierda de la pantalla, y haz click en la flecha hacia abajo (en una pantalla táctil, desliza hacia arriba desde la parte baja de la pantalla). La página de la Aplicación debería abrirse. Haz click en Símbolo del Sistema en la sección Sistema de Windows.
+- Mantén la tecla especial de Windows de tu teclado y pulsa "X". Elige "Símbolo del Sistema" del menú emergente.
+- Mantén pulsada la tecla de Windows y pulsa "R" para abrir una ventana "Ejecutar". Escribe "cmd" en la caja, y haz click en OK.
+
+![Escribe "cmd" en la ventana "Ejecutar"](../python_installation/images/windows-plus-r.png)
+
+Más adelante en este tutorial, necesitarás tener dos consolas de comandos abiertas a la misma vez. Sin embargo, en algunas versiones de Windows, si ya tienes abierta una ventana de comandos e intentas abrir otra usando el mismo método, simplemente maximizará la que ya tienes abierta. ¡Inténtalo ahora en tu ordenador y mira qué ocurre! Si solo se abre una ventana de comandos, intenta alguno de los otros métodos explicados anteriormente. Al menos uno de ellos debería abrir una nueva ventana de comandos.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Ve a Aplicaciones → Utilidades → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Probablemente se encuentre en Aplicaciones → Accesorios → Terminal, o Aplicaciones → Sistema → Terminal, aunque esto dependerá de tu sistema. Si no lo encuentras allí, intenta buscarlo en Google. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/es-ES/python_installation/README.md b/es-ES/python_installation/README.md
new file mode 100644
index 00000000000..111a1a6a69e
--- /dev/null
+++ b/es-ES/python_installation/README.md
@@ -0,0 +1,15 @@
+# Vamos a empezar con Python
+
+¡Por fin estamos aquí!
+
+Pero primero, déjanos decirte qué es Python. Python es un lenguaje de programación muy popular que puede ser usado para crear sitios web, juegos, software científico, gráficos, y más, mucho más.
+
+Python se originó en la década de 1980 y su principal objetivo es ser legible por los seres humanos (¡no sólo por máquinas!). Por esta razón parece mucho más sencillo que otros lenguajes de programación, pero no te preocupes – ¡Python también es realmente poderoso!
+
+# Instalación de Python
+
+> **Nota** Si usas un Chromebook, omite este capítulo y asegúrate de seguir las instrucciones de [Chromebook Setup](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/es-ES/python_installation/instructions.md b/es-ES/python_installation/instructions.md
new file mode 100644
index 00000000000..bfc1e604613
--- /dev/null
+++ b/es-ES/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Para lectores en casa: este capitulo se cubre en el vídeo [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> Esta sección está basada en un tutorial de Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django está escrito en Python. Necesitamos Python para hacer cualquier cosa en Django. ¡Empecemos con instalarlo! Queremos que instales la última versión de Python 3, así que si tienes una versión anterior, necesitarás actualizarla. Si ya tienes la version {{ book.py_min_version }} o una más actualizada no tendrás ningún inconveniente.
+
+Por favor, instala Python normalmente de la siguiente forma, incluso si tienes Anaconda instalada en el ordenador.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Primero comprueba si tu ordenador ejecuta la versión 32 bits de Windows o la de 64, en "Tipo de sistema" en la página de "Acerca de". Para llegar a esta página, intenta uno de estos métodos:
+
+* Presiona la tecla de Windows y la tecla Pause/Break al mismo tiempo
+* Abre el Panel de Control desde el menú de Windows, después accede a Sistema & y Seguridad, luego a Sistema
+* Presiona el botón de Windows, luego accede a Configuración > Sistema > Acerca de
+* Busca "Información del sistema" en el menú de Inicio de Windows. Para hacerlo, haz click en el botón de Inicio o pulsa la tecla Windows, entonces empieza a teclear `Información del sistema`. Empezará a proporcionar sugerencias tan pronto como empieces a teclear. Puedes selecionar la entrada una vez se muestre.
+
+Puedes descargar Python para Windows desde la siguiente web https://www.python.org/downloads/windows/. Clica en el enlace "Latest Python 3 Release -Python x.x.x". Si tu ordenador ejecuta la versión de **64 bits** de Windows, descarga **Windows x86-64 executable installer**. De lo contrario, descarga **Windows x86 executable installer**. Después de descargar el instalador, deberías ejecutarlo (dándole doble click) y seguir las instrucciones.
+
+Una cosa para tener en cuenta: Durante la instalación, verás una ventana de "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![No te olvides de agregar Python al Path](../python_installation/images/python-installation-options.png)
+
+Cuando la instalación de complete, verás un cuadro de diálogo con un enlace que puedes seguir para saber más sobre Python o sobre la versión que has instalado. Cierra o cancela ese dialogo -- ¡Aprenderás más en ese tutorial!
+
+Nota: Si utilizas una versión antigua de Windows( 7, Vista u otra versión anterior) y el instalador{{ book.py_version }} Python falla con un error, entonces deberás instalar todas las actualizaciones de Windows e intentar instalar Python de nueva cuenta. Si aún así aparece el error, intenta instalar la version Python {{ book.py_min_release }} desde [python.org](https://www.python.org/downloads/windows/).
+
+> Django{{ book.django_version }}necesita Python{{ book.py_min_version }}o algo más avanzado, el cual no es compatible con Windows XP o versiones anteriores.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Descarga el archivo *Mac OS X 64-bit/32-bit installer*,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/es-ES/python_introduction/README.md b/es-ES/python_introduction/README.md
new file mode 100644
index 00000000000..af54992a02f
--- /dev/null
+++ b/es-ES/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = ' <span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introducción a Python
+
+> Parte de este capítulo se basa en tutoriales de Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+¡Escribamos algo de código!
+
+## La Consola de Python
+
+> Para los lectores en casa: el video [conceptos básicos de Python: enteros, cadenas, listas, variables y errores](https://www.youtube.com/watch?v=MO63L4s-20U) cubre esta parte.
+
+Para empezar a jugar con Python, tenemos que abrir una *línea de comandos* en nuestra computadora. Deberías saber cómo hacerlo, pues lo aprendiste en el capítulo de [Introducción a la Línea de Comandos](../intro_to_command_line/README.md).
+
+Una vez que estés lista, sigue las instrucciones a continuación.
+
+Queremos abrir una consola de Python, así que escribe `python` en Windows o `python3` en Mac OS/Linux y pulsa `intro`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## ¡Tu primer comando en Python!
+
+Después de ejecutar el comando de Python, el cursor cambiará a `>>>`. Para nosotros esto significa que por ahora sólo podemos utilizar comandos del lenguaje Python. No tienes que escribir e`>>>` pues Python lo hará por ti.
+
+Si deseas salir de la consola de Python en cualquier momento, solo escribe `exit()` o usa el atajo `Ctrl + Z` para Windows y `Ctrl + D` para Mac/Linux. Luego no verás más `>>>`.
+
+Por ahora, no queremos salir de la consola de Python. Deseamos aprender más sobre ella. Vamos a comenzar escribiendo algo de matemática, escribe `2 + 3` y oprime la tecla `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+¡Qué bien! ¿Ves cómo salió la respuesta? ¡Python sabe matemática! Puedes probar otros comandos como:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Para realizar una operación exponencial, digamos 2 elevado al cubo, escribimos: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Diviértete con esto por un momento y luego vuelve aquí. :)
+
+Como puedes ver, Python es una gran calculadora. Si te estás preguntando qué más puedes hacer…
+
+## Cadena de caracteres
+
+¿Qué tal tu nombre? Escribe tu nombre entre comillas, así:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+¡Has creado tu primera cadena de texto! La misma es una secuencia de caracteres que puede ser procesada por una computadora. La cadena de texto (o string, en inglés) debe comenzar y terminar con el mismo carácter. Pueden ser comillas simples (`'`) o dobles (`"`) (¡no hay ninguna diferencia!) Las comillas le dicen a Python que lo que está dentro de ellas es una cadena de texto.
+
+Las cadenas pueden estar concatenadas. Prueba esto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hola " + "Ola"
+'Hola Ola'
+```
+
+También puedes multiplicar las cadenas por un número:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Si necesitas poner un apóstrofe dentro de una cadena, hay dos formas de hacerlo.
+
+Usar comillas dobles:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+o escapar el apóstrofe con la diagonal inversa (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Bien, ¿eh? Para ver tu nombre en letras mayúsculas, escribe:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+¡Acabas de usar el **método** `upper` sobre tu cadena de texto! Un método (como `upper()`) es un conjunto de instrucciones que Python tiene que realizar sobre un objeto determinado (`"Ola"`) una vez que se le invoca.
+
+Si quieres saber el número de letras que contiene tu nombre, ¡también hay una **función** para eso!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Te preguntarás ¿por qué a veces se invoca a las funciones con un `.` al final de una cadena (como `"Ola".upper()`) y a veces se invoca a la función colocando la cadena entre paréntesis? Bueno, en algunos casos las funciones pertenecen a los objetos, como `upper()`, que sólo puede ser utilizada sobre cadenas. En este caso, a la función le llamamos **método**. Otra veces, las funciones no pertenecen a ningún objeto específico y pueden ser usadas en diferentes objetos, como `len()`. Esta es la razón de por qué estamos pasando `"Ola"` como un parámetro a la función `len`.
+
+### Resumen
+
+Ok, es suficiente sobre las cadenas. Hasta ahora has aprendido sobre:
+
+- **la terminal** - teclear comandos (código) en la terminal de Python resulta en respuestas de Python
+- **números y strings** - en Python los números son usados para matemáticas y strings (cadenas de caracteres) para objetos de texto
+- **operadores** - como `+` y `*`, combinan valores para producir uno nuevo
+- **funciones** - como `upper()` y `len()`, ejecutan acciones sobre los objetos.
+
+Estos son los conocimientos básicos que puedes aprender de cualquier lenguaje de programación. ¿Lista para algo más difícil? ¡Seguro que lo estás!
+
+## Errores
+
+Vamos a intentar algo nuevo. ¿Podemos obtener la longitud de un número de la misma manera que pudimos averiguar la longitud de nuestro nombre? Escribe `len(304023)` y pulsa `enter`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+¡Pues tenemos nuestro primer error! El icono de {{ warning_icon }} es nuestra manera de darte un aviso de que el código que estás ejecutando no funciona como se espera. ¡Cometer errores (incluso algunos intencionales) son una parte importante del aprendizaje!
+
+Dicho error dice que los objetos de tipo "int" (números enteros) no tienen longitud. ¿Qué podemos hacer ahora? ¿Quizás podamos escribir el número como una cadena? Las cadenas tienen longitud, ¿verdad?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+¡Funcionó! Hemos utilizado la función `str` dentro de la función `len`. `str()` convierte todo en cadenas de texto.
+
+- La función `str` convierte cosas en cadenas, **strings**
+- La función `int` convierte cosas en enteros, **integers**
+
+> Importante: podemos convertir números en texto, pero no necesariamente podemos convertir texto en números - ¿qué sería `int('hello')`?
+
+## Variables
+
+Un concepto importante en la programación son las variables. Una variable no es más que un nombre para algo, de forma que puedas usarlo más tarde. Los programadores usan estas variables para almacenar datos, hacer su código más legible y para no tener que recordar qué es cada cosa.
+
+Supongamos que queremos crear una nueva variable llamada `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+Tecleamos que nombre es igual a Ola.
+
+Como habrás notado, tu programa no devolvió nada como lo hacía antes. Así que ¿cómo sabemos que la variable existe realmente? Escribe `name` y pulsa `intro`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+¡Genial! ¡Tu primera variable :)! Siempre puedes cambiar a lo que se refiere:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+También puedes usarla dentro de funciones:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Increíble, ¿verdad? Por supuesto, las variables pueden ser cualquier cosa, ¡también números! Prueba esto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Pero ¿qué pasa si usamos el nombre equivocado? ¿Puedes adivinar qué pasaría? ¡Vamos a probar!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+¡Un error! Como puedes ver, Python tiene diferentes tipos de errores y este se llama **NameError**. Python te dará este error si intentas utilizar una variable que no ha sido definida aún. Si más adelante te encuentras con este error, verifica tu código para ver si no has escrito mal una variable.
+
+¡Juega con esto un rato y descubre qué puedes hacer!
+
+## La función print
+
+Intenta esto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Cuando sólo escribes `name`, el intérprete de Python responde con la *representación* en forma de cadena de la variable 'name', que son las letras M-a-r-i-a, rodeadas de comillas simples ''. Cuando dices `print(name)`, Python va a "imprimir" el contenido de la variable a la pantalla, sin las comillas, que es más claro.
+
+Como veremos después, `print()` también es útil cuando queremos imprimir cosas desde adentro de las funciones, o cuando queremos imprimir cosas en múltiples líneas.
+
+## Listas
+
+Además de cadenas y enteros, Python tiene toda clase de tipos de objetos diferentes. Ahora vamos a introducir uno llamado **list**. Las listas son exactamente lo que piensas que son: objetos que son listas de otros objetos. :)
+
+Anímate y crea una lista:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Sí, esta lista está vacía. No es muy útil, ¿verdad? Vamos a crear una lista de números de lotería. No queremos repetirnos todo el rato, así que la pondremos también en una variable:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+Muy bien, ¡tenemos una lista! ¿Qué podemos hacer con ella? Vamos a ver cuántos números de lotería hay en la lista. ¿Tienes alguna idea de qué función deberías usar para eso? ¡Ya lo sabes!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+¡Sí! `len()` puede darte el número de objetos en una lista. Útil, ¿verdad? Tal vez la ordenemos ahora:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+No devuelve nada, sólo ha cambiado el orden en que los números aparecen en la lista. Vamos a imprimirla otra vez y ver que ha pasado:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Como puedes ver, los números de tu lista ahora están ordenados de menor a mayor. ¡Enhorabuena!
+
+¿Te gustaría invertir ese orden? ¡Vamos a hacerlo!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+Si quieres añadir algo a tu lista, puedes hacerlo escribiendo este comando:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Si deseas mostrar sólo el primer número, puedes hacerlo mediante el uso de **indexes** (en español, índices). Un índice es el número que te dice dónde en una lista aparece un ítem. Las programadoras y los programadores prefieren comenzar a contar desde 0, por lo tanto el primer objeto en tu lista esta en el indice 0, el próximo esta en el 1, y así sucesivamente. Intenta esto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Como puedes ver, puedes acceder a diferentes objetos en tu lista utilizando el nombre de la lista y el índice del objeto dentro de corchetes.
+
+Para borrar algo de tu lista tendrás que usar **índices** como aprendimos anteriormente y la función `pop()`. Vamos a tratar de ejemplificar esto y reforzaar lo que aprendimos anteriormente; vamos a borrar el primer número de nuestra lista.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Funcionó de maravilla!
+
+Para diversión adicional, prueba algunos otros índices: 6, 7, 1000, -1, -6 ó -1000. A ver si se puedes predecir el resultado antes de intentar el comando. ¿Tienen sentido los resultados?
+
+Puedes encontrar una lista de todos los métodos disponibles para listas en este capítulo de la documentación de Python: https://docs.python.org/3/tutorial/datastructures.html
+
+## Diccionarios
+
+> Para lectores en casa: este capítulo está cubierto en el video [Bases de Python: Diccionarios](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+
+Un diccionario es similar a una lista, pero accedes a valores usando una llave en vez de un índice. Una llave puede ser cualquier cadena o número. La sintaxis para definir un diccionario vacío es:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Esto demuestra que acabas de crear un diccionario vacío. ¡Hurra!
+
+Ahora, trata escribiendo el siguiente comando (intenta reemplazando con tu propia información):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+Con este comando, acabas de crear una variable llamada `participant` con tres pares llave-valor:
+
+- La llave `name` apunta al valor `'Ola'` (un objeto `string`),
+- `country` apunta a `'Poland'` (otro `string`),
+- y `favorite_numbers` apunta a `[7, 42, 92]` (una `list` con tres números en ella).
+
+Puedes verificar el contenido de claves individuales con esta sintaxis:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Lo ves, es similar a una lista. Pero no necesitas recordar el índice - sólo el nombre.
+
+¿Qué pasa si le pedimos a Python el valor de una clave que no existe? ¿Puedes adivinar? ¡Pruébalo y verás!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+¡Mira, otro error! Este es un **KeyError**. Python te ayuda y te dice que la llave `'age'` no existe en este diccionario.
+
+¿Cuando deberías usar un diccionario o una lista? Bueno, es un buen punto para reflexionar. Piensa sobre la respuesta, antes de mirar una solución en la siguiente línea.
+
+- ¿Sólo necesitas una secuencia ordenada de elementos? Usa una lista.
+- ¿Necesitas asociar valores con claves, así puedes buscarlos eficientemente (usando las claves) más adelante? Utiliza un diccionario.
+
+Los diccionarios, como las listas, son *mutables*, lo que quiere decir que pueden ser modificados después de ser creados. Puedes agregar nuevos pares llave/valor a un diccionario luego de crearlo, como:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Espero tenga sentido hasta ahora. :) ¿Listo para más diversión con diccionarios? Salta a la siguiente línea para algunas cosas sorprendentes.
+
+Puedes utilizar el comando `pop()` para borrar un elemento en el diccionario. Por ejemplo, si deseas eliminar la entrada correspondiente a la clave `'favorite_numbers'`, tienes que escribir el siguiente comando:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Como puedes ver en la salida, el par de llave-valor correspondiente a la llave 'favorite_numbers' ha sido eliminado.
+
+Además de esto, también puedes cambiar un valor asociado a una llave ya creada en el diccionario. Escribe:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Como puedes ver, el valor de la llave `'country'` ha sido modificado de `'Poland'` a `'Germany'`. :) ¿Emocionante? ¡Hurra! Has aprendido otra cosa asombrosa.
+
+### Resumen
+
+¡Genial! Sabes mucho sobre programación ahora. En esta última parte aprendiste sobre:
+
+- **errores** - ahora sabes cómo leer y entender los errores que aparecen si Python no entiende un comando
+- **variables** - nombres para los objetos que te permiten codificar más fácilmente y hacer el código más legible
+- **listas** - listas de objetos almacenados en un orden determinado
+- **diccionarios** - objetos almacenados como pares llave-valor
+
+¿Emocionada por la siguiente parte? :)
+
+## Compara cosas
+
+> Para lectores en casa: este capítulo está cubierto en el video [Bases de Python: Comparaciones](https://www.youtube.com/watch?v=7bzxqIKYgf4).
+
+Buena parte de la programación incluye comparar cosas. ¿Qué es lo más fácil para comparar? Números, por supuesto. Vamos a ver cómo funciona:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+¿Te preguntas por qué pusimos dos signos igual `==` al lado del otro para comparar si los números son iguales? Utilizamos un solo `=` para asignar valores a las variables. Siempre, **siempre** es necesario poner dos `==` Si deseas comprobar que las cosas son iguales entre sí. También podemos afirmar que las cosas no son iguales a otras. Para eso, utilizamos el símbolo `!=`, como mostramos en el ejemplo anterior.
+
+Da dos tareas más a Python:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+Hemos visto `>` y `<`, pero, ¿qué significan `>=` y `<=`? Los puedes leer así:
+
+- x `>` y significa: x es mayor que y
+- x `<` y significa: x es menor que y
+- x `<=` y significa: x es menor o igual que y
+- x `>=` y significa: x es mayor o igual que y
+
+¡Genial! ¿Quieres hacer uno mas? Intenta esto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Puedes darle a Python todos los números para comparar que quieras, y siempre te dará una respuesta. Muy inteligente, ¿verdad?
+
+- **and** - si utilizas el operador `and`, ambas comparaciones deben ser True para que el resultado de todo el comando sea True
+- **or** - si utilizas el operador `or`, sólo una de las comparaciones tiene que ser True para que el resultado de todo el comando sea True
+
+¿Has oído la expresión "comparar manzanas con naranjas"? Vamos a probar el equivalente en Python:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Aquí verás que al igual que en la expresión, Python no es capaz de comparar un número (`int`) y un string (`str`). En cambio, muestra un **TypeError** y nos dice que los dos tipos no se pueden comparar.
+
+## Boolean
+
+Incidentalmente, acabas de aprender sobre un nuevo tipo de objeto en Python. Se llama **Boolean** (booleano).
+
+Hay sólo dos objetos booleanos:
+
+- True - verdadero
+- False - falso
+
+Pero para que Python entienda esto, siempre los tienes que escribir de modo 'True' (la primera letra en mayúscula, con el resto de las letras en minúscula). **true, TRUE, y tRUE no funcionarán – solamente True es correcta.** (Lo mismo aplica también para 'False'.)
+
+Los valores booleanos pueden ser variables, también. Ve el siguiente ejemplo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+También puedes hacerlo de esta manera:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practica y diviértete con los booleanos ejecutando los siguientes comandos:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+¡Felicidades! Los booleanos son una de las funciones más geniales en programación y acabas de aprender cómo usarlos.
+
+# ¡Guárdalo!
+
+> Para lectores en casa: este capítulo está cubierto en el video [Bases de Python: Guardando archivos y condicionales](https://www.youtube.com/watch?v=dOAg6QVAxyk).
+
+Hasta ahora hemos escrito todo nuestro código Python en el intérprete, lo cual nos limita a ingresar una línea de código a la vez. Normalmente los programas son guardados en archivos y son ejecutados por el **intérprete** o **compilador** de nuestro lenguaje de programación. Hasta ahora, hemos estado corriendo nuestros programas de a una línea por vez en el **intérprete** de Python. Necesitaremos más de una línea de código para las siguientes tareas, entonces necesitaremos hacer rápidamente lo que sigue:
+
+- Salir del intérprete de Python
+- Abrir el editor de texto de nuestra elección
+- Guardar algo de código en un nuevo archivo de Python
+- ¡Ejecutarlo!
+
+Para salir del intérprete de Python que hemos estado usando, escribe `exit()`
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Esto te llevará de vuelta a la línea de comandos.
+
+Anteriormente, seleccionamos un editor de código de la sección </a>editor de código</0>. Necesitaremos abrir el editor ahora y escribir algo de código en un nuevo archivo (o si está usando un Chromebook, cree un nuevo archivo en el IDE de la nube y abra el archivo, que estará en el editor de código incluido):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviamente, ahora eres una desarrolladora Python muy experimentada, asi que sintete libre de escribir algo del código que has aprendido hoy.
+
+Ahora tenemos que guardar el archivo y asignarle un nombre descriptivo. Vamos a llamar al archivo **python_intro.py** y guardarlo en tu escritorio. Podemos nombrar el archivo como queramos, pero la parte importante es asegurarse de que termina en **.py**. La extensión **.py** le dice a nuestro sistema operativo que es un **archivo ejecutable de python** y Python lo puede ejecutar.
+
+> **Nota** Deberías notar una de las cosas más geniales de los editores de código: ¡los colores! En la consola de Python, todo era del mismo color, ahora deberías ver que la función `print` es de un color diferente a la cadena en su interior. Esto de denomina "sintaxis resaltada", y es una característica muy útil cuando se programa. El color de las cosas te dará pistas, como cadenas no cerradas o errores tipográficos en un nombre clave (como `def` en una función, que veremos a continuación). Esta es una de las razones por las cuales usar un editor de código. :)
+
+Con el archivo guardado, ¡es hora de ejecutarlo! Utilizando las habilidades que has aprendido en la sección de línea de comandos, utiliza la terminal para **cambiar los directorios** e ir al escritorio.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+En una Mac, el comando se verá algo como esto:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+En Linux, será así:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Recuerde que la palabra "Desktop" puede traducirse a su idioma local.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+En la consola de Windows, ésto será como:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+Y en Windows Powershell, será así:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Si tú estás atascada, pregunta por ayuda. ¡Eso es exactamente lo que hacen los entrenadores!
+
+Ahora usa Python para ejecutar el código en el archivo como esto:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Nota: en Windows 'python3' no es reconocido como un comando. En su lugar, usa 'python' para ejecutar el archivo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+¡Correcto! Ahora corriste tu primer programa de Python que fue guardado en un archivo. ¿Se siente increíble?
+
+Puedes ahora moverte a una herramienta esencial en programación:
+
+## If … elif … else
+
+Muchas de las cosas en código debería ser ejecutadas solo cuando las condiciones son conocidas. Eso es por qué Python lo ha llamado **sentencias if**.
+
+Reemplaza el código en tu archivo **python_intro.py** con esto:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Si guardáramos y corriéramos esto, veríamos un error como éste:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python nos espera dar nuevas instrucciones, las cuales son ejecutadas si la condición `3 > 2` torna a ser verdadera (o `True` para ese caso). Intentemos imprimir en Python "¡Funciona!". Cambia el código de tu archivo **python_intro.py** a esto:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+¿Notas cómo estamos indentando la siguiente línea de código con 4 espacios? Nosotros necesitamos hacer ésto para que Python comprenda que el código se ejecuta si el resultado es verdadero. Tú puedes hacer un espacio, pero prácticamente todos los programadores en Python hacen 4 espacios para hacer el código más legible. Un simple tabulador también contará como 4 espacios tan largos como tu editor de texto esté configurado. Cuando tú haces tu elección, ¡no la cambies! Si tu ya identaste con 4 espacios, sigue haciendo futuras identaciones con 4 espacios también, de otra forma, tú puedes correr con problemas.
+
+Guárdalo y ejecútalo de nuevo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Nota: Recuerda que en Windows, 'python3' no es reconocido como un comando. Desde ahora, reemplaza 'python3' con 'python' para ejecutar el archivo.
+
+### ¿Qué pasa si una condición no es verdadera?
+
+En previos ejemplos, el código fue ejecutado solamente cuando las condiciones eran Verdaderas. Pero Python también tiene sentencias `elif` y `else`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+Cuando ésto se ejecuta, imprimirá:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+Si 2 era mayor que el número 5, entonces el segundo comando sería ejecutado. Veamos cómo `elif` funciona:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+y ejecuta:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+¿Ves qué sucedió allí? `elif` te deja añadir condiciones adicionales que se ejecutan si las condiciones previas fallan.
+
+Tú puedes añadir tantas sentencias `elif` como quieras, luego de tu sentencia inicial `if`. Por ejemplo:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("Me duelen las orejas! :(")
+```
+
+Python corre a través de cada prueba secuencialmente e imprime:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comentarios
+
+Los comentarios son líneas que comienzan con `#`. Tú puedes escribir lo que quieras luego de el `#` y Python lo ignorará. Los comentarios pueden hacer que el código sea más fácil de entender para otras personas.
+
+Veamos cómo luce:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Cambiar el volumen si esta muy alto o muy bajo
+if volume < 20 or volume > 80:
+    volume = 50
+    print("Mucho mejor!")
+```
+
+Tú no necesitas escribir un comentario para cada línea de código, pero ellos son útiles para explicar qué está haciendo el código, o proveer un resumen cuando se está haciendo algo complejo.
+
+### Resumen
+
+En los últimos ejercicios tú aprendiste acerca de:
+
+- **Comparar cosas** - en Python puedes comparar cosas haciendo uso de `>`, `>=`, `==`, `<=`, `<` y de los operatores `and` y `or`
+- **Boolean** - un tipo de objeto que sólo puede tener uno de dos valores: `True` o `False`
+- **Guardar archivos** - almacenar código en archivos para que puedas ejecutar programas más grandes.
+- **if... elif... else** - sentencias que te permiten ejecutar código sólo cuando se cumplen ciertas condiciones.
+- **comentarios** - líneas que Python no ejecutará que permiten documentar el código
+
+¡Es tiempo para leer la última parte de éste capítulo!
+
+## ¡Tus propias funciones!
+
+> Para lectores en casa: este capítulo está cubierto en el video [Bases de Python: Funciones](https://www.youtube.com/watch?v=5owr-6suOl0).
+
+¿Recuerdas las funciones como `len()` que puedes ejecutar en Python? Bien, buenas noticias - ¡tú aprenderás cómo escribir tus propias funciones ahora!
+
+Una función es una secuencia de instrucciones que Python debería ejecutar. Cada función en Python inicia con la palabra clave `def`, el nombre es dado, y puede tener algunos parámetros. Veamos. Reemplaza el código en **python_intro.py** con lo siguiente:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, ¡nuestra primera función está lista!
+
+Tú puedes preguntar por qué hemos escrito el nombre de la función en la parte inferior de el archivo. Cuando escribimos `def hi():` y las líneas indentadas que siguen, estamos escribiendo instrucciones que la función `hi()` debe hacer. Python leerá y recordará estas instrucciones, pero no ejecutará la función todavía. Para decirle a Python que queremos ejecutar la función, tenemos que llamar a la función con `hi()`. Python lee el archivo y lo ejecuta desde arriba hacia abajo, así que tenemos que definir la función en el archivo antes de llamarla.
+
+Ejecuta ésto ahora y ve qué sucede:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Nota: si ésto no funciona, ¡Tranquil@! La salida te ayudará a entender por qué:
+
+- Si te sale `NameError`, probablemente significa que escribiste algo mal, así que deberias comprobar si utilizaste el mismo nombre para crear la función con `def hi():` y al llamarla con `hi()`.
+- Si te sale un `IndentationError`, comprueba que las líneas del `print` tienen el mismo espacio en blanco al comienzo de línea: python requiere que todo el código dentro de la función esté perfectamente alineado.
+- Si no hay ninguna salida, comprueba que el último `hi()` *no esté* identado - si lo está, esa línea también sera parte de la función, y nunca se ejecutará.
+
+Construyamos nuestra primera función con parámetros. Cambiarémos el ejemplo anterior - una función que dice 'hola' para la persona que lo ejecuta - con un nombre:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+Como puedes ver, ahora le dimos a nuestra función un parámetro que llamamos `nombre`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Recuerda: La función `print` está indentada con 4 espacios en la sentencia `if`. Esto es porque la función se ejecuta cuando la condición es conocida. Veamos cómo funciona ahora:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, un error. Por suerte, Python nos da un útil y agradable mensaje de error. Este nos dice que la función `hi()` (que definimos) tiene un argumento requerido (llamado `nombre`) y que olvidamos pasarlo cuando llamamos a la función. Configuremos esto en la parte inferior del archivo:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+Y ejecutemos otra vés:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+¿Y si cambiamos el nombre?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+Y lo ejecutamos:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Ahora, ¿Qué piensas que sucederá si escribes otro nombre allí? (No Ola o Sonja.) Intenta y ve si estás en lo correcto. Debería imprimir esto:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+Esto es sorprendente, ¿Verdad? De esta manera tú no tienes que repetir la función cada vez que cambies el nombre de la persona que está supuesta a recibir. Y eso es exactamente por qué necesitamos funciones - ¡tú nunca quieres repetir tú código!
+
+Hacer algo más inteligente - hay más nombres que dos, y escribir una condición para cada uno sería difícil, ¿Verdad? Reemplaza el contenido de tu archivo con lo siguiente:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Llamarémos al código ahora:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+¡Felicidades! ¡Ya aprendíste a cómo escribir funciones! :)
+
+## Bucles
+
+> Para lectores en casa: este capítulo está cubierto en el video [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0).
+
+Listo ésta es la última parte. Eso fue rápido, ¿verdad? :)
+
+Los programadores no les gusta repetir. Programar es todo acerca de automatizar cosas, así que no queremos recibir a cada persona por su nombre manualmente, ¿verdad? Allí es dónde los ciclos vienen a manejarse.
+
+¿Aún recuerdas las listas? Hagamos una lista de niñas:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+Queremos recibir a todos ellos con sus nombres. Tenemos la función `hola` para hacerlo, así que usémosla en un ciclo:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+La sentencia `for` se comporta parecido a una sentencia `if`; ambos códigos necesitan ser indentados por 4 espacios.
+
+Aquí está completo el código que estará en el archivo:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+Y cuando lo ejecutemos:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+Como puedes ver, todo lo que coloques dentro de una sentencia `for` con una indentación, será repetida para cada elemento de la lista `girls`.
+
+Tu puedes también usar `for` con números usando la función `range`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+El cuál imprimirá:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` es una función que crea una lista de números en serie (estos números son proporcionados por ti como parámetros).
+
+Nota que el segundo de estos números no está incluido en la lista que regresa Python (es decir, `range(1, 6)` cuenta desde 1 a 5, pero no incluye el número 6). Esto es porque "range" está medio-abierto, y por eso se incluye el primer valor, pero no el último.
+
+## Resumen
+
+Eso es todo. **¡Tú rockeas totalmente!** Esto fue un capítulo difícil, así que deberías sentirte orgullos@ de ti. ¡Estamos definitivamente encantados de que hayas llegado tan lejos!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+Tu podrías querer un momento para algo - estirarte, caminar cerca, descansar tus ojos - antes de avanzar a un próximo capítulo. :)
+
+![Pastelillo](images/cupcake.png)
\ No newline at end of file
diff --git a/es-ES/signup_pythonanywhere.md b/es-ES/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/es-ES/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/es-ES/template_extending/README.md b/es-ES/template_extending/README.md
new file mode 100644
index 00000000000..4fe42b329b8
--- /dev/null
+++ b/es-ES/template_extending/README.md
@@ -0,0 +1,151 @@
+# Extendiendo plantillas
+
+Otra cosa buena que tiene Django es la **extensión de plantillas**. ¿Qué significa? Significa que puedes reusar partes del HTML para diferentes páginas del sitio web.
+
+Las plantillas son útiles cuando quieres utilizar la misma información o el mismo diseño en más de un lugar. No tienes que repetirte a ti misma en cada archivo. Y si quieres cambiar algo, no tienes que hacerlo en cada plantilla, sólo en una!
+
+## Crea una plantilla base
+
+Una plantilla base es la plantilla más básica que extiendes en cada página de tu sitio web.
+
+Vamos a crear un archivo `base.html` en `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Ahora, ábrelo en el editor de código y copia todo el contenido de `post_list.html` en `base.html`, así:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Blog de Django Girls</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Blog de Django Girls</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Luego, en `base.html` reemplaza por completo tu `<body>` (todo lo que haya entre `<body>` and `</body>`) con esto:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Blog de Django Girls</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Seguro que ya te has dado cuenta de que lo que hemos hecho ha sido cambiar todo lo que había entre `{% for post in posts %}` y `{% endfor %}` por {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Pero ¿por qué? ¡Acabas de crear un bloque! Hemos usado la etiqueta de plantilla `{% block %}` para crear un área en la que se insertará HTML. Ese HTML vendrá de otra plantilla que extiende esta (`base.html`). Enseguida te enseñamos cómo se hace.
+
+Ahora guarda `base.html` y abre `blog/templates/blog/post_list.html` de nuevo en el editor. {% raw %}Quita todo lo que hay encima de `{% for post in posts %}` y por debajo de `{% endfor %}`. Cuando termines, el archivo tendrá este aspecto:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Queremos utilizar esto como parte de nuestra plantilla en los bloques de contenido. ¡Es hora de añadir etiquetas de bloque en este archivo!
+
+{% raw %}Tu etiqueta de bloque debe ser la misma que la etiqueta del archivo `base.html`. También querrás que incluya todo el código que va en los bloques de contenido. Para ello, pon todo entre `{% block content %}` y `{% endblock %}`. Algo como esto:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Solo falta una cosa. Tenemos que conectar estas dos plantillas. ¿Esto es lo que significa extender plantillas! Para eso tenemos que añadir una etiqueta "extends" al comienzo del archivo. Así:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+¡Y ya está! Guarda el fichero y comprueba que el sitio web sigue funcionando como antes. :)
+
+> Si te sale el error `TemplateDoesNotExist`, que significa que no hay ningún archivo `blog/base.html` y tienes `runserver` corriendo en la consola. Intenta pararlo, pulsando Ctrl+C (teclas Control y C a la vez) en la consola y reiniciarlo con el comando `python manage.py runserver`.
\ No newline at end of file
diff --git a/es-ES/whats_next/README.md b/es-ES/whats_next/README.md
new file mode 100644
index 00000000000..bf6a19a94f4
--- /dev/null
+++ b/es-ES/whats_next/README.md
@@ -0,0 +1,43 @@
+# ¿Y ahora qué?
+
+Date muchas felicitaciones. **¡Eres increíble!** ¡Estamos orgullosas! <3
+
+### ¿Qué hacer ahora?
+
+Toma un descanso y ¡relájate!. Acabas de hacer algo realmente grande.
+
+Después de eso, asegúrate de seguir a Django Girls en [Facebook](http://facebook.com/djangogirls) o [Twitter](https://twitter.com/djangogirls) para estar al día.
+
+### ¿Me puedes recomendar recursos adicionales?
+
+¡ Sí! Hay un *montón* de recursos en línea para el aprendizaje de todas las clases de habilidades en programación – puede ser algo intimidante donde ir, pero le tenemos cubierto. Cualquiera que sean tus intereses antes de que usted viniera a Django Girls, y los intereses que haya desarrollado a lo largo del tutorial, aquí hay algunos recursos gratuitos (o recursos con grandes componentes libres) que puede utilizar para llegar a donde quiera estar.
+
+#### Django
+
+- En nuestro libro [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [El tutorial oficial de Django](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Comienza a usar las lecciones en video de Django](http://www.gettingstartedwithdjango.com/)
+- [Especialización de Django para todos](https://www.coursera.org/specializations/django) - algunas vídeo-lecturas pueden ser auditadas de manera gratuita y puedes ganar un certificado de Coursera por tomar estos cursos
+
+#### HTML, CSS y JavaScript
+
+- [El curso de desarrollo web de Codeacademy](https://www.codecademy.com/learn/paths/web-development)
+- [FreeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [El curso de Python en Codeacademy](https://www.codecademy.com/learn/learn-python)
+- [Curso de Python de Google](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – Los primeros ejercicios son gratuitos
+- [Nuevos tutoriales de Coder](http://newcoder.io/tutorials/) - esta es una variedad de ejemplos prácticos de cómo puedes usar Python
+- [edX](https://www.edx.org/course?search_query=python) – puedes auditar la mayoría de los cursos gratis, pero si desea un certificado o créditos para una calificación de educación superior, entonces eso costará dinero
+- [La especialización Python en Coursera](https://www.coursera.org/specializations/python) – algunas videoconferencias pueden ser auditadas gratuitamente y puedes ganar un certificado de Coursera tomando estos cursos
+- [Python for Everybody](https://www.py4e.com/) - una versión libre y abierta de la especialización de Python en Coursera
+
+#### Trabajar con datos
+
+- [Curso de ciencia de datos de Codecademy](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – puedes auditar la mayoría de los cursos gratis, pero si desea un certificado o créditos para una calificación de educación superior, entonces eso costará dinero
+- [Dataquest](https://www.dataquest.io/) – las primeras 30 "misiones" son gratuitas
+
+¡No podemos esperar para ver lo que construyes a continuación!
\ No newline at end of file
diff --git a/es/GLOSSARY.md b/es/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/es/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/es/README.md b/es/README.md
index f701e82f95b..01736ae0502 100755
--- a/es/README.md
+++ b/es/README.md
@@ -1,51 +1,51 @@
-# Tutorial de Django Girls
+# Django Girls Tutorial
 
-[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
 
-> Este trabajo está bajo la licencia internacional Creative Commons Attribution-ShareAlike 4.0. Para ver una copia de esta licencia, visita el siguiente enlace https://creativecommons.org/licenses/by-sa/4.0/
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
 
-## Translation
-This tutorial has been translated from English into Spanish by a wonderful group of volunteers. Special thanks goes to Victoria Martinez de la Cruz, Kevin Morales, Joshua Aranda, Silvia Frias, Leticia, Andrea Gonzalez, Adrian Manjarres, Rodrigo Caicedo, Maria Chavez, Marcelo Nicolas Manso, Rosa Durante, Moises, Israel Martinez Vargas, JuanCarlos_, N0890Dy, Ivan Yivoff, Khaterine Castellano, Erick Navarro, cyncyncyn, ZeroSoul13, Erick Aguayo, Ernesto Rico-Schmidt, Miguel Lozano, osueboy, dynarro and Geraldina Garcia Alvarez.
+## Welcome
 
-## Introducción
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
 
-¿Alguna vez has sentido que el mundo está cada vez más cercano a la tecnología y de cierto modo te has quedado atrás? ¿Alguna vez te has preguntado cómo crear un sitio web pero nunca has tenido la suficiente motivación para empezar? ¿Has pensado alguna vez que el mundo del software es demasiado complicado para ti como para intentar hacer algo por tu cuenta?
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
 
-Bueno, ¡tenemos buenas noticias para ti! Programar no es tan difícil como aparenta y queremos mostrarte cuán divertido puede llegar a ser.
+## Introduction
 
-Este tutorial no te convertirá en programador mágicamente. Si quieres ser buena en esto, necesitarás meses o incluso años de aprendizaje y práctica. Pero queremos mostrarte que programar o crear sitios web no es tan complicado como parece. Intentaremos explicar pequeñas partes lo mejor que podamos, de forma que no te sientas intimidada por la tecnología.
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
 
-¡Esperamos poder hacerte amar la tecnología tanto como nosotras lo hacemos!
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
 
-## ¿Qué aprenderás con este tutorial?
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
 
-Cuando termines el tutorial, tendrás una aplicación web simple y funcional: tu propio blog. Te mostraremos como publicarla online, ¡así otros podrán ver tu trabajo!
+We hope that we'll be able to make you love technology as much as we do!
 
-Tendrá (más o menos) ésta apariencia:
+## What will you learn during the tutorial?
 
-![Figura 0.1][2]
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
 
- [2]: images/application.png
+It will (more or less) look like this:
 
-> Si estás siguiendo este tutorial por tu cuenta y no tienes a nadie que te ayude en caso de surgir algún problema, tenemos un chat para ti: [![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge). ¡Hemos pedido a nuestros tutores y participantes anteriores que estén ahí de vez en cuando para ayudar a otros con el tutorial! ¡No temas dejar tus preguntas allí!
+![Figure 0.1](images/application.png)
 
-Bien, [empecemos por el principio...][3]
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
 
- [3]: ./how_the_internet_works/README.md
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
 
-## Sobre nosotros y cómo contribuir
+## Following the tutorial at home
 
-Este tutorial lo mantiene [DjangoGirls][4]. Si encuentras algún error o quieres actualizar el tutorial, por favor [sigue la guía de cómo contribuir][5].
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
 
- [4]: https://djangogirls.org/
- [5]: https://github.com/DjangoGirls/tutorial/blob/master/README.md
+In every chapter already covered, there is a link that points to the correct video.
 
-## ¿Te gustaría ayudarnos a traducir el tutorial a otros idiomas?
+## About and contributing
 
-Actualmente, las traducciones se llevan a cabo sobre la plataforma crowdin.com en:
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
 
-https://crowdin.com/project/django-girls-tutorial
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
 
-Si tu idioma no esta listado en crowdin, por favor [abre un nuevo problema][6] informando el idioma así podemos agregarlo.
+https://crowdin.com/project/django-girls-tutorial
 
- [6]: https://github.com/DjangoGirls/tutorial/issues/new
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/es/SUMMARY.md b/es/SUMMARY.md
index 31ea84b15ed..7a45700a27d 100755
--- a/es/SUMMARY.md
+++ b/es/SUMMARY.md
@@ -1,25 +1,27 @@
-# Índice
+# Summary
 
-*   [Introducción](README.md)
-*   [¿Cómo funciona Internet?](how_the_internet_works/README.md)
-*   [Introducción a la línea de comandos](intro_to_command_line/README.md)
-*   [Instalación de Python](python_installation/README.md)
-*   [Editor de código](code_editor/README.md)
-*   [Introducción a Python](python_introduction/README.md)
-*   [¿Qué es Django?](django/README.md)
-*   [Instalación de Django](django_installation/README.md)
-*   [Comenzar un proyecto en Django](django_start_project/README.md)
-*   [Modelos en Django](django_models/README.md)
-*   [Administrador de Django](django_admin/README.md)
-*   [¡Desplegar!](deploy/README.md)
-*   [Django urls](django_urls/README.md)
-*   [Vistas de Django - ¡Es hora de crear!](django_views/README.md)
-*   [Introducción a HTML](html/README.md)
-*   [ORM de Django (Querysets)](django_orm/README.md)
-*   [Datos dinámicos en plantillas](dynamic_data_in_templates/README.md)
-*   [Plantillas de Django](django_templates/README.md)
-*   [CSS - Hazlo bonito](css/README.md)
-*   [Extender plantillas](template_extending/README.md)
-*   [Amplía tu aplicación](extend_your_application/README.md)
-*   [Formularios en Django](django_forms/README.md)
-*   [¿Qué sigue?](whats_next/README.md)
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/es/chromebook_setup/README.md b/es/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/es/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/es/chromebook_setup/instructions.md b/es/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/es/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/es/code_editor/README.md b/es/code_editor/README.md
index 3f6c86b1f73..404011f1b7d 100755
--- a/es/code_editor/README.md
+++ b/es/code_editor/README.md
@@ -1,43 +1,11 @@
-# Editor de código
+# Code editor
 
-Estás a punto de escribir tu primera línea de código, así que ¡es hora de descargar un editor de código!
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
 
-Hay muchos editores diferentes, cuál usar depende mucho de la preferencia personal. La mayoría de programadores de Python usan IDEs (Entornos de Desarrollo Integrados) complejos pero muy poderosos, como PyCharm. Sin embargo, como principiante, eso es probablemente menos conveniente; nuestras recomendaciones son igual de poderosas pero mucho mas simples.
+You're about to write your first line of code, so it's time to download a code editor!
 
-Nuestras sugerencias están listadas abajo, pero siéntete libre de preguntarle a tu tutor cuáles son sus preferencias - así será más fácil obtener su ayuda.
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
 
-## Gedit
-
-Gedit es un editor de código abierto, gratis, disponible para todos los sistemas operativos.
-
-[Descárgalo aquí][1]
-
- [1]: https://wiki.gnome.org/Apps/Gedit#Download
-
-## Sublime Text 3
-
-Sublime Text es un editor muy popular con un periodo de prueba gratis. Es fácil de instalar y está disponible para todos los sistemas operativos.
-
-[Descárgalo aquí][2]
-
- [2]: https://www.sublimetext.com/3
-
-## Atom
-
-Atom es un editor de código muy nuevo creado por [GitHub][3]. Es gratis, de código abierto, fácil de instalar y fácil de usar. Está disponible para Windows, OSX y Linux.
-
- [3]: https://github.com/
-
-[Descárgalo aquí][4]
-
- [4]: https://atom.io/
-
-# ¿Por qué estamos instalando un editor de código?
-
-Puedes estar preguntándote por qué estamos instalando un editor especial, en lugar de usar un editor convencional como Word o Notepad.
-
-En primer lugar, el código tiene que ser **texto plano** y el problema de las aplicaciones como Word o Textedit es que en realidad no producen texto plano. Lo que generan es texto enriquecido (con tipografías y formato), usando formatos propios como rtf.
-
-La segunda razón es que los editores de código son herramientas especializadas y, como tales, tienen características muy útiles, como resaltar la sintáxis del código con diferentes colores de acuerdo a su significado o cerrar comillas por ti automáticamente.
-
-Veremos todo esto en acción más adelante. En breve empezarás a pensar en tu fiel editor de código como una de tus herramientas favoritas :)
\ No newline at end of file
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/es/code_editor/instructions.md b/es/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/es/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/es/css/README.md b/es/css/README.md
index f252d90e6a3..04d5996ae52 100755
--- a/es/css/README.md
+++ b/es/css/README.md
@@ -1,58 +1,59 @@
-# CSS - ¡Hazlo bonito!
+# CSS – make it pretty!
 
-Nuestro blog todavía se ve bastante feo, ¿verdad? ¡Es hora de hacerlo bonito! Vamos a usar CSS para eso.
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
 
-## ¿Qué es CSS?
+## What is CSS?
 
-CSS (Cascading Style Sheets, que significa 'hojas de estilo en cascada') es un lenguaje utilizado para describir el aspecto y el formato de un sitio web escrito en lenguaje de marcado (como HTML). Trátalo como maquillaje para nuestra página web ;).
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
 
-Pero no queremos empezar de cero otra vez, ¿verdad? Una vez más, usaremos algo que ya ha sido realizado por programadores y publicado en Internet de forma gratuita. Ya sabes, reinventar la rueda no es divertido.
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
 
-## ¡Vamos a usar Bootstrap!
+## Let's use Bootstrap!
 
-Bootstrap es uno de los frameworks HTML y CSS más populares para desarrollar webs bonitas: https://getbootstrap.com/
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
 
-Lo escribieron programadores que trabajaban para Twitter y ahora lo desarrollan voluntarios de todo el mundo.
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
 
-## Instalar Bootstrap
+## Install Bootstrap
 
-Para instalar Bootstrap tienes que añadir esto al `<head>` de tu fichero `.html` (`blog/templates/blog/post_list.html`):
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
 
-```html
-    <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-    <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
-```    
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-Esto no añade ningún fichero a tu proyecto. Simplemente apunta a ficheros que existen en Internet. Adelante, abre tu sitio web y actualiza la página. ¡Aquí está!
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
 
-![Figure 14.1][1]
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
 
- [1]: images/bootstrap1.png
+![Figure 14.1](images/bootstrap1.png)
 
-¡Se ve mucho mejor!
+Looking nicer already!
 
-## Ficheros estáticos en Django
+## Static files in Django
 
-Finalmente nos vamos a fijar en estas cosas que hemos estado llamando **ficheros estáticos**. Los ficheros estáticos son todos tus CSS e imágenes; ficheros que no son dinámicos, por lo que su contenido no depende del contexto de la petición y serán iguales para todos los usuarios.
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
 
-### Dónde poner los ficheros estáticos para Django
+### Where to put static files for Django
 
-Como has visto cuando hemos ejecutado `collectstatic` en el servidor, Django ya sabe dónde encontrar los ficheros estáticos para la aplicación "admin". Ahora necesitamos añadir algunos ficheros estáticos para nuestra propia aplicación, `blog`.
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
 
-Esto lo conseguimos creando una carpeta llamada `static` dentro de la aplicación blog:
+We do that by creating a folder called `static` inside the blog app:
 
     djangogirls
     ├── blog
     │   ├── migrations
-    │   └── static
+    │   ├── static
+    │   └── templates
     └── mysite
     
 
-Django encontrará automáticamente cualquier carpeta que se llame "static" dentro de las carpetas de tus aplicaciones y podrá utilizar su contenido como ficheros estáticos.
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
 
-## ¡Tu primer fichero CSS!
+## Your first CSS file!
 
-Crea un nuevo directorio llamado `css` dentro de tu directorio `static`. Para añadir tu propio estilo a tu página web, crea un nuevo fichero llamado `blog.css` dentro de este directorio `css`. ¿Lista?
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
 
     djangogirls
     └─── blog
@@ -61,234 +62,243 @@ Crea un nuevo directorio llamado `css` dentro de tu directorio `static`. Para a
                    └─── blog.css
     
 
-¡Es hora de escribir algo de CSS! Abre el fichero `blog/static/css/blog.css` en tu editor de código.
-
-No vamos a entrar mucho en la personalización y el aprendizaje de CSS aquí porque es bastante fácil y lo puedes aprender por tu cuenta después de este taller. Recomendamos enormemente hacer este [curso de HTML y CSS en Codecademy][2] para aprender todo lo que necesitas saber sobre cómo hacer tus sitios web más bonitos con CSS.
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
 
- [2]: https://www.codecademy.com/tracks/web
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
 
-Pero vamos a hacer un poco al menos. ¿Tal vez podríamos cambiar el color de nuestro título? Los ordenadores utilizan códigos especiales para entender los colores. Empiezan con `#` y les siguen 6 letras (A-F) y números (0-9). Puedes encontrar códigos de color, por ejemplo, aquí: http://www.colorpicker.com/. También puedes utilizar [colores predefinidos][3] utilizando su nombre en inglés, como `red` y `green`.
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
 
- [3]: http://www.w3schools.com/cssref/css_colornames.asp
+In your `blog/static/css/blog.css` file you should add the following code:
 
-En tu fichero `blog/static/css/blog.css` deberías añadir el siguiente código:
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
-    h1 a {
-        color: #FCA205;
-    }
-```    
+h1 a {
+    color: #FCA205;
+}
+```
 
-`h1 a` es un selector CSS. Quiere decir que estamos aplicando nuestros estilos a cualquier elemento `a` que se encuentre dentro de un elemento `h1` (por ejemplo cuando tenemos en código algo como: `<h1><a href="">enlace</a></h1>`). En este caso le estamos diciendo que cambie el color a `#FCA205`, que es naranja. Por supuesto, ¡puedes poner tu propio color aquí!
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
 
-En un fichero CSS definimos los estilos para los elementos del fichero HTML. Los elementos se identifican por el nombre del elemento (es decir, `a`, `h1`, `body`), el atributo `class` (clase) o el atributo `id` (identificador). Class e id son nombres que le asignas tú misma al elemento. Las clases definen grupos de elementos y los ids apuntan a elementos específicos. Por ejemplo, la siguiente etiqueta se puede identificar con CSS usando el nombre `a`, la clase `external_link` o el id `link_to_wiki_page`:
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
 
 ```html
-    <a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
-```    
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
 
-Puedes leer más sobre [selectores de CSS en w3schools][4].
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
 
- [4]: http://www.w3schools.com/cssref/css_selectors.asp
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
 
-También necesitamos decirle a nuestra plantilla HTML que hemos añadido CSS. Abre el fichero `blog/templates/blog/post_list.html` y añade esta línea justo al principio:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-    {% load staticfiles %}
-```    
+{% load staticfiles %}
+```
 
-Aquí sólo estamos cargando ficheros estáticos :). Luego, entre el `<head>` y `</head>`, después de los enlaces a los ficheros CSS de Bootstrap (el navegador lee los ficheros en el orden en que están, así que nuestro fichero podría sobrescribir partes del código de Bootstrap), añade la siguiente línea:
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-    <link rel="stylesheet" href="{% static 'css/blog.css' %}">
-```    
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
 
-Le acabamos de decir a nuestra plantilla dónde se encuentra nuestro fichero CSS.
+Your file should now look like this:
 
-Ahora tu fichero debería tener este aspecto:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-    {% load staticfiles %}
-    <html>
-        <head>
-            <title>Django Girls blog</title>
-            <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-            <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
-            <link rel="stylesheet" href="{% static 'css/blog.css' %}">
-        </head>
-        <body>
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
             <div>
-                <h1><a href="/">Django Girls Blog</a></h1>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
             </div>
-    
-            {% for post in posts %}
-                <div>
-                    <p>published: {{ post.published_date }}</p>
-                    <h1><a href="">{{ post.title }}</a></h1>
-                    <p>{{ post.text|linebreaksbr }}</p>
-                </div>
-            {% endfor %}
-        </body>
-    </html>
-```    
+        {% endfor %}
+    </body>
+</html>
+```
 
-De acuerdo, ¡guarda el fichero y actualiza el sitio!
+OK, save the file and refresh the site!
 
-![Figure 14.2][5]
+![Figure 14.2](images/color2.png)
 
- [5]: images/color2.png
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
 
-¡Buen trabajo! ¿Quizá nos gustaría darle un poco de aire a nuestro sitio web y aumentar también el margen en el lado izquierdo? ¡Vamos a intentarlo!
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
-    body {
-        padding-left: 15px;
-    }
-```    
+body {
+    padding-left: 15px;
+}
+```
 
-Añade esto a tu CSS, guarda el fichero y ¡mira cómo funciona!
+Add that to your CSS, save the file and see how it works!
 
-![Figure 14.3][6]
+![Figure 14.3](images/margin2.png)
 
- [6]: images/margin2.png
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
 
-¿Quizá podríamos personalizar la tipografía del título? Pega esto en la sección `<head>` del fichero `blog/templates/blog/post_list.html`:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-    <link href="https://fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
-```    
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
 
-Esta línea va a importar una tipografía llamada *Lobster* de Google Fonts (https://www.google.com/fonts).
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
 
-Ahora añade la línea `font-family: 'Lobster';` en el fichero CSS `blog/static/css/blog.css` dentro del bloque de declaración `h1 a` (el código entre llaves `{` y `}`) y actualiza la página:
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
-    h1 a {
-        color: #FCA205;
-        font-family: 'Lobster';
-    }
-```    
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
 
-![Figure 14.3][7]
+![Figure 14.3](images/font.png)
 
- [7]: images/font.png
+Great!
 
-¡Genial!
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
 
-Como se mencionó anteriormente, CSS tiene un concepto de clases que básicamente permite nombrar una parte del código HTML y aplicar estilos sólo a esta parte, sin afectar a otras. Es muy útil si tienes dos divs que hacen algo muy diferente (como el encabezado y la entrada) y no quieres que tengan el mismo aspecto.
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
 
-¡Adelante! Nombra algunas partes del código HTML. Añade una clase llamada `page-header` al `div` que contiene el encabezado, así:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-    <div class="page-header">
-        <h1><a href="/">Django Girls Blog</a></h1>
-    </div>
-```    
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-Y ahora añade la clase `post` al `div` que contiene una entrada del blog.
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
+{% for post in posts %}
     <div class="post">
         <p>published: {{ post.published_date }}</p>
         <h1><a href="">{{ post.title }}</a></h1>
         <p>{{ post.text|linebreaksbr }}</p>
     </div>
-```    
+{% endfor %}
+```
 
-Ahora añadiremos bloques de declaración a diferentes selectores. Los selectores que comienzan con `.` hacen referencia a las clases. Hay muchos tutoriales y explicaciones sobre CSS en la web que te ayudarán a entender el siguiente código. Por ahora, simplemente copia y pega este bloque de código en tu fichero `blog/static/css/blog.css`:
+in the `blog/templates/blog/post_list.html` with this:
 
-```css
-    .page-header {
-        background-color: #ff9400;
-        margin-top: 0;
-        padding: 20px 20px 20px 40px;
-    }
-    
-    .page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
-        color: #ffffff;
-        font-size: 36pt;
-        text-decoration: none;
-    }
-    
-    .content {
-        margin-left: 40px;
-    }
-    
-    h1, h2, h3, h4 {
-        font-family: 'Lobster', cursive;
-    }
-    
-    .date {
-        float: right;
-        color: #828282;
-    }
-    
-    .save {
-        float: right;
-    }
-    
-    .post-form textarea, .post-form input {
-        width: 100%;
-    }
-    
-    .top-menu, .top-menu:hover, .top-menu:visited {
-        color: #ffffff;
-        float: right;
-        font-size: 26pt;
-        margin-right: 20px;
-    }
-    
-    .post {
-        margin-bottom: 70px;
-    }
-    
-    .post h1 a, .post h1 a:visited {
-        color: #000000;
-    }
-```    
-
-Luego rodea el código HTML que muestra las entradas con las declaraciones de clases. Sustituye esto:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-    {% for post in posts %}
-        <div class="post">
-            <p>published: {{ post.published_date }}</p>
-            <h1><a href="">{{ post.title }}</a></h1>
-            <p>{{ post.text|linebreaksbr }}</p>
-        </div>
-    {% endfor %}
-```    
-
-en `blog/templates/blog/post_list.html` por esto:
-
-```html
-    <div class="content container">
-        <div class="row">
-            <div class="col-md-8">
-                {% for post in posts %}
-                    <div class="post">
-                        <div class="date">
-                            {{ post.published_date }}
-                        </div>
-                        <h1><a href="">{{ post.title }}</a></h1>
-                        <p>{{ post.text|linebreaksbr }}</p>
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
                     </div>
-                {% endfor %}
-            </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
         </div>
     </div>
-```    
-
-Guarda los ficheros y actualiza tu sitio.
+</div>
+```
 
-![Figure 14.4][8]
+Save those files and refresh your website.
 
- [8]: images/final.png
+![Figure 14.4](images/final.png)
 
-¡Bien! Se ve increíble, ¿verdad? En realidad el código que acabamos de pegar no es tan difícil de entender y deberías ser capaz de entender la mayoría sólo con leerlo.
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
 
-No tengas miedo de jugar un poco con este CSS e intentar cambiar algunas cosas. Si rompes algo, no te preocupes, ¡siempre puedes deshacerlo!
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
 
-De cualquier forma, te volvemos a recomendar que hagas el [curso de HTML y CSS de Codeacademy][2] como una tarea post-taller para que aprendas todo lo que necesitas saber para hacer tus sitios web más bonitos con CSS.
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
 
-¡¿Lista para el siguiente capítulo?! :)
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/es/deploy/README.md b/es/deploy/README.md
index c85530aff05..b44e2eaaf73 100755
--- a/es/deploy/README.md
+++ b/es/deploy/README.md
@@ -1,72 +1,59 @@
-# ¡Despliega!
+# Deploy!
 
-> **Nota**: El siguiente capítulo puede ser a veces un poco difícil de superar. Se persistente y acábalo. El despliegue es una parte importante del proceso en el desarrollo web. Este capítulo está situado en el medio del tutorial para que tu tutor pueda ayudarte a poner tu sitio web en línea, lo que puede ser un proceso algo más complicado. Esto significa que podrás acabar el tutorial por tu cuenta si se te acaba el tiempo.
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
 
-Hasta ahora tu sitio web estaba disponible sólo en tu ordenador, ¡ahora aprenderás cómo desplegarlo! El despliegue es el proceso de publicar tu aplicación en Internet para que la gente pueda acceder y ver tu aplicación :).
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
 
-Como ya has aprendido, un sitio web tiene que estar en un servidor. Hay muchos proveedores, pero usaremos uno que tiene un proceso de despliegue relativamente simple: [PythonAnywhere][1]. PythonAnywhere es gratis para pequeñas aplicaciones que no tienen demasiados visitantes, definitivamente suficiente para este caso.
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
- [1]: https://pythonanywhere.com/
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
 
-El otro servicio externo que vamos a utilizar es [GitHub][2], un servicio de alojamiento de código. Hay otras opciones por ahí, pero hoy en día casi todos los programadores tienen una cuenta de GitHub, ¡y ahora tú también la vas a tener!
-
- [2]: https://www.github.com
-
-Usaremos GitHub como paso intermedio para transportar nuestro código desde y hasta PythonAnywhere.
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
 
 # Git
 
-Git es un "sistema de control de versiones" usado por muchos programadores - es un sistema que registra los cambios en los archivos a través del tiempo de forma tal que puedas acceder a versiones específicas cuando lo desees. Es muy similar a la opción de "registrar cambios" en Microsoft Word, pero mucho más poderoso.
-
-## Instalar Git
-
-### Windows
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
 
-Puedes descargar Git de [git-scm.com][3]. Puedes hacer clic en "Next" para todos los pasos excepto en uno; en el quinto paso titulado "Adjusting your PATH environment", elije "Run Git and associated Unix tools from the Windows command-line" (la última opción). Aparte de eso, los valores por defecto funcionarán bien. "Checkout Windows-style, commit Unix-style line endings" también está bien.
+{% include "/deploy/install_git.md" %}
 
- [3]: https://git-scm.com/
+## Starting our Git repository
 
-### MacOS
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
 
-Descarga Git de [git-scm.com][3] y sigue las instrucciones.
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
 
-### Linux
-
-Si no lo tienes ya instalado, git debería estar disponible a través del administrador de paquetes, prueba con:
-
-    sudo apt-get install git
-    # o
-    sudo yum install git
-    
-
-## Iniciar nuestro repositorio Git
-
-Git rastrea los cambios realizados a un grupo determinado de ficheros en lo que llamamos un repositorio de código (o "repo" para abreviar). Iniciemos uno para nuestro proyecto. Abre la consola y ejecuta los siguientes comandos en el directorio de `djangogirls`:
-
-> **Nota**: Comprueba el directorio de trabajo actual con el comando `pwd` (OSX/Linux) o `cd` (Windows) antes de inicializar el repositorio. Deberías estar en la carpeta `djangogirls`.
+{% filename %}command-line{% endfilename %}
 
     $ git init
     Initialized empty Git repository in ~/djangogirls/.git/
-    $ git config user.name "Tu nombre"
-    $ git config user.email tú@ejemplo.com
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
     
 
-Inicializar el repositorio git es algo que sólo necesitamos hacer una vez por proyecto (y no tendrás que volver a poner tu usuario y correo electrónico nunca más)
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
 
-Git llevará un registro de los cambios realizados en todos los ficheros y carpetas en este directorio, pero hay algunos ficheros que queremos que ignore. Esto lo hacemos creando un fichero llamado `.gitignore` en el directorio base. Abre tu editor y crea un nuevo fichero con el siguiente contenido:
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
 
     *.pyc
+    *~
     __pycache__
     myvenv
     db.sqlite3
+    /static
     .DS_Store
     
 
-Y guárdalo como `.gitignore` en la primera carpeta "djangogirls".
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
 
-> **Nota**: ¡El punto al principio del nombre del fichero es importante! Si tienes dificultades para crearlo (a los Mac no les gusta que crees ficheros que empiezan por punto desde Finder, por ejemplo), usa la opción "Guardar como" en tu editor, eso no falla.
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
 
-Es buena idea utilizar el comando `git status` antes de `git add` o cuando no estés segura de lo que va a hacer, para evitar cualquier sorpresa (por ejemplo, añadir o hacer commit de ficheros no deseados). El comando `git status` devuelve información sobre los ficheros sin seguimiento (untracked), modificados, preparados (staged), el estado de la rama y mucho más. La salida debería ser similar a:
+{% filename %}command-line{% endfilename %}
 
     $ git status
     On branch master
@@ -76,243 +63,198 @@ Es buena idea utilizar el comando `git status` antes de `git add` o cuando no es
     Untracked files:
       (use "git add <file>..." to include in what will be committed)
     
-    .gitignore
-    blog/
-    manage.py
-    mysite/
+            .gitignore
+            blog/
+            manage.py
+            mysite/
     
     nothing added to commit but untracked files present (use "git add" to track)
     
 
-Y finalmente guardamos nuestros cambios. Ve a la consola y ejecuta estos comandos:
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
 
     $ git add --all .
-    $ git commit -m "Mi app Django Girls, primer commit"
+    $ git commit -m "My Django Girls app, first commit"
      [...]
      13 files changed, 200 insertions(+)
      create mode 100644 .gitignore
      [...]
      create mode 100644 mysite/wsgi.py
+     ```
     
-
-## Enviar nuestro código a GitHub
-
-Visita [GitHub.com][4] y registra una nueva cuenta de usuario gratuita. Luego, crea un nuevo repositorio con el nombre "my-first-blog". Deja desmarcada la opción "Initialise with a README", deja la opción .gitignore en blanco (lo hemos hecho a mano) y deja la licencia como "None".
-
- [4]: https://www.github.com
-
-![][5]
-
- [5]: images/new_github_repo.png
-
-> **Nota** El nombre `my-first-blog` es importante. Podrías elegir otra cosa, pero va a aparecer muchas veces en las instrucciones que siguen y tendrías que sustituirlo cada vez. Probablemente sea más sencillo quedarte con el nombre `my-first-blog`.
-
-En la próxima pantalla verás la URL para clonar tu repositorio. Elige la versión "HTTPS", cópiala y en un momento la pegaremos en la consola:
-
-![][6]
-
- [6]: images/github_get_repo_url_screenshot.png
-
-Ahora tenemos que conectar el repositorio Git de tu ordenador con el que está en GitHub.
-
-    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
-    $ git push -u origin master
     
-
-Escribe tu nombre de usuario y contraseña de GitHub y deberías ver algo así:
-
-    Username for 'https://github.com': hjwp
-    Password for 'https://hjwp@github.com':
-    Counting objects: 6, done.
-    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
-    Total 3 (delta 0), reused 0 (delta 0)
-    To https://github.com/hjwp/my-first-blog.git
-     * [new branch]      master -> master
-    Branch master set up to track remote branch master from origin.
+    ## Pushing your code to GitHub
     
-
-<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extention -->
-
-Tu código está ahora en GitHub. ¡Ve y míralo! Verás que está en buena compañía; [Django][7], el [Tutorial de Django Girls][8] y muchos otros grandes proyectos de código abierto también alojan su código en GitHub :)
-
- [7]: https://github.com/django/django
- [8]: https://github.com/DjangoGirls/tutorial
-
-# Configurar nuestro blog en PythonAnywhere
-
-Es hora de registrar una cuenta gratuita de tipo "Beginner" en PythonAnywhere.
-
-*   [www.pythonanywhere.com][9]
-
- [9]: https://www.pythonanywhere.com/
-
-> **Nota**: Cuando elijas tu nombre de usuario ten en cuenta que la URL de tu blog tendrá la forma `nombredeusuario.pythonanywhere.com`, así que o bien elije tu propio apodo o bien un nombre que describa sobre qué trata tu blog.
-
-## Bajar nuestro código en PythonAnywhere
-
-Cuando te hayas registrado en PythonAnywhere serás redirigida a tu panel de control o página "Consoles". Elije la opción para iniciar una consola "Bash", que es la versión PythonAnywhere de una consola, como la que tienes en tu PC
-
-> **Nota**: PythonAnywhere está basado en Linux, por lo que si estás en Windows la consola será un poco distinta a la que tienes en tu ordenador.
-
-Descarguemos nuestro código desde GitHub a PythonAnywhere mediante la creación de un "clon" del repositorio. Escribe lo siguiente en la consola de PythonAnywhere:
-
-    $ git clone https://github.com/<tu-usuario-github>/my-first-blog.git
-
-> **Nota**: No pongas los símbolos < y >, solo escribe tu usuario.
-
-Esto va a descargar una copia de tu código en PythonAnywhere. Compruébalo escribiendo:
-
-    $ tree my-first-blog
-    my-first-blog/
-    ├── blog
-    │   ├── __init__.py
-    │   ├── admin.py
-    │   ├── migrations
-    │   │   ├── 0001_initial.py
-    │   │   └── __init__.py
-    │   ├── models.py
-    │   ├── tests.py
-    │   └── views.py
-    ├── manage.py
-    └── mysite
-        ├── __init__.py
-        ├── settings.py
-        ├── urls.py
-        └── wsgi.py
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
     
-
-### Crear un virtualenv en PythonAnywhere
-
-Tal y como hiciste en tu propio ordenador, puedes crear un virtualenv en PythonAnywhere. En la consola Bash, escribe:
-
-    20:20 ~ $ cd my-first-blog
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
     
-    20:20 ~ $ virtualenv --python=python3.4 myvenv
-    Running virtualenv with interpreter /usr/bin/python3.4
-    [...]
-    Installing setuptools, pip...done.
+    <img src="images/new_github_repo.png" />
     
-    20:20 ~ $ source myvenv/bin/activate
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
     
-    (myvenv)20:20 ~ $  pip install django==1.8 whitenoise
-    Collecting django
-    [...]
-    Successfully installed django-1.8 whitenoise-1.0.6
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
     
 
-<!--TODO: think about using requirements.txt instead of pip install.-->
-
-### Recopilar ficheros estáticos
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
 
-¿Te estabas preguntando qué es eso de "whitenoise"? Es una herramienta para servir los llamados "ficheros estáticos". Los ficheros estáticos funcionan de distinta forma en los servidores en comparación con cómo lo hacen en nuestro propio ordenador y necesitamos una herramienta como "whitenoise" para servirlos.
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
 
-Aprenderemos un poco más sobre los ficheros estáticos más adelante, cuando editemos el CSS de nuestro sitio.
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
 
-Por ahora sólo necesitamos ejecutar en el servidor un comando adicional llamado "collectstatic". Le dice a Django que recopile todos los ficheros estáticos que necesita en el servidor. Por el momento, principalmente son los ficheros estáticos que hacen que el panel de administración esté bonito.
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
 
-    20:20 ~ $ python manage.py collectstatic
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
     
-    You have requested to collect static files at the destination
-    location as specified in your settings:
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
     
-        /home/edith/my-first-blog/static
     
-    This will overwrite existing files!
-    Are you sure you want to do this?
+    # Setting up our blog on PythonAnywhere
     
-    Type 'yes' to continue, or 'no' to cancel: yes
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
     
-
-Escribe "yes", ¡y ahí va! ¿No te encanta hacer que las computadoras impriman páginas y páginas de texto imposible de entender? Siempre hago ruiditos para acompañarlo. Brp, brp brp...
-
-    Copying '/home/edith/.virtualenvs/myvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/actions.min.js'
-    Copying '/home/edith/.virtualenvs/myvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/inlines.min.js'
-    [...]
-    Copying '/home/edith/.virtualenvs/myvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/changelists.css'
-    Copying '/home/edith/.virtualenvs/myvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/base.css'
-    62 static files copied to '/home/edith/my-first-blog/static'.
+    {% include "/deploy/signup_pythonanywhere.md" %}
     
-
-### Crear la base de datos en PythonAnywhere
-
-Aquí hay otra cosa que es diferente entre tu ordenador y el servidor: éste utiliza una base de datos diferente. Por lo tanto, las cuentas de usuario y las entradas pueden ser diferentes en el servidor y en tu ordenador.
-
-Así que inicializamos la base de datos en el servidor igual que lo hicimos en nuestro ordenador, con `migrate` y `createsuperuser`:
-
-    (myvenv)20:20 ~ $ python manage.py migrate
-    Operations to perform:
-    [...]
-      Applying sessions.0001_initial... OK
     
+    ## Pulling our code down on PythonAnywhere
     
-    (myvenv)20:20 ~ $ python manage.py createsuperuser
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
     
 
-## Publicar nuestro blog como una aplicación web
-
-Ahora que nuestro código está en PythonAnywhere, el virtualenv está listo, los ficheros estáticos han sido recopilados y la base de datos está inicializada, estamos listas para publicarla como una aplicación web.
-
-Haz clic en el logo de PythonAnywhere para volver al panel principal, haz clic en la pestaña **Web** y pincha en **Add a new web app**.
-
-En la ventana de diálogo, después de confirmar el nombre de dominio, elije **manual configuration** (configuración manual) (NB la opción "Django" *no*). Luego, elije **Python 3.4** y haz clic en "Next" para terminar con el asistente.
-
-> **Nota** asegúrate de elegir la opción de "Manual configuration", no la de "Django". Somos demasiado buenas para la configuración por defecto de Django de PythonAnywhere ;-)
-
-### Configurar el virtualenv
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
 
-Serás redirigida a la pantalla de configuración de PythonAnywhere para tu aplicación web, a la que deberás acceder cada vez que quieras hacer cambios en la aplicación del servidor.
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-![][10]
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
 
- [10]: images/pythonanywhere_web_tab_virtualenv.png
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-En la sección "Virtualenv", haz clic en el texto rojo que dice "Enter the path to a virtualenv" (Introduce la ruta a un virtualenv) y escribe: `/home/<tu-usuario>/my-first-blog/myvenv/`
+$ cd my-first-blog
 
-> **Nota**: sustituye tu propio nombre de usuario como corresponda. Si cometes un error, PythonAnywhere te mostrará una pequeña advertencia. ¡No olvides no teclear los simbolos < y >!
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
 
-### Configurar el fichero WSGI
+$ source myvenv/bin/activate
 
-Django funciona utilizando el "protocolo WSGI", un estándar para servir sitios web usando Python, que PythonAnywhere soporta. La forma de configurar PythonAnywhere para que reconozca nuestro blog Django es editar un fichero de configuración WSGI.
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
 
-Haz clic en el enlace "WSGI configuration file" (en la sección "Code" en la parte de arriba de la página; se llamará algo parecido a `/var/www/<tu-usuario>_pythonanywhere_com_wsgi.py`) y te redirigirá al editor.
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-Elimina todo el contenido actual y reemplázalo con algo como esto:
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
 
-``` python
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
     import os
     import sys
     
-    path = '/home/<tu-usuario>/my-first-blog'  # aquí utiliza tu propio usuario, sin los simbolos < y >
+    path = os.path.expanduser('~/my-first-blog')
     if path not in sys.path:
         sys.path.append(path)
     
     os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
     
     from django.core.wsgi import get_wsgi_application
-    from whitenoise.django import DjangoWhiteNoise
-    application = DjangoWhiteNoise(get_wsgi_application())
-```    
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
 
-> **Nota** no olvides sustituir tu propio nombre de usuario donde dice `<tu-usuario>`
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
 
-Este fichero se encarga de decirle a PythonAnywhere dónde vive nuestra aplicación web y cómo se llama el fichero de configuración de Django. También configura la herramienta para ficheros estáticos "whitenoise".
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
 
-Dale a **Save** y vuelve a la pestaña **Web**.
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
 
-¡Todo listo! Dale al botón verde grande que dice **Reload** y podrás ver tu aplicación. Verás un enlace a ella en la parte de arriba de la página.
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
 
-## Consejos de depuración
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
 
-Si aparece un error cuando intentas visitar tu sitio, el primer lugar que deberás revisar para obtener información de depuración es el **error log**; encontrarás un enlace a él en la pestaña Web de PythonAnywhere. Mira a ver si hay algún mensaje de error ahí. Los más recientes están al final. Los problemas más comunes incluyen
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
 
-*   olvidar alguno de los pasos que hicimos en la consola: crear el virtualenv, activarlo, instalar Django en él, ejecutar collectstatic, inicializar la base de datos
-*   cometer un error en la ruta del virtualenv en la pestaña Web; suele haber un mensajito de error de color rojo, si hay algún problema
-*   cometer un error en el fichero de configuración WSGI; ¿has puesto bien la ruta a la carpeta my-first-blog?
+And remember, your coach is here to help!
 
-¡Tu tutor está ahí para ayudar!
+# You are live!
 
-# ¡Estás en vivo!
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
 
-La página por defecto de tu sitio debería decir "Welcome to Django", igual que en tu PC local. Intenta añadir `/admin/` al final de la URL y te redirigirá al panel de administración. Ingresa con tu nombre de usuario y contraseña y verás que puedes añadir nuevas entradas en el servidor.
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
 
-*¡Buen trabajo!* - los despliegues en el servidor son una de las partes más complejas del desarrollo web y muchas veces a la gente le cuesta varios días tenerlo funcionando. Pero tú tienes tu sitio en vivo, en Internet de verdad, ¡así como suena!
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/es/deploy/install_git.md b/es/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/es/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/es/deploy/signup_pythonanywhere.md b/es/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/es/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/es/django/README.md b/es/django/README.md
index 782c575948f..c62c145305b 100755
--- a/es/django/README.md
+++ b/es/django/README.md
@@ -1,27 +1,27 @@
-# ¿Qué es Django?
+# What is Django?
 
-Django (*gdh/ˈdʒæŋɡoʊ/jang-goh*) es un framework para aplicaciones web gratuito y open source, escrito en Python. Es un WEB framework - un conjunto de componentes que te ayudan a desarrollar sitios web más fácil y rápidamente.
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
 
-Verás, cuando estás construyendo un sitio web, frecuentemente necesitas un conjunto de componentes similares: una manera de manejar la autenticación de usuarios (registrarse, iniciar sesión, cerrar sesión), un panel de administración para tu sitio web, formularios, una forma de subir archivos, etc.
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
 
-Por suerte para ti, hace tiempo varias personas notaron que los desarrolladores web enfrentan problemas similares cuando construyen un sitio nuevo, por eso juntaron cabezas y crearon frameworks (Django es uno de ellos) que te ofrecen componentes listos para usarse.
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
 
-Los frameworks existen para ahorrarte tener que reinventar la rueda y ayudarte a aliviar la carga cuando construyes un sitio.
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
 
-## ¿Por qué necesitas un framework?
+## Why do you need a framework?
 
-Para entender para que es Django, necesitamos mirar mas de cerca a los servidores. Lo primero es que el servidor necesita saber que quieres que te sirva una página web.
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
 
-Imagina un buzón (puerto) el cual es monitoreado por cartas entrantes (peticiones). Esto es realizado por un servidor web. El servidor web lee la carta, y envía una respuesta con una página web. Pero cuando quieres enviar algo, tienes que tener algún contenido. Y Django es algo que te ayuda a crear el contenido.
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
 
-## ¿Qué sucede cuando alguien solicita una página web de tu servidor?
+## What happens when someone requests a website from your server?
 
-Cuando llega una petición a un servidor web, ésta es pasada a Django, el cual intenta averiguar lo que realmente es solicitado. Toma primero una dirección de página web y trata de averiguar qué hacer. Esta parte es realizada por el **urlresolver** de Django (ten en cuenta que la dirección de un sitio web es llamada URL - Uniform Resource Locator - así que el nombre *urlresolver* tiene sentido). Este no es muy inteligente - toma una lista de patrones y trata de encontrar la URL. Django comprueba los patrones de arriba hacia abajo y si algo coincide entonces Django le pasa la solicitud a la función asociada (que se llama *vista*).
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
 
-Imagina a un cartero llevando una carta. Ella está caminando por la calle y comprueba cada número de casa con el que está en la carta. Si coincide, ella deja la carta allí. ¡Así es como funciona el urlresolver!
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
 
-En la función de *vista* se hacen todas las cosas interesantes: podemos mirar a una base de datos para buscar alguna información. ¿Tal vez el usuario pidió cambiar algo en los datos? Como una carta diciendo "Por favor cambia la descripción de mi trabajo." La *vista* puede comprobar si tenes permitido hacer eso, entonces actualizar la descripción del trabajo para ti y devolverte un mensaje: "¡hecho!". Entonces la *vista* genera una respuesta y Django puede enviarla al navegador del usuario.
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
 
-Por supuesto, la descripción anterior esta simplificada un poco, pero no necesitas saber todas las cosas técnicas aun. Tener una idea general es suficiente.
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
 
-Así que en lugar de meternos demasiado en los detalles, ¡simplemente comenzaremos creando algo con Django y aprenderemos todas las piezas importantes en el camino!
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/es/django_admin/README.md b/es/django_admin/README.md
index c340823c749..46a5afbb500 100755
--- a/es/django_admin/README.md
+++ b/es/django_admin/README.md
@@ -1,27 +1,40 @@
-# Administrador de Django
+# Django admin
 
-Para agregar, editar y borrar los posts que hemos modelado, utilizaremos el administrador de Django.
+To add, edit and delete the posts we've just modeled, we will use Django admin.
 
-Vamos a abrir el archivo `blog/admin.py` y reemplazar su contenido con esto:
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
 
 ```python
-    from django.contrib import admin
-    from .models import Post
-    
-    admin.site.register(Post)
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
 ```
 
-Como puedes ver, importamos (incluimos) el modelo Post definido en el capítulo anterior. Para hacer nuestro modelo visible en la página del administrador, tenemos que registrar el modelo con `admin.site.register(Post)`.
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
 
-Ok, es hora de ver tu modelo Post. Recuerda ejecutar `python manage.py runserver` en la consola para correr el servidor web. Ve al navegador y tipea la dirección http://127.0.0.1:8000/admin/. Verás una página de ingreso como la que sigue:
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
 
-![Página de inicio de sesión][1]
+![Login page](images/login_page2.png)
 
- [1]: images/login_page2.png
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
 
-Para poder ingresar deberás crear un *superusuario* - un usuario que tiene control sobre todo lo que hay en el sitio. Vuelve hacia atrás a tu línea de comandos y tipea `python manage.py createsuperuser`, presiona enter y tipea tu nombre de usuario (en minúsculas, sin espacios), dirección de email y contraseña cuando sean requeridos. No te preocupes que no puedes ver tu contraseña mientras la tipeas - así es como debe ser. Simplemente tipéala y presiona 'Enter' para continuar. La salida de este comando debería verse así (nombre de usuario y email deberían ser los tuyos):
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
     Username: admin
     Email address: admin@admin.com
     Password:
@@ -29,20 +42,16 @@ Para poder ingresar deberás crear un *superusuario* - un usuario que tiene cont
     Superuser created successfully.
     
 
-Vuelve a tu navegador e ingresa con las credenciales de super usuario que elegiste, ahora deberías poder ver el panel de administración de Django.
-
-![Administrador de Django][2]
-
- [2]: images/django_admin3.png
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
 
-Ve a Posts y experimenta un poco con esto. Agrega cinco o seis posts del blog. No te preocupes por el contenido - puedes simplemente copiar y pegar texto de este tutorial en el contenido de tus posts para ahorrar tiempo :).
+![Django admin](images/django_admin3.png)
 
-Asegúrate de que por lo menos dos o tres posts (pero no todos) tienen la fecha de publicación. Será útil luego.
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
 
-![Administrador de Django][3]
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
 
- [3]: images/edit_post3.png
+![Django admin](images/edit_post3.png)
 
-Si quieres saber más sobre el administrador de Django, puedes visitar la documentación de Django: https://docs.djangoproject.com/en/1.8/ref/contrib/admin/
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
 
-Este probablemente sea un buen momento para tomar un café (o té) o algo para comer y re-energizarte. Creaste tu primer modelo de Django - ¡mereces un pequeño recreo!
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/es/django_forms/README.md b/es/django_forms/README.md
index 1e4b404124e..1d9efebffe4 100755
--- a/es/django_forms/README.md
+++ b/es/django_forms/README.md
@@ -1,378 +1,447 @@
-# Formularios en Django
+# Django Forms
 
-Lo último que haremos en nuestro website es crear un apartado para agregar y editar posts en el blog. Django `admin` está bien, pero es bastante difícil de personalizar y hacerlo bonito. Con `forms` tendremos un poder absoluto sobre nuestra interfaz - ¡podemos hacer casi cualquier cosa que podamos imaginar!
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
 
-Lo bueno de Django forms es que podemos definirlo desde cero o creando un `ModelForm` y se guardará el resultado del formulario en el modelo.
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
 
-Esto es exactamente lo que queremos hacer: crearemos un formulario para nuestro modelo `Post`.
+This is exactly what we want to do: we will create a form for our `Post` model.
 
-Como cada parte importante de Django, forms tienen su propio archivo: `forms.py`.
+Like every important part of Django, forms have their own file: `forms.py`.
 
-Tenemos que crear un archivo con este nombre en el directorio `blog`.
+We need to create a file with this name in the `blog` directory.
 
     blog
        └── forms.py
     
 
-Ok, vamos a abrirlo y vamos a escribir el siguiente código:
-    
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
 ```python
-    from django import forms
-    
-    from .models import Post
-    
-    class PostForm(forms.ModelForm):
-    
-        class Meta:
-            model = Post
-            fields = ('title', 'text',)
-```    
+from django import forms
 
-Primero necesitamos importar Django forms (`from django import forms`) y, obviamente, nuestro modelo `Post` (`from .models import Post`).
+from .models import Post
 
-`PostForm`, como probablemente sospechas, es el nombre del formulario. Necesitamos decirle a Django que este formulario es un `ModelForm` (así Django hará algo de magia para nosotros) - `forms.ModelForm` es responsable de ello.
+class PostForm(forms.ModelForm):
 
-A continuación, tenemos `class Meta`, donde le decimos a Django qué modelo debe utilizar para crear este formulario (`model = Post`).
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
 
-Finalmente, podemos decir que campo(s) queremos en nuestro formulario. En este escenario sólo queremos `title` y `text` - `author` será la persona que se ha autenticado (¡tú!) y `created_date` se definirá automáticamente cuando creemos un post (es decir en el código), ¿si?
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
 
-¡Y eso es todo! Todo lo que necesitamos hacer ahora es usar el formulario en una *view* y mostrarla en una plantilla.
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
 
-Una vez más vamos a crear: un enlace a la página, una dirección URL, una vista y una plantilla.
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
 
-## Enlace a una página con el formulario
+So once again we will create a link to the page, a URL, a view and a template.
 
-Es hora de abrir `blog/templates/blog/base.html`. Vamos a añadir un enlace en `div` llamado `page-header`:
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
-    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
-```    
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
 
-Ten en cuenta que queremos llamar a nuestra nueva vista `post_new`.
+After adding the line, your HTML file should now look like this:
 
-Después de agregar la línea, tu archivo html debería tener este aspecto:
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
-    {% load staticfiles %}
-    <html>
-        <head>
-            <title>Django Girls blog</title>
-            <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-            <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
-            <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
-            <link rel="stylesheet" href="{% static 'css/blog.css' %}">
-        </head>
-        <body>
-            <div class="page-header">
-                <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
-                <h1><a href="/">Django Girls Blog</a></h1>
-            </div>
-            <div class="content container">
-                <div class="row">
-                    <div class="col-md-8">
-                        {% block content %}
-                        {% endblock %}
-                    </div>
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
                 </div>
             </div>
-        </body>
-    </html>
-```   
+        </div>
+    </body>
+</html>
+```
 
-Luego de guardar y actualizar la página `http://127.0.0.1:8000` obviamente verás un error `NoReverseMatch` familiar, ¿verdad?
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
 
 ## URL
 
-Abrimos `blog/urls.py` y añadimos una línea:
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
-        url(r'^post/new/$', views.post_new, name='post_new'),
-```    
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
 
-Y el código final tendrá este aspecto:
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
-    from django.conf.urls import url
-    from . import views
-    
-    urlpatterns = [
-        url(r'^$', views.post_list),
-        url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail),
-        url(r'^post/new/$', views.post_new, name='post_new'),
-    ]
-```    
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
 
-Después de actualizar el sitio, veremos un `AttributeError`, puesto que no tenemos la vista `post_new` implementada. Vamos a añadirla ahora.
+## post_new view
 
-## Vista post_new
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
 
-Es el momento de abrir el archivo `blog/views.py` y agregar las siguientes líneas al resto de las filas `from`:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    from .forms import PostForm
-```    
+from .forms import PostForm
+```
+
+And then our *view*:
 
-y nuestra *vista*:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    def post_new(request):
-        form = PostForm()
-        return render(request, 'blog/post_edit.html', {'form': form})
-```    
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
 
-Para crear un nuevo formulario `Post`, tenemos que llamar a `PostForm()` y pasarlo a la plantilla. Volveremos a esta *vista* pero, por ahora, vamos a crear rápidamente una plantilla para el formulario.
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
 
-## Plantilla
+## Template
 
-Tenemos que crear un archivo `post_edit.html` en el directorio `blog/templates/blog`. Para hacer que un formulario funcione necesitamos varias cosas:
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
 
-*   tenemos que mostrar el formulario. Podemos hacerlo, por ejemplo, con un simple `{% raw %}{{ form.as_p }}{% endraw %}`.
-*   la línea anterior tiene que estar dentro de una etiqueta de formulario HTML: `<form method="POST">...</form>`
-*   necesitamos un botón `Guardar`. Lo hacemos con un botón HTML: `<button type='submit'>Save</button>`
-*   y finalmente justo después de la apertura de `<form...>` necesitamos agregar `{% raw %}{% csrf_token %}{% endraw %}`. ¡Esto es muy importante ya que hace que tus formularios sean seguros! Django se quejará si te olvidas de esta parte cuando intentes guardar el formulario.
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
 
-![CSFR Forbidden page][1]
+![CSFR Forbidden page](images/csrf2.png)
 
- [1]: images/csrf2.png
+OK, so let's see how the HTML in `post_edit.html` should look:
 
-Bueno, vamos a ver cómo quedará el HTML en `post_edit.html`:
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
 
 ```html
-    {% extends 'blog/base.html' %}
-    
-    {% block content %}
-        <h1>New post</h1>
-        <form method="POST" class="post-form">{% csrf_token %}
-            {{ form.as_p }}
-            <button type="submit" class="save btn btn-default">Save</button>
-        </form>
-    {% endblock %}
-```    
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
 
-¡Es hora de actualizar! ¡Si! ¡Tu formulario se muestra!
+Time to refresh! Yay! Your form is displayed!
 
-![Nuevo formulario][2]
+![New form](images/new_form2.png)
 
- [2]: images/new_form2.png
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
 
-Pero, ¡un momento! Si escribes algo en los campos `títle` y `text` y tratas de guardar los cambios - ¿qué pasará?
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
 
-¡Nada! Una vez más estamos en la misma página y el texto se ha ido... no se añade ningún post nuevo. Entonces, ¿qué ha ido mal?
+The answer is: nothing. We need to do a little bit more work in our *view*.
 
-La respuesta es: nada. Tenemos que trabajar un poco más en nuestra *vista*.
+## Saving the form
 
-## Guardar el formulario
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
 
-Abre `blog/views.py` una vez más. Actualmente, lo que tenemos en la vista `post_new` es:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    def post_new(request):
-        form = PostForm()
-        return render(request, 'blog/post_edit.html', {'form': form})
-```    
-
-Cuando enviamos el formulario somos redirigidos a la misma vista, pero esta vez tenemos algunos datos adicionales en `request`, más específicamente en `request.POST` (el nombre no tiene nada que ver con un post del blog, se refiere a que estamos "publicando" -en inglés, posting- datos). ¿Recuerdas que en el archivo HTML la definición de `<form>` tenía la variable `method="POST"`? Todos los campos del formulario estan ahora en `request.POST`. No deberías renombrar la variable `POST` (el único nombre que también es válido para la variable `method` es `GET`, pero no tenemos tiempo para explicar cuál es la diferencia).
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
 
-En nuestra *view* tenemos dos posibles situaciones a contemplar. Primero: cuando accedemos a la página por primera vez y queremos un formulario en blanco. Segundo: cuando volvemos a la *view* con los datos del formulario que acabamos de escribir. Así que tenemos que añadir una condición (utilizaremos `if` para eso).
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
 
-```python
-    if request.method == "POST":
-        [...]
-    else:
-        form = PostForm()
-```   
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
 
-Es hora de llenar los puntos `[...]`. Si el `method` es `POST` queremos construir el `PostForm` con los datos del formulario, ¿no? Lo haremos con:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    form = PostForm(request.POST)
-```    
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
 
-Fácil! Lo siguiente es verificar si el formulario es correcto (todos los campos necesarios están definidos y no hay valores incorrectos). Lo hacemos con `form.is_valid()`.
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
 
-Comprobamos que el formulario es válido y, si es así, ¡lo podemos salvar!
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    if form.is_valid():
-        post = form.save(commit=False)
-        post.author = request.user
-        post.save()
-```    
+form = PostForm(request.POST)
+```
 
-Básicamente, tenemos que hacer dos cosas aquí: guardamos el formulario con `form.save` y añadimos un autor (ya que no había ningún campo de `author` en el `PostForm` y este campo es obligatorio). `commit=False` significa que no queremos guardar el modelo `Post` todavía - queremos añadir el autor primero. La mayoría de las veces utilizarás `form.save()`, sin `commit=False`, pero en este caso, tenemos que hacerlo. `post.save()` conservará los cambios (añadiendo el autor) y se creará una nuevo post en el blog.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
 
-Por último, sería genial si podemos inmediatamente ir a la página `post_detail` del nuevo post de blog, ¿no? Para hacerlo necesitamos importar algo más:
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    from django.shortcuts import redirect
-```    
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
 
-Agrégalo al principio del archivo. Y ahora podemos decir: vé a la página `post_detail` del post recién creado.
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
 
-```python
-    return redirect('post_detail', pk=post.pk)
-```    
-Si este paso te da un error "NoReverseMatch", es debido a que la url no ha sido nombrada.
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
 
-En el archivo `blog/urls.py` Cambia lo siguiente:
 ```python
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail)
+from django.shortcuts import redirect
 ```
-por
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail,  name='post_detail')
+return redirect('post_detail', pk=post.pk)
 ```
 
-`post_detail` es el nombre de la vista a la que queremos ir. ¿Recuerdas que esta *view* requiere una variable `pk`? Para pasarlo a las vistas utilizamos `pk=post.pk`, donde `post` es el post recién creado.
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
 
-Bien, hablamos mucho, pero probablemente queremos ver como se ve ahora la *vista*, ¿verdad?
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    def post_new(request):
-        if request.method == "POST":
-            form = PostForm(request.POST)
-            if form.is_valid():
-                post = form.save(commit=False)
-                post.author = request.user
-                post.published_date = timezone.now()
-                post.save()
-                return redirect('post_detail', pk=post.pk)
-        else:
-            form = PostForm()
-        return render(request, 'blog/post_edit.html', {'form': form})
-```    
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
 
-Vamos a ver si funciona. Ve a la página http://127.0.0.1:8000/post/new/, añade un `title` y un `text`, guardalo... ¡y voilà! Se añade el nuevo post al blog y se nos redirige a la página de `post_detail`.
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
 
-Probablemente has visto que no hemos definido la fecha de publicación. Vamos a introducir un *botón publicar* en **Django Girls Tutorial: Extensions**.
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
 
-¡Eso es genial!
+That is awesome!
 
-## Validación de formularios
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
 
-Ahora, vamos a enseñarte qué tan bueno es Django forms. Un post del blog debe tener los campos `title` y `text`. En nuestro modelo `Post` no dijimos (a diferencia de `published_date`) que estos campos son requeridos, así que Django, por defecto, espera que estén definidos.
+![Logged in error](images/post_create_error.png)
 
-Trata de guardar el formulario sin `title` y `text`. ¡Adivina qué pasará!
+## Form validation
 
-![Validación de formularios][3]
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
 
- [3]: images/form_validation2.png
+Try to save the form without `title` and `text`. Guess what will happen!
 
-Django se encarga de validar que todos los campos en el formulario estén correctos. ¿No es genial?
+![Form validation](images/form_validation2.png)
 
-> Como recientemente hemos utilizado la interfaz de administrador de Django, el sistema piensa que estamos conectadas. Hay algunas situaciones que podrían llevarnos a desconectarnos (cerrando el navegador, reiniciando la base de datos, etc.). Si estás recibiendo errores al crear un post que indican la falta de inicio de sesión de usuario, dirígete a la página de administración `http://127.0.0.1:8000/admin` e inicia sesión nuevamente. Esto resolverá el problema temporalmente. Hay un arreglo permanente esperándote en el capítulo **Tarea: ¡Añadir seguridad a tu sitio web!** después del tutorial principal.
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
 
-![Error de inicio de sesión][4]
+## Edit form
 
- [4]: images/post_create_error.png
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
 
-## Editar el formulario
+Open `blog/templates/blog/post_detail.html` and add the line
 
-Ahora sabemos cómo agregar un nuevo formulario. Pero, ¿qué pasa si queremos editar uno existente? Es muy similar a lo que acabamos de hacer. Vamos a crear algunas cosas importantes rápidamente (si no entiendes algo, pregúntale a tu tutor o revisa lo capítulos anteriores, son temas que ya hemos cubierto).
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
-Abre el archivo `blog/templates/blog/post_detail.html` y añade esta línea:
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
 
-```python
-    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
-```    
+so that the template will look like this:
 
-para que la plantilla quede:
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
-        {% extends 'blog/base.html' %}
-    
-    {% block content %}
-        <div class="date">
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
         {% if post.published_date %}
-            {{ post.published_date }}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
         {% endif %}
         <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
-        </div>
         <h1>{{ post.title }}</h1>
         <p>{{ post.text|linebreaksbr }}</p>
-    {% endblock %}
-```    
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
 
-En el archivo `blog/urls.py` añadimos esta línea:
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
-        url(r'^post/(?P<pk>[0-9]+)/edit/$', views.post_edit, name='post_edit'),
-```    
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
 
-Vamos a reusar la plantilla `blog/templates/blog/post_edit.html`, así que lo último que nos falta es una *view*.
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
 
-Abramos el archivo `blog/views.py` y añadamos al final esta línea:
+Let's open `blog/views.py` and add this at the very end of the file:
 
-```python
-    def post_edit(request, pk):
-        post = get_object_or_404(Post, pk=pk)
-        if request.method == "POST":
-            form = PostForm(request.POST, instance=post)
-            if form.is_valid():
-                post = form.save(commit=False)
-                post.author = request.user
-                post.save()
-                return redirect('post_detail', pk=post.pk)
-        else:
-            form = PostForm(instance=post)
-        return render(request, 'blog/post_edit.html', {'form': form})
-```    
-
-Esto se ve casi exactamente igual a nuestra view `post_new`, ¿no? Pero no del todo. Primero: pasamos un parámetro extra `pk` de los urls. Luego: obtenemos el modelo `Post` que queremos editar con `get_object_or_404(Post, pk=pk)` y después, al crear el formulario pasamos este post como una `instancia` tanto al guardar el formulario:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    form = PostForm(request.POST, instance=post)
-```    
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
 
-como al abrir un formulario con este post para editarlo:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    form = PostForm(instance=post)
-```    
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
 
-Ok, ¡vamos a probar si funciona! Dirígete a la página `post_detail`. Debe haber ahí un botón para editar en la esquina superior derecha:
+```python
+form = PostForm(instance=post)
+```
 
-![Botón editar][5]
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
 
- [5]: images/edit_button2.png
+![Edit button](images/edit_button2.png)
 
-Al dar click ahí, debes ver el formulario con nuestro post del blog:
+When you click it you will see the form with our blog post:
 
-![Editar formulario][6]
+![Edit form](images/edit_form2.png)
 
- [6]: images/edit_form2.png
+Feel free to change the title or the text and save the changes!
 
-¡Siéntete libre de cambiar el título o el texto y guarda los cambios!
+Congratulations! Your application is getting more and more complete!
 
-¡Felicitaciones! ¡Tu aplicación está cada vez más completa!
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
 
-Si necesitas más información sobre los formularios de Django, debes leer la documentación: https://docs.djangoproject.com/en/1.8/topics/forms/
+## Security
 
-## Una cosa más: ¡Tiempo de implementación!
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
 
-Veamos si todo esto funciona en PythonAnywhere. ¡Tiempo de hacer otro despliegue!
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
 
-*   Primero, haz un commit con tu nuevo código y súbelo a GitHub
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added views to create/edit blog post inside the site."
-$ git push
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
 ```
 
-*   Luego, en una [consola Bash de PythonAnywhere][7]
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
 
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
-$ cd my-first-blog
-$ git pull
-[...]
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
 ```
 
-*   Finalmente, ve a la pestaña [Web][8] y haz click en **Reload**.
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
- [7]: https://www.pythonanywhere.com/consoles/
- [8]: https://www.pythonanywhere.com/web_app_setup/
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
 
-¡Y eso debería ser todo! Felicidades :)
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/es/django_installation/README.md b/es/django_installation/README.md
index 51205bb952f..7834993e063 100755
--- a/es/django_installation/README.md
+++ b/es/django_installation/README.md
@@ -1,113 +1,7 @@
-# Instalación de Django
+# Django installation
 
-> Parte de este capitulo esta basado en los tutoriales de Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
 > 
-> Parte de este capítulo se basa en el [django-marcador tutorial][1] bajo licencia de Creative Commons Attribution-ShareAlike 4.0 internacional. El tutorial de django-marcador tiene derechos de autor de Markus Zapke-Gündemann et al.
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
 
- [1]: http://django-marcador.keimlink.de/
-
-## Entorno virtual
-
-Antes de instalar Django, instalaremos una herramienta extremadamente útil que ayudará a mantener tu entorno de desarrollo ordenado en su computadora. Es posible omitir este paso, pero es muy recomendable no hacerlo - ¡comenzar con la mejor configuración posible ayudar a evitar muchos problemas en el futuro!
-
-Así que, vamos a crear un **entorno virtual** (también llamado un *virtualenv*). Aislará la configuración Python/Django con base en cada proyecto, lo que significa que cualquier cambio que realices en un sitio web no afectará a otros que también estés desarrollando. Genial, ¿no?
-
-Todo lo que necesitas hacer es encontrar un directorio en el que desees crear el `virtualenv`; tu directorio home, por ejemplo. En Windows puede verse como `C:\Users\Name` (donde `nombre` es el nombre de tu usuario).
-
-Para este tutorial usaremos un nuevo directorio `djangogirls` en tu directorio home:
-
-    mkdir djangogirls
-    cd djangogirls
-    
-
-Haremos un virtualenv llamado `myvenv`. El comando general estará en el formato:
-
-    python3 -m venv myvenv
-    
-
-### Windows
-
-Para crear un nuevo `virtualenv`, debes abrir la consola (te lo indicamos unos cuantos capítulos antes, ¿recuerdas?) y ejecuta `C:\Python34\python -m venv myvenv`. Se verá así:
-
-    C:\Users\Name\djangogirls> C:\Python34\python -m venv myvenv
-    
-
-en donde `C:\Python34\python` es el directorio en el que instalaste Python previamente y `myvenv` es el nombre de tu `virtualenv`. Puedes utilizar cualquier otro nombre, pero asegúrate de usar minúsculas y no dejar espacios, acentos o caracteres especiales. También es una buena idea mantener el nombre corto. ¡Vas a referirte a él mucho!
-
-### Linux y OS X
-
-Crear un `virtualenv` en Linux y OS X es tan simple como ejecutar `python3 -m venv myvenv`. Se verá así:
-
-    ~/djangogirls$ python3 -m venv myvenv
-    
-
-`myvenv` es el nombre de tu `virtualenv`. Puedes usar cualquier otro nombre, pero mantén el uso de minúsculas y no incluyas espacios. También es una buena idea mantener el nombre corto. ¡Vas a referirte a él mucho!
-
-> **Nota:** Actualmente, iniciar el entorno virtual en Ubuntu 14.04 de esta manera produce el siguiente error:
-> 
->     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
->     
-> 
-> Para evitar esto, utiliza directamente el comando `virtualenv`.
-> 
->     ~/djangogirls$ sudo apt-get install python-virtualenv
->     ~/djangogirls$ virtualenv --python=python3.4 myvenv
->     
-
-## Trabajar con virtualenv
-
-Este comando anterior creará un directorio llamado `myvenv` (o cualquier nombre que hayas escogido) que contiene nuestro entorno virtual (básicamente un montón de archivos y carpetas). Todo lo que queremos hacer ahora es iniciarlo ejecutando:
-
-    C:\Users\Name\djangogirls> myvenv\Scripts\activate
-    
-
-en Windows, o:
-
-    ~/djangogirls$ source myvenv/bin/activate
-    
-
-en OS X y Linux.
-
-¡Recuerda reemplazar `myvenv` con tu nombre de `virtualenv` que hayas elegido!
-
-> **Nota:** a veces el comando `source` podría no estar disponible. En esos casos trata de hacerlo esto:
-> 
->     ~/djangogirls$ . myvenv/bin/activate
->     
-
-Sabrás que tienes `virtualenv` iniciado cuando veas que aparece este mensaje en la consola:
-
-    (myvenv) C:\Users\Name\djangogirls>
-    
-
-o:
-
-    (myvenv) ~/djangogirls$
-    
-
-¡Nota que el prefijo `(myvenv)` aparece!
-
-Cuando trabajes en un entorno virtual, `python` automáticamente se referirá a la versión correcta, de modo que puedes utilizar `python` en vez de `python3`.
-
-Tenemos todas las dependencias importantes en su lugar. ¡Finalmente podemos instalar Django!
-
-## Instalar Django
-
-Ahora que tienes tu `virtualenv` iniciado, puedes instalar Django usando `pip`. En la consola, ejecuta `pip install django==1.8` (fíjate que utilizamos un doble signo igual: `==`).
-
-    (myvenv) ~$ pip install django==1.8
-    Downloading/unpacking django==1.8
-    Installing collected packages: django
-    Successfully installed django
-    Cleaning up...
-    
-
-En Windows
-
-> Si obtienes un error al ejecutar pip en Windows comprueba si la ruta de tu proyecto contiene espacios, acentos o caracteres especiales (por ejemplo, `C:\Users\User Name\djangogirls`). Si lo tiene, por favor considera moverla a otro lugar sin espacios, acentos o caracteres especiales (sugerencia: `C:\djangogirls`). Después de hacerlo ejecuta nuevamente el comando anterior.
-
-en Linux
-
-> Si obtienes un error al correr pip en Ubuntu 12.04 ejecuta `python -m pip install -U --force-reinstall pip` para arreglar la instalación de pip en el virtualenv.
-
-¡Eso es todo! ¡Ahora estás listo (por fin) para crear una aplicación Django!
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/es/django_installation/instructions.md b/es/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/es/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/es/django_models/README.md b/es/django_models/README.md
index 792ee596c23..7aa11d11732 100755
--- a/es/django_models/README.md
+++ b/es/django_models/README.md
@@ -1,39 +1,40 @@
-# Modelos en Django
+# Django models
 
-Lo que queremos crear ahora es algo que va a almacenar todos los posts en nuestro blog. Pero para poder hacerlo tenemos que hablar un poco acerca de algo llamado `objetos`.
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
 
-## Objetos
+## Objects
 
-Hay un concepto en el mundo de la programación llamado `programación orientada a objetos`. La idea es que en lugar de escribir todo como una aburrida secuencia de instrucciones de programación podemos modelar cosas y definir cómo interactúan con las demás.
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
 
-Entonces ¿Qué es un objeto? Es un conjunto de propiedades y acciones. Suena raro, pero te daremos un ejemplo.
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
 
-Si queremos modelar un gato crearemos un objeto `Gato` que tiene algunas propiedades, como son por ejemplo`color`, `edad`, `estado de ánimo` (es decir, bueno, malo, sueño ;)), `dueño` (que es un objeto `Persona` o, tal vez, en el caso de que el gato sea callejero, esta propiedad estará vacía).
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
 
-Y luego el `Gato` tiene algunas acciones: `ronronear`, `rasguñar` o `alimentarse` (en la cual daremos al gato algunos `ComidaDeGato`, que podría ser un objeto independiente con propiedades, como por ejemplo, `sabor`).
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
 
-    Gato
-    ---------
-    color 
-    edad 
-    humor 
-    dueño 
-    ronronear() 
-    rasguñar() 
-    alimentarse(comida_de_gato) 
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
     
-    ComidaDeGato
-    ----------
-    sabor
+
+    CatFood
+    --------
+    taste
     
 
-Básicamente se trata de describir cosas reales en el código con propiedades (llamadas `propiedades del objeto`) y las acciones (llamadas `métodos`).
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
 
-Y ahora, ¿cómo modelamos los posts en el blog? Queremos construir un blog, ¿no?
+How will we model blog posts then? We want to build a blog, right?
 
-Tenemos primero que responder algunas preguntas: ¿Qué es un post de un blog? ¿Qué características debe tener?
+We need to answer the question: What is a blog post? What properties should it have?
 
-Bueno, seguro que nuestros posts necesitan un texto con su contenido y un título, ¿cierto? También sería bueno saber quién lo escribió, así que necesitamos un autor. Por último, queremos saber cuándo el post fue creado y publicado.
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
 
     Post
     --------
@@ -44,131 +45,155 @@ Bueno, seguro que nuestros posts necesitan un texto con su contenido y un títul
     published_date
     
 
-¿Qué tipo de cosas podría hacerse con una entrada del blog? Sería bueno tener algún `método` que publique la entrada, ¿no?
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
 
-Así que vamos a necesitar el método `publicar`.
+So we will need a `publish` method.
 
-Puesto que ya sabemos lo que queremos lograr, ¡podemos empezar a moderlarlo en Django!
+Since we already know what we want to achieve, let's start modeling it in Django!
 
-## Modelo en Django
+## Django model
 
-Sabiendo qué es un objeto, podemos crear un modelo en Django para nuestros posts en el blog.
+Knowing what an object is, we can create a Django model for our blog post.
 
-Un modelo en Django es un tipo especial de objeto que se guarda en la `base de datos`. Una base de datos es una colección de datos. Allí es el lugar en el cual almacenarás la información sobre usuarios, posts del blog, etc. Utilizaremos una base de datos SQLite para almacenar nuestros datos. Este es el adaptador de base de datos predeterminada en Django -- será suficiente para nosotros por ahora.
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
 
-Piensa en el modelo en la base de datos como una hoja de cálculo con columnas (campos) y filas (datos).
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
 
-### Creando una aplicación
+### Creating an application
 
-Para mantener todo en orden, crearemos una aplicación separada dentro de nuestro proyecto. Es muy bueno tener todo organizado desde el principio. Para crear una aplicación, necesitamos ejecutar el siguiente comando en la consola (dentro de la carpeta de `djangogirls` donde está el archivo `manage.py`):
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py startapp blog
     
 
-Vas a notar que se crea un nuevo directorio llamado `blog` y contiene una serie de archivos. Nuestros directorios y archivos en nuestro proyecto deberían parecerse a esto:
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
 
     djangogirls
-    ├── mysite
-    |       __init__.py
-    |       settings.py
-    |       urls.py
-    |       wsgi.py
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
     ├── manage.py
-    └── blog
-        ├── migrations
-        |       __init__.py
+    └── mysite
         ├── __init__.py
-        ├── admin.py
-        ├── models.py
-        ├── tests.py
-        └── views.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
     
 
-Después de crear una aplicación también necesitamos decirle a Django que debe utilizarla. Lo hacemos en el archivo `mysite/settings.py`. Tenemos que encontrar `INSTALLED_APPS` y añadir una línea que contenga `'blog',` justo por encima de `)`. El producto final debe tener este aspecto:
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-    INSTALLED_APPS = (
-        'django.contrib.admin',
-        'django.contrib.auth',
-        'django.contrib.contenttypes',
-        'django.contrib.sessions',
-        'django.contrib.messages',
-        'django.contrib.staticfiles',
-        'blog',
-    )
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
 ```
 
-### Creando el Modelo Post
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
 
-En el archivo `blog/models.py` definimos todos los objetos llamados `Models` - este es un lugar en el cual definiremos nuestro modelo post.
+Let's open `blog/models.py`, remove everything from it, and write code like this:
 
-Vamos abrir `blog/models.py`, quitamos todo y escribimos un código como este:
+{% filename %}blog/models.py{% endfilename %}
 
 ```python
-    from django.db import models
-    from django.utils import timezone
-    
-    class Post(models.Model):
-        author = models.ForeignKey('auth.User')
-        title = models.CharField(max_length=200)
-        text = models.TextField()
-        created_date = models.DateTimeField(
-                default=timezone.now)
-        published_date = models.DateTimeField(
-                blank=True, null=True)
-    
-        def publish(self):
-            self.published_date = timezone.now()
-            self.save()
-    
-        def __str__(self):
-            return self.title
-```    
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
 
-> Vuelve a verificar que usaste dos guiones bajos (`_`) en cada lado del `str`. Estos se utilizan con frecuencia en Python y a veces también los llamamos "dunder" (diminutivo en inglés de "double-underscore").
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
 
-Da un poco de miedo, ¿verdad? Pero no te preocupes, ¡vamos a explicar qué significan estas líneas!
+It looks scary, right? But don't worry – we will explain what these lines mean!
 
-Todas las líneas que comienzan con `from` o `import` son líneas para añadir algo de otros archivos. Así que en vez de copiar y pegar las mismas cosas en cada archivo, podemos incluir algunas partes con `from... import ...`.
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
 
-`class Post(models.Model):` - esta línea define nuestro modelo (es un `objeto`).
+`class Post(models.Model):` – this line defines our model (it is an `object`).
 
-*   `class` es una palabra clave que indica que estamos definiendo un objeto.
-*   `Post` es el nombre de nuestro modelo. Podemos darle un nombre diferente (pero debemos evitar espacios en blanco y caracteres especiales). Una clase siempre comienza con su primera letra en mayúscula.
-*   `models.Model` significa que Post es un modelo de Django, así Django sabe que debe guardarlo en la base de datos.
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
 
-Ahora definimos las propiedades que hablábamos: `title`, `text`, `created_date`, `published_date` y `author`. Para hacer eso tenemos que definir un tipo de campo (¿es texto? ¿un número? ¿una fecha? ¿una relación con otro objeto - es decir, un usuario?).
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
 
-*   `models.CharField` - así es como defines un texto con un número limitado de caracteres.
-*   `models.TextField` - esto es para textos largos sin un límite. Será ideal para el contenido de un post, ¿verdad?
-*   `models.DateTimeField` - esto es fecha y hora.
-*   `modelos.ForeignKey` - este es un vínculo con otro modelo.
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
 
-No vamos a explicar cada pedacito de código, ya que nos tomaría demasiado tiempo. Debes echar un vistazo a la documentación de Django si quieres saber más sobre los campos de los Modelos y cómo definir cosas diferentes a las descritas anteriormente (https://docs.djangoproject.com/en/1.8/ref/models/fields/#field-types).
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
 
-¿Y qué sobre `def publish(self):`? Es exactamente nuestro método `publish` que mencionamos anteriormente. `def` significa que se trata de una función o método. `publish` es el nombre del método. Puedes cambiarlo, si quieres. La regla es que usamos minúsculas y guiones bajos en lugar de espacios (es decir, si quieres tener un método que calcule el precio medio, este podría llamarse `calculate_average_price`).
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
 
-Los métodos muy a menudo `devuelven` algo. Hay un ejemplo de esto en el método `__str__`. En este escenario, cuando llamamos a `__str__()` obtendremos un texto (**string**) con un título de Post.
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
 
-Si algo todavía no está claro sobre modelos, ¡no dudes en preguntar a tu tutor! Sabemos que es muy complicado, sobre todo cuando estás entendiendo qué son funciones y objetos mientras sigues este documento. Con suerte, ¡todo tiene un poco más de sentido para ti ahora!
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
 
-### Crear tablas para los modelos en tu base de datos
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
 
-El último paso es añadir nuestro nuevo modelo a nuestra base de datos. Primero tenemos que hacer que Django sepa que tenemos algunos cambios en nuestro modelo (acabamos de crearlo), escribe `python manage.py makemigrations blog`. Se verá así:
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py makemigrations blog
     Migrations for 'blog':
-      0001_initial.py:
+      blog/migrations/0001_initial.py:
+    
       - Create model Post
     
 
-Django preparará un archivo de migración que tenemos que aplicar ahora a nuestra base de datos escribiendo `python manage.py migrate blog`. El resultado debe ser:
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py migrate blog
     Operations to perform:
       Apply all migrations: blog
     Running migrations:
+      Rendering model states... DONE
       Applying blog.0001_initial... OK
     
 
-¡Hurra! Nuestro modelo de Post está ahora en nuestra base de datos. Sería bueno verlo, ¿no? ¡Dirígete al siguiente capítulo para ver cómo luce tu Post!
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/es/django_orm/README.md b/es/django_orm/README.md
index 1a572c54e64..31c47f27764 100755
--- a/es/django_orm/README.md
+++ b/es/django_orm/README.md
@@ -1,146 +1,218 @@
-# ORM de Django y QuerySets
+# Django ORM and QuerySets
 
-En este capítulo aprenderás cómo Django se conecta a la base de datos y almacena los datos en ella. ¡Vamos a sumergirnos!
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
 
-## ¿Qué es un QuerySet?
+## What is a QuerySet?
 
-Un QuerySet es, en esencia, una lista de objetos de un modelo determinado. Un QuerySet te permite leer los datos de una base de datos, filtrarlos y ordenarlos.
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
 
-Es más fácil de aprender con ejemplos. Vamos a intentarlo, ¿de acuerdo?
+It's easiest to learn by example. Let's try this, shall we?
 
 ## Django shell
 
-Abre la consola y escribe este comando:
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py shell
     
 
-El resultado debería ser:
+The effect should be like this:
 
-    (InteractiveConsole)
-    >>>
-    
+{% filename %}command-line{% endfilename %}
 
-Ahora estás en la consola interactiva de Django. Es como la consola de Python, pero con un toque de magia Django :). Puedes utilizar todos los comandos Python aquí también, por supuesto.
+```python
+(InteractiveConsole)
+>>>
+```
 
-### Ver todos los objetos
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
 
-Vamos a mostrar todos nuestros posts primero. Puedes hacerlo con el siguiente comando:
+### All objects
 
-    >>> Post.objects.all()
-    Traceback (most recent call last):
-          File "<console>", line 1, in <module>
-    NameError: name 'Post' is not defined
-    
+Let's try to display all of our posts first. You can do that with the following command:
 
-¡Uy! Apareció un error. Nos dice que no hay ningún objeto Post. Esto es correcto, ¡nos olvidamos de importarlo primero!
+{% filename %}command-line{% endfilename %}
 
-    >>> from blog.models import Post
-    
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
 
-Esto es simple: importamos el modelo `Post` de `blog.models`. Vamos a intentar mostrar todos los posts nuevamente:
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
 
-    >>> Post.objects.all()
-    <QuerySet [<Post: my post title>, <Post: another post title>]>
-    
+{% filename %}command-line{% endfilename %}
 
-Esta es una lista de las posts creadas anteriormente. Hemos creado estos posts usando la interfaz del administrador de Django. Sin embargo, ahora queremos crear nuevos posts usando Python, ¿cómo lo hacemos?
+```python
+>>> from blog.models import Post
+```
 
-### Crear objetos
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
 
-Esta es la forma de crear un nuevo objeto Post en la base de datos:
+{% filename %}command-line{% endfilename %}
 
-    >>> Post.objects.create(author=me, title='Sample title', text='Test')
-    
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
 
-Pero hay un ingrediente faltante: `me`. Necesitamos pasar una instancia del modelo `User` como autor. ¿Cómo hacemos eso?
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
 
-Primero importemos el modelo User:
+### Create object
 
-    >>> from django.contrib.auth.models import User
-    
+This is how you create a new Post object in database:
 
-¿Qué usuarios tenemos en nuestra base de datos? Veamos:
+{% filename %}command-line{% endfilename %}
 
-    >>> User.objects.all()
-    <QuerySet [<User: ola>]>
-    
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
 
-Este es el super usuario que creamos anteriormente, Vamos a obtener una instancia de ese usuario ahora:
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
 
-    me = User.objects.get(username='ola')
-    
+Let's import User model first:
 
-Como puedes ver, hicimos un `get` de un `User` con el `username` que sea igual a 'ola'. ¡Genial! Acuérdate de poner tu nombre de usuario para obtener tu usuario.
+{% filename %}command-line{% endfilename %}
 
-Ahora finalmente podemos crear nuestro primer post:
+```python
+>>> from django.contrib.auth.models import User
+```
 
-    >>> Post.objects.create(author=me, title='Sample title', text='Test')
-    
+What users do we have in our database? Try this:
 
-¡Hurra! ¿Quieres probar si funcionó?
+{% filename %}command-line{% endfilename %}
 
-    >>> Post.objects.all()
-    <QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
-    
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
 
-### Agrega más posts
+This is the superuser we created earlier! Let's get an instance of the user now:
 
-Ahora puedes divertirte un poco y añadir más posts para ver cómo funciona. Añade 2 ó 3 más y avanza a la siguiente parte.
+{% filename %}command-line{% endfilename %}
 
-### Filtrar objetos
+```python
+>>> me = User.objects.get(username='ola')
+```
 
-Una parte importante de los QuerySets es la habilidad para filtrarlos. Digamos que queremos encontrar todos los posts cuyo autor es el User ola. Usaremos `filter` en vez de `all` en `Post.objects.all()`. En los paréntesis estableceremos qué condición o conduciones deben cumplirse por un post del blog para terminar en nuestro queryset. En nuestro caso sería `author` es igual a `me`. La forma de escribirlo en Django es: `author=me`. Ahora nuestro bloque de código se ve como esto:
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
 
-    >>> Post.objects.filter(author=me)
-    <QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
-    
+Now we can finally create our post:
 
-¿O tal vez querramos ver todos los posts que contengan la palabra 'title' en el campo `title`?
+{% filename %}command-line{% endfilename %}
 
-    >>> Post.objects.filter(title__contains='title')
-    <QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
-    
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
 
-> **Nota** Hay dos guiones bajos (`_`) entre `title` y `contains`. Django ORM utiliza esta sintaxis para separar los nombres de los campos ("title") y operaciones o filtros ("contains"). Si sólo utilizas un guión bajo, obtendrás un error como "FieldError: Cannot resolve keyword title_contains".
+Hurray! Wanna check if it worked?
 
-También puedes obtener una lista de todos los posts publicados. Lo hacemos filtrando los posts que tienen el campo `published_date` en el pasado:
+{% filename %}command-line{% endfilename %}
 
-    >>> from django.utils import timezone
-    >>> Post.objects.filter(published_date__lte=timezone.now())
-    []
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
 
-Desafortunadamente, ninguno de nuestros posts han sido publicados todavía. ¡Vamos a cambiar esto! Primero obtén una instancia de un post que querramos publicar:
+There it is, one more post in the list!
 
-    >>> post = Post.objects.get(id=1)
-    
+### Add more posts
 
-¡Luego utiliza el método `publish` para publicarlo!
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
 
-    >>> post.publish()
-    
+### Filter objects
 
-Ahora intenta obtener la lista de posts publicados nuevamente (presiona la tecla con la flecha hacia arriba 3 veces y presiona Enter):
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
 
-    >>> Post.objects.filter(published_date__lte=timezone.now())
-    <QuerySet [<Post: Sample title>]>
-    
+{% filename %}command-line{% endfilename %}
 
-### Ordenando objetos
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
 
-Los QuerySets también te permiten ordenar la lista de objetos. Intentemos ordenarlos por el campo `created_date`:
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
 
-    >>> Post.objects.order_by('created_date')
-    <QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
 
-También podemos invertir el ordenamiento agregando `-` al principio:
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
 
-    >>> Post.objects.order_by('-created_date')
-    <QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
     
 
-¡Genial! ¡Ahora estás lista para la siguiente parte! Para cerrar la consola, tipea:
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
 
-    >>> exit()
-    $
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/es/django_templates/README.md b/es/django_templates/README.md
index 868b94dc88a..263eb1fd835 100755
--- a/es/django_templates/README.md
+++ b/es/django_templates/README.md
@@ -1,106 +1,106 @@
-# Plantillas de Django
+# Django templates
 
-¡Es hora de mostrar algunos datos! Django nos provee las útiles **template tags** para ello.
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
 
-## ¿Qué son las template tags?
+## What are template tags?
 
-Verás, en HTML no puedes realmente poner código Python, porque los navegadores no lo entienden. Ellos sólo saben HTML. Sabemos que HTML es algo estático, mientras que Python es mucho más dinámico.
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
 
-**Django template tags** nos permiten transferir cosas de Python como cosas en HTML, así que tu puedes construir sitios web dinámicos más rápido y fácil.
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
-## Mostrar la plantilla post list
+## Display post list template
 
-En el capítulo anterior dimos a nuestra plantilla una lista de posts en la variable `posts`. Ahora lo mostraremos en HTML.
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
 
-Para imprimir una variable en una plantilla de Django, utilizamos llaves dobles con el nombre de la variable dentro, así:
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
 
-``` html
-    {{ posts }}
-```    
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-Prueba esto en tu plantilla `blog/templates/blog/post_list.html` (reemplaza el segundo y el tercer par de etiquetas `<div></div>` con la línea `{{ posts }}`), guarda el archivo y actualiza la página para ver los resultados:
+```html
+{{ posts }}
+```
 
-![Figura 13.1][1]
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
 
- [1]: images/step1.png
+![Figure 13.1](images/step1.png)
 
-Como puedes ver, todo lo que obtenemos es esto:
+As you can see, all we've got is this:
 
-    <QuerySet [<Post: Mi segundo post>, <Post: Mi primer post>]>
-    
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
 
-Esto significa que Django lo entiende como una lista de objetos. ¿Recuerdas de **Introducción a Python** cómo podemos mostrar listas? Sí, ¡con los ciclos for! En una plantilla de Django, lo haces de esta manera:
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
 
-``` html
-    {% for post in posts %}
-        {{ post }}
-    {% endfor %}
-``` 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-Prueba esto en tu plantilla.
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
 
-![Figura 13.2][2]
+![Figure 13.2](images/step2.png)
 
- [2]: images/step2.png
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
 
-¡Funciona! Pero queremos que se muestren como los posts estáticos que creamos anteriormente en el capítulo de **Introducción a HTML**. Puedes mezclar HTML y template tags. Nuestro `body` se verá así:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-``` html
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
     <div>
-        <h1><a href="/">Django Girls Blog</a></h1>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
     </div>
-    
-    {% for post in posts %}
-        <div>
-            <p>published: {{ post.published_date }}</p>
-            <h1><a href="">{{ post.title }}</a></h1>
-            <p>{{ post.text|linebreaksbr }}</p>
-        </div>
-    {% endfor %}
-```    
-
-Todo lo que pones entre `{% for %}` y `{% endfor %}` se repetirá para cada objeto en la lista. Actualiza tu página:
+{% endfor %}
+```
 
-![Figura 13.3][3]
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
 
- [3]: images/step3.png
+![Figure 13.3](images/step3.png)
 
-¿Has notado que utilizamos una notación diferente esta vez `{{ post.title }}` o `{{ post.text }}`? Estamos accediendo a datos en cada uno de los campos definidos en nuestro modelo `Post`. También el `|linebreaksbr` está dirigiendo el texto de los posts a través de un filtro para convertir saltos de línea en párrafos.
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
 
-## Una cosa más
+## One more thing
 
-Sería bueno ver si tu sitio web seguirá funcionando en la Internet pública, ¿verdad? Intentemos desplegándola en PythonAnywhere nuevamente. Aquí te dejamos un ayuda memoria...
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
 
-*   Primero, sube tu código a GitHub
+* First, push your code to Github
 
-```
-$ git status
-[...]
-$ git add --all .
-$ git status
-[...]
-$ git commit -m "Modified templates to display posts from database."
-[...]
-$ git push
-```
+{% filename %}command-line{% endfilename %}
 
-*   Luego, identifícate en [PythonAnywhere][4] y ve a tu **consola Bash** (o empieza una nueva), y ejecuta:
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
 
-```
-$ cd my-first-blog
-$ git pull
-[...]
-```
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
 
-*   Finalmente, ve a la [pestaña Web][5] y presiona **Reload** en tu aplicación web. ¡Tu actualización debería poder verse!
+{% filename %}PythonAnywhere command-line{% endfilename %}
 
- [4]: https://www.pythonanywhere.com/consoles/
- [5]: https://www.pythonanywhere.com/web_app_setup/
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
-¡Felicidades! Ahora sigue adelante, trata de agregar un nuevo post usando el panel de administrador de Django (¡recuerda añadir published_date!) y luego actualiza tu página para ver si aparece tu nuevo post.
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
 
-¿Funciona como un encanto? ¡Estamos orgullosos! Aléjate de tu computadora por un rato, te has ganado un descanso. :)
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
 
-![Figura 13.4][6]
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
 
- [6]: images/donut.png
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/es/django_urls/README.md b/es/django_urls/README.md
index 3ced93e3a42..c491b27de5c 100755
--- a/es/django_urls/README.md
+++ b/es/django_urls/README.md
@@ -1,123 +1,129 @@
-# Django urls
+# Django URLs
 
-Vamos a construir nuestra primera página web -- ¡una página de inicio para tu blog! Pero primero, vamos a aprender un poco sobre Django urls.
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
 
-## ¿Qué es una URL?
+## What is a URL?
 
-Una URL es simplemente una dirección web, puedes ver una URL cada vez que visitas cualquier sitio web - es visible en la barra de direcciones de tu navegador (¡Sí! `127.0.0.1:8000` es una URL. Y http://djangogirls.org es también una URL):
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
 
-![URL][1]
+![Url](images/url.png)
 
- [1]: images/url.png
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
 
-Cada página en Internet necesita su propia URL. De esta manera tu aplicación sabe lo que debe mostrar a un usuario que abre una URL. En Django se usa algo llamado `URLconf` (configuración de URL), un conjunto de patrones que Django intentará hacer coincidir con la dirección URL recibida para encontrar la vista correcta.
+## How do URLs work in Django?
 
-## ¿Cómo funcionan las URLs en Django?
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
 
-Vamos a abrir el archivo `mysite/urls.py` y ver cómo es:
+{% filename %}mysite/urls.py{% endfilename %}
 
-``` python
-    from django.conf.urls import include, url
-    from django.contrib import admin
-    
-    urlpatterns = [
-        # Examples:
-        # url(r'^$', 'mysite.views.home', name='home'),
-        # url(r'^blog/', include('blog.urls')),
-    
-        url(r'^admin/', include(admin.site.urls)),
-    ]
-```    
+```python
+"""mysite URL Configuration
 
-Como puedes ver, Django ya puso algo aquí para nosotros.
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
 
-Las líneas que comienzan con `#` son comentarios - significa que esas líneas no serán ejecutadas por Python. Muy útil, ¿verdad?
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
 
-Ya está aquí la URL de admin, que visitaste en el capítulo anterior:
+The admin URL, which you visited in previous chapter, is already here:
 
-``` python
-        url(r'^admin/', include(admin.site.urls)),
-```    
+{% filename %}mysite/urls.py{% endfilename %}
 
-Esto significa que para cada URL que empieza con `admin/` Django encontrará su correspondiente *view*. En este caso estamos incluyendo en una sola línea muchas URLs de admin, así no está todo comprimido en este pequeño archivo - es más limpio y legible.
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
 
 ## Regex
 
-¿Te preguntas cómo Django coincide las direcciones URL con las vistas? Bueno, esta parte es difícil. Django utiliza `regex` -- expresiones regulares. Regex tiene muchas (¡un montón!) de normas que forman un patrón de búsqueda. Dado que las expresiones regulares son un tema avanzado, no entraremos en detalles sobre su funcionamiento.
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
 
-Si te interesa entender cómo creamos esos patrones, aquí hay un ejemplo del proceso - solamente necesitaremos un subconjunto de reglas limitado para expresar el patrón que estamos buscando:
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
 
-    ^ denota el principio del texto
-    $ denota el final del texto
-    \d representa un dígito
-    + indica que el ítem anterior debería ser repetido por lo menos una vez
-    () para encerrar una parte del patrón
-    
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
 
-Cualquier otra cosa en la definición del URL será tomada literalmente.
+Anything else in the URL definition will be taken literally.
 
-Ahora imagina que tienes un sitio web con una dirección como esta: `http://www.mysite.com/post/12345/`, donde `12345` es el número de post.
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
 
-Escribir vistas separadas para todos los números de post sería realmente molesto. Con las expresiones regulares podemos crear un patrón que coincidirá la URL y extraerá el número para nosotras: `^post/(\d+)/$`. Analicemos esta expresión parte por parte para entender qué es lo que estamos haciendo aquí:
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
 
-*   **^post/** le está diciendo a Django que tome cualquier cosa que tenga `post/` al principio del URL (justo antes de `^`)
-*   **(\d+)** significa que habrá un número (de uno o más dígitos) y que queremos que ese número sea capturado y extraído
-*   **/** le dice a Django que otro caracter `/` debería venir a continuación
-*   **$** indica el final del URL, lo que significa que sólo cadenas finalizando con `/` coincidirán con este patrón
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
 
-## ¡Tu primer URL de Django!
+## Your first Django URL!
 
-¡Es hora de crear nuestro primer URL! Queremos que 'http://127.0.0.1:8000/' sea la página de inicio de nuestro blog y que muestre una lista de posts.
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
 
-También queremos mantener el archivo `mysite/urls.py` limpio, así que importaremos URLs de nuestro `blog` al archivo `mysite/urls.py` principal.
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
 
-Elimina las líneas comentadas (líneas comenzando con `#`) y agrega una línea que importará `blog.urls` en el url principal (`''`).
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
 
-Tu archivo `mysite/urls.py` debería verse como este:
+Your `mysite/urls.py` file should now look like this:
 
-``` python
-    from django.conf.urls import include, url
-    from django.contrib import admin
-    
-    urlpatterns = [
-        url(r'^admin/', include(admin.site.urls)),
-        url(r'', include('blog.urls')),
-    ]
-``` 
+{% filename %}mysite/urls.py{% endfilename %}
 
-Django ahora redirigirá todo lo que vaya hacia 'http://127.0.0.1:8000/' a `blog.urls` y buscará más instrucciones allí.
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
 
-Cuando escribes expresiones regulares en Python acostúmbrate a poner `r` al principio de la cadena - esto es solamente una pista para que Python entienda que la cadena contenerá caracteres especiales que no son para ser interpretados por Python sino que son parte de la expresión regular.
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
 
 ## blog.urls
 
-Crea un nuevo archivo vacío `blog/urls.py`. ¡Muy bien! Agrega estas primeras dos líneas:
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
 
-``` python
-    from django.conf.urls import include, url
-    from . import views
+```python
+from django.conf.urls import url
+from . import views
 ```
 
-Aquí solo estamos importando los métodos de Django y todas nuestras `views` del `blog` (todavía no tenemos ninguna, pero lo haremos en un minuto)
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
 
-Luego de esto, podemos agregar nuestro primer patrón URL:
+After that, we can add our first URL pattern:
 
-``` python
-    urlpatterns = [
-        url(r'^$', views.post_list),
-    ]
-```
+{% filename %}blog/urls.py{% endfilename %}
 
-Como puedes ver, ahora estamos asignando una `view` llamada `post_list` al URL `^$`. Esta expresión regular coincidirá con `^` (un inicio) seguido de `$` (un final) - por lo tanto, sólo una cadena vacía coincidirá. Y esto es correcto, ya que en los URL resolvers de Django 'http://127.0.0.1:8000/' no es parte del URL. Este patrón mostrará a Django que `views.post_list` es el lugar correcto al que ir si alguien ingresa a tu sitio web con la dirección 'http://127.0.0.1:8000/'.
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
 
-¿Todo bien? Abre http://127.0.0.1:8000/ en tu navegador para ver el resultado.
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
 
-![Error][2]
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
 
- [2]: images/error1.png
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
 
-No hay más un "It works", ¿verdad? No te preocupes, es solamente una página de error, ¡nada que nos asuste! De hecho, son bastante útiles:
+![Error](images/error1.png)
 
-Puedes leer que no hay ningún **atributo 'post_list'**. ¿*post_list* te recuerda algo? ¡Así es como llamamos a nuestra vista! Esto significa que todo está en su lugar, sólo que no creamos nuestra *view* todavía. No te preocupes, ya llegaremos a eso.
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
 
-> Si quieres saber más sobre Django URLconfs, mira la documentación oficial: https://docs.djangoproject.com/en/1.8/topics/http/urls/
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/es/django_views/README.md b/es/django_views/README.md
index e62bd13fb42..07afe091a52 100755
--- a/es/django_views/README.md
+++ b/es/django_views/README.md
@@ -1,38 +1,44 @@
-# Vistas de Django - ¡Es hora de crear!
+# Django views – time to create!
 
-Es hora de deshacerse del error que hemos creado en el capítulo anterior :)
+Time to get rid of the bug we created in the last chapter! :)
 
-Una *View* es un lugar donde ponemos la "lógica" de nuestra aplicación. Se solicitará información del `model` que creaste anteriormente y se pasará a una `view` que crearás en el próximo capítulo. Las vistas son sólo métodos de Python que son un poco más complicados que lo que hicimos en el capítulo de **Introducción a Python**.
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
 
-Las Vistas se colocan en el archivo `views.py`. Agregaremos nuestras *views* al archivo `blog/views.py`.
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
 
 ## blog/views.py
 
-Bien, vamos abrir este archivo y ver lo que contiene:
+OK, let's open up this file and see what's in there:
 
-``` python
-    from django.shortcuts import render
-    
-    # Create your views here.
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
 ```
 
-No demasiadas cosas aquí todavía. La *view* más simple puede ser como esto:
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
 
-``` python
-    def post_list(request):
-        return render(request, 'blog/post_list.html', {})
-```    
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
 
-Como puedes ver, hemos creado un método (`def`) llamado `post_list` que toma un `request` y hace un `return` de un método `render` que renderizará (construirá) nuestra plantilla `blog/post_list.html`.
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
 
-Guarda el archivo, dirígete a http://127.0.0.1:8000/ y veamos lo que tenemos ahora.
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
 
-¡Otro error! Leamos lo que está pasando ahora:
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
 
-![Error][1]
+Another error! Read what's going on now:
 
- [1]: images/error.png
+![Error](images/error.png)
 
-Este es uno fácil: *TemplateDoesNotExist*. ¡Vamos a arreglar este error creando una plantilla en el siguiente capítulo!
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
 
-> Aprende más acerca de las views de Django leyendo la documentación oficial: https://docs.djangoproject.com/en/1.8/topics/http/views/
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/es/dynamic_data_in_templates/README.md b/es/dynamic_data_in_templates/README.md
index f991de7c0b5..807bb666ebc 100755
--- a/es/dynamic_data_in_templates/README.md
+++ b/es/dynamic_data_in_templates/README.md
@@ -1,72 +1,81 @@
-# Datos dinámicos en las plantillas
+# Dynamic data in templates
 
-Tenemos diferentes piezas en su lugar: el modelo `Post` está definido en `models.py`, tenemos a `post_list` en `views.py` y la plantilla agregada. ¿Pero cómo haremos realmente para que nuestros posts aparezcan en nuestra plantilla HTML? Porque eso es lo que queremos hacer: tomar algún contenido (modelos guardados en la base de datos) y mostrarlo adecuadamente en nuestra plantilla, ¿no?
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
 
-Esto es exactamente lo que las *views* se supone que hacen: conectar modelos con plantillas. En nuestra *view* `post_list` necesitaremos tomar los modelos que deseamos mostrar y pasarlos a una plantilla. Así que básicamente en una *view* decidimos qué (modelo) se mostrará en una plantilla.
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
 
-Muy bien, ahora ¿cómo lo hacemos?
+OK, so how will we achieve this?
 
-Necesitamos abrir nuestro archivo `blog/views.py`. Hasta ahora la *view* `post_list` se ve así:
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    from django.shortcuts import render
-    
-    def post_list(request):
-        return render(request, 'blog/post_list.html', {})
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
 ```
 
-¿Recuerdas cuando hablamos de incluir código en diferentes archivos? Ahora tenemos que incluir el modelo que definimos en el archivo `models.py`. Agregaremos la línea `from .models import Post` de la siguiente forma:
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    from django.shortcuts import render
-    from .models import Post
+from django.shortcuts import render
+from .models import Post
 ```
 
-El punto después de `from` indica el *directorio actual* o la *aplicación actual*. Como `views.py` y `models.py` están en el mismo directorio, simplemente usamos `.` y el nombre del archivo (sin `.py`). Ahora importamos el nombre del modelo (`Post`).
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
 
-¿Pero ahora qué sigue? Para tomar publicaciones reales del modelo `Post`, necesitamos algo llamado `QuerySet` (conjunto de consultas).
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
 
 ## QuerySet
 
-Ya debes estar familiarizada con la forma en que funcionan los QuerySets. Hablamos de ellos en el capítulo [Django ORM (QuerySets)][1].
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
 
- [1]: ../django_orm/README.md
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
 
-Entonces ahora nos interesa obtener una lista de entradas del blog que han sido publicadas y ordenadas por `published_date` (fecha de publicación), ¿no? ¡Ya hicimos eso en el capítulo QuerySets!
+{% filename %}blog/views.py{% endfilename %}
 
-    Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-    
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
 
-Ahora pondremos este bloque de código en el archivo `blog/views.py`, agregándolo a la función `def post_list(request)`:
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    from django.shortcuts import render
-    from django.utils import timezone
-    from .models import Post
-    
-    def post_list(request):
-        posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-        return render(request, 'blog/post_list.html', {})
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
 ```
 
-Observa que creamos una *variable* en nuestro QuerySet: `posts`. Tómala como el nombre de nuestro QuerySet. De aquí en adelante vamos a referirnos al QuerySet con ese nombre.
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
 
-La última parte es pasar el QuerySet `posts` a la plantilla (veremos cómo mostrarla en el siguiente capítulo).
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
 
-En la función `render` ya tenemos el parámetro `request` (todo lo que recibimos del usuario via Internet) y el archivo `'blog/post_list.html'` como plantilla. El último parámetro, que se ve así: `{}` es un campo en el que podemos agregar algunas cosas para que la plantilla las use. Necesitamos nombrarlos (los seguiremos llamando `'posts'` por ahora :)). Se debería ver así: `{'posts': posts}`. Observa que la parte que va antes de `:` está entre comillas `''`.
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
 
-Finalmente nuestro archivo `blog/views.py` debería verse así:
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    from django.shortcuts import render
-    from django.utils import timezone
-    from .models import Post
-    
-    def post_list(request):
-        posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-        return render(request, 'blog/post_list.html', {'posts': posts})
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
 ```
 
-¡Terminamos! Ahora regresemos a nuestra plantilla y mostremos este QuerySet.
+That's it! Time to go back to our template and display this QuerySet!
 
-Si quieres leer un poco más acerca de QuerySets en Django, puedes darle un vistazo a: https://docs.djangoproject.com/en/1.8/ref/models/querysets/
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/es/extend_your_application/README.md b/es/extend_your_application/README.md
index 8c0d2bae5b3..0bae760be7c 100755
--- a/es/extend_your_application/README.md
+++ b/es/extend_your_application/README.md
@@ -1,16 +1,17 @@
-# Amplía tu aplicación
+# Extend your application
 
-Ya hemos completado todos los pasos necesarios para la creación de nuestro sitio web: sabemos cómo escribir un model, url, view y template. También sabemos cómo hacer que nuestro sitio web se vea lindo.
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
 
-¡Hora de practicar!
+Time to practice!
 
-Lo primero que necesitamos en nuestro blog es, obviamente, una página para mostrar un post, ¿cierto?
+The first thing we need in our blog is, obviously, a page to display one post, right?
 
-Ya tenemos un modelo `Post`, así que no necesitamos añadir nada a `models.py`.
+We already have a `Post` model, so we don't need to add anything to `models.py`.
 
-## Crea un enlace en la plantilla
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-Vamos a empezar añadiendo un enlace dentro del archivo `blog/templates/blog/post_list.html`. Hasta el momento debería verse así:
 ```html
 {% extends 'blog/base.html' %}
 
@@ -27,90 +28,97 @@ Vamos a empezar añadiendo un enlace dentro del archivo `blog/templates/blog/pos
 {% endblock %}
 ```
 
-Queremos tener un enlace a una página de detalle sobre el título del post. Vamos a cambiar `<h1><a href="">{{ post.title }}</a></h1>` dentro del enlace:
-```
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
 <h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
 ```
 
-Es hora de explicar el misterioso `{% url 'post_detail' pk=post.pk %}`. Como probablemente sospeches, la notación `{% %}` significa que estamos utilizando Django template tags. ¡Esta vez vamos a utilizar uno que va a crear una dirección URL para nosotros!
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
 
-`post_detail` es el nombre de la *view* que queremos crear.
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
 
-Ahora cuando vayamos a: http://127.0.0.1:8000/ tendremos un error (como era de esperar, ya que no tenemos una dirección URL o una *view* para `post_detail`). Se verá así:
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
 
-![NoReverseMatch error][1]
+![NoReverseMatch error](images/no_reverse_match2.png)
 
- [1]: images/no_reverse_match2.png
+## Create a URL to a post's detail
 
-¡Vamos a crear una URL en `urls.py` para nuestro *view* `post_detail`!
+Let's create a URL in `urls.py` for our `post_detail` *view*!
 
-### URL: http://127.0.0.1:8000/post/1/
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
 
-Queremos crear una URL que apunte a Django a una *view* denominada `post_detail`, que mostrará una entrada del blog. Agrega la línea `url (r'^post/(?P<pk>[0-9]+)/$', views.post_detail),` al archivo `blog/urls.py`. Debería tener este aspecto:
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
 from . import views
 
 urlpatterns = [
-    url(r'^$', views.post_list),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
 ]
 ```
 
-Ese da un poco de miedo, pero no te preocupes - lo explicaremos para
-ti:
-- comienza con `^` otra vez, "el principio".
-- `post/` sólo significa que después del comienzo, la dirección URL debe contener la palabra **post** y **/**. Hasta ahora, bien.
-- `(?P<pk>[0-9]+)` - esta parte es más complicada. Significa que Django llevará todo lo que coloques aquí y lo transferirá a una vista como una variable llamada `pk`. `[0-9]` también nos dice que sólo puede ser un número, no una letra (todo debería estar entre 0 y 9). `+` significa que tiene que haber uno o más dígitos. Entonces algo como `http://127.0.0.1:8000/post//` no es válido, pero `http://127.0.0.1:8000/post/1234567890/` es perfectamente aceptable!
-- `/` - entonces necesitamos **/** de nuevo
-- `$` - ¡"el final"!
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
 
-Eso significa que si entras en `http://127.0.0.1:8000/post/5/` en tu navegador, Django entenderá que estás buscando una *view* denominada `post_detail` y transferirá la información de `pk` que es igual a `5` a esa *view*.
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
 
-`pk` es la abreviación de `primary key`. Este nombre se utiliza a menudo en proyectos de Django. Pero puedes nombrar tus variables como te guste (recuerda: ¡minúsculas y `_` en lugar de espacios en blanco!). Por ejemplo en lugar de `(?.¿P<pk>[0-9]+)` podríamos tener la variable `post_id`, así que esto lo verías como: `(?P <post_id>[0-9]+)`.
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
 
-¡Bien! ¡Actualiza la página: http://127.0.0.1:8000/ ¡Boom! ¡Sin embargo vemos otro error! Como era de esperarse.
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
 
-![AttributeError][2]
+![AttributeError](images/attribute_error2.png)
 
- [2]: images/attribute_error2.png
+Do you remember what the next step is? Of course: adding a view!
 
-¿Te acuerdas del próximo paso? Por supuesto: ¡agregar una view!
+## Add a post's detail view
 
-## post_detail view
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
 
-Esta vez nuestra *view* tomará un parámetro adicional `pk`. Nuestra *view* necesita recibirla, ¿cierto? Entonces definiremos nuestra función como `def post_detail (request, pk):`. Ten en cuenta que tenemos que usar exactamente el mismo nombre que especificamos en las urls (`pk`). ¡Omitir esta variable es incorrecto y resultará en un error!
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
 
-Ahora, queremos sólo un post del blog. Para ello podemos usar querysets como este:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 Post.objects.get(pk=pk)
 ```
 
-Pero este código tiene un problema. Si no hay ningún `Post` con `llave primaria` (`pk`) tendremos un error muy feo.
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
 
-![DoesNotExist error][3]
+![DoesNotExist error](images/does_not_exist2.png)
 
- [3]: images/does_not_exist2.png
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
 
-¡No queremos eso! Pero, por supuesto, Django viene con algo que se encargará de ese problema por nosotros: `get_object_or_404`. En caso de que no haya ningún `Post` con el dado `pk` se mostrará una más agradable página (`Page Not Found 404`).
+![Page not found](images/404_2.png)
 
-![Page not found][4]
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
 
- [4]: images/404_2.png
+OK, time to add a *view* to our `views.py` file!
 
-La buena noticia es que puedes crear tu propia página `Page Not Found` y diseñarla como desees. Pero por ahora no es tan importante, así que lo omitiremos.
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
 
-¡Es hora de agregar una *view* a nuestro archivo `views.py`!
+We should open `blog/views.py` and add the following code near the other `from` lines:
 
-Deberíamos abrir `blog/views.py` y agregar el siguiente código:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render, get_object_or_404
 ```
 
-Cerca de otras líneas `from`. Y en el final del archivo añadimos nuestra *view*:
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_detail(request, pk):
@@ -118,74 +126,72 @@ def post_detail(request, pk):
     return render(request, 'blog/post_detail.html', {'post': post})
 ```
 
-Sí. Es hora de actualizar la página: http://127.0.0.1:8000/
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
 
-![Post list view][5]
+![Post list view](images/post_list2.png)
 
- [5]: images/post_list2.png
+It worked! But what happens when you click a link in blog post title?
 
-¡Funcionó! Pero ¿qué pasa cuando haces click en un enlace en el título del post?
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
 
-![TemplateDoesNotExist error][6]
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
 
- [6]: images/template_does_not_exist2.png
+## Create a template for the post details
 
-¡Oh no! ¡Otro error! Pero ya sabemos cómo lidiar con eso, ¿no? ¡Tenemos que añadir una plantilla!
+We will create a file in `blog/templates/blog` called `post_detail.html`.
 
-Crearemos un archivo en `blog/templates/blog` llamado `post_detail.html`.
+It will look like this:
 
-Se verá así:
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
 
 {% block content %}
-    <div class="post">
-        {% if post.published_date %}
-            <div class="date">
-                {{ post.published_date }}
-            </div>
-        {% endif %}
-        <h1>{{ post.title }}</h1>
-        <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endblock %}
 ```
 
-Una vez más estamos extendiendo `base.html`. En el bloque `content` queremos mostrar la fecha de publicación (si existe), título y texto de nuestros posts. Pero deberíamos discutir algunas cosas importantes, ¿cierto?
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
 
-`{% if ... %} ... {% endif %}` es un template tag que podemos usar cuando querramos ver algo (¿recuerdas <code>if ... else...</code> del capítulo de **Introducción a Python**?). En este escenario queremos comprobar si el campo `published_date` de un post no está vacío.
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
 
-Bien, podemos actualizar nuestra página y ver si `Page Not Found` se ha ido.
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
 
-![Post detail page][7]
+![Post detail page](images/post_detail2.png)
 
- [7]: images/post_detail2.png
+Yay! It works!
 
-¡Yay! ¡Funciona!
+## One more thing: deploy time!
 
-## Una cosa más: ¡Tiempo de implementación!
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
 
-Sería bueno verificar que tu sitio web aún funcionará en PythonAnywhere, ¿cierto? Intentemos desplegar de nuevo.
+{% filename %}command-line{% endfilename %}
 
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added views to create/edit blog post inside the site."
-$ git push
-```
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
 
-*   Luego, en una [consola Bash de PythonAnywhere][8]
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
 
-```
-$ cd my-first-blog
-$ git pull [...]
-```
+{% filename %}command-line{% endfilename %}
 
-*   Finalmente, ve a la pestaña [Web][9] y haz click en **Reload**.
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
- [8]: https://www.pythonanywhere.com/consoles/
- [9]: https://www.pythonanywhere.com/web_app_setup/
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
 
-¡Y eso debería ser todo! Felicidades :)
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/es/how_the_internet_works/README.md b/es/how_the_internet_works/README.md
index 8a5e936cb93..efd95c3f4b2 100755
--- a/es/how_the_internet_works/README.md
+++ b/es/how_the_internet_works/README.md
@@ -1,55 +1,47 @@
-# ¿Cómo funciona Internet?
+# How the Internet works
 
-> Este capitulo está inspirado por la charla "How the Internet works" de Jessica McKellar (http://web.mit.edu/jesstess/www/).
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
 
-Apostamos que utilizas Internet todos los días. Pero, ¿sabes lo que pasa cuando escribes una dirección como https://djangogirls.org en tu navegador y presionas 'Enter'?
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
 
-Lo primero que tienes que entender es que un sitio web es sólo un montón de archivos guardados en un disco duro. Al igual que tus películas, música o fotos. Sin embargo, los sitios web poseen una peculiaridad: ellos incluyen un código de computadoras llamado HTML.
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
 
-Si no estás familiarizada con la programación, puede ser difícil de captar HTML al principio, pero tus navegadores web (como Chrome, Safari, Firefox, etc.) lo aman. Los navegadores web están diseñados para entender este código, seguir sus instrucciones y mostrar todos esos archivos de los cuales tu sitio web está hecho de la manera exacta como tu quieres que se muestren.
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
 
-Como cualquier otro archivo, tenemos que guardar los archivos HTML en algún lugar de un disco duro. Para Internet, usamos unas computadoras especiales y poderosas llamadas *servidores*. Ellas no tienen una pantalla, mouse o teclado, debido a que su propósito es almacenar datos y servirlos. Por esa razón son llamados *servidores* -- porque ellos *sirven* los datos.
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
 
-Ok, quizás te preguntes cómo luce Internet, ¿cierto?
+OK, but you want to know how the Internet looks, right?
 
-¡Te hemos hecho una imagen! Luce algo así:
+We drew you a picture! It looks like this:
 
-![Figura 1.1][1]
+![Figure 1.1](images/internet_1.png)
 
- [1]: images/internet_1.png
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
 
-Parece un lío, ¿no? En realidad es una red de máquinas conectadas (los mencionados *servidores*). ¡Cientos de miles de máquinas! ¡Muchos, muchos kilómetros de cables alrededor del mundo! Puedes visitar el sitio web [Submarine Cable Map][2] (http://submarinecablemap.com/) donde se muestran las conexiones de cables submarinos alrededor del mundo y ver lo complicada que es la red. Aquí hay una captura de pantalla de la página web:
+![Figure 1.2](images/internet_3.png)
 
- [2]: http://submarinecablemap.com/
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
 
-![Figura 1.2][3]
+It looks like this:
 
- [3]: images/internet_3.png
+![Figure 1.3](images/internet_2.png)
 
-Es fascinante, ¿no? Pero, obviamente, no es posible tener un cable entre cada máquina conectada a Internet. Así que, para llegar a una máquina (por ejemplo la que aloja a https://djangogirls.org) tenemos que pasar una solicitud a través de muchas máquinas diferentes.
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
 
-Se parece a esto:
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
 
-![Figura 1.3][4]
+![Figure 1.4](images/internet_4.png)
 
- [4]: images/internet_2.png
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
 
-Imagina que cuando escribes https://djangogirls.org, estas enviando una carta que dice: "Queridos Django Girls, me gustaría ver su sitio web djangogrils.org. Por favor, envíenmelo!"
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
 
-Tu carta va hacia la oficina de correo más cercana. Luego va a otra un poco más cercana de su destinatario, luego a otra y a otra hasta que es entregada en su destino. La única cosa diferente es que si tu envías cartas (*paquetes de datos*) con frecuencia al mismo lugar, cada carta puede pasar por oficinas de correos (*routers*) totalmente diferentes, dependiendo de cómo se distribuyen en cada oficina.
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
 
-![Figura 1.4][5]
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
 
- [5]: images/internet_4.png
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
 
-Sí, es tan simple como eso. Enviar mensajes y esperar alguna respuesta. Por supuesto, en vez de papel y lapicera usas bytes de datos, ¡pero la idea es la misma!
-
-En lugar de direcciones con el nombre de la calle, ciudad, código postal y nombre del país, utilizamos direcciones IP. Tu computadora pide primero el DNS (Domain Name System - en español Sistema de Nombres de Dominio) para traducir djangogirls.org a una dirección IP. Funciona como los viejos directorios telefónicos donde puedes buscar el nombre de la persona que se deseas contactar y este nos muestra su número de teléfono y dirección.
-
-Cuando envías una carta, ésta necesita tener ciertas características para ser entregada correctamente: una dirección, sello, etc. También utilizas un lenguaje que el receptor pueda entender, ¿cierto? Lo mismo sucede con los *paquetes de datos* que envías para ver un sitio web: utilizas un protocolo llamado HTTP (Hypertext Transfer Protocol - en español Protocolo de Transferencia de Hipertexto).
-
-Así que, básicamente, cuando tienes un sitio web necesitas tener un *servidor* (la máquina) donde vive. El *servidor* está esperando cualquier *solicitud* entrante (cartas que piden al servidor que envíe tu sitio web) y éste responde enviando tu sitio web (en otra carta).
-
-Puesto que este es un tutorial de Django, seguro te preguntarás qué es lo que hace Django. Bueno, cuando envías una respuesta, no siempre quieres enviar lo mismo a todo el mundo. Es mucho mejor si tus cartas son personalizadas, especialmente para la persona que acaba de escribir, ¿cierto? Django nos ayuda con la creación de estas cartas personalizadas :).
-
-Basta de charlas, ¡pongamos manos a la obra!
+Enough talk – time to create!
\ No newline at end of file
diff --git a/es/html/README.md b/es/html/README.md
index acfc1e723ae..004985089c2 100755
--- a/es/html/README.md
+++ b/es/html/README.md
@@ -1,210 +1,213 @@
-# Introducción a HTML
+# Introduction to HTML
 
-Te estarás preguntando, ¿qué es una plantilla?
+What's a template, you may ask?
 
-Una plantilla es un archivo que podemos reutilizar para presentar información diferente de forma consistente - por ejemplo, se podría utilizar una plantilla para ayudarte a escribir una carta, porque aunque cada carta puede contener un mensaje distinto y dirigirse a una persona diferente, compartirán el mismo formato.
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
 
-El formato de una plantilla de Django se describe en un lenguaje llamado HTML (que es el código HTML que mencionamos en el primer capítulo **Cómo funciona Internet**).
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
 
-## ¿Qué es HTML?
+## What is HTML?
 
-HTML es un simple código que es interpretado por tu navegador web - como Chrome, Firefox o Safari - para mostrar una página web al usuario.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
-HTML significa HyperText Markup Language - en español, Lenguaje de Marcas de HyperTexto. **HyperText** significa que es un tipo de texto que soporta hipervínculos entre páginas. **Markup** significa que hemos tomado un documento y lo hemos marcado con código para decirle a algo (en este caso, un navegador) cómo interpretar la página. El código HTML está construido con **etiquetas**, cada una comenzando con `<` y terminando con `>`. Estas etiquetas de marcado son **elementos**.
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
 
-## ¡Tu primera plantilla!
+## Your first template!
 
-Crear una plantilla significa crear un archivo de plantilla. Todo es un archivo, ¿verdad? Probablemente hayas notado esto ya.
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
 
-Las plantillas se guardan en el directorio de `blog/templates/blog`. Así que primero crea un directorio llamado `templates` dentro de tu directorio blog. Luego crea otro directorio llamado `blog` dentro de tu directorio de templates:
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
 
     blog
     └───templates
         └───blog
     
 
-(Tal vez te preguntes por qué necesitamos dos directorios llamados `blog` - como descubrirás más adelante, esto es simplemente una útil convención de nomenclatura que hace la vida más fácil cuando las cosas empiezan a complicarse más.)
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
 
-Y ahora crea un archivo `post_list.html` (déjalo en blanco por ahora) dentro de la carpeta `blog/templates/blog`.
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
 
-Mira cómo se ve su sitio web ahora: http://127.0.0.1:8000/
+See how your website looks now: http://127.0.0.1:8000/
 
-> Si todavía tienes un error `TemplateDoesNotExists`, intenta reiniciar el servidor. Ve a la línea de comandos, detén el servidor pulsando Ctrl + C (teclas Control y C juntas) y comienza de nuevo mediante la ejecución del comando `python manage.py runserver`.
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
 
-![Figura 11.1][1]
+![Figure 11.1](images/step1.png)
 
- [1]: images/step1.png
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
 
-¡Ningún error más! Felicidades :) Sin embargo, por ahora, tu sitio web no está publicando nada excepto una página en blanco, porque la plantilla también está vacía. Tenemos que arreglarlo.
+Add the following to your template file:
 
-Añade lo siguiente a tu archivo de plantilla:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-``` html
-    <html>
-        <p>Hi there!</p>
-        <p>It works!</p>
-    </html>
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
 ```
 
-¿Cómo luce ahora tu sitio web? Haz click para ver: http://127.0.0.1:8000/
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
 
-![Figura 11.2][2]
+![Figure 11.2](images/step3.png)
 
- [2]: images/step3.png
+It worked! Nice work there :)
 
-¡Funcionó! Buen trabajo :)
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
 
-*   La etiqueta más básica, `<html >`, es siempre el principio de cualquier página web y `</html >` es siempre el final. Como puedes ver, todo el contenido de la página web va desde el principio de la etiqueta `<html >` y hasta la etiqueta de cierre `</html >`
-*   `<p>` es una etiqueta para los elementos de párrafo; `</p>` cierra cada párrafo
+## Head and body
 
-## Cabeza & cuerpo
+Each HTML page is also divided into two elements: **head** and **body**.
 
-Cada página HTML también se divide en dos elementos: **head** y **body**.
+* **head** is an element that contains information about the document that is not displayed on the screen.
 
-*   **head** es un elemento que contiene información sobre el documento que no se muestra en la pantalla.
+* **body** is an element that contains everything else that is displayed as part of the web page.
 
-*   **body** es un elemento que contiene todo lo que se muestra como parte de la página web.
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
 
-Usamos `<head>` para decirle al navegador acerca de la configuración de la página y `<body>` para decir lo que realmente está en la página.
+For example, you can put a web page title element inside the `<head>`, like this:
 
-Por ejemplo, puedes ponerle un título a la página web dentro de la `<head>`, así:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-``` html
-    <html>
-        <head>
-            <title>Ola's blog</title>
-        </head>
-        <body>
-            <p>Hi there!</p>
-            <p>It works!</p>
-        </body>
-    </html>
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
 ```
 
-Guarda el archivo y actualiza tu página.
+Save the file and refresh your page.
 
-![Figura 11.3][3]
+![Figure 11.3](images/step4.png)
 
- [3]: images/step4.png
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
 
-¿Observas cómo el navegador ha comprendido que "Ola's blog" es el título de tu página? Ha interpretado `<title>Ola's blog</title>` y colocó el texto en la barra de título de tu navegador (también se utilizará para marcadores y así sucesivamente).
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
 
-Probablemente también hayas notado que cada etiqueta de apertura coincide con una *etiqueta de cierre*, con un `/`, y que los elementos son *anidados* (es decir, no puedes cerrar una etiqueta particular hasta que todos los que estaban en su interior se hayan cerrado también).
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
 
-Es como poner cosas en cajas. Tienes una caja grande, `<html></html>`; en su interior hay `<body></body>`, y que contiene las cajas aún más pequeñas: `<p></p>`.
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
 
-Tienes que seguir estas reglas de etiquetas de *cierre* y de *anidación* de elementos - si no lo haces, el navegador puede no ser capaz de interpretarlos correctamente y tu página se mostrará incorrectamente.
+## Customize your template
 
-## Personaliza tu plantilla
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
 
-¡Ahora puedes divertirte un poco y tratar de personalizar tu plantilla! Aquí hay algunas etiquetas útiles para eso:
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
 
-*   `<h1>Un título</h1>` - para tu título más importante
-*   `<h2>Un subtítulo</h2>` - para el título del siguiente nivel
-*   `<h3>Un subsubtítulo</h3>` - ... y así hasta `<h6>`
-*   `<em>texto</em>` - pone en cursiva tu texto
-*   `<strong>texto</strong>` - pone en negrita tu texto
-*   `<br />` - un salto de línea (no puedes colocar nada dentro de br)
-*   `<a href="https://djangogirls.org">link</a>` - crea un vínculo
-*   `<ul><li>primer elemento</li><li>segundo elemento</li></ul>` - crea una lista, ¡igual que esta!
-*   `<div></div>` - define una sección de la página
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
 
-Aquí hay un ejemplo de una plantilla completa:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-``` html
-    <html>
-        <head>
-            <title>Django Girls blog</title>
-        </head>
-        <body>
-            <div>
-                <h1><a href="">Django Girls Blog</a></h1>
-            </div>
-    
-            <div>
-                <p>published: 14.06.2014, 12:14</p>
-                <h2><a href="">My first post</a></h2>
-                <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
-            </div>
-    
-            <div>
-                <p>published: 14.06.2014, 12:14</p>
-                <h2><a href="">My second post</a></h2>
-                <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
-            </div>
-        </body>
-    </html>
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
 ```
 
-Aquí hemos creado tres secciones `div`.
+We've created three `div` sections here.
 
-*   El primer elemento `div` contiene el título de nuestro blog - es un encabezado y un enlace
-*   Otros dos elementos `div` contienen nuestros posts con la fecha de publicación, `h2` con un título que es clickeable y dos `p` (párrafo) de texto, uno para la fecha y uno para nuestro post.
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
 
-Nos da este efecto:
+It gives us this effect:
 
-![Figura 11.4][4]
+![Figure 11.4](images/step6.png)
 
- [4]: images/step6.png
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
 
-¡Yaaay! Pero hasta el momento, nuestra plantilla sólo muestra exactamente **la misma información** - considerando que antes hablábamos de plantillas que nos permitirían mostrar información **diferente** en el **mismo formato**.
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
 
-Lo que queremos realmente es mostrar posts reales añadidos en nuestra página de administración de Django - y ahí es a donde vamos a continuación.
+## One more thing: deploy!
 
-## Una cosa más: ¡despliega!
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
 
-Sería bueno ver todo esto disponible en Internet, ¿no? Hagamos otro despliegue en PythonAnywhere:
+### Commit, and push your code up to Github
 
-### Haz un commit y sube tu código a GitHub
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
 
-En primer lugar, veamos qué archivos han cambiado desde que hicimos el despliegue por última vez:
+{% filename %}command-line{% endfilename %}
 
     $ git status
     
 
-Asegúrate de que estás en el directorio `djangogirls` y vamos a decirle a `git` que incluya todos los cambios dentro de este directorio:
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
 
     $ git add --all .
     
 
-> **Nota** `-A` (abreviatura de "all") significa que `git` también reconocerá si has eliminado archivos (por defecto, sólo reconoce archivos nuevos/modificados). También recuerda (del capítulo 3) que `.` significa el directorio actual.
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
 
-Antes de que subamos todos los archivos, vamos a ver qué es lo que `git` subirá (todos los archivos que `git` cargará deberían aparecer en verde):
+{% filename %}command-line{% endfilename %}
 
     $ git status
     
 
-Ya casi estamos, ahora es tiempo de decirle que guarde este cambio en su historial. Vamos a darle un "mensaje de commit" donde describimos lo que hemos cambiado. Puedes escribir cualquier cosa que te gustaría en esta etapa, pero es útil escribir algo descriptivo para que puedes recordar lo que has hecho en el futuro.
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
 
-    $ git commit -m "Cambie el HTML para la página."
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
     
 
-> **Nota** Asegúrate de usar comillas dobles alrededor del mensaje de commit.
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
 
-Una vez que hicimos esto, subimos (push) nuestros cambios a PythonAnywhere:
+{% filename %}command-line{% endfilename %}
 
-    git push
+    $ git push
     
 
-### Descarga tu nuevo código a PythonAnywhere y actualiza tu aplicación web
+### Pull your new code down to PythonAnywhere, and reload your web app
 
-*   Abre la [página de consolas de PythonAnywhere][5] y ve a tu **consola Bash** (o comienza una nueva). Luego, ejecuta:
-    
-```
-$ cd ~/my-first-blog
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
 
- [5]: https://www.pythonanywhere.com/consoles/
+{% filename %}command-line{% endfilename %}
 
-Y mira cómo tu código se descarga. Si quieres comprobar que ya ha terminado, puedes ir a la pestaña **Files** y ver tu código en PythonAnywhere.
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
 
-*   Finalmente, dirígete a la pestaña [Web][6] y selecciona **Reload** en tu aplicación web.
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
 
- [6]: https://www.pythonanywhere.com/web_app_setup/
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
 
-¡Tu actualización debería estar en línea! Actualiza tu sitio web en el navegador. Ahora deberías poder ver tus cambios :)
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/es/installation/README.md b/es/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/es/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/es/intro_to_command_line/README.md b/es/intro_to_command_line/README.md
index de1565f63c0..5fb6d48dd1f 100755
--- a/es/intro_to_command_line/README.md
+++ b/es/intro_to_command_line/README.md
@@ -1,97 +1,154 @@
-# Introducción a la interfaz de línea de comandos
+# Introduction to the command-line interface
 
-Es emocionante, ¿verdad? Vas a escribir tu primera línea de código en pocos minutos :)
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
 
-**Permítenos presentarte a tu primer nuevo amigo: ¡la línea de comandos!**
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
 
-Los siguientes pasos te mostrarán cómo usar aquella ventana negra que todos los hackers usan. Puede parecer un poco aterrador al principio pero es solo un mensaje en pantalla que espera a que le des órdenes.
+**Let us introduce you to your first new friend: the command line!**
 
-## ¿Qué es la línea de comandos?
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
 
-La ventana, que generalmente es llamada **línea de comandos** o **interfaz de línea de comandos**, es una aplicación basada en texto para ver, manejar y manipular archivos en tu computadora (como por ejemplo el Explorador de Windows o Finder en Mac, pero sin la interfaz gráfica). Otros nombres para la línea de comandos son: *cmd*, *CLI*, *símbolo del sistema*, *consola* o *terminal*.
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
 
-## Abrir la interfaz de línea de comandos
+## What is the command line?
 
-Lo primero que debemos hacer para empezar a experimentar con nuestra interfaz de linea de comandos es abrirla.
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
 
-### Windows
+## Open the command-line interface
 
-Ir al menú Inicio → Todos los programas → Accesorios → Command Prompt
+To start some experiments we need to open our command-line interface first.
 
-### Mac OS X
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
 
-Aplicaciones → Servicios → Terminal
+Go to Start menu → Windows System → Command Prompt.
 
-### Linux
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
 
-Está probablemente en Aplicaciones → Accesorios → Terminal, pero eso depende de tu distribución. Si no lo encuentras, Googlealo :)
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
 
 ## Prompt
 
-Ahora deberías ver una ventana blanca o negra que está esperando tus órdenes.
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
 
-Si estás en Mac o Linux, probablemente verás `$`, así:
+{% filename %}command-line{% endfilename %}
 
     $
     
 
-En Windows, es un signo así `>`, como este:
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
 
     >
     
 
-Cada comando será precedido por este signo y un espacio, pero no tienes que escribirlo. Tu computadora lo hará por ti :)
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
 
-> Sólo una pequeña nota: en tu caso, tal vez hay algo como `C:\Users\ola>` o `Olas-MacBook-Air:~ ola$` antes del prompt y eso es 100% correcto. En este tutorial lo simplificaremos lo más posible.
+## Your first command (YAY!)
 
-## Tu primer comando (¡YAY!)
+Let's start by typing this command:
 
-Vamos a empezar con algo simple. Escribe este comando:
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ whoami
     
 
-o
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > whoami
     
 
-Y luego oprime la tecla Enter. Este es el resultado:
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
 
-    $ whoami olasitarska
+    $ whoami
+    olasitarska
     
 
-Como puedes ver, la computadora sólo te presentó tu nombre de usuario. Bien, ¿eh? :)
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
 
-> Trata de escribir cada comando, no copies y pegues. ¡Te acordarás más de esta manera!
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
 
-## Básicos
+### Current directory
 
-Cada sistema operativo tiene un conjunto diferente de comandos para la línea de comandos, así que asegúrate de seguir las instrucciones para tu sistema operativo. Vamos a intentarlo, ¿de acuerdo?
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
 
-### Directorio actual
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
 
-Sería bueno saber dónde estamos ahora, ¿cierto? Vamos a ver. Escribe este comando y oprime Enter:
+{% filename %}command-line{% endfilename %}
 
     $ pwd
     /Users/olasitarska
     
 
-Si estás en Windows:
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
 
-    > cd 
+{% filename %}command-line{% endfilename %}
+
+    > cd
     C:\Users\olasitarska
     
 
-Probablemente verás algo similar en tu máquina. Una vez que abres la línea de comandos generalmente empiezas en el directorio home de tu usuario.
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
 
-> Nota: 'pwd' significa 'print working directory' - en español, 'mostrar directorio de trabajo'.
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
 
 * * *
 
-### Lista de archivos y directorios
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
 
-¿Qué hay aquí? Sería bueno saber. Veamos:
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ ls
     Applications
@@ -101,175 +158,272 @@ Probablemente verás algo similar en tu máquina. Una vez que abres la línea de
     ...
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > dir
-    Directory of C:\Users\olasitarska
-    05/08/2014 07:28 PM <DIR> Applications
-    05/08/2014 07:28 PM <DIR> Desktop
-    05/08/2014 07:28 PM <DIR> Downloads
-    05/08/2014 07:28 PM <DIR> Music
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
     ...
     
 
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
 * * *
 
-### Cambia el directorio actual
+### Change current directory
+
+Now, let's go to our Desktop directory:
 
-¿Quizás podemos ir a nuestro escritorio?
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ cd Desktop
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd Desktop
     
 
-Comprueba si realmente ha cambiado:
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
 
-    $ pwd 
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
     /Users/olasitarska/Desktop
     
 
-Windows:
+<!--endsec-->
 
-    > cd 
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
     C:\Users\olasitarska\Desktop
     
 
-¡Aquí está!
+<!--endsec-->
+
+Here it is!
 
-> Pro tip: si escribes `cd D` y luego oprimes `tab` en el teclado, la línea de comandos automáticamente completará el resto del nombre para que puedas navegar más rápido. Si hay más de una carpeta que empiece con "D", presiona el botón `tab` dos veces para obtener una lista de opciones.
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
 
 * * *
 
-### Crear directorio
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
 
-¿Qué tal si creamos un directorio de Django Girls en tu escritorio? Puedes hacerlo de esta manera:
+{% filename %}command-line{% endfilename %}
 
-    $ mkdir djangogirls
+    $ mkdir practice
     
 
-Windows:
+<!--endsec-->
 
-    > mkdir djangogirls
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
     
 
-Este pequeño comando creará una carpeta con el nombre `djangogirls` en tu escritorio. ¡Puedes comprobar si está allí buscando en tu escritorio o ejecutando el comando `ls` (si estás usando Mac o Linux) o `dir` (si estás usando Windows)! Inténtalo :)
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
 
-> Pro tip: Si no quieres escribir una y otra vez los mismos comandos, prueba oprimiendo la `flecha arriba` y `flecha abajo` de tu teclado para ver recientes comandos utilizados.
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
 
 * * *
 
-### ¡Ejercicios!
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
 
-Un pequeño reto para ti: en el directorio recién creado `djangogirls` crea un directorio llamado `test`. Utiliza los comandos `cd` y `mkdir`.
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
 
-#### Solución:
+{% filename %}command-line{% endfilename %}
 
-    $ cd djangogirls 
+    $ cd practice
     $ mkdir test
     $ ls
+    test
     
 
-Windows:
+<!--endsec-->
 
-    > cd djangogirls 
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
     > mkdir test
-    > dir 
-    08/05/2014 19:28 < DIR > test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
     
 
-¡Felicitaciones! :)
+<!--endsec-->
+
+Congrats! :)
 
 * * *
 
-### Limpiar
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
 
-No queremos dejar un desorden, así que vamos a eliminar todo lo que hicimos hasta este momento.
+First, we need to get back to Desktop:
 
-En primer lugar, tenemos que volver al escritorio:
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ cd ..
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd ..
     
 
-`cd` `..` cambiará el directorio actual al directorio padre (que significa el directorio que contiene el directorio actual).
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
 
-Revisa dónde estás:
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
 
-    $ pwd 
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
     /Users/olasitarska/Desktop
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
 
-    > cd 
+{% filename %}command-line{% endfilename %}
+
+    > cd
     C:\Users\olasitarska\Desktop
     
 
-Ahora es hora de eliminar el directorio `djangogirls`.
+<!--endsec-->
+
+Now time to delete the `practice` directory:
 
-> **Atención**: Eliminar archivos utilizando `del`, `rmdir` o `rm` hace que no puedan recuperarse, lo que significa que los *archivos borrados desaparecerán para siempre* Debes ser muy cuidadosa con este comando.
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
 
-    $ rm -r djangogirls
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
 
-    > rmdir/s djangogirls 
-    djangogirls, ¿Estás seguro <Y/N>? Y
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
     
 
-Hecho! Asegurémonos que en verdad fueron borrados, vamos a ver:
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ ls
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > dir
     
 
-### Salida
+<!--endsec-->
+
+### Exit
 
-¡Esto es todo por ahora! Ahora puedes cerrar la línea de comandos sin problemas. Vamos a hacerlo al estilo hacker, ¿bien? :)
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ exit
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > exit
     
 
-Genial, ¿no? :)
+<!--endsec-->
 
-## Índice
+Cool, huh? :)
 
-Aquí hay una lista de algunos comandos útiles:
+## Summary
 
-| Comando (Windows) | Comando (Mac OS / Linux) | Descripción                  | Ejemplo                                           |
-| ----------------- | ------------------------ | ---------------------------- | ------------------------------------------------- |
-| exit              | exit                     | Cierra la ventana            | **exit**                                          |
-| cd                | cd                       | Cambia el directorio         | **cd test**                                       |
-| dir               | ls                       | Lista directorios/archivos   | **dir**                                           |
-| copy              | cp                       | Copia de archivos            | **copy c:\test\test.txt c:\windows\test.txt** |
-| move              | mv                       | Mueve archivos               | **move c:\test\test.txt c:\windows\test.txt** |
-| mkdir             | mkdir                    | Crea un nuevo directorio     | **mkdir testdirectory**                           |
-| del               | rm                       | Elimina archivos/directorios | **del c:\test\test.txt**                        |
+Here is a summary of some useful commands:
 
-Estos son solo algunos de los comandos que puedes ejecutar en la línea de comandos. No vas a usar nada más que esos por ahora.
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
 
-Si tienes curiosidad, [ss64.com][1] contiene una referencia completa de comandos para todos los sistemas operativos.
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
 
- [1]: http://ss64.com
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
 
-## ¿Lista?
+## Ready?
 
-¡Vamos a sumergirnos en Python!
+Let's dive into Python!
\ No newline at end of file
diff --git a/es/python_installation/README.md b/es/python_installation/README.md
index ba64077782c..93f81cb42d9 100755
--- a/es/python_installation/README.md
+++ b/es/python_installation/README.md
@@ -1,72 +1,15 @@
-# Vamos a empezar con Python
+# Let’s start with Python
 
-¡Por fin estamos aquí!
+We're finally here!
 
-Pero primero, déjenos decirte qué es Python. Python es un lenguaje de programación muy popular que puede utilizarse para la creación de sitios web, juegos, software académico, gráficos y mucho, mucho más.
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
 
-Python se originó en la década de 1980 y su objetivo principal es ser legible por los seres humanos (¡no sólo para las máquinas!), por eso parece mucho más simple que otros lenguajes de programación. Esto hace que sea más fácil de aprender, pero no te preocupes, ¡Python es también muy poderoso!
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
 
-# Instalación de Python
+# Python installation
 
-> Este subcapítulo se basa en un tutorial de Geek Girls Carrots (https://github.com/ggcarrots/django-carrots/)
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
 
-Django está escrito en Python. Necesitamos Python para cualquier cosa en Django. ¡Vamos a empezar con la instalación! Queremos que instales Python 3.4, así que si tienes alguna versión anterior, deberás actualizarla.
-
-### Windows
-
-Puedes descargar Python para Windows desde el sitio web https://www.python.org/downloads/release/python-343/. Después de descargar el archivo ***.msi**, debes ejecutarlo (haz doble click en el archivo) y sigue las instrucciones. Es importante recordar la ruta (el directorio) donde se ha instalado Python. ¡Será necesario más adelante!
-
-Algo para tener en cuenta: en la segunda pantalla del asistente de instalación, llamada "Customize", asegúrate de ir hacia abajo y elegir la opción "Add python.exe to the Path", como en
-
-![No te olvides de agregar Python al Path][1]
-
- [1]: images/add_python_to_windows_path.png
-
-### Linux
-
-Es muy posible que ya tengas Python instalado. Para verificar que ya lo tienes instalado (y qué versión es), abre una consola y tipea el siguiente comando:
-
-    $ python3 --version
-    Python 3.4.2
-    
-
-Si no tienes Python instalado o si quieres una versión diferente, puedes instalarlo como sigue:
-
-#### Ubuntu
-
-Tipea este comando en tu consola:
-
-    sudo apt-get install python3.4
-    
-
-#### Fedora
-
-Usa este comando en tu consola:
-
-    sudo dnf install python3.4
-    
-
-#### openSUSE
-
-Usa este comando en tu consola:
-
-    sudo zypper install python3
-
-
-### OS X
-
-Debes ir al sitio web https://www.python.org/downloads/release/python-342/ y descargar el instalador de Python:
-
-*   descarga el archivo *DMG* *Mac OS X 64-bit/32-bit installer*,
-*   haz doble click para abrirlo,
-*   doble click en *Python.mpkg* para ejecutar al instalador.
-
-Verifica que la instalación fue exitosa abriendo la *Terminal* y ejecutando el comando `python3`:
-
-    $ python3 --version
-    Python 3.4.2
-    
-
-* * *
-
-Si tienes alguna duda o si algo salió mal y no sabes cómo resolverlo - ¡pide ayuda a tu tutor! Algunas veces las cosas no salen tan fácilmente y es mejor pedir ayuda a alguien con más experiencia.
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/es/python_installation/instructions.md b/es/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/es/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/es/python_introduction/README.md b/es/python_introduction/README.md
index 97c6e1cd0e6..c1642302532 100755
--- a/es/python_introduction/README.md
+++ b/es/python_introduction/README.md
@@ -1,509 +1,710 @@
-# Introducción a Python
+# Introduction to Python
 
-> Parte de este capítulo se basa en tutoriales por Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 
-¡Vamos a escribir algo de código!
+Let's write some code!
 
 ## Python prompt
 
-Para empezar a jugar con Python, tenemos que abrir una *línea de comandos* en nuestra computadora. Ya sabes cómo hacerlo, lo aprendiste en el capítulo de [Introducción a la línea de comandos][1].
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
 
- [1]: /intro_to_command_line/README.html
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
 
-Una vez que estés lista, sigue las siguientes instrucciones.
+Once you're ready, follow the instructions below.
 
-Queremos abrir una consola de Python, así que escribe `python3` y pulsa Enter.
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
 
     $ python3
-    Python 3.4.2 (...)
-    Type "copyright", "credits" or "license" for more information.
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
     >>>
     
 
-## ¡Tu primer comando en Python!
+## Your first Python command!
 
-Después de ejecutar el comando de Python, el cursor cambia a `>>>`. Para nosotros esto significa que por ahora sólo podemos utilizar comandos en el lenguaje Python. No tienes que escribir el `>>>` - Python lo hará por ti.
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
 
-Si deseas salir de la consola de Python en cualquier momento, simplemente escribe `exit()` o usa el atajo `Ctrl + Z` para Windows y `Ctrl + D` para Mac/Linux. Luego no verás más `>>>`.
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
 
-Pero ahora no queremos salir de la consola de Python. Queremos aprender más sobre ella. Vamos a empezar con algo muy simple. Por ejemplo, trata de escribir algo de matemáticas, como `2 + 3` y pulsa Enter.
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
 
-    >>> 2 + 3
-    5
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
 
-¡Bien! ¿Ves como salió la respuesta? ¡Python sabe matemáticas! Podrías intentar otros comandos como:
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
 
 - `4 * 5`
 - `5 - 1`
 - `40 / 2`
 
-Diviértete con esto por un momento y luego vuelve aquí :).
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
 
-Como puedes ver, Python es una gran calculadora. Si te estás preguntando qué más puede hacer...
+As you can see, Python is a great calculator. If you're wondering what else you can do…
 
 ## Strings
 
-¿Y tu nombre? Escribe tu nombre de pila en frases como ésta:
+How about your name? Type your first name in quotes like this:
 
-    >>> "Ola"
-    'Ola'
-    
+{% filename %}command-line{% endfilename %}
 
-¡Has creado tu primer string! Es una secuencia de caracteres que puede ser procesada por una computadora. El string (o en español, cadena) debe comenzar y terminar con el mismo carácter. Esto puede ser comillas simples (`'`) o dobles (`"`) - ellas le dicen a Python que lo que esta dentro es una cadena.
+```python
+>>> "Ola"
+'Ola'
+```
 
-Las cadenas pueden ser concatenadas. Prueba esto:
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
 
-    >>> "Hola " + "Ola"
-    'Hola Ola'
-    
+Strings can be strung together. Try this:
 
-También puedes multiplicar las cadenas con un número:
+{% filename %}command-line{% endfilename %}
 
-    >>> "Ola" * 3
-    'OlaOlaOla'
-    
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
 
-Si necesitas poner un apóstrofe dentro de tu cadena, tienes dos maneras de hacerlo.
+You can also multiply strings with a number:
 
-Usando comillas dobles:
+{% filename %}command-line{% endfilename %}
 
-    >>> "Runnin' down the hill"
-    "Runnin' down the hill"
-    
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
 
-o escapando el apóstrofe con una barra invertida (`\`):
+If you need to put an apostrophe inside your string, you have two ways to do it.
 
-    >>> 'Runnin\' down the hill'
-    "Runnin' down the hill"
-    
+Using double quotes:
 
-Bien, ¿eh? Para ver tu nombre en letras mayúsculas, simplemente escribe:
+{% filename %}command-line{% endfilename %}
 
-    >>> "Ola".upper()
-    'OLA'
-    
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
 
-¡Usaste la **función** `upper` en tu cadena! Una función (como `upper()`) es un conjunto de instrucciones que Python tiene que realizar sobre un objeto determinado (`"Ola"`) una vez que se llama.
+or escaping the apostrophe with a backslash (``):
 
-Si quisieras saber el número de letras que contiene tu nombre, también existe una función para esto.
+{% filename %}command-line{% endfilename %}
 
-    >>> len("Ola")
-    3
-    
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
 
-Te preguntarás por qué a veces se llama a las funciones con un `.` al final de una cadena (como `"Ola".upper()`) y a veces se llama a una función y colocas la cadena entre paréntesis. Bueno, en algunos casos las funciones pertenecen a objetos, como `upper()`, que sólo puede ser utilizado sobre cadenas (upper() es una función de los objetos string). En este caso, llamamos **método** a esta función. Otra veces, las funciones no pertenecen a ningún objeto específico y pueden ser usados en diferentes objetos, como `len()`. Esta es la razón de por qué estamos pasando `"Ola"` como un parámetro a la función `len`.
+Nice, huh? To see your name in uppercase letters, simply type:
 
-### Resumen
+{% filename %}command-line{% endfilename %}
 
-Ok, suficiente sobre las cadenas. Hasta ahora has aprendido sobre:
+```python
+>>> "Ola".upper()
+'OLA'
+```
 
-*   **la terminal** - teclear comandos (código) dentro de la terminal de Python resulta en respuestas de Python
-*   **números y strings** - en Python los números son usados para matemáticas y strings para objetos de texto
-*   **operadores** - como + y *, combina valores para producir uno nuevo
-*   **funciones** - como upper() y len(), realizan opciones sobre los objetos.
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
 
-Estos son los conocimientos básicos que puedes aprender de cualquier lenguaje de programación. ¿Lista para algo un poco más difícil? ¡Apostamos que lo estás!
+If you want to know the number of letters contained in your name, there is a **function** for that too!
 
-## Errores
+{% filename %}command-line{% endfilename %}
 
-Intentemos con algo nuevo. ¿Podríamos obtener la longitud de un número de la misma manera que obtuvimos la longitud de nuestro nombre? Teclea `len(304023)` y presiona Enter:
+```python
+>>> len("Ola")
+3
+```
 
-    >>> len(304023)
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    TypeError: object of type 'int' has no len()
-    
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
 
-¡Obtuvimos nuestro primer error! Dice que los objetos de tipo "int" (números enteros) no tienen ninguna longitud. ¿Qué podemos hacer ahora? Quizás podemos escribir el numero como un string. Los strings tienen longitud, ¿cierto?
+### Summary
 
-    >>> len(str(304023))
-    6
-    
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
 
-¡Funcionó! Utilizamos la función `str` dentro de la función `len`. `str()` convierte todo a strings.
+## Errors
 
-*   La función `str` convierte cosas en **strings**
-*   La función `int` convierte cosas en **integers**
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
 
-> Importante: podemos convertir números en texto, pero no podemos necesariamente convertir texto en números - ¿qué sería `int('hello')`?
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
 
 ## Variables
 
-Un concepto importante en programación son las variables. Una variable no es más que un nombre para alguna cosa para que puedas usarla más tarde. Los programadores usan estas variables para almacenar datos, hacer su código más legible y así no tener que seguir recordando qué hace cada cosa.
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
 
-Supongamos que queremos crear una nueva variable llamada `name`:
+Let's say we want to create a new variable called `name`:
 
-    >>> name = "Ola"
-    
+{% filename %}command-line{% endfilename %}
 
-¿Ves? ¡Es fácil! Es simplemente: name equivale a Ola.
+```python
+>>> name = "Ola"
+```
 
-Como te has dado cuenta, el programa no regresa algo como lo hacia antes. Entonces, ¿Cómo sabemos que la variable existe realmente? Simplemente introduce `name` y pulsa Enter:
+We type name equals Ola.
 
-    >>> name
-    'Ola'
-    
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
 
-¡Súper! Tu primer variable :). Siempre podrás cambiar a lo que se refiere:
+{% filename %}command-line{% endfilename %}
 
-    >>> name = "Sonja"
-    >>> name
-    'Sonja'
-    
+```python
+>>> name
+'Ola'
+```
 
-Puedes usarla dentro de funciones también:
+Yippee! Your first variable! :) You can always change what it refers to:
 
-    >>> len(name)
-    5
-    
+{% filename %}command-line{% endfilename %}
 
-Increíble, ¿verdad? Por supuesto, las variables pueden ser cualquier cosa, ¡también números! Prueba esto:
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
 
-    >>> a = 4
-    >>> b = 6
-    >>> a * b
-    24
-    
+You can use it in functions too:
 
-Pero ¿qué pasa si usamos el nombre equivocado? ¿Puedes adivinar qué pasaría? ¡Vamos a probar!
+{% filename %}command-line{% endfilename %}
 
-    >>> city = "Tokyo"
-    >>> ctiy
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    NameError: name 'ctiy' is not defined
-    
+```python
+>>> len(name)
+5
+```
 
-¡Un error! Como puedes ver, Python tiene diferentes tipos de errores y este se llama **NameError**. Python te dará este error si intentas utilizar una variable que no ha sido definida aún. Si más adelante te encuentras con este error, verifica tu código para ver si no has escrito mal una variable.
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
 
-Juega con esto por un rato y mira que puedes hacer!
+{% filename %}command-line{% endfilename %}
 
-## La función print
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
 
-Intenta esto:
+But what if we used the wrong name? Can you guess what would happen? Let's try!
 
-    >>> name = 'Maria'
-    >>> name
-    'Maria'
-    >>> print(name)
-    Maria
-    
+{% filename %}command-line{% endfilename %}
 
-Cuando sólo escribes `name`, el intérprete de Python responde con la *representación* del string de la variable 'name', que son las letras M-a-r-i-a, rodeadas de comillas simples ''. Cuando dices `print(name)`, Python va a "imprimir" el contenido de la variable a la pantalla, sin las comillas, que es mejor.
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
 
-Como veremos después, `print()` también es útil cuando queremos imprimir cosas desde adentro de las funciones, o bien cuando queremos imprimir cosas en múltiples líneas.
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
 
-## Listas
+Play with this for a while and see what you can do!
 
-Además de string e integers, Python tiene toda clase de diferentes tipos de objetos. Ahora vamos a introducir uno llamado **list**. Las listas son exactamente lo que piensas que son: son objetos que son listas de otros objetos :)
+## The print function
 
-Anímate y crea una lista:
+Try this:
 
-    >>> []
-    []
-    
+{% filename %}command-line{% endfilename %}
 
-Sí, esta lista está vacía. No es muy útil, ¿verdad? Vamos a crear una lista de números de lotería. No queremos repetir todo el tiempo, así que los pondremos en una variable también:
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
 
-    >>> lottery = [3, 42, 12, 19, 30, 59]
-    
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
 
-Muy bien, ¡tenemos una lista! ¿Qué podemos hacer con ella? Vamos a ver cuántos números de lotería hay en la lista. ¿Tienes alguna idea de qué función deberías usar para eso? ¡Ya sabes esto!
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
 
-    >>> len(lottery)
-    6
-    
+## Lists
 
-¡Sí! `len()` puede darte el número de objetos en una lista. Útil, ¿verdad? Tal vez la ordenemos ahora:
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
 
-    >>> lottery.sort()
-    
+Go ahead and create a list:
 
-Esto no devuelve nada, sólo cambió el orden en que los números aparecen en la lista. Vamos a imprimir la lista otra vez y ver que pasó:
+{% filename %}command-line{% endfilename %}
 
-    >>> print(lottery)
-    [3, 12, 19, 30, 42, 59]
-    
+```python
+>>> []
+[]
+```
 
-Como puedes ver, los números en tu lista ahora están ordenados de menor a mayor. ¡Felicidades!
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
 
-¿Te gustaría invertir ese orden? ¡Vamos a hacerlo!
+{% filename %}command-line{% endfilename %}
 
-    >>> lottery.reverse()
-    >>> print(lottery)
-    [59, 42, 30, 19, 12, 3]
-    
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
 
-Fácil, ¿no? Si quieres añadir algo a tu lista, puedes hacerlo escribiendo este comando:
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
 
-    >>> lottery.append(199)
-    >>> print(lottery)
-    [59, 42, 30, 19, 12, 3, 199]
-    
+{% filename %}command-line{% endfilename %}
 
-Si deseas mostrar sólo el primer número, puedes hacerlo mediante el uso de **indexes** (en español, índices). Un índice es el número que te dice dónde en una lista aparece un ítem. La computadora inicia la cuenta en 0, así que el primer objeto en tu lista está en el índice 0, el siguiente es 1, y así sucesivamente. Intenta esto:
+```python
+>>> len(lottery)
+6
+```
 
-    >>> print(lottery[0])
-    59
-    >>> print(lottery[1])
-    42
-    
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
 
-Como puedes ver, puedes acceder a diferentes objetos en tu lista utilizando el nombre de la lista y el índice del objeto dentro de corchetes.
+{% filename %}command-line{% endfilename %}
 
-Para diversión adicional, prueba algunos otros índices: 6, 7, 1000, -1, -6 ó -1000. A ver si se puedes predecir el resultado antes de intentar el comando. ¿Tienen sentido los resultados?
+```python
+>>> lottery.sort()
+```
 
-Puedes encontrar una lista de todos los métodos disponibles para listas en este capítulo de la documentación de Python: https://docs.python.org/3/tutorial/datastructures.html
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
 
-## Diccionarios
+{% filename %}command-line{% endfilename %}
 
-Un diccionario es similar a una lista, pero accedes a valores usando una clave en vez de un índice. Una clave puede ser cualquier cadena o número. La sintaxis para definir un diccionario vacío es:
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
 
-    >>> {}
-    {}
-    
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
 
-Esto demuestra que acabas de crear un diccionario vacío. ¡Hurra!
+Maybe we want to reverse that order? Let's do that!
 
-Ahora, trata escribiendo el siguiente comando (intenta reemplazando con propia información):
+{% filename %}command-line{% endfilename %}
 
-    >>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
-    
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
 
-Con este comando, acabas de crear una variable `participant` con tres pares clave-valor:
+If you want to add something to your list, you can do this by typing this command:
 
-*   La clave `name` apunta al valor `'Ola'` (un objeto `string`),
-*   `country` apunta a `'Poland'` (otro `string`),
-*   y `favorite_numbers` apunta a `[7, 42, 92]` (una `list` con tres números en ella).
+{% filename %}command-line{% endfilename %}
 
-Puedes verificar el contenido de claves individuales con esta sintaxis:
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
 
-    >>> print(participant['name'])
-    Ola
-    
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
 
-Lo ves, es similar a una lista. Pero no necesitas recordar el índice - sólo el nombre.
+{% filename %}command-line{% endfilename %}
 
-¿Qué pasa si le pedimos a Python el valor de una clave que no existe? ¿Puedes adivinar? ¡Pruébalo y verás!
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
 
-    >>> participant['age']
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    KeyError: 'age'
-    
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
 
-¡Mira, otro error! Este es un **KeyError**. Python te ayuda y te dice que la llave `'age'` no existe en este diccionario.
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
 
-¿Cuándo utilizar un diccionario o una lista? Bueno, eso es un buen punto para reflexionar. Sólo ten una solución en mente antes de mirar la respuesta en la siguiente línea.
+That worked like a charm!
 
-*   ¿Sólo necesitas una secuencia ordenada de elementos? Usa una lista.
-*   ¿Necesitas asociar valores con claves, así puedes buscarlos eficientemente (usando las claves) más adelante? Utiliza un diccionario.
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
 
-Los diccionarios, como las listas, son *mutables*, lo que significa que pueden ser cambiados después de ser creados. Puedes agregar nuevos pares clave/valor en el diccionario después de que ha sido creado, por ejemplo:
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
 
-    >>> participant['favorite_language'] = 'Python'
-    
+## Dictionaries
 
-Como en las listas, el método `len()` en los diccionarios, devuelve el número de pares clave-valor en el diccionario. Adelante, escribe el comando:
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
 
-    >>> len(participant)
-    4
-    
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
 
-Espero tenga sentido hasta ahora. :) ¿Lista para más diversión con los diccionarios? Salta a la siguiente línea para algunas cosas sorprendentes.
+{% filename %}command-line{% endfilename %}
 
-Puedes utilizar el comando `pop()` para borrar un elemento en el diccionario. Por ejemplo, si deseas eliminar la entrada correspondiente a la clave `'favorite_numbers'`, sólo tienes que escribir el siguiente comando:
+```python
+>>> {}
+{}
+```
 
-    >>> participant.pop('favorite_numbers')
-    >>> participant
-    {'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
-    
+This shows that you just created an empty dictionary. Hurray!
 
-Como puedes ver en la salida, el par de clave-valor correspondiente a la clave 'favorite_numbers' ha sido eliminado.
+Now, try writing the following command (try substituting your own information, too):
 
-Además de esto, también puedes cambiar un valor asociado a una clave ya creada en el diccionario. Teclea:
+{% filename %}command-line{% endfilename %}
 
-    >>> participant['country'] = 'Germany'
-    >>> participant
-    {'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
-    
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
 
-Como puedes ver, el valor de la clave `'country'` ha sido modificado de `'Poland'` a `'Germany'`. :) ¿Emocionante? ¡Hurra! Has aprendido otra cosa asombrosa.
+With this command, you just created a variable named `participant` with three key–value pairs:
 
-### Resumen
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
 
-¡Genial! Sabes mucho sobre programación ahora. En esta última parte aprendiste sobre:
+You can check the content of individual keys with this syntax:
 
-*   **errors** - ahora sabes cómo leer y entender los errores que aparecen si Python no entiende un comando que le has dado
-*   **variables** - nombres para los objetos que te permiten codificar más fácilmente y hacer el código más legible
-*   **lists** - listas de objetos almacenados en un orden determinado
-*   **dictionaries** - objetos almacenados como pares clave-valor
+{% filename %}command-line{% endfilename %}
 
-¿Emocionada por la siguiente parte? :)
+```python
+>>> print(participant['name'])
+Ola
+```
 
-## Compara cosas
+See, it's similar to a list. But you don't need to remember the index – just the name.
 
-Una gran parte de la programación incluye comparar cosas. ¿Qué es lo más fácil para comparar? Números, por supuesto. Vamos a ver cómo funciona:
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
 
-    >>> 5 > 2
-    True
-    >>> 3 < 1
-    False
-    >>> 5 > 2 * 2
-    True
-    >>> 1 == 1
-    True
-    >>> 5 != 2
-    True
-    
+{% filename %}command-line{% endfilename %}
 
-Le dimos a Python algunos números para comparar. Como puedes ver, Python no sólo puede comparar números, sino que también puede comparar resultados de método. Bien, ¿eh?
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
 
-¿Te preguntas por qué pusimos dos signos igual `==` al lado del otro para comparar si los números son iguales? Utilizamos un solo `=` para asignar valores a las variables. Siempre, **siempre** es necesario poner dos `==` Si deseas comprobar que las cosas son iguales entre sí. También podemos afirmar que las cosas no son iguales a otras. Para eso, utilizamos el símbolo `!=`, como mostramos en el ejemplo anterior.
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
 
-Da dos tareas más a Python:
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
 
-    >>> 6 >= 12 / 2
-    True
-    >>> 3 <= 2
-    False
-    
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
 
-`>` y `<` son fáciles, pero ¿qué es significa `> =` y `< =`? Se leen así:
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
 
-*   x `>` y significa: x es mayor que y
-*   x `<` y significa: x es menor que y
-*   x `<=` y significa: x es menor o igual que y
-*   x `>=` y significa: x es mayor o igual que y
+{% filename %}command-line{% endfilename %}
 
-¡Genial! ¿Quieres hacer uno mas? Intenta esto:
+```python
+>>> participant['favorite_language'] = 'Python'
+```
 
-    >>> 6 > 2 and 2 < 3
-    True
-    >>> 3 > 2 and 2 < 1
-    False
-    >>> 3 > 2 or 2 < 1
-    True
-    
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
 
-Puedes darle a Python todos los números para comparar que quieras, y siempre te dará una respuesta. Muy inteligente, ¿verdad?
+{% filename %}command-line{% endfilename %}
 
-*   **and** - si utilizas el operador `and`, ambas comparaciones deben ser True para que el resultado de todo el comando sea True
-*   **or** - si utilizas el operador `or`, sólo una de las comparaciones tiene que ser True para que el resultado de todo el comando sea True
+```python
+>>> len(participant)
+4
+```
 
-¿Has oído la expresión "comparar peras con manzanas"? Vamos a probar el equivalente en Python:
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
 
-    >>> 1 > 'django'
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    TypeError: unorderable types: int() > str()
-    
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
 
-Aquí verás que al igual que en la expresión, Python no es capaz de comparar un número (`int`) y un string (`str`). En cambio, muestra un **TypeError** y nos dice que los dos tipos no se pueden comparar.
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
 
 ## Boolean
 
-Por cierto, acabas de aprender acerca de un nuevo tipo de objeto en Python. Se llama un **Boolean** -- y es probablemente el tipo más simple que existe.
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
 
-Hay sólo dos objetos Boolean: - True - False
+There are only two Boolean objects:
 
-Pero para que Python entienda esto, es necesario que siempre lo escribas como True (primera letra mayúscula, con el resto de la letras minúsculas). **true, TRUE, tRUE no funcionarán -- sólo True es correcto.** (Lo mismo aplica a False también, por supuesto.)
+- True
+- False
 
-Los valores booleanos pueden ser variables, también. Ve el siguiente ejemplo:
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
 
-    >>> a = True
-    >>> a
-    True
-    
+Booleans can be variables, too! See here:
 
-También puedes hacerlo de esta manera:
+{% filename %}command-line{% endfilename %}
 
-    >>> a = 2 > 5
-    >>> a
-    False
-    
+```python
+>>> a = True
+>>> a
+True
+```
 
-Practica y diviértete con los booleanos ejecutando los siguientes comandos:
+You can also do it this way:
 
-*   `True and True`
-*   `False and True`
-*   `True or 1 == 1`
-*   `1 != 2`
+{% filename %}command-line{% endfilename %}
 
-¡Felicidades! Los booleanos son una de las funciones más geniales en programación y acabas de aprender cómo usarlos.
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
 
-# ¡Guárdalo!
+Practice and have fun with Booleans by trying to run the following commands:
 
-Hasta ahora hemos estado escribiendo nuestro código Python en el intérprete, lo cual nos limita a una línea de código a la vez. Normalmente los programas son guardados en archivos y son ejecutados por el **intérprete** o **compilador** de nuestro lenguaje de programación. Hasta ahora, hemos estado corriendo nuestros programas de a una línea por vez en el **intérprete** de Python. Necesitaremos más de una línea de código para las siguientes tareas, entonces necesitaremos hacer rápidamente lo que sigue:
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
 
-*   Salir del intérprete de Python
-*   Abrir el editor de texto de nuestra elección
-*   Guardar algo de código en un nuevo archivo de Python
-*   ¡Ejecutarlo!
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
 
-Para salir del intérprete de Python que hemos estado usando, simplemente escribe la función exit():
+# Save it!
 
-    >>> exit()
-    $
-    
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
 
-Esto te llevará de vuelta a la línea de comandos.
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
 
-Anteriormente, elegimos un editor de código en la sección de [Editor de código][2]. Tendremos que abrir el editor ahora y escribir algo de código en un archivo nuevo:
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
 
- [2]: ../code_editor/README.md
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
 
-``` python
-    print('Hello, Django girls!')
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
 ```
 
-> **Nota** Deberías notar una de las cosas más geniales de los editores de código: ¡los colores! En la consola de Python, todo era del mismo color, pero ahora puedes ver que la función `print` es de un color diferente del string que está adentro de ella. Eso se denomina "resaltado de sintaxis", y es una gran ayuda cuando estás programando. Presta atención a los colores, y obtendrás una pista cuando te olvides de cerrar un string o cometes un error al escribir una palabra clave (como el `def` en una función, que veremos abajo). Esta es una de las razones por las cuales usar un editor de código :)
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
 
-Obviamente, ahora eres una desarrolladora Python muy experimentada, así que siéntete libre de escribir algo del código que has aprendido hoy.
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
 
-Ahora tenemos que guardar el archivo y asignarle un nombre descriptivo. Vamos a llamar al archivo **python_intro.py** y guardarlo en tu escritorio. Podemos nombrar el archivo de cualquier manera que queramos, lo importante aquí es asegurarse que el archivo finalice con **.py**, esto le indica a nuestra computadora que este es un **archivo ejecutable de Python** y que Python puede correrlo.
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
 
-Con el archivo guardado, ¡es hora de ejecutarlo! Utilizando las habilidades que has aprendido en la sección de línea de comandos, utiliza la terminal para **cambiar los directorios** e ir al escritorio.
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
 
-En una Mac, el comando se verá algo como esto:
+On a Mac, the command will look something like this:
 
-    cd ~/Desktop
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
     
 
-En Linux, va a ser así (la palabra "Desktop" puede estar traducida a tu idioma):
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
 
-    cd ~/Desktop
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
     
 
-Y en Windows, será así:
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
 
-    cd %HomePath%\Desktop
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
     
 
-Si te quedas atascada, sólo pide ayuda.
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
 
-y luego usa Python para ejecutar el código en el archivo como sigue:
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hello, Django girls!
     
 
-¡Muy bien! Ejecutaste tu primer programa de Python desde un archivo. ¿No se siente increíble?
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
 
-Ahora puedes moverte a una herramienta esencial en la programación:
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
 
-## If...elif...else
+You can now move on to an essential tool in programming:
 
-Un montón de cosas en el código sólo son ejecutadas cuando se cumplen las condiciones dadas. Por eso Python tiene algo llamado **sentencias if**.
+## If … elif … else
 
-Reemplaza el código en tu archivo **python_intro.py** por esto:
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
 
-``` python
-    if 3 > 2:
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
 ```
 
-Si lo guardáramos y lo ejecutáramos, veríamos un error como este:
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     File "python_intro.py", line 2
@@ -511,115 +712,194 @@ Si lo guardáramos y lo ejecutáramos, veríamos un error como este:
     SyntaxError: unexpected EOF while parsing
     
 
-Python espera que le demos más instrucciones que se supone serán ejecutadas si la condición `3 > 2` resulta ser verdadera (o `True` en este caso). Intentemos hacer que Python imprima "It works!". Cambia tu código en el archivo **python_intro.py** para que se vea como esto:
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
 
-``` python
-    if 3 > 2:
-        print('It works!')
+```python
+if 3 > 2:
+    print('It works!')
 ```
 
-¿Observas cómo hemos indentado la siguiente línea de código con 4 espacios? Tenemos que hacer esto para que Python sepa qué código ejecutar si la comparación resulta verdadera. Puedes poner un espacio, pero casi todos los programadores Python hacen 4 espacios para hacer que el código sea más legible. Un solo tab también contará como 4 espacios.
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
 
-Guárdalo y ejecútalo de nuevo:
+Save it and give it another run:
 
-    $ python3 python_intro.py
-    It works!
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
 
-### ¿Qué pasa si la condición no es verdadera?
+### What if a condition isn't True?
 
-En ejemplos anteriores, el código fue ejecutado sólo cuando las condiciones eran ciertas. Pero Python también tiene declaraciones `elif` y `else`:
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
-    if 5 > 2:
-        print('5 is indeed greater than 2')
-    else:
-        print('5 is not greater than 2')
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
 ```
 
-Al ejecutar esto se imprimirá:
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     5 is indeed greater than 2
     
 
-Si 2 fuera un número mayor que 5, entonces el segundo comando sería ejecutado. Fácil, ¿verdad? Vamos a ver cómo funciona `elif`:
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
 
-``` python
-    name = 'Sonja'
-    if name == 'Ola':
-        print('Hey Ola!')
-    elif name == 'Sonja':
-        print('Hey Sonja!')
-    else:
-        print('Hey anonymous!')
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
 ```
 
-y al ejecutarlo:
+and executed:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hey Sonja!
     
 
-¿Ves lo que pasó ahí?
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
 
-### Resumen
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
 
-En los últimos tres ejercicios aprendiste acerca de:
+Python runs through each test in sequence and prints:
 
-*   **Comparar cosas** - en Python puedes comparar cosas haciendo uso de `>`, `>=`, `==`, `<=`, `<` y de los operatores `and` y `or`
-*   **Boolean** - un tipo de objeto que sólo puede tener uno de dos valores: `True` o `False`
-*   **Guardar archivos** - cómo almacenar código en archivos así puedes ejecutar programas más grandes
-*   **if... elif... else** - sentencias que te permiten ejecutar código sólo cuando se cumplen ciertas condiciones
+{% filename %}command-line{% endfilename %}
 
-¡Es hora de leer la última parte de este capítulo!
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
 
-## ¡Tus propias funciones!
+## Comments
 
-¿Recuerdas las funciones como `len()` que puedes ejecutar en Python? Bien, buenas noticias, ¡ahora aprenderás cómo escribir tus propias funciones!
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
 
-Una función es una secuencia de instrucciones que Python debe ejecutar. Cada función en Python comienza con la palabra clave `def`, se le asigna un nombre y puede tener algunos parámetros. Vamos a empezar con algo fácil. Reemplaza el código en **python_intro.py** con lo siguiente:
+Let's see how that looks:
 
-``` python
-    def hi():
-        print('Hi there!')
-        print('How are you?')
-    
-    hi()
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
 ```
 
-Bien, ¡nuestra primera función está lista!
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
 
-Te preguntarás por qué hemos escrito el nombre de la función en la parte inferior del archivo. Esto es porque Python lee el archivo y lo ejecuta desde arriba hacia abajo. Así que para poder utilizar nuestra función, tenemos que reescribir su nombre en la parte inferior.
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
 
-Ejecutemos esto y veamos qué sucede:
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hi there!
     How are you?
     
 
-¡Eso fue fácil! Vamos a construir nuestra primera función con parámetros. Utilizaremos el ejemplo anterior - una función que dice 'Hi' a la persona que ejecuta el programa - con un nombre:
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
 
-``` python
-    def hi(name):
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
 ```
 
-Como puedes ver, ahora dimos a nuestra función un parámetro que llamamos `name`:
+As you can see, we now gave our function a parameter that we called `name`:
 
-``` python
-    def hi(name):
-        if name == 'Ola':
-            print('Hi Ola!')
-        elif name == 'Sonja':
-            print('Hi Sonja!')
-        else:
-            print('Hi anonymous!')
-    
-    hi()
-``` 
+{% filename %}python_intro.py{% endfilename %}
 
-Como puedes notar, tuvimos que poner dos indentaciones antes de la función `print` porque `if` necesita saber lo que debería ocurrir cuando se cumple la condición. Vamos a ver cómo funciona:
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Traceback (most recent call last):
@@ -628,87 +908,111 @@ Como puedes notar, tuvimos que poner dos indentaciones antes de la función `pri
     TypeError: hi() missing 1 required positional argument: 'name'
     
 
-Oops, un error. Por suerte, Python nos da un mensaje de error bastante útil. Nos dice que la función `hi()` (la que definimos) tiene un argumento requerido (llamado `name`) y que se nos olvidó pasarlo al llamar a la función. Vamos a arreglarlo en la parte inferior del archivo:
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
 
-``` python
-    hi("Ola")
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
 ```
 
-y lo ejecutamos otra vez:
+And run it again:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hi Ola!
     
 
-¿Y si cambiamos el nombre?
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
 
-``` python
-    hi("Sonja")
-```    
+And run it:
 
-y lo corremos:
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hi Sonja!
     
 
-Ahora, ¿qué crees que pasará si escribes otro nombre allí? (No Ola o Sonja). Pruébalo y verás si tienes razón. Esto debería imprimir:
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
 
     Hi anonymous!
     
 
-Esto es increíble, ¿verdad? De esta forma no tienes que repetir todo cada vez que deseas cambiar el nombre de la persona a la que la función debería saludar. Y eso es exactamente el por qué necesitamos funciones - ¡para no repetir tu código!
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
 
-Vamos a hacer algo más inteligente - hay más de dos nombres, y escribir una condición para cada uno sería difícil, ¿no?
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
 
-``` python
-    def hi(name):
-        print('Hi ' + name + '!')
-    
-    hi("Rachel")
-```    
+{% filename %}python_intro.py{% endfilename %}
 
-Ahora vamos a llamar al código:
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hi Rachel!
     
 
-¡Felicidades! Acabas de aprender cómo escribir funciones :)
+Congratulations! You just learned how to write functions! :)
+
+## Loops
 
-## Bucles
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
 
-Esta ya es la última parte. ¿Eso fue rápido, verdad? :)
+This is the last part already. That was quick, right? :)
 
-Como hemos mencionado, los programadores son perezosos, no les gusta repetir cosas. La programación intenta automatizar las cosas, así que no queremos saludar a cada persona por su nombre manualmente, ¿verdad? Es ahí donde los bucles se vuelven muy útiles.
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
 
-¿Todavía recuerdas las listas? Hagamos una lista de las chicas:
+Still remember lists? Let's do a list of girls:
 
-``` python
-    girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
-```    
+{% filename %}python_intro.py{% endfilename %}
 
-Queremos saludar a todas ellas por su nombre. Tenemos la función `hi` que hace eso, así que vamos a usarla en un bucle:
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
 
-``` python
-    for name in girls:
-```    
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
 
-La sentencia for se comporta de manera similar a la sentencia if, el código que sigue a continuación debe estar indentado usando cuatro espacios.
+{% filename %}python_intro.py{% endfilename %}
 
-Aquí está el código completo que estará en el archivo:
+```python
+for name in girls:
+```
 
-``` python
-    def hi(name):
-        print('Hi ' + name + '!')
-    
-    girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
-    for name in girls:
-        hi(name)
-        print('Next girl')
-```    
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
 
-y cuando lo ejecutamos:
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hi Rachel!
@@ -723,15 +1027,20 @@ y cuando lo ejecutamos:
     Next girl
     
 
-Como puedes ver, todo lo que pones con una indentación dentro de una sentencia `for` será repetido para cada elemento de la lista `girls`.
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
 
-También puedes usar el `for` en números usando la función `range`:
+You can also use `for` on numbers using the `range` function:
 
-    for i in range(1, 6):
-        print(i)
-    
+{% filename %}python_intro.py{% endfilename %}
 
-Lo que imprimirá:
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
 
     1
     2
@@ -740,16 +1049,14 @@ Lo que imprimirá:
     5
     
 
-`range` es una función que crea una lista de números en serie (estos números son proporcionados por ti como parámetros).
-
-Ten en cuenta que el segundo de estos dos números no será incluido en la lista que retornará Python (es decir, `range(1, 6)` cuenta desde 1 a 5, pero no incluye el número 6).
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
 
-## Resumen
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
 
-Eso es todo. **¡Eres genial!** Esto no fue tan fácil realmente, así que deberías sentirte orgullosa de ti misma. ¡Estamos muy orgullosos de que hayas llegado hasta aquí!
+## Summary
 
-Tal vez quieras hacer algo distinto por un momento - estirarte, caminar un poco, descansar tus ojos - antes de pasar al siguiente capítulo. :)
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
 
-![Cupcake][3]
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
 
- [3]: images/cupcake.png
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/es/template_extending/README.md b/es/template_extending/README.md
index 390be1c98e6..35997f913d3 100755
--- a/es/template_extending/README.md
+++ b/es/template_extending/README.md
@@ -1,14 +1,14 @@
-# Extendiendo Plantillas
+# Template extending
 
-Otra cosa buena que Django tiene para tí es la **extensión de plantillas**. ¿Qué significa esto? Significa que puedes usar las mismas partes de tu HTML para diferentes páginas de tu sitio web.
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
 
-De esta forma no tienes que repetir el código en cada uno de los archivos cuando quieres usar una misma información o un mismo esquema. Y si quieres cambiar algo, no necesitas hacerlo en cada plantilla.
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
 
-## Creando una plantilla base
+## Create a base template
 
-Una plantilla base es la plantilla más básica que extiendes en cada página de tu sitio web.
+A base template is the most basic template that you extend on every page of your website.
 
-Vamos a crear un archivo `base.html` en `blog/templates/blog/`:
+Let's create a `base.html` file in `blog/templates/blog/`:
 
     blog
     └───templates
@@ -17,72 +17,99 @@ Vamos a crear un archivo `base.html` en `blog/templates/blog/`:
                 post_list.html
     
 
-Luego ábrelo y copia todo lo que hay en `post_list.html` al archivo `base.html`, de la siguiente manera:
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
 
-```html
-    {% load staticfiles %}
-    <html>
-        <head>
-            <title>Django Girls blog</title>
-            <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-            <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
-            <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
-            <link rel="stylesheet" href="{% static 'css/blog.css' %}">
-        </head>
-        <body>
-            <div class="page-header">
-                <h1><a href="/">Django Girls Blog</a></h1>
-            </div>
-    
-            <div class="content container">
-                <div class="row">
-                    <div class="col-md-8">
-                    {% for post in posts %}
-                        <div class="post">
-                            <div class="date">
-                                {{ post.published_date }}
-                            </div>
-                            <h1><a href="">{{ post.title }}</a></h1>
-                            <p>{{ post.text|linebreaksbr }}</p>
-                        </div>
-                    {% endfor %}
-                    </div>
-                </div>
-            </div>
-        </body>
-    </html>
-```    
-
-Luego, en `base.html` reemplaza por completo tu `<body>` (todo lo que haya entre `<body>` and `</body>`) con esto:
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
-``` html
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
     <body>
         <div class="page-header">
             <h1><a href="/">Django Girls Blog</a></h1>
         </div>
+
         <div class="content container">
             <div class="row">
                 <div class="col-md-8">
-                {% block content %}
-                {% endblock %}
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
                 </div>
             </div>
         </div>
     </body>
+</html>
 ```
 
-Básicamente remplazamos todo entre `{% for post in posts %}{% endfor %}` con:
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
-``` html
-    {% block content %}
-    {% endblock %}
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
 ```
 
-¿Qué significa esto? Acabas de crear un `block`, una template tag que te permite insertar HTML en este bloque en otras plantillas que extiendan a `base.html`. Te mostraremos como hacer esto en un momento.
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
 
-Ahora guárdalo y abre tu archivo `blog/templates/blog/post_list.html` de nuevo. Elimina todo lo que no esté dentro del body y luego elimina también `<div class="page-header"></div>`, de forma que tu archivo se verá asi:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-``` html
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
     {% for post in posts %}
         <div class="post">
             <div class="date">
@@ -92,31 +119,29 @@ Ahora guárdalo y abre tu archivo `blog/templates/blog/post_list.html` de nuevo.
             <p>{{ post.text|linebreaksbr }}</p>
         </div>
     {% endfor %}
+{% endblock %}
 ```
 
-Y ahora agrega esta línea al inicio del archivo:
-```
-    {% extends 'blog/base.html' %}
-``` 
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
 
-Significa que ahora estamos extendiendo de la plantilla `base.html` en `post_list.html`. Sólo nos falta una cosa: poner todo (excepto la línea que acabamos de agregar) entre `{% block content %}` y `{% endblock %}`. Como esto:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-``` html
-    {% extends 'blog/base.html' %}
-    
-    {% block content %}
-        {% for post in posts %}
-            <div class="post">
-                <div class="date">
-                    {{ post.published_date }}
-                </div>
-                <h1><a href="">{{ post.title }}</a></h1>
-                <p>{{ post.text|linebreaksbr }}</p>
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
             </div>
-        {% endfor %}
-    {% endblock %}
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
 ```
 
-¡Eso es todo! Verifica que tu sitio web aún funcione apropiadamente :)
+That's it! Check if your website is still working properly. :)
 
-> Si tienes un error `TemplateDoesNotExists` que diga que no hay un archivo `blog/base.html` y tienes `runserver` ejecutándose en la consola, intenta pararlo (presionando Ctrl+C - las teclas Control y C juntas) y reinicialo ejecutando el comando `python manage.py runserver`.
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/es/whats_next/README.md b/es/whats_next/README.md
index df5bd765d55..fbb1d2a7d6e 100755
--- a/es/whats_next/README.md
+++ b/es/whats_next/README.md
@@ -1,40 +1,25 @@
-# ¿Qué sigue?
+# What's next?
 
-¡Date muchas felicitaciones! **¡Eres increíble!**. ¡Estamos orgullosos! <3
+Congratulate yourself! **You're totally awesome**. We're proud! <3
 
-### ¿Qué hacer ahora?
+### What to do now?
 
-Toma un descanso y relájate. Acabas de hacer algo realmente grande.
+Take a break and relax. You have just done something really huge.
 
-Después de eso, asegúrate de:
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
 
-*   Seguir a Django Girls en [Facebook][1] o [Twitter][2] para estar al día
+### Can you recommend any further resources?
 
- [1]: http://facebook.com/djangogirls
- [2]: https://twitter.com/djangogirls
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
 
-### ¿Me puedes recomendar recursos adicionales?
+Later on, you can try the resources listed below. They're all very recommended!
 
-¡Sí! En primer lugar, sigue adelante y prueba nuestro libro llamado [Django Girls Tutorial: Extensiones][3].
-
- [3]: https://tutorial-extensions.djangogirls.org
-
-Más adelante, puedes intentar los recursos listados a continuación. ¡Son todos muy recomendables! 
-
-- [Django's official tutorial][4] 
-- [New Coder tutorials][5] 
-- [Code Academy Python course][6] 
-- [Code Academy HTML & CSS course][7] 
-- [Django Carrots tutorial][8] 
-- [Learn Python The Hard Way book][9] 
-- [Getting Started With Django video lessons][10] 
-- [Two Scoops of Django: Best Practices for Django book][11]
-
- [4]: https://docs.djangoproject.com/en/1.8/intro/tutorial01/
- [5]: http://newcoder.io/tutorials/
- [6]: https://www.codecademy.com/en/tracks/python
- [7]: https://www.codecademy.com/tracks/web
- [8]: https://github.com/ggcarrots/django-carrots/
- [9]: http://learnpythonthehardway.org/book/
- [10]: http://www.gettingstartedwithdjango.com/
- [11]: https://twoscoopspress.org/products/two-scoops-of-django-1-6
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/fa-IR/GLOSSARY.md b/fa-IR/GLOSSARY.md
new file mode 100644
index 00000000000..c65a983e6a3
--- /dev/null
+++ b/fa-IR/GLOSSARY.md
@@ -0,0 +1,3 @@
+# ویرایشگر کد
+
+ویرایشگر کد یک برنامه کاربردی است که به شما امکان می دهد کد خود را ذخیره کنید تا بتوانید بعدا به آن بازگردید. شما می توانید در [بخش ویرایشگر کد](./code_editor/README.md) یاد بگیرید که چطور یکی از آن‌ها را دانلود کنید
\ No newline at end of file
diff --git a/fa-IR/README.md b/fa-IR/README.md
new file mode 100644
index 00000000000..4c69142bfbc
--- /dev/null
+++ b/fa-IR/README.md
@@ -0,0 +1,51 @@
+# جنگو برای دختران
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> این کار تحت مجوز Creative Commons Attribution-Share Alike 4.0 مجاز است. برای مشاهده یک نسخه از این مجوز، بهhttps://creativecommons.org/licenses/by-sa/4.0/ مراجعه کنید
+
+## خوش آمدید
+
+به دوره آموزشی دختران جنگو خوش آمدید! خوشحال هستیم که شما را اینحا می‌بینیم. :) در این آموزش، شما را به سفری به پشت صحنه تکنولوژی‌های وب خواهیم برد و نگاهی اجمالی می‌اندازیم به تمام بخش‌های بزرگ و کوچکی که کنار هم قرار می‌گیرند تا وب، آن طور که می‌شناسیمش، کار کند.
+
+مثل تمام کارهای ناشناخته دیگر، این کار نیز یک ماجراجویی خواهد بود. اما نگران نباشید، چرا که شهامت اینجا بودن را داشته‌اید، همه چیز خوب پیش خواهد رفت. :)
+
+## معرفی
+
+آیا تا به حال احساس کرده اید دنیا هر روز بیشتر و بیشتر پیرامون تکنولوژی می‌گذرد که شما (هنوز) با آن ارتباط برقرار نمی‌کنید؟ آیا شده به ساختن یک وبسایت فکر کنید ولی انگیزه کافی را برای شروع اش نداشته باشید؟ آیا تا به حال به این فکر کرده‌اید که دنیای نرم‌افزار برای آنکه شما وارد آن بشوید، بیش از حد پیچیده است؟
+
+ما خبرهای خوبی برای شما داریم. برنامه نویسی آن قدر که به نظر می‌رسد سخت نیست و می‌خواهیم نشان دهیم که حتی میتواند جالب هم باشد.
+
+این آموزش شما را به طرز جادویی تبدیل به برنامه نویس نخواهد کرد. اگر بخواهید برنامه نویس خوبی شوید، باید ماه‌ها و یا حتی سال‌ها برایش وقت بگذارید. ولی ما می‌خواهیم نشان دهیم که برنامه نویسی یا ساختن وبسایت آنقدرها که به نظر می‌رسد پیچیده نیست. سعی ما این است که قدم به قدم و جز به جز جلو برویم، تا زیاد گیج نشوید.
+
+امیدواریم بتوانیم کاری کنیم که شما هم به اندازه ما از تکنولوژی خوشتان بیاید!
+
+## در این آموزش چه چیزی یاد خواهید گرفت؟
+
+وقتی این برنامه آموزشی را تمام کنید، یک برنامه وب که کار می‌کند یعنی وبلاگ خودتان را خواهید داشت. به شما نشان خواهیم داد چه طور آن را روی اینترنت بگذارید تا بقیه کارتان را ببینند!
+
+کمابیش شبیه این خواهد شد:
+
+![تصویر 0.1](images/application.png)
+
+> اگر خودتان به تنهایی با این آموزش کار می‌کنید و مربی ندارید تا به شما کمک کند، در صورت بروز هر مشکلی ما یک سیستم چت برای شما داریم: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). ما از مربی‌ها و شرکت کنندگان قبلی خود خواسته ایم تا هر چند وقت یکبار اینجا باشند و به بقیه کمک کنند! از پرسیدن سوال هایتان نترسید!
+
+خوب،[ بیایید از ابتدا شروع کنیم... ](./how_the_internet_works/README.md)
+
+## دنبال کردن آموزش در منزل
+
+فوق‌العاده خواهد بود که در یکی از کارگاه‌های دختران جنگو شرکت کنید، اما می‌دانیم که امکان شرکت همیشه فراهم نیست. به همین دلیل است که شما را تشویق می کنیم که در خانه از این آموزش استفاده کنید. برای خوانندگان در منزل، ما در حال تهیه ویدئوهایی هستیم که دنبال کردن آموزش به تنهایی را آسان‌‌تر می‌سازد. هنوز کامل نشده‌است، اما چیزهای بیشتر و بیشتری به زودی در کانال یوتیوب [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) قرار خواهد گرفت.
+
+در هر فصل که قبلاً پوشش داده شده است، یک لینک وجود دارد که به ویدیو صحیح اشاره می‌کند.
+
+## مشارکت در توسعه
+
+این آموزش توسط [DjangoGirls](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/) لیست نشده است، [یک issue جدید](https://github.com/DjangoGirls/tutorial/issues/new) باز کنید و در مورد این زبان به ما اطلاع دهید تا ما بتوانیم آن را اضافه کنیم.
\ No newline at end of file
diff --git a/fa-IR/SUMMARY.md b/fa-IR/SUMMARY.md
new file mode 100644
index 00000000000..4ff90958204
--- /dev/null
+++ b/fa-IR/SUMMARY.md
@@ -0,0 +1,35 @@
+# چکیده
+
+* [معرفی](README.md)
+* [نصب و راه‌اندازی](installation/README.md) 
+  * [ترمینال](installation/README.md#command-line)
+  * [پایتون](installation/README.md#python)
+  * [ویرایشگر کد](installation/README.md#code-editor)
+  * [محیط مجازی](installation/README.md#virtualenv)
+  * [جنگو](installation/README.md#django)
+  * [گیت](installation/README.md#git)
+  * [گیت هاب](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [نصب و راه اندازی (کروم بوک)](chromebook_setup/README.md)
+* [اینترنت چگونه کار می‌کند](how_the_internet_works/README.md)
+* [آشنایی با خط فرمان](intro_to_command_line/README.md)
+* [نصب و راه اندازی پایتون](python_installation/README.md)
+* [ویرایشگر کد](code_editor/README.md)
+* [آشنایی با پایتون](python_introduction/README.md)
+* [جنگو چیست?](django/README.md)
+* [نصب و راه اندازی جنگو](django_installation/README.md)
+* [اولین پروژه جنگو شما!](django_start_project/README.md)
+* [مدل در جنگو](django_models/README.md)
+* [پنل مدیریت در جنگو](django_admin/README.md)
+* [فاز دیپلوی!](deploy/README.md)
+* [URL ها در جنگو](django_urls/README.md)
+* [ساخت view در جنگو!](django_views/README.md)
+* [آشنایی با HTML](html/README.md)
+* [ORM در جنگو](django_orm/README.md)
+* [داده های پویا در templates](dynamic_data_in_templates/README.md)
+* [templates در جنگو](django_templates/README.md)
+* [CSS - آن را زیبا کنید](css/README.md)
+* [توسعه template](template_extending/README.md)
+* [برنامه خود را توسعه دهید](extend_your_application/README.md)
+* [فرم در جنگو](django_forms/README.md)
+* [گام بعدی چیست؟](whats_next/README.md)
\ No newline at end of file
diff --git a/fa-IR/chromebook_setup/README.md b/fa-IR/chromebook_setup/README.md
new file mode 100644
index 00000000000..73d2075a168
--- /dev/null
+++ b/fa-IR/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# نصب Chromebook
+
+> **نکته** اگر الان در حال گذراندن [مراحل نصب](../installation/README.md) هستید، لازم نیست مجددا این مراحل را انجام دهید و می‌توانید مستقیماً به بخش [آشنایی با پایتون](../python_introduction/README.md) بروید.
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/fa-IR/chromebook_setup/instructions.md b/fa-IR/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..ca0ad1132c4
--- /dev/null
+++ b/fa-IR/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+اگر از Chromebook استفاده نمی‌کنید می‌توانید [از این بخش ](http://tutorial.djangogirls.org/en/installation/#install-python) عبور کنید. اگر از آن استفاده می‌کنید تجربه نصب شما کمی متفاوت خواهد بود. شما می توانید بقیه دستورالعمل نصب را نادیده بگیرید.
+
+### IDE ابری (PaizaCloud Cloud IDE, AWS Cloud9 و Glitch.com)
+
+IDE ابری ابزاری است که به شما دسترسی به یک ویرایشگر کد و یک کامپیوتر در حال کار کردن روی اینترنت را می‌دهد که می‌توانید نصب، نوشتن و اجرای برنامه‌ها را در آن انجام دهید. در زمان این آموزش، IDE ابری به عنوان * دستگاه محلی شما * عمل خواهد کرد. شما همچنان مانند سایر همکلاسی‌ها که از OS X، اوبونتو یا ویندوز استفاده می‌کنند، دستورات را در ترمینال اجرا خواهید کرد اما ترمینال شما به کامپیوتری که IDE ابری برای شما آماده کرده متصل است. در اینحا دستورالعمل استفاده از IDE های ابری ( PaizaCloud Cloud IDE، AWS Cloud9 و Glitch.com) را خواهید دید. شما می‌توانید یکی از IDE های ابری را انتخاب کنید و دستورالعمل را دنبال کنید.
+
+#### IDE ابری PiazaCloud
+
+1. به [PaizaCloud Cloud IDE](https://paiza.cloud/) بروید
+2. یک حساب کاربری بسازید
+3. بر روی *New Server* کلیک کنید و گزینه Django app را انتخاب کنید
+4. دکمه Terminal را (در سمت چپ صفحه) بزنید
+
+حالا شما باید صفحه ای با یک ستون کناری و کلیدهایی در سمت چپ ببینید. بر روی دکمه "Terminal" کلیک کنید تا پنجره ترمینال با پیغامی شبیه به این باز شود:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+ترمینال در IDE ابری PiazaCloud برای دستورات شما آماده شده است. شما می‌توانید اندازه این پنجره را تغییر دهید تا کمی بزرگتر دیده شود.
+
+#### 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 عبارت *Cloud9* را در محل جستجو وارد کنید و کلید جستجو را بزنید
+5. در داشبورد Cloud 9 بر روی *Create environment* کلیک کنید
+6. نام آن را *django-girls* بگذارید
+7. در هنگام انجام تنظیمات، در بخش "Environment Type" گزینه *Create a new instance for environment (EC2)* را و در بخش "Instance type" گزینه *t2.micro* را انتخاب کنید ("Free-tier eligible" را نشان خواهد داد). تنظیمات پیشفرض صرفه جویانه و خوب است و شما هم باقی تنظیمات پیشفرض را نگه دارید.
+8. بر روی *Next step* کلیک کنید
+9. بر روی *Create environment* کلیک کنید
+
+حالا باید صفحه‌ای با یک نوار کناری، یک صفحه اصلی بزرگ با مقداری نوشته و یک صفحه کوچک در پایین ببینید که شبیه به این خواهد بود:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+این محدوده پایین، ترمینال شماست. شما می‌توانید از این ترمینال برای فرستادن دستورات به کامپیوتر Cloud 9 استفاده کنید. می‌توانید ابعاد این پنجره را تغییر دهید تا کمی بزرگتر دیده شود.
+
+#### IDE ابری Glitch.com
+
+1. به [Glitch.com](https://glitch.com/) بروید 
+2. یک حساب کاربری (https://glitch.com/signup) بسازید یا از حساب GitHub خود استفاده کنید. (راهنمای استفاده از حساب GitHubرا در زیر ببینید)
+3. بر روی *New Project* کلیک کنید و گزینه *hello-webpage* را انتخاب کنید
+4. بر روی گزینه کشویی Tools کلیک کنید (در سمت چپ و پایین صفحه)، سپس بر روی دکمه Terminal کلیک کنید تا یک کنسول خط فرمان باز شود: 
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+هنگامی که از Glitch.com به عنوان ویرایشگر ابری خود استفاده می‌کنید، لازم نیست که یک محیط مجازی بسازید، به جای آن فایل‌های زیر را باید بسازید:
+
+{% 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
+```
+
+وقتی این فایل‌ها ساخته شدند، به Terminal بروید و دستورات زیر را اجرا کنید تا اولین پروژه جنگو شما ساخته شود:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+برای دیدن جزییات مربوط به پیغام خطا، می‌توانید لاگ عیب‌یابی جنگو را در اپلیکیشن Glitch فعال کنید. به سادگی کد زیر را به انتهای فایل `mysite/settings.py` اضافه کنید.
+
+{% 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,
+        },
+    },
+}
+```
+
+این کار یک فایل `debug.log` می‌سازد که جزییات عملیات جنگو و پیغام‌های خطای احتمالی، در آن است، به کمک این فایل عیب‌یابی وب‌سایت بسیار ساده‌تر می‌شود.
+
+اولین ریستارت پروژه Glitch‌ نباید موفقیت‌آمیز باشد! (اگر بر روی منوی کشویی `Show` کلیک کنید و سپس `In a New Window` را بزنید، پیغام خطای `DisallowedHost` را دریافت خواهید کرد) در مورد این مرحله نگران نباشید، این آموزش این مشکل را به زودی و پس از به روزرسانی تنظیمات پروژه که در فایل `mysite/settings.py` است، حل خواهد کرد.
+
+### محیط مجازی
+
+یک محیط مجازی (Virtual Environment یا virtualenv) شبیه یک جعبه خصوصی است که ما می‌توانیم کدهای کامپیوتری مربوط به یک پروژه را در آن جمع کنیم. ما از آن‌ها استفاده می‌کنیم تا تکه‌های مختلف کدهای هر پروژه را جدا از پروژه دیگر نگه داریم تا بین پروژه‌ها تداخل پیش نیاید.
+
+اجرا:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(توجه کنید که در خط آخر ما از یک علامت مد و یک مساوی استفاده کردیم: `~=`).
+
+### GitHub
+
+یک حساب کاربری [GitHub](https://github.com) بسازید.
+
+### PythonAnywhere
+
+دوره آموزشی جنگوگرلز شامل بخشی است به نام فاز دیپلوی یا Deployment، که شامل گرفتن و انتقال دادن کدهای وبسایت شما به یک کامپیوتر در دسترس عموم (به نام سرور) است تا سایرین هم بتوانند کار شما را ببینند.
+
+اگر این دوره آموزشی را بر روی Chromebook که خودش کامپیوتری بر روی اینترنت است (در مقابل لپ تاپ‌های معمولی که کامپیوتری محلی محسوب می‌شوند)، انجام می‌دهید این بخش کمی عجیب خواهد بود. با این‌حال، استفاده از Cloud 9 به عنوان یک محیط کاری برای کارهای در جریان و استفاده از Python Anywhere به عنوان یک فضای معرفی و نمایش پروژه هایی که در طول زمان کامل می‌شوند، مفید است.
+
+بنابراین یک حساب کاربری جدید در [www.pythonanywhere.com](https://www.pythonanywhere.com) بسازید.
\ No newline at end of file
diff --git a/fa-IR/code_editor/README.md b/fa-IR/code_editor/README.md
new file mode 100644
index 00000000000..90c36a2806f
--- /dev/null
+++ b/fa-IR/code_editor/README.md
@@ -0,0 +1,11 @@
+# ویرایشگر کد
+
+> برای خوانندگان در خانه: این فصل در ویدئو [نصب پایتون و ویرایشگر کد](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) توضیح داده شده است.
+
+به نوشتن اولین خط کدتان نزدیک می‌شوید، زمان مناسبی برای دانلود یک ویرایشگر کد است!
+
+> **نکته** اگر از Chromebook استفاده میکنید، این فصل را رد کنید و مطمئن شوید که دستورالعمل [نصب Chromebook](../chromebook_setup/README.md) را دنبال کنید. IDE ابری که شما انتخاب کرده‌اید (PaizaCloud Cloud IDE یا AWS Cloud9) شامل یک ویرایشگر کد هم هست و هنگامی که یک فایل را در IDE خودتان باز می‌کنید به صورت اتوماتیک از ویرایشگر استفاده می‌کنید.
+> 
+> **نکته** ممکن است این بخش را قبل‌تر در بخش [نصب و راه‌اندازی](../installation/README.md) انجام داده باشید، در این صورت مستقیم به بخش بعد بروید! 
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/fa-IR/code_editor/instructions.md b/fa-IR/code_editor/instructions.md
new file mode 100644
index 00000000000..b10c0a8b471
--- /dev/null
+++ b/fa-IR/code_editor/instructions.md
@@ -0,0 +1,37 @@
+ویرایشگرهای مختلف زیادی وجود دارد که این امر به سلیقه شخصی برمی‌گردد. اغلب برنامه‌نویسان پایتون از محیط‌های توسعه یکپارچه (IDE, Integrated Development Environments) بسیار قدرتمند مثل PyCharm استفاده می‌کنند. اما برای یک مبتدی احتمالا خیلی مناسب نیست. پیشنهادهای ما به همان اندازه قدرتمند، اما بسیار ساده‌تر هستند.
+
+ما موارد زیر را پیشنهاد می‌کنیم، اما می‌توانید از مربی خود، ترجیحش را بپرسید. راحت‌تر است از مربی کمک بگیرید.
+
+## Visual Studio Code
+
+Visual Studio Code یک ویرایشگر کد است که توسط مایکروسافت توسعه داده شده و برای ویندوز، لینوکس و macOS موجود است. این ویرایشگر قابلیت عیب یابی، کنترل Git از داخل نرم افزار، برجسته سازی دستورات، سیستم هوشمند کامل کردن دستورات، سیستم snippets (جلوگیری از نوشتن بخش‌های تکراری در کدها) و بازنویسی کدها است.
+
+[از اینجا دانلود کنید](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit یک نرم افزار آزاد و یک ویرایشگر رایگان است که برای تمام سیستم عامل‌ها موجود است.
+
+[از اینجا دانلود کنید](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text یک ویرایشگر بسیار رایج است که یک دوره آزمایشی رایگان دارد و برای تمام سیستم عامل‌ها موجود است.
+
+[جهت دانلود کلیک نمایید](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom نیز یک ویرایشگر رایج دیگر است که نرم افزاری رایگان و آزاد است و برای ویندوز، لینوکس وOS X موجود است. Atom توسط [GitHub](https://github.com/) توسعه داده شده است.
+
+[از اینجا دانلود کنید](https://atom.io/)
+
+## چرا ویرایشگر متن نصب می‌کنیم؟
+
+ممکن است فکر کنید که چرا به جای استفاده از برنامه‌ای مثل Word یا Notepad، این نرم‌افزار خاص ویرایش کد را نصب می‌کنم.
+
+دلیل اول این است که کدها نیاز دارند که به صورت متن ساده (**plain text**) باشند و مشکل برنامه‌هایی مثل Word یا Textedit این است که متن ساده تولید نمی‌کنند، بلکه متنی غنی (با فونت و قالب‌بندی) می‌سازند و از قالب‌های سفارشی مثل [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format) استفاده می‌کنند.
+
+دلیل دوم این است که ویرایشگرهای متن به طور خاص برای ویرایش کد ساخته شده‌اند. بنابراین، امکاناتی مثل رنگ‌آمیزی کدها بر اساس معنایشان یا بستن خودکار نقل قول‌ها را دارند.
+
+همه این‌ها را بعداً در عمل خواهیم دید. به زودی، شما به ویرایشگر کد خود به عنوان یکی از ابزارهای محبوبتان نگاه خواهید کرد. :)
\ No newline at end of file
diff --git a/fa-IR/css/README.md b/fa-IR/css/README.md
new file mode 100644
index 00000000000..074ed7e7d6f
--- /dev/null
+++ b/fa-IR/css/README.md
@@ -0,0 +1,325 @@
+# CSS - زیبایش کن!
+
+بلاگ ما هنوز خیلی زشت است، نه؟ وقتش است که زیبایش کنیم. برای این کار از CSS استفاده می‌کنیم.
+
+## CSS چیست؟
+
+CSS یا (Cascading Style Sheets) زبان مورد استفاده برای توصیف ظاهر و قالب‌بندی یک وب سایت نوشته شده در زبان نشانه گذاری، (مانند HTML) است. از آن به عنوان آرایش برای صفحه وب خود استفاده می‌کنیم. ؛)
+
+اما ما نمی‌خواهیم دوباره از ابتدا شروع کنیم، درست است؟ یک بار دیگر، ما از چیزی که برنامه‌نویسان در اینترنت به صورت رایگان منتشر کرده‌اند استفاده می‌کنیم. همانطور که می‌دانید اختراع دوباره چرخ جالب نیست.
+
+## با بوت‌ استرپ شروع کنیم!
+
+بوت استرپ یکی از محبوب‌ترین چارچوب‌های HTML و CSS برای توسعه وب سایت‌های زیبا است: https://getbootstrap.com/
+
+توسط برنامه نویسانی که در توییتر کار می کردند نوشته شده بود. در حال حاضر توسط داوطلبانی از سراسر جهان توسعه یافته است!
+
+## نصب بوت استرپ
+
+برای نصب بوت استرپ فایل `.html` را در ویرایشگر متن باز کنید و به بخش `<head>` خط‌های زیر را اضافه کنید:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+این کار هیچ فایلی به پروژه شما اضافه نمی‌کند. این کد به فایلی که در اینترنت وجود دارد اشاره می‌کند. بنابراین به پیش بروید وبسایت خود را باز کنید و صفحه را ریفرش کنید. بفرمایید!
+
+![تصویر 14.1](images/bootstrap1.png)
+
+ظاهری قشنگ‌تر از قبل!
+
+## فایل‌های ایستا در جنگو
+
+در نهایت نگاهی دقیق‌تر به فایل‌هایی بیاندازیم که به آن‌ها فایل ایستا یا ثابت **static files** می‌گوییم. فایل‌های ایستا شامل تمامی فایل‌های CSS و عکس‌ها می‌باشند. محتوای آن‌ها به متن درخواست بستگی ندارد و برای هر کاربر یکسان خواهد بود.
+
+### فایل‌های ایستا کجای جنگو قرار میگیرند
+
+جنگو به هرحال می‌داند که فایل‌های ثابت در اپلیکیشن پیش ساخته "admin" کجا قرار گرفته‌اند. حالا ما لازم داریم تا چند فایل ثابت را به اپلیکیشن `blog` خودمان اضافه کنیم.
+
+ما این کار را با ایجاد یک پوشه به نام `static` در داخل برنامه وبلاگ انجام می‌دهیم:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+جنگو به طور خودکار هر پوشه‌ای با نام "static" را در پوشه اپلیکیشن‌های شما پیدا خواهد کرد. پس از آن قادر است از محتوای آن‌ها به عنوان فایل ایستا استفاده کند.
+
+## اولین فایل CSS شما!
+
+اکنون یک فایل CSS ایجاد کنیم تا سلیقه خود را به صفحه وب تان اضافه کنیم. یک پوشه جدید با نام `css` در داخل پوشه `static` بسازید. سپس در داخل این پوشه `css`، یک فایل جدید با نام `blog.css` ایجاد کنید. آماده شد؟
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+حالا وقت کمی CSS نوشتن است! فایل `blog/static/css/blog.css` را در ویرایشگر کد خود باز کنید.
+
+ما در اینجا، سفارشی سازی و یادگیری CSS را خیلی عمیق بررسی نخواهیم کرد. اگر بخواهید بیشتر در باره CSS بدانید، یک توصیه برای یک دوره رایگان، در پایین این صفحه وجود دارد.
+
+اما بیایید حداقل کمی به آن بپردازیم. شاید بتوانیم رنگ header هایمان را تغییر دهیم؟ برای درک رنگ‌ها، رایانه‌ها از کدهای ویژه استفاده می‌کنند. این کدها با `#` شروع می‌شوند و به ترتیب شامل 6 حرف (A-F) و اعداد (0-9) هستند. به عنان مثال، کد رنگ آبی `FF0000#` است. شما می‌توانید در آدرس http://www.colorpicker.com:/ کد رنگ بسیاری از رنگ‌ها را پیدا کنید. شما همچنین ممکن است از [رنگ‌های از پیش تعریف شده](http://www.w3schools.com/colors/colors_names.asp) از جمله `قرمز` و `سبز` استفاده کنید.
+
+در فایل ` blog/static/css/blog.css ` کد زیر را اضافه کنید:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` انتخابگر یا selector در یک فایل CSS است. به این معنی که ما درحال تنظیم کردن فرمت هر عنصر `a` هستیم که در داخل یک بخش `h1` باشد. `h2 a` نیز دقیقا مانند همین کار را در بخش `h2` انجام می‌دهد. بنابراین وقتی ما چیزی شبیه یک `<h1><a href="">link</a></h1>` داریم، فرمت `h1 a` اعمال خواهد شد. در این مورد، ما می‌خواهیم رنگ آن را به `#C25100` تغییر دهیم که رنگ نارنجی تیره است. یا اینکه می‌توانید رنگ مورد علاقه خودتان را بگذارید فقط مطمئن باشید با رنگ سفید زمینه، کنتراست کافی داشته باشد!
+
+در یک فایل CSS،ما فرمت‌ بخش‌های مختلف یک فایل HTML را مشخص می‌کنیم. اولین روش شناسایی هر عنصر یا element، نام عنصر است. ممکن است این عناصر را به عنوان تگ tag از بخش HTML بخاطر داشته باشید. عناصری مانند ` a `، ` h1 `، و `body` همه نمونه‌هایی از نام یک عنصر هستند. ما همچنین عناصر را با ویژگی‌هایی مانند `class` یا `id` نیز شناسایی می‌کنیم. class و id نام‌هایی هستند که شما خودتان به عناصر مختلف نسبت می‌دهید. class ها، گروه‌های عناصر را تعریف می‌کنند و id ها به یک عنصر خاص اشاره می‌کنند. برای مثال، می‌توانید عنصر زیر را با استفاده از نام تگ، یعنی ` a`، نام کلاس ` external_link ` یا به کمک آیدی `link_to_wiki_page ` شناسایی کنید:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+شما می‌توانید در این موارد بیشتر بخوانید [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+ما همچنین باید به قالب HTML خودمان بگوییم که یک فایل CSS اضافه کرده‌ایم. فایل `blog/templates/blog/post_list.html` را در ویرایشگر کد باز کنید و خط زیر را به ابتدای آن اضافه کنید:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+ما فقط فایل‌های ثابت یا static را در اینجا بارگیری می‌کنیم. :) بین برچسب `<head>` و `</head>`، پس از پیوند به فایل‌های بوت استرپ، این خط را اضافه کنید:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+مرورگر فایل‌ها را به ترتیب می‌خواند، بنابراین ما باید مطمئن شویم که این خط در جای مناسب قرار گرفته است. در غیر این صورت کد در فایل شما ممکن است توسط کد در فایل‌های بوت استرپ لغو شود. ما فقط به قالب HTML مان می‌گوییم که فایل CSS کجا قرار دارد.
+
+اکنون فایل شما باید مانند این باشد:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+خب، حالا فایل را ذخیره کنید و صفحه را دوباره بارگذاری کنید!
+
+![تصویر 14.2](images/color2.png)
+
+کارت خوب بود! شاید بخواهیم کمی حاشیه سمت چپ صفحه وب مان را افزایش دهیم؟ بیایید این را امتحان کنیم!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body { padding-left: 15px; }
+```
+
+این کد را به فایل CSS خود اضافه کنید، و ببینید چگونه کار می‌کند!
+
+![تصویر 14.3](images/margin2.png)
+
+شاید ما بتوانیم فونت را در هدر صفحه‌مان سفارشی کنیم؟ این قطعه کد را در بخش `<head>` فایل `blog/templates/blog/post_list.html` وارد کنید:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+همانند قبل ترتیب قرار دادن لینک‌ها را چک کنید و این خط را قبل پیوند به `blog/static/css/blog.css` قرار دهید. این خط، فونتی به نام *Lobster* را از مجموعه فونت‌های گوگل فراخوانی می‌کند (https://www.google.com/fonts).
+
+در فایل CSS به آدرس `blog/static/css/blog.css`، بخش تعریف عنصر ` h1 a ` را پیدا کنید (قطعه کدی که بین `{` و `}` قرار دارد). حالا خط `font-family: 'Lobster';` را بین آکولادها اضافه کنید و صفحه وب را دوباره بارگیری کنید:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a { color: #C25100; font-family: 'Lobster'; }
+```
+
+![تصویر 14.3](images/font.png)
+
+عالی!
+
+همانطور که در بالا ذکر شد CSS دارای مفهوم کلاس است. کلاس‌ها به شما اجازه می‌دهند تا بخشی از کد HTML را نامگذاری کنید و تنها فرمت این قسمت از کد را تغییر بدهید، بدون اینکه به سایر قسمت‌ها آسیبی برسد. کلاس‌ها می‌توانند فوق‌العاده مفید باشند! شاید شما دو div دارید که کاری متفاوت انجام می دهند (مانند header و post). یک کلاس می‌تواند به شما کمک کند آن‌ها را متفاوت نگاه کنید.
+
+به همین ترتیب جلو بروید و برخی بخش‌های کد HTML را نام گذاری کنید. بخش `header` را که شامل header وب‌سایت شماست با کد زیر جابجا کنید:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+و اکنون کلاس `post` را به `article` اضافه کنید که حاوی یک پست وبلاگ است.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+ما اکنون بلوک‌های معرف را به انتخاب‌گرهای مختلف اضافه خواهیم کرد. انتخابگرهایی که با `.` آغاز می‌شوند مربوط به کلاس‌ها هستند. آموزش‌ها و توضیحات بسیار خوبی درباره CSS در اینترنت وجود دارد که می‌تواند به شما در درک کد زیر کمک کند. حالا این قطعه کد را در فایل `blog/static/css/blog.css` کپی کنید:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+سپس کد HTML زیر را که نمایش پست‌ها با اسامی کلاس‌ها را نشان می‌دهد:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+در فایل `blog/templates/blog/post_list.html` با قطعه کد زیر عوض کنید:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+این فایل‎‌ها را ذخیره کنید و وبسایت خود را دوباره بارگیری کنید.
+
+![تصویر 14.4](images/final.png)
+
+یووهو! به نظر عالی می‌آید، اینطور نیست؟ به کدی که اضافه کردیم نگاه کنید تا محلی که کلاس ها را در HTML اضافه و در CSS استفاده کرده ایم پیدا کنید. اگر بخواهید نوشته تاریخ ها را فیروزه ای رنگ کنید کجا را باید تغییر دهید؟
+
+نگران نباشید کمی با این CSS کار کنید و سعی کنید برخی از چیزها را تغییر دهید. بازی با CSS می‌تواند به شما کمک کند که بفهمید هر بخش چگونه کار می‌کند. اگر چیزی را خراب کردید، نگران نباشید، همیشه می‌توانید این تغییرات را به حالت قبل برگردانید!
+
+ما اکیداً گذراندن دوره‌های آموزشی آنلاین "Basic HTML & HTML5" و "Basic CSS" را در [freeCodeCamp](https://learn.freecodecamp.org/) توصیه می‌کنیم. این دوره‌ها به شما کمک خواهد کرد تا همه چیزهایی که برای زیباتر کردن وبسایت خود با HTML و CSS لازم دارید یاد بگیرید.
+
+برای فصل بعدی آماده هستید؟! :)
\ No newline at end of file
diff --git a/fa-IR/deploy/README.md b/fa-IR/deploy/README.md
new file mode 100644
index 00000000000..f9ff5947e75
--- /dev/null
+++ b/fa-IR/deploy/README.md
@@ -0,0 +1,246 @@
+# مرحله منتشر کردن!
+
+> **توجه داشته باشید** که قسمت‌های پیش رو ممکن است کمی سخت به نظر برسد. نا امید نشوید و این بخش را تا آخر ادامه دهید، یکی از مهم‌ترین قسمت‌های توسعه وب سایت منتشرکردن یا Deploy می‌باشد. این فصل در وسط آموزش قرار گرفته است، بنابراین مربی شما می‌تواندبه شما در راه اندازی آنلاین وبسایتتان کمک کند. این به این معنی است که شما می‌توانید به تنهایی ادامه‌ی تمرین خود را به اتمام برسانید حتی اگر زمان کارگاه به پایان برسد.
+
+تا به اینجا وب سایت شما فقط در رایانه شما قابل مشاهده است. حالا شما یاد خواهید گرفت که چگونه آن را دیپلوی کنید! دیپلوی یعنی فرآیند انتشار پروژه شما در اینترنت، تا سایرین بتوانند در نهایت پروژه شما را ببینند. :)
+
+همانطور که یاد گرفتید، وب سایت باید بر یک سرور جای بگیرد. سرورهای زیادی در اینترنت وجود دارد، ما قصد داریم از [PythonAnywhere](https://www.pythonanywhere.com/) استفاده نماییم. PythonAnywhere برای پروژه‌های کوچک که بازدید‌کنندگان خیلی زیادی ندارند رایگان است بنابراین در حال حاضر برای شما مناسب است.
+
+سرویس خارجی دیگری که ما استفاده می‌کنیم [گیت هاب](https://www.github.com) است که سرویس میزبانی کد است. سرویس‌های دیگری نیز وجود دارد، اما تقریباً این روزها همه برنامه نویسان اکانت گیت هاب دارند و الان شما هم خواهید داشت!
+
+این سه مکان برای شما مهم خواهد بود. کامپیوتر محلی شما جایی است که شما در حال توسعه و تست هستید. هنگامی که شما تغییرات را اعمال کردید، یک نسخه از برنامه خود را در گیت هاب قرار می‌دهید. وب سایت شما در PythonAnywhere خواهد بود و شما آن را با یک کپی جدید از کدهای خود که از گیت هاب گرفته‌اید، به روز رسانی خواهید کرد.
+
+# گیت
+
+> **نکته** اگر بخش [نصب و راه‌اندازی](../installation/README.md) را انجام داده‌اید، نیازی نیست که دوباره این بخش را انجام دهید. می‌توانید از این بخش رد شده و ساختن مخزن گیت را شروع کنید.
+
+{% include "/deploy/install_git.md" %}
+
+## ایجاد مخزن گیت
+
+نرم افزار گیت تغییرات یک مجموعه فایل که در جایی به نام مخزن (به طور مخفف repo) وجود دارند را ردگیری می‌کند. بیایید یکی برای پروژه خودمان بسازیم. کنسول خود را باز کنید و این دستورات را در پوشه `djangogirls` اجرا کنید:
+
+> ** توجه ** قبل از شروع به کار موقعیت پوشه‌ای را که در آن هستید با دستور `pwd` (در سیستم عامل Mac OS X / Linux) یا `cd` (در ویندوز) بفهمید. شما باید در پوشه `djangogirls` باشید.
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+راه اندازی مخزن گیت کاری است که ما برای هر پرژه فقط یک بار انجام می‌دهیم (لازم نیست مجدداً نام کاربری و ایمیل را وارد کنید).
+
+گیت هاب تغییرات روی تمام فایل‌ها و پوشه های زیرمجموعه این پوشه را پیگیری می‌کند، اما برخی فایل‌هایی که می‌خواهیم آن‌ها را نادیده بگیریم نیز وجود دارند. ما این کار را با ایجاد یک فایل به نام `.gitignore` در پوشه پایه انجام می‌دهیم. ویرایشگر خود را باز کنید و یک فایل جدید با محتویات زیر ایجاد کنید:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+و آن را در پوشه "djangogirls" با نام `.gitignore` ذخیره کنید.
+
+> ** توجه** نقطه در ابتدای نام فایل مهم است! اگر مشکلی در ایجاد آن دارید (به عنوان مثال Mac شما دوست ندارد فایل هایی را بسازید که با نقطه شروع می‌شود)، پس از ویژگی save as استفاده کنید که به کمک آن می‌توانید این نوع فایل‌ها را ذخیره کنید. و مطمئن باشید که هیچ پسوندی مانند `.txt` یا `.py` در انتهای فایل نگذاشته باشید نام این فایل فقط باید `.gitignore` باشد تا توسط Git شناسایی شود. لینوکس و MacOS با فایل‌هایی که با `.` شروع شوند (مانند `.gitignore`) مانند یک فایل مخفی شده برخورد می‌کند و دستور `ls` به طور معمول آن‌ها را نشان نمی‌دهد. به جای آن از دستور `ls -a` برای دیدن فایل `.gitignore` استفاده کنید.
+> 
+> **توجه** یکی از فایل‌هایی که در فایل `.gitignore` مشخص شده است فایل `db.sqlite3` است. این فایل پایگاه داده محلی شماست جایی که تمام اطلاعات مربوط به کاربر و پست‌های وبلاگ شما در آن ذخیره می‌شود. ما از روش استاندارد برنامه نویسی استفاده خواهیم کرد به این معنی که ما از پایگاه داده‌های متفاوتی برای توسعه بر روی کامپیوتر محلی و سپس وبسایت اصلی که روی PythonAnywhere هست استفاده خواهیم کرد. پایگاه داده بر روی PythonAnywhere می‌تواند SQLite باشد همانند آنچه بر روی کامپیوتر خود از آن استفاده می‌کنید اما معمولاً از پایگاه داده MySQL برای وبسایت اصلی استفاده می‌کنیم که می‌تواند تعداد بسیار زیاد بازدیدکننده از سایت را مدیریت کند. علاوه بر این حذف کردن فایل SQLite در کپی مربوط به GitHub به این معنی است که تمام پست‌های وبلاگی و superuser هایی که تا الان ساخته‌اید فقط روی کامپیوتر خودتان مورد استفاده خواهد بود و برای محیط اصلی وبسایت باید دوباره آن‌ها را بسازید. شما باید از پایگاه داده محلی خود به عنوان یک زمین بازی خوب استفاده کنید که در آن می‌توانید چیزهای مختلف را آزمایش کنید و نگرانی پاک کردن پست‌های اصلی از وبلاگ را نداشته باشید.
+
+ایده خوبی است که همیشه قبل از زدن دستور `git add` یا هر وقت که مطمئن نیستید چه چیزی تغییر کرده، دستور `git status` را بزنید. این کار کمک می‌کند که از هر نوع غافلگیری مانند اضافه کردن یا commit کردن فایل اشتباه، جلوگیری شود. دستور `git status` اطلاعاتی در مورد فایل‌های ردگیری نشده untracked، اصلاح شده modified، استیج شده staged و نیز درمورد وضعیت شاخه ای که در آن هستیم می‌دهد. خروجی باید شبیه به موارد زیر باشد:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+و در نهایت ما تغییرات را ذخیره می‌کنیم. به کنسول خود بروید و این دستورات را اجرا کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## کدهای خود را به GitHub انتقال دهید
+
+به [GitHub.com](https://www.github.com) بروید و یک حساب کاربری رایگان برای خود بسازید. اگر این کار را در کارگاه برای اولین بار انجام می‌دهید حواستان باشد که رمز عبور خود را حفظ کنید یا به نر‌م‌افزار مدیریت رمز عبور خود بسپرید.
+
+حالا یک مخزن یا repository بسازید و نام آن را "my-first-blog" بگذارید. گزینه "initialize with a README" را علامت نخورده باقی بگذارید و هم چنین گزینه .gitignore را هم خالی بگذارید (ما بعداً آن را اضافه خواهیم کرد). هم چنین گزینه License را None بگذارید.
+
+![](images/new_github_repo.png)
+
+> **توجه** نام `my-first-blog` مهم است. شما می‌توانید اسم دیگری انتخاب کنید اما از این اسم زیاد استفاده خواهیم کرد و به یاد داشته باشید که اگر اسم دیگری گذاشتید هرجا لازم بود اسم انتخابی خود را استفاده کنید. احتمالاً راحت‌تر است که از همین اسم `my-first-blog` استفاده نمایید.
+
+در صفحه بعد شما URL مخزن خود را خواهید دید که در برخی دستورات بعدی از آن استفاده خواهیم کرد:
+
+![](images/github_get_repo_url_screenshot.png)
+
+حالا وقت آن است که مخزن Git روی کامپیوتر شما را به مخزن موجود در Github وصل کنیم.
+
+خط زیر را در کنسول خود تایپ کنید (`<your-github-username>` را با نام کاربری و گذر واژه خود که در GitHub تعریف کرده اید عوض کنید. علامت‌های کوچکتر و بزرگتر را استفاده نکنید. URL باید دقیقاً همان آدرسی باشد که کمی قبل‌تر دیده‌اید):
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+وقتی شما فایلی را به GitHub می‌فرستید یا push می‌کنید نام کاربری و گذرواژه از شما پرسیده می‌شود (ممکن است در همان کنسول خط فرمان یا در یک پنجره جدید از شما پرسیده شود) پس از وارد کردن اطلاعات ورود، چیزی شبیه به این خواهید دید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+کد شما الان روی GitHub است. بروید و آن را کنترل کنید! خواهید دید که کدهای شما در جای خوبی است. پروژه [Django](https://github.com/django/django)، دوره آموزشی [Django Girls](https://github.com/DjangoGirls/tutorial) و بسیاری نرم‌افزارهای متن باز فوق العاده دیگر هم، کدهایشان را در GitHub قرار داده‌اند. :)
+
+# تنظیم کردن وبلاگ بر روی PythonAnywhere
+
+## یک حساب کاربری بر روی PythonAnywhere بسازید
+
+> **توجه** شما ممکن است کمی قبل‌تر و در مراحل نصب یک حساب کاربری در PythonAnywhere درست کرده باشید. اگر چنین است نیاز نیست که حساب کاربری دیگری بسازید.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## وبسایت‌مان را بر روی PythonAnywhere تنظیم کنیم
+
+با کلیک کردن بر روی لوگو و انتخاب گزینه شروع یک کنسول "Bash" به [داشبورد PythonAnywhere ](https://www.pythonanywhere.com/) بروید. این محیط خط فرمان مخصوص PythonAnywhere است، شبیه آنچه در کامپیوتر خود دارید.
+
+![بخش 'New Console' در صفحه وبسایت PythonAnywhere با دکمه‌ای برای 'bash'](images/pythonanywhere_bash_console.png)
+
+> **توجه** PythonAnywhere بر مبنای لینوکس است، بنابراین اگر روی ویندوز کار می‌کنید این محیط خط فرمان با آنچه در ویندوز دارید کمی متفاوت است.
+
+منتشر کردن یک اپلیکیشن تحت وب بر روی PythonAnywhere شامل آوردن کدها از GitHub و تنظیم کردن PythonAnywhere برای تشخیص آن و اجرا کردنش به عنوان یک برنامه تحت وب است. روش‌های غیرخودکار برای این کار وجود دارد اما PythonAnywhere یک ابزار کمکی دارد که همه این کارها را برای شما انجام می‌دهد. اجازه بدهید اول از همه این ابزار را نصب کنیم:
+
+{% filename %}خط فرمان PythonAnywhere {% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+این دستور باید چیزهایی شبیه به `Collecting pythonanywhere` بر روی صفحه نشان دهد و در انتها نیز این پیغام `Successfully installed (...) pythonanywhere- (...)` نمایش داده خواهد شد.
+
+حالا ما برنامه کمکی را اجرا می‌کنیم تا به طور اتوماتیک برنامه ما را از GitHub بخواند. خطوط زیر را در کنسول PythonAnywhere بنویسید (فراموش نکنید که نام کاربری GitHub را به جای `<your-github-username>` بنویسید در نتیجه URL شما مانند URL اختصاصی شما در GitHub میشود):
+
+{% filename %}خط فرمان PythonAnywhere {% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+همینطور که به اجراشدن آن نگاه می‌کنید می‌توانید بفهمید که چه کاری انجام می‌دهد:
+
+- دانلود کردن کد شما از GitHub
+- ساختن یک محیط مجازی virtualenv بر روی PythonAnywhere شبیه آنچه که بر روی کامپیوتر خود داشتید
+- به روزرسانی برخی از تنظیمات شما با تنظیمات مورد نیاز برای انتشار
+- تنظیم کردن یک دیتابیس در PythonAnywhere با استفاده از دستور `manage.py migrate`
+- تنظیم کردن فایل‌های ثابت شما (بعداً درمورد آن‌ها یاد خواهیم گرفت)
+- و در نهایت تنظیم کردن PythonAnywhere برای ارائه اپلیکیشن شما از طریق API خودش
+
+در PythonAnywhere تمام این مراحل اتوماتیک انجام می‌شود اما برای سایر سرورها شما باید دقیقا تمام این اقدامات را انجام دهید.
+
+مهم‌ترین چیزی که اینجا باید به آن توجه کنید آن است که پایگاه داده شما در اینجا از چیزی که بر روی کامپیوتر خود دارید کاملا مستقل است در نتیجه ممکن است اینجا حساب کاربری ادمین یا پست‌های متفاوتی نسبت به کامپیوتر شخصی خود داشته باشید. در نتیجه همان طور که بر روی کامپیوتر خودمان انجام داده ایم باید یک کاربر admin با دستور `createsuperuser` بسازیم. PythonAnywhere به صورت اتوماتیک محیط مجازی یا virtulenv شما را فعال کرده است درنتیجه تنها چیزی که لازم دارید این است که خط زیر را اجرا کنید:
+
+{% filename %}خط فرمان Python Anywhere{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+مشخصات کاربر ادمین را وارد کنید. می‌توانید این اطلاعات را شبیه اطلاعات ادمین که قبلاً در کامپیوتر خود زده‌اید در نظر بگیرید مگر اینکه بخواهید گذره واژه امن‌تری در PythonAnywhere در نظر بگیرید.
+
+حالا اگر بخواهید می‌‌توانید نگاهی به کدهای خود در PythonAnywhere بیندازید دستور `ls` را بزنید:
+
+{% filename %}خط فرمان PythonAnywhere{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.pytests.py  static
+    templates  views.py
+    
+
+علاوه بر این می‌توانید به صفحه File بروید و به کمک مرورگر فایل پیش‌ساخته که در PythonAnywhere قرار داده شده به فایل‌های خود نگاهی بیاندازید. از صفحه کنسول و به کمک کلید منو در گوشه بالا و سمت راست، می توانید به سایر صفحات PythonAnywhere بروید. وقتی شما در یک صفحه هستید، نزدیک به بالای صفحه، لینک‌هایی به سایر صفحات وجود دارد.
+
+## اکنون آنلاین هستید!
+
+وب‌سایت شما باید الان به طور عمومی در اینترنت منتشر شده باشد! از طریق صفحه "Web" در PythonAnywhere لینک به این صفحه را پیدا کنید. شما می‌توانید این صفحه را با هر کسی به اشتراک بگذارید. :)
+
+> **توجه** این یک تمرین ابتدایی است و ما در هنگام انتشار، برخی میانبرهایی را استفاده کرده‌ایم که از جنبه امنیت وبسایت، روش‌های ایده‌آلی نیستند. هرگاه تصمیم گرفتید که این پروژه یا پروژه دیگری را بسازید، باید به راهنمایی‌های امنیتی موجود در [چک لیست انتشار جنگو](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) نگاهی بیندازید.
+
+## نکات عیب‌یابی
+
+اگر شما با خطایی در هنگام اجرا کردن دستور `pa_autoconfigure_django.py` مواجه شدید ممکن است به دلایل زیر باشد:
+
+- فراموشی در ساخت توکن API در PythonAnywhere.
+- اشتباه در URL مربوط به GitHub
+- اگر خطایی با این مضمون *"Could not find your settings.py"* مشاهده کردید، احتمالاً تمام فایل‌های خود را به Git اضافه نکرده‌اید یا همه آن‌ها را (به کمک دستور push) به GitHub نفرستاده‌اید. به بخش Git در بالا نگاهی دوباره بیندازید
+- اگر قبلاً حساب کاربری در PythonAnywhere داشته‌اید و خطای collectstatic دریافت می‌کنید احتمالاً نسخه‌های قدیمی‌تر SQLite (مثلاً 3.8.2) را در حساب کاربری خود دارید. در این موارد، یک حساب کاربری جدید بسازید و دستورات مربوط به PythonAnywhere را دوباره بزنید.
+
+اگر هنگام مراجعه به وبسایت خطایی مشاهده کردید اولین جا برای بررسی و عیب یابی نگاه کردن به بخش **error log** است. حتماً در صفحه ["Web"](https://www.pythonanywhere.com/web_app_setup/) در PythonAnywhere لینکی به این بخش پیدا خواهید کرد. نگاه کنید که آیا پیغام خطایی در این صفحه وجود دارد؛ آخرین پیغام‌ها در پایین‌ترین خط ها است.
+
+علاوه بر این دستورالعمل‌های عیب‌یابی عمومی‌تری هم در [صفحه راهنمای سایت PythonAnywhere](http://help.pythonanywhere.com/pages/DebuggingImportError) وجود دارد.
+
+و به یاد داشته باشید که مربی شما اینجاست تا به شما کمک کند!
+
+# وبسایت خود را بررسی کنید!
+
+صفحه اصلی سایت شما باید "It worked" را نشان دهد همانطور که بر روی کامپیوتر خودتان کار می‌کرد. سعی کنید ` /admin/ ` را به انتهای آدرس اینترنتی اضافه کنید و به سایت مدیریت برسید. با نام کاربری و گذرواژه خود وارد شوید خواهید دید که می‌توانید پست جدیدی ایجاد کنید. به یاد داشته باشید که پست‌هایی که در پایگاه داده کامپیوتر خود ایجاد کرده اید بر روی وبسایت آنلاین شما منتقل نشده است.
+
+وقتی چند پست جدید ایجاد کردید به تنظیمات بر روی کامپیوتر خود (local و نه تنظیمات روی PythonAnywhere) برگردید. از اینجا می‌توانید تنظیمات محلی را تغییر دهید. این یک روش رایج در توسعه وبسایت است؛ تغییرات را روی کامپیوتر خود اعمال کنید، آن‌ها را به GitHub بفرستید و سپس این تغییرات را از گیتهاب، بر روی وب سرور کپی کنید. این روش کمک می‌کند که بدون ایجاد خرابی در وبسایت آنلاین بتوان آن را به روز رسانی کرد. جالب نیست؟
+
+یک *خسته نباشید* حسابی به خودتان بگویید! راه اندازی سرور یکی از مهارتی‌ترین بخش‌های توسعه وبسایت است و گاهی برای برخی افراد روزها زمان می‌برد تا بتوانند آن را راه اندازی کنند. اما شما توانستید سایت خود را بر روی اینترنت واقعی راه اندازی کنید!
\ No newline at end of file
diff --git a/fa-IR/deploy/install_git.md b/fa-IR/deploy/install_git.md
new file mode 100644
index 00000000000..ff86d8911c0
--- /dev/null
+++ b/fa-IR/deploy/install_git.md
@@ -0,0 +1,52 @@
+گیت یک "سیستم کنترل نسخه" است که توسط بسیاری از برنامه‌نویسان مورد استفاده قرار می‌گیرد. این نرم‌افزار می‌تواند تغییرات روی فایل‌ها را در طول زمان دنبال کند بنابراین می‌توانید نسخه خاصی را بعداً بازیابی کنید. این قابلیت تقریباً شبیه ابزار "track changes" در برنامه‌های ویرایش متن (مانند Microsoft Word و LibreOffice Writer) است اما به مراتب از آن‌ها قویتر است.
+
+## نصب گیت
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+برای نصب گیت می‌توانید آن را از [git-scm.com](https://git-scm.com/) دانلود کنید. همه جا میتوانید کلید next را بزنید به غیر از دو جا: جایی که در مورد ویرایشگر متن از شما می‌پرسد شما باید ویرایشگر Nano را انتخاب کنید و در مرحله‌ای که عنوان آن "Adjusting your PATH environment" است، گزینه "Use Git and optional Unix tools from the Windows Command Prompt" (گزینه آخر) را انتخاب کنید. در بقیه موارد، پیش فرض‌ها مناسب هستند. گزینه "Checkout Windows-style, commit Unix-style line endings" را انتخاب کنید.
+
+فراموش نکنید که بعد از اینکه نصب به پایان رسید command prompt یا PowerShell را از نو باز کنید. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+گیت را از [git-scm.com](https://git-scm.com/) دانلود کنید و دستورالعمل‌ها را دنبال کنید.
+
+> ** نکته **اگر شما از OS X نسخه 10.6، 10.7 یا 10.8 استفاده می‌کنید باید GIT را از اینجا نصب کنید: [ نصب Git برای OS X Snow Leopard ](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/fa-IR/deploy/signup_pythonanywhere.md b/fa-IR/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..919b24ce459
--- /dev/null
+++ b/fa-IR/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere سرویسی است که برای اجرای کدهای نوشته شده با پایتون در سرورهای ابری استفاده می‌شود. ما از آن برای میزبانی سایت خود و قرار دادن آن بر روی اینترنت استفاده خواهیم کرد.
+
+بلاگی که در حال ساختن آن هستیم را بر روی PythonAnywhere قرار خواهیم داد. برای استفاده از سرویس PythonAnywhere میتوانید به صورت رایگان به عنوان تازه کار در آن ثبت نام کنید (ثبت نام به صورت تازه کار برای کار ما کفایت می کند. نیازی به ورود کارت اعتباری نیست).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![صفحه ثبت نام PythonAnywhere دارای امکان ثبت نام رایگان برای کاربران تازه کار می باشد](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **نکته:** هنگام انتخاب نام کاربری خود به این نکته توجه داشته باشید که آدرس بلاگ شما با نام کاربری شما به صورت `yourusername.pythonanywhere.com` مشخص خواهد شد. بنابراین علاوه بر استفاده از نام خود به عنوان نام کاربری، می‌توانید از یک اسم دلخواه برای بلاگ خود استفاده کنید. هچینین رمز عبور خود را به خاطر داشته باشید.
+
+## ایجاد API توکن PythonAnywhere
+
+این کار را فقط یکبار هنگام شروع انجام خواهید داد. پس از اینکه در PythonAnywhere ثبت نام کردید به داشبورد خود هدایت خواهید شد. در سمت راست بالای صفحه بر روی Account خود کلیک کنید:
+
+![لینک Account در سمت راست بالای صفحه](../deploy/images/pythonanywhere_account.png)
+
+سپس به تب "API token" رفته و "Create new API token" را بزنید.
+
+![تب API token در صفحه Account](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/fa-IR/django/README.md b/fa-IR/django/README.md
new file mode 100644
index 00000000000..9870bd4f5a8
--- /dev/null
+++ b/fa-IR/django/README.md
@@ -0,0 +1,27 @@
+# جنگو چیست؟
+
+جنگو (*جَنگو*) یک فریم‌ورک تحت وب رایگان و متن بازopen source است که با زبان پایتون نوشته شده‌است. یک فریم ورک تحت وب، دارای مجموعه‌ای از ابزارهاست که به شما کمک می‌کنند تا یک وب سایت را سریع‌تر و راحت‌تر توسعه دهید.
+
+هنگامی که در حال ساخت یک وب سایت هستید، شما همیشه به مجموعه ای از اجزای مشابه نیاز دارید. به شرح زیر: یک روش برای کنترل کردن احراز هویت کاربر (ثبت نام ، ورود به حساب کاربری ، خروج از حساب کاربری) ، یک پنل مدیریت برای وب سایت خود ، فرم ها ، روشی برای آپلود فایل ها و غیره.
+
+خوشبختانه خیلی وقت پیش، افرادی متوجه این موضوع شدند که هنگام ساختن یک سایت جدید، توسعه دهندگان وب با مشکلات مشابهی روبرو می‌شوند، بنابراین آنها تیمی را تشکیل دادند که به راحتی اجزای کار را در اختیار شما قرار می‌دهد که شما بتوانید به راحتی از آنها استفاده کنید ودر نهایت فریم ورک‌ها را ساختند (جنگو یکی از آن هاست).
+
+فریم ورکها به این دلیل به وجود آمده اند که دیگر نیازی نباشد شما از اول چرخ را بسازید و به شما کمک می کند تا به راحتی سایت خود را بسازید.
+
+## چرا شما به یک فریم ورک نیاز دارید؟
+
+برای درک بهتر چگونگی عملکرد جنگو لازم است نگاه دقیق‌تری به سرورها بیندازیم. اولین چیزی که سرور نیاز دارد بداند این است که شما می‌خواهید سرور برای شما یک وب پیج را ارائه کند.
+
+حالا یک صندوق پست (port) را تصور کنید که منتظر دریافت نامه‌ها (requests) است. این کار توسط وب سرور انجام خواهد گرفت. وب سرور نامه را خوانده و پاسخ مربوطه را به وب پیج می فرستد. اما هنگامی که شما می‌خواهید چیزی را ارسال کنید، به محتوا احتیاج دارید. و جنگو همانی است که به شما برای ایجاد محتوا کمک می‌کند.
+
+## زمانی که فردی از سرور شما یک وبسایت را درخواست می‌کند، چه اتفاقی می‌افتد؟
+
+هنگامی که یک درخواست به وب سرور می آید، به جنگو انتقال داده می شود و جنگو تلاش می‌کند بفهمد که دقیقاً چه چیزی درخواست شده است. در ابتدا آدرس وب پیج را می‌گیرد و سعی می‌کند تشخیص دهد چه کاری باید انجام دهد. این بخش توسط **urlresolver** جنگو انجام می‌گیرد (آدرس وبسایت URL یا Uniform Resource Locator نامیده می‌شود به این دلیل *urlresolver* یا تجزیه کننده URL نام با مسمایی است). خیلی سیستم هوشمندی نیست فقط یک لیست از الگوها را می‌گیرد و سعی می‌کند درخواست را با یکی از این الگوها مطابقت دهد. جنگو الگوها را از بالا به پایین بررسی می‌کند و اگر الگویی مشابه درخواست پیدا کرد، آن درخواست را به تابع مرتبط با آن الگو (که * view * نامیده می‌شود) ارسال می‌کند.
+
+یک پستچی را با یک نامه تصور کنید. او در خیابان راه می‌رود و پلاک هر خانه را با پلاک نوشته شده روی نامه مقایسه می‌کند. اگر مطابقت داشته باشد، نامه را در آنجا می گذارد. این روش کار urlresolver است!
+
+در تابع * view*، تمام چیزهای جالب اتفاق می‌افتد: ما می‌توانیم به یک پایگاه داده نگاه کنیم تا اطلاعاتی را جستجو کنیم. شاید کاربر درخواست تغییر در داده را داشته باشد؟ مانند درخواست‌هایی که در یک نامه فرستاده می‌شوند: "لطفا شرح شغل من را تغییر دهید". تابع * view* می‌تواند بررسی کند که آیا شما مجاز به انجام این کار هستید، و سپس شرح شغل را برای شما به روز رسانی کرده و یک پیام را ارسال کند: "انجام شد!" سپس تابع *view * یک پاسخ ایجاد می‌کند و جنگو می‌تواند آن را به مرورگر وب کاربر ارسال کند.
+
+توضحیحات بالا کمی ساده شده‌اند اما شما نیازی ندارید که همه ریزه‌کاری‌های فنی را بدانید. یک درک کلی از فرآیند کافی است.
+
+پس به جای آن که بیش از این سراغ جزییات برویم می‌خواهیم با جنگو چیزی بسازیم و بخش‌های مهم آن را در این مسیر یاد بگیریم!
\ No newline at end of file
diff --git a/fa-IR/django_admin/README.md b/fa-IR/django_admin/README.md
new file mode 100644
index 00000000000..e571d29a120
--- /dev/null
+++ b/fa-IR/django_admin/README.md
@@ -0,0 +1,57 @@
+# پنل مدیریت در جنگو
+
+برای اضافه کردن، ویرایش و حذف پست‌هایی که به تازگی مدلشان را درست کرده‌ایم، از جنگو ادمین یا پنل مدیریت جنگو استفاده خواهیم کرد.
+
+فایل `blog/admin.py` را در ویرایشگر کد باز کنید و محتوای آن را با خطوط زیر عوض کنید:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+همانطور که می‌بینید، مدل Post را که در بخش قبل تعریف کرده بودیم فراخوانی کرده‌ایم. برای اینکه مدل ما در صفحه مدیریت نمایش داده شود، ما باید مدل را با دستور ` admin.site.register(Post)` ثبت کنیم.
+
+خوب، وقت آن است که به مدل Post نگاهی بیندازیم. به خاطر داشته باشید که دستور `python manage.py runserver` را در کنسول اجرا کنید تا وب سرور اجرا شود. به مرورگر خود بروید و آدرس http://127.0.0.1:8000/admin/ را تایپ کنید. شما یک صفحه لاگین را به شکل زیر می‌بینید:
+
+![صفحه لاگین](images/login_page2.png)
+
+برای ورود به سیستم، باید یک کاربر *superuser* ایجاد کنید - یک حساب کاربری که بر روی همه چیز در سایت کنترل داشته باشد. به محیط خط فرمان بازگردید و دستور `python manage.py createsuperuser` را تایپ کنید و Enter را فشار دهید.
+
+> به یاد داشته باشید، برای نوشتن دستورات جدید در حالی که وب سرور در حال اجرا است، یک پنجره ترمینال جدید را باز کرده و محیط مجازی خود را فعال کنید. ما در مورد نحوه نوشتن دستورات جدید در بخش **راه اندازی وب سرور** از فصل **اولین پروژه جنگو شما!** صحبت کردیم.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+هنگام درخواست، نام کاربری (با حروف کوچک و بدون فاصله)، آدرس ایمیل و رمز عبور را تایپ کنید. **نگران نباشید که تایپ شدن گذر واژه را نمی‌بینید، همانطور است که باید باشد.** گذرواژه را وارد کنید و `Enter` را بزنید. خروجی باید مانند این باشد (که در آن نام کاربری و ایمیل خود را باید ببینید):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+به مرورگر خود برگردید و با نام کاربری که انتخاب کرده اید وارد شوید. شما باید داشبورد مدیریت جنگو را ببینید.
+
+![جنگو ادمین](images/django_admin3.png)
+
+به بخش Post بروید و کمی با آن کار کنید. پنج یا شش پست وبلاگی بسازید. نگران محتوای پست‌ها نباشید، این پست‌ها فقط به صورت محلی و برای شما نمایش داده خواهد شد. می‌توانید برای صرفه جویی در وقت از جایی مطالبی در آن کپی کنید. :)
+
+اطمینان حاصل کنید که حداقل برای دو یا سه پست (اما نه همه پست‌ها) تاریخ انتشار را تعیین کنید. بعداً مفید خواهد بود.
+
+![پنل مدیریت در جنگو](images/edit_post3.png)
+
+اگر می‌خواهید در مورد پنل مدیریت جنگو بیشتر بدانید باید مستندات جنگو را نگاه کنید: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+احتمالاً الان وقت مناسبی است تا قهوه یا چای بنوشید یا چیزی برای خوردن پیدا کنید تا دوباره سرحال شوید. شما اولین مدل جنگو را ایجاد کردید و شایسته یک استراحت کوتاه هستید!
\ No newline at end of file
diff --git a/fa-IR/django_forms/README.md b/fa-IR/django_forms/README.md
new file mode 100644
index 00000000000..4f696368d76
--- /dev/null
+++ b/fa-IR/django_forms/README.md
@@ -0,0 +1,479 @@
+# فرم در جنگو
+
+آخرین چیزی که می‌خواهیم در وب سایت مان انجام دهیم ایجاد یک راه خوب برای اضافه کردن و ویرایش پست‌های وبلاگ است. `ادمین ` جنگو خوب است، اما سخت است که آن را زیبا یا سفارشی کنیم. با ` فرم‌ها ` ما کنترل کاملی بر روی صفحه خود داریم. تقریباً می‌توانیم هرکاری که بخواهیم انجام دهیم!
+
+ویژگی فرم‌ها در جنگو این است که ما می‌توانیم یکی را از ابتدا تعریف کنیم یا از `ModelForm`استفاده کنیم که نتیجه فرم را به صورت مدل ذخیره می‌کند.
+
+این دقیقا همان چیزی است که ما می‌خواهیم انجام دهیم: ما یک فرم را برای مدل ` Post` ایجاد خواهیم کرد.
+
+مانند هر بخش مهمی از جنگو، فرم‌ها فایل خود را دارند: ` forms.py`.
+
+ما باید یک فایل با این نام در پوشه ` blog` ایجاد کنیم.
+
+    blog
+       └── forms.py
+    
+
+خوب، اجازه دهید آن را در ویرایشگر کد باز کنیم و خطوط زیر را تایپ کنیم:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+باید در ابتدا فرم‌های جنگو را فراخوانی کنیم (`from django import forms`) سپس مدل مربوط به `Post` را نیز فراخوانی کنیم(`from .models import Post`).
+
+` PostForm`، همانطور که احتمالاً حدس زده اید، نام فرم ما است. ما باید به جنگو بگوییم که این فرم یک نوع `ModelForm` است (بنابراین جنگو برای ما چند کار جادویی انجام خواهد داد) - `forms.ModelForm` مسئول انجام این کارها است.
+
+بعد از این، ما `class Meta` را داریم، جایی که به جنگو می‌گویم که کدام مدل باید برای ایجاد این فرم (`model = Post`) استفاده شود.
+
+در نهایت می‌توانیم بگوییم که کدام بخش‌ (بخش‌ها) باید در فرم ما باشد. در این سناریو ما تنها `title` و `text` را می‌خواهیم نشان دهیم - `author` باید فردی باشد که در حال حاضر وارد شده است (شما!) و `created_date` تاریخ ایجاد یک پست جدید است که باید به طور خودکار تنظیم شود، درست است؟
+
+و همین! تمام مواردی که اکنون باید انجام دهیم، استفاده از فرم در یک *view* و نمایش آن در تمپلیت است.
+
+بنابراین یک بار دیگر یک لینک، یک URL، یک view و یک تمپلیت ایجاد خواهیم کرد.
+
+## لینک به یک صفحه با فرم
+
+قبل از آنکه لینک را اضافه کنیم، لازم است آیکونی را به عنوان دکمه برای این لینک اضافه کنیم. برای این دوره آموزشی فایل [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) را دانلود کنید و آن را در پوشه `blog/templates/blog/icons/` ذخیره کنید
+
+> نکته: برای دانلود فایل SVG منو زمینه‌ای مربوط به آن را باز کنید (معمولاً به کمک راست کلیک بر روی آن) و بعد گزینه "Save link as" را انتخاب کنید. در پنجره‌ای که باز می‌شود آدرس محلی که می‌خواهید فایل را ذخیره کنید، مشخص کنید، به پوشه `djangogirls` که پروژه جنگو شما در آن است بروید و پوشه `blog/templates/blog/icons/` را پیدا کنید و فایل را در آن ذخیره کنید.
+
+وقت آن است که فایل `blog/templates/blog/base.html` را در ویرایشگر متن خود باز کنید. حالا می‌توانیم از فایل آیکون در تمپلیت base به شکل زیر استفاده کنیم. در عنصر `div` که در بخش `header` قرار دارد، لینکی قبل از عنصر `h1` اضافه خواهیم کرد:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+توجه داشته باشید که ما می‌خواهیم نام ویو جدید را `post_new` بگذاریم. آیتم [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) توسط [Bootstrap Icons](https://icons.getbootstrap.com/) ارائه می‌شود و علامتی مانند یک صفحه به همراه یک علامت به اضافه، نشان خواهد داد. ما از یک هدایت‌کننده جنگو یا Django template directive، به اسم `include` استفاده می‌کنیم. این هدایت‌کننده محتوای یک فایل را به تمپلیت جنگو تزریق می‌کند. مرورگر وب به خوبی می‌تواند این نوع از محتوا را بدون پردازش‌های اضافه، مدیریت کند.
+
+> شما می‌توانید تمام آیکون‌های بوتسترپ را از [اینجا](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip) دانلود کنید. فایل را از حالت زیپ خارج کنید و همه تصاویر را در پوشه‌ای به نام `icons` در داخل پوشه `blog/templates/blog/` قرار دهید. به این روش شما می‌توانید به آیکونی مانند `pencil-fill.svg` از طریق آدرس `blog/templates/blog/icons/pencil-fill.svg`، دسترسی داشته باشید
+
+بعد از اصلاح این خط، فایل شما باید به این شکل باشد:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+پس از ذخیره و بازخوانی صفحه http://127.0.0.1:8000 شما با یک خطای شناخته شده `NoReverseMatch` مواجه خواهید شد، درست است؟ بسیار عالی!
+
+## آدرس اینترنتی
+
+فایل `blog/urls.py` را باز کرده و کد زیر را به آن اضافه می‌کنیم:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+و در نهایت کد ما بصورت زیر خواهد بود:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+از آنجایی که ویوی `post_new` را پیاده سازی نکرده ایم، هنگامی که سایت را ریفرش کنیم با خطای `AttributeError` مواجه خواهیم شد. پس باید ویوی مربوطه را نیز بسازیم:
+
+## ویو post_new
+
+زمان آن است که فایل `blog/views.py` را در ویرایشگر کد باز کنید و خطوط زیر را در ردیف `from` ها اضافه کنید:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+و حالا *view* ما:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+برای ایجاد یک فرم جدید`Post`، ما باید`()PostForm` را فراخوانی کنیم و آن را به تمپلیت منتقل کنیم. ما به این *view* باز خواهیم گشت، اما در حال حاضر، بیایید به سرعت یک تمپلیت برای این فرم ایجاد کنیم.
+
+## تمپلیت
+
+لازم است یک فایل به نام `post_edit.html`در پوشه `blog/templates/blog`بسازیم و آن را در ویرایشگر کد بازکنیم. برای آنکه یک فرم کار کند به چند چیز نیاز داریم:
+
+* ما باید فرم را نمایش دهیم. مثلاً می‌توانیم این کار را با {% raw %}`{{ form.as_p }}`{% endraw %} انجام دهیم.
+* خط بالا باید درون تگ فرم HTML پیچیده شود: `<form method="POST">... </form>`.
+* ما به یک دکمه `ذخیره کردن` نیاز داریم. این کار را با یک دکمه HTML انجام می‌دهیم: `<button type="submit">Save</button>`.
+* و در نهایت، درست بعد از باز شدن تگ `<form ...>` باید {% raw %}`{% csrf_token %}`{% endraw %} را اضافه کنیم. نوشتن این عبارت بسیار مهم است، زیرا فرم‌های شما را امن می‌کند! اگر شما این تکه را فراموش کنید، جنگو هنگام تلاش برای ذخیره کردن فرم پیغام خطا می‌دهد:
+
+![صفحه خطا CSRF](images/csrf2.png)
+
+خوب، بگذار ببینیم HTML در فایل `post_edit.html` چطور باید باشد:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+حالا زمان به روزرسانی پروژه است! بله فرم شما نمایش داده می‌شود!
+
+![فرم جدید](images/new_form2.png)
+
+اما یک دقیقه صبر کنید وقتی چیزی را در فیلدهای `title` و `text` تایپ کنید و سعی کنید آن را ذخیره کنید، چه اتفاقی خواهد افتاد؟
+
+هیچ چی! ما یک بار دیگر در همان صفحه هستیم و متن ما رفته است... و هیچ پست جدیدی اضافه نشده است. پس چه اتفاقی افتاد؟
+
+جواب این است: هیچ چیز. ما باید در *view* خودمان کمی کارهای بیشتری انجام دهیم.
+
+## ذخیره فرم
+
+یکبار دیگر فایل `blog/views.py` را در ویرایشگر کد باز کنید. در حال حاضر آنچه که در ویو `post_new` داریم این هاست:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+هنگامی که فرم را ارسال می‌کنیم، ما به همان ویوی قبل باز می‌گردیم، اما این بار ما در `request` داده‌های بیشتری داریم، به ویژه در `request.POST` (نامگذاری request.POST هیچ ارتباطی با "پست" وبلاگ ندارد و به معنی آن است که ما در حال ارسال اطلاعات هستیم). به یاد می آورید که چگونه در فایل HTML، تعریف `<form>` دارای متغیر `method="POST"` بود؟ تمام فیلدهای فرم اکنون در `request.POST` قرار دارند. شما نباید عبارت `POST` را در اینجا به چیز دیگری تغییر دهید (تنها مقدار معتبر دیگر برای `method` مقدار `GET` است، اما الان وقت آن را نداریم تا تفاوت آن‌ها را توضیح دهیم).
+
+بنابراین در *view*، ما دو موقعیت جداگانه برای رسیدگی داریم: اول اینکه زمانی که ما برای اولین بار به صفحه می‌رویم و یک فرم خالی را می‌خواهیم، و دوم، وقتی با اطلاعات نوشته شده درون فرم، به *view* برمی‌گردیم. بنابراین ما نیاز به اضافه کردن یک شرط داریم (ما از `if`برای این منظور استفاده می‌کنیم):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+وقت آن است که نقاط `[...]` را پر کنید. اگر مقدار `method` برابر با `POST` باشد، ما می خواهیم که با اطلاعات درون فرم `PostForm` را بسازیم، درست است؟ ما این کار را به صورت زیر انجام خواهیم داد:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+قدم بعدی این است که بررسی کنید که آیا فرم صحیح است (تمام فیلدهای لازم تنظیم شده و مقادیر نادرست وارد نشده است). ما این کار را با `form.is_valid()` انجام می‌دهیم.
+
+ما بررسی می کنیم که آیا فرم معتبر است و اگر چنین باشد، می توانیم آن را ذخیره کنیم!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+اساساً، ما دو چیز در اینجا داریم: فرم را با `form.save` ذخیره می‌کنیم سپس یک نویسنده برای مطلب تعیین می‌کنیم (از آنجا که فیلد `author` در فرم موجود نبوده و داشتن نویسنده برای مطلب در `PostForm`الزامی است). `commit=False` بدین معنی است که ما نمی‌خواهیم مدل `Post` را ذخیره کنیم - ما می‌خواهیم ابتدا نویسنده را اضافه کنیم. در بیشتر موارد شما از `()form.save` بدون `commit=False` استفاده می‌کنید، اما در این مورد، ما باید آن را استفاده کنیم. `()post.save` تغییرات (اضافه کردن نویسنده) را اعمال می‌کند و یک پست جدید بلاگ ایجاد می‌شود!
+
+سرانجام، خوب بود اگر می‌توانستیم بلافاصله به صفحه جزییات پست جدید `post_detail` که هم اکنون ساخته‌ایم برویم، درست است؟ برای این کار ما نیاز به فراخوانی دیگری داریم:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+آن را در ابتدای فایل خود اضافه کنید. و اکنون می‌توان گفت، "به صفحه جزییات پست `post_detail` برای پست جدید برو":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` نام ویویی است که ما می‌خواهیم به آن برویم. به یاد دارید که این *view* نیاز به متغیر `pk` دارد؟ برای فرستادن آن به ویو، از `pk=post.pk` استفاده می‌کنیم، که در آن `post` جدیدترین پست وبلاگ است!
+
+خوب، ما خیلی صحبت کرده‌ایم، اما احتمالاً می‌خواهید ببینید که کل *view* چگونه به نظر می‌رسد، درست است؟
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+بیایید ببینیم که آیا کار می‌کند. به صفحه http://127.0.0.1:8000/post/new/ بروید، یک `title` و یک `text` اضافه کنید و نتیجه را ببینید! پست جدید وبلاگ اضافه شده است و ما به صفحه `post_detail` هدایت می‌شویم!
+
+ممکن است متوجه شده باشید که قبل از ذخیره پست، تاریخ انتشار را تنظیم کرده‌ایم. بعدها، ما دکمه *publish button* را در بخش **Django Girls Tutorial: Extensions** معرفی می‌کنیم.
+
+این عالیه!
+
+> همانطور که اخیراً رابط کاربری ادمین جنگجو را استفاده کردیم، سیستم در حال حاضر فکر می‌کند ما هنوز در سیستم لاگین هستیم. چند موقعیت وجود دارد که می تواند منجر به خروج ما از رابط کاربری مدیریت شود (بسته شدن مرورگر، راه اندازی مجدد دیتابیس و غیره). اگر در هنگام ایجاد یک پست متوجه شدید که خطایی در رابطه با عدم وجود یک کاربر ایجاد شده است، به صفحه مدیریت http://127.0.0.1:8000/admin بروید و دوباره وارد شوید. این مسأله به طور موقت حل خواهد شد. یک تکلیف اضافه برای خانه که بعد از بخش اصلی آموزش، انتظار شما را می‌کشد رفع مشکلات امنیتی وبسایت در بخش **Homework: add security to your website!** است.
+
+![خطا ورود به سیستم](images/post_create_error.png)
+
+## اعتبارسنجی فرم
+
+حالا به شما نشان می‌دهیم که فرم‌ها در جنگو چقدر جالب هستند. یک پست وبلاگ باید فیلدهای `title` و `text` را داشته باشد. در مدل `Post` ما نگفتیم که این فیلدها (به غیر از `published_date`) الزامی نیستند، بنابراین، جنگو به طور پیش فرض آن‌ها را الزامی می‌داند.
+
+سعی کنید فرم را بدون `title` و `text` ذخیره کنید. حدس بزنید چه اتفاقی خواهد افتاد!
+
+![اعتبارسنجی فرم](images/form_validation2.png)
+
+جنگو مواظب است که تمام فیلدهای موجود در فرم ما صحیح پر شده باشند. فوق‌العاده نیست؟
+
+## ويرايش فرم
+
+حالا ما می‌دانیم که چگونه یک پست جدید اضافه کنیم. اما اگر بخواهیم یک فرم موجود را ویرایش کنیم، چه؟ این کار بسیار شبیه آنچه ما انجام داده‌یم است. بگذارید برخی از چیزهای مهم را سریع بسازیم. (اگر چیزی را درک نمی‌کنید، باید از مربی خود بپرسید یا در فصل‌های قبلی نگاه کنید، زیرا ما قبلاً همه این مراحل را پوشش دادیم.)
+
+ابتدا، اجازه دهید که آیکونی که نمایش دهنده دکمه اصلاح است را ذخیره کنیم. فایل [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) را دانلود کنید و آن را در آدرس `blog/templates/blog/icons/` ذخیره کنید.
+
+فایل `blog/templates/blog/post_detail.html` را در ویرایشگر متن باز کنید و خطوط زیر را به عنصر `article` اضافه کنید:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+قالب فوق شبیه به این خواهد شد:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+فایل `blog/urls.py` را باز کنید و خط زیر را به آن اضافه کنید:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+ما از این تمپلیت `blog/templates/blog/post_edit.html` مجدداً استفاده خواهیم کرد پس تنها قطعه باقی مانده *view* است.
+
+فایل `blog/views.py` را باز کنید و خط زیر را به انتهای این فایل اضافه کنید:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+این ویو شبیه ویوی `post_new` ماست، درست است؟ اما نه دقیقاً. در ابتدا ما یک پارامتر `pk` اضافی از `urls` ارسال کرده‌ایم. سپس مدل `Post` را که می‌خواهیم اصلاح کنیم با دستور `get_object_or_404(Post, pk=pk)` می‌گیریم و بعد از آن یک فرم می‌سازیم و این فرم را به صورت `instance`ارسال می‌کنیم، هر دو این کارها وقتی اتفاق می‌افتد که فرم را ذخیره می‌کنیم…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+… و هنگامی که یک فرم را به این صورت برای تغییر دادن باز می‌کنیم:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+بسیار خوب، حالا بیایید امتحان کنیم که آیا کار می‌کند! به صفحه `post_detail` بروید. باید یک کلید edit در گوشه سمت راست بالا باشد:
+
+![کلید Edit](images/edit_button2.png)
+
+وقتی بر روی آن کلیک کنید یک فرم که با اطلاعات پست وبلاگی ما پر شده است نشان داده می‌شود:
+
+![فرم Edit](images/edit_form2.png)
+
+به راحتی محتوای پست را تغییر دهید و آن را ذخیره کنید!
+
+تبریک! برنامه شما کامل و کامل‌تر می‌شود!
+
+اگر اطلاعات بیشتری در مورد فرم‌ها در جنگو لازم دارید باید مستندات مربوط به آن را در این آدرس بخوانید: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## امنیت
+
+ساختن یک پست جدید فقط با یک کلیک، بسیار فوق العاده است! اما همین الان هرکسی که از صفحه شما بازدید می‌کند می‌تواند به راحتی یک پست جدید بسازد و این احتمالاً چیزی نیست که شما بخواهید. حالا بیایید کاری کنیم که این دکمه فقط برای شما نشان داده شود و کس دیگری آن را نبیند.
+
+فایل `blog/templates/blog/base.html` را در ویرایشگر کد باز کنید بخش `div` با نام `header` و تگ a موجود در آن را پیدا کنید. باید چیزی شبیه به این باشد:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+حالا ما می‌خواهیم یک تگ `{% if %}` دیگر به این اضافه کنیم که باعث خواهد شد این لینک فقط برای کاربری نشان داده شود که به عنوان ادمین وارد شده باشد که در حال حاضر فقط شما هستید! تگ `<a>` را به شکل زیر تغییر دهید:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+تگ `{% if %}` باعث خواهد شد که لینک فقط در صورتی به مرورگر ارسال شود که کاربر درخواست کننده صفحه، با حساب کاربری ادمین وارد شده باشد. این کار به طور کامل ساختن پست جدید را محافظت نمی‌کند اما قدم اولیه‌ی خوبی است. مباحث بیشتری از امنیت را در بخش‌های اضافه آموزش پوشش خواهیم داد.
+
+کلید edit را که به صفحه جزییات یک پست اضافه کردیم به یاد دارید؟ حالا همین کار را برای آن صفحه نیز می‌خواهیم انجام دهیم تا دیگران قادر به تغییر محتوای یک پست نباشند.
+
+فایل `blog/templates/blog/post_detail.html` را باز کنید و خط زیر را پیدا کنید:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+آن را به شکل زیر تغییر دهید:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+از آنجا که احتمالاً هنوز به عنوان ادمین در سیستم لاگین کرده‌اید، اگر صفحه را دوباره بازخوانی کنید، تغییر خاصی را نمی‌بینید. صفحه را در یک مرورگر دیگر یا یک پنجره ناشناس incognito window (در Windows Edge به آن "InPrivate" می‌گویند) بارگذاری کنید. خواهید دید که لینک و آیکون اصلاح پست، نمایش داده نمی‌شود!
+
+## یک چیز دیگر: زمان دیپلوی است!
+
+بیایید ببینیم آیا همه این تغییرات در PythonAnywhere کار می‌کند. وقت یک دیپلوی کردن دیگر است!
+
+* ابتدا کد جدید را کامیت کنید و آن را به GitHub بفرستید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* سپس در کنسول [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/) تایپ کنید:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(یادتان باشد که `<your-pythonanywhere-domain>` را با زیر دامنه اصلی خود در PythonAnywhere عوض کنید البته بدون آکولادها.)
+
+* در نهایت به صفحه ["Web" page](https://www.pythonanywhere.com/web_app_setup/) بروید (از کلید منو در بالا و سمت راست کنسول استفاده کنید) و کلید **Reload** را بزنید. آدرس وبلاگ خودتان https://subdomain.pythonanywhere.com را باز کنید تا تغییرات را ببینید.
+
+به نتیجه رسید! تبریک! :)
\ No newline at end of file
diff --git a/fa-IR/django_installation/README.md b/fa-IR/django_installation/README.md
new file mode 100644
index 00000000000..dc3cccdfa7d
--- /dev/null
+++ b/fa-IR/django_installation/README.md
@@ -0,0 +1,7 @@
+# نصب و راه اندازی جنگو
+
+> **نکته** اگر از Chromebook استفاده می‌کنید، این فصل را رد کنید و مطمئن شوید که دستورالعمل [ تنظیمات Chromebook](../chromebook_setup/README.md) را دنبال کنید.
+> 
+> **نکته** اگر مراحل [نصب و راه‌اندازی](../installation/README.md) را انجام داده‌اید یعنی این بخش انجام شده است، می‌توانید مستقیم به بخش بعد بروید!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/fa-IR/django_installation/instructions.md b/fa-IR/django_installation/instructions.md
new file mode 100644
index 00000000000..b15dae2cd65
--- /dev/null
+++ b/fa-IR/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> قسمت‌هایی از این بخش بر اساس دوره آموزشی Geek Girls Carrots است (https://github.com/ggcarrots/django-carrots).
+> 
+> قسمتهایی نیز بر پايه دوره آموزشی [django-marcador tutorial](http://django-marcador.keimlink.de/) و با مجوز Creative Commons Attribution-ShareAlike 4.0 International License است. حقوق دوره آموزشی django-marcador متعلق به Markus Zapke-Gründemann و همکاران می‌باشد.
+
+## محیط مجازی
+
+قبل از اینکه ما جنگو را نصب کنیم، ابزاری بسیار پراستفاده به شما می‌دهیم تا با نصب آن محیط برنامه نویسی خود را بر روی کامپیوترتان تمیز و مرتب نگه دارید. می‌توانید برای ادامه کار از این مرحله صرف نظر کنید اما استفاده از آن بسیار توصیه می‌شود. شروع کار با تنظیمات مناسب جلوی بسیاری از مشکلات در آینده را می‌گیرد!
+
+بنابراین، اجازه دهید یک ** محیط مجازی ** یا virtual environment بسازیم (همچنین به آن * virtualenv* هم گفته می‌شود). محیط مجازی، تنظیمات پایتون/جنگو را برای هر پروژه و جدا از دیگر پروژه‌ها، قرنطینه و حفظ خواهد کرد. یعنی هر تغییری که در تنظیمات یک وبسایت انجام می‌دهید، بر روی دیگر وبسایت‌هایی که در حال توسعه آن‌ها هستید تاثیر نخواهد گذاشت. تمیز و مرتب، اینطور نیست؟
+
+آنچه شما باید انجام دهید این است که یک پوشه را پیدا کنید که در آن می‌خواهید ` محیط مجازی` را ایجاد کنید. برای مثال، پوشه home. در ویندوز، چیزی شبیه `C:\Users\Name` است (که در آن `Name` نام کاربری شما است که با آن وارد ویندوز شده‌اید).
+
+> **نکته: ** در ویندوز اطمینان حاصل کنید که نام این پوشه حاوی کاراکترهای خاص یا دارای اعراب نیست؛ اگر نام کاربری شما دارای کاراکترهای خاص است، از یک پوشه دیگر استفاده کنید، به عنوان مثال `C:\djangogirls`.
+
+برای این آموزش ما از یک پوشه جدید `djangogirls` در پوشه اصلی شما استفاده خواهیم کرد:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+ما یک محیط مجازی به نام `myvenv` خواهیم ساخت. فرمان کلی در این قالب خواهد بود:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+برای ایجاد یک `محیط مجازی` جدید، باید کنسول خط فرمان را باز کنید و دستور <`python -m venv myvenv` را اجرا کنید. شبیه این خواهد شد:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+در اینجا `myvenv` نام `محیط مجازی` شماست. می‌توانید هر نام دیگری انتخاب کنید اما از حروف کوچک استفاده کنید و از اسپیس، اعراب گذاری و کاراکترهای خاص استفاده نکنید. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+می‌توانیم با دستور `python3 -m venv myvenv` هم در لینوکس و هم در OS X `محیط مجازی` بسازیم. شبیه این خواهد بود:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+نام `محیط مجازی` شما، `myvenv` است. می‌توانید هر نام دیگری انتخاب کنید اما از حروف کوچک استفاده کنید و از اسپیس استفاده نکنید. همچنین بهتر است اسم کوتاهی انتخاب کنید چون بعدتر ارجاعات زیادی به آن خواهید داشت!
+
+> **نکته: ** در بعضی نسخه‌های دبیان/اوبونتو ممکن است چنین پیغام خطایی دریافت کنید:
+> 
+> {% filename %}خط فرمان{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> در این موارد دستورالعمل داده شده در بالا را دنبال کنید. پکیج `python3-venv` را نصب کنید: {% filename %}خط فرمان{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **نکته: ** در بعضی نسخه‌های دبیان/اوبونتو ساختن محیط مجازی با این دستور ممکن است باعث چنین خطایی بشود:
+> 
+> {% filename %}خط فرمان{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> برای حل این مشکل، از دستور `virtualenv` استفاده کنید.
+> 
+> {% filename %}خط فرمان{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **نکته: ** اگر چنین خطایی گرفتید
+> 
+> {% filename %}خط فرمان{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> در عوض از این دستور استفاده کنید:
+> 
+> {% filename %}خط فرمان{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## کار کردن با محیط مجازی
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+محیط مجازی خود را با اجرای دستور زیر فعال کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. در این شرایط یک بار دیگر Windows PowerShell را با گزینه "Run as Administrator" اجرا کنید. سپس دستورات زیر را قبل از فعال کردن محیط مجازی خود، اجرا کنید:
+> 
+> {% filename %}خط فرمان{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> مزیت آن این است که لازم نیست بین پنجره ویرایشگر کد و پنجره خط فرمان جابجا شوید
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+محیط مجازی خود را با اجرای دستور زیر فعال کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+به یاد داشته باشید که `myvenv` را با نامی که برای `محیط مجازی` خود انتخاب کرده‌اید عوض کنید!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}خط فرمان{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+هنگامی که پیشوند `(myvenv)` در کنسول خط فرمان اضافه شود به معنی آن است که `محیط مجازی` شما فعال شده است.
+
+وقتی درون یک محیط مجازی کار می‌کنید کلمه `python` به صورت اتوماتیک به نسخه صحیح پایتون ارجاع می‌دهد در نتیجه می‌توانید به جای `python3` از `python` استفاده کنید.
+
+بسیار خوب، ما همه نیازمندی‌ها را داریم حالا می‌توانیم جنگو را نصب کنیم!
+
+## نصب جنگو {#django}
+
+حالا که `محیط مجازی` شما فعال شده است می‌توانید جنگو را نصب کنید.
+
+قبل از آن باید مطمئن شویم که آخرین نسخه `pip` که برای نصب جنگو استفاده می‌شود را داریم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### نصب پکیج‌ها و پیش‌نیازهایشان
+
+یک فایل پیش‌نیازها شامل لیستی از پکیج‌های وابسته است که باید به کمک `pip install` نصب شوند:
+
+در ابتدا یک فایل `requirements.txt` در پوشه `djangogirls/` بسازید. معمولاً می‌توانید از خود ویرایشگر کد که قبل‌تر نصب کرده‌اید هم برای ساختن فایل جدید استفاده کنید. یک فایل جدید در ویرایشگر کد بسازید و سپس به نام `requirements.txt`در پوشه `djangogirls/` ذخیره‌اش کنید. پوشه شما شبیه این خواهد بود:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+در فایل `djangogirls/requirements.txt` باید خط زیر را اضافه کنید:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+حالا دستور `pip install -r requirements.txt` را اجرا کنید تا جنگو نصب شود.
+
+{% filename %}خط فرمان{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). اگر چنین است لطفاً از مسیری استفاده کنید که در آن اسپیس به کار نرفته باشد (مثلا چنین مسیری `C:\djangogirls`). یک محیط مجازی در پوشه جدید درست کنید سپس محیط مجازی قبلی را پاک کنید و دستور بالا را دوباره اجرا کنید. (جابجا کردن پوشه مربوط به محیط مجازی ایده خوبی نیست و باعث می‌شود محیط مجازی کار نکند. محیط مجازی با آدرس مطلق کار می‌کند)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}خط فرمان{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> اگر هنگام اجرای دستور pip بر روی اوبونتو نسخه 12.04 پیغام خطا گرفتید از دستور `python -m pip install -U --force-reinstall pip` برای اصلاح پکیج pip در محیط مجازی استفاده کنید.
+
+<!--endsec-->
+
+عالی! بالاخره در نهایت آماده شدید تا یک برنامه جنگو بسازید!
\ No newline at end of file
diff --git a/fa-IR/django_models/README.md b/fa-IR/django_models/README.md
new file mode 100644
index 00000000000..34822e580fd
--- /dev/null
+++ b/fa-IR/django_models/README.md
@@ -0,0 +1,202 @@
+# مدل در جنگو
+
+آنچه الان می‌خواهیم بسازیم چیزی است که تمام پست‌های ما در وبلاگ را ذخیره می‌کند. اما برای اینکه بتوانیم این کار را بکنیم باید کمی در مورد مفهوم `شیء` صحبت کنیم.
+
+## اشیاء
+
+مفهومی در برنامه نویسی وجود دارد که به آن `برنامه‌نویسی شیء‌گرا` گفته می‌شود. به این معنی که به جای آنکه همه چیز را در ردیف‌هایی طولانی از دستورات بنویسیم می‌توانیم مدل هایی درست کنیم و تعریف کنیم که این مدل ها چگونه با هم ارتباط داشته باشند.
+
+یک شیء چیست؟ یک شیء مجموعه‌ای از خصوصیات و اعمال است. ممکن است کمی عجیب باشد اما برای شما مثالی خواهیم زد.
+
+اگر بخواهیم مدلی برای یک گربه بسازیم یک شیء به نام `Cat` میسازیم که دارای خصوصیاتی است مانند `رنگ`، `سن`، `حالت` (مثلاً خوب، بد یا خواب‌آلود) و `مالک` (که می‌تواند اشاره به یک شیء `Person` یا در در مورد گربه‌های ولگرد، بدون اشاره به فردی خاص، خالی بماند).
+
+یک شیء از نوع `Cat` دارای فعالیتی‌هایی مانند: `خُرخُر کردن`، `خراشیدن` و یا `غذا خوردن` است. (برخی مواقع به گربه، `غذای گربه` می‌‌دهیم که می‌تواند یک شیء جداگانه باشد که خصوصیت `مزه` داشته باشد).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+بنابراین ایده اصلی آن است که چیزهای واقعی در کدها با خصوصیات (که به آن `object properties` می‌گوییم) و اعمال (که به آن `methods` می‌گوییم) تعریف شوند.
+
+ما می‌خواهیم یک وبلاگ درست کنیم، درست است؟ چگونه یک مدل برای پست‌های وبلاگی بسازیم؟
+
+باید به این سوال پاسخ دهیم که: یک پست وبلاگی چیست؟ چه خصوصیاتی دارد؟
+
+خب، پست وبلاگی ما قطعاً به مقداری متن و یک عنوان نیاز دارد، درست است؟ بسیار خوب خواهد بود که بدانیم چه کسی مطلب را نوشته است، پس به نویسنده هم احتیاج داریم. سرانجام می‌خواهیم بدانیم که این مطلب در چه تاریخی نوشته و منتشر شده است.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+چه کارهایی با یک پست وبلاگی می‌توان انجام داد؟ بسیار جالب خواهد بود که `متدهایی` داشته باشیم که بتواند یک پست را منتشر کند. چطور است؟
+
+بنابراین به یک متد انتشار یا `publish` نیاز داریم.
+
+حالا که می‌دانیم دقیقاً به چه چیزی احتیاج داریم بیایید مدل سازی در جنگو را شروع کنیم!
+
+## مدل در جنگو
+
+حالا که می‌دانیم شیء چیست، می‌توانیم یک مدل جنگویی برای پست‌های وبلاگ‌مان بسازیم.
+
+یک مدل در جنگو نوعی شیء ویژه است که در `پایگاه داده` یا database ذخیره می‌شود. یک پایگاه داده مجموعه‌ای از اطلاعات است. جایی است که در آن اطلاعات مربوط به کاربرها، پست‌های وبلاگی و غیره را نگهداری می‌کنیم. ما از پایگاه داده SQLite برای ذخیره اطلاعات استفاده می‌کنیم. این پایگاه داده، پایگاه داده پیشفرض در جنگو است و الان برای ما کافی است.
+
+شما می‌توانید یک مدل را در پایگاه داده، چیزی شبیه به یک صفحه گسترده با ستون‌ها (فیلدها) و ردیف‌ها(داده‌ها) تصور کنید.
+
+### ساختن یک اپلیکیشن
+
+برای آنکه همه چیز مرتب باشد ما یک برنامه مجزا (اپلیکیشن) در پروژه خود خواهیم ساخت. خوب است که همه چیز از ابتدا مرتب باشد. برای ساخت یک برنامه جدید باید دستور زیر را در خط فرمان اجرا کنیم (در پوشه `djangogirls` و جایی که فایل `manage.py` وجود دارد):
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+خواهید دید که یک پوشه جدید به نام `blog` ساخته شده و شامل تعدادی فایل است. پوشه‌ها و فایل‌ها در پروژه ما باید شبیه به این باشد:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+بعد از ساختن این برنامه، باید به جنگو بگوییم تا از آن استفاده کند. این کار را در فایل `mysite/settings.py` انجام می‌دهیم -- این فایل را در ویرایشگر کد باز کنید. باید `INSTALLED_APPS` را پیدا کنیم و دقیقاً بالای علامت `[` در انتهای این بخش، خطی شامل `'blog.apps.BlogConfig',` را اضافه کنیم. پس در نهایت شبیه این خواهد بود:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### ساختن مدل برای پست وبلاگ
+
+در فایل `blog/models.py` ما تمام اشیائی را که به آن `مدل Model` می‌گوییم تعریف می‌کنیم. اینجا فضایی است که پست‌های وبلاگی را تعریف می‌کنیم.
+
+فایل `blog/models.py` را در ویرایشگر کد باز کنید، تمام محتویات آن را پاک کنید و کد‌های زیر را در آن بنویسید:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User', on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> مطمئن بشوید که در هر طرف `str` دوبار از کاراکتر `_` استفاده کنید. از این قرارداد زیاد در پایتون استفاده می‌شود که به آن "dunder" هم می‌گویند که مخفف "double-underscore" است.
+
+عجیب به نظر می‌رسد؟ نگران نباشید ما درباره عملکرد این خط ها توضیح خواهیم داد!
+
+تمام خطوطی که با `from` یا `import` شروع می‌شوند خطوطی هستند که محتوایی را از یک فایل دیگر به این فایل اضافه می‌کنند. پس به جای آنکه یک محتوای یکسان را در هر فایل تکرار کنیم، می‌توانیم از این الگو استفاده کنیم `from ... import ... `.
+
+`class Post(models.Model):` – این خط مدل ما را تعریف می‌کند (که یک `شیء` یا object است).
+
+- `class` کلید واژه‌ای است که نشان می‌دهد در حال تعریف کردن یک شیء هستیم.
+- `Post` نام مدل ما است. می‌توانیم به آن نام متفاوتی بدهیم (اما نباید از کاراکترهای خاص و اسپیس استفاده کنیم). همیشه نام یک کلاس را با حروف بزرگ شروع کنید.
+- `models.Model` به این معنی است که Post یک مدل جنگویی است، بنابراین جنگو می‌داند که این مدل باید در پایگاه داده ذخیره شود.
+
+حالا ویژگی‌هایی که در مورد آن‌ها صحبت کردیم را اضافه می‌کنیم: `title`، `text`، `created_date`، `published_date` و `author`. برای این کار باید ویژگی‌های هرکدام از این‌ها را مشخص کنیم (آیا متن است؟ یا عدد؟ یا تاریخ؟ یا ارتباطی با یک شیء دیگر دارد، مثلا کاربر؟)
+
+- `models.CharField` – این عبارت مشخص می‌کند که ویژگی مورد نظر از جنس متن با تعداد کاراکتر محدود است.
+- `models.TextField` – این عبارت برای اختصاص دادن متن با تعداد کاراکتر نامحدود است. به نظر برای متن پست‌های وبلاگی مناسب است، درست است؟
+- `models.DateTimeField` – مشخص کننده تاریخ و زمان است.
+- `models.ForeignKey` – نشان دهنده ارتباط به یک مدل دیگر است.
+
+ما همه قطعات کد را توضیح نخواهیم داد برای آنکه زمان بسیار زیادی می‌گیرد. اگر بخواهید اطلاعات بیشتری در مورد فیلدهای یک مدل‌ و انواع آن بدانید باید نگاهی به مستندات جنگو بیندازید (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+منظور از `def publish(self):` چیست؟ این دقیقاً متد یا عملیات `publish` (انتشار یک پست وبلاگی) است که قبل‌تر در مورد آن صحبت کردیم. عبارت `def` نشان دهنده آن است که یک تابع یا متد تعریف شده‌ است و `publish` نام این تابع است. شما می‌توانید نام این تابع را به دلخواه عوض کنید. برای نامگذاری متدها، معمولاً از حروف کوچک و خط زیرین (underscore) به جای کاراکتر فاصله (space) استفاده می‌کنیم. برای مثال، تابعی که برای محاسبه قیمت متوسط لازم داریم به این صورت نامگذاری می‌شود `calculate_average_price`.
+
+توابع معمولاً یک مقدار را باز می‌گردانند که با `return` تعریف می‌شود. نمونه‌ای از این بازگرداندن در تابع `__str__` وجود دارد. در این سناریو وقتی ما تابع `__str__()` را فراخوانی می‌کنیم یک نوشته (با فرمت **string**) که حاوی عنوان پست وبلاگی است دریافت می‌کنیم.
+
+همچنین توجه داشته باشید که هر دو تابع `def publish(self):` و `def __str__(self):` به کمک فاصله‌گذاری ابتدای خط، درون کلاس تعریف شده‌اند. چون پایتون به فاصله‌ها حساس است نیاز داریم که میزان فاصله ابتدا خط برای متدها درست تعریف شوند تا متد، درون کلاس قرار داشته باشد. در غیر اینصورت متدها عضوی از کلاس نخواهند بود، و ممکن است رفتار غیرمنتظره‌ای ببینید.
+
+اگر هنوز چیزی در مورد مدل‌ها برای شما مبهم است حتماً از مربی خود بپرسید! می‌دانیم که یادگرفتن مفاهیم اشیاء و توابع به طور همزمان، پیچیده است. ولی حداقل الان کمی برای شما واضح‌تر شده است!
+
+### ساختن جدول برای مدل‌ها در پایگاه داده‌ها
+
+آخرین مرحله این است که مدل جدیدی که ساخته‌ایم را به پایگاه داده اضافه کنیم. ابتدا باید جنگو را از تغییراتی که در مدل‌ها ایجاد کرده‌ایم آگاه کنیم. (این تغییرات همین کارهایی است که انجام داده‌ایم!) به کنسول خط فرمان بروید و تایپ کنید `python manage.py makemigrations blog`. چیزی شبیه این خواهید دید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**نکته: **به یاد داشته باشید که فایل‌هایی که تغییر داده‌اید را ذخیره کنید وگرنه ممکن است کامپیوتر نسخه قبلی فایل را در نظر بگیرد و پیغام خطا نشان بدهد.
+
+جنگو یک فایل مهاجرت یا migration برای ما درست می‌کند که ما باید آن را به پایگاه داده ارسال کنیم. عبارت `python manage.py migrate blog` را اجرا کنید و خروجی باید شبیه به این باشد:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+هورا! مدل Post ما اکنون در پایگاه داده قرار گرفته است! جالب خواهد بود که نگاهی به آن بیندازیم! پس به سراغ بخش بعدی بروید تا ببینید Post ها به چه صورتی درآمده‌اند!
\ No newline at end of file
diff --git a/fa-IR/django_orm/README.md b/fa-IR/django_orm/README.md
new file mode 100644
index 00000000000..653a5e0371f
--- /dev/null
+++ b/fa-IR/django_orm/README.md
@@ -0,0 +1,221 @@
+# ORM و QuerySets در جنگو
+
+در این فصل شما نحوه اتصال جنگو به پایگاه داده و روش ذخیره اطلاعات در آن را یاد خواهید گرفت. بگذارید شروع کنیم!
+
+## QuerySet چیست؟
+
+به صورت خلاصه، کوئری‌ست لیستی از تعدادی شیء مربوط به یک مدل خاص است. کوئری‌ست به شما این امکان را می‌دهد که داده‌ها را از پایگاه داده بخوانید، فیلتر کنید یا آن‌ها را مرتب کنید.
+
+ساده‌ترین راه فهمیدن آن، مثال است. پس شروع می‌کنیم.آماده‌اید؟
+
+## کنسول خط فرمان جنگو
+
+کنسول‌های لوکال خود را باز کرده (نه در PythonAnywhere) و این دستور را تایپ کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+    
+
+باید پاسخی مانند زیر دریافت کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+شما در حال حاضر در کنسول تعاملی جنگو هستید. این محل کاملاً شبیه به محیط تعاملی پایتون می‌باشد با این تفاوت که چند ویژگی جادویی جنگو را در بر دارد. :) شما می‌توانید تمامی دستورات پایتون را در اینجا استفاده کنید.
+
+### تمام اشیاء
+
+در ابتدا تمامی پست ها را نمایش می دهیم. با دستور زیر می توان این کار را انجام داد:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+اوه اوه! به خطا خوردیم. این خطا به این معنی است که هیچ پستی وجود ندارد. درست است! فراموش کردیم که پست ها را import کنیم!
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+مدل `Post` را از `blog.models` فراخوانی می‌کنیم. حالا دوباره تمامی پست‌ها را نمایش می‌دهیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+لیستی از پست‌هایی که قبلا ایجاد کرده بودیم درست شد! ما این پست‌ها را با استفاده از صفحه مدیریت جنگو ایجاد کرده‌بودیم. اما حالا می‌خواهیم پست جدیدی با استفاده از پایتون درست کنیم. چطور این کار را انجام می‌دهیم؟
+
+### ساختن شیء
+
+به صورت زیر می‌توان یک شیء جدید از نوع Post در پایگاه داده ایجاد کرد:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+اما ما در اینجا یک عنصر گم شده داریم: `نویسنده`. نیاز هست که یک نمونه از مدل `User` را به عنوان نویسنده برای ساخت شیء جدید تعریف کنیم. نحوه انجام کار به صورت زیر می باشد.
+
+بیایید اول مدل User را فراخوانی کنیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+چه کاربرانی در پایگاه داده داریم؟ این را امتحان کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+این همان کاربر اصلی یا superuser است که کمی قبل‌تر ساخته‌ایم! حالا بیایید نمونه ای از روی کاربر اصلی بسازیم (این خط را مطابق نام کاربر اصلی که قبلاً وارد کرده‌اید تغییر دهید):
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+همان طور که می‌بینید ما یک `کاربر` را به کمک دستور `get` و با ارجاع دادن مقدار 'ola' به متغیر `username` فراخوانی کردیم. خیلی دقیق!
+
+الان ما می‌توانیم پست خود را ایجاد کنیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+هورا! می‌خواهید امتحان کنیم که آیا درست کار می‌کند؟
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+بنابراین یک پست دیگر در لیست خواهیم داشت!
+
+### اضافه کردن پست های بیشتر
+
+حالا برای تفریح هم که شده می‌توانید پست‌های بیشتری بسازید تا با نحوه کارکرد آن بهتر آشنا شوید. دو یا سه پست دیگربسازید و سپس به مرحله بعد بروید.
+
+### فیلتر کردن اشیاء
+
+بخش مهمی از QuerySet، توانایی فیلتر کردن آن است. در اینجا می‌خواهیم تمام پست‌هایی که کاربر ola ساخته است را پیدا کنیم. در اینجا از عبارت `filter` به جای `all` در `Post.objects.all()` استفاده می‌کنیم. در پرانتز ما شرطی (شرایطی) که لازم است وجود داشته باشد تا شیء مورد نظر به QuerySet اضافه شود را بیان می‌کنیم. در اینجا، شرط ما این است که `author` برابر با `me` باشد. نحوه نوشتن آن در جنگو به این صورت است `author=me`. الان یک کد به صورت زیر داریم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+یا شاید ما بخواهیم تمام پست‌هایی که در فیلد `title` کلمه 'title' را داشته باشند پیدا کنیم؟
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **نکته** دقت کنید که ۲تا کاراکتر underscore ( `ـ`) در میان `title` و `contains` وجود دارد. ORM جنگو از این قانون استفاده می‌کند تا عملیات یا فیلتر مورد نظر را ("contains") از نام فیلد ("title") جدا کند. اگر فقط از یک underscore استفاده کنید خطایی مانند این دریافت خواهید کرد "FieldError: Cannot resolve keyword title_contains".
+
+همچنین می‌توانید لیستی از تمام پست‌های منتشر شده دریافت کنید. ما این کار را با فیلتر کردن همه پست‌هایی که برای آن‌ها `published_date` تعیین کرده بودیم انجام می‌دهیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+متاسفانه پست هایی که از طریق کنسول پایتون اضافه کرده‌ایم هنوز منتشر نشده‌اند. اما می‌توانیم این وضعیت را تغییر دهیم! ابتدا یک نسخه از پست‌هایی که می‌خواهیم منتشر کنیم تهیه می‌کنیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+و حالا با متد `publish` آن را منتشر می کنیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+الان دوباره سعی کنید لیستی از پست‌های منتشر شده را نمایش دهید (دکمه جهت بالا در کیبورد را ۳ بار زده و `enter` کنید):
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### مرتب‌سازی اشیاء (Ordering objects)
+
+QuerySet ها همچنین به شما اجازه می‌دهند لیستی از اشیاء را مرتب کنید. بیایید آن‌ها را بر اساس `created_date`، مرتب کنیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+همچنین با اضافه کردن `-` در ابتدای دستور می‌توانیم اشیاء را به صورت معکوس مرتب کنیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### کوئری‌های پیچیده از طریق زنجیره توابع
+
+همانطور که دیدید برخی از توابع در `Post.objects`، یک کوئری ست باز می‌گردانند. همان تابع می‌تواند مجدداً بر روی یک کوئری ست اعمال شود و کوئری ست دیگری برگرداند. بنابراین، شما می‌توانید تاثیر آن‌ها را به صورت **زنجیره‌ای** با هم ترکیب کنید:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+این روش واقعاً قدرتمند است و به شما اجازه می‌دهد کوئری‌های پیچیده‌ای بسازید.
+
+موفق شدیم! شما الان برای قسمت بعدی آماده هستید. برای بستن پوسته (shell) دستور زیر را تایپ کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> exit()
+```
\ No newline at end of file
diff --git a/fa-IR/django_start_project/README.md b/fa-IR/django_start_project/README.md
new file mode 100644
index 00000000000..4d1846b5290
--- /dev/null
+++ b/fa-IR/django_start_project/README.md
@@ -0,0 +1,260 @@
+# اولین پروژه جنگو شما!
+
+> قسمت‌هایی از این بخش بر اساس دوره آموزشی Geek Girls Carrots بنا شده است (https://github.com/ggcarrots/django-carrots).
+> 
+> قسمت‌هایی هم بر اساس دوره آموزشی [django-marcador tutorial](http://django-marcador.keimlink.de/) تحت مجوز بین المللی Creative Commons Attribution-ShareAlike 4.0 تهیه شده است. امتیاز دوره آموزشی django-marcador متعلق به Markus Zapke-Gründemann و همکاران است.
+
+قصد داریم یک وبلاگ کوچک بسازیم!
+
+در قدم اول یک پروژه جدید جنگو میسازیم. در واقع ساختن یک پروژه جنگو شامل اجرا کردن دستوراتی است که توسط جنگو آماده شده و با اجرای آن، بدنه اصلی پروژه ساخته می‌شود. این بدنه، شامل تعدادی پوشه و فایل است که ما بعداً از آن ها استفاده خواهیم کرد.
+
+نام برخی از این فایل‌ها و پوشه‌ها برای جنگو بسیار مهم است. شما نباید نام فایل‌‌هایی که الان می‌خواهیم بسازیم را تغییر دهید. همچنین تغییر پوشه‌های آنها هم ایده خوبی نیست. جنگو باید در یک ساختار مشخص مورد استفاده قرار گیرد تا بتواند موارد مهم را پیدا کند.
+
+> به یاد داشته باشید که همه دستورات را در محیط مجازی (virtualenv) اجرا کنید. اگر پیشوند `(myvenv)` را در کنسول خط فرمان نمی‌بینید، باید محیط مجازی را فعال کنید. فعال کردن محیط مجازی را در قسمت **کارکردن با محیط مجازی** از بخش **نصب جنگو** توضیح داده‌ایم. در ویندوز با تایپ `myvenv\Scripts\activate` و در لینوکس یا مک با نوشتن `source myvenv/bin/activate` می‌توانید محیط مجازی را فعال کنید.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+در کنسول لینوکس یا مک باید دستورات زیر را اجرا کنید. **فراموش نکنید که `علامت نقطه` را در آخر عبارت بگذارید!**
+
+{% filename %}خط فرمان{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> علامت `.` مهم است برای اینکه به سیستم می‌گوید که جنگو را در همین پوشه جاری نصب کند (علامت `.` به پوشه ای که در حال حاضر در آن هستیم اشاره میکند).
+> 
+> **نکته** وقتی دستور بالا را می‌نویسید به یاد داشته باشید که فقط بخشی را می‌نویسید که با `django-admin` شروع می‌شود. بخش `(myvenv) ~/djangogirls$` نشان می‌دهد که شما باید دستورات ورودی را در مقابل آن بنویسید.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+در ویندوز باید دستور زیر را اجرا کنید. **(فراموش نکنید که `علامت نقطه` را در انتها بگذارید)**:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> علامت `.` مهم است برای اینکه به سیستم می‌گوید که جنگو را در همین پوشه جاری نصب کند (علامت `.` به پوشه ای که در حال حاضر در آن هستیم اشاره میکند).
+> 
+> **نکته** وقتی دستور بالا را می‌نویسید به یاد داشته باشید که فقط بخشی را می‌نویسید که با `django-admin.exe` شروع می‌شود. بخش `(myvenv) C:\Users\Name\djangogirls>` نشان می‌دهد که شما باید دستورات ورودی را در مقابل آن بنویسید.
+
+<!--endsec-->
+
+`django-admin.py` دستوری است که پوشه‌ها و فایل‌ها را برای شما می‌سازد. الان باید ساختار پوشه‌ها و فایل‌های شما شبیه به این باشد:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **نکته**: در ساختار پوشه‌ها، شما پوشه `venv` را هم که قبلاً ساخته ایم خواهید دید.
+
+`manage.py` دستوری است که به مدیریت سایت کمک می‌کند. به کمک این دستور (و برخی چیزهای دیگر) و بدون نصب نرم افزارهای دیگر می‌توانیم یک وب سرور بر روی کامپیوتر خود راه اندازی کنیم.
+
+فایل `settings.py` حاوی تنظیمات وبسایت شما است.
+
+یادتان می‌آید در مورد حامل نامه و این موضوع که: کجا را باید نگاه کند تا بتواند نامه را به مقصد برساند‌، صحبت کردیم؟ فایل `urls.py` شامل الگوهایی است که توسط `urlresolver` استفاده می‌شوند.
+
+اجازه بدهید الان از سایر فایل‌ها چشم‌پوشی کنیم چون آن‌ها را تغییر نخواهیم داد. تنها چیزی که باید مواظب آن باشید این است که آن‌ها را اشتباهی پاک نکنید!
+
+## تغییر تنظیمات
+
+می‌خواهیم کمی تغییرات در فایل `mysite/settings.py` ایجاد کنیم. این فایل را در ویرایشگر کد، که پیش از این نصب کرده اید باز کنید.
+
+**نکته**: به یاد داشته باشید که فایل `settings.py`، یک فایل معمولی مانند بقیه فایل‌ها است. شما می‌توانید این فایل را به کمک ویرایشگر کد با استفاده از منو "file -> open"، باز کنید. از این طریق یک پنجره معمولی باز می‌شود که می‌توانید به کمک آن فایل `settings.py` را پیدا کنید و آن را انتخاب کنید. به جای این کار، می‌توانید در بین پوشه‌ها، پوشه djangogirls را پیدا کنید بر روی آن راست کلیک کنید. سپس نام ویرایشگر کد خود را از لیست به نمایش درآمده انتخاب کنید. انتخاب ویرایشگر مهم است چرا که ممکن است نرم افزارهای دیگر هم فایل را باز کنند ولی اجازه ویرایش کردن به شما ندهند.
+
+خیلی خوب خواهد بود که زمان درست را در وبسایت خود داشته باشیم. به [لیست منطقه های زمانی ویکیپدیا](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) بروید و محدوده زمانی مناسب را برای خود انتخاب کنید (TZ) (مثلاً `Asia/Tehran`).
+
+در فایل `settings.py` خطی را که حاوی `TIME_ZONE` است پیدا کنید و آن را اصلاح کنید تا منطقه زمانی شما را نشان دهد. مثلاً:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Asia/Tehran'
+```
+
+یک شناسه زبان شامل دو بخش است یکی زبان، مثلاً `en` برای انگلیسی و `fa` برای فارسی، و دیگری کد کشور، مثلاً `de` برای آلمان و `ir` برای ایران. اگر انگلیسی زبان اصلی شما نیست می‌توانید این شناسه را تغییر دهید تا پیغام‌های جنگو به زبان خودتان برای شما نمایش داده شود. بنابراین شما ترجمه دکمه "Cancel" را به زبانی که در اینجا معرفی کرده اید خواهید دید. [جنگو به زبان‌های زیادی ترجمه شده و قابل استفاده است](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+اگر زبان دیگری را می‌خواهید شناسه زبان را در خط زیر تغییر دهید:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+علاوه بر این نیاز داریم تا آدرس فایل‌های ثابت یا ایستا را نیز اضافه کنیم. (بعداً به طور کامل در این دوره آموزشی به فایل‌های ثابت و CSS خواهیم پرداخت.) به *انتهای* فایل بروید و دقیقاً زیر ورودی `STATIC_URL`، یک خط جدید با عنوان `STATIC_ROOT` اضافه کنید:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+وقتی در این فایل `DEBUG` برابر با `True`باشد و `ALLOWED_HOSTS` خالی باشد، مقادیر هاست `['localhost', '127.0.0.1', '[::1]']` خواهد بود. این هاست در هنگام انتشار وبسایت روی اینترنت، با هاست PythonAnywhere هماهنگ نخواهد بود پس تنظیمات را به این شکل تغییر می‌دهیم:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **نکته**: اگر از کروم بوک استفاده می‌کنید، این خط را هم به انتهای فایل settings.py اضافه کنید: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> اگر از cloud9 استفاده می‌کنید `.amazonaws.com` را به `ALLOWED_HOSTS` اضافه کنید
+> 
+> اگر شما پروژه خود را بر روی `Glitch.com` میزبانی می‌کنید، اجازه دهید که از کلید مخفی جنگو یا Djanog secret key پروژه شما که باید محرمانه بماند محافظت کنیم (در غیر اینصورت هر کس که پروژه شما را بررسی کند آن را خواهد دید):
+> 
+> - در ابتدا، یک کلید مخفی شانسی می‌سازیم. ترمینال Glitch را دوباره باز کنید و دستورات زیر را تایپ کنید:
+>     
+>     {% filename %}خط فرمان{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     این کار باعث خواهد شد که یک رشته اتفاقی از کاراکترها و حروف ساخته شود، چیزی که به عنوان یک کلید مخفی برای پروژه جنگو شما کاملاً مناسب است. ما این کلید را در فایل `.env` در Glitch اضافه می‌کنیم، این فایل درصورتی توسط Glitch به ما نشان داده می‌شود که ما صاحب پروژه باشیم.
+> 
+> - فایلی به نام `.env` در پوشه اصلی پروژه بسازید و کدهای زیر را در آن قرار دهید:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - سپس فایل settings پروژه جنگو را با تغییرات زیر به روز رسانی کنید تا کلید مخفی به آن اضافه شود:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - کمی پایین‌تر در همان فایل، نام وبسایت جدید Glitch شما را اضافه می‌کنیم:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     مقدار `PROJECT_DOMAIN` به صورت اتوماتیک توسط Glitch ایجاد می‌شود. این مقدار وابسته به نام پروژه شماست.
+
+## راه اندازی یک پایگاه داده
+
+تعداد بسیار زیادی پایگاه داده وجود دارد که می‌تواند داده های وبسایت شما را ذخیره کند. ما از پایگاه داده پیشفرض `sqlite3` استفاده می‌کنیم.
+
+این پایگاه داده از قبل در این بخش از فایل `mysite/settings.py` تعریف شده است:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+برای ساختن یک پایگاه داده برای وبسایتمان، دستور زیر را در کنسول خط فرمان اجرا می‌کنیم: `python manage.py migrate` (هنگام اجرای این دستور باید در پوشه `djangogirls` باشیم جایی که فایل `manage.py` قرار دارد). اگر همه چیز خوب پیش برود باید چیزی شبیه به این را ببینیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+تمام شد! وقت آن است که وب سرور را اجرا کنیم و ببینیم آیا وبسایت ما کار می‌کند!
+
+## فعال کردن وب سرور
+
+شما باید در پوشه‌ای باشید که فایل `manage.py` در آن قرار دارد. (در پوشه `djangogirls`). در کنسول خط فرمان، وب سرور را به کمک این دستور فعال می‌کنیم `python manage.py runserver`:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+اگر در Chromebook کار می‌کنید از این دستور استفاده کنید:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+یا اگر از Glitch استفاده می‌کنید به کمک دستور زیر:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+اگر در ویندوز کار می‌کنید و با خطای `UnicodeDecodeError` مواجه شدید، از دستور زیر استفاده کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+حالا زمان آن است که چک کنید وبسایت کار می‌کند یا نه. مرورگر خود را باز کنید (فایرفاکس، کروم، سافاری، اینترنت اکسپلورر یا هر چیز دیگر) و آدرس زیر را وارد کنید:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+اگر از Chromebook و Cloud9 استفاده می‌کنید، در پنجره pop-up که در گوشه ی بالا، سمت راست پنجره ی خط فرمان، که در حال اجرای وب سرور است، باز شده است، بر روی آدرس URL ظاهر شده کلیک کنید. این آدرس چیزی شبیه به این است:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+یا در Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+تبریک! شما اولین وبسایت خود را ساخته اید و با یک وب سرور آن را فعال کرده اید! فوق العاده نیست؟
+
+![Install worked!](images/install_worked.png)
+
+توجه داشته باشید که یک کنسول خط فرمان در هر لحظه فقط یک کار را می‌تواند انجام دهد و کنسول خط فرمان که شما قبل‌تر باز کرده‌اید در حال اجرای وب سرور است. تا زمانی که وب سرور در حال اجراست و منتظر است تا درخواستی به آن برسد می‌توان چیزی تایپ کرد ولی هیچ دستور جدیدی را نمی‌توان اجرا کرد.
+
+> نحوه عملکرد وب سرور را در بخش **اینترنت چگونه کار می‌کند** دوره کرده ایم.
+
+برای اینکه در زمان فعال بودن وب سرور، دستورات بیشتری را در کنسول خط فرمان تایپ کنید باید یک کنسول جدید باز کنید و محیط مجازی خود را فعال کنید. برای آنکه روش باز کردن یک کنسول جدید را مرور کنید می‌توانید به بخش [آشنایی با خط فرمان](../intro_to_command_line/README.md) نگاهی بیندازید. برای قطع فعالیت وب سرور، به همان کنسولی بروید که وب سرور در آن فعال است و کلید CTRL و C را با هم بزنید (در ویندوز ممکن است لازم باشد کلید CTRL را با کلید Break بزنید).
+
+برای قدم بعدی آماده هستید؟ حالا وقت آن است که کمی محتوا بسازیم!
\ No newline at end of file
diff --git a/fa-IR/django_templates/README.md b/fa-IR/django_templates/README.md
new file mode 100644
index 00000000000..06eefa0c9d7
--- /dev/null
+++ b/fa-IR/django_templates/README.md
@@ -0,0 +1,108 @@
+# templates در جنگو
+
+وقت آن است که داده‌ها را در وبسایت نمایش دهیم. جنگو چندین **template tag** مفید در اختیار ما قرار می‌دهد.
+
+## template tag چیست؟
+
+میدانیم که در کدهای HTML نمی‌توانیم از کد های پایتون استفاده کنیم،به این دلیل که مرورگر نمی‌تواند کد پایتون را درک کند. مرورگرها فقط HTML را می‌فهمند. همینطور می‌دانیم که HTML ایستا است، در حالی که پایتون بسیار پویاتر است.
+
+** template tags در جنگو ** ما را قادر می‌سازد تا اشیا پایتونی را به HTML انتقال دهیم، بنابراین شما می‌توانید با سرعت بیشتری وبسایت‌های پویا توسعه دهید. چه خوب!
+
+## نمایش دادن قالب لیست پست‌های وبلاگ
+
+در بخش قبلی، ما لیستی از پست‌ها را در قالب متغیر `posts` به template دادیم. حالا آن را به وسیله HTML نمایش می‌دهیم.
+
+برای چاپ یک متغیر در template های جنگو، نام متغیر را درون دو جفت آکولاد قرار می دهیم. مانند کد زیر:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+این مورد را در قالب `blog/templates/blog/post_list.html` امتحان کنید. آن را در ویرایشگر کد باز کنید، و هر چیزی از دومین `<div>` تا سومین `</div>` را با `{{ posts }}` جایگزین کنید. فایل را ذخیره کنید، و صفحه را برای دیدن نتیجه refresh کنید:
+
+![تصویر 13.1](images/step1.png)
+
+همینطوری که مشاهده می‌کنید، تمام چیزی که به دست آورده‌ایم این است:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+این به معنای آن است که جنگو این متغیر را به عنوان لیستی از اشیا در نظر می‌گیرد. آیا از بخش **معرفی پایتون** بخاطر دارید که چگونه می‌توانیم لیست‌ها را نمایش دهیم؟ بله، با حلقه for ! در یک template جنگو شما این کار را به صورت زیر انجام خواهید داد:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+این کار را در template خود امتحان کنید.
+
+![تصویر 13.2](images/step2.png)
+
+کار میکند! اما ما میخواهیم تا پست ها مانند پست های ایستایی که پیش از این در بخش **معرفی HTML** ساختیم، نمایش داده شود. میتوانید HTML و template tag را با هم استفاده کنید. قسمت `body` به صورت زیر خواهد بود:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %} هر چیزی که بین `{% for %}` و `{% endfor %}` قرار می‌دهید، برای هر شی در لیست تکرار می‌شود. صفحه خود را refresh کنید: {% endraw %}
+
+![تصویر 13.3](images/step3.png)
+
+آیا توجه کردید که این بار از نشانه گذاری متفاوتی استفاده کردیم؟ (`{{ post.title }}` یا `{{ post.text }}`)؟ ما در حال دسترسی به داده‌های موجود در هر فیلد تعریف شده در مدل `Post` هستیم. همچنین، `|linebreaksbr` متن پست‌ها را از فیلتری رد می‌کند که line-break ها را به پاراگراف تبدیل می‌کند.
+
+## یک مورد دیگر
+
+خوب است اگر بدانیم وب سایت شما روی اینترنت عمومی نیز به درستی کار می‌کند یا نه، درست است؟ بیایید تا دوباره انتشار آن را روی PythonAnywhere امتحان کنیم. خلاصه‌ای از مراحل در زیر آورده شده‌ است…
+
+* ابتدا کد خود را روی گیتهاب push کنید
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* سپس دوباره به [PythonAnywhere](https://www.pythonanywhere.com/consoles/) وارد شوید و به **Bash console** خود بروید ( یا یک کنسول خط فرمان جدید باز کنید)، و دستورات زیر را اجرا کنید:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(به خاطر داشته باشید `<your-pythonanywhere-domain>` را با زیردامنه PythonAnywhere خود جایگزین کنید، بدون علامت های <>)
+
+* سرانجام، به برگه ["Web" page](https://www.pythonanywhere.com/web_app_setup/) بروید و **Reload** را انتخاب کنید. (برای رسیدن به سایر صفحات در PythonAnywhere از دکمه منو در سمت بالا و راست صفحه استفاده کنید.) به روز رسانی شما باید در آدرس https://subdomain.pythonanywhere.com موجود باشد در مرورگر خود آن را امتحان کنید! اگر پست‌های وبلاگی شما در PythonAnywhere با پست‌های شما در سرور فعال روی کامپیوترتان یکی نیست، نگران نباشید همه چیز مرتب است. پایگاه داده موجود روی کامپیوتر شما و PythonAnywhere، برخلاف سایر فایل‌های شما، با یکدیگر یکسان سازی نمی‌شوند و یکی نیستند.
+
+تبریک! حالا سعی کنید که یک پست جدید از طریق پنل مدیریت جنگو (به یاد دارید که published_date را اضافه کردیم) اضافه کنید مطمئن شوید که در بخش مدیریت جنگو در وبسایت PythonAnywhere باشید، https://subdomain.pythonanywhere.com/admin. سپس صفحه خود را دوباره بارگزاری کنید و ببینید آیا پست جدید به آن اضافه شده است.
+
+جذاب نیست؟ به شما افتخار می‌کنیم! کمی از کامپیوتر خود دور شوید، لازم است کمی استراحت کنید. :)
+
+![تصویر 13.4](images/donut.png)
\ No newline at end of file
diff --git a/fa-IR/django_urls/README.md b/fa-IR/django_urls/README.md
new file mode 100644
index 00000000000..164462a0938
--- /dev/null
+++ b/fa-IR/django_urls/README.md
@@ -0,0 +1,103 @@
+# URL ها در جنگو
+
+ما در آستانه ساخت اولین صفحه وب هستیم: یک صفحه برای وبلاگ شما! ولی قبل از آن بیایید کمی در مورد آدرس دهی در جنگو یادبگیریم.
+
+## URL چیست؟
+
+یک URL یک آدرس اینترنتی است. شما هربار که وبسایتی را بازدید می‌کنید می‌توانید آدرس آن را ببینید، این آدرس، در address bar یا پنجره آدرس مرورگر دیده می‌شود. (بله! `127.0.0.1:8000` یک آدرس (URL) است! و `https://djangogirls.org` هم یک آدرس (URL) است.)
+
+![URL](images/url.png)
+
+هر صفحه‌ای در اینترنت آدرس خود را لازم دارد. به این روش برنامه ما متوجه می‌شود که چه چیزی را باید به کاربری که یک آدرس را باز می‌کند نشان بدهد. در جنگو ما از چیزی به نام `URLconf` استفاده می‌کنیم (URL configuration). URLconf مجموعه‌ای از الگوها است که جنگو به کمک آن می‌تواند متوجه شود که آدرس درخواست شده باید به کدام ویو، ارجاع داده شود.
+
+## آدرس ها در جنگو چطور کار می‌کنند؟
+
+حالا فایل `mysite/urls.py` را در ویرایشگر کد خود باز کنید و ببینید چگونه است:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+همانطور که می‌بینید، اینجا جنگو چیزهایی برای ما گذاشته است.
+
+به خطوط بین نقل قول سه تایی (`'''` یا `"""`) docstrings یا توضیحات سند گفته می‌شود. شما می‌توانید این توضیحات را در بالای فایل، کلاس یا تابع بنویسید و عملکرد آن را شرح دهید. این خطوط توسط پایتون اجرا نمی‌شوند.
+
+همچنین، آدرس بخش مدیریت که در بخش قبل دیده اید، اینجا وجود دارد:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+معنی این خط این است که هر آدرسی که با `admin/` شروع شود، جنگو *view* مربوط به آن را پیدا خواهد کرد. در این مورد خاص، ما تعداد زیادی آدرس را اضافه کرده‌ایم که همه آن‌ها در این فایل نیامده‌اند - این شکل از خلاصه کردن آدرس‌ها خوانایی وتمیزی کدها را افزایش می‌دهد.
+
+## اولین آدرس جنگویی شما!
+
+زمان آن است که اولین آدرس خود را بسازید! ما می‌خواهیم که 'http://127.0.0.1:8000/' صفحه اصلی وبلاگ ما باشد که در آن لیستی از پست‌ها نمایش داده شود.
+
+همچنین می‌خواهیم که فایل `mysite/urls.py` را تمیز نگه داریم، در نتیجه آدرس‌ها را از اپلیکیشن `blog` ، در فایل اصلی آدرس‌ها `mysite/urls.py` فراخوانی می‌کنیم.
+
+به پیش برویم و خطی را اضافه کنیم که `blog.urls` را بارگذاری می‌کند. همچنین لازم است که خط `from django.urls…` را عوض کنید چرا که ما اینجا از تابع `include` استفاده می‌کنیم، بنابراین لازم است که شما دستور import را به این خط اضافه کنید.
+
+فایل `mysite/urls.py` شما باید چیزی شبیه به این شده باشد:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+حالا جنگو هر درخواستی که به آدرس 'http://127.0.0.1:8000/' ارسال شود را به `blog.urls` ارسال می‌کند و دستورالعمل‌های بعدی را در آنجا جستجو می‌کند.
+
+## blog.urls
+
+در پوشه `blog` یک فایل خالی به نام `urls.py` بسازید و آن را در ویرایشگر کد باز کنید. بسیار خوب! این دو خط را به آن اضافه کنید:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+در اینجا ما تابع جنگویی `path` و تمام `view` ها از اپلیکیشن `blog` را بارگذاری کرده‌ایم (هرچند که هنوز هیچ view نداریم ولی تا چند دقیقه دیگر سراغ آن خواهیم رفت!)
+
+بعد از این می‌توانیم اولین الگو آدرس را اضافه کنیم:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+همانطور که می‌بینید ما یک `view` به نام `post_list` را به آدرس پایه وبلاگ نسبت داده‌ایم. این الگوی URL، شامل یک رشته خالی از کاراکتر است و سیستم بررسی آدرس جنگو نام دامنه را (مثلاً http://127.0.0.1:8000/) که پیشوندی برای همه آدرس‌ها است، در نظر نمی‌گیرد. این الگو به جنگو می‌گوید که اگر کسی آدرس 'http://127.0.0.1:8000/' را وارد کرد باید به `views.post_list` بروی.
+
+قسمت آخر، `name='post_list'`، نام آدرس است که برای تعیین هویت یک view استفاده می‌شود. این نام می‌تواند کاملاً شبیه نام view باشد یا نام کاملاً متفاوتی داشته باشد. ما بعداً از آدرس‌های نامگذاری شده در پروژه استفاده خواهیم کرد بنابراین مهم است که برای هر آدرسی نام، تعریف شود. علاوه بر این تلاش خواهیم کرد که نام آدرس‌ها، منحصر به فرد و برای به خاطر سپردن، ساده باشد.
+
+اگر الان تلاش کنید تا به آدرس http://127.0.0.1:8000/ بروید احتمالاً با پیغام خطای موجود نبودن صفحه مواجه خواهید شد. این پیغام به خاطر این است که سرور (یادتان هست که تایپ می‌کردیم `runserver`؟) فعال نیست. به کنسول سرور نگاه کنید تا ببینید دلیل آن چیست.
+
+![خطا](images/error1.png)
+
+کنسول سرور یک پیعام خطا نشان می‌دهد ولی نگران نباشید، ابزار سودمندی است: این پیغام خطا می‌گوید که **no attribute 'post_list'**. این نام همان *view* است که جنگو تلاش می‌کند آن را پیدا و اجرا کند، اما ما هنوز آن را نساخته‌ایم. در این مرحله `/admin/` شما هم کار نمی‌کند. نگران نباشید، سراغ آن هم خواهیم رفت. اگر پیغام خطای دیگری دریافت کردید یک بار وب سرور را قطع و مجدداً فعال کنید. برای این کار، در پنجره کنسولی که وب سرور در آن در حال اجرا است، با زدن کلیدهای Ctrl+C (کلید Control و کلید C با هم)، وب سرور را متوقف کنید. در ویندوز ممکن است لازم باشد کلیدهای Ctrl+Break را بزنید. سپس لازم است که وب سرور را مجدداً با دستور `python manage.py runserver` راه اندازی کنید.
+
+> اگر می‌خواهید بیشتر در مورد URLconfs جنگو بدانید، به مستندات رسمی آن نگاهی بیندازید: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/fa-IR/django_views/README.md b/fa-IR/django_views/README.md
new file mode 100644
index 00000000000..7a51ba2acf9
--- /dev/null
+++ b/fa-IR/django_views/README.md
@@ -0,0 +1,44 @@
+# ساخت view در جنگو!
+
+وقتشه که از شر باگی که تو فصل قبلی ایجاد کردیم راحت بشیم :)
+
+یک *view* یا نما بخشی از برنامه است که "منطق" برنامه در آن قرار می‌گیرد. این مولفه اطلاعات مورد نیاز را از `model` هایی که قبلا ایجاد کرده‌اید می گیرد و به `template` ارسال می‌کند. ما در بخش بعد یک قالب یا template خواهیم ساخت. View ها صرفاً توابع پایتونی هستند که کمی پیچیده‌تر از توابعی هستند که در بخش **آشنایی با پایتون** نوشتیم.
+
+ویوها در فایل `views.py` قرار دارند. ما *ویوهای* مورد نظرمان را در فایل `blog/views.py` اضافه خواهیم کرد.
+
+## blog/views.py
+
+خب، بیایید این فایل را در ویرایشگر کد باز کنیم و ببینیم چه چیزی در آن هست:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+هنوز چیز زیادی در آن نیست.
+
+به یاد داشته باشید که خط هایی که با `#` شروع می‌شوند کامنت یا توضیحات هستند - به این معنی که این خط ها توسط پایتون اجرا نمی‌شوند.
+
+حالا بیایید همانند توصیه‌ای که در خود فایل شده است یک *view* بسازیم. این ویو بسیار خلاصه را زیر کامنت موجود در فایل اضافه کنید:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+همانطور که می‌بینید ما یک تابع ساختیم ( دستور `def` تابع `post_list` را که یک آرگومان به نام `request` می‌گیرد صدا می‌زند و در نهایت به کمک یک تابع دیگر به نام `render` قالب `blog/post_list.html` را باز می‌گرداند (`return`)).
+
+فایل را ذخیره کنید و در مرورگر خود آدرس http://127.0.0.1:8000/ را بزنید و ببینید چه چیزی دیده می‌شود.
+
+باز هم خطا! ببینید چه اتفاقی افتاده است:
+
+![خطا](images/error.png)
+
+حداقل می‌توان دید که سرور در حال کار است اما هنوز، همه چیز کامل نیست، درست است؟ نگران نباشید این فقط یک صفحه خطاست، لازم نیست بترسید! دقیقاً شبیه خطاهای موجود در کنسول، این خطاها هم کاملاً مفید هستند. شما می‌توانید ببینید که با خطای *TemplateDoesNotExist* یعنی قالب وجود ندارد، مواجه شده اید. خب بگذارید این خطا را درست کنیم و در بخش بعد یک قالب یا template بسازیم!
+
+> با خواندن مستندات رسمی جنگو اطلاعات بیشتری در مورد ویوها یاد خواهید گرفت: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/fa-IR/dynamic_data_in_templates/README.md b/fa-IR/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..32450f053a8
--- /dev/null
+++ b/fa-IR/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# داده‌های پویا در template ها
+
+ما قطعات مختلفی داریم: مدل `Post` که در فایل `models.py` تعریف شده است، `post_list` که در فایل `views.py` تعریف شده و یک template که ساخته‌ایم. ولی واقعاً چطور پست‌های وبلاگمان را در قالب HTML نشان می‌دهیم؟ چون این کاری است که می‌خواهیم انجام دهیم؛ گرفتن محتوا (مدل‌هایی که در پایگاه داده ذخیره شده اند) و نشان دادن آن در قالب مورد نظر خودمان، درست است؟
+
+این دقیقاً همان چیزی است که *view*ها برای آن طراحی شده اند: وصل کردن مدل ها و قالب‌ها. در *ویو* `post_list` ما نیاز داریم که مدل مورد نظر را بگیریم و آن را به تمپلیت مناسب آن ارجاع دهیم. ما در *ویو* تصمیم می‌گیریم که چه چیزی (model) در تمپلیت نشان داده شود.
+
+بسیار خوب، چطور به این هدف برسیم؟
+
+لازم است که فایل`blog/views.py` را در ویرایشگر کد باز کنیم. تا اینجا *ویو* `post_list` شبیه به این است:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+به یاد دارید که در مورد اضافه کردن کدهای نوشته شده در فایل‌های مختلف صحبت کردیم؟ حالا وقت آن است که مدلی را که در فایل `models.py` نوشتیم به این فایل اضافه کنیم. ما خط `from .models import Post` را به این صورت اضافه می‌کنیم:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+نقطه قبل از `models` به معنی *پوشه جاری* یا *اپلیکیشن جاری* است. هر دو فایل `views.py` و `models.py` در یک پوشه قرار دارند. پس به این معنی است که ما می‌توانیم از `.` به همراه نام فایل (بدون پسوند `.py`) استفاده کنیم. سپس نام مدل را فراخوانی می‌کنیم (`Post`).
+
+قدم بعدی چیست؟ برای اینکه پست‌های وبلاگی واقعی که قبلاً ساخته ایم را فراخوانی کنیم به چیزی نیاز داریم که به آن `کوئری ست` یا `QuerySet` می‌گوییم.
+
+## QuerySet
+
+شما باید با نحوه کار کوئری ست‌ها آشنا باشید. ما در [بخش ORM جنگو](../django_orm/README.md) در مورد آن‌ها صحبت کرده ایم.
+
+حالا ما پست‌هایی را می‌خواهیم که بر اساس `تاریخ انتشار` یا published_date، مرتب شده اند، درست است؟ این کار را هم در بخش کوئری ست انجام داده ایم!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+حالا فایل `blog/views.py` را در ویرایشگر کد باز کنید و این تکه کد را به تابع `def post_list(request)` اضافه کنید. فراموش نکنید که خط `from django.utils import timezone` را هم به بالای فایل اضافه کنید:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+برای نمایش QuerySet در لیست ارسال های بلاگ، دو کار باقی مانده است که باید انجام شود:
+
+1. فرستادن کوئری ست `posts` به تمپلیت با تغییر تابع `render`. الان این کار را انجام می‌دهیم.
+2. اصلاح تمپلیت برای نمایش دادن کوئری ست `posts`. این کار را در بخش‌های بعد انجام خواهیم داد.
+
+توجه داشته باشید که ما یک *متغیر* برای کوئری ست مان درست کردیم: `posts`. آن را به عنوان نام کوئری ست در نظر بگیرید. از این به بعد ما به کمک همین نام به این کوئری ست مراجعه می‌کنیم.
+
+در تابع `render` ما یک پارامتر `request` داریم (درخواستی است که کاربر از طریق اینترنت برای ما ارسال کرده است) و یک پارامتر دیگر که نام فایل template است (`'blog/post_list.html'`). آخرین پارامتر ما، `{}`، محلی است که می‌توانیم چیزهایی را برای استفاده در template در آن قرار دهیم. باید برای این چیزها اسم تعریف کنیم (مثلاً همین متغیر `'posts'`). :) باید به این صورت برای فایل تمپلیت ارسال شوند: `{'posts': posts}`. توجه کنید که بخش سمت چپ علامت `:` از نوع رشته یا string است و لازم است که با علامت نقل قول `''` محصور شود.
+
+در نتیجه فایل `blog/views.py` ما شبیه به این خواهد شد:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+همین! وقت آن است که به فایل template برگردیم و این کوئری ست را نمایش دهیم!
+
+دوست دارید در مورد کوئری ست‌ها بیشتر بدانید؟ به اینجا نگاهی بیندازید: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/fa-IR/extend_your_application/README.md b/fa-IR/extend_your_application/README.md
new file mode 100644
index 00000000000..eb64c918205
--- /dev/null
+++ b/fa-IR/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# برنامه خود را توسعه دهید
+
+ما تقریباً تمام مراحل مختلف ضروری برای ساختن وبسایتمان را کامل کرده‌ایم: می‌دانیم که چطور مدل، URL، ویو و تمپلیت بنویسیم. علاوه بر این می‌دانیم که چطور وبسایتمان را زیباتر کنیم.
+
+زمان تمرین است!
+
+اولین چیزی که در وبلاگمان لازم داریم صفحه‌ای است که یک پست را نشان دهد، درست است؟
+
+ما یک مدل `Post` داریم پس لازم نیست چیزی به فایل `models.py` اضافه کنیم.
+
+## ساختن لینک به جزییات پست در تمپلیت
+
+ما با اضافه کردن یک لینک به فایل `blog/templates/blog/post_list.html` آغاز می‌کنیم. این فایل را در ویرایشگر کد باز کنید و تا اینجا باید شبیه به این باشد: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %} ما می‌خواهیم در لیست پست ها، یک لینک از عنوان پست وبلاگی به جزییات پست داشته باشیم. عبارت `<h2><a href="">{{ post.title }}</a></h2>` را تغییر دهید تا به صفحه جزییات پست لینک شود: {% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %} زمان آن است که عبارت رازآلود `{% url 'post_detail' pk=post.pk %}` را توضیح دهیم. همانطور که ممکن است حدس زده باشید این علامت `{% %}` به معنی آن است که ما از سیستم template tag جنگو استفاده می‌کنیم. این بار ما از یک tag استفاده خواهیم کرد که برایمان یک URL بسازد!{% endraw %}
+
+بخش `post_detail` به معنی آن است که جنگو انتظار دارد یک آدرس به نام post_detail، در فایل `blog/urls.py` وجود داشته باشد
+
+حالا معنی `pk=post.pk` چیست؟ `pk` مخفف primary key (کلید اصلی) است که یک نام منحصر به فرد برای هر ردیف از داده‌ها در پایگاه داده می‌باشد. هر مدل جنگو یک فیلد به عنوان کلید اصلی دارد، و سوای اینکه چه نام دیگری داشته باشد، همواره به عنوان pk قابل ارجاع است. چون ما در مدل `Post` کلید اصلی نساخته بودیم، جنگو یکی برای ما ساخته است (به طور پیشفرض فیلدی که نام آن "id" است، عددی را در خود ذخیره می‌کند که با هر دیتای جدید یکی به آن اضافه می‌شود مثلاً 1، 2، 3 ) و برای هر پست جدید در وبلاگ یکی به آن اضافه می‌کند. ما با نوشتن `post.pk` به کلید اصلی دسترسی پیدا می‌کنیم، همانطور که به فیلدهای دیگر (مانند `title` و `author`) در آبژکت `Post`، دسترسی داشته‌ایم.
+
+حالا وقتی به آدرس http://127.0.0.1:8000/ می‌رویم با خظا مواجه می‌شویم (همانطور که انتظار داشتیم، چرا که ما هنوز برای `post_detail` ، یک آدرس یا یک *view* نساخته ایم). چیزی شبیه به این:
+
+![خطا NoReverseMatch](images/no_reverse_match2.png)
+
+## ساختن آدرس برای جزییات یک پست وبلاگ
+
+بیایید یک URL برای *ویو* `post_detail` در فایل `urls.py` بسازیم!
+
+ما می‌خواهیم جزییات اولین پست ما در این **URL** دیده شود: http://127.0.0.1:8000/post/1/
+
+بیایید یک آدرس در فایل `blog/urls.py` بسازیم تا جنگو را به *view* با نام `post_detail` هدایت کند که جزییات کامل یک پست وبلاگ را نشان می‌دهد. فایل `blog/urls.py`را در ویرایشگر کد باز کنید و خط `path('post/<int:pk>/', views.post_detail, name='post_detail'),` را اضافه کنید، چیزی شبیه به این می‌شود:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+بخش `post/<int:pk>/` یک الگوی URL را معرفی می‌کند که برای شما توضیح خواهیم داد:
+
+- `post/` نشان می‌دهد که آدرس باید با کلمه **post** شروع شده باشد و در ادامه آن یک **/** وجود داشته باشد. تا اینجا همه چیز خوب است.
+- `<int:pk>` این بخش ممکن است کمی گیج کننده باشد، این عبارت به این معنی است که جنگو انتظار دارد که یک عدد صحیح دریافت کند و مقدار آن را به یک متغیر به نام `pk` نسبت خواهد داد.
+- `/` - درنهایت ما به یک **/** در انتهای آدرس نیاز داریم.
+
+یعنی اگر شما آدرس `http://127.0.0.1:8000/post/5/` را در مرورگر خود وارد کنید جنگو متوجه خواهد شد که شما به دنبال یک *view* به نام `post_detail` هستید و مقدار متغیر `pk` را برابر `5` قرار می‌دهد و این اطلاعات را به *view* مورد نظر ارسال می‌کند.
+
+بسیار عالی، ما یک الگوی آدرس جدید به فایل `blog/urls.py` اضافه کردیم! حالا صفحه http://127.0.0.1:8000/ را دوباره بارگزاری کنید، بووم! سرور دوباره متوقف شده است. به کنسول نگاهی بیندازید، یک پیغام خطای دیگر دیده می‌شود!
+
+![AttributeError](images/attribute_error2.png)
+
+یادتان هست که مرحله بعدی چیست؟ اضافه کردن ویو!
+
+## اضافه کردن ویو جزییات یک پست
+
+این بار *view* ما یک پارامتر اضافه دریافت کرده است، `pk`. *ویو* ما باید بتواند آن را دریافت کند، درست است؟ پس ما تابع خودمان را به این صورت تعریف می‌کنیم `def post_detail(request, pk):`. باید توجه داشته باشید که این پارامتر باید دقیقاً همان نامی را داشته باشد که ما در `urls` تعریف کرده‌ایم (`pk`). همچنین توجه کنید که حذف این متغیر، غلط است و باعث ایجاد خطا خواهد شد.
+
+حالا ما می‌خواهیم فقط و فقط یک پست وبلاگی را داشته باشیم. برای اینکار از کوئری ست به شکل زیر استفاده می‌کنیم:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+اما این کد یک مشکل دارد. اگر هیچ `Post` با `کلید اصلی` (`pk`) وجود نداشته باشد، یک خطای زشت دریافت خواهیم کرد!
+
+![خطا DoesNotExist](images/does_not_exist2.png)
+
+چنین چیزی را نمی‌خواهیم! اما خوشبختانه جنگو چیزی دارد که می‌تواند این مشکل را حل کند: `get_object_or_404`. در صورتی که هیچ `Post` با `pk` داده شده وجود نداشته باشد، یک صفحه خطای زیباتر یعنی صفحه `Page Not Found 404` را نشان خواهد داد.
+
+![صفحه پیدا نشد](images/404_2.png)
+
+خبر خوب اینکه شما می‌توانید صفحه `Page not found` اختصاصی برای خودتان را با سلیقه خودتان بسازید. اما این الان موضوع خیلی مهمی نیست بنابراین ما از آن رد خواهیم شد.
+
+وقت آن است که یک *ویو* به فایل `views.py` اضافه کنیم!
+
+در فایل `blog/urls.py` ما یک الگوی آدرس به نام `post_detail` ساختیم که به یک ویو با نام `views.post_detail` ارجاع داشت. این به این معنی است که جنگو انتظار دارد که یک تابع با نام `post_detail` در فایل `blog/views.py` وجود داشته باشد.
+
+زمان آن است که فایل `blog/views.py` را در ویرایشگر کد باز کنید و خطوط زیر را در ردیف `from` ها اضافه کنید:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+و در انتهای فایل، *ویو* خودمان را اضافه خواهیم کرد:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+بله، حالا وقت بارگذاری مجدد صفحه است: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+کار می‌کند! ولی وقتی روی لینک مربوط به عنوان یک پست کلیک کنید چه اتفاقی می‌افتد؟
+
+![خطا TemplateDoesNotExist](images/template_does_not_exist2.png)
+
+وای نه! یک خطای دیگر! اما حالا ما می‌دانیم که چطور با این خطا برخورد کنیم، درست است؟ ما باید یک تمپلیت اضافه کنیم!
+
+## ساختن یک تمپلیت برای جزییات پست وبلاگی
+
+در پوشه `blog/templates/blog` یک فایل به نام `post_detail.html` بسازید و آن را در ویرایشگر کد باز کنید.
+
+حالا کد زیر را تایپ کنید:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+یک بار دیگر ما فایل `base.html` را اضافه کرده‌ایم. ما می‌خواهیم در بلوک `content` ، جزییات یک پست منتشر شده (اگر چنین پستی وجود داشت) شامل عنوان و متن را نشان دهیم. اما باید در مورد چند موضوع مهم صحبت کنیم، خب؟
+
+{% raw %}`{% if ... %} ... {% endif %}` یک تمپلیت تگ است که وقتی می‌خواهیم چیزی را چک کنیم از آن استفاده می‌کنیم. (عبارت `if ... else ...` را از بخش **آشنایی با پایتون** به یاد دارید؟) در این سناریو ما می‌خواهیم بررسی کنیم آیا بخش `published_date` مربوط به یک پست خالی نیست.{% endraw %}
+
+بسیار خوب، ما می‌توانیم صفحه وبلاگمان را دوباره بارگذاری کنیم و ببینیم آیا خطا `TemplateDoesNotExist` از بین رفته است یا نه.
+
+![صفحه جزییات پست](images/post_detail2.png)
+
+واو! بالاخره کار کرد!
+
+# زمان دیپلوی!
+
+خوب خواهد بود اگر ببینیم وبسایت شما هنوز روی PythonAnywhere کار میکند یا نه؟پس بیایید یک بار دیگر آن را منتشر کنیم.
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+سپس در کنسول [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/) تایپ کنید:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(یادتان باشد که `<your-pythonanywhere-domain>` را با زیر دامنه اصلی خود در PythonAnywhere عوض کنید البته بدون آکولادها.)
+
+## به روزرسانی فایل‌های ایستا در سرور
+
+سرورهایی مانند PythonAnywhere دوست دارند که با فایل‌های ایستا (مانند فایل‌های CSS) به گونه‌ای متفاوت از فایل‌های پایتون برخورد کنند، چرا که می‌توانند آن ها را بهینه کنند و سرعت لود شدن آن‌ها را افزایش دهند. در نتیجه هرگاه که ما تغییری در فایل‌های CSS می‌دهیم ، باید دستوری اضافه بر روی آن اجرا کنیم تا به سرور بگوییم که این فایل‌ها تغییر کرده اند. این دستور `collectstatic` نام دارد.
+
+ابتدا با فعال کردن محیط مجازی شروع کنیم اگر از قبل هنوز فعال نیست (PythonAnywhere از دستوری به نام `workon` برای این کار استفاده می‌کند این دستور دقیقاً شبیه `source myenv/bin/activate` است که شما بر روی کامپیوتر خودتان اجرا می‌کنید):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+دستور `manage.py collectstatic` تقریباً شبیه دستور `manage.py migrate` است. ما تغییراتی در کدها می‌دهیم و به جنگو می‌گوییم این تغییرات را *apply* (اعمال) کند، چه در فایل‌های ایستا در سرور باشد چه در پایگاه داده.
+
+به هرحال، الان ما آماده هستیم، به سراغ ["Web" page](https://www.pythonanywhere.com/web_app_setup/) بروید (از طریق دکمه menu در گوشه بالا و سمت راست کنسول) و دکمه **Reload** را بزنید و سپس به صفحه https://subdomain.pythonanywhere.com نگاه کنید تا نتیجه را ببینید.
+
+به نتیجه رسید! تبریک! :)
\ No newline at end of file
diff --git a/fa-IR/how_the_internet_works/README.md b/fa-IR/how_the_internet_works/README.md
new file mode 100644
index 00000000000..92ce549d377
--- /dev/null
+++ b/fa-IR/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# اینترنت چگونه کار می‌کند
+
+> برای خوانندگان در خانه: این فصل در ویدئو [نصب پایتون و کد ویرایشگر](https://www.youtube.com/watch?v=oM9yAA09wdc) توضیح داده شده است.
+> 
+> این فصل "اینترنت چگونه کار می‌کند" از سخنرانی جسیکا مک کلر (http://web.mit.edu/jesstess/www/) الهام گرفته شده است.
+
+قطعاً شما هر روز از اینترنت استفاده می‌کنید. اما آیا می‌دانید در واقع وقتی شما آدرسی مثل https://djangogirls.org را در مرورگر خود تایپ می‌کنید، چه اتفاقی می‌افتد؟
+
+اولین چیزی که باید بدانید این است که یک وب سایت از مجموعه‌ای از فایل‌ها تشکیل شده است که روی یک هارد دیسک ذخیره شده اند ـ دقیقاً مانند فیلم‌ها، آهنگ‌ها و تصاویر شما. با این وجود، وب سایت ها یک ویژگی منحصر به فرد دارند: کدهای کامپیوتری به نام HTML.
+
+اگر با برنامه نویسی آشنایی ندارید، ممکن است درک HTML در ابتدا سخت باشد، ولی مرورگر های شما (مثل گوگل کروم، سافاری، فایرفاکس و...) عاشق آن هستند. مرورگرها طراحی شده اند تا این کدها را درک کنند، دستورات آنها را دنبال کنند و فایل‌هایی را که وب سایت شما از آن تشکیل شده است، دقیقاً آنطور که می‌خواهید، نمایش دهند.
+
+مانند هر فایل دیگری، ما نیاز داریم تا فایل‌های HTML را نیز جایی بر روی هارد دیسک ذخیره کنیم. برای اینترنت، ما از کامپیوترهای مخصوص و قوی به نام *servers* استفاده می‌کنیم. این کامپیوترها صفحه نمایش، کیبورد یا موس ندارند برای آنکه وظیفه اصلی آن‌ها ذخیره اطلاعات و ارائه آن‌ها است. برای همین به آن‌ها *سرور* می‌گویند برای آنکه آن‌ها داده‌ها را *ارائه* می‌کنند (serve یعنی ارائه کردن).
+
+خب، ولی شما می‌خواهید بدانید که اینترنت چطور کار می‌کند، درست است؟
+
+تصویری برای شما کشیده ایم! چیزی شبیه به این:
+
+![تصویر 1.1](images/internet_1.png)
+
+کمی به هم ریخته است، درست است؟ در واقع این شبکه‌ای از ماشین‌های به هم متصل شده است (همانطور که در بالا اشاره شد *سرورها* هستند). صدها و هزاران دستگاه! کیلومترها سیم و کابل دور دنیا! شما می‌توانید وبسایت نقشه کابل‌های زیردریایی (http://submarinecablemap.com) را ببینید تا با پیچیدگی شبکه آشنا شوید. این تصویری از این وبسایت است:
+
+![تصویر 1.2](images/internet_3.png)
+
+جذاب است، اینطور نیست؟ اما کشیدن یک سیم مستقیم بین هر دستگاه متصل شده به اینترنت با دیگر دستگاه‌ها ممکن نیست. بنابراین برای رسیدن به یک دستگاه (مثلاً دستگاهی که https://djangogirls.org روی آن ذخیره شده) نیاز است تا ما درخواستی (request) را از طریق دستگاه‌های بسیار زیادی ارسال کنیم.
+
+شبیه به این:
+
+![تصویر 1.3](images/internet_2.png)
+
+تصور کنید که وقتی شما https://djangogirls.org را تایپ می‌کنید، نامه‌ای فرستاده اید به این مضمون: "دختران جنگو عزیز، من می‌خواهم وب سایت djangogirls.org را ببینم. لطفاً آن را برای من بفرستید!"
+
+نامه شما به نزدیکترین اداره پست فرستاده می‌شود. بعد به اداره پست دیگری می‌رود که کمی بیشتر به مقصد نزدیک است و همینطور پیش می‌رود تا به مقصد نهایی برسد. تنها ویژگی این سیستم این است که اگر نامه های بسیاری به یک مقصد بفرستید (*data packets*) آن‌ها می‌توانند از مسیرهایی کاملاً متفاوت (*routers*) به مقصد برسند. این موضوع بستگی به این دارد که نامه ها در هر اداره پست چطور تقسیم شوند.
+
+![تصویر 1.4](images/internet_4.png)
+
+این روش کار است - شما پیغامی میفرستید و منتظر پاسخ می‌مانید. به جای قلم و کاغذ شما از بایت‌های داده استفاده می‌کنید اما منطق کار یکسان است!
+
+به جای آدرس یا نام خیابان، شهر و کدپستی، ما از آدرس IP استفاده می‌کنیم. کامپیوتر شما ابتدا از DNS (Domain Name System) می‌خواهد که djangogirls.org را به IP address تبدیل کند. این سیستم شبیه دفترچه تلفن‌های قدیمی است که شما می‌توانستید دنبال نام یک نفر بگردید و آدرس و شماره تلفن وی را پیدا کنید.
+
+وقتی شما نامه‌ای می‌فرستید نیاز است که ویژگی های مشخصی داشته باشد تا قابل ارسال باشد: آدرس، تمبر و غیره. علاوه بر این از زبانی استفاده می‌کنید که گیرنده آن را متوجه شود، درست است؟ عین همین اتفاق برای *data packet* هایی می‌افتد که شما برای دیدن یک وبسایت ارسال می‌کنید. ما از پروتکلی به نام HTTP (Hypertext Transfer Protocol) استفاده می‌کنیم.
+
+بنابراین به طور اصولی، وقتی شما وبسایتی دارید، نیاز است تا یک *سرور* داشته باشید که وبسایت بر روی آن قرار داشته باشد. وقتی که *سرور* یک *ریکوئست* (یک درخواست به صورت یک نامه) را دریافت می‌کند، وبسایت شما را در پاسخ به آن نامه ارسال می‌کند (در یک نامه جداگانه).
+
+از آنجاییکه این دوره آموزشی جنگو است، ممکن است شما بپرسید جنگو چه کاری را انجام می‌دهد. وقتی شما پاسخ هر درخواست را می‌فرستید، معمولاً نمی‌خواهید یک پاسخ یکسان را برای همه بفرستید. بسیار بهتر خواهد بود اگر هر نامه‌ای شخصی و ویژه هر فرد فرستنده، پاسخ داده شود، درست است؟ جنگو به شما کمک می‌کند تا این نامه‌های شخصی و جالب را بسازید. :)
+
+صحبت بس است - وقت ساختن است!
\ No newline at end of file
diff --git a/fa-IR/html/README.md b/fa-IR/html/README.md
new file mode 100644
index 00000000000..8dc4c605f52
--- /dev/null
+++ b/fa-IR/html/README.md
@@ -0,0 +1,227 @@
+# آشنایی با HTML
+
+ممکن است بپرسید تمپلیت چیست؟
+
+تمپلیت (به معنی قالب) فایلی است که می‌توانیم بارها از آن استفاده کنیم و اطلاعات مختلفی را به کمک آن و در یک فرمت ثابت ارائه کنیم. مثلاً شما می‌توانید از یک تمپلیت کمک بگیرید و یک نامه بنویسید چرا که با اینکه هر نامه‌ای پیغام و آدرس متفاوتی دارد، اما از فرمت مشابهی استفاده می‌کند.
+
+یک تمپلیت جنگو توسط زبانی به نام HTML تعریف می‌شود (همان HTML که در بخش اول، **اینترنت چگونه کار می‌کند**، به آن اشاره کرده بودیم).
+
+## HTML چیست؟
+
+HTML نوعی از کد است که توسط مرورگر وب، مانند کروم و فایرفاکس یا سافاری، تفسیر و اجرا می‌شود تا یک صفحه وب را نشان دهد.
+
+HTML مخفف عبارت "HyperText Markup Language" است. **HyperText** به این معنی است که نوعی از نوشته است که هایپرلینک بین صفحات را پشتیبانی می‌کند. **Markup** یعنی ما یک متن را برمی‌داریم و آن را علامت گذاری می‌کنیم تا به سیستم دیگری (مثلاً در اینجا مرورگر وب) بگوییم چطور آن را تفسیر کند. کدهای HTML با **tag** ها ساخته شده اند که هرکدام با `>` آغاز و با `<` پایان می‌یابند. این تگ‌ها **المان‌های** نشانه گذاری هستند.
+
+## اولین تمپلیت شما!
+
+ساختن یک تمپلیت یعنی ساختن یک فایل تمپلیت. هرچیزی، یک فایل است، درست است؟ احتمالاً تا الان این موضوع را متوجه شده اید.
+
+تمپلیت‌ها در دایرکتوری `blog/templates/blog` ذخیره می‌شوند. بنابراین اول یک دایرکتوری به نام `templates` در دایرکتوری وبلاگ بسازید. سپس دایرکتوری دیگری به نام `blog` در داخل آن بسازید:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(ممکن است فکر کنید که چرا دوتا دایرکتوری به نام `blog` لازم داریم. همانطور که بعدتر خواهیم دید این یک سیستم نامگذاری کارآمد برای وقتی است که اوضاع پیچیده‌تر می‌شود.)
+
+حالا یک فایل `post_list.html` (که فعلاً خالی باشد) در دایرکتوری بسازید `blog/templates/blog`.
+
+نگاه کنید که الان وبسایت شما چه شکلی شده است: http://127.0.0.1:8000/
+
+> اگر هنوز پیغام خطا `TemplateDoesNotExist` را می‌بینید، یک بار سرور را قطع و بعد دوباره فعال کنید. به خط فرمان بروید سرور را با زدن Ctrl+C (کلید کنترل و کلید C باهم) قطع کنید و با اجرای دستور `python manage.py runserver` مجدداً فعال کنید.
+
+![تصویر 11.1](images/step1.png)
+
+پیغام خطایی نیست! تبریک :) با اینحال وبسایت شما هنوز چیزی به غیر از یک صفحه خالی نشان نمی‌دهد برای اینکه تمپلیت شما خالی است. لازم است که آن را اصلاح کنیم.
+
+فایل جدید را در ویرایشگر کد باز کنید و موارد زیر را به آن اضافه کنید:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+الان وبسایت شما چطور به نظر می‌رسد؟ به آن سری بزنید تا بفهمید: http://127.0.0.1:8000/
+
+![تصویر 11.2](images/step3.png)
+
+کار می‌کند! خوب شد! :)
+
+* خط `<!DOCTYPE html>` یک تگ HTML نیست. این عبارت فقط نوع فایل را مشخص می‌کند. در اینجا این عبارت به مرورگر اعلام می‌کند که نوع فایل [HTML5](https://html.spec.whatwg.org/#the-doctype) است. همیشه شروع هر نوع فایل HTML5 با همین عبارت شروع می‌شود.
+* `<html>` پایه‌ای‌ترین تگ و معمولاً اولین تگ در ابتدای صفحه است و تگ `</html>` معمولاً در انتهای صفحه می‌آید. همانطور که می‌بینید، تمام محتوای وبسایت بین تگ `<html>` در ابتدا و تگ `</html>` در انتها قرار می‌گیرند
+* تگ `<p>` برای پاراگراف‌ها به کار می‌رود و تگ `</p>` پایان هر پاراگراف را مشخص می‌کند
+
+## Head and body
+
+هر صفحه HTML همچنین به دو بخش اصلی تقسیم می‌شود: **head** و **body**.
+
+* **head** عنصری است که شامل اطلاعاتی در مورد هر فایل می‌شود که در صفحه نشان داده نمی‌شوند.
+
+* **body** عنصری است که شامل هر چیزی است که در صفحه وبسایت نمایش داده می‌شوند.
+
+ما از `<head>` استفاده می‌کنیم تا در مورد تنظیمات فایل به مرورگر اطلاعاتی بدهیم و `<body>` نشان می‌دهد که چه چیزی واقعاً در صفحه وجود دارد.
+
+برای مثال شما می‌توانید تگ عنوان یا title را به شکل زیر در `<head>`، قرار دهید:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+این فایل‎ را ذخیره کنید و وبسایت خود را دوباره بارگذاری کنید.
+
+![تصویر 11.3](images/step4.png)
+
+توجه کنید که چگونه مرورگر متوجه شد که "Ola's blog" عنوان صفحه شماست؟ مرورگر عبارت `<title>Ola's blog</title>` را تفسیر کرده و آن را به عنوان نام صفحه، در نوار نام صفحه مرورگر قرار داده است (البته عنوان در جاهای دیگری مانند bookmark کردن هم استفاده می‌شود).
+
+احتمالاً تا الان توجه کرده‌اید که هر تگ شروع به همراه یک *تگ پایان* و علامت `/` می‌آید و عوامل در آن نیز *nested* می‌شوند (یعنی شما نمی‌توانید یک تگ را ببندید مگر آنکه تمام تگ‌های درون آن را بسته باشید).
+
+شبیه گذاشتن چیزها در جعبه است. شما یک جعبه بزرگ دارید، `<html></html>`؛ درون آن یک جعبه دیگر `<body></body>`، و این همینطور ادامه دارد تا به کوچکترین جعبه برسد: `<p></p>`.
+
+شما باید از این قوانین *بستن تگ‌ها* و نیز *nesting*، پیروی کنید. اگر این قوانین رعایت نشوند مرورگر ممکن است نتواند فایل شما را درست تفسیر کند و صفحه HTML درست نمایش داده نخواهد شد.
+
+## تنظیم کردن تمپلیت
+
+الان می‌توانید کمی تفریح کنید و تلاش کنید تا تمپلیت خود را تنظیم کنید! در اینجا تعدادی تگ مفید معرفی شده:
+
+* `<h1>heading</h1>` یک تیتر برای عنوان‌های مهم
+* `<h2>sub-heading</h2>` یک تیتر برای عنوان‌های کم اهمیت‌تر
+* `<h3>sub-sub-heading</h3>` یک زیر عنوان که تا `<h6>` درجه اهمیت آن کمتر می‌شود
+* `<p>پاراگراف</p>پاراگرافی از نوشته‌ها`
+* `<em>تاکید</em>` بر نوشته شما تاکید می‌کند
+* `<strong>تاکید</strong>` تاکید بیشتر روی متن
+* `<br>` به خط بعد می‌رود (شما نمی‌توانید چیزی درون تگ br بگذارید و علاوه بر این br، تگِ پایانی ندارد)
+* `<a href="https://djangogirls.org">لینک</a>` یک لینک می‌سازد
+* `<ul><li>آیتم اول</li><li>آیتم دوم</li></ul>` یک لیست، دقیقاً مانند همین لیست درست می‌کند!
+* `<div></div>` یک بخش جدید در صفحه تعریف می‌کند
+* `<nav></nav>` مجموعه‌ای از لینک‌های دسترسی را تعریف می‌کند
+* `<article></article>`محتوای مستقل و فارق از محیط را مشخص می‌کند
+* `<section></section>` یک بخش را در فایل مشخص می‌کند
+* `<header></header>` بخش سربرگ یک صفحه را مشخص می‌کند
+* `<main></main>` بخش محتوای اصلی صفحه را مشخص می‌کند
+* `<aside></aside>` محتوای جانبی نسبت به جایی که در آن قرار گرفته را مشخص می‌کند (مانند منوی کناری)
+* `<footer></footer>` بخش پاورقی یک سند را مشخص می‌کند
+* `<time></time>` بک زمان (یا تاریخ و زمان) را مشخص می‌کند
+
+اینجا نمونه‌ای از یک تمپلیت کامل داریم. آن را در فایل `blog/templates/blog/post_list.html` کپی کنید:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+ما اینجا یک بخش `header` و دو بخش 0>article</code> ایجاد کردیم.
+
+* بخش `header` شامل عنوان مقاله وبلاگ ماست - یک عنوان و یک لینک
+* دو عنصر `article` شامل پست‌های وبلاگ ما به همراه تاریخ انتشار در یک عنصر `time`، یک عنصر`h2` با عنوان مقاله که قابل کلیک کردن است و عنصر `p` (paragraph) که برای متن مقاله استفاده شده است.
+
+چنین نتیجه ای به ما می‌دهد:
+
+![تصویر 11.4](images/step6.png)
+
+واای! ولی تا اینجا تمپلیت ما دقیقاً **اطلاعات یکسانی** را نمایش می‌دهد درحالیکه قبل‌تر در مورد این صحبت کردیم که تمپلیت به ما اجازه می‌دهد **اطلاعات متفاوتی** را در **قالب یکسان** نمایش دهیم.
+
+آن چیزی که واقعاً می‌خواهیم این است که پست‌های واقعی که در جنگو ادمین اضافه کرده‌ایم را نمایش دهد و این همان چیزی است که در ادامه سراغ آن خواهیم رفت.
+
+## فقط یک چیز دیگر: دیپلوی!
+
+خیلی خوب خواهد بود که همه اینها را به صورت آنلاین بر روی اینترنت ببینیم، درست است؟ پس بیایید یک بار دیگر به کمک PythonAnywhere وبسایت را منتشر کنیم:
+
+### کامیت کنید و کد را بر روی گیتهاب پوش کنید
+
+اول از همه ببینیم کدام فایل ها را به نسبت آخرین انتشار، تغییر داده ایم (این دستور را بر روی کامپیوتر خود اجرا کنید و نه در PythonAnywhere):
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ git status
+    
+
+مطمئن باشید که در دایرکتوری `djangogirls` هستید و به `گیت` اجازه دهید تمام تغییرات ایجاد شده در این دایرکتوری را در نظر بگیرد:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ git add .
+    
+
+قبل از آنکه همه فایل‌ها را آپلود کنیم بگذارید ببینیم که `گیت` چه فایل‌هایی را آپلود خواهد کرد (تمام فایل‌هایی که `گیت` آپلود خواهد کرد الان سبز رنگ دیده می‌شوند):
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ git status
+    
+
+حالا وقت آن است که بگوییم تمام این تغییرات را در سابقه خودش ذخیره کند. الان می‌خواهیم یک "commit message" یا پیغام کامیت تعریف کنیم که تغییرات ما را توضیح می‌دهد. هرچیزی که دلتان بخواهد می‌توانید تایپ کنید، اما بهتر است توضیحاتی را بنویسید که بعداً متوجه شوید در این مرحله چه تغییراتی داده‌اید.
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **نکته** مطمئن باشید که از علامت نقل قول دوتایی در اطراف پیغام مربوط به کامیت استفاده کنید.
+
+وقتی این کار را انجام دادیم تغییرات را در گیتهاب آپلود (push) می‌کنیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ git push
+    
+
+### فایل‌های جدیدتان را بر روی PythonAnywhere ببرید و صفحه وبسایت را دوباره بارگذاری کنید
+
+* سپس دوباره به صفحه **Bash console** خود در [PythonAnywhere](https://www.pythonanywhere.com/consoles/) بروید (یا یک کنسول خط فرمان جدید باز کنید) و دستورات زیر را اجرا کنید:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+یادتان باشد که `<your-pythonanywhere-domain>` را با زیر دامنه اصلی خود در PythonAnywhere عوض کنید البته بدون آکولادها. نام زیردامنه شما معمولاً همان نام کاربری شما در PythonAnywhere است اما در مواردی ممکن است کمی متفاوت باشد (مثلاً اگر نام کاربری شما دارای حروف بزرگ باشد). اگر این دستور کار نکرد از `ls` (لیست کردن فایل‌ها) استفاده کنید تا زیردامنه خود را پیدا کنید و سپس با دستور `cd` به آن دایرکتوری بروید.
+
+حالا منتظر شوید تا فایل‌های شما دانلود شوند. اگر می‌خواهید بدانید که فایل‌ها رسیده اند یا نه به صفحه **"Files"** بروید و کدهای خود بر روی PythonAnywhere را ببینید (شما میتوانید به بقیه فایل‌های خود در PythonAnywhere، از طریق کلید منو در کنسول دسترسی پیدا کنید).
+
+* سرانجام به صفحه ["Web"](https://www.pythonanywhere.com/web_app_setup/) بروید و **Reload** را بزنید.
+
+تغییرات شما آنلاین شده اند! صفحه وبسایت خود را در مرورگرتان دوباره بارگذاری کنید. تغییرات دیده خواهند شد. :)
\ No newline at end of file
diff --git a/fa-IR/installation/README.md b/fa-IR/installation/README.md
new file mode 100644
index 00000000000..4857ed957d7
--- /dev/null
+++ b/fa-IR/installation/README.md
@@ -0,0 +1,68 @@
+# اگر این آموزش را در خانه دنبال می‌کنید
+
+اگر این آموزش را در خانه دنبال می‌کنید و نه در یکی از [رویدادهای دختران جنگو](https://djangogirls.org/events/)، می‌توانید به طور کامل از این بخش بگذرید و به بخش [اینترنت چگونه کار می‌کند](../how_the_internet_works/README.md) بروید.
+
+به دلیل اینکه ما نصب کردن هر چیزی را که دراین سری آموزشی نیاز است، در محل مورد نیاز بیان می‌کنیم. این صفحه تنها برای بیان همه دستورات نصب در یک مکان، اضافه شده است (که برای برخی کارگاه‌ها مفید است). شما می‌توانید هرچیزی که در این بخش آمده است را نصب کنید. اما اگر ترجیح می‌دهید پیش از نصب چند ابزار و نرم افزار روی کامپیوترتان، در مورد آن‌ها یاد بگیرید، از این بخش عبور کنید. ما نحوه‌ی نصب هر چیزی را، زمانی که به آن نیاز داشتید، توضیح می‌دهیم.
+
+موفق باشید!
+
+# اگر در یک کارگاه شرکت کرده‌اید
+
+اگر در یکی از [رویدادهای جنگو برای دختران](https://djangogirls.org/events/) شرکت کرده اید:
+
+* ممکن است کارگاه شما یک "جلسه نصب پیش‌نیازها" قبل از رویداد اصلی داشته باشد. اگر در جلسه نصب پیش‌نیازها هستید، این بخش مخصوص شماست! برای نصب هرچیزی که در این رویداد نیاز دارید، دستورالعمل‌های این بخش را دنبال کنید، و در صورت نیاز از مربی‌ها کمک بگیرید. سپس در کارگاه اصلی، می‌توانید از دستورالعمل‌های نصب که در آموزش اصلی با آنها مواجه می‌شوید، عبور کنید.
+* ممکن است برگزار کنندگان کارگاه، از شما بخواهند تا سعی کنید همه چیز را قبل از شروع کارگاه روی کامپیوترتان نصب کنید. اگر از شما این درخواست را داشته اند، این بخش برای شماست! به بهترین نحو دستورالعمل های این بخش را دنبال کنید. اگر نتوانستید چیزی را نصب کنید، در کارگاه اصلی، زمانی که به دستورالعمل‌های نصب آن بخش در آموزش اصلی می‌رسید، می‌توانید از مربی‌ها کمک بگیرید.
+* اگر کارگاه شما فاقد جلسه نصب پیش نیازها بود (یا شما نتوانستید در آن شرکت کنید)، و اگر برگزارکنندگان از شما نخواستند که همه چیز را پیش از شروع رویداد نصب کنید، از این بخش عبور کنید و مستقیم به بخش [ اینترنت چگونه کار می‌کند](../how_the_internet_works/README.md) بروید. شما هر چیزی را که به آن نیاز دارید، در طول آموزش اصلی نصب خواهید کرد.
+
+# نصب پیش‌نیازها
+
+در این آموزش شما یک وبلاگ خواهید ساخت. برای انجام این کار، در خلال روند آموزش، به شما نحوه‌ی نصب نرم‌افزارهای مختلف روی کامپیوترتان و نحوه‌ی راه اندازی چند حساب اینترنتی گفته خواهد شد. این بخش شامل تمام مراحل نصب و دستورالعمل‌های ثبت نام است (که برای بعضی از کارگاه‌ها مفید است).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# معرفی کوتاه کنسول خط فرمان {#command-line}
+
+بسیاری از مراحل زیر به "کنسول"، "ترمینال"، "پنجره دستورات" یا "خط فرمان" اشاره می‌کنند ـ همه آنها یک معنا دارند: یک پنجره روی کامپیوتر شما که می‌توانید دستوراتی را در آن وارد کنید. زمانی که به آموزش اصلی رسیدید، در مورد خط فرمان بیشتر می‌آموزید. فعلاً، اصلی‌ترین موردی که باید بدانید نحوه باز کردن یک پنجره خط فرمان و شکل ظاهری آن است: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# نصب پایتون {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# نصب یک ویرایشگر متنی {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# نصب محیط مجازی و نصب جنگو {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# نصب گیت {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# ساخت حساب کاربری GitHub {#github-account}
+
+به [GitHub.com](https://www.github.com) بروید و برای یک حساب کاربری جدید و رایگان،‌ ثبت نام کنید. از بخاطر سپردن رمز عبور خود اطمینان حاصل کنید (اگر از یک نرم افزار مدیریت رمزهای عبور استفاده میکنید، رمز عبور جدید را به آن اضافه کنید).
+
+# ساخت حساب کاربری PythonAnywhere {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# شروع کنید و آموزش‌ها را بخوانید
+
+تبریک، شما کاملاً آماده شروع هستید. اگر هنوز پیش از شروع کارگاه زمان دارید، خواندن بخش‌های ابتدایی برایتان مفید خواهد بود:
+
+* [اینترنت چگونه کار می‌کند](../how_the_internet_works/README.md)
+
+* [معرفی خط‌فرمان](../intro_to_command_line/README.md)
+
+* [معرفی پایتون](../python_introduction/README.md)
+
+* [جنگو چیست؟](../django/README.md)
+
+# از کارگاه لذت ببرید!
+
+زمانی که کارگاه را شروع کردید، می‌توانید مستقیماً به بخش [اولین پروژه جنگو شما](../django_start_project/README.md) بروید، چون قبلاً مطالب بخش‌های پیش از آن را مرور کرده اید.
\ No newline at end of file
diff --git a/fa-IR/intro_to_command_line/README.md b/fa-IR/intro_to_command_line/README.md
new file mode 100644
index 00000000000..4ee16eb9ab3
--- /dev/null
+++ b/fa-IR/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# آشنایی با خط فرمان
+
+> برای خوانندگان در خانه: این فصل در ویدئو [دوست جدید شما: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) توضیح داده شده است.
+
+هیجان انگیز است! شما تا چند دقیقه دیگر اولین خط کد خود را خواهید نوشت! :)
+
+**بگذارید شما را به اولین دوست جدیدتان معرفی کنیم: خط فرمان!**
+
+این مراحل به شما یاد می‌دهد که چطور از این پنجره سیاهی استفاده کنید که همه هکرها از آن استفاده می‌کنند. ممکن است در ابتدا کمی ترسناک به نظر بیاید ولی این فقط یک علامت است که نشان می‌دهد سیستم منتظر فرمان‌های شماست.
+
+> **نکته** توجه داشته باشید که در این دوره آموزشی ما بارها از دایرکتوری یا پوشه صحبت کرده ایم هر دو این مفاهیم یکی هستند.
+
+## خط فرمان چیست؟
+
+این پنجره که معمولاً **command line** یا **صفحه خط فرمان** گفته می‌شود یک نرم افزار مبتنی بر متن است که برای مشاهده، مدیریت و تغییر فایل‌ها از آن استفاده می‌شود. شباهت زیادی به ویندوز اکسپلورر یا فایندر در مک دارد با این تفاوت که اینترفیس گرافیکی ندارد. نام های دیگر خط فرمان این‌ها هستند: *cmd*, *CLI*, *prompt*, *console* ، *terminal*.
+
+## اینترفیس خط فرمان را باز کنید
+
+برای اینکه کمی تجربه کنیم باید ابتدا اینترفیس خط فرمان را باز کنید.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+شما صفحه‌ای سیاه یا سفید خواهید دید که منتظر دستورات شماست.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+اگر بر روی مک یا لینوکس کار می‌کنید، ممکن است یک علامت `$` ببینید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+بر روی ویندوز، احتمالاً علامت `>` را خواهید دید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    >
+    
+
+به بخش لینوکس در بالا نگاه کنید، چیزی که در آنجا می‌بینید بسیار شبیه چیزی است که در وبسایت PythonAnywhere و در ادامه این دوره آموزشی خواهید دید.
+
+<!--endsec-->
+
+هر دستور با یک پیشوند `$` یا `>` و یک اسپیس نشان داده شده‌اند، ولی شما نباید آن‌ها را تایپ کنید کامپیوتر آن را قبل از هر دستور شما گذاشته است. :)
+
+> یک نکته کوچک: ممکن است در کامپیوتر شما چیزهایی شبیه به `C:\Users\ola>` یا `Olas-MacBook-Air:~ ola$` قبل از علامت پرامت باشد که کاملاً طبیعی است.
+
+به بخشی که از ابتدای خط تا علامت `$` یا `>` را شامل می‌شود *command line prompt* یا به طور خلاصه *prompt* گفته می‌شود (prompt به معنی تشویق کردن و برانگیختن است). این علامت شما را تشویق می‌کند تا جلوی آن چیزی بنویسید.
+
+در این دوره آموزشی وقتی که از شما می‌خواهیم که دستوری را بنویسید، معمولاً در سمت چپ آن `$` یا `>` را گذاشته‌ایم. این تکه را در نظر نگیرید و فقط دستور را که بلافاصله بعد از پرامت قرار دارد تایپ کنید.
+
+## اولین دستور شما (وای!)
+
+بیایید با تایپ این دستور شروع کنیم:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+و سپس کلید `enter` را بزنید. نتیجه این خواهد بود:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+همانطور که می‌بینید کامپیوتر نام کاربری شما را نشان می‌دهد. جالب نیست؟ :)
+
+> برای امتحان کردن هر دستور آن را کپی نکیند. با تایپ کردن بهتر یاد خواهید گرفت!
+
+## اصول اولیه
+
+هر سیستم عامل، مجموعه دستورات کمی متفاوت برای خط فرمان، با دیگر سیستم عامل‌ها دارد، بنابراین مطمئن شوید که دستورالعمل‌های سیستم عامل خود را دنبال می‌کنید. حالا این را امتحان کنیم، آماده اید؟
+
+### دایرکتوری جاری
+
+بسیار خوب است که بفهمیم در کدام دایرکتوری هستیم. این دستور را تایپ کنید و کلید `enter` را بزنید:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> نکته: 'pwd' مخفف 'print working directory' به معنی 'دایرکتوری در حال اجرا را چاپ کن' است.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> نکته: 'cd' مخفف 'change directory' به معنی 'دایرکتوری را عوض کن'. در نرم افزار PowerShell در ویندوز شما می‌توانید مانند لینوکس یا مک از دستور pwd استفاده کنید.
+
+<!--endsec-->
+
+احتمالاً چیزی شبیه به این را بر روی کامپیوتر خود دیده اید. وقتی پنچره خط فرمان را باز می‌کنید معمولاً در دایرکتوری home اکانت کاربری خود هستید.
+
+* * *
+
+### چیزهای بیشتر در مورد یک فرمان
+
+بسیاری از فرمان‌هایی که شما می‌توانید در پرامت فرمان تایپ کنید یک راهنمای داخلی دارند که می‌توانید آن را ببینید و بخوانید! مثلاٌ برای آنکه در مورد فرمان دایرکتوری جاری بیشتر بدانید:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X و لینوکس یک فرمان `man` دارند که در مورد فرمان‌ها کمک زیادی می‌کند. دستور `man pwd` را امتحان کنید و ببینید که چه می‌شود. یا دستور `man` را قبل از فرمان‌های دیگر قرار دهید تا راهنمای داخلی آن‌ها را ببینید. خروجی فرمان `man` صفحه بندی شده است. با کمک کلید اسپیس به صفحه بعد بروید و با زدن `q` از راهنما خارج شوید.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+اضافه کردن یک پسوند `/?` به اکثر فرمان‌ها باعث می‌شود که صفحه راهنما نشان داده شود. لازم است صفحه را به سمت بالا اسکرول کنید تا تمام آن را ببینید. `cd /?` را امتحان کنید.
+
+<!--endsec-->
+
+### لیست کردن فایل‌ها و دایرکتوری‌ها
+
+چی توش هست؟ خوبه که بفهمیم. نگاه کنید:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> نکته: در PowerShell شما می‌توانید مانند لینوکس یا Mac OS X از دستور 'ls' استفاده کنید.<!--endsec-->
+
+* * *
+
+### تغییر دایرکتوری جاری
+
+حالا به دایرکتوری Desktop کامپیوترمان برویم:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ cd Desktop
+    
+
+توجه داشته باشید که ممکن است دایرکتوری Desktop به زبان کاربری تعیین شده در لینوکس شما ترجمه شود. اگر چنین اتفاقی افتاد لازم است که شما `Desktop` را با نام ترجمه شده عوض کنید؛ مثلاً برای زبان آلمانی با `Schreibtisch` عوض کنید.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+بررسی کنید که آیا واقعاً دایرکتوری جاری عوض شد:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+بله درست شد!
+
+> نکته حرفه‌ای: اگر شما تایپ کنید `cd D` و بعد کلید `tab` را بر روی کیبورد بزنید، خط فرمان ادامه فرمان شما را تایپ خواهد کرد بنابراین سریعتر می‌توانید حرکت کنید. اگر دایرکتوری هایی که با "D" شروع می‌شوند بیشتر از یکی باشند، با دوبار زدن کلید `tab` لیستی از آن‌ها را خواهید دید.
+
+* * *
+
+### ساختن دایرکتوری
+
+چطور است که یک دایرکتوری آزمایشی بر روی دسکتاپ بسازیم؟ به این روش می‌توانید انجام دهید:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+این دستور کوچک یک دایرکتوری به نام `practice` بر روی دسکتاپ شما خواهد ساخت. شما می‌توانید با اجرا کردن دستور `ls` یا `dir` بررسی کنید که آیا این دایرکتوری روی Desktop هست یا نه! آن را امتحان کنید. :)
+
+> نکته حرفه‌ای: اگر دوست ندارید یک دستور را بارها و بارها تایپ کنید، کلید `up arrow` یا جهت بالا و `down arrow` یا جهت پایین را بر روی کیبورد بزنید تا فرمان‌هایی که اخیراً زده اید را ببینید.
+
+* * *
+
+### تمرین!
+
+یک چالش کوچک برای شما: در این دایرکتوری `practice` که اخیراٌ ساخته اید، یک دایرکتوری به نام `test` بسازید. (از دستور `cd` و `mkdir` استفاده کنید.)
+
+#### راه حل:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+تبریک! :)
+
+* * *
+
+### پاک‌سازی
+
+نمی‌خواهیم همه جا را شلوغ کنیم، پس بیایید همه چیزهایی که ساخته ایم را پاک کنیم.
+
+اول از همه باید به Desktop برویم:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+استفاده کردن از `..` به همراه دستور `cd` باعث خواهد شد که به دایرکتوری parent بروید (parent دایرکتوری است که دایرکتوری جاری درون آن قرار دارد).
+
+بررسی کنید که کجا هستید:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+حالا وقت پاک کردن دایرکتوری `practice` است:
+
+> **توجه**: پاک کردن فایل‌ها با `del` یا `rmdir` یا `rm` غیر قابل بازگشت است به این معنی که *فایل‌های پاک شده برای همیشه از بین می‌روند*! بنابراین هنگام کار با این دستورها بسیار احتیاط کنید.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+انجام شد! برای اینکه مطمئن شوید پاک شده است آن را چک کنید:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### خروج
+
+برای الان کافی است! شما می‌توانید به راحتی خط فرمان را ببندید. بیایید به روش هکرها انجامش دهیم، باشه؟ :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+با حال بود، نه؟ :)
+
+## چکیده
+
+اینجا چکیده‌ای از دستورات مهم آورده شده:
+
+| دستورات (Windows) | دستورات (Mac OS / Linux) | توضیحات                     | مثال                                               |
+| ----------------- | ------------------------ | --------------------------- | -------------------------------------------------- |
+| exit              | exit                     | بستن پنجره خط فرمان         | **exit**                                           |
+| cd                | cd                       | تغییر دایرکتوری             | **cd test**                                        |
+| cd                | pwd                      | نشان دادن دایرکتوری جاری    | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | لیست کردن دایرکتوری/فایل ها | **dir**                                            |
+| copy              | cp                       | کپی کردن فایل               | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | جا به جا کردن فایل          | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | ساختن یک دایرکتوری جدید     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | حذف کردن یک فایل            | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | حذف کردن یک دایرکتوری       | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | دیدن راهنمای یک دستور       | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+این‌ها تعداد بسیار کمی از دستوراتی هستند که می‌توانید در خط فرمان اجرا کنید، اما امروز چیزی بیشتر از این‌ها لازم ندارید.
+
+اگر علاقمند هستید، وبسایت [ss64.com](http://ss64.com) مرجع کاملی از انواع فرمان‌ها برای سیستم عامل‌های مختلف دارد.
+
+## آماده هستید؟
+
+حالا در پایتون شیرجه بزنیم!
\ No newline at end of file
diff --git a/fa-IR/intro_to_command_line/open_instructions.md b/fa-IR/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..e6aff14474a
--- /dev/null
+++ b/fa-IR/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+بسته به نسخه ویندوز و نیز نوع کیبورد شما، یکی از موارد زیر برای شما یک command window یا خط فرمان باز خواهد کرد (شاید باید کمی امتحان کنید ولی لازم نیست تمام این پیشنهادات را آزمایش کنید):
+
+- به منوی استارت یا screen بروید و عبارت "Command Prompt" را در بخش جستجو وارد کنید.
+- این مسیر را دنبال کنید Start menu → Windows System → Command Prompt.
+- این مسیر را دنبال کنید Start menu → All Programs → Accessories → Command Prompt.
+- به بخش Start بروید و موس را روی صفحه تکان دهید و به گوشه پایین سمت چپ بروید و بر روی فلش به سمت پایین که ظاهر می‌شود کلید کنید (در یک سیستم تاچ اسکرین باید از پایین اسکرین را لمس کنید و دست خود را بالا بکشید). صفحه App ها باید باز شود. بر روی Command Prompt در بخش Windows System کلیک کنید.
+- کلید مخصوص Windows را بر روی کیبورد نگه دارید و دکمه "X" را بزنید. "Command Prompt" را از پنجره‌ای که باز می‌شود انتخاب کنید.
+- کلید Windows را نگه دارید و دکمه "R" را بزنید تا پنجره "Run" بازشود. تایپ کنید "cmd" و کلید OK را بزنید.
+
+![در پنجره "Run" بنویسید "cmd"](../python_installation/images/windows-plus-r.png)
+
+بعداً در این دوره آموزشی احتیاج دارید که دو پنجره خط فرمان به طور همزمان باز داشته باشید. با این حال در برخی نسخه‌های ویندوز، اگر یک پنجره خط فرمان باز داشته باشید و از همان روش برای باز کردن یک پنجره خط فرمان دیگری استفاده کنید به جای باز شدن پنجره جدید، همان قبلی دوباره نشان داده می‌شود. حالا روی کامپیوتر خود امتحان کنید و ببینید چه اتفاقی می‌افتد! اگر فقط یک پنجره خط فرمان دریافت کردید، یک روش دیگر از این لیست بالا را امتحان کنید. حداقل یکی از این‌ها باید یک پنجره جدید خط فرمان بازکند.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+به اینجا بروید Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+احتمالاً Applications → Accessories → Terminal یا Applications → System → Terminal است که بستگی به سیستم کامپیوتر شما دارد. اگر در این آدرس‌ها پیدا نکردید سعی کنید با جستجو در گوگل جای آن را پیدا کنید. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/fa-IR/python_installation/README.md b/fa-IR/python_installation/README.md
new file mode 100644
index 00000000000..53720da3016
--- /dev/null
+++ b/fa-IR/python_installation/README.md
@@ -0,0 +1,15 @@
+# بیایید پایتون را شروع کنیم
+
+بالاخره به اینجا رسیدیم!
+
+اما در ابتدا بگذارید که به شما بگوییم پایتون چیست. پایتون یک زبان برنامه نویسی بسیار رایج است که می‌تواند برای ساخت وبسایت، بازی‌ها، نرم افزارهای علمی، گرافیک و بسیاری امور دیگر استفاده شود.
+
+پایتون به اواخر دهه 1980 باز می‌گردد و هدف اصلی آن این بود که زبانی طراحی شود که خواندن آن برای افراد هم راحت باشد (و نه اینکه صرفاً ماشین‌ها راحت باشند!). به خاطر همین است که خواندن آن نسبت به بقیه زبان‌ها ساده تر است، اما نگران نباشید، پایتون واقعاً قدرتمند است!
+
+# نصب و راه اندازی پایتون
+
+> **نکته** اگر از Chromebook استفاده می‌کنید، از این بخش رد شوید و دستورالعمل‌های بخش [نصب Chromebook](../chromebook_setup/README.md) را پیگیری کنید.
+> 
+> **نکته** اگر مراحل [نصب و راه‌اندازی](../installation/README.md) را طی کرده‌اید، نیازی به انجام دوباره آن نیست. شما می‌توانید به بخش بعد بروید!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/fa-IR/python_installation/instructions.md b/fa-IR/python_installation/instructions.md
new file mode 100644
index 00000000000..946d037a67b
--- /dev/null
+++ b/fa-IR/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> برای خوانندگان در خانه: این فصل در ویدئو [نصب پایتون و ویرایشگر کد](https://www.youtube.com/watch?v=pVTaqzKZCdA) توضیح داده شده است.
+> 
+> این قسمت بر اساس دوره آموزشی Geek Girls Carrots نوشته شده است.(https://github.com/ggcarrots/django-carrots)
+
+جنگو با پایتون نوشته شده است. برای انجام هر کاری در جنگو، به زبان پایتون احتیاج داریم. بیایید با نصب پایتون شروع کنیم! ما می‌خواهیم شما آخرین نسخه پایتون 3 را نصب کنید، بنابراین اگر هرنسخه قدیمی تری دارید باید آن را به روزرسانی کنید. اگر پایتون نسخه {{ book.py_min_version }} یا بالاتر دارید، خوب است.
+
+حتی اگر بر روی کامپیوتر شما Anaconda نصب شده است، لطفاً پایتون معمولی را به روش زیر نصب کنید.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+ابتدا چک کنید که کامپیوتر شما دارای ویندوز 32-bit است یا 64-bit، در ردیف "System type" در صفحه System Info می‌توانید این را متوجه شوید. برای پیدا کردن این صفحه یکی از کارهای زیر را انجام دهید:
+
+* دکمه Windows و دکمه Pause/Break را همزمان روی کیبورد فشار دهید
+* Control Panel را از منو ویندوز باز کنید، سپس به System & Security بروید و بعد از آن به System بروید
+* دکمه Windows را فشار دهید، سپس مسیر Settings > System > About را دنبال کنید
+* منوی Start ویندوز را برای یافتن "System Information" جستجو کنید. برای این کار بر روی منوی Start کلیک کنید یا کلید Windows را بزنید، سپس شروع به تایپ کردن `System Information` کنید. این کار باعث خواهد شد پیشنهادهای مختلف در هنگام تایپ کردن به شما نشان داده شود. شما می‌توانید گزینه System Information‌ را به محض ظاهر شدن، انتخاب کنید.
+
+می‌توانید پایتون برای ویندوز را از وبسایت https://www.python.org/downloads/windows/ دانلود کنید. بر روی لینک "Latest Python 3 Release - Python x.x.x" کلیک کنید. اگر کامپیوتر شما نسخه **64-bit** ویندوز را اجرا می‌کند، **Windows x86-64 executable installer** را دانلود کنید. در غیر اینصورت، **Windows x86 executable installer** را دانلود کنید. پس از دانلود کردن اینستالر، باید آن را اجرا کنید (بر روی آن دوبار کلیک کنید) و دستورالعمل‌ها را دنبال کنید.
+
+نکته قابل توجه: در هنگام نصب پنجره‌ای را خواهید دید به نام "Setup". مطمئن شوید که گزینه "Add Python {{ book.py_version }} to PATH" یا "Add Python to your environment variables"را انتخاب کرده‌اید و سپس بر روی "Install Now" که اینجا می‌بینید، کلیک کنید (اگر نسخه‌‌های دیگری را نصب کنید ممکن است کمی با این متفاوت باشد):
+
+![فراموش نکنید که پایتون را به Path اضافه کنید](../python_installation/images/python-installation-options.png)
+
+وقتی که نصب کامل شد، یک پنجره خواهید دید که شما را به یک لینک برای آموزش بیشتر در مورد پایتون و نیز در مورد نسخه‌ای که نصب کرده‌اید ارجاع می‌دهد. این پنجره را کنسل کنید و یا ببندید - شما در همین دوره آموزشی بیشتر در مورد پایتون یاد خواهید گرفت!
+
+نکته: اگر از نسخه‌های قدیمی‌تر ویندوز استفاده می‌کنید (7، Vista یا نسخه‌های قدیمی‌تر) و نصب پایتون نسخه {{ book.py_version }} با خطا مواجه شد، تمام آپدیت‌های ویندوز را نصب کنید و دوباره برای نصب پایتون تلاش کنید. اگر همچنان با خطا مواجه شدید، سعی کنید پایتون نسخه {{ book.py_min_release }} را از [Python.org](https://www.python.org/downloads/windows/) نصب کنید.
+
+> جنگو {{ book.django_version }} به پایتون {{ book.py_min_version }} یا بالاتر نیاز دارد که ویندوز XP یا نسخه‌های قدیمی‌تر را پشتیبانی نمی‌کند.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **نکته** قبل از نصب پایتون بر روی OS X، باید مطمئن شوید که تنظیمات Mac‌، اجازه نصب پکیج‌هایی را که در App Store‌ نیستند، می‌دهد. به System Preferences بروید (در پوشه Applications است)، بر روی "Security & Privacy," کلیک کنید و به تب "General" بروید. اگر "Allow apps downloaded from:" بر روی "Mac App Store" تنظیم شده بود آن را به گزینه "Mac App Store and identified developers" تغییر دهید.
+
+شما باید به آدرس https://www.python.org/downloads/mac-osx/ بروید و آخرین نسخه پایتون را دانلود کنید: 
+
+* فایل *Mac OS X 64-bit/32-bit installer* را دانلود کنید،
+* بر روی *python-{{ book.py_release }}-macosx10.9.pkg* دوبار کلیک کنید تا نصب‌کننده نرم‌افزار فعال شود.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+احتمال زیادی دارد که شما بر روی کامپیوترتان پایتون داشته باشید. برای چک کردن آنکه آیا پایتون دارید (یا اینکه نسخه آن چیست)، یک کنسول باز کنید و دستورات زیر را تایپ کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+اگر نسخه نصب شده دیگری از پایتون دارید حداقل {{ book.py_min_version }} (یا مثلاً {{ book.py_min_release }})، نیازی به به‌‌روزرسانی ندارید. اگر پایتون نصب شده ندارید یا نسخه دیگری را می‌خواهید، اول باید به کمک دستورات زیر، کنترل کنید که از کدام توزیع لینوکس استفاده می‌کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+سپس بسته به نتیجه، یکی از روش‌های نصب زیر را به کار ببرید.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+این دستور را در کنسول تایپ کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+این دستور را در کنسول تایپ کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+اگر بر روی نسخه‌های قدیمی Fedora کار می‌کنید ممکن است پیغام خطایی بگیرید که `dnf` پیدا نشد. در این مورد، باید به جای آن از `yum` استفاده کنید.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+این دستور را در کنسول تایپ کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+برای بررسی موفقیت‌آمیز بودن نصب، یک خط فرمان باز کنید و دستور `python3</0 را جرا کنید:</p>
+
+<p>{% filename %}خط فرمان{% endfilename %}</p>
+
+<pre><code>$ python3 --version
+Python {{ book.py_release }}
+`</pre> 
+
+نسخه نمایش داده شده ممکن است با {{ book.py_release }} متفاوت باشد اما باید آن چیزی باشد که در موقع نصب انتخاب کرده‌اید.
+
+**نکته:** اگر بر روی ویندوز کار می‌کنید و خطای `python3` wasn't found را گرفتید، از دستور `python` (بدون `3`) استفاده کنید و ببنید آیا ممکن است که نسخه پایتون {{ book.py_min_version }} یا بالاتر باشد. اگر این کار هم موثر نبود، یک خط فرمان جدید بازکنید و دوباره تلاش کنید؛ اگر خط فرمان شما از قبل از نصب پایتون باز مانده باشد ممکن است چنین خطایی دریافت کنید.
+
+* * *
+
+اگر جایی تردید داشتید یا مشکل دیگری بوجود آمد که نمی‌دانستید چه باید بکنید، لطفاً از مربی خود کمک بگیرید! گاهی وقت‌ها اوضاع به خوبی پیش نمی‌رود و بهتر است از فرد باتجربه‌تری کمک بگیرید.
\ No newline at end of file
diff --git a/fa-IR/python_introduction/README.md b/fa-IR/python_introduction/README.md
new file mode 100644
index 00000000000..d476d7ab8c2
--- /dev/null
+++ b/fa-IR/python_introduction/README.md
@@ -0,0 +1,1071 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# آشنایی با پایتون
+
+> قسمت‌هایی از این بخش بر اساس دوره آموزشی Geek Girls Carrots طراحی شده است (https://github.com/ggcarrots/django-carrots).
+
+حالا بیایید کمی کد بنویسیم!
+
+## خط فرمان پایتون
+
+> > برای کسانی که در خانه مطالعه می‌کنند این بخش در ویدئو [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) توضیح داده شده است.
+
+برای آنکه با پایتون کار کنیم باید یک کنسول *خط فرمان* روی کامپیوتر خود باز کنید. احتمالا بلد هستید که چطور این کار را بکنید، در بخش [آشنایی با خط فرمان](../intro_to_command_line/README.md) آن را یاد گرفته‌اید.
+
+زمانی که آماده بودید، دستورالعمل‌های زیر را دنبال کنید.
+
+ما می‌خواهیم یک کنسول پایتون باز کنیم، پس در کنسول خط فرمان ویندوز `python` و در ترمینال لینوکس/ مک `python3` را تایپ کنید و `enter` بزنید.
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## اولین دستور پایتونی شما!
+
+پس از اجرای دستور Python، خط فرمان به `>>>` تغییر می‌کند. این تغییر برای ما به معنای آن است که در حال حاضر فقط می‌توانیم از دستورات زبان پایتون استفاده کنیم. شما نیازی به تایپ `>>>` ندارید - خط فرمان پایتون این کار را برایتان میکند.
+
+اگر هر زمان قصد خروج از خط فرمان پابتون را داشتید `exit()` را تایپ کنید یا از `Ctrl + Z` در ویندوز و `Ctrl + D` در مک/لینوکس استفاده کنید. پس از خروج `>>>` را دیگر نمی‌بینید.
+
+ما الان نمی‌خواهیم از خط فرمان پایتون خارج شویم. ما می‌خواهیم چیزهای بیشتری در مورد آن یاد بگیریم. بیایید با کمی ریاضیات شروع کنیم، مانند `2 + 3`3 و زدن `enter`.
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+خوبه! دیدید که جواب چگونه ظاهر شد؟ پایتون ریاضیات را می‌فهمد! می‌توانید دستور دیگری مثل این را امتحان کنید:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+برای اجرای محاسبات نمایی، مانند ۲ به توان ۳، تایپ میکنیم: {% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+کمی با دستورات مختلف محاسباتی تفریح کنید و دوباره آموزش را ادامه دهید. :)
+
+همانطور که می‌بینید، پایتون محاسبه‌گر بسیار خوبی است. آیا به این فکر می‌کنید که چه کارهای دیگری می‌شود انجام داد…
+
+## رشته‌های متنی
+
+چطور است با اسم شما شروع کنیم؟ نام خود را بین علامت نقل قول به صورت زیر بنویسید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+شما همین الان اولین رشته متنی خود را ساختید! رشته متنی دنباله‌ای از کاراکترها است که می‌توان آن‌ها را توسط کامپیوتر پردازش کرد. رشته متنی همواره باید با یک علامت شروع، و با همان پایان یابد. این علامت ممکن است نقل قول تکی یا آپاستروف (`'`) یا نقل قول دوتایی (`"`) باشد (در پایتون بین این دو فرقی نیست) این علامت ها به پایتون میگویند که حاوی یک رشته متنی هستند.
+
+رشته ها می‌توانند به همدیگر الحاق شوند. دستور زیر را امتحان کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+همچنین میتوانید یک رشته را در یک عدد ضرب کنید، رشته به تعداد آن عدد تکرار می‌شود:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+اگر نیاز داشتید تا یک علامت آپاستروف داخل رشته بیاورید، دو راه دارید.
+
+استفاده از علامت نقل قول دوتایی:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+یا استفاده از یک بک اسلش (``) پیش از علامت آپاستروف:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+خوب است، نه؟ برای دیدن نام خود با حروف بزرگ، تایپ کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+شما همین الان از **متد** `upper` روی رشته متنی استفاده کردید! یک متد (مانند `upper()`) دنباله‌ای از دستورات پایتونی است. زمانی که متد را صدا بزنید، آن دستورات روی یک شی ورودی (`"Ola"`) اعمال می‌شود.
+
+آیا می‌خواهید تعداد حروف نام خود را بدانید؟ یک **تابع** برای این کار هم هست!
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+به این فکر می‌کنید که چرا گاهی تابع را با یک `.` در انتهای یک رشته صدا می‌کنیم (مانند `"Ola".upper()`) و گاهی ابتدا یک تابع را صدا می‌زنیم و رشته را جلوی نام تابع داخل پرانتز می‌گذاریم؟ در بعضی موارد، توابع به اشیا تعلق دارند، مانند `upper()` ، که فقط میتواند روی رشته‌های متنی اعمال شود. در این موارد، تابع را یک **method** می‌نامیم. در موارد دیگر، توابع به چیزی تعلق ندارند و می‌توان آنها را روی انواع مختلفی از اشیا استفاده کرد، درست مانند `len()`. به همین دلیل است که `"Ola"` را به عنوان یک پارامتر ورودی به تابع `len` می‌دهیم.
+
+### چکیده
+
+بسیار خب، صحبت راجع به رشته‌ها کافی است. تا اینجا شما موارد زیر را یاد گرفته‌اید:
+
+- **خط فرمان** - تایپ دستورات (کد) و دیدن نتایج در خط فرمان پایتون
+- ** اعداد و رشته‌های متنی** - در پایتون اعداد برای محاسبات ریاضی و رشته‌ها به عنوان اشیا متنی استفاده می‌شوند
+- **عملگرها** مانند `+` و `*`، برای ساخت یک مقدار جدید، چند مقدار را با هم ترکیب می‌کنند
+- **توابع**- مانند `upper()` و `len()`، که بر روی اشیا، اعمالی را انجام می‌دهند.
+
+موارد گفته شده، مبانی تمام زبان‌های برنامه‌نویسی است که ممکن است بعدا بیاموزید. برای کارهای سخت‌تر آماده هستید؟ حتماً آماده‌اید!
+
+## خطاها
+
+بیایید چیز جدیدی را امتحان کنیم. می‌توانیم طول یک عدد را همانطور که طول نام خودمان را پیدا می‌کنیم، به دست آوریم؟ تایپ کنید`len(304023)` و `enter` را بزنید:
+
+{% filename %}{{ warning_icon }} خط فرمان{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+اولین خطا را دریافت کردیم! به وسیله آیکن {{ warning_icon }} به شما اعلام می‌کنیم کدی که قرار است اجرا کنید، مطابق انتظار شما اجرا نخواهد شد. اشتباه کردن (حتی اشتباهات عمدی) بخش مهمی از یادگیری است!
+
+خطای دریافتی می‌گوید اشیا نوع "int" (اعداد طبیعی)، صفت "طول" ندارند. خب پس حالا چه کاری می‌توانیم بکنیم؟ می‌توانیم عددمان را به عنوان یک رشته متنی بنویسیم؟ رشته‌های متنی دارای طول هستند، درست است؟
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+کار کرد! ما از تابع `str` داخل تابع `len` استفاده کردیم. `str()` هرچیزی را به رشته متنی تبدیل می کند.
+
+- تابع `str` ورودی‌اش را به **strings** تبدیل می‌کند
+- تابع `int` ورودی‌اش را به **integers** تبدیل می‌کند
+
+> توجه: ما می‌توانیم اعداد را به متن تبدیل کنیم، اما همیشه نمی‌توان متن را به عدد تبدیل کرد - مثلا خروجی `int('hello')` چه چیزی می‌تواند باشد؟
+
+## متغیرها
+
+یکی از مفاهیم مهم در برنامه‌نویسی، مفهوم متغیرها است. متغیر نامی است برای یک مقدار که بعدا بتوانید برای ارجاع به آن مقدار، از نام متغیر استفاده کنید. برنامه‌نویس‌ها از این متغیرها برای ذخیره داده، و بالا بردن خوانایی کد استفاده می‌کنند تا مجبور نباشند همه‌چیز را در ذهن نگه‌دارند.
+
+بیایید یک متغیر جدید به نام `name` بسازیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> name = "sara"
+```
+
+تایپ می‌کنیم name مساوی sara.
+
+همانطور که توجه کردید، برنامه شما مانند دفعات قبل خروجی نداد. پس از کجا بدانیم متغیر واقعا وجود دارد؟ نام متغیر `name` را وارد کنید و `enter` بزنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> name
+'sara'
+```
+
+بلههههه! اولین متغیر شما!‌ :) همواره می‌توانید چیزی را که متغیر به آن ارجاع می‌دهد، تغییر دهید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> name = "Mahsa"
+>>> name
+'Mahsa'
+```
+
+می‌توانید از آن در توابع نیز استفاده کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+عالی است، نه؟ متغیرها می‌توانند هرچیزی باشند- مثل اعداد! این یکی را امتحان کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+ولی اگر نام اشتباه را استفاده کنیم چه می‌شود؟ می‌توانید حدس بزنید چه اتفاقی می‌افتد؟ بیایید امتحان کنیم!
+
+{% filename %}{{ warning_icon }} خط-فرمان{% endfilename %}
+
+```python
+>>> city = "Tehran"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+یک خطا! همانطور که می‌بینید، پایتون دارای انواع مختلفی از خطاها است و این یکی خطا **NameError** نام دارد. اگر سعی کنید از متغیری که هنوز تعریف نشده استفاده کنید، پایتون این خطا را به شما می‌دهد. اگر بعداً به این خطا برخورد کردید، کد خود را برای اشتباه تایپی در نام متغیرها چک کنید.
+
+کمی این موارد را امتحان کنید تا ببینید چه کارهایی می‌توانید با آن انجام دهید!
+
+## تابع print
+
+این را امتحان کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> name = 'Mahsa'
+>>> name
+'Mahsa'
+>>> print(name)
+Mahsa
+```
+
+زمانی که فقط `name` را تایپ می‌کنید، مفسر پایتون با *ارائه‌ای* از رشته متنی داخل متغیر 'name' پاسخ می‌دهد، که این پاسخ دنباله کاراکترهای M-a-h-s-a درون علامت نقل قول است. وقتی که `print(name)` را اجرا می‌کنید، پایتون محتوای متغیر را در صفحه نمایش نشان می‌دهد، البته بدون علامت‌های نقل قول که مرتب‌تر است.
+
+بعداً خواهیم دید که `print()` زمانی که می‌خواهیم از داخل توابع چیزی را نمایش دهیم، یا زمانی که می‌خواهیم چندین خط از متن را نمایش دهیم، نیز مفید است.
+
+## لیست‌ها
+
+پایتون علاوه بر رشته ها و اعداد، انواع مختلفی از اشیا را دارد. و الان نوعی از اشیا را معرفی می‌کنیم که **list** نام دارند. لیست‌ها دقیقا همان چیزی هستند که فکرش را می‌کنید: یک نوع شی که خودش لیستی از اشیای دیگر است. :)
+
+حالا یک لیست بسازید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+بله، این لیست خالی است. آنقدر مفید نیست، درست است؟ بیایید یک لیست از اعداد بخت آزمایی بسازیم. ما نمی‌خواهیم یک عدد تکراری را انتخاب کنیم، پس اعداد بخت آزمایی را داخل یک متغیر می‌گذاریم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+بسیار خب، ما یک لیست داریم! چه کاری می‌توانیم با آن انجام دهیم؟ بیایید ببینیم چه تعداد عدد بخت آزمایی درون لیست داریم. هیچ ایده‌ای درمورد این که از چه تابعی باید استفاده کنیم، دارید؟ از قبل این را می‌دانید!
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+بله! تابع `len()` می‌تواند تعداد اشیای درون لیست را بدهد. بسیار مفید، درست است؟ حالا بیایید لیستمان را مرتب کنیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+این یکی هیچ خروجی نداد، بلکه فقط ترتیب قرارگرفتن اعداد در لیست را تغییر داد. بیایید دوباره لیست را چاپ کنیم و ببینیم چه اتفاقی افتاده:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+همانطور که می‌بینید، اعداد درون لیست از کمترین مقدار به بیشترین مقدار مرتب شده‌اند. تبریک!
+
+شاید بخواهیم ترتیب اعداد را برعکس کنیم. بیایید انجامش دهیم!
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+اگر می‌خواهید چیزی به لیست خود اضافه کنید، می‌توانید این دستور را تایپ کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+اگر می‌خواهید فقط عدد اول را نمایش دهید، می‌توانید این کار با استفاده از **indexes** انجام دهید. ایندکس شماره‌ای است که نشان دهنده محل قرار گرفتن یک آیتم در لیست است. برنامه‌نویس‌ها ترجیح می‌دهند شمردن را از 0 شروع کنند. پس شماره اولین شی در لیست 0 است، بعدی 1 است و الی آخر. دستور زیر را امتحان کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+همانطور که می‌بینید، می‌توانید به اشیاء مختلف موجود در لیست به کمک نام لیست و ایندکس آن شیء که درون یک براکت آمده باشد، دسترسی پیدا کنید.
+
+برای حذف چیزی از داخل لیست، باید همانطور که در بالا یاد گرفتیم، از **ایندکس** و متد `pop()` استفاده کنید. بیایید یک مثال را امتحان کنیم و چیزی را که قبلا یاد گرفتیم، بهبود دهیم؛ ما اولین عدد لیست را حذف خواهیم کرد.
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+مانند یک افسون عمل کرد!
+
+برای تفریح بیشتر، باقی ایندکس ها را نیز امتحان کنید:6 ،7، 1000، -1، -6، یا -1000. ببینید می‌توانید نتیجه را پیش از اجرای دستور، پیش بینی کنید؟ نتایج برای شما معنایی دارند؟
+
+می توانید لیستی از متدهای مربوط به لیست‌ها را در این بخش از مستندات پایتون پیدا کنید: https://docs.python.org/3/tutorial/datastructures.html
+
+## دیکشنری‌ها
+
+> برای خوانندگان داخل خانه: این قسمت در ویدئوهای بخش [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) پوشش داده شده است.
+
+دیکشنری شبیه به لیست است، ولی برای دسترسی به مقادیر باید از کلیدها به جای ایندکس‌های عددی استفاده کنید. یک کلید می‌تواند رشته متنی و یا عدد باشد. دستور زبان تعریف یک دیکشنری خالی این است:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+خروجی نشان می‌دهد که یک دیکشنری خالی ساخته‌اید. هورررااا!
+
+حالا سعی کنید که دستور زیر را بنویسید (سعی کنید اطلاعات خود را نیز جایگزین کنید):
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> participant = {'name': 'Mahsa', 'country': 'Iran', 'favorite_numbers': [7, 42, 92]}
+```
+
+با این دستور، یک متغیر به نام `participant` شامل سه جفت کلید-مقدار ساخته‌اید:
+
+- کلید `name` به مقدار `Mahsa` (یک شی `string` ) اشاره می‌کند
+- کلید `country` به `'Iran'` (یک `string` دیگر) اشاره می‌کند
+- و کلید `favorite_numbers` به `[7, 42, 92]` اشاره می‌کند (یک `لیست` با سه عدد داخل آن).
+
+می‌توانید محتوای هر کلید را طبق دستور زیر به تنهایی چک کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Mahsa
+```
+
+ببینید، دیکشنری مشابه یک لیست است. ولی نیازی نیست که ایندکس ها را بخاطر بیاورید - فقط کافی است نام کلید را بدانید.
+
+اگر مقدار کلیدی را که وجود ندارد از پایتون درخواست کنیم چه اتفاقی می‌افتد؟ می‌توانید حدس بزنید؟ بیایید امتحان کنیم و ببینیم!
+
+{% filename %}{{ warning_icon }} خط فرمان{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+ببینید، یک خطای دیگر! این یکی **KeyError** است. پایتون به شما کمک می‌کند و می‌گوید که کلید `'age'` در دیکشنری وجود ندارد.
+
+چه زمانی از لیست و چه زمانی از دیکشنری باید استفاده کرد؟ نکته خوبی است. قبل از دیدن خط بعد به پاسخ فکر کنید.
+
+- یک دنباله ترتیبی از آیتم ها نیاز دارید؟ لیست را انتخاب کنید.
+- آیا نیاز است کلیدها و مقادیر را به همدیگر ارتباط دهید، که بعدا بتوانید به صورت کارآمد مقادیر را بوسیله کلیدها جستجو کنید؟ از یک دیکشنری استفاده کنید.
+
+دیکشنری‌ها، مانند لیست‌ها *تغییر پذیر* هستند، به معنای آن که می‌توان آن‌ها را پس از ساخت، تغییر داد. می‌توانید پس از ساختن دیکشنری، جفت کلید-مقدار جدید به آن اضافه کنید، مانند زیر:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+استفاده از متد `len()` روی دیکشنری، مانند لیست‌ها، تعداد جفت‌های کلید-مقدار را برمی‌گرداند. دستور زیر را تایپ کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+امیدواریم تا اینجا همه چیز برایتان روشن باشد. :) آماده تفریح بیشتر با دیکشنری‌ها هستید؟ ادامه آموزش را بخوانید تا با چیزهای شگفت انگیز روبرو شوید.
+
+می‌توانید از متد `pop()` برای حذف یک آیتم از دیکشنری استفاده کنید. برای مثال، اگر می‌خواهید مدخل مربوط به کلید `'favorite_numbers'` را حذف کنید، دستور زیر را تایپ کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Iran', 'favorite_language': 'Python', 'name': 'Mahsa'}
+```
+
+همانطور که در خروجی مشاهده می‌کنید، کلید مقدار متناظر با 'favorite_numbers' حذف شده است.
+
+به همین شکل، می‌توانید مقدار مربوط به یک کلید موجود در دیکشنری را تغییر دهید. این را تایپ کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Mahsa'}
+```
+
+همانطور که می‌توانید ببینید مقدار کلید `'country'` از `'Iran'` به `'Germany'` تغییر پیدا کرده‌است. :) هیجان انگیز نیست؟ هورا! همین الان یک مورد شگفت انگیز دیگر یاد گرفتید.
+
+### چکیده
+
+بسیار عالی! الان چیزهای زیادی راجع به برنامه‌نویسی می‌دانید. در همین قسمت آخر شما موارد زیر را آموختید:
+
+- **خطاها** - اگر پایتون دستوری را متوجه نشود و خطایی را نشان دهد، حالا شما می‌دانید چطور آن خطا را بخوانید و درک کنید
+- **متغیرها** - نام‌هایی برای اشیا هستند که شما را قادر می‌سازد راحت تر کد بزنید و کد شما را خواناتر می‌کند
+- **لیست‌ها** - لیستی از اشیا که در یک ترتیب خاص ذخیره شده‌اند
+- **دیکشنری‌ها** - اشیایی که به عنوان جفت‌های کلید-مقدار ذخیره شده‌اند
+
+برای بخش بعدی هیجان زده‌اید؟ :)
+
+## مقایسه اشیا
+
+> برای خوانندگان داخل خانه: این قسمت در ویدئو های بخش [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) پوشش داده شده است.
+
+بخش بزرگی از برنامه‌نویسی شامل مقایسه اشیا است. مقایسه چه چیزهایی از همه راحت‌تر است؟ اعداد! بیایید نحوه کارکرد آن را ببینیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+ما به پایتون تعدادی عدد برای مقایسه کردن داده‌ایم. همانطور که می‌بینید، پایتون نه تنها می‌تواند اعداد را مقایسه کند بلکه می‌تواند عبارت‌های ریاضی مانند `2 * 2` و متدهایی همچون `len([4, 5])` که نتیجه `2` را می‌دهد نیز با هم مقایسه کند. جالب است، نه؟
+
+آیا به این فکر کرده‌اید که چرا دو علامت مساوی `==` کنار هم برای چک کردن تساوی اعداد گذاشته‌ایم؟ ما از یک علامت مساوی `=` برای انتساب مقادیر به متغیرها استفاده می‌کنیم. اگر می‌خواهید مساوی بودن دو شی با همدیگر را چک کنید، همیشه و **همیشه** باید از دو علامت مساوی `==` استفاده کنید. همچنین می‌توانیم مساوی نبودن اشیا را تعیین کنیم. برای این منظور، از علامت `=!`، همانطور که در مثال بالا نشان داده شده است، استفاده می‌کنیم.
+
+دو تمرین دیگر با پایتون انجام بدهید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+ما `>` و `<` را دیدیم، ولی `>=` و `<=` چه معنایی دارد؟ آنها را به این صورت بخوانید:
+
+- x `>` y یعنی‌: x بزرگتر از y است
+- x `<` y یعنی: x کوچکتر از y است
+- x `<=` y یعنی: x کوچکتر یا مساوی y است
+- x `>=` y یعنی: x بزرگتر یا مساوی y است
+
+بسیارعالی! می‌خواهید بیشتر با آن کار کنید؟ این را امتحان کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+می‌توانید هر تعداد عدد که می‌خواهید برای مقایسه به پایتون بدهید، و او به شما جواب بدهد! بسیار زیرکانه است، نه؟
+
+- **and** - اگر شما از عملوند `and` استفاده کنید، هر دو مقایسه باید True باشند تا کل عبارت True ارزیابی شود
+- **or** - اگر شما از عملوند `or` استفاده می‌کنید، Trueبودن یکی از مقایسه ها کافی است تا کل عبارت True ارزیابی شود
+
+آیا عبارت " مقایسه سیب با پرتقال" را شنیده‌اید؟ بیایید نسخه پایتونی آن را امتحان کنیم:
+
+{% filename %}{{ warning_icon }} خط فرمان {% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+همانطور که در عبارت بالا می‌بینید، پایتون قادر نیست یک رشته (`str`) و یک عدد (`int`) را با هم مقایسه کند. درعوض، یک **TypeError** نشان می‌دهد و به ما می‌گوید که دو نوع نمی‌توانند با یکدیگر مقایسه شوند.
+
+## Boolean
+
+در حقیقت شما با نوع جدیدی از اشیا در پایتون آشنا شدید. به نام **Boolean** بولیَن.
+
+فقط دو نوع شی بولین وجود دارد:
+
+- True - درست
+- False - نادرست
+
+برای اینکه پایتون این نوع را بشناسد، باید همیشه آن را به صورت 'True' بنویسید (حرف اول بزرگ، و باقی حروف کوچک). **true, TRUE, و tRUE را نخواهد شناخت - فقط Trueدرست است.** ( برای False هم همینطور.)
+
+بولین ها می توانند به صورت متغیر باشند، اینجا را ببینید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+می‌توانید به این صورت نیز انجامش دهید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+با اجرای دستورات زیر، با بولین ها تفریح و تمرین کنید:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 =! 2`
+
+تبریک! بولین‌ها یکی از جالب ترین ویژگی‌های برنامه‌نویسی هستند، و شما همین الان یاد گرفتید چطور از آن‌ها استفاده کنید!
+
+# ذخیره کنید!
+
+> برای خوانندگان داخل خانه: این قسمت در ویدئو های بخش [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) پوشش داده شده است.
+
+تا اینجا ما تمام کدهای پایتون خود را در مفسر خط فرمان نوشته‌ایم، که ما را محدود به ورود یک خط از کد در یک زمان می‌کرد. برنامه‌های نرمال در فایل ذخیره می‌شوند و به وسیله **مفسر** یا **کامپایلر** زبان برنامه‌نویسی اجرا می‌شوند. تا اینجا ما برنامه‌هایمان به صورت - هربار، یک خط - در **مفسر** پایتون اجرا کردیم. برای تمرین‌های بعدی به بیش از یک خط کد نیاز خواهیم داشت، پس ما نیاز داریم تا سریعاً:
+
+- از مفسر پایتون خارج شویم
+- ویرایشگر متنی دلخواه خود را نصب کنیم
+- چندخط کد در فایل جدید پایتون ذخیره کنیم
+- آن را اجرا کنیم!
+
+برای خروج از مفسر پایتونی که در حال استفاده از آن هستیم، تابع `exit()` را تایپ کنید
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+>>> exit()
+```
+
+این عمل شما را به خط فرمان بازمی‌گرداند.
+
+پیش از این، ما یک ویرایشگر متنی از بخش [ویرایشگر متن](../code_editor/README.md) انتخاب کردیم. حالا باید ویرایشگر را باز کنیم و چند خط کد در یک فایل جدید بنویسیم (یا اگر از یک کروم بوک استفاده می کنید، یک فایل جدید روی cloud IDE بسازید و فایل را باز کنید):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+به وضوح، حالا شما یک توسعه دهنده پایتون کاربلد هستید، پس کمی از کدهایی که امروز یاد گرفتید را بنویسید.
+
+حالا باید فایل را ذخیره کنیم و یک نام توصیفی به آن بدهیم. بیایید فایل را **python_intro.py** نامگذاری کنیم و آن را روی صفحه دسکتاپ ذخیره کنیم. می‌توانیم به فایل هر نامی که می‌خواهیم بدهیم، ولی پایان یافتن فایل با **.py** مهم است. پسوند **.py** به سیستم عامل می‌گوید که این یک **فایل اجرایی پایتون** است و پایتون می تواند آن را اجرا کند.
+
+> **توجه** شما باید به یکی از جالب‌ترین ویژگی‌های ویرایشگر کد دقت کنید: رنگ‌ها! در کنسول پایتون، همه چیز به یک رنگ بود، حالا شما می‌توانید ببینید که تابع `print` رنگ متفاوتی با رشته متنی دارد. به این ویژگی "برجسته سازی دستوری " می‌گویند، که ویژگی بسیار مفیدی برای کد زدن است. رنگ چیزها شما را راهنمایی می‌کند، مانند رشته متنی بسته نشده یا غلط دیکته ای در کلمات کلیدی (مانند `def` در یک تابع که در ادامه خواهیم دید). این یکی از دلایلی است که از ویرایشگر کد استفاده می‌کنیم. :)
+
+وقتی فایل را ذخیره کردیم وقت آن است که آن را اجرا کنیم! ار مهارت‌هایی که در بخش خط فرمان گفتیم استفاده کنید، از ترمینال برای **تغییر دایرکتوری** به دسکتاپ استفاده کنید.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+بر روی Mac، فرمان‌ها شبیه به این خواهد بود:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+بر روی لینوکس شبیه به این است:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(به یاد داشته باشید که ممکن است کلمه "Desktop" به زبان منتخب شما ترجمه شده باشد.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+در خط فرمان ویندوز، شبیه به این است:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+بر روی پاورشل ویندوز، شبیه به این است:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+اگر گیر کردید تقاضای راهنمایی کنید. مربی‌ها برای همین کار در کنار شما هستند!
+
+حالا از پایتون استفاده کنید تا کدهای موجود در فایل را اجرا کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+نکته: در ویندوز 'pyhton3' یک دستور محسوب نمیشود. به جای آن از 'python' برای اجرای فایل استفاده کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+بسیار خب! شما اولین برنامه پایتون خود را که در یک فایل ذخیره شده بود اجرا کردید. فوق العاده نیستید؟
+
+حالا شما می‌توانید به سراغ یکی از ابزارهای ضروری برنامه نویسی بروید:
+
+## If … elif … else
+
+بسیاری از کدها تنها زمانی باید اجرا شوند که شروط داده شده درست باشند. به همین دلیل پایتون چیزی به نام دستور شرطی - **دستور if** دارد.
+
+کد خود را در فایل **python_intro.py** با این جایگزین کنید:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+اگر ما این را ذخیره و اجرا کنیم، خطایی مانند زیر را مشاهده می‌کنیم:
+
+{% filename %}{{ warning_icon }} خط-فرمان{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+پایتون انتظار دارد که ما مشخص کنیم اگر شرط `3 > 2` درست باشد چه دستوری باید اجرا شود (یا به صورت صحیح‌تر شرط `True` باشد). بیایید کاری کنیم که در صورت درست بودن شرط، پایتون در خروجی بنویسد: “It works!”. کد را در فایل **python_intro.py** به این تغییر دهید:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+به تورفتگی خط بعدی کد به اندازه 4 اسپیس دقت کردید؟ به این تورفتگی ها نیاز داریم تا پایتون بداند در صورت درست بودن شرط کدام دستورات را اجرا کند. می توانید از یک اسپیس استفاده کنید، ولی تقریبا همه برنامه‌نویسان پایتون برای تمیزی و خوانایی کد از 4 اسپیس استفاده می کنند. همچنین می‌توانید ویرایشگر کد خود را طوری تنظیم کنید تا یک tab به عنوان 4 اسپیس محسوب شود. زمانی که انتخاب خود را تعیین کردید، آن را تغییر ندهید! اگر تورفتگی را با 4 اسپیس انجام می‌دهید، تمام تورفتگی های بعدی را با 4 اسپیس انجام دهید، درغیر این صورت به مشکل برمی‌خورید.
+
+فایل را ذخیره کنید و بار دیگر اجرا کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+توجه: یادتان باشد که در ویندوز 'python3' به عنوان یک دستور شناخته نمی‌شود. از الان به بعد 'python3' را با 'python' برای اجرای فایل ها جایگزین کنید.
+
+### چه می‌شود اگر یک شرط True نباشد؟
+
+در مثال قبلی، کد تنها زمانی اجرا می‌شد که شرط‌ها درست بودند. ولی پایتون دستورات `elif` و `else` هم دارد:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+وقتی آن را اجرا کنید، خروجی زیر را نمایش می‌دهد:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+اگر 2 عدد بزرگتری از 5 بود، دستور دوم اجرا می‌شد. بیایید نحوه کار `elif` را ببینیم:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+و اجرا کنید:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+دیدید چه اتفاقی افتاد؟ `elif` شما را قادر میسازد تا شرط های بیشتری اضافه کنید تا اگر شروط قبلی درست نبودند، شروط جدید ارزیابی شوند.
+
+میتوانید هر تعداد `elif` که خواستید پس از `if` اولیه اضافه کنید، به عنوان مثال:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+پایتون تمام شرط ها را به ترتیب ارزیابی می‌کند و چاپ می‌کند:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## کامنت‌ها
+
+کامنت‌ها خطوطی هستند که با `#` شروع می‌شوند. می‌توانید بعد از `#` هر توضیحاتی راجع به کد بنویسید و پایتون آن را نادیده می‌گیرد. کامنت‌ها می‌توانند کد شما را برای دیگران خواناتر کنند.
+
+بیایید ببینیم چطور دیده می‌شود:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+نیازی نیست برای هر خط کد کامنت بنویسید، ولی برای توضیح اینکه چرا کد شما کاری را انجام می‌دهد یا برای داشتن یک خلاصه، زمانی که کد کار پیچیده‌ای را انجام می‌دهد، مفید اند.
+
+### چکیده
+
+در تمرین های اخیر شما موارد زیر را یاد گرفتید:
+
+- **مقایسه اشیا** - در پایتون می‌توانید اشیا را به وسیله `>` و `>=` و `==` و `<=` و `<` و عملگرهای `and` و `or` مقایسه کنید
+- **بولین‌ها** - نوعی از اشیا که می‌تواند فقط دو مقدار معتبر بگیرد: `True` یا `False`
+- ** ذخیره فایل‌ها** - ذخیره کردن کدها در فایل تا بتوانید برنامه‌های بزرگتری را اجرا کنید.
+- **if … elif … else** - دستوراتی که شما را قادر می‌سازد کدها را زمانی اجرا کنید که شروط مشخصی درست باشند.
+- **کامنت‌ها** - خطوطی که پایتون آن‌ها را به عنوان کد اجرا نمی‌کند، و به شما اجازه می‌دهد تا کد خود را مستند سازی کنید
+
+زمان آخرین بخش از این فصل رسیده است!
+
+## تابع خودتان را بنویسید!
+
+> برای خوانندگان داخل خانه: این قسمت در ویدئو های بخش [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) پوشش داده شده است.
+
+توابعی مانند `len()` را که می‌توانید در پایتون اجرا کنید، به خاطر دارید؟ بسیار خوب - شما الان یاد می‌گیرید که چطور تابع خود را بنویسید!
+
+یک تابع دنباله‌ای از دستورات است که پایتون باید اجرا کند. همه توابع در پایتون با کلمه کلیدی `def` شروع می شوند، نام می‌گیرند و می‌توانند پارامترهای ورودی داشته باشند. بیایید امتحانش کنیم. کد داخل فایل **python_intro.py** را با این جایگزین کنید:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+خب، اولین تابع ما آماده است!
+
+شاید فکر می‌کنید که چرا نام تابع را در انتهای فایل نوشته‌ایم. وقتی که ما عبارت `def hi():` و خطوط تو رفته زیر آن را می‌نویسیم، دستورالعمل‌هایی را که باید توسط تابع `hi()` اجرا شوند مشخص می‌کنیم. پایتون این دستورالعمل‌ها را می‌خواند و به یاد می‌آورد اما آن را اجرا نمی‌کند. برای آنکه به پایتون بگوییم که این تابع را اجرا کند، باید تابع را فراخوانی کنیم یا آن را با عبارت `hi()` صدا بزنیم. پایتون فایل را می‌خواند و آن را از بالا به پایین اجرا می‌کند، بنابراین ما باید قبل از صدا زدن آن، عملکرد تابع را در فایل تعریف کرده باشیم.
+
+بیایید این را اجرا کنیم و ببینیم چه اتفاقی می‌افتد:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+توجه: اگر درست کار نکرد، نترسید! خروجی به شما کمک می کند دلیل آن را بفهمید:
+
+- اگر یک خطای `NameError` دریافت کردید، احتمالا چیزی را اشتباه تایپ کرده‌اید، پس چک کنید که از نام یکسانی موقع ساختن تابع با `def hi():` و صدا کردن آن با `hi()` استفاده کرده‌باشید.
+- اگر یک خطای `IndentationError` دریافت کردید، چک کنید که هر دو دستور `print` تورفتگی یکسانی دارند: پایتون می‌خواهد که تمام کدهای داخل تابع به درستی قرار بگیرند و هم راستا باشند.
+- اگر اصلا چیزی چاپ نشده، چک کنید که آخرین `hi()` تورفته *نباشد* - اگر تورفتگی داشته‌باشد، بخشی از کد تابع می‌شود و هرگز اجرا نمی‌شود.
+
+بیایید اولین تابع خود را با پارامتر ورودی بسازیم. ما مثال قبلی را تغییر می‌دهیم - تابعی که به فرد اجرا کننده آن سلام می‌کند - با نام خود فرد:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+همانطور که می‌بینید، ما الان به تابع یک پارامتر به نام `name` دادیم:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+به خاطر داشته باشید: تابع `print` با 4 اسپیس داخل دستور `if` تورفتگی دارد. بخاطر آنکه تابع زمانی اجرا می‌شود که شرط درست باشد. بیایید نحوه کار آن را ببینیم:
+
+{% filename %}{{ warning_icon }} خط-فرمان{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+آخ، خطا. خوشبختانه، پایتون یک پیام خطای مفید به ما می‌دهد. به ما می‌گوید که تابع `hi()` (همانی که تعریف کردیم) یک پارامتر ورودی دارد (به نام `name`) و ما فراموش کردیم زمان صدا کردن تابع آن را وارد کنیم. بیایید آن را در انتهای فایل درست کنیم:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+و دوباره اجرا کنیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+و اگر نام را تغییر دهیم چه می‌شود؟
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+و اجرا کنیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+فکر میکنید اگر نام دیگری را بنویسید چه اتفاقی می‌افتد؟(بغیر از Ola یا Sonja). امتحان کنید و ببینید که درست فکر می کردید یا نه. باید این را نمایش دهد:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    Hi anonymous!
+    
+
+عالی است.نه؟ با این روش، نیاز نیست برای هر تغییر نامی که تابع به آن سلام میکند، کار تکراری انجام دهید. ما دقیقا توابع را برای همین نیاز داریم - شما نمی‌خواهید تا هر دفعه کد خود را تکرار کنید!
+
+بیایید کار هوشمندانه‌تری انجام دهیم - بیشتر از 2 اسم داریم، و نوشتن یک شرط برای هر کدام سخت است. درست است؟ محتوای فایل خود را با فایل زیر جایگذاری کنید:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+حالا بیایید تا کد را صدا بزنیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+تبریک! شما همین الان نحوه نوشتن توابع را یاد گرفتید! :)
+
+## حلقه‌های تکرار
+
+> برای خوانندگان داخل خانه: این قسمت در ویدئو های بخش [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) پوشش داده شده است.
+
+این آخرین بخش است. سریع تمام شد درست است؟ :)
+
+برنامه‌نویس‌ها دوست ندارند کار تکراری انجام دهند. برنامه‌نویسی برای اتوماتیک کردن کارها است، پس ما نمی‌خواهیم به طور غیر اتوماتیک به هر فرد سلام کنیم، درست است؟ این همان جایی است که حلقه‌های تکرار - Loop - به کار می‌آیند.
+
+هنوز لیست‌ها را به خاطر دارید؟ بیایید یک لیست از دختران بسازیم:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+ما می‌خواهیم به همه آنها با ذکر نامشان سلام کنیم. برای این کار تابع `hi` را داریم، بیایید در یک حلقه از آن استفاده کنیم:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+عبارت `for` کمی شبیه به عبارت `if` رفتار می‌کند؛ کد زیر هر دو باید به اندازه 4 اسپیس تو رفتگی داشته باشد.
+
+اینجا کد کاملی را که باید در فایل باشد، داریم:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+و وقتی آن را اجرا کنیم:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+همانطور که می‌بینید، هر چیزی که درون یک عبارت `for` با تورفتگی قرار دهید، برای هر المان لیست `girls` تکرار می‌شود.
+
+همچنین می‌توانید از `for` با استفاده تابع `range` روی اعداد نیز استفاده کنید:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+که چاپ می کند:
+
+{% filename %}خط فرمان{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` تابعی است که لیستی از اعداد متوالی را می‌سازد (ابتدا و انتهای بازه توسط شما به عنوان پارامتر به تابع داده می شود).
+
+توجه کنید که کران بالای بازه -دومین پارامتر- در لیست ساخته‌شده توسط پایتون نمی‌آید (به این معناست که `range(1, 6)` از 1 تا 5 می‌شمارد، اما شامل 6 نمی‌شود). به دلیل این که "range" نیمه‌باز است، و منظور این است که شامل عدد ابتدای بازه می‌شود ولی عدد انتهایی را شامل نمی‌شود.
+
+## چکیده
+
+همین بود. **شما فوق‌العاده هستید!** این بخش دارای ریزه کاری هایی بود و شما باید به خودتان افتخار کنید. ما هم قطعاً به شما افتخار می‌کنیم که تا اینجا پیش آمده اید!
+
+برای دیدن آموزش رسمی و کامل پایتون آدرس https://docs.python.org/3/tutorial/ را ببینید. این آموزش به شما دید کامل‌تر و درست‌تری نسبت به این زبان می‌دهد. موفق باشید! :)
+
+شاید بخواهید قبل از رفتن به مرحله بعد، کارهای دیگری بکنید، کمی کش قوس بیایید، قدم بزنید و به چشم های خود استراحتی بدهید. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/fa-IR/template_extending/README.md b/fa-IR/template_extending/README.md
new file mode 100644
index 00000000000..a2aa76589ec
--- /dev/null
+++ b/fa-IR/template_extending/README.md
@@ -0,0 +1,151 @@
+# توسعه template
+
+چیز دیگری که جنگو برای شما دارد **توسعه template** است. معنای آن چیست؟ به این معنی است که شما می‌توانید بخش‌هایی از یک کد HTML را در چندین صفحه مختلف از وب سایت خود استفاده کنید.
+
+زمانی که قصد دارید از اطلاعات یا ترکیب بندی خاصی چندین بار استفاده کنید، template ها به کمک شما خواهند آمد. نیازی نیست که یک کار تکراری را برای همه فایل ها انجام دهید. و اگر قصد داشتید چیزی را تغییر دهید، لازم نیست آن تغییر را در تک تک template ها اعمال کنید. فقط یکبار کافی است!
+
+## ساخت یک template پایه
+
+یک template پایه، اساسی ترین template است که شما آن را در هر صفحه وب سایت خود توسعه می‌دهید.
+
+اجازه دهید تا یک فایل `base.html` در مسیر `blog/templates/blog/` بسازیم:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+سپس فایل را در ویرایشگر متنی باز کنید و همه چیز را از فایل `post_list.html` داخل فایل `base.html` کپی کنید، مانند زیر:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+سپس در فایل `base.html`, همه محتویات تگ `<body>` (همه چیز بین `<body>` و `</body>`) را با کد زیر عوض کنید:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %} ممکن است توجه کرده باشید که این عمل هر چیزی بین `{% for post in posts %}` و `{% endfor %}` را با کد زیر عوض کرده است: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+ولی چرا؟ شما همین الان یک `block` ساختید! شما از تمپلیت تگ `{% block %}` برای ساخت یک ناحیه استفاده کردید، که کد HTML در آن قرار می‌گیرد. زمانی که تمپلیت `base.html` را در فایل تمپلیت دیگری گسترش می‌دهیم، کدهای HTML مذکور را داخل تگ block می‌نویسیم. ما نحوه انجام کار را همین الان به شما نشان خواهیم داد.
+
+فایل `base.html` را ذخیره کنید و فایل `blog/templates/blog/post_list.html` را دوباره در ویرایشگر متنی باز کنید. {% raw %} شما قرار است همه چیز را از بالای `{% for post in posts %}` و زیر `{% endfor %}` حذف کنید. زمانی که کار گفته شده را انجام دادید، فایل به این شکل خواهد بود:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+ما می‌خواهیم از این بخش template برای تمام بلاک‌های محتوا استفاده کنیم. زمان اضافه کردن تگ‌های block به این فایل رسیده‌است!
+
+{% raw %} شما می‌خواهید که تگ block با تگ‌های فایل `base.html` هماهنگ باشد. هم چنین می‌خواهید تا این تگ تمام کدهای متعلق به بلاک محتوا را شامل شود. برای انجام این کار، همه چیز را بین `{% block content %}` و `{% endblock %}` قرار دهید. به این صورت:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+تنها یک کار باقی مانده. ما باید این دو template را به یکدیگر متصل کنیم. هدفمان از گسترش template همین است! با اضافه کردن تگ extends در ابتدای فایل، این کار را انجام می‌دهیم. مانند زیر:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+همین است! فایل را ذخیره کنید، و چک کنید که آیا وب‌سایت شما هنوز به درستی کار می‌کند. :)
+
+> اگر خطای`TemplateDoesNotExist` را دریافت کردید، به معنای آن است که فایل `blog/base.html` وجود ندارد و دستور `runserver` در کنسول خط فرمان در حال اجرا است. سعی کنید دستور را متوقف کنید (با زدن Ctrl+C - کلید Control و کلید C به صورت همزمان) و وب سرور را دوباره با دستور `python manage.py runserver` راه اندازی کنید.
\ No newline at end of file
diff --git a/fa-IR/whats_next/README.md b/fa-IR/whats_next/README.md
new file mode 100644
index 00000000000..9a14d147f2a
--- /dev/null
+++ b/fa-IR/whats_next/README.md
@@ -0,0 +1,43 @@
+# گام بعدی چیست؟
+
+تبریک به شما! **شما فوق العاده هستید**. به شما افتخار می‌کنیم! <3
+
+### حالا چه باید کرد؟
+
+یک نفس راحت بکش. همین حالا هم یک کار واقعاٌ بزرگ انجام دادی.
+
+بعد از این مطمئن شو که جنگو گرلز را در [فیسبوک](http://facebook.com/djangogirls) یا [توییتر](https://twitter.com/djangogirls) دنبال میکنی تا در جریان تازه‌ترین‌ها باشی.
+
+### آیا می‌توانید منابع دیگری معرفی کنید؟
+
+بله! حجم *بسیار زیادی* منابع آنلاین برای یادگرفتن هر نوع مهارت برنامه نویسی وجود دارد - این می‌تواند به راحتی باعث سردرگمی بشود اما ما از شما حمایت می‌کنیم. هرچیزی که باعث شد که شما به جنگو گرلز بیایید و یا هرچیزی که در طول دوره آموزش برایتان جالب بوده، ما منابعی کاملاً رایگان (یا با بخش‌هایی رایگان) برای آن‌ها معرفی می‌کنیم که شما می‌توانید به هر شکلی که بخواهید از آنها استفاده کنید.
+
+#### جنگو
+
+- کتاب دیگر ما، [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [دوره آموزشی رسمی جنگو](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [شروع کردن جنگو با درس‌های ویدئویی](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django)، برخی ویدئوها به رایگان قابل استفاده است و می‌توانید بعد از گذراندن این دوره‌ها مدرک Coursera بگیرید
+
+#### HTML, CSS and JavaScript
+
+- [دوره توسعه وبسایت Codecademy](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### پایتون
+
+- [دوره پایتون Codecademy](https://www.codecademy.com/learn/learn-python)
+- [دوره پایتون گوگل](https://developers.google.com/edu/python/)
+- [کتاب Learn Python The Hard Way](http://learnpythonthehardway.org/book/) - تمرین‌های ابتدایی رایگان است
+- [دوره آموزشی New Coder](http://newcoder.io/tutorials/) - مجموعه‌ای از تمرین ‌های کاربردی است که نشان می‌دهد چطور از پایتون می‌توان استفاده کرد
+- [edX](https://www.edx.org/course?search_query=python) - بسیاری از دوره‌ها را می‌توانید رایگان استفاده کنید، ولی اگر مدرک یا تأییدیه بخواهید باید هزینه بپردازید
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) - برخی از دوره‌ها رایگان هستند و با گذراندن آنها می‌توانید مدرک دوره را بگیرید
+- [Python for Everybody](https://www.py4e.com/) - یک دوره آزاد و رایگان بر اساس Coursera Python for Everybody
+
+#### کار کردن با داده‌ها
+
+- [دوره علم داده Codecademy](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) - بسیاری از دوره‌ها را رایگان می‌توانید شرکت کنید ولی اگر مدرک یا تأییدیه می‌خواهید باید هزینه بپردازید
+- [Dataquest](https://www.dataquest.io/) - سی "مأموریت" اول رایگان هستند
+
+نمی‌توانیم صبر کنیم تا ببینیم چه چیزی درست می‌کنید!
\ No newline at end of file
diff --git a/fa/GLOSSARY.md b/fa/GLOSSARY.md
new file mode 100644
index 00000000000..c3ba34b6028
--- /dev/null
+++ b/fa/GLOSSARY.md
@@ -0,0 +1,3 @@
+# ویرایشگر کد ویرایشگر کد یک برنامه است که به شما اجازه میدهد کدهایتان را ذخیره کنید بنابراین شما میتوانید به آنها رجوع کنید. شما میتوانید در فصل editor chapter یاد بگیرید که یکی از آنها را چطور دانلود کنید.
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/fa/README.md b/fa/README.md
new file mode 100644
index 00000000000..431f4c64f49
--- /dev/null
+++ b/fa/README.md
@@ -0,0 +1,51 @@
+# جنگو برای دختران
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## معرفی
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? آیا شده به ساختن یک وبسایت فکر کنید ولی انگیزه کافی را برای شروع اش نداشته باشید؟ آیا شده به ساختن یک وبسایت فکر کنید ولی انگیزه کافی را برای شروع آن نداشته باشید؟
+
+ما خبرهای خوبی برای شما داریم. برنامه نویسی آن قدر که به نظر می‌رسد سخت نیست و می‌خواهیم نشان دهیم که حتی میتواند جالب هم باشد.
+
+This tutorial will not magically turn you into a programmer. اگر بخواهید برنامه نویس خوبی شوید، باید ماهها و یا حتی سالها برایش وقت بگذارید. ولی ما می‌خواهیم نشان دهیم که برنامه نویسی آنقدر که به نظر می‌رسد پیچیده نیست. سعی ما این است که قدم به قدم و جز به جز جلو برویم، تا زیاد گیج نشوید. 
+
+امیدواریم که بتوانیم کاری کنیم که شما در حد امکان از فناوری خوشتان بیاید. 
+
+## در این آموزش چه چیزی یاد خواهید گرفت؟
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+این (کم و بیش) شبیه این خواهد شد:
+
+![عدد 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). ما بوسیله پرسش از مربی هایمان٫ شرکت کننده گان قبلیمان و ... به ما کمک می‌کنند در توسعه این آموزش! نگران هیچ چیز نباشید سوالات خود را بپرسید!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## مشارکت در توسعه
+
+این آموزش نگهداری می‌شود توسط [DjangoGirls](https://djangogirls.org/). در صورتی که مشکلی در این آموزش می‌بینید لطفا در بروزرسانی و حل آن مشکل به ما کمک کنید. [راهنمای نحوه توسعه](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/fa/SUMMARY.md b/fa/SUMMARY.md
new file mode 100644
index 00000000000..f891169f2fc
--- /dev/null
+++ b/fa/SUMMARY.md
@@ -0,0 +1,27 @@
+# سرفصل ها
+
+* [معرفی](README.md)
+* [نصب و راه‌اندازی](installation/README.md)
+* [نصب و راه اندازی (chromebook)](chromebook_setup/README.md)
+* [اینترنت چگونه کار می‌کند](how_the_internet_works/README.md)
+* [آشنایی با خط فرمان](intro_to_command_line/README.md)
+* [نصب و راه اندازی پایتون](python_installation/README.md)
+* [ویرایشگر کد](code_editor/README.md)
+* [آشنایی با پایتون](python_introduction/README.md)
+* [جنگو چیست؟](django/README.md)
+* [نصب و راه اندازی جنگو](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [مدل در جنگو](django_models/README.md)
+* [پنل مدیریت در جنگو](django_admin/README.md)
+* [فاز دیپلوی!](deploy/README.md)
+* [آدرس دهی در جنگو](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [آشنایی با HTML](html/README.md)
+* [ORM در جنگو](django_orm/README.md)
+* [داده های پویا در templates](dynamic_data_in_templates/README.md)
+* [templates در جنگو](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [توسعه template](template_extending/README.md)
+* [توسعه application شما](extend_your_application/README.md)
+* [فرم در جنگو](django_forms/README.md)
+* [گام بعدی چیست؟](whats_next/README.md)
\ No newline at end of file
diff --git a/fa/chromebook_setup/README.md b/fa/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/fa/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/fa/chromebook_setup/instructions.md b/fa/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/fa/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/fa/code_editor/README.md b/fa/code_editor/README.md
new file mode 100644
index 00000000000..2e1cfbaba69
--- /dev/null
+++ b/fa/code_editor/README.md
@@ -0,0 +1,11 @@
+# ویرایشگر کد
+
+> برای خوانندگان در خانه: این فصل در ویدئو [نصب پایتون و کد ویرایشگر](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) توضیح داده شده است.
+
+دارید به نوشتن اولین خط کدتان نزدیک می‌شوید، زمان مناسبی برای دانلود یک ویرایشگر متن است!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/fa/code_editor/instructions.md b/fa/code_editor/instructions.md
new file mode 100644
index 00000000000..74f829144e4
--- /dev/null
+++ b/fa/code_editor/instructions.md
@@ -0,0 +1,31 @@
+ویرایشگرهای مختلف زیادی وجود دارد که این امر به سلیقه شخصی برمی‌گردد. اغلب برنامه‌نویسان پایتون از محیط‌های توسعه یکپارچه (IDE, Integrated Development Environments) بسیار قدرتمند مثل PyCharm استفاده می‌کنند. اما برای یک مبتدی احتمالا خیلی مناسب نیست. پیشنهادهای ما به همان اندازه قدرتمند، اما بسیار ساده‌تر هستند.
+
+ما موارد زیر را پیشنهاد می‌کنیم، اما می‌توانید از مربی خود، ترجیحش را بپرسید. راحت‌تر است از مربی کمک بگیرید.
+
+## Gedit
+
+Gedit یک ویرایشگر متن باز و رایگان است که برای همه سیستم‌عاملها وجود دارد.
+
+[جهت دانلود کلیک نمایید](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[جهت دانلود کلیک نمایید](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[جهت دانلود کلیک نمایید](https://atom.io/)
+
+## چرا ویرایشگر متن نصب می‌کنیم؟
+
+ممکن است فکر کنید که چرا به جای استفاده از برنامه‌ای مثل Word یا Notepad، این نرم‌افزار خاص ویرایش کد را نصب می‌کنم.
+
+در ابتدا این که کدها نیاز دارند که به صورت متن ساده (**plain text**) باشند و مشکل برنامه‌هایی مثل Word یا Textedit این است که متن ساده تولید نمی‌کنند، بلکه متنی غنی (با فونت و قالب‌بندی) می‌سازند و از قالب‌های سفارشی مثل [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format) استفاده می‌کنند.
+
+دلیل دوم این است که ویرایشگرهای متن به طور خاص برای ویرایش کد ساخته شده‌اند. بنابراین، امکاناتی مثل رنگ‌آمیزی کدها بر اساس معنایشان یا بستن خودکار نقل قول‌ها را دارند.
+
+همه این‌ها را بعدا در عمل خواهیم دید. به زودی، شما به ویرایشگر خود به عنوان ابزار محبوبتان نگاه خواهید کرد. :)
\ No newline at end of file
diff --git a/fa/css/README.md b/fa/css/README.md
new file mode 100644
index 00000000000..3d32c11c991
--- /dev/null
+++ b/fa/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+بلاگ ما هنوز خیلی زشت است، نه؟ وقتش است که زیبایش کنیم. برای این کار از CSS استفاده می‌کنیم.
+
+## CSS چیست؟
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## با بوت‌ استرپ شروع کنیم!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## نصب بوت استرپ
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![عدد 14.1](images/bootstrap1.png)
+
+ظاهری قشنگ تر از قبل!
+
+## فایل ها ی ثابت در جنگو
+
+ما در نهایت نگاهی دقیقتر به فایلها می اندازیم ( فایل های ثابت). فایلهای ثابت شامل تمامی فایلهای CSS و عکسها می باشند. Their content doesn't depend on the request context and will be the same for every user.
+
+### فایل های ثابت در جنگو کجا قرار میگیرد
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![عدد 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![عدد 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![عدد 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![عدد 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/fa/deploy/README.md b/fa/deploy/README.md
new file mode 100644
index 00000000000..2c1ec41b377
--- /dev/null
+++ b/fa/deploy/README.md
@@ -0,0 +1,260 @@
+# فاز دیپلوی!
+
+> **توجه داشته باشید** که قسمت های پیش رو ممکن هست کمی سخت به نظر برسد. یکی از مهم ترین قسمت های توسعه وب سایت, دیپلوی می باشد. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/fa/deploy/install_git.md b/fa/deploy/install_git.md
new file mode 100644
index 00000000000..f7a2fa418e5
--- /dev/null
+++ b/fa/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). در بقیه موارد, پیش فرض ها مناسب هستند. استایل ویندوز را مورد بررسی قرار دهید ولی استایل یونیکس تا انتها مناسب می باشد و تغییر ندهید.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/fa/deploy/signup_pythonanywhere.md b/fa/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/fa/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/fa/django/README.md b/fa/django/README.md
new file mode 100644
index 00000000000..7f2ad03511a
--- /dev/null
+++ b/fa/django/README.md
@@ -0,0 +1,27 @@
+# جنگو چیست؟
+
+جنگو (جَنگو) یک فریم ورک تحت وب رایگان و open source است که با زبان پایتون نوشته شده است. یک فریم ورک تحت وب, دارای مجموعه ای است که به شما کمک می کنند تا یک وب سایت را سریع تر و راحت تر توسعه دهید.
+
+هنگامی که در حال ساخت یک وب سایت هستید، شما همیشه به مجموعه ای از اجزای مشابه نیاز دارید. به شرح زیر: یک روش برای کنترل کردن احراز هویت کاربر (ثبت نام ، ورود به حساب کاربری ، خروج از حساب کاربری) ، یک پنل مدیریت برای وب سایت خود ، فرم ها ، روشی برای آپلود فایل ها و غیره.
+
+خوشبختانه خیلی وقت پیش، افرادی متوجه این موضوع شدند که هنگام ساختن یک سایت جدید، توسعه دهندگان وب با مشکلات مشابهی روبرو می شوند، بنابراین آن ها تیمی را تشکیل دادند که به راحتی اجزای کار را در اختیار شما قرار می دهد که شما بتوانید به راحتی از انها استفاده کنید ودر نهایت فریم ورک ها را ساختند (جنگو یکی از آن هاست).
+
+فریم ورکها به این دلیل به وجود آمده اند که دیگر نیازی نباشد شما از اول چرخ را بسازید و به شما کمک می کند تا به راحتی سایت خود را بسازید.
+
+## چرا شما به یک فریم ورک نیاز دارید?
+
+برای درک بهترچگونگی عملکرد جنگو نگاه دقیق تری به سرور می اندازیم. اولین چیزی که سرور نیاز دارد که بداند این است که شما می خواهید سرور برای شما یک وب پیج را راه اندازی کند.
+
+حالا میل باکس را تصور کنید که برای دریافت نامه ها ( requests) چه کارهایی را انجام می دهد. این کار توسط وب سرور انجام خواهد گرفت. وب سرور نامه را خوانده و پاسخ مربوطه را به وب پیج می فرستد. اما هنگامی که شما میخواهید چیزی را ارسال کنید, شما به برخی مطالب نیاز دارید. و جنگو همونی است که به شما برای ایجاد محتوا کمک می کند.
+
+## زمانی که فردی یک درخواست از وب سایت به سرور شما می کند، چه اتفاقی می افتد؟
+
+هنگامی که درخواست به وب سرور فرستاده می شود آن درخواست به جنگو انتقال داده می شود در این هنگام جنگو در تلاش برای فهمیدن درخواست می باشد. در ابتدا آدرس وب پیج را میگیرد و سعی در فهمیدن عملکرد می کند. این بخش توسط **urlresolver** جنگو انجام میگیرد (توجه داشته باشید که website address یوآرال را صدا میزند – Uniform Resource Locator– به این دلیل *urlresolver* نامیده می شود). یک لیست از الگوها را میگیرد و سعی برای مطابقت با آدرس می کند (خیلی منطقی نیست). Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/fa/django_admin/README.md b/fa/django_admin/README.md
new file mode 100644
index 00000000000..75faab2ce52
--- /dev/null
+++ b/fa/django_admin/README.md
@@ -0,0 +1,57 @@
+# پنل مدیریت در جنگو
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/fa/django_forms/README.md b/fa/django_forms/README.md
new file mode 100644
index 00000000000..3009f9cf445
--- /dev/null
+++ b/fa/django_forms/README.md
@@ -0,0 +1,447 @@
+# فرم در جنگو
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/fa/django_installation/README.md b/fa/django_installation/README.md
new file mode 100644
index 00000000000..532f4da91ca
--- /dev/null
+++ b/fa/django_installation/README.md
@@ -0,0 +1,7 @@
+# نصب و راه اندازی جنگو
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/fa/django_installation/instructions.md b/fa/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/fa/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/fa/django_models/README.md b/fa/django_models/README.md
new file mode 100644
index 00000000000..a183f242112
--- /dev/null
+++ b/fa/django_models/README.md
@@ -0,0 +1,199 @@
+# مدل در جنگو
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/fa/django_orm/README.md b/fa/django_orm/README.md
new file mode 100644
index 00000000000..48c5a248d50
--- /dev/null
+++ b/fa/django_orm/README.md
@@ -0,0 +1,219 @@
+# جنگو ORM و QuerySets
+
+در این فصل شما چگونگی اتصال به پایگاه داده و ذخیره اطلاعات در آن را خواهید یادگرفت. وارد عمل شویم!
+
+## QuerySet چیست؟
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+ساده ترین راه برای فراگیری با مثال است. پس شروع می کنیم.آماده اید؟
+
+## پوسته Django
+
+کنسول های لوکال خود را باز کرده ( نه در PythonAnywhere) و این دستور را تایپ کنید:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+    
+
+باید پاسخی مانند زیر دریافت کنید:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole) >>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### تمام اشیاء
+
+در ابتدا تمامی پست ها را نمایش می دهیم. با دستور زیر می توان این کار را انجام داد:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### ایجاد شیء
+
+به صورت زیر می توان یک شیء پست جدید در پایگاه داده ایجاد کرد:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+بیایید اول مدل User را وارد کنیم:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+مشاهده کاربران در پایگاه داده :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+الان ما میتونیم پست خود را ایجا کنیم:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+با هم امتحان می کنیم.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+اینگونه یک پست دیگر در لیست خواهیم داشت!
+
+### اضافه کردن پست های بیشتر
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### فیلتر کردن اشیاء
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. ما در اینجا به جای `all` از `filter` در تمامی `Post.objects.all()` استفاده می کنیم. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. الان یک کد به صورت زیر داریم:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+ 
+Context | Request Context
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> دقت کنید که ۲تا کارکتر underscore ( ــ ) در میان `title` و `contains` وجود دارد. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+و حالا با متد `publish` آن را منتشر می کنیم:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### سفارش اشیاء (Ordering objects)
+
+QuerySets همچنین به شما اجازه میدهد لیستی از اشیاء را سفارش دهید.آنها را در قسمت `created_date` سفارش دهید:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+همچنین با اضافه کردن `-` در ابتدای دستور میتوانیم معکوس سفارش را ببینیم:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### زنجیرهای QuerySets
+
+شما همچنین می توانید QuerySets ها را با **chaining** با یکدیگر ترکیب کنید:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+این واقعا قدرتمند است و به شما اجازه کوءری های(queries) پیچیده را می دهد.
+
+موفق شدیم! شما الان برای قسمت بعدی آماده هستید. برای بستن پوسته (shell) دستور زیر را تایپ کنید:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+```
\ No newline at end of file
diff --git a/fa/django_start_project/README.md b/fa/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/fa/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/fa/django_templates/README.md b/fa/django_templates/README.md
new file mode 100644
index 00000000000..892cef3b3db
--- /dev/null
+++ b/fa/django_templates/README.md
@@ -0,0 +1,106 @@
+# templates در جنگو
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![عدد 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![عدد 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![عدد 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![عدد 13.4](images/donut.png)
\ No newline at end of file
diff --git a/fa/django_urls/README.md b/fa/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/fa/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/fa/django_views/README.md b/fa/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/fa/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/fa/dynamic_data_in_templates/README.md b/fa/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..6a70e71760f
--- /dev/null
+++ b/fa/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# داده های پویا در templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/fa/extend_your_application/README.md b/fa/extend_your_application/README.md
new file mode 100644
index 00000000000..190d32270fe
--- /dev/null
+++ b/fa/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# توسعه application شما
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/fa/how_the_internet_works/README.md b/fa/how_the_internet_works/README.md
new file mode 100644
index 00000000000..40b7dd70f2d
--- /dev/null
+++ b/fa/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# اینترنت چگونه کار می‌کند
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![عدد 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![عدد 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![عدد 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![عدد 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/fa/html/README.md b/fa/html/README.md
new file mode 100644
index 00000000000..4991c6014c5
--- /dev/null
+++ b/fa/html/README.md
@@ -0,0 +1,213 @@
+# آشنایی با HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![عدد 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![عدد 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![عدد 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![عدد 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/fa/install_git.md b/fa/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/fa/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/fa/installation/README.md b/fa/installation/README.md
new file mode 100644
index 00000000000..318ffbfb40f
--- /dev/null
+++ b/fa/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [آشنایی با پایتون](../python_introduction/README.md)
+
+* [جنگو چیست؟](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/fa/instructions.md b/fa/instructions.md
new file mode 100644
index 00000000000..b5a0981698b
--- /dev/null
+++ b/fa/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period. It's easy to install and use, and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source, easy to install and easy to use. It's available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/fa/intro_to_command_line/README.md b/fa/intro_to_command_line/README.md
new file mode 100644
index 00000000000..35cfbeb4a08
--- /dev/null
+++ b/fa/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## سرفصل ها
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/fa/python_installation/README.md b/fa/python_installation/README.md
new file mode 100644
index 00000000000..3ea387325cb
--- /dev/null
+++ b/fa/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# نصب و راه اندازی پایتون
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/fa/python_installation/instructions.md b/fa/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/fa/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/fa/python_introduction/README.md b/fa/python_introduction/README.md
new file mode 100644
index 00000000000..ec2834af04f
--- /dev/null
+++ b/fa/python_introduction/README.md
@@ -0,0 +1,1061 @@
+# آشنایی با پایتون
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### سرفصل ها
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### سرفصل ها
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### سرفصل ها
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## سرفصل ها
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/fa/signup_pythonanywhere.md b/fa/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/fa/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/fa/template_extending/README.md b/fa/template_extending/README.md
new file mode 100644
index 00000000000..0b70f067b35
--- /dev/null
+++ b/fa/template_extending/README.md
@@ -0,0 +1,147 @@
+# توسعه template
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/fa/whats_next/README.md b/fa/whats_next/README.md
new file mode 100644
index 00000000000..37f4e0440b8
--- /dev/null
+++ b/fa/whats_next/README.md
@@ -0,0 +1,25 @@
+# گام بعدی چیست؟
+
+از پسش بر اومدی! **ایول داری**. ما بهت افتخار می کنیم! <3
+
+### حالا چیکار کنم؟
+
+یک نفس راحت بکش. همین حالا هم ی کار بزرک کردی.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### شما می تونید یک منبع دیگه معرفی کنید؟
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/fi-FI/GLOSSARY.md b/fi-FI/GLOSSARY.md
new file mode 100644
index 00000000000..0e87d991ae8
--- /dev/null
+++ b/fi-FI/GLOSSARY.md
@@ -0,0 +1,3 @@
+# koodi muokkaaja
+
+Koodi muokkaaja on sovellus, joka antaa sinun tallentaa koodisi, jotta voit jatkaa sitä myöhemmin. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/fi-FI/README.md b/fi-FI/README.md
new file mode 100644
index 00000000000..3707450b472
--- /dev/null
+++ b/fi-FI/README.md
@@ -0,0 +1,51 @@
+# Django tytöt tutoriaali
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Tervetuloa
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Johdanto
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Kuva 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/fi-FI/SUMMARY.md b/fi-FI/SUMMARY.md
new file mode 100644
index 00000000000..95ae8ec5b1e
--- /dev/null
+++ b/fi-FI/SUMMARY.md
@@ -0,0 +1,35 @@
+# Yhteenveto
+
+* [Johdanto](README.md)
+* [Asennus](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [Mikä on Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [Mitä seuraavaksi?](whats_next/README.md)
\ No newline at end of file
diff --git a/fi-FI/chromebook_setup/README.md b/fi-FI/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/fi-FI/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/fi-FI/chromebook_setup/instructions.md b/fi-FI/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..e39cebb863b
--- /dev/null
+++ b/fi-FI/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Voit [ohittaa tämän osan](http://tutorial.djangogirls.org/en/installation/#install-python), jos et käytä Chromebookia. Jos et käytä, asennuskokemus on hieman erilainen. Voit ohittaa loput asennusohjeet.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE (Integroitu kehitysympäristö) on työkalu, jolla saat käyttöösi koodieditorin ja pääset netissä toimivaan tietokoneeseen, johon voit asentaa, kirjoittaa ja käyttää ohjelmistoa. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtuaaliympäristö
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/fi-FI/code_editor/README.md b/fi-FI/code_editor/README.md
new file mode 100644
index 00000000000..0a401fb1f52
--- /dev/null
+++ b/fi-FI/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/fi-FI/code_editor/instructions.md b/fi-FI/code_editor/instructions.md
new file mode 100644
index 00000000000..69f0525c394
--- /dev/null
+++ b/fi-FI/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Lataa se täältä](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Lataa se täältä](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Lataa se täältä](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/fi-FI/css/README.md b/fi-FI/css/README.md
new file mode 100644
index 00000000000..1250be8258f
--- /dev/null
+++ b/fi-FI/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## Mikä on CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Kuva 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Valmis?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Kuva 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Kuva 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Kuva 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Kuva 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/fi-FI/deploy/README.md b/fi-FI/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/fi-FI/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/fi-FI/deploy/install_git.md b/fi-FI/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/fi-FI/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/fi-FI/deploy/signup_pythonanywhere.md b/fi-FI/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/fi-FI/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/fi-FI/django/README.md b/fi-FI/django/README.md
new file mode 100644
index 00000000000..278131d480d
--- /dev/null
+++ b/fi-FI/django/README.md
@@ -0,0 +1,27 @@
+# Mikä on Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) on ilmainen avoimen lähdekoodin web-sovelluskehys, joka on kirjoitetty Pythonilla. Web-sovelluskehys on joukko komponentteja, jotka auttavat kehittämään verkkosivustoja nopeammin ja helpommin.
+
+Kun olet rakentamassa sivustoa, tarvitset aina samanlaisia komponentteja: tavan käsitellä käyttäjän todennus (rekisteröitymisessä sekä sisään ja ulos kirjautuessa), hallinto-paneelin, lomakkeita, tavan ladata tiedostoja jne.
+
+Onneksi ihmiset jo kauan sitten huomasivat, että web-kehittäjät kohtaavat kerta toisensa jälkeen samanlaisia ongelmia uutta sivustoa rakentaessaan, joten he yhdistivät voimansa ja loivat sovelluskehyksiä (esimerkiksi Djangon), jotka antavat valmiita komponentteja suoraan käyttöön.
+
+Sovelluskehykset ovat olemassa, jotta sinun ei tarvitsisi keksiä pyörää uudelleen ja jotta säästät aikaa rakentaessasi uutta sivustoa.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/fi-FI/django_admin/README.md b/fi-FI/django_admin/README.md
new file mode 100644
index 00000000000..72f6b892ca5
--- /dev/null
+++ b/fi-FI/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Kirjautumissivu](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/fi-FI/django_forms/README.md b/fi-FI/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/fi-FI/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/fi-FI/django_installation/README.md b/fi-FI/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/fi-FI/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/fi-FI/django_installation/instructions.md b/fi-FI/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/fi-FI/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/fi-FI/django_models/README.md b/fi-FI/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/fi-FI/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/fi-FI/django_orm/README.md b/fi-FI/django_orm/README.md
new file mode 100644
index 00000000000..7fdc215a875
--- /dev/null
+++ b/fi-FI/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### Kaikki objektit
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/fi-FI/django_start_project/README.md b/fi-FI/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/fi-FI/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/fi-FI/django_templates/README.md b/fi-FI/django_templates/README.md
new file mode 100644
index 00000000000..167eb84ba04
--- /dev/null
+++ b/fi-FI/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django mallit
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Kuva 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Kuva 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Kuva 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/fi-FI/django_urls/README.md b/fi-FI/django_urls/README.md
new file mode 100644
index 00000000000..9bf28746a77
--- /dev/null
+++ b/fi-FI/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Kyllä! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Virhe](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/fi-FI/django_views/README.md b/fi-FI/django_views/README.md
new file mode 100644
index 00000000000..618b82f77e0
--- /dev/null
+++ b/fi-FI/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Virhe](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/fi-FI/dynamic_data_in_templates/README.md b/fi-FI/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/fi-FI/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/fi-FI/extend_your_application/README.md b/fi-FI/extend_your_application/README.md
new file mode 100644
index 00000000000..874265f1a51
--- /dev/null
+++ b/fi-FI/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Sivua ei löydy](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/fi-FI/how_the_internet_works/README.md b/fi-FI/how_the_internet_works/README.md
new file mode 100644
index 00000000000..af0cb24aee6
--- /dev/null
+++ b/fi-FI/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Kuva 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Kuva 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Kuva 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Kuva 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/fi-FI/html/README.md b/fi-FI/html/README.md
new file mode 100644
index 00000000000..6bf61ade0d9
--- /dev/null
+++ b/fi-FI/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Kuva 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Kuva 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Kuva 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Kuva 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/fi-FI/installation/README.md b/fi-FI/installation/README.md
new file mode 100644
index 00000000000..442f416b5f2
--- /dev/null
+++ b/fi-FI/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Asennus
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Aloita lukeminen
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [Mikä on Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/fi-FI/intro_to_command_line/README.md b/fi-FI/intro_to_command_line/README.md
new file mode 100644
index 00000000000..142f4eba7ae
--- /dev/null
+++ b/fi-FI/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Luo hakemisto
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Poistu
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Yhteenveto
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Kuvaus                     | Esimerkki                                          |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| poistu            | poistu                   | sulje ikkuna               | **poistu**                                         |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | kopioi tiedosto            | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | siirrä tiedosto            | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Valmis?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/fi-FI/intro_to_command_line/open_instructions.md b/fi-FI/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/fi-FI/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/fi-FI/python_installation/README.md b/fi-FI/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/fi-FI/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/fi-FI/python_installation/instructions.md b/fi-FI/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/fi-FI/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/fi-FI/python_introduction/README.md b/fi-FI/python_introduction/README.md
new file mode 100644
index 00000000000..171e8729ef8
--- /dev/null
+++ b/fi-FI/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Yhteenveto
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Virheet
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Muuttujat
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Virhe! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Sanakirjat
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Yhteenveto
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Kommentit
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Yhteenveto
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hei Anonyymi!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Yhteenveto
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/fi-FI/template_extending/README.md b/fi-FI/template_extending/README.md
new file mode 100644
index 00000000000..c1052de8b78
--- /dev/null
+++ b/fi-FI/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Mutta miksi? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/fi-FI/whats_next/README.md b/fi-FI/whats_next/README.md
new file mode 100644
index 00000000000..bbcd36fd21e
--- /dev/null
+++ b/fi-FI/whats_next/README.md
@@ -0,0 +1,43 @@
+# Mitä seuraavaksi?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Kyllä! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/fr-FR/GLOSSARY.md b/fr-FR/GLOSSARY.md
new file mode 100644
index 00000000000..48cb7aaa0d3
--- /dev/null
+++ b/fr-FR/GLOSSARY.md
@@ -0,0 +1,3 @@
+# Éditeur de texte
+
+L'éditeur de texte est une application qui permet d'écrire et enregistrer du code que vous pourrez ré-utiliser plus tard. Vous pouvez apprendre comment s'en procurer un grâce au chapitre [Éditeur de Texte](./code_editor/README.md)
\ No newline at end of file
diff --git a/fr-FR/README.md b/fr-FR/README.md
new file mode 100644
index 00000000000..5ba91076d15
--- /dev/null
+++ b/fr-FR/README.md
@@ -0,0 +1,51 @@
+# Tutoriel de Django Girls
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Cette œuvre est mise à disposition selon les termes de la Licence Creative Commons Attribution — ShareAlike 4.0 International. Pour consulter une copie de cette licence, visitez https://creativecommons.org/licenses/by-sa/4.0/deed.fr
+
+## Bienvenue
+
+Bienvenue dans le tutoriel Django Girls ! Nous sommes heureux de vous voir ici. :) Dans ce tutoriel, nous allons vous emmener dans un voyage sous le capot des technologies web, en vous offrant un aperçu de tous les pièces et les morceaux qui doivent être assemblés pour que le web fonctionne tel que nous le connaissons.
+
+Comme avec toutes les choses inconnues, cela va être une aventure, mais pas de soucis, puisque vous avez déjà eu le courage d'arriver ici, vous allez y arriver. :)
+
+## Introduction
+
+Avez-vous déjà eu l'impression que le monde est de plus en plus rempli de technologies avec lesquelles vous n'êtes pas (encore) familière ? Avez-vous déjà été curieuse de comment créer un site web, sans jamais avoir le courage de vous plonger dedans ? Vous êtes-vous déjà dit que le monde de l'informatique est trop compliqué, ne serait-ce que pour savoir par où commencer ?
+
+Hé bien, bonne nouvelle ! Programmer n'est pas aussi dur que ça en a l'air, et nous sommes là pour vous montrer à quel point ça peut être amusant.
+
+Ce tutoriel ne vous transformera pas magiquement en programmeuse. Si vous voulez devenir bonne, cela peut prendre des mois, voire même des années d'apprentissage et de pratique. Mais nous voulons vous montrer que programmer ou créer des sites web n'est pas aussi compliqué que ça en a l'air. Nous allons essayer de vous expliquer différents morceaux afin de rendre la technologie moins intimidante.
+
+Nous espérons arriver à vous faire aimer la technologie autant que nous l'aimons !
+
+## Qu'apprendrez-vous au cours de ce tutoriel ?
+
+Une fois que vous aurez terminé le tutoriel, vous aurez une petite application web : votre propre blog. Nous allons vous montrer comment le mettre en ligne, ainsi votre travail sera visible par d'autres !
+
+Ça devrait ressembler plus ou moins à ça :
+
+![Figure 0.1](images/application.png)
+
+> Si vous travaillez avec le tutoriel de votre côté et n'avez pas un coach qui vous aiderait en cas de problème, nous avons un système de discussion instantanée pour vous : [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Nous avons demandé aux coachs et participant·e·s des précédentes éditions de passer de temps en temps pour aider les autres avec le tutoriel. N'ayez pas peur et allez poser vos questions !
+
+OK, [commençons par le commencement…](./how_the_internet_works/README.md)
+
+## Suivre le tutoriel chez soi
+
+Il est formidable de participer à un atelier Django Girls, mais nous comprenons qu'il n'est pas toujours facile d'en trouver un. C'est pourquoi nous vous encourageons à essayer de suivre ce tutoriel chez vous. Pour les lectrices à la maison, nous sommes actuellement en train de préparer des vidéos afin qu'il vous soit plus facile de suivre le tutoriel de votre côté. C'est encore un travail en cours, mais la chaine YouTube [Le code convient aux filles](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) couvre de plus en plus de choses.
+
+Dans chaque chapitre couvert se trouve un lien pointant vers la vidéo correspondante.
+
+## À propos et contributions
+
+Ce tutoriel est maintenu par [DjangoGirls](https://djangogirls.org/). Si vous rencontrez des erreurs ou souhaitez simplement suggérer une amélioration du tutoriel, il est important de respecter [les règles de contribution](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Vous voulez nous aider à traduire le tutoriel dans d'autres langues ?
+
+Actuellement, les traductions sont faites sur la plateforme crowdin.com :
+
+https://crowdin.com/project/django-girls-tutorial
+
+Si votre langue n'est pas listée sur [crowdin](https://crowdin.com/), merci [d'ouvrir un ticket](https://github.com/DjangoGirls/tutorial/issues/new) pour nous en informer afin que nous la rajoutions.
\ No newline at end of file
diff --git a/fr-FR/SUMMARY.md b/fr-FR/SUMMARY.md
new file mode 100644
index 00000000000..e0cd7739510
--- /dev/null
+++ b/fr-FR/SUMMARY.md
@@ -0,0 +1,35 @@
+# Résumé
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Ligne de commande](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Éditeur de code](installation/README.md#code-editor)
+  * [Environnement virtuel](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [Comment marche l'Internet](how_the_internet_works/README.md)
+* [Introduction à l'interface en ligne de commande](intro_to_command_line/README.md)
+* [Installation de Python](python_installation/README.md)
+* [L'éditeur de texte](code_editor/README.md)
+* [Introduction à Python](python_introduction/README.md)
+* [Qu'est-ce que Django ?](django/README.md)
+* [Installation de Django](django_installation/README.md)
+* [Votre premier projet Django !](django_start_project/README.md)
+* [Les modèles dans Django](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Déployer !](deploy/README.md)
+* [Les URL de Django](django_urls/README.md)
+* [Vues Django – c'est l'heure de créer !](django_views/README.md)
+* [Introduction au HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Données dynamiques dans les templates](dynamic_data_in_templates/README.md)
+* [Templates Django](django_templates/README.md)
+* [CSS – donnez du style](css/README.md)
+* [Héritage de template](template_extending/README.md)
+* [Finaliser votre application](extend_your_application/README.md)
+* [Formulaires Django](django_forms/README.md)
+* [Et maintenant ?](whats_next/README.md)
\ No newline at end of file
diff --git a/fr-FR/chromebook_setup/README.md b/fr-FR/chromebook_setup/README.md
new file mode 100644
index 00000000000..98cda3e1c66
--- /dev/null
+++ b/fr-FR/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Installation de Chromebook
+
+> **Note** Si vous avez déjà passé les [étapes d’installation](../installation/README.md), il n'est pas nécessaire de les répéter - vous pouvez vous rendre directement à [Introduction à Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/fr-FR/chromebook_setup/instructions.md b/fr-FR/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..62ef8ea2dc0
--- /dev/null
+++ b/fr-FR/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Vous pouvez [passer cette section](http://tutorial.djangogirls.org/en/installation/#install-python) si vous n'utilisez pas un Chromebook. Sinon, votre installation sera un peu différente. Vous pouvez ignorer le reste des instructions d'installation.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud 9 est un outil qui vous propose un éditeur de code et un accès à un ordinateur, fonctionnant sur Internet, sur lequel vous pouvez installer, écrire et exécuter des logiciels. Pour la durée du tutoriel, Cloud IDE agira comme votre *machine locale*. Vous lancerez toujours des commandes dans un terminal exactement comme vos camarades sous macOS, Ubuntu ou Windows, mais votre terminal sera connecté à un ordinateur distant que Cloud IDE aura configuré pour vous. Voici les instructions pour Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Vous pouvez choisir l'un des cloud IDE et suivre les instructions du cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Allez sur [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Créez un compte
+3. Cliquez sur *Nouveau Serveur* et choisissez l'application Django
+4. Cliquez sur le bouton Terminal (sur le côté gauche de la fenêtre)
+
+Maintenant vous devriez voir une interface avec une barre latérale et des boutons à gauche. Cliquez sur le bouton « Terminal » pour ouvrir la fenêtre de terminal. Vous devriez voir le résultat suivant :
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+Le terminal de PaizaCloud Cloud IDE attend vos instructions. Vous pouvez redimensionner ou maximiser la fenêtre pour la rendre un peu plus grand.
+
+#### AWS Cloud9
+
+Cloud 9 requiert actuellement que vous vous connectiez avec AWS et que vous renseigniez votre carte de crédit.
+
+1. Installez Cloud 9 depuis le [Chrome Web Store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Allez à [c9.io](https://c9.io) et cliquez sur *Mise en route avec AWS Cloud9*
+3. Créez un compte AWS (requiert votre carte de crédit, mais il existe un forfait gratuit)
+4. Dans le tableau de bord AWS, entrez *Cloud9* dans la barre de recherche et cliquez dessus
+5. Dans le tableau de bord Cloud 9, cliquez sur *Créer un environnement*
+6. Appelez-le *django-girls*
+7. Lors de la configuration des paramètres, sélectionnez *Créer une nouvelle instance pour l'environnement (EC2)* pour "Type d'environnement" et le "Type d'instance" *t2.micro* (il devrait être indiqué comme disponible gratuitement). Le paramètre d'économie par défaut suffira. Vous pouvez garder les autres paramètres par défaut.
+8. Cliquez sur *Étape suivante*
+9. Cliquez sur *Créer un environnement*
+
+Maintenant, vous pouvez voir une interface avec une barre latérale, une grande fenêtre principale avec du texte et une petite fenêtre en bas qui ressemble à quelque chose comme ceci:
+
+{% filename %}bash{% endfilename %}
+
+    nomutilisateur:~/workspace $
+    
+
+Cette fenêtre en bas est votre terminal. Vous pouvez l'utiliser pour donner des instructions à l'ordinateur Cloud9. Vous pouvez changer la taille de la fenêtre et l'agrandir un peu.
+
+#### Glitch.com Cloud IDE
+
+1. Allez sur [Glitch.com](https://glitch.com/)
+2. Créez un compte (https://glitch.com/signup) ou utilisez votre compte GitHub si vous en avez un. (Voir les instructions GitHub ci-dessous.)
+3. Cliquez sur *New Project* et choisissez *hello-webpage*
+4. Cliquez sur la liste déroulante Outils (en bas à gauche de la fenêtre), puis sur le bouton Terminal pour ouvrir l'onglet terminal qui contiendra une invite comme celle-ci :
+
+{% filename %}Terminal{% endfilename %}
+
+    app@nom-de-votre-projet-glitch:~
+    
+
+Lorsque vous utilisez Glitch.com comme environnement de développement Cloud (IDE), vous n'avez pas besoin de créer un environnement virtuel. À la place, créez manuellement les fichiers suivants :
+
+{% 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
+```
+
+Une fois ces fichiers créés, allez dans le Terminal et exécutez les commandes suivantes pour créer votre premier projet Django :
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+Afin de voir les messages d'erreur détaillés, vous pouvez activer les journaux de débogage Django pour votre application Glitch. Ajoutez simplement ce qui suit à la fin du fichier `mysite/settings.py`.
+
+{% 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,
+        },
+    },
+}
+```
+
+Cela va créer un fichier `debug.log` détaillant les opérations Django et tous les messages d'erreur qui pourraient apparaître, ce qui rendra la correction beaucoup plus facile si votre site Web ne fonctionne pas.
+
+Le redémarrage initial du projet Glitch devrait échouer. (Si vous cliquez sur le bouton en haut de la liste déroulante `Show` puis cliquez sur `In a New Window`, vous recevrez un message d'erreur `DisallowedHost` (accès non autorisé).) Ne vous inquiétez pas à ce stade, le tutoriel corrigera cela dès que vous aurez mis à jour les paramètres Django de votre projet dans le fichier `mysite/settings.py` .
+
+### Environnement virtuel
+
+Un environnement virtuel (également appelé un virtualenv) est comme une boîte noire dans laquelle nous pouvons insérer du code informatique utile à un projet sur lequel nous travaillons. Nous les utilisons pour conserver séparément les différents morceaux de code que nous voulons dans nos différents projets afin que les choses ne se mélangent entre les projets.
+
+Lancer :
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(Notez que sur la dernière ligne, nous utilisons un tilde suivi d'un signe égal : `~=`).
+
+### GitHub
+
+Créez un compte [GitHub](https://github.com).
+
+### PythonAnywhere
+
+Le tutoriel Django Girls comprend une section sur ce qui est appelé le Déploiement, un processus qui permet de déplacer le code de votre application web vers un ordinateur public (appelé serveur) pour que d'autres personnes puissent voir votre travail.
+
+Cette partie est un peu étrange quand on fait le tutoriel sur un Chromebook puisque nous utilisons déjà un ordinateur qui est visible sur Internet (par opposition, par exemple, à un ordinateur portable). Cependant, c'est toujours utile, car nous devons penser à notre espace de travail Cloud 9 comme un endroit pour notre travail "en cours" et Python Anywhere comme un endroit pour publier notre projet à mesure qu'il devient plus complet.
+
+Donc, inscrivez-vous pour un nouveau compte Python Anywhere sur [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/fr-FR/code_editor/README.md b/fr-FR/code_editor/README.md
new file mode 100644
index 00000000000..b3e64c1cad6
--- /dev/null
+++ b/fr-FR/code_editor/README.md
@@ -0,0 +1,11 @@
+# L'éditeur de code
+
+> Pour les lectrices autodidactes, ce chapitre est traité dans la vidéo [Installer Python & Éditeur de code](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+Vous êtes sur le point d'écrire vos premières lignes de code, il est donc temps de télécharger un éditeur de code.
+
+> **Note** Si vous utilisez un Chromebook, ignorez ce chapitre mais assurez-vous de suivre les instructions dans [configuration pour Chromebook](../chromebook_setup/README.md). Le cloud IDE que vous avez choisi (PaizaCloud Cloud IDE ou AWS Cloud9) inclut un éditeur de code, et lorsque vous ouvrez un fichier dans votre IDE dans le menu fichier, vous utiliserez automatiquement l’éditeur.
+> 
+> **Note** Vous l'avez probablement déjà fait au chapitre [Installation](../installation/README.md). Si c'est le cas, vous pouvez passer directement au prochain chapitre !
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/fr-FR/code_editor/instructions.md b/fr-FR/code_editor/instructions.md
new file mode 100644
index 00000000000..a7465c92120
--- /dev/null
+++ b/fr-FR/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Choisir un éditeur de texte parmi tous ceux qui sont disponibles est surtout une histoire de goûts personnels. La plupart des programmeurs·ses Python utilisent des IDE (Environnements de Développement Intégrés) complexes mais très puissants, comme PyCharm par exemple. Ce n'est pas forcément le meilleur choix pour débuter : ceux que nous vous recommandons sont tout aussi puissants, mais beaucoup plus simples à utiliser.
+
+Nos suggestions sont listées ci-dessous, mais n'hésitez pas à demander à vos coachs quelles sont leurs préférences - il sera plus facile d'obtenir de l'aide de leur part.
+
+## Visual Studio Code
+
+Visual Studio Code est éditeur de texte développé par Microsoft pour Windows, Linux et macOS. Il inclut le support du déboggage, l'utilisation de Git intégrée, le surlignage syntaxique, l'autocompletion intelligente du code, les snippets et la refactoring du code.
+
+[Télécharger](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit est un éditeur libre et gratuit disponible pour tout les systèmes d'exploitation.
+
+[Télécharger](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text est un éditeur très populaire avec une période d'évaluation gratuite et il est disponible pour tous les systèmes d'exploitation.
+
+[Télécharger](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom est un autre éditeur populaire. Il est gratuit, ouvert et disponible pour Windows, macOS et Linux. Atom est développé par [GitHub](https://github.com/).
+
+[Télécharger](https://atom.io/)
+
+## Pourquoi installer un éditeur de texte?
+
+Vous devez vous demander pourquoi on installe un éditeur de texte spécial plutôt que d'utiliser Word ou Notepad plus simplement.
+
+La première raison est que le code doit être en format **texte brute**, et le problème est que les éditeurs comme Word et Textedit ne produisent pas réellement du texte brute, mais du texte enrichi (avec des polices et de la mise en forme), en utilisant des formats personnalisés comme [ RTF (Rich Text Format) ](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+La seconde raison est que les éditeurs de code sont conçus spécialement pour l'édition de code. Ils fournissent donc des fonctionnalités très utiles comme la coloration du code en fonction du sens de celui ou automatiquement ajouter un guillemet fermant à chaque que vous ouvrez un guillemet.
+
+Nous verrons tout cela en pratique plus tard. Bientôt votre bon vieux éditeur de code deviendra l'un de vos outils favoris. :)
\ No newline at end of file
diff --git a/fr-FR/css/README.md b/fr-FR/css/README.md
new file mode 100644
index 00000000000..8e5c0ad8aa8
--- /dev/null
+++ b/fr-FR/css/README.md
@@ -0,0 +1,330 @@
+# CSS - Rendez votre site joli !
+
+Soyons honnêtes : notre blog est plutôt moche, non ? Un peu de CSS devrait nous permettre d'arranger ça !
+
+## Qu'est-ce que le CSS ?
+
+Les feuilles de style (CSS : Cascading Style Sheets) sont un langage utilisé pour décrire l'apparence et la disposition d'un site écrit en langage de balisage (comme HTML). Considérez-le comme le maquillage de notre page web. ;)
+
+Mais on ne souhaite pas repartir de zéro. Une fois de plus, nous utiliserons quelque chose que les programmeurs ont publié gratuitement sur Internet. Réinventer la roue n'est pas amusant, n'est-ce pas ?
+
+## Utilisons Bootstrap !
+
+Bootstrap est l'un des frameworks HTML/CSS les plus populaires pour développer de beaux sites web : https://getbootstrap.com/
+
+Il a été créé par d'anciens développeurs de Twitter. Il est maintenant développé par des bénévoles aux quatre coins du monde !
+
+## Installer Bootstrap
+
+Pour installer Bootstrap, ouvrez votre fichier `.html` dans l'éditeur de code et ajoutez cela à la section `<head>` :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Cela n'ajoute pas de fichier à votre projet, mais crée seulement un lien vers des fichiers existant sur internet. Allez-y, ouvrez votre site web et rafraichissez la page. Et voilà !
+
+![Figure 14.1](images/bootstrap1.png)
+
+C'est déjà un peu mieux !
+
+## Les fichiers statiques dans Django
+
+Enfin, allons jeter un coup d'œil à ces **fichiers statiques** dont nous n'arrêtons pas de vous parler. Les fichiers statiques correspondent à tous vos CSS et vos images. Leur contenu ne dépend pas du contexte de la requête et sera le même pour tous les utilisateurs.
+
+### Où ranger les fichiers statiques dans Django ?
+
+Django sait déjà où trouver les fichiers statiques pour l'application "admin" intégrée. Maintenant, nous devons ajouter quelques fichiers statiques pour notre propre application, `blog`.
+
+Pour cela, nous allons créer un dossier appelé `static` à l'intérieur de notre appli blog :
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django va rechercher automatiquement tous les dossiers dits "statiques" à l'intérieur de vos dossiers d'appli. Ensuite, il sera en mesure d'utiliser leur contenu sous forme de fichiers statiques.
+
+## Votre premier fichier CSS !
+
+Nous allons maintenant créer un fichier CSS afin de personnaliser votre page. Créez un nouveau dossier appelé `css` à l'intérieur de votre dossier `static`. Ensuite, créez un nouveau fichier appelé `blog.css` à l'intérieur du dossier `css`. Vous êtes prêt ?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Et c'est parti pour un peu de CSS ! Ouvrez le fichier `blog/static/css/blog.css` dans votre éditeur de texte.
+
+Nous n'irons pas trop loin dans la personnalisation et l'apprentissage du CSS ici. Il y a à la fin de cette page une recommandation pour un cours CSS gratuit si vous souhaitez en savoir plus.
+
+Que pourrions-nous faire rapidement ? Pourquoi ne pas changer la couleur de notre en-tête ? Pour indiquer la couleur que nous souhaitons utiliser, nous devons utiliser un code particulier. Ce code commence par un `#` suivi de 6 lettres (A-F) et chiffres (0-9). Par exemple, le code pour du bleu est `#0000FF`. Afin de trouver le code associé à la couleur de votre choix, vous pouvez consulter le site http://www.colorpicker.com/. Vous pouvez aussi utiliser des [couleurs prédéfinies](http://www.w3schools.com/colors/colors_names.asp), comme `red` ou `green`.
+
+Dans votre fichier `blog/static/css/blog.css`, ajoutez le code suivant :
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` est un sélecteur CSS. Cela signifie que nous allons appliquer nos styles à tout élément `a` qui se trouve dans un élément `h1` ; le sélecteur `h2 a` fait la même chose pour les éléments `h2`. Donc lorsque nous avons quelque chose comme `<h1><a href="">lien</a></h1>`, le style `h1 a` est appliqué. Dans notre cas, nous indiquons de changer sa couleur en `#C25100`, c'est à dire en orange foncé. Ou vous pouvez mettre votre propre couleur ici, mais assurez-vous qu’il contraste bien avec le fond blanc !
+
+Un fichier CSS permet de déterminer le style des éléments présents dans un fichier HTML. La première façon pour identifier des éléments, c'est avec leur nom d'élément. Vous vous en souviendrez car ces noms proviennent des balises HTML. Exemple : `a`, `h1` et `body` sont tous des noms d'élément. Vous pouvez aussi identifier les éléments par leur attribut `class` ou `id`. La classe et l'identifiant sont des noms que vous choisissez vous-même. Les classes définissent des groupes d'éléments tandis que les identifiants pointent un élément spécifique. Par exemple, l'élément suivant peut être identifié par CSS à la fois par son nom `a`, sa classe `external_link`, ou son identifiant unique (id) `link_to_wiki_page` :
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Apprenez-en plus à propos des [Sélecteurs CSS sur W3Schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+Nous devons aussi dire à notre modèle HTML que nous avons utilisé un peu de CSS. Ouvrez le fichier `blog/templates/blog/post_list.html` dans l'éditeur de code et ajoutez cette ligne au tout début :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+On vient tout juste de charger les fichiers statiques :). Entre les balises `<head>` et `</head>`, après les liens vers les fichiers CSS de Bootstrap, ajoutez cette ligne :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Le navigateur lit les fichiers dans l'ordre où ils sont donnés, donc nous devons nous assurer que c'est dans le bon endroit. Dans le cas contraire, le code dans notre fichier peut être écrasé par le code des fichiers Bootstrap. Nous venons simplement de dire à notre template où trouver notre fichier CSS.
+
+Maintenant, votre fichier doit ressembler à ceci :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>Date de publication: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Ok, on sauvegarde et on rafraîchit la page !
+
+![Figure 14.2](images/color2.png)
+
+Bravo ! Peut-être que nous pourrions aérer un peu notre page web en augmentant la marge du côté gauche ? Essayons pour voir !
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Ajoutez ceci à votre CSS, enregistrez le fichier et regarder comment cela fonctionne !
+
+![Figure 14.3](images/margin2.png)
+
+Et si nous changions aussi la police de caractères de notre entête ? Collez ceci dans le `<head>` de votre fichier `blog/templates/blog/post_list.html` :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Comme précédemment, vérifiez l'ordre et placez le avant `blog/static/css/blog.css`. Cette ligne importera une police appelée *Lobster* à partir de Google Fonts (https://www.google.com/fonts).
+
+Retrouvez le bloc de règles `h1 a` (délimité par les accolades `{` `}`) dans le fichier css `blog/static/css/blog.css`. Ajoutez maintenant la ligne `font-family; 'Lobster',` dans les accolades et rafraîchissez la page :
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Super !
+
+Comme mentionné ci-dessus, CSS a un concept de classe. Ce concept vous permet de nommer une partie de code HTML et d'y appliquer des styles, uniquement pour cette partie, sans affecter le reste. Cela peut être très utile ! Peut-être que vous avez deux divs qui sont en train de faire quelque chose de différent (comme votre en-tête et votre contenu). Une classe peut vous aider à leur donner un aspect différent.
+
+Vous pouvez maintenant nommer certaines parties du code HTML. Remplacez l'élément `header` qui contient votre en-tête avec ce qui suit :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+Maintenant, ajoutez la classe `post` à votre `article` contenant votre blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>Date de publication: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Nous allons maintenant ajouter des blocs de règles aux différents sélecteurs. Les sélecteurs qui commencent par `.` désignent des classes. De nombreux tutoriels et explications sur le CSS existent sur le Web, cela pourra vous aider qui à comprendre le code suivant. Pour le moment, copiez et collez-le dans votre fichier `blog/static/css/blog.css` :
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Nous allons maintenant nous intéresser au code concernant les posts. Il va falloir remplacer le code le code suivant :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>Date de publication: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+se trouvant dans le fichier `blog/templates/blog/post_list.html` par :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Sauvegardez les fichiers modifiés et rafraîchissez votre page.
+
+![Figure 14.4](images/final.png)
+
+Woohoo ! Ça a l'air génial, non ? Intéressez-vous au code que nous venons juste de coller pour trouver quelles règles CSS sont appliquées aux sélecteurs HTML que nous avons nommés précédemment. Où feriez-vous le changement si l'on souhaite mettre la date en turquoise ?
+
+N'ayez pas peur de bricoler un peu le CSS et essayer de changer certaines choses. Jouer avec le CSS peut vous aider à comprendre comment et qui agit sur quoi. Si vous cassez quelque chose, ne vous inquiétez pas – vous pouvez toujours faire marche arrière !
+
+Nous vous recommandons chaudement de suivre les cours en ligne "Basic HTML & HTML5" et "Basic CSS" sur [freeCodeCamp](https://learn.freecodecamp.org/). Ils vous aideront à en apprendre plus sur le sujet et à créer de magnifiques sites web avec HTML et CSS.
+
+Prêt pour le chapitre suivant ? :)
\ No newline at end of file
diff --git a/fr-FR/deploy/README.md b/fr-FR/deploy/README.md
new file mode 100644
index 00000000000..67295d98cf3
--- /dev/null
+++ b/fr-FR/deploy/README.md
@@ -0,0 +1,250 @@
+# Déployer !
+
+> **Note** Le chapitre suivant peut-être un peu difficile à comprendre. Accrochez-vous et allez jusqu'au bout : le déploiement fait partie intégrale du processus de développement d'un site internet. Ce chapitre a été placé au milieu du tutoriel afin de permettre à votre coach de vous aider dans cette étape un peu compliquée qu'est la mise en ligne de votre site. Si jamais vous manquez de temps à la fin de la journée, ne vous inquiétez pas ! Une fois ce chapitre terminé, vous serez en mesure de finir le tutoriel chez vous :)
+
+Jusqu'à maintenant, votre site web est uniquement disponible sur votre ordinateur. Maintenant, vous allez apprendre à déployer! Déployer signifie mettre en ligne votre site pour que d'autres personnes puissent enfin voir votre app. :)
+
+Comme vous l'avez appris, un site web a besoin d'être installé sur un serveur. Il existe de nombreux fournisseurs de serveurs disponibles sur Internet, nous utiliserons [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere est gratuit pour les petites applications qui n'ont pas trop de visiteurs, donc ce sera certainement suffisant pour vous maintenant.
+
+Nous allons aussi utiliser les services [GitHub](https://www.github.com), ce qui nous permettra d'héberger notre code en ligne. Il existe d'autres entreprises qui proposent des services similaires. Cependant, presque tous⋅tes les développeurs·ses possèdent aujourd'hui un compte Github et, dans quelques instants, vous aussi !
+
+Ces trois endroits sont importants pour vous. Votre ordinateur local est l'endroit où vous faites de développement et de test. Lorsque vous êtes heureux avec le résultat, vous sauvegarderez une copie de votre programme sur GitHub. Votre site sera sur PythonAnywhere et vous le mettrez à jour en y mettant une copie de votre nouveau code sur GitHub.
+
+# Git
+
+> **Note** Si vous avez déjà effectué [l'installation](../installation/README.md), il n'est pas nécessaire de la refaire : vous pouvez passer à la partie suivante et commencer à créer votre dépôt Git
+
+{% include "/deploy/install_git.md" %}
+
+## Démarrer un dépôt Git
+
+Git conserve toutes les modifications apportées à un ensemble de fichiers dans un "repository" (ou "dépôt"). Nous allons devoir en créer un pour notre projet. Ouvrez votre terminal et allez dans le répertoire `djangogirls`. Ensuite, tapez les commandes suivantes :
+
+> **Note** : n'oubliez pas de vérifier dans quel répertoire vous vous trouvez avant d'initialiser votre dépôt. Pour cela tapez la commande `pwd` (OSX/Linux) ou `cd` (Windows). Vous devriez vous trouver dans le dossier `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+L'initialisation d'un dépôt git ne doit être faite qu'une seule fois par projet (et vous n'avez plus jamais besoin de re-saisir le nom d'utilisateur et adresse email).
+
+Git va surveiller les modifications faites à tous les fichiers et dossiers présents dans ce répertoire, mais il y a certains fichiers que nous voudrions qu'il ignore. Pour cela, nous allons créer un fichier appelé `.gitignore` dans le répertoire principal du projet. Ouvrez votre éditeur et créez un nouveau fichier en copiant le contenu suivant :
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Base de donnée
+    db.sqlite3
+    
+    # Dossier "static" à la racine du projet
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+     
+    Text
+    XPath: /pre[2]/code
+    
+    
+
+Enregistrez ce fichier sous le nom `.gitignore` dans votre répertoire principal "djangogirls".
+
+> **Attention** : le point au début du nom du fichier est important ! Si vous avez des difficultés à le faire (les Macs n'aiment pas que vous créiez des fichiers commençant par un point dans le Finder, par exemple), utilisez la fonction "Enregistrer sous" dans votre éditeur; ça marche toujours. N'ajoutez pas `.txt`, `.py`, ou d'autres extensions à la fin du nom. Git va reconnaitre le fichier seulement s'il porte le nom `.gitignore`. Linux et MacOS considèrent les fichiers commençant par `.` (comme `.gitignore`) comme étant cachés et la commande `ls` normale ne va pas montrer ces fichiers. Il faut utiliser `ls -a` pour voir le fichier `.gitignore`.
+> 
+> **Remarque** un de fichiers que vous avez spécifié dans votre fichier `.gitignore` est `db.sqlite3`. Ce fichier est votre base de données locale, où tous les utilisateurs et les articles que vous avez créés sont stockés. Suivant les bonnes pratiques du développement web, nous allons utiliser des bases de données distinctes pour votre site de test local et votre site Web en ligne sur PythonAnywhere. La base de données sur PythonAnywhere pourrait être du type SQLite, comme votre version locale. Normalement on lui préfèrerait une base de données du type MySQL, car capable de gérer un plus grand nombre de visiteurs. Quoi qu’il en soit, le fait que votre base de données SQLite soit ignorée lors de l'archivage sur GitHub implique que tous les messages et le superutilisateurs que vous avez créé jusqu'à présent ne seront disponibles que localement. Vous devrez les créer de nouveau en production. Vous devriez penser à votre base de données locale comme un terrain de jeux où vous pouvez tester différentes choses et ne pas avoir peur de supprimer vos messages réels sur votre blog.
+
+C'est une bonne idée d'utiliser la commande `git status` avant `git add` ou dès que vous n'êtes plus sûr de ce qui a changé dans le projet. Cela vous évitera des surprises comme ajouter ou envoyer un mauvais fichier. La commande `git status` permet d'obtenir des informations sur tous les fichiers non-suivis/modifiés/ajoutés, l'état de la branche, et bien plus encore. La commande devrait renvoyer ceci:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Et pour finir, nous allons enregistrer nos modifications. Tapez ces commandes dans votre terminal:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Publier votre code sur GitHub
+
+Allez sur [GitHub.com](https://www.github.com) et créez-vous un nouveau compte gratuitement. (Si vous l'avez déjà fait lors de la préparation pour l’atelier, c’est très bien !) N’oubliez pas de mémoriser votre mot de passe (ajoutez-le à votre gestionnaire de mot de passe, si vous en utilisez un).
+
+Ensuite, créez un nouveau dépôt en lui donnant le nom "mon-nouveau-blog". Laissez la case "initialisation avec README" décochée, laissez l'option .gitignore vide (nous l'avons fait manuellement) et laissez la Licence en tant que Aucune.
+
+![](images/new_github_repo.png)
+
+> **Note** : dans le cadre de ce tutoriel, le nom `mon-nouveau-blog` est très important. Cependant, vous êtes libre de le changer mais, attention : à chaque fois que ce nom apparaîtra dans le tutoriel, vous allez devoir le remplacer par le nom que vous avez choisi. Il est probablement plus simple de garder le nom `mon-nouveau-blog`.
+
+Dans l'image suivante, vous verrez le URL de votre dépôt, que vous utiliserez dans certaines commandes qui suivent (ex. pour cloner le dépôt) :
+
+![](images/github_get_repo_url_screenshot.png)
+
+Nous avons maintenant besoin de relier nos deux dépôts ("hook" en anglais) : celui sur notre ordinateur et celui sur GitHub.
+
+Tapez les instructions suivantes dans votre console (remplacez `<your-github-username>` avec le nom d'utilisateur de votre compte GitHub et sans les chevrons. Le URL doit correspondre exactement à l'URL que vous venez de voir) :
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Lorsque vous "poussez" sur GitHub, votre nom d’utilisateur ainsi que le mot de passe vous seront demandés (que ce soit dans la fenêtre de ligne de commande ou dans une fenêtre pop-up). Après avoir entré les informations d’identification, vous devriez voir quelque chose comme ceci :
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Votre code est maintenant sur GitHub. Allez jeter un coup d’œil ! Votre code est maintenant au même endroit que d'autres projets super cool : [Django](https://github.com/django/django), [le tutoriel Django Girls](https://github.com/DjangoGirls/tutorial) et les nombreux autres projets libres qui sont hébergés sur GitHub. :)
+
+# Mettre votre blog en ligne avec PythonAnywhere
+
+## Créez votre compte utilisateur sur PythonAnywhere
+
+> **Note** Vous avez peut être déjà créé un compte PythonAnyWhere au cours de la phase d'installation - si c'est le cas, inutile de le refaire.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configurer votre site sur PythonAnywhere
+
+Allez sur le [Panneau de Contrôle de PythonAnywhere](https://www.pythonanywhere.com/) en cliquant sur le logo, et choisissez l'option de démarrer un terminal "Bash". C'est comme votre terminal à vous, mais chez PythonAnywhere.
+
+![La section "nouveau terminal" sur l'interface web de PythonAnywhere, avec un bouton pour "bash"](images/pythonanywhere_bash_console.png)
+
+> **Note** : PythonAnywhere utilise Linux. Si vous êtes sous Windows, la console sera un peu différente de celle de votre ordinateur.
+
+Pour déployer une application sur PythonAnywhere, vous devez y télécharger votre code depuis GitHub, puis configurer PythonAnywhere pour qu'il la reconnaisse et commence à la faire tourner en tant qu'application web. Cela peut se faire de façon manuelle, mais PythonAnywhere fourni un outil qui va tout faire pour vous. Commençons par l'installer:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+Vous devriez voir quelque chose comme `Collecting pythonanywhere`, et au bout d'un moment une dernière ligne disant `Successfully installed (...) pythonanywhere-(...)`.
+
+Maintenant, nous exécutez l'assistant pour configurer automatiquement votre application à partir de GitHub. Tapez ce qui suit dans la console sur PythonAnywhere (n'oubliez pas d'utiliser votre nom d'utilisateur GitHub à la place de `<your-github-username>`, afin que l'URL corresponde à celle du clone de GitHub) :
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+En regardant la commande s'exécuter, vous devriez voir ce qui ce passe:
+
+- Téléchargement de votre code depuis GitHub
+- Création d'un virtualenv chez PythonAnywhere, comme celui sur votre propre ordinateur
+- Mise à jour de votre fichier de paramètres avec des paramètres de déploiement
+- Mise en place d’une base de données sur PythonAnywhere en utilisant la commande `manage.py migrate`
+- Mise en place de vos fichiers statiques (nous verrons ce que c'est plus tard)
+- Et configuration de PythonAnywhere pour servir votre application web via son API
+
+Sur PythonAnywhere toutes ces étapes sont automatisées, mais ce sont les mêmes étapes que vous auriez à faire avec n'importe quel autre fournisseur de serveurs.
+
+La principale chose à remarquer maintenant est que votre base de donnée sur PythonAnywhere est complètement séparée de votre base de données sur votre propre ordinateur. Cela veut dire qu'elle peut contenir des messages différents et avoir des comptes administrateurs différents. Et donc, exactement comme on l'avait fait sur votre ordinateur, on doit initialiser le compte administrateur avec `createsuperuser`. PythonAnywhere a initialisé votre virtualenv pour vous automatiquement, donc la seule chose que vous avez à faire est d'exécuter:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Entrez les informations pour votre compte administrateur. Mieux vaut utiliser les mêmes que sur votre ordinateur pour éviter toute confusion, sauf si vous voulez utiliser un mot de passe plus sécurisé sur PythonAnywhere.
+
+Maintenant, si vous voulez, vous pouvez aussi jeter un œil à votre code sur PythonAnywhere en utilisant la commande `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+Vous pouvez également accéder à la page "Fichiers" et naviguer à l'aide du navigateur de fichiers PythonAnywhere intégré. (Depuis la page Console, vous pouvez visiter d'autres pages PythonAnywhere en cliquant sur le bouton Menu en haut à droite. Une fois que vous vous trouvez dans une de ces pages, les liens vers les autres pages se trouve en haut.)
+
+## Vous êtes désormais sur Internet !
+
+Votre site devrait maintenant être accessible sur Internet ! Cliquez sur l'onglet "Web" dans PythonAnywhere pour y obtenir un lien. Vous pouvez partagez ce lien avec qui vous voulez. :)
+
+> **Note** Ce tutoriel est conçu pour les débutants, et pendant le déploiement on a pris quelques raccourcis qui, d'un point de vue de la sécurité, ne sont pas idéaux. Quand vous voudrez aller plus loin dans ce projet, ou commencer un nouveau projet, vous devriez consulter la [Checklist de déploiement pour Django](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) pour obtenir des conseils sur comment sécuriser votre site.
+
+## Conseils en cas de bug
+
+Si vous constatez une erreur en exécutant le script `pa_autoconfigure_django.py`, voici quelques causes courantes :
+
+- Oubli de créer votre "jeton API" pour PythonAnywhere.
+- Faire une erreur dans votre URL GitHub
+- Si vous voyez un message d’erreur indiquant *« Could not find your settings.py »*, vous avez probablement oublié d'ajouter tous vos fichiers sur Git, et/ou vous ne les avez pas envoyé à GitHub. Regardez à nouveau la section Git ci-dessus
+- Si vous avez précédemment créé un compte PythonAnywhere et avez rencontré une erreur avec collectstatic, vous avez probablement une version antérieure de SQLite (par ex : 3.8.2) sur votre compte. Dans ce cas, créez un nouveau compte et essayez les commandes présentes dans la section PythonAnywhere ci-dessus.
+
+Si vous constatez une erreur lorsque vous essayez de visiter votre site web, les **logs d'erreurs** devraient vous permettre de comprendre ce qui ne marche pas. Vous trouverez un lien vers les logs dans la page [Web](https://www.pythonanywhere.com/web_app_setup/) de PythonAnywhere. Regardez s’il y a des messages d’erreurs ; les plus récents seront en bas du fichier.
+
+Vous pourrez aussi trouver des astuces pour le débogage sur le site d'aide de[PythonAnywhere](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+Et n'oubliez pas, votre coach est là pour vous aider !
+
+# Jetez un œil à votre site !
+
+La page par défaut de votre site doit dire "Ça marche!", comme c'est le cas sur votre ordinateur local. Vous pouvez essayer d'accéder à l'interface d’administration en ajoutant `/admin/` à la fin de l'URL. Normalement, une page de login devrait s'afficher. Identifiez-vous avec votre nom d'utilisateur et mot de passe et vous verrez que vous pourrez créer de nouveaux messages sur le serveur. N'oubliez pas que les messages dans votre base de données locale n'ont pas été envoyés sur la version en ligne de votre blog.
+
+Une fois que vous avez créé des messages, vous pouvez revenir à votre configuration locale (pas PythonAnywhere). De là, vous devez travailler sur votre installation locale pour apporter des modifications. C'est la façon habituelle de procéder dans le développement web : faire des modifications localement, envoyer ces modifications sur GitHub, puis télécharger ces modifications vers votre serveur Web de production. Cela vous permet de faire des expériences sans endommager votre site web de production (celui sur Internet). Cool, non ?
+
+*Félicitations !* Le déploiement est l’une des parties les plus épineuses du développement web et il faut souvent plusieurs jours avant d'obtenir quelque chose de fonctionnel. Mais vous avez réussi à mettre votre site en ligne, dans le vrai Internet !
\ No newline at end of file
diff --git a/fr-FR/deploy/install_git.md b/fr-FR/deploy/install_git.md
new file mode 100644
index 00000000000..23fb476e80d
--- /dev/null
+++ b/fr-FR/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git est un " système de gestion de versions" utilisé par de nombreux développeurs. Ce logiciel permet de garder une trace des modifications apportées à chaque fichier afin que vous puissiez facilement revenir en arrière ou à une version spécifique. Un peu comme la fonction « suivi des modifications » dans les programmes de traitement de texte (par exemple, Microsoft Word ou LibreOffice Writer), mais beaucoup plus puissant.
+
+## Installer Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Vous pouvez télécharger Git sur [git-scm.com](https://git-scm.com/). Vous pouvez cliquer sur "suivant" pour toutes les étapes sauf deux : au moment de choisir l'éditeur, sélectionnez Nano ; à l'étape intitulée "Adjusting your PATH environment", sélectionnez "Use Git and optional Unix tools from the Windows Command Prompt" (l'option du bas). Les autres choix par défaut n'ont pas besoin d'être modifiés. Laissez cocher l'option "Checkout Windows-style, commit Unix-style line endings".
+
+N'oubliez pas de fermer puis relancer l'invite de commande ou la fenêtre Powershell une fois l'installation terminée. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Téléchargez Git sur [git-scm.com](https://git-scm.com/) et suivez les instructions.
+
+> **Note** Si vous utilisez un OS X 10.6, 10.7 ou 10.8, vous devrez sans doute installer la version de git présente ici : [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/fr-FR/deploy/signup_pythonanywhere.md b/fr-FR/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..13999332854
--- /dev/null
+++ b/fr-FR/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere est un service qui permet de faire tourner des programmes en Python sur des serveurs "dans le cloud". Nous allons l'utiliser pour héberger notre site, en direct et sur Internet.
+
+Nous allons donc mettre le blog que nous sommes en train de construire sur PythonAnywhere. Pour commencer, créez un compte « Débutant » (beginner) sur PythonAnywhere (le niveau gratuit est très bien, vous n’avez pas besoin d’une carte de crédit).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![La page de login de PythonAnywhere contenant un bouton pour créer le compte gratuit pour 'Débutant'](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** Lorsque vous choisissez votre nom d'utilisateur, gardez à l'esprit que l'URL de votre blog prendra la forme `nomutilisateur.pythonanywhere.com`, alors choisissez un pseudonyme ou un nom adapté pour votre blog. Mémorisez votre mot de passe (ajoutez-le à votre gestionnaire de mot de passe, si vous en utilisez un).
+
+## Création d’un jeton API pour PythonAnywhere
+
+C'est quelque chose que vous n'aurez à faire qu'une seule fois. Lorsque vous serez inscrit à PythonAnywhere, vous vous retrouverez sur votre tableau de bord. Trouvez le lien en haut à droit de votre page "Compte":
+
+![Lien du compte en haut à droite sur la page](../deploy/images/pythonanywhere_account.png)
+
+sélectionnez l'onglet nommé "API token", et cliquez sur le bouton "Créer un nouveau jeton API".
+
+![L'onglet API sur la page Compte](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/fr-FR/django/README.md b/fr-FR/django/README.md
new file mode 100644
index 00000000000..62674aa7890
--- /dev/null
+++ b/fr-FR/django/README.md
@@ -0,0 +1,27 @@
+# Qu'est-ce que Django?
+
+Django (*/ˈdʒæŋɡoʊ/ jang-goh*) est un framework web gratuit et open-source écrit en Python. Un framework web est un ensemble de composants qui vous aide à développer des sites web plus rapidement et plus facilement.
+
+Lorsque vous créez un site web, vous avez souvent besoin de la même chose : une manière de gérer l'authentification de vos utilisateurs (créer un compte, se connecter, se déconnecter), une partie dédiée à la gestion de votre site, des formulaires, une manière de mettre en ligne des fichiers, etc.
+
+Heureusement pour vous, d'autres personnes ont réalisé depuis longtemps que les développeurs web font face aux mêmes problèmes lors de la construction d'un nouveau site, donc ils travaillent ensemble et créent un framework (Django étant un) qui vous donne des composants prêts à l'emploi.
+
+Les frameworks existent pour vous éviter d'avoir à réinventer la roue et aider à réduire les frais généraux lorsque vous construisez de nouveaux sites.
+
+## Pourquoi est-ce que vous auriez besoin d'un framework ?
+
+Pour comprendre ce qu'est exactement Django, nous devons regarder de plus près le serveur. La première chose est que le serveur doit savoir que vous voulez vous servir une page Web.
+
+Imaginez une boîte aux lettres (un port) dont l'arrivée de lettres (une requête) serait surveillée. C'est le travail qu'effectue le serveur. Le serveur Web lit la lettre et renvoie une page Web en réponse. Généralement, lorsque vous voulez envoyer quelque chose, vous avez besoin de contenu. Django est un outil qui va vous aider à créer ce contenu.
+
+## Que se passe-t-il quand quelqu'un demande un site web à votre serveur ?
+
+Lorsqu'une requête arrive sur un serveur web, elle est transmise à Django dont le premier travail va être de comprendre ce qui est demandé. Il s'occupe tout d'abord de l'adresse de page Web et essaie de savoir quoi faire. Ce travail est effectué par le routeur de Django, l'**urlresolver** (à savoir qu'une adresse web est appelé URL - Uniform Resource Locator - d'où le nom d'*urlresolver*). Ce n'est pas très intelligent - il faut renseigner une liste de modèles pour faire correspondre une URL. Django vérifie dans l'ordre les modèles, et si correspondance il y a, alors il transmet la requête à la fonction associée (appelé *vue*).
+
+Afin d'y voir un peu plus clair, imaginez un facteur transportant une lettre. Il descend la rue et vérifie à chaque maison si le numéro de celle-ci correspond à celui de la lettre. Si les deux numéros correspondent, il met la lettre dans la boîte aux lettres de cette maison. C'est à peu près comme cela que fonctionne l'urlresolver !
+
+C'est dans la fonction de la *vue* que les choses se passent : nous allons pouvoir jeter un œil dans la base de données pour obtenir d'avantage d'informations. Par exemple, peut-être que l'utilisateur demande à changer quelque chose dans ces données ? Ce serait comme une lettre dont le contenu serait : "Merci de changer la description de mon emploi actuel". La *vue* va tout d'abord vérifier que l'utilisateur est bien autorisé à effectuer ce changement puis elle corrigera la description de l'emploi. Enfin, la *vue* générera une réponse de type "Travail terminé !" que Django pourra retourner à l'utilisateur.
+
+Ceci n'est qu'une description très simplifiée du processus. Vous n'avez pas besoin de connaître tous les détails techniques pour le moment : cette vue d'ensemble suffira largement.
+
+Au lieu de vous assommer avec des détails complexes, nous allons plutôt commencer à construire quelque chose avec Django et nous allons apprendre les choses importantes au fur et à mesure !
\ No newline at end of file
diff --git a/fr-FR/django_admin/README.md b/fr-FR/django_admin/README.md
new file mode 100644
index 00000000000..c2d063a88b9
--- /dev/null
+++ b/fr-FR/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+Pour ajouter, modifier et supprimer les posts que nous venons de créer, nous allons utiliser l'interface Django admin.
+
+Ouvrons le fichier `blog/admin.py` dans l'éditeur de code et remplaçons son contenu par ceci :
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Comme vous pouvez le voir, nous importons le modèle « Post » que nous avons écrit dans le chapitre précédent. Afin que notre modèle soit visible dans l'interface d'administration, nous avons besoin d'enregistrer notre modèle à l'aide de `admin.site.register(Post)`.
+
+Voilà, il est temps de jeter un œil à notre modèle Post. N'oubliez pas d'exécuter `python manage.py runserver` dans votre console afin de lancer le serveur web. Retourner sur votre navigateur et taper l'adresse http://127.0.0.1:8000/admin/. Vous verrez une page de login qui ressemble à celle-ci :
+
+![Page de login](images/login_page2.png)
+
+Afin de vous connecter, vous allez devoir créer un *superuser*, c'est à dire un utilisateur qui contrôlera l'intégralité du site. Retournez à votre ligne de commande : tapez `python manage.py createsuperuser` puis appuyez sur entrée.
+
+> Conseil : pour pouvoir taper de nouvelles commandes pendant que le serveur tourne, ouvrez une nouvelle console et activez à nouveau votre virtualenv. La section **Démarrer le serveur web** du chapitre **Votre premier projet Django !** explique comment écrire de nouvelles commandes.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Tapez votre nom d'utilisateur (en minuscules, sans espace), votre email et votre mot de passe. **Ne soyez pas surpris de ne pas voir le mot de passe quand vous le saisissez, c'est normal.** Saisissez le à l'aveugle et appuyez sur `Entrée` pour continuer. Vous devrez obtenir quelque chose comme ceci (où le nom d'utilisateur et le mail correspond à ce que vous avez saisi) :
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Retournez dans votre navigateur et connectez-vous en tant que superutilisateur grâce à l'utilisateur que vous venez de créer. Vous devriez accéder à l'interface d'administration de Django.
+
+![Django admin](images/django_admin3.png)
+
+Allons du côté des Posts et jouons un peu avec. Créez 5 ou 6 blog posts. Ne vous inquiétez pas trop du contenu, qui ne sera visible que depuis votre ordinateur. Vous pouvez copier-coller des morceaux du tutoriel pour aller plus vite. :)
+
+Assurez-vous quelques posts (mais pas tous) aient une date de publication. Cela sera utile plus tard.
+
+![Django admin](images/edit_post3.png)
+
+Si vous voulez en savoir plus sur l'interface d'administration de Django, n'hésitez pas à consulter la documentation du framework : https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Cela peut être un bon moment pour prendre un café (ou un thé) ou quelque chose à manger pour vous redynamiser. Vous avez créé votre premier modèle Django - vous méritez une petite pause!
\ No newline at end of file
diff --git a/fr-FR/django_forms/README.md b/fr-FR/django_forms/README.md
new file mode 100644
index 00000000000..97c9cf19845
--- /dev/null
+++ b/fr-FR/django_forms/README.md
@@ -0,0 +1,479 @@
+# Formulaires Django
+
+La dernière chose que nous voulons faire sur notre site web, c'est créer une manière sympathique d'ajouter ou éditer des blog posts. L'interface d'administration (`/admin`) de Django est cool, mais elle est assez complexe à personnaliser et à rendre jolie. Les formulaires (`forms`) vont nous donner un pouvoir absolu sur notre interface : nous allons être capables de faire à peu près tout ce que nous pouvons imaginer !
+
+Ce qui est pratique avec les formulaires Django, c'est que nous pouvons aussi bien en définir un à partir de rien ou créer un `ModelForm` qui va enregistrer le résultat du formulaire dans un modèle.
+
+C'est la seconde solution que nous allons utiliser pour créer un formulaire pour notre modèle `Post`.
+
+Comme toutes les choses importantes dans Django, les formulaires ont leur propre fichier : `forms.py`.
+
+Nous allons devoir créer un fichier avec ce nom dans notre dossier `blog`.
+
+    blog
+       └── forms.py
+    
+
+Ouvrez maintenant ce fichier dans l'éditeur de code et tapez le code suivant :
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Tout d'abord, nous avons besoin d'importer les formulaires Django (`from django import forms`), puis notre modèle `Post` (`from .models import Post`).
+
+Comme vous l'avez probablement deviné, `PostForm` est le nom de notre formulaire. Nous avons besoin d'indiquer à Django que ce formulaire est un `ModelForm` (pour que Django fasse certaines choses automatiquement pour nous). Pour cela, nous utilisons `forms.ModelForm`.
+
+Ensuite, nous avons la `class Meta` qui nous permet de dire à Django quel modèle il doit utiliser pour créer ce formulaire (`model = Post`).
+
+Enfin, nous précisions quel⋅s sont le⋅s champ⋅s qui doivent figurer dans notre formulaire. Dans notre cas, nous souhaitons que seuls `title` et `text` apparaissent dans notre formulaire. Nous obtiendrons les autres données différemment : par exemple, on s'attend à ce que l'auteur (`author`) soit la personne actuellement connectée (c'est à dire vous !) et que la date de création `created_date` soit générée automatiquement lors de la création du post (cf code que nous avons écrit).
+
+Et voilà, c'est tout ! Tout ce qu'il nous reste à faire, c'est d'utiliser ce formulaire dans une *vue* et de l'afficher dans un template.
+
+Nous allons donc une nouvelle fois suivre le processus suivant et créer : un lien vers la page, une URL, une vue et un template.
+
+## Lien vers une page contenant le formulaire
+
+Avant d'ajouter le lien, nous avons besoin d'icônes que nous allons utiliser comme boutons pour le lien. Pour ce tutoriel, téléchargez [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) et enregistrez-le dans le dossier `blog/templates/blog/icons/`
+
+> Remarque : Pour télécharger l'image SVG, ouvrez le menu contextuel du lien (en cliquant avec le bouton droit de la souris) et sélectionnez "Enregistrer le lien sous". Dans la boîte de dialogue vous demandant où enregistrer le fichier, choisissez le répertoire `djangogirls` de votre projet Django, et à l'intérieur du sous-répertoire `blog/templates/blog/icons/`, et enregistrez le fichier à cet endroit.
+
+Il est temps d'ouvrir `blog/templates/blog/base.html` dans l'éditeur de code. Maintenant nous pouvons utiliser ce fichier d'icônes à l'intérieur du template de base comme suit. Dans l'élément `div` à l'intérieur de la section `header` , nous ajouterons un lien avant l'élément `h1`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Remarquez que notre nouvelle vue s'appelle `post_new`. L'icône [SVG](https://icons.getbootstrap.com/icons/file-earmark-plus/) est fournie par les [icônes Bootstrap](https://icons.getbootstrap.com/) et elle affichera une icône de page avec le signe plus. Nous utilisons une directive de modèle Django appelée `include`. Cela injectera le contenu du fichier dans le template Django. Le navigateur web sait comment gérer ce type de contenu sans aucun traitement supplémentaire.
+
+> Vous pouvez télécharger toutes les icônes Bootstrap [ici](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Décompressez le fichier et copiez tous les fichiers image SVG vers un nouveau dossier dans `blog/templates/blog/` intitulé `icons`. De cette façon, vous pouvez accéder à une icône comme `pencil-fill.svg` en référençant le chemin du fichier `blog/templates/blog/icons/pencil-fill.svg`
+
+Après avoir ajouté cette ligne, votre fichier HTML devrait maintenant ressembler à ceci :
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Normalement, après avoir sauvegardé et rechargé la page http://127.0.0.1:8000, vous devriez encore tomber sur l'erreur `NoReverseMatch`. Est-ce le cas ? Très bien !
+
+## URL
+
+Ouvrez le fichier `blog/urls.py` dans l'éditeur de code et ajoutez cette ligne :
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+Votre fichier doit maintenant ressembler à ceci :
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+Une fois la page rechargée, vous allez voir une `AttributeError`, ce qui est normal. Nous n'avons pas encore implémenté la vue `post_new`. Faisons-le maintenant.
+
+## La vue post_new
+
+Ouvrez maintenant le fichier `blog/views.py` dans l'éditeur de code et ajoutez les lignes suivantes avec celles du `from` qui existent déjà :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+Puis dans la *vue* :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Afin de pouvoir créer un nouveau formulaire `Post`, nous avons besoin d'appeler la fonction `PostForm()` et de la passer au template. Nous reviendrons modifier cette *vue* plus tard, mais pour l'instant, créons rapidement un template pour ce formulaire.
+
+## Template
+
+Nous avons à présent besoin de créer un fichier `post_edit.html` dans le dossier `blog/templates/blog` et de l'ouvrir dans l'éditeur de code. Afin que notre formulaire fonctionne, nous avons besoin de plusieurs choses :
+
+* Nous avons besoin d'afficher le formulaire. Pour cela, nous n'avons qu'à utiliser {% raw %}`{{ form.as_p }}`{% endraw %}.
+* La ligne précédente va avoir besoin d'être entourée des balises HTML `<form method="POST">...</form>`.
+* Nous avons besoin d'un bouton `Valider`. Nous allons le créer à l'aide d'un bouton HTML : `<button type="submit">Valider</button>`.
+* Enfin, nous devons ajouter {% raw %}`{% csrf_token %}`{% endraw %} juste après `<form ...>`. C'est très important car c'est ce qui va permettre de sécuriser votre formulaire ! Si vous oubliez ce détail, Django se plaindra lorsque vous essaierez de sauvegarder le formulaire:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+Ok, voyons maintenant à quoi devrait ressembler le HTML contenu dans le fichier `post_edit.html` :
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Rafraîchissons la page ! Et voilà : le formulaire s'affiche !
+
+![New form](images/new_form2.png)
+
+Mais attendez une minute! Lorsque vous taperez quelque chose dans les champs `title` et `text` et essayez de le sauvegarder, que se passera-t-il?
+
+Absolument rien ! Nous retombons sur la même page sauf qu'en plus, notre texte a disparu et aucun article ne semble avoir été créé. Que s'est-il passé ?
+
+La réponse est : rien ! Nous avons juste encore un peu de travail à accomplir. Retournons à notre *vue*.
+
+## Sauvegarder le contenu du formulaire
+
+Ouvrez à nouveau `blog/views.py` dans l'éditeur de code. Actuellement, `post_new` n'est composé que des lignes de code suivantes :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Lorsque nous envoyons notre formulaire, nous revenons à la même vue. Cependant, nous récupérons les données dans `request`, et plus particulièrement dans `request.POST` (le nom "POST" n'a aucun lien avec nos "posts" de blog : il est lié au type de requête effectué à l'envoi des données). Vous rappelez-vous comment dans le fichier HTML, notre définition de la variable `<form>` avait la méthode `method="POST"`? Tous les champs du formulaire se trouvent maintenant dans `request.POST`. Veillez à ne pas renommer `POST` en quoi que ce soit d'autre : la seule autre valeur autorisée pour `method` est `GET`. Malheureusement, nous n'avons pas le temps de rentrer dans les détails aujourd'hui.
+
+Donc dans notre *vue* nous avons deux situations différentes à gérer : la première quand on accède à la page pour la première fois et nous voulons un formulaire vide, et la seconde quand on revient à la *vue* avec les données que l'on a saisies dans le formulaire. Pour gérer ces deux cas, nous allons utiliser une condition `if` (si) :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+Il faut maintenant remplir à l'endroit des pointillés `[...]`. Si `method` contient `POST` alors on veut construire le `PostForm` avec les données du formulaire, n'est-ce pas ? Nous allons le faire comme cela :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+La prochaine étape est de vérifier que le formulaire a été rempli correctement (tous les champs obligatoires ont été remplis et aucune valeur incorrecte n'a été envoyée). Nous allons faire ça en utilisant `form.is_valid()`.
+
+Testons donc si notre formulaire est valide et, si c'est le cas, sauvegardons-le !
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+En gros, nous effectuons deux choses ici : nous sauvegardons le formulaire grâce à `form.save` et nous ajoutons un auteur. Rappelez vous, il n'y avait pas de champ `author` dans le `PostForm` mais nous avons obligatoirement besoin d'un auteur pour que le formulaire que nous avons créé soit valide. `commit=False` signifie que nous ne voulons pas encore enregistrer notre modèle `Post`. Nous voulons d'abord ajouter un auteur. La plupart du temps, vous utiliserez `form.save()` sans `commit=False`. Mais ici nous en avons besoin. `post.save()` sauvegardera les changements, c'est-à-dire l'ajout d'un auteur. Et voilà, un nouveau post de blog est créé !
+
+Enfin, ce serait génial si nous pouvions tout de suite aller à la page `post_detail` du post de blog que nous venons de créer. Pour cela, nous avons besoin d'importer une dernière chose :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Ajoutez-le au tout début de votre fichier. Maintenant, nous allons ajouter la ligne qui signifie "aller à la page `post_detail` pour le nouveau post qui vient d'être créé":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` est le nom de la vue où nous voulons aller. Rappelez-vous : une *vue* a besoin d'une variable `pk`. Afin de le passer à la vue, nous utilisons `pk=post.pk`, où `post` désigne le blog post nouvellement créé !
+
+Et si au lieu de parler, nous vous montrions à quoi ressemble maintenant notre *vue* ?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Voyons si ça marche. Allez à l'adresse http://127.0.0.1:8000/post/new/, ajoutez des valeurs dans les champs `title` et du `text`, sauvegardez ... et voilà ! Le nouveau post est bien créé et vous êtes redirigé vers la page `post_detail` !
+
+Vous avez peut-être remarqué que nous avons choisi une date de publication avant de sauvegarder le post. Nous en aurons besoin lorsque nous créerons le *publish button* (bouton publier) dans **l'une des extensions du tutoriel Django Girls** (en anglais).
+
+Encore bravo !
+
+> Comme nous avons récemment utilisé l'interface d'administration de Django, le système pense que nous sommes toujours connectés. Cependant, il y a plusieurs cas qui peuvent amener un utilisateur à être déconnecté : fermer le navigateur, redémarrer la base de données, etc. Si jamais vous obtenez des erreurs lors de la création d'un post qui disent que vous n'êtes pas connecté, retournez sur la page d'administration présente à l'adresse http://127.0.0.1:8000/admin et connectez vous à nouveau. Cependant, vous devinez bien que cette solution n'est pas suffisante à long terme. Afin de corriger ce problème, n'hésitez pas à faire la partie **Devoir : ajouter de la sécurité à son site internet !** qui est située juste après la partie principale du tutoriel.
+
+![Logged in error](images/post_create_error.png)
+
+## Validation de formulaire
+
+Maintenant, nous allons vous montrer à quel point les formulaires Django sont cools ! Un post de blog a besoin de champs `title` (titre) et `text` (texte). Dans notre modèle `Post`, nous n'avons pas signalé que ces champs n'étaient pas obligatoire (à l'inverse de `published_date`). Django s'attend donc à ce qu'ils soient remplis à chaque fois.
+
+Essayez de sauvegarder un formulaire sans mettre de `titre` ou de `texte`. Devinez ce qui va se passer !
+
+![Form validation](images/form_validation2.png)
+
+Django va s'occuper de la validation : il va regarder si tous les champs de notre formulaire sont en adéquation avec notre modèle. C'est cool, non ?
+
+## Éditer un formulaire
+
+Maintenant, nous savons comment ajouter un nouveau post. Comment faire pour en modifier un qui existe déjà ? C'est très similaire à ce que nous venons de faire. Tout d'abord, faisons rapidement quelques choses importantes. (Si vous ne comprenez pas quelque chose, vous devriez demander à votre entraîneur ou regarder les chapitres précédents, car nous avons déjà traité toutes ces étapes.)
+
+Tout d'abord, enregistrons l'icône qui représente le bouton d'édition. Téléchargez [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) et enregistrez-le dans le dossier `blog/templates/blog/icons/`.
+
+Ouvrez `blog/templates/blog/post_detail.html` dans l'éditeur de code et ajoutez le code suivant dans l'élément `article`:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+Votre template doit maintenant ressembler à ceci :
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Ouvrez le fichier `blog/urls.py` dans l'éditeur de code et ajoutez cette ligne :
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+Nous allons réutiliser le template de `blog/templates/blog/post_edit.html`. Il ne va donc nous manquer qu'une *vue*.
+
+Ouvrons `blog/views.py` dans l'éditeur de code et ajoutons à la toute fin du fichier :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Vous ne trouvez pas que ça ressemble presque exactement à la vue de `post_new` ? Regardons un peu plus en détails. Tout d'abord, nous passons un paramètre `pk` supplémentaire. Ensuite, nous récupérons le modèle `Post` que nous souhaitons éditer à l'aide de `get_object_or_404(Post, pk=pk)`. Puis, lorsque nous créons un formulaire, nous passons ce post comme une `instance`, d'abord lorsque nous sauvegardons le formulaire…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…Puis ensuite lorsque nous ouvrons le formulaire associé à ce post afin de l'éditer :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+Alors, voyons si ça marche ! Allons à la page `post_detail`. Un bouton d'édition devrait apparaître dans le coin supérieur droit de la page :
+
+![Edit button](images/edit_button2.png)
+
+Lorsque vous cliquez dessus, vous devez voir le formulaire du post de blog apparaître :
+
+![Edit form](images/edit_form2.png)
+
+N'hésitez pas à changer le titre ou le texte et à enregistrer les modifications!
+
+Bravo ! Votre application s'enrichit de plus en plus de fonctionnalités !
+
+Si vous souhaitez en apprendre plus sur les formulaires Django, n'hésitez pas à consulter la documentation associée : https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Sécurité
+
+C’est génial de pouvoir créer de nouveaux posts juste en cliquant sur un lien ! Mais maintenant, toute personne visitant votre site sera en mesure de créer un nouveau post, et ce n'est peut-être pas ce que vous voulez. Faisons en sorte que les boutons apparaissent pour vous mais pas pour les autres.
+
+Ouvrez `blog/templates/blog/base.html` dans l'éditeur de code, trouvez notre `div` `page-header` et la balise ancre que vous y avez mis plus tôt. Ça doit ressembler à ça :
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Nous allons y ajouter une autre balise `{% if %}` qui ne fera apparaitre le lien qu’aux utilisateurs⋅trices connecté⋅e⋅s avec les droits d'administration. C'est à dire pour le moment, seulement vous ! Changez la balise `<a>` comme ceci :
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+Ce `{% if %}` fait en sorte de n’envoyer le lien au navigateur que si l’utilisateur⋅trice demandant la page est connecté⋅e. Cela ne n'empêche pas complètement la création de nouveaux posts, mais c’est un bon début. Nous reviendrons sur les questions de sécurité dans les extensions du tutoriel.
+
+Rappelez-vous l'icône de modification que nous venons d'ajouter à notre page de détails? Nous souhaitons également ajouter les mêmes modifications, afin que les autres utilisateurs ne puissent pas modifier les publications existantes.
+
+Ouvrez le fichier `blog/templates/blog/post_detail.html` dans l'éditeur de code et trouvez la ligne suivante :
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Changez-la en ceci:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Parce vous êtes sans doute déjà connecté⋅e⋅s, vous ne verrez aucune différence si vous rafraîchissez la page. Mais si vous chargez la page dans un navigateur web différent ou dans une fenêtre en mode "navigation privée" ou "incognito", vous verrez que le lien ne s'affiche plus, et l’icône non plus !
+
+## Encore un petit effort : déployons !
+
+Nos modifications fonctionnent-elles sur PythonAnywhere ? Pour le savoir, déployons à nouveau !
+
+* Tout d'abord, commitez votre nouveau code et pushez le à nouveau sur GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git pus
+    
+
+* Puis, dans la console bash de [PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}Ligne de commande PythonAnywhere{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(N’oubliez pas de remplacer `<your-pythonanywhere-domain>` avec votre propre sous-domaine PythonAnywhere, sans les chevrons.)
+
+* Enfin, allez sur ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (utilisez le bouton de menu en haut à droite de la console) et cliquez **Reload**. Actualisez votre blog https://subdomain.pythonanywhere.com pour voir les changements.
+
+Et normalement c'est tout ! Félicitations ! :)
\ No newline at end of file
diff --git a/fr-FR/django_installation/README.md b/fr-FR/django_installation/README.md
new file mode 100644
index 00000000000..9e0e85acc8a
--- /dev/null
+++ b/fr-FR/django_installation/README.md
@@ -0,0 +1,7 @@
+# Installation de Django
+
+> **Note** Si vous utilisez un Chromebook, passez ce chapitre mais prenez soin de suivre les instructions de [configuration pour Chromebook](../chromebook_setup/README.md).
+> 
+> **Note **Si vous avez déjà effectué [l'Installation](../installation/README.md) vous devriez déjà avoir fait ce qui suit. Vous pouvez donc passer directement au chapitre suivant !
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/fr-FR/django_installation/instructions.md b/fr-FR/django_installation/instructions.md
new file mode 100644
index 00000000000..09f5715f857
--- /dev/null
+++ b/fr-FR/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Note : ce chapitre est en partie inspiré d'un autre tutoriel réalisé par les Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Ce chapitre est en partie inspiré du [tutoriel django-marcador](http://django-marcador.keimlink.de/) qui est sous licence Creative Commons Attribution-ShareAlike 4.0 International License. Le tutoriel django-marcador a été créé par Markus Zapke-Gründemann et al.
+
+## L'environnement virtuel
+
+Avant d'installer Django, nous allons vous faire installer un outil extrêmement utile qui vous aidera à maintenir votre environnement de développement propre. Nous vous recommandons fortement de ne pas sauter cette étape, même si elle n'est pas indispensable. En commençant avec la meilleure configuration possible vous éviterez beaucoup de problèmes par la suite !
+
+Donc, commençons par créer un **environnement virtuel de programmation** (ou *virtualenv*). Chaque projet aura sa propre configuration en Python/Django grâce à virtualenv. Ce qui veut dire que si vous modifiez un site web, ça n'affectera pas les autres sites sur lesquels vous travaillez. Plutôt cool, non ?
+
+Tout ce dont vous avez besoin, c'est de trouver un dossier où vous voulez créer votre `virtualenv` ; vous pouvez choisir votre répertoire "home" par exemple. Sous Windows, le home ressemble à `C:\Utilisateurs\Nom` (où `Nom` est votre login).
+
+> **Note:** Sur Windows, assurez-vous que le chemin vers ce répertoire ne contienne pas d'accents ou autres caractères spéciaux; si c'est la cas, utilisez un répertoire différent, par exemple `C:\djangogirls`.
+
+Dans ce tutoriel, nous allons utiliser un nouveau dossier `djangogirls` que vous allez créer dans votre dossier home :
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Nous allons créer un virtualenv appelé `myvenv`. Pour cela, nous taperons une commande qui ressemblera à :
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Pour créer un nouveau `virtualenv`, vous devez ouvrir un terminal et exécuter `python -m venv myvenv`. Voici ce à quoi ça devrait ressembler:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Où `myvenv` est le nom de votre `virtualenv`. Vous pouvez choisir un autre nom mais attention : il doit être en minuscules, sans espaces et sans accents ou caractères spéciaux. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Pour créer un `virtualenv` sous Linux ou OS X, tapez simplement la commande `python3 -m venv myvenv`. Ça ressemblera à ça :
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` est le nom de votre `virtualenv`. Vous pouvez choisir un autre nom, mais veillez à n'utiliser que des minuscules et à n'insérer ni espaces, ni caractères spéciaux. C'est aussi une bonne idée de choisir un nom plutôt court, car vous aller souvent l'utiliser!
+
+> **Note:** sur certaines versions de Debian/Ubuntu vous pouvez avoir l'erreur suivante:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> Dans ce cas, suivez les instructions ci-dessus et installez le paquet `python9-venv`: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **Note:** Sur certaines version de Debian/Ubuntu, initialiser l’environnement virtuel de cette façon donne l'erreur suivante:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Pour résoudre ce problème, utilisez plutôt la commande `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **Note:** Si vous avez une erreur telle que :
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> alors exécutez plutôt :
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Travailler avec virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Démarrez votre environnement virtuel en exécutant :
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Utilisateurs\Nom\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. Dans ce cas ouvrez une autre console Windows PowerShell avec l'option "ouvrir en tant qu'administrateur". Puis essayer d'exécuter la commande suivante avant de démarrer votre environnement virtuel :
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> L'avantage, c'est que vous n'aurez pas à constamment passer de l'éditeur aux lignes de commandes
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Démarrez votre environnement virtuel en exécutant :
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+N'oubliez pas de remplacer `myvenv` par le nom que vous avez choisi pour votre `virtualenv` (le cas échéant) !
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+Vous saurez que votre `virtualenv` est lancé quand le prompt de votre console est précédé de `(myvenv)`.
+
+Quand vous travaillez dans un environnement virtuel, la commande `python` fera automatiquement référence à la bonne version de Python. Vous pouvez donc utiliser `python` plutôt que `python3`.
+
+Ok, nous avons installé toutes les dépendances dont nous avions besoin. Nous allons enfin pouvoir installer Django !
+
+## Installation de Django {#django}
+
+Maintenant que vous avez activé votre `virtualenv`, vous pouvez installer Django.
+
+Avant de faire cela, nous devons nous assurer que nous avons la dernière version de `pip`, le programme que nous allons utiliser pour installer Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installer des paquets avec un fichier "requirements"
+
+Un fichier "requirement" maintient une liste des dépendances qui doivent être installées avec `pip install`:
+
+Tout d'abord, créez un fichier `requirements.txt` dans votre dossier `djangogirls`, en utilisant l'éditeur de texte que vous avez téléchargé précédemment. Pour ce faire, ouvrez un nouveau fichier dans l'éditeur et sauvegarde-le à l'intérieur du dossier `djangogirls/` en lui donnant le nom `requirements.txt`. Votre dossier ressemble maintenant à ceci :
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+Dans ce fichier `djangogirls/requirements.txt` vous devez ajouter ceci :
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Maintenant, exécutez `pip install -r requirements.txt` pour installer Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). Si c'est le cas, changez de dossier et essayez d'en créer un nouveau en prenant en compte le fait qu'il ne doit donc avoir ni accents, ni espaces, ni caractères spéciaux (ex : `C:\djangogirls`). Créez un nouvel environnement virtuel dans le nouveau répertoire, puis supprimez l'ancien et ré-essayez la commande précédente. (Déplacer ou couper/coller le répertoire de l'environnement virtuel ne marchera pas car virtualenv utilise des chemins absolus)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> Si vous obtenez une erreur lorsque vous utilisez pip sous Ubuntu 12.04, tapez la commande `python -m pip install -U --force-reinstall pip` pour réparer l'installation de pip dans votre virtualenv.
+
+<!--endsec-->
+
+Et voilà ! Vous êtes (enfin) prête pour créer votre première application Django !
\ No newline at end of file
diff --git a/fr-FR/django_models/README.md b/fr-FR/django_models/README.md
new file mode 100644
index 00000000000..55240f7db44
--- /dev/null
+++ b/fr-FR/django_models/README.md
@@ -0,0 +1,201 @@
+# Les modèles dans Django
+
+Maintenant, nous aimerions créer quelque chose qui permet stocker les articles de notre blog. Mais avant de pour pouvoir faire ça, nous allons tout d'abord devoir vous parler d'un truc qui s'appelle les `objets`.
+
+## Les objets
+
+Il existe un concept en programmation qu'on appelle la `programmation orientée objets`. L'idée, c'est de modéliser les choses et de définir comment elles interagissent entre elles plutôt que de tout voir comme une séquence d'instructions.
+
+Du coup, c'est quoi un objet ? C'est une collection de propriétés et d'actions. Ça a l'air bizarre dit comme ça. Un exemple devrait vous permettre d'y voir un peu plus clair.
+
+Si on veut modéliser un chat, nous allons créer un objet `Chat` qui a des propriétés comme `couleur`, `âge`, `humeur` (bonne humeur, mauvaise humeur, fatigué ;)) et `propriétaire` (ce qui pourrait être un objet `Personne`, ou, s'il s'agit d'un chat sauvage, cette propriété pourrait être simplement vide).
+
+Ensuite, nous pouvons donner des actions au `Chat` : `ronronner`, `gratter` ou `manger`. (Dans ce dernier cas, on donne au chat de la `NourriturePourChat`, ce qui peut être un objet séparé avec ses propres propriétés, comme le `goût`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+L'idée qu'il faut retenir, c'est que l'on décrit les choses du monde réel avec des propriétés (appelées `propriétés des objets`) et des actions (appelées `méthodes`).
+
+Du coup, comment modéliser les articles de blog ? C'est bien gentil les chats, mais ce qui nous intéresse, ça reste de faire un blog !
+
+Pour ça, il faut réponde à la question : qu'est-ce qu'un article de blog ? Quelles propriétés devrait-il avoir ?
+
+Pour commencer, notre blog post doit avoir du texte : il a bien du contenu et un titre, n'est-ce pas ? Et puis, ce serait bien de savoir aussi qui l'a écrit. On a donc besoin d'un auteur. Enfin, on aimerait aussi savoir quand l'article a été écrit et publié.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Quel genre d'actions pourrions-nous faire sur un article de blog ? Un bon début serait d'avoir une `méthode` qui permet de publier le post.
+
+On va donc avoir besoin d'une méthode `publish`.
+
+Voilà, nous avons une idée de ce que nous avons besoin. Allons modéliser tout ça dans Django!
+
+## Les modèles dans Django
+
+Maintenant que nous savons ce qu'est un objet, nous allons pouvoir créer un modèle Django pour notre post de blog.
+
+Un modèle Django est un type particulier d'objet : il est sauvegardé dans la `base de données`. Une base de données est une collection de données. C'est à cet endroit que l'on stocke toutes les informations au sujet des utilisateurs, des blog posts, etc. Pour stocker nos données, nous allons utiliser une base de données SQLite. C'est la base de données par défaut dans Django. Elle sera largement suffisante pour ce que nous voulons faire.
+
+Pour vous aider à visualiser ce qu'est une base de données, pensez à un tableur avec des colonnes (champs) et des lignes (données).
+
+### Créer une application
+
+Pour éviter le désordre, nous allons créer une application séparée à l'intérieur de notre projet. Prenez l'habitude de bien tout organiser dès le début. Afin de créer une application, nous avons besoin d'exécuter la commande suivante dans notre console (prenez garde à bien être dans le dossier `djangogirls` où se trouve le fichier `manage.py`) :
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Vous pouvez voir qu'un nouveau dossier `blog` a été créé et qu'il contient différents fichiers. Les dossiers et fichiers liés à votre projet doivent maintenant être organisés selon cette structure :
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+Après avoir créé une nouvelle application, vous devez dire à Django de l'utiliser. Nous faisons cela via le fichier `mysite/settings.py`. Ouvrez-le dans votre éditeur de code. Trouvez la section `INSTALLED_APPS` et ajoutez une ligne `'blog.apps.BlogConfig',` juste avant `]`. La section doit maintenant ressembler à ceci :
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Créer un modèle de blog post
+
+Le fichier `blog/models.py` permet de définir les objets que nous appelons des `modèles`. C'est à cet endroit que nous allons définir ce que c'est qu'un un blog post.
+
+Ouvrez le fichier `blog/models.py` dans l'éditeur de code, supprimez tout ce qui s'y trouve et copiez-y le morceau de code suivant :
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Vérifiez que vous avez bien utilisé deux tirets bas (`_`) autour de `str`. C'est une convention fréquemment utilisée en Python qui porte même un petit nom en anglais : "dunder", pour "double-underscore".
+
+Ce gros morceau de code a l'air effrayant mais, ne vous inquiétez pas : nous allons vous expliquer ce que signifie chacune de ces lignes!
+
+Toutes les lignes qui commencent par `from` ou `import` sont des lignes qui permettent d'importer des morceaux d'autres fichiers. Concrètement, au lieu de recopier ou de copier-coller la même chose dans différents fichiers, nous pouvons tout simplement faire référence à certains morceaux d'autres fichiers à l'aide de `from ... import ...`.
+
+`class Post(models.Model):` - C'est cette ligne qui permet de définir notre modèle (ce qui est un `object`).
+
+- Le mot clef spécial `class` permet d'indiquer que nous sommes en train de définir un objet.
+- `Post` est le nom de notre modèle. Vous pouvez lui donner un autre nom (mais vous ne pouvez pas utiliser des caractères spéciaux ou accentués et insérer des espaces). Le nom d'une classe commence toujours par une majuscule.
+- `models.Model` signifie que Post est un modèle Django. Comme ça, Django sait qu'il doit l'enregistrer dans la base de données.
+
+Maintenant, nous allons pouvoir définir les propriétés dont nous parlions au début de ce chapitre : `title (titre)`, `text (texte)`, `created_date (date de création)`, `published_date (date de publication)` et `author (auteur)`. Pour cela, nous allons avoir besoin de définir le type de chaque champ (Est-ce que c'est du texte? Un nombre ? Une date ? Une relation à un autre objet, comme un objet utilisateur par exemple ?)
+
+- `models.CharField` - Cela nous permet de définir un champ texte avec un nombre limité de caractères.
+- `models.TextField` - Cela nous permet de définir un champ text sans limite de caractères. Parfait pour le contenu d'un blog post, non ?
+- `models.DateTimeField` - Définit que le champ en question est un horodatage (date et heure).
+- `models.ForeignKey` - C'est un lien vers un autre modèle.
+
+Malheureusement, nous n'avons pas le temps de vous expliquer tous les bouts de code que nous allons manipuler dans ce tutoriel. Si vous voulez en savoir plus sur les modèles Django, n'hésitez pas à consulter la documentation officielle de Django (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+Et sinon, c'est quoi `def publish(self):` ? Il s'agit de notre méthode `publish` dont nous parlions tout à l'heure. `def` signifie que nous créons une fonction/méthode qui porte le nom `publish`. Vous pouvez changer le nom de la méthode si vous le souhaitez. La règle de nommage est d'utiliser des minuscules et des tirets bas à la place des espaces. Par exemple, une méthode qui calcule le prix moyen d'un produit pourrait s'appeler `calcul_prix_moyen`.
+
+Les méthodes renvoient (`return`) souvent quelque chose. C'est le cas de la méthode `__str__`. Dans notre tutoriel, lorsque nous appellerons la méthode `__str__()`, nous allons obtenir du texte (**string**) avec un titre de Post.
+
+Notez également que les deux lignes `def publish(self) :` et `def __str__(self) :` sont mises en retrait à l’intérieur de notre classe. Parce que Python est sensible aux espaces, nous devons mettre en retrait (ou "indenter") nos méthodes à l'intérieur de la classe. Sinon, les méthodes ne sont pas considérées comme appartenantes à la classe, et vous pouvez obtenir un comportement inattendu.
+
+Si quelque chose ne vous parait pas clair au sujet des modèles, n'hésitez pas à demander à votre coach ! Cela peut être compliqué à comprendre la première fois, surtout lorsque l'on apprend les objets et les fonctions en même temps. Gardez espoir ! Avec le temps, tout cela vous paraitra de moins en moins magique et de plus en plus évident !
+
+### Créer des tables pour votre modèle dans votre base de données
+
+La dernière étape pour cette section est d'ajouter notre nouveau modèle à notre base de données. Tout d'abord, nous devons signaler à Django que nous venons de créer notre modèle. (Nous venons de le terminer !). Allez sur votre terminal et tapez `python manage.py makemigrations blog`. Le résultat devrait ressembler à ça :
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Remarque :** N’oubliez pas de sauvegarder les fichiers que vous modifiez. Dans le cas contraire, votre ordinateur exécute la version précédente, ce qui pourrait vous donner des messages d’erreur inattendus.
+
+Django vient de nous préparer un fichier de migration que nous allons pouvoir appliquer dès maintenant à notre base de données. Pour cela, tapez `python manage.py migrate blog`. Normalement, vous devrez voir ceci s'afficher dans votre console :
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Youpi ! Notre modèle Post est maintenant intégré à la base de données. Ce serait cool de voir à quoi il ressemble réellement ! Pour ça, il va falloir attaquer la section suivante ! Au boulot ;)!
\ No newline at end of file
diff --git a/fr-FR/django_orm/README.md b/fr-FR/django_orm/README.md
new file mode 100644
index 00000000000..89bb1a8927a
--- /dev/null
+++ b/fr-FR/django_orm/README.md
@@ -0,0 +1,221 @@
+# L'ORM Django et les QuerySets
+
+Dans ce chapitre, nous allons apprendre comment Django se connecte à la base de données et comment il y enregistre des choses. On respire un grand coup et on y va !
+
+## Qu'est-ce qu'un QuerySet ?
+
+Un QuerySet est, par essence, une liste d'objets d'un modèle donné. C'est ce qui vous permet de lire, trier et organiser, des données présentes dans une base de données.
+
+Il est plus simple d'apprendre avec un exemple. Et si nous nous intéressions à celui-ci ?
+
+## Le shell Django
+
+Ouvrez la console de votre ordinateur (et non celle de PythonAnywhere) et tapez la commande suivante :
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Ceci devrait maintenant s'afficher dans votre console :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Vous êtes maintenant dans la console interactive de Django. C'est comme celle de Python, mais avec toute la magie qu'apporte Django :). Les commandes Python sont aussi utilisables dans cette console.
+
+### Lister tous les objets
+
+Essayons tout d'abord d'afficher tous nos posts. Vous pouvez le faire à l'aide de cette commande :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oups ! Voilà que ça nous renvoie une erreur qui nous dit qu'il n'existe pas de Post. En effet, nous avons oublié de commencer par un "import" !
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+Nous importons le modèle `Post` depuis notre `blog.models`. Essayons à nouveau la commande précédente :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Cela nous permet d'obtenir une liste des posts que nous avons créés tout à l'heure ! Rappelez-vous : nous avions créé ces posts à l'aide de l'interface d'administration de Django. Cependant, nous aimerions maintenant créer de nouveaux posts à l'aide de python : comment allons-nous nous y prendre ?
+
+### Créer des objets
+
+Voici comment créer un nouveau objet Post dans la base de données :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Cependant, il nous manque un petit quelque chose : `me`. Nous avons besoin de lui passer une instance du modèle `User` en guise d'auteur (author). Comment faire ?
+
+Tout d'abord, il nous faut importer le modèle User :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Avons-nous des utilisateurs dans notre base de données ? Voyons voir :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+Il s'agit du superutilisateur que nous avons créé tout à l'heure ! Sauvegardons une instance de cet utilisateur (modifie la ligne suivante avec ton nom d'utilisateur) :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Comme vous pouvez le constater, nous avons maintenant obtenu (`get`) un utilisateur (`User`) avec un nom d’utilisateur `username` qui est égale à « ola ». Très bien !
+
+Nous allons enfin pouvoir créer notre post :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Et voilà ! Vous aimeriez voir si ça a vraiment marché ?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Et voilà : un post de plus dans la liste !
+
+### Ajouter plus de posts
+
+Amusez-vous à ajouter d'autres posts pour vous entrainer un peu. Essayez d'ajouter deux ou trois posts en plus puis passez à la partie suivante.
+
+### Filtrer les objets
+
+L'intérêt des QuerySets, c'est que l'on peut les filtrer. Disons que nous aimerions retrouver tous les posts écrits par l'utilisateur Ola. Pour cela, nous allons utiliser `filter` à la place de `all` dans `Post.objects.all()`. Les parenthèses vont nous servir à préciser quelles sont les conditions auxquelles un post de blog doit se conformer pour être retenu par notre queryset. Dans notre exemple, la condition est que `author` soit égal à `me`. La manière de le dire en Django c'est : `author=me`. Maintenant, votre bout de code doit ressembler à ceci :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Et si nous voulions chercher les posts qui contiennent uniquement le mot "titre" ("title" en anglais) dans le champs `title`?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** Il y a deux tirets bas (`_`) entre `title` et `contains`. L'ORM de Django utilise cette règle afin de séparer les noms de champ ("title") et les opérations ou les filtres ("contains"). Si vous n'utilisez qu'un seul tiret bas, vous allez obtenir une erreur du type : "FieldError: Cannot resolve keyword title_contains".
+
+Vous pouvez aussi obtenir une liste de tous les posts publiés. Pour cela, nous allons filtrer les posts qui possèdent une date de publication (`published_date`) dans le passé :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Malheureusement, le post que nous avons créé dans la console Python n'est pas encore publié. Allons corriger ce problème ! Dans un premier temps, nous aimerions obtenir une instance du post que nous voulons publier :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+Ensuite, publions-le grâce à notre méthode `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Maintenant, essayez d'obtenir à nouveau la liste des posts publiés (appuyez trois fois sur la flèche du haut, puis `entrée`) :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Classer les objets
+
+Les QuerySets permettent aussi de trier la liste des objets. Essayons de les trier par le champs `created_date` :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+On peut aussi inverser l'ordre de tri en ajouter `-` au début :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Requêtes complexes grâce au chaînage des méthodes
+
+Comme vous l'avez vu, quand on applique certaines méthodes à `Post.objects` on obtient un QuerySet en résultat. Les mêmes méthodes peuvent également être appliquées sur un QuerySet, ce qui ensuite donnera lieu à un nouveau QuerySet. Ainsi, vous pouvez combiner leur effet en les **enchaînant** l'une après l'autre :
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+C'est un outil très puissant qui va vous permettre d'écrire des requêtes complexes.
+
+Génial ! Vous êtes maintenant prête à passer à l'étape suivante ! Pour fermer le shell, tapez ceci:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/fr-FR/django_start_project/README.md b/fr-FR/django_start_project/README.md
new file mode 100644
index 00000000000..bd676dddd0a
--- /dev/null
+++ b/fr-FR/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Votre premier projet Django !
+
+> Une partie de ce chapitre s’inspire du tutoriel des Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Des morceaux de ce chapitre sont inspirés du [tutoriel django-marcador](http://django-marcador.keimlink.de/), disponible sous licence Creative Commons Attribution-ShareAlike 4.0 International. Le tutoriel django-marcador a été créé par Markus Zapke-Gründemann et al.
+
+Nous allons créer un petit blog !
+
+La première étape consiste à démarrer un nouveau projet Django. En gros, cela veut dire que nous allons lancer quelques scripts fournis par Django qui vont créer un squelette de projet Django. Il s'agit de fichiers et de dossiers que nous utiliserons par la suite.
+
+Il y existe certains fichiers et dossiers dont les noms sont extrêmement importants pour Django. Il ne faut pas renommer les fichiers que nous sommes sur le point de créer. Ce n'est pas non plus une bonne idée de les déplacer. Django a besoin de maintenir une certaine structure pour retrouver les éléments importants.
+
+> N'oubliez pas de tout exécuter dans votre virtualenv. Si vous ne voyez pas le préfixe `(myvenv)` dans votre console, vous avez besoin d'activer votre virtualenv. Nous vous avons expliqué comment faire ça dans le chapitre **Installation de Django**, dans la partie **Travailler avec virtualenv**. Tapez `myvenv\Scripts\activate` dans votre console Windows ou `source myvenv/bin/activate` dans celle de Mac OS ou Linux afin d'activer votre virtualenv.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+Retournons à la création de notre premier projet. Tapez la commande suivant dans votre console MacOS ou Linux. **N'oubliez pas le point `.`à la fin !**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Le point `.` est très important : c'est lui qui permet de dire au script d'installer Django dans votre répertoire courant (le point `.` est une référence abrégée à celui-ci).
+> 
+> **Note** : lorsque vous tapez la commande précédente dans votre console, vous ne devez recopier que la partie qui commence par `django-admin`. La partie `(myvenv) ~/djangogirls$` montrée ici n'est qu'un exemple pour vous rappeler de taper la commande dans votre console.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Sur Windows, vous devez taper la commander suivante. ** (N'oubliez pas le point `.` à la fin) ** :
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Le point `.` est très important : c'est lui qui permet de dire au script d'installer Django dans votre répertoire courant (le point `.` est une référence abrégée à celui-ci).
+> 
+> **Note** : lorsque vous tapez la commande précédente dans votre console, vous ne devez recopier que la partie qui commence par `django-admin.exe`. La partie `(myvenv) C:\Users\Name\djangogirls>` montrée ici n'est qu'un exemple pour vous rappeler de taper la commande dans votre console.
+
+<!--endsec-->
+
+`django-admin.py` est un script qui crée les dossiers et fichiers nécessaires pour vous. Vous devriez maintenant avoir une structure de dossier qui ressemble à celle-ci:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note** : dans votre structure de dossier, vous pourrez voir également le répertoire `venv` que nous avons créé avant.
+
+`manage.py` est un script qui aide à gérer ou maintenir le site. Entre autres, il permet notamment de lancer un serveur web sur notre ordinateur sans rien installer d'autre.
+
+Le fichier `settings.py` contient la configuration de votre site web.
+
+Vous vous souvenez de l'histoire du postier qui livre des lettres ? `urls.py` contient une liste de patterns d'urls utilisés par `urlresolver`.
+
+Ignorons les autres fichiers pour l'instant, nous n'allons pas avoir besoin d'y toucher. La seule chose à retenir est qu'il ne faut pas les supprimer par accident !
+
+## Changer la configuration
+
+Apportons quelques changements à `mysite/settings.py`. Ouvrez le fichier avec l'éditeur de code que vous avez installé tout à l'heure.
+
+**Note** : Gardez à l’esprit que `settings.py` est un fichier ordinaire, comme les autres. Vous pouvez l’ouvrir depuis l’éditeur de code, en cliquant sur « file-> open » dans le menu. Cela devrait ouvrir la fenêtre habituelle de navigation, où vous allez pouvoir chercher votre fichier `settings.py` et le sélectionner. Autrement, vous pouvez naviguer jusqu’au dossier djangogirls sur votre bureau et faire un clic droit sur le nom du fichier. Sélectionnez ensuite votre éditeur de code dans la liste qui s'affiche. Sélectionner l’éditeur est important car vous pourriez avoir d’autres programmes installés qui peuvent ouvrir le fichier, mais qui ne vous permettraient pas de le modifier.
+
+Ça serait sympa d'avoir l'heure correcte sur notre site Web. Allez sur la [liste Wikipedia des fuseaux horaires](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) et copiez votre fuseau horaire (TZ) (par exemple `Europe/Berlin`).
+
+Dans `settings.py`, recherchez la ligne qui contient `TIME_ZONE` et modifiez-la pour choisir votre propre fuseau horaire. Par exemple :
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+Un code de langue se compose de la langue, par exemple `en` pour l’anglais ou `de` pour l’allemand et du code du pays, p. ex. `de` pour l’Allemagne ou `ch` pour la Suisse. Si l’anglais n’est pas votre langue maternelle, vous pouvez ajouter votre code de langue afin que les boutons par défaut et les notifications de Django soient traduits. Vous auriez alors le bouton « Cancel » traduits dans la langue que vous avez définie. [Django est livré avec un grand nombre de traductions disponibles](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+Si vous voulez changer la langue, modifiez le code de langue comme montré dans la ligne suivante :
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Nous allons avoir besoin aussi d'un chemin d’accès pour les fichiers statiques. (Nous allons découvrir les fichiers statiques et CSS plus tard dans le tutoriel) Allez à la *fin* du fichier et juste en dessous de `STATIC_URL`, ajoutez une nouvelle entrée `STATIC_ROOT` :
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Lorsque `DEBUG` a valeur `True` et `ALLOWED_HOSTS` est vide, les noms d'hôte acceptés sont `[« localhost », '127.0.0.1 », ' [ :: 1]']`. Notre nom d’hôte sur PythonAnywhere ne sera donc pas accepté une fois que notre application sera déployée. Pour éviter cela, nous allons changer le paramètre suivant :
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note** : Si vous utilisez un Chromebook, ajoutez cette ligne à la fin de votre fichier settings.py : `MESSAGE_STORAGE = « django.contrib.messages.storage.session.SessionStorage »`
+> 
+> Ajoutez `.amazonaws.com` à `ALLOWED_HOSTS` si vous utilisez cloud9
+> 
+> Si vous hébergez votre projet sur `Glitch.com`, nous devons protéger la clé secrète Django qui doit rester confidentielle (sinon, toute personne remixant votre projet pourrait la voir) :
+> 
+> - Tout d'abord, nous allons créer une clé secrète aléatoire. Ouvrez à nouveau le terminal Glitch et tapez la commande suivante :
+>     
+>     {% filename %}Terminal{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     Ceci devrait afficher une longue chaîne de caractères aléatoire, parfaite à utiliser comme clé secrète pour votre tout nouveau site web Django. Nous allons maintenant coller cette clé dans un `.env` que Glitch ne vous montrera que si vous êtes propriétaire du site Web.
+> 
+> - Créez un fichier `.env` à la racine de votre projet et ajoutez-y la propriété suivante :
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Ici, à l'intérieur des apostrophes, vous pouvez copier et coller la clé aléatoire générée ci-dessus
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Puis mettez à jour le fichier de configuration de Django pour injecter cette valeur secrète et définir le nom du site web Django :
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - Et un peu plus loin, dans le même fichier, nous injectons le nom de votre nouveau site Glitch :
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     `PROJECT_DOMAIN` est générée automatiquement par Glitch. Elle contient le nom de votre projet.
+
+## Configuration de la base de données
+
+Il existe tout un tas de systèmes de gestion de bases de données qu'il est possible d'utiliser pour stocker les données de votre site. Nous allons utiliser celui par défaut : `sqlite3`.
+
+Il est déjà configuré dans cette partie de votre fichier `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Pour créer la base de donnée de notre blog, il faut lancer la commande suivante dans la console : `python manage.py migrate` (vous avez besoin d'être dans le dossier `djangogirls` qui contient le fichier `manage.py`). Si tout se passe bien, vous devriez voir quelque chose comme ça:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+Et voilà ! Il ne reste plus qu'à lancer le serveur et voir si notre site web fonctionne !
+
+## Lancer le serveur web
+
+Pour cela, vous avez besoin d'être dans le dossier qui contient le fichier `manage.py` (le dossier `djangogirls`). Dans votre console, vous pouvez lancer le serveur en tapant `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Si vous avez un Chromebook, utilisez plutôt la commande suivante :
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+ou celle-ci si vous utilisez Glitch :
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+Si vous utilisez Windows et que vous obtenez l'erreur `UnicodeDecodeError`, tapez plutôt cette commande :
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Ensuite, vous allez vérifier que votre site fonctionne. Pour cela, ouvrez votre navigateur (Firefox, Chrome, Safari, Internet Explorer, ou n'importe quel autre), et entrez l'adresse suivante :
+
+{% filename %}navigateur{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+Si vous utilisez un Chromebook et Cloud9, cliquez plutôt sur l’URL dans la fenêtre pop-up qui devrait figurer dans le coin supérieur droit de la fenêtre de commande où le serveur web est en cours d’exécution. L'URL ressemblera à quelque chose comme :
+
+{% filename %}navigateur{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+ou sur Glitch :
+
+    https://nom-de-votre-projet-glitch.glitch.me
+    
+
+Bravo ! Vous venez de créer votre premier site web, et de le lancer avec un serveur web ! C'est génial, non?
+
+![L'installation a fonctionné !](images/install_worked.png)
+
+Notez qu’une fenêtre de commande ne peut exécuter qu’une chose à la fois, et la fenêtre de commande que vous avez ouverte précédemment est en train d'exécuter le serveur web. Tant que le serveur web est en cours d’exécution et en attente de requêtes entrantes, le terminal acceptera du nouveau texte mais ne l'exécutera pas.
+
+> Nous avons vu le fonctionnement des serveurs web dans le chapitre **Comment fonctionne Internet**.
+
+Pour taper et executer des nouvelles commandes pendant que le serveur web est en fonction, ouvrez une nouvelle fenêtre dans votre terminal et activez votre virtualenv. Pour révoir comment ouvrir une nouvelle fenêtre, rendez-vous au chapitre [Introduction à la ligne de commande](../intro_to_command_line/README.md). Pour arrêter votre serveur web, retournez dans la fenêtre où il tourne et appuyez sur CTRL+C : gardez les boutons Control et C appuyés en même temps. (Sous Windows, vous devrez peut-être appuyer sur CTRL+Arrêt défil.)
+
+Prêtes pour la suite ? Il est temps de créer du contenu !
\ No newline at end of file
diff --git a/fr-FR/django_templates/README.md b/fr-FR/django_templates/README.md
new file mode 100644
index 00000000000..8bb92d9e643
--- /dev/null
+++ b/fr-FR/django_templates/README.md
@@ -0,0 +1,108 @@
+# Templates Django
+
+Il est temps d'afficher des données ! Pour nous aider, Django fournit des balises de gabarit (**template tags**) qui sont intégrées au framework. Pour le reste du tutoriel, nous utiliserons plutôt le mot template, bien plus répandu que sa traduction "gabarit".
+
+## Qu'est-ce que c'est que des balises de template ?
+
+En HTML, vous ne pouvez pas mettre directement du code Python car les navigateurs seraient incapables de le comprendre. Les navigateurs ne connaissent que le HTML. Nous vous avons signalé précédemment que HTML est du genre statique, alors que Python est bien plus dynamique.
+
+Les **Balises de template Django** nous permettent de transferer des choses ressemblant à du Python dans du HTML afin de nous permettre de construire des sites web plus rapidement. Cool, non ?
+
+## Template d'affichage de la liste des posts
+
+Dans le chapitre précédent, nous avons donné à notre template une liste de posts à l'aide de la variable `posts`. Nous allons maintenant les afficher en HTML.
+
+Afin d'afficher une variable dans un template Django, nous utiliserons des doubles accolades avec le nom de la variable à l'intérieur. Ça ressemble à ceci :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Essayez de faire la même chose avec votre template `blog/templates/blog/post_list.html`. Ouvrez-le avec votre éditeur et remplacez tout ce qui se trouve entre la seconde balise `<div>` jusqu'au troisième `</div>` avec la ligne `{{ posts }}`. Sauvegardez votre fichier et rafraichissez votre page pour voir le résultat :
+
+![Figure 13.1](images/step1.png)
+
+Comme vous pouvez le voir, tout ce que nous avons, c'est ceci :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Cela signifie que Django l'interprète comme une liste d'objets. Essayez de vous rappeler comment afficher des listes en Python. Si vous avez un trou de mémoire, allez voir dans le chapitre **Introduction à Python**. Vous avez trouvé ? Avec des boucles ! Dans un template Django, vous pouvez les écrire de la façon suivante :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Essayez ceci dans votre template.
+
+![Figure 13.2](images/step2.png)
+
+Ça marche ! Cependant, nous aimerions plutôt afficher les posts à la manière des posts statiques, comme lorsque nous les avions créés dans le chapitre **Introduction au HTML**. Vous pouvez mixer HTML et balises de template. Notre `body` ressemble maintenant à ceci :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Tout ce qui se situe entre `{% for %}` et `{% endfor %}` va être répété pour chaque objet présent dans la liste. Rafraichissez votre page :{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Avez-vous remarqué que nous avons utilisé une notation légèrement différente cette fois-ci (`{{ post.title }}` ou `{{ post.text }}`) ? Nous accédons aux données associées à chaque champ défini dans notre modèle `Post`. De même, le `|linebreaksbr` nous permet de rediriger le texte des posts à travers un filtre qui convertit automatiquement les fins de lignes en paragraphes.
+
+## Une dernière chose
+
+Maintenant, ça serait bien de voir si votre site Web fonctionne toujours sur Internet. Nous allons essayer de le re-déployer sur PythonAnywhere. Voici un récapitulatif des étapes…
+
+* En premier lieu, envoyez votre code sur GitHub (push)
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modification des templates to afficher les posts contenus dans la base de données."
+    [...]
+    $ git push
+    
+
+* Ensuite, reconnectez-vous à [PythonAnywhere](https://www.pythonanywhere.com/consoles/) et allez sur la "**Bash console**" (ou démarrer-en une nouvelle), et lancez les commandes suivantes :
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(N’oubliez pas de remplacer `<your-pythonanywhere-domain>` avec votre propre nom de sous domaine sur PythonAnywhere, sans les chevrons.)
+
+* Pour finir, n'oubliez pas de recharger votre application web : onglet [Web](https://www.pythonanywhere.com/web_app_setup/) puis cliquez sur le bouton **Reload**. (Pour rejoindre les autres pages de PythonAnywhere à partir de la console, utilisez le bouton de menu dans le coin supérieur droit). Votre mise à jour devrait apparaître sur https://subdomain.pythonanywhere.com--Allez regarder dans le navigateur ! Si les posts sur PythonAnywhere ne correspondent pas à ceux qui apparaissent dans votre version locale du blog, ne vous inquiétez pas. Les deux bases de données, la locale et celle sur PythonAnywhere, ne sont pas synchronisées comme le reste des fichiers.
+
+Félicitations ! Maintenant, allez de l'avant et essayez d'ajouter un nouveau message dans votre administrateur Django (rappelez-vous d'ajouter publication_date!) Assurez-vous que vous êtes dans l'administrateur Django pour votre site pythonanywhere, https://subdomain.pythonanywhere.com/admin. Ensuite, rafraîchissez votre page pour voir si le message apparaît.
+
+Ça a marché ? Nous sommes super fière de vous ! Éloignez vous un peu de votre clavier maintenant : vous avez mérité de faire une pause. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/fr-FR/django_urls/README.md b/fr-FR/django_urls/README.md
new file mode 100644
index 00000000000..2acb1af708e
--- /dev/null
+++ b/fr-FR/django_urls/README.md
@@ -0,0 +1,103 @@
+# Les URL de Django
+
+Nous sommes sur le point de créer notre première page web : une page d'accueil pour votre blog ! Mais d'abord, commençons par en apprendre un peu plus sur les URL de Django.
+
+## Qu'est-ce qu'une URL ?
+
+Une URL est une adresse web. Vous pouvez voir une URL chaque fois que vous visitez un site web. Elle est visible dans la barre d'adresse de votre navigateur. (Oui ! `127.0.0.1:8000` est aussi une URL ! Et `https://djangogirls.org` est aussi une URL.)
+
+![URL](images/url.png)
+
+Chaque page internet a besoin de sa propre URL. C'est grâce à cela que votre application sait ce qu'elle doit afficher à un utilisateur qui ouvre cette URL. Dans Django, nous utilisons un outil appelé `URLconf` (Configuration d'URL). URLconf est un ensemble de modèles que Django va essayé de faire correspondre à l'URL demandée afin de trouver la vue adaptée.
+
+## Comment les URLs fonctionnent-elles dans Django ?
+
+Ouvrons le fichier `mysite/urls.py` dans notre éditeur de code et regardons à quoi il ressemble :
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Comme vous pouvez le voir ici, Django a déjà préparé quelque chose pour nous.
+
+Les lignes entre triples guillemets (`'''` or `"""`) sont appelées docstrings. Vous pouvez les écrire en haut d'un fichier, d'une classe ou d'une méthode pour décrire son fonctionnement. Elle ne seront pas exécutées par Python.
+
+L'URL admin, que vous avez abordé dans le chapitre précédent est déjà là :
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Cette ligne signifie que pour toutes les URL commençant par `admin/`, Django trouvera une *vue* correspondante. Dans cet exemple, nous incluons de nombreuses URL admin. Elles ne sont donc pas toutes contenues dans ce petit fichier. C'est plus lisible et plus propre.
+
+## Votre première URL Django !
+
+Il est temps de créer notre première URL ! Nous voulons que 'http://127.0.0.1:8000/' soit la page d'accueil de notre blog et qu'elle affiche la liste des articles.
+
+Nous aimerions aussi garder notre fichier `mysite/urls.py` propre. Pour cela, nous allons importer les URLs de notre application `blog` dans notre fichier principal `mysite/urls.py`.
+
+Allez-y ! Ajoutez une ligne qui importera `blog.urls`. Vous devrez également modifier la ligne ` from django.urls...` car nous utiliseront la fonction `include`. Il vous faudra ajouter cet import à la ligne.
+
+Votre fichier `mysite/urls.py` devrait maintenant ressembler à ceci :
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django va maintenant rediriger tout ce qui arrive sur "http://127.0.0.1:8000/" vers `blog.urls` puis regardera dans ce fichier pour y trouver la suite des instructions à suivre.
+
+## blog.urls
+
+Créez un nouveau fichier vide nommé `urls.py` dans le répertoire `blog`, et ouvrez-le dans l'éditeur de code. Très bien ! Ajoutez ces deux premières lignes :
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Nous venons d'importer la fonction `path` de Django ainsi que toutes les `vues` liées à notre application `blog`. (Cependant, nous n'avons pas encore créé de vues ! Pas de problème : nous y viendrons dans une minute !)
+
+Après ça, nous pouvons ajouter notre premier modèle (pattern) d'URL:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+Comme vous pouvez le voir, nous assignons une `vue` appelée `post_list` à l'URL racine. Ce modèle d’URL correspond à une chaîne vide et le résolveur d'URL de Django ignore le nom de domaine (par exemple, http://127.0.0.1:8000/), soit la première partie de l'URL. Ce pattern va donc indiquer à Django d'afficher la vue `views.post_list` à un utilisateur de votre site web qui se rendrait à l'adresse "http://127.0.0.1:8000/".
+
+La dernière partie, `name='post_list'`, est le nom de l'URL qui sera utilisée afin d'identifier la vue. Ce nom peut être le même que celui de la vue ou quelque chose de complètement différent. Plus tard dans ce tutoriel, nous allons utiliser les noms que nous avons donné à nos URLs. Il est donc important de donner un nom unique à chaque URL que nous créons. Pour vous faciliter la tâche, essayez de trouver des nom d'URLs simple à retenir.
+
+Si vous essayez d'aller sur http://127.0.0.1:8000/ maintenant, vous trouverez un message du style « page web non disponible ». C’est parce que le serveur (vous vous souvenez d'avoir tapé `runserver` ?) n'est plus en exécution. Jetez un oeil à la console pour savoir pourquoi.
+
+![Erreur](images/error1.png)
+
+Votre console affiche une erreur, mais ne vous inquiétez pas – c’est en fait très utile : elle vous dit qu’il n’existe aucun attribut « post_list » (**no attribute 'post_list'**). C’est le nom de la *vue* que Django essaie de trouver et d’utiliser, or nous ne l'avons pas encore créée. À ce stade, votre `/admin/` ne fonctionnera pas non plus. Pas de problème, on y vient. Si vous voyez un message d’erreur différent, essayez de redémarrer votre serveur web. Pour faire cela, dans la console qui exécute le serveur web, arrêtez-le en appuyant sur CTRL+C (les touches Control et C simultanément). Sous Windows, vous devrez peut-être appuyer sur Ctrl+Break. Vous devrez alors redémarrer le serveur web en exécutant la commande `python manage.py runserver`.
+
+> Si vous voulez en savoir plus au sujet de la configuration des URLs dans Django, vous pouvez aller consulter la documentation officielle du framework : https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/fr-FR/django_views/README.md b/fr-FR/django_views/README.md
new file mode 100644
index 00000000000..530a34f1b35
--- /dev/null
+++ b/fr-FR/django_views/README.md
@@ -0,0 +1,44 @@
+# Vues Django - C'est l'heure de créer !
+
+Il est enfin temps de se débarrasser du bug que nous avons créé dans le chapitre précédent! :)
+
+C'est dans la *vue* que nous allons ranger toute la partie "logique" de notre application. C'est elle qui va se charger d'aller chercher les informations liées à notre `modèle `que nous venons de créer et de les passer à un `template`. Nous allons créer ce template dans le chapitre suivant. Concrètement, les vues ne sont que des fonctions Python un peu plus élaborées que celles que nous avons créées dans la partie **Introduction à Python**.
+
+Les vues sont placées dans le fichier `views.py`. Nous allons créer nos *vues* dans le fichier `blog/views.py`.
+
+## blog/views.py
+
+Ok, allons-y ! Ouvrons ce fichier dans notre éditeur de code pour voir ce qu'il contient :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Pas beaucoup de choses pour l'instant.
+
+N’oubliez pas que les lignes commençant par `#` sont des commentaires, ce qui signifie qu'elles ne sont pas exécutées par Python.
+
+Nous allons créer une *vue* comme l’indique le commentaire. Ajoutez la vue minimale suivante :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Comme vous pouvez le voir, nous avons créé une fonction (`def`) appelée `post_list` qui prend une `request (requête)` et qui va `return (retourner)` la valeur donnée par une autre fonction `render` qui va assembler notre template `blog/post_list.html`.
+
+Sauvegardez votre fichier et allez à l'adresse http://127.0.0.1:8000/ pour voir ce qui s'affiche maintenant.
+
+Une autre erreur ! Voyons ce qu'elle nous dit :
+
+![Erreur](images/error.png)
+
+Cela indique que le serveur tourne, ce qui est bien, mais il y a quelque chose qui ne va pas, non ? Ne vous inquiétez pas, c’est juste une page d’erreur, il ne faut pas avoir peur d'elle ! Au contraire, tout comme les messages d’erreur dans la console, elle nous est très utile. Vous pouvez lire que *TemplateDoesNotExist*. Nous allons corriger ce bug et créer un modèle (template) dans le prochain chapitre !
+
+> Pour en apprendre un peu plus sur les vues dans Django, consultez la documentation officielle : https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/fr-FR/dynamic_data_in_templates/README.md b/fr-FR/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..4c25163a082
--- /dev/null
+++ b/fr-FR/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Données dynamiques dans les templates
+
+Nous avons différents morceaux en place : le modèle `Post` qui est définit dans le fichier `models.py`, la vue `post_list` dans `views.py` et nous venons de créer notre template. Mais comment allons-nous faire pour faire apparaître nos posts dans notre template HTML ? Car au final, n'est-ce pas le but que nous souhaiterions atteindre ? Nous aimerions prendre du contenu, en l’occurrence notre modèle sauvegardé dans notre base de données, et réussir à joliment l'afficher dans notre template.
+
+C'est à ça que servent les *vues* : connecter les modèles et les templates. Dans notre *vue* `post_list`, nous allons avoir besoin de prendre les modèles dont nous avons besoin et de les passer au template. C'est dans la *vue* que nous allons décider ce qui va s'afficher (quel modèle) dans un template.
+
+Ok, et sinon, on fait comment ?
+
+Nous allons avoir besoin d'ouvrir le fichier `blog/views.py` dans l'éditeur de code. Pour l'instant, la *vue* `post_list` ressemble à ceci :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Est-ce que vous vous souvenez de comment rajouter des morceaux de code écris dans d'autres fichiers ? Nous en avons parlé dans un chapitre précédent. Nous allons devoir importer notre modèle qui est défini dans le fichier `models.py`. Pour cela, nous allons ajouter la ligne `from .models import Post` de la façon suivante :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+Le point avant `models` signifie *dossier courant* ou *application courante*. Les fichiers `views.py` et `models.py` sont dans le même répertoire. Cela signifie que nous pouvons utiliser `.` suivi par le nom du fichier (sans `.py`). Ensuite, nous importons le modèle (`Post`).
+
+Ok, et après ? Afin de pouvoir aller chercher les véritables posts de blog de notre modèle `Post`, nous avons besoin de quelque chose qui s'appelle un `QuerySet`.
+
+## QuerySet
+
+Normalement, ce mot doit vous évoquer quelque chose. Nous en avons un peu parlé dans la section [Django ORM (QuerySets)](../django_orm/README.md).
+
+Maintenant, nous allons nous intéresser à comment publier les post classés par date de publication (`published_date`). Ça tombe bien, on a déjà fait ça dans la section sur les QuerySets !
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Ouvrons donc le fichier `blog/views.py` dans l’éditeur de code et ajoutons le morceau de code suivant à la fonction `def post_list(request)`. N’oubliez pas d’ajouter d’abord `from django.utils import timezone`.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+Pour afficher notre QuerySet sur la liste des publications de notre blog, il nous reste deux choses à faire:
+
+1. Passer les `posts` QuerySet dans le contexte du modèle, en changeant l'appel à la fonction `render` . Nous allons le faire maintenant.
+2. Modifier le modèle pour afficher le QuerySet `posts` . Nous en parlerons dans un chapitre ultérieur.
+
+Veuillez noter que nous créons une *variable* pour notre QuerySet : `posts`. Considérez que c'est le nom de notre QuerySet. À partir de maintenant, nous allons pouvoir faire référence à notre QuerySet en utilisant ce nom.
+
+Dans la fonction `render`, nous avons un paramètre `request`, qui désigne tout ce que nous recevons d'un utilisateur par l'intermédiaire d'Internet, et un autre qui signale le fichier template (`'blog/post_list.html'`). Le dernier paramètre, `{}`, va nous permettre de glisser des informations que notre template va utiliser. Nous devons donner des noms à ces informations (nous allons rester sur `'posts'` pour le moment). :) Ça va ressembler à ça : `{'posts': posts}`. La partie située avant `:` est une chaine de caractères ; vous devez donc l'entourer de guillemets : `''`.
+
+Au final, notre fichier `blog/views.py` doit ressembler à ceci maintenant :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+Et voilà, c'est bon ! Nous allons retourner du côté de notre template pour que notre QuerySet puisse s'afficher correctement !
+
+Si vous voulez en savoir plus sur les QuerySets, n'hésitez pas à consulter la documentation officielle du framework : https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/fr-FR/extend_your_application/README.md b/fr-FR/extend_your_application/README.md
new file mode 100644
index 00000000000..56e9c2d1b6a
--- /dev/null
+++ b/fr-FR/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Finaliser votre application
+
+Nous avons déjà franchi toutes les étapes nécessaires à la création de notre site web : nous savons maintenant comment écrire un modèle, une URL, une vue et un template. Nous avons même réussi à rendre notre site web plus joli .
+
+C'est le moment de pratiquer tout ce que vous avez appris !
+
+Tout d'abord, il faudrait que notre blog possède une page qui permet d'afficher un post, n'est-ce pas ?
+
+Nous avons déjà un modèle `Post`, nous n'avons donc pas besoin d'ajouter quoi que ce soit à `models.py`.
+
+## Créer un lien dans un template
+
+Nous allons tout d'abord ajouter un lien à l'intérieur du fichier `blog/templates/blog/post_list.html`. Ouvrez-le dans l’éditeur de code et voyez qu'il devrait ressembler à ceci : {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}Nous aimerions pouvoir cliquer sur le titre du post et arriver sur une page avec le contenu de celui-ci. Pour cela, changeons `<h2><a href="">{{ post.title }}</a></h2>` pour qu'il pointe vers la page de contenu du post :{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}C'est le moment parfait pour expliquer ce mystérieux `{% url 'post_detail' pk=post.pk %}`. Vous vous souvenez peut-être que la notation `{% %}` nous permet d'utiliser les balises de template Django. Cette fois-ci, nous allons utiliser des balises qui vont s'occuper de créer des URLs à notre place !{% endraw %}
+
+La partie `post_detail` signifie que Django s'attend de trouver une URL en `blog/urls.py` avec nom = post_detail
+
+Et qu’en est-il de `pk=post.pk` ? `pk` est l’abréviation de clé primaire (« primary key » en anglais), qui est un identifiant unique pour chaque entrée dans une base de données. Chaque modèle Django a un champ qui sert de clé primaire, et peu importe son autre nom, il peut aussi être appelé par le nom « pk ». Comme nous n’avons pas spécifié de clé primaire dans notre modèle `Post`, Django en crée une pour nous (par défaut, un champ nommé « id » contenant un nombre qui augmente pour chaque entrée, c’est-à-dire 1, 2, 3, etc.) et l’ajoute comme champ à chacun de nos posts. Nous accédons à la clé primaire en écrivant `post.pk`, pareil que pour accéder aux autres champs (`title`, `author`, etc.) de notre objet `Post` !
+
+Maintenant si nous jetons un coup d’œil à http://127.0.0.1:8000/, nous rencontrons une erreur. Ceci est prévisible, puisque nous n'avons ni d'URL ni de *view* pour `post_detail`. L'erreur ressemble à ceci :
+
+![Erreur NoReverseMatch](images/no_reverse_match2.png)
+
+## Créer une URL vers le contenu d'un post
+
+Allons créer notre URL dans le fichier `urls.py` pour notre *vue* `post_detail` !
+
+Nous aimerions que le contenu de notre premier post s'affiche à cette **URL** : http://127.0.0.1:8000/post/1/
+
+Allons créer une URL dans le fichier `blog/urls.py` qui dirigera Django vers une *vue* appelée `post_detail`. Cela nous permettra d'afficher l'intégralité d'un post de blog. Ouvrez le fichier `blog/urls.py` dans l’éditeur de code et ajoutez la ligne `path('post/<int:pk>/', views.post_detail, name='post_detail'),` afin que le fichier ressemble à ceci :
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+La partie `post/<int:pk>/` spécifie un modèle d’URL – allons voir plus dans le détail :
+
+- `post/` signifie que l’URL doit commencer par le mot **post** suivie d’un **/**. OK, pas très compliqué.
+- `<int:pk>`– cette partie est plus délicate. Cela signifie que Django s’attend à une valeur entière (int), qu'en suite il transférera à une vue comme variable de nom `pk`.
+- `/` – il nous faut un **/** à nouveau avant la fin de l’URL.
+
+Concrètement, cela signifie que si vous entrez `http://127.0.0.1:8000/post/5/` dans votre barre d'adresse, Django va comprendre que vous cherchez à atteindre une *vue* appelée `post_detail` et qu'il doit communiquer à cette *vue* que `pk` est égal à `5`.
+
+OK, nous avons ajouté un nouveau modèle d’URL à `blog/urls.py` ! Actualisons la page : http://127.0.0.1:8000/ Boom ! Le serveur a cessé de marcher à nouveau. Jetez un oeil sur la console – comme prévu, il y a encore une autre erreur !
+
+![AttributeError](images/attribute_error2.png)
+
+Vous souvenez-vous de ce qu'il faut faire ensuite ? Il faut ajouter une vue !
+
+## Ajouter une vue pour le contenu du post
+
+Cette fois-ci, nous allons donner un paramètre supplémentaire à notre *vue* : `pk`. Notre *vue* va avoir besoin de le récupérer, n'est ce pas ? Pour cela, nous allons définir une fonction : `def post_detail(request, pk):`. Notez que ce paramètre doit avoir exactement le même nom que celui que nous avons spécifié dans le fichier `urls` (`pk`). Notez aussi qu’oublier de mettre cette variable est incorrect et produira une erreur !
+
+Maintenant, nous aimerions obtenir qu'un seul blog post. Pour cela, nous allons utiliser des QuerySets qui ressemblent à ceux-ci:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Cependant, il y a un petit problème dans cette ligne de code. Si aucun de nos `Posts` ne possèdent cette `primary key (clef primaire)` (`pk`), nous allons nous retrouver avec une super erreur bien cracra!
+
+![Erreur DoesNotExist](images/does_not_exist2.png)
+
+Dans l'idéal, nous aimerions pouvoir éviter ça! Encore une fois, Django nous offre l'outil parfait pour ça : `get_object_or_404`. Dans le cas où il n'existerait pas de `Post` avec le `pk` indiqué, une page d'erreur beaucoup plus sympathique s'affichera : c'est ce qu'on appelle une `erreur 404 : page non trouvée`.
+
+![Page non trouvée](images/404_2.png)
+
+La bonne nouvelle, c'est que vous pouvez créer vous-mêmes votre page `Page non trouvée` et en faire ce que vous voulez ! Reconnaissez que ce n'est pas le plus important pour le moment donc nous allons zapper cette partie ;).
+
+Ok, ajoutons notre *vue* à notre fichier `views.py`!
+
+Dans le fichier `blog/urls.py` nous avons crée un modèle d'URL `post_detail` qui fait référence à la vue `views.post_detail`. En conséquence, Django s'attend à qu'une fonction `post_detail` soit définie dans le fichier `blog/views.py`.
+
+Ouvrez maintenant le fichier `blog/views.py` dans l'éditeur de code et ajoutez la ligne suivante après les autres lignes du type `from` qui existent déjà :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+A la fin du fichier nous ajoutons finalement notre *view* :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Hop, réactualisons la page http://127.0.0.1:8000/
+
+![Vue post_list](images/post_list2.png)
+
+C'est bon, ça a marché ! Mais que ce passe-t-il lorsque nous cliquons sur un lien dans un titre de blog post ?
+
+![Erreur TemplateDoesNotExist](images/template_does_not_exist2.png)
+
+Oh non ! Encore une erreur ! Mais cette fois, vous savez quoi faire : nous avons besoin d'un template !
+
+## Créer un template pour le contenu du post
+
+Nous allons créer un fichier `post_detail.html` dans le dossier `blog/templates/blog` et nous l'ouvrons ensuite avec notre éditeur de code.
+
+Entrez le code suivant :
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Une nouvelle fois, nous faisons hériter de `base.html`. Dans le `content` block, nous voulons afficher la date de publication d'un post (si elle existe), son titre et son texte. Mais vous souhaitez peut-être quelques éclaircissements avant, non?
+
+{% raw %}`{% if ... %} ... {% endif %}` est une balise de template que nous pouvons utiliser si nous voulons vérifier quelque chose. (Vous souvenez-vous de `if ... else ..` que nous avons appris dans le chapitre **Introduction à Python** ?) Dans ce cas spécifique, nous voulons vérifier que `published_date` existe.{% endraw %}
+
+Ok, vous pouvez maintenant actualiser votre page et voir si `TemplateDoesNotExist` a enfin disparu.
+
+![Page détaillée d'un post](images/post_detail2.png)
+
+Yay ! Ça marche!
+
+# C'est le moment de deployer !
+
+Ce serait bien de mettre à jour la version de notre site sur PythonAnywhere. On s'accroche et on déploie encore une fois :)
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Ajout de la vue et du template de détail blog post ainsi que du CSS pour le site."
+    $ git push
+    
+
+Puis, dans la console bash de [PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(N’oubliez pas de remplacer `<your-pythonanywhere-domain>` avec votre propre sous-domaine PythonAnywhere, sans les chevrons.)
+
+## Mise à jour des fichiers statiques sur le serveur
+
+Des serveurs comme PythonAnywhere réservent un traitement particuliers aux "fichiers statiques" (par exemple les fichiers CSS), notamment afin de les charger plus rapidement. En conséquence, à chaque fois que nos fichiers CSS changent, nous devons executer une commande pour que le serveur les mette à jour. Cette commande s'appelle `collectstatic`.
+
+Démarrez en activant votre virtualenv, s'il n'est pas toujours actif (PythonAnywhere propose la commande `workon`, ce qui est l'équivalent de `source myenv/bin/activate` sur votre ordinateur) :
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+La commande `manage.py collectstatic` nous rappelle un peu `manage.py migrate`. Nous apportons des changements à notre code, puis nous disons à Django *d'appliquer* ces changements, que ce soit pour la gestion des fichiers statiques ou pour la structure de la base de données.
+
+Maintenant nous sommes prêtes à aller sur [« Web »](https://www.pythonanywhere.com/web_app_setup/) (depuis le menu en haut à droite de la console), appuyer sur **Reload** et voir les résultats à votre adresse https://sous-domaine.pythonanywhere.com.
+
+Normalement, ça devrait suffire ! Encore bravo! :)
\ No newline at end of file
diff --git a/fr-FR/how_the_internet_works/README.md b/fr-FR/how_the_internet_works/README.md
new file mode 100644
index 00000000000..214707e0954
--- /dev/null
+++ b/fr-FR/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Comment fonctionne Internet
+
+> Pour les lectrices autodidactes : ce chapitre est traité dans la vidéo [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> Ce chapitre s’inspire de la conférence « Comment fonctionne Internet » de Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+Vous utilisez sûrement Internet tous les jours. Mais savez-vous ce qui ce passe vraiment quand vous tapez une adresse comme https://djangogirls.org dans votre navigateur et appuyez sur `Entrée`?
+
+La première chose que vous devez comprendre c’est qu’un site Web consiste en un tas de fichiers sauvegardés sur un disque dur -- tout comme vos films, musiques ou photos. Cependant, les sites web ont quelque chose d'unique : ils contiennent du code informatique appelé HTML.
+
+Si vous n'avez pas l'habitude de la programmation, il peut être difficile de comprendre HTML au début, mais vos navigateurs web (comme Chrome, Safari, Firefox, etc.) adorent ça. Les navigateurs web sont conçus pour comprendre ce code, pour suivre les instructions qu'il contient et présenter les fichiers de votre site web exactement comme vous voulez qu'ils soient présentés.
+
+Comme pour n'importe quel autre fichier, il faut stocker les fichiers HTML sur un disque dur quelque part. Pour Internet, on utilise des ordinateurs spéciaux, très puissants, appelés *serveurs*. Ils n'ont pas d'écran, de clavier ou de souris, car leur rôle est de stocker des données, et de les servir. C'est pour ça qu'on les appelle des *serveurs* : parce qu'ils sont là pour vous *servir* des données.
+
+Bon, d'accord. Mais vous avez envie de savoir à quoi Internet ressemble, n'est-ce-pas ?
+
+Nous vous avons fait un dessin ! Voilà à quoi ça ressemble :
+
+![Figure 1.1](images/internet_1.png)
+
+C'est le bazar, non ? En fait, c'est un réseau de machines connectées entre elles (les *serveurs* dont on parlait plus tôt). Des centaines de milliers de machines ! Des millions de kilomètres de câbles, partout dans le monde ! Vous pouvez aller voir une carte des câbles sous-marins (http://submarinecablemap.com/) pour voir à quel point le réseau est compliqué. Voici une capture d'écran du site :
+
+![Figure 1.2](images/internet_3.png)
+
+Fascinant, non ? Cependant, il n'est pas possible de tirer un câble entre chaque machine connectée à Internet. Du coup, pour atteindre une machine (par exemple, celle où https://djangogirls.org est sauvegardé), on doit faire passer une requête par plein d'autres machines.
+
+Ça ressemble ça :
+
+![Figure 1.3](images/internet_2.png)
+
+C'est un peu comme si, quand vous tapiez https://djangogirls.org, vous envoyiez une lettre qui dit "Chères Django Girls, je voudrais voir le site djangogirls.org. Pouvez-vous me l'envoyer ?"
+
+Votre lettre part vers le bureau de poste le plus proche. Ensuite, il file vers un autre, qui est plus proche de votre destinataire. Puis un autre, et encore un autre, jusqu'à sa destination. Une chose à retenir : si vous envoyez beaucoup de lettres (*data packets*) au même endroit, il se pourrait qu'elles transitent par des postes différentes (*routers*). Cela dépend de la manière dont elles sont distribuées à chaque bureau de poste.
+
+![Figure 1.4](images/internet_4.png)
+
+Cela fonctionne comme ça - vous envoyez des messages et attendez une réponse. Vous utilisez des octets de données à la place du papier et du crayon, mais l'idée est la même !
+
+À la place des adresses postales (nom de rue, ville, code postal), nous utilisons des adresses IP. Votre ordinateur commence par demander au DNS (Domaine Name System) de traduire djangogirls.org en une adresse IP. Ça marche un peu comme un de ces vieux annuaires où l'on peut chercher le nom d'une personne et trouver son numéro de téléphone et son adresse.
+
+Quand vous envoyez une lettre, elle a besoin de certaines choses pour transiter correctement : une adresse, un timbre, etc. Vous devez aussi utiliser une langue que votre destinataire comprend. C'est la même chose pour les paquets de données que vous envoyez pour voir un site web. Vous utilisez un protocole appelé HTTP (Hypertext Tranfer Protocol).
+
+Donc, au final, pour avoir un site web il faut qu'il soit sur un *serveur* (c'est une machine). Lorsque le *serveur* reçoit une *requête/0> (dans une lettre), il envoie votre site Web (dans une autre lettre).</p> 
+
+Puisqu'on est dans un tutoriel sur Django, vous devez vous demander ce que Django fait. Quand vous envoyez une réponse, vous ne renvoyez pas toujours la même réponse à tout le monde. C'est bien mieux quand les lettres sont personnalisées, surtout quand elles s'adressent à quelqu'un qui vient de vous écrire, non ? Et bien Django vous aide à écrire les lettres personnalisées et intéressantes. :)
+
+Assez parlé, il est temps de commencer à créer des trucs !
\ No newline at end of file
diff --git a/fr-FR/html/README.md b/fr-FR/html/README.md
new file mode 100644
index 00000000000..e810b99b45e
--- /dev/null
+++ b/fr-FR/html/README.md
@@ -0,0 +1,227 @@
+# Introduction au HTML
+
+Vous vous demandez sûrement ce qu'est un template.
+
+Un template est un fichier que vous pouvez réutiliser afin de présenter des informations différentes sous un seul et même format. Par exemple, vous pourriez avoir envie d'utiliser un template pour écrire une lettre : bien que son contenu varie ou qu'elle puisse être adressée à des personnes différentes, sa forme reste la même.
+
+Le format d'un template Django est décrit grâce à un langage qui s'appelle HTML (c'est le même HTML que celui dont nous parlions dans le chapitre un, **Comment fonctionne l'Internet**).
+
+## Qu'est-ce que le HTML ?
+
+HTML est un code qui est interprété par votre navigateur (Chrome, Firefox ou Safari) et qui permet d'afficher une page web à l'utilisateur.
+
+L'abréviation HTML signifie « HyperText Markup Language ». **HyperText** signifie que c'est un type de texte qui supporte les hyperliens entre les pages. **Markup** signifie que nous avons pris un document et que nous avons balisé le code pour signifier (ici, au navigateur) comment il faut interpréter la page. Le code HTML est construit à l'aide de **balises**, chacune commençant par `<` et finissant par `>`. Ces balises représentent des **éléments** markup.
+
+## Votre premier template !
+
+Créer un template signifie créer un fichier template. Et oui, encore des fichiers ! Vous aviez déjà probablement remarqué que tout tourne autour des fichiers.
+
+Les templates sont sauvegardés dans le dossier `blog/templates/blog`. Tout d'abord, créons un dossier appelé `templates` à l'intérieur du dossier de notre blog. Ensuite, créez un autre dossier appelé `blog` à l'intérieur de votre dossier templates :
+
+    blog
+    └───templates
+        └───blog
+    
+
+Vous pourriez vous demander pourquoi nous avons besoin de deux dossiers portant tous les deux le nom `blog`. Comme vous le découvrirez plus tard, c'est une convention de nommage qui va nous faciliter la vie quand les choses vont commencer à devenir compliquées.
+
+Et maintenant, créez un fichier `post_list.html` (laisser le vide pour le moment) dans le dossier `templates/blog/blog`.
+
+Allons regarder à quoi ressemble notre site maintenant : http://127.0.0.1:8000/
+
+> Si vous avez encore l'erreur `TemplateDoesNotExist`, essayez de redémarrer votre serveur. Allez sur votre ligne de commande et arrêtez votre server en appuyant simultanément sur Ctrl+C (les touches Control et C de votre clavier). Vous pouvez le relancer en tapant la commande `python manage.py runserver`.
+
+![Figure 11.1](images/step1.png)
+
+Et voilà, il n'y a plus d'erreurs ! Bravo :) Cependant, notre site ne peut rien faire d'autre pour le moment qu'afficher une page blanche. La faute à notre template que nous avons laissé vide. Allons corriger ça.
+
+Ouvrez le nouveau fichier dans l’éditeur de code et ajoutez le morceau suivant :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Bonjour !</p>
+    <p>Ça marche !</p>
+</body>
+</html>
+```
+
+Alors, à quoi ressemble notre site web maintenant ? Allons le découvrir : http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+Ça marche ! Bon boulot! :)
+
+* La ligne `<!DOCTYPE html>` n'est pas une balise HTML. Elle ne déclare que le type de document. Ici, elle informe le navigateur web que le type de document est [HTML5](https://html.spec.whatwg.org/#the-doctype). C'est toujours ainsi que débute un fichier HTML5.
+* La balise la plus élémentaire, `<html>`, figure toujours au début de n'importe quelle page web tandis que `</html>` est toujours située à la fin. Comme vous pouvez le constater, l'intégralité du contenu de notre page web est située entre la balise de départ, `<html>`, et la balise de fin, `</html>`
+* `<p>` est la balise pour les éléments de type paragraphe. `</p>` permet de fermer chaque paragraphe.
+
+## Head et Body
+
+Chaque page HTML est divisée en deux éléments : **head** (entête) et **body** (corps.
+
+* **head** est un élément qui contient des informations sur le document : son contenu ne s'affichera pas à l'écran.
+
+* **body** est un élément qui contient tout le reste. Son contenu s'affichera à l'écran et constituera notre page web.
+
+Nous utilisons `<head>` pour transmettre la configuration de la page au navigateur tandis que `<body>` l'informe sur le contenu de la page.
+
+Par exemple, vous pouvez donner un titre à votre page web en utilisant l'élément titre dans le `<head>` :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Bonjour !</p>
+        <p>Ça marche !</p>
+    </body>
+</html>
+```
+
+Sauvegardez votre fichier et actualisez la page.
+
+![Figure 11.3](images/step4.png)
+
+Vous avez vu comment le navigateur a compris que « Le Blog d'Ola » est le titre de votre page ? Il a interprété `<title>Le blog d'Ola</title>` et a placé ce texte dans la barre de titre de votre navigateur (c'est ce titre qui va être aussi utilisé lorsque vous créez un marque-page, etc.).
+
+Vous avez aussi probablement remarqué que chaque balise ouvrante possède sa *balise fermante*, composée d'un `/`, est qu'elles *encadrent* les différents éléments. Cela signifie que vous ne pouvez pas fermer une balise si celles imbriquées à l'intérieur de celle-ci n'ont pas été fermées.
+
+Pensez à lorsque vous mettez des choses à l'intérieur de boîtes. Vous avez une grosse boîte, `<html></html>`; à l'intérieur de celle-ci, on trouve une plus petite boîte, `<body></body>`, qui contient elle-même d'autres petites boîtes, `<p></p>`.
+
+Essayez de vous rappeler de cet exemple lorsque vous utilisez les balises *fermantes* et que vous avez des éléments *imbriqués*. Si vous ne suivez pas ces règles, votre navigateur risque de ne pas être capable d'interpréter votre code correctement et votre page web sera mal affichée.
+
+## Personnaliser votre template
+
+Et si nous en profitions pour nous amuser un peu ? Essayons de personnaliser notre template ! Voici quelques balises que vous pouvez utiliser :
+
+* `<h1>Titre 1</h1>` pour vos titres les plus importants
+* `<h2>Titre 2</h2>` pour les sous-titres
+* `<h3>Titre 3</h3>` ... et ainsi de suite jusqu'à `<h6>`
+* `<p>Un paragraphe contenant du texte</p>`
+* `<em>texte</em>` permet de mettre l'accent sur une partie du texte
+* `<strong>texte</strong>` permet de mettre encore plus l'accent sur une partie de texte
+* `<br>` permet d'insérer un saut de ligne (vous ne pouvez rien mettre à l'intérieur d'un élément br et il n'y a pas de balise fermante)
+* `<a href="https://djangogirls.org">link</a>` permet de créer un lien
+* `<ul><li>premier item</li><li>second item</li></ul>` permet de créer des listes, comme celle que nous sommes en train de faire !
+* `<div></div>` permet de créer une section au sein de la page
+* `<nav></nav>` définit un ensemble de liens de navigation
+* `<article></article>` spécifie du contenu indépendant et autonome
+* `<section></section>` définit une section dans un document
+* `<header></header>` spécifie un en-tête pour un document ou une section
+* `<main></main>` spécifie le contenu principal d'un document
+* `<aside></aside>` définit du contenu en dehors du contenu dans lequel il est placé (comme une barre latérale)
+* `<footer></footer>` définit un pied de page pour un document ou une section
+* `<time></time>` définit un instant spécifique (ou un horodatage)
+
+Voici un exemple d’un modèle complet, copiez et collez-le dans `blog/templates/blog/post_list.html` :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Blog Django Girls</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Blog Django Girls</a></h1>
+        </header>
+
+        <article>
+            <time>publication: 14.06.2014, 12:14</time>
+            <h2><a href="">Mon premier article</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>publication: 14.06.2014, 12:14</time>
+            <h2><a href="">Mon second article</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+Nous avons créé ici une section `en-tête` et deux sections `article`.
+
+* Le premier élément `header` contient le titre de notre blog - c'est à la fois un titre et un lien
+* Les deux éléments `article` contiennent nos articles de blog avec une date de publication dans un élément `time` un élément `h2` avec un titre de publication qui est cliquable et un élément `p` (paragraphe) pour le texte de notre blog.
+
+Ce qui nous donne :
+
+![Figure 11.4](images/step6.png)
+
+Yaaay ! Pour l'instant, notre template nous permet seulement d'afficher les **mêmes informations** alors que nous disions précédemment qu'il doit nous permettre d'afficher des informations **différentes** utilisant le **même format**.
+
+Ce qu'on aimerait pouvoir faire maintenant, c'est d'afficher les posts que nous avons créés précédemment dans l'interface d'administration de Django. Penchons-nous là dessus.
+
+## Une dernière chose : déployer !
+
+Ne serait-il pas génial de pouvoir voir tous ces changements en ligne ? Hop, déployons à nouveau !
+
+### Commiter et pusher votre code sur GitHub
+
+Tout d'abord, allons voir quels sont les fichiers qui ont changé depuis notre dernier déploiement (lancez ces commandes dans votre console locale et non celle de PythonAnywhere) :
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Assurez-vous d'être dans le dossier `djangogirls`. Voici la commande qui permet de dire à `git` d'inclure tout les changements qui ont eu lieu dans ce dossier :
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Avant que nous puissions uploader nos fichiers, regardons ce que `git` à l'intention de faire (tous les fichiers que `git` va uploader vont apparaître en vert) :
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+On y est presque : nous devons maintenant lui dire de sauvegarder ces changements dans son historique. Nous allons y ajouter un "message de commit" qui nous permettra de décrire ce qui a été changé. Vous pouvez mettre ce que vous voulez dans un message de commit. Généralement, il est préférable de mettre quelque chose d'utile qui vous permettra de vous souvenir plus tard de ce que vous avez fait.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Modification du HTML du site"
+    
+
+> **Note** Assurez-vous d'utiliser des guillemets doubles autour du message de commit.
+
+Une fois que nous avons fait cela, nous pouvons mettre en ligne (pusher) nos modifications sur GitHub :
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Puller les modifications sur PythonAnywhere et recharger son appli web
+
+* Allez sur la page des [consoles de PythonAnywhere](https://www.pythonanywhere.com/consoles/). Retournez dans votre **console Bash** ou ouvrez-en une nouvelle puis tapez la commande suivante :
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+N’oubliez pas de remplacer `<your-pythonanywhere-domain>` avec votre propre sous-domaine PythonAnywhere, sans les chevrons. Votre nom de sous-domaine est normalement votre nom d'utilisateur PythonAnywhere, mais dans certains cas, il peut être un peu différent (par exemple si votre nom d'utilisateur contient des lettres capitales). Donc, si cette commande ne fonctionne pas, utilisez la commande `ls` (lister fichiers) pour trouver votre sous-domaine/nom de dossier, puis `cd` jusque là.
+
+Maintenant, vous voyez votre code en train d'être téléchargé. Si vous voulez vérifier que le nouveau code est arrivé sur PythonAnywhere, vous pouvez aller sur la page **"Files"** et y retrouver les fichiers (vous pouvez naviguer dans les différentes pages de PythonAnywhere depuis le menu).
+
+* Pour finir, n'oubliez pas de recharger votre application web : onglet [Web](https://www.pythonanywhere.com/web_app_setup/) puis cliquez sur le bouton **Reload**.
+
+Retournez sur votre site en cliquant sur l'adresse en haut de la page : normalement, vous devriez voir la dernière version. Si ce n'est pas le cas, ce n'est pas grave : n'hésitez pas à demander de l'aider à votre coach. :)
\ No newline at end of file
diff --git a/fr-FR/installation/README.md b/fr-FR/installation/README.md
new file mode 100644
index 00000000000..052782998f5
--- /dev/null
+++ b/fr-FR/installation/README.md
@@ -0,0 +1,68 @@
+# Si vous suivez ce tutoriel chez vous
+
+Si vous suivez ce tutoriel chez vous et non dans un [évènement Django Girls](https://djangogirls.org/events/), vous pouvez passer directement au chapitre [Comment fonctionne Internet](../how_the_internet_works/README.md).
+
+La raison est que toutes les informations nécessaires aux installations seront données au fur et à mesure dans les différents chapitres du tutoriel. Celle-ci est juste une page supplémentaire qui rassemble toutes les instructions d’installation en un seul endroit (ce qui est utile pour certains formats d’atelier). Vous pouvez choisir d’installer tout ce qui est sur cette page dès maintenant si vous le souhaitez. Cependant, si vous avez envie d'apprendre des choses avant d'installer plein de trucs sur votre ordinateur : passez ce chapitre et installez ce dont vous avez besoin au fil des chapitres.
+
+Bonne chance !
+
+# Si vous participez à un atelier
+
+Si vous participez à un [événement Django Girls](https://djangogirls.org/events/) :
+
+* Dans certains cas un « party d’installation » a lieu avant l’atelier principal. Si vous vous trouvez à un party d’installation, cette page est pour vous ! Suivez les instructions ici pour installer tout ce dont vous avez besoin pour l’atelier. Demandez de l'aide aux coaches si nécessaire. Ensuite, pendant l'atelier vous pourrez ignorer les instructions d’installation que vous rencontrerez dans le tutoriel.
+* Les organisateurs de votre atelier vous ont peut-être proposé de procéder aux installations chez vous. Si c'est le cas, cette page est pour vous ! Suivez les instructions ici, autant que vous le pouvez. Pendant l’atelier principal, quand vous arrivez à une étape nécessitant d'un logiciel que vous n'avez pas réussi à installer toute seule, vous pourrez demander à votre coach.
+* Si votre atelier n’a pas de party d'installation (ou si vous l'avez raté), et si les organisateurs ne vous ont pas demandé d’essayer de tout installer en amont, ignorez cette page et allez directement au chapitre [Comment fonctionne Internet](../how_the_internet_works/README.md). Vous allez installer tout ce dont vous avez besoin au fur et à mesure que vous avancez dans le tutoriel.
+
+# Installation
+
+Dans ce tutoriel, vous allez apprendre comment créer un blog. Le tutoriel vous guidera à travers toute les étapes d'installation des différents logiciels, ansi que de création de comptes en ligne nécessaires. Cette page regroupe l’ensemble des instructions concernant installations et comptes en ligne en un seul endroit (ce qui est utile pour certains formats d’atelier).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brève introduction à la ligne de commande {#command-line}
+
+Dans les étapes ci-dessous vous allez rencontrer les noms « console », « terminal », « invite de commande » ou « ligne de commande ». Tous ces termes signifient la même chose : une fenêtre sur votre ordinateur où vous pouvez rentrer des commandes. Une fois que vous aurez démarré le tutoriel principal, vous apprendrez plus sur la ligne de commande. Pour l’instant, le plus important est que vous appreniez à ouvrir un terminal et que vous voyez à quoi cela ressemble : {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Installer Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Installer un éditeur de code {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Mettre en place virtualenv et installer Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Installer Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Créer un compte GitHub {#github-account}
+
+Allez sur [GitHub.com](https://www.github.com) et créez un compte d’utilisateur gratuitement. N’oubliez pas votre mot de passe (ajoutez-le à votre gestionnaire de mots de passe, si vous utilisez un).
+
+# Créer un compte PythonAnywhere {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Commencer à lire
+
+Félicitations, vous avez tout installé et êtes prête ! Si vous avez toujours du temps avant l'atelier, il peut être utile de commencer à lire les premiers chapitres :
+
+* [Comment fonctionne Internet](../how_the_internet_works/README.md)
+
+* [Introduction à la ligne de commande](../intro_to_command_line/README.md)
+
+* [Introduction à Python](../python_introduction/README.md)
+
+* [Qu'est-ce que Django?](../django/README.md)
+
+# Profitez de l’atelier !
+
+Lors de l’atelier, vous serez en mesure d'attaquer directement le chapitre [Votre premier projet Django !](../django_start_project/README.md) parce que vous aurez déjà couvert le matériel dans les chapitres précédents.
\ No newline at end of file
diff --git a/fr-FR/intro_to_command_line/README.md b/fr-FR/intro_to_command_line/README.md
new file mode 100644
index 00000000000..d52adf26777
--- /dev/null
+++ b/fr-FR/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction à l'interface en ligne de commande
+
+> Pour les lectrices à la maison : ce chapitre est traité dans la vidéo [Votre nouvel ami : la ligne de commande](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+C'est un peu exaltant, non ? Dans quelques instants, vous allez écrire votre première ligne de code! :)
+
+**Commençons par vous présenter un nouvel ami : la ligne de commande !**
+
+Les étapes suivantes vont vous montrer comment utiliser la fenêtre noire que tous les bidouilleurs·euses utilisent. Elle est un peu effrayante à première vue, mais en fait, c'est tout simplement un programme qui attend qu'on lui donne des commandes.
+
+> **Note :** Il existe deux mots pour parler de dossier : dossier ou répertoire. Il se peut que nous utilisions les deux dans le tutoriel mais, pas de panique : ils signifient la même chose.
+
+## Qu'est-ce qu'une ligne de commande ?
+
+Cette fenêtre, qu'on appelle aussi **ligne de commande** ou **interface en ligne de commande**, est une application textuelle qui permet de voir et de manipuler des fichiers sur votre ordinateur. C'est un peu la même chose que l'Explorateur Windows ou Finder dans Mac, mais sans interface graphique. On l'appelle parfois aussi : *cmd*, *CLI*, *prompt*, *console* ou *terminal*.
+
+## Ouvrir l'interface en ligne de commande
+
+Pour commencer à expérimenter, nous avons d'abord besoin d'ouvrir notre interface en ligne de commande.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Invite de commande
+
+Vous devriez maintenant voir une fenêtre noire ou blanche qui attend vos commandes.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Si vous êtes sous Mac ou Linux, vous verrez probablement un `$`, comme ça :
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Si vous êtes sous Windows, vous verrez probablement un `>`, comme ça :
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Jetez un coup d'œil à la section Linux ci-dessus : c'est à cela que la ligne de commande ressemblera une fois que vous serez sur PythonAnywhere.
+
+<!--endsec-->
+
+Chaque commande que vous taperez sera automatiquement précédée par un `$` ou `>` et une espace. Vous ne devez pas les rentrer vous-même, votre ordinateur le fera pour vous. :)
+
+> Petite remarque : il se peut que vous voyiez quelque chose comme `C:\Users\ola>` ou `Olas-MacBookAir:~ola$` avant le signe de prompt. Pas de problème : c'est parfaitement normal.
+
+La partie jusque et y compris le `$` ou le `>` est appelée *l’invite de commande*, ou *prompt* (en anglais) pour faire court. Elle vous invite à entrer une commande.
+
+Dans le tutoriel, lorsque nous voulons que vous tapiez une commande, nous allons inclure le `$` ou `>` et parfois d'autres information juste avant, à sa gauche. Ignorez cette partie à gauche et tapez uniquement la commande, qui commence après l’invite.
+
+## Votre première commande (YAY !)
+
+Commençons en tapant cette commande :
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+Puis appuyez sur la touche `entrée`. Voilà ce qui s'affiche chez moi :
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+Comme vous pouvez le voir, l'ordinateur vient d'afficher votre nom d'utilisateur. Sympa, non ? ;)
+
+> Essayez de taper chaque commande sans copier-coller. Ça aide à les retenir !
+
+## Les bases
+
+Les différents systèmes d'exploitation ont des commandes légèrement différentes, donc faites attention à suivre les instructions pour votre système d'exploitation. Allons-y !
+
+### Dossier courant
+
+Ce serait pratique de savoir dans quel répertoire nous nous trouvons. Pour le savoir, tapez la commande suivante et appuyez sur `entrée` :
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Remarque : « pwd » veut dire « print working directory » (afficher le dossier courant).
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note : « cd » signifie « changer répertoire ». Avec PowerShell vous pouvez utiliser pwd comme sur Linux ou Mac OSX.
+
+<!--endsec-->
+
+Vous verrez probablement quelque chose de similaire sur votre machine. Quand vous ouvrez une ligne de commande, vous démarrez habituellement dans le dossier personnel de votre utilisateur.
+
+* * *
+
+### En savoir plus sur une commande
+
+De nombreuses commandes que vous pouvez taper à l’invite de commande ont une aide intégrée que vous pouvez afficher et lire ! Par exemple, pour en savoir plus sur le répertoire actuel :
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+macOS et Linux ont une commande `man`, qui donne des informations sur les commandes. Essayez `man pwd` et regardez ce qui s'affiche, ou ajoutez `man` devant une autre commande pour voir sa documentation. La sortie de `man` est normalement paginée. Utilisez la barre d’espace pour passer à la page suivante et `q` pour quitter l’aide.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Ajouter un `/ ?` à la fin de la commande devrait également permettre d'afficher la page d’aide. Vous devrez peut-être faire défiler votre fenêtre de commande vers le haut pour tout voir. Essayez `cd / ?`.
+
+<!--endsec-->
+
+### Lister les fichiers et les dossiers
+
+Du coup, que pouvons-nous trouver dans ce dossier personnel ? Voyons voir :
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Bureau
+    Musique
+    Téléchargements
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Bureau
+    05/08/2020 07:28 PM <DIR>      Téléchargements
+    05/08/2020 07:28 PM <DIR>      Musique
+    ...
+    
+
+> Remarque : Dans PowerShell, vous pouvez également utiliser "ls" comme sur Linux et Mac OS X. <!--endsec-->
+
+* * *
+
+### Changer le dossier courant
+
+Maintenant, essayons d'aller sur notre Bureau :
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Bureau
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Bureau
+    
+
+Notez que le nom du répertoire « Bureau » pourrait être traduit dans la langue de votre compte Linux. Si c'est le cas, vous devrez remplacer `Bureau` par sa traduction. Par exemple, `Schreibtisch` pour l’allemand ou <0>Desktop</0> pour l'anglais.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Bureau
+    
+
+<!--endsec-->
+
+Vérifions que ça a bien changé :
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Bureau
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Bureau
+    
+
+<!--endsec-->
+
+Et voilà !
+
+> Pro tip : si vous tapez `cd B` puis que vous appuyez sur la touche `tabulation`, la ligne de commande va automatiquement compléter le reste du nom. Cela va vous permettre d'aller plus vite et d'éviter des fautes de frappe. Si plusieurs dossiers commencent par un « B », appuyez sur la touche `tabulation` deux fois pour avoir une liste des options.
+
+* * *
+
+### Créer un dossier
+
+Que diriez-vous de créer un répertoire dédié aux exercices sur votre bureau ? Vous pouvez le faire de cette façon :
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir exercices
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir exercices
+    
+
+<!--endsec-->
+
+Cette petite commande crée un dossier nommé `exercices` sur votre bureau. Vous pouvez vérifier qu'il est bien là en regardant votre Bureau, ou en lançant la commande `ls` ou `dir` ! Essayez donc. :)
+
+> Pro tip : Si vous voulez éviter de taper les mêmes commandes plein de fois, essayez d'appuyer sur les touches `flèche haut` et `flèche bas` pour retrouver les dernières commandes que vous avez tapées.
+
+* * *
+
+### Exercice !
+
+Un petit défi pour vous : dans votre nouveau dossier `exercices`, créez un dossier appelé `test`. (Pour ça, utilisez les commandes `cd` et `mkdir`.)
+
+#### Solutions :
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd exercices
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd exercices
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Félicitations ! :)
+
+* * *
+
+### Nettoyage
+
+Supprimons tout ce qu'on vient de faire, histoire d'éviter de laisser du bazar.
+
+D'abord, revenons au Bureau :
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Grâce à `...` et la commande `cd`, vous pouvez aller directement dans le dossier parent de votre répertoire courant (c'est-à-dire le dossier qui contient le dossier dans lequel vous étiez).
+
+Vérifiez où vous êtes :
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Bureau
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Bureau
+    
+
+<!--endsec-->
+
+Maintenant, il est temps de supprimer le dossier `exercices` :
+
+> **Attention** : Supprimer des fichiers avec `del`, `rmdir` ou `rm` est irrévocable, ce qui veut dire que *les fichiers supprimés sont perdus à jamais* ! Du coup, faites très attention avec cette commande.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r exercices
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S exercices
+    exercices, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Et voilà ! Pour être sure que le dossier a bien été supprimé, vérifions :
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Sortir
+
+C'est tout pour le moment ! Vous pouvez maintenant fermer la ligne de commande. Faisons-le à la manière des bidouilleurs⋅euses, d’accord ? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, non ? :)
+
+## Résumé
+
+Voici un résumé de quelques commandes utiles :
+
+| Commande (Windows) | Commande (macOS / Linux) | Description                      | Exemple                                           |
+| ------------------ | ------------------------ | -------------------------------- | ------------------------------------------------- |
+| exit               | exit                     | ferme la fenêtre                 | **exit**                                          |
+| cd                 | cd                       | change le dossier courant        | **cd test**                                       |
+| cd                 | pwd                      | montre le dossier courant        | **cd** (Windows) ou **pwd** (macOS / Linux)       |
+| dir                | ls                       | liste des fichiers/dossiers      | **dir**                                           |
+| copy               | cp                       | copie un fichier                 | **copy c:\test\test.txt c:\windows\test.txt** |
+| move               | mv                       | déplace un fichier               | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir              | mkdir                    | crée un nouveau dossier          | **mkdir testdirectory**                           |
+| rmdir (or del)     | rm                       | supprime un fichier              | **del c:\test\test.txt**                        |
+| rmdir /S           | rm -r                    | supprime un répertoire           | **rm -r testdirectory**                           |
+| [CMD] /?           | man [CMD]                | affiche l'aide pour une commande | **cd /?** (Windows) ou **man cd** (macOS / Linux) |
+
+Ce ne sont que quelques-unes des commandes que vous pouvez utiliser dans votre ligne de commande. Cette liste est suffisante pour réaliser ce tutoriel.
+
+Si vous êtes curieuse, [ss64.com](http://ss64.com) contient une référence complète de toutes les commandes pour tous les systèmes d'exploitation.
+
+## Vous êtes prête ?
+
+Plongeons dans Python !
\ No newline at end of file
diff --git a/fr-FR/intro_to_command_line/open_instructions.md b/fr-FR/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..608e1c81425
--- /dev/null
+++ b/fr-FR/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Une des procédures suivantes, selon votre version de Windows et votre clavier, devrait vous permettre d'ouvrir l'invite de commande (il est possible que vous deviez vous débrouiller un peu jusqu'à ce que vous trouvez la bonne) :
+
+- Allez dans le menu ou écran de démarrage et tapez "Invite de commande" dans l'outil de recherche.
+- Cliquez sur le Menu démarrer→ Système Windows → Invite de commandes.
+- Aller dans Menu démarrer → Tous les programmes → Accessoires → Invite de commandes.
+- Allez sur l’écran de démarrage, passez votre souris dans le coin inférieur gauche de l’écran et cliquez sur la flèche qui s’affiche (sur un écran tactile, plutôt balayer du bas vers le haut de l’écran). La page Apps doit s’ouvrir. Cliquez sur invite de commandes dans la section Système Windows.
+- Maintenez la touche Windows enfoncée et appuyez sur la touche « X » de votre clavier. Choisissez « Invite de commandes » dans le menu contextuel.
+- Maintenez la touche Windows enfoncée et appuyez sur la touche « R » pour ouvrir une fenêtre « Exécuter ». Tapez « cmd », puis cliquez sur la touche OK.
+
+![Tapez "cmd" dans la fenêtre "Exécuter"](../python_installation/images/windows-plus-r.png)
+
+Plus loin dans ce tutoriel, vous aurez besoin de deux fenêtres ouvertes en même temps. Toutefois, sur certaines versions de Windows, si vous avez déjà une fenêtre de commande ouverte et que vous essayez d’en ouvrir une seconde utilisant la même méthode, vous serez renvoyées vers la fenêtre de commande que vous avez déjà ouvert. Essayez-le maintenant sur votre ordinateur pour voir ce qui se passe ! Si vous obtenez seulement une fenêtre de commande, essayez l’une des autres méthodes dans la liste ci-dessus. Au moins une d'entre elles devrait vous donner une nouvelle fenêtre de commande.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Allez sur Applications → Utilitaires → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+C’est probablement sous Applications → Accessoires → Terminal ou Applications → Système → Terminal, mais cela peut dépendre de votre système. Si toujours rien, vous pouvez demander à Google. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/fr-FR/python_installation/README.md b/fr-FR/python_installation/README.md
new file mode 100644
index 00000000000..dd80800b48e
--- /dev/null
+++ b/fr-FR/python_installation/README.md
@@ -0,0 +1,15 @@
+# Commençons par Python
+
+On est parti !
+
+Tout d'abord, laissez-nous vous en dire un peu plus sur Python. Python est un langage de programmation très populaire qui peut être utilisé pour créer des sites web, des jeux, des logiciels scientifiques, des graphiques et bien d'autres choses encore.
+
+Python a été créé à la fin des années 1980. l'objectif principal des créateurs du langage était de rendre ce langage de programmation lisible aussi bien par des humains que par des machines. C'est pourquoi il semble plus simple que les autres langages de programmation, mais ne vous inquiétez pas - Python est aussi extrêmement puissant !
+
+# Installation de Python
+
+> **Note** Si vous utilisez un Chromebook, passez ce chapitre et prenez soin de suivre les instructions de [configuration pour Chromebook](../chromebook_setup/README.md).
+> 
+> **Note **Si vous avez déjà effectué [l'Installation](../installation/README.md) vous devriez déjà avoir fait ce qui suit. Vous pouvez donc passer directement au chapitre suivant !
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/fr-FR/python_installation/instructions.md b/fr-FR/python_installation/instructions.md
new file mode 100644
index 00000000000..c2722c45e34
--- /dev/null
+++ b/fr-FR/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Pour les lecteur·rices autodidactes (et qui n'ont pas de soucis avec l'anglais) : Ce chapitre est traité dans la vidéo [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> Cette section repose sur un tutoriel de Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django est écrit en Python. Pour réaliser quelque chose en Django, il va nous falloir Python. Commençons par l'installer ! Pour suivre ce tutoriel, l'idéale est d'installer la dernière version de Python 3. Si vous avez une version antérieure, il va falloir la mettre à jour. Si vous avez déjà la version {{ book.py_min_version }} ou supérieure, ça devrait aller.
+
+Veuillez installer Python comme suit, même si vous avez déjà installé Anaconda sur votre ordinateur.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Vérifiez d'abord si votre ordinateur exécute une version 32 bits ou une version 64 bits de Windows, en cherchant "Type du système" dans la page d'information système. Pour accéder à cette page, essayez l'une de ces méthodes :
+
+* Appuyez sur la touche Windows et la touche Pause/Attn en même temps
+* Ouvrez votre panneau de configuration depuis le menu Windows, puis naviguez vers Système et sécurité, puis Système
+* Appuyez sur la touche Windows, puis accédez à Paramètres > Système > A propos
+* Recherchez dans le menu Démarrer Windows le raccourci "Informations système". Pour ce faire, cliquez sur le bouton Démarrer ou appuyez sur la touche Windows, puis commencez à taper `Informations système`. Des entrées correspondantes apparaîtrons dès que vous tapez. Vous pouvez sélectionner l'entrée une fois qu'elle apparaît.
+
+Vous pouvez télécharger Python pour Windows depuis le site web https://www.python.org/downloads/windows/. Cliquez sur le lien "Latest Python 3 Release - Python x.x.x". Si votre ordinateur exécute une version **64-bit** de Windows, téléchargez l'installateur exécutable **Windows x86-64 executable installer**. Sinon, téléchargez **Windows x86 executable installer**. Après avoir téléchargé l'installateur, vous devriez l'exécuter (double-cliquez dessus) et suivre les instructions.
+
+Une chose à surveiller : lors de l’installation, vous remarquerez une fenêtre marquée « Setup ». Assurez-vous de cocher la case "Add Python {{ book.py_version }} to PATH" ou "Add Python to your environment variables" et cliquez sur "Install Now", comme indiqué ici (cela peut s'afficher un peu différemment si vous installez une autre version):
+
+![N'oubliez pas d'ajouter Python à votre chemin (path)](../python_installation/images/python-installation-options.png)
+
+Une fois l’installation terminée, vous verrez une boîte de dialogue contenant un lien que vous pouvez suivre pour en savoir plus sur Python ou sur la version que vous avez installée. Fermez ou annulez cette boîte de dialogue -- vous en apprendrez plus dans ce tutoriel !
+
+Note : Si vous utilisez une ancienne version de Windows (7, Vista, ou n'importe quelle version antérieure) et l'installateur Python {{ book.py_version }} échoue avec une erreur, alors installez toutes les mises à jour Windows et essayez d'installer Python à nouveau. Si vous avez toujours l'erreur, essayez d'installer la version {{ book.py_min_release }} de Python depuis [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} a besoin de Python {{ book.py_min_version }} ou plus récent, qui n'est pas pris pas en charge par Windows XP ou les versions précédentes.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Avant d'installer Python sur OS X, vous devriez vous assurer que vos paramètres Mac permettent d'installer des programmes qui ne proviennent pas de l'App Store. Allez dans Préférences Système (c'est dans le dossier Applications), cliquez sur "Sécurité & Confidentialité", puis sur l'onglet "Général". Si votre "Autoriser les applications téléchargées de:" est défini sur "Mac App Store", changez-le à "Mac App Store et développeurs identifiés".
+
+Vous devez aller sur le site https://www.python.org/downloads/mac-osx/ et télécharger l'installateur python:
+
+* Téléchargez le fichier *Mac OS X 64-bit/32-bit installer*,
+* Double-cliquez sur le fichier *python-{{ book.py_release }}-macosx10.9.pkg* pour lancer l'installateur.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Il est très probable que Python soit déjà installé sur votre machine. Afin de vérifier qu'il est bien installé (et surtout quelle version vous avez), ouvrez une console et tapez la commande suivante :
+
+{% filename %}ligne de commande{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+Si vous avez une version différente de Python installée, au moins {{ book.py_min_version }} (par exemple {{ book.py_min_release }}), vous n'avez pas besoin de mettre à jour Python. Si Python n'est pas installé, ou si vous voulez une version différente, vérifiez d'abord la distribution Linux que vous utilisez avec la commande suivante :
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Ensuite, selon le résultat, suivez l'un des guides d'installation sous cette section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Tapez cette commande dans votre terminal :
+
+{% filename %}ligne de commande{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Tapez cette commande dans votre terminal :
+
+{% filename %}ligne de commande{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+Si vous utilisez une ancienne version de Fedora, vous pourriez avoir une erreur disant que la commande `dnf` n'est pas trouvée. Dans ce cas, vous devez utiliser la commande `yum` à la place.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Tapez cette commande dans votre terminal :
+
+{% filename %}ligne de commande{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Vérifiez que l'installation s'est bien déroulée en ouvrant votre terminal et en lançant la commande `python3`:
+
+{% filename %}ligne de commande{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+La version affichée peut être différente de {{ book.py_release }} -- elle devrait correspondre à la version que vous avez installée.
+
+**NOTE:** Si vous êtes sur Windows et que vous obtenez un message d'erreur disant que `python3` n'a pas été trouvé, essayez d'utiliser `python` (sans `3`) et vérifiez si elle lance une version de Python {{ book.py_min_version }} ou ultérieure. Si cela ne fonctionne pas non plus, vous pouvez ouvrir une nouvelle ligne de commande et réessayer ; cela se produit si vous utilisez une fenêtre de ligne de commande datant d'avant l'installation de Python.
+
+* * *
+
+Si vous avez des questions ou si quelque chose ne fonctionne pas et que vous ne savez pas quoi faire : demandez de l'aide à votre coach ! Il arrive parfois que les choses ne se déroulent pas comme prévu et il est alors préférable de demander à quelqu'un qui a plus d'expérience.
\ No newline at end of file
diff --git a/fr-FR/python_introduction/README.md b/fr-FR/python_introduction/README.md
new file mode 100644
index 00000000000..559d3a226e6
--- /dev/null
+++ b/fr-FR/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction à Python
+
+> Une partie de ce chapitre s’inspire du tutoriel des Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Allons écrire du code !
+
+## Le prompt Python
+
+> Pour les lecteurs à la maison: cette partie est couverte dans la vidéo [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) .
+
+Pour commencer à jouer avec Python, nous avons besoin d'ouvrir une *ligne de commande* sur votre ordinateur. Normalement, vous savez déjà comment le faire – vous l'avez appris dans le chapitre [Introduction à la ligne de commande](/intro_to_command_line/README. html).
+
+Dès que vous êtes prête, suivez les instructions suivantes.
+
+Afin d'ouvrir une console Python, tapez `python` sous Windows ou `python3` sous Mac OS/Linux et appuyez sur `entrée`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Votre première commande Python !
+
+Après avoir lancé la commande Python, votre prompt (ou invite de commandes) a changé en `>>>`. Cela signifie que maintenant, les seules commandes que nous pouvons taper sont des commandes appartenant au langage Python. Vous n'avez pas besoin de taper `>>>` - Python fait ça pour vous.
+
+Si vous voulez quitter la console Python, tapez `exit()` ou utilisez le raccourci `Ctrl + Z` pour Windows ou `Ctrl + D` pour Mac/Linux. Après ça, vous ne verrez plus le `>>>`.
+
+Pour l'instant, nous ne voulons pas quitter la console Python. Nous voulons en savoir plus. Commençons par écrire quelques operations mathématiques, comme `2 + 3` suivi par la touche `entrée`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Pas mal, non ? Vous avez vu comment la réponse a surgi ? Python s'y connait en math ! Vous pouvez essayer d’autres commandes comme :
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Pour effectuer un calcul exponentiel, disons 2 à la puissance 3, nous tapons : {% filename %}ligne de commande{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Amusez-vous un peu avec ça, et revenez ici après. :)
+
+Comme vous pouvez le constater, Python est une très bonne calculette. Comme vous vous en doutez, il est aussi capable de faire autre chose…
+
+## Chaines de caractères (Strings)
+
+Et si nous essayions avec votre nom ? Tapez votre prénom entre guillemets, comme cela :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+Vous venez de créer votre première chaîne de caractères ! C'est une suite de caractères qui peut être traitée par un ordinateur. Une chaine de caractères doit toujours commencer et terminer par le même caractère. Çela peut être un guillemet simple (`'`) ou un guillemet double (`"`), ça n'a pas d'importance. Cela permet à Python de savoir que tout ce qui se trouve à l'intérieur de ces guillemets est une chaîne de caractères.
+
+Il est possible d'assembler des chaines de caractères comme ceci :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Salut  " + "Ola"
+'Salut Ola'
+```
+
+Vous pouvez aussi multiplier une chaîne de caractères par un nombre :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Si vous avez besoin de mettre une apostrophe dans votre chaine de caractères, vous avez deux possibilités.
+
+Vous pouvez utiliser des guillemets doubles :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "J'aime la mousse au chocolat"
+"J'aime la mousse au chocolat"
+```
+
+ou échapper l’apostrophe avec une barre oblique inversée (un backslash, `\`) :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'J\'aime la mousse au chocolat'
+"J'aime la mousse au chocolat"
+```
+
+Pas mal, non ? Pour voir votre nom en majuscules, tapez juste :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Vous venez d'utiliser la **fonction** `upper` sur votre chaine de caractères! Une méthode (comme `upper()`) est un ensemble d'instructions que Python va effectuer sur un objet donné (`"Ola"`) lorsque vous l’appellerez.
+
+Si vous voulez savoir combien il y a de lettres dans votre nom, il y a une **fonction** pour ça !
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Vous avez peut-être remarqué que parfois, on appelle la fonction avec `.` en la plaçant après la chaine de caractères (comme `"Ola".upper()`) alors qu'à d'autres moment, on appelle d'abord la fonction puis la chaine de caractères entre parenthèses. Il s'avère que dans certains cas, les fonctions appartiennent à des objets (c'est le cas de `upper()`) et qu'elles ne peuvent être appliquées qu'à des chaines de caractères. Dans ce cas, on appelle la fonction une **méthode**. D'autres fois, les fonctions n’appartiennent à rien de particulier et peuvent être utilisées sur différents types d'objets (c'est le cas de `len()`). C'est pour ça que nous passons `"Ola"` comme argument à la fonction `len`.
+
+### Résumé
+
+OK, assez parlé de chaines de caractères. Jusque-là, nous avons découvert :
+
+- **le prompt** – taper des commandes (du code) dans le prompt Python donne des réponses dans Python
+- **les nombres et les chaines de caractères** – dans Python, les nombres sont utilisés pour faire des calculs, et les chaines de caractères pour manipuler du texte
+- **opérateurs** – comme `+` et `*`, ils combinent des valeurs pour en produire une nouvelle
+- **les fonctions** – comme `upper()` et `len()` qui effectuent des actions sur les objets.
+
+Ce sont des bases présentes dans tous les langages de programmation existants. Prête pour quelque chose de plus compliqué ? Allons-y !
+
+## Les erreurs
+
+Essayons quelque chose de nouveau. Pouvons-nous obtenir la longueur d’un nombre de la même façon que celle de notre nom ? Tapez `len(304023)` et appuyez sur `entrée` :
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Nous avons eu notre première erreur! L'icône {{ warning_icon }} est notre façon de vous alerter que le code que vous êtes sur le point d'exécuter ne fonctionnera pas comme prévu. Faire des erreurs (même intentionnellement) est une partie importante de l'apprentissage!
+
+L'erreur que nous venons d'avoir nous dit que les objets de type "int" (integers, ce qui signifie nombre entier) n'ont pas de longueur. Que pouvons-nous faire, du coup ? Pourquoi ne pas essayer d'écrire notre nombre comme une chaine de caractères ? Après tout, les chaînes de caractères ont bien une taille, non ?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Ça a marché ! Nous avons utilisé la fonction `str` à l'intérieur de la fonction `len`. La fonction `str()` convertit n'importe quoi en chaine de caractères.
+
+- La fonction `str` convertit des choses en **chaines de caractères**
+- La fonction `int` convertit des choses en **entiers**
+
+> Important : il est possible de convertir des nombres en texte, mais il n'est pas toujours possible de convertir du texte en nombres. Parce que, bon, ça vaudrait quoi `int('salut')` ?
+
+## Variables
+
+Il existe un concept super important en programmation : les variables. Une variable, c'est juste un nom pour quelque chose que l'on aimerait utiliser plus tard. Les programmeurs⋅euses utilisent des variables pour stocker des données, rendre leur code plus lisible, et pour ne pas avoir à se rappeler de ce que sont les choses.
+
+Disons que nous aimerions créer une variable appelée `name` :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+Nous tapons name égale Ola.
+
+Vous avez peut-être remarqué que contrairement à tout à l'heure, le programme ne renvoie rien. Du coup, comment faire pour vérifier que la variable existe vraiment ? Tapez `name` et appuyez sur `entrée` :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Youpi ! Votre première variable ! :) Vous pouvez toujours changer ce à quoi elle fait référence :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+Vous pouvez aussi l'utiliser avec des fonctions :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Génial, non ? Et bien sûr, les variables peuvent être n'importe quoi, y compris des nombres ! Essayez ça :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Mais que ce passe-t-il si nous utilisons le mauvais nom ? Essayez de deviner ! C'est parti !
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Une erreur ! Comme vous pouvez le voir, Python a différents types d'erreurs, et celle-ci est une **NameError**. Python vous donne cette erreur quand vous essayez d'utiliser une variable qui n'a pas encore été définie. Si vous rencontrez cette erreur par la suite, vérifiez dans votre code que vous n'avez pas fait une faute de frappe dans une variable.
+
+Jouez un peu avec les variables et essayez de voir ce que vous pouvez en faire !
+
+## La fonction print
+
+Essayez ça :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Quand vous tapez `name`, l'interpréteur Python répond avec la *représentation* de la chaine de caractères associée à la variable "name", c'est à dire les lettres M-a-r-i-a, entourées par des guillemets simples. Quand vous dites `print(name)`, Python va "imprimer" le contenu de la variable sur l'écran, sans les guillemets, ce qui est plus sympa.
+
+Comme nous le verrons plus tard, `print()` est aussi utile lorsque l'on veut afficher des choses depuis l'intérieur de fonctions ou des choses sur plusieurs lignes.
+
+## Les listes
+
+En plus des chaines de caractères et des entiers, Python possède tout un tas d'autres types d'objets. Nous allons maintenant vous présenter un type appelé **list** (liste). Les listes sont exactement ce que vous pensez : des objets qui sont des listes d’autres objets. :)
+
+Allez-y, créez une liste :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Oui, cette liste est vide. Pas très utile, non ? Créons maintenant une liste de numéros de loterie. Nous ne voulons pas nous répéter tout le temps, donc mettons-la dans une variable :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+Voilà, nous avons une liste ! Qu'est ce que nous pourrions en faire ? Commençons par voir combien de numéros de loterie il y a dans cette liste. Une idée de la fonction pour faire ça ? Vous la connaissez déjà !
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Hé oui ! `len()` peut aussi vous donner le nombre d'objets dans une liste. Pratique, non ? Peut-être qu'on peut aussi la trier :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Ça ne renvoie rien : cette fonction a juste changé l'ordre dans lequel les nombres apparaissent dans la liste. Affichons-la encore pour voir ce qu'il s'est passé :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Comme vous pouvez le voir, les nombres de la liste sont maintenant triés du plus petit au plus grand. Bravo !
+
+Pouvons-nous inverser cet ordre ? Essayons!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+Si vous voulez ajouter quelque chose à la liste, vous pouvez le faire en tapant cette commande :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Si vous ne souhaitez afficher que le premier élément, vous pouvez le faire en utilisant des **indices**. Un indice est un nombre qui indique où se trouve un élément dans la liste. Les programmeurs⋅euses préfèrent compter à partir de 0 : le premier objet dans notre liste a donc pour indice 0, le suivant 1 et ainsi de suite. Essayez ça :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Comme vous pouvez le voir, nous pouvons accéder à différents objets dans la liste en utilisant le nom de la liste suivi de l'indice de l'objet entre crochets.
+
+Pour supprimer quelque chose de votre liste, vous devrez utiliser les **indices** comme nous l'avons appris ci-dessus et la méthode `pop()` . Essayons l'exemple suivant : supprimez le premier élément de votre liste.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Ça marche à merveille !
+
+Jouons encore un peu avec les indices ! Essayez-en des nouveaux : 6, 7, 1000, -1, -6 ou -1000. Est-ce que vous arrivez à prévoir le résultat avant de taper la commande ? Est-ce que ses résultats vous paraissent logiques ?
+
+Vous pouvez trouver une liste complète des méthodes disponibles pour les listes dans ce chapitre de la documentation de Python : https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionnaires
+
+> Pour les lectrices autodidactes : cette partie est traitée dans la vidéo [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+
+Un dictionnaire est un peu comme une liste. Cependant, nous utilisons des clefs plutôt que des indices numériques pour accéder aux valeurs. Une clef peut être n'importe quelle chaîne de caractères ou n'importe quel nombre. La syntaxe pour définir un dictionnaire vide est la suivante :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Cela montre que vous venez de créer un dictionnaire vide. Hurray !
+
+Maintenant, essayez d'écrire la commande suivante (et essayez aussi de remplacer le contenu par vos informations) :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+Avec cette commande, vous venez de créer une variable nommée `participant` avec trois paires clef–valeur :
+
+- La clef `name` pointe vers la valeur `'Ola'` (un objet `chaine de caractères`),
+- `country` pointe vers `'Poland'` (une autre `chaine de caractères`),
+- et `favorite_numbers` pointe vers `[7, 42, 92]` (une `liste` contenant trois nombres).
+
+Vous pouvez vérifier le contenu de chaque clef avec cette syntaxe :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Vous voyez, c'est un peu comme une liste; Cependant, vous n'avez pas besoin de vous souvenir de l'indice, juste de son nom.
+
+Que ce passe-t-il lorsque nous demandons à Python la valeur correspondant à une clef qui n'existe pas ? Pouvez-vous le deviner ? Essayons voir !
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Oh, une autre erreur ! Celle-ci est une **KeyError**. Python nous donne un coup de main et nous dit que la clef `'age'` n'existe pas dans le dictionnaire.
+
+Vous vous demandez peut-être quand est-ce qu'il faut utiliser un dictionnaire ou une liste ? C'est une bonne question. Réfléchissez-y un instant avant de regarder la réponse à la ligne suivante.
+
+- Vous avez besoin d'une suite ordonnée d'éléments ? Utilisez une liste.
+- Vous avez besoin d'associer des valeurs à des clefs, de manière à pouvoir les retrouver efficacement (par clef) par la suite ? Utilisez un dictionnaire.
+
+Comme les listes, les dictionnaires sont *mutables*, ce qui signifie qu'ils peuvent être modifiés après leur création. Vous pouvez ajouter de nouvelles paires clé–valeur au dictionnaire après sa création, comme ceci :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Comme pour les listes, la fonction `len()` permet d'obtenir le nombre de paires clef–valeur du dictionnaire. Essayez de taper la commande suivante :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+J'espère que c'est compréhensible pour l'instant :) Prête pour s'amuser un peu plus avec les dictionnaires ? Passez à la ligne suivante pour voir des trucs géniaux.
+
+Vous pouvez utiliser la méthode `pop()` pour supprimer un élément du dictionnaire. Par exemple, si vous voulez supprimer l'entrée correspondant à la clé `« favorite_numbers »`, tapez la commande suivante :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Comme vous pouvez le voir dans votre console, la paire clef–valeur correspondant à "favorite_numbers" a été supprimée.
+
+De même, vous pouvez changer la valeur associée à une clef déjà créée dans le dictionnaire. Tapez ceci :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Voilà, la valeur de la clé `"country"` a été modifiée de `"Poland"` à `"Germany"`. :) Ce n'est pas cool ça ? Yep ! Un autre truc génial d'appris.
+
+### Résumé
+
+C'est super ! Vous savez plein de choses sur la programmation maintenant. Dans cette partie, vous avez appris :
+
+- **les erreurs** – vous savez maintenant comment lire et comprendre les erreurs qui apparaissent quand Python ne comprend pas l'une de vos commandes
+- **les variables** – des noms pour les objets qui vous permettent de coder plus facilement et de rendre votre code plus lisible
+- **les listes** – des listes d'objets stockés dans un ordre particulier
+- **les dictionnaires** – des objets stockés sous forme de paires clef–valeur
+
+On continue ? :)
+
+## Comparer des choses
+
+> Pour les lectrices autodidactes : cette partie est traitée dans la vidéo [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4).
+
+Comparer des choses est très important en programmation. Quelle serait la chose la plus facile à comparer ? Les nombres, bien sûr ! Allons voir comment ça marche :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+Nous avons donné à Python quelques nombres à comparer. Comme vous pouvez le voir, Python n'est pas seulement capable de comparer des nombres, mais il peut aussi comparer les valeurs des expressions mathématiques comme `2 * 2` avec le résultat d'une fonction comme le `2` renvoyé par `len([4, 5])`. Pas mal, non ?
+
+Vous vous demandez probablement pourquoi nous avons mis deux signes `==` côte à côte pour savoir si deux nombres étaient égaux ? On utilise déjà `=` pour assigner des valeurs aux variables. Du coup, il faut toujours, oui **toujours**, mettre deux `==` si vous voulez savoir si deux choses sont égales. Nous pouvons aussi dire que certaines choses ne sont pas égales à d'autres. Pour cela, nous utilisons le symbole `! =`, comme illustré dans l'exemple ci-dessus.
+
+Donnons encore un peu de boulot à Python :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+`>` et `<` sont faciles, mais qu'est ce que `>=` et `<=` veulent dire ? Ils se lisent comment ça :
+
+- x `>` y veut dire : x est plus grand que y
+- x `<` y signifie: x est inférieure à y
+- x `< =` y signifie: x est inférieur ou égal à y
+- x `>=` y veut dire : x est supérieur ou égal à y
+
+Super ! Un dernier ? Essayez ça :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Vous pouvez donner à Python autant de nombres à comparer que vous le souhaitez et il vous donnera une réponse. Plutôt malin, non ?
+
+- **and** – si vous utilisez l'opérateur `and` (et), les deux comparaisons doivent être True (vraies) pour que la commande toute entière soit True
+- **or** – si vous utilisez l'opérateur `or` (ou), il suffit qu'une des deux comparaisons soit True (vraie) pour que la commande toute entière soit True
+
+Vous connaissez l'expression "on ne compare pas les choux et les carottes" ? Essayons l'équivalent en Python :
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Comme vous le voyez, Python n'est pas capable de comparer un nombre (`int`) et une chaine de caractères (`str`). À la place, il nous montre une **TypeError** et nous dit que les deux types ne peuvent pas être comparés.
+
+## Booléen
+
+Vous venez d'apprendre un nouveau type d'objet en Python. Il s'appelle **Boolean**.
+
+Il n'y a que deux objets Booléens :
+
+- True (vrai)
+- False (faux)
+
+Pour que Python comprenne qu'il s'agit d'un Boléen, il faut toujours l'écrire 'True' (première lettre en majuscule, les autres en minuscule). **true, TRUE, tRUE ne marchent pas -- seul True est correct.** (Et c'est aussi vrai pour False.)
+
+Les Booléens aussi peuvent être des variables ! Regardez :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Vous pouvez aussi faire ça :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Entraînez-vous et amusez-vous avec les Booleéns en essayant de lancer les commandes suivantes :
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Bravo ! Les Booléens sont l'une des fonctionnalités les plus cools en programmation et vous venez juste d'apprendre comment les utiliser !
+
+# Sauvegardez tout ça !
+
+> Pour les lectrices autodidactes : cette partie est traitée dans la vidéo [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk).
+
+Pour l'instant, nous avons écrit tout notre code Python directement dans l'interpréteur, ce qui nous limite à une ligne de code à la fois. Les programmes sont typiquement sauvegardés dans des fichiers et sont exécutés par **l'interpréteur** ou le **compilateur** de notre langage de programmation. Jusqu'à présent, nous avons lancé nos programmes une ligne à la fois dans **l'interprèteur** Python. Nous aurons besoin de plus d'une ligne de code pour les prochaines tâches, donc nous aurons rapidement besoin de :
+
+- Quitter l'interpréteur Python ;
+- Ouvrir l'éditeur de code de notre choix ;
+- Sauvegarder du code dans un nouveau fichier Python ;
+- Le lancer !
+
+Pour quitter l'interpréteur Python que nous sommes en train d'utiliser, il suffit de taper la fonction `exit()`
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Cela vous ramènera dans la ligne de commande de votre système d'exploitation.
+
+Tout à l'heure, nous avions choisi un éditeur de code de la section [code editor](../code_editor/README.md). Nous allons maintenant ouvrir l'éditeur et écrire du code dans un nouveau fichier (ou, si vous utilisez un Chromebook, créez un nouveau fichier dans le cloud IDE et ouvrez le fichier, qui sera dans l'éditeur de code inclus) :
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Vous avez maintenant pas mal de connaissances en Python : n'hésitez pas à écrire du code avec ce que vous avez appris aujourd'hui !
+
+Maintenant, nous devons sauvegarder le fichier et lui donner un nom descriptif. Appelons le fichier **python_intro.py** et sauvegardons-le sur votre bureau. Vous pouvez donner le nom que vous souhaitez à ce fichier mais il est important qu'il se termine par **.py**. L'extension **.py** permet de signaler à votre système d'exploitation que ce fichier est un **fichier exécutable Python** et que Python peut le lancer.
+
+> **Note :** Vous avez probablement constaté que votre code se pare de multiples couleurs : ça fait partie des choses qui rendent la programmation dans un éditeur de texte bien plus agréable ! Votre console Python n'avait pas cette fonctionnalité : tout était donc de la même couleur. Dans votre éditeur de texte, vous devriez voir que la fonction `print`, par exemple, n'a pas la même couleur d'une chaîne de caractères. C'est ce qu'on appelle « la coloration syntaxique ». C'est une fonctionnalité très utile lorsque l'on programme. La couleur des choses va vous permettre de détecter des problèmes : une chaine de caractères non fermée, une faute dans un mot (ce sera par exemple le cas dans la fonction `def` que vous verrez un peu plus tard). C'est ce genre de fonctionnalités qui font que vous aimerez rapidement programmer avec un éditeur de code. :)
+
+Une fois que le fichier est sauvegardé, vous pouvez le lancer ! En utilisant les compétences que vous avez apprises dans la section sur la ligne de commande, utilisez le terminal pour **changer le dossier courant** vers le bureau.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Sur Mac, ça ressemblera à :
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Sur Linux, ce sera comme ça :
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(N'oubliez pas que le mot "Bureau" peut être traduit dans votre langue locale.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+Dans l'invite de commande Windows, ce sera comme ceci :
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+Et sur Windows Powershell, ce sera comme ça :
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Si vous êtes coincées, demandez de l'aide. C'est exactement pour ça que les coaches sont là !
+
+Maintenant, utilisez Python pour exécuter le code contenu dans votre fichier :
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: sur Windows 'python3' n'est pas reconnu comme une commande. Au lieu de cela, utilisez 'python' pour exécuter le fichier :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Super ! Vous venez de lancer votre premier programme python à partir d'un fichier. Cool non ?
+
+Et maintenant, passons à un autre outil essentiel de la programmation :
+
+## If … elif … else
+
+Quand on code, il y a plein de choses qui ne doivent être exécutées que dans certaines conditions. Pour cela, Python possède ce qu'on appelle l'instruction **if** (si).
+
+Remplacez le code dans votre fichier **python_intro.py** avec ceci :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Si nous sauvegardons ce fichier et que nous l'exécutons, nous obtiendrons l'erreur suivante :
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python s'attend à ce que nous lui donnions des instructions sur ce qu'il faut exécuter lorsque la condition `3 > 2` est vraie (ou plutôt, `True`). Essayons de lui faire afficher "Ça marche !". Remplacez le code dans **python_intro.py** par ceci :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('Ça marche !')
+```
+
+Avez-vous remarqué que nous avions décalé la ligne suivante de quatre espaces ? C'est ce que l'on appelle indenter. Nous avons besoin d'indenter pour que Python sache quel code exécuter si le résultat est vrai. Un seul espace suffirait, mais à peu près tous⋅tes les programmeurs⋅euses Python pensent que 4 espaces sont plus clairs. La touche de tabulation (Tab) devrait ajouter automatiquement 4 espaces, mais cela peut dépendre du paramétrage de votre éditeur de texte. Lorsque vous avez fait votre choix, ne le changez pas ! Si vous avez déjà indenté avec 4 espaces, faites de même dans le reste du fichier - sinon vous risquez de rencontrer des problèmes.
+
+Sauvegardez le fichier et relancez le :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+Ça marche !
+```
+
+Note: N'oubliez pas que sur Windows, 'python3' n'est pas reconnu comme une commande. À partir de maintenant, remplacez 'python3' par 'python' pour exécuter le fichier.
+
+### Et que se passe-t-il si une condition n’est pas vraie ?
+
+Dans les exemples précédents, Python a exécuté du code parce que celui-ci se trouvait sous une condition qui était vraie. Cependant, Python possède aussi des instructions `elif` (sinon si) et `else` (sinon) :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 est effectivement plus grand que 2')
+else:
+    print("5 n'est pas plus grand que 2")
+```
+
+Lorsque vous exécuterez le code, ceci s'affichera :
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 est effectivement plus grand que 2
+    
+
+Et si 2 était plus grand que 5, la seconde commande serait exécutée. Voyons comment `elif` fonctionne :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+Exécutons le code :
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+Que s'est-il passé ? `elif` vous permet d'ajouter d'autres conditions à exécuter si les précédentes échouent.
+
+Vous pouvez ajouter autant de `elif` que vous le souhaitez après le premier `if`. Voici un exemple :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python va tester les différentes conditions puis il affichera ceci :
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Parfait, je peux entendre tous les détails du morceau.
+    
+
+## Commentaires
+
+Les commentaires sont des lignes commençant par `#`. Vous pouvez écrire ce que vous voulez après le `#` et Python va l'ignorer. Les commentaires peuvent rendre votre code plus facile à comprendre pour d'autres personnes.
+
+Voyons à quoi cela ressemble :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+Vous n'avez pas besoin d'écrire un commentaire pour chaque ligne de code, mais il est utile parfois d'expliquer pourquoi votre code fait une certaine chose, ou de fournir un résumé pour les parties les plus complexes.
+
+### Résumé
+
+Avec ces derniers exercices, vous avez appris :
+
+- **Comment comparer des choses** – en Python, vous pouvez comparer des choses avec `>`, `>=`, `==`, `<=`, `<` et avec les opérateurs `and`, `or`
+- **Booléen** – un type d'objet qui n'a que deux valeurs possibles : `True` et `False`
+- **Comment sauvegarder des fichiers** – stocker votre code dans des fichiers pour pouvoir écrire des programmes plus longs.
+- **if … elif … else** – des instructions que vous permettent de n'exécuter du code que dans certaines conditions.
+- **commentaires** – lignes que Python n'exécutera pas et qui vous permettent de documenter votre code.
+
+Il est temps d'attaquer la dernière partie de ce chapitre !
+
+## Vos propres fonctions !
+
+> Pour les lectrices autodidactes : cette partie est traitée dans la vidéo [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0).
+
+Vous vous souvenez des fonctions comme `len()` que vous pouvez exécuter en Python ? Et bien, bonne nouvelle : vous allez apprendre à écrire vos propres fonctions!
+
+Une fonction est un ensemble d'instructions que Python va exécuter. Chaque fonction en Python commence par le mot-clef `def`. On lui donne un nom, et elle peut avoir des paramètres. Essayons ! Remplacer le code de **python_intro.py** par ceci :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Voilà, notre première fonction est prête !
+
+Vous vous demandez peut-être pourquoi nous avons écrit le nom de la fonction à la fin du fichier. Quand nous écrivons `def hi():` et les lignes indentées qui suivent, nous écrivons les instructions disant ce que la fonction `hi` doit faire. Python va lire et mémoriser ces instructions, mais ne va pas exécuter la fonction tout de suite. Pour dire à Python que nous voulons exécuter la fonction, nous devons appeler la fonction avec `hi()`. Python lit le fichier et l’exécute de haut en bas, donc nous devons définir la fonction dans le fichier avant de l’appeler.
+
+Lançons notre code pour voir ce qui se passe :
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note : si cela n'a pas fonctionné, ne paniquez pas ! Le message d'erreur vous aidera à comprendre pourquoi :
+
+- Si vous obtenez un `NameError`, cela est du probablement à une faute de frappe, donc vous devriez vérifier d'avoir utilisé le même nom lors de la création de la fonction avec `def hi():` et lors de l'appel avec `hi()`.
+- Si vous obtenez un `IndentationError`, vérifiez que les deux `print` sont à la même distance du début de leur ligne: python veut que tout le code à l'intérieur de la fonction soit bien aligné.
+- Si vous n'obtenez rien du tout, vérifiez que le `hi()` à la fin *n'est pas indenté*. Si c'est le cas, cette ligne est considérée par Python comme faisant partie de la fonction, et elle ne sera donc jamais exécutée.
+
+Construisons maintenant notre première fonction avec des paramètres. Dans l'exemple précédent, nous avions une fonction que disait "Hi there!" à la personne qui la lançait. Faisons une fonction identique, mais ajoutons un nom cette fois-ci :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+Comme vous le voyez, nous avons donné à notre fonction un paramètre appelé `name` :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Rappelez-vous : la fonction `print` est indentée de quatre espaces dans le bloc `if`, car elle est exécutée uniquement quand la condition est remplie. Voyons comment ça marche :
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oups, une erreur. Heureusement, Python nous donne un message d'erreur assez utile. Il nous dit que la fonction `hi()` (celle que nous avons définie) a besoin d'un argument (que nous avons appelé `name`). Nous avons oublié de passer cet argument lorsque nous avons appelé notre fonction. Corrigeons la dernière ligne du fichier :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+Et exécutez votre code à nouveau :
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+Et que se passe-t-il quand on change de nom ?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+Exécutez votre code à nouveau :
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Maintenant, que pensez-vous qu'il se passera lorsque nous écrivrons un autre nom (ni Ola, ni Sonja) ? Faites un essai et regardez si vous avez raison. Ceci devrait s'afficher :
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+Super, non ? Avec ça, vous n'avez pas besoin de répéter de lignes de code lorsque vous voulez changer le nom de la personne à saluer. C'est pour cette raison que nous avons besoin de fonctions : vous ne voulez pas avoir à répéter votre code !
+
+Faisons quelque chose de plus intelligent – il existe bien plus que deux noms, et écrire une condition pour chacun d'entre eux serait difficile, non ? Remplacez le contenu de votre fichier avec les suivants :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Exécutons à nouveau notre code :
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Félicitations ! Vous venez juste d’apprendre à écrire des fonctions ! :)
+
+## Les boucles
+
+> Pour les lectrices autodidactes : cette partie est traitée dans la vidéo [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0).
+
+C’est déjà la dernière partie. C’était rapide, non ? :)
+
+Les programmeurs⋅euses n'aiment pas devoir se répéter. L'essence de la programmation est d'automatiser les choses. Pour reprendre l'exemple précédent, nous aimerions pouvoir saluer automatiquement chaque personne. Pour cela, nous allons utiliser des boucles.
+
+Vous vous souvenez des listes ? Faisons une liste de filles :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+Nous voulons saluer chacune d'entre elles par son nom. Nous avons déjà la fonction `hi` pour faire ça, utilisons-la donc dans une boucle :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+L'instruction `for` se comporte un peu comme `if`. Le code qui suit doit donc être indenté de quatre espaces.
+
+Voilà le code complet à mettre dans votre fichier :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+Exécutez votre code :
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+Comme vous pouvez le constater, tout ce que vous mettez dans la déclaration `for` avec une indentation sera répété pour chaque élément de la liste `filles`.
+
+Vous pouvez aussi utiliser `for` sur des nombres grâce à la fonction `range`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Cela va afficher :
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` est une fonction qui crée une liste de nombres qui se suivent (c'est vous qui définissez l’intervalle à l'aide de paramètres).
+
+Vous pouvez remarquer que le second de ces nombres n'est pas inclus dans la liste que Python nous donne (ce qui signifie que `range(1, 6)` compte de 1 à 5, mais n'inclue pas 6). Cela est du au fait que "range" est semi-ouvert, c'est-à-dire qu'il prend en compte la première valeur mais pas la dernière.
+
+## Résumé
+
+Et voilà ! **Vos assurez un max !** C'était un chapitre difficile, donc vous pouvez être fières de vous. De notre côté, nous sommes fières de vous, pour être parvenu-e si loin dans le cours. Bravo !
+
+Pour accéder au tutoriel officiel et complet de Python, visitez https://docs.python.org/3/tutorial/. Cela vous donnera un accès plus exhaustif à l'étude du langage. A bientôt! :)
+
+N'hésitez pas à prendre une pause : étirez-vous, marchez un peu ou reposez-vous les yeux. Une fois que vous avez un peu rechargé vos batteries, vous pouvez attaquer le chapitre suivant :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/fr-FR/template_extending/README.md b/fr-FR/template_extending/README.md
new file mode 100644
index 00000000000..909b525e6df
--- /dev/null
+++ b/fr-FR/template_extending/README.md
@@ -0,0 +1,151 @@
+# Héritage de template
+
+Django vous réserve encore bien des surprises : une assez géniale est **l'héritage de template**. Qu'est ce que ça signifie ? C'est une fonctionnalité qui vous permet de réutiliser certains morceaux de HTML dans différentes pages de votre site web.
+
+Les modèles permettent d'utiliser les mêmes informations ou mises en page en plusieurs endroits. Vous n'avez pas à vous répéter dans chaque fichier. Et si vous voulez changer quelque chose, vous n'avez pas à le faire dans chaque modèle, mais juste un!
+
+## Créer un template de base
+
+Un template de base est le template le plus simple que vous pouvez faire hériter à chaque page de votre site web.
+
+Créons le fichier `base.html` dans le dossier `blog/templates/blog/` :
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Ensuite, ouvrez ce fichier dans l'éditeur de code et collez-y tout ce qui se trouve dans le fichier `post_list.html`. Ça devrait ressembler à ça :
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Puis, dans le fichier `base.html`, remplacez tout ce qui se trouve dans `<body>` (de `<body>` à `</body>`) par ceci :
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Vous pouvez remarquer qu'on vient de remplacer tout ce qui était entre `{% for post in posts %}` et `{% endfor %}` avec : {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Mais pourquoi? Vous venez de créer un `block` ! Vous avez utilisé la balise de modèle `{% block %}` pour créer une partie qui va contenir du HTML. Ce HTML viendra d'un autre modèle qui étendra ce modèle-ci (`base.html`). Nous vous expliquerons comment faire cela dans un instant.
+
+Enregistrez `base.html` et ouvrez votre `blog/templates/blog/post_list.html` à nouveau dans l'éditeur de code. {% raw %}Vous allez tout supprimer au-dessus de `{% for post in posts %}` et en dessous de `{% endfor %}`. Lorsque vous avez terminé, le fichier ressemblera à ceci :{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Nous voulons utiliser ceci dans le cadre de notre modèle pour tous les blocs 'content'. Il est temps d'ajouter ajouter des balises block à ce fichier !
+
+{% raw %}Vous voulez que votre balise block corresponde à la balise dans votre fichier `base.html` . Vous voulez aussi qu'il inclue tout le code qui appartient à vos blocs de contenu. Pour faire cela, entourez tout le code de `{% block content %}` et `{% endblock %}`. Comme ceci :{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Seule une chose reste à faire. Nous devons connecter ces deux modèles ensemble. C'est ça, étendre des modèles ! Nous allons le faire en ajoutant une balise 'extends' au début du fichier. Comme cela :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Et voilà ! Enregistrez le fichier et vérifiez que votre site fonctionne toujours correctement. :)
+
+> Si vous obtenez l'erreur `TemplateDoesNotExist`, cela signifie qu'il n'y a pas de fichier `blog/base.html` et que vous avez `runserver` en cours d'exécution dans la console. Arrêtez-le (en appuyant simultanément sur Ctrl+C, les touches Control et C de votre clavier) et relancez-le en tapant la commande `python manage.py runserver`.
\ No newline at end of file
diff --git a/fr-FR/whats_next/README.md b/fr-FR/whats_next/README.md
new file mode 100644
index 00000000000..0437a65605c
--- /dev/null
+++ b/fr-FR/whats_next/README.md
@@ -0,0 +1,43 @@
+# Et maintenant ?
+
+Un immense bravo à vous ! **Vous êtes très déterminée**. Nous sommes fières ! <3
+
+### Que faire maintenant ?
+
+Faites une pause et détendez-vous ! Vous venez d'accomplir quelque chose de conséquent.
+
+Ensuite, suivez Django Girls sur [Facebook](http://facebook.com/djangogirls) ou [Twitter](https://twitter.com/djangogirls) pour être au courant des nouvelles.
+
+### À la recherche de ressources supplémentaires ?
+
+Oui ! Il y a *énormément* de ressources en ligne pour apprendre toutes sortes de compétences de programmation. Il peut être assez difficile de s'orienter et aller plus loin, mais nous vous donnons des pistes pour démarrer. Quelle que soit la raison qui vous a menée à participer à Django Girls, et quels que soient les intérêts que vous avez développés en suivant le tutoriel, voici quelques ressources gratuites (ou des ressources avec de grands composants gratuits) que vous pouvez utiliser pour atteindre vos objectifs.
+
+#### Django
+
+- Notre autre livre, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Tutoriel officiel de Django](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Vidéos Getting Started With Django](http://www.gettingstartedwithdjango.com/)
+- [La spécialisation Python de Coursera](https://www.coursera.org/specializations/django) – vous pouvez accéder gratuitement à certains cours et vous pouvez obtenir un certificat Coursera à la fin
+
+#### HTML, CSS et JavaScript
+
+- [Cours de développement web de la Codecademy](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Cours Python de la Codecademy](https://www.codecademy.com/learn/learn-python)
+- [Cours Python de Google](https://developers.google.com/edu/python/)
+- Le livre [Learn Python The Hard Way](http://learnpythonthehardway.org/book/) – les premiers exercices sont gratuits
+- [New Coder tutorials](http://newcoder.io/tutorials/) – c'est une série d'exemples pratiques illustrant comment Python peut vous servir
+- [edX](https://www.edx.org/course?search_query=python) – vous pouvez accéder à la plupart des cours gratuitement, mais si vous voulez un certificat ou des crédits pour une qualification supérieure, cela coûtera de l'argent
+- [La spécialisation Python de Coursera](https://www.coursera.org/specializations/python) – vous pouvez accéder gratuitement à certains cours et vous pouvez obtenir un certificat à la fin
+- [Python for Everybody](https://www.py4e.com/) – une version gratuite et ouverte de la spécialisation de Coursera "Python for Everybody"
+
+#### Travailler avec les données
+
+- [Cours de science des données de la Codecademy](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – vous pouvez accéder à la plupart des cours gratuitement, mais si vous voulez un certificat ou des crédits pour une qualification supérieure, cela coûtera de l'argent
+- [Dataquest](https://www.dataquest.io/) – les 30 premières « missions » sont gratuites
+
+On a hâte de voir votre prochaine création !
\ No newline at end of file
diff --git a/fr/GLOSSARY.md b/fr/GLOSSARY.md
index 17c69c4d382..48cb7aaa0d3 100644
--- a/fr/GLOSSARY.md
+++ b/fr/GLOSSARY.md
@@ -1,3 +1,3 @@
 # Éditeur de texte
 
-L'éditeur de texte est une application qui permet d'écrire et d'enregistrer du code que vous pourrez ré-utiliser plus tard. Vous pouvez apprendre comment s'en procurer un grâce au chapitre [Éditeur de Texte](./code_editor/README.md)
+L'éditeur de texte est une application qui permet d'écrire et enregistrer du code que vous pourrez ré-utiliser plus tard. Vous pouvez apprendre comment s'en procurer un grâce au chapitre [Éditeur de Texte](./code_editor/README.md)
\ No newline at end of file
diff --git a/fr/README.md b/fr/README.md
index f45ef9780cd..fa8bd482a34 100755
--- a/fr/README.md
+++ b/fr/README.md
@@ -1,52 +1,51 @@
 # Tutoriel de Django Girls
 
-[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
 
-> Cette œuvre est mise à disposition selon les termes de la Licence Creative Commons Attribution-ShareAlike 4.0 International. Pour obtenir une copie de cette licence, visitez https://creativecommons.org/licenses/by-sa/4.0/
+> Cette œuvre est mise à disposition selon les termes de la Licence Creative Commons Attribution — Partage dans les Mêmes Conditions 4.0 International. Pour obtenir une copie de cette licence, visitez https://creativecommons.org/licenses/by-sa/4.0/deed.fr
 
-## Translation
+## Bienvenue
 
-This tutorial has been translated from English to French by a group of awesome volunteers. Special thanks for help go to Lucie Daeye, Georges Dubus, Emmanuelle Delescolle, Leila, MadCath, Mélanie Chauvel and Sebastien Barbier. <3 <3
+Bienvenue dans le tutoriel Django Girls ! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
 
 ## Introduction
 
-Avez-vous déjà eu l'impression que la technologie prend une place de plus en plus importante, mais que vous êtes en quelque sorte laissée à la traine ? Avez-vous déjà été curieuse de comment créer un site web, sans jamais avoir le courage de vous plonger dedans ? Vous êtes-vous déjà dit que le monde du logiciel est trop compliqué pour savoir ne serait-ce que par où l'attaquer ?
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Avez-vous déjà été curieuse de comment créer un site web, sans jamais avoir le courage de vous plonger dedans ? Vous êtes-vous déjà dit que le monde du logiciel est trop compliqué pour savoir ne serait-ce que par où l'attaquer ?
 
 Hé bien, bonne nouvelle ! Programmer n'est pas aussi dur que ça en a l'air, et nous sommes là pour vous montrer à quel point ça peut être amusant.
 
-Ce tutoriel ne va pas vous transformer en programmeuse du jour au lendemain. Devenir vraiment bonne peut prendre des mois, voire même des années d'apprentissage et de pratique. Mais nous voulons vous montrer que programmer ou créer des sites web n'est pas aussi compliqué que ça en ait l'air. Nous allons essayer de vous expliquer différents morceaux afin de rendre la technologie moins intimidante.
+Ce tutoriel ne vous transformera pas magiquement en programmeuse. Devenir vraiment bonne peut prendre des mois, voire même des années d'apprentissage et de pratique. Mais nous voulons vous montrer que programmer ou créer des sites web n'est pas aussi compliqué que ça en a l'air. Nous allons essayer de vous expliquer différents morceaux afin de rendre la technologie moins intimidante.
 
 Nous espérons arriver à vous faire aimer la technologie autant que nous l'aimons !
 
 ## Qu'apprendrez-vous au cours de ce tutoriel ?
 
-À la fin de ce tutoriel, vous aurez une application toute simple et pleinement fonctionnelle : votre propre blog. Nous allons vous montrer comment le mettre en ligne afin de pouvoir montrer le résultat à d'autres personnes !
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
 
 Ça devrait ressembler plus ou moins à ça :
 
-![Figure 0.1][2]
+![Figure 0.1](images/application.png)
 
- [2]: images/application.png
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Nous avons demandé aux coachs et participant·e·s des précédentes éditions de passer de temps en temps pour aider les autres avec le tutoriel. N'aillez pas peur et allez poser vos questions !
 
-> Si vous travaillez sur ce tutoriel dans votre coin et que vous n'avez pas de coach pour vous aider, venez sur le chat : [![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) en cas de problème. Nous avons demandé aux coachs et participant·e·s des précédentes éditions de passer de temps en temps pour aider les autres avec le tutoriel. N'aillez pas peur et allez poser vos questions !
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
 
-Alors, [commençons par le commencement...][3]
+## Suivre le tutoriel chez soi
 
- [3]: how_the_internet_works/README.md
+Il est formidable de participer à un atelier Django Girls, mais nous comprenons qu'il n'est pas toujours facile d'en trouver un. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
 
-## À propos et contributions
+Dans chaque chapitre couvert se trouve un lien pointant vers la vidéo correspondante.
 
-Ce tutoriel est maintenu par [DjangoGirls][4]. Si vous rencontrez des erreurs ou souhaitez simplement suggérer une amélioration du tutoriel, il est important de respecter [les règles de contribution][5].
+## À propos et contributions
 
- [4]: https://djangogirls.org/
- [5]: https://github.com/DjangoGirls/tutorial/blob/master/README.md
+Ce tutoriel est maintenu par [DjangoGirls](https://djangogirls.org/). Si vous rencontrez des erreurs ou souhaitez simplement suggérer une amélioration du tutoriel, il est important de respecter [les règles de contribution](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
 
-## Voulez-vous nous aider à traduire le tutoriel dans d'autres langues ?
+## Would you like to help us translate the tutorial into other languages?
 
-Pour l'instant, les traductions sont stockées sur la plate-forme crowdin.com dans :
+Currently, translations are being kept on crowdin.com platform at:
 
 https://crowdin.com/project/django-girls-tutorial
 
-Si votre langue n'est pas sur crowdin, veuillez [ouvrir un ticket][6] avec la langue, pour que nous puissions l'ajouter.
-
- [6]: https://github.com/DjangoGirls/tutorial/issues/new
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/fr/SUMMARY.md b/fr/SUMMARY.md
index 4eabc020e6f..c2f1697e220 100755
--- a/fr/SUMMARY.md
+++ b/fr/SUMMARY.md
@@ -1,26 +1,27 @@
 # Résumé
 
-*   [Introduction](README.md)
-*   [Installation](installation/README.md)
-*   [Comment fonctionne l'Internet ?](how_the_internet_works/README.md)
-*   [Introduction à l'interface en ligne de commande](intro_to_command_line/README.md)
-*   [Installation de Python](python_installation/README.md)
-*   [L'éditeur de texte](code_editor/README.md)
-*   [Introduction à Python](python_introduction/README.md)
-*   [Qu'est-ce que Django?](django/README.md)
-*   [Installation de Django](django_installation/README.md)
-*   [Votre premier projet Django !](django_start_project/README.md)
-*   [Les modèles dans Django](django_models/README.md)
-*   [Django admin](django_admin/README.md)
-*   [Déployer !](deploy/README.md)
-*   [Les urls Django](django_urls/README.md)
-*   [Créons nos vues Django!](django_views/README.md)
-*   [Introduction au HTML](html/README.md)
-*   [Django ORM (Querysets)](django_orm/README.md)
-*   [Données dynamiques dans les templates](dynamic_data_in_templates/README.md)
-*   [Templates Django](django_templates/README.md)
-*   [CSS - Rendez votre site joli](css/README.md)
-*   [Héritage de template](template_extending/README.md)
-*   [Finaliser votre application](extend_your_application/README.md)
-*   [Formulaires Django](django_forms/README.md)
-*   [La suite ?](whats_next/README.md) 
\ No newline at end of file
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [Comment marche l'Internet](how_the_internet_works/README.md)
+* [Introduction à l'interface en ligne de commande](intro_to_command_line/README.md)
+* [Installation de Python](python_installation/README.md)
+* [L'éditeur de texte](code_editor/README.md)
+* [Introduction à Python](python_introduction/README.md)
+* [Qu'est-ce que Django?](django/README.md)
+* [Installation de Django](django_installation/README.md)
+* [Votre premier projet Django !](django_start_project/README.md)
+* [Les modèles dans Django](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Déployer!](deploy/README.md)
+* [Les urls Django](django_urls/README.md)
+* [Vues Django - C'est l'heure de créer !](django_views/README.md)
+* [Introduction au HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Données dynamiques dans les templates](dynamic_data_in_templates/README.md)
+* [Templates Django](django_templates/README.md)
+* [CSS - Rendez votre site joli](css/README.md)
+* [Héritage de template](template_extending/README.md)
+* [Finaliser votre application](extend_your_application/README.md)
+* [Formulaires Django](django_forms/README.md)
+* [La suite?](whats_next/README.md)
\ No newline at end of file
diff --git a/fr/chromebook_setup/README.md b/fr/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/fr/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/fr/chromebook_setup/instructions.md b/fr/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..02f8e89ae54
--- /dev/null
+++ b/fr/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+Vous pouvez [passer cette section](http://tutorial.djangogirls.org/en/installation/#install-python) si vous n'utilisez pas un Chromebook. Si c'est le cas, votre expérience sera un peu différente. Vous pouvez ignorer le reste des instructions d'installation.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. Pour la durée du tutoriel, Cloud 9 agira comme votre *machine locale*. Vous lancerez toujours des commandes dans un terminal exactement comme vos camarades sous OS X, Ubuntu ou Windows, mais votre terminal sera connecté à un ordinateur autre part que Cloud 9 a configuré pour vous.
+
+1. Installez Cloud 9 depuis le [Chrome Web Store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Allez à [c9.io](https://c9.io)
+3. Créez un compte
+4. Click *Create a New Workspace*
+5. Appelez-le *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Environnement virtuel
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Créez un compte [Github](https://github.com).
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/fr/code_editor/README.md b/fr/code_editor/README.md
index b149081182d..496838b87a5 100755
--- a/fr/code_editor/README.md
+++ b/fr/code_editor/README.md
@@ -1,7 +1,11 @@
 # L'éditeur de texte
 
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
 Vous allez bientôt écrire vos premières lignes de code : Il vous faut tout d'abord télécharger un éditeur de texte !
 
-> **Note** : Vous l'avez peut-être déjà fait dans le chapitre d'installation. Si c'est le cas, passez directement au prochain chapitre!
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
 
 {% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/fr/code_editor/instructions.md b/fr/code_editor/instructions.md
index d5649f6293b..14aeb7ce91d 100644
--- a/fr/code_editor/instructions.md
+++ b/fr/code_editor/instructions.md
@@ -1,6 +1,6 @@
 Choisir un éditeur de texte parmi tous ceux qui sont disponibles est surtout une histoire de goûts personnels. La plupart des programmeurs·ses Python utilisent des IDE (Environnements de développement intégrés) complexes mais très puissants, comme Pycharm par exemple. Ce n'est pas forcément le meilleur choix pour débuter : ceux que nous vous recommandons sont tout aussi puissants, mais beaucoup plus simples à utiliser.
 
-Vous pouvez choisir l'un des éditeurs de la liste ci-dessous, mais n'hésitez pas à demander à votre coach l'éditeur qu'il·elle préfère.
+Nos suggestions sont listées ci-dessous, mais n'hésitez pas à demander à vos coachs quelles sont ses préférences - il sera plus facile d'obtenir de l'aide de leur part.
 
 ## Gedit
 
@@ -10,13 +10,13 @@ Gedit est un éditeur libre et gratuit disponible pour tout les systèmes d'expl
 
 ## Sublime Text 3
 
-Sublime text est un éditeur très populaire : il est disponible gratuitement sous forme de version d'évaluation pour tout les systèmes d'exploitation. Il est facile à installer et à utiliser.
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
 
 [Télécharger](https://www.sublimetext.com/3)
 
 ## Atom
 
-Atom est un éditeur très récent créé par [GitHub](https://github.com/). Disponible pour tout les systèmes d'exploitation, il est libre, gratuit, facile à installer et à utiliser.
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
 
 [Télécharger](https://atom.io/)
 
@@ -24,8 +24,8 @@ Atom est un éditeur très récent créé par [GitHub](https://github.com/). Dis
 
 Vous vous demandez sûrement pourquoi nous vous faisons installer un éditeur spécialement créé pour écrire du code. Pourquoi ne pourrions nous pas simplement utiliser un éditeur de texte comme Word ou Notepad ?
 
-La première raison est que votre code doit être écrit en **texte brut**. Le problème avec les applications comme Word ou Textedit, c'est qu'elles ne produisent pas du texte brut mais du texte enrichi (avec des polices et de la mise en page), basé sur un standard comme [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
 
-La seconde raison est que les éditeurs de texte dédiés à la programmation contiennent de nombreuses fonctions très utiles. Ils peuvent colorer le texte en fonction du sens de celui-ci (coloration syntaxique) ou ajouter automatiquement un guillemet fermant à chaque fois que vous ouvrez un guillemet.
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
 
-Vous allez bientôt vous rendre compte à quel point un logiciel dédié à la programmation peut être pratique ! Prenez un peu de temps pour trouver l'éditeur qui vous convient, car il deviendra rapidement l'un de vos outils préférés :)
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/fr/css/README.md b/fr/css/README.md
index 31e3302fa4b..a75f2ca9dca 100755
--- a/fr/css/README.md
+++ b/fr/css/README.md
@@ -1,112 +1,115 @@
-# CSS - Rendez votre site joli !
+# CSS – make it pretty!
 
 Soyons honnêtes : notre blog est plutôt moche, non ? Un peu de CSS devrait nous permettre d'arranger ça !
 
 ## Qu'est-ce que le CSS ?
 
-Les feuilles de style, ou Cascading Style Sheets (CSS), sont un langage informatique utilisé pour décrire l'apparence et le formatage d'un document écrit en langage markup (ex : HTML). Pour faire simple : des produits cosmétiques pour pages web ;)
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
 
-Je suppose que vous n'avez pas particulièrement envie de partir de rien et de devoir tout construire vous-même. Pour éviter cela, nous allons une nouvelle fois utiliser différentes ressources créées et mises à disposition gratuitement sur Internet par d'autres développeurs·ses. Réinventer à chaque fois la roue n'est pas vraiment fun, en plus, c'est absolument inutile.
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
 
 ## Utilisons Bootstrap !
 
-Bootsrap est l'un des frameworks HTML et CSS les plus populaires. Il est utilisé pour créer de très beaux sites web : https://getbootstrap.com/
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
 
-Il a été créé par d'anciens programmeurs·ses de chez Twitter et est maintenant développé par des bénévoles aux quatre coins du monde.
+Il a été créé par d'anciens programmeurs·ses de chez Twitter. Il est maintenant développé par des bénévoles aux quatre coins du monde !
 
 ## Installer Bootstrap
 
-Pour installer Bootstrap, vous avez besoin d'ajouter ceci dans le `<head>` de votre fichier `.html` (`blog/templates/blog/post_list.html`) :
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
 ```
 
-En faisant ceci, vous n'ajoutez aucun nouveau fichier à votre projet : vous reliez simplement des fichiers hébergés sur Internet à votre projet. Essayez maintenant de rafraichir votre page. Et voilà !
-
-![Figure 14.1][1]
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
 
- [1]: images/bootstrap1.png
+![Figure 14.1](images/bootstrap1.png)
 
 C'est déjà un peu mieux !
 
 ## Les fichiers statiques dans Django
 
-Enfin, allons jeter un coup d'œil à ces **fichiers statiques** dont nous n'arrêtons pas de vous parler. Votre CSS et vos images sont des fichiers statiques et non dynamiques. Cela signifie que leur contenu ne dépend pas du contexte de la requête et qu'il sera donc identique pour chaque utilisateur.
+Enfin, allons jeter un coup d'œil à ces **fichiers statiques** dont nous n'arrêtons pas de vous parler. Les fichiers statiques correspondent à tous vos CSS et vos images. Leur contenu ne dépend pas du contexte de la requête et sera le même pour tous les utilisateurs.
 
 ### Où ranger les fichiers statiques dans Django ?
 
-Comme vous l'avez probablement remarqué lorsque nous avons exécuté la commande `collectstatic` sur le serveur, Django sait déjà où trouver les fichiers statiques pour la partie "admin". Maintenant, il ne nous reste plus qu'à ajouter les fichiers statiques liés à notre app `blog`.
+Django sait déjà où trouver les fichiers statiques pour la partie « admin ». Maintenant, il ne nous reste plus qu'à ajouter les fichiers statiques liés à notre app `blog`.
 
-Pour cela, nous allons créer un dossier appelé `static` à l'intérieur de notre blog app :
+Pour cela, nous allons créer un fichier appelé `static` à l'intérieur de notre blog app :
 
     djangogirls
     ├── blog
     │   ├── migrations
-    │   └── static
+    │   ├── static
+    │   └── templates
     └── mysite
+    
 
-
-Django est capable de détecter automatiquement tout les dossiers appelés "static" dans l'arborescence de votre app. Il sera ainsi capable d'utiliser les fichiers présents à l'intérieur de ces dossiers comme des fichiers statiques.
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
 
 ## Votre première CSS !
 
-Nous allons créer un fichier CSS afin de personnaliser notre page web. Créez un nouveau dossier appelé `css` à l'intérieur de votre dossier `static`. Ensuite, créez un nouveau fichier appelé `blog.css` à l'intérieur du dossier `css`. Vous êtes prête ?
+Let's create a CSS file now, to add your own style to your web page. Créez un nouveau dossier appelé `css` à l'intérieur de votre dossier `static`. Ensuite, créez un nouveau fichier appelé `blog.css` à l'intérieur du dossier `css`. Vous êtes prête ?
 
     djangogirls
     └─── blog
          └─── static
               └─── css
                    └─── blog.css
-
+    
 
 Et c'est parti pour un peu de CSS ! Ouvrez le fichier `static/css/blog.css` dans votre éditeur de texte.
 
-Nous n'allons pas trop nous attarder sur les CSS aujourd'hui. Nous vous invitons, une fois rentrée chez vous, à vous plonger dans d'autres tutoriels de CSS. Vous verrez, c'est assez simple à comprendre ! Vous pouvez par exemple consulter le cours [Codeacademy HTML & CSS course][2] qui est une excellente ressource et qui vous permettra d'en apprendre plus sur la personnalisation de site web à l'aide de CSS.
-
- [2]: https://www.codecademy.com/tracks/web
-
-Que pourrions-nous faire rapidement ? Pourquoi ne pas changer la couleur de notre entête ? Pour indiquer la couleur que nous souhaitons utiliser, nous devons utiliser un code particulier. Ces codes commencent par `#` et sont suivis de 6 lettres (A-F) et chiffres (0-9). Afin de trouver le code associé à la couleur de votre choix, vous pouvez consulter le site http://www.colorpicker.com/. Vous pouvez aussi utiliser des [couleurs prédéfinies][3], comme `red` ou `green`.
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
 
- [3]: http://www.w3schools.com/cssref/css_colornames.asp
+Que pourrions-nous faire rapidement ? Pourquoi ne pas changer la couleur de notre en-tête ? Pour indiquer la couleur que nous souhaitons utiliser, nous devons utiliser un code particulier. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. Vous pouvez aussi utiliser des [couleurs prédéfinies](http://www.w3schools.com/colors/colors_names.asp), comme le `rouge` et le `vert`.
 
 Ajoutez le code suivant dans votre fichier `blog/static/css/blog.css` :
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 h1 a {
     color: #FCA205;
 }
-```  
+```
 
-`h1 a` est un sélecteur CSS. Cela signifie que nous appliquons ce style pour chaque élément `a` présent à l'intérieur d'un élément `h1` (ce qui est le cas de `<h1><a href="">link</a></h1>`). Dans notre exemple précédent, nous indiquions notre souhait de changer la couleur du texte en `#FCA205`, c'est à dire en orange. Bien évidemment, vous êtes libre de choisir n'importe quelle couleur !
+`h1 a` est un sélecteur CSS. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. Dans notre exemple précédent, nous indiquions notre souhait de changer la couleur du texte en `#FCA205`, c'est à dire en orange. Bien évidemment, vous êtes libre de choisir n'importe quelle couleur !
 
-Un fichier CSS permet de déterminer le style des éléments présents dans un fichier HTML. Les différents éléments sont identifiés par leur nom (`a`, `h1`, `body`), l’attribut `class` ou l’attribut `id`. Class et id sont des noms que vous choisissez vous-même. Les classes définissent des groupes d'éléments tandis que les ids désignent des éléments précis. Par exemple, l'élément suivant peut être identifié par CSS à la fois par son nom `a`, sa classe `external_link`, ou son identifiant `link_to_wiki_page` :
+Un fichier CSS permet de déterminer le style des éléments présents dans un fichier HTML. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class et id sont des noms que vous choisissez vous-même. Les classes définissent des groupes d'éléments tandis que les ids désignent des éléments précis. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
 
 ```html
 <a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
 ```
 
-Nous vous conseillons d'en apprendre un peu plus sur les sélecteurs CSS sur [w3schools][4].
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
 
- [4]: http://www.w3schools.com/cssref/css_selectors.asp
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
 
-Afin que nos modifications fonctionnent, nous devons aussi signaler à notre template HTML que nous utilisons des CSS. Ouvrez le fichier `blog/templates/blog/post_list.html` et ajoutez cette ligne au tout début de celui-ci :
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
 ```
 
-Hop, nous chargeons les fichiers statiques :). Pour l'ajout de code suivant, gardez en tête que le navigateur lit vos fichiers dans l'ordre dans lequel ils lui sont donnés : en le plaçant à l'endroit que nous vous indiquons, vous allez pouvoir remplacer du code provenant des fichiers Boostrap par le vôtre. Donc, entre le `<head>` et le `</head>` et après les liens vers les fichiers CSS de Boostrap, ajoutez ceci :
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <link rel="stylesheet" href="{% static 'css/blog.css' %}">
 ```
 
-Nous venons simplement de dire à notre template où nous avons rangé notre fichier CSS.
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. Nous venons simplement de dire à notre template où nous avons rangé notre fichier CSS.
 
 Maintenant, votre fichier doit ressembler à ceci :
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -132,35 +135,37 @@ Maintenant, votre fichier doit ressembler à ceci :
 </html>
 ```
 
-Ok, on sauvegarde et on rafraichit la page !
-
-![Figure 14.2][5]
+Ok, on sauvegarde et on rafraîchit la page !
 
- [5]: images/color2.png
+![Figure 14.2](images/color2.png)
 
 Bravo ! Peut-être que nous pourrions un peu aérer notre page web en augmentant la marge du côté gauche ? Essayons pour voir !
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 body {
     padding-left: 15px;
 }
 ```
 
-Ajoutez ceci à votre fichier CSS, sauvegardez-le et voyons le résultat !
+Add that to your CSS, save the file and see how it works!
 
-![Figure 14.3][6]
-
- [6]: images/margin2.png
+![Figure 14.3](images/margin2.png)
 
 Et si nous changions aussi la police de caractères de notre entête ? Collez ceci dans la partie `<head>` de votre fichier `blog/templates/blog/post_list.html` :
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
-<link href="https://fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
 ```
 
-Cette ligne nous permet d'importer la police de caractères *Lobster* depuis Google Fonts (https://www.google.com/fonts).
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
 
-Maintenant, ajoutons `font-family: 'Lobster';` à l'intérieur du bloc déclaratif `h1 a` dans le fichier CSS `blog/static/css/blog.css`. Le bloc déclaratif est le code situé à l'intérieur des accolades `{` et `}`. N'oubliez pas ensuite de rafraichir la page.
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 h1 a {
@@ -169,24 +174,26 @@ h1 a {
 }
 ```
 
-![Figure 14.3][7]
-
- [7]: images/font.png
+![Figure 14.3](images/font.png)
 
 Super !
 
-Comme nous l'avions mentionné précédemment, il existe une notion de classe dans CSS. En gros, cela vous permet de donner un nom à un morceau de code HTML auquel vous souhaitez appliquer un style particulier sans que cela ne concerne le reste du code. C'est particulièrement pratique lorsque vous avez deux divs qui font quelque chose de différent (par exemple, votre entête et votre post) et que vous ne voulez pas qu'ils soient identiques.
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
 
 Allons donner des noms à certaines parties de notre code html. Ajouter la classe `page-header` à votre `div` qui contient votre entête. Votre fichier doit ressembler maintenant à ceci :
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="page-header">
     <h1><a href="/">Django Girls Blog</a></h1>
 </div>
- ```
+```
 
 Maintenant, ajoutez la classe `post` à votre `div` contenant votre blog post.
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="post">
     <p>published: {{ post.published_date }}</p>
@@ -195,7 +202,9 @@ Maintenant, ajoutez la classe `post` à votre `div` contenant votre blog post.
 </div>
 ```
 
-Nous allons maintenant ajouter des blocs déclaratifs à différents sélecteurs. Les sélecteurs qui commencent par `.` sont reliés aux classes. Le net regorge de bons tutoriels sur CSS qui vous permettront de comprendre le code que nous allons rajouter à notre fichier. Pour l'instant, copier-coller le code qui suit dans votre fichier `blog/static/css/blog.css` :
+Nous allons maintenant ajouter des blocs déclaratifs à différents sélecteurs. Les sélecteurs qui commencent par `.` sont reliés aux classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. Pour l'instant, copier-coller le code qui suit dans votre fichier `blog/static/css/blog.css` :
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 .page-header {
@@ -219,7 +228,6 @@ h1, h2, h3, h4 {
 }
 
 .date {
-    float: right;
     color: #828282;
 }
 
@@ -247,7 +255,9 @@ h1, h2, h3, h4 {
 }
 ```
 
-Nous allons maintenant nous intéresser au code concernant les posts. Il va falloir remplacer le code suivant :
+Nous allons maintenant nous intéresser au code concernant les posts. Il va falloir remplacer le code le code suivant :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
@@ -261,6 +271,8 @@ Nous allons maintenant nous intéresser au code concernant les posts. Il va fall
 
 Ce code se trouve dans le fichier `blog/templates/blog/post_list.html`. Il doit être remplacé par le code suivant :
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="content container">
     <div class="row">
@@ -268,7 +280,7 @@ Ce code se trouve dans le fichier `blog/templates/blog/post_list.html`. Il doit
             {% for post in posts %}
                 <div class="post">
                     <div class="date">
-                        {{ post.published_date }}
+                        <p>published: {{ post.published_date }}</p>
                     </div>
                     <h1><a href="">{{ post.title }}</a></h1>
                     <p>{{ post.text|linebreaksbr }}</p>
@@ -279,16 +291,14 @@ Ce code se trouve dans le fichier `blog/templates/blog/post_list.html`. Il doit
 </div>
 ```
 
-Sauvegardez les fichiers modifiés et rafraichissez votre site web.
-
-![Figure 14.4][8]
+Sauvegardez les fichiers modifiés et rafraîchissez votre site web.
 
- [8]: images/final.png
+![Figure 14.4](images/final.png)
 
-Woohoo ! C'est pas mal, non ? Le code que nous avons collé n'est pas bien compliqué à comprendre et vous devriez pouvoir en saisir l'essentiel rien qu'en le lisant (ce n'est pas grave si ce n'est pas le cas ! ).
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
 
-N'ayez pas peur et jouez un peu avec la CSS : essayez par exemple d'en changer des morceaux. Vous avez cassé quelque chose ? Pas de problème : vous pouvez toujours annuler vos modifications !
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
 
-Voilà pour la partie CSS. Nous vous encourageons vivement à suivre le tutoriel gratuit de [Code Academy][2] : considérez ce tutoriel comme un petit travail à faire une fois rentrée chez vous. Vous connaitrez ainsi tout ce qu'il y a à savoir pour rendre son site bien plus joli !
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
 
-Prête pour le chapitre suivant ? :)
+Prête pour le chapitre suivant ? :)
\ No newline at end of file
diff --git a/fr/deploy/README.md b/fr/deploy/README.md
index bc8fdb9c988..7292ef46b63 100755
--- a/fr/deploy/README.md
+++ b/fr/deploy/README.md
@@ -1,26 +1,18 @@
-# Déployer !
+# Déployer!
 
 > **Note** Le chapitre suivant peut-être un peu difficile à comprendre. Accrochez-vous et allez jusqu'au bout : le déploiement fait partie intégrale du processus de développement d'un site internet. Ce chapitre a été placé au milieu du tutoriel afin de permettre à votre coach de vous aider dans cette étape un peu compliquée qu'est la mise en ligne de votre site. Si jamais vous manquez de temps à la fin de la journée, ne vous inquiétez pas ! Une fois ce chapitre terminé, vous serez en mesure de finir le tutoriel chez vous :)
 
-Jusqu'à présent, votre site web n'était seulement disponible que sur votre ordinateur. Maintenant, vous allez apprendre à le déployer ! Déployer signifie mettre en ligne votre site pour que d'autres personnes puissent enfin voir votre app :).
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Déployer signifie mettre en ligne votre site pour que d'autres personnes puissent enfin voir votre app. :)
 
-Comme vous l'avez appris, un site web a besoin d'être installé sur un serveur. Il existe de très nombreux fournisseurs de serveurs sur Internet. Nous allons en utiliser un qui dispose d'un système de déploiement relativement simple : [PythonAnywhere][1]. PythonAnywhere est gratuit pour les petites applications qui n'ont pas beaucoup de visiteurs : cela correspond parfaitement à ce dont nous avons besoin pour le moment.
+Comme vous l'avez appris, un site web a besoin d'être installé sur un serveur. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
- [1]: https://pythonanywhere.com/
+Nous allons aussi utiliser les services [GitHub](https://www.github.com), ce qui nous permettra d'héberger notre code en ligne. Il existe d'autres entreprises qui proposent des services similaires. Cependant, presque tous⋅tes les développeurs·ses possèdent aujourd'hui un compte Github et, dans quelques instants, vous aussi !
 
-Nous allons aussi utiliser les services [GitHub][2], ce qui nous permettra d'héberger notre code en ligne. Il existe d'autres entreprises qui proposent des services similaires. Cependant, presque tous⋅tes les développeurs·ses possèdent aujourd'hui un compte Github et, dans quelques instants, vous aussi !
-
- [2]: https://www.github.com
-
-Github va nous servir d'intermédiaire pour envoyer et récupérer notre code sur PythonAnywhere.
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
 
 # Git
 
-Git est un "gestionnaire de version" utilisé par de nombreux·ses développeurs·ses. Ce logiciel permet de garder une trace des modifications apportées à chaque fichier afin que vous puissiez facilement revenir en arrière ou à une version spécifique. Cette fonction est similaire au "suivi des modifications" de Microsoft Word, mais en beaucoup plus puissant.
-
-## Installer Git
-
-> **Note** Si vous avez suivi la partie "installation" du tutoriel, vous n'avez pas besoin d'installer Git à nouveau. Vous pouvez passer directement à la prochaine section et commencer à créer votre dépôt Git.
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
 
 {% include "/deploy/install_git.md" %}
 
@@ -28,53 +20,61 @@ Git est un "gestionnaire de version" utilisé par de nombreux·ses développeurs
 
 Git conserve toutes les modifications apportées à un ensemble de fichiers dans un "repository" (ou "dépôt"). Nous allons devoir en créer un pour notre projet. Ouvrez votre terminal et allez dans le répertoire `djangogirls`. Ensuite, tapez les commandes suivantes :
 
-> **Note** : n'oubliez pas de vérifier dans quel répertoire vous vous trouvez avant d'initialiser votre dépôt. Pour cela tapez la commande `pwd` (OSX/Linux) ou `cd` (Windows). Vous devriez vous trouver dans le dossier `djangogirls`.
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. Vous devriez vous trouver dans le dossier `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
 
     $ git init
     Initialise un dépôt Git vide à l'emplacement ~/djangogirls/.git/
     $ git config --global user.name "Votre nom"
     $ git config --global user.email you@exemple.com
+    
 
-
-L'initialisation d'un dépôt git ne se fait qu'une fois par projet. De même, vous n'aurez plus jamais à ré-entrer votre nom d'utilisateur ou votre email.
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
 
 Git va surveiller et conserver les modifications concernant l'ensemble des fichiers et dossiers présents dans ce répertoire, à l'exception de certains fichiers que nous aimerions exclure. Pour cela, nous allons créer un fichier appelé `.gitignore` dans le répertoire principal du projet. Ouvrez votre éditeur et créez un nouveau fichier en copiant le contenu suivant :
 
-```
-*.pyc
-__pycache__
-myvenv
-db.sqlite3
-/static
-.DS_Store
-```
+{% filename %}.gitignore{% endfilename %}
 
-Enregistrez ce fichier `.gitignore` dans votre répertoire principal "djangogirls".
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
 
-> **Attention**: le point au début du nom du fichier est important ! Vous pouvez parfois rencontrer des difficultés à créer ce fichier. Par exemple, Mac ne vous laisse pas enregistrer un fichier qui commence par un point dans Finder. Pour contourner ce problème, utilisez la fonction "enregistrer sous" de votre éditeur : ça marche à tous les coups!
+And save it as `.gitignore` in the "djangogirls" folder.
 
-> **Note** L'un des fichiers spécifiés dans `.gitignore` est `db.sqlite3`. Ce fichier est votre base de donnée locale, où tous vos posts de blog sont stockés. Ce fichier n'est pas ajouté à la base de données parce que votre site internet sur PythonAnywhere utilise une base de donnée différente.  Cette base de donnée peut être en SQLite, comme celle créée localement sur votre ordinateur mais en général, une base de données appelée MySQL est utilisée parce qu'elle peut gérer beaucoup plus de visiteurs qu'une base de données SQLite. Dans tous les cas, ignorer votre base de donneés SQLite pour la copie sur GitHub signifie que tous les posts que vous avez créé jusqu'à maintenant vont rester sur votre machine locale et ne seront accessible que depuis cette machine. Vous allez devoir les ajouter à nouveau sur votre site internet en production. Considérez votre base de données locale comme une aire de jeu où vous pouvez essayer des choses différentes sans vous souciez de supprimer un de vos vrais post de blog.
+> **Attention** : le point au début du nom du fichier est important ! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
 
-Avant de taper la commande `git add` ou lorsque vous ne vous souvenez plus des changements que vous avez effectué dans votre projet, pensez à taper la commande `git status`. Cela permet surtout d'éviter les mauvaises surprises, comme l'ajout ou l'envoi d'un mauvais fichier. La commande `git status` permet d'obtenir des informations sur tous les fichiers non-suivis/modifiés/mis-à-jour, l'état de la branche, et bien plus encore. Voici ce qui se passe lorsque vous tapez cette commande :
+Avant de taper la commande `git add` ou lorsque vous ne vous souvenez plus des changements que vous avez effectué dans votre projet, pensez à taper la commande `git status`. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
 
     $ git status
     On branch master
-
+    
     Initial commit
-
+    
     Untracked files:
       (use "git add <file>..." to include in what will be committed)
-
+    
             .gitignore
             blog/
             manage.py
             mysite/
-
+    
     nothing added to commit but untracked files present (use "git add" to track)
-
+    
 
 Pour le moment, nous n'avons fait que regarder l'état de notre branche. Pour enregistrer nos changements, nous allons devoir taper les commandes suivantes :
 
+{% filename %}command-line{% endfilename %}
+
     $ git add --all .
     $ git commit -m "My Django Girls app, first commit"
      [...]
@@ -82,183 +82,154 @@ Pour le moment, nous n'avons fait que regarder l'état de notre branche. Pour en
      create mode 100644 .gitignore
      [...]
      create mode 100644 mysite/wsgi.py
-
-
-## Publier votre code sur GitHub
-
-Allez sur [GitHub.com][2] et inscrivez-vous gratuitement (si vous possédez déjà un compte, c'est très bien!)
-
-Ensuite, créez un nouveau dépôt en lui donnant le nom "my-first-blog". Pensez à laisser les options par défaut. Dans notre cas, il n'est pas nécessaire de cocher la case "initialise with a README". Vous pouvez aussi laisser l'option .gitignore vide car nous avons déjà créé ce fichier précédemment. Enfin, comme nous n'avons pas besoin d'une licence pour notre application, laissez le champ License à None.
-
-![][3]
-
- [3]: images/new_github_repo.png
-
-> **Note** : dans le cadre de ce tutoriel, le nom `my-first-blog` est très important. Cependant, vous êtes libre de le changer mais, attention : à chaque fois que ce nom apparaitra dans le tutoriel, vous allez devoir le substituer avec le nom que vous avez choisi. Il est probablement plus simple de garder le nom `my-first-blog` pour cette fois.
-
-La page suivante vous donne l'URL qui va vous permettre de cloner votre dépôt. Choisissez la version « HTTPS » et copiez l'URL car nous allons rapidement en avoir besoin :
-
-![][4]
-
- [4]: images/github_get_repo_url_screenshot.png
-
-Nous avons maintenant besoin de relier nos deux dépôts : celui sur notre ordinateur et celui sur GitHub. On utilise l'expression "hook" en anglais pour cette décrire cette étape.
-
-Tapez les instructions suivantes dans votre console (remplacez `<votre-nom-d'utilisateur-github>` avec le nom d'utilisateur de votre compte GitHub et sans les chevrons) :
-
-    $ git remote add origin https://github.com/<votre-nom-d'utilisateur-github>/my-first-blog.git
-    $ git push -u origin master
-
-
-Entrez votre nom d'utilisateur et mot de passe Github. Vous devriez voir quelque chose comme ceci :
-
-    Username for 'https://github.com': votre-nom
-    Password for 'https://votre-nom@github.com':
-    Counting objects: 6, done.
-    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
-    Total 3 (delta 0), reused 0 (delta 0)
-    To https://github.com/votre-nom/my-first-blog.git
-     * [new branch]      master -> master
-    Branch master set up to track remote branch master from origin.
-
-
-<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extention -->
-
-Votre code est maintenant sur GitHub. Allez jeter un coup d’œil ! Votre code est maintenant au même endroit que d'autres projets super cool : [Django][5], [le tutoriel Django Girls][6] et les nombreux autres projets libres qui sont hébergés sur GitHub :)
-
- [5]: https://github.com/django/django
- [6]: https://github.com/DjangoGirls/tutorial
-
-# Mettre votre blog en ligne avec PythonAnywhere
-
-> **Note** Vous avez peut être déjà créé un compte PythonAnyWhere au cours de la phase d'installation - si c'est le cas, inutile de le refaire.
-
-{% include "/deploy/signup_pythonanywhere.md" %}
-
-## Récupérer votre code sur PythonAnywhere
-
-Une fois enregistré sur PythonAnywhere, vous serez automatiquement redirigée sur votre écran d'accueil où se trouve la liste des consoles. Cliquez sur le lien "Bash" dans la partie "start a new console". C'est la version PythonAnywhere des consoles que vous avez sur votre ordinateur.
-
-> **Note** : PythonAnywhere utilise Linux. Si vous êtes sous Windows, la console sera un peu différente de celle de votre ordinateur.
-
-Importons notre code depuis Github vers PythonAnywhere en créant un "clone" de notre dépôt. Tapez la commande suivante dans la console de PythonAnywhere (n'oubliez pas d'utiliser votre nom d'utilisateur Github à la place de `<your-github-username>`):
-
-    $ git clone https://github.com/<votre-nom-d'utilisateur-github>/my-first-blog.git
-
-
-Cette commande va permettre d'effectuer une copie de votre code vers PythonAnywhere. La commande `tree my-first-blog` permet d'afficher un aperçu de ce qui se trouve maintenant sur votre serveur :
-
-    $ tree my-first-blog
-    my-first-blog/
-    ├── blog
-    │   ├── __init__.py
-    │   ├── admin.py
-    │   ├── migrations
-    │   │   ├── 0001_initial.py
-    │   │   └── __init__.py
-    │   ├── models.py
-    │   ├── tests.py
-    │   └── views.py
-    ├── manage.py
-    └── mysite
-        ├── __init__.py
-        ├── settings.py
-        ├── urls.py
-        └── wsgi.py
-
-
-### Créer un virtualenv sur PythonAnywhere
-
-Tout comme sur votre ordinateur, vous allez devoir créer un environnement virtuel et installer Django sur PythonAnywhere. L'opération est identique, à une différence près pour les utilisatrices de Windows : il s'agit ici d'une console Linux. Pas de panique, c'est très simple ! Ouvrez la console Bash de PythonAnywhere et tapez les commandes suivantes :
-
-    $ cd my-first-blog
-
-    $ virtualenv --python=python3.4 myvenv
-    Running virtualenv with interpreter /usr/bin/python3.4
-    [...]
-    Installing setuptools, pip...done.
-
-    $ source myvenv/bin/activate
-
-
-    (mvenv) $  pip install django~=1.11.0
-    Collecting django
-    [...]
-    Successfully installed django-1.11
-
-
-> **Note** : L'étape `pip install` peut prendre quelques minutes. Patience, patience ! Cependant, si cela prend plus de 5 minutes, c'est que quelque chose ne va pas. N'hésitez pas à solliciter votre coach.
-
-<!--TODO: think about using requirements.txt instead of pip install.-->
-
-
-
-### Créer une base de données sur PythonAnywhere
-
-Tout comme l'environnement virtuel, la base de données n'est pas partagée entre le serveur et votre ordinateur. Cela signifie, entre autre, que vous n'aurez plus forcément les mêmes utilisateurs ni les mêmes posts sur votre ordinateur et sur PythonAnywhere.
-
-Pour créer une base de données sur PythonAnywhere, nous allons taper les mêmes commandes que sur notre ordinateur: d'abord `migrate`, puis `createsuperuser`:
-
-    (mvenv) $ python manage.py migrate
-    Operations to perform:
-    [...]
-      Applying sessions.0001_initial... OK
-
-
-    (mvenv) $ python manage.py createsuperuser
-
-
-## Faire de votre blog une application web
-
-Maintenant, notre code est sur PythonAnywhere, notre virtualenv est prêt et la base de données est initialisée. Nous sommes prêts à le publier comme une application web !
-
-Retourner sur la page d'accueil de PythonAnywhere en cliquant sur le logo en haut à gauche. Ensuite, cliquez sur l'onglet **Web** et **Add a new web app**.
-
-Après avoir confirmé votre nom de domaine, choisissez **manual configuration** dans la boite de dialogue (NB : ne choisissez *pas* l'option "Django"). Enfin, choisissez **Python 3.4** et cliquez sur "next" pour fermer l'assistant de configuration.
-
-> **Note** : Faites bien attention à sélectionner l'option configuration manuelle ("Manual configuration") et non l'option "Django". N'oubliez pas une chose : vous êtes bien trop cool pour prendre l'option Django qui est fourni par défaut ;-)
-
-### Configurer le virtualenv
-
-Une fois l'assistant fermé, vous serez automatiquement conduite sur la page de configuration dédiée à votre application web. Dès que vous aurez besoin de modifier quelque chose concernant votre appli, c'est là que vous devrez aller.
-
-![][7]
-
- [7]: images/pythonanywhere_web_tab_virtualenv.png
-
-Dans la section "Virtualenv", cliquez sur le texte en rouge qui indique "Enter the path to a virtualenv" (entrer le chemin d'accès de votre environnement virtuel), et entrez ceci : `/home/<your-username>/my-first-blog/myvenv/`. Cliquez sur la boite bleue avec la case à cocher pour sauvegarder le chemin d’accès.
-
-> **Note** : N'oubliez pas de mettre votre nom d'utilisateur. Ne vous inquiétez pas : si vous faites une erreur, PythonAnywhere vous le signalera.
-
-### Configurer le fichier WSGI
-
-Django utilise le protocole "WSGI" qui est un stantard pour servir des sites web qui utilisent Python. Ce protocole est supporté par PythonAnywhere. Afin que PythonAnywhere détecte notre blog Django, nous allons éditer le fichier de configuration WSGI.
-
-Dans l'onglet web, vous allez trouver une section code : cliquez sur le lien "WSGI configuration file" : votre fichier de configuration devrait s’intituler `/var/www/<your-username>_pythonanywhere_com_wsgi.py`. Une fois que vous avez cliqué dessus, vous serez automatiquement redirigée dans un éditeur de texte.
-
-Supprimer le contenu du fichier et le remplacer par ce qui suit :
-
-```python
-import os
-import sys
-
-path = '/home/<your-username>/my-first-blog'  # use your own username here
-if path not in sys.path:
-    sys.path.append(path)
-
-os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
-
-from django.core.wsgi import get_wsgi_application
-from django.contrib.staticfiles.handlers import StaticFilesHandler
-application = StaticFilesHandler(get_wsgi_application())
-```
-
-> **Note** : N'oubliez pas de remplacer `<your-username>` par votre nom d'utilisateur
-> **Note** : A la ligne 3, on s'assure que PythonAnywhere saura trouver notre application. Il est très important que ce chemin d'accès soit correct, et plus particulièrement qu'il n'y ait pas d'espaces en plus. Dans le cas contraire "ImportError" s'affichera dans le log d'erreur.
-
-Le but de ce fichier est de permettre à PythonAnywhere de savoir où votre application web se situe et de connaître le nom des fichiers de configuration de Django.
-
-`StaticFilesHandler` sert à gérer notre CSS. Cette étape est réalisée automatiquement en exécutant la commande `runserver`. Nous aborderons un peu plus en détails les fichiers statiques quand nous éditerons le CSS de notre site.
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': votre-nom Password for 'https://votre-nom@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Allez jeter un coup d’œil !  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Importons notre code depuis Github vers PythonAnywhere en créant un "clone" de notre déôpt. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. Pour le moment, vous n'avez pas besoin d'en savoir plus ! Ne vous inquiétez pas : nous reviendrons plus tard sur les fichiers statiques (partie CSS). L'objectif de ce chapitre est de poser toutes les bases nécessaires au déploiement pour passer rapidement à la suite :)
 
 Cliquez sur **Save** puis, retournez dans l'onglet **Web**.
 
@@ -266,26 +237,24 @@ Et voilà, c'est fini ! Vous n'avez plus qu'à cliquer sur le gros bouton vert *
 
 ## Conseils en cas de bug
 
-Si vous constatez une erreur lorsque vous essayez de visiter votre site web, les **logs d'erreurs** devraient vous permettre de comprendre ce qui ne marche pas. Vous trouverez un lien vers ces fichiers dans l'onglet [Web][8] de PythonAnywhere. Regardez s’il y a des messages d’erreurs ; les plus récents seront en bas du fichier. Les bugs les plus fréquents que vous pouvez rencontrer sont les suivants:
-
- [8]: https://www.pythonanywhere.com/web_app_setup/
+Si vous constatez une erreur lorsque vous essayez de visiter votre site web, les **logs d'erreurs** devraient vous permettre de comprendre ce qui ne marche pas. Vous trouverez un lien vers ces fichiers dans l'onglet [Web](https://www.pythonanywhere.com/web_app_setup/) de PythonAnywhere. Regardez s’il y a des messages d’erreurs ; les plus récents seront en bas du fichier. Les bugs les plus fréquents que vous pouvez rencontrer sont les suivants:
 
-*   Oublier une étape lors du passage dans la console. Vous devriez avoir fait toutes les étapes suivantes : créer un environnement virtuel, l'activer, installer Django et enfin créer la base de données.
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
 
-*   Se tromper dans le chemin d'accès à l'environnement virtuel : si c'est le cas, vous trouverez un petit message d'erreur en rouge dans l'onglet "web", section virtualenv.
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
 
-*   Se tromper lors de la création du fichier de configuration WSGI : pensez à vérifier si le chemin d'accès que vous avez entré est bien celui de "my-first-blog"?
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
 
-*   Se tromper de version de Python : votre environnement virtuel et votre application web doivent toutes les deux être sous Python 3.4.
+- Se tromper de version de Python : votre environnement virtuel et votre application web doivent toutes les deux être sous Python 3.6.
 
-*   Il y a quelques [astuces générales de débogage sur le wiki PythonAnywhere][9].
-
- [9]: https://www.pythonanywhere.com/wiki/DebuggingImportError
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
 
 Et n'oubliez pas, votre coach est là pour vous aider !
 
 # Votre site est en ligne !
 
-La page qui s'affiche devrait être la même que celle sur votre ordinateur : "Welcome to Django". Vous pouvez essayer d'accéder à l'interface d’administration en ajoutant `/admin/` à la fin de l'URL. Normalement, une page de login devrait s'afficher. Une fois connectée en utilisant votre nom d'utilisateur et votre mot de passe, vous devriez pouvoir ajouter des nouveaux posts sur le serveur.
+The default page for your site should say "It worked!", just like it does on your local computer. Vous pouvez essayer d'accéder à l'interface d’administration en ajoutant `/admin/` à la fin de l'URL. Normalement, une page de login devrait s'afficher. Une fois connectée en utilisant votre nom d'utilisateur et votre mot de passe, vous devriez pouvoir ajouter des nouveaux posts sur le serveur.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
 
-*Félicitations !* Le déploiement est l’une des parties les plus épineuses du développement web et il faut souvent plusieurs jours avant d'obtenir quelque chose de fonctionnel. Mais vous avez réussi sans trop d'encombres à mettre votre site en ligne : parfait <3
+*Félicitations !* Le déploiement est l’une des parties les plus épineuses du développement web et il faut souvent plusieurs jours avant d'obtenir quelque chose de fonctionnel. Mais vous avez réussi sans trop d'encombres à mettre votre site en ligne : parfait <3
\ No newline at end of file
diff --git a/fr/deploy/install_git.md b/fr/deploy/install_git.md
index 2190df46aa8..3d951a58254 100644
--- a/fr/deploy/install_git.md
+++ b/fr/deploy/install_git.md
@@ -1,17 +1,52 @@
-### Windows
+Git est un "gestionnaire de version" utilisé par de nombreux·ses développeurs·ses. Ce logiciel permet de garder une trace des modifications apportées à chaque fichier afin que vous puissiez facilement revenir en arrière ou à une version spécifique. Cette fonction est similaire au "suivi des modifications" de Microsoft Word, mais en beaucoup plus puissant.
 
-Vous pouvez télécharger Git sur [git-scm.com](https://git-scm.com/). Vous pouvez cliquer sur "next" à toutes les étapes, sauf pour la cinquième, "Adjusting your PATH environment" : n'oubliez pas de choisir "Run Git and associated Unix tools from the Windows command-line", situé en bas de la liste des options disponibles. Les autres choix par défaut n'ont pas besoin d'être modifiés. L'option "Checkout Windows-style, commit Unix-style line endings" est parfaite: vous n'avez rien à changer sur cette page.
+## Installer Git
 
-### MacOS
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Vous pouvez télécharger Git sur [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Les autres choix par défaut n'ont pas besoin d'être modifiés. L'option "Checkout Windows-style, commit Unix-style line endings" est parfaite: vous n'avez rien à changer sur cette page.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
 
 Vous pouvez télécharger Git sur [git-scm.com](https://git-scm.com/). Pour le reste de l'installation, suivez simplement les instructions de l'installateur.
 
-### Linux
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Git est probablement déjà installé mais, si ce n'est pas le cas, voici les instructions à suivre :
+```bash
+$ sudo zypper install git
+```
 
-    sudo apt-get install git
-     # ou
-    sudo yum install git
-     # ou
-    sudo zypper install git
\ No newline at end of file
+<!--endsec-->
\ No newline at end of file
diff --git a/fr/deploy/signup_pythonanywhere.md b/fr/deploy/signup_pythonanywhere.md
index 3b6e7b711a2..ca66bd0de69 100644
--- a/fr/deploy/signup_pythonanywhere.md
+++ b/fr/deploy/signup_pythonanywhere.md
@@ -1,5 +1,5 @@
-Si vous ne l'avez pas encore fait, n'oubliez pas de vous créer un compte "Beginner" sur PythonAnywhere.
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
 
-  * [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
 
-> **Note** : Le nom d'utilisateur que vous allez choisir va déterminer l'adresse de votre blog de la manière suivante : `votrenomdutilisateur.pythonanywhere.com`. Si vous ne savez pas quoi prendre, nous vous conseillons de choisir votre surnom ou un nom proche du sujet de votre blog.
\ No newline at end of file
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/fr/django/README.md b/fr/django/README.md
index b11204e524e..3a3c4fe37ca 100755
--- a/fr/django/README.md
+++ b/fr/django/README.md
@@ -1,27 +1,27 @@
 # Qu'est-ce que Django?
 
-Django (*/ˈdʒæŋɡoʊ/ jang-goh*) est un framework web gratuit et libre écrit en Python. Un framework web est un ensemble de composants qui vous aide à développer des sites web plus rapidement et plus facilement.
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. Un framework web est un ensemble de composants qui vous aide à développer des sites web plus rapidement et plus facilement.
 
 Lorsque vous créez un site web, vous avez souvent besoin de la même chose : une manière de gérer l'authentification de vos utilisateurs (créer un compte, se connecter, se déconnecter), une partie dédiée à la gestion de votre site, des formulaires, une manière de mettre en ligne des fichiers, etc.
 
-La bonne nouvelle, c'est que d'autres gens se sont aussi rendus compte de ce problème et ont décidé de s'allier avec des développeurs·ses pour le résoudre. Ensemble, ces personnes ont créé différents frameworks, dont Django, pour fournir un set de composants de base qui peuvent être utilisés lors de la création d'un site web.
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
 
-Les frameworks existent pour vous éviter de réinventer la roue à chaque fois. Ils vous aident aussi à alléger la charge de travail liée à la création d'un site web.
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
 
 ## Pourquoi est-ce que vous auriez besoin d'un framework ?
 
-Pour comprendre ce à quoi peut bien servir Django, nous avons besoin de nous intéresser aux multiples rôles des serveurs. Par exemple, la première chose qu'a besoin de savoir un serveur, c'est que vous aimeriez qu'il vous affiche une page web.
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
 
-Imaginez une boîte aux lettres (un port) dont l'arrivée de lettres (une requête) serait surveillée. C'est le travail qu'effectue le serveur. Le serveur web lit la lettre qu'il a reçue et en réponse, retourne une page web. Généralement, lorsque vous voulez envoyer quelque chose, vous avez besoin de contenu. Django est quelque chose qui va vous aider à créer ce contenu.
+Imaginez une boîte aux lettres (un port) dont l'arrivée de lettres (une requête) serait surveillée. C'est le travail qu'effectue le serveur. The web server reads the letter and then sends a response with a webpage. Généralement, lorsque vous voulez envoyer quelque chose, vous avez besoin de contenu. Django est quelque chose qui va vous aider à créer ce contenu.
 
 ## Que se passe-t-il quand quelqu'un demande un site web à votre serveur ?
 
-Quand une requête arrive sur un serveur web, elle est transmise à Django dont le premier travail va être d'essayer de comprendre ce qui est exactement demandé. Il s'occupe tout d'abord de l'adresse de la page web et essaye de comprendre ce qu'il doit en faire. Ce travail est effectué par l' **urlresolver** de Django (l'adresse d'une page web est appelée URL, Uniform Resource Locator, ce qui nous aide à comprendre le nom *urlresolver*). Comme il n'est pas très malin, il prend une liste de modèles existants et essaye de trouver celui qui correspond à notre URL. Django lit sa liste de modèles du haut vers le bas et si jamais quelque chose correspond, il envoie la requête à la fonction associée (qui s'appelle une *vue (view)*).
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
 
 Afin d'y voir un peu plus clair, imaginez une postière transportant une lettre. Elle descend la rue et vérifie à chaque maison si le numéro de celle-ci correspond à celui de la lettre. Si jamais les deux numéros correspondent, elle met la lettre dans la boîte aux lettres de cette maison. C'est à peu près comme cela que fonctionne l'urlresolver !
 
-C'est dans la fonction *vue* que les choses intéressantes se passent : cela nous permet de jeter un œil dans la base de données pour obtenir des informations. Par exemple, peut-être que l'utilisateur vient de demander de changer quelque chose dans ces données ? Ce serait comme une lettre dont le contenu serait : "Merci de changer la description de mon emploi actuel". La *vue* va tout d'abord vérifier que l'utilisateur est bien autorisé à effectuer ce changement puis elle corrigera la description de l'emploi. Enfin, elle retournera un message de type : "C'est bon, j'ai terminé ! ". La *vue* créera une réponse et c'est Django qui se chargera de la transmettre au navigateur de l'utilisateur.
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Par exemple, peut-être que l'utilisateur vient de demander de changer quelque chose dans ces données ? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
 
 Bien sûr, ceci n'est qu'une description très simplifiée du processus. Vous n'avez pas besoin de connaitre tous les détails techniques pour le moment : cette vue d'ensemble suffira largement.
 
-Maintenant, nous aurions la possibilité de vous assommer avec des détails complexes sur comment tout cela fonctionne. À la place, nous allons plutôt commencer à construire quelque chose ! Nous vous donnerons toutes les informations importantes au fur et à mesure que vous progresserez. Ce sera plus sympa, non ?
+Maintenant, nous aurions la possibilité de vous assommer avec des détails complexes sur comment tout cela fonctionne. À la place, nous allons plutôt commencer à construire quelque chose ! Nous vous donnerons toutes les informations importantes au fur et à mesure que vous progresserez. Ce sera plus sympa, non ?
\ No newline at end of file
diff --git a/fr/django_admin/README.md b/fr/django_admin/README.md
index 3653cfc4d60..f31f0cd9851 100755
--- a/fr/django_admin/README.md
+++ b/fr/django_admin/README.md
@@ -1,48 +1,57 @@
-# L'interface d'administration de Django
+# Django admin
 
-Pour ajouter, éditer et supprimer les posts que nous venons de modéliser, nous allons utiliser l'interface d'administration de Django.
+To add, edit and delete the posts we've just modeled, we will use Django admin.
 
-Ouvrons le fichier `blog/admin.py` et remplaçons son contenu par ceci :
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
 
 ```python
 from django.contrib import admin
 from .models import Post
 
 admin.site.register(Post)
-```    
+```
 
 Comme vous pouvez le voir, nous importons le modèle « Post » que nous avons écrit dans le chapitre précédent. Afin que notre modèle soit visible dans l'interface d'administration, nous avons besoin d'enregistrer notre modèle à l'aide de `admin.site.register(Post)`.
 
-Voilà, il est temps de jeter un œil à notre modèle Post. N'oubliez pas d'exécuter `python manage.py runserver` dans votre console afin de lancer le serveur web. Dans votre navigateur, entrez l'adresse http://127.0.0.1:8000/admin/. Si tout va bien, vous verrez une page comme celle-ci:
+Voilà, il est temps de jeter un œil à notre modèle Post. N'oubliez pas d'exécuter `python manage.py runserver` dans votre console afin de lancer le serveur web. Go to your browser and type the address http://127.0.0.1:8000/admin/. Vous verrez une page de login qui ressemble à celle-ci :
+
+![Page de login](images/login_page2.png)
 
-![Page de login][1]
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
 
- [1]: images/login_page2.png
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
 
-Afin de vous connecter, vous allez devoir créer un *superuser*, c'est à dire un utilisateur qui contrôlera l'intégralité du site. Retournez à votre ligne de commande : tapez `python manage.py createsuperuser` puis appuyez sur entrée. Tapez votre nom d'utilisateur (en minuscules, sans espace), votre email et votre mot de passe. Vous ne voyez pas le mot de passe que vous êtes en train de taper ? C'est tout à fait normal, ne vous inquiétez pas ! Tapez simplement votre mot de passe et appuyez sur `entrée` pour continuer. La sortie que vous allez obtenir doit ressembler à celle-ci. Notez que le nom d'utilisateur et l'adresse email doivent correspondre aux informations que vous venez d'entrer.
+{% filename %}Mac OS X or Linux:{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
     Username: admin
     Email address: admin@admin.com
     Password:
     Password (again):
     Superuser created successfully.
+    
 
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
 
-Retournez dans votre navigateur et connectez-vous en tant que superutilisateur grâce à l'utilisateur que vous venez de créer. Vous devriez accéder à l'interface d'administration de Django.
-
-![Django admin][2]
-
- [2]: images/django_admin3.png
-
-Allez voir vos posts et expérimentez un peu avec. Ajoutez 5 ou 6 posts. Ne vous occupez pas du contenu - vous pouvez juste copier du texte de ce tutoriel pour aller plus vite :).
+![Django admin](images/django_admin3.png)
 
-Sur vos 5 posts, faites en sorte qu'au moins 2 ou 3 posts possèdent une date de publication. Prenez garde à ne pas en donner à tous vos posts car nous allons avoir besoin de ces deux différents cas plus tard.
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
 
-![Django admin][3]
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
 
- [3]: images/edit_post3.png
+![Django admin](images/edit_post3.png)
 
-Si jamais vous voulez en savoir un peu plus sur l'interface d'administration de Django, vous pouvez lire la documentation qui lui est associée : https://docs.djangoproject.com/fr/1.11/ref/contrib/admin/
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
 
-Il est probablement temps d'aller recharger vos batteries avec un café, un thé ou un truc à grignoter. Vous venez de créer votre modèle Django : vous méritez bien une petite pause !
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/fr/django_forms/README.md b/fr/django_forms/README.md
index fbfd803d507..494c06e426d 100755
--- a/fr/django_forms/README.md
+++ b/fr/django_forms/README.md
@@ -1,6 +1,6 @@
 # Formulaires Django
 
-La dernière chose que nous voulons faire sur notre site web, c'est créer une manière sympathique d'ajouter ou d'éditer des blog posts. `L'interface d'administration` de Django est cool, mais elle est assez complexe à personnaliser et à rendre jolie. Les `formulaires` vont nous donner un pouvoir absolu sur notre interface : nous allons être capables de faire à peu près tout ce que nous pouvons imaginer !
+La dernière chose que nous voulons faire sur notre site web, c'est créer une manière sympathique d'ajouter ou éditer des blog posts. `L'interface d'administration` de Django est cool, mais elle est assez complexe à personnaliser et à rendre jolie. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
 
 Ce qui est pratique avec les formulaires Django, c'est que nous pouvons aussi bien en définir un à partir de rien ou créer un `ModelForm` qui va enregistrer le résultat du formulaire dans un modèle.
 
@@ -12,9 +12,11 @@ Nous allons devoir créer un fichier avec ce nom dans notre dossier `blog`.
 
     blog
        └── forms.py
+    
 
+OK, let's open it and type the following code:
 
-Ouvrez maintenant ce fichier et tapez le code suivant :
+{% filename %}blog/forms.py{% endfilename %}
 
 ```python
 from django import forms
@@ -30,27 +32,31 @@ class PostForm(forms.ModelForm):
 
 Nous avons besoin tout d'abord d'importer les formulaires Django (`from django import forms`), puis, évidemment, notre modèle `Post` (`from .models import Post`).
 
-Comme vous l'avez probablement deviné, `PostForm` est le nom de notre formulaire. Nous avons besoin de préciser à Django que ce formulaire est un `ModelForm`. Pour cela, nous utilisons `forms.ModelForm`.
+Comme vous l'avez probablement deviné, `PostForm` est le nom de notre formulaire. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
 
 Ensuite, nous avons une `Meta Classe` qui nous permet de dire à Django quel modèle il doit utiliser pour créer ce formulaire (`model = Post`).
 
-Enfin, nous précisions quels sont le⋅s champ⋅s qui doivent figurer dans notre formulaire. Dans notre cas, nous souhaitons que seuls `title` et `text` apparaissent dans notre formulaire. Nous obtiendrons les autres données différemment : par exemple, on s'attend à ce que l'auteur (`author`) soit la personne actuellement enregistrée (c'est à dire vous !) et que la date de création `created_date` soit générée automatiquement lors de la création du post (cf code que nous avons écrit).
+Enfin, nous précisions quels sont le⋅s champ⋅s qui doivent figurer dans notre formulaire. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
 
 Et voilà, c'est tout ! Tout ce qu'il nous reste à faire, c'est d'utiliser ce formulaire dans une *vue* et de l'afficher dans un template.
 
-Nous allons donc une nouvelle fois suivre le processus suivant et créer : un lien vers la page, une URL, une vue et un template.
+So once again we will create a link to the page, a URL, a view and a template.
 
 ## Lien vers une page contenant le formulaire
 
 C'est le moment d'ouvrir le fichier `blog/templates/blog/base.html`. Nous allons ajouter un lien dans un `div` appelé `page-header` :
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Remarquez que notre nouvelle vue s'appelle `post_new`.
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
 
-Après avoir ajouté cette ligne, votre fichier html devrait maintenant ressembler à ceci :
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
@@ -79,40 +85,48 @@ Après avoir ajouté cette ligne, votre fichier html devrait maintenant ressembl
 </html>
 ```
 
-Sauvegardez votre fichier et rafraichissez la page http://127.0.0.1:8000 : vous devez normalement tomber encore une fois sur l'erreur `NoReverseMatch` !
+Sauvegardez votre fichier et rafraîchissez la page http://127.0.0.1:8000 : vous devez normalement tomber encore une fois sur l'erreur `NoReverseMatch` !
 
 ## URL
 
 Ouvrez le fichier `blog/urls.py` et ajoutez cette ligne :
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-    url(r'^post/new/$', views.post_new, name='post_new'),
+url(r'^post/new/$', views.post_new, name='post_new'),
 ```
 
 Votre fichier doit maintenant ressembler à ceci :
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
     url(r'^post/new/$', views.post_new, name='post_new'),
 ]
 ```
 
-Une fois la page rechargée, vous allez voir une `AttributeError`, ce qui est normal. Nous n'avons pas encore implémentée la vue `post_new`. Allons nous occuper de ça maintenant.
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
 
 ## La vue post_new
 
 Ouvrez maintenant le fichier `blog/views.py` et ajoutez les lignes suivantes avec celles du `from` qui existent déjà :
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from .forms import PostForm
 ```
 
-Puis ajoutez la *vue* :
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -120,22 +134,22 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Afin de pouvoir créer un nouveau formulaire `Post`, nous avons besoin d'appeler la fonction `PostForm()` et de la passer au template. Nous reviendrons modifier cette *vue* plus tard, mais pour l'instant, créons rapidement un template pour ce formulaire.
+Afin de pouvoir créer un nouveau formulaire `Post`, nous avons besoin d'appeler la fonction `PostForm()` et de la passer au template. We will go back to this *view*, but for now, let's quickly create a template for the form.
 
 ## Template
 
 Pour cela, nous avons besoin de créer un fichier `post_edit.html` dans le dossier `blog/templates/blog`. Afin que notre formulaire fonctionne, nous avons besoin de plusieurs choses :
 
-*   Nous voulons afficher le formulaire. Nous pouvons le faire à l'aide d'un simple `{% raw %}{{ form.as_p }}{% endraw %}` par exemple.
-*   La ligne précédente va avoir besoin d'être enveloppée dans des balises HTML : `<form method="POST">...</form>`
-*   Nous avons besoin d'un bouton `Save (sauvegarder)`. Nous allons le créer à l'aide d'un bouton HTML : `<button type="submit">Save</button>`
-*   Enfin, nous devons ajouter `{% raw %}{% csrf_token %}{% endraw %}` juste après `<form ...>`. C'est très important car c'est ce qui va permettre de sécuriser votre formulaire ! De toute manière, si vous avez oublié ce petit morceau, Django vous le fera remarquer lorsque vous sauvegarderez le formulaire :
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. C'est très important car c'est ce qui va permettre de sécuriser votre formulaire ! If you forget about this bit, Django will complain when you try to save the form:
 
-![CSFR Forbidden page][1]
+![CSFR Forbidden page](images/csrf2.png)
 
- [1]: images/csrf2.png
+OK, so let's see how the HTML in `post_edit.html` should look:
 
-Ok, voyons maintenant à quoi devrait ressembler le fichier `post_edit.html` :
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -149,21 +163,21 @@ Ok, voyons maintenant à quoi devrait ressembler le fichier `post_edit.html` :
 {% endblock %}
 ```
 
-Rafraichissons la page ! Et voilà : le formulaire s'affiche !
+Rafraîchissons la page ! Et voilà : le formulaire s'affiche !
 
-![Nouveau formulaire][2]
+![Nouveau formulaire](images/new_form2.png)
 
- [2]: images/new_form2.png
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
 
-Heu, attendez une minute... Quand vous tapez quelque chose dans `title` et `text` et que vous essayez de le sauvegarder, que se passe-t-il ?
-
-Absolument rien ! Nous retombons sur la même page sauf qu'en plus, notre texte a disparu et aucun post ne semble avoir été créé. Que s'est-il passé ?
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
 
 La réponse est : rien ! Nous avons juste encore un peu de travail à accomplir. Retournons à notre *vue*.
 
 ## Sauvegarder le contenu du formulaire
 
-Ouvrez à nouveau `blog/views.py`. Actuellement, `post_new` n'est composé que des lignes de code suivantes :
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -171,9 +185,11 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Lorsque nous envoyons notre formulaire, nous revenons à la même vue. Cependant, nous avons des données dans `request`, et plus particulièrement dans `request.POST`. Prenez garde que "POST" ici n'a aucun lien avec "blog post" : le nom est lié au fait que nous envoyons des données. Rappelez-vous : nous avions défini la variable `method="POST"` dans le fichier HTML qui contient notre `<formulaire>` ? Tous les champs du formulaire se trouvent maintenant dans `request.POST`. Veillez à ne pas renommer `POST` en quoi que ce soit d'autre : la seule autre valeur autorisée pour `method` est `GET`. Malheureusement, nous n'avons pas le temps de rentrer dans les détails aujourd'hui.
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? Tous les champs du formulaire se trouvent maintenant dans `request.POST`. Veillez à ne pas renommer `POST` en quoi que ce soit d'autre : la seule autre valeur autorisée pour `method` est `GET`. Malheureusement, nous n'avons pas le temps de rentrer dans les détails aujourd'hui.
 
-Dans notre *vue*, nous avons donc deux situations différentes à gérer. Tout d'abord, nous avons la situation où nous accédons à la page pour la première fois et que nous voulons un formulaire vide. Ensuite, nous avons la seconde situation où nous retournons sur la *vue* et nous voulons que les champs du formulaire contiennent les informations que nous avions tapées. Pour gérer ces deux cas, nous allons utiliser une condition `if` (si).
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. Pour gérer ces deux cas, nous allons utiliser une condition `if` (si):
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 if request.method == "POST":
@@ -182,41 +198,51 @@ else:
     form = PostForm()
 ```
 
-Attaquons-nous à remplir ces `[...]`. Si la `method` est `POST`, c'est que nous voulons construire notre `PostForm` avec les données de notre formulaire. Pour cela, nous devons ajouter :
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST)
 ```
 
-Facile ! La prochaine étape est de vérifier si le contenu de notre formulaire est correct. Nous aimerions vérifier, par exemple, que les champs obligatoires soient bien remplis et qu'aucune donnée incorrecte ne soit sauvegardée. Pour cela, nous allons utiliser `form.is_valid()`.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
 
 Testons donc si notre formulaire est valide et, si c'est le cas, sauvegardons-le !
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 if form.is_valid():
     post = form.save(commit=False)
     post.author = request.user
     post.published_date = timezone.now()
     post.save()
-```  
+```
+
+En gros, nous effectuons deux choses ici : nous sauvegardons le formulaire grâce à `form.save` et nous ajoutons un auteur. Rappelez vous, il n'y avait pas de champ `author` dans le `PostForm` mais nous avons obligatoirement besoin d'un auteur pour que le formulaire que nous avons créé soit valide). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
 
-En gros, nous effectuons deux choses ici : nous sauvegardons le formulaire grâce à `form.save` et nous ajoutons un auteur. Rappelez-vous, il n'y avait pas de champ `author` dans le `PostForm` mais nous avons obligatoirement besoin d'un auteur pour que le formulaire que nous avons créé soit valide. `commit=False` signifie que nous ne voulons pas encore enregistrer notre modèle `Post`. Nous voulons tout d'abord ajouter un auteur. La plupart du temps, vous utiliserez `form.save()` sans `commit=False`. Cependant, nous en avons besoin ici. `post.save()` va nous permettre de sauvegarder les changements, c'est-à-dire l'ajout d'un auteur. Et voilà, maintenant c'est sûr, un nouveau blog post sera créé !
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
 
-Enfin, ce serait génial si nous pouvions tout de suite aller à la page `post_detail` du post de blog que nous venons de créer. Pour cela, nous avons besoin d'importer une dernière chose :
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import redirect
 ```
 
-Ajoutez-le au tout début de votre page. Maintenant, nous allons ajouter la ligne qui signifie : "aller à la page `post_detail` pour le nouveau post qui vient d'être créé".
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 return redirect('post_detail', pk=post.pk)
 ```
 
-`post_detail` est le nom de la vue où nous voulons aller. Rappelez-vous : une *vue* a besoin d'une variable `pk`. Afin de le passer à la vue, nous utilisons `pk=post.pk`, où `post` désigne le blog post nouvellement créé !
+`post_detail` is the name of the view we want to go to. Rappelez-vous : une *vue* a besoin d'une variable `pk`. To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
 
-Et si au lieu de parler, nous vous montrions à quoi ressemble maintenant notre *vue* ?
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -233,41 +259,41 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Voyons si ça marche. Allez à l'adresse http://127.0.0.1:8000/post/new/, ajoutez un `titre` et du `texte`, puis sauvegardez... Et voilà ! Le nouveau post est bien créé et vous êtes redirigé vers la page `post_detail` !
+Voyons si ça marche. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
 
-Vous avez peut-être remarqué que nous avons choisi une date de publication avant de sauvegarder le post. Nous en aurons besoin lorsque nous créerons le *publish button* (bouton publier) dans **l'un des extensions du tutoriel Django Girls** (en anglais).
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
 
 Encore bravo !
 
-## Validation de formulaire
-
-Maintenant, nous allons vous montrer à quel point les formulaires Django sont cools ! Un post de blog a besoin de champs `title` (titre) et `text` (texte). Dans notre modèle `Post`, nous n'avons pas signalé que ces champs n'étaient pas obligatoire (à l'inverse de `published_date`). Django s'attend donc à ce qu'ils soient remplis à chaque fois.
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. Cependant, vous devinez bien que cette solution n'est pas suffisante à long terme. Afin de corriger ce problème, n'hésitez pas à faire la partie **Devoir : ajouter de la sécurité à son site internet !** qui est située juste après la partie principale du tutoriel.
 
-Essayez de sauvegarder un formulaire sans mettre de `titre` ou de `texte`. Devinez ce qui va se passer !
+![Erreur de loggin](images/post_create_error.png)
 
-![Validation de formulaire][3]
-
- [3]: images/form_validation2.png
+## Validation de formulaire
 
-Django va s'occuper de la validation : il va regarder si tous les champs de notre formulaire sont en adéquation avec notre modèle. C'est cool, non ?
+Maintenant, nous allons vous montrer à quel point les formulaires Django sont cools ! Un post de blog a besoin de champs `title` (titre) et `text` (texte). In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
 
-> Comme nous avons récemment utilisé l'interface d'administration de Django, le système pense que nous sommes encore connectés. Cependant, il y a plusieurs cas qui peuvent amener un utilisateur à être déconnecté : fermer le navigateur, redémarrer la base de données, etc. Si jamais vous obtenez des erreurs lors de la création d'un post qui disent que vous n'êtes pas connecté, retournez sur la page d'administration présente à l'adresse http://127.0.0.1:8000/admin et connectez-vous à nouveau. Cependant, vous devinez bien que cette solution n'est pas suffisante à long terme. Afin de corriger ce problème, n'hésitez pas à faire la partie **Devoir : ajouter de la sécurité à son site internet !** qui est située juste après la partie principale du tutoriel.
+Try to save the form without `title` and `text`. Guess what will happen!
 
-![Erreur de loggin][4]
+![Validation de formulaire](images/form_validation2.png)
 
- [4]: images/post_create_error.png
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
 
 ## Éditer un formulaire
 
-Maintenant, nous savons comme ajouter un nouveau formulaire. Comment faire si nous voulons éditer un formulaire déjà existant ? C'est assez proche de ce que nous venons de faire. Créons ce dont nous avons besoin rapidement. Si jamais des choses vous semblent obscures, n'hésitez pas à demander à votre coach ou à revoir les chapitres précédents. Tout ce que nous allons faire maintenant a déjà été expliqué plus en détail précédemment.
+Maintenant, nous savons comme ajouter un nouveau formulaire. Comment faire si nous voulons éditer un formulaire déjà existant ? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
 
-Ouvrez le fichier `blog/templates/blog/post_detail.html` et ajoutez la ligne suivante :
+Open `blog/templates/blog/post_detail.html` and add the line
 
-```python
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
 
-Votre template doit ressembler à ceci :
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -288,13 +314,17 @@ Votre template doit ressembler à ceci :
 
 Maintenant, dans `blog/urls.py`, ajoutez cette ligne :
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-    url(r'^post/(?P<pk>[0-9]+)/edit/$', views.post_edit, name='post_edit'),
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
 ```
 
 Nous allons réutiliser le template de `blog/templates/blog/post_edit.html`. Il ne va donc nous manquer qu'une *vue*.
 
-Ouvrons `blog/views.py` et ajoutons à la toute fin du fichier :
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_edit(request, pk):
@@ -312,47 +342,51 @@ def post_edit(request, pk):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Vous ne trouvez pas que ça ressemble presque à la vue de `post_new` ? Regardons un peu plus en détail. Tout d'abord, nous passons un paramètre `pk` supplémentaire. Ensuite, nous récupérons le modèle `Post` que nous souhaitons éditer à l'aide de `get_object_or_404(Post, pk=pk)`. Puis, lorsque nous créons un formulaire, nous faisons de ce post deux `instances`. Tout d'abord lorsque nous sauvegardons le formulaire :
+Vous ne trouvez pas que ça ressemble presque à la vue de `post_new` ? Regardons un peu plus en détails. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST, instance=post)
 ```
 
-Puis ensuite lorsque nous ouvrons le formulaire associé à ce post afin de l'éditer :
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(instance=post)
 ```
 
-Alors, voyons si ça marche ! Allons à la page `post_detail`. Un bouton d'édition devrait apparaitre dans le coin supérieur droit de la page :
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
 
-![Bouton d'édition][5]
-
- [5]: images/edit_button2.png
+![Bouton d'édition](images/edit_button2.png)
 
 Lorsque vous cliquez dessus, vous devez voir le formulaire du post de blog apparaitre :
 
-![Éditer un formulaire][6]
-
- [6]: images/edit_form2.png
+![Éditer un formulaire](images/edit_form2.png)
 
-Essayez de manipuler un peu ce que vous venez de créer : ajoutez du texte, changez le titre puis sauvegardez ces changements !
+Feel free to change the title or the text and save the changes!
 
-Bravo ! Votre application se complexifie et contient de plus en plus de fonctionnalités !
+Bravo ! Votre application se complexifie et contient de plus en plus de fonctionnalité !
 
-Si jamais vous voulez en savoir plus sur les formulaires dans Django, n'hésitez pas à lire la documentation associée : https://docs.djangoproject.com/fr/1.11/topics/forms/
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
 
 ## Sécurité
 
-C’est génial de pouvoir créer de nouveaux posts juste en cliquant sur un lien ! Mais n’importe qui visitant votre site pourra mettre un nouveau post en ligne, ce qui n’est probablement pas ce que vous souhaitez. Faisons en sorte que le bouton n’apparaisse seulement qu'à vous.
+C’est génial de pouvoir créer de nouveaux posts juste en cliquant sur un lien ! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
 
 Dans `blog/templates/blog/base.html`, trouvez notre `page-header` `div` et la balise ancre que vous y avez mis plus tôt. Ça doit ressembler à ça :
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-On va y ajouter une autre balise `{% if %}` qui ne fera apparaitre le lien qu’aux utilisateurs⋅trices connecté⋅e⋅s dans l’administration : uniquement vous pour le moment ! Changez la balise `<a>` comme ceci :
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Changez la balise `<a>` comme ceci :
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% if user.is_authenticated %}
@@ -360,37 +394,54 @@ On va y ajouter une autre balise `{% if %}` qui ne fera apparaitre le lien qu’
 {% endif %}
 ```
 
-Ce `{% if %}` fait en sorte de n’envoyer le lien au navigateur que si l’utilisateur⋅trice demandant la page est connecté⋅e. Ce n’est pas une protection complète, mais c’est un bon début. Nous reviendrons sur les questions de sécurité dans les extensions du tutoriel.
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. Ce n’est pas une protection complète, mais c’est un bon début. Nous reviendrons sur les questions de sécurité dans les extensions du tutoriel.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
 
-Comme vous êtes probablement connectée, vous ne verrez aucune différence si vous rafraichissez la page. Mais chargez la page dans un autre navigateur ou dans une fenêtre incognito, et vous verrez que le lien n’apparait pas !
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
 
 ## Encore un petit effort : déployons !
 
 Nos modifications fonctionnent-elles sur PythonAnywhere ? Pour le savoir, déployons à nouveau !
 
-*   Tout d'abord, commitez votre nouveau code et pushez-le à nouveau sur Github
-```
+* Tout d'abord, commiter votre nouveau code et pusher le à nouveau sur Github:
+
+{% filename %}command-line{% endfilename %}
+
     $ git status
     $ git add --all .
     $ git status
-    $ git commit -m "Ajout de vues qui permettent de créer et d'éditer un post de blog sur le site."
+    $ git commit -m "Added views to create/edit blog post inside the site."
     $ git push
-```
+    
 
-*   Puis, dans la console bash de [PythonAnywhere][7]:
+* Puis, dans la console bash de [PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
 
- [7]: https://www.pythonanywhere.com/consoles/
-```
     $ cd my-first-blog
-    $ source myvenv/bin/activate
-    (myvenv)$ git pull
+    $ git pull
     [...]
-    (myvenv)$ python manage.py collectstatic
-    [...]
-```
-
-*   Enfin, cliquez sur l'onglet [Web][8] et cliquez sur **Reload**.
+    
 
- [8]: https://www.pythonanywhere.com/web_app_setup/
+* Enfin, cliquez sur l'onglet [Web](https://www.pythonanywhere.com/web_app_setup/) et cliquez sur **Reload**.
 
-Normalement, ça devrait suffire ! Encore bravo :)
+Normalement, ça devrait suffire ! Encore bravo :)
\ No newline at end of file
diff --git a/fr/django_installation/README.md b/fr/django_installation/README.md
index c775ee7bbc4..b50d46ce4f1 100755
--- a/fr/django_installation/README.md
+++ b/fr/django_installation/README.md
@@ -1,5 +1,7 @@
 # Installation de Django
 
-> **Note** Si vous avez déjà suivi les étapes d'Installation, vous n'avez rien d'autre à faire - vous pouvez aller directement au chapitre suivant !
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
 
 {% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/fr/django_installation/instructions.md b/fr/django_installation/instructions.md
index 7bc4f86512b..f3729f0a474 100644
--- a/fr/django_installation/instructions.md
+++ b/fr/django_installation/instructions.md
@@ -1,6 +1,6 @@
-> Note : ce chapitre est en partie inspiré d'un autre tutoriel réalisé par les Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
->
-> Ce chapitre est en partie inspiré du [tutoriel django-marcador](http://django-marcador.keimlink.de/) qui est sous licence Creative Commons Attribution-ShareAlike 4.0 International License. Le tutoriel django-marcador a été créé par Markus Zapke-Gründemann et al.
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Le tutoriel django-marcador a été créé par Markus Zapke-Gründemann et al.
 
 ## L'environnement virtuel
 
@@ -8,106 +8,194 @@ Avant d'installer Django, nous allons vous faire installer un outil extrêmement
 
 Donc, commençons par créer un **environnement virtuel de programmation** (ou *virtualenv*). Chaque projet aura sa propre configuration en Python/Django grâce à virtualenv. Ce qui veut dire que si vous modifiez un site web, ça n'affectera pas les autres sites sur lesquels vous travaillez. Plutôt cool, non ?
 
-Tout ce dont vous avez besoin, c'est de trouver un dossier où vous voulez créer votre `virtualenv` ; vous pouvez choisir votre home par exemple. Sous Windows, le home ressemble à `C:\Utilisateurs\Nom` (où `Nom` est votre login).
+Tout ce dont vous avez besoin, c'est de trouver un dossier où vous voulez créer votre `virtualenv` ; vous pouvez choisir votre home par exemple. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
 
 Dans ce tutoriel, nous allons utiliser un nouveau dossier `djangogirls` que vous allez créer dans votre dossier home :
 
-    mkdir djangogirls
-    cd djangogirls
+{% filename %}command-line{% endfilename %}
 
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
 
 Nous allons créer un virtualenv appelé `myvenv`. Pour cela, nous taperons une commande qui ressemblera à :
 
-    python3 -m venv myvenv
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
 
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
 
-### Windows
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
 
-Afin de créer un nouveau `virtualenv`, vous avez besoin d'ouvrir votre console (nous en avons déjà parlé dans un chapitre précédent. Est-ce que vous vous en souvenez ?) et tapez `C:\Python34\python -m venv myvenv`. Ça ressemblera à ça :
+{% filename %}command-line{% endfilename %}
 
-    C:\Utilisateurs\Nom\djangogirls> C:\Python34\python -m venv myvenv
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
 
+Where `myvenv` is the name of your `virtualenv`. Vous pouvez choisir un autre nom mais attention : il doit être en minuscules, sans espaces et sans accents ou caractères spéciaux. It is also good idea to keep the name short – you'll be referencing it a lot!
 
-`C:\Python34\python` doit être le nom du dossier où vous avez installé Python et `myvenv` doit être le nom de votre `virtualenv`. Vous pouvez choisir un autre nom mais attention : il doit être en minuscules, sans espaces et sans accents ou caractères spéciaux. C'est aussi une bonne idée de choisir un nom plutôt court, car vous aller souvent l'utiliser !
+<!--endsec-->
 
-### Linux et OS X
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
 
-Pour créer un `virtualenv` sous Linux ou OS X, tapez simplement la commande `python3 -m venv myvenv`. Ça ressemblera à ça :
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
 
-    ~/djangogirls$ python3 -m venv myvenv
+{% filename %}command-line{% endfilename %}
 
+    $ python3 -m venv myvenv
+    
 
-`myvenv` est le nom de votre `virtualenv`. Vous pouvez choisir un autre nom, mais veillez à n'utiliser que des minuscules et à n'insérer ni espaces, ni caractères spéciaux. C'est aussi une bonne idée de choisir un nom plutôt court, car vous aller souvent l'utiliser!
+`myvenv` est le nom de votre `virtualenv`. Vous pouvez choisir un autre nom, mais veillez à n'utiliser que des minuscules et à n'insérer ni espaces, ni caractères spéciaux. It is also a good idea to keep the name short as you'll be referencing it a lot!
 
-> **NOTE:** initialiser un environnement virtuel sous Ubuntu 14.04 de cette manière donne l'erreur suivante :
->
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
 >     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
 >     
->
+> 
 > Pour résoudre ce problème, utilisez plutôt la commande `virtualenv`.
->
->     ~/djangogirls$ sudo apt-get install python-virtualenv
->     ~/djangogirls$ virtualenv --python=python3.4 myvenv
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
 >     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
 
 ## Travailler avec virtualenv
 
 Les commandes listées ci-dessus permettent de créer un dossier appelé `myvenv` (ou le nom que vous avez choisi) qui contient notre environnement virtuel. Pour faire simple, c'est un dossier composé lui-même d'autres dossiers et de fichiers.
 
-#### Windows
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
 
 Démarrez votre environnement virtuel en exécutant :
 
+{% filename %}command-line{% endfilename %}
+
     C:\Utilisateurs\Nom\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
 
+<!--endsec-->
 
-#### Linux et OS X
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
 
 Démarrez votre environnement virtuel en exécutant :
 
-    ~/djangogirls$ source myvenv/bin/activate
+{% filename %}command-line{% endfilename %}
 
+    $ source myvenv/bin/activate
+    
 
 N'oubliez pas de remplacer `myvenv` par le nom que vous avez choisi pour votre `virtualenv` (le cas échéant) !
 
 > **NOTE :** il arrive parfois que `source` ne soit pas disponible. Dans ce cas, vous pouvez essayer ceci :
->
->     ~/djangogirls$ . myvenv/bin/activate
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
 >     
 
-Vous saurez que votre `virtualenv` est lancé quand le prompt de votre console ressemblera à ceci :
+<!--endsec-->
 
-    (myvenv) C:\Utilisateurs\Nom\djangogirls>
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
 
+Quand vous travaillez dans un environnement virtuel, la commande `python` fera automatiquement référence à la bonne version de Python. Vous pouvez donc utiliser `python` plutôt que `python3`.
 
-ou :
+Ok, nous avons installé toutes les dépendances dont nous avions besoin. Nous allons enfin pouvoir installer Django !
 
-    (myvenv) ~/djangogirls$
+## Installation de Django
 
+Now that you have your `virtualenv` started, you can install Django.
 
-Vous remarquez que le préfixe `(myvenv)` est apparu !
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
 
-Quand vous travaillez dans un environnement virtuel, la commande `python` fera automatiquement référence à la bonne version de Python. Vous pouvez donc utiliser `python` plutôt que `python3`.
+{% filename %}command-line{% endfilename %}
 
-Ok, nous avons installé toutes les dépendances dont nous avions besoin. Nous allons enfin pouvoir installer Django !
+    (myvenv) ~$ pip install --upgrade pip
+    
 
-## Installation de Django
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
 
-Maintenant que vous avez lancé votre `virtualenv`, vous pouvez installer Django à l'aide de `pip`. Dans votre console, tapez `pip install django~=1.11.0`. Notez bien que nous utilisons un tilde suivi du signe égal : `~=`).
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~$ pip install django~=1.11.0
-    Downloading/unpacking django==1.11
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
     Installing collected packages: django
-    Successfully installed django
-    Cleaning up...
+    Successfully installed django-1.11.3
+    
 
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
 
-Sous Windows :
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
 
-> Si jamais vous obtenez des erreurs lorsque vous utilisez pip sous Windows, vérifiez si votre chemin d'accès contient des espaces, des accents ou des caractères spéciaux (ex : `C:\Utilisateurs\Nom d'Utilisateur\djangogirls`). Si c'est le cas, changez de dossier et essayez d'en créer un nouveau en prenant en compte le fait qu'il ne doit donc avoir ni accents, ni espaces, ni caractères spéciaux (ex : `C:\djangogirls`). Après l'avoir déplacé, essayez de retaper la commande précédente.
+<!--endsec-->
 
-Sous Linux :
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
 
 > Si vous obtenez une erreur lorsque vous utilisez pip sous Ubuntu 12.04, tapez la commande `python -m pip install -U --force-reinstall pip` pour réparer l'installation de pip dans votre virtualenv.
 
-Et voilà ! Vous êtes (enfin) prête pour créer votre première application Django !
+<!--endsec-->
+
+Et voilà ! Vous êtes (enfin) prête pour créer votre première application Django !
\ No newline at end of file
diff --git a/fr/django_models/README.md b/fr/django_models/README.md
index abd14c9209c..882adb3d137 100755
--- a/fr/django_models/README.md
+++ b/fr/django_models/README.md
@@ -1,40 +1,40 @@
 # Les modèles dans Django
 
-Maintenant, nous aimerions créer quelque chose qui permet de stocker les articles de notre blog. Mais avant de pouvoir faire ça, nous allons tout d'abord devoir vous parler d'un truc qui s'appelle les `objets`.
+Maintenant, nous aimerions créer quelque chose qui permet stocker les articles de notre blog. Mais avant de pour pouvoir faire ça, nous allons tout d'abord devoir vous parler d'un truc qui s'appelle les `objets`.
 
 ## Les objets
 
-Il existe un concept en programmation qu'on appelle la `programmation orientée objets`. L'idée, c'est de modéliser les choses et de définir comment elles interagissent entre elles plutôt que de tout voir comme une séquence d'instructions.
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
 
 Du coup, c'est quoi un objet ? C'est une collection de propriétés et d'actions. Ça a l'air bizarre dit comme ça. Un exemple devrait vous permettre d'y voir un peu plus clair.
 
-Si on veut modéliser un chat, nous allons créer un objet `Chat` qui a quelques propriétés comme `couleur`, `age`, `humeur` (bonne humeur, mauvaise humeur, fatigué ;)). Il peut aussi avoir un `propriétaire` (un objet `Personne`), mais ce n'est pas obligatoire : cette propriété pourrait être vide dans le cas d'un chat sauvage.
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
 
-Ensuite, nous pouvons donner des actions au `Chat` : `ronronner`, `gratter` ou `manger`. (Dans ce dernier cas, on donne au chat un objet `NourriturePourChat`, qui peut lui aussi avoir ses propres propriétés, comme le `goût`).
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
 
-    Chat
+    Cat
     --------
-    couleur
+    color
     age
-    humeur
-    propriétaire
-    ronronner()
-    gratter()
-    nourrir(nourriture_pour_chat)
-
-
-    NourriturePourChat
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
     --------
-    gout
-
+    taste
+    
 
 L'idée qu'il faut retenir, c'est que l'on décrit les choses du monde réel avec des propriétés (appelées `propriétés des objets`) et des actions (appelées `méthodes`).
 
 Du coup, comment modéliser les articles de blog ? C'est bien gentil les chats, mais ce qui nous intéresse, ça reste de faire un blog !
 
-Pour ça, il faut répondre à la question : qu'est-ce qu'un article de blog ? Quelles propriétés devrait-il avoir ?
+Pour ça, il faut réponde à la question : qu'est-ce qu'un article de blog ? Quelles propriétés devrait-il avoir ?
 
-Pour commencer, notre blog post doit avoir du texte : il a bien du contenu et un titre, n'est-ce pas ? Et puis, ce serait bien de savoir aussi qui l'a écrit. On a donc besoin d'un auteur. Enfin, on aimerait aussi savoir quand l'article a été écrit et publié.
+Pour commencer, notre blog post doit avoir du texte : il a bien du contenu et un titre, n'est-ce pas ? It would be also nice to know who wrote it – so we need an author. Enfin, on aimerait aussi savoir quand l'article a été écrit et publié.
 
     Post
     --------
@@ -43,7 +43,7 @@ Pour commencer, notre blog post doit avoir du texte : il a bien du contenu et un
     author
     created_date
     published_date
-
+    
 
 Quel genre d'actions pourrions-nous faire sur un article de blog ? Un bon début serait d'avoir une `méthode` qui permet de publier le post.
 
@@ -55,7 +55,7 @@ Voilà, nous avons une idée de ce que nous avons besoin. Allons modéliser tout
 
 Maintenant que nous savons ce qu'est un objet, nous allons pouvoir créer un modèle Django pour notre post de blog.
 
-Un modèle Django est un type particulier d'objet : il est sauvegardé dans la `database`. Une base de données est une collection de données. C'est à cet endroit que l'on stocke toutes les informations au sujet des utilisateurs, des blog posts, etc. Pour stocker nos données, nous allons utiliser une base de données SQLite. C'est la base de données par défaut dans Django. Elle sera largement suffisante pour ce que nous voulons faire.
+A model in Django is a special kind of object – it is saved in the `database`. Une base de données est une collection de données. C'est à cet endroit que l'on stocke toutes les informations au sujet des utilisateurs, des blog posts, etc. Pour stocker nos données, nous allons utiliser une base de données SQLite. This is the default Django database adapter – it'll be enough for us right now.
 
 Pour vous aider à visualiser ce qu'est une base de données, pensez à un tableur avec des colonnes (champs) et des lignes (données).
 
@@ -63,29 +63,40 @@ Pour vous aider à visualiser ce qu'est une base de données, pensez à un table
 
 Pour éviter le désordre, nous allons créer une application séparée à l'intérieur de notre projet. Prenez l'habitude de bien tout organiser dès le début. Afin de créer une application, nous avons besoin d'exécuter la commande suivante dans notre console (prenez garde à bien être dans le dossier `djangogirls` où se trouve le fichier `manage.py`) :
 
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
 
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
 
-Vous pouvez voir qu'un nouveau dossier `blog` a été créé et qu'il contient différents fichiers. Vos dossiers et fichiers liés à votre projet doivent maintenant être organisés selon cette structure :
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
 
     djangogirls
-    ├── mysite
-    |       __init__.py
-    |       settings.py
-    |       urls.py
-    |       wsgi.py
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
     ├── manage.py
-    └── blog
-        ├── migrations
-        |       __init__.py
+    └── mysite
         ├── __init__.py
-        ├── admin.py
-        ├── models.py
-        ├── tests.py
-        └── views.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
 
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
 
-Après avoir créé une nouvelle application, vous devez dire à Django de l'utiliser. Pour cela, nous allons éditer le fichier `mysite/settings.py`. Trouvez la section `INSTALLED_APPS` et ajoutez `'blog',` juste avant `]`. La section doit maintenant ressembler à ceci :
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 INSTALLED_APPS = [
@@ -101,9 +112,11 @@ INSTALLED_APPS = [
 
 ### Créer un modèle de blog post
 
-Le fichier `blog/models.py` permet de définir les objets que nous appelons des `modèles`. C'est à cet endroit que nous allons définir ce qu'est un blog post. Pour éviter tout problème (les caractères accentués par exemple!), nous allons garder les termes en anglais.
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
 
-Ouvrez le fichier `blog/models.py`, supprimez tout ce qui s'y trouve et copiez-y le morceau de code suivant :
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
 
 ```python
 from django.db import models
@@ -111,7 +124,7 @@ from django.utils import timezone
 
 
 class Post(models.Model):
-    author = models.ForeignKey('auth.User')
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
     created_date = models.DateTimeField(
@@ -127,44 +140,53 @@ class Post(models.Model):
         return self.title
 ```
 
-> Vérifiez que vous avez bien utilisé deux tirets bas (`_`) autour de `str`. C'est une convention fréquemment utilisée en Python qui porte même un petit nom en anglais : "dunder", pour "double-underscore".
+> Double-check that you use two underscore characters (`_`) on each side of `str`. C'est une convention fréquemment utilisée en Python qui porte même un petit nom en anglais : "dunder", pour "double-underscore".
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
 
-Ce gros morceau de code a l'air effrayant mais, ne vous inquiétez pas : nous allons vous expliquer ce que signifie chacune de ces lignes!
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
 
-Toutes les lignes qui commencent par `from` ou `import` sont des lignes qui permettent d'importer des morceaux d'autres fichiers. Concrètement, au lieu de recopier ou de copier-coller la même chose dans différents fichiers, nous pouvons tout simplement faire référence à certains morceaux d'autres fichiers à l'aide de `from ... import ...`.
+`class Post(models.Model):` – this line defines our model (it is an `object`).
 
-`class Post(models.Model):` - C'est cette ligne qui permet de définir notre modèle. C'est un `object`).
+- Le mot clef spécial `class` permet d'indiquer que nous sommes en train de définir un objet.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` signifie que Post est un modèle Django. Comme ça, Django sait qu'il doit l'enregistrer dans la base de données.
 
-*   Le mot clef spécial `class` permet d'indiquer que nous sommes en train de définir un objet.
-*   `Post` est le nom de notre modèle. Vous pouvez lui donner un autre nom mais vous ne pouvez pas utiliser de caractères spéciaux ou accentués ni insérer des espaces. Le nom d'une classe commence toujours par une majuscule.
-*   `models.Model` signifie que Post est un modèle Django. Comme ça, Django sait qu'il doit l'enregistrer dans la base de données.
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
 
-Maintenant, nous allons pouvoir définir les propriétés dont nous parlions au début de ce chapitre : `title (titre)`, `text (texte)`, `created_date (date de création)`, `published_date (date de publication)` et `author (auteur)`. Pour cela, nous allons avoir besoin de définir le type de chaque champ (Est-ce que c'est du texte? Un nombre ? Une date ? Une relation à un autre objet, un utilisateur par exemple ?).
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
 
-*   `models.CharField` - Cela nous permet de définir un champ texte avec un nombre limité de caractères.
-*   `models.TextField` - Cela nous permet de définir un champ texte sans limite de caractères. Parfait pour le contenu d'un blog post !
-*   `models.DateTimeField` - Définit que le champ en question est une date ou une heure.
-*   `models.ForeignKey` - C'est un lien vers un autre modèle.
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
 
-Malheureusement, nous n'avons pas le temps de vous expliquer tous les bouts de code que nous allons manipuler dans ce tutoriel. Si vous voulez en savoir un peu plus sur les différents champs disponibles dans les modèles ou que vous aimeriez définir quelque chose qui n'est pas listé dans les exemples ci-dessus, n'hésitez pas à consulter la documentation de Django (https://docs.djangoproject.com/fr/1.11/ref/models/fields/#field-types).
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
 
-Et sinon, c'est quoi `def publish(self):` ? Il s'agit de notre méthode `publish` dont nous parlions tout à l'heure. `def` signifie que nous créons une fonction/méthode qui porte le nom `publish`. Vous pouvez changer le nom de la méthode si vous le souhaitez. N'oubliez pas les règles de nommage et pensez à utiliser des minuscules et des tirets bas à la place des espaces. Par exemple, une méthode qui calcule le prix moyen d'un produit pourrait s'appeler `calcul_prix_moyen`.
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
 
-Les méthodes renvoient (`return`) souvent quelque chose. C'est le cas de la méthode `__str__`. Dans notre tutoriel, lorsque nous appellerons la méthode `__str__()`, nous allons obtenir du texte (**string**) avec un titre de Post.
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
 
-Si quelque chose ne vous parait pas clair au sujet des modèles, n'hésitez pas à demander à votre coach ! Cela peut être compliqué à comprendre la première fois, surtout lorsque l'on apprend les objets et les fonctions en même temps. Gardez espoir ! Avec le temps, tout cela vous paraitra de moins en moins magique et de plus en plus évident !
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
 
 ### Créer des tables pour votre modèle dans votre base de données
 
-La dernière étape pour cette section est d'ajouter notre nouveau modèle à notre base de données. Tout d'abord, nous devons signaler à Django que nous venons de créer notre modèle. Tapez `python manage.py makemigrations blog` dans votre console. Le résultat devrait ressembler à ça :
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py makemigrations blog
     Migrations for 'blog':
-      0001_initial.py:
+      blog/migrations/0001_initial.py:
+    
       - Create model Post
+    
 
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
 
-Django vient de nous préparer un fichier de migration que nous allons pouvoir appliquer dès maintenant à notre base de données. Pour cela, tapez `python manage.py migrate blog`. Normalement, vous devrez voir ceci s'afficher dans votre console :
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py migrate blog
     Operations to perform:
@@ -172,6 +194,6 @@ Django vient de nous préparer un fichier de migration que nous allons pouvoir a
     Running migrations:
       Rendering model states... DONE
       Applying blog.0001_initial... OK
+    
 
-
-Youpi ! Notre modèle Post est maintenant intégré à la base de données. Ce serait cool de voir à quoi il ressemble réellement ! Pour ça, il va falloir attaquer la section suivante ! Au boulot ;)!
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/fr/django_orm/README.md b/fr/django_orm/README.md
index 9ca9ec4c9dd..82a842d6c72 100755
--- a/fr/django_orm/README.md
+++ b/fr/django_orm/README.md
@@ -4,7 +4,7 @@ Dans ce chapitre, nous allons apprendre comment Django se connecte à la base de
 
 ## Qu'est-ce qu'un QuerySet ?
 
-Un QuerySet est, par essence, une liste d'objets d'un modèle donné. C'est ce qui vous permet de lire, trier et organiser, des données présentes dans une base de données.
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
 
 Il est plus simple d'apprendre avec un exemple. Et si nous nous intéressions à celui-ci ?
 
@@ -12,21 +12,28 @@ Il est plus simple d'apprendre avec un exemple. Et si nous nous intéressions à
 
 Ouvrez la console de votre ordinateur (et non celle de PythonAnywhere) et tapez la commande suivante :
 
-    (myvenv) ~/djangogirls$ python manage.py shell
+{% filename %}command-line{% endfilename %}
 
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
 
 Ceci devrait maintenant s'afficher dans votre console :
 
-    (InteractiveConsole)
-    >>>
+{% filename %}command-line{% endfilename %}
 
+```python
+(InteractiveConsole)
+>>>
+```
 
-Vous êtes maintenant dans la console interactive de Django. C'est comme celle de Python, mais avec toute la magie qu'apporte Django :). Du coup, les commandes Python sont aussi utilisables dans cette console.
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
 
 ### Lister tous les objets
 
 Essayons tout d'abord d'afficher tous nos posts. Vous pouvez le faire à l'aide de cette commande :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.all()
 Traceback (most recent call last):
@@ -34,59 +41,75 @@ Traceback (most recent call last):
 NameError: name 'Post' is not defined
 ```
 
-Ooops ! Voilà que ça nous renvoie une erreur qui nous dit qu'il n'existe pas de Post. En effet, nous avons oublié de commencer par un "import" !
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> from blog.models import Post
 ```
 
-Rien de compliqué : nous importons le modèle `Post` depuis notre `blog.models`. Essayons à nouveau la commande précédente :
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> Post.objects.all()
 <QuerySet [<Post: my post title>, <Post: another post title>]>
 ```
 
-Cela nous permet d'obtenir une liste des posts que nous avons créé tout à l'heure ! Rappelez-vous : nous avions créé ces posts à l'aide de l'interface d'administration de Django. Cependant, nous aimerions maintenant créer de nouveaux posts à l'aide de Python : comment allons-nous nous y prendre ?
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
 
 ### Créer des objets
 
 Voici comment créer un nouveau objet Post dans la base de données :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.create(author=me, title='Sample title', text='Test')
 ```
 
-Cependant, il nous manque un petit quelque chose : `me`. Nous avons besoin de lui passer une instance du modèle `User` en guise d'auteur (author). Comment faire ?
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
 
 Tout d'abord, il nous faut importer le modèle User :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> from django.contrib.auth.models import User
 ```
 
 Avons-nous des utilisateurs dans notre base de données ? Voyons voir :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> User.objects.all()
 <QuerySet [<User: ola>]>
 ```
 
-C'est le superutilisateur que nous avions créé tout à l'heure ! Essayons maintenant d'obtenir une instance de l'utilisateur :
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
-me = User.objects.get(username='ola')
+>>> me = User.objects.get(username='ola')
 ```
 
-Comme vous pouvez le voir, nous obtenons (`get`) un utilisateur (`User`) avec comme nom d'utilisateur (`username`) 'ola'. Cool ! Bien sûr, vous pouvez utiliser votre nom si vous le souhaitez.
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
 
 Nous allons enfin pouvoir créer notre post :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.create(author=me, title='Sample title', text='Test')
 ```
 
-Youpi ! Et si on vérifiait quand même si ça a marché ?
+Et voilà ! Vous aimeriez voir ci ça a vraiment marché ?
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> Post.objects.all()
@@ -97,46 +120,59 @@ Et voilà : un post de plus dans la liste !
 
 ### Ajouter plus de posts
 
-Amusez-vous à ajouter d'autres posts pour vous entrainer un peu. Essayez d'ajouter 2-3 posts en plus puis passez à la partie suivante.
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
 
 ### Filtrer les objets
 
-L'intérêt des QuerySets, c'est que l'on peut les filtrer. Disons que nous aimerions retrouver tous les posts écrits par l'utilisateur Ola. Pour cela, nous allons utiliser `filter` à la place de `all` dans `Post.objects.all()`. Les parenthèses vont nous servir à préciser quelles sont les conditions auxquelles un post de blog doit se conformer pour être retenu par notre QuerySet. Dans notre exemple, `author` est égal à `me`. La manière de le dire en Django c'est : `author=me`. Maintenant, votre bout de code doit ressembler à ceci:
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. Pour cela, nous allons utiliser `filter` à la place de `all` dans `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Maintenant, votre bout de code doit ressembler à ceci:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> Post.objects.filter(author=me)
 [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
 ```
 
-Et si nous voulions chercher les posts qui contiennent uniquement le mot "titre" dans le champs `title`?
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> Post.objects.filter(title__contains='title')
 [<Post: Sample title>, <Post: 4th title of post>]
 ```
 
-> **Note** Il y a deux tirets bas (`_`) entre `title` et `contains`. L'ORM de Django utilise cette syntaxe afin de séparer les noms de champ ("title") et les opérations ou les filtres ("contains"). Si vous n'utilisez qu'un seul tiret bas, vous allez obtenir une erreur du type : "FieldError: Cannot resolve keyword title_contains".
+> **Note** Il y a deux tirets bas (`_`) entre `title` et `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
 
-Comment obtenir une liste de tous les posts publiés ? Cela se fait facilement en filtrant tous les posts qui ont une date de publication, `published_date`, dans le passé :
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> from django.utils import timezone
 >>> Post.objects.filter(published_date__lte=timezone.now())
+[]
 ```
 
-Malheureusement, le post que nous avons créé dans la console Python n'est pas encore publié. Allons corriger ce problème ! Dans un premier temps, nous aimerions obtenir une instance du post que nous voulons publier :
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> post = Post.objects.get(title="Sample title")
 ```
 
-Ensuite, publions-le grâce à notre méthode `publish`!
+Ensuite, publions-le grâce à notre méthode `publish`:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> post.publish()
 ```
 
-Maintenant, essayez d'obtenir à nouveau la liste des posts publiés. Pour cela, appuyez trois fois sur la flèche du haut et appuyez sur `entrée` :
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> Post.objects.filter(published_date__lte=timezone.now())
@@ -145,7 +181,9 @@ Maintenant, essayez d'obtenir à nouveau la liste des posts publiés. Pour cela,
 
 ### Classer les objets
 
-Les QuerySets permettent aussi de trier la liste des objets. Essayons de les trier par le champ `created_date` :
+Les QuerySets permettent aussi de trier la liste des objets. Essayons de les trier par le champs `created_date` :
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> Post.objects.order_by('created_date')
@@ -154,6 +192,8 @@ Les QuerySets permettent aussi de trier la liste des objets. Essayons de les tri
 
 On peut aussi inverser l'ordre de tri en ajouter `-` au début:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.order_by('-created_date')
 [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
@@ -163,15 +203,16 @@ On peut aussi inverser l'ordre de tri en ajouter `-` au début:
 
 Vous pouvez aussi combiner les QuerySets and les **chainant** les unes aux autres :
 
-```python
->>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-```
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
 
 C'est un outil très puissant qui va vous permettre d'écrire des requêtes complexes.
 
 Génial ! Vous êtes maintenant prête à passer à l'étape suivante ! Pour fermer le shell, tapez ceci:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> exit()
 $
-```
+```
\ No newline at end of file
diff --git a/fr/django_start_project/README.md b/fr/django_start_project/README.md
index 16f3ce3a092..c1086d0e2ae 100755
--- a/fr/django_start_project/README.md
+++ b/fr/django_start_project/README.md
@@ -1,32 +1,46 @@
 # Votre premier projet Django !
 
-> Note : ce chapitre est en partie inspiré d'un autre tutoriel réalisé par les Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
->
-> Des morceaux de ce chapitre sont inspirés du [tutoriel django-marcador][1], disponible sous licence Creative Commons Attribution-ShareAlike 4.0 International. Le tutoriel django-marcador a été créé par Markus Zapke-Gründemann et al.
+> Une partie de ce chapitre s’inspire du tutoriel des Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Le tutoriel django-marcador a été créé par Markus Zapke-Gründemann et al.
 
- [1]: http://django-marcador.keimlink.de/
-
-Nous allons créer un petit blog !
+We're going to create a small blog!
 
 La première étape consiste à démarrer un nouveau projet Django. En gros, cela veut dire que nous allons lancer quelques scripts fournis par Django qui vont créer un squelette de projet Django. Il s'agit de fichiers et de dossiers que nous utiliserons par la suite.
 
-Il existe certains fichiers et dossiers dont les noms sont extrêmement importants pour Django. Il ne faut pas renommer les fichiers que nous sommes sur le point de créer. Ce n'est pas non plus une bonne idée de les déplacer. Django a besoin de maintenir une certaine structure pour retrouver les éléments importants.
+Il y existe certains fichiers et dossiers dont les noms sont extrêmement importants pour Django. Il ne faut pas renommer les fichiers que nous sommes sur le point de créer. Ce n'est pas non plus une bonne idée de les déplacer. Django a besoin de maintenir une certaine structure pour retrouver les éléments importants.
+
+> N'oubliez pas de tout exécuter dans votre virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. Nous vous avons expliqué comment faire ça dans le chapitre **Installation de Django**, dans la partie **Travailler avec virtualenv**. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
 
-> N'oubliez pas de tout exécuter dans votre virtualenv. Si vous ne voyez pas le préfixe `(myvenv)` dans votre console, vous avez besoin d'activer votre virtualenv. Nous vous avons expliqué comment faire ça dans le chapitre **Installation de Django**, dans la partie **Travailler avec virtualenv**. Tapez `myvenv\Scripts\activate` dans votre console Windows ou `source myvenv/bin/activate` dans celle de Mac OS ou Linux afin d'activer votre virtualenv.
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
 
-Retournons à la création de notre premier projet. Tapez la commande suivante dans votre console MacOS ou Linux. **N'oubliez pas le point `.`à la fin** :
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
 
+<!--endsec-->
 
-Pour les utilisatrices de Windows, tapez la commande suivante. **N'oubliez pas le point `.` à la fin** :
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
 
-    (myvenv) C:\Users\Name\djangogirls> django-admin startproject mysite .
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
 
+{% filename %}command-line{% endfilename %}
 
-> Le point `.` est très important : c'est lui qui permet de dire au script d'installer Django dans votre répertoire courant (le point `.` est une référence abrégée à celui-ci).
->
-> **Note** : lorsque vous tapez les commandes précédentes dans votre console, vous ne devez recopier que la partie qui commence par `django-admin` ou `django-admin.py`. Les `(myvenv) ~/djangogirls$` et `(myvenv) C:\Users\Name\djangogirls>` du tutoriel sont là pour vous rappeler que ces commandes doivent être tapées dans votre console.
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
 
 `django-admin.py` est un script qui crée les dossiers et fichiers nécessaires pour vous. Vous devriez maintenant avoir une structure de dossier qui ressemble à celle-ci:
 
@@ -37,9 +51,11 @@ Pour les utilisatrices de Windows, tapez la commande suivante. **N'oubliez pas l
             urls.py
             wsgi.py
             __init__.py
+    
 
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
 
-`manage.py` est un script qui aide à gérer le site. Il permet notamment de lancer un serveur web sur notre ordinateur sans rien installer d'autre.
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
 
 Le fichier `settings.py` contient la configuration de votre site web.
 
@@ -51,37 +67,57 @@ Ignorons les autres fichiers pour l'instant, nous n'allons pas avoir besoin d'y
 
 Apportons quelques changements à `mysite/settings.py`. Ouvrez le fichier avec l'éditeur de code que vous avez installé tout à l'heure.
 
-Ça serait sympa d'avoir l'heure correcte sur notre site Web. Allez sur [wikipedia timezones list][2] et copiez le fuseau horaire qui correspond le mieux à l'endroit où vous vous trouvez (TZ). (par exemple: `Europe/Paris`)
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+Ça serait sympa d'avoir l'heure correcte sur notre site Web. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
 
- [2]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+Change the language code by changing the following line:
 
-Dans settings.py, recherchez la ligne qui contient le `TIME_ZONE` et modifiez-la pour choisir votre propre fuseau horaire :
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-TIME_ZONE = 'Europe/Paris'
+LANGUAGE_CODE = 'de-ch'
 ```
 
-En remplaçant "Europe/Paris" par la valeur appropriée
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
 
-Nous allons aussi devoir ajouter un chemin d'accès pour les fichiers statiques (nous en apprendrons plus sur les fichiers statiques et CSS plus tard dans le tutoriel). Allez jusqu'à la *fin* du fichier et juste en dessous de la ligne `STATIC_URL`, ajoutez-en une nouvelle avec `STATIC_ROOT` :
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 STATIC_URL = '/static/'
 STATIC_ROOT = os.path.join(BASE_DIR, 'static')
 ```
 
-Quand `DEBUG` est à `True` et `ALLOWED_HOSTS` est vide, les ordinateurs qui sont autorisés à servir notre site web sont ceux de la liste `['localhost', '127.0.0.1', '[::1]']`. Plus loin dans ce tutorial, nous allons déployer le site web sur PythonAnywhere, donc nous allons anticiper un peu et ajouter le nom de domaine correspondant :
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-ALLOWED_HOSTS = ['127.0.0.1', '<your_username>.pythonanywhere.com']
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
 ```
 
-## Configuration de la base de données
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
 
-Il existe tout un tas de systèmes de gestion de bases de données qu'il est possible d'utiliser pour stocker les données de votre site. Nous allons utiliser celui par défaut : `sqlite3`.
+Il existe tout un tas de systèmes de gestion de bases de données qu'il est possible d'utiliser pour stocker les données de votre site. Nous allons va utiliser celui par défaut : `sqlite3`.
 
 Il est déjà configuré dans cette partie de votre fichier `mysite/settings.py`:
 
+{% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 DATABASES = {
     'default': {
@@ -93,51 +129,74 @@ DATABASES = {
 
 Pour créer la base de donnée de notre blog, il faut lancer la commande suivante dans la console : `python manage.py migrate` (vous avez besoin d'être dans le dossier `djangogirls` qui contient le fichier `manage.py`). Si tout se passe bien, vous devriez voir quelque chose comme ça:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py migrate
     Operations to perform:
-      Synchronize unmigrated apps: messages, staticfiles
-      Apply all migrations: contenttypes, sessions, admin, auth
-    Synchronizing apps without migrations:
-       Creating tables...
-          Running deferred SQL...
-       Installing custom SQL...
+      Apply all migrations: auth, admin, contenttypes, sessions
     Running migrations:
       Rendering model states... DONE
       Applying contenttypes.0001_initial... OK
       Applying auth.0001_initial... OK
       Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
       Applying contenttypes.0002_remove_content_type_name... OK
       Applying auth.0002_alter_permission_name_max_length... OK
       Applying auth.0003_alter_user_email_max_length... OK
       Applying auth.0004_alter_user_username_opts... OK
       Applying auth.0005_alter_user_last_login_null... OK
       Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
       Applying sessions.0001_initial... OK
-
+    
 
 Et voilà ! Il ne reste plus qu'à lancer le serveur et voir si notre site web fonctionne !
 
+## Starting the web server
+
 Pour cela, vous avez besoin d'être dans le dossier qui contient le fichier `manage.py` (le dossier `djangogirls`). Dans votre console, vous pouvez lancer le serveur en tapant `python manage.py runserver`:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py runserver
+    
 
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
 
 Si vous utilisez Windows et que vous obtenez l'erreur `UnicodeDecodeError`, tapez plutôt cette commande :
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
 
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
 
-Ensuite, il ne nous reste plus qu'à vérifier que votre site fonctionne. Pour cela, ouvrez votre navigateur (Firefox, Chrome, Safari, Internet Explorer, ou n'importe quel autre), et entrez l'adresse suivante :
+{% filename %}browser{% endfilename %}
 
     http://127.0.0.1:8000/
+    
 
+If you're using a Chromebook, you'll always visit your test server by accessing:
 
-Tant qu'il sera lancé, le serveur web va monopoliser votre console. Pour pouvoir taper de nouvelles commandes pendant que le serveur tourne, ouvrez une nouvelle console et activez à nouveau votre virtualenv. Pour arrêter votre serveur web, retournez dans la console où il se trouve et appuyez sur CTRL+C : maintenez les boutons Control et C enfoncés en même temps. Sous Windows, vous devrez peut-être appuyer sur CTRL+Arrêt défil.
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
 
 Bravo ! Vous venez de créer votre premier site web, et de le lancer avec un serveur web ! C'est génial, non?
 
-![Ça a marché !][3]
+![Ça a marché!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
 
- [3]: images/it_worked2.png
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
 
-Prête pour la suite ? Il est temps de créer du contenu!
+Prête pour la suite ? Il est temps de créer du contenu!
\ No newline at end of file
diff --git a/fr/django_templates/README.md b/fr/django_templates/README.md
index f9605fb119b..29bb5b0dcdd 100755
--- a/fr/django_templates/README.md
+++ b/fr/django_templates/README.md
@@ -4,9 +4,9 @@ Il est temps d'afficher des données ! Pour nous aider, Django fournit des balis
 
 ## Qu'est-ce que c'est que des balises de template ?
 
-En HTML, vous ne pouvez pas mettre directement du code Python car les navigateurs seraient incapables de le comprendre. Les navigateurs ne connaissent que le HTML. Nous vous avons signalé précédemment que HTML est du genre statique, alors que Python est bien plus dynamique.
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
 
-Les **Balises de template Django** nous permettent de transférer des choses ressemblant à du Python dans du HTML afin de nous permettre de construire des sites web plus rapidement et facilement. Cool, non ?
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
 ## Template d'affichage de la liste des posts
 
@@ -14,24 +14,28 @@ Dans le chapitre précédent, nous avons donné à notre template une liste de p
 
 Afin d'afficher une variable dans un template Django, nous utiliserons des doubles accolades avec le nom de la variable à l'intérieur. Ça ressemble à ceci :
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {{ posts }}
 ```
 
 Essayez de faire la même chose avec votre template `blog/templates/blog/post_list.html`. Remplacez tout ce qui se trouve entre la seconde balise `<div>` jusqu'au troisième `</div>` avec la ligne `{{ posts }}`. Sauvegardez votre fichier et rafraichissez votre page pour voir le résultat :
 
-![Figure 13.1][1]
-
- [1]: images/step1.png
+![Figure 13.1](images/step1.png)
 
 Comme vous pouvez le voir, tout ce que nous avons, c'est ceci :
 
-```python
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
 <QuerySet [<Post: My second post>, <Post: My first post>]>
 ```
 
 Cela signifie que Django l'interprète comme une liste d'objets. Essayez de vous rappeler comment afficher des listes en Python. Si vous avez un trou de mémoire, allez voir dans le chapitre **Introduction à Python**. Vous avez trouvé ? Avec des boucles ! Dans un template Django, vous pouvez les écrire de la façon suivante :
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     {{ post }}
@@ -40,11 +44,11 @@ Cela signifie que Django l'interprète comme une liste d'objets. Essayez de vous
 
 Essayez ceci dans votre template.
 
-![Figure 13.2][2]
+![Figure 13.2](images/step2.png)
 
- [2]: images/step2.png
+Ça marche ! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. Vous pouvez mixer HTML et balises de template. Notre `body` ressemble maintenant à ceci :
 
-Ça marche ! Cependant, nous aimerions plutôt les afficher à la manière des posts statiques, comme lorsque nous les avions créés dans le chapitre **Introduction au HTML**. Vous pouvez mixer HTML et balises de template. Notre `body` ressemble maintenant à ceci :
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <div>
@@ -53,7 +57,7 @@ Essayez ceci dans votre template.
 
 {% for post in posts %}
     <div>
-        <p>publié: {{ post.published_date }}</p>
+        <p>published: {{ post.published_date }}</p>
         <h1><a href="">{{ post.title }}</a></h1>
         <p>{{ post.text|linebreaksbr }}</p>
     </div>
@@ -62,18 +66,18 @@ Essayez ceci dans votre template.
 
 {% raw %}Tout ce qui se situe entre `{% for %}` et `{% endfor %}` va être répété pour chaque objet présent dans la liste. Rafraichissez votre page :{% endraw %}
 
-![Figure 13.3][3]
+![Figure 13.3](images/step3.png)
 
- [3]: images/step3.png
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? Nous accédons aux données associées à chaque champ défini dans notre modèle `Post`. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
 
-Avez-vous remarqué que nous utilisons une notation légèrement différente cette fois (`{{ post.title }}` or `{{ post.text }}`) ? Nous accédons aux données associées à chaque champ défini dans notre modèle `Post`. De même, les barres verticales `|` nous permettent de rediriger le texte des posts à travers un filtre qui convertit automatiquement les fins de lignes en paragraphes.
+## Une dernière chose
 
-## Encore une chose !
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
 
-Maintenant, ça serait bien de voir si votre site Web fonctionne toujours sur Internet. Nous allons essayer de le re-déployer sur PythonAnywhere. Voici un récapitulatif des étapes...
+* En premier lieu, envoyez votre code sur GitHub (push)
+
+{% filename %}command-line{% endfilename %}
 
-*   En premier lieu, envoyez votre code sur GitHub (push)
-```
     $ git status
     [...]
     $ git add --all .
@@ -82,25 +86,21 @@ Maintenant, ça serait bien de voir si votre site Web fonctionne toujours sur In
     $ git commit -m "Modified templates to display posts from database."
     [...]
     $ git push
-```
+    
 
-*   Ensuite, reconnectez-vous à [PythonAnywhere][4] et allez sur la "**Bash console**" (ou démarrez-en une nouvelle), et lancez les commandes suivantes :
+* Ensuite, reconnectez-vous à [PythonAnywhere](https://www.pythonanywhere.com/consoles/) et allez sur la "**Bash console**" (ou démarrer-en une nouvelle), et lancez les commandes suivantes :
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
 
- [4]: https://www.pythonanywhere.com/consoles/
-```
     $ cd my-first-blog
     $ git pull
     [...]
-```
-
-*   Finalement, allez sur l'[onglet Web][5] et cliquez sur **Reload** sur votre application web. Votre site mis-à-jour devrait être en ligne !
-
- [5]: https://www.pythonanywhere.com/web_app_setup/
+    
 
-Félicitations ! Maintenant, pourquoi ne pas essayer d'ajouter un nouveau post à l'aide de l'interface d'administration ? N'oubliez pas d'ajouter une date de publication ! Ensuite, rafraichissez votre page et regardez si votre post apparait.
+* Finalement, allez sur l'[onglet Web](https://www.pythonanywhere.com/web_app_setup/) et cliquez sur **Reload** sur votre application web. Votre site mis-à-jour devrait être en ligne ! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
 
-Ça a marché ? Nous sommes super fières de vous ! Éloignez vous un peu de votre clavier maintenant : vous avez mérité de faire une pause. :)
+Félicitations! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
 
-![Figure 13.4][6]
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
 
- [6]: images/donut.png
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/fr/django_urls/README.md b/fr/django_urls/README.md
index 93afdcca466..d2079a4bee3 100755
--- a/fr/django_urls/README.md
+++ b/fr/django_urls/README.md
@@ -1,21 +1,21 @@
-# Les urls Django
+# Django URLs
 
-Nous sommes sur le point de construire notre première page web : la page d'accueil de notre blog ! Avant de passer à la partie code, apprenons-en un peu plus sur les urls Django.
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
 
 ## Qu'est-ce qu'une URL ?
 
-Une URL est simplement une adresse web. Vous pouvez voir une URL à chaque fois que vous visitez un site web: l'URL se trouve dans la barre d'adresse (hé oui! `127.0.0.1:8000` est aussi une URL ! `https://djangogirls.org` est aussi une URL) :
+Une URL est simplement une adresse web. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` est aussi une URL ! And `https://djangogirls.org` is also a URL.)
 
-![Url][1]
+![Url](images/url.png)
 
- [1]: images/url.png
-
-Chaque page internet a besoin de sa propre URL. Cela permet à votre application de savoir ce qu'elle doit afficher à un utilisateur lorsqu'il entre une URL. Dans Django, nous utilisons un outil appelé `URLconf` (configuration des URLs) : c'est un ensemble de patterns que Django va essayer de faire correspondre avec l'URL reçue afin d'afficher la vue correspondante.
+Chaque page internet a besoin de sa propre URL. This way your application knows what it should show to a user who opens that URL. Dans Django, nous utilisons un outil appelé `URLconf` (configuration des URLs) : URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
 
 ## Comment les URLs fonctionnent-elles dans Django ?
 
 Ouvrons le fichier `mysite/urls.py` dans notre éditeur de code et regardons à quoi il ressemble :
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
 """mysite URL Configuration
 
@@ -29,55 +29,58 @@ urlpatterns = [
 ]
 ```
 
-Comme vous pouvez le voir, Django nous a déjà préparé une partie du travail.
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
 
-Les lignes encadrées par trois guillemets (`"""` ou `'''`) sont appelées docstrings ; nous pouvons les ajouter au début de nos fichiers, de nos classes ou de nos méthodes pour décrire ce qu'elles font. Ces lignes ne seront donc pas exécutées par Python.
+The admin URL, which you visited in previous chapter, is already here:
 
-Comme vous pouvez le voir, l'adresse de l'interface d'administration est déjà en place :
+{% filename %}mysite/urls.py{% endfilename %}
 
 ```python
     url(r'^admin/', admin.site.urls),
 ```
 
-Cela signifie que pour chaque URL qui commence par `admin/`, Django affichera la *vue* correspondante. Dans cet exemple, vous pouvez constater que toutes les URLs liées à l'interface d'administration sont contenues dans une seule ligne : en plus d'être pratique, cela rend notre fichier beaucoup plus propre et lisible.
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
 
 ## Regex
 
-Vous vous demandez sûrement comment Django arrive à faire correspondre les URLs aux vues correspondantes ? Bon, on respire un grand coup car ça va être un peu complexe. Django utilise des `regex` ("expressions régulières"). Les regex ont beaucoup (vraiment beaucoup ! ) de règles qui permettent de donner une description de la chaîne de caractères que l'on recherche (pattern). Étant donné que les regex sont un sujet avancé, nous ne rentrerons pas en détail dans leur fonctionnement.
+Vous vous demandez sûrement comment Django arrive à faire correspondre les URLs aux vues correspondantes ? Bon, on respire un grand coup car ça va être un peu complexe. Django utilise des `regex` ("expressions régulières"). Les regex ont beaucoup (vraiment beaucoup ! ) de règles qui permettent de donner une description de la chaine de caractères que l'on recherche (pattern). Étant donné que les regex sont un sujet avancé, nous ne rentrerons pas en détail dans leur fonctionnement.
 
-Si vous avez quand-même envie de comprendre comment nous avons créé nos patterns, vous pouvez lire ce qui va suivre. Dans notre exemple, nous allons utiliser un petit sous ensemble des règles disponibles pour écrire des patterns :
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
 
-    ^ -> le début du texte
-    $ -> la fin du texte
-    \d -> un chiffre
-    + -> indique que l'expression précédente doit se répéter au moins une fois
-    () -> capture une partie du pattern
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
 
+Anything else in the URL definition will be taken literally.
 
-Tout ce qui ne fait pas partie de ces règles et qui est présent dans la description de ce que l'on cherche sera interprété de manière littérale.
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
 
-Maintenant, imaginez que vous avez un site web qui a comme adresse : `http://www.mysite.com/post/12345/`. `12345` désigne le numéro de votre post.
+Ce serait vraiment pénible de devoir écrire une vue différente pour chaque post que nous aimerions rédiger. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
 
-Ce serait vraiment pénible de devoir écrire une vue différente pour chaque post que nous aimerions rédiger. Nous allons créer un pattern qui correspond à cette URL et qui nous permettra aussi d'extraire le numéro de post : `^post/(\d+)/$`. Décomposons-la morceau par morceau pour comprendre ce que nous faisons :
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** signifie qu'il y aura un nombre (un ou plusieurs chiffres) que nous souhaitons capturer et extraire
+* **/** dit à Django que le caractère `/` doit suivre le nombre
+* **$** marque la fin de l'URL, ce qui signifie que seules les chaines de caractères se terminant par `/` correspondrons au pattern
 
-*   **^ post /** indique à Django d'attraper toutes les url qui commencent par `post/` (juste après `^`)
-*   **(\d+)** signifie qu'il y aura un nombre (un ou plusieurs chiffres) que nous souhaitons capturer et extraire
-*   **/** dit à Django que le caractère `/` doit suivre le nombre
-*   **$** marque la fin de l'URL, ce qui signifie que seules les chaînes de caractères se terminant par `/` correspondrons au pattern
+## Your first Django URL!
 
-## Votre première URL Django !
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
 
-Bon, il est temps de créer votre première URL ! Nous voulons que "http://127.0.0.1:8000/" soit la page d’accueil de notre blog et qu'elle nous montre la liste des articles du blog.
-
-Nous aimerions aussi garder notre fichier `mysite/urls.py` propre. Pour cela, nous allons importer les URLs de notre application `blog` dans notre fichier principal `mysite/urls.py`.
-
-On y va : ajoutez une ligne qui va nous permettre d'importer `blog.urls` dans notre URL principale (`''`). Notez que nous utilisons ici la fonction `include` et qu'il est donc nécessaire de l'ajouter à l'import de la première ligne de notre fichier.
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
 
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
 
 Votre fichier `mysite/urls.py` devrait maintenant ressembler à ceci:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import include
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
@@ -88,39 +91,39 @@ urlpatterns = [
 
 Django va maintenant rediriger tout ce qui arrive sur "http://127.0.0.1:8000/" vers `blog.urls` puis regardera dans ce fichier pour y trouver la suite des instructions à suivre.
 
-En Python, les expressions régulière commencent toujours par `r` au début de la chaîne de caractères. Cela permet d'indiquer à Python que ce qui va suivre inclut des caractères qu'il ne doit pas interpréter en tant que code Python mais en tant qu'expression régulière.
+Writing regular expressions in Python is always done with `r` in front of the string. Cela permet d'indiquer à Python que ce qui va suivre inclus des caractères qu'il ne doit pas interpréter en tant que code python mais en tant qu'expression régulière.
 
 ## blog.urls
 
-Créez un nouveau fichier vide `blog/urls.py`. OK ! Ajoutez maintenant ces deux premières lignes :
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
 from . import views
 ```
 
-Nous venons d'importer les méthodes de Django dont nous avons besoin ainsi que toutes les `vues` liées à notre application `blog`. Cependant, nous n'avons pas encore créé de vues ! Pas de problème : nous y viendrons dans une minute
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
 
 Après ça, nous pouvons ajouter notre premier pattern d'URL:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
 ]
 ```
 
-Comme vous pouvez le voir, nous assignons une `vue` appelée `post_list` à l'URL `^$`. Décomposons cette expression régulière : `^` pour début suivie de `$` pour fin. Si nous mettons ces deux symboles ensemble, cela donne l'impression que nous sommes à la recherche d'une chaîne de caractères (string) vide. Ça tombe bien car c'est exactement ce que nous voulons ! En effet, l'URL resolver de Django ne considère pas 'http://127.0.0.1:8000/' comme faisant partie de l'URL. Ce pattern va donc indiquer à Django d'afficher la vue `views.post_list` à un utilisateur de votre site web qui se rendrait à l'adresse "http://127.0.0.1:8000/".
-
-La dernière partie, `name='post_list'`, est le nom de l'URL qui sera utilisée afin d'identifier la vue. Ce nom peut être le même que celui de la vue ou quelque chose de complètement différent. Plus tard dans ce tutoriel, nous allons utiliser les noms que nous avons donné à nos URLs. Il est donc important de donner un nom unique à chaque URL que nous créons. Pour vous faciliter la tâche, essayez de trouver des noms d'URLs simple à retenir.
-
-Est-ce que tout fonctionne toujours ? Ouvrez votre navigateur à l'adresse http://127.0.0.1:8000/ pour vérifier.
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. Ça tombe bien car c'est exactement ce que nous voulons ! En effet, l'URL resolver de Django ne considère pas 'http://127.0.0.1:8000/' comme faisant partie de l'URL. Ce pattern va donc indiquer à Django d'afficher la vue `views.post_list` à un utilisateur de votre site web qui se rendrait à l'adresse "http://127.0.0.1:8000/".
 
-![Erreur][2]
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. Ce nom peut être le même que celui de la vue ou quelque chose de complètement différent. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
 
- [2]: images/error1.png
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
 
-"It works" a disparu ! Ne vous en faites pas : ce que vous voyez est juste une page d'erreur. N'ayez pas peur des pages d'erreur, elles sont en fait très utiles :
+![Erreur](images/error1.png)
 
-Sur cette page, vous pouvez lire le message **no attribute 'post_list'** (il manque un attribut "post_list"). Est-ce que *post_list* vous rappelle quelque chose ? Yep, c'est le nom que nous avons donné à notre vue ! Cela signifie que nous avons posé les fondations mais, que nous n'avons pas encore créé notre *vue*. Pas de problème, on y vient :).
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
 
-> Si vous voulez en savoir plus au sujet de la configuration des URLs dans Django, vous pouvez aller consulter la documentation officielle du framework : https://docs.djangoproject.com/fr/1.11/topics/http/urls/
+> Si vous voulez en savoir plus au sujet de la configuration des URLs dans Django, vous pouvez aller consulter la documentation officielle du framework : https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/fr/django_views/README.md b/fr/django_views/README.md
index 429c93c1b3a..59c6827d442 100755
--- a/fr/django_views/README.md
+++ b/fr/django_views/README.md
@@ -1,8 +1,8 @@
-# Créons nos vues Django!
+# Django views – time to create!
 
-Il est enfin temps de se débarrasser du bug que nous avons créé dans le chapitre précédent :)
+Il est enfin temps de se débarrasser du bug que nous avons créé dans le chapitre précédent! :)
 
-C'est dans la *vue* que nous allons ranger toute la partie "logique" de notre application. C'est elle qui va se charger d'aller chercher les informations liées à notre `modèle `que nous venons de créer et de les passer à un `template`. Nous allons créer ce template dans le chapitre suivant. Concrètement, les vues ne sont que des méthodes Python un peu plus élaborées que celles que nous avons manipulées dans la partie **Introduction à Python**.
+C'est dans la *vue* que nous allons ranger toute la partie "logique" de notre application. C'est elle qui va se charger d'aller chercher les informations liées à notre `modèle `que nous venons de créer et de les passer à un `template`. Nous allons créer ce template dans le chapitre suivant. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
 
 Les vues sont placées dans le fichier `views.py`. Nous allons créer nos *vues* dans le fichier `blog/views.py`.
 
@@ -10,33 +10,35 @@ Les vues sont placées dans le fichier `views.py`. Nous allons créer nos *vues*
 
 Ok, allons-y ! Ouvrons ce fichier pour voir ce qu'il contient :
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
 # Create your views here.
 ```
 
-Il n'y pas encore grand chose dans ce fichier.
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
 
-Les lignes qui commencent par `#` permettent de commenter notre code : ces lignes ne seront donc pas exécutées par Python. Pratique, non ?
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
 
-La vue la plus simple que l'on peut créer ressemble à ceci :
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Comme vous pouvez le voir, nous avons créé une méthode (`def`) appelée `post_list` qui prend une `request (requête)` et `return (retourne)` une méthode `render` qui va permettre d'assembler tout ça selon notre template `blog/post_list.html`.
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
 
-Sauvegardez votre fichier et allez à l'adresse http://127.0.0.1:8000/ pour voir ce qui s'affiche maintenant.
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
 
 Une autre erreur ! Voyons ce qu'elle nous dit :
 
-![Erreur][1]
-
- [1]: images/error.png
+![Erreur](images/error.png)
 
-Celle-là est plutôt simple : *TemplateDoesNotExist*. Corrigeons ça en créant un template dans la section suivante !
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
 
-> Pour en apprendre un peu plus sur les vues dans Django, consultez la documentation officielle : https://docs.djangoproject.com/fr/1.11/topics/http/views/
+> Pour en apprendre un peu plus sur les vues dans Django, consultez la documentation officielle : https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/fr/dynamic_data_in_templates/README.md b/fr/dynamic_data_in_templates/README.md
index 137968bac8d..26f14635293 100755
--- a/fr/dynamic_data_in_templates/README.md
+++ b/fr/dynamic_data_in_templates/README.md
@@ -1,13 +1,15 @@
 # Données dynamiques dans les templates
 
-Nous avons différents morceaux en place : le modèle `Post` qui est définit dans le fichier `models.py`, la vue `post_list` dans `views.py` et nous venons de créer notre template. Mais comment allons-nous faire pour faire apparaître nos posts dans notre template HTML ? Car au final, n'est-ce pas le but que nous souhaiterions atteindre ? Nous aimerions prendre du contenu, en l’occurrence notre modèle sauvegardé dans notre base de données, et réussir à joliment l'afficher dans notre template.
+Nous avons différents morceaux en place : le modèle `Post` qui est définit dans le fichier `models.py`, la vue `post_list` dans `views.py` et nous venons de créer notre template. Mais comment allons-nous faire pour faire apparaître nos posts dans notre template HTML ? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
 
-C'est à ça que servent les *vues* : connecter les modèles et les templates. Dans notre *vue* `post_list`, nous allons avoir besoin de prendre les modèles dont nous avons besoin et de les passer au template. Concrètement, c'est dans la *vue* que nous allons décider ce qui va s'afficher (modèle) dans un template.
+C'est à ça que servent les *vues* : connecter les modèles et les templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
 
-Ok, et sinon, on fait comment ?
+OK, so how will we achieve this?
 
 Nous allons avoir besoin d'ouvrir le fichier `blog/views.py`. Pour l'instant, la *vue* `post_list` ressemble à ceci :
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
@@ -15,28 +17,34 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Est-ce que vous vous souvenez de comment rajouter des morceaux de code écrits dans d'autres fichiers ? Nous en avons parlé dans un chapitre précédent. Nous allons devoir importer notre modèle qui est défini dans le fichier `models.py`. Pour cela, nous allons ajouter la ligne `from .models import Post` de la façon suivante :
+Est-ce que vous vous souvenez de comment rajouter des morceaux de code écris dans d'autres fichiers ? Nous en avons parlé dans un chapitre précédent. Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
 from .models import Post
 ```
 
-Le point après `from` signifie le *dossier courant* ou *l'application courante*. Comme `views.py` et `models.py` sont dans le même dossier, nous pouvons tout simplement utiliser `.` et le nom du fichier, sans le `.py`. Ensuite, nous importons le modèle (`Post`).
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Ensuite, nous importons le modèle (`Post`).
 
-Ok, et après ? Afin de pouvoir aller chercher les véritables posts de blog de notre modèle `Post`, nous avons besoin de quelque chose qui s'appelle un `QuerySet`.
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
 
 ## QuerySet
 
-Normalement, ce mot doit vous évoquer quelque chose. Nous en avons un peu parlé dans la section [Django ORM (QuerySets)][1].
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
 
-Maintenant, nous allons nous intéresser à une liste de blog posts qui sont publiés et classés par date de publication (`published_date`). Ça tombe bien, on a déjà fait ça dans la section sur les QuerySets !
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
 ```
 
-Il ne nous reste plus qu'à mettre cette ligne de code à l'intérieur de notre fichier `blog/views.py`, dans la fonction `def post_list(request)` :
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
@@ -48,16 +56,16 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Veuillez noter que nous créons une *variable* pour notre QuerySet : `posts`. Considérez que c'est le nom de notre QuerySet. À partir de maintenant, nous allons pouvoir faire référence à notre QuerySet en utilisant ce nom.
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
 
-Notez aussi que notre code utilise la fonction `timezone.now()` que nous allons aussi devoir importer de `timezone`.
-
-Il nous manque encore un petit quelque chose : passer notre QuerySet `posts` à notre template. Nous nous intéresserons plus particulièrement à celui-ci dans la section suivante.
+Veuillez noter que nous créons une *variable* pour notre QuerySet : `posts`. Considérez que c'est le nom de notre QuerySet. À partir de maintenant, nous allons pouvoir faire référence à notre QuerySet en utilisant ce nom.
 
-Dans la fonction `render`, nous avons déjà un paramètre `request`, qui désigne tout ce que nous recevons d'un utilisateur par l'intermédiaire d'Internet, et un fichier template appelé `'blog/post_list.html'`. Le dernier paramètre, qui ressemble à `{}`, va nous permettre de glisser des instructions que notre template va suivre. Nous avons besoin par exemple de lui donner des noms : nous allons rester sur `'posts'` pour le moment :). Ça va ressembler à ça : `{'posts': posts}`. La partie située avant `:` est une chaîne de caractères : vous devez donc l'entourer de guillemets `''`.
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. Nous avons par exemple de lui donner des noms : nous allons rester sur `'posts'` pour le moment). :) Ça va ressembler à ça : `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
 
 Au final, notre fichier `blog/views.py` doit ressembler à ceci maintenant :
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from django.utils import timezone
@@ -70,6 +78,4 @@ def post_list(request):
 
 Et voilà, c'est bon ! Nous allons retourner du côté de notre template pour que notre QuerySet puisse s'afficher correctement !
 
-Si vous voulez en savoir plus sur les QuerySets, n'hésitez pas à consulter la documentation officielle du framework : https://docs.djangoproject.com/fr/1.11/ref/models/querysets/
-
- [1]: ../django_orm/README.md
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/fr/extend_your_application/README.md b/fr/extend_your_application/README.md
index 5489fff0887..4127d55b741 100755
--- a/fr/extend_your_application/README.md
+++ b/fr/extend_your_application/README.md
@@ -10,7 +10,7 @@ Nous avons déjà un modèle `Post`, nous n'avons donc pas besoin de retourner 
 
 ## Créer un lien dans un template
 
-Nous allons tout d'abord ajouter un lien à l'intérieur du fichier `blog/templates/blog/post_list.html`. Pour le moment, ce fichier doit ressembler à ceci :
+Nous allons commencer par ajouter un lien à l’intérieur du fichier `blog/templates/blog/post_list.html`. À ce stade, il devrait ressembler à ceci :{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -30,19 +30,21 @@ Nous allons tout d'abord ajouter un lien à l'intérieur du fichier `blog/templa
 
 {% raw %}Nous aimerions pouvoir cliquer sur le titre du post et arriver sur une page avec le contenu de celui-ci. Pour cela, changeons `<h1><a href="">{{ post.title }}</a></h1>` pour qu'il pointe vers la page de contenu du post :{% endraw %}
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
 ```
 
 {% raw %}C'est le moment parfait pour expliquer ce mystérieux `{% url 'post_detail' pk=post.pk %}`. Vous vous souvenez peut-être que la notation `{% %}` nous permet d'utiliser les balises de template Django. Cette fois, nous allons utiliser des balises qui vont s'occuper de créer des URLs à notre place !{% endraw %}
 
-`blog.views.post_detail` est le chemin d'accès vers la *vue* `post_detail` que nous aimerions créer. Attention : `blog` désigne notre application (le dossier `blog`) et `views` le fichier `views.py`. Enfin, `post_detail` est le nom de notre *vue*.
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
 
-Si nous essayons d'aller à http://127.0.0.1:8000/, nous allons rencontrez une erreur : nous n'avons pas d'URL ou de *vue* pour `post_detail`. L'erreur ressemble à ceci :
+Et qu’en est-il `pk=post.pk` ? `pk` est l’abréviation de clé primaire ("primary key" en anglais), qui est une référence unique pour chaque élément enregistré dans une base de données. Comme nous n'avons pas spécifiée de clé primaire dans notre modèle `Post`, Django en crée une pour nous (par défaut, un nombre qui augmente d’un pour chaque enregistrement, c'est-à-dire 1, 2, 3 etc..) et l’ajoute comme un champ nommé `pk` à chacun de nos posts. Nous accédons à la clé primaire en écrivant `post.pk`, de la même manière, que nous pouvons accéder autres champs (`titre`, `auteur`, etc...) dans notre objet de `Post` !
 
-![Erreur NoReverseMatch][1]
+Maintenant si on jette un coup d’œil à : http://127.0.0.1:8000/, nous rencontrons une erreur. Ceci est prévisible puisque nous n'avons pas d'URL ni de *view* pour `post_detail`. L'erreur ressemble à ceci :
 
- [1]: images/no_reverse_match2.png
+![Erreur NoReverseMatch](images/no_reverse_match2.png)
 
 ## Créer une URL vers le contenu d'un post
 
@@ -50,7 +52,9 @@ Allons créer notre URL dans le fichier `urls.py` pour notre *vue* `post_detail`
 
 Nous aimerions que le contenu de notre premier post s'affiche à cette **URL** : http://127.0.0.1:8000/post/1/
 
-Allons créer une URL dans le fichier `blog/urls.py` qui pointera Django vers une *vue* appelée `post_detail`. Cela nous permettra d'afficher l'intégralité d'un post de blog. Ajoutez la ligne `url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),` dans le fichier `blog/urls.py`. Votre fichier devrait maintenant ressembler à ceci :
+Allons créer une URL dans le fichier `blog/urls.py` qui pointera Django vers une *vue* appelée `post_detail`. Cela nous permettra d'afficher l'intégralité d'un post de blog. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. Votre fichier devrait maintenant ressembler à ceci :
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
@@ -58,62 +62,63 @@ from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
 ]
 ```
 
-`^post/(?P<pk>[0-9]+)/$` a l'air plutôt effrayant mais, ne vous inquiétez pas, décortiquons-le ensemble :
-*   Il commence par `^`, qui désigne le "début"
-*   `post/` signifie seulement qu'après le début, l'URL doit contenir le mot **post** et **/**. Jusque-là, tout va bien.
-*   `(?P<pk>[0-9]+)` : ok, là, on s'accroche :). Cela signifie que Django va prendre tout ce que vous placez là et le transférer à une vue sous la forme d'une variable appelée `pk`. `[0-9]` nous dit aussi que nous ne voulons que des nombres (tout ce qui est entre 0 et 9 inclus) et non des lettres. `+` signifie qu'il faut, au minimum, un chiffre à cet endroit. Du coup, quelque chose comme `http://127.0.0.1:8000/post//` n'est pas valide tandis que `http://127.0.0.1:8000/post/1234567890/` l'est complètement!
-*   `/` - nous avons encore besoin d'un **/**
-*   `$` - "la fin"!
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
 
-Concrètement, cela signifie que si vous entrez `http://127.0.0.1:8000/post/5/` dans votre barre d'adresse, Django va comprendre que vous cherchez à atteindre une *vue* appelée `post_detail` et qu'il doit communiquer l'information que `pk` est égal `5` dans cette *vue*.
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. Cela signifie que Django va prendre tout ce que vous placez là et le transférer à une vue sous la forme d'une variable appelée `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` signifie qu'il faut, au minimum, un chiffre à cet endroit. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
 
-`pk` est un raccourci pour `primary key`. Ce nom est très souvent utilisé dans les projets Django. Cependant, vous pouvez appeler cette variable comme bon vous semble, toujours dans la limite des règles suivantes : pas d'accents, pas de caractères spéciaux, des minuscules et des `_` à la place des espaces. Par exemple, à la place de `(?P<pk>[0-9]+)`, nous pourrions utiliser la variable `post_id`, ce qui donnerait : `(?P<post_id>[0-9]+)`.
-
-Comme nous venons d'ajouter un nouveau pattern d'URL au fichier `blog/urls.py`, rafraîchissons la page : http://127.0.0.1:8000/ Boom ! Encore une erreur ! Mais on s'y attendait ;)
+Concrètement, cela signifie que si vous entrez `http://127.0.0.1:8000/post/5/` dans votre barre d'adresse, Django va comprendre que vous cherchez à atteindre une *vue* appelée `post_detail` et qu'il doit communiquer l'information que `pk` est égal `5` dans cette *vue*.
 
-![AttributeError][2]
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
 
- [2]: images/attribute_error2.png
+![AttributeError](images/attribute_error2.png)
 
 Est-ce que vous vous souvenez de ce que nous devons faire ensuite ? Il falloir ajouter une vue !
 
 ## Ajouter une vue pour le contenu du post
 
-Cette fois, nous allons donner un paramètre supplémentaire à notre *vue* : `pk`. Notre *vue* va avoir besoin de le récupérer. Pour cela, nous allons définir une fonction : `def post_detail(request, pk):`. Attention : notez bien que nous utilisons le même nom que celui que nous avons spécifié dans le fichier url (`pk`). Oublier cette variable est incorrecte et va générer une erreur !
+This time our *view* is given an extra parameter, `pk`. Notre *vue* va avoir besoin de le récupérer. Pour cela, nous allons définir une fonction : `def post_detail(request, pk):`. Attention : notez bien que nous utilisons le même nom que celui que nous avons spécifié dans le fichier url (`pk`). Oublier cette variable est incorrect et va générer une erreur !
 
-Maintenant, nous n'aimerions obtenir qu'un seul blog post. Pour cela, nous allons utiliser des QuerySets qui ressemblent à ceux-ci:
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 Post.objects.get(pk=pk)
 ```
 
-Cependant, il y a un petit problème dans cette ligne de code. Si aucun de nos `Posts` ne possède cette `primary key (clef primaire)` (`pk`), nous allons nous retrouver avec une super erreur bien cracra!
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
 
-![Erreur DoesNotExist][3]
+![Erreur DoesNotExist](images/does_not_exist2.png)
 
- [3]: images/does_not_exist2.png
+Dans l'idéal, nous aimerions pouvoir éviter ça! Comme d'habitude, Django nous offre l'outil parfait pour ça : `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
 
-Dans l'idéal, nous aimerions pouvoir éviter ça! Comme d'habitude, Django nous offre l'outil parfait pour ça : `get_object_or_404`. Dans le cas où il n'existerait pas de `Post` avec le `pk` indiqué, une page d'erreur beaucoup plus sympathique s'affichera : c'est ce qu'on appelle une `erreur 404 : page non trouvée`.
+![Page non trouvée](images/404_2.png)
 
-![Page non trouvée][4]
+La bonne nouvelle, c'est que vous pouvez créer vous-mêmes votre page `Page non trouvée` et en faire ce que vous voulez ! Reconnaissez que ce n'est pas le plus important pour le moment donc nous allons zapper cette partie ;).
 
- [4]: images/404_2.png
+OK, time to add a *view* to our `views.py` file!
 
-La bonne nouvelle, c'est que vous pouvez créer vous-mêmes votre page `Page non trouvée` et en faire ce que vous voulez ! Reconnaissez que ce n'est pas le plus important pour le moment donc nous allons zapper cette partie ;).
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
 
-Ok, ajoutons notre *vue* à notre fichier `views.py`!
+We should open `blog/views.py` and add the following code near the other `from` lines:
 
-Ouvrons le fichier `blog/views.py` et ajoutons le code suivant:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render, get_object_or_404
 ```
 
-Cette ligne est à ajouter en dessous des lignes `from` situées en début de fichier. Ensuite, à la fin de notre fichier, nous allons ajouter notre *vue* proprement dite:
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_detail(request, pk):
@@ -123,23 +128,21 @@ def post_detail(request, pk):
 
 Hop, réactualisons la page http://127.0.0.1:8000/
 
-![Vue post_list][5]
+![Vue post_list](images/post_list2.png)
 
- [5]: images/post_list2.png
+C'est bon, ça a marché ! Mais que ce passe-t-il lorsque nous cliquons sur un lien dans un titre de blog post ?
 
-C'est bon, ça a marché ! Mais que se passe-t-il lorsque nous cliquons sur un lien dans un titre de blog post ?
-
-![Erreur TemplateDoesNotExist][6]
-
- [6]: images/template_does_not_exist2.png
+![Erreur TemplateDoesNotExist](images/template_does_not_exist2.png)
 
 Oh non ! Encore une erreur ! Mais cette fois, vous savez quoi faire : nous avons besoin d'un template !
 
-## Créer un template pour le contenu du post
+## Create a template for the post details
 
 Nous allons créer un fichier `post_detail.html` dans le dossier `blog/templates/blog`.
 
-Ça ressemblera à ça :
+Le résultat devrait ressembler à ça :
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -159,13 +162,11 @@ Nous allons créer un fichier `post_detail.html` dans le dossier `blog/templates
 
 Une nouvelle fois, nous faisons hériter de `base.html`. Dans le `content` block, nous voulons que s'affiche la date de publication d'un post (si elle existe), son titre et son texte. Mais vous souhaitez peut-être quelques éclaircissements avant, non?
 
-{% raw %}`{% if ... %} ... {% endif %}` est une balise de template que nous pouvons utiliser si nous voulons vérifier quelque chose : souvenez-vous de `if ... else ..` de la section **Introduction à Python**. Dans ce scénario, nous aimerions vérifier si la date de publication d'un post (`published_date`) n'est pas vide.{% endraw %}
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
 
 Ok, vous pouvez maintenant rafraîchir votre page et voir si la page `Page not found` a enfin disparu.
 
-![Page détaillée d'un post][7]
-
- [7]: images/post_detail2.png
+![Page détaillée d'un post](images/post_detail2.png)
 
 Yay ! Ça marche!
 
@@ -173,27 +174,24 @@ Yay ! Ça marche!
 
 Nous ferions bien de mettre à jour la version de notre site présente sur PythonAnywhere. On s'accroche et on déploie encore une fois :)
 
+{% filename %}command-line{% endfilename %}
+
     $ git status
     $ git add --all .
     $ git status
     $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
     $ git push
+    
 
+Puis, dans la console bash de [PythonAnywhere](https://www.pythonanywhere.com/consoles/):
 
-*   Puis, dans la console bash de [PythonAnywhere][8]:
-
- [8]: https://www.pythonanywhere.com/consoles/
+{% filename %}command-line{% endfilename %}
 
     $ cd my-first-blog
-    $ source myvenv/bin/activate
-    (myvenv)$ git pull
-    [...]
-    (myvenv)$ python manage.py collectstatic
+    $ git pull
     [...]
+    
 
+Enfin, cliquez sur l'onglet [Web](https://www.pythonanywhere.com/web_app_setup/) et cliquez sur **Reload**.
 
-*   Enfin, cliquez sur l'onglet [Web][9] et cliquez sur **Reload**.
-
- [9]: https://www.pythonanywhere.com/web_app_setup/
-
-Normalement, ça devrait suffire ! Encore bravo :)
+Normalement, ça devrait suffire ! Encore bravo :)
\ No newline at end of file
diff --git a/fr/how_the_internet_works/README.md b/fr/how_the_internet_works/README.md
index 4445c403ad0..215698ade78 100644
--- a/fr/how_the_internet_works/README.md
+++ b/fr/how_the_internet_works/README.md
@@ -1,52 +1,47 @@
 # Comment fonctionne l'Internet ?
 
-> Ce chapitre est inspiré par la présentation "How the Internet works" par Jessica McKellar (http://web.mit.edu/jesstess/www/).
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
 
-Vous utilisez sûrement Internet tous les jours. Mais savez-vous ce qu'il ce passe vraiment quand vous tapez une adresse comme https://djangogirls.org dans votre navigateur et appuyez sur `Entrée` ?
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
 
 Avant tout, il faut savoir qu'un site web n'est rien de plus qu'un tas de fichiers sauvegardés sur un disque dur. Exactement comme vos vidéos, vos musiques ou vos photos. Cependant, les sites web ont quelque chose d'unique : ils contiennent du code informatique appelé HTML.
 
 Si vous n'avez pas l'habitude de la programmation, il peut être difficile de comprendre HTML au début, mais vos navigateurs web (comme Chrome, Safari, Firefox, etc.) adorent ça. Les navigateurs web sont conçus pour comprendre ce code, pour suivre les instructions qu'il contient et présenter les fichiers de votre site web exactement comme vous voulez qu'ils soient présentés.
 
-Comme pour n'importe quel autre fichier, il faut stocker les fichiers HTML sur un disque dur quelque part. Pour Internet, on utilise des ordinateurs spéciaux, très puissants, appelés *serveurs*. Ils n'ont pas d'écran, de clavier ou de souris, car leur rôle est de stocker des données, et de les servir. C'est pour ça qu'on les appelle des *serveurs* -- parce qu'ils sont là pour vous *servir* des données.
+Comme pour n'importe quel autre fichier, il faut stocker les fichiers HTML sur un disque dur quelque part. Pour Internet, on utilise des ordinateurs spéciaux, très puissants, appelés *serveurs*. Ils n'ont pas d'écran, de clavier ou de souris, car leur rôle est de stocker des données, et de les servir. That's why they're called *servers* – because they *serve* you data.
 
-Bon, d'accord. Mais vous avez envie de savoir à quoi Internet ressemble, n'est-ce-pas ?
+OK, but you want to know how the Internet looks, right?
 
-On va a fait un dessin ! Internet ressemble à ça :
+Nous vous avons fait un dessin ! Voilà à quoi ça ressemble :
 
-![Figure 1.1][1]
+![Figure 1.1](images/internet_1.png)
 
- [1]: images/internet_1.png
+C'est le bazar, non ? In fact it is a network of connected machines (the above-mentioned *servers*). Des centaines de milliers de machines ! Des millions de kilomètres de câbles, partout dans le monde ! Vous pouvez aller voir une carte des câbles sous-marins (http://submarinecablemap.com/) pour voir à quel point le réseau est compliqué. Voici une capture d'écran du site :
 
-C'est le bazar, non ? En fait, c'est un réseau de machines connectées entre elles (les *serveurs* dont on parlait plus tôt). Des centaines de milliers de machines ! Des millions de kilomètres de câbles, partout dans le monde ! Vous pouvez aller voir une carte des câbles sous-marins (http://submarinecablemap.com/) pour voir à quel point le réseau est compliqué. Voici une capture d'écran du site :
+![Figure 1.2](images/internet_3.png)
 
-![Figure 1.2][2]
-
- [2]: images/internet_3.png
-
-Fascinant, non ? Cependant, il n'est évidemment pas possible de tirer un câble entre chaque machine connectée à Internet. Du coup, pour atteindre une machine (par exemple, celle où https://djangogirls.org est sauvegardé), on doit faire passer une requête par plein d'autres machines.
+Fascinant, non ? Cependant, il n'est évidemment pas possible de tirer un câble entre chaque machine connectée à Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
 
 Ça ressemble ça :
 
-![Figure 1.3][3]
-
- [3]: images/internet_2.png
+![Figure 1.3](images/internet_2.png)
 
-C'est un peu comme si, quand vous tapiez https://djangogirls.org, vous envoyiez une lettre qui dit "Chères Django Girls, je voudrais voir le site djangogirls.org. Pouvez-vous me l'envoyer ?"
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
 
 Votre lettre part vers le bureau de poste le plus proche. Ensuite, il file vers un autre, qui est plus proche de votre destinataire. Puis un autre, et encore un autre, jusqu'à sa destination. Une chose à retenir : si vous envoyez beaucoup de lettres (*data packets*) au même endroit, il se pourrait qu'elles transitent par des postes différentes (*routers*). Cela dépend de la manière dont elles sont distribuées à chaque bureau de poste.
 
-![Figure 1.4][4]
+![Figure 1.4](images/internet_4.png)
 
- [4]: images/internet_4.png
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
 
-Oui oui, c'est aussi simple que ça. Vous envoyez des messages et attendez une réponse. Alors, bien sûr, le papier et le crayon sont remplacés par des octets de données, mais l'idée est la même.
+À la place des adresses postales (nom de rue, ville, code postal), nous utilisons des adresses IP. Votre ordinateur commence par demander au DNS (Domaine Name System) de traduire djangogirls.org en une adresse IP. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
 
-À la place des adresses postales (nom de rue, ville, code postal), nous utilisons des adresses IP. Votre ordinateur commence par demander au DNS (Domaine Name System) de traduire djangogirls.org en une adresse IP. Ça marche un peu comme un de ces vieux annuaires où l'on peut chercher le nom d'une personne et trouver son numéro de téléphone et son adresse.
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Vous devez aussi utiliser une langue que votre destinataire comprend. C'est la même chose pour les paquets de données que vous envoyez pour voir un site web. Vous utilisez un protocole appelé HTTP (Hypertext Tranfer Protocol).
 
-Quand vous envoyez une lettre, elle a besoin de certaines choses pour transiter correctement, comme une adresse et un timbre. Vous devez aussi utiliser une langue que votre destinataire comprend. C'est la même chose pour les paquets de données que vous envoyez pour voir un site web. Vous utilisez un protocole appelé HTTP (Hypertext Tranfer Protocol).
+Donc, au final, pour avoir un site web il faut qu'il soit sur un *serveur* (c'est une machine). Lorsque le *serveur* reçoit une *requête/0> (dans une lettre), il envoie votre site Web (dans une autre lettre).</p> 
 
-Donc, au final, pour avoir un site web il faut qu'il soit sur un *serveur* (c'est une machine). Lorsque le *serveur* reçoit une *requête* (dans une lettre), il envoie votre site Web (dans une autre lettre).
-Puisqu'on est dans un tutoriel sur Django, vous devez vous demander ce que Django fait. Quand vous envoyez une réponse, vous ne renvoyez pas toujours la même réponse à tout le monde. C'est bien mieux quand les lettres sont personnalisées, surtout quand elles s'adressent à quelqu'un qui vient de vous écrire, non ? Et bien Django vous aide à écrire les lettres personnalisées et intéressantes :).
+Since this is a Django tutorial, you might ask what Django does. Quand vous envoyez une réponse, vous ne renvoyez pas toujours la même réponse à tout le monde. C'est bien mieux quand les lettres sont personnalisées, surtout quand elles s'adressent à quelqu'un qui vient de vous écrire, non ? Et bien Django vous aide à écrire les lettres personnalisées et intéressantes. :)
 
-Assez parlé, il est temps de commencer à créer des trucs !
\ No newline at end of file
+Enough talk – time to create!
\ No newline at end of file
diff --git a/fr/html/README.md b/fr/html/README.md
index 9b06a7f8817..9862f9c073e 100755
--- a/fr/html/README.md
+++ b/fr/html/README.md
@@ -2,13 +2,13 @@
 
 Vous vous demandez sûrement ce qu'est un template.
 
-Un template est un fichier que vous pouvez réutiliser afin de présenter des informations différentes sous un seul et même format. Par exemple, vous pourriez avoir envie d'utiliser un template pour écrire une lettre : bien que son contenu varie ou qu'elle puisse être adressée à des personnes différentes, sa forme reste la même.
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
 
-Le format d'un template Django est décrit grâce à un langage qui s'appelle HTML (c'est le même HTML que celui dont nous parlions dans le chapitre un, **Comment fonctionne l'Internet**).
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
 
 ## Qu'est-ce que le HTML ?
 
-HTML est un code simple qui est interprété par votre navigateur (Chrome, Firefox ou Safari) et qui permet d'afficher une page web à l'utilisateur.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
 L'abréviation HTML signifie « HyperText Markup Language ». **HyperText** signifie que c'est un type de texte qui supporte les hyperliens entre les pages. **Markup** signifie que nous avons pris un document et que nous avons balisé le code pour signifier (ici, au navigateur) comment il faut interpréter la page. Le code HTML est construit à l'aide de **balises**, chacune commençant par `<` et finissant par `>`. Ces balises représentent des **éléments** markup.
 
@@ -21,24 +21,24 @@ Les templates sont sauvegardés dans le dossier `blog/templates/blog`. Tout d'ab
     blog
     └───templates
         └───blog
+    
 
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
 
-Vous pourriez vous demander pourquoi nous avons besoin de deux dossiers portant tous les deux le nom `blog`. Comme vous le découvrirez plus tard, c'est une simple convention de nommage qui va nous faciliter la vie quand les choses vont commencer à devenir compliquées.
-
-Et maintenant, créez un fichier `post_list.html` (laisser le vide pour le moment) dans le dossier `blog/templates/blog`.
+Et maintenant, créez un fichier `post_list.html` (laisser le vide pour le moment) dans le dossier `templates/blog/blog`.
 
 Allons regarder à quoi ressemble notre site maintenant : http://127.0.0.1:8000/
 
-> Si vous avez une erreur `TemplateDoesNotExists`, essayez de redémarrer votre serveur. Prenez votre ligne de commande et arrêtez votre serveur en appuyant simultanément sur Ctrl+C (les touches Control et C de votre clavier). Vous pouvez le relancer en tapant la commande `python manage.py runserver`.
-
-![Figure 11.1][1]
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
 
- [1]: images/step1.png
+![Figure 11.1](images/step1.png)
 
 Et voilà, il n'y a plus d'erreurs ! Bravo :) Cependant, notre site ne peut rien faire d'autre pour le moment qu'afficher une page blanche. La faute à notre template que nous avons laissé vide. Allons corriger ça.
 
 Ajoutez ce qui suit à votre fichier template :
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <p>Hi there!</p>
@@ -46,33 +46,33 @@ Ajoutez ce qui suit à votre fichier template :
 </html>
 ```
 
-Alors, à quoi ressemble notre site web maintenant ? Allons le découvrir : http://127.0.0.1:8000/
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
 
-![Figure 11.2][2]
-
- [2]: images/step3.png
+![Figure 11.2](images/step3.png)
 
 Ça marche ! Bon boulot :)
 
-*   La balise la plus élémentaire, `<html>`, figure toujours au début de n'importe quelle page web tandis que `</html>` est toujours située à la fin. Comme vous pouvez le constater, l'intégralité du contenu de notre page web est située entre la balise de départ, `<html>`, et la balise fermante, `</html>`
-*   `<p>` est la balise pour les éléments de type paragraphe. `</p>` permet de fermer chaque paragraphe.
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. Comme vous pouvez le constater, l'intégralité du contenu de notre page web est située entre la balise de départ, `<html>`, et la balise fermante, `</html>`
+* `<p>` est la balise pour les éléments de type paragraphe. `</p>` permet de fermer chaque paragraphe.
 
-## Head & body
+## Head and body
 
-Chaque page HTML est divisée en deux éléments : **head** (entête) et **body** (corps).
+Chaque page HTML est divisée en deux éléments : **head** (entête) et **body** (corps.
 
-*   **head** est un élément qui contient des informations sur le document : son contenu ne s'affichera pas à l'écran.
+* **head** est un élément qui contient des informations sur le document : son contenu ne s'affichera pas à l'écran.
 
-*   **body** est un élément qui contient tout le reste. Son contenu s'affichera à l'écran et constituera notre page web.
+* **body** est un élément qui contient tout le reste. Son contenu s'affichera à l'écran et constituera notre page web.
 
 Nous utilisons `<head>` pour transmettre la configuration de la page au navigateur tandis que `<body>` l'informe sur le contenu de la page.
 
-Par exemple, vous pouvez donner un titre à votre site en utilisant l'élément titre dans le `<head>` :
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
     <head>
-        <title>Le Blog d'Ola</title>
+        <title>Ola's blog</title>
     </head>
     <body>
         <p>Hi there!</p>
@@ -83,9 +83,7 @@ Par exemple, vous pouvez donner un titre à votre site en utilisant l'élément
 
 Sauvegardez votre fichier et actualisez la page.
 
-![Figure 11.3][3]
-
- [3]: images/step4.png
+![Figure 11.3](images/step4.png)
 
 Vous avez vu comment le navigateur a compris que « Le Blog d'Ola » est le titre de votre page ? Il a interprété `<title>Le blog d'Ola</title>` et a placé ce texte dans la barre de titre de votre navigateur (c'est ce titre qui va être aussi utilisé lorsque vous créez un marque-page, etc.).
 
@@ -93,23 +91,26 @@ Vous avez aussi probablement remarqué que chaque balise ouvrante possède sa *b
 
 Pensez à lorsque vous mettez des choses à l'intérieur de boîtes. Vous avez une grosse boîte, `<html></html>`; à l'intérieur de celle-ci, on trouve une plus petite boîte, `<body></body>`, qui contient elle-même d'autres petites boîtes, `<p></p>`.
 
-Essayez de vous rappeler cet exemple lorsque vous utilisez les balises *fermantes* et que vous avez des éléments *imbriqués*. Si vous ne suivez pas ces règles, votre navigateur risque de ne pas être capable d'interpréter votre code correctement et risque de mal afficher votre page web.
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
 
 ## Personnaliser votre template
 
 Et si nous en profitions pour nous amuser un peu ? Essayons de personnaliser notre template ! Voici quelques balises que vous pouvez utiliser :
 
-*   `<h1>Titre 1</h1>` - pour vos titres les plus importants
-*   `<h2>Titre 2</h2>` - pour les sous-titres
-*   `<h3>Titre 3</h3>` ... et ainsi de suite jusqu'à `<h6>`
-*   `<em>texte</em>` permet de mettre l'accent sur une partie du texte
-*   `<strong>texte</strong>` permet de mettre encore plus l'accent sur une partie de texte
-*   `<br />` permet d'insérer un saut de ligne (vous ne pouvez rien mettre à l'intérieur d'un élément br)
-*   `<a href="https://djangogirls.org">link</a>` permet de créer un lien
-*   `<ul><li>premier item</li><li>second item</li></ul>` permet de créer des listes, comme celle que nous sommes en train de faire !
-*   `<div></div>` permet de créer une section au sein de la page
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>Titre 2</h2>` - pour les sous-titres
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>texte</em>` permet de mettre l'accent sur une partie du texte
+* `<strong>texte</strong>` permet de mettre encore plus l'accent sur une partie de texte
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` permet de créer un lien
+* `<ul><li>premier item</li><li>second item</li></ul>` permet de créer des listes, comme celle que nous sommes en train de faire !
+* `<div></div>` permet de créer une section au sein de la page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
 
-Voici un exemple de template utilisant plusieurs balises :
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -118,7 +119,7 @@ Voici un exemple de template utilisant plusieurs balises :
     </head>
     <body>
         <div>
-            <h1><a href="">Django Girls Blog</a></h1>
+            <h1><a href="/">Django Girls Blog</a></h1>
         </div>
 
         <div>
@@ -138,18 +139,16 @@ Voici un exemple de template utilisant plusieurs balises :
 
 Nous avons créé trois sections à l'aide de `div`.
 
-*   Le premier `div` contient le titre de notre blog - c'est à la fois un titre et un lien
-*   Les deux autres `div` contiennent nos posts avec leur date de publication, un titre de post `h2` qui est cliquable ainsi que deux `p` (paragraphe) de texte : un pour la date et l'autre pour notre post.
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Les deux autres `div` contiennent nos blogposts avec leur date de publication, un titre de post `h2` qui est cliquable ainsi que deux `p`s (paragraphe) de texte : un pour la date et l'autre pour notre blogpost.
 
 Ce qui nous donne :
 
-![Figure 11.4][4]
+![Figure 11.4](images/step6.png)
 
- [4]: images/step6.png
+Yaaay ! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
 
-Yaaay ! Pour l'instant, notre template nous permet seulement d'afficher les **mêmes informations** alors que nous disions précédemment qu'il doit nous permettre d'afficher des informations **différentes** utilisant le **même format**.
-
-Ce qu'on aimerait pouvoir maintenant, c'est afficher les posts que nous avons créés précédemment dans l'interface d'administration de Django. Penchons-nous là dessus.
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
 
 ## Une dernière chose : déployer !
 
@@ -159,51 +158,56 @@ Ne serait-il pas génial de pouvoir voir tout ces changements en ligne ? Hop, d
 
 Tout d'abord, allons voir quels sont les fichiers qui ont changé depuis notre dernier déploiement (lancez ces commandes dans votre console locale et non celle de PythonAnywhere) :
 
-    $ git status
+{% filename %}command-line{% endfilename %}
 
+    $ git status
+    
 
 Assurez-vous que vous êtes bien dans le dossier `djangogirls`. Voici la commande qui permet de dire à `git` d'inclure tout les changements qui ont eu lieu dans ce dossier :
 
+{% filename %}command-line{% endfilename %}
+
     $ git add --all .
+    
 
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Essayez de vous rappeler du chapitre 3 : `.` permet de désigner le dossier courant.
 
-> **Note** `--all` (traduction de "tout") signifie que `git` va aussi analyser si vous avez supprimé des fichiers (par défaut, il ne s'intéresse qu'aux nouveaux fichiers ou à ceux modifiés). Essayez de vous rappeler du chapitre 3 : `.` permet de désigner le dossier courant.
+Avant que nous puissions uploader nos fichiers, regardons ce que `git` à l'intention de faire (tous les fichiers que `git` va uploader vont apparaître en vert) :
 
-Avant que nous puissions uploader nos fichiers, regardons ce que `git` à l'intention de faire (tous les fichiers que `git` va uploader vont apparaitre en vert) :
+{% filename %}command-line{% endfilename %}
 
     $ git status
-
+    
 
 On y est presque : nous devons maintenant lui dire de sauvegarder ces changements dans son historique. Nous allons y ajouter un "message de commit" qui nous permettra de décrire ce qui a été changé. Vous pouvez mettre ce que vous voulez dans un message de commit. Généralement, il est préférable de mettre quelque chose d'utile qui vous permettra de vous souvenir plus tard de ce que vous avez fait.
 
-    $ git commit -m "Modification du HTML du site"
+{% filename %}command-line{% endfilename %}
 
+    $ git commit -m "Modification du HTML du site"
+    
 
 > **Note** N'oubliez pas d'utiliser de doubles guillemets autour de votre message de commit.
 
-Une fois que nous avons fait cela, nous pouvons mettre en ligne (pusher) nos modifications sur GitHub :
+Once we've done that, we upload (push) our changes up to GitHub:
 
-    git push
+{% filename %}command-line{% endfilename %}
 
+    $ git push
+    
 
 ### Puller les modifications sur PythonAnywhere et recharger son appli web
 
-*   Allez sur la page des [consoles de PythonAnywhere][5]. Retournez dans votre **console Bash** ou ouvrez-en une nouvelle puis tapez la commande suivante :
+* Allez sur la page des [consoles de PythonAnywhere](https://www.pythonanywhere.com/consoles/). Retournez dans votre **console Bash** ou ouvrez-en une nouvelle puis tapez la commande suivante :
 
- [5]: https://www.pythonanywhere.com/consoles/
+{% filename %}command-line{% endfilename %}
 
     $ cd ~/my-first-blog
-    $ source myvenv/bin/activate
-    (myvenv)$ git pull
-    [...]
-    (myvenv)$ python manage.py collectstatic
+    $ git pull
     [...]
-
+    
 
 Voilà ! Votre code modifié est téléchargé. Si vous voulez vérifier ce que vous venez de récupérer, vous pouvez aller jeter un coup d’œil dans l'onglet **Files** de PythonAnywhere.
 
-*   Pour finir, n'oubliez pas de recharger votre application web : onglet [web][6] puis cliquez sur le bouton **Reload**.
-
- [6]: https://www.pythonanywhere.com/web_app_setup/
+* Pour finir, n'oubliez pas de recharger votre application web : onglet [web](https://www.pythonanywhere.com/web_app_setup/) puis cliquez sur le bouton **Reload**.
 
-Retournez sur votre site en cliquant sur l'adresse en haut de la page : normalement, vous devriez voir la dernière version. Si ce n'est pas le cas, ce n'est pas grave : n'hésitez pas à demander de l'aide à votre coach :)
+Retournez sur votre site en cliquant sur l'adresse en haut de la page : normalement, vous devriez voir la dernière version. Si ce n'est pas le cas, ce n'est pas grave : n'hésitez pas à demander de l'aider à votre coach. :)
\ No newline at end of file
diff --git a/fr/install_git.md b/fr/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/fr/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/fr/installation/README.md b/fr/installation/README.md
index d00a4e6805f..f29db8a699a 100644
--- a/fr/installation/README.md
+++ b/fr/installation/README.md
@@ -1,10 +1,10 @@
 # Si vous suivez ce tutoriel chez vous
 
-Si vous suivez ce tutoriel chez vous et non dans un [évènement Django Girls](https://djangogirls.org/events/), vous pouvez passer directement au chapitre [Comment fonctionne l'Internet ?](../how_the_internet_works/README.md).
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
 
-Les informations données ici sont couvertes dans le reste du tutoriel. Cette partie permet simplement de regrouper au même endroit tout ce qu'il est nécessaire d'installer avant de participer à un évènement. Les évènements Django Girls incluent une "soirée d'installation" qui permet de prendre un peu d'avance sur la journée de formation proprement dite.
+Les informations données ici sont couvertes dans le reste du tutoriel. Cette partie permet simplement de regrouper au même endroit tout ce qu'il est nécessaire d'installer avant de participer à un évènement. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
 
-Rien ne vous empêche de tout installer maintenant si vous le souhaitez. Cependant, si vous avez envie d'apprendre des choses avant d'installer plein de trucs sur votre ordinateur : passez ce chapitre et installez ce dont vous avez besoin au fil des chapitres.
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
 
 Bonne chance !
 
@@ -12,6 +12,11 @@ Bonne chance !
 
 Pendant l'atelier, vous allez apprendre à construire un blog. Afin d'être prête pour le jour J, vous devrez installer les éléments listés sur cette page.
 
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
 # Installer Python
 
 {% include "/python_installation/instructions.md" %}
@@ -30,7 +35,7 @@ Pendant l'atelier, vous allez apprendre à construire un blog. Afin d'être prê
 
 # Créer un compte GitHub
 
-Allez sur [GitHub.com](https://www.github.com) et créez-vous un nouveau compte gratuitement.
+Si vous ne l'avez pas encore fait, allez sur [GitHub.com](https://www.github.com) et créez-vous un nouveau compte gratuitement.
 
 # Créer un compte PythonAnywhere
 
@@ -40,10 +45,14 @@ Allez sur [GitHub.com](https://www.github.com) et créez-vous un nouveau compte
 
 Félicitations, vous avez tout installé et êtes prête ! Si vous avez toujours du temps avant l'atelier, il peut être utile de commencer à lire les premiers chapitres :
 
-  * [Comment fonctionne l'Internet ?](../how_the_internet_works/README.md)
+* [Comment fonctionne l'Internet ?](../how_the_internet_works/README.md)
+
+* [Introduction à la ligne de commande](../intro_to_command_line/README.md)
+
+* [Introduction à Python](../python_introduction/README.md)
 
-  * [Introduction à la ligne de commande](../intro_to_command_line/README.md)
+* [Qu'est-ce que Django?](../django/README.md)
 
-  * [Introduction à Python](../python_introduction/README.md)
+# Enjoy the workshop!
 
-  * [Qu'est-ce que Django?](../django/README.md)
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/fr/instructions.md b/fr/instructions.md
new file mode 100644
index 00000000000..d042926b29a
--- /dev/null
+++ b/fr/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for you instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/fr/intro_to_command_line/README.md b/fr/intro_to_command_line/README.md
index 358d60a21c6..802924f61ec 100755
--- a/fr/intro_to_command_line/README.md
+++ b/fr/intro_to_command_line/README.md
@@ -1,72 +1,110 @@
 # Introduction à l'interface en ligne de commande
 
-C'est un peu exaltant, non ? Dans quelques instants, vous allez écrire votre première ligne de code :)
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
 
 **Commençons par vous présenter un nouvel ami : la ligne de commande !**
 
-Les étapes suivantes vont vous montrer comment utiliser la fenêtre noire que tous les bidouilleurs·euses utilisent. Elle est un peu effrayante à première vue, mais en fait, c'est tout simplement un programme qui attend qu'on lui donne des commandes.
+Les étapes suivantes vont vous montrer comment utiliser la fenêtre noire que tous les bidouilleurs·euses utilisent. Elle est un peu effrayante à première vue, mais en fait, c'est un tout simplement un programme qui attend qu'on lui donne des commandes.
 
-> **Note :** Il existe deux mots pour parler de dossier : dossier ou répertoire. Il se peut que nous utilisions les deux dans le tutoriel mais, pas de panique : ils signifient la même chose.
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
 
 ## Qu'est-ce qu'une ligne de commande ?
 
-Cette fenêtre, qu'on appelle aussi **ligne de commande** ou **interface en ligne de commande**, est une application textuelle qui permet de voir et de manipuler des fichiers sur votre ordinateur. C'est un peu la même chose que l'Explorateur Windows ou Finder dans Mac, mais sans interface graphique. On l'appelle parfois aussi : *cmd*, *CLI*, *prompt*, *console* ou *terminal*.
+Cette fenêtre, qu'on appelle aussi **ligne de commande** ou **interface en ligne de commande**, est une application textuelle qui permet de voir et de manipuler des fichiers sur votre ordinateur. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. On l'appelle parfois aussi : *cmd*, *CLI*, *prompt*, *console* ou *terminal*.
 
 ## Ouvrir l'interface en ligne de commande
 
 Pour commencer à expérimenter, nous avons d'abord besoin d'ouvrir notre interface en ligne de commande.
 
-### Windows
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
 
-Aller dans Menu démarrer → Tous les programmes → Accessoires → Invite de commandes.
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
 
-### Mac OS X
+Go to Applications → Utilities → Terminal.
 
-Applications → Utilitaires → Terminal.
+<!--endsec-->
 
-### Linux
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
 
-Vous la trouverez probablement dans Applications → Accessoires → Terminal, mais ça dépend de votre système. Si elle n'est pas là, demandez à Google :)
+Vous la trouverez probablement dans Applications → Accessoires → Terminal, mais ça dépend de votre système. Si elle n'est pas là, demandez à Google. :)
+
+<!--endsec-->
 
 ## Prompt
 
 Vous devriez maintenant voir une fenêtre noire ou blanche qui attend vos commandes.
 
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
 Si vous être sous Mac ou Linux, vous verrez probablement un `$`, comme ça :
 
+{% filename %}command-line{% endfilename %}
+
     $
+    
 
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
 
 Sur Windows, c'est un signe `>`, comme ça :
 
+{% filename %}command-line{% endfilename %}
+
     >
+    
+
+<!--endsec-->
+
+Chaque commande commence par ce signe, puis un espace. Mais vous n'avez pas besoin de le taper, votre ordinateur le fait pour vous. :)
 
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
 
-Chaque commande commence par ce signe, puis un espace. Mais vous n'avez pas besoin de le taper, votre ordinateur le fait pour vous :)
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
 
-> Petite remarque : il se peut que vous voyiez quelque chose comme `C:\Users\ola>` ou `Olas-MacBookAir:~ola$` avant le signe de prompt. Pas de problème : c'est parfaitement normal. C'est juste parce que dans ce tutoriel, nous tentons de simplifier les choses autant que possible.
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
 
 ## Votre première commande (YAY !)
 
-Commençons par quelque chose de simple. Tapez la commande suivante :
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ whoami
+    
+
+<!--endsec-->
 
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
 
-ou
+{% filename %}command-line{% endfilename %}
 
     > whoami
+    
 
+<!--endsec-->
 
 Puis, appuyez sur la touche `entrée`. Voilà ce qui s'affiche chez moi :
 
+{% filename %}command-line{% endfilename %}
+
     $ whoami
     olasitarska
+    
 
+Comme vous pouvez le voir, l'ordinateur vient d'afficher votre nom d'utilisateur. Sympa, non? :)
 
-Comme vous pouvez le voir, l'ordinateur vient d'afficher votre nom d'utilisateur. Sympa, non ? ;)
-
-> Essayez de taper chaque commande sans copier-coller. Ça aide à les retenir !
+> Try to type each command; do not copy-paste. You'll remember more this way!
 
 ## Les bases
 
@@ -76,19 +114,31 @@ Les différents systèmes d'exploitation ont des commandes légèrement différe
 
 Ce serait pratique de savoir dans quel répertoire nous nous trouvons. Pour le savoir, tapez la commande suivante et appuyez sur `entrée` :
 
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ pwd
     /Users/olasitarska
+    
+
+> Remarque : "pwd" veut dire "print working directory" (afficher le dossier courant).
+
+<!--endsec-->
 
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
 
-Si vous êtes sous Windows :
+{% filename %}command-line{% endfilename %}
 
     > cd
     C:\Users\olasitarska
+    
 
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
 
-Vous verrez probablement quelque chose de similaire sur votre machine. Quand vous ouvrez une ligne de commande, vous démarrez habituellement dans le dossier personnel de votre utilisateur.
+<!--endsec-->
 
-> Remarque : "pwd" veut dire "print working directory" (afficher le dossier courant).
+Vous verrez probablement quelque chose de similaire sur votre machine. Quand vous ouvrez une ligne de commande, vous démarrez habituellement dans le dossier personnel de votre utilisateur.
 
 * * *
 
@@ -96,15 +146,23 @@ Vous verrez probablement quelque chose de similaire sur votre machine. Quand vou
 
 Du coup, que pouvons-nous trouver dans ce dossier personnel ? Pour le savoir, essayons ceci :
 
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ ls
     Applications
     Bureau
     Musique
     Téléchargements
     ...
+    
+
+<!--endsec-->
 
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
 
-Windows :
+{% filename %}command-line{% endfilename %}
 
     > dir
      Directory of C:\Users\olasitarska
@@ -113,7 +171,9 @@ Windows :
     05/08/2014 07:28 PM <DIR>      Musique
     05/08/2014 07:28 PM <DIR>      Téléchargements
     ...
+    
 
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
 
 * * *
 
@@ -121,29 +181,49 @@ Windows :
 
 Maintenant, essayons d'aller sur notre bureau :
 
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ cd Bureau
+    
+
+<!--endsec-->
 
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
 
-Windows :
+{% filename %}command-line{% endfilename %}
 
     > cd Bureau
+    
 
+<!--endsec-->
 
 Vérifions que ça a bien changé :
 
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ pwd
     /Users/olasitarska/Bureau
+    
 
+<!--endsec-->
 
-Windows :
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd
     C:\Users\olasitarska\Bureau
+    
 
+<!--endsec-->
 
 Et voilà !
 
-> Pro tip : si vous tapez `cd B` puis que vous appuyez sur la touche `tabulation`, la ligne de commande va automatiquement compléter le reste du nom. Cela va vous permettre d'aller plus vite et d'éviter des fautes de frappe. Si plusieurs dossiers commencent par un « B », appuyez sur `tabulation` deux fois pour avoir une liste des options.
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
 
 * * *
 
@@ -151,15 +231,25 @@ Et voilà !
 
 Que diriez-vous de créer un répertoire dédié aux exercices sur votre bureau ? Vous pouvez le faire de cette façon :
 
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ mkdir exercices
+    
 
+<!--endsec-->
 
-Windows :
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > mkdir exercices
+    
 
+<!--endsec-->
 
-Cette petite commande crée un dossier nommé `exercices` sur votre bureau. Vous pouvez vérifier qu'il est bien là en regardant votre bureau, ou en lançant la commande `ls` ou `dir` ! Essayez donc :)
+Cette petite commande crée un dossier nommé `exercices` sur votre bureau. Vous pouvez vérifier qu'il est bien là en regardant votre bureau, ou en lançant la commande `ls` ou `dir` ! Essayez donc. :)
 
 > Pro tip : Si vous voulez éviter de taper les mêmes commandes plein de fois, essayez d'appuyer sur les touches `flèche haut` et `flèche bas` pour retrouver les dernières commandes que vous avez tapé.
 
@@ -167,23 +257,33 @@ Cette petite commande crée un dossier nommé `exercices` sur votre bureau. Vous
 
 ### Un peu d'exercice !
 
-Petit défi pour vous : dans votre nouveau dossier `exercices`, créez un dossier appelé `test`. Pour ça, utilisez les commandes `cd` et `mkdir`.
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
 
 #### Solutions :
 
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ cd exercices
     $ mkdir test
     $ ls
     test
+    
+
+<!--endsec-->
 
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
 
-Windows :
+{% filename %}command-line{% endfilename %}
 
     > cd exercices
     > mkdir test
     > dir
     05/08/2014 07:28 PM <DIR>      test
+    
 
+<!--endsec-->
 
 Félicitations ! :)
 
@@ -195,65 +295,114 @@ Supprimons tout ce qu'on vient de faire, histoire d'éviter de laisser du bazar.
 
 D'abord, revenons au Bureau :
 
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ cd ..
+    
 
+<!--endsec-->
 
-Windows :
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
 
-    > cd ..
+{% filename %}command-line{% endfilename %}
 
+    > cd ..
+    
 
+<!--endsec-->
 
-Grâce à `..` et la commande `cd`, vous pouvez aller directement dans le dossier parent de votre répertoire courant (c'est à dire le dossier qui contient le dossier dans lequel vous étiez).
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
 
 Vérifiez où vous êtes :
 
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ pwd
     /Users/olasitarska/Bureau
+    
+
+<!--endsec-->
 
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
 
-Windows :
+{% filename %}command-line{% endfilename %}
 
     > cd
     C:\Users\olasitarska\Bureau
+    
 
+<!--endsec-->
 
 Maintenant, il est temps de supprimer notre dossier `exercices` :
 
-> **Attention** : Supprimer des fichiers avec `del`, `rmdir` ou `rm` est irrévocable, ce qui veut dire que *les fichiers supprimés sont perdus à jamais* ! Du coup, faites très attention avec cette commande.
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ rm -r exercices
+    
+
+<!--endsec-->
 
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
 
-Windows :
+{% filename %}command-line{% endfilename %}
 
     > rmdir /S exercices
     exercices, Are you sure <Y/N>? Y
+    
 
+<!--endsec-->
 
 Et voilà. Pour être sure que le dossier a bien été supprimé, vérifiez :
 
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ ls
+    
 
+<!--endsec-->
 
-Windows :
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > dir
+    
 
+<!--endsec-->
 
 ### Sortir
 
-C'est tout pour le moment ! Vous pouvez maintenant fermer la ligne de commande. Faisons-le à la manière des bidouilleurs⋅euses. :)
+C'est tout pour le moment ! Vous pouvez maintenant fermer la ligne de commande. Faisons-le à la manière des bidouilleurs⋅euses? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ exit
+    
+
+<!--endsec-->
 
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
 
-Windows :
+{% filename %}command-line{% endfilename %}
 
     > exit
+    
 
+<!--endsec-->
 
-Cool, non ? :)
+Cool, non? :)
 
 ## Résumé
 
@@ -261,20 +410,20 @@ Voici un résumé de quelques commandes utiles :
 
 | Commande (Windows) | Commande (Mac OS / Linux) | Description                 | Exemple                                           |
 | ------------------ | ------------------------- | --------------------------- | ------------------------------------------------- |
-| exit               | exit                      | ferme la fenêtre            | **exit**                                          |
+| sortir             | sortir                    | ferme la fenêtre            | **sortir**                                        |
 | cd                 | cd                        | change le dossier courant   | **cd test**                                       |
+| cd                 | pwd                       | show the current directory  | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
 | dir                | ls                        | liste des fichiers/dossiers | **dir**                                           |
 | copy               | cp                        | copie un fichier            | **copy c:\test\test.txt c:\windows\test.txt** |
 | move               | mv                        | déplace un fichier          | **move c:\test\test.txt c:\windows\test.txt** |
 | mkdir              | mkdir                     | crée un nouveau dossier     | **mkdir testdirectory**                           |
-| del                | rm                        | supprime un dossier/fichier | **del c:\test\test.txt**                        |
+| rmdir (or del)     | rm                        | delete a file               | **del c:\test\test.txt**                        |
+| rmdir /S           | rm -r                     | delete a directory          | **rm -r testdirectory**                           |
 
 Ce ne sont que quelques-unes des commandes que vous pouvez utiliser dans votre ligne de commande. Cette liste est suffisante pour réaliser ce tutoriel.
 
-Si vous êtes curieuse, [ss64.com][1] contient une référence complète de toutes les commandes pour tous les systèmes d'exploitation.
-
- [1]: http://ss64.com
+Si vous êtes curieuse, [ss64.com](http://ss64.com) contient une référence complète de toutes les commandes pour tous les systèmes d'exploitation.
 
 ## Vous êtes prête ?
 
-Nous allons plonger dans Python !
+Nous allons plonger dans Python !
\ No newline at end of file
diff --git a/fr/python_installation/README.md b/fr/python_installation/README.md
index 47e71cbd43a..cd6f3b1d170 100755
--- a/fr/python_installation/README.md
+++ b/fr/python_installation/README.md
@@ -4,10 +4,12 @@ On est parti !
 
 Tout d'abord, laissez-nous vous en dire un peu plus sur Python. Python est un langage de programmation très populaire qui peut être utilisé pour créer des sites web, des jeux, des logiciels scientifiques, des graphiques et bien d'autres choses encore.
 
-Python a été créé à la fin des années 1980. l'objectif principal des créateurs du langage était de rendre ce langage de programmation lisible aussi bien par des humains que par des machines. Par conséquent, il a l'air beaucoup plus simple à lire que d'autres langages de programmation. Cependant, ne vous fiez pas à son apparente simplicité de lecture et d'apprentissage : Python est un langage très puissant !
+Python a été créé à la fin des années 1980. l'objectif principal des créateurs du langage était de rendre ce langage de programmation lisible aussi bien par des humains que par des machines. This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
 
 # Installation de Python
 
-> **Note** : Si vous avez suivi la partie installation du tutoriel, vous n'avez pas besoin d'installer Python à nouveau. Vous pouvez sauter cette partie et passer au chapitre suivant !
+> **Note** Si vous utilisez un Chromebook, passez ce chapitre et prenez soin de suivre les instructions de [configuration pour Chromebook](../chromebook_setup/README.md).
+> 
+> **Note** Si vous avez déjà réalisé les étapes d'installation, vous ne devez pas refaire la procédure - vous pouvez passer directement au prochain chapitre!
 
 {% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/fr/python_installation/instructions.md b/fr/python_installation/instructions.md
index bf25d129da4..2affe3c332a 100644
--- a/fr/python_installation/instructions.md
+++ b/fr/python_installation/instructions.md
@@ -1,59 +1,106 @@
-> Note : ce sous-chapitre est en partie inspiré d'un autre tutoriel réalisé par les Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> Cette section repose sur un tutoriel de Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
 
-Django est écrit en Python. Pour réaliser quelque chose en Django, il va nous falloir Python. Commençons par installer ce dernier ! Pour ce tutoriel, nous utilisons la version 3.4 de Python. Si vous avez une version antérieure, il va falloir la mettre à jour.
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
 
-### Windows
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
 
-Vous pouvez télécharger Python pour Windows sur le site web https://www.python.org/downloads/release/python-343/. Après avoir téléchargé le fichier ***.msi**, lancez-le en double-cliquant sur son icône et suivez les instructions qui s'affichent à l'écran. Attention : il est important de se souvenir du chemin d'accès (le dossier) où vous avez installé Python. Vous en aurez besoin plus tard.
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
 
-Une chose à laquelle vous devez faire attention : dans le second écran de l'installateur intitulé "Customize", assurez-vous de bien dérouler l'écran jusqu'en bas et de choisir l'option "Ajouter python.exe au chemin", comme sur l'image ci dessous :
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
 
-![N'oubliez pas d'ajouter Python à votre chemin (path)](../python_installation/images/add_python_to_windows_path.png)
+![N'oubliez pas d'ajouter Python à votre chemin (path)](../python_installation/images/python-installation-options.png)
 
-### Linux
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+Vous devez aller sur le site https://www.python.org/downloads/release/python-361/ et télécharger l'installateur python:
+
+* Téléchargez le fichier *Mac OS X 64-bit/32-bit installer*,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
 
 Il est très probable que Python soit déjà installé sur votre machine. Afin de vérifier qu'il est bien installé (et surtout quelle version vous avez), ouvrez une console et tapez la commande suivante :
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 --version
-    Python 3.4.3
+    Python 3.6.1
     
 
-Si Python n'est pas installé ou que vous avez une version différente, vous pouvez l'installer en suivant les instructions suivantes :
+Si vous avez installé une "micro" version particulière de Python, par exemple la 3.6.0, alors plus besoin de la mettre à niveau. Si Python n'est pas installé ou que vous avez une version différente, vous pouvez l'installer en suivant les instructions suivantes :
+
+<!--endsec-->
 
-#### Debian ou Ubuntu
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
 
 Tapez cette commande dans votre terminal :
 
-    $ sudo apt-get install python3.4
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
     
 
-#### Fedora
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
 
 Tapez cette commande dans votre terminal :
 
-    $ sudo dnf install python3.4
+{% filename %}command-line{% endfilename %}
+
+    sudo dnf install python3
     
 
-#### openSUSE
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
 
-Tapez cette commande dans votre terminal :
+<!--endsec-->
 
-    $ sudo zypper install python3
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Tapez cette commande dans votre terminal :
 
+{% filename %}command-line{% endfilename %}
 
-### OS X
+    $ sudo zypper install python3
+    
 
-Vous devez aller sur le site https://www.python.org/downloads/release/python-343/ et télécharger l'installateur Python :
+<!--endsec-->
 
-  * Téléchargez le fichier *Mac OS X 64-bit/32-bit installer*,
-  * Double-cliquez sur le fichier *python-3.4.3-macosx10.6.pkg* pour lancer l'installateur.
+Verify the installation was successful by opening a command prompt and running the `python3` command:
 
-Vérifiez que l'installation s'est bien déroulée en ouvrant votre *Terminal* et en lançant la commande `python3`:
+{% filename %}command-line{% endfilename %}
 
     $ python3 --version
-    Python 3.4.3
+    Python 3.6.1
     
 
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
 * * *
 
-Si vous avez des questions ou si quelque chose ne fonctionne pas et que vous ne savez pas quoi faire : demandez de l'aide à votre coach ! Il arrive parfois que les choses ne se déroulent pas comme prévu et il est alors préférable de demander à quelqu'un qui a plus d'expérience.
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Il arrive parfois que les choses ne se déroulent pas comme prévu et il est alors préférable de demander à quelqu'un qui a plus d'expérience.
\ No newline at end of file
diff --git a/fr/python_introduction/README.md b/fr/python_introduction/README.md
index 4e454f5c6e3..800e48c7af4 100755
--- a/fr/python_introduction/README.md
+++ b/fr/python_introduction/README.md
@@ -1,57 +1,75 @@
 # Introduction à Python
 
-> Note : ce chapitre est en partie inspiré d'un autre tutoriel réalisé par les Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> Une partie de ce chapitre s’inspire du tutoriel des Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 
 Allons écrire du code !
 
 ## Le prompt Python
 
-Pour commencer à jouer avec Python, nous avons besoin d'ouvrir une *ligne de commande* sur votre ordinateur. Normalement, vous savez déjà comment le faire -- vous l'avez appris dans le chapitre [Introduction à la ligne de commande][1].
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
 
- [1]: ../intro_to_command_line/README.md
+Pour commencer à jouer avec Python, nous avons besoin d'ouvrir une *ligne de commande* sur votre ordinateur. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
 
 Dès que vous êtes prête, suivez les instructions suivantes.
 
 Afin d'ouvrir une console Python, tapez `python` sous Windows ou `python3` sous Mac OS/Linux et appuyez sur `entrée`.
 
-```python
-$ python3
-Python 3.4.3 (...)
-Type "help", "copyright", "credits" or "license" for more information.
->>>
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
 
 ## Votre première commande Python !
 
-Après avoir lancé la commande Python, votre prompt (ou invite de commandes) s'est changé en `>>>`. Cela signifie que maintenant, les seules commandes que nous pouvons taper sont dans le langage Python. Vous n'avez pas besoin de taper `>>>` - Python fait ça pour vous.
+Après avoir lancé la commande Python, votre prompt (ou invite de commandes) s'est changé en `>>>`. Cela signifie que maintenant, les seules commandes que nous pouvons taper sont dans le langage Python. You don't have to type in `>>>` – Python will do that for you.
+
+Quand vous voudrez sortir de la console Python, tapez `exit()` ou utilisez le raccourcit `Ctrl + Z` pour Windows ou `Ctrl + D` pour Mac/Linux. Après ça, vous ne verrez plus le `>>>`.
 
-Quand vous voudrez sortir de la console Python, tapez `exit()` ou utilisez le raccourci `Ctrl + Z` pour Windows ou `Ctrl + D` pour Mac/Linux. Après ça, vous ne verrez plus le `>>>`.
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
 
-Pour le moment, nous ne voulons pas quitter la console Python car nous nous aimerions mieux la connaitre. Démarrons avec quelque chose de vraiment simple. Par exemple, faisons un peu de math : tapez `2 + 3` et appuyez sur `entrée`.
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> 2 + 3
 5
 ```
 
-Pas mal ! Vous voyez comment la réponse est sortie ? Python sait faire des maths ! Vous pouvez essayer d'autres commandes comme : - `4 * 5` - `5 - 1` - `40 / 2`
+Pas mal, non ? Vous avez vu comment la réponse a surgi ? Python s'y connait en math ! Vous pouvez essayer d’autres commandes comme :
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
 
-Amusez-vous un peu avec ça, et revenez ici après :).
+Amusez-vous un peu avec ça, et revenez ici après. :)
 
-Comme vous pouvez le constater, Python est une très bonne calculette. Comme vous vous en doutez, il est aussi capable de faire autre chose ...
+As you can see, Python is a great calculator. If you're wondering what else you can do…
 
-## Chaînes de caractères (Strings)
+## Chaines de caractères (Strings)
 
 Et si nous essayions avec votre nom ? Tapez votre prénom entre guillemets, comme cela :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Ola"
 'Ola'
 ```
 
-Vous venez de créer votre première chaîne de caractères ! C'est une suite de caractères qui peut être traitée par un ordinateur. Une chaîne de caractères doit toujours commencer et terminer par le même caractère. Cela peut être un guillemet simple (`'`) ou un guillemet double (`"`), ça n'a pas d'importance. Cela permet à Python de savoir que tout ce qui se trouve à l'intérieur de ces guillemets est une chaîne de caractères.
+Vous venez de créer votre première chaine de caractères ! C'est une suite de caractères qui peut être traitée par un ordinateur. Une chaine de caractères doit toujours commencer et terminer par le même caractère. Çela peut être un guillemet simple (`'`) ou un guillemet double (`"`), ça n'a pas d'importance. Cela permet à Python de savoir que tout ce qui se trouve à l'intérieur de ces guillemets est une chaine de caractères.
 
-Il est possible d'assembler des chaînes de caractères comme ceci :
+Il est possible d'assembler des chaines de caractères comme ceci :
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> "Salut  " + "Ola"
@@ -60,21 +78,27 @@ Il est possible d'assembler des chaînes de caractères comme ceci :
 
 Vous pouvez aussi multiplier une chaîne de caractères par un nombre :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Ola" * 3
 'OlaOlaOla'
 ```
 
-Si vous avez besoin de mettre une apostrophe dans votre chaîne de caractères, vous avez deux possibilités.
+Si vous avez besoin de mettre une apostrophe dans votre chaine de caractères, vous avez deux possibilités.
 
 Vous pouvez utiliser des guillemets doubles :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> "J'aime la mousse au chocolat"
 "J'aime la mousse au chocolat"
 ```
 
-ou échapper l’apostrophe avec une barre oblique inversée (un backslash, `&#92;`) :
+ou échapper l’apostrophe avec une barre oblique inversée (un backslash, ``) :
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> 'J\'aime la mousse au chocolat'
@@ -83,30 +107,34 @@ ou échapper l’apostrophe avec une barre oblique inversée (un backslash, `&#9
 
 Pas mal, non ? Pour voir votre nom en majuscules, tapez juste :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Ola".upper()
 'OLA'
 ```
 
-Vous venez d'utiliser la **fonction** `upper` sur votre chaîne de caractères ! Une fonction (comme `upper()`) est un ensemble d'instructions que Python va effectuer sur un objet donné (`"Ola"`) lorsque vous l’appellerez.
+Vous venez d'utiliser la **fonction** `upper` sur votre chaine de caractères! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
 
-Si vous voulez savoir combien il y a de lettres dans votre nom, il y a une fonction pour ça !
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> len("Ola")
 3
 ```
 
-Vous avez peut-être remarqué que parfois, on appelle la fonction avec `.` en la plaçant après la chaîne de caractères (comme `"Ola".upper()`) alors qu'à d'autres moment, on appelle d'abord la fonction puis la chaîne de caractères entre parenthèses ? Il s'avère que dans certains cas, les fonctions appartiennent à des objets (c'est le cas de `upper()`) et qu'elles ne peuvent être appliquées qu'à des chaînes de caractères. Dans ce cas, on appelle la fonction une **méthode**. D'autres fois, les fonctions n’appartiennent à rien de particulier et peuvent être utilisées sur différents types d'objets (c'est le cas de `len()`). C'est pour ça que nous passons `"Ola"` comme argument à la fonction `len`.
+Vous avez peut-être remarqué que parfois, on appelle la fonction avec `.` en la plaçant après la chaine de caractères (comme `"Ola".upper()`) alors qu'à d'autres moment, on appelle d'abord la fonction puis la chaine de caractères entre parenthèses ? Il s'avère que dans certains cas, les fonctions appartiennent à des objets (c'est le cas de `upper()`) et qu'elles ne peuvent être appliquées qu'à des chaines de caractères. Dans ce cas, on appelle la fonction une **méthode**. D'autres fois, les fonctions n’appartiennent à rien de particulier et peuvent être utilisées sur différents types d'objets (c'est le cas de `len()`). C'est pour ça que nous passons `"Ola"` comme argument à la fonction `len`.
 
 ### Résumé
 
-OK, assez parlé de chaînes de caractères. Jusque-là, nous avons découvert :
+OK, assez parlé de chaines de caractères. Jusque-là, nous avons découvert :
 
-*   **le prompt** - taper des commandes (du code) dans le prompt Python donne des réponses dans Python
-*   **les nombres et les chaînes de caractères** - dans Python, les nombres sont utilisés pour faire des calculs, et les chaînes de caractères pour manipuler du texte
-*   **opérateurs** - comme + et * qui combinent des valeurs pour en obtenir de nouvelles
-*   **les fonctions** - comme upper() et len() qui effectuent des actions sur les objets.
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
 
 Ce sont des bases présentes dans tous les langages de programmation que vous pouvez apprendre. Prête pour quelque chose de plus compliqué ? Allons-y !
 
@@ -114,6 +142,8 @@ Ce sont des bases présentes dans tous les langages de programmation que vous po
 
 Essayons quelque chose de nouveau. Pouvons-nous obtenir la longueur d’un nombre de la même façon que celle de notre nom ? Tapez `len(304023)` et appuyez sur `entrée` :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(304023)
 Traceback (most recent call last):
@@ -121,40 +151,48 @@ Traceback (most recent call last):
 TypeError: object of type 'int' has no len()
 ```
 
-Nous venons d'obtenir notre première erreur ! Elle nous dit que les objets de type "int" (integers, ce qui signifie nombre entier) n'ont pas de longueur. Que pouvons-nous faire, du coup ? Pourquoi ne pas essayer d'écrire notre nombre comme une chaîne de caractères ? Après tout, les chaînes de caractères ont bien une taille, non ?
+Nous venons d'obtenir notre première erreur ! Elle nous dit que les objets de type "int" (integers, ce qui signifie nombre entier) n'ont pas de longueur. Que pouvons-nous faire, du coup ? Pourquoi ne pas essayer d'écrire notre nombre comme une chaine de caractères ? Après tout, les chaînes de caractères ont bien une taille, non ?
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> len(str(304023))
 6
 ```
 
-Ça a marché ! Nous avons utilisé la fonction `str` à l'intérieur de la fonction `len`. La fonction `str()` convertit n'importe quoi en chaîne de caractères.
+Ça a marché ! Nous avons utilisé la fonction `str` à l'intérieur de la fonction `len`. La fonction `str()` convertit n'importe quoi en chaine de caractères.
 
-*   La fonction `str` convertit des choses en **chaînes de caractères**
-*   La fonction `int` convertit des choses en **entiers**
+- La fonction `str` convertit des choses en **chaines de caractères**
+- La fonction `int` convertit des choses en **entiers**
 
-> Important : il est possible de convertir des nombres en texte, mais il n'est pas toujours possible de convertir du texte en nombres. Parce que, bon, ça vaudrait quoi `int('salut')` ?
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
 
 ## Variables
 
-Il existe un concept super important en programmation : les variables. Une variable, c'est juste un nom pour quelque chose que l'on aimerait utiliser plus tard. Les programmeurs⋅euses utilisent des variables pour stocker des données, rendre leur code plus lisible, et pour ne pas avoir à se rappeler de ce que sont les choses.
+Il y existe un concept super important en programmation : les variables. Une variable, c'est juste un nom pour quelque chose que l'on aimerait utiliser plus tard. Les programmeurs⋅euses utilisent des variables pour stocker des données, rendre leur code plus lisible, et pour ne pas avoir à se rappeler de ce que sont les choses.
 
 Disons que nous aimerions créer une variable appelée `name` :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> name = "Ola"
 ```
 
-Vous voyez ? C'est tout bête ! C'est simplement : name vaut Ola.
+We type name equals Ola.
 
 Vous avez peut-être remarqué que contrairement à tout à l'heure, le programme ne renvoie rien. Du coup, comment faire pour vérifier que la variable existe vraiment ? Tapez simplement `name` et appuyez sur `entrée` :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> name
 'Ola'
 ```
 
-Youpi ! Votre première variable :) ! Vous pouvez toujours changer ce à quoi elle fait référence :
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> name = "Sonja"
@@ -164,12 +202,16 @@ Youpi ! Votre première variable :) ! Vous pouvez toujours changer ce à quoi el
 
 Vous pouvez aussi l'utiliser dans des fonctions :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(name)
 5
 ```
 
-Génial, non ? Et bien sûr, les variables peuvent être n'importe quoi, y compris des nombres ! Essayez ça :
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> a = 4
@@ -178,7 +220,9 @@ Génial, non ? Et bien sûr, les variables peuvent être n'importe quoi, y compr
 24
 ```
 
-Mais que se passe-t-il si nous utilisons le mauvais nom ? Essayez de deviner ! C'est parti !
+Mais que ce passe-t-il si nous utilisons le mauvais nom ? Essayez de deviner ! C'est parti !
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> city = "Tokyo"
@@ -196,6 +240,8 @@ Jouez un peu avec les variables et essayez de voir ce que vous pouvez faire !
 
 Essayez ça :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> name = 'Maria'
 >>> name
@@ -204,29 +250,35 @@ Essayez ça :
 Maria
 ```
 
-Quand vous tapez `name`, l'interpréteur Python répond avec la *représentation* de la chaîne de caractères associée à la variable "name", c'est à dire les lettres M-a-r-i-a, entourées par des guillemets simples. Quand vous dites `print(name)`, Python va "imprimer" le contenu de la variable sur l'écran, sans les guillemets, ce qui est plus sympa.
+Quand vous tapez `name`, l'interpréteur Python répond avec la *représentation* de la chaine de caractères associée à la variable "name", c'est à dire les lettres M-a-r-i-a, entourées par des guillemets simples. Quand vous dites `print(name)`, Python va "imprimer" le contenu de la variable sur l'écran, sans les guillemets, ce qui est plus sympa.
 
 Comme nous le verrons plus tard, `print()` est aussi utile lorsque l'on veut afficher des choses depuis l'intérieur de fonctions ou des choses sur plusieurs lignes.
 
 ## Les listes
 
-En plus des chaînes de caractères et des entiers, Python possède tout un tas d'autres types d'objets. Nous allons maintenant vous présenter un type appelé **listes**. Les listes sont exactement ce que vous pensez qu’elles sont : des objets qui sont des listes d’autres objets :)
+En plus des chaines de caractères et des entiers, Python possède tout un tas d'autres types d'objets. Nous allons maintenant vous présenter un type appelé **listes**. Les listes sont exactement ce que vous pensez qu’elles sont : des objets qui sont des listes d’autres objets. :)
 
 Allez-y, créez une liste :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> []
 []
-```  
+```
 
 Oui, cette liste est vide. Pas très utile, non ? Créons maintenant une liste de numéros de loterie. Nous ne voulons pas nous répéter tout le temps, donc mettons-la dans une variable :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery = [3, 42, 12, 19, 30, 59]
 ```
 
 Voilà, nous avons une liste ! Qu'est ce que nous pourrions en faire ? Commençons par voir combien de numéros de loterie il y a dans cette liste. Une idée de la fonction pour faire ça ? Vous la connaissez déjà !
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(lottery)
 6
@@ -234,12 +286,16 @@ Voilà, nous avons une liste ! Qu'est ce que nous pourrions en faire ? Commenço
 
 Hé oui ! `len()` peut aussi vous donner le nombre d'objets dans une liste. Pratique, non ? Peut-être qu'on peut aussi la trier :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery.sort()
 ```
 
 Ça ne renvoie rien : cette fonction a juste changé l'ordre dans lequel les nombres apparaissent dans la liste. Affichons-la encore pour voir ce qu'il s'est passé :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(lottery)
 [3, 12, 19, 30, 42, 59]
@@ -249,13 +305,17 @@ Comme vous pouvez le voir, les nombres de la liste sont maintenant triés du plu
 
 Pouvons-nous inverser cet ordre ? Essayons!
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery.reverse()
 >>> print(lottery)
 [59, 42, 30, 19, 12, 3]
 ```
 
-Facile, non ? Si vous voulez ajouter quelque chose à la liste, vous pouvez le faire en tapant cette commande :
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> lottery.append(199)
@@ -265,6 +325,8 @@ Facile, non ? Si vous voulez ajouter quelque chose à la liste, vous pouvez le f
 
 Si vous ne souhaitez afficher que le premier nombre, vous pouvez le faire en utilisant des **indices**. Un indice est un nombre qui dit où l'élément apparait dans la liste. Les programmeurs⋅euses préfèrent compter à partir de 0 : le premier objet dans notre liste a donc pour indice 0, le suivant 1 et ainsi de suite. Essayez ça :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(lottery[0])
 59
@@ -274,7 +336,9 @@ Si vous ne souhaitez afficher que le premier nombre, vous pouvez le faire en uti
 
 Comme vous pouvez le voir, nous pouvons accéder à différents objets dans la liste en utilisant le nom de la liste suivi de l'indice de l'objet entre crochets.
 
-Pour supprimer un objet de votre liste, vous aurez besoin de son **indice** ainsi que de la commande `pop()`. Essayons l'exemple suivant : supprimez le premier numéro de votre liste.
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> print(lottery)
@@ -282,19 +346,24 @@ Pour supprimer un objet de votre liste, vous aurez besoin de son **indice** ains
 >>> print(lottery[0])
 59
 >>> lottery.pop(0)
+59
 >>> print(lottery)
 [42, 30, 19, 12, 3, 199]
 ```
 
 Ça marche à merveille !
 
-Jouons encore un peu avec les indices ! Essayez-en des nouveaux : 6, 7, 1000, -1, -6 ou -1000. Est-ce que vous arrivez à prévoir le résultat avant de taper la commande ? Est-ce que ces résultats vous paraissent logiques ?
+Jouons encore un peu avec les indices ! Essayez-en des nouveaux : 6, 7, 1000, -1, -6 ou -1000. Est-ce que vous arrivez à prévoir le résultat avant de taper la commande ? Est-ce que ses résultats vous paraissent logiques ?
 
 Vous pouvez trouver une liste complète des méthodes disponibles pour les listes dans ce chapitre de la documentation de Python : https://docs.python.org/3/tutorial/datastructures.html
 
 ## Dictionnaires
 
-Un dictionnaire est un peu comme une liste. Cependant, nous utilisons des clefs plutôt que des indices pour accéder aux valeurs. Une clef peut être n'importe quelle chaîne de caractère ou n'importe quel nombre. La syntaxe pour définir un dictionnaire vide est la suivante :
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> {}
@@ -303,28 +372,34 @@ Un dictionnaire est un peu comme une liste. Cependant, nous utilisons des clefs
 
 C'est comme ça que l'on crée un dictionnaire vide. Hourra !
 
-Maintenant, essayez d'écrire la commande suivante (et essayez aussi de changer le contenu) :
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
 ```
 
-Avec cette commande, vous venez de créer une variable nommée `participant` avec trois paires clef-valeur :
+With this command, you just created a variable named `participant` with three key–value pairs:
 
-*   La clef `name` pointe vers la valeur `'Ola'` (un objet `chaîne de caractères`),
-*   `country` pointe vers `'Poland'` (une autre `chaîne de caractères`),
-*   et `favorite_numbers` pointe vers `[7, 42, 92]` (une `liste` contenant trois nombres).
+- La clef `name` pointe vers la valeur `'Ola'` (un objet `chaine de caractères`),
+- `country` pointe vers `'Poland'` (une autre `chaine de caractères`),
+- et `favorite_numbers` pointe vers `[7, 42, 92]` (une `liste` contenant trois nombres).
 
 Vous pouvez vérifier le contenu de chaque clef avec cette syntaxe :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(participant['name'])
 Ola
 ```
 
-Vous voyez, c'est un peu comme une liste; Cependant, vous n'avez pas besoin de vous souvenir de l'indice, juste de son nom.
+See, it's similar to a list. But you don't need to remember the index – just the name.
 
-Que se passe-t-il lorsque nous demandons à Python la valeur correspondant à une clef qui n'existe pas ? Pouvez-vous le deviner ? Essayons voir !
+Que ce passe-t-il lorsque nous demandons à Python la valeur correspondant à une clef qui n'existe pas ? Pouvez-vous le deviner ? Essayons voir !
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> participant['age']
@@ -337,35 +412,44 @@ Oh, une autre erreur ! Celle-ci est une **KeyError**. Python nous donne un coup
 
 Vous vous demandez peut-être quand est-ce qu'il faut utiliser un dictionnaire ou une liste ? C'est une bonne question. Réfléchissez-y un instant avant de regarder la réponse à la ligne suivante.
 
-*   Vous avez besoin d'une suite ordonnée d'éléments ? Utilisez une liste.
-*   Vous avez besoin d'associer des valeurs à des clefs, de manière à pouvoir les retrouver efficacement (par clef) par la suite ? Utilisez un dictionnaire.
+- Vous avez besoin d'une suite ordonnée d'éléments ? Utilisez une liste.
+- Vous avez besoin d'associer des valeurs à des clefs, de manière à pouvoir les retrouver efficacement (par clef) par la suite ? Utilisez un dictionnaire.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
 
-Comme les listes, les dictionnaires sont *mutables*, ce qui signifie qu'ils peuvent être modifiés après leur création. Vous pouvez ajouter de nouvelles paires clé/valeur au dictionnaire après sa création, comme ceci :
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> participant['favorite_language'] = 'Python'
 ```
 
-Comme pour les listes, la fonction `len()` permet d'obtenir le nombre de paires clef-valeur du dictionnaire. Essayez et tapez la commande suivante :
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> len(participant)
 4
 ```
 
-J'espère que c'est compréhensible pour l'instant :) Prête pour s'amuser un peu plus avec les dictionnaires ? Passez à la ligne suivante pour voir des trucs géniaux.
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Par exemple, si vous voulez supprimer l'entrée correspondant à la clé `« favorite_numbers »`, tapez la commande suivante :
 
-Vous pouvez utiliser la commande `pop()` pour supprimer un élément du dictionnaire. Par exemple, si vous voulez supprimer l'entrée correspondant à la clé `« favorite_numbers »`, tapez la commande suivante :
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> participant.pop('favorite_numbers')
+[7, 42, 92]
 >>> participant
 {'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
 ```
 
-Comme vous pouvez le voir dans votre console, la paire clef-valeur correspondant à "favorite_numbers" a été supprimée.
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
 
-De même, vous pouvez changer la valeur associée à une clef déjà créée dans le dictionnaire. Tapez ceci :
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> participant['country'] = 'Germany'
@@ -373,22 +457,26 @@ De même, vous pouvez changer la valeur associée à une clef déjà créée dan
 {'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
 ```
 
-Voilà, la valeur de la clé `"country"` a été modifiée de `"Poland"` à `"Germany"`. :) Ce n'est pas cool ça ? Yep ! Un autre truc génial d'appris !
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
 
 ### Résumé
 
 C'est super ! Vous savez plein de choses sur la programmation maintenant. Dans cette partie, vous avez appris :
 
-*   **les erreurs** - vous savez maintenant comment lire et comprendre les erreurs qui apparaissent quand Python ne comprend pas l'une de vos commandes
-*   **les variables** - des noms pour les objets qui vous permettent de coder plus facilement et de rendre votre code plus lisible
-*   **les listes** - des listes d'objets stockés dans un ordre particulier
-*   **les dictionnaires** - des objets stockés sous forme de paires clef-valeur
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
 
 On continue ? :)
 
 ## Comparer des choses
 
-Comparer des choses est très important en programmation. Quelle serait la chose la plus facile à comparer ? Les nombres, bien sûr ! Voyons voir comment ça marche :
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> 5 > 2
@@ -403,12 +491,14 @@ True
 True
 ```
 
-Nous avons donné à Python des nombres à comparer. Comme vous pouvez le voir, Python peut comparer des nombres, mais aussi des résultats de méthodes. Pas mal, non ?
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
 
-Vous vous demandez probablement pourquoi nous avons mis deux signes `==` côte à côte pour savoir si deux nombres étaient égaux ? On utilise déjà `=` pour assigner des valeurs aux variables. Du coup, il faut toujours, oui **toujours**, mettre deux `==` si vous voulez savoir si deux choses sont égales. Nous pouvons aussi dire que certaines choses ne sont pas égales à d'autres Pour cela, nous utilisons le symbole `!=`, comme illustré dans l'exemple ci-dessus.
+Vous vous demandez probablement pourquoi nous avons mis deux signes `==` côte à côte pour savoir si deux nombres étaient égaux ? On utilise déjà `=` pour assigner des valeurs aux variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. Nous pouvons aussi dire que certaines choses ne sont pas égales à d'autres Pour cela, nous utilisons le symbole `! =`, comme illustré dans l'exemple ci-dessus.
 
 Donnons encore un peu de boulot à Python :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> 6 >= 12 / 2
 True
@@ -416,15 +506,17 @@ True
 False
 ```
 
-`>` et `<` sont faciles, mais qu'est ce que `>=` et `<=` veulent dire ? Ils se lisent comment ça :
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
 
-*   x `>` y veut dire : x est plus grand que y
-*   x `<` y signifie: x est inférieure à y
-*   x `<=` y signifie: x est inférieur ou égal à y
-*   x `>=` y veut dire : x est supérieur ou égal à y
+- x `>` y veut dire : x est plus grand que y
+- x `<` y signifie: x est inférieure à y
+- x `< =` y signifie: x est inférieur ou égal à y
+- x `>=` y veut dire : x est supérieur ou égal à y
 
 Super ! Un dernier ? Essayez ça :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> 6 > 2 and 2 < 3
 True
@@ -436,30 +528,37 @@ True
 
 Vous pouvez donner à Python autant de nombres à comparer que vous le souhaitez et il vous donnera une réponse. Plutôt malin, non ?
 
-*   **and** - si vous utilisez l'opérateur `and` (et), les deux comparaisons doivent être True (vraies) pour que la commande toute entière soit True
-*   **or** - si vous utilisez l'opérateur `or` (ou), il suffit qu'une des deux comparaisons soit True (vraie) pour que la commande toute entière soit True
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
 
 Vous connaissez l'expression "on ne compare pas les choux et les carottes" ? Essayons l'équivalent en Python :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> 1 > 'django'
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
-TypeError: unorderable types: int() > str()
+TypeError: '>' not supported between instances of 'int' and 'str'
 ```
 
-Comme vous le voyez, Python n'est pas capable de comparer un nombre (`int`) et une chaîne de caractères (`str`). À la place, il nous montre une **TypeError** et nous dit que les deux types ne peuvent pas être comparés.
+Comme vous le voyez, Python n'est pas capable de comparer un nombre (`int`) et une chaine de caractères (`str`). À la place, il nous montre une **TypeError** et nous dit que les deux types ne peuvent pas être comparés.
 
 ## Booléen
 
-Au passage, vous venez de découvrir un nouveau type d'objets en Python. On l'appelle **Booléen**. C'est probablement le type le plus simple qui existe.
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
 
-Il n'y a que deux objets Booléens : - True (vrai) - False (faux)
+There are only two Boolean objects:
 
-Pour que Python comprenne qu'il s'agit d'un Boléen, il faut toujours l'écrire True (première lettre en majuscule, les autres en minuscule). **true, TRUE, tRUE ne marchent pas -- seul True est correct.** (Et c'est aussi vrai pour False.)
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
 
 Les Booléens aussi peuvent être des variables ! regardez :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> a = True
 >>> a
@@ -468,31 +567,37 @@ True
 
 Vous pouvez aussi faire ça :
 
+{% filename %}command-line{% endfilename %}
+
 ```python
 >>> a = 2 > 5
 >>> a
 False
 ```
 
-Entrainez-vous et amusez-vous avec les Booleéns en essayant de lancer les commandes suivantes :
+Entraînez-vous et amusez-vous avec les Booleéns en essayant de lancer les commandes suivantes :
 
-*   `True and True`
-*   `False and True`
-*   `True or 1 == 1`
-*   `1 != 2`
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
 
 Bravo ! Les Booléens sont l'une des fonctionnalités les plus cools en programmation et vous venez juste d'apprendre comment les utiliser !
 
 # Sauvegardez tout ça !
 
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
 Pour l'instant, nous avons écrit tout notre code Python directement dans l'interpréteur, ce qui nous limite à une ligne à la fois. Les programmes normaux sont sauvegardés dans des fichiers et sont exécutés par **l'interpréteur** ou le **compilateur** de notre langage de programmation. Jusque-là, c'était ligne par ligne dans **l'interpréteur**. Nous allons avoir besoin de bien plus qu'une ligne de code par la suite alors, vous allez rapidement avoir besoin de :
 
-*   Quitter l'interpréteur Python
-*   Ouvrir l'éditeur de code de notre choix
-*   Sauvegarder du code dans un nouveau fichier Python
-*   Le lancer !
+- Quitter l'interpréteur Python
+- Ouvrir l'éditeur de code de notre choix
+- Sauvegarder du code dans un nouveau fichier Python
+- Le lancer !
 
-Pour quitter l'interpréteur Python que nous sommes en train d'utiliser, il suffit de taper la fonction `exit()` :
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> exit()
@@ -501,87 +606,140 @@ $
 
 Cela vous ramènera dans la ligne de commande de votre système d'exploitation.
 
-Tout à l'heure, dans la section [L'éditeur de texte][2], nous avons choisi un éditeur de texte. Ouvrez-le et écrivez le code suivant dans un nouveau fichier :
+Tout à l'heure, dans la section [L'éditeur de texte](../code_editor/README.md), nous avons choisi un éditeur de texte. Nous avons maintenant besoin de l'ouvrir et d'écrire du code dans un nouveau fichier :
 
- [2]: ../code_editor/README.md
+{% filename %}editor{% endfilename %}
 
 ```python
 print('Hello, Django girls!')
 ```
 
-> **Note :** Vous avez probablement constaté que votre code se pare de multiples couleurs : ça fait partie des choses qui rendent la programmation dans un éditeur de texte bien plus agréable. Votre console Python n'avait pas cette fonctionnalité : tout était donc de la même couleur. Dans votre éditeur de texte, vous devriez voir que la fonction `print` possède différentes couleurs. C'est ce qu'on appelle « la coloration syntaxique ». C'est une fonctionnalité très utile lorsque l'on programme. La couleur des choses va vous permettre de détecter des problèmes : une chaîne de caractères non fermée, une faute dans un mot (ce sera par exemple le cas dans la fonction `def` que vous verrez un peu plus bas). C'est ce genre de fonctionnalités qui font que vous aimerez rapidement programmer avec un éditeur de code :)
-
 Vous avez maintenant pas mal de connaissances en Python : n'hésitez pas à écrire du code avec ce que vous avez appris aujourd'hui !
 
-Sauvegardons maintenant le fichier en lui donnant un nom descriptif. On n'a qu'à l'appeler **python_intro.py** et le sauvegarder sur le bureau. Vous pouvez donner le nom que vous souhaitez à ce fichier mais il est important qu'il se termine par **.py**. L'extension **.py** permet de signaler à votre système d'exploitation que ce fichier est un **fichier exécutable Python** et que Python peut le lancer.
+Sauvegardons maintenant le fichier en lui donnant un nom descriptif. On n'a qu'à l'appeler **python_intro.py** et le sauvegarder sur le bureau. Vous pouvez donner le nom que vous souhaitez à ce fichier mais il est important qu'il se termine par **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. C'est ce qu'on appelle « la coloration syntaxique ». C'est une fonctionnalité très utile lorsque l'on programme. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). C'est ce genre de fonctionnalités qui font que vous aimerez rapidement programmer avec un éditeur de code. :)
 
 Une fois que le fichier est sauvegardé, vous pouvez le lancer ! En utilisant les compétences que vous avez apprises dans la section sur la ligne de commande, utilisez le terminal pour **changer le dossier courant** vers le bureau.
 
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
 Sur Mac, ça ressemblera à :
 
+{% filename %}command-line{% endfilename %}
+
     $ cd ~/Desktop
+    
+
+<!--endsec-->
 
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
 
-Sous Linux, comme ça (il se peut que le mot Bureau soit dans une autre langue) :
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
 
     $ cd ~/Desktop
+    
+
+<!--endsec-->
 
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
 
-Et sous Windows, ce sera comme ça :
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
 
     > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
 
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
 
 Si vous êtes bloquée, n'hésitez pas à appeler à l'aide.
 
 Maintenant, utilisez Python pour exécuter le code contenu dans votre fichier :
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
 
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
 
 Super ! Vous venez de lancer votre premier programme python à partir d'un fichier. Cool non ?
 
 Et maintenant, passons à un autre outil essentiel de la programmation :
 
-## If...elif...else
+## If … elif … else
 
-Quand on code, il y a plein choses qui ne doivent être exécutées que dans certaines conditions. Pour cela, Python possède ce qu'on appelle l'instruction **if** (si).
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
 
 Remplacez le code dans votre fichier **python_intro.py** avec ceci :
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
 ```
 
-Si nous sauvegardons ce fichier et que nous le lançons, nous obtiendrons l'erreur suivante :
+If we were to save and run this, we'd see an error like this:
 
-```python
-$ python3 python_intro.py
-File "python_intro.py", line 2
-         ^
-SyntaxError: unexpected EOF while parsing
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
 
 Python s'attend à ce que nous lui donnions des instructions sur ce qu'il faut exécuter lorsque la condition `3 > 2` est vraie (ou plutôt, `True`). Essayons de lui faire afficher "Ça marche !". Remplacez le code dans **python_intro.py** par ceci :
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
-    print('It works!')
+    print('Ça marche !')
 ```
 
 Avez-vous remarqué que nous avions décalé la ligne suivante de quatre espaces ? C'est ce que l'on appelle indenter. Nous avons besoin d'indenter pour que Python sache quel code exécuter si le résultat est vrai. Un seul espace suffirait, mais à peu près tous⋅tes les programmeurs⋅euses Python pensent que 4 espaces sont plus clairs. Une seule `tab` (tabulation) compte également comme 4 espaces.
 
 Sauvegardez le fichier et relancez le :
 
-    $ python3 python_intro.py
-    Ça marche !
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+Ça marche !
+```
 
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
 
 ### Et que se passe-t-il si une condition n’est pas vraie ?
 
 Dans les exemples précédents, le code était exécuté quand la condition était vraie. Cependant, Python possède aussi des instructions `elif` (sinon si) et `else` (sinon) :
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 5 > 2:
     print('5 est effectivement plus grand que 2')
@@ -591,11 +749,15 @@ else:
 
 Lorsque vous exécuterez le code, ceci s'affichera :
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     5 est effectivement plus grand que 2
+    
 
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
 
-Et si 2 était plus grand que 5, la seconde commande serait exécutée. Facile, non ? Voyons comment `elif` fonctionne :
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 name = 'Sonja'
@@ -609,52 +771,80 @@ else:
 
 Exécutons le code :
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hey Sonja!
-
+    
 
 Que s'est-il passé ? `elif` vous permet d'ajouter d'autres conditions à exécuter si les précédentes échouent.
 
 Vous pouvez ajouter autant de `elif` que vous le souhaitez après le premier `if`. Voici un exemple :
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 volume = 57
 if volume < 20:
-    print("C'est plutôt calme.")
+    print("It's kinda quiet.")
 elif 20 <= volume < 40:
-    print("Une jolie musique de fond.")
+    print("It's nice for background music")
 elif 40 <= volume < 60:
-    print("Parfait, je peux entendre tous les détails du morceau.")
+    print("Perfect, I can hear all the details")
 elif 60 <= volume < 80:
-    print("Parfait pour faire la fête !")
+    print("Nice for parties")
 elif 80 <= volume < 100:
-    print("Un peu trop fort !")
+    print("A bit loud!")
 else:
-    print("Au secours ! Mes oreilles ! :(")
+    print("My ears are hurting! :(")
 ```
 
 Python va tester les différentes conditions puis il affichera ceci :
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Parfait, je peux entendre tous les détails du morceau.
+    
+
+## Comments
 
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
 
 ### Résumé
 
-Avec ces trois derniers exercices, vous avez appris :
+In the last few exercises you learned about:
 
-*   **Comment comparer des choses** - en Python, vous pouvez comparer des choses avec `>`, `>=`, `==`, `<=`, `<` et avec les opérateurs `and`, `or`
-*   **Booléen** - un type d'objet qui n'a que deux valeurs possibles : `True` et `False`
-*   **Comment sauvegarder des fichiers** - stocker votre code dans des fichiers pour pouvoir écrire des programmes plus longs.
-*   **if...elif...else** - des instructions que vous permettent de n'exécuter du code que dans certaines conditions.
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
 
 Il est temps d'attaquer la dernière partie de ce chapitre !
 
 ## Vos propres fonctions !
 
-Vous vous souvenez des fonctions comme `len()` que vous pouvez exécuter en Python ? Et bien, bonne nouvelle : vous allez apprendre à écrire vos propres fonctions!
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+Une fonction est un ensemble d'instructions que Python va exécuter. Chaque fonction en Python commence par le mot-clef `def`. On lui donne un nom, et elle peut avoir des paramètres. Let's give it a go. Remplacer le code de **python_intro.py** par ceci :
 
-Une fonction est un ensemble d'instructions que Python va exécuter. Chaque fonction en Python commence par le mot-clef `def`. On lui donne un nom, et elle peut avoir des paramètres. Commençons par quelque chose de facile. Remplacer le code de **python_intro.py** par ceci :
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi():
@@ -670,12 +860,22 @@ Vous vous demandez peut-être pourquoi nous avons écrit le nom de la fonction 
 
 Lançons notre code pour voir ce qui se passe :
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hi there!
     How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
 
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
 
-C'était facile ! Construisons maintenant notre première fonction avec des paramètres. Dans l'exemple précédent, nous avions une fonction qui disait "Hi there!" à la personne qui la lançait. Faisons une fonction identique, mais ajoutons un nom cette fois :
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi(name):
@@ -683,6 +883,8 @@ def hi(name):
 
 Comme vous le voyez, nous avons donné à notre fonction un paramètre appelé `name` :
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
     if name == 'Ola':
@@ -697,46 +899,59 @@ hi()
 
 Rappelez-vous : la fonction `print` est indentée de quatre espaces dans le bloc `if`, car elle est exécutée uniquement quand la condition est satisfaite. Voyons comment ça marche :
 
-```python
-$ python3 python_intro.py
-Traceback (most recent call last):
-File "python_intro.py", line 10, in <module>
-  hi()
-TypeError: hi() missing 1 required positional argument: 'name'
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
 
 Oups, une erreur. Heureusement, Python nous donne un message d'erreur assez utile. Il nous dit que la fonction `hi()` (celle que nous avons définie) a besoin d'un argument (que nous avons appelé `name`). Nous avons oublier de passer cet argument lorsque nous avons appelé notre fonction. Corrigeons la dernière ligne du fichier :
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 hi("Ola")
 ```
 
-Et exécutez votre code à nouveau :
+Et relançons le :
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hi Ola!
-
+    
 
 Et que se passe-t-il quand on change de nom ?
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 hi("Sonja")
 ```
 
-Exécutez votre code à nouveau :
+Et qu'on le lance :
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hi Sonja!
+    
 
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
 
-Maintenant, que pensez-vous qu'il se passera lorsque nous écrirons un autre nom (ni Ola, ni Sonja) ? Faites un essai et regardez si vous avez raison. Ceci devrait s'afficher :
+{% filename %}command-line{% endfilename %}
 
     Hi anonymous!
+    
 
+Super, non ? Avec ça, vous n'avez pas besoin de vous répéter lorsque vous voulez changer le nom de la personne à saluer. And that's exactly why we need functions – you never want to repeat your code!
 
-Super, non ? Avec ça, vous n'avez pas besoin de vous répéter lorsque vous voulez changer le nom de la personne à saluer. C'est pour cette raison que nous avons besoin de fonctions : vous ne voulez pas avoir à répéter votre code !
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
 
-Faisons maintenant quelque chose de plus malin : comme vous le savez, il existe plus de deux prénoms. Cependant, ce serait un peu pénible de devoir écrire une condition pour chacun d'entre eux, n'est-ce pas ?
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi(name):
@@ -747,34 +962,44 @@ hi("Rachel")
 
 Exécutons à nouveau notre code :
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hi Rachel!
+    
 
-
-Félicitations ! Vous venez juste d’apprendre à écrire des fonctions ! :)
+Bravo ! Vous venez d'apprendre à écrire des fonctions! :)
 
 ## Les boucles
 
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
 C’est déjà la dernière partie. C’était rapide, non ? :)
 
 Les programmeurs⋅euses n'aiment pas devoir se répéter. L'essence de la programmation est d'automatiser les choses : nous aimerions pouvoir saluer automatiquement chaque personne. Pour cela, nous allons utiliser des boucles.
 
 Vous vous souvenez des listes ? Faisons une liste de Django Girls :
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
 ```
 
 Nous voulons saluer chacune d'entre elles par son nom. Nous avons déjà la fonction `hi` pour faire ça, utilisons donc une boucle :
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 for name in girls:
 ```
 
-L'instruction `for` se comporte un peu comme `if`. Le code qui suit doit donc être indenté de quatre espaces.
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
 
 Voilà le code complet à mettre dans votre fichier :
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
     print('Hi ' + name + '!')
@@ -787,6 +1012,8 @@ for name in girls:
 
 Exécutez votre code :
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hi Rachel!
     Next girl
@@ -798,12 +1025,14 @@ Exécutez votre code :
     Next girl
     Hi You!
     Next girl
-
+    
 
 Comme vous le voyez, tout ce que nous avons mis dans un `for` avec une indentation est répété pour chaque élément de la liste `girls`.
 
 Vous pouvez aussi utiliser `for` sur des nombres grâce à la fonction `range`:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 for i in range(1, 6):
     print(i)
@@ -811,23 +1040,23 @@ for i in range(1, 6):
 
 Ce qui affiche :
 
+{% filename %}command-line{% endfilename %}
+
     1
     2
     3
     4
     5
-
+    
 
 `range` est une fonction qui crée une liste de nombres qui se suivent (c'est vous qui définissez l’intervalle à l'aide de paramètres).
 
-Vous pouvez remarquer que le second de ces nombres n'est pas inclus dans la liste que Python nous donne (ce qui signifie que `range(1, 6)` compte de 1 à 5, mais n'inclut pas 6). C'est lié au fait que "range" est à moitié ouvert. Cela signifie qu'il inclut la première valeur mais pas la dernière.
+Vous pouvez remarquer que le second de ces nombres n'est pas inclus dans la liste que Python nous donne (ce qui signifie que `range(1, 6)` compte de 1 à 5, mais n'inclue pas 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
 
 ## Résumé
 
-Et voilà ! **Vous êtes géniale !** Ce chapitre était un peu compliqué et vous devriez être fière de vous ! En tout cas, nous sommes super fières de vous !
-
-N'hésitez pas à prendre une pause : étirez-vous, marchez un peu ou reposez-vous les yeux. Une fois que vous avez un peu rechargé vos batteries, vous pouvez attaquer le chapitre suivant :)
+Et voilà ! **Vous êtes géniale !** Ce chapitre était un peu compliqué et vous devriez être fière de vous ! En tout cas, nous sommes super fière de vous !
 
-![Cupcake][3]
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
 
- [3]: images/cupcake.png
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/fr/signup_pythonanywhere.md b/fr/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/fr/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/fr/template_extending/README.md b/fr/template_extending/README.md
index 91d2dc08572..64d4fb28de2 100755
--- a/fr/template_extending/README.md
+++ b/fr/template_extending/README.md
@@ -2,9 +2,9 @@
 
 Django vous réserve encore bien des surprises : une assez géniale est **l'héritage de template**. Qu'est ce que ça signifie ? C'est une fonctionnalité qui vous permet de réutiliser certains morceaux de HTML dans différentes pages de votre site web.
 
-Concrètement, cela permet d'éviter de vous répéter dans chaque fichier lorsque vous voulez utiliser la même information ou mise en page. Ainsi, lorsque vous voudrez changer quelque chose, vous n'aurez à le faire qu'une seule fois!
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
 
-## Créer un template de base
+## Create a base template
 
 Un template de base est le template le plus simple que vous pouvez faire hériter à chaque page de votre site web.
 
@@ -15,10 +15,12 @@ Créons le fichier `base.html` dans le dossier `blog/templates/blog/` :
         └───blog
                 base.html
                 post_list.html
-
+    
 
 Ensuite, ouvrez ce fichier `base.html` et collez-y tout ce qui se trouve dans le fichier `post_list.html`. Ça devrait ressembler à ça :
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -55,6 +57,8 @@ Ensuite, ouvrez ce fichier `base.html` et collez-y tout ce qui se trouve dans le
 
 Puis, dans le fichier `base.html`, remplacez tout ce qui se trouve dans `<body>` (de `<body>` à `</body>`) par ceci :
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <body>
     <div class="page-header">
@@ -71,16 +75,20 @@ Puis, dans le fichier `base.html`, remplacez tout ce qui se trouve dans `<body>`
 </body>
 ```
 
-Nous venons concrètement de remplacer tout ce qui se trouve entre `{% for post in posts %}{% endfor %}` par :
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% block content %}
 {% endblock %}
 ```
 
-Qu'est-ce que cela signifie ? Vous venez simplement de créer un `block` : c'est une balise de template qui vous permet d'insérer le HTML de ce block dans d'autres templates qui héritent de `base.html`. Nous vous expliquerons comment faire dans un instant.
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). Nous vous expliquerons comment faire dans un instant.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
 
-Maintenant, sauvegardez votre fichier puis ouvrez à nouveau `blog/templates/blog/post_list.html`. Supprimez tout ce qui n'est pas dans body. Supprimez aussi `<div class="page-header"></div>`. Votre fichier doit maintenant ressembler à ça :
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
@@ -94,13 +102,29 @@ Maintenant, sauvegardez votre fichier puis ouvrez à nouveau `blog/templates/blo
 {% endfor %}
 ```
 
-Maintenant, ajoutez cette ligne au début du fichier :
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Comme ceci :{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-{% extends 'blog/base.html' %}
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
 ```
 
-{% raw %}Cela signifie que nous sommes en train d'étendre le modèle du template `base.html` dans `post_list.html`. Une dernière chose à faire : déplacez tout le contenu du fichier dans la partie située entre `{% block content %}` et `{% endblock %}`. Attention à ne pas déplacer la ligne que nous venons juste d'insérer. Comme ceci :{% endraw %}
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -118,6 +142,6 @@ Maintenant, ajoutez cette ligne au début du fichier :
 {% endblock %}
 ```
 
-Et voilà ! Vérifiez que votre site fonctionne toujours correctement :)
+Et voilà ! Vérifiez que votre site fonctionne toujours correctement. :)
 
-> Si jamais vous rencontrez une erreur de type `TemplateDoesNotExists` qui signale que le fichier `blog/base.html` n'existe pas et que `runserver` tourne dans votre console, tuez-le (en appuyant sur les touches Ctrl+C en même temps) et relancez votre server à l'aide de la commande `python manage.py runserver`.
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/fr/whats_next/README.md b/fr/whats_next/README.md
index 1eedc004b81..2f8019618d9 100755
--- a/fr/whats_next/README.md
+++ b/fr/whats_next/README.md
@@ -1,39 +1,25 @@
-# La suite?
+# La suite ?
 
-Un immense bravo à vous ! **Vous êtes totalement géniale**. Nous sommes fière de vous ! < 3
+Un immense bravo à vous ! **Vous êtes totalement géniale**. Nous sommes fière de vous! <3
 
 ### Que faire maintenant ?
 
 Faites une pause et détendez-vous. Vous venez d'accomplir quelque chose de vraiment énorme.
 
-Après ça, vous pouvez :
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
 
-*   Suivez Django Girls sur [Facebook][1] ou [Twitter][2] pour être tenue au courant
+### À la recherche de ressources supplémentaires ?
 
- [1]: http://facebook.com/djangogirls
- [2]: https://twitter.com/djangogirls
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
 
-### À la recherche de ressources supplémentaires ?
+Later on, you can try the resources listed below. They're all very recommended!
 
-Jetez un coup d’œil à notre autre livre, [Django Girls Tutorial: Extensions][3] (en anglais).
-
- [3]: https://tutorial-extensions.djangogirls.org
-
-Ensuite, vous pouvez essayer les ressources listées ci-dessous. Elles sont toutes recommandables !
-- [Django's official tutorial][4]
-- [New Coder tutorials][5]
-- [Code Academy Python course][6]
-- [Code Academy HTML & CSS course][7]
-- [Django Carrots tutorial][8]
-- [Learn Python The Hard Way book][9]
-- [Getting Started With Django video lessons][10]
-- [Two Scoops of Django: Best Practices for Django 1.8 book][11]
-
- [4]: https://docs.djangoproject.com/en/1.11/intro/tutorial01/
- [5]: http://newcoder.io/tutorials/
- [6]: https://www.codecademy.com/en/tracks/python
- [7]: https://www.codecademy.com/tracks/web
- [8]: https://github.com/ggcarrots/django-carrots/
- [9]: http://learnpythonthehardway.org/book/
- [10]: http://www.gettingstartedwithdjango.com/
- [11]: https://twoscoopspress.com/products/two-scoops-of-django-1-8
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/ha-HG/GLOSSARY.md b/ha-HG/GLOSSARY.md
new file mode 100644
index 00000000000..4ccdce94324
--- /dev/null
+++ b/ha-HG/GLOSSARY.md
@@ -0,0 +1,3 @@
+# edita code
+
+edita code Adali aikace-aikace ne wanda zai ku damr adana lambar ku don haka zai iya dawowa zuwa gare shi daga baya You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/ha-HG/README.md b/ha-HG/README.md
new file mode 100644
index 00000000000..121da8f55bf
--- /dev/null
+++ b/ha-HG/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ha-HG/SUMMARY.md b/ha-HG/SUMMARY.md
new file mode 100644
index 00000000000..d9741b4f21c
--- /dev/null
+++ b/ha-HG/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/ha-HG/chromebook_setup/README.md b/ha-HG/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/ha-HG/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ha-HG/chromebook_setup/instructions.md b/ha-HG/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..2df2048e6ec
--- /dev/null
+++ b/ha-HG/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ha-HG/code_editor/README.md b/ha-HG/code_editor/README.md
new file mode 100644
index 00000000000..0a401fb1f52
--- /dev/null
+++ b/ha-HG/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ha-HG/code_editor/instructions.md b/ha-HG/code_editor/instructions.md
new file mode 100644
index 00000000000..82fbac15aad
--- /dev/null
+++ b/ha-HG/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ha-HG/css/README.md b/ha-HG/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/ha-HG/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/ha-HG/deploy/README.md b/ha-HG/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/ha-HG/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/ha-HG/deploy/install_git.md b/ha-HG/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/ha-HG/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ha-HG/deploy/signup_pythonanywhere.md b/ha-HG/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/ha-HG/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ha-HG/django/README.md b/ha-HG/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/ha-HG/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/ha-HG/django_admin/README.md b/ha-HG/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/ha-HG/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ha-HG/django_forms/README.md b/ha-HG/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/ha-HG/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ha-HG/django_installation/README.md b/ha-HG/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/ha-HG/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ha-HG/django_installation/instructions.md b/ha-HG/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/ha-HG/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ha-HG/django_models/README.md b/ha-HG/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/ha-HG/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ha-HG/django_orm/README.md b/ha-HG/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/ha-HG/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ha-HG/django_start_project/README.md b/ha-HG/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/ha-HG/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ha-HG/django_templates/README.md b/ha-HG/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/ha-HG/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ha-HG/django_urls/README.md b/ha-HG/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/ha-HG/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ha-HG/django_views/README.md b/ha-HG/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/ha-HG/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ha-HG/dynamic_data_in_templates/README.md b/ha-HG/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/ha-HG/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ha-HG/extend_your_application/README.md b/ha-HG/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/ha-HG/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ha-HG/how_the_internet_works/README.md b/ha-HG/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/ha-HG/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ha-HG/html/README.md b/ha-HG/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/ha-HG/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ha-HG/installation/README.md b/ha-HG/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/ha-HG/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ha-HG/intro_to_command_line/README.md b/ha-HG/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/ha-HG/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ha-HG/intro_to_command_line/open_instructions.md b/ha-HG/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/ha-HG/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ha-HG/python_installation/README.md b/ha-HG/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/ha-HG/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ha-HG/python_installation/instructions.md b/ha-HG/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/ha-HG/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ha-HG/python_introduction/README.md b/ha-HG/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/ha-HG/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ha-HG/template_extending/README.md b/ha-HG/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/ha-HG/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ha-HG/whats_next/README.md b/ha-HG/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/ha-HG/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/ha/GLOSSARY.md b/ha/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/ha/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/ha/README.md b/ha/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/ha/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ha/SUMMARY.md b/ha/SUMMARY.md
new file mode 100644
index 00000000000..7a45700a27d
--- /dev/null
+++ b/ha/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/ha/chromebook_setup/README.md b/ha/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/ha/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ha/chromebook_setup/instructions.md b/ha/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/ha/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ha/code_editor/README.md b/ha/code_editor/README.md
new file mode 100644
index 00000000000..404011f1b7d
--- /dev/null
+++ b/ha/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ha/code_editor/instructions.md b/ha/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/ha/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ha/css/README.md b/ha/css/README.md
new file mode 100644
index 00000000000..04d5996ae52
--- /dev/null
+++ b/ha/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/ha/deploy/README.md b/ha/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/ha/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/ha/deploy/install_git.md b/ha/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ha/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ha/deploy/signup_pythonanywhere.md b/ha/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/ha/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ha/django/README.md b/ha/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/ha/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/ha/django_admin/README.md b/ha/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/ha/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ha/django_forms/README.md b/ha/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/ha/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/ha/django_installation/README.md b/ha/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/ha/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ha/django_installation/instructions.md b/ha/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/ha/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ha/django_models/README.md b/ha/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/ha/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ha/django_orm/README.md b/ha/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/ha/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ha/django_start_project/README.md b/ha/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/ha/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ha/django_templates/README.md b/ha/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/ha/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ha/django_urls/README.md b/ha/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/ha/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/ha/django_views/README.md b/ha/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/ha/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/ha/dynamic_data_in_templates/README.md b/ha/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/ha/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/ha/extend_your_application/README.md b/ha/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/ha/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/ha/how_the_internet_works/README.md b/ha/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/ha/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ha/html/README.md b/ha/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/ha/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ha/install_git.md b/ha/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ha/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ha/installation/README.md b/ha/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/ha/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ha/instructions.md b/ha/instructions.md
new file mode 100644
index 00000000000..30bd493b11b
--- /dev/null
+++ b/ha/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command dnf is not found. In that case you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ha/intro_to_command_line/README.md b/ha/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/ha/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ha/python_installation/README.md b/ha/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/ha/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ha/python_installation/instructions.md b/ha/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/ha/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ha/python_introduction/README.md b/ha/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/ha/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ha/signup_pythonanywhere.md b/ha/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/ha/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ha/template_extending/README.md b/ha/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/ha/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ha/whats_next/README.md b/ha/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/ha/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/he-IL/GLOSSARY.md b/he-IL/GLOSSARY.md
new file mode 100644
index 00000000000..3fd4bd9841f
--- /dev/null
+++ b/he-IL/GLOSSARY.md
@@ -0,0 +1,3 @@
+# עורך קוד
+
+עורך הקוד הוא יישום המאפשר לך לשמור את הקוד שלך, כך ניתן יהיה לחזור אליו מאוחר יותר. את יכולה ללמוד איפה להשיג אחד ב: [פרק עורך הקוד](./code_editor/README.md)
\ No newline at end of file
diff --git a/he-IL/README.md b/he-IL/README.md
new file mode 100644
index 00000000000..75a70330bb2
--- /dev/null
+++ b/he-IL/README.md
@@ -0,0 +1,51 @@
+# מדריך בנות ג'נגו
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## הקדמה
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## מה תלמדו במדריך זה?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+זה יראה (פחות או יותר) כך:
+
+![תמונה 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## אודות ועזרה
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/he-IL/SUMMARY.md b/he-IL/SUMMARY.md
new file mode 100644
index 00000000000..74202c108cd
--- /dev/null
+++ b/he-IL/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-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [התקנה (Chromebook)](chromebook_setup/README.md)
+* [איך עובד האינטרנט](how_the_internet_works/README.md)
+* [מבוא לשורת הפקודה](intro_to_command_line/README.md)
+* [התקנת פייתון](python_installation/README.md)
+* [עורך קוד](code_editor/README.md)
+* [מבוא לפייתון](python_introduction/README.md)
+* [מהו ג'אנגו?](django/README.md)
+* [התקנת ג'אנגו](django_installation/README.md)
+* [פרויקט הג'אנגו הראשון שלך!](django_start_project/README.md)
+* [מודלים של ג'אנגו](django_models/README.md)
+* [ג'אנגו אדמין](django_admin/README.md)
+* [מבצוע!](deploy/README.md)
+* [קישורי Django](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [מבוא לHTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [טפסי Django](django_forms/README.md)
+* [מה הלאה?](whats_next/README.md)
\ No newline at end of file
diff --git a/he-IL/chromebook_setup/README.md b/he-IL/chromebook_setup/README.md
new file mode 100644
index 00000000000..6fb4ee28864
--- /dev/null
+++ b/he-IL/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# קנפוג Chromebook
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/he-IL/chromebook_setup/instructions.md b/he-IL/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..159ca4047ec
--- /dev/null
+++ b/he-IL/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+ניתן [ לדלג מיד על החלק הזה](http://tutorial.djangogirls.org/en/installation/#install-python) אם אתם.ן לא משתמשים.ות בChromebook. אם כן, ההתקנה תהיה קצת שונה. באפשרותכן.ם להתעלם מהוראות ההתקנה אלו.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE הוא כלי שנותן לך עורך קוד וגישה למחשב הרץ על האינטרנט שעליו ניתן להוריד, לכתוב, ולהריץ תוכנות. במהלך המדריך, Cloud IDE ישמש כ*מחשב המקומי* שלך. עדיין תריצ.י פקודות בממשק הטרמינל בדיוק כמו שאר חבריך לכיתה בOS X, Ubuntu או Windows, אבל הטרמינל יהיה מחובר למחשב שפועל במקום אחר שcloud IDE מסדר בשבילך. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). ניתן לבחור אחד מהcloud IDEs, ולעקוב אחר ההוראות של הcloud IDEs.
+
+#### PaizaCloud Cloud IDE
+
+1. לכו ל [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. הירשמו ליצירת חשבון
+3. לחצו *שרת חדש* ובחרו באפליקציית הDjango
+4. לחצו על כפתור הטרמינל (בצד שמאל של החלון)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### סביבה וירטואלית
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/he-IL/code_editor/README.md b/he-IL/code_editor/README.md
new file mode 100644
index 00000000000..985b370699f
--- /dev/null
+++ b/he-IL/code_editor/README.md
@@ -0,0 +1,11 @@
+# עורך קוד
+
+> לקוראים בבית: הפרק הזה מופיע בסרטון [התקנת פייתון ועורך קוד](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+את עומדת לכתוב את שורת הקוד הראשונה שלך, אז הגיע הזמן להוריד עורך קוד!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/he-IL/code_editor/instructions.md b/he-IL/code_editor/instructions.md
new file mode 100644
index 00000000000..673a9f9aeee
--- /dev/null
+++ b/he-IL/code_editor/instructions.md
@@ -0,0 +1,37 @@
+יש המון עורכי קוד שונים, ובסופו של דבר זה מסתכם בהעדפה אישית. רוב מתכנתות הפייתון משתמשות בתוכנות עריכת קוד מתוחכמות יחסית, המכונות IDEs)(Integrated Development Environments, ובעברית - סביבות פיתוח משולבות, כמו PyCharm. אבל למתחילים זה כנראה פחות מתאים; עדיף להתחיל מעורך קוד שימושי לא פחות, אבל פשוט בהרבה.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[לחצי כאן להורדה](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[לחצי כאן להורדה](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[לחצי כאן להורדה](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/he-IL/css/README.md b/he-IL/css/README.md
new file mode 100644
index 00000000000..599b31bbbc6
--- /dev/null
+++ b/he-IL/css/README.md
@@ -0,0 +1,330 @@
+# CSS – בואו נעשה את זה יפה!
+
+הבלוג שלנו עדיין נראה די מכוער, לא? הגיע הזמן לגרום לו להראות טוב! בשביל זה, נשתמש ב-CSS.
+
+## מה זה CSS?
+
+CSS (Cascading Style Sheets, או בעברית - גליונות סגנון מדורגים) היא שפה המשמשת לתאר את המראה והעיצוב של אתר הכתוב בשפת markup (כמו HTML). תחשבו על זה כמו על איפור לדף אינטרנט שלנו. ;)
+
+אבל לא נרצה להתחיל את הכל מחדש, נכון? שוב פעם, נשתמש במשהו ששוחרר באינטרנט בחינם. להמציא את הגלגל זה לא כיף.
+
+## בואי נשתמש ב-Bootstrap!
+
+Bootstrap היא אחת מחבילות ה-HTML ו-CSS הפופולריות ביותר ליצירה של אתרים יפים: https://getbootstrap.com/
+
+היא נכתבה על ידי מתכנתות.ים שעבדו בטוויטר, ועכשיו היא מפותחת ומתוחזקת על ידי מתנדבים מכל העולם!
+
+## התקנת Bootstrap
+
+כדי להתקין את Bootstrap, עלינו לפתוח את קובץ ה`.html` בעורך הקוד ולהוסיף את זה לחלק ה`<head>`.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+זה לא מוסיף קבצים לפרויקט שלך; זה פשוט מצביע לקבצים קיימים באינטרנט. אז פשוט לכו על זה, תפתחו את הדפדפן, תרעננו את העמוד, והנה!
+
+![תמונה 14.1](images/bootstrap1.png)
+
+זה כבר נראה טוב יותר!
+
+## קבצים סטטיים ב Django
+
+סוף-סוף אנחנו יכולים להתעמק במה שנקרא **קבצים סטטיים** (או בעברית, קבועים). קבצים סטטיים הם כל התמונות וקבצי הCSS. Their content doesn't depend on the request context and will be the same for every user.
+
+### איפה לשים קבצים סטטיים בג'נגו
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+נעשה זאת על ידי יצירה של קובץ בשם `static` בתיקייה של האפליקציה שלנו:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django ימצא באופן אוטומטי את כל התיקיות בשם "static" בתוך כל אחת מהתיקיות של האפליקציה. ואז הוא יוכל להשתמש בתוכן שלהם כקבצים סטטיים.
+
+## קובץ ה-CSS הראשון שלך!
+
+בואו ניצור קובץ CSS עכשיו, כדי להוסיף את סטייל אישי לעמוד. תייצרי תיקייה חדשה בשם `css` בתוך תיקייה ה-`static` שלך. עכשיו, תייצרי קובץ חדש בשם `blog.css` בתוך תיקיית ה-`css`. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+הגיע הזמן לכתוב קצת CSS! תפתחי את הקובץ `blog/static/css/blog.css` בעורך הקוד שלך.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+אבל בואי נלמד לפחות קצת. Maybe we could change the color of our headers? כדי להבין צבעים, מחשבים משתמשים בקידודים מיוחדים. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. את גם יכולה להשתמש ב[צבעים מוגדרים מראש](http://www.w3schools.com/colors/colors_names.asp) עם שמות ידועים, כמו `red` ו-`green`.
+
+בקובץ `blog/static/css/blog.css` שלך, הוסיפי את השורות הבאות:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1` הוא מה שנקרא CSS Selector (או בעברית, בורר CSS). This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+בקובץ ה-CSS אנחנו בוחרים עיצוב לתגיות המופיעות בקובץ ה-HTML. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. המאפיינים class ו-id מוסיפים לתגיות שלך שמות שאת בוחרת בעצמך. מאפייני class מגדירים קבוצות (מחלקות) של תגיות, ומאפייני id מייחדים תגיות מסוימות. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. הרגע גילינו לתבנית שלנו איפה נמצא קובץ ה-CSS שלנו.
+
+בשלב הזה, הקובץ שלך צריך להיראות בערך כך:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+אחלה, תשמרי את הקובץ ותרענני את העמוד!
+
+![תמונה 14.2](images/color2.png)
+
+עבודה טובה! אולי עכשיו נוסיף לאתר שלנו קצת אוויר, ונגדיל את הרווח מצד שמאל? בואי ננסה!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![תמונה 14.3](images/margin2.png)
+
+אולי אנחנו יכולים לשנות קצת את הגופן בכותרות שלנו? תעתיקי לתוך ה-`<head>` של קובץ ה-0>blog/templates/blog/post_list.html</code> שלך את השורות הבאות:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![תמונה 14.3](images/font.png)
+
+מגניב!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+עכשיו נוסיף עיצוב למחלקות השונות שהגדרנו. סלקטורים המתחילים ב-`.` (נקודה) מתאימים למאפייני class. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+ואז תוסיפי את מאפייני ה-class לקוד ה-HTML שלך, שמציג את הפוסטים בבלוג. תחליפי את זה:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+בקובץ ה-`blog/templates/blog/post_list.html` שלך בזה:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+שמרו את הקבצים האלו ותרעננו את האתר.
+
+![תמונה 14.4](images/final.png)
+
+ווהו! נראה מדהים, נכון? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+מוכנה לפרק הבא?! :)
\ No newline at end of file
diff --git a/he-IL/deploy/README.md b/he-IL/deploy/README.md
new file mode 100644
index 00000000000..ad816a6de74
--- /dev/null
+++ b/he-IL/deploy/README.md
@@ -0,0 +1,246 @@
+# מבצוע!
+
+> **הערה:** הפרק הבא יחסית קשה. תתמידי ותסיימי אותו; מבצוע (מלשון מבצע, להפוך משהו למבצעי - באנגלית deployment) הוא חלק חשוב בתהליך בניית אתרים. פרק זה מופיע באמצע המדריך בכוונה, כדי שהחונכת שלך תוכל לעזור לך עם החלקים הקצת יותר טריקיים בהעלאת האתר שלך לאוויר. כך שאם יגמר לך הזמן, עדיין תוכלי לסיים את כל העסק בכוחות עצמך.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! מבצוע הוא תהליך הפרסום של האפליקציה שלך באינטרנט, כך שגם אנשי םאחרים יוכלו לראות אותה ולהשתמש בה. :)
+
+כמו שכבר למדת, אתר אינטרנט חייב להימצא על שרת. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+השירות החיצוני האחר שנשתמש בו הוא [GitHub](https://www.github.com), שהוא שירות אחסון קוד. יש גם כל מני שירותים אחרים, אבל כמעט לכל המתכנתים בימינו יש חשבון GitHub, אז עכשיו גם לך יהיה!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## מתחילים את ה-Git Repository
+
+Git עוקב אחרי שינויים בקבוצה מסוימת של קבצים שנקראת repository (או בקיצור, repo. עברית זה כנראה משהו כמו "מאגר"). בואי נייצר אחד בשביל הפרויקט שלנו. פתחי טרמינל והריצי את הפקודות הבאות בתיקייה של `djangogirls`:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. את אמורה להיות בתיקייה `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git יעקוב רק אחרי שינויים של קבצים בתיקייה הזו, אבל יש גם קבצים מסוימים שהיינו רוצים שהוא יתעלם מהם. אנחנו עושים זאת על ידי יצירת קובץ בשם `.gitignore` בתיקייה הראשית. פתחי את עורך הקוד שלך וצרי קובץ חדש עם השורות הבאות:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **הערה:** הנקודה בתחילת שם הקובץ חשובה! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+זה רעיון טוב להריץ `git status` לפני שמריצים `git add`, או בכל פעם שמשהו משתנה ולא בטוחים מה קורה. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+ולבסוף נשמור את השינויים. עברי ל - console והריצי את הפקודות הבאות:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/he-IL/deploy/install_git.md b/he-IL/deploy/install_git.md
new file mode 100644
index 00000000000..df8f317d4ca
--- /dev/null
+++ b/he-IL/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git היא תוכנת version control (ובעברית, בקרת גרסאות), שמתכנתים רבים משתמשים בה. התוכנה הזו יודעת לעקוב אחרי שינויים בקבצים לאורך זמן, כך שתמיד אפשר לעבור לגרסה אחרת מאוחר יותר. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## התקנת Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+את יכולה להוריד את git מ-[git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). מלבד זאת, אפשרויות ברירת המחדל הן סבבה. גם הסרת הסימון מ-Windows-style line endings והוספתו ב-Unix-style line endings היא רעיון לא רע.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/he-IL/deploy/signup_pythonanywhere.md b/he-IL/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/he-IL/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/he-IL/django/README.md b/he-IL/django/README.md
new file mode 100644
index 00000000000..6d7d48ba7c1
--- /dev/null
+++ b/he-IL/django/README.md
@@ -0,0 +1,27 @@
+# מהו ג'נגו?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. שלד תוכנה הוא קבוצה של רכיבים המסייעים לעזור לך בתכנות אתרי איטרנט באופן קל ומהיר יותר.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## למה צריך שלד?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/he-IL/django_admin/README.md b/he-IL/django_admin/README.md
new file mode 100644
index 00000000000..3d0fc0c2458
--- /dev/null
+++ b/he-IL/django_admin/README.md
@@ -0,0 +1,57 @@
+# דג'אנגו אדמין
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/he-IL/django_forms/README.md b/he-IL/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/he-IL/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/he-IL/django_installation/README.md b/he-IL/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/he-IL/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/he-IL/django_installation/instructions.md b/he-IL/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/he-IL/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/he-IL/django_models/README.md b/he-IL/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/he-IL/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/he-IL/django_orm/README.md b/he-IL/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/he-IL/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/he-IL/django_start_project/README.md b/he-IL/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/he-IL/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/he-IL/django_templates/README.md b/he-IL/django_templates/README.md
new file mode 100644
index 00000000000..9722f75871d
--- /dev/null
+++ b/he-IL/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![תמונה 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![תמונה 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![תמונה 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/he-IL/django_urls/README.md b/he-IL/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/he-IL/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/he-IL/django_views/README.md b/he-IL/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/he-IL/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/he-IL/dynamic_data_in_templates/README.md b/he-IL/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/he-IL/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/he-IL/extend_your_application/README.md b/he-IL/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/he-IL/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/he-IL/how_the_internet_works/README.md b/he-IL/how_the_internet_works/README.md
new file mode 100644
index 00000000000..fe50b17bcfa
--- /dev/null
+++ b/he-IL/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# איך עובד האינטרנט
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. דפדפני אינטרנט נועדו להבין קוד זה, לעקוב אחר ההוראות שלו, ולהציג את הקבצים מהם אתר האינטרנט שלך בנוי, בדיוק כפי שאת רוצה.
+
+כמו עם כל קובץ, יש לאחסן קבצי HTML איפשהו בדיסק הקשיח. עבור האינטרנט, קיימים מחשבים מיוחדים שנקראים *שרתים*. אין להם מסך, עכבר או מקלדת, כי המטרה העיקרית שלהם היא כדי לאחסן נתונים ולהנגיש אותם. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+ציירנו לך תמונה! זה נראה ככה:
+
+![איור 1.1](images/internet_1.png)
+
+נראה כמו בלגן, נכון? In fact it is a network of connected machines (the above-mentioned *servers*). מאות אלפי מכשירים! קילומטרים רבים של כבלים ברחבי העולם! תוכלו לבקר באתר מפת הכבלים התת-ימיים (http://submarinecablemap.com) כדי לראות כמה מסובך הוא האינטרנט. הנה צילום מסך מהאתר:
+
+![איור 1.2](images/internet_3.png)
+
+זה מרתק, נכון? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+זה נראה כך:
+
+![איור 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+המכתב שלך הולך לסניף הדואר הקרוב ביותר אליך. משם הוא הולך לאחד אחר, שקצת קרוב יותר לנמען, ואז לעוד אחד, ועוד אחד עד שמגיע ליעד. הדבר המיוחד היחיד הוא שכשאת שולחת מכתבים רבים (*חבילות נתונים*) לאותו המקום, הם יכולים לעבור בסניפי דואר (*נתבים*) שונים לגמרי. זה תלוי איך הם מופצים בכל אחד מהסניפים.
+
+![איור 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+במקום כתובות עם שם רחוב, עיר, מיקוד, שם מדינה, נשתמש בכתובות IP. המחשב שלך קודם מבקש מה-DNS (Domain Name System) לתרגם את djangogirls.org לכתובת IP. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. את גם משתמשת בשפה שהנמען יבין, נכון? זה נכון גם לגבי *חבילות הנתונים* שאת שולחת על מנת לראות אתר אינטרנט. אנו נשתמש בפרוטוקול בשם HTTP (פרוטוקול העברת היפר-טקסט).
+
+אז, בעיקרון, כאשר יש לך אתר אינטרנט, את צריכה *שרת* (מכשיר) שבו הוא חי. כאשר *השרת* מקבל *בקשה* נכנסת (במכתב), הוא שולח בחזרה את האתר שלך (במכתב אחר).
+
+Since this is a Django tutorial, you might ask what Django does. כאשר את שולחת תגובה, את לא תמיד רוצה לשלוח לכולם את אותו הדבר. זה הרבה יותר טוב אם המכתבים שלך מותאמים אישית, במיוחד עבור האדם שרק כתב לך, נכון? Django מסייע לך ביצירת המכתבים המעניינים והמותאמים אישית האלו. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/he-IL/html/README.md b/he-IL/html/README.md
new file mode 100644
index 00000000000..9056f98117b
--- /dev/null
+++ b/he-IL/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![תמונה 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![תמונה 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![תמונה 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![תמונה 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/he-IL/installation/README.md b/he-IL/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/he-IL/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/he-IL/intro_to_command_line/README.md b/he-IL/intro_to_command_line/README.md
new file mode 100644
index 00000000000..c9c0a87c097
--- /dev/null
+++ b/he-IL/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# מבוא לממשק שורת-הפקודה
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**הרשי לנו להציג את חברך החדש הראשון: שורת הפקודה!**
+
+השלבים הבאים יראו לך כיצד להשתמש בחלון השחור כמו כל ההאקרים. זה אולי נראה קצת מפחיד בהתחלה, אבל האמת שזה רק אות המחכה לפקודות ממך.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## מהי שורת הפקודה?
+
+החלון, אשר נקרא בדרך כלל **שורת פקודה** או **ממשק שורת-פקודה**, הוא יישום מבוסס טקסט עבור צפיה, טיפול ותפעול קבצים במחשב שלך. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. שמות אחרים עבור שורת הפקודה הם: *cmd*, *CLI*, *prompt*, *מסוף בקרה* או *טרמינל*.
+
+## פתיחת ממשק שורת פקודה
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## פקודה
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    <
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## הפקודה הראשונה שלך (הידד!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    whoami $ 
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    whoami <
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    whoami $ 
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/he-IL/intro_to_command_line/open_instructions.md b/he-IL/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/he-IL/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/he-IL/python_installation/README.md b/he-IL/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/he-IL/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/he-IL/python_installation/instructions.md b/he-IL/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/he-IL/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/he-IL/python_introduction/README.md b/he-IL/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/he-IL/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/he-IL/template_extending/README.md b/he-IL/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/he-IL/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/he-IL/whats_next/README.md b/he-IL/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/he-IL/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/he/GLOSSARY.md b/he/GLOSSARY.md
new file mode 100644
index 00000000000..3fd4bd9841f
--- /dev/null
+++ b/he/GLOSSARY.md
@@ -0,0 +1,3 @@
+# עורך קוד
+
+עורך הקוד הוא יישום המאפשר לך לשמור את הקוד שלך, כך ניתן יהיה לחזור אליו מאוחר יותר. את יכולה ללמוד איפה להשיג אחד ב: [פרק עורך הקוד](./code_editor/README.md)
\ No newline at end of file
diff --git a/he/README.md b/he/README.md
new file mode 100644
index 00000000000..d25f1c32b98
--- /dev/null
+++ b/he/README.md
@@ -0,0 +1,51 @@
+# מדריך בנות ג'נגו
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## הקדמה
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## מה תלמדו במדריך זה?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+זה יראה (פחות או יותר) כך:
+
+![תמונה 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## אודות ועזרה
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/he/SUMMARY.md b/he/SUMMARY.md
new file mode 100644
index 00000000000..d514f6211be
--- /dev/null
+++ b/he/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [הקדמה](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [איך עובד האינטרנט](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [עורך קוד](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [מהו ג'נגו?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [דג'אנגו אדמין](django_admin/README.md)
+* [מבצוע!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/he/chromebook_setup/README.md b/he/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/he/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/he/chromebook_setup/instructions.md b/he/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/he/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/he/code_editor/README.md b/he/code_editor/README.md
new file mode 100644
index 00000000000..e7ace593866
--- /dev/null
+++ b/he/code_editor/README.md
@@ -0,0 +1,11 @@
+# עורך קוד
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+את עומדת לכתוב את שורת הקוד הראשונה שלך, אז הגיע הזמן להוריד עורך קוד!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/he/code_editor/instructions.md b/he/code_editor/instructions.md
new file mode 100644
index 00000000000..c2a62157580
--- /dev/null
+++ b/he/code_editor/instructions.md
@@ -0,0 +1,31 @@
+יש המון עורכי קוד שונים, ובסופו של דבר זה מסתכם בהעדפה אישית. רוב מתכנתות הפייתון משתמשות בתוכנות עריכת קוד מתוחכמות יחסית, המכונות IDEs)(Integrated Development Environments, ובעברית - סביבות פיתוח משולבות, כמו PyCharm. אבל למתחילים זה כנראה פחות מתאים; עדיף להתחיל מעורך קוד שימושי לא פחות, אבל פשוט בהרבה.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+עורך חינמי עם קוד פתוח, שמתאים לכל מערכות ההפעלה.
+
+[לחצי כאן להורדה](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[לחצי כאן להורדה](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[לחצי כאן להורדה](https://atom.io/)
+
+## למה אנחנו מתקינות עורך קוד, בעצם?
+
+יכול להיות שאת שואלת את עצמך, למה אנחנו מתקינות תוכנה מיוחדת לעריכת קוד, במקום להשתמש במשהו כמו Word או Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/he/css/README.md b/he/css/README.md
new file mode 100644
index 00000000000..d16ef7d2400
--- /dev/null
+++ b/he/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+הבלוג שלנו עדיין נראה די מכוער, לא? הגיע הזמן לגרום לו להראות טוב! בשביל זה, נשתמש ב-CSS.
+
+## מה זה CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## בואי נשתמש ב-Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## התקנת Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![תמונה 14.1](images/bootstrap1.png)
+
+זה כבר נראה טוב יותר!
+
+## קבצים סטטיים ב Django
+
+סוף-סוף אנחנו יכולים להתעמק במה שנקרא **קבצים סטטיים** (או בעברית, קבועים). Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### איפה לשים קבצים סטטיים בג'נגו
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+נעשה זאת על ידי יצירה של קובץ בשם `static` בתיקייה של האפליקציה שלנו:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## קובץ ה-CSS הראשון שלך!
+
+Let's create a CSS file now, to add your own style to your web page. תייצרי תיקייה חדשה בשם `css` בתוך תיקייה ה-`static` שלך. עכשיו, תייצרי קובץ חדש בשם `blog.css` בתוך תיקיית ה-`css`. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+הגיע הזמן לכתוב קצת CSS! תפתחי את הקובץ `blog/static/css/blog.css` בעורך הקוד שלך.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+אבל בואי נלמד לפחות קצת. אולי נשנה את צבע הכותרות? כדי להבין צבעים, מחשבים משתמשים בקידודים מיוחדים. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. את גם יכולה להשתמש ב[צבעים מוגדרים מראש](http://www.w3schools.com/colors/colors_names.asp) עם שמות ידועים, כמו `red` ו-`green`.
+
+בקובץ `blog/static/css/blog.css` שלך, הוסיפי את השורות הבאות:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1` הוא מה שנקרא CSS Selector (או בעברית, בורר CSS). This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. במקרה כזה, אנחנו קובעים שצבע הטקסט יהיה `#FCA205`, שזה כתום. כמובן שאת יכולה לבחור כאן איזה צבע שמוצא-חן בעיניך!
+
+בקובץ ה-CSS אנחנו בוחרים עיצוב לתגיות המופיעות בקובץ ה-HTML. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. המאפיינים class ו-id מוסיפים לתגיות שלך שמות שאת בוחרת בעצמך. מאפייני class מגדירים קבוצות (מחלקות) של תגיות, ומאפייני id מייחדים תגיות מסוימות. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. הרגע גילינו לתבנית שלנו איפה נמצא קובץ ה-CSS שלנו.
+
+בשלב הזה, הקובץ שלך צריך להיראות בערך כך:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+אחלה, תשמרי את הקובץ ותרענני את העמוד!
+
+![תמונה 14.2](images/color2.png)
+
+עבודה טובה! אולי עכשיו נוסיף לאתר שלנו קצת אוויר, ונגדיל את הרווח מצד שמאל? בואי ננסה!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![תמונה 14.3](images/margin2.png)
+
+אולי אנחנו יכולים לשנות קצת את הגופן בכותרות שלנו? תעתיקי לתוך ה-`<head>` של קובץ ה-0>blog/templates/blog/post_list.html</code> שלך את השורות הבאות:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![תמונה 14.3](images/font.png)
+
+מגניב!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+יאללה, נסי לתת שמות לחתיכות קוד HTML. הוסיפי מאפיין class עם הערך `page-header` ל-`div` שמכיל את הכותרת שלך, ככה:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+ועכשיו תוסיפי מאפיין class בשם `post` ל-`div` שלך שמכיל את גוף ההודעה.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+עכשיו נוסיף עיצוב למחלקות השונות שהגדרנו. סלקטורים המתחילים ב-`.` (נקודה) מתאימים למאפייני class. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. בינתיים, פשוט תעתיקי ותדביקי אותו בקובץ ה-`blog/static/css/blog.css` שלך:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+ואז תוסיפי את מאפייני ה-class לקוד ה-HTML שלך, שמציג את הפוסטים בבלוג. תחליפי את זה:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+בקובץ ה-`blog/templates/blog/post_list.html` שלך בזה:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+תשמרי את הקבצים ותרענני את העמוד.
+
+![תמונה 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+מוכנה לפרק הבא?! :)
\ No newline at end of file
diff --git a/he/deploy/README.md b/he/deploy/README.md
new file mode 100644
index 00000000000..52d7edf9296
--- /dev/null
+++ b/he/deploy/README.md
@@ -0,0 +1,260 @@
+# מבצוע!
+
+> **הערה:** הפרק הבא יחסית קשה. תתמידי ותסיימי אותו; מבצוע (מלשון מבצע, להפוך משהו למבצעי - באנגלית deployment) הוא חלק חשוב בתהליך בניית אתרים. פרק זה מופיע באמצע המדריך בכוונה, כדי שהחונכת שלך תוכל לעזור לך עם החלקים הקצת יותר טריקיים בהעלאת האתר שלך לאוויר. כך שאם יגמר לך הזמן, עדיין תוכלי לסיים את כל העסק בכוחות עצמך.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! מבצוע הוא תהליך הפרסום של האפליקציה שלך באינטרנט, כך שגם אנשי םאחרים יוכלו לראות אותה ולהשתמש בה. :)
+
+כמו שכבר למדת, אתר אינטרנט חייב להימצא על שרת. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+השירות החיצוני האחר שנשתמש בו הוא [GitHub](https://www.github.com), שהוא שירות אחסון קוד. יש גם כל מני שירותים אחרים, אבל כמעט לכל המתכנתים בימינו יש חשבון GitHub, אז עכשיו גם לך יהיה!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## מתחילים את ה-Git Repository
+
+Git עוקב אחרי שינויים בקבוצה מסוימת של קבצים שנקראת repository (או בקיצור, repo. עברית זה כנראה משהו כמו "מאגר"). בואי נייצר אחד בשביל הפרויקט שלנו. פתחי טרמינל והריצי את הפקודות הבאות בתיקייה של `djangogirls`:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. את אמורה להיות בתיקייה `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git יעקוב רק אחרי שינויים של קבצים בתיקייה הזו, אבל יש גם קבצים מסוימים שהיינו רוצים שהוא יתעלם מהם. אנחנו עושים זאת על ידי יצירת קובץ בשם `.gitignore` בתיקייה הראשית. פתחי את עורך הקוד שלך וצרי קובץ חדש עם השורות הבאות:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **הערה:** הנקודה בתחילת שם הקובץ חשובה! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+זה רעיון טוב להריץ `git status` לפני שמריצים `git add`, או בכל פעם שמשהו משתנה ולא בטוחים מה קורה. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+ולבסוף נשמור את השינויים. עברי ל - console והריצי את הפקודות הבאות:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. תבדקי את זה!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# את באוויר!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/he/deploy/install_git.md b/he/deploy/install_git.md
new file mode 100644
index 00000000000..8df78e1c5f8
--- /dev/null
+++ b/he/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git היא תוכנת version control (ובעברית, בקרת גרסאות), שמתכנתים רבים משתמשים בה. התוכנה הזו יודעת לעקוב אחרי שינויים בקבצים לאורך זמן, כך שתמיד אפשר לעבור לגרסה אחרת מאוחר יותר. זה קצת כמו track changes ב-Microsoft Word, אבל הרבה יותר חזק.
+
+## התקנת Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+את יכולה להוריד את git מ-[git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). מלבד זאת, אפשרויות ברירת המחדל הן סבבה. גם הסרת הסימון מ-Windows-style line endings והוספתו ב-Unix-style line endings היא רעיון לא רע.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+תורידי git מ-[git-scm.com](https://git-scm.com/) ותעקבי אחרי ההוראות.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/he/deploy/signup_pythonanywhere.md b/he/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/he/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/he/django/README.md b/he/django/README.md
new file mode 100644
index 00000000000..04ee69426ad
--- /dev/null
+++ b/he/django/README.md
@@ -0,0 +1,27 @@
+# מהו ג'נגו?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. שלד תוכנה הוא קבוצה של רכיבים המסייעים לעזור לך בתכנות אתרי איטרנט באופן קל ומהיר יותר.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## למה צריך שלד?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/he/django_admin/README.md b/he/django_admin/README.md
new file mode 100644
index 00000000000..002b9a6484a
--- /dev/null
+++ b/he/django_admin/README.md
@@ -0,0 +1,57 @@
+# דג'אנגו אדמין
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/he/django_forms/README.md b/he/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/he/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/he/django_installation/README.md b/he/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/he/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/he/django_installation/instructions.md b/he/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/he/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/he/django_models/README.md b/he/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/he/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/he/django_orm/README.md b/he/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/he/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/he/django_start_project/README.md b/he/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/he/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/he/django_templates/README.md b/he/django_templates/README.md
new file mode 100644
index 00000000000..d409e1dc197
--- /dev/null
+++ b/he/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![תמונה 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![תמונה 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![תמונה 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![תמונה 13.4](images/donut.png)
\ No newline at end of file
diff --git a/he/django_urls/README.md b/he/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/he/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/he/django_views/README.md b/he/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/he/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/he/dynamic_data_in_templates/README.md b/he/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/he/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/he/extend_your_application/README.md b/he/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/he/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/he/how_the_internet_works/README.md b/he/how_the_internet_works/README.md
new file mode 100644
index 00000000000..0f2fb4f0b72
--- /dev/null
+++ b/he/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# איך עובד האינטרנט
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+הדבר הראשון שעליך להבין הוא שאתר אינטרנט הוא פשוט הרבה קבצים השמורים על דיסק קשיח. בדיוק כמו הסרטים, המוסיקה או התמונות שלך. עם זאת, יש חלק אחד ייחודי עבור אתרי אינטרנט: הם כוללים קוד מחשב הנקרא HTML.
+
+אם אתן לא מכירות תכנות זה יכול להיות קשה להבין HTML בהתחלה, אבל דפדפני האינטרנט שלך (כמו כרום, ספארי, פיירפוקס, וכו ') אוהבים את זה. דפדפני אינטרנט נועדו להבין קוד זה, לעקוב אחר ההוראות שלו, ולהציג את הקבצים מהם אתר האינטרנט שלך בנוי, בדיוק כפי שאת רוצה.
+
+כמו עם כל קובץ, יש לאחסן קבצי HTML איפשהו בדיסק הקשיח. עבור האינטרנט, קיימים מחשבים מיוחדים שנקראים *שרתים*. אין להם מסך, עכבר או מקלדת, כי המטרה העיקרית שלהם היא כדי לאחסן נתונים ולהנגיש אותם. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+ציירנו לך תמונה! זה נראה ככה:
+
+![איור 1.1](images/internet_1.png)
+
+נראה כמו בלגן, נכון? In fact it is a network of connected machines (the above-mentioned *servers*). מאות אלפי מכשירים! קילומטרים רבים של כבלים ברחבי העולם! תוכלו לבקר באתר מפת הכבלים התת-ימיים (http://submarinecablemap.com) כדי לראות כמה מסובך הוא האינטרנט. הנה צילום מסך מהאתר:
+
+![איור 1.2](images/internet_3.png)
+
+זה מרתק, נכון? אבל כמובן, לא ניתן להעביר כבל בין כל המכשירים המחוברים לאינטרנט. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+זה נראה כך:
+
+![איור 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+המכתב שלך הולך לסניף הדואר הקרוב ביותר אליך. משם הוא הולך לאחד אחר, שקצת קרוב יותר לנמען, ואז לעוד אחד, ועוד אחד עד שמגיע ליעד. הדבר המיוחד היחיד הוא שכשאת שולחת מכתבים רבים (*חבילות נתונים*) לאותו המקום, הם יכולים לעבור בסניפי דואר (*נתבים*) שונים לגמרי. זה תלוי איך הם מופצים בכל אחד מהסניפים.
+
+![איור 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+במקום כתובות עם שם רחוב, עיר, מיקוד, שם מדינה, נשתמש בכתובות IP. המחשב שלך קודם מבקש מה-DNS (Domain Name System) לתרגם את djangogirls.org לכתובת IP. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. את גם משתמשת בשפה שהנמען יבין, נכון? זה נכון גם לגבי *חבילות הנתונים* שאת שולחת על מנת לראות אתר אינטרנט. אנו נשתמש בפרוטוקול בשם HTTP (פרוטוקול העברת היפר-טקסט).
+
+אז, בעיקרון, כאשר יש לך אתר אינטרנט, את צריכה *שרת* (מכשיר) שבו הוא חי. כאשר *השרת* מקבל *בקשה* נכנסת (במכתב), הוא שולח בחזרה את האתר שלך (במכתב אחר).
+
+Since this is a Django tutorial, you might ask what Django does. כאשר את שולחת תגובה, את לא תמיד רוצה לשלוח לכולם את אותו הדבר. זה הרבה יותר טוב אם המכתבים שלך מותאמים אישית, במיוחד עבור האדם שרק כתב לך, נכון? Django מסייע לך ביצירת המכתבים המעניינים והמותאמים אישית האלו. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/he/html/README.md b/he/html/README.md
new file mode 100644
index 00000000000..7d4856ce8b4
--- /dev/null
+++ b/he/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![תמונה 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![תמונה 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![תמונה 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![תמונה 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/he/install_git.md b/he/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/he/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/he/installation/README.md b/he/installation/README.md
new file mode 100644
index 00000000000..2c02180fbc5
--- /dev/null
+++ b/he/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [מהו ג'נגו?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/he/instructions.md b/he/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/he/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/he/intro_to_command_line/README.md b/he/intro_to_command_line/README.md
new file mode 100644
index 00000000000..e925322d231
--- /dev/null
+++ b/he/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# מבוא לממשק שורת-הפקודה
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**הרשי לנו להציג את חברך החדש הראשון: שורת הפקודה!**
+
+השלבים הבאים יראו לך כיצד להשתמש בחלון השחור כמו כל ההאקרים. זה אולי נראה קצת מפחיד בהתחלה, אבל האמת שזה רק אות המחכה לפקודות ממך.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## מהי שורת הפקודה?
+
+החלון, אשר נקרא בדרך כלל **שורת פקודה** או **ממשק שורת-פקודה**, הוא יישום מבוסס טקסט עבור צפיה, טיפול ותפעול קבצים במחשב שלך. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. שמות אחרים עבור שורת הפקודה הם: *cmd*, *CLI*, *prompt*, *מסוף בקרה* או *טרמינל*.
+
+## פתיחת ממשק שורת פקודה
+
+כדי להתחיל ניסויים, עלינו קודם לפתוח את ממשק שורת פקודה שלנו.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+ככל הנראה תחת: Applications → Accessories → Terminal אבל זה תלוי במערכת ההפעלה שלך. אם זה לא שם, פשוט חפשי בגוגל. :)
+
+<!--endsec-->
+
+## פקודה
+
+את עכשיו אמורה לראות חלון לבן או שחור המחכה לפקודות שלך.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+אם את במקינטוש או Linux, את בטח רואה `$`, בדיוק כמו זה:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+ב- Windows, זה סימן `<`, כמו זה:
+
+{% filename %}command-line{% endfilename %}
+
+    <
+    
+
+<!--endsec-->
+
+סימן זה ועוד רווח יופיעו לפני כל פקודה, אך אין צורך להקליד אותו. המחשב שלך יעשה זאת בשבילך. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## הפקודה הראשונה שלך (הידד!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    whoami $ 
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    whoami <
+    
+
+<!--endsec-->
+
+ואז הקישי על `Enter`. זוהי התוצאה שלנו:
+
+{% filename %}command-line{% endfilename %}
+
+    whoami $ 
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/he/python_installation/README.md b/he/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/he/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/he/python_installation/instructions.md b/he/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/he/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/he/python_introduction/README.md b/he/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/he/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/he/signup_pythonanywhere.md b/he/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/he/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/he/template_extending/README.md b/he/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/he/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/he/whats_next/README.md b/he/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/he/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/hi-IN/GLOSSARY.md b/hi-IN/GLOSSARY.md
new file mode 100644
index 00000000000..fcdf6a5a598
--- /dev/null
+++ b/hi-IN/GLOSSARY.md
@@ -0,0 +1,3 @@
+# कोड संपादㅗ허ㅏ
+
+कोड संपादक एक ऐसा एप्लिकेशन है जो आपको अपना कोड सहेजने की अनुमति देता है ताकि आप बाद में효ㅗ इसे वापस प्राप्त कर सकें। आप सीख सकते हैं कि [कोड संपादक ㅗㅗㅗㅕㅗअध्याय](./code_editor/README.md) में से एक कहां से प्राप्त करें
\ No newline at end of file
diff --git a/hi-IN/README.md b/hi-IN/README.md
new file mode 100644
index 00000000000..848d70be70d
--- /dev/null
+++ b/hi-IN/README.md
@@ -0,0 +1,51 @@
+# डीजेन्गो गर्ल प्रशिक्षण
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> यह कार्य क्रिएटिव कॉमन्स एट्रिब्यूशन-शेयर-अलाइक 4.0 इंटरनेशनल लाइसेंस के तहत लाइसेंस प्राप्त है। इस लाइसेंस की एक प्रति देखने के लिए, https://creativecommons.org/licenses/by-sa/4.0/ पर जाएं.
+
+## स्वागत है
+
+डीजेन्गो गर्ल प्रशिक्षण में आपका स्वागत है! हम आपको यहाँ देखकर खुश है| इस टुटोरियस में हम आपको वैब टैकनौलजि के दायरे में लेकर जाएंगे , हम आपको थोंड़ा थोंड़ा करकर बताएंगें की काम करने वाली वैब कैसे बनाते है|
+
+हर अनजान चीजों के साथ यह एक साहसिक काम होने वाला है , परंतु चिंता करने की बात नही है चूंकी आप यहाँतक हिम्मत जुटाकर आ चुके है , आप ठीक हो जाएंगे |:)
+
+## 3
+
+क्या आपको कभी ऐसा महसूस हुआ है कि दुनिया अधिकाधिक टैकनोलजी से जुड़ता जा रहा है, जिसको आप (अभी तक) सही से समझ नहीं पा रहे हैं? 5 6
+
+7
+
+यह ट्यूटोरियल आपको जादुई रूप से एक प्रोग्रामर में नहीं बदलेगा। 9 10 11
+
+12
+
+## 13
+
+एक बार ट्यूटोरियल समाप्त करने के बाद, आपके पास एक छोटा सा काम करता हुआ वेब एप्लीकेशन होगा: आपका अपना ब्लॉग। हम आपको दिखाएंगे कि इसे ऑनलाइन कैसे किया जाए, ताकि दूसरे आप के काम को देख सकें।
+
+15
+
+![16](images/application.png)
+
+> अगर आप टुटोरियल पर खुद काम करते हैं और आपके पास कोई कोच नही है जो समस्या आने पर आपकी मदद कर सके , हमारे पास आपके लिये एक चैट सिस्टम है: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial) 18 19
+
+ठीक है, चलो शुरुआत से शुरू करें</ 0></p> 
+
+## घर पर टुटोरियस फौलो करते हुए
+
+जैंगो गर्ल कार्यशाला में भाग लेना अद्भुत है , परंतु हम जानते है की एक में भाग लेना संभव नहीं है| यही कारण है कि हम आपको निम्नलिखित टुटोरियल घर पर आज़माने के लिये एनकरेज करते हैं| घर पर बैठे पाठको के लिए हम ऐसे वीडीयो तैयार कर रहे हैं जो आपके लिए टुटोरियल का अनुसरण करना आसान बना देंगे| यह कार्य अभी भी प्रगति में है परंतु अधिक से अधिक चीज़ें जल्द ही [ Coding for girls ](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) यूट्यूब चैनल पर आ जाएंगे|
+
+पहले से कवर किए गए प्रतिएक अध्याय र एक लिंक है जो सही वीडीयो की तरफ इशारा करता है|
+
+## 20
+
+टुटोरियल [ DjangoGirls](https://djangogirls.org/) द्वारा बनाए रखा हुआ है| 23.
+
+## क्या आप हमें अन्य भाषाओं में ट्यूटोरियल अनुवाद करने में मदद करना चाहते हैं?
+
+वर्तमान में अनुवादो को crowdin.com प्लेटफोर्म पर रखा गया है|
+
+https://crowdin.com/project/django-girls-tutorials
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/hi-IN/SUMMARY.md b/hi-IN/SUMMARY.md
new file mode 100644
index 00000000000..ee5120ab42b
--- /dev/null
+++ b/hi-IN/SUMMARY.md
@@ -0,0 +1,35 @@
+# सारांश
+
+* [3](README.md)
+* [स्थापना](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [इंटरनेट कैसे काम करता है](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [कोड एडिटर](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [Django क्या है?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [आगे क्या है?](whats_next/README.md)
\ No newline at end of file
diff --git a/hi-IN/chromebook_setup/README.md b/hi-IN/chromebook_setup/README.md
new file mode 100644
index 00000000000..9a6b25a145e
--- /dev/null
+++ b/hi-IN/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook सेटअप
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/hi-IN/chromebook_setup/instructions.md b/hi-IN/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..84544485eac
--- /dev/null
+++ b/hi-IN/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+यदि आप Chromebook का उपयोग नहीं कर रहे हैं तो आप [ दबाकर इस भाग को छोड़ सकते हैं।](http://tutorial.djangogirls.org/en/installation/#install-python) अगर आप उपयोग करते हैं, आपका इंस्टॉलेशन अनुभव थोड़ा अलग होगा। आप बाकी इंस्टालेशन निर्देश को अनदेखा कर सकते हैं।
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE एक ऐसा उपकरण है जो आपको कोड एडिटर और इंटरनेट से कंप्यूटर चलाने देता है, जहाँ आप सॉफ़्टवेयर इंस्टॉल, लिख और चला सकते हैं। ट्यूटोरियल के दौरान, cloud IDE आपके लिए *स्थानीय मशीन* की तरह कार्य करेगा। आप अभी भी अपने सहपाठियों की तरह OS X, Ubuntu, या Windows पर टर्मिनल इंटरफ़ेस में कमांड चला पा रहे होंगे, लेकिन आपका टर्मिनल कहीं और चलने वाले कंप्यूटर से कनेक्ट होगा जो cloud IDE आपके लिए सेट अप करता है। Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). आप cloud IDEs में से एक चुन सकते हैं, और cloud IDE के निर्देशों का पालन कर सकते हैं।
+
+#### PaizaCloud Cloud IDE
+
+1. [PaizaCloud Cloud IDE](https://paiza.cloud/) पर जाएँ
+2. खाता के लिए साइन अप करें
+3. Click *New Server* and choose the Django app
+4. टर्मिनल बटन पर क्लिक करें (विंडो के बाईं तरफ)
+
+अब आपको बाईं ओर बटन, एक साइडबार के साथ एक इंटरफ़ेस देखना चाहिए। इस तरह के प्रॉम्प्ट से टर्मिनल विंडो खोलने के लिए "Terminal" बटन पर क्लिक करें:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+PaizaCloud Cloud IDE का टर्मिनल आपके निर्देशों के लिए तैयार हो जाता है। आप इसे थोड़ा बड़ा बनाने के लिए विंडो को resize या maximize कर सकते हैं।
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/hi-IN/code_editor/README.md b/hi-IN/code_editor/README.md
new file mode 100644
index 00000000000..03b60efbe28
--- /dev/null
+++ b/hi-IN/code_editor/README.md
@@ -0,0 +1,11 @@
+# कोड एडिटर
+
+> घर के पाठकों के लिए: यह अध्याय [ Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) वीडियो में पूरा किया गया है।
+
+आप कोड की पहली लाइन लिखने जा रहे है इसलिए अब आप को कोड एडिटर डाउनलोड कर लेना चाहिये।
+
+> ** नोट:- </ strong> यदि आप Chromebook का उपयोग कर रहे हैं, तो इस अध्याय को छोड़ दें और सुनिश्चित करें कि आप [ Chromebook सेटअप ](../chromebook_setup/README.md) निर्देशों का पालन करें। आपके द्वारा चुने गए cloud IDE (PaizaCloud Cloud IDE or AWS Cloud9) में कोड संपादक शामिल है, और जब आप फ़ाइल मेनू से अपने IDE में कोई फ़ाइल खोलते हैं, तो आप स्वचालित ही संपादक का उपयोग कर पाएँगे।</p> 
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!</blockquote> 
+> 
+> {% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/hi-IN/code_editor/instructions.md b/hi-IN/code_editor/instructions.md
new file mode 100644
index 00000000000..b0624950360
--- /dev/null
+++ b/hi-IN/code_editor/instructions.md
@@ -0,0 +1,37 @@
+आपके पास टेक्स्ट एडिटर (जहाँ आप कोड लिखेंगे) के कई चुनाव उपलब्ध हैं। आप अपनी पसंद के अनुसार किसी भी टेक्स्ट एडिटर का प्रयोग कर सकते हैं। अधिकांश पायथन प्रोग्रामर जटिल लेकिन अत्यंत शक्तिशाली IDEs (Integrated Development Environments) का उपयोग करते हैं, जैसे कि PyCharm। एक नए व्यक्ति के लिए हम किसी वैसे टेक्स्ट एडिटर का सुझाव देंगे, जो समझने में सरल हो और जो साथ साथ में शक्तिशाली भी हो।
+
+हमारे सुझाव नीचे दिए गए हैं, लेकिन अपने कोच से पूछें कि उनकी वरीयताएंँ क्या हैं - उनसे सहायता प्राप्त करना आसान होगा।
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[इसे यहाँ से डाउनलोड करें।](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[इसे यहाँ से डाउनलोड करें।](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[इसे यहाँ से डाउनलोड करें।](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/hi-IN/css/README.md b/hi-IN/css/README.md
new file mode 100644
index 00000000000..b5ef5f4c4d9
--- /dev/null
+++ b/hi-IN/css/README.md
@@ -0,0 +1,330 @@
+# CSS – इसे सुंदर बनाएँ!
+
+अभी भी हमारा ब्लॉग अच्छा नहीं दिख रहा है। सही बात है ना ? इसीलिए अब समय आ गया है की हम इसे सुन्दर बनाएँ। इसके लिए हम CSS का इस्तेमाल करेंगे। 
+
+## सीएसएस क्या है?
+
+Cascading Style Sheets (CSS) एक भाषा है जो मार्कअप भाषा (जैसे HTML) में लिखी गई वेबसाइट के स्वरूप और फॉर्मेट का बताने के लिए प्रयोग की जाती है। इसे हमारे वेब पेज के लिए मेक-अप की तरह देखें। ;)
+
+लेकिन हम फिर से स्क्रैच से शुरू नहीं करना चाहते हैं, है ना? एक बार और, हम इंटरनेट पर प्रोग्रामर द्वारा मुफ्त में रिलीज़ किए गए किसी चीज़ का इस्तेमाल करेंगे। पहिया का अविष्कार फिर से करना कोई खेल नहीं है, आपको पता है।
+
+## चलिए बूटस्ट्रैप का उपयोग करें!
+
+बूटस्ट्रैप बढ़िया वेबसाइटों के विकास के लिए सबसे लोकप्रिय HTML और CSS फ्रेमवर्कोंं से एक है: वेबसाइट: https://getbootstrap.com/
+
+यह प्रोग्रामर द्वारा लिखे गए थे जिन्होंने ट्विटर के लिए काम किया था। अब यह दुनिया भर से स्वयंसेवकों द्वारा विकसित किया जा रहा है!
+
+## बूटस्ट्रैप इनस्टॉल करें। 
+
+बूटस्ट्रैप को इनस्टॉल करने के लिए, कोड एडिटर में अपनी `.html` फ़ाइल खोलें और इसे `<head>` अनुभाग से जोड़ें:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+यह आपकी परियोजना में कोई भी फाइल नहीं जोड़ता है। यह सिर्फ इंटरनेट पर मौजूद फ़ाइलों को इंगित करता है। तो आगे बढ़ें, अपनी वेबसाइट खोलें और पेज रीफ्रेश करें। यह रहा!
+
+![Figure 14.1](images/bootstrap1.png)
+
+पहले से ही अच्छे दिख रहा हैं!
+
+## Django में static फ़ाइलें
+
+आखिरकार हम इन चीजों पर नज़र डालेंगे जिन्हें हम **static files** कह रहे हैं। स्टेटिक फाइलें हमारी सभी CSS और images हैं। उनकी सामग्री अनुरोध संदर्भ पर निर्भर नहीं है और प्रत्येक उपयोगकर्ता के लिए समान होगी।
+
+### Django के लिए Static Files कहाँ रखें । 
+
+Django पहले से ही जानता है कि अंत: निर्मित "admin" ऐप के लिए स्टेटिक फ़ाइलों को कहाँ खोजें। अब हमें अपने `blog` ऐप के लिए कुछ स्टेटिक फाइलों को जोड़ने की जरूरत है।
+
+हम ब्लॉग ऐप के अंदर `static` नामक फ़ोल्डर बनाकर ऐसा करते हैं:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django स्वचालित रूप से आपके किसी भी ऐप के फ़ोल्डर्स के अंदर "static" नामक किसी भी फ़ोल्डर को ढूंढ लेगा। फिर यह स्टेटिक सामग्री के रूप में उनका उपयोग करने में सक्षम हो जाएगा।
+
+## आपकी पहली CSS फ़ाइल!
+
+चलिए अपने वेब पेज पर अपनी शैली जोड़ने के लिए अब एक CSS फ़ाइल बनाएँँ। अपनी `static` डायरेक्टरी के अंदर `css` नामक एक नई डायरेक्टरी बनाएँँ। फिर इस `css` डायरेक्टरी के अंदर `blog.css` नामक एक नई फ़ाइल बनाएँँ। तैयार?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+कुछ CSS! लिखने का समय आ गया। अपने कोड एडिटर में `blog/static/css/blog.css` फ़ाइल खोलें
+
+हम यहाँँ CSS के बारे में अनुकूलित करने(customizing) और सीखने में बहुत गहरा नहीं जाएँगे। यदि आप और जानना चाहते हैं तो इस पृष्ठ के अंत में एक मुफ्त CSS पाठ्यक्रम की संस्तुति है।
+
+लेकिन चलिए कम से कम थोड़ा करते हैं। शायद हम अपने हेडर का रंग बदल सकें? रंगों को समझने के लिए, कंप्यूटर विशेष कोड का उपयोग करते हैं। ये कोड `#` के बाद 6 अक्षर (A–F) और संख्याएँ (0-9) के साथ शुरू होते हैं। उदाहरण के लिए, नीले रंग का कोड `#0000FF` है। आप http://www.colorpicker.com/ पर कई रंगों के लिए रंग कोड पा सकते हैं। आप [पूर्वनिर्धारित रंग](http://www.w3schools.com/colors/colors_names.asp) का भी उपयोग कर सकते हैं, जैसे कि `लाल` और `हरा`।
+
+आपको `blog/static/css/blog.css` फ़ाइल में निम्न कोड जोड़ना चाहिए:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` एक CSS Selector है। This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/hi-IN/deploy/README.md b/hi-IN/deploy/README.md
new file mode 100644
index 00000000000..3650bbd75fe
--- /dev/null
+++ b/hi-IN/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. यह अध्याय बीच में इसलिए डाला गया है ताकि आपके अध्यापक आपकी वेबसाइट को ऑनलाइन डालने में आपकी मदद कर सके| This means you can still finish the tutorial on your own if you run out of time.
+
+अभी तक आपकी वेबसाइट सिर्फ आपके कंप्यूटर पर थी | अब आप उसे डिप्लॉय करना सीखेंगे | डिप्लोयिंग का मतलब इन्टरनेट पर अपनी एप्लीकेशन छापना ताकि दुसरे लोग उसे देख सके| :)
+
+जैसे apne सीखा, हर वेबसाइट एक सर्वर पर बनती है | There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/hi-IN/deploy/install_git.md b/hi-IN/deploy/install_git.md
new file mode 100644
index 00000000000..03c67bf872d
--- /dev/null
+++ b/hi-IN/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+आप Git [git-scm.com](https://git-scm.com/) से डाउनलोड कर सकते हैं। You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). उस के अलावा, चूक ठीक हैं। चेकआउट Windows-शैली, कमिट Unix-शैली लाइन समापनों को संशोधित अच्छा है।
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/hi-IN/deploy/signup_pythonanywhere.md b/hi-IN/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/hi-IN/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/hi-IN/django/README.md b/hi-IN/django/README.md
new file mode 100644
index 00000000000..e020914be8a
--- /dev/null
+++ b/hi-IN/django/README.md
@@ -0,0 +1,27 @@
+# Django क्या है?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/hi-IN/django_admin/README.md b/hi-IN/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/hi-IN/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/hi-IN/django_forms/README.md b/hi-IN/django_forms/README.md
new file mode 100644
index 00000000000..0cba45f8eea
--- /dev/null
+++ b/hi-IN/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+और अंत में ब्लॉग पोस्ट को स्मपादित(edit) और प्रेषित(post) करने के लिए हम अपनी वेबसाइट में एक अच्छी युक्ति लगाएंगे. Django admin ऐसे तो बहोत ही उपयोगी है लेकिन इसे सुन्दर और अपने अनुसार अनुकूलित बनाना थोड़ा कठिन है. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+Django form के बारे में सबसे अच्छी बात ये है के या तो हम शुरुवात से इसे निरूपित कर सकते है या फिर सीधे एक model form बना सकते है जो की फॉर्म के परिणाम को मॉडल में सरक्षित करेगा.
+
+और ये वही चीज़ है जो हम करना चाहते है: हम यहाँ पर एक form का निर्माण करेंगे हमारे post model के लिए.
+
+Django के प्रत्येक महत्वपूर्ण हिस्सों की तरह, form की भी अपनी स्वयं की फाइल: form.py होती ह.
+
+हमे उपरोक्त नाम से blog डायरेक्टरी में एक फाइल बनाना पड़ेगी. 
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+PostForm, जैसे की आप शायद सोच सकते है, ये हमारे form का नाम है We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+और यह बात है! हम सब करने की ज़रूरत अब एक view में प्रपत्र का उपयोग करें और यह एक टेम्पलेट में प्रदर्शित है।
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/hi-IN/django_installation/README.md b/hi-IN/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/hi-IN/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/hi-IN/django_installation/instructions.md b/hi-IN/django_installation/instructions.md
new file mode 100644
index 00000000000..d6c2debb523
--- /dev/null
+++ b/hi-IN/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> mkdir djangogirls The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/hi-IN/django_models/README.md b/hi-IN/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/hi-IN/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/hi-IN/django_orm/README.md b/hi-IN/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/hi-IN/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/hi-IN/django_start_project/README.md b/hi-IN/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/hi-IN/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/hi-IN/django_templates/README.md b/hi-IN/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/hi-IN/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/hi-IN/django_urls/README.md b/hi-IN/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/hi-IN/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/hi-IN/django_views/README.md b/hi-IN/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/hi-IN/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/hi-IN/dynamic_data_in_templates/README.md b/hi-IN/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/hi-IN/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/hi-IN/extend_your_application/README.md b/hi-IN/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/hi-IN/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/hi-IN/how_the_internet_works/README.md b/hi-IN/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/hi-IN/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/hi-IN/html/README.md b/hi-IN/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/hi-IN/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/hi-IN/installation/README.md b/hi-IN/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/hi-IN/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/hi-IN/intro_to_command_line/README.md b/hi-IN/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b5878e66991
--- /dev/null
+++ b/hi-IN/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# कमांड लाइन अंतराफलक से परिचय |
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## सारांश
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/hi-IN/intro_to_command_line/open_instructions.md b/hi-IN/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/hi-IN/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/hi-IN/python_installation/README.md b/hi-IN/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/hi-IN/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/hi-IN/python_installation/instructions.md b/hi-IN/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/hi-IN/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/hi-IN/python_introduction/README.md b/hi-IN/python_introduction/README.md
new file mode 100644
index 00000000000..e54924e8033
--- /dev/null
+++ b/hi-IN/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### सारांश
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### सारांश
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### सारांश
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## सारांश
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/hi-IN/template_extending/README.md b/hi-IN/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/hi-IN/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/hi-IN/whats_next/README.md b/hi-IN/whats_next/README.md
new file mode 100644
index 00000000000..54d36e87f94
--- /dev/null
+++ b/hi-IN/whats_next/README.md
@@ -0,0 +1,43 @@
+# आगे क्या है?
+
+अपने आप को बधाई दे! **आपने बहुत अच्छी तरह से काम किया है।** हमें गर्व है! <3
+
+### अब क्या करे?
+
+एक ब्रेक लें और आराम करें! आपने अभी-अभी कुछ बहुत बड़ा किया है।
+
+उसके बाद, अद्यतित रहने के लिए [फेसबुक](http://facebook.com/djangogirls) या[ ट्विटर ](https://twitter.com/djangogirls)पर Django गर्ल्स का पालन करना सुनिश्चित करें।
+
+### क्या आप कोई और संसाधन सुझा सकते हैं?
+
+हाँ! प्रोग्रामिंग कौशल के सभी प्रकार सीखने के लिए ऑनलाइन *बहुत* सारे संसाधन हैं - यह बहुत चुनौतीपूर्ण हो सकता है कि आगे कहां जाना है, लेकिन हमने आपको कवर किया है। Django गर्ल्स में आने से पहले आपकी रुचियां जो भी थीं, और जो भी रुचियां आपने पूरे ट्यूटोरियल में विकसित की हैं, यहां कुछ मुफ्त संसाधन (या बड़े मुक्त घटकों के साथ संसाधन) हैं, जिनका उपयोग आप वहीं करना चाहते हैं जहां आप होना चाहते हैं।
+
+#### Django
+
+- हमारी दूसरी पुस्तक, [Django गर्ल्स ट्यूटोरियल: एक्सटेंशन](https://tutorial-extensions.djangogirls.org/)
+- [Django के आधिकारिक ट्यूटोरियल](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS और JavaScript
+
+- [कोड अकादमी का वेब डेवलपमेंट कोर्स](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### पायथन
+
+- [कोड अकादमी का पायथन कोर्स](https://www.codecademy.com/learn/learn-python)
+- [गूगल का पायथन कोर्स](https://developers.google.com/edu/python/)
+- [जानें पायथन द हार्ड वे किताब](http://learnpythonthehardway.org/book/) - शुरुआती अभ्यास मुफ्त हैं 
+- [नए कोडर ट्यूटोरियल](http://newcoder.io/tutorials/) - यह आप पायथन का उपयोग कैसे कर सकते हैं इसके विभिन्न व्यावहारिक उदाहरण हैं
+- [एडेक्स](https://www.edx.org/course?search_query=python) - आप अधिकांश पाठ्यक्रमों को मुफ्त में ऑडिट कर सकते हैं, लेकिन यदि आप एक उच्च शिक्षा योग्यता के लिए प्रमाण पत्र या क्रेडिट चाहते हैं तो इसके लिए पैसे खर्च होंगे
+- [कौरसेरा के पायथन स्पेशलाइजेशन](https://www.coursera.org/specializations/python) - कुछ वीडियो लेक्चर मुफ्त में ऑडिट किए जा सकते हैं और आप इन कोर्सेज को लेकर एक कौरसेरा सर्टिफिकेट कमा सकते हैं
+- [पाइथन फॉर एवरीबॉडी](https://www.py4e.com/) - एवरीबॉडी स्पेशलाइजेशन के लिए कौरसेरा पायथन का एक स्वतंत्र और खुला संस्करण
+
+#### डेटा के साथ काम करना
+
+- [कोड अकादमी का डेटा साइंस कोर्स](https://www.codecademy.com/learn/paths/data-science)
+- [एडेक्स](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) - आप अधिकांश पाठ्यक्रमों को मुफ्त में ऑडिट कर सकते हैं, लेकिन यदि आप एक उच्च शिक्षा योग्यता के लिए प्रमाण पत्र या क्रेडिट चाहते हैं तो इसके लिए पैसे खर्च होंगे
+- [डेटाक्वेस्ट](https://www.dataquest.io/) - पहले 30 "मिशन" मुफ्त हैं
+
+हम यह देखने के लिए इंतजार नहीं कर सकते कि आप आगे क्या बनाते हैं!
\ No newline at end of file
diff --git a/hi/GLOSSARY.md b/hi/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/hi/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/hi/README.md b/hi/README.md
new file mode 100644
index 00000000000..0e9b253f84d
--- /dev/null
+++ b/hi/README.md
@@ -0,0 +1,51 @@
+# Django tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## 3
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? 5 6
+
+7
+
+This tutorial will not magically turn you into a programmer. 9 10 11
+
+12
+
+## 13
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+15
+
+![16](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). 18 19
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## 20
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). 23.
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/hi/SUMMARY.md b/hi/SUMMARY.md
new file mode 100644
index 00000000000..a33520c6388
--- /dev/null
+++ b/hi/SUMMARY.md
@@ -0,0 +1,27 @@
+# सारांश
+
+* [3](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [कोड एडिटर](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [Django क्या है?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [आगे क्या है?](whats_next/README.md)
\ No newline at end of file
diff --git a/hi/chromebook_setup/README.md b/hi/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/hi/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/hi/chromebook_setup/instructions.md b/hi/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/hi/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/hi/code_editor/README.md b/hi/code_editor/README.md
new file mode 100644
index 00000000000..f6718d30dee
--- /dev/null
+++ b/hi/code_editor/README.md
@@ -0,0 +1,11 @@
+# कोड एडिटर
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+आप कोड की पहली लाइन लिखने जा रहे है इसलिए अब आप को कोड एडिटर डाउनलोड कर लेना चाहिये।
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/hi/code_editor/instructions.md b/hi/code_editor/instructions.md
new file mode 100644
index 00000000000..a0f4297140d
--- /dev/null
+++ b/hi/code_editor/instructions.md
@@ -0,0 +1,31 @@
+आपके पास टेक्स्ट एडिटर (जहाँ आप कोड लिखेंगे) के कई चुनाव उपलब्ध हैं। आप अपनी पसंद के अनुसार किसी भी टेक्स्ट एडिटर का प्रयोग कर सकते हैं। ज्यादातर प्रोग्रामर काफी जटिल परंतु शक्तिशाली IDE (जिसमे कई कार्य करने की क्षमता हो) का प्रयोग करते हैं जैसे की PyCharm। एक नए व्यक्ति के लिए हम किसी वैसे टेक्स्ट एडिटर का सुझाव देंगे, जो समझने में सरल हो और जो साथ साथ में शक्तिशाली भी हो।
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit एक ओपन सोर्स (open source), मुफ्त एडिटर है जो सभी ऑपरेटिंग सिस्टम्स (OS) के लिए उपलब्ध है।
+
+[इसे यहाँ से डाउनलोड करें।](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[इसे यहाँ से डाउनलोड करें।](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[इसे यहाँ से डाउनलोड करें।](https://atom.io/)
+
+## हम क्यों एक कोड एडिटर इनस्टॉल रहे हैं ?
+
+हो सकता है आप सोच रहे हो की भला हम नया कोड एडिटर सॉफ्टवेयर क्यों इनस्टॉल कर रहे है वर्ड (Word) या नोटपैड (Notepad) इस्तेमाल क्यों नहीं कर रहे। 
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/hi/css/README.md b/hi/css/README.md
new file mode 100644
index 00000000000..9aba6336131
--- /dev/null
+++ b/hi/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+अभी भी हमारा ब्लॉग अच्छा नहीं दिख रहा है। सही बात है ना ? इसीलिए अब समय आ गया है की हम इसे सुन्दर बनाये। इसके लिए हम CSS का इस्तेमाल करेंगे। 
+
+## सीएसएस क्या है?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## चलो बूटस्ट्रैप का उपयोग करें!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## बूटस्ट्रैप इनस्टॉल करें। 
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+पहले से ही अच्छे नहीं लग रहा !
+
+## Django में static फ़ाइलें
+
+आखिर कर हम अब उस चीज पे भी एक करीबी निगाह डालते है जिससे हम **Static Files** कहते है। Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Django के लिए Static Files कहाँ रखें । 
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/hi/deploy/README.md b/hi/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/hi/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/hi/deploy/install_git.md b/hi/deploy/install_git.md
new file mode 100644
index 00000000000..08d3bf66fc0
--- /dev/null
+++ b/hi/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+आप Git [git-scm.com](https://git-scm.com/) से डाउनलोड कर सकते हैं। You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). उस के अलावा, चूक ठीक हैं। चेकआउट Windows-शैली, कमिट Unix-शैली लाइन समापनों को संशोधित अच्छा है।
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Git [git-scm.com](https://git-scm.com/) से डाउनलोड करें और बस निर्देशों का पालन करें।
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/hi/deploy/signup_pythonanywhere.md b/hi/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/hi/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/hi/django/README.md b/hi/django/README.md
new file mode 100644
index 00000000000..448cf5bc609
--- /dev/null
+++ b/hi/django/README.md
@@ -0,0 +1,27 @@
+# Django क्या है?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/hi/django_admin/README.md b/hi/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/hi/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/hi/django_forms/README.md b/hi/django_forms/README.md
new file mode 100644
index 00000000000..d5a909bc55f
--- /dev/null
+++ b/hi/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+और अंत में ब्लॉग पोस्ट को स्मपादित(edit) और प्रेषित(post) करने के लिए हम अपनी वेबसाइट में एक अच्छी युक्ति लगाएंगे. Django admin ऐसे तो बहोत ही उपयोगी है लेकिन इसे सुन्दर और अपने अनुसार अनुकूलित बनाना थोड़ा कठिन है. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+Django form के बारे में सबसे अच्छी बात ये है के या तो हम शुरुवात से इसे निरूपित कर सकते है या फिर सीधे एक model form बना सकते है जो की फॉर्म के परिणाम को मॉडल में सरक्षित करेगा.
+
+और ये वही चीज़ है जो हम करना चाहते है: हम यहाँ पर एक form का निर्माण करेंगे हमारे post model के लिए.
+
+Django के प्रत्येक महत्वपूर्ण हिस्सों की तरह, form की भी अपनी स्वयं की फाइल: form.py होती ह.
+
+हमे उपरोक्त नाम से blog डायरेक्टरी में एक फाइल बनाना पड़ेगी. 
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+PostForm, जैसे की आप शायद सोच सकते है, ये हमारे form का नाम है We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+और यह बात है! हम सब करने की ज़रूरत अब एक view में प्रपत्र का उपयोग करें और यह एक टेम्पलेट में प्रदर्शित है।
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/hi/django_installation/README.md b/hi/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/hi/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/hi/django_installation/instructions.md b/hi/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/hi/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/hi/django_models/README.md b/hi/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/hi/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/hi/django_orm/README.md b/hi/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/hi/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/hi/django_start_project/README.md b/hi/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/hi/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/hi/django_templates/README.md b/hi/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/hi/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/hi/django_urls/README.md b/hi/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/hi/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/hi/django_views/README.md b/hi/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/hi/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/hi/dynamic_data_in_templates/README.md b/hi/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/hi/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/hi/extend_your_application/README.md b/hi/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/hi/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/hi/how_the_internet_works/README.md b/hi/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/hi/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/hi/html/README.md b/hi/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/hi/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/hi/install_git.md b/hi/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/hi/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/hi/installation/README.md b/hi/installation/README.md
new file mode 100644
index 00000000000..7ae28037d41
--- /dev/null
+++ b/hi/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [Django क्या है?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/hi/instructions.md b/hi/instructions.md
new file mode 100644
index 00000000000..d042926b29a
--- /dev/null
+++ b/hi/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for you instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/hi/intro_to_command_line/README.md b/hi/intro_to_command_line/README.md
new file mode 100644
index 00000000000..4bc7703d781
--- /dev/null
+++ b/hi/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# कमांड लाइन अंतराफलक से परिचय |
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## सारांश
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/hi/python_installation/README.md b/hi/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/hi/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/hi/python_installation/instructions.md b/hi/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/hi/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/hi/python_introduction/README.md b/hi/python_introduction/README.md
new file mode 100644
index 00000000000..cb27f81ce70
--- /dev/null
+++ b/hi/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### सारांश
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### सारांश
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### सारांश
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## सारांश
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/hi/signup_pythonanywhere.md b/hi/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/hi/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/hi/template_extending/README.md b/hi/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/hi/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/hi/whats_next/README.md b/hi/whats_next/README.md
new file mode 100644
index 00000000000..1bd3c2fe0e6
--- /dev/null
+++ b/hi/whats_next/README.md
@@ -0,0 +1,25 @@
+# आगे क्या है?
+
+अपने आप को बधाई दे! **आपने बहुत अच्छी तरह से काम किया है।** हमें आप पर गर्व ह! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/hr-HR/GLOSSARY.md b/hr-HR/GLOSSARY.md
new file mode 100644
index 00000000000..3ef18986ca0
--- /dev/null
+++ b/hr-HR/GLOSSARY.md
@@ -0,0 +1,3 @@
+# uređivač koda
+
+Uređivač koda je aplikacija koja ti omogućuje da spremiš svoj kod kako bi mu se mogla poslije vratiti. Možeš saznati gdje nabaviti jedan od njih iz poglavlja [Uređivač teksta](./code_editor/README.md)
\ No newline at end of file
diff --git a/hr-HR/README.md b/hr-HR/README.md
new file mode 100644
index 00000000000..58c902dee17
--- /dev/null
+++ b/hr-HR/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Ovo djelo ima Creative Commons Attribution-ShareAlike 4.0 International Licence dozvolu. Posjetite https://creativecommons.org/licenses/by-sa/4.0/ za kopiju licence
+
+## Dobrodošli
+
+Dobrodošli na Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Uvod
+
+Jesi li se ikada osjećala kako je u svijetu sve više i više tehnologije koju (još) ne možeš shvatiti? Jesi li se ikada pitala kako stvoriti web stranicu ali nisi imala dovoljno motivacije započeti? Jesi li ikad mislila da je svijet softvera presložen za tebe da uopće pokušaš raditi nešto na svoju ruku?
+
+E pa, imamo odlične vijesti za tebe! Programiranje uopće nije tako teško kao što se čini i želimo ti pokazati koliko može biti zabavno.
+
+Ovaj tutorijal te neće čarobno pretvoriti u programera. Ako želiš biti odlična u tome, trebat će ti mjeseci ili čak godine učenja i vježbe. Ali mi ti želimo pokazati kako programiranje i stvaranje web stranica ne mora biti teško kao što se čini. Pokušat ćemo ti objasniti različite dijelove što bolje možemo, da se ne osjećaš zastrašeno tehnologijom.
+
+Nadamo se da ćemo ti moći prenesti našu ljubav prema tehnologiji!
+
+## Što ćeš naučiti tijekom tutorijala?
+
+Jednom kad završiš ovaj tutorijal, imat ćeš jednu malu web aplikaciju koja radi: vlastiti blog. Pokazat ćemo ti kako da to staviš online, tako da drugi mogu vidjeti tvoj rad!
+
+Blog će (više-manje) izgledati ovako:
+
+![Figure 0.1](images/application.png)
+
+> Ako samostalno prolaziš tutorijal i nemaš učitelja koji će ti pomoći s bilo kakvim problemom, imamo *chat* sustav za tebe: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Zamolili smo naše učitelje i prošle pohađatelje da budu tamo s vremena na vrijeme i pomognu drugima s tutorijalom! Ne boj se postavljanja pitanja!
+
+OK,[krenimo od početka...](./how_the_internet_works/README.md)
+
+## Praćenje tutorijala kod kuće
+
+Nevjerojatno je biti dio Django Girls radionica, ali svjesni smo da to nije uvijek moguće. Zato te potičemo da pokušaš pratiti ovaj tutorijal i kod kuće. Za čitatelje doma, trenutno pripremamo videe s kojim će ti biti lakše pratiti tutorijale na svoju ruku. To je sve još uvijek u nastajanju, ali sve više i više stvari bit će pokrivene na YouToube kanalu [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed).
+
+U svakom poglavlju koje je pokriveno, postoji link koji vodi na odgovarajući video.
+
+## O tutorijalu i doprinosima
+
+Ovaj tutorijal održavaju [DjangoGirls](https://djangogirls.org/). Ako nađete bilo kakve greške ili želite ažurirati tutorijal, molim.
+
+## Želiš li nam pomoći prevesti tutorijal na druge jezike?
+
+Trenutno, prijevodi se drže na platforni crowdin.com na adresi:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Ako tvoj jezik nije na popisu na [crowdinu](https://crowdin.com/), molimo [otvori novi issue](https://github.com/DjangoGirls/tutorial/issues/new) tako nas informirajući o jeziku kojeg želiš dodati. (Preveli: Amalija Ramljak i Marijan Smetko)
\ No newline at end of file
diff --git a/hr-HR/SUMMARY.md b/hr-HR/SUMMARY.md
new file mode 100644
index 00000000000..3bb39d14699
--- /dev/null
+++ b/hr-HR/SUMMARY.md
@@ -0,0 +1,35 @@
+# Sažetak
+
+* [Uvod](README.md)
+* [Instalacija](installation/README.md) 
+  * [Komandna linija](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Uređivač koda](installation/README.md#code-editor)
+  * [Virutalno okruženje](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [Python Anywhere](installation/README.md#pythonanywhere-account)
+* [Instalacija (chromebook)](chromebook_setup/README.md)
+* [Kako radi internet](how_the_internet_works/README.md)
+* [Uvod u naredbenu liniju](intro_to_command_line/README.md)
+* [Instalacija Pythona](python_installation/README.md)
+* [Uređivač koda](code_editor/README.md)
+* [Uvod u Python](python_introduction/README.md)
+* [Što je Django?](django/README.md)
+* [Instalacija Djanga](django_installation/README.md)
+* [Tvoj prvi Django projekt!](django_start_project/README.md)
+* [Django modeli](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Postavi na server!](deploy/README.md)
+* [Django url](django_urls/README.md)
+* [Django views - vrijeme za stvaranje!](django_views/README.md)
+* [Uvod u HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dinamički podaci u predlošcima](dynamic_data_in_templates/README.md)
+* [Django predlošci](django_templates/README.md)
+* [CSS - poljepšaj](css/README.md)
+* [Nadograđivanje predložaka](template_extending/README.md)
+* [Nadograđivanje tvoje aplikacije](extend_your_application/README.md)
+* [Django formulari](django_forms/README.md)
+* [Što je sljedeće?](whats_next/README.md)
\ No newline at end of file
diff --git a/hr-HR/chromebook_setup/README.md b/hr-HR/chromebook_setup/README.md
new file mode 100644
index 00000000000..a31591cf132
--- /dev/null
+++ b/hr-HR/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Postavljanje Chromebooka
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/hr-HR/chromebook_setup/instructions.md b/hr-HR/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..ab41b5e67fe
--- /dev/null
+++ b/hr-HR/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Možeš [odmah preskočiti ovaj dio](http://tutorial.djangogirls.org/en/installation/#install-python) ako ne koristiš Chromebook. Ako ipak koristiš, tvoje će iskustvo instalacije biti malo drugačije. Možeš ignorirati ostatak uputa za instalaciju.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud 9 je alat koji ti daje uređivač koda i pristup računalu pokrenutom na Internetu gdje možeš instalirati, pisati i pokretati programsku potporu (eng. software). Za vrijeme tutorijala, Cloud 9 služit će kao tvoj *lokalni stroj*. I dalje ćeš pokretati naredbe u terminalu kao i tvoji kolege iz razreda na OS X, Ubuntu ili Windowsima, ali tvoj će terminal biti povezan na računalo pokrenuto negdje drugdje gdje ga Cloud 9 postavi za tebe. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virutalno okruženje
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### Python Anywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/hr-HR/code_editor/README.md b/hr-HR/code_editor/README.md
new file mode 100644
index 00000000000..b6dfaed980b
--- /dev/null
+++ b/hr-HR/code_editor/README.md
@@ -0,0 +1,11 @@
+# Uređivač koda
+
+> Za čitatelje doma: ovo poglavlje je pokriveno u videu [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+Uskoro ćeš napisati svoju vlastitu liniju koda, stoga je vrijeme da preuzmeš uređivač koda!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/hr-HR/code_editor/instructions.md b/hr-HR/code_editor/instructions.md
new file mode 100644
index 00000000000..82fbac15aad
--- /dev/null
+++ b/hr-HR/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/hr-HR/css/README.md b/hr-HR/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/hr-HR/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/hr-HR/deploy/README.md b/hr-HR/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/hr-HR/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/hr-HR/deploy/install_git.md b/hr-HR/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/hr-HR/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/hr-HR/deploy/signup_pythonanywhere.md b/hr-HR/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..3790bc1de6f
--- /dev/null
+++ b/hr-HR/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Stvaranje PythonAnywhere API tokena
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/hr-HR/django/README.md b/hr-HR/django/README.md
new file mode 100644
index 00000000000..b1b5ae8aa32
--- /dev/null
+++ b/hr-HR/django/README.md
@@ -0,0 +1,27 @@
+# Što je Django?
+
+Django (*Džan-go*) je web framework koji je besplatan i otvorenog koda. Web framework je skup komponenti koje ti pomažu brže i lakše razvijati web stranice.
+
+Kada stvaraš web stranicu, uvijek ćeš trebati slične komponente: autentikacija korisnika (prijava, odjava), način upravljanja svoje stranice, formulari, učitavanje datoteka itd.
+
+Srećom, drugi ljudi su davno primjetili da se većina web programera susreće sa istim problemima kad stvaraju novu stranicu, pa su se udružili i stvorili razne frameworke (tipa Django) koji ti daju gotove komponente na korištenje.
+
+Frameworksi postoje da bi te spasili od potrebe "izmišljanja tople vode" i da ti smanje potrebu pisanja previše koda kada stvaraš novu stranicu.
+
+## Zašto ti treba framework?
+
+Za razumijevanje za što zapravo služi Django moramo pobliže pogledati poslužitelje. Prva stvar koju poslužitelji trebaju znati je da ti želiš da ti oni posluže web stranicu.
+
+Zamisli npr. poštanski sandučić (port) kojeg nadzireš za nadolazeća pisma (zahtjeve). To radi web poslužitelj. Web poslužitelj pročita pismo i pošalje odgovor s web stranicom. Ali, ako želiš poslati nešto, moraš imati sadržaj. Upravo je Django tu da ti pomogne stvoriti sadržaj.
+
+## Što se događa kad netko zatraži web stranicu s tvog poslužitelja?
+
+Čim zahtjev dođe na web poslužitelj, zahtjev se prosljeđuje Djangu koji zatim pokušava odgonetnuti što je zapravo zatraženo. On najprije uzme adresu web stranice i pokuša odgonetnuti što treba učiniti. Taj dio radi Djangov **urlresolver** (imaj na umu da se adresa web stranice naziva još i URL - Uniform Resource Locator - stoga *urlresolver* razrješava url stranice). Nije baš najpametniji - ima listu obrazaca s kojom uspoređuje adrese. Django provjerava obrasce od vrha prema dnu i ako nešto odgovara, tad Django proslijedi zahtjev pridruženoj funkciji (koja se naziva *view* - *pogled*).
+
+Zamisli poštara sa pismom. On hoda niz ulicu i uspoređuje svaki kućni broj sa brojem na pismu. Ako su brojevi isti, tamo ostavi pismo. Upravo na ovaj način radi urlresolver!
+
+U *view* funkciji događaju se sve zanimljive stvari: možemo potražiti neke informacije u bazi podataka. Možda je korisnik zatražio da mu promijenimo podatke? Poput pisma u kojem piše:"Molim promjeniti opis mog posla.". *View* će provjeriti je li ti dozvoljena ta radnja, zatim će za tebe promjeniti opis posla i vratiti poruku:"Gotovo!". Tada *view* stvara odgovor i Django ga potom šalje korisnikovom web pregledniku.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/hr-HR/django_admin/README.md b/hr-HR/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/hr-HR/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/hr-HR/django_forms/README.md b/hr-HR/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/hr-HR/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/hr-HR/django_installation/README.md b/hr-HR/django_installation/README.md
new file mode 100644
index 00000000000..38213c5aa0b
--- /dev/null
+++ b/hr-HR/django_installation/README.md
@@ -0,0 +1,7 @@
+# Instalacija Djanga
+
+> **Napomena:** Ako koristiš chromebook, preskoči ovo poglavlje i prati upute [Postavljanje Chromebooka](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/hr-HR/django_installation/instructions.md b/hr-HR/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/hr-HR/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/hr-HR/django_models/README.md b/hr-HR/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/hr-HR/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/hr-HR/django_orm/README.md b/hr-HR/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/hr-HR/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/hr-HR/django_start_project/README.md b/hr-HR/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/hr-HR/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/hr-HR/django_templates/README.md b/hr-HR/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/hr-HR/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/hr-HR/django_urls/README.md b/hr-HR/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/hr-HR/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/hr-HR/django_views/README.md b/hr-HR/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/hr-HR/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/hr-HR/dynamic_data_in_templates/README.md b/hr-HR/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/hr-HR/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/hr-HR/extend_your_application/README.md b/hr-HR/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/hr-HR/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/hr-HR/how_the_internet_works/README.md b/hr-HR/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/hr-HR/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/hr-HR/html/README.md b/hr-HR/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/hr-HR/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/hr-HR/installation/README.md b/hr-HR/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/hr-HR/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/hr-HR/intro_to_command_line/README.md b/hr-HR/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/hr-HR/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/hr-HR/intro_to_command_line/open_instructions.md b/hr-HR/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/hr-HR/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/hr-HR/python_installation/README.md b/hr-HR/python_installation/README.md
new file mode 100644
index 00000000000..cf48a314dc1
--- /dev/null
+++ b/hr-HR/python_installation/README.md
@@ -0,0 +1,15 @@
+# Počnimo s Pythonom
+
+Konačno smo tu!
+
+Ali prvo, poslušaj što je točno Python. Python je vrlo popularan programski jezik koji se može koristiti za stvaranje web stranica, igara, softver u znanosti, grafici i puno puno više.
+
+Python potiče iz kasnih 1980-ih i njegov glavni cilj je da je čitljiv za ljudska bića (a ne samo strojeve!). Zato i izgleda puno jednostavnije od drugih programskih jezika, ali ne brini - Python je također vrlo moćan!
+
+# Instalacija Pythona
+
+> **Napomena:** Ako koristiš chromebook, preskoči ovo poglavlje i prati upute [Postavljanje Chromebooka](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/hr-HR/python_installation/instructions.md b/hr-HR/python_installation/instructions.md
new file mode 100644
index 00000000000..3809909b988
--- /dev/null
+++ b/hr-HR/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Za čitatelje kod kuće: ovo poglavlje je pokriveno u videu [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> Ovaj odjeljak je napisan prema tutorijalu Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/hr-HR/python_introduction/README.md b/hr-HR/python_introduction/README.md
new file mode 100644
index 00000000000..50dd224b9b1
--- /dev/null
+++ b/hr-HR/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Uvod u Python
+
+> Dio ovoga poglavlja temelji se na tutorijalima Geek Girls Carrots-a (https://github.com/ggcarrots/django-carrots).
+
+Idemo nešto kodirati!
+
+## Pythonov prompt
+
+> Za čitatelje kod kuće: ovaj je dio pokriven u [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) videu.
+
+Kako bismo se počeli igrati s Pythonom, moramo otvoriti *naredbeni redak*. To ne bi trebao biti problem - učili smo to u poglavlju [Uvod u naredbeni redak](../intro_to_command_line/README.md).
+
+Kada si spremna, prati sljedeće upute.
+
+Želimo otvoriti Python konzolu. Upiši `python` ako si na Windowsima, a `python3` na Mac OS/Linuxu i pritisni `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Tvoja prva Python naredba!
+
+Nakon što smo pokrenuli naredbu Python, prompt se promijenio u `>>>`. Nama to znači da za sada smijemo koristiti samo naredbe jezika Python. Ne moraš utipkati `>>>` - Python će to činiti za tebe.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Tada više nećeš vidjeti `>>>`.
+
+Za sada ne želimo izaći iz Pythonove konzole, već želimo naučiti više o njoj. Započnimo tipkanjem malo matematike, npr. `2 + 3`, i pritiskanjem `enter`-a.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Super! Vidiš kako je odgovor iskočio? Python zna matematiku! Možeš isprobati druge naredbe poput:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Za izvođenje eksponencijalnog računa, recimo 2 na eksponent 3, pišemo: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Prvo se malo zabavljaj s ovime, a onda se vrati ovdje. :)
+
+Kao što vidiš, Python je odličan kalkulator. Ako se pitaš što još možeš raditi…
+
+## Stringovi (znakovni nizovi)
+
+Što kažeš na svoje ime? Upiši svoje ime ovako u navodne znakove:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+Sada je stvoren tvoj prvi string! String je slijed znakova koji računalo može obraditi. On uvijek mora započeti i završiti istim znakom. Taj znak može biti ili jednostruki (`'`) ili dvostruki (`"`) navodni znak (nema razlike!). Navodnici govore Pythonu da je ono između njih string.
+
+Stringovi mogu biti nanizani zajedno. Isprobaj ovo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+Također možeš množiti stringove brojem:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Ako moraš staviti apostrof u svoj string, postoje dva načina na koja to možeš učiniti.
+
+Koristeći dvostruke navodnike:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+ili zanemarujući taj apostrof kosom crtom unazad (`"`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Upravo si pozvala `upper` **metodu** na svom stringu! Metoda (poput `upper()`) je niz instrukcija koje Python mora izvesti nad danim objektom (`"Ola"`) kada ju pozoveš.
+
+Ako želiš znati koliko slova ima tvoje ime, postoji **funkcija** i za to!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Pitaš se zašto ponekad zoveš funkcije s `.` na kraju stringa (`"Ola".upper()`), a ponekad prvo pozoveš funkciju i staviš string u zagrade? Pa, u nekim slučajevima funkcije pripadaju objektima, poput `upper()` koja se može izvesti samo nad stringovima. U tom slučaju, funkcije nazivamo **metodama**. U drugim trenutcima funkcije ne pripadaju ničemu određenom te mogu biti korištene s različitim vrstama objekata kao, na primjer, `len()`. Zbog toga funkciji `len()` prosljeđujemo `"Ola"` kao parametar.
+
+### Sažetak
+
+OK, dosta stringova. Do sad je naučeno:
+
+- **prompt** - tipkanje naredaba (koda) u Pythonov prompt rezultira odgovorima u Pythonu
+- **brojevi i stringovi** - u Pythonu brojevi se koriste za matematiku, a stringovi za tekstualne objekte
+- **operatori** - poput `+` i `*`, kombiniraju vrijednosti radi stvaranja nove
+- **funkcije** - poput `upper()` i `len()`, izvode radnje na objektima.
+
+Ovo su osnove svakog programskog jezika koji učiš. Spremna za nešto teže? Kladimo se da jesi!
+
+## Greške
+
+Idemo isprobati nešto novo. Možemo li dobiti duljinu broja na jednak način na koji smo mogli saznali duljinu našega imena? Utipkaj `len(304023)` i pritisni `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Dobili smo našu prvu grešku! Ikona {{ warning_icon }} je naš način najavljivanja tebi da kod koji se spremaš pokrenuti neće raditi kako očekuješ. Pravljenje grešaka (čak i namjernih) bitan je dio učenja!
+
+Piše da objekti tipa "int" (integers, cijeli brojevi) nemaju duljinu. I što sada? Možda možemo napisati naš broj kao string; stringovi imaju duljinu, zar ne?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Radi! Iskoristili smo `str()` funkciju unutar `len()` funkcije. `str()` pretvara sve u stringove.
+
+- `str()` funkcija pretvara stvari u **stringove**
+- `int()` funkcija pretvara stvari u **cijele brojeve (integers)**
+
+> Bitno: brojeve možemo pretvoriti u tekst, no ne moramo nužno moći pretvoriti tekst u brojeve - što bi `int("hello")` uopće bilo?
+
+## Varijable
+
+Bitan koncept u programiranju su varijable. Varijabla nije ništa više nego ime za nešto pomoću kojega to nešto možeš poslije koristiti. Programeri koriste varijable za spremanje podataka, osiguranje čitljivosti koda te kako ne bi morali stalno pamtiti koja im vrijednost sljedeća treba.
+
+Recimo da želimo stvoriti novu varijablu nazvanu `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+Utipkamo name jednako Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Jupii! Tvoja prva varijabla! :) Uvijek možeš promijeniti na što se ona odnosi:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+Možeš ju također koristiti u funkcijama:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Ali što ako smo iskoristili krivo ime? Možeš li pogoditi što bi se dogodilo? Isprobajmo!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Greška! Ko što vidiš, Python ima različite vrste grešaka, a ova se zove **NameError**. Python će ti javiti ovu grešku ako pokušaš koristiti varijablu koja još nije definirana. Ako se kasnije susretneš s ovom greškom, provjeri svoj kod da vidiš imaš li krivo napisanih imena.
+
+Igraj se s ovime neko vrijeme i vidi što sve možeš raditi!
+
+## Funkcija print
+
+Isprobaj ovo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Kada upišeš samo `name`, Pythonov prevoditelj odgovara sa stringovskom *reprezentacijom* varijable 'name', a ona je slova M-a-r-i-a omeđena jednostrukim navodnicima, '. Kada napišeš `print(name)`, Python ispiše ("printa") sadržaj varijable na zaslon, ali bez navodnika, što je urednije.
+
+Kao što ćemo kasnije vidjeti, `print()` je također koristan kada želimo ispisati stvari iz funkcija ili kada želimo ispis u više linija.
+
+## Liste
+
+Osim stringova i cijelih brojeva, Python ima svakakve razne vrste objekata. Sada ćemo predstaviti jednu zvanu **lista**. Liste su točno ono što misliš da jesu: objekti koji su liste drugih objekata. :)
+
+Hajde napravi listu:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Da, ova je lista prazna. Nije baš korisno, zar ne? Idemo napraviti listu brojeva lota. Ne želimo se cijelo vrijeme ponavljati pa ćemo listu staviti u varijablu:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+Uredu, imamo listu! Što možemo raditi s njom? Idemo vidjeti koliko loto brojeva ima u listi. Imaš li ikakvu ideju koju bi funkciju trebalo iskoristiti za to? Znaš to već!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Da! `len()` ti može dati broj objekata u listi. Korisno, zar ne? Možda ćemo ju sada sortirati:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Ovo ništa ne vraća, samo je promijenilo redoslijed u kojem se brojevi pojavljuju u listi. Idemo ju opet ispisati i vidjeti što se dogodilo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Kao što možeš vidjeti, brojevi u tvojoj listi sada su sortirani od najniže prema najvišoj vrijednosti. Čestitamo!
+
+Možda želimo obrnuti taj redoslijed? Idemo to napraviti!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+Ako želiš nešto dodati u svoju listu, možeš to upisivanjem iduće naredbe:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Ako želiš prikazati samo prvi broj, možeš to učiniti korištenjem **indeksa**. Indeks je broj koji govori gdje se u listi nalazi neki objekt. Programeri radije započinju brojanje krenuvši od 0, tako da je prvi objekt u tvojoj listi na indeksu 0, sljedeći je na 1, itd. Isprobaj ovo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Kao što možeš vidjeti, možeš pristupiti različitim objektima u svojoj listi korištenjem imena liste i indeksa traženog objekta unutar uglatih zagrada.
+
+Za brisanje nečega iz svoje liste morat ćeš koristiti **indekse** o kojima smo gore naučili te `pop()` metodu. Idemo isprobati jedan primjer i učvrstiti prethodno stečeno znanje; brisat ćemo prvi broj iz naše liste.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+Za dodatnu zabavu, isprobajte neke druge indekse: 6, 7, 1000, -1, -6 ili -1000. Vidi možeš li predvidjeti rezultat prije isprobavanja naredbe. Imaju li ti rezultati smisla?
+
+Popis svih metoda za liste koje su na raspolaganju možeš pronaći u ovom poglavlju Pythonove dokumentacije: https://docs.python.org/3/tutorial/datastructures.html
+
+## Rječnici
+
+> Za čitatelje kod kuće: ovaj je dio pokriven u [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) videu.
+
+Rječnik je sličan listi, ali vrijednosti dohvaćaš tražeći ključ umjesto numeričkog indeksa. Ključ može biti bilokoji string ili broj. Sintaksa za definiranje praznoga rječnika je:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+To pokazuje da je upravo stvoren prazan rječnik. Hura!
+
+Sada pokušaj napisati iduću naredbu (također pokušaj zamijeniti svojim informacijama):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+Ovom naredbom stvorena je varijabla `participant` s tri para ključ-vrijednost:
+
+- Ključ `name` pokazuje na vrijednost `'Ola'` (`string` objekt),
+- `country` pokazuje na `'Poland'` (još jedan `string`),
+- a `favorite_numbers` pokazuje na `[7, 42, 92]` (`lista` s tri broja).
+
+Možeš provjeriti sadržaj individualnih ključeva idućom sintaksom:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Vidiš, slično je listi. Ali ne moraš pamtiti indeks - samo ključ.
+
+Što se dogodi ako pitamo Python vrijednost nepostojećega ključa? Možeš li pogoditi? Idemo probati i vidjeti!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Vidi, još jedna greška! Ova je **KeyError** - Python je koristan i kaže ti da ključ `'age'` ne postoji u ovom rječniku.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Trebaš li samo poredani niz stvari? Odaberi listu.
+- Trebaš li povezati vrijednosti sa ključevima kako bi se poslije efikasno moglo pretraživati pomoću ključa? Odaberi rječnik.
+
+Rječnici, poput list, su *promjenjivi*, što znači da ih se može promijeniti nakon što su stvoreni. Možeš dodati novi ključ-vrijednost par u rječnik poslije stvaranja, i to ovako:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Nadam se da sve do sada ima smisla. :) Spremna za još malo zabave s rječnicima? Čitaj dalje za neke nevjerojatne stvari.
+
+Možeš koristiti `pop()` metodu za brisanje stvari iz rječnika. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Kao što možeš vidjeti iz ispisa, par ključ-vrijednost koji pripada 'favorite_numbers' ključu je pobrisan.
+
+Osim toga, možeš i promijeniti vrijednost povezanu s već postojećim ključem u rječniku. Napiši ovo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Kao što vidiš, vrijednost ključa `'country'` je promijenjena iz `'Poland'` u `'Germany'` . :) Uzbudljivo? Hura! Upravo si naučila još jednu nevjerojatnu stvar.
+
+### Sažetak
+
+Odlično! Sada znaš mnogo o programiranju. U ovom je zadnjem dijelu naučeno:
+
+- **greške** - sada znaš kako čitati i razumjeti greške koje se pojavljuju ako Python ne razumije dobivenu naredbu
+- **varijable** - imena za objekte, omogućuju ti lakše kodiranje i da ti kod bude što čitljiviji
+- **liste** - liste objekata spremljene u određenom redoslijedu
+- **rječnici** - objekti spremljeni kao parovi ključ-vrijednost
+
+Uzbuđena za nastavak? :)
+
+## Uspoređivanje stvari
+
+> Za čitatelje kod kuće: ovaj je dio pokriven u [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) videu.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Pitaš li se zašto smo stavili dva znaka jednakosti `==` jedan pored drugog za usporedbu jednakosti brojeva? Koristimo jednostruki `=` za dodijeljivanje vrijednosti varijablama. Uvijek, **uvijek** moraš staviti dva znaka - `==` - ako želiš provjeriti jesu li dvije stvari jednake. Također možemo reći da su stvari različite. Za to koristimo simbol `!=` kao što je prikazano u gornjem primjeru.
+
+Daj Pythonu još dva zadatka:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+Vidjeli smo `>` i `<`, ali što znače `>=` i `<=`? Čitaj ih ovako:
+
+- x `>` y znači: x je veći od y
+- x `<` y znači: x je manji od y
+- x `<=` y znači: x je manji od ili jednak y
+- x `>=` y znači: x je veći od ili jednak y
+
+Odlično! Želiš li još jedan zadatak? Probaj ovo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Pythonu možeš dati koliko god brojeva želiš za usporedbu i on će ti dati odgovor! Poprilično pametno, zar ne?
+
+- **and** – ako koristiš `and` operator, obje usporedbe moraju biti istinite (True) kako bi cijela naredba bila istinita
+- **or** – ako koristiš `or` operator, samo jedna usporedba mora biti True kako bit cijela naredba bila True
+
+Je li ti poznat izraz "uspoređivati kruške s jabukama"? Idemo isprobati Pythonov ekvivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Ovdje vidiš da, kao i u izrazu, Python ne može uspoređivati broj (`int`) i string (`str`). Umjesto toga pokazuje **TypeError** i govori nam da ta dva tipa ne mogu biti uspoređena.
+
+## Boolean
+
+Slučajno si upravo naučila o novom tipu objekta u Pythonu. Zove se **Boolean**.
+
+Postoje samo dva Boolean objekta:
+
+- True
+- False
+
+Ali kako bi Python to razumio, uvijek to moraš pisati kao 'True' (prvo slovo veliko, ostala mala). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleani također mogu biti varijable! Vidi ovo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+To također možeš napraviti ovako:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Vježbaj i zabavi se s Booleanima tako da pokušaš izvesti iduće naredbe:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Čestitamo! Booleani su jedna od najkul značajki programiranja, a ti si upravo naučila kako ih koristiti!
+
+# Spremi ga!
+
+> Za čitatelje kod kuće: ovaj je dio pokriven u [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) videu.
+
+Do sada smo sav svoj Python kod pisali u prevoditelj, što nas ograničava na unošenje jedne po jedne linije koda. Normalni su programi spremljeni u datoteke i izvode ih **prevoditelj** ili **kompajler (compiler)** našega programskog jezika. Do sada smo pokretali naše programe liniju po liniju u Pythonovom **prevoditelju**. Trebat će nam više od jedne linije koda za sljedećih par zadataka, pa ćemo brzo morati:
+
+- Izađi iz Pythonovog prevoditelja
+- Otvori naš izbor uređivača koda
+- Spremi neki kod u novu Python datoteku
+- Pokreni ga!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+To će te vratiti u naredbeni redak.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Očito, sada si već poprilično iskusna Python developerica, pa slobodno napiši nešto koda što si danas naučila.
+
+Sada moramo spremiti datoteku i dati joj opisno ime. Idemo ju nazvati **python_intro.py** i spremiti ju na tvoj zaslon. Datoteku možemo nazvati kako želimo, ali bitno je da osiguramo da datoteka završava s **.py**. **.py** ekstenzija govori našem operacijskom sustavu da je to **izvršna Python datoteka** i da ju Python može pokrenuti.
+
+> **Napomena:** Trebala bi primijetiti jednu od prefora stvari kod uređivača koda: boje! U Python konzoli, sve je bilo iste boje; sada bi trebala vidjeti da je `print` funkcija drugačije boje nego string. To se zove "sintaksno isticanje" i jako je korisna značajka kod kodiranja. Boja stvari dat će ti migove (hintove) poput nezatvorenih stringova ili grešaka u pisanju ključnih riječi (kao `def` u funkciji koju ćemo vidjeti dolje). To je jedan od razloga zašto koristimo uređivač koda. :)
+
+Kada je datoteka spremljena, vrijeme je da ju se pokrene! Koristeći vještine koje si naučila u sekciji naredbenog retka, iskoristi terminal da **promijeniš direktorij** u zaslon.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Na Macu, naredba će izgledati ovako nekako:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### Što ako uvjet nije istinit?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Komentari
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Sažetak
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Tvoje vlastite funkcije!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Petlje
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Sažetak
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/hr-HR/template_extending/README.md b/hr-HR/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/hr-HR/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/hr-HR/whats_next/README.md b/hr-HR/whats_next/README.md
new file mode 100644
index 00000000000..f15bff7639f
--- /dev/null
+++ b/hr-HR/whats_next/README.md
@@ -0,0 +1,43 @@
+# Što sada?
+
+Čestitaj sebi! **Totalno si super.** Ponosne smo! <3
+
+### Što da sada radim?
+
+Take a break and relax! You have just done something really huge.
+
+Poslije toga, ne zaboravi pratiti Django Girls na [Facebook](http://facebook.com/djangogirls)-u ili [Twitter](https://twitter.com/djangogirls)-u da budeš pravovremeno informirana o svemu.
+
+### Možete li predložit neke daljnje izvore?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/hu-HU/GLOSSARY.md b/hu-HU/GLOSSARY.md
new file mode 100644
index 00000000000..0b906ac1f3c
--- /dev/null
+++ b/hu-HU/GLOSSARY.md
@@ -0,0 +1,3 @@
+# kódszerkesztő
+
+A kódszerkesztő egy alkalmazás, amely segítségével elmentheted a kódodat, így később vissza tudsz térni hozzá. A [Kódszerkesztő fejezetből](./code_editor/README.md) tudhatod meg, hogyan juthatsz hozzá
\ No newline at end of file
diff --git a/hu-HU/README.md b/hu-HU/README.md
new file mode 100644
index 00000000000..356f98b31e5
--- /dev/null
+++ b/hu-HU/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Bevezetés
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Gondolkoztál már azon, hogyan kell egy weblapot létrehozni, de soha nem volt elég erőd elkezdeni? Érezted úgy, hogy a szoftveres világ túl bonyolult ahhoz, hogy egyáltalán megpróbálj valamit létrehozni benne magadtól?
+
+Nos, jó hírünk van számodra! A programozás egyáltalán nem olyan nehéz, mint amilyennek tűnik, és mi megmutatjuk, hogy mennyire jó móka tud lenni.
+
+This tutorial will not magically turn you into a programmer. Ha profi akarsz lenni benne, hónapokat vagy akár éveket kell eltöltened tanulással és gyakorlással. De meg szeretnénk mutatni, hogy a programozás, illetve a weblapkészítés nem annyira bonyolult, mint amilyennek tűnik. Megpróbáljuk minél jobban elmagyarázni a különböző részleteket, hogy ne tűnjön annyira ijesztőnek a technológia.
+
+Reméljük, veled is annyira megszerettetjük a számítógépek világát, mint amennyire mi szeretjük!
+
+## Mit fogsz a tutorial alatt megtanulni?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+Körülbelül így fog kinézni:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Megkértük a segítőinket és korábbi résztvevőket, hogy legyenek fent, ahogy idejük engedi, és segítsenek másoknak a tutorialban. Kérdezz tőlük bátran!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## A tutorialról és a közreműködésről
+
+Ezt a tutorialt a [DjangoGirls](https://djangogirls.org/) tartja fenn. Ha bármilyen hibát találsz benne, vagy frissíteni szeretnéd, kérlek kövesd a [közreműködési útmutatót](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/hu-HU/SUMMARY.md b/hu-HU/SUMMARY.md
new file mode 100644
index 00000000000..498033f5a96
--- /dev/null
+++ b/hu-HU/SUMMARY.md
@@ -0,0 +1,35 @@
+# Összefoglaló
+
+* [Bevezetés](README.md)
+* [Installáció](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [Hogy működik az Internet?](how_the_internet_works/README.md)
+* [Bevezetés a parancssor használatába](intro_to_command_line/README.md)
+* [A Python telepítése](python_installation/README.md)
+* [Kódszerkesztő (editor)](code_editor/README.md)
+* [Bevezetés a Pythonba](python_introduction/README.md)
+* [Mi a Django?](django/README.md)
+* [Django telepítés](django_installation/README.md)
+* [Az első Django projekted!](django_start_project/README.md)
+* [Django modellek](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Bevezetés a HTML-be](html/README.md)
+* [Django ORM és QuerySet-ek](django_orm/README.md)
+* [Dinamikus adatok a template-ben](dynamic_data_in_templates/README.md)
+* [Django sablonok (template)](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template-kiegészítés](template_extending/README.md)
+* [Egészítsd ki az applikációdat](extend_your_application/README.md)
+* [Django űrlapok](django_forms/README.md)
+* [Következő lépések](whats_next/README.md)
\ No newline at end of file
diff --git a/hu-HU/chromebook_setup/README.md b/hu-HU/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/hu-HU/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/hu-HU/chromebook_setup/instructions.md b/hu-HU/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..4f4177ea212
--- /dev/null
+++ b/hu-HU/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtuális környezet
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/hu-HU/code_editor/README.md b/hu-HU/code_editor/README.md
new file mode 100644
index 00000000000..0caf81013f1
--- /dev/null
+++ b/hu-HU/code_editor/README.md
@@ -0,0 +1,11 @@
+# Kódszerkesztő (editor)
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+Nemsokára megírod a kód első sorát, itt az ideje letölteni egy kódszerkesztőt!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/hu-HU/code_editor/instructions.md b/hu-HU/code_editor/instructions.md
new file mode 100644
index 00000000000..3b13162efc1
--- /dev/null
+++ b/hu-HU/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Sokféle kódszerkesztő program létezik, és valójában ízlés kérdése, hogy ki melyiket választja. A legtöbb Python programozó bonyolult fejlesztői környezetet (IDE - Integrated Development Environment) használ, mint például a PyCharm. Egy kezdőnek viszont nem ezek a legmegfelelőbbek. A programok, amiket mi ajánlunk, hasonlóan hatékonyak, de használatuk sokkal egyszerűbb.
+
+Mi az alábbiakat javasoljuk, de nyugodtan kérj segítséget a coach-odtól, ő is könnyen tud tanácsot adni ez ügyben.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Letöltés](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Letöltés](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Letöltés](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/hu-HU/css/README.md b/hu-HU/css/README.md
new file mode 100644
index 00000000000..41817f7c388
--- /dev/null
+++ b/hu-HU/css/README.md
@@ -0,0 +1,330 @@
+# CSS - csinosítsd ki!
+
+Egyelőre nem túl szép a blogunk, igaz? Itt az ideje, hogy kicsinosítsd! Erre a CSS-t fogjuk használni.
+
+## Mi a CSS?
+
+A CSS (Cascading Style Sheets) egy nyelv, amit a HTML-ben megírt weboldalak kinézetének leírására használunk. Vagyis mintha kisminkelnéd a weboldaladat. ;)
+
+De ugye mi nem akarunk mindent elölről kezdeni? Megint csak egy olyat fogunk használni, amit a programozók kitettek az internetre, ingyenesen. A kerék újra feltalálás tudod nem olyan jó dolog.
+
+## Használjunk Bootstrapet!
+
+A Bootstrap az egyik legnépszerűbb HTML és CSS keretrendszer, amivel szép weboldalakat készíthetünk: https://getbootstrap.com/
+
+Eredetileg a Twitternél dolgozó programozók készítették, de most önkéntesek fejlesztik szerte a világon!
+
+## Bootstrap telepítés
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![14.1 ábra](images/bootstrap1.png)
+
+Már sokkal jobban néz ki!
+
+## Statikus fájlok a Django-ban
+
+Most nézzük meg kicsit közelebbről ezeket a "**statikus fájl**"-nak nevezett dolgokat. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Hová pakoljuk a statikus fájlokat?
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+Ehhez pedig létre kell hozunk egy "`static`" nevű könyvtárat a blog applikáción belül:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+A Django automatikusan megtalál minden "static" nevű mappát az alkalmazásaid könyvtárain belül, és képes lesz használni azok tartalmát statikus fájlokként.
+
+## Az első CSS fájlod!
+
+Írjunk egy CSS fájlt, hogy hozzáadd a saját stílusodat a weboldaladhoz. Hozz létre egy `css` nevű könyvtárat a `static` könyvtárban! Majd hozz létre egy új fájlt `blog.css` néven a `css` könyvtárban. Kész vagy?
+
+    djangogirls
+     └─── blog
+         └─── statikus
+             └─── css
+                 └─── blog.css
+    
+
+Itt az ideje, hogy a CSS fájlunkba írjunk is valamit! Nyisd meg a `blog/static/css/blog.css` fájlt a kódszerkesztődben.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+De azért egy pár dolgot megmutatunk. Maybe we could change the color of our headers? Hogy a számítógépek megértsék a színeket, speciális kódokat használnak. `#` jellel kezdődnek, majd 6 betű (A-F) és szám (0-9) következik. For example, the code for blue is `#0000FF`. Színkódokat például itt találhatsz: http://www.colorpicker.com/. [Előre meghatározott színeket](http://www.w3schools.com/colors/colors_names.asp) is használhatsz, mint a `red` vagy a `green`.
+
+A `blog/static/css/blog.css` fájlba írd bele a következő kódot:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+A `h1 a` egy CSS szelektor. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+A CSS fájlban mondjuk meg, hogy nézzenek ki a HTML fájl elemei. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. A class és az id olyan nevek, amelyeket te adhatsz meg az elemeknek. A class attribútum elemek egy csoportjára vonatkozik, míg az id-val kifejezetetten egy elemet tudunk beazonosítani. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+html<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Olvass utána a [CSS szelektorokról a w3schools oldalán](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. Most megmondtuk a template-ünknek, hol találja a CSS fájlokat.
+
+Így kellene kinéznie a fájlodnak:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Oké, mentsd el a fájlt és frissítsd be az oldalt!
+
+![14.2 ábra](images/color2.png)
+
+Szép munka! Lehet, hogy jó lenne adni egy kis "teret" a weboldalunknak és növelni a bal oldali margót. Próbáljuk meg!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Írd hozzá a CSS fájlodhoz, mentsd el és lássuk, működik-e!
+
+![14.3 ábra](images/margin2.png)
+
+Lehet, hogy testre szabhatnánk a betű stílusát a header-ünkben. A következő sort másold bele a `<head>`-be a `blog/templates/blog/post_list.html` fájlon belül:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![14.3 ábra](images/font.png)
+
+Szuper!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Most pedig adjunk stílusblokkokat a különböző szelektorokhoz. A `.` -tal kezdődő szelektorok classokra utalnak. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Ezután jelöld ki a HTML kódot, ami a post-okat jeleníti meg egy class="post" attribútummal. Cseréld le ezt:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+a `blog/templates/blog/post_list.html` fájlban ezzel:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Mentsd el a fájlokat és frissítsd az oldalad.
+
+![14.4 ábra](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Készen állsz a következő fejezetre?! :)
\ No newline at end of file
diff --git a/hu-HU/deploy/README.md b/hu-HU/deploy/README.md
new file mode 100644
index 00000000000..9d82c399cbe
--- /dev/null
+++ b/hu-HU/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Megjegyzés** A következő fejezet néhol kissé bonyolult lehet. Tarts ki és vedd át az egész fejezetet; ugyanis most a webfejlesztés egy nagyon fontos része következik - az ún. deployment. Ez a fejezet a tutorial közepén található, így majd a mentorod is tud segíteni a trükkösebb részeknél, miközben a honlapodat online is elérhetővé teszed. Magát a tutorialt később egyedül is befejezheted, ha esetleg kifutnál az időből.
+
+Míg most, a honlap csak akkor érhető el a számítógépen. Most megtanulod, hogyan kell telepíteni! Ez az ún. deploying - az a tevékenység, amely során az alkalmazásodat közzé teszed az interneten, hogy mások is láthassák és használhassák azt. :)
+
+Ahogyan azt már tudod, a honlapot egy szerveren kell elhelyezni. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+A másik külső szolgáltatás, amit igénybe fogunk venni a [GitHub](https://www.github.com), ami egy ún. code hosting service (forráskód tárolására és megosztására alkalmas online tárhely). Vannak más hozzá hasonló szolgáltatók is, de szinte minden programozó ezt használja manapság, és nemsokára te is közéjük tartozhatsz!
+
+Ez a három helyen lesz fontos. A helyi számítógép lesz az a hely, ahol fejlesztés, tesztelés. Amikor boldog vagy, a változások, a hely egy másolatot a program a GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Készítsünk Git repository-t
+
+A Git nyomon követi a változásokat az adott fájlokban egy ún. csomagtárban (repository vagy röviden "repo"). Nyissunk egy új repo-t a projektünknek. Nyisd fel a konzolt és futtasd le a következő parancsokat, a `djangogirls` mappában:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. A `djangogirls` mappában kell lenned.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Inicializálása a git repository-valamit tennünk kell, csak, ha egy projekt (nem kell újra adja meg a felhasználó nevét, e-mail soha többé).
+
+A Git ezután nyomon követ minden változást a fájlokban és mappákban ezen a mappán belül. De vannak bizonyos fájlok, amiket nem szeretnénk figyelembe venni. Ezt úgy tehetjük meg, hogy létrehozunk egy fájlt `.gitignore` névvel a gyökérkönyvtárban. Nyisd meg a szövegszerkesztőt és hozz létre egy új fájlt, amibe az alábbi sorok kerülnek:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Megjegyzés** Nagyon fontos, hogy a fájl neve ponttal kezdődjön! Ha nehezen létrehozása (Mac nem tetszik, hogy hozzon létre fájlokat, hogy kezdődik egy dot keresztül a Finder, például), akkor használja a "Mentés másként" funkciót a szerkesztő; golyóálló. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. Meg kell gondolni, a helyi adatbázis, mint egy jó játszótér, ahol ki lehet próbálni más dolgokat pedig ne félj, hogy akarsz törölni az igazi hozzászólás, a blogot.
+
+Jó ötlet a `git status` parancs használata még a `git add` előtt, valamint ezen kívül még bármikor, ha tudni szeretnéd, hogy mi változott. Ez segít megelőzni semmilyen meglepetés történik, mint a rossz fájlokat, hogy ki vagy követett el. A `git állapota` parancs visszatér információt bármely untracked/módosított/megrendezett fájlokat, a fióktelep állapota, valamint sokkal több. A kimenet az alábbihoz hasonló:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Végül mentsük le a változtatásokat. A konzolban futtasd le a következő parancsokat:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/hu-HU/deploy/install_git.md b/hu-HU/deploy/install_git.md
new file mode 100644
index 00000000000..a7021fccf3a
--- /dev/null
+++ b/hu-HU/deploy/install_git.md
@@ -0,0 +1,52 @@
+A Git egy "version control system" (VCS, magyarul verziókezelő rendszer), amit sok programozó használ. Ez a szoftver nyomon követ minden változást a fájlokban, így a későbbiekben is visszatérhetünk egy bizonyos régebbi verzióhoz. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Git telepítése
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+A Gitet innen töltheted le: [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Ezen kívül a többi maradhat az alapbeállításon. Checkout Windows-style, commit Unix-style line endings - ezek is maradhatnak így.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/hu-HU/deploy/signup_pythonanywhere.md b/hu-HU/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/hu-HU/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/hu-HU/django/README.md b/hu-HU/django/README.md
new file mode 100644
index 00000000000..5cf0c8fd7ba
--- /dev/null
+++ b/hu-HU/django/README.md
@@ -0,0 +1,27 @@
+# Mi a Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A webes keretrendszerek különböző építőelemek gyűjteményei, segítségükkel könnyebben és gyorsabban tudunk weboldalakat fejleszteni.
+
+Amikor weboldalt készítesz, mindig hasonló elemekre lesz szükséged: meg kell oldanod a felhasználók azonosítását (regisztráció, be- és kijelentkezés), kell egy felület a honlap kezeléséhez, formok (kérdőívek), kell valami megoldás a fájlok feltöltésére, stb.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Miért van szükséged keretrendszerre?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Képzelj el egy postaládát (port), amit folyamatosan figyelnek, hogy vannak-e beérkezett levelek (requestek). Ezt csinálja egy webszerver. The web server reads the letter and then sends a response with a webpage. Azonban amikor küldeni szeretnél valamit, szükséged van tartalomra. A Django ennek a tartalomnak a megalkotásában segít.
+
+## Mi történik, amikor valaki lekérdez egy honlapot a szerveredtől?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Képzelj el egy postást egy levéllel. Ahogy halad az utcán, minden házszámot megnéz, és összehasonlítja a levélen lévővel. Ha megegyezik, bedobja a levelet a postaládába. Így működik az urlresolver!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Talán a felhasználó meg szeretne változtatni valamilyen adatot? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/hu-HU/django_admin/README.md b/hu-HU/django_admin/README.md
new file mode 100644
index 00000000000..81a64507b3a
--- /dev/null
+++ b/hu-HU/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Amint láthatod, importáljuk az előző fejezet végén definiált Post modellt, vagyis elérhetővé tesszük ebben a fájlban is. Hogy a modell látszódjon az admin oldalon, regisztrálnunk kell a `admin.site.register(Post)` sorral.
+
+Most nézzük meg, hogy néz ki a Post modell. Ne felejtsd el futtatni a `python manage.py runserver` parancsot a konzolban, hogy elindítsd a webszervert. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/hu-HU/django_forms/README.md b/hu-HU/django_forms/README.md
new file mode 100644
index 00000000000..fa214f89eb7
--- /dev/null
+++ b/hu-HU/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django űrlapok
+
+Utolsó lépésként azt fogjuk megcsinálni, hogy a blogposztokat ne csak az admin oldalon hozhassuk létre és szerkeszthessük. A Django `admin` menő, de elég nehéz személyre szabni, és nem is túl szép. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+A Django formokban az a jó, hogy ha akarjuk, teljesen az alapoktól is megírhatjuk őket, de `ModelForm`-ot is létrehozhatunk, ami az űrlap eredményét a modellbe menti el.
+
+Pontosan ezt szeretnénk: egy űrlapot a `Post` modellünkhöz.
+
+Mint minden fontos résznek a Django-ban, a formoknak is megvan a maguk helye: a `forms.py` fájl.
+
+Hozz létre egy új fájlt ezzel a névvel a `blog` könyvtárban.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+Valószínűleg már sejted, hogy a `PostForm` az űrlapunk neve lesz. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Aztán a `class Meta` következik, itt mondjuk meg a Django-nak, hogy melyik modellt kell használnia az űrlap elkészítéséhez (`model = Post`).
+
+Legvégül megadhatjuk, hogy melyik mezők kerüljenek bele az űrlapba. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+Ennyi az egész! Most már csak az van hátra, hogy használjuk az űrlapot egy *view*-ban, és megjelenítsük egy template-ben.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link az oldalhoz, ahol az űrlap van
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new nézet
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Szükségünk van egy `Save` (Mentés) gombra. Ezt egy HTML gombbal tudjuk létrehozni: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. Ez nagyon fontos, mert ettől lesznek biztonságosak az űrlapjaid! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Űrlap mentése
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validáció
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Űrlapok szerkesztése
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Biztonság
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Még egy dolog: itt az ideje egy újabb deploynak!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Aztán írd be ezt a [PythonAnywhere Bash konzol](https://www.pythonanywhere.com/consoles/)ba:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/hu-HU/django_installation/README.md b/hu-HU/django_installation/README.md
new file mode 100644
index 00000000000..a26cb1d11d4
--- /dev/null
+++ b/hu-HU/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django telepítés
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/hu-HU/django_installation/instructions.md b/hu-HU/django_installation/instructions.md
new file mode 100644
index 00000000000..3bf59579484
--- /dev/null
+++ b/hu-HU/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. A django-marcador tutorial jogait, Markus Zapke-Gründemann és társai birtokolják.
+
+## Virtuális környezet
+
+Mielőtt feltelepítjük a Django-t, egy rettentő hasznos eszközt fogunk installálni, ami segít, hogy a kódolói környezetedet rendben tartsa a számítógépeden. Át lehet ugrani ezt a lépést, de nem ajánlott. Ha a lehető legjobb kiindulási helyzetből kezded a kódolást, sok bosszúságot megspórolhatsz magadnak a jövőben!
+
+Tehát először is hozzunk létre egy **virtuális környezetet** (virtual environment), amit *virtualenv*-nek is hívunk. A virtualenv projektenként különíti el a Python/Django környezetet. Ez azt jelenti, hogy ha megváltoztatsz valamit egy weboldalon, az nem lesz hatással a többi weboldalra, amit párhuzamosan fejlesztesz. Jó, igaz?
+
+Csak annyit kell tenned, hogy kiválasztasz egy könyvtárat, ahova a `virtualenv`et szeretnéd telepíteni, például a home könyvtárat. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+Ehhez a tutorialhoz egy új, `djangogirls` nevű mappát fogunk használni a home könyvtáradon belül:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Most pedig létrehozunk egy `myvenv` nevű virtuális környezetet. A kód általánosan így néz ki:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. Bármi más nevet is használhatsz, de maradj a kisbetűs szavaknál, és ne használj szóközt, ékezeteket, vagy más speciális karaktereket. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+A `myvenv` a`virtualenv`-ed neve. Más nevet is használhatsz, de maradj a kisbetűs szavaknál, és ne használj szóközt, ékezeteket, vagy más speciális karaktereket. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Hogy ezt elkerüld, használd a `virtualenv` parancsot.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Hogyan dolgozhatsz virtuális környezetben
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Így indíthatod el a virtuális környezetet:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/hu-HU/django_models/README.md b/hu-HU/django_models/README.md
new file mode 100644
index 00000000000..cb1ecc37ae0
--- /dev/null
+++ b/hu-HU/django_models/README.md
@@ -0,0 +1,201 @@
+# Django modellek
+
+Most valami olyasmire van szükségünk, ami eltárolja az összes blogbejegyzést. De ahhoz, hogy létre tudjunk hozni ilyesmit, előbb egy kicsit beszélnünk kell az `objektumokról`.
+
+## Objektumok
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+Tehát mi az az objektum? Tulajdonságok és tevékenységek gyűjteménye. Furán hangozhat, de mindjárt mutatunk egy példát.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+Tehát az egésznek az az alapötlete, hogy a valós dolgokat kódban tulajdonságokkal (vagyis `object property`-kkel) és tevékenységekkel (vagyis `method`-okkal) írjuk le).
+
+Hogyan modellezzük a blogposztokat? Egy blogot szeretnénk fejleszteni, ugye?
+
+Erre a kérdésre keressük a választ: Mi egy blogposzt? Milyen tulajdonságai vannak?
+
+Nos, a bejegyzésünknek biztos van szövege, és címe, igaz? It would be also nice to know who wrote it – so we need an author. Végül tudni szeretnénk, mikor lett megírva és publikálva a poszt.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Milyen dolgokat lehet csinálni egy blogbejegyzéssel? Jó lenne, ha lenne valamiféle `method`, ami publikálja a posztot, nem?
+
+Tehát szükségünk van egy `method` methodra.
+
+Most, hogy tudjuk, mit szeretnénk elérni, kezdjük el modellezni Django-ban!
+
+## Django modell
+
+Most, hogy tudjuk, mik az objektumok, már el tudjuk készíteni a blogposzt Django modelljét.
+
+A model in Django is a special kind of object – it is saved in the `database`. Az adatbázis tulajdonképpen adatok gyűjteménye. Ez az a hely, ahol adatokat tárolhatsz a felhasználókról, a blogposztokról, stb. Mi egy SQLite adatbázist fogunk használni az adataink tárolásához. This is the default Django database adapter – it'll be enough for us right now.
+
+Az adatbázisban lévő modellt úgy képzeld el, mint egy táblázatot (pl. az Excelben), ahol oszlopok (mezők) és sorok (adatok) vannak.
+
+### Készítsünk egy alkalmazást!
+
+Hogy minden szép rendben maradjon, most a projekten belül egy külön alkalmazást hozunk létre. Jó, ha már az elejétől fogva rendezetten tartjuk a dolgokat. Ahhoz, hogy létrehozzuk az alkalmazást, ezt a parancsot kell futtatnunk a parancssorban (a `djangogirls` könyvtárban, ahol a `manage.py` fájl van):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Hozzuk létre a blogposzt modelljét
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. Ez a jelölés gyakran előfordul a Pythonban, és néha "dunder"-nek hívjuk (a "double underscore" - dupla alulvonás rövidítése).
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- a `class` egy speciális kulcsszó, ami azt mutatja meg, hogy éppen egy objektumot definiálunk.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- a `models.Model` azt jelenti, hogy a Post egy Django Model, így a Django tudni fogja, hogy el kell menteni az adatbázisba.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Készíts táblákat a modelleknek az adatbázisodban
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/hu-HU/django_orm/README.md b/hu-HU/django_orm/README.md
new file mode 100644
index 00000000000..67617055b85
--- /dev/null
+++ b/hu-HU/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM és QuerySet-ek
+
+Ebben a fejezetben megtanulod, hogy hogyan kapcsolódik az adatbázishoz a Django, és hogyan tárol benne adatokat. Ugorjunk fejest!
+
+## Mi a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+A legkönnyebb, ha példákon keresztül tanulod meg. Próbáljuk csak ki!
+
+## Django shell
+
+Nyisd meg a lokális konzolodat (nem a PythonAnywhere-ét), és gépeld be ezt a parancsot:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Ezt fogod látni:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### Az összes objektum
+
+Először is próbáljuk meg az összes posztot megjeleníteni. A következő paranccsal tudod megtenni:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Objektum létrehozása
+
+Így hozhatsz létre egy új Post objektumot az adatbázisodban:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Először importáljuk az User modellt:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Milyen felhasználók vannak az adatbázisban? Próbáld meg ezt:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Most pedig végre létrehozhatjuk a posztot:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurrá! Meg akarod nézni, hogy működött-e?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Ott is van, egy újabb poszt a listában!
+
+### Hozz létre még néhány posztot
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Objektumok filterezése
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. Itt a `filter`-t fogjuk használni az `all` helyett a `Post.objects.all()`-ban. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Most így néz ki a kódunk:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** A `title` és a `contains` (vagyis 'tartalmaz') között két underscore karakter (`_`) van. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+Aztán közzétesszük a `publish` methoddal:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Objektumok sorbarendezése
+
+A QuerySetek segítségével sorba is rendezheted az objektumok listáját. Először próbáljuk meg a létrehozás dátuma (`created_date` mező) alapján rendezni őket:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Meg is fordíthatjuk a sorrendet, ha az elejére egy `-` jelet teszünk:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Ez egy nagyon hatékony módszer, és a segítségével bonyolult query-ket írhatsz.
+
+Remek! Most már készen állsz a következő részre! Hogy kilépj a shellből, gépeld be ezt:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/hu-HU/django_start_project/README.md b/hu-HU/django_start_project/README.md
new file mode 100644
index 00000000000..2013dae4f49
--- /dev/null
+++ b/hu-HU/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Az első Django projekted!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. A django-marcador tutorial jogait, Markus Zapke-Gründemann és társai birtokolják.
+
+Létre fogunk hozni egy kis blog!
+
+Az első lépés, hogy indítsunk egy új Django projektet. Ez annyit jelent, hogy lefuttatunk néhány scriptet, amit a Django tartalmaz, ezzel létrehozzuk a projekt vázát. Ez tulajdonképpen néhány mappa és fájl, amit majd később fogunk használni.
+
+Néhány fájl és könyvtár neve nagyon fontos a Django-ban. A fájlokat, amiket most hozunk létre, ne nevezd át! Az áthelyezésük sem egy jó ötlet. Fontos, hogy megtartsunk egy bizonyos szerkezetet, ami segít a Django-nak, hogy megtalálja a fontos dolgokat.
+
+> Figyelem: mindent a virtualenv-ben futtass. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. Ezt a **Django telepítés** fejezetben írtuk le, a **Virtuális környezetben való fejlesztés** résznél. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+A `django-admin.py` egy script, ami könyvtárakat és fájlokat hoz létre neked. Most ilyen könyvtárszerkezetednek kell lennie:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+A `settings.py` tartalmazza a weboldalat konfigurációját (beállításait),.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Most ne foglalkozzunk a többi fájllal, mert azokat nem fogjuk módosítani. Az egyetlen dolog, amit ne felejts el, hogy ne töröld ki őket véletlenül!
+
+## A beállítások megváltoztatása
+
+Változtassunk meg néhány dolgot a `mysite/settings.py` fájlban. Nyisd meg a fájlt a kódszerkesztővel, amit korábban telepítettél!
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Azt is megteheti, hogy nyissa meg a fájlt navigálva a djangogirls mappát az asztalon jobb egérgombbal kattintva. Ezután válassza ki a kódszerkesztő a listából. Kiválasztja a szerkesztő fontos lehet, hogy más programokat telepíteni, hogy nyissa meg a fájlt, de nem engedi szerkeszteni.
+
+Jó lenne, ha a weboldalunk a mi időzónánk szerinti időt mutatná. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. Tehát a "Cancel" gombot a nyelvére lefordítva, hogy meghatározott itt. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Mi is kell hozzá egy utat a statikus fájlokat. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+Sok különféle adatbázis-szoftver létezik, ami adatokat tud tárolni a weboldalakhoz. Mi az alapértelmezettet fogjuk használni, az `sqlite3`-ot.
+
+Ez már be van állítva a `mysite/settings.py` fájlodban:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Hogy létrehozz egy adatbázist a blogodhoz, futtasd le a következő parancsot a konzolban: `python manage.py migrate` (fontos, hogy a `djangogirls` könyvtárban legyél, ami tartalmazza a `djangogirls` fájlt). Ha minden jól megy, valami ilyesmit kell látnod:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+Készen is vagyunk! Itt az ideje, hogy elindítsd a webszervert, és meglásd, hogy működik-e.
+
+## Starting the web server
+
+Ehhez abban a könyvtárban kell lenned, ahol a `manage.py` fájl van (a `djangogirls` könyvtárban). A konzolban a következő paranccsal tudod elindítani a szervert: `python manage.py runserver`.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> Megnéztük, hogy milyen web szerver működik, a **Hogyan működik az Internet** fejezet.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/hu-HU/django_templates/README.md b/hu-HU/django_templates/README.md
new file mode 100644
index 00000000000..face4b0d9b0
--- /dev/null
+++ b/hu-HU/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django sablonok (template)
+
+Itt az idő, hogy megjelenítsünk pár adatot! Ehhez Django felkínál nekünk pár beépített **template tag**-et számunkra.
+
+## Mik a template tag-ek?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Template a bejegyzések listájához
+
+Az előző fejezetben hozzáadtuk a template-hez a bejegyzéseink listáját a `post` változóban. Most meg fogjuk ezt jeleníteni a HTML-ben.
+
+Ahhoz, hogy kiírjunk egy változót a Django template-ben, dupla kapcsos zárójelet használunk, benne a változó nevével, mint itt:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Próbáld ki a `blog/templates/blog/post_list.html` template-ben. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Mentsd el a fájlt és frissítsd az oldalt, hogy lásd az eredményt:
+
+![13.1 ábra](images/step1.png)
+
+Ahogy látod, ez minden, amink van:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Ez azt jelenti, hogy a Django objektumok listájaként értelmezi. Emlékszel a **Bevezetés a Python-ba** című fejezetből, hogy hogyan jelenítünk meg listákat? Igen, for loop-okkal! Egy Django template-ben ezt így tudod megtenni:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Próbáld ki a template-edben.
+
+![13.2 ábra](images/step2.png)
+
+És működik! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. A HTML-t és a template tageket használhatod együtt. A `body` így fog kinézni:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %} Minden, amit a `{% for %}` és `{% endfor %}` közé írsz, a lista minden egyes elemére meg fog ismétlődni. Frissítsd az oldalt:{% endraw %}
+
+![13.3 ábra](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? Az adatokat a `Post` modelben meghatározott mezők szerint érjük el. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## Még valami
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Ezután a [PythonAnywhere](https://www.pythonanywhere.com/consoles/)-en menj a **Bash console**-ba (vagy indíts újat), és futtasd le:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/hu-HU/django_urls/README.md b/hu-HU/django_urls/README.md
new file mode 100644
index 00000000000..3c198f6aa2b
--- /dev/null
+++ b/hu-HU/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## Mi az URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! a `127.0.0.1:8000` egy URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Az interneten minden oldalnak szüksége van egy saját URL-re. Így az alkalmazás tudja, mi kell mutatni, hogy egy felhasználó, aki megnyitja ezt az URL-címet. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## Hogy működnek az URL-ek a Django-ban?
+
+Nyisd meg a `mysite/urls.py` fájlt a kódszerkesztőben, és nézd meg:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Mint látható, a Django már valamit nekünk.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/hu-HU/django_views/README.md b/hu-HU/django_views/README.md
new file mode 100644
index 00000000000..8cab75fb855
--- /dev/null
+++ b/hu-HU/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Eljött az idő, hogy megszabaduljunk a hibától, amit az előző fejezetben szereztünk! :)
+
+A *nézet (view)* az a rész, ahova az applikációnk "logikáját" írjuk. Szükség lesz a nemrég elkészült `model`-ben megadott adatokra, amit majd továbbít a `template`-nek. A template-et majd a következő fejezetben hozzuk létre. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+A nézetek a `views.py` fájlban találhatók. A *view-kat* a `blog/views.py` fájlba fogjuk írni.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Újabb hiba! Olvasd el, mi a helyzet:
+
+![Hiba](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/hu-HU/dynamic_data_in_templates/README.md b/hu-HU/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..cf31b3cb6a6
--- /dev/null
+++ b/hu-HU/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dinamikus adatok a template-ben
+
+Az összetevőink különböző helyeken vannak: a `Post` modellt a `models.py`-ban definiáltuk, a `post_list` a `views.py`-ban van, és létrehoztunk egy sablont is. De mégis hogyan fogjuk megjeleníteni a bejegyzést a HTML sablonban? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+Pont ez az, amit a *nézetek (views)* csinálnak: összekötik a modelleket a sablonokkal. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Emlékszel, amikor azt magyaráztuk, hogyan tudsz korábban megírt kódot beletenni más fájlokba? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Ezután importáljuk a model nevét).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Figyeld meg, hogy létrehozunk egy *változót* a QuerySethez: `posts`. Vedd úgy, hogy ez a QuerySet neve. Innentől kezdve erre a névre hivatkozva használjuk.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. El kell neveznünk őket (egyelőre ragaszkodunk a `'posts'`-hoz). :) Így kell kinéznie: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+Végül a `blog/views.py` fájlnak így kell kinéznie:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+És megvan! Itt az idő visszatérni a template-hez és megjeleníteni ezt a QuerySet-et!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/hu-HU/extend_your_application/README.md b/hu-HU/extend_your_application/README.md
new file mode 100644
index 00000000000..daabb33c46f
--- /dev/null
+++ b/hu-HU/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Egészítsd ki az applikációdat
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Template link a bejegyzés részleteihez
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## URL a bejegyzés részleteihez
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Nézet a bejegyzés részleteihez
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/hu-HU/how_the_internet_works/README.md b/hu-HU/how_the_internet_works/README.md
new file mode 100644
index 00000000000..695abf19fe2
--- /dev/null
+++ b/hu-HU/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Hogy működik az Internet?
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+Biztosan minden nap internetezel. De tudod, igazából mi történik, mikor beírod a böngésződbe, hogy https://djangogirls.org, és `enter`t nyomsz?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. A webböngészőket úgy tervezték, hogy megértsék ezt a kódot, kövessék azt, ami abban van, és megjelenítsenek mindent pont úgy, ahogy szeretnéd.
+
+Mint minden fájlt, a HTML-t is merevlemezen kell tárolni. Az Internethez speciális, erős számítógépeket használunk, a *szervereket*. Ezekhez a gépekhez nem tartozik képernyő, egér vagy billentyűzet, mert a fő feladatuk az adatok tárolása és szolgáltatása. Ezért hívják őket *szervereknek* -- ők *szervíroznak* neked adatot.
+
+Rendben, de te azt szeretnéd tudni, hogyan néz ki az internet, ugye?
+
+Rajzoltunk neked egy képet! Így néz ki:
+
+![1.1 ábra](images/internet_1.png)
+
+Elég zavaros, igaz? In fact it is a network of connected machines (the above-mentioned *servers*). Több százezer gép! Rengeteg kilométernyi kábel körös-körül a világon! Nézd meg Submarine Cable Map weboldalt (http://submarinecablemap.com), és látni fogod milyen bonyolult a net. Itt egy kép az oldalról:
+
+![1.2 ábra](images/internet_3.png)
+
+Lenyűgöző, igaz? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+Így néz ki:
+
+![1.3 ábra](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Először a leveled a hozzád legközelebbi postára megy. Ezután továbbhalad egy olyan postára, ami már kicsit közelebb van a címzettedhez, és így tovább, míg el nem jut a céljához. Az egyetlen egyedi dolog, hogy ha több levelet (*adatcsomagot*) küldesz ugyanarra a helyre, azok valószínűleg teljesen már postákon (*routers*) mennek keresztül. Ez csak attól függ hogyan osztják el az egyes irodákban.
+
+![1.4 ábra](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Utcanév, házszám, város és irányítószám helyett IP-címeket használunk. A számítógéped először megkéri a DNS-t (Domain Name System, tartománynévrendszer), hogy fordítsa le a djangogirls.org-ot egy IP címre. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Ráadásul olyan nyelven kell írnod, amit a címzett megért. Ugyanez vonatkozik az *adatcsomagokra*, amiket azért küldesz, mert meg szeretnél nézni egy weboldalt. A HTTP (Hypertext Transfer Protocol) protokollt használjuk erre.
+
+Szóval, amikor van egy weboldalad, akkor szükséged van egy *szerverre* (gép), ahol az oldal lakik. Amikor a *szerver* kap egy beérkező *kérést* (egy levélben), akkor egy válaszban visszaküldi a weboldaladat (egy másik levélben).
+
+Since this is a Django tutorial, you might ask what Django does. Amikor küldesz egy választ, nem mindig pont ugyanazt küldöd mindenkinek. Sokkal jobb, ha a levelek személyesek, főleg, ha annak az embernek szólnak, akinek válaszolsz, nem igaz? A Django segít, hogy személyes és érdekes leveleket írhass. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/hu-HU/html/README.md b/hu-HU/html/README.md
new file mode 100644
index 00000000000..cd3ab3fba05
--- /dev/null
+++ b/hu-HU/html/README.md
@@ -0,0 +1,227 @@
+# Bevezetés a HTML-be
+
+Mi az a template, kérdezhetnéd?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## Mi a HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+A HTML a "HyperText Markup Language" rövidítése. A **HyperText** egy olyan szöveg, amely támogatja a hiperhivatkozásokat oldalak között. A **Markup** azt jelenti, hogy egy dokumentumot kód segítségével jelölésekkel látunk el, hogy leírjuk (ebben az esetben a böngészőnek) hogyan értelmezhető a weboldal. A HTML kód **tagekből** épül fel, amelyek mindegyike `<` jellel kezdődik, és `>` jellel végződik. Ezek a tagek reprezentálják a jelölő **elemeket**.
+
+## Az első template-ed!
+
+Egy template elkészítése azt jelenti, hogy létrehozunk egy template fájlt. Minden dolog egy fájl, igaz? Valószínűleg már te is észrevetted ezt.
+
+A template-eket a `blog/templates/blog` mappába mentjük. Először hozd létre a `templates` könyvtárat a blog mappában. Ezután hozz létre egy `blog` mappát a templates mappádban:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+Ezután hozd létre a `post_list.html` fájlt (egyelőre hagyd üresen) a `blog/templates/blog` mappában.
+
+Nézd meg, hogy néz ki most a weboldal: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![11.1 ábra](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![11.2 ábra](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Minden HTML oldalt két elemre osztunk: **head** és **body**.
+
+* A **head** elem információkat tartalmaz a dokumentumról, amit nem jelenítünk meg a képernyőn.
+
+* A **body** elem tartalmaz minden mást, ami a weboldalon jelenik meg.
+
+A `<head>` elemet használjuk arra, hogy az oldal konfigurációs beállításait megadjuk a böngészőnek, és a `<body>` elemet arra, hogy leírjuk mi jelenjen meg az oldalon.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Mentsd el a fájlt, és frissítsd az oldalt.
+
+![11.3 ábra](images/step4.png)
+
+Észrevetted, hogyan ismerte fel a böngésző, hogy az "Ola's blog" az oldal címe? Értelmezte a `<title>Ola's blog</title>` kódot, és a szöveget a böngésző cím mezőjébe rakta (ezt fogja használja könyvjelzőnek is, és így tovább).
+
+Valószínűleg azt is észrevetted, hogy minden nyitó taghez tartozik egy *záró tag* egy `/` jellel, és ezek az elemek *egymásba ágyazhatóak* (azaz nem lehet bezárni egy adott taget mindaddig, míg a benne levők nincsenek lezárva).
+
+Ez éppen olyan mintha különböző dolgokat tennénk dobozokba. Van egy nagy dobozod, a `<html></html>`; ebben benne van a `<body></body>`, és ez egy újabb kisebb dobozt tartalmaz: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Változtasd meg a template-edet
+
+Most szórakozásképpen próbáld módosítani a template-edet! Itt van néhány hasznos tag ehhez:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` cím a következő szintre
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` dőlt szöveghez
+* `<strong>text</strong>` a szöveg kiemeléséhez
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` létrehoz egy linket
+* `<ul><li>first item</li><li>second item</li></ul>` létrehoz egy listát, akárcsak ezt itt!
+* `<div></div>` az oldal szakaszainak megadásához
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Ennek kell megjelenni:
+
+![11.4 ábra](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## Még egy dolog: deploy!
+
+Jó lenne lenne látni ezt az egészet élesben az interneten, ugye? Csináljunk egy újabb PythonAnywhere deploy-t:
+
+### Commit, and push your code up to GitHub
+
+Először nézzük meg, hogy milyen fájlok változtak a legutóbbi deploy óta (futtasd az alábbi parancsot a gépeden, ne PythonAnywhere-en):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Mielőtt továbbmegyünk ellenőrizzük, hogy a `git` mit szeretne feltölteni (zölddel jelennek meg azok a fájlok, amiket a `git` fel akar tölteni):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Már majdnem készen is vagyunk, de előtte el kell mentenünk a változtatásokat az előzményekbe. Egy "commit message"-et adunk meg, ahol leírjuk, hogy mit változtattunk. Akármit beírhatsz, de később hasznos lehet, ha valami olyat adsz meg, ami segít beazonosítani, hogy mit csináltál.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pullold az új kódot PythonAnywhere-re, és frissítsd az oldalt
+
+* Nyisd meg a [PythonAnywhere konzol oldalát](https://www.pythonanywhere.com/consoles/) és menj a **Bash console**-odra (vagy indíts egy újat). Aztán futtasd ezt:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/hu-HU/installation/README.md b/hu-HU/installation/README.md
new file mode 100644
index 00000000000..6bc7c6a995c
--- /dev/null
+++ b/hu-HU/installation/README.md
@@ -0,0 +1,68 @@
+# Ha otthon csinálod a tutorialt
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/hu-HU/intro_to_command_line/README.md b/hu-HU/intro_to_command_line/README.md
new file mode 100644
index 00000000000..ac4b895233a
--- /dev/null
+++ b/hu-HU/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Bevezetés a parancssor használatába
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Hadd mutassuk be neked az első új barátodat: a parancssort!**
+
+A következő lépésekben megmutatjuk neked, hogyan használd azt a fekete ablakot úgy, ahogy az összes hacker használja. Első ránézésre kissé ijesztőnek tűnhet, de valójában csak egy egyszerű parancsot vár tőled.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## Mi az a parancssor?
+
+A **parancssor** (command line, vagy **command-line interface**) nevű ablak egy szöveges alapú alkalmazás, amit arra használhatsz, hogy fájlokat tekinthess meg, szerkeszthess, és különböző műveleteket végezhess rajtuk. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Egyéb megnevezések a parancssorra: *konzol*, *terminál*, *cmd*, *CLI*, *prompt*.
+
+## A parancssor megnyitása
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Parancssor
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Az első parancsod (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Az alapok
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### A jelenlegi mappa
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Megoldás:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Összefoglaló
+
+Here is a summary of some useful commands:
+
+| Parancs (Windows) | Parancs (Mac OS/Linux) | Leírás                        | Példa                                              |
+| ----------------- | ---------------------- | ----------------------------- | -------------------------------------------------- |
+| kilépés           | kilépés                | az ablak bezárása             | **kilépés**                                        |
+| cd                | cd                     | könyvtár megváltoztatása      | **cd test**                                        |
+| cd                | pwd                    | show the current directory    | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                     | könyvtárak/fájlok kilistázása | **dir**                                            |
+| copy              | cp                     | fájl másolása                 | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                     | fájl mozgatása                | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                  | új könyvtár létrehozása       | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                     | delete a file                 | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                  | delete a directory            | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]              | get help for a command        | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Kész vagy?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/hu-HU/intro_to_command_line/open_instructions.md b/hu-HU/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/hu-HU/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/hu-HU/python_installation/README.md b/hu-HU/python_installation/README.md
new file mode 100644
index 00000000000..7c52774faca
--- /dev/null
+++ b/hu-HU/python_installation/README.md
@@ -0,0 +1,15 @@
+# Kezdjünk ismerkedni a Pythonnal
+
+Végre itt vagyunk!
+
+Először is hadd mondjuk el, hogy mi is a Python. A Python egy nagyon népszerű programnyelv, amit weboldalkészítéshez, játékokhoz, tudományos szoftverekhez, grafikához és még csomó minden másra használnak.
+
+A Pythont a 80-as évek végén alkották meg, és a fő cél az volt, hogy ne csak gépek, hanem emberek számára is olvasható legyen. This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# A Python telepítése
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/hu-HU/python_installation/instructions.md b/hu-HU/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/hu-HU/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/hu-HU/python_introduction/README.md b/hu-HU/python_introduction/README.md
new file mode 100644
index 00000000000..b1016c63380
--- /dev/null
+++ b/hu-HU/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Bevezetés a Pythonba
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## A Python parancssor
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Az első Python parancsod!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Stringek
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Összefoglaló
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Hibák
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- A `str` függvény **stringgé** alakítja a dolgokat
+- Az `int` függvény **integerré** alakítja a dolgokat
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Változók
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## A print függvény
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Listák
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Szótárak
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- A `name` kulcs az `'Ola'` értékre mutat (ami egy `string` típusú objektum),
+- `country` a `'Poland'`-ra mutat (szintén `string` típusú),
+- és `favorite_numbers` a `[7, 42, 92]` objektumra mutat (ami egy `lista` benne három elemmel).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Csak elemek rendezett sorozatára van szükséged? Használj listát.
+- Kulcs és érték párokra van szükséged, amiket majd le tudsz kérdezni hatékonyan (kulcs alapján)? Használj szótárat.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Összefoglaló
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Dolgok összehasonlítása
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y azt jelenti: x nagyobb, mint y
+- x `<` y azt jelenti: x kisebb, mint y
+- x `<=` y azt jelenti: x kisebb vagy egyenlő y-nal
+- x `>=` y azt jelenti: x nagyobb vagy egyenlő y-nal
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean (Logikai)
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Mentsd el!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Lépjünk ki a Python interpreterből
+- Nyissunk meg egy kódszerkesztőt
+- Mensünk el benne valami kódot egy python fájlba
+- És futtassuk!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. Ezt úgy hívják: "syntax highlighting" (szintaxis-kiemelés), és kódoláshoz nagyon hasznos. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). Ez az egyik oka annak, hogy kódszerkesztőt használuk. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### Mi történik, ha egy feltétel nem teljesül (vagyis nem True)? 
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Összefoglaló
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## A saját függvényeidhez!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Ciklusok (loopok)
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Összefoglaló
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/hu-HU/template_extending/README.md b/hu-HU/template_extending/README.md
new file mode 100644
index 00000000000..bd3ffad6116
--- /dev/null
+++ b/hu-HU/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template-kiegészítés
+
+Egy másik szuper dolog, amit a Django tud, a **template extending**, vagyis template-kiegészítés. Mit jelent ez? Azt, hogy a HTML-ed egyes részeit több oldalon is fel tudod használni az alkalmazásodban.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base (alap) template a legegyszerűbb sablon, amit az alkalmazásod összes oldalán kiegészítesz.
+
+Hozz létre egy `base.html` fájlt a `blog/templates/blog/`-ban:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Aztán a `base.html`-ben cseréld ki az egész `<body>`-t (mindent a `<body>` és a `</body>` között) erre:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). Máris megmutatjuk, hogy működik.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Így:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/hu-HU/whats_next/README.md b/hu-HU/whats_next/README.md
new file mode 100644
index 00000000000..fabdccaba5e
--- /dev/null
+++ b/hu-HU/whats_next/README.md
@@ -0,0 +1,43 @@
+# Következő lépések
+
+Gratulálj magadnak! **Szuper vagy**. Nagyon büszkék vagyunk rád! <3
+
+### És most?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Tudunk-e ajánlani bármilyen tananyagot?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/hu/README.md b/hu/README.md
index 747acf69ced..0c72eb20443 100644
--- a/hu/README.md
+++ b/hu/README.md
@@ -1,51 +1,51 @@
 # Django Girls Tutorial
 
-[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
 
-> Ez az anyag Creative Commons Attribution-ShareAlike 4.0 International License jogvédelme alatt áll. A licenc megtekintéséhez látogass el ide: https://creativecommons.org/licenses/by-sa/4.0/
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
 
-## Fordítás
-A tutorial magyar fordítását egy csapat lelkes önkéntes készítette el: Czapári Dóri, Hanna Kollo, Erő Julcsi, Bónis Balázs, Kádár Szilvi, Szelle Erika, Téglássy Anna, Szabó Adrienn, Nádudvari György. Köszönjük nekik! <3
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
 
 ## Bevezetés
 
-Érezted már úgy hogy a világ egyre inkább a technológiáról szól, és te valahogy kimaradsz belőle? Gondolkoztál már azon, hogyan kell egy weblapot létrehozni, de soha nem volt elég erőd elkezdeni? Érezted úgy, hogy a szoftveres világ túl bonyolult ahhoz, hogy egyáltalán megpróbálj valamit létrehozni benne magadtól?
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Gondolkoztál már azon, hogyan kell egy weblapot létrehozni, de soha nem volt elég erőd elkezdeni? Érezted úgy, hogy a szoftveres világ túl bonyolult ahhoz, hogy egyáltalán megpróbálj valamit létrehozni benne magadtól?
 
 Nos, jó hírünk van számodra! A programozás egyáltalán nem olyan nehéz, mint amilyennek tűnik, és mi megmutatjuk, hogy mennyire jó móka tud lenni.
 
-Ez a tutorial nem fog téged egy csapásra programozóvá változtatni. Ha profi akarsz lenni benne, hónapokat vagy akár éveket kell eltöltened tanulással és gyakorlással. De meg szeretnénk mutatni, hogy a programozás, illetve a weblapkészítés nem annyira bonyolult, mint amilyennek tűnik. Megpróbáljuk minél jobban elmagyarázni a különböző részleteket, hogy ne tűnjön annyira ijesztőnek a technológia.
+This tutorial will not magically turn you into a programmer. Ha profi akarsz lenni benne, hónapokat vagy akár éveket kell eltöltened tanulással és gyakorlással. De meg szeretnénk mutatni, hogy a programozás, illetve a weblapkészítés nem annyira bonyolult, mint amilyennek tűnik. Megpróbáljuk minél jobban elmagyarázni a különböző részleteket, hogy ne tűnjön annyira ijesztőnek a technológia.
 
 Reméljük, veled is annyira megszerettetjük a számítógépek világát, mint amennyire mi szeretjük!
 
 ## Mit fogsz a tutorial alatt megtanulni?
 
-A tutorial befejezésével lesz egy egyszerű, működő webes alkalmazásod: a saját blogod. Megmutatjuk, hogyan kell a netre feltölteni, hogy mások is lássák az eredményt!
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
 
 Körülbelül így fog kinézni:
 
-![Figure 0.1][2]
+![Figure 0.1](images/application.png)
 
- [2]: images/application.png
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Megkértük a segítőinket és korábbi résztvevőket, hogy legyenek fent, ahogy idejük engedi, és segítsenek másoknak a tutorialban. Kérdezz tőlük bátran!
 
-> Ha egyedül dolgozol a tutorialon és nincs melletted coach, aki segíthetne, ha bármi probléma felmerül, használd a chatet, amit neked tartunk fenn: [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge). Megkértük a segítőinket és korábbi résztvevőket, hogy legyenek fent, ahogy idejük engedi, és segítsenek másoknak a tutorialban. Kérdezz tőlük bátran!
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
 
-Oké, [kezdjük az elejénél...][3]
+## Following the tutorial at home
 
- [3]: ./how_the_internet_works/README.md
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
 
-## A tutorialról és a közreműködésről
+In every chapter already covered, there is a link that points to the correct video.
 
-Ezt a tutorialt a [DjangoGirls][4] tartja fenn. Ha bármilyen hibát találsz benne, vagy frissíteni szeretnéd, kérlek kövesd a [közreműködési útmutatót][5].
+## A tutorialról és a közreműködésről
 
- [4]: https://djangogirls.org/
- [5]: https://github.com/DjangoGirls/tutorial/blob/master/README.md
+Ezt a tutorialt a [DjangoGirls](https://djangogirls.org/) tartja fenn. Ha bármilyen hibát találsz benne, vagy frissíteni szeretnéd, kérlek kövesd a [közreműködési útmutatót](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
 
-## Szeretnél segíteni lefordítani a tutorialt más nyelvekre?
+## Would you like to help us translate the tutorial into other languages?
 
-A fordításokat jelenleg a crowdin.com platformon végezzük:
+Currently, translations are being kept on crowdin.com platform at:
 
 https://crowdin.com/project/django-girls-tutorial
 
-Ha a te nyelved nem szerepel a crowdin listán, kérlek [hozz létre egy új issue-t][6], amely megjelöli a nyelvet, hogy hozzáadhassuk.
-
- [6]: https://github.com/DjangoGirls/tutorial/issues/new
\ No newline at end of file
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/hu/SUMMARY.md b/hu/SUMMARY.md
index 32bf04596b8..449836cebbf 100644
--- a/hu/SUMMARY.md
+++ b/hu/SUMMARY.md
@@ -1,26 +1,27 @@
 # Összefoglaló
 
-*   [Bevezetés](README.md)
-*   [Installáció](installation/README.md)
-*   [Hogy működik az Internet?](how_the_internet_works/README.md)
-*   [Bevezetés a parancssor használatába](intro_to_command_line/README.md)
-*   [A Python telepítése](python_installation/README.md)
-*   [Kódszerkesztő (editor)](code_editor/README.md)
-*   [Bevezetés a Pythonba](python_introduction/README.md)
-*   [Mi a Django?](django/README.md)
-*   [Django telepítés](django_installation/README.md)
-*   [Az első Django projekted!](django_start_project/README.md)
-*   [Django modellek](django_models/README.md)
-*   [Django admin](django_admin/README.md)
-*   [Deploy!](deploy/README.md)
-*   [Django url-ek](django_urls/README.md)
-*   [Django views - itt az ideje alkotni!](django_views/README.md)
-*   [Bevezetés a HTML-be](html/README.md)
-*   [Django ORM és QuerySet-ek](django_orm/README.md)
-*   [Dinamikus adatok a template-ben](dynamic_data_in_templates/README.md)
-*   [Django sablonok (template)](django_templates/README.md)
-*   [CSS - Tegyük széppé!](css/README.md)
-*   [Template-kiegészítés](template_extending/README.md)
-*   [Egészítsd ki az applikációdat](extend_your_application/README.md)
-*   [Django űrlapok](django_forms/README.md)
-*   [Következő lépések](whats_next/README.md)
+* [Bevezetés](README.md)
+* [Installáció](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [Hogy működik az Internet?](how_the_internet_works/README.md)
+* [Bevezetés a parancssor használatába](intro_to_command_line/README.md)
+* [A Python telepítése](python_installation/README.md)
+* [Kódszerkesztő (editor)](code_editor/README.md)
+* [Bevezetés a Pythonba](python_introduction/README.md)
+* [Mi a Django?](django/README.md)
+* [Django telepítés](django_installation/README.md)
+* [Az első Django projekted!](django_start_project/README.md)
+* [Django modellek](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django url-ek](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Bevezetés a HTML-be](html/README.md)
+* [Django ORM és QuerySet-ek](django_orm/README.md)
+* [Dinamikus adatok a template-ben](dynamic_data_in_templates/README.md)
+* [Django sablonok (template)](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template-kiegészítés](template_extending/README.md)
+* [Egészítsd ki az applikációdat](extend_your_application/README.md)
+* [Django űrlapok](django_forms/README.md)
+* [Következő lépések](whats_next/README.md)
\ No newline at end of file
diff --git a/hu/chromebook_setup/README.md b/hu/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/hu/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/hu/chromebook_setup/instructions.md b/hu/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/hu/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/hu/code_editor/README.md b/hu/code_editor/README.md
index dd6521f1a3b..854a8a0d506 100644
--- a/hu/code_editor/README.md
+++ b/hu/code_editor/README.md
@@ -1,7 +1,11 @@
 # Kódszerkesztő (editor)
 
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
 Nemsokára megírod a kód első sorát, itt az ideje letölteni egy kódszerkesztőt!
 
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
 > **Megjegyzés:** Lehet, hogy ezt már megtetted a Telepítés fejezet olvasása során - ha igen, ugorj előre a következő fejezetre!
 
-{% include "/code_editor/instructions.md" %}
+{% include "code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/hu/code_editor/instructions.md b/hu/code_editor/instructions.md
index 01c41e862f6..1559dc2c343 100644
--- a/hu/code_editor/instructions.md
+++ b/hu/code_editor/instructions.md
@@ -10,13 +10,13 @@ A Gedit egy open-source (nyílt forráskódú), ingyenes kódszerkesztő, az ös
 
 ## Sublime Text 3
 
-A Sublime Text egy nagyon népszerű editor, ingyenes próbaidővel. Könnyű telepíteni és használni, és minden operációs rendszeren elérhető.
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
 
 [Letöltés](https://www.sublimetext.com/3)
 
 ## Atom
 
-Az Atom egy teljesen új kódszerkesztő, amelyet a [GitHub](https://github.com/) hozott létre. Ingyenes, nyílt forráskódú, könnyen telepíthető és könnyen használható. Elérhető Windows-on, OSX-en és Linuxon.
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
 
 [Letöltés](https://atom.io/)
 
@@ -28,4 +28,4 @@ Az első ok az, hogy a kódot **egyszerű szövegként** kell szerkeszteni. Az 
 
 A másodsorban ezek a programozáshoz tervezett szövegszerkesztők kifejezetten kódszerkesztésre szakosodtak, ami azt jelenti hogy különböző funkciókkal segítik a munkát, mint például a programkód részeinek, szavainak kiemelése annak jelentése alapján, vagy az automatikus kiegészítés.
 
-Ezt mind látni fogjuk a későbbiekben. Hamarosan úgy fogsz gondolni a jó öreg megbízható kódszerkesztődre, mint az egyik kedvenc eszközödre :)
\ No newline at end of file
+Ezt mind látni fogjuk a későbbiekben. Hamarosan úgy fogsz gondolni a jó öreg megbízható kódszerkesztődre, mint az egyik kedvenc eszközödre. :)
\ No newline at end of file
diff --git a/hu/css/README.md b/hu/css/README.md
index edaa69771f8..54bf1b1d1ec 100644
--- a/hu/css/README.md
+++ b/hu/css/README.md
@@ -4,48 +4,49 @@ Egyelőre nem túl szép a blogunk, igaz? Itt az ideje, hogy kicsinosítsd! Erre
 
 ## Mi a CSS?
 
-A CSS (Cascading Style Sheets) egy nyelv, amit a HTML-ben megírt weboldalak kinézetének leírására használunk. Vagyis mintha kisminkelnéd a weboldaladat ;).
+A CSS (Cascading Style Sheets) egy nyelv, amit a HTML-ben megírt weboldalak kinézetének leírására használunk. Vagyis mintha kisminkelnéd a weboldaladat. ;)
 
-De nem akarjuk megint az alapoktól kezdeni, igaz? Itt is olyasmit fogunk felhasználni, amit más programozók már létrehoztak, és szabadon elérhetővé tettek az Interneten. Minek találnánk fel újra a spanyolviaszt?
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
 
 ## Használjunk Bootstrapet!
 
 A Bootstrap az egyik legnépszerűbb HTML és CSS keretrendszer, amivel szép weboldalakat készíthetünk: https://getbootstrap.com/
 
-Eredetileg a Twitternél dolgozó programozók készítették, de most önkéntesek fejlesztik szerte a világon.
+Eredetileg a Twitternél dolgozó programozók készítették, de most önkéntesek fejlesztik szerte a világon!
 
 ## Bootstrap telepítés
 
-Hogy telepítsd a Bootstrapet, add hozzá a következő a sorokat a `<head>` részhez a `.html` fájlodban (`blog/templates/blog/post_list.html`):
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
-```    
+```
 
 Ezzel nem adsz hozzá új fájlokat a projektedhez, csak az Interneten létező fájlokra hivatkozol. Nyisd meg újra a weboldaladat, és frissítsd! Itt is van!
 
-![14.1 ábra][1]
-
- [1]: images/bootstrap1.png
+![14.1 ábra](images/bootstrap1.png)
 
 Már sokkal jobban néz ki!
 
 ## Statikus fájlok a Django-ban
 
-Most nézzük meg kicsit közelebbről ezeket a "**statikus fájl**"-nak nevezett dolgokat. A CSS-ed és az összes képfájl statikus fájlnak számít -- ilyen minden, ami nem dinamikus, vagyis aminek a tartalma nem függ a kontextustól (magyarul a weboldal aktuális állapotától), és ezért minden felhasználó számára ugyanaz.
+Most nézzük meg kicsit közelebbről ezeket a "**statikus fájl**"-nak nevezett dolgokat. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
 
 ### Hová pakoljuk a statikus fájlokat?
 
-Django már tudja, hol találja a statikus fájlokat a beépíttett "admin" alkalmazáshoz. Most csak annyit kell tennünk, hogy a saját, `blog` alkalmazásunkhoz hozzáadunk néhány statikus fájlt.
+Amikor -- kicsit korábban -- a collectstatic parancsot futtattuk a szerveren, Django már tudta, hol találja a statikus fájlokat a beépíttett "admin" alkalmazáshoz. Most csak annyit kell tennünk, hogy a saját, `blog` alkalmazásunkhoz hozzáadunk néhány statikus fájlt.
 
 Ehhez pedig létre kell hozunk egy "`static`" nevű könyvtárat a blog applikáción belül:
 
     djangogirls
-     ├── blog
-     │ ├── migrations
-     │ └── static 
-     └── mysite
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
     
 
 A Django automatikusan megtalál minden "static" nevű mappát az alkalmazásaid könyvtárain belül, és képes lesz használni azok tartalmát statikus fájlokként.
@@ -56,55 +57,59 @@ A Django automatikusan megtalál minden "static" nevű mappát az alkalmazásaid
 
     djangogirls
      └─── blog
-         └─── static
+         └─── statikus
              └─── css
                  └─── blog.css
     
 
 Itt az ideje, hogy a CSS fájlunkba írjunk is valamit! Nyisd meg a `blog/static/css/blog.css` fájlt a kódszerkesztődben.
 
-Most nem fogunk túlságosan belemélyedni a CSS-be, mert nem bonyolult, és magadtól is meg tudod majd tanulni a workshop után. Ennek a fejezetnek a végén ajánlunk egy ingyenes kurzust, ahol többet tudhatsz meg a CSS-ről.
-
-De azért egy pár dolgot megmutatunk. Például megváltoztathatnánk a header színét? Hogy a számítógépek megértsék a színeket, speciális kódokat használnak. `#` jellel kezdődnek, majd 6 betű (A-F) és szám (0-9) következik. Színkódokat például itt találhatsz: http://www.colorpicker.com/. [Előre meghatározott színeket][3] is használhatsz, mint a `red` vagy a `green`.
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
 
- [3]: http://www.w3schools.com/cssref/css_colornames.asp
+De azért egy pár dolgot megmutatunk. Például megváltoztathatnánk a címsor színét? Hogy a számítógépek megértsék a színeket, speciális kódokat használnak. `#` jellel kezdődnek, majd 6 betű (A-F) és szám (0-9) következik. For example, the code for blue is `#0000FF`. Színkódokat például itt találhatsz: http://www.colorpicker.com/. [Előre meghatározott színeket](http://www.w3schools.com/colors/colors_names.asp) is használhatsz, mint a `red` vagy a `green`.
 
 A `blog/static/css/blog.css` fájlba írd bele a következő kódot:
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 h1 a {
-  color: #FCA205;
+    color: #FCA205;
 }
-```    
+```
 
-A `h1 a` egy CSS szelektor. Ez azt jelenti, hogy alkalmazzuk a stílusunkat minden olyan `a` elemre, ami egy `h1` elemen belül van (például, mikor valami ilyesmi van a kódban: `<h1><a href="">link</a></h1>`). Ebben az esetben azt mondjuk, hogy változtasd meg a kiválasztott elem színét `#FCA205`-re, ami narancssárgát jelent. Természetesen nyugodtan használd a saját színedet itt!
+A `h1 a` egy CSS szelektor. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. Ebben az esetben azt mondjuk, hogy változtasd meg a kiválasztott elem színét `#FCA205`-re, ami narancssárgát jelent. Természetesen nyugodtan használd a saját színedet itt!
 
-A CSS fájlban mondjuk meg, hogy nézzenek ki a HTML fájl elemei. Az egyes elemek beazonosíthatók az elemek nevei alapján (pl. `a`, `h1`, `body`), és a `class` vagy az `id` attribútumaik alapján. A class és az id olyan nevek, amelyeket te adhatsz meg az elemeknek. A class attribútum elemek egy csoportjára vonatkozik, míg az id-val kifejezetetten egy elemet tudunk beazonosítani. A következő tag például beazonosítható akár az "`a`" tag névvel, az `external_link` class-szal vagy a `link_to_wiki_page` id-val:
+A CSS fájlban mondjuk meg, hogy nézzenek ki a HTML fájl elemei. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. A class és az id olyan nevek, amelyeket te adhatsz meg az elemeknek. A class attribútum elemek egy csoportjára vonatkozik, míg az id-val kifejezetetten egy elemet tudunk beazonosítani. A következő tag például beazonosítható akár az "`a`" tag névvel, az `external_link` class-szal vagy a `link_to_wiki_page` id-val:
 
 ```html
-<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
-```    
-
-Olvass utána a [CSS szelektorokról a w3schools oldalán][4].
+html<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
 
- [4]: http://www.w3schools.com/cssref/css_selectors.asp
+Olvass utána a [CSS szelektorokról a w3schools oldalán](http://www.w3schools.com/cssref/css_selectors.asp).
 
 Mindezek után közölnünk kell a HTML fájlunkkal is, hogy hozzáadtunk pár CSS-t. Nyisd meg a `blog/templates/blog/post_list.html` fájlt és add a következő sort a fájl legelejére:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
-```    
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
 
-Itt csak betöltünk pár statikus fájlt :). Ezután a `<head>` és a `</head>` tagek közé, a Bootstrap CSS fájlok linkjei után (a böngésző olyan sorrendben olvassa az egyes fájlokat, amilyenben követik egymást, tehát a mi fájlunkban lévő kód lehet, hogy felülír pár kódot a Bootstrap fájlban), a következő sort add:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <link rel="stylesheet" href="{% static 'css/blog.css' %}">
-```     
+```
 
-Most megmondtuk a template-ünknek, hol találja a CSS fájlokat.
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. Most megmondtuk a template-ünknek, hol találja a CSS fájlokat.
 
 Így kellene kinéznie a fájlodnak:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -129,37 +134,38 @@ Most megmondtuk a template-ünknek, hol találja a CSS fájlokat.
     </body>
 </html>
 ```
-    
 
 Oké, mentsd el a fájlt és frissítsd be az oldalt!
 
-![14.2 ábra][5]
-
- [5]: images/color2.png
+![14.2 ábra](images/color2.png)
 
 Szép munka! Lehet, hogy jó lenne adni egy kis "teret" a weboldalunknak és növelni a bal oldali margót. Próbáljuk meg!
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 body {
     padding-left: 15px;
 }
-```    
+```
 
 Írd hozzá a CSS fájlodhoz, mentsd el és lássuk, működik-e!
 
-![14.3 ábra][6]
-
- [6]: images/margin2.png
+![14.3 ábra](images/margin2.png)
 
 Lehet, hogy testre szabhatnánk a betű stílusát a header-ünkben. A következő sort másold bele a `<head>`-be a `blog/templates/blog/post_list.html` fájlon belül:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
-<link href="https://fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
-```    
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
 
-Ez a sor beimportál egy *Lobster* nevű betűtípust a Google Fonts-ból (https://www.google.com/fonts).
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
 
-Most add hozzá a `font-family: 'Lobster';` sort a `blog/static/css/blog.css` fájlodban, a `h1 a` stílusát meghatározó blokkhoz (ez a `{` kapcsos zárójel `}` közötti kód) és frissítsd az oldalt:
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 h1 a {
@@ -168,24 +174,26 @@ h1 a {
 }
 ```
 
-![14.3 ábra][7]
-
- [7]: images/font.png
+![14.3 ábra](images/font.png)
 
 Szuper!
 
-Ahogy fentebb említettük, a CSS-ben van egy "class" nevű fogalom, ami alapvetően azt teszi lehetővé, hogy elnevezd a HTML kódod egy részét és alkalmazz rajta egy stílust, csak ezen a részen, ami így nem befolyásolja a többit. Nagyon hasznos tud lenni, például amikor van két dived, amelyek nagyon különböző dolgokat csinálnak (akár a header-ed vagy a post-od), tehát nem akarod, hogy ugyanúgy nézzenek ki.
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
 
 Menj végig és nevezd el egy részét a HTML kódodnak. Adj egy `page-header` nevű class-t a `div`-edhez, amelyik a header-t tartalmazza, akárcsak így:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="page-header">
     <h1><a href="/">Django Girls Blog</a></h1>
 </div>
-``` 
+```
 
 És most adj egy `post` class-t a `div`-hez, ami a blog postokat tartalmazza.
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="post">
     <p>published: {{ post.published_date }}</p>
@@ -194,7 +202,9 @@ Menj végig és nevezd el egy részét a HTML kódodnak. Adj egy `page-header` n
 </div>
 ```
 
-Most pedig adjunk stílusblokkokat a különböző szelektorokhoz. A `.` -tal kezdődő szelektorok classokra utalnak. Rengeteg szuper tutorial és magyarázat található a weben a CSS-ről, ami segít megérteni a következő kódot. Most csak másold ki és illeszd be a `blog/static/css/blog.css` fájlodba:
+Most pedig adjunk stílusblokkokat a különböző szelektorokhoz. A `.` -tal kezdődő szelektorok classokra utalnak. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. Most csak másold ki és illeszd be a `blog/static/css/blog.css` fájlodba:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 .page-header {
@@ -218,7 +228,6 @@ h1, h2, h3, h4 {
 }
 
 .date {
-    float: right;
     color: #828282;
 }
 
@@ -248,6 +257,8 @@ h1, h2, h3, h4 {
 
 Ezután jelöld ki a HTML kódot, ami a post-okat jeleníti meg egy class="post" attribútummal. Cseréld le ezt:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     <div class="post">
@@ -260,6 +271,8 @@ Ezután jelöld ki a HTML kódot, ami a post-okat jeleníti meg egy class="post"
 
 a `blog/templates/blog/post_list.html` fájlban ezzel:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="content container">
     <div class="row">
@@ -267,7 +280,7 @@ a `blog/templates/blog/post_list.html` fájlban ezzel:
             {% for post in posts %}
                 <div class="post">
                     <div class="date">
-                        {{ post.published_date }}
+                        <p>published: {{ post.published_date }}</p>
                     </div>
                     <h1><a href="">{{ post.title }}</a></h1>
                     <p>{{ post.text|linebreaksbr }}</p>
@@ -280,14 +293,12 @@ a `blog/templates/blog/post_list.html` fájlban ezzel:
 
 Mentsd el a fájlokat és frissítsd az oldalad.
 
-![14.4 ábra][8]
-
- [8]: images/final.png
+![14.4 ábra](images/final.png)
 
-Nahát! Fantaszikus nem? A kódot, amit beillesztettünk, nem túl nehéz megérteni és a nagyja már csak átolvasva is érthető kell, hogy legyen. Mit változtatnál ahhoz, hogy a dátum türkízkék színű legyen?
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
 
-Ne félj kicsit megbuherálni ezt a CSS-t és megváltoztatni pár dolgot. Ha valamit elrontasz, ne aggódj, vissza tudod csinálni!
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
 
-Mindenesetre melegen ajánljuk ezt az ingyenes online [Codeacademy HTML & CSS kurzust][2], mint workshop utáni házi feladatot, hogy mindent tudj arról, hogyan tudod csinosabbá varázsolni a weboldaladat CSS-sel.
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
 
 Készen állsz a következő fejezetre?! :)
\ No newline at end of file
diff --git a/hu/deploy/README.md b/hu/deploy/README.md
index 6eea7e68721..fa6b300c119 100644
--- a/hu/deploy/README.md
+++ b/hu/deploy/README.md
@@ -2,22 +2,17 @@
 
 > **Megjegyzés** A következő fejezet néhol kissé bonyolult lehet. Tarts ki és vedd át az egész fejezetet; ugyanis most a webfejlesztés egy nagyon fontos része következik - az ún. deployment. Ez a fejezet a tutorial közepén található, így majd a mentorod is tud segíteni a trükkösebb részeknél, miközben a honlapodat online is elérhetővé teszed. Magát a tutorialt később egyedül is befejezheted, ha esetleg kifutnál az időből.
 
-Ezidáig a honlapod csak a saját számítógépeden volt elérhető - most tanuljuk meg, hogyan tegyük mások számára is elérhetővé! Ez az ún. deploying - az a tevékenység, amely során az alkalmazásodat közzé teszed az interneten, hogy mások is láthassák és használhassák azt :).
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Ez az ún. deploying - az a tevékenység, amely során az alkalmazásodat közzé teszed az interneten, hogy mások is láthassák és használhassák azt. :)
 
-Ahogyan azt már tudod, a honlapot egy szerveren kell elhelyezni. Több szerver szolgáltató is elérhető az interneten. Mi egy olyat fogunk használni, amit viszonylag egyszerű kezelni: [PythonAnywhere][1]. A PythonAnywhere ingyenes olyan kisebb alkalmazások számára, amelyeknek nincs sok látogatójuk, tehát a mi esetünkben ez pont megfelelő lesz.
+Ahogyan azt már tudod, a honlapot egy szerveren kell elhelyezni. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
- [1]: https://www.pythonanywhere.com/
-
-A másik külső szolgáltatás, amit igénybe fogunk venni a [GitHub][2], ami egy ún. code hosting service (forráskód tárolására és megosztására alkalmas online tárhely). Vannak más hozzá hasonló szolgáltatók is, de szinte minden programozó ezt használja manapság, és nemsokára te is közéjük tartozhatsz!
-
- [2]: https://www.github.com
-
-Ez a három hely lesz fontos. A saját számítógéped lesz az a hely, ahol fejlesztesz és tesztelsz. Amikor elégedett vagy a módosításaiddal, felmásolod a programodat GitHub-ra. A website-od a PythonAnywhere-en lesz, és a GitHub-ról fogod frissíteni.
+A másik külső szolgáltatás, amit igénybe fogunk venni a [GitHub](https://www.github.com), ami egy ún. code hosting service (forráskód tárolására és megosztására alkalmas online tárhely). Vannak más hozzá hasonló szolgáltatók is, de szinte minden programozó ezt használja manapság, és nemsokára te is közéjük tartozhatsz!
 
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
 
 # Git
 
-> **Megjegyzés** Ha már követted a korábbi telepítési utasításokat, ezt a pontot átugorhatod és kezdheted kialakítani a saját Git csomagtáradat!
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
 
 {% include "/deploy/install_git.md" %}
 
@@ -25,7 +20,9 @@ Ez a három hely lesz fontos. A saját számítógéped lesz az a hely, ahol fej
 
 A Git nyomon követi a változásokat az adott fájlokban egy ún. csomagtárban (repository vagy röviden "repo"). Nyissunk egy új repo-t a projektünknek. Nyisd fel a konzolt és futtasd le a következő parancsokat, a `djangogirls` mappában:
 
-> **Megjegyzés** Az alábbi parancsokkal ellenőrizheted a munkamappát (working directory, az éppen megnyitott mappa): `pwd` (OSX/Linux) vagy `cd` (Windows) mielőtt létrehoznád a repositoryt. A `djangogirls` mappában kell lenned.
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. A `djangogirls` mappában kell lenned.
+
+{% filename %}command-line{% endfilename %}
 
     $ git init
     Initialized empty Git repository in ~/djangogirls/.git/
@@ -33,29 +30,30 @@ A Git nyomon követi a változásokat az adott fájlokban egy ún. csomagtárban
     $ git config --global user.email you@example.com
     
 
-A git csomagtár inicializálása olyasvalami, amit minden projekt esetében csak egyszer kell véghezvinni (így majd nem kell újra és újra megadni a felhasználónevet ill. jelszót).
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
 
 A Git ezután nyomon követ minden változást a fájlokban és mappákban ezen a mappán belül. De vannak bizonyos fájlok, amiket nem szeretnénk figyelembe venni. Ezt úgy tehetjük meg, hogy létrehozunk egy fájlt `.gitignore` névvel a gyökérkönyvtárban. Nyisd meg a szövegszerkesztőt és hozz létre egy új fájlt, amibe az alábbi sorok kerülnek:
 
 {% filename %}.gitignore{% endfilename %}
-```
-*.pyc
-*~
-__pycache__
-myvenv
-db.sqlite3
-/static
-.DS_Store
-```
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
     
 
-Majd mentsd le `.gitignore` néven a "djangogirls" legfelsőbb mappájában.
+And save it as `.gitignore` in the "djangogirls" folder.
 
-> **Megjegyzés** Nagyon fontos, hogy a fájl neve ponttal kezdődjön! Ha bármi gond adódna a fájl létrehozásánál (pl. Mac számítógépeken a Finder alapvetően nem engedi, hogy a fájlnév ponttal kezdődjön), akkor használd a "Save as" lehetőséget.
+> **Megjegyzés** Nagyon fontos, hogy a fájl neve ponttal kezdődjön! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
 
-> **Megjegyzés** A `.gitignore` file-ban megadott file-ok egyike a `db.sqlite3`. Ez a file a lokális adatbázisod, ez tárolja az összes blogposztodat. Nem akarjuk hozzáadni a repository-hoz, mert a PythonAnywhere-en lévő weboldal egy másik adatbázist fog használni. Az az adatbázis lehet SQLite, mint a fejlesztői gépeden, de többnyire egy MySQL nevűt fogsz használni, amely jóval több látogatót tud kiszolgálni mint az SQLite. Akármelyiket választod, azzal hogy az SQLite adatbázisod kihagyjuk a GitHub másolatból, az összes blogpost amelyet eddig létrehoztál csak lokálisan lesz elérhető, a publikus weboldalon újra létre kell majd ezeket hozni. Gondolj úgy a lokális adatbázisodra, mint egy  játszótérrel, ahol kipróbálhatsz különböző dolgokat és nem kell attól tartanod, hogy valódi posztokat fogsz törölni a blogodról.
+Jó ötlet a `git status` parancs használata még a `git add` előtt, valamint ezen kívül még bármikor, ha tudni szeretnéd, hogy mi változott. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
 
-Jó ötlet a `git status` parancs használata még a `git add` előtt, valamint ezen kívül még bármikor, ha tudni szeretnéd, hogy mi változott. Ez majd segít elkerülni olyan szituációkat, mint például rossz fájlok hozzáadása ill. feltöltése a csomagtárba. A `git status` parancs információt szolgáltat minden nem követett (not tracked) / megváltozott (modified) /feltöltésre felkészített fájlról (staged files) stb. A kimenet ehhez hasonló lesz:
+{% filename %}command-line{% endfilename %}
 
     $ git status
     On branch master
@@ -75,6 +73,8 @@ Jó ötlet a `git status` parancs használata még a `git add` előtt, valamint
 
 Végül mentsük le a változtatásokat. A konzolban futtasd le a következő parancsokat:
 
+{% filename %}command-line{% endfilename %}
+
     $ git add --all .
     $ git commit -m "My Django Girls app, first commit"
      [...]
@@ -82,183 +82,154 @@ Végül mentsük le a változtatásokat. A konzolban futtasd le a következő pa
      create mode 100644 .gitignore
      [...]
      create mode 100644 mysite/wsgi.py
+     ```
     
-
-## Forráskód feltöltése a GitHubra
-
-A böngészőben keresd fel a [GitHub.com][2] honlapot és regisztrálj be egy új "free user" fiókba. (Ha már beregisztráltál, ezt a pontot kihagyhatod) 
-
-Ezután hozz létre egy új csomagtárat ("repót"), amit nevezz "my-first-blog"-nak. Hagyd az "initialise with a README" mezőt jelöletlenül, a .gitignore lehetőséget hagyd üresen (ezt manuálisan tettük), a "License" résznél maradjon a "None" opció.
-
-![][3]
-
- [3]: images/new_github_repo.png
-
-> **Megjegyzés** A `my-first-blog` név fontos -- választhattál volna más nevet is, de gyakran előfordul majd a későbbiekben is a parancsokban. Valószínűleg egyszerűbb lesz számodra is, ha a `my-first-blog` nevet használod.
-
-A következő oldalon látni fogod a repód url-jét (repo's clone url). Válaszd a "HTTPS" verziót, másold ki - mindjárt bemásoljuk a terminálba:
-
-![][4]
-
- [4]: images/github_get_repo_url_screenshot.png
-
-Most összekötjük a Git csomagtárat a számítógépeden a másik csomagtárral a GitHubon.
-
-A konzolba írd be a következőt (helyettesítsd a `<your-github-username>` a saját felhasználóneveddel, amivel a GitHubon regisztráltál, de a kacsacsőrök nélkül):
-
-    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
-    $ git push -u origin master
     
-
-Add meg a GitHub felhasználónevedet és jelszódat, valami hasonlót kell hogy láss:
-
-    Username for 'https://github.com': hjwp
-    Password for 'https://hjwp@github.com':
-    Counting objects: 6, done.
-    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
-    Total 3 (delta 0), reused 0 (delta 0)
-    To https://github.com/hjwp/my-first-blog.git
-     * [new branch]      master -> master
-    Branch master set up to track remote branch master from origin.
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
     
 
-<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extention -->
-
-A forráskódod most már fent van a GitHubon. Menj és nézd meg! Láthatod hogy jó társasága van - [Django][5], a [Django Girls Tutorial][6], és sok más szuper nyílt forráskódú szoftver forráskódja szintén a GitHubon található :)
-
- [5]: https://github.com/django/django
- [6]: https://github.com/DjangoGirls/tutorial
-
-# Tegyük fel a blogot a PythonAnywhere-re
-
-> **Megjegyzés** Valószínűleg már létrehoztál egy PythonAnywhere fiókot korábban a telepítés során - ha így van, ezt nem kell újból megtenned.
-
-{% include "/deploy/signup_pythonanywhere.md" %}
-
-## Forráskód letöltése a PythonAnywhere-be
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
 
-Amikor bejelentkezel a PythonAnywhere-be, egyből a dashboard-on, vagy "Consoles" oldalon találod magad. Válaszd a "Bash" konzol indítása opciót -- ez a PythonAnywhere konzolja, ugyanolyan, mint a parancssor a gépeden.
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
 
-> **Megjegyzés** A PythonAnywhere Linux rendszeren alapszik, tehát ha Windows-ot használsz, a konzol egy kissé máshogy fog kinézni a te számítógépeden.
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
 
-Töltsük be a forráskódodat a GitHubról a PythonAnywhere-be egy "clone" létrehozásával. Írd be az alábbiakat a konzolba a PythonAnywhere-ben (ne felejtsd, hogy a `<your-github-username>` helyébe a saját, GitHubon használt felhasználónevedet helyettesítsd be):
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
 
-    $ git clone https://github.com/<your-github-username>/my-first-blog.git
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Menj és nézd meg!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Töltsük be a forráskódodat a GitHubról a PythonAnywhere-be egy "clone" létrehozásával. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
     
 
-Ez majd betölti a forráskódod másolatát a PythonAnywhere-be. Ellenőrizheted, ha beírod a konzolba, hogy `tree my-first-blog`:
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
 
-    $ tree my-first-blog
-    my-first-blog/
-    ├── blog
-    │   ├── __init__.py
-    │   ├── admin.py
-    │   ├── migrations
-    │   │   ├── 0001_initial.py
-    │   │   └── __init__.py
-    │   ├── models.py
-    │   ├── tests.py
-    │   └── views.py
-    ├── manage.py
-    └── mysite
-        ├── __init__.py
-        ├── settings.py
-        ├── urls.py
-        └── wsgi.py
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
     
 
-### Virtuális környezet létrehozása a PythonAnywhere-en
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
 
-Ugyanúgy, ahogy a saját gépeden csináltad, a PythonAnywhere-en is létrehozhatsz virtualenvet. Írd be a Bash konzolba:
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-{% filename %}PythonAnywhere parancssor{% endfilename %}
-```
 $ cd my-first-blog
 
-$ virtualenv --python=python3.6 myvenv
-Running virtualenv with interpreter /usr/bin/python3.6
-[...]
-Installing setuptools, pip...done.
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
 
 $ source myvenv/bin/activate
 
-(myvenv) $  pip install django~=1.11.0
-Collecting django
-[...]
-Successfully installed django-1.11.3
-```
-
-
-> **Megjegyzés** A `pip install` lépés eltarthat pár percig. Légy türelmes! De ha több mint 5 percig tart, akkor valószínűleg valami nincs rendben. Kérdezd meg a coachodat!
-
-<!--TODO: think about using requirements.txt instead of pip install.-->
-
-## Tegyük közzé a blogot a weben!
-
-Most már fent van a kódod a PythonAnywhere-en, kész a virtuális környezet, össze vannak gyűjtve a statikus fájlok, és az adatbázist is elkészítetted. Készen állsz, hogy webes alkalmazást csinálj belőle!
-
-Menj vissza a PythonAnywhere dashboardra (a logóra kattintva megteheted), majd kattints a **Web** tabra. Végül nyomd meg a **Add a new web app** gombot.
-
-Miután leokéztad a domainnevedet, válaszd a **manual configuration**-t (kézi konfiguráció - vigyázz, *ne* a "Django" opciót válaszd!) a párbeszédablakban. Aztán válaszd ki a **Python 3.4**-et, majd nyomd meg a Nextet.
-
-> **Megjegyzés** Fontos, hogy a "Manual configuration" lehetőséget válaszd, ne a "Django"-t. Túl menők vagyunk a PythonAnywhere-es Django setuphoz:)
-
-### Adatbázis létrehozása PythonAnywhere-en
-
-Van még valami, ami máshogy működik a saját gépeden és a szerveren: különböző szervert használnak. Így a felhasználói fiókok és a blogposztok különbözőek lehetnek a szerveren és a gépeden.
-
-A szerveren ugyanúgy tudod létrehozni az adatbázist, mint a saját gépeden, a `migrate` és `createsuperuser` parancsokkal:
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
 
-    (mvenv) $ python manage.py migrate
-    Operations to perform:
-    [...]
-      Applying sessions.0001_initial... OK
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
     
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
     
-    (mvenv) $ python manage.py createsuperuser
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
     
 
-### Virtuális környezet beállítása
-
-Most a PythonAnywhere config oldalára kerülsz, ahol különböző dolgokat állíthatsz be az appeddel kapcsolatban. Ha bármit meg szeretnél változtatni később, ide kell visszajönnöd.
-
-![][7]
-
- [7]: images/pythonanywhere_web_tab_virtualenv.png
-
-A "Virtualenv" részben kattints rá a piros szövegre: "Enter the path to a virtualenv", majd írd be: `/home/<your-username>/my-first-blog/myvenv/`. Kattints a kék dobozra a pipajellel, hogy elmentsd a path-t, mielőtt továbblépsz.
-
-> **Megjegyzés** Helyettesítsd be a saját felhasználóneved. Ha elrontasz valamit, a PythonAnywhere figyelmeztetni fog.
-
-### A WSGI fájl konfigurálása
-
-A Django a "WSGI protokollt" használja. Ez egy szabvány, ami a Python segítségével kiszolgált weboldalakra érvényes. A PythonAnywhere is támogatja ezt. Ahhoz, hogy a PythonAnywhere felismerje a Django blogunkat, egy WSGI konfigurációs fájlt kell szerkesztenünk.
-
-Kattints a "WSGI configuration file" linkre (a "Code" szekcióban az oldal tetejénél -- olyasmi neve lesz, hogy `/var/www/<your-username>_pythonanywhere_com_wsgi.py`). Egy kódszerkesztőbe fogsz jutni.
-
-Törölj ki mindent, és cseréld ki valami ilyesmire:
-
-```python
-import os
-import sys
-
-path = '/home/<your-username>/my-first-blog'  # itt a saját felhasználónevedet használd!
-if path not in sys.path:
-    sys.path.append(path)
-
-os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
-
-from django.core.wsgi import get_wsgi_application
-from django.contrib.staticfiles.handlers import StaticFilesHandler
-application = StaticFilesHandler(get_wsgi_application())
-```
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
 
-> **Megjegyzés** Ne felejtsd el a saját felhasználóneveddel helyettesíteni a `<your-username>`-et!
-> **Megjegyzés** A negyedik sorban gondoskodunk arról, hogy Python megtalálja a programunkat. Fontos, hogy ez az elérési út helyes legyen, és különösen hogy ne legyenek benne fölösleges szóközök. Különben "ImportError" hibát fogsz találni a logfile-ban.
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
 
-Ennek a fájlnak az a dolga, hogy megmondja a PythonAnywhere-nek, hol lakik a webes alkalmazásunk, és mi annak a fájlnak a neve, ahol a Django beállításai vannak.
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
 
-A `StaticFilesHandler` a CSS-ünkről gondoskodik. Helyi fejlesztéskor a `runserver` parancs látja el ezt a feladatot. Kicsivel később behatóbban megismerkedünk a statikus file-okkal, amikor a weboldalunk CSS-ét szerkesztjük.
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. A statikus fájlokról többet is tanulsz majd a tutorial során, amikor a CSS-t fogod szerkeszteni a honlapodhoz.
 
 Nyomd meg a **Save** (Mentés) gombot, majd menj vissza a **Web** fülre.
 
@@ -266,28 +237,24 @@ Kész is vagyunk! Nyomd meg a nagy zöld **Reload** gombot, és máris meg fogod
 
 ## Tippek debuggoláshoz
 
-Ha hibát látsz, amikor megpróbálod meglátogatni az oldaladat, az első hely, ahol információt kaphatsz a debuggoláshoz, az **error log**. Ehhez a PythonAnywhere [Web tab][8]-ján találod meg a linket. Nézd meg, hogy van-e benne bármilyen hibaüzenet; a legfrissebbek lesznek alul. Gyakran előforduló problémák:
-
- [8]: https://www.pythonanywhere.com/web_app_setup/
-
-*   Kihagytad valamelyik lépést a konzolban: a virtualenv létrehozását, aktiválását, a Django installálását a virtualenvben, a collectstatic lefuttatását, az adatbázis migrálását.
+Ha hibát látsz, amikor megpróbálod meglátogatni az oldaladat, az első hely, ahol információt kaphatsz a debuggoláshoz, az **error log**. Ehhez a PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/)-ján találod meg a linket. Nézd meg, hogy van-e benne bármilyen hibaüzenet; a legfrissebbek lesznek alul. Gyakran előforduló problémák:
 
-*   Valamit elrontottál a virtualenv path-ban a Web fülön -- általában egy piros hibaüzenet jelzi, ha valami gond van.
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
 
-*   Valamit elrontottál a WSGI konfigurációs fájlban -- jól írtad be a my-first-blog könyvtárhoz vezető elérési útvonalat?
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
 
-*   Ugyanazt a Python verziót választottad a virtualenved számára, mint az alkalmazásodhoz? Mindkettőnek a 3.4-esnek kell lennie.
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
 
-*   A [PythonAnywhere wikiben is találsz néhány általános hibakeresési tippet][9].
+- Ugyanazt a Python verziót választottad a virtualenved számára, mint az alkalmazásodhoz? Mindkettőnek a 3.6-esnek kell lennie.
 
- [9]: https://www.pythonanywhere.com/wiki/DebuggingImportError
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
 
 És ne feledd, a coachod azért van, hogy segítsen!
 
 # Él a weboldalad!
 
-A honlapod alapértelmezett oldala a "Welcome to Django", ugyanúgy, mint a saját gépeden. Add hozzá az `/admin/`-t az URL végéhez, és az adminfelületre kerülsz. Jelentkezz be a felhasználóneveddel és a jelszavaddal, és látni fogod, hogy itt is tudsz új Postokat létrehozni.
+The default page for your site should say "It worked!", just like it does on your local computer. Add hozzá az `/admin/`-t az URL végéhez, és az adminfelületre kerülsz. Jelentkezz be a felhasználóneveddel és a jelszavaddal, és látni fogod, hogy itt is tudsz új Postokat létrehozni.
 
-Ha már létrehoztál pár blogpostot, válts vissza a helyi gépedre (nem PythonAnywhere). Ezután a helyi gépeden érdemes dolgoznod. Ez gyakori munkafolyamat webfejlesztéskor - lokális fejlesztés, a változtatások feltöltése GitHub-ra, majd letöltése az éles webszerverre. Ez lehetővé teszi, hogy kisérletezz a éles webszervered elrontása nélkül. Vagány, mi?
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
 
-Megérdemelsz egy *HATALMAS* vállveregetést! A szerver deployment a webfejlesztés legbonyolultabb részei közé tartozik, és a fejlesztők gyakran napokat töltenek azzal, hogy mindent működésre bírjanak. De neked most komolyan van egy működő weboldalad, az Interneten, és nem is tartott sokáig megcsinálni!
+Megérdemelsz egy *HATALMAS* vállveregetést! A szerver deployment a webfejlesztés legbonyolultabb részei közé tartozik, és a fejlesztők gyakran napokat töltenek azzal, hogy mindent működésre bírjanak. De neked most komolyan van egy működő weboldalad, az Interneten, és nem is tartott sokáig megcsinálni!
\ No newline at end of file
diff --git a/hu/deploy/install_git.md b/hu/deploy/install_git.md
index 559e12addd0..1adf534b66b 100644
--- a/hu/deploy/install_git.md
+++ b/hu/deploy/install_git.md
@@ -2,58 +2,51 @@ A Git egy "version control system" (VCS, magyarul verziókezelő rendszer), amit
 
 ## Git telepítése
 
-<!--sec data-title="Windows" data-id="git_install_windows"
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
 data-collapse=true ces-->
 
-A Gitet innen töltheted le: [git-scm.com](https://git-scm.com/). Telepítése: csak kattints a "next" gombra egészen addig, amíg el nem érsz az ötödik lépésig - "Adjusting your PATH environment" címmel - itt válaszd ki a "Run Git and associated Unix tools from the Windows command-line" lehetőséget (keresd alul). Ezen kívül a többi maradhat az alapbeállításon. Checkout Windows-style, commit Unix-style line endings - ezek is maradhatnak így.
+A Gitet innen töltheted le: [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Ezen kívül a többi maradhat az alapbeállításon. Checkout Windows-style, commit Unix-style line endings - ezek is maradhatnak így.
 
-<!--endsec-->
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
 
-<!--sec data-title="OS X" data-id="git_install_OSX"
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
 data-collapse=true ces-->
 
 Töltsd le a Git-tet az alábbi linken: [git-scm.com](https://git-scm.com/), majd kövesd az utasításokat.
 
-> **Megjegyzés** Ha OS X 10.6, 10.7, vagy 10.8-et használsz, Az ezen a linken elérhető verziót kell telepítened: [Git teleptő OS X Snow Leopard-ra](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
 
 <!--endsec-->
 
-<!--sec data-title="Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
 data-collapse=true ces-->
 
-{% filename %}parancssor{% endfilename %}
+{% filename %}command-line{% endfilename %}
+
 ```bash
 $ sudo apt-get install git
 ```
 
 <!--endsec-->
 
-<!--sec data-title="Fedora (up to 21)" data-id="git_install_fedora_21"
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
 data-collapse=true ces-->
 
-{% filename %}parancssor{% endfilename %}
-```bash
-$ sudo yum install git
-```
-
-<!--endsec-->
-
-<!--sec data-title="Fedora 22+" data-id="git_install_fedora_22"
-data-collapse=true ces-->
+{% filename %}command-line{% endfilename %}
 
-{% filename %}parancssor{% endfilename %}
 ```bash
 $ sudo dnf install git
 ```
 
 <!--endsec-->
 
-<!--sec data-title="openSUSE" data-id="git_install_openSUSE"
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
 data-collapse=true ces-->
 
-{% filename %}parancssor{% endfilename %}
+{% filename %}command-line{% endfilename %}
+
 ```bash
 $ sudo zypper install git
 ```
 
-<!--endsec-->
+<!--endsec-->
\ No newline at end of file
diff --git a/hu/deploy/signup_pythonanywhere.md b/hu/deploy/signup_pythonanywhere.md
index 283a3a92986..ca66bd0de69 100644
--- a/hu/deploy/signup_pythonanywhere.md
+++ b/hu/deploy/signup_pythonanywhere.md
@@ -1,5 +1,5 @@
-Most itt az ideje, hogy létrehozz magadnak egy ingyenes, "Kezdő" ("Beginner") fiókot a PythonAnywhere oldalon.
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
 
-  * [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
 
-> **Megjegyzés:** A blogod címe, vagyis URL-je `felhasználónév.pythonanywhere.com` lesz, vagyis érdemes a regisztrációkor felhasználónévnek vagy a saját becenevedet választani, vagy a blogod témájához kapcsolódó nevet.
\ No newline at end of file
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/hu/django/README.md b/hu/django/README.md
index 4daf57a971a..4c6e5b691b5 100644
--- a/hu/django/README.md
+++ b/hu/django/README.md
@@ -1,26 +1,26 @@
 # Mi a Django?
 
-A Django egy webes alkalmazások készítésére használható, Pythonban írt, ingyenes, nyílt forráskódú keretrendszer (framework). A webes keretrendszerek különböző építőelemek gyűjteményei, segítségükkel könnyebben és gyorsabban tudunk weboldalakat fejleszteni.
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A webes keretrendszerek különböző építőelemek gyűjteményei, segítségükkel könnyebben és gyorsabban tudunk weboldalakat fejleszteni.
 
 Amikor weboldalt készítesz, mindig hasonló elemekre lesz szükséged: meg kell oldanod a felhasználók azonosítását (regisztráció, be- és kijelentkezés), kell egy felület a honlap kezeléséhez, formok (kérdőívek), kell valami megoldás a fájlok feltöltésére, stb.
 
-Szerencsére mások már régen észrevették, hogy a webfejlesztők mindig hasonló problémákkal szembesülnek egy új oldal készítésekor, ezért közösen kifejlesztettek különböző keretrendszereket (ezek egyike a Django). Ezek a frameworkok használatra kész komponenseket tartalmaznak.
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
 
-A keretrendszerek megakadályozzák, hogy újra és újra fel kelljen találnod a spanyolviaszt, és sok időt megspórolnak a weboldalkészítésben.
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
 
 ## Miért van szükséged keretrendszerre?
 
-Hogy megértsd, pontosan mire jó a Django, fontos, hogy jobban megismerd a szervereket. Az első dolog, amit egy szervernek tudnia kell az az, hogyha szeretnéd, hogy kiszolgáljon neked egy weboldalt.
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
 
-Képzelj el egy postaládát (port), amit folyamatosan figyelnek, hogy vannak-e beérkezett levelek (requestek). Ezt csinálja egy webszerver. A webszerver elolvassa a levelet, és választ (response) küld, amiben egy weboldal van. Azonban amikor küldeni szeretnél valamit, szükséged van tartalomra. A Django ennek a tartalomnak a megalkotásában segít.
+Képzelj el egy postaládát (port), amit folyamatosan figyelnek, hogy vannak-e beérkezett levelek (requestek). Ezt csinálja egy webszerver. The web server reads the letter and then sends a response with a webpage. Azonban amikor küldeni szeretnél valamit, szükséged van tartalomra. A Django ennek a tartalomnak a megalkotásában segít.
 
 ## Mi történik, amikor valaki lekérdez egy honlapot a szerveredtől?
 
-Amikor beérkezik egy kérés (request) a szerverre, a Django kapja meg, ami megpróbálja kitalálni, hogy pontosan mire irányul a kérés. Először a weboldal címét nézi meg, és megpróbál rájönni, hogy mit kell tenni. Ezt a részt a Django **urlresolver** része végzi (emlékezz vissza, hogy a weboldalak címét URL-nek - Uniform Resource Locatornak - hívják, vagyis az *urlresolver* névnek - kb. url-fordító - van értelme). Ez a dolog nem túl okos - csak fog egy csomó mintát (pattern), és megpróbálja hozzájuk illeszteni az URL-t. A Django felülről lefelé vizsgálja meg a mintákat, és ha az URL valamelyikkel megegyezik, továbbadja a requestet a megfelelő function-nek (függvénynek), amit *view*-nak hívunk).
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
 
 Képzelj el egy postást egy levéllel. Ahogy halad az utcán, minden házszámot megnéz, és összehasonlítja a levélen lévővel. Ha megegyezik, bedobja a levelet a postaládába. Így működik az urlresolver!
 
-A *view*, vagyis "nézet" rész az, ahol az érdekes dolgok történnek: itt nézhetünk bele adatbázisokba, hogy megkeressünk valamilyen információt. Talán a felhasználó meg szeretne változtatni valamilyen adatot? Mint egy levél, ami azt írja: "Kérlek, változtasd meg a munkám leírását." A *view* megnézi, hogy jogosult vagy-e erre a módosításra, aztán megváltoztatja a munka leírását, és visszaküld egy üzenetet: "Kész!". Aztán a *view* létrehoz egy választ, amit a Django elküld a felhasználó böngészőjének.
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Talán a felhasználó meg szeretne változtatni valamilyen adatot? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
 
 Természetesen ez a leírást egy kicsit leegyszerűsítettünk, de még nem kell, hogy minden technikai részletet tudj. Elég, ha van egy általános elképzelésed.
 
diff --git a/hu/django_admin/README.md b/hu/django_admin/README.md
index fb295d3f4f9..5b9816cd8ed 100644
--- a/hu/django_admin/README.md
+++ b/hu/django_admin/README.md
@@ -1,8 +1,10 @@
 # Django admin
 
-Az előbb elkészítettük a bejegyzések modelljeit. Ahhoz, hogy létrehozhassuk, szerkeszthessük és törölhessük őket, a Django admint fogjuk használni.
+To add, edit and delete the posts we've just modeled, we will use Django admin.
 
-Nyisd meg a `blog/admin.py` fájlt, és cseréld ki a benne lévő kódot erre:
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
 
 ```python
 from django.contrib import admin
@@ -13,19 +15,26 @@ admin.site.register(Post)
 
 Amint láthatod, importáljuk az előző fejezet végén definiált Post modellt, vagyis elérhetővé tesszük ebben a fájlban is. Hogy a modell látszódjon az admin oldalon, regisztrálnunk kell a `admin.site.register(Post)` sorral.
 
-Most nézzük meg, hogy néz ki a Post modell. Ne felejtsd el futtatni a `python manage.py runserver` parancsot a konzolban, hogy elindítsd a webszervert. Írd be a böngészőben a http://127.0.0.1:8000/admin/ címet. Egy ilyen login oldalt fogsz látni:
-
-![Login page][1]
+Most nézzük meg, hogy néz ki a Post modell. Ne felejtsd el futtatni a `python manage.py runserver` parancsot a konzolban, hogy elindítsd a webszervert. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
 
- [1]: images/login_page2.png
+![Login page](images/login_page2.png)
 
-A bejelentkezéshez létre kell hoznod egy *superuser*-t - egy olyan felhasználót, akinek mindenhez van hozzáférése az oldalon. Menj vissza a parancssorba, és írd be a `python manage.py createsuperuser` parancsot, majd nyomj entert.
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
 
-> Ne felejtsd, hogy ahhoz hogy új parancsokat tudj lefuttatni, miközben a webszerver fut, új terminál ablakot kell nyitnod és abban aktiválnod a virtualenvet. Erről <b>Az első Django projekted!</b> fejezetben, a <b>Webszerver elindítása</b> szakaszban volt szó.
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
 
-A következő lépésekben meg kell adnod egy felhasználónevet (ne használj nagybetűket és szóközt), emailcímet és jelszót. Ne ijedj meg, ha nem látod a jelszót, amikor begépeled - ennek így kell lennie. Csak írd be, és nyomj `enter`t a folytatáshoz. Az outputnak így kell kinéznie (természetesen a felhasználónév és az email az lesz, amit te adtál meg):
+{% filename %}Mac OS X or Linux:{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
     Username: admin
     Email address: admin@admin.com
     Password:
@@ -33,20 +42,16 @@ A következő lépésekben meg kell adnod egy felhasználónevet (ne használj n
     Superuser created successfully.
     
 
-Térj vissza a böngészőbe. Jelentkezz be a superuser adataival, amit az előbb adtál meg; ha minden jól megy, a Django admin dashboardra jutsz.
-
-![Django admin][2]
-
- [2]: images/django_admin3.png
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
 
-Nyisd meg a Posts részt, és kísérletezz vele egy kicsit. Hozz létre 5-6 blogposztot. Ne törődj a tartalommal - nyugodtan másolj be valami szöveget ebből a tutorialból, hogy időt spórolj :).
+![Django admin](images/django_admin3.png)
 
-Állíts be legalább két-három posztnak (de ne mindegyiknek!) egy publish date-et (megjelenési dátumot). Később jól fog jönni.
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
 
-![Django admin][3]
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
 
- [3]: images/edit_post3.png
+![Django admin](images/edit_post3.png)
 
-Ha szeretnél többet megtudni a Django adminról, a Django dokumentációban tudsz olvasni róla: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
 
-Itt az ideje, hogy kávézz vagy teázz egyet, vagy egyél valamit, hogy új erőre kapj. Elkészítetted az első Django modelledet - megérdemelsz egy kis lazítást!
\ No newline at end of file
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/hu/django_forms/README.md b/hu/django_forms/README.md
index 0d576d1d523..27a4504ae23 100644
--- a/hu/django_forms/README.md
+++ b/hu/django_forms/README.md
@@ -1,6 +1,6 @@
 # Django űrlapok
 
-Utolsó lépésként azt fogjuk megcsinálni, hogy a blogposztokat ne csak az admin oldalon hozhassuk létre és szerkeszthessük. A Django `admin` menő, de elég nehéz személyre szabni, és nem is túl szép. A `form`ok (űrlapok) segítségével viszont majdnem mindent meg tudunk csinálni a felületünkön, amit csak szeretnénk!
+Utolsó lépésként azt fogjuk megcsinálni, hogy a blogposztokat ne csak az admin oldalon hozhassuk létre és szerkeszthessük. A Django `admin` menő, de elég nehéz személyre szabni, és nem is túl szép. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
 
 A Django formokban az a jó, hogy ha akarjuk, teljesen az alapoktól is megírhatjuk őket, de `ModelForm`-ot is létrehozhatunk, ami az űrlap eredményét a modellbe menti el.
 
@@ -14,7 +14,9 @@ Hozz létre egy új fájlt ezzel a névvel a `blog` könyvtárban.
        └── forms.py
     
 
-Rendben, most nyisd meg, és írd bele a következő kódot:
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
 
 ```python
 from django import forms
@@ -26,31 +28,35 @@ class PostForm(forms.ModelForm):
     class Meta:
         model = Post
         fields = ('title', 'text',)
-```    
+```
 
 Először importálnunk kell a Django formjait (`from django import forms`), és persze a `Post` modellünket is (`from .models import Post`).
 
-Valószínűleg már sejted, hogy a `PostForm` az űrlapunk neve lesz. Meg kell mondanunk a Django-nak, hogy ez a form egy `ModelForm` (hogy egy kis Django varázslat kerüljön bele) - ezért a `forms.ModelForm` felelős.
+Valószínűleg már sejted, hogy a `PostForm` az űrlapunk neve lesz. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
 
 Aztán a `class Meta` következik, itt mondjuk meg a Django-nak, hogy melyik modellt kell használnia az űrlap elkészítéséhez (`model = Post`).
 
-Legvégül megadhatjuk, hogy melyik mezők kerüljenek bele az űrlapba. Mi csak a `title` (cím) és a `text` (szöveg) mezőket szeretnénk megjeleníteni - az `author` (szerző) az a felhasználó lesz, aki éppen be van jelentkezve (te magad!), és a `created_date`-et (létrehozás dátumát) automatikusan állítja be a Django, amikor elmented a posztot, emlékszel?
+Legvégül megadhatjuk, hogy melyik mezők kerüljenek bele az űrlapba. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
 
 Ennyi az egész! Most már csak az van hátra, hogy használjuk az űrlapot egy *view*-ban, és megjelenítsük egy template-ben.
 
-Tehát még egyszer: egy link az oldalhoz, egy URL, egy view és egy template.
+So once again we will create a link to the page, a URL, a view and a template.
 
 ## Link az oldalhoz, ahol az űrlap van
 
 Itt az ideje, hogy megnyisd a `blog/templates/blog/base.html` fájlt. Itt hozzáadunk egy linket a `page-header` nevű `div`hez:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
-```    
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
 
-Figyelem: az új nézetünket `post_new`-nak fogjuk hívni. A `"glyphicon glyphicon-plus"` class a bootstrap theme biztosítja, és egy pluszjelet fog megjeleníteni.
+After adding the line, your HTML file should now look like this:
 
-Miután hozzáadtad ezt a sort, így fog kinézni a html fájlod:
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
@@ -77,7 +83,7 @@ Miután hozzáadtad ezt a sort, így fog kinézni a html fájlod:
         </div>
     </body>
 </html>
-```    
+```
 
 Ha elmented, és frissíted a http://127.0.0.1:8000 oldalt, az ismerős `NoReverseMatch` hibát kell látnod, igaz?
 
@@ -85,57 +91,65 @@ Ha elmented, és frissíted a http://127.0.0.1:8000 oldalt, az ismerős `NoRever
 
 Nyisd meg a `blog/urls.py` fájlt, és add hozzá ezt a sort:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-    url(r'^post/new/$', views.post_new, name='post_new'),
-```    
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
 
 Így fog kinézni a teljes kód:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
     url(r'^post/new/$', views.post_new, name='post_new'),
 ]
-```    
+```
 
-Ha frissíted az oldalt, egy `AttributeError`t fogsz látni, hiszen még nincs implementálva a `post_new` nevű view. Készítsük el most rögtön.
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
 
 ## post_new nézet
 
 Nyisd meg a `blog/views.py` fájlt, és add hozzá a következő sorokat:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from .forms import PostForm
-```    
+```
 
-és a *view*t:
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
     form = PostForm()
     return render(request, 'blog/post_edit.html', {'form': form})
-```    
+```
 
-Ahhoz, hogy egy új `Post` űrlapot kapjunk, meg kell hívnunk a `PostForm()`-ot, és továbbadni a template-nek. Még visszatérünk erre a *view*-ra, de előbb gyorsan készítsük egy sablont a formnak.
+Ahhoz, hogy egy új `Post` űrlapot kapjunk, meg kell hívnunk a `PostForm()`-ot, és továbbadni a template-nek. We will go back to this *view*, but for now, let's quickly create a template for the form.
 
 ## Template
 
 Létre kell hoznunk egy `post_edit.html` nevű fájlt a `blog/templates/blog` könyvtárban. Ahhoz, hogy működjön az űrlapunk, szükségünk van pár dologra:
 
-*   meg kell jelenítenünk az űrlapot. Ezt egyszerűen megtehetjük a `{% raw %}{{ form.as_p }}{% endraw %}` kóddal.
-*   az előző sort be kell csomagolnunk egy HTML form tagbe: `<form method="POST">...</form>`
-*   szükségünk van egy `Save` (Mentés) gombra. Ezt egy HTML gombbal tudjuk létrehozni: `<button type="submit">Save</button>`
-*   és végül, a nyitó `<form ...>` tag után hozzá kell adnunk ezt: `{% raw %}{% csrf_token %}{% endraw %}`. Ez nagyon fontos, mert ettől lesznek biztonságosak az űrlapjaid! A Django panaszkodni fog, ha úgy próbálod elmenteni a formot, hogy kifelejtetted ezt a részt:
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* Az előző sort be kell csomagolnunk egy HTML form tagbe: `<form method="POST">...</form>`.
+* Szükségünk van egy `Save` (Mentés) gombra. Ezt egy HTML gombbal tudjuk létrehozni: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. Ez nagyon fontos, mert ettől lesznek biztonságosak az űrlapjaid! If you forget about this bit, Django will complain when you try to save the form:
 
-![CSFR tiltott oldal][1]
+![CSFR tiltott oldal](images/csrf2.png)
 
- [1]: images/csrf2.png
+OK, so let's see how the HTML in `post_edit.html` should look:
 
-Rendben, nézzük, hogy néz ki a HTML kód a `post_edit.html`-ben:
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -147,76 +161,88 @@ Rendben, nézzük, hogy néz ki a HTML kód a `post_edit.html`-ben:
         <button type="submit" class="save btn btn-default">Save</button>
     </form>
 {% endblock %}
-```    
+```
 
 Itt az ideje, hogy frissítsd az oldalt! Juhú! Ott van az űrlapod!
 
-![Új űrlap][2]
-
- [2]: images/new_form2.png
+![Új űrlap](images/new_form2.png)
 
-De várjunk csak egy percet! Ha begépelsz valamit a `title` és a `text` mezőbe, és megpróbálod elmenteni - mi történik?
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
 
-Semmi! Megint ugyanazon az oldalon vagyunk, és a szöveg eltűnt... és nem jött létre új bejegyzés. Mi romlott el?
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
 
 A válasz: semmi. Csak még egy kicsit dolgoznunk kell a *view*-n.
 
 ## Űrlap mentése
 
-Nyisd meg újra a `blog/views.py` fájlt. Most mindössze ennyi van a `post_new` nézetben:
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
     form = PostForm()
     return render(request, 'blog/post_edit.html', {'form': form})
-```    
+```
 
-Amikor beküldünk egy űrlapot, ugyanabba a nézetbe kerülünk vissza, de ilyenkor a `request`ben több adat van, mint korábban, egész pontosan a `request.POST`-ban (ennek az elnevezésnek nincs köze a blogban lévő "poszt"-hoz, ez annyit jelent, hogy éppen adatokat "posztolunk", vagyis küldünk). Emlékszel, hogy a HTML fájlban a `<form>` definíciójában szerepelt a `method="POST"` változó? Most az űrlap minden mezője bekerült a `request.POST`-ba. Semmiképp se nevezd át a `POST` (a `method` másik érvényes értéke a `GET` lenne, de most nincs idő elmagyarázni a különbséget).
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? Most az űrlap minden mezője bekerült a `request.POST`-ba. Semmiképp se nevezd át a `POST` (a `method` másik érvényes értéke a `GET` lenne, de most nincs idő elmagyarázni a különbséget).
 
-Tehát a *view*-ban két különböző esetet kell kezelnünk. Az első: amikor először kerülünk az oldalra, és egy üres űrlapot szeretnénk látni. A második: amikor visszajutunk a *view*-ba, azokkal az adatokkal, amiket épp az előbb gépeltünk be a formba. Ehhez egy feltételt kell hozzáadnunk (az `if`-et fogjuk használni).
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. Ehhez egy feltételt kell hozzáadnunk (az `if`-et fogjuk használni):
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 if request.method == "POST":
     [...]
 else:
     form = PostForm()
-```    
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
 
-Itt az ideje, hogy kitöltsük a `[...]` részeket. Ha a `method` `POST`, akkor egy `PostForm`-ot szeretnénk létrehozni az űrlapban beküldött adatokból, igaz? Ezt így tehetjük meg:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST)
-```    
+```
 
-Nem nehéz! A következő, hogy ellenőrizzük, helyes-e az űrlap (minden kötelező mező ki lett-e töltve, és nem készülünk-e helytelen adatokat elmenteni). Ezt csinálja a `form.is_valid()`.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
 
 Megnézzük, hogy érvényes-e a form, és ha igen, elmenthetjük!
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 if form.is_valid():
     post = form.save(commit=False)
     post.author = request.user
     post.published_date = timezone.now()
     post.save()
-```    
+```
+
+Itt lényegében két dolog történik: elmentjük az űrlapot a `form.save` paranccsal, és hozzáadunk egy szerzőt (mivel nem volt `author` mező a `PostForm`-ban, viszont ez a mező kötelező). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
 
-Itt lényegében két dolog történik: elmentjük az űrlapot a `form.save` paranccsal, és hozzáadunk egy szerzőt (mivel nem volt `author` mező a `PostForm`-ban, viszont ez a mező kötelező!). A `commit=False` azt jelenti, hogy még nem mentjük el a `Post` modellt - előbb még hozzá akarunk adni egy szerzőt. Az idő nagy részében a `commit=False` nélkül fogod használni a `form.save()`-et, de most szükségünk van erre a részre. A `post.save()` megőrzi a változtatásokat (szerző hozzáadása), és létrehoz egy új blogposztot!
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
 
-Végül tök jó lenne, ha egyből a frissen elkészült bejegyzés `post_detail` oldalára jutnánk nem? Ehhez egy újabb importra van szükségünk:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import redirect
-```   
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
 
-Ezt írd a fájlod elejére. És most megmondhatjuk a Django-nak: menj az új blogposzt `post_detail` oldalára.
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 return redirect('post_detail', pk=post.pk)
-```    
+```
+
+`post_detail` is the name of the view we want to go to. Emlékszel, hogy ez a *view* egy `pk` változót kér? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
 
-A `post_detail` a nézet neve, ahova most menni akarunk. Emlékszel, hogy ez a *view* egy `pk` változót kér? Ahhoz, hogy ezt megkapja, a `pk=post.pk` részt használjuk, ahol a `post` az új blogposztunkat jelenti!
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
 
-Rendben, elég sokat beszéltünk, de most már látni szeretnéd, hogy néz ki a teljes *view*, igaz?
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -231,43 +257,43 @@ def post_new(request):
     else:
         form = PostForm()
     return render(request, 'blog/post_edit.html', {'form': form})
-```    
+```
 
-Nézzük meg, hogy működik-e. Menj a http://127.0.0.1:8000/post/new/ oldalra, adj hozzá egy `title`-t és egy `text`-et, mentsd el... és voilà! Az új poszt bekerült az adatbázisba, és át lettél irányítva a `post_detail` oldalra!
+Nézzük meg, hogy működik-e. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
 
-Talán észrevetted, hogy a poszt elmentése előtt beállítjuk a közzététel dátumát. Később, a **Django Girls Tutorial: Extensions** részben egy *publish* gombot is készítünk.
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
 
 Ez nagyszerű!
 
-> Mivel nemrég használtuk a Django admin felületét, a rendszer most azt hiszi, hogy be vagyunk jelentkezve. Néhány esetben előfordul, hogy a rendszer kijelentkeztet minket (pl. ha bezárod a böngészőt vagy újraindítod az adatbázist). Ha azt veszed észre, hogy a hibaüzenetek arra utalnak, hogy nincs bejelentkezett felhasználó, menj az admin oldalra -http://127.0.0.1:8000/admin - és jelentkezz be újra. Ez ideiglenesen megoldja a problémát. Van egy hosszútávú megoldás is a **Házi feladat: tedd biztonságosabbá a weboldalad!** fejezetben a tutorial fő része után.
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. Ez ideiglenesen megoldja a problémát. Van egy hosszútávú megoldás is a **Házi feladat: tedd biztonságosabbá a weboldalad!** fejezetben a tutorial fő része után.
 
-![Bejelentkezési hiba][4]
-
- [4]: images/post_create_error.png
+![Bejelentkezési hiba](images/post_create_error.png)
 
 ## Form validáció
 
-Most megmutatjuk, mennyire menők a Django űrlapok. Egy blogposztnak kell, hogy legyen `title` és `text` mezője. A `Post` modellben nem jelentettük ki külön, hogy ezek a mezők nem kötelezőek (ellentétben a `published_date` mezővel), ezért a Django elvárja, hogy ki legyenek töltve.
-
-Próbáld meg elmenteni az űrlapot `title` vagy `text` nélkül. Találd ki, mi fog történni!
+Most megmutatjuk, mennyire menők a Django űrlapok. Egy blogposztnak kell, hogy legyen `title` és `text` mezője. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
 
-![Form validáció][3]
+Try to save the form without `title` and `text`. Guess what will happen!
 
- [3]: images/form_validation2.png
+![Form validáció](images/form_validation2.png)
 
-A Django gondoskodik az összes mező ellenőrzéséről. Hát nem fantasztikus?
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
 
 ## Űrlapok szerkesztése
 
-Most már tudod, hogyan tudsz új formot hozzáadni. De mi van, ha egy létező űrlapot szeretnél módosítani? Az eddigiekhez nagyon hasonlóan fog működni. Gyorsan készítsük néhány fontos dolgot (ha nem értesz valamit, kérdezd meg a coachodat, vagy nézz bele az előző fejezetekbe, hiszen ezeket a lépéseket már mind megcsináltad egyszer).
+Most már tudod, hogyan tudsz új formot hozzáadni. De mi van, ha egy létező űrlapot szeretnél módosítani? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
 
-Nyisd meg a `blog/templates/blog/post_detail.html` fájlt, és add hozzá ezt a sort:
+Open `blog/templates/blog/post_detail.html` and add the line
 
-```python
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
-```   
+```
 
-Így fog kinézni a template:
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -284,17 +310,21 @@ Nyisd meg a `blog/templates/blog/post_detail.html` fájlt, és add hozzá ezt a
         <p>{{ post.text|linebreaksbr }}</p>
     </div>
 {% endblock %}
-```    
+```
 
 A `blog/urls.py`-ban pedig erre a sorra lesz szükségünk:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-    url(r'^post/(?P<pk>[0-9]+)/edit/$', views.post_edit, name='post_edit'),
-```    
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
 
 Itt újrahasznosíthatjuk a `blog/templates/blog/post_edit.html` sablont, szóval már csak egy *view* van hátra.
 
-Nyisd meg a `blog/views.py`-t, és add hozzá ezt a fájl végén:
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_edit(request, pk):
@@ -310,87 +340,108 @@ def post_edit(request, pk):
     else:
         form = PostForm(instance=post)
     return render(request, 'blog/post_edit.html', {'form': form})
-```    
+```
+
+Majdnem pont úgy néz ki, mint a `post_new` view, nem igaz? De nem teljesen. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
 
-Majdnem pont úgy néz ki, mint a `post_new` view, nem igaz? De nem teljesen. Először is átadunk egy extra `pk` paramétert az url-ekből. Aztán a `Post` modellt a `get_object_or_404(Post, pk=pk)` sorral kapjuk meg, és végül, amikor létrehozzuk a formot, ezt a posztot adjunk át `instance`-ként, amikor elmentjük:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST, instance=post)
-```    
+```
+
+…and when we've just opened a form with this post to edit:
 
-és akkor is, amikor megnyitjuk az űrlapot, hogy szerkeszthessük a posztot:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(instance=post)
-```    
-
-Oké, most teszteljük le, hogy működik-e! Menj a `post_detail` oldalra. Kell lennie egy szerkesztés gombnak a jobb felső sarokban:
+```
 
-![Szerkesztés gomb][5]
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
 
- [5]: images/edit_button2.png
+![Szerkesztés gomb](images/edit_button2.png)
 
 Ha rákattintasz, megkapod az űrlapot a blogposzttal:
 
-![Űrlapok szerkesztése][6]
-
- [6]: images/edit_form2.png
+![Űrlapok szerkesztése](images/edit_form2.png)
 
-Változtasd meg a címet vagy a szöveget, és mentsd el!
+Feel free to change the title or the text and save the changes!
 
 Gratulálunk! Az alkalmazásod egyre és egyre jobb!
 
-Ha szeretnél többet tudni a Django formokról, olvass róluk a dokumentációban: https://docs.djangoproject.com/en/1.11/topics/forms/
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
 
 ## Biztonság
 
-Nagyon jó, hogy az új blogposztok írásához csak egy linkre kell kattintani! Viszont most bárki létre tud hozni egy új bejegyzést, aki meglátogatja az oldaladat, és valószínűleg ezt nem szeretnéd. Csináljuk meg, hogy a gombot csak te lásd, és mások ne.
+Nagyon jó, hogy az új blogposztok írásához csak egy linkre kell kattintani! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
 
 A `blog/templates/blog/base.html`-ben keresd meg a `page-header` `div`et, és az anchor taget, amit korábban írtál bele. Így néz ki:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
-```    
+```
 
-Írunk még egy `{% if %}` taget, ami arra lesz jó, hogy csak azoknak az usereknek mutassa a linket, akik be vannak jelentkezve az adminba. Most ez csak te vagy! Változtasd meg a `<a>` taget, hogy így nézzen ki:
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Változtasd meg a `<a>` taget, hogy így nézzen ki:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% if user.is_authenticated %}
     <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 {% endif %}
-```    
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. Ez nem akadályozza meg teljesen az új posztok létrehozását, de kezdésnek jó. A kiegészítő leckékben többet is tanulhatsz a biztonságról.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
 
-Az `{% if %}` miatt a link csak akkor küldődik át a böngészőbe, ha a felhasználó, aki lekérte az oldalt, be van jelentkezve. Ez nem akadályozza meg teljesen az új posztok létrehozását, de kezdésnek jó. A kiegészítő leckékben többet is tanulhatsz a biztonságról.
+Open `blog/templates/blog/post_detail.html` and find this line:
 
-Mivel valószínűleg be vagy jelentkezve, semmi változást nem fogsz látni, ha frissítesz. Viszont ha megnyitod az oldalt egy másik böngészőben, vagy egy inkognitóablakban, látni fogod, hogy a link nincs ott!
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
 
 ## Még egy dolog: itt az ideje egy újabb deploynak!
 
 Nézzük meg, hogy működik-e ez az egész a PythonAnywhere-en. Itt az ideje egy újabb deploynak!
 
-*   Először is commitold az új kódodat, és pushold GitHubra
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added views to create/edit blog post inside the site."
-$ git push
-```    
+* Először is commitold az új kódodat, és pushold GitHubra:
 
-*   Aztán írd be ezt a [PythonAnywhere Bash konzol][7]ba:
+{% filename %}command-line{% endfilename %}
 
- [7]: https://www.pythonanywhere.com/consoles/
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Aztán írd be ezt a [PythonAnywhere Bash konzol](https://www.pythonanywhere.com/consoles/)ba:
+
+{% filename %}command-line{% endfilename %}
 
     $ cd my-first-blog
-    $ source myvenv/bin/activate
-    (myvenv)$ git pull
-    [...]
-    (myvenv)$ python manage.py collectstatic
+    $ git pull
     [...]
     
 
-*   Végül menj a [Web tab][8]-ra, és nyomj **Reload**ot.
-
- [8]: https://www.pythonanywhere.com/web_app_setup/
+* Végül menj a [Web tab](https://www.pythonanywhere.com/web_app_setup/)-ra, és nyomj **Reload**ot.
 
-Ennyi az egész. Gratulálunk :)
+Ennyi az egész. Gratulálunk :)
\ No newline at end of file
diff --git a/hu/django_installation/README.md b/hu/django_installation/README.md
index e1f8f731196..de466e3c456 100644
--- a/hu/django_installation/README.md
+++ b/hu/django_installation/README.md
@@ -1,5 +1,7 @@
 # Django telepítés
 
-> **Megjegyzés** Ha elvégezted a legelső, Installáció című fejezetet, már túlvagy ezen - ugorj a következő fejezetre!
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
 
-{% include "/django_installation/instructions.md" %}
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/hu/django_installation/instructions.md b/hu/django_installation/instructions.md
index 508801c78bc..1bd11786329 100644
--- a/hu/django_installation/instructions.md
+++ b/hu/django_installation/instructions.md
@@ -1,6 +1,6 @@
-> Ennek a fejezetnek egy része a Geek Girls Carrots (https://github.com/ggcarrots/django-carrots) tutorialjain alapul.
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 > 
-> A fejezet részben a [django-marcador tutorial](http://django-marcador.keimlink.de/)-on alapszik, ami a Creative Commons Attribution-ShareAlike 4.0 International License jogvédelem alatt áll. A django-marcador tutorial jogvédelem alatt áll, Markus Zapke-Gründemann et al által.
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. A django-marcador tutorial jogait, Markus Zapke-Gründemann és társai birtokolják.
 
 ## Virtuális környezet
 
@@ -8,82 +8,93 @@ Mielőtt feltelepítjük a Django-t, egy rettentő hasznos eszközt fogunk insta
 
 Tehát először is hozzunk létre egy **virtuális környezetet** (virtual environment), amit *virtualenv*-nek is hívunk. A virtualenv projektenként különíti el a Python/Django környezetet. Ez azt jelenti, hogy ha megváltoztatsz valamit egy weboldalon, az nem lesz hatással a többi weboldalra, amit párhuzamosan fejlesztesz. Jó, igaz?
 
-Csak annyit kell tenned, hogy kiválasztasz egy könyvtárat, ahova a `virtualenv`et szeretnéd telepíteni, például a home könyvtárat. Windowson ez így nézhet ki: `C:\Users\Name` (ahol a `Name` a felhasználód neve).
+Csak annyit kell tenned, hogy kiválasztasz egy könyvtárat, ahova a `virtualenv`et szeretnéd telepíteni, például a home könyvtárat. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
 
-> __Megjegyzés__ Windows-on gondoskodj arról, hogy ez a könyvtár nem tartalmaz ékezetes vagy speciális karaktereket; ha a van ékezetes karakter a felhasználónevedben, használj egy másik könyvtárt, például `C:\djangogirls`.
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
 
 Ehhez a tutorialhoz egy új, `djangogirls` nevű mappát fogunk használni a home könyvtáradon belül:
 
-    mkdir djangogirls
-    cd djangogirls
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
     
 
 Most pedig létrehozunk egy `myvenv` nevű virtuális környezetet. A kód általánosan így néz ki:
 
-    python3 -m venv myvenv
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
     
 
-<!--sec data-title="Windows" data-id="virtualenv_installation_windows"
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
 data-collapse=true ces-->
 
-Ahhoz, hogy létrehozz egy új `virtualenv`-et, meg kell nyitni a konzolt (pár fejezettel ezelőtt tanultál róla - emlékszel?) és a ezt a parancsot kell lefuttatnod: `C:\Python35\python -m venv myvenv`. Ez fog történni:
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
 
-    C:\Users\Name\djangogirls> C:\Python35\python -m venv myvenv
+    C:\Users\Name\djangogirls> python -m venv myvenv
     
 
-itt a `C:\Python35\python` azt a könyvtárat jelenti, ahova korábban a Pythont telepítetted, és a `myvenv` a `virtualenv`-ed neve. Bármi más nevet is használhatsz, de maradj a kisbetűs szavaknál, és ne használj szóközt, ékezeteket, vagy más speciális karaktereket. Jó ötlet rövid nevet adni - sokszor be kell majd gépelned!
+Where `myvenv` is the name of your `virtualenv`. Bármi más nevet is használhatsz, de maradj a kisbetűs szavaknál, és ne használj szóközt, ékezeteket, vagy más speciális karaktereket. It is also good idea to keep the name short – you'll be referencing it a lot!
 
 <!--endsec-->
 
-<!--sec data-title="Linux és OS X" data-id="virtualenv_installation_linuxosx"
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
 data-collapse=true ces-->
 
-A `virtualenv` létrehozása Linux és OS X környezetben is csak annyiból áll, hogy a `python3 -m venv myvenv` parancsot futtatod. Így fog kinézni:
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
 
-    ~/djangogirls$ python3 -m venv myvenv
-    
-
-A `myvenv` a`virtualenv`-ed neve. Más nevet is használhatsz, de maradj a kisbetűs szavaknál, és ne használj szóközt, ékezeteket, vagy más speciális karaktereket. Jó ötlet rövid nevet adni - sokszor be kell majd gépelned!
+{% filename %}command-line{% endfilename %}
 
-> **MEGJEGYZÉS:** Debian/Ubuntu némelyik verziójánál az alábbi hibaüzenetet kaphatod:
+    $ python3 -m venv myvenv
+    
 
->{% filename %}parancssor{% endfilename %}
->```
->The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
->    apt-get install python3-venv
->You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
->```
->
-> Ebben az esetben a fenti leírást követve telepítsd a `python3-venv` csomagot:
->{% filename %}parancssor{% endfilename %}
->```
->$ sudo apt-get install python3-venv
->```
+A `myvenv` a`virtualenv`-ed neve. Más nevet is használhatsz, de maradj a kisbetűs szavaknál, és ne használj szóközt, ékezeteket, vagy más speciális karaktereket. It is also a good idea to keep the name short as you'll be referencing it a lot!
 
-> **MEGJEGYZÉS:** A virtuális környezetet létrehozó parancs Ubuntu 14.04 alatt ezt a hibát adja:
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
 > 
 >     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
 >     
 > 
 > Hogy ezt elkerüld, használd a `virtualenv` parancsot.
 > 
->     ~/djangogirls$ sudo apt-get install python-virtualenv
->     ~/djangogirls$ virtualenv --python=python3.6 myvenv
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
 >     
-
-> **MEGJEGYZÉS:** Ha az alábbi hibaüzenetet kapod:
-
->{% filename %}parancssor{% endfilename %}
->```
->E: Unable to locate package python3-venv
->```
-
-> Akkor az alábbit futtasd:
->
->{% filename %}parancssor{% endfilename %}
->```
->sudo apt install python3.6-venv
->```
 
 <!--endsec-->
 
@@ -91,51 +102,49 @@ A `myvenv` a`virtualenv`-ed neve. Más nevet is használhatsz, de maradj a kisbe
 
 A fenti parancs létrehozott egy `myvenv` nevű (vagy bármi más név, amit választottál) könyvtárat, ami a virtuális környezetünket tartalmazza (ez tulajdonképpen csak egy csomó könyvtár és fájl).
 
-<!--sec data-title="Windows" data-id="virtualenv_windows"
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
 data-collapse=true ces-->
 
 Így indíthatod el a virtuális környezetet:
 
+{% filename %}command-line{% endfilename %}
+
     C:\Users\Name\djangogirls> myvenv\Scripts\activate
     
-> __MEGJEGYZÉS:__ Windows 10-en lehet hogy egy hibaüzenetet kapsz Windows PowerShell-ben, amely szerint `execution of scripts is disabled on this system` (scriptek futtatása le van tiltva ezen a rendszeren). Ebben az esetben nyiss egy másik Windows PowerShell-t a "Run as Administrator" (adminisztrátorként futtatás) opcióval.  Majd próbáld meg az alábbi parancsot beírni mielőtt elindítod a virtuális környezetedet:
->
->{% filename %}parancssor{% endfilename %}
->```
->C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
->     Execution Policy Change
->     The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
->```
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
 
 <!--endsec-->
 
-<!--sec data-title="Linux and OS X" data-id="virtualenv_linuxosx"
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
 data-collapse=true ces-->
 
 Így indíthatod el a virtuális környezetet:
 
-    ~/djangogirls$ source myvenv/bin/activate
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
     
 
 Fontos, hogy `myvenv` helyett azt a neved írd be, amit a `virtualenv`-ednek választottál!
 
 > **MEGJEGYZÉS:** néha a `source` nem elérhető. Ebben az esetben próbáld meg ezt:
 > 
->     ~/djangogirls$ . myvenv/bin/activate
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
 >     
 
-Onnan tudod, hogy a `virtualenv` elindult, hogy a konzolodban a prompt így néz ki:
-
-    (myvenv) C:\Users\Name\djangogirls>
-    
-
-vagy:
-
-    (myvenv) ~/djangogirls$
-    
 <!--endsec-->
 
-Figyeld meg, hogy megjelent a `(myvenv)` előtag!
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
 
 Ha virtuális környezetben dolgozol, a `python` parancs mindig a megfelelő Python verzióra fog mutatni, tehát nyugodtan használhatod a `python`-t `python3` helyett.
 
@@ -143,50 +152,50 @@ Oké, most már minden feltétel teljesült. Végre installálhatjuk a Django-t!
 
 ## A Django telepítése
 
-Most, hogy elindítottad a `virtualenv`-et, telepiteni tudod a Django-t.
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
 
-Mielőtt ezt megtennénk, meg kell győződnünk arról, hogy a `pip` legfrissebb verzióját használjuk, amelynek segítségével fogjuk tudni telepíteni a Django-t:
+{% filename %}command-line{% endfilename %}
 
-{% filename %}parancssor{% endfilename %}
-```
-(myvenv) ~$ pip install --upgrade pip
-```
+    (myvenv) ~$ pip install --upgrade pip
+    
 
-Ezután futtasd ezt a parancsot a konzolban: `pip install django~=1.11` (figyelj oda, hogy egy tilde karaktert használunk, amelyet egy egyenlőségjel követ: `~=`).
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
 
-{% filename %}parancssor{% endfilename %}
-```
-(myvenv) ~$ pip install django~=1.11.0
-Collecting django~=1.11.0
-  Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
-Installing collected packages: django
-Successfully installed django-1.11.3
-```
+{% filename %}command-line{% endfilename %}
 
-<!--sec data-title="Windowson" data-id="django_err_windows"
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
 data-collapse=true ces-->
 
-> Ha hibát kapsz, amikor a pip-et hívod Windowson, nézd meg, hogy tartalmaz-e a projekted elérési útvonala szóközt, ékezetet, vagy speciális karaktereket (pl. `C:\Users\User Name\djangogirls`). Ha igen, használj helyette egy olyan könyvtárat, ahol nincsenek szóközök, ékezetek vagy speciális karakterek (javaslat: `C:\djangogirls`). Hozd létre az új könyvtárat, és abban egy új virtualenvet, majd töröld ki a régit és az új helyen próbáld futtatni az előző parancsot. (A virtualenv könyvtár áthelyezése nem fog működni, mert a virtualenv abszolút elérési utakat használ.)
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
 
 <!--endsec-->
 
-<!--sec data-title="Windows 8 és Windows 10" data-id="django_err_windows8and10"
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
 data-collapse=true ces-->
 
-> A parancssorod "megfagyhat" miután telepíteni próbálod a Django-t. Ha ez történik, az előző parancs helyett próbáld meg ezt:
->
->{% filename %}parancssor{% endfilename %}
->```
->C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
->```
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
 
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="django_err_linux"
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
 data-collapse=true ces-->
 
 > Ha Ubuntu 12.04 alatt hibát kapsz, amikor a pip-et próbálod hívni, futtasd a `python -m pip install -U --force-reinstall pip` parancsot, hogy megjavítsd a virtualenv-ben a pip feltelepített verzióját.
 
 <!--endsec-->
 
-Ennyi! Most pedig (végre) létrehozhatod a Django alkalmazásodat!
+Ennyi! Most pedig (végre) létrehozhatod a Django alkalmazásodat!
\ No newline at end of file
diff --git a/hu/django_models/README.md b/hu/django_models/README.md
index 5fc922e2601..50e37ce5413 100644
--- a/hu/django_models/README.md
+++ b/hu/django_models/README.md
@@ -4,13 +4,13 @@ Most valami olyasmire van szükségünk, ami eltárolja az összes blogbejegyzé
 
 ## Objektumok
 
-Létezik egy `objektumorientált programozás` nevű fogalom a programozáson belül. Ennek az az alapötlete, hogy ahelyett, hogy mindent utasítások unalmas sorozataként írnánk le, modellezhetjük is a dolgokat, és definiálhatjuk, hogyan lépnek kapcsolatba egymással.
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
 
 Tehát mi az az objektum? Tulajdonságok és tevékenységek gyűjteménye. Furán hangozhat, de mindjárt mutatunk egy példát.
 
-Ha egy macskát szeretnék modellezni, létrehozunk egy `Cat` (macska) objektumot, aminek van néhány tulajdonsága: `color` (szín), `age` (életkor), `mood` (kedv -például jó, rossz, álmos ;)), és `owner` (tulajdonos - aki egy `Person` (személy) objektum, és talán, ha kóbor macskáról van szó, ez a tulajdonság üres).
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
 
-Aztán a `Cat`-hez tartozik néhány tevékenység: `purr` (dorombolás), `scratch` (karmolás), vagy `feed` (evés - ahol a macskának adunk egy kis macskaeledelt, vagyis `CatFood`-ot, ami egy külön objektum, saját tulajdonságokkal, mint például `taste` (íz)).
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
 
     Cat
     --------
@@ -23,13 +23,18 @@ Aztán a `Cat`-hez tartozik néhány tevékenység: `purr` (dorombolás), `scrat
     feed(cat_food)
     
 
-Tehát az egésznek az az alapötlete, hogy a valós dolgokat kódban tulajdonságokkal (vagyis `object property`-kkel) és tevékenységekkel (vagyis `method`-okkal) írjuk le.
+    CatFood
+    --------
+    taste
+    
+
+Tehát az egésznek az az alapötlete, hogy a valós dolgokat kódban tulajdonságokkal (vagyis `object property`-kkel) és tevékenységekkel (vagyis `method`-okkal) írjuk le).
 
 Hogyan modellezzük a blogposztokat? Egy blogot szeretnénk fejleszteni, ugye?
 
 Erre a kérdésre keressük a választ: Mi egy blogposzt? Milyen tulajdonságai vannak?
 
-Nos, a bejegyzésünknek biztos van szövege, és címe, igaz? Azt is jó lenne tudni, hogy ki írta - vagyis szükségünk van egy szerzőre is. Végül tudni szeretnénk, mikor lett megírva és közzétéve a poszt.
+Nos, a bejegyzésünknek biztos van szövege, és címe, igaz? It would be also nice to know who wrote it – so we need an author. Végül tudni szeretnénk, mikor lett megírva és publikálva a poszt.
 
     Post
     --------
@@ -40,9 +45,9 @@ Nos, a bejegyzésünknek biztos van szövege, és címe, igaz? Azt is jó lenne
     published_date
     
 
-Milyen dolgokat lehet csinálni egy blogbejegyzéssel? Jó lenne, ha lenne valamiféle `method`, ami közzéteszi a posztot, nem?
+Milyen dolgokat lehet csinálni egy blogbejegyzéssel? Jó lenne, ha lenne valamiféle `method`, ami publikálja a posztot, nem?
 
-Tehát szükségünk van egy `publish` methodra.
+Tehát szükségünk van egy `method` methodra.
 
 Most, hogy tudjuk, mit szeretnénk elérni, kezdjük el modellezni Django-ban!
 
@@ -50,7 +55,7 @@ Most, hogy tudjuk, mit szeretnénk elérni, kezdjük el modellezni Django-ban!
 
 Most, hogy tudjuk, mik az objektumok, már el tudjuk készíteni a blogposzt Django modelljét.
 
-A Django-ban a modellek speciális objektumok - az `adatbázisban` vannak elmentve. Az adatbázis tulajdonképpen adatok gyűjteménye. Ez az a hely, ahol adatokat tárolhatsz a felhasználókról, a blogposztokról, stb. Mi egy SQLite adatbázist fogunk használni az adataink tárolásához. Ez az alapértelmezett Django adatbázis adapter -- ez egyelőre elég is lesz nekünk.
+A model in Django is a special kind of object – it is saved in the `database`. Az adatbázis tulajdonképpen adatok gyűjteménye. Ez az a hely, ahol adatokat tárolhatsz a felhasználókról, a blogposztokról, stb. Mi egy SQLite adatbázist fogunk használni az adataink tárolásához. This is the default Django database adapter – it'll be enough for us right now.
 
 Az adatbázisban lévő modellt úgy képzeld el, mint egy táblázatot (pl. az Excelben), ahol oszlopok (mezők) és sorok (adatok) vannak.
 
@@ -58,29 +63,40 @@ Az adatbázisban lévő modellt úgy képzeld el, mint egy táblázatot (pl. az
 
 Hogy minden szép rendben maradjon, most a projekten belül egy külön alkalmazást hozunk létre. Jó, ha már az elejétől fogva rendezetten tartjuk a dolgokat. Ahhoz, hogy létrehozzuk az alkalmazást, ezt a parancsot kell futtatnunk a parancssorban (a `djangogirls` könyvtárban, ahol a `manage.py` fájl van):
 
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py startapp blog
     
 
-Azt fogod látni, hogy egy új `blog` könyvtár keletkezett, és már most van benne néhány fájl. Így kell kinézniük a könyvtáraknak és fájloknak a projekten belül:
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
 
     djangogirls
-    ├── mysite
-    |       __init__.py
-    |       settings.py
-    |       urls.py
-    |       wsgi.py
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
     ├── manage.py
-    └── blog
-        ├── migrations
-        |       __init__.py
+    └── mysite
         ├── __init__.py
-        ├── admin.py
-        ├── models.py
-        ├── tests.py
-        └── views.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
     
 
-Miután létrejött az alkalmazás, meg kell mondanunk a Django-nak, hogy használja is azt. A `mysite/settings.py` tehetjük meg. Keresd meg az `INSTALLED_APPS` részt, és adj hozzá egy sort a `]` fölött, amiben ez áll: `'blog'`. Így kell kinéznie ennek a résznek:
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 INSTALLED_APPS = [
@@ -96,9 +112,11 @@ INSTALLED_APPS = [
 
 ### Hozzuk létre a blogposzt modelljét
 
-A `Model` nevű objektumokat a `blog/models.py` fájlban definiáljuk - tehát itt fogjuk definiálni a blogposztunkat is.
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
 
-Nyisd meg a `blog/models.py`-t, törölj ki mindent, és ezt a kódot írd bele:
+{% filename %}blog/models.py{% endfilename %}
 
 ```python
 from django.db import models
@@ -106,7 +124,7 @@ from django.utils import timezone
 
 
 class Post(models.Model):
-    author = models.ForeignKey('auth.User')
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
     created_date = models.DateTimeField(
@@ -122,47 +140,53 @@ class Post(models.Model):
         return self.title
 ```
 
-> Jól figyelj, hogy mindenképp két underscore (alulvonás) karaktert (`_`) használj a `str` mindkét oldalán. Ez a jelölés gyakran előfordul a Pythonban, és néha "dunder"-nek hívjuk (a "double underscore" - dupla alulvonás rövidítése).
+> Double-check that you use two underscore characters (`_`) on each side of `str`. Ez a jelölés gyakran előfordul a Pythonban, és néha "dunder"-nek hívjuk (a "double underscore" - dupla alulvonás rövidítése).
 
-Ijesztőnek tűnik? Ne aggódj, mindjárt elmagyarázzuk, hogy mit jelentenek ezek a sorok.
+It looks scary, right? But don't worry – we will explain what these lines mean!
 
-Azok a sorok, amik úgy kezdődnek, hogy `from` vagy `import`, más fájlokban lévő dolgokat adnak hozzá a fájlunkhoz. Ahelyett, hogy minden fájlba átmásolnánk ugyanazokat a dolgokat, beemelhetünk néhány dolgot a `from ... import ...` segítségével..
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
 
-`class Post(models.Model):` - ez a sor definiálja a modellünket (ami egy `objektum`).
+`class Post(models.Model):` – this line defines our model (it is an `object`).
 
-*   a `class` egy speciális kulcsszó, ami azt mutatja meg, hogy éppen egy objektumot definiálunk.
-*   a `Post` a modellünk neve. Más nevet is adhatnál neki (de kerüld el a speciális karaktereket - pl ékezetes karakterek - és a szóközt). Az osztályok (classok) nevét mindig nagybetűvel kezdjük.
-*   a `models.Model` azt jelenti, hogy a Post egy Django Model, így a Django tudni fogja, hogy el kell menteni az adatbázisba.
+- a `class` egy speciális kulcsszó, ami azt mutatja meg, hogy éppen egy objektumot definiálunk.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- a `models.Model` azt jelenti, hogy a Post egy Django Model, így a Django tudni fogja, hogy el kell menteni az adatbázisba.
 
-Most pedig azokat a tulajdonságokat definiáljuk, amikről korábban beszéltünk:`title` (cím), `text` (szöveg), `created_date` (létrehozás dátuma), `published_date` (közzététel dátuma) és `author` (szerző). Ahhoz, hogy ezt megtehessük, mindegyik mezőnek meg kell határoznunk a típusát (Szöveg lesz benne? Egy szám? Dátum? Egy másik objektumhoz fog kapcsolni, például egy User-hez (felhasználó)?).
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
 
-*   `models.CharField` - így definiálsz olyan szövegmezőt, ami meghatározott számú karaktert tartalmazhat.
-*   `models.TextField` - ez hosszú szövegekhez van, korlátozás nélkül. Pont jó egy blogbejegyzéshez, igaz?
-*   `models.DateTimeField` - ez dátumot és időt tartalmaz.
-*   `models.ForeignKey` - ez egy másik modellel való kapcsolatot jelent.
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
 
-Most nem magyarázzuk el nagyon részletesen a kódot, mert túl sok idő lenne. Ha szeretnél többet tudni a Model mezőkről, és hogy milyen más dolgokat lehet definiálni bennünk, olvashatsz róla a Django dokumentációban (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
 
-És mi a helyzet a `def publish(self):` résszel? Ez pontosan az a `publish` (közzététel) method, amiről korábban beszéltünk. A `def` azt jelenti, hogy ez egy függvény (function) / method, és a `publish` ennek a methodnak a neve. Ha szeretnéd, megváltoztathatod a metódus nevét. Az a szabály, hogy csak kisbetűket használunk, és szóköz helyett underscore-t (alulvonás). Például egy olyan method neve, ami az átlagárat számolja ki, ez lehetne: `calculate_average_price`.
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
 
-A methodok gyakran `return`-ölnek (visszaadnak) valamit. Erre van is egy példa a `__str__` methodban. Ebben az esetben amikor meghívjuk a `__str__()`-t, egy szöveget kapunk vissza (**string**), ami a Post címe.
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
 
-Vedd észre azt is, hogy mind `def publish(self):` mind `def __str__(self):` indentálva van a class-on bellül. Python számára fontosak a szóközök, ezért a method-okat indentálni kell az osztályokon bellül. Ha ez elmarad, akkor a method nem az adott osztályhoz fog tartozni, és furcsán fog viselkedni a program.
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
 
-Ha valami még nem teljesen világos a modellekkel kapcsolatban, nyugodtan kérdezd meg a coachodat! Tudjuk, hogy bonyolult, főleg, ha egyszerre tanulsz az objektumokról és a függvényekről. De reméljük, már sokkal kevésbé tűnik varázslatnak az egész!
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
 
 ### Készíts táblákat a modelleknek az adatbázisodban
 
-Az utolsó lépés, hogy hozzáadjuk az új modellünket az adatbázishoz. Először valahogy tudatnunk kell a Django-val, hogy változtattunk a modellünkön (vagyis most alkottuk meg!). Gépeld be, hogy `python manage.py makemigrations blog`. Ez fog történni:
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py makemigrations blog
     Migrations for 'blog':
-      0001_initial.py:
+      blog/migrations/0001_initial.py:
+    
       - Create model Post
     
-**Megjegyzés** Ne felejtsd el elmenteni a módosított file-okat. Különben a számítógéped az előző változatot futtatja le, amely váratlan hibaüzeneteket eredményezhet.
 
-A Django létrehozott nekünk egy migrációs fájlt, amit most futtatni fogunk az adatbázison. Írd be, hogy `python manage.py migrate blog`, és ezt az outputot kell kapnod:
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py migrate blog
     Operations to perform:
@@ -172,4 +196,4 @@ A Django létrehozott nekünk egy migrációs fájlt, amit most futtatni fogunk
       Applying blog.0001_initial... OK
     
 
-Hurrá! Bekerült az adatbázisba a Post modellünk! Jó lenne látni is, nem igaz? A következő fejezetben kiderül, hogy néz ki!
\ No newline at end of file
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/hu/django_orm/README.md b/hu/django_orm/README.md
index 6d7172ac15f..70494e3af8d 100644
--- a/hu/django_orm/README.md
+++ b/hu/django_orm/README.md
@@ -4,7 +4,7 @@ Ebben a fejezetben megtanulod, hogy hogyan kapcsolódik az adatbázishoz a Djang
 
 ## Mi a QuerySet?
 
-A QuerySet lényegében egy lista, amely egy bizonyos Model objektumait tartalmazza. A QuerySetek segítségével tudsz adatot kinyerni az adatbázisból, szűrheted és sorba rendezheted.
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
 
 A legkönnyebb, ha példákon keresztül tanulod meg. Próbáljuk csak ki!
 
@@ -12,136 +12,192 @@ A legkönnyebb, ha példákon keresztül tanulod meg. Próbáljuk csak ki!
 
 Nyisd meg a lokális konzolodat (nem a PythonAnywhere-ét), és gépeld be ezt a parancsot:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py shell
     
 
 Ezt fogod látni:
 
-    (InteractiveConsole)
-    >>>
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
 
-Most a Django interaktív konzoljában vagy. Olyasmi, mint a Python prompt, csak egy kis extra Django varázslattal :) Természetesen itt is használhatod az összes Python parancsot.
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
 
 ### Az összes objektum
 
 Először is próbáljuk meg az összes posztot megjeleníteni. A következő paranccsal tudod megtenni:
 
-    >>> Post.objects.all()
-    Traceback (most recent call last):
-          File "<console>", line 1, in <module>
-    NameError: name 'Post' is not defined
-    
+{% filename %}command-line{% endfilename %}
 
-Hoppá, egy hiba! Azt mondja, hogy nincs olyan, hogy Post. Igaza van -- elfelejtettük importálni!
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
 
-    >>> from blog.models import Post
-    
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
 
-Ez egyszerű: importáljuk a `Post` modellt a `blog.models`-ből. Próbáljuk meg újra megjeleníteni a Post-okat:
+{% filename %}command-line{% endfilename %}
 
-    >>> Post.objects.all()
-    <QuerySet [<Post: my post title>, <Post: another post title>]>
-    
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
 
-Egy lista a posztokból, amiket korábban megírtál! Ezeket még a Django admin felületén hoztad létre. Viszont ugyanezt meg tudod tenni a Python segítségével is. De vajon hogyan?
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
 
 ### Objektum létrehozása
 
 Így hozhatsz létre egy új Post objektumot az adatbázisodban:
 
-    >>> Post.objects.create(author=me, title='Sample title', text='Test')
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
 
-De az egyik összetevő hiányzik: a `me`. Az `User` (felhasználó) modell egy instance-át kell megadnunk author-ként (szerző). Hogy tudjuk ezt megcsinálni?
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
 
 Először importáljuk az User modellt:
 
-    >>> from django.contrib.auth.models import User
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
 
 Milyen felhasználók vannak az adatbázisban? Próbáld meg ezt:
 
-    >>> User.objects.all()
-    <QuerySet [<User: ola>]>
-    
+{% filename %}command-line{% endfilename %}
 
-Ez a superuser, amit korábban hoztál létre! Most vegyük ennek a felhasználónak egy instance-ét:
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
 
-    me = User.objects.get(username='ola')
-    
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
 
-Ahogy láthatod, most hozzájutottunk (`get`) egy `User`-hez, `username`-mel (felhasználónév), ami 'ola'-val egyenlő. Szuper! Természetesen itt a saját felhasználónevedet kell beírnod.
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
 
 Most pedig végre létrehozhatjuk a posztot:
 
-    >>> Post.objects.create(author=me, title='Sample title', text='Test')
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
 
 Hurrá! Meg akarod nézni, hogy működött-e?
 
-    >>> Post.objects.all()
-    <QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
 
 Ott is van, egy újabb poszt a listában!
 
 ### Hozz létre még néhány posztot
 
-A móka kedvéért hozz létre még 2-3 posztot, hogy lásd, hogyan működik. Ha ez megvan, továbbléphetsz a következő részre.
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
 
 ### Objektumok filterezése
 
-A QuerySet-ek egyik nagy előnye, hogy filterezhetjük (szűrhetjük) őket. Mondjuk le szeretnénk kérdezni az összes posztot, amit az ola User írt. Itt a `filter`-t fogjuk használni az `all` helyett a `Post.objects.all()`-ban. A zárójelek között megadhatjuk, hogy milyen feltétel(ek)nek kell teljesülnie ahhoz, hogy egy blogposzt bekerülhessen a querysetünkbe. Ebben az esetben az `author` (szerző) egyenlő `me`-vel (én). Ezt a Django-ban így írjuk le: `author=me`. Most így néz ki a kódunk:
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. Itt a `filter`-t fogjuk használni az `all` helyett a `Post.objects.all()`-ban. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Most így néz ki a kódunk:
 
-    >>> Post.objects.filter(author=me)
-    <QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+{% filename %}command-line{% endfilename %}
 
-    
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
 
-És ha össze szeretnénk gyűjteni minden olyan posztot, aminek a `title` (cím) mezőjében szerepel a 'title' szó?
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
 
-    >>> Post.objects.filter(title__contains='title')
-    <QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
-    
+{% filename %}command-line{% endfilename %}
 
-> **Note** A `title` és a `contains` (vagyis 'tartalmaz') között két underscore karakter (`_`) van. A Django ORM ezt a szintaxist használja arra, hogy elkülönítse a mezők neveit ("title") a műveletektől vagy filterektől ("contains"). Ha csak egy underscore-t használt, egy ilyen hibát fogsz kapni: "FieldError: Cannot resolve keyword title_contains" (kb "Mezőhiba: a title_contains kulcsszó nem található").
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
 
-Megkaphatod az összes közzétett poszt listáját is. Ezt úgy tudod megtenni, hogy az összes poszt között szűrsz azokra, amiknél be van állítva múltbéli `published_date` (vagyis közzététel dátuma):
+> **Note** A `title` és a `contains` (vagyis 'tartalmaz') között két underscore karakter (`_`) van. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
 
-    >>> from django.utils import timezone
-    >>> Post.objects.filter(published_date__lte=timezone.now())
-    []
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
 
-Sajnos az a poszt, amit a Python konzolban hoztunk létre, még nem lett közzétéve. De ezen könnyen változtathatunk! Először is, hozzá kell férnünk a poszt instance-éhez, amit közzé szeretnénk tenni:
+{% filename %}command-line{% endfilename %}
 
-    >>> post = Post.objects.get(title="Sample title")
-    
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
 
-Aztán közzétesszük a `publish` methoddal!
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
 
-    >>> post.publish()
-    
+{% filename %}command-line{% endfilename %}
 
-Most próbáld meg újra lekérdezni a közzétett posztok listáját (nyomd meg háromszor a felfelé nyilat, és nyomj `enter`t):
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
 
-    >>> Post.objects.filter(published_date__lte=timezone.now())
-    <QuerySet [<Post: Sample title>]>
-    
+Aztán közzétesszük a `publish` methoddal:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
 
 ### Objektumok sorbarendezése
 
 A QuerySetek segítségével sorba is rendezheted az objektumok listáját. Először próbáljuk meg a létrehozás dátuma (`created_date` mező) alapján rendezni őket:
 
-    >>> Post.objects.order_by('created_date')
-    <QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
 
 Meg is fordíthatjuk a sorrendet, ha az elejére egy `-` jelet teszünk:
 
-    >>> Post.objects.order_by('-created_date')
-    <QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
 
 ### QuerySetek összefűzése
 
@@ -154,5 +210,9 @@ Ez egy nagyon hatékony módszer, és a segítségével bonyolult query-ket írh
 
 Remek! Most már készen állsz a következő részre! Hogy kilépj a shellből, gépeld be ezt:
 
-    >>> exit()
-    $
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/hu/django_start_project/README.md b/hu/django_start_project/README.md
index 7db4a5f2a58..6078ad8f2f7 100644
--- a/hu/django_start_project/README.md
+++ b/hu/django_start_project/README.md
@@ -1,32 +1,46 @@
 # Az első Django projekted!
 
-> Ez a fejezet részben a Geek Girls Carrots (https://github.com/ggcarrots/django-carrots) tutorial-jain alapszik.
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 > 
-> A fejezet néhány része a [django-marcador tutorial][1] alapján készült, ami a Creative Commons Attribution-ShareAlike 4.0 International License alatt áll. A django-marcador tutorial jogait, Markus Zapke-Gründemann és társai birtokolják.
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. A django-marcador tutorial jogait, Markus Zapke-Gründemann és társai birtokolják.
 
- [1]: http://django-marcador.keimlink.de/
-
-Most egy egyszerű blogot fogunk készíteni!
+We're going to create a small blog!
 
 Az első lépés, hogy indítsunk egy új Django projektet. Ez annyit jelent, hogy lefuttatunk néhány scriptet, amit a Django tartalmaz, ezzel létrehozzuk a projekt vázát. Ez tulajdonképpen néhány mappa és fájl, amit majd később fogunk használni.
 
 Néhány fájl és könyvtár neve nagyon fontos a Django-ban. A fájlokat, amiket most hozunk létre, ne nevezd át! Az áthelyezésük sem egy jó ötlet. Fontos, hogy megtartsunk egy bizonyos szerkezetet, ami segít a Django-nak, hogy megtalálja a fontos dolgokat.
 
-> Figyelem: mindent a virtualenv-ben futtass. Ha nem látod a `(myvenv)` előtagot a konzolodban, aktiválnod kell a virtuális környezetedet. Ezt a **Django telepítés** fejezetben írtuk le, a **Virtuális környezetben való fejlesztés** résznél. Windows környezetben a `myvenv\Scripts\activate` parancssal, Mac OS / Linux alatt a `source myvenv/bin/activate` paranccsal tudod megtenni.
+> Figyelem: mindent a virtualenv-ben futtass. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. Ezt a **Django telepítés** fejezetben írtuk le, a **Virtuális környezetben való fejlesztés** résznél. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
 
-Ha Mac OS-t vagy Linuxot használsz, a következő parancsot kell futtatnod; **ne felejtsd el kitenni a pontot `.` a végén**:
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ django-admin startproject mysite .
     
 
-Ha Windowst használsz: **ne felejtsd el kitenni a pontot `.` a végén**:
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
 
-    (myvenv) C:\Users\Name\djangogirls> django-admin startproject mysite .
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
     
 
-> A pont `.` nagyon fontos, mert ez mondja meg a scriptnek, hogy abba a könyvtárba telepítse a Django-t, ahol éppen vagy (a pont `.` egy rövidítése ennek).
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
 > 
-> **Megjegyzés** Amikor begépeled a fenti parancsokat, csak azokat a részeket írd be, amik úgy kezdődnek, hogy `django-admin` vagy `django-admin.py`. A `(myvenv) ~/djangogirls$` és `(myvenv) C:\Users\Name\djangogirls>` csak példák a parancssorodra, amely azt várja, hogy parancsokat gépelj be neki.
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
 
 A `django-admin.py` egy script, ami könyvtárakat és fájlokat hoz létre neked. Most ilyen könyvtárszerkezetednek kell lennie:
 
@@ -39,13 +53,13 @@ A `django-admin.py` egy script, ami könyvtárakat és fájlokat hoz létre neke
             __init__.py
     
 
-> **Megjegyzés**: A könyvtárszerkezetedben a `venv` könyvtár is meg fog jelenni, amelyet nemrég hoztunk létre.
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
 
-A `manage.py` egy script, ami az oldal menedzselésében segít. Segítségével elindíthatsz egy webszervert a saját gépeden, anélkül, hogy bármit kellene installálnod, és más dolgokra is jó.
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
 
 A `settings.py` tartalmazza a weboldalat konfigurációját (beállításait),.
 
-Emlékszel, mit olvastál a postásról, aki azt próbálja kitalálni, hova vigye a levelet? Az `urls.py` fájl tartalmazza a mintákat, amiket az `urlresolver` használ.
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
 
 Most ne foglalkozzunk a többi fájllal, mert azokat nem fogjuk módosítani. Az egyetlen dolog, amit ne felejts el, hogy ne töröld ki őket véletlenül!
 
@@ -53,99 +67,136 @@ Most ne foglalkozzunk a többi fájllal, mert azokat nem fogjuk módosítani. Az
 
 Változtassunk meg néhány dolgot a `mysite/settings.py` fájlban. Nyisd meg a fájlt a kódszerkesztővel, amit korábban telepítettél!
 
-Jó lenne, ha a weboldalunk a mi időzónánk szerinti időt mutatná. Nézd meg a [wikipedia időzóna listát][2], és másold ki az időzónádat (TZ, time zone). (például `Europe/Budapest` )
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+Jó lenne, ha a weboldalunk a mi időzónánk szerinti időt mutatná. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
 
- [2]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
 
-Keresd meg a settings.py azt a sort, ami így keződik: `TIME_ZONE`, és írd át, hogy a saját időzónádat használja:
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-    TIME_ZONE = 'Europe/Budapest'
+TIME_ZONE = 'Europe/Berlin'
 ```
 
-Az "Europe/Budapest"-et változtasd meg kedved szerint.
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
 
-Szükségünk lesz még arra, hogy megadjuk a statikus fájlokhoz vezető elérési útvonalat (később mindent megtudhatsz a statikus fájlokról és a CSS-ről). Menj a fájl *végére*, és a `STATIC_URL` bejegyzés alatt adj hozzá egy következő bejegyzést `STATIC_ROOT` névvel:
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-    STATIC_URL = '/static/'
-    STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+LANGUAGE_CODE = 'de-ch'
 ```
 
-Amikor a DEBUG értéke True és az ALLOWED_HOSTS üres, a hosztnév alapértelmezetten ['localhost', '127.0.0.1', '[::1]']. Ez deploy után nem fog működni a PythonAnywhere-en, ezért változtassuk meg ezt a beállítást így:
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-    ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
 ```
 
-## Adatbázis létrehozása
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
 
 Sok különféle adatbázis-szoftver létezik, ami adatokat tud tárolni a weboldalakhoz. Mi az alapértelmezettet fogjuk használni, az `sqlite3`-ot.
 
 Ez már be van állítva a `mysite/settings.py` fájlodban:
 
+{% filename %}mysite/settings.py{% endfilename %}
+
 ```python
-    DATABASES = {
-        'default': {
-            'ENGINE': 'django.db.backends.sqlite3',
-            'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
-        }
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
     }
+}
 ```
 
-Hogy létrehozz egy adatbázist a blogodhoz, futtasd le a következő parancsot a konzolban: `python manage.py migrate` (fontos, hogy a `djangogirls` könyvtárban legyél, ami tartalmazza a `manage.py` fájlt). Ha minden jól megy, valami ilyesmit kell látnod:
+Hogy létrehozz egy adatbázist a blogodhoz, futtasd le a következő parancsot a konzolban: `python manage.py migrate` (fontos, hogy a `djangogirls` könyvtárban legyél, ami tartalmazza a `djangogirls` fájlt). Ha minden jól megy, valami ilyesmit kell látnod:
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py migrate
     Operations to perform:
-      Synchronize unmigrated apps: messages, staticfiles
-      Apply all migrations: contenttypes, sessions, admin, auth
-    Synchronizing apps without migrations:
-       Creating tables...
-          Running deferred SQL...
-       Installing custom SQL...
+      Apply all migrations: auth, admin, contenttypes, sessions
     Running migrations:
       Rendering model states... DONE
       Applying contenttypes.0001_initial... OK
       Applying auth.0001_initial... OK
       Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
       Applying contenttypes.0002_remove_content_type_name... OK
       Applying auth.0002_alter_permission_name_max_length... OK
       Applying auth.0003_alter_user_email_max_length... OK
       Applying auth.0004_alter_user_username_opts... OK
       Applying auth.0005_alter_user_last_login_null... OK
       Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
       Applying sessions.0001_initial... OK
     
 
 Készen is vagyunk! Itt az ideje, hogy elindítsd a webszervert, és meglásd, hogy működik-e.
 
-## Webszerver elindítása
+## Starting the web server
 
 Ehhez abban a könyvtárban kell lenned, ahol a `manage.py` fájl van (a `djangogirls` könyvtárban). A konzolban a következő paranccsal tudod elindítani a szervert: `python manage.py runserver`.
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py runserver
     
 
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
 Ha Windowst használsz, és `UnicodeDecodeError` hibaüzenetet kapsz, ezt a parancsot használd:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
     
 
-Most nincs más dolgod, mint ellenőrizni, hogy fut-e a weboldalad. Nyisd meg a böngésződet (Firefox, Chrome, Safari, Internet Explorer, vagy bármi más, amit használsz), és írd be a következő címet:
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
 
     http://127.0.0.1:8000/
     
 
-Gratulálunk! Létrehoztad az első weboldaladat, és futtatad is egy webszerver segítségével! Hát nem fantasztikus?
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
 
-![It worked!][3]
+Gratulálunk! Létrehoztad az első weboldaladat, és futtatad is egy webszerver segítségével! Nem fantasztikus?
 
- [3]: images/it_worked2.png
+![It worked!](images/it_worked2.png)
 
-A webszerver átvette az irányítást a parancssorod fölött, egészen addig, amíg le nem állítod. A terminálba tudsz gépelni, de nem fog lefuttatni új parancsokat. Ez azért van, mert a webszervernek folyamatosan kell futnia, hogy a beérkező lekérdezéseket (request-eket) fogadja.
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
 
-> Webszerverek működését a  <b>Hogy működik az Internet?</b> fejezetben tekintettük át.
+> We reviewed how web servers work in the **How the Internet works** chapter.
 
-Hogy újabb parancsokat írhass be, amíg fut a szerver, új terminálablakot kell nyitnod, és újraaktiválni a virtuális környezetedet. Hogy leállítsd a szervert, lépj vissza az ablakba, ahol fut, és nyomd meg a CTRL + C (Control és C billentyű egyszerre) billentyűkombinációt. (Windowson lehet, hogy a Ctrl+Break fog működni).
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
 
-Készen állsz a következő lépésre? Itt az ideje, hogy létrehozzunk némi tartalmat!
+Készen állsz a következő lépésre? Itt az ideje, hogy létrehozzunk némi tartalmat!
\ No newline at end of file
diff --git a/hu/django_templates/README.md b/hu/django_templates/README.md
index bb4d32a81da..81ca29940b3 100644
--- a/hu/django_templates/README.md
+++ b/hu/django_templates/README.md
@@ -4,9 +4,9 @@ Itt az idő, hogy megjelenítsünk pár adatot! Ehhez Django felkínál nekünk
 
 ## Mik a template tag-ek?
 
-Mint látod, a HTML-ben nem tudsz Python kódot írni, mivel a böngészők nem értik, csak a HTML-t. Fontos tudni, hogy a HTML inkább statikus, míg Python inkább dinamikus.
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
 
-A **Django template tag-ek** lehetővé teszik, hogy Python-szerű dolgokat írjunk a HTML-be, ezáltal gyorsabban és könnyebben tudsz dinamikus weboldalt készíteni. Éljen!
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
 ## Template a bejegyzések listájához
 
@@ -14,36 +14,41 @@ Az előző fejezetben hozzáadtuk a template-hez a bejegyzéseink listáját a `
 
 Ahhoz, hogy kiírjunk egy változót a Django template-ben, dupla kapcsos zárójelet használunk, benne a változó nevével, mint itt:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {{ posts }}
-```    
+```
 
 Próbáld ki a `blog/templates/blog/post_list.html` template-ben. Cserélj ki mindent a második `<div>` -től a harmadikig a következővel: `{{ posts }}`. Mentsd el a fájlt és frissítsd az oldalt, hogy lásd az eredményt:
 
-![13.1 ábra][1]
-
- [1]: images/step1.png
+![13.1 ábra](images/step1.png)
 
 Ahogy látod, ez minden, amink van:
 
-    <QuerySet [<Post: My second post>, <Post: My first post>]>
-    
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
 
 Ez azt jelenti, hogy a Django objektumok listájaként értelmezi. Emlékszel a **Bevezetés a Python-ba** című fejezetből, hogy hogyan jelenítünk meg listákat? Igen, for loop-okkal! Egy Django template-ben ezt így tudod megtenni:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     {{ post }}
 {% endfor %}
-```   
+```
 
 Próbáld ki a template-edben.
 
-![13.2 ábra][2]
+![13.2 ábra](images/step2.png)
 
- [2]: images/step2.png
+És működik! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. A HTML-t és a template tageket használhatod együtt. A `body` így fog kinézni:
 
-És működik! De azt akarjuk, hogy úgy jelenjen meg, mint a statikus bejegyzések, amit korábban készítettünk el a **Bevezetés a HTML-be** című fejezetben. A HTML-t és a template tageket használhatod együtt. A `body` így fog kinézni:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <div>
@@ -57,50 +62,45 @@ Próbáld ki a template-edben.
         <p>{{ post.text|linebreaksbr }}</p>
     </div>
 {% endfor %}
-```    
+```
 
 {% raw %} Minden, amit a `{% for %}` és `{% endfor %}` közé írsz, a lista minden egyes elemére meg fog ismétlődni. Frissítsd az oldalt:{% endraw %}
 
-![13.3 ábra][3]
+![13.3 ábra](images/step3.png)
 
- [3]: images/step3.png
-
-Észrevetted, hogy most egy kicsit más megjelölést használtunk: `{{ post.title }}`? Az adatokat a `Post` modelben meghatározott mezők szerint érjük el. Emellett `|linebreaksbr` kíséri a szöveget, ezáltal egy filteren keresztül új bekezdéssé alakítja az újsor karaktereket.
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? Az adatokat a `Post` modelben meghatározott mezők szerint érjük el. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
 
 ## Még valami
 
-Jó lenne látni, hogy a weblapod még mindig működik az Interneten, nem igaz? Telepítsük újra a PythonAnywhere-en. Itt a lépések összefoglalója...
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
 
-*   Először tedd fel a kódot a Github-ra
-```
-$ git status
-[...]
-$ git add --all .
-$ git status
-[...]
-$ git commit -m "Modified templates to display posts from database."
-[...]
-$ git push
-```    
+* Először tedd fel a kódot a Github-ra
 
-*   Ezután a [PythonAnywhere][4]-en menj a **Bash console**-ba (vagy indíts újat), és futtasd le:
+{% filename %}command-line{% endfilename %}
 
- [4]: https://www.pythonanywhere.com/consoles/
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
 
-```
-$ cd my-first-blog
-$ git pull
-[...]
-```
+* Ezután a [PythonAnywhere](https://www.pythonanywhere.com/consoles/)-en menj a **Bash console**-ba (vagy indíts újat), és futtasd le:
 
-*   Végül, a [Web][5] menüpontban klikkelj a **Reload**-ra. A frissítések ott vannak!  Ha a blogposztok a PythonAnywhere oldaladon nem egyeznek a helyi gépeden lévő blogban lévőkkel, az nem probléma. Az adatbázisok a helyi gépeden és PythonAnywhere-en nem szinkronizálódnak a többi file-al együtt.
+{% filename %}PythonAnywhere command-line{% endfilename %}
 
- [5]: https://www.pythonanywhere.com/web_app_setup/
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
-Gratulálunk! Folytatásképp hozz létre új bejegyzéseket a Django adminban (ne felejts el published_date-t hozzáadni). Ellenőrizd, hogy a pythonanywhere oldalhoz tartozó admin oldalon https://yourname.pythonanywhere.com/admin vagy. Majd frissítsd az oldalt, hogy lásd, megjelentek-e.
+* Végül, a [Web](https://www.pythonanywhere.com/web_app_setup/) menüpontban klikkelj a **Reload**-ra. A frissítések ott vannak! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
 
-Olyan, mint a varázslat? Büszkék vagyunk Rád! Hagy ott egy kicsit a gépet, megérdemelsz egy kis szünetet. :)
+Gratulálunk! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
 
-![13.4 ábra][6]
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
 
- [6]: images/donut.png
+![13.4 ábra](images/donut.png)
\ No newline at end of file
diff --git a/hu/django_urls/README.md b/hu/django_urls/README.md
index e43f4e1ec3f..cb0e3e5e814 100644
--- a/hu/django_urls/README.md
+++ b/hu/django_urls/README.md
@@ -1,22 +1,21 @@
-# Django url-ek
+# Django URLs
 
-Mindjárt elkészíted az első weblapodat: a blogod honlapját! De előbb tanuljunk egy kicsit a Django url-ekről.
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
 
 ## Mi az URL?
 
-Az URL egyszerűen csak egy webes cím. Minden alkalommal látsz URL-eket, amikor meglátogatsz egy weboldalt - a böngésződ címsorában találodm meg (igen! a `127.0.0.1:8000` egy URL! És a `https://djangogirls.org` is egy URL):
+Az URL egyszerűen csak egy webes cím. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! a `127.0.0.1:8000` egy URL! And `https://djangogirls.org` is also a URL.)
 
-![Url][1]
+![Url](images/url.png)
 
- [1]: images/url.png
-
-Az interneten minden oldalnak szüksége van egy saját URL-re. Innen tudja az alkalmazásod, hogy mit mutasson a felhasználónak, aki megnyitott egy URL-t. A Django-ban egy `URLconf` nevű dolgot használunk (URL configuration, vagyis URL beállítások). Az URLConf egy csomó minta, amit a Django megpróbál összehasonlítani az URL-lel, amit kapott, és ez alapján találja meg a helyes view-t.
+Az interneten minden oldalnak szüksége van egy saját URL-re. This way your application knows what it should show to a user who opens that URL. A Django-ban egy `URLconf` nevű dolgot használunk (URL configuration, vagyis URL beállítások). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
 
 ## Hogy működnek az URL-ek a Django-ban?
 
 Nyisd meg a `mysite/urls.py` fájlt a kódszerkesztőben, és nézd meg:
 
 {% filename %}mysite/urls.py{% endfilename %}
+
 ```python
 """mysite URL Configuration
 
@@ -30,97 +29,101 @@ urlpatterns = [
 ]
 ```
 
-Amint láthatod, a Django már előre iderakott nekünk pár dolgot.
+As you can see, Django has already put something here for us.
 
-A hármas idézőjelek (`'''` vagy `"""`) közötti sorok neve docstring (dokumentációs sztring) – Írhatsz ilyet egy file, osztály (class) vagy method elején, hogy leírhatsd hogy mit csinál. Python nem fogja lefuttatni ezeket a sorokat.
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
 
-Az admin URL, amit az előző fejezetben már meglátogattál, már itt van:
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
 
 ```python
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
 ```
 
-Ez azt jelenti, hogy minden URL-nél, ami `admin/`-nal kezdődik, a Django meg fogja találni a hozzátartozó *view*-t. Ebben az esetben sok admin URL-t hozzáadunk, hogy ne kelljen az egészet ebbe a kis fájlba tömni - így olvashatóbb és letisztultabb.
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
 
 ## Regex
 
 Kíváncsi vagy, hogyan párosítja össze a Django az URL-eket és a view-kat? Na, ez a rész trükkös. A Django `regex`-et használ (a "regular expressions", vagyis reguláris kifejezések rövidítése). A regexnek nagyon (nagyon!) sok szabálya van arra, hogy hogyan épít fel egy keresési mintázatot. Mivel a regex egy magasabb szintű téma, most nem megyünk bele a részletekbe.
 
-Ha szeretnéd megérteni, hogy hogyan hoztuk létre a mintákat, itt egy példa - csak néhány szabályra van szükségünk, hogy felépítsük a mintát, amit keresünk, például:
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
 
-    ^ a szöveg eleje
-    $ a szöveg vége
-    \d számjegy
-    + ez azt jelzi, hogy az előző elem egynél többször ismétlődik
-    () ez a minta egy részét fogja össze
-    
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
 
-A Django minden mást, ami az url definícióban van, szó szerint fog értelmezni.
+Anything else in the URL definition will be taken literally.
 
-Képzeld el, hogy van egy weboldalad ezzel a címmel: `http://www.mysite.com/post/12345/`, ahol a `12345/` a bejegyzésed száma.
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
 
-Minden egyes poszt számához új view-t írni nagyon idegesítő lenne. A reguláris kifejezésekkel létrehozhatunk egy mintát, ami megtalálja az URL-t, és kiszedi belőle a számot: `^post/(\d+)/$`. Nézzük meg lépésről lépésre, hogy mi történik itt:
+Minden egyes poszt számához új view-t írni nagyon idegesítő lenne. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
 
-*   A **^post/** azt mondja meg a Django-nak, hogy minden olyan url-t találjon meg, ami `post/`-tal kezdődik (rögtön ezután: `^`)
-*   A **(\d+)** azt jelenti, hogy ezután egy szám fog következni (egy vagy több számjegyű), és ezt a számot ki szeretnénk olvasni az URL-ből
-*   A **/** azt mondja meg a Django-nak, hogy utána még egy `/` karakternek kell következnie
-*   A **$** az URL végét jelzi, vagyis csak azok a stringeket fogja megfeleltetni a mintának, amik így végződnek: `/`
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* A **(\d+)** azt jelenti, hogy ezután egy szám fog következni (egy vagy több számjegyű), és ezt a számot ki szeretnénk olvasni az URL-ből
+* A **/** azt mondja meg a Django-nak, hogy utána még egy `/` karakternek kell következnie
+* A **$** az URL végét jelzi, vagyis csak azok a stringeket fogja megfeleltetni a mintának, amik így végződnek: `/`
 
-## Az első Django URL-ed!
+## Your first Django URL!
 
-Itt az ideje, hogy létrehozzuk az első URL-t! Azt szeretnénk, ha a 'http://127.0.0.1:8000/' lenne a blog kezdőoldala, és itt egy listát láthatnánk a blogbejegyzésekből.
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
 
-Fontos, hogy tisztán tartsuk a `mysite/urls.py` fájlt, ezért a `blog` alkalmazásból fogjuk importálni az url-eket.
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
 
-Rajta, add hozzá a sort, ami beimportálja `blog.urls`-t. Figyelmd meg, hogy az `include` függvényt használjuk, ezért hozzá **kell** adnod azt az import-ot a file első sorához.
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
 
 A `mysite/urls.py` fájlod most így néz ki:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import include
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
     url(r'', include('blog.urls')),
 ]
 ```
 
 Mostantól a Django mindent, ami a 'http://127.0.0.1:8000/'-re jön, átirányít a `blog.urls`-re, és ott fogja keresni a további tennivalókat.
 
-Amikor Pythonban írunk reguláris kifejezéseket, a stringek előtt mindig egy `r` áll. Ez egy hasznos tipp a Pythonnak, hogy a string tartalmazhat speciális karaktereket, de ezek a reguláris kifejezés alkotóelemei, és nem magának a Pythonnak szólnak.
+Writing regular expressions in Python is always done with `r` in front of the string. Ez egy hasznos tipp a Pythonnak, hogy a string tartalmazhat speciális karaktereket, de ezek a reguláris kifejezés alkotóelemei, és nem magának a Pythonnak szólnak.
 
 ## blog.urls
 
-Hozz létre egy új, üres fájlt `blog/urls.py` néven. Nagyszerű! Most írd be az első két sort:
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
 from . import views
 ```
 
-Itt csak annyi történik, hogy importáljuk a Django methodjait és az összes `view`nkat a `blog` alkalmazásból (még egyet sem írtunk meg, de mindjárt ezzel is foglalkozunk!)
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
 
 Ezután megírhatjuk az első URL mintát:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
 ]
 ```
 
-Amint láthatod, itt egy `post_list` nevű `view`t rendeltünk hozzá a `^$` URL-hez. Ez a regex a `^` karaktert (string kezdete) és az utána következő `$` karaktert (string vége) fogja keresni - vagyis csak az üres string felel meg neki. Ez így helyes, mert a Django URL resolverében a 'http://127.0.0.1:8000/' nem számít az URL részének. Ez a minta mondja meg a Django-nak, hogy ha valaki a 'http://127.0.0.1:8000/' címen lép be a weboldaladra, a `views.post_list` a helyes lépés.
-
-Az utolsó rész, `name='post_list'` az URL neve, amit a view azonosítására használunk. Ez lehet ugyanaz, mint a view neve, de lehet teljesen más is. A projekt későbbi részeiben ezeket az elnevezett URL-eket fogjuk használni, ezért fontos, hogy az app minden URL-jének nevet adjunk. Törekedj arra, hogy egyedi és könnyen megjegyezhető neveket adj.
-
-Minden világos? Nyisd meg a http://127.0.0.1:8000/ URL-t a böngésződben, hogy lásd az eredményt.
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. Ez így helyes, mert a Django URL resolverében a 'http://127.0.0.1:8000/' nem számít az URL részének. Ez a minta mondja meg a Django-nak, hogy ha valaki a 'http://127.0.0.1:8000/' címen lép be a weboldaladra, a `views.post_list` a helyes lépés.
 
-![Hiba][2]
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. Ez lehet ugyanaz, mint a view neve, de lehet teljesen más is. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
 
- [2]: images/error1.png
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
 
-Már nincs ott az "It works", igaz? Ne aggódj, ez csak egy hibaoldal, semmi félelmetes nincs benne! Tulajdonképpen nagyon is hasznos az ilyesmi:
+![Hiba](images/error1.png)
 
-Azt olvashatod, hogy **no attribute 'post_list'**, vagyis "nincs post_list nevű attribútum". Eszedbe jut valami a *post_list*-ről? Így neveztük el a view-t! Ez azt jelenti, hogy minden a megfelelő helyen van, csak még nem hoztuk létre a *view*-t. Ne aggódj, mindjárt eljutunk odáig.
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
 
 > Ha többet szeretnél megtudni a Django URLconf-ról, nézz bele a hivatalos dokumentációba: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/hu/django_views/README.md b/hu/django_views/README.md
index 6592bc15bd5..c2e1ab7d31b 100644
--- a/hu/django_views/README.md
+++ b/hu/django_views/README.md
@@ -1,8 +1,8 @@
-# Django views - itt az ideje alkotni!
+# Django views – time to create!
 
-Eljött az idő, hogy megszabaduljunk a hibától, amit az előző fejezetben szereztünk :)
+Eljött az idő, hogy megszabaduljunk a hibától, amit az előző fejezetben szereztünk! :)
 
-A *nézet (view)* az a rész, ahova az applikációnk "logikáját" írjuk. Szükség lesz a nemrég elkészült `model`-ben megadott adatokra, amit majd továbbít a `template`-nek. A template-et majd a következő fejezetben hozzuk létre. A nézetek ugyanolyan Python metódusok, mint amiket a **Bevezetés a Python-ba** című fejezetben csináltunk, csak egy kicsit bonyolultabbak.
+A *nézet (view)* az a rész, ahova az applikációnk "logikáját" írjuk. Szükség lesz a nemrég elkészült `model`-ben megadott adatokra, amit majd továbbít a `template`-nek. A template-et majd a következő fejezetben hozzuk létre. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
 
 A nézetek a `views.py` fájlban találhatók. A *view-kat* a `blog/views.py` fájlba fogjuk írni.
 
@@ -10,29 +10,35 @@ A nézetek a `views.py` fájlban találhatók. A *view-kat* a `blog/views.py` f
 
 Ok, nyissuk ki ezt a fájlt és nézzük, mi van benne:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
 # Create your views here.
 ```
 
-Egyelőre nem túl sok minden. A legegyszerűbb *view* így néz ki.
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Mint látod, létrehoztunk egy `post_list` elnevezésű metódust (`def`), ami vesz egy `request`-et és `return`-öl (visszaad) egy `render` metódust, ami összeállítja a `blog/post_list.html` template-et.
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
 
-Mentsd el a fájlt, menj a http://127.0.0.1:8000/ címre és lássuk, mink van.
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
 
 Újabb hiba! Olvasd el, mi a helyzet:
 
-![Hiba][1]
-
- [1]: images/error.png
+![Hiba](images/error.png)
 
-Ez egyszerű: *TemplateDoesNotExist*. Javítsuk ki ezt a hibát, és hozzunk létre egy template-et a következő fejezetben!
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
 
 > Tanulj meg többet a Django nézetekről a hivatalos dokumentációból: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/hu/dynamic_data_in_templates/README.md b/hu/dynamic_data_in_templates/README.md
index 97edb5a51f1..2910ceab757 100644
--- a/hu/dynamic_data_in_templates/README.md
+++ b/hu/dynamic_data_in_templates/README.md
@@ -1,13 +1,15 @@
 # Dinamikus adatok a template-ben
 
-Az összetevőink különböző helyeken vannak: a `Post` modellt a `models.py`-ban definiáltuk, a `post_list` a `views.py`-ban van, és létrehoztunk egy sablont is. De mégis hogyan fogjuk megjeleníteni a bejegyzést a HTML sablonban? Mert pontosan ez az, amit szeretnénk: fogjuk a tartalmat (az adatbázisban elmentett modelleket) és szépen megjelenítjük a sablonunkban.
+Az összetevőink különböző helyeken vannak: a `Post` modellt a `models.py`-ban definiáltuk, a `post_list` a `views.py`-ban van, és létrehoztunk egy sablont is. De mégis hogyan fogjuk megjeleníteni a bejegyzést a HTML sablonban? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
 
-Pont ez az, amit a *nézetek (views)* csinálnak: összekötik a modelleket a sablonokkal. A `post_list` *view*-ba kell berakni a modelleket, amiket meg akarunk jeleníteni, és továbbítani a sablonba. Tehát a *nézet*ben eldöntjük, hogy mi fog megjelenni a sablonban.
+Pont ez az, amit a *nézetek (views)* csinálnak: összekötik a modelleket a sablonokkal. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
 
-OK, hogyan fogjuk ezt megvalósítani?
+OK, so how will we achieve this?
 
 Meg kell nyitni a `blog/views.py` fájlt. Eddig így nézett ki a `post_list` *view*:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
@@ -15,29 +17,34 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Emlékszel, amikor azt magyaráztuk, hogyan tudsz korábban megírt kódot beletenni más fájlokba? Most itt az alkalom, hogy beletegyük a modelt, amit a `models.py`-ba írtunk. A `from .models import Post` sort a következőképpen adjuk hozzá:
+Emlékszel, amikor azt magyaráztuk, hogyan tudsz korábban megírt kódot beletenni más fájlokba? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
 from .models import Post
 ```
 
-A pont a `from` után az *aktuális könyvtárt*, vagy az *aktuális applikációt* jelenti. Mivel a `views.py` és a `models.py` ugyanabban a könyvtárban vannak, elég annyit használnunk, hogy `.` és a fájl nevét (`.py` nélkül). Ezután importáljuk a model nevét.).
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Ezután importáljuk a model nevét).
 
-De mi jön ezután? Ahhoz, hogy megkapjuk az aktuális blog bejegyzést a `Post` modelből, szükségünk lesz valamire, amit `QuerySet`-nek hívnak.
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
 
 ## QuerySet
 
-Már ismerős lehet, hogy hogyan működik a QuerySet. A [Django ORM (QuerySets)][1] fejezetben már beszéltünk róla.
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
 
- [1]: ../django_orm/README.md
+{% filename %}blog/views.py{% endfilename %}
 
-Most azok a bejegyzések érdekelnek minket, amik publikálva vannak és a `published_date` szerint vannak sorba rendezve. Ezt már megtettük a QuerySets fejezetben!
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
 
-    Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-    
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
 
-Most ezt a kódrészletet rakjuk a `blog/views.py` fájlba, hozzáadva a `def post_list(request)` function-hoz:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
@@ -49,16 +56,16 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Figyeld meg, hogy létrehozunk egy *változót* a QuerySethez: `posts`. Vedd úgy, hogy ez a QuerySet neve. Innentől kezdve erre a névre hivatkozva használjuk.
-
-Szintén fontos, hogy a kód a `timezone.now()` function-t tartalmazza, ehhez importálnunk kell a `timezone`-t.
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
 
-Az utolsó hiányzó rész, hogy továbbítsuk a `posts`-ot a sablonba (ezt a következő fejezetben kifejtjük).
+Figyeld meg, hogy létrehozunk egy *változót* a QuerySethez: `posts`. Vedd úgy, hogy ez a QuerySet neve. Innentől kezdve erre a névre hivatkozva használjuk.
 
-A `render` function-ban már van egy `request` paraméterünk (vagyis minden, ami a felhasználótól érkezik az interneten keresztül) és egy template file `'blog/post_list.html'`. Az utolsó paraméter, ami így néz ki: `{}`, egy olyan összetevő, amiben megadhatjuk azokat a dolgokat, amiket használni fogunk a template-ben. El kell neveznünk őket (egyelőre ragaszkodunk a `'posts'`-hoz :)). Így kell kinéznie: `{'posts': posts}`. Ne felejtsd el, hogy a `:` előtti rész egy string, ezt idézőjelbe kell tenned `''`.
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. El kell neveznünk őket (egyelőre ragaszkodunk a `'posts'`-hoz). :) Így kell kinéznie: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
 
 Végül a `blog/views.py` fájlnak így kell kinéznie:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from django.utils import timezone
@@ -71,4 +78,4 @@ def post_list(request):
 
 És megvan! Itt az idő visszatérni a template-hez és megjeleníteni ezt a QuerySet-et!
 
-Ha utána szeretnél olvasni a QuerySet-nek, itt megteheted: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/hu/extend_your_application/README.md b/hu/extend_your_application/README.md
index ffe6a9c5bfa..fa5e7f6c399 100644
--- a/hu/extend_your_application/README.md
+++ b/hu/extend_your_application/README.md
@@ -10,7 +10,7 @@ Már van egy `Post` modellünk, úgyhogy nem kell hozzáadnunk semmit a `models.
 
 ## Template link a bejegyzés részleteihez
 
-Kezdjük azzal, hogy hozzáadunk egy linket a `blog/templates/blog/post_list.html` fájlhoz. Eddig így kell kinéznie:
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -27,25 +27,24 @@ Kezdjük azzal, hogy hozzáadunk egy linket a `blog/templates/blog/post_list.htm
     {% endfor %}
 {% endblock %}
 ```
-    
 
 {% raw %}Szükségünk van egy linkre a bejegyzések címei és a bejegyzések részletes oldala között. Cseréljük ki a `<h1><a href="">{{ post.title }}</a></h1>` sort úgy, hogy a bejegyzés részletes oldalára vezet: {% endraw %}
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
 ```
 
 {% raw %}Itt az ideje elmagyarázni a rejtélyes `{% url 'post_detail' pk=post.pk %}` részt. Ahogy gyaníthattad, a `{% %}` jelölés azt jelenti, hogy Django template tag-eket használunk. Ezúttal egy olyat, ami létrehoz egy URL-t nekünk!{% endraw %}
 
-A `blog.views.post_detail` egy elérési út a `post_detail` *view*-hez, amit létre akarunk hozni. Jegyezd meg: `blog` az applikációnk neve (a `blog` könyvtár), `views` a `views.py` nevéből van, és az utolsó rész - `post_detail` - a *nézet* neve.
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
 
-És a `pk=post.pk` rész? A `pk` a "primary key" (elsődleges kulcs) rövidítése, amely mindegyik bejegyzésnek egy egyedi neve az adatbázisban. Nem adtunk meg egy elsődleges kulcsot a `Post` modellünkben, ezért Django létre fog nekünk hozni egyet (alapértelmezetten egy számot fog használni, amely egyesével nő, pl. 1, 2, 3) és ezt egy `pk` nevű mezőben hozzáadja mindegyik posthoz. Az elsődleges kulcsot `post.pk`-al érhetjük el, ugyan úgy mint a többi mezőt (`title`, `author`, stb.) a `Post` objektumban!
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
 
-Most amikor a http://127.0.0.1:8000/ címre megyünk, lesz egy hibaüzenetünk (ahogy vártuk is, mivel nincsen sem URL, sem *view* a `post_detail`-hez). Így fog kinézni:
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
 
-![NoReverseMatch hiba][1]
-
- [1]: images/no_reverse_match2.png
+![NoReverseMatch hiba](images/no_reverse_match2.png)
 
 ## URL a bejegyzés részleteihez
 
@@ -53,7 +52,9 @@ Hozzunk létre egy URL-t a `urls.py`-ban a `post_detail` *view*-hoz!
 
 Az első bejegyzésünk részleteit a kövekező **URL** címen akarjuk megjeleníteni: http://127.0.0.1:8000/post/1/
 
-Hozzunk létre egy URL-t a `blog/urls.py` fájlban, ami egy `post_detail` nevű *view*-ra mutat -- ez majd egy egész blogbejegyzést jelenít meg. Add hozzá a `url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),` sort a `blog/urls.py` fájlhoz. Így kell kinéznie a fájlnak:
+Hozzunk létre egy URL-t a `blog/urls.py` fájlban, ami egy `post_detail` nevű *view*-ra mutat -- ez majd egy egész blogbejegyzést jelenít meg. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. Így kell kinéznie a fájlnak:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
@@ -61,85 +62,88 @@ from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
 ]
 ```
 
-Ez a rész `^post/(?P<pk>[0-9]+)/$` elég ijesztően néz ki, de ne aggódj,elmagyarázzuk:
-- `^`-vel kezdődik -- "eleje" - `post/` azt jelenti, hogy az eleje után az URL-nek tartalmaznia kell ezt: **post** és **/**. Eddig jó.
-- `(?P<pk>[0-9]+)` - ez a rész trükkösebb. Ez azt jelenti, a Django fogja, amit ideraksz, és átirányítja egy nézethez egy `pk` nevű változóként. `[0-9]` azt közli, hogy ez csak egy számjegy lehet, betű nem (tehát minden 0 és 9 között). `+` azt jelenti, hogy egy vagy több számjegynek kell lennie. Tehát `http://127.0.0.1:8000/post//` nem érvényes, de `http://127.0.0.1:8000/post/1234567890/` teljesen jó!
-- `/` - kell még egy **/** - `$`
-- "vége"!
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
 
-Ez azt jelenti, hogy ha beírod a `http://127.0.0.1:8000/post/5/` címet a böngésződbe, akkor a Django megérti, hogy egy `post_detail` nevű 1>nézetet</em> keresel, és közvetíti az információt, hogy a `pk` `5-tel` egyenlő annál a *nézetnél*.
-
-`pk` a `primary key` rövid változata. Ezt a kifejezést gyakran használják Django projektekben. De úgy nevezed el a változódat, ahogy akarod (ne feledd: kisbetűkkel és szóköz helyett `_` karakterrel!). Például `(?P<pk>[0-9]+)` esetén használhatunk `post_id` változót, amivel így nézne ki: `(?P<post_id>[0-9]+)`.
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. Ez azt jelenti, a Django fogja, amit ideraksz, és átirányítja egy nézethez egy `pk` nevű változóként. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` azt jelenti, hogy egy vagy több számjegynek kell lennie. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
 
-Ok, hozzáadtunk egy új URL-t a `blog/urls.py`-hoz! Frissítsük az oldalt: http://127.0.0.1:8000/ Boom! Már megint egy újabb hiba! Várható volt!
+Ez azt jelenti, hogy ha beírod a `http://127.0.0.1:8000/post/5/` címet a böngésződbe, akkor a Django megérti, hogy egy `post_detail` nevű 1>nézetet</em> keresel, és közvetíti az információt, hogy a `pk` `5-tel` egyenlő annál a *nézetnél*.
 
-![AttributeError][2]
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
 
- [2]: images/attribute_error2.png
+![AttributeError](images/attribute_error2.png)
 
 Emlékszel, mi a következő lépés? Hát persze: hozzáadni egy új nézetet!
 
 ## Nézet a bejegyzés részleteihez
 
-Ezúttal adunk a *nézetünknek* egy extra paramétert: `pk`. A *nézetünknek* ezt meg kell kapnia, igaz? Úgyhogy a function-t úgy fogjuk meghatározni, hogy `def post_detail(request, pk):`. Jegyezd meg, hogy pontosan ugyanazt a nevet kell használnunk, amit az url-ben jelöltünk meg (`pk`). A változó kihagyása helytelen, és hibát fog eredményezni!
+This time our *view* is given an extra parameter, `pk`. A *nézetünknek* ezt meg kell kapnia, igaz? Úgyhogy a function-t úgy fogjuk meghatározni, hogy `def post_detail(request, pk):`. Jegyezd meg, hogy pontosan ugyanazt a nevet kell használnunk, amit az url-ben jelöltünk meg (`pk`). A változó kihagyása helytelen, és hibát fog eredményezni!
 
-Most egyetlen egy blogbejegyzést akarunk szerezni. Ehhez egy ilyen queryset-et használhatunk:
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
 
-    Post.objects.get(pk=pk)
-    
-
-De ennél a kódnál van egy kis gond. Ha nincsen `Post` az adott `primary key`-vel (`pk`), akkor egy nagyon csúnya hibát kapunk!
+{% filename %}blog/views.py{% endfilename %}
 
-![DoesNotExist hiba][3]
+```python
+Post.objects.get(pk=pk)
+```
 
- [3]: images/does_not_exist2.png
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
 
-Mi ezt nem akarjuk! De, természetesen a Django-nak van valamije, ami ezt megoldja nekünk: `get_object_or_404`. Abban az esetben, ha nincsen `Post` az adott `pk`-val, akkor egy sokkal szebb oldalt ad ki (`Page Not Found 404` oldalt).
+![DoesNotExist hiba](images/does_not_exist2.png)
 
-![Az oldal nem található][4]
+Mi ezt nem akarjuk! De, természetesen a Django-nak van valamije, ami ezt megoldja nekünk: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
 
- [4]: images/404_2.png
+![Az oldal nem található](images/404_2.png)
 
 A jó hír az, hogy elkészítheted a saját `Page not found` oldaladat, és olyan szépre alakíthatod, amilyenre akarod. De ez nem olyan fontos egyelőre, úgyhogy átugorhatjuk.
 
-Oké, itt az idő, hogy hozzáadjuk a *view*-t a `views.py` fájlunkhoz!
+OK, time to add a *view* to our `views.py` file!
 
-Nyisd meg a `blog/views.py` fájlt és add hozzá a következő kódot:
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
 
-    from django.shortcuts import render, get_object_or_404
-    
+We should open `blog/views.py` and add the following code near the other `from` lines:
 
-A többi `from` sor mellé. És a fájl alján hozzáadjuk a *view*-t:
+{% filename %}blog/views.py{% endfilename %}
 
-    def post_detail(request, pk):
-        post = get_object_or_404(Post, pk=pk)
-        return render(request, 'blog/post_detail.html', {'post': post})
-    
+```python
+from django.shortcuts import render, get_object_or_404
+```
 
-Igen. Ideje frissíteni az oldalt: http://127.0.0.1:8000/
+And at the end of the file we will add our *view*:
 
-![Post list nézet][5]
+{% filename %}blog/views.py{% endfilename %}
 
- [5]: images/post_list2.png
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
 
-Sikerült! De mi történik, ha ráklikkelsz egy linkre a blog bejegyzés címében?
+Igen. Ideje frissíteni az oldalt: http://127.0.0.1:8000/
 
-![TemplateDoesNotExist hiba][6]
+![Post list nézet](images/post_list2.png)
 
- [6]: images/template_does_not_exist2.png
+Sikerült! De mi történik, ha ráklikkelsz egy linkre a blog bejegyzés címében?
+
+![TemplateDoesNotExist hiba](images/template_does_not_exist2.png)
 
 Jaj ne! Egy másik hiba! De már tudjuk, hogyan kezeljük, igaz? Létre kell hoznunk egy template-et!
 
-## Template a bejegyzés részleteihez
+## Create a template for the post details
 
 Létrehozunk egy fájlt a `blog/templates/blog` könyvtárban, és elnevezzük: `post_detail.html`.
 
 Ez fog történni:
 
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -158,13 +162,11 @@ Ez fog történni:
 
 Itt megint a `base.html`-t bővítjük ki. A `content` blokkban meg szeretnénk jeleníteni a bejegyzés címét, szövegét és a megjelenési idejét (published_date) - ha van. De pár fontos dolgot tisztáznunk kell még, igaz?
 
-{% raw %}`{% if ... %} ... {% endif %}` egy template tag, amit akkor használni, amikor ellenőrizni akarunk valamit (emlékszel az `if ... else ..` részre a **Bevezetés a Python-ba** fejezetnél?). Ebben az esetben azt akarjuk leellenőrizni, hogy a bejegyzés `published_date` eleme nem üres.{% endraw %}
-
-Ok, most már frissíthetjük az oldalunkat és kiderül, hogy a `Page not found` eltűnt.
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
 
-![Post részletei oldal][7]
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
 
- [7]: images/post_detail2.png
+![Post részletei oldal](images/post_detail2.png)
 
 Juppi! Működik!
 
@@ -172,6 +174,8 @@ Juppi! Működik!
 
 Jó lenne ellenőrizni, hogy még mindig működik-e a weboldalad a PythonAnywhere-en, igaz? Próbáld meg újra deployolni.
 
+{% filename %}command-line{% endfilename %}
+
     $ git status
     $ git add --all .
     $ git status
@@ -179,20 +183,15 @@ Jó lenne ellenőrizni, hogy még mindig működik-e a weboldalad a PythonAnywhe
     $ git push
     
 
-*   Aztán írd be ezt a [PythonAnywhere Bash konzol][8]ba:
+Aztán írd be ezt a [PythonAnywhere Bash konzol](https://www.pythonanywhere.com/consoles/)ba:
 
- [8]: https://www.pythonanywhere.com/consoles/
+{% filename %}command-line{% endfilename %}
 
     $ cd my-first-blog
-    $ source myvenv/bin/activate
-    (myvenv)$ git pull
-    [...]
-    (myvenv)$ python manage.py collectstatic
+    $ git pull
     [...]
     
 
-*   Végül menj a [Web tab][9]-ra, és nyomj **Reload**ot.
-
- [9]: https://www.pythonanywhere.com/web_app_setup/
+Végül menj a [Web tab](https://www.pythonanywhere.com/web_app_setup/)-ra, és nyomj **Reload**ot.
 
-Ennyi az egész. Gratulálunk :)
+Ennyi az egész. Gratulálunk :)
\ No newline at end of file
diff --git a/hu/how_the_internet_works/README.md b/hu/how_the_internet_works/README.md
index d5d2fb2069f..006f718c225 100644
--- a/hu/how_the_internet_works/README.md
+++ b/hu/how_the_internet_works/README.md
@@ -1,53 +1,47 @@
 # Hogy működik az Internet?
 
-> Ez a fejezet Jessica McKellar "Hogy működik az Internet" (How the Internet works) című előadásán alapul (http://web.mit.edu/jesstess/www/).
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
 
-Biztosan minden nap internetezel. Tudod, igazából mi történik, mikor beírod a böngésződben, hogy https://djangogirls.org, és `enter`t nyomsz?
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
 
 Az első dolog, amit fontos megérteni, hogy egy weboldal nem más, mint egy csomó fájl egy merevlemezre mentve. Olyanok, mint a filmjeid, a zenéid, vagy a képeid. De van valami, ami a weboldalakat egyedivé teszi: a HTML nevű számítógépes kód.
 
-Ha nem igazán ismered a programozást, akkor nehéz lehet megértened először a HTML-t, de ne aggódj, a böngésződ (Chrome, Safari, Firefox, stb.) imádja. A webböngészőket úgy tervezték, hogy megértsék ezt a kódot, kövessék azt, ami abban van, és megjelenítsenek mindent pont úgy, ahogy szeretnéd.
+Ha nem igazán ismered a programozást, akkor nehéz lehet megértened először a HTML-t, de ne aggódj a böngésződ (Chrome, Safari, Firefox, stb.) imádja. A webböngészőket úgy tervezték, hogy megértsék ezt a kódot, kövessék azt, ami abban van, és megjelenítsenek mindent pont úgy, ahogy szeretnéd.
 
-Mint minden fájlt, a HTML-t is merevlemezen kell tárolni. Az Internethez speciális, erős számítógépeket használunk, a *szervereket*. Ezekhez a gépekhez nem tartozik képernyő, egér vagy billentyűzet, mert a fő feladatuk az adatok tárolása és szolgáltatása. Ezért hívjuk őket *szervernek*, vagyis kiszolgálónak -- ők *szolgálják ki* neked az adatokat.
+Mint minden fájlt, a HTML-t is merevlemezen kell tárolni. Az Internethez speciális, erős számítógépeket használunk, a *szervereket*. Ezekhez a gépekhez nem tartozik képernyő, egér vagy billentyűzet, mert a fő feladatuk az adatok tárolása és szolgáltatása. That's why they're called *servers* – because they *serve* you data.
 
-Rendben, de hogy néz ki az Internet?
+OK, but you want to know how the Internet looks, right?
 
 Rajzoltunk neked egy képet! Így néz ki:
 
-![1.1 ábra][1]
+![1.1 ábra](images/internet_1.png)
 
- [1]: images/internet_1.png
+Elég zavaros, igaz? In fact it is a network of connected machines (the above-mentioned *servers*). Több százezer gép! Rengeteg kilométernyi kábel körös-körül a világon! Nézd meg Submarine Cable Map weboldalt (http://submarinecablemap.com), és látni fogod milyen bonyolult a net. Itt egy kép az oldalról:
 
-Elég zavaros, igaz? Valójában ez egymáshoz kapcsolódó gépek (az előbb emlegetett *szerverek*) hálózata. Több százezer gép! Rengeteg kilométernyi kábel körös-körül a világon! Nézd meg Submarine Cable Map weboldalt (http://submarinecablemap.com), és látni fogod milyen bonyolult a net. Itt egy kép az oldalról:
+![1.2 ábra](images/internet_3.png)
 
-![1.2 ábra][2]
-
- [2]: images/internet_3.png
-
-Lenyűgöző, igaz? Persze az képtelenség, hogy minden gép össze legyen kötve egymással, ami az Internethez csatlakozik. Ezért hogy elérhessünk egy gépet (például azt, ahol a https://djangogirls.org van elmentve), a kérésünket egy csomó különböző gépen át kell juttatni.
+Lenyűgöző, igaz? Persze az képtelenség, hogy minden gép össze legyen kötve egymással, ami az Internethez csatlakozik. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
 
 Így néz ki:
 
-![1.3 ábra][3]
+![1.3 ábra](images/internet_2.png)
 
- [3]: images/internet_2.png
-
-Képzeld el úgy, hogy amikor beírod a https://djangogirls.org címet, egy levelet írsz: "Kedves Django Girls, szeretném megnézni a djangogirls.org oldalt. Kérlek, küldd el nekem!"
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
 
 Először a leveled a hozzád legközelebbi postára megy. Ezután továbbhalad egy olyan postára, ami már kicsit közelebb van a címzettedhez, és így tovább, míg el nem jut a céljához. Az egyetlen egyedi dolog, hogy ha több levelet (*adatcsomagot*) küldesz ugyanarra a helyre, azok valószínűleg teljesen már postákon (*routers*) mennek keresztül. Ez csak attól függ hogyan osztják el az egyes irodákban.
 
-![1.4 ábra][4]
-
- [4]: images/internet_4.png
+![1.4 ábra](images/internet_4.png)
 
-Ennyire egyszerű! Elküldöd a levelet, és várod a választ. Persze papír és toll helyett adatok byte-jait küldöd, de az ötlet ugyanaz!
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
 
-Utcanév, házszám, város és irányítószám helyett IP-címeket használunk. A számítógéped először megkéri a DNS-t (Domain Name System, tartománynévrendszer), hogy fordítsa le a djangogirls.org-ot egy IP címre. Körülbelül úgy működik, mint amikor a régi telefonkönyvekből kikerested valakinek a telefonszámát, és a címét.
+Utcanév, házszám, város és irányítószám helyett IP-címeket használunk. A számítógéped először megkéri a DNS-t (Domain Name System, tartománynévrendszer), hogy fordítsa le a djangogirls.org-ot egy IP címre. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
 
-Amikor levelet küldesz, bizonyos dolgokra szükség van, hogy jó helyre szállítsák őket: kell lennie rajta címnek, bélyegnek, stb. Ráadásul olyan nyelven kell írnod, amit a címzett megért. Ugyanez vonatkozik az *adatcsomagokra*, amiket azért küldesz, mert meg szeretnél nézni egy weboldalt. A HTTP (Hypertext Transfer Protocol) protokollt használjuk erre.
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Ráadásul olyan nyelven kell írnod, amit a címzett megért. Ugyanez vonatkozik az *adatcsomagokra*, amiket azért küldesz, mert meg szeretnél nézni egy weboldalt. A HTTP (Hypertext Transfer Protocol) protokollt használjuk erre.
 
 Szóval, amikor van egy weboldalad, akkor szükséged van egy *szerverre* (gép), ahol az oldal lakik. Amikor a *szerver* kap egy beérkező *kérést* (egy levélben), akkor egy válaszban visszaküldi a weboldaladat (egy másik levélben).
 
-Mivel ez egy Django útmutató, felmerülhet benned a kérdés, hogy a Django ebben a folyamatban milyen szerepet tölt be. Amikor küldesz egy választ, nem mindig pont ugyanazt küldöd mindenkinek. Sokkal jobb, ha a levelek személyesek, főleg, ha annak az embernek szólnak, akinek válaszolsz, nem igaz? A Django segít, hogy személyes és érdekes leveleket írhass :).
+Since this is a Django tutorial, you might ask what Django does. Amikor küldesz egy választ, nem mindig pont ugyanazt küldöd mindenkinek. Sokkal jobb, ha a levelek személyesek, főleg, ha annak az embernek szólnak, akinek válaszolsz, nem igaz? A Django segít, hogy személyes és érdekes leveleket írhass. :)
 
-De elég a beszédből, munkára fel!
\ No newline at end of file
+Enough talk – time to create!
\ No newline at end of file
diff --git a/hu/html/README.md b/hu/html/README.md
index cb4e60bd7cb..4a0ea81ad24 100644
--- a/hu/html/README.md
+++ b/hu/html/README.md
@@ -2,13 +2,13 @@
 
 Mi az a template, kérdezhetnéd?
 
-A template egy fájl, amit újrahasznosíthatunk, hogy különböző információkat jeleníthessünk meg egységes formában - például, egy template-et használhatsz egy levél megírásakor, ahol ugyan a levelek tartalma eltérhet, és a címzettek is különbözőek lehetnek, de a formájuk azonos.
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
 
-A Django template formátumát egy nyelvvel írjuk le, amit HTML-nek hívunk (ez az a HTML, amit a **Hogy működik az Internet?** fejezetben már említettünk).
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
 
 ## Mi a HTML?
 
-A HTML egy egyszerű kód, amit a böngésződ értelmez (pl.: Chrome, Firefox, vagy Safari), hogy weboldalakat jelenítsen meg a felhasználóknak.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
 A HTML a "HyperText Markup Language" rövidítése. A **HyperText** egy olyan szöveg, amely támogatja a hiperhivatkozásokat oldalak között. A **Markup** azt jelenti, hogy egy dokumentumot kód segítségével jelölésekkel látunk el, hogy leírjuk (ebben az esetben a böngészőnek) hogyan értelmezhető a weboldal. A HTML kód **tagekből** épül fel, amelyek mindegyike `<` jellel kezdődik, és `>` jellel végződik. Ezek a tagek reprezentálják a jelölő **elemeket**.
 
@@ -23,51 +23,51 @@ A template-eket a `blog/templates/blog` mappába mentjük. Először hozd létre
         └───blog
     
 
-(Meglepő lehet, hogy miért van szükség két `blog` nevű mappára - később majd rájössz, hogy ez egy hasznos elnevezési konvenció, ami megkönnyíti az életedet, amikor a dolgok bonyolulttá válnak.)
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
 
 Ezután hozd létre a `post_list.html` fájlt (egyelőre hagyd üresen) a `blog/templates/blog` mappában.
 
 Nézd meg, hogy néz ki most a weboldal: http://127.0.0.1:8000/
 
-> Ha továbbra is a `TemplateDoesNotExists` hibát kapod, akkor próbáld újraindítani a szervert. Menj a parancssorba, állítsd meg a szervert a Ctrl+C megnyomásával (a Control és C gombot egyszerre nyomd meg), és indítsd el újra a `python manage.py runserver` paranccsal.
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
 
-![11.1 ábra][1]
-
- [1]: images/step1.png
+![11.1 ábra](images/step1.png)
 
 Nincs több hiba! Ügyes vagy :) Azonban a weboldalad csak egy üres oldalt jelenít meg, mivel a template is üres, amit készítettél. Ezt ki kell javítanunk.
 
 Add hozzá az alábbi sorokat a template fájlodhoz:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <p>Hi there!</p>
     <p>It works!</p>
 </html>
-```    
-
-Szóval, hogy néz ki most a weboldalad? Kattints és nézd meg: http://127.0.0.1:8000/
+```
 
-![11.2 ábra][2]
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
 
- [2]: images/step3.png
+![11.2 ábra](images/step3.png)
 
 Működik! Szép munka :)
 
-*   A legalapvetőbb tag a `<html>`, amely minden weboldal elejére kerül, míg a `</html>` a végén szerepel. Láthatod, hogy a weboldal tartalma a kezdő `<html>` tag, és a záró `</html>` tag közé kerül
-*   A `<p>` tag a bekezdés (paragrafus) elem; `</p>` zárja a bekezdéseket
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. Láthatod, hogy a weboldal tartalma a kezdő `<html>` tag, és a záró `</html>` tag közé kerül
+* A `<p>` tag a bekezdés (paragrafus) elem; `</p>` zárja a bekezdéseket
 
-## Head és body
+## Head and body
 
 Minden HTML oldalt két elemre osztunk: **head** és **body**.
 
-*   A **head** elem információkat tartalmaz a dokumentumról, amit nem jelenítünk meg a képernyőn.
+* A **head** elem információkat tartalmaz a dokumentumról, amit nem jelenítünk meg a képernyőn.
 
-*   A **body** elem tartalmaz minden mást, ami a weboldalon jelenik meg.
+* A **body** elem tartalmaz minden mást, ami a weboldalon jelenik meg.
 
 A `<head>` elemet használjuk arra, hogy az oldal konfigurációs beállításait megadjuk a böngészőnek, és a `<body>` elemet arra, hogy leírjuk mi jelenjen meg az oldalon.
 
-Például a weboldal title elemét rakhatjuk a `<head>`-be:
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -83,9 +83,7 @@ Például a weboldal title elemét rakhatjuk a `<head>`-be:
 
 Mentsd el a fájlt, és frissítsd az oldalt.
 
-![11.3 ábra][3]
-
- [3]: images/step4.png
+![11.3 ábra](images/step4.png)
 
 Észrevetted, hogyan ismerte fel a böngésző, hogy az "Ola's blog" az oldal címe? Értelmezte a `<title>Ola's blog</title>` kódot, és a szöveget a böngésző cím mezőjébe rakta (ezt fogja használja könyvjelzőnek is, és így tovább).
 
@@ -93,24 +91,26 @@ Valószínűleg azt is észrevetted, hogy minden nyitó taghez tartozik egy *zá
 
 Ez éppen olyan mintha különböző dolgokat tennénk dobozokba. Van egy nagy dobozod, a `<html></html>`; ebben benne van a `<body></body>`, és ez egy újabb kisebb dobozt tartalmaz: `<p></p>`.
 
-Követned kell a *záró* tagekre, és az *egymásba ágyazható* elemekre vonatkozó szabályokat - ha nem teszed, a böngésző nem tudja majd értelmezni a kódodat megfelelően, és az oldalad hibásan jelenik majd meg.
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
 
 ## Változtasd meg a template-edet
 
 Most szórakozásképpen próbáld módosítani a template-edet! Itt van néhány hasznos tag ehhez:
 
-*   `<h1>A heading</h1>` - a legfontosabb címedhez
-*   `<h2>A sub-heading</h2>` cím a következő szintre
-*   `<h3>A sub-sub-heading</h3>` ... és így tovább, egészen `<h6>`-ig
-*   `<p>Egy bekezdésnyi szöveg</p>`
-*   `<em>text</em>` dőlt szöveghez
-*   `<strong>text</strong>` a szöveg kiemeléséhez
-*   `<br />` új sor kezdéséhez (nem mindenhová rakhatsz br-t)
-*   `<a href="https://djangogirls.org">link</a>` létrehoz egy linket
-*   `<ul><li>first item</li><li>second item</li></ul>` létrehoz egy listát, akárcsak ezt itt!
-*   `<div></div>` az oldal szakaszainak megadásához
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` cím a következő szintre
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` dőlt szöveghez
+* `<strong>text</strong>` a szöveg kiemeléséhez
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` létrehoz egy linket
+* `<ul><li>first item</li><li>second item</li></ul>` létrehoz egy listát, akárcsak ezt itt!
+* `<div></div>` az oldal szakaszainak megadásához
 
-Itt a példa egy teljes template-re, másold be a `blog/templates/blog/post_list.html` file-ba:
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -119,7 +119,7 @@ Itt a példa egy teljes template-re, másold be a `blog/templates/blog/post_list
     </head>
     <body>
         <div>
-            <h1><a href="">Django Girls Blog</a></h1>
+            <h1><a href="/">Django Girls Blog</a></h1>
         </div>
 
         <div>
@@ -139,18 +139,16 @@ Itt a példa egy teljes template-re, másold be a `blog/templates/blog/post_list
 
 Három `div` elemet hoztunk létre.
 
-*   Az első `div` tartalmazza a blogunk címét - ez egy cím, és egy link
-*   A másik két `div` elem a blog posztjainkat tárolja a publikálás dátumával - egy `h2` van benne a poszt címével, ami kattintható, emellett `p` bekezdések a dátumnak, és a szövegnek.
+* The first `div` element contains the title of our blog – it's a heading and a link
+* A másik két `div` elem a blog posztjainkat tárolja a publikálás dátumával - egy `h2` van benne a poszt címével, ami kattintható, emellett `p` bekezdések a dátumnak, és a szövegnek.
 
 Ennek kell megjelenni:
 
-![11.4 ábra][4]
-
- [4]: images/step6.png
+![11.4 ábra](images/step6.png)
 
-Yaaay! A template eddig pontosan **ugyanazt az infót** jeleníti meg - viszont korábban arról volt szó, hogy egy template-tel **különböző** információkat jeleníthetünk meg **azonos formában**.
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
 
-Amit igazából szeretnénk, hogy igazi posztokat jelenítünk meg, amiket a Django adminon adunk hozzá - nemsokára ezt is megnézzük.
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
 
 ## Még egy dolog: deploy!
 
@@ -160,48 +158,56 @@ Jó lenne lenne látni ezt az egészet élesben az interneten, ugye? Csináljunk
 
 Először nézzük meg, hogy milyen fájlok változtak a legutóbbi deploy óta (futtasd az alábbi parancsot a gépeden, ne PythonAnywhere-en):
 
+{% filename %}command-line{% endfilename %}
+
     $ git status
     
 
 A `djangogirls` mappában kell lenned, és a `git`-tel add hozzá az összes változtatást a könyvtáradon belül:
 
+{% filename %}command-line{% endfilename %}
+
     $ git add --all .
     
 
-> **Megjegyzés** `-a` (az "all" rövidítése) azt jelenti, hogy a `git` felismeri, ha fájlokat törölsz (alapból csak az új, és módosított fájlokat ismeri fel). Korábban már volt róla szó (a 3. fejezetben), hogy a `.` az aktuális mappát jelenti.
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Korábban már volt róla szó (a 3. fejezetben), hogy a `.` az aktuális mappát jelenti.
 
 Mielőtt továbbmegyünk ellenőrizzük, hogy a `git` mit szeretne feltölteni (zölddel jelennek meg azok a fájlok, amiket a `git` fel akar tölteni):
 
+{% filename %}command-line{% endfilename %}
+
     $ git status
     
 
 Már majdnem készen is vagyunk, de előtte el kell mentenünk a változtatásokat az előzményekbe. Egy "commit message"-et adunk meg, ahol leírjuk, hogy mit változtattunk. Akármit beírhatsz, de később hasznos lehet, ha valami olyat adsz meg, ami segít beazonosítani, hogy mit csináltál.
 
+{% filename %}command-line{% endfilename %}
+
     $ git commit -m "Changed the HTML for the site."
     
 
 > **Megjegyzés** Győződj meg róla, hogy idézőjelet használsz a commit üzenetnél.
 
-Miután ezzel megvagy, töltsd fel (push) a változtatásaidat Github-ra:
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
 
     $ git push
     
 
 ### Pullold az új kódot PythonAnywhere-re, és frissítsd az oldalt
 
-*   Nyisd meg a [PythonAnywhere konzol oldalát][5] és menj a **Bash console**-odra (vagy indíts egy újat). Aztán futtasd ezt:
+* Nyisd meg a [PythonAnywhere konzol oldalát](https://www.pythonanywhere.com/consoles/) és menj a **Bash console**-odra (vagy indíts egy újat). Aztán futtasd ezt:
 
- [5]: https://www.pythonanywhere.com/consoles/
+{% filename %}command-line{% endfilename %}
 
     $ cd ~/my-first-blog
-    $ source myvenv/bin/activate
-    (myvenv)$ git pull
+    $ git pull
     [...]
+    
 
 A fájljaid már itt is vannak. Ha le akarod csekkolni, akkor menj át a **Files tab**-ra és nézd meg a kódodat PythonAnywhere-en.
 
-*   Végül, kattints át a [Web tab][6]-ra, és nyomj egy **Reload**-ot a web alkalmazásodra.
-
- [6]: https://www.pythonanywhere.com/web_app_setup/
+* Végül, kattints át a [Web tab](https://www.pythonanywhere.com/web_app_setup/)-ra, és nyomj egy **Reload**-ot a web alkalmazásodra.
 
-A frissítéseid kint vannak! Frissítsd az weboldalt a böngésződben, és a változtatások már látni fogod :)
\ No newline at end of file
+A frissítéseid kint vannak! Frissítsd az weboldalt a böngésződben, és a változtatások már látni fogod. :)
\ No newline at end of file
diff --git a/hu/install_git.md b/hu/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/hu/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/hu/installation/README.md b/hu/installation/README.md
index a3802d348ce..1b383fe8b3b 100644
--- a/hu/installation/README.md
+++ b/hu/installation/README.md
@@ -1,10 +1,10 @@
 # Ha otthon csinálod a tutorialt
 
-Ha otthon csinálod a tutorialt, nem valamelyik [Django Girls eseményen](https://djangogirls.org/events/), át is ugorhatod ezt a fejezetet, és folytathatod a [Hogy működik az Internet?](../how_the_internet_works/README.md) fejezettel.
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
 
-Ez az oldal csak egy helyre gyűjti az installációk leírását, amikkel később úgyis találkozni fogsz a tutorial során. A Django Girls workshopok előtt mindig van egy installációs esemény, amikor mindent telepítünk, hogy a workshopon már ne kelljen ezzel bajlódni, ezért hasznos nekünk, hogy mindent megtalálunk egy helyen.
+Ez az oldal csak egy helyre gyűjti az installációk leírását, amikkel később úgyis találkozni fogsz a tutorial során. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
 
-Ha te is hasznosnak találod, nyugodtan elvégezheted ezt a fejezetet. De ha inkább fejest szeretnél ugrani a tanulásba, mielőtt egy csomó mindent telepítenél a gépedre, nyugodtan ugord át a fejezetet! Később úgyis elmagyarázzuk az összes telepítést.
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
 
 Sok szerencsét!
 
@@ -12,6 +12,11 @@ Sok szerencsét!
 
 A workshopon egy blogot fogsz elkészíteni. Ehhez el kell végezned néhány telepítési feladatot, hogy a workshop napján már egyből elkezdhess kódolni.
 
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
 # A Python telepítése
 
 {% include "/python_installation/instructions.md" %}
@@ -22,7 +27,7 @@ A workshopon egy blogot fogsz elkészíteni. Ehhez el kell végezned néhány te
 
 # Kódszerkesztő telepítése
 
-{% include "/code_editor/instructions.md" %}
+{% include "code_editor/instructions.md" %}
 
 # A Git telepítése
 
@@ -38,12 +43,16 @@ Menj a [GitHub.com](https://www.github.com) oldalra, és hozz létre egy új, in
 
 # Kezdheted az olvasást
 
-Gratulálunk, készen állsz a tutorialra! Ha van egy kis időd a workshop előtt, hasznos lehet, ha elolvasod az első néhány fejezetet:
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [Hogy működik az Internet](../how_the_internet_works/README.md)
+
+* [Bevezetés a parancsssor használatába](../intro_to_command_line/README.md)
 
-  * [Hogy működik az Internet](../how_the_internet_works/README.md)
+* [Bevezetés a Pythonba](../python_introduction/README.md)
 
-  * [Bevezetés a parancsssor használatába](../intro_to_command_line/README.md)
+* [Mi a Django?](../django/README.md)
 
-  * [Bevezetés a Pythonba](../python_introduction/README.md)
+# Enjoy the workshop!
 
-  * [Mi a Django?](../django/README.md)
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/hu/instructions.md b/hu/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/hu/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/hu/intro_to_command_line/README.md b/hu/intro_to_command_line/README.md
index 7d5f170f0ce..dd774c7f033 100644
--- a/hu/intro_to_command_line/README.md
+++ b/hu/intro_to_command_line/README.md
@@ -1,37 +1,40 @@
 # Bevezetés a parancssor használatába
 
-Ez nagyon izgalmas, igaz?! Pár percen belül megírod az első kódsorodat :)
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
 
 **Hadd mutassuk be neked az első új barátodat: a parancssort!**
 
 A következő lépésekben megmutatjuk neked, hogyan használd azt a fekete ablakot úgy, ahogy az összes hacker használja. Első ránézésre kissé ijesztőnek tűnhet, de valójában csak egy egyszerű parancsot vár tőled.
 
-> **Megjegyzés** A könyvben felváltva használjuk a 'könyvtár' és 'mappa' ('directory' és 'folder') szavakat, de ezek pont ugyanazt jelentik.
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
 
 ## Mi az a parancssor?
 
-A **parancssor** (command line, vagy **command-line interface**) nevű ablak egy szöveges alapú alkalmazás, amit arra használhatsz, hogy fájlokat tekinthess meg, szerkeszthess, és különböző műveleteket végezhess rajtuk. Olyasmi, mint a Windows Explorer, vagy Mac gépeken a Finder, de a grafikus felület nélkül. Egyéb megnevezések a parancssorra: *konzol*, *terminál*, *cmd*, *CLI*, *prompt*.
+A **parancssor** (command line, vagy **command-line interface**) nevű ablak egy szöveges alapú alkalmazás, amit arra használhatsz, hogy fájlokat tekinthess meg, szerkeszthess, és különböző műveleteket végezhess rajtuk. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Egyéb megnevezések a parancssorra: *konzol*, *terminál*, *cmd*, *CLI*, *prompt*.
 
 ## A parancssor megnyitása
 
 Hogy belevághass a kísérletezésbe, először meg kell nyitnod a parancssort.
 
-<!--sec data-title="Windows" data-id="windows_prompt" data-collapse=true ces-->
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
 
-Start menu → All Programs → Accessories → Command Prompt.
+Go to Start menu → Windows System → Command Prompt.
 
-<!--endsec-->
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
 
+<!--endsec-->
 
-<!--sec data-title="OS X" data-id="OSX_prompt" data-collapse=true ces-->
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
 
-Applications → Utilities → Terminal.
+Go to Applications → Utilities → Terminal.
 
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="linux_prompt" data-collapse=true ces-->
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
 
-Valószínűleg itt találod meg: Applications → Accessories → Terminal, de ez a rendszeredtől függ. Ha nincs ott, csak keress rá a Google-n :)
+Valószínűleg itt találod meg: Applications → Accessories → Terminal, de ez a rendszeredtől függ. Ha nincs ott, csak keress rá a Google-n. :)
 
 <!--endsec-->
 
@@ -39,65 +42,69 @@ Valószínűleg itt találod meg: Applications → Accessories → Terminal, de
 
 Egy fehér vagy fekete ablakot kell látnod, ami csak a te parancsaidra vár.
 
-<!--sec data-title="OS X és Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
 
 Ha Mac-ed vagy Linux-od van, valószínűleg egy `$`-t kell látnod:
 
+{% filename %}command-line{% endfilename %}
+
     $
     
 
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_prompt2" data-collapse=true ces-->
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
 
 A Windows-on ez egy `>` jel:
 
+{% filename %}command-line{% endfilename %}
+
     >
     
-<!--endsec-->
 
+<!--endsec-->
 
-Minden sornak ezzel a jellel és az azt követő space-el kell kezdődnie, de ezt nem neked kell begépelned. A számítógéped megteszi helyetted :)
+Minden sornak ezzel a jellel és az azt követő space-el kell kezdődnie, de ezt nem neked kell begépelned. A számítógéped megteszi helyetted. :)
 
-> Csak egy gyors megjegyzés: így is kinézhet a parancssorod: `C:\Users\ola>` vagy `Olas-MacBook-Air:~ ola$`, és ez teljesen jó így. Ebben az útmutatóban csak próbáljuk a lehető leginkább leegyszerűsíteni.
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
 
-A sor elején lévő rész, a  `$` vagy `>` karakterig (azt is beleértve) a *parancssori prompt* vagy röviden *prompt* a neve. Azt jelzi, hogy a számítógép a te utasításodra vár.
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
 
-A tutorial során, amikor egy parancsot kell beírnod, ki fogjuk írni a `$` vagy `>` karaktert, és olykor még bővebb promptot. Nyugodtan hagyd figyelmen kívül a baloldali részt, és csak a prompt után kezdődő parancsot gépeld be.
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
 
 ## Az első parancsod (YAY!)
 
-Kezdjük valami egyszerűvel. Gépeld be ezt a parancsot:
+Let's start by typing this command:
 
-<!--sec data-title="OS X és Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
 
-{% filename %}parancssor{% endfilename %}
-```
-$ whoami
-```
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
 
 <!--endsec-->
 
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
 
-<!--sec data-title="Windows" data-id="windows_whoami" data-collapse=true ces-->
+{% filename %}command-line{% endfilename %}
 
-{% filename %}parancssor{% endfilename %}
-```
-> whoami
-```
+    > whoami
+    
 
 <!--endsec-->
-    
 
 Majd nyomj `enter`t. Ezt az eredményt kapod:
 
+{% filename %}command-line{% endfilename %}
+
     $ whoami
     olasitarska
     
 
-Amint láthatod, a számítógéped az előbb kiírta a felhasználónevedet. Jó, mi?:)
+Amint láthatod, a számítógéped az előbb kiírta a felhasználónevedet. Jó, mi? :)
 
-> Próbálj meg minden parancsot begépelni, ahelyett, hogy innen másolnád ki. Így többet fogsz megjegyezni!
+> Try to type each command; do not copy-paste. You'll remember more this way!
 
 ## Az alapok
 
@@ -107,40 +114,41 @@ Minden operációs rendszer parancssora kissé különböző prancsokat igényel
 
 Jó lenne tudni, hogy most hol vagyunk, nem? Nézzük. Írd be ezt a parancsot, és nyomj `enter`t:
 
-<!--sec data-title="OS X és Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
 
-{% filename %}parancssor{% endfilename %}
-```
-$ pwd
-/Users/olasitarska
-```
+{% filename %}command-line{% endfilename %}
 
-> Megjegyzés: a 'pwd' jelentése: 'print working directory' ('munkakönyvtár kiírása').
+    $ pwd
+    /Users/olasitarska
+    
+
+> Megjegyzés: a 'pwd' jelentése: 'print working directory'.
 
 <!--endsec-->
 
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-<!--sec data-title="Windows" data-id="windows_cd" data-collapse=true ces-->
+    > cd
+    C:\Users\olasitarska
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-> cd
-C:\Users\olasitarska
-```
-> Megjegyzés: a 'cd' jelentése: 'change directory' ('könyvtár váltása'). Ha powershell-t használsz, használhatod a pwd parancsot is, mint Linuxon vagy Mac OS X-en.
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
 
 <!--endsec-->
 
-
 Valószínűleg valami hasonlót fogsz látni a gépeden. Amikor megnyitod a parancssort, általában a felhasználó 'home' könyvtárába kerülsz.
 
 * * *
 
 ### Fájlok és könyvtárak kilistázása
-    
+
 És mi van benne? Szuper lenne kideríteni. Nézzük meg:
 
-<!--sec data-title="OS X és Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ ls
     Applications
@@ -149,9 +157,12 @@ Valószínűleg valami hasonlót fogsz látni a gépeden. Amikor megnyitod a par
     Music
     ...
     
+
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_dir" data-collapse=true ces-->
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > dir
      Directory of C:\Users\olasitarska
@@ -161,7 +172,8 @@ Valószínűleg valami hasonlót fogsz látni a gépeden. Amikor megnyitod a par
     05/08/2014 07:28 PM <DIR>      Music
     ...
     
-<!--endsec-->
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
 
 * * *
 
@@ -169,47 +181,49 @@ Valószínűleg valami hasonlót fogsz látni a gépeden. Amikor megnyitod a par
 
 Most pedig lépjünk be a Desktop (vagy Asztal) mappába:
 
-<!--sec data-title="OS X és Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-$ cd Desktop
-```
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_move_to" data-collapse=true ces-->
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
 
+{% filename %}command-line{% endfilename %}
 
-{% filename %}parancssor{% endfilename %}
-```
-> cd Desktop
-```
-<!--endsec-->
+    > cd Desktop
     
 
+<!--endsec-->
+
 Nézzük meg, hogy tényleg megváltozott-e:
 
-<!--sec data-title="OS X és Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-$ pwd
-/Users/olasitarska/Desktop
-```
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_cd2" data-collapse=true ces-->
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-> cd
-C:\Users\olasitarska\Desktop
-```
 <!--endsec-->
 
 Itt is van!
 
-> PRO tipp: ha begépeled a `cd D`-t (vagy ha magyarul használod az operációs rendszeredet, és 'Asztal'-nak hívják a könyvtáradat, a `cd A`-t) és ezután megnyomod a <0>tab</0>-ot, a parancssor automatikusan kiegészíti a nevet, lehetővé téve számodra a gyorsabb navigálást. Amennyiben több mappa is kezdődik ugyanazzal a betűvel, nyomd meg kétszer a `tab`-ot, hogy kilistázza a több opciót.
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
 
 * * *
 
@@ -217,24 +231,25 @@ Itt is van!
 
 Mit szólnál, ha létrehoznánk egy gyakorló (practice) könyvtárat az asztalon? Így tudod megtenni:
 
-<!--sec data-title="OS X és Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-$ mkdir practice
-```
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_mkdir" data-collapse=true ces-->
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
+    > mkdir practice
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-> mkdir practice
-```
 <!--endsec-->
 
-Ez a parancs létre fog hozni egy `practice` nevű mappát az asztalodon. Ha megnézed az asztalt, meggyőződhetsz róla, hogy tényleg ott van-e, de a `ls` vagy `dir` paranccsal is megteheted! Próbáld ki :)
+Ez a parancs létre fog hozni egy `practice` nevű mappát az asztalodon. Ha megnézed az asztalt, meggyőződhetsz róla, hogy tényleg ott van-e, de a `ls` vagy `dir` paranccsal is megteheted! Próbáld ki. :)
 
 > PRO tipp: Ha nem szeretnéd újra és újra ugyanazt a parancsot begépelni, próbáld meg a `felfele` és `lefele nyilakkal` behívni a legutóbb futtatott parancsokat.
 
@@ -242,34 +257,34 @@ Ez a parancs létre fog hozni egy `practice` nevű mappát az asztalodon. Ha meg
 
 ### Feladat!
 
-Egy kis kihívás: hozz létre egy `test` nevű mappát a frissen elkészített `practice` könyvtáradban. Használd a `cd` és `mkdir` parancsokat.
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
 
 #### Megoldás:
 
-<!--sec data-title="OS X és Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-$ cd practice
-$ mkdir test
-$ ls
-test
-```
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_test_dir" data-collapse=true ces-->
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
 
+{% filename %}command-line{% endfilename %}
 
-{% filename %}parancssor{% endfilename %}
-```
-> cd practice
-> mkdir test
-> dir
-05/08/2014 07:28 PM <DIR>      test
-```
-<!--endsec-->
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
     
 
+<!--endsec-->
+
 Gratulálunk! :)
 
 * * *
@@ -280,113 +295,114 @@ Nem szeretnénk káoszt hagyni magunk után, szóval töröljünk le mindent, am
 
 Először vissza kell mennünk az Asztal-ra:
 
-<!--sec data-title="OS X és Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-$ cd ..
-```
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_back" data-collapse=true ces-->
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
 
+{% filename %}command-line{% endfilename %}
 
-{% filename %}parancssor{% endfilename %}
-```
-> cd ..
-```
-<!--endsec-->
+    > cd ..
     
 
-Ha a `cd` parancsot `..`-tal használod, a jelenlegi könyvtárból a parent (szülő) könyvtárba jutsz (ez az a mappa, ami tartalmazza azt a mappát, ahol éppen vagy).
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
 
 Ellenőrizzük le, hogy hol vagyunk:
 
-<!--sec data-title="OS X és Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-$ pwd
-/Users/olasitarska/Desktop
-```
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_cd3" data-collapse=true ces-->
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
 
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-> cd
-C:\Users\olasitarska\Desktop
-```
 <!--endsec-->
 
 Most pedig itt az ideje, hogy kitöröljük a `practice` könyvtárat:
 
-> **Figyelem**: A fájlok törlése a `del`, `rmdir`, vagy a `rm` parancsokkal visszafordíthatatlan, tehát a *törölt fájlok örökre eltűnnek*! Legyél nagyon óvatos ezzel a paranccsal.
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
 
-<!--sec data-title="OS X és Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-$ rm -r practice
-```
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_rmdir" data-collapse=true ces-->
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
 
+{% filename %}command-line{% endfilename %}
 
-{% filename %}parancssor{% endfilename %}
-```
-> rmdir /S practice
-practice, Are you sure <Y/N>? Y
-```
-<!--endsec-->
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
     
 
+<!--endsec-->
+
 Kész! Ellenőrizzük le, hogy tényleg megtörtént-e:
 
-<!--sec data-title="OS X és Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-$ ls
-```
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_dir2" data-collapse=true ces-->
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
 
+{% filename %}command-line{% endfilename %}
 
-{% filename %}parancssor{% endfilename %}
-```
-> dir
-```
-<!--endsec-->
+    > dir
     
 
+<!--endsec-->
+
 ### Kilépés
 
-Ennyi volt! Most már biztonságosan kiléphetsz a parancssorból. Csináljuk hacker módra, jó?:)
+Ennyi volt! Most már biztonságosan kiléphetsz a parancssorból. Csináljuk hacker módra, jó? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-<!--sec data-title="OS X és Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+    $ exit
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-$ exit
-```
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_exit" data-collapse=true ces-->
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
 
+{% filename %}command-line{% endfilename %}
 
-{% filename %}parancssor{% endfilename %}
-```
-> exit
-```
-<!--endsec-->
+    > exit
     
 
-Szuper, nem? :)
+<!--endsec-->
+
+Cool, huh? :)
 
 ## Összefoglaló
 
@@ -394,19 +410,19 @@ Egy kis összefoglalás néhány hasznos parancsról:
 
 | Parancs (Windows) | Parancs (Mac OS/Linux) | Leírás                        | Példa                                             |
 | ----------------- | ---------------------- | ----------------------------- | ------------------------------------------------- |
-| exit              | exit                   | az ablak bezárása             | **exit**                                          |
+| kilépés           | kilépés                | az ablak bezárása             | **kilépés**                                       |
 | cd                | cd                     | könyvtár megváltoztatása      | **cd test**                                       |
+| cd                | pwd                    | show the current directory    | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
 | dir               | ls                     | könyvtárak/fájlok kilistázása | **dir**                                           |
 | copy              | cp                     | fájl másolása                 | **copy c:\test\test.txt c:\windows\test.txt** |
 | move              | mv                     | fájl mozgatása                | **move c:\test\test.txt c:\windows\test.txt** |
 | mkdir             | mkdir                  | új könyvtár létrehozása       | **mkdir testdirectory**                           |
-| del               | rm                     | könyvtár/fájl törlése         | **del c:\test\test.txt**                        |
+| rmdir (or del)    | rm                     | delete a file                 | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                  | delete a directory            | **rm -r testdirectory**                           |
 
 Ez csak néhány parancs, azok közül, amiket a parancssorban futtathatsz, de ma nem lesz szükséged ennél többre.
 
-Ha kíváncsi vagy, a [ss64.com][1] oldalon megtalálod az összes parancsot bármelyik operációs rendszerre.
-
- [1]: http://ss64.com
+Ha kíváncsi vagy, a [ss64.com](http://ss64.com) oldalon megtalálod az összes parancsot bármelyik operációs rendszerre.
 
 ## Kész vagy?
 
diff --git a/hu/python_installation/README.md b/hu/python_installation/README.md
index 8dc956f79b9..c6744c65e39 100644
--- a/hu/python_installation/README.md
+++ b/hu/python_installation/README.md
@@ -4,10 +4,12 @@ Végre itt vagyunk!
 
 Először is hadd mondjuk el, hogy mi is a Python. A Python egy nagyon népszerű programnyelv, amit weboldalkészítéshez, játékokhoz, tudományos szoftverekhez, grafikához és még csomó minden másra használnak.
 
-A Pythont a 80-as évek végén alkották meg, és a fő cél az volt, hogy ne csak gépek, hanem emberek számára is olvasható legyen. Ezért néz ki sokkal egyszerűbbnek, mint más programnyelvek. Ez könnyebbé teszi a tanulást, de ne aggódj, a Python igencsak erőteljes nyelv!
+A Pythont a 80-as évek végén alkották meg, és a fő cél az volt, hogy ne csak gépek, hanem emberek számára is olvasható legyen. This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
 
 # A Python telepítése
 
-> **Megjegyzés** Ha már elvégezted az Installáció fejezetet, nem kell újra megtenned - ugorj a következő fejezetre!
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
 
-{% include "/python_installation/instructions.md" %}
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/hu/python_installation/instructions.md b/hu/python_installation/instructions.md
index 0b6425f89e7..86b20a183a6 100644
--- a/hu/python_installation/instructions.md
+++ b/hu/python_installation/instructions.md
@@ -1,79 +1,106 @@
-> Ez a fejezet a Geek Girls Carrots (https://github.com/ggcarrots/django-carrots) tutorialján alapszik
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
 
-A Django Python nyelven íródott. Ahhoz, hogy bármit létrehozhassunk a Django-ban, szükségünk van a Pythonra is. Kezdjük a telepítésével! Azt szeretnénk, hogy a Python 3.6-es verziója legyen telepítve -- ha ennél korábbi verzióval rendelkezel, akkor frissítened kell.
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
 
-<!--sec data-title="Windows" data-id="python_windows" data-collapse=true ces-->
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
 
-A Python-t az alábbi weboldalról tudod letölteni: https://www.python.org/downloads/release/python-343/. Az ***.msi** fájlt a letöltés után futtasd (dupla kattintás), és kövesd az utasításokat. Fontos, hogy emlékezz a path-ra (könyvtárra), ahova letöltötted. Később szükséged lesz rá!
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
 
-Egy fontos dolog, amire figyelj oda: a telepítővarázsló második képernyőjén ("Customize") görgess lejjebb, és válaszd ki az "Add python.exe to the Path" opciót, ahogy itt láthatod:
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
 
-![Ne felejtsd el hozzáadni a Pythont a Path-hoz](../python_installation/images/add_python_to_windows_path.png)
+![Ne felejtsd el hozzáadni a Pythont a Path-hoz](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
 
 <!--endsec-->
 
-<!--sec data-title="OS X" data-id="python_OSX"
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
 data-collapse=true ces-->
 
-> **Megjegyzés** Mielőtt telepítenéd a Pythont OS X-en, bizonyosodj meg arról hogy a Mac beállításaid megengedik olyan csomagok telepítését, amelyek nem az App Store-ból származnak. Nyisd meg a System Preferences ablakot (az Applications mappában), kattints a "Security & Privacy" gombra majd a "General" fülre. Ha az "Allow apps downloaded from:" beállítás "Mac App Store"-ra van állítva, állítsd át "Mac App Store and identified developers"-ra.
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
 
-Menj a https://www.python.org/downloads/release/python-343/ oldalra, és töltsd le a Python installert:
+Menj fel az alábbi honlapra: https://www.python.org/downloads/release/python-361/ és töltsd le a Python telepítőt:
 
-  * Töltsd le a *Mac OS X 64-bit/32-bit installer* fájlt,
-  * Kattints duplán a *python-3.4.3-macosx10.6.pkg*-re, hogy futtasd a telepítőt.
+* Töltsd le a *Mac OS X 64-bit/32-bit installer* fájlt,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
 
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="python_linux"
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
 data-collapse=true ces-->
 
 Nagyon valószínű, hogy a Python már telepítve van a gépedre. Ahhoz, hogy ezt leellenőrizd (illetve hogy megnézd, melyik verzió van a gépeden), nyisd meg a konzolt és írd be az alábbi parancsot:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 --version
-    Python 3.4.3
+    Python 3.6.1
     
 
-Ha még nincs Pythonod, vagy másik verziót szeretnél telepíteni, így teheted meg:
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. Ha még nincs Pythonod, vagy másik verziót szeretnél telepíteni, így teheted meg:
 
 <!--endsec-->
 
-<!--sec data-title="Debian vagy Ubuntu" data-id="python_debian"
-data-collapse=true ces-->
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
 
 Írd be az alábbi parancsot a konzolba:
 
-    $ sudo apt-get install python3.4
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
     
+
 <!--endsec-->
 
-<!--sec data-title="Fedora (22+)" data-id="python_fedora22"
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
 data-collapse=true ces-->
 
 Írd be az alábbi programot a konzolba:
 
-    $ sudo dnf install python3.4
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
     
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
 <!--endsec-->
 
-<!--sec data-title="openSUSE" data-id="python_openSUSE"
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
 data-collapse=true ces-->
 
 Írd be az alábbi programot a konzolba:
 
+{% filename %}command-line{% endfilename %}
+
     $ sudo zypper install python3
+    
 
 <!--endsec-->
 
-Bizonyosodj meg arról, hogy sikeres volt a telepítés! Nyisd meg a *Terminált* és futtasd le a `python3` parancsot:
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 --version
-    Python 3.4.3
+    Python 3.6.1
     
 
-
-**Megjegyzés** Ha windows-t használsz és egy hibaüzenetet kapsz, mely szerint `python3` nem található, próbáld meg `python` néven (a `3` nélkül) és ellenőrizd hogy Python 3.6-e.
-
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
 
 * * *
 
-Ha kétségeid vannak, vagy valami elromlott, és nem tudod, mit csinálj - csak kérdezd meg a coachodat! Néha a dolgok nem mennek teljesen simán, és jobb megkérdezni valakit, akinek több tapasztalata van a témában.
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Néha a dolgok nem mennek teljesen simán, és jobb megkérdezni valakit, akinek több tapasztalata van a témában.
\ No newline at end of file
diff --git a/hu/python_introduction/README.md b/hu/python_introduction/README.md
index 44f0af083c7..5152c3b63e8 100644
--- a/hu/python_introduction/README.md
+++ b/hu/python_introduction/README.md
@@ -1,96 +1,129 @@
 # Bevezetés a Pythonba
 
-> Ez a fejezet részben a Geek Girls Carrots (https://github.com/ggcarrots/django-carrots) tutorialjain alapszik.
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 
 Írjunk egy kis kódot!
 
 ## A Python parancssor
 
-Hogy elkezdhess a Pythonnal ismerkedni, szükséged lesz a *parancssorra*. Már tudod, hogyan kell -- megtanultad a [ Bevezetés a parancssor használatába][1] fejezetben.
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
 
- [1]: ../intro_to_command_line/README.md
+Hogy elkezdhess a Pythonnal ismerkedni, szükséged lesz a *parancssorra*. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
 
 Ha kész vagy, kövesd az alábbi utasításokat.
 
 Egy Python konzolt szeretnénk megnyitni. Gépeld be a `python` parancsot Windowson, vagy a `python3` parancsot, ha Mac vagy Linux van a gépeden, és nyomj `enter`t.
 
+{% filename %}command-line{% endfilename %}
+
     $ python3
-    Python 3.4.3 (...)
+    Python 3.6.1 (...)
     Type "help", "copyright", "credits" or "license" for more information.
     >>>
     
 
 ## Az első Python parancsod!
 
-Miután futtattad a Python parancsot, a parancssor megváltozott: `>>>`. Ez azt jelenti, hogy mostantól csak a Python nyelv parancsait használhatjuk. Nem kell beírnod ezt: `>>>` - a Python megcsinálja helyetted.
+Miután futtattad a Python parancsot, a parancssor megváltozott: `>>>`. Ez azt jelenti, hogy mostantól csak a Python nyelv parancsait használhatjuk. You don't have to type in `>>>` – Python will do that for you.
 
 Ha bármikor szeretnél kilépni a Python konzolból, csak gépeld be, hogy `exit()`, vagy használd a `Ctrl + Z` billentyűkombinációt Windos-ra, vagy a `Ctrl + D`-t Mac-re/Linux-ra. Ezután már nem fogod látni a `>>>` jelet.
 
-Most épp nem szeretnénk kilépni a Python konzolból. Inkább többet szeretnénk tanulni róla. Kezdjünk valami nagyon egyszerűvel. Például kezdjünk valami matekkel, mint pl. `2 + 3` majd `enter`.
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
 
-    >>> 2 + 3
-    5
-    
+{% filename %}command-line{% endfilename %}
 
-Szuper! Láttad, ahogy előugrott a válasz? A Python tud matekozni! Kipróbálhatsz más parancsokat is, mint például:
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
 
 - `4 * 5`
 - `5 - 1`
 - `40 / 2`
 
-Szórakozz egy kicsit ezzel aztán gyere vissza ide :).
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Szórakozz egy kicsit ezzel aztán gyere vissza ide. :)
 
-Amint látod, a Python jó számológép. Ha kíváncsi vagy, mire jó még...
+As you can see, Python is a great calculator. If you're wondering what else you can do…
 
 ## Stringek
 
 Mi a helyzet a neveddel? Gépeld be a neved időzéjelbe téve:
 
-    >>> "Ola"
-    'Ola'
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
 
 Épp most hoztad létre az első stringedet! Ez egy karakter-sorozat amit a számítógép fel tud dolgozni. A string kezdetét és végét ugyanazzal a karakterrel jelöljük. Ez lehet szimpla (`'`) vagy dupla (`"`) idézőjel (nincs különbség!) Az idézőjelek mondják meg a Pythonnak, hogy ami köztük van, az egy string.
 
 A stringeket össze is lehet fűzni. Próbáld ki ezt:
 
-    >>> "Hi there " + "Ola"
-    'Hi there Ola'
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
 
 Sokszorosítani is lehet őket:
 
-    >>> "Ola" * 3
-    'OlaOlaOla'
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
 
 Ha aposztrófot szeretnél a stringedbe tenni, kétféleképpen teheted meg.
 
 Idézőjel segítségével:
 
-    >>> "Runnin' down the hill"
-    "Runnin' down the hill"
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
 
 vagy pedig escape karakterrel (``) az aposztróf előtt:
 
-    >>> 'Runnin\' down the hill'
-    "Runnin' down the hill"
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
 
 Jó, mi? Ha nagybetűkkel szeretnéd látni a neved, csak gépeld be ezt:
 
-    >>> "Ola".upper()
-    'OLA'
-    
+{% filename %}command-line{% endfilename %}
 
-Épp most használtad az `upper` **functiont** (függvényt) a stringeden! A függvény, (mint például az `upper()`), egy utasítássorozat, amit a Python végrehajt egy adott objektumon (`"Ola"`), amikor a függvényt meghívod.
+```python
+>>> "Ola".upper()
+'OLA'
+```
 
-Ha szeretnéd tudni, hogy hány betűből áll a neved, arra is van függvény!
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
 
-    >>> len("Ola")
-    3
-    
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
 
 Érdekel, miért van az, hogy néha a függvényeket úgy hívjuk meg, hogy a string után egy `.` jön, majd a függvény neve (mint például `"Ola".upper()`), máskor pedig előbb a függvény neve jön, aztán a string a zárójelben? Nos, ez azért van mert néha a függvények objektumokhoz tartoznak, mint az `upper()`, amit csak azokon az objektumokon hívhatunk meg. Ebben az esetben a függvényt **metódusnak** (method) nevezzük. Máskor a függvény nem tartozik egy bizonyos típusú objektumhoz, hanem többféle típusú objektumon is meg lehet hívni, mint például a `len()`. Ezért volt az hogy az `"Ola"`-t paraméterként adtuk át a `len` függvénynek.
 
@@ -98,10 +131,10 @@ Ha szeretnéd tudni, hogy hány betűből áll a neved, arra is van függvény!
 
 Oké, elég a stringekből. Tehát ezidáig a következőkről tanultál:
 
-*   **a parancssor** - ha parancsokat (kódot) írunk be a Python parancssorba, a Python végrehajtja azokat
-*   **számok és stringek** - a Pythonban a számokat matematikai műveletekhez, a stringeket szöveg objektumokhoz használjuk
-*   **operátorok** - mint a + és a *, két értékből egy újat hoznak létre
-*   **függvények** - mint az upper() és a len(), objektumokon hajtanak végre műveleteket.
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
 
 Ezek volnának az alapjai minden programozási nyelvnek. Készen állsz valami bonyolultabbra? Rajta!
 
@@ -109,24 +142,30 @@ Ezek volnának az alapjai minden programozási nyelvnek. Készen állsz valami b
 
 Nézzünk valami újat. Vajon megkaphatjuk-e egy szám hosszát ugyanúgy, mint a nevünk hosszát? Írd be, hogy `len(304023)`, majd üss `enter`-t:
 
-    >>> len(304023)
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    TypeError: object of type 'int' has no len()
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
 
 Megkaptuk az első hibánkat! Azt mondja, az "int" típusú (integerek, egész számok) objektumoknak nincs hosszuk. Most akkor mit tehetünk? Talán leírhatjuk a számunkat stringként? A stringeknek van hosszuk, nem?
 
-    >>> len(str(304023))
-    6
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
 
 Működött! Használtuk a `str` függvényt a `len` függvény belsejében. A `str()` függvény stringgé alakít egy tetszőleges típusú objektumot.
 
-*   A `str` függvény **stringgé** alakítja a dolgokat
-*   Az `int` függvény **integerré** alakítja a dolgokat
+- A `str` függvény **stringgé** alakítja a dolgokat
+- Az `int` függvény **integerré** alakítja a dolgokat
 
-> Fontos: számokat (integereket) stringgé bármikor alakíthatunk, de stringet számmá nem feltétlenül - mégis mi lenne az `int('hello')` eredménye?
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
 
 ## Változók
 
@@ -134,46 +173,64 @@ A programozásban nagyon fontos a változó fogalma. A változó egy név egy ob
 
 Tegyük fel, hogy létrehoztál egy változót, aminek a neve `name`:
 
-    >>> name = "Ola"
-    
+{% filename %}command-line{% endfilename %}
 
-Látod? Egyszerű! Csak ennyi: name egyenlő Ola.
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
 
 Amint láthatod, a program nem adott vissza semmilyen eredményt, az eddigiekkel ellentétben. Honnan tudjuk így, hogy a változó létrejött? Egyszerűen írd be, hogy `name`, majd üss `enter`-t:
 
-    >>> name
-    'Ola'
-    
+{% filename %}command-line{% endfilename %}
 
-Juppííí! Az első változód :)! És bármikor megváltoztathatod, hogy mit tartalmaz:
+```python
+>>> name
+'Ola'
+```
 
-    >>> name = "Sonja"
-    >>> name
-    'Sonja'
-    
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
 
 És függvényekben is használhatod:
 
-    >>> len(name)
-    5
-    
+{% filename %}command-line{% endfilename %}
 
-Szuper, ugye? Természetesen a változók bármilyen értéket felvehetnek, például szám-értékeket is. Próbáld ki:
+```python
+>>> len(name)
+5
+```
 
-    >>> a = 4
-    >>> b = 6
-    >>> a * b
-    24
-    
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
 
 De mi van akkor, ha rossz nevet használunk? Kitalálod? Próbáljuk ki!
 
-    >>> city = "Tokyo"
-    >>> ctiy
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    NameError: name 'ctiy' is not defined
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
 
 Egy hiba! Amint látod a Pythonban különböző típusú hibák vannak, ezt például úgy hívják hogy **NameError**. A Python ezt a hibát dobja, ha olyan változóra hivatkozol, ami nem volt még létrehozva. Ha majd találkozol ezzel a hibával, mindig ellenőrizd a kódod, hogy nem írtál-e el egy nevet.
 
@@ -183,12 +240,15 @@ Játssz egy kicsit a változókkal, hogy lásd, mi mindenre vagy képes velük!
 
 Próbáld ki ezt:
 
-    >>> name = 'Maria'
-    >>> name
-    'Maria'
-    >>> print(name)
-    Maria
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
 
 Amikor beírod, hogy `name`, a Python interpreter a "name" változó szöveges *reprezentációjával* tér vissza, ami a M-a-r-i-a betűkből áll, idézőjelek között. Amikor azt írod: `print(name)`, a Python "kinyomtatja" a változó tartalmát a képernyőre, idézőjelek nélkül, ami sokkal elegánsabb.
 
@@ -196,72 +256,100 @@ Amint majd látni fogjuk, a `print()` hasznos lesz függvények belsejében is,
 
 ## Listák
 
-A stringek és az integerek mellett a Python még sok más típusú objektumot ismer. Most megmutatunk egy újat, amit úgy hívnak: **lista**. A lista olyan, amilyennek elképzeled: egy objektum, ami más objektumok listája :)
+A stringek és az integerek mellett a Python még sok más típusú objektumot ismer. Most megmutatunk egy újat, amit úgy hívnak: **lista**. A lista olyan, amilyennek elképzeled: egy objektum, ami más objektumok listája. :)
 
 Hozzunk létre egy listát:
 
-    >>> []
-    []
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
 
 Igen, ez egy üres lista. Nem túl hasznos, ugye? Most hozzunk létre egy listát a lottószámokkal. Nem akarjuk folyton ismételni magunkat, úgyhogy egyenesen egy változóba tesszük:
 
-    >>> lottery = [3, 42, 12, 19, 30, 59]
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
 
 Igen, van egy listánk! Mit lehet vele csinálni? Nézzük meg, hány lottószám van a listában. Van tipped, melyik függvényt fogjuk erre használni? Biztos tudod!
 
-    >>> len(lottery)
-    6
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
 
 Igen! A `len()` megadja, hogy hány objektum van a listában. Hasnzos, ugye? Most akkor rendezzük sorba a listát:
 
-    >>> lottery.sort()
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
 
 Ez nem ad vissza semmit, csak megváltoztatta a számok sorrendjét a listában. Írassuk ki a listát, hogy lássuk, mi történt:
 
-    >>> print(lottery)
-    [3, 12, 19, 30, 42, 59]
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
 
 Amint látod, a számok a listában most növekvő sorrendben vannak. Gratula!
 
 Esetleg szeretnéd fordított sorrendbe rendezni? Csináljuk meg!
 
-    >>> lottery.reverse()
-    >>> print(lottery)
-    [59, 42, 30, 19, 12, 3]
-    
+{% filename %}command-line{% endfilename %}
 
-Könnyű, ugye? Ha hozzá akarsz adni valamit a listához, a következő paranccsal teheted:
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
 
-    >>> lottery.append(199)
-    >>> print(lottery)
-    [59, 42, 30, 19, 12, 3, 199]
-    
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
 
 Ha például csak az első számot akarod látni, arra használhatod az **indexelést**. Az index egy szám ami megmondja, hányadikként fordul elő egy elem a listában. A programozók szeretik 0-tól kezdeni a számolást, ezért a lista első eleme a 0-dik indexű helyen van, a következő az 1-nél és így tovább. Próbáld ki ezt:
 
-    >>> print(lottery[0])
-    59
-    >>> print(lottery[1])
-    42
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
 
 Amint látod, a listában előforduló különböző objektumokat elérhetjük a lista nevének, illetve az objektum indexének megjelölésével, ahol az indexet szögletes zárójelbe írjuk.
 
-Ahhoz, hogy valamit kitöröljünk a listából, szükségünk van az **index** fogalmára, amint azt az előbb tanultuk, valamint a `pop()` parancsra. Nézzünk egy példát hogy megerősítsük az eddig tanultakat; ki fogjuk törölni az első elemet a listánkból.
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
 
-    >>> print(lottery)
-    [59, 42, 30, 19, 12, 3, 199]
-    >>> print(lottery[0])
-    59
-    >>> lottery.pop(0)
-    >>> print(lottery)
-    [42, 30, 19, 12, 3, 199]
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
 
 Működik, mint a varázslat!
 
@@ -271,262 +359,329 @@ Ebben a Python dokumentációban megtalálod a listákra értelmezett összes me
 
 ## Szótárak
 
-A szótár (dictionary) hasonló a listához, de a szótár elemeit nem indexekkel hanem kulcsokkal (key) érjük el. A kulcs lehet bármilyen string vagy szám. Az üres szótár létrehozására szolgáló utasítás a következő:
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
 
-    >>> {}
-    {}
-    
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
 
 Épp most definiáltál egy üres szótárat. Hurrá!
 
-Most pedig próbáld ki a következő parancsot (és próbáld meg használni a saját adataidat):
+Now, try writing the following command (try substituting your own information, too):
 
-    >>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
-    
+{% filename %}command-line{% endfilename %}
 
-Ezzel a paranccsal létrehoztál egy szótár-változót aminek a neve `participant`, és ami tartalmaz három kulcs-érték (key-value) párt:
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
 
-*   A `name` kulcs az `'Ola'` értékre mutat (ami egy `string` típusú objektum),
-*   `country` a `'Poland'`-ra mutat (szintén `string` típusú),
-*   és `favorite_numbers` a `[7, 42, 92]` objektumra mutat (ami egy `lista` benne három elemmel).
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- A `name` kulcs az `'Ola'` értékre mutat (ami egy `string` típusú objektum),
+- `country` a `'Poland'`-ra mutat (szintén `string` típusú),
+- és `favorite_numbers` a `[7, 42, 92]` objektumra mutat (ami egy `lista` benne három elemmel).
 
 Lekérdezheted az egyes kulcsokhoz tartozó értékeket a következő szintaxist használva:
 
-    >>> print(participant['name'])
-    Ola
-    
+{% filename %}command-line{% endfilename %}
 
-Látod, nagyon hasonlít a listákhoz. Csak épp nem kell indexeket megjegyezned - csupán neveket.
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
 
 Vajon mi történik, ha olyan kulcshoz tartozó értéket kérdezünk le a Pythontól, ami nem létezik? Nézzük meg!
 
-    >>> participant['age']
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    KeyError: 'age'
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
 
 Jéé, egy újabb hiba! Ezúttal **KeyError**. A Python segítőkész, és megmondja, hogy az `'age'` kulcsnál nem található érték a szótárban.
 
 Mikor használjunk szótárakat és mikor listákat? Nos, ez egy érdekes kérdés. Gondolkozz el egy kicsit, és próbáld meg magadtól kitalálni, mielőtt elolvasod az alábbi választ.
 
-*   Csak elemek rendezett sorozatára van szükséged? Használj listát.
-*   Kulcs és érték párokra van szükséged, amiket majd le tudsz kérdezni hatékonyan (kulcs alapján)? Használj szótárat.
+- Csak elemek rendezett sorozatára van szükséged? Használj listát.
+- Kulcs és érték párokra van szükséged, amiket majd le tudsz kérdezni hatékonyan (kulcs alapján)? Használj szótárat.
 
-A szótárak, ugyanúgy mint a listák, *módosíthatók*, ami azt jelenti, hogy az objektumot meg lehet változtatni létrehozás után. Hozzá lehet adni egy kulcs-érték párt a szótárhoz a létrehozása után, pl:
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
 
-    >>> participant['favorite_language'] = 'Python'
-    
+{% filename %}command-line{% endfilename %}
 
-Ugyanúgy, mint a listáknál, a `len()` metódus visszaadja a szótár hosszát, azaz a kulcs-érték párok számát. Rajta, próbáld ki a következő parancsot:
+```python
+>>> participant['favorite_language'] = 'Python'
+```
 
-    >>> len(participant)
-    4
-    
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
 
-Remélem most már világos :) Készen állsz az újabb mókára a szótárakkal? Ugorj a következő sorhoz, és láss lenyűgöző dolgokat.
+{% filename %}command-line{% endfilename %}
 
-Használd a `pop()` parancsot, hogy kitörölj egy elemet a szótárból. Mondjuk ki akarod törölni a `'favorite_numbers'` kulcsnál található elemet. Csak írd be a következőt:
+```python
+>>> len(participant)
+4
+```
 
-    >>> participant.pop('favorite_numbers')
-    >>> participant
-    {'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
-    
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
 
-Amint azt a kimenetből látod, a 'favorite_numbers' kulcshoz tartozó elem eltűnt a szótárból.
+You can use the `pop()` method to delete an item in the dictionary. Mondjuk ki akarod törölni a `'favorite_numbers'` kulcsnál található elemet. Csak írd be a következőt:
 
-Az előbbihez hasonlóan, meg is tudod változtatni egy kulcsnál a hozzá tartozó értéket a szótárban. Írd ezt:
+{% filename %}command-line{% endfilename %}
 
-    >>> participant['country'] = 'Germany'
-    >>> participant
-    {'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
-    
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
 
-Amint látod, a `'country'` kulcsnál levő érték megváltozott `'Poland'`-ról `'Germany'`-ra. :) Izgalmas, ugye? Hurrá! Most ismét tanultál egy nagyszerű dolgot.
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
 
 ### Összefoglaló
 
 Nagyszerű! Most már tudsz egy csomó mindent a programozásról. Ebben az utolsó részben a következőkről tanultál:
 
-*   **hibák** - tudod, hogyan olvasd és értsd meg a hibákat, amiket a Python ad, amikor nem tudja értelmezni a parancsodat
-*   **változók** - nevek az objektumokhoz, hogy a kód könnyebben írható és könnyebben olvasható legyen
-*   **listák** - lista meghatározott sorrendben lévő objektumokból
-*   **szótárak** - objektumok, amiket kulcs-érték párokként tárolunk
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
 
 Felkészültél a következő részre? :)
 
 ## Dolgok összehasonlítása
 
-A számítástechnikában nagyon fontos, hogy össze tudjunk hasonlítani dolgokat. Mik a legegyszerűbb dolgok, amiket össze tudunk hasonlítani? Hát a számok. Nézzük meg ez hogy működik:
-
-    >>> 5 > 2
-    True
-    >>> 3 < 1
-    False
-    >>> 5 > 2 * 2
-    True
-    >>> 1 == 1
-    True
-    >>> 5 != 2
-    True
-    
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
 
-Adtunk a Pythonnak néhány számot, hogy összehasonlítsa azokat. Amint látod, a Python nem csak számokat, de műveleti eredményeket is össze tud hasonlítani. Jó, ugye?
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
 
-Azon gondolkozol, miért kellett két egyenlőség jelet `==` tenni, amikor azt néztük, hogy két szám egyenlő-e? Az egyetlen `=` jelet arra használjuk, hogy a változóknak értéket adjunk. Mindig, de **mindig** két `==` jelet kell használni ha két dolog egyenlőségét akarod tesztelni. Azt is ki tudjuk fejezni, hogy két dolog nem egyenlő. Erre a `!=` szimbólumot használjuk, amint az alábbi példában is.
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Azon gondolkozol, miért kellett két egyenlőség jelet `==` tenni, amikor azt néztük, hogy két szám egyenlő-e? Az egyetlen `=` jelet arra használjuk, hogy a változóknak értéket adjunk. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. Azt is ki tudjuk fejezni, hogy két dolog nem egyenlő. Erre a `!=` szimbólumot használjuk, amint az alábbi példában is.
 
 Adj a Pythonnak két új parancsot:
 
-    >>> 6 >= 12 / 2
-    True
-    >>> 3 <= 2
-    False
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
 
-A `>` és a `<` egyszerűek, de vajon a `>=` és a `<=` mit jelentenek? Ezeket úgy kell olvasni, hogy:
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
 
-*   x `>` y azt jelenti: x nagyobb, mint y
-*   x `<` y azt jelenti: x kisebb, mint y
-*   x `<=` y azt jelenti: x kisebb vagy egyenlő y-nal
-*   x `>=` y azt jelenti: x nagyobb vagy egyenlő y-nal
+- x `>` y azt jelenti: x nagyobb, mint y
+- x `<` y azt jelenti: x kisebb, mint y
+- x `<=` y azt jelenti: x kisebb vagy egyenlő y-nal
+- x `>=` y azt jelenti: x nagyobb vagy egyenlő y-nal
 
 Nagyszerű! Szeretnél még egy példát? Próbáld ki ezt:
 
-    >>> 6 > 2 and 2 < 3
-    True
-    >>> 3 > 2 and 2 < 1
-    False
-    >>> 3 > 2 or 2 < 1
-    True
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
 
 Annyi összehasonlítást kombinálhatsz össze, amennyit csak akarsz, és a Python kiszámolja az eredményt. Okos, ugye?
 
-*   **and** (azaz: és) - amikor az `and` operátort használod, a kifejezés mindkét oldalán igaz értéknek kell állnia ahhoz, hogy az eredmény igaz legyen
-*   **or** (azaz: vagy) - amikor az `or` operátort használod, elég csak az egyik oldalon igaz értéknek állnia ahhoz, hogy az eredmény igaz legyen
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
 
 Hallottad már azt a kifejezést hogy "almákat narancsokkal összehasonlítani"? Nézzük meg ennek a python-beli megfelelőjét:
 
-    >>> 1 > 'django'
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    TypeError: unorderable types: int() > str()
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
 
 Láthatod, hogy ugyanúgy, mint a kifejezéseknél, a Python nem tudja összehasonlítani a számot (`int`) a stringgel (`str`). Ehelyett **TypeError** típusú hibát dob, azaz megmondja, hogy két különböző típust nem lehet egymással összehasonlítani.
 
 ## Boolean (Logikai)
 
-Véletlenül épp megismerkedtél egy újabb Python típussal. Úgy hívják: **Boolean** -- és valószínűleg ez a legegyszerűbb típus ami létezik.
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
 
-Egy Boolean objektum két lehetséges értéket vehet fel: - Igaz - Hamis
+There are only two Boolean objects:
 
-De ahhoz, hogy a Python megértse, pontosan így kell írni: 'True' (az első betű nagybetű, a többi kisbetű). **true, TRUE, tRUE mind nem jók -- csak az True helyes.** (És ugyanígy a 'False' esetében)
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
 
 A Booleanok is lehetnek változók! Nézd:
 
-    >>> a = True
-    >>> a
-    True
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
 
 Sőt, ezt is írhatod:
 
-    >>> a = 2 > 5
-    >>> a
-    False
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
 
 Gyakorold egy kicsit és játssz a Booleanokkal, pl próbáld ki a következő parancsokat:
 
-*   `True and True`
-*   `False and True`
-*   `True or 1 == 1`
-*   `1 != 2`
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
 
 Gratulálunk! A Booleanok a programozás egyik legmenőbb elemei, és te épp megtanultad használni őket!
 
 # Mentsd el!
 
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
 Egész mostanig a python interpreterbe írkáltuk a parancsokat, ami arra korlátoz minket hogy, egyszerre csak egy sort írjunk. A gyakorlatban a programokat fájlba mentjük, és utána futtatjuk a programnyelv **interpreter**-e vagy **compiler**-e révén. Mi mindeddig a Python **interpreter**-ével futtatuk a programjainkat, soronként. A következő feladatokhoz többsoros programokra is szükségünk lesz, úgyhogy gyorsan:
 
-*   Lépjünk ki a Python interpreterből
-*   Nyissunk meg egy kódszerkesztőt
-*   Mensünk el benne valami kódot egy python fájlba
-*   És futtassuk!
+- Lépjünk ki a Python interpreterből
+- Nyissunk meg egy kódszerkesztőt
+- Mensünk el benne valami kódot egy python fájlba
+- És futtassuk!
 
-Ahhoz hogy kilépjünk a Python interpreterből, egyszerűen írjuk be, hogy ~~~ exit()~~~:
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
 
-    >>> exit()
-    $
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
 
 Ezzel visszatértünk a parancssorba.
 
-Egy előző részben már kiválasztottuk a kedvenc [kódszerkesztő][2]nket. Most nyissuk meg az editort és az új üres fájlba írjuk bele:
+Egy előző részben már kiválasztottuk a kedvenc [kódszerkesztő](../code_editor/README.md)nket. Most nyissuk meg az editort és az új üres fájlba írjuk bele:
 
- [2]: ../code_editor/README.md
+{% filename %}editor{% endfilename %}
 
 ```python
-    print('Hello, Django girls!')
+print('Hello, Django girls!')
 ```
 
 Mostanra már tapasztalt Python programozó lettél, úgyhogy írj valami kódot, amit ma tanultál.
 
-Most mentsük el a fájlt, és adjunk neki valami jellemző nevet. Nevezzünk **python_intro.py**-nak, és mentsük el a desktopra. Bárhogy nevezhetjük a fájlt, de a kiterjesztés fontos, hogy **.py** legyen. A **.py** kiterjesztés megmondja az operációs rendszerünknek, hogy **python futtatható programfájl**-lal van dolga.
+Most mentsük el a fájlt, és adjunk neki valami jellemző nevet. Nevezzünk **python_intro.py**-nak, és mentsük el a desktopra. Bárhogy nevezhetjük a fájlt, de a kiterjesztés fontos, hogy **.py** legyen. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
 
-> **Megj.** Vegyük észre a kód editorok legnagyszerűbb tulajdonságát: a színeket! A Python konzolban minden egyszínű volt, most a `print` függvény más színű, mint a string. Ezt úgy hívják: "syntax highlighting" (szintaxis-kiemelés), és kódoláshoz nagyon hasznos. A kód színe mindenféle utalásokat hordoz magában, pl. egy lezáratlan string vagy egy elírás egy kulcsszó nevében (pl. a `def` a függvényeknél, amint látni fogjuk mindjárt). Ez az egyik oka annak, hogy kódszerkesztőt használuk :)
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. Ezt úgy hívják: "syntax highlighting" (szintaxis-kiemelés), és kódoláshoz nagyon hasznos. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). Ez az egyik oka annak, hogy kódszerkesztőt használuk. :)
 
 Most hogy a fájl el van mentve, itt az ideje, hogy lefuttassuk. Felhaszálva a tudásodat a parancssoros részből, navigálj a terminálban a desktopra a **könyvtárváltás** parancs segítségével.
 
-<!--sec data-title="OS X" data-id="python_OSX"
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
 data-collapse=true ces-->
 
 Mac-en a parancs valahogy így néz ki:
 
-{% filename %}parancssor{% endfilename %}
-```
-$ cd ~/Desktop
-```
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="python_linux"
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
 data-collapse=true ces-->
 
-Linuxon így (A "Desktop" lehet, hogy le van fordítva a te nyelvedre):
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
 
-{% filename %}parancssor{% endfilename %}
-```
-$ cd ~/Desktop
-```
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
 
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="python_windows" data-collapse=true ces-->
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
 
-Windowson így néz ki:
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
 
-{% filename %}parancssor{% endfilename %}
-```
-> cd %HomePath%\Desktop
-```
 <!--endsec-->
 
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
 
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
 
 Ha megakadtál volna, kérj nyugodtan segítséget.
 
 Most pedig futtasd le a Python kódot, így:
 
-{% filename %}parancssor{% endfilename %}
-```
-$ python3 python_intro.py
-Hello, Django girls!
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
     
-Note: Windows-on 'python3' néven nem található parancs. Helyette használd a 'python' néven:
 
-{% filename %}parancssor{% endfilename %}
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
 ```python
 > python python_intro.py
 ```
@@ -535,17 +690,21 @@ Rendben! Épp lefuttattad az első Python programodat fájlból. Jó érzés, ug
 
 Most akkor továbbmehetünk egy újabb kulcsfontosságú programozási elemre:
 
-## If...elif...else
+## If … elif … else
 
-Sokszor előfordul a programozásban, hogy egyes kódrészleteknek csak akkor kell lefutniuk, ha bizonyos feltételek teljesülnek. Ezért vannak a Pythonban az **if statement**ek (if állítások).
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
 
 Cseréld ki a **python_intro.py** fájlban lévő kódot erre:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-    if 3 > 2:
+if 3 > 2:
 ```
 
-Ha ezt elmented és lefuttatod, ezt a hibaüzenetet fogod látni:
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     File "python_intro.py", line 2
@@ -555,51 +714,65 @@ Ha ezt elmented és lefuttatod, ezt a hibaüzenetet fogod látni:
 
 A Python arra számít, hogy további utasításokat kap arra az esetre, ha a `3 > 2` teljesül, vagyis `True` lesz. Vegyük rá a Pythont, hogy kiírja: "It works!" ("Működik!"). Változtasd meg erre a **python_intro.py** fájlban lévő kódot:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-    if 3 > 2:
-        print('It works!')
+if 3 > 2:
+    print('It works!')
 ```
 
 Megfigyelted, hogy a következő sort 4 szóközzel indentáltuk? Erre azért van szükség, hogy a Python tudja, melyik kódrészletet kell lefuttatnia, ha a feltétel teljesül. Egy szóközt is használhatnál, de szinte az összes Python programozó 4 szóközt használ, hogy rendezetten nézzen ki a kód. Egy `tab` is 4 szóköznek számít.
 
 Mentsd el, és futtasd le még egyszer:
 
-    $ python3 python_intro.py
-    It works!
-    
-Note: Emlékezz arra, hogy Windows-on, 'python3' néven nem található parancs. Ha nálad is ez a helyzet, mostantól helyettesítsd 'python3'-t 'python'-al a file-ok futtatásához.
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
 
 ### Mi történik, ha egy feltétel nem teljesül (vagyis nem True)? 
 
 A korábbi példákban a kód csak akkor futott le, ha a feltétel teljesült. De a Pythonnak van `elif` és `else` statementje is:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-    if 5 > 2:
-        print('5 is indeed greater than 2')
-    else:
-        print('5 is not greater than 2')
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
 ```
 
 Ha ezt lefuttatod, a következőt kapod:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     5 is indeed greater than 2
     
 
-Ha a 2 nagyobb lenne, mint az 5, a második parancs futott volna le. Egyszerű, igaz? Nézzük, hogy működik az `elif`:
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
-    name = 'Sonja'
-    if name == 'Ola':
-        print('Hey Ola!')
-    elif name == 'Sonja':
-        print('Hey Sonja!')
-    else:
-        print('Hey anonymous!')
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
 ```
 
 lefuttatva:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hey Sonja!
     
@@ -608,68 +781,77 @@ Látod, mi történt itt? Az `elif` arra jó, hogy plusz feltételeket írhass a
 
 Az első `if` statement után annyi `elif` állítást írhatsz, amennyit csak akarsz. Például:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-    volume = 57
-    if volume < 20:
-        print("It's kinda quiet.")
-    elif 20 <= volume < 40:
-        print("It's nice for background music")
-    elif 40 <= volume < 60:
-        print("Perfect, I can hear all the details")
-    elif 60 <= volume < 80:
-        print("Nice for parties")
-    elif 80 <= volume < 100:
-        print("A bit loud!")
-    else:
-        print("My ears are hurting! :(")
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
 ```
 
 A Python sorban mindegyik feltételt megnézi, és kiírja:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Perfect, I can hear all the details
     
 
-## Megjegyzések
+## Comments
 
-A megjegyzések olyan sorok amelyek `#`-el kezdődnek. Bármit beírhatsz a `#` után, és Python figyelmen kívül fogja hagyni. Megjegyzések segíthetnek abban hogy a kódod mások számára érthető legyen.
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
 
-Lássuk, hogyan néz ki:
+Let's see how that looks:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
-# Hangerő beállítása, ha túl hangos vagy túl halk
+# Change the volume if it's too loud or too quiet
 if volume < 20 or volume > 80:
     volume = 50
     print("That's better!")
 ```
 
-Nem kell minden sorhoz megjegyzést írnod, de nagyon hasznosak annak elmagyarázásához hogy miért csinál valamit a kódod, vagy hogy összefoglalót nyújtson amikor valami bonyolult feladatot végez.
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
 
 ### Összefoglaló
 
-Az előző három feladatban ezekről tanultál:
+In the last few exercises you learned about:
 
-* __dolgok összehasonlítása__ - Pythonban a `>`, `>=`, `==`, `<=`, `<` jelekkel, és az `and`, `or` operátorokkal hasonlíthatsz össze dolgokat
-* __Boolean__ - egy olyan fajta objektum, ami csak két értéket vehet fel: `True` vagy `False`
-* __Fájlok elmentése__ - a kódot fájlokban is tárolhatod, így hosszabb programokat is lefuttathatsz.
-* __if...elif...else__ - állítások, amik arra jók, hogy a kód csak bizonyos feltételek teljesülése esetén fusson le.
-- __comments__ - sorok, amelyeket Python nem futtat le, amelyekkel dokumentálni tudod a kódodat.
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
 
 Elérkeztünk a fejezet utolsó részéhez!
 
 ## A saját függvényeidhez!
 
-Emlékszel például a `len()` fügvényre, amit lefuttathatsz Pythonban? Jó hírünk van - most megtanulod, hogyan írhatsz saját függvényeket!
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
 
-A függvény utasítások sorozata, amit a Python lefuttat. Minden Python függvény a `def` kulcsszóval kezdődik, van neve, és lehetnek paraméterei. Kezdjük egy könnyűvel. Cseréld ki a **python_intro.py** kódját erre:
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A függvény utasítások sorozata, amit a Python lefuttat. Minden Python függvény a `def` kulcsszóval kezdődik, van neve, és lehetnek paraméterei. Let's give it a go. Cseréld ki a **python_intro.py** kódját erre:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
-    def hi():
-        print('Hi there!')
-        print('How are you?')
-    
-    hi()
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
 ```
 
 Oké, kész is az első függvény!
@@ -678,37 +860,47 @@ Talán elgondolkodtál, miért írtuk a függvény nevét a fájl aljára. Erre
 
 Futtassuk le, és nézzük meg, mi történik:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hi there!
     How are you?
     
-Megjegyzés: ha nem működött, ne ess pánikba! A hibaüzenet segít kitalálni, hogy mi a baj:
-- Ha `NameError`-t kapsz, valószinűleg valamit elgépeltél, ellenőrizd, hogy ugyan azt a nevet használtad amikor létrehoztad a függvényt `def hi():`-al és amikor meghívtad `hi()`-al.
-- Ha `IndentationError` hibát kapsz, ellenőrizd, hogz mind a két `print` sor elején azonos mennyiségű üres hely (szóköz karakter) van: python számára a függvényen bellüli összes kódnak szépen illesztve kell lennie.
-- Ha nincs egyáltalán semmilyen kimenet, ellenőrizd hogy az utolsó `hi()` *nincs* indentálva - ha így lenne, az a sor is a függvény része lesz és ezért soha nem fog lefutni.
 
-Most írjuk meg az első olyan függvényt, aminek vannak paraméterei. Az előző példát fogjuk használni - egy függvény, ami köszön annak, aki futtatja, de most nevet is adunk hozzá:
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
-    def hi(name):
+def hi(name):
 ```
 
 Ahogy láthattad, a függvény most kapott egy paramétert, amit `name`-nek hívunk:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-    def hi(name):
-        if name == 'Ola':
-            print('Hi Ola!')
-        elif name == 'Sonja':
-            print('Hi Sonja!')
-        else:
-            print('Hi anonymous!')
-    
-    hi()
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
 ```
 
 Fontos: a `print` függvény 4 szóközzel van indentálva az `if` statementen belül. Erre azért van szükség, hogy ez a függvény a feltétel teljesülése esetén fusson le. Nézzük, hogy működik:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Traceback (most recent call last):
     File "python_intro.py", line 10, in <module>
@@ -718,46 +910,60 @@ Fontos: a `print` függvény 4 szóközzel van indentálva az `if` statementen b
 
 Hoppá, egy hiba. Szerencsére a Python elég hasznos hibaüzeneteket ad nekünk. Azt mondja, a `hi()` függvénynek (vagyis annak, amit az előbb definiáltunk) egy kötelező paramétere van (amit `name`-nek hívnak), és ezt elfelejtettük beadni, amikor meghívtuk a függvényt. Javítsuk ki a fájl alján:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-    hi("Ola")
+hi("Ola")
 ```
 
 És futtassuk le újra:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hi Ola!
     
 
 És ha megváltoztatjuk a nevet?
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-    hi("Sonja")
+hi("Sonja")
 ```
 
 Futtasd le:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hi Sonja!
     
 
-Mit gondolsz, mi fog történni, ha egy harmadik nevet írsz be? Próbáld ki, és nézd meg, jól gondoltad-e. Ezt kell kapnod:
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
 
     Hi anonymous!
     
 
-Ez fantasztikus, nem? Így nem kell állandóan ismételned magad, ha meg szeretnéd változtatni az ember nevét, akinek a függvény köszön. Pont emiatt van szükségünk függvényekre - soha ne ismételd meg a kódodat!
+Ez fantasztikus, nem? Így nem kell állandóan ismételned magad, ha meg szeretnéd változtatni az ember nevét, akinek a függvény köszön. And that's exactly why we need functions – you never want to repeat your code!
 
-Most csináljunk valami okosabbat - több mint két név van a világon, és nehéz lenne mindegyikhez egy külön feltételt írni, nem?
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
-    def hi(name):
-        print('Hi ' + name + '!')
-    
-    hi("Rachel")
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
 ```
 
 Most hívjuk meg a kódot:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hi Rachel!
     
@@ -766,38 +972,48 @@ Gratulálunk! Megtanultad, hogy kell függvényeket írni :)
 
 ## Ciklusok (loopok)
 
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
 Ez már tényleg az utolsó rész. Gyors volt, nem igaz? :)
 
 A programozók nem szeretik ismételni magukat. A programozás arról szól, hogy dolgokat automatizáljunk, így nem kell minden alkalommal kézzel beírni mindenkinek a nevét, akit üdvözölni akarunk. Ilyenkor jönnek jól a ciklusok.
 
 Még emlékszel a listákra? Írjunk egy listát lányokból:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-    girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
 ```
 
 Mindegyiküket üdvözölni szeretnénk. Ehhez már megvan a `hi` függvényünk, tegyük bele egy loopba:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-    for name in girls:
+for name in girls:
 ```
 
-A ```for``` statement hasonlóan működik, mint az ```if``` statement; mindkettő alatt 4 szóközzel kell indentálni a következő sort.
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
 
 Itt a teljes kód, ami a fájlban lesz:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-    def hi(name):
-        print('Hi ' + name + '!')
-    
-    girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
-    for name in girls:
-        hi(name)
-        print('Next girl')
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
 ```
 
 És amikor futtatjuk:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hi Rachel!
     Next girl
@@ -815,12 +1031,17 @@ Amint láthattad, minden, amit indentálva a `for` statementbe tettél, megismé
 
 A `for`-t számokon is használhatod, a `range` függvénnyel:
 
-    for i in range(1, 6):
-        print(i)
-    
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
 
 Ezt kapjuk:
 
+{% filename %}command-line{% endfilename %}
+
     1
     2
     3
@@ -830,14 +1051,12 @@ Ezt kapjuk:
 
 A `range` függvény létrehoz egy egymás után következő számokból álló listát (ezeket a számokat te adod meg paraméterként).
 
-Figyeld meg, hogy a két szám közül a második már nincs benne a listában, amit a Python visszaad (vagyis a `range(1, 6)` 1-től 5-ig számol, de nem tartalmazza a 6-ot). Ez azért van, mert a "range" félig nyitott, ez pedig azt jelenti, hogy az első értéket tartalmazza, de az utolsót már nem.
+Figyeld meg, hogy a két szám közül a második már nincs benne a listában, amit a Python visszaad (vagyis a `range(1, 6)` 1-től 5-ig számol, de nem tartalmazza a 6-ot). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
 
 ## Összefoglaló
 
 Meg is vagyunk. **Szuper vagy!** Ez egy nehéz fejezet volt, büszke lehetsz magadra. Mi nagyon büszkék vagyunk rád, amiért idáig eljutottál!
 
-Most talán tarthatnál egy kis szünetet - nyújtózkodj, sétálj egy kicsit, pihentesd a szemeidet - mielőtt továbbmennénk a következő fejezetre. :)
-
-![Cupcake][3]
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
 
- [3]: images/cupcake.png
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/hu/signup_pythonanywhere.md b/hu/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/hu/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/hu/template_extending/README.md b/hu/template_extending/README.md
index 6c517f892da..55ef90cffb5 100644
--- a/hu/template_extending/README.md
+++ b/hu/template_extending/README.md
@@ -2,9 +2,9 @@
 
 Egy másik szuper dolog, amit a Django tud, a **template extending**, vagyis template-kiegészítés. Mit jelent ez? Azt, hogy a HTML-ed egyes részeit több oldalon is fel tudod használni az alkalmazásodban.
 
-Így nem kell megismételned magad minden fájlban, ha ugyanazt az információt szeretnéd felhasználni, vagy ugyanolyan layout-ot tervezel. És ha meg szeretnél változtatni valamit, nem kell minden sablonban külön megtenned, csak egyszer!
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
 
-## Hozd létre az alap template-et
+## Create a base template
 
 A base (alap) template a legegyszerűbb sablon, amit az alkalmazásod összes oldalán kiegészítesz.
 
@@ -19,6 +19,8 @@ Hozz létre egy `base.html` fájlt a `blog/templates/blog/`-ban:
 
 Majd nyisd meg, és másolj át mindent a `post_list.html`-ből a `base.html`-be, így:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -55,6 +57,8 @@ Majd nyisd meg, és másolj át mindent a `post_list.html`-ből a `base.html`-be
 
 Aztán a `base.html`-ben cseréld ki az egész `<body>`-t (mindent a `<body>` és a `</body>` között) erre:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <body>
     <div class="page-header">
@@ -71,16 +75,20 @@ Aztán a `base.html`-ben cseréld ki az egész `<body>`-t (mindent a `<body>` é
 </body>
 ```
 
-Lényegében a `{% for post in posts %}{% endfor %}` részt kicseréltük erre:
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% block content %}
 {% endblock %}
 ```
 
-Ez mit is jelent? Létrehoztál egy `block`-ot. Ez egy olyan template tag, amely segítségével HTML-t illeszthetsz be a blokkba más template-ekben, ezzel kiegészítve a `base.html`-t. Máris megmutatjuk, hogy működik.
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). Máris megmutatjuk, hogy működik.
 
-Most mentsd el, és nyisd meg újra a `blog/templates/blog/post_list.html`-t. Törölj ki mindent a body-n kívül, és a `<div class="page-header"></div>` részt is, hogy így nézzen ki a fájl:
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
@@ -94,12 +102,29 @@ Most mentsd el, és nyisd meg újra a `blog/templates/blog/post_list.html`-t. T
 {% endfor %}
 ```
 
-És most add hozzá ezt a sort a fájl elejéhez:
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
 
-    {% extends 'blog/base.html' %}
-    
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Így:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
 
-{% raw %}Ez azt jelenti, hogy most a `base.html` template-et egészítjük ki a `post_list.html`-ben. Már csak egy dolog van hátra: az előző sor kivételével rakj mindent `{% block content %}` és `{% endblock %}` közé. Így:{% endraw %}
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -117,6 +142,6 @@ Most mentsd el, és nyisd meg újra a `blog/templates/blog/post_list.html`-t. T
 {% endblock %}
 ```
 
-Ez az! Nézd meg, hogy még mindig működik-e a weboldalad :)
+Ez az! Nézd meg, hogy még mindig működik-e a weboldalad. :)
 
-> Ha `TemplateDoesNotExists` (a template nem létezik) hibát kapsz, ami azt mondja, nincs `blog/base.html` fájlod, és fut a `runserver` a konzolban, próbáld meg leállítani (Ctrl+C-vel, vagyis egyszerre nyomd meg a Control és a C billentyűt) és indítsd el újra a `python manage.py runserver` paranccsal.
\ No newline at end of file
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/hu/whats_next/README.md b/hu/whats_next/README.md
index 1ce0d03b72a..623fccb3139 100644
--- a/hu/whats_next/README.md
+++ b/hu/whats_next/README.md
@@ -6,35 +6,20 @@ Gratulálj magadnak! **Szuper vagy**. Nagyon büszkék vagyunk rád! <3
 
 Tarts egy kis szünetet, és pihenj. Valami egészen hatalmas dolgot csináltál.
 
-Aztán majd ne felejtsd el:
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
 
-*   Követni a Django Girlst [Facebook][1]on vagy [Twitter][2]en, hogy mindenről értesülj
+### Tudunk-e ajánlani bármilyen tananyagot?
 
- [1]: http://facebook.com/djangogirls
- [2]: https://twitter.com/djangogirls
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
 
-### Tudunk-e ajánlani bármilyen tananyagot?
+Later on, you can try the resources listed below. They're all very recommended!
 
-Igen! Először is nézd meg a másik könyvünket, a [Django Girls Tutorial: Extensions][3]-t.
-
- [3]: https://tutorial-extensions.djangogirls.org
-
-Később megpróbálkozhatsz a lenti listában lévő anyagokkal is. Ezeket mind nagyon ajánljuk!
-
-- [Django's official tutorial][4]
-- [New Coder tutorials][5]
-- [Code Academy Python course][6]
-- [Code Academy HTML & CSS course][7]
-- [Django Carrots tutorial][8]
-- [Learn Python The Hard Way book][9]
-- [Getting Started With Django video lessons][10]
-- [Two Scoops of Django: Best Practices for Django 1.8 book][11]
-
- [4]: https://docs.djangoproject.com/en/1.11/intro/tutorial01/
- [5]: http://newcoder.io/tutorials/
- [6]: https://www.codecademy.com/en/tracks/python
- [7]: https://www.codecademy.com/tracks/web
- [8]: https://github.com/ggcarrots/django-carrots/
- [9]: http://learnpythonthehardway.org/book/
- [10]: http://www.gettingstartedwithdjango.com/
- [11]: https://twoscoopspress.com/products/two-scoops-of-django-1-8
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/hy-AM/GLOSSARY.md b/hy-AM/GLOSSARY.md
new file mode 100644
index 00000000000..800d5339124
--- /dev/null
+++ b/hy-AM/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor- ը ծրագիր է, որը թույլ է տալիս պահպանել ձեր կոդը, որպեսզի հետագայում կկարողանաք վերադառնալ դրան: Դուք կարող եք իմանալ, թե որտեղից կարելի է այն ձեռք բերել [ Code editor chapter ](./code_editor/README.md)
\ No newline at end of file
diff --git a/hy-AM/README.md b/hy-AM/README.md
new file mode 100644
index 00000000000..86243645c21
--- /dev/null
+++ b/hy-AM/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 միջազգային լիցենզիայով: Այս արտոնագրի պատճենը դիտելու համար այցելեք https://creativecommons.org/licenses/by-sa/4.0/
+
+## Բարի գալուստ
+
+Բարի գալուստ Django Girls ձեռնարկը: Մենք ուրախ ենք ձեզ այստեղ տեսնել: :) Այս ձեռնարկի ընթացքում մենք ձեզ ճանապարհորդելու ենք վեբ տեխնոլոգիաների տակ, առաջարկելով ձեզ մի ակնարկ այն բոլոր կտորների մասին, որոնք անհրաժեշտ է միավորել, որպեսզի համացանցն աշխատի այնպես, ինչպես մենք գիտենք:
+
+Ինչպես բոլոր անհայտ բաների դեպքում, սա էլ կլինի արկածախնդրություն, բայց ոչ մի անհանգստություն, քանի որ դուք արդեն համարձակություն եք գործադրել այստեղ լինելու համար, լավ կլինեք: :)
+
+## Ներածություն
+
+Երբևէ զգացե՞լ եք, որ աշխարհն ավելի ու ավելի շատ է վերաբերում այն ​​տեխնոլոգիային, որի հետ (դեռ չեք կարող) առնչվել: Երբևէ մտածե՞լ եք, թե ինչպես ստեղծել կայք, բայց երբևէ բավարար շարժառիթ չի՞ ունեցել գործելու: Երբևէ մտածե՞լ եք, որ ծրագրակազմի աշխարհը չափազանց բարդ է ձեզ համար, որպեսզի փորձեք նույնիսկ ինքնուրույն ինչ-որ բան անել:
+
+Դե, մենք լավ լուր ունենք ձեզ համար: Ծրագրավորումն այնքան էլ դժվար չէ, որքան թվում է, և մենք ուզում ենք ցույց տալ, թե որքան զվարճալի կարող է լինել:
+
+Այս ձեռնարկը կախարդական կերպով չի վերածի ձեզ ծրագրավորողի: Եթե ​​ցանկանում եք դրանում լավ տիրապետել, ձեզ հարկավոր են ամիսներ կամ նույնիսկ տարիներ սովորել և պրակտիկայով զբաղվել: Բայց մենք ուզում ենք ձեզ ցույց տալ, որ կայքերի ծրագրավորումը կամ ստեղծումը այնքան էլ բարդ չէ, որքան թվում է: Մենք կփորձենք բացատրել տարբեր կտորներ և կտորներ, ինչպես կարող ենք, այնպես որ դուք ձեզ ահաբեկված չեք զգա տեխնոլոգիայից:
+
+Հուսով ենք, որ կկարողանանք այնպես անել, որ դուք սիրեք տեխնոլոգիան, ինչպես մեզ:
+
+## Ի՞նչ կսովորեք ձեռնարկի ընթացքում:
+
+Ձեռնարկն ավարտելուց հետո դուք կունենաք մի փոքր աշխատող վեբ հավելված ՝ ձեր սեփական բլոգը: Մենք ձեզ ցույց կտանք, թե ինչպես տեղադրել այն առցանց, այնպես որ մյուսները կտեսնեն ձեր աշխատանքը:
+
+Դա (քիչ թե շատ) այսպիսի տեսք կունենա.
+
+![Figure 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 սեմինարին, բայց մենք տեղյակ ենք, որ միշտ չէ, որ հնարավոր է մեկին մասնակցել: Ահա թե ինչու մենք ձեզ խրախուսում ենք փորձել հետեւել այս ձեռնարկին տանը: Ընթերցողների համար տանը մենք ներկայումս պատրաստում ենք տեսանյութեր, որոնք ավելի հեշտ կդարձնեն ձեռնարկին ինքնուրույն հետևելը: Դա դեռ ընթացքի մեջ է, բայց շուտով ավելի ու ավելի շատ բաներ լուսաբանվելու են [ Կոդավորումը աղջիկների համար ](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube ալիքում:
+
+Արդեն լուսաբանված յուրաքանչյուր գլխում կա մի հղում, որը մատնանշում է ճիշտ տեսանյութը:
+
+## Մասին և ներդրում
+
+Այս ձեռնարկը վարում է [ DjangoGirls ](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) ՝ տեղեկացնելով մեզ լեզվի մասին, որպեսզի կարողանանք ավելացնել այն:
\ No newline at end of file
diff --git a/hy-AM/SUMMARY.md b/hy-AM/SUMMARY.md
new file mode 100644
index 00000000000..b95ca764cf9
--- /dev/null
+++ b/hy-AM/SUMMARY.md
@@ -0,0 +1,35 @@
+# Ամփոփում
+
+* [Ներածություն](README.md)
+* [Installation (Տեղադրում)](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook) (Տեղադրում)](chromebook_setup/README.md)
+* [Ինչպես է աշխատում ինտերնետը](how_the_internet_works/README.md)
+* [ Command line-ի (Հրամանի տողի) ներածություն](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!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [ Django views- Ստեղծագործելու ժամանակն է:](django_views/README.md)
+* [ HTML- ի ներածություն](html/README.md)
+* [ Django ORM (Querysets)](django_orm/README.md)
+* [Դինամիկ տվյալներ կաղապարներում](dynamic_data_in_templates/README.md)
+* [ Django templates (կաղապարներ)](django_templates/README.md)
+* [ CSS - դարձրեք այն գեղեցիկ](css/README.md)
+* [Template extending](template_extending/README.md)
+* [ Ընդլայնել ձեր դիմումը](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [ Ի՞նչ է հաջորդը](whats_next/README.md)
\ No newline at end of file
diff --git a/hy-AM/chromebook_setup/README.md b/hy-AM/chromebook_setup/README.md
new file mode 100644
index 00000000000..e3f529a8c5f
--- /dev/null
+++ b/hy-AM/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook տեղադրում
+
+> ** Նշում ** Եթե դուք արդեն աշխատել եք [installation steps](../installation/README.md) (ներբեռնման), ապա այլևս կարիգ չկա դա կրկնել. կարող եք անմիջապես անցնել [Introduction to Python](../python_introduction/README.md) (Python- ի Ներածություն) բաժնին: 
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/hy-AM/chromebook_setup/instructions.md b/hy-AM/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..573fd234ee3
--- /dev/null
+++ b/hy-AM/chromebook_setup/instructions.md
@@ -0,0 +1,159 @@
+Եթե ​​Chromebook չեք օգտագործում, կարող եք անմիջապես անցնել այս բաժնի վրայով: Եթե ​​այո, ձեր տեղադրման փորձը մի փոքր այլ կլինի: Դուք կարող եք անտեսել այն տեղադրման հրահանգների մնացած հատվածը:
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE- ը գործիք է, որը Ձեզ տալիս է կոդերի խմբագրման և ինտերնետ համակարգչից օգտվելու հնարավորություն, որի վրա կարող ես տեղադրել, գրել և գործարկել ծրագրային ապահովումը: предоставляющий тебе редактор кода и доступ к компьютеру в интернете, на котором ты можешь установить, записать и выполнить программу. Այս դասընթացի շրջանակներում Cloud IDE-ին կօգտագործվի որպես Ձեր *տեղային գործիք *. Դուք աշխատելու եք տերմինալում (ինչպես և ձեր դասընկերները OS X- ում, Ubuntu- ում կամ Windows- ում), բայց ձեր տերմինալը միացված կլինելու այն համակարգչին, որը գտնվում է Նիդեռլանդներում կամ Գերմանիայում, որը cloud IDE- ը ստեղծել է հատուկ Ձեզ համար: Ահա ամպային IDE- ների ցուցումները (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com): Դուք կարող եք ընտրել ամպային IDE- ներից մեկը եւ հետեւեք IDE ամպի հրահանգին:
+
+#### PaizaCloud Cloud IDE 
+
+1. Գնալ [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Ստեղծել account
+3. Սեղմեք *New Server* և ընտրեք Django app
+4. Սեղմեք Terminal կոճակը (պատուհանի ձախ կողմում)
+
+Այժմ դուք պետք է տեսնեք ինտերֆեյս՝ լուսանցքի նշումով և ձախ կողմում գտնվող կոճակներ: Կտտացրեք «Տերմինալ» կոճակին ՝ տերմինալի պատուհանը բացելու համար ՝ հետևյալ հաղորդագրությամբ.
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+PaizaCloud Cloud IDE- ի տերմինը պատրաստ է ձեր հրահանգներին: Կարող եք կրկնել կամ մեծացնել այդ պատուհանը, որպեսզի դա մի փոքր ավելի մեծ լինի:
+
+#### AWS Cloud9 
+
+Այժմ Cloud 9-ը պահանջում է, որ դուք գրանցվեք AWS համակարգով և մուտքագրեք կրեդիտ քարտի տվյալները:
+
+1. Ներբեռնեք Cloud 9-ը [ Chrome վեբ խանութից ](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Անցեք [c9.io](https://c9.io)էջին և կտտացրեք *Get started with AWS Cloud9*
+3. Գրանցվել AWS հաշվի համար (պահանջվում է կրեդիտ քարտի տվյալները, բայց այն կարող եք օգտագործել անվճար)
+4. AWS կառավարման վահանակում որոնման տողում մուտքագրեք * Cloud9 * և կտտացրեք այն
+5. Cloud 9-ի կառավարման վահանակում կտտացրեք * Ստեղծել միջավայր *
+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 համակարգչին: Կարող եք փոփոխել այդ պատուհանի չափերը այն մի փոքր մեծացնելով:
+
+#### Glitch.com Cloud IDE
+
+1. Գնացեք [ Glitch.com ](https://glitch.com/)
+2. Գրանցվեք հաշվի համար (https://glitch.com/signup) կամ օգտագործեք ձեր GitHub հաշիվը, եթե ունեք: (Տե՛ս GitHub- ի ցուցումները ստորև):
+3. Սեղմեք * New Project (Նոր նախագիծ )* և ընտրեք * hello-webpage (բարև-կայք) *
+4. Սեղմեք «Գործիքներ» ցանկի ցուցակի վրա (պատուհանի ներքևի ձախ կողմում), ապա «Տերմինալ» կոճակին ՝ տերմինալի ներդիրը բացելու համար ՝ այսպիսի հուշմամբ.
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+Glitch.com- ը որպես Cloud IDE օգտագործելիս անհրաժեշտ չէ վիրտուալ միջավայր ստեղծել: Փոխարենը, ձեռքով ստեղծեք հետևյալ ֆայլերը.
+
+{% 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
+```
+
+Այս ֆայլերը ստեղծվելուց հետո անցեք Տերմինալ և կատարեք հետևյալ հրամանները ՝ ձեր առաջին Django նախագիծը ստեղծելու համար.
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+Որպեսզի մանրամասն սխալի հաղորդագրություններ տեսնեք, կարող եք ակտիվացնել Django debug/Django կարգաբերման տեղեկամատյանները ձեր Glitch հավելվածի համար: Պարզապես ավելացրեք հետևյալը `mysite/settings.py` ֆայլի վերջում:
+
+{% 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,
+        },
+    },
+}
+```
+
+Սա կստեղծի ` debug.log ` ֆայլ, որը մանրամասնում է Django- ի գործողությունները և ցանկացած սխալ հաղորդագրություններ, որոնք կարող են ի հայտ գալ, շատ ավելի հեշտ դարձնելով դրանց շտկումը, եթե ձեր կայքը չի աշխատում:
+
+Glitch նախագծի նախնական վերագործարկումը պետք է ձախողվի: (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+(Virtual environment) Վիրտուալ միջավայրը (որը կոչվում է նաև virtualenv) նման է մեր անձնական տուփի. մենք կարող ենք ավելացնել օգտակար համակարգչային ծածկագիր (code) այն նախագծի համար, որի շուրջ մենք աշխատում ենք: Մենք օգտագործում ենք դրանք, որպեսզի պահպանենք տարբեր ծածկագրերի կոդերի մասնիկներ առանձին, այնպես որ դրանք չխառնվեն այլ նախագծերի հետ:
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(նշենք, որ վերջին տողի վրա մենք օգտագործում ենք ալիք, որին հաջորդում է հավասար նշանը ՝ ` ~ = `):
+
+### GitHub
+
+Ստեղծեք GitHub հաշիվ:
+
+### PythonAnywhere 
+
+Django Girls ձեռնարկը ներառում է բաժին այն մասին, թե ինչ է կոչվում Տեղակայում/Deployment-ը որը ձեր նոր վեբ հավելվածն աշխատեցնող ծածկագիր ստանալու գործընթացն է և տեղափոխումն այն հանրությանը հասանելի համակարգիչ (կոչվում է սերվեր/server) և այլն մարդիկ կարող են տեսնել ձեր աշխատանքը:
+
+Այս բաժինը մի փոքր տարօրինակ է, երբ մեզ մոտ Chromebook է, քանի որ մենք արդեն օգտագործում ենք համակարգիչ, որը գտնվում է ինտերնետային տիրույթում (ի տարբերություն, ասենք, նոութբուքի): Այնուամենայնիվ, այն դեռ օգտակար է, քանի որ մենք կարող ենք մեր Cloud 9 -ի աշխատանքային տարածքը համարել որպես «ընթացքի մեջ»/"in progress" գտնվող աշխատանքների տիրույթ, իսկ Python Anywhere-ը ՝ պատրաստի աշխատանքները ցուցադրելու տիրույթ, քանի որ այն ավելի ամբողջական տեսք ունի:
+
+Այսպիսով, գրանցվեք Python Anywhere նոր հաշվի համար ՝ [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/hy-AM/code_editor/README.md b/hy-AM/code_editor/README.md
new file mode 100644
index 00000000000..6c2d23cd2d7
--- /dev/null
+++ b/hy-AM/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor 
+
+> Տնային ուսուցման համար. Այս գլուխն ընդգրկված է [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.(Python-ի և տեքստի խմբագրի ծրագրերի ներբեռնումը:
+
+Դուք պատրաստվում եք գրել ձեր առաջին ծածկագիրը (cod-ը), այնպես որ ժամանակն է ներբեռնել ծածկագրի խմբագիր:
+
+> **Հավելում** :Եթե Chromebook եք օգտագործում, բաց թողեք այս գլուխը և համոզվեք, որ հետևում եք [Chromebook Setup](../chromebook_setup/README.md) (Chromebook- ի կարգավորման) հրահանգներին: Ձեր ընտրած ամպի IDE- ն (PaizaCloud Cloud IDE կամ AWS Cloud9) պարունակում է կոդի խմբագիր, և երբ ձեր IDE- ում ֆայլ եք բացում File ընտրացանկից, դուք ավտոմատ կերպով օգտագործում եք խմբագիր:
+> 
+> Նշում. գուցե դուք դա արել եք ավելի վաղ [Installation chapter](../installation/README.md) (տեղադրման գլխում). Եթե այո, ապա կարող եք անմիջապես անցնել հաջորդ գլխին:
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/hy-AM/code_editor/instructions.md b/hy-AM/code_editor/instructions.md
new file mode 100644
index 00000000000..a9abc2d9718
--- /dev/null
+++ b/hy-AM/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Կան շատ տարբեր խմբագիրներ, և դա հիմնականում կախված է անձնական նախասիրություններից: Շատ Python ծրագրավորողներ օգտագործում են բարդ, բայց միևնույն ժամանակ հզոր IDE֊ներ (Integrated Development Environments - Միասնական Նախագծման Միջավայր), ինչպիսն է օրինակ PyCharm֊ը։ Որպես սկսնակ, դա, հավանաբար, ավելի քիչ հարմար է, սակալյն մեր առաջարկությունները հավասարապես հզոր են, բայց շատ ավելի պարզ:
+
+Մեր առաջարկները ներկայացված են ստորև, բայց ազատորեն հարցրեք ձեր մարզչին, թե որոնք են իրենց նախընտրությունները. Նրանցից օգնություն ստանալն շատ ավելի հեշտ կլինի:
+
+## Visual Studio Code 
+
+Visual Studio Code- ը նախատեսված է կոդերի խմբագրման համար: Այն ստեղծված՝է Microsoft- ի կողմից Windows- ի, Linux- ի և macOS- ի համար: Այն իր մեջ ներառում է վրիպազերծիչ, ներդրված Git կառավարում, շարահյուսության լուսաբանման, խելացի կոդի ինքնալրացման և կոդի վերափոխման գործիքներ:
+
+[Ներբեռնիր այն այստեղից](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit- ը բաց կոդով, անվճար խմբագիր է, որը հասանելի է բոլոր օպերացիոն համակարգերի համար:
+
+[Ներբեռնիր այն այստեղից](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3 
+
+Sublime Text- ը շատ ճանաչված խմբագիր է `անվճար գնահատման փորձաշրջանով, և այն հասանելի է բոլոր օպերացիոն համակարգերի համար:
+
+[Ներբեռնիր այն այստեղից](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom- ը ևս մեկ սիրված խմբագիր է: Այն անվճար է, ազատ և բաց ծրագրային ապահովմամբ (բաց կոդով) և հասանելի է Windows- ի, OS X- ի և Linux- ի համար: Ատոմը մշակվում է [ GitHub ](https://github.com/) - ի կողմից:
+
+[Ներբեռնիր այն այստեղից](https://atom.io/)
+
+## Ինչու՞ է մեզ անհրաժեշտ կոդերի խմբագիր:
+
+Կարող եք հարցնել. Ինչու՞ տեղադրել կոդերի խմբագրման առանձին ծրագիր, երբ կարող ենք օգտագործել Word- ը կամ Notepad- ը:
+
+Առաջին պատճառն այն է, որ կոդը պետք է լինի ** պարզ տեքստ**, իսկ խնդիրը կապված Word- ի և Textedit- ի հետ այն է, որ նրանք չեն պահպանում կոդը այդ տեսքով, այլ օգտագործում են հարստացված տեքստեր (ներառելով տառատեսակը և ձևաչափը), ինչպիսիք են [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format): 
+
+Երկրորդ պատճառն այն է, որ մասնագիտացված խմբագիրները տրամադրում են բազմաթիվ օգտակար ծրագրավորման առանձնահատկություններ, ինչպիսիք են գունային կոդով ծածկագրված ծածկագիրը `ըստ դրա նշանակության և ավտոմատ փակվող չակերտների:
+
+Հետագայում այդ ամենը գործի մեջ կտեսնենք: Շուտով դուք կսկսեք մտածել ձեր կոդերի խմբագրի մասին `որպես փորձված ու իսկական սիրված գործիք :)
\ No newline at end of file
diff --git a/hy-AM/css/README.md b/hy-AM/css/README.md
new file mode 100644
index 00000000000..921be5c7867
--- /dev/null
+++ b/hy-AM/css/README.md
@@ -0,0 +1,331 @@
+# CSS - դարձրեք այն գեղեցիկ:
+
+Մեր բլոգը դեռ բավականին վատ տեսք ունի, այնպես չէ՞: Ժամանակն է այն ավելի գրավիչ դարձնել: Դրա համար մենք կօգտագործենք CSS:
+
+## Ի՞նչ է CSS- ը:
+
+Cascading Style Sheets (CSS-կասկադի ոճի թերթեր) դա լեզու է, որն օգտագործվում է նշագրման լեզվով գրված կայքի տեսքն ու ձևաչափումը նկարագրելու համար (ինչպես HTML-ն է): Համարեք սա որպես դիմահարդարում մեր կայքի համար :)
+
+Բայց մենք չենք ուզում զրոյից սկսել, այնպես չէ՞: Մենք կօգտագործենք այն ամենը, ինչ այլ ծրագրավորողներ տեղադրել են ինտերնետում անվճար: Նորից անվադող հորինելն այնքան էլ հետաքրքիր չէ :)
+
+## Եկեք օգտագործենք Bootstrap!
+
+Bootstrap- ը գեղեցիկ կայքեր մշակելու ամենատարածված HTML և CSS շրջանակներից մեկն է. Https://getbootstrap.com/
+
+Այն գրվել է Twitter ծրագրավորողների կողմից, իսկ այժմ մշակվում է կամավորների կողմից ամբողջ աշխարհից:
+
+## Տեղադրեք Bootstrap- ը
+
+Bootstrap- ը տեղադրելու համար խմբագրում բացեք ` .html ` կոդը պարունակող ֆայլը և այս տողերն ավելացրեք `<head>` վերնագրում.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %} 
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+
+```
+
+Սա ձեր ծրագրին ոչ մի ֆայլ չի ավելացնի: Այս կոդը պարզապես ցույց է տալիս, որ այդ ֆայլերը գոյություն ունեն ինտերնետում: Այսպիսով, բացեք կայքը և թարմացրեք էջը: Ահա՝ դուք կտեսնեք փոփոխությունները:
+
+![Պատկեր 14.1](images/bootstrap1.png)
+
+Արդեն ավելի գեղեցիկ տեսք ունի:
+
+## Ստատիկ ֆայլեր Django- ում
+
+Վերջապես, մենք ավելի մանրամասն կանդրադառնանք այն ամենին, ինչ կոչվում է **static files** (ստատիկ ֆայլեր): Ստատիկ ֆայլերը` բոլոր CSS ֆայլերը և պատկերներ են: Դրանց բովանդակությունը կախված չէ հարցման ենթատեքստից և արդյունքը նույնը կլինի յուրաքանչյուր օգտագործողի համար:
+
+### Որտե՞ղ տեղադրել ստատիկ ֆայլեր Django- ում:
+
+Django- ն արդեն գիտի, թե որտեղ կարելի է գտնել ստատիկ ֆայլերը «ադմինիստրատոր» ներդրված ծրագրի համար: Այժմ մենք պետք է ստատիկ ֆայլեր ավելացնենք մեր սեփական ծրագրում ՝ `blog` (բլոգ):
+
+Մենք դա կանենք ՝ ստեղծելով `static` folder (ստատիկ պանակ) մեր բլոգի հավելվածի ներսում:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django- ն ձեր ծրագրի պանակների մեջ ավտոմատ կերպով կգտնի «ստատիկ» կոչվող ցանկացած պանակ: Այնուհետև դրանց բովանդակությունը կարող եք օգտագործել որպես ստատիկ ֆայլեր:
+
+## Ձեր առաջին CSS ֆայլը:
+
+Եկեք ստեղծենք CSS ֆայլ ՝ ձեր վեբ էջում ձեր սեփական ոճը ստեղծելու համար: Ստեղծեք նոր ` css ` պանակ `static` (ստատիկ) պանակի ներսում: Դրանից հետո ստեղծեք ` blog.css ` կոչվող նոր ֆայլ այս ` css ` պանակի ներսում: Պատրա՞ստ եք
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Ժամանակն է գրել CSS մի քանի տող: Ձեր կոդի խմբագրիչում բացեք `blog/static/css/blog.css` ֆայլը:
+
+Այս դասընթացում մենք չենք կենտրոնանալու CSS-ի ուսուցման մեջ: Էջի վերջում առաջարկվում են անվճար CSS դասընթացներ, եթե ցանկանում եք ինքնուրույն սովորել CSS:
+
+Բայց եկեք պարզապես մի փոքր ուսումնասիրենք: Գուցե՞ մենք կարող ենք փոխել մեր վերնագրերի գույները: Գույները հասկանալու համար համակարգիչները օգտագործում են հատուկ ծածկագրեր (կոդեր): Այս կոդերը սկսվում են ` # ` - ից, որին հաջորդում են 6 տառ (A – F) և թվեր (0–9): Օրինակ ՝ կապույտի կոդը `#0000FF` է: Շատ գույների գունային կոդերը կարող եք գտնել այստեղ ՝ http://www.colorpicker.com/: Կարող եք նաև օգտագործել [ կանխորոշված ​​գույներ ](http://www.w3schools.com/colors/colors_names.asp), ինչպիսիք են `red` և `green` (կարմիրը և կանաչը).
+
+Ձեր ` blog/static/css/blog.css ` ֆայլում պետք է ավելացնեք հետևյալ ծածկագիրը.
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+` h1 a ` - ը CSS ընտրող է: Սա նշանակում է, որ մենք օգտագործում ենք մեր ոճերը `a`տարրի ներսում գտնվող ցանկացած `h1` տարրի նկատմամբ; `h2 a` ընտրիչը նույնն է անում`h2`տարրերի համար: Այսպիսով, երբ մենք ունենք `<h1><a href="">link</a></h1>` պես մի բան, կկիրառվի `h1 a` ոճը: Այս դեպքում մենք հրահանգում ենք, որ այն փոխի իր գույնը և դարձնի `#C25100`, որը մուգ նարնջագույն է: Կամ կարող եք այստեղ տեղադրել ձեր սեփական գույնը, բայց համոզված լինելով, որ այն լավ հակադրություն ունի սպիտակ ֆոնի վրա:
+
+CSS ֆայլում մենք որոշում ենք HTML ֆայլի տարրերի ոճերը: Էլեմենտները նույնացնելու առաջին եղանակը դրանց անվանումներն են: Պետք է հիշել այս պիտակները (tag-երը) HTML- ից: ` a `, ` h1 `, և ` body ` սրանք բոլորը տարրերի անունների օրինակներ են: Մենք նաև տարրերը նույնացնում ենք ըստ հատկանիշի `class` կամ հատկանիշը `id`. Class և id-ը անուններ են, որոնք դուք ինքներդ եք վերագրում տարրերին: Դասերը (сlass) սահմանում են տարրերի խմբեր, իսկ նույնացուցիչները (id) մատնանշում են հատուկ տարրեր: Օրինակ, դուք կարող եք նույնականացնել հետևյալ տարրը ՝ օգտագործելով տարրի անունը
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+CSS ընտրողների մասին ավելին կարող եք կարդալ այստեղ [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+Մենք նաև պետք է մեր HTML ձևանմուշին ասենք, որ մենք ավելացրել ենք CSS ոճեր: Կոդի խմբագրում բացեք `blog/templates/blog/post_list.html` ֆայլը և հենց սկզբում ավելացրեք այս տողը. 
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Մենք պարզապես ներբեռնում ենք ստատիկ ֆայլեր :) `<head>` և `</head>` միջև, Bootstrap CSS ֆայլեր ֆայլերից հետո, ավելացրեք այս տողը.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Բրաուզերը կարդում է ֆայլերը տրված հերթականությամբ, ուստի մենք պետք է համոզվենք, որ դրանք ճիշտ տեղում են: Հակառակ դեպքում, մեր ֆայլի կոդը կարող է գերակշռվել կոդով Bootstrap ֆայլերում: Մենք պարզապես պատմեցինք մեր ձևանմուշին (template), թե որտեղ է գտնվում մեր CSS ֆայլը:
+
+Ձեր ֆայլն այժմ պետք է ունենա այսպիսի տեսք.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Շատ լավ, պահեք ֆայլը և թարմացրեք կայքը:
+
+![Պատկեր 14.2](images/color2.png)
+
+Հիանալի աշխատանք: Գուցե մենք ցանկանում ենք մեր կայքին որոշակի տարածք և ձախ հատվածում լուսանցք ավելացնել: Եկեք փորձենք!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Ավելացրեք դա ձեր CSS- ին, պահեք ֆայլը և տեսեք, թե ինչպես է այն աշխատում:
+
+![Պատկեր 14.3](images/margin2.png)
+
+Միգուցե կարո՞ղ ենք հարմարեցնել մեր վերնագրի տառատեսակը: Տեղադրեք սա `<head>` in `blog/templates/blog/post_list.html` ձեր ֆայլում:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Ինչպես նախկինում, ստուգեք հրահանգը և տեղադրեք `blog/static/css/blog.css` հղումը: Այս տողում Google Fonts- ից (https://www.google.com/fonts) ներմուծեք * Lobster * կոչվող տառատեսակը:
+
+Գտեք ` h1 a ` հայտարարագրի բլոկը (ամրագոտիների միջեւ ծածկագիրը ` {` և `} `) CSS ֆայլում ` blog/static/css/blog.css` Ձևավոր փակագծերի միջև ավելացրեք `font-family: 'Lobster';` տողը և թարմացրեք էջը.
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Պատկեր 14.3](images/font.png)
+
+Հիանալի է!
+
+Ինչպես նշվեց վերևում, CSS- ն ունի դասակարգման հասկացություն: Դրանք թույլ են տալիս անվանել HTML կոդի մի մաս և կիրառել ոճեր միայն այդ մասի վրա ՝ առանց այլ մասերի վրա ազդելու: Սա կարող է շատ օգտակար լինել: Գուցե դուք ունեք երկու բաժիններ, որոնք տարբեր դերեր ունեն (ինչպես օրինակ վերնագիրն և բուն հաղորդագրությունը): Դասակարգումը (Class) կարող է օգնել ձեզ տարբեր տեսքեր ստանալ:
+
+Առաջ անցնենք և անվանեք HTML կոդի որոշ մասեր: Փոխարինեք Ձեր վերնագիրը հետևյալով `header` :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+Եվ հիմա ձեր ` post` ավելացրեք դասի ` article` բլոգի գրառում պարունակող: 
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Այժմ եկեք ավելացնենք բլոկի սահմանումները տարբեր ընտրողների համար: Selector-ները (ընտրողները), որոնք սկսվում են ` - ով: ` դասին հատուկ են: Համացանցում կան բազմաթիվ հիանալի հղումներ և բացատրություններ CSS- ի վերաբերյալ, որոնք կարող են օգնել ձեզ հասկանալ հետևյալ կոդը: Առայժմ, պատճենեք և տեղադրեք այն ձեր `blog/static/css/blog.css` ֆայլում.
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Հետո, փոփոխեք հաղորդագրությունները ցուցադրող HTML կոդը: Փոխարինեք սարանով ՝
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+`blog/templates/blog/post_list.html`-ում սրանով
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Պահեք այդ ֆայլերը և թարմացրեք ձեր կայքը:
+
+![Պատկեր 14.4](images/final.png)
+
+Օօօօ Հիանալի տեսք ունի, այնպես չէ՞ Նայեք մեր տեղադրած կոդին: Մենք դասակարգումներ (classes) ենք ավելացրել HTML- ին և օգտագործել դրանք CSS- ում: Որտե՞ղ կկատարեք փոփոխություն, եթե ցանկանում եք, որ ամսաթիվը փիրուզագույն լինի:
+
+Մի վախեցեք խճճվել CSS- ով `փորձեք փոխություններ անել: CSS- ով "խաղալը" կօգնի ձեզ հասկանալ, թե ինչ ֆունկցոնալություն ունեն տարբեր գործիքներ: Եթե ​​ինչ-որ բան փչացնում եք, մի անհանգստացեք. Միշտ կարող եք չեղարկել այն:
+
+Խորհուրդ ենք տալիս անցնել «Հիմնական HTML & HTML5» և «Հիմնական CSS» առցանց դասընթացներ [freeCodeCamp](https://learn.freecodecamp.org/): Դրանք կարող են օգնել ձեզ դարձնել ձեր կայքերը ավելի գեղեցիկ HTML և CSS- ին տիրապետելու միջոցով:
+
+Պատրա՞ստ եք հաջորդ գլխին: :)
\ No newline at end of file
diff --git a/hy-AM/deploy/README.md b/hy-AM/deploy/README.md
new file mode 100644
index 00000000000..f2cee3fe7e6
--- /dev/null
+++ b/hy-AM/deploy/README.md
@@ -0,0 +1,232 @@
+# Հրապարակում
+
+> **Նշում** Հաջորդ գլուխը, որոշ դեպքերում կարող է մի փոքր դժվար թվալ: Եղեք համառ և ավարտին հասցրեք այն, սերվերային կայքի տեղադրումը վեբ մշակման կարևոր մասն է: Այս գլուխը միտումնավոր տեղադրված է ձեռնարկի մեջտեղում, որպեսզի ձեր ուսուցիչը կարողանա օգնել ձեզ կայք թողարկելու բարդ գործընթացում: Այս կերպ Դուք կարող եք ինքնուրույն լրացնել բոլոր գլուխները, նույնիսկ եթե ժամանակը սուղ է:
+
+Մինչ այժմ ձեր կայքը հասանելի էր միայն ձեր համակարգչում: Այժմ դուք կսովորեք, թե ինչպես «տեղակայել/շահագործման հանձնել» ձեր կայքը: Տեղակայումը ձեր ծրագիրը ինտերնետում հրապարակելու գործընթացն է, որպեսզի մարդիկ վերջապես տեսնեն ձեր ստեղծած աշխատանքը: :) :)
+
+Ինչպես արդեն գիտեք, կայքը պետք է տեղակայված լինի սերվերի վրա: Ինտերնետում կան շատ սերվերների մատակարարներ, մենք կօգտագործենք [PythonAnywhere](https://www.pythonanywhere.com/) - ը: PythonAnywhere- ն անվճար է փոքր ծրագրերի համար, որոնք ունեն փոքր թվով այցելուներ, ինչը մեզ համար ավելի քան բավարար է:
+
+Մյուս արտաքին ծառայությունը, որը մենք կօգտագործենք, [ GitHub ](https://www.github.com) է, որը ծածկագրերի հոսթինգի (hosting-սպասարկման) ծառայություն է: Կան նաև այլ նմանատիպ ծառայություններ, բայց այսօր գրեթե յուրաքանչյուր ծրագրավորող ունի GitHub հաշիվ, և հիմա դուք նույնպես::
+
+Այս երեք տեղերը ձեզ համար կարևոր կլինեն: Ձեր տեղական համակարգիչը կլինի այն վայրը, որտեղ դուք կկատարեք մշակում և փորձարկում: Երբ գոհ լինեք փոփոխություններից, ձեր ծրագրի պատճենը կտեղադրեք GitHub- ում: Ձեր կայքը կլինի PythonAnywhere- ում, և դուք այն կթարմացնեք ՝ GitHub-ից ձեր կոդի նոր օրինակը ստանալու միջոցով:
+
+# Git
+
+> ** Նշում ** Եթե դուք արդեն կատարել եք [installation steps](../installation/README.md), (տեղադրման քայլերը), ապա դա նորից անելու անհրաժեշտություն չկա. Կարող եք անցնել հաջորդ բաժին և սկսել ստեղծել ձեր Git պահոցը:
+
+{% include "/deploy/install_git.md" %}
+
+## Ստեղծեք մեր Git պահոցը:
+
+Git- ը հետևում է ֆայլերի որոշակի հավաքածուի փոփոխությանը, որը կոչվում է պահոց (կրճատ ՝ «repo»): Եկեք ստեղծենք մեկը մեր նախագծի համար: Բացեք վահանակ և գործարկեք այս հրամանները `djangogirls` գրացուցակում.
+
+> **Նշում** Նախքան պահեստի նախնականացումը սկսեք, ստուգեք ձեր ընթացիկ աշխատանքային գրացուցակը `օգտագործելով `pwd` (Mac OS X/Linux) կամ `cd` (Windows) հրամաններ: Դուք պետք է լինեք ` djangogirls ` պանակում (folder):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Յուրաքանչյուր նախագծի համար անհրաժեշտ է նախաձևակերպել git պահոցը (git repository)միայն մեկ անգամ (և այլևս ստիպված չեք լինի կրկին մուտքագրել ձեր` օգտվողի անունն ու էլ. Փոստի հասցեն):
+
+Git- ը հետևելու է տվյալ գրացուցակի բոլոր ֆայլերի և գրացուցակների փոփոխություններին, սակայն մենք գերադասում ենք անտեսել դրանցից մի քանիսը: Դա անելու համար մենք պետք է պահեստի բազային գրացուցակում ստեղծենք ` .gitignore ` կոչվող ֆայլ: Բացեք ձեր խմբագիրը և ստեղծեք նոր ֆայլ հետևյալ բովանդակությամբ.
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    
+
+Եվ այն պահպանեք որպես ` .gitignore ` "djangogirls" արմատային գրացուցակում:
+
+> ** Նշում ** Ֆայլի անվան սկզբում գտնվող կետը կարևոր է: Եթե ​​նման ֆայլեր ստեղծելու խնդիրներ ունեք (Mac- ը թույլ չի տա ձեզ, կետով սկսվող անունով ֆայլ ստեղծել օրինակ, Finder- ի միջոցով), ապա օգտագործեք "Save As" (-պահել որպես) կոճակը ձեր կոդի խմբագրի ընտրացանկում, դա հաստատ անվտանգ է: Եվ համոզվեք, որ ֆայլի անվանման մեջ չեք ավելացնում `.txt`, `.py` կամ որևէ այլ ընդլայնում - Git- ը դա կճանաչի միայն այն դեպքում, եթե անունը պարունակում է միայն `.gitignore`.: Այն ֆայլեր, որոնց անունները սկսվում են (օրինակ `.gitignore` ով) Linux- ը և MacOS-ը դրանք ընդունում են որպես թաքնված, և սովորական `ls` հրամանը ցույց չի տալիս այս ֆայլերը: Փոխարենը օգտագործեք `ls -a` հրամանը `.gitignore` ֆայլը տեսնելու համար:
+> 
+> **Նշում** Ձեր `.gitignore` ֆայլում նշված ֆայլերից մեկը `db.sqlite3` է: Այս ֆայլը ձեր (local database) տեղական տվյալների շտեմարանն է, որտեղ պահվում են ձեր օգտվողների բոլոր գրառումները: Մենք հետևելու ենք վեբ ծրագրավորման ստանդարտ պրակտիկային, ինչը նշանակում է, որ մենք կօգտագործենք առանձին տվյալների բազաներ ձեր տեղական թեստային կայքի և PythonAnywhere- ում ձեր կենդանի կայքի համար: PythonAnywhere տվյալների բազան կարող է լինել SQLite, ճիշտ այնպես, ինչպես ձեր զարգացման սարքում, բայց սովորաբար դուք կօգտագործեք MySQL անունով շտեմարան, որը կարող է սպասարկել այցելուների շատ ավելի մեծ քանակության, քան SQLite- ը: Ամեն դեպքում, անտեսելով ձեր SQLite տվյալների շտեմարանը GitHub- ի համար, նշանակում է, որ մինչ այժմ ձեր ստեղծած բոլոր հաղորդագրություններն ու գերշահագործողները հասանելի կլինեն միայն տեղական մակարդակում, և արտադրության համար անհրաժեշտ է ստեղծել նորերը: Դուք պետք է ձեր տեղական տվյալների բազայի (local database-ի) մասին մտածեք որպես լավ խաղահրապարակ, որտեղ կարող եք փորձարկել տարբեր բաներ և չվախենալ, որ ձեր իրական գրառումները կջնջեք ձեր բլոգից:
+
+Լավ է օգտագործել `git status` (git կարգավիճակի) հրամանը նախքան`git add` (git ավելացնելը) կամ ցանկացած այլ պահ, երբ վստահ չեք, թե ինչն է փոխվել: Դա կօգնի Ձեզ զերծ մնալ տհաճ անակնկալներից, ինչպիսիք են սխալ ֆայլերի ավելացումը կամ կատարումը: `git status` (git կարգավիճակ) հրամանը վերադարձնում է տեղեկատվություն git- ում նախկինում չնկատված / փոփոխված / ներկայացված բոլոր ֆայլերի, ինչպես նաև մասնաճյուղի կարգավիճակի և այլնի մասին: Արդյունքը պետք է նման լինի հետևյալին.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Եվ վերջապես մենք կպահպանենք մեր փոփոխությունները: Անցեք վահանակին և մուտքագրեք այս հրամանները.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Հրապարակեք ձեր կոդը GitHub- ում
+
+Անցեք [GitHub.com](https://www.github.com) կայք և գրանցվեք նոր անվճար օգտվողի հաշվի համար: (Եթե դա արդեն արել եք սեմինարի նախապատրաստական ​​փուլում, հիանալի է): Համոզվեք, որ հիշում եք ձեր գաղտնաբառը (ավելացրեք այն գաղտնաբառերի կառավարչին (password manager), եթե այն օգտագործում եք):
+
+Հաջորդը, ստեղծեք նոր պահեստ ` "my-first-blog" (իմ առաջին բլոգը) անունով: "initialize with a README" վանդակը պետք չէ ընտրել, բաց թողեք .gitignore- ը (այս ֆայլը ձեռքով կստեղծենք) և թողեք License որպես None:
+
+![](images/new_github_repo.png)
+
+> **Նշում** . `my-first-blog` (իմ առաջին բլոգ) պահեստի անվանումը շատ կարևոր է: Իհարկե կարող եք այլ անվանումով հանդես գալ, բայց այն բազմիցս հանդիպում է հրահանգներում, և ամեն անգամ ստիպված կլինեք փոխել այն ձեր սեփականով: Միգուցե ավելի հեշտ է պահպանել `my-first-blog` անվանումը:
+
+Հաջորդ էկրանին կտեսնեք ձեր ռեպոյի կլոնային URL- ը, որը դուք կօգտագործեք հետևյալ հրահանգների միջոցով:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Այժմ մենք պետք է ձեր համակարգչում կապենք տեղական Git պահոցը GitHub- ի հետ:
+
+Մուտքագրեք հետևյալը ձեր վահանակի (console-ի) մեջ (փոխարինեք `<your-github-username>` - ը ձեր GitHub հաշիվը ստեղծելիս մուտքագրած օգտանունով, բայց առանց անկյունային գծերի. իսկ URL-ը պետք է համապատասխանի ձեր տեսած կլոնային URL- ին):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+GitHub մուտք գործելուց հետո ձեզանից կպահանջվի ձեր GitHub օգտվողի անունն ու գաղտնաբառը (կա՛մ հենց այնտեղ ՝ հրամանի տողի պատուհանում, կա՛մ ելնող պատուհանում), և հավատարմագրերը մուտքագրելուց հետո պետք է հայտնվի նման մի բան.
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Ձեր ծածկագիրն այժմ GitHub- ում է: Գնացեք կայք և ստուգեք այն: Այն կարող եք գտնել հիանալի ընկերություններում ինչպիսիք են՝ [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), և շատ այլ բաց կոդով ծրագրեր GitHub- ում: :)
+
+# PythonAnywhere- ում մեր բլոգի տեղադրումը
+
+## Գրանցվեք PythonAnywhere հաշվում
+
+> **Նշում** Եթե ավելի վաղ դուք արդեն գրանցվել եք PythonAnywhere հաշվում, ապա կարիգ չկա այն կրկնել:
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Մեր կայքի տեղադրումը PythonAnywhere- ում
+
+Վերադարձեք [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) հիմնական ընտրացանկ ՝ կտտացրեք պատկերանշանին և ընտրեք "Bash" վահանակը (console) գործարկելու տարբերակը. Սա PythonAnywhere-ի command line-ի (հրամանի տողի) տարբերակն է, ինչպես ձեր համակարգչում:
+
+![PythonAnywhere վեբ տարբերակի 'New Console' (Նոր վահանակ) բաժնում ՝ օգտագործելով «Bash» կոճակը](images/pythonanywhere_bash_console.png)
+
+> **Հղում** PythonAnywhere- ը հիմնված է Linux- ի վրա, այնպես որ, եթե դուք օգտագործում եք Windows, ապա console-ը (վահանակը) մի փոքր այլ տեսք կունենա ձեր համակարգչի վրա:
+
+PythonAnywhere- ում վեբ հավելվածի տեղադրումը ենթադրում է GitHub- ից ձեր կոդի բեռնումը և PythonAnywhere-ի կարգավորումը `որպեսզի այն ճանաչի և գործարկի որպես վեբ ծրագիր: Դա ձեռքով անելու եղանակներ կան, բայց PythonAnywhere- ը տրամադրում է օգնող գործիք, որն ամեն ինչ կանի ձեր փոխարեն: Եկեք նախ տեղադրենք այն.
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+Վահանակը պետք է տպի նման մի բան, ինչպիսին է `Collecting pythonanywhere` և վերջում `Successfully installed (...) pythonanywhere- (...)`.
+
+Այժմ մենք գործարկում ենք օգնականին ՝ GitHub-ից մեր հավելվածը ավտոմատ կերպով կարգավորելու համար: PythonAnyplace- ի վահանակի մեջ մուտքագրեք հետևյալ հրահանգը (մի մոռացեք օգտագործել ձեր GitHub օգտվողի անունը `<your-github-username>` -ի փոխարեն, որպեսզի URL- ը համապատասխանի GitHub-ի կլոնավորված URL- ին):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+Երբ տեսնեք, թե ինչպես է այն աշխատում, կարող եք հասկանալ, թե կոնկրետ ինչ է այն անում.
+
+- Ներբեռնեք ձեր կոդը GitHub- ից
+- Virtualenv-ի ստեղծումը PythonAnyplace- ում `ճիշտ այնպես, ինչպես ձեր համակարգչում է
+- Թարմացրեք ձեր settings file-ը (կարգավորումների ֆայլը) տեղակայման որոշ կարգավորումներում (deployment settings)
+- Ստեղծեք տվյալների բազա PythonAnywhere-ում ՝ օգտագործելով այս `manage.py migrate` հրամանը
+- Ձեր ստատիկ ֆայլերի (static files) կարգավորում (դրանց մասին մենք կիմանանք ավելի ուշ)
+- Եվ կարգավորեք PythonAnywhere- ը `ձեր վեբ հավելվածը API- ի միջոցով սպասարկելու համար
+
+Այս բոլոր քայլերը ավտոմատացված են PythonAnywhere- ում, բայց դրանք այն նույն քայլերն են, որոնք պետք է կատարվեն սերվերի ցանկացած այլ մատակարարի հետ:
+
+Հիմնական բանը, որն այժմ պետք է նկատել, այն է, որ PythonAnywhere տվյալների բազան իրականում ամբողջովին տարանջատված է ձեր համակարգչի տվյալների բազայից: Սա նշանակում է, որ նրանք կարող են ունենալ տարբեր հաղորդագրություններ և ադմինիստրատորի հաշիվներ: Արդյունքում, ինչպես արդեն արեցինք մեր համակարգչում, մենք պետք է ադմինիստրատորի հաշիվը նախապատրաստենք `createsuperuser` - ով: PythonAnywhere- ը ավտոմատ կերպով կակտիվացնի ձեր virtualenv-ին, այնպես որ ձեզ հարկավոր է միայն գործարկել՝
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Մուտքագրեք ադմինիստրատորի հաշվի (admin user) տեղեկատվությունը: Քանի դեռ չեք ցանկանում ձեր PythonAnywhere գաղտնաբառն ավելի ապահով դարձնել, ցանկալի է օգտագործել ձեր համակարգչում օգտագործածները, որպեսզի խառնաշփոթ չլինի, 
+
+Այժմ, եթե ցանկանում եք, կարող եք նաև հայացք նետել ձեր կոդին PythonAnywhere- ում ՝ օգտագործելով `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+Կարող եք նաև մտնել "Files" («Ֆայլեր») ներդիր էջ և շրջել ՝ օգտագործելով PythonAnywhere- ի ներկառուցված ֆայլերի զննիչը (built-in file browser): (Վահանակի էջից վերևի աջ անկյունում գտնվող ցանկի կոճակից կարող եք անցնել PythonAnywhere- ի այլ էջեր: Էջերից մեկում հայտնվելուց հետո, վերին մասում այլ էջերի հղումներ կան:)
+
+## Դու օնլայն եք:
+
+Ձեր կայքը այժմ հանրային ինտերնետում է: Անցեք PythonAnywhere- ի "Web" ներդիրին `ձեր կայքի հղումը ( link-ը) ստանալու համար: Կարող եք այն կիսել յուրաքանչյուրի հետ, ում ցանկանում եք: :)
+
+> **Նշում** Սա սկսնակների ձեռնարկ է, և մենք կայքը տեղակայելիս օգտագործել ենք մի քանի հնարքներ, որոնք անվտանգության տեսանկյունից իդեալական չեն: Եթե ​​որոշեք դրանով նախագիծ կառուցել կամ նորը սկսել, ապա պետք է ստուգեք [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) -ը՝ (Django- ի տեղակայման ստուգաթերթը) ձեր կայքի անվտանգության վերաբերյալ որոշ խորհուրդների համար:
+
+## Վրիպազերծման խորհուրդներ
+
+Ահա մի քանի ընդհանուր պատճառներ, եթե ​​ `pa_autoconfigure_django.py` սկրիպտը գործարկելիս սխալ եք տեսնում
+
+- PythonAnywhere API նշան բանալի չի ստեղծվել ՝ մուտքն ապահովելու համար:
+- GitHub պահոցի URL- ում սխալ է տեղի ունեցել
+- Եթե ​​տեսնում եք սխալ *"Could not find your settings.py"* (Չկարողացա գտնել ձեր settings.py) հետևյալ բովանդակությամբ, դա հավանաբար այն պատճառով է, որ դուք ի վիճակի չէիք ձեր բոլոր ֆայլերը ավելացնել Git- ին և / կամ դրանք հաջողությամբ չկարողացաք բեռնել GitHub- ում: Եվս մեկ անգամ նայեք վերևում գտնվող Git հատվածին և ստուգեք հրահանգները:
+- Եթե ​​նախկինում գրանցվել եք PythonAnywhere հաշվում և ունեցել եք ստատիկ սխալ, ապա, հավանաբար, ձեր հաշվի համար ունեք SQLite- ի հին տարբերակ (օրինակ ՝ 3.8.2): Այս դեպքում մուտք գործեք նոր հաշիվ և փորձեք վերևում գտնվող PythonAnywhere բաժնի հրահանգները:
+
+Եթե ​​ձեր կայք այցելելիս սխալ եք տեսնում, ապա տեղեկատվության կարգավորման համար, նախ նայիր **error log** (սխալների մատյանը): Դրա հղումը կարող եք գտնել PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/) էջում: Տեսեք, արդյոք կան սխալի հաղորդագրություններ. վերջինները ներքևում են:
+
+Այնտեղ կարող եք տեսնել նաև [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError). (PythonAnywhere- ի օգնության կայքի ընդհանուր սխալների վերացման խորհուրդներ)
+
+Եվ հիշեք. Ձեր մարզիչը այստեղ է ՝ օգնելու:
+
+# Ստուգեք ձեր կայքը:
+
+Ձեր կայքի դեֆոլտ էջում պետք է գրվի "It worked!"-(Այն աշխատեց), ճիշտ այնպես, ինչպես դա անում է ձեր տեղական համակարգչում: Փորձեք URL- ի վերջում ավելացնել `/admin/` և դուք կտեղափոխվեք ադմինիստրատորի կայք: Մուտք գործեք ձեր օգտվողի անունով և գաղտնաբառով և կտեսնեք, որ կարող եք նոր գրառումներ ավելացնել սերվերում. Հիշեք, որ ձեր փորձարկման տվյալների բազայից գրառումները չեն ուղարկվի ձեր կենդանի բլոգ:
+
+Մի քանի գրառում ստեղծելուց հետո կարող եք վերադառնալ ձեր տեղական կարգավորմանը (ոչ PythonAnywhere): Այստեղ է, որ պետք է աշխատել փոփոխություններ ստեղծելու վրա: Սա վեբ մշակման ընդհանուր աշխատանքային գործընթաց է. Տեղական փոփոխություններ կատարեք, այդ փոփոխությունները վերբեռնեք GitHub- ում և մղեք իրական վեբ սերվերի վրա: Սա թույլ է տալիս աշխատել և փորձարկել `առանց ձեր կայքը խափանելու: Բավականին լավ է, այնպես չէ՞
+
+Դուք արժանի եք գովասանքի: Սերվերների տեղակայումը վեբ մշակման ամենաբարդ փուլերից մեկն է, և դա իրականացնելը հաճախ տևում է մի քանի օր, մինչ դրանք կաշխատեն: Բայց դուք ստացաք կենդանի կայք ՝ իրական ինտերնետում:
\ No newline at end of file
diff --git a/hy-AM/deploy/install_git.md b/hy-AM/deploy/install_git.md
new file mode 100644
index 00000000000..3a65aa6f056
--- /dev/null
+++ b/hy-AM/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git- ը «տարբերակների կառավարման համակարգ է» ("version control system"), որն օգտագործվում է շատ ծրագրավորողների կողմից: Այս ծրագիրը վերահսկում է փոփոխությունները, որոնք տեղի են ունենում ֆայլերում, որպեսզի հետագայում կարողանաք վերականգնել ծածկագրի վիճակը ցանկալի ժամանակահատվածում: Մի փոքր նման է բառ մշակող ("track changes" )ծրագրերի գործառույթին (օրինակ ՝ Microsoft Word կամ LibreOffice Writer) բայց շատ ավելի հզոր:
+
+## Git-ի ներբեռնում
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Կարող ես ներբեռնել Git-ը այս հղումով [git-scm.com](https://git-scm.com/). "next" (հաջորդ) կարող եք ընտրել բոլոր քայլերին, բացառությամբ երկուսի. Քայլ որտեղ այն խնդրում է ընտրել ձեր խմբագրին (choose your editor), պետք է ընտրեք Nano- ն, իսկ «Ձեր PATH միջավայրի կարգավորումը»-("Adjusting your PATH environment") խորագրի ներքո ընտրեք "Use Git and optional Unix tools from the Windows Command Prompt"(«Օգտագործեք Git և ընտրովի Unix գործիքներ Windows հրամանի տողը»)(ներքևի տարբերակը): Մնացած բոլոր պարամետրերը կարող եք թողնել: "Checkout Windows-style, commit Unix-style line endings" տարբերակը լավ ընտրություն կլինի:
+
+Տեղադրումը հաջող ավարտելուց հետո մի մոռացեք վերսկսել հրամանի տողը կամ PowerShell- ը:<!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Ներբեռնեք Git- ը [git-scm.com](https://git-scm.com/) կայքից և հետևեք հրահանգներին:
+
+> ** Նշում ** Եթե դուք օգտագործում եք OS X 10.6, 10.7 կամ 10.8, ապա պետք է ներբեռնեք git- ի այս տարբերակը ՝ [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/hy-AM/deploy/signup_pythonanywhere.md b/hy-AM/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..8fdbc043ab9
--- /dev/null
+++ b/hy-AM/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnyway- ը ծառայություն է Python կոդի «ամպի մեջ» ("in the cloud") սերվերների վրա աշխատելու համար: Մենք այն օգտագործում ենք ինտերնետում մեր կայքը տեղակայելու համար:
+
+Գրանցվեք PythonAnywhere հաշիվը որպես "Beginner" («Սկսնակ», անվճար տարբերակը բավարար է, կրեդիտ քարտ չի պահանջվում):
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![PythonAnywhere գրանցման էջում կա 'Beginner' (Սկսնակ) անվճար հաշիվ ստեղծելու կոճակ](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Նշում** . Օգտանուն ընտրելիս հիշեք, որ բլոգի URL-ը կունենա այսպիսի տեսք `yourusername.pythonanywhere.com`, այնպես որ ընտրեք կամ ձեր սեփական մականունը կամ բլոգի թեմային վերաբերող անուն: Նաև համոզվեք, որ կհիշեք ձեր գաղտնաբառը (ավելացրեք այն ձեր գաղտնաբառերի կառավարչին,եթե նման բան օգտագործում եք):
+
+## PythonAnywhere- ում API token-ի (նշանի) ստեղծում
+
+Սա մի բան է, որը դուք պետք է անեք միայն մեկ անգամ: Երբ գրանցվեք PythonAnywhere- ում, ձեզ կտեղափոխեն կառավարման վահանակ (dashboard): Գտեք ձեր "Account" (հաշիվ) էջի վերևի աջ մասի հղումը ՝
+
+![Հաշվի հղումը գտնվում է էջի վերևի աջ հատվածում](../deploy/images/pythonanywhere_account.png)
+
+ապա ընտրեք "API token" անունով ներդիրը և սեղմեք "Create new API token". (ստեղծել նոր API նշան) կոճակը:
+
+![API token (API նշանի) ներդիրը Account page-ում (հաշվի էջում)](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/hy-AM/django/README.md b/hy-AM/django/README.md
new file mode 100644
index 00000000000..087714c84f2
--- /dev/null
+++ b/hy-AM/django/README.md
@@ -0,0 +1,27 @@
+# Ի՞նչ է Django- ն:
+
+Django- ն (/ˈdʒæŋɡoʊ/ *jang-goh*) Python- ում գրված անվճար և բաց կոդով վեբ հավելվածների շրջանակ է: Վեբ շրջանակը բաղադրիչների հավաքածու է, որոնք կօգնեն ձեզ արագ և հեշտ զարգացնել կայքերը:
+
+Երբ կայքեր եք մշակում, ձեզ անհրաժեշտ են նմանատիպ բաղադրիչներ ինչպիսիք են. օգտվողներին նույնականացնելու միջոցներ (մուտք, ելք, գրանցում), կայքի վահանակ, ձևաթղթեր, ֆայլեր վերբեռնելու գործիքներ և այլն:
+
+Բարեբախտաբար, այլ մարդիկ արդեն նկատել են որ վեբ մշակողները նման խնդիրներ են ունենում նոր կայք կառուցելիս, ուստի նրանք միավորվեցին և ստեղծեցին շրջանակներ (դրանցից մեկը Django- ն է), որոնք մեզ առաջարկում են պատրաստի ձևանմուշներ (components) օգտագործման համար:
+
+Երբ նոր կայք եք կառուցում շրջանակներ (Frameworks) օգնում են զարգացման գործընթացը հեշտացնել և նորից հեծանիվ չհորինել:
+
+## Ինչու՞ է ձեզ անհրաժեշտ շրջանակ:
+
+Հասկանալու համար, թե ինչի համար է մեզ հարկավոր Django- ն, մենք պետք է ավելի ուշադիր հետևենք սերվերներին: Նախ, սերվերը պետք է իմանա, որ դուք ցանկանում եք, որ այն ձեզ որպես վեբ էջ ծառայի:
+
+Պատկերացրեք փոստարկղ (նավահանգիստ), որը վերահսկվում է մուտքային նամակների (հարցումների) համար: Դա արվում է վեբ սերվերի( web server-ի) կողմից: Վեբ սերվերը (server) կարդում է էլ. Փոստը, այնուհետև ուղարկում է պատասխան վեբ էջի միջոցով: Բայց երբ ուզում ես ինչ-որ բան ուղարկել, պետք է այն որոշակի բովանդակություն ունենա: Իսկ Django- ն կօգնի ձեզ ստեղծել բովանդակություն (content):
+
+## Ի՞նչ է պատահում, երբ ինչ-որ մեկը վեբ կայք է խնդրում ձեր սերվերից:
+
+Երբ որևէ հարցումը է գալիս վեբ սերվերին, այն փոխանցվում է Django- ին, որը փորձում է պարզել, թե կոնկրետ ինչ է իրենից պահանջվում: Նախ այն վերցնում է ինտերնետային կայքի հասցեն և հետք փորձում հասկանալ, թե ինչ անել: Այս հատվածը իրականացնում է Django- ի ** urlresolver ** ը (նշենք, որ կայքի հասցեն կոչվում է URL - Uniform Resource Locator - այնպես որ * urlresolver * անունն իմաստ ունի): Այն շատ խելացի չէ. ուստի այն պարզապես վերցնում է օրինաչափությունների ցուցակ և փորձում համապատասխանեցնել URL- ի հետ: Django- ն վերևից ներքև ստուգում է օրինաչափությունները, և եթե ինչ-որ բան համընկնում է, ապա Django- ն հարցումը փոխանցում է համապատասխան գործառույթին (որը կոչվում է դիտում *view*):
+
+Պատկերացրեք նամակներով փոստատարի: Նա քայլում է փողոցով և ստուգում տան համարները նամակի վրա նշված հասցեի հետ: Եթե ​​դրանք համընկնում են, ապա նա նամակ է թողնում: Այսպես է աշխատում urlresolver- ը:
+
+Բայց ամենահետաքրքիր բաները տեղի են ունենում դիտման *view* գործառույթում. Օրինակ, մենք կարող ենք մուտք գործել տվյալների բազա՝ որոշ տեղեկություններ որոնելու համար: Միգուցե օգտագործողը խնդրե՞լ է փոխել որոշ տեղեկություններ: Օրինակ նամակը ասոմ է ՝ «Խնդրում եմ, փոխեք իմ աշխատանքի նկարագիրը»: *view* դիտման գործառույթը կարող է ստուգել, թե ​​արդյոք դուք դա անելու թույլտվություն ունեք, ապա թարմացրեք աշխատանքի նկարագրությունը և հետ ուղարկեք հաղորդագրություն."Done!" (Կատարված է) Դրանից հետո *view* առաջացնում է պատասխան, և Django- ն կարող է այն ուղարկել օգտվողի վեբ բրաուզերին:
+
+Վերոնշյալ նկարագրությունը մի փոքր պարզեցված է, բայց ձեզ հարկավոր չէ իմանալ բոլոր տեխնիկական «նրբությունները» հենց հիմա: Բավական է հասկանալ հիմնական գաղափարը: 
+
+Այսպիսով, առանց մանրամասների մեջ շատ խորանալու, եկեք սկսենք ինչ-որ բան ստեղծեք Django- ի հետ և այդ ընթացքում կսովորենք բոլոր կարևոր առանձնահատկությունները:
\ No newline at end of file
diff --git a/hy-AM/django_admin/README.md b/hy-AM/django_admin/README.md
new file mode 100644
index 00000000000..7f560dfbdf3
--- /dev/null
+++ b/hy-AM/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django ադմին
+
+Հենց նոր մոդելավորված գրառումները ավելացնելու, խմբագրելու և ջնջելու համար մենք կօգտագործենք Django ադմինիստրատորը:
+
+Բացեք `blog/admin.py` ֆայլը ծածկագրի խմբագրում և դրա բովանդակությունը փոխարինեք հետևյալով.
+
+{% filename %}blog/admin.py{% endfilename %} 
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Ինչպես տեսնում եք, մենք ներմուծել ենք (include-ներառել) Post-ի մոդելը, որը սահմանված էր նախորդ գլխում: Որպեսզի մեր մոդելը հասանելի լինի ադմինիստրատորի էջում, մենք պետք է այն գրանցենք ՝ օգտագործելով այս `admin.site.register(Post)` գրառումը:
+
+Լավ, ժամանակն է նայել մեր Post մոդելը: Հիշեք, որ վեբ սերվերը գործարկելու համար վահանակում գործարկեք այս `python manage.py runserver` հրամանը: Գնացեք ձեր browser (դիտարկիչ) և մուտքագրեք այս http://127.0.0.1:8000/admin/ հասցեն: Դուք կտեսնեք մուտքի թույլտվության էջ.
+
+![Մուտք էջ](images/login_page2.png)
+
+Մուտք գործելու համար հարկավոր է ստեղծել *superuser* ՝ օգտվողի հաշիվ, որն ամբողջությամբ վերահսկում է կայքը: Վերադարձեք հրամանի տող, մուտքագրեք `python manage.py createsuperuser` և սեղմեք Enter:
+
+> Հիշեք ՝ վեբ սերվերի գործարկման ընթացքում նոր հրամաններ գրելու համար բացեք նոր տերմինալային պատուհան և ակտիվացրեք ձեր վիրտուալ միջավայրը (virtualenv): Մենք վերանայեցինք, թե ինչպես գրել նոր հրամաններ ** Ձեր առաջին Django նախագիծը ** (Your first Django project)գլուխը, **Մեկնարկելով վեբ սերվերը** (Starting the web server) բաժնում:
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Երբ ձեզ հուշում են, մուտքագրեք ձեր օգտվողի անունը (փոքրատառով, առանց բացատներ), էլ. Փոստի հասցեն և գաղտնաբառը: ** Մի անհանգստացեք, որ չեք կարող տեսնել ձեր մուտքագրած գաղտնաբառը, դա բնական է ** Մուտքագրեք այն և սեղմեք `enter` շարունակելու համար: Արդյունքը պետք է ունենա այսպիսի տեսք (որտեղ օգտագործողի անունը և էլ. փոստը պետք է լինեն ձեր սեփականը).
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Վերադարձեք ձեր բրաուզեր (browser) և մուտք գործեք ձեր ընտրած օգտվողի անունով և գաղտնաբառով: Այնուհետև Դուք պետք է տեսնեք Django կառավարման վահանակ (Django admin dashboard):
+
+![Django ադմին](images/django_admin3.png)
+
+Գնացեք գրառումներ/ Posts բաժին և մի փոքր փորձարկեք այն: Ավելացրեք հինգ կամ վեց բլոգային գրառումներ (blog posts): Մի անհանգստացեք բովանդակության համար. Դուք այն տեսնում եք միայն ձեր տեղական համակարգչում. Դուք կարող եք պատճենել և տեղադրել տեքստը այս ձեռնարկից ՝ ժամանակ խնայելու համար: :)
+
+Համոզվեք, որ առնվազն երկու կամ երեք գրառում (բայց ոչ բոլորը) հրապարակման ամսաթիվ ունեն: Ապագայում դա կարող է օգտակար լինել:
+
+![Django ադմին](images/edit_post3.png)
+
+Եթե ​​ցանկանում եք ավելին իմանալ Django- ի ադմինիստրատորի մասին, տես պաշտոնական փաստաթղթերի այս բաժինը ՝ https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Հավանաբար, ճիշտ ժամանակն է մեկ բաժակ սուրճով (կամ թեյով) ինքներդ ձեզ ոքևորելու և ձեր էներգիան լրացնելու համար ինչ-որ բան ուտելու համար: Դուք պարզապես ստեղծեցիք ձեր առաջին Django մոդելը և արժանի եք ընդմիջման:
\ No newline at end of file
diff --git a/hy-AM/django_forms/README.md b/hy-AM/django_forms/README.md
new file mode 100644
index 00000000000..19200a6557a
--- /dev/null
+++ b/hy-AM/django_forms/README.md
@@ -0,0 +1,481 @@
+# Django ֆորմաներ 
+
+Վերջին բանը, որ մենք ուզում ենք անել մեր կայքում, բլոգի գրառումներն ավելացնելու և խմբագրելու հարմարավետ միջոց ստեղծելն է: Django- ի `admin` -ը (ադմինիստրատորը) հիանալի է, բայց դրա դիզայնը դժվար է փոխել: `forms` -ի հետ մենք բացարձակ վերահսկողություն կունենանք մեր ինտերֆեյսի վրա: Մենք կարող ենք իրագործել գրեթե այն ամենը, ինչ կարող ենք պատկերացնել:
+
+Django ձևերի (Django forms-ի) մեջ հաճելին այն է, որ մենք կարող ենք զրոյից ստեղծել նոր ձև, կամ օգտագործել `ModelForm`-ը ՝ ձևերի պարունակությունը մոդելում պահելու համար: 
+
+Սա հենց այն է, ինչ մենք ուզում ենք անել. Մենք ձև կստեղծենք `Post` մոդելի համար:
+
+Ինչպես Django-ի յուրաքանչյուր կարեւոր մաս, ձևերը (forms) նույնպես ունեն իրենց սեփական ֆայլը . ` form.py `:
+
+Մենք պետք է այս անունով ֆայլ ստեղծենք `blog` գրացուցակում:
+
+    blog
+       └── forms.py
+    
+
+Շատ լավ, եկեք բացենք այն կոդերի խմբագրում և մուտքագրենք հետևյալ կոդը.
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+django ներմուծման ձևերից
+
+.models- ից ներմուծում են Post
+
+դասի PostForm (forms. ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+
+
+```
+
+Նախ մենք պետք է ներմուծենք Django ձևերը/Django forms (`from django import forms` /django ներմուծման ձևերից) և մեր `Post` մոդելը/model (` .models- ից ներմուծում ենք Post `):
+
+` PostForm ` - ը, ինչպես, հավանաբար, ենթադրում եք, մեր ձևի անունն է: Մենք պետք է Django- ին ասենք, որ այս ձևը ` ModelForm ` է (այնպես որ Django- ն ինչ-որ կախարդանք անի մեզ համար). դրա համար պատասխանատու է `forms.ModelForm` - ը:
+
+Հաջորդը, մենք ունենք ` class Meta `, որտեղ մենք սահմանում ենք (Django- ին), թե որ մոդելը կօգտագործվի այս ձևը ստեղծելու համար (` model = Post `): 
+
+Վերջապես, մենք կարող ենք հստակեցնել, թե որ դաշտը (կամ դաշտերը) պետք է առկա լինեն մեր ֆորմայում: Այս սցենարում մենք ուզում ենք միայն ` title (վերնագիրը) ` և ` text(տեքստը) ` ցուցադրվեն. Հեղինակը պետք է լինի այն օգտվողը, ով մուտք է գործել իր օգտվողի անունով (այսինքն դու!) և ` created_date(ստեղծված_ ամսաթիվը) `պետք է ավտոմատ կերպով տեղադրվի գրառման ստեղծման ժամանակ (այսինքն ՝ կոդով), այնպես չէ՞: 
+
+Եվ վերջ այսքանը! Մեզ մնում է միայն օգտագործել ձևը *view* և ցուցադրել այն template-ում(ձևանմուշում):
+
+Այսպիսով, մեկ անգամ ևս մենք կստեղծենք link(հղում) դեպի էջ, URL, դիտում և template (ձևանմուշ):
+
+## Link (Հղում) դեպի էջի ձևը
+
+Հղումը չավելացնելուց առաջ մեզ պետք են մի քանի պատկերակներ, որոնք կօգտագործվեն որպես հղման կոճակներ: Այս ձեռնարկի համար ներբեռնեք [ file-earmark-plus.svg ](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) և պահեք այն ` blog/templates/blog/icons/ ` թղթապանակում:
+
+> Նշում. SVG պատկերը ներբեռնելու համար բացեք համատեքստային ընտրացանկը հղման վրա (սովորաբար դրա վրա աջ կտտացնելով) և ընտրեք <<Save link as>> («Պահել հղումը որպես»): Պատուհանում հարցնելով, թե որտեղ պետք է ֆայլը պահպանել, անցեք ձեր Django նախագծի ` djangogirls ` գրացուցակը, իսկ դրա ներքո ՝ ` blog/templates/blog/icons/ ` ենթագրացուցակ, և ֆայլը այնտեղ պահեք:
+
+Codeամանակն է ծածկագրի խմբագրում բացել `blog/templates/blog/base.html`: Այժմ մենք կարող ենք օգտագործել այս պատկերակային ֆայլը բազային ձևանմուշի մեջ ՝ հետևյալ կերպ. ` div ` տարրում ` headrer ` բաժնում, մենք կավելացնենք հղում ` h1 ` տարրից առաջ.
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Նկատի ունեցեք, որ մենք ուզում ենք մեր նոր տեսակետը կոչել ` post_new `: [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) տրամադրվում է [Bootstrap Icons ](https://icons.getbootstrap.com/) կողմից, և դրանում կցուցադրվի էջի պատկերակ `գումարած նշանով: Մենք օգտագործում ենք Django ձևանմուշի դիրեկտիվը, որը կոչվում է `include `: Սա ֆայլի պարունակությունը կներարկի Django ձևանմուշում: Վեբ զննարկիչը գիտի, թե ինչպես վարվել այս տեսակի բովանդակության հետ `առանց հետագա մշակման:
+
+> Bootstrap- ի բոլոր պատկերակները կարող եք ներբեռնել [ here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip): Անջատեք ֆայլը և պատճենեք բոլոր SVG պատկերային ֆայլերը ` blog/templates/blog/ ` ներսում գտնվող նոր պանակի մեջ, որը կոչվում է ` icons `: Այդ կերպ Դուք կարող եք մուտք գործել ` pencil-fill.svg ` պես պատկերակ ՝ օգտագործելով ֆայլի ուղի `blog/templates/blog/icons/pencil-fill.svg `
+
+Տողը խմբագրելուց հետո ձեր HTML ֆայլը այժմ պետք է ունենա այսպիսի տեսք.
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+http://127.0.0.1:8000 էջը փրկելուց և թարմացնելուց հետո կտեսնեք ծանոթ ` NoReverseMatch ` error(սխալ) : Այդպե՞ս է: Լավ
+
+## URL
+
+Կոդի խմբագրում բացում ենք ` blog/urls.py` և ավելացնում տող.
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+Եվ վերջնական ծածկագիրը կտեսնի այսպես.
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+Կայքը թարմացնելուց հետո մենք տեսնում ենք ` AttributeError `, քանի որ իրականացված չենք ` post_new ` դիտումը: Եկեք ավելացնենք հենց հիմա:
+
+## post_new view
+
+բացեք ` բլոգը / views.py ` ֆայլը ծածկագրի խմբագրում և ավելացնել տողերի մնացած տողերի հետևյալ տողերը. 
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+.forms- ից ներմուծում է PostForm
+```
+
+Եվ հետո մեր * տեսակետը *:
+
+{% filename%} blog/views.py {% endfilename%}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Նոր ` Post ` ձև ստեղծելու համար հարկավոր է զանգահարել ` PostForm () ` և փոխանցել այն ձևանմուշին: Մենք կվերադառնանք այս *view*, բայց առայժմ արագ եկեք ձևանմուշ ստեղծենք ձևի համար:
+
+## Կաղապար
+
+Մենք պետք է ` post_edit.html` գրացուցակում ` blog/templates/blog` ֆայլ ստեղծենք և բացենք այն կոդերի խմբագրում: Ձևը գործ դնելու համար մեզ մի քանի բան է պետք.
+
+* Մենք պետք է ցուցադրենք ձևը: Մենք կարող ենք դա անել (օրինակ) {% raw %}`{{ form.as_p }}`{% endraw %} - ով:
+* Վերևի տողը պետք է փաթաթված լինի HTML ձևի տարրով. `<form method="POST"> ... </form>`:
+* Մեզ պետք է ` Save` կոճակը: Մենք դա անում ենք HTML կոճակի միջոցով. `<button type="submit"> Save </button>`:
+* Եվ, վերջապես, `<form ...>` թեգը բացելուց անմիջապես հետո մենք պետք է ավելացնենք {% raw %} ` {% csrf_token %} ` {% endraw %}: Սա շատ կարևոր է, քանի որ դրանով ապահովվում են ձեր ձևերի անվտանգությունը: Եթե ​​մոռանաք այս բիթի մասին, Django- ն կբողոքարկի, երբ փորձեք պահպանել ձևը.
+
+![CSFR Forbidden page](images/csrf2.png)
+
+Լավ, այնպես որ եկեք տեսնենք, թե ինչպես պետք է HTML- ը ` post_edit.html ` - ում:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Թարմացնելու ժամանակն է: Այո Ձեր ձևը ցուցադրվում է:
+
+![New form](images/new_form2.png)
+
+Բայց սպասեք մի րոպե: Երբ ինչ-որ բան եք մուտքագրում ` title ` և ` title ` դաշտերում և փորձում եք այն պահպանել, ի՞նչ կլինի:
+
+Ոչինչ Մենք նորից նույն էջում ենք, և մեր տեքստը այլևս չկա ... և ոչ մի նոր գրառում չի ավելացվում: Այսպիսով, ի՞նչն է սխալ եղել: 
+
+Պատասխանն է. Ոչինչ: Մենք պետք է մի փոքր ավելի շատ աշխատանք կատարենք մեր * view*:
+
+## Ձևը պահելը
+
+Մեկ անգամ եւս բացեք ` blog/views.py ` կոդը խմբագրիչի մեջ: Ներկայումս ` post_new ` տեսքում մենք ունենք միայն հետևյալը.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Ձևը ներկայացնելիս մեզ հետ են բերում նույն տեսակետը, բայց այս անգամ մենք ունենք ևս մի քանի տվյալներ ` request` - ում, ավելի կոնկրետ ` request. POST ` (անվանումն ունի ոչ մի կապ չունի բլոգի "post"(«գրառման») հետ. դա կապ ունի այն փաստի հետ, որ մենք "psoting" («տեղադրում ենք») տվյալներ): Հիշո՞ւմ եք, թե ինչպես HTML ֆայլում մեր `<form>` սահմանումն ուներ փոփոխական ` method="POST" `: Ձևի բոլոր դաշտերն այժմ գտնվում են ` request.POST `: Դուք չպետք է վերանվանեք ` POST ` ը որևէ այլ բանի (` method ` միակ այլ վավեր արժեքը ` GET ` է, բայց մենք ժամանակ չունենք բացատրելու, թե ինչ տարբերություն է):
+
+Այսպիսով, մեր * view* մենք ունենք կարգավորման երկու առանձին իրավիճակ. Առաջին ՝ երբ մենք առաջին անգամ մուտք ենք գործում էջ և ուզում ենք դատարկ ձև, և երկրորդ, երբ վերադառնում ենք * view* բոլոր մուտքագրված ձևի տվյալներով: Այսպիսով, մենք պետք է պայման դնենք (դրա համար կօգտագործենք ` if `):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+Լրացրեք կետերը ` [...] `: Եթե ​​` method` ` POST ` է, ապա մենք ուզում ենք կառուցել ` PostForm- ը ` ձևից ստացված տվյալներով, այնպես չէ՞: Մենք դա կանենք հետևյալ կերպ.
+
+{% filename%} blog/views.py{% endfilename%}
+
+```python
+form = PostForm(request.POST)
+```
+
+Հաջորդ բանը `ստուգել, ​​թե արդյոք ձևը ճիշտ է (բոլոր պահանջվող դաշտերը դրված են և սխալ արժեքներ չեն ներկայացվել): Մենք դա անում ենք ` form.is_valid () ` - ի միջոցով:
+
+Մենք ստուգում ենք, արդյոք ձևը վավեր է, և եթե այո, ապա այն կարող ենք պահպանել:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Ըստ էության, մենք այստեղ ունենք երկու բան. Մենք ձևը պահում ենք ` form.save ` և ավելացնում ենք հեղինակ. ` commit = False ` նշանակում է, որ մենք դեռ չենք ուզում պահպանել ` Post ` մոդելը. Մենք նախ ուզում ենք ավելացնել հեղինակին: Շատ ժամանակ դուք կօգտագործեք ` form.save () ` առանց ` commit = False `, բայց այս դեպքում մենք պետք է այն մատակարարենք: ` post.save () ` կպահպանի փոփոխությունները (ավելացնելով հեղինակին) և կստեղծվի բլոգում նոր գրառում:
+
+Վերջապես, զարմանալի կլիներ, եթե մենք կարողանայինք անմիջապես անցնել ` post_detail ` էջը մեր նորաստեղծ բլոգում տեղադրելու համար, այնպես չէ՞: Դա անելու համար մեզ անհրաժեշտ է ևս մեկ ներմուծում.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Ավելացրեք այն ձեր ֆայլի հենց սկզբում: Եվ հիմա մենք կարող ենք ասել. «Անցեք ` post_detail ` էջը նորաստեղծ գրառման համար».
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+` post_detail ` այն տեսքի անունն է, որին մենք ցանկանում ենք այցելել: Հիշո՞ւմ եք, որ այս * view* պահանջում է ` pk ` փոփոխական: Այն դիտումներին փոխանցելու համար մենք օգտագործում ենք ` pk = post.pk `, որտեղ ` post` նոր ստեղծվող բլոգային գրառում է:
+
+Լավ, մենք շատ ենք խոսել, բայց հավանաբար ուզում ենք տեսնել, թե ինչպիսին է այժմ * view * ճիշտ է:
+
+{% filename%} բլոգ /views.py {% endfilename%}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Տեսնենք ՝ կաշխատի՞: Անցեք http://127.0.0.1:8000/post/new/ էջին, ավելացրեք `վերնագիր` և `տեքստ`, պահեք այն… և voilà: Ավելացվեց բլոգի նոր գրառումը, և մենք վերահասցեագրվում ենք ` հաղորդագրության_մանրամասնություն ` էջ:
+
+Գուցե նկատած լինեիք, որ մենք տեղադրում ենք հրապարակման ամսաթիվը նախքան հաղորդագրությունը պահելը: Ավելի ուշ, մենք կներկայացնենք * հրապարակման կոճակ * ** Django Girls Tutorial- ում ՝ Extensions **:
+
+Դա հիանալի է!
+
+> Քանի որ մենք վերջերս օգտագործել ենք Django ադմինիստրատորի միջերեսը, համակարգը ներկայումս կարծում է, որ մենք դեռ մուտք ենք գործել: Կան մի քանի իրավիճակներ, որոնք կարող են հանգեցնել մեզ դուրս գալուն (զննարկիչը փակելը, DB- ն վերագործարկելը և այլն): Եթե ​​հաղորդագրություն ստեղծելիս հայտնաբերում եք, որ սխալներ եք գրանցում մուտք գործած օգտվողի բացակայության վերաբերյալ, ապա անցեք ադմինիստրատորի էջ http://127.0.0.1:8000/admin և կրկին մուտք գործեք: Դրանով խնդիրը ժամանակավորապես կկարգավորվի: ** Տնային առաջադրանք. Ձեզ սպասում է մշտական ​​շտկում ՝ հիմնական ձեռնարկից հետո անվտանգություն ավելացրեք ձեր կայքում: **
+
+![Logged in error](images/post_create_error.png)
+
+## Ձևի վավերացում
+
+Այժմ մենք ձեզ ցույց կտանք, թե որքան զով են Django- ի ձևերը: Բլոգի գրառումը պետք է ունենա ` title ` և ` text ` դաշտեր: Մեր ` Post` մոդելում մենք չասացինք, որ այս դաշտերը (ի տարբերություն ` published_date `) չեն պահանջվում, ուստի Django- ն, ըստ նախնականի, ակնկալում է, որ դրանք կսահմանվեն:
+
+Փորձեք պահպանել ձևը առանց ` title ` և ` text `: Գուշակիր, թե ինչ կլինի:
+
+![Form validation](images/form_validation2.png)
+
+Django- ն հոգ է տանում հաստատելու, որ մեր ձևի բոլոր դաշտերը ճիշտ են: Հիանալի չէ՞:
+
+## Խմբագրել ձևը
+
+Այժմ մենք գիտենք, թե ինչպես ավելացնել նոր գրառում: Բայց ի՞նչ կլինի, եթե մենք ուզում ենք խմբագրել գոյություն ունեցողը: Սա շատ նման է մեր արածին: Եկեք արագ ստեղծենք մի քանի կարևոր բաներ: (Եթե ինչ-որ բան չեք հասկանում, պետք է հարցնեք ձեր մարզչին կամ նայեք նախորդ գլուխներին, քանի որ մենք արդեն ծածկել ենք այս բոլոր քայլերը):
+
+Նախ, եկեք պահենք պատկերակը, որը ներկայացնում է խմբագրման կոճակը: Ներբեռնեք [ pencil-fill.svg ](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) - ը և այն պահեք ` blog/templates/blog/icons/`:
+
+Կոդի խմբագրում բացեք `blog/templates/blog/post_detail.html` և `article` էլեմենտի մեջ ավելացրեք հետևյալ ծածկագիրը.
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+այնպես, որ ձևանմուշն այսպիսին լինի.
+
+{% filename%} բլոգ / ձևանմուշներ / բլոգ / post_detail.html {% endfilename%}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Բացեք ` blog/urls.py ` ծածկագրի խմբագրում և ավելացրեք այս տողը.
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+Մենք կրկին կօգտագործենք ` blog/templates/blog/post_edit.html ` ձևանմուշը, այնպես որ վերջին բացակայողը * view -է*:
+
+Եկեք բացենք ` blog/views.py` ծածկագրի խմբագրում և ավելացնենք սա ֆայլի հենց վերջում.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Սա կարծես գրեթե նույնն է, ինչ մեր ` post_new ` տեսակետը: Բայց ոչ ամբողջությամբ: Մեկի համար մենք ` url- ից ` փոխանցում ենք լրացուցիչ ` pk ` պարամետր: Հաջորդը, մենք ստանում ենք ` Post ` մոդելը, որը ցանկանում ենք խմբագրել ` get_object_or_404(Post, pk=pk)`, իսկ հետո, երբ ձև ենք ստեղծում, այս գրառումն անցնում ենք որպես ` instance`, այնպես էլ, երբ ձևը պահում ենք
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+… Եվ երբ մենք այս գրառմամբ նոր բացեցինք ձևաթուղթ ՝ խմբագրելու համար.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+Լավ, եկեք փորձենք, արդյոք այն աշխատում է: Եկեք գնանք ` post_detail` էջին: Վերին աջ անկյունում պետք է լինի խմբագրման կոճակ.
+
+![Edit button](images/edit_button2.png)
+
+Երբ կտտացրեք այն, կտեսնեք ձևը մեր բլոգի գրառման հետ.
+
+![Edit form](images/edit_form2.png)
+
+Ազատորեն փոխեք վերնագիրը կամ տեքստը և պահպանեք փոփոխությունները:
+
+Շնորհավորում եմ Ձեր դիմումը ավելի ու ավելի ամբողջական է դառնում:
+
+Եթե ​​Django ձևերի վերաբերյալ ավելի շատ տեղեկատվության կարիք ունեք, պետք է կարդաք փաստաթղթերը. https://docs.djangoproject.com/hy/2.2/topics/forms/
+
+## Անվտանգություն
+
+Հղումը կտտացնելով նոր հաղորդագրություններ ստեղծելու կարողությունը զարմանալի է: Բայց հենց հիմա, յուրաքանչյուր ոք, ով այցելում է ձեր կայք, կկարողանա նոր բլոգային գրառում կատարել, և դա, հավանաբար, ձեր ուզածը չէ: Եկեք այնպես անենք, որ կոճակը ցուցադրվի ձեզ համար, բայց ոչ ուրիշ մեկի:
+
+Բացեք ` blog/templates/blog/base.html` կոդերի խմբագրում, գտեք մեր ` div ` ` վերնագրի ներսում ` և խարիսխի տարրը, որը դուք ավելի վաղ այնտեղ եք տեղադրել , Այն պետք է ունենա այսպիսի տեսք.
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Մենք դրան կավելացնենք ևս ` {% if%} ` պիտակը, որը կստիպի հղումը ցույց տալ միայն այն ադմինիստրատոր մուտք գործած օգտվողների համար: Հենց հիմա, դու հենց դու ես: Փոխեք `<a>` տարրը ՝ այսպիսի տեսք ունենալու համար.
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+Սա ` {% if %} ` կհանգեցնի այն, որ հղումը կուղարկվի զննարկիչ, միայն եթե էջը հայցող օգտվողը մուտք է գործում: Սա ամբողջությամբ չի պաշտպանում նոր հաղորդագրությունների ստեղծումը, բայց դա լավ առաջին քայլ է: Մենք ավելի շատ անվտանգություն ենք ծածկելու ընդլայնման դասերին:
+
+Հիշո՞ւմ եք խմբագրման պատկերակը, որը մենք պարզապես ավելացրել ենք մեր մանրամասն էջին: Մենք ուզում ենք նաև նույն փոփոխությունն ավելացնել այնտեղ, այնպես որ այլ մարդիկ չեն կարողանա խմբագրել առկա հաղորդագրությունները:
+
+Բացեք ` blog/templates/blog/post_detail.html` կոդերի խմբագրում և գտեք այս տողը.
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Փոխեք այն այստեղ ՝
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Քանի որ, ամենայն հավանականությամբ, մուտք եք գործել կայք, եթե թարմացնեք էջը, այլ բան չեք տեսնի: Էջը բեռնեք այլ զննարկչում կամ ինկոգնիտո պատուհանում (Windows Edge- ում կոչվում է «InPrivate»), և կտեսնեք, որ հղումը չի ցուցադրվում, և պատկերակը նույնպես չի ցուցադրվում:
+
+## Եվս մեկ բան. Տեղաբաշխեք ժամանակ:
+
+Տեսնենք, արդյոք այս ամենը աշխատում է PythonAnywhere- ում: Anotherամանակն է նոր տեղակայման:
+
+* Նախ, կատարեք ձեր նոր ծածկագիրը և սեղմեք այն դեպի GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Հետո, [ PythonAnywhere Bash կոնսոլում ](https://www.pythonanywhere.com/consoles/)
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Մի մոռացեք փոխարինել `<your-pythonanywhere-domain>` ձեր իրական PythonAnywhere ենթադոմեյնով ՝ առանց անկյունային փակագծերի:)
+
+* Ի վերջո, անցեք [ "Web" page](https://www.pythonanywhere.com/web_app_setup/) (օգտագործեք մենյուի վերևի աջ մասում ընտրացանկի կոճակը) և սեղմեք ** Reload**: Թարմացրեք ձեր https://subdomain.pythonanywhere.com բլոգը ՝ փոփոխությունները տեսնելու համար:
+
+Եվ դա պետք է լինի դա: Շնորհավորանքներ :)
\ No newline at end of file
diff --git a/hy-AM/django_installation/README.md b/hy-AM/django_installation/README.md
new file mode 100644
index 00000000000..cf2e7794630
--- /dev/null
+++ b/hy-AM/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django- ի տեղադրում
+
+> **Նշում** Եթե Chromebook եք օգտագործում, բաց թողեք այս գլուխը և համոզվեք, որ հետևում եք [Chromebook Setup/Chromebook- ի կարգավորման](../chromebook_setup/README.md) ցուցումներին:
+> 
+> **Նշում** Եթե դուք արդեն ավարտել եք տեղադրումը [installation steps](../installation/README.md) , կարող եք ուղղակիորեն անցնել հաջորդ գլխին:
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/hy-AM/django_installation/instructions.md b/hy-AM/django_installation/instructions.md
new file mode 100644
index 00000000000..a05aba7e956
--- /dev/null
+++ b/hy-AM/django_installation/instructions.md
@@ -0,0 +1,230 @@
+> Այս բաժնի մի մասը հիմնված է Geek Girls Carrots- ի (https://github.com/ggcarrots/django-carrots) ձեռնարկների վրա:
+> 
+> Այս բաժնի մի մասը հիմնված է [django-marcador- ի վրա ձեռնարկ](http://django-marcador.keimlink.de/) լիցենզավորված Creative Commons- ի ներքո Attribution-ShareAlike 4.0 միջազգային լիցենզիա: Django-marcador ձեռնարկի հեղինակային իրավունքի պաշտպանն են Markus Zapke-Gründemann et al.
+
+## Վիրտուալ միջավայր
+
+Նախքան Django- ն տեղադրելը, մենք ձեզ կառաջարկենք տեղադրել չափազանց օգտակար գործիք, որը կօգնի ձեր կոդավորման միջավայրը կոկիկ պահել ձեր համակարգչում: Հնարավոր է բաց թողնել այս քայլը, բայց խորհուրդ է տրվում իրականացնել: Հնարավոր լավագույն կարգավորումից սկսելը ապագայում ձեզ շատ դժվարություններ կփրկի:
+
+Այսպիսով, եկեք ստեղծենք ** վիրտուալ միջավայր/virtual environment** (կոչվում է նաև *virtualenv* ): Virtualenv- ը մեկուսացնելու է ձեր Python / Django- ի տեղադրումը ՝ ըստ նախագծի: Սա նշանակում է, որ որևէ փոփոխություն, որ կատարեք մեկ կայքում, չի ազդի որևէ այլ կայքի վրա, որը դուք նույնպես զարգացնում եք: Կոկիկ է, այնպես չէ՞:
+
+Դուք պետք է ընդամենը գտնեք գրացուցակ, որում ցանկանում եք ստեղծել `virtualenv`; ձեր տան գրացուցակը, օրինակ. Windows- ում այն ​​կարող է նման լինել `C:\Users\Name` (որտեղ ` Name ` - ը ձեր մուտքի անունն է):
+
+> ** ՆՇՈՒՄ. ** Windows- ում համոզվեք, որ այս գրացուցակը չի պարունակում շեշտադրված կամ հատուկ նիշեր. եթե ձեր օգտանունը պարունակում է ընդգծված նիշեր, օգտագործեք այլ գրացուցակ, օրինակ ՝ `C:\djangogirls`:
+
+Այս ձեռնարկի համար մենք կօգտագործենք նոր գրացուցակ ` djangogirls ` ձեր տան գրացուցակից.
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Մենք պատրաստելու ենք մի վիրտուալ անուն, որը կոչվում է ` myvenv `: Ընդհանուր հրամանը կլինի ձևաչափով/format.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Նոր `virtualenv` ստեղծելու համար հարկավոր է բացել հրամանի տողը և գործարկել `python -m venv myvenv`: Դա կունենա այսպիսի տեսք.
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Որտեղ ` myvenv ` - ը ձեր `virtualenv` անունն է: Կարող եք օգտագործել ցանկացած այլ անուն, բայց հավատարիմ մնացեք փոքրատառերին և մի օգտագործեք բացատներ, շեշտադրումներ կամ հատուկ նիշեր: It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Մենք կարող ենք ստեղծել ` virtualenv ` ինչպես Linux- ի, այնպես էլ OS X- ի վրա ՝ գործարկելով `python3 -m venv myvenv`: Դա կունենա այսպիսի տեսք.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+` myvenv ` - ը ձեր `virtualenv` անունն է: Կարող եք օգտագործել ցանկացած այլ անուն, բայց հավատարիմ մնացեք փոքրատառերին և բացատներ մի օգտագործեք: Լավ է նաև, որ անունը կարճ մնա. Դուք դեռ շատ կանդրադառնաք դրան:
+
+> ** ՆՇՈՒՄ. ** Debian / Ubuntu- ի որոշ տարբերակների վրա կարող եք ստանալ հետևյալ սխալը.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Վիրտուալ միջավայրը հաջողությամբ չի ստեղծվել, քանի որ ensurepip- ը հասանելի չէ:  Debian / Ubuntu համակարգերում անհրաժեշտ է տեղադրել python3-venv փաթեթը ՝ օգտագործելով հետևյալ հրամանը:
+>        apt install python3-venv
+>     Հնարավոր է, որ ձեզ հարկավոր է օգտագործել sudo(սուդո) այդ հրահանգով:
+>       Python3-venv փաթեթը տեղադրելուց հետո վերստեղծեք ձեր virtual environment (վիրտուալ միջավայր)-ը:
+>     
+> 
+> Այս դեպքում հետևեք վերը նշված հրահանգներին և տեղադրեք ` python3-venv ` փաթեթը. {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> ** ՆՇՈՒՄ. ** Debian / Ubuntu- ի որոշ տարբերակներում վիրտուալ միջավայր նախաձեռնելիս այն տալիս է հետևյալ սխալը.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Այս խնդրը շրջանցելու համար օգտագործեք ` virtualenv ` հրամանը:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **Նշում** Եթե նման սխալ եք ստանում
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> փոխարենը բաց թող
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Վիրտուալենվի/virtualenv-ի հետ աշխատանք
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Սկսեք ձեր վիրտուալ միջավայրը/virtual environment-ը `գործարկելով.
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. Այս դեպքում բացեք մեկ այլ Windows PowerShell «Գործարկեք որպես ադմինիստրատոր»/"Run as Administrator" տարբերակով: Դրանից հետո փորձեք մուտքագրել հետևյալ հրամանը ՝ նախքան ձեր վիրտուալ միջավայրի/virtual environment-ի սկսելը.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> Առավելությունն այն է, որ անհրաժեշտ չէ փոխություն անել խմբագրի պատուհանի և հրամանի տողի միջև:
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Սկսեք ձեր վիրտուալ միջավայրը/virtual environment-ը `գործարկելով.
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Մի մոռացեք ` myvenv ` -ը փոխարինել ձեր ընտրած ` virtualenv ` անունով:
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+Դուք կհասկանաք, որ virtualenv- ն աշխատում է, երբ հրամանի տողում տեսնեք `(myvenv)` նախածանցը:
+
+Վիրտուալ միջավայրի հետ աշխատելիս ` python ` հրամանն ինքնաբերաբար կվերաբերվի լեզվի ճիշտ տարբերակին, այնպես որ ձեզ հարկավոր չէ օգտագործել ` python3 `: 
+
+Հիանալի է, հիմա մենք բոլոր կարեւոր կախվածությունները կպահենք մեկ տեղում: Վերջապես, դուք կարող եք տեղադրել Django- ն:
+
+## Django- ի տեղադրում {#django}
+
+Այժմ, երբ ձեր `virtualenv`-ն աշխատում է, կարող եք տեղադրել Django- ն:
+
+Բայց մինչ այդ մենք պետք է համոզվենք, որ մենք ունենք `pip`- ի վերջին տարբերակը տեղադրված, դա այն ծրագիրն է, որը մենք կօգտագործենք Django- ն տեղադրելու համար.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Փաթեթների տեղադրում պահանջներով
+
+Պահանջների ֆայլը/A requirements file պահում է կախվածության ցուցակը որը տեղադրվելու է օգտագործելով `pip install`:
+
+Սկզբից ` djangogirls/ ` թղթապանակի մեջ ստեղծեք ` requirements.txt ` ֆայլ ՝ օգտագործելով ավելի վաղ տեղադրած կոդերի խմբագրիչը: Դուք դա անում եք կոդի խմբագրում/code editor-ում նոր ֆայլ բացելով, այնուհետև պահպանելով այն որպես `requirements.txt/ պահանջներ` `djangogirls/` թղթապանակում: Ձեր թղթապանակն այսպիսի տեսք կունենա.
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+Հետևյալ կոդը ավելացրեք ձեր `djangogirls/requirements.txt` ֆայլում.
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Django- ն տեղադրելու համար այժմ մուտքագրեք `pip install -r requirements.txt`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). Եթե ​​սա է խնդիրը, ապա խնդրում ենք ձեր նախագիծը տեղափոխել մեկ այլ վայր, որի հասցեն չի պարունակի բացատներ և հատուկ նիշեր (խորհուրդ ենք տալիս ՝ `C:\djangogirls`): Նոր գրացուցակում ստեղծեք նոր virtualenv, այնուհետև ջնջեք հինը և կրկնեք վերը նշված հրահանգները: (Virtualenv գրացուցակի տեղափոխումը չի գործի, քանի որ virtualenv- ն օգտագործում է բացարձակ ուղիներ):
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> Եթե ​​Ubuntu 12.04-ին pip զանգահարելիս սխալի եք հանդիպում, գործարկեք `python -m pip install -U --force-reinstall pip` ՝ վիրտուալում pip- ի տեղադրումն ամրագրելու համար: 
+
+<!--endsec-->
+
+Վերջ Դուք այժմ (վերջապես) պատրաստ եք ստեղծել Django հավելված:
\ No newline at end of file
diff --git a/hy-AM/django_models/README.md b/hy-AM/django_models/README.md
new file mode 100644
index 00000000000..4e51216ce4d
--- /dev/null
+++ b/hy-AM/django_models/README.md
@@ -0,0 +1,203 @@
+# Django մոդելներ
+
+Մեզ ինչ-որ բան է պետք ՝ մեր բոլոր բլոգային գրառումները պահելու համար, դա հենց այն է ինչ մենք հիմա կստեղծենք: Բայց նախ եկեք խոսենք `objects/օբյեկտներ` կոչվող իրերի մասին:
+
+## Օbjects/Օբյեկտներ
+
+Ծրագրավորման մեջ կա մի հասկացություն, որը կոչվում է օբյեկտիվ կողմնորոշում(կամ օբյեկտի վրա հիմնված ծրագրավորում:): Գաղափարն այն է, որ հրահանգների ձանձրալի հաջորդականության փոխարեն, մենք մոդելավորում ենք իրերը և նկարագրում, թե ինչպես են դրանք փոխազդում միմյանց հետ:
+
+Այսպիսով, ինչ է օբյեկտը: Դա հատկությունների և գործողությունների հավաքածու է: Տարօրինակ է թվում, բայց մենք մի օրինակ կբերենք: 
+
+Եթե ​​մենք ուզում ենք կատու մոդելավորել, ապա կստեղծենք `Cat/ կատու`t օբյեկտ, որն ունի որոշակի հատկություններ, օրինակ ՝ `color/գույն`, `age/տարիք` `mood/տրամադրություն ` ՝ (վատ, լավ, քնկոտ;)), `owner/սեփականատեր` (օրինակ ՝ մեկ այլ առարկա. Անձ կամ, եթե կատուն վայրի է, այս հատկությունը դատարկ կլինի): 
+
+`Cat/Կատու` օբյեկտը կունենա որոշակի գործողությունների շարք. `purr/մլավել`, `scratch/ճանկռել`, կամ `feed/կերակրել` (որտեղ մենք կատուին տալիս ենք մի քանի `CatFood` (կատվի սնունդ), որը կարող է նաև լինել իր սեփական հատկություններով առանձին առարկա օրինակ `taste/համ` ):
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+Այսպիսով, հիմնականում գաղափարը՝ օբյեկտի նկարագրումն է կոդի մեջ՝ հատկություններով (կոչվում են `object properties/օբյեկտի հատկություններ`) և գործողություններով (կոչվում են `methods/մեթոդներ`):
+
+Այսպիսով, ինչպե՞ս ենք մոդելավորելու բլոգի հաղորդագրությունները: Մենք ուզում ենք բլոգ կառուցել, այնպես չէ՞:
+
+Մենք պետք է պատասխանենք այն հարցին. Ի՞նչ է բլոգի գրառումը: Ի՞նչ հատկություններ պետք է այն ունենա:
+
+Դե, հաստատ մեր բլոգային գրառմանը պետք է ինչ-որ տեքստ իր բովանդակությամբ և վերնագիրով, այնպես չէ՞: Լավ կլինի իմանալ նաև, թե ով է այն գրել, այնպես որ հեղինակը մեզ պետք է: Վերջապես, մենք պետք է իմանանք, թե երբ է ստեղծվել գրառումը և երբ է հրապարակվել:
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Ի՞նչ բաներ կարող եք անել բլոգում գրառման միջոցով: Լավ կլիներ որ գրառումը հրապարակող ինչ-որ մեթոդ լիներ, ճի՞շտ է: 
+
+Այսպիսով, մեզ հարկավոր է `publish/հրապարակման` մեթոդ:
+
+Դե, քանի որ մենք որոշել ենք, թե ինչ ենք ուզում ստանալ, եկեք սկսենք մոդելավորել այն Django- ում:
+
+## Django մոդել
+
+Իմանալով, թե ինչ է օբյեկտը, մենք կարող ենք ստեղծել Django մոդել մեր բլոգի գրառման համար:
+
+Django- ում մոդելը հատուկ տեսակի առարկա է. Այն պահվում է ` տվյալների բազայում/database`.: Տվյալների բազան/database-ը տարբեր տվյալների հավաքածու է: Սա այն վայրն է, որտեղ դուք կպահեք տեղեկատվություն օգտվողների, ձեր բլոգի հաղորդագրությունների և այլնի մասին: Մենք կօգտագործենք SQLite տվյալների բազա ՝ մեր տվյալները պահելու համար: Սա ներքին կարգավորման/default Django տվյալների շտեմարանն է. Այս փուլում նրա հնարավորությունները բավարար են մեր պահանջների համար: 
+
+Դուք կարող եք տվյալների շտեմարանում մոդելի մասին մտածել որպես աղյուսակ ՝ սյունակներով (դաշտերով/columns (fields) և տողերով (տվյալներով)/rows (data):
+
+### Դիմումների ստեղծում
+
+Ամեն ինչ կոկիկ պահելու համար մենք մեր ծրագրի ներսում կստեղծենք առանձին ծրագիր: Շատ հաճելի է ամեն ինչ կազմակերպել հենց սկզբից: Ծրագիր / Application ստեղծելու համար մենք պետք է հրամանի տողում մուտքագրենք հետևյալ հրահանգը ( `djangogirls` գրացուցակից, որտեղ գտնվում է `manage.py` ֆայլը). 
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Դուք կնկատեք, որ ստեղծվել է նոր `blog` գրացուցակ, որն այժմ պարունակում է մի շարք ֆայլեր: Այսպիսով, մեր նախագծում գրացուցակները և ֆայլերը պետք է ունենան այսպիսի տեսք.
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+Դիմումը/application-ը ստեղծվելուց հետո մենք պետք է Django- ին ասենք, որ այն այժմ պետք է օգտագործի այն: Մենք դա անում ենք `mysite/settings.py` ֆայլում - բացեք այն ձեր կոդի խմբագրում/code editor: Մենք պետք է գտնենք `INSTALLED_APPS` և ավելացնենք `'blog.apps.BlogConfig',` պարունակող տող, հենց վերևում `]` : Այսպիսով, վերջնական արդյունքը պետք է ունենա այսպիսի տեսք.
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Բլոգի գրառման մոդելի ստեղծում
+
+`blog/models.py` այս ֆայլում մենք բնութագրում ենք `Models/մոդելներ` կոչվող բոլոր օբյեկտները. Սա մի տեղ է, որտեղ մենք կսահմանենք մեր բլոգի գրառումը/blog post-երը:
+
+Բացեք `blog/models.py` այս ֆայլը կոդերի խմբագրում, ջնջեք ամբողջ տեքստը և փոխարենը տեղադրեք հետևյալ կոդը.
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Համոզվեք, որ `str` մեթոդի յուրաքանչյուր կողմում օգտագործեք երկու տակի գծիկ (`_`) : Այս կոնվենցիան հաճախ օգտագործվում է Python ծրագրավորման մեջ , և երբեմն կոչվում է "dunder" (կարճ ՝ «կրկնակի ընդգծում»/ "double-underscore"): 
+
+Սարսափելի է թվում, ճի՞շտ է: Բայց մի անհանգստացեք. Մենք կբացատրենք, թե ինչ են նշանակում այս տողերը:
+
+Բոլոր տողերը, որոնք `from` կամ `import` են սկսվում, թույլ են տալիս մուտք գործել կոդ այլ ֆայլերից: Այսպիսով, բոլոր ֆայլերի միջև միևնույն կոդը պատճենելու և տեղադրելու փոխարեն, մենք կարող ենք այն հղել ՝ օգտագործելով `...
+ import ...`.
+
+`class Post(models.Model):` –այս տողը սահմանում է մեր մոդելը (դա `object/օբյեկտ`-ն է):
+
+- `class/դասը` հատուկ բանալիբառ է, որը ցույց է տալիս, որ մենք օբյեկտ ենք սահմանում:
+- `Post` -ը մեր մոդելի անունն է: Ցանկության դեպքում մենք կարող ենք փոխել այն (բայց պետք է խուսափել հատուկ նիշերից և սպիտակ տարածությունից): Միշտ դասի անունը սկսեք մեծատառով: 
+- `models.Model` նշանակում է, որ Post օբյեկտը Django մոդել է, ուստի Django- ն գիտի, որ անհրաժեշտ է այն պահպանել տվյալների բազայում:
+
+Այժմ մենք սահմանում ենք այն հատկությունները, որոնց մասին մենք խոսում էինք ՝ `title/վերնագիրը`, `text/տեքստը`, `created_date/ստեղծման ամսաթիվը`, `published_date/հրապարակման ամսաթիվը` և `author/հեղինակ`. Դա անելու համար մենք պետք է պարզենք յուրաքանչյուր դաշտի տեսակը (արդյո՞ք այն տեքստային է): Թվայի՞ն Ամսաթի՞վ Կապը մեկ այլ օբյեկտի հետ, ինչպես օգտագործողը:)
+
+- `models.CharField` - այսպես մենք սահմանում. տեքստի դաշտ նիշերի քանակի սահմանափակումով:
+- `models.TextField` -սա երկար տեքստի համար է ՝ առանց սահմանի: Իդեալական է թվում բլոգի գրառման բովանդակության համար, այնպես չէ՞:
+- `models.DateTimeField` - սա ամսաթիվ և ժամ է:
+- `models.ForeignKey` –սա հղում է դեպի այլ մոդել:
+
+Մենք չենք բացատրի կոդերի յուրաքանչյուր մասն այստեղ, քանի որ դա չափազանց շատ ժամանակ կպահանջի: Ստուգեք Django- ի պաշտոնական փաստաթղթերը. Եթե ցանկանում եք ավելին իմանալ մոդելի դաշտերի և տարբեր օբյեկտներ սահմանելու մասին, այս հղումը կարող է օգնել. (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types) :
+
+Ինչ կասե՞ք `def publish(self):` (def հրապարակելուն (ինքնուրույն): Սա հենց այն `publish/հրապարակման` եղանակն է, որի մասին նախկինում խոսում էինք: `def` նշանակում է, որ սա function/method-ֆունկցիա / մեթոդ է, և `publish`-ը մեթոդի անունն է: Ցանկության դեպքում կարող եք փոխել մեթոդի անվանումը: Անվանման կանոնն այն է, որ մենք բացատների փոխարեն օգտագործում ենք փոքրատառ և ստորին գծեր: Օրինակ, միջին գինը հաշվարկող մեթոդը կարելի է անվանել `calculate_average_price`:
+
+Մեթոդները հաճախ ինչ-որ բան են `վերադարձնում/ return` : Դրա մի օրինակ կա `__str__` մեթոդում: Այս սցենարում, երբ մենք զանգահարենք `__str__()`, մենք կստանանք գրության վերնագիր ունեցող տեքստ (**string/տող**):
+
+Նաև նկատեք, որ `def publish(self):` և `def __str__(self):` կտրված են մեր դասի ներսում: Քանի որ Python- ը զգայուն է սպիտակ տարածության նկատմամբ, մենք պետք է դասի մեջ ներմուծենք մեր մեթոդները: Հակառակ դեպքում, մեթոդները չեն պատկանի դասին, և դուք կարող եք ինչ-որ անսպասելի արդյունք ունենալ:
+
+Եթե ​​մոդելների հետ կապված ինչ-որ բան դեռ պարզ չէ, ազատորեն հարցրեք ձեր ուսուցչին: Մենք գիտենք, որ դա իսկապես բարդ է, հատկապես, երբ զուգահեռաբար ուսումնասիրում ես, թե ինչ են օբյեկտներն/objects ու գործառույթները/functions: Բայց հուսանք, որ այս ամենը քեզ հիմա մոգություն չի թվում:
+
+### Ստեղծեք աղյուսակներ ձեր տվյալների բազայում
+
+Վերջին քայլը տվյալների բազայում մեր նոր մոդելի ավելացումն է: Նախ, մենք պետք է տեղյակ պահենք Django- ին, որ մենք փոփոխություններ ենք մտցրել մեր մոդելի մեջ: (Մենք հենց նոր ստեղծեցինք այն) Գնացեք ձեր վահանակի պատուհանում և մուտքագրեք `python manage.py makemigrations blog`: Այն պետք է ունենա նման տեսք:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+** Նշում. ** Մի մոռացեք պահպանել ձեր խմբագրած ֆայլերը: Հակառակ դեպքում, ձեր համակարգիչը կգործարկի նախորդ տարբերակները, որը կարող է ձեզ անսպասելի սխալ հաղորդագրություններ հաղորդել: 
+
+Django- ն մեզ համար տվյալների բազայի համար ստեղծեց միգրացիոն ֆայլ: Մուտքագրեք `python manage.py migrate blog` , արդյունքը պետք է լինի հետևյալը.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Ուռա! Մեր Post մոդելը այժմ մեր տվյալների բազայում է: Ցանկալի կլիներ տեսնել դա, այնպես չէ՞: Անցեք հաջորդ գլխին ՝ տեսնելու, թե ձեր Post-ը ինչ տեսք ունի:
\ No newline at end of file
diff --git a/hy-AM/django_orm/README.md b/hy-AM/django_orm/README.md
new file mode 100644
index 00000000000..e223fef2a4f
--- /dev/null
+++ b/hy-AM/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM և QuerySets
+
+Այս գլխում դուք կսովորեք, թե ինչպես է Django- ն միանում և պահում տեղեկատվությունը տվյալների բազայում: Եկեք սկսենք:
+
+## Ի՞նչ է QuerySet- ը:
+
+QuerySet- ը, ըստ էության, տվյալ Մոդելի օբյեկտների ցուցակն է: QuerySets- ը թույլ է տալիս կարդալ տվյալների բազան, զտել և փոխել դրանց կարգը:
+
+Օրինակով սովորելը ամենահեշտն է: Փորձենք սա, այնպես չէ՞:
+
+## Django shell
+
+Բացեք ձեր տեղական վահանակը (ոչ PythonAnywhere- ում) և մուտքագրեք այս հրամանը.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Արդյունքն այսպիսին պետք է լինի.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Դուք այժմ Django- ի ինտերակտիվ վահանակում եք: Դա ճիշտ է Python- ի հուշման նման, բայց ինչ-որ լրացուցիչ Django մոգությամբ: :) Այստեղ կարող եք օգտագործել Python- ի բոլոր հրամանները:
+
+### Բոլոր օբյեկտները
+
+Փորձենք նախ ցուցադրել մեր բոլոր հաղորդագրությունները: Դա կարող եք անել հետևյալ հրահանգով.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Վայ Սխալ առաջացավ: Այն մեզ ասում է, որ Փոստ չկա: Եվ դա ճիշտ է. Մենք մոռացել ենք ներմուծել այն:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+Մենք ներմուծում ենք `Post` մոդելը `blog.models`-ից:Փորձենք կրկին ստանալ բլոգի բոլոր գրառումները.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Սա ավելի վաղ ստեղծած հաղորդագրությունների ցուցակն է: Մենք ստեղծեցինք այս հաղորդագրությունները Django ադմինիստրատորի ինտերֆեյսի միջոցով: Բայց հիմա մենք ուզում ենք ստեղծել նոր հաղորդագրություններ Python- ի միջոցով, ինչպե՞ս դա անել:
+
+### Ստեղծել օբյեկտ
+
+Ահա, թե ինչպես եք դուք ստեղծում նոր Post օբյեկտ տվյալների բազայում/database.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Բայց այստեղ մենք ունենք մեկ պակասող բաղադրիչ ՝ `me/ես`: Մենք պետք է որպես հեղինակ փոխանցենք `User/Օգտագործող` մոդելի օրինակ: Ինչպե՞ս դա անել:
+
+Եկեք նախ ներմուծենք Օգտագործողի մոդելը/User model.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Ի՞նչ օգտվողներ ունենք մեր տվյալների բազայում/database: Փորձեք այս:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+Սա նույն գերշահագործողն է/superuser, որը մենք ստեղծել ենք ավելի վաղ: Այժմ եկեք ստեղծենք օգտագործողի օրինակ (այս տողը հարմարեցրեք ձեր սեփական օգտվողի անվանմանը).
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Ինչպես տեսնում եք, մենք այժմ ստանում ենք `get` a `User` `username`/օգտագործող անունով, որը համարժեք է «ola»-ին: Կոկիկ! 
+
+Այժմ մենք վերջապես կարող ենք ստեղծել մեր գրառումը.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Ուռա! Ցանկանու՞մ եք ստուգել, ​​արդյո՞ք այն աշխատում է:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Ահա, ևս մեկ գրառում ցուցակում:
+
+### Ավելացրեք այլ հաղորդագրություններ
+
+Այժմ կարող եք մի փոքր զվարճանալ և ավելացնել նոր հաղորդագրություններ ՝ տեսնելու համար, թե ինչպես է դա աշխատում: Ավելացրեք ևս երկու-երեքը, ապա անցեք հաջորդ մասին:
+
+### Ֆիլտրեք օբյեկտները
+
+QuerySets- ի կարեւոր առանձնահատկությունը օբյեկտները զտելու հնարավորությունն է: Ասենք, որ ուզում ենք գտնել ola օգտվողի հեղինակած բոլոր գրառումնները: `Post.objects.all()` –ում `all/ամբողջի` փոխարեն մենք կօգտագործենք `filter/ֆիլտր ` : Փակագծերի մեջ մենք նշելու ենք այն պայմանները, որոնցով կկառուցվի գրառումների ընտրությունը: Մեր դեպքում պայմանն այն է, որ `author/հեղինակը` պետք է հավասար լինի `me/ինձ `: Django- ում այն կգրվի այսպես `author=me`: Մեր ծածկագիրն այժմ ունի այսպիսի տեսք.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Կամ գուցե `title/վերնագիր` դաշտում ուզում ենք տեսնել բոլոր գրառումները, որոնք պարունակում են «վերնագիր»/'title' բառը:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Նշում** որ `title/Վերնագրի` և `contains/պարունակության` միջև կա երկու ընդգծված նիշ (`_`): Django- ի ORM- ն այս կանոնն օգտագործում է դաշտերի անունները («վերնագիր»/"title") և գործողությունները կամ ֆիլտրերն առանձնացնելու համար («պարունակում է»/"contains"): Եթե ​​դուք օգտագործեք միայն մեկ ընդգծում, դուք կստանաք սխալ ՝ "FieldError: Cannot resolve keyword title_contains".
+
+Կարող եք նաև ստանալ բոլոր հրապարակված հաղորդագրությունների ցուցակը: Մենք դա անում ենք ՝ զտելով անցյալում տեղադրված `published_date/հրապարակված_ամսաթերթը` բոլոր հաղորդագրությունները:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Ցավոք, գրառումը, որը մենք ավելացրել ենք Python կոնսոլից, դեռ հրապարակված չէ: Բայց մենք կարող ենք դա փոխել: Նախ ընտրենք այն գրառումը, որը մենք ցանկանում ենք հրապարակել.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+Եվ այնուհետև հրապարակեք այն մեր `publish/հրապարակել ` եղանակով:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Այժմ կրկին փորձեք ստանալ հրապարակված հաղորդագրությունների ցուցակը (3 անգամ սեղմեք վեր սլաքը և ապա `enter`).
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Օբյեկտների կարգավորում
+
+QuerySets- ը թույլ է տալիս տեսակավորել օբյեկտները: Փորձենք տեսակավորել ըստ `created_date/ստեղծման_ամսաթիվ` դաշտի.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Կարող ենք նաև հակադարձել հրամանը ՝ սկզբում ավելացնելով սա `-`
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Բարդ հարցումներ մեթոդի շղթայացման միջոցով
+
+Ինչպես տեսնում եք, `Post.objects` - ի որոշ մեթոդներ վերադարձնում են QuerySet- ը: Նույն մեթոդները կարելի է կրկին կանչել QuerySet- ում, և նրանք կվերադարձնեն նոր QuerySet: Այս կերպ Դուք կարող եք շղթայել դրանց ազդեցությունը ՝ դրանք միմյանց **chaining/կապակցելով**:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Սա իսկապես հզոր է և թույլ է տալիս գրել բավականին բարդ հարցումներ:
+
+Գերազանց է! Այժմ դուք պատրաստ եք հաջորդ մասի: Ինտերակտիվ վահանակը/shell փակելու համար մուտքագրեք ՝
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/hy-AM/django_start_project/README.md b/hy-AM/django_start_project/README.md
new file mode 100644
index 00000000000..1cd2562644a
--- /dev/null
+++ b/hy-AM/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Ձեր առաջին Django նախագիծը:
+
+> Այս գլխի մի մասը հիմնված է Geek Girls Carrots- ի ձեռնարկների վրա (https://github.com/ggcarrots/django-carrots):
+> 
+> Այս գլխի մասերը հիմնված են django-marcador ձեռնարկի վրա, որը լիցենզավորված է Creative Commons Attribution-ShareAlike 4.0 միջազգային լիցենզիայի կողմից: Django-marcador ձեռնարկի հեղինակային իրավունքները պաշտպանված են Markus Zapke-Gründemann- ի և այլոց կողմից:
+
+Մենք պատրաստվում ենք ստեղծել փոքրիկ բլոգ:
+
+Առաջին քայլը նոր Django նախագիծ սկսելն է: Ըստ էության, սա նշանակում է, որ մենք գործարկելու ենք մի քանի ստանդարտ սցենարներ Django բաշխումից, որոնք կստեղծեն նախագծի կմախք մեզ համար: Սա ընդամենը գրացուցակների և ֆայլերի մի խումբ է, որոնք մենք կօգտագործենք ավելի ուշ:
+
+Որոշ ֆայլերի և գրացուցակների անունները շատ կարևոր են Django- ի համար: Դուք չպետք է վերանվանեք այն ֆայլերը, որոնք մենք պատրաստվում ենք ստեղծել: Նրանց այլ տեղ տեղափոխելը նույնպես լավ գաղափար չէ: Django- ն պետք է որոշակի կառուցվածք պահպանի, որպեսզի կարողանա գտնել կարևոր բաներ:
+
+> Մի մոռացեք. Դուք պետք է գործադրեք բոլոր հրամանները virtualenv- ով: Եթե ​​հրամանի տողում չեք տեսնում `(myvenv)` նախածանցը, ապա ձեզ հարկավոր է ակտիվացնել virtualenv- ը: Մենք բացատրեցինք, թե ինչպես դա անել, **Django installation/Django տեղադրում** գլխի **Working with virtualenv/ Աշխատանք virtualenv-ի հետ ** բաժնում: Դա անելու համար մուտքագրեք `myvenv\Scripts\activate` Windows- ում կամ `source myvenv/bin/activate` Mac OS / Linux- ում:
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+Mac OS- ի կամ Linux- ի վահանակի վրա գործարկեք հետևյալ հրամանը. **մի մոռացեք կետ ավելացնել `  ` at the end!/վերջում**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> `.` կետը կարևոր է, քանի որ այն ասում է, որ սցենարը Django- ն տեղադրի ձեր ընթացիկ գրացուցակում (որի համար `.` կետը կարճ հղում է):
+> 
+> **Նշում** Վերը նշված հրամանը մուտքագրելիս հիշեք, որ դուք մուտքագրում եք միայն այն հատվածը, որը սկսվում է `django-admin` - ի կողմից: Այս `(myvenv) ~/djangogirls$` հատվածը, որը ցույց է տրված այստեղ, ուղղակի հուշման օրինակ է ՝ հետագա հրամանի մուտքագրման համար:
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Windows- ում պետք է գործարկել հետևյալ հրամանը: ** (Մի մոռացեք վերջում ավելացնել կետը) `. `) **:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> `.` կետը կարևոր է, քանի որ այն ասում է, որ սցենարը Django- ն տեղադրի ձեր ընթացիկ գրացուցակում (որի համար `.` կետը կարճ հղում է):
+> 
+> ** Նշում ** Վերը նշված հրամանը մուտքագրելիս հիշեք, որ դուք մուտքագրում եք միայն այն մասը, որը սկսվում է `django-admin.exe` - ով: `(myvenv) C:\Users\Name\djangogirls>` սրանք ընդամենը տերմինալային արագ տողերի օրինակներ են ՝ հետագա հրամանի մուտքագրման համար:
+
+<!--endsec-->
+
+`django-admin.py` սա սցենար է, որը կստեղծի գրացուցակի անհրաժեշտ կառուցվածքը և ֆայլերը մեզ համար: Այժմ դուք պետք է ունենաք ծրագրի հետևյալ կառուցվածքը.
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Նշում**. Գրացուցակի կառուցվածքում կտեսնեք նաև ձեր ` venv ` գրացուցակը, որը մենք ավելի վաղ ստեղծել էինք:
+
+`manage.py` սա սցենար է, որն օգնում է կառավարել կայքը: Դրանով մենք կկարողանանք վեբ սերվեր գործարկել ձեր համակարգչում ՝ առանց լրացուցիչ ծրագրեր տեղադրելու:
+
+` settings.py ` ֆայլը պարունակում է ձեր կայքի կարգավորումները:
+
+Հիշո՞ւմ եք փոստատարի հետ մեր անալոգիան, որը ստուգում է, թե որտեղ պետք է նամակ առաքել: ` urls.py ` ֆայլը պարունակում է ` urlresolver ` - ի կողմից օգտագործված օրինաչափությունների ցուցակ:
+
+Եկեք առայժմ մոռանանք մնացած ֆայլերի մասին , քանի որ դրանք չենք փոխելու: Միակ բանը, որ պետք է հիշել, դրանք պատահաբար չջնջելն է:
+
+## Փոխել կարգավորումները
+
+Եկեք որոշ փոփոխություններ կատարենք `mysite/settings.py` - ում: Բացեք ֆայլը ՝ ավելի վաղ տեղադրած կոդերի խմբագրիչի/code editor-ի միջոցով:
+
+**Նշում**. Հիշեք, որ `settings.py`- ը սովորական ֆայլ է, ինչպես ցանկացած այլ: Կարող եք այն բացել ձեր կոդերի խմբագրից `օգտագործելով "file -> open" /«ֆայլ-> բաց » գործողությունների ընտրացանկը: Սա ձեզ կտա սովորական պատուհանը, որում կարող եք անցնել ձեր `settings.py` ֆայլը և ընտրել այն: Այլապես, ֆայլը կարող եք բացել ՝ անցնելով ձեր աշխատասեղանի djangogirls պանակը և սեղմել աջ քլիք ֆայլի վրա: Ապա, ցուցակից ընտրեք ձեր կոդի խմբագիրը: Խմբագրի ընտրությունը կարևոր է, քանի որ կարող եք տեղադրել այլ ծրագրեր, որոնք կարող են բացել ֆայլը, բայց թույլ չեն տալիս խմբագրել այն:
+
+Լավ կլինի մեր կայքում ճիշտ ժամային գոտի սահմանել: Գնացեք [Wikipedia's list of time zones/Վիքիպեդիայի ժամային գոտիների ցուցակ](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) և պատճենեք ձեր համապատասխան ժամային գոտին (TZ) (օրինակ `Europe/Berlin`):
+
+`settings.py` ֆայլում գտեք `TIME_ZONE` պարունակող տողը և փոփոխեք այն ըստ ձեր ժամային գոտու: Օրինակ.
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+Լեզվի կոդը կազմված է մի լեզվով, օրինակ ``en` անգլերենի համար կամ `de` գերմաներենի համար, և երկրի կոդ, ինչպիսիք են `de`- ն Գերմանիայի համար կամ `ch`-ն Շվեյցարիայի համար: Եթե ​​անգլերենը ձեր մայրենի լեզուն չէ, կարող եք լեզու ավելացնել ՝ սկզբնադիր կոճակները և ծանուցումները Django- ից ձեր մայրենի լեզվով փոխելու համար: Այսպիսով, դուք կունենաք "Cancel"/«Չեղարկել» կոճակը թարգմանված այն լեզվով, որը դուք ընտրել եք այստեղ: [Django comes with a lot of prepared translations/ Django- ն տրամադրում է բազմաթիվ թարգմանություններ:](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code):
+
+Եթե ​​այլ լեզվի կարիք ունեք, փոխեք լեզվի կոդը `փոխելով հետևյալ տողը.
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Անհրաժեշտ է նաև ավելացնել ուղի/path ստատիկ ֆայլերի/static files համար: (Ստատիկ ֆայլերի և CSS- ի մասին ամեն ինչ կիմանանք ավելի ուշ ձեռնարկի ընթացքում): Իջեք ֆայլի *end/վերջը* և անմիջապես `STATIC_URL` գրառման տակ, ավելացրեք նորը ՝ `STATIC_ROOT`.
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Երբ `DEBUG`- ը `True/ճիշտ է`ճիշտ է, և `ALLOWED_HOSTS`- ը սահմանված չէ, ընդունիչը գտնվում է ընդդեմ `['localhost', '127.0.0.1', '[::1]']` . Մեր դիմումը գործադրելուց հետո սա չի համապատասխանում PythonAnywhere-ում մեր hostname-ին (հյուրընկալող անունին ), այնպես որ մենք կփոխենք հետևյալ կարգավորումները:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> ** Նշում**. Եթե օգտագործում եք Chromebook, ավելացրեք այս տողը ձեր settings.py ֆայլի վերջում. `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Ինչպես նաև, ավելացրեք ` .amazonaws.com `-ը ` ALLOWED_HOSTS ` - ին, եթե օգտագործում եք cloud9
+> 
+> Եթե ​​դուք ընդունում եք ձեր նախագիծը ` Glitch.com ` կայքում, եկեք պաշտպանենք Django գաղտնի բանալին, որը անհրաժեշտ է մնացեք գաղտնի (հակառակ դեպքում ձեր նախագիծը վերամշակող ցանկացած անձ կարող է տեսնել այն).
+> 
+> - Նախ, մենք պատրաստվում ենք ստեղծել պատահական գաղտնի բանալի: Կրկին բացեք Glitch տերմինալը և մուտքագրեք հետևյալ հրահանգը.
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     Սա պետք է ցուցադրի երկար պատահական տող, որը կատարյալ է որպես գաղտնի բանալի ձեր Django բոլորովին նոր կայքի համար: Այս բանալին մենք այժմ կպցրենք ` .env ` ֆայլի մեջ, որը Glitch- ը ցույց կտա ձեզ միայն այն դեպքում, եթե դուք եք կայքի սեփականատերը:
+> 
+> - Ձեր նախագծի հիմքում ստեղծեք ` .env ` ֆայլ և դրանում ավելացրեք հետևյալ հատկությունը.
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Դրանից հետո թարմացրեք Django- ի կարգավորումների ֆայլը `այս գաղտնի արժեքը ներարկելու համար և տեղադրելով Django կայքի անունը`
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - Եվ նույն ֆայլում մի փոքր ներքև, մենք ներարկում ենք ձեր նոր Glitch կայքի անունը (website-ը).
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     ` PROJECT_DOMAIN ` արժեքն ինքնաբերաբար գեներացվում է Glitch- ի կողմից: Այն կհամապատասխանի ձեր ծրագրի անվանը:
+
+## Ստեղծեք տվյալների բազա
+
+Ծրագրակազմ կան տարբեր տվյալների բազաներ, որոնք կարող են պահել տվյալներ ձեր կայքի համար: Մենք կօգտագործենք սա ՝ `sqlite3`:
+
+Սա արդեն տեղադրված է ձեր ` mysite / settings.py ` ֆայլի այս մասում.
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Մեր բլոգի համար տվյալների շտեմարան ստեղծելու համար եկեք վահանակում գործարկենք հետևյալը.`python manage.py migrate` (մենք պետք է լինենք `djangogirls` գրացուցակում, որը պարունակում է `manage.py` ֆայլը) Եթե ​​ամեն բան լավ է, դուք պետք է տեսնեք նման մի բան.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+Եվ մենք ավարտեցինք: Ժամանակն է սկսել վեբ սերվերը և տեսնել, թե արդյոք մեր կայքը գործում է:
+
+## Վեբ սերվերի գործարկում
+
+Դուք պետք է լինեք գրացուցակում, որտեղ գտնվում է `manage.py` ֆայլը (մեր դեպքում ՝ `djangogirls`): Վահանակում մենք կարող ենք սկսել վեբ սերվերը ՝ գործարկելով `python manage.py runserver`.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Եթե ​​աշխատում եք Chromebook- ի վրա, ապա օգտագործեք այս հրահանգը.
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+կամ սա, եթե օգտագործում եք Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+Եթե ​​դուք Windows- ում եք, և դա չի հաջողվում ` UnicodeDecodeError ` - ի հետ, փոխարենը օգտագործեք այս հրամանը.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Այժմ դուք պետք է ստուգեք, արդյո՞ք ձեր կայքը գործում է: Բացեք ձեր բրաուզերը (Firefox, Chrome, Safari, Internet Explorer կամ այլ ինչ որ օգտագործում եք) և մուտքագրեք այս հասցեն.
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+Եթե ​​օգտագործում եք Chromebook և Cloud9, փոխարենը կտտացրեք ելնող պատուհանի URL- ին, որը պետք է որ հայտնվեր հրամանի պատուհանի վերևի աջ անկյունում, որտեղ վեբ սերվերն է աշխատում: URL- ն այսպիսի տեսք կունենա.
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Շնորհավորում եմ Դուք պարզապես ստեղծել եք ձեր առաջին վեբ կայքը և այն վարում եք վեբ սերվերի միջոցով: Դա հիանալի, այնպես չէ՞:
+
+![Տեղադրեք աշխատանքը!](images/install_worked.png)
+
+Նկատի ունեցեք, որ հրամանի պատուհանը միանգամից կարող է գործարկել միայն մեկ բան, իսկ ավելի վաղ ձեր բացած հրամանի պատուհանը վեբ սերվերն է գործարկում: Քանի դեռ վեբ սերվերը աշխատում է և սպասում է լրացուցիչ մուտքային հարցումների, տերմինալը կընդունի նոր տեքստ, բայց չի կատարի նոր հրամաններ:
+
+> Մենք ստուգեցինք, թե ինչպես են աշխատում վեբ սերվերները ** Ինչպես է աշխատում ինտերնետը/How the Internet works ** գլխում:
+
+Վեբ սերվերի գործարկման ժամանակ լրացուցիչ հրամաններ մուտքագրելու համար բացեք նոր տերմինալի պատուհան և ակտիվացրեք ձեր virtualenv-ը. երկրորդ տերմինալի պատուհանը բացելու վերաբերյալ հրահանգները վերանայելու համար տե՛ս [Introduction to the command line/Հրամանի տողի ներածություն](../intro_to_command_line/README.md) բաժնում: Վեբ սերվերը դադարեցնելու համար վերադարձրեք այն պատուհանը, որում այն ​​աշխատում է, և միասին սեղմեք CTRL + C - Control և C ստեղները (Windows- ում գուցե ստիպված լինեք սեղմել Ctrl + Break):
+
+Պատրա՞ստ եք հաջորդ քայլին: Ժամանակն է ստեղծել որոշակի բովանդակություն:
\ No newline at end of file
diff --git a/hy-AM/django_templates/README.md b/hy-AM/django_templates/README.md
new file mode 100644
index 00000000000..f32c320a7ce
--- /dev/null
+++ b/hy-AM/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django շաբլոններ
+
+Որոշ տվյալներ ցուցադրելու ժամանակն է: Դրա համար Django- ն մեզ տալիս է մի քանի օգտակար **template tags/ձևանմուշներ**:
+
+## Ի՞նչ են շաբլոնային պիտակները
+
+Ինչպես տեսնում եք, HTML- ում դուք իսկապես չեք կարող Python կոդ գրել, քանի որ բրաուզերները չեն հասկանում դա: Նրանք գիտեն միայն HTML: Մենք գիտենք, որ HTML- ը բավականին ստատիկ է, մինչդեռ Python- ը շատ ավելի դինամիկ է:
+
+**Django template tags/Django շաբլոնային պիտակները**-ը թույլ են տալիս մեզ Python-ը տեղափոխել HTML- ի մեջ, այնպես որ կարող եք ավելի արագ կառուցել դինամիկ կայքեր: Հիանալի է:
+
+## ցուցադրել հաղորդագրությունների ցուցակի ձևանմուշը 
+
+Նախորդ գլխում մենք մեր ձևանմուշին/template-ին փոխանցեցինք հաղորդագրությունների ցանկը `posts/հաղորդագրությունների ` փոփոխականում: Այժմ այն ​​կներկայացնենք HTML- ով:
+
+Django ձևանմուշի/Django templates մեջ փոփոխական տեղադրելու համար հարկավոր է օգտագործել կրկնակի ձևավոր փակագծեր, որի ներսում փոփոխականի անունն է, ինչպես օրինակում.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Փորձեք սա ձեր ձևանմուշում/template `blog/templates/blog/post_list.html` : Բացեք այն կոդերի խմբագրում և փոխարինեք ամեն ինչ ՝ սկսած երկրորդ –ից`<div>` երրորդ-`</div>` - ով `{{ posts }}`. Պահեք ֆայլը և թարմացրեք էջը ՝ արդյունքները տեսնելու համար. 
+
+![Նկար 13.1](images/step1.png)
+
+Ինչպես տեսնում եք, մենք ստացանք հետևյալ տողը.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Սա ցույց է տալիս, որ Django- ն փոփոխականը հասկանում էր որպես օբյեկտների ցուցակ: Հիշեք Python- ի **Introduction to Python** («Ներածությունից), թե ինչպես կարող ենք ցուցակներ ցուցադրել: Ճիշտ է, for հանգույցով: Django- ի ձևանմուշում դրանք կարող եք օգտագործել այսպես.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Փորձեք սա ձեր ձևանմուշում:
+
+![Նկար 13.2](images/step2.png)
+
+Այն աշխատում է! Բայց մենք ուզում ենք, որ դրանք հայտնվեն որպես ստատիկ գրառումներ, որոնք մենք ստեղծել ենք **Introduction to HTML/ «HTML Ներածություն» ** գլխում: Դուք կարող եք խառնել HTML և ձևանմուշի պիտակները: Մեր `body`-ի տարրը կունենա այսպիսի տեսք.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %} Այն ամենը, ինչ դնում եք `{% for %}` - ի և `{% endfor %}` - ի միջև, կկրկնվի ցուցակի յուրաքանչյուր կետի համար: Թարմացրեք էջը ՝ {% endraw %}
+
+![Նկար 13.3](images/step3.png)
+
+Նկատե՞լ եք, որ այս անգամ մենք մի փոքր այլ գրառում ենք օգտագործել (`{{ post.title }}` or `{{ post.text }}`)? Մենք մուտք ենք գործում տվյալների `Post` մոդելում սահմանված յուրաքանչյուր դաշտ: Նաև `|linebreaksbr` -ը տեքստը ֆիլտրում է զտիչի միջոցով ՝ տողերի ընդմիջումները/line-breaks/ պարբերությունների/paragraphs/ վերածելու համար:
+
+## Եվս մեկ բան
+
+Ժամանակն է մեկ անգամ ևս համոզվել, որ մեր կայքը կաշխատի հանրային ինտերնետում, այնպե՞ս չէ: Փորձենք կայքի նոր տարբերակը տեղակայել PythonAnywhere - ում: Ահա քայլերի ամփոփումը...
+
+* Նախ վերբեռնեք ձեր կոդը GitHub- ում
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Դրանից հետո անցեք [ PythonAnywhere ](https://www.pythonanywhere.com/consoles/), բացեք **Bash console** (կամ սկսեք նորը) և մուտքագրեք հրահանգը.
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Հիշեք, որ `<your-pythonanywhere-domain>` - ը փոխարինեք ձեր PythonAnywhere օգտվողի անունով, առանց անկյունային փակագծերի:)
+
+* Վերջապես, անցեք ["Web" page/«Վեբ» էջ](https://www.pythonanywhere.com/web_app_setup/) և սեղմեք **Reload/Վերաբեռնում** ձեր վեբ հավելվածում: (Վահանակից PythonAnywhere- ի այլ էջեր հասնելու համար օգտագործեք վերևի աջ անկյունում գտնվող ընտրացանկի կոճակը): Ձեր թարմացումը պետք է հասանելի լինի https://subdomain.pythonanywhere.com- ստուգեք բրաուզերում: Եթե ​​PythonAnywhere կայքում բլոգի գրառումները չեն համընկնում տեղական սերվերում տեղակայված բլոգում հայտնվող գրառումների հետ, դա նորմալ է: Ձեր տեղական համակարգչի և PythonAnywhere- ի տվյալների բազան համապատասխանեցված չէ ձեր մնացած ֆայլերի հետ:
+
+Շնորհավորում ենք։ Այժմ շարունակեք և փորձեք նոր գրառում ավելացնել Django ադմինիստրատորին (չմեռանաք ավելացնել published_date!) Համոզվեք, որ դուք գտնվում եք Django ադմինիստրատորում ձեր pythonanywhere կայքի համար https://subdomain.pythonanywhere.com/admin: Դրանից հետո թարմացրեք ձեր էջը ՝ տեսնելու համար արդյոք գրառումը հայտնվում է այնտեղ:
+
+Զարմանալի՞ է աշխատում: Մենք հպարտ ենք ձեզանով: Մի փոքր հեռացեք համակարգչից. Դուք ընդմիջում եք վաստակել:
+
+![Նկար 13.4](images/donut.png)
\ No newline at end of file
diff --git a/hy-AM/django_urls/README.md b/hy-AM/django_urls/README.md
new file mode 100644
index 00000000000..1235171fbb0
--- /dev/null
+++ b/hy-AM/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URL- ներ
+
+Մենք պատրաստվում ենք ստեղծել մեր առաջին վեբ էջը. Ձեր բլոգի գլխավոր էջը: Բայց նախ եկեք մի փոքր սովորենք Django URL- ների մասին:
+
+## Ի՞նչ է URL-ը:
+
+URL- ը վեբ հասցե է: Դուք կարող եք տեսնել URL ՝ ամեն անգամ կայք այցելելիս. Այն տեսանելի է ձեր զննարկչի հասցեի տողում: Այո `127.0.0.1:8000` URL է: Եվ `https://djangogirls.org` նույնպես URL է:
+
+![URL](images/url.png)
+
+Ինտերնետում յուրաքանչյուր էջ իր սեփական URL- ի կարիքն ունի: Այս կերպ ձեր հավելվածը գիտի, թե ինչ պետք է ցույց տա այդ URL- ը բացող օգտվողին: Django- ում մենք օգտագործում ենք `URLconf` անունով մի բան (URL configuration/URL կազմաձևում): URLconf- ը օրինաչափությունների ամբողջություն է, որոնք Django- ն կփորձի համապատասխանել ստացված URL- ի հետ `դիտման համար ճիշտ մեթոդ ընտրելու համար:
+
+## Ինչպե՞ս են աշխատում URL- ները Django- ում:
+
+Եկեք բացենք `mysite/urls.py` ֆայլը ձեր ընտրած կոդի խմբագրում և տեսնենք, թե ինչ տեսք ունի այն.
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Ինչպես տեսնում եք, Django- ն այստեղ արդեն ինչ-որ բան է տեղադրել մեզ համար:
+
+Եռապատիկ չակերտների միջեւ տողերը(`'''` or `"""`) կոչվում են docstrings/փաստաթղթերի գծեր. դուք կարող եք դրանք գրել ֆայլի, դասի կամ մեթոդի վերևում `բացատրելու համար, թե ինչ է դա անում: Դրանք չեն գործարկվի Python- ի կողմից:
+
+Նախորդ գլխում այցելած ադմինիստրատորի URL- ն արդեն առկա է այստեղ ՝
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Այս տողը նշանակում է, որ յուրաքանչյուր URL- ի համար, որը սկսվում է `admin/`, /ադմինիստրատորով Django- ն կգտնի համապատասխան *view* /տեսք: Այս դեպքում մենք ընդգրկում ենք մեծ թվով ադմինիստրատորի URL- ներ, որոնք հստակ գրված չեն այս փոքր ֆայլում. Սա շատ ավելի կոկիկ է և ավելի ընթեռնելի:
+
+## Ձեր առաջին Django URL- ը:
+
+Ժամանակն է ստեղծել ձեր առաջին URL- ը: Մենք ուզում ենք, որ «http://127.0.0.1:8000/» - ը լինի մեր բլոգի գլխավոր էջը `դրանում տեղադրված հաղորդագրությունների ցուցակով:
+
+Մենք նաև ուզում ենք մաքուր պահել ` mysite/urls.py ` ֆայլը, այնպես որ URL- ներ կներմուծենք մեր ` blog` ծրագրից հիմնական ` mysite/urls.py ` ֆայլ:
+
+Առաջ անցեք, տող ավելացրեք `blog.urls` - ը ներմուծելու համար: Նշենք, որ մենք այստեղ օգտագործում ենք `include/ներառման` գործառույթը/function, այնպես որ դուք ստիպված կլինեք այն ներմուծել `from django.urls…` տողում:
+
+Ձեր `mysite/urls.py` ֆայլը այժմ պետք է ունենա այսպիսի տեսք.
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django- ն այժմ «http://127.0.0.1:8000/» - ի բոլոր խնդրանքները կուղղորդի դեպի `blog.urls` և այնտեղ կփնտրի հետագա հրահանգները:
+
+## blog.urls
+
+`blog` գրացուցակում ստեղծեք նոր դատարկ ֆայլ `urls.py` անունով և բացեք այն ձեր կոդի խմբագրում: Շատ լավ! Ավելացրեք այս առաջին երկու տողերը.
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Այստեղ մենք ներմուծում ենք Django- ի `path` գործառույթը և մեր բոլոր `views/դիտումները ` `blog` հավելվածից: (Մենք դեռ դրանք չունենք, բայց մի րոպեից նրանք կհայտնվեն):
+
+Դրանից հետո մենք կարող ենք ավելացնել մեր առաջին URL նմուշը.
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+Ինչպես տեսնում եք, մենք կապել ենք `post_list` անունով `view` -ն և արմատային url- ը: Այս URL- ի օրինակը համընկնում է դատարկ տողի հետ, և Django URL լուծիչը անտեսելու է տիրույթի անունը (այսինքն `http://127.0.0.1:8000/), որը նախածանցում է URL- ի ամբողջական ուղին: Այս օրինակը Django- ին կասի, որ ` views.post_list ` - ը ճիշտ տեղն է այցելելու, եթե ինչ-որ մեկը մուտք է գործում ձեր կայք «http://127.0.0.1:8000/» հասցեով:
+
+Վերջին մասը ՝`name='post_list'`, URL- ի անունն է, որն օգտագործվելու է դիտումը նույնացնելու համար: Դա կարող է նույնը լինել, ինչ view-ի անունն է, կամ կարող է լինել բոլորովին այլ բան: Ծրագրում մենք հետագայում կօգտագործենք անվանական URL- ներ, ուստի կարևոր է, որ դրանց անուններն այժմ ներառվեն ձեր դիմումի մեջ: Մեր URL- ների անունները յուրահատուկ և հեշտ հիշվող պետք է լինեն:
+
+Եթե ​​այժմ փորձեք այցելել http://127.0.0.1:8000/, ապա դուք պետք է տեսնեք այնպիսի հաղորդագրություն, որում ասվում է ՝ «ինտերնետային էջը հասանելի չէ»/'web page not available' : Դա այն պատճառով է, որ սերվերը (Հիշո՞ւմ եք մուտքագրեք `runserver`) այլևս չի աշխատում: Հայացք գցեք ձեր սերվերի վահանակի պատուհանից ՝ պարզելու պատճառը:
+
+![Սխալ](images/error1.png)
+
+Ձեր վահանակը սխալ է ցույց տալիս, բայց մի անհանգստացեք. Սա իրականում շատ օգտակար է. այն Ձեզ ասում են, որ **no attribute 'post_list'**("բացակայում է հատկությունը 'post_list'"-ում): Դա այն *view*-ի անունն է, որը Django- ն փորձում է գտնել և օգտագործել, բայց մենք այն դեռ չենք ստեղծել: Այս փուլում ձեր `/admin/`/ադմինիստրատորը նույնպես չի աշխատի: Մի անհանգստացեք. Մենք կհասնենք այնտեղ: Եթե ​​այլ սխալի հաղորդագրություն եք տեսնում, փորձեք վերագործարկել/restart ձեր վեբ սերվերը: Դա անելու համար վեբ սերվերը աշխատող վահանակի պատուհանում դադարեցրեք այն ՝ սեղմելով Ctrl + C (Control և C ստեղները միասին): Windows- ում գուցե ստիպված լինեք սեղմել Ctrl + Break: Ապա դուք պետք է վերագործարկեք վեբ սերվերը ՝ գործարկելով <`python manage.py runserver` հրամանը:
+
+> Եթե ​​ցանկանում եք ավելին իմանալ Django- ի ադմինիստրատորի մասին, տես պաշտոնական փաստաթղթերի այս բաժինը ՝ https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/hy-AM/django_views/README.md b/hy-AM/django_views/README.md
new file mode 100644
index 00000000000..7658a117908
--- /dev/null
+++ b/hy-AM/django_views/README.md
@@ -0,0 +1,44 @@
+# Django- ի դիտում. Ստեղծագործելու ժամանակն է:
+
+Ժամանակն է ազատվել այն սխալից, որի հետ մենք բախվեցինք վերջին գլխում: :)
+
+*view/տեսարանը * այն հատվածն է, որտեղ տեղադրում ենք մեր հավելվածի «տրամաբանությունը»: Այն տեղեկատվություն կխնդրի ձեր ստեղծած նախկին `model`-ից և կփոխանցի `template/ձևանմուշ`-ին: Հաջորդ գլխում շաբլոն/template կստեղծենք: Views/Դիտումները պարզապես Python գործառույթներ/ Python functions են, որոնք մի փոքր ավելի բարդ են, քան այն, ինչ մենք գրել ենք **Introduction to Python/Python- ի «Ներածություն»** գլխում:
+
+Դիտումները տեղակայված են ` views.py ` ֆայլում: Մենք կավելացնենք մեր *views/դիտումները * `blog/views.py`- ին:
+
+## blog/views.py
+
+Լավ, եկեք բացենք այս ֆայլը մեր կոդի խմբագրում/code editor և տեսնենք, թե ինչ կա այնտեղ:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Այստեղ դեռ շատ բան չկա:
+
+Հիշեք, որ ` # ` - ով սկսվող տողերը մեկնաբանություններ են. դա նշանակում է, որ այս տողերը չեն աշխատի Python- ում:
+
+Եկեք ստեղծենք *view/տեսակետ*, ինչպես հուշում է մեկնաբանությունը: Դրա տակ ավելացրեք հետևյալ նվազագույն տեսքը.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Ինչպես տեսնում եք, մենք ստեղծել ենք `post_list` անունով մի (`def`) մեթոդ, որը `request/խնդրանք` -ը որպես փաստարկ է վերցնում և `return/վերադարձնում` է `render/մատուցման ` մեթոդի արդյունքը, որը հավաքելու է մեր `blog/post_list.html` էջի ձևանմուշը:
+
+Պահեք ֆայլը, անցեք այստեղ հղումով http://127.0.0.1:8000/ և տեսեք, թե ինչ ունենք:
+
+Եվս մեկ սխալ: Կարդացեք, թե ինչ է կատարվում հիմա ՝
+
+![Սխալ](images/error.png)
+
+Սա ցույց է տալիս, որ սերվերը գոնե նորից է աշխատում, բայց նրա աշխատանքի ընթացքը դեռ սխալ է թվում, ճի՞շտ է: Մի անհանգստացեք, սա պարզապես սխալի էջ է, վախենալու ոչինչ չկա: Ինչպես և վահանակի սխալի հաղորդագրությունները, այս հաղորդագրությունները նույնպես օգտակար են: Կարող եք կարդալ, որ *TemplateDoesNotExist*: Եկեք շտկենք այս սխալը և ձևանմուշ/template ստեղծենք հաջորդ գլխում:
+
+> Իմացեք ավելին Django- ի տեսակետների/Django views-ի մասին `կարդալով պաշտոնական փաստաթղթերը. https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/hy-AM/dynamic_data_in_templates/README.md b/hy-AM/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..74e76af4f3a
--- /dev/null
+++ b/hy-AM/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Տվյալների դինամիկ փոփոխություն ձևանմուշներում
+
+Մենք ունենք տարբեր կտորներ. `Post` մոդելը սահմանվում է `models.py`- ում, մենք ունենք `post_list`- ը `views.py` - ում և ավելացնում է ձևանմուշը: Բայց ինչպե՞ս ցուցադրել գրառումները HTML էջի ձևանմուշում: Ի վերջո, սա հենց այն է, ինչին մենք ուզում ենք հասնել. Վերցնել որոշակի բովանդակություն (շտեմարանում պահվող մոդելներ) և ճշգրիտ ցուցադրել դրանք մեր ձևանմուշում/ template, այնպես չէ՞:
+
+Դրան են ծառայում դիտումները/*views* ՝ մոդելներն ու ձևանմուշները/models and templates/ միացնելու համար: `post_list` *view*-ում մենք պետք է վերցնենք այն մոդելները, որոնք մենք ցանկանում ենք ցուցադրել, և այնուհետև դրանք փոխանցել ձևանմուշին: *view*-ից մենք որոշում ենք, թե ինչ (մոդել) կցուցադրվի ձևանմուշում:
+
+Լավ, բա ինչպե՞ս ենք դրան հասնելու:
+
+Մենք պետք է բացենք `blog/views.py` ֆայլը կոդի խմբագրում/code editor: Այսպիսով, `post_list` *view* այսպիսի տեսք ունի.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Հիշո՞ւմ եք, մենք խոսեցինք այլ ֆայլերից կոդ ներառելու մասին: Այժմ մենք պետք է ներառենք մեր սահմանած մոդելը `models.py` ֆայլում: Մենք կավելացնենք տողը `from .models import Post` - ից հետևյալ կերպ.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+Մոդելներից առաջ կետը/dot նշանակում է *current directory/ընթացիկ գրացուցակ * կամ *current application/ընթացիկ ծրագիր*: Թե `views.py`- ը, թե `models.py` - ին գտնվում են նույն գրացուցակում: Սա նշանակում է, որ մենք կարող ենք օգտագործել կետ `.` և ֆայլի անունը (առանց `.py`-ի): Դրանից հետո մենք ներմուծում ենք մոդելի անվանումը (`Post`):
+
+Բայց ի՞նչ է հաջորդը: `Post` մոդելից իրական գրառում ստանալու համար մեզ պետք է այսպես կոչված `QuerySet`:
+
+## QuerySet
+
+Դուք արդեն պետք է ծանոթ լինեք, թե ինչպես է աշխատում QuerySets- ը: Մենք դրա մասին խոսեցինք [Django ORM (QuerySets) գլխում ](../django_orm/README.md):
+
+Այսպիսով, հիմա մենք ուզում ենք հրապարակված բլոգային հաղորդագրություններ/ published blog posts ՝ տեսակավորված ըստ published_date- ի, ճիշտ է: Մենք դա արդեն արեցինք QuerySets գլխում: 
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Այսպիսով, եկեք բացենք `blog/views.py` ֆայլը կոդի խմբագրում և ավելացնենք կոդի այս կտորը `def post_list(request)`, բայց մի մոռացեք ֆայլի սկզբում ավելացնել `from django.utils import timezone`.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+Մնացել է ընդամենը երկու բան ՝ մեր QuerySet- ը բլոգի գրառումների ցուցակում ցուցադրելու համար.
+
+1. Փոխանցեք `posts` QuerySet-ը ձևանմուշի մեջ ՝ զանգը/call փոխելով `render` function-ի /մատուցման գործառույթի (մենք դա կանենք հենց հիմա):
+2. Փոփոխեք ձևանմուշը ՝ QuerySet `posts`-ը ցուցադրելու համար: Մենք կանդրադառնանք դրան հաջորդ գլխում:
+
+Խնդրում ենք նկատի ունենալ, որ մենք QuerySet- ի համար *variable/փոփոխական* ենք ստեղծել. `posts/հաղորդագրություններ`: Դուք կարող եք դա համարել որպես անուն մեր QuerySet- ի համար: Այսուհետ մենք կարող ենք դրան անդրադառնալ այս անունով:
+
+`render/ռենդեր ` գործառույթում մենք արդեն ունենք `request/հարցման` պարամետրը (այսինքն `այն ամենը, ինչ մենք ստանում ենք օգտագործողից որպես խնդրանք ինտերնետի միջոցով) և ձևանմուշի ֆայլը` (`'blog/post_list.html'`): Վերջին պարամետրը, որն ունի այսպիսի տեսք `{}`, այն է, որտեղ մենք կարող ենք ավելացնել ձևանմուշ օգտագործելու ցանկացած բան: Սա այն վայրն է, որտեղ մենք կարող ենք ավելացնել որոշ բաներ, ձևանմուշի օգտագործման համար: Մենք պետք է նրանց անուններ տանք (մենք հիմա հավատարիմ կմնանք `'posts'/ հաղորդագրություններին` ) :) Դա պետք է ունենա այսպիսի տեսք. `{'posts': posts}`: Նկատի ունեցեք, որ մինչ `:` այս հատվածը լար է; հարկավոր է այն փակել չակերտներով. ` '' `:
+
+Այսպիսով, վերջապես, մեր `blog/views.py` ֆայլը պետք է ունենա այսպիսի տեսք.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+Այսքանը: Հիմա ժամանակն է գնալ ձևանմուշ/template և ցուցադրել QuerySet- ը էջում:
+
+Ցանկանու՞մ եք մի փոքր ավելին իմանալ Django- ի QuerySets- ի մասին: Անցեք այս հղումով՝ https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/hy-AM/extend_your_application/README.md b/hy-AM/extend_your_application/README.md
new file mode 100644
index 00000000000..3198751efd4
--- /dev/null
+++ b/hy-AM/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Ընդլայնել հավելվածը.
+
+Մենք արդեն ավարտել ենք մեր կայքի ստեղծման համար անհրաժեշտ բոլոր տարբեր քայլերը. Մենք գիտենք, թե ինչպես գրել մոդել, URL, դիտում և ձևանմուշ: Մենք նաև գիտենք, թե ինչպես կարելի է գեղեցիկ դարձնել մեր կայքը:
+
+Պրակտիկայի ժամանակն է:
+
+Բլոգում առաջին բանը, որ մեզ պետք է, հատուկ գրառումներ բացելու էջն է, այնպես չէ՞:
+
+Մենք դեռ ունենք `Post` մոդել, ուստի հարկավոր չէ որևէ լրացուցիչ կոդ ավելացնել մեր `models.py` ֆայլին:
+
+## Ստեղծեք ձևանմուշի հղում դեպի գրառման մանրամասներ
+
+Մենք կսկսենք այս `blog/templates/blog/post_list.html` ֆայլի ներսում հղում ավելացնելով: Բացեք այն ձեր կոդերի խմբագրում, և այժմ այն ​​պետք է ունենա այսպիսի տեսք. {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %} Մենք կցանկանայինք ցուցակում գրառման վերնագրից (post's title in the post list) հղում ունենալ գրառման մանրամասների (post's detail) էջին: Եկեք փոխենք `<h2><a href="">{{ post.title }}</a></h2>` այնպես, որ այն հղվի հաղորդագրության մանրամասն էջին ՝ {% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %} toամանակն է բացատրել խորհրդավոր `{% url 'post_detail' pk=post.pk %}`: Ինչպես կարող եք ենթադրել, այս `{% %}`նշումը նշանակում է, որ մենք օգտագործում ենք Django ձևանմուշի պիտակները/ Django template tags.: Այս անգամ մենք կօգտագործենք այն մեկը, որը մեզ համար URL կստեղծի: {% endraw %}
+
+` post_detail ` մասը նշանակում է, որ Django- ն սպասում է URL- ի`blog/urls.py` անունով = post_detail
+
+Իսկ ինչ վերաբերում է `pk=post.pk`- ին: `pk`- ն կարճ բանալին է, որը եզակի նույնացուցիչ է տվյալների բազայում յուրաքանչյուր գրառման համար: Յուրաքանչյուր Django մոդել ունի մի դաշտ, որը ծառայում է որպես իր հիմնական բանալի, և նրա ցանկացած այլ անուն կարող է նաև անվանվել «pk»: Քանի որ մենք չենք սահմանել հատուկ առաջնային բանալի մեր `Post` մոդելի մեջ, Django- ն կստեղծի մեկը մեզ համար (անխոս, դա կլինի մի թիվ, որը յուրաքանչյուր հաղորդագրության համար ավելանում է մեկով, ինչպես 1, 2, 3) և այն ավելացնում է ` pk ` անունով դաշտին ՝ մեր յուրաքանչյուր գրառման համար: Մենք մուտք ենք գործում հիմնական բանալին ՝ մուտքագրելով ` post.pk `, նույն կերպ, ինչպես մուտք ենք գործում այլ դաշտեր (`title/վերնագիր`, `author/հեղինակ`, etc.) մեր `Post/Հրապարակել ` օբյեկտ:
+
+Այժմ, երբ մենք գնանք http://127.0.0.1:8000/, մենք կունենանք սխալ (ինչպես սպասվում էր, քանի որ մենք դեռ URL կամ *view/դիտում* չունենք `post_detail`- ի համար): Դա նման տեսք կունենա: 
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Ստեղծեք URL ՝ post's detail/գրառման մանրամասներ էջի համար
+
+Եկեք `urls.py`- ում ստեղծենք URL մեր `post_detail` *view* համար:
+
+Մենք ուզում ենք, որ մեր առաջին հաղորդագրության մանրամասները ցուցադրվեն այս **URL** - ում ՝ http://127.0.0.1:8000/post/1/
+
+Եկեք `blog/urls.py` ֆայլում URL կազմենք ՝ Django- ին ուղղելու համար `post_detail`, անունով *view/դիտումը*-ն , որը ցույց կտա բլոգի մի ամբողջ գրառում: Բացեք `blog/urls.py` ֆայլը կոդերի խմբագրում և ավելացրեք այս տողը (`path('post/<int:pk>/', views.post_detail, name='post_detail'),`), որպեսզի ֆայլն այսպիսի տեսք ունենա.
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+Այս `post/<int:pk>/` մասը նշում է URL- ի օրինակը. Մենք ձեզ կբացատրենք ստորև.
+
+- `post/` /գրառում նշանակում է, որ URL- ը պետք է սկսվի **post** բառով, որին կհաջորդի **/**: Առայժմ ամեն բան կարգին է:
+- `<int:pk>` - այս հատվածը ավելի բարդ է: Դա նշանակում է, որ Django- ն ակնկալում է ամբողջ թվային արժեք և այն կփոխանցի view-ին որպես `pk` կոչվող փոփոխական:
+- `/` - ապա մեզ պետք է կրկին այս նշանը **/**, մինչև url- ի ավարտը:
+
+Սա նշանակում է, որ եթե ձեր բրաուզերում մուտքագրեք սա `http://127.0.0.1:8000/post/5/` , Django- ն պետք է հասկանա, որ ձեզ հարկավոր է *view*-ն որը կոչվող է ` post_detail `, և և փոխանցել այն տեղեկատվությունը, որը ` pk ` *հավասար է ` 5 ` այս <1>view*-ում:
+
+Լավ, մենք URL- ի նոր օրինակ ենք ավելացրել `blog/urls.py`-ում: Եկեք թարմացնենք էջը ՝ http://127.0.0.1:8000/ Boom! Սերվերը կրկին դադարեցրել է աշխատանքը: Հայացք գցեք կոնսոլին. Ինչպես և սպասվում էր, ևս մեկ սխալ կա:
+
+![AttributeError](images/attribute_error2.png)
+
+Հիշու՞մ եք, թե որն է հաջորդ քայլը: Դա view-ի/տեսակետ է ավելացնում:
+
+## Ավելացնել հաղորդագրության մանրամասն տեսք/post's detail view
+
+Այս անգամ մեր *view*-ին/ տեսակետին տրվում է լրացուցիչ պարամետր, `pk`. Մեր *view*-ն պետք է որսա, այնպես չէ՞: Այսպիսով, մենք մեր գործառույթը կսահմանենք որպես `def post_detail(request, pk):`. Նկատի ունեցեք, որ այս պարամետրը պետք է ունենա ճիշտ նույն անունը, ինչ որ մենք նշեցինք `urls` (`pk`) ներսում. Նկատի ունեցեք նաև, որ այս փոփոխականը բաց թողնելը սխալ է և կհանգեցնի սխալի:
+
+Այժմ մենք ուզում ենք ստանալ մեկ և միայն մեկ բլոգային հաղորդագրություն: Դա անելու համար մենք կարող ենք օգտագործել հարցաթերթիկներ, ինչպես հետևյալը.
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Բայց այս ծածկագիրը խնդիր ունի: Եթե ​​`primary key` (`pk`) -ում (տրված առաջնային բանալում) `Post`/գրառում չկա, մենք կունենանք շատ տգեղ սխալ:
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+Մենք դա չենք ուզում: Բայց բարեբախտաբար, Django- ն շրջանցելու միջոց ունի, որը կկարգավորի դա մեզ համար. `get_object_or_404`: Այն դեպքում, երբ չկա `Post`/Հաղորդագրություն տրված ` pk ` -ի համար, մենք կստանանք շատ ավելի լավ էջ, որը կոչվում է `Page Not Found 404`/ Էջը չի գտնվել):
+
+![Page not found](images/404_2.png)
+
+Լավ նորությունն այն է, որ դուք իրականում կարող եք ստեղծել ձեր սեփական `Page not found` / չգտնված էջը/ և այն դարձնել այնքան գեղեցիկ, որքան ցանկանում եք: Բայց դա հիմա այդքան էլ կարևոր չէ, ուստի մենք այն բաց կթողնենք:
+
+Լավ, ժամանակն է մեր `views.py` ֆայլին *view* /դիտում ավելացնել:
+
+`blog/urls.py`- ում մենք ստեղծեցինք URL կանոն `post_detail` անունով, որը վերաբերում է `views.post_detail` կոչվող դիտմանը: Սա նշանակում է, որ Django- ն `blog/views.py`- ի ներսում `post_detail` անունով գործառույթ կսպասարկի ներկայացնելու համար:
+
+Ժամանակն է բացել `blog/views.py` ֆայլը կոդի խմբագրում և տողերի կողքին ավելացնել `from` հետևյալ տողերը.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+Եվ ֆայլի վերջում մենք կավելացնենք մեր *view* -ն:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Այո Էջը թարմացնելու ժամանակն է ՝ http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+Աշխատում է! Ի՞նչ է պատահում, եթե փորձեք հետևել հաղորդագրության վերնագրի հղմանը:
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Օ ոչ! Եվս մեկ սխալ! Բայց մենք արդեն գիտենք, թե ինչպես վարվել դրա հետ, ճիշտ է: Մենք պետք է ձևանմուշ/template ավելացնենք:
+
+## Ստեղծեք ձևանմուշի հղում գրառման մանրամասների համար
+
+Մենք `blog/templates/blog`-ում կստեղծենք ֆայլ, որը կոչվում է `post_detail.html`, և կբացենք այն կոդերի խմբագրում:
+
+Մուտքագրեք հետևյալ ծածկագիրը.
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Կրկին մենք երկարացնում ենք `base.html`- ը: `content` (բովանդակություն) բլոկում մենք ցուցադրում ենք հրապարակման ամսաթիվը (եթե գոյություն ունի հրապարակված_ թվականը), վերնագիրն ու տեքստը: Բայց մենք պետք է քննարկենք մի քանի կարևոր բաներ, ճիշտ է՞:
+
+No translations matched your search {% raw %}`{% if ... %} ... {% endif %}` - ը ձևանմուշի պիտակ է, որը մենք կարող ենք օգտագործել, եթե ինչ-որ բան փորձելու կարիք ունենանք: (Հիշո՞ւմ եք եթե ... `if... կառուցվածքը Python- ի «Ներածություն» գլխից:) Այս բաժնում մենք ուզում ենք ստուգել, ​​թե արդյոք մեր գրառման <code>published_date` -ն /հրապարակված_թվականը պարունակում է տվյալներ, թե ոչ:{% endraw %}
+
+Լավ, մենք կարող ենք թարմացնել մեր էջը և տեսնել, թե արդյո՞ք `TemplateDoesNotExist` - ը այլևս չկա:
+
+![Post detail page](images/post_detail2.png)
+
+Այո դա աշխատում է:
+
+# Տեղակայման ժամանակն է:
+
+Լավ կլինի ստուգել, ​​որ կայքը դեռ աշխատում է PythonAnywhere- ում, ճիշտ չէ՞: Եկեք նորից կատարենք տեղակայումը:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Հետո, [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/)-ում:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Հիշեք, որ `<your-pythonanywhere-domain>` - ը փոխարինեք ձեր PythonAnywhere օգտվողի անունով, առանց չակերտների (անկյունային փակագծերի:)
+
+## Ստատիկ ֆայլերի թարմացվումը սերվերում
+
+Python- ի նման սերվերները ցանկացած այլ վայրում սիրում են ստեղծել «ստատիկ ֆայլեր» (օրինակ ՝ CSS ֆայլեր) Python ֆայլերից առանձին, քանի որ դրանք կարող են օպտիմալացնել, որպեսզի դրանք ավելի արագ բեռնվեն: Արդյունքում, ամեն անգամ, երբ մենք փոփոխություններ ենք կատարում մեր CSS ֆայլերում, մենք պետք է սերվերի վրա գործադրենք լրացուցիչ հրաման ՝ ասելու, որ դրանք թարմացնի: Հրամանը կոչվում է `collectstatic`:
+
+Սկսեք ակտիվացնելով ձեր virtualenv- ը, եթե այն արդեն ակտիվ չէ (PythonAnywhere- ը դրա համար օգտագործում է `workon` կոչվող հրամանը, սա նույնն է, ինչ `source myenv/bin/activate` հրամանը, որը դուք օգտագործում եք ձեր սեփական համակարգչում ):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+`manage.py collectstatic` հրամանը փոքր-ինչ նման է < `manage.py migrate`-ին: Մենք որոշ փոփոխություններ ենք կատարում մեր կոդի մեջ, այնուհետև ասում ենք, որ Django- ն *apply* / <0>կիրառի</0> այդ փոփոխությունները սերվերում կամ տվյալների բազայում ստատիկ ֆայլերի հավաքածուի մեջ:
+
+Ամեն դեպքում, մենք այժմ պատրաստ ենք անցնել ["Web" page](https://www.pythonanywhere.com/web_app_setup/) / <0>«Վեբ» էջ</0> (վահանակի վերևի աջ անկյունում գտնվող կոճակի ընտրացանկից) և կտտացնել **Reload** / <1>Վերաբեռնել</1>, և այնուհետև անցնել այս հղումով https: // page subdomain.pythonanywhere.com արդյունքը տեսնելու համար:
+
+Այսքանը: Դու արեցիր դա!
\ No newline at end of file
diff --git a/hy-AM/how_the_internet_works/README.md b/hy-AM/how_the_internet_works/README.md
new file mode 100644
index 00000000000..9a9629bb60f
--- /dev/null
+++ b/hy-AM/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Ինչպես է աշխատում ինտերնետը
+
+> Ընթերցողների համար տանը. Այս գլուխն ընդգրկված է [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) տեսանյութում
+> 
+> Այս գլուխը ներշնչված է Howեսիկա ՄաքՔելարի (http://web.mit.edu/jesstess/www/) "How the Internet works"(«Ինչպես է աշխատում ինտերնետը») զրույցից:
+
+Մենք գրազ ենք գալիս, որ դուք ամեն օր ինտերնետ եք օգտագործում: Բայց գիտե՞ք իրականում, թե ինչ է պատահում, երբ ձեր զննարկչի մեջ մուտքագրում եք https://djangogirls.org- ի նման հասցե և սեղմում ` enter `:
+
+Առաջին բանը, որ դուք պետք է հասկանաք, այն է, որ կայքը բաղկացած է կոշտ սկավառակի/ hard disk -ի վրա պահված մի շարք ֆայլերից, ինչպես ձեր ֆիլմերը, երաժշտությունը կամ նկարները: Այնուամենայնիվ, կա մեկ առանձնահատկություն, որը հատուկ է միայն կայքերին. Դրանք պարունակում են համակարգչային կոդ, որը կոչվում է HTML:
+
+Եթե ​​դուք ծանոթ չեք ծրագրավորմանը, սկզբում դժվար կլինի հասկանալ HTML- ը, բայց ձեր վեբ բրաուզերները (օրինակ ՝ Chrome, Safari, Firefox և այլն) սիրում են այն: Վեբ բրաուզերները նախատեսված են հասկանալու այս կոդը, հետևելու նրա հրահանգներին և ներկայացնելու այն ֆայլերը, որոնցից կազմված է ձեր կայքը, ճիշտ այնպես, ինչպես ցանկանում եք:
+
+Ինչպես ցանկացած ֆայլ, HTML ֆայլերը նույնպես պետք է պահենք ինչ-որ տեղ մեր կոշտ սկավառակի/hard disk-ի վրա: Ինտերնետի համար մենք օգտագործում ենք հատուկ հզոր համակարգիչներ, որոնք կոչվում են *servers/սերվերներ*: Նրանք չունեն էկրան, մկնիկ կամ ստեղնաշար, քանի որ նրանց հիմնական նպատակը տվյալների պահպանումն ու սպասարկումն է: Այդ պատճառով նրանց անվանում են *servers/սերվեր* , քանի որ դրանք ձեզ ծառայություն են *մատուցում*:
+
+Շատ լավ, բայց ուզում եք իմանալ, թե ինչ տեսք ունի ինտերնետը, ճի՞շտ է:
+
+Մենք նկարեցինք նկար ձեզ համար: Այն այսպիսի տեսք ունի.
+
+![Պատկեր 1.1](images/internet_1.png)
+
+Կարծես խառնաշփոթ է, չէ՞: Իրականում դա միացված մեքենաների ցանց է (վերոհիշյալ *servers/սերվերները*): Հարյուր հազարավոր մեքենաներ: Շատ ու շատ կիլոմետրեր ճոպաններ/cables ամբողջ աշխարհում: Կարող եք այցելել սուզանավերի մալուխային քարտեզի/Submarine Cable Map կայք (http://submarinecablemap.com/) ՝ տեսնելու, թե որքան բարդ է ցանցը: Ահա կայքի սքրինշոթը.
+
+![Պատկեր 1.2](images/internet_3.png)
+
+Դա զարմանալի է, այնպես չէ՞: Այնուամենայնիվ, հասկանալի է, որ հնարավոր չէ յուրաքանչյուր մեքենա մետաղալարով միացնել ինտերնետին: Այսպիսով, ցանկալի մեքենային հասնելու համար (օրինակ,մեկը https://djangogirls.org որտեղ պահպանվում է), մենք պետք է հարցումը փոխանցենք շատ այլ մեքենաների միջով:
+
+Այն պետք է ունենա նման տեսք:
+
+![Պատկեր 1.3](images/internet_2.png)
+
+Պատկերացրեք, որ երբ մուտքագրեք https://djangogirls.org, դուք նամակ եք ուղարկում, որում ասվում է. «Հարգելի Django Girls, ես ուզում եմ տեսնել djangogirls.org կայքը: Ուղարկեք այն ինձ, խնդրում եմ»:
+
+Ձեր նամակը գնում է ձեզ ամենամոտ փոստային բաժանմունք: Այնուհետև այն ուղարկվում է մեկ ուրիշին, որը մի փոքր ավելի մոտ է հասցեատիրոջը, իսկ հետո հաջորդին և այլն, մինչև այն հասցվի իր նպատակակետին: Միակ յուրահատկությունն այն է, որ շատ նամակներ (*data packets/տվյալների փաթեթներ *) մեկ հասցեով ուղարկելիս նրանցից յուրաքանչյուրը կարող է անցնել բոլորովին այլ փոստային բաժանմունքների (*routers/երթուղիչների*) միջով: Դա կախված է նրանից, թե ինչպես են դրանք բաշխվում յուրաքանչյուր գրասենյակում:
+
+![Պատկեր 1.4](images/internet_4.png)
+
+Ահա թե ինչպես է, այն աշխատում. Դուք հաղորդագրություններ եք ուղարկում և սպասում պատասխանի: Իհարկե, թղթի և գրիչի փոխարեն օգտագործվում են տվյալների բայթեր, բայց գաղափարը նույնն է:
+
+Փողոցի, քաղաքի, փոստային կոդի և երկրի անունների փոխարեն մենք օգտագործում ենք IP հասցեներ: Ձեր համակարգիչը նախ խնդրում է DNS- ին (Domain Name System/Դոմեյն անունների համակարգ) djangogirls.org- ը թարգմանել IP հասցեի: Սա գործում է հին հեռախոսների գրքերի նման, որտեղ դուք կարող եք փնտրել այն մարդու անունը, ում հետ ցանկանում եք կապվել, և գտնել նրա հեռախոսահամարը և հասցեն:
+
+Նամակ ուղարկելիս այն պետք է ունենա որոշակի բնութագրեր, որպեսզի այն ճիշտ առաքվի ՝ հասցե, կնիք և այլն: Դուք նաև օգտագործում եք լեզու, որը ստացողը հասկանում է, այնպես չէ՞: Նույնը վերաբերում է *data packets/տվյալների փաթեթներին*, որոնք դուք ուղարկում եք կայքը տեսնելու համար: Մենք օգտագործում ենք HTTP (Hypertext Transfer Protocol) կոչվող արձանագրություն:
+
+Հետեւաբար, հիմնականում, երբ կայք ունեք, պետք է ունենաք նաև սերվեր (մեքենա)/*server* (machine), որտեղ այն գտնվում է: Երբ *server/սերվերը* ստանում է մուտքային *request/հարցում* (նամակով), այն հետ է ուղարկում ձեր կայքը (մեկ այլ նամակով):
+
+Քանի որ սա Django ձեռնարկ է, կարող եք հարցնել, թե ինչ է անում Django- ն: Պատասխան ուղարկելիս միշտ չէ, որ ցանկանում եք նույն բանը ուղարկել բոլոր հասցեատերերին: Շատ ավելի լավ է, եթե ձեր նամակները անձնավորված լինեն, հատկապես այն մարդու համար, ով հենց նոր է գրել ձեզ, այնպես չէ՞: Django- ն օգնում է ձեզ ստեղծել այս անհատականացված, հետաքրքիր նամակները: :)
+
+Բավական է խոսելը ՝ ստեղծագործելու ժամանակն է:
\ No newline at end of file
diff --git a/hy-AM/html/README.md b/hy-AM/html/README.md
new file mode 100644
index 00000000000..a6c7d8b77b2
--- /dev/null
+++ b/hy-AM/html/README.md
@@ -0,0 +1,228 @@
+# HTML- ի ներածություն
+
+Կարո՞ղ եք հարցնել, թե ի՞նչ ձևանմուշ է:
+
+Կաղապարը ֆայլ է, որը մենք կարող ենք կրկին օգտագործել `տարբեր տեղեկատվություն կայուն ձևաչափով ներկայացնելու համար. Օրինակ, դուք կարող եք օգտագործել ձևանմուշ, որը կօգնի ձեզ նամակ գրել, քանի որ չնայած յուրաքանչյուր նամակ կարող է պարունակել տարբեր հաղորդագրություն և հասցեագրված լինել այլ անձի: , նրանք կկիսվեն նույն ձևաչափով:
+
+Django ձևանմուշի ձևաչափը նկարագրված է HTML կոչվող լեզվով (դա HTML- ն է, որը մենք նշել ենք առաջին գլխում ՝ ** How the Internet works (Ինչպես է աշխատում ինտերնետը) **):
+
+## Ի՞նչ է HTML- ը:
+
+HTML- ը ծածկագիր է, որը մեկնաբանվում է ձեր վեբ զննարկչի կողմից, ինչպիսիք են Chrome- ը, Firefox- ը կամ Safari- ն `օգտագործողի համար վեբ էջ ցուցադրելու համար:
+
+HTML- ը նշանակում է «HyperText Markup Language»: ** HyperText ** նշանակում է, որ դա տեքստի տեսակ է, որն աջակցում է էջերի միջև հիպերհղումները: ** Markup (Նշում) ** նշանակում է, որ մենք վերցրել ենք մի փաստաթուղթ և նշել այն կոդով, որպեսզի ինչ-որ բան ասենք (այս դեպքում ՝ զննարկիչ), թե ինչպես մեկնաբանել էջը: HTML կոդը կառուցված է ** tags (պիտակներով) **, յուրաքանչյուրը սկսվում է `<` - ով և ավարտվում `>` - ով: Այս tag-ները (պիտակները) ներկայացնում են markup (մակնշման) ** element-ներ(տարրեր) **:
+
+## Ձեր առաջին template-ը (ձևանմուշը):
+
+Կաղապար ստեղծել նշանակում է ձևանմուշի ֆայլ ստեղծել: Ամեն ինչ ֆայլ է, չէ՞: Դուք հավանաբար դա արդեն նկատել եք:
+
+Ձևանմուշները պահվում են ` blog/templates/blog` գրացուցակում: Այսպիսով, նախ ստեղծեք ` template-ներ (կաղապարներ) ` կոչվող գրացուցակ ձեր բլոգի գրացուցակի ներսում: Դրանից հետո ստեղծեք մեկ այլ գրացուցակ, որը կոչվում է ` blog` ձեր ձևանմուշների գրացուցակում.
+
+    blog
+    └───templates
+        └───blog
+    
+
+(Կարող եք զարմանալ, թե ինչու են մեզ հարկավոր երկու գրացուցակներ, որոնք կոչվում են ` blog`, ինչպես կիմանաք ավելի ուշ, սա անվանակոչման օգտակար պայմանագիր է, որը կյանքն ավելի է հեշտացնում, երբ ամեն ինչ սկսում է բարդանալ:
+
+Եվ հիմա ստեղծեք ` post_list.html ` ֆայլ (պարզապես թողեք այն դատարկ) առայժմ `blog/templates/blog ` գրացուցակի ներսում:
+
+Տեսեք, թե ինչպես է ձեր կայքը այժմ նայում. Http://127.0.0.1:8000/
+
+> Եթե ​​դեռ սխալ ունեք ` TemplateDoesNotExist ` - ը, փորձեք վերագործարկել ձեր սերվերը: Անցեք հրամանի տող, դադարեցրեք սերվերը ՝ Ctrl + C (Control և C ստեղները միասին) սեղմելով և այն նորից սկսեք ՝ գործարկելով ` python manage.py runserver ` command-ը (հրամանը):
+
+![Figure 11.1](images/step1.png)
+
+Այլևս ոչ մի սխալ: Շնորհավորում եմ :) Այնուամենայնիվ, ձեր կայքը իրականում ոչինչ չի հրապարակում, բացի դատարկ էջից, քանի որ ձեր ձևանմուշն էլ է դատարկ: Մենք պետք է դա շտկենք:
+
+Բացեք նոր ֆայլը ծածկագրի խմբագրում և ավելացրեք հետևյալը.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+Այսպիսով, ինչպես է ձեր կայքը այժմ նայում: Այցելեք այն ՝ պարզելու համար ՝ http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+Դա աշխատեց. Հաճելի աշխատանք այնտեղ: :)
+
+* `<! DOCTYPE html >` տողը HTML պիտակ չէ: Այն հայտարարում է միայն փաստաթղթի տեսակը: Այստեղ այն զննարկչին տեղեկացնում է, որ փաստաթղթի տեսակը [ HTML5 ](https://html.spec.whatwg.org/#the-doctype) է: Սա միշտ էլ ցանկացած HTML5 ֆայլի սկիզբ է:
+* Ամենահիմնական թեգը ՝ `<html>`, միշտ html բովանդակության սկիզբն է, և `</html> ` միշտ վերջը: Ինչպես տեսնում եք, կայքի ամբողջ բովանդակությունը անցնում է `<html>` սկզբի և եզրափակիչ թեգի միջև`</html>`
+* `<p>` պիտակ է պարբերության տարրերի համար; `</p> ` փակվում է յուրաքանչյուր պարբերություն
+
+## Գլուխը և մարմինը
+
+Յուրաքանչյուր HTML էջ բաժանվում է նաև երկու element-երի ** head ** և ** body **
+
+* ** head-ը ** էլեմենտ է, որը պարունակում է տեղեկություններ էկրանին չներկայացվող փաստաթղթի մասին:
+
+* ** body-ին ** էլեմենտ է, որը պարունակում է այն ամենը, ինչ ցուցադրվում է որպես վեբ էջի մաս:
+
+Մենք օգտագործում ենք `<head>` ՝ զննարկիչին էջի կազմաձևման մասին պատմելու համար, և `<body>` ՝ պատմելու համար, թե իրականում որն է էջում:
+
+Օրինակ, `<head>` - ի ներսում կարող եք տեղադրել վեբ էջի վերնագրի էլեմենտ, ինչպես հետևյալը.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Պահեք (save) ֆայլը և թարմացրեք ձեր էջը:
+
+![Figure 11.3](images/step4.png)
+
+Նկատեք, թե զննարկիչը ինչպե՞ս է հասկացել, որ "Ola's blog"( «Օլայի բլոգը») ձեր էջի վերնագիրն է: Այն մեկնաբանել է `<title> Օla's blog </title>` և տեքստը դրել ձեր զննարկչի վերնագրի տողում (այն կօգտագործվի նաև էջանիշների համար և այլն):
+
+Հավանաբար, դուք նաև նկատել եք, որ յուրաքանչյուր բացող պիտակ համընկնում է * closing tag (փակող պիտակ) * - ի հետ, ` / ` - ով, և որ էլեմենտ * nested (տեղադրված են) * (այսինքն ՝ կարող եք փակեք որոշակի tag (պիտակ), մինչև որ փակվեն բոլոր ներսում գտնվողները):
+
+Դա նման է իրերը տուփերի մեջ դնելուն: Դուք ունեք մեկ մեծ տուփ ՝ `<html> </html>`; դրա ներսում կա `<body> </body>`, և դա պարունակում է դեռ ավելի փոքր տուփեր. `<p> </p>`
+
+Դուք պետք է պահպանեք պիտակների* closing (փակման) * և * nesting(բնադրման)* տարրերի այս կանոնները. Եթե դա չես անում, զննարկիչը չի կարողանա դրանք ճիշտ մեկնաբանել, և ձեր էջը կցուցադրվի սխալ
+
+## Անհատականացրեք ձեր ձևանմուշը
+
+Այժմ կարող եք մի փոքր զվարճանալ և փորձել հարմարեցնել ձեր ձևանմուշը: Ահա դրա համար մի քանի օգտակար tags (պիտակ):
+
+* `<h1> A heading (Վերնագիր) </h1>` ձեր ամենակարևոր վերնագրի համար
+* `<h2> sub-heading (ենթավերնագիր) </h2>`Հաջորդ մակարդակի վերնագրի համար
+* Նույնիսկ ավելի փոքր`<h3> Ենթավերնագիր </h3>`… և այլն, մինչև `<h6>`
+* `
+<p> Տեքստի մի պարբերություն </p>`
+* `<em> տեքստը </em>` ընդգծում է ձեր տեքստը
+* `<strong> տեքստը </strong>` խիստ ընդգծում է ձեր տեքստը
+* `<br>` անցնում է մեկ այլ տողի (br- ի ներսում ոչինչ չես դնի, և փակիչ պիտակ չկա)
+* `<a href="https://djangogirls.org"> link-ը (հղումը) </a>` ստեղծում է link-ը (հղումը)
+* `<ul> <li> առաջին նյութը </li> <li> երկրորդ կետը </li> </ul>` կազմում է ցուցակ, ինչպես այս մեկը:
+* `<div> </div>` սահմանում է էջի մի հատված
+* `<nav> </nav>` սահմանում է նավիգացիոն հղումների շարք
+* `<article> </article>` սահմանում է անկախ, ինքնամփոփ բովանդակություն
+* `<section> </section>` փաստաթղթում բաժին է սահմանում 
+* `<header> </header>` նշանակում է փաստաթղթի կամ բաժնի վերնագիր
+* `<main> </main>` սահմանում է փաստաթղթի հիմնական բովանդակությունը
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer> </footer>` սահմանում է փաստաթղթի կամ բաժնի տողատակ
+* `<time> </time>` սահմանում է որոշակի ժամանակ (կամ տվյալների ժամանակը)
+
+Ահա ամբողջական ձևանմուշի օրինակ, պատճենեք և տեղադրեք այն ` blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+Մենք այստեղ ստեղծել ենք մեկ ` header (վերնագիր) ` և երկու ` artcicle (հոդված) ` բաժիններ:
+
+* ` header (վերնագիր) ` տարրը պարունակում է մեր բլոգի վերնագիրը. Դա վերնագիր է և link
+* ` article-ի (հոդվածի) ` երկու տարրերը պարունակում են մեր բլոգի հաղորդագրությունները հրապարակված ամսաթվով ` ժամանակ ` տարրում, ` h2 ` տարրը `գրառման վերնագրով, որը սեղմված է և ` p ` (paragraph/ պարբերություն) տարր `մեր բլոգի գրառման տեքստի համար:
+
+Դա մեզ տալիս է այս էֆեկտը.
+
+![Figure 11.4](images/step6.png)
+
+Սա շատ լավ է! Բայց մինչ այժմ մեր ձևանմուշը ցուցադրում է միայն ** նույն տեղեկատվությունը ** մինչդեռ ավելի վաղ մենք խոսում էինք ձևանմուշների մասին, որոնք թույլ էին տալիս մեզ ** տարբեր ** տեղեկատվություն ցուցադրել ** նույն ձևաչափով **
+
+Այն, ինչ մենք իսկապես ուզում ենք անել, մեր Django ադմինիստրատորի մեջ ավելացված իրական հաղորդագրությունների ցուցադրումն է, և ահա թե ուր ենք գնալու:
+
+## Եվս մեկ բան. Տեղակայել:
+
+Լավ կլիներ այս ամենը տեսնել և ապրել ինտերնետում, այնպես չէ՞: Եկեք կատարենք մեկ այլ PythonAnywhere տեղակայում.
+
+### Commit (Պարտավորվել) և push (ուղարկել) ձեր կոդը դեպի GitHub
+
+Նախ և առաջ, եկեք տեսնենք, թե ինչ ֆայլեր են փոխվել վերջին անգամ տեղակայելուց հետո (գործադրեք այս հրամանները տեղական, այլ ոչ թե PythonAnywhere- ում).
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Համոզվեք, որ գտնվում եք ` djangogirls ` գրացուցակում, և եկեք ասենք, որ ` git ` ներառի այս փոփոխությունների բոլոր փոփոխությունները.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Բոլոր ֆայլերը վերբեռնելուց առաջ եկեք ստուգենք, թե ինչ է վերբեռնելու համար ` git ` (բոլոր ֆայլերը, որոնք կբեռնեն ` git `, այժմ պետք է հայտնվեն կանաչ գույնով).
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Մենք համարյա այնտեղ ենք, հիմա ժամանակն է ասել, որ փրկի իր պատմության այս փոփոխությունը: Մենք դրան տալու ենք "commit message" («պարտավորության հաղորդագրություն»), որտեղ նկարագրում ենք, թե ինչ ենք փոխել: Այս փուլում կարող եք մուտքագրել այն ամենը, ինչ կցանկանաք, բայց օգտակար է նկարագրական ինչ-որ բան մուտքագրել, որպեսզի հետագայում կարողանաք հիշել ձեր արածը:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> ** Նշում ** Համոզվեք, որ կրկնակի գնանշումներ եք օգտագործում կատարած հաղորդագրության շուրջ:
+
+Դա անելուց հետո մենք մեր փոփոխությունները վերբեռնում ենք (մղում) մինչև GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Քաշեք ձեր նոր կոդը PythonAnywhere վայր և ներքաշեք ձեր վեբ ծրագիրը
+
+* Բացեք [ PythonAnywhere console page(վահանակների էջը) ](https://www.pythonanywhere.com/consoles/) և անցեք ձեր ** Bash console (Բաշ կոնսոլ) ** (կամ սկսեք նորը): Հետո run (սկի).
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+Դուք պետք է փոխարինեք `<your-pythonanywhere-domain>` ձեր իրական PythonAnywhere ենթադոմեյն անունով ՝ առանց անկյունային փակագծերի ( < > ): Ձեր ենթատիրույթի անունը սովորաբար ձեր PythonAnywhere օգտագործողի անունն է, բայց որոշ դեպքերում այն ​​կարող է մի փոքր այլ լինել (օրինակ, եթե ձեր օգտագործողի անունը մեծատառեր է պարունակում): Այսպիսով, եթե այս հրամանը չի գործում, օգտագործեք ` ls ` list files(ցուցակի ֆայլեր) հրամանը ՝ գտնելու ձեր իրական ենթադոմեյնը / թղթապանակի անունը, ապա ` cd ` այնտեղ:
+
+Այժմ դիտեք ձեր կոդի ներբեռնումը: Եթե ​​ուզում եք ստուգել, ​​թե արդյոք այն տեղ է հասել, կարող եք անցնել ** "Files" («Ֆայլեր») էջը ** և ձեր կոդը դիտել PythonAnywhere- ում (վահանակի էջի ընտրացանկի կոճակից կարող եք հասնել PythonAnywhere- ի այլ էջերի):
+
+* Վերջապես, անցեք [ "Web" («Վեբ») էջ ](https://www.pythonanywhere.com/web_app_setup/) և սեղմեք ** Reload (Վերաբեռնում) ** ձեր վեբ հավելվածում:
+
+Ձեր թարմացումը պետք է ուղիղ եթերում լինի: Գնացեք և թարմացրեք ձեր կայքը զննարկչում: Փոփոխությունները պետք է տեսանելի լինեն: :)
\ No newline at end of file
diff --git a/hy-AM/install_git.md b/hy-AM/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/hy-AM/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/hy-AM/installation/README.md b/hy-AM/installation/README.md
new file mode 100644
index 00000000000..c4e2b8e54f5
--- /dev/null
+++ b/hy-AM/installation/README.md
@@ -0,0 +1,68 @@
+# Եթե ​​ձեռնարկը տանը եք անում
+
+Եթե ​​դուք աշխատում եք ձեռնարկի վրա տանը, այլ ոչ թե [Django Girls- ի միջոցառումներից մեկում](https://djangogirls.org/events/), այժմ կարող եք ամբողջությամբ բաց թողնել այս գլուխը և անցնել անմիջապես [Ինչպես է աշխատում ինտերնետը](../how_the_internet_works/README.md) գլուխ
+
+Դա պայմանավորված է նրանով, որ մենք լուսաբանում ենք բաների տեղադրումը, քանի որ դրանք անհրաժեշտ են ձեռնարկի մեջ. Սա պարզապես լրացուցիչ էջ է, որը հավաքում է տեղադրման բոլոր հրահանգները մեկ տեղում (ինչը օգտակար է որոշ սեմինարների ձևաչափերի համար): Եթե ցանկանում եք, կարող եք ընտրել այն ամենը, ինչ կա այս էջում: Բայց եթե ցանկանում եք սկսել բաներ սովորել նախքան ձեր համակարգչում մի շարք իրեր տեղադրելը, բաց թողեք այս գլուխը և մենք ձեզ հետագայում կբացատրենք տեղադրման մասերը, երբ դրանք անհրաժեշտ լինեն:
+
+Հաջողություն!
+
+# Եթե ​​սեմինարի եք մասնակցում
+
+Եթե ​​մասնակցում եք [Django Girls- ի միջոցառումներից մեկին](https://djangogirls.org/events/):
+
+* Ձեր սեմինարը կարող է ունենալ «տեղադրման երեկույթ»: Եթե ​​դուք տեղադրման երեկույթի եք, այս էջը ձեզ համար է: Հետևեք այստեղ տրված հրահանգներին ՝ ստանալու այն ամենը, ինչ անհրաժեշտ սեմինարը տեղադրելու համար, և անհրաժեշտության դեպքում դիմեք մարզիչների օգնությունը: Այնուհետև հիմնական սեմինարում կարող եք բաց թողնել տեղադրման հրահանգները. Դուք կստանաք դրանք նաև հիմնական ձեռնարկում:
+* Գուցե ձեր սեմինարի կազմակերպիչները խնդրել են ձեզ նախքան սեմինարը սկսելը, փորձել տանը ` ամեն ինչ տեղադրել ձեր համակարգչում: Եթե ​​ձեզանից խնդրեցին դա անել, այս էջը ձեզ համար է: Հնարավորինս լավ հետեւեք այստեղ տրված հրահանգներին: Այնուհետև հիմնական սեմինարում, երբ դուք ստանում եք հիմնական ձեռնարկի տեղադրման քայլերը, եթե չկարողացաք տեղադրել որոշ էլեմենտներ, ապա կարող եք օգնություն ստանալ ձեր մարզչից:
+* Եթե ​​ձեր արհեստանոցը չի կազմակերպում «տեղադրման երեկույթ» (կամ դուք ի վիճակի չէիք ներկա գտնվել), և եթե կազմակերպիչները ձեզ չեն խնդրել տեղադրել ամեն ինչ նախքան ժամանելը. բաց թողեք այս էջը և անմիջապես անցեք [How the Internet works/ Ինտերնետի աշխատանք ](../how_the_internet_works/README.md) գլուխը: Ձեռնարկի միջոցով աշխատելու ընթացքում դուք կտեղադրեք այն ամենը, ինչ ձեզ հարկավոր է:
+
+# Installation (Տեղադրում)
+
+Այս ձեռնարկում դուք բլոգ կստեղծեք: Դա անելու համար ձեռնարկի ընթացքում ձեզ հանձնարարվելու է տարբեր ծրագրեր տեղադրել ձեր համակարգչում և անհրաժեշտության դեպքում կարգավորել որոշ առցանց հաշիվներ: Այս էջը պարունակում է տեղադրման և գրանցման բոլոր հրահանգները (ինչը օգտակար է սեմինարի որոշ ձևաչափերի համար):
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %}
+
+<!--endsec-->
+
+# Հրամանի տողի/ command line հակիրճ նկարագրություն {#command-line}
+
+Ստորև նշված քայլերից շատերը վերաբերում են "console"-ին, «տերմինալին»/"terminal", «հրամանի պատուհանին»"command window" կամ «հրամանի տողին»/ "command line" . Սրանք բոլորը նույն բանն են նշանակում. Ձեր համակարգչի վրա պատուհան, որտեղ կարող եք մուտքագրել հրամաններ: Երբ հասնեք հիմնական ձեռնարկին, դուք ավելին կսովորեք հրամանի տողի մասին: Այժմ հիմնական բանը, որ դուք պետք է իմանաք, այն է, թե ինչպես բացել հրամանի պատուհան և ինչպիսի տեսք ունի այն: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Տեղադրեք Python- ը {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Տեղադրեք կոդերի խմբագիր/code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Կարգավորեք virtualenv- ը և տեղադրեք Django- ն {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Տեղադրեք Git- ը {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Ստեղծեք GitHub հաշիվ/GitHub account {#github-account}
+
+Գնացեք [GitHub.com](https://www.github.com) և գրանցվեք նոր անվճար հաշվի համար: Համոզվեք, որ կհիշեք ձեր գաղտնաբառը (եթե այն օգտագործում եք, ավելացրեք գաղտնաբառերի կառավարչին):
+
+# Ստեղծեք PythonAnywhere հաշիվ {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Սկսեք կարդալ
+
+Շնորհավորում եմ, ամեն ինչ պատրաստ է: Եթե ​​սեմինարին դեռ ազատ ժամանակ է մնացել, օգտակար կլինի կարդալ առաջին մի քանի գլուխները.
+
+* [Ինչպես է աշխատում ինտերնետը](../how_the_internet_works/README.md)
+
+* [ Command line-ի (Հրամանի տողի) ներածություն](../intro_to_command_line/README.md)
+
+* [ Python-ի ներածություն/ Introduction to Python](../python_introduction/README.md)
+
+* [Ի՞նչ է Django- ն](../django/README.md)
+
+# Վայելեք սեմինարը:
+
+Երբ սեմինարը սկսվի, դուք կկարողանաք անմիջապես անցնել [Your first Django project! /ձեր Առաջին Django նախագիծը](../django_start_project/README.md) գլխին:
\ No newline at end of file
diff --git a/hy-AM/instructions.md b/hy-AM/instructions.md
new file mode 100644
index 00000000000..b5a0981698b
--- /dev/null
+++ b/hy-AM/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period. It's easy to install and use, and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source, easy to install and easy to use. It's available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/hy-AM/intro_to_command_line/README.md b/hy-AM/intro_to_command_line/README.md
new file mode 100644
index 00000000000..54c7fafdb47
--- /dev/null
+++ b/hy-AM/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Հրամանի տողի ինտերֆեյսի /command-line interface ներածություն
+
+> Նրանց համար, ովքեր ձեռնարկն անցնում են տանը. Ձեր նոր ընկերը ՝ [հրամանի տողը/ Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8), խոսում է այս գլխի նյութի մասին:
+
+Ցնցող է, չէ՞:Մի քանի րոպեից դուք կգրեք ձեր առաջին տողի ծածկագիրը: :)
+
+**Թույլ տվեք ներկայացնել ձեր առաջին նոր ընկերոջը. Հրամանի տող/command line:**
+
+Հաջորդ քայլերը ցույց կտան, թե ինչպես օգտագործել այն սև պատուհանը, որն օգտագործում են բոլոր հակերները: Սկզբում դա կարող է թվալ մի փոքր վախեցնող, բայց իրականում դա պարզապես պատուհան է, որը սպասում է ձեզանից հրահանգների:
+
+> **Նշում** Խնդրում ենք նկատի ունենալ, որ այս ձեռնարկում մենք օգտագործում ենք «գրացուցակ/'directory'» և «թղթապանակ/'folder'» տերմինները փոխադարձաբար. Այս բառերը միևնույն բանն են նշանակում:
+
+## Ի՞նչ է հրամանի տողը/command line: 
+
+Պատուհանը, որը սովորաբար անվանում են **Հրամանի տող/ command line** կամ **«Հրամանի տողի միջերես»/command-line interface (CLI)** , տեքստի վրա հիմնված ծրագիր է ՝ ձեր համակարգչի վրա ֆայլերը դիտելու, մշակելու և շահարկելու համար: Դա անում է նույնը, ինչ Explorer- ը Windows- ում կամ Finder- ը Mac OS X- ում, բայց այն չունի գրաֆիկական ինտերֆեյս: Հրամանի տողի այլ անուններն են ՝ *cmd*, *CLI*, *prompt*, *console* կամ *terminal*:
+
+## Բացեք հրամանի տողի միջերեսը/command-line interface
+
+Որոշ փորձեր սկսելու համար նախ պետք է բացենք հրամանի տողի միջերեսը/command-line interface:
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Հուշում
+
+Այժմ դուք պետք է տեսնեք սպիտակ կամ սև պատուհան, որը սպասում է ձեր հրամաններին:
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Եթե ​​ունեք Mac կամ Linux, ամենայն հավանականությամբ տողի վերջում կտեսնեք այս `$` նշանը.
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Windows- ում, հավանաբար, տեսնում եք այս `>` նշանը. 
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Մի փոքր վերևում կարող եք աչքի անցկացնել Linux- ի օգտագործողների հրահանգները. Մենք նման բան կտեսնենք, երբ հասնենք ձեռնարկի PythonAnyplace- ին: 
+
+<!--endsec-->
+
+Յուրաքանչյուր հրամանին նախորդելու է `$` կամ `>` նշանը և տարածությունը/space: Բայց ձեզ հարկավոր չէ դրանք տպել: Համակարգիչը դա կանի ձեր փոխարեն :)
+
+> Մի փոքր հուշում. Նման մի բան կարող է գրվել հրամանի տողի կուրսորի դիմաց `C:\Users\ola>` կամ `Olas-MacBook-Air:~ ola$` և դա 100% -ով նորմալ է:
+
+Ցանկացած հատված, ներառյալ այս `$` կամ այս `>` նշանները, հավաքականորեն կոչվում է *command line prompt/հրամանի տող հուշում * կամ ուղղակի *prompt/հուշում* : Սովորաբար, այն պարունակում է այն թղթապանակի հասցեն, որի մեջ դուք այժմ գտնվում եք: Այն հուշում է ձեզ հրաման մուտքագրել պատուհանի մեջ:
+
+Հետագայում ձեռնարկում, յուրաքանչյուր հրամանից առաջ, որը դուք պետք է մուտքագրեք, մենք կգրենք `$` կամ `>` խորհրդանիշ: Երբեմն դրա ձախ կողմում կավելացնենք ևս մի քանի տեքստ: Անտեսեք ձախ կողմը և պարզապես մուտքագրեք հրահանգը. Այն սկսվում է հուշումից հետո:
+
+## Ձեր առաջին հրամանը (YAY!)
+
+Սկսենք մուտքագրել այս հրամանը.
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+Եվ ապա սեղմեք `enter`: Սա է մեր արդյունքը.
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+Ինչպես տեսնում եք, համակարգիչը նոր է տպել ձեր օգտվողի անունը: Կոկիկ է, այնպես չէ՞: :)
+
+> Փորձեք մուտքագրել յուրաքանչյուր հրաման ձեռքով, այլ ոչ թե պատճենել և տեղադրել: Այսպիսով, դուք ավելի լավ կհիշեք:
+
+## Հիմունքներ
+
+Յուրաքանչյուր գործավար համակարգ ունի հրամանի տողի մի փոքր այլ հրամանների հավաքածու, այնպես որ համոզվեք, որ հետևում եք ձեր օպերացիոն համակարգի հրահանգներին: Փորձե՞նք սա:
+
+### Ընթացիկ գրացուցակ/Current directory
+
+Ցանկալի կլիներ իմանալ, թե որտեղ ենք մենք գտնվում, այնպես չէ՞: Եկեք տեսնենք: Մուտքագրեք այս հրամանը և սեղմեք `enter`.
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Նշում. «Pwd» նշանակում է «տպել աշխատանքային գրացուցակ»/'print working directory:
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Նշում. «Cd» նշանակում է «փոփոխել գրացուցակը»/'change directory': PowerShell- ի միջոցով դուք կարող եք օգտագործել pwd այնպես, ինչպես Linux- ում կամ Mac OS X- ում:
+
+<!--endsec-->
+
+Նման բան, հավանաբար, ձեր համակարգչում կտեսնեք: Հրամանի տող/command line բացելիս սովորաբար գտնվում եք ընթացիկ օգտվողի տնային գրացուցակում/user's home directory:
+
+* * *
+
+### Իմացիր ավելին հրամանի/command մասին
+
+Հրամանի տողի շատ հրամաններ ներկառուցված օգնություն ունեն: Օրինակ ՝ ահա, թե ինչպես կարելի է ավելին իմանալ հրամանի մասին, որը ցույց է տալիս, թե որ թղթապանակում եք գտնվում ներկայումս.
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X- ը և Linux- ը ունեն `man` հրաման, որը ձեզ օգնում է հրամանների հարցում: Փորձեք `man pwd` -ը և տեսեք, թե ինչ է ասում, կամ `man` հրամանը այլ հրամանների առաջ դրեք, որպեսզի տեսնեք նրանց օգնությունը: Սովորաբար, `man`-ի էջերը ցուցադրվում են էջ առ էջ: Օգտագործեք space bar հաջորդ էջին անցնելու համար, և ` q ` - ը `օգնությունից դուրս գալու համար:
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Օգնություն ցուցադրելու համար գրեթե ցանկացած հրամանին կարող եք ավելացնել ` /? `: Գուցե հարկ լինի ոլորել ներքև ՝ ամբողջ Օգնությունը կարդալու համար: Փորձեք մուտքագրել `cd /?`:
+
+<!--endsec-->
+
+### Նշեք ֆայլերը և գրացուցակները/directories
+
+Այսպիսով ի՞նչ կա դրա մեջ: Լավ կլինի պարզել դա: Տեսնենք.
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Նշում. PowerShell- ում կարող եք նաև օգտագործել «ls» - ը, ինչպես Linux- ում և Mac OS X- ում:<!--endsec-->
+
+* * *
+
+### Փոխել ընթացիկ գրացուցակը/current directory
+
+Հիմա եկեք գնանք մեր աշխատասեղանի գրացուցակին/Desktop directory.
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Նկատի ունեցեք, որ գրացուցակի անունը «Desktop» կարող է թարգմանվել ձեր Linux հաշվի լեզվով: Եթե ​​դա այդպես է, դուք պետք է `Desktop` փոխարինեք թարգմանված անունով. օրինակ ՝ `Schreibtisch` գերմաներենի համար:
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Ստուգեք, արդյոք այն իսկապես փոխվել է.
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Ահա այն!
+
+> PRO հուշում. Եթե ձեր ստեղնաշարի վրա մուտքագրեք ` cd D ` և այնուհետև սեղմեք ` tab (էջանիշը/ներդիրը) `, command line (հրամանի տողը) ավտոմատ կերպով լրացնում է անվան մնացած մասը, որպեսզի կարողանաք ավելի արագ նավարկել Եթե ​​«D» - ով սկսվող մեկից ավելի պանակներ կան, երկու անգամ սեղմեք ` tab (ներդիրը )` ստեղնին `ընտրանքների ցուցակ ստանալու համար:
+
+* * *
+
+### Ստեղծեք գրացուցակ
+
+Ի՞նչ կասեք ձեր աշխատասեղանի վրա պրակտիկ գրացուցակ ստեղծելու մասին: Դուք կարող եք դա անել այս կերպ.
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+Այս փոքրիկ հրահանգը կստեղծի ձեր աշխատասեղանի վրա `practice` անունով պանակ: Կարող եք ստուգել, ​​արդյոք այնտեղ կա ՝ նայելով ձեր աշխատասեղանին կամ գործարկելով `ls` կամ `dir` հրամանը: Փորձիր. :)
+
+> PRO հուշում. Եթե չեք ցանկանում անընդմեջ մուտքագրել նույն հրամանները, փորձեք սեղմել `վերին սլաքը/up arrow` և `ներքևի սլաքը/ down arrow` ձեր ստեղնաշարի վրա, որպեսզի շրջանցեք վերջերս օգտագործված հրամանները:
+
+* * *
+
+### Վարժություն
+
+Մի փոքր առաջադրանք. Նորաստեղծ `practice/պրակտիկայի` թղթապանակում ստեղծեք պանակ, որը կոչվում է `test`: (Օգտագործեք `cd` և `mkdir` հրահանգները):
+
+#### Լուծում.
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Շնորհավորում ենք։
+
+* * *
+
+### Մաքրել
+
+Մենք չենք ուզում խառնաշփոթ թողնել, ուստի եկեք ջնջենք այն ամենը, ինչ ստեղծել ենք մինչև այս պահը:
+
+Նախ, մենք պետք է վերադառնանք Desktop / աշխատասեղան.
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Օգտագործելով ` .. `-ի և ` cd ` - ի հրամանները միասին դուք կարող եք փոխել ընթացիկ գրացուցակը/current directory ծնող գրացուցակի/parent directory (այսինքն ՝ գրացուցակը, որը պարունակում է ձեր ընթացիկ գրացուցակը)
+
+Ստուգեք, թե որտեղ եք դուք ՝
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Հիմա ժամանակն է ջնջել `practice` գրացուցակը.
+
+> ** Ուշադրություն **. `del`, `rmdir` կամ `rm`ֆայլերը ջնջելը անվերադարձ է, այսինքն ՝ *ջնջված ֆայլերը կվերանան ընդմիշտ*!: Այսպիսով, շատ զգույշ եղեք այս հրամանի հետ:
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Կատարած է! Համոզված լինելու համար, որ այն իրականում ջնջված է, եկեք ստուգենք այն.
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Ելք
+
+Առայժմ վերջ: Այժմ կարող եք ապահով կերպով փակել հրամանի տողը: Եկեք դա անենք հակերային եղանակով, լա՞վ: :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Հերիք է, հա՞: :)
+
+## Ամփոփում
+
+Ահա մի քանի օգտակար հրամանների ամփոփ նկարագրություն.
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+Սրանք ընդամենը հրամաններից մի քանիսն են, որոնք կարող եք գործարկել ձեր հրամանի տողում/command line, բայց այսօր դրանից ավելին չեք օգտագործելու:
+
+Եթե ​​ձեզ հետաքրքրում է, [ss64.com](http://ss64.com) - ը պարունակում է հրամանի ամբողջական հղում բոլոր օպերացիոն համակարգերի համար:
+
+## Պատրա՞ստ եք
+
+Եկեք խորասուզվենք Python- ի մեջ:
\ No newline at end of file
diff --git a/hy-AM/intro_to_command_line/open_instructions.md b/hy-AM/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..88fad5f0bda
--- /dev/null
+++ b/hy-AM/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Կախված Windows- ի ձեր տարբերակից և ստեղնաշարից, հետևյալներից որևէ մեկը պետք է հրամանի պատուհան բացի (գուցե մի քիչ փորձեր կատարեք, բայց բոլոր տարբերակները փորձելու կարիք չկա).
+
+- Գնացեք Սկսել /Start բաժին ընտրացանկից (կամ Start էկրանից), և որոնման տողում մուտքագրեք «Command Prompt»:
+- Անցեք Սկսելու ցանկը/Start menu→Windows System → Command Prompt/ հրամանի տող:
+- Անցեք Start menu /Սկսելու ցանկը → All Programs / Բոլոր ծրագրերը → Accessories/Աքսեսուարներ → Command Prompt /Հրամանի տող:
+- Անցեք Start screen, ձեր մկնիկը տարեք էկրանի ստորին ձախ անկյունի վրա և կտտացրեք այնտեղ հայտնվող դեպի ներքև ուղված սլաքին: (Եթե ունեք սենսորային էկրան, մատը սահեցրեք ներքևից վերև): Հավելվածների էջը պետք է բացվի: Windows համակարգի բաժնում/Windows System section ընտրեք Command Prompt-ը/ հրամանի տողը:
+- Ձեր ստեղնաշարի վրա սեղմած պահելով Windows ստեղնը սեղմեք X: Հայտնվող ընտրացանկում ընտրեք «Command Prompt/Հրամանի տող»-ը: 
+- Ձեր ստեղնաշարի վրա սեղմած պահելով Windows ստեղնը սեղմեք "R" ՝ Run պատուհանը վեր հանելու համար: Տողում մուտքագրեք "cmd" և կտտացրեք OK:
+
+![Մուտքագրեք  "cmd"  "Run"  պատուհանում](../python_installation/images/windows-plus-r.png)
+
+Ավելի ուշ այս ձեռնարկի շրջանակներոըմ ձեզ հարկավոր է լինելու ունենալ միևնույն ժամանակ երկու բաց հրամանի պատուհան: Այնուամենայնիվ, Windows- ի որոշ տարբերակների դեպքում, եթե դուք արդեն ունեք մեկ բաց հրամանի պատուհան/command window և փորձում եք բացել երկրորդը նույն մեթոդով, այն ձեզ կուղարկի դեպի արդեն բացված հրամանի պատուհանը: Փորձեք դա ձեր համակարգչի վրա և տեսեք, թե ինչ է կատարվում: Եթե ​​միայն մեկ հրամանի պատուհան եք ստանում, փորձեք վերը նշված ցուցակի մյուս մեթոդներից որևէ մեկը: Դրանցից գոնե մեկը պետք է հանգեցնի նոր հրամանի պատուհանի բացմանը:
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Գնացեք Applications → Utilities/Կոմունալ ծառայություններ → Terminal /Տերմինալ: 
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Հրամանի տողը, հավանաբար, թաքնված է հետևյալում ՝ Applications → Accessories → Terminal, or Applications → System → Terminal, բայց դա կարող է կախված լինել ձեր համակարգից: Եթե ​​չկարողանաք գտնել, Google- ը կօգնի: :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/hy-AM/python_installation/README.md b/hy-AM/python_installation/README.md
new file mode 100644
index 00000000000..34cd91728f5
--- /dev/null
+++ b/hy-AM/python_installation/README.md
@@ -0,0 +1,15 @@
+# Եկեք սկսենք Python- ից
+
+Վերջապես մենք այստեղ ենք:
+
+Բայց նախ ասենք, թե ինչ է Python- ը: Python- ը շատ սիրված ծրագրավորման լեզու է, որը կարող է օգտագործվել կայքեր, խաղեր, գիտական ​​ծրագրեր, գրաֆիկա և շատ ավելին ստեղծելու համար:
+
+Python- ն առաջացել է 1980-ականների վերջին, և դրա հիմնական նպատակն է ընթեռնելի լինել մարդկանց կողմից (ոչ միայն մեքենաների): Ահա թե ինչու այն ավելի պարզ թվում, քան ծրագրավորման այլ լեզուները, բայց մի անհանգստացեք. Python-ը իսկապես հզոր է:
+
+# Python- ի տեղադրում
+
+> **Նշում** Եթե Chromebook եք օգտագործում, բաց թողեք այս գլուխը և համոզվեք, որ հետևում եք [Chromebook Setup/Chromebook- ի կարգավորման](../chromebook_setup/README.md) հրահանգներին:
+> 
+> **Նշում** Եթե դուք արդեն ավարտել եք տեղադրումը, ապա այլևս դա անելու կարիք չկա. Դուք կարող եք անմիջապես անցնել հաջորդ գլխին:
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/hy-AM/python_installation/instructions.md b/hy-AM/python_installation/instructions.md
new file mode 100644
index 00000000000..add866237f6
--- /dev/null
+++ b/hy-AM/python_installation/instructions.md
@@ -0,0 +1,118 @@
+> Ընթերցողների համար տանը. Այս գլուխն ընդգրկված է [ Installing Python & Code Editor ](https://www.youtube.com/watch?v=pVTaqzKZCdA) տեսանյութ:
+> 
+> Այս բաժինը հիմնված է Geek Girls Carrots- ի ձեռնարկի վրա (https://github.com/ggcarrots/django-carrots)
+
+Django- ն գրված է Python- ում: Մեզ պետք է Python- ը, որպեսզի Django- ում ինչ-որ բան անի: Եկեք սկսենք տեղադրելով այն: Մենք ուզում ենք, որ դուք տեղադրեք Python 3-ի վերջին տարբերակը, այնպես որ, եթե ունեք ավելի վաղ տարբերակ, ապա ձեզ հարկավոր է արդիականացնել այն: Եթե ​​արդեն ունեք {{ book.py_min_version }} կամ ավելի բարձր տարբերակ, ապա լավ կլինի:
+
+Խնդրում ենք տեղադրել սովորական Python– ը հետևյալ կերպ, նույնիսկ այն ժամանակ, երբ ձեր համակարգչում տեղադրված է Anaconda:
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Նախ ստուգեք, արդյոք ձեր համակարգիչը 32-բիթանոց տարբերակ է կամ 64-բիթանոց Windows տարբերակ, Համակարգի տեղեկատվության էջի «Համակարգի տեսակ» տողում: Այս էջին հասնելու համար փորձեք այս մեթոդներից մեկը.
+
+* Միաժամանակ սեղմեք Windows կոճակը և Pause / Break կոճակը
+* Բացեք ձեր կառավարման վահանակը Windows ընտրացանկից, ապա անցեք Համակարգ և & amp; Անվտանգություն, ապա ՝ Համակարգ
+* Սեղմեք Windows կոճակը, ապա անցեք Settings > System > About (Կարգավորումներ> Համակարգ> Մեր մասին)
+* Որոնեք Windows Start ընտրացանկում "System Information" («Համակարգի տեղեկատվություն») բաժնում: Դա անելու համար կտտացրեք Start կոճակին կամ սեղմեք Windows ստեղնը, ապա սկսեք մուտքագրել ` System Information `: Այն մուտքագրելուն պես կսկսի առաջարկություններ անել: Դուք կարող եք ընտրել առաջարկը, երբ այն հայտնվի:
+
+Python- ը Windows- ի համար կարող եք ներբեռնել https://www.python.org/downloads/windows/ կայքից: Կտտացրեք «Վերջին Python 3 թողարկում - Python x.x.x» հղմանը: Եթե ​​ձեր համակարգիչը աշխատում է Windows- ի ** 64-բիթանոց ** տարբերակով, ներբեռնեք ** Windows x86-64 գործարկվող տեղադրիչը **: Հակառակ դեպքում ներբեռնեք ** Windows x86 գործարկվող տեղադրիչը **: Տեղադրիչը ներբեռնելուց հետո դուք պետք է այն գործարկեք (կրկնակի սեղմեք դրա վրա) և հետևեք այնտեղ տրված հրահանգներին:
+
+Մի բան, որին պետք է զգույշ լինել. Տեղադրման ընթացքում դուք կնկատեք "Setup"(«Կարգավորում») նշվող պատուհանը: Համոզվեք, որ նշեք «Ավելացնել Python {{book.py_version}} - ը PATH» - ին կամ «Python ավելացնել ձեր միջավայրի փոփոխականներին» վանդակը և կտտացրեք «Տեղադրել հիմա» -ին, ինչպես ցույց է տրված այստեղ (կարող է մի փոքր այլ տեսք ունենալ, եթե տեղադրեք այլ տարբերակ):
+
+![
+Մի մոռացեք Python- ին ավելացնել Path- ին](../python_installation/images/python-installation-options.png)
+
+Տեղադրումն ավարտելուց հետո դուք կարող եք տեսնել երկխոսության տուփ հղումով, որին կարող եք հետևել Python- ի կամ ձեր տեղադրած տարբերակի մասին ավելին իմանալու համար: Փակեք կամ չեղարկեք այդ երկխոսությունը. Այս ձեռնարկում դուք ավելին կսովորեք:
+
+Նշում. Եթե օգտագործում եք Windows- ի (7, Vista կամ որևէ հին տարբերակ) ավելի հին տարբերակ, և Python- ի {{ book.py_version }} տեղադրիչը սխալմամբ ձախողվեց, ապա տեղադրեք բոլոր Windows Updates- ը և փորձեք նորից տեղադրել Python- ը: Եթե ​​դեռ սխալ ունեք, փորձեք տեղադրել Python տարբերակը {{ book.py_min_release }} [ Python.org ](https://www.python.org/downloads/windows/) կայքից:
+
+> Django- ին {{ book.django_version }} անհրաժեշտ է Python {{ book.django_version }} կամ ավելի մեծ, որը չի ապահովում Windows XP կամ ավելի վաղ տարբերակներ:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> ** Նշում ** Նախքան Python- ը OS X- ում տեղադրելը, պետք է համոզվեք, որ ձեր Mac- ի կարգավորումները թույլ են տալիս տեղադրել փաթեթներ, որոնք App Store- ից չեն: Գնացեք համակարգի նախապատվություններ, կտտացրեք "Security & Privacy," , ապա "General" («Ընդհանուր»)ներդիրին: Եթե ​​ձեր «Allow apps downloaded from:» դրված է որպես «Mac App Store,», ապա այն փոխեք «Mac App Store and identified developers.»:
+
+Դուք պետք է գնաք https://www.python.org/downloads/mac-osx/ կայք և ներբեռնեք Python- ի վերջին տեղադրիչը.
+
+* Ներբեռնեք * Mac OS X 64-բիթ / 32-բիթանոց տեղադրիչ * ֆայլը,
+* Տեղադրիչը գործարկելու համար կրկնակի կտտացրեք * պիթոն - {{ book.py_release }} - macosx10.9.pkg *:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Շատ հավանական է, որ Python- ն արդեն տեղադրված է տուփից դուրս: Ստուգելու համար, արդյոք այն տեղադրված է (և որ տարբերակն է), բացեք վահանակ և մուտքագրեք հետևյալ հրահանգը.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+Եթե ​​Python- ի այլ տարբերակ ունեք տեղադրված, առնվազն {{ book.py_min_version }} (օրինակ ՝ {{ book.py_min_release }}), ապա ձեզ հարկավոր չէ արդիականացնել: Եթե ​​Python- ը տեղադրված չէ, կամ եթե այլ տարբերակ եք ուզում, նախ ստուգեք, թե Linux- ի ո՞ր բաշխումն եք օգտագործում հետևյալ հրահանգով.
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Դրանից հետո, կախված արդյունքից, հետևեք այս բաժնի ներքևում տեղադրված հետևյալ ուղեցույցներից մեկին:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Մուտքագրեք այս հրամանը ձեր վահանակի մեջ.
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Օգտագործեք այս հրամանը ձեր վահանակում.
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+Եթե ​​Fedora- ի հին տարբերակներում եք, կարող է սխալվել, որ ` dnf ` հրամանը չի գտնվել: Այդ դեպքում փոխարենը պետք է օգտագործել ` yum `:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Օգտագործեք այս հրամանը ձեր վահանակում.
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Հաստատեք, որ տեղադրումը հաջող է անցել ՝ հրամանի տող բացելով և գործարկելով ` python3 ` հրամանը.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+Shownուցադրված տարբերակը կարող է տարբերվել {{ book.py_release }} - ից `այն պետք է համապատասխանի ձեր տեղադրած տարբերակին:
+
+**NOTE:** Եթե ​​Windows- ում եք և սխալ հաղորդագրություն եք ստանում, որ ` python3 ` չի գտնվել, փորձեք օգտագործել ` python ` (առանց ` 3 `) և ստուգեք եթե այն դեռ կարող է լինել Python- ի {{ book.py_min_version }} կամ ավելի բարձր տարբերակ: Եթե ​​դա նույնպես չի աշխատում, կարող եք բացել նոր հրամանի տող և նորից փորձել: դա տեղի է ունենում, եթե օգտագործում եք Python- ի տեղադրումից առաջ բացված հրամանի տողը:
+
+* * *
+
+Եթե ​​կասկածներ ունեք կամ ինչ-որ բան սխալ է տեղի ունեցել, և գաղափար չունեք հետագա անելիքների մասին, խնդրում ենք ձեր մարզչին հարցրեք: Երբեմն ամեն ինչ հարթ չի ընթանում, և ավելի լավ է օգնություն խնդրել ավելի մեծ փորձ ունեցող մեկից:
\ No newline at end of file
diff --git a/hy-AM/python_introduction/README.md b/hy-AM/python_introduction/README.md
new file mode 100644
index 00000000000..5cd24e527f3
--- /dev/null
+++ b/hy-AM/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Ներածություն Python- ին
+
+> Այս գլխի մի մասը հիմնված է Geek Girls Carrots- ի (https://github.com/ggcarrots/django-carrots) ձեռնարկների վրա:
+
+Եկեք գրենք մի քանի ծրագրեր:
+
+## Python prompt (կահակալ)
+
+> Ընթերցողների համար տանը. Այս մասը ներառված է [ Python Basics: Integers, Strings, Lists, Variables and Errors (Python- ի հիմունքներ. Ամբողջ թվեր, տողեր, ցուցակներ, փոփոխականներ և սխալներ) ](https://www.youtube.com/watch?v=MO63L4s-20U) տեսանյութում:
+
+Python- ի հետ խաղալու համար մենք պետք է ձեր համակարգչում բացենք * command line (հրամանի տող)*: Դուք արդեն պետք է իմանաք, թե ինչպես դա անել. Դուք դա սովորել եք [ Intro to Command Line (Հրամանի տողի ներածություն) ](../intro_to_command_line/README.md) գլխում:
+
+Պատրաստ լինելուց հետո հետևեք ստորև ներկայացված հրահանգներին:
+
+Մենք ուզում ենք Python կոնսոլ բացել, այնպես որ Windows- ում մուտքագրեք ` python ` կամ Mac OS / Linux համակարգում ` python3 ` և սեղմեք ` enter `:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Ձեր առաջին Python command-ը (հրամանը):
+
+Python հրամանը գործարկելուց հետո հուշումը փոխվեց `>>>`. Մեզ համար սա նշանակում է, որ առայժմ մենք կարող ենք օգտագործել միայն Python լեզվով հրամաններ: Պետք չէ մուտքագրել `>>>` - Python- ը դա կանի ձեզ համար:
+
+Եթե ​​ցանկանում եք ցանկացած պահի դուրս գալ Python- ի վահանակից, մուտքագրեք ` ելք () ` կամ օգտագործեք դյուրանցում ` Ctrl + Z ` Windows- ի և ` Ctrl + D ` Mac / Linux- ի համար: Այդ դեպքում `>>>`այլևս չեք տեսնի:
+
+Առայժմ մենք չենք ցանկանում դուրս գալ Python կոնսոլից: Մենք ուզում ենք ավելին իմանալ դրա մասին: Եկեք սկսենք մուտքագրել մի քանի մաթեմատիկա, ինչպիսին է ` 2 + 3 ` և սեղմելով ` մուտքագրումը `:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Հոյակապ. Տեսեք, թե ինչպես հայտնվեց պատասխանը: Python- ը գիտի մաթեմատիկա: Կարող եք փորձել այլ հրամաններ, ինչպիսիք են ՝
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Էքսպոնենտալ հաշվարկ կատարելու համար ասենք 2 հզորության 3-ը ՝ մենք մուտքագրում ենք. {% filename %}command-line (հրամանի տող){% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Մի փոքր զվարճացեք դրանով, ապա վերադառնաք այստեղ :)
+
+Ինչպես տեսնում եք, Python- ը հիանալի հաշվիչ է: Եթե ​​մտածում եք, թե էլ ինչ կարող եք անել ...
+
+## Strings (տողեր)
+
+Ինչ վերաբերում է ձեր անունին: Մուտքագրեք ձեր անունը այսպիսի մեջբերումներում. 
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+Դուք այժմ ստեղծել եք ձեր առաջին string-ը (տողը): Դա նիշերի հաջորդականություն է, որը կարող է մշակվել համակարգչի կողմից: String-ը միշտ պետք է սկսվի և ավարտվի նույն նիշով: Սա կարող է լինել միայնակ (` '`) կամ կրկնակի (` "`) մեջբերումներ (տարբերություն չկա:) Գնանշումները Python- ին ասում են, որ իրենց մեջ եղածը string է:
+
+String-երը կարելի է միասին դնել: Փորձեք այս:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+Դուք կարող եք նաև բազմապատկել տողերը մի թվով.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Եթե ​​ձեզ հարկավոր է ապոստերֆ դնել ձեր string-ի ներսում, ապա դա անելու երկու եղանակ ունեք:
+
+Օգտագործելով կրկնակի գնանշումներ.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+կամ հետադարձ աղեղից խուսափելուց (`\`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Հետաքրքիր է, ոչ: Ձեր անունը մեծատառով տեսնելու համար մուտքագրեք ՝
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Դուք հենց ձեր string-ի (տողի) վրա օգտագործեցիք ` upper(վերին) ` ** method(մեթոդը)**: Մեթոդը (ինչպիսին է ` upper() (վերին ()) `) հրահանգների հաջորդականությունն է, որը Python- ը պետք է կատարի տվյալ օբյեկտի վրա (` «Օլա» `), երբ այն զանգահարեք:
+
+Եթե ​​ուզում եք իմանալ ձեր անվան մեջ պարունակվող տառերի քանակը, դրա համար կա **function ( գործառույթ) **:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Հետաքրքիր է, թե ինչու եք երբեմն function-ներ (ֆունկցիաներ) կանչում a `.` String-ի (տողի) վերջում (ինչպես ` "Ola".upper()  `) և երբեմն նախ կանչում ես ֆունկցիա և string-ը դնում փակագծերում: Դե, որոշ դեպքերում function-ները (ֆունկցիաները) պատկանում են object-ների (օբյեկտների), ինչպես, օրինակ, ` վերին () `, որը կարող է կատարվել միայն տողերի վրա: Այս դեպքում մենք function (ֆունկցիան) անվանում ենք ** method (մեթոդ) **: Այլ ֆունկցիաներ, գործառույթները չեն պատկանում որևէ կոնկրետ բանի և կարող են օգտագործվել տարբեր տեսակի օբյեկտների վրա, ինչպես ` len () `: Այդ պատճառով մենք`"Ola"` որպես պարամետր ենք տալիս `len` գֆունկցիաին:
+
+### Ամփոփում
+
+Լավ, բավական է string-եր: Մինչ այժմ իմացել եք.
+
+- ** prompt-ը** - Python- ի մեջ հրահանգներ (code / կոդ) մուտքագրելը Python- ում տալիս է պատասխաններ
+- **numbers and strings (թվերն ու տողերը) ** - Python- ի համարներում օգտագործվում են մաթեմատիկայի համար, իսկ string-երը `տեքստային object- ների (օբյեկտների) համար
+- ** operators (օպերատորները) ** - ինչպիսիք են ` + ` և ` * `, միավորում են արժեքները ՝ նորը արտադրելու համար
+- ** function-ներ ** - ինչպես ` upper() ` և ` len() `, գործողություններ կատարել օբյեկտների վրա:
+
+Սրանք յուրաքանչյուր սովորած ծրագրավորման լեզվի հիմունքներն են: Պատրա՞ստ եք ավելի դժվար բանի:
+
+## Errors (Սխալներ)
+
+Փորձենք մի նոր բան: Կարո՞ղ ենք համարի երկարությունը ստանալ նույն կերպ, ինչպես կարող էինք պարզել մեր անվան երկարությունը: Մուտքագրեք ` len(304023) ` և սեղմեք ` enter `:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Մենք ստացանք մեր առաջին սխալը: {{ warning_icon }} icon-ը (պատկերակը) ձեզ նախապատվություն տալու այն ձևն է, որ այն կոդը, որը պատրաստվում եք գործարկել, չի աշխատի ինչպես սպասվում էր: Սխալներ թույլ տալը (նույնիսկ դիտավորյալները) ուսման կարևոր մասն է:
+
+Այն ասում է, որ «int» տեսակի object-ները (օբյեկտները) (integers/ ամբողջ թվեր) երկարություն չունեն: Այսպիսով, ի՞նչ կարող ենք անել հիմա: Միգուցե կարո՞ղ ենք մեր թիվը գրել որպես string: String-երն ունեն length (երկարություն), չէ՞:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Դա աշխատեց! Մենք ` str ` գործառույթի ներսում օգտագործեցինք ` str() ` function-ը: ` str() ` ամեն ինչ վերածում է string-երի:
+
+- ` str ` function (ֆունկցիան) իրերը վերափոխում է ** string-երի **
+- ` int ` function (ֆունկցիան) իրերը վերափոխում է ** integers **
+
+> Կարևոր. Մենք կարող ենք թվերը վերածել տեքստի, բայց պարտադիր չէ, որ տեքստը վերածենք թվերի. Ի՞նչ կլինի ամեն դեպքում `int('hello') `:
+
+## Variables (Փոփոխականներ)
+
+Mingրագրավորման կարևոր հայեցակարգը variable- ներն (փոփոխականներն) են: Varaible-ը (Փոփոխականը) ոչ այլ ինչ է, քան ինչ-որ բանի անուն, այնպես որ այն հետագայում կարող եք օգտագործել: ծրագրավորողներ օգտագործում են այս փոփոխականները տվյալներ պահելու, իրենց կոդերն ավելի ընթեռնելի դարձնելու համար և ստիպված չեն անընդհատ հիշել, թե ինչ բաներ են:
+
+Ասենք, որ ուզում ենք ստեղծել նոր variable (փոփոխական), որը կոչվում է ` name (անուն) `:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+Մենք մուտքագրում ենք name-ը (անունը) հավասար է Ola:
+
+Ինչպես նկատել եք, ձեր ծրագիրը չի վերադարձրել այլ բան, ինչպես նախկինում էր: Այսպիսով, ինչպե՞ս իմանանք, որ variable-ն (փոփոխականն) իրականում գոյություն ունի: Մուտքագրեք ` name (անունը) ` և սեղմեք ` enter (մուտքագրեք) `
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Ձեր առաջին variable-ը փոփոխականը! :) Դուք միշտ կարող եք փոխել այն, ինչին վերաբերում է.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+Այն կարող եք օգտագործել նաև function-ներում.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Հիանալի է, չէ՞: Այժմ variable-ները (փոփոխականները )կարող են լինել ցանկացած ՝ թվեր նույնպես: Փորձեք այս:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Բայց ի՞նչ կլինի, եթե մենք սխալ անուն օգտագործենք: Կարո՞ղ եք գուշակել, թե ինչ կլինի: Արի փորձենք!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Սխալ! Ինչպես տեսնում եք, Python- ն ունի տարբեր տեսակի սխալներ, և այս մեկը կոչվում է ** NameError **: Python- ը ձեզ կտա այս սխալը, եթե փորձեք օգտագործել դեռ չսահմանված variable (փոփոխական): Եթե ​​ավելի ուշ այս սխալի եք բախվել, ստուգեք ձեր կոդը ՝ ստուգելու համար, արդյոք սխալ եք մուտքագրել որևէ անուն:
+
+Մի փոքր խաղացեք սրա հետ և տեսեք, թե ինչ կարող եք անել:
+
+## Print function (Տպման գործառույթը)
+
+Փորձեք այս:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Երբ դուք պարզապես մուտքագրում եք ` name (անուն)`, Python- ի թարգմանիչը պատասխանում է 'name' variable (փոփոխական) string-ի (տող) * ներկայացմամբ* , որը M-a-r-i-a տառերն են, որոնք շրջապատված են մեկ չակերտով, ": Երբ ասում եք ` տպել (անունը) `, Python- ը "print"-կանի («կտպագրի») variable-ի պարունակությունը էկրանին ՝ առանց չակերտների, որը ավելի կոկիկ է:
+
+Ինչպես կտեսնենք ավելի ուշ, ` print () ` - ը օգտակար է նաև այն ժամանակ, երբ մենք ուզում ենք գործերը ներսից function-ներ տպել, կամ երբ ուզում ենք իրեր տպել բազմաթիվ տողերի վրա:
+
+## Lists (ցուցակները)
+
+String-երի և integer-ի (թվերի) հետ մեկտեղ Python- ն ունի ամենատարբեր տեսակի object-ներ (օբյեկտներ): Այժմ մենք պատրաստվում ենք ներկայացնել մեկը, որը կոչվում է ** list (ցուցակ) **: Ծուցակները հենց այն են, ինչ դուք կարծում եք. օբյեկտներ, որոնք այլ օբյեկտների ցուցակներ են: :)
+
+Գնացեք և ստեղծեք ցուցակ.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Այո, այս ցուցակը դատարկ է: Շատ օգտակար չէ, չէ՞: Եկեք ստեղծենք վիճակախաղի համարների ցուցակ: Մենք չենք ուզում անընդհատ կրկնվել, այնպես որ այն նաև կդնենք փոփոխականի մեջ.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+Լավ, մենք ցուցակ ունենք: Ի՞նչ կարող ենք անել դրա հետ: Տեսնենք, թե վիճակախաղի քանի համար կա ցուցակում: Դուք գաղափար ունե՞ք, թե որ function (ֆունկցիան) պետք է օգտագործեք դրա համար: Դուք դա արդեն գիտեք:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Այո՛ ` len()` - ը կարող է ձեզ ցուցակում մի շարք օբյեկտներ տալ: Հարմար է, չէ՞: Միգուցե հիմա տեսակավորենք.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Սա ոչինչ չի վերադարձնում, պարզապես փոխեց ցուցակի թվերը հայտնվելու հերթականությունը: Եկեք նորից տպենք և տեսնենք, թե ինչ է տեղի ունեցել:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Ինչպես տեսնում եք, ձեր ցուցակի թվերն այժմ տեսակավորված են ամենացածրից բարձրագույն արժեքից: Շնորհավորանքներ
+
+Միգուցե մենք ուզում ենք հետ շրջե՞լ այդ կարգը: Արի անենք դա!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+Եթե ցանկանում եք ինչ-որ բան ավելացնել ձեր ցուցակին, կարող եք դա անել ՝ մուտքագրելով այս հրահանգը.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Եթե ցանկանում եք ցույց տալ միայն առաջին համարը, ապա կարող եք դա անել ՝ օգտագործելով ** index (ինդեքսներ) **: Ինդեկսը այն թիվն է, որն ասում է, թե որտեղ է ցուցակում ինչ-որ իր տեղի ունենում: Ծրագրավորողները նախընտրում են սկսել հաշվել 0-ից, այնպես որ ձեր ցուցակում առաջին օբյեկտը 0 ինդեքսում է, հաջորդը 1-ի վրա և այլն: Փորձեք այս:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Ինչպես տեսնում եք, ձեր ցուցակում կարող եք մուտք գործել տարբեր օբյեկտներ ՝ օգտագործելով ցուցակի անվանումը և քառակուսի փակագծերի ներսում գտնվող օբյեկտի ցուցիչը:
+
+Ձեր ցուցակից ինչ-որ բան ջնջելու համար հարկավոր է օգտագործել ** indexes (ինդեքսները) **, ինչպես սովորեցինք վերևում և ` pop() (փոփ()) ` մեթոդը: Եկեք փորձենք մի օրինակ և ամրապնդենք նախկինում սովորածը. մենք կջնջենք մեր ցուցակի առաջին համարը:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Դա հիանալի աշխատեց:
+
+Լրացուցիչ զվարճանքի համար փորձեք մի քանի այլ ցուցանիշներ. 6, 7, 1000, -1, -6 կամ -1000: Տեսեք, արդյոք կարող եք կանխատեսել արդյունքը ՝ նախքան հրամանը փորձելը: Արդյո՞ք արդյունքները իմաստ ունեն:
+
+Python- ի փաստաթղթավորման այս գլխում կարող եք գտնել ցուցակի բոլոր մատչելի մեթոդների ցուցակը. https://docs.python.org/3/tutorial/datastructures.html
+
+## Բառարաններ
+
+> Ընթերցողների համար տանը. Այս մասն ընդգրկված է [ Python Basics: Dictionaries (Python- ի հիմունքները: բառարաններ) ](https://www.youtube.com/watch?v=ZX1CVvZLE6c) տեսանյութում:
+
+Բառարանը նման է ցուցակին, բայց արժեքներին մուտք եք գործում թվային ցուցիչի փոխարեն ստեղ փնտրելով: Բանալին կարող է լինել ցանկացած string(տո) կամ համար: Դատարկ բառարան սահմանելու համար շարահյուսությունն է.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Սա ցույց է տալիս, որ դուք պարզապես ստեղծել եք դատարկ բառարան: Ուռա!
+
+Այժմ փորձեք գրել հետևյալ հրահանգը (փորձեք փոխարինել նաև ձեր սեփական տեղեկությունները).
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+Այս հրամանի միջոցով դուք պարզապես ստեղծեցիք ` participant (մասնակից) ` անունով փոփոխական `երեք առանցքային արժեքի զույգերով.
+
+- `name(անուն) ` ստեղնը մատնանշում է ` 'Ola' ` արժեքը (` string` օբյեկտ),
+- ` country (երկիրը) ` մատնանշում է `'Poland' «Լեհաստան» ` (մեկ այլ ` string `)
+- և ` favorite_numbers (սիրված_համարները) ` ցույց են տալիս ` [7, 42, 92] ` (` list (ցուցակ) `, որի մեջ կա երեք համար):
+
+Անհատական ստեղների բովանդակությունը կարող եք ստուգել այս syntax (շարահյուսությամբ).
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Տեսեք, դա նման է ցուցակին: Բայց հարկավոր չէ հիշել ինդեքսը, պարզապես անունը:
+
+Ի՞նչ է պատահում, եթե Python- ից հարցնենք գոյություն չունեցող ստեղնաշարի արժեքը: Դուք կարող եք կռահել? Եկեք փորձենք և տեսնենք:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Տեսեք, մեկ այլ սխալ: Այս մեկը ** KeyError ** է: Python- ը օգտակար է և ասում է, որ `'age' («տարիքը») ` բանալին գոյություն չունի այս բառարանում:
+
+Ե՞րբ պետք է օգտագործեք բառարան կամ ցուցակ: Լավ, դա խորհելու լավ կետ է: Մտածեք պատասխանի մասին նախքան այն հաջորդ տողում դիտելը:
+
+- Ուղղակի պե՞տք է իրերի պատվիրված հաջորդականություն: Գնացեք ցուցակի համար:
+- Ձեզ հարկավոր է արժեքները կապել բանալիների հետ, որպեսզի հետագայում դրանք արդյունավետ (բանալիներով) որոնեք: Օգտագործեք բառարան
+
+Բառարանները, ինչպես list-ները (ցուցակ)ները, * mutable (փոփոխական) են *, ինչը նշանակում է, որ դրանք կարող են փոփոխվել ստեղծվելուց հետո: Բառարանում կարող եք ավելացնել բանալի-արժեքի նոր զույգեր այն ստեղծվելուց հետո, ինչպես հետևյալը.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Ծուցակների նման, բառարաններում օգտագործելով ` len () ` ֆունկցիան, վերադարձնում է բառարանում բանալի-արժեք զույգերի քանակը: Գնացեք և մուտքագրեք այս հրամանը.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Հուսով եմ ՝ դա մինչ այժմ իմաստ ունի: :) Պատրա՞ստ եք բառարանների հետ զվարճանալու համար: Կարդացեք մի քանի զարմանալի բաների մասին:
+
+Կարող եք օգտագործել ` pop () ` method-(մեթոդ)ը ՝ բառարանում իրը ջնջելու համար: Ասեք, եթե ցանկանում եք ջնջել `'favorite_numebrs' «սիրված_համարները» ` բանալին համապատասխան գրառումը, մուտքագրեք հետևյալ հրամանը.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Ինչպես տեսնում եք արդյունքից, 'favorite_numbers'(«սիրված_համարներ») ստեղնին համապատասխանող ստեղն-արժեք զույգը ջնջվել է:
+
+Բացի դրանից, դուք կարող եք նաև փոխել մի բառ, որը կապված է բառարանում արդեն իսկ ստեղծված բանալին: Մուտքագրեք սա ՝
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Ինչպես տեսնում եք, `'country' («երկիր») ` ստեղնի արժեքը փոխվել է ` 'Poland' («Լեհաստան») ` - ից ` 'Germany' («Գերմանիա»)`: :) Հուզիչ? Ուռա! Դուք պարզապես սովորեցիք մեկ այլ զարմանալի բան:
+
+### Ամփոփում
+
+Հոյակապ. Դուք հիմա շատ բան գիտեք ծրագրավորման մասին: Այս վերջին մասում իմացաք.
+
+- ** errors (սխալներ) ** - Դուք այժմ գիտեք, թե ինչպես կարդալ և հասկանալ սխալները, որոնք հայտնվում են, եթե Python- ը չի հասկանում ձեր կողմից տրված հրամանը
+- ** variables (փոփոխականներ) ** - օբյեկտների անուններ, որոնք թույլ են տալիս ավելի հեշտ ծածկագրել և ձեր կոդն ավելի ընթեռնելի դարձնել
+- ** lists (ցուցակներ) ** - որոշակի հերթականությամբ պահված օբյեկտների ցուցակներ
+- ** disctionaries (բառարաններ) ** - օբյեկտներ, որոնք պահվում են որպես ստեղն-արժեք զույգեր
+
+Հիասթափվա՞ծ եք հաջորդ մասի համար: :) 
+
+## Համեմատեք իրերը
+
+> Ընթերցողների համար տանը. Այս մասն ընդգրկված է [ Python Basics: Comparisons (Համեմատություններ )](https://www.youtube.com/watch?v=7bzxqIKYgf4) տեսանյութում:
+
+Ծրագրավորման մեծ մասը ներառում է իրերի համեմատություն: Ո՞րն է համեմատության մեջ ամենահեշտ բանը: Թվե՛ր: Տեսնենք, թե ինչպես է դա գործում.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+Մենք որոշ թվեր տվեցինք Python- ին `համեմատելու համար: Ինչպես տեսնում եք, Python- ը ոչ միայն կարող է համեմատել թվերը, այլ նաև կարող է համեմատել մաթեմատիկական արտահայտությունների արժեքները, ինչպիսիք են ` 2 * 2 ` և ֆունկցիայի արդյունքները, ինչպիսին է ` 2 ` վերադարձվածը ` len ([4, 5]) `: Հաճելի է, հա՞:
+
+Զարմանո՞ւմ եք, թե ինչու ենք իրար կողքի դնում երկու հավասար ` == ` նշաններ ՝ համեմատելու համար, եթե թվերը հավասար են: Մենք օգտագործում ենք մեկ ` = ` փոփոխականներին արժեքներ նշանակելու համար: Դուք միշտ, ** միշտ ** պետք է դնեք դրանցից երկուսը ՝ ` == ` - եթե ուզում եք ստուգել, արդյոք իրերը հավասար են միմյանց: Կարող ենք նաև փաստել, որ իրերն անհավասար են միմյանց համար: Դրա համար մենք օգտագործում ենք `!= ` խորհրդանիշը, ինչպես ցույց է տրված վերևում բերված օրինակում:
+
+Python- ին տվեք ևս երկու առաջադրանք.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+Մենք տեսել ենք `>`և `<` բայց ի՞նչ են նշանակում `>=` և `<=`: Կարդացեք դրանք այսպես.
+
+- x `>` y նշանակում է ՝ x- ն y- ից մեծ է
+- x `<` y նշանակում է `x- ը y- ից փոքր է
+- x `<=` y նշանակում է `x- ը y- ից փոքր է
+- x `>=` y նշանակում է. x- ը y- ից մեծ է կամ հավասար է դրան
+
+Հիանալի! ուզում ես մի հատ էլ անել? Փորձեք այս:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Կարող եք Python- ին տալ այնքան թվեր, որպեսզի համեմատես, որքան ուզում ես, և դա քեզ կպատասխանի: Բավականին խելացի, այդպես չէ՞:
+
+- ** and (և) ** - եթե օգտագործում եք ` and (և) ` օպերատորը, երկու համեմատություններն էլ պետք է լինեն Ճիշտ, որպեսզի ամբողջ հրամանը լինի Ճիշտ:
+- ** or (կամ) ** - եթե օգտագործում եք ` or (կամ) ` օպերատոր, ապա համեմատություններից միայն մեկը պետք է լինի Ճիշտ, որպեսզի ամբողջ հրամանը լինի Ճիշտ
+
+Լսե՞լ եք «խնձորը նարինջի հետ համեմատելը» արտահայտության մասին: Փորձենք Python- ի համարժեքը.
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Այստեղ տեսնում եք, որ ինչպես արտահայտության մեջ, Python- ը ի վիճակի չէ համեմատել համարը (` int `) և տողը (` str `): Փոխարենը, այն ցույց է տալիս ** TypeError ** և մեզ ասում է, որ երկու տիպերը չեն կարող համեմատվել միասին:
+
+## Boolean
+
+Ի դեպ, դուք հենց նոր իմացաք Python- ի նոր տեսակի օբյեկտների մասին: Այն կոչվում է ** Boolean (Բուլյան) **:
+
+Boolean (Բուլյան) ընդամենը երկու օբյեկտ կա.
+
+- Ճիշտ
+- Կեղծ
+
+Բայց որպեսզի Python- ը դա հասկանա, դուք պետք է այն միշտ գրեք որպես 'True' («Ճիշտ») (առաջին տառերը մեծատառով, մնացած տառերը փոքրատառերով): ** true, TRUE և tRUE չեն գործի. Միայն True- ն է ճիշտ: ** (Նույնը վերաբերում է նաև 'False' - ին):
+
+Booleans- ը նույնպես կարող է փոփոխական լինել: Տեսեք այստեղ ՝
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Դուք կարող եք նաև դա անել այս կերպ.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Պարապեք և զվարճացեք Booleans- ի հետ `փորձելով կատարել հետևյալ հրահանգները.
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Շնորհավորանքներ. Booleans- ը ծրագրավորման ամենաթեժ առանձնահատկություններից մեկն է, և դուք պարզապես սովորեցիք, թե ինչպես օգտագործել դրանք:
+
+# Պահպանել այն!
+
+> Ընթերցողների համար տանը. Այս մասը ներառված է [ Python Basics: Saving files and 'if' statement (Python- ի հիմունքներում. Ֆայլեր պահելը և «Եթե» հայտարարությունը) ](https://www.youtube.com/watch?v=dOAg6QVAxyk) տեսանյութում:
+
+Մինչ այժմ մենք թարգմանչի մեջ գրում էինք մեր պիթոնի բոլոր կոդերը, ինչը մեզ սահմանափակում է միանգամից մեկ տող կոդ մուտքագրելով: Նորմալ ծրագրերը պահվում են ֆայլերում և կատարվում են մեր ծրագրավորման լեզվի ** interpreter (թարգմանիչ) ** կամ ** compiler (կազմողի) ** կողմից: Մինչ այժմ մենք միանգամից տողեր ենք վարում մեր ծրագրերը Python- ի ** interpreter (թարգմանչի) ** մեջ: Հաջորդ մի քանի առաջադրանքների համար մեզ մեկից ավելի տող ծածկագիր է պետք, ուստի մեզ արագ անհրաժեշտ կլինի.
+
+- Ելք Python- ի թարգմանիչից
+- Բացեք մեր ընտրած կոդերի խմբագրիչը
+- Մի քանի կոդ պահեք պիթոնի նոր ֆայլում
+- Սկսե՛ք (run the code) 
+
+Մեզ համար օգտագործվող Python- ի interpreter (թարգմանիչից) դուրս գալու համար մուտքագրեք ` exit()  (ելք())` ֆունկցիան
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Սա ձեզ կրկին կտեղադրի command-ի (հրամանի) տողի մեջ:
+
+Ավելի վաղ մենք [ code editor (կոդերի խմբագիր) ](../code_editor/README.md) բաժնից ընտրեցինք code editor (կոդի խմբագիր): Մենք հիմա պետք է բացենք editor-ը (խմբագիրը) և մի քանի կոդ գրենք նոր ֆայլի մեջ (կամ եթե օգտագործում եք Chromebook, ստեղծեք նոր ֆայլ ամպային IDE- ում և բացեք այն ֆայլ, որը կլինի ներառված ծածկագրերի խմբագրում).
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Ակնհայտ է, որ դուք այժմ Python- ի բավականին փորձառու մշակող եք, այնպես որ ազատորեն գրեք մի քանի կոդ, որոնք սովորել եք այսօր:
+
+Այժմ մենք պետք է պահենք ֆայլը և տալ այն նկարագրական անուն: Եկեք զանգահարենք ֆայլը ** python_intro.py ** և պահենք այն ձեր աշխատասեղանին: Մենք կարող ենք ֆայլը անվանել այն, ինչ ուզում ենք, բայց այստեղ կարևոր մասն այն է, որ ֆայլը վերջանա ** .py **: ** .py ** ընդլայնումը մեր օպերացիոն համակարգին ասում է, որ սա ** Python excutable file (գործարկվող ֆայլ) ** է, և Python- ը կարող է այն գործարկել:
+
+> ** Նշում ** Դուք պետք է նկատեք կոդերի խմբագիրների ամենաթեժ մեկը `գույները: Python կոնսոլում ամեն ինչ նույն գույնն էր. հիմա պետք է տեսնեք, որ ` print (տպել) ` function-ը (գործառույթը) string-ից տարբեր գույն է: Սա կոչվում է "syntax highlighting" («շարահյուսական լուսաբանում»), և դա իսկապես օգտակար հատկություն է կոդավորման ժամանակ: Իրերի գույնը ձեզ հուշումներ կտա, ինչպիսիք են չփակված string-երը կամ կարևոր բառի տառասխալը (ինչպես ֆունկցիաի ` def (անջատումը) `, որը կտեսնենք ստորև): Սա է պատճառը, որ մենք օգտագործում ենք code editor ( կոդերի խմբագիր): :)
+
+Ֆայլը պահված պահով ՝ այն գործարկելու ժամանակն է: Օգտագործելով command line (հրամանի տողի) բաժնում ձեր սովորած հմտությունները, օգտագործեք տերմինալը ** change directories (գրացուցակները փոխելու ) ** համար:
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Mac- ի վրա հրամանը նման կլինի հետևյալ կերպ.
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Linux- ում դա կլինի այսպես.
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Հիշեք, որ "Desktop" («աշխատասեղան») բառը կարող է թարգմանվել ձեր տեղական լեզվով):
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+Windows- ի հրամանի տողում սա կլինի այսպես.
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+Եվ Windows Powershell- ում դա կլինի այսպես.
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Եթե խրվել եք, օգնություն խնդրեք: Դա հենց այն է, ինչի համար այստեղ են մարզիչները:
+
+Այժմ օգտագործեք Python- ը ֆայլի ծածկագիրը այսպիսի կատարելու համար.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Նշում. Windows- ում 'python3' («python3») - ը չի ճանաչվում որպես հրաման: Փոխարենը, ֆայլը կատարելու համար օգտագործեք 'python' («python»).
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Լավ! Դուք պարզապես գործարկել եք ձեր առաջին Python ծրագիրը, որը պահվել է ֆայլում: Ձեզ հիանալի՞ եք զգում:
+
+Այժմ կարող եք անցնել ծրագրավորման կարևոր գործիքի.
+
+## If … elif … else
+
+Կոդում պարունակվող շատ բաներ պետք է կատարվեն միայն տրված պայմանների բավարարման դեպքում: Այդ պատճառով Python- ն ունի **if statement (եթե հայտարարություններ) ** կոչվող մի բան:
+
+Փոխարինեք կոդը ձեր ** python_intro.py ** ֆայլում հետևյալով.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Եթե մենք save/ փրկեինք և run / գործարկեինք սա, կտեսնեինք այսպիսի սխալ.
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python- ն ակնկալում է, որ մենք նրան հետագա հրահանգներ կտանք, որոնք կատարվում են, եթե`3 > 2` պարզվում է, որ ճիշտ է (կամ `True` այդ հարցի համար): Փորձենք Python- ին տպել"It works!" («Այն գործում է»): Փոխեք ձեր կոդը ձեր ** python_intro.py ** ֆայլում հետևյալով ՝
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Ուշադրություն դարձրեք, թե ինչպես ենք մենք մուտքագրել ծածկագրի հաջորդ տողը ըստ 4 տարածության: Մենք պետք է դա անենք, որպեսզի Python- ը իմանա, թե ինչ կոդ գործարկի, եթե արդյունքը ճիշտ է: Կարող եք մեկ տարածք անել, բայց Python- ի գրեթե բոլոր ծրագրավորողները կատարում են 4-ը, որպեսզի ամեն ինչ կոկիկ տեսք ունենա: Մեկ ներդիրը նույնպես կհամարվի 4 տարածություն, քանի դեռ ձեր տեքստի խմբագրիչը պատրաստ է դա անել: Երբ դու կատարեցիր քո ընտրությունը, մի փոխիր այն: Եթե դուք արդեն կտրել եք 4 տարածություն, ապա կատարեք ցանկացած ապագա խորացում նաև 4 տարածության հետ, հակառակ դեպքում կարող եք խնդիրներ առաջանալ:
+
+Պահպանեք այն և նորից run /մեկնարկեք.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Նշում. Հիշեք, որ Windows- ում «python3» - ը չի ճանաչվում որպես հրաման: Այսուհետ, ֆայլը կատարելու համար փոխարինեք «python3» - ը «python» - ով:
+
+### Ի՞նչ կլինի, եթե պայմանը True (ճիշտ) չէ:
+
+Նախորդ օրինակներում ծածկագիրը կատարվում էր միայն այն ժամանակ, երբ պայմանները True (ճշմարիտ) էին: Բայց Python- ը ունի նաև ` elif ` և ` else ` հայտարարություններ.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+Երբ սա գործարկվի, այն կտպագրվի ՝
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+Եթե 2-ը 5-ից մեծ թիվ լիներ, ապա երկրորդ հրամանը կկատարվեր: Տեսնենք, թե ինչպես է աշխատում ` elif `:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+և սկսեց.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+Տեսեք, թե ինչ է տեղի ունեցել այնտեղ: `elif` Ձեզ հնարավորություն է տալիս ավելացնել լրացուցիչ պայմաններ, որոնք գործում են նախորդ պայմանների ձախողման դեպքում:
+
+Նախնական ` if (եթե) ` հայտարարությունից հետո կարող եք ավելացնել այնքան ` elif ` հայտարարություն, որքան ցանկանում եք: Օրինակ:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python- ն անցնում է յուրաքանչյուր թեստի հաջորդականությամբ և տպում.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Մեկնաբանությունները տողեր են, որոնք սկսվում են ` # ` - ով: ` # ` - ից հետո կարող եք գրել այն ամենը, ինչ ուզում եք, և Python- ը անտեսելու է այն: Մեկնաբանությունները կարող են հեշտացնել ձեր ծածկագիրը այլ մարդկանց համար:
+
+Տեսնենք, թե ինչպես է դա թվում.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+Կոդի յուրաքանչյուր տողի համար անհրաժեշտ չէ մեկնաբանություն գրել, բայց դրանք օգտակար են բացատրելու համար, թե ինչու է ձեր կոդն ինչ-որ բան անում, կամ ամփոփում է ներկայացնում, երբ այն ինչ-որ բարդ բան է անում:
+
+### Ամփոփում
+
+Վերջին մի քանի վարժություններում, որոնց մասին իմացաք.
+
+- ** comparing things (իրերի համեմատություն)** - Python- ում դուք կարող եք համեմատել իրերը ՝ օգտագործելով`>`, `>=`, `==`, `<=`, `<` և ` և `, ` or (կամ) ` օպերատորները
+- ** Boolean ** - օբյեկտի տեսակ, որը կարող է ունենալ միայն երկու արժեքներից մեկը ՝ ` Ture (Ճիշտ) ` կամ ` False (Սխալ)`
+- ** Saving files (Ֆայլեր պահելը)** - ֆայլերում կոդ է պահվում, որպեսզի կարողանաք ավելի մեծ ծրագրեր իրականացնել:
+- ** if… elif… other ** - հայտարարություններ, որոնք թույլ են տալիս կատարել կոդ միայն որոշակի պայմանների բավարարման դեպքում:
+- ** comments (մեկնաբանություններ) ** - տողեր, որոնք Python- ը չի գործարկի, որոնք թույլ են տալիս փաստաթղթավորել ձեր կոդը
+
+Ժամանակն է այս գլխի վերջին մասի:
+
+## Ձեր սեփական functions (ֆունկցիաները):
+
+> Ընթերցողների համար տանը. Այս մասն ընդգրկված է [ Python Basics: Functions ](https://www.youtube.com/watch?v=5owr-6suOl0) տեսանյութում: 
+
+Հիշո՞ւմ եք ` len() ` - ի նման գֆունկցիաներ, որոնք կարող եք կատարել Python- ում: Դե, լավ նորություն. Դուք կսովորեք, թե ինչպես գրել ձեր սեփական ֆունկցիաները հիմա:
+
+Ֆունկցիան հրահանգների հաջորդականություն է, որը Python- ը պետք է կատարի: Python- ում յուրաքանչյուր ֆունկցիան սկսվում է ` def ` հիմնաբառից, տրվում է անուն և կարող է ունենալ որոշ պարամետրեր: Եկեք փորձենք: Փոխարինեք կոդը ** python_intro.py ** - ում հետևյալով.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Լավ, մեր առաջին ֆունկցիան պատրաստ է:
+
+Կարող եք զարմանալ, թե ինչու ենք ֆունկցիայի անունը գրել ֆայլի ներքևում: Երբ մենք գրում ենք ` def hi (): ` և հետևյալ խորշված տողերը, սա մենք ենք, որ հրահանգներ ենք գրում, թե ինչ պետք է անի ` hi () ` ֆունկցիան: Python- ը կկարդա և կհիշի այս հրահանգները, բայց ֆունկցիան դեռ չի գործարկի: Python- ին ասելու համար, որ մենք ուզում ենք ֆունկցիան գործարկել, մենք պետք է ֆունկցիան կանչենք ` hi () ` - ով: Python- ը կարդում է ֆայլը և կատարում այն վերից վար, այնպես որ մենք պետք է ֆայլում սահմանենք ֆունկցիան նախքան այն կանչելը:
+
+Եկեք վարենք սա հիմա և տեսնենք, թե ինչ է տեղի ունենում.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Նշում. Եթե չի հաջողվել, մի խուճապի մատնվեք: Արդյունքը կօգնի ձեզ հասկանալ, թե ինչու.
+
+- Եթե դուք ստանում եք ` NameError` դա, հավանաբար, նշանակում է, որ դուք սխալ եք մուտքագրել ինչ-որ բան, ուստի պետք է ստուգեք, որ նույն անունն օգտագործել եք ` def hi (): ` ֆունկցիան ստեղծելիս և այն ` hi () ` - ով զանգահարելիս ,
+- Եթե դուք ստանում եք ` IndentationError `, տողի սկզբում ստուգեք, որ ` print (տպագիր) ` տողերն էլ ունենան նույն սպիտակ տարածությունը. 
+- Եթե ընդհանրապես ելք չկա, ստուգեք, որ վերջին ` hi() ` * տրոհված չէ * - եթե այդպես է, այդ տողը նույնպես կդառնա գործառույթի մաս: Այն երբեք չի սկսվի:
+
+Եկեք կառուցենք մեր առաջին գործառույթը պարամետրերով: Մենք կփոխենք նախորդ օրինակը ՝ ֆունկցիան , որն ասում է "hi" («ողջույն») այն աշխատող անձին ՝ անունով.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+Ինչպես տեսնում եք, մենք հիմա մեր ֆունկցիան տվեցինք մի պարամետր, որը կոչեցինք `name ( անուն) `:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Հիշիր `print (տպել) ` գործառույթը կտրված է չորս տարածության մեջ `if (եթե) ` հայտարարության մեջ: Դա պայմանավորված է նրանով, որ ֆունկցիան աշխատում է պայմանը բավարարելիս: Տեսնենք, թե ինչպես է այն աշխատում այժմ.
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Սխալ: Բարեբախտաբար, Python- ը մեզ տալիս է օգտակար սխալի հաղորդագրություն: Այն մեզ ասում է, որ ` hi () ` ֆունկցիան (այն, ինչ մենք սահմանեցինք) ունի մեկ պահանջվող փաստարկ (կոչվում է ` name (անուն) `) և որ մենք մոռացանք փոխանցել այն գործառույթը ակտիվացնելիս Եկեք ֆիքսենք այն ֆայլի ներքևում.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+Եվ նորից գործարկեք այն.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+Իսկ եթե անունը փոխե՞նք:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+Եվ run/գործարկեք այն.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Հիմա ի՞նչ եք կարծում, ի՞նչ կլինի, եթե այնտեղ մեկ այլ անուն գրեք: (Ոչ Ola/Օլան կամ Sonja/Սոնյան): Փորձեք և տեսեք, արդյոք ճիշտ եք: Այն պետք է տպագրի սա ՝
+
+{% filename %}command-line{% endfilename %}
+
+    Ողջույն անանուն:
+    
+
+Սա հիանալի է, չէ՞: Այս կերպ ձեզ հարկավոր չէ կրկնել ամեն անգամ, երբ ցանկանում եք փոխել այն անձի անունը, որը պետք է ողջունի ֆունկցիան: Եվ հենց այդ պատճառով մեզ ֆունկցիաներ են պետք. Դուք երբեք չեք ցանկանում կրկնել ձեր ծածկագիրը:
+
+Եկեք ավելի խելացի բան անենք. Անուններն ավելի շատ են, քան երկուսը, և յուրաքանչյուրի համար պայման գրելը դժվար կլինի, չէ՞: Ձեր ֆայլի պարունակությունը փոխարինեք հետևյալով.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+կեք հիմա զանգահարենք ծածկագիրը.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Շնորհավորում եմ Դուք պարզապես իմացաք, թե ինչպես գրել ֆունկցիաներ: :)
+
+## Loops ( Օղակներ )
+
+> Ընթերցողների համար տանը. Այս մասը ընդգրկված է [ Python Basics: For Loop ](https://www.youtube.com/watch?v=aEA6Rc86HF0) տեսանյութում:
+
+Սա արդեն վերջին մասն է: Դա արագ էր, չէ՞: :)
+
+Ծրագրավորողների չեն սիրում կրկնել իրենց: Ծրագրավորում բոլոր մասին, automating բաներ, այնպես որ, մենք չենք ուզում, որպեսզի ողջունելու յուրաքանչյուր անձին իրենց անունով ձեռքով, ճիշտ է? Դա այն վայրն է, որտեղ օղակները հարմար են:
+
+Դեռ հիշու՞մ եք ցուցակները: Եկեք կատարենք աղջիկների ցուցակ.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+Մենք ուզում ենք նրանց բոլորին ողջունել իրենց անունով: Դա անելու համար մենք ունենք ` hi ` function, ուստի եկեք օգտագործենք այն loop-ի (օղակի) մեջ.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+` for ` հայտարարությունը իրեն նույն կերպ է վերաբերվում ` if ` հայտարարությանը; Այս երկուսից էլ ներքևի ծածկագիրը պետք է փորված լինի չորս տարածության մեջ:
+
+Ահա ամբողջական կոդը, որը կլինի ֆայլում.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+Եվ երբ մենք այն run/վարում ենք.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+Ինչպես տեսնում եք, այն ամենը, ինչ դնում եք ` for (համար) ` հայտարարության ներդիրով, կկրկնվի ` girls (աղջիկների)` ցուցակի յուրաքանչյուր տարր:
+
+Դուք կարող եք նաեւ օգտագործել `for (համար) ` է թվերի օգտագործելով ` range (հեռահար) ` ֆունկցիան:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Որը կտպագրի.
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+` range (միջակայքը) ` ֆունկցիան է, որը ստեղծում է թվերի ցուցակը մեկը մյուսին հաջորդող (այս թվերը տրամադրվում են ձեր կողմից որպես պարամետրեր):
+
+Նկատի ունեցեք, որ այս երկու թվերից երկրորդը ներառված չէ Python- ի կողմից թողարկվող ցուցակում (նկատի ունի ` range(1, 6) ` հաշվում է 1-ից 5-ը, բայց չի ներառում 6 թիվը): Դա այն պատճառով է, որ "range"-ը («միջակայքը») կիսաբաց է, և դրանով մենք նկատի ունենք, որ այն ներառում է առաջին արժեքը, բայց ոչ վերջինը:
+
+## Ամփոփում
+
+Վերջ ** Դուք լիովին ռոք եք անում: ** Սա բարդ գլուխ էր, այնպես որ դուք պետք է հպարտանաք ինքներդ ձեզնով: Մենք անկասկած հպարտ ենք ձեզանով, որ հասել եք մինչ այժմ:
+
+Python- ի պաշտոնական և ամբողջական ձեռնարկի համար այցելեք https://docs.python.org/3/tutorial/: Սա ձեզ լեզվի ավելի մանրակրկիտ և ամբողջական ուսումնասիրություն կտա: Ողջույն :)
+
+Կարող եք համառոտ մեկ այլ բան անել ՝ ձգվել, մի փոքր շրջել, հանգստանալ ձեր աչքերով ՝ նախքան հաջորդ գլուխ անցնելը: :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/hy-AM/signup_pythonanywhere.md b/hy-AM/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/hy-AM/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/hy-AM/template_extending/README.md b/hy-AM/template_extending/README.md
new file mode 100644
index 00000000000..6f6584aeeba
--- /dev/null
+++ b/hy-AM/template_extending/README.md
@@ -0,0 +1,151 @@
+# Ձևանմուշի ընդլայնում/Template extending
+
+Django- ի մեկ այլ օգտակար բան **template extending/ձևանմուշի ընդլայնումն է ** : Ինչ է դա նշանակում? Ձեր կայքի տարբեր էջերիի համար կարող եք օգտագործել HTML- ի նույն մասերը: 
+
+Ձևանմուշներն/Templates օգնում են, երբ ուզում եք նույն տեղեկատվությունը կամ դասավորությունը օգտագործել մեկից ավելի վայրերում: Յուրաքանչյուր ֆայլում հարկավոր չէ կրկնել: Եվ եթե ուզում եք ինչ-որ բան փոխել, ապա հարկավոր չէ դա անել յուրաքանչյուր ձևանմուշում, այլ միայն մեկում:
+
+## Ստեղծեք բազային ձևանմուշ/ base template
+
+Բազային ձևանմուշը/base template ամենահիմնական ձևանմուշն է, որը դուք տարածում եք ձեր կայքի յուրաքանչյուր էջում:
+
+Եկեք ստեղծենք `base.html` ֆայլ `blog/templates/blog/`-ում:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Դրանից հետո բացեք այն կոդերի խմբագրում և պատճենեք ամեն ինչ ՝ `post_list.html` - ից `base.html` ֆայլը, ինչպես սա:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Դրանից հետո `base.html`- ում փոխարինեք ձեր ամբողջ `<body>` -ը (ամեն ինչ `<body>` և `</body> ` - ի միջև) հետևյալով.
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw%} Ինչպես նկատեցիք, մենք փոխարինեցինք ամեն ինչ ՝ սկսած `{% for post in posts %}`-ը, `{% endfor %}` - ով փոխարինելով ՝ {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Բայց ինչու՞ Դուք հենց նոր `block/բլոկ` ստեղծեցիք: Դուք օգտագործեցիք `{% block %}` ձևանմուշի պիտակը ՝ տարածք ստեղծելու համար, որտեղ կտեղադրվի HTML-ը : Այդ HTML- ը կգա մեկ այլ ձևանմուշից, որը տարածում է այս ձևանմուշը (`base.html`): Մենք ձեզ ցույց կտանք, թե ինչպես դա անել մեկ վայրկյանում:
+
+Այժմ պահպանեք `base.html`- ը և նորից բացեք ձեր `blog/templates/blog/post_list.html` կոդերի խմբագրում: {% raw %}Դուք պատրաստվում եք հեռացնել ամեն ինչ, որը գտնվում է `{% for post in posts %}`-ից վերևում, և `{% endfor %}`-ից ներքևում: Ավարտելուց հետո ֆայլն այսպիսի տեսք կունենա.{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Մենք ուզում ենք սա օգտագործել որպես մեր ձևանմուշի մի մաս ՝ բովանդակության բոլոր բլոկների համար: Ժամանակն է այս ֆայլին ավելացնել բլոկի պիտակները/block tags:
+
+{% raw %} Դուք ցանկանում եք, որ ձեր բլոկի թեգը համընկնի `base.html` ֆայլի պիտակի/ tag-ի հետ: Դուք նաև ցանկանում եք ներառել ամբողջ ծածկագիրը, որը պատկանում է բովանդակության բլոկներին/content blocks: Դա անելու համար ամեն ինչ տեղադրեք{% block content %} - ի և {% endblock %} - ի միջև: Սրա նման. {% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Մնում է միայն մեկ բան. Մենք պետք է այս երկու ձևանմուշները միացնենք միմյանց: Սա այն է, ինչ կոչվում է «ձևանմուշի ընդլայնում/extending templates»: Մենք դա կանենք ՝ ֆայլի սկզբին ընդլայնման պիտակ/ extends tag ավելացնելով: Սրա նման:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Վերջ Պահեք ֆայլը և ստուգեք, արդյոք ձեր կայքը դեռ պատշաճ կերպով աշխատում է: :) 
+
+> Եթե `TemplateDoesNotExist` սխալ եք ստանում, դա նշանակում է, որ `blog/base.html` ֆայլը բացակայում է, և դուք ունեք `runserver` վահանակում: Փորձեք դադարեցնել այն (միաժամանակ սեղմելով Ctrl + C - Control և C ստեղները) և վերագործարկեք սերվերը `python manage.py runserver` հրամանի միջոցով:
\ No newline at end of file
diff --git a/hy-AM/whats_next/README.md b/hy-AM/whats_next/README.md
new file mode 100644
index 00000000000..a17cb8f59c3
--- /dev/null
+++ b/hy-AM/whats_next/README.md
@@ -0,0 +1,43 @@
+# Ի՞նչ է հաջորդը
+
+Շնորհավորիր քեզ: ** Դուք հիանալի եք **: Մենք շատ հպարտ ենք <3
+
+### Ի՞նչ անել հիմա:
+
+Ընդմիջեք և հանգստացեք: Դուք պարզապես հոյակապ աշխատանք եք ավարտել:
+
+Հետևեք Django Girls- ին [Facebook](http://facebook.com/djangogirls)- ում և [Twitter](https://twitter.com/djangogirls) - ում `նորությունների մասին տեղեկացված լինելու համար:
+
+### Կարո՞ղ եք առաջարկել ուսման լրացուցիչ ռեսուրսներ:
+
+Այո: Բոլոր տեսակի ծրագրավորման լեզուները սովորելու համար կան * բազմաթիվ * առցանց ռեսուրսներ. Հնարավոր է դժվար թվալ ընտրությունը, թե որ կողմ շարժվել հաջորդ փուլերում, բայց մենք կօգնենք ձեզ դա հասկանալ: Ինչպիսին էլ որ լինեին ձեր հետաքրքրությունները նախքան Django Girls- ին միանալը, և ինչ հետաքրքրություններ էլ որ դուք զարգացրել եք ամբողջ դասընթացի ժամանակ, ահա մի քանի անվճար ռեսուրսներ (կամ ռեսուրսներ ՝ շատ անվճար բաղադրիչներով), որոնք կարող եք օգտագործել ձեր նպատակներին հասնելու համար:
+
+#### Django
+
+- Մեր մեկ այլ գիրք ՝ [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django- ի պաշտոնական ձեռնարկը](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Սկսենք Django- ի վիդեո դասերից](http://www.gettingstartedwithdjango.com/)
+- [ Django- ն բոլորի համար մասնագիտացման համար ](https://www.coursera.org/specializations/django) - որոշ տեսադասախոսություններ կարող են անվճար աուդիտի ենթարկվել, և այս դասընթացները անցնելով կարող եք վաստակել Coursera սերտիֆիկատ:
+
+#### HTML, CSS և JavaScript
+
+- [Codecademy- ի վեբ զարգացման դասընթաց](https://www.codecademy.com/learn/paths/web-development)
+- [ freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy-ի Python դասընթացը](https://www.codecademy.com/learn/learn-python)
+- [ Google- ի Python դասընթաց](https://developers.google.com/edu/python/)
+- [ Learn Python The Hard Way book (Իմացեք Python The Hard Way գիրքը) ](http://learnpythonthehardway.org/book/) - նախնական վարժություններն անվճար են
+- [ New Coder tutorials (Կոդերի նոր ձեռնարկներ) ](http://newcoder.io/tutorials/) - սա մի շարք գործնական օրինակներ է, թե ինչպես կարող եք օգտագործել Python- ը
+- [ edX ](https://www.edx.org/course?search_query=python) - Դուք կարող եք ստուգել դասընթացների մեծ մասը անվճար, բայց եթե ցանկանում եք բարձրագույն կրթության որակավորման վկայագիր կամ կրեդիտներ, ապա դա կարժենա գումար:
+- [ Coursera's Python specialization (Coursera- ի Python մասնագիտացումը) ](https://www.coursera.org/specializations/python) - որոշ վիդեո դասախոսություններ կարող են անվճար աուդիտի ենթարկվել, և դուք կարող եք վաստակել Coursera սերտիֆիկատ ՝ անցնելով այս դասընթացները
+- [ Python for Everybody (Python բոլորի համար) ](https://www.py4e.com/) - Coursera Python- ի բոլորի համար անվճար և բաց տարբերակ մասնագիտացման համար
+
+#### Տվյալների հետ աշխատելը
+
+- [Codecademy-ի տվյալների գիտության դասընթաց](https://www.codecademy.com/learn/paths/data-science)
+- [ edX ](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) - Դուք կարող եք ստուգել դասընթացների մեծ մասը անվճար, բայց եթե ցանկանում եք բարձրագույն կրթության որակավորման վկայագիր կամ կրեդիտներ, ապա դա կարժենա գումար:
+- [ Dataquest (Տվյալների հարցում) ](https://www.dataquest.io/) - առաջին 30 «առաքելությունները» անվճար են
+
+Մենք անհամբեր սպասում ենք ՝ տեսնելու, թե հետո ինչ եք կառուցում:
\ No newline at end of file
diff --git a/id-ID/GLOSSARY.md b/id-ID/GLOSSARY.md
new file mode 100644
index 00000000000..64f43bbc9bd
--- /dev/null
+++ b/id-ID/GLOSSARY.md
@@ -0,0 +1,3 @@
+# Editor Kode
+
+Editor kode adalah sebuah aplikasi yang memungkinkan anda menyimpan kode anda sehingga anda akan dapat membukannya kembali. Anda dapat belajar dimana dapat memperolehnya di bab [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/id-ID/README.md b/id-ID/README.md
new file mode 100644
index 00000000000..fca62cc021c
--- /dev/null
+++ b/id-ID/README.md
@@ -0,0 +1,51 @@
+# Tutorial Django Girls
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Karya ini dilisensikan dengan Lisensi Internasional Creative Commons Attribution-ShareAlike 4.0. Untuk melihat salinan lisensi ini, kunjungi https://creativecommons.org/licenses/by-sa/4.0/
+
+## SELAMAT DATANG
+
+Selamat datang di Tutorial Django Girls! Kami senang melihat Anda di sini. :) Dalam tutorial ini, kami akan membawa Anda ke sebuah perjalanan di bawah tenda teknologi web, menawarkan sekilas semua potongan dan penggalan yang perlu disatukan untuk membuat pekerjaan web seperti yang kita ketahui.
+
+Seperti semua hal yang tidak diketahui, ini akan menjadi petualangan - tapi jangan khawatir, karena Anda sudah memberanikan diri untuk berada di sini, Anda akan baik-baik saja. :)
+
+## Pengantar
+
+Pernahkah Anda merasa bahwa dunia lebih dan lebih banyak tentang teknologi yang tidak dapat Anda ketahui (belum) berhubungan? Pernahkah Anda bertanya-tanya bagaimana cara membuat situs web tapi tidak pernah memiliki cukup motivasi untuk memulai? Pernahkah Anda berpikir bahwa dunia perangkat lunak terlalu rumit untuk Anda coba melakukan sesuatu sendiri?
+
+Nah, kami punya kabar baik untukmu! Pemrograman tidak sesulit yang terlihat dan kami ingin menunjukkan betapa menyenangkannya itu.
+
+Tutorial ini tidak akan secara ajaib mengubah Anda menjadi programmer. Jika Anda ingin menjadi ahli dalam hal ini, Anda memerlukan waktu berbulan-bulan bahkan bertahun-tahun untuk belajar dan berlatih. Tapi kami ingin menunjukkan bahwa pemrograman atau pembuatan situs web tidak serumit tampilannya. Kami akan mencoba untuk menjelaskan potongan dan potongan yang berbeda sebaik yang kami bisa, jadi Anda tidak akan merasa terintimidasi oleh teknologi.
+
+Kami berharap bahwa kami akan dapat membuat anda mencintai teknologi sebagaimana kami juga mencintainya.
+
+## Apa yang akan anda pelajari dalam tutorial ini?
+
+Setelah selesai tutorial, Anda akan memiliki aplikasi web kerja kecil: blog Anda sendiri. Kami akan menunjukkan cara memasangnya secara online, sehingga orang lain akan melihat karya Anda!
+
+Hasilnya kurang lebih akan seperti ini:
+
+![Gambar 0.1](images/application.png)
+
+> Jika Anda bekerja dengan tutorial Anda sendiri dan tidak memiliki pelatih yang akan membantu Anda jika terjadi masalah, kami memiliki sistem obrolan untuk Anda: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Kami meminta kepada pelatih kami dan peserta sebelumnya untuk masuk ke sana untuk membantu orang lain mempelajari tutorial ini! Jangan sungkan untuk bertanya di sana!
+
+Oke, [mari kita mulai dari awal…](./how_the_internet_works/README.md)
+
+## Mengikuti tutorial di rumah
+
+Sungguh menakjubkan bisa ambil bagian dalam lokakarya Django Girls, tapi kami sadar bahwa tidak selalu mungkin untuk menghadiri acara tersebut. Inilah sebabnya kami mendorong Anda untuk mencoba mengikuti tutorial ini di rumah. Bagi pembaca di rumah, saat ini kami sedang mempersiapkan video yang akan memudahkan anda mengikuti tutorial sendiri. Ini masih merupakan pekerjaan yang sedang berjalan, tapi semakin banyak hal akan segera ditutup di [Pengodean adalah untuk anak perempuan](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed)kanal Youtube.
+
+Di setiap bab yang sudah dibahas, ada tautan yang mengarah ke video yang benar.
+
+## Tentang Tutorial Ini dan Bagaimana Cara Berkontribusi
+
+Tutorial ini diselenggarakan oleh [DjangoGirls](https://djangogirls.org/). Jika Anda menemukan kesalahan atau ingin mengupdate tutorialnya silahkan [ikuti panduan kontribusi](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Apakah Anda ingin membantu kami menerjemahkan tutorial ke bahasa lain?
+
+Saat ini, terjemahan disimpan di platform crowdin.com di:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Bila bahasa Anda tidak terdaftar di [crowdin](https://crowdin.com/), silakan [buat pengajuan baru](https://github.com/DjangoGirls/tutorial/issues/new) yang menginformasikan terkait bahasa supaya kami bisa menambahkannya.
\ No newline at end of file
diff --git a/id-ID/SUMMARY.md b/id-ID/SUMMARY.md
new file mode 100644
index 00000000000..e4eb5e72927
--- /dev/null
+++ b/id-ID/SUMMARY.md
@@ -0,0 +1,35 @@
+# Ikhtisar
+
+* [Pengenalan](README.md)
+* [Instalasi](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Instalasi (chromebook)](chromebook_setup/README.md)
+* [Bagaimana Internet Bekerja](how_the_internet_works/README.md)
+* [Pengenalan Pada Command Line](intro_to_command_line/README.md)
+* [Instalasi Python](python_installation/README.md)
+* [Teks editor](code_editor/README.md)
+* [Pengenalan Python](python_introduction/README.md)
+* [Apa itu Django ?](django/README.md)
+* [Installasi Django](django_installation/README.md)
+* [Project Django pertamamu!](django_start_project/README.md)
+* [Model Django](django_models/README.md)
+* [Admin Django](django_admin/README.md)
+* [Deploy (Publikasikan)](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Tampilan Django - waktu untuk membuat!](django_views/README.md)
+* [Pengantar untuk HTML](html/README.md)
+* [Django ORM (Queryset)](django_orm/README.md)
+* [Dinamis data dalam template](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS - membuatnya cantik](css/README.md)
+* [Template memperpanjang](template_extending/README.md)
+* [Perluas aplikasi Anda](extend_your_application/README.md)
+* [Form Django](django_forms/README.md)
+* [Apa selanjutnya?](whats_next/README.md)
\ No newline at end of file
diff --git a/id-ID/chromebook_setup/README.md b/id-ID/chromebook_setup/README.md
new file mode 100644
index 00000000000..03d9ebdaecb
--- /dev/null
+++ b/id-ID/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Penyiapan Chromebook
+
+> **Catatan** Jika Anda sudah melakukan [langkah-langkah pemasangan](../installation/README.md), tidak perlu melakukan ini lagi – Anda bisa langsung melompat ke Pengantar Python</1>.</p> </blockquote> 
+> 
+> {% include "/chromebook_setup/instructions.md"%}
\ No newline at end of file
diff --git a/id-ID/chromebook_setup/instructions.md b/id-ID/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..81b5729744a
--- /dev/null
+++ b/id-ID/chromebook_setup/instructions.md
@@ -0,0 +1,159 @@
+Anda bisa [melewatkan bagian ini](http://tutorial.djangogirls.org/en/installation/#install-python) jika Anda tidak menggunakan Chromebook. Jika ya, pengalaman instalasi Anda akan sedikit berbeda. Anda bisa mengabaikan sisa instruksi penginstalan.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE merupakan sebuah layanan berupa editor kode dan diakses lewat komputer yang berjalan di internet yang mana Anda bisa memasang, menulis, dan mengoperasikan perangkat lunak. Di dalam tutorial ini, Cloud IDE ini akan bertindak sebagai *mesin lokal* Anda. Anda tetap bisa mengoperasikan perintah di antarmuka terminal sama seperti mereka yang menggunakan OS X, Ubuntu, atau Windows, tapi terminal ini akan terkoneksi ke komputer yang berjalan di layanan cloud IDE yang Anda gunakan. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Anda bisa memilih salah satu dari layanan cloud IDE, dan ikuti instruksi dari setiap layanan cloud IDE yang Anda gunakan.
+
+#### PaizaCloud Cloud IDE
+
+1. Buka situs [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Buatlah akun baru
+3. Klik *New Server* dan pilih Django app
+4. Klik tombol Terminal (yang terletak di samping kiri)
+
+Lalu amati sidebar, terdapat tombol di sebelah kiri. Klik tombol "Terminal" untuk membuka terminal dengan prompt seperti ini:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+Terminal pada PaizaCloud Cloud IDE siap menerima instruksi Anda. Anda bisa mengubah ukuran atau memaksimalkan jendela itu untuk membuatnya sedikit lebih besar.
+
+#### AWS Cloud9
+
+Saat ini Cloud 9 mengharuskan Anda untuk mendaftar dengan AWS dan memasukkan informasi kartu kredit.
+
+1. Pasang Cloud 9 dari Chrome web store</ 0></li> 
+    
+    - Pergi ke [c9.io](https://c9.io) dan klik *Get started with AWS Cloud9*
+    - Daftar untuk akun AWS (memerlukan informasi kartu kredit, tetapi kamu dapat menggunakannya secara gratis)
+    - Pada AWS Dashboard, masuk *Cloud9* pada kotak pencarian dan klik
+    - Pada Cloud 9 dashboard, klik *Create environment*
+    - Namakan *django-girls*
+    - Saat di configuring settings, pilih *Create a new instance for environment (EC2)* untuk "Environment Type" dan *t2.micro* "Instance type" (Tulisan yang seharusnya muncul "Free-tier eligible."). Pengaturan default cost-saving selesai dan Anda dapat menetapkan yang lain secara default.
+    - Klik *Next step*
+    - Klik *Create environment*</ol> 
+    
+    Sekarang Anda harus melihat sebuah antarmuka dengan sidebar, jendela utama yang besar dengan beberapa teks, dan sebuah jendela kecil di bagian bawah yang terlihat seperti ini:
+    
+    {% filename %}bash{% endfilename %}
+    
+        yourusername:~/workspace $
+        
+    
+    Area bagian bawah adalah terminal Anda. Anda bisa menggunakannya untuk mengirimkan perintah kepada komputer remote Cloud9. Anda bisa menyesuaikan ukuran jendela untuk membuatnya sedikit lebih besar.
+    
+    #### Glitch.com Cloud IDE
+    
+    1. Go to [Glitch.com](https://glitch.com/)
+    2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+    3. Click *New Project* and choose *hello-webpage*
+    4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+    
+    {% filename %}Terminal{% endfilename %}
+    
+        app@name-of-your-glitch-project:~
+        
+    
+    When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+    
+    {% 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
+    ```
+    
+    Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+    
+    {% filename %}Terminal{% endfilename %}
+    
+        django-admin.py startproject mysite .
+        refresh
+        
+    
+    In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+    
+    {% 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,
+            },
+        },
+    }
+    ```
+    
+    This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+    
+    The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+    
+    ### Lingkungan Virtual
+    
+    A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+    
+    Run:
+    
+    {% filename %}Cloud 9{% endfilename %}
+    
+        mkdir djangogirls
+        cd djangogirls
+        python3 -m venv myvenv
+        source myvenv/bin/activate
+        pip install django~={{ book.django_version }}
+        
+    
+    (note that on the last line we use a tilde followed by an equal sign: `~=`).
+    
+    ### GitHub
+    
+    Make a [GitHub](https://github.com) account.
+    
+    ### PythonAnywhere
+    
+    The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+    
+    This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+    
+    Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/id-ID/code_editor/README.md b/id-ID/code_editor/README.md
new file mode 100644
index 00000000000..72678ec3f18
--- /dev/null
+++ b/id-ID/code_editor/README.md
@@ -0,0 +1,11 @@
+# Editor kode
+
+> Bagi pembaca di rumah: bab ini tercakup dalam  Memasang Python & amp; Editor Kode </ 0> video.</p> </blockquote> 
+> 
+> Anda akan menulis baris kode pertama Anda, jadi sekarang saatnya mendownload editor kode!
+> 
+> > **Catatan** Jika Anda menggunakan Chromebook, silahkan lewati bab ini dan pastikan Anda mengikuti perintah [Chromebook Setup](../chromebook_setup/README.md). IDE cloud yang anda pilih (PaizaCloud Cloud IDE atau AWS Cloud9) menyertakan sebuah Editor Kode, dan ketika anda membuka sebuah berkas di IDE anda dari menu File, maka anda akan secara ototmatis menggunakan editor tersebut.
+> > 
+> > ** Catatan** Anda mungkin telah melakukan ini sebelumnya di [bab Instalasi](../installation/README.md) - jika demikian, Anda dapat langsung melompat ke bab berikutnya!
+> 
+> {% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/id-ID/code_editor/instructions.md b/id-ID/code_editor/instructions.md
new file mode 100644
index 00000000000..bfc3da2d95b
--- /dev/null
+++ b/id-ID/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Ada banyak teks editor yang tersedia dan kita dapat memilih salah satu yang kita suka. Sebagian besar programmer Python menggunakan IDE (Integrated Development Environment) yang rumit namun memiliki banyak fitur, seperti PyCharm. Aplikasi seperti PyCharm menurut kami kurang sesuai untuk digunakan oleh pemula. Oleh sebab itu kami menyarankan aplikasi yang lebih sederhana namun memiliki fitur tak kalah lengkap.
+
+Berikut ini beberapa aplikasi yang kami sarankan untuk dapat pembaca pakai. Jangan sungkan untuk bertanya kepada mentor anda mengenai pilihan mereka - biasanya mereka akan dengan senang hati membantu.
+
+## Visual Studio Code
+
+Visual Studio Code adalah editor kode, yang dikembangkan oleh Microsoft untuk sistem operasi Windows, Linux dan macOS. Yang mendukung untuk debugging, kontrol Git didalamnya, penyorotan sintaksis, penyelesaian kode cerdas, snippet, dan refaktorisasi kode.
+
+[Download disini](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit adalah sebuah aplikasi teks editor yang bersifat sumber terbuka (open-source), gratis, dan tersedia untuk semua sistem operasi.
+
+[Download disini](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sumblime Text merupakan editor yang sangat populer dengan fitur gratis yang berjangka waktu dan tersedia untuk semua sistem operasi.
+
+[Download disini](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom merupakan editor populer juga. Gratis, open-source dan tersedia untuk Windows, OS X dan Linux. Atom dikembangkan oleh [GitHub](https://github.com/).
+
+[Download disini](https://atom.io/)
+
+## Mengapa Kita Perlu Memasang Aplikasi Teks Editor?
+
+Pembaca mungkin bertanya-tanya mengapa kita perlu memasang aplikasi teks editor dan tidak menggunakan editor biasa seperti Word atau Notepad.
+
+Alasan pertama adalah kode harus berbentuk **plain text** (teks biasa), Masalah dengan program seperti Word dan Textedit adalah bahwa mereka tidak menghasilkan plain text, tetapi program tersebut menghasilkan format rich text (dengan font dan format), menggunakan format khusus seperti  Rich Text Format (RTF)</ 1>.</p> 
+
+Alasan kedua adalah bahwa semua editor kode memiliki spesialisasi dalam penulisan kode, sehingga mereka memiliki fungsi yang berguna seperti menandai kode dengan warna, atau secara otomatis menutup tanda kutip.
+
+Kita lihat semuanya saat Anda sudah melakukannya. Nantinya, Anda akan berfikir bahwa kode editor lama yang sering anda gunakan akan menjadi salah satu kode edit yang akan menjadi favorit Anda. :)
\ No newline at end of file
diff --git a/id-ID/css/README.md b/id-ID/css/README.md
new file mode 100644
index 00000000000..09f6d373725
--- /dev/null
+++ b/id-ID/css/README.md
@@ -0,0 +1,330 @@
+# CSS - mempercantik!
+
+Blog kita masih terlihat jelek, kan? Saatnya mempercantiknya! Kita akan menggunakan CSS untuk itu.
+
+## Apa itu CSS?
+
+Cascading Style Sheets (CSS) adalah bahasa yang menjelaskan tampilan dan format situs web. Seperti halnya HTML, yang merupakan bahasa markup. CSS adalah sesuatu seperti "make-up" dari situs web Kita. ;)
+
+Tapi kita tidak ingin memulai dari nol lagi kan? Sekali lagi, kita akan menggunakan sesuatu yang dirilis oleh programer dan tersedia secara gratis di Internet. Seperti istilah "Reinventing the wheel (Menemukan kembali roda)" hal tersebut tidaklah menyenangkan.
+
+## Mari kita gunakan Bootstrap!
+
+Bootstrap adalah salah satu kerangka kerja HTML dan CSS yang paling populer untuk mengembangkan situs web yang indah: https://getbootstrap.com/
+
+Itu ditulis oleh programmer yang bekerja untuk Twitter. Sekarang dikembangkan oleh sukarelawan dari seluruh dunia!
+
+## Memasang Bootstrap
+
+Buka file `.html` Anda di editor kode Anda dan tambahkan berikut ini ke bagian `<head>` untuk menginstal bootstrap:
+
+{% filename%} blog / templates / blog / post_list.html {% endfilename%}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Ini tidak akan menambahkan file apa pun ke proyek Anda. Kode hanya merujuk ke file yang ada di Internet. Jadi buka dan *refresh* (muat ulang) situs web Anda. Inilah hasilnya!
+
+![Gambar 14.1](images/bootstrap1.png)
+
+Terlihat lebih menarikkan!
+
+## Static files di Django
+
+Akhirnya kita bisa lebih dekat dengan sesuatu yang dipanggil **static files** atau file statis. Statis file ini adalah semua hal yang berhubungan dengan CSS dan gambar. Kontennya tidak tergantung pada konteks permintaan, tetapi berlaku sama untuk semua pengguna.
+
+### Dimana menyimpan static files untuk Django
+
+Django sudah tahu di mana menemukan file statis untuk aplikasi "admin" bawaan. Sekarang kita hanya perlu menambahkan beberapa file statis untuk aplikasi kita sendiri, di dalam direktori `blog`.
+
+Lakukan dengan cara membuat folder bernama `static` di dalam direktori blog:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django secara otomatis akan menemukan folder yang disebut "static" di dalam folder aplikasi Anda. Dan kemudian file ini bisa digunakan isinya sebagai file statis.
+
+## File CSS pertamamu!
+
+Sekarang, mari kita buat file CSS, untuk mempercantik halaman web Anda. Buat sebuah folder bernama `css` di dalam folder `static`. Kemudian buat sebuah file bernama `blog.css` di dalam folder `css`. Siap?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Saatnya menulis CSS! Buka file `blog/static/css/blog.css` di editor kode Anda.
+
+Kita tidak akan terlalu mendalam mempelajari tentang CSS di sini. Bila ingin belajar lebih mendalam terkait CSS ini Anda bisa kunjungi [halaman ini](https://www.w3schools.com/css/).
+
+Tapi kita akan sedikit modifikasi. Mungkin kita akan mengubah warna *headers* kita. Untuk mengetahui warna, komputer menggunakan kode unik. Kode ini dimulai dengan ` # </ 0> diikuti oleh 6 huruf (A-F) dan angka (0-9). Misalnya, kode untuk warna biru adalah <code> #0000FF </ 0> . Anda dapat menemukan kode warna untuk berbagai warna di sini: http://www.colorpicker.com/. Kamu juga dapat menggunakan <a href="http://www.w3schools.com/colors/colors_names.asp">warna yang telah ditetapkan</a>, seperti <code>red` dan `green`.
+
+Dalam berkas `blog/static/css/blog.css` kamu mesti menambahkan kode seperti berikut:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` adalah selector dalam CSS. Ini berarti kita akan memberikan gaya pada setiap elemen `a` yang terdapat dalam elemen `h1`; begitu pula dengan selector `h2 a`, melakukan hal yang sama. Jadi ketika kita memiliki sesuatu seperti `<h1><a href="">link</a></h1>`, gaya elemen `h1 a` akanberubah. Dalam kasus ini, kita akan mengubah warnanya menjadi `#C25100`, ini menandakan warna jingga gelap. Atau kamu bisa memilih sendiri warnanya, tapi pastikan warna tersebut berbeda dengan warna putih dari latar!
+
+Dalam file CSS kita menentukan gaya untuk elemen yang berada pada file HTML. Mulanya kita menuliskan elemen dengan nama elemen itu sendiri. Kamu mungkin ingat ini merupakan tag dari HTML. Seperti `a`, `h1`, dan `body` adalah contoh dari nama elemen. Kita juga menuliskan elemen dengan atribut `class` atau atribut `id`. Nama class dan id ini dimaksudkan untuk elemen-elemen yang kita tuliskan. Class dimaksudkan untuk kumpulan elemen, dan id dimaksudkan untuk elemen tertentu. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Kamu bisa baca lebih lanjut tentang [CSS Selectors di w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+Kita juga mesti memberti tahu template HTML kita yang telah ditambahkan beberapa CSS. Buka file `blog/templates/blog/post_list.html` di kode editor dan tambahkan baris ini di paling atas dalam file tersebut:
+
+{% filename%} blog / templates / blog / post_list.html {% endfilename%}
+
+```html
+{% load static %}
+```
+
+Kita hanya perlu memuat file statisnya di sini. :) Di antara tag `<head>` dan `</head>`, setelah tautan ke file CSS Bootstrap, tambahkan baris ini:
+
+{% filename%}blog/templates/blog/post_list.html{% endfilename%}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Browser akan membaca file tersebut sesuai urutan, jadi kita perlu memastikan baris tersebut ada di posisi yang tepat. Jika tidak, kode dalam file kita mungkin akan diganti dengan kode dalam file Bootstrap. Kita baru saja menambahakan lokasi file template kita.
+
+Seharusnya isi dalam filenya seperti ini:
+
+{% filename%} blog / templates / blog / post_list.html {% endfilename%}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, simpan file dan segarkan situsnya!
+
+![Gambar 14.2](images/color2.png)
+
+Kerja bagus! Mungkin kita juga akan memberi sedikit ruang pada website kita dan menambahkan margin di sisi luar kiri? Coba ini!
+
+{% filename%} blog / static / css / blog.css {% endfilename%}
+
+```css
+body {
+     padding-left: 15px;
+}
+```
+
+Tambahkan ke CSS kamu, simpan dan lihat hasilnya!
+
+![Gambar 14.3](images/margin2.png)
+
+Mungkin kita bisa mengubah huruf di header kita? Tempelkan ini ke file kamu `<head>` di `blog/templates/blog/post_list.html`:
+
+{% filename%} blog / templates / blog / post_list.html {% endfilename%}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Seperti sebelumnya, periksa urutan dan tempat sebelum ditautkan ke `blog / static / css / blog.css`. Baris ini akan mengimpor huruf yang disebut *Lobster* dari Google Fonts (https://www.google.com/fonts).
+
+Temukan blok ini `h1 a` (kode antara tanda kurung `{` dan `}`) di file CSS `blog/static/css/blog.css`. Sekarang tambahkan baris `font-family: 'Lobster';` di antara kurung kurawal, dan segarkan halamannya:
+
+{% filename%}blog/static/css/blog.css{% endfilename%}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Gambar 14.3](images/font.png)
+
+Bagus!
+
+Seperti disebutkan di atas, CSS memiliki konsep class. Ini memungkinkan kamu memberi atribut ke dalam bagian kode HTML dan mempercantik hanya pada elemen tertentu, sehingga tidak memengaruhi elemen lain. Ini bisa sangat membantu! Mungkin kamu memiliki dua `div` dengan fungsi berbeda (seperti header dan postingan kamu). Sebuah class dapat membantu kamu membuatnya telihat berbeda.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename%}blog/templates/blog/post_list.html{% endfilename%}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Kami sekarang akan menambahkan blok deklarasi ke penyeleksi yang berbeda. Pemilih dimulai dengan ` . </ 0> berhubungan dengan kelas. Ada banyak tutorial dan penjelasan bagus tentang CSS di Web yang dapat membantu Anda memahami kode berikut. Untuk saat ini, cukup copy dan paste ke file <code>blog/static/css/blog.css` Anda:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Kode HTML yang bertanggung jawab untuk menampilkan posting blog harus diperluas oleh kelas. Ganti kode berikut:
+
+{% filename%} blog / templates / blog / post_list.html {% endfilename%}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+di `blog/templates/blog/post_list.html` dengan ini:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Simpan dan *refresh* (segarkan) halaman Anda.
+
+![Gambar 14.4](images/final.png)
+
+Woo hoo! Terlihat mengagumkan, kan? Lihatlah kode yang baru kita tempel untuk menemukan tempat di mana kita menambahkan kelas dalam HTML dan menggunakannya di CSS. Dimana Anda akan membuat perubahan, jika Anda ingin merubah warna tanggal menjadi turquoise?
+
+Jangan takut untuk bermain-main dengan file CSS dan mencoba mengubah beberapa hal. Bermain dengan CSS dapat membantu Anda memahami hal-hal yang lain. Jangan khawatir jika sesuatu rusak, Anda selalu dapat balik ke masa lalu dengan cara *undo*!
+
+Kami sangat merekomendasikan untuk mengambil kursus gratis "Basic HTML & HTML5" dan "Basic CSS" di [freeCodeCamp](https://learn.freecodecamp.org/). Kursus itu bisa membantu kamu untuk belajar cara membuat website yang lebih cantik dengan HTML dan CSS.
+
+Siap untuk bab berikutnya ?! :)
\ No newline at end of file
diff --git a/id-ID/deploy/README.md b/id-ID/deploy/README.md
new file mode 100644
index 00000000000..11ea616da3e
--- /dev/null
+++ b/id-ID/deploy/README.md
@@ -0,0 +1,249 @@
+# Peluncuran (Deploy)!
+
+> **Catatan** Bab berikut mungkin terasa agak sulit untuk dipahami. Lanjutkan sampai selesai; proses deploy merupakan proses yang penting pada proses pengembangan website. Bab ini sengaja diletakkan di bagian tengah tutorial ini dengan harapan agar pendamping anda, kalau ada, dapat membantu anda menjadikan website anda online, dengan sedikit trik. Ini artinya, anda masih dapat menyelesaikan sendiri tutorial ini kalau-kalau anda tak lagi punya cukup waktu.
+
+Sampai sekarang, situs Anda hanya tersedia di komputer Anda. Sekarang Anda akan belajar bagaimana cara menggunakannya! Proses deploy adalah proses mempublikasikan aplikasi anda di Internet agar orang lain dapat membuka dan melihat aplikasi anda. :)
+
+Sebagaimana yang telah anda pelajari, sebuah website haruslah diletakkan pada server. Ada banyak penyedia server di internet, kita akan menggunakan [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere tidak berbayar untuk aplikasi kecil yang tidak memiliki terlalu banyak pengunjung sehingga pasti akan cukup untuk anda sekarang.
+
+Layanan eksternal lain akan menggunakan [GitHub](https://www.github.com), yang merupakan sebuah layanan hosting kode program. Ada beberapa yang lain, akan tetapi hampir semua programmer saat ini memiliki akun di GitHub, anda berikutnya.
+
+Ketiga tempat ini penting bagi Anda. Komputer lokal Anda akan menjadi tempat pengembangan dan pengujian Anda. Bila Anda senang dengan perubahan tersebut, Anda akan menempatkan salinan program Anda di GitHub. Situs Anda akan berada di PythonAnywhere dan Anda akan memperbaruinya dengan mendapatkan salinan kode Anda yang baru dari GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Memulai repositori Git kita
+
+Git mencatat perubahan atas file-file yang disebut repositori kode (atau disingkat "repo" saja). Mari kita mulai untuk proyek kita. Buka konsole dan jalankan perintah ini dalam direktori`djangogirl`:
+
+> ** Catatan </ 0> Periksa direktori kerja Anda saat ini dengan perintah ` pwd </ 1> (Mac OS X / Linux) atau <code> cd </ 1> (Windows) sebelum menginisialisasi repositori. Anda harus berada di dalam folder <code>djangogirl`.</p> </blockquote> 
+> 
+> {% filename%} baris perintah {% endfilename%}
+> 
+>     $ git init
+>     Initialized empty Git repository in ~/djangogirls/.git/
+>     $ git config --global user.name "Nama Anda"
+>     $ git config --global user.email anda@contoh.com
+>      
+>     
+> 
+> Menginisialisasi repositori git adalah sesuatu yang perlu kita lakukan hanya sekali per proyek (dan Anda tidak perlu memasukkan kembali nama pengguna dan email itu lagi).
+> 
+> Git akan mencatat perubahan atas semua file dan folder yang ada dalam direktori ini, tetapi ada beberapa file yang ingin kita abaikan. Kita melakukan ini dengan cara membuat sebuah file yang diberi nama `.fitignore`, dalam direktori utama. Jalankan program editor anda kemudian buat sebuah file baru dengan isi :
+> 
+> {% filename%} .gitignore {% endfilename%}
+> 
+>     # Python
+>     *.pyc
+>     *~
+>     __pycache__
+>     
+>     # Env
+>     .env
+>     myvenv/
+>     venv/
+>     
+>     # Database
+>     db.sqlite3
+>     
+>     # Static folder at project root
+>     /static/
+>     
+>     # macOS
+>     ._*
+>     .DS_Store
+>     .fseventsd
+>     .Spotlight-V100
+>     
+>     # Windows
+>     Thumbs.db*
+>     ehthumbs*.db
+>     [Dd]esktop.ini
+>     $RECYCLE.BIN/
+>     
+>     # Visual Studio
+>     .vscode/
+>     .history/
+>     *.code-workspace
+>     
+> 
+> Dan simpan sebagai ` .gitignore </ 0> di folder "djangogirls".</p>
+
+<blockquote>
+  <p><strong>Catatan</strong> Titik di depan nama file sangat penting!  Jika anda mengalami kesulitan membuat nama file semacam ini (Karena Mac tidak suka jika anda membuat nama file yang diawali dengan titik lewat Finder, ini contoh kasus), maka pilih fitur "Save As" pada editor anda, yang seharusnya selalu berfungsi. Penting bahwa Anda tidak mengisi nama file dengan <code>.txt`, `.py` atau ekstensi nama file lainnya - file hanya akan dikenali oleh Git jika namanya persis `.gitignore`. Linux dan MacOS memperlakukan file-file dengan nama yang diawali oleh `.` (seperti `.gitignore`) sebagai file yang tersembunyi dan `ls` biasa tidak akan memperlihatkan file-file ini. Gunakan `ls -a` untuk melihat file `.gitignore`. 
+> 
+> ** Catatan </ 0> Salah satu file yang ditentukan dalam Anda ` Gitignore </ 1> file <code> db.sqlite3 </ 1> . File ini adalah basis data lokal Anda tempat semua pengguna dan posting Anda disimpan. Kami akan mengikuti praktik umum pengembangan web, yang berarti kami akan menggunakan basis data terpisah untuk situs web pengujian lokal kami dan situs web publik kami di PythonAnywhere. Basis data PythonAnywhere bisa berupa SQLite, seperti pada mesin pengembangan Anda, tetapi biasanya Anda akan menggunakan apa yang disebut basis data MySQL, yang dapat menangani lebih banyak pengunjung daripada SQLite. Bagaimanapun, dengan tidak menggunakan database SQLite Anda untuk salinan GitHub, semua posting superuser Anda sebelumnya hanya akan tersedia secara lokal, dan Anda harus menambahkan yang baru di lingkungan produksi. Anda harus memikirkan database lokal Anda sebagai taman bermain yang bagus di mana Anda dapat menguji berbagai hal dan tidak takut bahwa Anda akan menghapus posting sebenarnya dari blog Anda.</p>
+</blockquote>
+
+<p>Sebaiknya cek status dulu dengan perintah <code>git status` sebelum melakukan `git add` atau kapanpun anda ingin memastikan apa yang telah berubah. Ini akan membantu mencegah kejutan terjadi, seperti file yang salah ditambahkan atau dilakukan. Perintah ` git status </ 0> mengembalikan informasi tentang file yang tidak dilacak / dimodifikasi / dipentaskan, status cabang, dan banyak lagi. Keluarannya harus serupa dengan berikut ini:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>$ git status
+On branch master
+
+No commits yet
+
+Untracked files:
+  (use "git add <file>..." to include in what will be committed)
+
+        .gitignore
+        blog/
+        manage.py
+        mysite/
+        requirements.txt
+
+nothing added to commit but untracked files present (use "git add" to track)
+`</pre> 
+> 
+> Dan akhirnya kita simpan perubahan kita. Buka konsole dan jalankan perintah-perintah berikut:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ git add .
+>     $ git commit -m "My Django Girls app, first commit"
+>      [...]
+>      13 files changed, 200 insertions(+)
+>      create mode 100644 .gitignore
+>      [...]
+>      create mode 100644 mysite/wsgi.py
+>     
+> 
+> ## Memasukkan kode Anda ke GitHub
+> 
+> Pergi ke [GitHub.com](https://www.github.com) dan daftar secara gratis untuk akun yang baru. (Jika Anda sudah mengaturnya selama persiapan lokakarya, itu bagus!) Pastikan Anda tidak lupa kata sandi Anda (tambahkan ke kata sandi manager Anda, jika Anda menggunakannya).
+> 
+> Kemudian buat sebuah repositori baru, beri nama "my-first-blog". Biarkan kotak centang "initialize with a README" dan pengaturan opsi .gitignore kosong (Kita sudah melakukannya dengan manual) dan biarkan lisensi ditetapkan ke "None".
+> 
+> ![](images/new_github_repo.png)
+> 
+> > **Catatan** Nama `my-first-blog` sangat penting, tentu anda bisa saja memilih nama lain, akan tetapi nama tersebut akan selalu muncul lagi dan anda tentu akan repot harus selalu menggantinya. Jadi tak usah sulit-sulit, pakai saja nama `my-first-blog`.
+> 
+> Pada layar berikutnya, Anda akan diperlihatkan repo's clone URL Anda, yang akan Anda gunakan di beberapa perintah berikut:
+> 
+> ![](images/github_get_repo_url_screenshot.png)
+> 
+> Sekarang kita perlu menghubungkan Git repositori dalam komputer Anda ke dalam GitHub.
+> 
+> Ketik perintah berikut ini pada konsol (Gantilah `<your-github-username>` dengan nama user sesuai akun GitHub yang telah Anda buat, tetapi tanpa tanda kurung sudut):
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+>     $ git push -u origin master
+>     
+> 
+> Saat Anda push ke GitHub, Anda akan diminta untuk username dan password Github Anda (baik secara langsung di jendela baris perintah atau di jendela pop-up), dan setelah memasukkan kredensial Anda akan melihat sesuatu seperti ini:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Counting objects: 6, done.
+>     Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+>     Total 3 (delta 0), reused 0 (delta 0)
+>     To https://github.com/ola/my-first-blog.git
+>     
+>      * [new branch]      master -> master
+>     Branch master set up to track remote branch master from origin.
+>     
+> 
+> <!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+> 
+> Kode Anda sekarang ada di GitHub. Silahkan anda cek! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+> 
+> # Mengatur situs Kita di PythonAnywhere
+> 
+> ## Mendaftar untuk PythonAnywhere
+> 
+> > **Catatan** Anda mungkin telah membuat akun PythonAnywhere sebelumnya selama langkah-langkah pemasangan - jika ya, Anda tidak perlu melakukannya lagi.
+> 
+> {% include "/deploy/signup_pythonanywhere.md" %}
+> 
+> ## Mengatur situs Kita di PythonAnywhere
+> 
+> Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+> 
+> ![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+> 
+> > **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+> 
+> Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+> 
+> {% filename %}PythonAnywhere command-line{% endfilename %}
+> 
+>     $ pip3.8 install --user pythonanywhere
+>     
+> 
+> That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+> 
+> Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+> 
+> {% filename %}PythonAnywhere command-line{% endfilename %}
+> 
+>     $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+>     
+> 
+> As you watch that running, you'll be able to see what it's doing:
+> 
+> - Downloading your code from GitHub
+> - Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+> - Updating your settings file with some deployment settings
+> - Setting up a database on PythonAnywhere using the `manage.py migrate` command
+> - Setting up your static files (we'll learn about these later)
+> - And configuring PythonAnywhere to serve your web app via its API
+> 
+> On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+> 
+> The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+> 
+> {% filename %}PythonAnywhere command-line{% endfilename %}
+> 
+>     (ola.pythonanywhere.com) $ python manage.py createsuperuser
+>     
+> 
+> Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+> 
+> Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+> 
+> {% filename %}PythonAnywhere command-line{% endfilename %}
+> 
+>     (ola.pythonanywhere.com) $ ls
+>     blog  db.sqlite3  manage.py  mysite requirements.txt static
+>     (ola.pythonanywhere.com) $ ls blog/
+>     __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+>     tests.py  views.py
+>     
+> 
+> You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+> 
+> ## You are now live!
+> 
+> Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+> 
+> > **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+> 
+> ## Debugging tips
+> 
+> If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+> 
+> - Lupa membuat token API PythonAnywhere anda.
+> - Membuat kesalahan dalam URL GitHub anda
+> - Jika anda melihat kesalahan yang mengatakan *"Tidak dapat menemukan settings.py anda"*, mungkin karena anda tidak berhasil menambahkan semua berkas anda ke Git, dan / atau anda tidak mendorongnya ke GitHub berhasil. Lihat lagi bagian Git di atas
+> - If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+> 
+> If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+> 
+> There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+> 
+> And remember, your coach is here to help!
+> 
+> # Periksa situs Anda!
+> 
+> The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+> 
+> Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+> 
+> Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/id-ID/deploy/install_git.md b/id-ID/deploy/install_git.md
new file mode 100644
index 00000000000..c737dae799d
--- /dev/null
+++ b/id-ID/deploy/install_git.md
@@ -0,0 +1,50 @@
+Git adalah "version control system" yang digunakan oleh banyak sekali programmer. Software ini dapat mencatat perubahan file dari waktu ke waktu sehingga anda dapat mencari versi tertentu di kemudian hari. Ini mirip dengan fitur "track changes" di pengolah kata (seperti Microsoft Word atau LibreOffice Writer), tetapi jauh lebih powerful.
+
+## Menginstal Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Kamu dapat mengunduh Git dari [git-scm.com](https://git-scm.com/). Anda bisa menekan "next" di semua langkah kecuali satu; pada langkah kelima yang berjudul ""Adjusting your PATH environment", pilih "Use Git and optional Unix tools from the Windows Command Prompt" (opsi paling bawah). Akan tetapi membiarkan pilihan-pilihan tersebut dalam keadaan default juga tidak masalah. Lihat pada Window-style, akhir baris Unix-style yang ada terlhat bagus.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git dari [git-scm.com](https://git-scm.com/) dan ikuti perintah yang diberikan.
+
+> ** Catatan </ 0> Jika Anda menjalankan OS X 10.6, 10.7, atau 10.8, Anda perlu menginstal versi git dari sini:  Git installer untuk OS X Snow Leopard </ 1></p> </blockquote> <!--endsec-->
+> 
+> <!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+> ```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/id-ID/deploy/signup_pythonanywhere.md b/id-ID/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..d7b86fa1622
--- /dev/null
+++ b/id-ID/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+Sedang terjadi pengularan layanan di dalam kode server "membetuk awan". baik, kami akan menggunakan rumah ini, sebagai tempat tinggal dalam internet.
+
+Kami akan menjadikan rumah blog dalam membangun pyhtonAnywhere. cara mendaftar akun untuk pemula di PythonAnywhere ( tenang, semuanya gratis, kamu tidak perlu membayar).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![Di halaman PythonAnywhere menunjukkan cara untuk membuat 'pemula' akun](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Juga,untuk mengingat kode rahasia kamu ( tambahkan di pengelola kode rahasia,jika hanya menggunakan satu).
+
+## Membuat token API PythonAnywhere
+
+Hanya dapat dilakukan satu kali. jika kamu mendaftar PythonAnywhere, kamu akan terdaftar di laman depan. Temukan link yang ada di kanan atas akun halamanmu:
+
+![Akun link di kanan atas halaman](../deploy/images/pythonanywhere_account.png)
+
+lalu pilih menu "API token", dan tekan yang bertuliskan buat "API token baru".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/id-ID/django/README.md b/id-ID/django/README.md
new file mode 100644
index 00000000000..8d815e1fcc6
--- /dev/null
+++ b/id-ID/django/README.md
@@ -0,0 +1,27 @@
+# Apa itu Django?
+
+Django (/ dʒæŋɡoʊ/ *jang-goh*) adalah framework aplikasi web open source dan open source yang ditulis dengan Python. Sebuah framework web adalah sebuah set komponen-komponen yang dapat membantu anda untuk mengembangkan website dengan lebih cepat dan mudah.
+
+Ketika anda sedang membangun sebuah website, anda akan selalu berurusan dengan hal-hal serupa misalnya bagaimana menangani autentikasi user (sign up, sign in dan sign out), panel pengelolaan website, form-form, bagaimana mengupload file dan sebagianya.
+
+Beruntung bagi Anda, orang lain lama sekali menyadari bahwa pengembang web menghadapi masalah yang sama saat membangun situs baru, jadi mereka bekerja sama dan menciptakan kerangka kerja (Django menjadi salah satunya) yang memberi Anda komponen siap pakai untuk digunakan.
+
+Kerangka ada untuk menyelamatkan Anda dari keharusan menemukan kembali kemudi dan membantu meringankan sebagian overhead saat Anda membangun situs baru.
+
+## Mengapa anda memerlukan sebuah framework?
+
+Untuk memahami apa sebenarnya Django, kita perlu melihat lebih dekat pada server. Hal pertama adalah bahwa server perlu tahu bahwa Anda ingin melayani Anda sebuah halaman web.
+
+Bayangkanlah sebuah mailbox/kotak surat (port), yang selalu dimonitor untuk mengetahui apakah ada surat masuk (request). Ini dikerjakan oleh server. Server web membaca surat tersebut dan kemudian mengirimkan tanggapan dengan sebuah halaman web. Akan tetapi, ketika anda ingin mengirimkan sesuatu, anda perlu menyiapkan isinya. Dan django akan membantu anda membuat isinya.
+
+## Apa yang terjadi ketika seseorang membuka halaman web di server anda?
+
+Ketika permintaan datang ke server web, itu diteruskan ke Django yang mencoba untuk mencari tahu apa yang sebenarnya diminta. Dibutuhkan alamat halaman web terlebih dahulu dan mencoba untuk mencari tahu apa yang harus dilakukan. Bagian ini dilakukan oleh Django **urlresolver** (perhatikan bahwa alamat situs web disebut URL - Uniform Resource Locator - jadi nama *urlresolver* masuk akal). Ini tidak terlalu cerdas - dibutuhkan daftar pola dan mencoba mencocokkan URL. Django memeriksa pola dari atas ke bawah dan jika ada yang cocok, maka Django meneruskan permintaan ke fungsi yang terkait (yang disebut *view*).
+
+Bayangkanlah ada petugas pengantar surat membawa sebuah surat. Ia menelusuri jalan dan mengecek tiap nomor rumah apakah cocok dengan alamat pada surat. Jika cocok, ia akan mengantarkan ke sana. Begitulah cara kerja urlresolver!
+
+Pada fungsi *view*, semua hal menarik dilakukan: kita bisa melihat database untuk mencari beberapa informasi. Munkin si user ingin mengubah data? Seperti sepucuk surat yang berbunyi, "Tolong ubah deskripsi pekerjaan saya." The *pandangan* dapat memeriksa apakah Anda diperbolehkan untuk melakukan itu, kemudian memperbarui deskripsi pekerjaan untuk Anda dan mengirim kembali pesan: "! Selesai" Kemudian *pandangan* menghasilkan respon dan Django dapat mengirimkannya ke web browser pengguna.
+
+Deskripsi di atas agak disederhanakan, tapi Anda tak perlu tahu segala sesuatu yang sangat teknis dulu. Mengerti yang umum-umum dulu sudah cukup.
+
+Jadi, kita tidak akan belajar segala sesuatunya langsung secara detail, tetapi kita akan mulai membuat sesuatu dengan Django dan kita akan belajar semua hal penting sambil berjalan!
\ No newline at end of file
diff --git a/id-ID/django_admin/README.md b/id-ID/django_admin/README.md
new file mode 100644
index 00000000000..a552e74a54b
--- /dev/null
+++ b/id-ID/django_admin/README.md
@@ -0,0 +1,57 @@
+# Admin Django
+
+Untuk menambahkan, mengedit dan menghapus tulisan yang baru saja kita telusuri, kita akan menggunakan admin Django.
+
+Mari buka berkas `blog/admin.py` dalam editor kode dan ganti isinya dengan ini:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Sebagaimana dapat Anda lihat, kita mengimpor (include) model Post yang telah didefinisikan di bab sebelumnya. Agar model kita tampil pada halaman admin, kita perlu mendaftarkan model tersebut dengan `admin.site.register(Post)`.
+
+Oke, saatnya kita lihat model Post kita. Ingat untuk menjalankan `python manage.py runserver` di konsol untuk menjalankan web server. Buka browser Anda dan ketikkan alamat http://127.0.0.1:8000/admin/. Anda akan melihat halaman login seperti ini:
+
+![Halaman masuk](images/login_page2.png)
+
+Untuk masuk, Anda perlu membuat * superuser </ 0> - akun pengguna yang memiliki kontrol atas segala hal di situs. Go back to the command line, type `python manage.py createsuperuser`, and press enter.</p> 
+
+> Ingat, untuk menulis perintah baru saat server web berjalan, buka jendela terminal baru dan aktifkan virtualenv Anda. Kami meninjau bagaimana menulis perintah baru di ** proyek Django pertama Anda! </ 0> bab, di bagian ** Starting the web server </ 0> .</p> </blockquote> 
+> 
+> {% filename %}Mac OS X atau Linux:{% endfilename %}
+> 
+>     (myvenv) ~/djangogirls$ python manage.py createsuperuser
+>     
+> 
+> {% filename %}Windows:{% endfilename %}
+> 
+>     (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+>     
+> 
+> Saat diminta, ketik nama akun anda (huruf kecil, tidak ada spasi), alamat email, dan kata sandi. **Jangan khawatir ketika Anda tidak dapat melihat kata sandi yang Anda ketik - begitulah semestinya.** Ketik saja dan tekan `enter` untuk melanjutkan. Keluarannya akan terlihat seperti ini (dimana nama akun dan emailnya seharusnya adalah milik Anda):
+> 
+>     Nama pengguna: ola
+>     Alamat email: ola@example.com
+>     Kata sandi:
+>     Kata sandi (lagi):
+>     Superuser sukses dibuat.
+>     
+> 
+> Kembali ke browser Anda. Masuklah dengan kredensial superuser yang Anda pilih; Anda harus melihat dasbor admin Django.
+> 
+> ![Admin Django](images/django_admin3.png)
+> 
+> Pergilah ke Posts dan bereksperimenlah sedikit dengannya. Tambahkan lima atau enam posting blog. Jangan khawatir tentang isi -- ini hanya tampak ke Anda pada komputer lokal Anda - Anda dapat menyalin-tempel sebagian teks dari tutorial ini untuk menghemat waktu. :)
+> 
+> Pastikan paling tidak ada dua atau tiga postingan (tapi tidak semua) yang memiliki tanggal terbitan. Ini akan sangat membantu nantinya.
+> 
+> ![Admin Django](images/edit_post3.png)
+> 
+> Jika Anda ingin tahu lebih banyak tentang admin Django, Anda harus memeriksa dokumentasi Django: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+> 
+> Ini mungkin saja saat yang tepat untuk minum kopi (atau teh) atau sesuatu yang bisa dimakan untuk mengembalikan tenaga anda. Anda menciptakan model Django yang pertama - Anda layak untuk sedikit beristirahat!
\ No newline at end of file
diff --git a/id-ID/django_forms/README.md b/id-ID/django_forms/README.md
new file mode 100644
index 00000000000..b399c87f7be
--- /dev/null
+++ b/id-ID/django_forms/README.md
@@ -0,0 +1,475 @@
+# Form Django
+
+Hal penting terakhir yang akan kita lakukan adalah bagaimana membuat agar user dapat menambah dan mengedit post blog dengan mudah. `Admin` django sudah bagus, tapi sedikit sulit untuk meng-customize dan membuatnya lebih cantik. Dengan ` bentuk </ 0> kita akan memiliki kekuatan mutlak atas antarmuka kita - kita dapat melakukan hampir semua hal yang dapat kita bayangkan!</p>
+
+<p>Bagusnya form django adalah bahwa kita dapat mendefinisikannya dengan mudah atau dengan membuat sebuah <code>ModelForm` yang akan memberikan keluaran form tersebut ke dalam model terkait.
+
+Ini benar-benar merupakan hal yang kita ingin lakukan. Kita akan membuat sebuah form yang kita tujukan untuk model `Post` kita.
+
+Sama seperti tiap bagian penting dari Django, form memiliki file sendiri, yaitu forms.py.
+
+Kita perlu membuat sebuah file dengan nama tersebut di dalam directory `blog`.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename%} blog / forms.py {% endfilename%}
+
+```python
+dari bentuk impor Django dari .Models import Post class PostForm (forms.ModelForm):
+
+     class Meta:
+         model = Post
+         fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, sebagaimana yang barangkali anda duga, adalah nama form kita. Kita perlu memberi tahu Django bahwa bentuk ini adalah ` ModelForm </ 0> (jadi Django akan melakukan sihir untuk kita) - <code> forms.ModelForm </ 0> bertanggung jawab untuk itu.</p>
+
+<p>Selanjutnya, kita memiliki <code>class Meta` dimana kita memberitahu django model yang mana yang harus digunakan untuk menciptakan form ini (`model=post`).
+
+Akhirnya, kita dapat menyatakan field-field mana yang akan muncul di dalam form kita. Dalam skenario ini kita hanya ingin ` title </ 0> dan <code> text </ 0> yang akan terbuka - <code> author </ 0> harus menjadi orang yang saat ini masuk (Anda!) Dan < 0> create_date </ 0> harus disetel secara otomatis saat kita membuat sebuah posting (yaitu dalam kode), bukan?</p>
+
+<p>Begitulah caranya! Yang kita perlu lakukan sekarang adalah menggunakan <em>view</em> dan menampilkannya di dalam sebuah template.</p>
+
+<p>Jadi sekali lagi kita akan membuat link ke halaman, URL, tampilan dan template.</p>
+
+<h2>Mengarahkan link menuju sebuah halaman dengan Form</h2>
+
+<p>Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download <a href="https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg">file-earmark-plus.svg</a> and save it in the folder <code>blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## view post_view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+dari .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new (request):
+     form = PostForm ()
+     mengembalikan render (request, 'blog / post_edit.html', {'form': form} )
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Kita perlu sebuah tombol `Save`. Kita lakukan hal itu dengan sebuah tombol HTML: `<button type="submit">Save</button>`.
+* Dan akhirnya, tepat setelah tag pembuka `<form ...>` kita perlu menambahkan {% raw%} ` {% csrf_token%} </ 1> {% endraw%} . Ini sangat penting, karena akan menjadikan form anda aman! Jika Anda lupa sedikit ini, Django akan mengeluh saat Anda mencoba menyimpan formulir:</li>
+</ul>
+
+<p><img src="images/csrf2.png" alt="CSFR Forbidden page" /></p>
+
+<p>OK, so let's see how the HTML in <code>post_edit.html` should look:</p> 
+    {% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+    
+    ```html
+    {% extends 'blog/base.html' %}
+    
+    {% block content %}
+        <h2>New post</h2>
+        <form method="POST" class="post-form">{% csrf_token %}
+            {{ form.as_p }}
+            <button type="submit" class="save btn btn-default">Save</button>
+        </form>
+    {% endblock %}
+    ```
+    
+    Time to refresh! Yay! Your form is displayed!
+    
+    ![New form](images/new_form2.png)
+    
+    But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+    
+    Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+    
+    The answer is: nothing. We need to do a little bit more work in our *view*.
+    
+    ## Menyimpan Form
+    
+    Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+    
+    {% filename %}blog/views.py{% endfilename %}
+    
+    ```python
+    def post_new (request):
+         form = PostForm ()
+         mengembalikan render (request, 'blog / post_edit.html', {'form': form} )
+    ```
+    
+    When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+    
+    So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+    
+    {% filename %}blog/views.py{% endfilename %}
+    
+    ```python
+    jika request.method == "POST":
+     [...] 
+    else:
+     form = PostForm ()        
+    ```
+    
+    It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+    
+    {% filename %}blog/views.py{% endfilename %}
+    
+    ```python
+    form = PostForm (request.POST)
+    ```
+    
+    The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+    
+    We check if the form is valid and if so, we can save it!
+    
+    {% filename %}blog/views.py{% endfilename %}
+    
+    ```python
+    jika form.is_valid ():
+         post = form.save (komit = salah)
+         post.author = request.user
+         post.published_date = timezone.now ()
+         post.save () post.save ()
+    ```
+    
+    Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+    
+    Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+    
+    {% filename %}blog/views.py{% endfilename %}
+    
+    ```python
+    dari django.shortcuts import redirect
+    ```
+    
+    Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+    
+    {% filename %}blog/views.py{% endfilename %}
+    
+    ```python
+    pengalihan kembali ('post_detail', pk = post.pk)
+    ```
+    
+    `post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+    
+    OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+    
+    {% filename %}blog/views.py{% endfilename %}
+    
+    ```python
+    def post_new (request):
+         if request.method == "POST":
+             form = PostForm (request.POST)
+             jika form.is_valid ():
+                 post = form.save (commit = false)
+                 post.author = request.user
+                 post.             publish_date = timezone.now ()
+     post.save ()
+                 pengalihan kembali ('post_detail', pk = post.pk)
+         else:
+             form = PostForm ()
+         mengembalikan render (permintaan, 'blog / post_edit.html', {'form': bentuk} )
+    ```
+    
+    Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+    
+    You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+    
+    That is awesome!
+    
+    > As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+    
+    ![Logged in error](images/post_create_error.png)
+    
+    ## Validasi Form
+    
+    Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+    
+    Try to save the form without `title` and `text`. Guess what will happen!
+    
+    ![Form validation](images/form_validation2.png)
+    
+    Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+    
+    ## Form Edit
+    
+    Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+    
+    First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+    
+    Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+    
+    {% filename%} blog / templates / blog / post_detail.html {% endfilename%}
+    
+    ```html
+    <aside class="actions">
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+          {% include './icons/pencil-fill.svg' %}
+        </a>
+    </aside>
+    ```
+    
+    so that the template will look like this:
+    
+    {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+    
+    ```html
+    {% extends 'blog/base.html' %}
+    
+    {% block content %}
+        <article class="post">
+            <aside class="actions">
+                <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                    {% include './icons/pencil-fill.svg' %}
+                </a>
+            </aside>
+            {% if post.published_date %}
+                <time class="date">
+                    {{ post.published_date }}
+                </time>
+            {% endif %}
+            <h2>{{ post.title }}</h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endblock %}
+    ```
+    
+    Open `blog/urls.py` in the code editor, and add this line:
+    
+    {% filename %}blog/urls.py{% endfilename %}
+    
+    ```python
+        path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+    ```
+    
+    We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+    
+    Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+    
+    {% filename%} blog / views.py {% endfilename%}
+    
+    ```python
+    def post_edit (request, pk):
+         post = get_object_or_404 (Post, pk = pk)
+         jika request.method == "POST":
+             form = PostForm (request.POST, instance = post)
+             if form.is_valid ():
+                 post = form .save (commit = False)
+                 post.author = request.user
+                 post.published_date = timezone.now ()
+                 post.save ()
+                 pengalihan kembali ('post_detail', pk = post.pk)
+         else:
+             form = PostForm (instance = post )
+         mengembalikan render (permintaan, 'blog / post_edit.html', {'form': form} )
+    ```
+    
+    This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+    
+    {% filename%} blog / views.py {% endfilename%}
+    
+    ```python
+    form = PostForm (request.POST, instance = post)
+    ```
+    
+    …and when we've just opened a form with this post to edit:
+    
+    {% filename %}blog/views.py{% endfilename %}
+    
+    ```python
+    form = PostForm (contoh = post)
+    ```
+    
+    OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+    
+    ![Edit button](images/edit_button2.png)
+    
+    When you click it you will see the form with our blog post:
+    
+    ![Edit form](images/edit_form2.png)
+    
+    Feel free to change the title or the text and save the changes!
+    
+    Congratulations! Your application is getting more and more complete!
+    
+    If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+    
+    ## Keamanan
+    
+    Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+    
+    Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+    
+    {% filename%} blog / templates / blog / base.html {% endfilename%}
+    
+    ```html
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+    ```
+    
+    We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+    
+    {% filename %}blog/templates/blog/base.html{% endfilename %}
+    
+    ```html
+    {% if user.is_authenticated %}
+        <a href="{% url 'post_new' %}" class="top-menu">
+            {% include './icons/file-earmark-plus.svg' %}
+        </a>
+    {% endif %}
+    ```
+    
+    This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+    
+    Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+    
+    Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+    
+    {% filename%} blog / templates / blog / post_detail.html {% endfilename%}
+    
+    ```html
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+    </a>
+    ```
+    
+    Change it to this:
+    
+    {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+    
+    ```html
+    {% if user.is_authenticated %}
+         <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+            {% include './icons/pencil-fill.svg' %}
+         </a>
+    {% endif %}
+    ```
+    
+    Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+    
+    ## Satu hal lagi: saatnya melakukan deploy!
+    
+    Let's see if all this works on PythonAnywhere. Time for another deploy!
+    
+    * First, commit your new code, and push it up to GitHub:
+    
+    {% filename %}command-line{% endfilename %}
+    
+        $ git status
+        $ git add .
+        $ git status
+        $ git commit -m "Added views to create/edit blog post inside the site."
+        $ git push
+        
+    
+    * Kemudian dalam konsol Bash [PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+        $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+        $ git pull
+        [...]
+        
+    
+    (Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+    
+    * Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+    
+    And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/id-ID/django_installation/README.md b/id-ID/django_installation/README.md
new file mode 100644
index 00000000000..0327fb9ee49
--- /dev/null
+++ b/id-ID/django_installation/README.md
@@ -0,0 +1,7 @@
+# Installasi Django
+
+> ** Catatan </ 0> Jika Anda menggunakan Chromebook, lewati bab ini dan pastikan Anda mengikuti petunjuk  Pengaturan Chromebook </ 1> .</p> 
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!</blockquote> 
+> 
+> {% include "/django_installation/instructions.md"%}
\ No newline at end of file
diff --git a/id-ID/django_installation/instructions.md b/id-ID/django_installation/instructions.md
new file mode 100644
index 00000000000..790e33bbd43
--- /dev/null
+++ b/id-ID/django_installation/instructions.md
@@ -0,0 +1,233 @@
+> Bagian dari bagian ini didasarkan pada tutorial oleh Geek Girls Wortel (https://github.com/ggcarrots/django-carrots).
+> 
+> Bagian dari bagian ini didasarkan pada tutorial  Django-marcador </ 0> yang berlisensi di bawah Lisensi Internasional Creative Commons Attribution-ShareAlike 4.0. Hak cipta tutorial django-marcador oleh Markus Zapke-Gründemann et al.</p> </blockquote> 
+> 
+> ## Virtual Environment
+> 
+> Sebelum anda menginstal django, anda akan mempelajari cara menginstall tool yang sangat penting untuk menjaga pengembangan komputer anda secara teratur. Dimungkinkan untuk melewati bagian ini, tapi sangat dianjurkan untuk tidak melewatinya. Dimulai dengan setup sebaik mungkin akan menghindarkan anda dari banyak kesulitan di masa yang akan datang.
+> 
+> Karena itu, mari membuat sebuah **virtual environment** (juga disebut *virtualenv*). Virtualenv akan memisahkan setup Python/Django untuk tiap proyek. Ini artinya bahwa suatu perubahan yang anda buat pada sebuah website, tidak akan mempengaruhi website lain yang juga sedang anda kembangkan. Jelas bukan ?
+> 
+> Yang perlu anda kerjakan adalah menemukan sebuah direktory dimana anda ingin menciptakan `virtualenv`, yaitu home directory anda, ini sebagai misal. Pada Windows, mungkin terlihat seperti `C:\Users \ Name` (dimana`Nama` merupakan nama login anda).
+> 
+> > **CATATAN: ** Pada Windows, pastikan petunjuk ini tidak mengandung karakter beraksen atau karakter khusus; Jika nama pengguna anda mengandung karakter beraksen, gunakan petunjuk yang berbeda, misalnya, `C:\ jangogirls`.
+> 
+> Karena tutorial ini akan menggunakan sebuah direktory baru yaitu `djangogirls`, dari home direktory anda:
+> 
+> {% filename%} baris perintah {% endfilename%}
+> 
+>     $ mkdir djangogirls $ cd djangogirls
+>     
+> 
+> Kita akan membuat sebuah virtualenv dengan nama `myenv`. Bentuk perintah umumnya seperti ini:
+> 
+> {% filename%} baris perintah {% endfilename%}
+> 
+>     $ python3 -m venv myvenv
+>     
+> 
+> <!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+> 
+> Untuk membuat new ` virtualenv </ 0> , Anda perlu membuka command prompt dan menjalankan <code> python -m venv myvenv </ 0> . Ini akan terlihat seperti ini:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>C: \ Users \ Name \ djangogirls & gt; python -m venv myvenv
+`</pre> 
+> 
+> Dimana ` myvenv </ 0> adalah nama <code> virtualenv </ 0> Anda . Anda boleh menggunakan nama yang lain, tapi harus menggunakan huruf kecil dan tanpa spasi, karakter khusus ataupun tanda petik. It is also a good idea to keep the name short – you'll be referencing it a lot!</p>
+
+<!--endsec-->
+
+
+> 
+> <!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+<p>Kita bisa menciptakan <code>virtualenv`pada Linux dan OS X dengan menjalankan 
+> 
+> `python3 -m venv myvenv`. Ini akan terlihat seperti ini:
+> 
+> {% filename%} baris perintah {% endfilename%}
+> 
+>     $ python3 -m venv myvenv
+>     
+> 
+> `myvenv` adalah nama dari `virtualenv` anda. Anda dapat menggunakan nama lain akan tetapi tetap gunakan huruf kecil dan tanpa spasi. Ini juga merupakan ide yang baik untuk menjaga agar nama tetap singkat seperti yang akan anda rujuk secara banyak!
+> 
+> > ** CATATAN: </ 0> Pada beberapa versi Debian / Ubuntu Anda mungkin menerima error berikut:</p> 
+> > 
+> > {% filename%} baris perintah {% endfilename%}
+> > 
+> >     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+> >        apt install python3-venv
+> >     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+> >     
+> > 
+> > Dalam kasus ini, ikuti petunjuk di atas dan pasang paket ` python3-venv </ 0> :
+ {% filename%} command-line {% endfilename%}  </p>
+
+<pre><code>$ sudo apt install python3-venv
+`</pre> 
+> > 
+> > ** CATATAN: </ 0> Pada beberapa versi Debian / Ubuntu yang memulai lingkungan virtual seperti saat ini memberikan error berikut:</p> 
+> > 
+> > {% filename %}baris perintah{% endfilename %}
+> > 
+> >     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+> >     
+> > 
+> > Untuk mengatasi hal ini, gunakan perintah `virtualenv`.
+> > 
+> > {% filename%} baris perintah {% endfilename%}
+> > 
+> >     $ sudo apt install python-virtualenv
+> >     $ virtualenv --python=python{{ book.py_version }} myvenv
+> >     
+> > 
+> > ** CATATAN: </ 0> Jika Anda mengalami error seperti</p> 
+> > 
+> > {% filename%} baris perintah {% endfilename%}
+> > 
+> >     E: Tidak dapat menemukan paket python3-venv
+> >     
+> > 
+> > lalu jalankan:
+> > 
+> > {% filename%} baris perintah {% endfilename%}
+> > 
+> >     sudo apt install python{{ book.py_version }}-venv
+> >     </blockquote> 
+> > 
+> > <!--endsec-->
+> > 
+> > ## Bekerja Dengan Virtualenv
+> > 
+> > The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+> > 
+> > <!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+> > 
+> > Aktifkan virtual environment anda dengan menjalankan:
+> > 
+> > {% filename%} baris perintah {% endfilename%}
+> > 
+> >     C: \ Users \ Name \ djangogirls & gt; myvenv \ Scripts \ activate
+> >     
+> > 
+> > > **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. Dalam kasus ini, buka Windows PowerShell lainnya dengan opsi "Run as Administrator". Kemudian coba ketikkan perintah berikut sebelum memulai lingkungan virtual Anda:
+> > > 
+> > > {% filename%} baris perintah {% endfilename%}
+> > > 
+> > >     C: \ WINDOWS \ system32 & gt; Set-ExecutionPolicy -ExecutionPolicy     Perubahan Kebijakan Eksekusi RemoteSigned
+> > >      Kebijakan
+> > >          eksekusi membantu melindungi Anda dari skrip yang tidak Anda percaya. Mengubah kebijakan eksekusi mungkin akan memaparkan risiko keamanan yang dijelaskan di topik bantuan about_Execution_Policies di http://go.microsoft.com/fwlink/?LinkID=135170. Apakah Anda ingin mengubah kebijakan eksekusi? [Y] Ya   [A] Ya untuk Semua   [N] Tidak   [L] Tidak untuk Semua   [S] Suspend [?] Help (defaultnya adalah "N"): A
+> > >     
+> > 
+> > <!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+> > 
+> > > **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> > > 
+> > >     $ . myvenv\Scripts\activate.ps1
+> > >     
+> > > 
+> > > The advantage is that you don't have to switch between editor windows and command-line windows
+> > 
+> > <!--endsec-->
+> > 
+> > <!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+> > 
+> > Start your virtual environment by running:
+> > 
+> > {% filename %}command-line{% endfilename %}
+> > 
+> >     $ source myvenv / bin / aktifkan
+> >     
+> > 
+> > Remember to replace `myvenv` with your chosen `virtualenv` name!
+> > 
+> > > **NOTE:** If the command `source` is not available, try doing this instead:
+> > > 
+> > > {% filename %}command-line{% endfilename %}
+> > > 
+> > >     $ . myvenv/bin/activate
+> > >     
+> > 
+> > <!--endsec-->
+> > 
+> > You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+> > 
+> > When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+> > 
+> > OK, we have all important dependencies in place. We can finally install Django!
+> > 
+> > ## Installing Django {#django}
+> > 
+> > Now that you have your `virtualenv` started, you can install Django.
+> > 
+> > Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+> > 
+> > {% filename %}command-line{% endfilename %}
+> > 
+> >     (myvenv) ~$ python -m pip install --upgrade pip
+> >     
+> > 
+> > ### Installing packages with requirements
+> > 
+> > A requirements file keeps a list of dependencies to be installed using `pip install`:
+> > 
+> > First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+> > 
+> >     djangogirls
+> >     ├── myvenv
+> >     │   └── ...
+> >     └───requirements.txt
+> >     
+> > 
+> > In your `djangogirls/requirements.txt` file you should add the following text:
+> > 
+> > {% filename %}djangogirls/requirements.txt{% endfilename %}
+> > 
+> >     Django~={{ book.django_version }}
+> >     
+> > 
+> > Now, run `pip install -r requirements.txt` to install Django.
+> > 
+> > {% filename %}command-line{% endfilename %}
+> > 
+> >     (myvenv) ~$ pip install -r requirements.txt
+> >     Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+> >       Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+> >     Installing collected packages: Django
+> >     Successfully installed Django-{{ book.django_version }}
+> >     
+> > 
+> > <!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+> > 
+> > > If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+> > 
+> > <!--endsec-->
+> > 
+> > <!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+> > 
+> > > Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> > > 
+> > > {% filename %}command-line{% endfilename %}
+> > > 
+> > >     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+> > >     
+> > 
+> > <!--endsec-->
+> > 
+> > <!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+> > 
+> > > If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+> > 
+> > <!--endsec-->
+> > 
+> > That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/id-ID/django_models/README.md b/id-ID/django_models/README.md
new file mode 100644
index 00000000000..b5ae006dddf
--- /dev/null
+++ b/id-ID/django_models/README.md
@@ -0,0 +1,185 @@
+# Model Django
+
+Apa yang akan kita buat sekarang adalah sesuatu untuk menyimpan semua postingan pada blog kita. tetapi untuk bisa melakukan hal itu kita akan sedikit membahas tentang `objects`.
+
+## Benda
+
+Ada konsep dalam pemrograman yang disebut ` pemrograman berorientasi obyek </ 0> . Idenya adalah bahwa alih-alih menulis segala sesuatu sebagai urutan instruksi pemrograman yang membosankan, kita dapat memodelkan berbagai hal dan menentukan bagaimana mereka berinteraksi satu sama lain.</p>
+
+<p>Jadi apa itu obyek? Ini adalah kumpulan properti dan tindakan. Kedengarannya aneh, tapi kami akan memberi contoh.</p>
+
+<p>Jika kita ingin model kucing, kita akan membuat objek <code> Cat </ 0> yang memiliki beberapa properti seperti <code> warna </ 0> , <code> usia </ 0> , <code> mood < / 0> (seperti baik, buruk, atau mengantuk;)), dan <code> pemilik </ 0> (yang dapat diberi objek <code> Person </ 0> - atau mungkin, jika ada kucing yang tersesat, properti ini bisa kosong).</p>
+
+<p>Kemudian <code> Cat </ 0> memiliki beberapa tindakan: <code> purr </ 0> , <code> scratch </ 0> , atau <code> feed </ 0> (dalam hal ini, kami akan memberikannya Cat beberapa <code> CatFood </ 0> , yang bisa jadi objek terpisah dengan properti, seperti <code> taste </ 0> ).</p>
+
+<pre><code>Cat -------- usia warna mood owner purr () scratch () feed (cat_food)
+`</pre> 
+
+    Makanan Kucing --------
+    
+
+Jadi intinya idenya adalah untuk mendeskripsikan hal-hal nyata dalam kode dengan properti (disebut ` object properties </ 0> ) dan tindakan (disebut <code> methods </ 0> ).</p>
+
+<p>Bagaimana kita akan model posting blog itu? Kami ingin membangun blog, bukan?</p>
+
+<p>Kita perlu menjawab pertanyaan: Apa itu posting blog? Properti apa yang seharusnya dimiliki?</p>
+
+<p>Nah, pastinya posting blog kita butuh beberapa teks dengan konten dan judulnya kan? Akan sangat menyenangkan mengetahui siapa yang menulisnya - jadi kita butuh seorang penulis. Akhirnya, kami ingin tahu kapan posting itu dibuat dan dipublikasikan.</p>
+
+<pre><code>Posting -------- judul teks penulis created_date published_date
+`</pre> 
+
+Hal apa saja yang bisa dilakukan dengan posting blog? Akan menyenangkan untuk memiliki beberapa ` metode </ 0> yang menerbitkan posting, kan?</p>
+
+<p>Jadi kita perlu <code> mempublikasikan </ 0> method.</p>
+
+<p>Karena kita sudah tahu apa yang ingin kita capai, mari kita mulai pemodelannya di Django!</p>
+
+<h2>Model Django</h2>
+
+<p>Mengetahui apa itu objek, kita bisa membuat model Django untuk posting blog kita.</p>
+
+<p>Model di Django adalah jenis khusus dari objek - itu disimpan dalam <code> Database </ 0> . Database adalah kumpulan data. Ini adalah tempat di mana Anda akan menyimpan informasi tentang pengguna, posting blog Anda, dll. Kami akan menggunakan database SQLite untuk menyimpan data kami. Ini adalah default database Django adaptor - itu akan cukup bagi kita sekarang.</p>
+
+<p>Anda bisa memikirkan model dalam database sebagai spreadsheet dengan kolom (field) dan baris (data).</p>
+
+<h3>Membuat aplikasi</h3>
+
+<p>Agar semuanya tetap rapi, kami akan membuat aplikasi terpisah di dalam proyek kami. Sangat menyenangkan untuk memiliki semua yang terorganisir sejak awal. Untuk membuat aplikasi kita perlu menjalankan perintah berikut di console (dari <code> djangogirls </ 0> directory dimana <code> manage.py </ 0> file is):</p>
+
+<p>{% filename %}Mac OS X and Linux:{% endfilename %}</p>
+
+<pre><code>(myvenv) ~ / djangogirls $ python manage.py startapp blog
+`</pre> 
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Anda akan melihat bahwa sebuah petunjuk `blog` baru dibuat dan berisi sejumlah file sekarang. Petunjuk dan file dalam proyek kami akan terlihat seperti ini:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+Setelah membuat sebuah aplikasi, kita juga perlu memberitahukan Django bahwa aplikasi tersebut harus menggunakannya. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. Jadi produk akhir akan tampak seperti ini:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Membuat model posting blog
+
+Pada file `blog/models.py` kami menemukan semua objek yang disebut `Model` - ini merupakan tempat di mana kita akan menemukan posting blog kita.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Periksa bahwa Anda menggunakan karakter dua garis bawah (`_`) pada setiap sisi `str`. Konvensi ini sering digunakan dengan Python dan terkadang kita juga menyebutnya "dunder" (singkatan dari "double-underscore").
+
+Terlihat menakutkan bukan? Tapi jangan khawatir - kami akan menjelaskan arti garis-garis ini!
+
+Semua baris yang dimulai dengan `dari` atau ` impor ` adalah baris yang menambahkan beberapa bit dari berkass lain. Jadi, alih-alih menyalin dan menempelkan hal yang sama di setiap berkas, kita dapat menyertakan beberapa bagian dengan ` dari ... impor ... ` .
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- ` class </ 0> adalah kata kunci khusus yang menunjukkan bahwa kita mendefinisikan suatu objek.</li>
+<li><code> Posting </ 0> adalah nama model kami. Kita bisa memberikannya nama yang berbeda (tapi kita harus menghindari karakter dan spasi khusus). Selalu mulai nama kelas dengan huruf besar.</li>
+<li><code> models.Model </ 0> berarti bahwa Post adalah Model Django, jadi Django tahu bahwa itu harus disimpan dalam database.</li>
+</ul>
+
+<p>Sekarang kita menetapkan properti yang sedang kita bicarakan: <code>title`, `text`, `created_date`, `published_date` and `author`. Untuk melakukan itu, kita harus menetapkan jenis masing-masing bidang (apakah itu teks? Nomor? Tanggal? Sebuah hubungan dengan objek yang lain, seperti Pengguna?)</p> 
+    - ` models.CharField </ 0> - begitulah cara Anda mendefinisikan teks dengan jumlah karakter yang terbatas.</li>
+<li><code> models.TextField </ 0> - ini untuk teks panjang tanpa batas. Kedengarannya ideal untuk konten posting blog kan?</li>
+<li><code> models.DateTimeField </ 0> - ini adalah tanggal dan waktu.</li>
+<li><code> models.ForeignKey </ 0> - ini adalah link ke model lain.</li>
+</ul>
+
+<p>Kami tidak akan menjelaskan setiap kode bit di sini karena ini akan memakan terlalu banyak waktu. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).</p>
+
+<p>Bagaimana dengan <code>def publish(self):`? Ini merupakan metode `publish` yang kita bicarakan sebelumnya. `def` berarti bahwa ini merupakan sebuah fungsi/metode dan `publish` merupakan nama metode. Anda bisa mengganti nama metode tersebut jika anda mau. The naming rule is that we use lowercase and underscores instead of spaces. Misalnya, metode yang menghitung nilai rata-rata bisa dinamakan ` calculate_average_price`.</p> 
+        Methods often `return` something. Ada contoh bahwa dalam `__str__`metode. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+        
+        Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Karena Python sensitif terhadap spasi, kita perlu mengidentifikasi metode kita di dalam kelas. Jika tidak, metode tidak akan termasuk dalam kelas, dan anda bisa mendapatkan beberapa perilaku tak terduga.
+        
+        Jika ada sesuatu yang masih belum jelas tentang model, jangan ragu untuk bertanya pada pelatih anda! Kami tahu ini rumit, terutama saat anda mempelajari benda dan fungsi apa yang ada pada waktu bersamaan. Tapi mudah-mudahan ini terlihat sedikit kurang ajaib untuk anda sekarang!
+        
+        ### Buat tabel untuk model di database Anda
+        
+        Langkah terakhirnya adalah menambahkan model baru ke database kami. Pertama kita harus membuat Django tahu bahwa kita memiliki beberapa perubahan dalam model kita. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. Ini akan terlihat seperti ini:
+        
+        {% filename %}command-line{% endfilename %}
+        
+            (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+            Migrations for 'blog':
+              blog/migrations/0001_initial.py:
+            
+              - Create model Post
+            
+        
+        **Catatan:** Ingatlah untuk menyimpan berkas yang anda sunting. Jika tidak, komputer anda akan menjalankan versi sebelumnya yang mungkin memberi anda pesan kesalahan yang tidak terduga.
+        
+        Django menyiapkan berkas migrasi untuk kita yang sekarang harus kita terapkan ke database kita. Mengetik `python manage.py bermigrasi blog` dan hasilnya harus seperti berikut:
+        
+        {% filename %}command-line{% endfilename %}
+        
+            (myvenv) ~/djangogirls$ python manage.py migrate blog
+            Operations to perform:
+              Apply all migrations: blog
+            Running migrations:
+              Applying blog.0001_initial... OK
+            
+        
+        Hore! Model Post kami sekarang ada di database kami! Alangkah baiknya melihatnya, bukan? Langsung ke bab berikutnya untuk melihat seperti apa Post anda!
\ No newline at end of file
diff --git a/id-ID/django_orm/README.md b/id-ID/django_orm/README.md
new file mode 100644
index 00000000000..3692970a922
--- /dev/null
+++ b/id-ID/django_orm/README.md
@@ -0,0 +1,213 @@
+# Django ORM dan QuerySets
+
+Pada chapter kali ini, kamu akan belajar bagaimana Django terkoneksi dengan database dan menyimpan data tersebut didalamnya. Mari kita mulai!
+
+## Apa itu QuerySet?
+
+QuerySet pada dasarnya adalah daftar objek dari Model yang diberikan. QuerySets memungkinkan Anda untuk membaca data dari database, memfilter dan memesannya.
+
+Ini paling mudah untuk belajar lewat contoh. Mari kita coba ini, gimana?
+
+## Django shell
+
+Buka konsol lokal kamu (bukan di PythonAnywhere) dan ketik baris perintah ini:
+
+{% filename%} baris perintah {% endfilename%}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Hasilnya akan seperti ini:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### Semua benda
+
+Mari kita coba tampilkan semua postingan kita dulu. Kamu bisa melakukan itu dengan perintah seperti ini:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Ups! Sebuah kesalahan muncul. Ini memberitahu kita bahwa tidak ada Post. Benar - kita lupa mengimpornya dulu!
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+& gt; & gt; & gt; Post.objects.all ()
+ <QuerySet [<Post: my post title> , <Post: another post title> ] & gt;
+```
+
+Ini adalah daftar posting yang kami buat tadi! Kami membuat posting ini menggunakan antarmuka admin Django. Tapi sekarang kita ingin membuat posting baru menggunakan Python, jadi bagaimana kita melakukannya?
+
+### Buat objek
+
+Beginilah cara Anda membuat objek Post baru di database:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+& gt; & gt; & gt; Post.objects.create (author = me, title = 'Contoh judul', teks = 'Uji')
+```
+
+Tapi kami punya satu unsur yang hilang di sini: ` saya </ 0> . Kita perlu melewatkan sebuah instance dari model <code> User </ 0> sebagai penulis. Bagaimana kita melakukannya?</p>
+
+<p>Mari impor model Pengguna terlebih dahulu:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">& gt; & gt; & gt; dari django.contrib.auth.models import User
+`</pre> 
+
+Pengguna apa yang ada di database kami? Coba ini:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+& gt; & gt; & gt; User.objects.all ()
+ <QuerySet [<User: ola> ] & gt;
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+& gt; & gt; & gt; saya = User.objects.get (username = 'ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Sekarang kita akhirnya bisa membuat tulisan kita:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hore! Ingin memeriksa apakah berhasil?
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+& gt; & gt; & gt; Post.objects.all ()
+ <QuerySet [<Post: my post title> , <Post: another post title> , <Post: Sample title> ] & gt;
+```
+
+Itu dia, satu lagi posting di daftar!
+
+### Tambahkan lebih banyak pos
+
+Anda sekarang dapat bersenang-senang dan menambahkan lebih banyak pos untuk melihat cara kerjanya. Tambahkan dua atau tiga lagi dan kemudian lanjutkan ke bagian selanjutnya.
+
+### Filter objek
+
+Sebagian besar QuerySets adalah kemampuan untuk memfilternya. Katakanlah kita ingin menemukan semua tulisan yang pengguna ola tulis. Kita akan menggunakan ` filter </ 0> daripada <code> all </ 0> di <code> Post.objects.all () </ 0> . Dalam kurung kita menyatakan kondisi apa yang harus dipatok oleh posting blog agar bisa berakhir dalam queryset kita. Dalam kasus kami, kondisinya adalah bahwa <code> penulis </ 0> harus sama dengan <code> saya </ 0> . Cara untuk menuliskannya di Django adalah <code> author = me </ 0> . Sekarang potongan kode kita terlihat seperti ini:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+`</pre> 
+
+Atau mungkin kita ingin melihat semua tulisan yang berisi kata 'title' di bidang ` title </ 0> ?</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+`</pre> 
+
+> ** Catatan </ 0> Ada dua karakter garis bawah ( ` _ </ 1> ) antara <code> judul </ 1> dan <code> berisi </ 1> . ORM Django menggunakan aturan ini untuk memisahkan nama field ("judul") dan operasi atau filter ("contains"). Jika Anda hanya menggunakan satu garis bawah, Anda akan mendapatkan pesan kesalahan seperti "FieldError: Tidak dapat menyelesaikan judul kata kunci_contains".</p>
+</blockquote>
+
+<p>Anda juga bisa mendapatkan daftar semua posting yang dipublikasikan. Kami melakukan ini dengan memfilter semua posting yang telah <code> publish_date </ 0> di sebelumnya:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+`</pre> 
+> 
+> Sayangnya, posting yang kami tambahkan dari konsol Python belum dipublikasikan. Tapi kita bisa mengubah itu! Pertama dapatkan sebuah instance dari sebuah postingan yang ingin kita publikasikan:
+> 
+> {% filename%} baris perintah {% endfilename%}
+> 
+> ```python
+& gt; & gt; & gt; post = Post.objects.get (judul = "judul contoh")
+```
+
+Kemudian publikasikan dengan metode ` publish </ 0> :</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">& gt; & gt; & gt; post.publish ()
+`</pre> 
+
+Sekarang cobalah untuk mendapatkan daftar posting yang dipublikasikan lagi (tekan tombol panah atas tiga kali dan tekan ` enter </ 0> ):</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+`</pre> 
+
+### Memesan benda
+
+QuerySets juga memungkinkan Anda untuk memesan daftar objek. Mari kita coba untuk memesannya dengan bidang ` create_date </ 0> :</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+`</pre> 
+
+Kita juga bisa membalik pemesanan dengan menambahkan ` - </ 0> di awal:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+`</pre> 
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Ini benar-benar hebat dan memungkinkan Anda menulis kueri yang cukup rumit.
+
+Keren! Anda sekarang siap untuk bagian selanjutnya! Untuk menutup shell, ketik ini:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+& gt; & gt; & gt; keluar () $
+```
\ No newline at end of file
diff --git a/id-ID/django_start_project/README.md b/id-ID/django_start_project/README.md
new file mode 100644
index 00000000000..3385ad648a4
--- /dev/null
+++ b/id-ID/django_start_project/README.md
@@ -0,0 +1,259 @@
+# Project Django pertamamu!
+
+> Bagian dari bab ini didasarkan pada tutorial oleh Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Bagian dari bab ini didasarkan pada  Django-marcador    tutorial </ 0> berlisensi di bawah Creative Commons    Lisensi Internasional Attribution-ShareAlike 4.0. Hak cipta tutorial django-marcador oleh Markus Zapke-Gründemann et al.</p> </blockquote> 
+> 
+> Kita akan membuat blog sederhana!
+> 
+> Langkah pertama adalah memulai dengan membuat projek baru Django. Pada dasarnya, Kita akan menjalankan beberapa skrip yang disediakan oleh Django yang mana akan membuat skeleton projek Django untuk kita. Ini merupakan bagian direktori dan file yang akan kita gunakan nanti.
+> 
+> Nama untuk beberapa file dan direktori sangat penting untuk Django. Kamu harus mengganti nama file yang akan kita buat. Memindahkan file tersebut ke tempat yang lain bukanlah ide yang bagus. Django perlu mempertahankan struktur tertentu agar bisa menemukan hal penting.
+> 
+> > Ingatlah untuk menjalankan semuanya di virtualenv. Jika Anda tidak melihat awalan ` (myvenv) </ 0> di konsol Anda, Anda perlu mengaktifkan virtualenv Anda. Kami menjelaskan bagaimana melakukannya di bagian <strong> instalasi Django </ 0> di bagian <strong> Bekerja dengan virtualenv </ 0> . Mengetik <code> myvenv \ Scripts \ activate </ 0> pada Windows atau
+ <code> sumber myvenv / bin / activate </ 0> pada Mac OS X atau Linux akan melakukan ini untuk Anda.  </p>
+</blockquote>
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+<p>Di konsol Mac OS X atau Linux Anda, Anda harus menjalankan perintah berikut. <strong> Jangan lupa menambahkan periode (atau titik) <code> . </ 1> di akhir! </ 0></p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>(myvenv) ~/djangogirls$ django-admin startproject mysite .
+`</pre> 
+> > 
+> > > Masalah `.` cukup krusial karena ini akan memberi perintah skrip untuk menginstall Django pada direktori-mu saat ini (untuk masalah `.` adalah referensi singkat).
+> > > 
+> > > ** Catatan </ 0> Saat mengetikkan perintah di atas, ingat bahwa Anda hanya mengetikkan bagian yang dimulai oleh ` Django-admin </ 1>.
+  Bagian <code> (myvenv) ~ / djangogirls $ </ 0> yang ditunjukkan di sini hanyalah contoh dari prompt yang akan mengundang masukan Anda pada baris perintah Anda.</p>
+</blockquote>
+
+<!--endsec-->
+
+
+> > > 
+> > > <!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+<p>Pada Windows Anda harus menjalankan perintah berikut. <strong> (Jangan lupa menambahkan periode (atau titik) <code>. </ 1> di akhir) </ 0>:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>(myvenv) C: \ Users \ Name \ djangogirls & gt; django-admin.exe startproject mysite.
+`</pre> 
+> > > 
+> > > > Masalah `.` cukup krusial karena ini akan memberi perintah skrip untuk menginstall Django pada direktori-mu saat ini (untuk masalah `.` adalah referensi singkat).
+> > > > 
+> > > > **Catatan** Saat mengetikkan perintah di atas, ingat bahwa Anda hanya mengetikkan bagian yang dimulai oleh `django-admin.exe`. Bagian `(myvenv) C:\Users\Name\djangogirls>` yang ditunjukkan di sini hanyalah contoh prompt yang akan mengundang masukan Anda pada baris perintah Anda.
+> > > 
+> > > <!--endsec-->
+> > > 
+> > > ` django-admin.py </ 0> adalah script yang akan membuat direktori dan file untuk Anda. Anda sekarang harus memiliki struktur direktori yang terlihat seperti ini:</p>
+
+<pre><code>djangogirls
+├── manage.py
+├── mysite
+│   ├── __init__.py
+│   ├── settings.py
+│   ├── urls.py
+│   └── wsgi.py
+├── myvenv
+│   └── ...
+└── requirements.txt
+`</pre> 
+> > > 
+> > > > ** Catatan </ 0>: dalam struktur direktori Anda, Anda juga akan melihat direktori ` venv </ 1> yang telah kita buat sebelumnya.</p>
+</blockquote>
+
+<p><code> manage.py </ 0> adalah skrip yang membantu pengelolaan situs. Dengan itu kita akan bisa (antara lain) untuk memulai web server di komputer kita tanpa menginstal apapun.</p>
+
+<p>File <code> settings.py </ 0> berisi konfigurasi situs web Anda.</p>
+
+<p>Ingat ketika kita berbicara tentang pembawa surat yang memeriksa kemana harus mengirimkan surat? <code> urls.py </ 0> berisi daftar pola yang digunakan oleh <code> urlresolver </ 0>.</p>
+
+<p>Mari kita abaikan file lainnya untuk saat ini karena kita tidak akan mengubahnya. Satu-satunya hal yang perlu diingat adalah tidak menghapusnya secara tidak sengaja!</p>
+
+<h2>Mengubah pengaturan</h2>
+
+<p>Mari buat beberapa perubahan di <code> mysite / settings.py </ 0>. Buka file dengan menggunakan editor kode yang telah Anda instal sebelumnya.</p>
+
+<p><strong> Catatan </ 0>: Perlu diingat bahwa <code> settings.py </ 1> adalah file biasa, seperti file lainnya. Anda dapat membukanya dari dalam editor kode, dengan menggunakan tindakan menu "file -> open". Ini akan memberi Anda jendela biasa tempat Anda dapat menavigasi ke file <code> settings.py </ 0> dan memilihnya. Sebagai alternatif, Anda dapat membuka file dengan menavigasi ke folder djangogirls di desktop Anda dan mengklik kanannya. Kemudian, pilih editor kode Anda dari daftar. Memilih editor penting karena Anda mungkin menginstal program lain yang bisa membuka file tapi tidak membiarkan Anda mengeditnya.</p>
+
+<p>Alangkah baiknya memiliki waktu yang tepat di situs kami. Pergi ke <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones"> daftar zona waktu Wikipedia </ 0> dan salin zona waktu yang relevan (TZ) (misalnya <code> Eropa / Berlin </ 1> ).</p>
+
+<p>Di <code> settings.py </ 0>, cari baris yang berisi <code> TIME_ZONE </ 0> dan modifikasi untuk memilih zona waktu Anda sendiri. Sebagai contoh:</p>
+
+<p>{% filename%} mysite / settings.py {% endfilename%}</p>
+
+<pre><code class="python">TIME_ZONE = 'Eropa / Berlin'
+`</pre> 
+> > > > 
+> > > > A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. Jadi Anda akan memiliki tombol "Batal" yang diterjemahkan ke bahasa yang Anda definisikan di sini. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+> > > > 
+> > > > If you want a different language, change the language code by changing the following line:
+> > > > 
+> > > > {% filename%} mysite / settings.py {% endfilename%}
+> > > > 
+> > > > ```python
+LANGUAGE_CODE = 'de-ch'
+```
+> > 
+> > Kita juga perlu menambahkan path untuk file statis. (Kita akan mencari tahu semua tentang file statis dan CSS nanti di tutorial.) Turun ke * akhir </ 0> dari file tersebut, dan di bawah entri ` STATIC_URL </ 1> , tambahkan sebuah yang baru disebut <code> STATIC_ROOT </ 1> :</p>
+
+<p>{% filename%} mysite / settings.py {% endfilename%}</p>
+
+<pre><code class="python">STATIC_URL = '/ static /' STATIC_ROOT = os.path.join (BASE_DIR, 'statis')
+`</pre> 
+> > 
+> > Bila ` DEBUG </ 0> adalah <code> True </ 0> dan <code> ALLOWED_HOSTS </ 0> kosong, host divalidasi terhadap <code> ['localhost', '127.0.0.1', ' [:: 1] '] </ 0> . Ini tidak akan cocok dengan nama host kami di PythonAnywhere begitu kami menerapkan aplikasi kami sehingga kami akan mengubah setelan berikut:</p>
+
+<p>{% filename%} mysite / settings.py {% endfilename%}</p>
+
+<pre><code class="python">ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+`</pre> 
+> > 
+> > > ** Catatan </ 0> : Jika Anda menggunakan Chromebook, tambahkan baris ini di bagian bawah file settings.py Anda: ` MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage' </ 1>  </p>
+  
+  <p>Also add <code>.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9</p> 
+> > > 
+> > > If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> > > 
+> > > - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+> > >     
+> > >     {% filename %}command-line{% endfilename %}
+> > >     
+> > >     ```bash
+> > >     python -c 'from django.core.management.utils import get_random_secret_key; \
+> > >           print(get_random_secret_key())'
+> > >     ```
+> > >     
+> > >     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> > > 
+> > > - Create a file `.env` at the root of your project and add the following property in it:
+> > >     
+> > >     {% filename %}.env{% endfilename %}
+> > >     
+> > >     ```bash
+> > >     # Here, inside the single quotes, you can cut and paste the random key generated above
+> > >     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+> > >     ```
+> > > 
+> > > - Then update the Django settings file to inject this secret value and set the Django web site name:
+> > >     
+> > >     {% filename %}mysite/settings.py{% endfilename %}
+> > >     
+> > >     ```python
+> > >     SECRET_KEY = os.getenv('SECRET')
+> > >     ```
+> > > 
+> > > - And a little further down in the same file, we inject the name of your new Glitch website:
+> > >     
+> > >     {% filename %}mysite/settings.py{% endfilename %}
+> > >     
+> > >     ```python
+> > >     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+> > >     ```
+> > >     
+> > >     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.</blockquote> 
+> > > 
+> > > ## Buat database
+> > > 
+> > > Ada banyak perangkat lunak database yang berbeda yang dapat menyimpan data untuk situs Anda. Kita akan menggunakan yang default, ` sqlite3 </ 0> .</p>
+
+<p>Ini sudah disiapkan di bagian berkas <code> mysite / settings.py </ 0> Anda :</p>
+
+<p>{% filename%} mysite / settings.py {% endfilename%}</p>
+
+<pre><code class="python">DATABASES = {
+     'default': {
+         'ENGINE': 'django.db.backends.sqlite3',
+         'NAME': os.path.join (BASE_DIR, 'db.sqlite3'),
+     }}
+`</pre> 
+> > > 
+> > > Untuk membuat database untuk blog kita, mari kita jalankan yang berikut di konsol: ` python manage.py migrate </ 0> (kita perlu berada di direktori <code> djangogirls </ 0> yang berisi <code> manage.py </ 0> file). Jika berjalan dengan baik, Anda harus melihat sesuatu seperti ini:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>(myvenv) ~ / djangogirls $ python manage.py migran Operasi yang harus dilakukan:
+   Terapkan semua migrasi: auth, admin, contenttypes, sessions Running migration:
+   Rendering model states ... DONE
+   Menerapkan contenttypes.0001_initial ... OK
+   Menerapkan auth.0001_initial ... OK
+   Menerapkan admin.0001_initial ... OK
+   Menerapkan admin.0002_logentry_remove_auto_add ... OK
+   Menerapkan contenttypes.0002_remove_content_type_name ... OK
+   Menerapkan auth.0002_alter_permission_name_max_length ... OK
+   Menerapkan auth.0003_alter_user_email_max_length ... OK
+   Menerapkan auth.0004_alter_user_username_opts ... OK
+   Menerapkan auth.0005_alter_user_last_login_null ... OK
+   Menerapkan auth.0006_require_contenttypes_0002 ... OK
+   Menerapkan auth.0007_alter_validators_add_error_messages ... OK
+  Applying auth.0008_alter_user_username_max_length... OK
+  Applying auth.0009_alter_user_last_name_max_length... OK
+  Applying sessions.0001_initial... OK
+`</pre> 
+> > > 
+> > > Dan kita sudah selesai! Waktunya memulai web server dan melihat apakah website kita bekerja!
+> > > 
+> > > ## Memulai server web
+> > > 
+> > > Anda harus berada di direktori yang berisi file ` manage.py </ 0> (direktori <code> djangogirls </ 0> ). Di konsol, kita bisa memulai server web dengan menjalankan <code> python manage.py runserver </ 0> :</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>(myvenv) ~ / djangogirls $ python manage.py runserver
+`</pre> 
+> > > 
+> > > Jika Anda menggunakan Chromebook, gunakan perintah ini sebagai gantinya:
+> > > 
+> > > {% filename %}Cloud 9{% endfilename %}
+> > > 
+> > >     (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+> > >     
+> > > 
+> > > or this one if you are using Glitch:
+> > > 
+> > > {% filename %}Glitch.com terminal{% endfilename %}
+> > > 
+> > >     $ refresh
+> > >     
+> > >     
+> > > 
+> > > If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+> > > 
+> > > {% filename %}command-line{% endfilename %}
+> > > 
+> > >     (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+> > >     
+> > > 
+> > > Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+> > > 
+> > > {% filename %}browser{% endfilename %}
+> > > 
+> > >     http://127.0.0.1:8000/
+> > >     
+> > > 
+> > > If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+> > > 
+> > > {% filename %}browser{% endfilename %}
+> > > 
+> > >     https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+> > >     
+> > > 
+> > > or on Glitch:
+> > > 
+> > >     https://name-of-your-glitch-project.glitch.me
+> > >     
+> > > 
+> > > Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+> > > 
+> > > ![Install worked!](images/install_worked.png)
+> > > 
+> > > Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+> > > 
+> > > > Kami meninjau bagaimana server web bekerja di ** Bagaimana Internet bekerja** bab.
+> > > 
+> > > To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+> > > 
+> > > Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/id-ID/django_templates/README.md b/id-ID/django_templates/README.md
new file mode 100644
index 00000000000..63a0407963d
--- /dev/null
+++ b/id-ID/django_templates/README.md
@@ -0,0 +1,109 @@
+# Django templates
+
+Saatnya menampilkan data! Django menyediakan fitur bawaan berupa **template tags** untuk keperluan tersebut.
+
+## Apa itu template tags?
+
+Anda lihat, di HTML, Anda tidak bisa benar-benar menulis kode Python, karena browser tidak memahaminya. Mereka hanya tahu HTML. Kita tahu bahwa HTML agak statis, sementara Python jauh lebih dinamis.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Menampilkan template post list
+
+Di pembahasan sebelumnya kita menyediakan post list ke dalam variabel `posts`.
+
+Untuk mencetak variabel ke dalam Django templates, kita menggunakan dua buah karakter kurung kurawal denga nama variable di dalamnya, seperti ini:
+
+{% filename%} blog / templates / blog / post_list.html {% endfilename%}
+
+```html
+{{posts}}
+```
+
+Terapkan ke template `blog/templates/blog/post_list.html`. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Simpan file, dan refresh halaman untuk melihat hasil perubahan:
+
+![Gambar 13.1](images/step1.png)
+
+Seperti yang bisa kita lihat, tercetak seperti berikut:
+
+{% filename%} blog / templates / blog / post_list.html {% endfilename%}
+
+```html
+<QuerySet [<Post: My second post> , <Post: My first post> ] & gt;
+```
+
+Yang berarti Django dapat mengenalinya sebagai list objek. Ingat pembahasan dari **Introduction to Python** bagaimana kita menampilkan list? Ya, dengan loop! Di Django template, kita menerapkannya seperti ini:
+
+{% filename%} blog / templates / blog / post_list.html {% endfilename%}
+
+```html
+{% untuk posting di posting%} 
+{{post}} {% endfor%}
+
+```
+
+Cobalah terapkan di template.
+
+![Gambar 13.2](images/step2.png)
+
+Berhasil! Tapi kami ingin posting ditampilkan seperti tulisan statis yang kami buat sebelumnya di bab ** Introduction to HTML </ 0> . Anda dapat mencampur tag HTML dan template. Kami ` tubuh </ 0> akan terlihat seperti ini:</p>
+
+<p>{% filename%} blog / templates / blog / post_list.html {% endfilename%}</p>
+
+<pre><code class="html"><header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+`</pre> 
+
+{% raw%} Semua yang Anda masukkan antara ` {% untuk%} </ 0> dan <code> {% endfor%} </ 0> akan diulang untuk setiap objek dalam daftar. Segarkan laman Anda: {% endraw%}</p>
+
+<p><img src="images/step3.png" alt="Gambar 13.3" /></p>
+
+<p>Have you noticed that we used a slightly different notation this time (<code>{{ post.title }}` or `{{ post.text }}`)? Kami mengakses data di masing-masing bidang yang didefinisikan dalam model ` Post </ 0> kami . Juga, <code> | linebreaksbr </ 0> sedang menyalurkan teks posting melalui filter untuk mengubah jeda baris menjadi paragraf.</p>
+
+<h2>Satu hal lagi</h2>
+
+<p>Akan lebih baik bila website Anda tetap bekerja di Internet publik kan? Ayo coba gunakan PythonAnywhere lagi. Inilah rekap langkahnya ...</p>
+
+<ul>
+<li>First, push your code to GitHub</li>
+</ul>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>$ git status
+[...]
+$ git add .
+$ git status
+[...]
+$ git commit -m "Modified templates to display posts from database."
+[...]
+$ git push
+`</pre> 
+
+* Kemudian, masuk kembali ke  PythonAnywhere </ 0> dan masuk ke konsol < 1> Bash </ 1> Anda (atau jalankan yang baru), dan jalankan:</li> </ul> 
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+        $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+        $ git pull
+        [...]
+        
+    
+    (Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+    
+    * Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+    
+    Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+    
+    Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+    
+    ![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/id-ID/django_urls/README.md b/id-ID/django_urls/README.md
new file mode 100644
index 00000000000..36a36e3b7a8
--- /dev/null
+++ b/id-ID/django_urls/README.md
@@ -0,0 +1,102 @@
+# URL Django
+
+Kami akan membuat laman web pertama kami: beranda untuk blog Anda! Tapi pertama, mari pelajari sedikit tentang URL Django.
+
+## Apa itu URL?
+
+URL adalah sebuah alamat web. Anda dapat melihat URL setiap kali mengunjungi situs web - ini terlihat di bilah alamat browser Anda. (Iya nih! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Setiap halaman di Internet membutuhkan URLnya sendiri. Dengan cara ini aplikasi Anda tahu apa yang harus ditunjukkan kepada pengguna yang membuka URL itu. Di Django, kita menggunakan yang disebut `URLconf` (konfigurasi URL). URLconf adalah seperangkat pola-pola yang akan dicoba Django untuk mencocokkan URL yang diminta untuk menemukan view/tampilan yang benar.
+
+## Bagaimana cara kerja URL di Django?
+
+Mari buka berkas ` mysite / urls.py ` di editor kode pilihan Anda dan lihat seperti apa:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Seperti yang Anda lihat, Django telah meletakkan sesuatu di sini untuk kita.
+
+Baris antara tanda kutip tiga kali (` '' '</ 0> atau <code> "" "</ 0>) disebut docstrings - Anda dapat menuliskannya di bagian atas file, kelas atau metode untuk menjelaskan apa yang dilakukannya. Mereka tidak akan dijalankan oleh Python.</p>
+
+<p>URL admin, yang telah Anda kunjungi di bab sebelumnya, ada di sini:</p>
+
+<p>{% filename%} mysite / urls.py {% endfilename%}</p>
+
+<pre><code class="python">    path('admin/', admin.site.urls),
+`</pre> 
+
+Baris ini berarti bahwa untuk setiap URL yang dimulai dengan ` admin / </ 0>, Django akan menemukan tampilan <em> yang sesuai </ 1>. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.</p>
+
+<h2>Your first Django URL!</h2>
+
+<p>Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.</p>
+
+<p>We also want to keep the <code>mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/id-ID/django_views/README.md b/id-ID/django_views/README.md
new file mode 100644
index 00000000000..88c77c5a7cf
--- /dev/null
+++ b/id-ID/django_views/README.md
@@ -0,0 +1,42 @@
+# Tampilan Django - waktu untuk membuat!
+
+Waktunya menyingkirkan bug yang kita buat di bab terakhir! :)
+
+A * view </ 0> adalah tempat kita meletakkan "logika" aplikasi kita. Ini akan meminta informasi dari ` Model </ 0> Anda buat sebelumnya dan menyebarkannya ke <code> Template </ 0> . Kami akan membuat template di bab berikutnya. View hanyalah berupa fungsi Python tetapi lebih kompleks dibandingkan dengan yang telah kita buat pada bab <strong>Pengenalan Pada Python</strong>.</p>
+
+<p>Penayangan ditempatkan di file <code> views.py </ 0> . Kami akan menambahkan <em> tampilan </ 1> ke file <code> blog / views.py </ 0> .</p>
+
+<h2>blog / views.py</h2>
+
+<p>OK, let's open up this file in our code editor and see what's in there:</p>
+
+<p>{% filename%} blog / views.py {% endfilename%}</p>
+
+<pre><code class="python">from django.shortcuts import render
+
+# Create your views here.
+`</pre> 
+
+Belum banyak perintah di sini.
+
+Ingat bahwa baris yang dimulai dengan ` # </ 0> adalah komentar - ini berarti bahwa baris tersebut tidak akan dijalankan oleh Python.</p>
+
+<p>Mari buat <em> lihat </ 0> seperti yang disarankan oleh komentar. Tambahkan tampilan minimal berikut di bawah ini:</p>
+
+<p>{% filename%} blog / views.py {% endfilename%}</p>
+
+<pre><code class="python">def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+`</pre> 
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Simpan filenya, pergi ke http://127.0.0.1:8000/ dan lihat apa yang kita punya.
+
+Kesalahan lain Baca apa yang terjadi sekarang:
+
+![Kesalahan](images/error.png)
+
+Ini memperlihatkan bahwa server berjalan lagi, paling tidak, tapi masih kelihatan belum betul, betul? Jangan khawatir, itu hanyalah halaman error, tak ada yang perlu ditakutkan! Sama seperti pesan error di dalam konsol, hal tersebut sangat berguna. Anda dapat membaca *TemplateDoesNotExist*. Mari perbaiki bug ini dan membuat sebuah template pada bab berikutnya!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/id-ID/dynamic_data_in_templates/README.md b/id-ID/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..dcfe9484d78
--- /dev/null
+++ b/id-ID/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Template Daftar Data Dinamis
+
+Kami memiliki beberapa bagian yang berbeda: model ` Post ` didefinisikan pada ` models.py `, kami memiliki ` post_list ` di ` views.py ` dan template ditambahkan. Tapi bagaimana kita benar-benar membuat posting Anda muncul di template HTML Anda? Karena itulah yang ingin kita lakukan - ambil beberapa konten (model yang tersimpan di database) dan tampilkan dengan baik di template kita kan?
+
+Inilah yang seharusnya dilihat * dilihat *: hubungkan model dan template. Pada ` post_list ` * tampilan * kita perlu mengambil model yang ingin kita tampilkan dan menyebarkannya ke template. Pada tampilan * * kita menentukan apa (model) yang akan ditampilkan di template.
+
+Baiklah, jadi bagaimana kita bisa mencapai ini?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/static/css/views.py{% endfilename %}
+
+```python
+dari django.shortcuts import render
+
+def post_list (permintaan):
+     mengembalikan render (permintaan, 'blog / post_list.html', {})
+```
+
+Ingat ketika kita berbicara tentang termasuk kode yang ditulis dalam file yang berbeda?   Konteks | Permintaan Konteks? Sekarang adalah saat ketika kita harus menyertakan model yang telah kita tulis di ` models.py `.   Konteks | Permintaan Konteks. Kami akan menambahkan baris ` dari .Models import Post ` seperti ini:
+
+{% filename %}blog/static/css/views.py{% endfilename %}
+
+```python
+pythonfrom django.shortcuts import admin
+from .models import P
+```
+
+Titik sebelum ` model ` berarti * direktori saat ini * atau * aplikasi saat ini *. Kedua ` views.py ` dan ` models.py ` ada di direktori yang sama. Ini berarti kita bisa menggunakan `. ` dan nama file (tanpa `.py `). Kemudian kita mengimpor nama modelnya (` Post `).
+
+Tapi apa selanjutnya? Untuk mengambil postingan blog yang sebenarnya dari model ` Post ` kita memerlukan sesuatu yang disebut ` QuerySet `.
+
+## QuerySet
+
+Anda seharusnya sudah terbiasa dengan bagaimana QuerySets bekerja. Kami membicarakannya di [ bagian Django ORM (Query Sets) ](../django_orm/README.md).
+
+Jadi sekarang kita ingin posting blog yang dipublikasikan diurutkan menurut ` published_date `, kan? Kami sudah melakukannya di bab QuerySets!
+
+{% filename %}blog/static/css/views.py{% endfilename %}
+
+```python
+& gt; & gt; & gt; Post.objects.filter (published_date__lte = timezone.now ()) order_by ('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/static/css/views.py{% endfilename %}
+
+```python
+dari django.shortcuts import render
+dari zona waktu impor django.utils
+dari .Model impor Post
+
+def post_list(permintaan):
+     posting = Post.objects.filter (published_date__lte = timezone.now ()) order_by ('published_date')
+     mengembalikan render (permintaan, 'blog / post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Perlu diketahui bahwa kami membuat variabel * * untuk QuerySet kami: ` posts `. Perlakukan ini sebagai nama QuerySet kami. Mulai sekarang kita bisa merujuknya dengan nama ini.
+
+Pada fungsi ` render ` kita memiliki satu parameter ` request ` (semua yang kita terima dari pengguna melalui Internet) dan yang lain memberi file template (` 'blog / post_list.html '`). Parameter terakhir, ` {} `, adalah tempat di mana kita dapat menambahkan beberapa hal untuk template yang akan digunakan. Kita perlu memberi mereka nama (kita akan tetap berpegang pada ` 'posts' ` sekarang). :) Seharusnya terlihat seperti ini: ` {'posts': posts} `. Harap dicatat bahwa bagian sebelum `: ` adalah string; Anda perlu membungkusnya dengan tanda petik: ` '' `.
+
+Jadi akhirnya file `blog/views.py` kita akan terlihat seperti ini:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+dari django.shortcuts import render
+dari zona waktu impor django.utils
+dari .Model impor Post
+
+def post_list (permintaan):
+     posting = Post.objects.filter (published_date__lte = timezone.now ()) order_by ('published_date')
+     mengembalikan render (permintaan, 'blog / post_list.html', {'posts': posts})
+```
+
+Itu dia! Waktunya kembali ke template kita dan menampilkan QuerySet ini!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/id-ID/extend_your_application/README.md b/id-ID/extend_your_application/README.md
new file mode 100644
index 00000000000..55094bc8792
--- /dev/null
+++ b/id-ID/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Perluas aplikasi Anda
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Buat link template ke detail posting
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Membuat URL posting detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Buat template untuk detail posting
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Memperbarui file statis di server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/id-ID/how_the_internet_works/README.md b/id-ID/how_the_internet_works/README.md
new file mode 100644
index 00000000000..cf8bd2582eb
--- /dev/null
+++ b/id-ID/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Bagaimana Internet Bekerja
+
+> Bagi pembaca di rumah: bab ini tercakup dalam video [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> Bab ini terinspirasi oleh pembicaraan "Bagaimana Internet bekerja" oleh Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+Kami yakin Anda menggunakan internet setiap hari. Tapi apakah Anda benar-benar tahu apa yang terjadi saat Anda mengetikkan alamat seperti https://djangogirls.org ke browser Anda dan tekan `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Browser web dirancang untuk memahami kode ini, ikuti instruksinya, dan tunjukkan file-file ini yang dibuat oleh situs web Anda, persis seperti yang Anda inginkan.
+
+Seperti pada setiap file, kita perlu menyimpan file HTML di suatu tempat pada hard disk. Untuk internet, kami menggunakan khusus, kuat komputer disebut *server*. Mereka tidak memiliki layar, mouse atau keyboard, karena mereka tujuan utama adalah untuk menyimpan data dan melayani. Itu sebabnya mereka disebut *server* - karena mereka *melayani* data Anda.
+
+OK, tapi Anda ingin tahu bagaimana internet terlihat, kan?
+
+Kami menggambarmu! Sepertinya ini:
+
+![Gambar 1.1](images/internet_1.png)
+
+Sepertinya berantakan, kan? Bahkan itu adalah jaringan mesin yang terhubung (yang disebutkan di atas * server </ 0> ). Ratusan ribu mesin! Banyak, banyak kilometer dari kabel di seluruh dunia! Anda dapat mengunjungi kabel bawah laut peta situs web (http://submarinecablemap.com) untuk melihat bagaimana rumit net. Berikut adalah screenshot dari website:</p> 
+
+![Gambar 1.2](images/internet_3.png)
+
+Hal ini menarik, bukan? But it is not possible to have a wire between every machine connected to the Internet. Jadi, untuk mencapai mesin (misalnya, satu di mana https://djangogirls.org disimpan) kita perlu lulus permintaan melalui banyak, banyak mesin yang berbeda.
+
+Itu tampak seperti ini:
+
+![Gambar 1.3](images/internet_2.png)
+
+Bayangkan bahwa ketika Anda mengetik https://djangogirls.org, Anda mengirim surat yang berbunyi: "Dear Django Girls, saya ingin melihat situs djangogirls.org, kirimkan kepada saya, please!"
+
+Surat Anda ke kantor pos terdekat dengan Anda. Kemudian pergi ke yang lain yang sedikit lebih dekat ke penerima Anda, lalu ke yang lain, dan yang lainnya sampai dikirim ke tempat tujuannya. Satu-satunya hal yang unik adalah jika Anda mengirim banyak surat ( * paket data * ) ke tempat yang sama, mereka bisa melalui kantor pos yang sama sekali berbeda ( * router * ). Hal ini tergantung bagaimana mereka didistribusikan di setiap kantor.
+
+![Gambar 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Alih-alih alamat dengan nama jalan, kota, kode pos dan nama negara, kita menggunakan alamat IP. Komputer Anda pertama kali meminta DNS (Domain Name System) untuk menerjemahkan djangogirls.org ke alamat IP. Ini bekerja sedikit seperti buku telepon kuno di mana Anda dapat mencari nama orang yang ingin Anda hubungi dan menemukan nomor telepon dan alamat mereka.
+
+Bila Anda mengirim surat, perlu ada fitur tertentu yang bisa disampaikan dengan benar: alamat, stempel, dll. Anda juga menggunakan bahasa yang dipahami oleh penerima, bukan? Hal yang sama berlaku untuk paket data * * yang Anda kirim untuk melihat situs web. Kami menggunakan protokol yang disebut HTTP (Hypertext Transfer Protocol).
+
+Jadi, pada dasarnya, jika Anda memiliki situs web, Anda harus memiliki *server* (mesin) tempat tinggalnya. Ketika * server * menerima permintaan * masuk * (dalam sebuah surat), ia akan mengirimkan kembali situs Anda (dalam surat lain).
+
+Karena ini adalah tutorial Django, Anda mungkin bertanya apa yang Django lakukan. Bila Anda mengirim tanggapan, Anda tidak selalu ingin mengirimkan hal yang sama kepada semua orang. Jauh lebih baik jika surat Anda dipersonalisasi, terutama untuk orang yang baru saja menulis surat kepada Anda, bukan? Django membantu Anda membuat surat yang dipersonalisasi dan menarik ini. :)
+
+Cukup waktu bicara untuk menciptakan!
\ No newline at end of file
diff --git a/id-ID/html/README.md b/id-ID/html/README.md
new file mode 100644
index 00000000000..b119022cce4
--- /dev/null
+++ b/id-ID/html/README.md
@@ -0,0 +1,227 @@
+# Pengantar ke HTML
+
+Apa itu template, mungkin kamu bertanya?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+Format template-template Django dijelaskan dalam bahasa yang disebut HTML (itulah HTML yang kami sebutkan di bab pertama, ** Bagaimana Internet bekerja </ 0>).</p> 
+
+## HTML adalah?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML singkatan dari "HyperText Markup bahasa". ** HyperText </ 0> berarti itu adalah jenis teks yang mendukung sebuah link antar halaman. < Markup </ 0> berarti kita telah mengambil sebuah dokumen dan menandai dengan kode untuk mengatakan sesuatu (dalam hal ini, browser internet) bagaimana menafsirkan halaman. Kode HTML dibangun oleh ** tag </ 0>, masing-masing dimulai dengan ` & lt; </ 1> dan diakhiri dengan <code> & gt; </ 1>. Tag ini mewakili markup <strong> elemen </ 0> .</p>
+
+<h2>Template pertama kamu!</h2>
+
+<p>Membuat template berarti membuat file template. Semuanya adalah sebuah file, bukan? Anda mungkin sudah menyadari hal ini.</p>
+
+<p>Template tersimpan di direktori <code> blog / template / blog </ 0>. Jadi pertama menciptakan sebuah direktori yang disebut <code>template` di dalam direktori blog Anda. Kemudian dibuat direktori lain yang disebut `blog` di dalam direktori template Anda:</p> 
+
+    blog 
+    └───templates
+     └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+Dan sekarang membuat `post_list.html` file (Biarkan kosong untuk sekarang) didalam direktori `blog/template/blog`.
+
+Lihatlah bagaimana situs web terlihat sekarang: http://127.0.0.1:8000 /
+
+> Jika Anda masih memiliki kesalahan `TemplateDoesNotExist`, mencoba untuk me-ulang server Anda. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Gambar 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/static/css/list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+Jadi bagaimana Apakah situs web Anda terlihat sekarang? Mengunjunginya untuk mengetahui: http://127.0.0.1:8000 /
+
+![Gambar 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Kepala dan tubuh
+
+Setiap halaman HTML juga dibagi menjadi dua elemen: **kepala** dan **tubuh**.
+
+* **kepala** merupakan elemen yang berisi informasi tentang dokumen yang tidak ditampilkan di layar.
+
+* **tubuh** merupakan unsur yang berisi segala sesuatu yang lain yang ditampilkan sebagai bagian dari halaman web.
+
+Kami menggunakan `<head>` untuk memberi tahu browser tentang konfigurasi halaman, dan `<body>` untuk memberitahukannya tentang apa yang sebenarnya ada di halaman.
+
+Misalnya, Anda bisa memasukkan elemen judul halaman web ke dalam `<head>`, seperti ini:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Simpan dan refresh halaman Anda.
+
+![Gambar 11.3](images/step4.png)
+
+Perhatikan bagaimana browser telah dipahami bahwa "Ola's blog" adalah judul halaman Anda? Ini telah ditafsirkan `<title>Ola's blog</title>` dan ditempatkan teks di bar judul browser Anda (ini juga akan digunakan untuk bookmark dan seterusnya).
+
+Mungkin Anda juga memperhatikan bahwa setiap tag pembuka cocok dengan tag penutup * *, dengan ` / `, dan elemen itu * nested * (yaitu Anda dapat Tutup tag tertentu sampai semua yang ada di dalamnya sudah ditutup juga).
+
+Ini seperti memasukkan barang ke dalam kotak. Anda memiliki satu kotak besar, `<html> </html>`; Di dalamnya ada `<body> </body>`, dan itu berisi kotak yang masih lebih kecil: `<p> </p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Sesuaikan template Anda
+
+Anda sekarang bisa bersenang-senang dan mencoba menyesuaikan template Anda! Berikut adalah beberapa tag yang berguna untuk itu:
+
+* `<h1> Judul </h1>` untuk pos terpenting Anda
+* `<h2> Sub-judul </h2>` untuk judul di tingkat berikutnya
+* `<h3>Sub-sub-judul</h3>` ... dan seterusnya, sampai `<h6>`
+* `<p>Sebuah paragraf teks </p>`
+* `<em> teks</em>` menekankan teks Anda
+* `<strong>teks</strong>` sangat menekankan teks Anda
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` membuat sebuah link
+* `<ul> <li> item pertama </li> <li> item kedua </li> </ul>` membuat daftar, sama seperti yang ini!
+* `<div></div>` mendefinisikan bagian dari halaman
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Berikut adalah contoh template lengkap, copy dan paste ke `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Anak rok televisi sepak bola dan gas beracun. Donec id elit non mi porta gravida di eget Metus Sed congue. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Anak rok televisi sepak bola dan gas beracun. Donec id elit non mi porta gravida di eget Metus Sed congue. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Ini memberi kita efek ini:
+
+![Gambar 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+Apa yang sebenarnya ingin kita lakukan adalah menampilkan posting nyata yang ditambahkan di admin Django kita - dan ke sanalah kita akan pergi berikutnya.
+
+## Satu hal lagi: menyebarkan!
+
+Alangkah baiknya melihat semua ini dan tinggal di Internet kan? Mari kita lakukan PythonAnywhere lainnya :
+
+### Commit, and push your code up to GitHub
+
+Pertama, mari kita lihat file apa yang telah berubah sejak terakhir kita digunakan (jalankan perintah ini secara lokal, bukan di PythonAnywhere ):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Kita sudah hampir sampai, sekarang saatnya untuk menceritakannya untuk menyimpan perubahan ini dalam sejarahnya. Kami akan memberikan "pesan komit" di mana kami menggambarkan apa yang telah kami ubah. Anda dapat mengetikkan apa pun yang Anda inginkan pada tahap ini, namun sangat membantu untuk mengetikkan sesuatu yang deskriptif sehingga Anda dapat mengingat apa yang telah Anda lakukan di masa mendatang.
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Setelah kami selesai melakukannya, kami mengupload (mendorong) perubahan kami ke GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Menarik kode baru ke PythonAnywhere, dan isi ulang aplikasi web Anda
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/id-ID/installation/README.md b/id-ID/installation/README.md
new file mode 100644
index 00000000000..9e77dd7628d
--- /dev/null
+++ b/id-ID/installation/README.md
@@ -0,0 +1,68 @@
+# Jika Anda sedang melakukan tutorial di rumah
+
+Jika Anda melakukan tutorial ini di rumah, bukan di salah satu acara  Django Girls </ 0> , Anda benar-benar dapat melewatkan bab ini sekarang dan langsung ke  bab “Bagaimana Internet Bekerja”.</p> 
+
+Ini dikarenakan kami melindungi bagian-bagian pemasangan yang dimana bagian-bagian tersebut dibutuhkan di tutorial ini. Ini hanya halaman tambahan yang menggabungkan semua instruksi pemasangan di satu tempat ( yang sangat berguna untuk beberapa format ruang kerja). Bila anda mau anda dapat memilih untuk memasang semua yang ada di halaman ini sekarang. Namun bila anda ingin mulai belajar segala sesuatunya sebelum memasang banyak hal pada komputer anda, lewati bab ini dan nanti kami akan menjelaskan bagian-bagian pemasangan kepada anda, ini dikarenakan bagian-bagian tersebut sangat diperlukan.
+
+Semoga berhasil!
+
+# Bila anda menghadiri suatu seminar
+
+Bila anda menghadiri salah satu [ acara Django Girls](https://djangogirls.org/events/):
+
+* Ruang kerja anda mungkin memiliki “bagian pemasangan” sebelum ruang kerja utama. Jika anda ada di bagian pemangan, halaman ini adalah untuk anda! Ikuti instruksi-instruksi ini untuk mendapat semua yang anda butuhkan untuk pemasangan ruang kerja, bila perlu dengan bantuan para instruktur. Kemudian di ruang kerja utama, ketika anda menemukan instruksi-instruksi pemasangan di pelajaran utama, anda dapat melewati instruksi-instruksi tersebut.
+* Para penyelenggara seminar anda mungkin meminta anda untuk mencoba memasang semua di komputer anda dirumah sebelum seminar dimulai. Jika anda diminta untuk melakukannya, halaman ini untuk anda! Ikuti instruksi-instruksi dibawah ini sebaik mungkin. Dan pada saat anda berada di ruang kerja utama dan berada di bagian langkah pemasangan di pelajaran utama, anda bisa mendapatkan bantuan dari pelatih anda bila anda tidak dapat memasang bagian tersebut.
+* Jika seminar anda tidak memiliki bagian pemasangan (atau anda tidak dapat menghadirinya), dan bila para penyelenggara tidak meminta anda untuk memasang semua sebelum anda datang, lewati halaman ini dan langsung menuju ke bab [Bagaimana Internet Bekerja](../how_the_internet_works/README.md). And akan dapat memasang semua yang anda butuhkan karena anda bekerja melalui bimbingan.
+
+# Instalasi
+
+Dalam pelajaran ini anda akan dapat membuat sebuah blog. Agar dapat melakukannya, pada saat anda masuk ke bagian pelajaran tersebut anda akan diinstruksikan untuk bagaimana memasang berbagai perangkat lunak pada komputer anda dan membuat beberapa akun online karena itu sangat dibutuhkan. Halaman ini menggabungkan semua instruksi pemasangan dan pendaftaran dalam satu tempat (yang dimana sangat berguna untuk beberapa format ruang kerja).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md"%} 
+
+<!--endsec-->
+
+# Perkenalan singkat dengan macam perintah {#command-line}
+
+Banyak dari langkah-langkah dibawah menunjuk kepada “konsol atau console”, “terminal”, “perintah window atau window command”, atau “perintah atau command line” - semua ini memiliki makna yang sama yaitu sebuah jendela pada komputer anda dimana anda dapat memasukkan perintah-perintah. Pada saat anda sampai pada pelajaran utama, anda akan banyak belajar tentang baris perintah. Sekarang, bagian penting yang anda perlu ketahui adalah bagaimana membuka sebuah perintah window dan bagaimana bentuknya: {%termasuk “/perkenalan_kepada_baris_perintah/buka_instruksi.md” %}
+
+# Pasang Phyton {#python}
+
+{% termasuk “/python_pemasangan/instruksi.md” %}
+
+# Pasang sebuah kode pengeditan {#code-editor}
+
+{% termasuk “/code_editor/instruksi.md” %}
+
+# Buat virtualenv dan pasang Django {#virtualenv}
+
+{% termasuk “/django_pemasangan/instruksi.md” %}
+
+# Pasang Git {#git}
+
+{% termasuk “/menyebar/pasang_git.md” %}
+
+# Create a GitHub account {#github-account}
+
+Masuk ke [GitHub.com](https://www.github.com) dan daftar pengguna baru. Pastikan untuk ingat kata kuncu (tambahkan itu pada manajer kata kunci, bila anda menggunakannya).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% termasuk “/penyebaran/daftar_phytonanywhere.md” %}
+
+# Mulai membaca
+
+Selamat, anda sudah siap dan siap untuk pergi! Jika anda masih memiliki beberapa waktu sebelum seminar, akan sangat berguna untuk mulai membaca beberapa bab awal:
+
+* [Bagaimana internet bekerja](../how_the_internet_works/README.md)
+
+* [Pengenalan pada baris perintah](../intro_to_command_line/README.md)
+
+* [Pengenalan pada Phyton](../python_introduction/README.md)
+
+* [Apa itu Django?](../django/README.md)
+
+# Nikmati seminarnya!
+
+Pada saat anda memulai seminarnya, anda akan dapat langsung menuju ke [Projek Pertama Django!](../django_start_project/README.md) karena anda sudah menguasai semua bahan di bab-bab sebelumnya.
\ No newline at end of file
diff --git a/id-ID/intro_to_command_line/README.md b/id-ID/intro_to_command_line/README.md
new file mode 100644
index 00000000000..a49571ad6b0
--- /dev/null
+++ b/id-ID/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Pengantar antarmuka baris perintah
+
+> Bagi para pembaca di rumah: bab ini telah dibahas di video [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+Ini menarik kan? Anda akan menulis baris kode pertama Anda hanya dalam beberapa menit! :)
+
+**Mari kita perkenalkan Anda ke teman baru pertama Anda: baris perintah!**
+
+Langkah-langkah berikut akan menunjukkan cara menggunakan jendela hitam yang digunakan oleh semua hacker. Mungkin terlihat sedikit menakutkan pada awalnya tapi sebenarnya itu hanya sebuah prompt menunggu perintah dari Anda.
+
+> **Catatan** Perlu diketahui bahwa di sepanjang buku ini kita akan menggunakan istilah 'directory' dan 'folder' secara bergantian tetapi keduanya adalah satu dan sama.
+
+## Apa itu baris perintah?
+
+Jendela, yang biasanya disebut **command line**atau** antarmuka baris perintah**, adalah aplikasi berbasis teks untuk melihat, menangani, dan memanipulasi berkas di komputer Anda. Ini seperti Windows Explorer atau Finder di Mac, tapi tanpa antarmuka grafis. Nama lain dari baris perintah adalah: *cmd*, *CLI*, *prompt*, *konsol* atau *terminal*.
+
+## Buka antarmuka baris perintah
+
+Untuk mulai beberapa percobaan kita perlu untuk membuka baris-perintah antar muka dulu.
+
+{% include “/intro_to_command_line/open_instructions.md” %}
+
+## Jendela Perintah
+
+Anda sekarang sebaiknya melihat sebuah window hitam atau putih yang sedang menunggu perintah anda.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Bila anda ada di Mac atau Linux, anda akan melihat `$`, seperti ini:
+
+{% filename %}command-line {% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Di Windows, mungkin anda melihat `>`, seperti ini:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Lihat di bagian atas bagian Linux sekarang — anda akan melihat sesuatu yang sama seperti itu apabila anda masuk ke PhytonAnywhere nanti di tutorial ini.
+
+<!--endsec-->
+
+Setiap perintah akan didahulukan dengan `$` atau `>` dan satu tempat, namun anda tidak perlu mengetiknya. Komputer anda akan melakukannya untuk anda. :)
+
+> Hanya sebuah catatan kecil: dalam alatmh mungkin akan ada seperti `C:\Users\ola>`or ` Olas-MacBook-Air:~ola$` sebelum tanda coba, dan ini artinya 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Perintah pertama Anda (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami 
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Hal-hal dasar
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Direktori aktif
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd /
+    Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd 
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls 
+    Applications 
+    Desktop 
+    Downloads 
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solusi:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}baris-perinah{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Ringkasan
+
+Here is a summary of some useful commands:
+
+| Perintah (Windows) | Perintah (Mac OS / Linux) | Keterangan                  | Contoh                                             |
+| ------------------ | ------------------------- | --------------------------- | -------------------------------------------------- |
+| exit               | exit                      | menutup jendela kerja       | **exit**                                           |
+| cd                 | cd                        | mengganti direktori         | **cd tes**                                         |
+| cd                 | pwd                       | menunjukkan direktori aktif | **cd** (Windows) atau **pwd** (Mac OS / Linux)     |
+| dir                | ls                        | daftar direktori/file       | **dir**                                            |
+| copy               | cp                        | menyalin berkas             | **copy c:\tes\tes.txt c:\windows\tes.txt**     |
+| move               | mv                        | memindakan berkas           | **move c:\tes\tes.txt c:\windows\tes.txt**     |
+| mkdir              | mkdir                     | membuat direktori baru      | **mkdir direktorites**                             |
+| rmdir (or del)     | rm                        | menghapus berkas            | **del c:\tes\tes.txt**                           |
+| rmdir /S           | rm -r                     | menghapus direktori         | **rm -r testdirectory**                            |
+| [CMD] /?           | man [CMD]                 | get help for a command      | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Siap?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/id-ID/intro_to_command_line/open_instructions.md b/id-ID/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..60e9a1cff03
--- /dev/null
+++ b/id-ID/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Bergantung pada versi Windows dan keyboard Anda, salah satu dari yang berikut ini akan membuka jendela perintah (Anda mungkin harus bereksperimen sedikit, tetapi Anda tidak harus mencoba semua saran ini):
+
+- Buka menu Start atau layar Anda (desktop), dan ketik "Command Prompt" di kotak pencarian.
+- Pergi ke Start menu → Windows System → Command Prompt.
+- Buka Start menu → All Programs → Accessories → Command Prompt.
+- Pergi ke layar Start menu, alihkan mouse Anda ke bagian pojok kiri bawah layar Anda, dan klik panah bawah yang muncul (pada touch screen, geser jari Anda dari bawah ke atas pada layar). Halaman Aplikasi seharusnya terbuka. Klik pada Command Prompt di Windows System section.
+- Tahan tombol spesial Windows pada keyboard dan tekan tombol "X" bersamaan (windows + x). Pilih "Command Prompt" dari menu yang keluar.
+- Tahan tombol Windows dan tekan tombol "R" untuk dapat memunculkan jendela "Run" (windows + R). Ketik "cmd" di boxnya, dan klik tombol OK.
+
+![Ketik & quot; cmd & quot; di bagian & quot; Jalankan & quot; jendela](../python_installation/images/windows-plus-r.png)
+
+Kemudian dalam tutorial ini, Anda harus memiliki dua command windows terbuka secara bersamaan. Namun, pada beberapa versi Windows, jika Anda sudah memiliki satu command window terbuka dan Anda mencoba membuka yang kedua menggunakan metode yang sama, itu malah akan mengarahkan Anda ke command window yang sudah Anda buka. Cobalah pada komputer Anda dan lihat apa yang terjadi! Jika Anda hanya mendapatkan satu command window, cobalah satu atau lebih dari metode diatas. Setidaknya salah satunya akan menghasilkan command window baru yang dibuka.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Pergi ke Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Mungkin di bawah Applications → Accessories → Terminal, atau Applications → System → Terminal, tetapi itu mungkin tergantung pada sistem Anda. Jika Anda tidak bisa cobalah Google. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/id-ID/python_installation/README.md b/id-ID/python_installation/README.md
new file mode 100644
index 00000000000..b8258522d70
--- /dev/null
+++ b/id-ID/python_installation/README.md
@@ -0,0 +1,15 @@
+# Mari kita mulai dengan Python
+
+Kami akhirnya di sini!
+
+Tapi pertama, mari kita ceritakan apa itu Python. Python adalah bahasa pemrograman yang sangat populer yang bisa digunakan untuk membuat situs web, game, perangkat lunak ilmiah, grafis, dan banyak lagi.
+
+Python berasal pada akhir 1980-an dan tujuan utamanya adalah untuk dapat dibaca oleh manusia (tidak hanya mesin!). Inilah sebabnya mengapa tampilannya lebih sederhana daripada bahasa pemrograman lainnya, tapi jangan khawatir - Python juga sangat hebat!
+
+# Instalasi Python
+
+> **Catatan** Jika Anda menggunakan Chromebook, lewati bab ini dan pastikan Anda mengikuti [Pengaturan](../chromebook_setup/README.md) Chromebook.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md"%}
\ No newline at end of file
diff --git a/id-ID/python_installation/instructions.md b/id-ID/python_installation/instructions.md
new file mode 100644
index 00000000000..a1b2c83e6cb
--- /dev/null
+++ b/id-ID/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Bagi para pembaca di rumah: bab ini terangkum dalam video [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> Bagian ini dibuat berdasarkan tutorial yang dibuat oleh Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django ditulis menggunakan Python. Kita butuh Python untuk melakukan berbagai hal di Django. Yuk kita mulai menginstallnya! Kita menginginkan kamu menginstall Python 3, Jika kamu sudah memiliki versi sebelum itu, Kamu butuh upgrade versi yang akan kita install kali ini. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Jangan lupa menambahkan Python dapa Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/id-ID/python_introduction/README.md b/id-ID/python_introduction/README.md
new file mode 100644
index 00000000000..355673ccb53
--- /dev/null
+++ b/id-ID/python_introduction/README.md
@@ -0,0 +1,1070 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Pengenalan Python
+
+> Bagian dari bab ini didasarkan pada tutorial oleh Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Mari kita tulis beberapa kode!
+
+## Python prompt
+
+> Untuk pembaca di rumah: bagian ini tercakup dalam [Python Basicx: Integers, Strings, Lists, Variables dan Error](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+Untuk memulai python, kita perlu membuka *Comand line atau Jendela perintah* pada komputer anda. Anda seharusnya sudah tahu bagaimana melakukannya - Anda telah belajar di bagian [Pengenalan Halaman Perintah](../intro_to_command_line/README.md).
+
+Saat kamu sudah siap, ikuti instruksi dibawah ini.
+
+Kita ingin membuka konsol Python, Jadi silakan ketik `python` untuk Windows atau `python3` pada Mac OS/Linux dan tekan `Enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Perintah Python Pertama!
+
+Setelah menjalankan perintah Python, prompt akan berubah menjadi `>>>`. Bagi kita sekarang adalah kita harus menggunakan perintah pada bahasa Python saja. Kmau gak perlu mengetik pada perintah `>>>` - Python akan melakukannya untukmu.
+
+Jika Anda ingin keluar dari konsol Python, Cukup dengan mengetik perintah `exit()` atau menggunakan pintasan `Ctrl + Z` untuk Windows dan `Ctrl + D` untuk Mac/Linux. Kemudian kamu tidak akan melihat lagi `>>>`.
+
+Untuk saat ini, kami tidak ingin untuk keluar dari konsol Python. Kami ingin belajar lebih banyak tentang hal itu. Mari kita mulai dengan mengetik beberapa matematika, seperti `2 + 3` dan memukul `masuk`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Bagus! Lihat bagaimana balasan muncul keluar? Python tahu matematika! Anda bisa mencoba perintah lain seperti:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2
+`
+
+Untuk melakukan perhitungan eksponensial, katakan 2 pada power 3, kita ketik: {% filename %}baris perintah{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Bersenang-senang dengan ini sebentar dan kemudian kembali kesini. :)
+
+Seperti yang Anda lihat, Python adalah kalkulator yang hebat. Jika Anda bertanya-tanya apa lagi yang bisa Anda lakukan…
+
+## Kata
+
+Bagaimana dengan namamu? Ketik nama depan Anda dalam tanda kutip seperti ini:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 
+'OlaOlaOla'
+```
+
+Anda sekarang telah membuat string pertama Anda! Ini adalah urutan karakter yang bisa diolah oleh komputer. String harus selalu dimulai dan diakhiri dengan karakter yang sama. Ini mungkin tunggal (`'`) atau double (`"`) mengutip (tidak ada bedanya!) Kutipan memberi tahu Python bahwa apa yang ada di dalamnya adalah string.
+
+String bisa dirangkai. Coba ini:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+Anda juga bisa mengalikan string dengan angka:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Jika Anda perlu menempatkan tanda kutip di dalam string Anda, Anda memiliki dua cara untuk melakukannya.
+
+Menggunakan tanda kutip ganda:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' menuruni bukit'
+"Runnin' menuruni bukit"
+```
+
+atau keluar dari apostrof dengan garis miring terbalik (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' menuruni bukit'
+"Runnin' menuruni bukit"
+```
+
+Keren, Kan? Untuk melihat nama Anda dalam huruf kapital, cukup ketik:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Anda hanya menggunakan **method**`upper` pada string anda! Method (`upper`) adalah urutan instruksi yang Python harus melakukan pada objek tertentu ( ` " Ola " `) setelah anda menyebutnya.
+
+Jika Anda ingin tahu jumlah huruf yang terkandung dalam nama Anda, ada **function** untuk itu juga!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len ("Ola")
+3
+```
+
+Entah mengapa kadang-kadang Anda memanggil fungsi dengan `.` di akhir string (seperti `"Ola".upper()`) dan terkadang Anda pertama kali memanggil fungsi dan menempatkan string dalam kurung? Nah, dalam beberapa kasus, fungsi termasuk objek, seperti `upper()`, yang hanya bisa dilakukan pada string. Dalam hal ini, kita sebut fungsi sebuah **metode**. Di lain waktu, fungsi tidak termasuk dalam sesuatu yang spesifik dan dapat digunakan pada berbagai jenis objek, seperti `len()`. Itu sebabnya kami memberi `"Ola"` sebagai parameter pada fungsi `len`.
+
+### Ringkasan
+
+OK, cukup banyak senar. Sejauh ini Anda telah belajar tentang:
+
+- **prompt** - perintah mengetik (kode) ke prompt Python menghasilkan jawaban dengan Python
+- **nomor dan string** - dengan nomor Python digunakan untuk matematika dan string untuk objek teks
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **fungsi** - seperti `atas()` dan `len()`, lakukan tindakan pada objek.
+
+Ini adalah dasar dari setiap bahasa pemrograman yang Anda pelajari. Siap untuk sesuatu yang lebih sulit? Kami yakin Anda!
+
+## Kesalahan
+
+Mari kita coba sesuatu yang baru. Bisakah kita mendapatkan panjang sejumlah cara yang sama kita bisa mengetahui panjang nama kami? Ketik di `len(304023)` dan tekan `Masukkan`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Kami punya kesalahan pertama kami! Ikon {{ warning_icon }} adalah cara kami memberi Anda kepala up yang Anda akan menjalankan kode tidak bekerja seperti yang diharapkan. Membuat kesalahan (bahkan disengaja yang) yang merupakan bagian penting dari belajar!
+
+Dikatakan bahwa objek dari jenis "int" (bilangan bulat, bilangan bulat) memiliki panjang tidak. Jadi apa yang dapat kita lakukan sekarang? Mungkin kita dapat menulis nomor kami sebagai string? String memiliki panjang, kanan?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+```
+
+Itu berhasil! Kami menggunakan fungsi `str` dalam fungsi `len`. `Str()` mengkonversi segala sesuatu ke string.
+
+- Fungsi `int` mengubah semuanya menjadi **bilangan bulat**
+- Fungsi `int` mengubah hal-hal menjadi **bilangan bulat**
+
+> Penting: kita bisa mengonversi bilangan menjadi teks, tapi kita tidak bisa mengubah teks menjadi angka - apa yang akan `int ('halo')` jadi?
+
+## Variabel
+
+Konsep penting dalam pemrograman adalah variabel. Variabel adalah tidak lebih dari sebuah nama untuk sesuatu sehingga Anda dapat menggunakannya nanti. Programmer menggunakan variabel ini untuk menyimpan data, membuat kode mereka lebih mudah dibaca dan sehingga mereka tidak perlu tetap mengingat apa hal-hal yang.
+
+Katakanlah kita ingin membuat sebuah variabel baru yang disebut `nama`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> nama = "Ola"
+```
+
+Kita ketik nama sama Ola.
+
+Seperti yang telah Anda sadari, program Anda tidak mengembalikan hal seperti sebelumnya. Jadi bagaimana kita tahu bahwa sebenarnya variabel itu ada? Cukup masukkan `name`dan tekan `Enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Hura! Variabel pertama Anda! :) Anda selalu dapat mengubah apa yang ia merujuk kepada:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+Anda dapat menggunakannya dalam fungsi juga:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Bagus kan? Variabel dapat berisi segalanya, termasuk angka. Coba yang berikut ini:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Tapi bagaimana jika kita menggunakan nama yang salah? Dapatkah kamu menebak apa yang akan terjadi? Mari kita coba!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Kesalahan! Seperti yang Anda lihat, Python memiliki berbagai jenis kesalahan dan satu ini disebut **NameError**. Python akan memberikan kesalahan ini jika Anda mencoba menggunakan sebuah variabel yang belum didefinisikan belum. Jika Anda mengalami kesalahan ini kemudian, memeriksa kode Anda untuk melihat jika Anda telah salah ketik nama.
+
+Bermain dengan ini untuk sementara waktu dan lihat apa yang dapat Anda lakukan!
+
+## Fungsi cetak
+
+Coba ini:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Ketika Anda cukup mengetikkan `nama`, Python interpreter merespon dengan *representasi* string variabel 'nama', yang huruf M-a-r-i-a, dikelilingi oleh tanda kutip tunggal, ''. Ketika Anda mengatakan `print(name)`, Python akan "cetak" isi dari variabel ke layar, tanpa tanda kutip, yang merupakan lebih rapi.
+
+Seperti yang kita akan lihat nanti, `print()` ini juga berguna ketika kita ingin mencetak sesuatu dari di dalam fungsi, atau ketika kita ingin mencetak hal pada beberapa baris.
+
+## Daftar
+
+Beside strings and integers, Python has all sorts of different types of objects. Sekarang kita akan mengenalkan salah satunya yaitu **list**. Lists persis yang Anda pikirkan: objek yang merupakan kumpulan dari objek-objek. :)
+
+Mari dan buat list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Ya, daftar ini kosong. Tidak terlalu berguna kan? Mari buat daftar nomor undian. Kami tidak ingin mengulangi diri kami sepanjang waktu, jadi kami akan memasukkannya ke dalam variabel juga:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+Baiklah, kita punya daftar! Apa yang bisa kita lakukan dengan itu? Mari kita lihat berapa jumlah undian yang ada dalam daftar. Apakah Anda tahu fungsi mana yang harus Anda gunakan untuk itu? Anda sudah tahu ini!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Ya! `Len()` dapat memberikan sejumlah objek dalam daftar. Handy, kanan? Mungkin kita akan semacam itu sekarang:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Ini tidak kembali apa-apa, ini hanya mengubah urutan di mana nomor muncul dalam daftar. Mari kita mencetak lagi dan melihat apa yang terjadi:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> cetak (undian)
+[3, 12, 19, 30, 42, 59]
+```
+
+Seperti yang Anda lihat, angka-angka dalam daftar diurutkan sekarang dari nilai terendah ke tertinggi. Congrats!
+
+Mungkin kita ingin terbalik urutan itu? Mari kita lakukan!
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> lottery.reverse ()
+>>> cetak (undian)
+[59, 42, 30, 19, 12, 3]
+```
+
+Jika Anda ingin menambahkan sesuatu ke daftar Anda, Anda dapat melakukan ini dengan mengetik perintah ini:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> lottery.append (199)
+>>> cetak (undian)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Jika Anda ingin menampilkan hanya nomor pertama, Anda dapat melakukan ini dengan menggunakan **indeks**. Sebuah indeks adalah angka yang mengatakan di mana dalam daftar sebuah item terjadi. Programmer lebih memilih untuk mulai menghitung 0, jadi obyek pertama dalam daftar Anda di indeks 0, berikutnya adalah 1, dan sebagainya. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> cetak (undian[0])
+59
+>>> cetak (undian [1])
+42
+```
+
+Seperti yang Anda lihat, Anda dapat mengakses objek yang berbeda dalam daftar Anda dengan menggunakan daftar nama dan indeks objek dalam kurung.
+
+Untuk menghapus sesuatu dari daftar Anda Anda akan perlu menggunakan **indeks** seperti yang kita pelajari di atas dan metode `pop()`. Mari kita coba contoh dan memperkuat apa yang kita pelajari sebelumnya; kami akan menghapus nomor pertama dari daftar kami.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> cetak (undian)
+[59, 42, 30, 19, 12, 3, 199]
+>>> cetak (undian[0])
+59
+>>> lottery.pop(0)
+59
+>>> cetak(undian)
+[42, 30, 19, 12, 3, 199]
+```
+
+Yang bekerja seperti pesona!
+
+Untuk bersenang-senang tambahan, mencoba beberapa indeks: 6, 7, 1000, 1,-6 atau-1000. Lihat jika Anda dapat memprediksi hasil sebelum mencoba perintah. Apakah hasil akal?
+
+Anda dapat menemukan daftar semua tersedia daftar metode dalam bab ini Python dokumentasi: https://docs.python.org/3/tutorial/datastructures.html
+
+## Kamus
+
+> Bagi pembaca di rumah: bagian ini tercakup dalam video [Python Basics: Functions](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+Kamus ini mirip dengan daftar, tapi Anda mengakses nilai dengan mencari kunci bukan sebuah angka indeks. Kunci dapat string atau nomor apapun. Sintaks untuk mendefinisikan Kamus kosong adalah:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Ini menunjukkan bahwa Anda baru saja membuat kamus kosong. Hore!
+
+Sekarang, coba menulis perintah berikut (coba mengganti informasi Anda sendiri, terlalu):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> peserta = {'nama': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+Dengan perintah ini, Anda hanya menciptakan variabel bernama `peserta` dengan tiga pasangan kunci-nilai:
+
+- Kunci `nama` menunjuk ke nilai `'Ola'` (a `string` objek),
+- `negara` menunjuk ke `'Polandia'` (string `lainnya`),
+- dan `favorite_numbers` menunjuk ke `[7, 42, 92]` (a `daftar` dengan tiga nomor di dalamnya).
+
+Anda dapat memeriksa isi kunci individu dengan sintaks ini:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Lihat, mirip dengan daftar. Tetapi Anda tidak perlu mengingat indeks – hanya nama.
+
+Apa yang terjadi jika kita bertanya Python nilai kunci yang tidak ada? Dapatkah Anda menebak? Mari kita mencoba dan melihat!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> peserta['usia']
+Traceback (panggilan terakhir):
+  File "<stdin>", baris 1, di <module>
+KeyError: 'usia'
+```
+
+Tampilan, kesalahan lain! Ini adalah **KeyError**. Python membantu dan memberitahu Anda bahwa kunci `'usia'` tidak ada dalam Kamus ini.
+
+Kapan kamu harus menggunakan dictionary atau list? Nah, itu bagus untuk direnungkan. Pikirkan saja jawabannya sebelum melihat jawabannya di baris berikutnya.
+
+- Anda hanya perlu memesan urutan item? Pergi untuk daftar.
+- Apakah Anda perlu menghubungkan nilai dengan tombol, sehingga Anda dapat mencarinya efisien (dengan kunci) kemudian? Menggunakan Kamus.
+
+Kamus, seperti daftar, yang *bisa berubah*, berarti bahwa mereka dapat mengubah setelah mereka diciptakan. Anda dapat menambahkan baru pasangan kunci-nilai ke kamus setelah itu diciptakan, seperti ini:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Saya harap ini masuk akal sampai sekarang. :) Siap untuk bersenang-senang dengan kamus? Baca terus untuk beberapa hal yang menakjubkan.
+
+Anda dapat menggunakan metode ` pop () ` untuk menghapus item dalam kamus. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Ikhtisar
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **error** - Anda sekarang tahu bagaimana membaca dan memahami kesalahan yang muncul jika Python tidak mengerti perintah yang Anda berikan
+- **variabel** - nama untuk objek yang memungkinkan kode Anda lebih mudah dan membuat kode Anda lebih mudah dibaca
+- **daftar** - daftar objek yang tersimpan dalam urutan tertentu
+- **kamus** - objek yang disimpan sebagai pasangan kunci-nilai
+
+Excited for the next part? :)
+
+## Bandingkan hal-hal
+
+> Bagi pembaca di rumah: bagian ini tercakup dalam [Dasar-dasar Python: Perbandingan](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+Benar
+>>> 3 < = 2
+Salah
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y berarti: x lebih besar dari y
+- x `<` y berarti: x kurang dari y
+- x `<=` y berarti: x kurang dari atau sama dengan y
+- x `>=` y berarti: x lebih besar dari atau sama dengan y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **dan** - jika Anda menggunakan operator `dan`, kedua perbandingan harus benar agar keseluruhan perintah menjadi True
+- **atau** - jika Anda menggunakan operator `atau`, hanya satu perbandingan yang harus Benar agar seluruh perintah menjadi Benar
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- Benar
+- Salah
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> a = benar
+>>> a
+Benar
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `Benar dan Benar`
+- `Salah dan benar`
+- `Benar atau 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Simpan itu!
+
+> Untuk pembaca di rumah: bagian ini tercakup dalam [Dasar-dasar Python: Menyimpan file dan "Jika" pernyataan](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Keluar dari juru bahasa Python
+- Buka editor pilihan kami
+- Simpan beberapa kode ke file python baru
+- Menjalankannya!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Catatan** Anda harus memperhatikan salah satu hal yang paling keren tentang editor kode: warna! Di konsol Python, semuanya warnanya sama; Sekarang Anda harus melihat bahwa fungsi `print` adalah warna yang berbeda dari string. Ini disebut "penyorotan sintaks", dan ini adalah fitur yang sangat berguna saat mengkodekan. Warna benda akan memberi petunjuk, seperti string yang tidak ditutup atau salah ketik pada nama kata kunci (seperti ` def ` dalam sebuah fungsi, yang akan kita lihat di bawah). Inilah salah satu alasan kita menggunakan kode editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}garis komando{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}garis komando{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Deskop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py Halo, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## Jika ... elif ... lain
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### Bagaimana jika sebuah kondisi tidak benar?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 memang lebih besar dari 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hei Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py Sempurna, saya bisa mendengar semua detailnya
+    
+
+## Komentar
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Ikhtisar
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** - jenis objek yang hanya bisa memiliki satu dari dua nilai: `Benar` atau`Salah`
+- ** Simpan file** - menyimpan kode dalam file sehingga Anda bisa menjalankan program yang lebih besar.
+- **jika…elif…lain** - pernyataan yang memungkinkan Anda untuk mengeksekusi kode hanya bila kondisi tertentu terpenuhi.
+- **perintah** - baris yang tidak akan dijalankan Python yang memungkinkan Anda mendokumentasikan kode Anda
+
+Time for the last part of this chapter!
+
+## Fungsi anda sendiri
+
+> Bagi pembaca di rumah: bagian ini tercakup dalam video [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- Jika Anda mendapatkan `kesalahan nama`, itu mungkin berarti Anda mengetikkan sesuatu yang salah, jadi Anda harus memeriksa bahwa Anda menggunakan nama yang sama saat membuat fungsi dengan `def hi():` dan kapan memanggilnya dengan `hi()`.
+- Jika Anda mendapatkan `IndentationError`, periksalah bahwa kedua baris `cetak` memiliki spasi yang sama di awal baris: python menginginkan semua kode di dalam fungsi disesuaikan dengan rapi.
+- Jika tidak ada output sama sekali, periksa apakah yang terakhir `hi()` *tidak* indentasi - jika memang demikian, baris itu juga akan menjadi bagian dari fungsi, dan itu akan tidak pernah lari.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi (nama):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hai anonim!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> Bagi pembaca di rumah: bagian ini tercakup dalam [Dasar-dasar Python: Untuk video Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0).
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+untuk nama pada anak perempuan:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+untuk saya di kisaran (1, 6):
+    cetak(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Ikhtisar
+
+Itu dia. ** Kamu hebat! ** Bab ini sama sekali tidak mudah, Anda harus bangga. Kami bangga dengan Anda karena telah berhasil sampai di sini!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+Sebelum Anda melanjutkan ke bab berikutnya, lakukan sesuatu yang lain - meregangkan, berlari, menenangkan mata Anda. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/id-ID/template_extending/README.md b/id-ID/template_extending/README.md
new file mode 100644
index 00000000000..33de5cd27fb
--- /dev/null
+++ b/id-ID/template_extending/README.md
@@ -0,0 +1,149 @@
+# Template memperpanjang
+
+Hal baik lain yang Django miliki untuk Anda adalah ** template yang diperluas </ 0>. Apa artinya ini? Ini berarti Anda dapat menggunakan bagian HTML yang sama untuk berbagai halaman situs web Anda.</p> 
+
+Template membantu bila kamu ingin menggunakan informasi atau tata letak yang sama di lebih dari satu tempat. Kamu tidak perlu mengulang sendiri di setiap file. Dan jika kamu ingin mengubah sesuatu, Anda tidak perlu melakukannya di setiap template, hanya satu!
+
+## Buat template dasar
+
+Template dasar adalah template paling dasar yang Anda tambahkan di setiap halaman situs web kamu.
+
+Ayo buat file ` base.html </ 0> di <code> blog / templates / blog / </ 0>:</p>
+
+<pre><code>blog └───templates
+     └───blog
+             base.html
+             post_list.html
+`</pre> 
+
+Kemudian buka dan salin semua dari `post_list.html` ke `base.html` file, Seperti ini:
+
+{% filenama %}blog/template/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Kemudian di `base.html`, ganti seluruh `<body>` ( diantara semua `<body>` dan `</body>`) dengan ini:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw%} Anda mungkin melihat ini mengganti semuanya dari ` {% untuk posting di posting%} </ 0> menjadi <code> {% endfor%} </ 0> dengan: {% endraw%}</p>
+
+<p>{% filename %}blog/templates/blog/base.html{% endfilename %}</p>
+
+<pre><code class="html">{% block content %}
+{% endblock %}
+`</pre> 
+
+Tapi mengapa? Anda baru saja membuat `block`! Anda menggunakan template tag `{% blok %}` Untuk membuat area yang memiliki HTML yang Dimasukkan didalamnya. HTML akan datang dari template lain yang memperluas template ini (`base.html`). Kami akan menunjukkan kepada kamu bagaimana melakukan ini dalam sesaat.
+
+Sekarang simpan`base.html` dan buka `blog/template/blog/post_list.html` kamu lagi di kode editor. {% raw %} kamu akan menghapus segalanya diatas `{% for post in posts %}` dan dibawah `{% endfor %}`. Saat kamu sudah selesai, berkas akan terlihat seperti ini:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Kami akan menggunakan ini sebagai bagian dari template kami untuk semua konten blok. Saatnya untuk menambahkan tag blok untuk berkas ini!
+
+{% raw %} Anda ingin tag blok anda cocok dengan tag di dalam berkas `base.html` anda. Anda juga ingin memasukkan semua kode yang termasuk dalam blok konten Anda. Untuk melakukannya, letakkan semuanya diantara `{% block content %}` dan `{% endblock %}`. Seperti ini:{% endraw %}
+
+{% filename %}blog/template/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Hanya tersisa satu hal. Kita perlu menghubungkan dua template ini bersama-sama. Inilah semua tentang memperluas template! Kami akan melakukan ini dengan menambahkan tag meluas ke awal file. Seperti ini:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Itu saja! Simpan filenya, dan periksa apakah situs Anda berfungsi dengan baik. :)
+
+> Jika Anda mendapatkan error `TemplateDoesNotExist`, itu berarti tidak ada file `blog/base.html`dan Anda memiliki `runserver` yang berjalan di konsol. Cobalah untuk menghentikannya (dengan menekan Ctrl+C - tombol Control and C bersamaan) dan restart dengan menjalankan perintah `python manage.py runserver`.
\ No newline at end of file
diff --git a/id-ID/whats_next/README.md b/id-ID/whats_next/README.md
new file mode 100644
index 00000000000..f7d4716f9f2
--- /dev/null
+++ b/id-ID/whats_next/README.md
@@ -0,0 +1,43 @@
+# Apa berikutnya?
+
+Beri selamat kepada anda sendiri! **Kamu sangat hebat!**. Kami bangga! <3
+
+### Apa yang harus dilakukan sekarang?
+
+Istirahat sejenak dan santai! Anda baru saja melakukan hal besar.
+
+Follow Django Girls di [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) jangan sampai ketinggalan.
+
+### Adakah rekomendasi belajar yang lainnya?
+
+Ya! Ada *sangat banyak* sumber daya online untuk mempelajari semua jenis keterampilan pemrograman - mungkin cukup menakutkan untuk mengetahui apa yang harus dilakukan selanjutnya, tetapi kami telah membantu Anda. Apa pun minat Anda sebelum Anda datang ke Django Girls, dan minat apa pun yang Anda kembangkan selama tutorial, berikut adalah beberapa sumber daya gratis (atau sumber daya dengan komponen gratis yang besar) yang dapat Anda gunakan untuk mencapai tempat yang Anda inginkan.
+
+#### Django
+
+- Buku Kami lainnya, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Tutorial resmi Django](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Memulai dengan pelajaran video Django](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Kursus pengembangan web Codecademy](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Kursus Codecademy's Python](https://www.codecademy.com/learn/learn-python)
+- [Kursus Google's Python](https://developers.google.com/edu/python/)
+- Buku [Learn Python The Hard Way](http://learnpythonthehardway.org/book/) – latihan pertama gratis
+- [New Coder tutorials](http://newcoder.io/tutorials/) – berbagai contoh praktis tentang bagaimana Python dapat digunakan
+- [edX](https://www.edx.org/course?search_query=python) – Anda dapat menguji sebagian besar kursus secara gratis, tetapi jika Anda ingin mendapatkan sertifikat atau kredit untuk pendidikan lebih lanjut, Anda akan dikenakan biaya
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – beberapa kuliah video dapat diputar secara gratis dan Anda bisa mendapatkan Sertifikat Coursera dengan mengikuti kursus ini
+- [Python for Everybody](https://www.py4e.com/) - versi gratis dan terbuka dari Coursera Python untuk pembelajar tingkat apapun
+
+#### Bekerja dengan data
+
+- [Kursus Codecademy's data science](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – Anda dapat menguji sebagian besar kursus secara gratis, tetapi jika Anda ingin mendapatkan sertifikat atau kredit untuk pendidikan lebih lanjut, Anda akan dikenakan biaya
+- [Dataquest](https://www.dataquest.io/) – 30 "missions" (misi) pertama gratis
+
+Kami tidak sabar untuk melihat apa yang akan Anda buat!
\ No newline at end of file
diff --git a/id/GLOSSARY.md b/id/GLOSSARY.md
new file mode 100644
index 00000000000..e51bb817523
--- /dev/null
+++ b/id/GLOSSARY.md
@@ -0,0 +1,3 @@
+# Editor Kode
+
+Editor kode adalah sebuah aplikasi yang memungkinkan anda menyimpan kode anda sehingga anda akan dapat membukannya kembali. Anda dapat belajar dimana dapat memperolehnya di bab [Editor Kode](./code_editor/README.md)
\ No newline at end of file
diff --git a/id/README.md b/id/README.md
new file mode 100644
index 00000000000..20999ffa72c
--- /dev/null
+++ b/id/README.md
@@ -0,0 +1,51 @@
+# Tutorial Django Girls
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Karya ini dilisensikan dengan Lisensi Internasional Creative Commons Attribution-ShareAlike 4.0. Untuk melihat salinan lisensi ini, kunjungi https://creativecommons.org/licenses/by-sa/4.0/
+
+## SELAMAT DATANG
+
+Selamat datang di Tutorial Django Girls! Kami senang melihat Anda di sini :) Dalam tutorial ini, kami akan membawa Anda ke sebuah perjalanan di bawah tenda teknologi web, menawarkan sekilas semua potongan dan potongan yang perlu disatukan untuk membuat pekerjaan web seperti yang kita ketahui. saya t.
+
+Seperti semua hal yang tidak diketahui, ini akan menjadi petualangan - tapi jangan khawatir, karena Anda sudah berusaha keras untuk berada di sini, Anda akan baik-baik saja :)
+
+## pengantar
+
+Pernahkah Anda merasa bahwa dunia lebih dan lebih banyak tentang teknologi yang tidak dapat Anda ketahui (belum) berhubungan? Pernahkah Anda bertanya-tanya bagaimana cara membuat situs web tapi tidak pernah memiliki cukup motivasi untuk memulai? Pernahkah Anda berpikir bahwa dunia perangkat lunak terlalu rumit untuk Anda coba melakukan sesuatu sendiri?
+
+Nah, kami punya kabar baik untukmu! Pemrograman tidak sesulit yang terlihat dan kami ingin menunjukkan betapa menyenangkannya itu.
+
+Tutorial ini tidak akan secara ajaib mengubah Anda menjadi programmer. Jika Anda ingin menjadi ahli dalam hal ini, Anda memerlukan waktu berbulan-bulan bahkan bertahun-tahun untuk belajar dan berlatih. Tapi kami ingin menunjukkan bahwa pemrograman atau pembuatan situs web tidak serumit tampilannya. Kami akan mencoba untuk menjelaskan potongan dan potongan yang berbeda sebaik yang kami bisa, jadi Anda tidak akan merasa terintimidasi oleh teknologi.
+
+Kami berharap bahwa kami akan dapat membuat anda mencintai teknologi sebagaimana kami juga mencintainya.
+
+## Apa yang akan anda pelajari dalam tutorial ini?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+Hasilnya kurang lebih akan seperti ini:
+
+![Gambar 0.1](images/application.png)
+
+> Jika Anda bekerja dengan tutorial Anda sendiri dan tidak memiliki pelatih yang akan membantu Anda jika terjadi masalah, kami memiliki sistem obrolan untuk Anda: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Kami meminta kepada pelatih kami dan peserta sebelumnya untuk masuk ke sana untuk membantu orang lain mempelajari tutorial ini! Jangan sungkan untuk bertanya di sana!
+
+Oke, [mari kita mulai dari awal…](./how_the_internet_works/README.md)
+
+## Mengikuti tutorial di rumah
+
+Sungguh menakjubkan bisa ambil bagian dalam lokakarya Django Girls, tapi kami sadar bahwa tidak selalu mungkin untuk menghadiri acara tersebut. Inilah sebabnya kami mendorong Anda untuk mencoba mengikuti tutorial ini di rumah. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. Ini masih merupakan pekerjaan yang sedang berjalan, tapi semakin banyak hal akan segera ditutup di [Pengodean adalah untuk anak perempuan](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed)kanal Youtube.
+
+Di setiap bab yang sudah dibahas, ada tautan yang mengarah ke video yang benar.
+
+## Tentang Tutorial Ini dan Bagaimana Cara Berkontribusi
+
+Tutorial ini diselenggarakan oleh [DjangoGirls](https://djangogirls.org/). Jika Anda menemukan kesalahan atau ingin mengupdate tutorialnya silahkan [ikuti panduan kontribusi](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Saat ini, terjemahan disimpan di platform crowdin.com di:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/id/SUMMARY.md b/id/SUMMARY.md
new file mode 100644
index 00000000000..95ca9fcfd7c
--- /dev/null
+++ b/id/SUMMARY.md
@@ -0,0 +1,27 @@
+# Ikhtisar
+
+* [Pengenalan](README.md)
+* [Instalasi](installation/README.md)
+* [Instalasi (chromebook)](chromebook_setup/README.md)
+* [Bagaimana Internet Bekerja](how_the_internet_works/README.md)
+* [Pengenalan Pada Command Line](intro_to_command_line/README.md)
+* [Instalasi Python](python_installation/README.md)
+* [Teks editor](code_editor/README.md)
+* [Pengenalan Python](python_introduction/README.md)
+* [Apa itu Django ?](django/README.md)
+* [Installasi Django](django_installation/README.md)
+* [Project Django pertamamu!](django_start_project/README.md)
+* [Model Django](django_models/README.md)
+* [Admin Django](django_admin/README.md)
+* [Deploy (Publikasikan)](deploy/README.md)
+* [Urls Django](django_urls/README.md)
+* [Tampilan Django - waktu untuk membuat!](django_views/README.md)
+* [Pengantar untuk HTML](html/README.md)
+* [Django ORM (Queryset)](django_orm/README.md)
+* [Dinamis data dalam template](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS - membuatnya cantik](css/README.md)
+* [Template memperpanjang](template_extending/README.md)
+* [Perluas aplikasi Anda](extend_your_application/README.md)
+* [Form Django](django_forms/README.md)
+* [Apa selanjutnya?](whats_next/README.md)
\ No newline at end of file
diff --git a/id/chromebook_setup/README.md b/id/chromebook_setup/README.md
new file mode 100644
index 00000000000..be14bd5f421
--- /dev/null
+++ b/id/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Penyiapan Chromebook
+
+> ** Catatan </ 0> Jika Anda sudah mengerjakan langkah-langkah Instalasi, tidak perlu melakukan ini lagi - Anda bisa langsung melewati [ Introduction to Python ](../python_introduction/README.md) .</p> </blockquote> 
+> 
+> {% include "/chromebook_setup/instructions.md"%}
\ No newline at end of file
diff --git a/id/chromebook_setup/instructions.md b/id/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..05d5f38d721
--- /dev/null
+++ b/id/chromebook_setup/instructions.md
@@ -0,0 +1,59 @@
+Anda dapat  melewatkan hak atas bagian ini </ 0> jika Anda tidak menggunakan Chromebook. Jika ya, pengalaman instalasi Anda akan sedikit berbeda. Anda bisa mengabaikan sisa instruksi penginstalan.</p> 
+
+### Awan 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. Untuk durasi tutorial, Cloud 9 akan bertindak sebagai * mesin lokal </ 0> Anda . Anda masih akan menjalankan perintah di antarmuka terminal seperti teman sekelas Anda di OS X, Ubuntu, atau Windows, namun terminal Anda akan terhubung ke komputer yang berjalan di tempat lain yang ditetapkan Cloud 9 untuk Anda.</p> 
+
+1. Pasang Cloud 9 dari  penyimpanan web Chrome </ 0></li> 
+    
+    - Pergi ke  c9.io </ 0></li> 
+        
+        - Daftar ke akun
+        - Klik * Buat Workspace Baru </ 0></li> 
+            
+            - Nama itu * Django-girls </ 0></li> 
+                
+                - Pilih * Blank </ 0> (kedua dari kanan di baris bawah dengan logo oranye)</li> </ol> 
+                    
+                    Sekarang Anda harus melihat sebuah antarmuka dengan sidebar, jendela utama yang besar dengan beberapa teks, dan sebuah jendela kecil di bagian bawah yang terlihat seperti ini:
+                    
+                    {% filename%} Cloud 9 {% endfilename%}
+                    
+                        yourusername: ~ / workspace $
+                        
+                    
+                    This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+                    
+                    ### Lingkungan Virtual
+                    
+                    Lingkungan virtual (juga disebut virtualenv) adalah seperti kotak pribadi yang bisa kita gunakan untuk kode proyek komputer yang kita kerjakan. Kami menggunakannya untuk menyimpan berbagai bit kode yang kami inginkan untuk berbagai proyek kami sehingga hal-hal tidak tercampur aduk antara proyek.
+                    
+                    Di terminal Anda di bagian bawah antarmuka Cloud 9, jalankan yang berikut ini:
+                    
+                    {% filename%} Cloud 9 {% endfilename%}
+                    
+                        sudo apt update sudo apt install python3.6-venv
+                        
+                    
+                    Jika ini masih tidak berhasil, mintalah bantuan untuk pelatih Anda.
+                    
+                    Selanjutnya, jalankan:
+                    
+                    {% filename%} Cloud 9 {% endfilename%}
+                    
+                        mkdir djangogirls cd djangogirls python3.6 -mvenv myvenv source myvenv / bin / mengaktifkan pip install django ~ = 1.11.0
+                        
+                    
+                    (perhatikan bahwa pada baris terakhir kita menggunakan tilde diikuti dengan tanda sama: ~ =).
+                    
+                    ### Github
+                    
+                    Buat akun  Github </ 0> .</p> 
+                    
+                    ### PythonAnywhere
+                    
+                    Tutorial Django Girls menyertakan bagian tentang apa yang disebut Deployment, yaitu proses mengambil kode yang memberi kekuatan pada aplikasi web baru Anda dan memindahkannya ke komputer yang dapat diakses publik (disebut server) sehingga orang lain dapat melihat pekerjaan Anda.
+                    
+                    Bagian ini sedikit aneh saat melakukan tutorial di Chromebook karena kita sudah menggunakan komputer yang ada di Internet (berlawanan dengan, katakanlah, laptop). Namun, ini masih berguna, karena kita dapat memikirkan ruang kerja Cloud 9 kita sebagai tempat atau karya "dalam proses" kita dan Python Anywhere sebagai tempat untuk memamerkan barang-barang kita karena menjadi lebih lengkap.
+                    
+                    Jadi, masuk ke akun Python Anywhere baru di  www.pythonanywhere.com </ 0> .</p>
\ No newline at end of file
diff --git a/id/code_editor/README.md b/id/code_editor/README.md
new file mode 100644
index 00000000000..3a603347b69
--- /dev/null
+++ b/id/code_editor/README.md
@@ -0,0 +1,11 @@
+# Editor kode
+
+> Bagi pembaca di rumah: bab ini tercakup dalam  Memasang Python & amp; Editor Kode </ 0> video.</p> </blockquote> 
+> 
+> Anda akan menulis baris kode pertama Anda, jadi sekarang saatnya mendownload editor kode!
+> 
+> > ** Catatan </ 0> Jika Anda menggunakan Chromebook, lewati bab ini dan pastikan Anda mengikuti petunjuk  Pengaturan Chromebook </ 1> .</p> 
+> > 
+> > ** Catatan </ 0> Anda mungkin telah melakukan ini sebelumnya di bab Instalasi - jika demikian, Anda dapat langsung melewati bab berikutnya!</p> </blockquote> 
+> > 
+> > {% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/id/code_editor/instructions.md b/id/code_editor/instructions.md
new file mode 100644
index 00000000000..ebb7689069c
--- /dev/null
+++ b/id/code_editor/instructions.md
@@ -0,0 +1,31 @@
+Ada banyak teks editor yang tersedia dan kita dapat memilih salah satu yang kita suka. Sebagian besar programmer Python menggunakan IDE (Integrated Development Environment) yang rumit namun memiliki banyak fitur, seperti PyCharm. Aplikasi seperti PyCharm menurut kami kurang sesuai untuk digunakan oleh pemula. Oleh sebab itu kami menyarankan aplikasi yang lebih sederhana namun memiliki fitur tak kalah lengkap.
+
+Saran kami ada di bawah, tapi jangan ragu untuk bertanya pada pelatih apa preferensi mereka - akan lebih mudah mendapatkan bantuan dari mereka.
+
+## Gedit
+
+Gedit adalah sebuah aplikasi teks editor yang open-source, gratis, dan tersedia untuk semua sistem operasi.
+
+[Download disini](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download disini](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download disini](https://atom.io/)
+
+## Mengapa Kita Perlu Memasang Aplikasi Teks Editor?
+
+Pembaca mungkin bertanya-tanya mengapa kita perlu memasang aplikasi teks editor dan tidak menggunakan editor biasa seperti Word atau Notepad.
+
+Alasan pertama adalah kode itu harus ** teks biasa </ 0> , dan masalah dengan program seperti Word dan Textedit adalah bahwa mereka sebenarnya tidak menghasilkan teks biasa, mereka menghasilkan teks kaya (dengan font dan format) menggunakan format kustom seperti  RTF (Rich Text Format) </ 1> .</p> 
+
+Alasan kedua adalah bahwa editor kode khusus untuk mengedit kode, sehingga bisa memberikan fitur bermanfaat seperti menyoroti kode dengan warna sesuai maknanya, atau secara otomatis menutup tanda kutip untuk Anda.
+
+Kita akan melihat semua ini dalam tindakan nanti. Segera, Anda akan memikirkan editor kode lama terpercaya Anda sebagai salah satu alat favorit Anda. :)
\ No newline at end of file
diff --git a/id/css/README.md b/id/css/README.md
new file mode 100644
index 00000000000..8eeefa01031
--- /dev/null
+++ b/id/css/README.md
@@ -0,0 +1,259 @@
+# CSS - membuatnya cantik!
+
+Blog yang kita buat masih terlihat jelek, kan? Sekarang waktunya untuk mempercantik tampilannya! Kita akan menggunakan CSS untuk itu.
+
+## Apa itu CSS?
+
+Cascading Style Sheets (CSS) adalah bahasa yang digunakan untuk menggambarkan tampilan dan format situs web yang ditulis dalam bahasa markup (seperti HTML). Perlakukan itu sebagai make-up untuk halaman web kita. ;)
+
+Tapi kita tidak ingin memulai dari nol lagi kan? Sekali lagi, kita akan menggunakan sesuatu yang diprogramkan oleh programer di Internet secara gratis. Reinventing the wheel tidak menyenangkan, lho.
+
+## Mari kita gunakan Bootstrap!
+
+Bootstrap adalah salah satu kerangka kerja HTML dan CSS yang paling populer untuk mengembangkan situs web yang indah: https://getbootstrap.com/
+
+Itu ditulis oleh programmer yang bekerja untuk Twitter. Sekarang dikembangkan oleh sukarelawan dari seluruh dunia!
+
+## Memasang Bootstrap
+
+Untuk menginstal Bootstrap, Anda perlu menambahkan ini ke `<head>` di file ` .html </ 1> Anda :</p>
+
+<p>{% filename%} blog / templates / blog / post_list.html {% endfilename%}</p>
+
+<pre><code class="html"><link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css"> 
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+`</pre> 
+
+Ini tidak menambahkan file ke proyek Anda. Ini hanya menunjuk ke file yang ada di Internet. Langsung saja buka situs Anda dan refresh halamannya. Ini dia!
+
+![Gambar 14.1](images/bootstrap1.png)
+
+Melihat lebih baik sudah!
+
+## Static files di Django
+
+Mari kita bahas apa itu **static files**. Static files are all your CSS and images. Konten mereka tidak bergantung pada konteks permintaan dan akan sama untuk setiap pengguna.
+
+### Dimana menyimpan static files untuk Django
+
+Django sudah tahu di mana menemukan file statis untuk aplikasi "admin" bawaan. Sekarang kita hanya perlu menambahkan beberapa file statis untuk aplikasi kita sendiri, ` blog </ 0> .</p>
+
+<p>Kita melakukan itu dengan cara membuat folder bernama <code>static` didalam blog app:
+
+    djangogirls ├── blog │ ├── migrasi │ ├── static │   └── template └── mysite
+    
+
+Django secara otomatis akan menemukan folder yang disebut "statis" di dalam folder aplikasi Anda. Maka akan bisa menggunakan isinya sebagai file statis.
+
+## File CSS pertama mu!
+
+Mari buat file CSS sekarang, untuk menambahkan gaya Anda sendiri ke halaman web Anda. Buat sebuah folder bernama `css` di dalam folder `static`. Kemudian buat sebuah file bernama `blog.css` di dalam folder `css`. Siap?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Saatnya menulis CSS! Buka file `blog/static/css/blog.css` kedalam teks editor mu.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+Tapi mari kita lakukan setidaknya sedikit. Mungkin kita bisa mengubah warna header kita? Untuk memahami warna, komputer menggunakan kode khusus. Kode ini dimulai dengan ` # </ 0> diikuti oleh 6 huruf (A-F) dan angka (0-9). Misalnya, kode biru adalah <code> # 0000FF </ 0> . Anda dapat menemukan kode warna untuk banyak warna di sini: http://www.colorpicker.com/. Anda juga dapat menggunakan <a href="http://www.w3schools.com/colors/colors_names.asp"> warna yang telah ditetapkan </ 0> , seperti <code> merah </ 1> dan <code> hijau </ 1> .</p>
+
+<p>Dalam berkas <code>blog/static/css/blog.css` kamu harus ditambahkan kode seperti berikut:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+     warna: # FCA205; }
+```
+
+`h1 a` adalah selector dalam CSS. Ini berarti kita menerapkan gaya kita ke elemen ` a </ 0> di dalam elemen <code> h1 </ 0> . Jadi ketika kita memiliki sesuatu seperti <code>&lt;h1&gt;&lt;a href=""&gt; link </ 0> , style <code> h1 a </ 1> akan berlaku. Pada contoh kali ini, kita memberitahukan untuk melakukan perubahan warna menjadi <code>#FCA205`, yang dimana warna tersebut adalah Jingga. Tentu saja, kamu bisa menempatkan warna mu sendiri disini!
+
+Dalam berkas CSS kita menentukan styles untuk elemen yang berada pada berkas HTML. Cara pertama kita mengidentifikasi elemen adalah dengan nama elemen. Anda mungkin ingat ini sebagai tag dari bagian HTML. Hal-hal seperti ` a </ 0> , <code> h1 </ 0> , dan <code> body </ 0> adalah contoh nama elemen.
+Kami juga mengidentifikasi elemen dengan atribut <code> class </ 0> atau atribut <code> id </ 0> . Class dan id adalah nama-nama elemen yang kamu berikan sendiri. Class-class mendefinisikan kelompok-kelompok elemen, dan id menunjuk pada elemen khusus. Misalnya, Anda dapat mengidentifikasi tag berikut dengan menggunakan nama tag <code> a </ 0> , kelas <code> external_link </ 0> , atau id <code> link_to_wiki_page </ 0> :</p>
+
+<pre><code class="html"><a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+`</pre> 
+
+Anda dapat membaca lebih lanjut tentang  CSS Selectors di w3schools </ 0> .</p> 
+
+Kita juga perlu memberi tahu template HTML kita bahwa kita menambahkan beberapa CSS. Buka file ` blog / templates / blog / post_list.html </ 0> dan tambahkan baris ini di awal saja:</p>
+
+<p>{% filename%} blog / templates / blog / post_list.html {% endfilename%}</p>
+
+<pre><code class="html">{% memuat staticfiles%}
+`</pre> 
+
+Kami hanya memuatkan file statis di sini. :) Antara tag `<head>` dan ` </ 2> </ 1> , setelah link ke file CSS Bootstrap, tambahkan baris ini:</p>
+
+<p>{% filename%} blog / templates / blog / post_list.html {% endfilename%}</p>
+
+<pre><code class="html"><link rel="stylesheet" href="{% static 'css/blog.css' %}">
+`</pre> 
+
+Browser membaca file sesuai urutan yang mereka berikan, jadi kita perlu memastikan ini ada di tempat yang tepat. Jika tidak, kode di file kami mungkin akan diganti dengan kode di file Bootstrap. Kami hanya memberi tahu template kami dimana file CSS kami berada.
+
+File Anda seharusnya terlihat seperti ini:
+
+{% filename%} blog / templates / blog / post_list.html {% endfilename%}
+
+```html
+{% load staticfiles%} 
+&lt;html&gt; 
+&lt;head&gt; &lt;title&gt; Blog Django Girls </ 2> &lt;link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css"&gt; &lt;link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css"&gt; &lt;link rel="stylesheet" href="{% static 'css/blog.css' %}"&gt; </ 1> &lt;body&gt; &lt;div&gt; &lt;h1&gt;&lt;a href="/"&gt; Django Girls Blog </ 8 > </ 7> {% untuk pos di pos%} &lt;div&gt; &lt;p&gt; dipublikasikan: {{post.published_date}} </ 9> &lt;h1&gt;&lt;a href=""&gt; {{post.title}} </ 10> &lt;p&gt; { {post.text | linebreaksbr}} </ 9> </ 7> {% endfor%} </ 6> </ 0>    
+        
+        
+        
+        
+    
+    
+        
+            
+        
+
+        
+            
+                
+                
+                
+            
+        
+    
+
+```
+
+OK, simpan file dan refresh situsnya
+
+![Gambar 14.2](images/color2.png)
+
+Kerja bagus! Mungkin kita juga ingin memberi website kita sedikit udara dan meningkatkan margin di sisi kiri? Ayo coba ini!
+
+{% filename%} blog / static / css / blog.css {% endfilename%}
+
+```css
+badan {
+     padding-left: 15px; }
+```
+
+Tambahkan itu ke CSS Anda, simpan file dan lihat hasilnya!
+
+![Gambar 14.3](images/margin2.png)
+
+Mungkin kita bisa menyesuaikan font di header kita? Tempel ini ke file `<head>` di ` blog / templates / blog / post_list.html </ 1> Anda :</p>
+
+<p>{% filename%} blog / templates / blog / post_list.html {% endfilename%}</p>
+
+<pre><code class="html"><link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+`</pre> 
+
+Seperti sebelumnya, periksa urutan dan tempat sebelum link ke ` blog / static / css / blog.css </ 0> . Baris ini akan mengimpor font yang disebut <em> Lobster </ 1> dari Google Fonts (https://www.google.com/fonts).</p>
+
+<p>Temukan blok deklarasi <code> h1 a </ 0> (kode antara tanda kurung <code> { </ 0> dan <code> } </ 0> ) di file CSS <code> blog / static / css / blog .css </ 0> .  Sekarang tambahkan baris <code> font-family: 'Lobster'; </ 0> di antara kawat gigi, dan segarkan halaman:</p>
+
+<p>{% filename%} blog / static / css / blog.css {% endfilename%}</p>
+
+<pre><code class="css">h1 a {
+     warna: # FCA205;
+    font-family: 'Lobster'; }
+`</pre> 
+
+![Gambar 14.3](images/font.png)
+
+Besar!
+
+Seperti disebutkan di atas, CSS memiliki konsep kelas. Ini memungkinkan Anda memberi nama bagian dari kode HTML dan menerapkan gaya hanya pada bagian ini, tanpa mempengaruhi bagian lain. Ini bisa sangat membantu! Mungkin Anda memiliki dua divs yang melakukan sesuatu yang berbeda (seperti header dan postingan Anda). Sebuah kelas dapat membantu Anda membuat mereka terlihat berbeda.
+
+Silakan dan beri nama beberapa bagian kode HTML. Tambahkan sebuah kelas yang disebut ` header halaman </ 0> ke <code> div </ 0> yang berisi header Anda, seperti ini:</p>
+
+<p>{% filename%} blog / templates / blog / post_list.html {% endfilename%}</p>
+
+<pre><code class="html">&lt;div class="page-header"&gt; 
+&lt;h1&gt;&lt;a href="/"&gt; Django Girls Blog </ 1> </ 0>    
+
+`</pre> 
+
+Dan sekarang tambahkan sebuah kelas ` pos </ 0> ke <code> div </ 0> berisi sebuah posting blog.</p>
+
+<p>{% filename%} blog / templates / blog / post_list.html {% endfilename%}</p>
+
+<pre><code class="html">&lt;div class="post"&gt; 
+&lt;p&gt; diterbitkan: {{post.published_date}} </ 1> &lt;h1&gt;&lt;a href=""&gt; {{post.title}} </ 2> &lt;p&gt; {{post.text | linebreaksbr}} </ 1> < / 0>    
+    
+    
+
+`</pre> 
+
+Kami sekarang akan menambahkan blok deklarasi ke penyeleksi yang berbeda. Pemilih dimulai dengan ` . </ 0> berhubungan dengan kelas. Ada banyak tutorial dan penjelasan bagus tentang CSS di Web yang dapat membantu Anda memahami kode berikut. Untuk saat ini, cukup copy dan paste ke file <code> blog / static / css / blog.css </ 0> Anda :</p>
+
+<p>{% filename%} blog / static / css / blog.css {% endfilename%}</p>
+
+<pre><code class="css">.page-header {
+     background-color: # ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px; } .page-header h1, .page-header h1 a, .page-header h1 a: visited, .page-header h1 a: active {
+     color: #ffffff;
+    ukuran huruf: 36pt;
+    hiasan teks: tidak ada; } .content {
+     margin-left: 40px; } h1, h2, h3, h4 {
+     font-family: 'Lobster', kursif; } .date {
+     color: # 828282; } .ave {
+     float: benar; } .post-form textarea, .post-form input {
+     width: 100%; } .top-menu, .top-menu: hover, .top-menu: visited {
+     color: #ffffff;
+    float: benar;
+    ukuran huruf: 26pt;
+    margin-right: 20px; } .post {
+     margin-bottom: 70px; } .post h1 a, .post h1 a: visited {
+    warna: # 000000; }
+`</pre> 
+
+Kemudian hubungilah kode HTML yang menampilkan tulisan dengan deklarasi kelas. Ganti ini:
+
+{% filename%} blog / templates / blog / post_list.html {% endfilename%}
+
+```html
+{% untuk posting di posting%} 
+&lt;div class="post"&gt; &lt;p&gt; diterbitkan: {{post.published_date}} </ 1> &lt;h1&gt;&lt;a href=""&gt; {{post.title}} </ 2> &lt;p&gt; {{post.text | linebreaksbr}} </ 1> </ 0> {% endfor%}    
+        
+        
+        
+    
+
+```
+
+di ` blog / templates / blog / post_list.html </ 0> dengan ini:</p>
+
+<p>{% filename%} blog / templates / blog / post_list.html {% endfilename%}</p>
+
+<pre><code class="html">&lt;div class="content container"&gt; 
+&lt;div class="row"&gt; &lt;div class="col-md-8"&gt; {% untuk posting di posting%} &lt;div class="post"&gt; &lt;div class="date"&gt; &lt;p&gt; diterbitkan: {{post.published_date}} </ 5> </ 4> &lt;h1&gt;&lt;a href=""&gt; {{post. judul}} </ 6> &lt;p&gt; {{post.text | linebreaksbr}} </ 5> </ 3> {% endfor%} </ 2> </ 1> </ 0>    
+        
+            
+                
+                    
+                        
+                    
+                    
+                    
+                
+            
+        
+    
+
+`</pre> 
+
+Simpan file tersebut dan segarkan situs Anda.
+
+![Gambar 14.4](images/final.png)
+
+Woo hoo! Terlihat mengagumkan, kan? Lihatlah kode yang baru kita tempel untuk menemukan tempat di mana kita menambahkan kelas dalam HTML dan menggunakannya di CSS. Di mana Anda akan membuat perubahan jika Anda ingin tanggal menjadi turquoise?
+
+Jangan takut untuk bermain-main dengan CSS ini sedikit dan mencoba untuk mengubah beberapa hal. Bermain dengan CSS dapat membantu Anda memahami hal-hal yang berbeda. Jika Anda memecahkan sesuatu, jangan khawatir - Anda selalu bisa membatalkannya!
+
+Kami sangat merekomendasikan untuk mengambil online gratis ini  Codeacademy HTML & amp; Kursus CSS </ 0> . Ini dapat membantu Anda mempelajari semua tentang membuat situs web Anda lebih cantik dengan CSS.</p> 
+
+Siap untuk bab berikutnya ?! :)
\ No newline at end of file
diff --git a/id/deploy/README.md b/id/deploy/README.md
new file mode 100644
index 00000000000..757ef04ce4b
--- /dev/null
+++ b/id/deploy/README.md
@@ -0,0 +1,226 @@
+# Deploy (Publikasikan)
+
+> **Catatan** Bab berikut mungkin terasa agak sulit untuk dipahami. Lanjutkan sampai selesai; proses deploy merupakan proses yang penting pada proses pengembangan website. Bab ini sengaja diletakkan di bagian tengah tutorial ini dengan harapan agar pendamping anda, kalau ada, dapat membantu anda menjadikan website anda online, dengan sedikit trik. Ini artinya, anda masih dapat menyelesaikan sendiri tutorial ini kalau-kalau anda tak lagi punya cukup waktu.
+
+Sampai sekarang, situs Anda hanya tersedia di komputer Anda. Sekarang Anda akan belajar bagaimana cara menggunakannya! Proses deploy adalah proses mempublikasikan aplikasi anda di Internet agar orang lain dapat membuka dan melihat aplikasi anda. :)
+
+Sebagaimana yang telah anda pelajari, sebuah website haruslah diletakkan pada server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+Layanan eksternal lain akan menggunakan [GitHub](https://www.github.com), yang merupakan sebuah layanan hosting kode program. Ada beberapa yang lain, akan tetapi hampir semua programmer saat ini memiliki akun di GitHub, anda berikutnya.
+
+Ketiga tempat ini penting bagi Anda. Komputer lokal Anda akan menjadi tempat pengembangan dan pengujian Anda. Bila Anda senang dengan perubahan tersebut, Anda akan menempatkan salinan program Anda di GitHub. Situs Anda akan berada di PythonAnywhere dan Anda akan memperbaruinya dengan mendapatkan salinan kode Anda yang baru dari GitHub.
+
+# Git
+
+> ** Catatan </ 0> Jika Anda sudah melakukan langkah-langkah Instalasi, Anda tidak perlu melakukan ini lagi - Anda dapat melompat ke bagian berikutnya dan mulai membuat gudang Git Anda.</p> </blockquote> 
+> 
+> {% include "/deploy/install_git.md" %}
+> 
+> ## Memulai repositori Git kita
+> 
+> Git mencatat perubahan atas file-file yang disebut repositori kode (atau disingkat "repo" saja). Mari kita mulai untuk proyek kita. Buka konsole dan jalankan perintah ini dalam direktori`djangogirl`:
+> 
+> > ** Catatan </ 0> Periksa direktori kerja Anda saat ini dengan perintah ` pwd </ 1> (Mac OS X / Linux) atau <code> cd </ 1> (Windows) sebelum menginisialisasi repositori. Anda harus berada di dalam folder <code>djangogirl`.</p> </blockquote> 
+> > 
+> > {% filename%} baris perintah {% endfilename%}
+> > 
+> >     $ git init
+> >     Initialized empty Git repository in ~/djangogirls/.git/
+> >     $ git config --global user.name "Nama Anda"
+> >     $ git config --global user.email anda@contoh.com
+> >      
+> >     
+> > 
+> > Menginisialisasi repositori git adalah sesuatu yang perlu kita lakukan hanya sekali per proyek (dan Anda tidak perlu memasukkan kembali nama pengguna dan email itu lagi).
+> > 
+> > Git akan mencatat perubahan atas semua file dan folder yang ada dalam direktori ini, tetapi ada beberapa file yang ingin kita abaikan. Kita melakukan ini dengan cara membuat sebuah file yang diberi nama `.fitignore`, dalam direktori utama. Jalankan program editor anda kemudian buat sebuah file baru dengan isi :
+> > 
+> > {% filename%} .gitignore {% endfilename%}
+> > 
+> >     * .pyc * ~
+> >      __pycache__ 
+> >     myvenv db.sqlite3 / static .DS_Store
+> >     
+> > 
+> > Dan simpan sebagai ` .gitignore </ 0> di folder "djangogirls".</p>
+
+<blockquote>
+  <p><strong>Catatan</strong> Titik di depan nama file sangat penting!  Jika Anda mengalami kesulitan untuk membuatnya (Mac tidak suka Anda membuat file yang dimulai dengan titik melalui Finder, misalnya), kemudian gunakan fitur "Save As" di editor Anda; itu antipeluru</p>
+  
+  <p><strong> Catatan </ 0> Salah satu file yang ditentukan dalam Anda <code> Gitignore </ 1> file <code> db.sqlite3 </ 1> . File itu adalah database lokal Anda, di mana semua posting Anda disimpan. Kami tidak ingin menambahkan ini ke repositori Anda karena situs Anda di PythonAnywhere akan menggunakan database yang berbeda.  Database itu bisa berupa SQLite, seperti mesin pengembangan Anda, tapi biasanya Anda akan menggunakan satu yang disebut MySQL yang bisa menangani lebih banyak pengunjung situs daripada SQLite. Either way, dengan mengabaikan database SQLite Anda untuk salinan GitHub, itu berarti semua posting yang Anda buat sejauh ini akan tetap ada dan hanya tersedia secara lokal, namun Anda harus menambahkannya lagi pada produksi. Anda harus memikirkan database lokal Anda sebagai taman bermain yang bagus di mana Anda dapat menguji berbagai hal dan tidak takut bahwa Anda akan menghapus posting sebenarnya dari blog Anda.</p>
+</blockquote>
+
+<p>Sebaiknya cek status dulu dengan perintah <code>git status` sebelum melakukan `git add` atau kapanpun anda ingin memastikan apa yang telah berubah. Ini akan membantu mencegah kejutan terjadi, seperti file yang salah ditambahkan atau dilakukan. Perintah ` git status </ 0> mengembalikan informasi tentang file yang tidak dilacak / dimodifikasi / dipentaskan, status cabang, dan banyak lagi. Keluarannya harus serupa dengan berikut ini:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>$ git status
+On branch master
+
+Initial commit
+
+Untracked files:
+  (use "git add <file>..." to include in what will be committed)
+
+        .gitignore
+        blog/
+        manage.py
+        mysite/
+
+nothing added to commit but untracked files present (use "git add" to track)
+`</pre> 
+> > 
+> > Dan akhirnya kita simpan perubahan kita. Buka konsole dan jalankan perintah-perintah berikut:
+> > 
+> > {% filename %}command-line{% endfilename %}
+> > 
+> >     $ git add --all
+> >     $ git commit -m "Aplikasi Django Girls saya, komit pertama"
+> >      [...] 13 file diubah, 200 sisipan (+)
+> >      buat mode 100644 .gitignore
+> >      [...] buat mode 100644 mysite / wsgi.py
+> >      `` `# # Mendorong kode Anda ke GitHub Masuk ke [GitHub.com] (https://www.github.com) dan masuk ke akun pengguna baru yang gratis. 
+> >        
+> >        (Jika Anda sudah melakukannya dalam persiapan lokakarya, itu bagus!) Kemudian, buat repositori baru, beri nama "my-first-blog". Biarkan kotak centang "inisialisasi dengan README" tidak dicentang, tinggalkan opsi .gitignore kosong (kami telah melakukannya secara manual) dan tinggalkan Lisensi sebagai Tidak Ada.
+> >     
+> >     <0 /> 
+> >     
+> >     & gt; ** Catatan ** Nama `my-first-blog` itu penting - Anda bisa memilih yang lain, tapi akan banyak terjadi dalam petunjuk di bawah ini, dan Anda harus menggantinya setiap saat. Mungkin lebih mudah untuk tetap dengan nama `my-first-blog`.
+> >     
+> >     Pada layar berikutnya, Anda akan ditampilkan URL kloning repo Anda. Pilih versi "HTTPS", salin, dan kami akan segera menempelkannya ke terminal:
+> >     
+> >      <0 /> 
+> >     
+> >     Sekarang kita perlu menghubungkan repositori Git di komputer Anda ke yang ada di GitHub.
+> >     
+> >     Ketik berikut ini ke konsol Anda (Ganti ` &lt;your-github-username&gt; ` dengan nama pengguna yang Anda masukkan saat membuat akun GitHub, namun tanpa tanda kurung siku):
+> >     
+> >      {% filename%} command-line {% endfilename%}
+> >     
+> > 
+> > $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+> > 
+> >     <br />Masukkan username dan password GitHub Anda dan Anda akan melihat sesuatu seperti ini:
+> >     
+> >      {% filename%} command-line {% endfilename%}
+> >     
+> > 
+> > Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), digunakan kembali 0 (delta 0) Untuk https://github.com/hjwp/my-first-blog.git
+> > 
+> > - [cabang baru] master -> master master cabang diatur untuk melacak master cabang jarak jauh dari asal.
+> > 
+> >     <br />& lt; - TODO: mungkin tombol ssh dipasang di pesta pemasangan, dan titik ppl yang tidak memilikinya ke ekstensi - & gt; 
+> >     
+> >     Kode Anda sekarang ada di GitHub. Silahkan anda cek!  Anda akan menemukannya di perusahaan yang bagus - [Django] (https://github.com/django/django), [Django Girls Tutorial] (https://github.com/DjangoGirls/tutorial), dan banyak lainnya hebat Proyek perangkat lunak sumber terbuka juga meng-host kode mereka di GitHub. :) # Menyiapkan blog kita di PythonAnywhere 
+> >     
+> >     & gt; ** Catatan ** Anda mungkin telah membuat akun PythonAnywhere sebelumnya selama langkah-langkah pemasangan - jika ya, tidak perlu melakukannya lagi.
+> >     
+> >     {% include "/ deploy / signup_ pythonanywhere .md"%} ## Menarik kode kita di PythonAnywhere 
+> >     
+> >     Bila Anda telah mendaftar ke PythonAnywhere , Anda akan dibawa ke halaman dasbor atau "Consoles". Pilih opsi untuk memulai konsol "Bash" - itu adalah versi konsol PythonAnywhere , seperti yang ada di komputer Anda.
+> >     
+> >     <0 /> 
+> >     
+> >     & gt; ** Catatan ** PythonAnywhere berbasis Linux, jadi jika Anda menggunakan Windows, konsol akan terlihat sedikit berbeda dari yang ada di komputer Anda.
+> >     
+> >     Mari kita tarik kembali kode kita dari GitHub dan memasukkan ke PythonAnywhere dengan cara membuat "clone" dari repo kita. Ketik berikut ke konsol di PythonAnywhere (jangan lupa gunakan nama pengguna GitHub Anda sebagai ganti ` &lt;your-github-username&gt; `):
+> >     
+> >      {% filename%} PythonAnywhere  command-line {% endfilename%}
+> >     
+> > 
+> > $ git klon https://github.com/<your-github-username>/my-first-blog.git
+> > 
+> >     <br />Ini akan menarik salinan kode Anda ke PythonAnywhere . Check it out dengan mengetikkan `tree my-first-blog`:
+> >     
+> >      {% filename%} PythonAnywhere  command-line {% endfilename%}
+> >     
+> > 
+> > $ tree my-first-blog my-first-blog / ├── blog │ ├── ** init </ 0> .py │ ├── admin.py │ ├── migrasi │ │ ├── 0001_initial. py │ │ └── ** init </ 0> .py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── ** init </ 0> .py ├── settings.py ├── urls.py └── wsgi.py</p> 
+> > 
+> >     <br /><br />### Membuat virtualenv di PythonAnywhere 
+> >     
+> >     Sama seperti yang Anda lakukan di komputer Anda sendiri, Anda dapat membuat virtualenv di PythonAnywhere . Di konsol Bash, ketik:
+> >     
+> >      {% filename%} PythonAnywhere  command-line {% endfilename%}
+> >     
+> > 
+> > $ cd my-first-blog
+> > 
+> > $ virtualenv --python = python3.6 myvenv Menjalankan virtualenv dengan interpreter /usr/bin/python3.6 [...] Memasang setuptools, pip ... done.
+> > 
+> > $ source myvenv / bin / aktifkan
+> > 
+> > (myvenv) $ pip install django ~ = 1.11.0 Mengumpulkan Django [...] Berhasil menginstal Django-1.11.3
+> > 
+> >     <br /><br />& gt; ** Catatan ** Langkah `pip install` bisa memakan waktu beberapa menit.  Sabar, sabar!  Tapi kalau dibutuhkan lebih dari lima menit, ada yang salah.  Tanya pelatihmu
+> >     
+> >     & lt; ! - TODO: pikirkan tentang penggunaan requirements.txt daripada pemasangan pip .-- & gt; 
+> >     
+> >     ### Membuat database di PythonAnywhere 
+> >     
+> >     Inilah hal lain yang berbeda antara komputer dan server Anda sendiri: menggunakan database yang berbeda. Jadi akun dan pos pengguna bisa berbeda di server dan di komputer Anda.
+> >     
+> >     Sama seperti yang kita lakukan di komputer Anda sendiri, kami mengulang langkah untuk menginisialisasi database di server, dengan `migrate` dan` createuperuser`:
+> >     
+> >      {% filename%} PythonAnywhere  command-line {% endfilename%}
+> >     
+> > 
+> > (mvenv) $ python manage.py bermigrasi Operasi untuk melakukan: [...] Menerapkan sesi.0001_initial ... OK (mvenv) $ python manage.py createuperuser
+> > 
+> >     <br />## Mempublikasikan blog kita sebagai aplikasi web Sekarang kode kita ada di PythonAnywhere , virtualenv kita sudah siap, dan database diinisialisasi. Kami siap mempublikasikannya sebagai aplikasi web!
+> >     
+> >     Klik kembali ke dasbor PythonAnywhere dengan mengklik logo nya, dan kemudian klik pada ** Web ** tab. Akhirnya, tekan ** Tambahkan aplikasi web baru **.
+> >     
+> >     Setelah mengkonfirmasikan nama domain Anda, pilih ** konfigurasi manual ** (NB - * bukan * opsi "Django") di dialog. Selanjutnya pilih ** Python 3.6 **, dan klik Next untuk menyelesaikan wizard.
+> >     
+> >     & gt; ** Catatan ** Pastikan Anda memilih opsi "Manual configuration", bukan "Django". Kami terlalu keren untuk setup Django default PythonAnywhere . ;-) ### Menetapkan virtualenv Anda akan dibawa ke layar config PythonAnywhere untuk webapp Anda, di situlah Anda harus pergi kapan pun Anda ingin melakukan perubahan pada aplikasi di server.
+> >     
+> >     </ / 
+> >     
+> >     Di bagian "Virtualenv", klik teks merah yang bertuliskan "Enter the path to an virtualenv", dan masukkan `/ home / &lt;your-PythonAnywhere-username&gt; / my-first-blog / myvenv /`. Klik kotak biru dengan tanda centang untuk menyimpan jalan sebelum pindah.
+> >     
+> >     & gt; ** Catatan ** Ganti nama pengguna PythonAnywhere Anda sendiri yang sesuai. Jika Anda membuat kesalahan, PythonAnywhere akan menunjukkan sedikit peringatan.
+> >     
+> >     
+> >     ### Mengkonfigurasi file WSGI Django bekerja dengan menggunakan "protokol WSGI", sebuah standar untuk melayani situs web menggunakan Python, yang didukung PythonAnywhere . Cara kita mengkonfigurasi PythonAnywhere untuk mengenali blog Django kita adalah dengan mengedit file konfigurasi WSGI.
+> >     
+> >     Klik pada link "file konfigurasi WSGI" (di bagian "Kode" di dekat bagian atas halaman - akan diberi nama seperti `/ var / www / &lt;your-PythonAnywhere-username&gt; _pythonanywhere_com_wsgi.py`), dan Anda akan menjadi dibawa ke editor
+> >     
+> >     Hapus semua isi dan ganti dengan yang berikut:
+> >     
+> >      {% filename%} & amp; lt; nama pengguna & amp; gt; _pythonanywhere_com_wsgi.py {% endfilename%} 
+> >     `` `python import os import sys path = os.path.expanduser ('~ / my-first-blog') jika path tidak di sys.path:
+> >          sys.path.append ( path) os.environ ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings' dari django.core.wsgi import get_wsgi_application dari django.contrib.staticfiles.handlers import StaticFilesHandler application = StaticFilesHandler (get_wsgi_application ())
+> >     
+> > 
+> > Tugas file ini adalah memberi tahu PythonAnywhere tempat aplikasi web kami tinggal dan apa nama file pengaturan Django.
+> > 
+> > The ` StaticFilesHandler </ 0> adalah untuk menangani CSS kita. Ini diurus secara otomatis untuk Anda selama pengembangan lokal dengan perintah <code> runserver </ 0> . Kita akan lebih memahami lagi nanti tentang file statis
+Kita akan lebih paham lagi apa itu file statis pada tutorial berikutmya, yaitu ketika kita mengedit CSS untuk website kita.</p>
+
+<p>Klik <strong>Save</strong> dan kembalilah ke tab <strong>Web</strong>.</p>
+
+<p>Selesai! Klik tombol hijau besar dengan label <strong>Reload</strong> dan anda akan dapat melihat aplikasi anda. Nda akan menemukan sebuah link yang mengarah kepadanya di bagian atas halaman.</p>
+
+<h2>Tip Debugging (Mencari bug atau error)</h2>
+
+<p>Jika anda melihat ada error pada saat anda membuka website anda, lokasi pertama-tama untuk mencari informasi debugging adalah pada <strong>error log</strong>. Anda akan menemukan sebuah link yang mengarah ke sana pada tab <a href="https://www.pythonanywhere.com/web_app_setup/">Web tab</a> PythonAnywhere. Lihat apakah ada pesan error di sana, yang terbaru ada di bagian bawah. Masalah-masalah yang umum dijumpai meliputi:</p>
+
+<ul>
+<li><p>Melupakan salah satu langkah yang kami lakukan di konsol: membuat virtualenv, mengaktifkannya, menginstal Django ke dalamnya, memigrasikan database.</p></li>
+<li><p>Membuat kesalahan di jalur virtualenv di tab Web - biasanya akan ada pesan kesalahan kecil berwarna merah di sana, jika ada masalah.</p></li>
+<li><p>Membuat kesalahan dalam file konfigurasi WSGI - apakah Anda mendapatkan jalur ke folder blog pertama saya?</p></li>
+<li><p>Apakah anda memilih versi python yang sama untuk virtualenv dengan python apliksi web anda? Keduanya harus versi 3.6.</p></li>
+</ul>
+
+<p>Ada juga beberapa <a href="https://www.pythonanywhere.com/wiki/DebuggingImportError"> kiat debugging umum pada PythonAnywhere wiki </ 0> .</p>
+
+<p>Dan ingat, pendamping anda siap di sini untuk membantu ada!</p>
+
+<h1>Website anda kini hidup!</h1>
+
+<p>Halaman default untuk situs Anda harus mengatakan "It worked!", Seperti halnya pada komputer lokal Anda. Coba tambahkan <code>/admin/` di akhir URL, maka anda akan masuk pada admin website. Lakukan Log in dengan username dan password yang sesuai dan anda akan dapat membuat posting baru di server.
+> > 
+> > Begitu Anda memiliki beberapa tulisan yang dibuat, Anda dapat kembali ke penyiapan lokal Anda (bukan PythonAnywhere ). Dari sini Anda harus mengerjakan setup lokal Anda untuk melakukan perubahan. Ini adalah alur kerja umum dalam pengembangan web - membuat perubahan secara lokal, mendorong perubahan tersebut ke GitHub, dan menarik perubahan Anda ke server Web langsung Anda. Ini memungkinkan Anda bekerja dan bereksperimen tanpa merusak situs web Anda. Cukup keren, ya?
+> > 
+> > Tepuk tangan! Pada proses pengembangan website, proses deploy ke dalam server adalah sebuah proses yang perlu sedikit trik dan seseorang biasanya perlu beberapa hari usaha sampai berhasil. Tapi kini anda sudah berhasil membuat website anda hidup dalam Internet sesungguhnya, itu sangat bagus!
\ No newline at end of file
diff --git a/id/deploy/install_git.md b/id/deploy/install_git.md
new file mode 100644
index 00000000000..b3c56d81d3c
--- /dev/null
+++ b/id/deploy/install_git.md
@@ -0,0 +1,50 @@
+Git adalah suatu "sistem kontrol versi" yang digunakan oleh banyak sekali programmer. Software ini dapat mencatat perubahan file dari waktu ke waktu sehingga anda dapat mencari versi tertentu di kemudian hari. Ini mirip dengan fitur "track changes" pada Microsoft Word, tapi jauh lebih baik.
+
+## Menginstal Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Kamu dapat mengunduh Git dari [git-scm.com](https://git-scm.com/). Anda bisa menekan "next" di semua langkah kecuali satu; pada langkah kelima yang berjudul "Menyesuaikan lingkungan PATH Anda", pilih "Gunakan Git dan alat Unix opsional dari Windows Command Prompt" (opsi paling bawah). Selain itu, defaultnya bagus. Lihat pada Window-style, akhir baris Unix-style yang ada terlhat bagus.
+
+Jangan lupa restart command prompt atau PowerShell setelah penginstalan selesai dengan sukses. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git dari [git-scm.com](https://git-scm.com/) dan ikuti perintah yang diberikan.
+
+> ** Catatan </ 0> Jika Anda menjalankan OS X 10.6, 10.7, atau 10.8, Anda perlu menginstal versi git dari sini:  Git installer untuk OS X Snow Leopard </ 1></p> </blockquote> <!--endsec-->
+> 
+> <!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+> 
+> {% filename%} baris perintah {% endfilename%}
+> 
+> ```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename%} baris perintah {% endfilename%}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename%} baris perintah {% endfilename%}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/id/deploy/signup_pythonanywhere.md b/id/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/id/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/id/django/README.md b/id/django/README.md
new file mode 100644
index 00000000000..3edd3c5457f
--- /dev/null
+++ b/id/django/README.md
@@ -0,0 +1,27 @@
+# Apa itu Django?
+
+Django (/ dʒæŋɡoʊ/ *jang-goh*) adalah framework aplikasi web open source dan open source yang ditulis dengan Python. Sebuah framework web adalah sebuah set komponen-komponen yang dapat membantu anda untuk mengembangkan website dengan lebih cepat dan mudah.
+
+Ketika anda sedang membangun sebuah website, anda akan selalu berurusan dengan hal-hal serupa misalnya bagaimana menangani autentikasi user (sign up, sign in dan sign out), panel pengelolaan website, form-form, bagaimana mengupload file dan sebagianya.
+
+Beruntung bagi Anda, orang lain lama sekali menyadari bahwa pengembang web menghadapi masalah yang sama saat membangun situs baru, jadi mereka bekerja sama dan menciptakan kerangka kerja (Django menjadi salah satunya) yang memberi Anda komponen siap pakai untuk digunakan.
+
+Kerangka ada untuk menyelamatkan Anda dari keharusan menemukan kembali kemudi dan membantu meringankan sebagian overhead saat Anda membangun situs baru.
+
+## Mengapa anda memerlukan sebuah framework?
+
+Untuk memahami apa sebenarnya Django, kita perlu melihat lebih dekat pada server. Hal pertama adalah bahwa server perlu tahu bahwa Anda ingin melayani Anda sebuah halaman web.
+
+Bayangkanlah sebuah mailbox/kotak surat (port), yang selalu dimonitor untuk mengetahui apakah ada surat masuk (request). Ini dikerjakan oleh server. Server web membaca surat tersebut dan kemudian mengirimkan tanggapan dengan sebuah halaman web. Akan tetapi, ketika anda ingin mengirimkan sesuatu, anda perlu menyiapkan isinya. Dan django akan membantu anda membuat isinya.
+
+## Apa yang terjadi ketika seseorang membuka halaman web di server anda?
+
+Ketika permintaan datang ke server web, itu diteruskan ke Django yang mencoba untuk mencari tahu apa yang sebenarnya diminta. Dibutuhkan alamat halaman web terlebih dahulu dan mencoba untuk mencari tahu apa yang harus dilakukan. Bagian ini dilakukan oleh Django **urlresolver** (perhatikan bahwa alamat situs web disebut URL - Uniform Resource Locator - jadi nama *urlresolver* masuk akal). Ini tidak terlalu cerdas - dibutuhkan daftar pola dan mencoba mencocokkan URL. Django memeriksa pola dari atas ke bawah dan jika ada yang cocok, maka Django meneruskan permintaan ke fungsi yang terkait (yang disebut *view*).
+
+Bayangkanlah ada petugas pengantar surat membawa sebuah surat. Ia menelusuri jalan dan mengecek tiap nomor rumah apakah cocok dengan alamat pada surat. Jika cocok, ia akan mengantarkan ke sana. Begitulah cara kerja urlresolver!
+
+Pada fungsi *view*, semua hal menarik dilakukan: kita bisa melihat database untuk mencari beberapa informasi. Munkin si user ingin mengubah data? Seperti sepucuk surat yang berbunyi, "Tolong ubah deskripsi pekerjaan saya." The *pandangan* dapat memeriksa apakah Anda diperbolehkan untuk melakukan itu, kemudian memperbarui deskripsi pekerjaan untuk Anda dan mengirim kembali pesan: "! Selesai" Kemudian *pandangan* menghasilkan respon dan Django dapat mengirimkannya ke web browser pengguna.
+
+Tentu saja diskripsi tadi agak disederhanakan, toh sejauh ini anda tak perlu tahu segala sesuatu yang sangat teknis dulu. Mengerti yang umum-umum dulu sudah cukup.
+
+Jadi, kita tidak akan belajar segala sesuatunya langsung secara detail, tetapi kita akan membuat sesuatu dengan django dan hal-hal penting lainnya sambil berjalan!
\ No newline at end of file
diff --git a/id/django_admin/README.md b/id/django_admin/README.md
new file mode 100644
index 00000000000..e328af2f20f
--- /dev/null
+++ b/id/django_admin/README.md
@@ -0,0 +1,53 @@
+# Admin Django
+
+Untuk menambahkan, mengedit dan menghapus tulisan yang baru saja kita telusuri, kita akan menggunakan admin Django.
+
+Mari buka file ` blog / admin.py </ 0> dan ganti isinya dengan ini:</p>
+
+<p>{% filename%} blog / admin.py {% endfilename%}</p>
+
+<pre><code class="python">dari admin impor django.contrib dari .Models import Post admin.site.register (Post)
+`</pre> 
+
+Sebagaimana dapat anda lihat, kita mengimport (meng Include) model Post yang telah didefinisikan di bab sebelumnya. Agar model kita tampil pada halaman admin, kita perlu mendaftarkan model tersebut dengan `admin.site.register(Post)`.
+
+Oke, saatnya kita lihat model Post kita. Ingat untuk menjalankan `python manage.py runserver` di konsol untuk menjalankan web server. Buka browser Anda dan ketikkan alamat http://127.0.0.1:8000/admin/. Anda akan melihat halaman login seperti ini:
+
+![Halaman masuk](images/login_page2.png)
+
+Untuk masuk, Anda perlu membuat * superuser </ 0> - akun pengguna yang memiliki kontrol atas segala hal di situs. Go back to the command line, type `python manage.py createsuperuser`, and press enter.</p> 
+
+> Ingat, untuk menulis perintah baru saat server web berjalan, buka jendela terminal baru dan aktifkan virtualenv Anda. Kami meninjau bagaimana menulis perintah baru di ** proyek Django pertama Anda! </ 0> bab, di bagian ** Starting the web server </ 0> .</p> </blockquote> 
+> 
+> {% filename %}Mac OS X or Linux:{% endfilename %}
+> 
+>     (myvenv) ~/djangogirls$ python manage.py createsuperuser
+>     
+> 
+> {% filename %}Windows:{% endfilename %}
+> 
+>     (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+>     
+> 
+> When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+> 
+>     Username: admin
+>     Email address: admin@admin.com
+>     Password:
+>     Password (again):
+>     Superuser created successfully.
+>     
+> 
+> Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+> 
+> ![Django admin](images/django_admin3.png)
+> 
+> Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+> 
+> Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+> 
+> ![Django admin](images/edit_post3.png)
+> 
+> If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+> 
+> This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/id/django_forms/README.md b/id/django_forms/README.md
new file mode 100644
index 00000000000..4edb38f0069
--- /dev/null
+++ b/id/django_forms/README.md
@@ -0,0 +1,427 @@
+# Form Django
+
+Hal penting terakhir yang akan kita lakukan adalah bagaimana membuat agar user dapat menambah dan mengedit post blog dengan mudah. `Admin` django sudah bagus, tapi sedikit sulit untuk meng-customize dan membuatnya lebih cantik. Dengan ` bentuk </ 0> kita akan memiliki kekuatan mutlak atas antarmuka kita - kita dapat melakukan hampir semua hal yang dapat kita bayangkan!</p>
+
+<p>Bagusnya form django adalah bahwa kita dapat mendefinisikannya dengan mudah atau dengan membuat sebuah <code>ModelForm` yang akan memberikan keluaran form tersebut ke dalam model terkait.
+
+Ini benar-benar merupakan hal yang kita ingin lakukan. Kita akan membuat sebuah form yang kita tujukan untuk model `Post` kita.
+
+Sama seperti tiap bagian penting dari Django, form memiliki file sendiri, yaitu forms.py.
+
+Kita perlu membuat sebuah file dengan nama tersebut di dalam directory `blog`.
+
+    blog
+       └── forms.py
+    
+
+Baiklah, ayo buka dan ketik kode berikut ini:
+
+{% filename%} blog / forms.py {% endfilename%}
+
+```python
+dari bentuk impor Django dari .Models import Post class PostForm (forms.ModelForm):
+
+     class Meta:
+         model = Post
+         fields = ('title', 'text',)
+```
+
+Pertama, kita perlu mengimport form Django (</code>form django import forms</code>) dan model `Post` kita (`from .models import Post</0>).</p>
+
+<p><code>PostForm`, sebagaimana yang barangkali anda duga, adalah nama form kita. Kita perlu memberi tahu Django bahwa bentuk ini adalah ` ModelForm </ 0> (jadi Django akan melakukan sihir untuk kita) - <code> forms.ModelForm </ 0> bertanggung jawab untuk itu.</p>
+
+<p>Selanjutnya, kita memiliki <code>class Meta` dimana kita memberitahu django model yang mana yang harus digunakan untuk menciptakan form ini (`model=post`).
+
+Akhirnya, kita dapat menyatakan field-field mana yang akan muncul di dalam form kita. Dalam skenario ini kita hanya ingin ` title </ 0> dan <code> text </ 0> yang akan terbuka - <code> author </ 0> harus menjadi orang yang saat ini masuk (Anda!) Dan < 0> create_date </ 0> harus disetel secara otomatis saat kita membuat sebuah posting (yaitu dalam kode), bukan?</p>
+
+<p>Begitulah caranya! Yang kita perlu lakukan sekarang adalah menggunakan <em>view</em> dan menampilkannya di dalam sebuah template.</p>
+
+<p>Jadi sekali lagi kita akan membuat link ke halaman, URL, tampilan dan template.</p>
+
+<h2>Mengarahkan link menuju sebuah halaman dengan Form</h2>
+
+<p>Sekarang saatnya membuka <code>blog/templates/base.html`. Kita akan menambahkan sebuah link di dalam `div` yang diberi nama `page-header`:
+
+{% filename%} blog / templates / blog / base.html {% endfilename%}
+
+```html
+&lt;a href="{% url 'post_new' %}" class="top-menu"&gt;&lt;span class="glyphicon glyphicon-plus"&gt; </ 0>
+```
+
+Perhatikan bahwa kami ingin memanggil tampilan baru kami ` post_new </ 0> . Kelas <code> "glyphicon glyphicon-plus" </ 0> disediakan oleh tema bootstrap yang kami gunakan, dan akan menampilkan tanda tambah bagi kami.</p>
+
+<p>Setelah menambahkan baris, file HTML Anda sekarang harus terlihat seperti ini:</p>
+
+<p>{% filename%} blog / templates / blog / base.html {% endfilename%}</p>
+
+<pre><code class="html">{% load staticfiles%} 
+&lt;html&gt; 
+&lt;head&gt; &lt;title&gt; Blog Django Girls </ 2> &lt;link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css"&gt; &lt;link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css"&gt; &lt;link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'&gt; &lt;link rel="stylesheet" href="{% static 'css/blog.css' %}"&gt; </ 1> &lt;body&gt; &lt;div class="page-header"&gt; &lt;a href="{% url 'post_new' %}" class="top-menu"&gt;&lt;span class="glyphicon glyphicon-plus"&gt; </ 9 > &lt;h1&gt;&lt;a href="/"&gt; Django Girls Blog </ 10> </ 8> &lt;div class="content container"&gt; &lt;div class="row"&gt; &lt;div class="col-md-8"&gt; {% konten blok%} {% endblock%} </ 13> </ 12> </ 11> </ 7 > </ 0>    
+        
+        
+        
+        
+        
+    
+    
+        
+            
+            
+        
+        
+            
+                
+                    
+                    
+                
+            
+        
+    
+
+`</pre> 
+
+Setelah disimpan dan merefresh halaman http://127.0.0.1:8000 anda pasti akan melihat tampilan error yang sudah familiar: `NoReverseMatch`, betul?
+
+## URL
+
+Kita buka `blog/urls.py` dan tambahkan baris:
+
+{% filename%} blog / urls.py {% endfilename%}
+
+```python
+url (r '^ post / new / $', views.post_new, name = 'post_new'),
+```
+
+Dan kode terakhir akan tampak seperti ini:
+
+{% filename%} blog / urls.py {% endfilename%}
+
+```python
+dari django.conf.urls url impor dari. impor dilihat urlpatterns = [
+     url (r '^ $', views.post_list, name = 'post_list'),
+     url (r '^ post / (? P <pk> \ d +) / $', views.post_detail, name = 'post_detail'),
+     url (r '^ post / new / $', views.post_new, name = 'post_new'),]
+```
+
+Setelah menyegarkan situs, kita melihat ` AttributeError </ 0> , karena kita tidak memiliki tampilan <code> post_new </ 0> yang diterapkan. Mari kita tambahkan sekarang juga.</p>
+
+<h2>view post_view</h2>
+
+<p>Sekarang kita buka file <code>blog/views.py` dan tambahkan baris-baris berikut dengan sisa dari baris-baris `rows`: 
+
+{% filename%} blog / views.py {% endfilename%}
+
+```python
+dari .forms import PostForm
+```
+
+Dan kemudian * tampilan </ 0> kami :</p> 
+
+{% filename%} blog / views.py {% endfilename%}
+
+```python
+def post_new (request):
+     form = PostForm ()
+     mengembalikan render (request, 'blog / post_edit.html', {'form': form} )
+```
+
+Untuk membuat sebuah form `post` baru, kita perlu memanggil `PostForm` dan mengirimkannya ke dalam template tersebut. Kita akan kembali ke tampilan * ini </ 0> , tapi untuk saat ini, mari kita buat template untuk formulir dengan cepat.</p> 
+
+## Template
+
+Kita perlu membuat sebuah file </code>post_edit.html</code> di dalam direktori `blog/templates/blog</0>. Untuk membuat sebuah form agar berjalan, kita perlu beberapa hal:</p>
+
+<ul>
+<li>We have to display the form. We can do that with (for example) {% raw %}<code>{{ form.as_p }}`{% endraw %}.</li> 
+
+* Baris di atas tersebut perlu diletakkan di dalam tag form HTML: `<form method="POST">...</form>`.
+* Kita perlu sebuah tombol `Save`. Kita lakukan hal itu dengan sebuah tombol HTML: `<button type="submit">Save</button>`.
+* Dan akhirnya, tepat setelah tag pembuka `<form ...>` kita perlu menambahkan {% raw%} ` {% csrf_token%} </ 1> {% endraw%} . Ini sangat penting, karena akan menjadikan form anda aman! Jika Anda lupa sedikit ini, Django akan mengeluh saat Anda mencoba menyimpan formulir:</li>
+</ul>
+
+<p><img src="images/csrf2.png" alt="Halaman terlarang CSFR" /></p>
+
+<p>Baiklah, jadi mari kita lihat bagaimana HTML di <code> post_edit.html </ 0> akan terlihat:</p>
+
+<p>{% filename%} blog / templates / blog / post_edit.html {% endfilename%}</p>
+
+<pre><code class="html">{% meluas 'blog / base.html'%}
+
+ {% blok konten%} 
+&lt;h1&gt; Pos baru </ 0> &lt;form method="POST" class="post-form"&gt; {% csrf_token%} {{form.as_p}} &lt;button type="submit" class="save btn btn-default"&gt; Simpan </ 2> </ 1> {% endblock%}    
+    
+        
+        
+    
+
+`</pre> 
+    Saatnya merefresh web kita! Wow...! Form anda tampil!
+    
+    ![Form Baru](images/new_form2.png)
+    
+    Tapi tunggu sebentar! Saat Anda mengetikkan sesuatu di bidang ` title </ 0> dan <code> text </ 0> dan coba simpan, apa yang akan terjadi?</p>
+
+<p>Tidak ada! Kami sekali lagi ada di halaman yang sama dan teks kami hilang ... dan tidak ada tulisan baru yang ditambahkan. Jadi apa yang salah?</p>
+
+<p>Jawabnya: tidak ada yang salah. Kita hanya perlu bekerja sedikit lagi pada <em>view kita</em>.</p>
+
+<h2>Menyimpan Form</h2>
+
+<p>Buka <code> blog / views.py </ 0> sekali lagi. Saat ini semua yang ada pada tampilan <code> post_new </ 0> adalah sebagai berikut:</p>
+
+<p>{% filename%} blog / views.py {% endfilename%}</p>
+
+<pre><code class="python">def post_new (request):
+     form = PostForm ()
+     mengembalikan render (request, 'blog / post_edit.html', {'form': form} )
+`</pre> 
+    
+    Saat kita mengirimkan formulir, kita dibawa kembali ke tampilan yang sama, tapi kali ini kita memiliki beberapa data lagi di ` request </ 0> , lebih khusus lagi pada permintaan <code> .POST </ 0> (penamaannya telah tidak ada hubungannya dengan blog "post", ada kaitannya dengan fakta bahwa kita "memposting" data). Ingat bagaimana dalam file HTML, definisi <code><form>` kami memiliki variabel ` method = "POST" </ 1> ? Semua field dari from tersebut kini dalam <code>request.POST`. Anda tidak boleh merename `POST` apapun namanya (satu-satunya nilai valed dari `method` adalah `GET`, akan tetapi kami tidak punya cukup waktu untuk menjelaskan perbedaannya).
+    
+    Jadi dalam kami * pandangan </ 0> kita memiliki dua situasi yang terpisah untuk menangani: pertama, ketika kita mengakses halaman untuk pertama kalinya dan kami ingin formulir kosong, dan kedua, ketika kita kembali ke * tampilan </ 0> dengan semua data formulir yang baru saja kita ketik. Sehingga kita perlu menambahkan sebuah kondisi (akan kita gunakan `if` untuk keperluan tersebut):</p> 
+    
+    {% filename%} blog / views.py {% endfilename%}
+    
+    ```python
+jika request.method == "POST":
+ [...] 
+else:
+ form = PostForm ()        
+```
+
+Saatnya untuk mengisi titik-titik ` [...] </ 0> . Jika <code> method </ 0> adalah <code> POST </ 0> maka kita ingin membuat <code> PostForm </ 0> dengan data dari form, kan? Kami akan melakukannya sebagai berikut:</p>
+
+<p>{% filename%} blog / views.py {% endfilename%}</p>
+
+<pre><code class="python">form = PostForm (request.POST)
+`</pre> 
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+Kita cek apakah form tersebut valid dan jika ya, kita dapat menyimpannya!
+
+{% filename%} blog / views.py {% endfilename%}
+
+```python
+jika form.is_valid ():
+     post = form.save (komit = salah)
+     post.author = request.user
+     post.published_date = timezone.now ()
+     post.save () post.save ()
+```
+
+Pada dasarnya, kita memiliki dua hal di sini: kita simpan form dengan ` form.save </ 0> dan kita tambahkan seorang penulis (karena tidak ada bidang <code> author </ 0> di <code> PostForm </ 0> dan bidang ini diperlukan). <code> commit = Salah </ 0> berarti kita tidak ingin menyimpan model <code> Post </ 0> - kita ingin menambahkan penulis terlebih dahulu. Sebagian besar waktu Anda akan menggunakan <code> form.save () </ 0> tanpa <code> commit = False </ 0> , namun dalam kasus ini, kita perlu menyediakannya. <code> post.save () </ 0> akan menyimpan perubahan (menambahkan penulis) dan sebuah posting blog baru dibuat!</p>
+
+<p>Akhirnya, akan sangat mengagumkan jika kita bisa langsung masuk ke halaman <code> post_detail </ 0> untuk posting blog kita yang baru dibuat, bukan? Untuk melakukan itu kita memerlukan satu impor lagi:</p>
+
+<p>{% filename%} blog / views.py {% endfilename%}</p>
+
+<pre><code class="python">dari django.shortcuts import redirect
+`</pre> 
+
+Tambahkan di awal file Anda. Dan sekarang kita bisa mengatakan, "pergi ke halaman ` post_detail </ 0> untuk posting yang baru dibuat":</p>
+
+<p>{% filename%} blog / views.py {% endfilename%}</p>
+
+<pre><code class="python">pengalihan kembali ('post_detail', pk = post.pk)
+`</pre> 
+
+` post_detail </ 0> adalah nama tampilan yang ingin kita tuju. Ingat bahwa <em>view</em> ini memerlukan sebuah variabel <code>pk`? Untuk menyebarkannya ke tampilan, kita menggunakan ` pk = post.pk </ 0> , di mana <code> post </ 0> adalah postingan blog yang baru dibuat!</p>
+
+<p>Baiklah, kita sudah banyak bicara, tapi kita mungkin ingin melihat seperti apa tampilan <em> lihat </ 0> sekarang juga kan?</p>
+
+<p>{% filename%} blog / views.py {% endfilename%}</p>
+
+<pre><code class="python">def post_new (request):
+     if request.method == "POST":
+         form = PostForm (request.POST)
+         jika form.is_valid ():
+             post = form.save (commit = false)
+             post.author = request.user
+             post.             publish_date = timezone.now ()
+ post.save ()
+             pengalihan kembali ('post_detail', pk = post.pk)
+     else:
+         form = PostForm ()
+     mengembalikan render (permintaan, 'blog / post_edit.html', {'form': bentuk} )
+`</pre> 
+
+Mari lihat, apakah dapat berjalan. Pergi ke halaman http://127.0.0.1:8000/post/new/, tambahkan ` judul </ 0> dan <code> teks </ 0> , simpan ... dan voila! Posting blog baru ditambahkan dan kami diarahkan ke halaman <code> post_detail </ 0> !</p>
+
+<p>Anda mungkin telah memperhatikan bahwa kami menetapkan tanggal publikasi sebelum menyimpan pos. Nantinya, kami akan mengenalkan <em> tombol publish </ 0> di <strong> Django Girls Tutorial: Extensions </ 1> .</p>
+
+<p>Sejauh ini bagus !</p>
+
+<blockquote>
+  <p>Karena kita baru saja menggunakan antarmuka admin Django, sistem saat ini berpikir kita masih login. Ada beberapa situasi yang bisa menyebabkan kita keluar (menutup browser, memulai ulang DB, dll.). Jika, ketika membuat sebuah posting, Anda menemukan bahwa Anda mendapatkan kesalahan yang mengacu pada kurangnya pengguna yang masuk, masuk ke halaman admin http://127.0.0.1:8000/admin dan masuk lagi. Ini sementara akan menyelesaikan permasalahan. Ada penyelesain permanen yang menanti anda pada bab <strong>Homework: add security to your website!</strong> setelah tutorial utama.</p>
+</blockquote>
+
+<p><img src="images/post_create_error.png" alt="Login Error" /></p>
+
+<h2>Validasi Form</h2>
+
+<p>Sekarang, akan kami perlihatkan betapa hebatnya form django itu. Sebuah post blog perlu memiliki field <code>title` dan `text`. Pada model ` Post </ 0> kami tidak mengatakan bahwa bidang ini (berlawanan dengan <code> published_date </ 0> ) tidak diperlukan, jadi Django, secara default, mengharapkannya disetel.</p>
+
+<p>Cobalah untuk menyimpan formulir tanpa <code> judul </ 0> dan <code> teks </ 0> . Coba tebak apa yang akan terjadi!</p>
+
+<p><img src="images/form_validation2.png" alt="Validasi Form" /></p>
+
+<p>Django berusaha untuk memvalidasi bahwa semua bidang dalam formulir kami benar. Bukankah itu mengagumkan?</p>
+
+<h2>Form Edit</h2>
+
+<p>Kini kita tahu bagaimana menambah form baru. Tetapi, bagaimana jika kita ingin mengedit yang sudah ada ? Ini sangat mirip dengan apa yang baru saja kita lakukan. Mari buat beberapa hal penting dengan cepat. (Jika Anda tidak mengerti sesuatu, Anda harus bertanya kepada pelatih Anda atau melihat bab-bab sebelumnya, karena kami telah menyelesaikan semua langkah ini.)</p>
+
+<p>Buka <code> blog / templates / blog / post_detail.html </ 0> dan tambahkan barisnya</p>
+
+<p>{% filename%} blog / templates / blog / post_detail.html {% endfilename%}</p>
+
+<pre><code class="html">&lt;a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"&gt;&lt;span class="glyphicon glyphicon-pencil"&gt; </ 0>
+`</pre> 
+
+sehingga template akan terlihat seperti ini:
+
+{% filename%} blog / templates / blog / post_detail.html {% endfilename%}
+
+```html
+{% meluas 'blog / base.html'%}
+
+ {% blok konten%} 
+&lt;div class="post"&gt; {% jika post.published_date%} &lt;div class="date"&gt; {{post.published_date}} </ 1> {% endif%} <2 > </ 2> &lt;h1&gt; {{post.title}} </ 3> &lt;p&gt; {{post.text | linebreaksbr}} </ 4> </ 0> {% endblock%}    
+        
+            
+                
+            
+        
+        
+        
+        
+    
+
+```
+
+Dalam `blog/urls.py` kita tambah baris ini:
+
+{% filename%} blog / urls.py {% endfilename%}
+
+```python
+    url (r '^ post / (? P <pk> \ d +) / edit / $', views.post_edit, name = 'post_edit'),
+```
+
+Kita akan menggunakan kembali template `blog/templates/blog/post_edit.html`, sehingga sesuatu yang belum adalah sebuah *view*.
+
+Mari buka ` blog / views.py </ 0> dan tambahkan ini di bagian akhir file:</p>
+
+<p>{% filename%} blog / views.py {% endfilename%}</p>
+
+<pre><code class="python">def post_edit (request, pk):
+     post = get_object_or_404 (Post, pk = pk)
+     jika request.method == "POST":
+         form = PostForm (request.POST, instance = post)
+         if form.is_valid ():
+             post = form .save (commit = False)
+             post.author = request.user
+             post.published_date = timezone.now ()
+             post.save ()
+             pengalihan kembali ('post_detail', pk = post.pk)
+     else:
+         form = PostForm (instance = post )
+     mengembalikan render (permintaan, 'blog / post_edit.html', {'form': form} )
+`</pre> 
+
+Ini tampak hampir sama persis dengan view `post_new` kita, benar ? Tetapi tidak seluruhnya sama persis. Untuk satu, kami melewatkan parameter ` pk </ 0> tambahan dari url. Selanjutnya, kita mendapatkan <code> Post </ 0> model yang ingin kita edit dengan <code> get_object_or_404 (Post, pk = pk) </ 0> dan kemudian, ketika kita membuat sebuah form, kita melewati postingan ini sebagai < 0> contoh </ 0> , saat kita menyimpan form ...</p>
+
+<p>{% filename%} blog / views.py {% endfilename%}</p>
+
+<pre><code class="python">form = PostForm (request.POST, instance = post)
+`</pre> 
+
+... dan saat kami baru saja membuka formulir dengan tulisan ini untuk diedit:
+
+{% filename%} blog / views.py {% endfilename%}
+
+```python
+form = PostForm (contoh = post)
+```
+
+Baiklah, mari kita uji jika berhasil! Ayo pergi ke halaman ` post_detail </ 0> . Harus ada tombol edit di pojok kanan atas:</p>
+
+<p><img src="images/edit_button2.png" alt="Tombol Edit" /></p>
+
+<p>Ketika anda mengkliknya, anda aka melihat form tersebut berisi post blog kita:</p>
+
+<p><img src="images/edit_form2.png" alt="Form Edit" /></p>
+
+<p>Jangan ragu untuk mengganti judul atau teks dan simpan perubahannya!</p>
+
+<p>Selamat! Aplikasi anda makin lama makin lengkap!</p>
+
+<p>Jika Anda memerlukan informasi lebih lanjut tentang formulir Django, Anda harus membaca dokumentasi: https://docs.djangoproject.com/en/1.11/topics/forms/</p>
+
+<h2>Keamanan</h2>
+
+<p>Telah berhasil membuat post baru hanya dengan melakukan klik pada sebuah link itu hebat! Tapi, sekarang seseorang yang mengunjungi website anda akan dapat memposting postingan baru dan itu mungkin bukan hal yang anda inginkan! Tapi sekarang, siapa pun yang mengunjungi situs Anda akan dapat membuat posting blog baru, dan itu mungkin bukan sesuatu yang Anda inginkan. Mari kita membuatnya jadi tombol muncul untuk Anda tapi tidak untuk orang lain.</p>
+
+<p>Dalam <code>blog/templates/blog/base.html`, temukan `div` dari `page-header` kita dan anchor tag yang anda letakkan sebelumnya. Tampilannya seharusnya seperti ini:
+
+{% filename%} blog / templates / blog / base.html {% endfilename%}
+
+```html
+&lt;a href="{% url 'post_new' %}" class="top-menu"&gt;&lt;span class="glyphicon glyphicon-plus"&gt; </ 0>
+```
+
+Kami akan menambahkan tag ` {% jika%} </ 0> ke ini, yang akan membuat tautan hanya muncul untuk pengguna yang masuk ke admin. Sekarang, itu hanya kamu! Ubah tag 0>&lt;a&gt;` agar menjadi ini:
+
+{% filename%} blog / templates / blog / base.html {% endfilename%}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+Ini ` {% jika%} </ 0> akan menyebabkan tautan dikirim ke browser hanya jika pengguna yang meminta halaman masuk. Ini tidak melindungi adanya penulisan post baru seluruhnya, tapi cukup bagus untuk langkah awal. Kita akan mempelajari masalah keamanan lebih jauh pada pelajaran tentang extension.</p>
+
+<p>Ingat ikon edit yang baru saja kita tambahkan ke halaman detail kita? Kami juga ingin menambahkan perubahan yang sama di sana, sehingga orang lain tidak dapat mengedit posting yang ada.</p>
+
+<p>Buka <code> blog / templates / blog / post_detail.html </ 0> dan temukan baris ini:</p>
+
+<p>{% filename%} blog / templates / blog / post_detail.html {% endfilename%}</p>
+
+<pre><code class="html">&lt;a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"&gt;&lt;span class="glyphicon glyphicon-pencil"&gt; </ 0>
+`</pre> 
+
+Ubah ke ini:
+
+{% filename%} blog / templates / blog / post_detail.html {% endfilename%}
+
+```html
+{% jika user.is_authenticated%} 
+&lt;a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"&gt;&lt;span class="glyphicon glyphicon-pencil"&gt; </ 0> {% endif%}     
+
+```
+
+Karena Anda mungkin masuk, jika Anda menyegarkan halaman, Anda tidak akan melihat sesuatu yang berbeda. Muatkan halaman di browser lain atau jendela penyamaran (disebut "InPrivate" di Windows Edge), meskipun, dan Anda akan melihat bahwa tautan tidak muncul, dan ikonnya juga tidak ditampilkan!
+
+## Satu hal lagi: saatnya melakukan deploy!
+
+Mari kita lihat apakah itu semua dapat berjalan di PythonAnywhere. Saatnya melakukan deploy lagi!
+
+* Pertama, lakukan commit kode baru anda dan kirim ke GitHub:
+
+{% filename%} baris perintah {% endfilename%}
+
+    $ git status $ git add --all. $ git status $ git commit -m "Ditambahkan tampilan untuk membuat / mengedit posting blog di dalam situs." $ git push
+    
+
+* Kemudian dalam konsol Bash [PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename%} baris perintah {% endfilename%}
+
+    $ cd my-first-blog $ git pull
+     [...]
+    
+
+* Yang terakhir, cari [Web tab](https://www.pythonanywhere.com/web_app_setup/) dan klik **Reload**.
+
+Dan seharusnya dapa berjalan! Selamat :)
\ No newline at end of file
diff --git a/id/django_installation/README.md b/id/django_installation/README.md
new file mode 100644
index 00000000000..c6530739e25
--- /dev/null
+++ b/id/django_installation/README.md
@@ -0,0 +1,7 @@
+# Installasi Django
+
+> ** Catatan </ 0> Jika Anda menggunakan Chromebook, lewati bab ini dan pastikan Anda mengikuti petunjuk  Pengaturan Chromebook </ 1> .</p> 
+> 
+> ** Catatan </ 0> Jika Anda sudah mengerjakan langkah-langkah Instalasi maka Anda telah melakukan ini - Anda bisa langsung menuju bab berikutnya!</p> </blockquote> 
+> 
+> {% include "/django_installation/instructions.md"%}
\ No newline at end of file
diff --git a/id/django_installation/instructions.md b/id/django_installation/instructions.md
new file mode 100644
index 00000000000..5958c90c641
--- /dev/null
+++ b/id/django_installation/instructions.md
@@ -0,0 +1,202 @@
+> Bagian dari bagian ini didasarkan pada tutorial oleh Geek Girls Wortel (https://github.com/ggcarrots/django-carrots).
+> 
+> Bagian dari bagian ini didasarkan pada tutorial  Django-marcador </ 0> yang berlisensi di bawah Lisensi Internasional Creative Commons Attribution-ShareAlike 4.0. Hak cipta tutorial django-marcador oleh Markus Zapke-Gründemann et al.</p> </blockquote> 
+> 
+> ## Virtual Environment
+> 
+> Sebelum kita menginstal django kami akan mengajari anda untuk menginstall tool yang sangat penting yang akan menjaga lingkungan pengembangan anda teratur di komputer anda. Dimungkinkan untuk melewati bagian ini, tapi sangat dianjurkan untuk tidak melewatinya. Dimulai dengan setup sebaik mungkin akan menghindarkan anda dari banyak kesulitan di masa yang akan datang.
+> 
+> Karena itu, mari membuat sebuah **virtual environment** (juga disebut *virtualenv*). Virtualenv akan memisahkan setup Python/Django untuk tiap proyek. Ini artinya bahwa suatu perubahan yang anda buat pada sebuah website, tidak akan mempengaruhi website lain yang juga sedang anda kembangkan. Jelas bukan ?
+> 
+> Yang perlu anda kerjakan adalah menemukan sebuah direktory dimana anda ingin menciptakan `virtualenv`, yaitu home directory anda, ini sebagai misal. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+> 
+> > **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+> 
+> Karena tutorial ini akan menggunakan sebuah direktory baru yaitu `djangogirls`, dari home direktory anda:
+> 
+> {% filename%} baris perintah {% endfilename%}
+> 
+>     $ mkdir djangogirls $ cd djangogirls
+>     
+> 
+> Kita akan membuat sebuah virtualenv dengan nama `myenv`. Bentuk perintah umumnya seperti ini:
+> 
+> {% filename%} baris perintah {% endfilename%}
+> 
+>     $ python3 -m venv myvenv
+>     
+> 
+> <!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+> 
+> Untuk membuat new ` virtualenv </ 0> , Anda perlu membuka command prompt dan menjalankan <code> python -m venv myvenv </ 0> . Ini akan terlihat seperti ini:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>C: \ Users \ Name \ djangogirls & gt; python -m venv myvenv
+`</pre> 
+> 
+> Dimana ` myvenv </ 0> adalah nama <code> virtualenv </ 0> Anda . Anda boleh menggunakan nama yang lain, tapi harus menggunakan huruf kecil dan tanpa spasi, karakter khusus ataupun tanda petik. Ini juga ide bagus untuk menjaga agar nama tetap pendek - Anda akan sering merujuknya!</p>
+
+<!--endsec-->
+
+
+> 
+> <!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+<p>We can create a <code>virtualenv` on both Linux and OS X by running 
+> 
+> `python3 -m venv myvenv`. It will look like this:
+> 
+> {% filename%} baris perintah {% endfilename%}
+> 
+>     $ python3 -m venv myvenv
+>     
+> 
+> `myvenv` adalah nama dari `virtualenv` anda. Anda dapat menggunakan nama lain akan tetapi tetap gunakan huruf kecil dan tanpa spasi. It is also a good idea to keep the name short as you'll be referencing it a lot!
+> 
+> > ** CATATAN: </ 0> Pada beberapa versi Debian / Ubuntu Anda mungkin menerima error berikut:</p> 
+> > 
+> > {% filename%} baris perintah {% endfilename%}
+> > 
+> >     Lingkungan virtual tidak berhasil dibuat karena ensurepip tidak tersedia.  Pada sistem Debian / Ubuntu, Anda perlu menginstal paket python3-venv menggunakan perintah berikut.
+> >        apt-get install python3-venv Anda mungkin perlu menggunakan sudo dengan perintah itu.  Setelah menginstal paket python3-venv, buat ulang lingkungan virtual Anda.
+> >     
+> > 
+> > Dalam kasus ini, ikuti petunjuk di atas dan pasang paket ` python3-venv </ 0> :
+ {% filename%} command-line {% endfilename%}  </p>
+
+<pre><code>$ sudo apt-get install python3-venv
+`</pre> 
+> > 
+> > ** CATATAN: </ 0> Pada beberapa versi Debian / Ubuntu yang memulai lingkungan virtual seperti saat ini memberikan error berikut:</p> 
+> > 
+> > {% filename %}baris perintah{% endfilename %}
+> > 
+> >     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+> >     
+> > 
+> > Untuk mengatasi hal ini, gunakan perintah `virtualenv`.
+> > 
+> > {% filename%} baris perintah {% endfilename%}
+> > 
+> >     $ sudo apt-get install python-virtualenv $ virtualenv --python = python3.6 myvenv
+> >     
+> > 
+> > ** CATATAN: </ 0> Jika Anda mengalami error seperti</p> 
+> > 
+> > {% filename%} baris perintah {% endfilename%}
+> > 
+> >     E: Tidak dapat menemukan paket python3-venv
+> >     
+> > 
+> > lalu jalankan:
+> > 
+> > {% filename%} baris perintah {% endfilename%}
+> > 
+> >     sudo apt install python3.6-venv
+> >     </blockquote> 
+> > 
+> > <!--endsec-->
+> > 
+> > ## Bekerja Dengan Virtualenv
+> > 
+> > Perintah di atas akan meciptakan sebuah direktori dengan nama `myvenv` (atau nama apa saja yang anda pilih) yang berisi virtual environment kita (jelasnya berisi banyak file dan direktori).
+> > 
+> > <!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+> > 
+> > Aktifkan virtual environment anda dengan menjalankan:
+> > 
+> > {% filename%} baris perintah {% endfilename%}
+> > 
+> >     C: \ Users \ Name \ djangogirls & gt; myvenv \ Scripts \ activate
+> >     
+> > 
+> > > ** CATATAN: </ 0> pada Windows 10 Anda mungkin mendapatkan pesan kesalahan pada Windows PowerShell yang mengatakan bahwa ` eksekusi skrip dinonaktifkan pada sistem ini </ 1> . Dalam kasus ini, buka Windows PowerShell lainnya dengan opsi "Run as Administrator".  Kemudian coba ketikkan perintah berikut sebelum memulai lingkungan virtual Anda:</p>
+  
+  <p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>C: \ WINDOWS \ system32 & gt; Set-ExecutionPolicy -ExecutionPolicy     Perubahan Kebijakan Eksekusi RemoteSigned
+ Kebijakan
+     eksekusi membantu melindungi Anda dari skrip yang tidak Anda percaya. Mengubah kebijakan eksekusi mungkin akan memaparkan risiko keamanan yang dijelaskan di topik bantuan about_Execution_Policies di http://go.microsoft.com/fwlink/?LinkID=135170. Apakah Anda ingin mengubah kebijakan eksekusi? [Y] Ya   [A] Ya untuk Semua   [N] Tidak   [L] Tidak untuk Semua   [S] Suspend [?] Help (defaultnya adalah "N"): A
+`</pre> </blockquote> 
+> > > 
+> > > <!--endsec-->
+> > > 
+> > > <!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+> > > 
+> > > Aktifkan virtual environment anda dengan menjalankan:
+> > > 
+> > > {% filename%} baris perintah {% endfilename%}
+> > > 
+> > >     $ source myvenv / bin / aktifkan
+> > >     
+> > > 
+> > > Ingat untuk mengganti `myvenv` dengan nama pilihan anda `virtualenv` name!
+> > > 
+> > > > **CATATAN:** kadang-kadang `source` tidak tersedia. Kalau anda menghadapi masalah tersebut coba ini:
+> > > > 
+> > > > {% filename%} baris perintah {% endfilename%}
+> > > > 
+> > > >     $. myvenv / bin / aktifkan
+> > > >     
+> > > 
+> > > <!--endsec-->
+> > > 
+> > > Anda akan tahu bahwa Anda memiliki ` virtualenv </ 0> dimulai saat Anda melihat bahwa prompt di konsol Anda diawali dengan <code> (myvenv) </ 0> .</p>
+
+<p>Ketika anda bekerja dalam sebuah virtual environment, <code>python` akan otomatis mengacu pada versi yang benar sehingga anda dapat menggunakan perintah `python` bukannya `python3`.
+> > > 
+> > > Oke, kita telah memiliki semua dipendensi penting pada tempatnya. Pada akhirnya kita dapat mengintal django.
+> > > 
+> > > ## Menginstall Django
+> > > 
+> > > Sekarang setelah ` virtualenv </ 0> dimulai, Anda bisa menginstal Django.</p>
+
+<p>Sebelum kita melakukan itu, kita harus memastikan bahwa kita memiliki versi terbaru <code> pip </ 0> , perangkat lunak yang kita gunakan untuk menginstal Django:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>(myvenv) ~ $ pip install --upgrade pip
+`</pre> 
+> > > 
+> > > Kemudian jalankan ` pip install django ~ = 1.11.0 </ 0> (perhatikan bahwa kita menggunakan tilde diikuti dengan tanda yang sama: <code> ~ = </ 0> ) untuk menginstal Django.</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>(myvenv) ~ $ pip install django ~ = 1.11.0 Mengumpulkan Django ~ = 1.11.0
+   Men-download Django-1.11.3-py2.py3-none-any.whl (6.8MB) Menginstal paket yang dikumpulkan: Django Berhasil menginstal Django-1.11 .3
+`</pre> <!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+> > > 
+> > > > Jika Anda mendapatkan pesan kesalahan saat memanggil pip pada platform Windows, periksa apakah pathname proyek Anda berisi spasi, aksen atau karakter khusus (misalnya, ` C: \ Users \ User Name \ djangogirls </ 0> ). Jika ya, mohon pertimbangkan untuk menggunakan tempat lain tanpa spasi, aksen atau karakter khusus (saran: <code> C: \ djangogirls </ 0> ). Buat virtualenv baru di direktori baru, lalu hapus yang lama dan coba perintah di atas lagi. (Memindahkan direktori virtualenv tidak akan berfungsi karena virtualenv menggunakan path absolut.)</p>
+</blockquote>
+
+<!--endsec-->
+
+
+> > > > 
+> > > > <!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+<blockquote>
+  <p>Baris perintah Anda mungkin membeku setelah Anda mencoba menginstal Django. Jika ini terjadi, alih-alih penggunaan perintah di atas:</p>
+  
+  <p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>C: \ Users \ Name \ djangogirls & gt; python -m pip install django ~ = 1.11.0
+`</pre> </blockquote> 
+> > > > 
+> > > > <!--endsec-->
+> > > > 
+> > > > <!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+> > > > 
+> > > > > Jika anda mengalami error saat memanggil pip pada Ubuntu 12.04 silahkan jalankan code berikut `python -m pip install -U --force-reinstall pip` untuk memperbaiki instalasi pip pada cirtualenv.
+> > > > 
+> > > > <!--endsec-->
+> > > > 
+> > > > Itu dia! Akhirnya sekarang anda telah membuat aplikasi Django!
\ No newline at end of file
diff --git a/id/django_models/README.md b/id/django_models/README.md
new file mode 100644
index 00000000000..8d98afde180
--- /dev/null
+++ b/id/django_models/README.md
@@ -0,0 +1,183 @@
+# Model Django
+
+Apa yang akan kita buat sekarang adalah sesuatu untuk menyimpan semua postingan pada blog kita. tetapi untuk bisa melakukan hal itu kita akan sedikit membahas tentang `objects`.
+
+## Benda
+
+Ada konsep dalam pemrograman yang disebut ` pemrograman berorientasi obyek </ 0> . Idenya adalah bahwa alih-alih menulis segala sesuatu sebagai urutan instruksi pemrograman yang membosankan, kita dapat memodelkan berbagai hal dan menentukan bagaimana mereka berinteraksi satu sama lain.</p>
+
+<p>Jadi apa itu obyek? Ini adalah kumpulan properti dan tindakan. Kedengarannya aneh, tapi kami akan memberi contoh.</p>
+
+<p>Jika kita ingin model kucing, kita akan membuat objek <code> Cat </ 0> yang memiliki beberapa properti seperti <code> warna </ 0> , <code> usia </ 0> , <code> mood < / 0> (seperti baik, buruk, atau mengantuk;)), dan <code> pemilik </ 0> (yang dapat diberi objek <code> Person </ 0> - atau mungkin, jika ada kucing yang tersesat, properti ini bisa kosong).</p>
+
+<p>Kemudian <code> Cat </ 0> memiliki beberapa tindakan: <code> purr </ 0> , <code> scratch </ 0> , atau <code> feed </ 0> (dalam hal ini, kami akan memberikannya Cat beberapa <code> CatFood </ 0> , yang bisa jadi objek terpisah dengan properti, seperti <code> taste </ 0> ).</p>
+
+<pre><code>Cat -------- usia warna mood owner purr () scratch () feed (cat_food)
+`</pre> 
+
+    Makanan Kucing --------
+    
+
+Jadi intinya idenya adalah untuk mendeskripsikan hal-hal nyata dalam kode dengan properti (disebut ` object properties </ 0> ) dan tindakan (disebut <code> methods </ 0> ).</p>
+
+<p>Bagaimana kita akan model posting blog itu? Kami ingin membangun blog, bukan?</p>
+
+<p>Kita perlu menjawab pertanyaan: Apa itu posting blog? Properti apa yang seharusnya dimiliki?</p>
+
+<p>Nah, pastinya posting blog kita butuh beberapa teks dengan konten dan judulnya kan? Akan sangat menyenangkan mengetahui siapa yang menulisnya - jadi kita butuh seorang penulis. Akhirnya, kami ingin tahu kapan posting itu dibuat dan dipublikasikan.</p>
+
+<pre><code>Posting -------- judul teks penulis created_date published_date
+`</pre> 
+
+Hal apa saja yang bisa dilakukan dengan posting blog? Akan menyenangkan untuk memiliki beberapa ` metode </ 0> yang menerbitkan posting, kan?</p>
+
+<p>Jadi kita perlu <code> mempublikasikan </ 0> method.</p>
+
+<p>Karena kita sudah tahu apa yang ingin kita capai, mari kita mulai pemodelannya di Django!</p>
+
+<h2>Model Django</h2>
+
+<p>Mengetahui apa itu objek, kita bisa membuat model Django untuk posting blog kita.</p>
+
+<p>Model di Django adalah jenis khusus dari objek - itu disimpan dalam <code> Database </ 0> . Database adalah kumpulan data. Ini adalah tempat di mana Anda akan menyimpan informasi tentang pengguna, posting blog Anda, dll. Kami akan menggunakan database SQLite untuk menyimpan data kami. Ini adalah default database Django adaptor - itu akan cukup bagi kita sekarang.</p>
+
+<p>Anda bisa memikirkan model dalam database sebagai spreadsheet dengan kolom (field) dan baris (data).</p>
+
+<h3>Membuat aplikasi</h3>
+
+<p>Agar semuanya tetap rapi, kami akan membuat aplikasi terpisah di dalam proyek kami. Sangat menyenangkan untuk memiliki semua yang terorganisir sejak awal. Untuk membuat aplikasi kita perlu menjalankan perintah berikut di console (dari <code> djangogirls </ 0> directory dimana <code> manage.py </ 0> file is):</p>
+
+<p>{% filename %}Mac OS X and Linux:{% endfilename %}</p>
+
+<pre><code>(myvenv) ~ / djangogirls $ python manage.py startapp blog
+`</pre> 
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Membuat model posting blog
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Periksa bahwa Anda menggunakan karakter dua garis bawah (`_`) pada setiap sisi `str`. Konvensi ini sering digunakan dengan Python dan terkadang kita juga menyebutnya "dunder" (singkatan dari "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- ` class </ 0> adalah kata kunci khusus yang menunjukkan bahwa kita mendefinisikan suatu objek.</li>
+<li><code> Posting </ 0> adalah nama model kami. Kita bisa memberikannya nama yang berbeda (tapi kita harus menghindari karakter dan spasi khusus). Selalu mulai nama kelas dengan huruf besar.</li>
+<li><code> models.Model </ 0> berarti bahwa Post adalah Model Django, jadi Django tahu bahwa itu harus disimpan dalam database.</li>
+</ul>
+
+<p>Now we define the properties we were talking about: <code>title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)</p> 
+    - ` models.CharField </ 0> - begitulah cara Anda mendefinisikan teks dengan jumlah karakter yang terbatas.</li>
+<li><code> models.TextField </ 0> - ini untuk teks panjang tanpa batas. Kedengarannya ideal untuk konten posting blog kan?</li>
+<li><code> models.DateTimeField </ 0> - ini adalah tanggal dan waktu.</li>
+<li><code> models.ForeignKey </ 0> - ini adalah link ke model lain.</li>
+</ul>
+
+<p>We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).</p>
+
+<p>What about <code>def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.</p> 
+        Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+        
+        Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+        
+        If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+        
+        ### Buat tabel untuk model di database Anda
+        
+        The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+        
+        {% filename %}command-line{% endfilename %}
+        
+            (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+            Migrations for 'blog':
+              blog/migrations/0001_initial.py:
+            
+              - Create model Post
+            
+        
+        **Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+        
+        Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+        
+        {% filename %}command-line{% endfilename %}
+        
+            (myvenv) ~/djangogirls$ python manage.py migrate blog
+            Operations to perform:
+              Apply all migrations: blog
+            Running migrations:
+              Rendering model states... DONE
+              Applying blog.0001_initial... OK
+            
+        
+        Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/id/django_orm/README.md b/id/django_orm/README.md
new file mode 100644
index 00000000000..83db96a1302
--- /dev/null
+++ b/id/django_orm/README.md
@@ -0,0 +1,203 @@
+# Django ORM dan QuerySets
+
+Pada chapter kali ini, kamu akan belajar bagaimana Django terkoneksi dengan database dan menyimpan data tersebut didalamnya. Mari kita mulai!
+
+## Apa itu QuerySet?
+
+QuerySet pada dasarnya adalah daftar objek dari Model yang diberikan. QuerySets memungkinkan Anda untuk membaca data dari database, memfilter dan memesannya.
+
+Ini paling mudah untuk belajar lewat contoh. Mari kita coba ini, gimana?
+
+## Django shell
+
+Buka konsol lokal kamu (bukan di PythonAnywhere) dan ketik baris perintah ini:
+
+{% filename%} baris perintah {% endfilename%}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Hasilnya akan seperti ini:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Anda sekarang ada di konsol interaktif Django. Ini sama seperti prompt Python, tapi dengan beberapa tambahan Django magic. :) Anda bisa menggunakan semua perintah Python di sini juga, tentu saja.
+
+### Semua benda
+
+Mari kita coba tampilkan semua postingan kita dulu. Kamu bisa melakukan itu dengan perintah seperti ini:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Ups! Sebuah kesalahan muncul. Ini memberitahu kita bahwa tidak ada Post. Benar - kita lupa mengimpornya dulu!
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+& gt; & gt; & gt; Post.objects.all ()
+ <QuerySet [<Post: my post title> , <Post: another post title> ] & gt;
+```
+
+Ini adalah daftar posting yang kami buat tadi! Kami membuat posting ini menggunakan antarmuka admin Django. Tapi sekarang kita ingin membuat posting baru menggunakan Python, jadi bagaimana kita melakukannya?
+
+### Buat objek
+
+Beginilah cara Anda membuat objek Post baru di database:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+& gt; & gt; & gt; Post.objects.create (author = me, title = 'Contoh judul', teks = 'Uji')
+```
+
+Tapi kami punya satu unsur yang hilang di sini: ` saya </ 0> . Kita perlu melewatkan sebuah instance dari model <code> User </ 0> sebagai penulis. Bagaimana kita melakukannya?</p>
+
+<p>Mari impor model Pengguna terlebih dahulu:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">& gt; & gt; & gt; dari django.contrib.auth.models import User
+`</pre> 
+
+Pengguna apa yang ada di database kami? Coba ini:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+& gt; & gt; & gt; User.objects.all ()
+ <QuerySet [<User: ola> ] & gt;
+```
+
+Ini adalah superuser yang kita buat tadi! Mari dapatkan contoh pengguna sekarang:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+& gt; & gt; & gt; saya = User.objects.get (username = 'ola')
+```
+
+Seperti yang Anda lihat, sekarang kita ` mendapatkan </ 0> a <code> Pengguna </ 0> dengan <code> nama pengguna </ 0> yang sama dengan 'ola'. Rapi! Tentu saja, Anda harus menyesuaikan baris ini untuk menggunakan username Anda sendiri.</p>
+
+<p>Sekarang kita akhirnya bisa membuat tulisan kita:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">& gt; & gt; & gt; Post.objects.create (author = me, title = 'Contoh judul', teks = 'Uji')
+`</pre> 
+
+Hore! Ingin memeriksa apakah berhasil?
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+& gt; & gt; & gt; Post.objects.all ()
+ <QuerySet [<Post: my post title> , <Post: another post title> , <Post: Sample title> ] & gt;
+```
+
+Itu dia, satu lagi posting di daftar!
+
+### Tambahkan lebih banyak pos
+
+Anda sekarang dapat bersenang-senang dan menambahkan lebih banyak pos untuk melihat cara kerjanya. Tambahkan dua atau tiga lagi dan kemudian lanjutkan ke bagian selanjutnya.
+
+### Filter objek
+
+Sebagian besar QuerySets adalah kemampuan untuk memfilternya. Katakanlah kita ingin menemukan semua tulisan yang pengguna ola tulis. Kita akan menggunakan ` filter </ 0> daripada <code> all </ 0> di <code> Post.objects.all () </ 0> . Dalam kurung kita menyatakan kondisi apa yang harus dipatok oleh posting blog agar bisa berakhir dalam queryset kita. Dalam kasus kami, kondisinya adalah bahwa <code> penulis </ 0> harus sama dengan <code> saya </ 0> . Cara untuk menuliskannya di Django adalah <code> author = me </ 0> . Sekarang potongan kode kita terlihat seperti ini:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">& gt; & gt; & gt; Post.objects.filter (penulis = saya) [ <Post: Sample title> , <Post: Post number 2> , <Post: My 3rd post!> , <Post: 4th title of post> ]
+`</pre> 
+
+Atau mungkin kita ingin melihat semua tulisan yang berisi kata 'title' di bidang ` title </ 0> ?</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">& gt; & gt; & gt; Post.objects.filter (title__contains = 'title') [ <Post: Sample title> , <Post: 4th title of post> ]
+`</pre> 
+
+> ** Catatan </ 0> Ada dua karakter garis bawah ( ` _ </ 1> ) antara <code> judul </ 1> dan <code> berisi </ 1> . ORM Django menggunakan aturan ini untuk memisahkan nama field ("judul") dan operasi atau filter ("contains"). Jika Anda hanya menggunakan satu garis bawah, Anda akan mendapatkan pesan kesalahan seperti "FieldError: Tidak dapat menyelesaikan judul kata kunci_contains".</p>
+</blockquote>
+
+<p>Anda juga bisa mendapatkan daftar semua posting yang dipublikasikan. Kami melakukan ini dengan memfilter semua posting yang telah <code> publish_date </ 0> di sebelumnya:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">& gt; & gt; & gt; dari django.utils import timezone
+ & gt; & gt; & gt; Post.objects.filter (published_date__lte = timezone.now ()) []
+`</pre> 
+> 
+> Sayangnya, posting yang kami tambahkan dari konsol Python belum dipublikasikan. Tapi kita bisa mengubah itu! Pertama dapatkan sebuah instance dari sebuah postingan yang ingin kita publikasikan:
+> 
+> {% filename%} baris perintah {% endfilename%}
+> 
+> ```python
+& gt; & gt; & gt; post = Post.objects.get (judul = "judul contoh")
+```
+
+Kemudian publikasikan dengan metode ` publish </ 0> :</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">& gt; & gt; & gt; post.publish ()
+`</pre> 
+
+Sekarang cobalah untuk mendapatkan daftar posting yang dipublikasikan lagi (tekan tombol panah atas tiga kali dan tekan ` enter </ 0> ):</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">& gt; & gt; & gt; Post.objects.filter (published_date__lte = timezone.now ()) [ <Post: Sample title> ]
+`</pre> 
+
+### Memesan benda
+
+QuerySets juga memungkinkan Anda untuk memesan daftar objek. Mari kita coba untuk memesannya dengan bidang ` create_date </ 0> :</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">& gt; & gt; & gt; Post.objects.order_by ('created_date') [ <Post: Sample title> , <Post: Post number 2> , <Post: My 3rd post!> , <Post: 4th title of post> ]
+`</pre> 
+
+Kita juga bisa membalik pemesanan dengan menambahkan ` - </ 0> di awal:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code class="python">& gt; & gt; & gt; Post.objects.order_by ('- created_date') [ <Post: 4th title of post> ,   <Post: My 3rd post!> , <Post: Post number 2> , <Post: Sample title> ]
+`</pre> 
+
+### Chaining QuerySets
+
+Anda juga dapat menggabungkan QuerySets dengan ** chaining </ 0> bersama-sama:</p> 
+
+    & gt; & gt; & gt; Post.objects.filter (published_date__lte = timezone.now ()) order_by ('published_date')
+    
+
+Ini benar-benar hebat dan memungkinkan Anda menulis kueri yang cukup rumit.
+
+Keren! Anda sekarang siap untuk bagian selanjutnya! Untuk menutup shell, ketik ini:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+& gt; & gt; & gt; keluar () $
+```
\ No newline at end of file
diff --git a/id/django_start_project/README.md b/id/django_start_project/README.md
new file mode 100644
index 00000000000..e1941f20d7c
--- /dev/null
+++ b/id/django_start_project/README.md
@@ -0,0 +1,200 @@
+# Project Django pertamamu!
+
+> Bagian dari bab ini didasarkan pada tutorial oleh Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Bagian dari bab ini didasarkan pada  Django-marcador    tutorial </ 0> berlisensi di bawah Creative Commons    Lisensi Internasional Attribution-ShareAlike 4.0. Hak cipta tutorial django-marcador oleh Markus Zapke-Gründemann et al.</p> </blockquote> 
+> 
+> We're going to create a small blog!
+> 
+> Langkah pertama adalah memulai dengan mebuat projek baru Django. Pada dasarnya, Kita akan menjalankan beberapa skrip yang disediakan oleh Django yang amana akan membuat skeleton projek Django untuk kita. Ini merupakan bagian direktori dan file yang akan kita gunakan nanti.
+> 
+> Nama untuk beberapa file dan direktori sangat penting untuk Django. Kamu harus mengganti nama file yang akan kita buat. Memindahkan file tersebut ke tempat yang lain bukanlah ide yang bagus. Django perlu mempertahankan struktur tertentu agar bisa menemukan hal penting.
+> 
+> > Ingatlah untuk menjalankan semuanya di virtualenv. Jika Anda tidak melihat awalan ` (myvenv) </ 0> di konsol Anda, Anda perlu mengaktifkan virtualenv Anda. Kami menjelaskan bagaimana melakukannya di bagian <strong> instalasi Django </ 0> di bagian <strong> Bekerja dengan virtualenv </ 0> . Mengetik <code> myvenv \ Scripts \ activate </ 0> pada Windows atau
+ <code> sumber myvenv / bin / activate </ 0> pada Mac OS X atau Linux akan melakukan ini untuk Anda.  </p>
+</blockquote>
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+<p>Di konsol Mac OS X atau Linux Anda, Anda harus menjalankan perintah berikut. <strong> Jangan lupa menambahkan periode (atau titik) <code> . </ 1> di akhir! </ 0></p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>(myvenv) ~/djangogirls$ django-admin startproject mysite .
+`</pre> 
+> > 
+> > > Masalah `.` cukup krusial karena ini akan memberi perintah skrip untuk menginstall Django pada direktori-mu saat ini (untuk masalah `.` adalah referensi singkat).
+> > > 
+> > > ** Catatan </ 0> Saat mengetikkan perintah di atas, ingat bahwa Anda hanya mengetikkan bagian yang dimulai oleh ` Django-admin </ 1>.
+  Bagian <code> (myvenv) ~ / djangogirls $ </ 0> yang ditunjukkan di sini hanyalah contoh dari prompt yang akan mengundang masukan Anda pada baris perintah Anda.</p>
+</blockquote>
+
+<!--endsec-->
+
+
+> > > 
+> > > <!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+<p>Pada Windows Anda harus menjalankan perintah berikut. <strong> (Jangan lupa menambahkan periode (atau titik) <code>. </ 1> di akhir) </ 0>:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>(myvenv) C: \ Users \ Name \ djangogirls & gt; django-admin.exe startproject mysite.
+`</pre> 
+> > > 
+> > > > Masalah `.` cukup krusial karena ini akan memberi perintah skrip untuk menginstall Django pada direktori-mu saat ini (untuk masalah `.` adalah referensi singkat).
+> > > > 
+> > > > **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+> > > 
+> > > <!--endsec-->
+> > > 
+> > > ` django-admin.py </ 0> adalah script yang akan membuat direktori dan file untuk Anda. Anda sekarang harus memiliki struktur direktori yang terlihat seperti ini:</p>
+
+<pre><code>djangogirls
+├───manage.py
+└───mysite
+         settings.py
+         urls.py
+         wsgi.py
+         __init__.py
+`</pre> 
+> > > 
+> > > > ** Catatan </ 0>: dalam struktur direktori Anda, Anda juga akan melihat direktori ` venv </ 1> yang telah kita buat sebelumnya.</p>
+</blockquote>
+
+<p><code> manage.py </ 0> adalah skrip yang membantu pengelolaan situs. Dengan itu kita akan bisa (antara lain) untuk memulai web server di komputer kita tanpa menginstal apapun.</p>
+
+<p>File <code> settings.py </ 0> berisi konfigurasi situs web Anda.</p>
+
+<p>Ingat ketika kita berbicara tentang pembawa surat yang memeriksa kemana harus mengirimkan surat? <code> urls.py </ 0> berisi daftar pola yang digunakan oleh <code> urlresolver </ 0>.</p>
+
+<p>Mari kita abaikan file lainnya untuk saat ini karena kita tidak akan mengubahnya. Satu-satunya hal yang perlu diingat adalah tidak menghapusnya secara tidak sengaja!</p>
+
+<h2>Mengubah pengaturan</h2>
+
+<p>Mari buat beberapa perubahan di <code> mysite / settings.py </ 0>. Buka file dengan menggunakan editor kode yang telah Anda instal sebelumnya.</p>
+
+<p><strong> Catatan </ 0>: Perlu diingat bahwa <code> settings.py </ 1> adalah file biasa, seperti file lainnya. Anda dapat membukanya dari dalam editor kode, dengan menggunakan tindakan menu "file -> open". Ini akan memberi Anda jendela biasa tempat Anda dapat menavigasi ke file <code> settings.py </ 0> dan memilihnya. Sebagai alternatif, Anda dapat membuka file dengan menavigasi ke folder djangogirls di desktop Anda dan mengklik kanannya. Kemudian, pilih editor kode Anda dari daftar. Memilih editor penting karena Anda mungkin menginstal program lain yang bisa membuka file tapi tidak membiarkan Anda mengeditnya.</p>
+
+<p>Alangkah baiknya memiliki waktu yang tepat di situs kami. Pergi ke <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones"> daftar zona waktu Wikipedia </ 0> dan salin zona waktu yang relevan (TZ) (misalnya <code> Eropa / Berlin </ 1> ).</p>
+
+<p>Di <code> settings.py </ 0>, cari baris yang berisi <code> TIME_ZONE </ 0> dan modifikasi untuk memilih zona waktu Anda sendiri. Sebagai contoh:</p>
+
+<p>{% filename%} mysite / settings.py {% endfilename%}</p>
+
+<pre><code class="python">TIME_ZONE = 'Eropa / Berlin'
+`</pre> 
+> > > > 
+> > > > Kode bahasa terdiri dari bahasa, mis. ` en </ 0> untuk bahasa Inggris atau <code> de </ 0> untuk bahasa jerman, dan kode negara, mis. <code> de </ 0> untuk jerman atau <code> ch </ 0> untuk swiss. Anda ingin menambahkan ini jika Anda ingin tombol dan notifikasi default dari Django ada dalam bahasa Anda. Jadi Anda akan memiliki tombol "Batal" yang diterjemahkan ke bahasa yang Anda definisikan di sini. <a href="https://docs.djangoproject.com/en/1.11/ref/settings/#language-code"> Django hadir dengan banyak terjemahan yang disiapkan </ 0> .</p>
+
+<p>Ubah kode bahasa dengan mengubah baris berikut:</p>
+
+<p>{% filename%} mysite / settings.py {% endfilename%}</p>
+
+<pre><code class="python">LANGUAGE_CODE = 'de-ch'
+`</pre> 
+> > > > 
+> > > > Kita juga perlu menambahkan path untuk file statis. (Kita akan mencari tahu semua tentang file statis dan CSS nanti di tutorial.) Turun ke * akhir </ 0> dari file tersebut, dan di bawah entri ` STATIC_URL </ 1> , tambahkan sebuah yang baru disebut <code> STATIC_ROOT </ 1> :</p>
+
+<p>{% filename%} mysite / settings.py {% endfilename%}</p>
+
+<pre><code class="python">STATIC_URL = '/ static /' STATIC_ROOT = os.path.join (BASE_DIR, 'statis')
+`</pre> 
+> > > > 
+> > > > Bila ` DEBUG </ 0> adalah <code> True </ 0> dan <code> ALLOWED_HOSTS </ 0> kosong, host divalidasi terhadap <code> ['localhost', '127.0.0.1', ' [:: 1] '] </ 0> . Ini tidak akan cocok dengan nama host kami di PythonAnywhere begitu kami menerapkan aplikasi kami sehingga kami akan mengubah setelan berikut:</p>
+
+<p>{% filename%} mysite / settings.py {% endfilename%}</p>
+
+<pre><code class="python">ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+`</pre> 
+> > > > 
+> > > > > ** Catatan </ 0> : Jika Anda menggunakan Chromebook, tambahkan baris ini di bagian bawah file settings.py Anda: ` MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage' </ 1>  </p>
+  
+  <p>Also add <code>.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9</p> </blockquote> 
+> > > > > 
+> > > > > ## Buat database
+> > > > > 
+> > > > > Ada banyak perangkat lunak database yang berbeda yang dapat menyimpan data untuk situs Anda. Kita akan menggunakan yang default, ` sqlite3 </ 0> .</p>
+
+<p>Ini sudah disiapkan di bagian berkas <code> mysite / settings.py </ 0> Anda :</p>
+
+<p>{% filename%} mysite / settings.py {% endfilename%}</p>
+
+<pre><code class="python">DATABASES = {
+     'default': {
+         'ENGINE': 'django.db.backends.sqlite3',
+         'NAME': os.path.join (BASE_DIR, 'db.sqlite3'),
+     }}
+`</pre> 
+> > > > > 
+> > > > > Untuk membuat database untuk blog kita, mari kita jalankan yang berikut di konsol: ` python manage.py migrate </ 0> (kita perlu berada di direktori <code> djangogirls </ 0> yang berisi <code> manage.py </ 0> file). Jika berjalan dengan baik, Anda harus melihat sesuatu seperti ini:</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>(myvenv) ~ / djangogirls $ python manage.py migran Operasi yang harus dilakukan:
+   Terapkan semua migrasi: auth, admin, contenttypes, sessions Running migration:
+   Rendering model states ... DONE
+   Menerapkan contenttypes.0001_initial ... OK
+   Menerapkan auth.0001_initial ... OK
+   Menerapkan admin.0001_initial ... OK
+   Menerapkan admin.0002_logentry_remove_auto_add ... OK
+   Menerapkan contenttypes.0002_remove_content_type_name ... OK
+   Menerapkan auth.0002_alter_permission_name_max_length ... OK
+   Menerapkan auth.0003_alter_user_email_max_length ... OK
+   Menerapkan auth.0004_alter_user_username_opts ... OK
+   Menerapkan auth.0005_alter_user_last_login_null ... OK
+   Menerapkan auth.0006_require_contenttypes_0002 ... OK
+   Menerapkan auth.0007_alter_validators_add_error_messages ... OK
+   Menerapkan sesi.0001_initial ... baik
+`</pre> 
+> > > > > 
+> > > > > Dan kita sudah selesai! Waktunya memulai web server dan melihat apakah website kita bekerja!
+> > > > > 
+> > > > > ## Memulai server web
+> > > > > 
+> > > > > Anda harus berada di direktori yang berisi file ` manage.py </ 0> (direktori <code> djangogirls </ 0> ). Di konsol, kita bisa memulai server web dengan menjalankan <code> python manage.py runserver </ 0> :</p>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>(myvenv) ~ / djangogirls $ python manage.py runserver
+`</pre> 
+> > > > > 
+> > > > > Jika Anda menggunakan Chromebook, gunakan perintah ini sebagai gantinya:
+> > > > > 
+> > > > > {% filename %}Cloud 9{% endfilename %}
+> > > > > 
+> > > > >     (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+> > > > >     
+> > > > > 
+> > > > > Jika Anda menggunakan Windows dan ini gagal dengan ` UnicodeDecodeError </ 0> , gunakan perintah ini sebagai gantinya:</p>
+
+<p>{% filename %}command-line{% endfilename %}</p>
+
+<pre><code>(myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+`</pre> 
+> > > > > 
+> > > > > Sekarang yang perlu Anda lakukan hanyalah memeriksa apakah situs Anda berjalan. Buka browser Anda (Firefox, Chrome, Safari, Internet Explorer atau apapun yang Anda gunakan) dan masukkan alamat ini:
+> > > > > 
+> > > > > {% filename %}browser{% endfilename %}
+> > > > > 
+> > > > >     http://127.0.0.1:8000/
+> > > > >     
+> > > > > 
+> > > > > Jika menggunakan Chromebook, Anda akan selalu mengunjungi server uji dengan mengakses:
+> > > > > 
+> > > > > {% filename %}browser{% endfilename %}
+> > > > > 
+> > > > >     https://django-girls-<your cloud9 username>.c9users.io
+> > > > >     
+> > > > > 
+> > > > > Selamat! Anda baru saja membuat situs web pertama dan menjalankannya menggunakan server web! Bukankah itu mengagumkan?
+> > > > > 
+> > > > > ![Ini berhasil!](images/it_worked2.png)
+> > > > > 
+> > > > > Saat server web berjalan, Anda tidak akan melihat command-line prompt baru untuk memasukkan perintah tambahan. Terminal akan menerima teks baru tapi tidak akan menjalankan perintah baru. Ini karena server web terus berjalan untuk mendengarkan permintaan masuk .
+> > > > > 
+> > > > > > Kami meninjau bagaimana server web bekerja di ** Bagaimana Internet bekerja** bab.
+> > > > > 
+> > > > > Untuk mengetikkan perintah tambahan saat server web berjalan, buka jendela terminal baru dan aktifkan virtualenv Anda. Untuk menghentikan server web, kembali ke jendela tempat ia menjalankan dan tekan tombol CTRL + C - Control dan C bersama-sama (di Windows, Anda mungkin harus menekan Ctrl + Break).
+> > > > > 
+> > > > > Siap untuk langkah selanjutnya? Saatnya untuk membuat beberapa konten!
\ No newline at end of file
diff --git a/id/django_templates/README.md b/id/django_templates/README.md
new file mode 100644
index 00000000000..738e2632c7d
--- /dev/null
+++ b/id/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Saatnya menampilkan data! Django menyediakan fitur bawaan berupa **template tags** untuk keperluan tersebut.
+
+## Apa itu template tags?
+
+Anda lihat, di HTML, Anda tidak bisa benar-benar menulis kode Python, karena browser tidak memahaminya. Mereka hanya tahu HTML. Kita tahu bahwa HTML agak statis, sementara Python jauh lebih dinamis.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Menampilkan template post list
+
+Di pembahasan sebelumnya kita menyediakan post list ke dalam variabel `posts`.
+
+Untuk mencetak variabel ke dalam Django templates, kita menggunakan dua buah karakter kurung kurawal denga nama variable di dalamnya, seperti ini:
+
+{% filename%} blog / templates / blog / post_list.html {% endfilename%}
+
+```html
+{{posts}}
+```
+
+Terapkan ke template `blog/templates/blog/post_list.html`. Ubah semua dari `<div>` kedua sampai dengan `</div>` ketiga ganti dengan `{{ posts }}`. Simpan file, dan refresh halaman untuk melihat hasil perubahan:
+
+![Gambar 13.1](images/step1.png)
+
+Seperti yang bisa kita lihat, tercetak seperti berikut:
+
+{% filename%} blog / templates / blog / post_list.html {% endfilename%}
+
+```html
+<QuerySet [<Post: My second post> , <Post: My first post> ] & gt;
+```
+
+Yang berarti Django dapat mengenalinya sebagai list objek. Ingat pembahasan dari **Introduction to Python** bagaimana kita menampilkan list? Ya, dengan loop! Di Django template, kita menerapkannya seperti ini:
+
+{% filename%} blog / templates / blog / post_list.html {% endfilename%}
+
+```html
+{% untuk posting di posting%} 
+{{post}} {% endfor%}
+
+```
+
+Cobalah terapkan di template.
+
+![Gambar 13.2](images/step2.png)
+
+Berhasil! Tapi kami ingin posting ditampilkan seperti tulisan statis yang kami buat sebelumnya di bab ** Introduction to HTML </ 0> . Anda dapat mencampur tag HTML dan template. Kami ` tubuh </ 0> akan terlihat seperti ini:</p>
+
+<p>{% filename%} blog / templates / blog / post_list.html {% endfilename%}</p>
+
+<pre><code class="html"><div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+`</pre> 
+
+{% raw%} Semua yang Anda masukkan antara ` {% untuk%} </ 0> dan <code> {% endfor%} </ 0> akan diulang untuk setiap objek dalam daftar. Segarkan laman Anda: {% endraw%}</p>
+
+<p><img src="images/step3.png" alt="Gambar 13.3" /></p>
+
+<p>Pernahkah Anda memperhatikan bahwa kami menggunakan notasi yang sedikit berbeda kali ini ( <code> {{post.title}} </ 0> atau <code> {{post.text}} ) </ 0> ? Kami mengakses data di masing-masing bidang yang didefinisikan dalam model <code> Post </ 0> kami . Juga, <code> | linebreaksbr </ 0> sedang menyalurkan teks posting melalui filter untuk mengubah jeda baris menjadi paragraf.</p>
+
+<h2>Satu hal lagi</h2>
+
+<p>Akan lebih baik bila website Anda tetap bekerja di Internet publik kan? Ayo coba gunakan PythonAnywhere lagi. Inilah rekap langkahnya ...</p>
+
+<ul>
+<li>Pertama, dorong kode Anda ke Github</li>
+</ul>
+
+<p>{% filename%} baris perintah {% endfilename%}</p>
+
+<pre><code>$ git status
+ [...] 
+$ git add --all. $ git status
+ [...] 
+$ git commit -m "Template yang dimodifikasi untuk menampilkan posting dari database."
+[...] 
+$ git push
+`</pre> 
+
+* Kemudian, masuk kembali ke  PythonAnywhere </ 0> dan masuk ke konsol < 1> Bash </ 1> Anda (atau jalankan yang baru), dan jalankan:</li> </ul> 
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+        $ cd my-first-blog
+        $ git pull
+        [...]
+        
+    
+    * Akhirnya, naik ke tab  Web </ 0> dan tekan ** Reload </ 1> di aplikasi web Anda. Pembaruan Anda seharusnya hidup! Jika posting blog di situs PythonAnywhere Anda tidak cocok dengan posting yang muncul di blog yang dihosting di server lokal Anda, tidak masalah. Database di komputer lokal Anda dan Python Anywhere tidak sinkron dengan file Anda yang lain.</li> </ul> 
+        
+        Selamat! Sekarang lanjutkan dan coba tambahkan sebuah posting baru di admin Django Anda (ingatlah untuk menambahkan publish_date !) Pastikan Anda berada di admin Django untuk situs pythonanywhere Anda , https: // yourname. pythonanywhere .com / admin Kemudian segarkan halaman Anda untuk melihat apakah tulisan itu muncul di sana.
+        
+        Bekerja seperti pesona? Kami bangga Langkah menjauh dari komputer Anda sedikit - Anda telah mendapatkan istirahat. :)
+        
+        ![Gambar 13.4](images/donut.png)
\ No newline at end of file
diff --git a/id/django_urls/README.md b/id/django_urls/README.md
new file mode 100644
index 00000000000..abc86141b81
--- /dev/null
+++ b/id/django_urls/README.md
@@ -0,0 +1,127 @@
+# URL Django
+
+Kami akan membuat laman web pertama kami: beranda untuk blog Anda! Tapi pertama, mari pelajari sedikit tentang URL Django.
+
+## Apa itu URL?
+
+URL hanyalah sebuah alamat web. Anda dapat melihat URL setiap kali mengunjungi situs web - ini terlihat di bilah alamat browser Anda. (Iya nih! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Setiap halaman di Internet membutuhkan URLnya sendiri. Dengan cara ini aplikasi Anda tahu apa yang harus ditunjukkan kepada pengguna yang membuka URL itu. Di Django kita menggunakan sesuatu yang disebut `URLconf` (URL configuration). URLconf adalah seperangkat pola yang akan dicoba Django untuk mencocokkan dengan URL yang diminta untuk menemukan tampilan yang benar.
+
+## Bagaimana cara kerja URL di Django?
+
+Mari buka berkas ` mysite / urls.py ` di editor kode pilihan Anda dan lihat seperti apa:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"" "Konfigurasi URL mysite
+
+[...]
+"" "
+dari django.conf.urls url impor
+dari django.contrib import admin
+
+urlpatterns = [
+     url (r '^ admin /', admin.site.urls),
+]
+```
+
+Seperti yang Anda lihat, Django telah meletakkan sesuatu di sini untuk kita.
+
+Baris antara tanda kutip tiga kali (` '' '</ 0> atau <code> "" "</ 0>) disebut docstrings - Anda dapat menuliskannya di bagian atas file, kelas atau metode untuk menjelaskan apa yang dilakukannya. Mereka tidak akan dijalankan oleh Python.</p>
+
+<p>URL admin, yang Anda kunjungi di bab sebelumnya, sudah ada di sini:</p>
+
+<p>{% filename%} mysite / urls.py {% endfilename%}</p>
+
+<pre><code class="python">    url(r'^admin/', admin.site.urls),
+`</pre> 
+
+Baris ini berarti bahwa untuk setiap URL yang dimulai dengan ` admin / </ 0>, Django akan menemukan tampilan <em> yang sesuai </ 1>. Dalam hal ini kami menyertakan banyak URL admin sehingga tidak semua dikemas ke dalam file kecil ini - ini lebih mudah dibaca dan bersih.</p>
+
+<h2>Regex</h2>
+
+<p>Apakah Anda bertanya-tanya bagaimana Django mencocokkan URL dengan tampilan? Nah, bagian ini memang rumit. Django menggunakan <code> regex </ 0>, singkatan dari "regular expressions". Regex memiliki banyak (banyak!) Aturan yang membentuk pola pencarian. Karena regex adalah topik lanjutan, kami tidak akan membahas secara terperinci bagaimana mereka bekerja.</p>
+
+<p>Jika Anda masih ingin memahami bagaimana kami menciptakan pola, berikut adalah contoh prosesnya - kami hanya memerlukan subset terbatas peraturan untuk mengungkapkan pola yang kami cari, yaitu:</p>
+
+<ul>
+<li><code>^` untuk awal teks</li> 
+
+* `$`untuk akhir teks
+* `\d` untuk satu digit
+* `+` untuk menunjukkan bahwa item sebelumnya harus diulang setidaknya satu kali
+* `()` untuk menangkap sebagian dari pola</ul> 
+
+Ada lagi definisi URL yang akan diambil secara harfiah.
+
+Sekarang bayangkan Anda memiliki situs web dengan alamat seperti `http://www.mysite.com/post/12345/`, where `12345` adalah jumlah posting Anda.
+
+Menulis pandangan terpisah untuk semua nomor posting akan sangat menyebalkan. Dengan ekspresi reguler, kami dapat membuat pola yang sesuai dengan URL dan mengekstrak nomor untuk kami: `^post/(\d+)/$`. Mari kita turunkan sepotong demi sepotong untuk melihat apa yang sedang kita lakukan di sini:
+
+* **^post/** memberitahu Django untuk mengambil apapun yang dimilikinya `post/` di awal url (right after `^`)
+* **(\d+)** berarti akan ada angka (satu atau lebih digit) dan kami ingin nomor yang diambil dan diekstraksi
+* **/** memberitahu Django bahwa karakter `/` yang lain harus diikuti
+* **$** kemudian menunjukkan akhir dari URL yang berarti bahwa hanya string yang diakhiri dengan `/` akan cocok dengan pola ini
+
+## URL Django pertama Anda!
+
+Waktunya membuat URL pertama kami! Kami ingin 'http://127.0.0.1:8000/' menjadi halaman awal blog kami dan untuk menampilkan daftar posting.
+
+Kami juga ingin menyimpan berkas `mysite/urls.py` tetap bersih, jadi kami akan mengimpor URL dari aplikasi `blog`ke`mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Anda ` mysite / urls.py </ 0> File sekarang harus terlihat seperti ini:</p>
+
+<p>{% filename%} mysite / urls.py {% endfilename%}</p>
+
+<pre><code class="python">from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+`</pre> 
+
+Django sekarang akan mengarahkan semua yang masuk ke 'http://127.0.0.1:8000/' ke ` blog.urls </ 0> dan mencari petunjuk lebih lanjut di sana.</p>
+
+<p>Menulis ekspresi reguler dengan Python selalu dilakukan dengan <code> r </ 0> di depan string. Ini adalah petunjuk yang berguna untuk Python bahwa string mungkin berisi karakter khusus yang tidak dimaksudkan untuk Python itu sendiri, namun untuk ekspresi reguler.</p>
+
+<h2>blog.urls</h2>
+
+<p>Buat file kosong baru bernama <code> urls.py </ 0> di direktori <code> blog </ 0> . Baiklah! Tambahkan dua baris pertama ini:</p>
+
+<p>{% filename%} blog / urls.py {% endfilename%}</p>
+
+<pre><code class="python">dari django.conf.urls url impor dari. tampilan impor
+`</pre> 
+
+Di sini kita mengimpor fungsi Django ` url </ 0> dan semua <code> views </ 0> dari aplikasi <code> blog </ 0> . (Kami belum memilikinya, tapi kami akan segera melakukannya!)</p>
+
+<p>Setelah itu, kami dapat menambahkan pola URL pertama kami:</p>
+
+<p>{% filename%} blog / urls.py {% endfilename%}</p>
+
+<pre><code class="python">urlpatterns = [
+     url (r '^ $', views.post_list, name = 'post_list'),]
+`</pre> 
+
+Seperti yang Anda lihat, sekarang kami menetapkan sebuah  view </ 0> yang disebut <code> post_list </ 0> ke <code> ^ $ </ 0> URL. Ekspresi reguler ini akan cocok dengan <code> ^ </ 0> (awal) diikuti oleh <code> $ </ 0> (akhir) - jadi hanya string kosong yang akan cocok. Itu benar, karena di Django URL resolvers, 'http://127.0.0.1:8000/' bukan bagian dari URL. Pola ini akan memberi tahu Django bahwa <code> views.post_list </ 0> adalah tempat yang tepat untuk dikunjungi jika seseorang masuk ke situs Anda di alamat 'http://127.0.0.1:8000/'.</p>
+
+<p>Bagian terakhir, <code> name = 'post_list' </ 0> , adalah nama URL yang akan digunakan untuk mengidentifikasi tampilan. Ini bisa sama dengan nama tampilan tapi bisa juga sama sekali berbeda. Kami akan menggunakan URL yang disebutkan kemudian di proyek, jadi penting untuk memberi nama setiap URL di aplikasi. Kita juga harus berusaha agar nama URL tetap unik dan mudah diingat.</p>
+
+<p>Jika Anda mencoba mengunjungi http://127.0.0.1:8000/ sekarang, Anda akan menemukan pesan 'halaman web tidak tersedia'. Ini karena server (ingat mengetik <code> runserver </ 0> ?) Tidak lagi berjalan. Lihatlah jendela konsol server Anda untuk mencari tahu mengapa.</p>
+
+<p><img src="images/error1.png" alt="Kesalahan" /></p>
+
+<p>Konsol Anda menunjukkan kesalahan, tapi jangan khawatir - itu sebenarnya cukup berguna: Ini memberitahu Anda bahwa ada <strong> tidak ada atribut 'post_list' </ 0> . Itulah nama <em> pandangan </ 0> yang Django sedang mencoba untuk menemukan dan menggunakan, tapi kami belum menciptakannya belum. Pada tahap ini <code> / admin / </ 0> Anda juga tidak akan bekerja. Jangan khawatir - kita akan sampai di sana.</p>
+
+<blockquote>
+  <p>Jika Anda ingin tahu lebih banyak tentang Django URLconfs, lihat dokumentasi resmi: https://docs.djangoproject.com/en/1.11/topics/http/urls/</p>
+</blockquote>
\ No newline at end of file
diff --git a/id/django_views/README.md b/id/django_views/README.md
new file mode 100644
index 00000000000..96718bfc673
--- /dev/null
+++ b/id/django_views/README.md
@@ -0,0 +1,42 @@
+# Tampilan Django - waktu untuk membuat!
+
+Waktunya menyingkirkan bug yang kita buat di bab terakhir! :)
+
+A * view </ 0> adalah tempat kita meletakkan "logika" aplikasi kita. Ini akan meminta informasi dari ` Model </ 0> Anda buat sebelumnya dan menyebarkannya ke <code> Template </ 0> . Kami akan membuat template di bab berikutnya. View hanyalah berupa fungsi Python tetapi lebih kompleks dibandingkan dengan yang telah kita buat pada bab <strong>Pengenalan Pada Python</strong>.</p>
+
+<p>Penayangan ditempatkan di file <code> views.py </ 0> . Kami akan menambahkan <em> tampilan </ 1> ke file <code> blog / views.py </ 0> .</p>
+
+<h2>blog / views.py</h2>
+
+<p>Baiklah, mari kita buka file ini dan lihat apa yang ada di dalamnya:</p>
+
+<p>{% filename%} blog / views.py {% endfilename%}</p>
+
+<pre><code class="python">from django.shortcuts import render
+
+# Create your views here.
+`</pre> 
+
+Belum banyak perintah di sini.
+
+Ingat bahwa baris yang dimulai dengan ` # </ 0> adalah komentar - ini berarti bahwa baris tersebut tidak akan dijalankan oleh Python.</p>
+
+<p>Mari buat <em> lihat </ 0> seperti yang disarankan oleh komentar. Tambahkan tampilan minimal berikut di bawah ini:</p>
+
+<p>{% filename%} blog / views.py {% endfilename%}</p>
+
+<pre><code class="python">def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+`</pre> 
+
+Sebagaimana dapat anda lihat, kita membuat sebuah fungsi (`def`) namanya `post_list` yang melakukan `request` dan `me-return` sebuah fungsi `render` yang akan melakukan render (menggabungkan) template `blog/post_list.html` kita.
+
+Simpan filenya, pergi ke http://127.0.0.1:8000/ dan lihat apa yang kita punya.
+
+Kesalahan lain Baca apa yang terjadi sekarang:
+
+![Kesalahan](images/error.png)
+
+Ini memperlihatkan bahwa server berjalan lagi, paling tidak, tapi masih kelihatan belum betul, betul? Jangan khawatir, itu hanyalah halaman error, tak ada yang perlu ditakutkan! Sama seperti pesan error di dalam konsol, hal tersebut sangat berguna. Anda dapat membaca *TemplateDoesNotExist*. Mari perbaiki bug ini dan membuat sebuah template pada bab berikutnya!
+
+> Pelajari lebih lanjut tentang view Django dengan membaca dokumentasi resmi: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/id/dynamic_data_in_templates/README.md b/id/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..7868f43c28f
--- /dev/null
+++ b/id/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Template Daftar Data Dinamis
+
+Kami memiliki beberapa bagian yang berbeda: model ` Post ` didefinisikan pada ` models.py `, kami memiliki ` post_list ` di ` views.py ` dan template ditambahkan. Tapi bagaimana kita benar-benar membuat posting Anda muncul di template HTML Anda? Karena itulah yang ingin kita lakukan - ambil beberapa konten (model yang tersimpan di database) dan tampilkan dengan baik di template kita kan?
+
+Inilah yang seharusnya dilihat * dilihat *: hubungkan model dan template. Pada ` post_list ` * tampilan * kita perlu mengambil model yang ingin kita tampilkan dan menyebarkannya ke template. Pada tampilan * * kita menentukan apa (model) yang akan ditampilkan di template.
+
+Baiklah, jadi bagaimana kita bisa mencapai ini?
+
+Kita perlu membuka ` blog / views.py ` kita. Sejauh ` post_list ` * lihat * terlihat seperti ini:
+
+{% filename %}blog/static/css/views.py{% endfilename %}
+
+```python
+dari django.shortcuts import render
+
+def post_list (permintaan):
+     mengembalikan render (permintaan, 'blog / post_list.html', {})
+```
+
+Ingat ketika kita berbicara tentang termasuk kode yang ditulis dalam file yang berbeda?   Konteks | Permintaan Konteks? Sekarang adalah saat ketika kita harus menyertakan model yang telah kita tulis di ` models.py `.   Konteks | Permintaan Konteks. Kami akan menambahkan baris ` dari .Models import Post ` seperti ini:
+
+{% filename %}blog/static/css/views.py{% endfilename %}
+
+```python
+pythonfrom django.shortcuts import admin
+from .models import P
+```
+
+Titik sebelum ` model ` berarti * direktori saat ini * atau * aplikasi saat ini *. Kedua ` views.py ` dan ` models.py ` ada di direktori yang sama. Ini berarti kita bisa menggunakan `. ` dan nama file (tanpa `.py `). Kemudian kita mengimpor nama modelnya (` Post `).
+
+Tapi apa selanjutnya? Untuk mengambil postingan blog yang sebenarnya dari model ` Post ` kita memerlukan sesuatu yang disebut ` QuerySet `.
+
+## QuerySet
+
+Anda seharusnya sudah terbiasa dengan bagaimana QuerySets bekerja. Kami membicarakannya di [ bagian Django ORM (Query Sets) ](../django_orm/README.md).
+
+Jadi sekarang kita ingin posting blog yang dipublikasikan diurutkan menurut ` published_date `, kan? Kami sudah melakukannya di bab QuerySets!
+
+{% filename %}blog/static/css/views.py{% endfilename %}
+
+```python
+& gt; & gt; & gt; Post.objects.filter (published_date__lte = timezone.now ()) order_by ('published_date')
+```
+
+Sekarang kita letakkan potongan kode ini di dalam file ` blog / views.py ` dengan menambahkannya ke fungsi ` def post_list (request) `, tapi jangan lupa tambahkan dulu ` dari zona waktu impor django.utils `:
+
+{% filename %}blog/static/css/views.py{% endfilename %}
+
+```python
+dari django.shortcuts import render
+dari zona waktu impor django.utils
+dari .Model impor Post
+
+def post_list(permintaan):
+     posting = Post.objects.filter (published_date__lte = timezone.now ()) order_by ('published_date')
+     mengembalikan render (permintaan, 'blog / post_list.html', {})
+```
+
+Bagian terakhir yang hilang adalah melewati ` posts ` QuerySet ke konteks template. Jangan khawatir - kami akan membahas bagaimana menampilkannya di bab berikutnya.
+
+Perlu diketahui bahwa kami membuat variabel * * untuk QuerySet kami: ` posts `. Perlakukan ini sebagai nama QuerySet kami. Mulai sekarang kita bisa merujuknya dengan nama ini.
+
+Pada fungsi ` render ` kita memiliki satu parameter ` request ` (semua yang kita terima dari pengguna melalui Internet) dan yang lain memberi file template (` 'blog / post_list.html '`). Parameter terakhir, ` {} `, adalah tempat di mana kita dapat menambahkan beberapa hal untuk template yang akan digunakan. Kita perlu memberi mereka nama (kita akan tetap berpegang pada ` 'posts' ` sekarang). :) Seharusnya terlihat seperti ini: ` {'posts': posts} `. Harap dicatat bahwa bagian sebelum `: ` adalah string; Anda perlu membungkusnya dengan tanda petik: ` '' `.
+
+Jadi akhirnya file `blog/views.py` kita akan terlihat seperti ini:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+dari django.shortcuts import render
+dari zona waktu impor django.utils
+dari .Model impor Post
+
+def post_list (permintaan):
+     posting = Post.objects.filter (published_date__lte = timezone.now ()) order_by ('published_date')
+     mengembalikan render (permintaan, 'blog / post_list.html', {'posts': posts})
+```
+
+Itu dia! Waktunya kembali ke template kita dan menampilkan QuerySet ini!
+
+Ingin membaca sedikit lebih banyak tentang QuerySets di Django? Anda harus melihat di sini: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/id/extend_your_application/README.md b/id/extend_your_application/README.md
new file mode 100644
index 00000000000..331a8fedfbd
--- /dev/null
+++ b/id/extend_your_application/README.md
@@ -0,0 +1,179 @@
+# Perluas aplikasi Anda
+
+Kami telah menyelesaikan semua langkah berbeda yang diperlukan untuk pembuatan situs web kami: kami tahu cara menulis model, url, tampilan dan template. Kita juga tahu bagaimana membuat website kita cantik.
+
+Waktunya berlatih!
+
+Hal pertama yang kita butuhkan di blog kita adalah, jelas, halaman untuk menampilkan satu posting, bukan?
+
+Kita sudah memiliki model ` Post </ 0> , jadi kita tidak perlu menambahkan apapun ke <code> models.py </ 0> .</p>
+
+<h2>Buat link template ke detail posting</h2>
+
+<p>Kita akan mulai dengan menambahkan link di dalam file <code> blog / template / blog / post_list.html </ 0> . Sejauh ini seharusnya terlihat seperti ini:
+ {% filename%} blog / templates / blog / post_list.html {% endfilename%}</p>
+
+<pre><code class="html">{% meluas 'blog/base.html' %}{% block content %} {% for post in posts %} <div class="post"><div class="date">{{ post.published_date }}</div> <h1><a href="">{{ post.title }}</a></h1> <p>{{ post.text|linebreaksbr }}</p></div> {% endfor %}{% endblock %}
+`</pre> 
+
+{% raw %}Kami ingin memiliki tautan dari judul posting di daftar pos ke halaman detail post. Mari kita ubah `<h1><a href="">{{ post.title }}</a></h1>` sehingga link ke halaman detail posting:{% endraw %}
+
+{% filename %}blog / template/ blog/post_list.html {% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %} saatnya untuk menjelaskan misterius `{% url 'post_detail' pk =post.pk%}`. Seperti yang Anda duga, notasi ` {% %}` berarti kita menggunakan tag template Django. Kali ini kita akan menggunakan satu yang akan membuat URL untuk Kita!{% endraw %}
+
+Bagian `detail_post` berarti Django akan mengharapkan URL di `blog /urls.py` dengan nama = detail_post
+
+Dan bagaimana dengan `pk=post.pk`? `pk` adalah singkatan dari primary key, yang merupakan nama unik untuk setiap record dalam database. Karena kita tidak menetapkan primary key dalam model `posting` kami, Django menciptakan satu untuk kita (secara default, nomor yang meningkat oleh satu untuk masing-masing rekaman, yaitu 1, 2, 3) dan menambah itu sebagai sebuah bidang yang bernama `pk` masing-masing posting kami. Kita mengakses primary key dengan menulis `post.pk`, dengan cara yang sama kita mengakses bidang lain (`judul`, `penulis`, dll) di objek `posting` kami!
+
+Sekarang ketika kita pergi ke http://127.0.0.1:8000 / kita akan memiliki kesalahan (seperti yang diharapkan, karena kita belum memiliki URL atau *pemandangan* untuk `post_detail`). Ini akan terlihat seperti ini:
+
+![Kesalahan NoReverseMatch](images/no_reverse_match2.png)
+
+## Membuat URL posting detail
+
+Mari kita membuat URL di `urls.py` untuk `post_detail` kita *Lihat*!
+
+Kami ingin posting pertama kami detail untuk ditampilkan di **URL**: http://127.0.0.1:8000/post/1 /
+
+Mari kita membuat URL dalam `blog/urls.py` file untuk Django titik *pemandangan* bernama `post_detail`, yang akan menunjukkan seluruh blog posting. Tambahkan baris `url (r'^ posting / (? P <pk>\d+)/$', views.post_detail, nama = 'post_detail'),` ke `blog/urls.py` file. File Anda seharusnya terlihat seperti ini:
+
+{% filename %}blog/static/css/urls.py{% endfilename %}
+
+```python
+dari django.conf.urls impor url dari. Impor dilihat urlpatterns = [url (r'^ $', views.post_list, nama = 'post_list'), url (r'^ posting / (? P <pk>\d+)/$', views.post_detail, nama = 'post_detail'),]
+```
+
+Bagian ini `^ posting / (? P <pk>\d+)/$` terlihat menakutkan, tetapi jangan khawatir-kami akan menjelaskan hal itu untuk Anda:
+
+- dimulai dengan `^ ^` lagi-"awal".
+- `posting /` hanya berarti bahwa setelah awal, URL harus berisi kata **posting** dan **/**. Sejauh ini baik-baik saja.
+- `(?. P <pk>\d+)` – ini rumit. Itu berarti bahwa Django akan mengambil segala sesuatu yang Anda tempat di sini dan transfer ke pemandangan sebagai variabel disebut `pk`. (Catatan bahwa ini sesuai dengan nama yang kami berikan utama kunci variabel kembali di `blog/templates/blog/post_list.html`!) `\d` juga memberitahu kita bahwa itu hanya dapat digit, bukan surat (sehingga semuanya antara 0 hingga 9). `+` berarti bahwa ada kebutuhan untuk satu atau lebih angka tidak. Jadi sesuatu seperti `http://127.0.0.1:8000/post / /` tidak sah, tetapi `http://127.0.0.1:8000/post/1234567890/` ini sangat OK!
+- `/`- maka kita perlu **/** lagi.
+- `$` – "akhir"!
+
+Itu berarti jika Anda memasukkan ` http://127.0.0.1:8000/post/5/ ` ke browser Anda, Django akan mengerti bahwa Anda mencari *Tampilan* yang disebut `detil_post` dan transfer informasi `pk ` sama dengan `5` ke *tampilan*.
+
+Ok, kami sudah menambahkan pola URL baru ke `blog/url.py`! Mari segarkan halaman: http://127.0.0.1:80000/ Boom! Server berhenti berjalan lagi. Lihat konsol - seperti yang diharapkan, ada lagi kesalahan lain!
+
+![Atribut rusak](images/attribute_error2.png)
+
+Anda ingat apakah langkah selanjutnya? Tentu: Menambah tampilan!
+
+## Add a post's detail view
+
+Kali ini *view* diberikan parameter tambahan, `pk`. *view* kita perlu menangkapnya, bukan? Jadi kita akan mendefinisikan fungsi kita sebagai `def post_detail(request, pk):`. Perhatikan bahwa kita perlu menggunakan nama yang sama persis dengan yang kita tentukan dalam url (`pk`). Menghilangkan variabel ini tidak benar dan akan mengakibatkan kesalahan!
+
+Sekarang, kita ingin mendapatkan satu dan hanya satu posting blog. Untuk melakukan ini, kita bisa menggunakan querysets, seperti ini:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Tapi kode ini bermasalah. Jika tidak ada `Posting`dengan kunci utama` ` (`pk`), kita akan memiliki kesalahan yang sangat jelek!
+
+![Kesalahan DoesNotExist](images/does_not_exist2.png)
+
+Kami tidak menginginkan itu! Tapi, tentu saja, Django hadir dengan sesuatu yang akan menangani hal itu untuk kita: `get_object_or_404`. Jika tidak ada `Posting`dengan`pk` yang diberikan, halaman itu akan menampilkan halaman yang jauh lebih bagus, halaman `Halaman Tidak Ditemukan 404`.
+
+![Halaman tidak ditemukan](images/404_2.png)
+
+Kabar baiknya adalah Anda benar-benar dapat membuat laman `Halaman tidak ditemukan`dan membuatnya sama cantiknya dengan yang Anda inginkan. Tapi itu tidak terlalu penting saat ini, jadi kita akan melewatinya.
+
+OK, saatnya menambahkan *view* untuk kami `views.py` file!
+
+Di `blog/urls.py` kami membuat aturan URL bernama `post_detail` yang mengacu pada tampilan yang disebut `views.post_detail`. Ini berarti bahwa Django akan mengharapkan fungsi tampilan yang disebut `post_detail` di dalam `blog/views.py`.
+
+Kita harus membuka `blog/views.py` dan menambahkan kode berikut di dekat baris `dari` lainnya:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+dari django.shortcuts import render, get_object_or_404
+```
+
+Dan di akhir file kita akan menambahkan kita *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Tampilan daftar pos](images/post_list2.png)
+
+Ini berhasil! Tapi apa jadinya bila anda mengklik link di judul posting blog?
+
+![TemplateDoesNotExist kesalahan](images/template_does_not_exist2.png)
+
+Oh tidak! Kesalahan lain Tapi kita sudah tahu bagaimana mengatasinya, kan? Kita perlu menambahkan template!
+
+## Buat template untuk detail posting
+
+Kami akan membuat file di `blog/template/blog` yang disebut `post_detail.html`.
+
+Ini akan terlihat seperti ini:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Sekali lagi kita memperluas `base.html`. Di blok `konten` kami ingin menampilkan publikasi post_date (jika ada), judul dan teks. Tapi kita harus membahas beberapa hal penting, bukan?
+
+{% raw %}`{% if ... %} ... {% endif %}` adalah tag templat yang dapat kami gunakan saat kami ingin memeriksa sesuatu. (Ingat `jika ... lain ..`dari**Pengenalan bab Python**?) Dalam skenario ini, kami ingin memeriksa apakah `published_date` tidak kosong.{% endraw %}
+
+Oke, kita bisa me-refresh halaman kita dan melihat apakah `TemplateDoesNotExist` hilang sekarang.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! Berhasil!
+
+## Satu hal lagi: saatnya melakukan deploy!
+
+Akan lebih baik jika situs Anda tetap bekerja di PythonAnywhere, bukan? Mari coba penggelaran lagi.
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Kemudian dalam konsol Bash [PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Yang terakhir, cari [Web tab](https://www.pythonanywhere.com/web_app_setup/) dan klik **Reload**.
+
+Dan seharusnya dapa berjalan! Selamat :)
\ No newline at end of file
diff --git a/id/how_the_internet_works/README.md b/id/how_the_internet_works/README.md
new file mode 100644
index 00000000000..5c3467054f5
--- /dev/null
+++ b/id/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Bagaimana Internet Bekerja
+
+> Bagi pembaca di rumah: bab ini tercakup dalam video [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> Bab ini terinspirasi oleh pembicaraan "Bagaimana Internet bekerja" oleh Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+Kami yakin Anda menggunakan internet setiap hari. Tapi apakah Anda benar-benar tahu apa yang terjadi saat Anda mengetikkan alamat seperti https://djangogirls.org ke browser Anda dan tekan `enter`?
+
+Hal pertama yang perlu Anda pahami adalah bahwa sebuah situs web hanyalah sekumpulan file yang tersimpan di hard disk. Sama seperti film, musik, atau gambar Anda. Namun, ada satu bagian yang unik untuk situs web: termasuk kode komputer yang disebut HTML.
+
+Jika Anda tidak terbiasa dengan pemrograman, akan sulit untuk memahami HTML pada awalnya, namun browser web Anda (seperti Chrome, Safari, Firefox, dll.) Menyukainya. Browser web dirancang untuk memahami kode ini, ikuti instruksinya, dan tunjukkan file-file ini yang dibuat oleh situs web Anda, persis seperti yang Anda inginkan.
+
+Seperti pada setiap file, kita perlu menyimpan file HTML di suatu tempat pada hard disk. Untuk internet, kami menggunakan khusus, kuat komputer disebut *server*. Mereka tidak memiliki layar, mouse atau keyboard, karena mereka tujuan utama adalah untuk menyimpan data dan melayani. Itu sebabnya mereka disebut *server* - karena mereka *melayani* data Anda.
+
+OK, tapi Anda ingin tahu bagaimana internet terlihat, kan?
+
+Kami menggambarmu! Sepertinya ini:
+
+![Gambar 1.1](images/internet_1.png)
+
+Sepertinya berantakan, kan? Bahkan itu adalah jaringan mesin yang terhubung (yang disebutkan di atas * server </ 0> ). Ratusan ribu mesin! Banyak, banyak kilometer dari kabel di seluruh dunia! Anda dapat mengunjungi kabel bawah laut peta situs web (http://submarinecablemap.com) untuk melihat bagaimana rumit net. Berikut adalah screenshot dari website:</p> 
+
+![Gambar 1.2](images/internet_3.png)
+
+Hal ini menarik, bukan? Tapi jelas, tidak mungkin untuk memiliki kawat antara setiap mesin terhubung ke internet. Jadi, untuk mencapai mesin (misalnya, satu di mana https://djangogirls.org disimpan) kita perlu lulus permintaan melalui banyak, banyak mesin yang berbeda.
+
+Itu tampak seperti ini:
+
+![Gambar 1.3](images/internet_2.png)
+
+Bayangkan bahwa ketika Anda mengetik https://djangogirls.org, Anda mengirim surat yang berbunyi: "Dear Django Girls, saya ingin melihat situs djangogirls.org, kirimkan kepada saya, please!"
+
+Surat Anda ke kantor pos terdekat dengan Anda. Kemudian pergi ke yang lain yang sedikit lebih dekat ke penerima Anda, lalu ke yang lain, dan yang lainnya sampai dikirim ke tempat tujuannya. Satu-satunya hal yang unik adalah jika Anda mengirim banyak surat ( * paket data * ) ke tempat yang sama, mereka bisa melalui kantor pos yang sama sekali berbeda ( * router * ). Hal ini tergantung bagaimana mereka didistribusikan di setiap kantor.
+
+![Gambar 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Alih-alih alamat dengan nama jalan, kota, kode pos dan nama negara, kita menggunakan alamat IP. Komputer Anda pertama kali meminta DNS (Domain Name System) untuk menerjemahkan djangogirls.org ke alamat IP. Ini bekerja sedikit seperti buku telepon kuno di mana Anda dapat mencari nama orang yang ingin Anda hubungi dan menemukan nomor telepon dan alamat mereka.
+
+Bila Anda mengirim surat, perlu ada fitur tertentu yang bisa disampaikan dengan benar: alamat, stempel, dll. Anda juga menggunakan bahasa yang dipahami oleh penerima, bukan? Hal yang sama berlaku untuk paket data * * yang Anda kirim untuk melihat situs web. Kami menggunakan protokol yang disebut HTTP (Hypertext Transfer Protocol).
+
+Jadi, pada dasarnya, jika Anda memiliki situs web, Anda harus memiliki *server* (mesin) tempat tinggalnya. Ketika * server * menerima permintaan * masuk * (dalam sebuah surat), ia akan mengirimkan kembali situs Anda (dalam surat lain).
+
+Karena ini adalah tutorial Django, Anda mungkin bertanya apa yang Django lakukan. Bila Anda mengirim tanggapan, Anda tidak selalu ingin mengirimkan hal yang sama kepada semua orang. Jauh lebih baik jika surat Anda dipersonalisasi, terutama untuk orang yang baru saja menulis surat kepada Anda, bukan? Django membantu Anda membuat surat yang dipersonalisasi dan menarik ini. :)
+
+Cukup waktu bicara untuk menciptakan!
\ No newline at end of file
diff --git a/id/html/README.md b/id/html/README.md
new file mode 100644
index 00000000000..30165a32459
--- /dev/null
+++ b/id/html/README.md
@@ -0,0 +1,210 @@
+# Pengantar ke HTML
+
+Apa itu template, mungkin kamu bertanya?
+
+Template adalah file yang dapat kita gunakan kembali untuk menyajikan informasi yang berbeda dalam format yang konsisten - misalnya, Anda dapat menggunakan template untuk membantu menulis surat, karena walaupun setiap huruf mungkin berisi pesan berbeda dan ditujukan kepada yang lain. orang, mereka akan berbagi format yang sama.
+
+Format template-template Django dijelaskan dalam bahasa yang disebut HTML (itulah HTML yang kami sebutkan di bab pertama, ** Bagaimana Internet bekerja </ 0>).</p> 
+
+## HTML adalah?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML singkatan dari "HyperText Markup bahasa". ** HyperText </ 0> berarti itu adalah jenis teks yang mendukung sebuah link antar halaman. < Markup </ 0> berarti kita telah mengambil sebuah dokumen dan menandai dengan kode untuk mengatakan sesuatu (dalam hal ini, browser internet) bagaimana menafsirkan halaman. Kode HTML dibangun oleh ** tag </ 0>, masing-masing dimulai dengan ` & lt; </ 1> dan diakhiri dengan <code> & gt; </ 1>. Tag ini mewakili markup <strong> elemen </ 0> .</p>
+
+<h2>Template pertama kamu!</h2>
+
+<p>Membuat template berarti membuat file template. Semuanya adalah sebuah file, bukan? Anda mungkin sudah menyadari hal ini.</p>
+
+<p>Template tersimpan di direktori <code> blog / template / blog </ 0>. Jadi pertama menciptakan sebuah direktori yang disebut <code>template` di dalam direktori blog Anda. Kemudian dibuat direktori lain yang disebut `blog` di dalam direktori template Anda:</p> 
+
+    blog 
+    └───templates
+     └───blog
+    
+
+(Anda mungkin bertanya-tanya mengapa kita perlu dua direktori kedua disebut `blog`-seperti yang Anda akan menemukan nanti, ini adalah cukup berguna konvensi penamaan yang membuat hidup lebih mudah ketika keadaan mulai menjadi lebih rumit.)
+
+Dan sekarang membuat `post_list.html` file (Biarkan kosong untuk sekarang) didalam direktori `blog/template/blog`.
+
+Lihatlah bagaimana situs web terlihat sekarang: http://127.0.0.1:8000 /
+
+> Jika Anda masih memiliki kesalahan `TemplateDoesNotExist`, mencoba untuk me-ulang server Anda. Pergi ke baris perintah, menghentikan server dengan menekan Ctrl + C (kontrol dan C kunci bersama-sama) dan mulai lagi dengan menjalankan perintah `python manage.py runserver`.
+
+![Gambar 11.1](images/step1.png)
+
+Tidak ada kesalahan lagi! Selamat :) Namun, situs Anda sebenarnya tidak menerbitkan apapun kecuali halaman kosong, karena template Anda juga kosong. Kita perlu memperbaikinya.
+
+Tambahkan yang berikut ke file template Anda:
+
+{% filename %}blog/static/css/list.html{% endfilename %}
+
+```html
+<html><p>Hi sana!</p>     <p>Kerjanya!</p> </html>
+```
+
+Jadi bagaimana Apakah situs web Anda terlihat sekarang? Mengunjunginya untuk mengetahui: http://127.0.0.1:8000 /
+
+![Gambar 11.2](images/step3.png)
+
+Itu berhasil! Nice bekerja di sana :)
+
+* Tag paling dasar, `<html>`, selalu adalah awal dari setiap halaman web dan `</html>` selalu akhir. Seperti yang Anda lihat, seluruh isi website terjadi antara awal tag `<html>`dan tag penutup `</html>`
+* `<p>`adalah suatu tag untuk elemen ayat; `</p>` menutup setiap ayat
+
+## Kepala dan tubuh
+
+Setiap halaman HTML juga dibagi menjadi dua elemen: **kepala** dan **tubuh**.
+
+* **kepala** merupakan elemen yang berisi informasi tentang dokumen yang tidak ditampilkan di layar.
+
+* **tubuh** merupakan unsur yang berisi segala sesuatu yang lain yang ditampilkan sebagai bagian dari halaman web.
+
+Kami menggunakan `<head>` untuk memberi tahu browser tentang konfigurasi halaman, dan `<body>` untuk memberitahukannya tentang apa yang sebenarnya ada di halaman.
+
+Misalnya, Anda bisa memasukkan elemen judul halaman web ke dalam `<head>`, seperti ini:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Simpan dan refresh halaman Anda.
+
+![Gambar 11.3](images/step4.png)
+
+Perhatikan bagaimana browser telah dipahami bahwa "Ola's blog" adalah judul halaman Anda? Ini telah ditafsirkan `<title>Ola's blog</title>` dan ditempatkan teks di bar judul browser Anda (ini juga akan digunakan untuk bookmark dan seterusnya).
+
+Mungkin Anda juga memperhatikan bahwa setiap tag pembuka cocok dengan tag penutup * *, dengan ` / `, dan elemen itu * nested * (yaitu Anda dapat Tutup tag tertentu sampai semua yang ada di dalamnya sudah ditutup juga).
+
+Ini seperti memasukkan barang ke dalam kotak. Anda memiliki satu kotak besar, `<html> </html>`; Di dalamnya ada `<body> </body>`, dan itu berisi kotak yang masih lebih kecil: `<p> </p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Sesuaikan template Anda
+
+Anda sekarang bisa bersenang-senang dan mencoba menyesuaikan template Anda! Berikut adalah beberapa tag yang berguna untuk itu:
+
+* `<h1> Judul </h1>` untuk pos terpenting Anda
+* `<h2> Sub-judul </h2>` untuk judul di tingkat berikutnya
+* `<h3>Sub-sub-judul</h3>` ... dan seterusnya, sampai `<h6>`
+* `<p>Sebuah paragraf teks </p>`
+* `<em> teks</em>` menekankan teks Anda
+* `<strong>teks</strong>` sangat menekankan teks Anda
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` membuat sebuah link
+* `<ul> <li> item pertama </li> <li> item kedua </li> </ul>` membuat daftar, sama seperti yang ini!
+* `<div></div>` mendefinisikan bagian dari halaman
+
+Berikut adalah contoh template lengkap, copy dan paste ke `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Anak rok televisi sepak bola dan gas beracun. Donec id elit non mi porta gravida di eget Metus Sed congue. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Anak rok televisi sepak bola dan gas beracun. Donec id elit non mi porta gravida di eget Metus Sed congue. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+Ini memberi kita efek ini:
+
+![Gambar 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+Apa yang sebenarnya ingin kita lakukan adalah menampilkan posting nyata yang ditambahkan di admin Django kita - dan ke sanalah kita akan pergi berikutnya.
+
+## Satu hal lagi: menyebarkan!
+
+Alangkah baiknya melihat semua ini dan tinggal di Internet kan? Mari kita lakukan PythonAnywhere lainnya :
+
+### Komit, dan dorong kode Anda ke Github
+
+Pertama, mari kita lihat file apa yang telah berubah sejak terakhir kita digunakan (jalankan perintah ini secara lokal, bukan di PythonAnywhere ):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Kita sudah hampir sampai, sekarang saatnya untuk menceritakannya untuk menyimpan perubahan ini dalam sejarahnya. Kami akan memberikan "pesan komit" di mana kami menggambarkan apa yang telah kami ubah. Anda dapat mengetikkan apa pun yang Anda inginkan pada tahap ini, namun sangat membantu untuk mengetikkan sesuatu yang deskriptif sehingga Anda dapat mengingat apa yang telah Anda lakukan di masa mendatang.
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Catatan** Pastikan Anda menggunakan tanda kutip ganda di sekitar pesan komit.
+
+Setelah kami selesai melakukannya, kami mengupload (mendorong) perubahan kami ke GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Menarik kode baru ke PythonAnywhere, dan isi ulang aplikasi web Anda
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Pembaruan Anda seharusnya hidup! Silakan dan segarkan situs Anda di browser. Perubahan harus terlihat. :)
\ No newline at end of file
diff --git a/id/install_git.md b/id/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/id/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/id/installation/README.md b/id/installation/README.md
new file mode 100644
index 00000000000..1d41b0eed7b
--- /dev/null
+++ b/id/installation/README.md
@@ -0,0 +1,58 @@
+# Jika Anda sedang melakukan tutorial di rumah
+
+Jika Anda melakukan tutorial di rumah, bukan di salah satu acara  Django Girls </ 0> , Anda benar-benar dapat melewatkan bab ini sekarang dan langsung ke  Bagaimana Internet bekerja </ 1> bab .</p> 
+
+Ini karena kita meliput semua hal ini di keseluruhan tutorial, dan ini hanyalah halaman tambahan yang mengumpulkan semua instruksi instalasi di satu tempat. Acara Django Girls mencakup satu "malam instalasi" dimana kami memasang semuanya sehingga kami tidak perlu repot melakukannya selama workshop berlangsung, jadi ini berguna bagi kami.
+
+If you find it useful, you can follow this chapter too. Tetapi jika Anda ingin mulai mempelajari banyak hal sebelum memasang banyak barang di komputer Anda, lewati bab ini dan kami akan menjelaskan bagian pemasangannya nanti.
+
+Semoga berhasil!
+
+# Instalasi
+
+Di bengkel Anda akan membangun sebuah blog, dan ada beberapa tugas setup di tutorial yang akan bagus untuk dikerjakan terlebih dahulu sehingga Anda siap untuk mulai coding pada hari itu.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md"%} 
+
+<!--endsec-->
+
+# Instal Python
+
+{% include "/python_installation/instructions.md"%}
+
+# Set up virtualenv dan install Django
+
+{% include "/django_installation/instructions.md"%}
+
+# Instal editor kode
+
+{% include "/code_editor/instructions.md"%}
+
+# Pasang git
+
+{% include "/deploy/install_git.md"%}
+
+# Buat akun GitHub
+
+Pergi ke [ GitHub.com](https://www.github.com) dan masuk ke akun pengguna baru yang gratis.
+
+# Buat akun PythonAnywhere
+
+{% include "/deploy/signup_pythonanywhere.md"%}
+
+# Mulai membaca
+
+Selamat, Anda sudah siap dan siap untuk pergi! Jika Anda masih memiliki beberapa waktu sebelum lokakarya, akan berguna untuk mulai membaca beberapa bab awal:
+
+* [Bagaimana internet bekerja](../how_the_internet_works/README.md)
+
+* [Pengantar baris perintah](../intro_to_command_line/README.md)
+
+* [Pengenalan Python](../python_introduction/README.md)
+
+* [Apa itu Django ?](../django/README.md)
+
+# Nikmati bengkelnya!
+
+Ketika Anda memulai lokakarya, Anda akan bisa langsung menuju [proyek Django pertama Anda!](../django_start_project/README.md) karena Anda telah membahas materi di bab-bab sebelumnya.
\ No newline at end of file
diff --git a/id/instructions.md b/id/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/id/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/id/intro_to_command_line/README.md b/id/intro_to_command_line/README.md
new file mode 100644
index 00000000000..8c931ee73bb
--- /dev/null
+++ b/id/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Pengantar antarmuka baris perintah
+
+> Bagi para pembaca di rumah: bab ini telah dibahas di video [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+Ini menarik kan? Anda akan menulis baris kode pertama Anda hanya dalam beberapa menit! :)
+
+**Mari kita perkenalkan Anda ke teman baru pertama Anda: baris perintah!**
+
+Langkah-langkah berikut akan menunjukkan cara menggunakan jendela hitam yang digunakan oleh semua hacker. Mungkin terlihat sedikit menakutkan pada awalnya tapi sebenarnya itu hanya sebuah prompt menunggu perintah dari Anda.
+
+> **Catatan** Perlu diketahui bahwa di sepanjang buku ini kita akan menggunakan istilah 'directory' dan 'folder' secara bergantian tetapi keduanya adalah satu dan sama.
+
+## Apa itu baris perintah?
+
+Jendela, yang biasanya disebut **command line**atau** antarmuka baris perintah**, adalah aplikasi berbasis teks untuk melihat, menangani, dan memanipulasi berkas di komputer Anda. Ini seperti Windows Explorer atau Finder di Mac, tapi tanpa antarmuka grafis. Nama lain dari baris perintah adalah: *cmd*, *CLI*, *prompt*, *konsol* atau *terminal*.
+
+## Buka antarmuka baris perintah
+
+Untuk memulai beberapa percobaan kita perlu membuka antarmuka baris perintah kita terlebih dahulu.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Buka menu Start → Windows System → Command Prompt.
+
+> Pada versi Windows yang lama, lihat pada menu Start → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Arahkan ke Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Mungkin letaknya di Applications → Accessories → Terminal, tapi itu tergantung pada sistem Anda. Jika tidak ada, silahkan cari bantuan di Google. :)
+
+<!--endsec-->
+
+## Jendela Perintah
+
+Sekarang Anda akan melihat jendala hitam atau putih yang menunggu perintah yang Anda ketikkan.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Jikan Anda menggunakan Mac atau Linux, mungkin Anda akan melihat tanda `$`, seperti ini:
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Pada Windows, tandanya `>` seperti ini:
+
+{% filename %}baris-perintah{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Setiap baris perintah akan ada tambahan awal dengan tanda ini dan satu spasi, namun Anda tidak perlu mengetikkannya. Komputer Anda akan melakukannya untuk Anda. :)
+
+> Catatan kecil: dalam kasus Anda mungkin kelihatan seperti `C:\Users\ola>` atau `Olas-MacBook-Air:~ ola$` sebelum tanda prompt, itu tidak menjadi masalah.
+
+Bagian setelah dan termasuk tanda `$` atau `>` disebut *prompt baris perintah*, atau singkatnya disebut *prompt*. Mengharuskan Anda untuk mengetikkan sebuah perintah di sana.
+
+Pada tutorial, pada saat kami ingin Anda untuk mengeikkan baris perintah, kami akan sertakan tanda `$` atau `>`, dan kadang-kadang lebih ke kiri. Anda dapat mengabaikan bagian sebelah kiri tadi lalu perintahnya dapat dimulai setelah prompt.
+
+## Perintah pertama Anda (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+Dan kemudian tekan `enter`. Beginilah hasilnya:
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ whoami 
+    olasitarska
+    
+
+Seperti yang bisa Anda lihat, komputer baru saja mencetak nama pengguna Anda. Rapi, kan? :)
+
+> Coba ketik setiap baris peintah; jangan disalin-tempel. Anda akan ingat lebih banyak dengan cara ini!
+
+## Hal-hal dasar
+
+Setiap sistem operasi memiliki seperangkat perintah yang sedikit berbeda untuk baris perintah, jadi pastikan untuk mengikuti petunjuk untuk sistem operasi Anda. Bagaimana kalau kita mencobanya sekarang?
+
+### Direktori aktif
+
+Akan lebih baik jika mengetahui di mana posisi kita sekarang. Mari kita lihat. Ketikkan perintah ini lalu tekan `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ pwd /
+    Users/olasitarska
+    
+
+> Catatan: 'pwd' singkatan dari 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    > cd 
+    C:\Users\olasitarska
+    
+
+> Catatan: 'cd' singkatan dari 'change directory'. Dengan powershell Anda dapat menggunakn pwd seperti halnya pada Linux atau Mac OS X.
+
+<!--endsec-->
+
+Anda mungkin akan melihat sesuatu yang serupa di mesin Anda. Setelah Anda membuka baris perintah yang biasanya Anda gunakan di direktori home pengguna Anda.
+
+* * *
+
+### Daftar berkas dan direktori
+
+Jadi apa isinya? Pasti menyenangkan untuk mencari tahu. Mari kita lihat:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ ls 
+    Applications 
+    Desktop 
+    Downloads 
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    > dir  
+    Directory of C:\Users\olasitarska 
+    05/08/2014 07:28 PM <DIR> Applications 
+    05/08/2014 07:28 PM <DIR> Desktop 
+    05/08/2014 07:28 PM <DIR> Downloads 
+    05/08/2014 07:28 PM <DIR> Music 
+    ...
+    
+
+> Catatan: di powershell Anda juga dapat menggunakan 'ls' seperti pada Linux dan Mac OS X. <!--endsec-->
+
+* * *
+
+### Mengganti direktori aktif
+
+Sekarang, mari kita ke direktori Desktop:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Coba periksa apa sudah benar-benar berubah:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ pwd 
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    > cd 
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Ini dia!
+
+> PRO tip: jika Anda ketik `cd D` dan kemudian menekan `tab` pada keyboard Anda, perintah tersebut akan secara otomatis mengisi sisa dari perintah yang akan diketik sehingga Anda dapat bekerja lebih cepat. Jika ada lebih daru satu folder yang dimulai dengan "D", tekan tombol `tab` dua kali untuk melihat daftar pilihan yang tersedia.
+
+* * *
+
+### Membuat Direktori
+
+Bagaimana jika kita membuat direktori praktik di dekstop Anda? Anda dapat melakukannya begini:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ mkdir praktik
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    > mkdir praktik
+    
+
+<!--endsec-->
+
+Perintah sederhana ini akan membuat sebuh folder dengan nama `praktik` pada Desktop Anda. Anda dapat memeriksanya apakah sudah ada di Desktop atau dengan menjalankan perintah `ls` atu `dir`! Cobalah. :)
+
+> PRO tip: Jika Anda tidak ingin mengetikkan perintah yang sama berulangkali, coba tekan `panah atas` dan `panah bawah` pada keyboard Anda untuk melihat perintah yang baru saja Anda gunakan.
+
+* * *
+
+### Latihan!
+
+Tantangan kecil untuk Anda: pada direktori `praktik` yang baru Anda buat, buat sebuah direktori dengan nama `tes`. (Gunakan perintah `cd` dan `mkdir`.)
+
+#### Solusi:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ cd practice 
+    $ mkdir test 
+    $ ls 
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    > cd practice 
+    > mkdir test 
+    > dir 
+    05/08/2014 07:28 PM <DIR> test
+    
+
+<!--endsec-->
+
+Selamat! :)
+
+* * *
+
+### Pembersihan
+
+Kami tidak ingin meninggalkan kekacauan, jadi mari kita hilangkan semua yang telah kita lakukan sampai saat itu.
+
+Pertama, kita perlu kembali ke Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Penggunaan `..` dengan perintah `cd` akan mengubah direktori aktif saat ini kembali ke direktori induk (yaitu, direktori yang berisi direktori aktif saat ini.).
+
+Periksa posisi Anda:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ pwd 
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    > cd 
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Sekarang kita akan menghapus direktori `praktik`:
+
+> **Perhatian**: Menghapus berkas dengan menggunakan `del`, `rmdir ` atau `rm ` tidak dapat dipulihkan, artinya *berkas yang dihapus akan hilang selamanya*! Jadi berhati-hatilah dengan perintah ini.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}baris-perinah{% endfilename %}
+
+    > rmdir /S practice 
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Selesai! Untuk memastikan itu benar-benar dihapus, mari kita periksa:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+Itu dulu untuk saat ini! Anda dapat menutup baris perintah sekarang. Mari melakukannya seperti yang dilakukan peretas, oke? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}baris-perintah{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Keren, kan? :)
+
+## Ringkasan
+
+Berikut ini adalah beberapa ringkasan perintah yang akan berguna:
+
+| Perintah (Windows) | Perintah (Mac OS / Linux) | Keterangan                  | Contoh                                         |
+| ------------------ | ------------------------- | --------------------------- | ---------------------------------------------- |
+| exit               | exit                      | menutup jendela kerja       | **exit**                                       |
+| cd                 | cd                        | mengganti direktori         | **cd tes**                                     |
+| cd                 | pwd                       | menunjukkan direktori aktif | **cd** (Windows) atau **pwd** (Mac OS / Linux) |
+| dir                | ls                        | daftar direktori/file       | **dir**                                        |
+| copy               | cp                        | menyalin berkas             | **copy c:\tes\tes.txt c:\windows\tes.txt** |
+| move               | mv                        | memindakan berkas           | **move c:\tes\tes.txt c:\windows\tes.txt** |
+| mkdir              | mkdir                     | membuat direktori baru      | **mkdir direktorites**                         |
+| rmdir (or del)     | rm                        | menghapus berkas            | **del c:\tes\tes.txt**                       |
+| rmdir /S           | rm -r                     | menghapus direktori         | **rm -r testdirectory**                        |
+
+Ini semua hanya beberapa perintah yang dapat Anda jalankan pada baris perintah, tapi hari ini Anda tidak akan menggunakan apapun lebih dari itu.
+
+Jika Anda masih penasaran, [ss64.com](http://ss64.com) berisi referensi lengkap tentang perintah-perintah untuk semua sistem operasi.
+
+## Siap?
+
+Mari menyelami dunia Python!
\ No newline at end of file
diff --git a/id/python_installation/README.md b/id/python_installation/README.md
new file mode 100644
index 00000000000..0a27cdf6deb
--- /dev/null
+++ b/id/python_installation/README.md
@@ -0,0 +1,15 @@
+# Mari kita mulai dengan Python
+
+Kami akhirnya di sini!
+
+Tapi pertama, mari kita ceritakan apa itu Python. Python adalah bahasa pemrograman yang sangat populer yang bisa digunakan untuk membuat situs web, game, perangkat lunak ilmiah, grafis, dan banyak lagi.
+
+Python berasal pada akhir 1980-an dan tujuan utamanya adalah untuk dapat dibaca oleh manusia (tidak hanya mesin!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Instalasi Python
+
+> **Catatan** Jika Anda menggunakan Chromebook, lewati bab ini dan pastikan Anda mengikuti [Pengaturan](../chromebook_setup/README.md) Chromebook.
+> 
+> **Catatan** Jika Anda sudah mengerjakan langkah-langkah Pemasangan, Anda tidak perlu melakukan ini lagi - Anda bisa langsung melompat ke bab berikutnya!
+
+{% include "/python_installation/instructions.md"%}
\ No newline at end of file
diff --git a/id/python_installation/instructions.md b/id/python_installation/instructions.md
new file mode 100644
index 00000000000..61f2e77b8eb
--- /dev/null
+++ b/id/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> Bagi para pembaca di rumah: bab ini terangkum dalam video [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> Bagian ini dibuat berdasarkan tutorial yang dibuat oleh Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django ditulis dengan Python. Kami membutuhkan Python untuk melakukan apapun di Django. Mari kita mulai dengan menginstalnya! Kami ingin Anda menginstal Python 3.6, jadi jika Anda memiliki versi sebelumnya, Anda perlu mengunggahnya.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Pertama periksa apakah komputer Anda menjalankan versi 32-bit atau versi Windows 64-bit, dengan menekan tombol Windows + tombol Pause/Break yang akan membuka info Sistem Anda, dan melihat baris "Tipe sistem". Anda bisa mendownload Python untuk Windows dari situs https://www.python.org/downloads/windows/. Klik tautan "Latest Python 3 Release - Python x.x.x". Jika komputer Anda menjalan Windows versi **64-bit**, silahkan unduh **Windows x86-64 executable installer**. Jika tidak, unduh **Windows x86 executable installer**. Setelah mendownload installer, Anda harus menjalankannya (klik dua kali) dan ikuti instruksi di sana.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Jangan lupa menambahkan Python dapa Path](../python_installation/images/python-installation-options.png)
+
+Pada langkah selanjutnya, Anda akan menggunakan Windows Command Line (yang juga akan kami ceritakan). Sekarang, jika Anda ingin mengetik beberapa perintah, arahkan ke menu Start → Windows System → Command Prompt. Anda juga dapat menahan tombol Windows dan menekan tombol "R" -key sampai jendela "Run" muncul. Untuk membuka Command Line, ketik "cmd" dan tekan enter di jendela "Run". (Pada versi Windows yang lebih baru, Anda mungkin harus mencari "Command Prompt" karena terkadang tersembunyi.)
+
+![Jenis "; cmd"; di "; Jalankan " jendela](../python_installation/images/windows-plus-r.png)
+
+Catatan: Jika Anda menggunakan versi Windows yang lebih tua (7, Vista, atau versi yang lebih lama) dan installer Python 3.6.x gagal dengan kesalahan, Anda dapat mencoba:
+
+1. instal semua Windows Updates dan coba install Python 3.6 lagi; atau
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+Jika Anda menginstal versi lama Python, layar penginstalan mungkin terlihat sedikit berbeda dari yang ditunjukkan di atas. Pastikan Anda menggulir ke bawah untuk melihat "Add python.exe to Path", lalu klik tombol di sebelah kiri dan pilih "Akan diinstal pada hard drive lokal":
+
+![Tambahkan Python ke Path, versi lama](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Catatan** Sebelum menginstal Python di OS X, Anda harus memastikan pengaturan Mac Anda memungkinkan menginstal paket yang bukan dari App Store. Buka System Preferences (ada di folder Applications), klik "Security & Privacy," dan kemudian tab "General". Jika "Izinkan aplikasi Anda diunduh dari:" disetel ke "Mac App Store", ubahlah menjadi "Mac App Store dan pengembang yang teridentifikasi."
+
+Kamu bisa berkunjung ke situs https://www.python.org/downloads/release/python-361/ dan unduh file install-an Python:
+
+* Unduh file installer Mac OS X 64-bit/32-bit
+* Klik dua kali *python-3.6.1-macosx10.6.pkg* untuk menjalankan installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Sepertinya kamu telah menginstall Python sebelumnya. Untuk mengecek jika itu sudah terinstall serta mengetahui versi yang dipakai, Buka konsol dan ketik perintah dibawah ini:
+
+{% filename %} baris perintah {% endfilename %}
+
+    $ python3 --versi
+    Python 3.6.1
+    
+
+Jika Anda memiliki 'versi mikro' yang berbeda dari Python yang terpasang, mis. 3.6.0, maka Anda tidak perlu upgrade. Jika kamu tidak memiliki Python yang terinstall sebelumnya atau jika kamu menginginkan versi Python yang berbeda, Kamu bisa menginstall seperti dibawah ini:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Ketik perintah ini di konsol:
+
+{% filename %} baris perintah {% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Gunakan perintah ini di konsol:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Gunakan perintah ini di konsol:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verifikasi instalasi berhasil dengan membuka command prompt dan menjalankan perintah `python3`:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --versi
+    Python 3.6.1
+    
+
+**CATATAN:** Jika Anda menggunakan Windows dan Anda mendapatkan pesan kesalahan bahwa `python3` tidak ditemukan, coba gunakan `python` (tanpa `3`) dan periksa apakah masih mungkin versi Python 3.6.
+
+* * *
+
+Jika Anda ragu, atau jika ada yang tidak beres dan Anda tidak tahu apa yang harus dilakukan selanjutnya, tolong tanya pelatih Anda! Kadang sesuatu tidak berjalan dengan lancar dan ini lebih baik untuk meminta bantuan pada seseorang yang berpengalaman.
\ No newline at end of file
diff --git a/id/python_introduction/README.md b/id/python_introduction/README.md
new file mode 100644
index 00000000000..964f597e368
--- /dev/null
+++ b/id/python_introduction/README.md
@@ -0,0 +1,1059 @@
+# Pengantar Python
+
+> Bagian dari bab ini didasarkan pada tutorial oleh Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Mari kita tulis beberapa kode!
+
+## Python prompt
+
+> Bagi pembaca di rumah: bagian ini tercakup dalam [Dasar-Dasar Python: Integer, String, Daftar, Variabel dan Kesalahan](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+Untuk memulai python, kita perlu membuka *Comand line atau Jendela perintah* pada komputer anda. Anda seharusnya sudah tahu bagaimana melakukan itu - Anda mempelajarinya di bagian [Intro to Command Line](../intro_to_command_line/README.md).
+
+Ketika kamu sudah siap, Silakan ikuti instruksi dibawah ini.
+
+Kita ingin membuka konsol Python, Jadi silakan ketik `python` untuk Windows atau `python3` pada Mac OS/Linux dan tekan `Enter`.
+
+{% filename%} baris perintah {% endfilename%}
+
+    $ python3
+    Python 3.6.1 (...)
+    Ketik "bantuan", "hak cipta", "kredit" atau "lisensi" untuk informasi lebih lanjut.
+    >>>
+    
+
+## Perintah Python pertama Anda!
+
+Setelah menjalankan perintah Python, prompt akan berubah menjadi `>>>`. Bagi kita sekarang adalah kita harus menggunakan perintah pada bahasa Python saja. Anda tidak perlu mengetik `>>>` - Python akan melakukannya untuk Anda.
+
+Jika kamu ingin keluar dari konsol Python, Cukup dengan mengetik perintah `exit()` atau pakai shortcut `Ctrl + Z` untuk Windows dan `Ctrl + D` untuk Mac/Linux. Maka Anda tidak akan melihat `>>&gt` lagi.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Bagus! Lihat bagaimana balasan muncul keluar? Python tahu matematika! Anda bisa mencoba perintah lain seperti:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2
+`
+
+Untuk melakukan perhitungan eksponensial, katakan 2 pada power 3, kita ketik: {% filename %}baris perintah{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Bersenang-senang dengan ini sebentar dan kemudian kembali kesini. :)
+
+Seperti yang Anda lihat, Python adalah kalkulator yang hebat. Jika Anda bertanya-tanya apa lagi yang bisa Anda lakukan…
+
+## String
+
+Bagaimana dengan namamu? Ketik nama depan Anda dalam tanda kutip seperti ini:
+
+{% filename %} baris perintah {% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+Anda sekarang telah membuat string pertama Anda! Ini adalah urutan karakter yang bisa diolah oleh komputer. String harus selalu dimulai dan diakhiri dengan karakter yang sama. Ini mungkin tunggal (`'`) atau double (`"`) mengutip (tidak ada bedanya!) Kutipan memberi tahu Python bahwa apa yang ada di dalamnya adalah string.
+
+String bisa dirangkai. Coba ini:
+
+{% filename %} baris perintah {% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+Anda juga bisa mengalikan string dengan angka:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Jika Anda perlu menempatkan tanda kutip di dalam string Anda, Anda memiliki dua cara untuk melakukannya.
+
+Menggunakan tanda kutip ganda:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> "Runnin' menuruni bukit"
+"Runnin' menuruni bukit"
+```
+
+atau keluar dari apostrof dengan garis miring terbalik (``):
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> 'Runnin\' menuruni bukit'
+"Runnin' menuruni bukit"
+```
+
+Bagus, ya? Untuk melihat nama Anda dalam huruf besar, cukup ketik:
+
+{% filename %}baris-perintah{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Anda hanya menggunakan **method**`upper` pada string anda! method (`upper`) adalah urutan instruksi yang Python harus melakukan pada objek tertentu ( ` " Ola " ` ) setelah anda menyebutnya .
+
+Jika Anda ingin tahu jumlah huruf yang terkandung dalam nama Anda , ada **function** untuk itu juga!
+
+{% filename %} baris-perintah{% endfilename %}
+
+```python
+>>> len ("Ola")
+3
+```
+
+Entah mengapa kadang-kadang Anda memanggil fungsi dengan `.` di akhir string (seperti `"Ola".upper()`) dan terkadang Anda pertama kali memanggil fungsi dan menempatkan string dalam kurung? Nah, dalam beberapa kasus, fungsi termasuk objek, seperti `upper()`, yang hanya bisa dilakukan pada string. Dalam hal ini, kita sebut fungsi sebuah **metode**. Di lain waktu, fungsi tidak termasuk dalam sesuatu yang spesifik dan dapat digunakan pada berbagai jenis objek, seperti `len()`. Itu sebabnya kami memberi `"Ola"` sebagai parameter pada fungsi `len`.
+
+### Ikhtisar
+
+OK, cukup banyak senar. Sejauh ini Anda telah belajar tentang:
+
+- **prompt** - perintah mengetik (kode) ke prompt Python menghasilkan jawaban dengan Python
+- **nomor dan string** - dengan nomor Python digunakan untuk matematika dan string untuk objek teks
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **fungsi** - seperti `atas()` dan `len()`, lakukan tindakan pada objek.
+
+Ini adalah dasar-dasar setiap bahasa pemrograman yang Anda pelajari. Siap untuk sesuatu yang lebih keras? Kami yakin kamu!
+
+## Kesalahan
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename%} baris perintah {% endfilename%}
+
+```python
+& gt; & gt; & gt; len (304023) Traceback (panggilan terakhir terakhir):
+   File " <stdin> ", baris 1, di <module> 
+TypeError: objek tipe 'int' tidak memiliki len ()
+```
+
+Kami mendapat kesalahan pertama kami! Dikatakan bahwa objek tipe "int" (bilangan bulat, bilangan bulat) tidak memiliki panjang. Jadi apa yang bisa kita lakukan sekarang? Mungkin kita bisa menulis nomor kita sebagai string? String punya panjang, kan?
+
+{% filename %}baris-perintah{% endfilename %}
+
+```python
+& gt; & gt; & gt; len (str (304023)) 6
+```
+
+Ini berhasil! Kami menggunakan `str` fungsi di dalam `len` fungsi. `str()` mengubah segalanya menjadi senar.
+
+- Fungsi `str` mengubah sesuatu menjadi **string**
+- Fungsi `int` mengubah semuanya menjadi **bilangan bulat**
+
+> Penting: kita bisa mengonversi bilangan menjadi teks, tapi kita tidak bisa mengubah teks menjadi angka - apa yang akan `int ('halo')` jadi?
+
+## Variabel
+
+Konsep penting dalam pemrograman adalah variabel. Variabel tidak lebih dari sebuah nama untuk sesuatu sehingga Anda dapat menggunakannya nanti. Pemrogram menggunakan variabel ini untuk menyimpan data, membuat kode mereka lebih mudah dibaca dan karenanya mereka tidak perlu terus mengingat hal-hal apa adanya.
+
+Misalkan kita ingin membuat variabel baru yang disebut ` name ` :
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> nama = "Ola"
+```
+
+We type name equals Ola.
+
+Seperti yang telah Anda sadari, program Anda tidak mengembalikan hal seperti sebelumnya. Jadi bagaimana kita tahu bahwa sebenarnya variabel itu ada? Cukup masukkan `nama`dan tekan `masukkan`:
+
+{% filename %}baris-perintah{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Hura! Variabel pertama anda :) Anda selalu bisa mengubah apa yang dimaksud dengan:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+Anda dapat menggunakannya dalam fungsi juga:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Mengagumkan kan? Tentu saja, variabel bisa apa saja - angka juga! Coba ini:
+
+{% filename %} baris perintah {% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Tapi bagaimana kalau kita menggunakan nama yang salah? Bisakah kamu menebak apa yang akan terjadi? Mari mencoba!
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> kota = "Tokyo"
+>>> ctiy
+Traceback (panggilan terakhir):
+   File "<stdin>", baris 1, di <module>
+NameError: nama 'ctiy' tidak didefinisikan
+```
+
+Sebuah kesalahan! Seperti yang Anda lihat, Python memiliki jenis kesalahan yang berbeda dan yang satu ini disebut **NameError**. Python akan memberi Anda kesalahan ini jika Anda mencoba menggunakan variabel yang belum didefinisikan. Jika Anda mengalami kesalahan ini nanti, periksa kode Anda untuk melihat apakah Anda salah mengetikkan nama apa pun.
+
+Mainkan dengan ini untuk sementara dan lihat apa yang dapat Anda lakukan!
+
+## Fungsi cetak
+
+Coba ini:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Bila Anda mengetikkan `nama`, juru bahasa Python merespons dengan string *representasi* dari variabel 'nama', yaitu huruf M-a-r-i-a, dikelilingi oleh tanda kutip tunggal, ''. Bila Anda mengatakan `print (nama)`, Python akan "mencetak" isi variabel ke layar, tanpa tanda petik, yang lebih rapi.
+
+Seperti yang akan kita lihat nanti, `print()` juga berguna saat kita ingin mencetak sesuatu dari fungsi di dalam, atau saat kita ingin mencetak berbagai hal pada banyak baris.
+
+## Daftar
+
+Selain string dan bilangan bulat, Python memiliki berbagai jenis objek. Sekarang kita akan mengenalkan satu daftar ** **. Daftar persis seperti yang Anda duga: objek yang merupakan daftar objek lain. :)
+
+Silakan membuat daftar:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Ya, daftar ini kosong. Tidak terlalu berguna kan? Mari buat daftar nomor undian. Kami tidak ingin mengulangi diri kami sepanjang waktu, jadi kami akan memasukkannya ke dalam variabel juga:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> undian = [3, 42, 12, 19, 30, 59]
+```
+
+Baiklah, kita punya daftar! Apa yang bisa kita lakukan dengan itu? Mari kita lihat berapa jumlah undian yang ada dalam daftar. Apakah Anda tahu fungsi mana yang harus Anda gunakan untuk itu? Anda sudah tahu ini!
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Iya nih! `len()` dapat memberi Anda sejumlah objek dalam daftar. Berguna, kan? Mungkin kita akan mengatasinya sekarang:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Ini tidak mengembalikan apapun, itu hanya mengubah urutan nomor yang muncul dalam daftar. Ayo cetak lagi dan lihat apa yang terjadi:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> cetak (undian)
+[3, 12, 19, 30, 42, 59]
+```
+
+Seperti yang dapat Anda lihat, angka dalam daftar Anda sekarang diurutkan dari nilai terendah ke nilai tertinggi. Selamat!
+
+Mungkin kita ingin membalikkan pesanan itu? Ayo lakukan itu!
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> lottery.reverse ()
+>>> cetak (undian)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> lottery.append (199)
+>>> cetak (undian)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Jika Anda hanya ingin menunjukkan angka pertama, Anda dapat melakukannya dengan menggunakan **indeks**. Sebuah indeks adalah angka yang mengatakan di mana dalam daftar sebuah item terjadi. Pemrogram lebih memilih untuk mulai menghitung pada 0, jadi objek pertama dalam daftar Anda ada di indeks 0, yang berikutnya adalah 1, dan seterusnya. Coba ini:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> cetak (undian[0])
+59
+>>> cetak (undian [1])
+42
+```
+
+Seperti yang Anda lihat, Anda dapat mengakses berbagai objek dalam daftar Anda dengan menggunakan nama daftar dan indeks objek di dalam tanda kurung siku .
+
+Untuk menghapus sesuatu dari daftar Anda, Anda perlu menggunakan ** indeks ** seperti yang telah kita pelajari di atas dan metode ` pop () ` . Mari coba contoh dan perkuat apa yang telah kita pelajari sebelumnya; kami akan menghapus nomor pertama dari daftar kami.
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> cetak (undian)
+[59, 42, 30, 19, 12, 3, 199]
+>>> cetak (undian[0])
+59
+>>> lottery.pop(0)
+59
+>>> cetak(undian)
+[42, 30, 19, 12, 3, 199]
+```
+
+Itu bekerja seperti pesona!
+
+Untuk kesenangan ekstra, cobalah beberapa indeks lainnya: 6, 7, 1000, -1, -6 atau -1000. Lihat apakah Anda bisa memprediksi hasilnya sebelum mencoba perintahnya. Apakah hasilnya masuk akal?
+
+Anda dapat menemukan daftar semua metode daftar yang tersedia di bab dokumentasi Python ini: https://docs.python.org/3/tutorial/datastructures.html
+
+## Kamus
+
+> Bagi pembaca di rumah: bagian ini tercakup dalam [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+Kamus mirip dengan daftar, namun Anda mengakses nilai dengan mencari kunci alih-alih indeks numerik. Kunci bisa berupa string atau angka. Sintaks untuk mendefinisikan kamus kosong adalah:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Ini menunjukkan bahwa Anda baru saja membuat kamus kosong. Hore!
+
+Sekarang, coba tuliskan perintah berikut (coba ganti informasi Anda sendiri juga):
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> peserta = {'nama': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+Dengan perintah ini, Anda baru saja membuat sebuah variabel bernama `peserta` dengan tiga pasangan nilai kunci:
+
+- Kunci `nama` menunjuk ke nilai `'Ola'` (a `string` objek),
+- `negara` menunjuk ke `'Polandia'` (string `lainnya`),
+- dan `favorite_numbers` menunjuk ke `[7, 42, 92]` (a `daftar` dengan tiga nomor di dalamnya).
+
+Anda dapat memeriksa isi kunci individu dengan sintaks ini:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Lihat, ini mirip dengan daftar. Tapi Anda tidak perlu mengingat indeks - cukup namanya.
+
+Apa yang terjadi jika kita meminta Python nilai sebuah kunci yang tidak ada? Bisakah kamu menebak? Mari kita coba dan lihat!
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> peserta['usia']
+Traceback (panggilan terakhir):
+  File "<stdin>", baris 1, di <module>
+KeyError: 'usia'
+```
+
+Lihat, kesalahan lain! Yang ini adalah **KeyError**. Python sangat membantu dan memberitahu Anda bahwa kunci `'usia'` tidak ada dalam kamus ini.
+
+Kapan sebaiknya Anda menggunakan kamus atau daftar? Nah, itu bagus untuk direnungkan. Pikirkan saja jawabannya sebelum melihat jawabannya di baris berikutnya.
+
+- Apakah Anda hanya butuh urutan barang yang dipesan? Pergi untuk daftar.
+- Apakah Anda perlu mengaitkan nilai dengan kunci, sehingga Anda dapat melihatnya secara efisien (dengan kunci) nanti? Gunakan kamus.
+
+Kamus, seperti daftar, *bisa berubah*, artinya bisa diubah setelah dibuat. Anda dapat menambahkan pasangan kunci-nilai baru ke kamus setelah dibuat, seperti ini:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Seperti daftar, menggunakan metode `len()` pada kamus mengembalikan jumlah pasangan kunci-nilai dalam kamus. Silakan ketik perintah ini:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Saya harap ini masuk akal sampai sekarang. :) Siap untuk bersenang-senang dengan kamus? Baca terus untuk beberapa hal yang menakjubkan.
+
+Anda dapat menggunakan metode ` pop () ` untuk menghapus item dalam kamus. Katakan, jika Anda ingin menghapus entri yang sesuai dengan tombol `'favorite_numbers'`, ketik saja perintah berikut:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Seperti yang dapat Anda lihat dari keluaran, pasangan kunci-nilai yang sesuai dengan kunci 'favorit_numbers' telah dihapus.
+
+Serta ini, Anda juga dapat mengubah nilai yang terkait dengan kunci yang sudah dibuat di kamus. Ketik ini:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Seperti yang dapat Anda lihat, nilai kunci `'negara'` telah diubah dari `'Polandia'` ke `'Jerman'`. :) Menyenangkan? Hore! Anda baru saja belajar hal menakjubkan lainnya.
+
+### Ikhtisar
+
+Mengagumkan! Anda tahu banyak tentang pemrograman sekarang. Pada bagian terakhir ini Anda belajar tentang:
+
+- **error** - Anda sekarang tahu bagaimana membaca dan memahami kesalahan yang muncul jika Python tidak mengerti perintah yang Anda berikan
+- **variabel** - nama untuk objek yang memungkinkan kode Anda lebih mudah dan membuat kode Anda lebih mudah dibaca
+- **daftar** - daftar objek yang tersimpan dalam urutan tertentu
+- **kamus** - objek yang disimpan sebagai pasangan kunci-nilai
+
+Bersemangat untuk bagian selanjutnya? :)
+
+## Bandingkan hal-hal
+
+> Bagi pembaca di rumah: bagian ini tercakup dalam [Dasar-dasar Python: Perbandingan](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+Sebagian besar pemrograman melibatkan perbandingan berbagai hal. Apa hal termudah untuk membandingkan? Bilangan, tentu saja. Mari kita lihat bagaimana cara kerjanya:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+Kami memberi Python beberapa nomor untuk dibandingkan. Seperti yang bisa Anda lihat, Python tidak hanya bisa membandingkan angka, tapi juga bisa membandingkan hasil metode. Bagus, ya?
+
+Apakah Anda bertanya-tanya mengapa kita menempatkan dua tanda sama ` == ` di sebelah satu sama lain untuk membandingkan apakah angka sama? Kami menggunakan satu ` = ` untuk menetapkan nilai pada variabel. Anda selalu, **selalu** perlu memasukkan dua dari mereka - `==` - jika Anda ingin memeriksa apakah semuanya sama satu sama lain. Kita juga dapat menyatakan bahwa hal-hal yang tidak setara satu sama lain. Untuk itu, kita menggunakan simbol ` ! = ` , seperti yang ditunjukkan pada contoh di atas.
+
+Berikan Python dua tugas lagi:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+Benar
+>>> 3 < = 2
+Salah
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y berarti: x lebih besar dari y
+- x `<` y berarti: x kurang dari y
+- x `<=` y berarti: x kurang dari atau sama dengan y
+- x `>=` y berarti: x lebih besar dari atau sama dengan y
+
+Mengagumkan! Mau melakukan satu lagi? Coba ini:
+
+{% filename %}garis komando{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Anda dapat memberi Python sebanyak mungkin untuk membandingkan yang Anda inginkan, dan ini akan memberi Anda jawaban! Cukup pintar kan?
+
+- **dan** - jika Anda menggunakan operator `dan`, kedua perbandingan harus benar agar keseluruhan perintah menjadi True
+- **atau** - jika Anda menggunakan operator `atau`, hanya satu perbandingan yang harus Benar agar seluruh perintah menjadi Benar
+
+Pernahkah Anda mendengar ungkapan "membandingkan apel dengan jeruk?" Mari kita coba yang setara dengan Python:
+
+{% filename %}garis komando{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Di sini Anda melihat bahwa seperti dalam ekspresi, Python tidak dapat membandingkan angka (`int`) dan sebuah string (`str`). Sebagai gantinya, ini menunjukkan ** TypeError ** dan memberi tahu kita bahwa kedua jenis ini tidak dapat dibandingkan bersama-sama.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+Hanya ada dua objek Boolean:
+
+- Benar
+- Salah
+
+Tapi bagi Python untuk memahami ini, Anda harus selalu menulisnya sebagai 'Benar' (huruf besar huruf pertama, dengan sisa huruf-hurufnya lebih rendah). **benar, BENAR, dan tRUE tidak akan bekerja - hanya Benar benar. ** (Hal yang sama juga berlaku untuk 'Salah' juga.)
+
+Boolean bisa jadi variabel juga! Lihat disini:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> a = benar
+>>> a
+Benar
+```
+
+Anda juga bisa melakukannya dengan cara ini:
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Berlatih dan bersenang-senang dengan Boolean dengan mencoba menjalankan perintah berikut:
+
+- `Benar dan Benar`
+- `Salah dan benar`
+- `Benar atau 1 == 1`
+- `1 != 2`
+
+Selamat! Boolean adalah salah satu fitur paling keren dalam pemrograman, dan Anda baru saja belajar menggunakannya!
+
+# Simpan itu!
+
+> Untuk pembaca di rumah: bagian ini tercakup dalam [Dasar-dasar Python: Menyimpan file dan "Jika" pernyataan](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+Sejauh ini kami telah menulis semua kode python kami di penerjemah, yang membatasi kami untuk memasukkan satu baris kode sekaligus. Program normal disimpan dalam file dan dieksekusi oleh bahasa pemrograman kita **penerjemah** atau **penyusun**. Sejauh ini kami telah menjalankan program kami satu baris sekaligus di Python **penerjemah**. Kita akan membutuhkan lebih dari satu baris kode untuk beberapa tugas berikutnya, jadi kita akan segera perlu:
+
+- Keluar dari juru bahasa Python
+- Buka editor pilihan kami
+- Simpan beberapa kode ke file python baru
+- Menjalankannya!
+
+Untuk keluar dari interpreter Python bahwa kita telah menggunakan, cukup ketik `exit()` fungsi
+
+{% filename %}baris perintah{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Ini akan mengembalikan Anda ke command prompt.
+
+Sebelumnya, kami memilih editor kode dari bagian [editor kode](../code_editor/README.md). Kita perlu membuka editor sekarang dan menulis beberapa kode ke file baru:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Jelas, Anda adalah pengembang Python yang cukup berpengalaman sekarang, jadi silakan menulis beberapa kode yang telah Anda pelajari hari ini.
+
+Sekarang kita perlu menyimpan file dan memberikannya nama deskriptif. Mari kita panggil file ** python_intro.py ** dan simpan ke desktop Anda. Kita bisa menamai file apapun yang kita mau, tapi yang penting disini adalah memastikan file berakhir di ** .py ** . Ekstensi**.py** memberitahu sistem operasi kita bahwa ini adalah sebuah **Phyton file bisa dieksekusi** dan Phyton itu bisa berjalan.
+
+> **Catatan** Anda harus memperhatikan salah satu hal yang paling keren tentang editor kode: warna! Di konsol Python, semuanya warnanya sama; Sekarang Anda harus melihat bahwa fungsi `print` adalah warna yang berbeda dari string. Ini disebut "penyorotan sintaks", dan ini adalah fitur yang sangat berguna saat mengkodekan. Warna benda akan memberi petunjuk, seperti string yang tidak ditutup atau salah ketik pada nama kata kunci (seperti ` def ` dalam sebuah fungsi, yang akan kita lihat di bawah). Inilah salah satu alasan kita menggunakan kode editor. :)
+
+Dengan file yang tersimpan, saatnya untuk menjalankannya! Dengan menggunakan keahlian yang telah Anda pelajari di bagian baris perintah, gunakan terminal untuk **ubah direktori** ke desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Di Mac, perintahnya akan terlihat seperti ini:
+
+{% filename %}baris perintah{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Di Linux, akan seperti ini (kata "Desktop" bisa diterjemahkan ke bahasa lokal Anda):
+
+{% filename %}garis komando{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+Pada Windows Command Prompt, akan seperti ini:
+
+{% filename %}garis komando{% endfilename %}
+
+    > cd %HomePath%\Deskop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+Dan pada Windows Powershell, akan seperti ini:
+
+{% filename %}baris perintah{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Jika Anda terjebak, mintalah bantuan.
+
+Sekarang gunakan Python untuk mengeksekusi kode pada file seperti ini:
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ python3 python_intro.py Halo, Django girls!
+    
+
+Catatan: pada Windows 'python3' tidak dikenali sebagai perintah. Sebagai gantinya, gunakan 'python' untuk mengeksekusi file:
+
+{% filename %}baris-perintah{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Baik! Anda hanya menjalankan program Python pertama Anda yang disimpan ke sebuah file. Merasa mengagumkan
+
+Anda sekarang dapat beralih ke alat penting dalam pemrograman:
+
+## Jika ... elif ... lain
+
+Banyak hal dalam kode harus dijalankan hanya bila kondisi yang diberikan terpenuhi. Itu sebabnya Python memiliki sesuatu yang disebut**jika pernyataan**.
+
+Ganti kode di file **python_intro.py** Anda dengan ini:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Jika kita menyimpan dan menjalankan ini, kita akan melihat kesalahan seperti ini:
+
+{% filename %}baris-perintah{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python mengharapkan kita untuk memberikan instruksi lebih lanjut untuk itu yang di eksekusi jika kondisi `3 > 2` ternyata benar (atau `Benar` dalam hal ini). Mari kita coba membuat tulisan Python "It works!". Ubah kode Anda di berkas **python_intro.py** Anda ke ini:
+
+{% filename %}python_intro.py {% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Perhatikan bagaimana kita menjerumuskan baris kode berikut dengan 4 spasi? Kita perlu melakukan ini sehingga Python tahu kode apa yang harus dijalankan jika hasilnya benar. Anda bisa melakukan satu ruang, tapi hampir semua pemrogram Python melakukan 4 untuk membuat segalanya terlihat rapi. Tunggal `tab` juga akan dihitung sebagai 4 ruang.
+
+Simpan dan berikan satu putaran lagi:
+
+{% filename %}garis komando{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Catatan: Ingat bahwa di Windows, 'python3' tidak dikenali sebagai perintah. Mulai sekarang, ganti 'python3' dengan 'python' untuk mengeksekusi file.
+
+### Bagaimana jika sebuah kondisi tidak benar?
+
+Dalam contoh sebelumnya, kode hanya dijalankan bila kondisinya benar. Tapi Python juga punya `elif` dan `lain` pernyataan:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+Saat ini dijalankan maka akan tercetak:
+
+{% filename %}baris perintah{% endfilename %}
+
+    $ python3 python_intro.py
+    5 memang lebih besar dari 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+dan dieksekusi:
+
+{% filename %}baris perintah{% endfilename %}
+
+    $ python3 python_intro.py
+    Hei Sonja!
+    
+
+Lihat apa yang terjadi disana? `elif` memungkinkan Anda menambahkan kondisi tambahan yang berjalan jika kondisi sebelumnya gagal.
+
+Anda dapat menambahkan sebanyak `elif` pernyataan yang Anda inginkan setelah pernyataan `jika` awal Anda. Sebagai contoh:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python berjalan melalui setiap tes secara berurutan dan dicetak:
+
+{% filename %}garis komando{% endfilename %}
+
+    $ python3 python_intro.py Sempurna, saya bisa mendengar semua detailnya
+    
+
+## Komentar
+
+Komentar adalah garis yang dimulai dengan `#`. Anda bisa menulis apapun yang Anda inginkan setelah `#` dan Python akan mengabaikannya. Komentar dapat membuat kode Anda lebih mudah dipahami oleh orang lain.
+
+Mari kita lihat bagaimana tampilannya:
+
+{% filename %} Pengantar_phyton.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+Anda tidak perlu menulis komentar untuk setiap baris kode, namun berguna untuk menjelaskan mengapa kode Anda melakukan sesuatu, atau memberikan ringkasan saat melakukan sesuatu yang rumit.
+
+### Ikhtisar
+
+Dalam beberapa latihan terakhir yang Anda pelajari:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** - jenis objek yang hanya bisa memiliki satu dari dua nilai: `Benar` atau`Salah`
+- ** Simpan file** - menyimpan kode dalam file sehingga Anda bisa menjalankan program yang lebih besar.
+- **jika…elif…lain** - pernyataan yang memungkinkan Anda untuk mengeksekusi kode hanya bila kondisi tertentu terpenuhi.
+- **perintah** - baris yang tidak akan dijalankan Python yang memungkinkan Anda mendokumentasikan kode Anda
+
+Waktu untuk bagian terakhir dari bab ini!
+
+## Fungsi anda sendiri
+
+> Bagi pembaca di rumah: bagian ini tercakup dalam video [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Ingat fungsi seperti `len ()`yang bisa Anda eksekusi dengan Python? Nah, kabar baik - Anda akan belajar bagaimana menulis sendiri fungsi Anda sekarang!
+
+Fungsi adalah urutan instruksi yang harus dilakukan Python. Setiap fungsi di Python dimulai dengan kata kunci `def`, diberi nama, dan bisa memiliki beberapa parameter. Let's give it a go. Ganti kode di **python_intro.py** dengan mengikuti:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Oke, fungsi pertama kita sudah siap!
+
+Anda mungkin bertanya-tanya mengapa kami menuliskan nama fungsi di bagian bawah file. Ini karena Python membaca file dan mengeksekusinya dari atas ke bawah. Jadi untuk menggunakan fungsi kita, kita harus menulis ulang di bagian bawah.
+
+Ayo jalankan ini sekarang dan lihat apa yang terjadi:
+
+{% filename %}garis komando{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Catatan: jika tidak berhasil, jangan panik! keluarannya akan membantu Anda untuk mengetahui mengapa:
+
+- Jika Anda mendapatkan `kesalahan nama`, itu mungkin berarti Anda mengetikkan sesuatu yang salah, jadi Anda harus memeriksa bahwa Anda menggunakan nama yang sama saat membuat fungsi dengan `def hi():` dan kapan memanggilnya dengan `hi()`.
+- Jika Anda mendapatkan `IndentationError`, periksalah bahwa kedua baris `cetak` memiliki spasi yang sama di awal baris: python menginginkan semua kode di dalam fungsi disesuaikan dengan rapi.
+- Jika tidak ada output sama sekali, periksa apakah yang terakhir `hi()` *tidak* indentasi - jika memang demikian, baris itu juga akan menjadi bagian dari fungsi, dan itu akan tidak pernah lari.
+
+Mari kita bangun fungsi pertama kita dengan parameter. Kami akan menggunakan contoh sebelumnya - sebuah fungsi yang mengatakan 'hai' kepada orang yang menjalankannya - dengan sebuah nama:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi (nama):
+```
+
+Seperti yang bisa Anda lihat, sekarang kami memberi parameter fungsi yang kami namakan `nama`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Ingat: Fungsi `print` adalah indentasi empat spasi di dalam `jika`pernyataan. Ini karena fungsinya berjalan saat kondisinya terpenuhi. Mari kita lihat bagaimana cara kerjanya sekarang:
+
+{% filename %}garis komando{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, terjadi kesalahan. Untungnya, Python memberi kita pesan kesalahan yang cukup berguna. Ini memberitahu kita bahwa fungsinya `hi()` (yang kita definisikan) memiliki satu argumen yang dibutuhkan (panggilan `nama`) dan bahwa kita lupa melewatinya saat memanggil fungsinya. Mari kita memperbaikinya di bagian bawah file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+Dan jika kita mengganti namanya?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+Dan jalankan:
+
+{% filename %}baris perintah {% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Nah, apa yang menurut Anda akan terjadi jika Anda menulis nama lain di sana? (Bukan Ola atau Sonja.) Cobalah dan lihat apakah Anda benar. Ini harus mencetak ini:
+
+{% filename %} baris perintah {% endfilename %}
+
+    Hai anonim!
+    
+
+Ini luar biasa kan? Dengan cara ini Anda tidak perlu mengulanginya sendiri setiap kali Anda ingin mengubah nama orang yang seharusnya disapanya. Dan itulah mengapa kita membutuhkan fungsi - Anda tidak ingin mengulang kode Anda!
+
+Mari kita melakukan sesuatu yang lebih pintar - ada lebih banyak nama daripada dua, dan menulis sebuah kondisi untuk masing-masing akan sulit, bukan?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Mari kita panggil kode sekarang:
+
+{% filename %}baris perintah{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Selamat! Anda baru saja belajar bagaimana menulis fungsi! :)
+
+## Loops
+
+> Bagi pembaca di rumah: bagian ini tercakup dalam [Dasar-dasar Python: Untuk video Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0).
+
+Ini adalah bagian terakhir. Itu cepat kan? :)
+
+Pemrogram tidak suka mengulanginya sendiri. Pemrograman adalah tentang mengotomatisasi berbagai hal, jadi kita tidak ingin menyapa setiap orang dengan nama mereka secara manual, bukan? Di situlah loop berguna.
+
+Masih ingat daftar? Mari kita daftar anak perempuan:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+Kami ingin menyapa mereka semua dengan nama mereka. Kami memiliki fungsi `hi` untuk melakukan itu, jadi mari kita gunakan dalam satu lingkaran:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+untuk nama pada anak perempuan:
+```
+
+Itu ```untuk``` pernyataan berperilaku serupa dengan ```jika``` pernyataan; kode di bawah kedua ini perlu indentasi empat spasi.
+
+Berikut adalah kode lengkap yang akan ada di file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+Dan saat kita menjalankannya:
+
+{% filename %}baris perintah{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+Seperti yang dapat Anda lihat, semua yang Anda masukkan ke dalam pernyataan `untuk` dengan indent akan diulang untuk setiap elemen dari daftar `girls`.
+
+Anda juga dapat menggunakan `untuk` pada nomor dengan menggunakan fungsi `range`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+untuk saya di kisaran (1, 6):
+    cetak(i)
+```
+
+Yang akan dicetak:
+
+{% filename %}baris perintah{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`jarak` adalah fungsi yang membuat daftar angka yang mengikuti satu demi satu (angka-angka ini disediakan oleh Anda sebagai parameter).
+
+Perhatikan bahwa kedua dari kedua angka ini tidak termasuk dalam daftar yang dihasilkan oleh Python (artinya `jarak(1, 6)` dihitung dari 1 sampai 5, namun tidak termasuk angka 6). Itu karena "range" setengah terbuka, dan dengan itu kita maksudkan itu termasuk nilai pertama, tapi bukan yang terakhir.
+
+## Ikhtisar
+
+Itu dia. **Kamu benar-benar rock!** Ini adalah bab yang rumit, jadi Anda harus merasa bangga pada diri sendiri. Kami pasti bangga dengan Anda karena sejauh ini berhasil!
+
+Anda mungkin ingin secara singkat melakukan sesuatu yang lain - Peregangan, jalan-jalan sebentar, istirahatkan matamu - sebelum melanjutkan ke bab berikutnya. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/id/signup_pythonanywhere.md b/id/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/id/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/id/template_extending/README.md b/id/template_extending/README.md
new file mode 100644
index 00000000000..ab745ef5a48
--- /dev/null
+++ b/id/template_extending/README.md
@@ -0,0 +1,137 @@
+# Template memperpanjang
+
+Hal baik lain yang Django miliki untuk Anda adalah ** template yang diperluas </ 0>. Apa artinya ini? Ini berarti Anda dapat menggunakan bagian HTML yang sama untuk berbagai halaman situs web Anda.</p> 
+
+Template membantu bila kamu ingin menggunakan informasi atau tata letak yang sama di lebih dari satu tempat. Kamu tidak perlu mengulang sendiri di setiap file. Dan jika kamu ingin mengubah sesuatu, Anda tidak perlu melakukannya di setiap template, hanya satu!
+
+## Buat template dasar
+
+Template dasar adalah template paling dasar yang Anda tambahkan di setiap halaman situs web kamu.
+
+Ayo buat file ` base.html </ 0> di <code> blog / templates / blog / </ 0>:</p>
+
+<pre><code>blog └───templates
+     └───blog
+             base.html
+             post_list.html
+`</pre> 
+
+Kemudian buka dan salin semua dari `post_list.html` ke `base.html` file, Seperti ini:
+
+{% filenama %}blog/template/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles%} 
+&lt;html&gt; 
+&lt;head&gt; &lt;title&gt; Blog Django Girls </ 2> &lt;link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css"&gt; &lt;link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css"&gt; &lt;link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'&gt; &lt;link rel="stylesheet" href="{% static 'css/blog.css' %}"&gt; </ 1> &lt;body&gt; &lt;div class="page-header"&gt; &lt;a href="{% url 'post_new' %}" class="top-menu"&gt;&lt;span class="glyphicon glyphicon-plus"&gt; </ 9 > &lt;h1&gt;&lt;a href="/"&gt; Django Girls Blog </ 10> </ 8> &lt;div class="content container"&gt; &lt;div class="row"&gt; &lt;div class="col-md-8"&gt; {% konten blok%} {% endblock%} </ 13> </ 12> </ 11> </ 7 > </ 0>    
+        
+        
+        
+        
+        
+    
+    
+        
+            
+            
+        
+        
+            
+                
+                    
+                    
+                
+            
+        
+    
+```
+
+Kemudian di `base.html`, ganti seluruh `<body>` ( diantara semua `<body>` dan `</body>`) dengan ini:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Blog Django Girls</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw%} Anda mungkin melihat ini mengganti semuanya dari ` {% untuk posting di posting%} </ 0> menjadi <code> {% endfor%} </ 0> dengan: {% endraw%}</p>
+
+<p>{% filename %}blog/templates/blog/base.html{% endfilename %}</p>
+
+<pre><code class="html">{% block content %}
+{% endblock %}
+`</pre> 
+
+Tapi mengapa? Anda baru saja membuat `block`! Anda menggunakan template tag `{% blok %}` Untuk membuat area yang memiliki HTML yang Dimasukkan didalamnya. HTML akan datang dari template lain yang memperluas template ini (`base.html`). Kami akan menunjukkan kepada kamu bagaimana melakukan ini dalam sesaat.
+
+Sekarang simpan`base.html` dan buka `blog/template/blog/post_list.html` kamu lagi. {% raw %} kamu akan menghapus segalanya diatas `{% for post in posts %}` dan dibawah `{% endfor %}`. Saat kamu sudah selesai, berkas akan terlihat seperti ini:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+Kami akan menggunakan ini sebagai bagian dari template kami untuk semua konten blok. Saatnya untuk menambahkan tag blok untuk berkas ini!
+
+{% raw %} Anda ingin tag blok anda cocok dengan tag di dalam berkas `base.html` anda. Anda juga ingin memasukkan semua kode yang termasuk dalam blok konten Anda. Untuk melakukannya, letakkan semuanya diantara `{% block content %}` dan `{% endblock %}`. Seperti ini:{% endraw %}
+
+{% filename %}blog/template/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Hanya tersisa satu hal. Kita perlu menghubungkan dua template ini bersama-sama. Inilah semua tentang memperluas template! Kami akan melakukan ini dengan menambahkan tag meluas ke awal file. Seperti ini:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% memperluas 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Itu saja! Periksa apakah situs Anda masih berfungsi sebagaimana mestinya. :)
+
+> Jika Anda mendapatkan error `TemplateDoesNotExist`, itu berarti tidak ada file `blog/base.html`dan Anda memiliki `runserver` yang berjalan di konsol. Cobalah untuk menghentikannya (dengan menekan Ctrl+C - tombol Control and C bersamaan) dan restart dengan menjalankan perintah `python manage.py runserver`.
\ No newline at end of file
diff --git a/id/whats_next/README.md b/id/whats_next/README.md
new file mode 100644
index 00000000000..87d5a1c77f5
--- /dev/null
+++ b/id/whats_next/README.md
@@ -0,0 +1,25 @@
+# Apa berikutnya?
+
+Selamatkan dirimu! ** Anda benar-benar hebat </ 0> . Kami bangga <3</p> 
+
+### Apa yang harus dilakukan sekarang?
+
+Istirahat sejenak dan rileks. Anda baru saja melakukan sesuatu yang sangat besar.
+
+Setelah itu, pastikan untuk mengikuti Django Girls di  Facebook </ 0> atau  Twitter </ 1> untuk tetap mengikuti perkembangan.</p> 
+
+### Dapatkah Anda merekomendasikan sumber daya lebih lanjut?
+
+Iya nih! Pertama, maju dan coba buku kami yang lain, yang disebut  Django Girls Tutorial: Extensions </ 0> .</p> 
+
+Nantinya, Anda bisa mencoba sumber daya yang tercantum di bawah ini. Mereka semua sangat dianjurkan!
+
+- [Tutorial resmi Django](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [Tutorial Coder Baru](http://newcoder.io/tutorials/)
+- [Code Academy Python saja](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & amp; Kursus CSS](https://www.codecademy.com/tracks/web)
+- [Tutorial wortel Django](https://github.com/ggcarrots/django-carrots)
+- [Pelajari buku Python The Hard Way](http://learnpythonthehardway.org/book/)
+- [Memulai dengan pelajaran video Django](http://www.gettingstartedwithdjango.com/)
+- [Dua Scoops dari Django 1.11: Praktik Terbaik untuk buku Django Web Framework](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+-  Hello Web App: Pelajari Cara Membangun Aplikasi Web </ 0> - Anda juga dapat meminta lisensi e-book gratis dengan menghubungi penulis Tracy Osborn di  tracy@limedaring.com </ 1></li> </ul>
\ No newline at end of file
diff --git a/ig-NG/GLOSSARY.md b/ig-NG/GLOSSARY.md
new file mode 100644
index 00000000000..5cbbc70c860
--- /dev/null
+++ b/ig-NG/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor bụ ngwa na-enye gị ohere ịchekwa koodu gị ka ị nwee ike ịbịaghachi na ya ma emesịa. I nwere ike imuta otu aga esi nweta otu site na ebe a dere maka Code editor <0></p>
\ No newline at end of file
diff --git a/ig-NG/README.md b/ig-NG/README.md
new file mode 100644
index 00000000000..121da8f55bf
--- /dev/null
+++ b/ig-NG/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ig-NG/SUMMARY.md b/ig-NG/SUMMARY.md
new file mode 100644
index 00000000000..8279673c8fc
--- /dev/null
+++ b/ig-NG/SUMMARY.md
@@ -0,0 +1,35 @@
+# Nchikota
+
+* [Ndubata](README.md)
+* [Nwụnye](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Ihe Ndezi Koodu](installation/README.md#code-editor)
+  * [Gburugburu ebe a n'edowa koodu](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Nwụnye (chromebook)](chromebook_setup/README.md)
+* [Otu Intanetị si arụ ọrụ](how_the_internet_works/README.md)
+* [Ndubata nke command line](intro_to_command_line/README.md)
+* [Nwụnye Python](python_installation/README.md)
+* [Ihe ndezi koodu](code_editor/README.md)
+* [Ndubata nke Python](python_introduction/README.md)
+* [Kedu Ihe bụ Django?](django/README.md)
+* [Nwunye Django](django_installation/README.md)
+* [Ihe omume Django mbu gi!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Idokwa!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views - oge imepụta!](django_views/README.md)
+* [Ndubata nke HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Data di ike na templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS - mee ya ka ọ maa mma](css/README.md)
+* [Template igbati](template_extending/README.md)
+* [Gbatia ngwa gị](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [Kedu ihe ọzọ?](whats_next/README.md)
\ No newline at end of file
diff --git a/ig-NG/chromebook_setup/README.md b/ig-NG/chromebook_setup/README.md
new file mode 100644
index 00000000000..df2b34ad6d6
--- /dev/null
+++ b/ig-NG/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Melite Chromebook
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ig-NG/chromebook_setup/instructions.md b/ig-NG/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..3b9811d1c14
--- /dev/null
+++ b/ig-NG/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+I nwere ike [ hapụ ebe a ](http://tutorial.djangogirls.org/en/installation/#install-python) ma ọ bụrụ na ị naghị eji Chromebook. Y’ọbụrụ na ị ji ya , nwụnye gị ga-abu obere ihe dị iche I nwere ike ileghara anya ndị fọdụrụ na ntuziaka nwụnye a.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE bu ngwaọrụ eji enyere gi aka ideputa koodu ma banye na kọmputa na aru oru na ntanetị ebe inwere ike i tinye, dee ihe ma ghazie ngwanro a. Maka oge n'ime nkuzi nkuzi a, cloud IDE ga-arụ ọrụ dị ka * Igwe mpaghara gị *. l ka ga-anọ na-agba n'ime otu ọnụ oru dika ụmụ klas ibe gị nọ na OS X, Ubuntu, ma ọ bụ Windows, mana a ga-ejikọ ọnụ oru gị na kọmputa na-agba ebe ozo cloud IDE wubere gi. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). I nwere ike ịhọrọ otu n’ime cloud IDE, ma soro kwa ntuziaka cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Gaa na [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Debanye aha maka akaụntụ
+3. Pịa * Server ọhụụ * ma họrọ Django App
+4. Pịa bọtịnụ Terminal (n'akụkụ aka ekpe nke ihi oru ahụ)
+
+Ugbu a ị ga - ahụ na obuputara ihe n’akuku ihu oru a, bọtịnụ n'aka ekpe. Pịa bọtịnụ "Terminal" ka imepee ọnụ ọrụ na-eji otu a:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+A na-akwadebe ọnụ ọrụ na PaizaCloud Cloud IDE maka ntuziaka gị. I nwere ike igbubi ma ọ bụ bulie elu ihu oru ahụ iji mee ka ọ bukwuo ibu.
+
+#### AWS Cloud9
+
+Ugbu a Cloud 9 chọrọ ka ị debanye aha na AWS wee debanye ihe ogwugwa kaadị akwụmụgwọ.
+
+1. Tinye Cloud 9 si na[ ụlọ ahịa weebụ Chrome](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Gaa na [ c9.io ](https://c9.io) wee pịa * Bido na AWS Cloud9 *
+3. Debanye aha maka akaụntụ AWS (o na eji ihe ogwugwa kaadị akwụmụgwọ, mana ị nwere ike were ya n'efu)
+4. N'ime AWS, tinye * Cloud9 * na ihe ochicho wee pịa ya
+5. N’ime Cloud 9, pịa * Mepụta gburugburu *
+6. Kpọọ ya * django-girls *
+7. Mgbe ị na-ahazi ntọala, họrọ * Mepụta atụ ọhụụ maka gburugburu (EC2) * maka "Udị gburugburu" yana * t2.micro * "Na ụdị atu" (ọ kwesịrị kwu "Ntọpụta-aka ruru eru maka ya."). Etu echekwara iru-ego di nma ma gi nwere ike idowe nrụrụ nke ọzọ.
+8. Pịa * Nzọụkwụ ọzọ *
+9. Pịa * Mepụta gburugburu *
+
+Ugbu a ị ga - ahụ ihi oru nwere ihe na akuku, nnukwu windo nwere ụfọdụ ihe ederede, na ihi oru obere na ala nke dị ka nke a:
+
+{% filename %}bash{% endfilename %}
+
+    aha njirimara gị: ~ / ebe ọrụ $
+    
+
+Ebe ala a bụ ọdụ oru gị. I nwere ike iji ọdụ oru a zipu ntuziaka na kọmputa Cloud 9. I nwere ike ịgbanwe ihu oru ahụ iji mee ya t'ọ bụru tu ibu.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Gburugburu Mebere
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ig-NG/code_editor/README.md b/ig-NG/code_editor/README.md
new file mode 100644
index 00000000000..a1609ea7fda
--- /dev/null
+++ b/ig-NG/code_editor/README.md
@@ -0,0 +1,11 @@
+# Ihe ndezi koodu
+
+> Maka ndị na - agụ akwụkwọ nọ n'ụlọ: E kụziri isiakwụkwọ nke a na [Nwụnye Python & Ihe Ndezi Koodu](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) vidiyo.
+
+I na-achọ ide akara koodu mbụ gị, ya mere oge eruola iji budata ihe ndezi koodu!
+
+> **Ndetu** Ọ bụrụ na ị na-eji Chromebook, hapu ebe a ma gbaa mbọ hụ na ị na-eso [ntuziaka ](../chromebook_setup/README.md)Chromebook . Igwe IDE nke ị họọrọ (PaizaCloud Cloud IDE ma ọ bụ AWS Cloud9) gụnyere ihe ndezi koodu, yana mgbe imepe faịlụ na IDE gị na menu Faịlị, ị ga-n'eji ihe ndezi ahụ na-akpaghị aka.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ig-NG/code_editor/instructions.md b/ig-NG/code_editor/instructions.md
new file mode 100644
index 00000000000..82fbac15aad
--- /dev/null
+++ b/ig-NG/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ig-NG/css/README.md b/ig-NG/css/README.md
new file mode 100644
index 00000000000..2cc001cc2ff
--- /dev/null
+++ b/ig-NG/css/README.md
@@ -0,0 +1,330 @@
+# CSS - mee ya ka ọ maa mma!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/ig-NG/deploy/README.md b/ig-NG/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/ig-NG/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/ig-NG/deploy/install_git.md b/ig-NG/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/ig-NG/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ig-NG/deploy/signup_pythonanywhere.md b/ig-NG/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ef39d80d196
--- /dev/null
+++ b/ig-NG/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere bụ ọrụ maka ịru koodu Python na sava "na cloud". Anyị ga-eji ya wee kwado saịtị anyị, na ru oru na ntanetị.
+
+Anyị ga na-elele blog anyị na-ewu na PythonAnywhere. Debanye aha maka akaụntụ "Mbido" na PythonAnywhere (ọnụahịa n'efu dị mma, ị gaghị eji kaadị kredit).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Ndetu** Mgbe ị na-ahọrọ aha njirimara gị ebe a, buru n'uche na URL nke blog gị ga-abụ ụdị a `yourusername.pythonanywhere.com`, ya mere i họrọ aha otutu gi ma obu aha maka ihe blog gi bu banyere. Ọzọkwa, dị njikere icheta paswọọdụ gị (tinye ya na ihe njikwa paswọọdụ gị, ọ bụrụ na i n'eji otu).
+
+## Imepụta API token PythonAnywhere 
+
+Nke a bụ ihe ị ga - eme naanị otu ugboro. Mgbe idebanye aha maka PythonAnywhere, a ga-akpọrọ gị ga dashboard gị. Chọta njikọ ahụ n'akụkụ aka nri n'ebe "akaụntụ" peeji gị:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+wee họrọ taabụ a kpọrọ “API token”, ma pịa bọtịnụ na-ekwu "Mepụta API token ọhụrụ".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ig-NG/django/README.md b/ig-NG/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/ig-NG/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/ig-NG/django_admin/README.md b/ig-NG/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/ig-NG/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ig-NG/django_forms/README.md b/ig-NG/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/ig-NG/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ig-NG/django_installation/README.md b/ig-NG/django_installation/README.md
new file mode 100644
index 00000000000..111fb8e6a04
--- /dev/null
+++ b/ig-NG/django_installation/README.md
@@ -0,0 +1,7 @@
+# Nwụnye Django
+
+> **Ndetu** Ọ bụrụ na ị na-eji Chromebook, hapu ebe a ma gbaa mbọ hụ na ị na-eso [ntuziaka ](../chromebook_setup/README.md)Chromebook .
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ig-NG/django_installation/instructions.md b/ig-NG/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/ig-NG/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ig-NG/django_models/README.md b/ig-NG/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/ig-NG/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ig-NG/django_orm/README.md b/ig-NG/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/ig-NG/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ig-NG/django_start_project/README.md b/ig-NG/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/ig-NG/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ig-NG/django_templates/README.md b/ig-NG/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/ig-NG/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ig-NG/django_urls/README.md b/ig-NG/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/ig-NG/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ig-NG/django_views/README.md b/ig-NG/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/ig-NG/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ig-NG/dynamic_data_in_templates/README.md b/ig-NG/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/ig-NG/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ig-NG/extend_your_application/README.md b/ig-NG/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/ig-NG/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ig-NG/how_the_internet_works/README.md b/ig-NG/how_the_internet_works/README.md
new file mode 100644
index 00000000000..e842be16d31
--- /dev/null
+++ b/ig-NG/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Otu Intanetị si arụ ọrụ
+
+> Maka ndị na-agụ akwụkwọ n’ụlọ: a kọwara isiakwụkwọ na vidiyo- Otu Intanet si arụ ọrụ.
+> 
+> Isi okwu a kpalitere n'okwu "Otu Intanet si arụ ọrụ" nke Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+Anyị na-ekwenye na ị na-eji Intaneti kwa ụbọchị. Mana ị maara n'ezie ihe na-eme mgbe ị pịnyere adreesị dị ka https://djangogirls.org n'ime ihe nchọgharị gị wee pịa `enter`?
+
+Ihe mbụ ikwesiri ighọta bụ na webụsaiti nwere ọtụtụ faịlụ echekwara na diski ike - dika ihe nkiri, egwu, ma ọbu ihe onyonyo/foto gi Agbanyeghị, enwere otu ebe pụrụ iche maka webụsaịtị: ha gụnyere koodu kọmputa akpọrọ HTML.
+
+Ọ bụrụ na ị maghị programin, o nwere ike isiri gị ike ịghọta HTML na mbụ, mana ihe nchọgharị weebụ gị (dịka Chrome, Safari, Firefox, wdg) dị ya mma. E mere ihe nchọgharị weebụ iji ghọta koodu a, soro ntuziaka ya, ma gosipụta faịlụ ndị a eji mee weebụsaịtị gị, otu ị chọrọ.
+
+Dị ka faịlụ ọ bụla, anyị kwesịrị ịchekwa faịlụ HTML n'ebe dị iche na diski ike Maka Intanet, anyị na-eji kọmputa pụrụ iche, nke dị ike a na-akpọ server. Ha enweghị ihuenyo, mouse ma ọ bụ ahụigodo, n'ihi na isi nzube ha bụ ịchekwa data ma jeere ya ozi. Ọ bụ ya mere eji akpọ ha server - n'ihi na ha na - enye gị data.
+
+Ọ dị mma, mana ịchọrọ ịma ka ịntanetị si dị?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ig-NG/html/README.md b/ig-NG/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/ig-NG/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ig-NG/installation/README.md b/ig-NG/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/ig-NG/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ig-NG/intro_to_command_line/README.md b/ig-NG/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/ig-NG/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ig-NG/intro_to_command_line/open_instructions.md b/ig-NG/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/ig-NG/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ig-NG/python_installation/README.md b/ig-NG/python_installation/README.md
new file mode 100644
index 00000000000..55abd689f97
--- /dev/null
+++ b/ig-NG/python_installation/README.md
@@ -0,0 +1,15 @@
+# Ka anyị bido na Python
+
+Anyị erutego ebe a n'ikpeazụ!
+
+Mana nke mbu, ka anyị gwa gị ihe Python bụ. Python bụ asụsụ mmemme a ma ama nke enwere ike iji ya mepụta weebụsaịtị, egwuregwu, sọftụware sayensị, eserese, na ọtụtụ ihe ndị ọzọ.
+
+Python sitere na ngwụsị 1980s ma ebum n’uche ya bu ka ndi mmadu nwe ike i guru ya (obughi nani igwe!). Nke a bụ ya mere na ọ dị mfe karịa n'asụsụ mmemme ndị ọzọ, mana echegbula - Python dịkwa ike n'ezie!
+
+# Nwụnye Python
+
+> **Ndetu** Ọ bụrụ na ị na-eji Chromebook, hapu ebe a ma gbaa mbọ hụ na ị na-eso [ntuziaka ](../chromebook_setup/README.md)Chromebook .
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ig-NG/python_installation/instructions.md b/ig-NG/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/ig-NG/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ig-NG/python_introduction/README.md b/ig-NG/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/ig-NG/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ig-NG/template_extending/README.md b/ig-NG/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/ig-NG/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ig-NG/whats_next/README.md b/ig-NG/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/ig-NG/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/ig/GLOSSARY.md b/ig/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/ig/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/ig/README.md b/ig/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/ig/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ig/SUMMARY.md b/ig/SUMMARY.md
new file mode 100644
index 00000000000..7a45700a27d
--- /dev/null
+++ b/ig/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/ig/chromebook_setup/README.md b/ig/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/ig/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ig/chromebook_setup/instructions.md b/ig/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/ig/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ig/code_editor/README.md b/ig/code_editor/README.md
new file mode 100644
index 00000000000..404011f1b7d
--- /dev/null
+++ b/ig/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ig/code_editor/instructions.md b/ig/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/ig/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ig/css/README.md b/ig/css/README.md
new file mode 100644
index 00000000000..04d5996ae52
--- /dev/null
+++ b/ig/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/ig/deploy/README.md b/ig/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/ig/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/ig/deploy/install_git.md b/ig/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ig/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ig/deploy/signup_pythonanywhere.md b/ig/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/ig/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ig/django/README.md b/ig/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/ig/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/ig/django_admin/README.md b/ig/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/ig/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ig/django_forms/README.md b/ig/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/ig/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/ig/django_installation/README.md b/ig/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/ig/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ig/django_installation/instructions.md b/ig/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/ig/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ig/django_models/README.md b/ig/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/ig/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ig/django_orm/README.md b/ig/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/ig/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ig/django_start_project/README.md b/ig/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/ig/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ig/django_templates/README.md b/ig/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/ig/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ig/django_urls/README.md b/ig/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/ig/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/ig/django_views/README.md b/ig/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/ig/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/ig/dynamic_data_in_templates/README.md b/ig/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/ig/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/ig/extend_your_application/README.md b/ig/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/ig/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/ig/how_the_internet_works/README.md b/ig/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/ig/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ig/html/README.md b/ig/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/ig/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ig/install_git.md b/ig/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ig/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ig/installation/README.md b/ig/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/ig/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ig/instructions.md b/ig/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/ig/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ig/intro_to_command_line/README.md b/ig/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/ig/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ig/python_installation/README.md b/ig/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/ig/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ig/python_installation/instructions.md b/ig/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/ig/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ig/python_introduction/README.md b/ig/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/ig/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ig/signup_pythonanywhere.md b/ig/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/ig/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ig/template_extending/README.md b/ig/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/ig/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ig/whats_next/README.md b/ig/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/ig/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/it-IT/GLOSSARY.md b/it-IT/GLOSSARY.md
new file mode 100644
index 00000000000..5ebfa17670a
--- /dev/null
+++ b/it-IT/GLOSSARY.md
@@ -0,0 +1,3 @@
+# editor di codice
+
+L'editor di codice è un'applicazione che ti permette di salvare il tuo codice e di potervi tornare in seguito. Puoi capire come procurartene uno nel [capitolo Editor di codice](./code_editor/README.md)
\ No newline at end of file
diff --git a/it-IT/README.md b/it-IT/README.md
new file mode 100644
index 00000000000..bbeb397c717
--- /dev/null
+++ b/it-IT/README.md
@@ -0,0 +1,51 @@
+# Il tutorial di Django Girls
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Questo lavoro è concesso sotto la licenza Creative Commons Attribuzione-ShareAlike 4.0 internazionale. Per visualizzare una copia di questa licenza, visita https://creativecommons.org/licenses/by-sa/4.0/
+
+## Benvenuta
+
+Benvenuta al tutorial Django Girls! Siamo felici di vederti qui. :) In questo tutorial, vi porteremo in un viaggio nella sfera delle tecnologie web, offrendovi uno sguardo di tutti i bit e pezzi che hanno bisogno di stare insieme per far funzionare il web così come lo conosciamo.
+
+Come per tutte le cose sconosciute, questa sarà un'avventura - ma non preoccupatevi, dal momento che hai già avuto il coraggio di arrivare fino a qui, andrà tutto bene :)
+
+## Introduzione
+
+Hai mai avuto l'impressione che il mondo stia diventando sempre più tecnologico e di essere per così dire (temporaneamente) rimasta indietro? Ti sei mai chiesta come creare un sito web ma non hai mai avuto abbastanza motivazione per iniziare? Hai mai pensato che il mondo del software è troppo complicato per te persino per provare a fare qualcosa per conto tuo?
+
+Beh, abbiamo buone notizie per te! La programmazione non è così complicata come sembra e vogliamo dimostrarti quanto può essere divertente.
+
+Questo tutorial non ti trasformerà magicamente in una programmatrice. Se vuoi diventare brava, ci vorranno mesi o addirittura anni di apprendimento e pratica. Ma ti vogliamo dimostrare che scrivere programmi o creare siti web non è complicato come sembra. Proveremo a spiegarti diversi argomenti come meglio possiamo, in modo che non ti senta più intimidita dalla tecnologia.
+
+Speriamo di riuscire a farti amare la tecnologia come la amiamo noi!
+
+## Cosa imparerai durante questo tutorial?
+
+Una volta terminato il tutorial, avrai creato una piccola applicazione web funzionante: il tuo blog personale. Ti mostreremo come metterlo online, in modo che gli altri possano vedere il tuo lavoro!
+
+Assomiglierà (più o meno) a questo:
+
+![Figure 0.1](images/application.png)
+
+> Se lavori da sola al tutorial e non hai un insegnante che ti possa aiutare nel caso avessi qualche problema, abbiamo una chat per te: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Abbiamo chiesto ai nostri coach e a coloro che hanno già partecipato di visitare la chat di tanto in tanto per aiutare gli altri con il tutorial! Non aver paura di fare domande!
+
+OK, [cominciamo dall'inizio...](./how_the_internet_works/README.md)
+
+## Seguire il tutorial da casa
+
+È fantastico prendere parte a un workshop Django Girls, ma siamo consapevoli che non sempre è possibile essere presenti a un workshop. Questo è il motivo per cui ti invitiamo a provare a seguire il tutorial da casa. Per chi ci segue da casa, stiamo preparando alcuni video che renderanno più facile seguire il tutorial da sole. È un progetto ancora in corso, ma col tempo gli argomenti trattati sul nostro canale YouTube [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) saranno sempre di più.
+
+In ogni capitolo già trattato, c'è un link che punta al video corrispondente.
+
+## Informazioni e contribuzioni
+
+Questo tutorial è mantenuto da [DjangoGirls](https://djangogirls.org/). Se trovi errori o se vuoi aggiornare questo tutorial, [segui le linee guida per i collaboratori](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Vuoi aiutarci a tradurre il tutorial in altre lingue?
+
+Attualmente le traduzioni vengono svolte sulla piattaforma crowdin.com all'indirizzo:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Se la tua lingua non è elencata su [crowdin](https://crowdin.com/), puoi [aprire una nuova istanza](https://github.com/DjangoGirls/tutorial/issues/new) segnalando la tua lingua, in modo che possiamo aggiungerla.
\ No newline at end of file
diff --git a/it-IT/SUMMARY.md b/it-IT/SUMMARY.md
new file mode 100644
index 00000000000..3dc4d708974
--- /dev/null
+++ b/it-IT/SUMMARY.md
@@ -0,0 +1,35 @@
+# Indice
+
+* [Introduzione](README.md)
+* [Installazione](installation/README.md) 
+  * [Riga di Comando](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [L'editor di codice](installation/README.md#code-editor)
+  * [Ambiente virtuale](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installazione (chromebook)](chromebook_setup/README.md)
+* [Come funziona Internet](how_the_internet_works/README.md)
+* [Introduzione alla command line](intro_to_command_line/README.md)
+* [Istallazione di Python](python_installation/README.md)
+* [L'editor di codice](code_editor/README.md)
+* [Introduzione a Python](python_introduction/README.md)
+* [Che cos'è Django?](django/README.md)
+* [Installazione di Django](django_installation/README.md)
+* [Il tuo primo progetto Django!](django_start_project/README.md)
+* [I modelli di Django](django_models/README.md)
+* [L'admin di Django](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URL](django_urls/README.md)
+* [Le views di Django – è l'ora di creare!](django_views/README.md)
+* [Introduzione all'HTML](html/README.md)
+* [ORM di Django (Querysets)](django_orm/README.md)
+* [I dati dinamici nei template](dynamic_data_in_templates/README.md)
+* [I template di Django](django_templates/README.md)
+* [CSS - rendilo più carino](css/README.md)
+* [Estendere il template](template_extending/README.md)
+* [Estendi la tua applicazione](extend_your_application/README.md)
+* [I Form Django](django_forms/README.md)
+* [E dopo?](whats_next/README.md)
\ No newline at end of file
diff --git a/it-IT/chromebook_setup/README.md b/it-IT/chromebook_setup/README.md
new file mode 100644
index 00000000000..4e4076369f1
--- /dev/null
+++ b/it-IT/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Configurazione del Chromebook
+
+> **Nota** Se hai già completato il processo di installazione, non è necessario rifare tutto e puoi passare direttamente a [Introduzione a Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/it-IT/chromebook_setup/instructions.md b/it-IT/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..c5592f410f8
--- /dev/null
+++ b/it-IT/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Puoi [saltare questa sezione](http://tutorial.djangogirls.org/en/installation/#install-python) se non utilizzi un Chromebook. L'installazione su Chromebook segue una procedura un po' diversa. Il resto delle istruzioni di installazione può essere ignorato.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE è uno strumento che mette a disposizione un editor di codice e l'accesso ad un computer virtuale su cui installare, scrivere ed eseguire il software. In questo tutorial, Cloud IDE avrà la funzione di un *computer locale*. Digiterai i comandi sull'interfaccia di un terminale, come le tue compagne di corso che utilizzano OS X, Ubuntu o Windows, ma il tuo terminale sarà connesso a un computer remoto che Cloud IDE ha creato per te. Puoi trovare di seguito le istruzioni per i Cloud IDE (PaizaCloud IDE, AWS Cloud9, Glitch.com). Puoi selezionare uno dei Cloud IDE e seguire le relative istruzioni.
+
+#### PaizaCloud Cloud IDE
+
+1. Vai su [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Crea un account
+3. Clicca su *Nuovo server* oppure <0>New Server</0> e scegli l'app Django
+4. Seleziona il pulsante Terminal (sul lato sinistro della pagina)
+
+Ora dovresti vedere un'interfaccia con una barra laterale e dei pulsanti sulla sinistra. Fai click sul pulante "Terminal" per aprire la finestra del terminale con il prompt, così:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+Il terminale su PaizaCloud Cloud IDE è pronto a ricevere istruzioni. Puoi ridimensionare la finestra o renderla un po' più più grande.
+
+#### AWS Cloud9
+
+Attualmente Cloud 9 richiede la registrazione con AWS e l'inserimento delle informazioni sulla carta di credito.
+
+1. Installa Cloud9 dal [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Vai su [c9.io](https://c9.io) e clicca *Inizia con AWS Cloud9*
+3. Registra un account AWS (richiede informazioni sulla carta di credito, ma puoi usarlo gratuitamente)
+4. Nella Dashboard di AWS, inserisci *Cloud9* nella barra di ricerca e facci click
+5. Nel cruscotto Cloud 9, clicca su *Crea ambiente*
+6. Chiamalo *django-girls*
+7. Durante la configurazione delle impostazioni, selezionare *Creare una nuova istanza per l'ambiente (EC2)* per "Tipo di Ambiente" e *t2.micro* "Tipo di Istanza" (dovrebbe essere "Free-tier."). L'impostazione di default per il risparmio dei costi va bene e puoi mantenere le altre impostazioni predefinite.
+8. Clicca *Passo Successivo*
+9. Fai click su *Create Environment*
+
+Ora dovresti vedere un'interfaccia con una barra laterale, una grossa finestra principale con del testo, ed una piccola finestra in basso che sembra questa:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+Questa finestra in basso è il tuo terminale. Puoi usare il terminale per inviare istruzioni al computer remoto Cloud9. Puoi cambiare le dimensioni della finestra e renderla più grande.
+
+#### Glitch.com
+
+1. Vai su [Glitch.com](https://glitch.com/)
+2. Crea un account (https://glitch.com/signup) o, se lo possiedi, usa il tuo account GitHub (di seguito puoi trovare le istruzioni su GitHub).
+3. Seleziona *New Project* e scegli *hello-webpage*
+4. Seleziona l'elenco a discesa "Strumenti" (Tools, nella sezione della pagina in basso a sinistra), poi premi sul pulsante Terminale (Terminal) per aprire una scheda terminale con un prompt come il seguente:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+Quando utilizzi Glitch.com come il tuo Cloud IDE, non è necessario creare un ambiente virtuale. Puoi invece creare manualmente i seguenti file:
+
+{% 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
+```
+
+Una volta creati i file, vai al Terminale ed esegui i comandi seguenti per creare il tuo primo progetto Django:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+Per poter vedere dettagliatamente i messaggi di errore, puoi attivare i log di debug di Django per la tua applicazione Glitch. Aggiungi semplicemente questa dicitura alla fine del file `mysite/settings.py`.
+
+{% 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,
+        },
+    },
+}
+```
+
+Questo procedimento creerà un file `debug.log` con i dettagli sulle operazioni effettuate da Django e su eventuali messaggi di errore che potrebbero apparire, rendendone più semplice la correzione se il tuo sito web non funzionasse.
+
+Il riavvio iniziale del progetto Glitch potrebbe fallire. (Se selezioni il pulsante a discesa in alto `Show` e poi `In a New Window`, riceverai il messaggio di errore `DisallowedHost`) Non devi preoccupartene in questa fase, il tutorial lo correggerà non appena aggiorni le impostazioni del tuo progetto di Django nel file `mysite/settings.py`.
+
+### Ambiente virtuale
+
+Un ambiente virtuale (virtual environment, spesso abbreviato in virtualenv) è una specie di scatola privata in cui si può inserire un codice informatico per un progetto su cui si sta lavorando. Si usa per mantenere separati i numerosi pezzi di codice dei vari progetti, in modo da non creare confusione tra i progetti stessi.
+
+Esegui:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(N.B. nell'ultima riga abbiamo usato una tilde seguita dal segno uguale: `~=`).
+
+### GitHub
+
+Crea un account [GitHub](https://github.com).
+
+### PythonAnywhere
+
+Il tutorial di Django Girls include una sezione su ciò che viene definito Deployment, ovvero il processo durante il quale si estrae il codice che alimenta la tua nuova applicazione web e lo si sposta su un computer accessibile al pubblico (chiamato server), in modo che altre persone possano vedere il tuo lavoro.
+
+Questa parte del tutorial è un po' insolita se lo si segue su un Chromebook, siccome stiamo usando un computer che è già su internet (al contrario di un laptop, per esempio). È comunque utile, se consideriamo il nostro Cloud 9 come uno spazio per il nostro lavoro "in corso" e Python Anywhere come uno spazio per mostrare il nostro materiale quando è più completo.
+
+Quindi, registra il tuo nuovo account Python Anywhere su [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/it-IT/code_editor/README.md b/it-IT/code_editor/README.md
new file mode 100644
index 00000000000..13c4af12926
--- /dev/null
+++ b/it-IT/code_editor/README.md
@@ -0,0 +1,11 @@
+# L'editor di codice
+
+> Per i lettori a casa: questo capitolo è trattato nel video [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+Stai per scrivere la tua prima riga di codice, per cui è il momento di scaricare il tuo editor!
+
+> **Nota** Se utilizzi un Chromebook, salta questo capitolo e segui le istruzioni in [Configurazione di Chromebook](../chromebook_setup/README.md). L'IDE cloud che sceglierai (PaizaCloud Cloud IDE o AWS Cloud9) include un editor di codice, e quando aprirai un file nel tuo IDE dal menu File, utilizzerai automaticamente l'editor.
+> 
+> **Nota** Potresti aver già effettuato questo passaggio nel capitolo sull'installazione. Se così fosse, puoi passare al prossimo capitolo!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/it-IT/code_editor/instructions.md b/it-IT/code_editor/instructions.md
new file mode 100644
index 00000000000..91cf3472e78
--- /dev/null
+++ b/it-IT/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Ci sono moltissimi editor diversi e la scelta dipende in gran parte dalle proprie preferenze. La maggior parte dei programmatori Python usa IDE (in inglese Integrated Development Environments, ambienti di sviluppo integrati) complessi ma estremamente potenti, come PyCharm. Tuttavia questo non è l'editor più appropriato per una principiante; quelli che ti suggeriremo noi sono ugualmente potenti, ma molto più semplici.
+
+Qui di seguito te ne consigliamo alcuni, ma puoi chiedere al tuo coach quali editor preferisce - in modo che possa aiutarti più facilmente.
+
+## Codice Studio Visual
+
+Visual Studio Code è un editor di codice sorgente sviluppato da Microsoft per Windows, Linux e macOS. Include il supporto per il debug, il controllo Git incorporato, l'evidenziazione della sintassi, il completamento intelligente del codice, gli snippet e il refactoring del codice.
+
+[Scaricalo qui](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit è un editor open-source e gratuito, disponibile per tutti i sistemi operativi.
+
+[Scaricalo qui](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text è tra gli editor più utilizzati. Ha un periodo di prova gratuito ed è disponibile per tutti i sistemi operativi.
+
+[Scaricalo qui](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom è un altro editor molto diffuso. È gratuito, open-source e disponibile per Windows, OS X e Linux. Atom è sviluppato da [GitHub](https://github.com/).
+
+[Scaricalo qui](https://atom.io/)
+
+## Perché installare un editor di codice?
+
+Forse ti stai chiedendo per quale motivo installiamo questo editor di codice, invece di usare un'applicazione come Word o Blocco Note.
+
+La prima ragione è che il codice deve essere **testo semplice**, e programmi come Word e Textedit non producono questo tipo di testo, ma testo formattato (con font e formattazione), codificato in formati come l'[RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+La seconda ragione è che gli editor sono specializzati nel modificare codice, e quindi mettono a disposizione utili funzionalità come l'evidenziazione della sintassi con colori legati al suo significato, o la chiusura automatica di parentesi e virgolette.
+
+Vedremo tutto ciò più avanti. Presto, il tuo fidato editor di testo diventerà uno dei tuoi strumenti preferiti. :)
\ No newline at end of file
diff --git a/it-IT/css/README.md b/it-IT/css/README.md
new file mode 100644
index 00000000000..e5be23e1df1
--- /dev/null
+++ b/it-IT/css/README.md
@@ -0,0 +1,330 @@
+# CSS - rendilo carino!
+
+Il nostro blog sembra ancora bruttino, vero? È arrivato il momento di abbellirlo! Per fare ciò useremo i CSS.
+
+## Che cosa sono i CSS?
+
+I CSS (Cascading Style Sheet, fogli di stile a cascata) servono a descrivere l'aspetto e la formattazione di un sito web scritto in un linguaggio di Markup (come l'HTML). Vedilo come il make-up per la nostra pagina web. ;)
+
+Ma non vogliamo iniziare di nuovo dalle basi, vero? Ancora una volta, useremo qualcosa che i programmatori hanno rilasciato su internet gratuitamente. Reinventare la ruota non è divertente, come saprai.
+
+## Usiamo Bootstrap!
+
+Bootstrap è uno dei framework HTML e CSS più poplari per sviluppare bellissimi siti web: https:/getbootstrap.com/
+
+È stato scritto dai programmatori che lavoravano per Twitter. Adesso è sviluppato da volontari provenienti da tutto il mondo!
+
+## Installare Bootstrap
+
+Per installare Bootstrap, apri il tuo file `.html` nell'editor di codice e aggiungi la riga seguente alla sezione `<head>`:
+
+{% filename %}blog/templates/blog/post_list{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Queste righe non aggiungono nessun file al tuo progetto. Puntano solo ad altri file già esistenti siu Internet. Quindi avanti, apri il tuo sito e ricarica la pagina. Ecco qua!
+
+![Figura 14.1](images/bootstrap1.png)
+
+Sembra già più carino!
+
+## File statici in Django
+
+Infine, daremo uno sguardo più approfondito a quelli che abbiamo chiamato **file statici**. I file statici sono tutti i tuoi CSS e le tue immagini. Il loro contenuto non dipende dal contesto richiesto e sarà lo stesso per tutti gli utenti.
+
+### Dove mettere i file statici in Django
+
+Django sa già dove trovare file statici per l'app integrata "admin". Ora dobbiamo aggiungere alcuni file statici per la nostra app, `blog`.
+
+Lo facciamo creando una cartella denominata `static` all'interno dela nostra app blog:
+
+    djangogirls
+    ├── blog
+    |     ├── migrations
+    |     ├── static
+    |     └── templates
+    └── mysite
+    
+
+Django trova automaticamente ogni cartella chiamata ''static'' all'interno di qualsiasi cartella della tua app. Quindi potrà usarne il contenuto come file statici.
+
+## Il tuo primo file CSS!
+
+Creiamo un file CSS, per aggiungere uno stile alla tua pagina web. Crea una nuova cartella dal nome `css` all'interno della tua cartella `static`. Poi, crea un nuovo file all'interno della tua cartella `css` e chiamalo `blog.css`. Fatto?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+È il giunto il momento di scrivere un po' di CSS! Apri il file `static/css/blog.css` nel tuo editor di codice.
+
+Non approfondiremo l'apprendimento dei CSS in questa sede. Se vuoi saperne di più, in fondo a questa pagina ti consigliamo un corso gratuito.
+
+Facciamo comunque un esempio. Vogliamo cambiare il colore del nostro header? Per decifrare i colori, i computer usano dei codici speciali. Questi codici iniziano con `#` seguiti da 6 lettere (A–F) e numeri (0–9). Per esempio, questo è il codice per il blu `#0000FF`. Puoi trovare i codici per molti colori qui: http://www.colorpicker.com/. Puoi anche usare [colori predefiniti](http://www.w3schools.com/colors/colors_names.asp) come ad esempio `red` e `green`.
+
+Aggiungi il seguente codice nel tuo file `static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` è un esempio di selettore CSS. Significa che stiamo applicando i nostri fogli di stile ad ogni elemento `a` all'interno di un elemento `h1`; il selettore `h2 a` si comporta allo stesso modo con gli elementi `h2`. Quindi quando si ha qualcosa come `<h1><a href="">link</a></h1>`, lo stile `h1 a` verrà applicato. In questo caso stiamo impostando il colore `#C25100`, che corrisponde all'arancione scuro. Puoi inserire il colore che preferisci, ma assicurati che ci sia un buon contrasto con lo sfondo bianco!
+
+In un file CSS definiamo lo stile degli elementi presenti nel file HTML. Il primo modo per identificare gli elementi è attraverso il loro nome. Potresti ricordarli come tags dalla sezione sull'HTML. Cose come `a`, `h1` e `body` sono tutti esempi di nomi di elementi. Possiamo identificare anche con l'attributo `class` o l'attributo `id`. Class e id sono i nomi che assegni agli elementi. Le classi definiscono gruppi di elementi mentre gli id indicano uno specifico elemento. Per esempio, potresti identificare il seguente elemento utilizzando il nome dell'elemento `a`, la classe `external_link`, o l'ID`link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Puoi leggere di più su i [Selettori CSS su w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+Inoltre dobbiamo dire al nostro template HTML che abbiamo aggiunto del codice CSS. Apri il file `blog/templates/blog/post_list.html` nell'editor di codice e aggiungi questa riga all'inizio:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Qui stiamo semplicemente caricando file statici. :) Tra i tag `<head>` e `</head>`, dopo il link ai file CSS di Bootstrap, aggiungi la riga seguente:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Il browser legge i file nell'ordine in cui sono messi, quindi dobbiamo essere sicuri che sia nel posto giusto. Altrimenti il codice del nostro file potrebbe essere sovrascritto dal codice dei file di Bootstrap. Stiamo dicendo al nostro template dove trovare i nostri file CSS.
+
+Il tuo file dovrebbe avere questo aspetto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, salviamo il file e ricarichiamo la pagina web!
+
+![Figura 14.2](images/color2.png)
+
+Ben fatto! Adesso potremmo dare un po' più d'aria alla nostra pagina web e aumentare il margine nella parte sinistra. Proviamo!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Aggiungi queste righe al tuo CSS, salva il file e guarda il risultato!
+
+![Figura 14.3](images/margin2.png)
+
+Potremmo anche personalizzare lo stile calligrafico nel nostro header. Incolla quanto segue all'interno del tag `<head>` che si trova nel file `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Come prima, controlla l'ordine e la posizione prima del link a `blog/static/css/blog.css`. Questa riga di codice importerà un carattere chiamato *Lobster* da Google Fonts (https://www.google.com/fonts).
+
+Trova il blocco `h1 a` (il codice tra parentesi `{` e `}`) nel file CSS `blog/static/css/blog.css`. Ora aggiungi la riga `font-family: 'Lobster';` tra le parentesi e ricarica la pagina:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+   color: #C25100;
+   font-family: 'Lobster';
+}
+```
+
+![Figura 14.3](images/font.png)
+
+Grandioso!
+
+Come già detto in precedenza, CSS possiede il concetto di classi. Questo ti permette identificare una parte del codice HTML e applicare lo stile solo su quella parte, senza modificare le altre. Questo è utilissimo! Potresti avere due div che hanno qualcosa di differente (come il tuo header e il tuo post). Una classe ti aiuta a renderli differenti.
+
+Vai avanti e chiama alcune parti del codice HTML. Sostituisci l'`intestazione` che contiene l'intestazione con quanto segue:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+E ora aggiungi una classe `post` al tuo `articolo` che contiene un post del blog.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Ora aggiungiamo dei blocchi di codice ai nostri nuovi selettori. I selettori che iniziano con `.` indicano una classe. Sul Web ci sono diversi ottimi tutorial e spiegazioni sui CSS che possono aiutarti a capire il codice che stiamo per scrivere. Per ora, copia e incolla quanto segue nel tuo file `blog/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Ora aggiungi all'esterno del codice HTML riguardante i posts all'interno del blog alcuni elementi con definizione di classi. Sostituisci questo:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+nel file `blog/templates/blog/post_list.html` con quanto segue:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Salva entrambi i file e ricarica la pagina web.
+
+![Figura 14.4](images/final.png)
+
+Woohoo! È fantastico, vero? Guarda il codice che abbiamo appena incollato, per trovare i punti dove abbiamo aggiunto le classi nell'HTML usate nel CSS. Dove dovremmo modificare se volessimo la data in azzurro?
+
+Non aver paura di fare qualche esperimento con i CSS, prova a fare qualche modifica. Giocare con i CSS può aiutarti a capire cosa fanno le varie cose. Se fai qualche errore, non preoccuparti - puoi sempre tornare indietro!
+
+Consigliamo vivamente di seguire i corsi online gratuiti di "Basic HTML & HTML 5" e "Basic CSS" su [freeCodeCamp](https://learn.freecodecamp.org/). Possono aiutarti ad imparare tutto sul creare siti web più carini in HTML e CSS.
+
+Pronta per il prossimo capitolo?! :)
\ No newline at end of file
diff --git a/it-IT/deploy/README.md b/it-IT/deploy/README.md
new file mode 100644
index 00000000000..7cd3cbfbcb2
--- /dev/null
+++ b/it-IT/deploy/README.md
@@ -0,0 +1,246 @@
+# Pubblica Online!
+
+> **Nota** Il seguente capitolo può essere un po' difficile da fare fino in fondo. Non mollare e cerca di portarlo a termine; la pubblicazione online è una parte importante nel processo di costruzione di un sito web. Questo capitolo è collocato a metà del tutorial in modo che il tuo coach ti possa aiutare con il processo leggermente più complicato di messa online del sito. Questo significa che puoi ancora finire il tutorial per conto tuo se sei a corto di tempo.
+
+Fino ad ora il tuo sito web è stato presente solo sul tuo computer. Adesso imparerai come implementarlo! L'implementazione è il processo di pubblicazione online del tuo progetto in modo tale che sia visibile anche da altre persone. :)
+
+Come abbiamo imparato, un sito Web deve trovarsi su un server. Ci sono molti server provider disponibili su Internet, noi useremo [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere è gratuito per le piccole applicazioni che non hanno troppi visitatori, sarà quindi perfetto per te al momento.
+
+L'altro servizio esterno che useremo è [GitHub](https://www.github.com), che è un servizio di hosting di codice. Ne esistono altri, ma oggigiorno quasi tutti i programmatori hanno un account GitHub e ora lo avrai anche tu!
+
+Questi tre servizi saranno importantissimi per te. Userai il tuo computer locale per sviluppare e fare test. Quando sarai soddisfatto delle modifiche, caricherai una copia del tuo programma su GitHub. Il tuo sito Web sarà su PythonAnywhere e lo aggiornerai con una nuova copia del codice da GitHub.
+
+# Git
+
+> **Nota** Se hai già terminato il processo di installazione, non é necessario eseguire nuovamente questa operazione. Puoi passare alla sezione successiva e iniziare a creare il tuo repository Git.
+
+{% include "/deploy/install_git.md" %}
+
+## Inizializzare un repository Git
+
+Git tiene traccia delle modifiche a un particolare insieme di file in quello che è chiamato repository di codice (o "repo" in breve). Iniziamone uno per il nostro progetto. Apri la console ed esegui questi comandi nella directory `djangogirls`:
+
+> **Nota** Controlla la tua cartella di lavoro corrente con a`pwd`(Mac OS X/Linux) o`cd` (Windows) comando prima di inizziare il repository. Dovresti essere nella cartella `djangogirls`.
+
+{% filename %}comando-linea{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+L'inizializzazione del repository git é qualcosa che dobbiamo fare una sola volta per progetto (e non dovrai piú reinserire il nome utente e l'indirizzo email).
+
+Git memorizzerà le modifiche a tutti i file e le cartelle in questa directory, ma ci sono alcuni file che vogliamo ignorare. Si fa creando un file chiamato `.gitignore` nella directory di base. Apri il tuo editor e crea un nuovo file con questo contenuto:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+E salvalo come `.gitignore` all'interno della cartella "djangogirls".
+
+> **Nota** Il punto all'inizio del nome del file è importante! Se hai difficoltá a crearlo (per esempio, Mac non piacere creare file che iniziano con un punto attraverso il Finder), usa la funzione "salva con nome" nell'editor, é a prova di proiettile. E assicurati di non aggiungere `.txt`, `.py`, o qualsiasi altra estensione al nome del file -- sarà riconosciuto da Git solo se il nome è `.gitignore`. Linux e MacOS trattano i file con un nome che inizia con `.` (come `.gitignore`) come nascosti ed il comando `Is` normale non mostrerà questi file. Invece usa `Is - a` per vedere il file `.gitignore`.
+> 
+> **Nota** Uno dei file che hai specificato nel tuo file `.ginignore` è `db.sqlite3`. Questo file è il tuo database locale, in cui sono archiviati i post e gli utenti. Seguiremo le pratiche standard di programmazione web, ovvero useremo due diversi database: uno per il sito con cui effettuarai i test locali, e uno per il sito online su PythonAnywhere. Come database PythonAnywhere potresti usare SQLite, ma ne userai più spesso uno che si chiama MySQL, che può gestire molti più vsitatori di SQLite. In entrambi i casi, ignorando il database SQLite per la copia di GitHub, vuol dire che tutti i post che hai creato finora saranno solo disponibili localmente, ma li aggiungeremo nuovamente in produzione. Dovresti pensare al database locale come un parco giochi dove si possono provare cose diverse e senza avere paura di eliminare i tuoi messaggi reali dal tuo blog.
+
+È una buona idea usare il comando `git status` prima di `git add` oppure ogni volta che non sei sicuro di cosa sia cambiato. Questo aiuterà ad evitare eventuali brutte sorprese, come file sbagliati che vengono aggiunti o a cui viene fatto il commit. Il comando `git status` restituisce informazioni riguardanti qualsiasi file non tracciato/modificato/in staging, lo stato del branch e molto altro. L'output dovrebbe essere simile a quanto segue:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+E finalmente salviamo le nostre modifiche. vai alla tua console ed esegui questi comandi:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pubblica il tuo codice su GitHub
+
+Vai su [GitHub.com](https://www.github.com) e crea un nuovo account gratuito. (Se lo hai già fatto nella preparazione al workshop, benissimo!) Assicurati di ricordare la tua password (aggiungila al tuo password manager, se ne usi uno).
+
+Quindi, crea un nuovo repository con il il nome "my-first-blog". Lascia deselezionata la casella di controllo "initialise with a README", lascia vuota l'opzione .gitignore (lo abbiamo già fatto manualmente) e lascia License su None.
+
+![](images/new_github_repo.png)
+
+> **Nota** Il nome `my-first-blog` è importante -- potresti sceglierne un altro, ma il nome verrà ripetuto un sacco di volte nelle istruzioni qui sotto, e dovresti sostituirlo ogni volta. Probabilmente è più facile mantenere il nome `my-first-blog`.
+
+Sulla prossima schermata, ti sarà mostrato il tuo clone URL ricopiato, che userai in alcuni dei comandi che seguono:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Ora dobbiamo collegare il repository Git sul tuo computer a quello su GitHub.
+
+Digita quanto segue sulla tua console (sostituisci `<your-github-username>` con il nome utente che hai inserito quando hai creato l'account GitHub, ma senza le parentesi angolari -- l'URL dovrebbe coincidere con L'URL clone che hai appena visto):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Quando si spinge su GitHub, ti verrà chiesto il tuo nome utente e password GitHub (o nella finestra di comando o in una finestra pop-up), e dopo aver inserito le credenziali si dovrebbe vedere qualcosa di simile a questo:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Adesso Il tuo codice è su GitHub. Guarda! Lo troverai in buona compagnia - [Django](https://github.com/django/django), il [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial) e molti grandi progetti di software open source caricano il proprio codice su GitHub. :)
+
+# Configurare il nostro blog su PythonAnywhere
+
+## Crea un account PythonAnywhere
+
+> **Nota** Potresti aver già creato un account PythonAnywhere prima, durante la fase di installazione - in questo caso, non c'è bisogno di crearlo di nuovo.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configurare il nostro sito su PythonAnywhere
+
+Torna alla [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) principale cliccando sul logo e scegli l'opzione per avviare una console "Bash” - questa è la versione PythonAnywhere di una riga di comando, proprio come quella sul tuo computer.
+
+![La sezione 'Nuova Console' sull'interfaccia web PythonAnywhere, con un pulsante per 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Nota** PythonAnywhere si basa su Linux, quindi se sei su Windows, la console apparirà un po' diversa da quella del tuo computer.
+
+Per implementare un'applicazione web su PythonAnywhere devi prendere il codice da GitHub, e configurare PythonAnywhere in modo che lo riconosca come un'applicazione web. Puoi farlo manualmente, ma PythonAnywhere ti fornisce uno strumento che farà tutto il lavoro al posto tuo. Prima di tutto installiamolo:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+Ora dovresti leggere: `Collecting pythonanywhere` e un'eventuale riga finale che dice `Successfully installed (...) pythonanywhere- (...)`.
+
+Ora eseguiamo l'helper per configurare automaticamente la nostra applicazione da GitHub. Digita quanto segue nella console su PythonAnywhere (non dimenticare di usare il tuo nome utente di GitHub al posto di `<your-github-username>`) in modo che l'URL corrisponda all'URL clone di GitHub:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+Guardando l'esecuzione, potrai vedere cosa sta facendo:
+
+- Scaricare il tuo codice da GitHub
+- Creare un virtualenv su PythonAnywhere, come quello sul tuo computer
+- Aggiornare il file di impostazioni con alcune impostazioni di implementazione
+- Configurare un database su PythonAnywhere utilizzando il comando `manage.py migrate`
+- Configurare i tuoi file statici (di cui parlaremo più avanti)
+- E configurare PythonAnywhere per servire la tua app web tramite la sua API
+
+Su PythonAnywhere tutti questi passaggi sono automatizzati, ma sono gli stessi passaggi che dovresti effettuare con qualsiasi altro server provider.
+
+La cosa principale da notare ora è che il tuo database su PythonAnywhere è completamente separato dal database sul tuo computer, e quindi può avere post e account di amministrazione differenti. Di conseguenza, come abbiamo fatto sul computer, dobbiamo inizializzare l'account di amministrazione con `createsuperuser`. PythonAnywhere ha attivato automaticamente il tuo virtualenv, quindi ora devi solo eseguire il codice seguente:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Inserisci i dettagli per l'utente di amministrazione. È meglio utilizzare gli stessi che stai usando sul computer per evitare confusione, a meno che non desideri rendere la password su PythonAnywhere più sicura.
+
+Ora, se vuoi, puoi anche dare un'occhiata al tuo codice su PythonAnywhere utilizzando `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls 
+    blog db.sqlite3 manage.py mysite requirements.txt static 
+    (ola.pythonanywhere.com) $ ls blog/ 
+    __init__.py __pycache__ admin.py apps.py migrations models.py 
+    tests.py views.py
+    
+
+Puoi anche andare alla pagina "File" e navigare in uso del browser di file integrato di PythonAnywhere. (Dalla pagina Console, puoi raggiungere altre pagine PythonAnywhere dal pulsante menu nell'angolo in alto a destra. Una volta che sei su una delle pagine, ci sono link agli altri vicini all'alto.)
+
+## Ora sei online!
+
+Ora il tuo sito dovrebbe essere stato pubblicato online! Clicca sulla pagina PythonAnywhere per ottenere un link. Puoi condividerlo con chiunque tu voglia :)
+
+> **Nota** Questo è un tutorial per principianti, e nel distribuire questo sito abbiamo preso alcune scorciatoie che non sono ideali dal punto di vista della sicurezza. Se e quando decidi di usare questo progetto in produzione, oppure di avviare un nuovo progetto, dovresti controllare la [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) per alcuni consigli di sicurezza del tuo sito.
+
+## Suggerimenti per il debug
+
+Se si osserva un errore durante l'esecuzione dello script `pa_autoconfigure_django.py`, ecco alcune cause comuni:
+
+- Dimenticare di creare il tuo token API PythonAnywhere.
+- Errore nel tuo URL GitHub
+- Se vedi un errore dicendo * "Non è stato possibile trovare le impostazioni.py"*, probabilmente perché non è riuscito ad aggiungere tutti i file a Git e/o non li hai spinti fino a GitHub con successo. Dai un altro sguardo alla sezione Git qui sopra
+- Se ti sei registrato in precedenza con un account su PythonAnywhere e hai avuto un errore con il comando collectstatic, probabilmente, il tuo account ha una versione un po' vecchia di SQLite (es. 3..2). In tal caso, registrati per un nuovo account e prova i comandi nella sezione PythonAnywhere qui sopra.
+
+Se vedi un errore quando provi a visitare il tuo sito, il primo posto dove cercare qualche info per il debugging è nel tuo **error log**. Troverai un link nella [ scheda Web](https://www.pythonanywhere.com/web_app_setup/) di PythonAnywhere. Vedi se ci sono messaggi di errore lì; i più recenti sono alla fine.
+
+Ci sono alcuni [consigli generali per il debugging sulla wiki di PythonAnywhere](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+E ricorda, il tuo coach è qui per aiutarti!
+
+# Scopri il tuo Elenco di Vita!
+
+La pagina predefinita per il tuo sito dovrebbe dire "Welcome to Django", esattamente come sul tuo Pc locale. Prova ad aggiungere `/admin/` alla fine della URL, e verrai portata al sito di amministrazione. Accedi con il nome utente e la password, e vedrai che puoi aggiungere nuovi post sul server -- ricorda che i post del database di test locale non sono stati inviati al tuo blog live.
+
+Una volta che hai creato un paio di post, puoi tornare indietro alla copia locale (non PythonAnywhere). Da qui in poi, lavori sulla tua copia locale per fare le modifiche. Si tratta di un flusso di lavoro comune nello sviluppo Web (apportare modifiche localmente, inviare quei cambiamenti su GitHub, aggiornare le tue modifiche sul server Web. Questo consente di lavorare e fare esperimenti senza rompere il tuo sito Web. Bello, vero?
+
+Dà a te stessa un' *ENORME* pacca sulla schiena! Il deploy dei server è tra le parti più complicate dello sviluppo web e di solito le persone ci impiegano svariati giorni prima di farli funzionare. Ma hai pubblicato il tuo sito su Internet senza sforzo!
\ No newline at end of file
diff --git a/it-IT/deploy/install_git.md b/it-IT/deploy/install_git.md
new file mode 100644
index 00000000000..e8f07d7ae1b
--- /dev/null
+++ b/it-IT/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git è un "sistema di controllo versione" utilizzato da molti programmatori. Questo software può tracciare le modifiche ai file nel corso del tempo, così da poter ripristinare successivamente una specifica versione. Un po' come la funzione "revisioni" nei programmi di elaborazione di testi (come Microsoft Word o LibreOffice), ma molto più potente.
+
+## Installare Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+È possibile scaricare Git da [git-scm.com](https://git-scm.com/). Puoi saltare tutti i passaggi tranne due: nel passaggio dove ti chiede di scegliere l'editor, dovrai selezionare Nano, e nel passaggio "Regolazione della variabile di ambiente PATH", seleziona "Esegui Git e gli strumenti Unix opzionali dal prompt dei comandi di Windows" (l'opzione in basso). A parte questo, i valori predefiniti vanno bene. 'Checkout Windows-style' e 'commit Unix-style line endings' vanno bene.
+
+Non dimenticare di riavviare il prompt dei comandi o la powershell dopo che l'installazione è terminata con successo. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Scarica Git da [git-scm.com](https://git-scm.com/) e segui le istruzioni.
+
+> **Nota** Se stai usando OS X 10.6, 10.7 o 10.8, dovrai installare la versione di Git da qui: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/it-IT/deploy/signup_pythonanywhere.md b/it-IT/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..4ba19117885
--- /dev/null
+++ b/it-IT/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere è un servizio che permette di eseguire il codice Python sui server "nel cloud". Lo useremo per ospitare il nostro sito, live e su Internet.
+
+Caricheremo il blog che stiamo realizzando su PythonAnywhere. Crea un account "beginner" su PythonAnywhere (l'account gratuito va benissimo, non ti serve una carta di credito).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![Nella pagina di iscrizione di PythonAnywhere c'è il tasto per creare un account 'Principiante' gratuito](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Nota** Quando scegli il tuo nome utente, tieni presente che l'URL del tuo blog assumerá la forma` tuonomeutente.pythonanywhere.com`, quindi scegli il tuo soprannome o un nome che riguardi l'argomento del blog. Inoltre, assicurati di ricordare la tua password (aggiungilo al tuo password manager, se ne usi uno).
+
+## Creazione di un token API PythonAnywhere
+
+Dovrai compiere questo passaggio solo una volta. Dopo aver creato un account su PythonAnywhere, verrai indirizzata alla tua dashboard. Trova il link in alto a destra nella pagina "Account":
+
+![Link account in alto a destra sulla pagina](../deploy/images/pythonanywhere_account.png)
+
+quindi seleziona la scheda chiamata "API token", e premi il pulsante che dice "Crea nuovo token API".
+
+![La scheda token API nella pagina Account](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/it-IT/django/README.md b/it-IT/django/README.md
new file mode 100644
index 00000000000..d9af20a3413
--- /dev/null
+++ b/it-IT/django/README.md
@@ -0,0 +1,27 @@
+# Che cos'è Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) è un framework per applicazioni web gratuito e open source, scritto in Python. Un web framework è un insieme di componenti che ti aiuta a sviluppare siti web più velocemente e facilmente.
+
+Per costruire un sito web ci vogliono sempre componenti molto simili: il sistema per gestire l'autenticazione dell'utente (registrazione, accesso, logout), il pannello di amministrazione del sito, il sistema per caricare i file, ecc.
+
+Non sei la prima e non sarai l'ultima persona ad affrontare questi problemi: altri programmatori prima di te li hanno affrontati e risolti, tanto spesso e tanto ripetitivamente da aver distillato varie *web framework* (Django è una delle tante) che mettono a disposizione tutti gli elementi necessari, pronti per l'uso.
+
+La funzione dei *framework* è evitare di dover reinventare l'acqua calda, e risparmiar tempo nel mettere in piedi un nuovo progetto.
+
+## Perché ho bisogno di un framework?
+
+Per capire bene cosa è Django, a cosa serve davvero, diamo uno sguardo più da vicino ai server. Tanto per incominciare, bisogna che il server sappia che gli si sta chiedendo qualcosa, per esempio una pagina web.
+
+Immagina una cassetta delle lettere (port), che venga continuamente tenuta d'occhio, nel caso arrivino lettere (request). Questo è ciò che fa un server: tiene d'occhio un *port* e sbriga le *request* in arrivo. Un server web legge il contenuto della richiesta ed invia una risposta, sotto forma di pagina web. Ma quando vuoi inviare qualcosa, hai bisogno di avere qualche contenuto. E Django è ciò che ti aiuta a creare questo contenuto.
+
+## Cosa succede quando qualcuno richiede un sito Web dal tuo server?
+
+Quando una richiesta arriva ad un server web, questi lo passa a Django, che la interpreta, per capire cosa si stia richiedendo precisamente. Django esamina prima di tutto l'indirizzo della pagina web richiesta, e decide come proseguire. Di questa parte si occupa lo **urlresolver** di Django, (nota che un indirizzo di una pagina web si chiama URL, che sta per Localizzatore Uniforme di Risorse, cosa che spiega il nome *urlresolver*). Questo urlresolver non è nulla di trascendentale, non fa che raccogliere una serie di schemi e prova a trovare la corrispondenza per lo URL. Django passa in rassegna gli schemi disponibili, ed al primo che si adatti, passa la richiesta alla funzione associata (che si chiama *view*).
+
+Immagina un postino con una lettera. Sta camminando per la strada e controlla ogni numero civico mettendolo a confronto con quello sulla lettera. Se corrisponde, mette lì la lettera. Questo è il modo in cui l'urlresolver funziona!
+
+Nella funzione *view*, è lì che avviene il vero lavoro: per esempio cercare in una base dati l'informazione richiesta. Forse l'utente ha richiesto di cambiare qualcosa all'interno dei suoi dati? Come se una lettera (la richiesta) dicesse: "aggiorna la descrizione del mio lavoro". La *view* verifica se hai autorizzazione a farlo, se sì, accetta il valore ricevuto come nuova descrizione, lo invia al database, e se il database le risponde "ok", la *view* costruisce la risposta alla richiesta iniziale, in modo che Django la possa servire al navigatore web dell'utente.
+
+La descrizione precedente è un tantinello semplificata, ma non c'è ancora bisogno di entrare nei dettagli tecnici. Serve bene per farsi un'idea corretta della interazione.
+
+A questo punto, lasciamo perdere i dettagli, che c'è tempo per impararli, e iniziamo piuttosto ad usare Django per costruire qualcosa. Strada facendo impareremo quello che manca, poco per volta.
\ No newline at end of file
diff --git a/it-IT/django_admin/README.md b/it-IT/django_admin/README.md
new file mode 100644
index 00000000000..ef52410db1f
--- /dev/null
+++ b/it-IT/django_admin/README.md
@@ -0,0 +1,57 @@
+# L'interfaccia admin di Django
+
+Per aggiungere, modificare ed eliminare le pubblicazioni che abbiamo appena modellato, useremo l'amministratore di Django.
+
+Apriamo `blog/admin.py` nell'editore testi e cambiamo il contenuto così:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Come puoi vedere, stiamo importando (include) il modello di Post che abbiamo definito nel capitolo precedente. Per far si che il nostro modello sia visibile nella pagina di admin, dobbiamo registrare questo modello con `admin.site.register(Post)`.
+
+OK, è tempo di guardare il nostro Post. Ricorda di eseguire `python manage.py runserver` nella console per avviare il web server. Vai al tuo browser e digita l'indirizzo http://127.0.0.1:8000/admin/. Vedrai una pagina login simile a questa:
+
+![Login page](images/login_page2.png)
+
+Per accedere, devi creare un *superuser* - un utente che ha pieno controllo di tutto quello che c'è sul sito. Torna alla riga di comando, digita` python manage.py crearesuperutente`, e premi invio.
+
+> Ricorda, per eseguire comandi lasciando in esecuzione il server web, apri una nuova finestra di terminale e attiva il tuo virtualenv. Abbiamo presentato come scrivere nuovi comandi nel capitolo **Il tuo primo progetto Django!**, nella sezione **Avvio del server web**.
+
+{% filename %}Mac OS X o Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Quando te lo richiede, digita il tuo username (minuscole, senza spazi), il indirizzo email, e la password che vorrai utilizzare. **Non allarmarti se non vedi la password mentre scrivi, così funziona.** Digitala, premi `enter`, e continua. Il risultato dovrebbe assomigliare a questo (dove il nome utente e l'email saranno quelli che hai inserito):
+
+    Username: ola
+    Email address: ola@example.com 
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Torna al navigatore web. Fai log in con le credenziali di superuser che hai appena definito, dovresti vedere il pannello di amministrazione di Django.
+
+![Django admin](images/django_admin3.png)
+
+Vai su Posts e giocaci un po', per capire come funziona. Aggiungi cinque o sei post. Non preoccuparti del contenuto — questo è visibile solo a te sul tuo computer personale — puoi fare copia-incolla di parti di questo tutorial per far presto. :)
+
+Fa in modo di avere per lo meno un paio di post (non tutti però) con data di pubblicazione. Ci tornerà utile poi.
+
+![Django admin](images/edit_post3.png)
+
+Se vuoi sapere di più su Django admin, puoi controllare la documentazione ufficiale di Django: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Arrivati a questo punto, wow, mi sembra proprio il caso di prendersi un buon caffè ri-energizzante, una frutta (o magari una camomilla). Hai appena creato il tuo primo modello Django — ti meriti una pausa!
\ No newline at end of file
diff --git a/it-IT/django_forms/README.md b/it-IT/django_forms/README.md
new file mode 100644
index 00000000000..bde835d90ae
--- /dev/null
+++ b/it-IT/django_forms/README.md
@@ -0,0 +1,479 @@
+# Form Django
+
+Infine vogliamo creare un bel modo per poter aggiungere e cambiare in nostri blog posts. Django `admin` è bello, ma è alquanto difficile da personalizzare e rendere carino. Con `forms` avremo il controllo totale sulla nostra interfaccia - possiamo fare praticamente tutto quello ce vogliamo!
+
+La bella cosa dei Django forms è che possiamo sia inventare un nuovo form da zero che creare un `ModelForm` che salverà il risultato del form sul nostro modello.
+
+Questo è esattamente quello che stiamo per fare: stiamo per creare un form per il nostro modello dei `Post`.
+
+Come ogni parte importante di Django, i forms hanno il proprio file: `forms.py`.
+
+Dobbiamo creare un file con questo nome all'interno della cartella `blog`.
+
+    blog
+       └── forms.py
+    
+
+Ok, apriamolo nell'editor di codice e digitiamo quanto segue:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Dobbiamo importare prima di tutto i Django Forms (`from django import forms`) e, ovviamente, il nostro `Post` model (`from .models import Post`).
+
+`PostForm`, come probabilmente hai intuito, è nome del nostro form. Dobbiamo ora dire a Django che questa form é una `ModelForm` (così Django farà qualche magia per noi)- `forms.ModelForm` è il comando per farlo.
+
+Successivamente, abbiamo `class Meta`, con cui diciamo a Django quale model utilizzare per creare questo form (`model = Post`).
+
+Finalmente, possiamo indicare uno o più campi che il nostro form deve avere. In questo caso vogliamo che solamente `title` e `text` siano visibili -`author` è la persona attualmente connessa (tu!) e `created_date` dovrebbe generarsi da sola ogni volta che creiamo un post (cioè nel nostro programma), giusto?
+
+E questo è tutto! Tutto quello che dobbiamo fare ora é usare il form nella nostra *view* e visualizzarlo nel template.
+
+Quindi creeremo di nuovo un link alla pagina, un URL, una view e un template.
+
+## Link ad una pagina usando il form
+
+Prima di aggiungere il link, abbiamo bisogno di alcune icone da usare come pulsanti per il link. Per questo tutorial, scarica [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) e salvalo nella cartella `blog/templates/blog/icons/`
+
+> Nota: Per scaricare l'immagine SVG, aprire il menu contestuale sul link (di solito facendo clic destro su di essa) e selezionare "Salva collegamento come". Nella finestra di dialogo che ti chiede dove salvare il file, vai alla directory `djangogirls` del tuo progetto Django, e all'interno di questo fino alla sottodirectory `blog/templates/blog/icons/`, e salvare il file lì.
+
+È ora di aprire `blog/templates/blog/base.html` nell'editor di codice. Ora possiamo usare questo file di icone all'interno del modello di base come segue. Nell'elemento `div` all'interno della sezione `header` , aggiungeremo un link prima dell'elemento `h1`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Nota che vogliamo chiamare la nostra nuova view `post_new`. L'[icona SVG](https://icons.getbootstrap.com/icons/file-earmark-plus/) è fornita dal [Bootstrap Icons](https://icons.getbootstrap.com/) e mostrerà un'icona di pagina con il segno 'più'. Utilizziamo una direttiva sui modelli Django chiamata `include`. Questo immetterà il contenuto del file nel modello Django. Il browser web sa come gestire questo tipo di contenuto senza ulteriori elaborazioni.
+
+> Puoi scaricare tutte le icone di Bootstrap [qui](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Scompattare il file e copiare tutti i file immagine SVG in una nuova cartella all'interno `blog/templates/blog/` chiamata `icone`. In questo modo è possibile accedere a un'icona come `pencil-fill.svg` utilizzando il percorso del file `blog/templates/blog/icons/pencil-fill.svg`
+
+Dopo aver modificato la riga, il file HTML dovrebbe ora assomigliare a questo:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Dopo aver salvato e aggiornato la pagina http://127.0.0.1:8000 vedrai un errore che già conosci: `NoReverseMatch`. Lo vedi? Bene!
+
+## URL
+
+Apriamo `blog/urls.py` nell'editor di codice e aggiungiamo:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+E il codice finale sarà così:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+Dopo aver aggiornato il sito, vedremo un `AttributeError` dal momento che non abbiamo la view `post_new` implementata. Aggiungiamolo, adesso.
+
+## post_new view
+
+È ora di aprire i `blog/views. y` file nell'editor di codice e aggiungere le seguenti righe con il resto delle `da` righe:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+E poi la nostra *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Per creare un nuovo modulo `Post`, dobbiamo richiamare `PostForm()` e passarlo nel nostro modello. Torneremo sulla *view* in seguito, ma per ora creiamo velocemente un modello per il modulo.
+
+## Template
+
+Dobbiamo creare un file `post_edit. tml` nella directory `blog/templates/blog` , e aprilo nell'editor di codice. Per far si che un modulo funzioni, abbiamo bisogno di diverse cose:
+
+* Dobbiamo visualizzare il form. Possiamo farlo con (ad esempio) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* La riga sopra deve essere racchiuso con un elemento di forma HTML: `<form method="POST">...</form>`.
+* Ci serve un `Save` pulsante. Possiamo fare Ciò con HTML button: `<button type="submit">Save</button>`.
+* E infine, subito dopo l'apertura `<form ...>` abbiamo bisogno di aggiungere {% raw %}`{% csrf_token %}`{% endraw %}. Questo passaggio è molto importante dal momento che rende il nostro form sicuro! Se dimentichi di questo bit, Django si lamenterà quando tenterai di salvare il modulo:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, quindi vediamo come dovrebbe apparire l'HTML in `post_edit.html`:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+     <h2>New post</h2>
+     <form method="POST" class="post-form">{% csrf_token %}
+         {{ form.as_p }}
+         <button type="submit" class="save btn btn-default">Save</button>
+     </form>
+{% endblock %}
+```
+
+Aggiorna la pagina! Yay! Il tuo modulo è visualizzato!
+
+![Nuovo Modulo](images/new_form2.png)
+
+Ma, aspetta un momento! Se provi a scrivere qualcosa nei campi`titolo` e `testo` e cerchi di salvare ciò che hai scritto- che cosa succede?
+
+Nulla! Siamo ancora una volta nella stessa pagina e il nostro testo è andato perduto… e nessun nuovo post è stato aggiunto. Quindi cosa è andato storto?
+
+La risposta è: nulla. Dobbiamo solo fare un po' di lavoro in più nella nostra *view*.
+
+## Salvare il form
+
+Apri ancora una volta `blog/views.py`. Attualmente tutto quello che abbiamo nella view `post_new` è:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Quando inviamo il form, veniamo riportati alla stessa view, ma questa volta abbiamo più dati in `request`, in particolare in `request.POST` (il nome non ha nulla a che vedere con un blog "post", bensì con l'inglese "posting", ovvero inviare, in questo caso dati). Ricordate come nel file HTML, la nostra definizione `<form>` aveva la variabile `method="POST"`? Tutti i campi dal modulo sono ora in `request.POST`. Non è necessario rinominare `POST` in nessuna altra maniera (l'unico altro valore valido per `method` è `GET`, ma al momento non abbiamo abbastanza tempo per spiegare la differenza).
+
+Quindi, nella nostra *view* abbiamo due situazioni separate da gestire: prima, quando accediamo la pagina per la prima volta e vogliamo un modulo vuoto, e poi, quando torniamo alla *view* con tutti i dati del modulo che abbiamo appena digitato. Per cui dobbiamo aggiungere una condizione(useremo `if`):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+È ora di riempire i punti `[...]`. Se `metodo` è `POST` allora vogliamo costruire il `PostForm` con dati dal modulo, giusto? Lo faremo come segue:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+La cosa successiva è controllare se il modulo è corretto (tutti i campi obbligatori sono impostati e non sono stati inviati valori errati). Lo facciamo con `form.is_valid()`.
+
+Verifichiamo se il modulo è valido e se è così, possiamo salvarlo!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+In pratica, ci sono due cose da fare: salviamo il modulo con `form.save` e aggiungiamo un autore(dal momento che non c'era nessun campo autore `author` nel modulo `PostForm` e questo campo non può essere lasciato bianco). `commit=False` significa che non vogliamo ancora salvare il modello `Post` - vogliamo aggiungere prima l'autore. La maggior parte del tempo userai `form.save()` senza `commit=False`, ma in questo caso dobbiamo fornirlo. `post.save()` manterrà le modifiche (aggiungendo l'autore) ed un nuovo post del blog è stato creato!
+
+Infine, sarebbe fantastico se potessimo andare immediatamente alla pagina `post_detail` per il nostro post appena creato, giusto? Per fare questo abbiamo bisogno di un'altra importazione:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Aggiungilo all'inizio del tuo file. E ora possiamo dire: "vai alla pagina `post_detail` per il post appena creato":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` è il nome della view su cui vogliamo andare. Ti ricordi che questa *view* ha bisogno della variabile `pk`? Per passare alle views, usiamo `pk=post.pk`, dove `post` è il post appena creato!
+
+OK, abbiamo parlato molto, ma probabilmente vogliamo vedere come appare l'intera *view* ora, giusto?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Vediamo se funziona. Vai alla pagina http://127.0.0.1:8000/post/new/, aggiungi un `titolo` e `testo`, salvalo… e voilà! Il nuovo post è stato aggiunto e siamo reindirizzati alla pagina `post_detail`!
+
+Potresti aver notato che stiamo impostando la data di pubblicazione prima di salvare il post. Più tardi, introdurremo un *pulsante pubblcia* nel **Django Girls Tutorial: Estensioni**.
+
+Fantastico!
+
+> Poiché abbiamo recentemente utilizzato l'interfaccia di admin di Django, il sistema attualmente ritiene che siamo ancora loggati. Ci sono alcune situazioni che potrebbero portarci a disconnetterci (chiusura del browser, riavvio del DB, ecc.). Se, quando si crea un post, si scopre che si stanno ricevendo errori in riferimento alla mancanza di un utente loggato, vai alla pagina admin http://127.0.0.1:8000/admin e accedi di nuovo. Questo risolverà temporaneamente il problema. C'è una correzione permanente che ti aspetta nella sezione degli esercizi extra alla fine del tutorial principale **Compiti: aggiungi sicurezza al tuo sito web!**.
+
+![Registrato con un errore](images/post_create_error.png)
+
+## Validazione del form
+
+E adesso ti dimostreremo quanto siano belli i moduli di Django. Un post del blog deve avere dei campi per il `titolo` ed il `testo`. Nel nostro modello `Post` non abbiamo detto che questi campi (contrariamente a `published_date`) non sono richiesti, quindi Django, di default, si aspetta che siano impostati.
+
+Prova a salvare il modulo senza `titolo` e `testo`. Indovina cosa accadrà!
+
+![Convalida del modulo](images/form_validation2.png)
+
+Django si incarica di verificare che tutti i campi nel nostro modulo siano corretti. Non è fantastico?
+
+## Form di modifica
+
+Ora sappiamo come aggiungere un nuovo post. Ma cosa succede se ne vogliamo cambiarne uno esistente? E' molto simile a quanto abbiamo appena fatto. Creiamo rapidamente alcune cose importanti. (Se non capisci qualcosa, dovresti chiedere al tuo coach o guardare i capitoli precedenti, poiché abbiamo già affrontato tutti questi passi.)
+
+Innanzitutto, salviamo l'icona che rappresenta il pulsante di modifica. Scarica [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) e salvalo nella posizione `blog/templates/blog/icons/`.
+
+Apri `blog/templates/blog/post_detail.html` nell'editor di codice e aggiungi il seguente codice all'interno dell'elemento `article`:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+così che il modello sarà così:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Apri `blog/urls.py` nell'editor del codice e aggiungi questa riga:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+Riutilizzeremo il modello `blog/templates/blog/post_edit.html`, quindi l'ultima cosa che manca è una *view*.
+
+Apriamo `blog/views.py` nell'editor del codice e aggiungiamolo alla fine del file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Questo sembra quasi esattamente la view `post_new`, giusto? Ma non del tutto. Per una, passiamo un parametro `pk` extra da `urls`. Successivamente, otteniamo il modello `Post` che vogliamo modificare con `get_object_or_404(Post, pk=pk)` e poi, quando creiamo un modulo, passiamo questo post come `istanza`, sia quando salviamo il modulo…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…e quando abbiamo appena aperto un modulo con questo post per modificare:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, vedi se funziona! Vai alla pagina `post_detail` . Dovrebbe esserci un pulsante di modifica nell'angolo in alto a destra:
+
+![Pulsante modifica](images/edit_button2.png)
+
+Quando ci clicchi, vedrai il modulo con i nostri post del blog:
+
+![Modificare il modulo](images/edit_form2.png)
+
+Sentiti libero di cambiare il titolo o il testo e salvare le modifiche!
+
+Complimenti! La tua application è sempre più completa!
+
+Se necessiti di altre informazioni sui moduli di Django, dovresti leggere la documentazione: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Sicurezza
+
+Riuscire a creare nuovi post semplicemente cliccando su un link è bellissimo! Ma in questo momento chiunque visiti il tuo sito potrà creare un nuovo post sul blog, e probabilmente non è qualcosa che vuoi. Facciamo spuntare il bottone solo per te e non per gli altri.
+
+Apri `blog/template/blog/base.html` nell'editor del codice, trova il nostro `div` all'interno dell'`intestazione` e il tag di ancoraggio che hai inserito in precedenza. Dovrebbe essere così:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Aggiungeremo un altro tag `{% if %}` , che farà apparire il link solo per gli utenti che hanno effettuato l'accesso nell'admin. In questo momento, è solo voi! Cambia l'elemento `<a>` per farlo assomigliare a questo:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+Questo `{% if %}` causerà l'invio del link al browser solo se l'utente che richiede la pagina è loggato. Questo non protegge completamente la creazione di nuovi post, ma è un buon primo passo. Ci occuperemo di più sicurezza nelle lezioni di estensione.
+
+Ricordi l'icona modifica che abbiamo aggiunto sulla nostra pagina di dettaglio? Vogliamo faro la stessa cosa qui, così le altre persone non potranno editare i post esistenti.
+
+Apri `blog/templates/blog/post_detail.html` nell'editor del codice e trova questa riga:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Cambialo in questo:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Siccome probabilmente sei loggata, se ricarichi la pagina non vedrai differenze. Carica la pagina in un browser diverso o in una finestra incognita (chiamata "InPrivate" in Windows Edge), tuttavia, e vedrai che il link non viene mostrato in alto, e l'icona non viene visualizzata!
+
+## Ultima cosa: ora di fare il deploy!
+
+Vediamo se funziona su PythonAnywhere. È l'ora di ripartire!
+
+* Prima di tutto, esegui il tuo nuovo codice e push fino a GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Poi, in una [console PythonAnywhere Bash](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Ricordati di sostituire `<your-pythonanywhere-domain>` con il sottodominio di PythonAnywhere, senza le parentesi angolo.)
+
+* Infine, salta alla pagina [ "Web" ](https://www.pythonanywhere.com/web_app_setup/) (usa il pulsante menu in alto a destra della console) e premi **Ricarica**. Aggiorna il tuo blog https://subdomain.pythonanywhere.com per vedere le modifiche.
+
+Ecco fatto! Congratulazioni!
\ No newline at end of file
diff --git a/it-IT/django_installation/README.md b/it-IT/django_installation/README.md
new file mode 100644
index 00000000000..d8e3b0195a0
--- /dev/null
+++ b/it-IT/django_installation/README.md
@@ -0,0 +1,7 @@
+# Installazione di Django
+
+> **Nota** Se utilizzi un Chromebook, salta questo capitolo e segui le istruzioni in [Configurazione di Chromebook](../chromebook_setup/README.md).
+> 
+> Se hai terminato il processo di installazione, questo passaggio l'hai già completato e puoi passare direttamente al capitolo successivo!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/it-IT/django_installation/instructions.md b/it-IT/django_installation/instructions.md
new file mode 100644
index 00000000000..a176a4f2ea2
--- /dev/null
+++ b/it-IT/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Parte di questa sezione è basata sul tutorial delle Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Una parte di questo capitolo di basa sul [django-marcador tutorial](http://django-marcador.keimlink.de/), con licenza Creative Commons Attribution-ShareAlike 4.0 International License. Il tutorial di django-marcador è protetto da copyright di Markus Zapke-Gründemann et al.
+
+## Ambiente virtuale
+
+Prima di installare Django, ti vogliamo far installare uno strumento estremamente utile per tenere in ordine l'ambiente in cui programmerai sul tuo computer. Potresti saltare questo passaggio, ma è caldamente consigliato soffermarsi. Se inizi con la migliore configurazione possibile, ti risparmierai un sacco di problemi per il futuro!
+
+Per cui, creiamo ora un **ambiente virtuale** (chiamato anche un *virtualenv*). Virtualenv isolerà la tua configurazione di Python/Django in base ai diversi progetti. Questo significa che qualunque modifica farai su un sito non avrà alcun effetto su tutti gli altri che stai sviluppando. Chiaro ora?
+
+Tutto quello che devi fare è trovare una cartella in cui vuoi creare il `virtualenv`; la tua home directory, ad esempio. Su Windows potrebbe apparire come `C:\Users\Name` (dove `Name` è il nome del tuo login).
+
+> **Nota:** Su Windows, assicurati che la cartella non contenga caratteri accentati o speciali; se il tuo username contiene cartteri accentati, usa una cartella diversa, ad esempio `C:\djangogirls`.
+
+Per questo tutorial useremo una nuova directory `djangogirls` dalla tua home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Ora creeremo un virtualenv dal nome `myvenv`. Questo è il formato del comando generale:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Per creare un nuovo `virtualenv` devi aprire il prompt dei comandi ed eseguire `python -m venv myvenv`. Apparirà così:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Qui `myvenv` è il nome del tuo `virtualenv`. Puoi utilizzare qualsiasi altro nome, ma attieniti a utilizzare le minuscole, a non usare spazi, accenti o caratteri speciali. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Possiamo creare un `virtualenv` sia su Linux che su OS X eseguendo `python3 -m myvenv`. Apparirà così:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` è il nome del tuo `virtualenv`. Puoi usare qualsiasi altro nome, ma utilizza solo minuscole e niente spazi. Inoltre è meglio scegliere un nome breve, in quanto dovrai digitarlo molte volte!
+
+> **NOTA:** Su alcune versioni di Debian/Ubuntu potresti vedere il seguente errore:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In questo caso, segui le istruzioni sopra e installa il pacchetto `python3-venv`: {% filename %}riga di comando{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTA:** In alcune versioni di Debian/Ubuntu che iniziano l'ambiente virtuale come questo attualmente dà il seguente errore:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Per aggirare il problema utilizza, invece del precedente, il comando `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTA:** Se ottieni un errore come
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> allora esegui:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Lavorare con virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Avvia il tuo virtualenv digitando:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In questo caso, apri un'altra Windows PowerShell con l'opzione "Esegui come amministratore". Quindi prova a digitare il seguente comando prima di iniziare il tuo ambiente virtuale:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> Il vantaggio è che non devi passare tra le finestre dell'editor e le finestre della linea di comando
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Avvia il tuo virtualenv digitando:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Ricordati di sostituire `myvenv` con il nome del `virtualenv` che hai scelto!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+Sarai certo di aver avviato il `virtualenv` quando vedrai che il prompt nella tua console inizia con `(myvenv)`.
+
+Quando si lavora all'interno di un ambiente virtuale, `python` farà automaticamente riferimento alla versione corretta da utilizzare. Per cui puoi digitare `python` invece che `python3`.
+
+OK, abbiamo tutte le dipendenze importanti pronte. Finalmente possiamo installare Django!
+
+## Installare Django {#django}
+
+Ora che hai avviato il tuo `virtualenv`, puoi installare Django.
+
+Prima però dobbiamo assicurarci di avere la versione più recente di `pip`, il software che useremo per installare Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installazione di pacchetti con requisiti
+
+Un file di requisiti mantiene un elenco di dipendenze da installare utilizzando `pip install`:
+
+Crea un file `requirements.txt` all'interno della cartella `djangogirls/` utilizzando l'editor di codice che hai installato prima. Lo fai aprendo un nuovo file nell'editor di codice e quindi salvarlo come `requirements.txt` nella cartella `djangogirls/` . La tua cartella assomiglierà a questo:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+Nel tuo file `djangogirls/requirements.txt` aggiungi il testo seguente:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Ora, esegui `pip install -r requirements.txt` per installare Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). Se lo fa, si prega di considerare l'utilizzo di un altro luogo senza spazi, accenti o caratteri speciali (suggerimento: `C:\djangogirls`). Crea un nuovo virtualenv nella nuova cartella, quindi cancellane uno vecchio e riprova il comando sopra. (Spostare la directory virtualenv non funzionerà perché virtualenv utilizza percorsi assoluti.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> Se ottieni un errore quando esegui il comando pip su Ubuntu 12.04, prova ad eseguire `python -m pip install -U --force-reinstall pip` per risolvere il problema.
+
+<!--endsec-->
+
+Questo è tutto! Sei (finalmente) pronto/a a creare un'applicazione Django!
\ No newline at end of file
diff --git a/it-IT/django_models/README.md b/it-IT/django_models/README.md
new file mode 100644
index 00000000000..da42aa15095
--- /dev/null
+++ b/it-IT/django_models/README.md
@@ -0,0 +1,201 @@
+# I modelli di Django
+
+Vogliamo creare un qualcosa che raccoglierà tutti i post del nostro blog. Per farlo, però, dobbiamo prima introdurre i cosiddetti `oggetti`.
+
+## Oggetti
+
+Esiste un concetto nella programmazione che è quello di `programmazione orientata agli oggetti`. L'idea di base è che invece di scrivere una noiosa sequenza di istruzioni di programmazione, possiamo modellare le cose e decidere come devono interagire l'una con l'altra.
+
+Quindi cos'è un oggetto? È un insieme di proprietà ed azioni. Suona strano, ma ti faremo un esempio.
+
+Se vogliamo il modello di un gatto creeremo un oggetto `Gatto` che possiede alcune proprietà come: `colore`, `età`, `umore` (come buono, cattivo, assonnato ;) ) e `padrone` (che è un oggetto `Persona` oppure, nel caso di un gatto randagio, la proprietà sarà vuota).
+
+Quindi il `Gatto` possiede anche alcune azioni: `fare_le_fusa`, `graffiare` e `alimentare` (in quest'ultimo caso, daremo al gatto del `CiboPerGatti`, che sarà un altro oggetto con le sue proprietà, come `gusto`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+Quindi in pratica l'idea è quella di descrivere cose vere in codice con delle proprietà (chiamate `proprietà di oggetti`) e azioni (chiamate `metodi`).
+
+Quindi come faremo a modellare i post del blog? vogliamo costruire un blog, giusto?
+
+Dobbiamo rispondere alla domanda: cos'è un post? Quali proprietà dovrebbe avere?
+
+Beh, sicuramente il nostro post ha bisogno di qualche testo con il suo contenuto ed un titolo, vero? Sarebbe bello sapere anche chi l'ha scritto - quindi abbiamo bisogno di un autore. Infine, vogliamo sapere quando il post è stato creato e pubblicato.
+
+    Post
+    --------
+    titolo
+    testo
+    autore
+    data_creazione
+    data_pubblicazione
+    
+
+Che tipo di cose si potrebbero fare con un post? Sarebbe bello avere qualche `metodo` che pubblica il post, vero?
+
+Quindi avremo bisogno di un metodo `pubblicare`.
+
+Dal momento che sappiamo già cosa vogliamo ottenere, iniziamo a modellarlo in Django!
+
+## Modello Django
+
+Sapendo cos'è un oggetto, possiamo creare un modello Django per il nostro post.
+
+Un modello in Django è uno speciale tipo di oggetto - è salvato nel `database`. Un database è un insieme di dati. È un posto in cui archivierai informazioni sui tuoi utenti, sui tuoi post, ecc. Useremo un database SQLite per archiviare i nostri dati. Questo è l'adattatore Django di database predefinito -- ci basterà per adesso.
+
+Puoi pensare ad un modello nel database come ad un foglio elettronico con colonne (campi) e righe (dati).
+
+### Creazione di un'applicazione
+
+Per mantenere tutto ordinato, creeremo un'applicazione diversa all'interno del nostro progetto. E' molto bello avere tutto organizzato fin dall'inizio. Per creare un'applicazione abbiamo bisogno di eseguire il seguente comando nella console (dalla cartella `djangogirls` dove si trova il file `manage.py`):
+
+{% filename %}Mac OS X o Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Noterai che si è creata una nuova cartella `blog` e che ora contiene alcuni file. Le nostre cartelle ed i nostri file nel nostro progetto si dovrebbero vedere così:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+Dopo aver creato un'applicazione dobbiamo dire a Django che dovrebbe utilizzarla. Lo facciamo nel file `mysite/settings.py` -- aprilo nell'editor di codice. Dobbiamo scoprire `INSTALLED_APPS` ed aggiunge una riga contenente `'blog.apps.BlogConfig',` proprio sopra `]`. Il progetto dovrebbe assomigliare a questo:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creazione di un modello blog post
+
+Nel file `blog/models.py` definiamo tutti gli oggetti chiamati `Models` - Questo è il posto dove definiremo il nostro blog post.
+
+Apriamo `blog/models.py`, cancella tutto quello che è lì e scrivi un codice come questo:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings 
+from django.db import models 
+from django.utils import timezone 
+
+
+class Post(models.Model):
+     author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+     title = models.CharField(max_length=200)
+     text = models.TextField()
+     created_date = models.DateTimeField(default=timezone.now)
+     published_date = models.DateTimeField(blank=True, null=True)
+
+     def publish(self):
+         self.published_date = timezone.now()
+         self.save()
+
+     def __str__(self):
+         return self.title
+```
+
+> Assicurati di aver usato 2 underscore (`_`) da entrambi i lati di `str`. Questa convenzione viene utilizzata spesso in Python e a volte li chiamiamo anche "dunder" (abbreviazione di "doppio carattere di sottolineatura").
+
+Sembra spaventoso, vero? ma non ti preoccupare, ti spiegheremo cosa significano queste righe!
+
+Tutte le righe che iniziano con `from` oppure con `import` sono righe che aggiungono alcuni pezzi da altri file. Quindi invece di copiare e incollare le stesse cose in ogni file, possiamo includere alcune parti con `from ... importa ...`.
+
+`class Post(models.Model):` - questa riga definisce il nostro modello (è un `oggetto`).
+
+- `class` è una parola chiave speciale che indica che stiamo definendo un oggetto.
+- `Post` è il nome del nostro modello. Possiamo dargli un nome diverso (ma dobbiamo evitare caratteri speciali e spazi). Inizia sempre il nome di una classe con un lettera maiuscola.
+- `models.Model` significa che il Post è un modello Django, quindi Django sa che dovrebbe essere salvato nel database.
+
+Ora definiamo le proprietà di cui stavamo parlando: `titolo`, `testo`, `data_creazione`, `data_pubblicazione` e `autore`. Per fare ciò dobbiamo definire un tipo per ogni campo (è un testo? Un numero? Una data? Una relazione con un altro oggetto, come User?)
+
+- `models.CharField` - così si definisce un testo con un numero limitato di lettere.
+- `models.TextField` - questo è il codice per definire un testo senza un limite. Sembra l'ideale per i contenuti di un post, vero?
+- `models.DateTimeField` - questo per la data ed l'ora.
+- `models.ForeignKey` - questo è un link a un altro modello.
+
+Non spiegheremo ogni pezzo di codice perchè ci vorrebbre troppo tempo. Dovresti dare un'occhiata alla documentazione di Django se vuoi sapere di più sui campi del Modello e come definire le cose oltre che da quelli descritti sopra (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+Che dire di `def publish(self):`? È esattamente il metodo `pubblicare` di cui stavamo parlando prima. `def` significa che questa è una funzione/metodo e `publish` è il nome del metodo. Puoi modificare il nome del metodo, se vuoi. La regola per la denominazione è usare lettere minuscole e caratteri di sottolineatura al posto degli spazi. Per esempio, un metodo che calcola il prezzo medio potrebbe essere chiamato `calculate_average_price`.
+
+I metodi spesso `restituiscono` qualcosa. C'è un esempio nel metodo `__str__`. In questo caso, quando chiamiamo `__str__()` otterremo un testo (**stringa**) con il titolo del Post.
+
+Nota anche che entrambe `def publish(self):` e `def __str__(self):` sono indentate all'interno della classe. Poiché Python è sensibile agli spazi, dobbiamo indentare i nostri metodi dentro alla classe. Altrimenti i metodi non apparterranno alla classe e potresti ottenere qualche comportamento inaspettato.
+
+Se c'è qualcosa di poco chiaro sui modelli, sentiti libera/o di chiedere al tuo coach! Sappiamo che è complicato, soprattutto quando impari cosa sono gli oggetti e le funzioni allo stesso tempo. Ma speriamo che sembri un po' meno magico per te per adesso!
+
+### Crea tabelle per i modelli nel tuo database
+
+L'ultimo passo è quello di aggiungere un nuovo modello al nostro database. Prima dobbiamo far sapere a Django che ci sono alcuni cambiamenti nel nostro modello (l'abbiamo appena creato. (Vai alla finestra della tua console e digita `python manage.py makemigrations blog`. Il risultato somiglierà a questo:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Nota:** Ricorda di salvare i file che modifica. Altrimenti, il computer eseguirà la versione precedente che potrebbe fornirti messaggi di errore inattesi.
+
+Django ci ha preparato un file di migrazione che dobbiamo applicare nel nostro database. Digita `python manage.py migrate blog` e l'output dovrebbe essere:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Evviva! Il nostro modello Post ora è nel database! Sarebbe bello poterlo vedere, vero? Vai al prossimo capitolo per vedere com'è il tuo Post!
\ No newline at end of file
diff --git a/it-IT/django_orm/README.md b/it-IT/django_orm/README.md
new file mode 100644
index 00000000000..c08695fcc90
--- /dev/null
+++ b/it-IT/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM e QuerySets
+
+In questo capitolo imparerai come Django si collega al database e archivia i dati al suo interno. Tuffiamoci!
+
+## Cos'è un QuerySet?
+
+Un QuerySet è in sostanza una lista di oggetti di un Model. Ti permettono di leggere i dati dal database, filtrarli e ordinarli.
+
+È più facile impararlo con un esempio. Proviamo, ti va?
+
+## La shell di Django
+
+Apri la tua console locale (non su PythonAnywhere) e digita questo comando:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+L'effetto dovrebbe essere come questo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Ora ti trovi nella consolle interattiva di Django. E' come il prompt di python ma con un po' di magia di Django in più :). Qui puoi anche utilizzare tutti i comandi Python, ovviamente.
+
+### Tutti gli oggetti
+
+Proviamo a rendere visibili tutti i nostri post prima. Puoi farlo con il seguente comando:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Ops! È comparso un errore. Ci dice che non c'è nessun Post. È corretto -- ci siamo dimenticati di importarlo!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+È semplice: importiamo il modello `Post` da `blog.models`. Proviamo a rendere di nuovo visibili tutti i post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+È la lista dei post che abbiamo creato prima! Li abbiamo creati utilizzando l'interfaccia di amministrazione di Django. Se volessimo crearne uno con Python, come dovremmo fare?
+
+### Creare oggetti
+
+Così si crea un nuovo oggetto Post nel database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Ma manca un ingrediente qui: `me`. Dobbiamo passare un'istanza del modello `User` come un autore. Come si fa?
+
+Importiamo il modello User prima:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Quali utenti abbiamo nel nostro database? Prova questo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+Questo è il superutente che abbiamo creato prima! Ora riceviamo un'istanza dell'utente (regolare questa linea per utilizzare il tuo nome utente):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Come puoi vedere, ora `riceviamo` un `Utente` con un `username` che equivale a 'ola'. Vicino!
+
+Adesso possiamo finalmente creare il nostro post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Evviva! Vuoi controllare se funziona?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Eccolo, un altro post nell'elenco!
+
+### Aggiungi altri post
+
+Ora puoi divertirti un po' ed aggiungere altri post per vedere come funziona. Aggiungi altri 2 o 3 e vai alla prossima parte.
+
+### Filtrare gli oggeti
+
+Larga parte parte dei QuerySets consiste nell'abilità di filtrarli. Diciamo che vogliamo trovare tutti i post il cui autore è ola. Useremo `filter` invece di `all` in `Post.objects.all()`. Nelle parentesi andremo ad inserire tutte le condizioni che un Post deve avere per essere nel nostro queryset. Nella nostra situazione è `autore` che è uguale a `me`. Il modo di scriverlo in Django è `autore=me`. Ora il nostro pezzo di codice ha questo aspetto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+O magari vogliamo vedere tutti i post che contengono la parola 'titolo' nel campo `titolo`?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Nota** ci sono due caratteri di sottolineatura (`_`) tra `titolo` e `contains`. L'ORM di Django usa questa regola per separare i nomi dei field ("title") dalle operazioni e dai filtri ("contains"). Se usi solo un carattere di sottolineatura, otterrai un errore come "FieldError: non è possibile risolvere la parola chiave title_contains".
+
+Puoi anche ottenere una lista di tutti i post pubblicati. Lo facciamo filtrando tutti i post che hanno una `published_date` impostata in passato:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Purtroppo, il post che abbiamo aggiunto dalla console Python non è ancora pubblicato. Possiamo modificarlo! In primo luogo ottenere un'istanza di un post che vogliamo pubblicare:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+Ora pubblicalo con il nostro metodo `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Ora cerca di ottenere di nuovo l'elenco dei post pubblicati (premere il pulsante di freccia in su 3 volte e premere `invio`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordinare gli oggetti
+
+I QuerySet ti permettono anche di ordinare le liste di oggetti. Proviamo a ordinarli in base al campo `created_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Possiamo anche invertire l'ordine aggiungendo `-` all'inizio:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Query complesse attraverso la catena di metodo
+
+Come hai visto, alcuni metodi su `Post.objects` restituiscono un QuerySet. Gli stessi metodi possono a loro volta essere chiamati su un QuerySet, e poi restituiranno un nuovo QuerySet. Puoi anche combinare QuerySets ** concatenandole** insieme:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+È davvero potente e ti permette di scrivere query piuttosto complesse.
+
+Fantastico! Ora sei pronta per la prossima parte! Per chiudere la shell, digita questo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/it-IT/django_start_project/README.md b/it-IT/django_start_project/README.md
new file mode 100644
index 00000000000..654e71c8057
--- /dev/null
+++ b/it-IT/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Il tuo primo progetto Django!
+
+> Parte di questo capitolo è tratto dal tutorial delle Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parti di questo capitolo si basano sul [django-marcador tutorial](http://django-marcador.keimlink.de/) con licenza Creative Commons Attributions-ShareAlike 4.0 International License. Il tutorial di django-marcador è protetto da copyright di Markus Zapke-Gründemann et al.
+
+Creeremo un piccolo blog!
+
+Il primo passo è quello di iniziare un nuovo progetto di Django. Fondamentalmente, questo significa che eseguiremo alcuni script forniti da Django che creerà per noi lo scheletro di un progetto Django. Si tratta solo di un insieme di directory e file che verranno utilizzati dopo.
+
+I nomi di alcuni file e cartelle sono molto importanti per Django. Non dovresti modificare i nomi dei file che stiamo per creare. Neanche spostarli in un altro posto è una buona idea. Django deve mantenere una determinata struttura per essere in grado di trovare le cose importanti.
+
+> Ricordati di eseguire tutto nel virtualenv. Se non vedi il prefisso `(myvenv)` nella tua console, devi attivare il tuo virtualenv. Abbiamo spiegato come farlo nel capitolo **installazione Django** nella parte **Lavorando con virtualenv**. Digitando `myvenv\Scripts\activate` su Windows oppure `source myvenv/bin/activate` su Mac OS / Linux farà questo per te.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+Dovresti eseguire il seguente comando nella tua console MacOS X o Linux; **non dimenticarti di aggiungere il punto `.` alla fine! **
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Il punto `.` è cruciale perché dice allo script d'installare Django nell'attuale directory (quindi il punto `.` è un riferimento di abbreviazione).
+> 
+> **Nota** Quando digiti i comandi sopra, ricorda che si digita soltanto la parte che inizia con django-admin oppure ``. Le parti mostrate qui come (myvenv) ~/djangogirls$ e `(myvenv) C:\Users\Name\djangogirls` sono solo esempi del prompt che starà invitando il tuo input sulla tua command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Dovresti eseguire nella tua console MacOS o Linux il seguente comando; **non dimenticarti di aggiungere il punto `.` alla fine **:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Il punto `.` è cruciale perché dice allo script d'installare Django nell'attuale directory (quindi il punto `.` è un riferimento di abbreviazione).
+> 
+> **Nota** Quando digiti i comandi sopra, ricorda che si digita soltanto la parte che inizia con django-admin oppure ``. Le parti mostrate qui come (myvenv) ~/djangogirls$ e `(myvenv) C:\Users\Name\djangogirls` sono solo esempi del prompt che starà invitando il tuo input sulla tua command line.
+
+<!--endsec-->
+
+`django-admin.py` è uno script che creerà le cartelle ed i file per te. Adesso dovresti avere una struttura di directory simile a questa:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Nota**: nella struttura della directory, vedrai anche la tua cartella `venv` che abbiamo creato prima.
+
+`manage.py` è uno script che aiuta a gestire il sito. Usandolo saremo in grado di avviare un web server sul nostro computer senza dover istallare nient'altro, tra l'altro.
+
+Il file `settings.py` contiene la configurazione del tuo sito web.
+
+Ricordi quando abbiamo parlato di un postino che controlla dove rilasciare la lettera? il file `urls.py` contiene una lista di schemi usati da `urlresolver`.
+
+Ignoriamo gli altri file per ora dal momento che non li modificheremo. L'unica cosa da ricordare è di non cancellarli per sbaglio!
+
+## Modificare le impostazioni
+
+Facciamo qualche cambiamento in `mysite/settings.py`. Apri il file usando il code editor che hai istallato prima.
+
+**Nota**: Ricorda che `settings.py` è un file regolare, come qualsiasi altro. Puoi aprirlo all'interno dell'editor di codice, utilizzando le azioni di menu "file -> apri". Questo dovrebbe portarti la finestra abituale in cui puoi navigare nel file `settings.py` e selezionarlo. In alternativa, puoi aprire il file navigando nella cartella djangogirls sul tuo desktop e facendo clic destro su di esso. Quindi, seleziona l'editor di codice dall'elenco. La selezione dell'editor è importante perché potresti avere altri programmi installati che possono aprire il file ma non ti permetterà di modificarlo.
+
+Sarebbe bello avere l'ora corretta sul nostro sito Web. Vai alla lista delle zone orarie [Wikipedia](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) e copia la tua zona di tempo (TZ) (ad esempio. `Europa/Berlino`).
+
+In settings.py, trova la riga che contiene `TIME_ZONE` e modificala per scegliere il tuo fuso orario:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+Un codice lingua è costituito dalla lingua, ad esempio`en` per l'inglese o `de` per il tedesco e il codice del paese, ad esempio`de` per la Germania o `ch` per la Svizzera. Se l'inglese non è la tua lingua nativa, puoi aggiungere questo per cambiare i pulsanti e le notifiche predefinite da Django per essere nella tua lingua. Quindi, il pulsante "Annulla" verrebbe tradotto nella lingua che hai definito qui. [Django arriva con molte traduzioni preparate](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+Se vuoi una lingua diversa, cambia il codice lingua modificando la seguente riga:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Dovremo anche aggiungere un percorso per i file statici. (Più tardi scopriremo tutti i file statici e CSS nel tutorial.) Vai alla *end* del file, e appena sotto la voce `STATIC_URL` aggiungi un nuovo nome chiamato `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Quando `DEBUG` è `Vero` e `ALLOWED_HOSTS` è vuoto, l'host è convalidato contro `['localhost', '127.0.0.1', '[::1]']`. Questo non abbina il nostro hostname su PythonAnywhere dopo aver distribuito la nostra applicazione in modo da modificare le seguenti impostazioni:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Nota**: se stai usando un Chromebook, aggiungi questa linea nella parte inferiore del file settings.py: `MESSAGE_STORAGE = 'django.contrib.storage.session.SessionStorage'`
+> 
+> Aggiunge anche `.amazonaws.com` a `ALLOWED_HOSTS` se stai usando cloud9
+> 
+> Se stai presentando il tuo progetto su `Glitch.com`, bisogna proteggere la chiave segreta di Django, che deve rimanere confidenziale (altrimenti chiunque faccia un remix del tuo progetto potrebbe vederla):
+> 
+> - Prima di tutto, si crea una chiave segreta casuale. Apri nuovamente il terminale Glitch e digita il comando seguente:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     Il comando dovrebbe mostrare una lunga stringa casuale, perfetta da usare come chiave segreta per il tuo nuovo sito web Django. Si incolla poi questa chiave in un file `.env` che Glitch mostrerà solamente se sei il proprietario del sito web.
+> 
+> - Crea un file `.env` alla base del tuo progetto e aggiungi al suo interno la proprietà seguente:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Qui, all'interno delle virgolette, puoi tagliare e incollare la chiave casuale generata precedentemente
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Aggiorna poi il file delle impostazioni di Django per inserire questo valore segreto e impostare il nome del sito web:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - Poco più avanti nello stesso file, inserisci il nome del tuo nuovo sito web Glitch:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     Il valore `PROJECT_DOMAIN` è generato automaticamente da Glitch. Corrisponderà al nome del tuo progetto.
+
+## Imposta un database
+
+Ci sono un sacco di software di database diversi che possono immagazzinare dati per il tuo sito. Noi useremo quello di default, `sqlite3`.
+
+È già impostato in questa parte del file `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Per creare un database per il nostro blog, eseguiamo questo nella console: `python manage.py migrate` (abbiamo bisogno di essere nella directory `djangogirls` che contiene il file `manage.py`). Se funziona, dovresti vedere qualcosa di simile:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+E abbiamo finito! Tempo di avviare il server web e vedere se il nostro sito Web funziona!
+
+## Avvio del server web
+
+Devi essere nella directory che contiene il file di `manage.py` (la directory `djangogirls`). Nella console, possiamo avviare il server web eseguendo `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Se invece stai usando un Chromebook, digita questo comando:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+o questo se stai usando Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+Se usi Windows e il comando `UnicodeDecodeError` non funziona, puoi usare questo:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Ora devi solo controllare se il tuo sito web è in esecuzione. Apri il tuo browser (Firefox, Chrome, Safari, Internet Explorer o quello che utilizzi di solito) e inserisci questo indirizzo:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+Se stai utilizzando un Chromebook e Cloud9, seleziona invece l'URL nella finestra a comparsa che dovrebbe apparire nell'angolo in alto a destra della finestra di comando dove il server web è in esecuzione. L'URL sarà simile a questo:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+oppure su Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulazioni! Hai appena creato il tuo primo sito web e lo hai avviato usando un server web! Non è fantastico?
+
+![Installazione completata!](images/install_worked.png)
+
+N.B. Una finestra di comando può eseguire solo una cosa alla volta e la finestra di comando che hai aperto in precedenza sta eseguendo il server web. Finché il server web è in esecuzione e in attesa di ulteriori richieste in arrivo, il terminale ammetterà del testo nuovo, ma non eseguirà nuovi comandi.
+
+> Abbiamo esaminato come funzionano i server web nel capitolo **Come funziona il capitolo** .
+
+Per digitare ulteriori comandi mentre il server web è in esecuzione, puoi aprire una nuova finestra terminale e attivare il tuo virtualenv (per rivedere le istruzioni su come aprire una seconda finestra terminale, vedi [Introduction to the command line](../intro_to_command_line/README.md)). Per arrestare il server web, devi tornare alla finestra dove è in esecuzione e premere CTRL+C - ovvero i tasti Control e C insieme (su Windows potresti dover premere Ctrl+Break).
+
+Sei pronto per il prossimo passaggio? È ora di creare un po' di contenuti!
\ No newline at end of file
diff --git a/it-IT/django_templates/README.md b/it-IT/django_templates/README.md
new file mode 100644
index 00000000000..ae8a2beed24
--- /dev/null
+++ b/it-IT/django_templates/README.md
@@ -0,0 +1,108 @@
+# I templates di Django
+
+È l'ora di visualizzare alcuni dati! Django ci dà alcuni **template tags** già pronti per farlo.
+
+## Cosa sono i template tags?
+
+In HTML non puoi scrivere codice Python, perché i browser non lo capiscono. Essi conoscono solo l'HTML. Noi sappiamo che l'HTML è piuttosto statico, mentre Python è molto più dinamico.
+
+I **Django template tags** ci permettono di trasferire le cose simili a Python in HTML, in modo che tu possa costruire siti web in modo più veloce e facile. Accidenti!
+
+## Mostra il template con la lista di post
+
+Nel capitolo precedente abbiamo dato al nostro template una lista di posts nella variabile `posts`. Adesso lo mostreremo nell'HTML.
+
+Per stampare una variabile nel template Django, usiamo doppie parentesi graffe con il nome della variabile all'interno, così:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Prova ad inserirlo nel tuo template `blog/templates/blog/post_list.html`. Sostituisci tutto dal secondo `<div>` al terzo `</div>` con `{{ posts }}`. Salva il file e aggiorna la pagina per vedere i risultati:
+
+![Figura 13.1](images/step1.png)
+
+Come vedi, quello che abbiamo è:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Significa che Django lo vede come una lista di oggetti. Ricordi dalla **Introduzione a Python** come possiamo rendere visibili le liste? Sì, con for loops! In un template Django si fanno così:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Prova ad inserirlo nel tuo template.
+
+![Figura 13.2](images/step2.png)
+
+Funziona! Ma noi vogliamo che vengano mostrate come i post statici che abbiamo creato prima nel capitolo **Introduzione ad HTML**. Puoi mischiare i tag HTML con quelli di template. Il nostro `body` avrà questo aspetto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Tutto quello che hai messo tra `{% for %}` e `{% endfor %}` Sarà ripetuto per ciascun oggetto della lista. Aggiorna la tua pagina:{% endraw %}
+
+![Figura 13.3](images/step3.png)
+
+Ti sei accorto che abbiamo utilizzato una notazione leggermente diversa questa volta `{{ post.title }}` oppure `{{ post.text }}`)? Stiamo introducendo i dati in ciascuno dei campi definiti nel nostro modello `Post`. Inoltre il comando `|linebreaks` introduce un filtro che traduce gli accapo (la pressione del tasto "invio" sulla tastiera) nel loro equivalente in HTML.
+
+## Un' ultima cosa
+
+Sarebbe bello vedere se il tuo sito funziona ancora su Internet, giusto? Proviamo a fare il deploy su PythonAnywhere di nuovo. Ecco un riepilogo dei passaggi...
+
+* Prima di tutto, fai il push del tuo codice verso Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Poi, ritorna su [PythonAnywhere](https://www.pythonanywhere.com/consoles/) e vai alla tua **console di Bash** (o iniziane una nuova) ed esegui:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Ricordati di sostituire `<your-pythonanywhere-domain>` con il sottodominio di PythonAnywhere, senza le parentesi angolo.)
+
+* Infine, fai un salto alla [scheda Web](https://www.pythonanywhere.com/web_app_setup/) e premi **Reload** sulla tua web app. (Per raggiungere altre pagine PythonAnywhere dalla console, usa il pulsante menu nell'angolo in alto a destra.) Il tuo aggiornamento dovrebbe essere attivo su https://subdomain.pythonanywhere.com -- scoprilo nel browser! Se i post che hai sul computer non combaciano con quelli presenti su PythonAnywhere, va tutto bene. Il database su PythonAnywhere e quello sul tuo computer sono diversi a differenza degli altri file.
+
+Congratulazioni! Andiamo avanti e proviamo ad aggiungere nuovi post nel tuo admin di Django (ricordati di aggiungere published_date!). Assicurati di essere nell'admin del tuo sito su pythonanywhere, https://subdomain.pythonanywhere.com/admin. Quindi aggiorna la pagina per vedere se i post sono comparsi.
+
+Funziona come un incantesimo? Ne siamo fieri! Staccati dal computer per un po', ti sei guadagnato/a una pausa. :)
+
+![Figura 13.4](images/donut.png)
\ No newline at end of file
diff --git a/it-IT/django_urls/README.md b/it-IT/django_urls/README.md
new file mode 100644
index 00000000000..626a37d85b0
--- /dev/null
+++ b/it-IT/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URL
+
+Stiamo per costruire la nostra pagina web: una homepage per il tuo blog! Ma prima, impariamo un po' di più sulle url di Django.
+
+## Che cos'è un URL?
+
+Una URL è semplicemente un indirizzo web. Puoi vedere una URL ogni volta che visiti un sito web - si vede nella barra degli indirizzi del tuo browser. (sì. (Ma certo che sì! `127.0.0.1:8000` is a URL! Anche `https://djangogirls.org` è una URL.)
+
+![URL](images/url.png)
+
+Ogni pagina internet ha bisogno della sua URL. In questo modo la tua applicazione sa cosa deve mostrare a un utente che visita una URL. In Django usiamo qualcosa chiamato `URLconf` ( configurazione dell'URL). URLconf è un insieme di modelli che Django cercherà di far corrispondere con l'URL ricevuta per trovare la view giusta.
+
+## Come funzionano le URL in Django?
+
+Apriamo il file `mysite/urls.py` nel code editor che hai scelto e vediamo com'è:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import path, include
+from django.urls import admin
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Come puoi vedere, Django ha già predisposto qualcosa per noi in questo file.
+
+Le line tra un triplo apice (`'''` o `"""`) sono chiamate docstrings - puoi scriverle all'inizio di file, classi o metodi per descrivere cosa fanno. Verranno ignorati da Python.
+
+L'admin URL , che hai visto nel capitolo precedente è già qui:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Questo significa che per ogni URL che comincia con `admin/` Django troverà la corrispondente *view*. In questo caso stiamo includendo un sacco di admin URL così che non sia tutto imballato in questo piccolo file - è più leggibile e più pulito.
+
+## Il tuo primo URL Django!
+
+E' ora di creare la tua prima URL. Vogliamo usare http://127.0.0.1:8000/ come homepage per il nostro blog e visualizzare il nostro elenco di post.
+
+Vogliamo anche mantenere il file di `mysite/urls.py` pulito, quindi importeremo le url dalla nostra applicazione `blog` sul file principale `mysite/urls.py`.
+
+Vai avanti, aggiungi una linea che importerà `blog.urls`. Dovrai anche cambiare la riga `da django.urls…` perché stiamo usando la funzione `include` qui, quindi dovrai aggiungere questa importazione alla riga.
+
+Il tuo file `mysite/urls.py` ora dovrebbe avere questo aspetto:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Ora Django reindirizzerà tutto ciò che viene da 'http://127.0.0.1:8000/' verso `blog.urls` e cercherà qui ulteriori istruzioni.
+
+## blog.urls
+
+Crea un nuovo file vuoto chiamato `urls.py` nella cartella `blog` e aprilo nell'editor di codice. Tutto a destra! Aggiungi queste prime due righe:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Qui abbiamo importato la funzione `url` di Django e tutte le nostre `views` dalla applicazione `blog` (Non abbiamo ancora nulla, ma ci arriveremo fra un minuto!)
+
+Dopo di che, possiamo aggiungere il nostro primo modello di URL:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+Come vedi, stiamo assegnando una `view` nominata `post_list` alla URL `^$`. Questo modello dell'URL corrisponderà ad una stringa vuota ed al risolutore URL di Django ignorerà il nome del dominio (es., http://127.0.0.1:8000/) che prefissa il percorso URL completo. Questo schema dirà a Django che `views.post_list` è il posto giusto dove andare se qualcuno entra nel tuo sito all'indirizzo 'http://127.0.0.1:8000/'.
+
+L'ultima parte `name='post_list'` è il nome dell'URL che verrà usata per identificare la view. Può avere lo stesso del nome della view, ma può anche essere qualcosa di completamente diverso. Useremo le URL rinominate successivamente nel progetto quindi è importante dare un nome a ciascuna URL nell'app. Inoltre dovremmo cercare di mantenere i nomi delle URL unici e facili da ricordare.
+
+Se provi a guardare adesso http://127.0.0.1:8000/, troverai un qualche tipo di messaggio come 'pagina non disponibile'. Questo perché il server (ricordi quando hai digitato `runserver`?) non è più attivo. Per capirne il motivo dai un occhiata alla console del tuo server.
+
+![Errore](images/error1.png)
+
+La tua console sta mostrando un errore, ma non preoccuparti – è davvero molto utile: ti dice che c'è **nessun attributo 'post_list'**. È il nome della *view* che Django prova a cercare e usare, ma non l'abbiamo ancora creata. In questa fase, anche il tuo `/admin/` non funzionerà. Non ti preoccupare, ci arriveremo. Se vedi un altro messaggio di errore, prova a riavviare il server web. Per farlo, nella finestra della console che esegue il server web, interrompilo premendo Ctrl+C (i tasti Control e C insieme). Su Windows, potresti dover premere Ctrl+Break. Poi devi riavviare il server web eseguendo un comando `python manage.py runserver`.
+
+> Se vuoi sapere di più su URLconfs di Django, guarda alla documentazione ufficiale: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/it-IT/django_views/README.md b/it-IT/django_views/README.md
new file mode 100644
index 00000000000..0f76223f653
--- /dev/null
+++ b/it-IT/django_views/README.md
@@ -0,0 +1,44 @@
+# Le viste di Django – è arrivata l'ora di creare!
+
+E' ora di liberarsi di quel bug che abbiamo creato nel capitolo precedente! :)
+
+Una *view* è un posto dove viene messa la "logica" della nostra applicazione. Essa richiederà informazioni dal `modello` che hai creato prima e lo passerà ad un `template`. Creeremo un template nel prossimo capitolo. Le views sono solo metodi di Python un po' più complicati di quelli che abbiamo descritto nel capitolo **Introduzione a Python**.
+
+Le views vengono collocate nel file `views.py`. Noi aggiungeremo le nostre *views* nel file `blog/views.py`.
+
+## blog/views.py
+
+OK, apriamo questo file e scopriamo cosa c'è dentro:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Crea le tue views qui.
+```
+
+Non c'è altro qui.
+
+Ricorda che le linee che iniziano con `#` sono commenti – questo significa che queste linee non saranno gestite da Python.
+
+Creiamo una *vista* come suggerisce il commento. Aggiungi la seguente vista minima qui sotto:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Come puoi vedere, abbiamo creato una funzione (`def`) chiamata `post_list` che prende `request` e restituisce `return` una funzione `render` che renderizza (mette insieme) il nostro template `blog/post_list.html`.
+
+Salva il file, vai su http://127.0.0.1:8000/ e guarda cosa abbiamo ottenuto.
+
+Un altro errore! Leggi cosa sta succedendo adesso:
+
+![Errore](images/error.png)
+
+Questo mostra che almeno il server è ancora attivo, ma ancora non sembra corretto, vero? Non preoccuparti, è solo una pagina di errore, nulla di cui aver paura! Come l messaggi di errore nella console, sono davvero utili. Puoi leggere il *TemplateDoesNotExist*. Correggiamo questo bug e creiamo un template nel capitolo successivo!
+
+> Scopri di più sulle visualizzazioni di Django leggendo la documentazione ufficiale: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/it-IT/dynamic_data_in_templates/README.md b/it-IT/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..91f554eb781
--- /dev/null
+++ b/it-IT/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# I dati dinamici nei templates
+
+Abbiamo diversi pezzi: il modello `Post` è definito in `models.py`, abbiamo `post_list` nel file `views.py` ed abbiamo aggiunto il template. Ma come faremo a far comparire i nostri post nel nostro template HTML? Perché è quello che vogliamo: prendere qualche contenuto (modelli salvati nel database) e farlo vedere in modo carino nel nostro template, giusto?
+
+Questo è esattamente quello che le *views* dovrebbero fare: collegare i modelli ed i template. Nella nostra `post_list` *view* avremo bisogno di prendere i modelli che vogliamo far vedere e passarli nel template. Nella *view* decidiamo cosa (modello) renderemo visibile nel template.
+
+OK, quindi come facciamo a farlo?
+
+Dobbiamo aprire il nostro `blog/views.py`. Per ora `post_list` *view* si vede così:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Ricordi quando abbiamo parlato di includere codice scritto in diversi file? Ora è il momento di includere il model che abbiamo scritto in `models.py`. Aggiungeremo questa riga `from .models import Post` così:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+Il punto prima di `models` significa *directory attuale* oppure *applicazione attuale*. Sia `views.py` che `models.py` sono nella stessa cartella. Questo significa che possiamo usare `.` seguito dal nome del file (senza `.py`). Allora importiamo il nome del modello (`Post`).
+
+Cos'altro bisogna fare? Per poter prendere i post del blog dal modello`Post` ci serve una cosa chiamata `QuerySet`.
+
+## QuerySet
+
+Dovresti già sapere come funziona QuerySet. Ne abbiamo parlato nel capitolo [Django ORM (QuerySets) ](../django_orm/README.md).
+
+Quindi ora vogliamo i post del blog che sono pubblicati ordinati per `published_date`, giusto? Lo abbiamo già fatto nel capitolo sulle QuerySet!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Quindi, apriamo il file `blog/views.py` nell'editor del codice, e aggiungiamo questo codice alla funzione `def post_list(request)` -- ma non dimenticare di aggiungere prima `da django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+Per mostrare il nostro QuerySet sull'elenco dei post del nostro blog, ci sono rimaste due cose da fare:
+
+1. Passare il QuerySet dei `post` al contesto del modello, modificando la chiamata della funzione di `render`: Lo faremo adesso.
+2. Modifica il modello per visualizzare il QuerySet dei `post`. Copriremo ciò in un capitolo successivo.
+
+Nota che abbiamo creato una *variabile* per il nostro QuerySet: `posts`. Vedila come il nome del nostro QuerySet. Da qui in avanti possiamo riferirci ad esso con questo nome.
+
+Nella funzione `render` abbiamo già un parametro con `request` (quindi tutto quello che riceviamo dal nostro utente via internet) e un file template `'blog/post_list.html'`). Nell'ultimo parametro, che è simile a questo: `{}` possiamo aggiungere cose che il template possa utilizzare. Dobbiamo dargli un nome (ci atterremo a `'posts'` per il momento). :) Si vede così: `{'posts': posts}`. Ti preghiamo di notare che la parte prima di `:` è una stringa; devi metterla tra virgolette.
+
+Finalmente il nostro file `blog/views.py` dovrebbe essere così:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+E' tutto! Ora di tornare al nostro template e rendere visibile questo QuerySet!
+
+Vuoi leggere un poco di più su QuerySets in Django? Dovresti guardare qui: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/it-IT/extend_your_application/README.md b/it-IT/extend_your_application/README.md
new file mode 100644
index 00000000000..fd4e75ba793
--- /dev/null
+++ b/it-IT/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Estendi la tua applicazione
+
+Abbiamo già completato tutti i passaggi differenti necessari per la creazione del nostro sito web: sappiamo come scrivere un modello, un URL, una vista ed un modello. Sappiamo anche come rendere carino il nostro sito web.
+
+Ora di far pratica!
+
+La prima cosa di cui abbiamo bisogno nel nostro blog è, ovviamente, una pagina per rendere visibile un post, vero?
+
+Abbiamo già un modello dei `Post`, quindi non abbiamo bisogno di aggiungere niente in `models.py`.
+
+## Creare un link di template verso la pagina di dettaglio di un post
+
+Cominceremo aggiungendo un link all'interno del file `blog/templates/blog/post_list.html`. Per ora dovrebbe avere questo aspetto: Aprilo nell'editor di codice, e finora dovrebbe sembrare così: {% filename %}blog/template/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}Vogliamo creare un link che dal titolo di un post facente parte dell'elenco di articoli porti alla pagina di dettaglio. Cambiamo `<h2><a href="">{{ post.title }}</a></h2>` così che linki alla pagina di dettaglio del post:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}È arrivata l'ora di spiegare il misterioso `{% url 'post_detail' pk=post.pk %}`. Come avrai capito, il simbolo `{% %}` significa che stiamo usando i tag del template di Django. Questa volta ne useremo uno che creerà una URL per noi!{% endraw %}
+
+La parte `post_detail` significa che Django si aspetta un URL in `blog/urls.py` con nome=post_detail
+
+E come si può parlare di `pk=post.pk`? `pk` è breve per il tasto principale, che è un identificatore unico per ogni registro in un database. Ogni modello di Django ha un campo che serve come tasto principale, e qualsiasi altro nome ha, è anche referenziabile come "pk". Poiché non abbiamo specificato un tasto principale nel nostro modello `Post`, Django ne crea uno per noi (di default, un campo nominato "id" che mantiene un numero che aumenta per ogni registro, es. 1, 2, 3) e lo aggiunge come un campo per ognuno dei nostri post. Accediamo al tasto principale scrivendo `post.pk`, allo stesso modo in cui accediamo agli altri campi (`titolo`, `autore`, etc.) nel nostro oggetto del `Post`!
+
+Adesso quando andremo all'indirizzo: http://127.0.0.1:8000/ avremo un errore (come sapevamo, dal momento che non abbiamo una URL oppure una *view* per `post_detail`). Avrà questo aspetto:
+
+![Errore: nessuna corrispondenza inversa](images/no_reverse_match2.png)
+
+## Crea una URL per i dettagli di un post
+
+Creiamo una URL in `urls.py` per il nostro `post_detail` *view*!
+
+Vogliamo che il nostro primo post venga visualizzato a questo **URL **: http://127.0.0.1:8000/post/1/
+
+Facciamo sì che l'URL nel file `blog/urls.py` punti Django ad una *view* chiamata `post_detail`, che mostrerà un intero post. Apri il file `blog/urls.py` nell'editor del codice e aggiungi la riga `path('post/<int:pk>/', view.post_detail, name='post_detail'),` così che il file assomiglia a questo:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+Questa parte `post/<int:pk>/` specifica un modello URL – lo spiegheremo per te:
+
+- `post/` significa che l'URL deve iniziare con la parola **post** seguita da **/**. Fin qui tutto bene.
+- `<int:pk>` – questa parte è più difficile. Significa che Django si aspetta un valore intero e lo trasferirà in una vista come variabile chiamata `pk`.
+- `/` – abbiamo bisogno di un **/** di nuovo prima di completare l'URL.
+
+Ciò significa che se digiti `http://127.0.0.1:8000/post/5/` nel tuo browser, Django capirà che stai cercando una *view* chiamata `post_detail` e trasferirà l'informazione che `pk` è uguale a `5` a quella *view*.
+
+Ok, abbiamo aggiunto un nuovo pattern URL in `blog/urls.py`! Prova ad aggiornare la pagina: http://127.0.0.1:8000/ Boom! Il server ha smesso di funzionare di nuovo. Diamo un occhiata alla console - come previsto, c'è una altro errore!
+
+![Errore Attributo](images/attribute_error2.png)
+
+Ti ricordi di quale è il prossimo passo? Ma certo: aggiungere una view!
+
+## Aggiungi una view del post
+
+Questa volta alla nostra *view* viene data un altro parametro `pk`. La nostra *view* deve prenderlo, vero? Quindi definiremo la nostra funzione come `def post_detail(request, pk):`. Nota che questo parametro deve avere lo stesso esatto nome di quello specificato in `urls` (`pk`). Nota anche che omettere questa variabile è scorretto e risulterà in un errore!
+
+Ora, noi vogliamo ottenere un' unico post. Per farlo possiamo utilizzare le queryset così:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Ma questo codice presenta un problema. Se non c'è `Post` con `primary key` (`pk`) otterremo un errore bruttissimo!
+
+![Errore: non esiste](images/does_not_exist2.png)
+
+Noi non lo vogliamo! Ma, senza dubbio, Django ha qualcosa che si occuperà del problema per noi: `get_object_or_404`. Nel caso in cui non ci sia `Post` con la data `pk` mostrerà una pagina molto più carina (chiamata `Page Not Found 404`.
+
+![Pagina non trovata](images/404_2.png)
+
+La buona notizia è che in realtà puoi creare la tua pagina `Page not found` modificarla come vuoi e darle un bell'aspetto. Ma non è importantissimo in questo momento, quindi salteremo questa parte.
+
+Ok, è arrivata l'ora di aggiungere una *view* al nostro file `views.py`!
+
+In `blog/urls.py` abbiamo creato una regola URL chiamata `post_detail` che si riferisce a una vista chiamata `views.post_detail`. Ciò significa che Django si aspetta una funzione di visualizzazione chiamata `post_detail` all'interno di `blog/views.py`.
+
+Apri il file `blog/views.py` e aggiungi quanto segue con il resto delle importazioni `from`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+E alla fine del file aggiungeremo la nostra *vista*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Sì. È ora di aggiornare la pagina: http://127.0.0.1:8000/
+
+![Visualizzazione elenco post](images/post_list2.png)
+
+Ha funzionato! Ma cosa succede se clicchi su un link nel titolo del post?
+
+![Errore: il template non esiste](images/template_does_not_exist2.png)
+
+Oh no! Un altro errore! Ma sappiamo già come occuparcene, giusto? Dobbiamo aggiungere un template!
+
+## Crea un template per il post detail
+
+Creeremo un file in `blog/templates/blog` chiamato `post_detail.html`.
+
+Inserisci il codice seguente:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Stiamo estendendo ancora una volta il template di base. `base.html`. Nel blocco `content` vogliamo mostrare una published_date del post (se esiste), un titolo ed il testo. Ma dovremmo discutere di alcune cose importanti, vero?
+
+{% raw %}`{% if ... %}... {% endif %}` è un tag di template che possiamo utilizzare quando vogliamo controllare qualcosa (ricordi if. (Ricorda `se... altro ...` da **Introduzione al capitolo Python** ?) In questo scenario vogliamo controllare se il post `published_date` non è vuoto.{% endraw %}
+
+Ok, possiamo aggiornare la nostra pagina e vedere se `TemplateDoesNotExist` non c'è più.
+
+![Pagina di dettaglio del post](images/post_detail2.png)
+
+Si! Ha funzionato!
+
+# Tempo di Deploy!
+
+Sarebbe bello vedere se il tuo sito web funziona ancora su PythonAnywhere, giusto? Proviamo a fare nuovamente il deploy.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Poi, in una [console PythonAnywhere Bash](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Ricordati di sostituire `<your-pythonanywhere-domain>` con il sottodominio di PythonAnywhere, senza le parentesi angolo.)
+
+## Aggiornamento file statici sul server
+
+Server come PythonAnywhere amano trattare "file statici" (come file CSS) in modo diverso dai file Python, perché possono ottimizzare per essere caricati più velocemente. Di conseguenza, ogni volta che modifichiamo i nostri file CSS, dobbiamo eseguire un comando extra sul server per dirlo per aggiornarli. Il comando è chiamato `colleziona`.
+
+Inizia attivando il tuo virtualenv se non è ancora attivo da prima (PythonAnywhere utilizza un comando chiamato `workon` per farlo, è proprio come il comando `sorgente myenv/bin/activate` che usi sul tuo computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+Il comando `manage.py collectstatic` è un po' come `manage.py migrate`. Facciamo alcune modifiche al nostro codice, e poi diciamo a Django a *applica* queste modifiche, sia alla collezione di file statici del server, sia al database.
+
+In ogni caso, siamo pronti a salire sulla pagina [ "Web"](https://www.pythonanywhere.com/web_app_setup/) (dal pulsante menu in alto a destra della console) e colpire **Ricarica**, e poi guarda la pagina https://subdomain.pythonanywhere.com per vedere il risultato.
+
+Ecco fatto! Congratulazioni!
\ No newline at end of file
diff --git a/it-IT/how_the_internet_works/README.md b/it-IT/how_the_internet_works/README.md
new file mode 100644
index 00000000000..1669588aca9
--- /dev/null
+++ b/it-IT/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Come funziona Internet
+
+> Per le lettrici a casa: questo capitolo viene trattato nel video [Come funziona Internet](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> Questo capitolo trae ispirazione dal discorso di Jessica McKellar "Come funziona Internet" (http://web.mit.edu/jesstess/www/).
+
+Scommettiamo che usi Internet tutti i giorni. Ma sai davvero cosa succede quando digiti un indirizzo come https://djangogirls.org nel tuo browser e premi `invio`?
+
+La prima cosa da capire è che un sito è è composto da un gruppo di file salvati su un hard disk. Tuttavia, c'è una caratteristica tipica dei siti web: includono un codice chiamato HTML.
+
+Se non hai familiarità con la programmazione, può essere difficile da cogliere HTML all'inizio, ma i tuoi web browser (come Chrome, Safari, Firefox, ecc) lo adorano. I browser sono progettati per capire questo codice, seguire le sue istruzioni e presentare questi file che costituiscono il tuo sito web esattamente nel modo desiderato.
+
+Come per tutti i file, dobbiamo archiviare i file HTML da qualche parte su un hard disk. Per l'Internet, utilizziamo computer speciali e potenti chiamati *servers*. Non hanno uno schermo, un mouse o una tastiera, perché il loro unico proposito è quello di archiviare i dati e fornirli. Per questo vengono chiamati *server* -- perché *servono* i tuoi dati.
+
+Ok, ma tu vuoi sapere com'è Internet, vero?
+
+Abbiamo creato un'immagine! Ecco:
+
+![Figura 1.1](images/internet_1.png)
+
+Sembra complicato, vero? Infatti è una rete di macchine collegate (i *server* di cui parlavamo prima). Centinaia di migliaia di macchine! Molti, molti chilometri di cavi in tutto il mondo! Puoi visitare un sito di Submarine Cable Map (http://submarinecablemap.com) per vedere quanto è complicata la rete. Ecco uno screenshot dal sito web:
+
+![Figura 1.2](images/internet_3.png)
+
+E' affascinante, non è vero? Ma ovviamente, non è possibile avere un cavo fra ogni macchina collegata ad Internet. Quindi, per raggiungere una macchina (per esempio quella in cui è salvato https://djangogirls.org) dobbiamo far passare una richiesta attraverso a molte, molte macchine diverse.
+
+Assomiglia a questo:
+
+![Figura 1.3](images/internet_2.png)
+
+Immagina che quando digiti https://djangogirls.org invii una lettera che dice: "Caro Django Girls, voglio vedere il sito djangogirls.org. inviamelo, per favore!"
+
+La tua lettera arriva nell'ufficio postale più vicino a te. Dopo di che va in un altro ufficio postale, che è un po' più vicino al tuo destinatario, poi in un altro ed in un altro ancora finché viene consegnato a destinazione. L'unica cosa è che se invii molte lettere (*pacchi di dati*) allo stesso posto, potrebbero attraversare uffici postali totalmente diversi (*routers*). Questo dipende da come vengono distribuiti presso ogni ufficio.
+
+![Figura 1.4](images/internet_4.png)
+
+Funziona così - invii un messaggio e aspetti una risposta. Solo che al posto di carta e penna usi byte di dati, ma il concetto è lo stesso!
+
+Al posto di indirizzi fisici, ovvero del nome della via, della città, del Cap, e del nome del Paese, usiamo indirizzi IP. Il tuo computer prima chiede il DNS (Domain Name System) per tradurre djangogirls.org in un indirizzo IP. Funziona un po' come i vecchi elenchi telefonici, dove puoi cercare il nome della persona che vuoi contattare e trovare il numero telefonico e l'indirizzo.
+
+Quando invii una lettera, deve avere determinate caratteristiche per essere consegnata correttamente: un indirizzo, un timbro, ecc. Inoltre utilizzi un linguaggio che il destinatario è in grado di capire, vero? Lo stesso vale per i *pacchi di dati* che invii per vedere un sito Web. Usiamo un protocollo chiamato HTTP (Hypertext Transfer Protocol).
+
+Quindi, praticamente, quando hai un sito, devi avere un *server* (macchina) dove archiviarlo. Quando il *server* riceve una *richiesta* (in una lettera), restituisce il tuo sito (in un'altra lettera).
+
+Dal momento che questo è il tutorial di Django, ti starai chiedendo che cosa fa Django. Quando invii una risposta, non vuoi inviare la stessa cosa a tutti. E' molto meglio se le tue lettere son personalizzate, soprattutto per la persona che ti ha appena scritto, giusto? Django ti aiuta con la creazione di queste interessanti lettere personalizzate. :)
+
+Basta parlare, è arrivata l'ora di creare!
\ No newline at end of file
diff --git a/it-IT/html/README.md b/it-IT/html/README.md
new file mode 100644
index 00000000000..8a413a18f81
--- /dev/null
+++ b/it-IT/html/README.md
@@ -0,0 +1,227 @@
+# Introduzione all'HTML
+
+Ti potresti chiedere, cos'è un template?
+
+Un template è un file che possiamo riutilizzare per presentare informazioni diverse in un formato consistente - per esempio, potresti utilizzare un template per aiutarti a scrivere una lettera, perché anche se ciascuna lettera potrebbe contenere un messaggio diverso ed essere a sua volta indirizzata ad una persona diversa, condivideranno lo stesso formato.
+
+Un template Django viene descritto in un linguaggio chiamato HTML (è lo stesso HTML che abbiamo menzionato nel primo capitolo **Come funziona l'Internet**).
+
+## Cos'è l'HTML?
+
+HTML è un semplice codice che viene interpretato dal tuo browser - come Chrome, Firefox o Safari - per rendere un sito web visibile all'utente.
+
+HTML sta per "HyperText Markup Language". **HyperText** significa che è un tipo di testo che supporta i collegamenti ipertestuali tra le pagine. **Markup** significa che abbiamo preso un documento e l'abbiamo contrassegnato con il codice per dire a qualcosa (in questo caso, un browser) come interpretare la pagina. Il codice HTML è costruito con **tags**, ognuno inizia con `<` e finisce con `>`. Questi tag rappresentano gli **elementi** di markup.
+
+## Il tuo primo template!
+
+Creare un template significa creare un file template. Tutto è un file, vero? Probabilmente l'hai già notato.
+
+I template vengono salvati in una cartella `blog/templates/blog`. Quindi prima crea una directory chiamata `templates` nella directory del tuo blog. Quindi crea un'altra directory chiamata `blog` all'interno della tua directory templates:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(Ti chiederai perché abbiamo bisogno di due directory chiamate entrambe `blog` - come scoprirai più tardi, si tratta semplicemente di una denominazione convenzionale che serve rendere la vita più facile.)
+
+E ora crea un file `post_list.html` nella directory `blog/templates/blog` (lascialo in bianco per adesso).
+
+Guarda che aspetto ha il tuo sito adesso: http://127.0.0.1:8000/
+
+> Se hai ancora l'errore `TemplateDoesNotExist`, prova a riavviare il tuo server. Vai nella command line, arresta il server premendo Ctrl+C ( I tasti Control e C insieme) e riavvialo utilizzando il comando `python manage.py runserver`.
+
+![Figura 11.1](images/step1.png)
+
+L'errore dovrebbe essere stato corretto! Congratulazioni :) Tuttavia, il tuo sito in realtà non sta pubblicando niente eccetto una pagina vuota, perché anche il tuo template è vuoto. Bisogna sistemarlo.
+
+Apri il nuovo file nell'editor di codice e aggiungi quanto segue:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+Quindi come appare il tuo sito ora? clicca per scoprirlo: http://127.0.0.1:8000/
+
+![Figura 11.2](images/step3.png)
+
+Ha funzionato! Ottimo lavoro! :)
+
+* La riga `<!DOCTYPE html>` non è un tag HTML. Dichiara solo il tipo di documento. Qui, informa il browser che il tipo di documento è [HTML5](https://html.spec.whatwg.org/#the-doctype). Questo è sempre l'inizio di qualsiasi file HTML5.
+* Il tag più semplice, `<html>`, è sempre l'inizio del contenuto html e `</html>` è sempre la fine. Come puoi vedere, l'intero contenuto del sito va tra il tag iniziale `<html>` ed il tag conclusivo `</html>`
+* `<p>` è un tag per gli elementi paragrafo; `</p>` conclude ogni paragrafo
+
+## Testa e corpo
+
+Ciascuna pagina HTML è a sua volta divisa in due elementi: **head** e **body**.
+
+* **head** è un elemento che contiene informazioni sul documento non visibili sullo schermo.
+
+* **body** è l'elemento che contiene tutto ciò che invece viene visualizzato come parte della pagina web.
+
+Utilizziamo `<head>` per dire al browser come interpretare la configurazione della pagina, e `<body>` per dirgli in realtà cosa c'è nella pagina.
+
+Per esempio, puoi mettere un elemento di titolo all'interno di `<head>`, così:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Salva il file e aggiorna la tua pagina.
+
+![Figura 11.3](images/step4.png)
+
+Hai notato come il browser ha capito che "Il blog di Ola" è il titolo della tua pagina? Ha interpretato `<title>Il blog di Ola</title>` ed ha messo il testo nella barra del titolo sul tuo browser (sarà anche utilizzato per i segnalibri e così via).
+
+Probabilmente hai anche notato che ogni tag di apertura è abbinato ad un *tag di chiusura*, con un `/`, e che gli elementi sono *annidati* (i.e. non puoi chiudere un tag particolare fino a quando tutti quelli che erano al suo interno sono stati chiusi a loro volta).
+
+È come mettere le cose in delle scatole. Hai una grossa scatola, `<html></html>`; al suo interno c'è `<body></body>`, che contiene scatole ancora più piccole: `<p></p>`.
+
+Devi seguire queste regole di tag *di chiusura*, e di elementi *annidati* - se non lo fai, il browser potrebbe non essere in grado di interpretarli correttamente e la tua pagina verrà visualizzata incorrettamente.
+
+## Personalizza il tuo template
+
+Ora puoi divertirti un po' e provare a personalizzare il tuo template! Qua ci sono un po' di tag utili per quello:
+
+* `<h1>A heading</h1>` - per la tua intestazione più importante
+* `<h2>A sub-heading</h2>` - per un titolo di livello inferiore
+* `<h3>A sub-sub-heading</h3>` ... e così via, fino a `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` enfatizza il tuo testo
+* `<strong>text</strong>` enfatizza fortemente il tuo testo
+* `<br>` va in un'altra riga (puoi mettere qualsiasi cosa dentro br)
+* `<a href="https://djangogirls.org">link</a>` crea un link
+* `<ul><li>primo elemento</li><li>secondo elemento</li></ul>` fa una lista, proprio come questa qui!
+* `<div></div>` definisce una sezione della pagina
+* `<nav></nav>` definisce un insieme di collegamenti di navigazione
+* `<article></article>` specifica il contenuto autonomo e indipendente
+* `<section></section>` definisce una sezione in un documento
+* `<header></header>` specifica un'intestazione per un documento o una sezione
+* `<main></main>` specifica il contenuto principale di un documento
+* `<aside></aside>` definisce alcuni contenuti a parte il contenuto in cui è inserito (come una barra laterale)
+* `<footer></footer>` definisce un piè di pagina per un documento o sezione
+* `<time></time>` definisce un'ora (o datetime) specifica
+
+Ecco un esempio di modello completo, copia e incolla in `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+Abbiamo creato una sezione `intestazione` e due `articolo` sezione qui.
+
+* L'elemento `intestazione` contiene il titolo del nostro blog – è un'intestazione e un link
+* I due elementi `articolo` contengono i nostri post sul blog con una data pubblicata in un elemento `ora` , un elemento `h2` con un titolo post cliccabile e un elemento `p` (paragrafo) per il testo del nostro post sul blog.
+
+Ci dà questo effetto:
+
+![Figura 11.4](images/step6.png)
+
+Yaaay! Ma fino adesso, il nostro template mostra esattamente **la stessa informazione** - mentre prima stavamo dicendo che i template ci permettono di mostrare **diverse** informazioni nello **stesso formato**.
+
+Quello che vogliamo è visualizzare i veri post aggiunti nel nel nostro Django admin - è quello che faremo adesso.
+
+## Un'ultima cosa: il deploy!
+
+Sarebbe bello vedere tutto questo live su Internet, giusto? Facciamo un altro deploy su PythonAnywhere:
+
+### Committa e pubblica il tuo codice su GitHub
+
+Prima di tutto, vediamo quali file sono cambiati dall'ultimo deploy (esegui questi comandi localmente, non su PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Assicurati di essere nella directory `djangogirls` e diciamo a `git` di includere tutte le modifiche in questa directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Prima di caricare tutti i file, proviamo a controllare cosa caricherà `git` (tutti i file che caricherà `git` ora appariranno in verde):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Ci siamo quasi, ora è il momento di dirgli di salvare questa modifica nella cronologia. Gli daremo un "messaggio di commit" dove descriviamo ciò che abbiamo modificato. Puoi digitare tutto quello che vuoi a questo punto, sarebbe utile scrivere qualcosa di descrittivo in modo da ricordare in futuro cos'hai fatto.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Ho cambiato l'HTML per questo sito."
+    
+
+> **Nota** Assicurati di usare doppie virgolette prima e dopo il "messaggio di commit".
+
+Quando hai finito, caricheremo (push) le nostre modifiche su Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Scarica il tuo nuovo codice su PythonAnywhere, e ricarica la tua web app
+
+* Apri la [pagina Console PythonAnywhere](https://www.pythonanywhere.com/consoles/) e vai alla tua **Bash console** (o iniziane una nuova). Quindi, esegui:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+Ricordati di sostituire `<your-pythonanywhere-domain>` con il sottodominio di PythonAnywhere, senza le parentesi angolo. Il tuo nome di sottodominio è normalmente il tuo nome utente PythonAnywhere, ma in alcuni casi potrebbe essere un po' diverso (come se il tuo nome utente contiene lettere capitali). Quindi, se questo comando non funziona, usa il comando `ls` (files list) per trovare il tuo nome di sottodominio/cartella reale e poi `cd` su di esso.
+
+Ora guarda il tuo codice scaricato. Se vuoi controllare che sia arrivato, puoi saltare alla pagina **"Files** e visualizzare il tuo codice su PythonAnywhere (puoi raggiungere altre pagine PythonAnywhere dal pulsante menu sulla pagina della console).
+
+* Infine, fai un salto alla [scheda Web](https://www.pythonanywhere.com/web_app_setup/) e premi **Reload** sulla tua web app.
+
+Il tuo aggiornamento dovrebbe essere applicato! Vai avanti ed aggiorna il tuo sito nel brower. Le modifiche dovrebbero essere visibili. :)
\ No newline at end of file
diff --git a/it-IT/installation/README.md b/it-IT/installation/README.md
new file mode 100644
index 00000000000..bdf0f1bb583
--- /dev/null
+++ b/it-IT/installation/README.md
@@ -0,0 +1,68 @@
+# Se stai seguendo il tutorial a casa
+
+Se stai seguendo il tutorial a casa, e non durante uno degli [eventi Django Girls](https://djangogirls.org/events/), puoi saltare completamente questo capitolo e andare direttamente al capitolo [Come funziona Internet](../how_the_internet_works/README.md).
+
+Questo perché nel tutorial spieghiamo come installare i programmi passo passo -- questa è una pagina aggiuntiva che raccoglie tutte le istruzioni di installazione (e che può tornare utile in alcuni workshop). Se vuoi puoi decidere di installare subito il materiale che trovi in questa pagina. Ma se vuoi imparare alcune nozioni prima di installare queste cose sul tuo computer, salta questo capitolo e ti spiegheremo come fare le installazioni più tardi, quando sarà necessario.
+
+Buona fortuna!
+
+# Se stai partecipando a un workshop
+
+Se stai partecipando a uno degli [eventi Django Girls](https://djangogirls.org/events/):
+
+* Il tuo workshop potrebbe avere un "party di installazione" prima del workshop principale. Se sei in un party di installazione, questa pagina è per te! Segui le istruzioni qui per ottenere tutto quello che serve per il workshop installato, con l'aiuto degli autobus se necessario. Poi al workshop principale, sarai in grado di saltare le istruzioni di installazione che incontrerai nel tutorial principale quando li avrai ricevuti.
+* Gli organizzatori del tuo workshop potrebbero aver chiesto di provare a casa per installare tutto sul tuo computer prima dell'inizio del workshop. Se ti è stato chiesto di farlo, questa pagina è per te! Segui le istruzioni qui, il meglio possibile. Poi al workshop principale, quando si arriva a un passo di installazione nel tutorial principale, se non si è riusciti a installare quel pezzo, si può ottenere aiuto dal tuo coach.
+* Se il tuo workshop non ha un gruppo di installazione (o non hai potuto partecipare), e se gli organizzatori non ti hanno chiesto di provare a installare tutto prima di arrivare, salta questa pagina e vai direttamente al capitolo [Come funziona Internet](../how_the_internet_works/README.md) . Installerai tutto ciò di cui hai bisogno quando lavori il tutorial.
+
+# Installazione
+
+In questo tutorial costruirai un blog. Per farlo, mentre vai nel tutorial, sarai informato su come installare vari software sul tuo computer e impostare alcuni account online come sono necessari. Questa pagina raccoglie tutte le istruzioni di installazione e iscrizione in un unico luogo (che è utile per alcuni formati di workshop).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Breve introduzione alla linea di comando {#command-line}
+
+Molti dei passaggi qui sotto fanno riferimento alla "console", "terminal", "finestra di comando", o "linea di comando" - tutto questo significa la stessa cosa: una finestra sul tuo computer dove puoi inserire comandi. Quando arriverai al tutorial principale, imparerai di più sulla linea di comando. Per ora, la cosa principale che devi sapere è come aprire una finestra di comando e come sembra: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Installa Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Installa un editor del codice {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Imposta virtualenv e installa Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Installa Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Crea un profilo di GitHub {#github-account}
+
+Vai su [GitHub.com](https://www.github.com) e crea un nuovo account gratuito. Assicurati di ricordare la tua password (aggiungila al tuo password manager, se ne usi uno).
+
+# Crea un profilo di PythonAnywhere {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Inizia la lettura
+
+Congratulazioni, sei pronta a partire! Se hai del tempo prima del workshop sarebbe magnifico se leggessi qualche capitolo iniziale:
+
+* [Come funziona Internet](../how_the_internet_works/README.md)
+
+* [Introduzione alla riga di comando](../intro_to_command_line/README.md)
+
+* [Introduzione a Python](../python_introduction/README.md)
+
+* [Che cos'è Django?](../django/README.md)
+
+# Divertiti al workshop!
+
+Quando inizierà il workshop, potrai andare direttamente a [il tuo primo progetto Django!](../django_start_project/README.md) dato che hai già coperto il materiale dei capitoli precedenti.
\ No newline at end of file
diff --git a/it-IT/intro_to_command_line/README.md b/it-IT/intro_to_command_line/README.md
new file mode 100644
index 00000000000..78876efd45f
--- /dev/null
+++ b/it-IT/intro_to_command_line/README.md
@@ -0,0 +1,437 @@
+# Introduzione all'interfaccia a riga di comando
+
+> Messaggio per i lettori: questo capitolo si trova nel video [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+Non è grandioso? avete appena scritto la vostra prima linea di codice in pochi minuti! :)
+
+**Ti presentiamo il tuo primo nuovo amico: la riga di comando!**
+
+I prossimi passaggi ti mostreranno come utilizzare quella 'finestra nera' che tutti gli hacker utilizzano. Ti potrà sembrare un po' allarmante all'inizio, ma è solamente un prompt in attesa dei tuoi comandi.
+
+> **Nota**: si prega di notare che in questo libro useremo il termine "directory" e "cartella" in maniera intercambiabile, ma sono la medesima cosa.
+
+## Cos'è la riga di comando?
+
+La finestra solitamente chiamata **riga di comando** o **interfaccia della riga di comando**, è un'applicazione basata su testo che ti permette di visualizzare, gestire e modificare i file sul tuo computer. È simile a Windows Explorer o Finder su Mac, ma senza interfaccia grafica. Altri nomi della riga di comando sono: *cmd*, *CLI*, *prompt*, *console* o *terminal*.
+
+## Aprire l'interfaccia della riga di comando
+
+Per cominciare a sperimentare, dobbiamo prima aprire la nostra interfaccia della riga di comando.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+Dovreste vedere ora una finestra nera o bianca in attesa dei vostri comandi.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Se state utilizzando un Mac o Linux, vedrete probabilmente un`$` come questo:
+
+{% filename %}riga di comando{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Su Windows, probebilmente vedrete un`>` come questo:
+
+{% filename %}riga di comando{% endfilename %}
+
+    >
+    
+
+Dai un'occhiata alla sezione Linux appena sopra -- vedrai qualcosa di più come quando arriverai a PythonAnywhere più tardi nel tutorial.
+
+<!--endsec-->
+
+Ogni comando sarà prepesso da un `$` o `>` e uno spazio, ma non dovresti digitarlo. Il tuo computer lo farà per te. :)
+
+> Solo una piccola nota: nel tuo caso ci dovrebbe essere qualcosa come `C:\Users\ola>` oppure `Olas-MacBook-Air:~ ola$` prima del segno di prompt. È corretto al 100%.
+
+La parte fino al `$` o al `>` inclusi, si chiama *prompt della linea di comando* o semplicemente *prompt*. Ti richiede di inserire qualcosa.
+
+Nel tutorial quando vorremo che tu scriva un comando, includeremo `$` o `>` e occasionalmente qualcosa in più a sinistra. Puoi ignorare la parte a sinistra e inserire solo il comando dopo il prompt.
+
+## Il tuo primo comando (YAY!)
+
+Iniziamo digitando questo comando:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+Premi `invio`. Questo è il nostro risultato:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami olasitarska
+    
+
+Come puoi vedere, il computer ha appena stampato il tuo nome utente. Bello, eh? :)
+
+> Prova a digitare ogni comando, non copiare ed incollare. Ti ricorderai di più in questo modo!
+
+## Nozioni di base
+
+Ogni sistema operativo ha un insieme di comandi leggermente diverso per la command line, per cui assicurati di seguire le istruzioni per il tuo sistema operativo. Proviamo questo, ti va?
+
+### Cartella corrente
+
+Sarebbe bello sapere dove ci troviamo ora, giusto?Vediamo. Digita questo comando e premi Invio:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd/utenti/olasitarska
+    
+
+> Nota: 'pwd' sta per 'stampa directory di lavoro'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd C:\Users\olasitarska
+    
+
+> Nota: 'cd' sta per 'modifica cartella'. Con la shell può usare pwd come su Linux o Mac OS X.
+
+<!--endsec-->
+
+Probabilmente vedrai qualcosa di simile sul tuo computer. Quando apri la command-line normalmente inizi sulla tua directory home.
+
+* * *
+
+### Guida Utente
+
+Molti comandi che puoi digitare al comando richiesto hanno un aiuto integrato che puoi visualizzare e leggere! Per esempio, per saperne di più sul comando della directory corrente:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X e Linux hanno un comando `man` che ti dà aiuto sui comandi. Prova `man pwd` e vedi cosa dice, o mette `man` prima di altri comandi per vedere il loro aiuto. L'output di `man` è normalmente paginato. Usa la barra di spazio per passare alla pagina successiva, e `q` per smettere di guardare l'aiuto.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Aggiungere un suffisso `/?` alla maggior parte dei comandi stamparà la pagina di aiuto. Potresti dover scorrere la finestra di comando per vederlo tutto. Prova `cd /?`.
+
+<!--endsec-->
+
+### Elenco di file e cartelle
+
+Cosa c'è dentro? Sarebbe bello scoprirlo. Vediamo come:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    
+
+> Nota: In PowerShell è anche possibile utilizzare 'ls' come su Linux e Mac OS X. <!--endsec-->
+
+* * *
+
+### Cambiare cartella corrente
+
+Ora, andiamo nella nostra directory Desktop:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Nota che il nome della directory "Desktop" potrebbe essere tradotto nella lingua del tuo account Linux. Se così è, dovrai sostituire `Desktop` con il nome tradotto; per esempio, `Schreibtisch` per il tedesco.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Controlla ora se ti sei veramente spostato/a:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Ecco fatto!
+
+> Suggerimento PRO:se digiti `cd D` e poi premi `tab` sulla tastiera, la command-line completerà automaticamente il resto del nome per cui puoi navigare più velocemente. Se c'è più di una cartella che comincia con "D", premi `tab` due volte per ottenere la lista con tutte le opzioni.
+
+* * *
+
+### Creare una directory
+
+Che ne dici di creare una directory di pratica sul tuo desktop? Puoi farlo in questo modo:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+Questo breve comando creerà una cartella con il nome `practice` sul tuo desktop. Puoi controllare se è lì semplicemente guardando sul tuo desktop oppure eseguendo un commando `ls` oppure `dir`! Provalo. :)
+
+> Suggerimento PRO: se non vuoi digitare lo stesso comando tutte le volte, prova a premere ` freccia in su ` e `freccia in giù` sulla tua tastiera per scorrere tutti i comandi che hai usato fin ora.
+
+* * *
+
+### Esercizio!
+
+Piccola sfida per te: nella tua directory appena creata `practice` crea una directory chiamata `test`. usa i comandi `cd` e `mkdir`.)
+
+#### Soluzione:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}riga di comando{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congratulazioni!
+
+* * *
+
+### Facciamo ordine
+
+Non vogliamo lasciare un pasticcio, per cui rimuoviamo tutto quello che abbiamo fatto fino a questo punto.
+
+Per prima cosa dobbiamo tornare al Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Usando `..` con il comando `cd` cambierai la tua directory attuale alla directory padre (si tratta della cartella che contiene la tua directory attuale).
+
+Controlla dove ti trovi ora:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Adesso è l'ora di cancellare la directory `practice`:
+
+> **Attenzione**: cancellare un file usando `del`, `rmdir` o `rm` è irreversibile, *i file cancellati andranno perduti per sempre*! Per cui sii molto prudente nell'utilizzare questi comandi.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Fatto! Per essere sicuri che sia stato effettivamente cancellato, controlliamo:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Uscire dalla command line
+
+Questo è tutto per ora! puoi tranquillamente chiudere la tua command line. facciamolo alla maniera degli hacker, va bene? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Figo, eh? :)
+
+## Indice
+
+Questo è un riepilogo di alcuni comandi utili:
+
+| Comandi(Windows) | Comandi (Mac OS / Linux)  | Descrizione                     | Esempio                                           |
+| ---------------- | ------------------------- | ------------------------------- | ------------------------------------------------- |
+| esci             | uscire dalla command line | chiudi la finestra              | **uscire dalla command line**                     |
+| cd               | cd                        | cambiare directory              | **cd test**                                       |
+| cd               | pwd                       | Cambiare cartella corrente      | **cd** (Windows) o **pwd** (Mac OS / Linux)       |
+| dir              | ls                        | elenco directory/file           | **dir**                                           |
+| copia            | cp                        | copia un file                   | **copy c:\test\test.txt c:\windows\test.txt** |
+| sposta           | mv                        | spostare un file                | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir            | mkdir                     | creare una nuova directory      | **mkdir testdirectory**                           |
+| rmdir (or del)   | rm                        | Eliminare un file               | **del c:\test\test.txt**                        |
+| rmdir /S         | rm -r                     | Seleziona una cartella          | **mkdir testdirectory**                           |
+| [CMD]/?          | man [CMD]                 | Ottieni un aiuto per un comando | **cd** (Windows) o **pwd** (Mac OS / Linux)       |
+
+Questi sono solo alcuni dei comandi che puoi eseguire sulla tua command line, ma non ne userai altri oltre a quelli spiegati oggi.
+
+Se sei curioso/a, [ss64.com](http://ss64.com) contiene una guida completa ai comandi per tutti i sistemi operativi.
+
+## Fatto?
+
+Tuffiamoci in Python!
\ No newline at end of file
diff --git a/it-IT/intro_to_command_line/open_instructions.md b/it-IT/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..881110fb1f6
--- /dev/null
+++ b/it-IT/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+A seconda della versione di Windows utilizzata e della propria tastiera, una delle azioni seguenti dovrebbe aprire una finestra di comando (probabilmente sarà necessario fare più prove, ma non è necessario provare tutti i suggerimenti proposti):
+
+- Andare al menù Start o alla schermata Start e digitare "Prompt dei comandi" nella barra di ricerca.
+- Andare al menù Start-->Sistema Windows-->Prompt dei Comandi.
+- Andare a menù Start-->Tutti i Programmi-->Accessori-->Prompt dei Comandi.
+- Andare alla schermata Start, spostare il mouse nell'angolo in basso a sinistra dello schermo e cliccare sulla freccia in basso che comparirà (per i dispositivi touch screen, scorrere verso l'alto dal fondo dello schermo). La pagina App dovrebbe aprirsi. Cliccare su Prompt dei Comandi nella sezione Sistema Windows.
+- Tenere premuto il tasto Windows e cliccare "X". Scegliere "Prompt dei Comandi" dal menù popup.
+- Tenere premuto il tasto Windows e premere "R" per aprire la finestra "Esegui". Digitare "cmd" nella casella di testo e premere OK.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Più avanti in questo tutorial, dovrete avere due finestre di comando aperte contemporaneamente. In ogni caso, in alcune versioni di Windows, se già si ha una finestra di comando aperta e si cerca di aprirne un'altra con lo stesso metodo, vi mostrerà la finestra di comando già aperta. Provate adesso sul vostro computer e vedete cosa accade! Se si riesce ad aprire solo una finestra di comando, provare un altro dei metodi sopra indicati. Almeno uno permetterà l'apertura di una nuova finestra di comando.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Andare ad Applicazioni-->Funzionalità-->Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Probabilmente si troverà in Applicazioni--> Funzionalità--> Terminal, ma dipende dal sistema operativo. Nel caso in cui non si trovasse, provare a fare una ricerca Google. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/it-IT/python_installation/README.md b/it-IT/python_installation/README.md
new file mode 100644
index 00000000000..4fc467a6976
--- /dev/null
+++ b/it-IT/python_installation/README.md
@@ -0,0 +1,15 @@
+# Iniziamo con Python
+
+Finalmente siamo qui!
+
+Ma prima, permettici di introdurre brevemente cos'è Python. Python è un linguaggio di programmazione molto popolare che può essere utilizzato per creare siti web, giochi, sofware scientifici, graffici e molto, molto altro.
+
+Python è stato creato alla fine degli anni '80 ed il suo obiettivo principale è quello di essere leggibile dalle persone (e non solo dalle macchine!). Per questo motivo sembra più semplice di altri linguaggi di programmazione, ma non preoccuparti -- Python è anche molto potente!
+
+# Installazione di Python
+
+> **Nota** Se utilizzi un Chromebook, salta questo capitolo e segui le istruzioni in [Configurazione di Chromebook](../chromebook_setup/README.md).
+> 
+> Se hai terminato il processo di installazione, questo passaggio lo hai già completato e puoi passare direttamente al capitolo successivo!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/it-IT/python_installation/instructions.md b/it-IT/python_installation/instructions.md
new file mode 100644
index 00000000000..488e112bab9
--- /dev/null
+++ b/it-IT/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Per le lettrici a casa: questo capitolo è trattato nel video [Installazione di Python & Editor di codice](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> Questa sezione è basata sul tutorial delle Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django è scritto in Python. Python ci serve per fare qualunque cosa in Django. Iniziamo con l'installazione! Dovresti installare la versione più recente di Python 3, quindi se hai una versione precendente dovrai aggiornarla. Se possiedi già la versione {{ book.py_min_version }} o una versione successiva non servono aggiornamenti.
+
+Installa Python normale come segue, anche quando hai Anaconda installato sul tuo computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Prima verifica se il computer sta eseguendo una versione a 32 bit o una versione a 64 bit di Windows, sulla linea "Tipo di sistema" della pagina Info di sistema. Per raggiungere questa pagina, prova uno di questi metodi:
+
+* Premi il tasto Windows e Pausa/Break contemporaneamente
+* Apri il tuo Pannello di Controllo dal menu Windows, quindi naviga nel sistema & Sicurezza, quindi sistema
+* Premi il pulsante Windows, quindi vai su Impostazioni > Sistema > Informazioni
+* Cerca "System Information" nel menu Start di Windows. Per fare ciò, clicca sul pulsante Start o premi il tasto Windows, poi inizia a digitare `System Information`. Inizierà a dare suggerimenti non appena digiterai. Puoi selezionare la voce una volta che compare.
+
+Puoi scaricare Python per Windows dal sito web https://www.python.org/downloads/windows/. Clicca sul link "Ultimo Python 3 - Python x.x.x". Se il tuo computer sta eseguendo una versione **64-bit** di Windows, scarica il file **Windows x86-64 di installer eseguibile**. Altrimenti, scarica il file **Windows x86 eseguibile installer**. Dopo aver scaricato il file *.msi, lo dovresti eseguire (cliccaci sopra due volte) e segui le istruzioni.
+
+Una cosa per cui guardare: durante l'installazione, si noti una finestra contrassegnata "Setup". Assicurati di selezionare la casellina "Add Python {{ book.py_version }} to PATH" o 'Aggiungi Python alle tue variabili ambientali" e clicca su "installa ora", come mostrato qui (potrebbe risultare leggermente diverso se stai installando una versione differente):
+
+![Non dimenticare di aggiungere Python al Path](../python_installation/images/python-installation-options.png)
+
+Quando l'installazione è completata, potresti vedere una finestra di dialogo con un link che puoi seguire per saperne di più su Python o sulla versione installata. Chiudi o annulla questa finestra -- imparerai molto di più in questo tutorial!
+
+Nota: Se si utilizza una versione precedente di Windows (7, Vista, o qualsiasi versione precedente) e l'installatore di Python {{ book.py_version }} non funziona per un errore, installare tutti gli aggiornamenti di Windows e provare a installare nuovamente Python. Se l'errore si ripresenta, prova ad installare la versione di Python {{ book.py_min_release }} da [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} ha bisogno di Python {{ book.py_min_version }} o maggiore, che non supporta Windows XP o versioni precedenti.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Nota** Prima di installare Python su OS X, devi fare in modo/ verificare che le impostazioni Mac consentano l'installazione di pacchetti che non sono presenti nell'App Store. Vai alle Preferenze di sistema (è nella cartella Applicazioni), clicca "Sicurezza & Privacy," e poi la scheda "Generale". Se il tuo "Consenti le app scaricate da:" è impostato su "Mac App Store", cambialo in "Mac App Store e sviluppatori identificati".
+
+Devi andare sul sito https://www.python.org/downloads/mac-osx/ e scaricare il programma di installazione di Python più recente:
+
+* Scarica il file *Mac OS X 64-bit/32-bit installer*
+* Fare doppio clic su *python-{{ book.py_release }}-macosx10.9.pkg* per eseguire l'installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+È molto probabile che tu abbia già installato Python fuori dalla scatola. Per verificare se è installata (e quale versione è), aprire una console e digitare il seguente comando:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+Se hai una versione diversa di Python installata, almeno {{ book.py_min_version }} (es. {{ book.py_min_release }}), allora non devi aggiornare. Se non hai Python installato, o se vuoi una versione diversa, controlla prima quale distribuzione Linux stai usando con il seguente comando:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+In seguito, a seconda del risultato, segui una delle seguenti guide di installazione sotto questa sezione.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Digita questo comando nella tua console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Usa questo comando nella tua console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+Se sei nelle vecchie versioni Fedora potresti ottenere un errore che il comando `dnf` non è stato trovato. In questo caso, devi utilizzare `yum` invece.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Usa questo comando nella tua console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verifica che l'installazione si sia conclusa correttamente aprendo l'applicazione *Terminal* ed eseguendo il comando `python3`:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+La versione mostrata può essere diversa da {{ book.py_release }} -- dovrebbe corrispondere alla versione installata.
+
+**NOTA:** Se sei su Windows e ricevi un messaggio di errore che dice che `python3` non è stato trovato, prova ad utilizzare `python` (senza `3`), controlla sia la versione di Python che è {{ book.py_min_version }} o superiore. Se anche questo non funziona, puoi aprire un nuovo prompt dei comandi e riprovare; questo accade se usi un prompt dei comandi aperto da prima dell'installazione di Python.
+
+* * *
+
+Se hai dubbi o se qualcosa è andato storto e non hai idea di cosa fare dopo - chiedi al tuo coach! A volte le cose non vanno come dovrebbero ed è meglio chiedere aiuto a qualcuno con più esperienza.
\ No newline at end of file
diff --git a/it-IT/python_introduction/README.md b/it-IT/python_introduction/README.md
new file mode 100644
index 00000000000..bec324366e0
--- /dev/null
+++ b/it-IT/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduzione a Python
+
+> Parte di questo capitolo è tratto dal tutorial delle Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Scriviamo un po' di codice!
+
+## La linea di comando di Python
+
+> Per chi ci segue da casa: questa parte si trova nel video [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U).
+
+Per iniziare a giocare con Python, devi avviare sul tuo computer una *linea di comando*. Dovresti già sapere come farlo – l'hai imparato nel capitolo [Introduzione alla riga di comando](../intro_to_command_line/README.md).
+
+Una volta pronta, segui le istruzioni riportate di seguito.
+
+Vogliamo aprire una console Python, quindi digita `python` su Windows o `python3` su Mac OS/Linux e premi `invio`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Il tuo primo comando Python!
+
+Dopo aver eseguito il comando Python, il prompt è cambiato in `>>>`. Questo ci informa che ora dovremo utilizzare comandi propri del linguaggio Python. Non devi digitare `>>>` - Python lo farà per te.
+
+Se ad un certo punto vuoi uscire dalla console di Python, digita `exit()` oppure usa la scorciatoia `Ctrl + Z` per Windows e `Ctrl + D` per Mac/Linux. Dopo non vedrai più `>>>`.
+
+Per il momento, non vogliamo uscire dalla console di Python. Vogliamo saperne di più. Iniziamo digitando qualche espressione matematica, come `2 + 3` e premiamo `invio`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Bello! Hai visto come le risposte spuntano fuori? Python conosce la matematica! Prova altri comandi come:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Per eseguire un calcolo esponenziale, per esempio 2 elevato alla potenza 3, digitiamo: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Giochicchia un po' con Python, e poi torna a leggere qui. :)
+
+Come puoi vedere, Python è una buona calcolatrice. Ora ti starai sicuramente chiedendo cos'altro è capace di fare…
+
+## Stringhe
+
+Che ne dici di scrivere il tuo nome? Digitalo tra virgolette così:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+Hai appena creato la tua prima stringa! Una stringa è una sequenza di caratteri che possono essere elaborati da un computer. La stringa deve sempre iniziare e finire con lo stesso carattere. Che può essere una virgoletta semplice (`'`) o doppia (`"`) (non c'è differenza!) Le virgolette dicono a Python che il contenuto al loro interno è una stringa.
+
+Le stringhe possono essere legate assieme. Prova questo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> " Ciao " + "Ola"
+'Ciao Ola'
+```
+
+Puoi anche moltiplicare le stringhe con un numero:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Se devi mettere un apostrofo nella tua stringa, hai due modi per farlo.
+
+Utilizzando le virgolette doppie:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "L'ape Maja va"
+"L'ape Maja va"
+```
+
+o facendo l'escape dell'apostrofo (cioè evitando che concluda la stringa) con una barra rovesciata (`\`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'L\'ape Maja va'
+"L'ape Maja va"
+```
+
+Bello, eh? Per vedere il tuo nome in maiuscolo, digita:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Hai appena applicato il **metodo** `upper` sulla tua stringa! Un metodo (come `upper()`) è una sequenza di istruzioni che Python deve compiere su un oggetto dato (la stringa `"Ola"`) nel momento in cui viene applicato.
+
+Se vuoi sapere il numero di lettere nel tuo nome, per questo c'è una **funzione**!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Ti stai chiedendo la differenza fra il chiamare una funzione con un `.` alla fine di una stringa (come `"Ola".upper()`) ed il chiamare prima la funzione e poi mettere la stringa tra parentesi? Beh, ci sono funzioni che appartengono ad oggetti, come `upper()`, che può essere eseguita solo su stringhe. In questo caso, chiamiamo la funzione **metodo**. Altre volte, le funzioni non appartengono a niente di specifico e possono essere utilizzate su diversi tipi di oggetti, proprio come `len()`. Ecco perché stiamo passando `"Ola"` come parametro alla funzione `len`.
+
+### Indice
+
+OK, basta con le stringhe. Ecco fino ad ora quanto hai imparato:
+
+- Il **prompt** -- Digitare i comandi (codice) nel prompt di Python restituisce risposte in Python
+- **Numeri e stringhe** -- In Python i numeri vengono utilizzati per la matematica e le stringhe per oggetti testuali
+- Gli **operatori** -- come `+` e `*`, combinano più valori per produrne uno nuovo
+- **funzioni** -- come `upper()` e `len()`, eseguono azioni su oggetti.
+
+Fin qui le basi del linguaggio di programmazione che stiamo imparando. Pronta per qualcosa di più complicato? Scommetto di sì!
+
+## Errori
+
+Proviamo una cosa diversa. Possiamo ottenere la lunghezza di un numero nella stessa forma in cui abbiamo potuto scoprire la lunghezza del nostro nome? Digita `len(304023)` e premi `Invio`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Abbiamo ottenuto il nostro primo errore! L'icona {{ warning_icon }} è il nostro modo per suggerirti che il codice che stai per eseguire non funzionerà come ti aspetti. Fare errori (anche intenzionali) è un elemento importante dell'apprendimento!
+
+Il testo dice che gli oggetti di tipo "int" (interi, numeri interi) non hanno lunghezza. Quindi cosa possiamo fare ora? Forse possiamo scrivere il nostro numero come stringa? Le stringhe hanno una lunghezza, giusto?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Ha funzionato! Abbiamo utilizzato la funzione `str` all'interno della funzione `len`. `str()` converte tutto in stringhe.
+
+- La funzione `str` converte le cose in **stringhe**
+- La funzione `int` converte le cose in **numeri interi**
+
+> Importante: possiamo convertire i numeri in testo, ma non possiamo convertire il testo in numeri - cosa potrebbe essere `int('hello')`?
+
+## Variabili
+
+Un concetto importante nella programmazione è quello delle variabili. Una variabile non è altro che un nome per qualcosa, così puoi usarla più tardi. I programmatori usano le variabili per memorizzare dati, rendere il loro codice più leggibile in modo da non dover continuare a ricordare le cose.
+
+Diciamo che vogliamo creare una nuova variabile chiamata `nome`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> nome = "Ola"
+```
+
+Praticamente, poniamo il valore della variabile <tt>nome</tt> uguale alla stringa "Ola".
+
+Come hai notato, il tuo programma non ha dato nessun risultato come ha fatto prima. Allora come facciamo a sapere che la variabile esiste veramente? semplicemente digita `nome` e premi `Invio`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> nome
+'Ola'
+```
+
+Urrà! La tua prima variabile! :) E puoi anche cambiare il valore a cui essa si riferisce:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> nome = "Sonja"
+>>> nome
+'Sonja'
+```
+
+La puoi utilizzare anche nelle funzioni:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(nome)
+5
+```
+
+Fantastico, vero? Naturalmente, le variabili possono essere qualsiasi cosa, così come i numeri! Prova questo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Ma cosa succede se utilizziamo il nome sbagliato? Riesci a immaginare cosa succederebbe? Proviamo!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Un errore! Come puoi vedere, Python ha diversi tipi di errori e questo qui si chiama **NameError**. Python ti darà questo errore se provi ad utilizzare una variabile che non è stata ancora definita. Se incontri questo errore più tardi, controlla il tuo codice per vedere se hai digitato in modo errato i nomi.
+
+Giocaci per un po' e vedi cosa puoi fare!
+
+## La funzione print
+
+Prova questo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> nome = 'Maria'
+>>> nome
+'Maria'
+>>> print(name)
+Maria
+```
+
+Quando digiti `name`, l'interprete di Python risponde con una stringa *rappresentazione* della variabile 'nome', che contiene le lettere M-a-r-i-a, circondate da singole virgolette, ''. Quando dici `print(nome)`, Python "stamperà" i contenuti della variabile sullo schermo, senza le virgolette, che è più pulito.
+
+Come vedremo dopo, `print()` è anche utile quando vogliamo stampare le cose dall'interno delle funzioni, oppure quando vogliamo stampare le cose in molteplici righe.
+
+## Liste
+
+Oltre alle stringhe ed ai numeri interi, Python ha tanti tipi di oggetti. Ora ne introdurremo uno chiamato **lista**. Le liste sono fatte proprio come immagini: sono oggetti che sono liste di altri oggetti. :)
+
+Vai avanti e crea una lista:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Sì, questa lista è vuota. Abbastanza inutile, vero? Creiamo una lista di numeri della lotteria. Non vogliamo ripetere la sequenza ogni volta, quindi metteremo anche la lista in una variabile:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lotteria = [3, 42, 12, 19, 30, 59]
+```
+
+Bene, abbiamo una lista! Cosa possiamo farne? Vediamo quanti numeri della lotteria contiene. Quale funzione potresti utilizzare per questo compito? Lo hai già imparato!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lotteria)
+8
+```
+
+Si! `len()` può darti il numero di oggetti in una lista. Utile, vero? Forse abbiamo risolto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lotteria.sort()
+```
+
+Questo comando non dà nessun risultato, ha semplicemente cambiato l'ordine in cui i numeri appaiono nella lista. Stampiamo di nuovo la lista per vedere cosa è successo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lotteria)
+[3, 12, 19, 30, 42, 59]
+```
+
+Come puoi vedere, adesso i numeri nella tua lista sono ordinati dal valore più basso a quello più alto. Congratulazioni!
+
+Vogliamo invertire quell'ordine? Facciamolo!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lotteria.reverse()
+>>> print(lotteria)
+[59, 42, 30, 19, 12, 3]
+```
+
+Facile, vero? Se vuoi aggiungere qualcosa alla tua lista, puoi farlo digitando questo comando:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lotteria.append(199)
+>>> print(lotteria)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Se vuoi mostrare solo il primo numero, puoi farlo usando gli **indici**. L'indice è il numero che dice la posizione esatta dell'elemento all'interno di una lista. I programmatori preferiscono iniziare a contare da 0, quindi il primo oggetto nella lista è all'indice 0, il successivo all'1, e così via. Prova questo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lotteria[0])
+59
+>>> print(lotteria[1])
+42
+```
+
+Come puoi vedere, puoi accedere a diversi oggetti nella tua lista usando il nome della lista e l'indice dell'oggetto all'interno delle parentesi quadre.
+
+Per eliminare qualcosa dalla lista dovrai usare gli **indici** come abbiamo visto sopra, e il metodo `pop()`. Proviamo a fare un esercizio per rafforzare quanto abbiamo imparato prima; elimineremo il primo numero della lista.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Ha funzionato a meraviglia!
+
+Prova altri indici: 6, 7, 1000, -1, -6 o -1000. Prova a prevedere il risultato ancora prima di eseguire il comando. Hanno senso i risultati?
+
+Per saperne di più su i metodi disponibili per le liste puoi consultare questo capitolo della documentazione Python: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dizionari
+
+> Per chi ci segue da casa: questa parte si trova nel video [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+
+Un dizionario (dictionary) è simile a una lista, ma accedi ai valori cercando una chiave invece di un indice. Una chiave può essere qualsiasi stringa o numero. La sintassi per definire un dizionario vuoto è:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Questo dimostra che hai appena creato un dizionario vuoto. Evviva!
+
+Ora, prova a scrivere il seguente comando (prova a sostituirlo con le tue informazioni):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> partecipante = {'nome': 'Ola', 'paese': 'Polonia', 'numeri_preferiti': [7, 42, 92]}
+```
+
+Con questo comando hai appena creato una variabile chiamata `partecipante` con tre coppie di chiavi-valori:
+
+- La chiave `nome` va a indicare il valore `'Ola'` (un oggetto `stringa`),
+- `paese` indica `'Polonia'` (un'altra `stringa`),
+- e `numeri_preferiti` indica `[7, 42, 92]` (una `lista` con tre numeri al suo interno).
+
+Puoi controllare il contenuto di chiavi individuali con questa sintassi:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(partecipante['nome'])
+Ola
+```
+
+Vedi, assomiglia ad una lista. Ma non devi ricordare l'indice - solo il nome.
+
+Cosa succede se chiediamo a Python il valore di una chiave che non esiste? Riesci a indovinarlo? Proviamo!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> partecipante['età']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'età'
+```
+
+Guarda, un altro errore! Questo qua è un **KeyError**. Python è utile e ti dice che la chiave `'età'` non esiste in questo dizionario.
+
+Quando usare un dizionario o una lista? Bella domanda. Prova a formulare una soluzione mentalmente prima di vedere la risposta nella prossima riga.
+
+- Ha bisogno di una sequenza ordinata di elementi? Fai una lista.
+- Hai bisogno di associare i valori alle chiavi, così che potrai cercarle agilmente (per chiave) dopo? Usa un dizionario.
+
+I dizionari, come le liste, sono *mutable*, significa che possono essere cambiati dopo che sono stati creati. Si possono aggiugere nuove coppie chiave/valore ad un dizionario dopo averlo creato:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> partecipante['linguaggio_preferito'] = 'Python'
+```
+
+Come le liste, usando la funzione `len()` sui dizionari restituisce il numero di coppie chiave-valore nel dizionario. Vai avanti e digita questo comando:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(partecipante)
+4
+```
+
+Spero che abbia senso per te. :) Pronta per divertirti con i dizionari? Vai alla prossima riga per realizzare altre cose fantastiche.
+
+Puoi usare il comando `del` per cancellare un elemento nella directory. Se vuoi cancellare la voce che corrisponde al tasto `'numeri_preferiti'`, digita il seguente comando:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Come puoi vedere dall'output, la coppia chiave-valore corrispondente alla chiave 'numeri_preferiti' è stato cancellata.
+
+Puoi anche cambiare un valore associato ad una chiave già creata nel dizionario. Digita:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> partecipante['paese'] = 'Germania'
+>>> partecipante
+{'paese': 'Germania', 'linguaggio_preferito': 'Python', 'nome': 'Ola'}
+```
+
+Come puoi vedere, il valore della chiave `'paese'` è stato cambiato da `'Polonia'` a `'Germania'`. :) Eccitante, vero? Evviva! Hai già imparato un'altra cosa fantastica.
+
+### Indice
+
+Fantastico! ora sai molto sulla programmazione. In questa ultima parte hai imparato:
+
+- **errori** - ora sai come leggere e capire gli errori che appaiono se Python non comprende un comando che gli hai dato
+- **variabili** - nomi per oggetti. Ti permettono di scrivere codice più semplice e di renderlo più leggibile
+- **liste** - liste di oggetti archiviati in un ordine particolare
+- **dizionari** - oggetti archiviati come coppie di chiave-valore
+
+Sei emozionato/a per la prossima parte? :)
+
+## Confrontare le cose
+
+> Per i lettori da casa: questa parte si trova nel video [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4).
+
+Larga parte della programmazione include il confrontare le cose. Qual è la cosa più semplice da confrontare? I numeri, senza dubbio. Vediamo come funziona:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+Abbiamo dato a Python dei numeri da confrontare. Come puoi vedere, non solo Python può confrontare i numeri, ma può anche confrontare i valori delle espressioni matematiche come `2 * 2` e i risultati delle funzioni come `2` restituiti da `len([4, 5])`. "Bello, eh?"
+
+Ti sei chiesta perché abbiamo messo due simboli di uguale `==` uno vicino all'altro per confrontare i numeri? Usiamo un singolo `=` per assegnare valori alle variabili. Sempre, **sempre** devi mettere due `==` se vuoi controllare se le cose sono uguali. Possiamo affermare anche che le cose sono diverse tra di loro. Per dirlo, usiamo il simbolo `!=`, come mostrato nell'esempio sopra.
+
+Dai a Python altri due compiti:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+`>` e `<` sono facili, ma cosa significano `>=` e `<=`? Leggili così:
+
+- x `>` y significa: x è maggiore di y
+- x `<` y significa: x è minore di y
+- x `<=` y significa: x è minore o uguale a y
+- x `>=` y significa: x è maggiore o uguale a y
+
+Fantastico! Vuoi farne due o tre? prova questo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Puoi dare a Python tutti i numeri da confrontare che vuoi, ti darà sempre una risposta! Molto intelligente, vero?
+
+- **and** - se usi l'operatore `e`, entrambe le cose confrontate devono essere True in modo tale che l'intero comando sia True
+- **or** - se usi l'operatore `o`, solo una delle cose messe a confronto deve essere True in modo tale che l'intero comando sia True
+
+Hai sentito parlare dell'espressione "comparare mele e arance"? Proviamo l'equivalente in Python:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Dall'espressione puoi capire che Python non è in grado di mettere a confronto un numero (`int`) e una stringa (`str`). Ci mostra invece un **TypeError** e ci dice che i due tipi non possono essere messi a confronto.
+
+## Booleano
+
+Tra parentesi, hai appena appreso di un nuovo tipo di oggetto in Python. Si chiama **Boolean**.
+
+Ci sono solo due oggetti Boolean:-True-False
+
+- Vero
+- Falso
+
+Ma perché Python possa capirlo, bisogna sempre scrivere True (prima lettera maiuscola, le altre minuscole). **true, TRUE, tRUE non funzionano -- solo True è corretto.** (Lo stesso vale per False, ovviamente.)
+
+I Boolean possono anche essere variabili! Guarda qui:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Lo puoi fare anche in questa forma:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Esercitati e divertiti con i valori booleani provando a eseguire i seguenti comandi:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congratulazioni! I valori Booleani sono tra le cose più interessanti della programmazione e tu hai appena imparato ad utilizzarli!
+
+# Salvalo!
+
+> Per i lettori da casa: questa parte si trova nel video [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk).
+
+Fino ad ora abbiamo scritto tutto il nostro codice Python nell'interprete, il ché ci limita ad una riga di codice alla volta. I programmi vengono salvati in file ed eseguiti dall'**interpreter** del nostro linguaggio di programmazione o dal **compiler**. Fino ad ora abbiamo eseguito i nostri programmi una riga per volta nell' **interprete** di Python. Avremo bisogno di più di una riga di codice per i prossimi compiti, quindi dovremo fare queste cose velocemente:
+
+- Uscire dall'interprete di Python
+- Aprire l'editor di codice che abbiamo scelto
+- Salvare un po' di codice in un file python
+- Eseguirlo!
+
+Per uscire dall'interprete di Python che abbiamo utilizzato, digita la funzione `exit()`
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Questo ti immetterà nel prompt dei comandi.
+
+Prima abbiamo scelto un editor di codice dalla sezione [editor di codice](../code_editor/README.md) . Dobbiamo aprire l'editor ora e scrivere un codice in un nuovo file (o se stai usando un Chromebook, creare un nuovo file nell'IDE cloud e aprire il file, che sarà incluso nell'editor di codice):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Ciao, Django girls!')
+```
+
+Ovviamente a questo punto sei una programmatrice Python senior, quindi sentiti libera di scrivere un po' del codice che hai imparato oggi.
+
+Ora dobbiamo salvare il file e dargli un nome descrittivo. Chiama il file **python_intro.py** e salvalo sulla tua scrivania. Puoi chiamare il file come vuoi, ma è importante assicurarsi che finisca con **.py**. L'estensione **.py** dice al Sistema Operativo che questo è un **file eseguibile python** e che Python può eseguirlo.
+
+> **Nota** Dovresti notare una delle cose più belle degli editori di codice: i colori! Nella console Python ogni cosa era dello stesso colore, mentre ora dovresti visualizzare la funzione `print` di un colore differente rispetto alla stringa che la segue. Questa viene chiamata "sintassi evidenziata", ed è veramente utile quando si scrive codice. Il colore serve come suggerimento, ad esempio per una stringa che non è chiusa, o un errore di digitazione di una keyword (come la `def` per le funzioni, che vedremo più avanti). Questo è uno dei motivi per cui usiamo un editor di codice. :)
+
+E' ora di eseguire il file! Usando le nozioni che hai imparato nella sezione command line, usa il terminal per **cambiare cartella** alla scrivania.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Su un Mac, il comando sarà più o meno così:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Su Linux, sarà così:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Ricorda che la parola "Desktop" potrebbe essere tradotta nella tua lingua.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+Nel prompt dei comandi di Windows, sarà così:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+E su windows, sara come questo:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Se sei bloccato, chiedi aiuto. Ecco esattamente per che cosa sono qui gli autobus!
+
+Ora usa Python per eseguire il codice nel file:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ciao, Django girls!
+    
+
+Nota: su Windows 'python3' non è riconosciuto come comando. Al contrario, usa 'python' per eseguire il file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Perfetto! Hai appena eseguito il tuo primo programma Python salvato su un file. Grande, no?
+
+Ora puoi continuare con uno strumento essenziale nella programmazione:
+
+## If … elif … else 
+
+Molte cose dovrebbero essere eseguite soltanto quando si incontrano certe condizioni. E' per questo che Python ha gli **if statements**.
+
+Sostituisci il codice nel file **python_intro.py** con questo:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Se salviamo questo codice e lo eseguiamo, incontriamo un errore come questo:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python si aspetta che gli vengano fornite ulteriori istruzioni che saranno eseguite se la condizione `3 > 2` risulterà vera (o `True` se vogliamo). Proviamo a fare in modo che Python stampi "Funziona!". Modifica il tuo codice nel tuo file **python_intro.py** con questo:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Vedi come abbiamo indentato la riga successiva usando 4 spazi? Si deve fare così in modo tale che Python sappia quale codice eseguire se il risultato è True. Puoi mettere uno spazio, ma la maggior parte dei programmatori di Python ne mettono 4 per rendere le cose più ordinate. Una singola scheda conterrà anche 4 spazi finché l'editor di testo è impostato per farlo. Quando hai fatto la tua scelta, non cambiarla! Se hai già indicizzato con 4 spazi, crea qualsiasi rientro futuro con 4 spazi - altrimenti potresti incorrere in problemi.
+
+Salvalo ed eseguilo di nuovo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+Funziona!
+```
+
+Nota: Ricorda che su Windows, 'python3' non è riconosciuto come comando. Da ora in poi, sostituisci 'python3' con 'python' per eseguire il file.
+
+### E se una condizione non è Vera?
+
+In esempi precedenti, il codice è stato eseguito solo quando le condizioni erano True. Ma Python ha anche gli `elif` e `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 è infatti maggiore di 2')
+else:
+    print('5 non è maggiore di 2')
+```
+
+Quando viene lanciato, mostrerà:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 è infatti maggiore di 2
+    
+
+Se 2 fosse più grande di 5, allora andrebbe in esecuzione il secondo comando. Facile, vero? Andiamo a vedere come funziona `elif`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+nome = 'Sonja'
+if nome == 'Ola':
+    print('Hey Ola!')
+elif nome == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonimo!')
+```
+
+ed eseguito:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+Hai visto cosa è successo? `elif` ti consente di aggiungere condizioni supplementari che verranno eseguite se nessuna delle condizioni precedenti viene soddisfatta.
+
+Allo statement iniziale `if` puoi far seguire tutti gli statement `elif` che vuoi. Per esempio:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python esegue ogni singolo test in sequenza e scrive:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfetto, posso apprezzare ogni dettaglio
+    
+
+## Commenti
+
+I commenti sono linee che iniziano con `#`. Puoi scrivere tutto ciò che vuoi dopo `#` e Python lo ignorerà. I commenti possono rendere il tuo codice più facile da capire per gli altri.
+
+Vediamo come funziona
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+Non devi scrivere un commento per ogni riga di codice, ma sono utili per spiegare perché il tuo codice sta facendo qualcosa, o fornire un riepilogo quando sta facendo qualcosa di complesso.
+
+### Indice
+
+Nei tre esercizi precedenti hai imparato:
+
+- come **confrontare le cose** - in Python puoi mettere a confronto le cose usando `>`, `>=`, `==`, `<=`, `<` e gli operatori `e`, `o`
+- i **Boolean** - una tipologia di oggetto che può avere solo uno di questi due valori: `True` o `False`
+- come **Salvare file** - archiviare codice nei file in modo da poter eseguire programmi più lunghi.
+- **if...elif...else** - affermazioni che ti permettono di eseguire codice solo quando vengono incontrate certe condizioni.
+- **commenti** - linee che Python non verrà eseguito che ti permettono di documentare il tuo codice
+
+E' ora dell'ultima parte del capitolo!
+
+## Le funzioni personalizzate!
+
+> Per i lettori da casa: questa parte si trova nel video [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0).
+
+Ti ricordi quelle funzioni che puoi eseguire in Python come `len()`? Beh, buone notizie, ora imparerai a scrivere delle funzioni tutte tue!
+
+Una funzione è una sequenza di istruzioni che Python dovrebbe eseguire. Ogni funzione in Python inizia con la parola chiave `def`, viene assegnato un nome e può avere alcuni parametri. Diamo un colpo. Sostituisci il codice nel file **python_intro.py** con il seguente:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def ciao():
+    print('Ciao!')
+    print('Come stai?')
+
+ciao()
+```
+
+Okay, la nostra prima funzione è pronta!
+
+Ti starai chiedendo perché abbiamo scritto il nome della funzione alla fine del file. Quando scriviamo `def hi():` e le seguenti linee indentate, questi siamo noi che scriviamo le istruzioni per cosa dovrebbe fare la funzione `hi()`. Python leggerà e ricorderà queste istruzioni, ma ancora non eseguirà la funzione. Per dire a Python che vogliamo eseguire la funzione, dobbiamo chiamare la funzione con `hi()`. Python legge il file e lo esegue dall'alto verso il basso, così che dobbiamo definire la funzione nel file prima di chiamarla.
+
+Eseguiamolo e vediamo cosa succede:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ciao!
+    Come stai?
+    
+
+Nota: se non ha funzionato, non panicare! L'output ti aiuterà a capire perché:
+
+- Se ottieni un `NameError`, questo probabilmente significa che hai digitato qualcosa di sbagliato, quindi dovresti controllare che tu abbia usato lo stesso nome quando crei la funzione con `def hi():` e quando lo chiamate con `hi()`.
+- Se ottieni un `IndentaionError`, controlla che entrambe le linee `print` abbiano lo stesso spazio bianco all'inizio di una linea: python vuole che tutto il codice all'interno della funzione sia allineato in modo adeguato.
+- Se non c'è nessun output, controlla che l'ultima `hi()` *non sia indentato* se è così, questa linea diventerà parte della funzione, e non verrà mai eseguita.
+
+E' stato facile! Costruiamo la nostra prima funzione con parametri. Useremo l'esempio precedente - una funzione che dice 'ciao' alla persona che lo esegue - aggiungendo il nome:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def ciao(nome):
+```
+
+Come puoi vedere, abbiamo dato alla nostra funzione un parametro chiamato `nome`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def ciao(nome):
+    if nome == 'Ola':
+        print('Ciao Ola!')
+    elif nome == 'Sonja':
+        print('Ciao Sonja!')
+    else:
+        print('Ciao anonimo!')
+
+ciao()
+```
+
+Ricorda: La funzione `print` è rientrata di 4 spazi rispetto allo statement `if`. Infatti, la funzione viene eseguita quando la condizione viene soddisfatta. Vediamo ora come funziona:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: ciao() missing 1 required positional argument: 'nome'
+    
+
+Ops, un errore. Fortunatamente, Python ci fornisce un messaggio di errore che ci può servire. Ci dice che la funzione `ciao()` (quella che abbiamo definito) ha un argomento richiesto (chiamato `nome`) e che ci siamo dimenticati di metterlo quando abbiamo chiamato la funzione. Sistemiamolo alla fine del file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+ciao("Ola")
+```
+
+Ed eseguiamo di nuovo:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ciao Ola!
+    
+
+E se cambiamo il nome?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+ciao("Sonja")
+```
+
+Ed eseguilo:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ciao Sonja!
+    
+
+Ora, cosa pensi che succederà se scrivi un altro nome? (non Ola o Sonja) Provaci e vedi se la tua ipotesi è giusta. Dovrebbe stampare questo:
+
+{% filename %}command-line{% endfilename %}
+
+    Ciao anonimo!
+    
+
+Fantastico, vero? In questo modo non devi ripetere tutto ogni volta che vuoi modificare il nome della persona che la funzione dovrebbe salutare. Ed è esattamente per questo che abbiamo bisogno delle funzioni - non vuoi ripetere il tuo codice!
+
+Facciamo qualcosa di più intelligente – ci sono più nomi di due, e scrivere una condizione per ciascuno sarebbe difficile, giusto? Sostituisci il contenuto del tuo file con i seguenti:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def ciao(nome):
+    print('Ciao ' + nome + '!')
+
+ciao("Rachel")
+```
+
+Ora chiamiamo il codice:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ciao Rachel!
+    
+
+Complimenti! Hai appena imparato a scrivere le funzioni! :)
+
+## Loop
+
+> Per i lettori da casa: questa parte si trova nel video [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0).
+
+È l'ultima parte. Abbiamo fatto in fretta, vero? :)
+
+I programmatori non amano ripetere ciò che scrivono. La programmazione mira a automatizzare le cose, non vorremo mica salutare ognuno col suo nome manualmente? Ecco un caso in cui i loop ci tornano comodi.
+
+Ti ricordi ancora delle liste? Facciamo una lista di ragazze:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+ragazze = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'Tu']
+```
+
+Vogliamo salutare tutte loro per nome. Abbiamo la funzione `ciao` per farlo, quindi usiamola in loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+Lo statement ~~~ for~~~ si comporta in modo simile allo statement ~~~ if~~~; il codice sottostante deve essere rientrato di quattro spazi.
+
+Qua c'è l'intero codice che sarà nel file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def ciao(nome):
+    print('Ciao ' + nome + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'Tu']
+for name in girls:
+    ciao(name)
+    print('Prossima ragazza')
+```
+
+E quando lo eseguiamo:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ciao Rachel!
+    Prossima ragazza
+    Ciao Monica!
+    Prossima ragazza
+    Ciao Phoebe!
+    Prossima ragazza
+    Ciao Ola!
+    Prossima ragazza
+    Ciao You!
+    Prossima ragazza
+    
+
+Come puoi vedere, tutto quello che metti all'interno di un `for` statement con una spaziatura si ripeterà per ogni elemento della lista `girls`.
+
+Puoi anche utilizzare `for` su numeri usando la funzione `range`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Che stamperà:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` è una funzione che crea una lista di numeri che si seguono uno dopo l'altro (questi numeri vengono forniti da te come parametri).
+
+Nota che il secondo di questi due numeri non è incluso nella lista prodotta da Python ( ciò significa che `range(1, 6)` conta da 1 a 5, ma non include il numero 6). Questo perché "range" è mezzo-aperto e con ciò intendiamo che include il primo valore, man non l'ultimo.
+
+## Indice
+
+È tutto. **Sei grande!** Questo capitolo non era affatto facile, puoi essere orgogliosa di te stessa. Noi siamo fierissimi di te per avercela fatta fino a qui!
+
+Per il tutorial ufficiale e completo di python visita https://docs.python.org/3/tutorial/. Questo ti darà uno studio più completo e completo della lingua. Saluti! :)
+
+Potresti desiderare di fare brevemente qualcos'altro - stiracchiati, fai due passi, riposa gli occhi - prima di continuare con il prossimo capitolo. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/it-IT/template_extending/README.md b/it-IT/template_extending/README.md
new file mode 100644
index 00000000000..5e06e2be4fd
--- /dev/null
+++ b/it-IT/template_extending/README.md
@@ -0,0 +1,151 @@
+# Estendere il template
+
+Un'altra cosa bella di Django è l'**estensione del template**. Cosa significa? Significa che puoi usare le stesse parti del tuo HTML per pagine diverse del tuo sito.
+
+I template ti aiutano quando vuoi usare le stesse informazioni o gli stessi layout in pagine diverse. Non devi ripetere lo stesso codice in ogni file. E se vuoi cambiare qualcosa, non lo devi fare in ogni template, ma solo in uno!
+
+## Creare un template di base
+
+Un template di base è il template più semplice. Lo puoi estendere ad ogni pagina del tuo sito.
+
+Creiamo un file `base.html` in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Poi aprilo nell'editor di codice e copia tutto da `post_list.html` al file `base.html`, in questo modo:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Poi nel `base.html`, rimpiazza tutto il tuo `<body>` (tutto quello che si trova tra `<body>` e `</body>`) con questo:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Potresti aver notato che questo sostituisce tutto da `{% for post in posts %}` a `{% endfor %}` con: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Perchè? Hai appena creato un blocco! Hai appena usato un template tag `{% block %}` per creare un area che che avrà dell'HTML all'interno. Questo codice HTML verrà da altri template che estenderanno questo (`base.html`). Ti mostreremo come farlo tra un attimo.
+
+Ora salva `base.html` e apri di nuovo il tuo `blog/templates/blog/post_list.html` nell'editor di codice. {% raw %}Rimuovi tutto quello che c'è prima di `{% for post in posts %}` e dopo `{% endfor %}`. Quando hai finito, il file apparirà così:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Vogliamo usare questa parte del nostro template per ogni blocco per i contenuti. Aggiungiamo un tag block in questo file!
+
+{% raw %}Dobbiamo fare in modo che il tuo tag block combaci con quello nel tuo file`base.html`. Dobbiamo anche includere tutto il codice del blocco dei contenuti. Per farlo, metti tutto tra `{% block content %}` e `{% endblock %}`. Come questo:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Un'ultima cosa. Dobbiamo collegare questi due template. È questo che vuol dire estendere i template! Lo faremo aggiungendo un tag extends all'inizio del file. Così:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Ecco fatto! Salva il file e controlla se il tuo sito web funziona ancora correttamente. :)
+
+> Se ottieni l'errore `TemplateDoesNotExist`, significa che non c'è nessun file `blog/base.html` e `runserver` è in esecuzione nella console. Prova ad arrestarlo (premendo Ctrl+C, i tasti Control e C insieme) e riavvialo utilizzando il comando `python manage.py runserver`.
\ No newline at end of file
diff --git a/it-IT/whats_next/README.md b/it-IT/whats_next/README.md
new file mode 100644
index 00000000000..4dcb13c2e48
--- /dev/null
+++ b/it-IT/whats_next/README.md
@@ -0,0 +1,43 @@
+# Quali sono le prospettive?
+
+Complimenti! **Sei veramente incredibile**. Siamo orgogliosi! <3
+
+### E ora cosa si fa?
+
+Per prima cosa: Pausa, Relax! Hai veramente appena fatto passi da gigante.
+
+Dopodichè, assicurati di seguire Django Girls in [ Facebook ](http://facebook.com/djangogirls) o [ Twitter](https://twitter.com/djangogirls) per restare aggiornata.
+
+### Mi puoi consigliare ulteriori risorse?
+
+Ma certo che sì! C'è una quantità *enorme* a dir poco, di risorse online per imparare i vari aspetti della programmazione — da farti perdere l'orientamento, tanto da impedirti di decidere in che direzione andare. Le Django Girls ti hanno preparato una selezione. Qualunque fosse il tuo interesse prima di iniziare questo tutorial, e qualunque sia l'interesse che questo tutorial ha maggiormente stimolato in te, qui ci sono un paio di risorse libere (o risorse con buona parte libera) per tornare ad orientarti, ed andare nella direzione che t'interessa.
+
+#### Django
+
+- Il nostro altro libro, [Django Girls Tutorial: Estensioni](https://tutorial-extensions.djangogirls.org/)
+- [Il tutorial ufficiale di Django's](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Le lezioni video su come incominciare con Django](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – alcune lezioni a video possono essere viste gratuitamente e, seguendoli, puoi ottenere un Certificato Coursera
+
+#### HTML, CSS e JavaScript
+
+- [Corso di sviluppo web di Codecademy](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Corso Python di Codecademy](https://www.codecademy.com/learn/learn-python)
+- [Corso Python di Google](https://developers.google.com/edu/python/)
+- [Libro: Impara Python The Hard Way](http://learnpythonthehardway.org/book/) – gli esercizi iniziali sono gratuiti
+- [Nuovi tutorial di Coder](http://newcoder.io/tutorials/) – Questo è una serie di esempi pratici di come utilizzare Python
+- [edX](https://www.edx.org/course?search_query=python) – puoi controllare la maggior parte dei corsi gratuiti, ma se si desidera un certificato o crediti verso una qualifica di istruzione superiore, allora questo costerà denaro
+- [specializzazione Python di questa persona](https://www.coursera.org/specializations/python) – alcune lezioni video possono essere revisionate gratuitamente e puoi ottenere un certificato di Coursera seguendo questi corsi
+- [Python per tutti](https://www.py4e.com/) - una versione libera e aperta del Coursera Python per la specializzazione di tutti i corpi
+
+#### Lavorare con i dati
+
+- [Corso di informatica di Codecademy](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – puoi controllare la maggior parte dei corsi gratuiti, ma se si desidera un certificato o crediti verso una qualifica di istruzione superiore, allora questo costerà denaro
+- [Dataquest](https://www.dataquest.io/) – le prime 30 "missioni" sono gratuite
+
+Non possiamo aspettare di vedere cosa costruirai in seguito!
\ No newline at end of file
diff --git a/it/README.md b/it/README.md
index 40e85c34b2e..ff58a719cfc 100644
--- a/it/README.md
+++ b/it/README.md
@@ -1,16 +1,22 @@
 # Il tutorial di Django Girls
 
-[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
 
-> Questo lavoro è sotto la licenza internazionale di Creative Commons Attribution-ShareAlike 4.0. Per vedere una copia di questa licenza, visita https://creativecommons.org/licenses/by-sa/4.0/
+> Questo lavoro è concesso sotto la licenza Creative Commons Attribuzione-ShareAlike 4.0 internazionale. Per visualizzare una copia di questa licenza, visita https://creativecommons.org/licenses/by-sa/4.0/
+
+## Benvenuta
+
+Benvenuta al tutorial Django Girls! Siamo felici di vederti qui :) In questo tutorial, ti porteremo in un viaggio sotto il cofano delle tecnologie web, offrendoti un assaggio di tutti i pezzetti e mozziconi che sono necessari per far funzionare il web come lo conosciamo.
+
+Come succede con tutte le cose sconosciute, questa sarà un'avventura - ma non preoccuparti: dato che hai già trovato il coraggio di venire fin qui, andrà tutto bene :)
 
 ## Introduzione
 
-Hai mai sentito che il mondo sta diventando sempre più tecnologico e sei in qualche modo rimasto indietro? ti sei mai chiesta come creare un sito web ma non hai mai avuto abbastanza motivazione per iniziare? Hai mai pensato che il mondo del software è troppo complicato per te persino per provare a fare qualcosa per conto tuo?
+Hai mai avuto l'impressione che il mondo stia diventando sempre più tecnologico e di essere per così dire (temporaneamente) rimasta indietro? ti sei mai chiesta come creare un sito web ma non hai mai avuto abbastanza motivazione per iniziare? Hai mai pensato che il mondo del software è troppo complicato per te persino per provare a fare qualcosa per conto tuo?
 
 Beh, abbiamo buone notizie per te! La programmazione non è così complicata come sembra e vogliamo dimostrati quanto può essere divertente.
 
-Il tutorial non ti trasformerà magicamente in un programmatore. Se vuoi diventare bravo/a, ci vorranno mesi o addirittura anni di apprendimento e pratica. Ma ti vogliamo dimostrare che la programmazione o creare siti web non è complicato come sembra. Proveremo a spiegarti diversi argomenti come meglio possiamo, in modo che non ti senta più intimidito/a dalla tecnologia.
+Questo tutorial non ti trasformerà magicamente in un programmatore. Se vuoi diventare bravo/a, ci vorranno mesi o addirittura anni di apprendimento e pratica. Ma ti vogliamo dimostrare che la programmazione o creare siti web non è complicato come sembra. Proveremo a spiegarti diversi argomenti come meglio possiamo, in modo che non ti senta più intimidito/a dalla tecnologia.
 
 Speriamo di essere in grado di farti amare la tecnologia come lo facciamo noi!
 
@@ -20,29 +26,26 @@ Una volta che avrai terminato il tutorial, avrai a disposizione una semplice app
 
 Assomiglierà (più o meno) a questo:
 
-![Figure 0.1][2]
+![Figure 0.1](images/application.png)
 
- [2]: images/application.png
+> Se lavori da solo/a al tutorial e non hai un insegnante che ti possa aiutare nel caso avessi qualche problema, abbiamo una chat per te: [!(Chat.svg)![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Abbiamo chiesto ai nostri insegnanti e partecipanti precedenti di esserci di volta in volta ed aiutare gli altri con il tutorial! Non aver paura di fare domande!
 
-> Se lavori da solo/a al tutorial e non hai un'insegnante che ti possa aiutare nel caso avessi qualche problema, abbiamo una chat per te: [![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge). Abbiamo chiesto ai nostri insegnanti e partecipanti precedenti di esserci di volta in volta ed aiutare gli altri con il tutorial! Non aver paura di fare domande!
+OK, [cominciamo dall'inizio...](./how_the_internet_works/README.md)
 
-OK, [cominciamo dall'inizio...][3]
+## Seguire il tutorial da casa
 
- [3]: ./how_the_internet_works/README.md
+È fantastico prendere parte a un workshop Django Girls, ma siamo consapevoli che non sempre è possibile essere presenti a un workshop. Questo è il motivo per cui ti invitiamo a provare seguendo il tutorial da casa. Per chi ci segue da casa, stiamo preparando alcuni video che renderanno più facile seguire il tutorial da sole. È ancora un lavoro in corso d'opera, ma col tempo ci saranno sempre saranno più argomenti trattati sul nostro canale YouTube, [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed).
 
-## Informazioni e contribuzioni
+In ogni capitolo già trattato, c'è un link che punta al video corretto.
 
-Questo tutorial è mantenuto da [DjangoGirls][4]. Se trovi errori o se vuoi aggiornare questo tutorial, [segui le linee guida per i collaboratori][5].
+## Informazioni e contribuzioni
 
- [4]: https://djangogirls.org/
- [5]: https://github.com/DjangoGirls/tutorial/blob/master/README.md
+Questo tutorial è mantenuto da [DjangoGirls](https://djangogirls.org/). Se trovi errori o se vuoi aggiornare questo tutorial, [segui le linee guida per i collaboratori](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
 
-## Vorresti aiutarci a tradurre il tutorial in un altra lingua?
+## Vuoi aiutarci a tradurre il tutorial in altre lingue?
 
-Attualmente, le traduzioni vengono mantenute sulla piattaforma crowdin.com in:
+Attualmente, le traduzioni vengono mantenute sulla piattaforma crowdin.com presso:
 
 https://crowdin.com/project/django-girls-tutorial
 
-Se la tua lingua non è elencata su crowding, per favore [apri una nuova istanza][6] con la tua lingua in modo che possiamo aggiungerla.
-
- [6]: https://github.com/DjangoGirls/tutorial/issues/new
\ No newline at end of file
+Se la tua lingua non è elencata su [crowdin](https://crowdin.com/), puoi [aprire una nuova istanza](https://github.com/DjangoGirls/tutorial/issues/new) segnalando la tua lingua, in modo che possiamo aggiungerla.
\ No newline at end of file
diff --git a/it/SUMMARY.md b/it/SUMMARY.md
index 694b07fd6b9..11b04b6e56d 100644
--- a/it/SUMMARY.md
+++ b/it/SUMMARY.md
@@ -2,9 +2,10 @@
 
 * [Introduzione](README.md)
 * [Installazione](installation/README.md)
+* [Installazione (chromebook)](chromebook_setup/README.md)
 * [Come funziona Internet](how_the_internet_works/README.md)
 * [Introduzione al command line](intro_to_command_line/README.md)
-* [Installazione di Python](python_installation/README.md)
+* [Istallazione di Python](python_installation/README.md)
 * [Code Editor](code_editor/README.md)
 * [Introduzione a Python](python_introduction/README.md)
 * [Che cos'è Django?](django/README.md)
@@ -14,12 +15,12 @@
 * [L'admin di Django](django_admin/README.md)
 * [Deploy!](deploy/README.md)
 * [Django URL](django_urls/README.md)
-* [Le views di Django - è arrivata l'ora di creare!](django_views/README.md)
+* [Le viste di Django – è arrivata l'ora di creare!](django_views/README.md)
 * [Introduzione all'HTML](html/README.md)
 * [ORM di Django (Querysets)](django_orm/README.md)
-* [I dati dinamici in templates](dynamic_data_in_templates/README.md)
+* [I dati dinamici nei templates](dynamic_data_in_templates/README.md)
 * [I templates di Django](django_templates/README.md)
-* [CSS - dagli un bell'aspetto](css/README.md)
+* [CSS - rendilo più carino](css/README.md)
 * [Estendere il template](template_extending/README.md)
 * [Estendi la tua applicazione](extend_your_application/README.md)
 * [Form Django](django_forms/README.md)
diff --git a/it/chromebook_setup/README.md b/it/chromebook_setup/README.md
new file mode 100644
index 00000000000..e04232191ff
--- /dev/null
+++ b/it/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Impostazione del chromebook
+
+> **Nota** Se hai già seguito tutti i passi durante la sezione Installazione, non è necessario rifare tutto di nuovo - puoi passare direttamente a [Introduzione a Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/it/chromebook_setup/instructions.md b/it/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..6ccd68d9cbb
--- /dev/null
+++ b/it/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+Puoi [saltare questa sezione](http://tutorial.djangogirls.org/en/installation/#install-python) se non stai usando un Chromebook. Altrimenti, la tua installazione seguirà una procedura diversa. Puoi ignorare il resto delle istruzioni di installazione.
+
+### Cloud9
+
+Cloud9 è uno strumento che mette a disposizione un editor e l'accesso ad un computer su Internet su cui puoi installare, scrivere ed eseguire il software. Per questo tutorial, Cloud9 sarà come il tuo *computer locale*. Potrai sempre scrivere comandi sul terminale come i tuoi compagni di classe su OS X, Ubuntu o Windows, ma il tuo terminale sarà connesso ad un computer attivo da un'altra parte, che Cloud9 configura per te.
+
+1. Installa Cloud 9dal [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Vai su [c9.io](https://c9.io)
+3. Registrati
+4. Clicca *Crea nuovo spazio di lavoro*
+5. Chiamalo *django-girls*
+6. Seleziona *Blank* (secondo da destra nella riga in basso con il logo arancione)
+
+Ora dovresti vedere un'interfaccia con una barra laterale, una grossa finestra principale con del testo, ed una piccola finestra in basso che somiglia a questa:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    tuonome:~/workspace $
+    
+
+Quest'area in basso è il tuo *terminale*, dove darai le tue istruzioni al computer che Cloud9 ha preparato. Puoi ridimensionare questa finestra per renderla un po' più grande.
+
+### Ambiente virtuale
+
+Un ambiente virtuale (in inglese virtual environment, abbreviato spesso in virtualenv) è come una scatola privata in cui possiamo mettere del codice per un progetto su cui stiamo lavorando. Li usiamo per tenere separati i vari pezzi di codice dei nostri progetti, affinchè non si crei confusione tra di essi.
+
+Nel terminale in basso dell'interfaccia di Cloud9, esegui:
+
+{% filename %} Nuvola 9 {% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+Se non funziona, chiedi aiuto al tuo coach.
+
+Poi, esegui:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(nota che nell'ultima linea abbiamo usato una tilde seguita da un segno di uguale: ~=).
+
+### Github
+
+Creare un account [Github](https://github.com).
+
+### PythonAnywhere
+
+Il tutorial Django Girls include una sezione chiamata Distribuzione, ovvero spostare su un computer accessibile a tutti (chiamato server) il codice che alimenta la tua nuova applicazione web, affinché altre persone possano vedere il tuo lavoro.
+
+Questa parte del tutorial è un po' strana seguendo il tutorial su un Chromebook, poiché stiamo già usando un computer che è già su internet (al contrario di, per esempio, un laptop). Comunque, è sempre utile, poichè possiamo pensare a Cloud9 come uno spazio con il nostro "lavoro in corso" e PythonAnywhere come al luogo dove mostrare i nostri programmi, in quanto diventano più completi.
+
+Quindi, registrati a PythonAnywhere su [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/it/code_editor/README.md b/it/code_editor/README.md
index 8261e76f6cb..73c28e7c960 100644
--- a/it/code_editor/README.md
+++ b/it/code_editor/README.md
@@ -1,7 +1,11 @@
-# Code Editor
+# L'editor di codice
+
+> Per i lettori a casa: questo capitolo è trattato nel video [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
 
 Stai per scrivere la tua prima riga di codice, per cui è il momento di scaricare il tuo editor!
 
-> **Nota** Potresti aver già affrontato questo passaggio nel capitolo Installazione - se è così, puoi saltare direttamente al prossimo capitolo!
+> **Nota** Se stai usando un Chromebook, salta questo capitolo e segui le istruzioni per il [setup su Chromebook](../chromebook_setup/README.md).
+> 
+> **Nota** Potresti aver già effettuato questo passaggio nel capitolo sull'installazione - in questo caso, puoi andare al prossimo capitolo!
 
-{% include "/code_editor/instructions.md" %}
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/it/code_editor/instructions.md b/it/code_editor/instructions.md
index bd6ab5614c2..bc78af308ad 100644
--- a/it/code_editor/instructions.md
+++ b/it/code_editor/instructions.md
@@ -1,6 +1,6 @@
-Sono disponibili diversi editor e la scelta di uno piuttosto che un altro dipende principalmente dal gusto personale. La maggior parte dei programmatori Python usa complessi ma estremamente potenti IDE (ambienti di sviluppo integrati), come PyCharm. Tuttavia, dal momento che sei ancora agli inizi non è l'editor più appropriato; quelli che ti suggeriremo noi sono ugualmente potenti ma molto più semplici da utilizzare.
+Ci sono un sacco di editor diversi e la scelta di quale usare dipende perlopiù dai gusti personali. La maggior parte dei programmatori Python usa IDE (ambienti di sviluppo integrati) complessi ma estremamente potenti, come PyCharm. Tuttavia, dal momento che sei ancora agli inizi, questo non è l'editor più appropriato; quelli che ti suggeriremo noi sono ugualmente potenti, ma molto più semplici da utilizzare.
 
-I nostri suggerimenti sono riportati qui di seguito, ma sentiti libero/a di chiedere al tuo coach quali sono le sue preferenze in materia di editor, in questo modo sarà più semplice per il tuo coach aiutarti.
+I nostri suggerimenti sono riportati qui di seguito, ma sentiti libera di chiedere al tuo coach quali sono le sue preferenze in materia di editor - in questo modo sarà più semplice per il tuo coach aiutarti.
 
 ## Gedit
 
@@ -16,16 +16,16 @@ Sublime Text è uno tra gli editor più utilizzati. Ha un periodo di prova gratu
 
 ## Atom
 
-Atom è un nuovo editor di codice creato da [GitHub](https://github.com/). È gratuito, open-source, facile da installare e da usare. È disponibile per Windows, OSX e Linux.
+Atom è un editor molto recente, creato da [GitHub](https://github.com/). È gratis, open_source, facile da installare e da usare. È disponibile per Windows, OS X e Linux.
 
 [Scaricalo qui](https://atom.io/)
 
-## Perché installiamo un editor di codice?
+## Perché installare un editor di codice?
 
-Forse ti stai chiedendo per quale motivo installiamo questo editor di codice invece di usare un applicazione come Word or Blocco Note.
+Forse ti stai chiedendo per quale motivo installiamo questo editor di codice, invece di usare un'applicazione come Word o Blocco Note.
 
-Il primo motivo è che il codice deve essere **testo semplice**, e il problema con programmi come Word e Textedit è che in realtà non producono testo semplice. Producono testo RTF (con caratteri e formattazione), utilizzando formati personalizzati come [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+La prima ragione è che il codice deve essere **testo semplice**, e programmi come Word e Textedit in realtà non producono questo tipo di testo, ma testo formattato (con font e formattazione) personalizzato come l'[RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
 
-La seconda ragione è che i code editor sono specializzati per programmare, perciò hanno molte funzionalità utili, ad esempio diversi colori per evidenziare frammenti di codice con diversi significati, o l'inserimento automatico del secondo paio di virgolette.
+La seconda ragione è che gli editor sono specializzati nel modificare codice, e quindi mettono a disposizione utili funzionalità come l'evidenziazione della sintassi con colori legati al suo significato, o la chiusura automatica di parentesi e virgolette.
 
-Vedremo tutto ciò più tardi. Il tuo fidato code editor sarà presto uno dei tuoi strumenti preferiti :)
\ No newline at end of file
+Vedremo tutto ciò più avanti. Presto, il tuo fidato editor di testo diventerà uno dei tuoi strumenti preferiti. :)
\ No newline at end of file
diff --git a/it/css/README.md b/it/css/README.md
index b7b87505dd2..c63238dbcf2 100644
--- a/it/css/README.md
+++ b/it/css/README.md
@@ -1,294 +1,304 @@
-# CSS - dagli un bel aspetto!
+# CSS - rendilo carino!
 
 Il nostro blog sembra ancora un pochino brutto, vero? È arrivato il momento di abbellirlo! Per fare ciò useremo CSS.
 
 ## Che cos'è CSS?
 
-Cascading Style Sheets (CSS) è un linguaggio usato per descrivere l'aspetto e la formattazione di un sito scritto in un linguaggio di markup (come HTML). Vedilo come il trucco del nostro sito ;).
+Il CSS (Cascading Style Sheet, fogli di stile a cascata) è un linguaggio usato per descrivere l'aspetto e la formattazione di un sito web scritto in un linguaggio di Markup (come l'HTML). Vedilo come il trucco per la nostra pagina. ;)
 
-Ma non vogliamo ricominciare da capo, giusto? Ancora una volta useremo qualcosa preparato da altri programmatori disponibile su Internet gratuitamente per tutti. Si sa, re-inventare la ruota non è molto divertente.
+Ma non vogliamo iniziare di nuovo dalle basi, vero? Ancora una volta, useremo qualcosa che i programmatori hanno rilasciato su internet gratuitamente. Reinventare la ruota non è divertente, come saprai.
 
 ## Usiamo Bootstrap!
 
-Bootstrap è uno dei più popolari framework HTML e CSS per costruire bellissimi siti internet: https://getbootstrap.com/
+Bootstrap è uno dei framework HTML e CSS più poplari per sviluppare bellissimi siti web: https:/getbootstrap.com/
 
-È stato scritto da programmatori che lavoravano per Twitter ed è ora sviluppato da volontari da ogni parte del mondo.
+È stato scritto dai programmatori che lavoravano per Twitter. Adesso è sviluppato da volontari provenienti da tutto il mondo!
 
-## Installa Bootstrap
+## Installare Bootstrap
 
-Per installare Bootstrap, avrai bisogno di aggiungere questo nel tag `<head>` del tuo file `.html` (`blog/templates/blog/post_list.html`):
+Per installare Bootstrap devi aggiungere nella sezione `<head>` del tuo file `.html`:
+
+{% filename %}blog/templates/blog/post_list{% endfilename %}
 
 ```html
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
 ```
 
-Le due linee sopra riportate non aggiungono nessun file al tuo progetto. Stanno solo reindirizzando ad alcuni files the esistono in internet. Ma non ti preoccupare troppo, vai avanti e apri la tua pagina web e ricarica la pagina. Eccolo qui!
-
-![Figura 14.1][1]
+Le due linee sopra riportate non aggiungono nessun file al tuo progetto. Stanno solo reindirizzando ad alcuni files the esistono in internet. Ma non ti preoccupare troppo, vai avanti, apri la tua pagina web e ricaricala. Eccolo qui!
 
- [1]: images/bootstrap1.png
+![Figura 14.1](images/bootstrap1.png)
 
 Sembra già più carino!
 
 ## File statici in Django
 
-Infine, daremo uno sguardo più approfondito a quelli che abbiamo chiamato **file statici**. I file statici sono tutti i tuoi CSS e le immagini -- file che non sono dinamici, il loro contenuto non dipende dal contesto della richiesta e sarà lo stesso per ogni utente.
+Infine, daremo uno sguardo più approfondito a quelli che abbiamo chiamato **file statici**. I file statici sono tutti i tuoi CSS e le tue immagini. Il loro contenuto non dipende dal contesto richiesto e sarà lo stesso per tutti gli utenti.
 
 ### Dove mettere i file statici in Django
 
-Come hai visto quando abbiamo eseguito `collectstatic` sul server, Django sa già dove trovare i file statici per l'app built-in "admin". Ora dobbiamo solo aggiungere alcuni file statici per la nostra app, `blog`.
+Django sa già dove può trovare i file statici per l'app "admin". Adesso andremo ad aggiungere qualche file statico per la tua app `blog`.
 
 Lo facciamo creando una cartella denominata `static` all'interno dela nostra app blog:
 
     djangogirls
     ├── blog
-    │   ├── migrations
-    │   └── static
+    |     ├── migrations
+    |     ├── static
+    |     └── templates
     └── mysite
+    
 
-
-Django troverà automaticamente tutte le cartelle chiamate "static" dentro le cartelle delle tua app, e sarà in grado di utilizzare il loro contenuto come file statici.
+Django trova automaticamente ogni cartella chiamata ''static'' all'interno di qualsiasi cartella della tua app. Quindi potrà usarne il contenuto come file statici.
 
 ## Il tuo primo file CSS!
 
-Ora, creiamo un file CSS, per poter aggiungere il tuo stile personale al tuo sito. Crea una nuova cartella dal nome `css` all'interno della tua cartella `static`. Poi, crea un nuovo file all'interno della tua cartella `css` e chiamalo `blog.css`. Fatto?
+Creiamo un file CSS, per aggiungere uno stile alla tua pagina web. Crea una nuova cartella dal nome `css` all'interno della tua cartella `static`. Poi, crea un nuovo file all'interno della tua cartella `css` e chiamalo `blog.css`. Fatto?
 
     djangogirls
     └─── blog
          └─── static
               └─── css
                    └─── blog.css
+    
 
+È il giunto il momento di scrivere un po' di CSS! Apri il file `static/css/blog.css` nel tuo editor di codice.
 
-È giunto il momento di scrivere un po' di CSS! Apri il file `static/css/blog.css` nel tuo editor di codice.
-
-Non ci dilungheremo troppo sul come personalizzare e imparare CSS in questo momento, dal momento che è abbastanza facile e puoi impararlo da solo/a alla fine di questo workshop. Ti raccomandiamo caldamente di seguire questo corso [Codeacademy HTML & CSS course][2] per imparare tutto quello che serve sapere per poter rendere più bello un sito internet con CSS.
-
- [2]: https://www.codecademy.com/tracks/web
-
-Facciamo comunque un esempio. Perchè non cambiare il colore del nostro header? Per decifrare i colori, i computer usano dei codici speciali. Questi codici cominciano con `#` a cui fanno seguito 6 caratteri, sia lettere (A-F) che numeri (0-9). Puoi trovare vari esempi di codici colore qui: http://www.colorpicker.com/. Puoi anche usare [colori predefiniti][3] come ad esempio `red` e `green`.
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
 
- [3]: http://www.w3schools.com/cssref/css_colornames.asp
+Facciamo comunque un esempio. Perchè non cambiare il colore del nostro header? Per decifrare i colori, i computer usano dei codici speciali. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). Per esempio, questo è il codice per il blu `#0000FF`. Puoi trovare i codici per molti colori qui: http://www.colorpicker.com/. Puoi anche usare [colori predefiniti](http://www.w3schools.com/colors/colors_names.asp) come ad esempio `red` e `green`.
 
 Aggiungi il seguente codice nel tuo file `static/css/blog.css`:
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 h1 a {
-    color: #FCA205;
+    color: #FCA205;
 }
 ```
 
-`h1 a` è un esempio di selettore CSS. Questo significa che stiamo cercando di cambiare lo stile su tutti gli elementi `a` all'interno di un elemento `h1` (in questo caso, abbiamo una linea di codice così strutturata: `<h1><a href="">link</a></h1>`). In questo caso, stiamo cercando di cambiare il colore con `#FCA205`, che corrisponde all'arancione. Ovviamente puoi mettere il codice di qualsiasi altro colore tu preferisca!
+`h1 a` è un esempio di selettore CSS. Questo significa che stiamo applicando il nostro stile a tutti gli elementi `a` contenuti in un elemento `h1`. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In questo caso, stiamo cercando di cambiare il colore con `#FCA205`, che corrisponde all'arancione. Ovviamente puoi mettere il codice di qualsiasi altro colore tu preferisca!
 
-In un file CSS definiamo lo stile degli elementi presenti nel file HTML. Gli elementi in questione vengono identificati con il nome (ad esempio `a`, `h1`, `body`) oppure con l'attributo `class` o l'attributo `id`. Class e id sono i nomi che assegni agli elementi. Le classi definiscono gruppi di elementi mentre gli id indicano uno specifico elemento. Ad esempio, il seguente elemento può essere identificato nel CSS utilizzando il nome del tag `a`, la classe `external_link` oppure l'id ` link_to_wiki_page`:
+In un file CSS definiamo lo stile degli elementi presenti nel file HTML. Il primo modo per identificare gli elementi è attraverso il loro nome. Potresti ricordarli come tags dalla sezione sull'HTML. Cose come `a`, `h1` e `body` sono tutti esempi di nomi di elementi. Possiamo identificare anche con l'attributo `class` o l'attributo `id`. Class e id sono i nomi che assegni agli elementi. Le classi definiscono gruppi di elementi mentre gli id indicano uno specifico elemento. Per esempio puoi identificare il tag seguente usando il nome `a`, la classe `external_link` o l'id `link_to_wiki_page`:
 
 ```html
 <a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
 ```
 
-Per saperne di più puoi leggere [CSS Selectors in w3schools][4].
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
 
- [4]: http://www.w3schools.com/cssref/css_selectors.asp
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
 
-Infine, dobbiamo anche far sapere al nostro template in HTML che abbiamo effettivamente aggiunto un po' di CSS. Apri il file `blog/templates/blog/post_list.html` e aggiungi la seguente riga di testo:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
 ```
 
-Per ora stiamo solamente caricando tutti i nostri static files :). Aggiungi questa riga di testo tra `<head>` e `</head>`, subito dopo il link al file CSS di Bootstrap (il browser legge i file nell'ordine in cui sono dati, per cui il codice nei nostri files può sovrascrivere il codice presente nei files di Bootstrap):
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <link rel="stylesheet" href="{% static 'css/blog.css' %}">
 ```
 
-Stiamo dicendo al nostro template dove trovare i nostri file CSS.
+Il browser legge i file nell'ordine in cui sono messi, quindi dobbiamo essere sicuri che sia nel posto giusto. Otherwise the code in our file may be overriden by code in Bootstrap files. Stiamo dicendo al nostro template dove trovare i nostri file CSS.
 
 Il tuo file dovrebbe avere questo aspetto:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
-    <head>
-        <title>Django Girls blog</title>
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
-        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
-    </head>
-    <body>
-        <div>
-            <h1><a href="/">Django Girls Blog</a></h1>
-        </div>
-
-        {% for post in posts %}
-            <div>
-                <p>published: {{ post.published_date }}</p>
-                <h1><a href="">{{ post.title }}</a></h1>
-                <p>{{ post.text|linebreaksbr }}</p>
-            </div>
-        {% endfor %}
-    </body>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
 </html>
 ```
 
 OK, salviamo il file e ricarichiamo la pagina web!
 
-![Figura 14.2][5]
-
- [5]: images/color2.png
+![Figura 14.2](images/color2.png)
 
 Ben fatto! Adesso potremmo dare un po' più d'aria alla nostra pagina web e aumentare il margine nella parte sinistra. Proviamo!
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 body {
-    padding-left: 15px;
+    padding-left: 15px;
 }
 ```
 
-Aggiungi questo al tuo CSS, salva il file e guarda il risultato!
+Add that to your CSS, save the file and see how it works!
 
-![Figura 14.3][6]
-
- [6]: images/margin2.png
+![Figura 14.3](images/margin2.png)
 
 Potremmo anche personalizzare lo stile calligrafico nel nostro header. Incolla quanto segue all'interno del tag `<head>` che si trova nel file `blog/templates/blog/post_list.html`:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
-<link href="https://fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
 ```
 
-Questa riga consente di importare un font chiamato *Lobster* da Google Fonts (https://www.google.com/fonts).
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
 
-Ora aggiungi `font-family: 'Lobster';` nel file CSS `static/css/blog.css` all'interno del blocco `h1 a` (il codice tra le due parentesi graffe, `{` e `}`) e ricarica la pagina:
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 h1 a {
-    color: #FCA205;
-    font-family: 'Lobster';
+    color: #FCA205;
+    font-family: 'Lobster';
 }
 ```
 
-![Figura 14.3][7]
-
- [7]: images/font.png
+![Figura 14.3](images/font.png)
 
 Grandioso!
 
-Come già accennato, il CSS utilizza il concetto di 'classe' che in pratica ti permette di assegnare uno specifico nome ad una parte del tuo documento HTML e di applicare uno stile solo a questa parte senza cambiare il resto. È di grande aiuto quando hai due div che hanno funzioni differenti (ad esempio uno è un header e l'altro un post), e non vuoi che appaiano uguali.
+Come già detto in precedenza, CSS possiede il concetto di classi. Questo ti permette identificare una parte del codice HTML e applicare lo stile solo su quella parte, senza modificare le altre. Questo è utilissimo! Potresti avere due div che hanno qualcosa di differente (come il tuo header e il tuo post). Una classe ti aiuta a renderli differenti.
 
 Prova a dare dei nomi ad alcune parti dell'HTML. Aggiungi una classe chiamta `page-header` al tuo `div` che contiene l'intestazione così:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="page-header">
-    <h1><a href="/">Django Girls Blog</a></h1>
+    <h1><a href="/">Django Girls Blog</a></h1>
 </div>
 ```
 
 E ora aggiungi una classe `post` al tuo `div` che contiene un articolo del blog.
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="post">
-    <p>published: {{ post.published_date }}</p>
-    <h1><a href="">{{ post.title }}</a></h1>
-    <p>{{ post.text|linebreaksbr }}</p>
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
 </div>
 ```
 
-Ora aggiungiamo dei blocchi di codice ai nostri nuovi selettori. I selettori che iniziano con `.` indicano una classe. Online ci sono molti tutorial e spiegazioni sul CSS che possono aiutarti a comprendere il codice che stiamo per scrivere. Per ora, copia e incolla quanto segue nel tuo file `mysite/static/css/blog.css`:
+Ora aggiungiamo dei blocchi di codice ai nostri nuovi selettori. I selettori che iniziano con `.` indicano una classe. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. Per ora, copia e incolla quanto segue nel tuo file `mysite/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 .page-header {
-    background-color: #ff9400;
-    margin-top: 0;
-    padding: 20px 20px 20px 40px;
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
 }
 
 .page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
-    color: #ffffff;
-    font-size: 36pt;
-    text-decoration: none;
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
 }
 
 .content {
-    margin-left: 40px;
+    margin-left: 40px;
 }
 
 h1, h2, h3, h4 {
-    font-family: 'Lobster', cursive;
+    font-family: 'Lobster', cursive;
 }
 
 .date {
-    float: right;
-    color: #828282;
+    color: #828282;
 }
 
 .save {
-    float: right;
+    float: right;
 }
 
 .post-form textarea, .post-form input {
-    width: 100%;
+    width: 100%;
 }
 
 .top-menu, .top-menu:hover, .top-menu:visited {
-    color: #ffffff;
-    float: right;
-    font-size: 26pt;
-    margin-right: 20px;
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
 }
 
 .post {
-    margin-bottom: 70px;
+    margin-bottom: 70px;
 }
 
 .post h1 a, .post h1 a:visited {
-    color: #000000;
+    color: #000000;
 }
 ```
 
 Ora aggiungi all'esterno del codice HTML riguardante i posts all'interno del blog alcuni elementi con definizione di classi. Sostituisci questo:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
-    <div class="post">
-        <p>published: {{ post.published_date }}</p>
-        <h1><a href="">{{ post.title }}</a></h1>
-        <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endfor %}
 ```
 
 nel file `blog/templates/blog/post_list.html` con quanto segue:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="content container">
-    <div class="row">
-        <div class="col-md-8">
-            {% for post in posts %}
-                <div class="post">
-                    <div class="date">
-                        {{ post.published_date }}
-                    </div>
-                    <h1><a href="">{{ post.title }}</a></h1>
-                    <p>{{ post.text|linebreaksbr }}</p>
-                </div>
-            {% endfor %}
-        </div>
-    </div>
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
 </div>
 ```
 
 Salva entrambi i file e ricarica la pagina web.
 
-![Figura 14.4][8]
-
- [8]: images/final.png
+![Figura 14.4](images/final.png)
 
-Woohoo! È fantastico, vero? Il codice che abbiamo appena inserito non è poi così difficile da comprendere, dovresti riuscire a capirne la maggior parte semplicemente leggendolo.
+Woohoo! È fantastico, vero? Guarda il codice che abbiamo appena incollato, per trovare i punti dove abbiamo aggiunto le classi nell'HTML usate nel CSS. Dove dovremmo modificare se volessimo la data in azzurro?
 
-Non farti spaventare, sperimenta con i CSS e prova a cambiare alcune cose. Se rompi qualcosa, non ti preoccupare, puoi sempre farlo tornare come era prima!
+Non aver paura di fare qualche esperimento con i CSS, prova a fare qualche modifica. Giocare con i CSS può aiutarti a capire cosa fanno le varie cose. If you break something, don't worry – you can always undo it!
 
-Compito per casa post-workshop: ti consigliamo caldamente di seguire [il corso su HTML & CSS di Codeacademy][2]. Così potrai imparare tutto ciò di cui hai bisogno per rendere i tuoi siti web più belli sfruttando il CSS.
+Ti raccomandiamo di fare questo corso gratuito: [Codeacademy HTML & CSS](https://www.codecademy.com/tracks/web). Può aiutarti a imparare tutto ciò che ti serve per rendere carini i tuoi siti con CSS.
 
 Pronta per il prossimo capitolo?! :)
\ No newline at end of file
diff --git a/it/deploy/README.md b/it/deploy/README.md
index 7108b23f80e..35087f182cf 100644
--- a/it/deploy/README.md
+++ b/it/deploy/README.md
@@ -2,25 +2,17 @@
 
 > **Nota** Il seguente capitolo è abbastanza difficile da capire fino in fondo. Non mollare e cerca di portarlo a termine; deployment (termine abbastanza complicato da tradurre, ma indica tutto ciò che tu rendi LIVE, accessibile sul web e non più solo dal tuo computer) è una parte importante nel processo di costruzione di un sito web. Questo capitolo è inserito a metà del tutorial per far sì che il tuo tutor possa aiutarti con il processo leggermente più complesso di messa online del sito. Questo significa che puoi ancora finire il tutorial da sola se sei a corto di tempo.
 
-Fino ad ora il tuo sito è accessibile solo dal tuo computer, ma ora imparerai come metterlo online! Deploying è il processo di pubblicazione online del tuo progetto in modo tale che sia visibile anche da altre persone :).
+Fino ad ora, il tuo sito web era presente solo sul tuo computer. Adesso imparerai come fare il deploy! Il deploy è il processo di pubblicazione online del tuo progetto in modo tale che sia visibile anche da altre persone. :)
 
-Come hai già visto, un sito internet ha sede in un server. Ci sono tantissimi server providers disponibili su internet. Noi ne useremo uno che ha un processo di deployment relativamente semplice: [PythonAnywere][1]. Questo provider è gratuito per piccole applicazioni che non hanno troppi visitatori. Sarà quindi perfetto per te al momento.
+Come si è appreso, un sito Web deve trovarsi su un server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
- [1]: https://pythonanywhere.com/
+L'altro servizio esterno che useremo è [GitHub](https://www.github.com), che è un servizio di hosting di codice. Ne esistono altri, ma di questi tempi quasi tutti i programmatori hanno un account GitHub e ora lo avrai anche tu!
 
-L'altro servizio esterno che useremo è [GitHub][2], che è un servizio di hosting di codice. Ne esistono altri, ma di questi tempi quasi tutti i programmatori hanno un account GitHub e ora lo avrai anche tu!
-
- [2]: https://www.github.com
-
-Useremo GitHub come trampolino di lancio per importare ed esportare il nostro codice su PythonAnywhere.
+Questi tre servizi saranno importantissimi per te. Il tuo computer in locale sarà il posto in cui svilupperai e farai test. Quando sei soddisfatto delle modifiche, caricherai una copia del programma su GitHub. Il tuo sito Web sarà su PythonAnywhere e lo aggiornerai con una nuova copia del codice da GitHub.
 
 # Git
 
-Git è un "sistema di controllo versione" utilizzato da un sacco di programmatori. Questo software può tracciare le modifiche nel corso del tempo ad i file, in questo modo puoi ripristinare successivamente una specifica versione. Un pò come l'opzione "traccia modifiche" in Microsoft Word, ma molto più potente.
-
-## Installare Git
-
-> **Nota** Se hai già fatto la procedura di installazione, non devi farlo di nuovo - si può passare alla sezione successiva e iniziare a creare il tuo repository Git.
+> **Nota** Se hai giá eseguito i passagi di installazione, non é necessario eseguire nuovamente questa operazione - puoi andare alla sezione successiva e iniziare a creare il tuo repository Git.
 
 {% include "/deploy/install_git.md" %}
 
@@ -28,7 +20,9 @@ Git è un "sistema di controllo versione" utilizzato da un sacco di programmator
 
 Git tiene traccia delle modifiche a un particolare insieme di file in quello che è chiamato repository di codice (o "repo" in breve). Iniziamone uno per il nostro progetto. Apri la console ed esegui questi comandi nella directory `djangogirls`:
 
-> **Nota** controlla la directory su cui stai lavorando adesso con il comando `pwd`(OSX/Linux) oppure `cd`(Windows) prima di iniziare il repository. Dovresti essere nella cartella `djangogirls`.
+> **Nota** Controlla la tua cartella di lavoro corrente con a`pwd`(Mac OS X/Linux) o`cd` (Windows) comando prima di inizziare il repository. Dovresti essere nella cartella `djangogirls`.
+
+{% filename %}comando-linea{% endfilename %}
 
     $ git init
     Initialized empty Git repository in ~/djangogirls/.git/
@@ -36,23 +30,30 @@ Git tiene traccia delle modifiche a un particolare insieme di file in quello che
     $ git config --global user.email you@example.com
     
 
-Dobbiamo inizializzare il repository git solo una volta per ogni progetto (e non dovrai più reinserire il nome utente e l'email).
+L'inizializzazione del repository git é qualcosa che dobbiamo fare una sola volta per progetto (e non dovrai piú reinserire il nome utente e l'indirizzo email).
 
 Git memorizzerà le modifiche a tutti i file e le cartelle in questa directory, ma ci sono alcuni file che vogliamo ignorare. Si fa creando un file chiamato `.gitignore` nella directory di base. Apri il tuo editor e crea un nuovo file con questo contenuto:
 
+{% filename %}.gitignore{% endfilename %}
+
     *.pyc
+    *~
     __pycache__
     myvenv
     db.sqlite3
-    /static
-    .DS_Store
+    /statica
+    .DS_Negozio
     
 
 E salvalo come `.gitignore` all'interno della cartella "djangogirls".
 
-> **Nota** Il punto all'inizio del nome del file è importante! Se hai difficoltà nel crearlo (ad esempio, ai Mac non piace quando crei file che iniziano con un punto tramite il Finder), allora usa la funzionalità "Salva con nome" nel tuo editor, è a prova di bomba.
+> **Nota** Il punto all'inizio del nome del file è importante! Se hai difficoltá a crearlo (per esempio, Mac non piacere creare file che iniziano con un punto attraverso il Finder), usa la funzione "salva con nome" nell'editor, é a prova di proiettile.
+> 
+> **Nota** Uno dei file che hai specificato nel tuo`.ginignore`il file é`db.sqlite3`. Quel file é il tuo database locale, in cui sono archiviate tutte le tue pubblicazioni. Non vogliamo aggiungere questo al tuo repository perché il tuo sitio web in PythonAnywhere utilizzerá un database diverso. Quel database potrebbe essere SQLite, come la tua macchina di sviluppo, ma generalmente usa una chiamata MySQL che puó gestire molti piú visitatori del sitio di SQLite. Ad ogni modo, ignorando il tuo database SQLite per la copia di GitHub, significa che tutte le pubblicazioni che hai creato fino ad ora rimarranno e saranno disponibili solo localmente, ma dovrai aggiungerle nuovamente in produzione. Dovresti pensare al database locale come un parco giochi dove si possono provare cose diverse e senza avere paura di eliminare i tuoi messaggi reali dal tuo blog.
+
+È una buona idea usare il comando `git status` prima di `git add` oppure ogni volta che non sei sicuro di cosa sia cambiato. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
 
-È una buona idea usare il comando `git status` prima di `git add` oppure ogni volta che non sei sicuro di cosa sia cambiato. Questo aiuterà ad evitare eventuali brutte sorprese, come file sbagliati che vengono aggiunti o a cui viene fatto il commit. Il comando `git status` restituisce informazioni riguardanti qualsiasi file non tracciato/modificato/in staging, lo stato del branch e molto altro. L'output dovrebbe essere simile a:
+{% filename %}command-line{% endfilename %}
 
     $ git status
     On branch master
@@ -72,215 +73,163 @@ E salvalo come `.gitignore` all'interno della cartella "djangogirls".
 
 E finalmente salviamo le nostre modifiche. vai alla tua console ed esegui questi comandi:
 
+{% filename %}command-line{% endfilename %}
+
     $ git add --all .
-    $ git commit -m "La mia app Django Girls, primo commit"
+    $ git commit -m "My Django Girls app, first commit"
      [...]
      13 files changed, 200 insertions(+)
      create mode 100644 .gitignore
      [...]
      create mode 100644 mysite/wsgi.py
+     ```
     
-
-## Pubblichiamo il nostro codice su GitHub
-
-Vai su [GitHub.com][2] e registrati per ottenere un nuovo account gratuito. (Se l'hai già fatto nella preparazione di laboratorio, è fantastico!)
-
-Quindi, crea un nuovo repository, dandogli il nome "my-first-blog". Lascia deselezionata la casella di controllo "initialise with a README", lascia l'opzione di .gitignore vuota (lo abbiamo fatto manualmente) e License su None.
-
-![][3]
-
- [3]: images/new_github_repo.png
-
-> **Nota** Il nome `my-first-blog` è importante -- potresti scegliere qualcos'altro, ma si ripeterà un sacco di volte nelle istruzioni qui sotto, e dovrai sostituirlo ogni volta. Probabilmente è più facile mantenere il nome `my-first-blog`.
-
-Nella schermata successiva, ti verrà mostrato l'URL per clonare il tuo repo:
-
-![][4]
-
- [4]: images/github_get_repo_url_screenshot.png
-
-Ora abbiamo bisogno di collegare il repository Git sul tuo computer a quello su GitHub.
-
-Digita quanto segue sulla tua console (Sostituisci `<your-github-username>` con il nome utente che hai inserito quando hai creato il account GitHub, ma senza le parentesi angolari):
-
-    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
-    $ git push -u origin master
     
-
-Inserisci il tuo username e la tua password di GitHub. Dovresti vedere qualcosa di simile:
-
-    Username for 'https://github.com': hjwp
-    Password for 'https://hjwp@github.com':
-    Counting objects: 6, done.
-    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
-    Total 3 (delta 0), reused 0 (delta 0)
-    To https://github.com/hjwp/my-first-blog.git
-     * [new branch]      master -> master
-    Branch master set up to track remote branch master from origin.
+    ## Pushing your code to GitHub
     
-
-<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extention -->
-
-Adesso Il tuo codice è su GitHub. Ora controlla! Scoprirai che è in bella compagnia - [Django][5], il [Django Girls Tutorial][6] e molti altri grandi progetti open source software usano GitHub per ospitare il loro codice :)
-
- [5]: https://github.com/django/django
- [6]: https://github.com/DjangoGirls/tutorial
-
-# Configurare il nostro blog su PythonAnywhere
-
-> **Nota** Potresti aver già creato un account di PythonAnywhere precedentemente, durante i passaggi di installazione - se è così, non c'è bisogno di farlo nuovamente.
-
-{% include "/deploy/signup_pythonanywhere.md" %}
-
-## Scaricare il nostro codice su PythonAnywhere
-
-Quando ti sarai registrata su PythonAnywhere, verrai portata alla tua dashboard o alla pagina «Console». Scegli l'opzione per iniziare una console "Bash" -- quella è la versione PythonAnywhere di una console, proprio come quella sul tuo computer.
-
-> **Nota** PythonAnywhere è basato su Linux, quindi se sei su Windows, la console apparirà un po' diversa da quella sul tuo computer.
-
-Scarichiamo il nostro codice da GitHub e su PythonAnywhere creando un "clone" del nostro repo. Digita quanto segue nella console su PythonAnywhere ( non dimenticare di usare il tuo nome utente di GitHub al posto di `<your-github-username>`):
-
-    $ git clone https://github.com/<your-github-username>/my-first-blog.git
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
     
-
-Questo scaricherà una copia del tuo codice su PythonAnywhere. Dai un'occhiata digitando `tree my-first-blog`:
-
-    $ tree my-first-blog
-    my-first-blog/
-    ├── blog
-    │   ├── __init__.py
-    │   ├── admin.py
-    │   ├── migrations
-    │   │   ├── 0001_initial.py
-    │   │   └── __init__.py
-    │   ├── models.py
-    │   ├── tests.py
-    │   └── views.py
-    ├── manage.py
-    └── mysite
-        ├── __init__.py
-        ├── settings.py
-        ├── urls.py
-        └── wsgi.py
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
     
-
-### Creare un virtualenv su PythonAnywhere
-
-Proprio come hai fatto sul tuo computer, puoi creare un virtualenv su PythonAnywhere. Nella console di Bash, digita:
-
-    cd my-first-blog
+    <img src="images/new_github_repo.png" />
     
-    $ virtualenv --python=python3.4 myvenv
-    Running virtualenv with interpreter /usr/bin/python3.4
-    [...]
-    Installing setuptools, pip...done.
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
     
-    $ source myvenv/bin/activate
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
     
-    (mvenv) $  pip install django==1.8 whitenoise==2.0
-    Collecting django
-    [...]
-    Successfully installed django-1.8.2 whitenoise-2.0
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
     
 
-> **Nota** Il passaggio `pip install` può richiedere un paio di minuti. Sii paziente! Ma se richiede più di 5 minuti, c'è qualcosa di sbagliato. Chiedi al tuo coach.
-
-<!--TODO: think about using requirements.txt instead of pip install.-->
-
-### Raccogliere file statici.
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
 
-Ti stavi chiedendo cos'è quel "whitenoise"? È uno strumento per fornire i cosiddetti "file statici". I file statici sono i file che di solito non cambiano o non eseguono codice di programmazione, come i file HTML o CSS. Funzionano in modo diverso sui server e abbiamo bisogno di uno strumento come "whitenoise" per fornirli.
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
 
-Scopriremo un po' di più sui file statici più tardi nell'esercitazione, quando modificheremo il CSS per il nostro sito.
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
 
-Per ora abbiamo solo bisogno di eseguire un comando supplementare chiamato `collectstatic`, sul server. Dice a Django di raccogliere tutti i file statici di cui ha bisogno sul server. Al momento questi sono per lo più file che fanno apparire carino il sito di amministrazione.
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
 
-    (mvenv) $ python manage.py collectstatic
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
     
-    You have requested to collect static files at the destination
-    location as specified in your settings:
+    Your code is now on GitHub. Ora controlla!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
     
-        /home/edith/my-first-blog/static
     
-    This will overwrite existing files!
-    Are you sure you want to do this?
+    # Setting up our blog on PythonAnywhere
     
-    Type 'yes' to continue, or 'no' to cancel: yes
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
     
-
-Digita "yes" e si parte! Non ti piace far stampare al computer pagine e pagine di testo incomprensibile? Faccio sempre piccoli versi per accompagnarlo. Brp, brp brp...
-
-    Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/actions.min.js'
-    Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/inlines.min.js'
-    [...]
-    Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/changelists.css'
-    Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/base.css'
-    62 static files copied to '/home/edith/my-first-blog/static'.
+    {% include "/deploy/signup_pythonanywhere.md" %}
     
-
-### Creare il database su PythonAnywhere
-
-Ecco un'altra differenza tra il tuo computer ed il server: usa un database diverso. Quindi gli account utente ed i post possono essere diversi sul server rispetto a come appaiono sul tuo computer.
-
-Possiamo inizializzare il database sul server proprio come abbiamo fatto sul tuo computer, con `migrate` e `createsuperuser`:
-
-    (mvenv) $ python manage.py migrate
-    Operations to perform:
-    [...]
-      Applying sessions.0001_initial... OK
     
+    ## Pulling our code down on PythonAnywhere
     
-    (mvenv) $ python manage.py createsuperuser
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Scarichiamo il nostro codice da GitHub e su PythonAnywhere creando un "clone" del nostro repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
     
 
-## Pubblicare il nostro blog come una web app
-
-Ora il nostro codice è su PythonAnywhere, il nostro virutualenv è pronto, i file statici sono stati raccolti, ed il database è stato inizializzato. Siamo pronti a pubblicarlo come una web app!
-
-Torna alla dashboard di PythonAnywhere cliccando sul suo logo, e clicca sulla scheda **Web**. Infine, premi **Add a new web app**.
-
-Dopo aver confermato il nome del dominio, scegli **manual configuration** (NB *non* l'opzione "Django") nella finestra di dialogo. Successivamente, scegli **Python 3.4** e clicca su Avanti per completare la procedura guidata.
-
-> **Nota** assicurati di aver scelto l'opzione "Manual configuration", non l'opzione "Django". Siamo troppo cool per l'installazione di Django di PythonAnywhere di default;-)
-
-### Impostare il virtualenv
-
-Verrai portato alla schermata di configurazione PythonAnywhere per tua webapp, che è dove dovrai andare ogni volta che desideri apportare modifiche all'applicazione sul server.
-
-![][7]
-
- [7]: images/pythonanywhere_web_tab_virtualenv.png
+$ git clone https://github.com/<your-github-username>/mio-primo-blog.git
 
-Nella sezione "Virtualenv", clicca sul testo rosso che dice "Enter the path to a virtualenv" ed immetti: `/home/<your-username>/my-first-blog/myvenv/`. Clicca sul riquadro blu con il segno di spunta per salvare il percorso prima di andare avanti.
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-> **Note** Sostituisci il tuo nome utente come appropriato. se commetti un errore, PythonAnywhere ti avvertirà.
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
 
-### Configurare il file WSGI
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-Django funziona usando il "protocollo WSGI", uno standard per fornire siti Web utilizzando Python, che PythonAnywhere supporta. Il modo in cui configuriamo PythonAnywhere per riconoscere il nostro blog in Django è modificando un file di configurazione WSGI.
+$ cd mio-primo-blog
 
-Clicca sul link "WSGI configuration file" (nella sezione "Code" nella parte superiore della pagina -- avrà un nome tipo `/var/www/<il-tuo-username> _pythonanywhere_com_wsgi.py`), e accederai ad un editor.
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
 
-Elimina tutti i contenuti e sostituiscili con qualcosa di simile:
+$ source myvenv/bin/activate
 
-```python
-import os
-import sys
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
 
-path = '/home/<il-tuo-username>/my-first-blog'  # usa il tuo username qui
-if path not in sys.path:
-    sys.path.append(path)
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
 
-from django.core.wsgi import get_wsgi_application
-from whitenoise.django import DjangoWhiteNoise
-application = DjangoWhiteNoise(get_wsgi_application())
-```
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
 
-> **Nota** non dimenticare di mettere il tuo nome utente dove dice `<il-tuo-username>`
+Questo al fine di dire a PythonAnywhere dove è la nostra web app e qual è il nome del file Django.
 
-Il compito di questo file è dire a PythonAnywhere dove si trova la nostra web app e qual è il nome del file che contiene le impostazioni Django. Inolte, configura lo strumento di file statici "whitenoise".
+Il `StaticFilesHandler` si occupa dei nostri CSS. Questo è gestito automaticamente durante lo sviluppo locale dal comando `runserver`. Scopriremo un po' di più sui file statici più tardi nell'esercitazione, quando modificheremo il CSS per il nostro sito.
 
 Clicca **Save** e poi torna alla scheda **Web**.
 
@@ -288,26 +237,24 @@ Abbiamo finito! Premi il grande pulsante verde **Reload** e potrai vedere la tua
 
 ## Suggerimenti per il debug
 
-Se vedi un errore quando provi a visitare il tuo sito, il primo posto dove cercare qualche info per il debugging è nel tuo **error log**. Troverai un link nella [ scheda Web][8] di PythonAnywhere. Vedi se ci sono messaggi di errore lì; i più recenti sono alla fine. I problemi comuni includono:
+Se vedi un errore quando provi a visitare il tuo sito, il primo posto dove cercare qualche info per il debugging è nel tuo **error log**. Troverai un link nella [ scheda Web](https://www.pythonanywhere.com/web_app_setup/) di PythonAnywhere. Vedi se ci sono messaggi di errore lì; i più recenti sono alla fine. Problemi comuni includono:
 
- [8]: https://www.pythonanywhere.com/web_app_setup/
+- Dimenticare uno degli step che abbiamo fatto nella console: creare il virtualenv, attivarlo, installare Django, migrare il database.
 
-*   Dimenticare uno dei passi che abbiamo fatto nella console: creare il virtualenv, attivarlo, installarci Django, eseguire collecstatic, inizializzazione del database.
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
 
-*   Commettere un errore nel percorso del virtualenv sulla scheda Web -- di solito c'è un piccolo messaggio di errore in rosso, se c'è un problema.
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
 
-*   Commettere un errore nel file di configurazione WSGI -- il percorso che hai trovato per tua cartella my-first-blog è corretto?
+- Hai adottato la stessa versione di Python per il tuo virtualenv come hai fatto per la tua app web? entrambe dovrebbero essere 3.6.
 
-*   Hai adottato la stessa versione di Python per il tuo virtualenv come hai fatto per la tua app web? entrambe dovrebbero essere 3.4.
-
-*   Ci sono alcuni [consigli generali per il debugging sulla wiki di PythonAnywhere][9].
-
- [9]: https://www.pythonanywhere.com/wiki/DebuggingImportError
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
 
 E ricorda, il tuo coach è qui per aiutarti!
 
 # Sei live!
 
-La pagina predefinita per il tuo sito dovrebbe dire "Welcome to Django", esattamente come sul tuo Pc locale. Prova ad aggiungere `/admin/` alla fine della URL, e verrai portata al sito di amministrazione. Accedi con il tuo username e password, e vedrai che puoi aggiungere nuovi Post sul server.
+The default page for your site should say "It worked!", just like it does on your local computer. Prova ad aggiungere `/admin/` alla fine della URL, e verrai portata al sito di amministrazione. Accedi con il tuo username e password, e vedrai che puoi aggiungere nuovi Post sul server.
+
+Una volta che hai creato un paio di post, puoi tornare indietro alla copia locale (non PythonAnywhere). Da qui in poi, lavori sulla tua copia locale per fare le modifiche. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. Questo consente di lavorare e fare esperimenti senza rompere il tuo sito Web. Bello, vero?
 
-Dà a te stessa un' *ENORME* pacca sulla schiena! Il deploy dei server è tra le parti più complicate dello sviluppo web e di solito le persone ci impiegano svariati giorni prima di farli funzionare. Ma hai pubblicato il tuo sito su Internet senza sforzo!
+Dà a te stessa un' *ENORME* pacca sulla schiena! Il deploy dei server è tra le parti più complicate dello sviluppo web e di solito le persone ci impiegano svariati giorni prima di farli funzionare. Ma hai pubblicato il tuo sito su Internet senza sforzo!
\ No newline at end of file
diff --git a/it/deploy/install_git.md b/it/deploy/install_git.md
index dac44912b60..9a660191502 100644
--- a/it/deploy/install_git.md
+++ b/it/deploy/install_git.md
@@ -1,17 +1,52 @@
-### Windows
+Git è un "sistema di controllo versione" utilizzato da un sacco di programmatori. Questo software può tracciare le modifiche nel corso del tempo ad i file, in questo modo puoi ripristinare successivamente una specifica versione. Un pò come l'opzione "traccia modifiche" in Microsoft Word, ma molto più potente.
 
-È possibile scaricare Git da [git-scm.com](https://git-scm.com/). Puoi saltare tutti i passaggi tranne uno. Nel quinto passaggio, dal titolo "Regolazione della variabile PATH di sistema", scegli "Esegui Git e gli strumenti Unix associati dalla riga di comando di Windows" (l'opzione in basso). A parte questo, i valori predefiniti vanno bene. 'Checkout Windows-style' e 'commit Unix-style line endings' vanno bene.
+## Installare Git
 
-### MacOS
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+È possibile scaricare Git da [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). A parte questo, i valori predefiniti vanno bene. 'Checkout Windows-style' e 'commit Unix-style line endings' vanno bene.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
 
 Scarica Git da [git-scm.com](https://git-scm.com/) e segui le istruzioni.
 
-### Linux
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Se non è già installato, git dovrebbe essere disponibile tramite il gestore di pacchetti, prova a cercare:
+```bash
+$ sudo zypper install git
+```
 
-    sudo apt-get install git 
-    # oppure
-    sudo yum install git
-    # oppure
-    sudo zypper install git
+<!--endsec-->
\ No newline at end of file
diff --git a/it/deploy/signup_pythonanywhere.md b/it/deploy/signup_pythonanywhere.md
index d70701156de..ca66bd0de69 100644
--- a/it/deploy/signup_pythonanywhere.md
+++ b/it/deploy/signup_pythonanywhere.md
@@ -1,5 +1,5 @@
-Ora è il momento di registrarsi per un account gratuito "Beginner" su PythonAnywhere.
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
 
-  * [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
 
-> **Nota** Quando scegli il tuo nome utente, tieni conto che l'URL del tuo blog diventerà `iltuousername.pythonanywhere.com`, quindi scegli il tuo nickname oppure un nome ispirato a ciò su cui si basa il tuo blog.
\ No newline at end of file
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/it/django/README.md b/it/django/README.md
index 5bcc3f74e2e..b2ffebd6bac 100644
--- a/it/django/README.md
+++ b/it/django/README.md
@@ -1,27 +1,27 @@
 # Che cos'è Django?
 
-Django (*/ˈdʒæŋɡoʊ/ jang-goh*) è un framework per applicazioni web gratuito e open source, scritto in Python. Un web framework è un insieme di componenti che ti aiuta a sviluppare siti web più velocemente e facilmente.
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. Un web framework è un insieme di componenti che ti aiuta a sviluppare siti web più velocemente e facilmente.
 
 Quando si costruisce un sito web, si ha sempre bisogno di un insieme di componenti simili: un sistema per gestire l'autenticazione dell'utente (registrazione, accesso, logout), un pannello di amministrazione per il tuo sito web, un sistema per caricare i file, ecc.
 
-Fortunatamente, alcune persone diverso tempo fa si sono rese conto che gli sviluppatori web incontrano problemi simili ogni volta che costruiscono un sito internet. Per questo motivo si sono uniti e hanno costruito dei framework (di cui Django fa parte) che offrono componenti già pronti per l'uso.
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
 
-I frameworks esistono per evitare che tu debba reinventare la ruota e ti semplificano il lavoro quando crei un nuovo sito.
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
 
 ## Perché ho bisogno di un framework?
 
-Per capire Django, abbiamo bisogno di dare un'occhiata più da vicino ai server. La prima cosa che il server deve sapere è che vuoi che ti fornisca una pagina web.
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
 
-Immagina una cassetta delle lettere che monitora tutte le lettere in entrata (richieste). Questo è ciò che fa un web server. Il web server legge le lettere, e invia una risposta con una pagina web. Ma quando vuoi inviare qualcosa, hai bisogno di avere qualche contenuto. E Django è ciò che ti aiuta a creare questo contenuto.
+Immagina una cassetta delle lettere che monitora tutte le lettere in entrata (richieste). Questo è ciò che fa un web server. The web server reads the letter and then sends a response with a webpage. Ma quando vuoi inviare qualcosa, hai bisogno di avere qualche contenuto. E Django è ciò che ti aiuta a creare questo contenuto.
 
 ## Cosa succede quando qualcuno richiede un sito Web dal tuo server?
 
-Quando una richiesta arriva al web server, viene passata a Django che prova a capire che cosa é stato veramente richiesto. Django prende l'indirizzo della pagina web e cerca di capire cosa deve fare. Questa parte viene svolta da Django **urlresolver** (nota che l'indirizzo di una pagina web si chiama URL - Uniform Resource Locator -per cui il nome *urlresolver* acquista significato). Non é molto intelligente -ha bisogno di una serie di schemi e in seguito prova a far corrispondere l'URL. Django controlla questi modelli o schemi da cima a fondo e se qualcosa corrisponde a quel punto Django passa la richiesta alla funzione associata (che si chiama *view*).
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
 
 Immagina un postino con una lettera. Sta camminando per la strada e controlla ogni numero civico mettendolo a confronto con quello sulla lettera. Se corrisponde, mette lì la lettera. Questo è il modo in cui l'urlresolver funziona!
 
-Nella funzione *view* avvengono tutte le cose più interessanti: possiamo consultare un database alla ricerca di qualche informazione. Forse l'utente ha richiesto di cambiare qualcosa all'interno dei suoi dati? È come una lettera che dice "Per favore cambia la descrizione del mio lavoro". La *view* può controllare se sei autorizzata a farlo, poi aggiorna la descrizione del lavoro per te e manda un messaggio: "Fatto!". In seguito, la *view* genera una risposta e Django la può inviare al browser dell'utente.
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Forse l'utente ha richiesto di cambiare qualcosa all'interno dei suoi dati? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
 
 Naturalmente, la descrizione qui sopra é molto semplificata, ma per il momento non hai bisogno di sapere nel dettaglio tutti gli aspetti tecnici. Avere il senso generale per il momento è abbastanza.
 
-Per cui invece di perderci troppo nei dettagli, creeremo semplicemente qualcosa usando Django e apprenderemo i concetti fondamentali lungo la strada!
\ No newline at end of file
+Per cui invece di perderci troppo nei dettagli, creeremo semplicemente qualcosa usando Django e apprenderemo in concetti fondamentali lungo la strada!
\ No newline at end of file
diff --git a/it/django_admin/README.md b/it/django_admin/README.md
index de3fcc57f64..29c4257d335 100644
--- a/it/django_admin/README.md
+++ b/it/django_admin/README.md
@@ -1,26 +1,40 @@
-# Django admin
+# L'admin di Django
 
-Per aggiungere, modificare e cancellare i post che abbiamo appena strutturato useremo Django admin.
+Per aggiungere, modificare ed eliminare le pubblicazioni che abbiamo appena modellato, useremo l'amministratore di Django.
 
-Apri il file `blog/admin.py` e sostituisci il suo contenuto con:
+Stiamo per aprire il ` blog/admin.py` archiviare e sostituire il suo contenuto con questo:
 
-    from django.contrib import admin
-    from .models import Post
-    
-    admin.site.register(Post)
-    
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
 
 Come puoi vedere, stiamo importando (include) il modello di Post che abbiamo definito nel capitolo precedente. Per far si che il nostro modello sia visibile nella pagina di admin, dobbiamo registrare questo modello con `admin.site.register(Post)`.
 
-OK, è tempo di guardare il nostro modello Post. Ricorda di eseguire `python manage.py runserver` nella console per avviare il web server. Vai nel browser e scrivi l'indirizzo http://127.0.0.1:8000/admin/ Vedrai una pagina di login come questa:
+OK, è tempo di guardare il nostro Post. Ricorda di eseguire `python manage.py runserver` nella console per avviare il web server. Vai al tuo browser e digitare l'indirizzo http://127.0.0.1:8000/admin/. Vedrai una pagina login simile a questa:
 
-![Login page][1]
+![Login page](images/login_page2.png)
 
- [1]: images/login_page2.png
+Per accedere, devi creare un * superutente* - una conta utente che ha il controllo su tutto sul sitio. Torna alla riga di comando, digita` python manage.py crearesuperutente`, e premi invio.
 
-Per accedere, devi creare un *superuser* - un utente che ha il controllo su tutto nel sito. Torna alla command-line e digita `python manage.py createsuperuser`, e premi invio. Quando richiesto, digita il tuo username (minuscole, senza spazi), indirizzo e-mail e password. Non ti preoccupare se non riesci a vedere la password che stai digitando - è così che dovrebbe essere. Basta digitarlo e premere `invio` per continuare. L'output dovrebbe essere così (dove il nome utente e l'email dovrebbero essere i tuoi):
+> Ricorda, per scrivere nuovi comandi mentre il web server è insecuzione, apri una nuova finestra di terminale e attiva il tuo virtualenv. Esaminiamo come scrivere nuovi comandi nel capitolo ** Il tuo primo progetto Django! **, nel ** Avvio del server web** sezione.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
     Username: admin
     Email address: admin@admin.com
     Password:
@@ -28,20 +42,16 @@ Per accedere, devi creare un *superuser* - un utente che ha il controllo su tutt
     Superuser created successfully.
     
 
-Torna nel tuo browser e fai il log in con le credenziali di superuser che hai scelto, dovresti vedere la dashboard d'amministrazione di Django.
-
-![L'admin di Django][2]
-
- [2]: images/django_admin3.png
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
 
-Vai su Post ed sperimenta un po'. Aggiungi cinque o sei post. Non preoccuparti del contenuto - puoi semplicemente fare il copia-incolla di parti di testo da questo tutorial per risparmiare tempo :).
+![Django admin](images/django_admin3.png)
 
-Assicurati che almeno due o tre post (ma non tutti) abbiano la data in cui sono stati pubblicati. Ti sarà utile più tardi.
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
 
-![L'admin di Django][3]
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
 
- [3]: images/edit_post3.png
+![Django admin](images/edit_post3.png)
 
-Se vuoi sapere di più riguardo l'admin di Django, dovresti dare un'occhiata alla documentazione di Django: https://docs.djangoproject.com/en/1.8/ref/contrib/admin/
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
 
-Questo è un buon momento per andare a prendere un caffè (o tè) o qualcosa da mangiare per riprendere le forze. Hai creato il tuo primo modello Django - ti meriti una piccola pausa!
\ No newline at end of file
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/it/django_forms/README.md b/it/django_forms/README.md
index 2598ee9bd71..2e5968d10ff 100644
--- a/it/django_forms/README.md
+++ b/it/django_forms/README.md
@@ -1,6 +1,6 @@
-# I form di Django
+# Form Django
 
-Infine vogliamo creare un bel modo per poter aggiungere e cambiare in nostri blog posts. Django `admin` è bello, ma è alquanto difficile da personalizzare e rendere carino. Con i `forms` avremo il potere assoluto sull'aspetto della nostra pagina web-possiamo fare praticamente qualsiasi cosa vogliamo!
+Infine vogliamo creare un bel modo per poter aggiungere e cambiare in nostri blog posts. Django `admin` è bello, ma è alquanto difficile da personalizzare e rendere carino. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
 
 La bella cosa dei Django forms è che possiamo sia inventare un nuovo form da zero che creare un `ModelForm` che salverà il risultato del form sul nostro modello.
 
@@ -12,9 +12,11 @@ Dobbiamo creare un file con questo nome all'interno della cartella `blog`.
 
     blog
        └── forms.py
+    
 
+OK, let's open it and type the following code:
 
-OK, apriamo questo file e inseriamo:
+{% filename %}blog/forms.py{% endfilename %}
 
 ```python
 from django import forms
@@ -23,34 +25,38 @@ from .models import Post
 
 class PostForm(forms.ModelForm):
 
-    class Meta:
-        model = Post
-        fields = ('title', 'text',)
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
 ```
 
 Dobbiamo importare prima di tutto i Django Forms (`from django import forms`) e, ovviamente, il nostro `Post` model (`from .models import Post`).
 
-`PostForm`, come probabilmente hai intuito, è il nome del nostro form. Dobbiamo ora dire a Django che questa form é una `ModelForm` (così Django farà qualche magia per noi)- `forms.ModelForm` è il comando per farlo.
+`PostForm`, come probabilmente hai intuito, è nome del nostro form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
 
 Successivamente, abbiamo `class Meta`, con cui diciamo a Django quale model utilizzare per creare questo form (`model = Post`).
 
-Finalmente possiamo indicare uno o più campi che il nostro form deve avere. In questo caso vogliamo che solamente `title` e `text` siano visibili -`author` è la persona attualmente connessa (tu!) e `created_date` dovrebbe generarsi da sola ogni volta che creiamo un post (cioè nel nostro programma), giusto?
+Finalmente, possiamo indicare uno o più campi che il nostro form deve avere. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
 
 E questo è tutto! Tutto quello che dobbiamo fare ora é usare il form nella nostra *view* e visualizzarlo nel template.
 
-Ricapitolando, creeremo: link che punti alla pagina, una URL, una view e un model.
+So once again we will create a link to the page, a URL, a view and a template.
 
 ## Link ad una pagina usando il form
 
 È tempo di aprire `blog/templates/blog/base.html`. Aggiungeremo un link nel `div` chiamato `page-header`:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Nota che vogliamo chiamare la nostra nuova view `post_new`.
+Nota che noi vogliamo chiamare la nostra vista `post_new`. La classe `"glyphicon glyphicon-plus"` è data dal tema di bootstrap che stiamo usando e visualizzerà un segno più per noi.
+
+After adding the line, your HTML file should now look like this:
 
-Dopo aver aggiunto quanto detto, il tuo file html dovrebbe essere simile a questo:
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
@@ -85,34 +91,42 @@ Dopo aver salvato e aggiornato la pagina http://127.0.0.1:8000 vedrai ovviamente
 
 Apri il file `blog/urls.py` e aggiungi:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-    url(r'^post/new/$', views.post_new, name='post_new'),
+url(r'^post/new/$', views.post_new, name='post_new'),
 ```
 
 Il risultato finale sarà:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
     url(r'^post/new/$', views.post_new, name='post_new'),
 ]
 ```
 
-Dopo aver aggiornato il sito, vedremo un `AttributeError` dal momento che non abbiamo ancora creato `post_new`. Aggiungiamolo adesso.
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
 
 ## post_new view
 
 Apri il file `blog/views.py` e aggiungi quanto segue con il resto delle importazioni `from`:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from .forms import PostForm
 ```
 
-e la nostra *view*:
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -120,22 +134,22 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Per creare un nuovo `Post` form, dobbiamo chiamare il metodo `PostForm()` e passarlo nel nostro template. Torneremo poi sulla *view*, ma per ora creiamo un veloce template per il nostro form.
+Per creare un nuovo `Post` form, dobbiamo chiamare il metodo `PostForm()` e passarlo nel nostro template. We will go back to this *view*, but for now, let's quickly create a template for the form.
 
 ## Template
 
 All'interno della cartella `blog/templates/blog` dobbiamo creare il file `post_edit.html`. Per far si che il nostro form funzioni abbiamo bisogno di diverse cose:
 
-*   dobbiamo rendere il form visibile. Per farlo possiamo usare semplicemente `{% raw %}{{ form.as_p }}{% endraw %}`.
-*   le righe scritte sopra hanno bisogno di 'essere avvolte' da un HTML tag: `<form method="POST">...</form>`
-*   ci serve un `Save` pulsante. Possiamo fare ciò con HTML button: `<button type="submit">Save</button>`
-*   infine, subito dopo l'apertura del tag `<form ...>`, dobbiamo aggiungere `{% raw %}{% csrf_token %}{% endraw %}`. Questo passaggio è molto importante dal momento che rende il nostro form sicuro! Django si lamenterà se ti dimentichi di inserire questa parte e provi comunque a salvare ciò che è contenuto nel form:
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* Le righe scritte sopra hanno bisogno di 'essere avvolte' da un HTML tag: `<form method="POST">...</form>`.
+* Ci serve un `Save` pulsante. Possiamo fare Ciò con HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. Questo passaggio è molto importante dal momento che rende il nostro form sicuro! If you forget about this bit, Django will complain when you try to save the form:
 
-![CSFR Forbidden page][1]
+![CSFR Forbidden page](images/csrf2.png)
 
- [1]: images/csrf2.png
+OK, so let's see how the HTML in `post_edit.html` should look:
 
-OK, il tuo HTML `post_edit.html` dovrebbe apparire così:
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -151,19 +165,19 @@ OK, il tuo HTML `post_edit.html` dovrebbe apparire così:
 
 Ora aggiorna la pagina! Yeah! Puoi ora visualizzare il tuo form!
 
-![New form][2]
+![New form](images/new_form2.png)
 
- [2]: images/new_form2.png
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
 
-Ma, aspetta un momento! Se provi a scrivere qualcosa in `title` e `text` e cerchi di salvare ciò che hai scritto, che cosa succede?
-
-Niente! Siamo di nuovo sulla stessa pagina di prima e il nostro testo é sparito...e non compare nessun nuovo post. Che cosa abbiamo sbagliato?
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
 
 La risposta è: nulla. Dobbiamo solo fare un po' di lavoro in più nella nostra *view*.
 
 ## Salvare il form
 
-Apri `blog/views.py` di nuovo. Attualmente tutto ciò che abbiamo nella view `post_new` é:
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -171,9 +185,11 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Quando inviamo il form, veniamo riportati alla stessa view, ma questa volta abbiamo più dati in `request`, in particolare in `request.POST` (il nome non ha nulla a che vedere con un blog "post", bensì con l'inglese "posting", ovvero inviare, in questo caso dati). Ti ricordi che nel nostro file HTML il nostro `<form>` aveva la variabile `method="POST"`? Per cui ora, tutto quello che l'utente ha inserito nel form è disponibile in `method="POST"`. Non è necessario rinominare `POST` in nessuna altra maniera (l'unico altro valore valido per `method` è `GET`, ma al momento non abbiamo abbastanza tempo per spiegare la differenza).
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? Per cui ora, tutto quello che l'utente ha inserito nel form è disponibile in `method="POST"`. Non è necessario rinominare `POST` in nessuna altra maniera (l'unico altro valore valido per `method` è `GET`, ma al momento non abbiamo abbastanza tempo per spiegare la differenza).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. Per cui dobbiamo aggiungere una condizione(useremo `if`):
 
-Per cui nella nostra *view* abbiamo due diverse situazioni da gestire. Prima: quando accediamo alla pagina per la prima volta e vogliamo un form che sia vuoto. Seconda: quando torniamo alla *view* con tutti i dati appena inseriti nel form. Per cui dobbiamo aggiungere una condizione(useremo `if`).
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 if request.method == "POST":
@@ -182,15 +198,19 @@ else:
     form = PostForm()
 ```
 
-È ora di completare i puntini `[...]`. Se il `method` è `POST` allora vogliamo costruire il nostro `PostForm` con i dati appena inseriti dall'utente, giusto? Raggiungeremo questo risultato con:
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST)
 ```
 
-Facile! Come prossima cosa dobbiamo controllare se il form è corretto (per cui che tutti i campi necessari siano stati impostati e che non ci siano valori sbagliati). Possiamo fare questo con `form.is_valid()`.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+Se la forma viene ritenuta valida verrà salvata!
 
-Se il form viene ritenuto valido verrà salvato!
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 if form.is_valid():
@@ -200,23 +220,29 @@ if form.is_valid():
     post.save()
 ```
 
-In pratica, ci sono due cose da fare: salviamo il form con `form.save` e aggiungiamo un autore (dal momento che non c'era nessun campo autore `author` nel form `PostForm` e questo campo non può essere lasciato bianco!). `commit=False` significa che non vogliamo salvare `Post` model per il momento-vogliamo prima assicurarci di aggiungere un autore. Per la maggior parte del tempo userai `form.save()`, senza `commit=False`, ma in questo caso abbiamo bisogno di questa extra specificazione. `post.save()` salverà le modifiche (aggiunta di autore) e il nuovo post del tuo blog è stato finalmente creato!
+In pratica, ci sono due cose da fare: salviamo il form con `form.save` e aggiungiamo un autore(dal momento che non c'era nessun campo autore `author` nel form `PostForm` e questo campo non può essere lasciato bianco). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
 
-Infine, non sarebbe fantastico se potessimo immediatamente essere indirizzati alla pagina `post_detail` del nuovo blog post appena creato? Per fare ciò dobbiamo importare:
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import redirect
 ```
 
-Aggiungilo all'inizio del file. E ora possiamo dire: vai alla pagina `post_detail` per il post appena creato.
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 return redirect('post_detail', pk=post.pk)
 ```
 
-`post_detail` é il nome della view che vogliamo visitare. Ti ricordi che questa *view* ha bisogno della variabile `pk`? Per passarla alla nostre views utilizziamo `pk=post.pk`, dove `post` è il post appena creato!
+`post_detail` è il nome della vista su cui vogliamo andare. Ti ricordi che questa *view* ha bisogno della `pk` variabile? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
 
-Ok, abbiamo parlato abbastanza ora e forse sei curioso/a di vedere l'aspetto della nostra *view*, giusto?
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -233,41 +259,41 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Vediamo se funziona. Vai sulla pagina http://127.0.0.1:8000/post/new/, aggiungi un `title` e un `text`, salvalo... e voilà! Il tuo nuovo post è stato aggiunto e noi siamo stati reindirizzati automaticamente alla pagina `post_detail` !
+Vediamo se funziona. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
 
-Forse avrai notato che stiamo impostando una data di pubblicazione prima di salvare il post. Più tardi introdurremo l'uso del *publish button* in **Django Girls Tutorial: Extensions**.
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
 
 Fantastico!
 
-## Validazione del Form
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. Questo risolverà temporaneamente il problema. C'è una correzione permanente che ti aspetta nella sezione degli esercizi extra alla fine del tutorial principale **Compiti: aggiungi sicurezza al tuo sito web!**.
 
-E adesso ti dimostreremo quanto siano belli i form di Django. Sappiamo che un post ha bisogno di `title` e `text`. Nel nostro `Post` model non abbiamo detto (al contrario di quello che abbiamo fatto per `published_date`) che questi campi non sono obbligatori, per cui Django si aspetta che vengano impostati.
+![Logged in error](images/post_create_error.png)
 
-Prova a salvare il form senza `title` e `text`. Indovina che cosa accade!
+## Validazione del form
 
-![Validazione del form][3]
+E adesso ti dimostreremo quanto siano belli i form di Django. Sappiamo che un post ha bisogno di `title` e `text`. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
 
- [3]: images/form_validation2.png
+Try to save the form without `title` and `text`. Guess what will happen!
 
-Django si sta prendendo cura di controllare che tutti i campi nel nostro form siano corretti. Non è fantastico?
+![Validazione del form](images/form_validation2.png)
 
-> Dato che poco fa stavamo usando l'interfaccia di Django admin, Django pensa che siamo ancora connessi. Ci sono alcune situazioni che potrebbero portarci a fare un log out(chiudere il browser, riavviare il DB etc.). Se ti trovi nella situazione di avere errori, quando crei un post, relativi alla mancanza di un utente, vai alla admin page `http://127.0.0.1:8000/admin` ed effettua il log in di nuovo. Questo risolverà temporaneamente il problema. C'è una correzione permanente che ti aspetta nella sezione degli esercizi extra alla fine del tutorial principale **Compiti: aggiungi sicurezza al tuo sito web!**.
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
 
-![Logged in error][4]
+## Form di modifica
 
- [4]: images/post_create_error.png
+Ora sappiamo come aggiungere un form. Ma cosa succede se ne vogliamo cambiarne uno esistente? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
 
-## Modifica il form
+Open `blog/templates/blog/post_detail.html` and add the line
 
-Ora sappiamo come aggiungere un form. Ma cosa succede se ne vogliamo cambiare uno esistente? È un processo abbastanza simile a quelli che abbiamo appena fatto. Creiamo alcune cose importanti rapidamente (se non capisci qualcosa, chiedi aiuto al tuo coach o guarda i capitoli precedenti, dal momento che abbiamo coperto tutti questi passaggi precedentemente).
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
-Apri `blog/templates/blog/post_detail.html` e aggiungi:
-
-```python
+```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
 
-per cui il tuo template sarà così:
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -288,13 +314,17 @@ per cui il tuo template sarà così:
 
 In `blog/urls.py` aggiugi:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-    url(r'^post/(?P<pk>[0-9]+)/edit/$', views.post_edit, name='post_edit'),
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
 ```
 
 Riutilizzeremo il model `blog/templates/blog/post_edit.html`, quindi l'ultima cosa che manca è una *view*.
 
-Apriamo `blog/views.py` e aggiungiamo alla fine del file:
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_edit(request, pk):
@@ -312,47 +342,51 @@ def post_edit(request, pk):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Questo sembra quasi esattamente la view `post_new`, giusto? Ma non del tutto. Prima cosa: si passa un parametro supplementare `pk` dall'URL. Dopo di che: prendiamo il modello ` Post` che vogliamo modificare con `get_object_or_404(Post, pk=pk)` e in seguito, quando creeremo un form, passeremo questo post come `instance`, sia quando salviamo il form:
+Questo sembra quasi esattamente la view `post_new`, giusto? Ma non del tutto. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST, instance=post)
 ```
 
-e quando abbiamo appena aperto un form con questo post da modificare:
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(instance=post)
 ```
 
-Ok, testiamo se funziona! Andiamo alla pagina `post_detail`. Dovrebbe esserci un pulsante modifica nell'angolo superiore destro:
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
 
-![Pulsante modifica][5]
-
- [5]: images/edit_button2.png
+![Edit button](images/edit_button2.png)
 
 Quando ci clicchi, vedrai il modulo con i nostri post del blog:
 
-![Modifica il form][6]
-
- [6]: images/edit_form2.png
+![Form di modifica](images/edit_form2.png)
 
-Sentiti libero di cambiare il titolo o il testo e salva le modifiche!
+Feel free to change the title or the text and save the changes!
 
 Complimenti! La tua application è sempre più completa!
 
-Se ti servono altre informazioni sui forms di Django dovresti leggere la documentazione: https://docs.djangoproject.com/en/1.8/topics/forms/
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
 
 ## Sicurezza
 
-Riuscire a creare nuovi post semplicemente cliccando su un link è bellissimo! Ma, al momento, chiunque visiti il tuo sito potrebbe pubblicare un nuovo post nel tuo blog e probabilmente non vuoi che ciò accada. Facciamo in modo che questo tasto sia visibile solo per te e non per altri.
+Riuscire a creare nuovi post semplicemente cliccando su un link è bellissimo! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Facciamo spuntare il bottone solo per te e non per gli altri.
 
 Vai al tuo `blog/templates/blog/base.html` e trova il `page-header` `div` con il tag di tipo anchor che hai messo prima. Dovrebbe apparire così:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Vogliamo aggiungere qui un altro tag del tipo `{% if %}` che farà comparire il link solo per gli utenti connessi come admin. Per ora, solo tu! Cambia il tag `<a>` in modo che risulti così:
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Cambia il tag `<a>` in modo che risulti così:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% if user.is_authenticated %}
@@ -360,39 +394,54 @@ Vogliamo aggiungere qui un altro tag del tipo `{% if %}` che farà comparire il
 {% endif %}
 ```
 
-Grazie a questo `{% if %}`, il link verrà inviato al browser solo se l'utente che prova ad accedere alla pagina è connesso come admin. Con questa condizione non ci siamo protetti del tutto dalla creazione di nuovi post, ma abbiamo fatto un buon passo avanti. Nelle lezioni estensione ci occuperemo di più della sicurezza.
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. Con questa condizione non ci siamo protetti del tutto dalla creazione di nuovi post, ma abbiamo fatto un buon passo avanti. Nelle lezioni estensione ci occuperemo di più della sicurezza.
+
+Ricordi l'icona modifica che abbiamo aggiunto sulla nostra pagina di dettaglio? Vogliamo faro la stessa cosa qui, così le altre persone non potranno editare i post esistenti.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
-Ora, dato che probabilmente sei connessa/o, se aggiorni la pagina non troverai alcuna differenza. Ma prova a ricaricare la pagina in un altro browser o in una finestra di navigazione in incognito e vedrai che il link non c'è!
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Siccome probabilmente sei loggata, se ricarichi la pagina non vedrai differenze. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
 
 ## Ultima cosa: ora di fare il deploy!
 
 Vediamo se funziona su PythonAnywhere. È l'ora di un altro deploy!
 
-*   Innanzitutto, fai un commit del tuo nuovo codice e fai il push per caricarlo su Github
+* Innanzitutto, fai un commit del tuo nuovo codice e fai il push per caricarlo su Github:
 
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added views to create/edit blog post inside the site."
-$ git push
-```
+{% filename %}command-line{% endfilename %}
 
-*   Poi, in una [console PythonAnywhere Bash][7]:
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
 
- [7]: https://www.pythonanywhere.com/consoles/
+* Poi, in una [console PythonAnywhere Bash](https://www.pythonanywhere.com/consoles/):
 
-```
-$ cd my-first-blog
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```
+{% filename %}command-line{% endfilename %}
 
-*   Infine, vai sulla [Web tab][8] e premi **Reload**.
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
- [8]: https://www.pythonanywhere.com/web_app_setup/
+* Infine, vai sulla [Web tab](https://www.pythonanywhere.com/web_app_setup/) e premi **Reload**.
 
-Fatto! Congratulazioni :)
+Fatto! Congratulazioni :)
\ No newline at end of file
diff --git a/it/django_installation/README.md b/it/django_installation/README.md
index 15f3758fbdd..c5c1f700c38 100644
--- a/it/django_installation/README.md
+++ b/it/django_installation/README.md
@@ -1,5 +1,7 @@
 # Installazione di Django
 
-> **Nota** Se hai già eseguito i passaggi per l'Installazione, allora hai già fatto quanto serve e puoi andare direttamente al prossimo capitolo!
+> **Nota** Se utilizzi un Chromebook, salta questo capitolo e assicurati di seguire il[ Configurzione di Chromebook](../chromebook_setup/README.md)istruzioni.
+> 
+> **Nota** Se hai già lavorato ai passaggi di instalazzione lo hai già fatto: puoi passare direttamente al capitolo successivo!
 
-{% include "/django_installation/instructions.md" %}
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/it/django_installation/instructions.md b/it/django_installation/instructions.md
index 931be14224b..3341744d418 100644
--- a/it/django_installation/instructions.md
+++ b/it/django_installation/instructions.md
@@ -1,6 +1,6 @@
-> Una parte di questo capitolo si basa sui tutorial delle Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> Parte di questa sezione è basata sul tutorial delle Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 > 
-> Una parte di questo capitolo di basa sul [django-marcador tutorial](http://django-marcador.keimlink.de/) sotto licenza Creative Commons Attribution-ShareAlike 4.0 International License. Il tutorial di django-marcador è protetto da copyright di Markus Zapke-Gründemann et al.
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Il tutorial di django-marcador è protetto da copyright di Markus Zapke-Gründemann et al.
 
 ## Ambiente virtuale
 
@@ -8,85 +8,143 @@ Prima di installare Django, ti vogliamo far installare uno strumento estremament
 
 Per cui, creiamo ora un **ambiente virtuale** (chiamato anche un *virtualenv*). Virtualenv isolerà la tua configurazione di Python/Django in base ai diversi progetti. Questo significa che qualunque modifica farai su un sito non avrà alcun effetto su tutti gli altri che stai sviluppando. Chiaro ora?
 
-Tutto quello che devi fare è trovare una cartella in cui vuoi creare il `virtualenv`; la tua home directory, ad esempio. Su Windows potrebbe essere `C:\Users\Name` (dove `Name` è il nome del tuo login).
+Tutto quello che devi fare è trovare una cartella in cui vuoi creare il `virtualenv`; la tua home directory, ad esempio. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
 
 Per questo tutorial useremo una nuova directory `djangogirls` dalla tua home directory:
 
-    mkdir djangogirls
-    cd djangogirls
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
     
 
 Ora creeremo un virtualenv dal nome `myvenv`. Questo è il formato del comando generale:
 
-    python3 -m venv myvenv
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
     
 
-### Windows
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
 
-Per creare un nuovo `virtualenv` è necessario aprire la console (ti abbiamo spiegato come fare nei capitoli precedenti, ricordi?) ed esegui `C:\Python34\python -m venv myvenv`. Il risultato somiglierà a questo:
+{% filename %}command-line{% endfilename %}
 
-    C:\Users\Name\djangogirls> C:\Python34\python -m venv myvenv
+    C:\Users\Name\djangogirls> python -m venv myvenv
     
 
-dove `C:\Python34\python` è la directory in cui precedentemente hai installato Python e `myvenv` è il nome del tuo `virtualenv`. Puoi utilizzare qualsiasi altro nome, ma attieniti a utilizzare le minuscole, a non usare spazi, accenti o caratteri speciali. È meglio usare un nome breve dal momento che dovrai digitarlo spesso!
+Where `myvenv` is the name of your `virtualenv`. Puoi utilizzare qualsiasi altro nome, ma attieniti a utilizzare le minuscole, a non usare spazi, accenti o caratteri speciali. It is also good idea to keep the name short – you'll be referencing it a lot!
 
-### Linux e OS X
+<!--endsec-->
 
-Creare un `virtualenv` su Linux e OS X è semplice, basta digitare: `python3 -m venv myvenv`. Il risultato sarà simile a questo:
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
 
-    ~/djangogirls$ python3 -m venv myvenv
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
     
 
-`myvenv` è il nome del tuo `virtualenv`. Puoi usare qualsiasi altro nome, ma utilizza solo minuscole e niente spazi. Sarebbe meglio se il nome fosse corto perchè lo dovrai digitare molte volte!
+`myvenv` è il nome del tuo `virtualenv`. Puoi usare qualsiasi altro nome, ma utilizza solo minuscole e niente spazi. It is also a good idea to keep the name short as you'll be referencing it a lot!
 
-> **NOTA:** Avviare il virtualenv su Ubuntu 14.04 in questa maniera al momento darà il seguente errore:
+> **NOTA:** Su alcune versioni di Debian/Ubuntu potresti vedere il seguente errore:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
 > 
 >     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
 >     
 > 
 > Per aggirare il problema utilizza, invece del precedente, il comando `virtualenv`.
 > 
->     ~/djangogirls$ sudo apt-get install python-virtualenv
->     ~/djangogirls$ virtualenv --python=python3.4 myvenv
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
 >     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
 
 ## Lavorare con virtualenv
 
-Il comando sopra specificato, creerà una cartella dal nome `myvenv` (o col nome che hai scelto) che contiene il tuo virtual environment (ovvero un mucchio di files e cartelle).
+Il comando sopra specificato, creerà una cartella dal nome `myenv` (o col nome che hai scelto) che contiene il tuo virtual environment (ovvero un mucchio di files e cartelle).
 
-#### Windows
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
 
 Avvia il tuo virtualenv digitando:
 
+{% filename %}command-line{% endfilename %}
+
     C:\Users\Name\djangogirls> myvenv\Scripts\activate
     
 
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
 
-#### Linux e OS X
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
 
 Avvia il tuo virtualenv digitando:
 
-    ~/djangogirls$ source myvenv/bin/activate
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
     
 
 Ricordati di sostituire `myvenv` con il nome `virtualenv` che hai scelto!
 
 > **Nota:** a volte il comando `source` potrebbe non essere disponibile. In quel caso prova ad usare questo:
 > 
->     ~/djangogirls$ . myvenv/bin/activate
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
 >     
 
-Saprai con certezza che hai avviato `virtualenv` quando vedrai che il prompt dei comandi nella console si presenta così:
+<!--endsec-->
 
-    (myvenv) C:\Users\Name\djangogirls>
-    
-
-oppure:
-
-    (myvenv) ~/djangogirls$
-    
-
-Fai caso al prefisso `(myvenv)`!
+Saprai che il tuo `virtualenv` è partito quando vedrai il prompt della tua console che inizia con `(myvenv)`.
 
 Quando si lavora all'interno di un ambiente virtuale, `python` farà automaticamente riferimento alla versione corretta da utilizzare. Per cui puoi digitare `python` invece `python3`.
 
@@ -94,21 +152,50 @@ OK, abbiamo tutte le dipendenze importanti pronte. Finalmente possiamo installar
 
 ## Installare Django
 
-Ora che hai iniziato ad utilizzare il tuo `virtualenv`, puoi installare Django usando `pip`. Nella console, esegui `pip install django==1.8` (nota che usiamo un doppio simbolo di uguale: `==`).
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
 
-    (myvenv) ~$ pip install django==1.8
-    Downloading/unpacking django==1.8
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
     Installing collected packages: django
-    Successfully installed django
-    Cleaning up...
+    Successfully installed django-1.11.3
     
 
-Su Windows
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Crea un nuovo virtualenv nella nuova cartella, quindi elimina quello vecchio e riprova i comandi precedenti. (Spostare la cartella del virtualenv non funziona in quanto virtualenv usa le path assolute.)
+
+<!--endsec-->
 
-> Se ottieni un errore quando chiami pip sulla piattaforma Windows controlla se il pathname del tuo progetto contiene spazi, accenti o caratteri speciali (i.e. `C:\Users\User Name\djangogirls`). Se è così ti conviene spostarlo in un altro path senza spazi, accenti o caratteri speciali (il suggerimento è: `C:\djangogirls`). Dopo averlo spostato, prova ad eseguire di nuovo il comando di cui sopra.
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
 
-su Linux
+> La tua linea di comando potrebbe bloccarsi quando provi ad installare Django. Se succede, invece del comando precedente usa:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
 
 > Se ottieni un errore quando esegui il comando pip su Ubuntu 12.04, prova ad eseguire `python -m pip install -U --force-reinstall pip` per risolvere il problema.
 
-Questo è tutto! Sei (finalmente) pronto/a a creare un'applicazione Django!
+<!--endsec-->
+
+Questo è tutto! Sei (finalmente) pronto/a a creare un'applicazione Django!
\ No newline at end of file
diff --git a/it/django_models/README.md b/it/django_models/README.md
index 9c826a11556..8a37256259f 100644
--- a/it/django_models/README.md
+++ b/it/django_models/README.md
@@ -1,26 +1,31 @@
-# Modelli Django
+# I modelli di Django
 
 Vogliamo creare un qualcosa che raccoglierà tutti i post del nostro blog. Per farlo, però, dobbiamo prima introdurre i cosiddetti `oggetti`.
 
 ## Oggetti
 
-Esiste un concetto nella programmazione chiamato `programmazione orientata agli oggetti`. L'idea è che invece di scrivere tutto come una noiosa sequenza di istruzioni di programmazione, possiamo modellare le cose e definire come esse interagiscono fra di loro.
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
 
 Quindi cos'è un oggetto? È un insieme di proprietà ed azioni. Suona strano, ma ti faremo un esempio.
 
-Se vogliamo modellare un gatto creeremo un oggetto `Gatto` che ha qualche proprietà, i.e. `colore`, `età`, `umore` (i.e. bravo, cattivo, sonnolento ;)), `padrone` (che è un oggetto `Persona` oppure, nel caso di un gatto randagio, questa proprietà è vuota).
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
 
-E poi il `Gatto` ha alcune azioni: `fusa`, `graffiare` oppure `alimentare` (nella quale daremo al gatto un po' di `Cibo per gatti`, che potrebbe essere un oggetto diverso con delle proprietà, i.e. `gusto`).
+Quindi il `Gatto` possiede anche alcune azioni: `fare_le_fusa`, `graffiare` e `alimentare` (in quest'ultimo caso, daremo al gatto del `CiboPerGatti`, che sarà un altro oggetto con le sue proprietà, come `gusto`).
 
-    Gatto
+    Cat
     --------
-    colore
-    età
-    umore
-    padrone
-    fare le fusa()
-    graffiare()
-    alimentare(cat_food)
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
     
 
 Quindi in pratica l'idea è quella di descrivere cose vere in codice con delle proprietà (chiamate `proprietà di oggetti`) e azioni (chiamate `metodi`).
@@ -29,7 +34,7 @@ Quindi come faremo a modellare i post del blog? vogliamo costruire un blog, gius
 
 Dobbiamo rispondere alla domanda: cos'è un post? Quali proprietà dovrebbe avere?
 
-Beh, sicuramente il nostro post ha bisogno di qualche testo con il suo contenuto ed un titolo, vero? Sarebbe bello sapere chi l'ha scritto - quindi abbiamo bisogno di un autore. Infine, vogliamo sapere quando il post è stato creato e pubblicato.
+Beh, sicuramente il nostro post ha bisogno di qualche testo con il suo contenuto ed un titolo, vero? It would be also nice to know who wrote it – so we need an author. Infine, vogliamo sapere quando il post è stato creato e pubblicato.
 
     Post
     --------
@@ -50,55 +55,68 @@ Dal momento che sappiamo già cosa vogliamo ottenere, iniziamo a modellarlo in D
 
 Sapendo cos'è un oggetto, possiamo creare un modello Django per il nostro post.
 
-Un modello in Django è uno speciale tipo di oggetto - è salvato nel `database`. Un database è un insieme di dati. È un posto in cui archivierai informazioni sui tuoi utenti, sui tuoi post, ecc. Useremo un database SQLite per archiviare i nostri dati. Questo è l'adattatore Django di database predefinito -- ci basterà per adesso.
+A model in Django is a special kind of object – it is saved in the `database`. Un database è un insieme di dati. È un posto in cui archivierai informazioni sui tuoi utenti, sui tuoi post, ecc. Useremo un database SQLite per archiviare i nostri dati. This is the default Django database adapter – it'll be enough for us right now.
 
 Puoi pensare ad un modello nel database come ad un foglio elettronico con colonne (campi) e righe (dati).
 
 ### Creazione di un'applicazione
 
-Per mantenere tutto ordinato, creeremo un'applicazione diversa all'interno del nostro progetto. È molto bello avere tutto organizzato fin dall'inizio. Per creare un'applicazione abbiamo bisogno di eseguire il seguente comando nella console (dalla cartella `djangogirls` dove si trova il file `manage.py`):
+Per mantenere tutto ordinato, creeremo un'applicazione diversa all'interno del nostro progetto. E' molto bello avere tutto organizzato fin dall'inizio. Per creare un'applicazione abbiamo bisogno di eseguire il seguente comando nella console (dalla cartella `djangogirls` dove si trova il file `manage.py`):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py startapp blog
     
 
-Noterai che si è creata una nuova cartella `blog` e che ora contiene alcuni file. Le nostre cartelle ed i nostri file nel nostro progetto si dovrebbero vedere così:
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
 
     djangogirls
-    ├── mysite
-    |       __init__.py
-    |       settings.py
-    |       urls.py
-    |       wsgi.py
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
     ├── manage.py
-    └── blog
-        ├── migrations
-        |       __init__.py
+    └── mysite
         ├── __init__.py
-        ├── admin.py
-        ├── models.py
-        ├── tests.py
-        └── views.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
     
 
-Dopo aver creato un'applicazione dobbiamo dire a Django che dovrebbe utilizzarla. Lo facciamo nel file `mysite/settings.py`. Dobbiamo trovare `INSTALLED_APPS` ed aggiungere una riga che contenga `'blog',` appena sopra`)`. Quindi il prodotto finale dovrebbe assomigliare a questo:
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-INSTALLED_APPS = (
-    'django.contrib.admin',
-    'django.contrib.auth',
-    'django.contrib.contenttypes',
-    'django.contrib.sessions',
-    'django.contrib.messages',
-    'django.contrib.staticfiles',
-    'blog',
-)
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
 ```
 
 ### Creazione di un modello blog post
 
-Nel file `blog/models.py` definiamo tutti gli oggetti chiamati `Models` - Questo è il posto dove definiremo il nostro blog post.
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
 
-Apriamo `blog/models.py`, cancella tutto quello che è lì e scrivi un codice come questo:
+{% filename %}blog/models.py{% endfilename %}
 
 ```python
 from django.db import models
@@ -106,7 +124,7 @@ from django.utils import timezone
 
 
 class Post(models.Model):
-    author = models.ForeignKey('auth.User')
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
     created_date = models.DateTimeField(
@@ -122,44 +140,53 @@ class Post(models.Model):
         return self.title
 ```
 
-> Ricontrolla se stai utilizzando due caratteri di sottolineatura (`_`) su ciascun lato di `str`. Questa convenzione viene utilizzata spesso in Python e a volte li chiamiamo anche "dunder" (abbreviazione di "doppio carattere di sottolineatura").
+> Assicurati di aver usato 2 underscore (`_`) da entrambi i lati di `str`. Questa convenzione viene utilizzata spesso in Python e a volte li chiamiamo anche "dunder" (abbreviazione di "doppio carattere di sottolineatura").
 
-Sembra spaventoso, vero? ma non ti preoccupare, ti spiegheremo cosa significano queste righe!
+It looks scary, right? But don't worry – we will explain what these lines mean!
 
-Tutte le righe che iniziano con `from` oppure con `import` sono righe che aggiungono alcuni pezzi da altri file. Quindi invece di copiare e incollare le stesse cose in ogni file, possiamo includere alcune parti con `from ... import ...`.
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
 
-`class Post(models.Model):` - questa riga definisce il nostro modello (è un `oggetto`).
+`class Post(models.Model):` – this line defines our model (it is an `object`).
 
-*   `class` è una parola chiave speciale che indica che stiamo definendo un oggetto.
-*   `Post` è il nome del nostro modello. Possiamo dargli un nome diverso (ma dobbiamo evitare caratteri speciali e spazi). Inizia sempre il nome di una classe con un lettera maiuscola.
-*   `models.Model` significa che il Post è un modello Django, quindi Django sa che dovrebbe essere salvato nel database.
+- `class` è una parola chiave speciale che indica che stiamo definendo un oggetto.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` significa che il Post è un modello Django, quindi Django sa che dovrebbe essere salvato nel database.
 
-Ora definiamo le proprietà di cui stavamo parlando: `titolo`, `testo`, `data_creazione`, `data_pubblicazione` e `autore`. Per fare ciò dobbiamo definire un tipo per ogni campo (è un testo? Un numero? Una data? Una relazione con un altro oggetto, i.e. un utente?).
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
 
-*   `models.CharField` - così si definisce un testo con un numero limitato di lettere.
-*   `models.TextField` - questo è il codice per definire un testo senza un limite. Sembra l'ideale per i contenuti di un post, vero?
-*   `models.DateTimeField` - questo per la data ed l'ora.
-*   `models.ForeignKey` - questo è un link a un altro modello.
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
 
-Non spiegheremo ogni pezzo di codice perchè ci vorrebbre troppo tempo. Dovresti dare un'occhiata alla documentazione di Django se vuoi saperne di più sui campi di un modello e come definire altre cose rispetto a quelle descritte sopra (https://docs.djangoproject.com/en/1.8/ref/models/fields/#field-types).
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
 
-Che dire di `def publish(self):`? È esattamente il metodo `pubblicare` di cui stavamo parlando prima. `def` significa che questa è una funzione/metodo e `publish` è il nome del metodo. Puoi modificare il nome del metodo, se vuoi. La regola per la denominazione è usare lettere minuscole e caratteri di sottolineatura al posto degli spazi. Per esempio, un metodo che calcola il prezzo medio potrebbe essere chiamato `calculate_average_price`.
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
 
-I metodi spesso `restituiscono` qualcosa. C'è un esempio nel metodo `__str__`. In questo caso, quando chiamiamo `__str__()` otterremo un testo (**stringa**) con il titolo del Post.
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
 
-Se c'è qualcosa di poco chiaro sui modelli, sentiti libera/o di chiedere al tuo coach! Sappiamo che è complicato, soprattutto quando impari cosa sono gli oggetti e le funzioni allo stesso tempo. Ma speriamo che sembri un po' meno magico per te per adesso!
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
 
 ### Crea tabelle per i modelli nel tuo database
 
-L'ultimo passo è quello di aggiungere un nuovo modello al nostro database. Prima dobbiamo far sapere a Django che ci sono alcuni cambiamenti nel nostro modello (l'abbiamo appena creato!). Digita `python manage.py makemigrations blog`. Il risultato somiglierà a questo:
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py makemigrations blog
     Migrations for 'blog':
-      0001_initial.py:
+      blog/migrations/0001_initial.py:
+    
       - Create model Post
     
 
-Django ci ha preparato un file di migrazione che dobbiamo applicare nel nostro database. Digita `python manage.py migrate blog` e l'output dovrebbe essere:
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py migrate blog
     Operations to perform:
@@ -169,4 +196,4 @@ Django ci ha preparato un file di migrazione che dobbiamo applicare nel nostro d
       Applying blog.0001_initial... OK
     
 
-Evviva! Il nostro modello Post ora è nel database! Sarebbe bello poterlo vedere, vero? Vai al prossimo capitolo per vedere com'è il tuo Post!
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/it/django_orm/README.md b/it/django_orm/README.md
index 69baae3eb50..72de9c51b1f 100644
--- a/it/django_orm/README.md
+++ b/it/django_orm/README.md
@@ -1,10 +1,10 @@
-# Django ORM e i QuerySet
+# Django ORM e QuerySets
 
 In questo capitolo imparerai come Django si collega al database e archivia i dati al suo interno. Tuffiamoci!
 
 ## Cos'è un QuerySet?
 
-Un QuerySet, in sostanza, è una lista di oggetti di un determinato Modello. Il QuerySet ti permette di leggere il dato dal database, filtrarlo e ordinarlo.
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
 
 È più facile impararlo con un esempio. Proviamo, ti va?
 
@@ -12,146 +12,207 @@ Un QuerySet, in sostanza, è una lista di oggetti di un determinato Modello. Il
 
 Apri la tua console locale (non su PythonAnywhere) e digita questo comando:
 
-    (myvenv) ~/djangogirls$ python manage.py shell
+{% filename %}command-line{% endfilename %}
 
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
 
 L'effetto dovrebbe essere come questo:
 
-    (InteractiveConsole)
-    >>>
+{% filename %}command-line{% endfilename %}
 
+```python
+(InteractiveConsole)
+>>>
+```
 
-Ora ti trovi nella consolle interattiva di Django. È come il prompt di python ma con un po' di magia di Django in più :). Qui puoi anche utilizzare tutti i comandi Python, ovviamente.
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
 
 ### Tutti gli oggetti
 
 Proviamo a rendere visibili tutti i nostri post prima. Puoi farlo con il seguente comando:
 
-    >>> Post.objects.all()
-    Traceback (most recent call last):
-          File "<console>", line 1, in <module>
-    NameError: name 'Post' is not defined
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
 
-Ops! È comparso un errore. Ci dice che non c'è nessun Post. È corretto -- ci siamo dimenticati di importarlo!
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
 
-    >>> from blog.models import Post
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> from blog.models import Post
+```
 
-È semplice: importiamo il modello `Post` da `blog.models`. Proviamo a rendere di nuovo visibili tutti i post:
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
 
-    >>> Post.objects.all()
-    <QuerySet [<Post: my post title>, <Post: another post title>]>
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
 
-È una lista di post che abbiamo creato prima! Abbiamo creato questi post usando l'interfaccia di ammisnistrazione di Django. Comunque sia, ora vogliamo creare nuovi post usando Python, quindi come lo facciamo?
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
 
 ### Creare oggetti
 
 Così si crea un nuovo oggetto Post nel database:
 
-    >>> Post.objects.create(author=me, title='Sample title', text='Test')
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
 
-Ma manca un ingrediente qui: `me`. Dobbiamo passare un'istanza del modello `User` come un autore. Come si fa?
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
 
 Importiamo il modello User prima:
 
-    >>> from django.contrib.auth.models import User
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> from django.contrib.auth.models import User
+```
 
 Quali utenti abbiamo nel nostro database? Prova questo:
 
-    >>> User.objects.all()
-    <QuerySet [<User: ola>]>
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
 
-È il superuser che abbiamo creato prima! Ora prendiamo un'istanza del user:
+This is the superuser we created earlier! Let's get an instance of the user now:
 
-    me = User.objects.get(username='ola')
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> me = User.objects.get(username='ola')
+```
 
-Come puoi vedere, ora prendiamo `(get)` un `User` con un `username` che è uguale a 'ola'. Ben fatto, devi cambiarlo con il tuo username.
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
 
 Adesso possiamo finalmente creare il nostro post:
 
-    >>> Post.objects.create(author=me, title='Sample title', text='Test')
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
 
 Evviva! Vuoi controllare se funziona?
 
-    >>> Post.objects.all()
-    <QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
 
 Eccolo, un altro post nell'elenco!
 
 ### Aggiungi altri post
 
-Ora puoi divertirti un po' ed aggiungere altri post per vedere come funziona. Aggiungi altri 2 o 3 e vai alla prossima parte.
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
 
 ### Filtrare gli oggeti
 
-Larga parte parte dei QuerySet consiste nell'abilità di filtrarli. Diciamo che vogliamo trovare tutti i post che hanno come autore l'Utente ola. Useremo `filter` invece di `all` in `Post.objects.all()`. Tra parentesi affermeremo le condizioni che un blog post deve soddisfare per finire nel nostro queryset. Nella nostra situazione è `autore` che è uguale a `me`. Il modo di scriverlo in Django è `autore=me`. Ora il nostro pezzo di codice ha questo aspetto:
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. Useremo `filter` invece di `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Ora il nostro pezzo di codice ha questo aspetto:
+
+{% filename %}command-line{% endfilename %}
 
-    >>> Post.objects.filter(author=me)
-    <QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
 
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
 
-O magari vogliamo vedere tutti i post che contengono la parola 'titolo' nel campo `titolo`?
+{% filename %}command-line{% endfilename %}
 
-    >>> Post.objects.filter(title__contains='title')
-    <QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
 
+> **Nota** ci sono due caratteri di sottolineatura (`_`) tra `titolo` e `contains`. L'ORM di Django usa questa regola per separare i nomi dei field ("title") dalle operazioni e dai filtri ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
 
-> **Nota** ci sono due caratteri di sottolineatura (`_`) tra `titolo` e `contains`. L'ORM di Django usa questa sintassi per separare i nomi dei campi ("titolo") ed operazioni o filtri ("contiene"). Se usi solo un carattere di sottolineatura, otterrai un errore come "FieldError: non è possibile risolvere la parola chiave title_contains".
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
 
-Puoi anche ottenere una lista di tutti i post pubblicati. Lo facciamo filtrando tutti i post che hanno una `published_date` impostata in passato:
+{% filename %}command-line{% endfilename %}
 
-    >>> from django.utils import timezone
-    >>> Post.objects.filter(published_date__lte=timezone.now())
-    []
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
 
-Purtroppo, il post che abbiamo aggiunto dalla console Python non è ancora pubblicato. Possiamo modificarlo! In primo luogo ottenere un'istanza di un post che vogliamo pubblicare:
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
 
-    >>> post = Post.objects.get(title="Sample title")
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
 
-Ora pubblicalo con il nostro metodo `publish`!
+Ora pubblicalo con il nostro metodo `publish`:
 
-    >>> post.publish()
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> post.publish()
+```
 
-Ora cerca di ottenere di nuovo l'elenco dei post pubblicati (premere il pulsante di freccia in su 3 volte e premere `invio`):
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
 
-    >>> Post.objects.filter(published_date__lte=timezone.now())
-    <QuerySet [<Post: Sample title>]>
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
 
 ### Ordinare gli oggetti
 
 I QuerySet ti permettono anche di ordinare le liste di oggetti. Proviamo a ordinarli in base al campo `created_date`:
 
-    >>> Post.objects.order_by('created_date')
-    <QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
 
 Possiamo anche invertire l'ordine aggiungendo `-` all'inizio:
 
-    >>> Post.objects.order_by('-created_date')
-    <QuerySet [<Post: 4th title of post>, <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>, <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
 
-### QuerySet di concatenamento
+### QuerySets di concatenamento
 
-Puoi anche combinare QuerySet ** concatenandole** insieme:
+Puoi anche combinare QuerySets ** concatenandole** insieme:
 
     >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-
+    
 
 È davvero potente e ti permette di scrivere query piuttosto complesse.
 
 Fantastico! Ora sei pronta per la prossima parte! Per chiudere la shell, digita questo:
 
-    >>> exit()
-    $
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/it/django_start_project/README.md b/it/django_start_project/README.md
index 02d16306558..466e80b3594 100644
--- a/it/django_start_project/README.md
+++ b/it/django_start_project/README.md
@@ -1,32 +1,46 @@
 # Il tuo primo progetto Django!
 
-> Parte di questo capitolo è basato su esercitazioni di Geek Girls (https://github.com/ggcarrots/django-carrots).
+> Parte di questo capitolo è tratto dal tutorial delle Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 > 
-> Parti di questo capitolo sono basate sul [django-marcador tutorial][1] sotto la licenza Creative Commons Attributions-ShareAlike 4.0 International License. Il tutorial di django-marcador è protetto da copyright di Markus Zapke-Gründemann et al.
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Il tutorial di django-marcador è protetto da copyright di Markus Zapke-Gründemann et al.
 
- [1]: http://django-marcador.keimlink.de/
-
-Creeremo un semplice blog!
+We're going to create a small blog!
 
 Il primo passo è quello di iniziare un nuovo progetto di Django. Fondamentalmente, questo significa che eseguiremo alcuni script forniti da Django che creerà per noi lo scheletro di un progetto Django. Si tratta solo di un insieme di directory e file che verranno utilizzati dopo.
 
 I nomi di alcuni file e cartelle sono molto importanti per Django. Non dovresti modificare i nomi dei file che stiamo per creare. Neanche spostarli in un altro posto è una buona idea. Django deve mantenere una determinata struttura per essere in grado di trovare le cose importanti.
 
-> Ricordati di eseguire tutto nel virtualenv. Se non vedi un prefisso `(myvenv)` nella tua console devi attivare il tuo virtualenv. Abbiamo spiegato come farlo nel capitolo **installazione Django** nella parte **Lavorando con virtualenv**. Digitando `myvenv\Scripts\activate` su Windows oppure `source myvenv/bin/activate` su Mac OS / Linux farà questo per te.
+> Ricordati di eseguire tutto nel virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. Abbiamo spiegato come farlo nel capitolo **istallazione Django** nella parte **Lavorando con virtualenv**. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
 
-Dovresti eseguire nella tua console MacOS o Linux il seguente comando; **non dimenticarti di aggiungere il punto `.` alla fine **:
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ django-admin startproject mysite .
     
 
-Su Windows; **non dimenticarti di aggiungere il punto `.` alla fine**:
+> Il punto `.` è cruciale perché dice allo script d'installare Django nell'attuale directory (quindi il punto `.` è un riferimento di abbreviazione).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
 
-    (myvenv) C:\Users\Name\djangogirls> django-admin startproject mysite .
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
     
 
-> Il punto `.` è cruciale perché dice allo script d'installare Django nell'attuale directory (quindi il punto `.` è un riferimento di abbreviazione)
+> Il punto `.` è cruciale perché dice allo script d'installare Django nell'attuale directory (quindi il punto `.` è un riferimento di abbreviazione).
 > 
-> **Nota** Quando digiti i comandi sopra, ricorda che si digita soltanto la parte che inizia con `django-admin` oppure `django-admin.py`. Le parti mostrate qui come `(myvenv) ~/djangogirls$` e `(myvenv) C:\Users\Name\djangogirls>` sono solo esempi del prompt che starà invitando il tuo input sulla tua command line.
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
 
 `django-admin.py` è uno script che creerà le cartelle ed i file per te. Adesso dovresti avere una struttura di directory simile a questa:
 
@@ -39,7 +53,9 @@ Su Windows; **non dimenticarti di aggiungere il punto `.` alla fine**:
             __init__.py
     
 
-`manage.py` è uno script che aiuta a gestire il sito. Usandolo saremo in grado di avviare un web server sul nostro computer senza dover installare nient'altro, tra l'altro.
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
 
 Il file `settings.py` contiene la configurazione del tuo sito web.
 
@@ -49,33 +65,59 @@ Ignoriamo gli altri file per ora dal momento che non li modificheremo. L'unica c
 
 ## Modificare le impostazioni
 
-Facciamo qualche cambiamento in `mysite/settings.py`. Apri il file usando il code editor che hai installato prima.
+Facciamo qualche cambiamento in `mysite/settings.py`. Apri il file usando il code editor che hai istallato prima.
 
-Sarebbe bello avere l'ora corretta sul nostro sito Web. Vai alla [lista di fusi orari di wikipedia][2] e copia il tuo fuso orario (TZ). (es. `Europe/Berlin`)
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
 
- [2]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+Sarebbe bello avere l'ora corretta sul nostro sito Web. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
 
-In settings.py, trova la riga che contiene `TIME_ZONE` e modificala per scegliere il tuo fuso orario:
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 TIME_ZONE = 'Europe/Berlin'
 ```
 
-Modifica "Europe/Berlin" nel modo corretto
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
 
-Avrai anche bisogno di aggiungere un percorso per i file statici (scopriremo tutto su file statici e CSS più avanti nell'esercitazione). Scendi fino alla *fine* del file e sotto la voce `STATIC_URL`, aggiungi un nuovo percorso chiamato `STATIC_ROOT`:
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 STATIC_URL = '/static/'
 STATIC_ROOT = os.path.join(BASE_DIR, 'static')
 ```
 
-## Imposta un database
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
 
 Ci sono un sacco di software di database diversi che possono immagazzinare dati per il tuo sito. Noi useremo quello di default, `sqlite3`.
 
 È già impostato in questa parte del file `mysite/settings.py`:
 
+{% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 DATABASES = {
     'default': {
@@ -87,52 +129,74 @@ DATABASES = {
 
 Per creare un database per il nostro blog, eseguiamo questo nella console: `python manage.py migrate` (abbiamo bisogno di essere nella directory `djangogirls` che contiene il file `manage.py`). Se funziona, dovresti vedere qualcosa di simile:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py migrate
     Operations to perform:
-      Synchronize unmigrated apps: messages, staticfiles
-      Apply all migrations: contenttypes, sessions, admin, auth
-    Synchronizing apps without migrations:
-       Creating tables...
-          Running deferred SQL...
-       Installing custom SQL...
+      Apply all migrations: auth, admin, contenttypes, sessions
     Running migrations:
       Rendering model states... DONE
       Applying contenttypes.0001_initial... OK
       Applying auth.0001_initial... OK
       Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
       Applying contenttypes.0002_remove_content_type_name... OK
       Applying auth.0002_alter_permission_name_max_length... OK
       Applying auth.0003_alter_user_email_max_length... OK
       Applying auth.0004_alter_user_username_opts... OK
       Applying auth.0005_alter_user_last_login_null... OK
       Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
       Applying sessions.0001_initial... OK
     
 
 E abbiamo finito! Tempo di avviare il server web e vedere se il nostro sito Web funziona!
 
+## Starting the web server
+
 Devi essere nella directory che contiene il file di `manage.py` (la directory `djangogirls`). Nella console, possiamo avviare il server web eseguendo `python manage.py runserver`:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py runserver
     
 
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
 Se sei su Windows e non funziona con `UnicodeDecodeError`, usa questo comando:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
     
 
-Ora tutto quello che devi fare è controllare che il tuo sito sia in esecuzione. Apri il tuo browser (Firefox, Chrome, Safari, Internet Explorer o qualsiasi altro tu usi) e digita l'indirizzo:
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
 
     http://127.0.0.1:8000/
     
 
+If you're using a Chromebook, you'll always visit your test server by accessing:
 
-Il server web assumerà il controllo del command prompt finché non lo fermi. Per digitare più comandi mentre è in esecuzione apri una nuova finestra di terminale e attiva il tuo virtualenv. Per fermare il server web, torna alla finestra dove è in esecuzione e premi i pulsanti CTRL+C - Control e C insieme (su Windows, è probabile che tu deva premere Ctrl+Break).
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
 
 Congratulazioni! Hai appena creato il tuo primo sito e l'hai avviato usando un web server! Non è fantastico?
 
-![Ha funzionato!][3]
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
 
- [3]: images/it_worked2.png
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
 
-Pronto/a per il prossimo passo? È ora di creare un po' di contenuti!
+Pronto/a per il prossimo passo? È ora di creare un po' di contenuti!
\ No newline at end of file
diff --git a/it/django_templates/README.md b/it/django_templates/README.md
index c2697f5a341..b02d0bc15a5 100644
--- a/it/django_templates/README.md
+++ b/it/django_templates/README.md
@@ -4,9 +4,9 @@
 
 ## Cosa sono i template tags?
 
-In HTML non puoi scrivere codice Python, perché i browser non lo capiscono. Essi conoscono solo l'HTML. Noi sappiamo che l'HTML è piuttosto statico, mentre Python è molto più dinamico.
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
 
-I **Django template tags** ci permettono di trasferire le cose simili a Python in HTML, in modo che tu possa costruire siti web in modo più veloce e facile. Accidenti!
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
 ## Mostra il template con la lista di post
 
@@ -14,64 +14,69 @@ Nel capitolo precedente abbiamo dato al nostro template una lista di posts nella
 
 Per stampare una variabile nel template Django, usiamo doppie parentesi graffe con il nome della variabile all'interno, così:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {{ posts }}
 ```
 
 Prova questo nel tuo template `blog/templates/blog/post_list.html`. Sostituisci tutto dal secondo `<div>` al terzo `</div>` con `{{ posts }}`. Salva il file e aggiorna la pagina per vedere i risultati:
 
-![Figura 13.1][1]
-
- [1]: images/step1.png
+![Figura 13.1](images/step1.png)
 
 Come vedi, quello che abbiamo è:
 
-    <QuerySet [<Post: My second post>, <Post: My first post>]>
-    
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
 
 Significa che Django lo vede come una lista di oggetti. Ricordi dalla **Introduzione a Python** come possiamo rendere visibili le liste? Sì, con for loops! In un template Django si fanno così:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
-    {{ post }}
+    {{ post }}
 {% endfor %}
 ```
 
 Prova ad inserirlo nel tuo template.
 
-![Figura 13.2][2]
+![Figura 13.2](images/step2.png)
 
- [2]: images/step2.png
+Funziona! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. Puoi mischiare i tag HTML con quelli di template. Il nostro `body` avrà questo aspetto:
 
-Funziona! Ma noi vogliamo che vengano mostrate come i post statici che abbiamo creato prima nel capitolo **Introduzione ad HTML**. Puoi mischiare i tag HTML con quelli di template. Il nostro `body` avrà questo aspetto:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <div>
-    <h1><a href="/">Django Girls Blog</a></h1>
+    <h1><a href="/">Django Girls Blog</a></h1>
 </div>
 
 {% for post in posts %}
-    <div>
-        <p>published: {{ post.published_date }}</p>
-        <h1><a href="">{{ post.title }}</a></h1>
-        <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endfor %}
 ```
 
 {% raw %}Tutto quello che hai messo tra `{% for %}` e `{% endfor %}` Sarà ripetuto per ciascun oggetto della lista. Aggiorna la tua pagina:{% endraw %}
 
-![Figura 13.3][3]
-
- [3]: images/step3.png
+![Figura 13.3](images/step3.png)
 
-Ti sei accorto che abbiamo utilizzato una notazione leggermente diversa questa volta `{{ post.title }}` oppure `{{ post.text }}`? Stiamo introducendo i dati in ciascuno dei campi definiti nel nostro modello `Post`. Inoltre le `|linebreaksbr` stanno spingendo il testo dei post attraverso un filtro per trasformare le line-breaks in paragrafi.
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? Stiamo introducendo i dati in ciascuno dei campi definiti nel nostro modello `Post`. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
 
 ## Un' ultima cosa
 
-Sarebbe bello vedere se il tuo sito funziona ancora su Internet, giusto? Proviamo a fare il deploy su PythonAnywhere di nuovo. Ecco un riepilogo dei passaggi...
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* Prima di tutto, fai il push del tuo codice verso Github
 
-*   Prima di tutto, fai il push del tuo codice verso Github
+{% filename %}command-line{% endfilename %}
 
     $ git status
     [...]
@@ -83,23 +88,19 @@ Sarebbe bello vedere se il tuo sito funziona ancora su Internet, giusto? Proviam
     $ git push
     
 
-*   Poi, ritorna su [PythonAnywhere][4] e vai alla tua **console di Bash** (o iniziane una nuova) ed esegui:
+* Poi, ritorna su [PythonAnywhere](https://www.pythonanywhere.com/consoles/) e vai alla tua **console di Bash** (o iniziane una nuova) ed esegui:
 
- [4]: https://www.pythonanywhere.com/consoles/
+{% filename %}PythonAnywhere command-line{% endfilename %}
 
     $ cd my-first-blog
     $ git pull
     [...]
     
 
-*   Infine, vai sulla [Web tab][5] e premi **Reload** sulla tua web app. L'aggiornamento dovrebbe essere live!
-
- [5]: https://www.pythonanywhere.com/web_app_setup/
-
-Congratulazioni! Ora vai avanti e prova ad aggiungere un nuovo post nel tuo Admin Django (ricorda di aggiungere una published_date!), sucessivamente aggiorna il tuo sito per vedere se il post compare.
+* Infine, vai sulla [Web tab](https://www.pythonanywhere.com/web_app_setup/) e premi **Reload** sulla tua web app. L'aggiornamento dovrebbe essere live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. Il database su PythonAnywhere e quello sul tuo computer sono diversi a differenza degli altri file.
 
-Funziona come un incantesimo? Ne siamo fieri! Staccati dal computer per un po', ti sei guadagnato/a una pausa. :)
+Congratulazioni! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
 
-![Figura 13.4][6]
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
 
- [6]: images/donut.png
+![Figura 13.4](images/donut.png)
\ No newline at end of file
diff --git a/it/django_urls/README.md b/it/django_urls/README.md
index b661a07a53a..a9733064488 100644
--- a/it/django_urls/README.md
+++ b/it/django_urls/README.md
@@ -1,125 +1,129 @@
-# Django URL
+# Django URLs
 
-Stiamo per costruire la nostra pagina web: una homepage per il tuo blog! Ma prima, impariamo un po' di più sulle url di Django.
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
 
 ## Che cos'è un URL?
 
-Una URL è semplicemente un indirizzo web. Puoi vedere una URL ogni volta che visiti un sito web - si vede nella barra degli indirizzi del tuo browser. (sì! `127.0.0.1:8000` is a URL! Anche `https://djangogirls.org` è una URL):
+Una URL è semplicemente un indirizzo web. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
 
-![Url][1]
+![Url](images/url.png)
 
- [1]: images/url.png
-
-Ogni pagina internet ha bisogno della sua URL. In questo modo la tua applicazione sa cosa deve mostrare a un utente che visita una URL. In Django usiamo qualcosa chiamato `URLconf` ( configurazione dell'URL). URLconf è un insieme di modelli che Django cercherà di far corrispondere con l'URL ricevuta per trovare la view giusta.
+Ogni pagina internet ha bisogno della sua URL. This way your application knows what it should show to a user who opens that URL. In Django usiamo qualcosa chiamato `URLconf` ( configurazione dell'URL). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
 
 ## Come funzionano le URL in Django?
 
 Apriamo il file `mysite/urls.py` nel code editor che hai scelto e vediamo com'è:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
-    # Examples:
-    # url(r'^$', 'mysite.views.home', name='home'),
-    # url(r'^blog/', include('blog.urls')),
-
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
 ]
 ```
 
-Come puoi vedere, Django ha già predisposto qualcosa per noi in questo file.
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. Verranno ignorati da Python.
 
-Le righe che iniziano con `#` sono commenti - questo significa che non verranno lette da Python. Comodo, non è vero?
+The admin URL, which you visited in previous chapter, is already here:
 
-L'admin URL , che hai visto nel capitolo precedente è già qui:
+{% filename %}mysite/urls.py{% endfilename %}
 
 ```python
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
 ```
 
-Questo significa che per ogni URL che comincia con `admin/` Django troverà la corrispondente *view*. In questo caso stiamo includendo un sacco di admin URL così che non sia tutto imballato in questo piccolo file - è più leggibile e più pulito.
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
 
 ## Regex
 
 Per caso ti stai chiedendo come fa Python a far corrispondere URL e view? Beh, questa parte è difficile. Django usa `regex`, abbreviazione di "espressioni regolari". Regex ha molte, (moltissime!) regole che costituiscono un modello di ricerca. Dal momento che i regex sono un argomento avanzato, non analizzeremo nel dettaglio come funzionano.
 
-Se vuoi capire come abbiamo creato i patterns, eccoti un esempio del procedimento - ci servirà solo un sottoinsieme limitato di regole per esprimere il modello che stiamo cercando, vale a dire:
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
 
-    ^ per l'inizio del testo
-    $ per la fine del testo
-    \d per una cifra
-    + per indicare che l'elemento precedente dovrebbe essere ripetuto almeno una volta
-    () per catturare parte del pattern
-    
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
 
-Il resto nella definizione dell'url sarà preso alla lettera.
+Anything else in the URL definition will be taken literally.
 
-Ora immagina di avere un sito Web con un indirizzo così: `http://www.mysite.com/post/12345/`, dove `12345` è il numero del tuo post.
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
 
-Scrivere view separate per ogni numero del post sarebbe veramente noioso. Con l'espressione regolare possiamo creare un modello che corrisponde all'url ed estrae il numero per noi: `^ post/(\d+) / $`. Scomponiamo pezzo per pezzo per vedere che cosa stiamo facendo:
+Scrivere view separate per ogni numero del post sarebbe veramente noioso. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
 
-*   **^ post /** sta dicendo a Django di prendere tutto ciò che ha `post /` all'inizio dell'url (subito dopo `^`)
-*   **(\d+)** significa che ci sarà un numero (composto da una o più cifre) e che noi vogliamo che il numero venga catturato ed estratto
-*   **/** dice a django che ci dovrebbe essere un altro carattere a seguire `/`
-*   infine, **$** indica la fine dell'URL. Significa che solo le stringhe che terminano con `/` corrisponderanno a questo modello
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** significa che ci sarà un numero (composto da una o più cifre) e che noi vogliamo che il numero venga catturato ed estratto
+* **/** dice a django che ci dovrebbe essere un altro carattere a seguire `/`
+* infine, **$** indica la fine dell'URL. Significa che solo le stringhe che terminano con `/` corrisponderanno a questo modello
 
-## La tua prima Url Django!
+## Your first Django URL!
 
-È ora di creare la tua prima URL. Vogliamo usare http://127.0.0.1:8000/ come homepage per il nostro blog e visualizzare il nostro elenco di post.
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
 
-Vogliamo anche mantenere il file di `mysite/urls.py` pulito, quindi importeremo le url dalla nostra applicazione `blog` sul file principale `mysite/urls.py`.
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
 
-Vai avanti, elimina le righe commentate (che cominciano con `#`) e aggiungi una riga che importerà `blog.urls` nella url principale (`''`).
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
 
 Il tuo file `mysite/urls.py` ora dovrebbe avere questo aspetto:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import include
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
     url(r'', include('blog.urls')),
 ]
 ```
 
 Django reindirizzerà ora tutto ciò che viene da 'http://127.0.0.1:8000/' verso `blog.urls` e cercherà ulteriori istruzioni in questo file.
 
-Quando si scrivono espressioni regolari in Python lo si fa sempre con `r` davanti alla stringa. Questo è un suggerimento utile per Python che la stringa possa contenere caratteri speciali che non sono destinati per lo stesso Python, ma per l'espressione regolare.
+Writing regular expressions in Python is always done with `r` in front of the string. Questo è un suggerimento utile per Python che la stringa possa contenere caratteri speciali che non sono destinati per lo stesso Python, ma per l'espressione regolare.
 
 ## blog.urls
 
-Crea un nuovo file `blog/urls.py`. Perfetto! Ora aggiungi queste prime due righe:
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
 from . import views
 ```
 
-Stiamo solo importando metodi che appartengono a Django e tutte le nostre `views` dalla nostra app `blog` (non abbiamo ancora nulla all'interno, ma rimedieremo a questo in un minuto!)
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
 
 Dopo di che, possiamo aggiungere il nostro primo modello di URL:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
 ]
 ```
 
-Come vedi, stiamo assegnando una `view` nominata `post_list` alla URL `^$`. Questa espressione regolare combinerà`^` (un inizio) seguito da `$` (una fine) - cosicché solo una stringa vuota possa combaciare. È giusto, perché nei resolver di URL di Django, ' http://127.0.0.1:8000 /' non è una parte dell'URL. Questo schema dirà a Django che `views.post_list` è il posto giusto dove andare se qualcuno entra nel tuo sito all'indirizzo 'http://127.0.0.1:8000/'.
-
-L'ultima parte `name='post_list'` è il nome dell'URL che verrà usata per identificare la view. Può avere lo stesso nome della view, ma può anche essere qualcosa di completamente diverso. Useremo le URL rinominate successivamente nel progetto quindi è importante dare un nome a ciascuna URL nell'app. Inoltre dovremmo cercare di mantenere i nomi delle URL unici e facili da ricordare.
-
-Tutto fatto? Apri http://127.0.0.1:8000 / nel tuo browser per vedere il risultato.
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. È giusto, perché nei resolver di URL di Django, ' http://127.0.0.1:8000 /' non è una parte dell'URL. Questo schema dirà a Django che `views.post_list` è il posto giusto dove andare se qualcuno entra nel tuo sito all'indirizzo 'http://127.0.0.1:8000/'.
 
-![Errore][2]
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. Può avere lo stesso del nome della view, ma può anche essere qualcosa di completamente diverso. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
 
- [2]: images/error1.png
+Se provi a guardare adesso http://127.0.0.1:8000/, troverai un qualche tipo di messaggio come 'pagina non disponibile'. Questo perché il server (ricordi quando hai digitato `runserver`?) non è più attivo. Per capirne il motivo dai un occhiata alla console del tuo server.
 
-Non funziona, vero? Non ti preoccupare, è solo una pagina di errore, niente di cui spaventarsi! In realtà sono molto utili:
+![Errore](images/error1.png)
 
-Leggerai che **non c'è un attributo 'post_list**. il *post_list* ti ricorda qualcosa? Abbiamo chiamato la nostra view proprio così! Questo significa che è tutto a posto. Semplicemente non abbiamo ancora creato la nostra *view*. Non ti preoccupare, ci arriveremo.
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. È il nome della *view* che Django prova a cercare e usare, ma non l'abbiamo ancora creata. At this stage your `/admin/` will also not work. No worries – we will get there.
 
-> Se vuoi sapere di più sulla configurazione di URL Django, vai alla documentazione ufficiale: https://docs.djangoproject.com/en/1.8/topics/http/urls/
\ No newline at end of file
+> Se vuoi saperne di più su Django URLconfs, dai uno sguardo alla documentazione ufficiale: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/it/django_views/README.md b/it/django_views/README.md
index a65540fc789..43cdea1cbc2 100644
--- a/it/django_views/README.md
+++ b/it/django_views/README.md
@@ -1,6 +1,6 @@
-# Le views di Django - è arrivata l'ora di creare!
+# Django views – time to create!
 
-È ora di liberarsi di quel bug che abbiamo creato nel capitolo precedente :)
+E' ora di liberarsi di quel bug che abbiamo creato nel capitolo precedente! :)
 
 Una *view* è un posto dove viene messa la "logica" della nostra applicazione. Essa richiederà informazioni dal `modello` che hai creato prima e lo passerà ad un `template`. Creeremo un template nel prossimo capitolo. Le views sono solo metodi di Python un po' più complicati di quelli che abbiamo descritto nel capitolo **Introduzione a Python**.
 
@@ -10,29 +10,35 @@ Le views vengono collocate nel file `views.py`. Noi aggiungeremo le nostre *view
 
 OK, apriamo questo file e scopriamo cosa c'è dentro:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
-# Create your views here.
+# Crea le tue views qui.
 ```
 
-Non c'è molto per ora. La *view* più semplice può essere simile a questa.
+Non c'è altro qui.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_list(request):
-    return render(request, 'blog/post_list.html', {})
+    return render(request, 'blog/post_list.html', {})
 ```
 
-Come puoi vedere, abbiamo creato un metodo (`def`) chiamato `post_list` che prende `request` e `restituisce` un metodo `render` che ci fornirà (metterà insieme) il nostro template `blog/post_list.html`.
+Come puoi vedere, abbiamo creato una funzione (`def`) chiamata `post_list` che prende `request` e restituisce `return` una funzione `render` che renderizza (mette insieme) il nostro template `blog/post_list.html`.
 
-Salva il file, vai su http://127.0.0.1:8000/ e guarda cosa abbiamo ottenuto.
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
 
 Un altro errore! Leggi cosa sta succedendo adesso:
 
-![Error][1]
-
- [1]: images/error.png
+![Errore](images/error.png)
 
-Questo è facile: *TemplateDoesNotExist*. Sistemiamo il bug e creiamo un template nel prossimo capitolo!
+Questo mostra che almeno il server è ancora attivo, ma ancora non sembra corretto, vero? Non preoccuparti, è solo una pagina di errore, nulla di cui aver paura! Come l messaggi di errore nella console, sono davvero utili. Puoi leggere il *TemplateDoesNotExist*. Correggiamo questo bug e creiamo un template nel capitolo successivo!
 
-> Impara di più sulle views di Django leggendo la documentazione ufficiale: https://docs.djangoproject.com/en/1.8/topics/http/views/
\ No newline at end of file
+> Impara di più sulle views di Django leggendo la documentazione ufficiale: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/it/dynamic_data_in_templates/README.md b/it/dynamic_data_in_templates/README.md
index b3479a7996f..ab50ea81bb7 100644
--- a/it/dynamic_data_in_templates/README.md
+++ b/it/dynamic_data_in_templates/README.md
@@ -1,43 +1,50 @@
 # I dati dinamici nei templates
 
-Abbiamo diversi pezzi: il modello `Post` è definito in `models.py`, abbiamo `post_list` nel file `views.py` ed abbiamo aggiunto il template. Ma come faremo a far comparire i nostri post nel nostro template HTML? Perché questo è quello che vogliamo: prendere qualche contenuto (modelli salvati nel database) e farlo vedere in modo carino nel nostro template, giusto?
+Abbiamo diversi pezzi: il modello `Post` è definito in `models.py`, abbiamo `post_list` nel file `views.py` ed abbiamo aggiunto il template. Ma come faremo a far comparire i nostri post nel nostro template HTML? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
 
-Questo è esattamente quello che le *views* dovrebbero fare: collegare i modelli ed i template. Nella nostra `post_list` *view* avremo bisogno di prendere i modelli che vogliamo far vedere e passarli nel template. Quindi praticamente nella *view* decidiamo cosa (modello) renderemo visibile nel template.
+Questo è esattamente quello che le *views* dovrebbero fare: collegare i modelli ed i template. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. Nella *view* decidiamo cosa (modello) renderemo visibile nel template.
 
-OK, quindi come facciamo a farlo?
+OK, so how will we achieve this?
 
 Dobbiamo aprire il nostro `blog/views.py`. Per ora `post_list` *view* si vede così:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
 def post_list(request):
-    return render(request, 'blog/post_list.html', {})
+    return render(request, 'blog/post_list.html', {})
 ```
 
-Ricordi quando abbiamo parlato di includere codice scritto in diversi file? Ora è il momento di includere il model che abbiamo scritto in `models.py`. Aggiungeremo questa riga `from .models import Post` così:
+Ricordi quando abbiamo parlato di includere codice scritto in diversi file? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
 from .models import Post
 ```
 
-Il punto dopo il `from` significa *directory attuale* oppure *applicazione attuale*. Dal momento che `views.py` e `models.py` sono nella stessa directory possiamo semplicemente utilizzare `.` ed il nome del file (senza `.py`). Allora importiamo il nome del modello (`Post`).
+Il punto prima di `models` significa *directory attuale* oppure *applicazione attuale*. Sia `views.py` che `models.py` sono nella stessa cartella. Questo significa che possiamo usare `.` seguito dal nome del file (senza `.py`). Allora importiamo il nome del modello (`Post`).
 
-Cos'altro bisogna fare? Per poter prendere i post del blog dal modello`Post` ci serve una cosa chiamata `QuerySet`.
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
 
 ## QuerySet
 
-Dovresti già sapere come funziona QuerySet. Ne abbiamo parlato nel capitolo [Django ORM (QuerySets) ][1].
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
 
- [1]: ../django_orm/README.md
+Quindi ora vogliamo i post del blog che sono pubblicati ordinati per `published_date`, giusto? Lo abbiamo già fatto nel capitolo sulle QuerySet!
 
-Quindi ora ci interessa una lista di post del blog che sono pubblicati e organizzati da `published_date`, giusto? Lo abbiamo già fatto nel capitolo sulle QuerySet!
+{% filename %}blog/views.py{% endfilename %}
 
-    Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
 
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
 
-Adesso mettiamo questo pezzo di codice nel file `blog/views.py` aggiungendolo alla funzione `def post_list(request)`:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
@@ -49,15 +56,15 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Nota che abbiamo creato una *variabile* per il nostro QuerySet: `posts`. Vedila come il nome del nostro QuerySet. Da qui in avanti possiamo riferirci ad esso con questo nome.
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
 
-Il codice utilizza anche la funzione `timezone.now()`, quindi dobbiamo aggiungere un import per `timezone`.
+Nota che abbiamo creato una *variabile* per il nostro QuerySet: `posts`. Vedila come il nome del nostro QuerySet. Da qui in avanti possiamo riferirci ad esso con questo nome.
 
-L'ultima cosa che manca è passare la QuerySet `posts` nel template (ci occuperemo di come renderlo visibile nel prossimo capitolo).
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. Dobbiamo dargli un nome (ci atterremo a `'posts'` per il momento). :) Si vede così: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
 
-Nella funzione `render` abbiamo già un parametro con `request` (quindi tutto quello che riceviamo dal nostro utente via internet) e un file template `'blog/post_list.html'`. Nell'ultimo parametro, che è simile a questo: `{}` possiamo aggiungere cose che il template possa utilizzare. Dobbiamo dargli un nome (ci atterremo a `'posts'` per il momento :)). Si vede così: `{'posts': posts}`. Ti preghiamo di notare che la parte prima di `:` è una stringa; devi metterla tra virgolette `''`.
+Finalmente il nostro file `blog/views.py` dovrebbe essere così:
 
-Il nostro file `blog/views.py` dovrà risultare così:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
@@ -65,10 +72,10 @@ from django.utils import timezone
 from .models import Post
 
 def post_list(request):
-    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-    return render(request, 'blog/post_list.html', {'posts': posts})
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
 ```
 
-È tutto! Ora di tornare al nostro template e rendere visibile questo QuerySet!
+E' tutto! Ora di tornare al nostro template e rendere visibile questo QuerySet!
 
-Se vuoi leggere di più sui QuerySets in Django dovresti dare un'occhiata qui: https://docs.djangoproject.com/en/1.8/ref/models/querysets/
\ No newline at end of file
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/it/extend_your_application/README.md b/it/extend_your_application/README.md
index be73b5469ec..22fc1c5daae 100644
--- a/it/extend_your_application/README.md
+++ b/it/extend_your_application/README.md
@@ -10,7 +10,7 @@ Abbiamo già un modello dei `Post`, quindi non abbiamo bisogno di aggiungere nie
 
 ## Creare un link di template verso la pagina di dettaglio di un post
 
-Cominceremo aggiungendo un link all'interno del file `blog/templates/blog/post_list.html`. Per ora dovrebbe avere questo aspetto:
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -25,25 +25,26 @@ Cominceremo aggiungendo un link all'interno del file `blog/templates/blog/post_l
             <p>{{ post.text|linebreaksbr }}</p>
         </div>
     {% endfor %}
-{% endblock content %}
+{% endblock %}
 ```
 
-
 {% raw %}Vogliamo creare un link che dal titolo di un post facente parte dell'elenco di articoli porti alla pagina di dettaglio. Cambiamo `<h1><a href="">{{ post.title }}</a></h1>` così che linki alla pagina di dettaglio del post:{% endraw %}
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
 ```
 
 {% raw %}È arrivata l'ora di spiegare il misterioso `{% url 'post_detail' pk=post.pk %}`. Come avrai capito, il simbolo `{% %}` significa che stiamo usando i tag del template di Django. Questa volta ne useremo uno che creerà una URL per noi!{% endraw %}
 
-`blog.views.post_detail` è un percorso per arrivare alla `post_detail` *view* che vogliamo creare. Nota bene: `blog` è il nome della nostra applicazione (la directory `blog`), `views` viene dal nome del file `views.py` e l'ultima cosa - `post_detail` - è il nome della *view*.
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
 
-Adesso quando andremo all'indirizzo: http://127.0.0.1:8000/ avremo un errore (come sapevamo, dal momento che non abbiamo una URL oppure una *view* per `post_detail`). Avrà questo aspetto:
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
 
-![Errore: nessuna corrispondenza inversa][1]
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
 
- [1]: images/no_reverse_match2.png
+![Errore: nessuna corrispondenza inversa](images/no_reverse_match2.png)
 
 ## Crea una URL per i dettagli di un post
 
@@ -51,7 +52,9 @@ Creiamo una URL in `urls.py` per il nostro `post_detail` *view*!
 
 Vogliamo che il nostro primo post venga visualizzato a questo **URL **: http://127.0.0.1:8000/post/1/
 
-Facciamo sì che l'URL nel file `blog/urls.py` punti Django ad una *view* chiamata `post_detail`, che mostrerà un intero post. Aggiungi la riga `url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),` al file `blog/urls.py`. Il file dovrebbe assomigliare a questo:
+Facciamo sì che l'URL nel file `blog/urls.py` punti Django ad una *view* chiamata `post_detail`, che mostrerà un intero post. Aggiungi la riga `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` al file `blog/urls.py`. Il file dovrebbe assomigliare a questo:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
@@ -59,82 +62,88 @@ from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
 ]
 ```
 
-Questa parte `^post/(?P<pk>[0-9]+)/$` sembra spaventosa, ma non preoccuparti - te la spiegheremo: - inizia ancora con `^` -- "l'inizio" - `post/` semplicemente significa che dopo l'inizio, l'URL dovrebbe contenere la parola **post** e **/**. Fin qui tutto bene. - `(?P<pk>[0-9]+)` - questa parte è più complicata. Significa che Django prenderà tutto quello che hai messo qui e lo trasferirà ad una view come variabile denominata `pk`. `[0-9]` ci dice anche che la variabile può essere solo un numero, non una lettera (quindi tutto tra 0 e 9). `+` significa che ci devono essere una o più cifre. Quindi qualcosa di simile a `http://127.0.0.1:8000/post//` non è valido, ma `http://127.0.0.1:8000/post/1234567890/` è perfetto! - `/` Quindi ci serve **/** di nuovo - `$` - "fine"!
-
-Ciò significa che se digiti `http://127.0.0.1:8000/post/5/` nel tuo browser, Django capirà che stai cercando una *view* chiamata `post_detail` e trasferirà l'informazione che `pk` è uguale a `5` a quella *view*.
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
 
-`pk` è un diminutivo di `primary key`. Questo nome viene frequentemente utilizzato nei progetti Django. Ma puoi chiamare la tua variabile come vuoi (ricorda: minuscole e `_` invece degli spazi!). Per esempio invece di `(?P<pk>[0-9]+)` potremmo avere la variabile `post_id`quindi questo pezzettino dovrebbe assomigliare a: `(?P<post_id>[0-9]+)`.
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. Significa che Django prenderà tutto quello che hai messo qui e lo trasferirà ad una view come variabile denominata `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` significa che ci devono essere una o più cifre. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
 
-Ok, abbiamo aggiunto un nuovo schema di URL a `blog/urls.py`! Aggiorniamo la pagina: http://127.0.0.1:8000/ Boom! Ancora un altro errore! Come previsto!
+Ciò significa che se digiti `http://127.0.0.1:8000/post/5/` nel tuo browser, Django capirà che stai cercando una *view* chiamata `post_detail` e trasferirà l'informazione che `pk` è uguale a `5` a quella *view*.
 
-![Errore attributo][2]
+OK, we've added a new URL pattern to `blog/urls.py`! Prova ad aggiornare la pagina: http://127.0.0.1:8000/ Boom! Il server ha smesso di funzionare di nuovo. Have a look at the console – as expected, there's yet another error!
 
- [2]: images/attribute_error2.png
+![Errore attributo](images/attribute_error2.png)
 
 Ti ricordi di quale è il prossimo passo? Ma certo: aggiungere una view!
 
 ## Aggiungi una view del post
 
-Questa volta alla nostra *view* viene data un altro parametro `pk`. La nostra *view* deve prenderlo, vero? Quindi definiremo la nostra funzione come `def post_detail(request, pk):`. Dobbiamo utilizzare esattamente lo stesso nome che abbiamo specificato in urls (`pk`). Omettere questa variabile è sbagliato e genererà un errore!
+This time our *view* is given an extra parameter, `pk`. La nostra *view* deve prenderlo, vero? Quindi definiremo la nostra funzione come `def post_detail(request, pk):`. Dobbiamo utilizzare esattamente lo stesso nome che abbiamo specificato in urls (`pk`). Omettere questa variabile è sbagliato e genererà un errore!
 
-Ora, noi vogliamo ottenere un unico post. Per farlo possiamo utilizzare le queryset così:
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
 
-    Post.objects.get(pk=pk)
+{% filename %}blog/views.py{% endfilename %}
 
+```python
+Post.objects.get(pk=pk)
+```
 
-Ma questo codice presenta un problema. Se non c'è `Post` con `primary key` (`pk`) otterremo un errore bruttissimo!
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
 
-![Errore: non esiste][3]
+![Errore: non esiste](images/does_not_exist2.png)
 
- [3]: images/does_not_exist2.png
+Noi non lo vogliamo! Ma, senza dubbio, Django ha qualcosa che si occuperà del problema per noi: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
 
-Noi non lo vogliamo! Ma, senza dubbio, Django ha qualcosa che si occuperà del problema per noi: `get_object_or_404`. Nel caso in cui non ci sia `Post` con la data `pk` mostrerà una pagina molto più carina (chiamata `Page Not Found 404`).
+![Pagina non trovata](images/404_2.png)
 
-![Pagina non trovata][4]
+La buona notizia è che in realtà puoi creare la tua pagina `Page not found` modificarla come vuoi e darle un bell'aspetto. Ma non è importantissimo in questo momento, quindi salteremo questa parte.
 
- [4]: images/404_2.png
+OK, time to add a *view* to our `views.py` file!
 
-La buona notizia è che in realtà puoi creare la tua pagina `Page not found` modificarla come vuoi e darle un bell'aspetto. Ma non è importantissimo in questo momento, quindi salteremo questa parte.
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
 
-Ok, è arrivata l'ora di aggiungere una *view* al nostro file `views.py`!
+We should open `blog/views.py` and add the following code near the other `from` lines:
 
-Dovremo aprire `blog/views.py` ed aggiungere il seguente codice:
+{% filename %}blog/views.py{% endfilename %}
 
-    from django.shortcuts import render, get_object_or_404
+```python
+from django.shortcuts import render, get_object_or_404
+```
 
+And at the end of the file we will add our *view*:
 
-Vicino ad altre righe `from` ed alla fine del file aggiungeremo la nostra *view*:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    def post_detail(request, pk):
-        post = get_object_or_404(Post, pk=pk)
-        return render(request, 'blog/post_detail.html', {'post': post})
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
 ```
 
-Si, è giunta l'ora di aggiornare la pagina: http://127.0.0.1:8000/
-
-![Visualizzazione elenco post][5]
+Si. E' giunta l'ora di aggiornare la pagina: http://127.0.0.1:8000/
 
- [5]: images/post_list2.png
+![Visualizzazione elenco post](images/post_list2.png)
 
 Ha funzionato! Ma cosa succede se clicchi su un link nel titolo del post?
 
-![Errore: il template non esiste][6]
-
- [6]: images/template_does_not_exist2.png
+![Errore: il template non esiste](images/template_does_not_exist2.png)
 
 Oh no! Un altro errore! Ma sappiamo già come occuparcene, giusto? Dobbiamo aggiungere un template!
 
-## Crea un template per il post detail
+## Create a template for the post details
 
 Creeremo un file in `blog/templates/blog` chiamato `post_detail.html`.
 
 Il risultato somiglierà a questo:
 
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -153,13 +162,11 @@ Il risultato somiglierà a questo:
 
 Stiamo estendendo ancora una volta il template di base. `base.html`. Nel blocco `content` vogliamo mostrare una published_date del post (se esiste), un titolo ed il testo. Ma dovremmo discutere di alcune cose importanti, vero?
 
-{% raw %}`{% if ... %} ... {% endif %}` è un tag di template che possiamo utilizzare quando vogliamo controllare qualcosa (ricordi `if ... else ..` dal capitolo **Introduzione a Python**?). In questo caso vogliamo controllare che la `published_date` di un post non sia vuota. {% endraw %}
-
-Ok, possiamo aggiornare la nostra pagina e vedere se `Page not found` non c'è più.
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
 
-![Pagina di dettaglio del post][7]
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
 
- [7]: images/post_detail2.png
+![Pagina di dettaglio del post](images/post_detail2.png)
 
 Si! Ha funzionato!
 
@@ -167,27 +174,24 @@ Si! Ha funzionato!
 
 Sarebbe bello vedere se il tuo sito Web sarà ancora funzionante in PythonAnywhere, vero? Proviamo a fare un alrto deploy.
 
+{% filename %}command-line{% endfilename %}
+
     $ git status
     $ git add --all .
     $ git status
     $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
     $ git push
+    
 
+Poi, in una [console PythonAnywhere Bash](https://www.pythonanywhere.com/consoles/):
 
-*   Poi, in una [console PythonAnywhere Bash][8]:
-
- [8]: https://www.pythonanywhere.com/consoles/
+{% filename %}command-line{% endfilename %}
 
     $ cd my-first-blog
-    $ source myvenv/bin/activate
-    (myvenv)$ git pull
-    [...]
-    (myvenv)$ python manage.py collectstatic
+    $ git pull
     [...]
+    
 
+Infine, vai sulla [Web tab](https://www.pythonanywhere.com/web_app_setup/) e premi **Reload**.
 
-*   Infine, vai su il [Web tab][9] e premi **Reload**.
-
- [9]: https://www.pythonanywhere.com/web_app_setup/
-
-Fatto! Congratulazioni :)
+Fatto! Congratulazioni :)
\ No newline at end of file
diff --git a/it/how_the_internet_works/README.md b/it/how_the_internet_works/README.md
index 13f02ddb34d..3392c0fd93b 100644
--- a/it/how_the_internet_works/README.md
+++ b/it/how_the_internet_works/README.md
@@ -1,53 +1,47 @@
-# Come funziona Internet
+# Come funziona l'Internet
 
-> Questo capitolo è ispirato ad un discorso di Jessica McKellar "How the Internet Works" (http://web.mit.edu/jesstess/www/).
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
 
-Scommettiamo che usi Internet tutti i giorni. Ma sai davvero che cosa succede quando digiti un indirizzo come https://djangogirls.org nel tuo browser e premi `invio`?
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
 
 La prima cosa da capire è che un sito è solo un gruppo di file salvati su un hard disk. Proprio come i tuoi film, la tua musica e le tue immagini. Tuttavia, c'è una caratteristica tipica dei siti web: includono un codice chiamato HTML.
 
 Se non hai familiarità con la programmazione, può essere difficile da capire l'HTML all'inizio, ma i tuoi web browser (come Chrome, Safari, Firefox, ecc) lo adorano. I browser sono progettati per capire questo codice, seguire le sue istruzioni e presentare questi file che costituiscono il tuo sito web esattamente nel modo desiderato.
 
-Come per tutti i file, dobbiamo archiviare i file HTML da qualche parte su un hard disk. Per l'Internet, utilizziamo computer speciali e potenti chiamati *servers*. Non hanno uno schermo, un mouse o una tastiera, perché il loro unico proposito è quello di archiviare i dati e fornirli. È per quello che vengono chiamati *servers* -- perché essi *servono* i tuoi dati.
+Come per tutti i file, dobbiamo archiviare i file HTML da qualche parte su un hard disk. Per l'Internet, utilizziamo computer speciali e potenti chiamati *servers*. Non hanno uno schermo, un mouse o una tastiera, perché il loro unico proposito è quello di archiviare i dati e fornirli. That's why they're called *servers* – because they *serve* you data.
 
-OK, ma tu vuoi sapere com'è internet, vero?
+OK, but you want to know how the Internet looks, right?
 
 Abbiamo creato un'immagine! Ecco com'è:
 
-![Figura 1.1][1]
+![Figura 1.1](images/internet_1.png)
 
- [1]: images/internet_1.png
+Sembra caotico, vero? In fact it is a network of connected machines (the above-mentioned *servers*). Centinaia di migliaia di macchine! Molti, molti chilometri di cavi in tutto il mondo! Puoi visitare un sito di Submarine Cable Map (http://submarinecablemap.com) per vedere quanto è complicata la rete. Ecco uno screenshot dal sito web:
 
-Sembra caotico, vero? Infatti è una rete di macchine collegate (i *servers* che abbiamo menzionato prima). Centinaia di migliaia di macchine! Molti, molti chilometri di cavi in tutto il mondo! Puoi visitare un sito di Submarine Cable Map (http://submarinecablemap.com) per vedere quanto è complicata la rete. Ecco uno screenshot dal sito web:
+![Figura 1.2](images/internet_3.png)
 
-![Figura 1.2][2]
-
- [2]: images/internet_3.png
-
-È affascinante, non è vero? Ma ovviamente, non è possibile avere un cavo fra ogni macchina collegata ad Internet. Quindi, per raggiungere una macchina (per esempio quella in cui è salvato https://djangogirls.org) dobbiamo far passare una richiesta attraverso a molte, molte macchine diverse.
+E' affascinante, non è vero? Ma ovviamente, non è possibile avere un cavo fra ogni macchina collegata ad Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
 
 Assomiglia a questo:
 
-![Figura 1.3][3]
+![Figura 1.3](images/internet_2.png)
 
- [3]: images/internet_2.png
-
-Immagina che quando digiti https://djangogirls.org invii una lettera che dice: "Caro Django Girls, voglio vedere il sito djangogirls.org. inviamelo, per favore!"
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
 
 La tua lettera arriva nell'ufficio postale più vicino a te. Dopo di che va in un altro ufficio postale, che è un po' più vicino al tuo destinatario, poi in un altro ed in un altro ancora finché viene consegnato a destinazione. L'unica cosa è che se invii molte lettere (*pacchi di dati*) allo stesso posto, potrebbero attraversare uffici postali totalmente diversi (*routers*). Questo dipende da come vengono distribuiti presso ogni ufficio.
 
-![Figura 1.4][4]
-
- [4]: images/internet_4.png
+![Figura 1.4](images/internet_4.png)
 
-Si, è esattamente così. Tu invii messaggi e ti aspetti una risposta. Certo, invece di carta e penna usi i bytes di dati, ma l'idea è la stessa!
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
 
-Al posto di indirizzi fisici, ovvero del nome della via, della città, del Cap, e del nome del Paese, usiamo indirizzi IP. Il tuo computer prima chiede il DNS (Domain Name System) per tradurre djangogirls.org in un indirizzo IP. Funziona un po' come i vecchi elenchi telefonici, dove cercando il nome della persona che volevi contattare potevi trovare il numero telefonico e l'indirizzo.
+Al posto di indirizzi fisici, ovvero del nome della via, della città, del Cap, e del nome del Paese, usiamo indirizzi IP. Il tuo computer prima chiede il DNS (Domain Name System) per tradurre djangogirls.org in un indirizzo IP. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
 
-Quando invii una lettera, deve avere determinate caratteristiche per essere consegnata correttamente: un indirizzo, un timbro, ecc. Inoltre utilizzi un linguaggio che il destinatario è in grado di capire, vero? Lo stesso vale per i *pacchi di dati* che invii per vedere un sito Web. Usiamo un protocollo chiamato HTTP (Hypertext Transfer Protocol).
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Inoltre utilizzi un linguaggio che il destinatario è in grado di capire, vero? Lo stesso vale per i *pacchi di dati* che invii per vedere un sito Web. Usiamo un protocollo chiamato HTTP (Hypertext Transfer Protocol).
 
 Quindi, praticamente, quando hai un sito, devi avere un *server* (macchina) dove archiviarlo. Quando il *server* riceve una *richiesta* (in una lettera), restituisce il tuo sito (in un'altra lettera).
 
-Dal momento che questo è il tutorial di Django, ti chiederai cosa fa Django. Quando invii una risposta, non vuoi inviare la stessa cosa a tutti. È molto meglio se le tue lettere son personalizzate, soprattutto per la persona che ti ha appena scritto, giusto? Django ti aiuta con la creazione di queste interessanti lettere personalizzate :).
+Since this is a Django tutorial, you might ask what Django does. Quando invii una risposta, non vuoi inviare la stessa cosa a tutti. E' molto meglio se le tue lettere son personalizzate, soprattutto per la persona che ti ha appena scritto, giusto? Django ti aiuta con la creazione di queste interessanti lettere personalizzate. :)
 
-Basta parlare, è arrivata l'ora di creare!
\ No newline at end of file
+Enough talk – time to create!
\ No newline at end of file
diff --git a/it/html/README.md b/it/html/README.md
index cd7287f49d8..8b742b8e26f 100644
--- a/it/html/README.md
+++ b/it/html/README.md
@@ -2,13 +2,13 @@
 
 Ti potresti chiedere, cos'è un template?
 
-Un template è un file che possiamo riutilizzare per presentare informazioni diverse in un formato consistente - per esempio, potresti utilizzare un template per aiutarti a scrivere una lettera, perché anche se ciascuna lettera potrebbe contenere un messaggio diverso ed essere a sua volta indirizzata ad una persona diversa, condivideranno lo stesso formato.
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
 
-Un template Django viene descritto in un linguaggio chiamato HTML (è lo stesso HTML che abbiamo menzionato nel primo capitolo **Come funziona l'Internet**).
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
 
 ## Cos'è l'HTML?
 
-HTML è un semplice codice che viene interpretato dal tuo browser - come Chrome, Firefox o Safari - per rendere un sito web visibile all'utente.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
 HTML sta per "HyperText Markup Language". **HyperText** significa che è un tipo di testo che supporta i collegamenti ipertestuali tra le pagine. **Markup** significa che abbiamo preso un documento e l'abbiamo contrassegnato con il codice per dire a qualcosa (in questo caso, un browser) come interpretare la pagina. Il codice HTML è costruito con **tags**, ognuno inizia con `<` e finisce con `>`. Questi tag rappresentano gli **elementi** di markup.
 
@@ -21,24 +21,24 @@ I template vengono salvati in una cartella `blog/templates/blog`. Quindi prima c
     blog
     └───templates
         └───blog
+    
 
-
-(Ti chiederai perché abbiamo bisogno di due directory chiamate entrambe `blog` - come scoprirai più tardi, si tratta semplicemente di una denominazione convenzionale che serve a rendere la vita più facile.)
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
 
 E ora crea un file `post_list.html` nella directory `blog/templates/blog` (lascialo in bianco per adesso).
 
 Guarda che aspetto ha il tuo sito adesso: http://127.0.0.1:8000/
 
-> Se continui ad avere un errore `TemplateDoesNotExists`, prova a riavviare il server. Vai nella command line, arresta il server premendo Ctrl+C ( I tasti Control e C insieme) e riavvialo utilizzando il comando `python manage.py runserver`.
-
-![Figura 11.1][1]
+> Se hai ancora l'errore `TemplateDoesNotExist`, prova a riavviare il tuo server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
 
- [1]: images/step1.png
+![Figura 11.1](images/step1.png)
 
 L'errore non c'è più! Congratulazioni :) Tuttavia, il tuo sito in realtà non sta pubblicando niente eccetto una pagina vuota, perché anche il tuo template è vuoto. Dobbiamo sistemarlo.
 
 Aggiungi quanto segue nel tuo file template:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <p>Hi there!</p>
@@ -46,28 +46,28 @@ Aggiungi quanto segue nel tuo file template:
 </html>
 ```
 
-Quindi come appare il tuo sito ora? Clicca per scoprirlo: http://127.0.0.1:8000/
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
 
-![Figura 11.2][2]
-
- [2]: images/step3.png
+![Figura 11.2](images/step3.png)
 
 Ha funzionato! Ottimo lavoro :)
 
-*   Il comando più basico, `<html>`, è sempre l'inizio di ogni pagina web e `</html>` è sempre la fine. Come puoi vedere, l'intero contenuto del sito va tra il tag iniziale `<html>` ed il tag conclusivo `</html>`
-*   `<p>` è un tag per gli elementi paragrafo; `</p>` conclude ogni paragrafo
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. Come puoi vedere, l'intero contenuto del sito va tra il tag iniziale `<html>` ed il tag conclusivo `</html>`
+* `<p>` è un tag per gli elementi paragrafo; `</p>` conclude ogni paragrafo
 
-## Head & body
+## Head and body
 
 Ciascuna pagina HTML è a sua volta divisa in due elementi: **head** e **body**.
 
-*   **head** è un elemento che contiene informazioni sul documento non visibili sullo schermo.
+* **head** è un elemento che contiene informazioni sul documento non visibili sullo schermo.
 
-*   **body** è l'elemento che contiene tutto ciò che invece viene visualizzato come parte della pagina web.
+* **body** è l'elemento che contiene tutto ciò che invece viene visualizzato come parte della pagina web.
 
 Utilizziamo `<head>` per dire al browser come interpretare la configurazione della pagina, e `<body>` per dirgli in realtà cosa c'è nella pagina.
 
-Per esempio, puoi mettere un elemento di titolo all'interno di `<head>`, così:
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -83,9 +83,7 @@ Per esempio, puoi mettere un elemento di titolo all'interno di `<head>`, così:
 
 Salva il file e aggiorna la tua pagina.
 
-![Figura 11.3][3]
-
- [3]: images/step4.png
+![Figura 11.3](images/step4.png)
 
 Hai notato come il browser ha capito che "Il blog di Ola" è il titolo della tua pagina? Ha interpretato `<title>Il blog di Ola</title>` ed ha messo il testo nella barra del titolo sul tuo browser (sarà anche utilizzato per i segnalibri e così via).
 
@@ -93,23 +91,26 @@ Probabilmente hai anche notato che ogni tag di apertura è abbinato ad un *tag d
 
 È come mettere le cose in delle scatole. Hai una grossa scatola, `<html></html>`; al suo interno c'è `<body></body>`, che contiene scatole ancora più piccole: `<p></p>`.
 
-Devi seguire queste regole di tag *di chiusura*, e di elementi *annidati* - se non lo fai, il browser potrebbe non essere in grado di interpretarli correttamente e la tua pagina verrà visualizzata incorrettamente.
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
 
 ## Personalizza il tuo template
 
 Ora puoi divertirti un po' e provare a personalizzare il tuo template! Qua ci sono un po' di tag utili per quello:
 
-*   `<h1>Un'intestazione</h1>` - per la tua intestazione più importante
-*   `<h2>Un sottotitolo</h2>` per un titolo di livello inferiore
-*   `<h3>Un sottotitolo più piccolo</h3>` ... e così via, fino a `<h6>`
-*   `<em>text</em>` enfatizza il tuo testo
-*   `<strong>text</strong>` enfatizza fortemente il tuo testo
-*   `<br />` va in un'altra riga (puoi mettere qualsiasi cosa dentro br)
-*   `<a href="https://djangogirls.org">link</a>` crea un link
-*   `<ul><li>primo elemento</li><li>secondo elemento</li></ul>` fa una lista, proprio come questa qui!
-*   `<div></div>` definisce una sezione della pagina
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>Un sottotitolo</h2>` per un titolo di livello inferiore
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` enfatizza il tuo testo
+* `<strong>text</strong>` enfatizza fortemente il tuo testo
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` crea un link
+* `<ul><li>primo elemento</li><li>secondo elemento</li></ul>` fa una lista, proprio come questa qui!
+* `<div></div>` definisce una sezione della pagina
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
 
-Qui c'è un esempio di un template completo:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -118,7 +119,7 @@ Qui c'è un esempio di un template completo:
     </head>
     <body>
         <div>
-            <h1><a href="">Django Girls Blog</a></h1>
+            <h1><a href="/">Django Girls Blog</a></h1>
         </div>
 
         <div>
@@ -128,8 +129,8 @@ Qui c'è un esempio di un template completo:
         </div>
 
         <div>
-            <p>published: 14.06.2014, 12:14</p>
-            <h2><a href="">My second post</a></h2>
+            <p>pubblicato: 14.06.2014, 12:14</p>
+            <h2><a href="">Il mio secondo postt</a></h2>
             <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
         </div>
     </body>
@@ -138,18 +139,16 @@ Qui c'è un esempio di un template completo:
 
 Abbiamo creato tre sezioni `div` qui.
 
-*   Il primo elemento `div` contiene il titolo del nostro blog - è un'intestazione ed un link
-*   Altri tre elementi `div` contengono i nostri post con la loro data di pubblicazione, `h2` con il titolo di un post che è cliccabile e due `p` (paragrafi) di testo, uno per la data e l'altro per i nostri post.
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Altri tre elementi `div` contengono i nostri post con la loro data di pubblicazione, `h2` con il titolo di un post che è cliccabile e due `p` (paragrafi) di testo, uno per la data e l'altro per i nostri post.
 
 Ci dà questo effetto:
 
-![Figura 11.4][4]
+![Figura 11.4](images/step6.png)
 
- [4]: images/step6.png
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
 
-Yaaay! Ma fino adesso, il nostro template mostra esattamente **la stessa informazione** - mentre prima stavamo dicendo che i template ci permettono di mostrare **diverse** informazioni nello **stesso formato**.
-
-Quello che vogliamo è visualizzare i veri post aggiunti nel nel nostro Django admin - è quello che faremo adesso.
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
 
 ## Un'ultima cosa: il deploy!
 
@@ -159,51 +158,56 @@ Sarebbe bello vedere tutto questo live su Internet, giusto? Facciamo un altro de
 
 Prima di tutto, vediamo quali file sono cambiati dall'ultimo deploy (esegui questi comandi localmente, non su PythonAnywhere):
 
-    $ git status
+{% filename %}command-line{% endfilename %}
 
+    $ git status
+    
 
 Assicurati di essere nella directory `djangogirls` e diciamo a `git` di includere tutte le modifiche in questa directory:
 
-    $ git add --all .
+{% filename %}command-line{% endfilename %}
 
+    $ git add --all .
+    
 
-> **Nota** `-A` (diminutivo di "all") significa che `git` riconoscerà anche il fatto che hai cancellato dei file (per impostazione predefinita, esso riconosce soltanto i file nuovi/modificati). Ricorda anche (dal capitolo 3) che il `.` significa la directory attuale.
+> **Nota** `--all` significa che `git` riconoscerà anche se hai eliminato dei files (di default riconosce solo i file nuovi o modificati). Ricorda anche (dal capitolo 3) che il `.` significa la directory attuale.
 
 Prima di caricare tutti i file, proviamo a controllare cosa caricherà `git` (tutti i file che caricherà `git` ora appariranno in verde):
 
-    $ git status
+{% filename %}command-line{% endfilename %}
 
+    $ git status
+    
 
 Ci siamo quasi, ora è il momento di dirgli di salvare questa modifica nella cronologia. Gli daremo un "messaggio di commit" dove descriviamo ciò che abbiamo modificato. Puoi digitare tutto quello che vuoi a questo punto, sarebbe utile scrivere qualcosa di descrittivo in modo da ricordare in futuro cos'hai fatto.
 
-    $ git commit -m "Ho cambiato l'HTML per questo sito."
+{% filename %}command-line{% endfilename %}
 
+    $ git commit -m "Ho cambiato l'HTML per questo sito."
+    
 
 > **Nota** Assicurati di usare doppie virgolette attorno al messaggio di commit.
 
-Quando hai finito, caricheremo (push) le nostre modifiche su Github:
+Once we've done that, we upload (push) our changes up to GitHub:
 
-    git push
+{% filename %}command-line{% endfilename %}
 
+    $ git push
+    
 
 ### Scarica il tuo nuovo codice su PythonAnywhere, e ricarica la tua web app
 
-*   Apri la [pagina Console PythonAnywhere][5] e vai alla tua **Bash console** (o iniziane una nuova). Quindi, esegui:
+* Apri la [pagina Console PythonAnywhere](https://www.pythonanywhere.com/consoles/) e vai alla tua **Bash console** (o iniziane una nuova). Quindi, esegui:
 
- [5]: https://www.pythonanywhere.com/consoles/
+{% filename %}command-line{% endfilename %}
 
     $ cd ~/my-first-blog
-    $ source myvenv/bin/activate
-    (myvenv)$ git pull
-    [...]
-    (myvenv)$ python manage.py collectstatic
+    $ git pull
     [...]
-
+    
 
 Ed osserva il tuo codice mentre viene scaricato. Se vuoi controllare che sia arrivato, puoi fare un salto alla scheda **Files** e vedere il tuo codice su PythonAnywhere.
 
-*   Infine, fai un salto alla [scheda Web][6] e premi **Reload** sulla tua web app.
-
- [6]: https://www.pythonanywhere.com/web_app_setup/
+* Infine, fai un salto alla [scheda Web](https://www.pythonanywhere.com/web_app_setup/) e premi **Reload** sulla tua web app.
 
-Il tuo aggiornamento dovrebbe essere applicato! Vai avanti ed aggiorna il tuo sito nel brower. Le modifiche dovrebbero essere visibili :)
\ No newline at end of file
+Il tuo aggiornamento dovrebbe essere applicato! Vai avanti ed aggiorna il tuo sito nel brower. Le modifiche dovrebbero essere visibili. :)
\ No newline at end of file
diff --git a/it/install_git.md b/it/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/it/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/it/installation/README.md b/it/installation/README.md
index ca7831573b1..4637f9404d4 100644
--- a/it/installation/README.md
+++ b/it/installation/README.md
@@ -1,10 +1,10 @@
 # Se stai facendo il tutorial a casa
 
-Se stai facendo il tutorial a casa e non durante uno degli [eventi Django Girls ](https://djangogirls.org/events/), puoi saltare questo capitolo e andare direttamente a [Come funziona Internet](../how_the_internet_works/README.md).
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
 
-Copriamo questi argomenti nel tutorial completo, e questa è una pagina aggiuntiva contenente tutte le istruzioni di installazione. L'evento Django Girls include una "serata dedicata all'installazione" in cui installiamo tutto, in modo da non preoccuparcene durante il workshop, quindi questo capitolo è utile per chi partecipa ad uno dei nostri workshop.
+Copriamo questi argomenti nel tutorial completo, e questa è una pagina aggiuntiva contenente tutte le istruzioni di installazione. L'evento Django Girls include una "serata di installazione" dove andremo ad installare tutto ciò che ci serve, così non dovremo farlo durante il workshop.
 
-Se lo trovi utile puoi seguire anche questo capitolo. Ma se vuoi iniziare a imparare prima di installare le cose sul tuo computer, salta questo capitolo. Ti spiegheremo l'installazione più avanti.
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
 
 Buona fortuna!
 
@@ -12,6 +12,11 @@ Buona fortuna!
 
 Nel workshop costruirai un blog, e ci sono alcuni task dedicati all'impostazione che sarebbe bello completare in anticipo, in modo che tu sia pronta a scrivere codice in giornata.
 
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
 # Installare Python
 
 {% include "/python_installation/instructions.md" %}
@@ -30,7 +35,7 @@ Nel workshop costruirai un blog, e ci sono alcuni task dedicati all'impostazione
 
 # Creare un account GitHub
 
-Vai su [GitHub.com](https://www.github.com) e iscriviti per un nuovo account gratuito.
+Vai all'indirizzo [GitHub.com](https://www.github.com) e crea un nuovo account utente gratuito.
 
 # Creare un account PythonAnywhere
 
@@ -38,12 +43,16 @@ Vai su [GitHub.com](https://www.github.com) e iscriviti per un nuovo account gra
 
 # Inizia la lettura
 
-Complimenti, ora sei pronta! Se hai un po' di tempo prima del workshop, potrebbe essere utile cominciare a leggere i capitoli iniziali:
+Congratulazioni, sei pronta a partire! Se hai del tempo prima del workshop sarebbe magnifico se leggessi qualche capitolo iniziale:
+
+* [Come funziona Internet](../how_the_internet_works/README.md)
+
+* [Introduzione alla riga di comando](../intro_to_command_line/README.md)
 
-  * [Come funziona Internet](../how_the_internet_works/README.md)
+* [Introduzione a Python](../python_introduction/README.md)
 
-  * [Introduzione alla riga di comando](../intro_to_command_line/README.md)
+* [Che cos'è Django?](../django/README.md)
 
-  * [Introduzione a Python](../python_introduction/README.md)
+# Divertiti al workshop!
 
-  * [Che cos'è Django?](../django/README.md)
+Quando inizierà il workshop, potrai andare direttamente a [il tuo primo progetto Django!](../django_start_project/README.md) dato che hai già coperto il materiale dei capitoli precedenti.
\ No newline at end of file
diff --git a/it/instructions.md b/it/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/it/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/it/intro_to_command_line/README.md b/it/intro_to_command_line/README.md
index fd63b8bfca7..bb880673034 100644
--- a/it/intro_to_command_line/README.md
+++ b/it/intro_to_command_line/README.md
@@ -1,72 +1,109 @@
 # Introduzione alla linea di comando
 
-Eccitante, vero? Scriverai la tua prima riga di codice in pochi minuti :)
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
 
 **Ti presentiamo il tuo primo nuovo amico: la linea di comando!**
 
 I prossimi passaggi ti mostreranno come utilizzare quella 'finestra nera' che tutti gli hacker utilizzano. Ti potrà sembrare un po' allarmante all'inizio, ma è solamente un prompt in attesa dei tuoi comandi.
 
-> **Nota** Nota bene: in tutto questo tutorial usiamo sia il termine 'directory' che 'cartella' ma sono la stessa cosa.
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
 
 ## Cos'è la command line?
 
-La finestra solitamente chiamata **comand-line** o **interfaccia della command-line**, è un'applicazione basata su testo che ti permette di visualizzare, gestire e manipolare i file sul tuo computer. Molto simile a Windows Explorer o al Finder su Mac, ma senza l'interfaccia grafica. Altri nomi per la command line sono: *cmd*, *CLI*, *prompt*, *console* o *terminal*.
+La finestra solitamente chiamata **comand-line** o **interfaccia della command-line**, è un'applicazione basata su testo che ti permette di visualizzare, gestire e manipolare i file sul tuo computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Altri nomi per la command line sono: *cmd*, *CLI*, *prompt*, *console* o *terminal*.
 
 ## Aprire l'interfaccia di command-line
 
 Per cominciare a sperimentare dobbiamo aprire l'interfaccia della nostra command-line.
 
-### Windows
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
 
-Vai a menù Start → tutti i programmi → accessori → prompt dei comandi.
+<!--endsec-->
 
-### Mac OS X
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
 
-Applicazioni → utilità → terminal.
+Go to Applications → Utilities → Terminal.
 
-### Linux
+<!--endsec-->
 
-Probabilmente è sotto Applicazioni → Accessori → Terminal, ma quello potrebbe dipendere dal tuo sistema. Se non è lì cercalo su Google :)
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Probabilmente è sotto Applicazioni → Accessori → Terminal, ma quello potrebbe dipendere dal tuo sistema. Se non è lì cercalo su Google. :)
+
+<!--endsec-->
 
 ## Prompt
 
 Ora dovresti essere in grado di vedere una finestra bianca o nera che è in attesa di ricevere un comando.
 
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
 Se sei su Mac o Linux, probabilmente vedi `$`, proprio come questo:
 
+{% filename %}command-line{% endfilename %}
+
     $
     
 
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
 Su Windows, è un segno `>`, come questo:
 
+{% filename %}command-line{% endfilename %}
+
     >
     
 
-Ogni comando sarà preceduto da questo simbolo e da uno spazio, ma tu non hai bisogno di digitarlo. Il computer lo farà per te :)
+<!--endsec-->
+
+Ogni comando sarà preceduto da questo simbolo e da uno spazio, ma tu non hai bisogno di digitarlo. Il computer lo farà per te. :)
 
-> Solo una piccola nota: nel tuo caso ci dovrebbe essere qualcosa come `C:\Users\ola>` oppure `Olas-MacBook-Air:~ ola$` prima del segno di prompt. È corretto al 100%. In questo tutorial lo semplificheremo al massimo.
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+La parte fino al `$` o al `>` inclusi, si chiama *prompt della linea di comando* o semplicemente *prompt*. Ti richiede di inserire qualcosa.
+
+Nel tutorial quando vorremo che tu scriva un comando, includeremo `$` o `>` e occasionalmente qualcosa in più a sinistra. Puoi ignorare la parte a sinistra e inserire solo il comando dopo il prompt.
 
 ## Il tuo primo comando (YAY!)
 
-Cominciamo con qualcosa di veramente semplice. Digita questo comando:
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ whoami
     
 
-oppure
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > whoami
     
 
+<!--endsec-->
+
 Premi `invio`. Questo è il nostro risultato:
 
-    $ whoami
-    olasitarska
+{% filename %}command-line{% endfilename %}
+
+    $ whoami olasitarska
     
 
-Come puoi vedere, il computer ha appena stampato il tuo nome utente. Bello, eh?:)
+Come puoi vedere, il computer ha appena stampato il tuo nome utente. Bello, eh? :)
 
-> Prova a digitare ogni comando, non copiare ed incollare. Ti ricorderai di più in questo modo!
+> Try to type each command; do not copy-paste. You'll remember more this way!
 
 ## Nozioni di base
 
@@ -76,19 +113,29 @@ Ogni sistema operativo ha un insieme di comandi leggermente diverso per la comma
 
 Sarebbe bello sapere dove siamo adesso, vero? Vediamo. Digita questo commando e premi `invio`:
 
-    $ pwd
-    /Users/olasitarska
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd/utenti/olasitarska
     
 
-Se sei su Windows:
+> Nota: 'pwd' sta per 'stampa directory di lavoro'.
+
+<!--endsec-->
 
-    > cd
-    C:\Users\olasitarska
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd C:\Users\olasitarska
     
 
-Probabilmente vedrai qualcosa di simile sul tuo computer. Quando apri la command-line normalmente inizi sulla tua directory home.
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
 
-> Nota: 'pwd' sta per 'stampa directory di lavoro'.
+<!--endsec-->
+
+Probabilmente vedrai qualcosa di simile sul tuo computer. Quando apri la command-line normalmente inizi sulla tua directory home.
 
 * * *
 
@@ -96,6 +143,10 @@ Probabilmente vedrai qualcosa di simile sul tuo computer. Quando apri la command
 
 Cosa c'è dentro? Sarebbe bello scoprirlo. Vediamo come:
 
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ ls
     Applications
     Desktop
@@ -104,7 +155,11 @@ Cosa c'è dentro? Sarebbe bello scoprirlo. Vediamo come:
     ...
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > dir
      Directory of C:\Users\olasitarska
@@ -115,35 +170,57 @@ Windows:
     ...
     
 
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
 * * *
 
 ### Cambiare cartella corrente
 
 Ora, andiamo nella nostra directory Desktop:
 
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ cd Desktop
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd Desktop
     
 
+<!--endsec-->
+
 Controlla ora se ti sei veramente spostato/a:
 
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ pwd
     /Users/olasitarska/Desktop
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd
     C:\Users\olasitarska\Desktop
     
 
+<!--endsec-->
+
 Ecco fatto!
 
-> Suggerimento PRO: se digiti `cd D` e poi premi `tab` sulla tastiera, la command-line completerà automaticamente il resto del nome per cui puoi navigare più velocemente. Se c'è più di una cartella che comincia con "D", premi `tab` due volte per ottenere la lista con tutte le opzioni.
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
 
 * * *
 
@@ -151,15 +228,25 @@ Ecco fatto!
 
 Che ne dici di creare una directory di pratica sul tuo desktop? Puoi farlo in questo modo:
 
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ mkdir practice
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > mkdir practice
     
 
-Questo breve comando creerà una cartella con il nome `practice` sul tuo desktop. Puoi controllare se è lì semplicemente guardando sul tuo desktop oppure eseguendo un commando `ls` oppure `dir`! Provalo :)
+<!--endsec-->
+
+Questo breve comando creerà una cartella con il nome `practice` sul tuo desktop. Puoi controllare se è lì semplicemente guardando sul tuo desktop oppure eseguendo un commando `ls` oppure `dir`! Provalo. :)
 
 > Suggerimento PRO: se non vuoi digitare lo stesso comando tutte le volte, prova a premere ` freccia in su ` e `freccia in giù` sulla tua tastiera per scorrere tutti i comandi che hai usato fin ora.
 
@@ -167,17 +254,25 @@ Questo breve comando creerà una cartella con il nome `practice` sul tuo desktop
 
 ### Esercizio!
 
-Piccola sfida per te: nella tua directory appena creata `practice` crea una directory chiamata `test`. usa i comandi `cd` e `mkdir`.
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
 
 #### Soluzione:
 
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ cd practice
     $ mkdir test
     $ ls
     test
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd practice
     > mkdir test
@@ -185,6 +280,8 @@ Windows:
     05/08/2014 07:28 PM <DIR>      test
     
 
+<!--endsec-->
+
 Congratulazioni! :)
 
 * * *
@@ -195,85 +292,135 @@ Non vogliamo lasciare un pasticcio, per cui rimuoviamo tutto quello che abbiamo
 
 Per prima cosa dobbiamo tornare al Desktop:
 
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ cd ..
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd ..
     
 
-Usando `..` con il comando `cd` cambierai la tua directory attuale alla directory padre (si tratta della cartella che contiene la tua directory attuale).
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
 
 Controlla dove ti trovi ora:
 
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ pwd
     /Users/olasitarska/Desktop
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd
     C:\Users\olasitarska\Desktop
     
 
+<!--endsec-->
+
 Adesso è l'ora di cancellare la directory `practice`:
 
-> **Attenzione**: cancellare un file usando `del`, `rmdir` o `rm` è irreversibile, *i file cancellati andranno perduti per sempre*! Per cui sii molto prudente nell'utilizzare questi comandi.
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ rm -r practice
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > rmdir /S practice
     practice, Are you sure <Y/N>? Y
     
 
+<!--endsec-->
+
 Fatto! Per essere sicuri che sia stato effettivamente cancellato, controlliamo:
 
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ ls
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > dir
     
 
+<!--endsec-->
+
 ### Uscire dalla command line
 
-Questo è tutto per ora! puoi tranquillamente chiudere la tua command line. Facciamolo alla maniera degli hacker, va bene?:)
+Questo è tutto per ora! puoi tranquillamente chiudere la tua command line. facciamolo alla maniera degli hacker, va bene? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ exit
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > exit
     
 
-Figo, eh?:)
+<!--endsec-->
+
+Figo, eh? :)
 
 ## Indice
 
 Questo è un riepilogo di alcuni comandi utili:
 
-| Comandi(Windows) | Comandi (Mac OS / Linux) | Descrizione                 | Esempio                                           |
-| ---------------- | ------------------------ | --------------------------- | ------------------------------------------------- |
-| exit             | exit                     | chiudi la finestra          | **exit**                                          |
-| cd               | cd                       | cambiare directory          | **cd test**                                       |
-| dir              | ls                       | elenco directory/file       | **dir**                                           |
-| copy             | cp                       | copia un file               | **copy c:\test\test.txt c:\windows\test.txt** |
-| move             | mv                       | spostare un file            | **move c:\test\test.txt c:\windows\test.txt** |
-| mkdir            | mkdir                    | creare una nuova directory  | **mkdir testdirectory**                           |
-| del              | rm                       | eliminare un file/directory | **del c:\test\test.txt**                        |
+| Comandi(Windows) | Comandi (Mac OS / Linux)  | Descrizione                | Esempio                                           |
+| ---------------- | ------------------------- | -------------------------- | ------------------------------------------------- |
+| esci             | uscire dalla command line | chiudi la finestra         | **uscire dalla command line**                     |
+| cd               | cd                        | cambiare directory         | **cd test**                                       |
+| cd               | pwd                       | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir              | ls                        | elenco directory/file      | **dir**                                           |
+| copia            | cp                        | copia un file              | **copy c:\test\test.txt c:\windows\test.txt** |
+| sposta           | mv                        | spostare un file           | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir            | mkdir                     | creare una nuova directory | **mkdir testdirectory**                           |
+| rmdir (or del)   | rm                        | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S         | rm -r                     | delete a directory         | **rm -r testdirectory**                           |
 
 Questi sono solo alcuni dei comandi che puoi eseguire sulla tua command line, ma non ne userai altri oltre a quelli spiegati oggi.
 
-Se sei curioso/a, [ss64.com][1] contiene una guida completa ai comandi per tutti i sistemi operativi.
-
- [1]: http://ss64.com
+Se sei curioso/a, [ss64.com](http://ss64.com) contiene una guida completa ai comandi per tutti i sistemi operativi.
 
 ## Fatto?
 
-Tuffiamoci in Python!
+Tuffiamoci in Python!
\ No newline at end of file
diff --git a/it/python_installation/README.md b/it/python_installation/README.md
index bb131b68683..dc2a4893e0f 100644
--- a/it/python_installation/README.md
+++ b/it/python_installation/README.md
@@ -2,12 +2,14 @@
 
 Finalmente siamo qui!
 
-Ma prima, permettici di introdurre brevemente cos'è Python. Python è un linguaggio di programmazione molto popolare che può essere utilizzato per creare siti web, giochi, sofware scientifici, grafici e molto, molto altro.
+Ma prima, permettici di introdurre brevemente cos'è Python. Python è un linguaggio di programmazione molto popolare che può essere utilizzato per creare siti web, giochi, sofware scientifici, graffici e molto, molto altro.
 
-Python ha avuto origine alla fine degli anni '80 ed il suo obiettivo principale è quello di essere leggibile dagli esseri umani (non solo dalle macchine!). Per questo motivo sembra molto più semplice di altri linguaggi di programmazione. Questo lo rende facile da imparare, ma non ti preoccupare, Python è anche molto potente!
+Python ha avuto origine alla fine degli anni '80 ed il suo obiettivo principale è quello di essere leggibile dagli esseri umani (non solo dalle macchine!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
 
-# Installazione di Python
+# Istallazione di Python
 
-> **Nota** Se hai fatto la procedura di installazione, non c'è bisogno di farlo di nuovo - puoi saltare dritto/a al prossimo capitolo!
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
 
-{% include "/python_installation/instructions.md" %}
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/it/python_installation/instructions.md b/it/python_installation/instructions.md
index aa923d93268..4928f5d3c8a 100644
--- a/it/python_installation/instructions.md
+++ b/it/python_installation/instructions.md
@@ -1,59 +1,106 @@
-> Questa sezione si basa su un tutorial fatto da Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> Questa sezione è basata sul tutorial delle Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
 
-Django è scritto in Python. Abbiamo bisogno di Python per fare qualsiasi cosa in Django. Iniziamo con l'installazione! Vogliamo che sul tuo pc sia installato Python 3.4 quindi se hai una versione precedente, dovrai aggiornarlo.
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
 
-### Windows
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
 
-Puoi scaricare Python per Windows dal sito web https://www.python.org/downloads/release/python-343/. Dopo aver scaricato il file ***.msi**, lo dovresti eseguire (cliccaci sopra due volte) e segui le istruzioni. È importante ricordare il percorso (la directory) dove ha installato Python. Più tardi sarà necessario!
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
 
-Una cosa a cui fare attenzione: sulla seconda schermata dell'installazione guidata, contrassegnata "Customize", assicurati di scorrere verso il basso e di scegliere l'opzione "Add python.exe to the Path", come illustrato qui:
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
 
-![Non dimenticare di aggiungere Python al Path](../python_installation/images/add_python_to_windows_path.png)
+![Non dimenticare di aggiungere Python al Path](../python_installation/images/python-installation-options.png)
 
-### Linux
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+Devi andare sul sito https://www.python.org/downloads/release/python-361/ e scaricare il programma di installazione di Python:
+
+* Scarica il file *Mac OS X 64-bit/32-bit installer*
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
 
 È molto probabile che tu abbia Python già installato di default. Per controllare se ce l'hai già installato (e quale versione è), apri una console e digita il seguente comando:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 --version
-    Python 3.4.3
+    Python 3.6.1
     
 
-Se non hai Python installato o se vuoi una versione diversa, puoi installarla come segue:
+Se hai una differente 'micro versione' di Python installata, ad esempio la 3.6.0, non hai bisogno di aggiornarla. Se non hai Python installato o se vuoi una versione diversa, puoi istallarla come segue:
+
+<!--endsec-->
 
-#### Debian o Ubuntu
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
 
 Digita questo comando nella tua console:
 
-    $ sudo apt-get install python3.4
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
     
 
-#### Fedora
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
 
 Usa questo comando nella tua console:
 
-    $ sudo dnf install python3.4
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
     
 
-#### openSUSE
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
 
-Usa questo comando nella tua console:
+<!--endsec-->
 
-    $ sudo zypper install python3
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Usa questo comando nella tua console:
 
+{% filename %}command-line{% endfilename %}
 
-### OS X
+    $ sudo zypper install python3
+    
 
-Devi andare sul sito https://www.python.org/downloads/release/python-343/ e scarica il programma d'installazione di Python:
+<!--endsec-->
 
-  * Scarica il file *Mac OS X 64-bit/32-bit installer*
-  * Fai doppio click su *python-3.4.3-macosx10.6.pkg* per eseguire il programma d'installazione.
+Verify the installation was successful by opening a command prompt and running the `python3` command:
 
-Verifica che l'installazione si sia conclusa correttamente aprendo l'applicazione *Terminal* ed eseguendo il comando `python3`:
+{% filename %}command-line{% endfilename %}
 
     $ python3 --version
-    Python 3.4.3
+    Python 3.6.1
     
 
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
 * * *
 
-Se hai dubbi o se qualcosa è andato storto e non hai idea di cosa fare dopo - chiedi al tuo insegnante! A volte le cose non vanno come dovrebbero ed è meglio chiedere aiuto a qualcuno con più esperienza.
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! A volte le cose non vanno come dovrebbero ed è meglio chiedere aiuto a qualcuno con più esperienza.
\ No newline at end of file
diff --git a/it/python_introduction/README.md b/it/python_introduction/README.md
index 90fb27d0cb0..84301392c82 100644
--- a/it/python_introduction/README.md
+++ b/it/python_introduction/README.md
@@ -1,21 +1,23 @@
 # Introduzione a Python
 
-> Parte di questo capitolo è basato su esercitazioni di Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> Parte di questo capitolo è tratto dal tutorial delle Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 
-Scriviamo un pò codice!
+Scriviamo un po' di codice!
 
 ## La linea di comando di Python
 
-Per iniziare a giocare con Python, devi avviare sul tuo computer una *linea di comando*. Dovresti già sapere come farlo -- l'hai imparato nel capitolo [Introduzione a Command Line][1].
+> Per chi ci segue da casa: questa parte si trova nel video [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U).
 
- [1]: ../intro_to_command_line/README.md
+Per iniziare a giocare con Python, devi avviare sul tuo computer una *linea di comando*. Dovresti già sapere come farlo – l'hai imparato nel capitolo [Introduzione alla riga di comando](../intro_to_command_line/README.md).
 
 Una volta pronta, segui le istruzioni riportate di seguito.
 
 Vogliamo aprire una console Python, quindi digita `python` su Windows o `python3` su Mac OS/Linux e premi `invio`.
 
+{% filename %}command-line{% endfilename %}
+
     $ python3
-    Python 3.4.3 (...)
+    Python 3.6.1 (...)
     Type "help", "copyright", "credits" or "license" for more information.
     >>>
     
@@ -26,67 +28,102 @@ Dopo aver eseguito il comando Python, il prompt è cambiato in `>>>`. Significa
 
 Se ad un certo punto vuoi uscire dalla console di Python, digita `exit()` oppure usa la scorciatoia `Ctrl + Z` per Windows e `Ctrl + D` per Mac/Linux. Allora non vedrai più `>>>`.
 
-Per ora non vogliamo uscire dalla console Python. Vogliamo saperne di più. Cominciamo con qualcosa davvero semplice. Per esempio, prova un po' di matematica, come `2 + 3` e premi `invio`.
+Per ora, non vogliamo uscire dalla console di Python. Vogliamo saperne di più. Iniziamo digitando alcuni calcoli matematici, come `2 + 3` e premiamo `invio`.
 
-    >>> 2 + 3
-    5
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Bello! Hai visto come le risposte spuntano fuori? Python conosce la matematica! Prova altri comandi come:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
 
-Fantastico! Hai visto come è comparsa la risposta? Python conosce la matematica! potresti provare altri comandi come: - `4 * 5` - `5 - 1` - `40 / 2`
+Per eseguire un calcolo esponenziale, per esempio 2 elevato alla potenza 3, digitiamo: {% filename %}command-line{% endfilename %}
 
-Divertiti con questo per un pò e dopo torna qui :).
+```python
+>>> 2 ** 3
+8
+```
 
-Come puoi vedere, Python è una buona calcolatrice. Ora ti starai sicuramente chiedendo cos'altro è capace di fare...
+Divertiti con questo per un po' e dopo torna qui. :)
+
+Come puoi vedere, Python è una buona calcolatrice. Ora ti starai sicuramente chiedendo cos'altro è capace di fare…
 
 ## Stringhe
 
 Che ne dici di scrivere il tuo nome? Digitalo tra virgolette così:
 
-    >>> "Ola"
-    'Ola'
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
 
 Hai appena creato la tua prima stringa! Una stringa è una sequenza di caratteri che possono essere elaborati da un computer. La stringa deve sempre iniziare e finire con lo stesso carattere. Che può essere una virgoletta semplice (`'`) o doppia (`"`) (non c'è differenza!) Le virgolette dicono a Python che il contenuto al loro interno è una stringa.
 
 Le stringhe possono essere legate assieme. Prova questo:
 
-    >>> " Ciao " + "Ola"
-    'Ciao Ola'
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> " Ciao " + "Ola"
+'Ciao Ola'
+```
 
 Puoi anche moltiplicare le stringhe con un numero:
 
-    >>> "Ola" * 3
-    'OlaOlaOla'
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
 
 Se devi mettere un apostrofo nella tua stringa, hai due modi per farlo.
 
 Utilizzando le virgolette doppie:
 
-    >>> "Correre verso l'albero"
-    "Correre verso l'albero"
-    
+{% filename %}command-line{% endfilename %}
 
-o facendo l'escape dell'apostrofo (cioè trattandolo come un carattere qualunque) con una barra rovesciata ( \ ):
+```python
+>>> "L'ape Maja va"
+"L'ape Maja va"
+```
 
-    >>> 'Correre verso l\'albero'
-    "Correre verso l'albero"
-    
+o facendo l'escape dell'apostrofo (cioè trattandolo come un carattere qualunque) con una barra rovesciata (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "L\'ape Maja va"
+"L'ape Maja va"
+```
 
 Bello, eh? Per vedere il tuo nome in maiuscolo, digita:
 
-    >>> "Ola".upper()
-    'OLA'
-    
+{% filename %}command-line{% endfilename %}
 
-Hai appena usato la funzione `upper` sulla tua stringa! Una funzione (come `upper()`) è una sequenza di istruzioni che Python deve eseguire su un determinato oggetto (`"Ola"`).
+```python
+>>> "Ola".upper()
+'OLA'
+```
 
-Se vuoi sapere il numero delle lettere presenti nel tuo nome, c'è una funzione anche per quello!
+Hai appena usato il **metodo** `upper` sulla tua stringa! Un metodo (come `upper()`) è una sequenza di istruzioni che Python deve compiere su un oggetto dato (`"Ola"`) ogni volta che viene chiamato.
 
-    >>> len("Ola")
-    3
-    
+Se vuoi sapere quante il numero di lettere del tuo nome, c'è una **funzione** anche per quello!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
 
 Ti stai chiedendo perché certe volte chiami una funzione con un `.` alla fine di una stringa (come `"Ola".upper()`) ed in altri casi chiami prima una funzione e poi metti la stringa tra parentesi? Beh, in alcuni casi, le funzioni appartengono ad oggetti, come `upper()`, che può essere eseguita solo su stringhe. In questo caso, chiamiamo la funzione **metodo**. Altre volte, le funzioni non appartengono a niente di specifico e possono essere utilizzate su diversi tipi di oggetti, proprio come `len()`. Ecco perché stiamo dando `"Ola"` come un parametro alla funzione `len`.
 
@@ -94,10 +131,10 @@ Ti stai chiedendo perché certe volte chiami una funzione con un `.` alla fine d
 
 OK, basta con le stringhe. Ecco fino ad ora quanto hai imparato:
 
-*   **il prompt** - digitare i comandi (codice) nel prompt di Python restituisce risposte in Python
-*   **numeri e stringhe** - in Python i numeri vengono utilizzati per la matematica e le stringhe per oggetti testuali
-*   **operatori** - come + e *, combinano i valori per produrne di nuovi
-*   **funzioni** - come upper() e len(), eseguono azioni su oggetti.
+- Il **prompt** -- Digitare i comandi (codice) nel prompt di Python restituisce risposte in Python
+- **Numeri e stringhe** -- In Python i numeri vengono utilizzati per la matematica e le stringhe per oggetti testuali
+- Gli **operatori** -- come + e *, combinano più valori per produrne uno nuovo
+- **functions** – like `upper()` and `len()`, perform actions on objects.
 
 Queste sono le basi di ogni linguaggio di programmazione che impari. Pronta per qualcosa di più complicato? Scommetto che lo sei!
 
@@ -105,22 +142,28 @@ Queste sono le basi di ogni linguaggio di programmazione che impari. Pronta per
 
 Proviamo qualcosa di nuovo. Possiamo ottenere la lunghezza di un numero nella stessa forma in cui abbiamo potuto scoprire la lunghezza del nostro nome? Digita `len(304023)` e premi `Invio`:
 
-    >>> len(304023)
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    TypeError: object of type 'int' has no len()
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
 
 Abbiamo ottenuto il nostro primo errore! Ci dice che gli oggetti di tipo "int" (integers, numeri interi) non hanno lunghezza. Quindi cosa possiamo fare? Forse possiamo scrivere il nostro numero come una stringa? Le stringhe hanno una lunghezza, vero?
 
-    >>> len(str(304023))
-    6
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
 
 Ha funzionato! Usiamo la funzione `str` all'interno della funzione `len`. `str()` converte tutto in stringhe.
 
-*   La funzione `str` converte le cose in **stringhe**
-*   La funzione `int` converte le cose in **numeri interi**
+- La funzione `str` converte le cose in **stringhe**
+- La funzione `int` converte le cose in **numeri interi**
 
 > Importante: possiamo convertire i numeri in testo, ma non possiamo convertire il testo in numeri - cosa potrebbe essere `int('hello')`?
 
@@ -130,46 +173,64 @@ Un concetto importante nella programmazione è quello delle variabili. Una varia
 
 Diciamo che vogliamo creare una nuova variabile chiamata `nome`:
 
-    >>> nome = "Ola"
-    
+{% filename %}command-line{% endfilename %}
 
-Vedi? È facile! è semplicemente: nome è uguale a Ola.
+```python
+>>> nome = "Ola"
+```
 
-Come avrai notato, il programma non ha ritornato nulla, diversamente da prima. Quindi come facciamo a sapere che la variabile esiste? Digita `nome` e premi `enter`:
+Praticamente, poniamo il valore della variabile "nome" uguale a "Ola".
 
-    >>> nome
-    'Ola'
-    
+Come avrai notato, il programma non ha ritornato nulla, diversamente da prima. Quindi come facciamo a sapere che la variabile esiste? Digita `nome` e premi `invio`:
 
-Evvai! La tua prima variabile :)! Puoi sempre modificare a cosa si riferisce:
+{% filename %}command-line{% endfilename %}
 
-    >>> nome = "Sonja"
-    >>> nome
-    'Sonja'
-    
+```python
+>>> nome
+'Ola'
+```
+
+Urrà! La tua prima variabile! :) Puoi sempre cambiare il valore a cui essa si riferisce:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> nome = "Sonja"
+>>> nome
+'Sonja'
+```
 
 La puoi utilizzare anche nelle funzioni:
 
-    >>> len(nome)
-    5
-    
+{% filename %}command-line{% endfilename %}
 
-Fantastico, vero? Certo, le variabile possono essere qualsiasi cosa, così come i numeri! Prova questo:
+```python
+>>> len(nome)
+5
+```
 
-    >>> a = 4
-    >>> b = 6
-    >>> a * b
-    24
-    
+Fantastico, vero? Naturalmente, le variabili possono essere qualsiasi cosa, così come i numeri! Prova questo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
 
 Ma cosa succede se utilizziamo il nome sbagliato? Riesci a immaginare cosa succederebbe? Proviamo!
 
-    >>> city = "Tokyo"
-    >>> ctiy
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    NameError: name 'ctiy' is not defined
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
 
 Un errore! Come puoi vedere, Python ha diversi tipi di errori e questo qui si chiama **NameError**. Python ti darà questo errore se provi ad utilizzare una variabile che non è stata ancora definita. Se incontri questo errore più tardi, controlla il tuo codice per vedere se hai digitato in modo errato i nomi.
 
@@ -179,85 +240,116 @@ Giocaci per un po' e vedi cosa puoi fare!
 
 Prova questo:
 
-    >>> nome = 'Maria'
-    >>> nome
-    'Maria'
-    >>> print(nome)
-    Maria
-    
+{% filename %}command-line{% endfilename %}
 
-Quando digiti `nome`, l'interprete di Python risponde con una stringa *rappresentazione* della variabile 'nome', che contiene le lettere M-a-r-i-a, circondate da singole virgolette, ''. Quando dici `print(nome)`, Python "stamperà" i contenuti della variabile sullo schermo, senza le virgolette, che è più pulito.
+```python
+>>> nome = 'Maria'
+>>> nome
+'Maria'
+>>> print(name)
+Maria
+```
+
+Quando digiti `name`, l'interprete di Python risponde con una stringa *rappresentazione* della variabile 'nome', che contiene le lettere M-a-r-i-a, circondate da singole virgolette, ''. Quando dici `print(nome)`, Python "stamperà" i contenuti della variabile sullo schermo, senza le virgolette, che è più pulito.
 
 Come vedremo dopo, `print()` è anche utile quando vogliamo stampare le cose dall'interno delle funzioni, oppure quando vogliamo stampare le cose in molteplici righe.
 
 ## Liste
 
-Oltre alle stringhe ed ai numeri interi, Python ha tanti tipi di oggetti. Ora ne introdurremo uno chiamato **lista**. Le liste sono fatte proprio come immagini: sono oggetti che sono liste di altri oggetti :)
+Oltre alle stringhe ed ai numeri interi, Python ha tanti tipi di oggetti. Ora ne introdurremo uno chiamato **lista**. Le liste sono fatte proprio come immagini: sono oggetti che sono liste di altri oggetti. :)
 
 Vai avanti e crea una lista:
 
-    >>> []
-    []
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
 
 Si, questa lista è vuota. Non serve a molto, giusto? Creiamo una lista di numeri della lotteria. Non vogliamo ripetere tutto ogni volta, quindi metteremo la lista in una variabile:
 
-    >>> lotteria = [3, 42, 12, 19, 30, 59]
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lotteria = [3, 42, 12, 19, 30, 59]
+```
 
 Abbiamo una lista! Cosa possiamo farne? Vediamo quanti numeri della lotteria ci sono nella lista. Hai idea di quale funzione potresti utilizzare per farlo? Lo abbiamo imparato insieme prima!
 
-    >>> len(lotteria)
-    6
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lotteria)
+8
+```
 
 Si! `len()` può darti il numero di oggetti in una lista. Utile, vero? Forse abbiamo risolto:
 
-    >>> lotteria.sort()
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lotteria.sort()
+```
 
 Questo comando non dà nessun risultato, ha semplicemente cambiato l'ordine in cui i numeri appaiono nella lista. Stampiamo di nuovo la lista per vedere cosa è successo:
 
-    >>> print(lotteria)
-    [3, 12, 19, 30, 42, 59]
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lotteria)
+[3, 12, 19, 30, 42, 59]
+```
 
 Come puoi vedere, adesso i numeri nella tua lista sono ordinati dal valore più basso a quello più alto. Congratulazioni!
 
 Vogliamo invertire quell'ordine? Facciamolo!
 
-    >>> lotteria.reverse()
-    >>> print(lotteria)
-    [59, 42, 30, 19, 12, 3]
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lotteria.reverse()
+>>> print(lotteria)
+[59, 42, 30, 19, 12, 3]
+```
 
 Facile, vero? Se vuoi aggiungere qualcosa alla tua lista, puoi farlo digitando questo comando:
 
-    >>> lotteria.append(199)
-    >>> print(lotteria)
-    [59, 42, 30, 19, 12, 3, 199]
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lotteria.append(199)
+>>> print(lotteria)
+[59, 42, 30, 19, 12, 3, 199]
+```
 
 Se vuoi mostrare solo il primo numero, puoi farlo usando gli **indici**. L'indice è il numero che dice la posizione esatta dell'elemento all'interno di una lista. I programmatori preferiscono iniziare a contare da 0, quindi il primo oggetto nella lista è all'indice 0, il successivo all'1, e così via. Prova questo:
 
-    >>> print(lotteria[0])
-    59
-    >>> print(lotteria[1])
-    42
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lotteria[0])
+59
+>>> print(lotteria[1])
+42
+```
 
 Come puoi vedere, puoi accedere a diversi oggetti nella tua lista usando il nome della lista e l'indice dell'oggetto all'interno delle parentesi quadre.
 
-Per eliminare qualcosa dalla lista dovrai usare **indexes** come abbiamo visto sopra, e lo statement `pop()`. Proviamo a fare qualcosa per rafforzare quanto imparato prima; elimineremo il primo numero della lista.
+Per eliminare qualcosa dalla lista dovrai usare gli **indici** come abbiamo visto sopra, e il metodo `pop()`. Proviamo a fare un esercizio per rafforzare quanto abbiamo imparato prima; elimineremo il primo numero della lista.
 
-    >>> print(lotteria)
-    [59, 42, 30, 19, 12, 3, 199]
-    >>> print(lotteria[0])
-    59
-    >>> lotteria.pop(0)
-    >>> print(lotteria)
-    [42, 30, 19, 12, 3, 199]
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
 
 Ha funzionato a meraviglia!
 
@@ -267,254 +359,352 @@ Per saperne di più su i metodi disponibili per le liste puoi consultare questo
 
 ## Dizionari
 
+> Per chi ci segue da casa: questa parte si trova nel video [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+
 Un dizionario (dictionary) è simile a una lista, ma accedi ai valori cercando una chiave invece di un indice. Una chiave può essere qualsiasi stringa o numero. La sintassi per definire un dizionario vuoto è:
 
-    >>> {}
-    {}
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
 
 Questo dimostra che hai appena creato un dizionario vuoto. Evviva!
 
 Ora, prova a scrivere il seguente comando (prova a sostituirlo con le tue informazioni):
 
-    >>> partecipante = {'nome': 'Ola', 'paese': 'Polonia', 'numeri_preferiti': [7, 42, 92]}
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> partecipante = {'nome': 'Ola', 'paese': 'Polonia', 'numeri_preferiti': [7, 42, 92]}
+```
 
 Con questo comando hai appena creato una variabile chiamata `partecipante` con tre coppie di chiavi-valori:
 
-*   La chiave `nome` va a indicare il valore `'Ola'` (un oggetto `stringa`),
-*   `paese` indica `'Polonia'` (un'altra `stringa`),
-*   e `numeri_preferiti` indica `[7, 42, 92]` (una `lista` con tre numeri al suo interno).
+- La chiave `nome` va a indicare il valore `'Ola'` (un oggetto `stringa`),
+- `paese` indica `'Polonia'` (un'altra `stringa`),
+- e `numeri_preferiti` indica `[7, 42, 92]` (una `lista` con tre numeri al suo interno).
 
 Puoi controllare il contenuto di chiavi individuali con questa sintassi:
 
-    >>> print(partecipante['nome'])
-    Ola
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(partecipante['nome'])
+Ola
+```
 
 Vedi, assomiglia ad una lista. Ma non devi ricordare l'indice - solo il nome.
 
 Cosa succede se chiediamo a Python il valore di una chiave che non esiste? Riesci a indovinarlo? Proviamo!
 
-    >>> partecipante['età']
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    KeyError: 'età'
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> partecipante['età']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'età'
+```
 
 Guarda, un altro errore! Questo qua è un **KeyError**. Python è utile e ti dice che la chiave `'età'` non esiste in questo dizionario.
 
 Quando usare un dizionario o una lista? Bella domanda. Prova a formulare una soluzione mentalmente prima di vedere la risposta nella prossima riga.
 
-*   Ha bisogno di una sequenza ordinata di elementi? Fai una lista.
-*   Hai bisogno di associare i valori alle chiavi, così che potrai cercarle agilmente (per chiave) dopo? Usa un dizionario.
+- Ha bisogno di una sequenza ordinata di elementi? Fai una lista.
+- Hai bisogno di associare i valori alle chiavi, così che potrai cercarle agilmente (per chiave) dopo? Usa un dizionario.
 
-I dizionari, come le liste, sono *mutable*, significa che possono essere cambiati dopo che sono stati creati. Si possono aggiugere nuove coppie chiave/valore ad un dizionario dopo averlo creato:
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
 
-    >>> partecipante['linguaggio_preferito'] = 'Python'
-    
+{% filename %}command-line{% endfilename %}
 
-Così come succede se applicato alle liste, il metodo `len()` restituisce il numero di coppie chiave/valore anche quando applicato a un dizionario. Vai e digita il comando:
+```python
+>>> partecipante['linguaggio_preferito'] = 'Python'
+```
 
-    >>> len(partecipante)
-    4
-    
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
 
-Spero che abbia senso per te. :) Pronta per divertirti con i dizionari? Vai alla prossima riga per realizzare altre cose fantastiche.
+{% filename %}command-line{% endfilename %}
 
-Puoi usare il comando `pop()` per cancellare un elemento nella directory. Se vuoi cancellare la voce che corrisponde alla chiave `'numeri_preferiti'`, digita il seguente comando:
+```python
+>>> len(partecipante)
+4
+```
 
-    >>> partecipante.pop('numeri_preferiti')
-    >>> partecipante
-    {'paese': 'Polonia', 'linguaggio_preferito': 'Python', 'nome': 'Ola'}
-    
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
 
-Come puoi vedere dall'output, la coppia chiave-valore corrispondente alla chiave 'numeri_preferiti' è stato cancellata.
+You can use the `pop()` method to delete an item in the dictionary. Se vuoi cancellare la voce che corrisponde alla chiave `'numeri_preferiti'`, digita il seguente comando:
 
-Puoi anche cambiare un valore associato ad una chiave già creata nel dizionario. Digita:
+{% filename %}command-line{% endfilename %}
 
-    >>> partecipante['paese'] = 'Germania'
-    >>> partecipante
-    {'paese': 'Germania', 'linguaggio_preferito': 'Python', 'nome': 'Ola'}
-    
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
 
-Come puoi vedere, il valore della chiave `'paese'` è stato cambiato da `'Polonia'` a `'Germania'`. :) Eccitante, vero? Evviva! Hai già imparato un'altra cosa fantastica.
+```python
+>>> partecipante['paese'] = 'Germania'
+>>> partecipante
+{'paese': 'Germania', 'linguaggio_preferito': 'Python', 'nome': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
 
 ### Indice
 
 Fantastico! ora sai molto sulla programmazione. In questa ultima parte hai imparato:
 
-*   **errori** - ora sai come leggere e capire gli errori che appaiono se Python non comprende un comando che gli hai dato
-*   **variabili** - nomi per oggetti. Ti permettono di scrivere codice più semplice e di renderlo più leggibile
-*   **liste** - liste di oggetti archiviati in un ordine particolare
-*   **dizionari** - oggetti archiviati come coppie di chiave-valore
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
 
 Sei emozionato/a per la prossima parte? :)
 
 ## Confrontare le cose
 
-Larga parte della programmazione include il confrontare le cose. Qual è la cosa più semplice da confrontare? I numeri, senza dubbio. Vediamo come funziona:
-
-    >>> 5 > 2
-    True
-    >>> 3 < 1
-    False
-    >>> 5 > 2 * 2
-    True
-    >>> 1 == 1
-    True
-    >>> 5 != 2
-    True
-    
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
 
-Abbiamo dato a Python alcuni numeri da mettere a confronto. Come puoi vedere, Python può mettere a confronto non solo numeri, ma anche i risultati dei metodi. Forte, eh?
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
 
-Ti sei chiesta perché abbiamo messo due simboli di uguale `==` uno vicino all'altro per confrontare i numeri? Usiamo un singolo `=` per assegnare valori alle variabili. Sempre, **sempre** devi mettere due `==` se vuoi controllare se le cose sono uguali. Possiamo affermare anche che le cose sono diverse tra di loro. Per dirlo, usiamo il simbolo `!=`, come mostrato nell'esempio sopra.
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Ti sei chiesta perché abbiamo messo due simboli di uguale `==` uno vicino all'altro per confrontare i numeri? Usiamo un singolo `=` per assegnare valori alle variabili. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. Possiamo affermare anche che le cose sono diverse tra di loro. Per dirlo, usiamo il simbolo `!=`, come mostrato nell'esempio sopra.
 
 Dai a Python altri due compiti:
 
-    >>> 6 >= 12 / 2
-    True
-    >>> 3 <= 2
-    False
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
 
-`>` e `<` sono facili, ma cosa significano `>=` e `<=`? Leggili così:
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
 
-*   x `>` y significa: x è maggiore di y
-*   x `<` y significa: x è minore di y
-*   x `<=` y significa: x è minore o uguale a y
-*   x `>=` y significa: x è maggiore o uguale a y
+- x `>` y significa: x è maggiore di y
+- x `<` y significa: x è minore di y
+- x `<=` y significa: x è minore o uguale a y
+- x `>=` y significa: x è maggiore o uguale a y
 
 Fantastico! Vuoi farne due o tre? prova questo:
 
-    >>> 6 > 2 and 2 < 3
-    True
-    >>> 3 > 2 and 2 < 1
-    False
-    >>> 3 > 2 or 2 < 1
-    True
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
 
 Puoi dare a Python tutti i numeri da confrontare che vuoi, ti darà sempre una risposta! Molto intelligente, vero?
 
-*   **and** - se usi l'operatore `e`, entrambe le cose confrontate devono essere True in modo tale che l'intero comando sia True
-*   **or** - se usi l'operatore `o`, solo una delle cose messe a confronto deve essere True in modo tale che l'intero comando sia True
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
 
 Hai sentito parlare dell'espressione "comparare mele e arance"? Proviamo l'equivalente in Python:
 
-    >>> 1 > 'django'
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    TypeError: unorderable types: int() > str()
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
 
 Dall'espressione puoi capire che Python non è in grado di mettere a confronto un numero (`int`) e una stringa (`str`). Ci mostra invece un **TypeError** e ci dice che i due tipi non possono essere messi a confronto.
 
 ## Booleano
 
-Accidentalmente, hai appena imparato un nuovo tipo di oggetto in Python. Si chiama **Boolean** e probabilmente è il tipo più facile che ci sia.
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
 
-Ci sono solo due oggetti Boolean:
 - True
 - False
 
-Ma perché Python possa capirlo, bisogna sempre scrivere True (prima lettera maiuscola, le altre minuscole). **true, TRUE, tRUE non funzionano -- solo True è corretto.** (Lo stesso vale per False, ovviamente.)
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
 
 I Boolean possono anche essere variabili! Guarda qui:
 
-    >>> a = True
-    >>> a
-    True
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
 
 Lo puoi fare anche in questa forma:
 
-    >>> a = 2 > 5
-    >>> a
-    False
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
 
 Fai pratica e divertiti con i Boolean provando ad eseguire i seguenti comandi:
 
-*   `True and True`
-*   `False and True`
-*   `True or 1 == 1`
-*   `1 != 2`
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
 
 Congratulazioni! I valori Boolean sono tra le cose più interessanti della programmazione e tu hai appena imparato ad utilizzarli!
 
 # Salvalo!
 
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
 Finora abbiamo scritto il codice python nell'interprete, che ci permette di inserire una linea di codice per volta. I programmi vengono salvati in file ed eseguiti dall'**interpreter** del nostro linguaggio di programmazione o dal **compiler**. Fino ad ora abbiamo eseguito i nostri programmi una riga per volta nell' **interprete** di Python. Avremo bisogno di più di una riga di codice per i prossimi compiti, quindi dovremo fare queste cose velocemente:
 
-*   Uscire dall'interprete di Python
-*   Aprire l'editor di codice che abbiamo scelto
-*   Salvare un po' di codice in un file python
-*   Eseguirlo!
+- Uscire dall'interprete di Python
+- Aprire l'editor di codice che abbiamo scelto
+- Salvare un po' di codice in un file python
+- Eseguirlo!
 
-Per uscire dall'interprete di Python che è quello che stavamo utilizzando, digita la funzione ```exit()``` :
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
 
-    >>> exit()
-    $
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
 
 Questo ti immetterà nel prompt dei comandi.
 
-Prima, abbiamo preso un editore di codice dalla sezione [code editor][2]. Dovremo aprire l'editor ora e scrivere un po' di codice in un nuovo file:
+Prima, abbiamo preso un editore di codice dalla sezione [code editor](../code_editor/README.md). Dovremo aprire l'editor ora e scrivere un po' di codice in un nuovo file:
 
- [2]: ../code_editor/README.md
+{% filename %}editor{% endfilename %}
 
 ```python
 print('Ciao, Django girls!')
 ```
 
-> **Nota** Dovresti notare una delle cose più belle degli editori di codice: i colori! Nella console Python ogni cosa era dello stesso colore, mentre ora dovresti visualizzare la funzione `print` di un colore differente rispetto alla stringa che la segue. Questa viene chiamata "sintassi evidenziata", ed è veramente utile quando si scrive codice. Il colore serve come suggerimento, ad esempio per una stringa che non è chiusa, o un errore di digitazione di una keyword (come la `def` per le funzioni, che vedremo più avanti). Questo è uno dei motivi per cui usiamo un editor di codice :)
-
 Ovviamente a questo punto sei una programmatrice Python senior, quindi sentiti libera di scrivere un po' del codice che hai imparato oggi.
 
-Ora dobbiamo salvare il file e dargli un nome descrittivo. Chiama il file **python_intro.py** e salvalo sulla tua scrivania. Puoi chiamare il file come vuoi, ma è importante assicurarsi che finisca con **.py**. L'estensione **.py** dice al Sistema Operativo che questo è un **file eseguibile python** e che Python può eseguirlo.
+Ora dobbiamo salvare il file e dargli un nome descrittivo. Chiama il file **python_intro.py** e salvalo sulla tua scrivania. Puoi chiamare il file come vuoi, ma è importante assicurarsi che finisca con **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. Questa viene chiamata "sintassi evidenziata", ed è veramente utile quando si scrive codice. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). Questo è uno dei motivi per cui usiamo un editor di codice. :)
 
-È ora di eseguire il file! Usando le nozioni che hai imparato nella sezione command line, usa il terminal per **cambiare cartella** alla scrivania.
+E' ora di eseguire il file! Usando le nozioni che hai imparato nella sezione command line, usa il terminal per **cambiare cartella** alla scrivania.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
 
 Su un Mac, il comando assomiglierà a questo:
 
+{% filename %}command-line{% endfilename %}
+
     $ cd ~/Desktop
     
 
-Su Linux, sarà come questo (la parola "Desktop" potrebbe essere tradotta nella tua lingua):
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
 
     $ cd ~/Desktop
     
 
-E su windows, sara come questo:
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
 
     > cd %HomePath%\Desktop
     
 
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
 Se rimani bloccata, chiedi aiuto.
 
 Ora usa Python per eseguire il codice nel file:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Ciao, Django girls!
     
 
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
 Perfetto! Hai appena eseguito il tuo primo programma Python salvato su un file. Grande, no?
 
 Ora puoi continuare con uno strumento essenziale nella programmazione:
 
-## If...elif...else
+## If … elif … else
 
-Molte cose dovrebbero essere eseguite soltanto quando si incontrano certe condizioni. È per questo che Python ha gli **if statements**.
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
 
 Sostituisci il codice nel file **python_intro.py** con questo:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
 ```
 
-Se salviamo questo codice e lo eseguiamo, incontriamo un errore come questo:
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     File "python_intro.py", line 2
@@ -524,96 +714,137 @@ Se salviamo questo codice e lo eseguiamo, incontriamo un errore come questo:
 
 Python si aspetta che gli vengano fornite ulteriori istruzioni che saranno eseguite se la condizione `3 > 2` risulterà vera (o `True` se vogliamo). Proviamo a fare in modo che Python stampi "Funziona!". Modifica il tuo codice nel tuo file **python_intro.py** con questo:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
-     print('Funziona!')
+    print('It works!')
 ```
 
-Vedi come abbiamo indentato la riga successiva usando 4 spazi? Si deve fare così in modo tale che Python sappia quale codice eseguire se il risultato è True. Puoi fare uno spazio, ma circa tutti i programmatori di Python ne fanno 4 per far vedere le cose più ordinate. Anche un signolo `tab` conta come 4 spazi.
+Vedi come abbiamo indentato la riga successiva usando 4 spazi? Si deve fare così in modo tale che Python sappia quale codice eseguire se il risultato è True. Puoi mettere uno spazio, ma la maggior parte dei programmatori di Python ne mettono 4 per rendere le cose più ordinate. Anche un signolo `tab` conta come 4 spazi.
 
 Salvalo ed eseguilo di nuovo:
 
-    $ python3 python_intro.py
-    Funziona!
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+Funziona!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
 
 ### E se una condizione non è Vera?
 
 In esempi precedenti, il codice è stato eseguito solo quando le condizioni erano True. Ma Python ha anche gli `elif` e `else` statements:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 5 > 2:
-     print('5 è infatti maggiore di 2') 
+    print('5 è infatti maggiore di 2')
 else:
-     print('5 non è maggiore di 2')
+    print('5 non è maggiore di 2')
 ```
 
 Quando viene lanciato, mostrerà:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     5 è infatti maggiore di 2
     
 
-Se 2 fosse un numero maggiore di 5, allora andrebbe in esecuzione il secondo comando. Facile, vero? Andiamo a vedere come funziona `elif`:
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 nome = 'Sonja'
 if nome == 'Ola':
-    print('Ciao Ola!')
+    print('Hey Ola!')
 elif nome == 'Sonja':
-    print('Ciao Sonja!')
+    print('Hey Sonja!')
 else:
-    print('Ciao anonimo!')
+    print('Hey anonimo!')
 ```
 
 ed eseguito:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
-    Ciao Sonja!
+    Hey Sonja!
     
 
 Hai visto cosa è successo? `elif` ti consente di aggiungere condizioni supplementari che verranno eseguite se nessuna delle condizioni precedenti viene soddisfatta.
 
 Allo statement iniziale `if` puoi far seguire tutti gli statement `elif` che vuoi. Per esempio:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 volume = 57
 if volume < 20:
-    print("Piuttosto basso.")
+    print("It's kinda quiet.")
 elif 20 <= volume < 40:
-    print("Adatto per musica di sottofondo")
+    print("It's nice for background music")
 elif 40 <= volume < 60:
-    print("Perfetto, posso apprezzare ogni dettaglio")
+    print("Perfect, I can hear all the details")
 elif 60 <= volume < 80:
-    print("Ideale per le feste")
+    print("Nice for parties")
 elif 80 <= volume < 100:
-    print("Un po' altino!")
+    print("A bit loud!")
 else:
-    print("Oddio, le mie orecchie! :(")
+    print("My ears are hurting! :(")
 ```
 
 Python esegue ogni singolo test in sequenza e scrive:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Perfetto, posso apprezzare ogni dettaglio
     
 
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
 ### Indice
 
-Nei tre esercizi precedenti hai imparato:
+In the last few exercises you learned about:
 
-*   come **confrontare le cose** - in Python puoi mettere a confronto le cose usando `>`, `>=`, `==`, `<=`, `<` e gli operatori `e`, `o`
-*   i **Boolean** - una tipologia di oggetto che può avere solo uno di questi due valori: `True` o `False`
-*   come **Salvare file** - archiviare codice nei file in modo da poter eseguire programmi più lunghi.
-*   **if...elif...else** - affermazioni che ti permettono di eseguire codice solo quando vengono incontrate certe condizioni.
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
 
-È ora dell'ultima parte del capitolo!
+E' ora dell'ultima parte del capitolo!
 
 ## Le funzioni personalizzate!
 
-Ti ricordi quelle funzioni che puoi eseguire in Python come `len()`? Beh, buone notizie, ora imparerai a scrivere delle funzioni tutte tue!
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
 
-Una funzione è una sequenza di istruzioni che Python dovrebbe eseguire. Ogni funzione in Python inizia con la parola chiave `def`, viene assegnato un nome e può avere alcuni parametri. Iniziamo con una facile. Sostituisci il codice nel file **python_intro.py** con il seguente:
+Una funzione è una sequenza di istruzioni che Python dovrebbe eseguire. Ogni funzione in Python inizia con la parola chiave `def`, viene assegnato un nome e può avere alcuni parametri. Let's give it a go. Sostituisci il codice nel file **python_intro.py** con il seguente:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def ciao():
@@ -629,12 +860,22 @@ Ti starai chiedendo perché abbiamo scritto il nome della funzione alla fine del
 
 Eseguiamolo e vediamo cosa succede:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Ciao!
     Come stai?
     
 
-È stato facile! Costruiamo la nostra prima funzione con parametri. Useremo l'esempio precedente - una funzione che dice 'ciao' alla persona che lo esegue - aggiungendo il nome:
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def ciao(nome):
@@ -642,6 +883,8 @@ def ciao(nome):
 
 Come puoi vedere, abbiamo dato alla nostra funzione un parametro chiamato `nome`:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def ciao(nome):
     if nome == 'Ola':
@@ -656,45 +899,59 @@ ciao()
 
 Ricorda: La funzione `print` è rientrata di 4 spazi rispetto allo statement `if`. Infatti, la funzione viene eseguita quando la condizione viene soddisfatta. Vediamo ora come funziona:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Traceback (most recent call last):
     File "python_intro.py", line 10, in <module>
-      ciao()
+      hi()
     TypeError: ciao() missing 1 required positional argument: 'nome'
     
 
 Ops, un errore. Fortunatamente, Python ci fornisce un messaggio di errore che ci può servire. Ci dice che la funzione `ciao()` (quella che abbiamo definito) ha un argomento richiesto (chiamato `nome`) e che ci siamo dimenticati di metterlo quando abbiamo chiamato la funzione. Sistemiamolo alla fine del file:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 ciao("Ola")
 ```
 
 Ed eseguiamo di nuovo:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Ciao Ola!
     
 
 E se cambiamo il nome?
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 ciao("Sonja")
 ```
 
-Ed eseguilo:
+E mEttilo in EsEcuzionE:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Ciao Sonja!
     
 
-Ora, cosa pensi che succederà se scrivi un altro nome? (non Ola o Sonja) Provaci e vedi se la tua ipotesi è giusta. Dovrebbe stampare questo:
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
 
     Ciao anonimo!
     
 
-Fantastico, vero? In questo modo non devi ripetere tutto ogni volta che vuoi modificare il nome della persona che la funzione dovrebbe salutare. Ed è esattamente per questo che abbiamo bisogno delle funzioni - non vuoi ripetere il tuo codice!
+Fantastico, vero? In questo modo non devi ripetere tutto ogni volta che vuoi modificare il nome della persona che la funzione dovrebbe salutare. And that's exactly why we need functions – you never want to repeat your code!
 
-Facciamo una cosa più intelligente -- ci sono più di due nomi, e scrivere una condizione per ognuno sarebbe complicato, vero?
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def ciao(nome):
@@ -705,45 +962,57 @@ ciao("Rachel")
 
 Ora chiamiamo il codice:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Ciao Rachel!
     
 
-Congratulazioni! Hai appena imparato a scrivere delle funzioni :)
+Congratulazioni! Hai appena imparato come scrivere funzioni! :)
 
 ## Loop
 
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
 È l'ultima parte. Abbiamo fatto in fretta, vero? :)
 
 I programmatori non amano ripetere ciò che scrivono. La programmazione mira a automatizzare le cose, non vorremo mica salutare ognuno col suo nome manualmente? Ecco un caso in cui i loop ci tornano comodi.
 
 Ti ricordi ancora delle liste? Facciamo una lista di ragazze:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 ragazze = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'Tu']
 ```
 
 Vogliamo salutare tutte loro per nome. Abbiamo la funzione `ciao` per farlo, quindi usiamola in loop:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-for nome in ragazze:
+for name in girls:
 ```
 
-Lo statement `for` si comporta in modo simile allo statement `if`; il codice sottostante deve essere rientrato di quattro spazi.
+L'istruzione ```for``` ha un comportamento simile all'istruzione ```if``` il codice sotto entrambe deve essere indentato di quattro spazi.
 
 Qua c'è l'intero codice che sarà nel file:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def ciao(nome):
-    print('Ciao ' + nome + '!') 
+    print('Ciao ' + nome + '!')
 
-ragazze = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'Tu']
-for nome in ragazze:
-    ciao(nome)
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'Tu']
+for name in girls:
+    ciao(name)
     print('Prossima ragazza')
 ```
 
-E quando lo eseguiamo:
+E quando lo mEttiamo in EsEcuzionE:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Ciao Rachel!
@@ -762,6 +1031,8 @@ Come puoi vedere, tutto quello che metti all'interno di un `for` statement con u
 
 Puoi anche utilizzare `for` su numeri usando la funzione `range`:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 for i in range(1, 6):
     print(i)
@@ -769,6 +1040,8 @@ for i in range(1, 6):
 
 Che stamperà:
 
+{% filename %}command-line{% endfilename %}
+
     1
     2
     3
@@ -778,12 +1051,12 @@ Che stamperà:
 
 `range` è una funzione che crea una lista di numeri che si seguono uno dopo l'altro (questi numeri vengono forniti da te come parametri).
 
-Nota che il secondo di questi due numeri non è incluso nella lista prodotta da Python ( ciò significa che `range(1, 6)` conta da 1 a 5, ma non include il numero 6). Questo perché "range" è mezzo-aperto e con ciò intendiamo che include il primo valore, man non l'ultimo.
+Nota che il secondo di questi due numeri non è incluso nella lista prodotta da Python ( ciò significa che `range(1, 6)` conta da 1 a 5, ma non include il numero 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
 
 ## Indice
 
 È tutto. **Sei grande!** Questo capitolo non era affatto facile, puoi essere orgogliosa di te stessa. Noi siamo fierissimi di te per avercela fatta fino a qui!
 
-Potresti desiderare di fare brevemente qualcos'altro - stiracchiati, fai due passi, riposa gli occhi - prima di continuare con il prossimo capitolo. :)
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
 
-![Cupcake](images/cupcake.png)
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/it/signup_pythonanywhere.md b/it/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/it/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/it/template_extending/README.md b/it/template_extending/README.md
index 7f8c752c6d8..0950030b02d 100644
--- a/it/template_extending/README.md
+++ b/it/template_extending/README.md
@@ -2,9 +2,9 @@
 
 Un'altra cosa bella di Django è l'**estensione del template**. Cosa significa? Significa che puoi usare le stesse parti del tuo HTML per pagine diverse del tuo sito.
 
-Così non hai bisogno di ripetere le stesse informazioni/layout in ogni file. E se vuoi cambiare qualcosa, non devi cambiarlo in ogni templates, ma soltanto una volta!
+Templates help when you want to use the same information or layout in more than one place. Non devi ripeterti in ogni file. And if you want to change something, you don't have to do it in every template, just one!
 
-## Crea un template di base
+## Create a base template
 
 Un template base è il template più semplice. Lo puoi estendere su ogni pagina del tuo sito.
 
@@ -19,6 +19,8 @@ Creiamo un file `base.html` in `blog/templates/blog/`:
 
 Poi aprilo e copia tutto da `post_list.html` e incollalo sul file `base.html`, così:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -55,6 +57,8 @@ Poi aprilo e copia tutto da `post_list.html` e incollalo sul file `base.html`, c
 
 Poi nel `base.html`, rimpiazza tutto il tuo `<body>` (tutto quello che si trova tra `<body>` e `</body>`) con questo:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <body>
     <div class="page-header">
@@ -71,16 +75,20 @@ Poi nel `base.html`, rimpiazza tutto il tuo `<body>` (tutto quello che si trova
 </body>
 ```
 
-Abbiamo praticamente rimpiazzato tutto quello tra `{% for post in posts %}{% endfor %}` con:
+{% raw %}Potresti aver notato che questo sostituisce tutto da `{% for post in posts %}` a `{% endfor %}` con: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% block content %}
 {% endblock %}
 ```
 
-Che cosa significa? Che hai appena creato un `blocco`, ovvero un tag di template che ti permette di inserire l'HTML presente in questo blocco all'interno di altri template che estendono `base.html`. Ti mostreremo come farlo tra un attimo.
+Perchè? Hai appena creato un blocco! Hai appena usato un template tag `{% block %}` per creare un area che che avrà dell'HTML all'interno. That HTML will come from another template that extends this template (`base.html`). Ti mostreremo come farlo tra un attimo.
 
-Ora salvalo, e apri il tuo `blog/templates/blog/post_list.html` di nuovo. Cancella tutto quello che non è all'interno del body e poi cancella anche `<div class="page-header"></div>`, in modo che il file appaia così:
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}Rimuovi tutto quello che c'è prima di `{% for post in posts %}` e dopo `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
@@ -94,13 +102,29 @@ Ora salvalo, e apri il tuo `blog/templates/blog/post_list.html` di nuovo. Cancel
 {% endfor %}
 ```
 
-Ed ora aggiungi questa riga all'inizio del file:
+Vogliamo usare questa parte del nostro template per ogni blocco per i contenuti. Aggiungiamo un tag block in questo file!
 
-```python
-{% extends 'blog/base.html' %}
+{% raw %}Dobbiamo fare in modo che il tuo tag block combaci con quello nel tuo file`base.html`. Dobbiamo anche includere tutto il codice del blocco dei contenuti. Per farlo, metti tutto tra `{% block content %}` e `{% endblock %}`. Come questo:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
 ```
 
-{% raw %}Significa che stiamo estendendo il template `base.html` in `post_list.html`. Rimane solo una cosa da fare: metti tutto (tranne la riga che abbiamo appena aggiunto) tra `{% block content %}` e `{% endblock %}`. Come questo:{% endraw %}
+Un'ultima cosa. Dobbiamo collegare questi due template. È questo che vuol dire estendere i template! Lo faremo aggiungendo un tag extends all'inizio del file. Così:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -118,6 +142,6 @@ Ed ora aggiungi questa riga all'inizio del file:
 {% endblock %}
 ```
 
-È tutto! Controlla se il tuo sito sta ancora funzionando correttamente :)
+È tutto! Controlla se il tuo sito sta ancora funzionando correttamente. :)
 
-> Se hai un errore `TemplateDoesNotExists` che dice che non c'è un file `blog/base.html` e hai `runserver` in esecuzione nella console, prova a fermarlo (premendo Ctrl+C - I tasti Control e C insieme) e riavvialo mettendo in esecuzione il comando `python manage.py runserver`.
\ No newline at end of file
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/it/whats_next/README.md b/it/whats_next/README.md
index bd564cdb653..f526e79cf24 100644
--- a/it/whats_next/README.md
+++ b/it/whats_next/README.md
@@ -1,39 +1,25 @@
 # Quali sono le prospettive?
 
-Complimenti! **Sei veramente incredibile**. Siamo orgogliosi! < 3
+Complimenti! **Sei veramente incredibile**. Siamo orgogliosi! <3
 
 ### Cosa si fa ora?
 
 Prenditi una pausa e rilassati. Hai veramente fatto un passo da gigante.
 
-Dopo di che, assicurati di:
+Dopodichè, assicurati di seguire Django Girls in [ Facebook ](http://facebook.com/djangogirls) o [ Twitter](https://twitter.com/djangogirls) per essere aggiornato.
 
-*   Seguire Django Girls su [Facebook][1] o [Twitter][2] per rimanere aggiornata
+### Mi puoi consigliare ulteriori risorse?
 
- [1]: http://facebook.com/djangogirls
- [2]: https://twitter.com/djangogirls
+Sì! Per prima cosa, vai avanti e prova il nostro altro libro, chiamato[ Django Girls Tutorial: estensioni](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
 
-### Mi puoi consigliare ulteriori risorse?
+Successivamente, puoi provare le risorse elencate di seguito. Tutti sono altamente raccomandati!
 
-Si! Vai avanti e prova il nostro libro dal titolo [Django Girls Tutorial: estensioni][3].
-
- [3]: https://tutorial-extensions.djangogirls.org
-
-Più avanti potrai provare le risorse elencate qui sotto. Sono tutte molto consigliate!
-- [Django - tutorial ufficiale][4]
-- [Tutorial per i nuovi Coder][5]
-- [Corso Code Academy Python][6]
-- [Corso Code Academy HTML & CSS][7]
-- [Tutorial Django Carrots][8]
-- [Il libro "Learn Python The Hard Way"][9]
-- [Lezioni video "Inizia con Django"][10]
-- [Il libro "Two Scoops of Django: Best Practices for Django 1.8 book"][11]
-
- [4]: https://docs.djangoproject.com/en/1.8/intro/tutorial01/
- [5]: http://newcoder.io/tutorials/
- [6]: https://www.codecademy.com/en/tracks/python
- [7]: https://www.codecademy.com/tracks/web
- [8]: https://github.com/ggcarrots/django-carrots
- [9]: http://learnpythonthehardway.org/book/
- [10]: http://www.gettingstartedwithdjango.com/
- [11]: https://twoscoopspress.com/products/two-scoops-of-django-1-8
+- [Il tutorial ufficiale di Django's](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [Nuovi tutorial su Coder](http://newcoder.io/tutorials/)
+- [Il corso di Python su Code Academy](https://www.codecademy.com/en/tracks/python)
+- [Code Accademia HTML& CSS corso](https://www.codecademy.com/tracks/web)
+- [Tutorial di carote Django](https://github.com/ggcarrots/django-carrots)
+- [Impara il libro di Python The Hard Way](http://learnpythonthehardway.org/book/)
+- [A cominciare dalle lezione video di Django](http://www.gettingstartedwithdjango.com/)
+- [Due pillole di Django 1.11: Le migliore pratiche per il libro di Django web Framework](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [ Ciao web App: Impara a costruire un'App web](https://hellowebapp.com/) - Puoi anche richiadere una licenza di eBook gratuita contattando l'autore Tracy Osborn all'indirizzo<tracy@limedaring.com>
\ No newline at end of file
diff --git a/ja-JP/GLOSSARY.md b/ja-JP/GLOSSARY.md
new file mode 100644
index 00000000000..591c8c621e7
--- /dev/null
+++ b/ja-JP/GLOSSARY.md
@@ -0,0 +1,3 @@
+# コードエディタ
+
+コードエディタはコードを保存して後から戻ってこれるようにできるアプリケーションです。 [コードエディタの章](./code_editor/README.md)で、どこから入手できるか知ることができます。
\ No newline at end of file
diff --git a/ja-JP/README.md b/ja-JP/README.md
new file mode 100644
index 00000000000..7da60a87851
--- /dev/null
+++ b/ja-JP/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/deed.ja
+
+## ウェルカム！
+
+Django Girlsのチュートリアルにようこそ！ ここでお会いできてうれしいです :) このチュートリアルでは、ウェブテクノロジーの内側を見るたびにお連れします。私たちが知っているように、ウェブを動かすのに必要な技術を垣間見ることができるでしょう。
+
+全てが知らないことのように、これは冒険のようになるでしょう。けれど心配しないでください。あなたはすでに勇気をだしてここにいるのですから。上手くいくでしょう :)
+
+## はじめに
+
+世界のますます色々なところに自分が（まだ）知らないテクノロジーが使われていると感じたことはありませんか？ ウェブサイトはどうやって作るのだろうと興味をもちつつ、先延ばしにしていませんか？ ソフトウェアの世界は複雑すぎて一人でなにかに取り組むことはできないと考えたことはありませんか？
+
+そんなあなたに朗報です！プログラミングはそれほど難しくありませんよ。楽しみかたをお教えします！！
+
+このチュートリアルは、魔法のようにあなたをプログラマーに変身させるものではありません。 上手くなりたかったら、何ヶ月あるいは何年もの勉強と練習を積まなければいけません。 しかし、プログラミングやウェブサイトを作成することは、あなたが思っているほど複雑ではないことを、このチュートリアルをとおして示したいと思います。 テクノロジーをコワイと感じないように、できるだけ細かく説明していきますね。
+
+あなたがテクノロジーやプログラミングを楽しんでくれると嬉しいです！！
+
+## チュートリアルでは何を知ることができる？
+
+このチュートリアルを終わらせれば、実際に動作する、自分の小さなウェブアプリを1つ動かせるようになります。私たちは、アプリをインターネット上で動かす方法を教えます。インターネット上で動くようになれば、あなたが作ったアプリを世界中の誰でも見られるようになります！
+
+このようなサイトができあがります！:
+
+![図 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のワークショップに参加することはすばらしいことです。でも、いつも参加できるとは限らないですよね。 でしたら、ご自宅でこのチュートリアルに取り組むことをおすすめします。 ご自宅で取り組まれる方向けに、チュートリアルを一人で進めやすくする動画の準備を進めています。 動画の準備は進行中ですが、YouTubeチャンネル [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) ですぐにますます多くのことがカバーされるでしょう。
+
+動画がすでに準備された章には、動画へのリンクがあります。
+
+## コントリビューションについて
+
+このチュートリアルは、[DjangoGirls](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/) にない時は、[新しい issue を立て](https://github.com/DjangoGirls/tutorial/issues/new)て、追加したい言語を私たちに教えてください。
\ No newline at end of file
diff --git a/ja-JP/SUMMARY.md b/ja-JP/SUMMARY.md
new file mode 100644
index 00000000000..8f99cd0d28f
--- /dev/null
+++ b/ja-JP/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-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [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_start_project/README.md)
+* [Djangoモデル](django_models/README.md)
+* [ログインページを作ろう（Django admin）](django_admin/README.md)
+* [デプロイ！](deploy/README.md)
+* [Django URL](django_urls/README.md)
+* [Djangoビュー](django_views/README.md)
+* [HTML 入門](html/README.md)
+* [Django ORM（クエリセット）](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)
\ No newline at end of file
diff --git a/ja-JP/chromebook_setup/README.md b/ja-JP/chromebook_setup/README.md
new file mode 100644
index 00000000000..abcc0c7ed87
--- /dev/null
+++ b/ja-JP/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook のセットアップ
+
+> **注意** 既に</a>インストール手順</1>を実行しているのなら再び行う必要はありません。スキップして[Python入門](../python_introduction/README.md)に進んでください。 
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ja-JP/chromebook_setup/instructions.md b/ja-JP/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..480faa36205
--- /dev/null
+++ b/ja-JP/chromebook_setup/instructions.md
@@ -0,0 +1,159 @@
+Chromebookを使わない場合は、このセクションを飛ばして、[Pythonのインストール](http://tutorial.djangogirls.org/en/installation/#install-python) に進んでください。 もし利用している場合は、普通のインストールの作業とは少し異なります。 インストール手順の残りの部分は無視できます。
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+クラウドIDEはコードエディタと、インターネットにつながって動作し、ソフトウェアをインストールしたり、書いたり、実行したりできるコンピュータへのアクセスを提供するツールです。 チュートリアルを通して、クラウドIDEはまるであなたの*ローカルマシン*のように動作するでしょう。 みんながOS XやUbuntuやWindowsでやるのと同じようにターミナルからコマンドを実行できますが、そのターミナルはクラウドIDEが準備したどこかのコンピュータに接続されています。 Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). クラウドIDEのうちどれかを選んで、指示に従ってください。
+
+#### PaizaCloud Cloud IDE
+
+1. [PaizaCloud Cloud IDE](https://paiza.cloud/) へ移動します。
+2. アカウントを登録します。
+3. *新規サーバ作成* をクリックして、Djangoを選択してください。
+4. （ウィンドウの左側にある）「ターミナル」をクリックします。
+
+左側にサイドバーといくつかボタンのある画面が見えていると思います。 「ターミナル」ボタンをクリックして、下記のようなプロンプトが表示されたターミナルウィンドウを開いてください：
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+これでPaizaCloud Cloud IDEのターミナルは準備できました。 ウィンドウを大きくしたいときは、サイズを変えたり最大化したりできますよ。
+
+#### AWS Cloud9
+
+現在、Cloud 9 はAWSのアカウント作成とクレジットカード情報の登録が必須になっています。
+
+1. [Chrome ウェブストア](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)から、Cloud 9 をインストールしてください。
+2. [c9.io](https://c9.io)に行って、*AWS Cloud9をはじめる* をクリックしてください。
+3. AWSアカウントを作成してください。（クレジットカード情報の登録が必要ですが、このチュートリアルは無料利用枠で進めることができます。）
+4. AWSのダッシュボードを開き、検索ボックスで *Cloud9* と入力し選択してください。
+5. Cloud9のダッシュボードで、*Create environment (環境の作成)* を選択します。
+6. 名前は *django-girls* としておきましょう。
+7. ”Configure settings (設定の構成)”のステップでは、”Environment Type (環境タイプ)”に *Create a new instance for environment (EC2) (新しいインスタンスを作成する (EC2))* を、”Instance type (インスタンスタイプ)”に *t2.micro* を選択します（"Free-tier eligible (無料利用枠で利用できる)" と書かれているはずです）。 ”Cost-saving setting (コスト削減の設定)”はデフォルトの選択のままにします。その他の設定もデフォルトにしておきましょう。
+8. *Next step (次のステップ)* を選択します。
+9. *Create environment (環境の作成)* を選択します。
+
+サイドバー、文章が書かれた大きなメインウィンドウ、そして下部にはこのような小さなウィンドウが表示されています：
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+この下の部分が、あなたのターミナルです。このターミナルから、遠くにあるCloud 9のコンピュータに指示を送ることができます。ウィンドウのサイズを変更して少し大きくすることもできます。
+
+#### Glitch.com Cloud IDE
+
+1. Glitch.com<0>に行く</li> 
+    
+    - アカウントをサインアップ(https://glitch.com/signup)するか、GitHubアカウントを持っている場合はそれを使用します。(以下のGitHubの手順を参照してください)
+    - *新規プロジェクト* をクリックし、 *hello-webpage* を選択します。
+    - ツールドロップダウンリスト(ウィンドウの左下にある)をクリックします。 次に、ターミナルのボタンを以下のようなプロンプトとともにターミナルを開くために、ターミナルボタンをクリックします。</ol> 
+    
+    {% filename %}Terminal{% endfilename %}
+    
+        app@name-of-your-glitch-project:~
+        
+    
+    When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+    
+    {% 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
+    ```
+    
+    Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+    
+    {% filename %}Terminal{% endfilename %}
+    
+        django-admin.py startproject mysite .
+        refresh
+        
+    
+    In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+    
+    {% 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,
+            },
+        },
+    }
+    ```
+    
+    This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+    
+    The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+    
+    ### 仮想環境
+    
+    A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+    
+    Run:
+    
+    {% filename %}Cloud 9{% endfilename %}
+    
+        mkdir djangogirls
+        cd djangogirls
+        python3 -m venv myvenv
+        source myvenv/bin/activate
+        pip install django~={{ book.django_version }}
+        
+    
+    (note that on the last line we use a tilde followed by an equal sign: `~=`).
+    
+    ### GitHub
+    
+    Make a [GitHub](https://github.com) account.
+    
+    ### PythonAnywhere
+    
+    The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+    
+    This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+    
+    Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ja-JP/code_editor/README.md b/ja-JP/code_editor/README.md
new file mode 100644
index 00000000000..cfae4e1e399
--- /dev/null
+++ b/ja-JP/code_editor/README.md
@@ -0,0 +1,11 @@
+# コードエディタ
+
+> 家で１人でこのチャプターに挑戦している方へ：このチャプターは、動画（英語）もあるので参考にしてください。 [Your new friend: Command Line](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s)
+
+まさにこれから、はじめてのコードを書いていきます。コードエディタをダウンロードしましょう！
+
+> **補足：** Chromebookを使っている方は、このチャプターは飛ばして、 [Chromebookのセットアップ](../chromebook_setup/README.md) の説明に従ってください。 あなたが選んだクラウドIDE（PaizaCloud Cloud IDE もしくは AWS Cloud9）にはコードエディタが含まれています。IDEのファイルメニューからファイルを開くと、自動的にエディタが使用できます。
+> 
+> **注意** [インストールの章](../installation/README.md)で既にコードエディターのダウウンロードを済ませてしまっているかもしれません。もしそうなら、スキップして次の章に進んでください！
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ja-JP/code_editor/instructions.md b/ja-JP/code_editor/instructions.md
new file mode 100644
index 00000000000..5fa3e1dbd6f
--- /dev/null
+++ b/ja-JP/code_editor/instructions.md
@@ -0,0 +1,37 @@
+本当にたくさんのエディタがありますが、どれを使うかは、結局は、ほとんど個人の好みの問題です。 ほとんどのPythonプログラマは、PyCharmなど、複雑ですが非常に強力なIDE（統合開発環境）というものを使っています。 しかし、初心者にとってはIDEはそれほど適していないかもしれないので、同じくらい強力で、もっとシンプルなものをオススメします。
+
+オススメのエディタは下記に挙げますが、気軽にコーチに質問して好みや特徴ををきいてみてください。
+
+## Visual Studio Code
+
+Visual Studio Codeは、マイクロソフトがWindowsとLinuxとmacOS向けに開発したソースコードエディタです。 デバッグのサポート、組み込まれたGit操作、シンタックスハイライト、かしこいコード補完、スニペット、リファクタリングなど多くの機能があります。
+
+[ダウンロード](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit は、オープンソースの無料エディタで、全てのOSで利用可能です。
+
+[ダウンロード](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text はとても人気のあるエディタで、無料の試用期間があります。全てのOSに対応しています。　
+
+[ダウンロード](https://www.sublimetext.com/3)
+
+## Atom
+
+Atomも人気のあるエディタで、無料でオープンソース、そしてWindows、OS X、Linuxで利用可能です。Atomは[GitHub](https://github.com/)が開発しています。
+
+[ダウンロード](https://atom.io/)
+
+## なんでコードエディタをインストールするの？
+
+なぜWordやNotepadのようなものを使わず、特別なコードエディタをインストールする必要があるのかな、と思うかもしれません。
+
+まずひとつ目の理由として、コードは**プレーンテキスト**という、何の装飾もない文字列でないといけません。問題は、WordやTexteditのようなプログラムが生成するのは、実は、プレーンテキストではないということなんです。WordやTexteditは、[RTF（リッチテキストフォーマット）](https://en.wikipedia.org/wiki/Rich_Text_Format)などのような独自の形式を使って、リッチテキスト（フォントや書式を持った文字列）を生成します。
+
+2つ目の理由は、コードエディタは、コードを編集することに特化しているので、コードを意味によって色づけして強調したり、引用符を自動的に閉じたりするような、便利な機能があります。
+
+あとで使ってみて、こういった機能が全てわかるようになります。すぐに、信頼できる使い慣れたコードエディタが、お気に入りのツールになると思いますよ^^
\ No newline at end of file
diff --git a/ja-JP/css/README.md b/ja-JP/css/README.md
new file mode 100644
index 00000000000..89d701423a6
--- /dev/null
+++ b/ja-JP/css/README.md
@@ -0,0 +1,330 @@
+# CSSでカワイくしよう!
+
+ブログは作ったものの、まだなんかダサいですよね。かわいくしましょう！　そのためにはCSSを使います。
+
+## CSSとは？
+
+Cascading Style Sheets (CSS)とは、HTMLなどのマークアップ言語で書かれたWebサイトの見た目や書式を記述するための言語です。私達のWebページをメイクアップするものとして使います。
+
+でも、またゼロから作りたくないですよね。プログラマーたちがすでに作って無料で公開しているツールを使いましょう。わざわざイチから作り直す必要はないですからね。
+
+## Bootstrapを使いましょう！
+
+Bootstrap は美しいWebサイトを開発するためのHTMLとCSSのフレームワークとしてとても有名です: http://getbootstrap.com/
+
+これは、もともとTwitterのプログラマーが作成したもので、今は、世界中の有志のボランティアで開発されています。
+
+## Bootstrapのインストール
+
+Bootstrap をインストールするため、`.html` ファイル (blog/templates/blog/post_list.html) をコードエディタで開き `<head>` の中にこれを追加しましょう:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+これは、あなたのプロジェクトにファイルを追加しているわけではありません。インターネット上にあるファイルを指しているだけです。では、Webサイトを開いてページを再読み込みしてください。
+
+![図 14.1](images/bootstrap1.png)
+
+これだけでずいぶん見た目が良くなりましたね！
+
+## Djangoの静的ファイル
+
+最後に、**静的ファイル**と呼ばれるものを詳しく見ていきましょう。 静的ファイルとは、CSSファイルや画像ファイルといった、動的な変更が発生しないファイルのことです。 そのため、これらのファイルはリクエストに依存せず、どのユーザに対しても中身は同じになります。
+
+### 静的ファイルはプロジェクトのどこに置けばいいの？
+
+Djangoは、ビルトインの "admin" アプリにより、静的ファイルをどこで探せばいいのかわかっています。私たちがやることは、`blog` アプリのための静的ファイルを追加することだけです。
+
+そのために、blogアプリの中に `static` というフォルダを作ります。
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Djangoは、全てのアプリのフォルダ内の "static" と名づけられた全てのフォルダを自動的に探して、その中身を静的ファイルとして使えるようにします。
+
+## 最初のCSSファイル！
+
+CSSファイルを作って、Webサイトにあなたのスタイルを設定していきましょう。 `static` ディレクトリの中に `css` というディレクトリを作成しましょう。 そして、その `css` ディレクトリの中に `blog.css` という新規ファイルを作ります。 準備OK？
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+ついにCSSを書くときが来ました！　コードエディタで `blog/static/css/blog.css` ファイルを開きましょう。
+
+ここではCSSのカスタマイズや学習方法については詳しく説明しません。さらに知りたい場合は、このページの最後に無料のCSSの学習コースを紹介していますので、そちらを参考にしてください。
+
+ただ、せめて少しはここでやってみましょう。 ヘッダーの色を変えてみるのもいいかもしれませんね。 色を理解するために、コンピュータは特殊なコードを使います。 コードは、`#` で始まり、6種類のアルファベット（A-F）や数字（0-9）が続きます。 たとえば、青色のコードは `#0000FF` です。 カラーコードのサンプルはこのサイト http://www.colorpicker.com/ で確認できます。 `red` や `green` といった[定義済みの色](http://www.w3schools.com/colors/colors_names.asp)を利用することもできます.
+
+`blog/static/css/blog.css` ファイルに、次のコードを追加しましょう。
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` はCSSセレクタと呼ばれるものです。 これは、`h1`要素内の`a`要素にスタイルを適用していることを意味します。 `h2 a`セレクタは、`h2`要素に対して同じことを行います。 よって `<h1><a href="">link</a></h1>`となっているとき、 `h1 a` スタイルが適用されます。 この場合、その要素を `#C25100` に、つまり濃いオレンジ色にしようとしています。 あるいは、あなたの好きな色を設定することができますが、それが白い背景に対して良いコントラストを持つことを確認しましょう！
+
+CSSファイルには、HTMLファイルの各要素のスタイルを指定していきます。 まずは要素名でもって、その要素を識別します。 HTMLのタグ名は覚えがあるでしょう。 例えば `a`, `h1`, `body` などが要素名の例です。 また、`class` 属性や、`id` 属性によって要素を識別することができます。 classやidは、あなたが自分で要素につけることができる名前です。 classは要素のグループを定義して、idは特定の要素を指定します。 For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+CSSセレクタについては[CSS Selectors in w3schools](http://www.w3schools.com/cssref/css_selectors.asp)を見てください。
+
+さて、CSSを追加したことをHTMLテンプレートに教えないといけません。`blog/templates/blog/post_list.html` を開いて、先頭にこの行を追加しましょう：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+これで、このテンプレートに静的ファイルを読み込むことができました^^。そして、`<head>` と `</head>` の中にあるBootstrap CSSファイルのリンクの下に、この行を追加しましょう：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+ブラウザは上から書いた順番でファイルを読み込むので、記述する箇所はよく確かめる必要があります。 順番が逆になると、私たちが書いたファイルがBootstrapのファイルに上書きされてしまうかもしれません。 これで、テンプレートにCSSファイルがある場所を教えました。
+
+ファイルは次のようになっているはずです：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+保存して、サイトを更新してください。
+
+![図 14.2](images/color2.png)
+
+素晴らしいですね！あとは、左サイドの余白幅を少し広げて、余裕を持たせてあげたらもっと良くなると思いませんか？やってみましょう！
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+これをCSSに追加して、保存してください。どのように変化したか、さぁ見てみましょう！
+
+![図 14.3](images/margin2.png)
+
+ヘッダーのフォントを変えてみませんか？ファイル `blog/templates/blog/post_list.html` の `<head>` タグの中に次の一行を貼り付けましょう。
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+まずは、このリンクが `blog/static/css/blog.css` より前にあることを確かめましょう。この１行は *Lobster* というフォントをGoogle Fonts (https://www.google.com/fonts) から読み込むということを意味しています。
+
+`blog/static/css/blog.css` ファイルの中の、 `h1 a` という宣言ブロックを見つけてください（コードは `{` と `}` で囲まれています）。 そして、そのカッコの中に `font-family: 'Lobster';` と１行追加して、webサイトを更新してみましょう：
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![図 14.3](images/font.png)
+
+素晴らしいです！
+
+前述のように、CSSはクラスの概念を持っています。 それにより、HTMLコードの一部に名前を指定し、他の部分に影響を与えずにこの部分にだけスタイルを適用することができます。 なんて便利なんでしょう！ 例えば、２つのdiv要素（ヘッダーと記事など）があったとして、これらのそれぞれに違うスタイルを適用することができます。 クラスを利用すると、違う見た目にできるのです。
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+そして、さまざまなセレクタに宣言ブロックを追加します。 `.` で始まるセレクタはクラスに関連します。 Web上にはCSSに関する多くのチュートリアルがあり、それらは以下に示すコードを理解する手助けになるはずです。 今のところは、`blog/static/css/blog.css` のファイルに以下の内容をコピー＆ペーストしましょう：
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+では、投稿を表示しているHTMLコードをクラス宣言で囲みましょう。 `blog/templates/blog/post_list.html` 中のこの部分を
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+これで置き換えて下さい：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+ファイルを保存してWebサイトを更新してみましょう。
+
+![図 14.4](images/final.png)
+
+やったー！ ほら凄いでしょ？ 貼り付けたコードを見て、HTMLにクラスを追加した場所やそのクラスがCSSの中で使われている場所を探してみましょう。 日付の色をターコイズブルーにするには、どこを変更すればいいでしょうか？
+
+CSSをいじって表示が壊れることを恐れないで、どんどん変更を加えてみてください。 CSSで遊んでみることで、何がどうなっているかを理解できてきます。 たとえ何かを壊してしまっても、心配しないで！すぐに元に戻すことができます。
+
+[freeCodeCamp](https://learn.freecodecamp.org/)で無料のオンラインコース「Basic HTML & HTML5」と「Basic CSS」を受講することをおすすめします。 これらで学ぶと、HTMLとCSSであなたのWebサイトをよりカワイくできるでしょう。
+
+さて、次の章にいく準備はできましたか？^皿^
\ No newline at end of file
diff --git a/ja-JP/deploy/README.md b/ja-JP/deploy/README.md
new file mode 100644
index 00000000000..941e844f931
--- /dev/null
+++ b/ja-JP/deploy/README.md
@@ -0,0 +1,246 @@
+# デプロイ！
+
+> **補足** このチャプターはちょっと難しいことが沢山書かれています。 頑張って最後までやりきってください。デプロイはウェブサイトを開発するプロセスの上で、とても重要な部分ですが、つまずきやすいポイントも多く含まれています。 チュートリアルの途中にこのチャプターを入れています。そういったつまずきやすい箇所はメンターに質問して、あなたが作っているウェブサイトをオンラインでみれるようにしてください。 言い換えれば、もし時間切れでワークショップ内でチュートリアルを終わらせることができなかったとしても、この後のチュートリアルはきっと自分で終わらせることができるでしょう。
+
+今のところ、あなたが作ったサイトは、あなたのコンピューターでしかみることができません。 ここでは、デプロイの方法を学びましょう！ デプロイとは、あなたが作っているアプリケーションをインターネットで公開することです。あなた以外の人もウェブサイトを見ることができるようになりますよ. :)
+
+これまでに学んだとおり、ウェブサイトはサーバーに置かれています。 インターネットで利用できる多くのサーバー プロバイダーがありますが、私達は [PythonAnywhere](https://www.pythonanywhere.com/) を使用します。 PythonAnywhere は、多くの人がアクセスするものではない小さいアプリケーションを無料で公開できますので今のあなたには最適でしょう。
+
+使用するその他の外部サービスは [GitHub](https://www.github.com)、コードのホスティング サービスです。 他にも色々ありますが、ほとんどのプログラマはGitHubのアカウントを持っています。そしてあなたも今そうなります。
+
+これら3つの場所が重要になります。 ローカルコンピューターは、開発およびテストを行う場所になります。 変更に満足したら、GitHub上にプログラムのコピーを配置します。 あなたのウェブサイトはPythonAnywhereで公開され、GitHub からコードの新しいコピーを取得することによって更新されます。
+
+# Git
+
+> **注意** もしすでに[インストール手順](../installation/README.md)を行っていた場合は、このステップを再び行う必要はありません。次のステップにスキップして Git リポジトリを作り始めてください。
+
+{% include "/deploy/install_git.md" %}
+
+## Gitリポジトリを始める
+
+Gitはコードリポジトリ（または略して「リポジトリ」）というものの中に置かれる特定のファイルへの変更を追跡します。 私たちのプロジェクトを開始しましょう。 あなたのコンソールを開き、`djangogirls` ディレクトリでこれらのコマンドを実行します。
+
+> **備考：**リポジトリを初期化する前に `pwd` (OSX/Linux) または `cd` (Windows) コマンドで現在の作業ディレクトリを確認してください。 `djangogirls` フォルダー内にいる必要があります。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+gitリポジトリを初期化することは、プロジェクトごとに1回だけ行う必要があります（ユーザー名と電子メールをもう一度入力する必要はありません）。
+
+Git はこのディレクトリ内のすべてのファイルとフォルダの変更を追跡しますが、無視してほしいいくつかのファイルがあります。 ベースディレクトリ内で `.gitignore` という名前のファイルを作成することによってこれを行います。 あなたのエディターを開き、次の内容で新しいファイルを作成します。
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+これを "djangogirls" フォルダ内に `.gitignore` という名前で保存します。
+
+> **備考：**ファイル名の先頭のドットは重要です! もしそのファイルを作るのが難しいなら、（Macをお使いの方はFinderからドット（ . ）で始まるファイルを作れません。）そういう時はエディタでSave Asから作成すれば問題ありません。 `.txt`や `.py`などの拡張子をファイル名に入れないように気をつけてください。 ファイル名が`.gitignore`でないとGitに認識されません。 LinuxとMacOSは、（`.gitignore` のように） `.<code>で始まる名前のファイルを隠しファイルとして扱います。通常の<code>ls`コマンドでは、これらのファイルは表示されません。 `.gitignore`fileを見つけるために、代わりに`ls -a`を使います。
+> 
+> **備考：** `.gitignore`ファイルで指定したファイルの1つが`db.sqlite3`です。 そのファイルはローカルデータベースで、すべてのユーザーと投稿が保存されます。 私達は標準的なウェブプログラミングの慣習に従います。つまり、ローカルのテストサイトとPythonAnywhere上の本番のウェブサイトでデータベースを分けるということです。 PythonAnywhereのデータベースは開発用のマシンと同じようにSQLiteにすることができますが、通常はMySQLというSQLiteよりもたくさんのサイト訪問者に対処できるデータベースを使用します。 どちらの方法でも、GitHubのコードのコピーではSQLiteデータベースを無視することで、これまでに作成したすべての投稿と管理者はそのままローカルで利用できますが、本番環境（ブログを公開するPythonAnywhereのことです）ではそれらを再び作成する必要があります。 ローカルデータベースは本当のブログ投稿をブログから削除してしまうことを心配せずに、さまざまなことをテストできるよい遊び場として考えるといいでしょう。
+
+`git add` コマンドを実行する前や、どのような変更を加えたか定かでない時は、 `git status` コマンドを使用する事をおすすめします。 これは間違ったファイルを追加またはコミットなど思いもかけない事を止めるために役立ちます。 `git status` コマンドは、あらゆる追跡されていない/変更されている/ステージされている（untracked/modifed/staged）ファイルや、ブランチの状態などさまざまな情報を返します。 出力は次のようになります。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+最後に、変更内容を保存します。コンソールに移動し、これらのコマンドを実行します。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## GitHubにコードをプッシュする
+
+[GitHub.com](https://www.github.com)にアクセスし、Sign upをクリックして無料の新規アカウントを作成してください。 （ワークショップの前にすでに作成していたら、それは素晴らしいです!） あなたのパスワードを忘れないようにしてください（使っていたら、パスワードマネージャーに入れておいてください）
+
+そして、新しいリポジトリに "my-first-blog"の名前で新しいリポジトリを作成します。 "READMEで初期化する"チェックボックスをオフのままにし、.gitignoreオプションを空白にして（手動で行っています）、ライセンスをNoneのままにしておきます。
+
+![](images/new_github_repo.png)
+
+> **注** `my-first-blog`という名前は重要です。何か他のものを選択することもできますが、以下の手順では何度も繰り返す必要があります。他の名前を選択した場合は、 毎回それを置き換えてください。 できれば、`my-first-blog` の名前にしておきましょう。
+
+次の画面では、リポジトリをクローンするためのURLが表示されます。これはこの後のコマンドで利用します。
+
+![](images/github_get_repo_url_screenshot.png)
+
+そして自分のコンピューター上のGitリポジトリをGitHub上のGitリポジトリに結びつけてあげる必要があります。
+
+コンソールに次のように入力します（`<your-github-username>`をGitHubアカウントの作成時に入力したユーザー名に置き換えます。山カッコ&lt;&gt;を残さないでください。このURLはさっき見たクローンURLと一致する必要があります）。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+GitHubにプッシュするとき、GitHubのユーザー名とパスワードを聞かれます（コマンドライン上かポップアップウィンドウにて）。認証情報を入力したらこんな風に表示されます。
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    
+    To https://github.com/ola/my-first-blog.git
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+あなたのコードは今GitHub上にあります。 見に行きましょう！ [ Django ](https://github.com/django/django)や[ Django Girls Tutorial ](https://github.com/DjangoGirls/tutorial)、その他たくさんの素晴らしいオープンソースソフトウェアプロジェクトもGitHubでコードをホストしています。 :)
+
+# PythonAnywhereでブログを設定する
+
+## PythonAnywhere アカウントにサインアップする
+
+> **備考：**あなたがすでにPythonAnywhereのアカウントを以前に作成しインストールの手順をふんでいたら、再びそれを行う必要はありません。
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## PythonAnywhere でサイトを設定する
+
+ロゴをクリックしてメインの[PythonAnywhere Dashboard](https://www.pythonanywhere.com/)に戻り、「Bash」コンソールを起動するボタンをクリックします。これはPythonAnywhereバージョンのコマンドラインで、ちょうどあなたのコンピューターのコマンドラインと同じようなものです。
+
+![PythonAnywhereのウェブインターフェースの「New Console」、「bash」ボタン](images/pythonanywhere_bash_console.png)
+
+> **備考：**PythonAnywhere は Linuxベースなので、Windowsを使っている場合は、コンソールがあなたのものと少し違って見えるでしょう。
+
+PythonAnywhereにWebアプリケーションをデプロイするには、コードをGitHubからプルし、PythonAnywhereがそれを認識してWebアプリケーションのサーバを動かし始めるように設定する必要があります。 それを手動で行う方法もありますが、PythonAnywhereはそれをすべて行うヘルパーツールを提供しています。 まず、インストールしてみましょう。
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+`Collecting pythonanywhere` のようなメッセージがいくつか出力され、最終的に`Successfully installed (...) pythonanywhere- (...)`という行で終わると思います。
+
+GitHub からアプリを自動的に構成するためのヘルパーを実行します。 PythonAnywhereのコンソールに次のように入力します（GitHubからクローンするときのURLと一致するように、`<your-github-username>`の代わりにご自身のGitHubユーザー名を使用することを忘れないでください）：
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+実行しているところを見れば、何をしているのかわかるでしょう。
+
+- GitHubからコードをダウンロードする
+- ちょうどあなたのPC上でやったように、PythonAnywhere上に仮想環境 を作成する
+- 一部のデプロイメント設定で設定ファイルを更新する
+- `manage.py migrate`コマンドを使ってPythonAnywhere上のデータベースをセットアップする
+- 静的ファイルの設定（これについては後で学習します）
+- APIを通じてPythonAnywhereがあなたのWebアプリケーションを提供するように設定する
+
+PythonAnywhereではこれらすべてのステップは自動化されていますが、他のサーバープロバイダーでは同じ手順を自分で実行しなければなりません。
+
+今注目すべき重要な点は、PythonAnywhere上のデータベースが、自分のPC上のデータベースとはまったく別物であることです。つまり、異なる投稿と管理者アカウントを持つことができます。 その結果、自分のコンピュータで行ったように、`createsuperuser`で管理者アカウントを初期化する必要があります。 PythonAnywhereがあなたの代わりに仮想環境を自動的に起動したので、あなたがする必要があるのは以下の通りです：
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+管理者の詳細を入力します。 PythonAnywhere上のパスワードをより安全にしたい場合を除き、混乱を避けるために自分のコンピュータで使用しているのと同じものを使用することをお勧めします。
+
+PythonAnywhereのコードを`ls`を使って見てみることもできます：
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+また、Filesページに移動し、PythonAnywhereに組み込まれているファイルブラウザを使用して閲覧することもできます。 (ConsoleページからPythonAnywhereの他のページには、右上のメニューボタンからいけます。 一度いずれかのページに移動したら、他ページへのリンクは上部にあります。)
+
+## 動いています！
+
+あなたのサイトは今、インターネット上で動いているはずです。PythonAnywhereの Webページをクリックしてリンクを取得してください。あなたは誰とでもこのリンクを共有することができます。
+
+> **注** これは初心者向けのチュートリアルです。このサイトをデプロイする際にはセキュリティの観点からは理想的ではない、いくつかのショートカットをしました。 もしこのプロジェクトを利用すると決めたり、新しいプロジェクトを開始する場合は、あなたのサイトを安全にするいくつかのヒントについて、[Djangoデプロイチェックリスト](https://docs.djangoproject.com/ja/2.2/howto/deployment/checklist/)を注意深く読んでください。
+
+## デバッギングのヒント
+
+`pa_autoconfigure_django.py`スクリプトの実行中にエラーが表示された場合は、次のような原因が考えられます。
+
+- PythonAnywhere APIトークンの作成を忘れている
+- あなたのGitHubのURLを間違えている
+- *Could not find your settings.py*というエラーが表示された場合は、おそらくGitにすべてのファイルを追加できていなかったか、 GitHubにうまくプッシュできていなかった。 この場合はGitセクションをもう一度見てください
+- PythonAnywhereのアカウントを以前に作成していてcollectstaticでエラーが起きたとしたら、あなたのアカウントで古いバージョンのSQLite（例えば、3.8.2）を使っている可能性があります。 その場合、新しいアカウントを作成して、上記のPythonAnywhereのセクションに記載しているコマンドを実行してください。
+
+サイトにアクセスしようとするとエラーが表示された場合、最初にデバッグ情報を探す場所は**エラーログ**です。 PythonAnywhereの[ Webページ](https://www.pythonanywhere.com/web_app_setup/)には、エラーログへのリンクがあります。 そこにエラーメッセージがあるかどうかを確認してください。 最新のものは一番下にあります。
+
+[ PythonAnywhereヘルプサイトの一般的なデバッグのヒント](http://help.pythonanywhere.com/pages/DebuggingImportError)もあります。
+
+つまづいた時は、コーチに助けを求めましょう。
+
+# あなたのサイトをチェック！
+
+サイトのデフォルトページでは、ローカルコンピュータと同じように「It worked！」と表示されます。 URLの最後に`/admin/`を追加すると、管理サイトに移動します。 ユーザー名とパスワードでログインしたら、Postsへのリンクからサーバーに新規投稿を追加できることがわかるでしょう。ローカルのテスト用データベースの投稿は本番環境のブログに送られていないことも忘れないてくださいね。
+
+いくつかの投稿を作成したら、ローカル環境（PythonAnywhereではなく）に戻ることができます。 ここから、変更を加えるためにはあなたのローカル環境で作業する必要があります。 これがWeb開発の一般的なワークフローです。ローカルで変更し、それらの変更をGitHubにプッシュし、それからその変更を公開しているWebサーバーにプルしてきます。 これにより、公開しているWebサイトを壊すことなく作業したり試したりできます。 とってもクールでしょ？
+
+自分を*すっごく*褒めてあげてください！ サーバーのデプロイはWeb開発の最も難しい部分の1つで、ちゃんと動くようになるまで数日かかることもよくあります。 しかし、あなたは実際のインターネット上で、あなたのサイトを動かす事ができました！
\ No newline at end of file
diff --git a/ja-JP/deploy/install_git.md b/ja-JP/deploy/install_git.md
new file mode 100644
index 00000000000..ecef0a598ca
--- /dev/null
+++ b/ja-JP/deploy/install_git.md
@@ -0,0 +1,52 @@
+Gitはたくさんのプログラマが利用する「バージョン管理システム」です。 このソフトウェアは、特定のバージョンを後で呼び出すことができるように、時間の経過とともにファイルへの変更を追跡することができます。 ワードプロセッサープログラム (例えば、Microsoft WordやLibreOffice Writer）の「変更履歴」機能をより強力にしたようなものです。
+
+## Gitのインストール
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+[git-scm.com](https://git-scm.com/) からGitをダウンロードすることができます。 2つのステップを除いて「次へ」を押して進んで大丈夫です。エディタを選ぶステップでは、Nanoを選んでください。「PATH環境を調整する(Adjusting your PATH environment)」というステップでは、「Use Git and optional Unix tools from the Windows Command Prompt（WindowsコマンドプロンプトからGitとオプションのUnixツールを使用する）」（一番下の選択肢）を選択します。 それ以外はデフォルトの設定値で構いません。 改行コードの変換(Configuring the line ending conversions)については、「Checkout Windows-style, commit Unix-style line endings」の選択で大丈夫です。
+
+インストールが成功した後に、コマンドプロンプトやパワーシェルを再起動することを忘れないでください。<!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+[git-scm.com](https://git-scm.com/) からGitをダウンロードし、指示に従ってください。
+
+> **注** OS X 10.6,10.7、または10.8を実行している場合は、ここからgitのバージョンをインストールする必要があります: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ja-JP/deploy/signup_pythonanywhere.md b/ja-JP/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..06f0a3ce5a3
--- /dev/null
+++ b/ja-JP/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhereはクラウド上のサーバーでPythonのコードを走らせるためのサービスです。私たちのサイトをホスティングして、インターネット上で動かし続けるために使います。
+
+今までの章で作ったブログをPythonAnywhere上にホスティングします。PythonAnywhereの「Beginner」アカウントを作成しましょう(アカウントは無料枠で大丈夫です。クレジットカードは必要ありません)。
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![PythonAnywhereの登録ページ。無料の「Beginner」アカウントを作るためのボタンがあります。](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **注意** ユーザー名をつけるとき、ユーザー名が `yourusername.pythonanywhere.com` というようにブログのURLに反映されることに注意しましょう。なので、あなたのニックネームかブログの名前をユーザー名とするようにしてください。 パスワードは忘れないようにしてください。(パスワードマネージャーを使っているなら覚えさせておくのも良いでしょう。)
+
+## PythonAnywhere APIトークンの作成
+
+トークンは一度だけ作ればよいです。PythonAnywhereの登録が終わるとダッシュボード画面に移動します。「Account」ページへのリンクはページ右上のバーの中にあります。
+
+![ページ右上にあるAccountページへのリンク](../deploy/images/pythonanywhere_account.png)
+
+「Account」ページに移動したら、「API Token」というタブを選んで、「Create new API token」のボタンを押してください。
+
+![Accountページの「API Token」のタブ](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ja-JP/django/README.md b/ja-JP/django/README.md
new file mode 100644
index 00000000000..23550b7b2bf
--- /dev/null
+++ b/ja-JP/django/README.md
@@ -0,0 +1,27 @@
+# Djangoってなに？
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh* ジャンゴ と読みます) は無料でオープンソースとして公開されているPythonを使用したWebアプリケーションフレームワークです。 Web フレームワークは、素早く、簡単にウェブサイトを開発するのに役立つコンポーネントの一式が含まれています。
+
+ほら、Webサイトを構築する時、同じような構造が毎回必要になってきますよね。ユーザー認証（サインアップ、サインイン、サインアウト）、管理者用の画面、フォーム、ファイルのアップロードなど。
+
+開発者たちはサイトを構築する度に同じ問題を抱えたため、みんなで力を合わせてフレームワークを開発しました。（Djangoはフレームワークのひとつです。）幸運なことに、私たちは、開発に必要な要素がすでに含まれているフレームワークを使って開発することができます。
+
+フレームワークを使うことで、私たちは開発をイチから作り直して車輪の再発明をすることを避けられます。また、新しいサイトを構築する際にかかる最初の準備に必要なコストを軽減します。
+
+## なぜフレームワークを必要とするか。
+
+Djangoを本当に理解するために、サーバーの役割についてもう少し考えてみましょう。サーバーにWebページを配信してもらうようにするには、サーバーにその設定をする必要があります。
+
+手紙が届くポストを想像してください。手紙はユーザからWebサーバーに送られるリクエストのことで、ポストはWebサーバーのポートのことです。 Webサーバーが行っています。 Webサーバーはこのポストを監視して、手紙が届くとそれを読み、Webページから返事を送ります。 返事を送ろうとする時、コンテンツが必要ですね。 Djangoは、あなたがそのコンテンツを作る手助けをするものです。
+
+## 誰かがあなたのWEB サイトにリクエストを要求したときどうなりますか。
+
+Webサーバーにリクエストがあると、Djangoに伝えられ、リクエストの内容を把握しようとします。 まずWebページのアドレスを調べ、リクエストに対して何をするか決めます。 これは、Djangoの**urlresolver**が行います。（WebサイトのアドレスはURLと呼ばれます。 Uniform Resource Locator の略です。-resolverとは「解決するもの」という意味ですので、*urlresolver* というのはうなずけますよね。)。 パターンのリストを受け取って、URLに一致するものを探します。あまり賢いとはいえません。 Djangoは上から下にURLパターンを順に調べていきます。そこで何かがマッチすると、Djangoは*ビュー*と呼ばれる関数にリクエストを送ります。
+
+郵便配達員を思い浮かべてください。 配達員は、通りを歩き、ひとつひとつの家の番地と、手紙に書かれている番地を見比べて行きます。 マッチする番地があったら、手紙をそこに置いていきます。 urlresolverも同じ仕組みです。
+
+*ビュー*関数では、面白いことが行われます。私たちは、データベースに情報を探しにいきます。 時に、ユーザーがデータを変更するよう求めてきますよね？ 例えば、「私の仕事内容を変えて下さい」といった手紙のように。*ビュー*は、まずあなたにその権限があるか確認します。次に、仕事内容を書き換えて、「完了しました！」というメッセージをあなたに送り返します。そして、*ビュー*が反応を返して、DjangoがユーザーのWebブラウザに情報を送ります。
+
+上記の説明は、多少簡略化して説明しています。しかし、今ここでは、技術的なことを完璧に理解する必要はありません。概念が分かれば十分です。
+
+これ以上詳細について深く説明するより、きっと、Djangoを使って実際に手を動かして作ってみる方がいいでしょう。重要な事はすべてその過程で学べますよ！
\ No newline at end of file
diff --git a/ja-JP/django_admin/README.md b/ja-JP/django_admin/README.md
new file mode 100644
index 00000000000..ba1fcccce6a
--- /dev/null
+++ b/ja-JP/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+ブログの投稿を追加、編集、削除するのにDjango adminを使います。
+
+`blog/admin.py`ファイルをエディタで開いて、内容をこのように変えて下さい：
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+見て分かる通り、前回定義したPostモデルをimportしています。 モデルをAdminページ（管理画面）上で見えるようにするため、`admin.site.register(Post)`でモデルを登録する必要があります。
+
+ではPostモデルを見てみましょう。 Web サーバーを実行するコンソールで `python manage.py runserver` を実行してください。 ブラウザに行って http://127.0.0.1:8000/admin/ とアドレスバーにタイプします。 こんなログインページが出ますね。
+
+![ログインページ](images/login_page2.png)
+
+ログインするには、*superuser *（サイトの全てを管理するユーザー）を作る必要があります。 コマンドラインに戻り、`python manage.py createsuperuser` と入力し、enter キーを押します。
+
+> Webサーバーを実行しているときに新しいコマンドを入力したい場合は、新しいターミナルウィンドウを開き、仮想環境（virtualenv）を有効にすることを思い出してください。 **プロジェクトを作成しよう！**の**ウェブサーバを起動する**セクションでどうやって新しいコマンドを書くかというのを見直しました。
+
+{% filename %}Mac OS X または Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+プロンプトが表示されたら、ユーザー名 (小文字、スペースなし)、電子メール アドレス、およびパスワードを入力します。 **タイプしてる間パスワードは見えなくても大丈夫、それが正常です。**タイプして`Enter`を押して続けましょう。 そうすればこのように見えるはずです。（ユーザーネームとパスワードは今あなたがタイプしたものです。）
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+ブラウザに戻ってsuperuserでログインすると、Django admin ダッシュボードが見えるでしょう。
+
+![Django admin](images/django_admin3.png)
+
+Postsをクリックして移動し、少し試してみましょう。 5つか6つほど記事を追加してみることにします。 内容は気にしなくて大丈夫です。ローカルコンピュータで、あなただけに見える記事ですので。また、時間を節約するため、このチュートリアルからテキストをコピー&ペーストしても構いません。 :)
+
+少なくとも 2 つまたは 3 つの記事 (すべてではない) は公開日がセットされているようにしてください。後ほど役に立ちます。
+
+![Django admin](images/edit_post3.png)
+
+Django adminについてもっと知りたいときは、Djangoのドキュメントを見るとよいでしょう。https://docs.djangoproject.com/ja/2.2/ref/contrib/admin/
+
+ここでそろそろコーヒー（または紅茶）か何か食べるものを摂って自分を元気づけるのにいいタイミングでしょう。最初のDjangoモデルを作ったのだから、少し休みをとっていいところです！
\ No newline at end of file
diff --git a/ja-JP/django_forms/README.md b/ja-JP/django_forms/README.md
new file mode 100644
index 00000000000..cdda586d466
--- /dev/null
+++ b/ja-JP/django_forms/README.md
@@ -0,0 +1,479 @@
+# Djangoフォーム
+
+私たちのWebサイトで最終的にやりたいことは、投稿を追加したり編集したりするためのよい方法を作ることです。 `Django admin`はかなりいいですが、カスタマイズしたりかわいくいい感じにするのはちょっと大変です。 `フォーム` によってインターフェイスを完璧にコントロールできるようになります。想像するほとんど全てのことができます！
+
+Djangoフォームのよいところは、フォームをゼロから定義できたり、フォームの結果をモデルに保存できる`ModelForm`を作れたりするところです。
+
+これはまさに私たちがやりたいことです：`Post`モデルのためのフォームを作ります。
+
+Djangoの他の重要なパーツと同様に、フォームは自身のファイルがあります: `forms.py`
+
+これは`blog`ディレクトリの下にforms.pyの名前で作る必要があります。
+
+    blog
+       └── forms.py
+    
+
+このファイルをエディタで開き、次のコードを入力してください。
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+最初にDjangoのformsをインポート（`from django import forms`）し、`Post`モデルもインポート（`from .models import Post`）する必要があります。
+
+`PostForm`とは何かと思うかもしれませんが、これはフォームの名前です。 このフォームが `ModelForm` の一種だとDjangoに伝える必要があります (Djangoが私たちのためにいくつか魔法をかけられるように)。`forms.ModelForm`がその役割を果たします。
+
+次に`class Meta`ですが、ここでDjangoにフォームを作るときにどのモデルを使えばいいか (`model = Post`) を伝えます。
+
+最後にフォームのフィールドに何を置くか書きます。 今回は、私たちは`title`（タイトル）と `text`（本文）のみをフォームで使用します。 `author` は現在ログインしている人（あなた）です。 `created_date` は（コードによって）自動的に投稿を作った日時が設定されます。
+
+ひとまずこれでおしまいです！あとはフォームを*ビュー*で使い、それをテンプレート内に表示しさえすればいいです。
+
+もう一度、ページへのリンク、URL、ビューとテンプレートを作ります。
+
+## フォームにおけるページへのリンク
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new ビュー
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## テンプレート
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* フォームを表示する必要があります。 私たちは（例えば）{% raw %}`{{ form.as_p }}`{% endraw %} でこれを行うことができます。
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* `Save` ボタンが必要です。これをHTMLのbuttonタグで行います：`<button type="submit">Save</button>`
+* 最後に`<form ...>` タグの開始直後に、 `{% raw %}{% csrf_token %}{% endraw %}`を追加する必要があります。 フォームをセキュアにするためこれは非常に重要です！ これを忘れると、Djangoはフォームを保存しようとすると文句を言うでしょう：
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## フォームを保存する
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## フォームのバリデーション(検証)
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## フォームの編集
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## セキュリティ
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## もう一つ: デプロイの時間です!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* まず、Githubにあなたの新しく書いたコードをCommitして、Pushしてみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* それから、[PythonAnywhereのbashコンソール](https://www.pythonanywhere.com/consoles/)で：
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* 最後に、[Webページ](https://www.pythonanywhere.com/web_app_setup/) に飛んで（コンソールの右上のメニューボタンを使ってもいいですね）それから **Reload** を押しましょう。 変更を見るためにあなたのブログ https://subdomain.pythonanywhere.com を再読み込みしましょう。
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ja-JP/django_installation/README.md b/ja-JP/django_installation/README.md
new file mode 100644
index 00000000000..2024d23ecc2
--- /dev/null
+++ b/ja-JP/django_installation/README.md
@@ -0,0 +1,7 @@
+# Djangoのインストール
+
+> **補足：**　Chromebookを使っている方は、このチャプターは飛ばして、 [Chromebook Setup](../chromebook_setup/README.md) の説明に従ってセットアップしてください。
+> 
+> **注意** すでに[](../installation/README.md)インストールステップ</1>をすでに行っている場合は、次の章に進みましょう！
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ja-JP/django_installation/instructions.md b/ja-JP/django_installation/instructions.md
new file mode 100644
index 00000000000..81afdb7095e
--- /dev/null
+++ b/ja-JP/django_installation/instructions.md
@@ -0,0 +1,230 @@
+> このチャプターの一部はGeek Girls Carrots (https://github.com/ggcarrots/django-carrots) のチュートリアルに基づいています。
+> 
+> このチャプターの一部はCreative Commons Attribution-ShareAlike 4.0 International License のライセンスによる[django-marcador tutorial](http://django-marcador.keimlink.de/)に基づいています. このdjango-marcador tutorialはMarkus Zapke-Gründemann らが著作権を保有しています。 
+
+## 仮想環境
+
+Django をインストールする前に、あなたのコーディング環境を、きれいにしておく便利な道具をインストールしてもらいます。 このステップをとばすこともできますが、しかし、このステップをとばすことは全くお勧めしません。 可能な限りベストなセットアップで始めることは将来のたくさんのトラブルからあなたを救うはずですから！
+
+さあ、**仮想環境（virtual environment )**(*virtualenv*とも呼ばれています）を作成してみましょう。 仮想環境（virtual environment）ではプロジェクト単位であなたのPython/Djangoのセットアップを他から隔離します。 これは、あなたがひとつのウェブサイトにおこなったどんな変更も、あなたが開発している他のサイトに影響を及ぼさないということです。 便利でしょ？
+
+あなたがしなければならないのは、あなたが`仮想環境（virtual environment）`を作成したいディレクトリを見つけることです（たとえばホームディレクトリなどです）。 Windowsでは、ホームディレクトリは、`C:\Users\Name`と書かれているかもしれません (`Name`はあなたのログインネームです)。
+
+> **補足：**　Windowsの方は、ディレクトリ名に特殊文字やアクセント記号を含まないよう気をつけてください。もし、ユーザー名が特殊文字を含む場合は、`C:\djangogirls` のようなディレクトリを作成してください。
+
+このチュートリアルのために、ホームディレクトリに新しいディレクトリ`djangogirls`を作成します。
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+`myvenv`という仮想環境（virtual environment）を作成します。一般的なコマンドは以下のようになります：
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+新しい`virtualenv`を作成するために、コマンドプロンプトを開き（コマンドプロンプトについては何章か前にお話ししましたね。覚えてますか？）、`python -m venv myvenv`を実行して下さい。たとえばこのように入力します：
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+`myvenv` というところが、あなたの`virtualenv（仮想環境）` の名前です。 どんな名前でも使うことができますが、必ず小文字で表記し、スペース・アクセント記号・特殊文字は入れないでください。 It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+LinuxやOS Xで`virtualenv`を作るときは、`python3 -m venv myvenv`と実行するだけです。 たとえばこんな感じです：
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` は、あなたの `仮想環境(virtualenvironment)` の名前です。 どんな名前でも使うことができますが、必ず小文字で表記し、スペースは入れないでください。 短い名前にしておくのもいいアイデアですーあなたはこの名前を何度も参照しますから！
+
+> **補足：**DebianやUbuntuのバージョンによっては、以下のエラーが出ることがあります。
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> この場合、エラー内の指示にしたがって、`python3-venv`のパッケージをインストールしましょう。 {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **補足：**DebianやUbuntuのバージョンによっては、この仮想環境を実行すると、次のようなエラーがでます。
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+>     
+> 
+> このエラーを回避するために、代わりに`virtualenv`コマンドを使います。
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **補足：**もし以下のようなエラーがでたら、
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> 代わりに次のコマンドを実行してください。
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## 仮想環境の操作
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+実行して、仮想環境を起動します。
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls > myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. その場合は、Windows PowerShellを「管理者として開く」で、管理者権限で新しくウィンドウを開いてください。 そして、仮想環境を起動する前に、以下のコマンドを入力してください。
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> エディタのウィンドウとコマンドラインのウィンドウを行き来する必要がなくなるのが利点です。
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+実行して、仮想環境を起動します。
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+`myvenv` のところを、あなたが選んだ `仮想環境(virtualenv)` の名前に置き換えることを忘れないで下さいね！
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+コンソールでプロンプトの行頭に `(myvenv)` が付いたら、`仮想環境(virtualenv)` を起動しています。
+
+仮想環境の中で作業しているとき、`python` コマンドは自動的に正しいバージョンのPythonを参照するので、`python3` コマンドの代わりに `python` コマンドを使うことができます。
+
+OK、これで依存関係の準備はすべて整いました。いよいよDjangoのインストールです！
+
+## Djangoのインストール {#django}
+
+今 `virtualenv` を起動したので、Djangoをインストールすることができます。
+
+その前に、最新バージョンの `pip` がインストールされていることを確認すべきです。pipはDjangoのインストールに使うソフトウェアです。
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### requirementsファイルによってパッケージをインストールする
+
+requirementsファイルは `pip install` でインストールする依存関係の一覧が記載されているファイルです：
+
+インストールしたエディタを使って、最初に `requirements.txt` ファイルを `djangogirls/` フォルダの中に作ります。 エディタで新しいファイルを開いて、`djangogirls/` フォルダ内に `requirements.txt` という名前で保存してください。 ディレクトリはこんな感じになっているはずです：
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+`djangogirls/requirements.txt` ファイル中に以下のテキストを追加します：
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+そして、`pip install -r requirements.txt` を実行してDjangoをインストールします。
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). もし含んでいる場合は、スペース・アクセント記号・特殊文字を含まない別の場所（`C:\djangogirls`をオススメします）でディレクトリを作成することを検討してみてください。 新しいディレクトリに新しい仮想環境を作成してから、古いディレクトリを削除して、上記のコマンドを試してください。 （仮想環境には絶対パスが使われているので、仮想環境のディレクトリを移動させてもうまくいきません。）
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> Ubuntu 12.04でpipを実行してエラーが起きた場合は、仮想環境内にpipを再インストールするために `python -m pip install -U --force-reinstall pip` を実行して下さい。
+
+<!--endsec-->
+
+以上です！あなたは（ついに）Djangoアプリケーションを作成する準備が整いました！
\ No newline at end of file
diff --git a/ja-JP/django_models/README.md b/ja-JP/django_models/README.md
new file mode 100644
index 00000000000..413cea40e63
--- /dev/null
+++ b/ja-JP/django_models/README.md
@@ -0,0 +1,201 @@
+# Djangoモデル
+
+さて、ブログの投稿（記事、post ポスト）をためておくものが欲しいですよね。そのために `オブジェクト` についてちょっとお話しします。
+
+## オブジェクト
+
+プログラミングには `オブジェクト指向プログラミング` という概念があります。 それは、退屈なプログラムを繰り返し書く代わりにモデルになるものを作って、それが他とどう作用するかを定義するという考え方です。
+
+じゃあオブジェクトって何なの？って思いますよね。オブジェクトは状態（プロパティ）と命令（アクション）の塊です。ピンと来ないでしょうから例を挙げましょう。
+
+猫をモデルにしたいときは、`猫(Cat)` オブジェクトを作ります。そのプロパティは、`色(color)` 、`年齢(age)` 、`機嫌(mood)`（いい、悪い、眠い）、`飼い主(owner)`（ `人(Person)` オブジェクトですね、捨て猫ならそのプロパティは空白）です。
+
+`猫` のアクションは、`喉を鳴らす(purr)` 、`引っ掻く(scratch)` 、`餌を食べる(feed)`（ `キャットフード(CatFood)` などで、それはまた `味(taste)` というプロパティを持つ別のオブジェクトになるでしょう。）
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+つまり、オブジェクト指向とは実際の物を、プロパティ（ `オブジェクト・プロパティ` と呼びます）と命令（ `メソッド` と呼びます）を持つコードで表現するという考え方です。
+
+ではブログの投稿はどういうモデルになるでしょうか。ブログが作りたいんですよね？
+
+それにはブログの投稿とは何か、それはどんなプロパティがあるかという問いに答えなければなりません。
+
+まず確実なのはブログの投稿にはコンテンツとタイトルが必要ですね。 それからそれを書いた人が分かるといいでしょう。 最後に、投稿をいつ作成、公開したかも分かるといいですね。
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+ではブログの投稿でどんなことができたらいいでしょうか？投稿が公開されるといいですよね？
+
+なので `publish` メソッドが必要です。
+
+達成したいことが分かったので、Djangoでモデリングの開始です！
+
+## Djangoモデル
+
+オブジェクトが何か分かったので、ブログの投稿のDjangoモデルを作りましょう。
+
+Djangoのモデルは特別なオブジェクトで、`データベース` に格納されます。 データベースはデータの集まりです。 ここにユーザーやブログの投稿の情報を格納します。 データを格納するのにSQLiteデータベースを使います。 これはDjangoのデフォルトのデータベースで、今はこれで十分です。
+
+データベースの中のモデルは、列（フィールド）と行（データ）があるスプレッドシートと思ってもらっても結構です。
+
+### 新しいアプリケーションの作成
+
+全部をきちんと整理しておくため、プロジェクトの中に別のアプリケーションを作ります。 初めから全てを整理しておくのはとっても良いことです。 アプリケーションを作るために、次のコマンドをコンソールの中で走らせましょう。（`manage.py` ファイルがある `djangogirls` ディレクトリでコマンドをタイプしてくださいね）
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+新しく `blog` ディレクトリが作られて、今沢山のファイルがそこに入っているのに気がついたでしょう。ディレクトリとファイルはこんな風に見えるはずです：
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+アプリケーションを作ったら、Djangoにそれを使うように伝えないといけません。 それは `mysite/settings.py` でします。エディタでこれを開いてください。 `INSTALLED_APPS` を見つけて `]` の上に `'blog.apps.BlogConfig',` という一行を追加します。 そうすると、最終的には以下のようになりますね。
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### ブログの投稿のモデルの作成
+
+`blog/models.py` ファイルで `Model` と呼ばれるオブジェクトを全て定義します。これがブログの投稿を定義する場所です。
+
+`blog/models.py` をエディタで開いて中身を全部削除し、下のコードを書きましょう。
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> `str` の両側に2つのアンダースコア（ `_` ）がちゃんと入っているか確認しましょう。 これはPythonでよく使われて、"ダンダー"（ダブルアンダースコア）と呼ばれます。
+
+難しそうでしょ？でも大丈夫！ちゃんと説明しますから。
+
+`from` とか `import` で始まる行は全部、他のファイルから何かをちょこっとずつ追加する行です。 なので色んなファイルから必要な部分をコピペする代わりに `from ... import ...` で必要部分を入れることができます。
+
+`class Post(models.Model):` – この行が今回のモデルを定義します (これが `オブジェクト` です)。
+
+- classはオブジェクトを定義してますよ、ということを示すキーワードです。
+- `Post` はモデルの名前で、他の名前をつけることもできます（が、特殊文字と空白は避けなければいけません）。モデルの名前は大文字で始めます。
+- `models.Model` はPostがDjango Modelだという意味で、Djangoが、これはデータベースに保存すべきものだと分かるようにしています。
+
+さて今度はプロパティを定義しましょう：`title`、`text`、`created_date`、`published_date`、それに `author` ですね。 それにはまずフィールドのタイプを決めなければいけません。（テキスト？ 数値？ 日付？ 他のオブジェクト、例えばユーザーとの関係？）
+
+- `models.CharField` – 文字数が制限されたテキストを定義するフィールド
+- `models.TextField` – これは制限無しの長いテキスト用です。ブログの投稿のコンテンツに理想的なフィールドでしょ？
+- `models.DateTimeField` – 日付と時間のフィールド
+- `models.ForeignKey` – これは他のモデルへのリンク
+
+コードの細かいところまでは説明し出すと時間がかかるので、ここではしませんが、 モデルのフィールドや上記以外の定義のやり方について知りたい方は是非Djangoドキュメントを見てみて下さい。 (https://docs.djangoproject.com/ja/2.2/ref/models/fields/#field-types)
+
+`def publish(self):` は何かと言うと、 これこそが先程お話ししたブログを公開するメソッドそのものです。 `def` は、これはファンクション（関数）/メソッドという意味です。`publish` はメソッドの名前で、 変えることもできます。 メソッドの名前に使っていいのは、英小文字とアンダースコアで、アンダースコアはスペースの代わりに使います。 （例えば、平均価格を計算するメソッドは `calculate_average_price` っていう名前にします）
+
+メソッドは通常何かを `return` します。 一つの例が `__str__` メソッドにあります。 このシナリオでは、`__str__()` を呼ぶと、投稿のタイトルのテキスト（**string**）が返ってきます。
+
+`def publish(self):` と `def __str__(self):` の両方が class キーワードに続く行でインデントされているのに気づきましたか？ Pythonにモデルのメソッドだと伝えるために、class キーワードに続く行ではメソッドをインデントしましょう。 そうしないと、メソッドはモデルのものではなくなり、思ってもみない振る舞いをするでしょう。
+
+もしモデルがまだはっきりつかめないようだったら、気軽にコーチに聞いて下さい！ 特にオブジェクトとファンクションを同時に習ったときはとても複雑なのはよく分かってますから。 でも前ほど魔法みたいじゃないといいですけど！
+
+### データベースにモデルのためのテーブルを作成する
+
+最後のステップは新しいモデルをデータベースに追加することです。 まず、モデルに少し変更があったこと（今作ったこと）をDjangoに知らせましょう。 コンソールで `python manage.py makemigrations blog` とタイプします。 こんな感じですね。
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**メモ：**編集したファイルを忘れずに保存してくださいね。保存しないと、コンピュータが以前のパージョンのファイルを実行してしまい、思ってもみないエラーメッセージに出くわすかもしれません。
+
+Djangoが作ってくれた移行ファイルを私たちがデータベースに追加すれば完了です。`python manage.py migrate blog` とタイプするとこうなるでしょう。
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+やった～！Postモデルがデータベースに入りました。どうなったか見たいでしょ？次へ進みましょう！
\ No newline at end of file
diff --git a/ja-JP/django_orm/README.md b/ja-JP/django_orm/README.md
new file mode 100644
index 00000000000..ef474837506
--- /dev/null
+++ b/ja-JP/django_orm/README.md
@@ -0,0 +1,221 @@
+# DjangoのORMとクエリセット
+
+この章では、Djangoのデータベース接続方法と、データの格納について学びます。やってみましょう！
+
+## クエリセットとは？
+
+クエリセットが何かと言うと、モデルのオブジェクトのリストのことです。クエリセットを使って、データベースからデータを読み込んだり、抽出したり、並べ替えたりできます。
+
+実際に動かしてみるのが一番わかりやすいので、試してみましょう。
+
+## Django shell
+
+コンソール画面を開いて（PythonAnywhereのコンソールではないですよ）、次のコマンドを入力してみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+次のような表示に切り替わるでしょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+今、Djangoのインタラクティブコンソールが起動しています。Pythonプロンプトのようにだけ見えますが、ちゃんとDjangoも動いています :) このコンソール画面では、Pythonのコマンドは何でも使えます。
+
+### すべてのオブジェクト
+
+最初に、投稿のデータを全部表示させてみましょう。次のコマンドで、投稿のデータを全部表示させることが出来ます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+ごめんなさい、エラーになってしまいましたね。Postがないというエラーです。その通りなんです。最初にインポートをしなくてはならないのに、忘れていました。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+こんな風に書くだけで、`blog.models` から `Post` モデルをインポート出来ます。それでは、もう一度試してみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+さっきDjangoの管理画面から作った投稿のリストが表示されました。だけど、次はこのコンソール画面から、新たに投稿を作ってみたいですよね。それはどうすればいいのでしょうか。
+
+### オブジェクトの作成
+
+データベースに、新しいPostを作成するには、次のようにします。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+いい感じなのですが、1つだけマズイことをしているんです。author に `me` を渡していますが、これは `User` モデルのインスタンスでないといけませんよね。それは、どうやればいいと思います？
+
+そうです、さっきと同じです。Userモデルも先にインポートしておきましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+どんなユーザが、データベースに登録されてましたっけ？覗いてみましょうか。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+作成しておいたスーパーユーザがいますね。このユーザを取り出してみましょう（この行をご自身で作ったスーパーユーザのユーザ名に変更して取り出してくださいね）。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+ola という `ユーザ名` の `User` モデルのインスタンスを、`取り出せ` たでしょう？よかった！
+
+さあ、遂にコンソール画面から、投稿を作成出来ますね。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+どうでしょうか？ちゃんと出来ているか、確認しておきましょうね。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+出来ていますね！リストに新しい投稿が1つ追加されています。
+
+### さらに投稿を追加しましょう
+
+楽しくなってきたでしょう？理解を深めるためにもう少し投稿を作っておきましょう。2〜3個記事を追加したら、次に進みましょう。
+
+### オブジェクトの抽出
+
+クエリセットの大部分は、抽出機能だと言えるでしょう。 ユーザolaさんの投稿を全部確認してみましょうか。 全部の投稿を取り出すのではなく、olaさんの投稿だけを取り出したい場合は、`Post.objects.all()` の `all` を `filter` に変更します。 取り出されるブログの投稿が満たす条件を、カッコ()の中に指定します。 今回の例では、`author` が `me` と等しいという条件です。 Djangoでの表し方は、`author=me` となります。 このようになりますね。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+もしかすると `title` フィールドに title という単語が含まれている投稿だけを取り出したくなるかもしれませんね。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** `title` と `contains` の間に、アンダーバー (`_`) が2個続いていますが、 これはDjangoのORMの構文です。フィールド名のtitleと、照合タイプのcontainsを、2つのアンダーバーで連結させています。 もしアンダーバーが1個だけだと、title_contains というフィールド名だと判断されてしまい、エラーになります。("FieldError: Cannot resolve keyword title_contains")
+
+また、公開済みの全ての投稿を取り出すことも出来ます。それには、`published_date` が現在以前の全ての投稿を取り出します。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+そうでした、残念なことに、コンソールから追加した投稿はまだ公開されていませんね。じゃあ、投稿を公開してみるとしましょう。まず公開する投稿を決めましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+そして、`publish` メソッドを呼び出します。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+じゃあ、もう一度公開済みの投稿を取り出しましょう。(上方向キーを3回押せば、さっきのコマンドを呼び出せるでしょう。コマンドを表示出来たら、`Enter` キーを押してみましょう)
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### オブジェクトの並び替え
+
+クエリセットは、オブジェクトのリストの並べ替えもやってくれます。試しに `created_date` フィールドで並べ替えてみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+逆順、つまり新しく追加した順に並べ替えることも出来ます。それには、`-`（ハイフン）を使います。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### メソッドチェーンによる複雑なクエリ
+
+ご覧のように、`Post.objects`の一部のメソッドはクエリセットを返します。 逆に同じメソッドをクエリセットについて呼び出すこともでき、そうすると新しいクエリセットが返ります。 よって、**つなげる**ことで、メソッドの返すクエリセットを組み合わせることができます：
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+クエリセットをつなげるのは本当に強力です。つなげていくことでとても複雑なクエリも書くことが出来ます。
+
+いいですね！次の章への準備は万端ですね！このプロンプトを閉じるには、以下のようにします。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ja-JP/django_start_project/README.md b/ja-JP/django_start_project/README.md
new file mode 100644
index 00000000000..576cb32f93e
--- /dev/null
+++ b/ja-JP/django_start_project/README.md
@@ -0,0 +1,260 @@
+# プロジェクトを作成しよう！
+
+> このチャプターの一部はGeek Girls Carrotsのチュートリアルをもとにしています。(https://github.com/ggcarrots/django-carrots)
+> 
+> このチャプターの一部は Creative Commons Attribution-ShareAlike 4.0 International License のライセンスによる [django-marcador tutorial](http://django-marcador.keimlink.de/) をもとにしています。 この django-marcador tutorial は Markus Zapke-Gründemann たちが著作権を保有しています。
+
+ここからは、小さなブログを作っていきますよ！
+
+最初のステップは、Djangoのプロジェクトを新しく作成します。 基本的に、Djangoのスクリプトを実行しDjangoプロジェクトの骨格を作ります。 スクリプトは、これから使う沢山のファイルやディレクトリを自動生成します。
+
+Djangoでは、ファイルやディレクトリの名前がとても重要です。 作成されたファイルの名前は変えるべきではありません。 ファイルを移動させるのもいいアイディアとはいえません。 Djangoでは、重要なファイルを決められたファイル構成で作成しておくことが必要です。 
+
+> virtualenv（仮想環境）を実行しているでしょうか。 もしコンソールのプロンプトの前に `(myvenv)` という文字が表示されていない時は、virtualenv が実行されていないので、有効にする必要があります。 **Djangoのインストール** のチャプターの **仮想環境の操作** のパートで、仮想環境を実行する方法について説明しました。 Windowsでは、`myvenv\Scripts\activate`、MacOS や Linux では、 `source myvenv/bin/activate` というコマンドを入力すると有効にできます。
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+MacOS や Linux の場合は、コンソールで以下のコマンドを実行します。**最後のピリオド(ドット) `.` を忘れないようにしてください！**
+
+{% filename %}コマンドライン{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> コマンドの最後にピリオド `.` を入力したことを確認してくださいね。このピリオドは、現在の作業ディレクトリに Django をインストールするということを示しています (ピリオド `.` は、現在のディレクトリを表す省略表記です)。
+> 
+> **メモ:** 上記のコマンドを入力するときは、`django-admin` で始まる部分のみを入力することを忘れないでください。 ここに書いた `(myvenv) ~/djangogirls$` の部分は、コマンドライン上で入力を受け付けることを示しているプロンプトの一例なので、人によって違うかもしれません。
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Windows の場合は、以下のコマンドを実行しないといけません。**(最後にピリオド (ドット) `.` を書いてください)**
+
+{% filename %}コマンドライン{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> コマンドの最後にピリオド (.) があることを確認してくださいね。これば、現在の作業ディレクトリにDjangoをインストールするということを示すので、とても重要なのです。(ピリオドは簡略表記です).
+> 
+> **メモ:** 上記のコマンドを入力するときは、`django-admin` で始まる部分のみを入力することを忘れないでください。 ここに書いた `(myvenv) ~/djangogirls$` の部分は、コマンドライン上で入力を受け付けることを示しているプロンプトの一例なので、人によって違うかもしれません。
+
+<!--endsec-->
+
+django-admin.py は、必要なディレクトリとファイルを作成するスクリプトです。次のようなファイル構造が作成されましたね。:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **注**：ディレクトリ構造には、以前作成した`venv`ディレクトリもあります。
+
+`manage.py`はサイトの管理に役立つスクリプトです。 それを使用して、他のものをインストールすることなく、私たちのコンピュータ上でWebサーバーを起動することができます。
+
+`settings.py`ファイルには、ウェブサイトの設定が含まれています。
+
+手紙を送付する場所を確認する郵便業者について話した事を覚えていますか？ `urls.py`ファイルには、`urlresolver`（Djangoがビューを見つける仕組みです。Django URLのチャプターで説明します）で使用されるパターンのリストが含まれています。
+
+私たちが変更しない他のファイルを今は無視しましょう。 覚えておくべき唯一の事は、間違えてそれらを削除しないことです！
+
+## 設定変更
+
+`mysite/settings.py`にいくつか変更を加えましょう。 前にインストールしたコードエディタを使用してファイルを開きます。
+
+**注**：`settings.py`は他のものと同じように通常のファイルであることに注意してください。 「ファイルを開く」メニューを使用して、コードエディタ内から開くことができます。 これにより、`settings.py`ファイルに移動して選択できる通常のウィンドウが表示されます。 あるいは、デスクトップのdjangogirlsフォルダに移動して右クリックしてファイルを開くこともできます。 次に、リストからコードエディタを選択します。 インストールされた他のプログラムでは、ファイルを開けても編集できないかもしれないので、エディタの選択は重要です。
+
+私たちのWebサイトが正しい時間で動くといいでしょう。 [Wikipediaのタイムゾーンのリスト](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)に移動して、関連するタイムゾーン (TZ) をコピーします (例：`Asia/Tokyo`)。
+
+`settings.py` の中から `TIME_ZONE` と書かれた行を探してください。この行はタイムゾーンを表しているので、自分が住んでいるタイムゾーンに合わせて修正しましょう。たとえば、次のように書きます。
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Asia/Tokyo'
+```
+
+言語コードは、言語（例えば、英語の場合は`en`、ドイツ語の場合は`de`のように表します）と、国コード（例えば、ドイツの場合は`de`、スイスの場合は`ch`のように表します）からできています。 あなたの母国語が英語でない場合、これを追加すると、Djangoのデフォルトのボタンや通知が設定した言語に変更されます。 ですのでたとえば「Cancel」ボタンがここで定義した言語に翻訳されます。 [Djangoは多くの言語に対応しています。](https://docs.djangoproject.com/ja/2.2/ref/settings/#language-code)
+
+別の言語を使用する場合は、次の行を変更して言語コードを変更します。
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'ja'
+```
+
+静的ファイルのパスも追加する必要があります。 （静的ファイルとCSSについては、後ほどチュートリアルで説明します）。ファイルの*一番下*に移動し、`STATIC_URL`の下に `STATIC_ROOT`を追加します。：
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+`DEBUG` が `True` に設定されていて、`ALLOWED_HOSTS` が空のリストの時は、自動的に `['localhost', '127.0.0.1', '[::1]']` という3つのホストに対してチェックが行われます。 このままの設定では、これから私たちがデプロイして使う PythonAnywhere のホストネームが含まれていません。ですから、次のように設定を変更します。
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **メモ**: Chromebook を使っている人は、次の1行を settings.py ファイルの最後に追加してください。 `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> cloud9を使っている人は、 `ALLOWED_HOSTS` に、`.amazonaws.com` を追加しましょう。
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## データベースをセットアップする
+
+あなたのサイトのデータを保管することができるデータベース・ソフトウェアには、たくさんの種類があります。今は、Django がデフォルトで使う `sqlite3` というデータベースを使うことにします。
+
+この設定はすでに `mysite/settings.py` ファイルの中に次のように書かれています。
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+ブログのデータベースを作成するには、コンソールで次のコードを実行してみましょう： `python manage.py migrate` (`manage.py`ファイルのある`djangogirls`ディレクトリにいる必要があります) 。 うまくいったら次のように表示されるでしょう：
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+終わったら、 Webサーバーを起動し、私たちのWebサイトが動作しているかどうかを確認する時間です。
+
+## ウェブサーバを起動する
+
+コマンドラインやコマンドプロンプトで`manage.py`ファイルを含むディレクトリ（`djangogirls`ディレクトリ）に移動してください。 `python manage.py runserver`を実行してWebサーバーを起動できます。
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Chromebookを使用している場合は、代わりに次のコマンドを使用します。
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}ブラウザ{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> Webサーバーの仕組みについては、「インターネットの仕組み」の章を参照してください。
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ja-JP/django_templates/README.md b/ja-JP/django_templates/README.md
new file mode 100644
index 00000000000..cf60988eb0d
--- /dev/null
+++ b/ja-JP/django_templates/README.md
@@ -0,0 +1,108 @@
+# Djangoテンプレート
+
+何かデータを表示しましょう！Djangoはそれをビルトインの **テンプレートタグ** で実現できます。
+
+## テンプレートタグとは？
+
+HTML中で本当はPythonのコードを書くことはできません。なぜならブラウザが理解できないからです。ブラウザはHTMLだけ分かります。HTMLはどちらかというと静的で、それに対してPythonはもっとずっと動的なことを私たちは知っています。
+
+**Djangoテンプレートタグ** はHTMLにPyhtonのようなコードを埋め込むことができて、動的なウェブサイトがより早く簡単に作れます!
+
+## ブログ一覧テンプレートの表示
+
+前の章で、`posts` 変数でテンプレートに記事のリストを渡しました。今からHTMLで表示をしてみましょう。
+
+Djangoテンプレートで変数を表示するためには、次のように変数の名前を二重中括弧で括ります。
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+これを `blog/templates/blog/post_list.html` テンプレートでやってみましょう。 エディタでこのファイルを開き、2つめの `<div>` から3つめの `</div>` までをまるごと `{{ posts }}` に置き換えて下さい。 ファイルを保存してページをリロードすると：
+
+![図 13.1](images/step1.png)
+
+見たとおり、このようになります。
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Djangoはposts変数をオブジェクトのリストと認識します。 **Python入門**でどうやってリストを表示できたか覚えていますか？ ループを使ってリストを表示しましたよね。 Djangoテンプレートではこう書きます：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+これをブログのテンプレートで使ってみましょう。
+
+![図 13.2](images/step2.png)
+
+動きましたね。 しかし、本当は**HTML入門**で作った静的な記事のように表示してほしいところです。 そこで、HTMLとテンプレートタグを混ぜてみましょう。 `body` タグの中を次のように書いてください：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}`{% for %}` と `{% endfor %}` の間に書いたものはリスト中の各オブジェクトの分だけ繰り返されます。ページをリロードしてみましょう。{% endraw %}
+
+![図 13.3](images/step3.png)
+
+post変数がさっきと違って、`{{ post.title }}` や `{{ post.text }}` になっていることに気づきましたか？ `Post` モデルで定義したそれぞれのフィールドにアクセスしています。 `|linebreaksbr` はpostのテキスト中の改行を段落に変換するフィルタに通すという意味です。
+
+## もう一つ...
+
+今の時点でのウェブサイトを公開して見てみませんか？もう一度PythonAnywhereでデプロイしてみましょう。デプロイのステップをおさらいします。
+
+* まず、GithubにあなたのコードをPushしましょう
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* そしたら、[PythonAnywhere](https://www.pythonanywhere.com/consoles/)に戻って、**Bashコンソール**（か、新しいコンソール）に入って、次のようにコマンドを打ちましょう：
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+（忘れずに `<your-pythonanywhere-domain>` を自分のPythonAnywhereのサブドメイン名に置き換えましょう、<> は不要です。）
+
+* 最後にPythonAnywhereの[「Web」ページ](https://www.pythonanywhere.com/web_app_setup/)を開いて、アプリを**リロード**（Reload）します。 （コンソールからPythonAnywhereの他のページにアクセスするには、右上のメニューボタンを使います。）更新された内容が、 https://subdomain.pythonanywhere.com に反映されているはずです。ブラウザで確認してみましょう！ PythonAnywhereサイトで表示されるブログの記事が、あなたのパソコンの中のローカルサーバーのものと違っていても大丈夫です。 ローカルコンピュータにあるデータベースと、PythonAnywhere上のデータベースは同期していません。
+
+頑張りましたね！ さぁ、ここまでできたら、Django 管理画面から新しい投稿を追加してみましょう。（published_date 公開日の設定を忘れずに！）投稿を追加する時、PythonAnywhereのサイトの管理画面（https://subdomain.pythonanywhere.com/admin）であることを確認してください 。できたら、リロードして投稿したものが表示されるか見てみましょう。
+
+うまく動きましたか？ここまでよく頑張りましたね！少しパソコンから離れて、休憩をとりましょう。^_^
+
+![図 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ja-JP/django_urls/README.md b/ja-JP/django_urls/README.md
new file mode 100644
index 00000000000..5b509c93552
--- /dev/null
+++ b/ja-JP/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URL
+
+もうすぐ最初のWebページ、あなたのブログのホームページを作るところです！でも最初に、ちょっとだけDjangoのURLについて学びましょう。
+
+## URLとは？
+
+URLはWeb上のアドレスです。 サイトのURLは、ブラウザのアドレスバーで見ることができます。 （そう、 `127.0.0.1:8000` や `http://djangogirls.com` がURLです。）
+
+![URL](images/url.png)
+
+インターネット上のすべてのページには、独自のURLが必要です。 それによって、これから作るアプリケーションが、URLを指定してアクセスしてきたユーザに、何を見せたらいいのかわかるのです。 Djangoでは `URLconf`（URL設定）と呼ばれるものを使います。 URLconfはパターンの集まりで、適切なビューを見つけるために、DjangoがリクエストされたURLと照合するものです。
+
+## DjangoでURLはどのように機能する？
+
+`mysite/urls.py` を開いて、中身をみてみると：
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+ご覧のとおり、Djangoは既にこのようなものを置いてくれています。
+
+三重クオート（ `'''` や `"""` ）で囲まれた行は、docstringとよばれるコメント行です。ファイル、クラス、またはメソッドの先頭に記述して、それが何をするかを説明するのに用います。 これはPythonによって実行されない行です。
+
+前の章で訪れたadminのURLについてはすでに書いてありますね。
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+`admin/` で始まる全てのURLについて、Djangoが返すべき*ビュー*をこの行で指定しています。 今回の場合、adminで始まるURLをたくさん作ることになりますが、その全てをこの小さいファイルに書くようなことはしません。この方がきれいで読みやすいですし。
+
+## あなたの初めてDjango URL!
+
+さあ最初のURLを作りましょう！'http://127.0.0.1:8000/' をブログの入口ページにして、ブログの投稿のリストを表示するようにしたいと思います。
+
+`mysite/urls.py` ファイルは簡潔なままにしておきたいので、`mysite/urls.py` では`blog` アプリからURLをインポートするだけにしましょう。
+
+まず、`blog.urls` をインポートする行を追加しましょう。 ここで、`include`関数を使いたいので、`from django.urls…`の行を変更し、そのインポートを追加する必要があります。
+
+`mysite/urls.py` ファイルはこのようになります：
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+これでDjangoは'http://127.0.0.1:8000/' に来たリクエストは `blog.urls` へリダイレクトするようになり、それ以降はそちらを参照するようになります。
+
+## blogのURL
+
+`blog` ディレクトリの下に、新しく `urls.py` という空のファイルを作って、コードエディタで開いて下さい。そして最初の2行を以下のように書きます：
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+これはDjangoの `path` 関数と、`blog` アプリの全ての `ビュー`（といっても、今は一つもありません。すぐに作りますけど！）をインポートするという意味です。
+
+その後、最初のURLパターンを追加します。
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+見てのとおり、`post_list` という名前の `ビュー` をルートURLに割り当てています。 このURLパターンは空の文字列に一致します。Djangoはビューを見つけるとき、URLのパス(path)の前にくっつくドメイン名（つまり、http://127.0.0.1:8000/ の部分）を無視します。 このパターンは誰かがあなたのWebサイトの 'http://127.0.0.1:8000/' というアドレスにアクセスしてきたら `views.post_list` が正しい行き先だということをDjangoに伝えます。
+
+最後の `name='post_list'` は、ビューを識別するために使われるURL の名前です。 これはビューと同じ名前にすることもできますが、全然別の名前にすることもできます。 プロジェクトでは名前づけされたURLを後で使うことになるので、アプリのそれぞれのURLに名前をつけておくのは重要です。また、URLの名前はユニークで覚えやすいものにしておきましょう。
+
+もし今 http://127.0.0.1:8000/ にアクセスしたら、'web page not available' のようなメッセージが出るでしょう。 これはサーバー（ `runserver` ってタイプしたのを覚えていますか？）が動いていないからです。 なぜこうなったのかを知るためにサーバーのコンソール画面を見てみましょう。
+
+![エラー](images/error1.png)
+
+エラーが表示されていますね。でも心配しないで。これはむしろ、結構便利なものなんですよ：ここでは、**'post_list' という属性(attribute)がない**ことを知らせてくれています。 これは *ビュー* の名前で、Djangoが探して使おうとしましたが、私たちはこれをまだ作っていませんでした。 現時点では、`/admin/` も動作していないと思います。 心配しなくて大丈夫です。ちゃんとできますから。 別のエラーメッセージが表示された場合は、Webサーバーを再起動してみてください。 これを行うには、Webサーバーを実行しているコンソールウィンドウで、Ctrl + C（CtrlキーとCキーを同時に押す）で停止します。 Windowsの場合、Ctrl + Breakかもしれません。 その後、`python manage.py runserver`を実行してWebサーバーを再起動します。
+
+> Django URLconfについてもっと知りたい場合は、公式のドキュメントを見て下さい。 https://docs.djangoproject.com/ja/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ja-JP/django_views/README.md b/ja-JP/django_views/README.md
new file mode 100644
index 00000000000..7b9cc17cb07
--- /dev/null
+++ b/ja-JP/django_views/README.md
@@ -0,0 +1,44 @@
+# Djangoビュー – 今こそ作りましょう！
+
+それでは前の章の続きをやりましょう。確かビューの作成がまだだったので、エラーになっていましたね！:)
+
+*ビュー* はアプリのロジックを書いていくところです。 ビューは、以前あなたが作った `モデル` に情報を要求し、それを `テンプレート` に渡します。 テンプレートは、次の章で作ります。 ビューはただのPythonの関数です。**Python入門**の章で書いたものよりもちょっと複雑なだけですよ。
+
+ビューは、`views.py` に記述します。私たちの場合 `blog/views.py` に書くことになります。
+
+## blog/views.py
+
+では、早速 blog/views.py をコードエディタで開いて何があるか見てみましょう：
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+まだ何もないですね。
+
+`#` で始まる行は、コメントです。この行に書いたものはPythonは無視します。
+
+それでは、次のようなちょっとした *ビュー* を作ってみましょう。
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+見てのとおり、`post_list` という関数（`def` から始まる部分のことです）を作りました。これは `request` を引数に取ります。`blog/post_list.html` テンプレートを（色々なものを合わせて）組み立てる `render` という関数を呼び出して得た値を `return` しています。
+
+ファイルを保存したら、どんな風に表示されるか、ブラウザで http://127.0.0.1:8000/ を確認してみましょう。
+
+今度は別のエラーになりましたね。なんと書いてあるでしょうか。
+
+![エラー](images/error.png)
+
+サーバーは実行されていることはわかるのですが、正しく表示されないのはなぜでしょう？ 心配しないで！ただのエラーページです！ コンソールでのエラーメッセージと同じように、これは実際にかなり便利です。 *TemplateDoesNotExist* と書いてありますね。 それでは次の章でテンプレートを作って、エラーを解決しましょう！
+
+> Djangoのビューについてもっと知りたいのなら、公式ドキュメントをぜひ読んでみてください。 https://docs.djangoproject.com/ja/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ja-JP/dynamic_data_in_templates/README.md b/ja-JP/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..2342cd1d67c
--- /dev/null
+++ b/ja-JP/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# テンプレート内の動的データ
+
+記事（投稿）を保存するために `Post` モデルを `models.py` に定義しました。記事の一覧を表示する `post_list` は `views.py` にあり、テンプレートも加わりました。 これらを準備しましたが、実際のところ、記事をどうやってHTMLファイルに出力すればいいのでしょうか？ 大まかなイメージとしては、データベースに保存された記事を取り出して、テンプレートのHTMLファイルの中に行儀よく並べれば良さそうですね。
+
+正確には、*ビュー *が モデルとテンプレートの橋渡しをしてくれます。 私達が作業している `post_list ` *ビュー *の場合、表示したいデータを取り出して、テンプレートファイルに渡すことになります。 どのモデルのデータを、どのテンプレートに表示させるかを、 *ビュー*に 記述します。
+
+それでは、実際にやってみましょう。
+
+まず`blog/views.py`をエディタで開きます。今のところ `post_list`*ビュー* は、以下のようになっているでしょう。
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+少し前に、別のファイルに用意したコードをどうやってインクルードするか説明したのですけれど、覚えていますか？ それでは `models.py` のモデルを、インクルードしてみましょう。 `from .models import Post` という行を追加してみます。
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+`models` の前にあるドットは *カレントディレクトリ* 、もしくは *カレントアプリケーション *のことです。 ` views.py `と `models.py `は、同じディレクトリに置いてあります。 だから、こんな風に`.`とファイル名だけを使って、簡単に記述することが出来るのです。（ファイル名の拡張子`.py `は必要ないです） そして、モデルの名前を指定してインポートします(この場合のモデルは `Post `ですね)。
+
+さて、次にすべきことは、実際に `Post `モデルからブログの記事を取り出すことですが、それには `クエリセット `が必要です。
+
+## クエリセット
+
+もう、クエリセットの働きについては、知っていますよね。[Django ORM（クエリセット）](../django_orm/README.md) チャプター で勉強しました。
+
+公開したブログ記事を `published_date `で並べ替えをしたいですね。これも、クエリセットの章でやったので、大丈夫ですね？
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+それでは `blog/views.py`をエディタで開いて、このコードを`def post_list(request)`で始まる関数の中に加えましょう。`from django.utils import timezone`をまず追加するのを忘れないでくださいね。
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+ブログ投稿リストにクエリセットを表示するために、あと2つしなければならないことがあります。
+
+1. `posts` クエリセット をテンプレートコンテキストに渡し、 `render` 関数呼び出しを変更します。今から行います。
+2. `posts` クエリセットを表示するテンプレートを修正します。後の章で説明します。
+
+作成したクエリセットは、*変数* `posts `で参照できることに、注意しましょう。この 変数 posts を使って、クエリセットのデータにアクセスします。これから先 posts というと、このクエリセットのことです。
+
+`render `関数では、既にパラメータとして `request `とテンプレートファイル `'blog/post_list.html' `が渡されています。リクエストというのは、インターネットを介してユーザから受け取った全ての情報が詰まったものです。最後のパラメータに注目してください。 ` {} `こんな風に書かれていますね。この中に指定した情報を、テンプレートが表示してくれます。{} の中に引数を記述する時は、名前と値をセットにしなくてはなりません。 表示させたいのはクエリセットのデータなので、 `posts` を指定しましょう。 :) `{'posts': posts}`という具合に、記述します。 注意して欲しいのは、シングルクォートです。 `:`（コロン） で区切られた、前の方の posts は、 シングルクォート で囲まれて、 'posts' になっていますよね。こちらが名前で、後ろの方の posts は値、クエリセットのことです。
+
+最終的に `blog/views.py `は、以下の様になるはずです。
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+どうでしたか？次は、このクエリセットをテンプレートで表示させるところを、やってみましょう。
+
+Djangoのクエリセットについて、もっと知りたければこちらも読んでみてくださいね。 https://docs.djangoproject.com/ja/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ja-JP/extend_your_application/README.md b/ja-JP/extend_your_application/README.md
new file mode 100644
index 00000000000..f62ad90878d
--- /dev/null
+++ b/ja-JP/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# アプリケーションを拡張しよう
+
+もうウェブサイトを作るのに必要な全ての章は終わりました。モデル、URL、ビュー、テンプレートの書き方はわかっていますし、またウェブサイトを素敵にするやり方もわかります。
+
+さあ練習しましょう！
+
+ブログに最初に必要なものはおそらく、記事を表示するページですよね。
+
+もう`Post`モデルが入っていますから、`models.py`は追加する必要はありません
+
+## 投稿の詳細へのテンプレートリンクを作成する
+
+`blog/templates/blog/post_list.html`ファイルにリンクを追加していきましょう。 コードエディタで開いたら、次のようになっていますよね： {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}投稿リストの投稿のタイトルから投稿の詳細ページへのリンクを作りたいです。 投稿の詳細ページにリンクするように`<h2><a href="">{{ post.title }}</a></h2>`を変更しましょう。{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}不思議な` {％ url 'post_detail' pk = post.pk ％}`を説明します。 気づいたかもしれませんが、`{% %}`という表記はDjangoのテンプレートタグを使用していることを意味しています。 今私たちはこれをURLを作るために使います！{% endraw %}
+
+`post_detail`の部分は、Djangoが`blog/urls.py`に書かれた name=post_detail のURLを待ち受けることを表しています。
+
+そして`pk=post.pk`についてはどうでしょうか？ `pk` は primary keyの略で、データベースの各レコードのユニークな名前です。 すべてのDjangoモデルには、そのプライマリーキーとして機能するフィールドがあります。 どのような名前を持っていたとしても、「pk」と呼ばれることもあります `Post`モデルでプライマリキーを指定しなかったので、Djangoは私たちのために1つのキーを作成し（デフォルトでは、"id"という各レコードごとに1ずつ増える数字で、たとえば1、2、3です）、各投稿に`pk`というフィールド名で追加します。 We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+さて、私たちが http://127.0.0.1:8000/ に行くとエラーが出ます（知っての通り、URLも`post_detail`の*ビュー*もまだ作っていないので）。 このようになります：
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## 投稿の詳細へのURLを作成する
+
+`post_detail` *ビュー*用に`urls.py`にURLを作成しましょう！
+
+最初の投稿の詳細がこの**URL**で表示されるようにします：http://127.0.0.1:8000/post/1/
+
+投稿の内容を表示する`post_detail`という*ビュー*をDjangoに示すように、`blog/urls.py`ファイルでURLを作りましょう。 `blog/urls.py`をエディタで開いて、`path('post/<int:pk>/', views.post_detail, name='post_detail'),`という行を追加しましょう。ファイルは次のようになるでしょう。
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+`post/<int:pk>/` の部分はURLパターンを指定しています。それについて説明しましょう:
+
+- `post/` はURLが **post** に続けて **/** で始まることを意味します。ここまでは順調ですね。
+- `<int:pk>` – この部分はトリッキーです。これはDjangoは整数の値を期待し、その値が`pk`という名前の変数でビューに渡されることを意味しています。
+- `/` – それからURLの最後に再び **/** が必要です。
+
+つまり、ブラウザに`http://127.0.0.1:8000/post/5/`を入力すると、Djangoは`post_detail`という*ビュー*を探していると理解します。そして`pk`が`5`という情報をその*ビュー*に転送します。
+
+よし、私たちは `blog/urls.py` に新しい URL パターンを追加しました！ ページを更新しましょう：http://127.0.0.1:8000/ ドーン！ サーバーが再び実行を停止しました。 コンソールを見てください - 予想通り、もう一つのエラーがあります！
+
+![AttributeError](images/attribute_error2.png)
+
+あなたは次のステップが何であるか覚えていますか？ ビューを追加する！ですね。
+
+## 投稿の詳細ビューを追加する
+
+今回は*ビュー*に追加のパラメータ`pk`が与えられます。 私たちの*ビュー*はそれを受け取る必要がありますね？ そこで関数を`def post_detail(request, pk):`として定義します。 注意 このパラメーターは`urls` で指定した名前と（`pk`）全く同じものを使用しなければなりません。 そして、この変数を省略することは正しくなく、エラーになってしまします。
+
+今、私たちは1つだけブログ投稿を取得したいと考えています。 これを行うには、次のようなクエリセットが使用できます。
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+しかし、このコードには問題があります。 与えられた`プライマリキー`（`pk`）を持つ`Post`が存在しない場合、とてもダサいエラーが発生します。
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+私たちはそれを望んでいません！ しかし幸運にもDjangoにはそれを処理するものがあります：`get_object_or_404` です。 与えられた`pk`の`Post`がない場合、前よりもっとよい `Page Not Found 404` ページが表示されます。
+
+![Page not found](images/404_2.png)
+
+いい知らせとして実際には自分の`Page not found`ページを作って自分の好きなようにきれいにすることができます。しかしそれは今すごく重要ではないので、私たちはそれをスキップします。
+
+よし、今こそ*ビュー*を`views.py`ファイルに追加するときです！
+
+`blog/urls.py`では`views.post_detail`というビューを参照する`post_detail`という名前のURLルールを作成しました。 これは、Djangoが`blog/views.py`内の`post_detail`というビュー関数を待っていることを意味します。
+
+`blog/views.py`をコードエディタで開き、他の`from`行の近くに次のコードを追加する必要があります。
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+ファイルの最後に*ビュー*を追加します：
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+ページを更新してみましょう：http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+出来ましたね！ しかし、ブログ投稿のタイトルのリンクをクリックするとどうなりますか？
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+あらいやだ！ 別のエラー！ しかし、私たちはすでにそれに対処する方法をすでに知っていますね。 そう！テンプレートを追加する必要があります！
+
+## 投稿の詳細へのテンプレートリンクを作成する
+
+`blog/templates/blog`に`post_detail.html`というファイルを作成し、コードエディタで開きます。
+
+以下のコードを入力してください：
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+もう一度`base.html`を拡張します。 `content`ブロックでは、投稿の公開日（存在する場合）、タイトル、およびテキストを表示します。 ここで重要なポイントについて見てみます。
+
+{% raw %}`{% if ... %} ...  {％endif％}`は、何かをチェックしたいときに使用できるテンプレートタグです。 (`if ... else...`を**Python入門**のチャプターでやったのを覚えていますか？) この場合、投稿の`published_date`（公開日）が空でないかを確認します。{% endraw %}
+
+これで、ページを更新して`TemplateDoesNotExist`がもうなくなったかどうか確認できます。
+
+![Post detail page](images/post_detail2.png)
+
+イェーイ！うまくできていますね！
+
+# デプロイの時間です！
+
+あなたのウェブサイトがまだPythonAnywhere上で動くとしたらいいでしょう？またデプロイしてみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+それから、[PythonAnywhere Bash コンソール](https://www.pythonanywhere.com/consoles/)で：
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+（`<your-pythonanywhere-domain>`の部分を、自分の実際のPythonAnywhereのサブドメイン名に山カッコをはずして置き換えることを忘れずに。）
+
+## サーバー上の静的ファイルの更新
+
+PythonAnywhereのようなサーバは、（CSSファイルのような）「静的ファイル」をPythonファイルとは違って扱うのが好きです。なぜなら、それらが高速に読み込まれるように最適化できるからです。 その結果、CSSファイルを変更するたびに、サーバー上で追加のコマンドを実行して、更新するように指示する必要があります。 コマンドは`collectstatic`です。
+
+もし仮想環境（virtualenv）が有効になっていなければ有効化するところから始めましょう (PythonAnywhereではこれを行うために`workon`というコマンドを使用します。これはあなたが自身のコンピュータで使用している`source myenv/bin/activate`コマンドと同じようなものです) 。
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+`manage.py collectstatic`コマンドは、`manage.py migrate`のようなものです。 私たちはコードをいくつか変更してから、Djangoにサーバの静的ファイルのコレクションまたはデータベースに変更を*適用*するよう指示します。
+
+いずれにしても、[「Web」ページ](https://www.pythonanywhere.com/web_app_setup/)を（コンソールの右上のメニューボタンから）開き、**Reload**をクリックする準備ができました。そうしたらhttps://subdomain.pythonanywhere.comを見て結果を確認しましょう。
+
+うまくいってるはずです！おめでとうございます! :)
\ No newline at end of file
diff --git a/ja-JP/how_the_internet_works/README.md b/ja-JP/how_the_internet_works/README.md
new file mode 100644
index 00000000000..b11bce7f017
--- /dev/null
+++ b/ja-JP/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# インターネットのしくみ
+
+> 家で１人でこのチャプターに挑戦している方へ：このチャプターは、動画（英語）もあるので参考にしてください。 [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc)
+> 
+> この章は、ジェシカ・マッケラー（http://web.mit.edu/jesstess/www/ ）による「インターネットの仕組み」を参照しています。
+
+私達は、毎日インターネットを使っています。でも、ブラウザのアドレス欄に https://djangogirls.org のようなアドレスを入力して `Enter` キーを押すと何が起こるか、あなたは実際に知っていますか？
+
+まず最初に理解する必要があるのは、Webサイトはハードディスクに保存されたたくさんのファイル（ちょうどあなたの動画や音楽、画像のデータのようなファイル）からできているということです。 ただし、Webサイトに固有の部分が1つあります。HTMLと呼ばれるコンピューター向けコードが含まれていることです。
+
+プログラミングに慣れていない場合、最初はHTMLを把握するのは難しいかもしれませんが、Webブラウザ（Chrome、Safari、Firefoxなど）とHTMLコードは親和性があります。 Webブラウザはこのコードがわかるようになっていて、コードの指示に従います。そして、あなたのウェブサイトのファイルをあなたが望む方法で表示するのです。
+
+あなたのパソコンへファイルを保存するのと同じで、私達はHTMLをハードディスクに保存する必要があります。 インターネットの場合、*サーバー* と呼ばれるパワフルなコンピュータを使い、そのハードディスクに保存します。 サーバーの主な目的は、データを保存したり、データを供給したりすることなので、サーバーは画面やマウス、キーボードを持っていません。 サーバーはデータを供給する（*サーブ* する）役割を持っているので、*サーバー* と呼ばれるのです。
+
+はい、では、どのようにインターネットが見えるかを知りたいですよね？
+
+私たちは絵を描いてみました。
+
+![図 1.1](images/internet_1.png)
+
+上記の絵は混乱しているように見えますよね？ 接続されたマシン（*サーバー*）のネットワークは実際こんな感じです。 数十万台のマシン！ 世界中はりめぐらされたケーブル！ Submarine Cable MapのWebサイト (http://submarinecablemap.com) にアクセスすれば、ネットの複雑さを知ることができます。 ここにウェブサイトからのスクリーンショットがあります：
+
+![図 1.2](images/internet_3.png)
+
+すばらしいですね。 でも、インターネットに接続されているすべてのマシンとマシンの間にワイヤを置くことは不可能です。 したがって、マシン（例えば http://djangogirls.org が保存されているマシン）に到達するためには、多くの異なるマシンを介してリクエストを渡す必要があります。
+
+こんな感じですね。
+
+![図 1.3](images/internet_2.png)
+
+あなたが http://djangogirls.org と入力すると、「親愛なるDjango Girlsへ。私はdjangogirls.orgのWebサイトが見たいです。それを私に送ってください」とリクエスト（手紙）を送ることになります。
+
+あなたの手紙（リクエスト）は、まずあなたの一番近くの郵便局にいきますよね。 そしてそこから、もう少し宛先に近い別の郵便局に行き、またそこからもう少し近い郵便局に行って・・そしてあなたの目的地まで届きます。 特別なことが一つあります。同じ宛先に多くの手紙（*データパケット*）を送ると、まったく別の郵便局（*ルーター*）を通過して届く可能性があるということです。 届くまでの道順は、郵便局ごとの配送方法次第です。
+
+![図 1.4](images/internet_4.png)
+
+このように動作しています。あなたはメッセージを送信し、何らかの応答を期待します。 紙とペンではなく、データのバイトを使用しますが、アイデアは同じです！
+
+市町村名、郵便番号、国名の住所の代わりに、IPアドレスを使用します。 お使いのコンピュータは、まず djangogirls.org をIPアドレスに変換するようにDNS（Domain Name System）に依頼します。 あなたが連絡したい人の名前を探し、電話番号と住所を見つけることができる昔ながらの電話帳のようなものです。
+
+手紙を送るときには、住所、切手など、正しく配送される特定の機能が必要ですよね。 また、受信者が理解できる言語も使用している必要がありますよね？ Webサイトを表示するために送信する *データパケット* についても同様です。 HTTP（Hypertext Transfer Protocol）というプロトコルを使用します。（プロトコルとは正しく配送されるための機能や、使う言語などについての取り決めのことです）
+
+だから、基本的に、あなたがWebサイトを持つなら、*サーバー*（マシン）が必要です。 *サーバー* は *リクエスト* を（手紙で）受け取ると、Webサイトを（別の手紙で）返します。
+
+これはDjangoチュートリアルですから、Djangoが何をしているのか知りたいでしょう？ あなたが返事を返す時、 いつもみんなに同じ返事を返したいわけではなく、 リクエストを送った人それぞれにパーソナライズされた返事を返した方がよいこともありますよね？ Djangoはパーソナライズされた面白い手紙を作るのに役立ちます。 :)
+
+インターネットの話は以上です！さあ、いよいよあなたのブログサイトを作成する時間です！
\ No newline at end of file
diff --git a/ja-JP/html/README.md b/ja-JP/html/README.md
new file mode 100644
index 00000000000..1f4c61d2a8a
--- /dev/null
+++ b/ja-JP/html/README.md
@@ -0,0 +1,227 @@
+# HTML 入門
+
+テンプレートとは何でしょうか？
+
+テンプレートは、異なる情報を統一された形式で示すために繰り返し使われるファイルです。例えば、テンプレートは手紙を書く際に役立ちます。それぞれの手紙のメッセージは様々で、宛先も別々かもしれませんが、どの手紙も同じフォーマットを共有できるのです。
+
+Djangoのテンプレートのフォーマットは、HTMLと呼ばれる言語 (最初のチャプター**「インターネットのしくみ」**で触れたHTMLのことです) で書かれています。
+
+## HTMLとは？
+
+HTMLは、ChromeやFirefox、Safariなどのウェブブラウザで解読され、利用者にウェブページを表示するためのコードです。
+
+HTMLは、「HyperText Markup Language」の頭文字を取ったものです。 **HyperText**はWebページ間を結びつけるハイパーリンクをサポートするテキスト形式という意味です。 **Markup**とは、一つの書類について、コードで修飾を付けて、何かに(この場合、ブラウザに) どう解釈するかを伝えることを意味します。 HTMLコードは、 `<`で始まり、 `>`で終わる**タグ**で構成されています。 これらのタグが、markup修飾の**要素**なのです。
+
+## 最初のテンプレート
+
+テンプレートを作るとは、テンプレートのファイルを作ることです。すべてはファイルですよね。皆さんは、たぶん、このことに、もう気づいていると思います。
+
+テンプレートは、`blog/templates/blog`ディレクトリに保存されています。 それでは、最初に、自分のblogディレクトリの中に`templates`という名前のディレクトリを作成してください。 次に、自分のtemplatesディレクトリの中に`blog`という名前のディレクトリを作ります。
+
+    blog
+    └───templates
+        └───blog
+    
+
+（なぜ、両方とも`blog`という名前の付いたディレクトリを2つ作成する必要があるのか不思議に思う人もいるかもしれません。あとで分かると思いますが、簡単に言うと、これは、もっと複雑なことをやろうとした時に、それが楽にできるようにしてくれる便利な命名法なのです。）
+
+それでは、`blog/templates/blog`ディレクトリの中に、`post_list.html`ファイル(とりあえず何も書かれていないファイルにしておきます)を作成しましょう。
+
+あなたのウェブサイトを見てみてください: http://127.0.0.1:8000/
+
+> もし、`TemplateDoesNotExist`が引き続き表示されるようなら、自分のサーバーを再起動してみてください。 コマンドラインから、Ctrl+C(ControlとCのキーを同時に)を押してサーバーを止め、`python manage.py runserver`コマンドを動かして再度サーバーを動かします。
+
+![図 11.1](images/step1.png)
+
+もうエラーはありません。おめでとうございます! :)　しかし、あなたのウェブサイトは空白ページ以外は何も表示しいません。テンプレートが空白だからです。これを直していく必要があります。
+
+この新しく作ったファイルをコードエディタで開いて、次の内容を書き加えます。
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+さあ、あなたのウェブサイトはどう見えるでしょうか？以下を開いて確認してみましょう: http://127.0.0.1:8000/
+
+![図 11.2](images/step3.png)
+
+動いています。よくできました! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## HeadとBody
+
+それぞれのHTMLページは**head**と**body**という要素によって2つにわけられています.
+
+* **head**は文書についての情報を含む要素で、画面には表示されません。
+
+* **body**はWebページの一部として表示されるすべてを含む要素です。
+
+`<head>`でページの設定をブラウザに伝え、`<body>`でページの内容を伝えます。
+
+例えば、ウェブページのタイトル要素は`<head>`の中に書きます。こんな感じですね。
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+ファイルを保存し、ページを更新してください。
+
+![図 11.3](images/step4.png)
+
+ブラウザは、どうやって、"Ola's blog"があなたのウェブサイトのタイトルだと理解したのか分かりましたか？ ブラウザは、`<title>Ola's blog</title>`の意味を解釈して、あなたのブラウザのタイトルバーに文を配置したのです(この文はブックマークなどにも利用されます)。
+
+各々の開始タグは*閉じタグ*とセットで、閉じタグには`/`が付いていて、タグの要素は*入れ子*になっていることに気がついたことと思います(つまり、ある特定のタグを閉じるには、その中にある全てのタグも閉じられていないとだめなのです)。
+
+箱の中にものを詰め込むのと同じですね。 大きな箱、 `<html></html>`があります; その中に`<body></body>`があり、さらにもっと小さな`<p></p>`が入っているのです。
+
+こうした*閉じ*タグと、*入れ子*のルールを守らなくてはいけません - そうしないと、ブラウザはタグを適切に解釈することができず、あなたのウェブページが正しく表示されなくなるのです。
+
+## テンプレートのカスタマイズ
+
+それでは、ちょっぴり楽しくテンプレートを作り変えてみましょう！次のようないくつか便利なタグがあります。
+
+* `<h1>ヘッダー</h1>` 最も重要性の高い見出し
+* `<h2>サブのヘッダー</h2>` その次のレベルの見出し
+* `<h3>サブのサブのヘッダー</h3>`... など`<h6>`まで
+* `<p>文章の段落</p>`
+* `<em>文章</em>`で文章を強調する
+* `<strong>文章</strong>`でさらに文章を強調する
+* `<br>`は改行(brタグの中には何も書いてはいけません。閉じタグも無しです)
+* `<a href="https://djangogirls.org">リンク</a>` はリンクを生成します
+* `<ul><li>第１の項目</li><li>第２の項目</li></ul>` でリストを作成する、こんな感じに！
+* `<div></div>`はページ内のセクションを定義
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+いろんな要素をまとめたテンプレートの例がこれです。コピーして`blog/templates/blog/post_list.html`に貼り付けてみましょう:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. こんにちは！ よろしくお願いします！ Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. こんにちは！ よろしくお願いします！ Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+その結果、次のような結果が得られます。
+
+![図 11.4](images/step6.png)
+
+いぇーい！ ところが今のところ、私たちのテンプレートは、常に完全に**同じ情報**だけしか表示できません。一方で、以前は、テンプレートを使えば、**異なる**情報を**同じ形式**で表示できるようになるとお伝えしていたのですが。
+
+本当にやりたいことは、Djangoのadminに追加された本物の記事を表示することです。そして、それが次にやるべきことなのです。
+
+## もう一つ: デプロイしましょう！
+
+ここまでやったことを公開して、インターネットで動かしてみると楽しいですよね。PythonAnywhereでデプロイしてみましょう。
+
+### Githubに自分のコードをPushしてみよう
+
+まずは、最後に実行したときから、どのファイルを変更したか見てみましょう(以下のコマンドを、PythonAnywhereではなく、自分のパソコンで実行してください。)。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+`djangogirls` ディレクトリにいることを確認して、 `git` に対してこのディレクトリ内の変更を全て反映させるよう指示してください:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+全てのファイルをアップロードする前に、`git`が何をアップロードするのかチェックしておきましょう(`git`がアップロードする全ファイルは緑で表示されます):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+ほぼ完了です。どこを変更したかを履歴に保存するよう指示してみましょう。 何を変更したのか説明するコミットメッセージを残しましょう。 この時、どんな内容を好みで打ち込んでも構いませんが、何をしたかを具体的に書き込んでおけば、将来、作業内容を思い出す助けになるでしょう。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **注意** コミットメッセージでダブルクォーテーションを使用していることを確認してください。
+
+ここまで終われば、GitHubに変更部分をアップロード(push) しましょう。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### 新しいコードをPythonAnywhereにpullして、自分のウェブアプリを再度実行させる
+
+* [PythonAnywhereのコンソールページ](https://www.pythonanywhere.com/consoles/)を開き、**Bash コンソール**に移動してください (または新たなBash コンソールを開始してください)。それから次を実行してください。
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+`<your-pythonanywhere-domain>`を、山カッコ<>をつけずに、実際のPythonAnywhereのサブドメイン名に置き換える必要があります。 通常、サブドメイン名はPythonAnywhereユーザー名ですが、場合によっては多少異なることがあります（ユーザー名に大文字が含まれている場合など）。 このコマンドが機能しない場合は、`ls`（ファイルを一覧にする）コマンドを使用して、実際のサブドメイン名とフォルダ名を見つけ、そこに `cd` します。
+
+では、自分のコードがダウンロードされたことを確認しましょう。 それをチェックしたい場合は、**「Files」ページ** に移動して、自分のコードをPythonAnywhereの中で見てみましょう（コンソールページのメニューボタンからPythonAnywhereの他のページにアクセスできます）。
+
+* 最後に、[「Web」ページ](https://www.pythonanywhere.com/web_app_setup/)へ移動して、自分のアプリの**Reload**ボタンをクリックします。
+
+あなたのアプリが更新され、動いています！ウェブサイトを開いて、再読込してみましょう。どう変わったのか、見えるはずです。:)
\ No newline at end of file
diff --git a/ja-JP/installation/README.md b/ja-JP/installation/README.md
new file mode 100644
index 00000000000..48839651b8c
--- /dev/null
+++ b/ja-JP/installation/README.md
@@ -0,0 +1,68 @@
+# 家でチュートリアルに挑戦する方へ
+
+[Django Girls のイベント](https://djangogirls.org/events/)ではなく、あなたが一人家でこのチュートリアルに挑戦しているのであれば、このチャプターは無視して次のチャプター [インターネットのしくみ](../how_the_internet_works/README.md) に進みましょう。
+
+このチャプターがある理由は、チュートリアルで必要なもののインストールについてカバーしているからです。これは、インストール手順のすべてを一ヶ所にまとめた追加のページです（ワークショップのやり方によっては、このページは役に立ちます）。 ご希望であれば、このページにあるすべてのものを今すぐインストールすることができます。 ただ、いろんなものをパソコンにインストールする前に、一体それらが何なのかを学びたい方は、このチャプターを飛ばしてください。これ以降のページでそれらが必要になったときに、インストールの手順やその説明を行っています。
+
+がんばってね！
+
+# ワークショップに参加している方へ
+
+[Django Girlsのイベント](https://djangogirls.org/events/)の参加者のみなさん：
+
+* ワークショップDayの前に「インストールパーティ」が開催される場合があります。 あなたがインストールパーティに参加しているなら、このページをご参照ください！ 必要ならコーチの助けを借りて、このチャプターに書いてあるとおりに、ワークショップに必要なすべてのものをインストールしてみましょう。 ワークショップDayでは、以降のチュートリアルの中に出てくるインストールに関連する部分を飛ばすことができます。
+* ワークショップの主催者が、ワークショップ前に自宅であらかじめすべてをパソコンにインストールしてみるようにお願いしているかもしれません。 もしそのように言われていたのなら、このページをご参照ください！ できる限り、このチャプターに書いてあるようにやってみましょう。 その後メインのワークショップで、チュートリアルを進めて何かをインストールする箇所が出てきたときに、もしあなたができていなかったとしたら、コーチの助けを借りましょう。
+* インストールパーティが開催されない場合（またはあなたが参加できなかった場合）、そして主催者が事前のインストールをお願いしていない場合、このページは飛ばして、[インターネットのしくみ](../how_the_internet_works/README.md)のチャプターに進みましょう。 チュートリアルを進めながら、必要なものをすべてインストールします。
+
+# インストール
+
+このチュートリアルではブログを作成します。 そのために、チュートリアルを進める中で必要に応じて、さまざまなソフトウェアをコンピュータにインストールする方法や、いくつかのオンラインアカウントを設定する方法について教わります。 このページでは、インストールとアカウント作成の手順すべてを一ヶ所にまとめています（ワークショップのやり方によっては、このページは役に立ちます）。
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# コマンドラインの簡単な紹介 {#command-line}
+
+以下の手順の多くに、「コンソール」、「ターミナル」、「コマンドウィンドウ」、「コマンドライン」という言葉が出てきます。これらはすべて同じものを意味します。コマンドを入力できる、コンピュータのウィンドウです。 メインのチュートリアルに進むと、コマンドラインについてさらに学ぶことができます。 今は、コマンドウィンドウの開き方と、それがどのように見えるかを覚えましょう： {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Pythonのインストール {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# コードエディタのインストール {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# 仮想環境のセットアップとDjangoのインストール {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Gitのインストール {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+[GitHub.com](https://www.github.com)へ行って、新しく無料のユーザーアカウントを登録しましょう。パスワードを忘れないようにしてください（もしパスワードマネージャーを使っているなら、追加しましょう）。
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# 読んでみよう
+
+お疲れ様でした！これで準備が整いました。ワークショップが始まるまでに時間があれば、最初のチャプターいくつかを読んでおくとよいでしょう。
+
+* [インターネットのしくみ](../how_the_internet_works/README.md)
+
+* [コマンドラインを使ってみよう](../intro_to_command_line/README.md)
+
+* [Python入門](../python_introduction/README.md)
+
+* [Djangoってなに？](../django/README.md)
+
+# ワークショップを楽しんでください！
+
+ここまでで最初の数チャプターの内容を扱ってきたので、ワークショップでは、[プロジェクトを作成しよう！](../django_start_project/README.md)のチャプターからはじめてください。
\ No newline at end of file
diff --git a/ja-JP/intro_to_command_line/README.md b/ja-JP/intro_to_command_line/README.md
new file mode 100644
index 00000000000..0cdbc712e94
--- /dev/null
+++ b/ja-JP/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# コマンドラインを使ってみよう
+
+> 家で１人でこのチャプターに挑戦している方へ：このチャプターは、動画（英語）もあるので参考にしてください。 [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8)
+
+さぁ、これから最初のコードを書いていきますよ。楽しんでいきましょう！:)
+
+**最初にお友達になるのはコレです。: コマンドライン!**
+
+プログラマーが黒い画面に向かっている光景を見たことがありますか？ここからは、その黒い画面を触ってみます。最初はちょっとコワイと思うかもしれませんが、そんなことはありません。プロンプトと呼ばれるものがあなたの命令（コマンド）を待っています。
+
+> **備考：** このチュートリアルでは、”ディレクトリ”や"フォルダ"という用語が出てきますが、同じ意味です。
+
+## コマンドラインって何？
+
+さて、**コマンドライン** あるいは **コマンドライン インターフェイス**と呼ばれるこの画面は、キーボードで入力したテキストで命令を出してコンピューターと直接対話するように、ファイルを見たり、変更したりするものです。 グラフィカル・インターフェイスではないだけで、WindowsのエクスプローラやMacのFinderと同じ役割です。 このコマンドラインは、 *cmd*や*CLI*、*プロンプト*、*コンソール*、*ターミナル*と呼ばれることもあります。
+
+## コマンドラインインタフェースを開く
+
+では、実際にコマンドラインを開いて、触ってみることとしましょう。
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## プロンプト
+
+おそらく今、真っ白または真っ黒な画面が開かれていることでしょう。この画面はあなたの命令（コマンド）を待っています。
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+MacあるいはLinuxの方は、次のように `$` という記号が表示されていることでしょう。
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Windowsの方は、 `>` という記号が表示されていることでしょう。
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+上の Linux のセクションを見てください。このチュートリアルの後ろにある PythonAnywhere を扱うところで、似たような表示を見ることになります。
+
+<!--endsec-->
+
+各コマンドの先頭には、`$` あるいは `>` とスペース1つがつきます。コンピューターが表示してくれるので、自分で入力する必要はありません。:)
+
+> ちょっと補足です。お手元では `C:\Users\ola>` や `Olas-MacBook-Air:~ ola$` のようにプロンプト記号の前に表示があると思いますが、これは間違いではありません。
+
+`$` や `>` と書かれているところまでは、 *コマンドラインプロンプト* あるいは略して*プロンプト*と呼ばれます。プロンプトの意味は「促す」で、あなたが何か入力することを促しています。
+
+このチュートリアルでは、コマンドを入力してほしい時は、 `$` や `>` を含めて示しています（たまにこれらの左にも文字がきます）。 $ や > から左側は無視して、コマンドのみを入力してください。コマンドはプロンプトのあとに続きます。
+
+## 最初のコマンド (イェイ！)
+
+次のようにコマンドを入力してみましょう:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+そして最後に`Enterキー`を押してください。このような結果が返ってきます。
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+ご覧のとおり、コンピューターがあなたのユーザー名を表示してくれましたね。面白いでしょ？ :)
+
+> コピー＆ペーストではなく、コマンドを入力して試してみてください。そのうち自然と覚えられるようになりますからね！
+
+## 基本
+
+OSによってコマンドが若干違います。あなたのコンピューターのOS向けの説明に従って、以下は進めていってくださいね。次にいってみましょう。
+
+### カレントディレクトリ（現在のディレクトリ）
+
+今どこのディレクトリにいるか（どのフォルダで作業をしているか）、知りたいですよね？では、このようにキーボードから入力し、`Enterキー`を押してください。
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> 補足: 'pwd' は'print working directory'の略で、現在いる作業ディレクトリを表示することを意味します。
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+おそらく、あなたのマシン上でも似たような表示がされたのではないでしょうか。コマンドラインを起動すると、通常はユーザーのホームディレクトリがカレントディレクトリになります。
+
+* * *
+
+### コマンドについてもっと知る
+
+コマンドプロンプトに入力するコマンドの多くには、表示して読むことができるヘルプ機能が備わっています！例として、カレントディレクトリを表示するコマンドについてみてみましょう:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X と Linux には、`man` コマンドがあり、それはコマンドのヘルプを提供します。 `man pwd` を試してみましょう。他のコマンドも、コマンドの前に `man` と書き、ヘルプを見てみましょう。 `man` の出力は、通常はページ単位で表示されます。 次のページに移動するにはスペースキーを使います。 ヘルプを見るのをやめるには `qキー` を押します。
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+ほとんどのコマンドでは、コマンドの後ろに `/?` をつけて実行するとヘルプページが出力されます。すべての出力を見るには、コマンドラインを上にスクロールする必要があるかもしれません。`cd /?` を試してみましょう。
+
+<!--endsec-->
+
+### ファイルとディレクトリの一覧
+
+では、カレントディレクトリの中には何があるのでしょうか？表示させてみましょう。
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### カレントディレクトリの変更
+
+次に、デスクトップ(Desktop)というディレクトリに移動してみましょう。
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Desktop というディレクトリ名は、使用しているLinuxアカウントの言語に翻訳されているかもしれません。 その場合は、 `Desktop` を翻訳された名前に置き換えてください; たとえば、ドイツ語なら `Schreibtisch` です。
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+本当に変更されたかどうか確認してみてください：
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+できていますね！
+
+> プロのコツ: `cd D` と入力して、キーボードの`Tabキー`を押してください。すると、Dに続く残りの部分が自動的に補完されるので、より早く入力することができます。 もし、Dから始まるディレクトリ名が他にもあれば、`Tabキー`を2度押すと候補の一覧が表示されます。
+
+* * *
+
+### ディレクトリの作成
+
+それでは、practice ディレクトリをデスクトップに作成してみましょう。
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+この短いコマンドで、デスクトップに `practice` という名前のディレクトリが作成されました。 デスクトップを見るとディレクトリが作成されていることを確認できます。あるいは、先ほど学んだコマンド `ls` や `dir` を使っても確認できます。 やってみてください。 :)
+
+> プロのコツ: 同じコマンドを何度も入力したくない時は、キーボードの上下矢印キー `↑`、`↓` を押せば、最近使用したコマンドが現れます。内容を修正したい場合には，左右矢印キー←，→を利用して修正したい位置にカーソルを移動させることができますよ。
+
+* * *
+
+### 練習！
+
+練習をしてみましょう。先ほど作成した `practice` ディレクトリの中に、`test` という名前のディレクトリを作成してください。(使うコマンドは、`cd` と `mkdir` ですよ)
+
+#### 解答:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+おめでとうございます！よくできました！ :)
+
+* * *
+
+### 片付け
+
+練習で作ったものをそのまま置いておくと邪魔になりますね。練習がおわったら、削除しましょう。
+
+はじめに、作業するディレクトリをデスクトップに戻しましょう。
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+`cd` の後にある `..` で、カレントディレクトリを親ディレクトリに変更します。(今作業しているディレクトリのひとつ上のディレクトリに移動するということですね。)
+
+現在の作業ディレクトリを確認しておきましょう:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+では、`practice` ディレクトリを削除しましょう:
+
+> **注意**: `del` や `rmdir `、`rm` コマンドを使って削除したファイルは元に戻せません。*完全に消えてしまいます*！ これらのコマンドを使う時は、よく気をつけてくださいね。
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+できました！本当に削除されたか、確認してみましょう:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### 終了
+
+今回はここまでです。それではコマンドラインを終了しましょう。かっこいいやり方で終了したいですよね? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+かっこいいでしょう? :)
+
+## まとめ
+
+役立つコマンドをいくつかまとめておきます。
+
+| コマンド (Windows) | コマンド (Mac OS / Linux) | 説明                | 例                                                    |
+| -------------- | --------------------- | ----------------- | ---------------------------------------------------- |
+| exit           | exit                  | ウインドウを閉じる         | **exit**                                             |
+| cd             | cd                    | ディレクトリを変更         | **cd test**                                          |
+| cd             | pwd                   | 現在のディレクトリを表示      | **cd** (Windows) あるいは **pwd** (Mac OS / Linux)       |
+| dir            | ls                    | ディレクトリ/ファイルの一覧を表示 | **dir**                                              |
+| copy           | cp                    | ファイルのコピー          | **copy c:\test\test.txt c:\windows\test.txt**    |
+| move           | mv                    | ファイルを移動           | **move c:\test\test.txt c:\windows\test.txt**    |
+| mkdir          | mkdir                 | 新しいディレクトリを作成      | **mkdir testdirectory**                              |
+| rmdir (or del) | rm                    | ファイルを削除           | **del c:\test\test.txt**                           |
+| rmdir /S       | rm -r                 | ディレクトリを削除         | **rm -r testdirectory**                              |
+| [CMD] /?       | man [CMD]             | コマンドのヘルプを表示       | **cd /?** (Windows) あるいは **man cd** (Mac OS / Linux) |
+
+ここで勉強したのはコマンドのほんの一部でしたが、このワークショップで使うコマンドはこれだけです。
+
+もっと勉強したい方は、[ss64.com](http://ss64.com) に各OSのコマンド一覧があります。ご参考までに。
+
+## 準備OK？
+
+よし、次はPythonを勉強していきましょう！
\ No newline at end of file
diff --git a/ja-JP/intro_to_command_line/open_instructions.md b/ja-JP/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..a33591cf49a
--- /dev/null
+++ b/ja-JP/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+使用しているWindowsのバージョンとキーボードによりますが、以下のいずれかの方法でコマンドラインを開けるはずです(いくつか試す必要があるかもしれませんが、これらの方法のすべてを試す必要はありません):
+
+- [スタートメニュー] あるいはスタート画面の検索ボックスに「コマンドプロンプト」と入力しましょう。
+- [スタートメニュー] → [Windows システムツール] → [コマンドプロンプト] を選択しましょう。
+- [スタートメニュー] → [すべてのプログラム] → [アクセサリ] → [コマンドプロンプト] を選択しましょう。
+- スタート画面を開き、画面の左下隅にマウスをかざすと下矢印が表示されるのでクリックします（タッチパネルの場合は、代わりに画面の下から上に向かってフリックしましょう）。 アプリのページが見えるはずです。 [Windows システムツール] から [コマンドプロンプト] をクリックしましょう。
+- キーボードの [Windows キー] を押しながら [X キー] を押します。 ポップアップメニューが表示されるので [コマンドプロンプト] を選択しましょう。
+- [Windows キー] を押しながら [R キー] を押すと [ファイル名を指定して実行] というウィンドウが立ち上がります。 「cmd」と入力して [OK] をクリックしましょう。
+
+!["ファイル名を指定して実行" ウィンドウで "cmd" と入力](../python_installation/images/windows-plus-r.png)
+
+このチュートリアルの後ろの方では、同時に2つのコマンドラインを開く場面があります。 しかし、Windowsのいくつかのバージョンでは、コマンドラインをすでに1つ開いている状態で2つ目を同じ方法で開こうとした場合、すでに開いている1つ目のコマンドラインが参照されてしまうことがあります。 自分のコンピュータ上で試してみて何が起こるか見てみましょう！ コマンドラインが一つしか開かない場合は、上のリストにある他の方法を試してみてください。 上にあるいずれかの方法で新しいコマンドラインを開けるはずです。
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+[アプリケーション] → [ユーティリティ] → [ターミナル] を選択しましょう。
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+使用しているシステムによりますが、[アプリケーション] → [アクセサリ] の下、あるいは [アプリケーション] → [システム] の下に [ターミナル] があるでしょう。 もしそこに見当たらない場合は、Googleで検索してみましょう。 :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ja-JP/python_installation/README.md b/ja-JP/python_installation/README.md
new file mode 100644
index 00000000000..eaa7710236c
--- /dev/null
+++ b/ja-JP/python_installation/README.md
@@ -0,0 +1,15 @@
+# Pythonをはじめよう
+
+ついにここまで来ましたね！
+
+まずは、最初にPythonとは何かお話させて下さい。Pythonはとても人気のあるプログラミング言語です。Webサイトや、ゲーム、サイエンス、グラッフィックス、などなど、たくさんの場面で使われています。
+
+Pythonは1980年代の終わりに、人間が読みやすい（機械だけでなく）言語を目的に開発されました。 だから、他の言語に比べて、Pythonはとてもシンプルで、勉強しやすいのです。でもご心配なく、Pythonはとってもパワフルな言語ですから！
+
+# Pythonのインストール
+
+> **注意：**Chromebookをお使いの場合、このチャプターは飛ばして、[Chromebookのセットアップ](../chromebook_setup/README.md)の章をすすめてください。
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ja-JP/python_installation/instructions.md b/ja-JP/python_installation/instructions.md
new file mode 100644
index 00000000000..05f857be17d
--- /dev/null
+++ b/ja-JP/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> 家で１人でこのチャプターに挑戦している方へ：この章は、動画（英語）もあるので参考にしてください。 [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA)
+> 
+> このセクションはGeek Girls Carrots (https://github.com/ggcarrots/django-carrots) のチュートリアルをベースに作成しました。
+
+DjangoはPythonで書かれています。 Djangoを使うにはPythonが必要です。 では、インストールするところから始めましょう！ 最新のPython３をインストールしてください。それ以前のPythonがインストールされていたら、アップグレードする必要があります。 もしあなたが{{ book.py_min_version }}かそれ以上のバージョンを持っているのなら大丈夫です。
+
+下に書いたとおりのやり方で、Pythonをインストールしてください。すでにAnacondaが入っていても以下のとおりにインストールしてください。
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+まず、今使っているWindowsが32-bit版か64-bit版か確認しましょう。システム情報の”システムの種類”を確認してください。これを見る方法はいくつかあるので、次のうち１つをやってみましょう：
+
+* WindowsキーとPause/Breakキーを同時に押します。
+* Windowsのスタートからコントロールパネルを開き、”システムとセキュリティ”、”システム”と順にクリックします。
+* Windowsロゴをクリック、設定 > システム > バージョン情報 とクリックしていきましょう。
+* Windowsのスタートメニューから「システムの詳細設定」を検索します。 これを行うためには、スタートのボタンをクリックするかWindowsキーを押して、`システムの詳細設定`を入力し始めます。 入力するとすぐに候補を提案します。 表示されたら、選択することができます。
+
+https://www.python.org/downloads/windows/ からWindows版のPythonをダウンロードできます。 "Latest Python 3 Release - Python x.x.x" というリンクをクリックします。 あなたのWindowsが**64-bit版**なら、**Windows x86-64 executable installer**をダウンロードしてください。 そうでなければ**Windows x86 executable installer**をダウンロードしてください。 インストーラーがダウンロードできたら、ダブルクリックして実行し、指示に従ってください。
+
+インストールの途中で、「Setup」というタイトルのウィンドウがでてきたら注意してください。 以下に書かれてあるように（インストールしているバージョンが違った場合は表示されている内容が少し異なるかもしれません）、"Python {{ book.py_version }} to PATH" か "Add Python to your environment variables" のチェックボックスをチェックし、"Install Now"をクリックします。
+
+![Pythonのパスを通すのを忘れないようにしてください。](../python_installation/images/python-installation-options.png)
+
+インストールが終わったら、ダイアログボックスが出てきます。ボックス内のリンクを開くと、Pythonやインストールしたバージョンを説明したページに行けます。 ダイアログは閉じてしまいましょう。Pythonの使い方はこのチュートリアルでたっぷり勉強します！
+
+注意: もしあなたが古いバージョンのWindows(7, Vistaなど)使用している場合、Python {{ book.py_version }} インストーラーはエラーを起こし失敗します。Windowsアップデートをインストールし再度Pythonをインストールしてください。 もしもエラーが起こり続けているのなら、Python バージョン {{ book.py_min_release }} を[Python.org](https://www.python.org/downloads/windows/)からダウンロードしてみてください。
+
+> Django {{ book.django_version }} はWindows XP以前のバージョンがサポートしていない Python {{ book.py_min_version }} 以上のバージョンを必要とします。
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **注意** OS X にPython をインストールする前に、Mac の設定がApp Store以外からのパッケージのインストールを許可しているか確認してください。 Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+https://www.python.org/downloads/mac-osx/ のウェブサイトから最新のPython のインストーラーをダウンロードします。
+
+* *Mac OS X 64-bit/32-bit installer* というファイルをダウンロードします。 
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+おそらく殆どの場合は、すでに Python をインストールしていると思います。Python をインストールしているか確認するために（またどのばーじょんかかを）、コンソールを開いて以下のコマンドをうってください。
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+異なるバージョンの Python をインストールしている場合、少なくとも{{ book.py_min_version }} （例: {{ book.py_min_release }}）、アップグレードの必要はありません。 Pythonがインストールされていなかったり、異なるバージョンをインストールしたい場合は、はじめに下記のコマンドでどの Linux ディストリビューションを使っているか確認してください。
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+その後、結果によって、以下のセクションのいづれかのインストール手順に従います。
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+次のコマンドをコンソールに打ち込みます。
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+次のコマンドをコンソールで使用します。
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+Fedora バージョンが古い場合は、`dnf`が見つかりませんというエラーが起きるかもしれません。その場合は、`yum` を変わりに使用してください。
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+以下のコマンドをコンソールで使用してください。
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+インストールが成功しているか確認するために、コマンドプロンプトを開いて`Python3`コマンドを使用します。
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+表示されているバージョンは{{ book.py_release }} と異なるかもしれません。あなたがインストールしたバージョンが表示されています。
+
+**注意:**Windowsでpython3は見つかりませんというエラーが出たときは、python（`3抜きで`）実行してみてください。そして、{{ book.py_min_version }} 以降のバージョンが表示されているか確認してください。 どちらもうまく行かない場合は、新しくコマンドプロンプトを開いて再び試してみてください。Pythonのインストール前にコマンドプロントを開き続けていると、これが起こります。
+
+* * *
+
+なにか疑問や上手く行かないことがある時、また次に何をすればいいかわからに時は、コーチに質問しましょう。 時々上手く行かないときもあります。そんなときは、経験豊富な人に聞くのが良いです。
\ No newline at end of file
diff --git a/ja-JP/python_introduction/README.md b/ja-JP/python_introduction/README.md
new file mode 100644
index 00000000000..7fac2ab6b56
--- /dev/null
+++ b/ja-JP/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Python入門
+
+> このチャプターの一部はGeek Girls Carrotsのチュートリアルをもとにしています。(https://github.com/ggcarrots/django-carrots)
+
+さあ、コードを書いてみましょう！
+
+## Pythonプロンプト
+
+> 家で１人でこのパートに挑戦している方へ：このパートと続くパートは、動画（英語）もあるので参考にしてください。 [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U)
+
+Pythonであそぶために、*コマンドライン* を開きましょう。 やり方は、チャプター [コマンドラインを使ってみよう](../intro_to_command_line/README.md) で学びましたね。
+
+準備ができたら、次の指示に従ってやってみましょう。
+
+Pythonコンソールを開きましょう。Windowsなら `python` 、Mac OSやLinuxなら `python3` とタイプして `Enter` キーを押してください。
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## 最初のPythonコマンド！
+
+Pythonのコマンドが走ると、プロンプト記号が `>>>` に変わりました。 これは、今Pythonの言語を実行できますという意味です。 `>>>` はタイプしなくていいですよ – Pythonがあなたの代わりにやってくれます。
+
+Pythonコンソールを終了したい時は、`exit()` とタイプするか、ショートカット `Ctrl + Z`（Windows）、`Ctrl + D`（Mac/Linux）を使ってください。 そうするともう `>>>` は出なくなります。
+
+けど、今はまだコンソールを終了しないで、もっと動かして学びましょう。簡単な計算からはじめましょう。`2 + 3` とタイプして、`Enter` キーを押してください。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+できました！答えがでてきましたね。Pythonは計算ができます。他にも、次のようなコマンドを試してみましょう。
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+2の3乗のような指数の計算は、次のようにタイプします。{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+ちょっとの間楽しんであそんでみたら、またココに戻ってきてくださいね。:)
+
+お分かりのとおり、Pythonはステキな計算機ですね。他になにができるんだろう…と思ったら、次にいってみましょう。
+
+## 文字列
+
+あなたのお名前を次のようにクォーテーションをつけてタイプしてください。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+はじめてのString（文字列）が完成です！ Stringとは、文字の集合のことです。 シングルクォーテーション (`'`) あるいは、ダブルクォーテーション (`"`) で囲います。 最初と最後は同じ記号にしてください。 クォーテーションの中が文字列であることを意味しています。
+
+複数の文字列を結合することもできます。次のように試してみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+文字列を繰り返すためには、演算子を使って繰り返し回数を指定することもできます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+アポストロフィーを文字列の中に含めたい場合は、２通りの方法があります。
+
+まずは、ダブルクォーテーションを使う方法です。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+あるいは、バックスラッシュ (``) を使う方法もあります。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+できましたか？次に、あなたの名前を大文字に変えてみましょう。次のように記述してください。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+ここで `upper` **関数 (function)** を使うことができましたね！ 関数 ( `upper()` など) は、呼び出したオブジェクト ( `"Ola"` のことです) に対してどのような手順でどのような処理をするかをひとまとめにしたものです。
+
+あなたの名前の文字数を知りたいときは、その **関数 (function)** もあります！
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+どうして、文字列の後に `.` をつけて関数を呼び出したり ( `"Ola".upper()` のように)、あるいは、先に関数を呼び出してかっこの中に文字列をいれているのか、と疑問に思ったかもしれません。 そうですね。時に、オブジェクトに結びついた関数というのがあります。例えば、`upper()` は、文字列にのみ実行される関数です。 私たちはこれを **メソッド (method)** と呼びます。 それとは別に、特定のオブジェクトに関連せず、異なるタイプのオブジェクトに対して実行できる関数があります。例えば `len()` ですね。 `len` 関数の引数として `"Ola"` をかっこの中にいれているのです。
+
+### まとめ
+
+文字列はだいじょうぶですね。ここまでに学んだことをまとめましょう。
+
+- **プロンプト** – Pythonプロンプトにコマンド（コード）を入力すると、答えがかえってきます。
+- **数値と文字列** – 数値は計算に、文字列はテキストに使われます。
+- **演算子** – 例えば `+` や `*` のように、値を計算して新しい値を返します。
+- **関数** – `upper()` や `len()` のようにオブジェクトに対して行う機能のことです。
+
+すべてのプログラミング言語に共通する基礎になります。 もう少し難易度の高いものに挑戦してみましょう。準備はいいですか？
+
+## エラー
+
+さて、新しいことをやってみましょう。あなたの名前の文字数を数えたように、数字の文字数は数えられるでしょうか？ `len(304023)` と記述して、`Enter` キーを押してみましょう。
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+はじめてのエラーがでました！ {{ warning_icon }} アイコンのついたコードは思ったように動かないコードです。 （今回はチュートリアルで用意されていましたが）思ったように動かないことは学ぶ上で大事です！
+
+オブジェクトタイプ"int" (integers, 数値) は文字数がありませんと言っています。では、どうすればよいでしょうか？この数字を文字列として扱えれば、文字数を数えられるはずですよね？
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+うまく行きました！ `str` 関数を `len` のかっこの中に記述しました。`str()` はその中身を文字列に変換します。
+
+- `str` 関数は、**文字列** に変換します。
+- `int` 関数は、文字列や数値を **整数** に変換します。
+
+> 重要！: 数字は文字列にすることはできますが、全ての文字が数字に変換できるわけではありません。 例えば `int('hello')` は数字にはなりませんよね？
+
+## 変数
+
+変数（variables）は、プログラミングの重要なコンセプトです。 後で使うためにつける単なる名札ではありません。 プログラマーは変数を使ってデータを保管したり、 コードを読みやすくして、後でそれが何だったか覚えておかなくてもいいようにします。
+
+変数 `name` を新しくつくってみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+name イコール（=）"Ola" とタイプします。
+
+見てのとおり、プログラムは、なにも返してくれませんね。では、変数がきちんとあるか、どうやって確かめたらいいのでしょうか？ `name` とタイプして、`Enter` キーを押してください。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+やりました！あなたのはじめての変数ができましたね！代入する値を変えることもできます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+変数には関数も使えます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+素晴らしいですね！変数は、数値にも使えますよ。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+もしも、間違えた変数名を使ってしまったら、どうなるでしょうか？予想できますか？やってみましょう！
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+エラーになりました！ 前回とは違うエラータイプです。**NameError** という、初めてみるエラータイプですね。 作成されていない変数を使った時は、Pythonがエラーを教えてくれます。 もし、このエラーに出くわしたら、記述したコードにタイプミスがないか確認してください。
+
+ちょっと遊んで、何ができるか試してみてくださいね！
+
+## print 関数
+
+次に挑戦してみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+単に `name` とタイプした時は、Pythonインタプリタが、変数'name'の文字列*表現（representation）*を返します。ここでは、シングルクォーテーション（''）に囲まれた M-a-r-i-aという文字の集まりです。 しかし、`print(name)`と記述した時は、Pythonは変数の中身を出力します。クォーテーションはありません。
+
+これからさらに詳しくみていきますが、`print()` は、関数から出力をする時や、複数行の出力を行うときにも便利です。
+
+## リスト
+
+数値と文字列の他にも、すべてのオブジェクトタイプを勉強しておきましょう。 今から**list** というものを紹介していきます。 リストは、その名のとおり、オブジェクトの並びをもつものですね。 :)
+
+まずはリストを作りましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+はい、このリストは空っぽです。使いにくいですよね。では、くじ引きの番号のリストを作りましょう。 この番号を何度も繰り返し書きたくはないから、同時に変数に代入してしまいましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+よし、これでリストができました！このリストで何をしましょうか？では、くじ引きの番号がいくつあるか、数えてみましょう。何の関数を使えばいいか、予想できますか？すでに知っていますよね！
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+そうです！`len()` がリストにあるオブジェクトの数を取得できます。便利ですね。では、くじ引きの番号をソートしてみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+これは何も返してきません。これはリストに表示される番号を、順番に並べ替えただけです。再度出力して、確かめてみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+ご覧のとおり、小さい順に並び替えられましたね。おめでとう！
+
+逆順に並び替えてみたくなりましたか？やってみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+リストに何かを追加したいときは、次のようにコマンドを記述してください。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+最初の数字だけを出力したいときは、**インデックス(index)** を使って指定することができます。 インデックスは、アイテムがリストのどこにあるかを指す番号です。 リストの先頭の要素から順に「０」、次に「１」と割り当てられています。 次のとおり試してみてください。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+このように、リスト名と要素のインデックスを [] に記述することで、指定した要素を取り出すことができます。
+
+リストから要素を消すには、これまで学んできたインデックスと `pop()` メソッドを使います。 例で試してみましょう。リストの最初の要素を削除しています。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+お見事！
+
+他のインデックスも試して遊んでみてください。例えば、 6, 7, 1000, -1, -6, -1000 などをインデックスに指定するとどうなるでしょうか。コマンドを実行する前に予測してみましょう。結果はどうですか？
+
+ご参考に、こちらのドキュメントにリストメソッドがすべて記されています。 https://docs.python.org/3/tutorial/datastructures.html
+
+## 辞書（ディクショナリ）
+
+> 家で１人でこのパートに挑戦している方へ：このパートは、動画（英語）もあるので参考にしてください。 [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c)
+
+辞書(ディクショナリ)について確認しましょう。リストに似ていますが、インデックスのかわりにキーと呼ばれる識別子で値を参照します。キーは文字列も数値も使えます。ディクショナリは次のように `{}` 括弧で囲んで作成します。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+これで中身が空っぽのディクショナリができましたね。やったね！
+
+では、つぎのコマンドを記述してみましょう。 (あなた自身の情報に値をおきかえてみてもいいですよ）
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+このコマンドで、`participant` という名前の変数をつくって、３つのキーと値をもつ要素を作成しました。
+
+- キー `name` が指す値は `'Ola'` (`string` オブジェクト)
+- キー `country` が指す値は `'Poland'` (`string` オブジェクト)
+- キー `favorite_numbers` が指す値はリスト `[7, 42, 92]` (数字を3つ持つ`list`)
+
+次のように書くと各キーの値を確認できます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+リストに似ていますね。しかし、ディクショナリでは、インデックスを覚えておく必要がなく、キーの名前でいいのです。
+
+もし存在しないキーを参照しようとすると、どうなるでしょうか？予想できますか？実際にやってみましょう！
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+またエラーです。今回は **KeyError** というエラーが出ました。Pythonは、このディクショナリにキー `'age'` は存在しませんよ、と教えてくれています。
+
+ディクショナリとリストはどう使い分ければよいのでしょうか？そうですね、これはゆっくり考えてみるべきポイントですね！この後の行を読むまえに、答えを考えてみてください。
+
+- 必要なのは、順序付けられた一連のアイテムですか？　リストを使いましょう。
+- キーに対応する値が必要？キーから値を参照する？　ディクショナリを使いましょう。
+
+ディクショナリやリストは、作ったあとに変更できるオブジェクトです。これを *mutable* と呼びます。次のように、ディクショナリを作ったあとで、新しいキーと値を追加することができます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+お分かり頂けたでしょうか。 :) では、ディクショナリを使ってもう少し練習してみましょう。準備ができたら、次の行にいってみましょう。
+
+ディクショナリの要素を削除する時は、`pop()` メソッドを使います。 例えば、 キー `'favorite_numbers'` の要素を削除するには、次のように記述してください。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+このように、`'favorite_numbers'` のキーと値が削除されます。
+
+同様に、次のように記述することで、すでにあるキーの値を変更することができます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+これで、キー `'country'` の値は、`'Poland'` から `'Germany'` に変わりました。面白くなってきましたか？その調子です！
+
+### まとめ
+
+素晴らしいです！これで、あなたはプログラミングについて沢山のことを学びました。ここまでのところをまとめましょう。
+
+- **エラー** – あなたのコマンドをPythonが理解できない時にエラーが表示されます。
+- **変数** – コードを簡単にまた読みやすくするために、文字や数値などのオブジェクトにつける名札。
+- **リスト** – 複数の値（要素）が順に並んでいるもの。
+- **ディクショナリ** – キーと値のペアの集合です。
+
+次に進む準備はいいですか？ :)
+
+## 比較
+
+> 家で１人でこのパートに挑戦している方へ：このパートは、動画（英語）もあるので参考にしてください。[Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4)
+
+比較することは、プログラミングの醍醐味の１つです。簡単に比較できるものといえば、何でしょうか？そうです、数字ですね。さっそくやってみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+２つの数字がイコールであるかどうかを比べる時に、イコールの記号が２つ `==` 並んでいます。 Pythonを記述する時、イコール１つ `=`は、変数に値を代入するときに使います。 ですので、値同士が等しいかどうか比較するときは、必ず **必ず** イコール記号２つ `==` を記述してください。 等しくないことを比較するときは、 上記の例のように `!=` と記述します。
+
+次の２つはどうでしょうか。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+`>` と `<` は簡単でしたね。`>=` と `<=` はどうでしょうか？それぞれの意味は、次のとおりです。
+
+- x `>` y : x は y より大きい
+- x `<` y : x は y より小さい
+- x `<=` y : x は y 以下
+- x `>=` y : x は y 以上
+
+すばらしい! もう少しやってみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+複数の数値を比較して複雑になっても、その答えを出してくれます。とても賢いですね。
+
+- **and** – `and` の左辺と右辺が共にTrueの場合のみ、True。
+- **or** – `or` の左辺あるいは右辺の少なくとも１つがTrueの時、True。
+
+"comparing apples to oranges"という英語の表現を聞いたことはありますか？文字通り訳すと「リンゴとオレンジを比較する」となり、「比較にならないものを比較する」という意味です。Pythonでも同じようなことをやってみましょう。
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Pythonは、数値(`int`)と文字列(`str`)の比較はできません。 **TypeError** とエラーが表示され、２つのオブジェクトタイプが比較できないことを教えてくれています。
+
+## ブール型（Boolean）
+
+偶然にも、**ブール型 (Boolean)** というあたらしいオブジェクトタイプを学びました。
+
+ブール型は、たった２つの値を持ちます。
+
+- True
+- False
+
+Pythonを記述するときは、Trueの最初は大文字のT、残りは小文字です。 **true, TRUE, tRUE は間違いです。– True と記述してください** （False についても同様です。）
+
+ブール型は、次のように変数に代入することもできます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+このようなこともできます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+ブール型を使って、練習して遊んでみましょう。次のコマンドを試してみてください。
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+おめでとうございます！ブール型を理解することは、プログラミングでとても大事です。ここまでできましたね！
+
+# 保存しよう！
+
+> 家で１人でこのパートに挑戦している方へ：このパートと続くパートは、動画（英語）もあるので参考にしてください。[Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk)
+
+ここまでインタプリタでPythonのコードをかいてきました。つまり、コードを１行ずつしか書くことができませんでした。 普通のプログラムはファイルに保存され、**インタプリタ** あるいは **コンパイラ** でプログラミング言語を処理して実行します。 ここまで、私たちはプログラムを１行ごとにPython **インタプリタ** で実行してきました。 ここからは、１行以上のコードを実行していきましょう。次のような流れになります。
+
+- Pythonインタプリタを終了します。
+- お好きなエディタを起動します。
+- Pythonファイルとしてコードを保存します。
+- 実行します！
+
+これまで使っていたPythonインタプリタを終了しましょう。`exit()` 関数を入力してください。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+これで、コマンドプロンプトに戻りました。
+
+前に、[コードエディタ](../code_editor/README.md)セクションからエディタを選択しました。 ここでエディタを開いて、新しいファイルにコードを書き込んでみましょう（Chromebookを使用している場合は、Cloud IDEで新しいファイルを作成し、そのファイルを開きます。ファイルをcloud IDEに含まれたコードエディタで開いています）。
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+あなたは、すでにベテランのPython開発者です。今日学んだコードを自由に書いてみてください。
+
+コードを書いたら、わかりやすい名前をつけて保存しましょう。 **python_intro.py** と名前をつけて、デスクトップに保存してください。 ファイル名は何でもかまいません。ここで重要なことは、拡張子を **.py** とすることです。 コンピュータにこのファイルは **Pythonで実行するファイルです** とおしえます。
+
+> **メモ** コードエディタでは色に注目しましょう！これはとてもクールです。 Pythonコンソールでは、すべての文字は同じ色です。エディタでは、`print` 関数は文字列とは違う色がつきます。 これは「シンタックスハイライト」と呼ばれています。エディタは構文（シンタックス）を強調（ハイライト）します。コードを書くとき、これはとても役に立ちます。 色のおかげで、文字列の最後のクォーテーションの書き忘れや、キーワードの名前（この後学ぶ関数の `def` など）のタイポに気づくことができます。 これが私たちがコードエディタを使う理由の１つです. :)
+
+ファイルを保存したら、実行してみましょう！コマンドラインのセクションで学んだことを思い出して、ターミナルの **ディレクトリを変更** して、デスクトップにしましょう。
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Macでは、コマンドは次のようになります。
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Linuxでは、次のようになります。
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+（「Desktop」という単語はあなたの地域の言語に翻訳される場合があります。）
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+Windowsのコマンドプロンプトでは、次のようになります。
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+WindowsのPowerShellでは、次のようになります。
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+うまくできない時は、質問してください。まさにそのためにコーチがここにいるんです！
+
+ではPythonを使用して、ファイル内のコードを次のように実行します。
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+注：Windowsでは「python3」はコマンドとして認識されません。代わりに「python」を使ってファイルを実行します。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+できました！ファイルに保存された初めてのPythonプログラムを実行できたのです。すばらしいですね。
+
+では、ここからプログラミングに不可欠なツールを学んでいきましょう。
+
+## If … elif … else
+
+ある条件が成立するときにだけコードを実行したいということがよくあります。そのためにPythonでは **if文** を用います。
+
+**python_intro.py** ファイルのコードを次のように書き換えてください。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+もしこれを保存して実行すると、次のようなエラーが出ます。
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+`3 > 2` という条件が成立する（ `True` となりますね）時に実行される処理を、まだ記述していませんね。 では、Python に “It works!” と出力してもらいましょう。 **python_intro.py** ファイルの中身を、次のとおりに書き換えてください。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+2行目をスペース4つでインデント（字下げ）していることに気が付きましたか？ 条件が成り立つ時にどのコードを実行するかPythonが分かるように、インデントする必要があります。 スペース1つでもできますが、Pythonプログラマーはほぼ全員スペース4つとしています。 エディタの設定により、タブ1つもスペース4つと同じになります。 タブかスペースか決めたら、変えないようにしましょう。 例えばスペース4つでインデントしたら、この後もスペース4つでインデントするようにしましょう。インデントにスペースとタブを混ぜてしまうと問題が発生してしまうことがあります。
+
+保存して、もう一度実行してみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+注：Windowsでは「python3」はコマンドとして認識されないことを思い出してください。これから先、ファイルを実行するときは「python3」の代わりに「python」とタイプしてくださいね。
+
+### 条件がTrueじゃないときは？
+
+前述の例では、if文の条件が True の時だけコードが実行されました。Pythonは、`elif` や `else` といった記述もできます。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+これを実行した場合、次のように出力されます。
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+もし2が5より大きかったら、4行目のコマンドが実行されます。では、`elif` はどうなるのでしょうか？
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+実行すると...
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+どうなったかわかりましたか？ `elif` を使って、前に書いた条件が成立しない場合に実行される条件を追加することができます。
+
+最初の `if` の後に、好きなだけ `elif` を追加することができます。例えば...
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Pythonは上から順番に各条件をテストして実行し、次のように出力します。
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## コメント
+
+コメントは `#` で始まる行です。`#` の後にはなんでも書くことができ、Pythonはそれを無視します。コメントを書いたコードは、ほかの人にとってもわかりやすくなります。
+
+実際にはこのようになります。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# ボリュームが大きすぎたり小さすぎたりしたら変更する
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+コードのすべての行にコメントを書く必要はありません。コメントには、コードの中である処理をする理由や、複雑なコードの動きのまとめを書くと役に立ちます。
+
+### まとめ
+
+これらの練習を通して、学んだことは...
+
+- **比較** – 比較に用いる `>`, `>=`, `==`, `<=`, `<` そして`and`, `or` といった演算子があります。
+- **ブール型** – `True` と `False` 2つの値のみを持ちます。
+- **ファイルの保存** – コードはファイルに保存することで、大きなプログラムも実行できます。
+- **if … elif … else** – 条件分岐することで、特定の条件によって処理を分けて実行することができます。
+- **コメント** – あなたがコードについて記述できる行。Pythonは実行しません。
+
+では、いよいよこのチャプターの最後のパートです！
+
+## 自作の関数！
+
+> 家で１人でこのパートに挑戦している方へ：このパートは、動画（英語）もあるので参考にしてください。[Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0)
+
+Pythonでは `len()` のように関数が実行できるのを覚えていますか？ ここでは、自分で関数を作る方法を学びます。
+
+関数は、Pythonが実行する一連の命令をひとまとめにしたものです。 Pythonでは、関数は `def` というキーワードからはじまり、名前をつけ、引数を含むことができます。 やってみましょう。 **python_intro.py** の中身を下記のコードに置き換えてください。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+よし！あなたの最初の関数を実行する準備ができましたね！
+
+ここであなたは、最後の行になぜ関数の名前を書いたのだろう、と疑問に感じたかもしれません。 `def hi():` とそれに続くインデントされた数行を書くと、これは `hi()` という関数が何をすべきかという命令を書いたことになります。 Pythonはこれらの命令を読み込み記憶しますが、関数はまだ実行されません。 関数を実行したいとPythonに伝えるには、 `hi()` として関数を呼び出す必要があります。 Pythonはファイルを読み込み、先頭から末尾へと実行するので、関数を呼び出す前に定義しなければならないのです。
+
+では実行して、どうなるか見てみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+注：思ったように動かなくても慌てないで！画面の出力は動かない理由をつかむのに役立ちます。
+
+- `NameError` が出ている場合、おそらく何かミスタイプがあります。同じ名前を使っているかチェックしましょう。関数を定義するときは `def hi():` としていますか？関数を実行するときは `hi()` としていますか？
+- `IndentationError` が出ている場合、`print` 関数の2行が同じ数のスペースでインデントされているかチェックしましょう。関数の中のコードは同じ数のスベースでインデントされているとPythonは考えます。
+- 画面に何も表示されていない場合、最後の `hi()` がインデントされて *いない* かチェックしましょう - もしインデントされていたら、関数の一部になってしまっています。関数が呼び出されていません。
+
+次に引数をつかった関数を作ってみましょう。先ほどの例を変更し、人の名前を呼んで 'hi' と挨拶をする関数にしてみます。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+ご覧のように、関数に `name` という引数を与えました。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+要確認：`print` 関数は、` if `文の中で4つのスペースでインデントします。 これは、条件が満たされたときに関数が実行されるためです。 では、どのように動くか見てみましょう。
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+おっと、エラーがでてしまいました。 ラッキーなことに、Pythonがかなり役に立つエラーメッセージを表示してくれています。 定義した関数 `hi()` は、`name` という引数が必要ですが、関数を呼び出す時に引数を忘れてしまっているということがわかります。 最後の行を修正しましょう。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+実行してください。
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+では、名前を変えてみたらどうなりますか？
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+実行してください。
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+では、OlaやSonja以外の名前に変えた時、どうなるかわかりますか？やってみて、予測が正しいか確認して下さい。このように出力されます。
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+すごいでしょ？ 挨拶をする人の名前を変えるたびに繰り返しコードを書く必要がなくなりました。 これが関数を作る理由です。何度も繰り返してコードを書きたくないですよね！
+
+もっとスマートにしてみましょう。名前が2つよりも多いと、それぞれの名前に対して条件を書くのは大変じゃないですか？ファイルの内容を下記のように書き換えてください。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+では、実行してみましょう:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+おめでとうございます！関数の書き方を学びましたね！:)
+
+## ループ
+
+> 家で１人でこのパートに挑戦している方へ：このパートは、動画（英語）もあるので参考にしてください。[Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0)
+
+さぁ、もう最後のパートですよ。あっという間ですね。 :)
+
+先ほどお話ししたとおり、プログラマーはめんどくさがりで、同じことを繰り返すのは好きではありません。プログラミングの目的は、物事を自動化することです。名前を呼んで挨拶をする関数をすべての人に対して手で呼び出したくないですよね？こういう時にループが便利です。
+
+リストを覚えていますか？女の子の名前をリストにしてみましょう:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+名前を呼んで、全員にあいさつをしてみましょう。` hi `関数が使えますね。ループの中で使いましょう:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+この `for` 文は `if` 文に似ています。これらの下に書くコードは、4つのスペースでインデントする必要があります。
+
+ファイルに書かれるコードはこのようになります:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+実行してみましょう:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+ご覧のとおり、`girls` リストのすべての要素に対して、`for` 文の中にインデントして書いたことが繰り返されています。
+
+`range` 関数を使うことで、`for` 文を数値について使うこともできます。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+これを実行すると、次のように出力されます:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` 関数は、連続する数値を要素とするリストを作ります。引数に指定した開始の数値から終了の数値までのリストです。
+
+2つ目の引数（終了の数値）は、リストに含まれないことに注意してください（`range(1, 6)`は1から5がカウントされますが、6は含まれません）。 開始に指定した数値は含まれて、終了に指定した値は含まれないのです。
+
+## まとめ
+
+以上です！**おめでとう！頑張りました！** これは簡単ではなかったと思います。自分を褒めてあげてくださいね。ここまで進めることができたのは、本当にすごいことです！
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+次のチャプターに進む前に、ストレッチしたり、お散歩したり、目を休ませたりして、少しの間リフレッシュしてくださいね。 :)
+
+![カップケーキ](images/cupcake.png)
\ No newline at end of file
diff --git a/ja-JP/template_extending/README.md b/ja-JP/template_extending/README.md
new file mode 100644
index 00000000000..8785a443e0c
--- /dev/null
+++ b/ja-JP/template_extending/README.md
@@ -0,0 +1,151 @@
+# テンプレートを拡張しよう
+
+Djangoのまた別の素敵なところは**テンプレート拡張**です。これは何を意味するのでしょうか？それはHTMLの共通部分をウェブサイトの異なるページで使えるということです。
+
+テンプレートは同じ情報やレイアウトを複数の場所で利用したいときに役立ちます。 各ファイル内で繰り返す必要はありません。 さらにもし何か変更したい場合、各テンプレートを変更する必要はなく、1回変更すればいいだけです！
+
+## 基本テンプレートを作成する
+
+基本テンプレートはあなたのウェブサイトの各ページを拡張するための最も基本的なテンプレートです。
+
+`blog/templates/blog/`以下に`base.html`ファイルを作ってみましょう。
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+それからエディタで開いて、以下のように`post_list.html`から`base.html`ファイルにすべてコピーしましょう。
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+それから`base.html`内の`<body>`全体(`<body>`と`</body>`の間のすべて)を次で置き換えます。
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}`{% for post in posts %}` から `{% endfor %}` が以下のように置き換えられたことに気づいたでしょうか。 {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+でも何のために？ あなたはただ`block`を作っただけです！ `{% block %}` テンプレートタグを、これからHTMLを挿入しようとする場所に使いました。 そのHTMLはこのテンプレート (`base.html`) を拡張した別のテンプレートからやってきます。 どうやって行うかはすぐに示します。
+
+`base.html`を保存し、もう一度`blog/templates/blog/post_list.html`をエディタで開きます。 {% raw %} `{% for post in posts %}` の上と `{% endfor %}` の下すべてを削除しましょう。 それが終わったら以下のようになっていると思います。{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+これをcontentブロックに対応するテンプレートのパーツとして使いたいです。このファイルにblockタグを追加する時です！
+
+{% raw %}追加するblockタグは `base.html` ファイル中のタグにマッチしてほしいですよね。 また、blockタグにはcontentブロックに属するすべてのコードを含めたいですよね。 そうするには、すべてを `{% block content %}` と `{% endblock %}` の間に入れてあげればよいです。 このように:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+あとやることは一つだけです。これら二つのテンプレートをくっつけてあげる必要があります。これがテンプレートを拡張するということのすべてです！そうするにはこのファイルの先頭にextendsタグを追加します。次のように：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+以上です！ファイルを保存して、ウェブサイトがまだちゃんと動いているか確認しましょう。:)
+
+> もし `TemplateDoesNotExist` というエラーが出ていたら、 `blog/base.html` ファイルがないという意味で、コンソールで `runserver` が実行されたままになっていると思います。 これを止め(Ctrl+C - ControlとCのキーを同時押し)、それから `python manage.py runserver`コマンドを入力して再度サーバーを動かしてみてください。
\ No newline at end of file
diff --git a/ja-JP/whats_next/README.md b/ja-JP/whats_next/README.md
new file mode 100644
index 00000000000..be1767a4a13
--- /dev/null
+++ b/ja-JP/whats_next/README.md
@@ -0,0 +1,43 @@
+# 次のステップは？
+
+おめでとうございます。**素晴らしいです。**よくやりました！ <3
+
+### 今何をする？
+
+休憩してリラックスしてください！本当に大きなことを成し遂げました。
+
+休んだ後は、[Facebook](http://facebook.com/djangogirls)や[Twitter](https://twitter.com/djangogirls)でDjango Girlsをぜひフォローしてくださいね。最新の情報を入手できます。
+
+### さらにオススメの資料はありますか？
+
+あります！ 様々なプログラミングスキルを学ぶためのオンラインリソースが、*たくさん*あります。沢山ありすぎて何を次にやろうか迷うかもしれませんので、お勧めを示しておきます。 Django Girlsのチュートリアルを始める時にどんな興味を持っていたとしても、あるいは、チュートリアルを終えた今どんな興味があるとしても、あなたが行きたいところへ行くために使える無料の（あるいは、無料で多くのことを学べる）リソースを示します。
+
+#### Django
+
+- このチュートリアルの続きである[Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django 公式チュートリアル](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django 動画レッスン](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) - いくつかのビデオは無料で視聴可能で、Coursea終了証を取得することもできます。
+
+#### HTML, CSS ならびに JavaScript
+
+- [Codecademyのweb開発コース](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [CodecademyのPythonコース](https://www.codecademy.com/learn/learn-python)
+- [GoogleのPythonコース](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – 最初のエクササイズは無料です。
+- [New Coder tutorials](http://newcoder.io/tutorials/) – Pythonの使い方について様々な実用的な例があります。
+- [edX](https://www.edx.org/course?search_query=python) – ほとんどのコースを無料で視聴できますが、高等教育資格に向けた修了証書や単位が欲しい場合、お金がかかります。
+- [CourseraのPython専門講座](https://www.coursera.org/specializations/python) – オンライン動画の講義の一部を無料で見ることができ、コースを受講し終わるとCoursera修了証を取得することができます。
+- [Python for Everybody](https://www.py4e.com/) – CourseraのPython専門講座の無料かつ開放されたバージョンです。
+
+#### データ操作
+
+- [Codecademyのデータサイエンスコース](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – ほとんどのコースを無料で視聴できますが、高等教育資格に向けた修了証書や単位が欲しい場合、お金がかかります。
+- [Dataquest](https://www.dataquest.io/) – はじめの30 "ミッション" が無料です。
+
+あなたが次になにを作るか、楽しみにしています！
\ No newline at end of file
diff --git a/ja/GLOSSARY.md b/ja/GLOSSARY.md
new file mode 100644
index 00000000000..747b20e57ac
--- /dev/null
+++ b/ja/GLOSSARY.md
@@ -0,0 +1,3 @@
+# コードエディタ
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/ja/README.md b/ja/README.md
new file mode 100644
index 00000000000..8cbd8440f6e
--- /dev/null
+++ b/ja/README.md
@@ -0,0 +1,51 @@
+# Django Girls のチュートリアル
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## はじめに
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![図 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ja/SUMMARY.md b/ja/SUMMARY.md
new file mode 100644
index 00000000000..49579ec506f
--- /dev/null
+++ b/ja/SUMMARY.md
@@ -0,0 +1,27 @@
+# 概要
+
+* [はじめに](README.md)
+* [インストール](installation/README.md)
+* [Installation (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)
+* [Introduction to Python](python_introduction/README.md)
+* [ジャンゴってなに？](django/README.md)
+* [Django installation](django_installation/README.md)
+* [あなたの最初のDjangoプロジェクト！](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](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)
\ No newline at end of file
diff --git a/ja/chromebook_setup/README.md b/ja/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/ja/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ja/chromebook_setup/instructions.md b/ja/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..122ad90a0ff
--- /dev/null
+++ b/ja/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+Chromebookをお持ちでない場合は、このセクションをスキップできます. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. クラウド 9 no インストールする[Kurōmu ウェブストア](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. [C9.io](https://c9.io) に行く
+3. アカウントにサインアップします
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ja/code_editor/README.md b/ja/code_editor/README.md
new file mode 100644
index 00000000000..9bcd3d5af4f
--- /dev/null
+++ b/ja/code_editor/README.md
@@ -0,0 +1,11 @@
+# コードエディタ
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+まさにこれから、はじめてのコードを書いていきます。コードエディタをダウンロードしましょう！
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ja/code_editor/instructions.md b/ja/code_editor/instructions.md
new file mode 100644
index 00000000000..20dbe9ceb16
--- /dev/null
+++ b/ja/code_editor/instructions.md
@@ -0,0 +1,31 @@
+本当にたくさんのエディタがありますが、どれを使うかは、結局は、ほとんど個人の好みの問題です。 ほとんどのPythonプログラマは、Pycharmなど、複雑ですが非常に強力なIDE（統合開発環境）というものを使っています。 しかし、初心者にとってはIDEはそれほど適していないかもしれないので、同じくらい強力で、もっとシンプルなものをオススメします。
+
+オススメのエディタは下記に挙げますが、気軽にコーチに質問して好みや特徴ををきいてみてください.
+
+## Gedit
+
+Geditはオープン ソースの無料エディタで、すべてのOSで利用可能です。
+
+[ダウンロード](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[ダウンロード](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[ダウンロード](https://atom.io/)
+
+## なんでコードエディタをインストールするの？
+
+なんでWordやNotepadのようなものを使わず、特別なコードエディタをインストールするのかなと思うかもしれません。
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ja/css/README.md b/ja/css/README.md
new file mode 100644
index 00000000000..699f083e1c8
--- /dev/null
+++ b/ja/css/README.md
@@ -0,0 +1,407 @@
+# CSS – make it pretty!
+
+ブログは作ったものの、まだなんかダサいですよね。かわいくしましょう！　そのためにはCSSを使います。
+
+## CSSとは？
+
+Cascading Style Sheets (CSS)とは、HTMLなどのマークアップ言語で書かれたWebサイトの見た目や書式を記述するための言語です。私達のWebページをメイクアップするものとして使います。
+
+でも、またゼロから作りたくないですよね。プログラマーたちがすでに作って無料で公開しているツールを使いましょう。わざわざイチから作り直す必要はないですからね。
+
+## Let's use Bootstrap!
+
+Bootstrap は美しいWebサイトを開発するためのHTMLとCSSのフレームワークとしてとても有名です: http://getbootstrap.com/
+
+これは、もともとTwitterのプログラマーが作成したもので、今は、世界中の有志のボランティアで開発されています。
+
+## Bootstrapのインストール
+
+Bootstrapをインストールするには .html ファイル (blog/templates/blog/post_list.html) の
+
+<head>
+  の中に、次のとおり書き加えます：</p> 
+  
+  <p>
+    {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+  </p>
+  
+  <pre><code class="html">&lt;link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css"&gt;
+&lt;link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css"&gt;
+</code></pre>
+  
+  <p>
+    これは、あなたのプロジェクトにファイルを追加しているわけではありません。インターネット上にあるファイルを指しているだけです。では、Webサイトを開いてページを再読み込みしてください。
+  </p>
+  
+  <p>
+    <img src="images/bootstrap1.png" alt="図 14.1" />
+  </p>
+  
+  <p>
+    これだけでずいぶん見た目が良くなりましたね！
+  </p>
+  
+  <h2>
+    Static files in Django
+  </h2>
+  
+  <p>
+    最後に、<strong>静的ファイル</strong>と呼ばれるものを詳しく見ていきましょう。 Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+  </p>
+  
+  <h3>
+    静的ファイルはプロジェクトのどこに置けばいいの？
+  </h3>
+  
+  <p>
+    Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, <code>blog</code>.
+  </p>
+  
+  <p>
+    そのために、blogアプリの中に<code>static</code>というフォルダを作ります。
+  </p>
+  
+  <pre><code>djangogirls
+├── blog
+│   ├── migrations
+│   ├── static
+│   └── templates
+└── mysite
+</code></pre>
+  
+  <p>
+    Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+  </p>
+  
+  <h2>
+    Your first CSS file!
+  </h2>
+  
+  <p>
+    Let's create a CSS file now, to add your own style to your web page. <code>static</code>ディレクトリの中に<code>css</code>というディレクトリを作成しましょう。 そして、その<code>css</code>ディレクトリの中に<code>blog.css</code>という新規ファイルを作ります。 Ready?
+  </p>
+  
+  <pre><code>djangogirls
+└─── blog
+     └─── static
+          └─── css
+               └─── blog.css
+</code></pre>
+  
+  <p>
+    ついにCSSを書くときが来ました！　コードエディタで<code>blog/static/css/blog.css</code>ファイルを開きましょう。
+  </p>
+  
+  <p>
+    We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+  </p>
+  
+  <p>
+    ただ、せめて少しはここでやってみましょう。 ヘッダーの色を変えてみるのもいいかもしれませんね。 色を理解するために、コンピュータは特殊なコードを使います。 These codes start with <code>#</code> followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is <code>#0000FF</code>. You can find the color codes for many colors here: http://www.colorpicker.com/. <code>red</code>や<code>green</code>といった<a href="http://www.w3schools.com/colors/colors_names.asp">定義済みの色</a>を利用することもできます.
+  </p>
+  
+  <p>
+    <code>blog/static/css/blog.css</code>ファイルに、次のコードを追加しましょう。
+  </p>
+  
+  <p>
+    {% filename %}blog/static/css/blog.css{% endfilename %}
+  </p>
+  
+  <pre><code class="css">h1 a {
+    color: #FCA205;
+}
+</code></pre>
+  
+  <p>
+    <code>h1 a</code>はCSSセレクタと呼ばれるものです。 This means we're applying our styles to any <code>a</code> element inside of an <code>h1</code> element. So when we have something like <code>&lt;h1&gt;&lt;a href=""&gt;link&lt;/a&gt;&lt;/h1&gt;</code>, the <code>h1 a</code> style will apply. この場合、その要素を<code>#FCA205</code>に、つまりオレンジ色にしようとしています。 もちろん、あなたの好きな色に変えられます！
+  </p>
+  
+  <p>
+    CSSファイルには、HTMLファイルの各要素のスタイルを指定していきます。 The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like <code>a</code>, <code>h1</code>, and <code>body</code> are all examples of element names. We also identify elements by the attribute <code>class</code> or the attribute <code>id</code>. classやidは、あなたが自分で要素につけることができる名前です。 classは要素のグループを定義して、idは特定の要素を指定します。 For example, you could identify the following tag by using the tag name <code>a</code>, the class <code>external_link</code>, or the id <code>link_to_wiki_page</code>:
+  </p>
+  
+  <pre><code class="html">&lt;a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page"&gt;
+</code></pre>
+  
+  <p>
+    You can read more about <a href="http://www.w3schools.com/cssref/css_selectors.asp">CSS Selectors at w3schools</a>.
+  </p>
+  
+  <p>
+    We also need to tell our HTML template that we added some CSS. Open the <code>blog/templates/blog/post_list.html</code> file and add this line at the very beginning of it:
+  </p>
+  
+  <p>
+    {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+  </p>
+  
+  <pre><code class="html">{% load staticfiles %}
+</code></pre>
+  
+  <p>
+    We're just loading static files here. :) Between the <code>&lt;head&gt;</code> and <code>&lt;/head&gt;</code> tags, after the links to the Bootstrap CSS files, add this line:
+  </p>
+  
+  <p>
+    {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+  </p>
+  
+  <pre><code class="html">&lt;link rel="stylesheet" href="{% static 'css/blog.css' %}"&gt;
+</code></pre>
+  
+  <p>
+    The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. このようにCSSファイルがどこにあるか示します。
+  </p>
+  
+  <p>
+    ファイルは次のようになっているはずです:
+  </p>
+  
+  <p>
+    {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+  </p>
+  
+  <pre><code class="html">{% load staticfiles %}
+&lt;html&gt;
+    &lt;head&gt;
+        &lt;title&gt;Django Girls blog&lt;/title&gt;
+        &lt;link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css"&gt;
+        &lt;link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css"&gt;
+        &lt;link rel="stylesheet" href="{% static 'css/blog.css' %}"&gt;
+    &lt;/head&gt;
+    &lt;body&gt;
+        &lt;div&gt;
+            &lt;h1&gt;&lt;a href="/"&gt;Django Girls Blog&lt;/a&gt;&lt;/h1&gt;
+        &lt;/div&gt;
+
+        {% for post in posts %}
+            &lt;div&gt;
+                &lt;p&gt;published: {{ post.published_date }}&lt;/p&gt;
+                &lt;h1&gt;&lt;a href=""&gt;{{ post.title }}&lt;/a&gt;&lt;/h1&gt;
+                &lt;p&gt;{{ post.text|linebreaksbr }}&lt;/p&gt;
+            &lt;/div&gt;
+        {% endfor %}
+    &lt;/body&gt;
+&lt;/html&gt;
+</code></pre>
+  
+  <p>
+    保存して、サイトを更新してください。
+  </p>
+  
+  <p>
+    <img src="images/color2.png" alt="図 14.2" />
+  </p>
+  
+  <p>
+    素晴らしいですね！あとは、左サイドの余白幅を少し広げて、余裕を持たせてあげたらもっと良くなると思いませんか？やってみましょう。
+  </p>
+  
+  <p>
+    {% filename %}blog/static/css/blog.css{% endfilename %}
+  </p>
+  
+  <pre><code class="css">body {
+    padding-left: 15px;
+}
+</code></pre>
+  
+  <p>
+    Add that to your CSS, save the file and see how it works!
+  </p>
+  
+  <p>
+    <img src="images/margin2.png" alt="図 14.3" />
+  </p>
+  
+  <p>
+    ヘッダーのフォントを変えてみませんか？ファイル <code>blog/templates/blog/post_list.html</code> の<code>&lt;head&gt;</code> タグの中に次の一行を貼り付けましょう。
+  </p>
+  
+  <p>
+    {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+  </p>
+  
+  <pre><code class="html">&lt;link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css"&gt;
+</code></pre>
+  
+  <p>
+    As before, check the order and place before the link to <code>blog/static/css/blog.css</code>. This line will import a font called <em>Lobster</em> from Google Fonts (https://www.google.com/fonts).
+  </p>
+  
+  <p>
+    Find the <code>h1 a</code> declaration block (the code between braces <code>{</code> and <code>}</code>) in the CSS file <code>blog/static/css/blog.css</code>. Now add the line <code>font-family: 'Lobster';</code> between the braces, and refresh the page:
+  </p>
+  
+  <p>
+    {% filename %}blog/static/css/blog.css{% endfilename %}
+  </p>
+  
+  <pre><code class="css">h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+</code></pre>
+  
+  <p>
+    <img src="images/font.png" alt="図 14.3" />
+  </p>
+  
+  <p>
+    素晴らしいです！
+  </p>
+  
+  <p>
+    As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+  </p>
+  
+  <p>
+    先に進んで、HTMLコードの一部に名前をつけましょう。ヘッダーに含まれる<code>div</code> 要素に、<code>page-header</code> というクラス名をつけましょう：
+  </p>
+  
+  <p>
+    {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+  </p>
+  
+  <pre><code class="html">&lt;div class="page-header"&gt;
+    &lt;h1&gt;&lt;a href="/"&gt;Django Girls Blog&lt;/a&gt;&lt;/h1&gt;
+&lt;/div&gt;
+</code></pre>
+  
+  <p>
+    さらにブログ投稿を含む<code>div</code> 要素に<code>post</code> というクラス名をつけましょう。
+  </p>
+  
+  <p>
+    {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+  </p>
+  
+  <pre><code class="html">&lt;div class="post"&gt;
+    &lt;p&gt;published: {{ post.published_date }}&lt;/p&gt;
+    &lt;h1&gt;&lt;a href=""&gt;{{ post.title }}&lt;/a&gt;&lt;/h1&gt;
+    &lt;p&gt;{{ post.text|linebreaksbr }}&lt;/p&gt;
+&lt;/div&gt;
+</code></pre>
+  
+  <p>
+    そして、別のセレクタに宣言ブロックを追加します。 <code>.</code>で始まるセレクタはクラスに関連します。 There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. 今のところは、<code>blog/static/css/blog.css</code>のファイルに以下の内容をコピー＆ペーストしましょう：
+  </p>
+  
+  <p>
+    {% filename %}blog/static/css/blog.css{% endfilename %}
+  </p>
+  
+  <pre><code class="css">.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+</code></pre>
+  
+  <p>
+    そして、これをクラス宣言で投稿を表示しているHTMLコードで囲みます。 <0>blog/templates/blog/post_list.html</0> 中のこの部分を
+  </p>
+  
+  <p>
+    {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+  </p>
+  
+  <pre><code class="html">{% for post in posts %}
+    &lt;div class="post"&gt;
+        &lt;p&gt;published: {{ post.published_date }}&lt;/p&gt;
+        &lt;h1&gt;&lt;a href=""&gt;{{ post.title }}&lt;/a&gt;&lt;/h1&gt;
+        &lt;p&gt;{{ post.text|linebreaksbr }}&lt;/p&gt;
+    &lt;/div&gt;
+{% endfor %}
+</code></pre>
+  
+  <p>
+    これで置き換えて下さい：
+  </p>
+  
+  <p>
+    {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+  </p>
+  
+  <pre><code class="html">&lt;div class="content container"&gt;
+    &lt;div class="row"&gt;
+        &lt;div class="col-md-8"&gt;
+            {% for post in posts %}
+                &lt;div class="post"&gt;
+                    &lt;div class="date"&gt;
+                        &lt;p&gt;published: {{ post.published_date }}&lt;/p&gt;
+                    &lt;/div&gt;
+                    &lt;h1&gt;&lt;a href=""&gt;{{ post.title }}&lt;/a&gt;&lt;/h1&gt;
+                    &lt;p&gt;{{ post.text|linebreaksbr }}&lt;/p&gt;
+                &lt;/div&gt;
+            {% endfor %}
+        &lt;/div&gt;
+    &lt;/div&gt;
+&lt;/div&gt;
+</code></pre>
+  
+  <p>
+    それらのファイルを保存してWebサイトを更新してみましょう。
+  </p>
+  
+  <p>
+    <img src="images/final.png" alt="図 14.4" />
+  </p>
+  
+  <p>
+    Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+  </p>
+  
+  <p>
+    Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+  </p>
+  
+  <p>
+    We really recommend taking this free online <a href="https://www.codecademy.com/tracks/web">Codeacademy HTML & CSS course</a>. It can help you learn all about making your websites prettier with CSS.
+  </p>
+  
+  <p>
+    さて、次の章にいく準備はできましたか？^皿^
+  </p>
\ No newline at end of file
diff --git a/ja/deploy/README.md b/ja/deploy/README.md
new file mode 100644
index 00000000000..45b833fc88c
--- /dev/null
+++ b/ja/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **補足** このチャプターはちょっと難しいことが沢山書かれています。 頑張って最後までやりきってください。デプロイはウェブサイトを開発するプロセスの上で、とても重要な部分ですが、躓きやすいポイントも多く含まれています。 チュートリアルの途中にこのチャプターを入れています。そういった躓きやすい箇所はメンターに質問して、あなたが作っているウェブサイトをオンラインでみれるようにしてください。 言い換えれば、もし時間切れでワークショップ内でチュートリアルを終わらせることができなかったとしても、この後のチュートリアルはきっと自分で終わらせることができるでしょう。
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! デプロイとは、あなたが作っているアプリケーションをインターネットで公開することです。あなた以外の人もウェブサイトを見ることができるようになりますよ. :)
+
+これまでに学んだとおり、ウェブサイトはサーバーに置かれています。 There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+使用するその他の外部サービスは [GitHub](https://www.github.com) コードのホスティング サービスです。 他にも色々ありますが、ほとんどのプログラマはGitHubのアカウントを持っています。そしてあなたも今そうなります。
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Gitはリポジトリ（または略して「レポ」）と呼ばれる特定のファイルに変更をセットし追跡します。 私たちのプロジェクトを開始しましょう。 あなたのコンソールを開き、`djangogirls` ディレクトリでこれらのコマンドを実行します。
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. `Djangogirls` フォルダーにする必要があります。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git のすべてのファイルおよびこのディレクトリ内のフォルダーの変更を追跡しますが、無視するいくつかのファイルがあります。 ベース ディレクトリの `.gitignore` という名前のファイルを作成することによってこれを行います。 あなたのエディターを開き、次の内容で新しいファイルを作成します。
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **備考：**ファイル名の先頭のドットは重要です! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+`Git に追加` する前に、またはあなたは自分が何が変わったのかわからない見つけるたびに `git status` コマンドを使用することをお勧めします。 This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+最終的に我々 は、変更内容を保存します。本体に移動し、これらのコマンドを実行します。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. それをチェックしにいってください。  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    私たちのレポにクローンを作ることによって、GitHubとPythonAnywhere上から私たちのコードをpull downしましょう。 Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. 静的ファイルについては、チュートリアルの後半でCSSのサイトを編集するときに詳しく説明します。
+
+**セーブ(save)**を押して**Web**タブを押します。
+
+もう終わった！大きな緑色の** Reload </ 0>ボタンを押すと、アプリケーションを表示することができます。 ページの上部に、アプリケーションへのリンクがあります。</p> 
+
+## デバッギングのヒント
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+覚えてください。あなたのコーチたちはあなたのためにここにいます。
+
+# あなたは今生きている！
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+あなた自身の背中に * HUGE * パットを与える！ Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/ja/deploy/install_git.md b/ja/deploy/install_git.md
new file mode 100644
index 00000000000..3742ba1b8dc
--- /dev/null
+++ b/ja/deploy/install_git.md
@@ -0,0 +1,52 @@
+Gitはたくさんのプログラマが利用する「ヴァージョン管理システム」です。 このソフトウェアはファイルの変更を長期にわたって追跡し、あなたは特定のバージョンを後で思い出す事が可能です。 Microsoft Wordに少し変更を追跡する特徴があります、しかしもっと強力です。
+
+## Gitのインストール
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+[git-scm.com](https://git-scm.com/) かからGitをダウンロードすることができます。 You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). 他のことは全部、基本設定にしても大丈夫です。 Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+[git-scm.com](https://git-scm.com/)からGitをダウンロードし、指示に従ってください。
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ja/deploy/signup_pythonanywhere.md b/ja/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..c680f82f480
--- /dev/null
+++ b/ja/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [http://www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ja/django/README.md b/ja/django/README.md
new file mode 100644
index 00000000000..26f0c32b9b7
--- /dev/null
+++ b/ja/django/README.md
@@ -0,0 +1,27 @@
+# ジャンゴってなに？
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. Web フレームワークは、素早く、簡単にウェブサイトを開発するのに役立つコンポーネントの一式が含まれています。
+
+Web サイトを構築するとき常に同じような一連のコンポーネントを必要があります: ユーザー認証 (登録、サインイン、サインアウト) を処理する方法、あなたのウェブサイト、フォーム、ファイルなどをアップロードする方法の管理パネルです。
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## なぜフレームワークを必要とするか。
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+やってくるメールを監視するメール受信箱を想像してみてください。 これはWEBサーバによってです。 The web server reads the letter and then sends a response with a webpage. しかし、何かをレスポンスを返す場合は、いくつかのコンテンツを持っている必要があります。 Djangoは、コンテンツを作成することができます。
+
+## 誰かがあなたのWEB サイトにリクエストを要求したときどうなりますか。
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+配達人と手紙を想像してみてください。 彼女は通りを歩き、各家の番号をチェックします。 手紙とマッチすると、手紙を配達します。 これがurlresolverがどのように動いているか、です。
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. ユーザはデータにおいて何か変更するために尋ねるだろうか？ Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+もちろん、上の説明は少し簡単に書きましたが、まだすべての技術的なことを知る必要はないです。一般的な考え方を持つだけで十分です。
+
+細部に多くの時間を費やすより、Djangoで何かを作ることをはじめましょう、そしてやり方に沿って重要な部分を学びましょう！
\ No newline at end of file
diff --git a/ja/django_admin/README.md b/ja/django_admin/README.md
new file mode 100644
index 00000000000..ee94e35bce7
--- /dev/null
+++ b/ja/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+前章でpostモデルをimportするのを見ました。 Adminページ(管理画面)のモデルを作るために、モデルを登録する必要があります。`admin.site.register(Post)`の部分です.
+
+OKです、Postモデルについて見ていきましょう。 Web サーバーを実行するコンソールで `python manage.py runserver` を実行してください。 Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![ログインページ](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ja/django_forms/README.md b/ja/django_forms/README.md
new file mode 100644
index 00000000000..a24c264dabe
--- /dev/null
+++ b/ja/django_forms/README.md
@@ -0,0 +1,447 @@
+# Djangoのフォーム
+
+自分のwebサイトで最終的にやりたいことは、ブログポストを追加したり編集したりすることをいいやり方で作ることです。 Django adminはかなりいいですが、カスタマイズや上手く作るのはより難しいです。 With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+Djangoのフォームでよいところは、フォームをスクラッチで定義できたり、モデルからフォームを生成できるところです。
+
+これはまさに私たちがやりたいことです：Postモデルを作ります。
+
+Djangoのフォームの重要な部分は`forms.py`ファイルで持ちます.
+
+これは`blog`ディレクトリの下にforms. pyの名前で作る必要があります。
+
+    blog
+       └── forms.py
+    
+
+Forms. pyファイルを開き、次のコードをタイプしてください。
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Djangoのフォームクラスをインポートする必要があります。それが`rom django import forms`の部分です。そして`from .models import Post`はポストモデルをインポートしています).
+
+PostFormとは何かと思うかもしれません。これはフォームを作る時に定義する名前です。 We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+次に`class Meta`ですが、Postモデルを使う時、このフォーム`model = Post`を使います).
+
+最後にフォームのフィールドに何を置くか書きます。 In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+そしてそうです！今私たちが ビューで必要なのは、フォームを使うことです。テンプレートがあるので、それを示します。
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## フォームにおけるページへのリンク
+
+`blog/templates/blog/base.html`を開いてみましょう。ページヘッダというdivのリンクに次の内容を追加しましょう。
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+行を追加すると、このような html ファイルになります。
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Htmlファイルを保存して、ページをリロードします。 `NoReverseMatch` エラーが表示されます?
+
+## URL
+
+blog/urls.pyを開き、次の内容を追加します。
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+次に、このような内容を追加します。
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+サイトをリロードした後、`AttributeError`が出ます。`post_new`ビューの実装がないからです。ファイルに追加してみましょう。
+
+## post_new view
+
+blog/views.pyを開きます。fromの行の後に次の内容を追加してみましょう。
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Postフォームを新しく作るには、PostFormを呼び出し、それをテンプレートに渡す必要があります。 ビューに戻り、いまからフォームのテンプレートを作りましょう。
+
+## テンプレート
+
+blog/templates/blogディレクトリにpost_edit.htmlファイルを作りましょう。フォームを動かすにはいくつかやることがあります。
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* 上記の行は HTML フォーム タグでラップする必要があります: `<form method="POST">...</form>`.
+* `保存` のボタンが必要です。HTML ボタンで行う: `<button type="submit">Save</button>`.
+* 最後に`<form ...>` タグを開いて、 `{% raw %}{% csrf_token %}{% endraw %}`を追加する必要があります。 フォームを安全に保護できるのでこれは非常に重要です! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+更新をしてみましょう。やった！フォームが表示されます。
+
+![New form](images/new_form2.png)
+
+ちょっと待ってみて下さい。`title` and `text` フィールドに何か入力して保存するとどうなりますか？
+
+何もない! 我々 は再び同じページと私たちのテキストはあの新しい記事は追加されません。なぜこうなってしまったのか？
+
+答えは: ないからです。ビュー で、もう少し作業を行う必要があります.
+
+## Formをsaveする
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? フォームの全てのフィールドがPOSTリクエストです。 POST の名前を他の名前に変更することはできません (それを変更する唯一の方法は method に GET を指定することですが、それがなぜ間違いであるかを話す時間がありません)
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. それでは [...] の部分を埋めていきます):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+フォームをチェックして、フォームの値が有効であれば保存できます。
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+基本的にここでは2つのことを行います。まず form.save でフォームを保存することと author を追加することです(まだ PostForm 内に author フィールドがありませんし、このフィールドは必須です). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. この view では pk 変数が必須であることを覚えていますか? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+では動作確認してみます。 Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+素晴らしい！
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. その問題は一時的に解決します。 メインチュートリアルの後 Homework: add security to your website! の章に恒久的な対策がありますので宿題として取り組んでみてください。
+
+![Logged in error](images/post_create_error.png)
+
+## フォームのバリデーション(検証)
+
+ここではDjangoのフォームのクールなところを紹介します。 ブログのポストは title と text のフィールドが必要です。 In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![フォームのバリデーション(検証)](images/form_validation2.png)
+
+Djangoはフォームのすべてのフィールドが正しいことを検証してくれます。気が利くでしょう?
+
+## フォームの編集
+
+今、私たちは新しいフォームを追加する方法を知っています。 しかし既存のデータを編集するためはどうすれば良いのでしょうか? それは先ほど行ったことと非常に似ています。 すぐにいくつかの重要なものを作成してみましょう。 (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+blog/urls.py には次の行を追加します:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+テンプレート blog/templates/blog/post_edit.html を再利用します。そしてviewを追加します.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+post_view とほとんど同じに見えますか? しかし完全に同じではありません。 For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+クリックするとブログの記事にフォームが表示されます:
+
+![フォームの編集](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+おめでとう！アプリケーションが完成しました。
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## もう一つ: deployの時間です!
+
+ではPythonAnywhere上で動作するかを確認しましょう。再度デプロイします。
+
+* なおデプロイ方法を忘れてしまった場合は章の最後 Deploy をチェックしてください:: 
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* そうすると、PythonAnywhereのbashコンソールで見ると：
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* 最後に、Webタブに行って、リロードします.
+
+そしてdeployします! おめでとうございます :)
\ No newline at end of file
diff --git a/ja/django_installation/README.md b/ja/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/ja/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ja/django_installation/instructions.md b/ja/django_installation/instructions.md
new file mode 100644
index 00000000000..88c91373306
--- /dev/null
+++ b/ja/django_installation/instructions.md
@@ -0,0 +1,202 @@
+> このチャプターの一部はGeek Girls Carrots (http://django.carrots.pl/)のチュートリアルに基づいています。
+> 
+> このチャプターの一部はCreative Commons Attribution-ShareAlike 4.0 International License のライセンスによるdjango-marcador tutorialに基づいています. このdjango-marcador tutorialはMarkus Zapke-Gründemann らが著作権を保有しています。 
+
+## 仮想環境
+
+Django をインストールする前に、あなたのコーディング環境を、きれいにしておく便利な道具をインストールしてもらいます。 このステップをとばすこともできますが、しかし、このステップをとばすことは全くお勧めしまません。 可能な限りベストなセットアップで始めることは将来のたくさんのトラブルからあなたを救うはずですから！
+
+さあ、**仮想環境（virtual environment )**(*virtualenv*とも呼ばれています）を作成してみましょう。 仮想環境（virtual environment）ではプロジェクト単位であなたのPython/Djangoのセットアップを他から隔離します。 これは、あなたがひとつのウェブサイトにおこなったどんな変更も、あなたが開発している他のサイトに影響を及ぼさないということです。 わかりましたか？
+
+あなたがしなければならないのは、あなたが`仮想環境（virtual environment）`を作成したいディレクトリを見つけることです（たとえばホームディレクトリなどです）。 On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+このチュートリアルのために、ホームディレクトリに新しいディレクトリ`djangogirls`を作成します。
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+`myvenv`という仮想環境（virtual environment）を作成します。一般的なコマンドは以下のようになります：
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. どんな名前でも使うことができますが、必ず小文字で表記し、スペース・アクセント記号・特殊文字は入れないでください。 It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` は、あなたの `仮想環境(virtualenvironment)` の名前です。 どんな名前でも使うことができますが、必ず小文字で表記し、スペースは入れないでください。 It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+>     
+> 
+> このエラーを回避するために、代わりに`仮想環境(virtualenvironment)`コマンドを使います。
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## 仮想環境の操作
+
+上に示したコマンドは仮想環境（基本的には一連のディレクトリとファイル）を含む`myvenv` という名前（あるいはあなたが選んだ名前）のディレクトリを生成します。次に我々がしたいのは、これを実行し、開始することです。
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+実行して、仮想環境を起動します。
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls > myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+実行して、仮想環境を起動します。
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+`myvenv`のところをあながた選んだ`仮想環境(virtualenvironment)`名に置き換えることを忘れないで下さいね！
+
+> **備考:** `source` ではできない場合もあります。その場合は、代わりに以下のように入力してみてください：
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+virtual environment(仮想環境)の中で作業しているとき、`python`は自動的に正しいバージョンの`Python`を参照しますので、`python3`の代わりに<0>python</0>を使うことができます.
+
+OK,これでDjangoのインストール前に入れておきたい依存関係の準備がすべて整いました。いよいよDjangoのインストールです！
+
+## Djangoのインストール
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> Ubuntu 12.04でpipを呼んだときにエラーが起きた場合は、仮想環境(virtualenvironment)内でpipインストールをフィックスするために`python -m pip install -U --force-reinstall pip` を実行して下さい。
+
+<!--endsec-->
+
+以上です！あなたは（ついに）Djangoアプリケーションを作成する準備が整いました！
\ No newline at end of file
diff --git a/ja/django_models/README.md b/ja/django_models/README.md
new file mode 100644
index 00000000000..a9bec74e170
--- /dev/null
+++ b/ja/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## オブジェクト
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+じゃあオブジェクトって何なの？って思いますよね。オブジェクトは状態（プロパティ）と命令（アクション）の塊です。ピンと来ないでしょうから例を挙げましょう。
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+つまり、オブジェクト指向とは実際の物をプロパティ（オブジェクト・プロパティと呼びます）を持つコードと命令（メソッドと呼びます）で表現するという考え方です).
+
+ではブログポストはどういうモデルになるでしょうか。ブログが作りたいんですよね？
+
+それにはブログポストとは何か、それはどんなプロパティがあるかという問いに答えなければなりません。
+
+まず確実なのはブログポストにはコンテンツと表題がが必要ですね。 It would be also nice to know who wrote it – so we need an author. 最後にポストの作成公開した時間も分かるといいですね。
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+ではブログポストがどうなればいいですか？ポストをが公開されるといいですよね？
+
+なのでpublishメソッドが必要です。
+
+達成したいことが分かったので、Djangoでモデリングの開始です！
+
+## Django model
+
+オブジェクトが何か分かったので、ブログポストのDjangoモデルを作りましょう。
+
+A model in Django is a special kind of object – it is saved in the `database`. データベースはデータの集まりです。 ここにユーザーやブログポストの情報を格納します。 データを格納するのにSQLiteデータベースを使います。 This is the default Django database adapter – it'll be enough for us right now.
+
+データベースの中のモデルは、列（フィールド）と行（データ）があるスプレッドシートと思ってもらっても結構です。
+
+### Creating an application
+
+全部をきちんと整理しておくため、プロジェクトの中に別のアプリケーションを作ります。 初めから全てを整理しておくのはとっても良いことです。 アプリケーションを作るには、次のコマンドをコンソールの中で走らせなけれなりません。（manage.pyファイルがあるdjangogirlsディレクトリから）：
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. これはPythonでよく使われて"ダンダー"(ダブルアンダースコア）と呼んでいます。
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- classはオブジェクトを定義してますよ、ということを示すキーワードです。
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- models.ModelはポストがDjango Modelだという意味で、Djangoが、これはデータベースに保存すべきものだと分かるようにしています。
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ja/django_orm/README.md b/ja/django_orm/README.md
new file mode 100644
index 00000000000..c1b65e51829
--- /dev/null
+++ b/ja/django_orm/README.md
@@ -0,0 +1,218 @@
+# DjangoのORMとクエリセット
+
+この章では、Djangoのデータベース接続方法と、データストアについて学びます。やってみましょう！
+
+## クエリセットとは？
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+実際に動かしてみるのが一番わかりやすいので、試してみましょう。
+
+## Django shell
+
+コンソール画面を開いて、次のコマンドを入力してみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+次のような表示に切り替わるでしょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+最初に、ポストデータを全部表示させてみましょう。次のコマンドで、ポストのデータを全部表示させることが出来ます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+データベースに、新しいPostを作成するには、次のようにします。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+そうです、さっきと同じです。Userモデルも先にインポートしておきましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+どんなユーザが、データベースに登録されてましたっけ？覗いてみましょうか。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+さあ、遂にコンソール画面から、最初のポストを作成出来ますね。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+どうでしょうか？ちゃんと出来ているか、確認しておきましょうね。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. 全部のポストを取り出すのではなく、olaさんのポストだけを取り出したい場合は、Post.objects.all() の all を filter に変更します。 In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. このようになりますね。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** title と contains の間に、アンダーバーが2個続いていますが、 Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ja/django_start_project/README.md b/ja/django_start_project/README.md
new file mode 100644
index 00000000000..c974af5e9a1
--- /dev/null
+++ b/ja/django_start_project/README.md
@@ -0,0 +1,202 @@
+# あなたの最初のDjangoプロジェクト！
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. このdjango-marcador tutorialはMarkus Zapke-Gründemann らが著作権を保有しています。 
+
+We're going to create a small blog!
+
+最初のステップは、Djangoのプロジェクトを新しく作成します。 基本的に、Djangoのスクリプトを実行しDjangoプロジェクトの骨格を作ります。 スクリプトは、これから使う沢山のファイルやディレクトリを自動生成します。
+
+Djangoでは、ファイルやディレクトリの名前がとても重要です。 作成されたファイルの名前は変えるべきではありません。 ファイルを移動させるのもいいアイディアとはいえません。 Djangoでは、重要なファイルを決められたファイル構成で作成しておくことが必要です。 
+
+> virtualenv（仮想環境）を実行しているでしょうか。 If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. チャプターDjango installationのWorking with virtualenv で、仮想環境を実行する方法を説明しました。 Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> コマンドの最後にピリオド (.) があることを確認してくださいね。これば、現在の作業ディレクトリにDjangoをインストールするということを示すので、とても重要なのです。(ピリオドは簡略表記です).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> コマンドの最後にピリオド (.) があることを確認してくださいね。これば、現在の作業ディレクトリにDjangoをインストールするということを示すので、とても重要なのです。(ピリオドは簡略表記です).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+django-admin.py は、必要なディレクトリとファイルを作成するスクリプトです。次のようなファイル構造が作成されましたね。:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## 設定変更
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ja/django_templates/README.md b/ja/django_templates/README.md
new file mode 100644
index 00000000000..10e35e246b9
--- /dev/null
+++ b/ja/django_templates/README.md
@@ -0,0 +1,109 @@
+# Djangoテンプレート
+
+何かデータを表示しましょう！Djangoはそれをビルトインの テンプレートタグ で実現できます。
+
+## テンプレートタグとは？
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## ブログ一覧テンプレート
+
+前の章で、posts変数でテンプレートに記事のリストを渡しました。今からHTMLで表示をしてみましょう。
+
+Djangoテンプレートで変数を表示する為には、変数の名前を二重括弧で括ります:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+れをblog/templates/blog/post_list.htmlに書いてみて下さい。 ２つめと３つ目の
+
+<div>
+</div>タグをまるごと {{posts}} に置き換えて下さい。 ファイルを保存してページをリロードしますと：
+
+![図 13.1](images/step1.png)
+
+見たとおり、このようになります。
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Djangoはオブジェクトのリストと認識します。 Introduction to Pythonを思い出して下さい。 ループを使ってリストを表示しましたよね。 Djangoテンプレートではこう書きます:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+これをブログのテンプレートで使ってみましょう。
+
+![図 13.2](images/step2.png)
+
+動きましたね。 But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. bodyタグの中を次のように書いてください: bodyはこのようにします。
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% for %}と{% endfor %}の間にリストの中のオブジェクトごとに表示したい内容を書くとオブジェクトの数だけ繰り返し書かれます。ページをリロードしてみましょう。
+
+![図 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? Post モデルで定義したそれぞれのフィールドにアクセスしています。 Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## もう一つ...
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* まず、GitHubでコードをpushします。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* そしたら、Pythonanywhereに戻って、Bashコンソール（か、新しいコンソール）に入って、動かしましょう：
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* 最後にブラウザのタブを開いてアプリをリロードします。更新が反映されています！ If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+おめでとうございます！よくできました! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![図 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ja/django_urls/README.md b/ja/django_urls/README.md
new file mode 100644
index 00000000000..266af198e12
--- /dev/null
+++ b/ja/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## URLとは？
+
+URLとは、Webアドレスです。 You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! そう、127.0.0.1:8000 や And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+インターネット上のすべてのページには、独自のURLが必要です。 This way your application knows what it should show to a user who opens that URL. DjangoではURL_conf（URL設定）と呼ばれるものを使います。 URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+mysite/urls.pyを開いて、中身をみてみると：
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## 正規表現
+
+どのやってDjangoはビューにURLをマッチするのかと思うかもしれません。 そうです、この部分はひとひねりしています。 Djangoはregex、正規表現を使います。Regexは多くの（本当に多くの）検索パターンのルールを持っています。 理解するのは簡単では無いですが、今は心配しないで下さい。 将来、それらを正確に理解できるでしょう。今回は必要なものだけ使っています。
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+すべてのポストした記事の数を分けて記述することは非常に面倒です。 With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* (\d+)は１つか複数の数字を示します。取り出したい番号のことです。
+* /は別の記号が続くのを示します。
+* $は/で終わる後に示します。URLの終わりを示します。
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Mysite/urls.pyファイルはこのようになります：
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+これでDjangoは'http://127.0.0.1:8000/'に来たリクエストは`blog.urls`へリダイレクトするようになり、それ以降はそちらを参照するようになります。
+
+Writing regular expressions in Python is always done with `r` in front of the string. これは文字列がPythonで意味しない特別な文字であり、正規表現では意味する文字を含むというヒントになります。
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+その後、最初のURLパターンを追加します。
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. 正規表現での^は「文字列の開始」を意味します。ここからパターンマッチを始めます。 $は「文字列の終端」を意味していて、ここでパターンマッチを終わります。 この2つの記号を並べたパターンがマッチするのは、そう、空の文字列です。といっても、DjangoのURL名前解決では'http://127.0.0.1:8000/'は除いてパターンマッチするので、このパターンは'http://127.0.0.1:8000/'自体を意味します。つまり、'http://127.0.0.1:8000/'というURLにアクセスしてきたユーザに対して`views.post_list`を返すように指定していることになります。
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![エラー](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> Django URLconfについて知りたい場合は、公式のドキュメントを見て下さい： https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/ja/django_views/README.md b/ja/django_views/README.md
new file mode 100644
index 00000000000..eca8a8ccc0d
--- /dev/null
+++ b/ja/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+それでは前の章の続きをやりましょう。確かビューの作成がまだだったので、エラーになっていましたね! :)
+
+私たちは*view*にアプリケーションのロジックを置きます。 それは前に作成した `モデル` から情報を取得し、それを `テンプレート` に引き渡します。 テンプレートは次の章で作成します。 Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+ビューは、`views.py` ファイルに記述します。私たちの場合 *ビュー* を `blog/views.py` に書くことになります。
+
+## blog/views.py
+
+OK それでは早速そのファイル（blog/views.py)を開いてみましょう。
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+今度は別のエラーです。何と書いてあるか読んでみましょう。
+
+![エラー](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Djangoのビューについてもっと知りたいのなら、英語で書かれていますが、オフィシャルドキュメントを是非読んでみてください https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/ja/dynamic_data_in_templates/README.md b/ja/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..aa7debc56f0
--- /dev/null
+++ b/ja/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# テンプレート内の動的データ
+
+ポスト内容を保存する為の Post モデルは、 models.py に定義しました。ポストの一覧を表示する post_list は views.py にあり、そこにテンプレートも加わりました。 これらを準備しましたが、実際のところ、ポストをどうやってHTMLファイルに出力すればいいのでしょうか？ Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+正確には、 ビュー が モデルとテンプレートの橋渡しをしてくれます。 In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+まず blog/views.py を開きます。今のところ post_list ビュー は、以下のようになっているでしょう。
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+少し前に、別のファイルに用意したコードをどうやってインクルードするか説明したのですけれど、覚えていますか？ Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). そして、モデルの名前を指定してインポートします(この場合のモデルは Post ですね).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## クエリセット
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+作成したクエリセットは、 変数 posts で参照できることに、注意しましょう。この 変数 posts を使って、クエリセットのデータにアクセスします。これから先 posts というと、このクエリセットのことです。
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. 表示させたいのはクエリセットのデータなので、 posts を指定しましょう). :) こんな風に、記述することになります。 {'posts': posts}. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+最終的に blog/views.py は、以下の様になるはずです。
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+どうでしたか？次は、このクエリセットをテンプレートで表示させるところを、やってみましょう。
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/ja/extend_your_application/README.md b/ja/extend_your_application/README.md
new file mode 100644
index 00000000000..07e6bef3246
--- /dev/null
+++ b/ja/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# プログラムアプリケーション拡張
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+練習しましょう！
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+こんな感じですね。
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+イェーイ！うまくできます！
+
+## もう一つ: deployの時間です!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+そうすると、PythonAnywhereのbashコンソールで見ると：
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+最後に、Webタブに行って、リロードします.
+
+そしてdeployします! おめでとうございます :)
\ No newline at end of file
diff --git a/ja/how_the_internet_works/README.md b/ja/how_the_internet_works/README.md
new file mode 100644
index 00000000000..f85b207eb60
--- /dev/null
+++ b/ja/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# インターネットのしくみ
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+まず最初に理解する必要があるのは、ウェブサイトがちょうどハードディスクで保存されるたくさんのファイルであるということです。 同様に、映画、音楽、または画像。 ただし、web サイトに対して一意である 1 つの部分がある: 彼らは、HTML と呼ばれるコンピューター コードを含まれます。
+
+あなたがプログラミングをよく知っていないならば、最初はHTMLをつかむのは難しいでしょう。しかし、あなたのウェブ・ブラウザ（Chrome、Safari、Firefoxなどのような）はそれが好きです。 ウェブ・ブラウザはこのコードがわかるようになっていて、あなたのウェブサイトのファイルを表示するよう設計されています。
+
+すべてのファイルと同様我々 はどこかハード ディスク上の HTML ファイルを保存する必要があります。 インターネット *サーバー* と呼ばれる特別な強力なコンピューターを使用します。 サーバーの主な目的は、データを格納する事。ですがそれを提供するため、画面、マウスまたはキーボードを持っていません。 That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+私たちは絵を書きました。
+
+![図 1.1](images/internet_1.png)
+
+混乱しているように見えますか？ In fact it is a network of connected machines (the above-mentioned *servers*). マシンの何千もの何百も! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![図 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![図 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![図 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ja/html/README.md b/ja/html/README.md
new file mode 100644
index 00000000000..90f30cc9455
--- /dev/null
+++ b/ja/html/README.md
@@ -0,0 +1,213 @@
+# HTML 入門
+
+テンプレートとは何でしょうか？
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## HTMLとは？
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## 最初のテンプレート
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+あなたのウェブサイトを見てみてください: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![図 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![図 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+それぞれのHTMLページは**head**と**body**という要素によって2つにわけられています.
+
+* **head**は文書についての情報を含む要素で、画面には表示されません。
+
+* **body**はWebページの一部として表示されるすべてを含む要素です。
+
+`<head>`でページの設定をブラウザに伝え、`<body>`でページの内容を伝えます。
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+ファイルを保存し、ページを更新してください。
+
+![図 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## テンプレートのカスタマイズ
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. こんにちは！ よろしくお願いします！ </p>
+        </div>
+
+        <div>
+            <p>公開日: 2014/06/14, 12:14</p>
+            <h2><a href="">2番目の投稿</a></h2>
+            <p> こんにちは！ よろしくお願いします！ </p>
+        </div>
+    </body>
+</html>
+```
+
+ここで3つの `div` セクションを作成しました。
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![図 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ja/install_git.md b/ja/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ja/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ja/installation/README.md b/ja/installation/README.md
new file mode 100644
index 00000000000..a1ecf4bca99
--- /dev/null
+++ b/ja/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+グッドラック！
+
+# インストール
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Pythonのインストール
+
+{% include "/python_installation/instructions.md" %}
+
+# virtualenvのセットアップとDjangoのインストール
+
+{% include "/django_installation/instructions.md" %}
+
+# コードエディタのインストール
+
+{% include "/code_editor/instructions.md" %}
+
+# Gitのインストール
+
+{% include "/deploy/install_git.md" %}
+
+# GitHubのアカウント作成
+
+[GitHub.com](https://www.github.com)にアクセスし、Sign upを押して無料の新規アカウントを作成してください。
+
+# PythonAnywhereのアカウント作成
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [ジャンゴってなに？](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ja/instructions.md b/ja/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/ja/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ja/intro_to_command_line/README.md b/ja/intro_to_command_line/README.md
new file mode 100644
index 00000000000..3f5644ee6c8
--- /dev/null
+++ b/ja/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**最初にお友達になるのはコレです。: コマンドライン!**
+
+プログラマーが黒い画面に向かっている光景を見たことがありますか？ここからは、その黒い画面を触ってみます。最初はちょっとコワイと思うかもしれませんが、そんなことはありません。プロンプトと呼ばれるものがあなたの命令（コマンド）を待っています。
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+さて、コマンドライン あるいは コマンドライン　インターフェイスと呼ばれるこの画面は、キーボードで入力したテキストで命令を出してコンピューターと直接対話するように、 It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. このコマンドラインは、 cmd, CLI, プロンプト, コンソール or ターミナル と呼ばれることもあります.
+
+## Open the command-line interface
+
+では、実際にコマンドラインを開いて、触ってみることとしましょう。
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+おそらく ［アプリケーション］ー［アクセサリ］ー［ターミナル］と選択し起動できるでしょう。あなたのシステムによってはこの通りではないことがあります。見つからないときは、Google先生にきいてみましょう. :)
+
+<!--endsec-->
+
+## Prompt
+
+おそらく今、真っ白または真っ黒な画面が開かれていることでしょう。この画面はあなたの命令を待っています。
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Windowsの方は、 > という記号が表示されていることでしょう。
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+各コマンドの先頭には、この記号とスペースがつきます。あなたのコンピューターが表示してくれるので、自分で入力する必要はありません. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+そして最後にEnterキーを押して下さい。このような結果が返ってきます
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+ご覧のとおり、コンピューターがあなたのユーザーネームを表示してくれましたね。面白いでしょ? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+OSによってコマンドが若干違います。あなたのコンピューターのOSの方法に従って、以下は進めていってくださいね。次にいってみましょう。
+
+### Current directory
+
+今どこのディレクトリにいるか（どのフォルダで作業をしているか）、知りたいですよね？では、このようにキーボードで入力して、Enterキーをおしてください。
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> 補足: 'pwd' は'print working directory'を意味しており、現在いる作業ディレクトリを取得することです。
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+おそらく、似たようなものがあなたの画面に表示されたのではないでしょうか。コマンドラインを起動した最初は、通常ユーザーのホームディレクトリが表示されます。
+
+* * *
+
+### List files and directories
+
+では、その中には何があるのでしょうか？表示させてみましょう。
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+次に、デスクトップのディレクトリに移動してみましょう。
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+本当に変更されたかどうか確認してみてください：
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+できていますね！
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+それでは、Django Girlsのディレクトリをデスクトップに新規作成してみましょう。
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+この短いコマンドで、デスクトップにpracticeという名前の新しいフォルダが作成されました。 あなたのデスクトップを見てフォルダが作成されていることを確認してみましょう。あるいは、先ほど学んだコマンド` ls/dir` を使って確認しましょう。 やってみてください. :)
+
+> 同じコマンドを何度もなんども入力したくない時は、上下矢印キー↑，↓を押せば、先ほどキーボードから入力したものが現れます。内容を修正したい場合には，左右矢印キー←，→を利用して修正したい位置にカーソルを移動させて，修正することができますよ。
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+おめでとうございます！よくできました！
+
+* * *
+
+### Clean up
+
+練習がおわったら、それをそのままに置いておくと邪魔になりますね。削除しておきましょう。
+
+はじめに、作業するディレクトリをデスクトップに戻しましょう。
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+現在の作業ディレクトリを確認しておきましょう。
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+では、practiceディレクトリを削除しましょう。
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+ここまでです。それではコマンドラインを終了しましょう。かっこいいやり方で終わりたいですよね? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+かっこいいですね? :)
+
+## 概要
+
+ここに学んだコマンドをまとめておきます。
+
+| コマンド (Windows) | コマンド (Mac OS / Linux) | 説明                         | 例                                                 |
+| -------------- | --------------------- | -------------------------- | ------------------------------------------------- |
+| exit           | exit                  | ウインドウを閉じる                  | **exit**                                          |
+| cd             | cd                    | ディレクトリを変更                  | **cd test**                                       |
+| cd             | pwd                   | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir            | ls                    | ディレクトリ/ファイルの一覧を表示          | **dir**                                           |
+| copy           | cp                    | ファイルのコピー                   | **copy c:\test\test.txt c:\windows\test.txt** |
+| move           | mv                    | ファイルを移動                    | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir          | mkdir                 | 新しいディレクトリを作成               | **mkdir testdirectory**                           |
+| rmdir (or del) | rm                    | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S       | rm -r                 | delete a directory         | **rm -r testdirectory**                           |
+
+ここで勉強したのはコマンドのほんの一部でしたが、このワークショップで使うコマンドはこれだけです。
+
+もっと勉強したい方は、 ss64.com に各OSのコマンド一覧があります。ご参考までに。
+
+## Ready?
+
+よし、次はPythonを勉強していきましょう!
\ No newline at end of file
diff --git a/ja/python_installation/README.md b/ja/python_installation/README.md
new file mode 100644
index 00000000000..d3afd85cb94
--- /dev/null
+++ b/ja/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Pythonのインストール
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ja/python_installation/instructions.md b/ja/python_installation/instructions.md
new file mode 100644
index 00000000000..46d73c9b178
--- /dev/null
+++ b/ja/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> このセクションはGeek Girls Carrots(http://django.carrots.pl)をベースで作成しました。
+
+Django は、Pythonで開発されています。なにをするにせよ、まずはPythonが必要です。インストールしましょう！ Python 3.6 をインストールします。3.5以前のバージョンをインストール済みの場合は、アップグレードしてください。
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* *Mac OS X 64-bit/32-bit installer* ファイルをダウンロードしてください。
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ja/python_introduction/README.md b/ja/python_introduction/README.md
new file mode 100644
index 00000000000..7fa20974059
--- /dev/null
+++ b/ja/python_introduction/README.md
@@ -0,0 +1,1061 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+さあ、コードを書いてみましょう！
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+Pythonであそぶために、コマンドライン を開きましょう。 You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+準備ができたら、次の指示に従ってやってみましょう。
+
+Pythonコンソールを開きましょう。Windowsならpython、Mac OSやLinuxならpython3とタイプして Enterキーをおしてください.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+Pythonのコマンドが走ると、プロンプト記号が >>>に変わりました。 これは、今Pythonの言語を実行できますという意味です。 You don't have to type in `>>>` – Python will do that for you.
+
+Pythonコンソールを終わる時は、exit()　とタイプするか、ショートカットCtrl + Z （Windows）、 Ctrl + D（Mac/Linux）で終了です。 >>> は現れなくなりました。
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+ちょっとの間楽しんであそんでみたら、またココに戻ってきてくださいね. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+あなたのお名前を次のようにクォーテーションをつけてタイプしてください。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+はじめてのString（文字列）が完成です！ Stringとは、文字の集合のことです。 シングルクォーテーション (') あるいは、ダブルクォーテーション (") で囲います。 - クォーテーションの中が文字列であることを意味しています。
+
+複数の文字列を結合することもできます。次のように試してみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+文字列を繰り返すためには、演算子を使って繰り返し回数を指定することもできます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+アポストロフィーを文字列の中に含めたい場合は、２通りの方法があります。
+
+まずは、ダブルクォーテーションを使う方法です。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+あるいは、バックスラッシュ (\)を使う方法もあります。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+できましたか？次に、あなたの名前を大文字に変えてみましょう。次のように記述してください。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+どうして、文字列の後に. をつけて関数を呼び出したり ("Ola".upper()のように)、あるいは、先に関数を呼び出してかっこの中に文字列をいれているのか、と疑問に思ったかもしれません。 そうですね。時に、オブジェクトに結びついた関数というのがあります。例えば、upper()は、文字列にのみ実行される関数です。 私たちはこれをメソッド (method)と呼びます。 それとは別に、特定のオブジェクトに関連せず、異なるタイプのオブジェクトに対して実行できる関数があります。例えばlen()ですね。 len 関数の引数として"Ola"をかっこの中にいれているのです。
+
+### 概要
+
+文字列はだいじょうぶですね。ここまでに学んだことをまとめましょう。
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+すべてのプログラミング言語に共通する基礎になります。 もう少し難易度の高いものに挑戦してみましょう。準備はいいですか？
+
+## Errors
+
+さて、新しいことをやってみましょう。あなたの名前の文字数を数えたように、数字の文字列は数えれるでしょうか？ len(304023)と記述して、Enterキーを押してみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+はじめてのエラーがでました！オブジェクトタイプ"int" (integers, 数値) は文字数がありませんと言っています。では、どうすればよいでしょうか？この数字を文字列として扱えれば、文字数を数えれるはずですよね？
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+うまく行きました！ `str` 関数を`Len`の中に記述しました。`str()` はその中身を文字列に変換します。
+
+- `Str` 関数 は**文字列** に変換します
+- `int` 関数 は**文字整数** に変換します
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+変数（variables）は、プログラミングの重要なコンセプトです。 後で使うためにつける単なる名札ではありません。 プログラマーは変数を使ってデータを保管したり、 コードを読みやすくして、後でそれが何だったか覚えておかなくてもいいようにします。
+
+変数`name`を新しくつくってみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+見てのとおり、プログラムは、なにも返してくれませんね。では、変数がきちんとあるか、どうやって確かめたらいいのでしょうか？ `name`とタイプして、</code>0>Enterキー</0>をおしてください。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+関数にも使えます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+もしも、間違えた変数名を使ってしまったら、どうなるでしょうか？予想できますか？やってみましょう！
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+エラーになりました！ 前回とは違うエラータイプです。**NameError**という、初めてみるエラータイプですね。 作成されていない変数を使った時は、Pythonがエラーを教えてくれます。 もし、このエラーに出くわしたら、記述したコードにタイプミスがないか確認してください。
+
+ちょっと遊んで、何ができるか試してみてくださいね！
+
+## The print function
+
+次に挑戦してみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+単に`name`とタイプした時は、Pythonインタプリタが、変数'name'の *representation*を返します。 ここでは、 M-a-r-i-aという単なる文字の集まりで、シングルクォーテーション（''）に囲われています。 しかし、 print(name)と記述した時は、Pythonは変数の中身を出力します。クォーテーションはありません。
+
+これからさらに詳しくみていきますが、`print()` は、関数から出力をする時や、複数行の出力を行うときにも便利です。
+
+## Lists
+
+数値と文字列の他にも、すべてのオブジェクトタイプを勉強しておきましょう。 **list**というものがあります。 リストは、その名のとおり、オブジェクトの並びをもつものですね. :)
+
+まずはリストを作りましょう
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+はい、このリストは空っぽです。使いにくいですよね。では、くじ引きの番号のリストを作りましょう。 この番号を何度も繰り返し書きたくはないから、同時に変数に代入してしまいましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+よし、これでリストができました！このリストで何をしましょうか？では、くじ引きの番号がいくつあるか、数えてみましょう。何の関数を使えばいいか、予想できますか？すでに知っていますよね！
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+そうです！`len()` がリストにあるオブジェクトの数を取得できます。便利ですね。では、くじ引きの番号をソートしてみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+これは何も返してきません。これはリストに表示される番号を、順番に並べ替えただけです。再度出力して、確かめてみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+ご覧のとおり、小さい順に並び替えられましたね。おめでとう！
+
+逆順に並び替えてみたくなりましたか？やってみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+最初の数字だけを出力したいときは、インデックス**indexes**を使って指定することができます。 インデックスは、アイテムがリストのどこにあるかを指す番号です。次のとおり試してみてください。 インデックスは、リストの先頭の要素から順に「０」、次に「１」と割り当てられています。次のとおり試してみてください。 次に挑戦してみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+このように、リスト名と要素のインデックスを[]に記述することで、指定した要素を取り出すことができます。
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+お見事！
+
+他のインデックスも試して遊んでみてください。例えば、 6, 7, 1000, -1, -6, -1000 などをインデックスに指定するとどうなるでしょうか。コマンドを実行する前に予測してみましょう。結果はどうですか？
+
+ご参考に、こちらのドキュメントにリストメソッドがすべて記されています。 https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+これで中身が空っぽのディクショナリができましたね。やったね！
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- キー `name` が指す値 `'オーラ'` (`string` オブジェクト)
+- キー `country` が指す値 `'Poland'` (`string` オブジェクト),
+- キー `favorite_numbers/0> は リスト <code>[7, 42, 92]/0>。 (数字を3つ持つlist).</li>
+</ul>
+
+<p>次の構文で各キーの値を確認できます。</p>
+
+<p>{% filename %}command-line{% endfilename %}</p>
+
+<pre><code class="python">>>> print(participant['name'])
+Ola
+`</pre> 
+    See, it's similar to a list. But you don't need to remember the index – just the name.
+    
+    もし存在しないキーを参照しようとすると、どうなるでしょうか？予想できますか？実際にやってみましょう！
+    
+    {% filename %}command-line{% endfilename %}
+    
+    ```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+またエラーです。今回は **KeyError**.というエラーが出ました。Pythonは、このディクショナリにキー'age'は存在しませんよ、と教えてくれています。
+
+ディクショナリとリストはどう使い分ければよいのでしょうか？そうですね、これはゆっくり考えてみるべきポイントですね！この後の解答を読むまえに、考えてみてください。
+
+- 必要なのは、順序付けられた一連のアイテムですか？　リストを使いましょう。
+- キーに対応する値が必要？キーから値を参照する？　ディクショナリを使いましょう。
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. 例えば、 キー`'favorite_numbers'`の要素を削除するには、次のように記述してください。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### 概要
+
+素晴らしいです! これで、あなたはプログラミングについて沢山のことを学びました。ここまでのところをまとめましょう。
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+次に進む準備はいいですか？
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+２つの数字がイコールであるかどうかを比べる時に、イコールの記号が２つ==並んでいます。 Pythonを記述する時、イコール１つ=は、変数に値を代入するときに使います。 You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. 等しくないものを求める事もできます。 その時は例のように `!=`と記述します。
+
+次の２つはどうでしょうか
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x > y : x は y　より大きい
+- x < y : x は y　より小さい
+- x <= y : x は y　以下
+- x >= y : x は y　以上
+
+すばらしい! もう少しやってみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+条件式が複数あって複雑になっても、その答えを出してくれます。とても賢いですね。
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+"comparing apples to oranges"という英語の表現を聞いたことはありますか？文字通り訳すと「リンゴとオレンジを比較する」となり、「比較にならないものを比較する」という意味です。Pythonでも同じようなことをやってみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Pythonは、数値(int)　と文字列(str)の比較はできません。 **TypeError** とエラーが表示され、２つのオブジェクトタイプが比較できないことを教えてくれています。
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+ブール型は、次のように変数に代入することもできます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+このようなこともできます。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+ブール型を使って、練習して遊んでみましょう。次のコマンドを試してみてください。
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+おめでとうございます！ブール型を理解することは、プログラミングでとても大事です。ここまでできましたね！
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+ここまでインタプリタでPythonのコードをかいてきました。つまり、コードを１行づつしか書くことができませんでした。 普通のプログラムはファイルに保存され、インタプリタ あるいは コンパイラでプログラミング言語を処理して実行します。 ここまで、私たちはプログラムを１行ごとにPython インタプリタで実行してきました。 ここかっらは、１行以上のコードを実行していきましょう。次のような流れになります。
+
+- Pythonインタプリタを終了します。
+- お好きなエディタを起動します。
+- Pythonファイルとしてコードを保存します。
+- 実行します！
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+これで、コマンドプロンプトに戻りました。
+
+前のチャプター [code editor](../code_editor/README.md) で、エディタを紹介しました。エディタを起動して、新しいファイルにコードを書いてみましょう。
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+あなたは、すでにベテランのpython開発者です。今日学んだコードを自由に書いてみてください。
+
+コードを書いたら、わかりやすい名前をつけて保存しましょう。 **python_intro.py**と名前をつけて、デスクトップに保存してください。 ファイル名は何でもかまいません。ここで重要なことは、拡張子を**py**とすることです。 The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. これは「構文」と呼ばれています「ハイライトする」こと、そして、コーディングとき、それは本当に役に立つ特徴です。 The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). これが私たちがコードエディタを使う理由の１つです. :)
+
+ファイルを保存したら、実行してみましょう！コマンドラインのセクションで学んだことを思い出して、ターミナルの **ディレクトリを変更**して、デスクトップにしましょう。
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Macでは、コマンドは次のようになります。
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+うまくできない時は、質問してください。
+
+次に、ファイルのコードを実行します。
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+できました！これで、あなたはファイルに保存されたPythonプログラムを実行できましたね。いい気分ですね。
+
+では、ここからプログラミングに不可欠のツールを学んでいきましょう
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+では、**python_intro.py** ファイルのコードを次のように書き換えてください。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+条件式 3 > 2　がTrueの時、どのように処理をすべきかが記述されていませんね。 では、Python に “It works!”　と出力してもらいましょう。 **python_intro.py **ファイルの中身を、次のとおりに書き換えてください。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+２行目をスペース４つでインデントしていることに気が付きましたか？ if文がTrueの時、どのコードを実行するかPythonに知らせる必要があります。 スペース１つでもできますが、ほぼ全員のPythonプログラマーはスペース４つとしています。 タブ１つも、スペース４つと同じです。
+
+保存して、もう一度実行してみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+前述の例では、if文の条件式がTrueの時だけ、コードが実行されました。Pythonは、elif や else といった記述もできます。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+これを実行した場合、次のように出力されます。
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+それを実行すると...
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+`elif`を追加する事で 、上記の条件が失敗した場合に実行する余分な条件を追加する事ができます。
+
+最初の条件分岐の後に好きなように多くの`elif`を追加する事ができます。例えば...
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Pythonは上から順番に各条件をテスト、実行し、出力します。
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### 概要
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+では、このチャプターの最後のパートに挑戦していきましょう！
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+実行する機能をひとまとめにしたものを関数といいます。 Pythonでは、functionは`def`というキーワードからはじまり、引数を含むことができます。 Let's give it a go. **python_intro.py** の中身を書きのコードに置き換えてください。:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+あなたの最初の関数を実行する準備ができましたね!
+
+ここであなたは、最後の行になぜ関数の名前を書いたのだろう、と疑問に感じたかもしれません。 これは、Pythonがファイルを読み、上から下へ実行していくからです。 関数を定義したあとに、もう一度その関数を書いて呼び出します。
+
+では実行して、どうなるか見てみましょう:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+このとおり、関数に`name`という引数を足します。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+上記のように、`print`関数の前に、インデントを２ついれる必要があります。` if の条件式`が真の時に、なにをすべきかという処理はインデントの後に記述します。 実行して、どのように動くか見てみましょう。
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+おっと、エラーがでてしまいました。 Pythonがエラーメッセージを表示してくれています。 定義した関数`hi()`は、`name`という引数が必要ですが、関数を呼び出す時に引数を忘れてしまっています。 最後の行を修正しましょう。:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+実行してください。:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+では、名前を変えてみたらどうなりますか？
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+再度実行してください。:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+すばらしいですね。 挨拶をする人の名前を毎回何度も繰り返して書く必要がなくなりました。 And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+では、実行してみましょう。：
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+おめでとうございます！Functionsの書き方を学びましたね。:)!
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+さぁ、もう最後のパートですよ。あっという間ですね。 :)
+
+先ほどお話したとおり、プログラマーはめんどくさがりで、同じことを繰り返すことは好きではありません。プログラミングはすべてを自動的に処理したい。私たちはすべての人の名前ひとつひとつに対して挨拶をしたくないですよね？こういう時にループが便利です。
+
+リストを覚えていますか？女の子の名前をリストにしてみましょう。:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+名前を呼んで、全員にあいさつをしてみましょう。` hi `関数が使えますね。ループの中でつかいましょう。:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+ファイルに書かれるコードはこのようになります。
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+実行してみましょう。:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+ご覧のとおり、girlsリストのすべての要素に対して、`for `の中にインデントして書かれたことが繰り返されています.
+
+for 文では、range 関数をつかって指定した回数だけ繰り返すこともできます。:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+これを実行すると、次のように出力されます:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+range関数は、引数に指定した開始と終了の数値から連続する数値の値を要素として持つリスト型のオブジェクトを作成します。
+
+2つ目の引数（終了の数値）は、リストに含まれないことに注意してください。 That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## 概要
+
+以上です！**おめでとう！頑張りました！** これは簡単ではなかったと思います。自分を褒めてあげてくださいね。ここまで進めることができたのは、本当に素晴らしいことです！
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ja/signup_pythonanywhere.md b/ja/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/ja/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ja/template_extending/README.md b/ja/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/ja/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ja/whats_next/README.md b/ja/whats_next/README.md
new file mode 100644
index 00000000000..59911d7b817
--- /dev/null
+++ b/ja/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+おめでとう!**! <3</p> 
+
+### あなたは今何をすべきですか？
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/kk-KZ/GLOSSARY.md b/kk-KZ/GLOSSARY.md
new file mode 100644
index 00000000000..4aa1d336ce5
--- /dev/null
+++ b/kk-KZ/GLOSSARY.md
@@ -0,0 +1,3 @@
+# Мәтіндік редактор
+
+Мәтіндік редактор - ол кодты сақтап, кейінірек қайта қодануға арналған қосымша [Мәтіндік редактор тарауынан](./code_editor/README.md) өзіңізге керекті ақпаратты таба аласыз
\ No newline at end of file
diff --git a/kk-KZ/README.md b/kk-KZ/README.md
new file mode 100644
index 00000000000..c731f559bd3
--- /dev/null
+++ b/kk-KZ/README.md
@@ -0,0 +1,51 @@
+# Django Girls нұсқаулығы
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Қош келдің
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## Осы нұсқаулық бойынша не үйренесің?
+
+Оқулықты аяқтағаннан кейін сізде шағын жұмыс істейтін веб-бағдарлама болады: ол өз блогыңыз. Басқалар сіздің жұмысыңызды көруі үшін оны интернетте қалай орналастыру керектігін көрсетеміз!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/kk-KZ/SUMMARY.md b/kk-KZ/SUMMARY.md
new file mode 100644
index 00000000000..d9741b4f21c
--- /dev/null
+++ b/kk-KZ/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/kk-KZ/chromebook_setup/README.md b/kk-KZ/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/kk-KZ/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/kk-KZ/chromebook_setup/instructions.md b/kk-KZ/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..902aca7984e
--- /dev/null
+++ b/kk-KZ/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Егер сіз Хромбукты қолданбасаңыз, онда [осы секцияны секіріп кете аласыз](http://tutorial.djangogirls.org/en/installation/#install-python). Егер сіздің орнату жағдайыңыз кішкене басқаша болса. Онда қалған инструкцияларды елемеуге болады.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE құралы сізге код редакторын және кашықтықтағы компьютерін қолдануға рұқсат береді. Сол компьютерде сіз бағдарламаны орната, жаза және орындата аласыз. Осы сабақтар кезеңінде бұлттық IDE сіздің *локалдық машинасын* рөлін атқарады. Убунту, Windows, OSX қолданушылар сияқты сіз командаларды терминал интерфейсінде жазуға мүмкіндік болады. Бірақ сіздің терминалыңыз бұлттық IDE берген компьютерге жалданады. Осы жерде бұлттық IDE-ге (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com) арналған нұсқаулықтар. Сіз бұлттық IDE бірін тандап және сол бұлттық IDE нұсқаулығын қолдана аласыз.
+
+#### PaizaCloud Бұлттық IDE
+
+1. [PaizaCloud Cloud IDE](https://paiza.cloud/) парақшасына барыңыз
+2. Тіркеліңіз
+3. *New Server* шертініз және Django қосымшасын тандаңыз
+4. Терминал түймесін шертіңіз (терезенің сол жағында)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/kk-KZ/code_editor/README.md b/kk-KZ/code_editor/README.md
new file mode 100644
index 00000000000..0a401fb1f52
--- /dev/null
+++ b/kk-KZ/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/kk-KZ/code_editor/instructions.md b/kk-KZ/code_editor/instructions.md
new file mode 100644
index 00000000000..a02284e177a
--- /dev/null
+++ b/kk-KZ/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Көптеген редакторлар бар. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/kk-KZ/css/README.md b/kk-KZ/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/kk-KZ/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/kk-KZ/deploy/README.md b/kk-KZ/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/kk-KZ/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/kk-KZ/deploy/install_git.md b/kk-KZ/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/kk-KZ/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/kk-KZ/deploy/signup_pythonanywhere.md b/kk-KZ/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/kk-KZ/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/kk-KZ/django/README.md b/kk-KZ/django/README.md
new file mode 100644
index 00000000000..82b1ab2f9fd
--- /dev/null
+++ b/kk-KZ/django/README.md
@@ -0,0 +1,27 @@
+# Джанго деген не?
+
+Django (/ˈdʒæŋɡoʊ/ *джэн-го*) ол бос және веб қосымша фреймворгы. Джангоның коды ашық және ол Питонда жазылған. Веб фреймворк - вебсайттарды тезірек және оңайырақ құруға көмектесетін компоненттердің жинағы.
+
+Вебсайт құрғанда сізге әрдайым ұқсас компонентер керек. Мысалы: пайдаланушыны анықтап тануының өңдеу жолы (тіркелу, кіру, шығу), сайтты өзгертетін басқару тақтасы, форма, файлдарды жүктеу жолы және басқалары.
+
+Қуанышқа орай, басқа адамдар бұрында веб дамытушылар жаңа сайт құрғанда бірдей мәселелерді кездесетінің байқаған. Сонда олар жиналды және фреймворктарды құрды (Джанго солардың қатарына кіреді). Фреймворк іске дайын компонентерді сізге қолдануға береді.
+
+Дөнгелекті жаңадан құрудан сақтау ушін фреймворктар бар. Жәнеде жаңа сайт құрып жатқанда басты ауыртпау үшін.
+
+## Фреймворк сізге не үшін керек?
+
+Джанго не үшін керек екенің түсіну үшін, біз сервермен жақынырақ танысу керекпіз. Ең бастысы, сервер қандай вебпарақша орналастыру керек екенің білу керек.
+
+Кіріс хаттарды бақылауға (сұраныс) арналған электрондық жәшікті елесте (порт). Соны бақылап тұратын веб-cервер. Веб сервер хатты оқиды, содан кейін вебпарақша түрінде жауапты жібереді. Бірақ сіз бір нәрсе жібергіңіз келсе, сізде бір контент болу керек. Джанго сол контентті құру үшін көмектеседі.
+
+## Егер біреу сіздің серверінізде вебсайтқа сұраныс жасаса не болады? 
+
+Егер веб серверге сұраныс келсе, онда ол Джангоға барады. Біріншіден, ол веб парақшаның адресін алады және не істеу керек екенің анықтап отырады. Осы анықтау жұмысы Джангоның urlresolver модулімен өнделеді. Байқаныз, вебсайтты адресі URL деп аталады. URL resolver веб парақшалардың контенті қандай болу керек екенің шешеді. Ол тым ақылды емес - ол паттерндардың тізімін алады және URL-ды сәйкестіруге тырысады. Джанго үстіден астыға паттерндарды тексереді. Егер бірденке сәйкес болса, Джанго сұранысты тиісті функцияға апарады. Джангода оны *view* деп айтамыз.
+
+Хатты қолында ұстап тұрған пошташыны елестет. Ол көше бойымен жүр және әр үйдің нөмірін хаттағы нөмірмен салыстырып жатыр. Егер сәйкестік болса, онда ол хатты есікте қалдырады. Үйістіп urlresolver жұмыс істейді.
+
+Қызықтың бәрі *view* функциясында жасалған: бір ақпарат табу үшін біз деректер базасында көре аламыз. Егер қолданушы бір ақпаратты өзгертуге сұраса? Мысалы бір хатта жазылған: "Менің жұмысымңың сипаттамасын өзгертіңіз." Сізде өзгертуге рұқсат бар екенің, *view* тексере алады. Содан кейін жұмыс сипаттамасын сіз үшін өзгертеді және жаұап қайтарады: "Жасалды!". Содан кейін *view* жауапты құрады және Джанго оны пайдаланушыдың веб браузеріне жібере алады. 
+
+Үстіндегі сипаттама кішкене жеңілдетілген, бірақ техникалық заттардың бәрін білуге сізге қажет емес. Жалпы ойды түсіну жеткілікті.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/kk-KZ/django_admin/README.md b/kk-KZ/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/kk-KZ/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/kk-KZ/django_forms/README.md b/kk-KZ/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/kk-KZ/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/kk-KZ/django_installation/README.md b/kk-KZ/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/kk-KZ/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/kk-KZ/django_installation/instructions.md b/kk-KZ/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/kk-KZ/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/kk-KZ/django_models/README.md b/kk-KZ/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/kk-KZ/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/kk-KZ/django_orm/README.md b/kk-KZ/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/kk-KZ/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/kk-KZ/django_start_project/README.md b/kk-KZ/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/kk-KZ/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/kk-KZ/django_templates/README.md b/kk-KZ/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/kk-KZ/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/kk-KZ/django_urls/README.md b/kk-KZ/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/kk-KZ/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/kk-KZ/django_views/README.md b/kk-KZ/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/kk-KZ/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/kk-KZ/dynamic_data_in_templates/README.md b/kk-KZ/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/kk-KZ/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/kk-KZ/extend_your_application/README.md b/kk-KZ/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/kk-KZ/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/kk-KZ/how_the_internet_works/README.md b/kk-KZ/how_the_internet_works/README.md
new file mode 100644
index 00000000000..21996190ca5
--- /dev/null
+++ b/kk-KZ/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Интернет қалай жұмыс істейді
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+Бәстесуге дайынмын сіз күн сайын интернет қолданасың. Бірақ браузерге кіріп https://djangogirls.org адресін енгізген кезде не болатынын білесіз бе?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/kk-KZ/html/README.md b/kk-KZ/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/kk-KZ/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/kk-KZ/installation/README.md b/kk-KZ/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/kk-KZ/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/kk-KZ/intro_to_command_line/README.md b/kk-KZ/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/kk-KZ/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/kk-KZ/intro_to_command_line/open_instructions.md b/kk-KZ/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/kk-KZ/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/kk-KZ/python_installation/README.md b/kk-KZ/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/kk-KZ/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/kk-KZ/python_installation/instructions.md b/kk-KZ/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/kk-KZ/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/kk-KZ/python_introduction/README.md b/kk-KZ/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/kk-KZ/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/kk-KZ/template_extending/README.md b/kk-KZ/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/kk-KZ/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/kk-KZ/whats_next/README.md b/kk-KZ/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/kk-KZ/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/kn-IN/GLOSSARY.md b/kn-IN/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/kn-IN/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/kn-IN/README.md b/kn-IN/README.md
new file mode 100644
index 00000000000..121da8f55bf
--- /dev/null
+++ b/kn-IN/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/kn-IN/SUMMARY.md b/kn-IN/SUMMARY.md
new file mode 100644
index 00000000000..d9741b4f21c
--- /dev/null
+++ b/kn-IN/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/kn-IN/chromebook_setup/README.md b/kn-IN/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/kn-IN/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/kn-IN/chromebook_setup/instructions.md b/kn-IN/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..2df2048e6ec
--- /dev/null
+++ b/kn-IN/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/kn-IN/code_editor/README.md b/kn-IN/code_editor/README.md
new file mode 100644
index 00000000000..0a401fb1f52
--- /dev/null
+++ b/kn-IN/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/kn-IN/code_editor/instructions.md b/kn-IN/code_editor/instructions.md
new file mode 100644
index 00000000000..82fbac15aad
--- /dev/null
+++ b/kn-IN/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/kn-IN/css/README.md b/kn-IN/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/kn-IN/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/kn-IN/deploy/README.md b/kn-IN/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/kn-IN/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/kn-IN/deploy/install_git.md b/kn-IN/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/kn-IN/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/kn-IN/deploy/signup_pythonanywhere.md b/kn-IN/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/kn-IN/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/kn-IN/django/README.md b/kn-IN/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/kn-IN/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/kn-IN/django_admin/README.md b/kn-IN/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/kn-IN/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/kn-IN/django_forms/README.md b/kn-IN/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/kn-IN/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/kn-IN/django_installation/README.md b/kn-IN/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/kn-IN/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/kn-IN/django_installation/instructions.md b/kn-IN/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/kn-IN/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/kn-IN/django_models/README.md b/kn-IN/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/kn-IN/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/kn-IN/django_orm/README.md b/kn-IN/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/kn-IN/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/kn-IN/django_start_project/README.md b/kn-IN/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/kn-IN/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/kn-IN/django_templates/README.md b/kn-IN/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/kn-IN/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/kn-IN/django_urls/README.md b/kn-IN/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/kn-IN/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/kn-IN/django_views/README.md b/kn-IN/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/kn-IN/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/kn-IN/dynamic_data_in_templates/README.md b/kn-IN/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/kn-IN/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/kn-IN/extend_your_application/README.md b/kn-IN/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/kn-IN/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/kn-IN/how_the_internet_works/README.md b/kn-IN/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/kn-IN/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/kn-IN/html/README.md b/kn-IN/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/kn-IN/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/kn-IN/installation/README.md b/kn-IN/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/kn-IN/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/kn-IN/intro_to_command_line/README.md b/kn-IN/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/kn-IN/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/kn-IN/intro_to_command_line/open_instructions.md b/kn-IN/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/kn-IN/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/kn-IN/python_installation/README.md b/kn-IN/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/kn-IN/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/kn-IN/python_installation/instructions.md b/kn-IN/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/kn-IN/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/kn-IN/python_introduction/README.md b/kn-IN/python_introduction/README.md
new file mode 100644
index 00000000000..66bdcf06d37
--- /dev/null
+++ b/kn-IN/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (`\`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/kn-IN/template_extending/README.md b/kn-IN/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/kn-IN/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/kn-IN/whats_next/README.md b/kn-IN/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/kn-IN/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/ko-KR/GLOSSARY.md b/ko-KR/GLOSSARY.md
new file mode 100644
index 00000000000..3d405faa668
--- /dev/null
+++ b/ko-KR/GLOSSARY.md
@@ -0,0 +1,3 @@
+# 코드 에디터
+
+코드 에디터는 코드를 저장하고 다시 불러올 수 있는 프로그램입니다. [코드 에디터 장](./code_editor/README.md)에서 배울 수 있습니다.
\ No newline at end of file
diff --git a/ko-KR/README.md b/ko-KR/README.md
new file mode 100644
index 00000000000..41a0c032004
--- /dev/null
+++ b/ko-KR/README.md
@@ -0,0 +1,51 @@
+# 장고 걸스 튜토리얼 (Django Girls Tutorial)
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> 이 튜토리얼은 Creative Commons Attribution-ShareAlike 4.0 International 저작권을 준수합니다. 라이센스 전문은 https://creativecommons.org/licenses/by-sa/4.0 에서 확인하세요.
+
+## 환영합니다
+
+장고 걸스 튜토리얼에 오신것을 환영합니다! 여기서 보게 되어 기뻐요 :) 이 튜토리얼에서는 우리가 웹 기술을 살펴보기위한 여정을 안내하며, 우리가 알고있는 웹을 작동시키기 위해 함께 알아가야하는 모든 부분을 간략하게 보여줍니다.
+
+모든 알려지지 않은 것들과 마찬가지로 이것은 모험이 될 것이지만 걱정할 필요는 없어요. 이미 여기에 다다르기 위해 용기를 내어왔기 때문에 괜찮답니다:)
+
+## 들어가며
+
+점점 기술이 중요한 세상에 살고 있지만 내가 뒤쳐진게 아닌가 하는 생각이 문득 든 적이 있었나요? 그동안 웹 사이트를 어떻게 만드는지 궁긍했지만 막상 시작하기 어려웠나요? 소프트웨어라는 세상이 너무 복잡해보여 스스로 직접 만들기엔 엄두가 나지 않았나요?
+
+여기 반가운 소식이 있습니다! 프로그래밍은 생각만큼 어려운 건 아니랍니다. 프로그래밍이 얼마나 재미있는 것인지 알려드리고 싶어요.
+
+물론 이 튜토리얼을 읽기만 하면 프로그래머가 되는, 그런 기적은 일어나지 않을 거에요. 프로그래밍에 능숙해지려면, 몇 달, 혹은 몇 년이나 공부하고 수련해야하죠. 그러나 프로그래밍이나 웹 사이트를 제작하는 것이 그렇게 복잡하지 않다는 것은 보여드리고 싶습니다. 여러분이 겁먹지 않도록 조금씩 설명해드릴거에요.
+
+우리가 그랬듯이 여러분들도 프로그래밍을 사랑할 수 있게 되길 바랍니다!
+
+## 튜토리얼에서 무엇을 배우게 되나요?
+
+이 튜토리얼을 끝내면, 여러분들은 간단하고 잘 작동하는 나만의 블로그 사이트를 완성할 수 있어요. 온라인에 올리는 방법도 배울 거에요. 다른 사람들도 여러분의 작품을 보게 될거에요!
+
+우리는 이렇게 만들어 볼 거에요.
+
+![그림 0.1](images/application.png)
+
+> 만약 이 튜토리얼을 따라가다가 문제가 발생했을 때 도와줄 코치가 없을 때에는 우리와 얘기할 수 있어요: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). 우리는 코치나 전 참가자들에게 이 곳에서 도움이 필요한 사람들을 도와달라고 요청해두었답니다! 어떤 질문이든 물어보는데 주저하지 마세요!
+
+자, [기본적인 것부터 시작해볼까요...](./how_the_internet_works/README.md)
+
+## 집에서 튜토리얼 따라하기
+
+장고걸스 워크샵에서 모든 분들을 만나고 싶지만, 참석하기 어려운 분들이 있다는 것을 알고 있어요. 그래서 워크샵에 참석을 못하는 분들은 집에서 튜토리얼을 보며 자습하시길을 권하고 있어요. 혼자서도 집에서 튜토리얼을 보며 학습하실 수 있게 비디오를 만들고 있어요. 현재 촬영이 진행 중이고, 더 많은 영상들을 [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) 유투브 채널에서 보실 수 있을 거에요.
+
+모든 장에서 바로 해당 영상을 보실 수 있게 링크를 연결했어요.
+
+## 튜토리얼에 참여하기
+
+이 튜토리얼은 [DjangoGirls](https://djangogirls.org/)에서 지속적으로 관리하고 있습니다. 오류를 발견하거나 튜토리얼 내용을 업데이트하고 싶다면 [가이드라인 참여방법](https://github.com/DjangoGirls/tutorial/blob/master/README.md)을 참고하세요.
+
+## 다른 언어로 번역하길 원하시나요?
+
+현재 crowdin.com 에서 번역이 진행되고 있습니다:
+
+https://crowdin.com/project/django-girls-tutorial
+
+당신의 언어가 crowdin에 없다면, 새로운 언어가 있다고 알려주는 [이슈를 열어주세요.](https://github.com/DjangoGirls/tutorial/issues/new) 그러면 우리가 추가해드릴께요.
\ No newline at end of file
diff --git a/ko-KR/SUMMARY.md b/ko-KR/SUMMARY.md
new file mode 100644
index 00000000000..6757a2d19d1
--- /dev/null
+++ b/ko-KR/SUMMARY.md
@@ -0,0 +1,35 @@
+# 목차
+
+* [들어가며](README.md)
+* [설치하기](installation/README.md) 
+  * [Command Line(커맨드라인)](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-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [설치(크롬북)](chromebook_setup/README.md)
+* [인터넷이 어떻게 작동하는가](how_the_internet_works/README.md)
+* [Command Line(커맨드라인) 시작하기](intro_to_command_line/README.md)
+* [파이썬 설치하기](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 urls](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)
\ No newline at end of file
diff --git a/ko-KR/chromebook_setup/README.md b/ko-KR/chromebook_setup/README.md
new file mode 100644
index 00000000000..756692cffa1
--- /dev/null
+++ b/ko-KR/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# 크롬북 설정
+
+> **참고** 이미 [설치 단계](../installation/README.md)를 거쳤다면, 이 부분을 다시 하실 필요는 없습니다 - 바로 Python 소개</1>부분으로 넘어가세요.</p> </blockquote> 
+> 
+> {% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ko-KR/chromebook_setup/instructions.md b/ko-KR/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..8c8dadacfbe
--- /dev/null
+++ b/ko-KR/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+크롬북 유저가 아니라면 [이번 섹션은 넘어가도 상관없습니다.](http://tutorial.djangogirls.org/en/installation/#install-python) 유저가 맞다면, 여러분의 설치 과정은 약간 다를 것입니다. 여러분은 설치 안내의 나머지 부분을 무시하셔도 됩니다.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+클라우드 IDE는 당신에게 코드 에디터와 인터넷에 연결되어있어 당신이 프로그램을 깔고, 작성하고 실행할 수 있는 컴퓨터의 접근 권한을 주는 도구입니다. 이 튜토리얼이 진행되는 동안, 클라우드 IDE는 *당신의 집 컴퓨터*처럼 사용될 것입니다. 당신은 여전히 OS X, Ubuntu, Windows 등에서 했던 것 처럼 터미널 화면에 명령어를 입력할 겁니다. 하지만 이번에는 그 터미널이 어딘가에서 당신을 위해 돌아가는 클라우드 IDE 컴퓨터에 연결되죠. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). 당신은 이 클라우드 IDE들 중에 한개를 골라 가이드를 따라하면 되요!
+
+#### PaizaCloud Cloud IDE
+
+1. [PaizaCloud Cloud IDE](https://paiza.cloud/) 사이트에 접속합니다.
+2. 새 계정을 생성합니다.
+3. *새 서버* 선택후 Django 앱을 선택합니다.
+4. Terminal 버튼(왼쪽 창에 있습니다) 버튼을 클릭합니다.
+
+이제 당신은 버튼이 왼쪽에 있는 사이드바 형태의 인터페이스를 볼 수 있을 겁니다. "Terminal" 버튼을 눌러 터미널 창을 연 뒤 해당 명령어를 입력하세요:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+PaizaCloud Cloud IDE 의 터미널은 당신의 명령어를 기다리고 있습니다. 당신은 윈도우의 크기를 조절하거나 최대로 할 수 있습니다.
+
+#### AWS Cloud9
+
+현재 Cloud9은 AWS 계정 등록과 신용카드 정보 등록을 필요로합니다
+
+1. [ 크롬 웹스토어](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)에서 Cloud9을 설치합니다.
+2. [c9.io](https://c9.io) 접속후 *AWS Cloud9 시작하기*를 선택합니다.
+3. AWS 계정 등록을합니다 (신용카드 정보 등록하셔야 하지만 무료로 사용하실수 있습니다).
+4. AWS 대쉬보드에서 *Cloud9*을 서치창에 입력후 클릭합니다.
+5. Cloud9 대쉬보드에서 *환경 만들기*를 클릭합니다.
+6. *django-girls*라고 이름 짓습니다.
+7. 세팅 설정중, "환경 속성"에서 * 환경에 새 인스턴스 만들기 (EC2)*와 *t2.micro* "인스턴스 속성"을 선택합니다 ("무료사용자등급 가능"이라 표시 되어야합니다). 기본 비용절약 설정과 다른 기본설정으로 괜찮습니다.
+8. *다음 단계*를 선택합니다.
+9. * 환경 만들기*를 선택합니다.
+
+이제 다음과 같이 사이드바, 텍스트가 있는 큰 메인 창, 그리고 하단에 작은 창이 있는 화면이 보이실 겁니다.
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+이 하단영역은 귀하의 터미널입니다. 이 터미널을 이용해 원격 Cloud9 컴퓨터에 커맨드에 커맨드를 보낼 수 있습니다. 창을 더 크게 조절하실수 있습니다.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### 가상 환경
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ko-KR/code_editor/README.md b/ko-KR/code_editor/README.md
new file mode 100644
index 00000000000..76f1c574363
--- /dev/null
+++ b/ko-KR/code_editor/README.md
@@ -0,0 +1,11 @@
+# 코드 에디터
+
+> 집에서 학습하시는 분을 위해: 이번 장은 [파이썬 및 코드 에디터설치 비디오](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s)을 이용해 다룰 거에요.
+
+이제 코드를 작성하기 위해 코드 에디터를 다운로드 할 때에요!
+
+> **Note**만약 크롬북을 사용하고 있다면 이번 장은 생략하고 크롬북 설정 지침을 따르고 있는지 확인하세요. 당신이 선택한 cloud IDE (PaizaCloud Cloud IDE or AWS Cloud9)는 코드 편집기를 포함하며 당신의 IDE의 파일 메뉴에서 파일을 열었을 때, 당신은 자동으로 그 편집기를 사용하고 있을 것입니다.
+> 
+> **주의** 앞 장 [설치하기](../installation/README.md)에서 설치를 이미 했다면, 다음 장으로 넘어가세요!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ko-KR/code_editor/instructions.md b/ko-KR/code_editor/instructions.md
new file mode 100644
index 00000000000..7c4b2d0c8d7
--- /dev/null
+++ b/ko-KR/code_editor/instructions.md
@@ -0,0 +1,37 @@
+코드 편집기는 다양하고 많은 종류가 있어 자신의 취향에 따라 선택할 수 있어요. 대부분의 파이썬 프로그래머는 PyCharm 과 같이 복잡하지만 파워풀한 IDE (통합개발환경: Integrated Development Environments) 를 이용합니다. 하지만, 초보자에게는 적절하지 않을 수도 있어요. 우리는 강력한 기능과 함께 간단하게 사용할 수 있는 에디터를 추천해요.
+
+아래에 저희의 코드 편집기 권장 사항이 있지만 여러분의 코치들에게 어떤 코드 편집기를 자주 사용하는지도 물어보세요. 코치들에게 도움 받는 것이 더욱 쉬울 거에요.
+
+## Visual Studio Code
+
+Visual Studio Code는 마이크로소프트가 윈도우, 리눅스, 맥OS를 위해 개발한 소스 코드 에디터입니다. 디버깅, 내장 Git 컨트롤,문법 하이라이팅, 지능형 코드 완성, 스니펫, 코드 리팩토링등 지원을 포함하고 있습니다.
+
+[이 곳에서 다운받을 수 있어요.](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit는 모든 운영체제에서 사용 가능한 무료 오픈소스에요. 
+
+[이 곳에서 설치할 수 있어요.](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text는 인기있는 에디터이면서 무료로 사용할 수 있어요. 그리고 설치나 사용이 편리하며 모든 운영체제에서 쓸 수 있어요.
+
+[이 곳에서 다운받을 수 있어요.](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom은 또 다른 인기 편집기입니다. 무료 및 오픈소스이며, 윈도우, OS X와 리눅스에서 사용가능합니다. Atom은 [GitHub](https://github.com/)에 의해 개발되었습니다.
+
+[이 곳에서 다운받을 수 있어요.](https://atom.io/)
+
+## 왜 코드 에디터를 설치해야 하나요?
+
+워드나 노트패드가 있는데도, 굳이 코드 에디터 소프트웨어를 설치해야하는 이유가 궁금할거에요.
+
+첫 번째 이유는 코드는 **순수한 텍스트**이여야 합니다. 그런데 Word나 Textedit 같은 프로그램의 문제는, 그 프로그램들이 제대로된 순수한 텍스트를 생성하지 않기 때문입니다. 그들은 [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format)와 같은 커스텀 서식을 쓴 rich 텍스트(폰트와 서식이 있는 텍스트) 를 생성합니다.
+
+두 번째 이유는 코드 에디터가 여러분이 개발을 할 때 도움이 되는 여러 기능들을 제공하기 때문이에요. 대표적인 예로, 코드를 해석해서 색으로 문법을 하이라이팅해주는 기능이라든가 쌍따옴표("") 를 자동으로 닫아주는 등과 같은 기능들이지요.
+
+우리는 앞으로 어떻게 작동하는지 확인할 거에요. 그러면 곧, 여러분은 자신이 선택한 코드 에디터를 제일 좋아한다고 생각하기 시작할 거에요.
\ No newline at end of file
diff --git a/ko-KR/css/README.md b/ko-KR/css/README.md
new file mode 100644
index 00000000000..43f7ad99d5a
--- /dev/null
+++ b/ko-KR/css/README.md
@@ -0,0 +1,329 @@
+# CSS - 예쁘게 만들기
+
+우리가 만든 블로그가 아직 예쁘지 않죠? 이제 눈에 보기 좋게 예쁘게 만들어 볼 시간이에요. CSS를 사용해 만들어볼 거에요.
+
+## CSS는 무엇인가요?
+
+CSS(Cascading Style Sheets)는 웹사이트의 보여지는 부분 나타낼 때 사용하는 HTML와 같은 마크업 언어에요. 우리 웹페이지를 예쁘게 메이크업 하는 것과 같아요. ;)
+
+하지만, 처음부터 다시 시작하고 싶지는 않죠? 한 번 더, 인터넷에서 다른 개발자가 만든 무료로 배포된 코드를 사용할 거에요. (자동차를 만들기 위해) 바퀴를 다시 발명하는 건 재미있지 않죠.
+
+## Bootstrap을 사용해봐요!
+
+부트스트랩(Bootstrap)은 예쁜 웹사이트를 개발하기 위해 사용되는 유명한 HTML과 CSS 프레임워크 중 하나에요: https://getbootstrap.com/
+
+부트스트랩은 트위터 개발자들에 의해 만들어졌고 전 세계 자원봉사자들이 지속적으로 참여해 발전시키고 있어요.
+
+## Bootstrap 설치하기
+
+Bootstrap을 설치하려면 코드 편집기에서 `.html ` 파일을 열고 이 파일을 `<head>` 섹션에 추가하십시오.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+당신의 프로젝트에 어떤 파일도 추가하지 않는다. 인터넷에 존재하는 파일만 가리키고 있다. 그러니 웹사이트를 열고 페이지를 새로 고치세요. 여기있다!
+
+![그림 14.1](images/bootstrap1.png)
+
+더 보기 좋아졌죠!
+
+## Django의 정적 파일
+
+마지막으로 **정적 파일(static files)**을 다뤄볼 거에요. 모든 CSS와 이미지들은 정적 파일(static file) 이에요. Css와 정적파일은 모든 유저들이 동일하게 보여지기 때문에 콘텐츠와 상관없어요.
+
+### 어디에 정적 파일을 넣어야 하나요
+
+서버에서 `collectstatic`를 실행할 때 처럼, 장고는 "admin" 앱에서 동적 파일을 어디서 찾아야하는지 이미 알고 있어요. 이제 `blog`앱에 동적파일을 추가하면 되어요.
+
+blog앱 안에 `static`폴더를 만드세요:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django는 app폴더 안에 있는 "static" 폴더를 자동으로 찾아 안에 있는 내용을 불러내요. 그러면 컨텐츠를 정적 파일로 사용할 수 있어요.
+
+## 나의 첫 번째 CSS 파일!
+
+CSS파일을 만들어 나만의 스타일을 가진 웹페이지를 만들어 봐요. `static` 디렉토리 안에 `css`라고 새로운 디렉토리를 만드세요. 그리고 `css`디렉토리 안에 `blog.css`라는 파일을 만드세요. 준비되셨나요?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+CSS를 쓸 차례에요! 여러분이 사용하고 있는 코드에디터에서 `blog/static/css/blog.css`파일을 불러오세요.
+
+우리는 여기서 CSS에 대해 깊게 배우거나 다루지않을 거에요. 만약 더 많이 배우고 싶다면, 페이지 마지막 부분에 무료 CSS 코스에 대한 추천을 참고하세요.
+
+하지만 조금이라도 해보자구요. 제목 색깔을 바꿔볼까요? 컴퓨터는 특별한 코드를 사용해 색깔을 나타내요. `#`으로 시작해 알파벳(A-F) 와 숫자(0-9) 중 6개를 조합해 나타내요(16진수로 말이에요). 예를 들어, 파란색 코드는 `#0000FF`입니다. 더 많은 색상 코드는 다음 링크에서 찾을 수 있어요: http://www.colorpicker.com/ 그리고 [미리 정의 된 색](http://www.w3schools.com/colors/colors_names.asp), 예를 들어 `빨간색` 또는 `녹색` 등도 사용할 수 있어요.
+
+`blog/static/css/blog.css`에 아래의 코드를 추가하세요.
+
+{% filename %}blog/templates/blog/post_blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a`가 CSS 셀렉터(Selector)에요. 이건 `h1` 안에있는 어떤 `a` 요소에도 스타일을 적용한다는 뜻입니다; `h2` 셀렉터도 `h2`요소에 같은 작용을 한답니다. 예를 들어 `<h1><a href="">link</a></h1>`은 `h1 a` {...} 을 통해 스타일이 적용됩니다. 위의 예시에서, 다크 오렌지인 `#FCA205`으로 색상을 바꾸라 명한 겁니다. 아니면 여기에 색상을 입히셔도 되지만, 하얀 배경에 대비가 잘 되도록 주의하세요!
+
+CSS파일에서는 HTML 파일에 있는 각 요소들에 스타일을 적용할 수 있어요. 요소를 식별하는 첫 번째 방법은 이름을 붙이는 겁니다. HTML에서 태그 이름으로 찾을 수 있겠죠. `a`, `h1`, `body`요소도 그 예입니다. 상속 `class` 또는 상속 `id`로 요소를 식별합니다. Class와 id는 여러분들이 붙인 이름을 갖게 되지요. 클래스는 요소들의 그룹을 결정하는 것이고, id는 특정 요소들을 지칭해요. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+W3Schools에서 [CSS Selectors](http://www.w3schools.com/cssref/css_selectors.asp)에 대해 더 읽을 수 있어요.
+
+HTML 템플릿에 CSS를 추가했다는 사실을 알려줄 필요가 있어요. 코드 에디터에 있는 `blog/templates/blog/post_list.html`파일을 열고 가장 위에 다음 줄을 추가하세요:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+드디어 정적파일을 실행시켰어요 :) `<head>`와 `</head>`사이에, 아래 코드를 추가해 부트스트랩 CSS 파일과 연결시키세요.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+브라우저는 순서대로 차례차례 파일을 읽기 때문에, 올바른 곳에 배치해야해요. 그렇지 않으면, 파일의 부트스트랩 코드를 재정의해야 할 수도 있어요. 이제까지 CSS파일이 있는 템플릿에 대해 알아보았어요.
+
+여러분이 만든 파일은 아래와 같아야해요.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+자, 이제 파일을 저장하고 새로고침을 해보세요!
+
+![그림 14.2](images/color2.png)
+
+잘했어요! 웹사이트 왼쪽 여백을 좀더 주고 싶지 않나요? 한번 해봐요!
+
+{% filename %}blog/templates/blog/post_blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+이 코드를 CSS에 붙여넣고, 파일을 저장하고 어떻게 바뀌었는지 확인해봐요!
+
+![그림 14.3](images/margin2.png)
+
+제목의 폰트를 바꾸고 싶나요? `blog/templates/blog/post_list.html`파일 안에 `<head>`에 아래 코드를 붙여넣기 해보세요.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+이전과 마찬가지로, `blog/static/css/blog.css`를 연결 하기 전에 위치와 명령을 확인하세요. 이제 구글 폰트(https://www.google.com/fonts)에서 *랍스터* 라는 폰트를 가져오는 작업을 진행할 거에요.
+
+우선 `blog/static/css/blog.css`파일 내에서 `h1 a` 블록( h1 a {...} 사이의 코드)을 찾아보세요. 그리고 괄호 사이에 `font-family: 'Lobster';<0>을 추가하고 페이지 새로고침을 해보세요:</p>
+
+<p>{% filename %}blog/templates/blog/post_blog.css{% endfilename %}</p>
+
+<pre><code class="css">h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+`</pre> 
+
+![그림 14.3](images/font.png)
+
+잘했어요!
+
+위에서 언급했듯이, CSS는 클래스 개념을 가지고 있습니다. HTML 코드 내 이름을 지정해 다른 부분에 영향을 주지 않고 특정 부분에만 스타일을 적용할 수 있습니다. 정말 멋지죠! 두 div를 사용해 제목과 게시글이 다르게 보이게 만들 수도 있어요. 이처럼 클래스는 겉모습을 다르게 바꿔줍니다.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+다음 각 다른 선택자(selector) 에 정의를 붙여볼거에요. 클래스를 나타내는 선택자는 `.`으로 시작합니다. 아래의 코드(클래스 선택자) 를 이해하기 위해서 CSS에 대한 튜토리얼이나 설명을 참고하면 큰 도움이 될 거에요. 이제 `blog/static/css/blog.css`파일으로 아래 코드를 복사, 붙여넣기 하세요:
+
+{% filename %}blog/templates/blog/post_blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+자, 다음은 글을 보여주는 HTML 코드를 post라는 클래스 이름이 적힌 div로 감싸세요. 그러면 다음과 같을 거에요.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+`blog/templates/blog/post_list.html` 안에 아래 코드를 넣으세요.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+파일을 저장하고 웹사이트를 새로고침하세요.
+
+![그림 14.4](images/final.png)
+
+와! 멋지지 않나요? 붙여넣기한 HTML 클래스와 CSS 코드를 보세요. 초록색으로 날짜를 바꾸려면 어느 곳을 고쳐야할까요?
+
+CSS를 고치는 것을 두려워하지 말고, 편하게 고치고 싶은 것을 수정해보세요. 이것저것 고쳐보면서 CSS와 놀아보면 금방 이해할 수 있게 된답니다. 만약 무엇인가 깨져보이면, 걱정하지마세요 - 항상 되돌릴 수 있어요!
+
+[freeCodeCamp](https://learn.freecodecamp.org/)에서 "기본 HTML &ampl HTML5" 와 "기본 CSS" 무료 온라인 강의 들어보시길 권장드려요. HTML과 CSS로 귀하의 웹 사이트를 더 근사하게 만들 방법들을 배우실수 있답니다.
+
+다음 장을 읽을 준비됐나요?! :)
\ No newline at end of file
diff --git a/ko-KR/deploy/README.md b/ko-KR/deploy/README.md
new file mode 100644
index 00000000000..be1beb94b32
--- /dev/null
+++ b/ko-KR/deploy/README.md
@@ -0,0 +1,246 @@
+# 배포하기!
+
+> **참고**: 이번 장은 따라오기 조금 힘들 수도 있어요. 끝까지 따라와주세요. 배포는 웹사이트 개발의 가장 중요한 부분이에요. 튜토리얼 중간에 이번 장이 있는 이유는 여러분이 코치가 웹사이트를 온라인에서 볼 수 있게 도와주기 위해서에요. 시간이 모자르더라도 튜토리얼을 끝낼 수 있어요.
+
+지금까지는 웹사이트를 내 컴퓨터에서만 볼 수 있었어요. 이제 어떻게 웹사이트를 배포하는지 배워봅시다. 배포(deploy) 는 애플리케이션을 인터넷에 올려놓아 다른 사람들도 볼 수 있게 해주는 것 말해요. :)
+
+앞에서 배웠듯이, 웹사이트는 서버라는 곳에 들어가요. 인터넷상에 많은 서버 공급자들이 있지만, 우린 [PythonAnywhere](https://www.pythonanywhere.com/)을 사용할 겁니다. PythonAnywhere은 방문자가 많지 않은 소규모 어플리케이션은 무료로 사용가능하니 지금 우리에겐 충분하답니다.
+
+우리가 사용할 다른 서비스는 [GitHub](https://www.github.com)라는 코드 호스팅 서비스입니다. 프로그래머들이 애용하는 곳들 중 하나로 대부분의 모든 프로그래머가 GitHub 계정을 가지고 있다고 봐도 될 거예요. 이제 여러분도 하나 만들 때가 되었어요!
+
+이 세 가지는 매우 중요합니다. 로컬 컴퓨터에서는 개발 및 테스트를 수행할 거에요. 원하는 결과물을 얻게 되었다면, 그대로 GitHub에 복사본을 올려둘 거에요. PythonAnywhere에 웹 사이트가 올려질 거고, GitHub에서 새로운 복사본을 가져와 업데이트 될 거에요.
+
+# Git
+
+> **참고** 이미 [설치 단계](../installation/README.md)를 거쳤다면, 이 부분을 다시 하실 필요는 없습니다 - 바로 다음 장으로 넘어 가 Git 저장소 만들기를 시작하세요.
+
+{% include "/deploy/install_git.md" %}
+
+## Git 저장소(repository) 만들기
+
+Git은 코드 저장소(줄여서 "repo"라고 합니다.)에 특정한 파일들 집합의 변화를 추적하여 관리합니다. 이제 프로젝트를 시작해볼까요? 콘솔창을 열어서 `djangogirls` 디렉토리에서 아래 명령어들을 실행하세요. 아래 명령 중에서 Your Name 대신 여러분의 이름을, you@example.com 대신에 여러분의 이메일 주소를 입력하세요.
+
+> **주의**: 저장소를 초기화 하기 전에 여러분의 현재 작업 디렉토리가 어디인지 꼭 확인하세요. 맥OS나 Linux라면 `pwd` 명령으로, 윈도우라면 `cd` 명령어를 실행하면 알 수 있을 거에요. 반드시 `djangogirls` 폴더에서 해야합니다.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+git 저장소 초기화는 프로젝트를 시작할 때 딱 한번만 필요합니다 (username과 email 등록 명령은 다시 입력할 필요가 없습니다).
+
+Git은 이 디렉토리에 모든 파일들과 폴더들의 변경점을 추적할 거에요. 무시(ignore) 하도록 지정한 파일들을 제외하고는 말이죠. 기본 디렉토리에다 `.gitignore`라는 파일을 만들어서 특정 파일이나 폴더를 추적하지 않도록 할 수 있습니다. 에디터를 열어서 아래 내용을 넣어주세요:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+"djangogirls"폴더에 `.gitignore`파일을 저장하세요.
+
+> **주의**: 파일명 앞에 마침표로 시작하는 것이 중요합니다! 꼭 붙여주세요. 만약 여러분이 파일을 만드는 것이 어렵다면 (예를 들어 맥에서는 파인더에서 마침표로 시작하는 파일을 생성하는걸 좋아하지 않아요.) "다른 이름으로 저장(Save As)" 기능을 사용하세요. 대부분 이 것으로 충분할거에요. 그리고 `.txt`나 `.py`등 다른 파일 이름 익스텐션을 붙이지 마세요 -- 명칭이 `.gitignore` 이여야 git이 인식할수 있답니다. 리눅스와 MacOS는 `.` 으로 시작하는 파일명을 지닌 파일을 (`.gitignore` 같은) 숨김파일로 다루며 일반 `ls` 명령은 이러한 파일을 보여주지 않아요 `.gitignore` 파일을 보기위해서는 대신 `ls -a` 명령을 사용하세요
+> 
+> **주목** `.gitignore` 파일에 있는 `db.sqlite3`이라는 파일은 모든 사용자와 게시물이 저장된 로컬 데이터베이스입니다. 우리는 표준 웹 개발 방법을 수행할 거에요. 로컬 테스트 사이트와 PythonAnywhere에서 실제 서비스되는 웹사이트에서 분리된 데이터베이스를 사용하는걸 의미해요. PythonAnywhere 의 데이터베이스는 당신의 개발환경 처럼 SQLite에요. 하지만 보통은 많은 방문자를 처리하기 위해 SQLite보다는 MySQL 이라는 데이터베이스를 사용할 거에요. GitHub 저장소 복사본에 SQLite 데이터베이스를 제외하면, 지금까지 작성한 모든 게시물과 슈퍼유저는 로컬에서만 사용할 수 있으므로 실제 운영하는 프로덕션 환경에서는 다시 새 데이터베이스를 추가해야합니다. 로컬 데이터베이스를 놀이터처럼 생각하고 이것저것 테스트해보세요. 실제 블로그 내 게시글이 삭제되지 않으니 걱정하지 마세요.
+
+`git add`하기 전이나 변경된 것이 있는지 잘 모를 때마다 `git status` 명령어를 사용하는 것은 좋은 방법이에요. 잘못된 파일이 추가될 경우 이를 멈출 수 있게 도움을 주어요. `git status` 명령은 미추적/수정/스테이지된 파일들, 브랜치 상태와 그 외 많은 정보들을 보여줍니다. 출력 결과는 다음과 비슷합니다:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+자 이제 우리가 만든 코드들을 저장소에 넣어봅시다. 콘솔창에 가서 다음 명령어를 실행하세요:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## GitHub에 코드 넣기
+
+[GitHub.com](https://www.github.com)에 가서 무료 사용자 계정으로 회원가입을 하세요. (만약 워크샵 준비과정에서 하셨다면 훌륭하십니다!) 비밀번호 관리를 꼭 해주세요 (만약 사용하신다면 비밀번호 관리자에 추가해 주세요). 
+
+그 다음 새 저장소(new repository)를 "my-first-blog"라는 이름으로 생성하세요. 'initialize with a README' 와 '.gitignore' 옵션은 체크하지 말고 빈칸으로 놔두세요. (이미 직접 만들어 봤습니다) Liscense 부분도 None으로 놔두세요. 
+
+![](images/new_github_repo.png)
+
+> 꼭 이름을 my-first-name으로 지정해 주세요. 나중에야 얼마든지 다른 이름으로 바꿀수 있습니다만, 이 안내문에서는 이 제목이 앞으로 많이 등장할겁니다. 만약 다른 이름이라면, (지시를) 하나씩 따라할때마다 이름을 매번 바꿔줘야 하잖아요. 가급적이면 `my-first-blog`라는 저장소 이름을 그대로 사용하는게 편할거에요.
+
+다음 화면에서 이 레포지토리를 클론(clone)할때 쓸 url이 보일텐데요, 이 뒤에 나오는 명령어에서 사용될 예정입니다. 
+
+![](images/github_get_repo_url_screenshot.png)
+
+이제 내 컴퓨터의 Git 저장소를 GitHub에 있는 저장소로 연결해 보겠습니다. 
+
+이제 콘솔에 다음과 같이 입력하세요 (Github 계정을 만들때 입력한 username을 `<your-github-username>`꺾쇠(<>)를 떼고 입력해 주세요.. URL은 방금 보신 clone URL과 반드시 일치해야 합니다.):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Github에 push를 하면, Github 유저네임과 비밀번호를 입력하라고 할 겁니다(지금 열려있는 터미널창 아니면 새로운 팝업창), 이 정보를 입력하고 나면 다음과 같은 장면이 보여야 합니다. 
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+이제 코드가 Github에 업로드 되었습니다. 가서 확인해보세요! [Django](https://github.com/django/django), [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial)뿐만 아니라 수많은 훌륭한 오픈소스 소프트웨어 프로젝트들이 GitHub에서 코드를 호스팅하고 있어요. 방금 여러분이 한 것처럼 말이죠. :) :)
+
+# PythonAnywhere에서 블로그 설정하기
+
+## PythonAnywhere에 가서 회원가입을 하세요. 
+
+> **참고** 여러분은 아마 앞부분에서 PythonAnywhere 계정을 생성했을겁니다. 이미 PythonAnywhere 계정이 있으면, 이 부분을 다시 할 필요가 없어요.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## PythonAnywhere에 우리의 사이트 등록하기
+
+로고를 클릭해서 메인의 [PythonAnywhere Dashboard](https://www.pythonanywhere.com/)로 돌아간다음, "Bash" 콘솔 시작하기 옵션을 선택합니다 - 이건 PythonAnywhere 버전의 터미널 창이예요. 내컴퓨터에 있는것과 마찬가지입니다. 
+
+![PythonAnywhere 웹 인터페이스의 'New console'부분, 'bash'버튼과 함께](images/pythonanywhere_bash_console.png)
+
+> **알림**PythonAnywhere는 리눅스를 기반으로 합니다. 만약 Windows를 사용중이시라면 내컴퓨터의 커맨드라인과 약간 모양이 다를수도 있습니다.
+
+PythonAnywhere에 웹앱을 배포하는 과정은 Github에서 코드를 받아온 다음, PythonAnywhere이 이 app을 알아보도록 등록해주고, 웹앱 서비스를 시작하는 것입니다. 이런 과정을 직접 하나하나 할 수도 있습니다. 하지만 PythonAnywhere은 우리에게 이 과정을 대신 해주는 도움을 제공합니다. 이제 설치부터 해봅시다. 
+
+{% filename %}command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+이 명령을 실행하면 `Collecting pythonanywhere`같은 글씨가 나와야 합니다. 그리고 마지막에는 `Successfully installed (...) pythonanywhere-(...)`라는 문장과 함께 설치가 완료됩니다. 
+
+이제 helper를 실행하여 Github에 있는 app을 자동으로 등록하겠습니다. PythonAnywhere 콘솔에 다음과 같이 입력하세요.(`<your-github-username>`자리에 잊지말고 Github username을 입력해 주세요, URL이 Github의 clone url과 일치되도록 말입니다.)
+
+{% filename %}command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+이 실행 과정을 지켜보면, 어떤 일이 일어나는지 보일겁니다. 
+
+- Github에서 코드를 다운로드합니다
+- 내컴퓨터에서 하는것과 마찬가지로, PythonAnywhere에 가상환경을 생성합니다. 
+- settings 파일을 배포 관련 설정과 함께 업데이트 합니다. 
+- `manage.py migrate` 명령어를 사용해서 PythonAnywhere에 데이터베이스를 설정합니다
+- 정적 파일을 세팅합니다(이에 대해서는 나중에 배웁니다)
+- PythonAnywhere를 등록해서 API를 통해 웹앱을 서빙합니다. 
+
+PythonAnywhere에서는 위의 과정들이 모두 자동화되어 있습니다. 하지만 다른 서버 제공자를 사용하면 이같은 과정들을 하나하나 직접 수행해야 합니다. 
+
+여기서 기억해야 할 중요한 점은, PythonAnywhere에 있는 데이터베이스가 내컴퓨터의 데이터베이스와는 아무런 연결고리가 없다는 점입니다. 그래서 각자의 게시물 현황과 관리자 계정이 다릅니다. 따라서, 내컴퓨터에서 했던것과 마찬가지로, `createsuperuser`명령어를 이용해 관리자 계정을 세팅해야 합니다. PythonAnywhere가 이미 자동으로 가상환경을 생성해줬기때문에, 우리는 실행만 하면 됩니다:
+
+{% filename %}command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+관리자 계정에 필요한 세부 설정을 입력해 주세요. 특별히 PythonAnywhere 비밀번호의 보안을 강화할 생각이 아니라면, 헷갈림을 방지하기 위해서 내컴퓨터에서 사용하고있는 설정과 똑같이 해줍니다. 
+
+지금부터는 `ls` 명령어를 사용해 PythonAnywhere에 있는 코드를 검토하는게 가능합니다.
+
+{% filename %}command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.pytests.py  static
+    templates  views.py
+    
+
+이제 "Files" 페이지로 이동해서 PythonAnywhre의 내장 브라우저를 사용해 파일들을 둘러볼수도 있습니다. (콘솔 페이지에서 오른쪽 상단의 메뉴 버튼을 통해 PythonAnywhere의 다른 페이지로 이동할수도 있습니다. ) 일단 어떤 페이지에 접속하면, 상단에 다른 페이지로 이동할 수 있는 링크가 있습니다. 
+
+## 이제 세상에 공개되었습니다!
+
+이제 귀하의 사이트는 internet상에 공개되었습니다. PythonAnywhere의 "Web" 페이지를 클릭해 링크를 받아오세요. 이 링크는 귀하가 원하는 모든 사람에게 공유될 수 있습니다. 
+
+> **알림**이 안내서는 초보자를 위한 튜토리얼입니다. 쉬운 안내를 위해서 보안상 권장되지 않는 방법도 몇개 사용했습니다. 이 프로젝트를 기반으로 하거나 혹은 아예 새로운 프로젝트를 실행하려면, 사이트 보안을 위해 [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/)를 살펴보세요.
+
+## 디버깅 팁
+
+만일 `pa_autoconfigure_django.py` 스크립트를 실행하다가 에러가 발생한다면, 아래에 제시된 자주 나타나는 문제 원인들을 참고해 보세요. 
+
+- PythonAnywhere의 API 토큰 생성을 잊어버림
+- Github URL을 잘못 입력함
+- 만약 *"Could not find your settings.py"* 라는 오류가 보인다면, Git에 업로드할때 파일을 빼먹었던지 Github에 push가 제대로 되지 않은 것입니다. 위의 Git 부분을 한번 더 살펴보세요. 
+- 과거에 이미 PythonAnywhere에 가입된 상태였는데 collectstatic 에러가 발생한다면, 해당 계정의 SQLite 버전(eg 3.8.2)이 오래되어서 그럴수도 있습니다. 이럴때는 새로운 계정을 생성하고 위에 나와있는 PythonAnywhere 부분 명령어를 다시 실행해 보세요. 
+
+본인의 사이트에 접속할 때 오류가 보이면, 제일 먼저 **error log(오류 로그)**에서 디버깅 정보를 찾아보세요. PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/)에서 이 사이트로 가는 링크를 찾을 수 있습니다. 혹시 거기에 오류 메세지가 있는지 확인하세요. 가장 최근의 오류 메세지는 맨 하단에 있습니다. 
+
+[PythonAnywhere help site에서 일반적인 디버깅 팁](http://help.pythonanywhere.com/pages/DebuggingImportError)을 확인할 수 있어요.
+
+그리고 기억하세요, 코치들이 여러분을 도와주려고 기다리고 있습니다. 
+
+# 사이트 확인하기!
+
+여러분 사이트의 기본 페이지(default page)가 로컬과 같이 "It worked!"라는 메시지를 보여줘야 합니다. URL 뒤에 `/admin/`를 붙여서 다시 접속해 보세요. 이제 관리자 사이트를 볼 수 있어요. username과 비밀번호를 쳐서 로그인하면, 서버에 새로운 게시물들을 추가할 수 있습니다. - 기억하세요, 로컬에 있는 테스트 데이터베이스의 게시물들은 배포된 블로그로 옮겨지지 않습니다. 
+
+게시물 몇개를 생성했다면, 로컬의 설정으로 들어가세요. (PythonAnywhre에 있는거 말고요) 이제부터 로컬의 설정에 변경사항 몇개를 생성하겠습니다. 그리고 이것은 웹개발에서 흔한 작업 흐름입니다 - 로컬에서 변경사항을 만들고, Github에 푸시하고, 공개된 웹서버에 변경사항을 내려받으세요. 이렇게 하면 이미 공개된 사이트를 부수지 않고 여러가지 작업을 하고, 실험할 수 있습니다. 좀 멋지죠 ㅎㅎ?
+
+이제까지 고생한 자기 자신을 *격려*해주세요! 서버 배포는 웹 개발 단계 중 가장 까다로운 부분 중 하나이고, 어떨때는 제대로 돌아갈때까지 몇 일이 걸리기도 합니다. 하지만 당신은 진짜로 인터넷에 사이트 배포를 마쳤습니다!
\ No newline at end of file
diff --git a/ko-KR/deploy/install_git.md b/ko-KR/deploy/install_git.md
new file mode 100644
index 00000000000..9a41c04f037
--- /dev/null
+++ b/ko-KR/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git은 많은 프로그래머들이 사용하고 있는 "버전 제어 시스템(version control system)"이에요. 이 소프트웨어는 변경 내용을 추적할 수 있어 나중에 특정 버전을 다시 호출 할 수 있어요. 워드 프로세서 프로그램들 (마이크로소프트 워드나 리브레오피스 라이터 등)의 "변경 내용 추적" 기능과 같지만 훨씬 강력합니다.
+
+## Git 설치하기
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Git은 [git-scm.com](https://git-scm.com/)에서 다운로드 할 수 있어요. 두가지 단계만 빼고 "다음"을 누르실수 있답니다: 에디터 선택을 요구하는 단계에서 Nano를 선택하시고, "PATH 환경 조정" 단계에서 "윈도우 명령 프롬프트에서 Git과 Unix 도구 사용" (하단 옵션)을 선택해 주세요. 나머지는 모두 기본 설정대로 해도 됩니다. 윈도우 스타일, 유닉스 스타일로 라인엔딩 커밋하기(commit Unix-style line endings) 를 체크하는 것도 좋습니다.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+[git-scm.com](https://git-scm.com/)에서 맥용 설치파일을 다운받은 다음 실행해 나오는 지시사항에 따라 설치합니다.
+
+> **참고** 만약 OS X 10.6, 10.7, 10.8을 사용중이시면, 여기에 있는 git 버전을 설치하셔야 합니다: [ OS X Snow Leopard를 위한 Git 인스톨러 ](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ko-KR/deploy/signup_pythonanywhere.md b/ko-KR/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..02d63d10d53
--- /dev/null
+++ b/ko-KR/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere는 클라우드서버에서 파이썬코드를 실행할수 있는 서비스입니다. 우리는 이 서비스를 이용하여 우리 싸이트를 호스팅할것입니다.
+
+우리는 우리가 만든 블로그를 PythonAnywhere에서 서비스를 제공할 것 입니다. PythonAnywhere에 "Beginner"계정을 등록하세요. (무료사용자등급도 좋습니다. 신용카드가 필요하지 않아요.)
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![PythonAnywhere의 회원가입 페이지는 무료 'Beginner'계정 생성하기 버튼을 나타내고 있습니다.](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **참고**: 여러분의 유저네임을 정할 때 블로그 주소의 일부가 여러분의 유저네임으로 되는 것을 염두하고 정하세요. 예를 들어 유저네임이 uourusername이라면 여러분의 블로그 URL은 `yourusername.pythonanywhere.com`이 된답니다. 또한, 기억할 수 있는 비밀번호를 사용하세요(만약 당신이 비밀번호 관리자를 사용한다면 비밀번호를 추가해주세요)
+
+## PythonAnywhere API Token 생성
+
+이 단계는 한번만 수행하면 됩니다. PythonAnywhere에 가입이 완료되었다면, 대시보드를 볼 수 있습니다. 화면 우측상단의 "Account" 링크로 이동합니다.
+
+![화면 우측상단의 Account 링크](../deploy/images/pythonanywhere_account.png)
+
+그리고 "API token"으로 명명된 탭을 선택, 그리고 "Create new API token"버튼을 클릭합니다.
+
+![Account 페이지내 API token 탭](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ko-KR/django/README.md b/ko-KR/django/README.md
new file mode 100644
index 00000000000..db66893f3e2
--- /dev/null
+++ b/ko-KR/django/README.md
@@ -0,0 +1,27 @@
+# Django란 무엇일까요?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*)는 Python으로 만들어진 무료 오픈소스 웹 어플리케이션 프레임워크(web application framework) 입니다. 쉽고 빠르게 웹사이트를 개발할 수 있도록 돕는 구성요소로 이루어진 웹 프레임워크인 것이죠.
+
+웹사이트를 구축할 때, 비슷한 유형의 요소들이 항상 필요합니다. 회원가입, 로그인, 로그아웃과 같이 사용자 인증을 다루는 방법이나 웹사이트의 관리자 패널, 폼, 파일 업로드와 같은 것들 말이지요.
+
+그런데 정말 다행이게도, 오래 전에 어떤 웹 개발자들이 새로운 웹 사이트를 개발할 때 서로 비슷한 문제들에 직면한다는 것을 깨달았습니다. 그래서 팀을 조직했구요. 바로 사용할 수 있는 구성요소들을 갖춘 여러 프레임워크를 만들었답니다. (장고도 그 중에 하나인거죠.)
+
+프레임워크는 다시 발명해야하는 문제로부터 해방감을 주며 새로운 웹사이트를 개발할 때 뒤따르는 간접비용의 부담을 덜기 위해 존재한답니다.
+
+## 왜 프레임워크가 필요한가요?
+
+장고라는 것이 실제로 무엇을 위한 것인지 이해하기 위해서는 서버에 대해서 자세히 살펴볼 필요가 있어요. 첫 번째는, 서버가 여러분에게 웹 페이지를 제공하길 원하는지 알 필요가 있다는 거에요.
+
+편지(request, 요청) 이 도착했는지 확인해주는 메일박스(port, 포트) 가 있다고 상상해보세요. 이 것은 웹 서버가 해주는 일이에요. 웹 서버는 받은 편지를 읽고 웹 페이지와 함께 답장을 준답니다. 그런데 무언가를 주고 싶을 때는 그 안에 내용이 있어야하죠. 장고는 그 특정 컨텐츠를 만들 수 있는 역할을 합니다.
+
+## 누군가가 서버에 웹 사이트를 요청하면 어떤 일이 벌어질까요?
+
+웹 서버에 요청이 오면 장고로 전달됩니다. 그러면 장고는 실제로 어떤 요청이 들어왔는지 확인합니다. 첫 번째로 웹 페이지의 주소를 가져온 후 무엇을 할지 확인합니다. 이 것이 바로 장고의 **urlresolver**가 하는 역할이에요. (웹 사이트 주소는 URL - Uniform Resource Locator을 말합니다. 그래서 *urlresolver*의 이름을 이해할 수 있습니다.) 패턴 목록을 가져와 URL과 맞는지 하나 씩 대조해보는 것은 그리 똑똑한 방법이 아니죠. 그러나 장고는 위에서 부터 아래로 그 패턴을 확인해봅니다. 만약 일치하는 게 있다고 하면, 장고는 그 요청을 관련된 함수( *view*라고 불리는) 에 넘겨줍니다.
+
+편지를 가진 우편배달부를 생각해보세요. 거리를 걸으며 집집마다 편지와 대조해서 주소와 번지를 확인합니다. 주소와 번지가 일치하면 우편배달부는 그곳에 편지를 배달합니다. Urlresolver 가 바로 이와 같은 일을 합니다.
+
+모든 재미난 일들은 *view* 함수에서 모두 처리됩니다: 특정 정보를 데이터베이스에서 찾을 수 있어요. 그런데 만약 사용자가 데이터를 바꿔달라고 수정을 요청한다면 어떻게 될까요? "제 직업에 대한 설명을 바꿔주세요."와 같은 편지를 받았다고 생각해봅시다. *view*함수는 수정할 수 있는 권한이 있는지 확인하고나서, 직업에 대한 설명을 수정해 다시 답장을 주겠지요. "완료했습니다!" 라고요. 그리고 *view*는 응답을 생성하고 장고는 사용자의 웹브라우저로 응답을 보낼 수 있게 된답니다.
+
+물론 지금까지의 설명은 아주 간단히 설명한 것에 불과해요. 하지만 모든 기술적인 부분까지 자세히 알 필요가 없답니다. 이 정도 아는 것만으로도 충분하답니다.
+
+좀 더 자세히 아는 것보다, 지금부터는 장고를 이용해 간단하게 조그만 것부터 만들어봐요. 그렇게 하면서 중요한 모든 것들을 하나씩 배워나가도록 해요.
\ No newline at end of file
diff --git a/ko-KR/django_admin/README.md b/ko-KR/django_admin/README.md
new file mode 100644
index 00000000000..6c27a35d6f0
--- /dev/null
+++ b/ko-KR/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django 관리자
+
+우리가 모델링한 포스트를 더하거나 고치거나 삭제하기 위해서는, Django의 admin기능을 사용해야 합니다.
+
+코드 에디터에서 `blog/admin.py`파일을 열고 이것으로 교체하세요:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+코드에서 알 수 있듯이 앞 챕터에서 정의했던 Post 모델을 가져오고(import) 있어요. 관리자 페이지에서 만든 모델을 보려면 `admin.site.register(Post)`로 모델을 등록해야해요.
+
+자, 이제 Post 모델을 볼까요? 웹 서버를 실행하려면 콘솔창에서 `python manage.py runserver`를 실행하는걸 잊지마세요. 웹브라우저로 가서 http://127.0.0.1:8000/admin/ 을 입력하세요. 다음과 같은 로그인 화면이 보일거에요.
+
+![로그인 페이지](images/login_page2.png)
+
+로그인을 하기 위해서는, 모든 권한을 가지는 *슈퍼유저(superuser)*를 생성해야해요. 콘솔창에서 `python manage.py createsuperuser`을 입력하고 엔터를 누르세요.
+
+> 웹 서버가 실행중에 새로운 명령을 입력하기 위해서 새 터미널창을 열고 당신의 virtualenv를 활성화해야 하는것을 잊지마세요. 우리는 어떻게 새로운 명령을 입력하는지 **나의 첫 번째 장고 프로젝트!**장의 **웹 서버 시작하기** 챕터에서 복습했습니다.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+메시지가 나타나면 사용자 이름 (소문자, 공백 없이), 이메일 주소 및 암호를 입력합니다. **비밀번호를 입력할때 입력하는 비밀번호를 볼 수 없어 걱정하지 마세요 – 원래 그렇게 되어있답니다.** 입력후 `enter` 키를 눌러 계속하세요. 실행화면은 아래와 같을 거에요. (슈퍼유저로 사용 될 username 과 email 주소는 본인 것이어야해요.)
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+브라우저로 돌아와서 장고 관리자 페이지에서 슈퍼유저로 로그인한 후 대시보드를 확인하세요.
+
+![장고 관리자](images/django_admin3.png)
+
+Posts로 가서 약간의 실험을 해봅시다. 5 ~ 6개의 블로그 글을 작성해보세요. 내용에 대해 걱정하지 마세요 - 오로지 당신의 컴퓨터에서만 보인답니다 - 당신은 이 튜토리얼에서 일부 텍스트를 복사 붙여넣기해 시간을 절약할 수 있어요. :)
+
+최소한 2, 3개의 글들에 게시 날짜가 있는지 확인하세요. (모두 볼 필요는 없어요) 이건 나중에 도움이 될 거에요.
+
+![장고 관리자](images/edit_post3.png)
+
+장고 관리자에 대해서 좀 더 알고 싶다면 장고 공식 문서를 참고하세요. : https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+자, 여러분은 내 첫 번째 장고 모델을 만들었어요! 잠깐 쉴 시간을 필요하죠. 열심히 했으니 재충전을 위해 커피 한 잔(또는 차 한 잔) 또는 뭔가 먹고 돌아오세요.
\ No newline at end of file
diff --git a/ko-KR/django_forms/README.md b/ko-KR/django_forms/README.md
new file mode 100644
index 00000000000..3f09aaaf12f
--- /dev/null
+++ b/ko-KR/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django 폼
+
+이제 한 가지만 더 하면 웹사이트가 완성되어요. 바로 블로그 글을 추가하거나 수정하는 멋진 기능을 추가하는 것이죠. 장고의 `관리자` 기능도 충분히 멋있기는 하지만, 좀 더 입맛에 맞게 바꾸고 예쁘게 꾸미기에는 좀 한계가 있습니다. `폼(양식, forms)`으로 강력한 인터페이스를 만들 수 있어요. - 우리가 상상할 수 있는 거의 모든 것을 할 수 있거든요!
+
+장고 폼이 정말 멋진 것은 아무런 준비 없이도 양식을 만들 수 있고, `ModelForm`을 생성해 자동으로 모델에 결과물을 저장할 수 있다는 거에요.
+
+이 기능이 지금 우리가 할 내용이에요: 폼을 하나 만들어서 `Post` 모델에 적용해봅시다.
+
+장고의 모든 중요한 부분과 마찬가지로, 폼도 폼만의 파일을 만들어요: `forms.py`.
+
+우리는 이 이름으로 `blog` 디렉토리 안에 파일을 만들거에요.
+
+    blog
+      └── forms.py
+    
+
+자, 코드 에디터를 열어 아래 코드를 입력해 보아요.
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+위 코드를 보면 첫 번째로 forms model을 import 해야하고 (`from django import forms`), 그 다음으로 `Post` model 도 import 해야합니다. (`from .models import Post`).
+
+`PostForm` 은 이미 다들 예상 하셨듯이 우리가 만들 폼의 이름이에요. 그리고 장고에게 이 폼이 `ModelForm`이라는 것을 알려줘야해요. (그러면 장고가 뭔가 마술을 부릴 거에요) - `forms.ModelForm`은 ModelForm이라는 것을 알려주는 구문이에요.
+
+자, 이제 다음으로 `class Meta`가 나오는데요, 이 구문은 이 폼을 만들기 위해서 어떤 model이 쓰여야 하는지 장고에게 알려주는 구문입니다. (`model = Post`).
+
+마지막으로, 이 폼에 필드를 넣으면 완성되겠죠. 이번 폼에서는 `title` 과 `text` 만 보여지게 해 봅시다. - `author` 는 현재 로그인 하고 있는 사람이 될 것이고 (바로 당신이요!) 그리고 `created_date` 는 글이 등록되는 시간이 될 것입니다. (예를 들어, code 상에서요), 됐죠?
+
+마쳤습니다! 이제 *뷰* 에서 이 폼을 사용해 템플릿에서 보여주기만 하면 되네요.
+
+다음에는 링크, URL, 뷰 그리고 템플릿을 만들거에요.
+
+## 폼과 페이지 링크
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## 새로운 뷰 게시
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## 템플릿
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* 이제 폼을 나타나게 할거에요. 예를 들어 {% raw %}`{{ form.as_p }}`{% endraw %} 로 나타나게 할 수 있답니다.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* `Save` 버튼이 필요합니다. 이 것은 HTML 버튼으로 만들 수 있어요: `<button type="submit">Save</button>`.
+* 그리고 마지막으로 열린 `<form ...>` 태그에 {% raw %}`{% csrf_token %}`{% endraw %}를 추가해야 해요. 이 작업은 폼 보안을 위해 중요하답니다! 만약 이걸 잊어버린다면, 장고는 당신이 폼을 저장할때 주의를 시킬 거에요.
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## 폼 저장하기
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## 폼 검증하기
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## 폼 수정하기
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## 보안
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## 한 가지만 더: 배포하세요!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* 제일 먼저, 여러분의 코드를 커밋하고 Github로 푸시합니다.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* 그 다음 [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/)을 여세요:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* 마지막으로 ["웹" 페이지](https://www.pythonanywhere.com/web_app_setup/) (콘솔의 우측상단의 메뉴를 이용)로 이동해 **새로고침**. 을 누릅니다. 변경된 내용을 보기위해 당신의 https://subdomain.pythonanywhere.com 블로그를 새로고침 하세요.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ko-KR/django_installation/README.md b/ko-KR/django_installation/README.md
new file mode 100644
index 00000000000..168912c60b1
--- /dev/null
+++ b/ko-KR/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django 설치하기
+
+> **참고** 만약 크롬북을 사용한다면, 이번 장을 생략하고 [크롬 북 설정](../chromebook_setup/README.md)을 정확하게 따르세요.
+> 
+> **참고** 이미 [설치 단계](../installation/README.md)를 거쳤다면, 이 부분을 다시 하실 필요는 없습니다 - 바로 다음 장으로 넘어 가세요!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ko-KR/django_installation/instructions.md b/ko-KR/django_installation/instructions.md
new file mode 100644
index 00000000000..1cf173287ba
--- /dev/null
+++ b/ko-KR/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> 이번 장의 일부는 Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)의 튜토리얼을 바탕으로 작성되었습니다.
+> 
+> Creative Commons Attribution-ShareAlike 4.0 International License 에 따라 [django-marcador 튜토리얼](http://django-marcador.keimlink.de/)를 바탕으로 작성되었습니다. Django-marcador 튜토리얼은 Markus Zapke-Gründemann et al에게 저작권이 있습니다.
+
+## 가상 환경
+
+장고를 설치하기 전에, 개발 환경을 깔끔하게 관리하는데 아주 큰 도움이 되는 도구를 설치해보겠습니다. 이 단계를 건너뛸 수 있지만, 한번 직접 해보는 것을 추천합니다. 제대로 설치해야 나중에 문제가 발생하지 않거든요!
+
+자, 이제부터 **가상 환경**(*virtualenv*라고 불러요)을 만들어보겠습니다. Virtualenv는 프로젝트 기초 전부를 Python/Django와 분리시켜줍니다. 다시 말해 웹사이트가 변경되어도 개발 중인 것에 영향을 미치지 않다는 것입니다. 어때요, 깔끔하죠?
+
+`virtualenv`를 만드는 데 필요한 것은 생성할 곳을 정하는 것 뿐입니다. 예를 들면, home 디렉토리와 같은 곳이면 적당합니다. 윈도우 환경에서는 `C:\Users\Name` 일 거에요. (`Name` 이라는 것은 윈도우에 로그인할 때 사용한 아이디를 말합니다.)
+
+> **주의:** 윈도우에서는 디렉토리에 악센트기호나 특수문자가 포함되어서는 안되요; 만약 사용자명에 악센트 기호가 예를 들어`C:\djangogirls`와 같은 다른 디렉토리를 사용하세요.
+
+이 튜토리얼에서는 home 디렉토리 아래 `djangogirls`라는 디렉토리를 새로 만들어 사용하도록 할게요.
+
+{% filename %}명령줄{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+이제 `myenv` 라는 이름의 가상 환경을 만들어볼게요. 아래와 같은 형식의 명령을 실행하세요.
+
+{% filename %}명령줄{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+새 `virtualenv` 만들기 위해, 명령줄에 `python -m venv myvenv` 을 입력해서 실행해요. 화면에 이렇게 나타날 거에요:
+
+{% filename %}명령줄{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+여기서 `myvenv` 는 `가상 환경`의 이름이예요. 이름은 마음대로 정할 수 있지만, 소문자여야하고 공백은 없어야하고 특수문자도 사용하면 안되요. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+리눅스와 맥에서 `virtualenv`를 생성하려면 간단하게 `python3 -m venv myvenv`를 실행하면 됩니다. 화면에 이렇게 나타날 거에요:
+
+{% filename %}명령줄{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+여기서 `myvenv` 는 `가상 환경`의 이름이예요. 이름은 마음대로 정할 수 있지만, 소문자여야하고 공백은 없어야해요. 이름은 짧게 만드는게 좋아요. 자주 입력해야하니까요.
+
+> **참고:** 데비안/우분투 일부 버전에서 아래 오류가 나타날 수 있습니다:
+> 
+> {% filename %}명령줄{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  데비안/우분투 시스템에는, 다음 명령을 사용 하여 python3 venv 패키지를 설치 해야 합니다.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> 이 경우에는, 위에 `python3-venv` 패키지 설치 안내를 참고해요: {% filename %}명령줄{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **주의:** 일부 데비안/우분투 버전의 경우 가상환경을 초기화할때 아래와 같은 에러가 발생할 수 있어요:
+> 
+> {% filename %}명령줄{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> 이 문제를 해결하려면 `virtualenv` 명령을 사용해야해요.
+> 
+> {% filename %}명령줄{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **주의:** 만약 아래와 같은 에러가 발생할 경우
+> 
+> {% filename %}명령줄{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> 대신 아래와 같이 실행해요:
+> 
+> {% filename %}명령줄{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## 가상환경 사용하기
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+다음과 같이 가상환경을 실행하세요.
+
+{% filename %}명령줄{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. 이 경우 "관리자 권한으로 실행" 옵션을 사용해 새 윈도우 파워셸을 열어요. 가상환경을 시작하기 전에 그리고 아래 명령을 입력해요.
+> 
+> {% filename %}명령줄{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> 이것은 편집기창과 명령창을 전환하지 않아도 된다는 장점이 있어요.
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+가상환경을 실행해서 시작:
+
+{% filename %}명령줄{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+실행할 때 `myvenv` 부분에 자신이 선택한 `가상 환경`의 이름을 적어야해요!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}명령줄{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+콘솔에서 `(myvenv)`가 보이면 `virtualenv(가상환경)`이 실행되고 있다는 거에요.
+
+가상 환경을 시작하고 나면 `python`이라고만 해도 지정한 버전의 파이썬이 실행되기 때문에 `python3` 대신 `python`이라고 입력해도 된답니다.
+
+자, 이제 필요한 것들이 준비되었어요. 드디어 장고를 설치할 수 있어요!
+
+## Django 설치하기 {#django}
+
+`virtualenv`가 시작됐으니, `pip`으로 장고를 설치할 수 있어요.
+
+하기전에 먼저, 장고를 설치하기 위한 스프트웨어인 `pip`가 최신버전인지 확인해요.
+
+{% filename %}명령줄{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### 패키지와 requirement 설치
+
+requirements는 `pip install`로 설치가 필요한 것들의 목록을 유지합니다.
+
+먼저 이전에 설치한 코드편집기를 사용해 `djangogirls/` 폴더안에 `requirements.txt`파일을 생성해요. 코드 편집기에서 새 파일을 연 다음 `requirements.txt`을 `djangogirls/` 폴더에 저장해요. 디렉토리는 다음과 같을거에요:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+`staticcss/requirements.txt`파일에 아래의 코드를 추가하세요:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+이제 `pip install -r requirements.txt` 을 실행해 장고를 설치해요.
+
+{% filename %}명령줄{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). 만약 그렇다면 (`C:\djangogirls`처럼) 공백이나 특수문자가 없는 곳으로 옮겨보세요. 디렉토리에 새로운 가상환경을 만들고, 이전 가상환경을 삭제한 후 명령을 다시 시도해보세요. (가상환경은 절대 경로를 사용하기 때몬에 경로를 변경하면 작동하지 않습니다)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}명령줄{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> 우분투 12.04에서 오류가 발생했다면 `python -m pip install -U --force-reinstall pip` 명령으로 가상환경 내의 pip를 고쳐주세요.
+
+<!--endsec-->
+
+잘했어요! 드디어 장고 어플리케이션을 만들 준비가 끝났습니다!
\ No newline at end of file
diff --git a/ko-KR/django_models/README.md b/ko-KR/django_models/README.md
new file mode 100644
index 00000000000..46c846898b3
--- /dev/null
+++ b/ko-KR/django_models/README.md
@@ -0,0 +1,201 @@
+# Django 모델
+
+이번에 우리가 만들고자 하는 부분은 블로그 내 모든 포스트를 저장하는 부분이에요. 먼저 우리는 `객체(object)`에 대해서 조금 알고 있어야해요.
+
+## 객체(Object)
+
+프로그래밍 개발 방법 중에는 `객체 지향 프로그래밍(object oriented programming)`이라 부르는 개념이 있어요. 이 개발 방법은 프로그램이 어떻게 작동해야 하는지 모든 것을 하나하나 지시하는 것 대신, 모델을 만들어 그 모델이 어떤 역할을 가지고 어떻게 행동해야 하는지 정의하여 서로 알아서 상호작용할 수 있도록 만드는 것입니다.
+
+그렇다면 객체란 무엇일까요? 객체란 속성과 행동을 모아놓은 것이라고 할 수 있어요. 낯설게 느껴지지만 예를 들어보면 별 것 아님을 알게 될 거에요.
+
+예를 들어 `고양이(Cat)`라는 객체를 모델링 한다고 해볼게요. 이 고양이는 여러 속성을 가지고 있어요: `색깔`, `나이`, `분위기`(착한, 나쁜, 졸려 하는), `주인`(주인이 `사람`일 수도 있지만, 길고양이면 주인이 없으니 속성이 빈 값이 될 수 있어요) 등이 될 수 있겠지요.
+
+또 `고양이는` 특정 행동을 할 수 있어요: `야옹야옹하기`, `긁기`, 또는 `먹기` 등이 있겠네요. (`맛`과, 고양이에게 `고양이먹이`는 행동하는 객체가 달라요).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+기본적으로 객체지향설계 개념은 현실에 존재하는 것을 속성과 행위로 나타내는 것입니다. 여기서 속성은 `객체 속성(properties)`, 행위는 `메서드(methods)`로 구현됩니다).
+
+그렇다면 블로그 글을 모델로 만들 수 있을까요? 우리는 블로그를 만들고 싶잖아요, 그렇죠?
+
+우리는 다음 질문에 답할 수 있어야 해요: 블로그 글이란 무엇일까? 어떤 속성들을 가져야 할까?
+
+블로그는 제목과 내용이 필요하죠? 그리고 누가 썼는지도 알 수 있게 작성자(author) 도 추가하면 좋을 것 같아요. 마지막으로, 그 글이 작성된 날짜와 게시된 날짜도 알면 좋겠어요.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+블로그 글로 할 수 있는 것은 어떤 것들이 있을까요? 글을 출판하는 `메서드(method)`가 있으면 좋겠죠?
+
+그래서 우리는 `publish` 메서드도 만들어야 합니다.
+
+이제 무엇을 만들어야하는지 이미 알았으니, 장고에서 모델을 만들어 봅시다!
+
+## 장고 모델
+
+객체(object) 가 어떻게 구성되어야 하는지 이전에 살펴봤으니, 이번에는 블로그 글을 위한 장고 모델을 만들어봅시다.
+
+장고 안의 모델은 객체의 특별한 종류입니다. 이 모델을 저장하면 `데이터베이스`에 저장되것이죠. 데이터베이스란 데이터의 집합입니다. 데이터들이 모아져 있는 곳이지요. 이곳에 유저에 대한 정보나 여러분의 블로그 글 등등이 저장되어 있습니다. 우리는 데이터를 저장하기 위해서 여러가지 데이터베이스를 입맛에 맞게 고를 수 있는데요, 여기서는 SQLite 데이터베이스를 사용하겠습니다. Sqlite는 장고에서 기본으로 설정되여 있는 자료기지입니다. 이것을 어댑터라고 하죠. 어댑터가 무엇인지 알려면 설명이 길어지니 지금은 이 정도만 알고 있어도 충분할것 같아요.
+
+쉽게 말해 데이터베이스안의 모델이란 엑셀 스프레드시트와 같다고 말할 수 있어요. 엑셀 스프레드시트를 보면 열(필드) 와 행(데이터) 로 구성되어 있죠? 모델도 마찬가지입니다.
+
+### 어플리케이션 제작하기
+
+잘 정돈된 상태에서 시작하기 위해, 프로젝트 내부에 별도의 어플리케이션을 만들어볼 거에요. 처음부터 모든 것이 잘 준비되어있다면 훌륭하죠. 어플리케이션을 만들기 위해 콘솔창(`djangogirls` 디렉토리에서 `manage.py` 파일)에서 아래 명령어를 실행하세요.
+
+{% filename %}Mac OS X 와 Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+이제 `blog`디렉터리가 생성되고 그 안에 여러 파일도 같이 들어있는 것을 알 수 있어요. 디렉토리와 그 안의 파일들은 아래와 같을거에요.
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+어플리케이션을 생성한 후 장고에게 사용해야한다고 알려줘야 합니다. 코드편집기에서 `mysite/settings.py` 파일을 열어 진행할거에요. 이 파일 안에서 `INSTALLED_APPS`를 찾고 `]`바로 위 라인에`'blog.apps.BlogConfig'`을 추가하세요.. 최종 결과물은 아래와 다음과 같을 거에요.
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### 블로그 글 모델 만들기
+
+모든 `Model` 객체는 `blog/models.py` 파일에 선언하여 모델을 만듭니다. 이 파일에 우리의 블로그 글 모델도 정의할 거에요.
+
+`blog/models.py` 파일을 열어서 안에 모든 내용을 삭제한 후 아래 코드를 추가하세요:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> `str`양 옆에 언더스코어(`_`) 를 두 개씩 넣었는지 다시 확인하세요. 이건 관습은 파이썬에서 자주 사용되는데, "던더(dunder; 더블-언더스코어의 준말)"라고도 불려요.
+
+으음... 코드가 좀 무서워졌죠? 걱정마세요. 각 줄마다 어떤 의미인지 설명해드릴거에요.
+
+`from` 또는 `import`로 시작하는 부분은 다른 파일에 있는 것을 추가하라는 뜻입니다. 다시 말해, 매번 다른 파일에 있는 것을 복사&붙여넣기로 해야하는 작업을 `from</0>이 대신 불러와주는 거죠 import ...`.
+
+`class Post(models.Model):`는 모델을 정의하는 코드입니다. (모델은 `객체(object)`라고 했죠?
+
+- `class`는 특별한 키워드로, 객체를 정의한다는 것을 알려줍니다.
+- `Post`는 모델의 이름입니다. (특수문자와 공백 제외한다면) 다른 이름을 붙일 수도 있습니다. 항상 클래스 이름의 첫 글자는 대문자로 써야 합니다.
+- `models.Model`은 Post가 장고 모델임을 의미합니다. 이 코드 때문에 장고는 Post가 데이터베이스에 저장되어야 된다고 알게 됩니다.
+
+이제 속성을 정의하는 것에 대해서 이야기해볼게요: `title`, `text`, `created_date`, `published_date`, `author`에 대해서 말할 거에요. 각 필드마다 어떤 종류의 데이터 타입을 가지는지를 정해야해요. (텍스트? 숫자? 날짜? 예를 들어, 유저와 같은 다른 객체와의 관계?)
+
+- `models.CharField` - 글자 수가 제한된 텍스트를 정의할 때 사용합니다. 글 제목같이 대부분의 짧은 문자열 정보를 저장할 때 사용합니다.
+- `models.TextField` - 글자 수에 제한이 없는 긴 텍스트를 위한 속성입니다. 블로그 콘텐츠를 담기 좋겠죠?
+- `models.DateTimeField` - 이것은 날짜와 시간을 의미합니다.
+- `models.ForeignKey` - 다른 모델이 대한 링크를 의미합니다.
+
+시간 관계상 모든 코드를 하나하나 다 설명하지는 않을 거예요. 모델의 필드를 정의하는 방법에 궁금하거나 위에서 설명한 것 이외의 것이 알고 싶다면 아래 장고 공식 문서를 꼭 읽어보길 바랍니다. (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+`def publish(self):`는 무슨 뜻일까요? 이 것이 바로 앞서 말했던 `publish`라는 메서드(method) 입니다. `def`는 이 것이 함수/메서드라는 뜻이고, `publish`는 메서드의 이름입니다. 원한다면 메서드 이름을 변경할 수도 있어요. 이름을 붙일 때는 공백 대신, 소문자와 언더스코어를 사용해야 합니다. 예를 들어, 평균 가격을 계산하는 메서드는 `calculate_average_price`라고 부를 수 있겠네요.
+
+메서드는 자주 무언가를 되돌려주죠. (`return`) 그 예로 `__str__` 메서드를 봅시다. 이 시나리오대로라면, `__str__`를 호출하면 Post 모델의 제목 텍스트(**string**) 를 얻게 될 거에요.
+
+클래스 내 `def publish(self):`, `def __str__(self):`는 들여쓰기가 되어 있습니다. 파이썬은 공백에 민감한 때문에, 클래스 내 메소드는 들여쓰기를 해줘야 합니다. 그렇지 않으면 메소드가 클래스안에 속하지 않아서 예기치 않은 동작이 발생할 수 있습니다.
+
+아직 모델에 대해서 잘 모르는 부분이 있다면, 코치에게 자유롭게 물어보세요! 지금 배운 내용이 너무 복잡하게 느껴질 수 있어요. 객체와 함수를 배운 적이 없는 분들이 한꺼번에 배우게 된다면 특히 그렇겠죠. 그래도 해 볼 만한 마법이라고 생각했으면 좋겠어요!
+
+### 데이터베이스에 모델을 위한 테이블 만들기
+
+이 장의 마지막 단계입니다. 이제 데이터베이스에 우리의 새 모델을 추가할 거에요. 먼저 우리는 장고 모델에 (우리가 방금 만든!) 몇 가지 변화가 생겼다는 걸 알게 해줘야 합니다. (콘솔로 돌아가 `python manage.py makemigrations blog`를 입력하세요. 아마도 화면에 이렇게 보이겠죠?
+
+{% filename %}명령줄{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+주의: 수정한 파일들을 저장하는것을 잊지 마세요. 만약 그렇지 않으면 에러 메시지가 보이는 이전 코드가 실행될거에요.
+
+장고는 데이터베이스에 바로 반영할 수 있도록 마이그레이션 파일(migration file)이라는 것을 준비해 두었답니다. 이제 `python manage.py migrate blog` 명령을 실행해, 실제 데이터베이스에 모델 추가를 반영하겠습니다. :
+
+{% filename %}명령줄{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+만세! 드디어 글 모델이 데이터베이스에 저장되었습니다. 너무 멋지 않나요? 빨리 다음 장으로 넘어가서 블로그 글을 확인하러 가요!
\ No newline at end of file
diff --git a/ko-KR/django_orm/README.md b/ko-KR/django_orm/README.md
new file mode 100644
index 00000000000..f2255878e1d
--- /dev/null
+++ b/ko-KR/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM과 QuerySets(쿼리셋)
+
+이번 장에서는 장고를 데이터베이스에 연결, 데이터를 저장하는 방법에 대해서 알아볼 거에요. 함께 시작해봅시다!
+
+## 쿼리셋(QuerySet) 은 무엇인가요?
+
+핵심만 말하자면, 쿼리셋은 전달받은 모델의 객체 목록입니다. 쿼리셋은 데이터베이스로부터 데이터를 읽고, 필터를 걸거나 정렬을 할 수 있습니다.
+
+가장 쉽게 배우는 방법은 예제로 배우는 것이죠. 함께 해볼까요?
+
+## 장고 쉘(shell)
+
+PythonAnywhere가 아닌 로컬 컨솔에서 아래 명령을 입력하세요. :
+
+{% filename %}명령줄{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+실행하면 아래처럼 나올 거에요.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+여러분은 이제 장고 인터랙티브 콘솔(interactive console) 로 들어왔습니다. 파이썬 프롬프트와 비슷하지만 장고만의 마법을 부릴 수 있는 곳이기도 하지요. :) 물론 파이썬의 모든 명령어를 여기서 사용할 수 있습니다.
+
+### 모두 보기
+
+자, 이제 먼저 입력했던 모든 글들을 출력하겠습니다. 아래와 같이 입력하세요.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+이런! 에러가 나타났어요. 글이 없다고 하네요. 이럴수가... 그런데 이렇게 나오는 것이 맞는 거랍니다. 이 글을 먼저 불러오는 것(import) 을 잊었네요!
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+간단합니다. : 우리는 `Post`모델을 `blog.models`에서 불러왔어요. 이제 모든 글들을 출력해봅시다.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+우리가 만들었던 그 글 목록이 나타났네요! 장고 관리자 인터페이스로 만들었던 것들이에요. 그런데 파이썬으로 새 글을 포스팅하려면, 어떻게 해야할까요?
+
+### 객체 생성하기
+
+데이터베이스에 새 글 객체를 저장하는 방법에 대해 알아봅시다.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+하지만 여기에 뭔가 빼먹은 것이 하나 있어요.: `me` . 작성자로서 `User`(사용자) 모델의 인스턴스를 가져와 전달해줘야 합니다. 어떻게 해야 할까요?
+
+먼저 User 모델을 불러옵니다. :
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+데이터베이스에서 user는 어떤 일을 할까요? 함께 알아봅시다:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+이전에 만든 슈퍼유저에요! 사용자 개체를 얻어봐요(현재 가지고 있는 사용자이름을 사용하기위해 다음줄을 수정해요)
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+보다싶이 우리는 `username` 이 'ola'인 사용자를 깔끔하게`get`했어요.
+
+드디어 우리 게시물을 만들었네요. :
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+만세! 그런데 제대로 작동했는지 확인해봐야죠?
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+보세요, 목록에 게시글 하나가 더 늘었네요! 
+
+### 글 더 추가하기
+
+점점 재밌어질 거에요. 몇 개 글을 더 추가해서 잘 작동하는지 확인해봅시다. 2-3개 정도만 더 추가해보고 다음 내용으로 넘어갈게요.
+
+### 필터링하기
+
+쿼리셋의 중요한 기능은 데이터를 필터링하는 거에요. 예를 들어, 우리는 ola라는 User가 작성한 모든 글을 찾고 싶다고 해볼게요. 이런 경우 `Post.objects.all()`에서 `all` 대신, `filter`를 사용합니다. 쿼리셋 안에 있는 괄호 안에 우리가 원하는 조건(들)을 넣어줄 거에요. 지금 이 경우에는 `author`가 `me`인 조건을 넣어야겠죠. 이걸 장고로 표현한다면 `author=me`가 됩니다. 이제 이 조건이 반영된 코드를 볼까요. :
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+또는 모든 글들 중, `제목(title)`에 'title'이라는 글자가 들어간 글들만을 뽑아내서 보고 싶다면요?
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **주의하세요** `title`와 `contains` 사이에 있는 밑줄(`_`)이 2개입니다. 장고 ORM은 필드 이름("title")과 연산자과 필터("contains")를 밑줄 2개를 사용해 구분합니다. 밑줄 1개만 입력한다면, "FieldError: Cannot resolve keyword title_contains"라는 오류가 뜰 거에요.
+
+우리는 출판된 글 목록을 볼 수 있어요. 이를 위해 `출판 날짜(published_date)`가 과거인 글들을 필터링하면 가져오면 되겠죠.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+안타깝게도, 파이썬 콘솔에서 추가한 게시물은 아직 보이지 않네요. 하지만 바꿀 수 있어요! 먼저 게시하려는 게시물의 인스턴스를 얻어야 해요. :
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+그리고 `publish` 메서드를 사용해서 출판합시다:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+이제 (위쪽 화살표 버튼 3번을 누르고 `enter`를 눌러) 다시 게시된 글의 목록을 가져와 봅시다.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### 정렬하기
+
+퀘리셋은 객체 목록을 정렬도 할 수 있어요. 이제 `created_date` 필드를 정렬해봅시다. :
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+`-`을 맨 앞에 붙여주면 내림차순으로 정렬도 가능해요. :
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### 메서드체이닝을 활용한 복잡한 쿼리
+
+보다싶이, `Post.objects` 의 몇몇 함수는 쿼리셋을 반환해요. 쿼리셋에서도 동일한 함수를 호출할 수 있어요, 그리고새 쿼리셋을 반환한답니다. 쿼리셋들을 함께 **연결(chaining)**할 수도 있어요.
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+이 방법은 정말 강력해 복잡한 쿼리도 작성할 수 있게 해준답니다.
+
+좋아요! 이제 다음 내용으로 넘어갈 때로군요! 다음 명령을 입력해, 쉘을 종료하세요. :
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ko-KR/django_start_project/README.md b/ko-KR/django_start_project/README.md
new file mode 100644
index 00000000000..21393809440
--- /dev/null
+++ b/ko-KR/django_start_project/README.md
@@ -0,0 +1,260 @@
+# 나의 첫 번째 Django 프로젝트!
+
+> 이번 장의 일부는 Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)의 튜토리얼을 바탕으로 작성되었습니다.
+> 
+> 이번 장의 일부는 Creative Commons Attribution-ShareAlike 4.0 International License가 있는 [django-marcador tutorial](http://django-marcador.keimlink.de/)을 기초로 작성되었습니다. Django-marcador 튜토리얼은 Markus Zapke-Gründemann et al에게 저작권이 있습니다.
+
+이제 우리는 아주 간단한 블로그를 만들어 볼 거에요!
+
+첫 단계는 장고 프로젝트를 시작하는 거에요. 다시 말해 장고의 기본 골격을 만들어주는 스크립트를 실행할 거에요. 이 디렉토리와 파일 묶음은 나중에 사용할 것입니다.
+
+장고에서는 디렉토리나 파일 이름이 매우 중요하답니다. 우리가 생성할 그 파일들의 이름을 마음대로 변경해서는 안됩니다. 또한 그 파일들을 다른 곳으로 옮겨도 안됩니다. 장고는 중요한 것들을 찾을 수 있게 특정한 구조를 유지해야합니다.
+
+> 모든 것은 가상환경(virtualenv) 안에서 해야한다는 것을 기억하세요. 현재 콘솔창에서 접두어로 `(myvenv)`가 안보인다면 먼저 virtualenv를 활성화해야 합니다. **Django 설치하기**장의 **virtualenv 작동법**에서 이미 다루었던 내용입니다. 윈도우에서는 `myvenv\Scripts\activate`를 타이핑하고 Mac OS 또는 Linux에서는 `source myvenv/bin/activate`을 입력하세요.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+맥과 리눅스 콘솔에서는 다음과 같이 명령을 실행해야해요. **명령어 끝에 `.`(점, 마침표) 을 입력하는 것을 잊지마세요.** :
+
+{% filename %}명령줄{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> 점 `.`은 현재 디렉토리에 장고를 설치하라고 스크립트에 알려주기 때문에 중요해요. (축약된 표시이죠).
+> 
+> **참고** 위 명령을 입력할 때 `django-admin`로 시작하는 부분만 입력하세요. 여기에 보이는 `(myvenv) ~/djangogirls$` 부분은 커맨드라인에 입력을 가져오게 하는 프롬트프(prompt)의 예시에요.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+윈도우에서는 다음과 같이 명령을 실행해야 해요. **명령어 끝에 `.`(점, 마침표) 을 입력하는 것을 잊지마세요.** :
+
+{% filename %}명령줄{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> 점 `.`은 현재 디렉토리에 장고를 설치하라고 스크립트에 알려주기 때문에 중요해요. (축약된 표시이죠).
+> 
+> **참고** 위 명령을 입력할 때 `django-admin.exe`로 시작하는 부분만 입력하세요. 여기에 보이는 `(myvenv) C:\Users\Name\djangogirls>` 부분은 커맨드라인에 입력을 가져오게 하는 프롬트프(prompt)의 예시에요.
+
+<!--endsec-->
+
+`django-admin.py`은 스크립트로 디렉토리와 파일들을 생성해줍니다. 스크립트 실행 후에는 아래와 같이 새로 만들어진 디렉토리 구조를 볼 수 있을 거에요.
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **주의**: 디렉토리 구조안에, `venv` 디렉토리가 보인다면, 이미 이전에 만들어 놓은 것이에요.
+
+`manage.py` 파일 또한 스크립트인데, 사이트 관리를 도와주는 역할을 합니다. 이 스크립트로 다른 설치 작업 없이, 컴퓨터에서 웹 서버를 시작할 수 있습니다.
+
+`settings.py`는 웹사이트 설정이 있는 파일입니다.
+
+앞에 우편 배달부는 어느 곳으로 편지를 배달해야하는지 판단해야한다고 말했던 것을 기억하고 있나요? `urls.py` 파일은 `urlresolver`가 사용하는 패턴 목록을 포함하고 있습니다.
+
+지금 그 파일들을 수정하지 않을 거니 무시하세요. 실수로 파일을 지우지 않게 조심하세요!
+
+## 설정 변경
+
+`mysite/settings.py`을 조금 고쳐 볼게요. 설치한 코드 에디터를 열어 파일을 열어주세요.
+
+**주의**: `settings.py` 은 다른파일과 마찬가지로 일반 파일임을 명심하세요. 코드편집기에서 "파일 -> 열기"메뉴를 통해 열 수 있어요. `settings.py` 파일을 찾고 선택할 수 있는 일반적인 창이 나타난답니다. 또는, 바탕화면의 djangogirs폴더로 이동해서 마우스 우클릭후 파일을 열 수 있어요. 그리고 목록에서 코드편집기를 선택하세요. 파일을 열 수는 있지만 편집할 수는 없는 다른 프로그램이 설치되어 있을 수 있으므로 편집기를 선택하는 것이 중요해요.
+
+웹사이트에 정확한 현재 시간을 넣으면 좋겠죠. [위키피디아의 타임존 목록](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)으로 이동해서 연관된 타임존(TZ) (예를 들어`Europe/Berlin`).
+
+Settings.py에서 `TIME_ZONE`있는 줄을 찾으세요. 그리고 이를 해당 시간대로 변경하세요.
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+언어코드는 예를 들어 `en` 은 영어, `de` 는 독일어와 같이 구성 되어 있어요. 그리고 국가 코드는 예를 들어 `de`는 독일, `ch` 는 스위스와 같이 구성되어 있어요. 영어가 모국어가 아니라면, 이것을 추가해서 장고의 기본 버튼과 알림을 당신의 언어로 변경할 수 있어요. "Cancel" 버튼을 당신이 정의한 언어로 바꿀 수 있을거에요. [장고는 이미 준비된 번역본을 포함하고 있어요](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+다른 언어를 원한다면, 아래와 같이 언어 코드를 바꾸어서 변경할 수 있어요:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+그리고 경로에 정적파일을 추가해야 해요. (정적 파일과 CSS에 대한 자세한 내용은 튜토리얼 뒷부분에서 확인하겠습니다.) 파일의 *끝*으로 내려가서 `STATIC_URL` 항목 바로 아래에 `STATIC_ROOT`라는 새 항목을 추가해요.
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+`DEBUG` 가 `True` 이고 `ALLOWED_HOSTS` 가 비어있다면, 호스트가`['localhost', '127.0.0.1', '[::1]']`로 검증됩니다. 애플리케이션을 배포하고나면 PythonAnywhere 호스트 이름과 일치하지 않으므로 다음 설정을 변경합니다.
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **주의**: 크롬북을 사용하고 있다면, settings.py 에 아래 라인과 같이 추가해요: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> 그리고 cloud9을 사용하고 있다면 `ALLOWED_HOSTS`에 `.amazonaws.com` 을 추가해요.
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## 데이터베이스 설정하기
+
+사이트 내 데이터를 저장하기 위한 많은 다양한 데이터베이스 소프트웨어들이 있습니다. 그 중에서 우리는 `sqlite3`을 사용할 거에요.
+
+사실 이미 `mysite/settings.py` 파일 안에 설치가 되어있어요. :
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+블로그에 데이터베이스를 생성하기 위해서 콘솔창에서 아래 코드를 실행하세요: `python manage.py migrate` (이 명령을 실행하기 위해서는 `djangogirls`디렉토리 안에 있는 `manage.py` 필요합니다.) 잘 작동되면, 아래와 같은 내용이 나옵니다. :
+
+{% filename %}명령줄{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+잘했네요! 이제 웹 서버를 시작해 웹사이트가 잘 작동하는지 확인해봐요!
+
+## 웹 서버 시작하기
+
+프로젝트 디렉토리(the `djangogirls` directory)에 `manage.py` 파일이 있어야 합니다. 콘솔에서는 `python manage.py runserver` 명령을 실행해, 웹서버를 바로 시작할 수 있습니다. :
+
+{% filename %}명령줄{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+만약 크롬북을 쓰고 있다면, 대신에 이 명령을 사용해요:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}브라우저{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> 우리는 이미 **인터넷 작동 방법** 장에서 어떻게 웹서버가 작동하는지 알아봤어요. 
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ko-KR/django_templates/README.md b/ko-KR/django_templates/README.md
new file mode 100644
index 00000000000..2dde72ff055
--- /dev/null
+++ b/ko-KR/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django 템플릿
+
+이제 데이터를 보여줄 차례에요! 이를 위해 장고는 내장된 **template tags**라는 유용한 기능을 제공합니다.
+
+## 템플릿 태그는 무엇인가요?
+
+HTML에 여러분은 파이썬 코드를 바로 넣을 수 없어요. 브라우저는 HTML만을 알고 있고 파이썬 코드를 이해할 수 없기 때문이에요. 알다시피 HTML는 정적이지만, 파이썬은 동적입니다.
+
+**장고 템플릿 태그**는 파이썬을 HTML로 바꿔주어, 빠르고 쉽게 동적인 웹사이트를 만들 수 있게 도와주어요. 야호!
+
+## post 목록 템플릿 보여주기
+
+이전 장에서 글 목록이 들어있는 `posts` 변수를 템플릿에 넘겨주었습니다. 이제 넘겨진 posts 변수를 받아서 HTML에 나타나도록 해볼 차례예요.
+
+장고 템플릿 안에 있는 값을 출력하려면, 변수 이름안에 중괄호를 넣어 표시해야합니다. 이렇게요. :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+`blog/templates/blog/post_list.html` 템플릿에서 하세요. 에디터로 열고 두 번째 `<div>`에서 세 번째 `</div>`까지를 `{{ posts }}`로 바꾸세요. 파일을 저장하고 페이지를 새로 고침하면 이렇게 보입니다. :
+
+![그림 13.1](images/step1.png)
+
+우리는 아래와 같이 만들었어요. :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+이는 장고가 {{ posts}} 를 객체들의 목록으로 이해하고 처리했다는 것을 의미해요. **파이썬 들어가기**에서 어떻게 목록을 보여줬는지 기억하고 있나요? 맞아요, for loop을 이용해서죠! 장고 템플릿에서는 이렇게 해야합니다. :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+여러분의 템플릿 파일에 적용해 보세요.
+
+![그림 13.2](images/step2.png)
+
+잘 작동하네요! 그런데 디자인이 별로죠. 앞에서 **HTML 소개** 챕터에서 했던 정적 글들처럼 보이면 참 좋을텐데 말이에요. HTML과 템플릿 태그를 섞어 사용하면 멋있게 만들 수 있어요. 우리의 `body`는 다음과 같을 거에요. :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %} `{% for %}` 와 `{% endfor %}`사이에 넣은 모든 것은 목록의 모든 객체를 반복하게 됩니다. 페이지를 새로고침 해보세요: {% endraw %}
+
+![그림 13.3](images/step3.png)
+
+(`{{ post.title }}`라던가 `{{ post.text }}`) 같이 이전과 다른 표기법을 사용한 것을 눈치 채셨나요? `Post` 모델에서 정의한 각 필드의 데이터에 접근하기 위해 이 표기법을 사용합니다. 또한 `|linebreaks` 같이 파이프 문자(|)도 사용해요. 이건 블로그 글 텍스트에서 행이 바뀌면 문단으로 변환하도록 하라는 의미입니다. 행바뀜을 문단으로 변환하는 필터를 적용한다는 표현을 쓰기도 합니다.
+
+## 한 가지 더
+
+나혼자만 웹 사이트를 보는게 아니라 다른 사람들도 인터넷을 통해서 볼 수 있으면 참 좋겠죠? 이제 PythonAnywhere에 다시 여러분이 만든 블로그를 배포해봅시다. 아래에 각 단계별로 요약했어요.
+
+* 먼저, 코드를 깃허브에 푸시해보아요
+
+{% filename %}명령줄{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* 다음 [PythonAnywhere](https://www.pythonanywhere.com/consoles/)로 돌아와 **배시 콘솔창**으로 가서(또는 이미 닫았다면 새 콘솔창을 여세요), 다음 명령어를 실행하세요. :
+
+{% filename %}PythonAnywhere 명령줄{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(당신의 PythonAnywhere 서브 도메인을 `<your-pythonanywhere-domain>`에 화살괄호 없이 입력하는것을 잊지마세요)
+
+* 마지막으로 [웹 탭(Web tab)](https://www.pythonanywhere.com/web_app_setup/)으로 가서 여러분의 웹 앱을 **다시 불러오기**를 하세요. (PythonAnywhere 의 다른 페이지를 콘솔에서 접근하기 위해서는, 우측상단 메뉴 버튼을 이용해요.) 새로 업데이트한 내용이 https://subdomain.pythonanywhere.com 에 갱신될 거에요-- 브라우저에서 확인해보세요! PythonAnywhere 사이트 내 블로그 게시글 내용과 로컬 서버에 있는 내용이 똑같지 않아도 돼요. 로컬 컴퓨터 데이터베이스와 PythonAnywehere 데이터베이스 파일은 파일 동기화를 하지 않아요.
+
+축하합니다! 장고 관리자 화면에서 새 게시글을 작성하세요. (published_date를 만든 것을 기억하세요!) pythonanywhere 사이트 https://subdomain.pythonanywhere.com/admin에서 장고 관리자인 것을 확인하세요. 새로고침을 하고 게시글이 잘 보이는지 확인해보세요.
+
+잘 작동하니까 멋지죠? 참 자랑스러워요! 잠시 쉬고 오세요. :)
+
+![그림 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ko-KR/django_urls/README.md b/ko-KR/django_urls/README.md
new file mode 100644
index 00000000000..646ec48cdb4
--- /dev/null
+++ b/ko-KR/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django urls
+
+첫 웹페이지를 만들어 보기로 해요: 여러분의 블로그를 위한 홈페이지요! 그 전에 먼저 장고 URL에 대해서 조금 알아봅시다.
+
+## URL이란 무엇인가요?
+
+URL은 웹 주소입니다. 웹사이트를 방문할 때마다 URL을 볼 수 있으며 브라우저의 주소창에 표시됩니다. (맞아요! `127.0.0.1:8000`가 URL입니다! 그리고 `https://djangogirls.org` 또한 URL이죠.)
+
+![URL](images/url.png)
+
+인터넷에 있는 모든 페이지들은 자신만의 URL을 가지고 있어야 해요. 이런 방식으로 어플리케이션은 URL을 입력한 사용자에게 어떤 내용을 보여줘야할지 알게 됩니다. 장고 에서는 `URLconf` (URL configuration)라는걸 사용합니다. URLconf는 장고에서 URL과 일치하는 뷰를 찾기 위한 패턴들의 집합입니다.
+
+## Django에서 URL은 어떻게 작동할까요?
+
+코드 에디터에서 `mysite/urls.py`파일을 열면 아래와 같을 거에요. :
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+보다싶이, 장고가 이미 어떤 내용을 넣어 두었네요.
+
+세 개의 따옴표들(`"""`, `'''`) 사이에 있는 줄들은 독스트링(docstring)이라 불려요. 파일의 최상단이나 클래스 혹은 메서드 위에 적어두면, 그것이 어떤 역할을 하는지 알려주는 역할을 합니다. 여기있는 내용은 실행되지 않아요.
+
+이전 장에서 봤던 관리자 URL도 여기에 이미 있어요:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+이 줄의 의미는 `admin/`으로 시작하는 모든 URL을 장고가 *view*와 대조해 찾아낸다는 뜻입니다. 이 경우 많은 admin URL을 포함해야 하기 때문에 작은 파일안에 모두 들어가지 않아요. 여기에 좀 더 읽기 좋고 깔끔한 방법이 있어요.
+
+## 나의 첫 번째 Django url!
+
+첫 번째 URL을 만들어 봅시다! 우리는 '<http://127.0.0.1:8000/>' 이 주소를 우리 블로그의 홈페이지 주소로 쓸 것이고, 이 주소로 들어가면 글 목록이 보이게 만들어 볼 거에요.
+
+또한 `mysite/urls.py`파일을 깨끗한 상태로 유지하기 위해, `blog` 어플리케이션에서 메인 `mysite/urls.py`파일로 URL들을 가져올 거에요.
+
+먼저, `blog.urls`를 가져오는 행을 추가해 봅시다. `blog.urls`를 가져오려면, `include` 함수를 이용해야 합니다. 그 함수를 이용하려면, `from django.urls` 로 시작하는 행을 수정해야 할 거에요.
+
+이제 `mysite/urls.py` 파일은 아래처럼 보일 거에요.
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+지금 장고는 'http://127.0.0.1:8000/'로 들어오는 모든 접속 요청을 `blog.urls`로 전송하고 추가 명령을 찾을 거에요.
+
+## blog.urls
+
+`blog` 디렉토리에 `urls.py` 라는 이름의 빈 파일을 만들고 코드 에디터로 여세요. 좋아요! 이제 아래 두줄을 추가합니다:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+우리는 장고에서 제공되는 함수 `path`와 `blog` 애플리케이션에서 사용할 모든 `views`를 불러오고 있어요. (물론 아직 뷰를 하나도 안 만들었지만, 곧 만들거니 조금만 기다리세요!)
+
+그 다음, 첫 번째 URL 패턴을 추가하세요.
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+이제 `post_list`라는 이름의 `view`가 루트 URL에 할당되었습니다. 이러한 URL 패턴은 빈 문자열에 매칭이 되며, 장고 URL 확인자(resolver)는 전체 URL 경로에서 접두어(prefix)에 포함되는 도메인 이름(i.e. <http://127.0.0.1:8000/>)을 무시해서 받아들입니다. 따라서, 이 패턴은 장고에게 누군가 웹사이트에 'http://127.0.0.1:8000/' 주소로 들어왔을 때 `views.post_list`를 보여주라고 말할 거에요.
+
+마지막 부분인 `name='post_list'` 는 URL에 이름을 붙인 것으로 뷰를 식별합니다. 이 부분은 뷰의 이름과 같을 수도 완전히 다를 수도 있습니다. 이름을 붙인 URL은 프로젝트의 후반에 사용할 거에요. 그러니 앱의 각 URL을 이름짓는 것은 중요합니다. 또 URL에 고유한 이름을 붙여, 외우고 부르기 쉽게 만들어야 해요.
+
+지금 http://127.0.0.1:8000를 접속 하려 하면 'web page not available(웹 페이지를 사용할 수 없습니다)'와 같은 메세지가 보일 겁니다. 이렇게 뜨는건 지금은 서버가(`runserver`라고 입력했던걸 기억하시나요?) 실행되고 있지 않기 때문이에요. 서버 콘솔을 보고 왜 그런지 이유를 찾아봅시다.
+
+![오류](images/error1.png)
+
+콘솔에서 에러가 발생했네요. 하지만 걱정하지 마세요. 에러는 해결할 방법을 알려준답니다. : __no attribute 'post_list'__ 라는 메시지가 보일 텐데요. 이것은 장고가 찾고 사용하려고하는 *뷰*가 아직 없다는 거에요. 이 단계에서 `/admin/`로도 접속되지 않을 거에요. 앞으로 고쳐볼 테니 걱정하지 마세요. 혹시 여러분이 다른 에러 메시지를 보게 된다면, 웹서버를 껐다 켜보세요. 이걸 하기 위해서는 콘솔창에서 실행되고 있는 웹 서버를 Ctrl+C 로 중지해요(Control 키와 C 키를 동시에 눌러야해요). 윈도우 에서는 Ctrl+Break 키를 눌러야 할거에요. 그리고 `python manage.py runserver` 명령을 입력해, 웹서버를 다시 시작해야 해요.
+
+> 장고 URL 설정에 대해 더 알고 싶다면 공식 문서를 읽어보세요. : https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ko-KR/django_views/README.md b/ko-KR/django_views/README.md
new file mode 100644
index 00000000000..4777968097c
--- /dev/null
+++ b/ko-KR/django_views/README.md
@@ -0,0 +1,44 @@
+# Django 뷰 만들기
+
+지난 장에서 만들었던 버그를 잡을 시간이 왔어요! :)
+
+뷰(*view*) 는 어플리케이션의 "로직"을 넣는 곳이에요. 뷰는 앞 챕터에서 만들었던 `모델`에게서 필요한 정보를 받아와서 `템플릿`에 전달하는 역할을 합니다. 다음 장에서 템플릿을 만들어 볼 거에요. 뷰는 **파이썬 들어가기** 장에서 했던 것 보다 조금 더 복잡해 보이는 파이썬 함수입니다.
+
+뷰는 `views.py` 파일 안에 있습니다. 우리는 *views*를 `blog/views.py` 파일 안에 추가할 거에요.
+
+## blog/views.py
+
+좋아요. 이제 이 파일을 열고 안에 있는 내용을 살펴봅시다. :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# 이 곳에 views를 추가하세요.
+```
+
+해야할 게 그렇게 많지는 않아요.
+
+`#`로 시작하는 줄은 주석이 됨을 기억하세요 – 이 라인은 파이썬에 의해 실행되지 않는 것을 의미합니다.
+
+주석내 추천에 따라 *view* 를 생성해 봅시다. 최소한의 뷰를 아래와 같이 추가해봅시다.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+방금 `post_list`라는 함수(`def`)를 만들었습니다. 이 함수는 `요청(request)`을 넘겨받아 `render`메서드를 호출합니다. 이 함수는 `render` 메서드를 호출하여 받은(return) `blog/post_list.html`템플릿을 보여줍니다.
+
+파일을 저장하고, http://127.0.0.1:8000/로 접속해 결과를 확인해보세요.
+
+에러가 발생했어요! 이제 아래 내용을 읽어보세요. :
+
+![오류](images/error.png)
+
+서버가 다시 실행했지만, 아직도 보여지지 않네요, 그렇죠? 걱정하지마세요, 이건 단순한 오류 페이지에요, 전혀 두려워하지 않아도 돼요! 콘솔에 에러 메세지가 나타나는 것은, 실제로 정말 유용하답니다! *TemplateDoesNotExist (템플릿이 존재하지 않습니다)*라고 읽을 수 있으니까요. 버그를 잡고 다음 장에서 템플릿을 만들어보아요!
+
+> Django 뷰에 대해 자세히 알고 싶으시면 공식 문서를 읽어보세요. https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ko-KR/dynamic_data_in_templates/README.md b/ko-KR/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..7ba3bf37bca
--- /dev/null
+++ b/ko-KR/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# 템플릿의 동적 데이터
+
+블로그 글은 각각 다른 장소에 조각조각 나눠져있어요. `Post`모델은 `models.py`파일에, `post_list`모델은 `views.py`파일에 있어요. 그리고 앞으로 템플릿도 추가해야 합니다. 하지만 실제로 HTML 템플릿에서 글들이 어떻게 보여질까요? 보여주고자 하는 컨텐츠(데이터베이스 안에 저장되어 있는 모델들) 를 가져와서 우리의 템플릿에 넣어서 멋있게 보여줄 것입니다.
+
+여기서 *views*가 모델과 템플릿을 연결하는 역할을 한다는 것을 알 수 있어요. `post_list` *view*에서 보여주고 템플릿에 넘기기 위해서 모델을 가져와야해요. 그래서 기본적으로 *view*에서는 템플릿에서 무엇을 보여줄 지 (모델)을 선택해야죠.
+
+자, 모두 했나요?
+
+이제 `blog/views.py` 파일을 열어봅시다. `post_list` *view* 파일이 아래처럼 보일꺼에요.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+다른 파일들에 있는 코드를 가져오는 것에 대해서 이야기 했던거 기억나나요? 이제 `models.py` 파일에서 정의한 모델을 가져올 때입니다. 이제 `from .models import Post` 행을 추가해 봅시다. 아래처럼 보이게 될 것입니다.:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+`from` 다음에 있는 마침표(.)는 *현재 디렉토* 또는* 현재 어플리케이션*을 의미합니다. `views.py` 및 `models.py` 같은 디렉터리에 있습니다. `.`와 파일 이름만으로 (`.py`없이) 사용할 수 있어요. 자 다음은 모델(`Post`)의 이름을 불러옵니다).
+
+그럼 그 다음은? `Post` 모델에서 실제 블로그 글들을 가져와야 하는데 이때 필요한 특별한 무엇인가가 `QuerySet`입니다.
+
+## 쿼리셋(QuerySet)
+
+여러분은 쿼리셋이 어떻게 동작하는지를 이미 친숙해져있어야 합니다. [Django ORM (쿼리셋)](../django_orm/README.md)에서 배운 내용입니다.
+
+자, 이제는 블로그 글 목록에 관심을 가져봅시다. 글 목록이 출판되고 `출판된 날짜(published_date)`기준으로 정렬되면 좋겠죠? 사실 이미 쿼리셋 장에서 배운 내용입니다.
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+코드 편집기에서 `blog/views.py` 파일을 열어보야요,그리고 `def post_list(request)` 함수를 작성해요 --하지만 먼저 `from django.utils import timezone`을 추가해야하는 것을 잊지 말아요:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+블로그 게시글 목록에 쿼리셋을 보여주려면, 두 가지 작업이 더 남았어요.
+
+1. `render` 함수 호출을 변경하여 `posts` 쿼리셋을 템플릿 컨텍스트에 전달합니다. 이제 할거에요.
+2. `posts` 쿼리셋을 보여주기위해 템플릿을 수정해요. 다음 챕터에서 다룰거랍니다.
+
+우리는 `posts`쿼리셋을 나타내는 *변수*를 만든다는 점에 주의하세요. 이 변수는 퀴리셋의 이름으로 취급하며 이 이름으로 참조할 수도 있습니다.
+
+`render` 함수는 `request`(인터넷을 통해 사용자로부터 받는 모든것)라는 하나의 매개변수를 가지고, 다른하나는 템플릿 파일(`'blog/post_list.html'`)을 전달해요. `{}` 와 같이 보이는 마지막 파라미터는 템플릿을 사용하기 위해 뭔가 추가하는 장소입니다. 이름을 넣어줘야 합니다. (여기서는 `'posts'`라고 하죠). :) 이렇게 보일지도 모르겠어요: `{'posts': posts}`. `:` 표시를 해 구분하는 것을 잊지 마세요; 양쪽에 작은 따옴표:`"`를 붙이는 것도요.
+
+그래서 최종적으로는 `blog/views.py` 파일이 아래처럼 될 것입니다. :
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+다 되었습니다! 이제 템플릿 파일로 돌아가서 이 쿼리셋을 나타나도록 하는 것을 해볼 때입니다.
+
+쿼리셋에 대해 더 알고 싶다면 장고 공식 문서를 읽어보세요. : https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ko-KR/extend_your_application/README.md b/ko-KR/extend_your_application/README.md
new file mode 100644
index 00000000000..0e3f08396b5
--- /dev/null
+++ b/ko-KR/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# 어플리케이션 확장하기
+
+우리는 지금까지 웹사이트 제작에 필요한 모든 단계들을 마쳤어요. 모델, URL, 뷰와 템플릿을 만드는지 알게 되었고요. 또 웹사이트를 어떻게 멋지게 꾸미는지 알게 되었어요.
+
+이제 연습해 봅시다!
+
+블로그에 가장 필요한 것은 페이지에 포스트가 보이게 만드는 것이겠죠?
+
+이미 앞에서 `Post` 모델을 만들었으니 `models.py`에 추가할 내용은 없습니다.
+
+## Post에 템플릿 링크 만들기
+
+`blog/templates/blog/post_list.html` 파일에 링크를 추가하는 것부터 시작합시다. 아마 아래와 같을 거에요. : 코드편집기를 열면 아래와 같이 보일거에요: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}우리는 post 목록에 있는 제목에서 post의 내용 페이지로 가는 링크를 만들 거에요. `<h2><a href="">{{ post.title }}</a></h2>` 를 변경해 봅시다. post의 상세 페이지는 {% endraw %} 로 연결됩니다.
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %} `{% url 'post_detail' pk=post.pk %}`에 대해 설명할 때가 왔군요! 예상하셨겠지만 `{% %}` 표기는 장고 템플릿 태그를 사용하고 있는 것을 말합니다. 이번에는 우리를 위한 URL를 만들어 사용해 봅시다!{% endraw %}
+
+`post_detail` 부분은 `blog/urls.py`에서 URL을 name=post_detail 로 예측하는걸 의미해요.
+
+그리고 `pk=post.pk`는 어떨까요? `pk` 는 데이터베이스에서 각 레코드의 고유 식별자를 의미하는 기본키(Primary Key)의 줄임말이에요. 모든 장고 모델은 기본키 역할을 하는 필드를 가지고 있고 다른 이름이 무엇이든간에 "pk"라 할 수 있어요. `Post` 모델에 기본키를 정의하지 않았기 때문에,장고는 우리를 위해 기본키를 생성해요(기본값으로 필드명이 "id" 예를들어 1, 2, 3과 같이 레코드마다 숫자가 증가하는 숫자값을 지녀요) 그리고 각 글마다 이 필드를 추가한답니다. `post.pk`와 같이 기본키에 접근할 수 있어요, 같은 방법으로 `Post`객체의 다른 필드에 접근(`title`, `author`, 기타.)할 수 있어요.
+
+http://127.0.0.1:8000/를 열어보세요. 오류 메세지가 나올 거에요. (예상대로, 아직 `post_detail`을 위한 *view*파일 만들지 않아 오류가 나는 것이죠.) 아마 이렇게 나왔을 거에요. :
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Post 상세 페이지에 URL 만들기
+
+`urls.py` 파일에 `post_detail` *view*를 위한 URL를 만들어 봅시다!
+
+첫 번째 게시물의 상세 **URL**은 이렇게 나올 거에요. : http://127.0.0.1:8000/post/1/
+
+`blog/urls.py`파일에 URL을 만들어, 장고가 `post_detail` *뷰*로 보내, 게시글이 보일 수 있게 해봅시다. `path('post/<int:pk>/', views.post_detail, name='post_detail')`코드를 `blog/urls.py`파일에 추가하면 아래와 같이 보일 거에요.
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+여기서 `post/<int:pk/>/`는 URL 패턴을 나타내요. 하나씩 차근차근 알아볼 거에요.
+
+- `post/`란 URL이 **post** 문자를 포함해야 한다는 것을 말합니다. 아직 할 만하죠?
+- `<int:pk>`<int:pk></0>는 조금 까다롭습니다. 장고는 숫자로 나타낼 수 있는 값을 읽어들이며, 이를 뷰에 `pk`라는 변수로써 전달할 수 있다는 것을 의미합니다.
+- `/`은 다음에 **/** 가 한 번 더 와야 한다는 의미입니다.
+
+브라우저에 `http://127.0.0.1:8000/post/5/`입력하면, 장고는 `post_detail`인 *view*를 찾고 있다고 생각하고 `pk`가 `5`와 일치한 *view*로 정보를 보내게 됩니다.
+
+좋아요, `blog/urls.py`에 새로운 URL 패턴이 추가됐네요! 페이지를 새로고침 해보세요: http://127.0.0.1:8000/ 짠! 서버 실행이 멈추었어요! 예상했던대로 콘솔에 에러가 발생했네요!
+
+![AttributeError](images/attribute_error2.png)
+
+다음 단계는 무엇일까요? 그렇죠. : view를 추가해야죠!
+
+## Post 상세 페이지에 뷰 추가하기
+
+이제 *view*는 추가적으로 매개 변수`pk`를 받아야합니다. *view*에 가져다가 써야겠죠? 그래서 함수를 정의할 때, pk를 받도록 `def post_detail(request, pk):`라고 정의 할 것입니다. 이 파라미터는 반드시 `urls` (`pk`)에 명시된 이름과 같아야 한다는걸 주의하세요. 변수가 생략되면 문제가 생겨 오류가 날 거에요!
+
+이제, 우리는 딱 한 개 블로그만 보고 싶어요. 이를 위해 다음과 같이 쿼리셋(queryset)을 사용해야해요. :
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+하지만 이 코드에는 문제가 있어요. `primary key` (`pk`)가있는 `Post`가 없다면 보고 싶지 않은 오류가 나올 거에요!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+우리가 원하는게 아니에요! 장고에서는 이를 해결 하기위해 특별한 기능을 제공해요. : `get_object_or_404`이에요. 이 기능을 사용하면 `pk`에 맞는 `Post`가 없을 경우, 멋진 페이지(`페이지 찾을 수 없음 404 : Page Not Found 404)`를 보여줄 거에요.
+
+![Page not found](images/404_2.png)
+
+좋은 점은 여러분 만의 `페이지 찾을 수 없음(Page not found)` 페이지를 예쁘게 만들 수 있다는 거에요. 지금 당장 중요한 것이 아니까 생략할게요.
+
+좋아요. 이제 `views.py` 파일에 *view*를 추가합시다!
+
+`blog/urls.py`파일에서 `views.post_detail`라는 뷰를 `post_detail`이라 이름을 붙이도록 URL 법칙을 만들었어요. 이는 장고가 `post_detail`이라는 이름을 해석할 때, `blog/views.py`파일 내부의 `post_detail`이라는 뷰 함수로 이해하도록 해줍니다.
+
+`blog/views.py`파일을 열고, `from`으로 시작하는 행에서 다음과 같이 코드를 추가해주세요:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+`blog/views.py`파일을 열고, `from`으로 시작하는 행에서 다음과 같이 코드를 추가해주세요:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+브라우저를 새로고침 해보세요. : http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+잘 되네요! 그런데 블로그 제목 안의 링크를 클릭하면 어떻게 되나요?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+이런! 또 에러가 나왔네요! 하지만 이제는 이런 걸 어떻게 다뤄야하는지 알고 있죠? 우리는 이제 템플릿을 추가해 볼 거에요!
+
+## Post 상세 페이지에 템플릿 만들기
+
+`blog/templates/blog` 디렉토리 안에 `post_detail.html`라는 새 파일을 생성하세요.
+
+다음 코드를 추가하세요:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+다시 한 번 `base.html`을 확장해 봅시다. `content` 블록에서, 블로그 글의 published_date 출판일(존재한다면) 과 제목, 내용을 보이게 할 거에요. 그런데 제일 중요한 것을 얘기해봐야하지 않겠어요?
+
+{% raw %}`{% if ... %} ... {% endif %}` 는 무엇인가를 확인할 때 사용하는 템플릿 태그 입니다. ( ` If else ...` 를 **파이썬 소개** 장에서 다뤘던걸 기억하나요?) 이 시나리오 에서는 우리는 글의`published_date` 가 비어있지 않은지 확인하고 싶어요.{% endraw %}
+
+페이지를 새로고침하면 `페이지 찾을 수 없음(Page not found)` 페이지가 없어진 것을 알 수 있어요.
+
+![Post detail page](images/post_detail2.png)
+
+야호! 잘 되네요!
+
+# 배포 시간!
+
+PythonAnywhere에서도 웹사이트가 잘 작동하는지 봐야겠죠? 다시 한 번 배포해봅시다.
+
+{% filename %}명령줄{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+그 다음 [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/)을 여세요:
+
+{% filename %}PythonAnywhere 명령줄{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(당신의 PythonAnywhere 서브 도메인을 `<your-pythonanywhere-domain>`에 화살괄호 없이 입력하는것을 잊지마세요)
+
+## 서버의 정적파일을 업데이트
+
+PythonAnywhere 와 같은 서버는 "정적 파일" (CSS와 같은 파일)을 파이썬 파일과는 다르게 다뤄요, 왜냐하면 더 빨리 불러올 수 있도록 최적화 할 수 있기 때문이에요. 결과적으로, 우리가 CSS파일을 변경했을때, 우리는 서버에서 이것을 업데이트하기 위한 추가 명령을 실행해야 해요. 이 명령은 `collectstatic`이라 불려요.
+
+만약 활성화 하고 있지 않았다면 virtualenv를 활성화하고 실행해요 (PythonAnywhere 는`workon` 명령을 사용해요, 내 컴퓨터에서 쓰던 `source myenv/bin/activate`명령과 같아요.):
+
+{% filename %}PythonAnywhere 명령줄{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+`manage.py collectstatic` 명령은 `manage.py migrate`와 같아요. 코드를 변경하고 장고에게 서버의 정적 파일 모음이나 데이터베이스에 이러한 변경사항을 *적용*하도록 지시할거에요.
+
+어쨌든, 이제 콘솔 오른쪽 상단에 있는 메뉴 버튼에서 ["Web" page](https://www.pythonanywhere.com/web_app_setup/)로 이동해서 **Reload**를 누른 다음 https://subdomain.pythonanywhere.com 페이지를 확인하여 결과를 확인할 수 있어요.
+
+이제 완료 되었어요. 축하합니다. :)
\ No newline at end of file
diff --git a/ko-KR/how_the_internet_works/README.md b/ko-KR/how_the_internet_works/README.md
new file mode 100644
index 00000000000..f674d6a0362
--- /dev/null
+++ b/ko-KR/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# 인터넷은 어떻게 작동할까요
+
+> 집에서 공부하시는 분은: 이번 챕터에서 [인터넷은 어떻게 작동할까요](https://www.youtube.com/watch?v=oM9yAA09wdc) 영상을 참고하세요.
+> 
+> 이 챕터는 Jessica McKellar의 "인터넷은 어떻게 작동할까요"(http://web.mit.edu/jesstess/www/)에 영감을 받아 작성되었습니다.
+
+당신은 매일 인터넷을 사용하실거에요. 하지만 당신이 브라우저 주소창에 https://djangogirls.org 를 입력하고 `enter` 키를 누르면 어떤 일이 일어나는지 확실히 알고 있나요?
+
+먼저 웹사이트는 여러분의 영화, 음악 또는 사진과 같이 하드디스크에 저장된 파일로 이루어져 있다는 점을 이해할 필요가 있습니다. 하지만 다른 한가지는, 웹사이트는 HTML라 불리는 컴퓨터 코드가 포함되어 있다는 것이에요.
+
+만약 프로그래밍에 익숙하지 않다면, HTML을 이해하는 게 어려울 수도 있어요. 하지만 브라우저들(크롬, 사파리, 파이어폭스 같은 것들요)은 HTML을 사랑한답니다. 웹 브라우저는 코드를 이해하고 지시에 따르고, 내가 원하는 방식으로 정확하게 구현될 수 있도록 설계되었어요.
+
+다른 파일처럼 HTML 파일도 하드 디스크 어딘가에 저장해야합니다. 인터넷에선 *서버*라는 특별하고 강력한 컴퓨터를 사용해요. 데이터를 저장하고 제공하는 것이 주된 목적이기 때문에 모니터나 마우스, 키보드가 필요없지요. 데이터를 *제공(serve)* 하기때문에 – *서버(servers)* 라고 부릅니다.
+
+좋아요, 하지만 인터넷이 어떻게 생겼는지도 알고 싶지 않나요?
+
+그림을 그려봤습니다. 이렇게 생겼어요:
+
+![그림 1.1](images/internet_1.png)
+
+조금 지저분해 보이죠? 사실 인터넷은 수 많은 기계(앞서 얘기한 *서버*라는)들을 연결한 하나의 네트워크랍니다. 수백, 수천 대의 기계들이요! 긴, 아주 긴 케이블들이 지구 전체를 둘러싸고 있답니다! 해저 케이블 지도 사이트 (http://submarinecablemap.com/)에 가보면 케이블이 얼마나 복잡하게 연결되어있는지 알 수 있어요. 아래 사진은 웹사이트에서 가져온 스크린 샷입니다.
+
+![그림 1.2](images/internet_3.png)
+
+멋지지 않나요? 그렇지만 인터넷에 연결된 모든 기계를 선으로 연결하는 것은 불가능해요. 그래서 어떤 기계(예를 들어 https://djangogirls.org 이 저장되어 있는 것 같은)에 도달하기 위해서는 수없이 많은 다른 기계들을 통과해야 한답니다.
+
+그림으로 보면 다음과 같습니다.
+
+![그림 1.3](images/internet_2.png)
+
+주소창에 https://djangogirls.org 을 입력하는 것을, "사랑하는 장고 걸즈 여러분, 저는 장고걸즈 웹사이트를 보고 싶어요. 저에게 그 웹 사이트를 보여주세요!"라고 편지를 써서 보내는 것과 같다고 생각해 보세요.
+
+이 편지는 여러분과 가장 가까이에 있는 동네 우체국으로 갈거에요. 그리고 편지는 주소지에 최종적으로 배달될때까지 받을 사람에게 조금 더 가까운 다른 우체국으로, 그리고 또 다른 우체국으로 계속 전달되게 됩니다. 편지와 다른 한가지는 같은 장소에서 많은 양의 편지(*데이터 패킷*)을 보내면, 각기 다른 우체국(*라우터*) 을 통해 전달될 수 있다는 것입니다. 또 우체국마다 배포되는 방법이 달라요.
+
+![그림 1.4](images/internet_4.png)
+
+맞아요, 간단해요. 메시지를 보내고 답장을 기다리는 거죠. 물론 종이랑 펜 대신 몇 바이트의 데이터를 사용하는 것이지만, 기본 개념은 같답니다!
+
+도로명과 도시이름, 우편번호를 쓰는 대신 IP주소라는 것을 써야 하지만요. 여러분의 컴퓨터는 먼저 DNS(도메인 주소 시스템)에게 djangogirls.org 의 IP주소가 뭔지를 물어봅니다. 옛날 전화번호부 책에서 연락하고 싶은 대상의 이름으로 전화번호와 주소를 찾아내는 방법과 비슷하지요.
+
+여러분이 편지를 보낼 때는 몇가지 규칙을 지켜야 제대로 배달되지요? 주소가 적혀있어야 하고, 우표가 있어야 해요. 수령인이 이해할 수 있는 언어로 적혀져야하구요. 그렇죠? 여러분이 웹사이트를 찾기 위해 보낸 *데이터 패킷*에도 이러한 규칙들이 적용되어야 해요. 우리는 HTTP (하이퍼텍스트 전송 프로토콜) 라 불리는 프로토콜을 사용합니다.
+
+따라서 기본적으로 웹사이트를 만들려면 그 웹사이트가 동작할 *서버* (기계) 가 필요해요. *서버*에서 *요청*(편지) 을 받으면, 다시 웹사이트(다른 편지) 로 되돌려줍니다.
+
+장고 튜토리얼을 시작할 때부터, 장고가 무슨 일을 하는지 궁금하셨죠? 여러분이 답장을 보낼 때, 모든 사람에게 항상 동일한 내용을 보내고 싶지 않을 거에요. 받는 사람에 따라 각각 다른 답장을 보내면 더 좋지 않을까요? 이와 같이 장고는 맞춤형 편지를 보낼 수 있도록 도와준답니다. :)
+
+이제 수다는 그만하고– 뭔가 만들어볼까요!
\ No newline at end of file
diff --git a/ko-KR/html/README.md b/ko-KR/html/README.md
new file mode 100644
index 00000000000..8b2ceef9b2a
--- /dev/null
+++ b/ko-KR/html/README.md
@@ -0,0 +1,227 @@
+# HTML 시작하기
+
+템플릿이 무엇인지 궁금하셨죠?
+
+템플릿이란 서로 다른 정보를 일정한 형태로 표시하기 위해 재사용 가능한 파일이예요. 예를 들면 편지를 쓸때도 템플릿을 사용할 수 있어요. 편지의 내용이나 수신인 주소는 달라져도 동일한 디자인, 레이아웃을 사용하는 경우가 있으니까요.
+
+장고의 템플릿 양식은 HTML을 사용합니다. (HTML은 첫 번째 장 **인터넷은 어떻게 작동할까요**에서 들어봤죠).
+
+## HTML이란 무엇일까요?
+
+HTML은 크롬이나 파이어폭스, 사파리같은 웹브라우저가 해석할 수 있는 간단한 코드예요. 사용자에게 웹페이지를 표시할 때 사용해요.
+
+HTML은 "HyperText Markup Language"의 줄인 말입니다. **하이퍼텍스트(HyperText)** 는 텍스트인데 페이지간에 하이퍼링크를 담을 수 있다는 뜻이예요. **마크업(Markup)**이란 누군가에게(여기서는 브라우저) 문서를 해석하는 방법을 표시(mark)를 했다는 뜻이에요. HTML 코드는 **태그(tag)**들로 이루어져있어요. 태그는 `<` 로 시작하고 `>`로 끝나요. 이런 태그들은 마크업 **요소(elements)**를 나타냅니다.
+
+## 첫번째 템플릿!
+
+템플릿을 만드는 것은 템플릿 파일을 만든다는 뜻이예요. 모든 것은 파일에 저장되겠죠? 이미 눈치챘을 것 같군요.
+
+템플릿은 `blog/templates/blog` 디렉토리에 저장됩니다. 그러니까 먼저 블로그 디렉토리에 `templates` 디렉토리를 생성해야해요. 그리고, 템플릿 디렉토리에 `blog` 라는 디렉토리를 만드세요.
+
+    blog
+    └───templates
+        └───blog
+    
+
+(왜 `blog` 디렉토리를 하나 더 만들어야하는지 궁금할 거에요. 나중에 알게 되겠지만, 작업이 좀더 복잡해질 때 편하게 만들기 위해 사용하는 관습같은 거에요.)
+
+다음 `blog/templates/blog` 디렉토리에 `post_list.html` (비어있는) 파일을 만드세요.
+
+웹사이트를 확인해보세요. : http://127.0.0.1:8000/
+
+> 여전히 `TemplateDoesNotExists`에러가 나온다면, 웹 서버를 다시 시작하세요. 명령창으로 가서 Ctrl + C를 눌러 웹 서버 작동을 멈춥니다. 그런 후 다시 `python manage.py runserver` 명령을 실행해 서버를 재시작합니다.
+
+![그림 11.1](images/step1.png)
+
+이제 에러가 사라졌어요! 축하합니다. :) 하지만 웹사이트가 비어있어 아무 내용도 보여지지 않네요. 이제 고쳐나가 봅시다.
+
+코드 편집기로 새 파일을 열어서 다음내용을 추가해요:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+웹 사이트가 어떻게 보이나요? 방문해서 확인해보세요: http://127.0.0.1:8000/
+
+![그림 11.2](images/step3.png)
+
+잘 작동하네요! 잘 했습니다. :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head 와 Body
+
+각 HTML 페이지는 두 가지 요소, **head**와 **body**로 구분됩니다.
+
+* **head**는 문서에 대한 정보를 담고 있지만 이 정보는 화면에 직접적으로 보여지 않습니다.
+
+* **body**는 웹사이트에 보여지는 모든 내용을 담고 있습니다.
+
+`<head>`는 브라우저에 페이지에 대한 설정들을 알려주고, `<body>`는 실제 페이지에 보여줄 내용을 알려줍니다.
+
+그 예로, `<head>` 안에 웹페이지의 제목을 넣어봅시다. :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+파일을 저장하고 페이지를 새로고침 해보세요.
+
+![그림 11.3](images/step4.png)
+
+브라우저가 어떻게 "Ola's blog"를 웹 페이지의 제목으로 이해했을까요? 바로 브라우저가 `<title>Ola's blog</title>`를 해석해 브라우저 제목 표시줄에 내용을 반영한 것입니다. (북마크를 할 때도 이렇게 사용됩니다.)
+
+태그는 `/`로*태그 마침*하고 *중첩(nested)*해서 사용할 수 있습니다. (모든 태그가 닫힐 때까지 특정 태그 하나만 닫을 수 없습니다.)
+
+이 개념은 박스에 뭔가 집어 넣는 것과 같아요. 여러분에게 `<html></html>`라고 하는 큰 박스가 있습니다. 박스 안에는 `<body></body>` 박스가 있고, 또 그 박스 안에는 `<p></p>`라는 더 작은 박스들이 있는 것이죠.
+
+*태그 마침*과 *중첩*의 규칙을 잘 따라야 해요. 그렇지 않으면, 브라우저가 해석을 할 수 없어, 페이지가 원하는 모습으로 나오지 않게 됩니다.
+
+## 맞춤형 템플릿 만들기
+
+여러분은 이제 좀 더 재밌어질 것입니다. 여러분만의 템플릿을 만들어봅시다! 여기 몇 가지 유용한 태그들이 있습니다:
+
+* `<h1>A heading</h1>` - 가장 중요한 머리말에 사용하는 태그
+* `<h2>A sub-heading</h2>` 그 다음 수준의 머리말에 사용하는 태그
+* `<h3>A sub-sub-heading</h3>` ... 그 다음 머리말.. `<h6>` 까지 계속 수준이 낮아집니다.
+* `<p>텍스트 단락 입니다.</p>`
+* `<em>text</em>` 텍스트를 강조할 때 사용하는 태그
+* `<strong>text</strong>` 여러분의 텍스트를 강력하게 강조할 때 사용하는 태그
+* `<br>` 개행. 행을 내누기(br 태그 안에는 속성으로 아무 것도 넣을 수 없습니다.)
+* `<a href="https://djangogirls.org">link</a>` 링크 걸기
+* `<ul><li>first item</li><li>second item</li></ul>` 목록을 만듭니다. 지금 여러분이 보고 있는 목록처럼요!
+* `<div></div>` 페이지의 섹션을 정의합니다.
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+여기 템플렛 예제가 있어요, `blog/templates/blog/post_list.html`에 붙여넣으세요:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+이 태그들로 이렇게 변합니다. :
+
+![그림 11.4](images/step6.png)
+
+야호! 지금까지 만든 우리 템플릿은 계속 **같은 내용**만 보여주었죠. 그러나 앞에서 템플릿은 **같은 양식**을 사용하지만 **다른** 정보들을 보여줄 때 사용한다고 말했었죠.
+
+장고 관리자에서 실제 추가한 글들을 보여주는 방법은 앞으로 배우게 될 거에요.
+
+## 하나 더: 배포하기!
+
+방금 작업했던 것이 인터넷에서도 볼 수 있으면 좋겠죠? PythonAnywhere으로도 배포해 봅시다. :
+
+### Github에 코드를 커밋, 푸시하세요!
+
+제일 먼저, 마지막 배포 이후 수정된 파일을 확인해 봅시다. (PythonAnywhere가 아닌 로컬에서 실행하세요) :
+
+{% filename %}명령줄{% endfilename %}
+
+    $ git status
+    
+
+`djangogirls` 디렉토리에서 `git`에게 현재 폴더에 있는 모든 변경 내용을 포함라고 말합니다.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+파일 업로드 전, `git`으로 업로드 할 파일들을 확인해봅시다. (`git`에서 업로드 할 모든 파일들이 녹색으로 나타나야 합니다.) :
+
+{% filename %}명령줄{% endfilename %}
+
+    $ git status
+    
+
+거의 다 왔습니다. 이제 저장소에 변경 사항을 저장할 단계예요. 우리는 "커밋 메시지(commit message)"를 주어, 어떤 것이 수정 변경되었는지 알려줄 거에요. 이번에는 아무거나 적어도 괜찮습니다. 하지만 앞으로는 내가 수정한 내용을 간략하게 적어 다음에 기억할 수 있도록 하는 것이 좋을 거에요.
+
+{% filename %}명령줄{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **주의** 커밋 메시지는 쌍따옴표(")로 감싸주세요.
+
+완성되면, Github으로 업로드(푸쉬) 하세요. :
+
+{% filename %}명령줄{% endfilename %}
+
+    $ git push
+    
+
+### PythonAnywhere에서 새 코드를 가져와, 웹 앱을 다시 불러옵니다.
+
+* [PythonAnywhere 콘솔 페이지](https://www.pythonanywhere.com/consoles/)를 열고 **배시 콘솔** (또는 새로운 창)을 준비합니다. 그 다음, 명령어를 입력합니다. :
+
+{% filename %}PythonAnywhere 명령줄{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(당신의 PythonAnywhere 서브 도메인을 `<your-pythonanywhere-domain>`에 화살괄호 없이 입력하는것을 잊지마세요) 서브도메인은 PythonAnywhere 의 사용자명과 같아요, 그러나 간혹 다를 수도 있어요.(이름이 대문자를 포함하는 경우와 같이 말이죠). 만약 명령이 작동안하면, `ls` (파일 목록) 명령을 통해 실제 서브도메인/폴더명을 확인하고, `cd` 명령으로 이동해요.
+
+다운로드된 코드를 보아요. 반영되었는지 확인하려면 **"파일" 페이지**로 이동하여 PythonAnywhere에서 코드를 볼 수 있어요(콘솔 페이지의 메뉴 버튼에서 다른 PythonAnywhere 페이지에 연결할 수도 있어요).
+
+* 마지막으로 ["웹" 페이지("Web" page)](https://www.pythonanywhere.com/web_app_setup/)으로 가서 여러분의 웹 앱을 **다시 불러오기(Reload)**를 하세요.
+
+인터넷에도 업데이트 되었네요! 브라우저로 가서 웹사이트를 새로고침하세요. 변경한 내용들이 보일 거에요. :)
\ No newline at end of file
diff --git a/ko-KR/installation/README.md b/ko-KR/installation/README.md
new file mode 100644
index 00000000000..8ee05437a85
--- /dev/null
+++ b/ko-KR/installation/README.md
@@ -0,0 +1,68 @@
+# 집에서 이 튜토리얼을 보는 분들에게
+
+[Django 걸스 이벤트](https://djangogirls.org/events/)가 아닌 집에서 튜토리얼을 따라하시는 분들은 이 챕터를 넘기고 [인터넷은 어떻게 작동할까요?](../how_the_internet_works/README.md) 로 바로 넘어가세요.
+
+이 챕터는 (워크샵에 사용하기 유용하도록) 튜토리얼에서 필요한 모든 프로그램의 설치 안내를 한곳에 모은 추가적인 페이지입니다. 만일 원하신다면 이 페이지에 있는 모든 것을 인스톨 하실수도 있고, 컴퓨터에 이것저것 설치하기 전에, 먼저 학습을 시작하고 싶다면 이번 장을 건너뛰셔도 됩니다. 뒷 부분에서도 설치에 대한 내용을 다루게 될 거에요.
+
+모두 행운을 빌어요!
+
+# 만일 워크샵에 참석하신 분이라면
+
+[Django 걸스 이벤트](https://djangogirls.org/events/)에 참석 중이신 분이라면:
+
+* 여러분의 워크샵은 메인행사 전에 "Installation 행사"를 가질거에요. 여러분이 installation 파티에 계신다면, 바로 찾아오셨네요! 필요한 경우 코치의 도움을 받아 워크샵 설치에 필요한 모든 내용을 얻으려면 이곳의 안내를 따라요. 그런 다음 메인 워크샵에서 기본 튜토리얼에서 볼 수 있는 설치 지침을 건너뛸 수 있어요.
+* 워크샵 주체자들은 워크샵을 시작하기에 앞서 당신에게 집에서 모든것들을 설치해보도록 요청했을 수 있어요. 만약 이러한것들을 요청받았다면, 이 페이지는 당신을 위한거에요! 당신이 할 수 있는 최대한 이곳의 지침을 따르세요. 그런 다음 메인 워크샵에서 메인 튜토리얼의 설치 단계를 진행할때, 설치할 수 없는 경우 코치의 도움을 받을 수 있습니다.
+* 워크샵에 설치 파티가 없고(또는 참석할 수 없는 경우) 주체자가 당신에게 도착하기 전에 모든 설치를 시도하도록 요청하지 않은 경우, 이 페이지를 건너뛰고 [인터넷 작동 방식](../how_the_internet_works/README.md) 장으로 바로 이동해요. 튜토리얼을 통해 필요한 모든것을 설치할 수 있을거에요.
+
+# 설치하기
+
+이 튜토리얼에서 우리는 블로그를 만들어 볼 거에요. 이를 위해 튜토리얼을 진행하는 동안 컴퓨터에 다양한 소프트웨어를 설치하고 필요에 따라 일부 온라인 계정을 설정하는 방법에 대해 설명해요. 이 페이지는 설치와 회원가입 절차를 한 곳(일부 워크샵형식에 가장 유용한)에 모아놨어요.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# 커맨드라인에 대한 간단한 소개 {#command-line}
+
+"콘솔", "터미널", "명령창", 혹은 "명령줄" -- 이것들은 같은것을 의미해요: 명력을 입력할 수 있는 당신의 컴퓨터의 창이에요. 메인 튜토리얼을 진행시, 명령줄에 대해 더 많이 배우게 될거에요. 지금은, 우선 어떻게 명령줄을 열고 어떻게 보이는지에 대해 알아야해요: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Python 설치하기 {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Code Editor 설치하기 {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# virtualenv 설정 & Django 설치하기 {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Git 설치하기 {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+[GitHub.com](https://www.github.com) 에 접속해서 무료계정으로 회원가입을 해요. 비밀번호를 잊어먹지 마세요. (비밀번호 관리자를 쓰고있다면 추가해 두세요).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# 읽기 시작
+
+축하합니다. 드디어 여러분은 시작할 준비가 되었답니다! 워크샵 사전에 튜토리얼 앞 부분을 미리 읽어두면 도움이 될 거에요:
+
+* [인터넷은 어떻게 작동할까요?](../how_the_internet_works/README.md)
+
+* [커맨드라인(command line) 시작하기](../intro_to_command_line/README.md)
+
+* [파이썬(python) 시작하기](../python_introduction/README.md)
+
+* [Django란 무엇일까요?](../django/README.md)
+
+# 워크샵을 즐기세요!
+
+워크샵이 시작하면, 앞의 내용은 이미 다 이해했다고 생각하고 [나의 첫 번째 Django 프로젝트!](../django_start_project/README.md)로 넘어가세요.
\ No newline at end of file
diff --git a/ko-KR/intro_to_command_line/README.md b/ko-KR/intro_to_command_line/README.md
new file mode 100644
index 00000000000..7756d2cbce5
--- /dev/null
+++ b/ko-KR/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# 커맨드라인 시작하기
+
+> 집에서 공부하시는 분은: [새 친구: 커맨드라인](https://www.youtube.com/watch?v=jvZLWhkzX-8)영상을 참고하세요.
+
+재미있을 것 같지 않아요? 몇분 내로 여러분은 코딩의 첫 줄을 쓸 수 있어요! :)
+
+**여러분의 첫 번째 친구를 소개합니다: 바로, 커맨드라인(command line) 입니다!**
+
+해커들이 사용하는 까만 윈도우 창을 어떻게 사용하는지 보여드릴 거에요. 처음에는 약간 무서워 보일 수도 있지만, 이녀석은 그저 여러분의 명령을 기다리는 메시지창일 뿐이에요!
+
+> **참고** 이 설명서에서 '디렉토리'와 '폴더'라는 두가지 단어를 사용하지만 둘다 같은 뜻이랍니다.
+
+## 커맨드라인은 무엇일까요?
+
+흔히 **커맨드라인(command line)** 또는 **커맨드라인 대화창(command-line interface)**이라고도 불리는 이 윈도우는 컴퓨터에서의 파일을 보고, 처리하고, 조작하기 위한 텍스트 기반 응용 프로그램입니다. 그래픽 인터페이스가 없는 윈도우 익스플로러나 Mac의 Finder라고 봐도 되요. 커맨드라인은 *cmd*, *CLI*, *프롬프트(prompt)*, *콘솔(console)* 혹은 *터미널(terminal)*로 부르기도 해요.
+
+## 커맨드라인 열기
+
+몇가지 실험을 시작하기 전에 먼저 여러분의 커맨드라인 창을 열어봅시다.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## 프롬프트
+
+하얀색 혹은 까만색 배경 윈도우가 여러분의 명령을 기다리고 있는 것을 보실 수 있을 거에요
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+맥이나 리눅스의 경우, 아래와 같은 `$` 기호가 보일 거예요:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+윈도우에서는 아래와 같은 `>` 기호가 보일 거에요:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+바로 위의 Linux 섹션을 살펴보세요. PythonAnywhere에 접속하면 이 튜토리얼과 비슷한 내용을 볼 수 있습니다.
+
+<!--endsec-->
+
+각 명령은 `$` 또는 `>` 그리고 한 개의 공백이 앞에 붙어요, 하지만 그것은 입력하면 안되요. 컴퓨터가 당신을 위해 알아서 넣어줄 거랍니다.
+
+> 잠깐만요: 상황에 따라 프롬트 기호 앞에 `C:\Users\ola>` 혹은 `Olas-MacBook-Air:~ ola$` 같은 것이 보일 수 있는데, 그건 문제가 있는게 아니라 아주 잘 동작하는 거랍니다.
+
+`$` 또는 `>` 포함 부분 짧게 *명령줄 프롬프트* 또는 *프롬프트*라고 합니다. 뭔가 입력하라는 표시입니다.
+
+이 튜토리얼을 따라하면서, 커맨드 라인에 명령어를 입력할 때마다 왼쪽에 `$` 또는 `>`표시가 보일 거에요. 프롬프트를 실행하고 나서 왼쪽 표시 부분을 무시하고 명령어를 바로 입력하면 됩니다.
+
+## 나의 첫 번째 명령 (야호!)
+
+이 명령어를 입력하는 것부터 시작해보죠!
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+그리고 `Enter`를 누르세요. 다음과 같이 보일 거에요.
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami 
+    olasitarska
+    
+
+컴퓨터가 여러분 컴퓨터 사용자이름을 보여주네요. 괜찮지 않아요? :) 
+
+> 복사해서 붙여넣기 하지 말고, 직접 입력해 보세요. 더 잘 외워질 거예요!
+
+## 기본 명령어
+
+각각의 운영체제에 따라, 명령어들이 조금씩 다를 수도 있으니까, 여러분의 운영체제에 해당하는 설명을 따라주세요. 그럼 같이 해볼까요?
+
+### 현재 디렉토리
+
+우리가 지금 어느 폴더에 있는지 알면 좋겠죠? 아래의 명렁을 입력하고 `Enter`를 눌러보세요:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> 참고: 'pwd' 는 'print working directory(작업중인 디렉토리 출력)'의 줄임말이에요.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd 
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+위와 비슷한 결과가 출력되었을 거예요. 커맨드라인을 열면, 항상 여러분의 '사용자 홈 디렉토리' 에서 시작하게 됩니다
+
+* * *
+
+### 명령에 대해 더 배워보기
+
+명령창에 내장된 입력할 수 있는 많은 명령들은 표시하고 읽을 수 있는 많은 도움말이 내장되어 있어요. 예를 들어, 현재 디렉토리 명령에 대해 배워보아요:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X 와 Linux 는 `man` 이라는 명령어가 도움을 줄거에요. `man pwd` 입력하고 어떻게 나오는지 보아요, 혹은 다른명령어 앞에 `man` 을 붙여 입력하면 해당명령어의 도움말을 볼 수 있어요. `man` 은 보통 페이징되어있어요. 스페이스바를 눌러 다음 장으로 이동하고 `q` 를 눌러 도움말을 종료할 수 있어요.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+명령어에 `/?` 접미사를 붙여 도움말을 출력할 수 있어요. 아마 띄워진 화면을 스크롤 해야할 거에요. `cd /?`를 시도해 보세요.
+
+<!--endsec-->
+
+### 파일과 디렉토리 목록 보기
+
+여기에는 뭐가 있는지 알아낼 수 있다면 좋겠지요? 그럼 같이 해봐요.
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    $ ls 
+    Applications 
+    Desktop 
+    Downloads 
+    Music 
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### 현재 디렉토리 변경
+
+자, 바탕화면 디렉토리로 가볼까요:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    $ cd Desktop
+    
+
+"Desktop" 이라는 디렉토리명은 당신의 Linux계정의 언어 설정에 따라 번역되어있을 수 있으니 주의하세요. 이런경우 `Desktop`을 번역된 이름으로 바꾸어야 해요. 예를 들어, 독일어의 경우 `Schreibtisch` 이에요.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+정말 변경되었는지 볼까요:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+맞군요!
+
+> 전문가 팁: `cd D`까지 입력하고 `tab`(탭) 키를 누르면, 커맨드라인이 자동으로 나머지 부분을 완성해 주기 때문에, 시간을 절약할 수 있어요. "D"로 시작하는 폴더가 2개 이상일 경우, `tab`(탭) 키를 두 번 누르면, 해당하는 폴더들을 다 보여줍니다.
+
+* * *
+
+### 새 디렉토리 만들기
+
+바탕 화면에 연습 디렉터리를 만들어 볼까요? 이렇게 하면 돼요:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+이 간단한 명령어가, 바탕화면에 `practice` 라는 이름의 폴더를 만들어 줍니다. 바탕화면에서 직접 보거나, 명령어 `ls` 혹은 `dir`을 실행해서 확인할 수 있어요! 한 번 해보세요. :)
+
+> 전문가 팁: 같은 명령어를 여러 번 반복해서 입력하고 싶지 않다면, 키보드의 `위 화살표`와 `아래 화살표`를 눌러서 최근 사용한 명령어들을 볼 수 있어요.
+
+* * *
+
+### 연습문제!
+
+작은 도전 과제를 드릴게요: 새로 만든 `practice` 디렉토리 안에 `test` 라는 이름의 디렉토리를 만들어 보세요. 명령어 `cd` 와 `mkdir`을 사용하세요. 
+
+#### 답:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### 정리
+
+어지럽힌 흔적은 남기고 싶지 않지요, 지금까지 한 것들을 모두 지워봅시다!
+
+우선, 바탕화면으로 돌아가야해요.
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+`..`과 `cd` 명령은 현재 디렉토리에서 (현재 디렉토리보다 한수준 위인) 부모 디렉토리로 보내줄겁니다. 
+
+현재 위치를 확인해 보세요:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+이제 `practice` 디렉토리를 삭제할시간이에요:
+
+> **주의**: `del`, `rmdir` 혹은 `rm` 을 사용하여 파일을 지울 경우, 복구할 수가 없습니다, *지워진 파일들을 영원히 사라지게 됩니다*! 그러니, 이 명령어들은 주의해서 사용하세요.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+완료! 실제로 삭제되었는지, 확인해 봅시다:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}명령줄{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### 종료
+
+여기까지입니다! 이제 안전하게 커맨드라인을 닫아볼게요. 해커 스타일로 해 보죠, 어때요? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+멋지죠? :)
+
+## 요역
+
+유용한 명령어들을 모아봤어요:
+
+| 명령어(윈도우)       | 명령어(맥 OS/리눅스) | 설명                  | 예시                                                 |
+| -------------- | ------------- | ------------------- | -------------------------------------------------- |
+| exit           | exit          | 창을 닫는다              | **exit**                                           |
+| cd             | cd            | 디렉토리를 변경한다          | **cd test**                                        |
+| cd             | pwd           | 현재 디렉토리를 보여준다       | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir            | ls            | 디렉토리 혹은 파일 목록을 보여준다 | **dir**                                            |
+| copy           | cp            | 파일을 복사한다            | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move           | mv            | 파일을 이동한다            | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir          | mkdir         | 새 디렉토리를 만든다         | **mkdir testdirectory**                            |
+| rmdir (or del) | rm            | 파일을 지운다             | **del c:\test\test.txt**                         |
+| rmdir /S       | rm -r         | 디렉토리를 지운다           | **rm -r testdirectory**                            |
+| [CMD] /?       | man [CMD]     | 명령에 대한 도움말을 표시한다    | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+커맨드라인에서 실행할 수 있는 명령어들 중에 아주 일부만 소개했지만, 오늘은 이정도만 알아도 충분할 거에요. 
+
+하지만 더 많은 명령어가 궁금하신 분은 [ss64.com](http://ss64.com)에서 모든 운영체제별로 정리된 명령어 모음집을 확인하실 수 있어요.
+
+## 준비되셨나요?
+
+이제 파이썬의 세계로 빠져봅시다!
\ No newline at end of file
diff --git a/ko-KR/intro_to_command_line/open_instructions.md b/ko-KR/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..b42f92453ca
--- /dev/null
+++ b/ko-KR/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+사용하고있는 Windows 버전에 따라서, 아래 명령어 중에 하나를 치면 명령 프롬프트가 실행될 것입니다 (실험해보고 싶을수도 있겠지만, 그렇다고 다 쳐볼 필요는 없습니다.)
+
+- 화면의 시작 메뉴를 누르고 검색창에 " 명령 프롬프트"를 입력하세요. 
+- 시작 메뉴 --> 시스템 설정 --> 명령 프롬프트 
+- 시작메뉴로 가서 → 모든 프로그램 → 보조프로그램 → 명령 프롬프트.
+- 시작화면으로 가서, 마우스를 좌측하단 구석에 올려놓으면 아랫방향 화살표가 나타나요(터치스크린에서는 화면 아래를 쓸어올리세요) 앱 페이지가 보일거에요. 윈도우 시스템 항목에서 명령창을 클릭해요
+- 윈도우키를 누른상태에서 "X"키를 눌러요. 팝업 메뉴에서 "명령 프롬프트"를 선택해요.
+- 윈도우키를 누른채 "R"키를 눌러 "실행" 창을 열어요. "cmd"를 입력하고, 확인 버튼을 눌러요.
+
+!["실행" 창에서 "cmd" 를 입력하세요.](../python_installation/images/windows-plus-r.png)
+
+튜토리얼의 뒷부분에서는 두개의 명령창을 동시에 열어야 할 거에요. 그러나, 일부 윈도우 버전에서는 이미 하나의 명령창을 열어 놓았다면, 두 번째 창을 열기위해 같은 방법을 시도하더라도, 이미 열려있는 창을 나타낼 수도 있어요. 당신의 컴퓨터에서는 어떤일이 일어나는지 시도해보세요. 하나의 명령창만 보인다면, 위의 다른 방식을 시도해보세요. 적어도 하나는 새로운 창을 열 수 있을거에요.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+응용 프로그램 → 유틸리티 → 터미널.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+모든프로그램 → 도구 → 터미널, 혹은 모든프로그램 → 시스템 → 터미널 에 있을거에요. 그러나 시스템에 다라 다를 수 있어요. 만약 여기와 다르다면, 구글에 찾아보세요. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ko-KR/python_installation/README.md b/ko-KR/python_installation/README.md
new file mode 100644
index 00000000000..75e0efc8bf6
--- /dev/null
+++ b/ko-KR/python_installation/README.md
@@ -0,0 +1,15 @@
+# 파이썬 시작하기
+
+여기까지 오셨군요!
+
+먼저 파이썬(Python) 이란 무엇인지부터 말씀드릴게요. 파이썬은 아주 인기있는 프로그래밍 언어로, 파이썬을 이용하면 웹사이트, 게임, 과학용 소프트웨어, 그래픽 소프트웨어 등을 만들 수 있답니다.
+
+파이썬은 1980년대 후반에 만들어졌어요. 기계 뿐만 아니라 인간도 읽을 수 있도록 만드는 것이 목적이었어요. 이것이 다른 컴퓨터 언어보다 더욱 간결한 이유입니다. 그러나 걱정하지 마세요 - 파이썬 또한 정말 강력하답니다.
+
+# 파이썬 설치하기
+
+> **참고** 만약 크롬북을 사용한다면, 이번 장을 생략하고 [크롬 북 설정](../chromebook_setup/README.md)을 정확하게 따르세요.
+> 
+> **참고** 이미 [설치 단계](../installation/README.md)를 거쳤다면, 이 부분을 다시 하실 필요는 없습니다 - 바로 다음 장으로 넘어 가세요!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ko-KR/python_installation/instructions.md b/ko-KR/python_installation/instructions.md
new file mode 100644
index 00000000000..e70a077af96
--- /dev/null
+++ b/ko-KR/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> 집에서 학습하시는 분을 위해: 이번 장은 [파이썬 및 코드 편집기 설치 ](https://www.youtube.com/watch?v=pVTaqzKZCdA)비디오를 이용해 다룰 거에요.
+> 
+> 위 내용은 Geek Girls Carrots (http://django.carrots.pl)을 바탕으로 작성되었습니다.
+
+장고는 파이썬으로 만들어졌습니다. 장고로 무언가를 해보려면 파이썬이 있어야합니다. 우선 설치부터 해볼까요! 우리는 파이썬 3를 사용할 거예요. 그보다 낮은 버전을 사용하고 있다면, 업그레이드해야 합니다. {{ book.py_min_version }} 버전이나 높은 버전을 가지고 있다면 괜찮아요.
+
+Anaconda가 컴퓨터에 이미 설치되어 있더라도, 아래와같이 일반 파이썬을 설치해주세요.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+먼저 "시스템 종류" 시스템 정보 페이지를 통해 컴퓨터의 윈도우가 32비트 버전인지 64비트 버전인지 확인해 보아요. 아래 명령을 통해 페이지에 접근할 수 있어요:
+
+* 윈도우키와 Pasue/Break 키를 동시에 눌러요
+* 윈도우 메뉴에 제어판을 열어요, 그리고 시스템 및 보안의 시스템으로 이동해요.
+* 윈도우 버튼을 누르고, 설정 > 시스템 > 정보 를 클릭해요
+* 윈도우 시작메뉴에서 "시스템 정보"를 검색해요. 이를 위해서, 시작 버튼을 누르거나 윈도우 키를 누르고, `시스템 정보`를 입력해요. 당신이 입력한것에 따른 추천제안을 보여줘요. 보여진 것중에 선택할 수 있답니다.
+
+윈도우용 파이썬은 https://www.python.org/downloads/windows/ 에서 다운로드 받을 수 있어요. "Latest Python 3 Release - Python x.x.x" 링크를 클릭해요. 만약 당신의 컴퓨터의 윈도우가 **64-bit**라면 **Windows x86-64 executable installer**를 다운로드 해요. 아닐경우 **Windows x86 executable installer**를 다운로드 해요. 설치파일을 파일을 다운로드 받고나서, 실행(더블클릭으로)한 다음, 지시사항을 따라하세요.
+
+설치를 진행하기 시작하면 "Setup"이라고 적혀진 창을 발견 할 수 있을거에요. 여기 보이는것처럼 "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" 에 체크가 되어있는지 확인하고 "Install Now"를 클릭하세요.(설치되는 버전에 따라 조금 다르게 보일 수 있어요):
+
+![파이썬을 패쓰 (path)에 추가하는 것을 잊지 마세요.](../python_installation/images/python-installation-options.png)
+
+설치가 완료되면 파이썬 혹은 설치된 버전에 대한 정보를 알아볼 수 있는 링크가 표시된 안내창이 보입니다. 해당 창을 Close 혹은 cancel 하세요 - 당신은 이 튜토리얼에서 더 배우게 될거에요.
+
+주의: 만약 오래된 윈도우(7, 비스타, 혹은 더 오래된 버전)를 사용하고 있다면 파이썬 {{ book.py_version }} 인스톨러가 실페 에러를 나타낼 거에요, 그러면 윈도우 업데이트를 설치하고 파이썬 설치를 다시 해보세요. 만약 계속 에러를 나타낸다면, [Python.org](https://www.python.org/downloads/windows/)에서 파이썬 {{ book.py_min_release }} 버전을 설치해 보세요.
+
+> 장고 {{ book.django_version }}는 Windows XP나 이전버전을 지원하지 않는 파이썬 {{ book.py_min_version }} 혹은 이상의 버전을 필요로해요
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **주의** OS X에 파이썬을 설치하기 전, 맥 설정이 앱스토어에서 받지않은 패키지가 설치될 수 있도록 허용되어 있는지 확인하세요. 시스템 설정(어플리케이션 폴더에 있어요), "보안 및 개인정보보호", 그리고 "일반" 탭으로 이동해요. "다음에서 다운로드한 앱 허용:"이 "Mac App Store"로 되어있다면, "Mac App Store 및 확인된 개발자" 로 변경해요.
+
+https://www.python.org/downloads/mac-osx/ 에서 파이썬 설치프로그램을 다운로드 받아야 합니다.
+
+* *Mac OS X 64-bit/32-bit installer* 파일을 다운 받으세요.
+* *python-{{ book.py_release }}-macosx10.9.pkg*을 더블 클릭해 설치 프로그램을 시작하세요. 
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+아마도 이미 파이썬이 설치되어있을 거에요. 설치되어있는지 (그리고 어떤 버전인지) 확인하려면, 콘솔을 열어서 다음 명령을 실행하세요.
+
+{% filename %}명령줄{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+만약 다른버전의 파이썬이 깔려 있다면, 최소 {{ book.py_min_version }} (예를 들어 {{ book.py_min_release }})이어야 해요, 그렇지 않다면 업그레이드 해요. 파이썬이 설치되어 있지 않다면, 혹은 다른 버전을 원한다면, 먼저 어떤 리눅스 배포판을 사용하고 있는지 아래 명령으로 확인해요:
+
+{% filename %}명령줄{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+그리고나서, 결과에 따라, 아래 섹션의 설치 가이드를 따라해보세요.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+콘솔에서 다음 명령을 실행하세요.
+
+{% filename %}명령줄{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+콘솔에서 다음 명령을 실행하세요.
+
+{% filename %}명령줄{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+만약 오래된 페도라 버전을 사용하고 있다면 `dnf`명령을 찾을 수 없을거에요. 그런 경우 `yum` 명령을 대신 사용해요.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+콘솔에서 다음 명령을 실행하세요.
+
+{% filename %}명령줄{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+명령창을 열고 `python3` 명령을 실행해서 잘 설치되었는지 확인하세요.
+
+{% filename %}명령줄{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+만약 {{ book.py_release }} 버전과 다르게 보일거에요 -- 이것은 당신이 설치한 버전과 일치해요.
+
+**주의:** 만약 윈도우에서 `python3` 를 찾을수 없다는 에러메시지가 발생하면, `python` (`3`을 제외하고)을 입력해보고 {{ book.py_min_version }} 버전 이상인지 확인하세요. 만약 계속 작동하지 않는다면, 새 명령창을 열고 시도해보세요; 파이썬 설치 이전에 실행된 명령창인 경우 간혹 발생한답니다.
+
+* * *
+
+더 알고 싶은 것이 있거나, 설치가 잘 되지 않고 어찌 해야할지 모르겠다면 코치를 불러주세요! 잘 설치 되지 않는 경우도 있을 수 있습니다. 그럴 때는 경험이 있는 분에게 도움을 구해보세요.
\ No newline at end of file
diff --git a/ko-KR/python_introduction/README.md b/ko-KR/python_introduction/README.md
new file mode 100644
index 00000000000..d240518a494
--- /dev/null
+++ b/ko-KR/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# 파이썬(python) 시작하기
+
+> 이번 장의 일부는 Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)의 튜토리얼을 바탕으로 작성되었습니다.
+
+자, 코드를 써 봅시다!
+
+## 파이썬 프롬프트 (Python prompt)
+
+> 집에서 공부하시는 분은: [파이썬 기초: 정수, 문자, 리스트, 변수, 에러](https://www.youtube.com/watch?v=MO63L4s-20U)영상을 참고하세요.
+
+Python으로 놀기 위해서는 *커맨드라인*을 열어야 합니다. [커맨드라인 시작하기](../intro_to_command_line/README.md)에서 배웠던 걸 기억하고 있겠지요?
+
+준비되었다면, 아래 내용을 잘 따라오세요.
+
+파이썬 콘솔을 실행해야합니다. 윈도우에서는 `python`을 입력하고 맥OS나 리눅스라면`python3`를 입력하고 `엔터`를 입력하세요.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## 나의 첫 번째 파이썬 명령!
+
+파이썬을 실행시키고 나면 프롬프트가 `>>>`로 바뀝니다. 이제부터는 파이썬 언어의 명령어들만 사용할 수 있다는 뜻이예요. `>>>`를 입력할 필요 없어요. 파이썬이 대신해 줄 테니까요.
+
+파이썬 콘솔에서 나가려면 `exit()` 을 입력하거나 윈도우에서는 `Ctrl + Z` 를 맥이나 리눅스에서는 `Ctrl + D`를 입력하면 됩니다. 그러면 `>>>` 는 사라질 거에요.
+
+지금은 우리는 파이썬 콘솔을 나가지 않을거에요. 우리는 더 배우길 원하거든요. 자 이제 `2 + 3` 라는 수학식을 입력하고 `enter`키를 누르세요.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> 2 + 3 
+5
+```
+
+잘했어요! 결과값이 어떻게 나왔나요? 파이썬은 수학을 알고 있어요! 다른 명령어를 넣어봅시다:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+2의 3제곱인 지수연산을 수행하기위해서 우리는 {% filename %}명령줄{% endfilename %} 입력할 거에요.
+
+```python
+>>> 2 ** 3
+8
+```
+
+조금 놀아봤다면 다시 여기로 돌아와주세요 :)
+
+보시다시피, 파이썬은 훌륭한 계산기랍니다. 그 밖에 여러분들이 할 수 있는 것들이 궁금하다면...
+
+## 문자열(String)
+
+이름도 다룰 수 있을까요? 따옴표로 이름을 감싸서 입력해보세요.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> "Ola" 
+'Ola'
+```
+
+처음으로 문자열을 만들었군요! 문자열은 컴퓨터가 처리할 수 있는 연속된 문자들을 말해요. 문자열은 반드시 시작과 끝이 같은 문자여야해요. 문자열은 작은 따옴표(`'`) 나 큰 따옴표(`"`) 로 감싸야 해요. (둘 간의 차이점은 없어요. 단지 하나로 감싸나 둘로 감싸나 차이일 뿐이에요.) 이 따옴표는 파이썬에게 안에 문자열이리 들어있다고 알려줍니다.
+
+문자열들은 줄줄이 사탕처럼 연결할 수 있어요. 이렇게요:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola" 
+'Hi there Ola'
+```
+
+문자열이랑 숫자를 곱할 수도 있어요.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> "Ola" * 3 
+'OlaOlaOla'
+```
+
+문자열 안에 작은 따옴표를 넣고 싶다면, 두 가지 방법이 있어요.
+
+큰 따옴표를 사용하는 방법과
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> "Runnin' down the hill" 
+"Runnin' down the hill"
+```
+
+백슬래시 (``) 기호를 이용하는 방법이예요.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill' 
+"Runnin' down the hill"
+```
+
+알겠나요? 이제 이름을 대문자로 만들어볼까요:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+방금 문자열에 `upper`이라는 **함수(function)**를 사용했어요! 함수 (`upper()` 같은 것)란 파이썬이 주어진 대상(`"Ola"`같은)에 대해 수행할 수 있는 일련의 명령을 말해요.
+
+내 이름의 총 글자의 수를 알고 싶을 때, 사용하는 **함수**도 있어요.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> len("Ola") 
+3
+```
+
+함수 호출 시, 어떤 함수는 문자열 뒤에 `.`를 붙이고, (`"Ola".upper()` 처럼), 또 어떤 함수는 함수 뒤에 문자열이 들어간 괄호를 붙이는지 궁금하셨죠? `upper()`와 같은 함수는 객체에 속하게 되어 해당 문자열에서만 수행되기 때문이죠. 이와 같은 경우, 함수를 **메서드(method)**라고 합니다. 그리고, `len()`과 같은 함수들은 특정한 대상에 속하지 않고 여러가지 객체를 대상으로 사용할 수 있습니다. 그래서 `len` 함수에 `"Ola"`를 매개 변수(parameter) 로 준 거예요.
+
+### 목차
+
+자, 문자열은 충분히 다루었어요. 지금까지 우리가 공부한 것들을 정리해봅시다:
+
+- **the prompt: 프롬프트** - 명령어(코드) 를 파이썬 프롬프트에 입력하면 파이썬이 응답합니다.
+- **numbers and strings: 숫자와 문자열** - 파이썬에서는 셈을 할 때는 숫자를 사용하고 글을 다룰 때는 문자열을 사용합니다.
+- **operators: 연산자** - 값들을 이용해서 새로운 값을 만들 때는 `+` 와 `*` 같은 연산자를 이용합니다.
+- **functions 함수** - `upper()` 나 `len ()` 처럼 대상에 명령을 수행합니다.
+
+지금까지 프로그래밍 언어의 기초에 대해 알아보았어요. 더 어려운 부분으로 넘어가도 괜찮겠죠? 그럼요!
+
+## 오류
+
+이제 새로운 것을 해볼 때에요. 이름의 글자 길이를 알아냈듯이 숫자의 길이도 알 수 있을까요? `len(304023)` 을 입력하고 `엔터`를 입력해보세요:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+첫 번째 에러가 나타났어요! 여기서 {{warning_icon}} 아이콘은 `이 코드는 여러분이 예상하는 대로 실행되지 않을 것입니다`를 의미합니다. 학습하는데 있어서 의도적인 실수를 만들어보는 것도 중요한 역할을 하기도 한답니다!
+
+"int"(정수)객체는 길이가 없기 때문이지요. 이제 어떻게 할 수 있을까요? 숫자(number)를 문자열(String)로 바꿔 쓸 수 있지 않을까요? 문자열은 길이를 갖고 있으니까요, 그렇죠?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+잘 되네요! 앞에서 우리는`len` 함수 내부에 `str` 함수를 사용했어요. `str` 함수는 모든 것을 문자열로 변환한답니다.
+
+- `str`함수는 대상을 **문자열**로 변환합니다
+- `int` 함수는 대상을 **정수**로 변환합니다.
+
+> 중요 : 우리는 숫자를 텍스트로 변환할 수는 있지만, 반드시 텍스트를 숫자로 변환할 수 있는건 아닙니다 - `int('hello')` 가 어떻게 될 것 같나요?
+
+## 변수
+
+변수는 프로그래밍에서 중요한 개념입니다. 변수란 어떤 것을 나중에도 사용할 수 있도록 이름을 붙인 것일 뿐 입니다. 프로그래머들은 이 변수를 데이터 저장하는데 사용하고, 작성한 코드를 다 기억할 필요없이 코드를 읽기 쉽게 하기 위해 사용하지요.
+
+`name`이라는 새로운 변수를 만들어봅시다:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+우리는 name 변수에 Ola를 입력했어요.
+
+여러분도 알겠지만, 프로그램은 이전에 수행한 것을 보여주지 않습니다. 그러면 실제 변수에 어떤 값이 들어있는지 알려면 어떻게 해야할까요? 간단하게 `name`를 입력하고 `엔터`를 입력하세요:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+야호! 여러분이 만든 첫 변수입니다 :)! 언제든지 여러분은 변수를 바꿀 수 있어요:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+또 함수 안에서 변수를 사용할 수 있습니다:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+멋지죠? 물론 변수는 무엇이든지 담을 수 있으니, 당연히 숫자도 가능하죠! 해봅시다:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+그런데 만약 잘못된 이름을 사용했다면 어떻게 될까요? 어떤 일이 일어날까요? 해봅시다!
+
+{% filename %}{{ warning_icon }} 명령줄{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+에러가 나타났네요! 보다시피, 파이썬에는 많은 종류의 오류들이 있습니다. 그 중 하나가 **NameError**입니다. 파이썬은 아직 정의하지 않은 변수를 사용하면 이 오류를 보여줍니다. 나중에 똑같은 오류를 보게 된다면, 이름에 오타가 없는지 확인해보세요.
+
+잠시동안 변수와 놀아봅시다. 그리고 어떤 것들을 할 수 있는지 살펴보아요!
+
+## print 함수
+
+해봅시다:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+`name`을 쳤을 때, 파이썬 해석기는 'name' 변수의 문자열 *표현(representatio)*으로 응답하는데, 그 모양은 작은 따옴표('') 로 둘러싸인 M-a-r-i-a 문자들 입니다. `print(name)`라고 치면, 파이썬은 화면에 따옴표 없이 더 깔끔한 변수를 "출력(print)"할 것입니다.
+
+나중에 보겠지만, `print()`는 함수 안에 있는 어떤 것을 출력하거나, 이를 여러 줄로 출력할 때 유용하게 사용됩니다.
+
+## 리스트 (List)
+
+문자열과 정수 외에, 파이썬은 객체 정렬 위한 여러 방법들이 있어요. 이제 **리스트**라고 불리는 녀석에 대해서 알아보기로 하겠습니다. 리스트를 이렇게 생각하시면 됩니다: 다른 객체들을 나열한 객체. :)
+
+이제 리스트를 만듭시다:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+네, 리스트가 비어있어요. 별로 유용해 보이지 않죠? 이제 로또 번호 목록을 만들어 봅시다. 매번 직접 우리가 반복하기는 귀찮으니, 리스트에 변수를 넣어봅시다:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+좋아요, 리스트를 만들었네요! 어떻게 쓰면 될까요? 목록에 수 많은 로또 번호가 있다고 생각해봅시다. 함수를 사용할 수 있는 아이디어가 떠올랐나요? 여러분들은 이미 앞에서 해봤어요!
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+네! `len()` 함수는 리스트 안에 있는 객체의 수를 알려줍니다. 편리하지 않나요? 이제 정렬을 해봅시다:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+아무것도 보여주지 않네요. 이 함수는 리스트 안의 숫자들을 오름차순으로 정렬합니다. 어떻게 변했는지 리스트를 출력해봅시다:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+위에 나왔듯이, 리스트 안에 있는 숫자들은 오름차순으로 정렬되었습니다. 축하합니다!
+
+만약 반대로 내림차순으로 정렬하고 싶다면요? 하면 됩니다!
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+참 쉽죠? 여러분이 리스트에 새로운 값을 추가하고 싶다면면, 추가할 때마다 매번 다시 정렬 명령을 해줘야 합니다:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+만약 첫 번째 숫자 하나만 보여주고 싶다면, **인덱스(index)**를 사용하세요. 인덱스는 리스트 안의 아이템 위치를 나타내는 숫자입니다. 프로그래머는 0부터 세는 것을 선호합니다. 따라서 리스트에 있는 첫 번째 객체는 인덱스 0부터 시작하고, 그 다음은 1, 그 다음은 2.. 가 됩니다. 해봅시다:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+리스트의 이름이나 대괄호 안에 들어가는 객체의 인덱스를 사용해서, 리스트 안에 있는 다른 객체로도 접근이 가능합니다.
+
+리스트에서 무엇인가를 지우기위해서는 위에서 배운 **인덱스**와 , `pop()` 명령어가 필요해요. 이제 한번 해보고 이전에 배웠던 것을 다시 떠올려봅시다; 목록에서 첫 번째 숫자를 삭제할 것입니다.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+마법같네요!
+
+재미로 몇 번 더 여러 인덱스를 테스트해보세요: 6, 7, 1000, -1, -6, -1000 등이요. 결과값을 보기 전에 미리 어떤 값이 나올지 예상할 수 있었나요? 생각했던 정답이 나왔나요?
+
+이번 장에 나온 리스트 메서드와 관련된 모든 내용은 파이썬 공식 문서에서 찾을 수 있습니다. : https://docs.python.org/3/tutorial/datastructures.html
+
+## 딕셔너리(Dictionary)
+
+> 집에서 공부하시는 분은: [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c)영상을 참고하세요.
+
+딕셔너리는 리스트와 유사하지만, 인덱스가 아닌 키(key)로 값을 찾습니다. 키는 문자열이든, 숫자든지 상관 없습니다. 빈 딕셔너리를 만드는 문법은 아래와 같습니다. :
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+방금 비어있는 딕셔너리를 하나 만들었답니다. 만세!
+
+자, 이제 아래 명령어를 따라 작성해 봅시다. (안에 있는 정보는 마음대로 바꿔도 됩니다):
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+위 명령어로 `paticipant`라는 이름의 변수를 만들었습니다. 이 변수 안에는 3개의 키-값 쌍이 들어있습니다.
+
+- 키(key) 는 `name`이고, 값(value) 는 `'Ola'`를 가리킵니다. (`string(문자열)` 객체이지요.),
+- 키 `country`의 값은 `'Poland'`입니다. (또 다른 `string`입니다),
+- 그리고 키 `favorite_numbers`는 `[7, 42, 92]`를 가리킵니다. (`리스트`에는 세 개의 숫자가 있습니다.)
+
+여러분은 아래와 같은 문법으로 개별 키의 값에 접근할 수 있습니다.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+리스트와 조금 비슷하죠. 다만 인덱스가 아닌, 이름을 사용해 값에 접근한다는 것을 기억하세요.
+
+만약 파이썬에 키에 대응하는 값이 없는 경우에는 어떻게 될까요? 예측할 수 있나요? 그럼 한 번 알아봅시다!
+
+{% filename %}{{ warning_icon }} 명령줄{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+보세요, 에러가 났네요! 이번에는 **KeyError**에러가 났습니다. 파이썬은 친절하게 키 `'age'`가 딕셔너리에 존재하지 않는다고 알려주네요.
+
+그렇다면 언제 딕셔너리를 쓰고, 언제 리스트를 사용해야할까요? 이를 위한 판단 기준은 다음과 같습니다.
+
+- 아이템을 나열할 때 정렬이 필요하나요? 그렇다면 리스트를 사용하세요.
+- 키(key) 과 값(value) 이 서로 연관되어 있어야 하나요? 또는 보다 효과적으로 (키를 사용해서) 어떤 값을 찾아야 하나요? 그렇다면, 딕셔너리를 사용하세요.
+
+딕셔너리는 리스트와 유사하지만, *변경(mutable)*할 수 있습니다. 딕셔너리가 만들어진 후에도, 그 값을 마음대로 변경할 수 있다는 뜻이지요. 키/값 을 나중에 추가할 수 있답니다. 바로 이렇게요. :
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+리스트처럼 딕셔너리도 `len()` 메서드를 사용하여 키-값 쌍의 수를 리턴합니다. 한 번 커맨드라인에서 확인합시다.:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+다들 이해를 잘 하고 있으리라 믿어요 :) 딕셔너리로 좀 더 재미있는 것을 해볼까요? 좀더 흥미로운 내용이 다음에 있어요.
+
+`pop` 명령어로 딕셔너리에 있는 아이템을 삭제할 수 있습니다. `'favorite_numbers'` 키를 삭제하고 싶으면, 아래와 같은 명령어를 입력하면 됩니다. :
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+위에 보여지는 결과처럼 'favorite_numbers' 에 해당하는 키-값 쌍이 삭제되었네요.
+
+이뿐만 아니라 딕셔너리 안에 이미 만들어진 키에 해당하는 값도 변경할 수 있습니다. 다음 내용을 해보세요:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+보셨듯이, `'country'` 키에 해당하는 값이 `'Poland'`에서 `'Germany'`로 변경되었네요. :) 재미있죠? 야호! 우리는 또 굉장한 것을 배웠네요.
+
+### 목차
+
+훌륭하네요! 이제 모두가 프로그래밍에 대해서 많은 것을 알게 되었어요. 지금까지 우리가 배운 내용은 다음과 같아요. :
+
+- **에러** - 파이썬이 작성된 명령어를 이해하지 못할 때 발생하는 에러를 읽고 이해할 수 있습니다.
+- **변수** - 객체에 이름을 붙여 코드를 가독성 좋게 작성할 수 있습니다.
+- **리스트** - 특정한 순서로 정렬된 객체들이 저장된 목록임을 알고 있습니다.
+- **딕셔너리** - 키(key)-값(value) 쌍으로 이루어진 객체들이 저장된 것임을 알고 있습니다.
+
+다음 내용이 기대되나요? :)
+
+## 비교하기
+
+> 집에서 공부하시는 분은: [파이썬 기초: 비교하기](https://www.youtube.com/watch?v=7bzxqIKYgf4)영상을 참고하세요.
+
+무엇인가 비교하는 것은 프로그래밍에서 매우 중요한 부분이에요. 비교를 할 때, 제일 쉬운 방법은 무엇일까요? 당연히, 숫자입니다. 어떻게 하는지 알아볼게요. :
+
+{% filename %}{} 명령줄{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+우리는 파이썬에서 몇가지 숫자를 비교할거에요. 보다싶이 파이썬은 숫자비교만 가능한게 아니에요. 수학적 표현인 `2 * 2`의 값과 `len([4, 5])`함수의 결과값인 `2`의 비교 또한 가능하답니다. 멋지죠?
+
+두 숫자를 비교할 때 왜 등호 부호 `==`를 사용하는지 궁금했죠? 우리는 변수에 값을 넣을 때 한 개의 등호 기호 `=`를 사용하죠. 그렇기 때문에, 두 대상이 같은지 서로 비교하기 위해서는 **항상** 두 개의 등호 기호 `==`를 사용해야 합니다. 마찬가지로 두 대상이 서로 같지 않다라고 말할 수 있습니다. 위 예제에서 볼 수 있었듯이 서로 같은 대상이 아닐 때는 `!=` 기호를 사용합니다.
+
+두 개의 작업을 더 해볼게요.:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+`>`와 `<`는 알겠지만, `>=`와 `<=`는 무슨 뜻일까요? 아래 내용을 읽어보세요. :
+
+- x `>` y : x는 y보다 크다
+- x `<` : x는 y보다 작다
+- x `<=` : x가 y보다 작거나 같다
+- x `>=` : x가 y보다 크거나 같다
+
+잘했어요! 좀 더 해볼까요? 이런 건 어떨까요. :
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+파이썬은 얼마든지 원하는 만큼 숫자를 비교할 수 있고 답을 알려줄 거에요! 똑똑한 녀석이죠?
+
+- **and** - `and` 연산자는, 두 값 모두 참(True) 일 경우에만 결과가 True가 됩니다.
+- **or** - `or` 연산자는, 둘 중 하나만 참(True) 일 경우에 True가 됩니다.
+
+"사과를 오렌지에 비교하기"라는 말을 들어본 적이 있나요? 파이썬에게 시켜봅시다. :
+
+{% filename %}{{ warning_icon }} 명령줄{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+이처럼 파이썬은 숫자(`int`) 와 문자열(`str`) 을 비교할 수 없어요. 비교는 못하지만 대신 **TypeError**를 보여줘 두 타입이 서로 비교 대상이 아니라는 것을 알려줍니다.
+
+## Boolean (불리언)
+
+덧붙여서, 파이썬에서 **Boolean**이라는 새 객체 타입을 배웠어요.
+
+Boolean 객체는 종류는 딱 두 가지 뿐이에요.:- 참(True)- 거짓(False)
+
+- True
+- False
+
+그런데 파이썬이 이해시키려면, 항상 'True'라고 써야 합니다. (즉 첫 글자가 대문자고 나머지는 소문자여야만, Boolean으로 이해하는 것이죠.) **true, TRUE, tRUE는 모두 틀린 표현이에요. -- True만 올바른 표현입니다.** (False도 마찬가지입니다.)
+
+Boolean도 변수로 사용할 수도 있습니다! 다음을 보세요:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+이런 식으로도 쓸 수 있습니다.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+아래 명령어를 실행해보면서 Boolean을 가지고 놀아보세요. :
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+축하합니다! Boolean은 프로그래밍에 있어서 가장 멋진 기능 중 하나에요. 여러분은 Boolean을 앞으로 어떻게 사용해야 하는지 방금 배웠답니다!
+
+# 코드 저장하기!
+
+> 집에서 공부하시는 분은: [파이썬 기초: 파일 저장하기와 "if" 반복문](https://www.youtube.com/watch?v=dOAg6QVAxyk)영상을 참고하세요. 
+
+지금까지 우리는 인터프리터(interpreter) 에서 파이썬 코드를 입력해 왔어요. 한 번에 코드 한 줄만 입력할 수 있었어요. 일반적으로 프로그램은 파일로 저장되어 프로그래밍 언어 **인터프리터(interpreter)** 또는 **컴파일러(complier)**로 실행됩니다. 지금까지 우리는 파이썬 **인터프리터**에서 한 줄씩 코드를 입력해 프로그램을 실행시켰어요. 이제 앞으로는 한 줄 이상 더 많은 코드를 작성해 실행해 볼 거에요. 빨리 해볼게요. :
+
+- 파이썬 인터프리터를 종료하세요.
+- 선택한 코드 에디터를 실행하세요.
+- 코드를 새 파이썬 파일로 저장하세요.
+- 실행하세요!
+
+사용했던 파이썬 인터프리터를 종료하려면, `exit()` 함수를 입력하세요.:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+그러면 커맨드 프롬프트(또는 콘솔창) 가 초기화 됩니다.
+
+이전에 우리는 [코드 편집기](../code_editor/README.md)섹션에서 코드편집기를 알아봤어요. 우리는 지금 편집기를 열어서 새로운 파일에 코드를 입력해야 해요(만약 크롬북을 사용하고 있다면, 코드 편집기가 포함된 클라우드IDE에 새파일을 만들어요):
+
+{% filename %}편집기{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+오늘 우리 모두가 파이썬 개발자가 되었답니다. 그러니 오늘 배운 코드를 가지고 놀아보세요.
+
+이제 파일을 저장하고 파일 이름을 바꾸세요. 바탕화면에 **python_intro.py** 파일로 저장하세요. 원하는 파일이름으로 저장할 수 있지만, 파일 이름이 반드시 **.py**로 끝나야 해요. **.py**파일 확장자는 운영체제에게 **파이썬 실행 파일**이니 파이썬을 실행하라고 지시합니다.
+
+> **주의** 우리는 코드 에디터의 멋진 기능을 알고 있어야 해요. : 파이썬 콘솔에서는 모든 코드가 같은 색이였지만, 이제 `print` 함수와 그 안에 있는 문자열이 다른 색깔로 되어 구분할 수 있다는 것을 알게 되었을 거에요. 이를 "문법 하이라이팅(syntax highlighting)" 하는데, 코딩할 때 필요한 기능이죠. 이 기능은 여러분에게 색깔로 힌트를 알려줘요. 예를 들어, 문자열이 제대로 닫히지 않았다던가, 특정 키워드(함수에서 사용하는 `def` 같은 특별한 의미로 쓰이는 단어. 앞으로 다룰 거에요.)를 사용할 때, 다른 색으로 지정해서 바로 알 수 있게 해주죠. 그래서 우리는 코드 에디터를 사용한답니다. :) :)
+
+파일을 저장했다면, 커맨드라인 장에서 배웠던 것을 써먹어야죠! 터미널에서 데스크탑으로 **디렉토리 변경**을 해보세요.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+맥이라면 명령어는 다음과 같을 것입니다:
+
+{% filename %}명령줄{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+리눅스라면 다음과 같이 하세요. :
+
+{% filename %}명령줄{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+("Desktop"이라는 단어는 당신의 언어로 번역되어있을 수 있다는 것을 기억하세요)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+윈도우 명령창에서는 다음과 같이 될거에요:
+
+{% filename %}명령줄{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+그리고 윈도우 파워셸에서는 다음과 같이 하세요. :
+
+{% filename %}명령줄{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+만약 하는도중에 막혔다면, 도움을 요청하세요. 여기에 코치들이 있는 이유랍니다.
+
+이제 파일 안에 있는 코드를 실행하기 위해 다음과 같이 파이썬을 실행해 봅시다. :
+
+{% filename %}명령줄{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+주의: 윈도우에서는 'python3'를 명령으로 인식하지 못해요. 대신에 'python'을 사용해 파일을 열 수 있답니다.
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+잘했어요! 우리는 첫 파이썬 프로그램이 저장된 파일을 실행했어요. 내가 드디어 해냈다고 느껴지나요?
+
+다음으로 프로그래밍의 필수 도구를 알아볼 차례에요. :
+
+## If … elif … else
+
+코드의 많은 부분은 조건을 만났을 때 실행된답니다. 이를 위해 파이썬은 **if문**을 사용합니다.
+
+**python_intro.py** 파일을 다음과 같이 수정하세요:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+저장하고 실행하면 아래와 같은 에러를 보게 될 거에요. :
+
+{% filename %}{{ warning_icon }} 명령줄{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+파이썬은 조건문 `3 > 2`가 참인 경우(또는 값이 `True`인 경우)에 어떤할 지 물어 보네요. 이 경우에 파이썬이 "It works!"를 출력하게 해봅시다. : **python_intro.py** 파일을 아래와 같이 수정하세요. :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+두 번째 줄 들여쓰기 된 코드에 스페이스 4칸을 준 게 보이나요? 파이썬에서 결과가 참일대 코드를 실행하기 위해서는 이처럼 들여쓰기를 해줘야 한답니다. 물론 스페이스 한 칸만 띄울 수 있지만, 거의 모든 파이썬 프로그래머들은 코드를 깔끔하게 작성하기 위해 4칸을 사용해요. 텍스트 편집기에서 한번의 탭이 스페이스 4칸으로 계산된답니다. 들여쓰기 방식을 결정했다면, 바꾸지 마세요. 이미 스페이스 4칸으로 들여쓰기가 되었다면, 이후의 들여쓰기는 모두 4칸이어야 해요. 만약 그렇지 않으면 실행할때 문제가 생길거에요.
+
+이제 저장하고 실행해보세요:
+
+{% filename %}명령줄{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+주의: 윈도우에서는 'python3'가 명령으로 인식되지 않으니, 지금부터 'python3'를 'python'으로 변경해서 실행하세요.
+
+### 조건이 참(True) 이 아니라면 어떻게 되나요?
+
+앞의 예제에서 코드가 조건이 True인 경우에만 실행되게 만들었어요. 하지만 파이썬은 `elif`문과 `else`문도 사용할 수 있습니다.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+실행하면 다음과 같이 출력됩니다:
+
+{% filename %}명령줄{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+만약 2가 5보다 크다면 두번째 명령이 실행됩니다. 참 쉽죠? 이제 `elif`가 어떻게 작동하는지 봅시다. :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+그리고 실행해보세요. :
+
+{% filename %}명령줄{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+어떻게 됐나요? `elif`문은 맨 처음 조건이 아닐 경우 그 다음 조건을 처리하게 해줍니다.
+
+여러분은 `if` 문을 쓴 다음에 원하는 만큼 `elif` 문을 계속 추가할 수 있어요. 이렇게요. :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+파이썬이 각 테스트를 순서대로 실행하고 출력합니다:
+
+{% filename %}명령줄{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## 주석
+
+주석은 `#`로 시작해요. `#` 다음에 아무거나 원하는 것을 입력하면 파이썬은 이를 무시할거에요. 주석은 당신의 코드를 다른사람들이 더 쉽게 이해할 수 있도록 만들어 줄거랍니다.
+
+어떻게 보이는지 한번 알아볼까요:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+모든 코드에 주석을 달 필요는 없어요, 그러나 당신의 코드가 무엇을 해야하는지 설명해야 하거나 복잡한 무엇인가를 요약해야할 때 유용할 거에요.
+
+### 목차
+
+지금까지 우리는 몇가지 예제로 다음과 같은 것들을 배웠어요.:
+
+- **비교하기** - 파이썬에서 `>`, `>=`, `==`, `<=`, `<` 그리고 `and`, `or` 연산자를 사용해 비교합니다.
+- **Boolean** -두 둘 중 하나의 값만 가질 수 있는 객체입니다. : `True` 또는 `False`
+- **파일 저장하기** - 복잡한 프로그램을 실행할 수 있도록 코드를 파일로 저장합니다.
+- **if...elif...else** - 조건문을 작성해 특정 조건이 주어졌을 때만 코드가 실행되도록 만듭니다.
+- **주석** - 파이썬에서 실행하지 않고 문서화할 라인이에요.
+
+드디어 이번 장의 마지막 부분입니다!
+
+## 나만의 함수 만들기!
+
+> 집에서 공부하시는 분은: [파이썬 기초: 함수](https://www.youtube.com/watch?v=5owr-6suOl0)영상을 참고하세요.
+
+앞에서 했던 파이썬 `len()` 같은 함수를 기억하나요? 네, 좋은 소식이에요. 지금부터는 함수를 만드는 법을 배울 거에요!
+
+함수는 파이썬이 실행해야하는 명령어의 나열이에요. 파이썬의 각 함수는 `def`로 시작해, 이름을 가지고, 몇 가지 매개 변수를 가집니다. 자 한번 해볼까요. **python_intro.py**파일을 열어 코드를 다음과 같이 고치세요. :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+네, 우리가 만든 첫 번째 함수네요!
+
+파일 맨 밑에 왜 함수의 이름을 적는지 궁금할거에요. 우리가 적은 `def hi():`와 뒤따르는 들여쓰기된 줄들은, `hi()` 함수가 해야될 명령을 작성한 거에요 파이썬은 이 명령을 읽고 기억하겠지만, 우리는 아직 함수를 실행하지 않았어요. 파이썬에게 함수를 실행하라고 말하려면, `hi()` 로 함수 호출을 해야해요. 파이썬은 위에서부터 아래로 파일을 읽고 실행해요, 그래서 우리는 함수를 호출하기전에 먼저 정의해야 한답니다.
+
+이제 실행해서 어떻게 되는지 봅시다:
+
+{% filename %}명령줄{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+주의: 만약 작동이 안된다면, 당황하지 마세요! 출력된 내용을 보면 왜 그런지 알아가는데 도움이 될거에요:
+
+- `NameError`라면, 무엇인가 잘못 입력한거에요, `def hi():` 함수를 만들때랑 `hi()`를 호출할때 같은 이름인지 확인해요.
+- `IndentationError`라면, 두개의 `print` 줄이 같은 공백갯수로 시작되었는지 확인해요.: 파이썬은 함수내 모든 코드가 깔끔하게 정렬되기 원한답니다.
+- 아무것도 출력되지 않는다면, 마지막 `hi()` 가 들여쓰기 되지*않았는지* 확인해요. - 만약 들여쓰기 되어있다면, 함수의 일부가되어서 절대 실행되지 않을거랍니다.
+
+정말 간단하네요! 매개 변수와 함께 첫 번째 함수를 만들어 볼게요. 전에 사용했던 예제를 다시 사용할 거에요. 함수를 실행하면, 사람들에게 자신의 이름과 함께 'hi'를 말하게요.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+함수에 매개변수인 `name`를 주었어요.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+기억하세요: `if`문 안의 `print`함수는 4칸을 들여쓰기 했습니다. 조건문에 해당하는 경우에만 실행되게 만들기 위해서에요. 이제 어떻게 되는지 보세요. :
+
+{% filename %}{{ warning_icon }} 명령줄{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+이런, 에러가 나왔네요. 다행히도, 파이썬 에러는 유용한 오류 메세지를 보여주네요. 에러 메시지를 보면 함수 `hi()`가 한 개의 인자값(`name`) 을 필요로 하는데, 그 함수를 호출할 때 빼먹고 실행했다는 것을 알려주고 있어요. 이제 아래와 같이 코드를 수정해봅시다:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+그리고 다시 실행해보세요. :
+
+{% filename %}명령줄{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+만약 이름을 바꾸면 어떻게 될까요?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+그리고 실행하세요:
+
+{% filename %}명령줄{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+이제 다른 이름(Ola와 Sonja가 아닌) 을 넣는다면 어떻게 될까요? 한번 넣어서 실행해봅시다. 이렇게 나와야 해요. :
+
+{% filename %}명령줄{% endfilename %}
+
+    Hi anonymous!
+    
+
+어때요, 정말 굉장하지 않나요? 이로써 인사 함수가 호출될 때마다, 사람 이름을 매번 반복할 필요가 없어요. 그래서 함수가 필요해요 - 매번 똑같은 코드를 반복해 작성하지 않아도 돼요!
+
+좀더 똑똑하게 해보아요 - 이름이 두개 이상일때, 매번 조건을 작성하는것은 힘들겠죠? 아래와 같이 파일의 내용을 바꿔보세요.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+이제 코드를 실행해 봅시다:
+
+{% filename %}명령줄{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+축하합니다! 우리는 이제 함수를 작성하는 법을 알게 되었어요! :)
+
+## 반복하기
+
+> 집에서 공부하시는 분은 : [파이썬 기초: For 반복문](https://www.youtube.com/watch?v=aEA6Rc86HF0) 영상을 참고하세요.
+
+이제 마지막 부분입니다. 금방 했죠? :)
+
+프로그래머는 반복되는 일을 스스로 하기를 좋아하지 않아요. 프로그래밍이란 어떤 일들을 자동화하는 것이니까 반복적인 경우가 생기면 그걸 반복해서 해결하는 코드를 짜는 것이지요. 앞에서 했던 예제와 같이 인사해야 하는 사람이 수백명 있을 경우, 설마 각각 사람마다 인사하려고 hi('누구누구') 코드를 수백번 입력하고 싶지는 않겠지요? 이런 경우에 바로 반복문(loop)를 사용할 수 있어요.
+
+리스트 아직 기억하고 있어요? 아래 girls 리스트를 보세요. :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+우리는 여자 아이들 이름을 불러 인사를 하고 싶어요. 우리는 이미 `hi` 함수를 만들었으니 반복문을 사용해봅시다. : 
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+`for` 문은 `if` 문과 비슷하게 동작합니다; 두 경우 모두 다음에 오는 코드들을 4칸 들여쓰기 해야해요.
+
+아래 완성된 코드입니다. :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+실행하면 다음과 같습니다:
+
+{% filename %}명령줄{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+`girls` 리스트의 요소마다 여러분이 `for`문에 넣은, 들여쓰기를 한 모든 코드들이 반복됩니다.
+
+`for`문에 `range` 함수로 숫자를 사용할 수 있어요.
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+이렇게 출력됩니다. :
+
+{% filename %}명령줄{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range`는 매개 변수로 넘겨진 숫자부터 시작하는 숫자 리스트를 만들어주는 함수입니다.
+
+파이썬에서는 두 숫자 중 두 번째는 리스트에 포함되지 않는다는 것을 주의하세요. (즉 `range(1, 6)`는 1부터 5까지 카운트 하며 숫자 6은 리스트에 포함되지 않습니다.) "range"는 반만 열려 있기 때문에, 첫번째 숫자는 포함되지만 마지막 숫자는 포함되지 않아요.
+
+## 목차
+
+이제 다 끝났어요. **모두 정말 대단해요!** 어려운 내용이었는데 잘 해낸 나 자신을 자랑스럽게 생각하세요. 여기까지 온 것이 자랑스럽습니다!
+
+공식 파이썬 튜토리얼을 모두 해보고 싶다면 https://docs.python.org/3/tutorial/ 을 방문해보아요. 이렇게하면 철저하고 완벽하게 언어를 학습할 수 있어요. 화이팅!:)
+
+다음 장으로 넘어가지 전에 좀 쉬고 와도 좋아요. 스트레칭을 하던가, 잠깐 산책을 하던가, 눈을 쉬게 한다던가 말이죠. :)
+
+![컵케이크](images/cupcake.png)
\ No newline at end of file
diff --git a/ko-KR/template_extending/README.md b/ko-KR/template_extending/README.md
new file mode 100644
index 00000000000..821a3a8ffd2
--- /dev/null
+++ b/ko-KR/template_extending/README.md
@@ -0,0 +1,151 @@
+# 템플릿 확장하기
+
+장고의 또 다른 멋진 점은 **템플릿 확장(template extending)**입니다. 무슨 뜻일까요? 바로 여러분의 웹사이트 안의 서로 다른 페이지에서 HTML의 일부를 동일하게 재사용 할 수 있다는 뜻이에요.
+
+템플릿은 여러 곳에 동일한 정보/레이아웃을 사용하게 만들어 줍니다. 모든 파일에 동일한 내용을 반복해서 작성할 필요가 없게 되지요. 만약 어떤 부분을 변경하고 싶다면, 모든 템플릿을 수정하지 않아도 되어요. 딱 한번만 수정하면 끝난답니다!
+
+## 기본 템플릿 생성하기
+
+기본 템플릿은 웹사이트 내 모든 페이지에 확장되어 사용되는 가장 기본적인 템플릿입니다.
+
+`blog/templates/blog/`에 `base.html` 파일을 만들어 봅시다:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+그 다음 코드 에디터에서 파일을 열어 `post_list.html`에 있는 모든 내용을 `base.html`에 아래 내용을 복사해 붙여넣습니다.
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+그 다음 `base.html`에서 `<body>` (`<body>`와 `</body>` 사이에 있는 모든 내용)의 모든 내용을 아래와 같이 바꿉니다:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}`{% for post in posts %}` 부터`{% endfor %}` 까지 모든 내용을 바꿨어요. {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+왜 그럴까요? `block`을 만들었기 때문이죠! `{% block %}`템플릿 태그는 HTML이 삽입될 수 있는 영역을 만들어줍니다. (`base.html`)템플릿이 확장되어 HTML이 다른 템플릿에도 들어갈 수 있게 됩니다. 그럼 어떻게 동작하는지 알아볼게요.
+
+`base.html`을 저장한 후, 코드 에디터에서 `blog/templates/blog/post_list.html`을 다시 엽니다. {% raw %}`{% for post in posts %}`부터 `{% endfor %}`까지 모든 내용을 지우세요. 완료했다면 아래처럼 될 거에요:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+모든 콘텐츠 블록마다 이 템플릿을 사용할 거에요. 이제 파일에 블록 태그를 추가할 차례입니다!
+
+{% raw %}`base.html`파일 내 태그와 블록 태그가 일치하게 만들어야 합니다. 콘텐츠 블록에 속한 모든 코드가 포함되어야 하고요. 이를 위해, `{% block content %}`와 `{% endblock %}`사이에 모든 코드를 작성하면 됩니다. 아래 처럼요. :{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+한가지가 남았습니다. 템플릿 두 개를 서로 연결해야합니다. 그래서 템플릿을 확장한다는 거죠! 파일의 첫 부분에 태그를 추가하면 됩니다. 이렇게요:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+다 되었어요! 여러분의 웹사이트가 잘 작동하는지 확인해보세요. :)
+
+> 만약 `TemplateDoesNotExists(템플릿파일이 존재하지 않습니다)`라는 에러 메세지가 난다면 `blog/base.html`파일이 없이 콘솔에서 `runserver`가 작동되고 있는 경우입니다. 이런 경우, (Ctrl+C)를 눌러서 멈춘 후 `python manage.py runserver`명령어로 다시 서버를 실행하세요.
\ No newline at end of file
diff --git a/ko-KR/whats_next/README.md b/ko-KR/whats_next/README.md
new file mode 100644
index 00000000000..be4425fc698
--- /dev/null
+++ b/ko-KR/whats_next/README.md
@@ -0,0 +1,43 @@
+# 다음은?
+
+모두 축하합니다! 저는 여러분이 정말 멋지고 아주 자랑스러워요!! >_< <3
+
+### 이제 무엇을 해야하나요?
+
+잠시 휴식을 가지고 여유를 가지세요. 여러분은 이제 막 정말 큰 일 마쳤으니까요
+
+[Facebook](http://facebook.com/djangogirls) 또는 [Twitter](https://twitter.com/djangogirls) 에서 Django Girls를 구독하셔서 최신 정보를 얻으세요!
+
+### 다음에 해볼만한 자료를 추천해주실래요?
+
+예! 모든 종류의 프로그래밍 기술을 학습 할 수있는 * 많은</ 0> 리소스가 온라인에 있습니다. 다음에 어디로 가야할지 결정하는 것은 상당히 어려울 수 있지만, 저희가 도와 드리겠습니다. Django Girls에 오기 전에 관심사가 무엇이었든, 튜토리얼을 통해 개발한 관심사가 무엇이든, 여기에 원하는 곳으로 이동하는 데 사용할 수있는 무료 리소스 (또는 큰 무료 구성 요소가있는 리소스)가 있습니다.</p> 
+
+#### Django
+
+- 우리의 다른 책, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django 공식 튜토리얼](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Djnago 비디오 강의로 시작하기](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) - 몇몇의 비디오 강의는 무료로 청강할수 있으며 과정을 수료하여 Coursera 증명서를 취득할 수 있습니다.
+
+#### HTML/CSS/JavaScript
+
+- [Codeacademy web 개발 과정](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### 파이선(Python)
+
+- [Codeacademy Python 과정](https://www.codecademy.com/learn/learn-python)
+- [Google Python 과정](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – 첫 연습 무료
+- [New Coder tutorials](http://newcoder.io/tutorials/) –파이썬 활용에 대한 다양한 실습 예제
+- [edX](https://www.edx.org/course?search_query=python) - 당신은 무료로 청강할 수 있습니다. 그러나 인증서를 취득하거나 양질의 교육 충족을 위한 학점을 얻기위해서는 비용을 지불해야합니다.
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/python) - 몇몇의 비디오 강의는 무료로 청강할수 있으며 과정을 수료하여 Coursera 증명서를 취득할 수 있습니다.
+- [Python for Everybody](https://www.py4e.com/) - 전문화를 위한 Coursera Python의 무료 공개 버전
+
+#### 데이터학습
+
+- [Codeacademy 데이터 사이언스 과정](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) - 당신은 무료로 청강할 수 있습니다. 그러나 인증서를 취득하거나 양질의 교육 충족을 위한 학점을 얻기위해서는 비용을 지불해야합니다.
+- [Dataquest](https://www.dataquest.io/) - 첫 30 과제는 무료
+
+우리는 다음에 당신이 무엇을 만드는지 빨리 보고싶어요!
\ No newline at end of file
diff --git a/ko/GLOSSARY.md b/ko/GLOSSARY.md
index e549ec65d06..3d405faa668 100755
--- a/ko/GLOSSARY.md
+++ b/ko/GLOSSARY.md
@@ -1,3 +1,3 @@
 # 코드 에디터
 
-코드 에디터는 코드를 저장하고 불러올 수 있는 프로그램입니다. 자세한 내용은 [코드 에디터](./code_editor/README.md) 장에서 다룹니다.
+코드 에디터는 코드를 저장하고 다시 불러올 수 있는 프로그램입니다. [코드 에디터 장](./code_editor/README.md)에서 배울 수 있습니다.
\ No newline at end of file
diff --git a/ko/README.md b/ko/README.md
index 0bbd2537794..25bebde233e 100755
--- a/ko/README.md
+++ b/ko/README.md
@@ -1,54 +1,51 @@
-# 장고걸스 튜토리얼 (Django Girls Tutorial)
-[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
-
-> 이 튜토리얼은 Creative Commons Attribution-ShareAlike 4.0 International 저작권을 준수합니다.
-> 라이센스 전문은 https://creativecommons.org/licenses/by-sa/4.0 에서 확인하세요.
-
-## 번역
-이 튜토리얼은 열정적인 장고걸스 코치들과 자원봉사자들의 수고로 번역되었습니다.
+# 장고 걸스 튜토리얼 (Django Girls Tutorial)
 
-> 번역 업데이트 및 번역자
-> - 1차 : 2015. 10. 1. 
-    [이수진](https://github.com/sujinleeme), 함기훈, [Jay Park](http://jinto.pe.kr/), 조혜선, [정광윤](https://twitter.com/initialkommit), 임정훈, 문지영, 김휘경, 송석리, 여형석, 심혜민
-> - 2차 : 2016. 6. 3. 
-    [이수진](https://github.com/sujinleeme)
-> - 3차 : 2017. 5. 19.
-    [이수진](https://github.com/sujinleeme)
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
 
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
 
-## 환영합니다
+## Welcome
 
-장고걸스 튜토리얼에 오신 여러분들을 환경합니다! 이 곳에서 만나게 되어 기뻐요 :) 여러분을 웹 테크놀로지의 여정으로 초대하여 함께 조금씩 맛보면서 웹이 어떻게 작동하는지 알 수 있도록 도와드릴 거에요.
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
 
-아직 발견하지 못한 것을 알아가야하는 꽤 도전적인 모험이 될 것이지만, 지금 이 튜토리얼을 보는 여러분들은 용기를 가지고 있기 때문에, 끝까지 잘 해낼 거라 믿어요. :)
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
 
 ## 들어가며
-점점 기술이 중요해진 세상에 살고 있지만 나와 관련이 없다고 생각한 적이 있나요? 그동안 웹 사이트를 어떻게 만드는지 궁금했지만 막상 시작하기 어려웠나요? 소프트웨어 세상이 복잡해보여 혼자서 직접 만들기엔 엄두가 나지 않았나요?
 
-그런 여러분들에게 반가운 소식이 있습니다! 프로그래밍은 생각만큼 어려운 것이 아니랍니다. 우리는 여러분들에게 프로그래밍이 얼마나 재미있는 것인지 알려드리고 싶어요.
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? 그동안 웹 사이트를 어떻게 만드는지 궁긍했지만 막상 시작하기 어려웠나요? 소프트웨어라는 세상이 너무 복잡해보여 스스로 직접 만들기엔 엄두가 나지 않았나요?
+
+여기 반가운 소식이 있습니다! 프로그래밍은 생각만큼 어려운 건 아니랍니다. 프로그래밍이 얼마나 재미있는 것인지 알려드리고 싶어요.
 
-물론 이 튜토리얼을 읽기만 하면 모두가 프로그래머가 되는 기적은 일어나지 않을 거예요. 프로그래밍에 능숙해지려면 몇 달, 혹은 몇 년이나 공부하고 수련해야 합니다. 그러나 프로그래밍이나 웹 사이트 제작은 생각만큼 복잡하지 않아요. 이 튜토리얼을 읽는 여러분들이 겁먹지 않도록 차근차근 친절하게 설명해 드릴 거에요.
+This tutorial will not magically turn you into a programmer. 프로그래밍에 능숙해지려면, 몇 달, 혹은 몇 년이나 공부하고 수련해야하죠. 그러나 프로그래밍이나 웹 사이트를 제작하는 것이 그렇게 복잡하지 않다는 것은 보여드리고 싶습니다. 여러분이 겁먹지 않도록 조금씩 설명해드릴거에요.
 
 우리가 그랬듯이 여러분들도 프로그래밍을 사랑할 수 있게 되길 바랍니다!
 
 ## 튜토리얼에서 무엇을 배우게 되나요?
-이 튜토리얼을 끝내면 간단한 기능을 갖춘 나만의 블로그 사이트를 완성할 수 있어요. 온라인에 웹사이트를 올리는 방법도 배울 거에요. 다른 사람들도 여러분의 작품을 보게 될 거랍니다!
 
-우리는 앞으로 아래와 같은 웹 사이트를 만들어 볼 거예요.
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
 
-![Figure 0.1](images/application.png)
+우리는 이렇게 만들어 볼 거에요.
 
-> 만약 집에서 혼자 튜토리얼을 따라하다 문제가 생겼지만 주변에 도움받을 사람이 없다면 이 곳에서 질문하세요 : [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). 코치와 워크샵 참가자들은 여러분들을 도와줄 거에요! 어떤 질문이든 주저하지 말고 물어보세요!
+![그림 0.1](images/application.png)
 
-자, [이제 그럼 어서 시작해볼까요.](./how_the_internet_works/README.md)
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). 우리는 코치나 전 참가자들에게 이 곳에서 도움이 필요한 사람들을 도와달라고 요청해두었답니다! 어떤 질문이든 물어보는데 주저하지 마세요!
 
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
 
 ## 집에서 튜토리얼 따라하기
-장고걸스 워크샵에서 모든 분들을 만나뵙고 싶지만, 참석하기 어려운 분들이 있다는 것을 잘 알고 있어요. 그래서 워크샵에 참석하지 못하는 분들은 집에서 튜토리얼을 보며 자습하시길을 권장하고 있어요. 혼자서도 집에서 튜토리얼을 보며 학습하실 수 있도록 비디오 동영상을 만들고 있어요. [Coding is for girls 유투브 채널](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A)에서 보실 수 있고, 앞으로 더 많은 영상들을 보여드릴 예정입니다.
 
-## 튜토리얼 참여하기
-이 튜토리얼은 [DjangoGirls](https://djangogirls.org/)에서 지속적으로 관리하고 있습니다. 오류를 발견하거나 튜토리얼 내용을 업데이트하고 싶다면 [참여 방법](https://github.com/DjangoGirls/tutorial/blob/master/README.md)을 참고하세요.
+장고걸스 워크샵에서 모든 분들을 만나고 싶지만, 참석하기 어려운 분들이 있다는 것을 알고 있어요. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+모든 장에서 바로 해당 영상을 보실 수 있게 링크를 연결했어요.
+
+## 튜토리얼에 참여하기
+
+이 튜토리얼은 [DjangoGirls](https://djangogirls.org/)에서 지속적으로 관리하고 있습니다. 오류를 발견하거나 튜토리얼 내용을 업데이트하고 싶다면 [가이드라인 참여방법](https://github.com/DjangoGirls/tutorial/blob/master/README.md)을 참고하세요.
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
 
-## 튜토리얼 번역 참여하기
-장고걸스 튜토리얼은 crowdin.com에서 전세계 언어로 번역되고 있습니다 [https://crowdin.com/project/django-girls-tutorial](https://crowdin.com/project/django-girls-tutorial)
-여러분이 사용하는 언어가 없다면, [github 이슈](https://github.com/DjangoGirls/tutorial/issues/new)에 등록하셔서 저희에게 알려주세요.
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ko/SUMMARY.md b/ko/SUMMARY.md
index 09abc9c4e19..ae147797530 100755
--- a/ko/SUMMARY.md
+++ b/ko/SUMMARY.md
@@ -1,27 +1,27 @@
 # 목차
 
-*   [들어가며](README.md)
-*   [설치하기](installation/README.md)
-*   [설치하기 (chromebook)](chromebook_setup/README.md)
-*   [인터넷은 어떻게 작동할까요](how_the_internet_works/README.md)
-*   [Command Line 시작하기](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 urls](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)
+* [들어가며](README.md)
+* [설치하기](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [인터넷이 어떻게 작동하는가](how_the_internet_works/README.md)
+* [Command Line(커맨드라인) 시작하기](intro_to_command_line/README.md)
+* [파이썬 설치하기](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 urls](django_urls/README.md)
+* [Django views – time to create!](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 – make it pretty](css/README.md)
+* [템플릿 확장하기](template_extending/README.md)
+* [어플리케이션 확장하기](extend_your_application/README.md)
+* [Django 폼](django_forms/README.md)
+* [다음은?](whats_next/README.md)
\ No newline at end of file
diff --git a/ko/chromebook_setup/README.md b/ko/chromebook_setup/README.md
index c13a8150fe1..bd9a1112262 100755
--- a/ko/chromebook_setup/README.md
+++ b/ko/chromebook_setup/README.md
@@ -1,5 +1,5 @@
-# 크롬북에서 설치하기
+# 크롬북 설정
 
-> **Note** 설치 과정을 모두 마친 분들은 이 부분을 할 필요가 없습니다. [Python 시작하기](../python_introduction/README.md) 장으로 바로 넘어가세요. 
+> **참고** 이미 설치 단계를 거쳤다면, 이 부분을 다시 하실 필요는 없습니다 - 바로 [Python 소개](../python_introduction/README.md)부분으로 넘어가세요.
 
-{% include "/chromebook_setup/instructions.md" %}
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ko/chromebook_setup/instructions.md b/ko/chromebook_setup/instructions.md
index 7cf699d815f..e28401a0750 100755
--- a/ko/chromebook_setup/instructions.md
+++ b/ko/chromebook_setup/instructions.md
@@ -1,50 +1,51 @@
-크롬북 미사용자는 이번 장을 건너뛰고 [파이썬 설치하기](http://tutorial.djangogirls.org/ko/installation/#install-python) 장으로 넘어가세요. 
+만약 크롬북을 사용하고 있지 않다면, [이 섹션은 바로 넘어가도 됩니다.](http://tutorial.djangogirls.org/en/installation/#install-python) 사용하고 있다면, 여러분의 설치 경험은 약간 다를 것입니다. 여러분은 설치 안내의 나머지 부분을 무시하셔도 됩니다.
 
 ### Cloud 9
 
-Cloud 9는 소프트웨어를 설치, 작성 및 실행할 수 있는 인터넷이 실행되는 컴퓨터에 대한 접근과 코드 에디터를 제공하는 도구입니다. 튜토리얼 실습하는 동안 Cloud 9은 _로컬 머신_ 이라 생각하면 됩니다. OS X, 우분투, 윈도우 사용자 처럼 터미널에서 명령어를 입력할 수 있지만, Cloud 9가 설정된 다른 곳에서 실행 중인 컴퓨터의 터미널에 연결됩니다.
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. 이 튜토리얼에서는, Cloud 9가 당신의 *로컬 컴퓨터* 역할을 합니다. 이번에도 OS X, Ubuntu, Windows 등에서 했던 것과 같이 터미널 화면에 명령어를 입력할 것입니다. 그러나 이번에는 터미널이, Cloud 9에서 당신을 위해 어디선가 돌리고 있는 가상의 컴퓨터에 연결됩니다.
 
-1. [크롬 웹 스토어](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)에서 Cloud 9를 설치하세요.
-2. [c9.io](https://c9.io)에 접속하세요.
-3. 새 계정을 만드세요.
-4. _Create a New Workspace_ 를 클릭하세요.
-5. _django-girls_ 라고 쓰세요.
-6. _Blank_(오렌지색 로고가있는 맨 아래 줄 오른쪽에서 두 번째)를 선택하세요.
+1. [크롬 웹 스토어](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)에서 Cloud 9 설치하기
+2. [c9.io](https://c9.io)로 들어가기
+3. 계정 만들기
+4. *Create a New Workspace* 클릭하기
+5. *django-girls*라고 이름 붙이기
+6. *Blank* 선택하기(맨 밑 줄, 오른쪽에서 두 번째에 있는 오랜지색 로고)
 
-이제 메인 창 아래쪽에 다음과 같은 작은 창이 보일 거에요. :
+이제 다음과 같이 사이드바와, 텍스트가 있는 큰 메인 창, 그리고 하단에 작은 창이 있는 화면이 보일 겁니다.
 
 {% filename %}Cloud 9{% endfilename %}
-```
-yourusername:~/workspace $
-```
 
-이 하단 부분이 명령어를 입력할 Cloud9 _터미널_입니다. 창 크기를 조금 크게 조절할 수도 있어요.
+    유저이름:~/workspace $
+    
 
-### 가상환경
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
 
-가상환경(virtual environment, 줄여서 virtualenv)은 작업하고 있는 프로젝트의 코드를 넣을 수 있는 일종의 전용 상자와 같아요. 가상환경을 사용해 서로 다른 프로젝트마다 코드가 섞이지 않도록 유지할 수 있습니다.
+### 가상 환경
 
-Cloud 9 터미널에서 아래 명령어를 따라 입력하세요. :
+가상 환경 (virtualenv라고도 부름) 은 우리가 작업하는 프로젝트에 유용한 코드를 저장해놓는 개인 상자와도 같습니다. 가상 환경은 여러 코드의 일부분이 프로젝트간에 섞이지 않도록 따로 저장하는 데에 사용됩니다.
+
+Cloud 9 화면 하단의 터미널에, 다음의 명령어를 실행합니다:
 
 {% filename %}Cloud 9{% endfilename %}
-```
-sudo apt install python3.6-venv
-```
 
-작동하지 않다면, 코치에게 도움을 구하세요.
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+만약 작동하지 않는다면, 코치에게 도움을 요청하세요.
 
-그리고, 실행해보세요. :
+그 다음엔, 다음과 같이 실행합니다:
 
 {% filename %}Cloud 9{% endfilename %}
-```
-mkdir djangogirls
-cd djangogirls
-python3.6 -mvenv myvenv
-source myvenv/bin/activate
-pip install django~=1.11.0
-```
 
-(마지막 줄에는 물결표 뒤에 등호(~=) 기호를 사용합니다)
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(마지막 줄에서 물결표 다음에 등호를 사용한다는 것을 참고하길 바랍니다: ~=)
 
 ### Github
 
@@ -52,8 +53,8 @@ pip install django~=1.11.0
 
 ### PythonAnywhere
 
-장고걸스 튜토리얼 중 배포하기 장에서 웹 애플리케이션을 구동하는 코드를 공개적으로 액세스 가능한 컴퓨터(서버라고 합니다)로 옮겨, 다른 사람들이 웹 사이트를 볼 수 있도록 실습할 거에요.
+장고걸스 튜토리얼에는 배포라는 섹션이 있습니다. 여기서는 다른 사람이 여러분의 작업물을 볼 수 있도록, 여러분이 만든 새로운 웹 어플리케이션을 구성하는 코드를 (서버라고 불리는) 공개적으로 접근할 수 있는 컴퓨터로 옮기는 과정을 설명합니다.
 
-크롬북은 이미 인터넷에 연결된 컴퓨터(노트북과는 반대)이기 때문에 배포하기 장을 따라하면서 조금 이상하다고 생각할 수 있는데요. cloud 9을 현재 "개발 진행 중"인 공간으로 생각하면서 실습한 후, 맨 마지막에 PythonAnywhere에서 결과물을 배포한다고 생각하면 도움이 될 거에요.
+크롬북에서 튜토리얼을 따라하고 있다면, (예를 들면, 일반적인 노트북과 달리) 이미 인터넷상에서 작동하는 컴퓨터를 사용하고 있기 때문에 이상할 수 있습니다. 그러나 우리가 만든 Cloud 9 작업 공간을 "진행 중인" 작업 공간이라고 생각하고, Python Anywhere가 좀 더 완성된 작업물을 보여주는 공간이라고 생각하면 여전히 유용할 것입니다.
 
-[www.pythonanywhere.com](https://www.pythonanywhere.com) 에서 새 계정을 만드세요.
+따라서, [www.pythonanywhere.com](https://www.pythonanywhere.com)에서 새로운 Python Anywhere 계정을 만드시길 바랍니다.
\ No newline at end of file
diff --git a/ko/code_editor/README.md b/ko/code_editor/README.md
index 0c143a4da39..bef3e25104a 100755
--- a/ko/code_editor/README.md
+++ b/ko/code_editor/README.md
@@ -1,11 +1,11 @@
 # 코드 에디터
 
-> **Note** 집에서 학습하시는 분들은 [파이썬 및 코드 에디터 설치하기](https://www.youtube.com/watch?v=pVTaqzKZCdA&amp;t=4m43s) 영상을 보세요.
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
 
-이제 곧 코드를 작성할 예정이니, 코드 에디터를 설치할 차례입니다!
+이제 코드를 작성하기 위해 코드 에디터를 다운로드 할 때에요!
 
-> **Note** 크롬북 사용자는 이번 장을 건너뛰고 [크롬북에서 설치하기](../chromebook_setup/README.md) 장으로 넘어가세요.
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
 
-> **Note** 설치하기 장에 있는 내용을 모두 마쳤다면 다음 장으로 넘어가도 됩니다!
-
-{% include "/code_editor/instructions.md" %}
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ko/code_editor/instructions.md b/ko/code_editor/instructions.md
index 6bbb782cd1a..900a0c897ba 100755
--- a/ko/code_editor/instructions.md
+++ b/ko/code_editor/instructions.md
@@ -1,27 +1,31 @@
-코드 에디터는 종류가 많고 다양해 자신의 취향에 따라 선택할 수 있어요. 대부분의 파이썬 프로그래머는 PyCharm과 같이 복잡하지만 강력한 IDE(통합개발환경: Integrated Development Environments)를 이용합니다. 하지만 초보자에게 적합하지 않을 수 있어요. 간단하지만 강력한 기능을 갖춘 에디터 프로그램을 아래 추천합니다.
+코드 편집기는 다양하고 많은 종류가 있어 자신의 취향에 따라 선택할 수 있어요. 대부분의 파이썬 프로그래머는 PyCharm 과 같이 복잡하지만 파워풀한 IDE (통합개발환경: Integrated Development Environments) 를 이용합니다. 하지만, 초보자에게는 적절하지 않을 수도 있어요. 우리는 강력한 기능과 함께 간단하게 사용할 수 있는 에디터를 추천해요.
 
-이 중 내가 사용하고 싶은 것을 선택해 사용해도 되지만, 여러분의 코치가 어떤 프로그램을 사용하는지 물어보세요. 같은 프로그램을 사용하면 도움받기 수월해질 거에요.
+아래에 저희의 코드 편집기 권장 사항이 있지만 여러분의 코치들에게 어떤 코드 편집기를 자주 사용하는지도 물어보세요. 코치들에게 도움 받는 것이 더욱 쉬울 거에요.
 
 ## Gedit
-Gedit는 모든 운영체제에서 사용 가능한 무료 오픈소스에요.
 
-[다운받기](https://wiki.gnome.org/Apps/Gedit#Download)
+Gedit는 모든 운영체제에서 사용 가능한 무료 오픈소스에요. 
+
+[이 곳에서 다운받을 수 있어요.](https://wiki.gnome.org/Apps/Gedit#Download)
 
 ## Sublime Text 3
-Sublime Text는 가장 널리 알려진 프로그램으로 무료로 사용할 수 있어요. 설치와 사용이 편리하고 모든 운영체제에서 쓸 수 있어요.
 
-[다운받기](https://www.sublimetext.com/3)
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[이 곳에서 다운받을 수 있어요.](https://www.sublimetext.com/3)
 
 ## Atom
-Atom은 [GitHub](https://github.com/)에서 만든 에디터예요. 무료로 제공되는 오픈소스이며, 설치나 사용이 쉬워요. 윈도우, 맥OS, 리눅스에서 쓸 수 있어요.
 
-[다운받기](https://atom.io/) 
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[이 곳에서 다운받을 수 있어요.](https://atom.io/)
 
 ## 왜 코드 에디터를 설치해야 하나요?
-워드나 노트패드가 있는데도, 굳이 코드 에디터 소프트웨어를 설치해야 하는 이유가 궁금할 거에요.
 
-첫 번째로 코드는 **일반 텍스트**여야 하는데, 워드나 텍스트에딧(Textedit)과 같은 프로그램에서는 일반 텍스트가 아닌 [RTF(Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format)와 같은 사용자 서식을 쓴 리치 텍스트(폰트와 서식이 있는 텍스트)가 생성되기 때문입니다.
+워드나 노트패드가 있는데도, 굳이 코드 에디터 소프트웨어를 설치해야하는 이유가 궁금할거에요.
+
+첫 번째 이유는 코드는 **순수한 텍스트**이여야 합니다. 그런데 Word나 Textedit 같은 프로그램의 문제는, 그 프로그램들이 제대로된 순수한 텍스트를 생성하지 않기 때문입니다. 그들은 [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format)와 같은 커스텀 서식을 쓴 rich 텍스트(폰트와 서식이 있는 텍스트) 를 생성합니다.
 
-두 번째는 코드 에디터 프로그램은 개발에 유용한 여러 기능을 제공하기 때문입니다. 대표적인 예로, 코드를 해석해 문법을 하이라이팅해주는 기능이라든가 큰따옴표("")를 자동으로 닫아주는 기능이지요.
+두 번째 이유는 코드 에디터가 여러분이 개발을 할 때 도움이 되는 여러 기능들을 제공하기 때문이에요. 대표적인 예로, 코드를 해석해서 색으로 문법을 하이라이팅해주는 기능이라든가 쌍따옴표("") 를 자동으로 닫아주는 등과 같은 기능들이지요.
 
-앞으로 코드 에디터가 어떻게 작동하는지 알아볼 거에요. 곧 여러분은 내가 사용하는 코드 에디터를 제일 좋아하게 될 거랍니다.
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ko/css/README.md b/ko/css/README.md
index 06f7eecd9fb..c5212703757 100755
--- a/ko/css/README.md
+++ b/ko/css/README.md
@@ -1,25 +1,22 @@
-# CSS - 예쁘게 만들기
-
-아직 우리가 만든 블로그가 예쁘지 않죠? 이제 눈에 보기 좋게 예쁘게 만들어 볼 시간이에요. CSS를 사용해 만들어볼 거에요.
+# CSS – make it pretty!
 
+우리가 만든 블로그가 아직 예쁘지 않죠? 이제 눈에 보기 좋게 예쁘게 만들어 볼 시간이에요. CSS를 사용해 만들어볼 거에요.
 
 ## CSS는 무엇인가요?
 
-CSS(Cascading Style Sheets)는 HTML와 같이 마크업언어(Markup Language)로 작성된 웹사이트의 외관을 꾸미기 위해 사용되는 언어입니다. 웹사이트에 메이크업을 해볼까요. ;)
-
-아무것도 없는 상태에서 시작하기 어렵겠죠? 개발자들이 만든 오픈 소스 코드를 사용해 만들어 볼 거에요. 이미 있는 바퀴를 다시 발명하는 것은 재미가 없잖아요.
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
 
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
 
-## 부트스트랩을 사용해봐요!
+## Bootstrap을 사용해봐요!
 
-부트스트랩(Bootstrap)은 유명한 HTML과 CSS프레임워크로 예쁜 웹사이트를 만들 수 있습니다. : https://getbootstrap.com/
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
 
-트위터 개발자들이 부트스트랩을 만들었고, 전 세계 자원봉사자들이 지속적으로 참여해 발전시키고 있어요!
+부트스트랩은 트위터 개발자들에 의해 만들어졌고 전 세계 자원봉사자들이 지속적으로 참여해 발전시키고 있어요.
 
+## Bootstrap 설치하기
 
-## 부트스트랩 설치하기
-
-부트스트랩을 설치하려면, `.html`파일 내 `<head>`에 이 링크를 넣어야 합니다.
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
@@ -28,93 +25,91 @@ CSS(Cascading Style Sheets)는 HTML와 같이 마크업언어(Markup Language)
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
 ```
 
-이 링크는 프로젝트에 새 파일을 추가하는 게 아니에요. 인터넷에 있는 파일을 연결하는 거죠. 이제 웹사이트를 열어 새로고침 버튼을 눌러보세요. 짠!
-
-![Figure 14.1](images/bootstrap1.png)
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
 
-어때요, 보기 좋아졌죠!
+![그림 14.1](images/bootstrap1.png)
 
+더 보기 좋아졌죠!
 
-## 정적 파일
+## Django의 정적 파일
 
-마지막으로 __정적 파일(static files)__ 을 다뤄볼 거에요. 정적 파일은 CSS와 이미지 파일에 해당합니다. 이 컨텐츠는 요청 내용에 따라 바뀌는 것이 아니기 때문에 모든 사용자들이 동일한 내용을 볼 수 있어요.
+마지막으로 **정적 파일(static files)**을 다뤄볼 거에요. 모든 CSS와 이미지들은 정적 파일(static file) 이에요. Css와 정적파일은 모든 유저들이 동일하게 보여지기 때문에 콘텐츠와 상관없어요.
 
+### 어디에 정적 파일을 넣어야 하나요
 
-### 정적 파일은 어디에 넣어야 하나요
+서버에서 `collectstatic`를 실행할 때 처럼, 장고는 "admin" 앱에서 동적 파일을 어디서 찾아야하는지 이미 알고 있어요. 이제 `blog`앱에 동적파일을 추가하면 되어요.
 
-서버에서 `collectstatic`를 실행할 때 처럼, 장고는 "admin"앱에서 정적 파일을 어디서 찾아야하는지 이미 알고 있어요. 이제 "blog"앱에 정적파일을 추가하면 됩니다.
+blog앱 안에 `static`폴더를 만드세요:
 
-"blog"앱 안에 `static`라는 새 폴더를 만드세요. :
-
-```
     djangogirls
     ├── blog
     │   ├── migrations
-    │   └── static
+    │   ├── static
+    │   └── templates
     └── mysite
-```
-
-장고는 app 폴더 안에 있는 `static`폴더를 자동으로 찾을 수 있어요. 이 컨텐츠를 정적 파일로 사용하게 되는 것입니다.
+    
 
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
 
 ## 나의 첫 번째 CSS 파일!
 
-CSS파일을 만들어 나만의 스타일을 가진 웹페이지를 만들어봐요. `static`디렉토리 안에 `css`라고 새로운 디렉토리를 만드세요. 그리고 `css`디렉토리 안에 `blog.css`라는 파일을 만드세요. 준비되셨나요?
+Let's create a CSS file now, to add your own style to your web page. `static` 디렉토리 안에 `css`라고 새로운 디렉토리를 만드세요. 그리고 `css`디렉토리 안에 `blog.css`라는 파일을 만드세요. 준비되셨나요?
 
-```
     djangogirls
     └─── blog
          └─── static
               └─── css
                    └─── blog.css
-```
+    
 
-CSS를 쓸 차례예요! 코드 에디터에서 `blog/static/css/blog.css`파일을 열어보세요.
+CSS를 쓸 차례에요! 여러분이 사용하고 있는 코드에디터에서 `blog/static/css/blog.css`파일을 불러오세요.
 
-CSS는 꽤 쉽고 워크샵 후에도 스스로 배울 수 있기 때문에 CSS에 대해 깊이 살펴보지는 않을 거에요. 이 장 맨 마지막 부분에 추천하는 무료 사이트가 있습니다.
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
 
-하지만 조금이라도 해보자구요. 제목 색상을 바꿔볼까요? 컴퓨터는 특별한 코드를 사용해 색상을 나타내요. `#`으로 시작해 알파벳(A-F)와 숫자(0-9) 중 6개를 조합해 헥사코드(hexacode)로 나타냅니다. 이 곳에서 원하는 색상 코드를 찾을 수 있어요. [https://www.colorpicker.com/](https://www.colorpicker.com/) 또는 `빨간색(red)` 또는 `녹색(green)` 등 [미리 명시된 색상](http://www.w3schools.com/colors/colors_names.asp)을 사용할 수 있어요.
+하지만 조금이라도 해보자구요. 제목 색깔을 바꿔볼까요? 컴퓨터는 특별한 코드를 사용해 색깔을 나타내요. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). 예를 들어, 파란색 코드는 `#0000FF`입니다. 더 많은 색상 코드는 다음 링크에서 찾을 수 있어요: http://www.colorpicker.com/ You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
 
-`blog/static/css/blog.css` 파일에 아래 코드를 추가하세요. :
+`blog/static/css/blog.css`에 아래의 코드를 추가하세요.
 
 {% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 h1 a {
     color: #FCA205;
 }
 ```
 
-`h1 a`는 CSS 셀렉터(Selector)라고 합니다. `h1`요소 안에 어떠한 `a`요소를 넣어 스타일을 적용 할 수 있다는 거죠. 예를 들어 `<h1><a href="">link</a></h1>` 라면, 오렌지색 `#FCA205`으로 바꿀 수 있어요. 물론, 내가 원하는 다른 색상을 지정할 수 있어요!
+`h1 a`가 CSS 셀렉터(Selector)에요. `h1`대신 `a`스타일을 적용하라는 뜻입니다. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. 예를 들어, 오랜지 색상은 `#FCA205`입니다. 물론, 색상을 직접 선택할 수도 있어요!
 
-CSS 파일에서는 HTML 파일에 있는 각 요소들에 스타일을 정의할 수 있어요. 요소를 식별하는 첫 번째 방법은 요소 이름을 사용하는 것입니다. HTML 섹션에서 태그로 기억할 수 있습니다. `a`,`h1`,`body`와 같은 것은 모두 요소 이름의 예입니다. 또 `class` 속성이나 `id` 속성에 의해 요소를 식별합니다. 클래스와 ID는 요소에 직접 부여한 이름이에요. 클래스는 요소 그룹을 정의하고 ID는 특정 요소를 가리킵니다. 아래 코드와 같이 태그 이름은 `a`, 클래스는 `external_link` 또는 ID는 `link_to_wiki_page`로 사용하여 태그를 통해 요소를 식별할 수 있습니다.
+CSS파일에서는 HTML 파일에 있는 각 요소들에 스타일을 적용할 수 있어요. 요소를 식별하는 첫 번째 방법은 이름을 붙이는 겁니다. HTML에서 태그 이름으로 찾을 수 있겠죠. `a`, `h1`, `body`요소도 그 예입니다. 상속 `class` 또는 상속 `id`로 요소를 식별합니다. Class와 id는 여러분들이 붙인 이름을 갖게 되지요. 클래스는 요소들의 그룹을 결정하는 것이고, id는 특정 요소들을 지칭해요. 예를 들어, 다음 태그들은 css에서 태그 이름 `a`, 클래스 `external_link`, id `link_to_wiki_page`을 사용해서 식별해요.
 
 ```html
 <a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
 ```
 
-W3Schools에서 [CSS 선택자](https://www.w3schools.com/cssref/css_selectors.asp)에 대해 읽어보시길 바랍니다.
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
 
-이제 CSS를 HTML에 추가해봅시다. `blog/templates/blog/post_list.html` 파일을 열고 맨 처음 줄에 이 라인을 추가하세요.
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 ```
 
-여기에서 동적 파일을 로딩하는 거에요. :)
-다음 `<head>`와 `</head>` 사이에 부트스트랩 CSS파일 링크 다음에 아래 코드를 추가하세요.
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <link rel="stylesheet" href="{% static 'css/blog.css' %}">
 ```
 
-브라우저는 주어진 순서대로 파일을 읽으므로 파일이 올바른 위치에 있는지 확인해야합니다. 그렇지 않으면 파일 코드가 부트 스트랩 파일의 코드를 무시할 수 있습니다.
-이제까지 CSS파일이 있는 템플릿에 대해 알아보았어요.
+브라우저는 순서대로 차례차례 파일을 읽기 때문에, 올바른 곳에 배치해야해요. Otherwise the code in our file may be overriden by code in Bootstrap files. 이제까지 CSS파일이 있는 템플릿에 대해 알아보았어요.
 
-코드는 아래와 같아야 해요.
+여러분이 만든 파일은 아래와 같아야해요.
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -142,34 +137,36 @@ W3Schools에서 [CSS 선택자](https://www.w3schools.com/cssref/css_selectors.a
 
 자, 이제 파일을 저장하고 새로고침을 해보세요!
 
-![Figure 14.2](images/color2.png)
+![그림 14.2](images/color2.png)
 
 잘했어요! 웹사이트 왼쪽 여백을 좀더 주고 싶지 않나요? 한번 해봐요!
 
 {% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 body {
     padding-left: 15px;
 }
 ```
 
-이 코드를 CSS에 붙여넣고, 파일을 저장하고 어떻게 바뀌었는지 확인해봐요!
+Add that to your CSS, save the file and see how it works!
 
-![Figure 14.3](images/margin2.png)
+![그림 14.3](images/margin2.png)
 
-제목 폰트를 바꾸고 싶나요? `blog/templates/blog/post_list.html` 파일 내 `<head>`부분에 아래 코드를 붙여넣기 해보세요.
+제목의 폰트를 바꾸고 싶나요? `blog/templates/blog/post_list.html`파일 안에 `<head>`에 아래 코드를 붙여넣기 해보세요.
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
 ```
 
-`blog/static/css/blog.css` 파일 내 넣은 코드의 순서와 위치를 다시 확인해보세요. 이 라인은 Google 글꼴 (https://www.google.com/fonts)에서 * Lobster* 라는 글꼴을 가져온 것을 말해요.
-
-그리고 CSS파일  `blog/static/css/blog.css` 에서`h1 a` 선언 블록 (중괄호`{`와`}`) 사이의 코드를 찾으세요. `font-family : 'Lobster';` 를 중괄호 사이에 추가하고 페이지를 새로고침 합니다.
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
 
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
 
 {% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 h1 a {
     color: #FCA205;
@@ -177,23 +174,26 @@ h1 a {
 }
 ```
 
-![Figure 14.3](images/font.png)
+![그림 14.3](images/font.png)
 
 잘했어요!
 
-앞서 말했듯이, CSS는 클래스 개념을 가지고 있어요. 클래스는 HTML의 코드 일부에 이름을 붙이고 그 부분만 특정 스타일을 적용할 수 있게 해줍니다. 각기 다른 div를 (예를 들어 하나는 제목에 있고 하나는 글 본문에 있는 경우) 구분할 때 정말 유용해요. HTML 코드의 일부 이름을 지정하십시오. 
+위에서 언급했듯이, CSS는 클래스 개념을 가지고 있습니다. HTML 코드 내 이름을 지정해 다른 부분에 영향을 주지 않고 특정 부분에만 스타일을 적용할 수 있습니다. 정말 멋지죠! 두 div를 사용해 제목과 게시글이 다르게 보이게 만들 수도 있어요. 이처럼 클래스는 겉모습을 다르게 바꿔줍니다.
 
-제목이 포함된 `div`에 `page-header`라는 클래스명을 붙여보세요. :
+이제 HTML 코드의 일부에 이름을 붙여봅시다. header에 포함된 `div`에 `page-header`라고 class 이름을 붙여봅시다. 다음과 같이 말이죠:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="page-header">
     <h1><a href="/">Django Girls Blog</a></h1>
-</div>```
+</div>
+```
 
-그리고 블로그 게시글을 나타내는 `div`에 `post`라고 클래스명을 붙여보세요.
+그리고 이제 블로그 글 안에 있는 `div`에 `post`라고 class 이름을 붙여보세요.
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="post">
     <p>published: {{ post.published_date }}</p>
@@ -202,10 +202,10 @@ h1 a {
 </div>
 ```
 
-이제 여러 선택자들을 추가해봅시다. 클래스 선택자는 `.`으로 시작합니다. 인터넷에 많은 CSS 튜토리얼과 설명 가이드가 있으니 찾아보면 도움이 될 거에요. 이제 `blog/static/css/blog.css` 파일에 아래 코드를 복사, 붙여넣기 하세요.
-
+다음 각 다른 선택자(selector) 에 정의를 붙여볼거에요. 클래스를 나타내는 선택자는 `.`으로 시작합니다. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. 이제 `blog/static/css/blog.css`파일안에 아래 코드를 복사, 붙여넣기 하세요:
 
 {% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 .page-header {
     background-color: #ff9400;
@@ -255,9 +255,10 @@ h1, h2, h3, h4 {
 }
 ```
 
-자, 다음은 글을 보여주는 HTML 코드를 post라는 클래스 명을 선언해 div로 감싸세요. 이렇게 바꾸면 됩니다. :
+자, 다음은 글을 보여주는 HTML 코드를 post라는 클래스 이름이 적힌 div로 감싸세요. 그러면 다음과 같을 거에요.
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     <div class="post">
@@ -267,9 +268,11 @@ h1, h2, h3, h4 {
     </div>
 {% endfor %}
 ```
-`blog/templates/blog/post_list.html` 파일 안에 아래 코드를 넣으세요.
+
+`blog/templates/blog/post_list.html` 안에 아래 코드를 넣으세요.
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="content container">
     <div class="row">
@@ -288,14 +291,14 @@ h1, h2, h3, h4 {
 </div>
 ```
 
-파일을 저장하고 웹 사이트를 새로고침하세요.
+파일을 저장하고 웹사이트를 새로고침하세요.
 
-![Figure 14.4](images/final.png)
+![그림 14.4](images/final.png)
 
-방금 붙여 넣은 코드를보고 HTML에 클래스를 추가하고 CSS에서 사용했던 곳을 찾아보세요. 날짜를 초록색으로 바꾸려면 어느 부분을 수정하면 될까요?
+와! 멋지지 않나요? 붙여넣기한 HTML 클래스와 CSS 코드를 보세요. 초록색으로 날짜를 바꾸려면 어느 곳을 고쳐야할까요?
 
-CSS를 바꿔보는 것을 두려워하지 마세요. CSS를 가지고 놀다보면 어떻게 작동되는지 좀더 이해할 수 있을 거에요. 망가뜨렸더라도 괜찮아요. 언제든지 되돌릴 수 있으니까요!
+CSS를 고치는 것을 두려워하지 말고, 편하게 고치고 싶은 것을 수정해보세요. 이것저것 고쳐보면서 CSS와 놀아보면 금방 이해할 수 있게 된답니다. If you break something, don't worry – you can always undo it!
 
-무료 온라인 [Codecademy HTML & CSS 코스](https://www.codecademy.com/tracks/web)를 수강해보는 것을 추천합니다. CSS로 웹 사이트를 더 아름답게 만드는 방법을 배울 수 있어요.
+[Codeacademy HTML & CSS 강좌](https://www.codecademy.com/tracks/web)를 수강하는 것을 강력히 추천합니다. CSS로 근사한 웹 사이트를 만들 수 있는 모든 방법을 배울 수 있답니다.
 
-다음 장을 읽을 준비가 되셨나요?! :)
+다음 장을 읽을 준비됐나요?! :)
\ No newline at end of file
diff --git a/ko/deploy/README.md b/ko/deploy/README.md
index d3da38552a9..03b11e2dacd 100755
--- a/ko/deploy/README.md
+++ b/ko/deploy/README.md
@@ -1,294 +1,260 @@
 # 배포하기!
 
-> **Note** 이번 장은 조금 따라 하기 어려울 수도 있습니다. 하지만 끝까지 따라와 주세요. 배포는 웹 사이트 개발의 가장 중요한 부분이에요. 튜토리얼 중간에 배포 내용이 있는 이유는 코치가 웹사이트를 온라인으로 배포하는 까다로운 과정을 도와줄 수 있기 때문이에요. 시간이 부족하면 혼자서 해볼 수 있을 겁니다.
+> **참고**: 이번 장은 따라오기 조금 힘들 수도 있어요. 끝까지 따라와주세요. 배포는 웹사이트 개발의 가장 중요한 부분이에요. 튜토리얼 중간에 이번 장이 있는 이유는 여러분이 코치가 웹사이트를 온라인에서 볼 수 있게 도와주기 위해서에요. 시간이 모자르더라도 튜토리얼을 끝낼 수 있어요.
 
-지금까지는 웹사이트를 내 컴퓨터에서만 볼 수 있었어요. 지금부터 웹사이트를 배포방법을 배워봅시다! 배포(deployment)는 애플리케이션을 인터넷에 올려놓아 다른 사람들도 볼 수 있게 해주는 것 말해요. :)
+지금까지는 웹사이트를 내 컴퓨터에서만 볼 수 있었어요. 이제 어떻게 웹사이트를 배포하는지 배워봅시다. 배포(deploy) 는 애플리케이션을 인터넷에 올려놓아 다른 사람들도 볼 수 있게 해주는 것 말해요. :)
 
-앞에서 배웠듯이, 웹사이트는 서버라는 곳에 들어갑니다. 인터넷 상에 서버를 제공하는 업체들은 참 많습니다. 우리는 이 중에 비교적 배포 과정이 간단한 [PythonAnywhere](https://pythonanywhere.com/)을 사용할 거에요. PythonAnywhere는 방문자가 아주 많지 않은 소규모 애플리케이션을 위한 무료 서비스를 제공하고 있습니다. 지금 우리가 만드는 웹사이트도 해당됩니다. 
+앞에서 배웠듯이, 웹사이트는 서버라는 곳에 들어가요. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
-우리가 사용할 다른 외부 서비스는 [GitHub](https://github.com/)이라는 코드 호스팅 서비스입니다. 요즘에는 모든 프로그래머들은 Github 계정을 가지고 있으니, 여러분도 Github 계정을 만들어봐요!
+우리가 사용할 다른 서비스는 [GitHub](https://www.github.com)라는 코드 호스팅 서비스입니다. 프로그래머들이 애용하는 곳들 중 하나로 대부분의 모든 프로그래머가 GitHub 계정을 가지고 있다고 봐도 될 거예요. 이제 여러분도 하나 만들 때가 되었어요!
 
-로컬컴퓨터, Github, Pythonanywhere 이 세 곳은 모두 중요해요. 로컬 컴퓨터는 개발 및 테스트를 수행하는 곳이 될 것입니다. 개발이 완료되면 프로그램 복사본을 GitHub에 저장합니다. 웹사이트는 PythonAnywhere에 있고 GitHub에서 코드 사본을 업데이트할 거에요.
+이 세 가지는 매우 중요합니다. 로컬 컴퓨터에서는 개발 및 테스트를 수행할 거에요. 원하는 결과물을 얻게 되었다면, 그대로 GitHub에 복사본을 올려둘 거에요. PythonAnywhere에 웹 사이트가 올려질 거고, GitHub에서 새로운 복사본을 가져와 업데이트 될 거에요.
 
-# Git 설치하기
-> **Note** 이미 설치가 완료되었다면, 다시 할 필요가 없어요. 다음 장으로 넘어가서 Git 저장소를 만드는 것부터 시작하세요.
-
-{% include "/deploy/install_git.md" %}
-
-## Git 저장소 만들기
-
-Git은 코드 저장소(repository: 줄여서 "repo"라고 합니다)에 특정한 파일들 집합의 변화를 추적하여 관리합니다. 이제 프로젝트를 시작해 볼까요? 콘솔 창을 열고 `djangogirls` 디렉터리에서 아래 명령어들을 실행하세요.
-
-> **Note** 저장소를 초기화하기 전에 여러분의 현재 작업 디렉터리가 어디인지 꼭 확인하세요. 맥OS나 Linux라면 `pwd` 명령으로, 윈도우라면 `cd` 명령어를 실행하면 알 수 있을 거예요. 반드시 `djangogirls` 폴더에서 해야 합니다.
-
-{% filename %}command-line{% endfilename %}
-```
-$ git init
-Initialized empty Git repository in ~/djangogirls/.git/
-$ git config --global user.name "Your Name"
-$ git config --global user.email you@example.com
-```
-
-git 저장소 초기화는 프로젝트를 시작할 때 딱 한 번만 필요합니다. (username과 email 등록 명령은 계속 적용되기 때문에 이 계정에서는 다시 입력할 필요가 없습니다)
-
-git은 이 디렉터리에 모든 파일과 폴더들의 변경 점을 추적할 것인데, 특정 파일들을 무시(ignore)하여 추적하지 않게 할 수 있습니다. 기본 디렉터리에 `.gitignore`라는 파일을 만들면 됩니다. 에디터를 열어 아래 내용을 넣어주세요. :
-
-{% filename %}.gitignore{% endfilename %}
-```
-*.pyc
-*~
-__pycache__
-myvenv
-db.sqlite3
-/static
-.DS_Store
-```
-
-그리고 `djangogirls` 폴더의 맨 위에다 `.gitignore` 라는 파일로 저장하세요.
-
-> **Note** 파일명 앞에 마침표로 시작하는 것이 중요합니다! 만약 파일을 만드는 것이 어렵다면 (예를 들어 맥은 파인더에서 마침표로 시작하는 파일을 생성하는 걸 좋아하지 않아요) `다른 이름으로 저장(Save As)` 기능을 사용하세요.
-
-> **Note** `.gitignore` 파일에 있는 `db.sqlite3`이라는 파일은 모든 게시물이 저장된 로컬 데이터베이스입니다. PythonAnywhere는 다른 데이터베이스를 사용하기 때문에 저장소에 추가될 필요가 없습니다. 다른 데이터베이스로는 SQLite로도 사용하지만 보통은 SQLite보다 훨씬 많은 방문자를 보유한 웹사이트일 경우 MySQL을 사용합니다. GitHub 저장소에 SQLite 데이터베이스를 제외하고 저장하면, 지금까지 작성한 모든 게시물을 로컬에서만 사용할 수 있으므로 실제 운영하는 프로덕션 환경에서는 다시 새 데이터베이스를 추가해야합니다. 로컬 데이터베이스는 데이터가 삭제되도 괜찮은 테스트 공간으로만 사용하세요.
-
-`git add`하기 전이나 변경된 것이 있는지 잘 모를 때마다 `git status`명령어를 사용하는 것은 좋은 방법이에요. 잘못된 파일이 추가되거나 커민된 경우, 이를 복구할 수 있습니다. `git status`명령은 미추적/수정된/스테이지된 파일, 브랜치 상태와 그 외 많은 정보를 보여줍니다. 실행하면 아래와 비슷하게 나타날 거에요.
+# Git
 
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
 
-{% filename %}command-line{% endfilename %}
-```
-$ git status
-On branch master
-
-Initial commit
-
-Untracked files:
-  (use "git add <file>..." to include in what will be committed)
+{% include "/deploy/install_git.md" %}
 
-        .gitignore
-        blog/
-        manage.py
-        mysite/
+## Git 저장소(repository) 만들기
 
-nothing added to commit but untracked files present (use "git add" to track)
-```
+Git은 코드 저장소(줄여서 "repo"라고 합니다.)에 특정한 파일들 집합의 변화를 추적하여 관리합니다. 이제 프로젝트를 시작해볼까요? 콘솔창을 열어서 `djangogirls` 디렉토리에서 아래 명령어들을 실행하세요. 아래 명령 중에서 Your Name 대신 여러분의 이름을, you@example.com 대신에 여러분의 이메일 주소를 입력하세요.
 
-자 이제 우리가 만든 코드들을 저장소에 넣어봅시다. 콘솔 창에 가서 다음 명령어를 실행하세요.
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. 반드시 `djangogirls` 폴더에서 해야합니다.
 
 {% filename %}command-line{% endfilename %}
-```
-$ git add --all .
-$ git commit -m "My Django Girls app, first commit"
- [...]
- 13 files changed, 200 insertions(+)
- create mode 100644 .gitignore
- [...]
- create mode 100644 mysite/wsgi.py
- ```
 
-## GitHub에 코드 배포하기
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
 
-[GitHub.com](https://github.com/)에서 새 무료 계정을 만드세요. (워크샵 전에 미리 가입했다면 더 좋죠!)
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
 
-그 다음 새 저장소(new repository)를 "my-first-blog"라는 이름으로 생성하세요. "README 파일과 초기화 하기(initialize with a README)" 체크박스는 체크안 한 상태로 두세요. .gitignore 옵션도 비어있는 상태(위에서 만들었죠?)로 두세요. 라이센스도 비워두세요.
+Git은 이 디렉토리에 모든 파일들과 폴더들의 변경점을 추적할 거에요. 무시(ignore) 하도록 지정한 파일들을 제외하고는 말이죠. 기본 디렉토리에다 `.gitignore`라는 파일을 만들어서 특정 파일이나 폴더를 추적하지 않도록 할 수 있습니다. 에디터를 열어서 아래 내용을 넣어주세요:
 
-<img src="images/new_github_repo.png" />
-
-> **Note** 저장소 이름 `my-first-blog`는 중요합니다. - 물론 내가 원하는 이름으로 바꿀 수 있지만, 매번 변경해서 사용해야 하니 정말 불편할 거에요. 되도록 `my-first-blog`라는 저장소 이름을 그대로 사용하는 것을 권장합니다.
+{% filename %}.gitignore{% endfilename %}
 
-다음 화면에서 저장소 복제 URL(repo's clon URL)을 볼 수 있을 거예요. "HTTPS" 버전을 선택해서 그 주소를 복사하세요. 그리고 터미널에다 붙여넣으세요.
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
 
-<img src="images/github_get_repo_url_screenshot.png" />
+"djangogirls"폴더에 `.gitignore`파일을 저장하세요.
 
-이제 내 컴퓨터의 Git 저장소를 GitHub에 있는 저장소로 연결해야합니다.
+> **주의**: 파일명 앞에 마침표로 시작하는 것이 중요합니다! 꼭 붙여주세요. If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. 로컬 데이터베이스를 놀이터처럼 생각하고 이것저것 테스트해보세요. 실제 블로그 내 게시글이 삭제되지 않으니 걱정하지 마세요.
 
-콘솔에 다음과 같이 입력하세요. (`<your-github-username>`에 꺽쇠괄호(<>)를 떼고 내 Github 사용자이름을 입력하세요)
+`git add`하기 전이나 변경된 것이 있는지 잘 모를 때마다 `git status` 명령어를 사용하는 것은 좋은 방법이에요. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
 
 {% filename %}command-line{% endfilename %}
-```
-$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
-$ git push -u origin master
-```
 
-아래와 같은 화면이 나오면 GitHub 사용자이름과 암호를 입력하세요. :
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+자 이제 우리가 만든 코드들을 저장소에 넣어봅시다. 콘솔창에 가서 다음 명령어를 실행하세요:
 
 {% filename %}command-line{% endfilename %}
-```
-Username for 'https://github.com': hjwp
-Password for 'https://hjwp@github.com':
-Counting objects: 6, done.
-Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
-Total 3 (delta 0), reused 0 (delta 0)
-To https://github.com/hjwp/my-first-blog.git
- * [new branch]      master -> master
-Branch master set up to track remote branch master from origin.
-```
-
-
-<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
 
-이제 여러분의 코드가 gitHub에 저장됐어요! 가서 확인해보세요! [Django](https://github.com/django/django), [장고걸스 튜토리얼][https://github.com/DjangoGirls/tutorial]뿐만 아니라 수많은 훌륭한 오픈소스 소프트웨어 프로젝트들이 gitHub에서 호스팅하고 있어요. 방금 여러분이 한 것처럼 말이죠. :)
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': 여러분의GitHub유저네임 Password for 'https://hjwp@github.com': 여러분의GitHub암호 Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. 가서 확인해보세요!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    GitHub에 있는 코드를 끌어와 저장소를 "복제"해 PythonAnywhere로 탑재해볼게요. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
 
-# PythonAnywhere에 블로그 설정하기
-
-> **Note** 설치하기 장에서 PythonAnywhere 계정을 만들었다면 이 부분을 건너뛰세요.
-
-{% include "/deploy/signup_pythonanywhere.md" %}
-
-
-## GitHub에서 PythonAnywhere로 코드 가져오기
-
-PythonAnywhere에 가입하면 대시보드 또는 "콘솔(Consoles)" 페이지를 볼 수 있을 거예요. "배시(Bash)" 콘솔로 시작하는 옵션을 선택하세요. - PythonAnywhere 버전의 콘솔로 PC에 있는 커맨드라인 같은 것으로 생각해도 됩니다.
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-> **Note** PythonAnywhere는 리눅스 기반으로 윈도우의 커맨드라인 창과 조금 다르게 보일 수 있어요.
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
 
-gitHub에 있는 코드를 끌어와 저장소를 "복제"해 PythonAnywhere로 탑재해 볼게요. PythonAnywhere 콘솔에 다음과 같이 입력하세요. (`<your-github-username>`대신 내 GitHub 사용자 이름을 입력하는 것을 잊지 마세요) :
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-{% filename %}PythonAnywhere command-line{% endfilename %}
-```
-$ git clone https://github.com/<your-github-username>/my-first-blog.git
-```
-
-PythonAnywhere에 코드 복사본을 올릴 거에요. `tree my-first-blog` 명령어를 입력해 확인해보세요. :
-
-{% filename %}PythonAnywhere command-line{% endfilename %}
-```
-$ tree my-first-blog
-my-first-blog/
-├── blog
-│   ├── __init__.py
-│   ├── admin.py
-│   ├── migrations
-│   │   ├── 0001_initial.py
-│   │   └── __init__.py
-│   ├── models.py
-│   ├── tests.py
-│   └── views.py
-├── manage.py
-└── mysite
-    ├── __init__.py
-    ├── settings.py
-    ├── urls.py
-    └── wsgi.py
-```
-
-### PythonAnywhere에서 가상환경(virtualenv) 생성하기
-
-PythonAnywhere에서도 내 컴퓨터에 있는 것과 같이 작동할 수 있게 가상환경(virtualenv)을 생성할 수 있어요. 배시 콘솔(Bash console)에 다음과 같이 입력하세요. :
-
-{% filename %}PythonAnywhere command-line{% endfilename %}
-```
 $ cd my-first-blog
 
-$ virtualenv --python=python3.6 myvenv
-Running virtualenv with interpreter /usr/bin/python3.6
-[...]
-Installing setuptools, pip...done.
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
 
 $ source myvenv/bin/activate
 
-(myvenv) $  pip install django~=1.11.0
-Collecting django
-[...]
-Successfully installed django-1.11.3
-```
-
-> **Note** `pip install`은 설치가 될 때까지 인내심이 조금 필요해요. 하지만 몇 분 안에 완료될 거니 조금만 기다려보세요. 만약 5분 이상 시간이 지났다면, 무엇인가 잘못된 거니 코치에게 물어보세요.
-
-<!--TODO: think about using requirements.txt instead of pip install.-->
-
-### PythonAnywhere에서 데이터베이스 생성하기
-
-컴퓨터와 서버가 다른 점이 또 하나 있어요. 바로 다른 데이터베이스를 사용한다는 점이에요. 그래서 사용자 계정과 글은 서버와 여러분의 컴퓨터와 다를 수 있어요.
-
-지난번 내 컴퓨터에서 했던 것과 같이 서버에서도 데이터베이스를 초기화 할 거예요. `migrate`와 `createsuperuser`를 사용하세요. :
-
-{% filename %}PythonAnywhere command-line{% endfilename %}
-```
-(mvenv) $ python manage.py migrate
-Operations to perform:
-[...]
-  Applying sessions.0001_initial... OK
-(mvenv) $ python manage.py createsuperuser
-```
-
-## web app으로 블로그 배포하기
-
-이제 코드는 PythonAnywhere에 있고 우리의 가상환경(virtualenv)도 준비가 되었으며, 정적 파일들도 모여 있고, 데이터베이스도 초기화되었네요. 이제 우리는 웹 앱으로 배포할 준비가 되었어요.
-
-로고를 클릭해 PythonAnywhere 대시보드로 와서 **Web**을 클릭하고 **Add a new web app**를 선택하세요.
-
-도메인 이름을 확정한 후, 대화창에 **수동설정(manual configuration)** ("Django"옵션이 *아니에요*) 을 클릭하세요. 다음, **Python 3.6**을 선택하고 다음(Next)을 클릭하면 마법사가 종료됩니다.
-
-> **Note** "Django"가 아니라 꼭 "수동설정(Manual configuration)"을 선택하세요. 기본 PythonAnywhere Django 설정을 위해서는 이렇게 하는 것이 더 좋아요. ;-)
-
-### 가상환경(virtualenv) 설정하기
-
-PythonAnywhere 설정 화면으로 이동할 거에요. 서버 앱에 변경사항이 있을 때 이 설정 화면으로 들어가야 합니다.
-
-<img src="images/pythonanywhere_web_tab_virtualenv.png" />
-
-"가상환경(Virtualenv)" 섹션에서 `가상환경 경로를 입력해주세요(Enter the path to a virtualenv)`라고 쓰여 있는 빨간색 글자를 클릭하고 `/home/<your-username>/my-first-blog/myvenv/` 라고 입력합니다. 이동 경로 저장을 하려면 파란색 박스에 체크 표시를 하고 클릭하세요.
-
-> **Note** PythonAnywhere 사용자 이름을 변경하세요. 실수하면 PythonAnywhere는 경고 메시지를 보여줄 거에요.
-
-
-### WSGI 파일 설정하기
-
-장고는 "WSGI 프로토콜(WSGI protocol"을 사용해 작동합니다. 이 프로토콜은 파이썬을 이용한 웹사이트를 서비스하기 위한 표준으로 PythonAnywhere에서도 지원합니다. WSGI 설정을 파일을 수정해 우리가 만든 장고 블로그를 PythonAnywhere에서 인식하게 해봅시다.
-
-"WSGI 설정 파일(WSGI configuration file)" 링크(페이지 상단에 있는 "코드(Code)" 섹션 내 `/var/www/<your-username>_pythonanywhere_com_wsgi.py`부분)를 클릭하면 에디터를 볼 수 있을 것입니다.
-
-모든 내용을 삭제하고 아래 내용을 넣으세요. :
-
-{% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
-```python
-import os
-import sys
-
-path = '/home/<your-PythonAnywhere-username>/my-first-blog'  # PythonAnywhere 계정으로 바꾸세요.
-if path not in sys.path:
-    sys.path.append(path)
-
-os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
-
-from django.core.wsgi import get_wsgi_application
-from django.contrib.staticfiles.handlers import StaticFilesHandler
-application = StaticFilesHandler(get_wsgi_application())
-```
-
-> **Note** `<your-PythonAnywhere-username>`을 PythonAnywhere 사용자 이름으로 바꾸는 것을 잊지 마세요.
-> **Note** 4번째 라인은 파이썬이 어디서나 응용 프로그램을 찾는 방법을 알고 있는지 확인합니다. 경로명은 공백없이 정확하게 작성해야합니다. 그렇지 않으면 "ImportError"라는 오류 로그가 발생합니다.
-
-이 파일은 PythonAnywhere에게 웹 애플리케이션의 위치와 Django 설정 파일명을 알려주는 역할을 합니다.
-
-`StaticFilesHandler`는 CSS를 다루기 위한 것입니다. `runserver` 명령으로 로컬 개발 중에 자동으로 처리됩니다. 튜토리얼의 뒷부분에서 CSS를 작성할 때 정적 파일에 대해 좀 더 알아볼 것입니다.
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+이 파일은 웹이 올라간 PythonAnywhere에게 Django 설정 파일 이름을 알려주는 역할을 해요.
+
+`StaticFilesHandler`는 CSS처리를 합니다. `runserver` 명령어로 로컬 개발 환경에서 자동으로 처리됩니다. 정적파일에 대해서는 튜토리얼 뒷부분에 나오는 CSS 부분에서 좀 더 자세히 알아볼게요.
 
 **저장(Save)**을 누르고 **웹(Web)** 탭을 누릅니다.
 
-다 되었어요! 큰 녹색 **다시 불러오기(Reload)** 버튼을 누르면 여러분은 여러분의 애플리케이션을 볼 수 있을 거예요. 여러분은 페이지 최상단에 가는 링크를 발견할 수 있을 거예요.
+다 되었어요! 큰 녹색 **다시 불러오기(Reload)** 버튼을 누르면 여러분은 여러분의 어플리케이션을 볼 수 있을 거에요. 여러분은 페이지 최 상단에 가는 링크를 발견할 거에요.
 
 ## 디버깅 팁
 
-본인의 사이트에 접속할 때 오류가 보이면, 제일 먼저 **error log(오류 로그)**에서 디버깅 정보를 찾아보세요. PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/)에서 이 링크를 찾을 수 있어요. 여기서 오류 메시지가 있는지 확인하세요. 대부분의 가장 최근의 오류 메시지는 맨 하단에 있어요. 일반적으로 많이 일어나는 문제들은 아래와 같습니다.:
-
-*   virtualenv를 생성하고 활성화할 때, Django를 설치할 때, Collestac을 돌릴 때, 데이터베이스를 설치할 때 같은 각 단계를 위한 콘솔 작업을 할 때 한 단계를 빼먹는 경우
+본인의 사이트에 접속할 때 오류가 보이면, 제일 먼저 **error log(오류 로그)**에서 디버깅 정보를 찾아보세요. PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/)에서 이 링크를 찾을 수 있어요. 여기서 오류 메세지가 있는지 확인하세요. 대부분의 가장 최근의 오류 메세지는 맨 하단에 있어요. 일반적으로 다음과 같은 점들일 수 있습니다:
 
-*   web tab에서 virtualenv 경로를 쓸 때 오타가 났을 때 - 이런 경우 빨간 작은 에러 메시지가 뜰 것입니다.
+- virtualenv를 생성 후 활성화, Django 설치, Collestac을 돌릴 때, 데이터베이스를 설치 등 작업은 건너뛰세요.
 
-*   WSGI 설정 파일에 실수가 있을 때 -- my-first-blog-folder 폴더의 경로를 올바르게 입력했었나요?
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
 
-*   Web app에서 그랬듯이 virtualenv에도 같은 파이썬 버전을 선택했나요? 둘 다 모두 3.4 버전이어야 해요 위키에서 [일반적인 디버깅 팁](https://www.pythonanywhere.com/wiki/DebuggingImportError)을 확인할 수 있어요.
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
 
-*   만약 `Invalid HTTP_HOST header: <your-site-name> . You may need to add <your-site-name> to ALLOWED_HOSTS.` 라는 오류메세지가 나온다면 `/mysite/settings.py`의 마지막 줄에 `ALLOWED_HOSTS = ['localhost', '127.0.0.1', '[::1]', '.pythonanywhere.com']` 를 추가 한 뒤에 다시 **Web** 탭에서 `Reload <your-site-name`이라는 녹색 버튼을 눌러 주세요.
+- Web app에서 그랬듯이 virtualenv에도 동일한 파이썬 버전을 선택했나요? 둘다 모두 3.6 버전이어야해요.
 
-[PythonAnywhere wiki에 있는 일반적인 디버깅 방법](https://www.pythonanywhere.com/wiki/DebuggingImportError)도 있습니다.
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
 
-코치들은 여러분들에게 도움을 주기 위해 여기 있다는 것을 기억하세요!
+기억하세요, 여러분의 코치들은 여러분들에게 도움을 주기 위해 여기 있어요!
 
 # 내 웹사이트가 나왔어요!
 
-사이트의 기본 페이지는 로컬 컴퓨터에서와 마찬가지로 "It worked(작동했습니다)"라고 보여줍니다. URL 끝에 `/admin/`을 추가하면 관리자 사이트로 이동합니다. 사용자 이름과 암호로 로그인하여 서버에 새 게시물을 추가 할 수 있어요.
+The default page for your site should say "It worked!", just like it does on your local computer. URL 뒤에 `/admin/`를 붙여서 다시 접속해 보세요. 이제 관리자 사이트를 볼 수 있어요. 서버에서 유저네임과 암호를 입력해서 로그인하면 새 글을 작성할 수 있음을 알 수 있어요.
 
-몇 개의 게시물을 작성하고 나면 PythonAnywhere가 아닌 로컬 설정으로 돌아갈 수 있어요. 여기에서 로컬 설정을 변경해야합니다. 이 것이 바로 공통적인 웹 개발의 작업 과정 입니다. 로컬에서 변경하고, 변경 사항을 GitHub에 적용하고, 변경 사항을 실제 웹 서버로 가져옵니다. 이를 통해 실제 웹 사이트를 손상시키지 않고 작업하고 테스트 해볼 수 있어요. 멋지지 않나요?
+게시글 몇 개를 만들고, 로컬 설치(PythonAnywhere 아닙니다)로 돌아오세요. 지금부터 로컬 컴퓨터에 몇 군데를 변경해야 해요. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. 이 방법으로 웹 사이트 내 오류 없이 여러가지 작업을 시도해볼 수 있어요. 멋지지 않나요?
 
-지금까지 잘했다고 내 자신에게 *크게* 칭찬해주세요! 서버 배포는 웹 개발의 가장 까다로운 부분 중 하나로 작업 기간이 몇 일씩 걸리는 경우가 많아요. 하지만 여러분이 만든 사이트는 인터넷에서 라이브되고 있어요!
+이제까지 수고한 모두를 *격려*해주세요! 서버 배포는 웹 개발 단계 중 가장 까다로운 부분 중 하나이기 때문에 작업 완성까지 몇 일이 걸리기도 해요. 하지만 이제 우리 사이트는 실제 인터넷에서 접속이 가능해요. 쉽게 잘 해냈어요!
\ No newline at end of file
diff --git a/ko/deploy/install_git.md b/ko/deploy/install_git.md
index 4f900b2f6f4..a880a9dac10 100755
--- a/ko/deploy/install_git.md
+++ b/ko/deploy/install_git.md
@@ -1,50 +1,52 @@
-Git이란 "버전 관리 시스템(version control system)"으로 많은 프로그래머들이 사용하고 있습니다. 이 소프트웨어는 시간 경과에 따른 파일 변경을 추적이 가능해 나중에라도 특정 버전을 다시 불러올 수 있습니다. Microsoft Word의 "변경 사항 추적"기능과 비슷하지만 훨씬 강력합니다.
+Git은 많은 프로그래머들이 사용하고 있는 "버전 제어 시스템(version control system)"이에요. 이 소프트웨어는 변경 내용을 추적할 수 있어 나중에 특정 버전을 다시 호출 할 수 있어요. 마이크로소프트 워드에 있는 "변경 내용 추적하기(track changes)"와 같은 기능이지만 이보다 훨씬 더 강력하죠.
 
 ## Git 설치하기
 
-<!--sec data-title="Windows" data-id="git_install_windows"
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
 data-collapse=true ces-->
 
-Git은 [git-scm.com](https://git-scm.com/)에서 내려받을 수 있습니다. 설치는 쉽답니다. 딱 한 단계만 빼고 기본 설정대로 `다음 다음 다음`을 계속 눌러주면 쉽게 설치할 수 있어요. 다섯 번째 `PATH 환경 설정(Adjusting your PATH environment)`화면에서 주의하세요. `윈도우 커맨드라인에서 Git과 유닉스 도구를 사용(Use Git and optional Unix tools from the Windows Command Prompt)`을 선택하세요. 나머지는 모두 기본 설정대로 해도 됩니다. `윈도우 스타일로 체크아웃, 유닉스 스타일로 라인엔딩 커밋하기(Checkout Windows-style, commit Unix-style line endings)`를 체크하는 것도 좋습니다.
+Git은 [git-scm.com](https://git-scm.com/)에서 다운로드 할 수 있어요. You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). 나머지는 모두 기본 설정대로 해도 됩니다. 윈도우 스타일, 유닉스 스타일로 라인엔딩 커밋하기(commit Unix-style line endings) 를 체크하는 것도 좋습니다.
 
-<!--endsec-->
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
 
-<!--sec data-title="OS X" data-id="git_install_OSX"
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
 data-collapse=true ces-->
 
-[git-scm.com](https://git-scm.com/)에서 다운받아 설치하세요. 
-
-> **Note** OS X 10.6, 10.7 또는 10.8을 사용하는 경우 다음 링크에서 git 버전을 설치해야합니다. : [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+[git-scm.com](https://git-scm.com/)에서 맥용 설치파일을 다운받은 다음 실행해 나오는 지시사항에 따라 설치하시면 됩니다.
 
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
 
 <!--endsec-->
 
-<!--sec data-title="Debian / Ubuntu" data-id="git_install_debian_ubuntu"
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
 data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
+
 ```bash
 $ sudo apt-get install git
 ```
 
 <!--endsec-->
 
-<!--sec data-title="Fedora" data-id="git_install_fedora"
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
 data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
+
 ```bash
 $ sudo dnf install git
 ```
 
 <!--endsec-->
 
-<!--sec data-title="openSUSE" data-id="git_install_openSUSE"
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
 data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
+
 ```bash
 $ sudo zypper install git
 ```
 
-<!--endsec-->
+<!--endsec-->
\ No newline at end of file
diff --git a/ko/deploy/signup_pythonanywhere.md b/ko/deploy/signup_pythonanywhere.md
index df39388e762..ca66bd0de69 100755
--- a/ko/deploy/signup_pythonanywhere.md
+++ b/ko/deploy/signup_pythonanywhere.md
@@ -1,5 +1,5 @@
-PythonAnywhere에서 무료 계정인 "초보자(Beginner)"로 회원가입 하세요.
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
 
-  * [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
 
-> **Note** 사용자 이름을 정할 때 블로그 주소의 일부가 되는 것을 기억하세요. 예를 들어 사용자이름이 `yourusername`이면 URL은 `yourusername.pythonanywhere.com`이 된답니다.
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ko/django/README.md b/ko/django/README.md
index 4aba1128e7f..c78230393a3 100755
--- a/ko/django/README.md
+++ b/ko/django/README.md
@@ -1,25 +1,27 @@
-# 장고란 무엇인가요?
+# Django란 무엇일까요?
 
-Django(*/dʒæŋɡoʊ/ jang-goh/쟁고/장고*)는 파이썬으로 만들어진 무료 오픈소스 웹 애플리케이션 프레임워크(web application framework)입니다. 쉽고 빠르게 웹사이트를 개발할 수 있도록 돕는 구성요소로 이루어진 웹 프레임워크랍니다.
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. 쉽고 빠르게 웹사이트를 개발할 수 있도록 돕는 구성요소로 이루어진 웹 프레임워크인 것이죠.
 
 웹사이트를 구축할 때, 비슷한 유형의 요소들이 항상 필요합니다. 회원가입, 로그인, 로그아웃과 같이 사용자 인증을 다루는 방법이나 웹사이트의 관리자 패널, 폼, 파일 업로드와 같은 것들 말이지요.
 
-그런데 정말 다행이게도, 오래전에 어떤 웹 개발자들이 새로운 웹 사이트를 개발할 때 서로 비슷한 문제들에 직면한다는 것을 깨달았습니다. 그래서 팀을 조직했고요. 바로 사용할 수 있는 구성요소들을 갖춘 여러 프레임워크를 만들었답니다. 장고도 그중에 하나인 거죠. 다시 발명해야 하는 문제로부터 해방감을 주고요. 새로운 웹사이트를 개발할 때 뒤따르는 간접비용의 부담을 덜어준답니다.
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
 
 ## 왜 프레임워크가 필요한가요?
 
-장고라는 것이 실제로 무엇을 위한 것인지 이해하기 위해서는 서버에 대해서 자세히 살펴볼 필요가 있어요. 먼저 서버가 여러분에게 웹 페이지를 제공하길 원하는지 알아야 해요.
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
 
-편지(request, 요청)가 도착했는지 확인해주는 메일박스(port, 포트)가 있다고 상상해보세요. 이 것은 웹 서버가 해주는 일이에요. 웹 서버는 받은 편지를 읽고 웹 페이지와 함께 답장을 준답니다. 그런데 무언가를 주고 싶을 때는 그 안에 내용이 있어야 하죠. 장고는 그 특정 콘텐츠를 만들 수 있는 역할을 합니다.
+편지(request, 요청) 이 도착했는지 확인해주는 메일박스(port, 포트) 가 있다고 상상해보세요. 이 것은 웹 서버가 해주는 일이에요. The web server reads the letter and then sends a response with a webpage. 그런데 무언가를 주고 싶을 때는 그 안에 내용이 있어야하죠. 장고는 그 특정 컨텐츠를 만들 수 있는 역할을 합니다.
 
 ## 누군가가 서버에 웹 사이트를 요청하면 어떤 일이 벌어질까요?
 
-웹 서버에 요청이 오면 장고로 전달됩니다. 장고 **urlresolver**는 웹 페이지의 주소를 가져와 무엇을 할지 확인합니다.(*urlresolver*는 웹 사이트 주소인 URL(Uniform Resource Locator)를 통해 이해합니다). 이 urlreslover는 그리 똑똑하지 않습니다. 패턴 목록을 가져와 URL과 맞는지 처음부터 하나씩 대조해 식별합니다. 만약 일치하는 패턴이있으면, 장고는 해당 요청을 관련된 함수(*view*)에 넘겨줍니다
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
 
-집배원을 생각해보세요. 집배원은 거리를 걸으며 집집이 편지와 대조해서 주소와 번지를 확인합니다. 주소와 번지가 일치하면 그곳에 편지를 배달합니다. *urlresolver*가 바로 집배원과 같은 역할을 합니다.
+우편배달부를 생각해보세요. 거리를 걸으며 집집마다 편지와 대조해서 주소와 번지를 확인합니다. 주소와 번지가 일치하면 우편배달부는 그곳에 편지를 배달합니다. Urlresolver 가 바로 이와 같은 일을 합니다.
 
-모든 재미난 일들은 *view* 함수에서 처리됩니다: 특정 정보를 데이터베이스에서 찾을 수 있습니다. 그런데 만약 사용자가 데이터를 바꿔달라고 수정을 요청한다면 어떻게 될까요? "제 직업에 대한 설명을 바꿔주세요."와 같은 편지를 받았다고 생각해봅시다. *view*함수는 수정할 수 있는 권한이 있는지 확인하고 나서, 직업에 대한 설명을 수정해 다시 답장을 주겠지요. "완료했습니다!" 라고요. 그러고 나서 *view*는 답장을 생성하여, 장고는 그 답장을 그 사용자의 웹 브라우저에 보내주는 역할을 합니다.
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. 그런데 만약 사용자가 데이터를 바꿔달라고 수정을 요청한다면 어떻게 될까요? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
 
 물론 지금까지의 설명은 아주 간단히 설명한 것에 불과해요. 하지만 모든 기술적인 부분까지 자세히 알 필요가 없답니다. 이 정도 아는 것만으로도 충분하답니다.
 
-좀 더 자세히 아는 것보다, 지금부터는 장고를 이용해 간단한 것부터 만들어봐요. 그렇게 하면서 중요한 모든 것들을 하나씩 배워나가도록 해요.
+좀 더 자세히 아는 것보다, 지금부터는 장고를 이용해 간단하게 조그만 것부터 만들어봐요. 그렇게 하면서 중요한 모든 것들을 하나씩 배워나가도록 해요.
\ No newline at end of file
diff --git a/ko/django_admin/README.md b/ko/django_admin/README.md
index 106794060dc..56f4dd92f84 100755
--- a/ko/django_admin/README.md
+++ b/ko/django_admin/README.md
@@ -1,13 +1,11 @@
-# 장고 관리자
+# Django 관리자
 
-관리자 화면을 한국어로 변경하길 원할 경우 'settings.py'중 `LANGUAGE_CODE = 'en-us'`를 `LANGUAGE_CODE = 'ko'`로 바꾸세요.
-
-방금 막 모델링 한 글들을 장고 관리자에서 추가하거나 수정, 삭제할 수 있어요.
-
-이제 `blog/admin.py` 파일을 열어서 내용을 다음과 같이 바꾸세요.
+To add, edit and delete the posts we've just modeled, we will use Django admin.
 
+Let's open the `blog/admin.py` file and replace its contents with this:
 
 {% filename %}blog/admin.py{% endfilename %}
+
 ```python
 from django.contrib import admin
 from .models import Post
@@ -15,38 +13,45 @@ from .models import Post
 admin.site.register(Post)
 ```
 
-코드에서 알 수 있듯이 앞 장에서 정의했던 `Post`모델을 가져오고(import) 있어요. 관리자 페이지에서 만든 모델을 보려면 `admin.site.register(Post)`로 모델을 등록해야 해요.
+코드에서 알 수 있듯이 앞 챕터에서 정의했던 Post 모델을 가져오고(import) 있어요. 관리자 페이지에서 만든 모델을 보려면 `admin.site.register(Post)`로 모델을 등록해야해요.
 
-자, 이제 `Post`모델을 볼까요? 웹 서버를 실행하려면 콘솔 창에서 `python manage.py runserver`를 실행하는걸 잊지 마세요. 브라우저를 열고 주소창에 http://127.0.0.1:8000/admin/ 을 입력하면 아래와 같은 로그인 페이지를 볼 수 있어요.
+자, 이제 Post 모델을 볼까요? 웹 서버를 실행하려면 콘솔창에서 `python manage.py runserver`를 실행하는걸 잊지마세요. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
 
-![Login page](images/login_page2.png)
+![로그인 페이지](images/login_page2.png)
 
-로그인하기 위해서는, 모든 권한을 가지는 *슈퍼 사용자(superuser)*를 생성해야 해요. 커맨드라인으로 돌아가서 `python manage.py createsuperuser`을 입력하고 엔터를 누르세요. 
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
 
-> 새 터미널 창을 열고 virtualenv를 활성화 시켜 웹 서버를 실행시키고 난 후 명령어를 입력해야합니다. <b>나의 첫 번째 Django 프로젝트!</b> 장의 <b>웹 서버 시작하기</b>섹션에서 명령어를 입력하는 방법을 배웠어요,
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
 
-메시지가 나타나면 사용자 이름 (소문자, 공백 없이), 이메일 주소 및 암호를 입력합니다. password를 입력할 때 화면에 글자가 보이지 않는다고 해도 걱정하지 마세요. 원래 password는 화면에 보이지 않습니다. 작성한 후에 `enter`를 누르세요. 실행화면은 아래와 같을 거예요. (슈퍼 사용자로 사용할 username 과 email 주소는 본인 계정을 사용하세요) :
+{% filename %}Mac OS X or Linux:{% endfilename %}
 
-{% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py createsuperuser
-Username: admin
-Email address: admin@admin.com
-Password:
-Password (again):
-Superuser created successfully.
-```
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
 
-브라우저로 돌아와서 장고 관리자 페이지에서 슈퍼 사용자로 로그인한 후 대시보드를 확인하세요.
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
 
 ![Django admin](images/django_admin3.png)
 
-게시글로 가서 이것저것 시도해보세요. 5~6개 블로그 포스트를 올려보세요. 안에 내용은 걱정하지 마세요. 튜토리얼에 있는 텍스트를 그냥 복사붙여넣기를 할 수 있으니까요.
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
 
-최소한 2, 3개의 글에 게시 날짜가 있는지 확인하세요. (모두 볼 필요는 없어요) 이건 나중에 도움이 될 거에요.
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
 
 ![Django admin](images/edit_post3.png)
 
-장고 관리자에 대해서 좀 더 알고 싶다면 장고 공식 문서를 읽어보세요 : https://docs.djangoproject.com/en/1.8/ref/contrib/admin/
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
 
-자, 우리는 내 첫 번째 장고 모델을 만들었어요! 잠깐 쉴 시간이 필요해요. 열심히 했으니 재충전을 위해 커피 한 잔(또는 차 한 잔) 또는 뭔가 먹고 돌아오세요.
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ko/django_forms/README.md b/ko/django_forms/README.md
index 05285194903..1dd8b48452f 100755
--- a/ko/django_forms/README.md
+++ b/ko/django_forms/README.md
@@ -1,23 +1,23 @@
-# 장고 폼
+# Django 폼
 
-한 가지만 더 하면 웹사이트가 완성됩니다. 바로 블로그 글을 추가하거나 수정하는 멋진 기능을 추가하는 것이죠. 장고의 `관리자` 기능도 충분히 멋있기는 하지만, 좀 더 입맛에 맞게 바꾸고 예쁘게 꾸미기에는 좀 한계가 있습니다. `폼(양식, forms)`으로 강력한 인터페이스를 만들 수 있어요. - 우리가 상상할 수 있는 거의 모든 것을 할 수 있거든요!
+이제 한 가지만 더 하면 웹사이트가 완성되어요. 바로 블로그 글을 추가하거나 수정하는 멋진 기능을 추가하는 것이죠. 장고의 `관리자` 기능도 충분히 멋있기는 하지만, 좀 더 입맛에 맞게 바꾸고 예쁘게 꾸미기에는 좀 한계가 있습니다. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
 
-장고 폼이 정말 멋진 것은 아무런 준비 없이도 양식을 만들 수 있고, `ModelForm`을 생성해 자동으로 모델에 결과물을 저장할 수 있다는 거예요.
+장고 폼이 정말 멋진 것은 아무런 준비 없이도 양식을 만들 수 있고, `ModelForm`을 생성해 자동으로 모델에 결과물을 저장할 수 있다는 거에요.
 
-이 기능이 지금 우리가 할 내용이에요. 폼을 하나 만들어서 `Post` 모델에 적용해봅시다.
+이 기능이 지금 우리가 할 내용이에요: 폼을 하나 만들어서 `Post` 모델에 적용해봅시다.
 
-장고의 모든 중요한 부분과 마찬가지로, 폼도 폼만의 `forms.py`.라는 파일을 만들어요.
+장고의 모든 중요한 부분과 마찬가지로, 폼도 폼만의 파일을 만들어요: `forms.py`.
 
-우리는 이 이름으로 `blog` 디렉토리 안에 파일을 만들 거에요.
+우리는 이 이름으로 `blog` 디렉토리 안에 파일을 만들거에요.
 
-```
-blog
- └── forms.py
-```
+    blog
+      └── forms.py
+    
 
-좋아요. 이제 이 파일을 열고 아래 코드를 작성하세요. :
+OK, let's open it and type the following code:
 
 {% filename %}blog/forms.py{% endfilename %}
+
 ```python
 from django import forms
 
@@ -30,34 +30,36 @@ class PostForm(forms.ModelForm):
         fields = ('title', 'text',)
 ```
 
+위 코드를 보면 첫 번째로 forms model을 import 해야하고 (`from django import forms`), 그 다음으로 `Post` model 도 import 해야합니다. (`from .models import Post`).
 
-위 코드를 보면 첫 번째로 forms model을 import 해야 하고 (`from django import forms`), 그다음으로 `Post` model도 import 해야 합니다. (`from .models import Post`).
+`PostForm` 은 이미 다들 예상 하셨듯이 우리가 만들 폼의 이름이에요. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
 
-`PostForm` 은 이미 다들 예상 하셨듯이 우리가 만들 폼의 이름이에요. 그리고 장고에 이 폼이 `ModelForm`이라는 것을 알려줘야해요. (그러면 장고가 뭔가 마술을 부릴 거에요) - `forms.ModelForm`은 ModelForm이라는 것을 알려주는 구문이에요.
+자, 이제 다음으로 `class Meta`가 나오는데요, 이 구문은 이 폼을 만들기 위해서 어떤 model이 쓰여야 하는지 장고에게 알려주는 구문입니다. (`model = Post`).
 
-자, 이제 다음으로 `class Meta`가 나오는데요, 이 구문은 이 폼을 만들기 위해서 어떤 model이 쓰여야 하는지 장고에 알려주는 구문입니다. (`model = Post`).
-
-마지막으로, 이 폼에 필드를 넣으면 완성되겠죠. 이번 폼에서는 `title`과 `text`만 보여지게 해 봅시다. - `author`는 현재 로그인 하고 있는 사람이 될 것이고 (바로 당신이요!) 그리고 `created_date`는 글이 등록되는 시간이 될 것입니다. (예를 들어, 코드 상에서요), 됐죠?
+마지막으로, 이 폼에 필드를 넣으면 완성되겠죠. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
 
 마쳤습니다! 이제 *뷰* 에서 이 폼을 사용해 템플릿에서 보여주기만 하면 되네요.
 
-다음에는 링크, URL, 뷰 그리고 템플릿을 만들 거에요.
+So once again we will create a link to the page, a URL, a view and a template.
 
 ## 폼과 페이지 링크
 
-`blog/templates/blog/base.html` 파일을 열어봅시다. `page-header` 라는 `div` class에 링크를 하나 추가할 거에요.
+`blog/templates/blog/base.html` 파일을 열어봅시다. `page-header` 라는 `div` class 에 링크를 하나 추가할거에요.
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-이 새로운 뷰는 `post_new`입니다. 부트스트랩 테마에 있는 `glyphicon glyphicon-plus` 클래스로 더하기 기호가 보이게 되는데요.
+이 새로운 뷰는 `post_new`입니다. 부트스트랩 테마에 있는 `"glyphicon glyphicon-plus"` 클래스로 더하기 기호가 보이게 됩니다.
 
-위 구문을 추가하고 나면, 이제 html 파일이 아래처럼 보일 거예요.
+After adding the line, your HTML file should now look like this:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
+Text for Translation
 {% load staticfiles %}
 <html>
     <head>
@@ -84,20 +86,22 @@ class PostForm(forms.ModelForm):
 </html>
 ```
 
-페이지를 저장하고 나서 http://127.0.0.1:8000 페이지를 새로고침 해보면, `NoReverseMatch`이라는 에러가 나타나죠?
+페이지를 저장하고 나서 http://127.0.0.1:8000 페이지를 새로고침 해보면, `NoReverseMatch`이 에러가 나타나죠?
 
 ## URL
 
-이제 `blog/urls.py`를 열고 아래 구문을 추가하겠습니다.
+이제 `blog/urls.py` 을 열고 아래 구문을 추가하겠습니다:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 url(r'^post/new/$', views.post_new, name='post_new'),
 ```
 
-전체 코드는 아래와 같을 거예요.
+전체 코드는 아래와 같을 거에요.
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
@@ -109,42 +113,45 @@ urlpatterns = [
 ]
 ```
 
-브라우저에 사이트를 다시 불러오면 `AttributeError`가 보이게 됩니다. 왜냐하면, 아직 `post_new`뷰를 구현하지 않았기 때문이죠. 이제 하나 더 추가해봅시다.
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
 
-## `post_new` view
+## post_new view
 
-`blog/views.py`파일을 열어서 `from`줄에 아래와 같은 코드를 추가합니다.
+`blog/views.py` 파일을 열어서 `from` 줄에 아래와 같은 코드를 추가합니다.
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from .forms import PostForm
 ```
 
-그리고 *view*에 추가합니다.
+And then our *view*:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_new(request):
     form = PostForm()
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-새 `Post` 폼을 추가하기 위해 `PostForm()` 함수를 호출하도록 하여 템플릿에 넘깁니다. 곧 *view* 로 다시 돌아와서 이 작업을 하겠지만, 지금 당장은 폼을 위한 템플릿을 먼저 빨리 만들어보도록 할게요.
+새 `Post` 폼을 추가하기 위해 `PostForm()` 함수를 호출하도록 하여 템플릿에 넘깁니다. We will go back to this *view*, but for now, let's quickly create a template for the form.
 
 ## 템플릿
 
-이번에는 `blog/templates/blog` 디렉터리 안에 `post_edit.html` 파일을 생성해 폼이 작동할 수 있게 만들 거에요.
+이번에는 `blog/templates/blog` 디렉토리 안에 `post_edit.html` 파일을 생성해 폼이 작동할 수 있게 만들거에요.
 
-- 먼저 폼이 보여야 합니다. 그 예로, `{% raw %}{{ form.as_p }}{% endraw %}`로 간단히 만들 수 있어요….
-- 위 코드를 HTML 태그로 폼을 감싸세요. `<form method="POST">...</form>`
-- `Save` 버튼이 필요합니다. 이것은 HTML 버튼으로 만들 수 있어요: `<button type="submit">Save</button>`
--  마지막으로 `<form ...>`을 열어 `{% raw %}{% csrf_token %}{% endraw %}`를 추가하세요. 이 작업은 폼 보안을 위해 중요하답니다! 이 작업을 빼먹고 저장하면 장고는 이렇게 불평할 거에요.
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. 이 작업은 폼 보안을 위해 중요하답니다! If you forget about this bit, Django will complain when you try to save the form:
 
-![CSFR Forbidden page](images/csrf2.png)
+![CSFR 서버가 허용하지 않는 웹 페이지(Forbidden page)](images/csrf2.png)
 
-네, 이제 `post_edit.html` 파일의 HTML을 확인해볼게요.
+OK, so let's see how the HTML in `post_edit.html` should look:
 
 {% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -157,34 +164,34 @@ def post_new(request):
 {% endblock %}
 ```
 
-다 작성했으면 화면을 다시 불러옵시다. 폼이 이렇게 나타났나요!
+다 작성했으면 화면을 다시 불러옵시다! 여러분의 폼이 이렇게 나타났나요!
 
-![New form](images/new_form2.png)
+![새 폼(New form)](images/new_form2.png)
 
-잠깐만요! `title`과 `text`필드에 아무거나 입력하고 저장해보세요. 어떻게 됐나요?
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
 
-글이 사라졌어요! 한번 더 해봐도 내가 입력한 글들은 어디론가로 사라지고는 새 글이 추가되지 않아요. 뭐가 잘못된 걸까요?
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
 
-여러분이 잘못한 게 없답니다. 단지 *view* 추가 작업이 필요할 뿐이에요.
+정답은요: 여러분이 잘못한 게 없어요. 단지 *view*에 조금 작업이 필요할 뿐이에요.
 
 ## 폼 저장하기
 
-`blog/views.py`를 다시 여세요. 지금 여러분이 보고 있는 `post_new`뷰는 아래와 같을 거에요.
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_new(request):
     form = PostForm()
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-폼을 제출할 때, 같은 뷰를 불러옵니다. 이때 `request`에는 우리가 입력했던 데이터들을 가지고 있는데, `request.POST`가 이 데이터를 가지고 있습니다. (`POST`는 글 데이터를 "등록하는(posting)"하는 것을 의미합니다. 블로그 "글"을 의미하는 "post"와 관련이 없어요) HTML에서 `<form>`정의에 `method="POST"`라는 속성이 있던 것이 기억나나요? 이렇게 POST로 넘겨진 폼 필드의 값들은 이제 `request.POST`에 저장됩니다. `POST`로 된 값을 다른 거로 바꾸면 안 돼요. `method` 속성의 값으로 넣을 수 있는 유효한 값 중에 `GET`같은 것도 있지만, post와 어떤 차이점이 있는지 등에 대해서 다루기에는 너무 길어질 것 같아 생략할게요)
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? 이렇게 POST로 넘겨진 폼 필드의 값들은 이제 `request.POST`에 저장됩니다. `POST`로 된 값을 다른 걸로 바꾸면 안돼요.(`method` 속성의 값으로 넣을 수 있는 유효한 값 중에 `GET` 같은 것도 있지만 post와 어떤 차이점이 있는지 등에 대해서 다루기에는 너무 길어질 것 같아 생략할게요.)
 
-이제 *view* 에서 두 상황으로 나누어 처리해볼게요.
-* 첫 번째: 처음 페이지에 접속했을 때입니다. 당연히 우리가 새 글을 쓸 수 있게 폼이 비어있어야겠죠.
-* 두 번째: 폼에 입력된 데이터를 *view* 페이지로 가지고 올 때입니다. 여기서 조건문을 추가시켜야 해요. (`if`를 사용하세요)
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. 여기서 조건문을 추가시켜야해요. (`if`을 사용할게요):
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 if request.method == "POST":
     [...]
@@ -192,18 +199,20 @@ else:
     form = PostForm()
 ```
 
-이제 생략된 `[...]`부분에 코드를 추가해봅시다. 만약 `method`가 `POST`라면, 폼에서 받은 데이터를 `PostForm`으로 넘겨줘야겠죠? 이렇게 작성하면 됩니다.
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 form = PostForm(request.POST)
 ```
 
-참 쉽죠! 다음에는 폼에 들어있는 값들이 올바른지를 확인해야합니다.(모든 필드에는 값이 있어야하고 잘못된 값이 있다면 저장하면 되지 않아야해요) 이를 위해 `form.is_valid()`을 사용할거에요.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
 
 폼에 입력된 값이 올바른지 확인한 다음, 저장되는거죠!
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 if form.is_valid():
     post = form.save(commit=False)
@@ -212,31 +221,30 @@ if form.is_valid():
     post.save()
 ```
 
-일반적으로 이 작업을 두 단계로 나눌 수 있어요. `form.save()`로 폼을 저장하는 작업과 작성자를 추가하는 작업입니다. (`PostForm`에는 `작성자(author)` 필드가 없지만, 필드 값이 필요하죠!) `commit=False`란 넘겨진 데이터를 바로 `Post` 모델에 저장하지는 말라는 뜻입니다. 왜냐하면, 작성자를 추가한 다음 저장해야 하니까요. 대부분의 경우에는 `commit=False`를 쓰지 않고 바로 `form.save()`를 사용해서 저장해요. 다만 여기서는 작성자 정보를 추가하고 저장해야 하므로 `commit=False`를 사용하는 거예요. `post.save()`는 변경사항(작성자 정보를 포함)을 유지할 것이고 새 블로그 글이 만들어질 거에요!
-
-끝으로, 새 블로그 글을 작성한 다음에 `post_detail`페이지로 이동할 수 있으면 좋겠죠? 이 작업을 하려면 한 가지를 더 불러와야 해요.
-
-```python
-from django.shortcuts import redirect
-```
+일반적으로, 이 작업을 두 단계로 나눌 수 있어요: `form.save`로 폼을 저장하는 작업과 작성자를 추가하는 작업입니다.(`PostForm`에는 `작성자(author)` 필드가 없지만, 필드 값이 필요하죠). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
 
-위 코드를 여러분의 파일 맨 위에 추가하세요. 그리고 새로 작성한 글을 볼 수 있도록 `post_detail`페이지로 가라고 수정합시다.
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import redirect
 ```
 
-`post_detail`은 우리가 이동해야 할 뷰의 이름이에요 *post_detail 뷰* 는 `pk`변수가 필요한 거 기억하고 있겠죠? `pk=post.pk`를 사용해서 뷰에게 값을 넘겨줄 거에요. 여기서 `post`는 새로 생성한 블로그 글이에요.
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 return redirect('post_detail', pk=post.pk)
 ```
 
-잘했어요. 너무 설명이 길어졌네요. 이제 *view* 전체 코드를 확인할게요.
+`blog.views.post_detail`은 이동해야 할 뷰의 이름이에요. *post_detail 뷰*는 `pk`변수가 필요한 거 기억하고 있겠죠? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_new(request):
     if request.method == "POST":
@@ -252,42 +260,42 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-잘 작동하는지 확인해보세요. http://127.0.0.1:8000/post/new/ 페이지로 접속해서 `title`과 `text`를 입력하고, 저장하세요…. 그리고…. 짜잔!!! 새로운 블로그 글이 추가되고 `post_detail`페이지가 나타났어요!
+잘 작동하는지 확인해보세요. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
 
-블로그 글을 저장하기 전에 게시일을 설정하고 싶을 거에요. 추후 __장고걸스 튜토리얼__ 중 게시글 추가하기 버튼 만들기에서 확인할 수 있어요.
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
 
-모두 잘해냈어요!
+모두 잘 해냈어요!
 
-> 장고 관리자 인터페이스처럼 로그인된 상태라고 생각해봅시다. 하지만 사용자가 로그아웃되는 상황이 발생하기도 하죠. (브라우저가 닫히거나, DB가 재시작된다든가 등) 만약 로그인되지 않은 상태에서 새 글을 저장한다면, 사용자가 로그인되어있지 않아 누가 글을 작성하였는지 알 수 없어요. 그래서 글을 저장할 때 오류가 발생하고, 로그인시키도록 [http://127.0.0.1:8000/admin](http://127.0.0.1:8000/admin) 관리자 페이지가 나타나게 될 거에요. 이 문제는 금방 해결할 수 있어요. 튜토리얼을 마친 후 장고걸스 심화 튜토리얼 - 보안 추가하기 장에서 실습할 수 있어요.
-
-![Logged in error](images/post_create_error.png)
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. 이 문제는 금방 해결할 수 있어요. 다만 이건 이 튜터리얼 후에 해야할 **과제(Homework): 여러분의 사이트에 보안 추가하기** 챕터로 남겨놓겠습니다.
 
+![로그인 오류 (Logged in error)](images/post_create_error.png)
 
 ## 폼 검증하기
 
-장고 폼이 얼마나 멋진지 알아볼 차례에요. 블로그 글은 `title`과 `text`필드가 반드시 있어야 해요. 우리가 만든 `Post`모델에서는 이 필드 값들이 필요 없다고 했지만(`published_date`는 제외하고) 장고는 모두 기본값으로 설정되어 있다고 생각합니다.
-
-`title`과 `text`없이 폼을 저장해보세요. 어떻게 될지 생각해보세요!
+이제 장고 폼이 얼마나 멋진지 알아볼 차례에요. 블로그 글은 `title`과 `test` 필드가 반드시 있어야해요. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
 
-![Form validation](images/form_validation2.png)
+Try to save the form without `title` and `text`. Guess what will happen!
 
-장고는 모든 필드의 값이 올바른지 검증할 수 있답니다. 정말 멋지죠?
+![폼 검증하기](images/form_validation2.png)
 
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
 
 ## 폼 수정하기
 
-지금까지 새 폼을 추가하는 방법에 대해 배웠어요. 하지만 이미 있던 글을 수정하려면 어떻게 해야 할까요? 이것도 앞서 했던 것과 매우 비슷해요. 빨리해보도록 합시다! (만약 이해하지 못하는 부분이 있다면, 여러분의 코치에게 이전 장의 내용에 관해서 물어보고 차례대로 하나씩 해결해 나가야 합니다)
+지금까지 새 폼을 추가하는 방법에 대해 배웠어요. 하지만 이미 있던 글을 수정하려면 어떻게 해야할까요? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
 
-`blog/templates/blog/post_detail.html`파일을 열어 아래 내용을 추가하세요.
+Open `blog/templates/blog/post_detail.html` and add the line
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
 
-이제 템플릿이 아래와 같이 보일 거에요.
+so that the template will look like this:
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -305,18 +313,20 @@ def post_new(request):
 {% endblock %}
 ```
 
-`blog/urls.py`에 다음 코드를 추가합니다.
+`blog/urls.py`에 아래 코드를 추가합니다.
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
     url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
 ```
 
-우리는 `blog/templates/blog/post_edit.html` 템플릿을 재사용할 거에요. 마지막으로 할 일은 *view* 를 만드는 것입니다.
+우리는 `blog/templates/blog/post_edit.html` 템플릿을 재사용할 거에요. 마지막으로 할 일은 *view*를 만드는 것입니다.
 
-`blog/views.py`파일을 열어서 파일 맨 밑에 코드를 추가해봅시다.
+Let's open `blog/views.py` and add this at the very end of the file:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_edit(request, pk):
     post = get_object_or_404(Post, pk=pk)
@@ -333,101 +343,106 @@ def post_edit(request, pk):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-
-음…. 코드가 `post_new`와 거의 비슷해 보이지 않나요? 하지만 완전히 같지는 않아요.
-* 첫 번째: url로부터 추가로 `pk` 매개변수를 받아서 처리합니다.
-* 두 번째: `get_object_or_404(Post, pk=pk)`를 호출하여 수정하고자 하는 글의 `Post` 모델 `인스턴스(instance)`로 가져옵니다. (`pk`로 원하는 글을 찾습니다) 이렇게 가져온 데이터를 폼을 만들 때와(글을 수정할 때 폼에 이전에 입력했던 데이터가 있어야 하겠죠?) 폼을 저장할 때 사용하게 됩니다.
+음.. 코드가 `post_new`과 거의 비슷해보이지 않나요? 하지만 완전히 같지는 않아요. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 form = PostForm(request.POST, instance=post)
 ```
 
-그리고 폼에 아래와 같이 수정하세요.
+…and when we've just opened a form with this post to edit:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 form = PostForm(instance=post)
 ```
 
-잘했어요. 이제 잘 작동하는지 확인해보세요! `post_detail`페이지로 가보세요. 우측 상단에 수정 버튼이 있어야 합니다.
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
 
-![Edit button](images/edit_button2.png)
+![수정 버튼(Edit button)](images/edit_button2.png)
 
 수정 버튼을 누르면 우리가 쓴 블로그 글이 들어가 있는 폼을 볼 수 있을 거에요.
 
-![Edit form](images/edit_form2.png)
+![폼 수정하기](images/edit_form2.png)
 
-자유롭게 제목과 텍스트를 수정하고 저장해보세요!
+Feel free to change the title or the text and save the changes!
 
 축하합니다! 여러분의 어플리케이션이 점점 더 완벽해지고 있어요!
 
-장고 폼에 대해 자세한 정보가 필요하다면 공식 문서를 읽어보세요. :
-https://docs.djangoproject.com/en/1.11/topics/forms/
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
 
 ## 보안
 
-링크를 클릭해 새로운 포스트가 나오게 만드는 것은 멋진 일이에요! 지금은 웹사이트를 방문하는 누구든지 글을 쓸 수 있지만, 그렇게 하고 싶지 않을 수 있어요. 나에게만 보이고 다른 사람에게는 보이지 않는 버튼을 만들어 볼게요.
+링크를 클릭해 새로운 포스트가 나오게 만드는 것은 멋져요! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. 나에게만 보이고 다른 사람에게는 보이지 않는 버튼을 만들어볼게요.
 
-`blog/templates/blog/base.html` 파일에서, `page-header` `div`를 찾아 그 위에 아래와 같이 입력합니다 :
+`blog/templates/blog/base.html` 파일에서, `page-header` `div`를 찾아 그 위에 아래와 같이 입력합니다:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-여기에 `{% if %}`태그를 추가해 관리자로 로그인한 유저들만 링크가 보일 수 있게 만들 거에요. 그게, 바로 여러분이죠! `<a>`태그를 아래와 같이 변경하세요 :
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! `<a>`태그를 아래와 같이 변경하세요:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% if user.is_authenticated %}
     <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 {% endif %}
 ```
 
-이 `{% if %}`는 브라우저에 페이지를 요청 하는 사용자가 로그인 하는 경우 링크가 발생됩니다. 이는 새 게시글을 완전히 보호해주는 것은 아니지만, 바람직한 방법입니다. 이 부분은 장고걸스 심화 튜토리얼에서 좀더 자세히 다룰거에요.
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. 이는 새 게시글을 완전히 보호해주는 것은 아니지만, 바람직한 방법입니다. 이 부분은 튜토리얼 심화에서 좀더 자세히 다룰거에요.
 
 세부 페이지에 있는 수정 아이콘이 기억나죠? 이번에도 동일하게 다른 사람들이 게시글을 수정하지 못하게 할 거에요.
 
-`blog/templates/blog/post_detail.html`파일을 열어 아래 내용을 추가하세요.
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
-이렇게 바꾸세요. :
+
+Change it to this:
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% if user.is_authenticated %}
      <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 {% endif %}
 ```
-로그인했기 때문에, 페이지 새로고침을 해도 아무것도 표시되지 않을 거에요. 새로운 브라우저 또는 시크릿 창을 실행해 보세요. 링크와 아이콘이 보이지 않게 되었어요!
+
+로그인했기 때문에, 페이지 새로고침을 해도 아무것도 표시되지 않을 거에요. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
 
 ## 한 가지만 더: 배포하세요!
 
 모든 작업을 끝마쳤으면 PythonAnywhere로 배포해야죠!
 
-* 제일 먼저 코드를 커밋하고 Github로 푸시합니다.
+* 제일 먼저, 여러분의 코드를 커밋하고 Github로 푸시합니다:
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added views to create/edit blog post inside the site."
-$ git push
-```
 
-* 그 다음 [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/)을 여세요 :
- 
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* 그 다음 [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/)을 여세요:
+
 {% filename %}command-line{% endfilename %}
-```
-$ cd my-first-blog
-$ git pull
-[...]
-```
 
-* 마지막으로 [Web tab](https://www.pythonanywhere.com/web_app_setup/)에서 **Reload**를 누르세요.
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* 마지막으로 [웹 탭(Web tab)](https://www.pythonanywhere.com/web_app_setup/)에서 **다시 불러오기(Reload)**를 누르세요.
 
-이제 배포가 완료 되었어요. 잘 작동되는지 확인하세요! 축하합니다. :)
+이제 배포가 완료 되었어요. 잘 작동되는지 확인해 보세요! 축하합니다. :)
\ No newline at end of file
diff --git a/ko/django_installation/README.md b/ko/django_installation/README.md
index 561cfbba876..3bd1a6c9c7c 100755
--- a/ko/django_installation/README.md
+++ b/ko/django_installation/README.md
@@ -1,8 +1,7 @@
-# 장고 설치하기
+# Django 설치하기
 
-> **Note** 크롬북 사용자는 이번 장을 건너뛰고, [크롬북에서 설치하기](../chromebook_setup/README.md) 장으로 가세요.
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
 
-
-> **Note** 이미 설치를 끝냈다면 다음 장으로 넘어세요!
-
-{% include "/django_installation/instructions.md" %}
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ko/django_installation/instructions.md b/ko/django_installation/instructions.md
index c79df5ced95..3092382020a 100755
--- a/ko/django_installation/instructions.md
+++ b/ko/django_installation/instructions.md
@@ -1,187 +1,201 @@
-> **Note** 이 장의 일부는 Geek Girls Carrots (http://django.carrots.pl/)의 튜토리얼을 기초로 작성되었습니다.
+> 이번 장의 일부는 Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)의 튜토리얼을 바탕으로 작성되었습니다.
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Django-marcador 튜토리얼은 Markus Zapke-Gründemann et al에게 저작권이 있습니다.
 
-> **Note** 이 장의 일부는 Creative Commons Attribution-ShareAlike 4.0 International License에 준수하여 [django-marcador 튜토리얼](https://github.com/ggcarrots/django-carrots)를 기초로 작성되었습니다. django-marcador 튜토리얼 저작권은 Markus Zapke-Gründemann et al이 소유하고 있습니다.
+## 가상 환경
 
-## 가상환경(Virtual environment)
+장고를 설치하기 전에, 개발 환경을 깔끔하게 관리하는데 아주 큰 도움이 되는 도구를 설치해보겠습니다. 이 단계를 건너뛸 수 있지만, 한번 직접 해보는 것을 추천합니다. 제대로 설치해야 나중에 문제가 발생하지 않거든요!
 
-장고 설치 전, 개발 환경을 깔끔하게 관리하는 데 큰 도움이 되는 도구를 설치해보겠습니다. 이 단계를 건너뛸 수 있지만, 한번 직접 해보는 것을 추천합니다. 제대로 설치해야 나중에 문제가 발생하지 않거든요!
+자, 이제부터 **가상 환경**(*virtualenv*라고 불러요)을 만들어보겠습니다. Virtualenv는 프로젝트 기초 전부를 Python/Django와 분리시켜줍니다. 다시 말해 웹사이트가 변경되어도 개발 중인 것에 영향을 미치지 않다는 것입니다. 어때요, 깔끔하죠?
 
-자, 이제부터 **가상환경(Virtual environment)**(*줄여서 virtualenv*라고 해요)을 만들어보겠습니다. Virtualenv는 프로젝트 기초 전부를 Python/Django와 분리해줍니다. 다시 말해 웹사이트가 변경되어도 개발 중인 것에 영향을 미치지 않는다는 것입니다. 어때요, 깔끔하죠?
+`virtualenv`를 만드는 데 필요한 것은 생성할 곳을 정하는 것 뿐입니다. 예를 들면, home 디렉토리와 같은 곳이면 적당합니다. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
 
-`virtualenv`를 만드는 데 필요한 것은 생성할 곳을 정하는 것뿐입니다. 예를 들면, home 디렉토리와 같은 곳이면 적당합니다. 윈도우 환경에서는 `C:\Users\Name`일 거에요. (`Name`이라는 것은 윈도우에 로그인할 때 사용한 아이디를 말합니다)
-
-> **Note** 윈도우에서 디렉토리 파일명에 악센트 또는 특수 문자가 포함되지 않도록 주의하세요. 사용자 이름에 악센트 부호가있는 문자가 들어 있으면 다른 디렉토리를 사용하세요. (예: `C:\djangogirls`)
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
 
 이 튜토리얼에서는 home 디렉토리 아래 `djangogirls`라는 디렉토리를 새로 만들어 사용하도록 할게요.
 
 {% filename %}command-line{% endfilename %}
-```
-$ mkdir djangogirls
-$ cd djangogirls
-```
-
-이제 `myenv` 라는 이름의 가상환경을 만들어 볼게요. 아래와 같은 형식의 명령을 실행하세요.
-
-{% filename %}command-line{% endfilename %}
-```
-$ python3 -m venv myvenv
-```
 
-<!--sec data-title="Windows" data-id="virtualenv_installation_windows" data-collapse=true ces-->
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
 
-`virtualenv`를 생성하려면 콘솔 창을 열고, (이전 장에서 얘기했는데, 기억나죠?) 그리고 `C:\Python35\python -m venv myvenv`를 실행하세요. 아마도 화면에 이렇게 보일 거에요. :
+이제 `myenv` 라는 이름의 가상 환경을 만들어볼게요. 아래와 같은 형식의 명령을 실행하세요.
 
 {% filename %}command-line{% endfilename %}
-```
-C:\Users\Name\djangogirls> C:\Python35\python -m venv myvenv
-```
-여기서 `C:\Python35\python`은 이전에 파이썬을 설치 한 디렉토리이고 `myvenv`는`virtualenv`의 이름입니다. 다른 이름을 사용해도 되지만 알파벳 소문자를 사용하고 공백, 악센트 또는 특수 문자는 사용하지 마세요. 가상환경 이름을 짧게 쓰는 것도 좋은 생각입니다. 자주 입력해야 하니까요.
 
-<!--endsec-->
-
-<!--sec data-title="Linux / OS X" data-id="virtualenv_installation_linuxosx" data-collapse=true ces-->
+    $ python3 -m venv myvenv
+    
 
-리눅스와 맥에서 `virtualenv`를 생성하려면 간단하게 `python3 -m venv myvenv`를 입력하면 됩니다. 화면에 이렇게 나타날 거에요. :
-
-{% filename %}command-line{% endfilename %}
-```
-$ python3 -m venv myvenv
-```
-
-여기서 `myvenv` 는 `가상환경`의 이름이에요. 이름은 마음대로 정할 수 있지만, 소문자여야 하고 공백은 없어야 해요. 이름은 짧게 만드는 게 좋아요. 자주 입력해야 하니까요.
-
-> **Note** Debian/Ubuntu에서 아래와 같은 오류가 발생할 수 있습니다. :
-
-{% filename %}command-line{% endfilename %}
-```
-The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
-    apt-get install python3-venv
-You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
-```
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
 
-이 경우, 위의 지시에 따라 `python3-venv` 패키지를 설치하세요. :
-{% filename %}command-line{% endfilename %}
-```
-$ sudo apt-get install python3-venv
-```
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
 
-> **Note** Debian/Ubuntu의 일부 버전에서 이와 같이 가상 환경을 초기화하면 현재 다음과 같은 오류가 발생합니다. :
 {% filename %}command-line{% endfilename %}
-```
-Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
-```
-
-이 문제를 해결하려면 `virtualenv` 명령를 사용하세요. :
 
-{% filename %}command-line{% endfilename %}
-```
-$ sudo apt-get install python-virtualenv
-$ virtualenv --python=python3.6 myvenv
-```
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
 
-> **Note** 아래와 같은 오류가 발생한다면
+Where `myvenv` is the name of your `virtualenv`. 이름은 마음대로 정할 수 있지만, 소문자여야하고 공백은 없어야하고 특수문자도 사용하면 안되요. It is also good idea to keep the name short – you'll be referencing it a lot!
 
-{% filename %}command-line{% endfilename %}
-```
-E: Unable to locate package python3-venv
-```
+<!--endsec-->
 
-이 명령어를 실행하세요. :
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
 
-{% filename %}command-line{% endfilename %}
-```
-sudo apt install python3.6-venv
-```
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+여기서 `myvenv` 는 `가상 환경`의 이름이예요. 이름은 마음대로 정할 수 있지만, 소문자여야하고 공백은 없어야해요. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **참고:** 데비안/우분투 일부 버전에서 아래 오류가 나타날 수 있습니다:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  데비안/우분투 시스템에는, 다음 명령을 사용 하여 python3 venv 패키지를 설치 해야 합니다.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> 이 문제를 해결하려면 `virtualenv` 명령을 사용해야해요.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
 
 <!--endsec-->
 
 ## 가상환경 사용하기
 
-앞의 명령을 사용하면 `myvenv`라는 디렉토리가 만들어져요. (이름을 변경하면 그 이름의 디레토리가 만들어집니다) 그리고 그 디렉토리에 우리가 사용할 가상환경이 들어있어요. (디렉토리와 파일들이 있어요)
+앞의 명령을 사용하면 `myvenv`라는 디렉토리가 만들어져요. (이름을 다르게 했다면 그 이름의 디레토리가 만들어져요) 그리고 그 디렉토리에 우리가 사용할 가상 환경이 들어있어요 (디렉토리들이랑 파일들이 있어요).
 
-<!--sec data-title="Windows" data-id="virtualenv_windows" data-collapse=true ces-->
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
 
-아래 명령어를 입력해 가상환경을 실행하세요. :
+다음과 같이 가상환경을 실행하세요.
 
 {% filename %}command-line{% endfilename %}
-```
-C:\Users\Name\djangogirls> myvenv\Scripts\activate
-```
 
-> **Note** Windows 10 사용할 경우, Windows PowerShell에서 '이 스크립트는 이 시스템에서 실행되지 않습니다.'라는 오류 메시지가 표시 될 수 있습니다. 이 경우 "관리자 권한으로 실행"옵션을 사용하여 다른 Windows PowerShell을 엽니다. 그런 다음 가상 환경을 시작하기 전에 다음 명령을 입력하세요.
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
 
-{% filename %}command-line{% endfilename %}
-```
-C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
-     Execution Policy Change
-     The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
-```
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
 
 <!--endsec-->
 
-<!--sec data-title="Linux / OS X" data-id="virtualenv_linuxosx"
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
 data-collapse=true ces-->
 
-아래 명령어를 입력해 가상환경을 실행하세요. :
+다음과 같이 가상환경을 실행하세요.
 
 {% filename %}command-line{% endfilename %}
-```
-$ source myvenv/bin/activate
-```
 
-`myvenv`를 여러분이 선택한 `virtualenv` 이름으로 바꾸는 것을 잊지 마세요!
+    $ source myvenv/bin/activate
+    
 
-> **Note** 가끔씩 `source`가 사용할 수 없을 수도 있습니다. 이 경우에는 아래와 같이 입력하세요. :
+실행할 때 `myvenv` 부분에 자신이 선택한 `가상 환경`의 이름을 적어야해요!
 
-{% filename %}command-line{% endfilename %}
-```
-$ . myvenv/bin/activate
-```
+> **주의:** 간혹 `source` 명령이 동작하지 않을 수도 있어요. 그럴 때는 이렇게 하세요.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
 
 <!--endsec-->
 
-콘솔의 프롬프트 앞에`(myvenv)`접두어가 붙어있다면 `virtualenv`가 시작되었음을 알 수 있어요.
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
 
-가상환경에서 작업 할 때,`python`은 자동으로 올바른 버전을 참조하므로 `python3` 대신`python`를 사용할 수 있습니다.
+가상 환경을 시작하고 나면 `python`이라고만 해도 지정한 버전의 파이썬이 실행되기 때문에 `python3` 대신 `python`이라고 입력해도 된답니다.
 
-의존성 설치를 모두 마쳤으니, 지금부터 장고를 설치할 수 있습니다!
+자, 이제 필요한 것들이 준비되었어요. 드디어 장고를 설치할 수 있어요!
 
-## 장고 설치하기
+## Django 설치하기
 
-`virtualenv`를 실행하기 전, 장고를 설치합시다.
+Now that you have your `virtualenv` started, you can install Django.
 
-그전에 장고를 설치하는 데 필요한 `pip`이 최신 버전인지 확인합니다. :
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~$ pip install --upgrade pip
-```
-그런 다음 `pip install django~=1.11.0`(Django를 설치하려면 물결표 뒤에 등호 :`~=`)를 입력해 장고를 설치하세요.
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~$ pip install django~=1.11.0
-Collecting django~=1.11.0
-  Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
-Installing collected packages: django
-Successfully installed django-1.11.3
-```
 
-<!--sec data-title="Windows" data-id="django_err_windows" data-collapse=true ces-->
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
 
-> **Note** Windows에서 pip를 사용할 때 오류가 발생하면, 프로젝트 경로 이름(예: `C:\Users\User Name\djangogirls`)에 공백, 액센트 또는 특수 문자가 포함되어 있는지 확인하세요. 그렇다면 공백, 악센트 또는 특수 문자가 없는 다른 경로를 사용하세요. (제안: `C:\djangogirls`). 새 디렉토리에 새 virtualenv를 만든 다음, 이전 가상 디렉토리를 삭제하고 위의 명령을 다시 시도하세요. virtualenv는 절대 경로를 사용하기 때문에 virtualenv 폴더를 이동해도 작동하지 않습니다. 
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). 디렉토리에 새로운 가상환경을 만들고, 이전 가상환경을 삭제한 후 명령을 다시 시도해보세요. (가상환경은 절대 경로를 사용하기 때몬에 경로를 변경하면 작동하지 않습니다)
 
 <!--endsec-->
 
-<!--sec data-title="Windows 8 / Windows 10" data-id="django_err_windows8and10" data-collapse=true ces-->
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
 
-> Windows에서 pip를 사용할 때 오류가 발생하면, 프로젝트 경로 이름(예: `C:\Users\User Name\djangogirls`)에 공백, 액센트 또는 특수 문자가 포함되어 있는지 확인하세요. 그렇다면 공백, 악센트 또는 특수 문자가 없는 다른 경로를 사용하세요. (제안: `C:\djangogirls`). 새 디렉토리에 새 virtualenv를 만든 다음, 이전 가상 디렉토리를 삭제하고 위의 명령을 다시 시도하세요. virtualenv는 절대 경로를 사용하기 때문에 virtualenv 폴더를 이동해도 작동하지 않습니다. 
+> 장고 설치 시, 커맨드 라인이 멈출 수 있습니다. 이 경우, 아래 명령어를 사용하세요:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
 
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="django_err_linux" data-collapse=true ces-->
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> 우분투 12.04에서 오류가 발생했다면 `python -m pip install -U --force-reinstall pip` 명령으로 가상환경 내의 pip를 고쳐주세요.
 
-> Ubuntu 12.04에서 pip를 사용하다 오류가 발생해 virtualenv에 pip를 재설치하려면 `python -m pip install -U --force-reinstall pip`를 실행하세요.
 <!--endsec-->
 
-여기까지 입니다! 이제 정말 장고 애플리케이션을 생성해봅시다!
+잘했어요! 드디어 장고 어플리케이션을 만들 준비가 끝났습니다!
\ No newline at end of file
diff --git a/ko/django_models/README.md b/ko/django_models/README.md
index 5b5e6fb41bb..3de0f55a2fc 100755
--- a/ko/django_models/README.md
+++ b/ko/django_models/README.md
@@ -1,95 +1,103 @@
-# 장고 모델
+# Django 모델
 
-이번에는 블로그 내 모든 포스트를 저장하는 부분을 만들 거에요. 먼저 우리는 `객체(object)`에 대해서 조금 알고 있어야 해요.
+이번에 우리가 만들고자 하는 부분은 블로그 내 모든 포스트를 저장하는 부분이에요. 먼저 우리는 `객체(object)`에 대해서 조금 알고 있어야해요.
 
 ## 객체(Object)
 
-프로그래밍 개발 방법 중에는 `객체 지향 프로그래밍(object oriented programming)`이라 부르는 개념이 있어요. 이 개발 방법은 프로그램이 어떻게 작동해야 하는지 모든 것을 하나하나 지시하는 것 대신, 모델을 만들어 그 모델이 어떤 역할을 가지고 어떻게 행동해야 하는지 정의하여 서로 알아서 상호작용할 수 있도록 만드는 것입니다.
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
 
-그렇다면 객체란 무엇일까요? 객체란 속성과 행동을 모아놓은 것이라 할 수 있어요. 객체란 개념이 낯설게 느껴지지만, 예를 들어보면 별것 아님을 알게 될 거에요.
+그렇다면 객체란 무엇일까요? 객체란 속성과 행동을 모아놓은 것이라고 할 수 있어요. 낯설게 느껴지지만 예를 들어보면 별 것 아님을 알게 될 거에요.
 
-예를 들어 `고양이(Cat)`라는 객체를 모델링 한다고 해볼게요. 이 고양이는 여러 속성을 가지고 있어요: `색깔`, `나이`, `분위기`(착한, 나쁜, 졸려 하는), `주인`(주인이 `사람`일 수도 있지만, 길고양이면 주인이 없으니 속성이 빈 값이 될 수 있어요) 등이 될 수 있겠지요.
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
 
-또 `고양이는` 특정 행동을 할 수 있어요: `야옹야옹하기`, `긁기`, 또는 `먹기` 등이 있겠네요. (`맛`과, 고양이에게 `고양이 먹이`는 행동하는 객체가 달라요).
+또 `고양이는` 특정 행동을 할 수 있어요: `야옹야옹하기`, `긁기`, 또는 `먹기` 등이 있겠네요. (`맛`과, 고양이에게 `고양이먹이`는 행동하는 객체가 달라요).
 
-    고양이
+    Cat
     --------
-    색깔
-    나이
-    분위기
-    주인
-    야옹야옹하기()
-    긁기()
-    먹기(음식)
-
-    고양이먹이
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
     --------
-    맛
+    taste
+    
 
+기본적으로 객체지향설계 개념은 현실에 존재하는 것을 속성과 행위로 나타내는 것입니다. 여기서 속성은 `객체 속성(properties)`, 행위는 `메서드(methods)`로 구현됩니다).
 
-  기본적으로 객체지향설계 개념은 현실에 존재하는 것을 속성과 행위로 나타내는 것입니다. 여기서 속성은 `객체 속성(properties)`, 행위는 `메서드(methods)`로 구현됩니다.
+그렇다면 블로그 글을 모델로 만들 수 있을까요? 우리는 블로그를 만들고 싶잖아요, 그렇죠?
 
-  그렇다면 블로그 글을 모델로 만들 수 있을까요? 우리는 블로그를 만들고 싶잖아요, 그렇죠?
+우리는 다음 질문에 답할 수 있어야 해요: 블로그 글이란 무엇일까? 어떤 속성들을 가져야 할까?
 
-  우리는 다음 질문에 답할 수 있어야 해요: 블로그 글이란 무엇일까? 어떤 속성들을 가져야 할까?
+블로그는 제목과 내용이 필요하죠? It would be also nice to know who wrote it – so we need an author. 마지막으로, 그 글이 작성된 날짜와 게시된 날짜도 알면 좋겠어요.
 
-  블로그는 제목과 내용이 필요하죠? 그리고 누가 썼는지도 알 수 있게 작성자(author)도 추가하면 좋을 것 같아요. 마지막으로, 그 글이 작성된 날짜와 게시된 날짜도 알면 좋겠어요.
-
-    Post(게시글)
+    Post
     --------
-    title(제목)
-    text(내용)
-    author(글쓴이)
-    created_date(작성일)
-    published_date(게시일)
-
+    title
+    text
+    author
+    created_date
+    published_date
+    
 
-  블로그 글로 할 수 있는 것은 어떤 것들이 있을까요? 글을 출판하는 `메서드(method)`가 있으면 좋겠죠?
+블로그 글로 할 수 있는 것은 어떤 것들이 있을까요? 글을 출판하는 `메서드(method)`가 있으면 좋겠죠?
 
-  그래서 우리는 `publish`메서드도 만들어야 합니다.
+그래서 우리는 `publish` 메서드도 만들어야 합니다.
 
-  이제 무엇을 만들어야 하는지 이미 알았으니, 장고에서 모델을 만들어 봅시다!
+이제 무엇을 만들어야하는지 이미 알았으니, 장고에서 모델을 만들어 봅시다!
 
 ## 장고 모델
 
-객체(object)가 어떻게 구성되어야 하는지 이전에 살펴봤으니, 이번에는 블로그 글을 위한 장고 모델을 만들어봅시다.
+객체(object) 가 어떻게 구성되어야 하는지 이전에 살펴봤으니, 이번에는 블로그 글을 위한 장고 모델을 만들어봅시다.
 
-장고 안의 모델은 객체의 특별한 종류입니다. 이 모델을 저장하면 그 내용이 `데이터베이스`에 저장되는 것이 특별한 점이죠. 데이터베이스란 데이터의 집합입니다. 데이터들이 모여 있는 곳이지요. 이곳에 사용자에 대한 정보나 여러분의 블로그 글 등등이 저장되어 있습니다. 우리는 데이터를 저장하기 위해서 여러 가지 데이터베이스를 입맛에 맞게 고를 수 있는데요, 여기서는 SQLite 데이터베이스를 사용하겠습니다. 'sqlite 데이터베이스는 기본 장고 데이터베이스 어댑터입니다.'라는 것까지만 알고 있어도 충분해요. 어댑터가 무엇인지를 알려면 내용이 너무 길어지니 일단 여기까지만 알고 계세요.
+A model in Django is a special kind of object – it is saved in the `database`. 데이터베이스란 데이터의 집합입니다. 데이터들이 모아져 있는 곳이지요. 이곳에 유저에 대한 정보나 여러분의 블로그 글 등등이 저장되어 있습니다. 우리는 데이터를 저장하기 위해서 여러가지 데이터베이스를 입맛에 맞게 고를 수 있는데요, 여기서는 SQLite 데이터베이스를 사용하겠습니다. This is the default Django database adapter – it'll be enough for us right now.
 
-쉽게 말해 데이터베이스 안의 모델이란 엑셀 스프레드시트와 같다고 말할 수 있어요. 엑셀 스프레드시트를 보면 열(필드)와 행(데이터)로 구성되어 있죠? 모델도 마찬가지입니다.
+쉽게 말해 데이터베이스안의 모델이란 엑셀 스프레드시트와 같다고 말할 수 있어요. 엑셀 스프레드시트를 보면 열(필드) 와 행(데이터) 로 구성되어 있죠? 모델도 마찬가지입니다.
 
-### 어플리케이션 만들기
+### 어플리케이션 제작하기
 
-잘 정돈된 상태에서 시작하기 위해, 프로젝트 내부에 별도의 애플리케이션을 만들어볼 거에요. 처음부터 모든 것이 잘 준비되어있다면 훌륭하죠. 애플리케이션을 만들기 위해 콘솔 창(`djangogirls` 디렉토리에서 `manage.py` 파일)에서 아래 명령어를 실행하세요.
+잘 정돈된 상태에서 시작하기 위해, 프로젝트 내부에 별도의 어플리케이션을 만들어볼 거에요. 처음부터 모든 것이 잘 준비되어있다면 훌륭하죠. 어플리케이션을 만들기 위해 콘솔창(`djangogirls` 디렉토리에서 `manage.py` 파일)에서 아래 명령어를 실행하세요.
 
-{% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py startapp blog
-```
+{% filename %}Mac OS X and Linux:{% endfilename %}
 
-이제 `blog`디렉터리가 생성되고 그 안에 여러 파일도 같이 들어있는 것을 알 수 있어요. 현재 디렉리와 파일들은 다음과 같을 거예요. :
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
 
-```
     djangogirls
-    ├── mysite
-    |       __init__.py
-    |       settings.py
-    |       urls.py
-    |       wsgi.py
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
     ├── manage.py
-    └── blog
-        ├── migrations
-        |       __init__.py
+    └── mysite
         ├── __init__.py
-        ├── admin.py
-        ├── models.py
-        ├── tests.py
-        └── views.py
-```
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
 
-애플리케이션을 생성한 후 장고에 사용해야 한다고 알려줘야 합니다. 이 역할을 하는 파일이 `mysite/settings.py`입니다. 이 파일 안에서 `INSTALLED_APPS`를 열어, `)`바로 위에 `'blog'`를 추가하세요. 최종 결과물은 아래와 다음과 같을 거예요. :
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 INSTALLED_APPS = [
     'django.contrib.admin',
@@ -104,18 +112,19 @@ INSTALLED_APPS = [
 
 ### 블로그 글 모델 만들기
 
-모든 `Model` 객체는 `blog/models.py` 파일에 선언하여 모델을 만듭니다. 이 파일에 우리의 블로그 글 모델도 정의할 거에요.
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
 
-`blog/models.py` 파일을 열어서 안에 모든 내용을 삭제한 후 아래 코드를 추가하세요.
+Let's open `blog/models.py`, remove everything from it, and write code like this:
 
 {% filename %}blog/models.py{% endfilename %}
+
 ```python
 from django.db import models
 from django.utils import timezone
 
 
 class Post(models.Model):
-    author = models.ForeignKey('auth.User')
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
     created_date = models.DateTimeField(
@@ -131,54 +140,60 @@ class Post(models.Model):
         return self.title
 ```
 
-> `str`양 옆에 언더스코어(`_`) 를 두 개씩 넣었는지 다시 확인하세요. 파이썬에서 자주 사용되는데, "던더(dunder; 더블-언더스코어의 준말)"라고도 불려요.
+> `str`양 옆에 언더스코어(`_`) 를 두 개씩 넣었는지 다시 확인하세요. 이건 관습은 파이썬에서 자주 사용되는데, "던더(dunder; 더블-언더스코어의 준말)"라고도 불려요.
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
 
-으음…. 코드가 좀 무서워졌죠? 걱정 마세요. 줄마다 어떤 의미인지 설명해드릴 거에요.
+`class Post(models.Model):` – this line defines our model (it is an `object`).
 
-`from` 또는 `import`로 시작하는 부분은 다른 파일에 있는 것을 추가하라는 뜻입니다. 다시 말해, 매번 다른 파일에 있는 것을 복사&붙여넣기로 해야 하는 작업을 `from`이 대신 불러와 주는 거죠.
+- `class`는 특별한 키워드로, 객체를 정의한다는 것을 알려줍니다.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model`은 Post가 장고 모델임을 의미합니다. 이 코드 때문에 장고는 Post가 데이터베이스에 저장되어야 된다고 알게 됩니다.
 
-`class Post(models.Model):`는 모델을 정의하는 코드입니다. (모델은 `객체(object)`라고 했죠?)
-* `class`는 특별한 키워드로, 객체를 정의한다는 것을 알려줍니다.
-* `Post`는 모델의 이름입니다. (특수문자와 공백 제외한다면) 다른 이름을 붙일 수도 있습니다. 항상 클래스 이름의 첫 글자는 대문자로 써야 합니다.
-* `models`은 Post가 장고 모델임을 의미합니다. 이 코드 때문에 장고는 Post가 데이터베이스에 저장되어야 한다고 알게 됩니다.
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
 
-이제 속성을 정의하는 것에 대해서 이야기해 볼게요. `title`, `text`, `created_date`, `published_date`, `author`에 대해서 말할 거에요. 속성을 정의하기 위해, 필드마다 어떤 종류의 데이터 타입을 가지는지를 정해야 해요. 여기서 데이터 타입에는 텍스트, 숫자, 날짜, 사용자 같은 다른 객체 참조 등이 있습니다.
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
 
-*   `models.CharField` - 글자 수가 제한된 텍스트를 정의할 때 사용합니다. 글 제목같이 짧은 문자열 정보를 저장할 때 사용합니다.
-*   `models.TextField` - 글자 수에 제한이 없는 긴 텍스트를 위한 속성입니다. 블로그 콘텐츠를 담기 좋겠죠?
-*   `models.DateTimeField` - 날짜와 시간을 의미합니다.
-*   `models.ForeignKey` - 다른 모델에 대한 링크를 의미합니다.
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
 
-시간 관계상 모든 코드를 하나하나 다 설명하지는 않을 거예요. 대신 모델의 필드와 정의하는 방법에 궁금하다면 장고 공식 문서를 꼭 읽어보길 바랍니다. : https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types)
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
 
-`def publish(self):`는 무슨 뜻일까요? 이것이 바로 앞서 말했던 `publish`라는 메서드(method) 입니다. `def`는 이것이 함수/메서드라는 뜻이고, `publish`는 메서드의 이름입니다. 원한다면 메서드 이름을 변경할 수도 있어요. 이름을 붙일 때는 공백 대신, 소문자와 언더스코어를 사용해야 합니다. 예를 들어, 평균 가격을 계산하는 메서드는 `calculate_average_price`라고 부를 수 있겠네요.
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
 
-메서드는 자주 무언가를 되돌려주죠. (`return`) 그 예로 `__str__` 메서드를 봅시다. 이 시나리오대로라면, `__str__`를 호출하면 Post 모델의 제목 텍스트(**string**)를 얻게 될 거에요.
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
 
-아직 모델에 대해서 잘 모르는 부분이 있다면, 코치에게 자유롭게 물어보세요! 지금 배운 내용이 너무 복잡하게 느껴질 수 있어요. 객체와 함수를 배운 적이 없는 분들이 한꺼번에 배우게 된다면 특히 그렇겠죠. 그래도 해 볼 만한 마법이라고 생각했으면 좋겠어요!
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
 
 ### 데이터베이스에 모델을 위한 테이블 만들기
 
-이 장의 마지막 단계입니다. 이제 데이터베이스에 우리의 새 모델, Post 모델을 추가할 거에요. 먼저 우리는 장고 모델에 (우리가 방금 만든!) 몇 가지 변화가 생겼다는 걸 알게 해줘야 합니다. `python manage.py makemigrations blog` 를 입력해 보세요. 아마도 화면에 이렇게 보이겠죠?
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py makemigrations blog
-Migrations for 'blog':
-  blog/migrations/0001_initial.py:
-  - Create model Post
-```
 
-장고는 데이터베이스에 지금 반영할 수 있도록 마이그레이션 파일(migration file)이라는 것을 준비해 두었답니다. 이제 `python manage.py migrate blog` 명령을 실행해, 실제 데이터베이스에 모델 추가를 반영하겠습니다. :
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py migrate blog
-Operations to perform:
-  Apply all migrations: blog
-Running migrations:
-  Rendering model states... DONE
-  Applying blog.0001_initial... OK
-```
 
-만세! 드디어 글 모델이 데이터베이스에 저장되었습니다. 너무 멋있지 않나요? 빨리 다음 장으로 넘어가서 블로그 글을 확인하러 가요!
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ko/django_orm/README.md b/ko/django_orm/README.md
index cb7d5d9c5ae..677611968e4 100755
--- a/ko/django_orm/README.md
+++ b/ko/django_orm/README.md
@@ -1,37 +1,39 @@
-# 장고 ORM과 쿼리셋(QuerySets)
+# Django ORM과 QuerySets(쿼리셋)
 
 이번 장에서는 장고를 데이터베이스에 연결, 데이터를 저장하는 방법에 대해서 알아볼 거에요. 함께 시작해봅시다!
 
-## 쿼리셋이란 무엇인가요?
+## 쿼리셋(QuerySet) 은 무엇인가요?
 
-핵심만 말하자면, 쿼리셋(QuerySet)은 전달받은 모델의 객체 목록입니다. 쿼리셋은 데이터베이스로부터 데이터를 읽고, 필터를 걸거나 정렬을 할 수 있습니다.
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
 
 가장 쉽게 배우는 방법은 예제로 배우는 것이죠. 함께 해볼까요?
 
 ## 장고 쉘(shell)
 
-PythonAnywhere가 아닌 로컬 콘솔에서 아래 명령을 입력하세요.
+PythonAnywhere가 아닌 로컬 컨솔에서 아래 명령을 입력하세요. :
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py shell
-```
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
 
 실행하면 아래처럼 나올 거에요.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 (InteractiveConsole)
 >>>
 ```
 
-여러분은 이제 장고 인터랙티브 콘솔(interactive console)로 들어왔습니다. 파이썬 프롬프트와 비슷하지만, 장고만의 마법을 부릴 수 있는 곳이기도 하지요. 물론 파이썬의 모든 명령어를 여기서 사용할 수 있습니다.
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
 
-### 모든 객체 조회하기
+### 모두 보기
 
-자, 이제 먼저 입력했던 모든 글들을 출력하겠습니다. 아래와 같이 입력하세요. :
+자, 이제 먼저 입력했던 모든 글들을 출력하겠습니다. 아래와 같이 입력하세요.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.all()
 Traceback (most recent call last):
@@ -39,61 +41,68 @@ Traceback (most recent call last):
 NameError: name 'Post' is not defined
 ```
 
-이런! 에러가 나타났어요. 글이 없다고 하네요. 이럴수가... 그런데 이렇게 나오는 것이 맞는 거랍니다. 이 글을 먼저 불러오는 것(import)을 잊었네요!
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> from blog.models import Post
 ```
 
-간단합니다. 우리는 `Post`모델을 `blog.models`에서 불러왔어요. 이제 모든 글을 출력해봅시다.
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.all()
 <QuerySet [<Post: my post title>, <Post: another post title>]>
 ```
 
-게시된 글 목록이 나타났네요! 장고 관리자 인터페이스로 만들었던 것들이에요. 그런데 파이썬으로 새 글을 포스팅하려면, 어떻게 해야 할까요?
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
 
 ### 객체 생성하기
 
 데이터베이스에 새 글 객체를 저장하는 방법에 대해 알아봅시다.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.create(author=me, title='Sample title', text='Test')
 ```
 
-하지만 여기에 뭔가 빼먹은 것이 하나 있어요. `me`(나)를 빼먹었네요. 작성자로서 `User`(사용자) 모델의 인스턴스를 가져와 전달해줘야 합니다. 어떻게 해야 할까요?
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
 
 먼저 User 모델을 불러옵니다. :
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> from django.contrib.auth.models import User
 ```
 
-데이터베이스에서 user는 어떤 일을 할까요? 함께 알아봅시다. :
+데이터베이스에서 user는 어떤 일을 할까요? 함께 알아봅시다:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> User.objects.all()
 <QuerySet [<User: ola>]>
 ```
 
-슈퍼유저로 등록했었던 그 사용자군요! 이제 이 사용자의 인스턴스(instance)를 가져와 봅시다. :
+This is the superuser we created earlier! Let's get an instance of the user now:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> me = User.objects.get(username='ola')
 ```
 
-보았듯이 `사용자이름(username)`이 'ola'인 `User` 인스턴스를 받아왔어요. 사용자 이름을 바꿨다면, 바뀐 이름을 넣어줘야겠죠.
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
 
-드디어 우리 게시물을 만들었네요 :
+드디어 우리 게시물을 만들었네요. :
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.create(author=me, title='Sample title', text='Test')
 ```
@@ -101,62 +110,70 @@ NameError: name 'Post' is not defined
 만세! 그런데 제대로 작동했는지 확인해봐야죠?
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.all()
 <QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
 ```
 
-보세요, 목록에 게시글 하나가 더 늘었네요!
+보세요, 목록에 게시글 하나가 더 늘었네요! 
 
 ### 글 더 추가하기
 
-점점 재밌어질 거에요. 몇 개 글을 더 추가해서 잘 작동하는지 확인하세요. 2-3개 정도만 더 추가해보고 다음 내용으로 넘어갈게요.
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
 
 ### 필터링하기
 
-쿼리셋의 중요한 기능은 데이터를 필터링하는 거예요. 예를 들어, 우리는 ola라는 사용자가 작성한 모든 글을 찾고 싶다고 해볼게요. 이런 경우 `Post.objects.all()`에서 `all`대신, `filter`를 사용합니다. 쿼리셋 안에 있는 괄호 안에 원하는 조건을 넣어줄 거예요. 지금 이 경우에는 `작성자(author)`가 `나(me)`인 조건을 넣어야겠죠. 이걸 장고로 표현한다면 `author=me`가 됩니다. 이제 이 조건이 반영된 코드를 볼까요.
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. 이런 경우 `Post.objects.all()`에서 `all` 대신, `filter`를 사용합니다. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. 이제 이 조건이 반영된 코드를 볼까요. :
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.filter(author=me)
 [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
 ```
 
-모든 글들 중, `제목(title)`에 'title'이라는 글자가 들어간 글들만을 뽑아내서 보고 싶다면요?
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> Post.objects.filter(title__contains='title')
+>>> Post.objects.filter( title__contains='title' )
 [<Post: Sample title>, <Post: 4th title of post>]
 ```
 
-> **Note**  `title`와 `contains` 사이에 있는 밑줄(`_`)이 2개(`__`)입니다. 장고 ORM은 필드 이름("title")과 연산자과 필터("contains")를 밑줄 2개를 사용해 구분합니다. 밑줄 1개만 입력한다면, `FieldError: Cannot resolve keyword title_contains`라는 오류가 뜰 거예요.
+> **주의하세요** `title`와 `contains` 사이에 있는 밑줄(`_`)이 2개입니다. 장고 ORM은 필드 이름("title")과 연산자과 필터("contains")를 밑줄 2개를 사용해 구분합니다. If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
 
-게시글 목록을 볼 수 있어요. `게시일(published_date)`로 과거에 작성한 글을 필터링하면 목록을 불러올 수 있어요.
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> from django.utils import timezone
 >>> Post.objects.filter(published_date__lte=timezone.now())
 []
 ```
-안타깝게도, 파이썬 콘솔에서 추가한 게시물은 아직 보이지 않네요. 하지만 바꿀 수 있어요! 먼저 게시하려는 게시물의 인스턴스를 얻어야 해요.
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> post = Post.objects.get(title="Sample title")
 ```
 
-그리고 `publish`메서드를 사용해서 게시합시다!
+그리고 `publish` 메서드를 사용해서 출판합시다:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> post.publish()
 ```
 
-이제 (위쪽 화살표 버튼 3번을 누르고 `enter`를 눌러) 다시 게시된 글의 목록을 가져와 봅시다.
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.filter(published_date__lte=timezone.now())
 [<Post: Sample title>]
@@ -164,37 +181,38 @@ NameError: name 'Post' is not defined
 
 ### 정렬하기
 
-퀘리셋은 객체 목록을 정렬할 수 있어요. 이제 `created_date`필드를 정렬해봅시다.
+퀘리셋은 객체 목록을 정렬도 할 수 있어요. 이제 `created_date` 필드를 정렬해봅시다. :
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.order_by('created_date')
 [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
 ```
 
-`-`을 맨 앞에 붙여주면 내림차순 정렬도 가능해요.
+`-`을 맨 앞에 붙여주면 내림차순으로 정렬도 가능해요. :
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.order_by('-created_date')
 [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
 ```
 
-### 쿼리셋 연결하기
+### 쿼리셋(QuerySets) 연결하기
 
-쿼리셋들을 함께 **연결(chaining)**할 수 있어요.
+쿼리셋들을 함께 **연결(chaining)**할 수도 있어요.
 
-{% filename %}command-line{% endfilename %}
-```
->>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-```
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
 
 이 방법은 정말 강력해 복잡한 쿼리도 작성할 수 있게 해준답니다.
 
 좋아요! 이제 다음 내용으로 넘어갈 때로군요! 다음 명령을 입력해, 쉘을 종료하세요. :
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> exit()
 $
-```
+```
\ No newline at end of file
diff --git a/ko/django_start_project/README.md b/ko/django_start_project/README.md
index 7e1b2e9bdc0..b1df6d43890 100755
--- a/ko/django_start_project/README.md
+++ b/ko/django_start_project/README.md
@@ -1,65 +1,65 @@
-# 나의 첫 번째 장고 프로젝트!
+# 나의 첫 번째 Django 프로젝트!
 
-> **Note** 이 장의 일부는 Geek Girls Carrots (http://django.carrots.pl/)의 튜토리얼을 기초로 작성되었습니다.
+> 이번 장의 일부는 Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)의 튜토리얼을 바탕으로 작성되었습니다.
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Django-marcador 튜토리얼은 Markus Zapke-Gründemann et al에게 저작권이 있습니다.
 
+We're going to create a small blog!
 
-> **Note** 이 장의 일부는 Creative Commons Attribution-ShareAlike 4.0 International License에 준수하여 [django-marcador 튜토리얼](https://github.com/ggcarrots/django-carrots)를 기초로 작성되었습니다. django-marcador 튜토리얼 저작권은 Markus Zapke-Gründemann et al이 소유하고 있습니다.
+첫 단계는 장고 프로젝트를 시작하는 거에요. 다시 말해 장고의 기본 골격을 만들어주는 스크립트를 실행할 거에요. 이 디렉토리와 파일 묶음은 나중에 사용할 것입니다.
 
-아주 간단한 블로그 사이트를 만들어 볼 거예요!
+장고에서는 디렉토리나 파일 이름이 매우 중요하답니다. 우리가 생성할 그 파일들의 이름을 마음대로 변경해서는 안됩니다. 또한 그 파일들을 다른 곳으로 옮겨도 안됩니다. 장고는 중요한 것들을 찾을 수 있게 특정한 구조를 유지해야합니다.
 
-첫 단계는 장고 프로젝트를 시작하는 거예요. 다시 말해 장고의 기본 골격을 만들어주는 스크립트를 실행할 거예요. 이 디렉토리와 파일 묶음은 나중에 사용할 것입니다.
+> 모든 것은 가상환경(virtualenv) 안에서 해야한다는 것을 기억하세요. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. **Django 설치하기**장의 **virtualenv 작동법**에서 이미 다루었던 내용입니다. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
 
-장고에서는 디렉토리와 파일명이 매우 중요하답니다. 파일명을 마음대로 변경해서도 안되고 다른 곳으로 옮겨도 안됩니다. 장고는 중요한 것들을 찾을 수 있게 특정한 구조를 유지해야 합니다.
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
 
-> 모든 작업은 가상환경(virtualenv) 안에서 해야 하는 것을 꼭 기억하세요. 현재 콘솔 창에서 접두어로 `(myvenv)`가 안 보인다면 먼저 virtualenv를 활성화해야 합니다. **Django 설치하기** 장에서 **virtualenv 작동법**에 대해 배웠어요. 윈도우에서는 `myvenv\Scripts\activate`를 타이핑하고, 맥 OS과 리눅스에서는 `source myvenv/bin/activate`을 입력하세요.
-
-<!--sec data-title="OS X / Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
-
-맥 OS과 리눅스 콘솔에서는 다음과 같이 명령을 실행해야해요. **명령어 끝에 `.`(점, 마침표)을 입력하는 것을 잊지마세요.** :
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ django-admin startproject mysite .
-```
 
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
 
-> 점 `.`은 현재 디렉토리에 장고를 설치하라고 스크립트에 알려주기 때문에 중요해요. (축약된 표시입니다)
->
-> **Note** 위 명령을 입력할 때 `django-admin`로 시작하는 부분만 입력하세요. 여기에 보이는 `(myvenv) ~/djangogirls$`부분은 커맨드 라인에 입력을 가져오게 하는 메세지(프롬트프 prompt)입니다.
+> 점 `.`은 현재 디렉토리에 장고를 설치하라고 스크립트에 알려주기 때문에 중요해요. (축약된 표시이죠).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
 
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
 
-윈도우에서도 **명령 끝에 `.`(점)을 입력하는 것을 잊지마세요** :
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) C:\Users\Name\djangogirls> django-admin.py startproject mysite .
-```
 
-> 점 `.`은 현재 디렉토리에 장고를 설치하라고 스크립트에 알려주기 때문에 중요해요. (축약된 표시입니다)
->
-> **Note** 위 명령을 입력할 때 `django-admin.py`로 시작하는 부분만 입력하세요. 여기에 보이는 `(myvenv) C:\Users\Name\djangogirls>`부분은 커맨드 라인에 입력을 가져오게 하는 메세지(프롬프트 prompt)입니다.
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> 점 `.`은 현재 디렉토리에 장고를 설치하라고 스크립트에 알려주기 때문에 중요해요. (축약된 표시이죠).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
 
 <!--endsec-->
 
-`django-admin.py`은 스크립트로 디렉토리와 파일들을 생성합니다. 스크립트 실행 후에는 아래와 같이 새로 만들어진 디렉토리 구조를 볼 수 있을 거예요.
+`django-admin.py`은 스크립트로 디렉토리와 파일들을 생성해줍니다. 스크립트 실행 후에는 아래와 같이 새로 만들어진 디렉토리 구조를 볼 수 있을 거에요.
 
     djangogirls
     ├───manage.py
-    └───mysite
-            settings.py
+    └───mysite
+            settings.py
             urls.py
             wsgi.py
             __init__.py
+    
 
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
 
-`manage.py`는 스크립트인데, 사이트 관리를 도와주는 역할을 합니다. 이 스크립트로 다른 설치 작업 없이, 컴퓨터에서 웹 서버를 시작할 수 있습니다.
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
 
 `settings.py`는 웹사이트 설정이 있는 파일입니다.
 
-앞에 우편배달부는 어느 곳으로 편지를 배달해야 하는지 판단해야 한다고 말했던 것을 기억하고 있나요? `urls.py`파일은 `urlresolver`가 사용하는 패턴 목록을 포함하고 있습니다.
+앞에 우편 배달부는 어느 곳으로 편지를 배달해야하는지 판단해야한다고 말했던 것을 기억하고 있나요? `urls.py` 파일은 `urlresolver`가 사용하는 패턴 목록을 포함하고 있습니다.
 
 지금 그 파일들을 수정하지 않을 거니 무시하세요. 실수로 파일을 지우지 않게 조심하세요!
 
@@ -67,42 +67,57 @@
 
 `mysite/settings.py`을 조금 고쳐 볼게요. 설치한 코드 에디터를 열어 파일을 열어주세요.
 
-웹사이트에 정확한 현재 시간을 넣으면 좋겠죠. [위키피디아 타임존 리스트][2]에 가서 해당 시간대(타임존)를 복사하세요. (예: `Asia/Seoul`)
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
 
- [2]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+웹사이트에 정확한 현재 시간을 넣으면 좋겠죠. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
 
-Settings.py에서 `TIME_ZONE`있는 줄을 찾으세요. 그리고 이를 해당 시간대로 변경하세요.
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
-    TIME_ZONE = 'Asia/Seoul'
+TIME_ZONE = 'Europe/Berlin'
 ```
 
-다음으로 정적파일 경로를 추가할 거에요. (정적 파일은 튜토리얼 후반부에서 CSS와 함께 다룰 거에요) 파일의 *끝(end)*으로 내려가서, `STATIC_URL`항목 바로 아래에 `STATIC_ROOT`을 추가하세요.
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 STATIC_URL = '/static/'
 STATIC_ROOT = os.path.join(BASE_DIR, 'static')
 ```
 
-`DEBUG`가`True`이고 `ALLOWED_HOSTS`가 비어 있으면, 호스트는 `['localhost', '127.0.0.1', '[::1]']`에 대해서 유효합니다. 애플리케이션을 배포할 때 PythonAnywhere의 호스트 이름과 일치하지 않으므로 다음 설정을 아래와 같이 변경해줘야 합니다. :
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
 ```
 
-> **Note** 크롬북 사용자는, `settings.py` 맨 마지막 줄에 아래 코드를 추가하세요. :
-> `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
 
-## 데이터베이스 설정하기
+## Set up a database
 
-사이트 내 데이터를 저장하기 위한 많은 다양한 데이터베이스 소프트웨어들이 있습니다. 그중에서 우리는 `sqlite3`을 사용할 거예요.
+사이트 내 데이터를 저장하기 위한 많은 다양한 데이터베이스 소프트웨어들이 있습니다. 그 중에서 우리는 `sqlite3`을 사용할 거에요.
 
-이미 `mysite/settings.py`파일 안에 설치가 되어있어요.
+사실 이미 `mysite/settings.py` 파일 안에 설치가 되어있어요. :
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 DATABASES = {
     'default': {
@@ -112,77 +127,76 @@ DATABASES = {
 }
 ```
 
-블로그에 데이터베이스를 생성하기 위해서 콘솔 창에서 아래 코드를 실행하세요. : `python manage.py migrate` (이 명령을 실행하기 위해서는 `djangogirls`디렉터리 안에 있는 `manage.py`가 필요합니다)
-
-잘 작동되면, 아래와 같은 내용이 나옵니다.
+블로그에 데이터베이스를 생성하기 위해서 콘솔창에서 아래 코드를 실행하세요: `python manage.py migrate` (이 명령을 실행하기 위해서는 `djangogirls`디렉토리 안에 있는 `manage.py` 필요합니다.) 잘 작동되면, 아래와 같은 내용이 나옵니다. :
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py migrate
-Operations to perform:
-  Apply all migrations: auth, admin, contenttypes, sessions
-Running migrations:
-  Rendering model states... DONE
-  Applying contenttypes.0001_initial... OK
-  Applying auth.0001_initial... OK
-  Applying admin.0001_initial... OK
-  Applying admin.0002_logentry_remove_auto_add... OK
-  Applying contenttypes.0002_remove_content_type_name... OK
-  Applying auth.0002_alter_permission_name_max_length... OK
-  Applying auth.0003_alter_user_email_max_length... OK
-  Applying auth.0004_alter_user_username_opts... OK
-  Applying auth.0005_alter_user_last_login_null... OK
-  Applying auth.0006_require_contenttypes_0002... OK
-  Applying auth.0007_alter_validators_add_error_messages... OK
-  Applying sessions.0001_initial... OK
-```
-
-잘했어요! 이제 웹 서버를 시작해 웹 사이트가 잘 작동하는지 확인해봐요!
 
-프로젝트 디렉토리(`djangogirls`)에 `manage.py`파일이 있어야 합니다. 콘솔에서는 `python manage.py runserver`명령을 실행해, 웹 서버를 바로 시작할 수 있습니다.
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+잘했네요! 이제 웹 서버를 시작해 웹사이트가 잘 작동하는지 확인해봐요!
+
+## Starting the web server
+
+프로젝트 디렉토리(the `djangogirls` directory)에 `manage.py` 파일이 있어야 합니다. 콘솔에서는 `python manage.py runserver` 명령을 실행해, 웹서버를 바로 시작할 수 있습니다. :
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py runserver
-```
 
-크롬북 사용자는 아래 명령어를 입력하세요. :
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
 
 {% filename %}Cloud 9{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8000
-```
 
-윈도우에서 `UnicodeDecodeError`오류가 난다면 아래 명령을 대신 써보세요. :
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+윈도우에서 `UnicodeDecodeError`를 썼는데 오류가 난다면 아래 명령을 대신 써보세요. :
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py runserver 0:8000
-```
 
-웹 사이트가 모두 잘 작동하는지 확인해봐요. 사용하는 브라우저(파이어폭스, 크롬, 사파리, 인터넷 익스플로어 등 여러분의 원하는 대로)를 열어서 주소를 입력하세요.
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
 
 {% filename %}browser{% endfilename %}
-```
-http://127.0.0.1:8000/
-```
 
-크롬북 사용자는 항상 테스트 서버를 통해 접근해야 합니다.:
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
 
 {% filename %}browser{% endfilename %}
-```
-https://django-girls-<your cloud9 username>.c9users.io
-```
 
-축하해요! 여러분은 방금 웹 서버를 활용한 첫 웹사이트를 만들었어요! 정말 멋지죠?
+    https://django-girls-<your cloud9 username>.c9users.io
+    
 
-![It worked!](images/it_worked2.png)
+축하해요! 여러분은 방금 웹 서버를 활용한 첫 웹사이트를 만들었어요! 정말 멋지죠?
 
-웹 서버가 실행되는 동안 추가 명령을 입력 할 수있는 새로운 명령어 프롬프트가 표시되지 않습니다. 새 텍스트를 터미널에서 입력할 수 있지만 명령은 실행되지 않습니다. 웹 서버가 들어오는 요청을 수신 대기하기 위해 지속적으로 실행하고 있기 때문이에요.
+![잘 작동합니다!](images/it_worked2.png)
 
-> <b>인터넷은 어떻게 작동될까요</b> 장에서 웹 서버에 대해 배웠었어요.
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
 
+> We reviewed how web servers work in the **How the Internet works** chapter.
 
-웹 서버가 실행되는 동안 추가 명령을 입력하려면 새 터미널 창을 열고 virtualenv를 활성화하세요. 웹 서버를 중지하려면 실행중인 창으로 다시 전환하고 CTRL + C - Control+C 키를 함께 누르세요. (윈도우에서는 Ctrl + Break를 눌러야 할 수도 있습니다)
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
 
-다음 단계로 넘어갈 준비가 되셨나요? 새로운 것을 또 배워볼까요!
+다음 단계로 넘어갈 준비가 되셨나요? 이제는 새로운 내용을 만들어 볼 시간이에요!
\ No newline at end of file
diff --git a/ko/django_templates/README.md b/ko/django_templates/README.md
index 97fb55b67c8..4eaed4ba2c3 100755
--- a/ko/django_templates/README.md
+++ b/ko/django_templates/README.md
@@ -1,38 +1,41 @@
-# 장고 템플릿
+# Django 템플릿
 
-이제 데이터를 보여줄 차례에요! 이를 위해 장고는 내장된 __템플릿 태그(template tags)__ 라는 유용한 기능을 제공합니다.
+이제 데이터를 보여줄 차례에요! 이를 위해 장고는 내장된 **template tags**라는 유용한 기능을 제공합니다.
 
 ## 템플릿 태그는 무엇인가요?
 
-HTML에 여러분은 파이썬 코드를 바로 넣을 수 없어요. 브라우져는 파이썬 코드를 이해할 수 없기 때문이에요요 브라우저는 HTML만을 알고 있어요. 알다시피 HTML는 정적이지만, 파이썬은 동적입니다.
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
 
-**템플릿 태그**는 파이썬을 HTML로 바꿔주어, 빠르고 쉽게 동적인 웹 사이트를 만들 수 있게 도와주어요. 야호!
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
 ## post 목록 템플릿 보여주기
 
-이전 장에서 글 목록이 들어있는 `posts` 변수를 템플릿에 넘겨주었습니다. 이제 넘겨진 `posts`변수를 받아 HTML에 나타나도록 해볼 차례예요.
+이전 장에서 글 목록이 들어있는 `posts` 변수를 템플릿에 넘겨주었습니다. 이제 넘겨진 posts 변수를 받아서 HTML에 나타나도록 해볼 차례예요.
 
-장고 템플릿 안에 있는 값을 출력하려면, 변수 이름 안에 중괄호를 넣어 표시해야 합니다.
+장고 템플릿 안에 있는 값을 출력하려면, 변수 이름안에 중괄호를 넣어 표시해야합니다. 이렇게요. :
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {{ posts }}
 ```
 
-`blog/templates/blog/post_list.html` 템플릿에서 하세요. 두 번째 `<div>`에서 세 번째 `</div>`까지를 `{{ posts }}`로 바꾸세요. 파일을 저장하고 페이지를 새로고침하면 이렇게 보입니다.
+`blog/templates/blog/post_list.html` 템플릿에서 하세요. 두 번째 `<div>`에서 세 번째 `</div>`까지를 `{{ posts }}`로 바꾸세요. 파일을 저장하고 페이지를 새로 고침하면 이렇게 보입니다. :
 
-![Figure 13.1](images/step1.png)
+![그림 13.1](images/step1.png)
 
-아래와 같이 만들었어요 :
+우리는 아래와 같이 만들었어요. :
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
-[<Post: My second post>, <Post: My first post>]
+<QuerySet [<Post: My second post>, <Post: My first post>]>
 ```
 
-이는 장고가 `{{ posts }}`를 객체 목록으로 이해하고 처리했다는 것을 의미해요. **Python 시작하기** 장에서 어떻게 목록을 보여줬는지 기억하고 있나요? 맞아요, `for loop`을 이용해서죠! 장고 템플릿에서는 이렇게 써야 합니다.
+이는 장고가 {{ posts}} 를 객체들의 목록으로 이해하고 처리했다는 것을 의미해요. **파이썬 들어가기**에서 어떻게 목록을 보여줬는지 기억하고 있나요? 맞아요, for loop을 이용해서죠! 장고 템플릿에서는 이렇게 해야합니다. :
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     {{ post }}
@@ -41,12 +44,12 @@ HTML에 여러분은 파이썬 코드를 바로 넣을 수 없어요. 브라우
 
 여러분의 템플릿 파일에 적용해 보세요.
 
-![Figure 13.2](images/step2.png)
-
-잘 작동하네요! 그런데 디자인이 별로죠. 앞에서 **HTML 시작하기** 했던 정적 블로그 게시글들이 보이게 만들면 참 좋을텐데 말이에요. HTML과 템플릿 태그를 섞어 사용하면 멋있게 만들 수 있어요. `body`를 아래와 같이 수정하세요.
+![그림 13.2](images/step2.png)
 
+잘 작동하네요! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. HTML과 템플릿 태그를 섞어 사용하면 멋있게 만들 수 있어요. 우리의 `body`는 다음과 같을 거에요. :
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div>
     <h1><a href="/">Django Girls Blog</a></h1>
@@ -61,44 +64,43 @@ HTML에 여러분은 파이썬 코드를 바로 넣을 수 없어요. 브라우
 {% endfor %}
 ```
 
-{% raw %}`{% for %}` 와 `{% endfor %}`사이에 넣은 모든 것은 목록의 모든 객체를 반복하게 됩니다. 페이지를 새로고침 해보세요.{% endraw %}
+{% raw %} `{% for %}` 와 `{% endfor %}`사이에 넣은 모든 것은 목록의 모든 객체를 반복하게 됩니다. 페이지를 새로고침 해보세요: {% endraw %}
 
-![Figure 13.3](images/step3.png)
+![그림 13.3](images/step3.png)
 
-`{{ post.title }}`라던가 `{{ post.text }}`같이 이전과 다른 표기법을 사용한 것을 눈치채셨나요? `Post`모델에서 정의한 각 필드의 데이터에 접근하기 위해 이 표기법을 사용합니다. 또한 `|linebreaksbr`같이 파이프 문자(|)도 사용해요. 이건 블로그 글 텍스트에서 행이 바뀌면 문단으로 변환하도록 하라는 의미입니다. 행바뀜을 문단으로 변환하는 필터를 적용한다는 표현을 쓰기도 합니다.
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? `Post` 모델에서 정의한 각 필드의 데이터에 접근하기 위해 이 표기법을 사용합니다. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
 
 ## 한 가지 더
 
-나 혼자만 웹 사이트를 보는 게 아니라 다른 사람들도 인터넷으로 볼 수 있으면 참 좋겠죠? 이제 PythonAnywhere에 다시 여러분이 만든 블로그를 배포해봅시다. 아래에 각 단계별로 요약했어요.
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
 
 * 제일 먼저, Github에 여러분의 코드를 git의 push를 사용해서 넣으세요.
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-[...]
-$ git add --all .
-$ git status
-[...]
-$ git commit -m "Modified templates to display posts from database."
-[...]
-$ git push
-```
 
-* 다음 [PythonAnywhere](https://www.pythonanywhere.com/consoles/)로 돌아와 **Bash console**로 가서(또는 이미 닫았다면 새 콘솔창을 여세요), 다음 명령어를 실행하세요. :
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
 
-{% filename %}command-line{% endfilename %}
-```
-$ cd my-first-blog
-$ git pull
-[...]
-```
+* 다음 [PythonAnywhere](https://www.pythonanywhere.com/consoles/)로 돌아와 **배시 콘솔창**으로 가서(또는 이미 닫았다면 새 콘솔창을 여세요), 다음 명령어를 실행하세요. :
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
 
-* 마지막으로 [Web tab](https://www.pythonanywhere.com/web_app_setup/)에서 **Reload**를 누르세요. 업데이트 내용이 보여야 해요! PythonAnywhere 사이트의 블로그 게시물이 로컬 서버에 호스팅 된 블로그에 나타나는 게시물과 일치하지 않는 것이 정상입니다. 로컬 컴퓨터와 PythonAnywhere의 데이터베이스는 동기화되지 않습니다.
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
-축하합니다! 이제 장고 관리자 페이지로 가서 새 블로그 글을 추가하고(게시일을 추가하는 것을 잊지 마세요!) https://yourname.pythonanywhere.com/admin 로 가야하는 것을 잊지마세요. 새로고침하면 새 글이 보일 거에요.
+* 마지막으로 [웹 탭(Web tab)](https://www.pythonanywhere.com/web_app_setup/)에서 **다시 불러오기(Reload)**를 누르세요. 업데이트가 보여야 해요! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. 로컬 컴퓨터 데이터베이스와 PythonAnywehere 데이터베이스 파일은 파일 동기화를 하지 않아요.
 
-잘 작동하니까 멋지죠? 잘 해낸 여러분들이 참 자랑스러워요! 잠시 쉬고 오세요. :)
+축하합니다! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
 
-![Figure 13.4](images/donut.png)
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
 
+![그림 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ko/django_urls/README.md b/ko/django_urls/README.md
index d4f2f6a1ace..7670038aa64 100755
--- a/ko/django_urls/README.md
+++ b/ko/django_urls/README.md
@@ -1,20 +1,21 @@
-# 장고 urls
+# Django URLs
 
-첫 웹 페이지를 만들어 봅시다. 블로그 홈페이지요! 먼저 장고 url에 대해서 조금 배워보기로 합시다.
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
 
 ## URL이란 무엇인가요?
 
-URL은 웹 주소랍니다. 웹 사이트를 방문할 때마다 브라우저의 주소창에 URL을 볼 수 있죠. 맞아요! `127.0.0.1:8000`이 바로 URL이에요. `https://djangogirls.org/`도 URL이랍니다.
+URL은 단순히 웹 주소랍니다. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000`가 바로 URL이에요! And `https://djangogirls.org` is also a URL.)
 
-![Url](images/url.png)
+![URL](images/url.png)
 
-인터넷의 모든 페이지는 고유한 URL을 가지고 있어야 해요. 애플리케이션은 사용자가 URL을 입력하면 어떤 내용을 보여줘야 하는지 알고 있어요. 장고는 `URLconf (URL configuration)`를 사용합니다. `URLconf`는 장고에서 URL과 일치하는 뷰를 찾기 위한 패턴들의 집합입니다.
+인터넷에 있는 모든 페이지들은 자신만의 URL을 가지고 있어야 해요. This way your application knows what it should show to a user who opens that URL. 장고는 `URLconf` (URL configuration)를 사용합니다. URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
 
-## 장고 URL은 어떻게 작동할까요?
+## Django에서 URL은 어떻게 작동할까요?
 
-코드 에디터에서 `mysite/urls.py`파일을 열면 아래 내용이 보일 거에요.
+코드 에디터에서 `mysite/urls.py`파일을 열면 아래와 같을 거에요. :
 
 {% filename %}mysite/urls.py{% endfilename %}
+
 ```python
 """mysite URL Configuration
 
@@ -28,55 +29,58 @@ urlpatterns = [
 ]
 ```
 
-장고가 이미 어떤 내용을 넣어 두었네요.
+As you can see, Django has already put something here for us.
 
-`#`로 시작되는 줄은 주석이에요. 파이썬은 주석을 실행하지 않아요. 꽤 유용하겠죠?
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. 파이썬은 이 구문을 읽지 않아요.
 
-이전 장에서 봤던 관리자 URL도 여기에 이미 있어요.
+The admin URL, which you visited in previous chapter, is already here:
 
 {% filename %}mysite/urls.py{% endfilename %}
+
 ```python
     url(r'^admin/', admin.site.urls),
 ```
 
-장고는 `admin/`로 시작하는 모든 URL을  *view*와 대조해 찾아냅니다. 무수히 많은 URL이 `admin URL`에 포함될 수 있어 일일이 모두 쓸 수 없답니다. 그래서 정규표현식을 사용합니다.
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
 
 ## 정규표현식(Regex)
 
-장고가 URL을 뷰에 매칭시키는 방법이 궁금하죠? 이 부분은 조금 어렵게 느껴질 수 있어요. 장고는 `regex`를 사용하는데, 이는 `정규표현식(regular expressions)`의 줄임말입니다. 정규식은 정말 (아주!) 많은 검색 패턴의 규칙을 가지고 있어요. 정규식은 어려운 내용이라 자세하게 알아보지 않을 거에요.
+장고가 URL을 뷰에 매칭시키는 방법이 궁금하죠? 이 부분은 조금 까다로울 수 있어요. 장고는 `regex`를 사용하는데, "정규표현식(regular expressions)"의 줄임말입니다. 정규식은 정말 (아주!) 많은 검색 패턴의 규칙을 가지고 있어요. 정규식은 심화 내용이기 때문에, 자세한 내용은 다루지 않을 거에요.
 
-URL패턴 만드는 방법이 궁금하다면, 다음 표기법을 확인하세요. 이 중 몇 가지 규칙만 사용할 거에요.
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
 
-* ^ : 문자열이 시작할 떄
-* $ : 문자열이 끝날 때
-* \d : 숫자
-* + : 바로 앞에 나오는 항목이 계속 나올 때
-* () : 패턴의 부분을 저장할 때
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
 
-이외에도 문자열을 이용해 url을 만들 수 있어요.
+Anything else in the URL definition will be taken literally.
 
-`http://www.mysite.com/post/12345/`라는 사이트가 있다고 합시다. 여기에서 `12345`는 글 번호를 의미합니다.
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
 
-뷰마다 모든 글 번호을 일일이 매기는 것은 정말 힘들죠. 정규표현식으로 url패턴을 만들어 숫자값과 매칭되게 할 수 있어요. 이렇게 말이죠. `^post/(\d+)/$`. 어떤 뜻인지 하나씩 살펴봅시다.
+뷰마다 모든 글 번호을 작성하는 것은 정말 힘든 일이 될 거에요. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
 
-*  **^post/** : url이(오른쪽부터) `post/`로 시작합니다.
-*  **(\d+)** : 숫자(한 개 이상)가 있습니다. 이 숫자로 조회하고 싶은 게시글을 찾을 수 있어요.
-*  **/** : `/`뒤에 문자가 있습니다.
-*  **$** : url 마지막이 `/`로 끝납니다.
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)**는 숫자(한 개 또는 여러개) 가 있다는 뜻입니다. 내가 뽑아내고자 글 번호가 되겠지요.
+* **/**는 장고에게 `/`뒤에 문자가 있음을 말해 줍니다.
+* **$**는 URL의 끝이 방금 전에 있던 `/`로 끝나야 매칭될 수 있다는 것을 나타냅니다.
 
-## 나의 첫 번째 Django url!
+## Your first Django URL!
 
-첫 번째 URL을 만들어 봅시다! 우리는 '<http://127.0.0.1:8000/>'가 홈페이지 주소로 만들어 글 목록이 보이게 만들어 볼 거에요.
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
 
-또한 `mysite/urls.py`파일을 깨끗한 상태로 유지하기 위해, `blog` 애플리케이션에서 메인 `mysite/urls.py`파일로 url들을 가져올 거에요.
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
 
-먼저 `#`로 시작하는 줄을 삭제하고 `main url('')`로 `blog.urls`를 가져오는 행을 추가해 봅시다.
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
 
 이제 `mysite/urls.py` 파일은 아래처럼 보일 거에요.
 
 {% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import include
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
@@ -85,39 +89,41 @@ urlpatterns = [
 ]
 ```
 
-지금 장고는 http://127.0.0.1:8000/ 로 들어오는 모든 접속 요청을 `blog.urls`로 전송해 추가 명령을 찾을 거예요.
+지금 장고는 'http://127.0.0.1:8000/'로 들어오는 모든 접속 요청을 `blog.urls`로 전송하고 추가 명령을 찾을 거에요.
 
-파이썬에서 정규 표현식을 작성할 때는 항상 문자열 앞에 `r`을 붙입니다. 이는 파이썬에게는 별 의미가 없지만, 파이썬에게 문자열에 특수 문자를 있다는 것을 알려줍니다.
+Writing regular expressions in Python is always done with `r` in front of the string. 이는 파이썬에게는 별 의미가 없지만, 파이썬에게 문자열에 특수 문자가 있다는 것을 알려줍니다.
 
 ## blog.urls
 
-`blog/urls.py`이라는 새 파일을 생성하세요. 좋아요! 이제 아래 두 줄을 추가하세요.
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
 ```
 
-우리는 장고의 메소드와 `blog` 애플리케이션에서 사용할 모든 `views`를 불러오고 있어요. (물론 아직 뷰를 하나도 안 만들었지만, 곧 만들거니 조금만 기다리세요!)
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
 
 그 다음, 첫 번째 URL 패턴을 추가하세요.
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
 ]
 ```
 
-이제 `post_list`라는 이름의 `view`가 `^$` URL에 할당되었습니다. 이 정규표현식은 `^`에서 시작해 `$`로 끝나는 지를 매칭할 것입니다. 즉 문자열이 아무것도 없는 경우만 매칭하겠죠. 틀린 것이 아니에요. 왜냐하면 장고 URL 확인자(resolver)는 '<http://127.0.0.1:8000/>' 는 URL의 일부가 아니기 때문입니다. 이 패턴은 장고에게 누군가 웹사이트에 '<http://127.0.0.1:8000/>' 주소로 들어왔을 때 `views.post_list`를 보여주라고 말할 거에요.
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. 틀린 것이 아니에요. 왜냐하면 장고 URL 확인자(resolver)는 'http://127.0.0.1:8000/' 는 URL의 일부가 아니기 때문입니다. 이 패턴은 장고에게 누군가 웹사이트에 'http://127.0.0.1:8000/' 주소로 들어왔을 때`views.post_list`를 보여주라고 말할 거에요.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. 이 부분은 뷰의 이름과 같을 수도 완전히 다를 수도 있습니다. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
 
-마지막 부분인 `name='post_list'`는 URL에 이름을 붙인 것으로 뷰를 식별합니다. 뷰의 이름과 같을 수도 완전히 다를 수도 있습니다. 이름을 붙인 URL은 프로젝트의 후반에 사용할 거예요. 그러니 앱의 각 URL마다 이름 짓는 것은 중요합니다. URL에 고유한 이름을 붙여, 외우고 부르기 쉽게 만들어야 해요.
+지금 http://127.0.0.1:8000를 접속해도, 'web page not available(웹 페이지를 사용할 수 없습니다')라는 메세지가 보일 겁니다. 더 이상 서버(`runserver`라고 입력했어요)가 실행되지 않기 때문이에요. 서버 콘솔 윈도우를 보고 왜 그런지 이유를 찾아보세요.
 
-http://127.0.0.1:8000/ 접속했는데 '웹 페이지를 사용할 수 없음(web page not available)'이라는 메시지가 표시되었나요?. 이는 서버(`runserver`라고 입력하는 것을 기억 하는가?)가 실행되지 않았기 때문이에요. 에러가 발생한 이유를 찾으려면 서버 콘솔 창을 보세요.
 ![Error](images/error1.png)
 
-콘솔에서 에러가 발생했네요. 하지만 걱정하지 마세요. 에러는 해결할 방법을 알려준답니다. :   __no attribute 'post_list'__ 라는 메시지가 보일 텐데요. 이것은 장고가 찾고 사용하려고하는 *뷰*가 아직 없다는 거에요. 이 단계에서 `/admin/`로도 접속되지 않을 거에요. 앞으로 고쳐볼 테니 걱정하지 마세요.
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. Django *뷰*가 계속해서 찾고 있지만, 우리는 아직 만들지 않았으니까요. At this stage your `/admin/` will also not work. No worries – we will get there.
 
-> 장고 URL 설정에 대해 더 알고 싶다면 장고 공식 문서를 읽어보세요. :
-https://docs.djangoproject.com/en/1.11/topics/http/urls/
+> 장고 URL 설정에 대해 더 알고 싶다면 공식 문서를 읽어보세요. : https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/ko/django_views/README.md b/ko/django_views/README.md
index 0342680e2bb..1b63e0e4951 100755
--- a/ko/django_views/README.md
+++ b/ko/django_views/README.md
@@ -1,40 +1,44 @@
-# 장고 뷰 만들기
+# Django views – time to create!
 
 지난 장에서 만들었던 버그를 잡을 시간이 왔어요! :)
 
-뷰(*view*) 는 애플리케이션의 "로직"을 넣는 곳이에요. 뷰는 이전 장에서 만들었던 `모델`에서 필요한 정보를 받아와서 `템플릿`에 전달하는 역할을 합니다. 다음 장에서 템플릿을 만들어 볼 거에요. 뷰는 __Python 시작하기__ 장에서 했던 것보다 어려워보이지만, 파이썬 함수일 뿐이에요.
+뷰(*view*) 는 어플리케이션의 "로직"을 넣는 곳이에요. 뷰는 앞 챕터에서 만들었던 `모델`에게서 필요한 정보를 받아와서 `템플릿`에 전달하는 역할을 합니다. 다음 장에서 템플릿을 만들어 볼 거에요. 뷰는 **파이썬 들어가기** 장에서 했던 것 보다 조금 더 복잡해 보이는 파이썬 함수입니다.
 
-뷰는 `views.py` 파일 안에 있습니다. 우리는 *views*를 `blog/views.py`파일 안에 추가할 거에요.
+뷰는 `views.py` 파일 안에 있습니다. 우리는 *views*를 `blog/views.py` 파일 안에 추가할 거에요.
 
 ## blog/views.py
 
-좋아요. 이제 이 파일을 열고 안에 있는 내용을 살펴봅시다:
+좋아요. 이제 이 파일을 열고 안에 있는 내용을 살펴봅시다. :
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
-# Create your views here.
+# 이 곳에 views를 추가하세요.
 ```
 
-별 내용이 없네요. 간단한 *view*를 만들어봅시다.
+해야할 게 그렇게 많지는 않아요.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-방금 `post_list`라는 함수(`def`) 만들어 `요청(request)`을 넘겨받아 `render`메서드를 호출합니다. 이 함수는 호출하여 받은(return) `blog/post_list.html`템플릿을 보여줍니다.
-
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
 
-파일을 저장하고, http://127.0.0.1:8000/ 로 접속해 확인해보세요.
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
 
-에러가 발생했네요! 아래 내용을 읽어보세요.
+에러가 발생했어요! 이제 아래 내용을 읽어보세요. :
 
 ![Error](images/error.png)
 
-*TemplateDoesNotExist*는 쉽게 해결할 수 있습니다. 잘 따라왔다면 방금 에러가 보이는게 맞아요. 다음 장에서 버그를 해결하기 위해 템플릿 파일을 만들 거에요!
-
-> 장고 뷰에 대해 더 알고 싶다면 장고 공식 문서를 읽어보세요. : https://docs.djangoproject.com/en/1.11/topics/http/views/
+서버가 사디 실행했지만, 아직도 보여지지 않네요, 그렇죠? 걱정하지마세요, 이건 단순한 오류 페이지에요, 전혀 두려워하지 않아도 돼요! 콘솔에 에러 메세지가 나타나는 것은, 실제로 정말 유용하답니다! *TemplateDoesNotExist (템플릿이 존재하지 않습니다)*라고 읽을 수 있으니까요. 버그를 잡고 다음 장에서 템플릿을 만들어보아요!
 
+> Django 뷰에 대해 자세히 알고 싶으시면 공식 문서를 읽어보세요. https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/ko/dynamic_data_in_templates/README.md b/ko/dynamic_data_in_templates/README.md
index 91532b54e23..287602470dc 100755
--- a/ko/dynamic_data_in_templates/README.md
+++ b/ko/dynamic_data_in_templates/README.md
@@ -1,14 +1,15 @@
-# 템플릿 동적 데이터
+# 템플릿의 동적 데이터
 
-블로그 글은 각각 다른 장소에 조각조각 나눠져있어요. `Post`모델은 `post_list`파일에, `post_list`모델은 `views.py`파일에 있어요. 그리고 앞으로 템플릿도 추가해야 합니다. HTML 템플릿에서 글 목록을 어떻게 보여줄까요? 이번 장에서는 콘텐츠(데이터베이스 안에 저장되어 있는 모델)를 가져와 템플릿에 넣어 보여주는 것을 해볼 거에요.
+블로그 글이 각각 다른 장소에 조각조각 나눠져있어요. `Post` 모델은 `post_list`파일에 정의되어 있고, `post_list` 모델은 `views.py` 파일에 정의되어 있습니다. 템플릿도 추가해야해요. 하지만 실제로 HTML 템플릿에서 글들이 어떻게 보여질까요? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
 
-*뷰(view)*는 모델과 템플릿을 연결하는 역할을 합니다. `post_list`를 *뷰*에서 보여주고 이를 템플릿에 전달하기 위해서는, 모델을 가져와야 합니다. 일반적으로 *뷰*가 템플릿에서 모델을 선택하도록 만들어야 합니다.
+여기서 *views*가 모델과 템플릿을 연결하는 역할을 한다는 것을 알 수 있어요. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. 그래서 기본적으로 *view*에서는 템플릿에서 무엇을 보여줄 지 (모델)을 선택해야죠.
 
-자, 모두 준비됐나요?
+OK, so how will we achieve this?
 
-`blog/views.py`파일을 열어봅시다. `post_list` *뷰* 내용을 봅시다.
+이제 `blog/views.py` 파일을 열어봅시다. `post_list` *view* 파일이 아래처럼 보일꺼에요.
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
@@ -16,32 +17,35 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-다른 파일에 있는 코드를 가져오는 방법, 기억나나요? `models.py`파일에 정의된 모델을 가져올 거에요. `from .models import Post`을 추가하세요.
+다른 파일들에 있는 코드를 가져오는 것에 대해서 이야기 했던거 기억나나요? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from .models import Post
 ```
 
-`from` 다음에 있는 마침표(.)는 현재 *디렉토리* 또는 *애플리케이션*을 의미합니다. 동일한 디렉터리 내 `views.py`, `models.py`파일이 있기 때문에 `. 파일명` (`.py`확장자를 붙이지 않아도)으로 내용을 가져올 수 있습니다. 이제 `Post`모델을 불러봅시다.
+`from` 다음에 있는 마침표(.)는 *현재 디렉토* 또는* 현재 어플리케이션*을 의미합니다. `views.py` 및 `models.py` 같은 디렉터리에 있습니다. `.`와 파일 이름만으로 (`.py`없이) 사용할 수 있어요. 자 다음은 모델(`Post`)의 이름을 불러옵니다).
 
-`Post`모델에서 블로그 글을 가져오기 위해서는 `쿼리셋(QuerySet)`이 필요합니다.
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
 
 ## 쿼리셋(QuerySet)
 
-여러분은 이미 쿼리셋에 익숙해야 해요. 자세한 내용은 [Django ORM과 QuerySets](../django_orm/README.md) 장에서 다루었어요.
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
 
-자, 블로그 글 목록을 살펴봅시다. 글 목록을 게시일 `published_date`기준으로 정렬해볼까요? 이미 Django ORM과 QuerySets 장에서 해본 내용이에요.
+자, 이제는 블로그 글 목록에 관심을 가져봅시다. 글 목록이 출판되고 `출판된 날짜(published_date)`기준으로 정렬되면 좋겠죠? 사실 이미 쿼리셋 장에서 배운 내용입니다.
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
 ```
 
-다음으로 `blog/views.py`파일 내 `def post_list(request)`함수에 아래 코드 내용을 넣어봅시다. 제일 먼저 `timezone` 모듈을 불러와야하니 `from django.utils import timezone`를 추가하는 것을 잊지 마세요.
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from django.utils import timezone
@@ -52,15 +56,15 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-아직 안한 부분은 `posts` QuerySet을 템플릿 컨텍스트에 전달하는 것입니다. 걱정하지 마세요. 맨 마지막에 이 부분을 다룰 거에요.
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
 
-우리는 `posts`라는 *변수*를 만들고 있다는 것을 기억하세요. 이 변수는 퀴리셋의 이름입니다.
+우리는 `posts`쿼리셋을 나타내는 *변수*를 만든다는 점에 주의하세요. 이 변수는 퀴리셋의 이름으로 취급하며 이 이름으로 참조할 수도 있습니다.
 
-다음 장에서 `posts`쿼리셋을 템플릿에 보내는 방법을 배울 거에요.
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. 이름을 넣어줘야 합니다. (여기서는 `'posts'`라고 하죠). :) 이렇게 보일지도 모르겠어요: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
 
-`render`함수에는 매개변수 `request`(사용자가 요청하는 모든 것)와 'blog/post_list.html' 템플릿이 있습니다. `{}`이 보일 텐데, 이곳에 템플릿을 사용하기 위해 매개변수를 추가할 거에요. (이 매개변수를`'posts'`라고 할거에요)`{'posts': posts}`이렇게 작성할거에요. `:`이전에 문자열이 와야하고, 작은 따옴표`''`를 양쪽에 붙이는 것을 잊지 마세요.
+그래서 최종적으로는 `blog/views.py` 파일이 아래처럼 될 것입니다. :
 
-이제 `blog/views.py`코드는 아래 코드처럼 보일 겁니다.
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
@@ -72,7 +76,6 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {'posts': posts})
 ```
 
-여기까지에요! 템플릿 파일로 돌아가 쿼리셋을 보이게 만들어 봅시다.
+다 되었습니다! 이제 템플릿 파일로 돌아가서 이 쿼리셋을 나타나도록 하는 것을 해볼 때입니다.
 
-쿼리셋에 대해 더 알고 싶다면 장고 공식 문서를 읽어보세요. :
-https://docs.djangoproject.com/en/1.8/ref/models/querysets/
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/ko/extend_your_application/README.md b/ko/extend_your_application/README.md
index f6009438c1e..06fb9a158bb 100755
--- a/ko/extend_your_application/README.md
+++ b/ko/extend_your_application/README.md
@@ -1,18 +1,17 @@
-# 프로그램 애플리케이션 확장하기
+# 어플리케이션 확장하기
 
-지금까지 웹 사이트 제작 단계를 모두 마쳤어요. 모델, url, 뷰와 템플릿을 만드는 방법을 알게 되었고요. 웹 사이트를 예쁘게 꾸미는 방법도 알게 되었어요.
+우리는 지금까지 웹사이트 제작에 필요한 모든 단계들을 마쳤어요. 모델, url, 뷰와 템플릿을 만드는지 알게 되었고요. 또 웹사이트를 어떻게 멋지게 꾸미는지 알게 되었어요.
 
-이제 또 실습해봅시다!
+이제 연습해 봅시다!
 
-블로그 게시글이 각 페이지마다 보이게 만들어 봅시다.
+블로그에 가장 필요한 것은 페이지에 포스트가 보이게 만드는 것이겠죠?
 
-이미 앞에서 `Post`모델을 만들었으니 `models.py`에 새로 추가할 내용은 없어요.
+이미 앞에서 `Post` 모델을 만들었으니 `models.py`에 추가할 내용은 없습니다.
 
 ## Post에 템플릿 링크 만들기
 
-`blog/templates/blog/post_list.html`파일에 링크를 추가하는 것부터 시작합시다. 아래와 같이 보일 거에요. : 
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
 {% extends 'blog/base.html' %}
 
@@ -29,32 +28,34 @@
 {% endblock %}
 ```
 
-{% raw %} `post`제목 목록이 보이고 해당 링크를 클릭하면, `post`상세 페이지로 이동하게 만들어 볼 거에요. `<h1><a href="">{{ post.title }}</a></h1>`부분을 수정해 봅시다. {% endraw %}
+우리는 post 목록에 있는 제목에서 post의 내용 페이지로 가는 링크를 만들 거에요. `<h1><a href="">{{ post.title }}</a></h1>` 를 변경해 봅시다. post의 상세 페이지는 {% endraw %} 로 연결됩니다.
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
 ```
 
-{% raw %}`{% url 'post_detail' pk=post.pk %}`을 설명할 때가 왔군요! `{% %}`는 장고 템플릿 태그을 말합니다. URL를 생성해 사용해봅시다.{% endraw %}
+`{% url 'post_detail' pk=post.pk %}`에 대해 설명할 때가 왔군요! 예상하셨겠지만 `{% %}` 표기는 장고 템플릿 태그를 사용하고 있는 것을 말합니다. 이번에는 우리를 위한 URL를 만들어 사용해 봅시다!
 
-`blog.views.post_detail`는 `post_detail` *뷰* 경로입니다. `blog`는 응용프로그램(디렉터리 `blog`)의 이름인 것을 꼭 기억하세요. `views`는 `views.py`파일명이에요. 마지막 부분 `post_detail`는 *view* 이름입니다.
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
 
-`pk = post.pk`이란 무엇일까요? `pk`는 데이터베이스의 각 레코드를 식별하는 기본키(Prmiary Key)의 줄임말 입니다. Post 모델에서 기본키를 지정하지 않았기 때문에 장고는 `pk`라는 필드를 추가해 새로운 블로그 게시물이 추가될 때마다 그 값이 1,2,3 등으로 증가하게 됩니다.  Post 객체의 다른 필드 (제목, 작성자 등)에 액세스하는 것과 같은 방식으로 post.pk를 작성하여 기본 키에 액세스합니다 `post.pk`를 써서 기본키에 접근할 수 있고 같은 방법으로 `Post`객체내 다른 필드(`title`, `author`)에도 접근할 수 있습니다!
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
 
-이제 http://127.0.0.1:8000/ 를 열어보세요. 아마 오류 메세지가 나올 거에요. (아직 `post_detail` *뷰*를 만들지 않아 오류가 나는 거에요) 이런 화면이 보일 거에요. :
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
 
 ![NoReverseMatch error](images/no_reverse_match2.png)
 
-## Post 상세 페이지 URL 만들기
+## Post 상세 페이지에 URL 만들기
 
-`post_detail`*뷰*가 보이게 `urls.py`에 URL를 만들어 봅시다!
+`urls.py` 파일에 `post_detail` *view*를 위한 URL를 만들어 봅시다!
 
-첫 게시물의 상세 페이지 **URL**이 http://127.0.0.1:8000/post/1/가 되게 만들 거에요.
+첫 번째 게시물의 상세 **URL**은 이렇게 나올 거에요. : http://127.0.0.1:8000/post/1/
 
-`blog/urls.py`파일에 URL을 만들어, 장고가 `post_detail` *뷰*로 보내, 게시글이 보일 수 있게 해봅시다. `url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail')`코드를 `blog/urls.py`파일에 추가하면 아래와 같을 보일 거에요.
+`blog/urls.py`파일에 URL을 만들어, 장고가 `post_detail`이란 *view<1/>로 보내, 전체 블로그 글이 보일 수 있게 만들어 봅시다. `url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail')` 코드를 `blog/urls.py` 파일에 추가하세요. 그러면 아래처럼 보일 거에요. :</p> 
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
@@ -65,77 +66,84 @@ urlpatterns = [
 ]
 ```
 
-`^post/(?P<pk>\d+)/$`부분이 복잡하게 보이지만, 걱정하지 마세요. 하나씩 차근차근 알아봅시다.
- - `^`은 "시작"을 뜻합니다.
- - `post/`란 URL이 **post** 문자를 포함해야 한다는 것을 말합니다. 아직 할 만하죠?
- - `(?P<pk>\d+)`는 조금 까다롭습니다. 이 정규표현식은 장고가 `pk`변수에 모든 값을 넣어 뷰로 전송하겠다는 뜻입니다. `\d`은 문자를 제외한 숫자 0부터 9 중, 한 가지 숫자만 올 수 있다는 것을 말합니다. `+`는 하나 또는 그 이상의 숫자가 올 수 있습니다.. 따라서 `http://127.0.0.1:8000/post/`라고 하면 post/ 다음에 숫자가 없으므로 해당 사항이 아니지만, `http://127.0.0.1:8000/post/1234567890/`는 완벽하게 매칭됩니다.
- - `/`은 다음에 **/** 가 한 번 더 와야 한다는 의미입니다.
- - `$`는 "마지막"을 말합니다. 그 뒤로 더는 문자가 오면 안 됩니다.
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
 
-브라우저에 `http://127.0.0.1:8000/post/5/`라고 입력하면, 장고는 `post_detail` *뷰*를 찾아 매개변수 `pk`가 `5`인 값을 찾아 *뷰*로 전달합니다.
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. 이 정규 표현식의 의미는 장고가 여러분이 여기에 넣은 모든 것을 `pk`변수에 넣어 뷰로 전송하겠다는 뜻입니다. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+`는 하나 또는 그 이상의 숫자가 와야한다는 것을 의미합니다. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
 
-`pk`는 `primary key`의 약자로, 장고에서 많이 사용되는 변수명입니다. 변수명은 내가 원하는 것으로 변경할 수 있어요. (변수명에 공백문자는 사용할 수 없으며 소문자와 `_`를 사용할 수 있음을 주의하세요) 예를 들어, `(?P<pk>\d+)`변수를 `post_id`으로 바꾸면, 정규표현식도 `(?P<post_id>\d+)`으로 바뀌게 됩니다.
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
 
-좋아요, 새로운 URL 패턴을 `blog/urls.py`에 추가했어요! 페이지를 새로고침 하세요. http://127.0.0.1:8000/ 쾅! 또 에러가 났어요! 예상했던 대로에요!
+OK, we've added a new URL pattern to `blog/urls.py`! 페이지를 새로고침 해보세요: http://127.0.0.1:8000/ 짠! 서버 실행이 멈추었어요! Have a look at the console – as expected, there's yet another error!
 
 ![AttributeError](images/attribute_error2.png)
 
-다음 단계는 무엇일까요? 그렇죠. 뷰를 추가해야죠!
+다음 단계는 무엇일까요? 그렇죠. : view를 추가해야죠!
 
-## Post 상세 페이지 내 뷰 추가하기
+## Post 상세 페이지에 뷰 추가하기
 
-*뷰*에 매개변수 `pk`를 추가해봅시다. *뷰*가 `pk`를 식별해야겠죠? 그래서 함수를 `def post_detail(request, pk):`라고 정의합니다. urls(`pk`)과 동일하게 이름을 사용해야 합니다. 변수가 생략되면 오류가 날 거예요!
+This time our *view* is given an extra parameter, `pk`. *view*에 가져다가 써야겠죠? 그래서 함수를 정의할 때, pk를 받도록 `def post_detail(request, pk):`라고 정의 할 것입니다. 기입된 urls(`pk`)에 지정한 것과 정확히 똑같은 이름을 사용해야함을 주의하세요. 변수가 생략되면 문제가 생겨 오류가 날 거에요!
 
-블로그 게시글 한 개만 보려면, 아래와 같이 쿼리셋(queryset)을 작성해야해요.
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 Post.objects.get(pk=pk)
 ```
 
-하지만 이 코드에는 문제가 있어요. 만약 해당 `primary key(pk)`의 `Post`를 찾지 못하면 오류가 나올 거에요!
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
 
 ![DoesNotExist error](images/does_not_exist2.png)
 
-우리가 원하는게 아니죠! 장고에는 이를 해결하기 위해 `get_object_or_404`라는 특별한 기능을 제공해요. `pk`에 해당하는 `Post`가 없을 경우, 멋진 페이지(`페이지 찾을 수 없음 404 : Page Not Found 404)`를 보여줄 거에요.
+우리가 원하는게 아니에요! 장고에서는 이를 해결 하기위해 특별한 기능을 제공해요. : `get_object_or_404`이에요. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
 
 ![Page not found](images/404_2.png)
 
-나중에 `페이지 찾을 수 없음(Page not found)`페이지를 예쁘게 만들 수 있어요. 지금 당장 중요한 것이 아니니 이 부분은 생략할게요.
+좋은 점은 여러분 만의 `페이지 찾을 수 없음(Page not found)` 페이지를 예쁘게 만들 수 있다는 거에요. 지금 당장 중요한 것이 아니까 생략할게요.
 
-좋아요. 이제 `views.py`파일에 새로운 *뷰*를 추가합시다!
+OK, time to add a *view* to our `views.py` file!
 
-`blog/views.py`파일을 열고 아래 코드를 추가하세요.
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render, get_object_or_404
 ```
 
-`from`행 가서, 파일 마지막 부분에 *뷰*를 추가하세요.
+And at the end of the file we will add our *view*:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_detail(request, pk):
     post = get_object_or_404(Post, pk=pk)
     return render(request, 'blog/post_detail.html', {'post': post})
 ```
 
-그리고 브라우저를 새로고침 하세요. http://127.0.0.1:8000/
+브라우저를 새로고침 해보세요. : http://127.0.0.1:8000/
 
 ![Post list view](images/post_list2.png)
 
-잘 작동하네요! 그런데 블로그 제목 링크를 클릭하면 어떻게 되나요?
+잘 되네요! 그런데 블로그 제목 안의 링크를 클릭하면 어떻게 되나요?
 
 ![TemplateDoesNotExist error](images/template_does_not_exist2.png)
 
-이런! 또 에러가 나왔네요! 하지만 이제 어떻게 해야하는지 알고 있죠? 드디어 템플릿을 추가할 차례에요!
+이런! 또 에러가 나왔네요! 하지만 이제는 이런 걸 어떻게 다뤄야하는지 알고 있죠? 우리는 이제 템플릿을 추가해 볼 거에요!
+
+## Create a template for the post details
 
-## Post 상세 페이지 템플릿 만들기
+`blog/templates/blog` 디렉토리 안에 `post_detail.html`라는 새 파일을 생성하세요.
 
-`blog/templates/blog` 디렉터리 안에 `post_detail.html`라는 새 파일을 생성하고 아래와 같이 코드를 작성하세요.
+아마도 화면에 이렇게 보이겠죠?
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -152,37 +160,38 @@ def post_detail(request, pk):
 {% endblock %}
 ```
 
-다시 한 번 `base.html`을 확장한 거에요. `content`블록에서 블로그 글의 게시일, 제목과 내용을 보이게 만들었어요.
+다시 한 번 `base.html`을 확장해 봅시다. `content` 블록에서, 블로그 글의 published_date 출판일(존재한다면) 과 제목, 내용을 보이게 할 거에요. 그런데 제일 중요한 것을 얘기해봐야하지 않겠어요?
 
-{% raw %} 가장 중요한 부분은 `{% if ... %} ... {% endif %}`라는 템플릿 태그인데, 내용이 있는지 확인할 때 사용합니다. (`if ... else ..`구문은 __Python 시작하기__ 장에서 배웠어요) `post`의 `게시일(published_date)`이 있는지, 없는지를 확인하는 거에요. {% endraw %}
+`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
 
-페이지를 새로고침하면 `페이지 찾을 수 없음(Page not found)` 페이지가 없어졌어요.
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
 
 ![Post detail page](images/post_detail2.png)
 
 야호! 잘 되네요!
 
-## 한 가지만 더 합시다. 배포하세요!
+## 한 가지만 더: 배포하세요!
 
-PythonAnywhere에도 웹사이트가 잘 작동하는지 봐야겠죠? 다시 한 번 배포합시다.
+PythonAnywhere에서도 웹사이트가 잘 작동하는지 봐야겠죠? 다시 한 번 배포해봅시다.
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
-$ git push
-```
-* 그 다음 [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/)을 여세요.
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+그 다음 [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/)을 여세요:
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd my-first-blog
-$ git pull
-[...]
-```
 
-* 마지막으로 [Web tab](https://www.pythonanywhere.com/web_app_setup/)에서 **Reload(다시 불러오기)** 를 누르세요.
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+마지막으로 [웹 탭(Web tab)](https://www.pythonanywhere.com/web_app_setup/)에서 **다시 불러오기(Reload)**를 누르세요.
 
-배포를 마쳤습니다. 잘 작동되는지 확인해 보세요! 축하합니다.
+이제 배포가 완료 되었어요. 잘 작동되는지 확인해 보세요! 축하합니다. :)
\ No newline at end of file
diff --git a/ko/how_the_internet_works/README.md b/ko/how_the_internet_works/README.md
index 82423d861d6..ee16b44142c 100755
--- a/ko/how_the_internet_works/README.md
+++ b/ko/how_the_internet_works/README.md
@@ -1,45 +1,47 @@
 # 인터넷은 어떻게 작동할까요
 
-> **Note** 이번 장은 Jessica McKellar의 글 ["How the internet works"](http://web.mit.edu/jesstess/www/)을 기초로 작성되었습니다. 
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
 
-우리는 매일 인터넷을 사용합니다. 그러나 브라우저 주소창에 [http://djangogirls.org](http://djangogirls.org)를 입력하고 `엔터`키를 누르면 어떤 일이 일어나는지 알고 있나요?
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
 
-웹 사이트란 동영상, 음악, 사진 파일처럼 하드 디스크에 저장된 파일묶음과 같습니다. 웹 사이트가 일반 파일과 다른 점은 HTML이라는 프로그래밍 코드가 들어있다는 것이에요.
+먼저 알아야 할 것은 웹사이트란 하드 디스크에 저장된 파일묶음이라는 거에요. 동영상, 음악, 사진 파일처럼요. 웹사이트가 다른 파일과 다른 점은 HTML이라는 컴퓨터 코드가 들어있다는 것이에요.
 
-프로그래밍에 익숙하지 않은 분이라면, HTML을 이해하기 어려울 수도 있어요. 하지만 브라우저들(크롬, 사파리, 파이어폭스) HTML을 사랑한답니다. 웹 브라우저는 코드를 이해하고 지시에 따라 정확하게 구현되도록 설계되었어요.
+만약 프로그래밍에 익숙하지 않다면, HTML을 이해하는 게 어려울 수도 있어요. 하지만 브라우저들(크롬, 사파리, 파이어폭스 같은 것들요) 은 HTML을 사랑한답니다. 웹 프라우저는 코드를 이해하고 지시에 따르고, 내가 원하는 방식으로 정확하게 구현될 수 있도록 설계되었어요.
 
-다른 파일처럼 HTML도 하드 디스크 어딘가에 저장해야 합니다. 인터넷에선 *서버*라는 특별하고 강력한 컴퓨터를 사용합니다. 데이터를 저장하고 제공하는 것이 주된 목적이기 때문에 모니터나 마우스, 키보드가 필요 없지요. 데이터를 *제공(serve)*하는 일을 하므로 *서버(server)*라고 부릅니다.
+다른 파일처럼 HTML 파일도 하드 디스크 어딘가에 저장해야합니다. 인터넷에선 *서버*라는 특별하고 강력한 컴퓨터를 사용해요. 데이터를 저장하고 제공하는 것이 주된 목적이기 때문에 모니터나 마우스, 키보드가 필요없지요. That's why they're called *servers* – because they *serve* you data.
 
-인터넷은 어떻게 생겼을지 궁금하죠?
+OK, but you want to know how the Internet looks, right?
 
-여러분들의 이해를 돕기 위해 그림을 그려봤어요!
+그림을 그려봤습니다. 이렇게 생겼어요:
 
-![Figure 1.1](images/internet_1.png)
+![그림 1.1](images/internet_1.png)
 
-조금 지저분해 보이죠? 사실 인터넷은 수 많은 기계들이 연결된(앞서 얘기한 *서버* 라는) 하나의 네트워크랍니다. 수백, 수천 대의 기계들이요! 긴, 아주 긴 케이블들이 지구 전체를 둘러싸고 있답니다! 해저 케이블 지도 사이트 (http://submarinecablemap.com/) 에 가보면 케이블이 얼마나 복잡하게 연결되어있는지 알 수 있어요. 아래 사진은 웹사이트에서 가져온 스크린 샷입니다.
+조금 지저분해 보이죠? In fact it is a network of connected machines (the above-mentioned *servers*). 수백, 수천 대의 기계들이요! 긴, 아주 긴 케이블들이 지구 전체를 둘러싸고 있답니다! 해저 케이블 지도 사이트 (http://submarinecablemap.com/)에 가보면 케이블이 얼마나 복잡하게 연결되어있는지 알 수 있어요. 아래 사진은 웹사이트에서 가져온 스크린 샷입니다.
 
-![Figure 1.2](images/internet_3.png)
+![그림 1.2](images/internet_3.png)
 
-멋지지 않나요? 그러나 인터넷에 연결된 모든 기계 전부 연결하는 것은 불가능한 일입니다. 그래서 특정한 기계(예를 들어 https://djangogirls.org 가 저장되었다면)에 도달하기 위해서는 수없이 많은 다른 기계들을 통과해야 한답니다.
+멋지지 않나요? 그러나 인터넷에 연결되어 있는 모든 기계들을 전부 연결하는 것은 불가능해요. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
 
 그림으로 보면 다음과 같습니다.
 
-![Figure 1.3](images/internet_2.png)
+![그림 1.3](images/internet_2.png)
 
-주소창에 https://djangogirls.org 을 입력하는 건, "사랑하는 장고걸스 여러분, 저는 장고걸스 웹사이트를 보고 싶어요. 저에게 그 웹 사이트를 보여주세요!"라고 편지를 써서 보내는 것과 같아요.
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
 
-이 편지는 나와 가장 가까이에 있는 동네 우체국으로 갑니다. 받을 사람에게 가까운 다른 우체국으로, 다른 우체국으로 전달되어 주소지에 최종 도착하게 됩니다. 특별한 점은 같은 장소에서 많은 양의 편지(*데이터 패킷*)을 보내면, 각기 다른 우체국(*라우터*)를 통해 전달된다는 것입니다. 또 우체국마다 전달되는 방법이 다르지요.
+이 편지는 나와 가장 가까이에 있는 동네 우체국으로 갈거에요. 받을 사람에게 가까운 다른 우체국으로, 다른 우체국으로 전달되면서 주소지에 최종 도착하게 됩니다. 특이한 점은 같은 장소에서 많은 양의 편지(*데이터 패킷*을 보내면, 각기 다른 우체국(*라우터*) 을 통해 전달될 수 있다는 것입니다. 또 우체국마다 배포되는 방법이 달라요.
 
-![Figure 1.4](images/internet_4.png)
+![그림 1.4](images/internet_4.png)
 
-맞아요, 간단해요. 메시지를 보내고 답장을 기다리는 거죠. 물론 종이랑 펜 대신 몇 바이트의 데이터를 사용하는 것이지만, 기본 개념은 같답니다!
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
 
-그리고 도로명과 도시 이름, 우편번호를 쓰는 대신 IP주소라는 것을 써야 해요. 컴퓨터는 먼저 DNS(도메인 주소 시스템)에 djangogirls.org IP주소가 무엇인지 물어봅니다. 전화주소록에서 연락하고 싶은 대상의 이름을 찾아 전화번호와 주소를 찾아내는 방법과 비슷하지요.
+그리고 도로명과 도시이름, 우편번호를 쓰는 대신 IP주소라는 것을 써야해요. 컴퓨터는 먼저 DNS(도메인 주소 시스템)에게 djangogirls.org 의 IP주소가 무엇인지 물어봅니다. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
 
-편지를 보낼 때 규칙을 지켜야 제대로 배달되어요. 주소가 적혀있어야 하고, 우표가 있어야 해요. 수령인이 읽을 수 있는 언어로 작성되어야 하고요. 이처럼 *데이터 패킷*에도 같이 적용되어야 웹사이트를 볼 수 있습니다. 우리는 HTTP(Hypertext Transfer Protocol: 하이퍼텍스트 전송 프로토콜)라는 프로토콜을 사용합니다.
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. 수령인이 이해할 수 있는 언어로 적혀져야하구요. 그렇죠? 이처럼 *데이터 패킷*에도 동일하게 적용되어야 웹사이트를 볼 수 있습니다. 우리는 HTTP (하이퍼텍스트 전송 프로토콜) 라는 프로토콜을 사용합니다.
 
-이처럼 기본적으로 웹 사이트를 만들려면 그 웹 사이트가 동작할 *서버*(기계)가 필요합니다. *서버*에서 *요청*(편지)을 받으면, 다시 웹 사이트(다른 편지)로 되돌려줍니다.
+따라서 기본적으로 웹사이트를 만들려면 그 웹사이트가 동작할 *서버* (기계) 가 필요해요. *서버*에서 *요청*(편지) 을 받으면, 다시 웹사이트(다른 편지) 로 되돌려줍니다.
 
-장고걸스 튜토리얼을 시작할 때부터, 장고가 무슨 일을 하는지 궁금하셨죠? 답장 전송 시 모든 사람이 같은 내용을 받는 것이 아니라, 받는 사람마다 각각 다른 답장을 보내면 더 좋지 않을까요? 이처럼 장고는 각 사용자에게 맞춤형 편지를 보낼 수 있게 도와준답니다. :)
+Since this is a Django tutorial, you might ask what Django does. 여러분이 답장을 보낼 때, 모든 사람에게 항상 동일한 내용을 보내고 싶지 않을 거에요. 받는 사람에 따라 각각 다른 답장을 보내면 더 좋지 않을까요? 이와 같이 장고는 맞춤형 편지를 보낼 수 있도록 도와준답니다. :)
 
-이제 수다는 그만하고, 정말 뭔가 만들어 보자고요!
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ko/html/README.md b/ko/html/README.md
index 167a3dfe05a..e81e1349c08 100755
--- a/ko/html/README.md
+++ b/ko/html/README.md
@@ -1,44 +1,44 @@
 # HTML 시작하기
 
-템플릿은 어떤 일을 하는지 궁금했죠?
+템플릿이 무엇인지 궁금하셨죠?
 
-템플릿이란 서로 다른 정보를 일정한 형태로 표시하기 위해 재사용 가능한 파일을 말해요. 예를 들면 편지에도 같은 템플릿을 사용할 수 있어요. 편지의 내용이나 수신인 주소는 달라져도 같은 디자인, 레이아웃을 사용하는 때도 있으니까요.
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
 
-장고 템플릿 양식은 HTML을 사용합니다. (HTML은 인터넷은 어떻게 작동할까요에서 들어본 내용이죠)
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
 
 ## HTML이란 무엇일까요?
 
-HTML은 크롬이나 파이어폭스, 사파리 같은 웹 브라우저가 해석할 수 있는 간단한 코드예요. 사용자에게 웹 페이지를 표시할 때 사용합니다.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
-HTML은 "HyperText Markup Language"의 줄임말로, __하이퍼텍스트(HyperText)__ 는 페이지 간 하이퍼링크가 포함된 텍스트라는 뜻입니다. **마크업(Markup)** 이란 누군가(브라우저)가 문서를 해석하도록 표시(mark)를 했다는 뜻이에요. HTML은 **태그(tag)** 들로 이루어져 있어요. 태그는 `<(여는 태그)` 로 시작하고 `>(닫는 태그)`로 끝나는데, 이는 마크업 **요소(elements)** 를 말합니다.
+HTML은 "HyperText Markup Language"의 줄인 말입니다. **하이퍼텍스트(HyperText)** 는 텍스트인데 페이지간에 하이퍼링크를 담을 수 있다는 뜻이예요. **마크업(Markup)**이란 누군가에게(여기서는 브라우저) 문서를 해석하는 방법을 표시(mark)를 했다는 뜻이에요. HTML 코드는 **태그(tag)**들로 이루어져있어요. 태그는 `<` 로 시작하고 `>`로 끝나요. 이런 태그들은 마크업 **요소(elements)**를 나타냅니다.
 
-## 첫 번째 템플릿!
+## 첫번째 템플릿!
 
-템플릿은 곧 템플릿 파일을 만든다는 뜻이에요. 템플릿 파일에 모든 내용이 저장되겠죠? 이미 알고 있을 것 같아요.
+템플릿을 만드는 것은 템플릿 파일을 만든다는 뜻이예요. 모든 것은 파일에 저장되겠죠? 이미 눈치챘을 것 같군요.
 
-템플릿은 `blog/templates/blog`디렉토리에 저장됩니다. 먼저 `blog`디렉터리 안에 하위 디렉터리인 `templates`을 생성하세요. 그리고 `template`디렉토리 내 `blog`라는 하위 디렉토리를 생성하세요.
+템플릿은 `blog/templates/blog` 디렉토리에 저장됩니다. 그러니까 먼저 블로그 디렉토리에 `templates` 디렉토리를 생성해야해요. 그리고, 템플릿 디렉토리에 `blog` 라는 디렉토리를 만드세요.
 
-```
-blog
-└───templates
- └───blog
-```
+    blog
+    └───templates
+        └───blog
+    
 
-(왜 똑같은 `blog`디렉토리를 하나 더 만들어야하는지 궁금할 거에요. 나중에 알게 되겠지만, 나중에 폴더 구조가 복잡해 질 때 좀더 쉽게 찾기 위해 사용하는 관습적인 방법이랍니다)
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
 
-다음 `blog/templates/blog`디렉토리 안에 `post_list.html`이라는 새 파일(현재는 빈 파일)을 만드세요.
+다음 `blog/templates/blog` 디렉토리에 `post_list.html` (비어있는) 파일을 만드세요.
 
-그리고 웹 사이트를 확인해보세요. http://127.0.0.1:8000/
+웹사이트를 확인해보세요. : http://127.0.0.1:8000/
 
-> `TemplateDoesNotExists`에러가 보인다면, 웹 서버를 다시 시작하세요. 커맨드라인(혹은 콘솔)으로 가서 `Ctrl + C`를 눌러 웹 서버를 중단합니다. 다시 `python manage.py runserver`명령을 실행해 서버를 재시작합니다.
+> 여전히 `TemplateDoesNotExists`에러가 나온다면, 웹 서버를 다시 시작하세요. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
 
-![Figure 11.1](images/step1.png)
+![그림 11.1](images/step1.png)
 
-이제 에러가 사라졌어요! 축하합니다. 하지만 웹 사이트에 아무것도 보이지 않네요. 이제 하나씩 고쳐나가 봅시다.
+이제 에러가 사라졌어요! 축하합니다. :) 하지만 웹사이트가 비어있어 아무 내용도 보여지지 않네요. 이제 고쳐나가 봅시다.
 
-`post_list.html`템플릿 파일에 아래 내용을 넣어주세요.
+템플릿 파일 post_list.html에 아래 내용을 넣어주세요:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <p>Hi there!</p>
@@ -46,26 +46,29 @@ blog
 </html>
 ```
 
-웹 사이트가 어떻게 보이나요? 확인해보세요. http://127.0.0.1:8000/
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
 
-![Figure 11.2](images/step3.png)
+![그림 11.2](images/step3.png)
 
-잘 작동하네요! 잘 했습니다.
+잘 작동하네요! 잘 했습니다. :)
 
-*   모든 웹 페이지는 `<html>`로 시작해 `</html>`로 마칩니다. 가장 기본적인 태그이지요. 모든 내용은 시작 태그 `<html>`과 닫는 태그인`</html>` 사이에 넣어야합니다.
-*   `<p>`는 문단 태그입니다. 문단의 끝 역시 `</p>`로 닫습니다.
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. 웹사이트의 모든 내용은 시작 태그 `<html>`과 닫는 태그인`</html>` 사이에 넣어야만 합니다.
+* `<p>`는 문단 태그입니다. 문단의 끝은 `</p>`로 닫습니다.
 
-## Head & body
+## Head and body
 
 각 HTML 페이지는 두 가지 요소, **head**와 **body**로 구분됩니다.
 
-*  **head** 는 문서 정보를 가지고 있지만, 웹 페이지에서 보이지 않는 정보들을 담는 영역입니다.
+* **head**는 문서에 대한 정보를 담고 있지만 이 정보는 화면에 직접적으로 보여지 않습니다.
 
-*  **body** 란 웹 페이지에 직접적으로 보이는 내용이 들어갑니다. 웹 페이지의 내용은 모두 이 body태그안에 들어갑니다.
+* **body**는 웹사이트에 보여지는 모든 내용을 담고 있습니다.
 
 `<head>`는 브라우저에 페이지에 대한 설정들을 알려주고, `<body>`는 실제 페이지에 보여줄 내용을 알려줍니다.
 
+For example, you can put a web page title element inside the `<head>`, like this:
+
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <head>
@@ -78,35 +81,37 @@ blog
 </html>
 ```
 
-파일을 저장하고 페이지를 새로고침 하세요.
+파일을 저장하고 페이지를 새로고침 해보세요.
 
-![Figure 11.3](images/step4.png)
+![그림 11.3](images/step4.png)
 
-브라우저는 어떻게 "Ola's blog"를 웹 페이지의 제목으로 이해했을까요? 바로 브라우저가 `<title>Ola's blog</title>`를 해석해 브라우저 제목 표시줄에 내용을 반영한 것입니다. (해당 페이지를 북마크를 할 때도 동일합니다)
+브라우저가 어떻게 "Ola's blog"를 웹 페이지의 제목으로 이해했을까요? 바로 브라우저가 `<title>Ola's blog</title>`를 해석해 브라우저 제목 표시줄에 내용을 반영한 것입니다. (북마크를 할 때도 이렇게 사용됩니다.)
 
-태그는 `/`로*태그 마침*하고 여러 태그를 *중첩(nested)*해서 사용할 수 있습니다. (모든 태그를 꼭 닫아줘야합니다)
+태그는 `/`로*태그 마침*하고 *중첩(nested)*해서 사용할 수 있습니다. (모든 태그가 닫힐 때까지 특정 태그 하나만 닫을 수 없습니다.)
 
-태그는 상자에 뭔가 집어넣는 것과 같아요. `<html></html>`라고 하는 큰 상자가 있다면, 상자 안에는 `<body></body>` 상자가 있고, 또 그 상자 안에는 `<p></p>`라는 더 작은 상자가 있는 것과 같아요.
+이 개념은 박스에 뭔가 집어 넣는 것과 같아요. 여러분에게 `<html></html>`라고 하는 큰 박스가 있습니다. 박스 안에는 `<body></body>` 박스가 있고, 또 그 박스 안에는 `<p></p>`라는 더 작은 박스들이 있는 것이죠.
 
-*태그 마침*과 *중첩*의 규칙을 잘 따라야 해요. 그렇지 않으면, 브라우저가 해석할 수 없어 페이지가 원하는 모습으로 나오지 않게 됩니다.
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
 
 ## 맞춤형 템플릿 만들기
 
-앞으로 좀 더 재밌어질 거에요. 나만의 템플릿을 만들어 볼 거에요! 아래 태그들을 짚고 넘어가세요.
+여러분은 이제 좀 더 재밌어질 것입니다. 여러분만의 템플릿을 만들어봅시다! 여기 몇 가지 유용한 태그들이 있습니다:
 
-* `<h1>A heading</h1>` - 큰 제목
-* `<h2>A sub-heading</h2>` - 중 제목
-* `<h3>A sub-sub-heading</h3>` - 소 제목... `<h6>`레벨까지 사용할 수 있습니다.
-* `<em>text</em>` - 텍스트 기울기 (Italic)
-* `<strong>text</strong>` - 텍스트를 두껍게(Bold)
-* `<br />` - 줄바꿈 (br은 스스로 닫히는 태그로 속성을 사용할 수 없습니다)
-* `<a href="http://djangogirls.org">link</a>` - 하이퍼링크 걸기
-* `<ul><li>first item</li><li>second item</li></ul>`- 목록 만들기
-* `<div></div>` - 페이지 섹션
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` 그 다음 수준의 머리말에 사용하는 태그
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` 텍스트를 강조할 때 사용하는 태그
+* `<strong>text</strong>` 여러분의 텍스트를 강력하게 강조할 때 사용하는 태그
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` 링크 걸기
+* `<ul><li>first item</li><li>second item</li></ul>` 목록을 만듭니다. 지금 여러분이 보고 있는 목록처럼요!
+* `<div></div>` 페이지의 섹션을 정의합니다.
 
-아래 템플릿 예제가 있습니다.
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <head>
@@ -114,7 +119,7 @@ blog
     </head>
     <body>
         <div>
-            <h1><a href="">Django Girls Blog</a></h1>
+            <h1><a href="/">Django Girls Blog</a></h1>
         </div>
 
         <div>
@@ -134,76 +139,75 @@ blog
 
 이 템플릿에는 세 개의 `div` 섹션이 있습니다.
 
-* 첫 번째 `div`는 블로그 제목을 가지고 있어요. 머리말과 링크이지요.
-* 나머지 두 `div`는 블로그 게시일과 `h2`로 된 블로그 제목과 링크를가 있습니다. 두 `p(문단)`의 하나는 날짜를, 다른 하나는 블로그를 가리키죠.
+* The first `div` element contains the title of our blog – it's a heading and a link
+* 나머지 두 `div`는 블로그 글 출판 날짜와 클릭할 수 있는 `h2`로 된 블로그 제목을 가지고 있습니다. 두 `p`(문단)의 하나는 날짜를, 다른 하나는 블로그를 위한 거에요.
 
-태그로 웹 페이지 화면이 아래와 같이 바뀝니다.
+이 태그들로 이렇게 변합니다. :
 
-![Figure 11.4](images/step6.png)
+![그림 11.4](images/step6.png)
 
-야호! 이전 템플릿은 **동일한 내용** 만을 보여줬어요. 이처럼 템플릿은 **같은 양식** 을 사용하지만, **다른** 정보들을 보여줄 때 사용됩니다.
+야호! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
 
-장고 관리자에서 추가한 글을 보여주는 방법은 곧 알아볼 거에요.
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
 
 ## 하나 더: 배포하기!
 
-방금 고친 내용을 인터넷에서도 봐야겠죠? PythonAnywhere으로도 배포해 봅시다.
+방금 작업했던 것이 인터넷에서도 볼 수 있으면 좋겠죠? PythonAnywhere으로도 배포해 봅시다. :
 
 ### Github에 코드를 커밋, 푸시하세요!
 
-제일 먼저, 마지막 배포 이후 수정된 파일을 확인해 봅시다. (PythonAnywhere가 아닌 로컬에서 실행하세요)
+제일 먼저, 마지막 배포 이후 수정된 파일을 확인해 봅시다. (PythonAnywhere가 아닌 로컬에서 실행하세요) :
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-```
 
-`djangogirls` 디렉터리에서 `git`에게 현재 폴더에 있는 모든 변경 내용을 포함시키라고 말해봅시다.
+    $ git status
+    
+
+`djangogirls` 디렉토리에서 `git`에게 현재 폴더에 있는 모든 변경 내용을 포함라고 말합니다.
 
 {% filename %}command-line{% endfilename %}
-```
-$ git add --all .
-```
 
-> **Note** `-A` ("all"의 축약어)는 `git`이 삭제한 파일을 인식합니다. (기본적으로, 새로 추가하거나 변경한 파일만 인식합니다) `.`가 현재 디렉터리라는 것을 기억하고 있죠? (3장에서 언급한 내용이에요)
+    $ git add --all .
+    
+
+> **Note** `-A` ("all"의 축약어) 는 `git`이 삭제한 파일을 인식합니다. (기본적으로, 새로 추가하거나 변경한 파일만 인지합니다) 또한 `.`의미가 현재 디렉토리라는 것을 기억하고 있죠? (3장에서 언급한 내용이에요)
 
-파일 업로드 전, `git`으로 업로드 할 파일들을 확인해봅시다. (`git`에서 업로드 할 모든 파일들은 녹색으로 표시됩니다)
+파일 업로드 전, `git`으로 업로드 할 파일들을 확인해봅시다. (`git`에서 업로드 할 모든 파일들이 녹색으로 나타나야 합니다.) :
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-```
 
-거의 다 왔습니다. 이제 github 저장소에 변경 사항을 히스토리에 저장할 단계예요. `커밋 메시지(commit message)`를 입력해, 수정 변경된 내용을 알려줄 거에요. 메시지 내용은 아무거나 적어도 되지만, 나중에 작업 내용을 기억할 수 있도록 설명 내용을 간단히 입력하는 것이 좋습니다.
+    $ git status
+    
+
+거의 다 왔습니다. 이제 저장소에 변경 사항을 저장할 단계예요. 우리는 "커밋 메시지(commit message)"를 주어, 어떤 것이 수정 변경되었는지 알려줄 거에요. 이번에는 아무거나 적어도 괜찮습니다. 하지만 앞으로는 내가 수정한 내용을 간략하게 적어 다음에 기억할 수 있도록 하는 것이 좋을 거에요.
 
 {% filename %}command-line{% endfilename %}
-```
-$ git commit -m "Changed the HTML for the site."
-```
 
-> **Note** 커밋 메시지를 쌍따옴표(")로 감싸주세요.
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **주의** 커밋 메시지는 쌍따옴표(")로 감싸주세요.
 
-완성되면, github으로 업로드(푸쉬) 하세요.
+Once we've done that, we upload (push) our changes up to GitHub:
 
 {% filename %}command-line{% endfilename %}
-```
-$ git push
-```
 
+    $ git push
+    
 
 ### PythonAnywhere에서 새 코드를 가져와, 웹 앱을 다시 불러옵니다.
 
-* [PythonAnywhere 콘솔 페이지](https://www.pythonanywhere.com/consoles/)를 열고 **배시 콘솔** (또는 새로운 창)에서 아래와 같이 명령어를 입력합니다.
+* [PythonAnywhere 콘솔 페이지](https://www.pythonanywhere.com/consoles/)를 열고 **배시 콘솔** (또는 새로운 창)을 준비합니다. 그 다음, 명령어를 입력합니다. :
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd ~/my-first-blog
-$ git pull
-[...]
-```
 
-코드가 다운되고 있죠? 다 되었는지 확인하고 싶으면 **파일 탭(Files tab)**에 가서 내 코드가 PythonAnywhere에 있는지 확인합니다.
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+그러면 코드가 다운되는 것을 볼 수 있어요. 다 되었는지 확인하고 싶으면 **파일 탭(Files tab)**에 가서 내 코드가 PythonAnywhere에 있는지 확인합니다.
 
-* 마지막으로 [Web tab](https://www.pythonanywhere.com/web_app_setup/)으로 가서 웹 앱을 **다시 불러오기(Reload)**를 하세요.
+* 마지막으로 [웹 탭(Web tab)](https://www.pythonanywhere.com/web_app_setup/)으로 가서 여러분의 웹 앱을 **다시 불러오기**를 하세요.
 
-인터넷에도 업데이트 되었어요! 브라우저를 새로고침하면 변경된 내용을 확인할 수 있어요. 변경한 내용이 보일 거에요. :)
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ko/install_git.md b/ko/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ko/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ko/installation/README.md b/ko/installation/README.md
index 52cd67e4252..616415c9951 100755
--- a/ko/installation/README.md
+++ b/ko/installation/README.md
@@ -1,49 +1,58 @@
-# 집에서 튜토리얼을 보시는 분들에게
+# 집에서 이 튜토리얼을 보는 분들에게
 
-[장고걸스 워크샵](http://djangogirls.org/events/)이 아닌 집에서 튜토리얼을 학습하는 분들은 이 장을 건너뛰고 [인터넷은 어떻게 작동할까요](../how_the_internet_works/README.md)부터 읽으세요.
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
 
-이번 장에는 설치와 관련된 모든 내용을 모두 모았습니다. 장고걸스 워크샵은 행사 전날, '설치의 밤'에서 모든 프로그램을 설치하고 개발환경을 준비하는 시간이 준비되어 있습니다. 워크샵 중간에 설치 문제로 진행에 어려움을 겪지 않게 하기 위해서지요.
+이 장에는 설치와 관련된 모든 내용을 모았습니다. 장고 걸스 이벤트에서는 워크샵 사전에 모든 설치를 완벽히 마치는, '설치의 밤'이 있습니다. 워크샵 중간 중간에 설치 문제로 진행에 서로 어려움을 겪지 않게 하기 위해서지요.
 
-컴퓨터에 먼저 모든 설치를 끝내고 내용을 따라가도 좋고, 설치 부분을 건너뛰고 먼저 학습을 시작해도 됩니다. 튜토리얼 뒷부분에서도 설치 방법에 대해 다룹니다.
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
 
 모두 행운을 빌어요!
 
 # 설치하기
 
-우리는 워크숍 하루 동안 나만의 블로그를 완성해 볼거에요. 워크숍 사전에 모든 설치가 완벽하게 끝냈다면, 온종일 코딩할 준비가 된 거랍니다.
+우리는 워크샵에서 블로그를 만들 거에요. 사전에 몇 가지 설치를 끝낸다면, 하루 종일 코딩할 준비가 된 거랍니다.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
 
-<!--sec data-title="Chromebook 사용자"
-data-id="chromebook_setup" data-collapse=true ces-->
-{% include "/chromebook_setup/instructions.md" %}
 <!--endsec-->
 
 # Python 설치하기
+
 {% include "/python_installation/instructions.md" %}
 
-# virtualenv 환경 설정 및 Django 설치하기
+# virtualenv 설정하고 Django 설치하기
+
 {% include "/django_installation/instructions.md" %}
 
 # 코드 에디터 설치하기
+
 {% include "/code_editor/instructions.md" %}
 
 # Git 설치하기
+
 {% include "/deploy/install_git.md" %}
 
 # GitHub 계정 만들기
-[GitHub.com](http://www.github.com)에서 무료 사용자 계정으로 회원가입을 하세요.
+
+[GitHub.com](https://www.github.com)에 가서 무료 사용자 계정으로 회원가입을 하세요.
 
 # PythonAnywhere 계정 만들기
+
 {% include "/deploy/signup_pythonanywhere.md" %}
 
-# 읽어보기
+# 코딩 시작
+
+축하합니다. 드디어 여러분은 시작할 준비가 되었답니다! 워크샵 사전에 튜토리얼 앞 부분을 미리 읽어두면 도움이 될 거에요:
+
+* [인터넷은 어떻게 작동할까요?](../how_the_internet_works/README.md)
+
+* [커맨드라인(command line) 시작하기](../intro_to_command_line/README.md)
 
-축하합니다. 드디어 코딩을 시작할 준비가 되었답니다! 워크숍 전에 튜토리얼의 앞 부분을 미리 읽어보세요.
+* [파이썬(python) 시작하기](../python_introduction/README.md)
 
-* [인터넷은 어떻게 작동할까요](../how_the_internet_works/README.md)
-* [Command line 시작하기](../intro_to_command_line/README.md)
-* [Python 시작하기](../python_introduction/README.md)
-* [Django란 무엇인가요](../django/README.md)
+* [Django란 무엇일까요?](../django/README.md)
 
+# 워크샵을 즐기세요!
 
-# 워크샵 즐기기!
-워크샵을 시작하면, 앞 부분의 내용을 모두 읽었다는 가정 하에 바로 [나의 첫 번째 장고 프로젝트!](../django_start_project/README.md) 장부터 할 수 있게 준비해주세요.
+워크샵이 시작하면, 앞의 내용은 이미 다 이해했다고 생각하고 [나의 첫 번째 Django 프로젝트!](../django_start_project/README.md)로 넘어가세요.
\ No newline at end of file
diff --git a/ko/instructions.md b/ko/instructions.md
new file mode 100644
index 00000000000..b5a0981698b
--- /dev/null
+++ b/ko/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period. It's easy to install and use, and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source, easy to install and easy to use. It's available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ko/intro_to_command_line/README.md b/ko/intro_to_command_line/README.md
index 5f65db03893..928b2c9a68d 100755
--- a/ko/intro_to_command_line/README.md
+++ b/ko/intro_to_command_line/README.md
@@ -1,204 +1,289 @@
-# 커맨드 라인 시작하기
+# 커맨드라인 시작하기
 
-> **Note** 집에서 학습하시는 분들은 ['내 친구 커맨드 라인를 소개합니다'](https://www.youtube.com/watch?v=jvZLWhkzX-8) 영상을 보세요.
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
 
-벌써부터 기대되지 않나요? 바로 일 분안에 여러분도 코딩 할 수 있어요!
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
 
-**여러분에게 첫 번째 친구를 소개합니다. 바로, 커맨드 라인(command line) 입니다!**
+**여러분에 첫 번째 친구를 소개합니다: 바로, 커맨드라인(command line) 입니다!**
 
-해커들이 사용하는 까만 윈도우 창을 어떻게 사용하는지 보여드릴 거에요. 처음에는 이 검은색 창이 무서워 보일 수도 있지만, 명령어를 기다리는 아이일 뿐이에요.
+해커들이 사용하는 까만 윈도우 창을 어떻게 사용하는지 보여드릴 거에요. 처음에는 약간 무서워 보일 수도 있지만, 여러분의 명령어를 기다리는 녀석일 뿐이에요.
 
-> **Note** 이 설명서에서 '디렉토리(directory)'와 '폴더(folder)' 모두 같은 뜻입니다.
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
 
-## 커맨드 라인은 무엇일까요?
+## 커맨드라인은 무엇일까요?
 
-**커맨드 라인(command line)**은 **커맨드-라인 인터페이스(command-line interface)**,  *cmd*, *CLI*, *프롬프트(prompt)*, *콘솔(console)*, *터미널(terminal)* 라고도 불리는 텍스트 기반 응용 프로그램으로 파일 보기, 처리, 조작이 가능합니다. 윈도우 익스플로러나 맥OS의 파인더와 비슷합니다. 하지만 그래픽 인터페이스는 없어요.
+**command line** 또는 **command-line interface**라고도 불리는 윈도우는 컴퓨터에서의 보기, 처리, 그리고 파일 조작을 위한 텍스트 기반 응용 프로그램입니다. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
 
-## 커맨드 라인 열기
+## 커맨드라인 열기
 
-커맨드 라인을 열어 몇 가지 실습해봅시다.
+커맨드라인을 열고 몇 가지 실험을 해봅시다.
 
-### 윈도우
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
 
-시작메뉴로 가서 → 모든 프로그램 → 보조프로그램 → 명령 프롬프트.
+Go to Start menu → Windows System → Command Prompt.
 
-### Mac OS X
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
 
-응용 프로그램 → 유틸리티 → 터미널.
+<!--endsec-->
 
-### 리눅스
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
 
-프로그램 → 보조 프로그램 → 터미널을 실행하면 될 거에요. 하지만 시스템에 따라 다를 수도 있으니 구글에서 찾아보세요.
+Go to Applications → Utilities → Terminal.
 
-## 프롬프트(prompt)
+<!--endsec-->
 
-이제 까만 배경이나 하얀 배경의 윈도우가 뭔가를 지시해주길 기다리고 있을 거에요.
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
 
-맥이나 리눅스의 경우, 이런 `$` 기호가 보일 거예요 :
+아마도 프로그램 → 보조 프로그램 → 터미널을 실행하면 될 거에요. 하지만 시스템에 따라 다를 수도 있어요. 그럴 때는 구글에서 찾아보세요. :)
+
+<!--endsec-->
+
+## 프롬프트
+
+이제 까만 배경이나 하얀 배경에 윈도우가 뭔가를 지시해주길 기다리고 있을 거에요.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+맥이나 리눅스의 경우, 이런 `$` 기호가 보일 거예요:
+
+{% filename %}command-line{% endfilename %}
 
     $
+    
 
+<!--endsec-->
 
-윈도우의 경우, 이런 `>` 기호가 보일 거에요 :
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+윈도우의 경우, 이런 `>` 기호가 보일 겁니다:
+
+{% filename %}command-line{% endfilename %}
 
     >
+    
+
+<!--endsec-->
 
+각각의 명령어는 접두어로 위와 같은 기호와 공백 한 칸이 붙습니다. 하지만 여러분이 입력할 필요는 없어요. 컴퓨터가 대신 해줄 거예요. :)
 
-각 명령어는 접두어로 위와 같은 기호와 공백 한 칸이 붙습니다. 하지만 여러분이 입력할 필요는 없어요. 컴퓨터가 대신 해줄 거예요 :)
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
 
-> 잠깐만요 : 상황에 따라 프롬트 기호 앞에 `C:\Users\ola>` 혹은 `Olas-MacBook-Air:~ ola$` 같은 것이 보일 수 있는데, 문제가 있는 것이 아니라 아주 잘 동작하는 거랍니다. 이 튜토리얼에서는 간략히 작성한 거에요.
+`$` 또는 `>` 포함 부분 짧게 *명령줄 프롬프트* 또는 *프롬프트*라고 합니다. 뭔가 입력하라는 표시입니다.
+
+이 튜토리얼을 따라하면서, 커맨드 라인에 명령어를 입력할 때마다 왼쪽에 `$` 또는 `>`표시가 보일 거에요. 프롬프트를 실행하고 나서 왼쪽 표시 부분을 무시하고 명령어를 바로 입력하면 됩니다.
 
 ## 나의 첫 번째 명령 (야호!)
 
-쉬운 것 부터 시작할게요. 아래 명령어를 입력해 보세요 :
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ whoami
+    
+
+<!--endsec-->
 
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
 
-또는
+{% filename %}command-line{% endfilename %}
 
     > whoami
+    
 
+<!--endsec-->
 
-그리고 `enter`를 누르세요. 다음과 같이 보일 거에요 :
+그리고 `enter`를 누르세요. 다음과 같이 보일 거에요.
 
-    $ whoami
-    olasitarska
+{% filename %}command-line{% endfilename %}
 
+    $ whoami 
+    olasitarska
+    
 
-컴퓨터는 사용자 이름을 스크린에 보여줍니다. 이거 좀 괜찮죠? :)
+As you can see, the computer has just printed your username. Neat, huh? :)
 
-> 복사 붙여넣기 하지 말고, 직접 입력해 보세요. 더 잘 외워질 거예요!
+> Try to type each command; do not copy-paste. You'll remember more this way!
 
 ## 기본 명령어
 
 각각의 운영체제에 따라, 명령어들이 조금씩 다를 수도 있으니까, 여러분의 운영체제에 해당하는 설명을 따라주세요. 그럼 같이 해볼까요?
 
-### 현재 디렉터리
+### 현재 디렉토리
 
-현재 어느 디렉터리에 있는지 확인하려면 아래 명령어를 입력하고 `enter`를 눌러보세요.
+우리가 어디쯤 있는지 알면 좋겠죠? 아래의 명렁을 입력하고 `enter`를 눌러보세요:
 
-맥 :
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ pwd
     /Users/olasitarska
+    
+
+> 참고: 'pwd' 는 'print working directory' 의 줄임말임.
+
+<!--endsec-->
 
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
 
-윈도우 :
+{% filename %}command-line{% endfilename %}
 
-    > cd
+    > cd 
     C:\Users\olasitarska
+    
 
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
 
-위와 비슷한 결과가 출력되었을 거예요. 커맨드라인을 열면, 항상 `Home` 디렉터리에서 시작합니다.
+<!--endsec-->
 
-> Note: 'pwd' 는 'print working directory'의 줄임말이에요.
+위와 비슷한 결과가 출력되었을 거예요. 커맨드라인을 열면, 항상 '홈 디렉토리' 에서 시작합니다.
 
 * * *
 
-### 파일과 디렉터리 목록 보기
+### 파일과 디렉토리 목록 보기
 
-디렉토리에 어떤 것이 있는지 확인하려면 이렇게 입력하세요.
+여기에는 뭐가 있는지 알아낼 수 있다면 좋겠지요? 그럼 같이 해봐요.
 
-맥 :
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
 
-    $ ls
-    Applications
-    Desktop
-    Downloads
-    Music
+{% filename %}command-line{% endfilename %}
+
+    $ ls 
+    Applications 
+    Desktop 
+    Downloads 
+    Music 
     ...
+    
 
+<!--endsec-->
 
-윈도우 :
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > dir  
-    Directory of C:\Users\olasitarska
-    05/08/2014 07:28 PM <DIR> Applications
-    05/08/2014 07:28 PM <DIR> Desktop
-    05/08/2014 07:28 PM <DIR> Downloads
-    05/08/2014 07:28 PM <DIR> Music
+    Directory of C:\Users\olasitarska 
+    05/08/2014 07:28 PM <DIR> Applications 
+    05/08/2014 07:28 PM <DIR> Desktop 
+    05/08/2014 07:28 PM <DIR> Downloads 
+    05/08/2014 07:28 PM <DIR> Music 
     ...
+    
 
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
 
 * * *
 
-### 현재 디렉터리 변경
+### 현재 디렉토리 변경
+
+자, 바탕화면 디렉토리로 가볼까요:
 
-자, 바탕화면 디렉터리로 가볼까요 :
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
 
-맥 :
+{% filename %}command-line{% endfilename %}
 
     $ cd Desktop
+    
+
+<!--endsec-->
 
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
 
-윈도우 :
+{% filename %}command-line{% endfilename %}
 
     > cd Desktop
+    
 
+<!--endsec-->
 
-변경되었는지 확인합시다.
+정말 변경되었는지 볼까요:
 
-맥 :
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
 
-    $ pwd
+{% filename %}command-line{% endfilename %}
+
+    $ pwd 
     /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
 
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
 
-윈도우 :
+{% filename %}command-line{% endfilename %}
 
-    > cd
+    > cd 
     C:\Users\olasitarska\Desktop
+    
 
+<!--endsec-->
 
 맞군요!
 
-> 전문가 팁 : `cd D`까지 입력하고 `tab`(탭) 키를 누르면, 커맨드 라인이 자동으로 나머지 부분을 완성해주어, 입력하는 시간을 절약할 수 있어요. "D"로 시작하는 폴더가 2개 이상일 경우, `tab`(탭) 키를 두 번 누르면, 해당하는 폴더들을 모두 보여줍니다.
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
 
 * * *
 
-### 새 디렉터리 생성하기
+### 새 디렉토리 만들기
 
-바탕 화면에 `practice` 디렉터리를 만들어 볼까요? 이렇게 하면 됩니다.
-(되도록 폴더명은 한국어 대신 영어로 작성하는 것이 좋아요 - 장고걸스서울)
+바탕 화면에 연습 디렉터리를 만들어 볼까요? 이렇게 하면 돼요:
 
-맥 :
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ mkdir practice
+    
+
+<!--endsec-->
 
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
 
-윈도우 :
+{% filename %}command-line{% endfilename %}
 
     > mkdir practice
+    
 
+<!--endsec-->
 
-이 간단한 명령어로, 바탕화면에 `practice`폴더를 만듭니다. 바탕화면에서 직접 보거나, 명령어 `ls` 혹은 `dir`을 실행해서 확인할 수 있어요! 한 번 해보세요.
+이 간단한 명령어가, 바탕화면에 `practice` 라는 이름의 폴더를 만들어 줍니다. 바탕화면에서 직접 보거나, 명령어 `ls` 혹은 `dir`을 실행해서 확인할 수 있어요! 한 번 해보세요. :)
 
-> 전문가 팁 : 같은 명령어를 여러 번 반복해 입력하고 싶지 않다면, 키보드 `위 화살표`와 `아래 화살표`를 누르세요. 최근 사용한 명령어들을 볼 수 있어요.
+> 전문가 팁: 같은 명령어를 여러 번 반복해서 입력하고 싶지 않다면, 키보드의 `위 화살표`와 `아래 화살표`를 눌러서 최근 사용한 명령어들을 볼 수 있어요.
 
 * * *
 
 ### 연습문제!
 
-연습 과제를 드릴게요. 새로 만든 `practice`디렉터리 안에 `test` 라는 이름의 디렉터리를 만들어 보세요. 명령어 `cd`와 `mkdir`을 사용하세요.
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### 답:
 
-#### 답 :
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
 
-맥 :
+{% filename %}command-line{% endfilename %}
 
     $ cd practice
     $ mkdir test
     $ ls
     test
+    
 
+<!--endsec-->
 
-윈도우:
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd practice
     > mkdir test
     > dir
     05/08/2014 07:28 PM <DIR>      test
+    
 
+<!--endsec-->
 
 축하합니다 :)
 
@@ -206,97 +291,139 @@
 
 ### 정리
 
-지금까지 연습한 내용을 모두 지워봅시다!
+어지럽힌 흔적은 남기고 싶지 않지요, 지금까지 한 것들을 모두 지워봅시다!
 
 우선, 바탕화면으로 돌아가야해요.
 
-맥 :
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ cd ..
+    
 
+<!--endsec-->
 
-윈도우 :
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd ..
+    
 
+<!--endsec-->
 
-`..`과 `cd` 명령은 현재 디렉터리에서 부모 디렉터리(현재 디렉터리 레벨보다 상위인)로 보내줄겁니다.
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
 
-현재 위치를 확인해 보세요.
+현재 위치를 확인해 보세요:
 
-맥 :
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
 
-    $ pwd
+{% filename %}command-line{% endfilename %}
+
+    $ pwd 
     /Users/olasitarska/Desktop
+    
 
+<!--endsec-->
 
-윈도우 :
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
 
-    > cd
+{% filename %}command-line{% endfilename %}
+
+    > cd 
     C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
 
+이제 `practice` 디렉토리를 삭제할시간이에요:
 
-이제 `practice` 디렉터리를 삭제해봐요.
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
 
-> **Note**: `del`, `rmdir`, `rm`을 사용하여 파일을 지우면, 재복구가 불가능합니다. *지워진 파일들을 영원히 사라지게 됩니다!* 그러니, 이 명령어들은 꼭 주의해서 사용하세요.
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
 
-맥 :
+{% filename %}command-line{% endfilename %}
 
     $ rm -r practice
+    
 
+<!--endsec-->
 
-윈도우 :
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > rmdir /S practice
     practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
 
+완료! 실제로 삭제되었는지, 확인해 봅시다:
 
-완료되었습니다! 완전히 삭제되었는지 확인해 보세요.
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
 
-맥 :
+{% filename %}command-line{% endfilename %}
 
     $ ls
+    
+
+<!--endsec-->
 
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
 
-윈도우 :
+{% filename %}command-line{% endfilename %}
 
     > dir
+    
 
+<!--endsec-->
 
 ### 종료
 
-여기까지 입니다! 이제 커맨드 라인을 닫으세요. 해커 스타일로 해볼까요, 괜찮죠?:)
+여기까지입니다! 이제 커맨드라인을 닫으시면 됩니다. 해커 스타일로 해 볼까요, 괜찮죠? :)
 
-맥 :
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ exit
+    
+
+<!--endsec-->
 
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
 
-윈도우 :
+{% filename %}command-line{% endfilename %}
 
     > exit
+    
 
+<!--endsec-->
 
 멋지지 않나요? :)
 
-## 요약
+## 목차
 
-아래 유용한 명령어를 모았습니다.
+유용한 명령어들을 요약한 표입니다:
 
-| 명령어(윈도우) | 명령어(맥 OS/리눅스) | 설명                  | 예시                                                |
-| -------- | ------------- | ------------------- | ------------------------------------------------- |
-| exit     | exit          | 창을 닫는다              | **exit**                                          |
-| cd       | cd            | 디렉터리를 변경한다          | **cd test**                                       |
-| dir      | ls            | 디렉터리 혹은 파일 목록을 보여준다 | **dir**                                           |
-| copy     | cp            | 파일을 복사한다            | **copy c:\test\test.txt c:\windows\test.txt** |
-| move     | mv            | 파일을 이동한다            | **move c:\test\test.txt c:\windows\test.txt** |
-| mkdir    | mkdir         | 새 디렉터리를 만든다         | **mkdir testdirectory**                           |
-| del      | rm            | 디렉터리 혹은 파일을 지운다     | **del c:\test\test.txt**                        |
+| 명령어(윈도우)       | 명령어(맥 OS/리눅스) | 설명                         | 예시                                                |
+| -------------- | ------------- | -------------------------- | ------------------------------------------------- |
+| exit           | exit          | 창을 닫는다                     | **exit**                                          |
+| cd             | cd            | 디렉토리를 변경한다                 | **cd test**                                       |
+| cd             | pwd           | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir            | ls            | 디렉토리 혹은 파일 목록을 보여준다        | **dir**                                           |
+| copy           | cp            | 파일을 복사한다                   | **copy c:\test\test.txt c:\windows\test.txt** |
+| move           | mv            | 파일을 이동한다                   | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir          | mkdir         | 새 디렉토리를 만든다                | **mkdir testdirectory**                           |
+| rmdir (or del) | rm            | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S       | rm -r         | delete a directory         | **rm -r testdirectory**                           |
 
-지금까지 커맨드 라인 명령어 일부를 알아보았어요. 이 정도만 알고 있어도 코딩하는데 문제가 없습니다.
+커맨드라인에서 실행할 수 있는 명령어들 중에, 아주 몇 가지만 소개했지만, 오늘은 이정도만 필요할 거에요. 
 
-더 알고 싶다면, [ss64.com](http://ss64.com)에서 각 운영체제별로 정리된 명령어 모음을 볼 수 있어요.
+더 알고 싶다면, [ss64.com](http://ss64.com)에서 운영체제별로 정리된 명령어모음을 볼 수 있어요.
 
 ## 준비되셨나요?
 
-이제 파이썬의 세계로 빠져봅시다!
+이제 파이썬의 세계로 빠져봅시다!
\ No newline at end of file
diff --git a/ko/python_installation/README.md b/ko/python_installation/README.md
index 75bcb86b438..7710a80e397 100755
--- a/ko/python_installation/README.md
+++ b/ko/python_installation/README.md
@@ -1,18 +1,15 @@
 # 파이썬 시작하기
 
-잘 오셨습니다!
+여기까지 오셨군요!
 
-제일 먼저 파이썬(Python)에 대해 설명할게요. 파이썬은 아주 인기있는 프로그래밍 언어로, 웹 사이트는 물론 게임, 과학용 소프트웨어, 그래픽 소프트웨어 등 다양한 것을 만들 수 있답니다.
+먼저 파이썬(Python) 이란 무엇인지부터 말씀드릴게요. 파이썬은 아주 인기있는 프로그래밍 언어로, 파이썬을 이용하면 웹사이트, 게임, 과학용 소프트웨어, 그래픽 소프트웨어 등을 만들 수 있답니다.
 
-파이썬은 1980년대 후반에 프로그래밍 언어를 기계 뿐만 아니라 인간도 읽을 수 있도록 만들고자 탄생한 언어입니다. 파이썬이 다른 프로그래밍 언어보다 훨씬 간단하게 보이고, 배우기도 쉬운 이유도 그 때문이죠. 하지만 파이썬은 아주 강력한 기능을 가진 프로그래밍 언어랍니다.
+파이썬은 1980년대 후반에 만들어졌어요. 기계 뿐만 아니라 인간도 읽을 수 있도록 만드는 것이 목적이었어요. This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
 
 # 파이썬 설치하기
 
-> **Note** 크롬북 사용자는 이번 장을 건너뛰고,  [크롬북에서 설치하기](../chromebook_setup/README.md) 장으로 넘어가세요.
-
-
-> **Note** 설치를 마친 분은 다음 장으로 넘어가세요!
-
-
-{% include "/python_installation/instructions.md" %}
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
 
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ko/python_installation/instructions.md b/ko/python_installation/instructions.md
index 85fb14db560..baf073f0eb6 100755
--- a/ko/python_installation/instructions.md
+++ b/ko/python_installation/instructions.md
@@ -1,106 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> 위 내용은 Geek Girls Carrots (http://django.carrots.pl)을 바탕으로 작성되었습니다.
 
-> **Note** 집에서 학습하시는 분들은 [파이썬 & 코드에디터 설치하기](https://www.youtube.com/watch?v=pVTaqzKZCdA) 영상을 보세요.
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
 
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
 
-> **Note** 이 장은 Geek Girls Carrots (https://github.com/ggcarrots/django-carrots) 튜토리얼을 기초로 작성되었습니다.
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
 
-장고는 파이썬 언어로 작성됐습니다. 파이썬이 있어야 장고를 할 수 있어요. 우선 설치부터 해볼까요! 우리는 파이썬 3.6를 사용할 거예요. 이보다 낮은 버전이 설치되었다면, 버전 업그레이드 하세요.
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
 
-<!--sec data-title="Windows" data-id="python_windows_ko" data-collapse=true ces-->
+![파이썬을 패쓰 (path)에 추가하는 것을 잊지 마세요.](../python_installation/images/python-installation-options.png)
 
-사용 중인 컴퓨터 윈도우 운영체제가 32비트인지 64비트인지 확인하려면 https://support.microsoft.com/en-au/kb/827218 에서 확인하세요. 윈도우 용 파이썬은 https://www.python.org/downloads/windows/ 웹 사이트에서 다운로드 할 수 있습니다. "Latest Python 3 Release - Python x.x.x"링크를 클릭하세요. **64 비트** 버전의 Windows인 경우 **Windows x86-64 executable installer**를 다운로드하세요. 이외에는 **Windows x86 executable installer**을 다운로드하세요. 설치 프로그램을 다운로드 한 후에 실행(더블 클릭)하고 지시 사항을 따르세요.
-
-> **Note** 설치하는 동안 "Setup(설치하기)"이라고 표시된 창이 나타납니다. 다음과 같이 "Add Python 3.6 to PATH(python3.6를 경로에 추가)"체크 박스를 체크하고 "Install Now(지금 설치하기)"를 클릭하세요.
-
-![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
-
-다음 단계에서는 윈도우 명령 프롬프트를 사용할 거에요 (윈도우 명령어도 알려드릴 거에요. 지금은 일부 명령을 입력해야하는 경우 시작 메뉴 → 모든 프로그램 → 보조 프로그램 → 명령 프롬프트로 이동하세요. Windows 키를 누르고 "실행"창이 팝업 될 때까지 "R"키를 누르면 됩니다. 명령어를 입력하려면 "cmd"를 입력하고 "실행"창에서 엔터키를 누르세요. (윈도우 최신 버전에서는 "명령 프롬프트"가 메뉴에 없을 수 있어 검색해 실행하면 됩니다)
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
 
 ![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
 
-> **Note** 윈도우 이전 버전(윈도우7, Vista 등)에서 파이썬 3.6.x 설치오류가 생기면, 다음과 같이 해보세요.
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
 
-1. 모든 윈도우 업데이트 후 파이썬 3.6를 다시 설치합니다.
-2. 또는 [파이썬 이전 버전](https://www.python.org/downloads/windows/)을 설치합니다. 
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
 
-버전이 낮은 파이썬 설치 시, 설치 화면이 위에 표시된 것과 약간 다르게 보일 수 있습니다. "Add Python 3.6. to PATH"를 보려면 아래로 스크롤 한 다음 왼쪽의 버튼을 클릭하고 "Will be installed on local hard drive(로컬 하드 드라이브에 설치)"를 선택하세요.
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
 
 ![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
 
 <!--endsec-->
 
-<!--sec data-title="OS X" data-id="python_OSX_ko"
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
 data-collapse=true ces-->
 
-> **Note** OS X에서는 파이썬 설치하기 전, Mac 설정에서 App Store가 아닌 패키지를 설치할 수 있도록 설정해야합니다. 시스템 환경 설정 (응용 프로그램 폴더에 있음)으로 이동하여 "보안 및 개인 정보"를 클릭 한 다음 "일반"탭을 클릭하세요. "다운로드 한 응용 프로그램 허용"이 "Mac App Store"로 설정된 경우 "Mac App Store 및 확인된 개발자"로 변경하세요.
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
 
-웹 사이트로 가서 파이썬 설치 파일을 다운 받으세요. : https://www.python.org/downloads/release/python-351/
+https://www.python.org/downloads/release/python-361/ 에서 파이썬 설치프로그램을 다운로드 받아야 합니다.
 
-* *Mac OS X 64-bit/32-bit installer* 파일을 다운받습니다.
-* *python-3.6.1-macosx10.6.pkg*을 더블클릭해 설치합니다.
+* *Mac OS X 64-bit/32-bit installer* 파일을 다운 받으세요.
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
 
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="python_linux_ko"
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
 data-collapse=true ces-->
 
-이미 파이썬이 설치되었을 겁니다. 설치된 버전을 확인하려면 콘솔을 열고 다음 명령을 입력하세요. :
+아마도 이미 파이썬이 설치되어있을 거에요. 설치되어있는지 (그리고 어떤 버전인지) 확인하려면, 콘솔을 열어서 다음 명령을 실행하세요.
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 --version
-Python 3.6.1
-```
 
-3.6.0 버전과 같이 '마이크로 버전'의 파이썬이 설치되어있는 경우 업그레이드 할 필요가 없습니다. 다른 버전의 파이썬을 설치하고 싶으면 아래와 같이하면 됩니다. :
+    $ python3 --version 
+    Python 3.6.1
+    
 
-<!--endsec-->
+3.6.0 등, 설치된 파이썬 버전이 'micro version'이라면, 업그레이드할 필요가 없습니다. 파이썬이 설치되어 있지 않거나 버전이 다르면 이렇게 해보세요:
 
+<!--endsec-->
 
-<!--sec data-title="Debian / Ubuntu" data-id="python_debian_ko"
-data-collapse=true ces-->
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
 
-콘솔에 아래 명령어를 입력하세요. :
+콘솔에서 다음 명령을 실행하세요.
 
 {% filename %}command-line{% endfilename %}
-```
-$ sudo apt-get install python3.6
-```
+
+    $ sudo apt-get install python3.6
+    
 
 <!--endsec-->
 
-<!--sec data-title="Fedora" data-id="python_fedora_ko"
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
 data-collapse=true ces-->
 
-콘솔에 아래 명령어를 입력하세요. :
+콘솔에서 다음 명령을 실행하세요.
 
 {% filename %}command-line{% endfilename %}
-```
-$ sudo dnf install python3
-```
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
 
 <!--endsec-->
 
-<!--sec data-title="openSUSE" data-id="python_openSUSE_ko"
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
 data-collapse=true ces-->
 
-콘솔에 아래 명령어를 입력하세요. :
+콘솔에서 다음 명령을 실행하세요.
 
 {% filename %}command-line{% endfilename %}
-```
-$ sudo zypper install python3
-```
+
+    $ sudo zypper install python3
+    
 
 <!--endsec-->
 
-설치가 성공적으로 마쳤는지 확인하려면, *터미널* 을 열고 `python3` 명령어를 입력해보세요.
+Verify the installation was successful by opening a command prompt and running the `python3` command:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 --version
-Python 3.6.1
-```
 
-> **Note** 윈도우에서 `python3`명령어를 입력한 후 에러 메세지가 나온다면 `python`(`3`을 빼고)이라 입력해보고 파이썬 3.6버전인지 체크해보세요.
+    $ python3 --version 
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
 
-설치 도중 문제가 생기거나 잘되지 않으면 코치들에게 도움을 요청하세요! 가끔은 경험이 많은 분들에게 도움을 받는 것이 더 좋을 수 있습니다.
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! 잘 설치 되지 않는 경우도 있을 수 있습니다. 그럴 때는 경험이 있는 분에게 도움을 구해보세요.
\ No newline at end of file
diff --git a/ko/python_introduction/README.md b/ko/python_introduction/README.md
index af7c3851d16..20896c921ab 100755
--- a/ko/python_introduction/README.md
+++ b/ko/python_introduction/README.md
@@ -1,140 +1,149 @@
-# 파이썬 시작하기
+# 파이썬(python) 시작하기
 
-> **Note** 이 장의 일부는 [Geek Girls Carrots 튜토리얼](https://github.com/ggcarrots/django-carrots)을 기초로 작성되었습니다. 
+> 이번 장의 일부는 Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)의 튜토리얼을 바탕으로 작성되었습니다.
 
+자, 코딩 한 번 해봅시다!
 
-자, 지금부터 코딩 한번 해볼까요?
+## 파이썬 프롬프트 (Python prompt)
 
-## 파이썬 프롬프트(Python prompt)
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
 
-> **Note** 집에서 학습하시는 분은 [파이썬 기초: 숫자, 문자열, 리스트, 변수, 에러](https://www.youtube.com/watch?v=MO63L4s-20U) 영상을 보세요.
-
-파이썬과 놀아보려면 *커맨드 라인* 창을 켜야합니다. [Command Line 시작하기](../intro_to_command_line/README.md) 장에서 어떻게 하는지 배웠어요.
+Python과 함께 놀기 위해서는 *커맨드라인*을 열어야 합니다. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
 
 준비되었다면, 아래 내용을 잘 따라오세요.
 
-파이썬 콘솔을 실행하기 위해, 윈도우에서는 `python`을 입력하고, 맥OS나 리눅스라면 `python3`를 입력하고 `엔터`를 입력하세요.
+파이썬 콘솔을 실행해야합, 윈도우에서는 `python`을 입력하고 맥OS나 리눅스라면`python3`를 입력하고 `엔터`를 입력하세요.
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3
-Python 3.6.1 (...)
-Type "help", "copyright", "credits" or "license" for more information.
->>>
-```
 
-## 첫 번째 파이썬 명령어!
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
 
-파이썬을 실행시키면 프롬프트가 `>>>`로 바뀝니다. 이제부터는 파이썬 언어 명령어만 사용할 수 있다는 뜻이예요. `>>>`를 입력할 필요 없어요. 파이썬이 대신해 줄 테니까요.
+## 나의 첫 번째 파이썬 명령!
 
-파이썬 콘솔에서 나가려면 `exit()`을 입력하거나, 윈도우에서는 `Ctrl + Z`를, 맥이나 리눅스에서는 `Ctrl + D`를 입력하면 됩니다. 그러면 `>>>` 는 사라질 거에요.
+파이썬을 실행시키고 나면 프롬프트가 `>>>`로 바뀝니다. 이제부터는 파이썬 언어의 명령어들만 사용할 수 있다는 뜻이예요. You don't have to type in `>>>` – Python will do that for you.
 
-물론 지금 파이썬 콘솔을 종료할 필요가 없답니다. 아직 파이썬 콘솔에 대해 좀 더 배워야 하니까요. 아주 간단한 사칙연산부터 해봅시다. `2 + 3`을 입력하고 `엔터`를 쳐보세요.
+파이썬 콘솔에서 나가려면 `exit()` 을 입력하거나 윈도우에서는 `Ctrl + Z` 를 맥이나 리눅스에서는 `Ctrl + D`를 입력하면 됩니다. 그러면 `>>>` 는 사라질 거에요.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> 2 + 3
+>>> 2 + 3 
 5
 ```
 
-잘했어요! 값이 출력되었나요? 파이썬은 수학을 할 줄 알아요. 다른 사칙연산도 입력해보세요.
+잘했어요! 결과값이 어떻게 나왔나요? 파이썬은 수학을 알고 있어요! 다른 명령어를 넣어봅시다:
 
 - `4 * 5`
 - `5 - 1`
 - `40 / 2`
 
-2의 3승과 같이 지수 계산을 위해서는 아래와 같이 입력하세요.
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
 
-{% filename %}command-line{% endfilename %}
 ```python
 >>> 2 ** 3
 8
 ```
 
-조금 놀아보고 다시 여기로 돌아와주세요. :)
+조금 놀아봤다면 다시 여기로 돌아와주세요. :)
 
-이처럼 파이썬은 훌륭한 계산기랍니다. 이외에도 할 수 있는 것들이 많아요!
+As you can see, Python is a great calculator. If you're wondering what else you can do…
 
 ## 문자열(String)
 
-이름을 써봅시다. 따옴표(")를 양쪽에 감싸서 입력해보세요.
+이름도 다룰 수 있을까요? 따옴표로 이름을 감싸서 입력해보세요.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> "Ola"
+>>> "Ola" 
 'Ola'
 ```
 
-처음으로 문자열을 만들었군요! 문자열은 컴퓨터가 처리할 수 있는 연속된 문자를 말해요. 문자열은 반드시 시작과 끝이 문자여야 하고, 양쪽을 작은따옴표(`'`) 나 큰따옴표(`"`)로 감싸야 해요. (차이점은 없어요) 이 따옴표는 파이썬에게 안에 문자열이 들어있다고 알려줍니다.
+처음으로 문자열을 만들었군요! 문자열은 컴퓨터가 처리할 수 있는 연속된 문자들을 말해요. 문자열은 반드시 시작과 끝이 같은 문자여야해요. 문자열은 작은 따옴표(`'`) 나 큰 따옴표(`"`) 로 감싸야 해요. (둘 간의 차이점은 없어요. 단지 하나로 감싸나 둘로 감싸나 차이일 뿐이에요.) 이 따옴표는 파이썬에게 안에 문자열이리 들어있다고 알려줍니다.
 
-문자열은 줄줄이 사탕처럼 연결될 수 있어요. 이렇게요.
+문자열들은 줄줄이 사탕처럼 연결할 수 있어요. 이렇게요:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> "Hi there " + "Ola"
+>>> "Hi there " + "Ola" 
 'Hi there Ola'
 ```
 
-문자열과 숫자를 함께 곱할 수도 있어요.
+문자열이랑 숫자를 곱할 수도 있어요.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> "Ola" * 3
+>>> "Ola" * 3 
 'OlaOlaOla'
 ```
 
-문자열 안에 작은따옴표를 넣고 싶다면, 두 가지 방법이 있어요.
+문자열 안에 작은 따옴표를 넣고 싶다면, 두 가지 방법이 있어요.
 
-큰따옴표("")를 사용하는 방법과
+큰 따옴표를 사용하는 방법과
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> "Runnin' down the hill"
+>>> "Runnin' down the hill" 
 "Runnin' down the hill"
 ```
 
-백슬래시(`\`)를 이용하는 방법이예요.
+백슬래시 (``) 기호를 이용하는 방법이예요.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> 'Runnin\' down the hill'
+>>> 'Runnin\' down the hill' 
 "Runnin' down the hill"
 ```
 
+알겠나요? 이제 이름을 대문자로 만들어볼까요:
+
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Ola".upper()
 'OLA'
 ```
 
-방금 문자열에 `upper`이라는 __메소드(method)__를 사용했어요! 메소드는(`upper()`같은 것)는 파이썬이 객체(`"Ola"`같은)를 대상으로 수행할 수 있는 일련의 명령을 말해요.
- 
-총 글자 수를 알고 싶을 때, `len()` __함수(function)__을 사용해요.
+방금 문자열에 `upper`이라는 **함수(function)**를 사용했어요! 함수 (`upper()` 같은 것)란 파이썬이 주어진 대상(`"Ola"`같은)에 대해 수행할 수 있는 일련의 명령을 말해요.
+
+내 이름의 총 글자의 수를 알고 싶을 때, 사용하는 **함수**도 있어요.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> len("Ola")
+>>> len("Ola") 
 3
 ```
 
-왜 어떤 함수는 문자열 뒤에 `.`를 붙이고, (`"Ola".upper()`처럼), 또 어떤 함수는 뒤에 문자열이 들어간 괄호(`len("Ola")처럼`)를 붙이는지 궁금하셨죠? ` upper()`같은 함수는 문자열만 쓸 수 있는 함수로, **메서드(method)**라고 합니다. 반면에 `len()`과 같은 함수는 문자열이나 숫자 등 여러 객체를 사용할 수 있어요. 그래서 `len()`함수에 `"Ola"`를 매개변수(parameter)로 준 거예요.
+함수 호출 시, 어떤 함수는 문자열 뒤에 `.`를 붙이고, (`"Ola".upper()` 처럼), 또 어떤 함수는 함수 뒤에 문자열이 들어간 괄호를 붙이는지 궁금하셨죠? `upper()`와 같은 함수는 객체에 속하게 되어 해당 문자열에서만 수행되기 때문이죠. 이와 같은 경우, 함수를 **메서드(method)**라고 합니다. 그리고, `len()`과 같은 함수들은 특정한 대상에 속하지 않고 여러가지 객체를 대상으로 사용할 수 있습니다. 그래서 `len` 함수에 `"Ola"`를 매개 변수(parameter) 로 준 거예요.
 
-### 요약하기
+### 목차
 
-자, 문자열은 충분히 다루었어요. 지금까지 우리가 공부한 내용을 정리해봅시다.
+자, 문자열은 충분히 다루었어요. 지금까지 우리가 공부한 것들을 정리해봅시다:
 
-*   **프롬프트(the prompt)** - 명령어(코드)를 파이썬 프롬프트에 입력하면 파이썬이 응답합니다.
-*   **숫자와 문자열(numbers and strings)** - 사칙연산을 할 때는 숫자를 사용하고 글을 다룰 때는 문자열을 사용합니다.
-*   **연산자(operators)** - `+` 나 `*`같은 연산자를 사용합니다.
-*   **함수(functions)** - 객체에 `upper()`나 `len()`처럼 명령을 수행합니다.
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
 
-지금까지 가장 기본적인 프로그래밍 문법을 살펴보았어요. 더 어려운 부분으로 넘어가도 괜찮겠죠?
+지금까지 프로그래밍 언어의 기초에 대해 알아보았어요. 더 어려운 부분으로 넘어가도 괜찮겠죠? 그럼요!
 
 ## 오류
 
-새로운 것을 배워봅시다. 총 글자 수도 알아냈듯이 숫자 수도 알 수 있을까요? `len(304023)`을 입력하고 `엔터`를 입력하세요.
+이제 새로운 것을 해볼 때에요. 이름의 글자 길이를 알아냈듯이 숫자의 길이도 알 수 있을까요? `len(304023)` 을 입력하고 `엔터`를 입력해보세요:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(304023)
 Traceback (most recent call last):
@@ -142,62 +151,68 @@ Traceback (most recent call last):
 TypeError: object of type 'int' has no len()
 ```
 
-첫 번째 에러가 나타났어요! "int"(정수)객체는 길이가 없기 때문이지요. 이제 어떻게 할 수 있을까요? 숫자(number)를 문자열(String)로 바꿔 쓸 수 있지 않을까요? 문자열은 길이를 갖고 있으니까요, 그렇죠?
+첫 번째 에러가 나타났어요! "int" (정수) 형식의 객체는 길이가 없기 때문이지요. 이제 어떻게 할 수 있을까요? 숫자(number) 를 문자열(String) 로 바꿔 쓸 수 있지 않을까요? 문자열은 길이를 갖고 있으니까요, 그렇죠?
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(str(304023))
 6
 ```
 
-잘 되네요! 앞에서 우리는 `len()`함수 내부에 `str()`함수를 사용했어요. `str()`함수는 모든 대상을 문자열로 변환한답니다.
+잘 되네요! 앞에서 우리는`len` 함수 내부에 `str` 함수를 사용했어요. `str` 함수는 모든 것을 문자열로 변환한답니다.
 
-*   `str()`함수는 대상을 **문자열**로 변환합니다
-*   `int()`함수는 대상을 **정수**로 변환합니다.
+- `str`함수는 대상을 **문자열**로 변환합니다
+- `int` 함수는 대상을 **정수**로 변환합니다.
 
-> 중요 : 숫자는 텍스트로 변환되지만, 반대로 텍스트는 숫자로 변환될 수 없습니다. - 그렇다면 `int('hello')`는 가능할까요?
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
 
 ## 변수
 
-변수는 프로그래밍에서 중요한 개념입니다. 변수란 여러 번 사용될 수 있게 이름을 붙인 거랍니다. 작성한 코드를 다 기억할 필요없이 코드를 읽기 쉽게 하기 위해 사용하지요. 프로그래머들은 변수를 사용해 데이터를 저장합니다.
+변수는 프로그래밍에서 중요한 개념입니다. 변수란 어떤 것을 나중에도 사용할 수 있도록 이름을 붙인 것일 뿐 입니다. 프로그래머들은 이 변수를 데이터 저장하는데 사용하고, 작성한 코드를 다 기억할 필요없이 코드를 읽기 쉽게 하기 위해 사용하지요.
 
-`name`이라는 새로운 변수를 만들어 보세요.
+`name`이라는 새로운 변수를 만들어봅시다:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> name = "Ola"
 ```
 
-봤죠? 간단해요. 매우 쉬어요! "이름은 올라와 같다"라고 쓰는 거에요.
+We type name equals Ola.
 
-여러분도 알겠지만, 프로그램은 이전에 수행한 내용을 보여주지 않아요. 그렇다면 변수값을 알려면 어떻게 해야할까요? `name`를 입력하고 `엔터`를 입력하세요.
+여러분도 알겠지만, 프로그램은 이전에 수행한 것을 보여주지 않습니다. 그러면 실제 변수에 어떤 값이 들어있는지 알려면 어떻게 해야할까요? 간단하게 `name`를 입력하고 `엔터`를 입력하세요:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> name
 'Ola'
 ```
 
-야호! `name`은 여러분이 만든 첫 변수랍니다! :) 언제든지 변수값을 바꿀 수 있어요.
+Yippee! Your first variable! :) You can always change what it refers to:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> name = "Sonja"
 >>> name
 'Sonja'
 ```
 
-또 함수 안에 변수명을 사용할 수 있습니다.
+또 함수 안에서 변수를 사용할 수 있습니다:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(name)
 5
 ```
 
-멋지죠? 물론 변수는 무엇이든지 담을 수 있으니, 당연히 숫자도 가능하죠! 해봅시다. :
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> a = 4
 >>> b = 6
@@ -205,9 +220,10 @@ TypeError: object of type 'int' has no len()
 24
 ```
 
-그런데 만약 잘못된 변수명을 입력하면 어떻게 나올까요?
+그런데 만약 잘못된 이름을 사용했다면 어떻게 될까요? 어떤 일이 일어날까요? 해봅시다!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> city = "Tokyo"
 >>> ctiy
@@ -216,16 +232,16 @@ Traceback (most recent call last):
 NameError: name 'ctiy' is not defined
 ```
 
-에러가 나타났네요! 보다시피, 파이썬에는 많은 종류의 오류들이 있습니다. **NameError**는 그 중 하나입니다. 파이썬은 아직 정의하지 않은 변수를 사용하면 이 오류를 보여줍니다. 나중에도 **NameError**라는 오류를 보게 된다면, 이름에 오타가 있는지 확인해야겠죠.
-
-조금 더 변수와 놀아봅시다. 그리고 어떤 것들을 할 수 있는지 살펴보아요!
+에러가 나타났네요! 보다시피, 파이썬에는 많은 종류의 오류들이 있습니다. 그 중 하나가 **NameError**입니다. 파이썬은 아직 정의하지 않은 변수를 사용하면 이 오류를 보여줍니다. 나중에 똑같은 오류를 보게 된다면, 이름에 오타가 없는지 확인해보세요.
 
+잠시동안 변수와 놀아봅시다. 그리고 어떤 것들을 할 수 있는지 살펴보아요!
 
-## print() 함수
+## print 함수
 
-아래와 코드를 따라 입력해보세요. :
+해봅시다:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> name = 'Maria'
 >>> name
@@ -234,76 +250,83 @@ NameError: name 'ctiy' is not defined
 Maria
 ```
 
-`name`을 쳤을 때, 파이썬 해석기는 'name' 변수의 문자열 *표현(representatio)*으로 응답하는데, 그 모양은 작은따옴표('')로 둘러싸인 M-a-r-i-a 문자입니다. `print(name)`라고 치면, 파이썬은 화면에 따옴표없이 더 깔끔한 화면을 보여(`print`)줍니다.
-
-나중에 차차 알게 될 거지만, `print()`는 함수 안에 있는 내용을 출력할 때, 여러 내용들을 확인하고 싶을 때 유용하게 사용됩니다.
+`name`을 쳤을 때, 파이썬 해석기는 'name' 변수의 문자열 *표현(representatio)*으로 응답하는데, 그 모양은 작은 따옴표('') 로 둘러싸인 M-a-r-i-a 문자들 입니다. `print(name)`라고 치면, 파이썬은 화면에 따옴표 없이 더 깔끔한 변수를 "출력(print)"할 것입니다.
 
+나중에 보겠지만, `print()`는 함수 안에 있는 어떤 것을 출력하거나, 이를 여러 줄로 출력할 때 유용하게 사용됩니다.
 
-## 리스트(List)
+## 리스트 (List)
 
-문자열과 정수 외에도 객체를 정렬할 수 있는 여러 방법들이 있습니다. **리스트**라고 불리는 아이에 대해 알아봅시다. 리스트란 서로 다른 객체들을 일렬로 나열한 것이라고 생각하시면 됩니다.
+문자열과 정수 외에, 파이썬은 객체 정렬 위한 여러 방법들이 있어요. 이제 **리스트**라고 불리는 녀석에 대해서 알아보기로 하겠습니다. 리스트를 이렇게 생각하시면 됩니다: 다른 객체들을 나열한 객체. :)
 
-아래와 같이 리스트를 만듭시다. :
+이제 리스트를 만듭시다:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> []
 []
 ```
 
-리스트가 비어있네요. 별로 유용해 보이지 않죠? 이제 로또 번호 목록을 만들어 봅시다. 매번 직접 우리가 반복하기는 귀찮으니, 리스트에 변수를 넣어봅시다.
+네, 리스트가 비어있어요. 별로 유용해 보이지 않죠? 이제 로또 번호 목록을 만들어 봅시다. 매번 직접 우리가 반복하기는 귀찮으니, 리스트에 변수를 넣어봅시다:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery = [3, 42, 12, 19, 30, 59]
 ```
 
-좋아요, 리스트를 만들었어요! 이제 무엇을 할 수 있을까요? 리스트 안에 들어간 로또 번호는 몇 개인지 알려면 어떻게 해야할까요? `len()`함수를 사용할 수 있겠죠? 이미 앞에서 해봤어요!
+좋아요, 리스트를 만들었네요! 어떻게 쓰면 될까요? 목록에 수 많은 로또 번호가 있다고 생각해봅시다. 함수를 사용할 수 있는 아이디어가 떠올랐나요? 여러분들은 이미 앞에서 해봤어요!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(lottery)
 6
 ```
 
-네! `len()`함수는 리스트 안에 있는 객체의 수를 알려줍니다. 유용하죠? 이제 정렬을 해봅시다.
+네! `len()` 함수는 리스트 안에 있는 객체의 수를 알려줍니다. 편리하지 않나요? 이제 정렬을 해봅시다:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery.sort()
 ```
 
-숫자를 오름차순으로 정렬했지만 출력값이 보이지 않네요. 어떻게 변했는지 리스트를 출력해 확인해봅시다. :
+아무것도 보여주지 않네요. 이 함수는 리스트 안의 숫자들을 오름차순으로 정렬합니다. 어떻게 변했는지 리스트를 출력해봅시다:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(lottery)
 [3, 12, 19, 30, 42, 59]
 ```
 
-리스트 안에 있는 숫자들은 오름차순으로 정렬되었어요. 잘했습니다!
+위에 나왔듯이, 리스트 안에 있는 숫자들은 오름차순으로 정렬되었습니다. 축하합니다!
 
-이번에는 내림차순으로 정렬해볼까요?
+만약 반대로 내림차순으로 정렬하고 싶다면요? 하면 됩니다!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery.reverse()
 >>> print(lottery)
 [59, 42, 30, 19, 12, 3]
 ```
 
-참 쉽죠? 여러분이 리스트에 새로운 값을 추가하고 싶다면 이렇게 해보세요. :
+If you want to add something to your list, you can do this by typing this command:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery.append(199)
 >>> print(lottery)
 [59, 42, 30, 19, 12, 3, 199]
 ```
 
-첫 번째 숫자 하나만 보여주고 싶다면, **인덱스(indexes)**를 사용하세요. 인덱스는 리스트 내 아이템 위치를 나타내는 숫자입니다. 프로그래머는 0부터 세는 것을 선호합니다. 따라서 리스트에 있는 첫 번째 객체는 인덱스 0부터 시작하고, 그 다음은 1, 그 다음은 2.. 순번대로 번호를 매길 수 있습니다. `.[index숫자]`를 입력해볼까요.
+만약 첫 번째 숫자 하나만 보여주고 싶다면, **인덱스(index)**를 사용하세요. 인덱스는 리스트 안의 아이템 위치를 나타내는 숫자입니다. 프로그래머는 0부터 세는 것을 선호합니다. 따라서 리스트에 있는 첫 번째 객체는 인덱스 0부터 시작하고, 그 다음은 1, 그 다음은 2.. 가 됩니다. 해봅시다:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(lottery[0])
 59
@@ -311,11 +334,12 @@ Maria
 42
 ```
 
-이렇게 리스트 이름과 대괄호`([])`안 객체의 인덱스를 사용해서, 리스트 안에 있는 다른 객체로도 접근이 가능합니다.
+리스트의 이름이나 대괄호 안에 들어가는 객체의 인덱스를 사용해서, 리스트 안에 있는 다른 객체로도 접근이 가능합니다.
 
-리스트 내 아이템을 지우려면 인덱스와 함께 `pop()`메소드를 사용하면 됩니다. 아래 예제 코드를 따라하면서 배운 내용을 다시 기억해봅시다. 리스트에 맨 처음 있는 객체를 삭제해봅시다.
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(lottery)
 [59, 42, 30, 19, 12, 3, 199]
@@ -327,19 +351,20 @@ Maria
 [42, 30, 19, 12, 3, 199]
 ```
 
-마법 같지 않나요!
+마법같네요!
 
-재미로 몇 번 더 여러 인덱스를 테스트해보세요: 6, 7, 1000, -1, -6, -1000 등이요. 결과값을 보기 전에 미리 정답을 유추해보세요. 생각했던 정답이 나왔나요?
+재미로 몇 번 더 여러 인덱스를 테스트해보세요: 6, 7, 1000, -1, -6, -1000 등이요. 결과값을 보기 전에 미리 어떤 값이 나올지 예상할 수 있었나요? 생각했던 정답이 나왔나요?
 
-이번 장에서 배운 리스트 메서드와 관련된 모든 내용은 파이썬 공식 문서에서 있습니다. :https://docs.python.org/3/tutorial/datastructures.html
+이번 장에 나온 리스트 메서드와 관련된 모든 내용은 파이썬 공식 문서에서 찾을 수 있습니다. : https://docs.python.org/3/tutorial/datastructures.html
 
 ## 딕셔너리(Dictionary)
 
-> 집에서 학습하시는 분들은 [파이썬 기초: 딕셔너리(Dictionaries)](https://www.youtube.com/watch?v=ZX1CVvZLE6c) 영상을 보세요.
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
 
-딕셔너리는 리스트와 유사하지만, 인덱스가 아닌 키(key)로 값을 찾습니다. 키는 문자열이든, 숫자든지 상관없습니다. 빈 딕셔너리를 만드는 문법은 아래와 같습니다.
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> {}
 {}
@@ -347,33 +372,35 @@ Maria
 
 방금 비어있는 딕셔너리를 하나 만들었답니다. 만세!
 
-자, 이제 아래 명령어를 따라 작성해 봅시다. (딕셔너리 안에 있는 값은 마음대로 수정해도 됩니다)
+Now, try writing the following command (try substituting your own information, too):
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
 ```
 
+With this command, you just created a variable named `participant` with three key–value pairs:
 
-위 명령어로 `paticipant`라는 새 변수를 만들었습니다. 이 변수 안에는 3개의 키-값 쌍이 들어있어요.
-
-*   키(key) 는 `name`이고, 값(value) 는 `'Ola'`를 가리킵니다. (`string`입니다)
-*   키 `country`의 값은 `'Poland'`입니다. (또 다른 `string`입니다)
-*   그리고 키 `favorite_numbers`는 `[7, 42, 92]`를 가리킵니다. (`list`에 숫자 세 개가 있습니다)
+- 키(key) 는 `name`이고, 값(value) 는 `'Ola'`를 가리킵니다. (`string(문자열)` 객체이지요.),
+- 키 `country`의 값은 `'Poland'`입니다. (또 다른 `string`입니다),
+- 그리고 키 `favorite_numbers`는 `[7, 42, 92]`를 가리킵니다. (`리스트`에는 세 개의 숫자가 있습니다.)
 
-아래와 같은 문법으로 개별 키의 값에 접근할 수 있습니다.
+여러분은 아래와 같은 문법으로 개별 키의 값에 접근할 수 있습니다.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(participant['name'])
 Ola
 ```
 
-리스트와 조금 비슷해보이지만 인덱스가 아닌, 이름을 사용해 값을 찾는다는 것을 기억하세요.
+See, it's similar to a list. But you don't need to remember the index – just the name.
 
-만약 파이썬에 키(key)에 대응하는 값이 없다면 어떻게 될까요? 그럼 테스트 해봅시다!
+만약 파이썬에 키에 대응하는 값이 없는 경우에는 어떻게 될까요? 예측할 수 있나요? 그럼 한 번 알아봅시다!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> participant['age']
 Traceback (most recent call last):
@@ -381,33 +408,36 @@ Traceback (most recent call last):
 KeyError: 'age'
 ```
 
-보세요, **KeyError**에러가 났습니다. 파이썬은 친절하게 `'age'`키가 딕셔너리에 존재하지 않는다고 알려주네요.
+보세요, 에러가 났네요! 이번에는 **KeyError**에러가 났습니다. 파이썬은 친절하게 키 `'age'`가 딕셔너리에 존재하지 않는다고 알려주네요.
 
 그렇다면 언제 딕셔너리를 쓰고, 언제 리스트를 사용해야할까요? 이를 위한 판단 기준은 다음과 같습니다.
 
-*   리스트 : 아이템 정렬이 필요할 때
-*   딕셔너리 : 키(key)과 값(value)이 서로 연관되어 있거나, 효과적으로 (키를 사용해서) 어떤 값을 찾을 때
+- 아이템을 나열할 때 정렬이 필요하나요? 그렇다면 리스트를 사용하세요.
+- 키(key) 과 값(value) 이 서로 연관되어 있어야 하나요? 또는 보다 효과적으로 (키를 사용해서) 어떤 값을 찾아야 하나요? 그렇다면, 딕셔너리를 사용하세요.
 
-딕셔너리는 리스트와 유사하지만, *변경(mutable)*할 수 있습니다. 딕셔너리가 만들어진 후에도, 그 값을 마음대로 변경할 수 있다는 뜻이지요. 키/값을 나중에 추가할 수 있답니다.
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
 
- {% filename %}command-line{% endfilename %}
 ```python
 >>> participant['favorite_language'] = 'Python'
 ```
 
-리스트처럼 딕셔너리도 `len()`메서드를 사용하여 키-값 쌍의 수를 리턴합니다. 한 번 커맨드라인에서 확인합시다.
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(participant)
 4
 ```
 
-다들 이해를 잘 하고 있으리라 믿어요 :) 딕셔너리로 좀 더 재미있는 것을 해볼까요?
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
 
-`pop()`메소드로 딕셔너리에 있는 아이템을 삭제해봅시다. 아래 예제를 따라서 `'favorite_numbers'` 키를 삭제해봅시다.
+You can use the `pop()` method to delete an item in the dictionary. `'favorite_numbers'` 키를 삭제하고 싶으면, 아래와 같은 명령어를 입력하면 됩니다. :
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> participant.pop('favorite_numbers')
 [7, 42, 92]
@@ -415,37 +445,39 @@ KeyError: 'age'
 {'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
 ```
 
-'favorite_numbers' 에 해당하는 키-값 쌍이 삭제되었네요.
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
 
-키에 해당하는 값도 변경할 수 있습니다. 이렇게 해보세요. :
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> participant['country'] = 'Germany'
 >>> participant
 {'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
 ```
 
-`'country'` 키에 해당하는 값이 `'Poland'`에서 `'Germany'`로 변경되었네요. :) 재미있죠? 야호! 또 굉장한 것을 배웠네요.
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
 
-### 요약
+### 목차
 
-훌륭하네요! 이제 모두가 프로그래밍에 대해서 많은 것을 알게 되었어요. 지금까지 우리가 배운 내용을 정리해볼까요.
+훌륭하네요! 이제 모두가 프로그래밍에 대해서 많은 것을 알게 되었어요. 지금까지 우리가 배운 내용은 다음과 같아요. :
 
-*   **에러** - 파이썬이 작성된 명령어를 이해하지 못할 때 에러가 발생합니다.
-*   **변수** - 객체에 적절한 이름을 붙여 코드를 가독성 좋게 작성할 수 있습니다.
-*   **리스트** - 특정한 순서로 정렬된 객체들이 저장된 목록입니다.
-*   **딕셔너리** - 키(key)-값(value) 쌍으로 이루어진 객체들이 저장됩니다.
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
 
 다음 내용이 기대되나요? :)
 
 ## 비교하기
 
-> 집에서 학습하시는 분들은 [파이썬 기초: 비교연산자(Comparisons)](https://www.youtube.com/watch?v=ZX1CVvZLE6c) 영상을 보세요.
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
 
-비교는 프로그래밍에서 매우 중요한 부분이에요. 비교를 할 때, 제일 쉬운 방법은 무엇일까요? 바로 숫자입니다. 어떻게 하는지 알아볼게요. :
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 5 > 2
 True
@@ -459,13 +491,14 @@ True
 True
 ```
 
-파이썬이 두 숫자를 비교했네요. 파이썬은 메서드 결과도 비교 가능합니다. 멋지죠?
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
 
-두 숫자를 비교할 때 왜 등호 부호 `==`를 사용하는지 궁금했죠? 변수에 값을 넣을 때 등호 기호`=` 하나만 사용했기 때문에, 두 대상이 같은지 서로 비교하기 위해서는 **항상** 두 개의 등호 기호 `==`를 사용해야 합니다. 마찬가지로 서로 다른 대상일 경우에는 `!=` 기호를 사용합니다.
+두 숫자를 비교할 때 왜 등호 부호 `==`를 사용하는지 궁금했죠? 우리는 변수에 값을 넣을 때 한 개의 등호 기호 `=`를 사용하죠. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. 마찬가지로 두 대상이 서로 같지 않다라고 말할 수 있습니다. 위 예제에서 볼 수 있었듯이 서로 같은 대상이 아닐 때는 `!=` 기호를 사용합니다.
 
-두 번 더 테스트 해볼게요. :
+두 번 더 테스트 해볼게요.:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 6 >= 12 / 2
 True
@@ -473,17 +506,17 @@ True
 False
 ```
 
-
-`>`와 `<`는 알겠는데, 그렇다면 `>=`와 `<=`는 무슨 뜻일까요? 아래 내용을 읽어보세요. :
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
 
 - x `>` y : x는 y보다 크다
 - x `<` : x는 y보다 작다
 - x `<=` : x가 y보다 작거나 같다
 - x `>=` : x가 y보다 크거나 같다
 
-잘했어요! 좀 더 해볼까요?
+잘했어요! 좀 더 해볼까요? 이런 건 어떨까요. :
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 6 > 2 and 2 < 3
 True
@@ -493,191 +526,220 @@ False
 True
 ```
 
-파이썬은 얼마든지 원하는 만큼 숫자를 비교할 수 있고 답을 알려줄 거랍니다! 똑똑한 녀석이죠?
+파이썬은 얼마든지 원하는 만큼 숫자를 비교할 수 있고 답을 알려줄 거에요! 똑똑한 녀석이죠?
 
-- **and** - `and` 연산자는, 두 값 모두 참(`True`)일 경우에만 결과가 참(`True`)이 됩니다.
-- **or** - `or` 연산자는, 둘 중 하나만 참(`True`)일 경우에 결과가 참(`True`)이 됩니다.
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
 
-"사과를 오렌지에 비교하기"라는 말을 들어본 적이 있나요? 파이썬에게 시켜봅시다.
+"사과를 오렌지에 비교하기"라는 말을 들어본 적이 있나요? 파이썬에게 시켜봅시다. :
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 1 > 'django'
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
-TypeError: unorderable types: int() > str()
+TypeError: '>' not supported between instances of 'int' and 'str'
 ```
 
-이처럼 파이썬은 숫자(`int`)와 문자열(`str`)을 비교할 수 없어요. 대신 **TypeError**를 보여줘 두 타입이 서로 비교 대상이 아니라는 것을 알려줍니다.
+이처럼 파이썬은 숫자(`int`) 와 문자열(`str`) 을 비교할 수 없어요. 비교는 못하지만 대신 **TypeError**를 보여줘 두 타입이 서로 비교 대상이 아니라는 것을 알려줍니다.
+
+## Boolean (불리언)
 
-## Boolean(불리언)
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
 
-방금 전 파이썬의 새로운 객체 종류를 배웠는데요. 바로 **Boolean**입니다. 이번 장에서 가장 쉬운 내용이에요.
+There are only two Boolean objects:
 
-불리언의 객체 두가지 입니다.
-- True(참)
-- False(거짓)
+- True
+- False
 
-파이썬은 항상`True`라고 써야 이해합니다. 첫 글자가 대문자고 나머지는 소문자여야만, Boolean으로 이해합니다. **true, TRUE, tRUE는 모두 틀린 표현이에요. -- `True`만 올바른 표현입니다.** (`False`도 마찬가지입니다)
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
 
-불리언을 변수로 사용할 수도 있습니다! 아래 코드를 실행해보세요.
+Boolean도 변수로 사용할 수도 있습니다! 다음을 보세요:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> a = True
 >>> a
 True
 ```
 
-또 이런 방법으로도 쓸 수 있습니다.
+이런 식으로도 쓸 수 있습니다.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> a = 2 > 5
 >>> a
 False
 ```
 
-아래 명령어를 실행해보면서 불리언을 가지고 놀아보세요.
+아래 명령어를 실행해보면서 Boolean을 가지고 놀아보세요. :
 
 - `True and True`
 - `False and True`
 - `True or 1 == 1`
 - `1 != 2`
 
-축하합니다! 불리언은 프로그래밍에 있어서 가장 멋진 기능 중 하나에요. 여러분은 불리언을 앞으로 어떻게 사용해야 하는지 방금 배웠답니다!
+축하합니다! Boolean은 프로그래밍에 있어서 가장 멋진 기능 중 하나에요. 여러분은 Boolean을 앞으로 어떻게 사용해야 하는지 방금 배웠답니다!
 
 # 코드 저장하기!
 
-> **Note** 집에서 학습하는 분들은 [파이썬 기초: 파일 저장 및 "If" 조건문](https://www.youtube.com/watch?v=dOAg6QVAxyk) 영상을 보세요.
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
 
+지금까지 우리는 인터프리터(interpreter) 에서 파이썬 코드를 입력해 왔어요. 한 번에 코드 한 줄만 입력할 수 있었어요. 일반적으로 프로그램은 파일로 저장되어 프로그래밍 언어 **인터프리터(interpreter)** 또는 **컴파일러(complier)**로 실행됩니다. 지금까지 우리는 파이썬 **인터프리터**에서 한 줄씩 코드를 입력해 프로그램을 실행시켰어요. 이제 앞으로는 한 줄 이상 더 많은 코드를 작성해 실행해 볼 거에요. 빨리 해볼게요. :
 
-지금까지 우리는 인터프리터(interpreter)에서 파이썬 코드를 입력해 왔어요. 한 번에 코드 한 줄만 입력할 수 있었어요. 일반적으로 프로그램은 파일로 저장되어 프로그래밍 언어 **인터프리터(interpreter)** 또는 **컴파일러(complier)**로 실행됩니다. 지금까지 우리는 파이썬 **인터프리터**에서 한 줄씩 코드를 입력해 프로그램을 실행시켰어요. 이제 앞으로는 한 줄 이상 더 많은 코드를 작성해 실행해 볼 거에요. 빨리 해볼게요.
+- 파이썬 인터프리터를 종료하세요.
+- 선택한 코드 에디터를 실행하세요.
+- 코드를 새 파이썬 파일로 저장하세요.
+- 실행하세요!
 
-*   파이썬 인터프리터를 종료하세요.
-*   선택한 코드 에디터를 실행하세요.
-*   코드를 새 파이썬 파일로 저장하세요.
-*   실행하세요!
-
-사용했던 파이썬 인터프리터를 종료하려면, `exit()`함수를 입력하세요.
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> exit()
 $
 ```
 
-그러면 커맨드 프롬프트(또는 콘솔)가 초기화됩니다.
+그러면 커맨드 프롬프트(또는 콘솔창) 가 초기화 됩니다.
 
-앞서 우리는 [코드 에디터](../code_editor/README.md) 장에서 사용할 에디터를 정했습니다. 이제 에디터를 실행해 코드를 작성하고 새 파일로 저장합니다.
+앞서 우리는 [코드 편집기](../code_editor/README.md) 섹션에서 어떤 코드 편집기를 사용할지 정했었습니다. 이제 편집기를 실행해서 새 코드를 작성하여 새 파일로 저장합니다:
 
 {% filename %}editor{% endfilename %}
+
 ```python
 print('Hello, Django girls!')
 ```
 
-당연히 여러분은 숙련된 파이썬 개발자에요. 지금 배운 코드를 자유롭게 작성해보세요.
-
-이제 파일명과 함께 저장해야합니다. 파일명을 ** python_intro.py **이라고 붙이고 데스크탑에 저장해 봅시다. 파일명은 마음대로 써도 되지만 파일 확장자는 __.py__ 로 끝나야합니다. **.py**파일 확장자로 운영체제에게 **파이썬 실행 파일**이니 파이썬을 실행하라고 지시합니다.
+오늘 우리 모두가 파이썬 개발자가 되었답니다. 그러니 오늘 배운 코드를 가지고 놀아보세요.
 
+이제 파일을 저장하고 파일 이름을 바꾸세요. 바탕화면에 **python_intro.py** 파일로 저장하세요. 원하는 파일이름으로 저장할 수 있지만, 파일 이름이 반드시 **.py**로 끝나야 해요. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
 
-> **Note** 코드 에디터의 멋진 기능을 알고 있어야 해요. 파이썬 콘솔에서는 모든 코드가 같은 색이였지만, 코드 에디터에는 `print()`함수와 문자열이 다른 색상으로 구분되었어요. 이를 `문법 하이라이팅(syntax highlighting)`하는데, 코딩할 때 필요한 기능입니다. 색상로 구분을 파악할 수 있고 오류도 확인할 수 있어요. 예를 들어, 문자열이 제대로 닫히지 않았다던가, 특정 키워드(함수에서 사용하는 `def`)를 사용할 때, 다른 색상으로 구분되기 때문에 쉽게 파악이 가능합니다. 그래서 코드 에디터를 사용하는 거랍니다. :)
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. 이를 "문법 하이라이팅(syntax highlighting)" 하는데, 코딩할 때 필요한 기능이죠. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). 그래서 우리는 코드 에디터를 사용한답니다. :)
 
-파일을 저장했다면, 커맨드라인 장에서 배웠던 것을 써먹어야죠! 터미널에서 데스크탑(또는 Desktop, 바탕화면)으로 **디렉토리 변경**을 해보세요.
+파일을 저장했다면, 커맨드라인 장에서 배웠던 것을 써먹어야죠! 터미널에서 데스크탑으로 **디렉토리 변경**을 해보세요.
 
-<!--sec data-title="OS X" data-id="python_OSX"
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
 data-collapse=true ces-->
 
-맥OS :
+맥이라면 명령어는 다음과 같을 것입니다:
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd ~/Desktop
-```
+
+    $ cd ~/Desktop
+    
+
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="python_linux"
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
 data-collapse=true ces-->
 
-리눅스 :
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
 {% filename %}command-line{% endfilename %}
-```
-$ cd ~/Desktop
-```
+
+    $ cd ~/Desktop
+    
 
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="python_windows" data-collapse=true ces-->
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
 
-윈도우 :
+On Windows Command Prompt, it will be like this:
 
 {% filename %}command-line{% endfilename %}
-```
-> cd %HomePath%\Desktop
-```
+
+    > cd %HomePath%\Desktop
+    
+
 <!--endsec-->
 
-따라하다 어려움이 있다면, 코치에게 도움을 요청하세요.
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
 
-파일 내 코드를 실행하기 위해 파이썬을 불러봅시다.
+And on Windows Powershell, it will be like this:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hello, Django girls!
-```
 
-> **Note** 윈도우에서 'python3' 명령어를 인식하지 못하면 'python'라고 입력하세요.
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+혹시 하다가 막히면, 코치에게 도움을 요청하세요.
+
+이제 파일 안에 있는 코드를 실행하기 위해 다음과 같이 파이썬을 실행해 봅시다. :
 
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
 
-잘했어요! 드디어 파이썬 프로그램이 저장된 파일을 실행했어요. 뿌듯하죠?
+```python
+> python python_intro.py
+```
+
+잘했어요! 우리는 첫 파이썬 프로그램이 저장된 파일을 실행했어요. 내가 드디어 해냈다고 느껴지나요?
 
-다음으로 프로그래밍의 필수 도구를 배울 차례에요.
+다음으로 프로그래밍의 필수 도구를 알아볼 차례에요. :
 
-## If...elif...else
+## If … elif … else
 
-대부분의 코드는 조건문을 만났을 때 실행됩니다. 파이썬은 **if**문을 사용합니다.
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
 
-**python_intro.py** 파일을 다음과 같이 수정하세요.
+**python_intro.py** 파일을 다음과 같이 수정하세요:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
 ```
 
-저장하고 실행하면 아래와 같은 에러가 보일 거에요.
+If we were to save and run this, we'd see an error like this:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-File "python_intro.py", line 2
-         ^
-SyntaxError: unexpected EOF while parsing
-```
 
-파이썬은 조건문 `3 > 2`가 참인 경우(또는 값이 `True`인 경우)에 어떻게 할 것인지 물어보네요. 이 경우에 파이썬이 "It works!"를 출력하게 해봅시다. **python_intro.py** 파일을 아래와 같이 수정하세요.
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+파이썬은 조건문 `3 > 2`가 참인 경우(또는 값이 `True`인 경우)에 어떤할 지 물어 보네요. 이 경우에 파이썬이 "It works!"를 출력하게 해봅시다. : **python_intro.py** 파일을 아래와 같이 수정하세요. :
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
     print('It works!')
 ```
 
-두 번째 줄에 들여쓰기 된 코드에 스페이스 4칸을 준 게 보이나요? 조건의 결과(`3 > 2`) 가 참일 경우에, 실행할 코드에 들여쓰기를 해줘야 합니다. 물론 스페이스 한 칸만 띄울 수 있지만, 거의 모든 파이썬 프로그래머들은 코드를 정갈하게 작성하기 위해 4칸을 사용해요. `탭(tab)`한 번은 들여쓰기 4칸과 같습니다.
+두 번째 줄 들여쓰기 된 코드에 스페이스 4칸을 준 게 보이나요? 조건의 결과(여기서는 3>2) 가 참일 경우에, 실행할 코드에 들여쓰기를 해줘야 합니다. 물론 스페이스 한 칸만 띄울 수 있지만, 거의 모든 파이썬 프로그래머들은 코드를 깔끔하게 작성하기 위해 4칸을 사용해요. `탭(tab)` 한 번은 스페이스 4칸을 준 것과 같아요.
 
-이제 저장하고 실행해보세요.
+이제 저장하고 실행해보세요:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 $ python3 python_intro.py
 It works!
 ```
 
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
 ### 조건이 참(True) 이 아니라면 어떻게 되나요?
 
-앞 예제에서 조건이 참(`True`)인 경우에만 실행되게 만들었어요. 하지만 파이썬은 `elif`문과 `else`문도 사용할 수 있습니다.
+앞의 예제에서 코드가 조건이 True인 경우에만 실행되게 만들었어요. 하지만 파이썬은 `elif`문과 `else`문도 사용할 수 있습니다.
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 5 > 2:
     print('5 is indeed greater than 2')
@@ -685,17 +747,18 @@ else:
     print('5 is not greater than 2')
 ```
 
-실행하면 다음과 같이 출력됩니다.
+실행하면 다음과 같이 출력됩니다:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-5 is indeed greater than 2
-```
 
-만약 2가 5보다 크다면 두번째 명령이 실행됩니다. 참 쉽죠? 이제 `elif`가 어떻게 작동하는지 봅시다.
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 name = 'Sonja'
 if name == 'Ola':
@@ -706,19 +769,20 @@ else:
     print('Hey anonymous!')
 ```
 
-그리고 실행해보세요.
+그리고 실행해보세요. :
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hey Sonja!
-```
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
 
 어떻게 됐나요? `elif`문은 맨 처음 조건이 아닐 경우 그 다음 조건을 처리하게 해줍니다.
 
-`if` 문을 쓴 다음에 원하는 만큼 `elif` 문을 계속 추가할 수 있어요. 이렇게요.
+여러분은 `if` 문을 쓴 다음에 원하는 만큼 `elif` 문을 계속 추가할 수 있어요. 이렇게요. :
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 volume = 57
 if volume < 20:
@@ -738,46 +802,50 @@ else:
 파이썬이 각 테스트를 순서대로 실행하고 출력합니다:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Perfect, I can hear all the details
-```
-## 주석(Comments)
 
-주석은 `#`으로 시작하는 줄입니다. 파이썬은 `#`의 내용을 무시합니다. 주석은 코드를 읽는 다른 사람들이 보다 쉽게 이해할 수 있도록 작성합니다.
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
 
-아래 예제를 보세요. :
+Let's see how that looks:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
-# volume 값을 바꿔보세요
+# Change the volume if it's too loud or too quiet
 if volume < 20 or volume > 80:
     volume = 50
     print("That's better!")
 ```
 
-모든 라인마다 주석을 작성할 필요는 없지만, 코드의 역할과 복잡한 수행 내용을 정리 요약할 때 사용됩니다.
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
 
-### 요약
+### 목차
 
-지금까지 배운 내용을 정리해봅시다.
+In the last few exercises you learned about:
 
-- **비교하기** - 파이썬에서 `>`, `>=`, `==`, `<=`, `<` 그리고 `and`, `or` 연산자를 사용해 비교합니다.
-- **불리언(Boolean)** -두 둘 중 하나의 값만 가질 수 있는 객체입니다. `True` 또는 `False`
-- **파일 저장하기** - 복잡한 프로그램을 실행할 수 있도록 코드를 파일로 저장합니다.
-- **`if`...`elif`...`else`** - 조건문을 작성해 특정 조건이 주어졌을 때만 코드가 실행되도록 만듭니다.
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
 
 드디어 이번 장의 마지막 부분입니다!
 
 ## 나만의 함수 만들기!
 
-> **Note** 집에서 학습하는 분들은 [파이썬 기초: 함수](https://www.youtube.com/watch?v=5owr-6suOl0) 영상을 보세요.
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
 
-앞에서 했던 `len()`와 같은 함수를 사용했었죠? 지금부터는 직접 함수를 만드는 법을 배울 거에요!
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
 
-함수는 파이썬이 명령어의 나열이에요. 파이썬의 각 함수는 `def`로 시작하고, 이름을 붙일 수 있고, 여러 매개변수를 가질 수 있어요. 쉬운 것부터 시작할게요. **python_intro.py** 파일을 열어 코드를 다음과 같이 고치세요.
+함수는 파이썬이 실행해야하는 명령어의 나열이에요. 파이썬의 각 함수는 `def`로 시작해, 이름을 가지고, 몇 가지 매개 변수를 가집니다. Let's give it a go. **python_intro.py**파일을 열어 코드를 다음과 같이 고치세요. :
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi():
     print('Hi there!')
@@ -786,33 +854,37 @@ def hi():
 hi()
 ```
 
-우리가 만든 첫 번째 함수네요!
+네, 우리가 만든 첫 번째 함수네요!
 
-파일 맨 밑에 왜 함수의 이름을 적었는지 궁금할 거에요.왜냐하면 파이썬은 파일을 위에서 아래로 읽어 실행하기 때문이에요. 함수를 사용하기 위해서는 하단에 다시 적어야 합니다.
+파일 맨 밑에 왜 함수의 이름을 적는지 궁금할거에요. 왜냐하면 파이썬은 파일을 위에서 아래로 읽어 실행하기 떄문이에요. 우리의 함수를 사용하기 위해서는 하단에 다시 적어야 합니다.
+
+이제 실행해서 어떻게 되는지 봅시다:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi there!
-How are you?
-```
 
-> **Note** 동작하지 않더라도 당황하지 마십시오! 에러 메세지와 출력값은 원인을 파악하고 해결할 수 있게 도와줍니다.
-- `NameError`에러는 잘못 입력한 내용이 있을 때 발생합니다. `def hi () :`로 함수를 생성 할 때와`hi ()`로 호출 할 때 같은 이름을 사용했는지 확인하세요.
-- `IndentationError`에러가 나오면, `print` 라인 둘 다 라인의 시작 부분에 같은 공백을 가지고 있는지 확인하세요. 파이썬은 함수 안의 모든 코드가 깔끔하게 정렬되어야합니다.
-- 출력값이 보이지 않는다면 마지막 `hi()`가 *들여쓰기가 되었는지* 를 확인하세요. - 들여쓰기가 된 행은 함수의 일부가 되기 떄문에 실행되지 않습니다.
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
 
+Note: if it didn't work, don't panic! The output will help you to figure why:
 
-다음으로 매개 변수와 함께 첫 번째 함수를 만들어 볼게요. 전에 사용했던 예제를 다시 사용할 거에요. 함수를 실행하면, 이름을 부르고 'hi'를 말하게요.
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
 ```
 
-함수에 매개변수인 `name`를 넣었어요. :
+함수에 매개변수인 `name`를 주었어요.
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
     if name == 'Ola':
@@ -825,60 +897,62 @@ def hi(name):
 hi()
 ```
 
-> **Note**: `if`문 안의 `print()`함수는 4칸을 들여쓰기 했습니다. 조건문에 해당하는 경우에만 실행되게 만들기 위해서에요. 이제 어떻게 되는지 보세요.
+기억하세요: `if`문 안의 `print`함수는 4칸을 들여쓰기 했습니다. 조건문에 해당하는 경우에만 실행되게 만들기 위해서에요. 이제 어떻게 되는지 보세요. :
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Traceback (most recent call last):
-File "python_intro.py", line 10, in <module>
-  hi()
-TypeError: hi() missing 1 required positional argument: 'name'
-```
 
-이런, 에러가 나왔네요. 다행히도, 파이썬 에러는 유용한 오류 메세지를 보여준답니다. 에러 메시지를 보면 함수 `hi()`가 한 개의 인자값(`name`) 을 필요로 하는데, 그 함수를 호출할 때 빼먹고 실행했다는 것을 알려주고 있어요. 이제 아래와 같이 코드를 수정해봅시다.
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+이런, 에러가 나왔네요. 다행히도, 파이썬 에러는 유용한 오류 메세지를 보여주네요. 에러 메시지를 보면 함수 `hi()`가 한 개의 인자값(`name`) 을 필요로 하는데, 그 함수를 호출할 때 빼먹고 실행했다는 것을 알려주고 있어요. 이제 아래와 같이 코드를 수정해봅시다:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 hi("Ola")
 ```
 
-그리고 다시 실행해보세요.
+그리고 다시 실행해보세요. :
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi Ola!
-```
 
-이름을 바꿔볼까요?
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+만약 이름을 바꾸면 어떻게 될까요?
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 hi("Sonja")
 ```
 
-그리고 실행하세요.
+그리고 실행하세요:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi Sonja!
-```
 
+    $ python3 python_intro.py
+    Hi Sonja!
+    
 
-이제 다른 이름(Ola와 Sonja가 아닌)을 넣는다면 어떻게 될까요? 아래처럼 나오게 만들어보세요. :
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
 
 {% filename %}command-line{% endfilename %}
-```
-Hi anonymous!
-```
 
-어때요, 정말 굉장하지 않나요? 이로써 인사 함수가 호출될 때마다, 매번 사람 이름을 반복할 필요가 없어요. 그래서 함수가 필요답니다. 매번 똑같은 코드를 반복해 작성하지 않아도 돼요!
+    Hi anonymous!
+    
 
-좀 더 똑똑하게 만들어 볼게요. - 2명 이상 이름이 있는 경우, 모든 이름마다 조건문을 추가하는 건 꽤 귀찮은 일이 될거에요. 그렇죠?
+어때요, 정말 굉장하지 않나요? 이로써 인사 함수가 호출될 때마다, 사람 이름을 매번 반복할 필요가 없어요. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
     print('Hi ' + name + '!')
@@ -886,43 +960,46 @@ def hi(name):
 hi("Rachel")
 ```
 
-이제 코드를 실행해 봅시다. :
+이제 코드를 실행해 봅시다:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi Rachel!
-```
 
-축하합니다! 우리는 이제 함수를 만들 수 있게 되었어요! :)
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+축하합니다! 이제 여러분은 함수를 작성하는 방법을 배웠습니다! :)
 
 ## 반복하기
 
-> 집에서 학습하는 분들은 [파이썬 기초: For 문](https://www.youtube.com/watch?v=aEA6Rc86HF0) 영상을 보세요.
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
 
 이제 마지막 부분입니다. 금방 했죠? :)
 
-프로그래머는 반복되는 일을 하는 것을 좋아하지 않아요. 프로그래밍은 모든 것을 자동화하는 것입니다. 모든 사람의 이름을 일일이 입력해서 hi 라는 메세지를 출력하게 만들고 싶지 않겠죠. 반복문을 사용하면 이를 해결할 수 있습니다.
+프로그래머는 반복되는 일을 스스로 하기를 좋아하지 않아요. 프로그래밍이란 어떤 일들을 자동화하는 것이니까 반복적인 경우가 생기면 그걸 반복해서 해결하는 코드를 짜는 것이지요. 앞에서 했던 예제와 같이 인사해야 하는 사람이 수백명 있을 경우, 설마 각각 사람마다 인사하려고 hi('누구누구') 코드를 수백번 입력하고 싶지는 않겠지요? 이런 경우에 바로 반복문(loop)를 사용할 수 있어요.
 
-리스트를 기억하고 있죠? 아래 girls 리스트를 보세요.
+리스트 아직 기억하고 있어요? 아래 girls 리스트를 보세요. :
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
 ```
 
-우리는 여자 아이들 이름을 불러 인사를 하고 싶어요. 우리는 이미 `hi` 함수를 만들었으니 반복문을 사용해봅시다. :
+우리는 여자 아이들 이름을 불러 인사를 하고 싶어요. 우리는 이미 `hi` 함수를 만들었으니 반복문을 사용해봅시다. : 
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 for name in girls:
 ```
 
-The ```for```문은 ```if```문과  다음 줄은 4칸 들여쓰기를 해야합니다.
+그리고 ```for``` 문은 ```if``` 문과 비슷한 일을 합니다; 4칸을 들여쓰기된 코드
 
-아래 완성된 코드입니다.
+아래 완성된 코드입니다. :
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
     print('Hi ' + name + '!')
@@ -933,53 +1010,53 @@ for name in girls:
     print('Next girl')
 ```
 
-실행하면 다음과 같습니다.
+실행하면 다음과 같습니다:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi Rachel!
-Next girl
-Hi Monica!
-Next girl
-Hi Phoebe!
-Next girl
-Hi Ola!
-Next girl
-Hi You!
-Next girl
-```
 
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
 
 `girls` 리스트의 요소마다 여러분이 `for`문에 넣은, 들여쓰기를 한 모든 코드들이 반복됩니다.
 
-`for`문에 `range()` 함수로 숫자범위를 지정해 사용할 수 있어요.
+`for`문에 `range` 함수로 숫자를 사용할 수 있어요.
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 for i in range(1, 6):
     print(i)
 ```
 
-이렇게 출력됩니다.
+이렇게 출력됩니다. :
 
 {% filename %}command-line{% endfilename %}
-```
-1
-2
-3
-4
-5
-```
 
-`range()`는 매개변수로 넘겨진 숫자부터 시작하는 숫자 리스트를 만들어주는 함수입니다.
+    1
+    2
+    3
+    4
+    5
+    
+
+`range`는 매개 변수로 넘겨진 숫자부터 시작하는 숫자 리스트를 만들어주는 함수입니다.
 
-두 숫자 중 두 번째(마지막)숫자는 리스트에 포함되지 않는다는 것을 기억하세요. (즉 `range(1, 6)`는 1부터 5까지 카운트 하며 숫자 6은 리스트에 포함되지 않습니다) "range()"는 반만 열려 있기 때문에, 첫번째 숫자는 포함되지만 마지막 숫자는 포함되지 않아요.
+파이썬에서는 두 숫자 중 두 번째는 리스트에 포함되지 않는다는 것을 주의하세요. (즉 `range(1, 6)`는 1부터 5까지 카운트 하며 숫자 6은 리스트에 포함되지 않습니다.) That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
 
-## 요약
+## 목차
 
-이제 다 끝났어요. **모두 정말 대단해요!** 지금까지 어려운 내용을 잘 따라온 여러분들이 정말 자랑스러워요!
+이제 다 끝났어요. **모두 정말 대단해요!** 어려운 내용이었는데 잘 해낸 나 자신을 자랑스럽게 생각하세요. 여기까지 온 것이 자랑스럽습니다!
 
-다음 장으로 가기전에 잠시 쉬는 시간을 가져도 좋아요. 스트레칭을 하던가, 잠깐 산책을 하던가, 눈을 쉬게 한다던가 말이죠. :)
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
 
-![Cupcake](images/cupcake.png)
+![컵케이크](images/cupcake.png)
\ No newline at end of file
diff --git a/ko/signup_pythonanywhere.md b/ko/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/ko/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ko/template_extending/README.md b/ko/template_extending/README.md
index 75ed74531df..2c8446ef19c 100755
--- a/ko/template_extending/README.md
+++ b/ko/template_extending/README.md
@@ -1,25 +1,26 @@
 # 템플릿 확장하기
 
-장고의 또 다른 멋진 기능은 __템플릿 확장(template extending)__ 입니다. 무슨 뜻일까요? 바로 여러분의 웹사이트 안의 서로 다른 페이지에서 HTML의 일부를 동일하게 재사용 할 수 있다는 뜻이에요.
+장고의 또 다른 멋진 점은 **템플릿 확장(template extending)**입니다. 무슨 뜻일까요? 바로 여러분의 웹사이트 안의 서로 다른 페이지에서 HTML의 일부를 동일하게 재사용 할 수 있다는 뜻이에요.
 
-이 방법을 사용하면 동일한 정보/레이아웃을 사용하고자 할 때, 모든 파일마다 같은 내용을 반복해서 입력 할 필요가 없게 됩니다. 또 뭔가 수정할 부분이 생겼을 때, 각각 모든 파일을 수정할 필요 없이 딱 한번만 수정하면 된답니다!
+Templates help when you want to use the same information or layout in more than one place. 모든 파일에 동일한 내용을 반복해서 작성할 필요가 없게 되지요. And if you want to change something, you don't have to do it in every template, just one!
 
-## 기본 템플릿 생성하기
+## Create a base template
 
 기본 템플릿은 웹사이트 내 모든 페이지에 확장되어 사용되는 가장 기본적인 템플릿입니다.
 
-`blog/templates/blog/`에 `base.html` 파일을 만들어 봅시다. :
+`blog/templates/blog/`에 `base.html` 파일을 만들어 봅시다:
 
     blog
     └───templates
         └───blog
                 base.html
                 post_list.html
-
+    
 
 그 다음 파일을 열어 `post_list.html`에 있는 모든 내용을 `base.html`에 아래 내용을 복사해 붙여넣습니다.
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -54,9 +55,10 @@
 </html>
 ```
 
-그 다음 `base.html`에서 `<body>` (`<body>`와 `</body>` 사이에 있는 모든 내용)의 모든 내용을 아래와 같이 바꿉니다. :
+그 다음 `base.html`에서 `<body>` (`<body>`와 `</body>` 사이에 있는 모든 내용)의 모든 내용을 아래와 같이 바꿉니다:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <body>
     <div class="page-header">
@@ -73,21 +75,21 @@
 </body>
 ```
 
-{% raw %}`{% for post in posts %}{% endfor %}` 사이에 있는 모든 내용을 바꿨습니다.: {% endraw %}
+{% raw %}`{% for post in posts %}` 부터`{% endfor %}` 까지 모든 내용을 바꿨어요. {% endraw %}
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% block content %}
 {% endblock %}
 ```
 
-이 코드는 무엇을 의미일까요? 우리는 `block`을 만든 거에요! 템플릿 태그 `{% block %}`으로 HTML 내에 들어갈 수 있는 공간을 만들었어요. `base.html`을 확장해 다른 템플릿에도 가져다 쓸 수 있게 한 거죠. 어떻게 동작하는지 보여 드릴게요.
-
-이제 `base.html`을 파일을 저장을 하고, `blog/templates/blog/post_list.html` 파일을 다시 엽니다. 
-{% raw %}`{% for post in posts %}`부터 `{% endfor %}`까지만 남기고 나머지는 전부  지우세요. 그럼 아래와 같이 될 겁니다. :{% endraw %}
+왜 그럴까요? `block`을 만들었기 때문이죠! `{% block %}`템플릿 태그는 HTML이 삽입될 수 있는 영역을 만들어줍니다. That HTML will come from another template that extends this template (`base.html`). 그럼 어떻게 동작하는지 알아볼게요.
 
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}`{% for post in posts %}`부터 `{% endfor %}`까지 모든 내용을 지우세요. When you're done, the file will look like this:{% endraw %}
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     <div class="post">
@@ -100,12 +102,12 @@
 {% endfor %}
 ```
 
-우리는 이 코드를 모든 컨텐츠 블록에 대한 템플릿의 일부로 거에요.
-이 파일에 블록 태그를 추가해봅시다!
+모든 콘텐츠 블록마다 이 템플릿을 사용할 거에요. 이제 파일에 블록 태그를 추가할 차례입니다!
 
-{% raw %}블록 태그가 `base.html`파일의 태그와 일치해야겠죠. 또 콘텐츠 블록에 속한 모든 코드를 포함하게 만들어야 할 거에요. 이를 위해서 `{% block content %}`와 `{% endblock %}`사이에 모든 코드를 넣으세요. 이렇게 말이죠. : {% endraw %}
+{% raw %}`base.html`파일 내 태그와 블록 태그가 일치하게 만들어야 합니다. 콘텐츠 블록에 속한 모든 코드가 포함되어야 하고요. 이를 위해, `{% block content %}`와 `{% endblock %}`사이에 모든 코드를 작성하면 됩니다. 아래 처럼요. :{% endraw %}
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% block content %}
     {% for post in posts %}
@@ -120,9 +122,10 @@
 {% endblock %}
 ```
 
-한 가지만 남았습니다. 이 두 템플릿을 연결해야해요. 지금까지 실습한 내용이 바로 확장 템플릿의 전부입니다! 확장 태그를 파일 맨 처음에 추가합니다. 아래와 같이요. :
+한가지가 남았습니다. 템플릿 두 개를 서로 연결해야합니다. 그래서 템플릿을 확장한다는 거죠! 파일의 첫 부분에 태그를 추가하면 됩니다. 이렇게요:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -139,6 +142,6 @@
 {% endblock %}
 ```
 
-다 되었어요! 여러분의 웹사이트가 잘 작동하는지 확인해보세요.)
+That's it! Check if your website is still working properly. :)
 
-> 만약 `TemplateDoesNotExists(템플릿파일이 존재하지 않습니다)`라는 에러 메세지가 난다면 `blog/base.html`파일이 없이 콘솔에서 `runserver`가 작동되고 있는 경우입니다. 이런 경우, (Ctrl+C)를 눌러서 멈춘 후 `python manage.py runserver`명령어로 다시 서버를 실행하세요.
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ko/whats_next/README.md b/ko/whats_next/README.md
index 7f9884063dc..4a91be668da 100755
--- a/ko/whats_next/README.md
+++ b/ko/whats_next/README.md
@@ -1,20 +1,19 @@
-# 더 나아가기
-튜토리얼을 마친 나에게 자신에게 축하한다고 말해보세요! __여러분 모두 정말 멋지게 해냈어요__. 모두 자랑스럽습니다! <3
+# 다음은?
 
-모두 축하합니다! **정말 멋져요!** 여러분들이 자랑스러워요! ^___^
+Congratulate yourself! **You're totally awesome**. We're proud! <3
 
 ### 이제 무엇을 해야하나요?
 
-잠시 휴식을 가지고 여유를 가지세요. 여러분은 이제 막 정말 큰 일 마쳤으니까요.
+잠시 휴식을 가지고 여유를 가지세요. 여러분은 이제 막 정말 큰 일 마쳤으니까요
 
-그리고 장고걸스 [페이스북](http://facebook.com/djangogirls)와 [트위터](https://twitter.com/djangogirls)를 팔로우하셔서 최신 소식을 구독하세요.
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
 
+### 다음에 해볼만한 자료를 추천해주실래요?
 
-### 앞으로 해 볼 만한 자료를 추천해주실래요?
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
 
-그럼요! [장고걸스: 심화튜토리얼(Django Girls Tutorial: Extensions)](https://tutorial-extensions.djangogirls.org)을 읽어보세요.
+Later on, you can try the resources listed below. They're all very recommended!
 
-나중에 아래 추천 리스트를 참고해 공부해보세요. 모두 강력 추천하는 자료입니다!
 - [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
 - [New Coder tutorials](http://newcoder.io/tutorials/)
 - [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
@@ -22,5 +21,5 @@
 - [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
 - [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
 - [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
-- [Two Scoops of Django: Best Practices for Django 1.8 book](https://twoscoopspress.com/products/two-scoops-of-django-1-8)
-- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/kr-SL/GLOSSARY.md b/kr-SL/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/kr-SL/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/kr-SL/README.md b/kr-SL/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/kr-SL/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/kr-SL/SUMMARY.md b/kr-SL/SUMMARY.md
new file mode 100644
index 00000000000..7a45700a27d
--- /dev/null
+++ b/kr-SL/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/kr-SL/chromebook_setup/README.md b/kr-SL/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/kr-SL/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/kr-SL/chromebook_setup/instructions.md b/kr-SL/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..28566904293
--- /dev/null
+++ b/kr-SL/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/kr-SL/code_editor/README.md b/kr-SL/code_editor/README.md
new file mode 100644
index 00000000000..404011f1b7d
--- /dev/null
+++ b/kr-SL/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/kr-SL/code_editor/instructions.md b/kr-SL/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/kr-SL/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/kr-SL/css/README.md b/kr-SL/css/README.md
new file mode 100644
index 00000000000..2e43c4e4f48
--- /dev/null
+++ b/kr-SL/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/kr-SL/deploy/README.md b/kr-SL/deploy/README.md
new file mode 100644
index 00000000000..a94a741e8a3
--- /dev/null
+++ b/kr-SL/deploy/README.md
@@ -0,0 +1,222 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Enter your GitHub username and password and you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Username for 'https://github.com': ola
+    Password for 'https://ola@github.com':
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.6 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own PC
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider. The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own PC—that means it can have different posts and admin accounts.
+
+As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  forms.py  migrations  models.py  static
+    templates  tests.py  urls.py  views.py
+    
+
+You can also go to the "Files" tab and navigate around using PythonAnywhere's built-in file browser.
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" tab to get a link to it. You can share this with anyone you want :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.0/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/kr-SL/deploy/install_git.md b/kr-SL/deploy/install_git.md
new file mode 100644
index 00000000000..cc5e638c991
--- /dev/null
+++ b/kr-SL/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/kr-SL/deploy/signup_pythonanywhere.md b/kr-SL/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..87544081943
--- /dev/null
+++ b/kr-SL/deploy/signup_pythonanywhere.md
@@ -0,0 +1,11 @@
+Sign up for a free "Beginner" account on PythonAnywhere:
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Accounts" page, then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Accounts page](images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/kr-SL/django/README.md b/kr-SL/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/kr-SL/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/kr-SL/django_admin/README.md b/kr-SL/django_admin/README.md
new file mode 100644
index 00000000000..9ece0a5ee71
--- /dev/null
+++ b/kr-SL/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.0/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/kr-SL/django_forms/README.md b/kr-SL/django_forms/README.md
new file mode 100644
index 00000000000..a8cfca01d3c
--- /dev/null
+++ b/kr-SL/django_forms/README.md
@@ -0,0 +1,449 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path 
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.0/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-username>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-username>` with your actual PythonAnywhere username, without the angle-brackets).
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/kr-SL/django_installation/README.md b/kr-SL/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/kr-SL/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/kr-SL/django_installation/instructions.md b/kr-SL/django_installation/instructions.md
new file mode 100644
index 00000000000..374e6c5de14
--- /dev/null
+++ b/kr-SL/django_installation/instructions.md
@@ -0,0 +1,218 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python3 -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of `djangogirls/` folder:
+
+    djangogirls
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/kr-SL/django_models/README.md b/kr-SL/django_models/README.md
new file mode 100644
index 00000000000..30719329d60
--- /dev/null
+++ b/kr-SL/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User', on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.0/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/kr-SL/django_orm/README.md b/kr-SL/django_orm/README.md
new file mode 100644
index 00000000000..6e98b36e43a
--- /dev/null
+++ b/kr-SL/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/kr-SL/django_start_project/README.md b/kr-SL/django_start_project/README.md
new file mode 100644
index 00000000000..22b5af697d7
--- /dev/null
+++ b/kr-SL/django_start_project/README.md
@@ -0,0 +1,203 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    ├───mysite
+    │        settings.py
+    │        urls.py
+    │        wsgi.py
+    │        __init__.py
+    └───requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.0/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/kr-SL/django_templates/README.md b/kr-SL/django_templates/README.md
new file mode 100644
index 00000000000..f692492c1c3
--- /dev/null
+++ b/kr-SL/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd $USER.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/kr-SL/django_urls/README.md b/kr-SL/django_urls/README.md
new file mode 100644
index 00000000000..f94d56b5821
--- /dev/null
+++ b/kr-SL/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.urls import path, include
+from django.contrib import admin
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.urls import path, include
+from django.contrib import admin
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full url path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.0/topics/http/urls/
\ No newline at end of file
diff --git a/kr-SL/django_views/README.md b/kr-SL/django_views/README.md
new file mode 100644
index 00000000000..a5b9ba281e5
--- /dev/null
+++ b/kr-SL/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.0/topics/http/views/
\ No newline at end of file
diff --git a/kr-SL/dynamic_data_in_templates/README.md b/kr-SL/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..329b98d957b
--- /dev/null
+++ b/kr-SL/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.0/ref/models/querysets/
\ No newline at end of file
diff --git a/kr-SL/extend_your_application/README.md b/kr-SL/extend_your_application/README.md
new file mode 100644
index 00000000000..664a6d617fc
--- /dev/null
+++ b/kr-SL/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `path('post/<int:pk>)/', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` just means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the url.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-username>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-username>` with your actual PythonAnywhere username, without the angle-brackets).
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-username>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/kr-SL/how_the_internet_works/README.md b/kr-SL/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/kr-SL/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/kr-SL/html/README.md b/kr-SL/html/README.md
new file mode 100644
index 00000000000..48273178b7a
--- /dev/null
+++ b/kr-SL/html/README.md
@@ -0,0 +1,217 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blog posts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-username>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-username>` with your actual PythonAnywhere username, without the angle-brackets).
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/kr-SL/installation/README.md b/kr-SL/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/kr-SL/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/kr-SL/intro_to_command_line/README.md b/kr-SL/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/kr-SL/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/kr-SL/python_installation/README.md b/kr-SL/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/kr-SL/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/kr-SL/python_installation/instructions.md b/kr-SL/python_installation/instructions.md
new file mode 100644
index 00000000000..c1a53d38bdb
--- /dev/null
+++ b/kr-SL/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu and enter "Command Prompt" into the search field there. (On older versions of Windows, you can start the Command Line with Start menu → Windows System → Command Prompt.) You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/kr-SL/python_introduction/README.md b/kr-SL/python_introduction/README.md
new file mode 100644
index 00000000000..97b2e788a0a
--- /dev/null
+++ b/kr-SL/python_introduction/README.md
@@ -0,0 +1,1068 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/kr-SL/template_extending/README.md b/kr-SL/template_extending/README.md
new file mode 100644
index 00000000000..e4263d91f8e
--- /dev/null
+++ b/kr-SL/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/kr-SL/whats_next/README.md b/kr-SL/whats_next/README.md
new file mode 100644
index 00000000000..db50453eb1a
--- /dev/null
+++ b/kr-SL/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.0/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/ku-TR/GLOSSARY.md b/ku-TR/GLOSSARY.md
new file mode 100644
index 00000000000..a54e0a319cd
--- /dev/null
+++ b/ku-TR/GLOSSARY.md
@@ -0,0 +1,3 @@
+# کۆد ئێدیتەر
+
+کۆد ئێدیتەر پرۆگرامێکە کە رێگە دەدات کۆدەکەت پارێزراو بێت تاکوو دوایی بتوانی بگەڕێەوە و بەردەوام بی لەسەر گۆڕانکاریەکانت. دەتوانن لە [بەشی کۆد ئێدیتەر](./code_editor/README.md) ئەو بەشە کە پێویستتانە هەڵیببژێرن و فێرببن
\ No newline at end of file
diff --git a/ku-TR/README.md b/ku-TR/README.md
new file mode 100644
index 00000000000..ae757bae651
--- /dev/null
+++ b/ku-TR/README.md
@@ -0,0 +1,51 @@
+# فێرکاری کچانی جەنگۆ
+
+[![پرۆگرامی گیتر](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> ئەم فێرکاریە رێگەی پێدراوە لەلایەن رێگەپێدەری (Creative Commons Attribution-ShareAlike 4.0)وە بۆ دیتنی کۆپییەک لە رێگەپێدەرەکە، سەردانی بەستەری https://creativecommons.org/licenses/by-sa/4.0/ بکە
+
+## بەخێربێیت
+
+بەخێربێیت بۆ فێرکاری کچانی جەنگۆ! ئێمه خۆشحاڵین بە دیتنی ئێوە بە سەردانی ئێوە بۆ ئێرە خۆشحاڵین :-) لەو فێرکارییەدا، دەتانبەین بۆ سەفەرێک لەژێر ناوی تەکنۆلۆژیای وێب، ئەو دەرفەتە دەخوڵقێنین کە سەرنجتان رابکێشین بۆ پێداچوونەوەیەک بەسەر هەموو ئەو وردە بەشانە کە پێویستە لەگەڵ یەکتری بن بۆ ئەوەی وێب لەسەرگەڕ بێت وەکوو دەیزانین.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## پێشەکی
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ku-TR/SUMMARY.md b/ku-TR/SUMMARY.md
new file mode 100644
index 00000000000..7455ed48c33
--- /dev/null
+++ b/ku-TR/SUMMARY.md
@@ -0,0 +1,35 @@
+# پوختە
+
+* [پێشەکی](README.md)
+* [دابەزاندن](installation/README.md) 
+  * [کۆمەند لاین](installation/README.md#command-line)
+  * [پایتۆن](installation/README.md#python)
+  * [کۆد ئێدیتەر](installation/README.md#code-editor)
+  * [ژینگەی ڤیرچواڵ](installation/README.md#virtualenv)
+  * [جەنگۆ](installation/README.md#django)
+  * [گیت](installation/README.md#git)
+  * [گیتهاب](installation/README.md#github-account)
+  * [پایتۆن لە هەموو شوێنێک](installation/README.md#pythonanywhere-account)
+* [دابەزاندن (کرۆمبووک)](chromebook_setup/README.md)
+* [ئینتەرنێت چۆن ئیش دەکات](how_the_internet_works/README.md)
+* [سەرەتایەک لەسەر کۆمەند لاین](intro_to_command_line/README.md)
+* [دابەزاندنی پایتۆن](python_installation/README.md)
+* [کۆد ئێدیتەر](code_editor/README.md)
+* [پێشەکییەک لەسەر پایتۆن](python_introduction/README.md)
+* [جەنگۆ چییە؟](django/README.md)
+* [دابەزاندنی جەنگۆ](django_installation/README.md)
+* [یەکەم پڕۆژەت لە جەنگۆ!](django_start_project/README.md)
+* [شێوەکانی جەنگۆ](django_models/README.md)
+* [جەنگۆ ئەدمین](django_admin/README.md)
+* [جێگیرکردن!](deploy/README.md)
+* [بەستەرەکانی جەنگۆ](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [چی دواتر؟](whats_next/README.md)
\ No newline at end of file
diff --git a/ku-TR/chromebook_setup/README.md b/ku-TR/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/ku-TR/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ku-TR/chromebook_setup/instructions.md b/ku-TR/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..2df2048e6ec
--- /dev/null
+++ b/ku-TR/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ku-TR/code_editor/README.md b/ku-TR/code_editor/README.md
new file mode 100644
index 00000000000..0a401fb1f52
--- /dev/null
+++ b/ku-TR/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ku-TR/code_editor/instructions.md b/ku-TR/code_editor/instructions.md
new file mode 100644
index 00000000000..82fbac15aad
--- /dev/null
+++ b/ku-TR/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ku-TR/css/README.md b/ku-TR/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/ku-TR/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/ku-TR/deploy/README.md b/ku-TR/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/ku-TR/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/ku-TR/deploy/install_git.md b/ku-TR/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/ku-TR/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ku-TR/deploy/signup_pythonanywhere.md b/ku-TR/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/ku-TR/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ku-TR/django/README.md b/ku-TR/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/ku-TR/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/ku-TR/django_admin/README.md b/ku-TR/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/ku-TR/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ku-TR/django_forms/README.md b/ku-TR/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/ku-TR/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ku-TR/django_installation/README.md b/ku-TR/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/ku-TR/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ku-TR/django_installation/instructions.md b/ku-TR/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/ku-TR/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ku-TR/django_models/README.md b/ku-TR/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/ku-TR/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ku-TR/django_orm/README.md b/ku-TR/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/ku-TR/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ku-TR/django_start_project/README.md b/ku-TR/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/ku-TR/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ku-TR/django_templates/README.md b/ku-TR/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/ku-TR/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ku-TR/django_urls/README.md b/ku-TR/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/ku-TR/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ku-TR/django_views/README.md b/ku-TR/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/ku-TR/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ku-TR/dynamic_data_in_templates/README.md b/ku-TR/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/ku-TR/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ku-TR/extend_your_application/README.md b/ku-TR/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/ku-TR/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ku-TR/how_the_internet_works/README.md b/ku-TR/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/ku-TR/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ku-TR/html/README.md b/ku-TR/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/ku-TR/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ku-TR/installation/README.md b/ku-TR/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/ku-TR/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ku-TR/intro_to_command_line/README.md b/ku-TR/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/ku-TR/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ku-TR/intro_to_command_line/open_instructions.md b/ku-TR/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/ku-TR/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ku-TR/python_installation/README.md b/ku-TR/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/ku-TR/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ku-TR/python_installation/instructions.md b/ku-TR/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/ku-TR/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ku-TR/python_introduction/README.md b/ku-TR/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/ku-TR/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ku-TR/template_extending/README.md b/ku-TR/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/ku-TR/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ku-TR/whats_next/README.md b/ku-TR/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/ku-TR/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/lt-LT/GLOSSARY.md b/lt-LT/GLOSSARY.md
new file mode 100644
index 00000000000..6e97032d0d5
--- /dev/null
+++ b/lt-LT/GLOSSARY.md
@@ -0,0 +1,3 @@
+# kodas redaktorius
+
+Ein Code-Editor ist eine Anwendung, die es dir erlaubt, deinen Code zu speichern, um später daran weiterzuarbeiten. Du kannst in dem [Code-Editor Kapitel](./code_editor/README.md) erfahren, woher du einen bekommst
\ No newline at end of file
diff --git a/lt-LT/README.md b/lt-LT/README.md
new file mode 100644
index 00000000000..9d73d939627
--- /dev/null
+++ b/lt-LT/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Dieses Werk ist unter der Creative Commons Attribution-ShareAlike 4.0 International License lizensiert. Eine Kopie dieser Lizenz finden Sie auf http://creativecommons.org/licenses/by-sa/4.0/
+
+## Willkommen
+
+Willkommen beim Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Einleitung
+
+Hattest du auch schon einmal das Gefühl, dass Technik in der Welt immer wichtiger wird und du da nicht ganz mithalten kannst?"("? Wolltest du schon immer einmal eine Website bauen, aber hattest dann nicht genug Motivation, damit anzufangen? Hast du dir irgendwann schon einmal gedacht, dass die Computerwelt zu kompliziert für dich ist, so dass du noch nicht einmal den Versuch unternommen hast, dort selbst etwas zu tun?
+
+Dann haben wir hier gute Neuigkeiten für dich! Programmieren ist nicht so schwer, wie du denkst und wir zeigen dir hier, wie viel Spaß es machen kann.
+
+Dieses Tutorial wird dich nicht auf zauberhafte Weise in eine Programmiererin verwandeln. Wenn du gut darin sein willst, brauchst du Monate oder sogar Jahre des Lernens und Übens. Aber wir wollen dir zeigen, dass Programmieren oder Webseitenerstellen nicht so kompliziert ist, wie es scheint. Wir versuchen, dir auf einfache Art verschiedene, kleine Teile zu zeigen, so dass du davon nicht eingeschüchtert wirst.
+
+Wir hoffen, dass du danach diese Technik und Technologien so sehr mögen wirst wie wir!
+
+## Was lernst du in diesem Tutorial?
+
+Wenn du mit dem Tutorial fertig bist, hast du eine einfache, aber funktionierende Webanwendung: deinen eigenen Blog. Wir zeigen dir, wie man ihn online stellt, andere können dein Werk also sehen!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/lt-LT/SUMMARY.md b/lt-LT/SUMMARY.md
new file mode 100644
index 00000000000..8fde86cfdf3
--- /dev/null
+++ b/lt-LT/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Kodas redaktorius](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/lt-LT/chromebook_setup/README.md b/lt-LT/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/lt-LT/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/lt-LT/chromebook_setup/instructions.md b/lt-LT/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..2df2048e6ec
--- /dev/null
+++ b/lt-LT/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/lt-LT/code_editor/README.md b/lt-LT/code_editor/README.md
new file mode 100644
index 00000000000..7cd5ed83167
--- /dev/null
+++ b/lt-LT/code_editor/README.md
@@ -0,0 +1,11 @@
+# Kodas redaktorius
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/lt-LT/code_editor/instructions.md b/lt-LT/code_editor/instructions.md
new file mode 100644
index 00000000000..82fbac15aad
--- /dev/null
+++ b/lt-LT/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/lt-LT/css/README.md b/lt-LT/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/lt-LT/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/lt-LT/deploy/README.md b/lt-LT/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/lt-LT/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/lt-LT/deploy/install_git.md b/lt-LT/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/lt-LT/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/lt-LT/deploy/signup_pythonanywhere.md b/lt-LT/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/lt-LT/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/lt-LT/django/README.md b/lt-LT/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/lt-LT/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/lt-LT/django_admin/README.md b/lt-LT/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/lt-LT/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/lt-LT/django_forms/README.md b/lt-LT/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/lt-LT/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/lt-LT/django_installation/README.md b/lt-LT/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/lt-LT/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/lt-LT/django_installation/instructions.md b/lt-LT/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/lt-LT/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/lt-LT/django_models/README.md b/lt-LT/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/lt-LT/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/lt-LT/django_orm/README.md b/lt-LT/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/lt-LT/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/lt-LT/django_start_project/README.md b/lt-LT/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/lt-LT/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/lt-LT/django_templates/README.md b/lt-LT/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/lt-LT/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/lt-LT/django_urls/README.md b/lt-LT/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/lt-LT/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/lt-LT/django_views/README.md b/lt-LT/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/lt-LT/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/lt-LT/dynamic_data_in_templates/README.md b/lt-LT/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/lt-LT/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/lt-LT/extend_your_application/README.md b/lt-LT/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/lt-LT/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/lt-LT/how_the_internet_works/README.md b/lt-LT/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/lt-LT/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/lt-LT/html/README.md b/lt-LT/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/lt-LT/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/lt-LT/installation/README.md b/lt-LT/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/lt-LT/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/lt-LT/intro_to_command_line/README.md b/lt-LT/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/lt-LT/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/lt-LT/intro_to_command_line/open_instructions.md b/lt-LT/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/lt-LT/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/lt-LT/python_installation/README.md b/lt-LT/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/lt-LT/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/lt-LT/python_installation/instructions.md b/lt-LT/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/lt-LT/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/lt-LT/python_introduction/README.md b/lt-LT/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/lt-LT/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/lt-LT/template_extending/README.md b/lt-LT/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/lt-LT/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/lt-LT/whats_next/README.md b/lt-LT/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/lt-LT/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/lt/GLOSSARY.md b/lt/GLOSSARY.md
new file mode 100644
index 00000000000..c3e7d845ccd
--- /dev/null
+++ b/lt/GLOSSARY.md
@@ -0,0 +1,3 @@
+# kodas redaktorius
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/lt/README.md b/lt/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/lt/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/lt/SUMMARY.md b/lt/SUMMARY.md
new file mode 100644
index 00000000000..4e50fb56fd9
--- /dev/null
+++ b/lt/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Kodas redaktorius](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/lt/chromebook_setup/README.md b/lt/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/lt/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/lt/chromebook_setup/instructions.md b/lt/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/lt/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/lt/code_editor/README.md b/lt/code_editor/README.md
new file mode 100644
index 00000000000..e41c1d7bc1c
--- /dev/null
+++ b/lt/code_editor/README.md
@@ -0,0 +1,11 @@
+# Kodas redaktorius
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/lt/code_editor/instructions.md b/lt/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/lt/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/lt/css/README.md b/lt/css/README.md
new file mode 100644
index 00000000000..04d5996ae52
--- /dev/null
+++ b/lt/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/lt/deploy/README.md b/lt/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/lt/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/lt/deploy/install_git.md b/lt/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/lt/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/lt/deploy/signup_pythonanywhere.md b/lt/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/lt/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/lt/django/README.md b/lt/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/lt/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/lt/django_admin/README.md b/lt/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/lt/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/lt/django_forms/README.md b/lt/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/lt/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/lt/django_installation/README.md b/lt/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/lt/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/lt/django_installation/instructions.md b/lt/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/lt/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/lt/django_models/README.md b/lt/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/lt/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/lt/django_orm/README.md b/lt/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/lt/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/lt/django_start_project/README.md b/lt/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/lt/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/lt/django_templates/README.md b/lt/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/lt/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/lt/django_urls/README.md b/lt/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/lt/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/lt/django_views/README.md b/lt/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/lt/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/lt/dynamic_data_in_templates/README.md b/lt/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/lt/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/lt/extend_your_application/README.md b/lt/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/lt/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/lt/how_the_internet_works/README.md b/lt/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/lt/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/lt/html/README.md b/lt/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/lt/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/lt/install_git.md b/lt/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/lt/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/lt/installation/README.md b/lt/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/lt/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/lt/instructions.md b/lt/instructions.md
new file mode 100644
index 00000000000..b5a0981698b
--- /dev/null
+++ b/lt/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period. It's easy to install and use, and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source, easy to install and easy to use. It's available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/lt/intro_to_command_line/README.md b/lt/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/lt/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/lt/python_installation/README.md b/lt/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/lt/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/lt/python_installation/instructions.md b/lt/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/lt/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/lt/python_introduction/README.md b/lt/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/lt/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/lt/signup_pythonanywhere.md b/lt/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/lt/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/lt/template_extending/README.md b/lt/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/lt/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/lt/whats_next/README.md b/lt/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/lt/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/mai-IN/GLOSSARY.md b/mai-IN/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/mai-IN/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/mai-IN/README.md b/mai-IN/README.md
new file mode 100644
index 00000000000..121da8f55bf
--- /dev/null
+++ b/mai-IN/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/mai-IN/SUMMARY.md b/mai-IN/SUMMARY.md
new file mode 100644
index 00000000000..d9741b4f21c
--- /dev/null
+++ b/mai-IN/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/mai-IN/chromebook_setup/README.md b/mai-IN/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/mai-IN/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/mai-IN/chromebook_setup/instructions.md b/mai-IN/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..2df2048e6ec
--- /dev/null
+++ b/mai-IN/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/mai-IN/code_editor/README.md b/mai-IN/code_editor/README.md
new file mode 100644
index 00000000000..0a401fb1f52
--- /dev/null
+++ b/mai-IN/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/mai-IN/code_editor/instructions.md b/mai-IN/code_editor/instructions.md
new file mode 100644
index 00000000000..82fbac15aad
--- /dev/null
+++ b/mai-IN/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/mai-IN/css/README.md b/mai-IN/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/mai-IN/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/mai-IN/deploy/README.md b/mai-IN/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/mai-IN/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/mai-IN/deploy/install_git.md b/mai-IN/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/mai-IN/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/mai-IN/deploy/signup_pythonanywhere.md b/mai-IN/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/mai-IN/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/mai-IN/django/README.md b/mai-IN/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/mai-IN/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/mai-IN/django_admin/README.md b/mai-IN/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/mai-IN/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/mai-IN/django_forms/README.md b/mai-IN/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/mai-IN/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/mai-IN/django_installation/README.md b/mai-IN/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/mai-IN/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/mai-IN/django_installation/instructions.md b/mai-IN/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/mai-IN/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/mai-IN/django_models/README.md b/mai-IN/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/mai-IN/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/mai-IN/django_orm/README.md b/mai-IN/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/mai-IN/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/mai-IN/django_start_project/README.md b/mai-IN/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/mai-IN/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/mai-IN/django_templates/README.md b/mai-IN/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/mai-IN/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/mai-IN/django_urls/README.md b/mai-IN/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/mai-IN/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/mai-IN/django_views/README.md b/mai-IN/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/mai-IN/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/mai-IN/dynamic_data_in_templates/README.md b/mai-IN/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/mai-IN/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/mai-IN/extend_your_application/README.md b/mai-IN/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/mai-IN/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/mai-IN/how_the_internet_works/README.md b/mai-IN/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/mai-IN/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/mai-IN/html/README.md b/mai-IN/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/mai-IN/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/mai-IN/installation/README.md b/mai-IN/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/mai-IN/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/mai-IN/intro_to_command_line/README.md b/mai-IN/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/mai-IN/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/mai-IN/intro_to_command_line/open_instructions.md b/mai-IN/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/mai-IN/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/mai-IN/python_installation/README.md b/mai-IN/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/mai-IN/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/mai-IN/python_installation/instructions.md b/mai-IN/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/mai-IN/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/mai-IN/python_introduction/README.md b/mai-IN/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/mai-IN/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/mai-IN/template_extending/README.md b/mai-IN/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/mai-IN/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/mai-IN/whats_next/README.md b/mai-IN/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/mai-IN/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/mai/GLOSSARY.md b/mai/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/mai/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/mai/README.md b/mai/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/mai/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/mai/SUMMARY.md b/mai/SUMMARY.md
new file mode 100644
index 00000000000..7a45700a27d
--- /dev/null
+++ b/mai/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/mai/chromebook_setup/README.md b/mai/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/mai/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/mai/chromebook_setup/instructions.md b/mai/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/mai/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/mai/code_editor/README.md b/mai/code_editor/README.md
new file mode 100644
index 00000000000..404011f1b7d
--- /dev/null
+++ b/mai/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/mai/code_editor/instructions.md b/mai/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/mai/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/mai/css/README.md b/mai/css/README.md
new file mode 100644
index 00000000000..04d5996ae52
--- /dev/null
+++ b/mai/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/mai/deploy/README.md b/mai/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/mai/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/mai/deploy/install_git.md b/mai/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/mai/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/mai/deploy/signup_pythonanywhere.md b/mai/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/mai/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/mai/django/README.md b/mai/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/mai/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/mai/django_admin/README.md b/mai/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/mai/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/mai/django_forms/README.md b/mai/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/mai/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/mai/django_installation/README.md b/mai/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/mai/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/mai/django_installation/instructions.md b/mai/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/mai/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/mai/django_models/README.md b/mai/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/mai/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/mai/django_orm/README.md b/mai/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/mai/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/mai/django_start_project/README.md b/mai/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/mai/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/mai/django_templates/README.md b/mai/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/mai/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/mai/django_urls/README.md b/mai/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/mai/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/mai/django_views/README.md b/mai/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/mai/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/mai/dynamic_data_in_templates/README.md b/mai/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/mai/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/mai/extend_your_application/README.md b/mai/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/mai/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/mai/how_the_internet_works/README.md b/mai/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/mai/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/mai/html/README.md b/mai/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/mai/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/mai/install_git.md b/mai/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/mai/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/mai/installation/README.md b/mai/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/mai/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/mai/instructions.md b/mai/instructions.md
new file mode 100644
index 00000000000..b5a0981698b
--- /dev/null
+++ b/mai/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period. It's easy to install and use, and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source, easy to install and easy to use. It's available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/mai/intro_to_command_line/README.md b/mai/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/mai/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/mai/python_installation/README.md b/mai/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/mai/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/mai/python_installation/instructions.md b/mai/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/mai/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/mai/python_introduction/README.md b/mai/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/mai/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/mai/signup_pythonanywhere.md b/mai/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/mai/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/mai/template_extending/README.md b/mai/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/mai/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/mai/whats_next/README.md b/mai/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/mai/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/ml-IN/GLOSSARY.md b/ml-IN/GLOSSARY.md
new file mode 100644
index 00000000000..3080a6d6b5a
--- /dev/null
+++ b/ml-IN/GLOSSARY.md
@@ -0,0 +1,3 @@
+# കോട് എടിറ്റര്‍
+
+കോട് എടിറ്റർ എന്ന് വെച്ചാൽ നിങൾ എഴുതുന്ന കോട് സേവ് ചെയ്യാനും, അതു പിന്നീട് എടുക്കാനും സഹായിക്കുന്ന ഒരു അപ്പ്ളിക്കേശൻ ആണ്. അവ എവിടെ നിന്നും കിട്ടുമെന്ന് [കോട് എടിറ്റർ പാടത്തിൽ](./code_editor/README.md) പഠിക്കാം
\ No newline at end of file
diff --git a/ml-IN/README.md b/ml-IN/README.md
new file mode 100644
index 00000000000..011f7c03168
--- /dev/null
+++ b/ml-IN/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![ഗിറ്റർ](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 ട്യൂട്ടോറിയലിലോട്ട് സ്വാഗതം! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## ആമുഖം
+
+നിങൾക്ക് തോന്നിയിട്ടുണ്ടോ ഈ ലോകത്ത് നിങൾക്ക് (ഇതുവരെ) മനസ്സിലാവാത്ത ടെക്ക്നോളജിയാണ് അതികവുമെന്ന്? എപ്പോഴെങ്കിലും ഒരു വെബ്സൈറ്റ് ഉണ്ടാക്കാൻ നിങൾക്ക് തോന്നുകയും എന്നാൽ അതിനുള്ള പ്രജോധനം ഇല്ലാതെയിരിക്കുകയും ചെയ്തിട്ടുണ്ടോ? നിങ്ങൾ സ്വന്തമായി എന്തെങ്കിലും ചെയ്യാൻ ശ്രമിക്കുന്നതിനായി സോഫ്റ്റ്വെയർ ലോകം വളരെ സങ്കീർണ്ണമാണെന്ന് താങ്കൾ എപ്പോഴെങ്കിലും ചിന്തിച്ചിട്ടുണ്ടോ?
+
+നന്നായി, ഞങ്ങൾ നിങ്ങൾക്ക് ശുഭവാർത്ത അറിയിക്കുന്നു! പ്രോഗ്രാമിംഗ് അത് തോന്നുന്നത് പോലെ ബുദ്ധിമുട്ടുള്ളതല്ല മാത്രമല്ല അത് എത്രമാത്രം രസകരമാണെന്നു കാണിച്ചുതരാൻ ഞങ്ങൾ ആഗ്രഹിക്കുന്നു.
+
+ഈ ട്യൂട്ടോറിയൽ നിങ്ങളെ ഒരു പ്രോഗ്രാമറിലേക്ക് അത്ഭുതകരമാക്കി മാറ്റുകയില്ല. നിങ്ങൾക്കതിൽ നല്ലതാകണമെങ്കിൽ, നിങ്ങൾക്ക് മാസങ്ങളോ വർഷങ്ങളോ പഠനവും പ്രയോഗവും വേണം. പക്ഷെ പ്രോഗ്രാമുകളെയോ വെബ്സൈറ്റുകൾ സൃഷ്ടിക്കുന്നതോ സങ്കീർണ്ണമായേക്കാവുന്നതോ എന്ന് ഞങ്ങൾ നിങ്ങളെ കാണിച്ചു തരാം. ഞങ്ങൾ വിവിധ ബിറ്റുകളും കഷങ്ങളെയും വിശദീകരിക്കാൻ ശ്രമിക്കും, അതിനാൽ നിങ്ങൾക്ക് സാങ്കേതികവിദ്യ ഭയപ്പെടുത്തുന്നതായി തോന്നില്ല.
+
+ഞങ്ങൾ നിങ്ങളെ പോലെ തന്നെ സാങ്കേതികവിദ്യയെ സ്നേഹിക്കാൻ കഴിയുമെന്ന് ഞങ്ങൾ പ്രതീക്ഷിക്കുന്നു!
+
+## ട്യൂട്ടോറിയലിൽ നിങ്ങൾ എന്ത് പഠിക്കും?
+
+നിങ്ങൾ ട്യൂട്ടോറിയൽ പൂർത്തിയാക്കി കഴിഞ്ഞാൽ, നിങ്ങൾക്ക് ഒരു ചെറിയ വർക്ക് വെബ് ആപ്ലിക്കേഷൻ ഉണ്ടായിരിക്കും: നിങ്ങളുടെ സ്വന്തം ബ്ലോഗ്. ഓൺലൈനിൽ എങ്ങനെ ഇട്ടുവെന്ന് ഞങ്ങൾ നിങ്ങൾക്ക് കാണിച്ചുതരാം, അതിനാൽ മറ്റുള്ളവർ നിങ്ങളുടെ ജോലി കാണും!
+
+ഇത് (കൂടുതലോ കുറവോ) ഇങ്ങനെയായിരിക്കും:
+
+![ചിത്രം 0.1](images/application.png)
+
+> നിങ്ങളുടെ സ്വന്തമായ ട്യൂട്ടോറിയൽ ഉപയോഗിച്ച് പ്രവർത്തിക്കുന്നുണ്ടെങ്കിൽ, നിങ്ങൾക്ക് എന്തെങ്കിലും പ്രശ്നമുണ്ടെങ്കിൽ നിങ്ങളെ സഹായിക്കുന്ന ഒരു കോച്ച് ഇല്ലെങ്കിൽ ഞങ്ങൾക്ക് നിങ്ങളുടെ ഒരു ചാറ്റ് സിസ്റ്റം ഉണ്ട്: [ ![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg) ](https://gitter.im/DjangoGirls/tutorial). ഞങ്ങളുടെ കോച്ചുകളും മുൻ പങ്കാളികളും സമയം ചെലവഴിക്കാൻ ട്യൂട്ടോറിയൽ ഉപയോഗിച്ച് മറ്റുള്ളവരെ സഹായിക്കാൻ ഞങ്ങൾ ആവശ്യപ്പെട്ടു! നിങ്ങളുടെ ചോദ്യം ചോദിക്കാൻ ഭയപ്പെടേണ്ടതില്ല!
+
+ശരി, തുടക്കത്തിൽ നമുക്ക് ആരംഭിക്കാം
+
+## വീട്ടിൽ ട്യൂട്ടോറിയൽ പിന്തുടരുന്നു
+
+ഒരു ഡാൻജോ ഗേൾസ് വർക്ക്ഷോപ്പിൽ പങ്കെടുക്കാൻ ഇത് വിസ്മയാവഹമാണ്. പക്ഷേ, പങ്കെടുക്കാൻ ഞങ്ങൾക്ക് എപ്പോഴും കഴിയില്ല. ഇതുകൊണ്ടാണ് വീട്ടിൽ ഈ ട്യൂട്ടോറിയൽ പിന്തുടരാൻ ശ്രമിക്കുക ഞങ്ങൾ പ്രോത്സാഹിപ്പിക്കുന്നു. വീട്ടിൽ വായനക്കാർക്ക്, ഞങ്ങൾ നിലവിൽ വീഡിയോ തയ്യാറാക്കുന്നു, നിങ്ങളുടേതായ ട്യൂട്ടോറിയൽ പിന്തുടരുന്നത് എളുപ്പമാക്കും. ഇപ്പോഴും അത് പുരോഗതിയിലാണ്, എന്നാൽ  പെൺകുട്ടികൾക്കായുള്ള കോഡിംഗ് </ u> YouTube ചാനലിലെ കൂടുതൽ കാര്യങ്ങൾ ഉടൻ തന്നെ മറയ്ക്കപ്പെടും.</p> 
+
+ഇതിനകം മൂടിയ ഓരോ അധ്യായങ്ങളിലും, കൃത്യമായ വീഡിയോ സൂചിപ്പിക്കുന്ന ഒരു ലിങ്കുണ്ട്.
+
+## ആമുഖവും സംഭാവനയും
+
+ഈ ട്യൂട്ടോറിയൽ DjangoGirls ആണ്. എന്തെങ്കിലും പിശകുകൾ കണ്ടെത്തുമ്പോൾ അല്ലെങ്കിൽ ട്യൂട്ടോറിയൽ അപ്ഡേറ്റ് ചെയ്യാൻ ആഗ്രഹിക്കുന്നുണ്ടെങ്കിൽ സംഭാവന മാർഗ്ഗരേഖകൾ പിന്തുടരുക 
+
+## മറ്റ് ഭാഷകളിലേക്ക് ട്യൂട്ടോറിയൽ വിവർത്തനം ചെയ്യാൻ ഞങ്ങളെ സഹായിക്കാൻ നിങ്ങൾക്ക് താല്പര്യമുണ്ടോ?
+
+നിലവിൽ, translations at crowdin.com പ്ലാറ്റ്ഫോം സൂക്ഷിച്ചിരിക്കുന്നത്:
+
+https://crowdin.com/project/django-girls-tutorial
+
+നിങ്ങളുടെ ഭാഷ ജനകീയ എന്നതിൽ ലിസ്റ്റുചെയ്തിട്ടില്ലെങ്കിൽ, അത് ഞങ്ങൾക്ക് ചേർക്കാൻ കഴിയുന്നതിനായി ഒരു പുതിയ ലക്കം തുറന്ന് ഞങ്ങളെ അറിയിക്കുക.
\ No newline at end of file
diff --git a/ml-IN/SUMMARY.md b/ml-IN/SUMMARY.md
new file mode 100644
index 00000000000..0af151c2fb1
--- /dev/null
+++ b/ml-IN/SUMMARY.md
@@ -0,0 +1,35 @@
+# സംഗ്രഹം
+
+* [ആമുഖം](README.md)
+* [ഇൻസ്റ്റാളേഷൻ](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [ഇൻസ്റ്റാളേഷൻ (Chromebook)](chromebook_setup/README.md)
+* [ഇന്റർനെറ്റ് എങ്ങനെ പ്രവർത്തിക്കുന്നു](how_the_internet_works/README.md)
+* [കമാൻഡ് ലൈനിനുള്ള ആമുഖം](intro_to_command_line/README.md)
+* [പൈഥൺ ഇൻസ്റ്റലേഷൻ](python_installation/README.md)
+* [കോട് എടിറ്റര്‍](code_editor/README.md)
+* [പൈത്തണിലേക്ക് ആമുഖം](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 URLs](django_urls/README.md)
+* [ജാങ്കോ (Django ) വ്യൂസ് ](django_views/README.md)
+* [HTML ആമുഖം ](html/README.md)
+* [ജാങ്കോ ORM ( ക്യുറിസെറ്റ് )](django_orm/README.md)
+* [ടെംപ്ലേറ്റിലെ ഡൈനാമിക് ടാറ്റ ](dynamic_data_in_templates/README.md)
+* [ജാങ്കോ (Django ) ടെംപ്ലേറ്റ്സ് ](django_templates/README.md)
+* [CSS - പേജ് മനോഹരമാക്കാം ](css/README.md)
+* [ടെംപ്ലേറ്റ്സ് extending ](template_extending/README.md)
+* [ആപ്ലിക്കേഷൻ വിപുലീകരിക്കുക ](extend_your_application/README.md)
+* [ജാങ്കോ (Django ) ഫോംസ് ](django_forms/README.md)
+* [അടുത്തതെന്ത്?](whats_next/README.md)
\ No newline at end of file
diff --git a/ml-IN/chromebook_setup/README.md b/ml-IN/chromebook_setup/README.md
new file mode 100644
index 00000000000..1b6183d134d
--- /dev/null
+++ b/ml-IN/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# ക്രോംബുക്ക് സെറ്റപ്പ് 
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ml-IN/chromebook_setup/instructions.md b/ml-IN/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..2df2048e6ec
--- /dev/null
+++ b/ml-IN/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ml-IN/code_editor/README.md b/ml-IN/code_editor/README.md
new file mode 100644
index 00000000000..96c90c9a93f
--- /dev/null
+++ b/ml-IN/code_editor/README.md
@@ -0,0 +1,11 @@
+# കോട് എടിറ്റര്‍
+
+> വീട്ടിൽ ഇരുന്നു വായിക്കുന്നവരുടെ ശ്രദ്ധക്ക് : [ പൈത്തൺ ഇൻസ്റ്റാൾ ചെയ്യുന്നതും കോഡ് എഡിറ്റർ ](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) വീഡിയോ ഉണ്ട് . 
+
+നിങ്ങളുടെ ആദ്യത്തെ വരി കോട് എഴുതാന്‍ നേരമായി. നമുക്കൊരു കോട് എടിറ്റര്‍ ഡൌണ്‍ലോഡ് ചെയ്യാം!
+
+> **നോട്ട് ** നിങ്ങൾ ചാറൊമേ ബുക്ക് ആണ് ഉപയോഗിക്കുന്നതെങ്കിൽ ഈ അധ്യായം വിട്ടു [ ക്രോം ബുക്ക് സെറ്റപ്പ് ](../chromebook_setup/README.md) നിർദ്ദേശങ്ങൾ വായിക്കുക നിങ്ങൾ ഉപയോഗിക്കുന്ന ക്‌ളൗഡ്‌ IDE (PaizaCloud Cloud IDE or AWS Cloud9) യിൽ ഒരു കോഡ് എഡിറ്റർ ഉൾപെട്ടിട്ടുണ്ടാകും.നിങ്ങൾ IDE ഉപയോഗിച്ച ഒരു ഫയൽ തുറക്കുമ്പോൾ അത് നേരിട്ട് കോഡ് എഡിറ്ററിൽ ആയിരിക്കും തുറന്നു വരുന്നത്.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ml-IN/code_editor/instructions.md b/ml-IN/code_editor/instructions.md
new file mode 100644
index 00000000000..c085086a8fc
--- /dev/null
+++ b/ml-IN/code_editor/instructions.md
@@ -0,0 +1,37 @@
+നിങ്ങളുടെ ഇഷ്ടത്തിനു അനുസരിച്ച് നിങ്ങള്‍ക്ക് തിരഞെടുക്കാവുന്ന ഒരുപാട് ടെക്സ്ട് എടിറ്ററുകളൂണ്ട്. ഒട്ടുമിയ്ക്ക പൈതണ്‍ പ്രൊഗ്രാമര്‍മാരും ഉപയോഗിക്കാറുള്ളത് അല്‍പ‌ം സങ്കീര്‍ണ്ണവും വളരെ പ്രാപ്തിയുമുള്ള PyCharm പോലത്തെ IDE (Integrated Development Environments) കളാണ്. എന്നാല്‍, ഒരു തുടകക്കാരി അല്ലെങ്കില്‍ തുടകക്കാരന്‍ എന്ന നിലയില്‍ അത് അല്പം കടുപ്പമേറിയതാവാം. ഇവിടെ ഞങ്ങള്‍ നിര്‍ദ്ദേശിക്കുന്നത് അത്ര തന്നെ പ്രാപ്തിയുള്ള എന്നാല്‍ സങ്കീര്‍ണ്ണമല്ലാത്തവയാണ്.
+
+താഴെ പറയുന്നവയാണ് ഞങ്ങൾ നിർദ്ദേശിക്കുന്ന എഡിറ്ററുകൾ. നിങ്ങളുടെ അധ്യാപകരോട് അവരുടെ ഇഷ്ടപെട്ടവ ചോദിക്കുന്നതിൽ മടിക്കേണ്ട. അവര്ക് നിങ്ങളെ സായ്ഹായിക്കാൻ എളുപ്പമായിരിക്കും.
+
+## വിഷ്വൽ സ്റ്റുഡിയോ കോഡ്
+
+വിൻഡോസിലും ലിനക്സിലും മാകിലും ഒരുപോലെ പ്രവർത്തിപ്പിക്കാൻ കഴിയുന്ന ഒരു സോഴ്സ് കോഡ് എഡിറ്റർ ആണ് വിഷ്വൽ സ്റ്റുഡിയോ കോഡ്. ഡീബഗ്ഗിങ്, എംബെഡ്ഡ്ഡ് ഗിറ്റ് കണ്ട്രോൾ, സിന്റാക്കസ് ഹൈലൈറ്റിംഗ്, കോഡ് കംപ്ലീഷൻ, സ്നിപ്പെട്ട്സ് പോലുള്ള ധാരാളം ഫീച്ചർ ഉള്ള ഒന്നാണ് ഈ കോഡ് എഡിറ്റർ.
+
+[ഇവിടെ നിന്നും ഡൌണ്‍ലോഡ് ചെയ്യൂ](https://code.visualstudio.com/)
+
+## ഗെഡിട്
+
+എല്ലാ ഓപ്പറേറ്റിംഗ് സിസ്റ്റത്തിനും ലഭ്യമായ ഒരു സൗജന്യ ഓപ്പൺ സോഴ്സ് കോഡ് എഡിറ്റർ ആണ് (ഗെഡിട്) Gedit.
+
+[ഇവിടെ നിന്നും ഡൌണ്‍ലോഡ് ചെയ്യൂ](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## സബ് ലൈയിം ടെക്സ്റ്റ് 3
+
+Sublime Text ഒരു വളരെ ജനസമ്മതിയും നിശ്ചിത സൌജന്യ കാലാവധിയുമുള്ള എടിറ്ററാണ്. അവ എല്ലാ ഓപറേറ്റിങ്ങ്‌ സിസ്റ്റങ്ങള്‍ക്കും ലഭ്യമാണ്. ഇന്‍സ്റ്റാള്‍ ചെയ്യാനും ഉപയോഗിക്കാനും എളുപ്പവുമാണ്.
+
+[ഇവിടെ നിന്നും ഡൌണ്‍ലോഡ് ചെയ്യൂ](https://www.sublimetext.com/3)
+
+## ആറ്റം 
+
+അതുപോലെ ആറ്റം വേറൊരു കോഡ് എഡിറ്റർ ആണ്. അത് മറ്റെല്ലാ എഡിറ്റോറിസിനെ പോലെ തന്നെ എല്ലാ ഓപ്പറേറ്റിംഗ് സിസ്റ്റത്തിലും വർക്ക് ആകും. സൗജന്യവും ആണ് അവരുടെ സേവനഗങ്ങൾ. ആറ്റം ഡെവലപ്പ് ചെയ്തതത് [ഗിറ്ഹബ് ](https://github.com/)ആണ്.
+
+[ഇവിടെ നിന്നും ഡൌണ്‍ലോഡ് ചെയ്യൂ](https://atom.io/)
+
+## എന്തിനാണ് നാം കോട് എടിറ്റര്‍ ഇന്‍സ്റ്റാള്‍ ചെയ്യുന്നത്?
+
+ഒരു സാധാരണ Word-ഓ Notepad-ഓ ഉപയോഗിക്കുന്നതിനു പകരം എന്തിനാണ് നാം ഈ പ്രത്യേകമായ കോട് എടിറ്റര്‍ സോഫ്റ്റ് വെയര്‍ ഇന്‍സ്റ്റാള്‍ ചെയ്യുന്നതെന്ന് നിങ്ങള്‍ ഒരു പക്ഷെ ചിന്തിച്ചിട്ടുണ്ടാവാം.
+
+ഒന്നാമത്തെ കാരണം എന്തെന്നാല്‍ നമ്മള്‍ എഴുതുന്ന കോട് പ്ലയിന്‍ ടെക്സ്ടില്‍ ആയിരിക്കണം. Word-ഉം Textedit-ഉം പോലെയുള്ള പ്രൊഗ്രാമുകളുടെ പ്രശ്നം അവ ഉല്‍പാദിപ്പിക്കുന്നത് പ്ലയിന്‍ ടെക്സ്ട് അല്ല. മറിച്ച് അവ നിര്‍ദ്ദേശാനുസരണം നിര്‍മ്മിക്കപ്പെട്ട RTF (Rich Text Format) പോലെയുള്ള ഫോര്‍മാറ്റുകള്‍ ഉപയോഗിച്ച് റിച്ച് ടെക്സ്ട് (ഫോന്റ്സും ഫോര്‍മാറ്റിങ്ങും അടങ്ങിയ) ആണ് ഉല്‍പാദിപ്പിക്കുക.
+
+രണ്ടാമത്തെ കാരണം എന്തെന്നാല്‍ കോട് എടിറ്ററുകള്‍ കോട് എഴുതുന്നതിനു വേണ്ടി പ്രത്യേകം നിര്‍മിക്കപ്പെട്ടവയാണ്. അതിനാല്‍ തന്നെ അവ നിങ്ങള്‍ക്ക് കോട് എഴുതാന്‍ സഹായകരമായ പല കാര്യങ്ങളും നല്‍കും. ഉദാഹരണത്തിന് പല നിറങ്ങള്‍ ഉപയോഗിച്ച് നിങ്ങളുടെ കോട് ഹൈലൈറ്റ് ചെയ്യാനും, കോട്ട്സുഗള്‍ തന്നെത്താന്‍ പൂര്‍ത്തീകരിക്കാനും അവയ്ക് കഴിയും.
+
+ഇതെല്ലാം അല്‍പസമയത്തിനുള്ളില്‍ നമുക്ക് നേരിട്ട് തന്നെ ഉപയോഗിച്ച് നോക്കാം . കുറച്ച് കാലത്തിനുള്ളില്‍ തന്നെ നിങ്ങളുടെ വിശ്വസ്തമായ കോട് എടിറ്റര്‍ നിങ്ങളുടെ ഏറ്റവും പ്രിയപ്പെട്ട ഉപകരണമായി മാറും. :)
\ No newline at end of file
diff --git a/ml-IN/css/README.md b/ml-IN/css/README.md
new file mode 100644
index 00000000000..f25b87ca7f9
--- /dev/null
+++ b/ml-IN/css/README.md
@@ -0,0 +1,330 @@
+# CSS - നമ്മുക് അത് മനോഹരമാക്കാം!
+
+നമ്മുടെ ബ്ലോഗ് ഇപ്പോഴും കാണാന്‍ വലിയ ഭംഗിയില്ല, അല്ലേ? അത് ഭംഗിയാക്കാന്‍ സമയമായി! അതിനു വേണ്ടി നമുക്കു CSS ഉപയോഗിക്കാം.
+
+## എന്താണ് CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## നമുക്ക് Bootstrap ഉപയോഗിക്കാം!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Bootstrap ഇന്‍സ്റ്റാള്‍ ചെയ്യാം
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+ഇപ്പോള്‍ തന്നെ ഒന്നു ഭംഗി കൂടിയില്ലേ!
+
+## Django-യിലെ static ഫൈലുകള്‍
+
+ഒടുവില്‍ നമ്മള്‍ **static ഫൈലുകള്‍** എന്നു വിളിച്ചുകൊണ്ടിരിക്കുന്ന ഈ വസ്തുക്കളെ ഒന്നു പരിഷോധിക്കാം. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Django-യിലെ static ഫൈലുകള്‍ എവിടെ വെക്കണം
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+അത് ചെയ്യാനായി നമുക്ക് blog ആപ്പിനകത്ത് ഒരു `static` എന്ന് പേരുള്ള ഫോള്‍ഡര്‍ നിര്‍മിക്കാം:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## നമ്മുടെ ആദ്യത്തെ CSS ഫൈല്‍!
+
+Let's create a CSS file now, to add your own style to your web page. `css` എന്ന് പേരുള്ള ഒരു പുതിയ ടയറക്ട്റി നിങ്ങളുടെ `static` ടയറക്ട്റിക്കകത്ത് നിര്‍മിക്കൂ. എന്നിട്ട് `blog.css` എന്ന് പേരുള്ള ഒരു പുതിയ ഫൈല്‍ ഈ `css` ടയറക്ടറിക്കകത്ത് നിര്‍മിക്കൂ. Ready?
+
+    djangogirls
+     └─── blog
+          └─── static
+               └─── css
+                    └─── blog.css
+    
+
+കുറച്ച് CSS എഴുതാന്‍ നേരമായി! നിങ്ങളുടെ ടെക്സ്ട് എഡിറ്ററില്‍ `blog/static/css/blog.css` എന്ന ഫൈല്‍ തുറക്കൂ.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+എന്നാലും നമുക്ക് കുറച്ചൊന്ന് ചെയ്തു നോക്കാം. Maybe we could change the color of our headers? നിറങ്ങളെ മനസ്സിലാക്കുവാനായി കംബ്യൂട്ടറുകള്‍ പ്രത്യേക കോഡുകള്‍ ഉപയോഗിക്കും. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. നേരിട്ട് നിറങ്ങളുടെ പേരുകള്‍ ഉപയോഗിച്ചാലും തെറ്റില്ല. ഉദാഹരണത്തിന് `red` എന്നോ `green` എന്നോ ഉപയോഗിക്ക.
+
+നിങ്ങളുടെ `blog/static/css/blog.css` ഫൈലില്‍ താഴെ കാണിച്ചിട്ടുള്ള കോട് ചേര്‍ക്കുക:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a`-നെ ഒരു CSS Selector എന്നണ് വിളിക്കുക. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+ഒരു HTML ഫൈലിലുള്ള എലമെന്റ്സിന്റെ സ്ടൈലിനെയാണ് നമ്മള്‍ ഒരു CSS ഫൈലില്‍ നിര്‍ണയിക്കുന്നത്. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class-ഉം id-യും നിങ്ങള്‍ തന്നെ എലമെന്റ്സിനു കൊടുക്കുന്ന പേരുകളാണ്. ഒരു class ഒരു കൂട്ടം എലമെന്റ്സിനെ വര്‍ണ്ണിക്കുവാന്‍ ഉപയോഗിക്കുന്നതാണ്. എന്നാല്‍ ഒരു id ഒരു പ്രത്യേഗ എലമെന്റിനെയാണ് സൂജിപ്പിക്കുന്നത്. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. നമ്മുടെ CSS ഫൈല്‍ എവിടെയാണെന്ന് നമ്മുടെ ടെംപ്ലൈറ്റിനോട് നാം പറഞ്ഞുകൊടുത്ത് കഴിഞ്ഞു.
+
+നമ്മുടെ ഫൈല്‍ കണ്ടാല്‍ താഴെ കൊടുത്തിട്ടുളളത് പോലെ ഇരിക്കണം:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+ഫൈല്‍ സേവ് ചെയത് സൈറ്റ് റിഫ്രഷ് ചെയ്യൂ!
+
+![Figure 14.2](images/color2.png)
+
+അടിപൊളി! നമ്മുടെ വെബ്സൈറ്റിന് എടതു ഭാഗത്തെ മാര്‍ജിന്‍ കൂട്ടി ഇത്തിരി വിസ്താരം നല്‍കാം? ശ്രമിക്കാം!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+നമ്മുടെ ഹെഡറിന്റെ ഫോണ്ടില്‍ ഒരു ഭേതഗതി വരുത്തി നോക്കിയാലോ? നിങ്ങളുടെ `blog/templates/blog/post_list.html` എന്ന ഫൈലിലെ `<head>`-ലോട്ട് താഴെയുള്ളത് പേസ്റ്റ് ചെയ്യൂ:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+ഉഷാര്‍!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/ml-IN/deploy/README.md b/ml-IN/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/ml-IN/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/ml-IN/deploy/install_git.md b/ml-IN/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/ml-IN/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ml-IN/deploy/signup_pythonanywhere.md b/ml-IN/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/ml-IN/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ml-IN/django/README.md b/ml-IN/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/ml-IN/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/ml-IN/django_admin/README.md b/ml-IN/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/ml-IN/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ml-IN/django_forms/README.md b/ml-IN/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/ml-IN/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ml-IN/django_installation/README.md b/ml-IN/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/ml-IN/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ml-IN/django_installation/instructions.md b/ml-IN/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/ml-IN/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ml-IN/django_models/README.md b/ml-IN/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/ml-IN/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ml-IN/django_orm/README.md b/ml-IN/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/ml-IN/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ml-IN/django_start_project/README.md b/ml-IN/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/ml-IN/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ml-IN/django_templates/README.md b/ml-IN/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/ml-IN/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ml-IN/django_urls/README.md b/ml-IN/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/ml-IN/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ml-IN/django_views/README.md b/ml-IN/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/ml-IN/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ml-IN/dynamic_data_in_templates/README.md b/ml-IN/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/ml-IN/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ml-IN/extend_your_application/README.md b/ml-IN/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/ml-IN/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ml-IN/how_the_internet_works/README.md b/ml-IN/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/ml-IN/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ml-IN/html/README.md b/ml-IN/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/ml-IN/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ml-IN/install_git.md b/ml-IN/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ml-IN/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ml-IN/installation/README.md b/ml-IN/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/ml-IN/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ml-IN/instructions.md b/ml-IN/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/ml-IN/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ml-IN/intro_to_command_line/README.md b/ml-IN/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/ml-IN/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ml-IN/intro_to_command_line/open_instructions.md b/ml-IN/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/ml-IN/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ml-IN/python_installation/README.md b/ml-IN/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/ml-IN/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ml-IN/python_installation/instructions.md b/ml-IN/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/ml-IN/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ml-IN/python_introduction/README.md b/ml-IN/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/ml-IN/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ml-IN/signup_pythonanywhere.md b/ml-IN/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/ml-IN/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ml-IN/template_extending/README.md b/ml-IN/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/ml-IN/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ml-IN/whats_next/README.md b/ml-IN/whats_next/README.md
new file mode 100644
index 00000000000..fe92a11cedf
--- /dev/null
+++ b/ml-IN/whats_next/README.md
@@ -0,0 +1,43 @@
+# അടുത്തതെന്ത്?
+
+ഞങ്ങൾ നിങ്ങളെ ഓർത്തു അഭിമാനിക്കുന്നു . നിങ്ങൾ ഒരു സംഭവം ആണ് . നിങ്ങളെ തന്നെ അഭിനന്ദിക്കു . <3 <3
+
+### ഇനി എന്ത് ചെയ്യും?
+
+ഒരു ബ്രേക്ക് എടുത്ത് റിലീസ് ചെയ്യൂ . നിങ്ങൾ വളരെ വലിയ ഒരു കാര്യം ആണ് ചെയ്തിരിക്കുന്നെ 
+
+അതിനു ശേഷം നിങ്ങൾ Djnago girls ഇന്റെ [ ഫേസ്ബുക് ](http://facebook.com/djangogirls) ഓ [ട്വിറ്റെർ ](https://twitter.com/djangogirls) ഫോള്ളോ ചെയ്തു എന്ന് ഉറപ്പു വരുത്തുക.
+
+### നിങ്ങൾക് വേറേതെങ്കിലും റിസോഴ്സ് പരിചയപ്പെടുത്താൻ സാധിക്കുമോ?
+
+തീർച്ചയായും ! ഏതു ലാംഗ്വേജ് പഠിക്കാൻ ആണേലും *വളരെ അതികം * ഉറവിടങ്ങൾ ഉണ്ടാകും. ഇവിടെ വരുന്നതിനു മുമ്പും വന്നതിനു ശേഷവും നിങ്ങളുടെ താല്പര്യം എന്താണേലും ചുവടെ കുറച്ച സൗജന്യ ഉറവിടങ്ങൾ കൊടുക്കുന്നു.
+
+#### ജാങ്കോ (Django)
+
+- ഞങ്ങളുടെ മറ്റു ബുക്കുകൾ , [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [ജാങ്കോയുടെ ഒഫീഷ്യൽ ട്യൂട്ടോറിയൽ ](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [ജാങ്കോ വീഡിയോ പഠനം ](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and ജാവാസ്ക്രിപ്റ്റ് 
+
+- [കോഡെഅക്കഡമി വെബ് ഡെവലപ്മെന്റ് കോഴ്സ് .](https://www.codecademy.com/learn/paths/web-development)
+- [ഫ്രീ കോഡ് ക്യാമ്പ് ](https://www.freecodecamp.org/)
+
+#### പൈതൻ 
+
+- [കോഡ് അക്കാഡമി പൈത്തൺ കോഴ്സ് ](https://www.codecademy.com/learn/learn-python)
+- [ഗൂഗിൾസ് പൈത്തൺ കോഴ്സ് ](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) ആദ്യത്തെ പാട ഭാഗങ്ങൾ ഫ്രീ 
+- [New Coder tutorials](http://newcoder.io/tutorials/) – പൈത്തൺ എങ്ങനെ ഉപയോഗിക്കാം എന്നുള്ളതിന് ഒരു വെത്യസ്തമായ പാഠ്യഭാഗം 
+- [edX](https://www.edx.org/course?search_query=python) - ഇതിൽ മിക്ക കോഴ്സയം ഫ്രീ ആണ്. പക്ഷെ നിങ്ങൾക് സർട്ടിഫിക്കറ്റ് വേണമെന്നുണ്ടെകിൽ അതിനു പണം അടക്കേണ്ടി വരും 
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – ചില പാഠഭാഗങ്ങൾ ഫ്രീ ആണ് ബാക്കി പൈസ കൊടുത്ത പഠിച്ചു കോഴ്സ്ഇറ സെര്ടിഫിക്കറ്റ് നേടാവുന്നതാണ് .
+- [Python for Everybody](https://www.py4e.com/)- കോഴ്സ്ഇറയുടെ പൈത്തൺ ക്ലാസ്സിന്റെ ഒരു ഫ്രീ വേർഷൻ .
+
+#### ഡാറ്റയും ആയി വർക്ക് ചെയ്യാൻ 
+
+- [Codecademy's ടാറ്റ സയൻസ് കോഴ്സ് ](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) - ഇതിൽ മിക്ക കോഴ്സയം ഫ്രീ ആണ്. പക്ഷെ നിങ്ങൾക് സർട്ടിഫിക്കറ്റ് വേണമെന്നുണ്ടെകിൽ അതിനു പണം അടക്കേണ്ടി വരും 
+- [Dataquest](https://www.dataquest.io/) – ആദ്യത്തെ 30 മിഷൻ ഫ്രീ ആയിരിക്കും 
+
+നിങ്ങൾ എന്താണ് ഉണ്ടാക്കിയത് എന്ന് കാണാൻ ഞങ്ങൾ ജിജ്ഞാസാരാണ്
\ No newline at end of file
diff --git a/ml/GLOSSARY.md b/ml/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/ml/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/ml/README.md b/ml/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/ml/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ml/SUMMARY.md b/ml/SUMMARY.md
new file mode 100644
index 00000000000..7a45700a27d
--- /dev/null
+++ b/ml/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/ml/chromebook_setup/instructions.md b/ml/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/ml/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ml/code_editor/README.md b/ml/code_editor/README.md
new file mode 100644
index 00000000000..404011f1b7d
--- /dev/null
+++ b/ml/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ml/code_editor/instructions.md b/ml/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/ml/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ml/deploy/install_git.md b/ml/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ml/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ml/deploy/signup_pythonanywhere.md b/ml/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/ml/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ml/django/README.md b/ml/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/ml/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/ml/django_admin/README.md b/ml/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/ml/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ml/django_installation/README.md b/ml/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/ml/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ml/django_models/README.md b/ml/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/ml/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ml/django_orm/README.md b/ml/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/ml/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ml/django_start_project/README.md b/ml/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/ml/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ml/django_templates/README.md b/ml/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/ml/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ml/django_urls/README.md b/ml/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/ml/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/ml/django_views/README.md b/ml/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/ml/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/ml/dynamic_data_in_templates/README.md b/ml/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/ml/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/ml/html/README.md b/ml/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/ml/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ml/installation/README.md b/ml/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/ml/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ml/intro_to_command_line/README.md b/ml/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/ml/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ml/python_installation/instructions.md b/ml/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/ml/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ml/python_introduction/README.md b/ml/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/ml/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ml/template_extending/README.md b/ml/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/ml/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ml/whats_next/README.md b/ml/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/ml/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/ms-MY/GLOSSARY.md b/ms-MY/GLOSSARY.md
new file mode 100644
index 00000000000..56c09af366b
--- /dev/null
+++ b/ms-MY/GLOSSARY.md
@@ -0,0 +1,3 @@
+# penyunting Kod
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/ms-MY/README.md b/ms-MY/README.md
new file mode 100644
index 00000000000..121da8f55bf
--- /dev/null
+++ b/ms-MY/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ms-MY/SUMMARY.md b/ms-MY/SUMMARY.md
new file mode 100644
index 00000000000..ce0422727bf
--- /dev/null
+++ b/ms-MY/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Penyunting Kod](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/ms-MY/chromebook_setup/README.md b/ms-MY/chromebook_setup/README.md
new file mode 100644
index 00000000000..8bfcee733ac
--- /dev/null
+++ b/ms-MY/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Persediaan Chromebook
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ms-MY/chromebook_setup/instructions.md b/ms-MY/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..fef01365851
--- /dev/null
+++ b/ms-MY/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Anda boleh [melangkau terus dari bahagian ini](http://tutorial.djangogirls.org/en/installation/#install-python) jika anda tidak menggunakan Chromebook. Sekiranya anda berada, pengalaman pemasangan anda akan sedikit berbeza. Anda boleh mengabaikan sisa arahan pemasangan.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE adalah alat yang meyediakan penyunting kod dan akses kepada komputer yang digunakan di Internet dimana anda boleh memasang, menulis, dan menggunakan perisian. Semasa tempoh tutorial, Cloud IDE akan bertindak sebagai *local machine* anda. Anda masih akan menjalankan arahan dalam antaramuka terminal seperti rakan sekelas anda di OS X, Ubuntu, atau Windows, tetapi terminal anda akan disambungkan kepada sebuah komputer yang berada di tempat lain yang telah disediakan oleh cloud IDE untuk anda. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Anda boleh memilih salah satu diantara cloud IDEs berikut, dan mengikut arahan cloud IDE tersebut.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Persekitaran Maya
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ms-MY/code_editor/README.md b/ms-MY/code_editor/README.md
new file mode 100644
index 00000000000..6524a7c0402
--- /dev/null
+++ b/ms-MY/code_editor/README.md
@@ -0,0 +1,11 @@
+# Penyunting Kod
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+Anda akan mula menaip barisan kod anda yang pertama, jadi tiba masanya untuk muat turun Penyunting Kod!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ms-MY/code_editor/instructions.md b/ms-MY/code_editor/instructions.md
new file mode 100644
index 00000000000..9d14c34dd45
--- /dev/null
+++ b/ms-MY/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Terdapat banyak penyunting yang berbeza dan kebanyakannya bergantung kepada pilihan peribadi. Kebanyakan pengaturcara Python menggunakan IDE (Integrated Development Environment) atau Persekitaran Pembangunan Bersepadu yang kompleks tetapi hebat, seperti PyCharm. Walau bagaimanapun, bagi seseorang yang baru mula belajar, ini mungkin kurang sesuai; oleh itu kami memberikan beberapa cadangan yang sama hebat tetapi lebih mudah.
+
+Cadangan kami di bawah, tetapi berasa bebas untuk meminta jurulatih anda apa yang mereka suka - ia akan lebih mudah untuk mendapatkan bantuan daripada mereka.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Muat turun di sini](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Muat turun di sini](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Muat turun di sini](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ms-MY/css/README.md b/ms-MY/css/README.md
new file mode 100644
index 00000000000..114479b087f
--- /dev/null
+++ b/ms-MY/css/README.md
@@ -0,0 +1,330 @@
+# CSS - menjadikannya cantik!
+
+Blog kita masih kelihatan hodoh, betul? Masa untuk menjadikannya cantik! Kami akan menggunakan CSS untuk itu.
+
+## Apakah CSS?
+
+Cascading Style Sheets (CSS) adalah bahasa yang digunakan untuk menggambarkan rupa dan pemformatan laman web yang ditulis dalam bahasa markup (seperti HTML). Rawat ia sebagai make-up untuk laman web kami. ;)
+
+Tetapi kita tidak mahu bermula dari awal lagi, bukan? Sekali lagi, kami akan menggunakan sesuatu yang dilancarkan oleh programmer di Internet secara percuma. Menghidupkan semula roda tidak menyenangkan, anda tahu.
+
+## Mari kita gunakan Bootstrap!
+
+Bootstrap adalah salah satu kerangka kerja HTML dan CSS yang paling populer untuk mengembangkan situs web yang indah: https://getbootstrap.com/
+
+Ia ditulis oleh pengaturcara yang bekerja untuk Twitter. Kini ia dibangunkan oleh sukarelawan dari seluruh dunia!
+
+## Memasang Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Rajah 14.1](images/bootstrap1.png)
+
+Kelihatan lebih cantik!
+
+## Fail Statik dalam Django
+
+Akhir sekali, kita akan melihat dengan lebih dekat kepada **fail-fail statik**. Fail statik adalah semua CSS dan imej anda. Kandungan mereka tidak bergantung pada konteks permintaan dan akan sama bagi setiap pengguna.
+
+### Di mana meletakkan fail-fail statik untuk Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+Kita melaksanakannya dengan mencipta folder yang dipanggil `statik` di dalam aplikasi blog ini:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django secara automatik akan mencari folder yang dipanggil "statik" dalam folder folder apl anda. Kemudian ia akan dapat menggunakan kandungannya sebagai fail statik.
+
+## Fail CSS anda yang pertama!
+
+Mari buat fail CSS sekarang, untuk menambah gaya anda sendiri ke halaman web anda. Cipta satu direktori baru yang dipanggil `css` dalam direktori `statik`. Kemudian cipta fail baru yang dipanggil `blog.css` di dalam direktori `css`. Sedia?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Masa untuk menulis beberapa CSS! Buka fail `blog/static/css/blog.css` dalam Penyunting kod anda.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+Tetapi mari kita lakukan sekurang-kurangnya sedikit. Maybe we could change the color of our headers? Untuk memahami warna, komputer menggunakan kod khas. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. Anda juga boleh menggunakan [warna-warna yang telah ditetapkan](http://www.w3schools.com/colors/colors_names.asp), seperti `red` dan `green`.
+
+Dalam fail `blog/static/css/blog.css`, anda perlu menambah kod berikut:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` adalah Pilihan CSS. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+Di dalam sebuah fail CSS, kita tentukan gaya bagi unsur-unsur dalam fail HTML. Cara pertama kami mengenal pasti elemen adalah dengan nama elemen. Anda mungkin ingat ini sebagai tanda dari bahagian HTML. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class dan id adalah nama-nama yang anda berikan pada unsur sendiri. Kelas menentukan kumpulan elemen, dan id titik untuk unsur-unsur tertentu. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Pelayar membaca fail dalam perintah mereka diberikan, jadi kami harus memastikan kalau semua ini adalah di tempat yang tepat. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+File anda sekarang harus kelihatan seperti ini:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, simpan file dan refresh situsnya
+
+![Rajah 14.2](images/color2.png)
+
+Kerja yang bagus! Mungkin kita juga ingin memberi kami web sedikit udara dan meningkatkan margin di sebelah kiri? Mari kita coba yang ini!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Tambah yang anda CSS, simpan fail dan melihat bagaimana ia berfungsi!
+
+![Rajah 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Rajah 14.3](images/font.png)
+
+Great!
+
+Seperti kekurangan di atas, CSS memiliki konsep kelas. Ini membolehkan anda menamakan sebahagian daripada kod HTML dan menggunakan gaya hanya untuk bahagian ini, tanpa menjejaskan bahagian lain. Ini boleh menjadi sangat membantu! Mungkin anda mempunyai dua div yang melakukan sesuatu yang berbeza (seperti header dan pos anda). Kelas boleh membantu anda membuat mereka kelihatan berbeza.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Sekarang kita akan menambah deklarasi blok untuk berbeza pemilih. Selectors starting with `.` relate to classes. Ada banyak tutorial dan penjelasan mengenai CSS di Web yang boleh membantu kau mengerti berikut kod. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Kemudian mengelilingi HTML kod yang memaparkan catatan dengan deklarasi kelas. Menggantikan ini:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Simpan fail tersebut dan muat semula laman web anda.
+
+![Rajah 14.4](images/final.png)
+
+Woohoo! Nampak hebat, kan? Melihat kod kita hanya disisipkan untuk mencari tempat di mana kita ditambah kelas di HTML dan menggunakan mereka dalam CSS. Di mana anda akan membuat perubahan jika anda ingin tarikh untuk menjadi biru?
+
+Jangan takut untuk bermain-main dengan CSS ini sedikit dan cuba untuk mengubah beberapa hal. Bermain dengan CSS boleh membantu anda untuk memahami apa yang perkara-perkara yang berbeza lakukan. Jika anda memecahkan sesuatu, jangan khawatir – anda sentiasa boleh membatalkannya!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Sedia untuk bab seterusnya ?! :)
\ No newline at end of file
diff --git a/ms-MY/deploy/README.md b/ms-MY/deploy/README.md
new file mode 100644
index 00000000000..5bf7f6816b8
--- /dev/null
+++ b/ms-MY/deploy/README.md
@@ -0,0 +1,246 @@
+# Menyebarkan!
+
+> **Nota** Bab berikut kadang-kadang agak sukar untuk diteruskan. Terus dan selesaikannya; penyebaran adalah bahagian penting dalam proses pembangunan laman web. Bab ini diletakkan di tengah-tengah tutorial supaya mentor anda dapat membantu dengan proses yang lebih rumit untuk mendapatkan laman web anda dalam talian. Ini bermakna anda masih boleh menyelesaikan tutorial anda sendiri jika anda kehabisan masa.
+
+Hingga kini, laman web anda hanya tersedia di komputer anda. Kini anda akan belajar bagaimana untuk menggunakannya! Menyebarkan adalah proses menerbitkan aplikasi anda di Internet supaya orang akhirnya boleh pergi dan melihat aplikasi anda. :)
+
+Seperti yang anda pelajari, tapak web harus ditempatkan di pelayan. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. Terdapat orang lain di luar sana, tetapi hampir semua pengaturcara mempunyai akaun GitHub hari ini, dan kini begitu juga anda!
+
+Ketiga tempat ini akan menjadi penting bagi anda. Komputer tempatan anda akan menjadi tempat di mana anda melakukan pembangunan dan ujian. Apabila anda berpuas hati dengan perubahan, anda akan meletakkan salinan program anda di GitHub. Laman web anda akan berada di PythonAnywhere dan anda akan mengemas kini dengan mendapatkan salinan baru kod anda dari GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Memulakan repositori Git kami
+
+Git menjejaki perubahan pada satu set fail tertentu dalam apa yang dipanggil repositori kod (atau "repo" untuk pendek). Mari kita mulakan projek kami. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Memulakan repositori git adalah sesuatu yang perlu kita lakukan hanya sekali bagi setiap projek (dan anda tidak perlu memasukkan semula nama pengguna dan email sekali lagi).
+
+Git akan menjejaki perubahan kepada semua fail dan folder dalam direktori ini, tetapi terdapat beberapa fail yang kami mahu ia diabaikan. We do this by creating a file called `.gitignore` in the base directory. Buka editor anda dan buat fail baru dengan kandungan berikut:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! Jika anda mengalami sebarang kesulitan menciptanya (Mac tidak menyukai anda untuk membuat fail yang bermula dengan titik melalui Finder, sebagai contoh), kemudian gunakan ciri "Simpan Sebagai" dalam editor anda; ia peluru. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. Anda perlu memikirkan pangkalan data tempatan anda sebagai taman permainan yang bagus di mana anda boleh menguji perkara yang berbeza dan jangan takut bahawa anda akan memadamkan siaran sebenar anda dari blog anda.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. Ini akan membantu menghalang sebarang kejutan daripada berlaku, seperti fail salah yang ditambah atau dilakukan. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. Keluaran harus sama dengan yang berikut:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Dan akhirnya kami menyelamatkan perubahan kami. Pergi ke konsol anda dan jalankan arahan ini:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/ms-MY/deploy/install_git.md b/ms-MY/deploy/install_git.md
new file mode 100644
index 00000000000..4bd17e0f292
--- /dev/null
+++ b/ms-MY/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git adalah "sistem kawalan versi" yang digunakan oleh banyak pengaturcara. Perisian ini boleh menjejaki perubahan pada fail dari semasa ke semasa supaya anda boleh mengimbas kembali versi tertentu kemudian. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Memasang Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Anda boleh memuat turun Git dari [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Selain itu, yang tertera adalah baik. Cuba lihat gaya-Windows, cara pengakhiran gaya-Unix adalah baik.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ms-MY/deploy/signup_pythonanywhere.md b/ms-MY/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/ms-MY/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ms-MY/django/README.md b/ms-MY/django/README.md
new file mode 100644
index 00000000000..76707b63d66
--- /dev/null
+++ b/ms-MY/django/README.md
@@ -0,0 +1,27 @@
+# Apa itu Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. Rangka kerja web adalah satu set komponen yang membantu anda mengembangkan laman web dengan lebih cepat dan lebih mudah.
+
+Apabila anda membina laman web, anda sentiasa memerlukan set komponen yang serupa: cara untuk mengendalikan pengesahan pengguna (mendaftar, melog masuk, melog masuk), panel pengurusan untuk laman web anda, borang, cara untuk memuat naik fail, dan lain-lain.
+
+Nasib baik untuk anda, orang lain lama dahulu menyedari bahawa pembangun web menghadapi masalah yang sama ketika membina laman web baru, jadi mereka bekerja sama dan membuat kerangka kerja (Django menjadi salah satu dari mereka) yang memberikan komponen siap pakai untuk digunakan.
+
+Rangka kerja ada untuk menyelamatkan anda daripada mencipta semula roda dan membantu mengurangkan beberapa overhead apabila anda sedang membina laman web baru.
+
+## Mengapa anda memerlukan rangka kerja?
+
+Untuk memahami apa sebenarnya Django, kita perlu melihat lebih dekat pada pelayan. Perkara pertama adalah bahawa pelayan perlu tahu bahawa anda mahu ia melayani anda halaman web.
+
+Bayangkan peti mel (port) yang dipantau untuk surat masuk ( permintaan ). Ini dilakukan oleh pelayan web. Pelayan web membaca surat itu dan kemudian menghantar respons dengan halaman web. Tetapi apabila anda mahu menghantar sesuatu, anda perlu mempunyai beberapa kandungan. Dan Django adalah sesuatu yang membantu anda membuat kandungan.
+
+## Apa yang berlaku apabila seseorang meminta tapak web dari pelayan anda?
+
+Apabila permintaan datang ke pelayan web, ia diluluskan kepada Django yang cuba memikirkan apa yang sebenarnya diminta. Ia mengambil alamat laman web terlebih dahulu dan cuba mencari tahu apa yang harus dilakukan. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). Ia tidak terlalu pintar - ia memerlukan senarai corak dan cuba memadankan URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Bayangkan pembawa mel dengan surat. Dia sedang berjalan di jalan dan memeriksa setiap nombor rumah di atas surat itu. Sekiranya ia sepadan, dia meletakkan surat itu di sana. Inilah cara kerja urlresolver!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Mungkin pengguna diminta mengubah sesuatu dalam data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/ms-MY/django_admin/README.md b/ms-MY/django_admin/README.md
new file mode 100644
index 00000000000..65deae6125c
--- /dev/null
+++ b/ms-MY/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+Untuk menambah, edit dan padamkan siaran kami baru saja dimodelkan, kita akan menggunakan Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Seperti yang anda boleh lihat, kita import (termasuk) Pos model didefinisikan dalam bab sebelumnya. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, masa untuk melihat model Pos kami. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. Anda akan melihat halaman login seperti ini:
+
+![Halaman log masuk](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Ingat, untuk tulis arahan baru ketika pelayan web adalah berjalan, buka terminal baru jendela dan mengaktifkan anda virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ms-MY/django_forms/README.md b/ms-MY/django_forms/README.md
new file mode 100644
index 00000000000..0af4aacf355
--- /dev/null
+++ b/ms-MY/django_forms/README.md
@@ -0,0 +1,479 @@
+# Borang Django
+
+Hal terakhir yang kita ingin lakukan di website kami menciptakan sebuah cara yang bagus untuk menambahkan dan mengedit posting blog. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Akhirnya, kita dapat mengatakan yang bidang(s) harus berakhir di formulir kami. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+Jadi sekali lagi kita akan membuat link ke halaman, URL, pandangan dan template.
+
+## Pautan ke halaman dengan borang
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## paparan post_new
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+dari .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Templat
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. Ini sangat penting, kerana ia menjadikan borang anda selamat! Sekiranya anda melupakan sedikit ini, Django akan mengeluh apabila anda cuba menyelamatkan borang:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Menyimpan borang
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Pengesahan borang
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit borang
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Satu lagi perkara: menggunakan masa!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ms-MY/django_installation/README.md b/ms-MY/django_installation/README.md
new file mode 100644
index 00000000000..4a4a8717d98
--- /dev/null
+++ b/ms-MY/django_installation/README.md
@@ -0,0 +1,7 @@
+# Pemasangan Django
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ms-MY/django_installation/instructions.md b/ms-MY/django_installation/instructions.md
new file mode 100644
index 00000000000..01e7cd52949
--- /dev/null
+++ b/ms-MY/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Persekitaran maya
+
+Sebelum memasang Django, kami akan memasang alat yang sangat berguna untuk membantu mengekalkan persekitaran pengekodan anda pada komputer anda. Ada kemungkinan untuk melangkau langkah ini, tetapi sangat disyorkan. Bermula dengan persediaan yang terbaik akan menjimatkan banyak masalah pada masa akan datang!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv akan mengasingkan persediaan Python / Django anda secara per-projek. Ini bermakna bahawa apa-apa perubahan yang anda buat ke satu laman web tidak akan menjejaskan mana-mana orang lain yang anda sedang berkembang. Rapi, betul?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. Anda boleh menggunakan nama lain, tetapi melekat pada huruf kecil dan tidak menggunakan ruang, aksen atau aksara khusus. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. Anda boleh menggunakan nama lain, tetapi melekat pada huruf kecil dan jangan gunakan ruang. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> kemudian alihkan:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ms-MY/django_models/README.md b/ms-MY/django_models/README.md
new file mode 100644
index 00000000000..386387f3df9
--- /dev/null
+++ b/ms-MY/django_models/README.md
@@ -0,0 +1,201 @@
+# Django model
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. Idea ini adalah bahawa bukannya menulis segala-galanya sebagai urutan arahan pengaturcaraan yang membosankan, kita boleh memodelkan sesuatu dan menentukan bagaimana mereka berinteraksi antara satu sama lain.
+
+Jadi apa benda? Ia adalah koleksi sifat dan tindakan. Kedengarannya aneh, tetapi kami akan memberikan contoh kepada anda.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+Bagaimana kita akan model blog itu? Kami ingin membangun sebuah blog, kan?
+
+Kita perlu menjawab soalan: Apakah blog pos? Apa sifat harus ia telah?
+
+Yah, pasti blog post kita memerlukan beberapa teks dengan kandungan dan judul, kan? Ia juga akan menjadi bagus untuk tahu siapa yang menulisnya – jadi kita perlu seorang penulis. Akhirnya, kita ingin tahu apabila pos diciptakan dan diterbitkan.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Kerana kita sudah tahu apa yang kita ingin mencapai, mari kita mulakan model dalam Django!
+
+## Django model
+
+Mengetahui apa objek itu, kita boleh buat Django model untuk blog post kita.
+
+A model in Django is a special kind of object – it is saved in the `database`. Pangkalan data adalah koleksi data. Ini adalah tempat di mana anda akan menyimpan maklumat tentang pengguna, blog anda, dan lain-lain. Kita akan menggunakan Lihat pangkalan data untuk menyimpan data kami. Ini adalah default Django pangkalan data adaptor – ia akan menjadi cukup untuk kita sekarang.
+
+Anda bisa memikirkan model dalam pangkalan data sebagai hamparan dengan ruangan (bidang) dan baris (data).
+
+### Membuat permohonan
+
+Untuk memastikan semuanya kemas, kita akan membuat permohonan yang berasingan di dalam projek kami. Hal ini sangat baik untuk memiliki semua dianjurkan dari awal. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Membuat pos blog model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. Konvensyen ini sering digunakan dalam Python dan kadang-kadang kita juga memanggil mereka "dunder" (pendek untuk "double-menekankan").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Membuat meja untuk model dalam pangkalan data anda
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ms-MY/django_orm/README.md b/ms-MY/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/ms-MY/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ms-MY/django_start_project/README.md b/ms-MY/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/ms-MY/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ms-MY/django_templates/README.md b/ms-MY/django_templates/README.md
new file mode 100644
index 00000000000..ae5b8ab824b
--- /dev/null
+++ b/ms-MY/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Rajah 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Rajah 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Rajah 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ms-MY/django_urls/README.md b/ms-MY/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/ms-MY/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ms-MY/django_views/README.md b/ms-MY/django_views/README.md
new file mode 100644
index 00000000000..60e6ad3ef6f
--- /dev/null
+++ b/ms-MY/django_views/README.md
@@ -0,0 +1,44 @@
+# Pemandangan Django - Masa untuk bina!
+
+Masa untuk lepaskan kesalahan yang telah kita bina dalam bab yang terakhir!:)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ms-MY/dynamic_data_in_templates/README.md b/ms-MY/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/ms-MY/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ms-MY/extend_your_application/README.md b/ms-MY/extend_your_application/README.md
new file mode 100644
index 00000000000..3e3e519c5cf
--- /dev/null
+++ b/ms-MY/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Melanjutkan permohonan anda
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Membuat template link ke pos detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Mencipta sebuah URL ke sebuah butiran pos
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Tambah post melihat butiran
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ms-MY/how_the_internet_works/README.md b/ms-MY/how_the_internet_works/README.md
new file mode 100644
index 00000000000..ee93a6ea095
--- /dev/null
+++ b/ms-MY/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Bagaimana Internet berfungsi
+
+> Untuk pembaca di rumah: bab ini adalah dilindungi dalam [Bagaimana Internet Berfungsi](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+Kami yakin anda menggunakan Internet setiap hari. Tapi apakah anda benar-benar tahu apa yang terjadi ketika anda jenis alamat seperti https://djangogirls.org ke pelayar anda dan tekan `masuk`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browser direka untuk memahami kode ini, mengikut arahan, dan sekarang ini fail bahawa laman web anda dibuat, persis seperti yang anda inginkan.
+
+Seperti dengan setiap file, kita perlu simpan fail HTML di suatu tempat di hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Rajah 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! Anda boleh mengunjungi sebuah kapal Selam Kabel Peta website (http://submarinecablemap.com) untuk melihat bagaimana rumit bersih. Here is a screenshot from the website:
+
+![Rajah 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. Jadi, untuk mencapai satu mesin (sebagai contoh, satu di mana https://djangogirls.org disimpan) kita perlu lulus permintaan melalui banyak, banyak mesin yang berbeza.
+
+It looks like this:
+
+![Rajah 1.3](images/internet_2.png)
+
+Bayangkan bahwa ketika anda jenis https://djangogirls.org, yang anda kirim surat yang mengatakan: "Dear Django Girls, aku ingin melihat djangogirls.org web. Kirimkan ke saya, silakan!"
+
+Your letter goes to the post office closest to you. Kemudian ia pergi untuk yang lain, yang sedikit lebih dekat dengan anda penerima, kemudian yang lain, dan lain sehingga ia dihantar di destinasi. Satu-satunya yang unik adalah bahawa jika anda banyak mengirim surat (*paket data*) ke tempat yang sama, mereka bisa pergi melalui benar-benar berbeza pejabat pos (*penghala*). This depends on how they are distributed at each office.
+
+![Rajah 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Bukan alamat dengan nama jalan, bandar, zip code dan nama negara, kami menggunakan alamat IP. Komputer pertama meminta DNS (Nama Domain Sistem) untuk menterjemahkan djangogirls.org ke alamat IP. Ia berfungsi sedikit seperti lama buku telefon di mana anda boleh melihat ke atas nama orang yang anda mahu untuk menghubungi dan mencari mereka nomor telepon dan alamat.
+
+Ketika anda mengirimkan surat, ia perlu mempunyai ciri-ciri tertentu yang akan dihantar dengan betul: alamat, perangko, dan lain-lain. Kau juga menggunakan bahasa yang penerima memahami, kan? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. Ketika kau mengirim seorang tindak balas, anda tidak selalu ingin menghantar hal yang sama untuk semua orang. Ia adalah jauh lebih baik jika surat-surat anda adalah peribadi, terutama untuk orang yang telah ditulis untuk anda, kan? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ms-MY/html/README.md b/ms-MY/html/README.md
new file mode 100644
index 00000000000..96b2449c391
--- /dev/null
+++ b/ms-MY/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Rajah 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Rajah 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Rajah 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Rajah 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ms-MY/installation/README.md b/ms-MY/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/ms-MY/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ms-MY/intro_to_command_line/README.md b/ms-MY/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/ms-MY/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ms-MY/intro_to_command_line/open_instructions.md b/ms-MY/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/ms-MY/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ms-MY/python_installation/README.md b/ms-MY/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/ms-MY/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ms-MY/python_installation/instructions.md b/ms-MY/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/ms-MY/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ms-MY/python_introduction/README.md b/ms-MY/python_introduction/README.md
new file mode 100644
index 00000000000..583a09d2234
--- /dev/null
+++ b/ms-MY/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ms-MY/template_extending/README.md b/ms-MY/template_extending/README.md
new file mode 100644
index 00000000000..e7ec0824d28
--- /dev/null
+++ b/ms-MY/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template melanjutkan
+
+Satu lagi perkara yang baik Django telah untuk anda **template melanjutkan**. Apa artinya ini? Ia bermakna bahawa anda boleh menggunakan yang sama bahagian HTML anda untuk halaman laman web anda.
+
+Template membantu ketika anda ingin menggunakan maklumat yang sama atau atur dalam lebih daripada di satu tempat. Anda tidak perlu mengulangi sendiri dalam setiap fail. Dan jika anda ingin mengubah sesuatu, anda tidak perlu melakukannya dalam setiap template, hanya satu!
+
+## Membuat pangkalan template
+
+Pangkalan template yang paling asas template yang anda melanjutkan pada setiap halaman laman web anda.
+
+Mari kita buat `base.html` fail dalam `blog/templates/blog/`:
+
+    blog
+    └───template
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Kemudian dalam `base.html`, menggantikan anda keseluruhan `<body>` (segala sesuatu di antara `<body>` dan `</body>`) dengan ini:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Anda mungkin melihat ini digantikan segala-galanya dari `{% for post in posts %}` to `{% endfor %}` dengan: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Tapi mengapa? Anda hanya mencipta `blok`! Anda digunakan tag template `{% block %}` untuk membuat kawasan yang akan HTML dimasukkan di dalamnya. Itu HTML akan datang dari template lain yang memanjang template ini (`base.html`). Kami akan menunjukkan anda bagaimana untuk melakukan ini dalam sekejap.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}Kau akan membuang semuanya di atas `{% for post in posts %}` dan di bawah `{% endfor %}`. Apabila anda selesai, fail akan kelihatan seperti ini:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Kita ingin untuk menggunakan ini sebagai sebahagian daripada template kami untuk semua kandungan blok. Masa untuk menambah blok tag ini fail!
+
+{% raw %}Anda ingin blok anda tag untuk perlawanan tag anda `base.html` fail. Anda juga ingin termasuk semua kod milik dalam kandungan anda blok. Untuk melakukan itu, letakkan segala sesuatu di antara `{% block content %}` dan `{% endblock %}`. Seperti ini:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Hanya satu hal yang tersisa. Kita perlu untuk menyambung dua template bersama-sama. Ini adalah apa yang melanjutkan template adalah semua tentang! Kita akan melakukan ini dengan menambah memanjangkan tag untuk awal fail. Seperti ini:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> Jika anda mendapatkan ralat `TemplateDoesNotExist`, itu berarti bahwa tidak ada `blog/base.html` file dan anda telah `runserver` berjalan di konsol. Mencoba untuk menghentikannya (dengan menekan Ctrl+C – Kawalan dan C kunci bersama-sama) dan mulakan semula oleh berjalan `python menguruskan.dengan salinan runserver` perintah.
\ No newline at end of file
diff --git a/ms-MY/whats_next/README.md b/ms-MY/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/ms-MY/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/ms/GLOSSARY.md b/ms/GLOSSARY.md
new file mode 100644
index 00000000000..56c09af366b
--- /dev/null
+++ b/ms/GLOSSARY.md
@@ -0,0 +1,3 @@
+# penyunting Kod
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/ms/README.md b/ms/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/ms/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ms/SUMMARY.md b/ms/SUMMARY.md
new file mode 100644
index 00000000000..68d0f929f52
--- /dev/null
+++ b/ms/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Penyunting Kod](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/ms/chromebook_setup/README.md b/ms/chromebook_setup/README.md
new file mode 100644
index 00000000000..863fa8136d2
--- /dev/null
+++ b/ms/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Persediaan Chromebook
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ms/chromebook_setup/instructions.md b/ms/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..4614153689e
--- /dev/null
+++ b/ms/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. Sekiranya anda berada, pengalaman pemasangan anda akan sedikit berbeza. Anda boleh mengabaikan sisa arahan pemasangan.
+
+### Awan 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. Anda masih akan menjalankan arahan dalam antara muka terminal seperti rakan sekelas anda di OS X, Ubuntu, atau Windows, tetapi terminal anda akan disambungkan ke komputer yang berjalan di tempat lain yang Awan 9 menetapkan untuk anda.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Daftar untuk akaun
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Sekarang anda perlu melihat antara muka dengan bar sisi, tetingkap utama yang besar dengan beberapa teks, dan tetingkap kecil di bahagian bawah yang kelihatan seperti ini:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Persekitaran Maya
+
+Persekitaran maya (juga dipanggil virtualenv) adalah seperti kotak peribadi yang boleh kita buat kod komputer berguna untuk projek yang sedang kita kerjakan. Kami menggunakannya untuk menyimpan pelbagai bit kod yang kami mahukan untuk pelbagai projek kami yang berasingan supaya perkara tidak dapat bercampur antara projek.
+
+Di terminal anda di bahagian bawah antara muka awan 9, jalankan yang berikut:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    kemas kini sudo apt
+    sudo apt install python3.6-venv
+    
+
+Jika ini masih tidak berfungsi, tanya jurulatih anda untuk mendapatkan bantuan.
+
+Seterusnya, jalankan:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(ambil perhatian bahawa pada baris terakhir kita menggunakan tilde diikuti dengan tanda yang sama: ~ =).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+Tutorial Django Girls merangkumi seksyen tentang apa yang disebut Deployment, yang merupakan proses mengambil kod yang menguatkan aplikasi web baru anda dan mengalihkannya ke komputer yang boleh diakses secara umum (dipanggil pelayan) supaya orang lain dapat melihat karya anda.
+
+Bahagian ini agak aneh apabila melakukan tutorial pada Chromebook kerana kami sudah menggunakan komputer yang ada di Internet (berbanding dengan, katakan, komputer riba). Walau bagaimanapun, ia masih berguna, kerana kita boleh memikirkan ruang kerja awan 9 kami sebagai tempat atau kerja "sedang berjalan" kami dan Python Anywhere sebagai tempat untuk memaparkan barangan kami kerana ia menjadi lebih lengkap.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ms/code_editor/README.md b/ms/code_editor/README.md
new file mode 100644
index 00000000000..35d6beb93b0
--- /dev/null
+++ b/ms/code_editor/README.md
@@ -0,0 +1,11 @@
+# Penyunting Kod
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+Anda akan mula menaip barisan kod anda yang pertama, jadi tiba masanya untuk muat turun Penyunting Kod!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ms/code_editor/instructions.md b/ms/code_editor/instructions.md
new file mode 100644
index 00000000000..4ae7996de97
--- /dev/null
+++ b/ms/code_editor/instructions.md
@@ -0,0 +1,31 @@
+Terdapat banyak penyunting yang berbeza dan kebanyakannya bergantung kepada pilihan peribadi. Kebanyakan pengaturcara Python menggunakan IDE (Integrated Development Environment) atau Persekitaran Pembangunan Bersepadu yang kompleks tetapi hebat, seperti PyCharm. Walau bagaimanapun, bagi seseorang yang baru mula belajar, ini mungkin kurang sesuai; oleh itu kami memberikan beberapa cadangan yang sama hebat tetapi lebih mudah.
+
+Cadangan kami di bawah, tetapi berasa bebas untuk meminta jurulatih anda apa yang mereka suka - ia akan lebih mudah untuk mendapatkan bantuan daripada mereka.
+
+## Gedit
+
+Gedit merupakan penyunting sumber terbuka yang percuma, disediakan untuk semua sistem operasi.
+
+[Muat turun di sini](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Muat turun di sini](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Muat turun di sini](https://atom.io/)
+
+## Mengapa kita memerlukan Penyunting Kod?
+
+Anda mungkin tertanya-tanya mengapa kami memasang perisian Penyunting Kod khas ini, dan bukannya menggunakan perisian seperti Word atau Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+Alasan kedua adalah bahawa editor kod khusus untuk kod penyuntingan, sehingga mereka dapat memberikan ciri-ciri berguna seperti menyoroti kod dengan warna mengikut maknanya, atau tanda kutip secara automatik untuk anda.
+
+Kita akan lihat semua ini dalam tindakan kemudian. Tidak lama lagi, anda akan memikirkan editor kod lama anda yang dipercayai sebagai salah satu alat kegemaran anda. :)
\ No newline at end of file
diff --git a/ms/css/README.md b/ms/css/README.md
new file mode 100644
index 00000000000..b8f0a50baa1
--- /dev/null
+++ b/ms/css/README.md
@@ -0,0 +1,304 @@
+# CSS - menjadikannya cantik!
+
+Blog kita masih kelihatan hodoh, betul? Masa untuk menjadikannya cantik! Kami akan menggunakan CSS untuk itu.
+
+## Apakah CSS?
+
+Cascading Style Sheets (CSS) adalah bahasa yang digunakan untuk menggambarkan rupa dan pemformatan laman web yang ditulis dalam bahasa markup (seperti HTML). Rawat ia sebagai make-up untuk laman web kami. ;)
+
+Tetapi kita tidak mahu bermula dari awal lagi, bukan? Sekali lagi, kami akan menggunakan sesuatu yang dilancarkan oleh programmer di Internet secara percuma. Menghidupkan semula roda tidak menyenangkan, anda tahu.
+
+## Mari kita gunakan Bootstrap!
+
+Bootstrap adalah salah satu kerangka kerja HTML dan CSS yang paling populer untuk mengembangkan situs web yang indah: https://getbootstrap.com/
+
+Ia ditulis oleh pengaturcara yang bekerja untuk Twitter. Kini ia dibangunkan oleh sukarelawan dari seluruh dunia!
+
+## Memasang Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+Ini tidak menambah sebarang fail pada projek anda. Ia hanya menunjuk kepada fail yang wujud di Internet. Teruskan saja, buka laman web anda dan muat semula halaman. Ini dia!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Kelihatan lebih cantik!
+
+## Fail Statik dalam Django
+
+Akhir sekali, kita akan melihat dengan lebih dekat kepada **fail-fail statik**. Fail statik adalah semua CSS dan imej anda. Kandungan mereka tidak bergantung pada konteks permintaan dan akan sama bagi setiap pengguna.
+
+### Di mana meletakkan fail-fail statik untuk Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+Kita melaksanakannya dengan mencipta folder yang dipanggil `statik` di dalam aplikasi blog ini:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django secara automatik akan mencari folder yang dipanggil "statik" dalam folder folder apl anda. Kemudian ia akan dapat menggunakan kandungannya sebagai fail statik.
+
+## Fail CSS anda yang pertama!
+
+Mari buat fail CSS sekarang, untuk menambah gaya anda sendiri ke halaman web anda. Cipta satu direktori baru yang dipanggil `css` dalam direktori `statik`. Kemudian cipta fail baru yang dipanggil `blog.css` di dalam direktori `css`. Sedia?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Masa untuk menulis beberapa CSS! Buka fail `blog/static/css/blog.css` dalam Penyunting kod anda.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+Tetapi mari kita lakukan sekurang-kurangnya sedikit. Mungkin kita boleh menukar warna header? Untuk memahami warna, komputer menggunakan kod khas. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. Anda juga boleh menggunakan [warna-warna yang telah ditetapkan](http://www.w3schools.com/colors/colors_names.asp), seperti `red` dan `green`.
+
+Dalam fail `blog/static/css/blog.css`, anda perlu menambah kod berikut:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` adalah Pilihan CSS. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. Dalam kes ini, kita sedang memberitahunya untuk menukar warna kepada `#FCA205`, iaitu warna oren. Sudah tentu, anda boleh meletakkan warna anda sendiri di sini!
+
+Di dalam sebuah fail CSS, kita tentukan gaya bagi unsur-unsur dalam fail HTML. Cara pertama kami mengenal pasti elemen adalah dengan nama elemen. Anda mungkin ingat ini sebagai tanda dari bahagian HTML. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class dan id adalah nama-nama yang anda berikan pada unsur sendiri. Kelas menentukan kumpulan elemen, dan id titik untuk unsur-unsur tertentu. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Pelayar membaca fail dalam perintah mereka diberikan, jadi kami harus memastikan kalau semua ini adalah di tempat yang tepat. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+File anda sekarang harus kelihatan seperti ini:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, simpan file dan refresh situsnya
+
+![Rajah 14.2](images/color2.png)
+
+Kerja yang bagus! Mungkin kita juga ingin memberi kami web sedikit udara dan meningkatkan margin di sebelah kiri? Mari kita coba yang ini!
+
+{% filename%} blog / static / css / blog.css {% endfilename%}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Tambah yang anda CSS, simpan fail dan melihat bagaimana ia berfungsi!
+
+![Rajah 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+Seperti kekurangan di atas, CSS memiliki konsep kelas. Ini membolehkan anda menamakan sebahagian daripada kod HTML dan menggunakan gaya hanya untuk bahagian ini, tanpa menjejaskan bahagian lain. Ini boleh menjadi sangat membantu! Mungkin anda mempunyai dua div yang melakukan sesuatu yang berbeza (seperti header dan pos anda). Kelas boleh membantu anda membuat mereka kelihatan berbeza.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+Sekarang kita akan menambah deklarasi blok untuk berbeza pemilih. Selectors starting with `.` relate to classes. Ada banyak tutorial dan penjelasan mengenai CSS di Web yang boleh membantu kau mengerti berikut kod. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Kemudian mengelilingi HTML kod yang memaparkan catatan dengan deklarasi kelas. Menggantikan ini:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Simpan fail tersebut dan muat semula laman web anda.
+
+![Rajah 14.4](images/final.png)
+
+Woohoo! Nampak hebat, kan? Melihat kod kita hanya disisipkan untuk mencari tempat di mana kita ditambah kelas di HTML dan menggunakan mereka dalam CSS. Di mana anda akan membuat perubahan jika anda ingin tarikh untuk menjadi biru?
+
+Jangan takut untuk bermain-main dengan CSS ini sedikit dan cuba untuk mengubah beberapa hal. Bermain dengan CSS boleh membantu anda untuk memahami apa yang perkara-perkara yang berbeza lakukan. Jika anda memecahkan sesuatu, jangan khawatir – anda sentiasa boleh membatalkannya!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). Ia boleh membantu anda mempelajari semua tentang membuat anda laman web lebih cantik dengan CSS.
+
+Sedia untuk bab seterusnya ?! :)
\ No newline at end of file
diff --git a/ms/deploy/README.md b/ms/deploy/README.md
new file mode 100644
index 00000000000..eb7025dcd44
--- /dev/null
+++ b/ms/deploy/README.md
@@ -0,0 +1,258 @@
+# Menyebarkan!
+
+> **Nota** Bab berikut kadang-kadang agak sukar untuk diteruskan. Terus dan selesaikannya; penyebaran adalah bahagian penting dalam proses pembangunan laman web. Bab ini diletakkan di tengah-tengah tutorial supaya mentor anda dapat membantu dengan proses yang lebih rumit untuk mendapatkan laman web anda dalam talian. Ini bermakna anda masih boleh menyelesaikan tutorial anda sendiri jika anda kehabisan masa.
+
+Hingga kini, laman web anda hanya tersedia di komputer anda. Kini anda akan belajar bagaimana untuk menggunakannya! Menyebarkan adalah proses menerbitkan aplikasi anda di Internet supaya orang akhirnya boleh pergi dan melihat aplikasi anda. :)
+
+Seperti yang anda pelajari, tapak web harus ditempatkan di pelayan. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. Terdapat orang lain di luar sana, tetapi hampir semua pengaturcara mempunyai akaun GitHub hari ini, dan kini begitu juga anda!
+
+Ketiga tempat ini akan menjadi penting bagi anda. Komputer tempatan anda akan menjadi tempat di mana anda melakukan pembangunan dan ujian. Apabila anda berpuas hati dengan perubahan, anda akan meletakkan salinan program anda di GitHub. Laman web anda akan berada di PythonAnywhere dan anda akan mengemas kini dengan mendapatkan salinan baru kod anda dari GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Memulakan repositori Git kami
+
+Git menjejaki perubahan pada satu set fail tertentu dalam apa yang dipanggil repositori kod (atau "repo" untuk pendek). Mari kita mulakan projek kami. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Memulakan repositori git adalah sesuatu yang perlu kita lakukan hanya sekali bagi setiap projek (dan anda tidak perlu memasukkan semula nama pengguna dan email sekali lagi).
+
+Git akan menjejaki perubahan kepada semua fail dan folder dalam direktori ini, tetapi terdapat beberapa fail yang kami mahu ia diabaikan. We do this by creating a file called `.gitignore` in the base directory. Buka editor anda dan buat fail baru dengan kandungan berikut:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! Jika anda mengalami sebarang kesulitan menciptanya (Mac tidak menyukai anda untuk membuat fail yang bermula dengan titik melalui Finder, sebagai contoh), kemudian gunakan ciri "Simpan Sebagai" dalam editor anda; ia peluru.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. Fail itu ialah pangkalan data setempat anda, di mana semua jawatan anda disimpan. Kami tidak mahu menambah ini ke repositori anda kerana laman web anda di PythonAnywhere akan menggunakan pangkalan data yang berbeza. Pangkalan data itu boleh menjadi SQLite, seperti mesin pembangunan anda, tetapi biasanya anda akan menggunakan salah satu yang dipanggil MySQL yang boleh menangani pelawat laman web yang lebih banyak daripada SQLite. Dengan cara ini, dengan mengabaikan pangkalan data SQLite anda untuk salinan GitHub, ini bermakna bahawa semua jawatan yang anda buat setakat ini akan tinggal dan hanya boleh didapati di dalam negara, tetapi anda perlu menambah lagi pengeluaran. Anda perlu memikirkan pangkalan data tempatan anda sebagai taman permainan yang bagus di mana anda boleh menguji perkara yang berbeza dan jangan takut bahawa anda akan memadamkan siaran sebenar anda dari blog anda.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. Ini akan membantu menghalang sebarang kejutan daripada berlaku, seperti fail salah yang ditambah atau dilakukan. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. Keluaran harus sama dengan yang berikut:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Dan akhirnya kami menyelamatkan perubahan kami. Pergi ke konsol anda dan jalankan arahan ini:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (Jika anda sudah melakukannya dalam persiapan bengkel, itu bagus!) Kemudian, buat repositori baru, memberikan nama "blog pertama saya". Biarkan kotak semak "memulakan dengan README" tidak dicentang, biarkan pilihan .gitignore kosong (kami telah melakukannya secara manual) dan biarkan Lesen sebagai Tiada.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. Mungkin lebih mudah hanya dengan nama `my-first-blog`.
+    
+    Pada skrin seterusnya, anda akan dipaparkan URL klon repo anda. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [cawangan baru] tuan -> master master Cawangan ditubuhkan untuk mengesan induk cawangan jauh dari asal.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Pergi dan periksa!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Pilih pilihan untuk memulakan konsol "Bash" - itulah versi PythonAnywhere dari konsol, sama seperti yang ada pada komputer anda.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Mari kita tarik kod kami dari GitHub dan ke PythonAnywhere dengan membuat "klon" repo kami. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Kesabaran, kesabaran!  Tetapi jika ia mengambil masa lebih dari pada lima minit, ada yang salah.  Tanya jurulatih anda.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. Oleh itu, akaun pengguna dan jawatan mungkin berbeza di pelayan dan di komputer anda.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. Kami bersedia untuk menerbitkannya sebagai aplikasi web!
+    
+    Klik kembali ke papan pemuka PythonAnywhere dengan mengklik pada logonya, kemudian klik pada tab **Web**. Akhirnya, tekan **Tambah apl web baru**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. Kami terlalu keren untuk setup PythonAnywhere default Django. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Klik kotak biru dengan tanda semak untuk menyelamatkan laluan sebelum bergerak.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. Sekiranya anda membuat kesilapan, PythonAnywhere akan menunjukkan sedikit amaran.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. Cara kami mengkonfigurasi PythonAnywhere untuk mengenali blog Django kami adalah dengan mengedit fail konfigurasi WSGI.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+Tugas fail ini adalah untuk memberitahu PythonAnywhere di mana aplikasi web kami hidup dan nama fail tetapan Django itu.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. Kami akan mengetahui lebih lanjut mengenai fail statik kemudian dalam tutorial, apabila kami mengedit CSS untuk laman web kami.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Petua penyahpepijatan
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). Lihat jika terdapat sebarang mesej ralat di sana; yang paling baru berada di bahagian bawah. Masalah biasa termasuk:
+
+- Melupakan satu langkah yang kami lakukan di konsol: mewujudkan virtualenv, mengaktifkannya, memasang Django ke dalamnya, memindahkan pangkalan data.
+
+- Membuat kesilapan dalam laluan virtualenv di tab Web - biasanya terdapat sedikit mesej ralat merah di sana, jika ada masalah.
+
+- Membuat kesilapan dalam fail konfigurasi WSGI - adakah anda mendapat laluan ke folder blog pertama saya?
+
+- Adakah anda memilih versi Python yang sama untuk virtualenv anda seperti yang anda lakukan untuk aplikasi web anda? Kedua-duanya harus 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+Dan ingat, jurulatih anda di sini untuk membantu!
+
+# Anda hidup!
+
+Halaman lalai untuk laman web anda sepatutnya mengatakan "Ia berfungsi!", Sama seperti pada komputer tempatan anda. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log masuk dengan nama pengguna dan kata laluan, dan anda akan melihat anda boleh menambah Posts baru pada pelayan.
+
+Sebaik sahaja anda mempunyai beberapa catatan yang dibuat, anda boleh kembali ke persediaan setempat anda (bukan PythonAnywhere ). Dari sini, anda perlu membuat persediaan setempat anda untuk membuat perubahan. Ini adalah alur kerja biasa dalam pembangunan web - membuat perubahan secara tempatan, tolak perubahan tersebut kepada GitHub, dan tarik perubahan anda ke pelayan Web langsung anda. Ini membolehkan anda untuk bekerja dan bereksperimen tanpa memecah laman web anda secara langsung. Cukup sejuk, kan?
+
+Give yourself a *HUGE* pat on the back! Pelancaran pelayan adalah salah satu bahagian yang paling menarik dari pembangunan web dan ia sering memerlukan orang beberapa hari sebelum mereka membuat mereka bekerja. Tetapi anda mendapat laman web anda secara langsung, di Internet sebenar, seperti itu!
\ No newline at end of file
diff --git a/ms/deploy/install_git.md b/ms/deploy/install_git.md
new file mode 100644
index 00000000000..63eab0cd886
--- /dev/null
+++ b/ms/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git adalah "sistem kawalan versi" yang digunakan oleh banyak pengaturcara. Perisian ini boleh menjejaki perubahan pada fail dari semasa ke semasa supaya anda boleh mengimbas kembali versi tertentu kemudian. Sedikit seperti ciri "perubahan trek" dalam Microsoft Word, tetapi lebih berkuasa.
+
+## Memasang Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Anda boleh memuat turun Git dari [git-scm.com](https://git-scm.com/). Anda boleh memukul "seterusnya" pada semua langkah kecuali satu; dalam langkah kelima yang bertajuk "Menyesuaikan persekitaran PATH anda", pilih "Gunakan Git dan alat Unix opsional dari Windows Command Prompt" (pilihan bawah). Selain itu, yang tertera adalah baik. Cuba lihat gaya-Windows, cara pengakhiran gaya-Unix adalah baik.
+
+Jangan lupa untuk memulakan semula command prompt atau powerhell selepas pemasangan selesai dengan jayanya. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ms/deploy/signup_pythonanywhere.md b/ms/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/ms/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ms/django/README.md b/ms/django/README.md
new file mode 100644
index 00000000000..6f88228d98c
--- /dev/null
+++ b/ms/django/README.md
@@ -0,0 +1,27 @@
+# Apa itu Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. Rangka kerja web adalah satu set komponen yang membantu anda mengembangkan laman web dengan lebih cepat dan lebih mudah.
+
+Apabila anda membina laman web, anda sentiasa memerlukan set komponen yang serupa: cara untuk mengendalikan pengesahan pengguna (mendaftar, melog masuk, melog masuk), panel pengurusan untuk laman web anda, borang, cara untuk memuat naik fail, dan lain-lain.
+
+Nasib baik untuk anda, orang lain lama dahulu menyedari bahawa pembangun web menghadapi masalah yang sama ketika membina laman web baru, jadi mereka bekerja sama dan membuat kerangka kerja (Django menjadi salah satu dari mereka) yang memberikan komponen siap pakai untuk digunakan.
+
+Rangka kerja ada untuk menyelamatkan anda daripada mencipta semula roda dan membantu mengurangkan beberapa overhead apabila anda sedang membina laman web baru.
+
+## Mengapa anda memerlukan rangka kerja?
+
+Untuk memahami apa sebenarnya Django, kita perlu melihat lebih dekat pada pelayan. Perkara pertama adalah bahawa pelayan perlu tahu bahawa anda mahu ia melayani anda halaman web.
+
+Bayangkan peti mel (port) yang dipantau untuk surat masuk ( permintaan ). Ini dilakukan oleh pelayan web. Pelayan web membaca surat itu dan kemudian menghantar respons dengan halaman web. Tetapi apabila anda mahu menghantar sesuatu, anda perlu mempunyai beberapa kandungan. Dan Django adalah sesuatu yang membantu anda membuat kandungan.
+
+## Apa yang berlaku apabila seseorang meminta tapak web dari pelayan anda?
+
+Apabila permintaan datang ke pelayan web, ia diluluskan kepada Django yang cuba memikirkan apa yang sebenarnya diminta. Ia mengambil alamat laman web terlebih dahulu dan cuba mencari tahu apa yang harus dilakukan. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). Ia tidak terlalu pintar - ia memerlukan senarai corak dan cuba memadankan URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Bayangkan pembawa mel dengan surat. Dia sedang berjalan di jalan dan memeriksa setiap nombor rumah di atas surat itu. Sekiranya ia sepadan, dia meletakkan surat itu di sana. Inilah cara kerja urlresolver!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Mungkin pengguna diminta mengubah sesuatu dalam data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Sudah tentu, perihalan di atas sedikit banyak dipermudahkan, tetapi anda tidak perlu mengetahui semua perkara teknikal lagi. Mempunyai idea umum cukup.
+
+Jadi, bukannya menyelam terlalu banyak ke dalam butiran, kami hanya akan mula membuat sesuatu dengan Django dan kami akan mempelajari semua bahagian penting di sepanjang jalan!
\ No newline at end of file
diff --git a/ms/django_admin/README.md b/ms/django_admin/README.md
new file mode 100644
index 00000000000..f1c955b7867
--- /dev/null
+++ b/ms/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+Untuk menambah, edit dan padamkan siaran kami baru saja dimodelkan, kita akan menggunakan Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Seperti yang anda boleh lihat, kita import (termasuk) Pos model didefinisikan dalam bab sebelumnya. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, masa untuk melihat model Pos kami. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. Anda akan melihat halaman login seperti ini:
+
+![Halaman log masuk](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Ingat, untuk tulis arahan baru ketika pelayan web adalah berjalan, buka terminal baru jendela dan mengaktifkan anda virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ms/django_forms/README.md b/ms/django_forms/README.md
new file mode 100644
index 00000000000..a39ef5b0d58
--- /dev/null
+++ b/ms/django_forms/README.md
@@ -0,0 +1,447 @@
+# Borang Django
+
+Hal terakhir yang kita ingin lakukan di website kami menciptakan sebuah cara yang bagus untuk menambahkan dan mengedit posting blog. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, mari buka dan ketik kod berikut:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Akhirnya, kita dapat mengatakan yang bidang(s) harus berakhir di formulir kami. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+Jadi sekali lagi kita akan membuat link ke halaman, URL, pandangan dan template.
+
+## Pautan ke halaman dengan borang
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+Selepas menambah baris, fail HTML anda sekarang akan kelihatan seperti ini:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+Dan kod terakhir akan kelihatan seperti ini:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+dari url import django.conf.urls
+dari. import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## paparan post_new
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+dari .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Templat
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. Ini sangat penting, kerana ia menjadikan borang anda selamat! Sekiranya anda melupakan sedikit ini, Django akan mengeluh apabila anda cuba menyelamatkan borang:
+
+![Halaman terlarang CSRF](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Masa untuk dimuat semula! Yay! Borang anda dipaparkan!
+
+![Borang baru](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Apa-apa! Kita sekali lagi pada halaman yang sama dan teks kita hilang... dan tidak ada posting baru ditambahkan. Jadi apa yang salah?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Menyimpan borang
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? Kami akan melakukannya seperti berikut:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+Kami semak jika borang itu sah dan jika ya, kami boleh menyimpannya!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+dari django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Mari kita lihat apakah ia berfungsi. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+Itu hebat!
+
+> Seperti yang baru-baru ini kami menggunakan antara muka admin Django, sistem pada masa ini menganggap kami masih log masuk. Terdapat beberapa situasi yang boleh menyebabkan kita dilog keluar (menutup penyemak imbas, memulakan semula DB, dan lain-lain). Jika, semasa membuat jawatan, anda mendapati bahawa anda mendapat kesilapan merujuk kepada kekurangan pengguna log masuk, pergi ke halaman admin http://127.0.0.1:8000/admin dan log masuk sekali lagi. Ini akan membetulkan masalah buat sementara waktu. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Log masuk kesilapan](images/post_create_error.png)
+
+## Pengesahan borang
+
+Sekarang, kami akan menunjukkan kepada anda bagaimana bentuk Django yang sejuk. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Pengesahan borang](images/form_validation2.png)
+
+Django menjaga untuk mengesahkan bahawa semua bidang dalam bentuk kami adalah betul. Bukankah itu hebat?
+
+## Edit borang
+
+Sekarang kita tahu cara menambah bentuk baru. But what if we want to edit an existing one? Ini sangat mirip dengan apa yang kita buat. Mari kita buat beberapa perkara penting dengan cepat. (Jika anda tidak memahami sesuatu, anda harus meminta jurulatih anda atau melihat bab sebelumnya, kerana kami telah melengkapkan semua langkah ini.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+supaya templat akan kelihatan seperti ini:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+Apabila anda mengklik, anda akan melihat borang dengan catatan blog kami:
+
+![Edit form](images/edit_form2.png)
+
+Jangan ragu untuk menukar tajuk atau teks dan simpan perubahan!
+
+Tahniah! Permohonan anda semakin lengkap!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Mampu mencipta jawatan baru hanya dengan mengklik pautan adalah hebat! Tetapi sekarang, sesiapa yang melawat laman web anda akan dapat membuat catatan blog baru, dan itu mungkin bukan sesuatu yang anda mahukan. Mari buatkannya supaya butang itu muncul untuk anda tetapi bukan untuk orang lain.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. Ini tidak melindungi penciptaan siaran baru sepenuhnya, tetapi ia adalah langkah pertama yang baik. Kami akan melindungi lebih banyak keselamatan dalam pelajaran lanjutan.
+
+Ingat ikon edit yang baru kami tambahkan pada halaman terperinci kami? Kami juga ingin menambah perubahan yang sama di sana, oleh itu orang lain tidak akan dapat mengedit jawatan sedia ada.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Tukar ke ini:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Oleh kerana anda mungkin log masuk, jika anda menyegarkan halaman, anda tidak akan melihat apa-apa yang berbeza. Muatkan halaman dalam pelayar yang berlainan atau tetingkap inkognito (dipanggil "InPrivate" di Windows Edge), walaupun, dan anda akan melihat bahawa pautan itu tidak dipaparkan dan ikonnya tidak dipaparkan sama ada!
+
+## Satu lagi perkara: menggunakan masa!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* Pertama, komit kod baru anda, dan tekankannya ke Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+Dan itu sepatutnya! Selamat :)
\ No newline at end of file
diff --git a/ms/django_installation/README.md b/ms/django_installation/README.md
new file mode 100644
index 00000000000..017305bdf71
--- /dev/null
+++ b/ms/django_installation/README.md
@@ -0,0 +1,7 @@
+# Pemasangan Django
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ms/django_installation/instructions.md b/ms/django_installation/instructions.md
new file mode 100644
index 00000000000..5f26814dc4c
--- /dev/null
+++ b/ms/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Persekitaran maya
+
+Sebelum memasang Django, kami akan memasang alat yang sangat berguna untuk membantu mengekalkan persekitaran pengekodan anda pada komputer anda. Ada kemungkinan untuk melangkau langkah ini, tetapi sangat disyorkan. Bermula dengan persediaan yang terbaik akan menjimatkan banyak masalah pada masa akan datang!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv akan mengasingkan persediaan Python / Django anda secara per-projek. Ini bermakna bahawa apa-apa perubahan yang anda buat ke satu laman web tidak akan menjejaskan mana-mana orang lain yang anda sedang berkembang. Rapi, betul?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. Anda boleh menggunakan nama lain, tetapi melekat pada huruf kecil dan tidak menggunakan ruang, aksen atau aksara khusus. Ia juga idea yang baik untuk menyimpan nama pendek - anda akan merujuknya banyak!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. Anda boleh menggunakan nama lain, tetapi melekat pada huruf kecil dan jangan gunakan ruang. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Persekitaran maya tidak berjaya dibuat kerana ensurepip tidak tersedia.  Pada sistem Debian / Ubuntu, anda perlu memasang paket python3-venv menggunakan arahan berikut.
+>        apt-get install python3-venv
+>     Anda mungkin perlu menggunakan sudo dengan arahan itu.  Selepas memasang pakej python3-venv, buat semula persekitaran maya anda.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> kemudian alihkan:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Memindahkan direktori virtualenv tidak akan berfungsi kerana virtualenv menggunakan laluan mutlak.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Barisan arahan anda mungkin membekukan selepas anda cuba memasang Django. Jika ini berlaku, bukannya arahan di atas digunakan:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+Itu sahaja! Anda kini (akhirnya) bersedia untuk membuat aplikasi Django!
\ No newline at end of file
diff --git a/ms/django_models/README.md b/ms/django_models/README.md
new file mode 100644
index 00000000000..84312e0b6bb
--- /dev/null
+++ b/ms/django_models/README.md
@@ -0,0 +1,199 @@
+# Django model
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. Idea ini adalah bahawa bukannya menulis segala-galanya sebagai urutan arahan pengaturcaraan yang membosankan, kita boleh memodelkan sesuatu dan menentukan bagaimana mereka berinteraksi antara satu sama lain.
+
+Jadi apa benda? Ia adalah koleksi sifat dan tindakan. Kedengarannya aneh, tetapi kami akan memberikan contoh kepada anda.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+Bagaimana kita akan model blog itu? Kami ingin membangun sebuah blog, kan?
+
+Kita perlu menjawab soalan: Apakah blog pos? Apa sifat harus ia telah?
+
+Yah, pasti blog post kita memerlukan beberapa teks dengan kandungan dan judul, kan? Ia juga akan menjadi bagus untuk tahu siapa yang menulisnya – jadi kita perlu seorang penulis. Akhirnya, kita ingin tahu apabila pos diciptakan dan diterbitkan.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Kerana kita sudah tahu apa yang kita ingin mencapai, mari kita mulakan model dalam Django!
+
+## Django model
+
+Mengetahui apa objek itu, kita boleh buat Django model untuk blog post kita.
+
+A model in Django is a special kind of object – it is saved in the `database`. Pangkalan data adalah koleksi data. Ini adalah tempat di mana anda akan menyimpan maklumat tentang pengguna, blog anda, dan lain-lain. Kita akan menggunakan Lihat pangkalan data untuk menyimpan data kami. Ini adalah default Django pangkalan data adaptor – ia akan menjadi cukup untuk kita sekarang.
+
+Anda bisa memikirkan model dalam pangkalan data sebagai hamparan dengan ruangan (bidang) dan baris (data).
+
+### Membuat permohonan
+
+Untuk memastikan semuanya kemas, kita akan membuat permohonan yang berasingan di dalam projek kami. Hal ini sangat baik untuk memiliki semua dianjurkan dari awal. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Membuat pos blog model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. Konvensyen ini sering digunakan dalam Python dan kadang-kadang kita juga memanggil mereka "dunder" (pendek untuk "double-menekankan").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Membuat meja untuk model dalam pangkalan data anda
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ms/django_orm/README.md b/ms/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/ms/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ms/django_start_project/README.md b/ms/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/ms/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ms/django_templates/README.md b/ms/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/ms/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ms/django_urls/README.md b/ms/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/ms/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/ms/django_views/README.md b/ms/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/ms/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/ms/dynamic_data_in_templates/README.md b/ms/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/ms/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/ms/extend_your_application/README.md b/ms/extend_your_application/README.md
new file mode 100644
index 00000000000..c6cf0f47807
--- /dev/null
+++ b/ms/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Melanjutkan permohonan anda
+
+Kita sudah siap semua yang berbeza langkah-langkah yang diperlukan untuk penciptaan kami web: kita tahu bagaimana untuk menulis model, url, paparan dan templat. Kita juga tahu bagaimana untuk membuat website kami cukup.
+
+Masa untuk berlatih!
+
+Benda pertama yang kita perlukan di blog kita adalah, jelas sekali, halaman untuk menampilkan satu siaran, betul?
+
+Kita sudah mempunyai yang `Post` model, jadi kita tidak perlu menambahkan apa-apa untuk `models.py`.
+
+## Membuat template link ke pos detail
+
+Kita akan bermula dengan menambah link di dalam `blog/templates/blog/post_list.html` file. Setakat ini ia harus kelihatan seperti ini: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}Kami ingin mempunyai link dari pos tajuk dalam senarai pos ke pos halaman butiran. Mari kita mengubah `<h1><a href="">{{ post.title }}</a></h1>` supaya ia menghubungkan ke pos halaman butiran:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. Seperti yang anda mungkin tersangka, yang `{% %}` notasi cara yang kami adalah menggunakan Django template tags. Kali ini kita akan menggunakan salah satu yang akan membuat URL untuk kita!{% endraw %}
+
+Yang `post_detail` bahagian bermakna itu Django akan mengharapkan URL di `blog/urls.py` dengan nama=post_detail
+
+And how about `pk=post.pk`? `pk` ini pendek untuk kunci utama, yang merupakan nama yang unik untuk setiap rekod dalam pangkalan data. Karena kita tidak menentukan kunci utama kami `Post` model, Django mewujudkan satu untuk kami (oleh lalai, beberapa yang meningkatkan oleh satu untuk setiap rekod, i.e. 1, 2, 3) dan menambah ia sebagai satu bidang yang dinamakan `pk` untuk setiap jawatan kami. Kita mengakses kunci utama dengan menulis `post.pk`, cara yang sama kami akses lain bidang (`tajuk`, `penulis`, dan lain-lain.) dalam kami `Post` objek!
+
+Sekarang, ketika kita pergi ke http://127.0.0.1:8000/ kami akan mempunyai satu kesilapan (seperti yang dijangka, sejak kita tidak lagi mempunyai URL atau sesuatu *pandangan* bagi `post_detail`). Ia akan kelihatan seperti ini:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Mencipta sebuah URL ke sebuah butiran pos
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. Fail harus kelihatan seperti ini:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. Ia bermakna Django akan mengambil segala sesuatu yang anda meletakkan di sini dan memindahkannya ke lihat sebagai variabel yang dipanggil `pk`. (Perhatikan yang ini sepadan dengan nama kami memberikan kunci utama berubah-ubah kembali dalam `blog/templates/blog/post_list.html`!) `\d` juga memberitahu kita bahwa hal itu hanya dapat angka, tidak surat (jadi semuanya antara 0 dan 9). `+` berarti harus ada satu atau lebih digit sana. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+Itu berarti jika anda masuk `http://127.0.0.1:8000/post/5/` ke pelayar anda, Django akan mengerti bahwa anda sedang mencari *pandangan* dipanggil `post_detail` dan memindahkan maklumat itu `pk` sama dengan `5` untuk itu *pandangan*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! Pelayan telah berhenti berjalan lagi. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Apakah anda ingat apa langkah berikutnya adalah? Tentu saja: menambah melihat!
+
+## Tambah post melihat butiran
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Catatan yang kita perlukan untuk menggunakan nama yang sama sebagai salah satu kita yang dinyatakan dalam urls (`pk`). Meninggalkan berubah-ubah ini adalah salah dan akan mengakibatkan satu kesilapan!
+
+Sekarang, kita mahu untuk mendapatkan salah satu dan hanya satu blog pos. Untuk melakukan ini, kita bisa menggunakan querysets, seperti ini:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+Berita baik adalah bahwa anda benar-benar dapat membuat anda sendiri `Halaman tidak menemukan` halaman dan menjadikannya sebagai cantik seperti yang anda mahu. Tapi itu tidak penting super sekarang, jadi kami akan melewatkan itu.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. Ini bermakna bahawa Django akan mengharapkan lihat fungsi dipanggil `post_detail` di dalam `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Menghantar senarai melihat](images/post_list2.png)
+
+Ia bekerja! Tetapi apa yang terjadi apabila anda klik link di blog pos tajuk?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh tidak! Satu lagi kesalahan! Tapi kami sudah tahu bagaimana untuk berurusan dengan itu, kan? Kita perlu untuk menambah template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. Dalam `content` blok kami mahu paparan yang post published_date (jika ia wujud), tajuk dan teks. Tetapi kita harus mendiskusikan beberapa hal penting, kan?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, kita boleh menyegarkan kami halaman dan melihat jika `TemplateDoesNotExist` pergi sekarang.
+
+![Pos halaman terperinci](images/post_detail2.png)
+
+Yay! Ia berfungsi!
+
+## Satu hal lagi: menggunakan masa!
+
+Itu akan menjadi baik untuk melihat jika anda masih akan bekerja pada PythonAnywhere, kan? Mari kita cuba menggerakkan lagi.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/ms/how_the_internet_works/README.md b/ms/how_the_internet_works/README.md
new file mode 100644
index 00000000000..bc5c0fc1817
--- /dev/null
+++ b/ms/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Bagaimana Internet berfungsi
+
+> Untuk pembaca di rumah: bab ini adalah dilindungi dalam [Bagaimana Internet Berfungsi](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+Kami yakin anda menggunakan Internet setiap hari. Tapi apakah anda benar-benar tahu apa yang terjadi ketika anda jenis alamat seperti https://djangogirls.org ke pelayar anda dan tekan `masuk`?
+
+Perkara pertama yang kau harus faham bahawa laman web adalah hanya sekelompok fail yang disimpan pada hard disk. Hanya seperti filem anda, music, atau gambar. Bagaimanapun, ada satu bagian yang unik untuk laman websites: mereka termasuk kode komputer yang dipanggil HTML.
+
+Jika anda tidak akrab dengan program itu akan sulit untuk memahami HTML pada mulanya, tetapi anda web browser (seperti Chrome, Safari, Firefox, dan lain-lain.) cinta itu. Web browser direka untuk memahami kode ini, mengikut arahan, dan sekarang ini fail bahawa laman web anda dibuat, persis seperti yang anda inginkan.
+
+Seperti dengan setiap file, kita perlu simpan fail HTML di suatu tempat di hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! Anda boleh mengunjungi sebuah kapal Selam Kabel Peta website (http://submarinecablemap.com) untuk melihat bagaimana rumit bersih. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. Jadi, untuk mencapai satu mesin (sebagai contoh, satu di mana https://djangogirls.org disimpan) kita perlu lulus permintaan melalui banyak, banyak mesin yang berbeza.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Bayangkan bahwa ketika anda jenis https://djangogirls.org, yang anda kirim surat yang mengatakan: "Dear Django Girls, aku ingin melihat djangogirls.org web. Kirimkan ke saya, silakan!"
+
+Your letter goes to the post office closest to you. Kemudian ia pergi untuk yang lain, yang sedikit lebih dekat dengan anda penerima, kemudian yang lain, dan lain sehingga ia dihantar di destinasi. Satu-satunya yang unik adalah bahawa jika anda banyak mengirim surat (*paket data*) ke tempat yang sama, mereka bisa pergi melalui benar-benar berbeza pejabat pos (*penghala*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Bukan alamat dengan nama jalan, bandar, zip code dan nama negara, kami menggunakan alamat IP. Komputer pertama meminta DNS (Nama Domain Sistem) untuk menterjemahkan djangogirls.org ke alamat IP. Ia berfungsi sedikit seperti lama buku telefon di mana anda boleh melihat ke atas nama orang yang anda mahu untuk menghubungi dan mencari mereka nomor telepon dan alamat.
+
+Ketika anda mengirimkan surat, ia perlu mempunyai ciri-ciri tertentu yang akan dihantar dengan betul: alamat, perangko, dan lain-lain. Kau juga menggunakan bahasa yang penerima memahami, kan? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. Ketika kau mengirim seorang tindak balas, anda tidak selalu ingin menghantar hal yang sama untuk semua orang. Ia adalah jauh lebih baik jika surat-surat anda adalah peribadi, terutama untuk orang yang telah ditulis untuk anda, kan? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ms/html/README.md b/ms/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/ms/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ms/install_git.md b/ms/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ms/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ms/installation/README.md b/ms/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/ms/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ms/instructions.md b/ms/instructions.md
new file mode 100644
index 00000000000..be0a284adad
--- /dev/null
+++ b/ms/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Creating a `virtualenv` on both Linux and OS X is as simple as running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ms/intro_to_command_line/README.md b/ms/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/ms/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ms/python_installation/README.md b/ms/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/ms/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ms/python_installation/instructions.md b/ms/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/ms/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ms/python_introduction/README.md b/ms/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/ms/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ms/signup_pythonanywhere.md b/ms/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/ms/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ms/template_extending/README.md b/ms/template_extending/README.md
new file mode 100644
index 00000000000..8d3e5605a9d
--- /dev/null
+++ b/ms/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template melanjutkan
+
+Satu lagi perkara yang baik Django telah untuk anda **template melanjutkan**. Apa artinya ini? Ia bermakna bahawa anda boleh menggunakan yang sama bahagian HTML anda untuk halaman laman web anda.
+
+Template membantu ketika anda ingin menggunakan maklumat yang sama atau atur dalam lebih daripada di satu tempat. Anda tidak perlu mengulangi sendiri dalam setiap fail. Dan jika anda ingin mengubah sesuatu, anda tidak perlu melakukannya dalam setiap template, hanya satu!
+
+## Membuat pangkalan template
+
+Pangkalan template yang paling asas template yang anda melanjutkan pada setiap halaman laman web anda.
+
+Mari kita buat `base.html` fail dalam `blog/templates/blog/`:
+
+    blog
+    └───template
+        └───blog
+                base.html
+                post_list.html
+    
+
+Kemudian buka dan salinan dari semuanya `post_list.html` to `base.html` fail, seperti ini:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Kemudian dalam `base.html`, menggantikan anda keseluruhan `<body>` (segala sesuatu di antara `<body>` dan `</body>`) dengan ini:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}Anda mungkin melihat ini digantikan segala-galanya dari `{% for post in posts %}` to `{% endfor %}` dengan: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Tapi mengapa? Anda hanya mencipta `blok`! Anda digunakan tag template `{% block %}` untuk membuat kawasan yang akan HTML dimasukkan di dalamnya. Itu HTML akan datang dari template lain yang memanjang template ini (`base.html`). Kami akan menunjukkan anda bagaimana untuk melakukan ini dalam sekejap.
+
+Sekarang simpan `base.html` dan kamu membuka `blog/templates/blog/post_list.html` sekali lagi. {% raw %}Kau akan membuang semuanya di atas `{% for post in posts %}` dan di bawah `{% endfor %}`. Apabila anda selesai, fail akan kelihatan seperti ini:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+Kita ingin untuk menggunakan ini sebagai sebahagian daripada template kami untuk semua kandungan blok. Masa untuk menambah blok tag ini fail!
+
+{% raw %}Anda ingin blok anda tag untuk perlawanan tag anda `base.html` fail. Anda juga ingin termasuk semua kod milik dalam kandungan anda blok. Untuk melakukan itu, letakkan segala sesuatu di antara `{% block content %}` dan `{% endblock %}`. Seperti ini:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Hanya satu hal yang tersisa. Kita perlu untuk menyambung dua template bersama-sama. Ini adalah apa yang melanjutkan template adalah semua tentang! Kita akan melakukan ini dengan menambah memanjangkan tag untuk awal fail. Seperti ini:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% memanjangkan 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Itu saja! Periksa jika anda masih bekerja dengan baik. :)
+
+> Jika anda mendapatkan ralat `TemplateDoesNotExist`, itu berarti bahwa tidak ada `blog/base.html` file dan anda telah `runserver` berjalan di konsol. Mencoba untuk menghentikannya (dengan menekan Ctrl+C – Kawalan dan C kunci bersama-sama) dan mulakan semula oleh berjalan `python menguruskan.dengan salinan runserver` perintah.
\ No newline at end of file
diff --git a/ms/whats_next/README.md b/ms/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/ms/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/ne-NP/GLOSSARY.md b/ne-NP/GLOSSARY.md
new file mode 100644
index 00000000000..2b6611f185e
--- /dev/null
+++ b/ne-NP/GLOSSARY.md
@@ -0,0 +1,3 @@
+# कोड सम्पादक
+
+कोड सम्पादक एउटा एस्तो उपकरण हो जसले तपाइलाई आफ्नो कोडलाई पछि फेरि खोल्न मिल्ने गरि राख्न अनुमति दिन्छ. तपाईले एउटा कहाँ पाउने भनेर [Code editor chapter](./code_editor/README.md) बाट थाह पाउनु हुनेछ
\ No newline at end of file
diff --git a/ne-NP/README.md b/ne-NP/README.md
new file mode 100644
index 00000000000..d2b26175047
--- /dev/null
+++ b/ne-NP/README.md
@@ -0,0 +1,51 @@
+# Django केटीहरुको Tutorial
+
+[![गिटर](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 Tutorial मा स्वागत छ! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ne-NP/SUMMARY.md b/ne-NP/SUMMARY.md
new file mode 100644
index 00000000000..d9741b4f21c
--- /dev/null
+++ b/ne-NP/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/ne-NP/chromebook_setup/README.md b/ne-NP/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/ne-NP/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ne-NP/chromebook_setup/instructions.md b/ne-NP/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..1d386396d16
--- /dev/null
+++ b/ne-NP/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+यदि तपाईं क्रोमबुक प्रयोग गर्नुहुन्न भने सिधै [ यो भागमा ](http://tutorial.djangogirls.org/en/installation/#install-python) जान सक्नु हुन्छ । यदि क्रोमबुक प्रयोग गर्नुहुन्छ भने स्थापना अनुभव (installation experience) अलिक फरक हुन्छ। तपाइंले बाँकि स्थापना प्रक्रियालाई ध्यान नदिदा हुन्छ।
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+क्लाउड आईडीई एक उपकरण हो जसले तपाईंलाई कोड सम्पादकाका साथै इन्टरनेट चल्दै गरेको कम्प्युटरमा पहुँच दिन्छ। चल्दै छ इन्टरनेटमा जहाँ तपाईं सफ्टवेयर स्थापना, लेख्न, र चलाउन सक्नुहुन्छ। तपाईं यस कम्प्यूटरमा सफ्टवेयर स्थापना गर्न, लेख्न, र चलाउन सक्नुहुन्छ । For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ne-NP/code_editor/README.md b/ne-NP/code_editor/README.md
new file mode 100644
index 00000000000..0a401fb1f52
--- /dev/null
+++ b/ne-NP/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ne-NP/code_editor/instructions.md b/ne-NP/code_editor/instructions.md
new file mode 100644
index 00000000000..82fbac15aad
--- /dev/null
+++ b/ne-NP/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ne-NP/css/README.md b/ne-NP/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/ne-NP/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/ne-NP/deploy/README.md b/ne-NP/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/ne-NP/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/ne-NP/deploy/install_git.md b/ne-NP/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/ne-NP/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ne-NP/deploy/signup_pythonanywhere.md b/ne-NP/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/ne-NP/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ne-NP/django/README.md b/ne-NP/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/ne-NP/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/ne-NP/django_admin/README.md b/ne-NP/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/ne-NP/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ne-NP/django_forms/README.md b/ne-NP/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/ne-NP/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ne-NP/django_installation/README.md b/ne-NP/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/ne-NP/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ne-NP/django_installation/instructions.md b/ne-NP/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/ne-NP/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ne-NP/django_models/README.md b/ne-NP/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/ne-NP/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ne-NP/django_orm/README.md b/ne-NP/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/ne-NP/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ne-NP/django_start_project/README.md b/ne-NP/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/ne-NP/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ne-NP/django_templates/README.md b/ne-NP/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/ne-NP/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ne-NP/django_urls/README.md b/ne-NP/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/ne-NP/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ne-NP/django_views/README.md b/ne-NP/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/ne-NP/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ne-NP/dynamic_data_in_templates/README.md b/ne-NP/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/ne-NP/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ne-NP/extend_your_application/README.md b/ne-NP/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/ne-NP/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ne-NP/how_the_internet_works/README.md b/ne-NP/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/ne-NP/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ne-NP/html/README.md b/ne-NP/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/ne-NP/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ne-NP/installation/README.md b/ne-NP/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/ne-NP/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ne-NP/intro_to_command_line/README.md b/ne-NP/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/ne-NP/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ne-NP/intro_to_command_line/open_instructions.md b/ne-NP/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/ne-NP/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ne-NP/python_installation/README.md b/ne-NP/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/ne-NP/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ne-NP/python_installation/instructions.md b/ne-NP/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/ne-NP/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ne-NP/python_introduction/README.md b/ne-NP/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/ne-NP/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ne-NP/template_extending/README.md b/ne-NP/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/ne-NP/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ne-NP/whats_next/README.md b/ne-NP/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/ne-NP/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/nl-NL/GLOSSARY.md b/nl-NL/GLOSSARY.md
new file mode 100644
index 00000000000..0186bbc86a2
--- /dev/null
+++ b/nl-NL/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is een programma die je codes opslaat zodat je ze later terug kan vinden. Je kan te weten komen waar je er zelf één kan krijgen in [Code editor hoofdstuk](./code_editor/README.md)
\ No newline at end of file
diff --git a/nl-NL/README.md b/nl-NL/README.md
new file mode 100644
index 00000000000..8eb81c66128
--- /dev/null
+++ b/nl-NL/README.md
@@ -0,0 +1,51 @@
+# Django Girls Gids
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Dit werk valt onder de Creative Commons Attribution-ShareAlike 4.0 Internationale licentie. Als je een kopie van deze licentie wilt inzien, bezoek dan https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welkom
+
+Welkom bij de Django Girls Gids! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Inleiding
+
+Heb je wel eens het gevoel gehad dat er in de wereld om je heen almaar meer technologie komt die je (nog) niet kunt bevatten? Heb je je wel eens afgevraagd hoe het zou zijn om een website te maken, maar toch niet genoeg motivatie om daarmee te beginnen? Denk je soms wel eens dat computerprogramma's maken te moeilijk is voor jou, zodat je niet eens de puf hebt eens zelf te proberen?
+
+Nou, hebben we goed nieuws voor je! Programmeren is helemaal niet zo moeilijk als het lijkt en wij willen je laten zien hoe leuk het kan zijn.
+
+Deze Gids zal je niet op slag veranderen in een programmeur. Als je er heel goed in wilt worden, heb je maanden, zo niet jaren, van leren en oefenen voor nodig. Maar wij willen je laten zien dat programmeren of het maken van websites niet zo lastig is als het lijkt. We zullen onze uiterste best doen om te proberen je de verschillende puzzelstukjes uit te leggen, zodat je je niet overwelmd hoeft te voelen door de technologie.
+
+We hopen dat het ons lukt om je net zo enthousiast over technologie te krijgen als wijzelf zijn!
+
+## Wat ga je leren in deze Gids?
+
+Als je de Gids hebt doorlopen, zul je een kleine, maar echt werkende web-applicatie hebben: je eigen blog. We zullen je laten zien hoe je die online zet zodat anderen je werk kunnen bewonderen!
+
+Het gaat er (ongeveer) zo uit zien:
+
+![Figuur 0.1](images/application.png)
+
+> Als je de Gids in je eentje doorneemt en je geen coach bij de hand hebt die je kan helpen in geval van problemen, dan hebben we een chat systeem voor je:[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We hebben onze coaches en eerdere deelnemers gevraagd om daar af en toe beschikbaar te zijn om anderen te helpen met de Gids! Aarzel niet om je vraag daar te stellen!
+
+OK, [laten we bij het begin beginnen...](./how_the_internet_works/README.md)
+
+## Thuis deze gids volgen
+
+Het is vet om deel te nemen aan een Django Girls workshop, maar we realiseren ons dat het niet altijd mogelijk is om er eentje bij te wonen. Daarom moedigen we je dan ook aan om te proberen deze Gids thuis te doorlopen. Voor de thuislezers zijn we momenteel bezig met het maken van videos die het gemakkelijker maken de Gids in je eentje door te werken. Het is nog niet helemaal klaar, maar binnenkort worden er steeds meer onderwerpen behandeld op het [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube kanaal.
+
+In elk hoofdstuk waarvoor er een video is, staat er een link daarnaartoe.
+
+## Gids-onderhoud en -bijdragen
+
+Deze gids wordt bijgehouden door de [DjangoGirls](https://djangogirls.org/). Als je een foutje vindt of de gids wilt bijwerken, volg dan de [richtlijnen om bij te dragen](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Zou je ons willen helpen om de gids te vertalen naar andere talen?
+
+Momenteel worden vertalingen gedaan op het crowdin.com platform op:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Als jouw taal niet wordt genoemd op [Crowdin](https://crowdin.com/), maak dan een [nieuwe melding](https://github.com/DjangoGirls/tutorial/issues/new) aan waarin je ons die taal meldt, dan voegen wij die toe.
\ No newline at end of file
diff --git a/nl-NL/SUMMARY.md b/nl-NL/SUMMARY.md
new file mode 100644
index 00000000000..c5a6d590ab5
--- /dev/null
+++ b/nl-NL/SUMMARY.md
@@ -0,0 +1,35 @@
+# Overzicht
+
+* [Introductie](README.md)
+* [Installatie](installation/README.md) 
+  * [Commando lijn](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code editor ](installation/README.md#code-editor)
+  * [Virtuele omgeving ](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub ](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installatie (op Chromebook)](chromebook_setup/README.md)
+* [Hoe het internet werkt](how_the_internet_works/README.md)
+* [Introductie van de opdrachtregel](intro_to_command_line/README.md)
+* [Installatie van Python](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introductie Python](python_introduction/README.md)
+* [Wat is Django?](django/README.md)
+* [Installatie van Django](django_installation/README.md)
+* [Je eerste Django project!](django_start_project/README.md)
+* [Django modellen](django_models/README.md)
+* [Django beheer](django_admin/README.md)
+* [Uitrollen!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views - tijd om ze te maken!](django_views/README.md)
+* [Introductie van HTML](html/README.md)
+* [Django ORM (Zoekresultaten)](django_orm/README.md)
+* [Dynamische gegevens in sjablonen](dynamic_data_in_templates/README.md)
+* [Django sjablonen](django_templates/README.md)
+* [CSS - Maak het mooi](css/README.md)
+* [Sjabloonuitbreidingen](template_extending/README.md)
+* [Applicatie-uitbreidingen](extend_your_application/README.md)
+* [Django formulieren](django_forms/README.md)
+* [En nu?](whats_next/README.md)
\ No newline at end of file
diff --git a/nl-NL/chromebook_setup/README.md b/nl-NL/chromebook_setup/README.md
new file mode 100644
index 00000000000..ae05276bfdf
--- /dev/null
+++ b/nl-NL/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook installatie
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/nl-NL/chromebook_setup/instructions.md b/nl-NL/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..dc52c4b7c49
--- /dev/null
+++ b/nl-NL/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Je kunt [deze sectie overslaan](http://tutorial.djangogirls.org/en/installation/#install-python) als je geen Chromebook gebruikt. Als je die wel gebruikt, dan is het installatieproces anders. Je kunt dan de rest van de installatieinstructies negeren.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud 9 is een hulpmiddel die je een code editor aanbiedt op een computer op het Internet. Hierop kan je de programmatuur installeren en uitvoeren. In deze gids beschouwen we Cloud 9 dan ook als jouw *lokale machine*. Je zult opdrachten nog steeds, net als je klasgenoten met OS X, Ubuntu, of Windows, in een terminalscherm typen. Maar jouw terminal is dan verbonden met een computer ergens anders, zoals Cloud 9 dat voor jou heeft ingesteld. Hieronder vind je de instructies voor zogenaamde cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Je kan kiezen uit de een van de volgende IDEs. Volg een van onderstaande instructies.
+
+#### Ga naar de PaizaCloud wolk IDE
+
+1. Ga naar de [PaizaCloud wolk IDE](https://paiza.cloud/)
+2. Meld je aan voor een account
+3. Klik op *New Server* en kies Django app
+4. Klik op Terminal knop (aan de linkerkant van het venster)
+
+Nu zou je een scherm met een zijbalk en knoppen aan de linkerkant moeten zien. Klik op de "Terminal" knop om een scherm met een terminal te openen, met de volgende prompt:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+De terminal op de PaizaCloud IDE is klaar voor je instructies. Je kunt het scherm vergroten of maximaliseren.
+
+#### AWS Cloud9
+
+Op dit moment vereist Cloud 9 dat je je aanmeldt met AWS en creditcardinformatie invoert.
+
+1. Installeer Cloud 9 uit de [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Ga naar [c9.io](https://c9.io) en klik op * Get started with AWS Cloud9*
+3. Registreer voor een AWS-account (vereist creditcardgegevens, maar deze kun je gratis gebruiken)
+4. In het AWS Dashboard, typ *Cloud9* in de zoekbalk en klik erop
+5. In het Cloud 9 overzicht, klik op * Create environment*
+6. Noem deze *django-girls*
+7. Tijdens het aanpassen van de instellingen, selecteer je * Create a new instance for environment (EC2)* voor “Environment Type” en de *t2.micro* “Instance type” (Er zou “Free-tier eligible.”) moeten staan. De standaard kosten-besparing instelling is in orde en je kan de andere standaard instellingen behouden
+8. Klik op *Next step*
+9. Klik op * Create environment*
+
+Je zou nu een scherm moeten zien met een zijbalk, een hoofdvenster met enkele tekstblokken erin, en een klein venster beneden dat er ongeveer zo uitziet:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+Het onderste scherm is je terminal. Je kunt de terminal gebruiken om instructies op afstand naar de Cloud 9 computer te versturen. Je kunt de grootte van dat scherm aanpassen om het iets groter te maken.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtuele omgeving
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/nl-NL/code_editor/README.md b/nl-NL/code_editor/README.md
new file mode 100644
index 00000000000..b4247648cb7
--- /dev/null
+++ b/nl-NL/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> Voor de lezers thuis: dit hoofdstuk wordt behandeld in de [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+Je staat op het punt om je eerste regel code te schrijven. Tijd om een code editor te downloaden!
+
+> **Opmerking** Als je een Chromebook gebruikt, sla dit hoofdstuk dan over en zorg ervoor dat je de [Chromebook installatie](../chromebook_setup/README.md) instructies volgt. De cloud IDE die je gekozen hebt (PiazaCloud Cloud IDE of AWS Cloud9) komt met een code editor. Wanneer je een bestand opent in je IDE vanuit het bestandsmenu gebruik je automatisch de editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/nl-NL/code_editor/instructions.md b/nl-NL/code_editor/instructions.md
new file mode 100644
index 00000000000..63af0fbbcce
--- /dev/null
+++ b/nl-NL/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Er zijn ontzettend veel verschillende code editors en het komt grotendeels neer op persoonlijke voorkeur. De meeste Python programmeurs gebruiken complexe maar uiterst krachtige IDEs (geïntegreerde software-ontwikkelomgeving) zoals PyCharm. Dat is waarschijnlijk minder geschikt voor een beginner. Onze aanbevelingen zijn even krachtig en een stuk eenvoudiger.
+
+Onze suggesties staan hieronder, maar vraag gerust je coach wat hun voorkeur is - het maakt het makkelijker om hulp van hen te krijgen.
+
+## Visual Studio Code
+
+Visual Studio Code is een code editor die ontwikkeld is door Microsoft voor Windows, Linux en MacOS. Deze editor bevat ondersteuning voor debugging, ingebakken Git controle, syntax highlighting en slimme code voltooiing, en code refactoring.
+
+[Download het hier](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is een gratis open source editor die beschikbaar is voor alle operating systems.
+
+[Download het hier](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is een hele populaire editor met een gratis proefperiode, en ook beschikbaar voor alle operating systems.
+
+[Download het hier](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is een andere populaire editor. Hij is gratis, open source en beschikbaar voor Windows, OS X en Linux. Atom is ontwikkeld door [GitHub](https://github.com/).
+
+[Download het hier](https://atom.io/)
+
+## Waarom installeren we een code editor?
+
+Je vraagt je misschien af waarom we een speciaal bewerkingsprogramma installeren, in plaats van dat we een programma als Word of Notepad gebruiken.
+
+De eerste reden is dat de code **plain text** (platte tekst) moet zijn, en het probleem met programma's zoals Word en Textedit is dat ze helemaal geen plain text produceren: ze produceren rich text (met lettertypes en opmaak), die ze opslaan als [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+De tweede reden is dat alle code editors gespecialiseerd zijn in het schrijven van code, zodat ze nuttige functies hebben zoals het markeren van de code met kleur, of automatisch aanhalingstekens sluiten.
+
+We zien dit later allemaal in actie. Al snel zul je je oude vertrouwde editor als een van je favoriete gereedschappen beschouwen. :)
\ No newline at end of file
diff --git a/nl-NL/css/README.md b/nl-NL/css/README.md
new file mode 100644
index 00000000000..7f473a0697f
--- /dev/null
+++ b/nl-NL/css/README.md
@@ -0,0 +1,330 @@
+# CSS - Maak het mooi!
+
+Onze blog ziet er nog steeds nogal lelijk uit, toch? Tijd om hem mooi te maken! Daarvoor gebruiken we CSS.
+
+## Wat is CSS?
+
+Cascading Style Sheets (CSS) is een taal die gebruikt wordt om het uiterlijk en de opmaak van een website geschreven in markup taal (zoals HTML) te beschrijven. Zie het als make-up voor onze webpagina. ;)
+
+Maar we willen niet weer helemaal vanuit het niets beginnen, toch? We maken wederom gebruik van iets wat programmeurs gratis via het internet delen. Het wiel opnieuw uitvinden is saai, toch?
+
+## We maken gebruik van Bootstrap!
+
+Bootstrap is een van de meest populaire HTML en CSS frameworks om mooie websites te ontwikkelen: https://getbootstrap.com/
+
+Het werd geschreven door programmeurs die voor Twitter werkten. Nu wordt het onderhouden door vrijwillers van over de hele wereld!
+
+## Bootstrap installeren
+
+Om Bootstrap te installeren open je het `.html` bestand in de code editor, en voeg je dit aan de `<head>` sectie toe:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Dit voegt geen bestanden toe aan je project, maar verwijst naar bestanden die al op het internet staan. Ga je gang, open je website en ververs de pagina. Daar zie je het resultaat!
+
+![Figuur 14.1](images/bootstrap1.png)
+
+Dit ziet er al een stuk beter uit!
+
+## Statische bestanden in Django
+
+Tenslotte zullen we een kijkje nemen naar de bestanden die we **statische bestanden** hebben genoemd. Statische bestanden zijn al je CSS-bestanden en afbeeldingen. Hun inhoud is niet afhankelijk van de context en is hetzelfde voor elke gebruiker.
+
+### Waar zet je statische bestanden in Django
+
+Django weet al waar het de statische bestanden voor de ingebouwde "admin" app kan vinden. Nu moeten we slechts wat statische bestanden voor onze eigen app, `blog`, toe te voegen.
+
+We doen dit door een folder met de naam `static` aan te maken binnenin de blog applicatie:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django vindt automatisch mappen die "static" genoemd zijn binnen je applicatiemappen, en kan de inhoud daarvan vervolgens als statische bestanden gebruiken.
+
+## Je eerste CSS bestand!
+
+Laten we een CSS-bestand aanmaken, om je eigen stijl aan je website toe te voegen. Maak een nieuwe map aan genaamd: `css` binnen je `static` map. Maak daarna een nieuw bestand genaamd: `blog.css` aan binnen deze `css` map. Klaar?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Tijd om wat CSS te schrijven! Open het `blog/static/css/blog.css` bestand in je code editor.
+
+We zullen hier niet te diep ingaan op het customiseren en leren over CSS. Er staan een aanbeveling voor een gratis cursus CSS op het einde van deze pagina als je meer wil leren hierover.
+
+Maar laten we wat details veranderen. Misschien kunnen we de kleur van onze header aanpassen? Om kleuren te begrijpen gebruiken computers speciale kleurcodes. Deze codes beginnen met `#`, gevolgd door een combinatie van 6 letters (A-F) en cijfers (0-9). De code voor de kleur blauw is bijvoorbeeld `#0000FF`. Je vindt een groot overzicht van kleurcodes hier: http://www.colorpicker.com/. Je kunt ook voorgedefinieerde kleuren gebruiken zoals `red` en `green`.
+
+In je `blog/static/css/blog.css` bestand moet je de volgende code toevoegen:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is een CSS Selector. Dit betekent dat we onze styling op alle `a` elementen binnen een `h1` element toepassen; de `h2 a` selector doet hetzelfde voor de `h2` elementen. Dus als we bijvoorbeeld iets hebben als `<h1><a href="">link</a></h1>`, wordt de `h1 a` stijl die we hebben opgegeven toegepast. In dit geval geven we de opdracht om de kleur te veranderen naar `#C25100`, een donkere kleur oranje. Je kunt natuurlijk ook je eigen kleur kiezen, maar zorg ervoor dat een een goed contrast heeft met de witte achtergrond!
+
+In een CSS bestand bepalen we de stijl voor de elementen in het HTML bestand. De eerste manier waarop we elementen identificeren, is met de naam van het element. Je hebt deze eerder voorbij zien komen als tags uit het HTML hoofdstuk. Dingen zoals `a`, `h1` en `body` zijn allemaal namen van elementen. We kunnen elementen ook identificeren bij het attribuut `class` of het attribuut `id`. Class en id zijn namen die je zelf aan een element geeft. Een class definieert een groep van elementen, en id's verwijzen naar specifieke elementen. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Je kunt meer over CSS lezen op [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We moeten ook ons HTML template laten weten dat we wat CSS hebben toegevoegd. Open het `blog/templates/blog/post_list.html` bestand in de code editor en voeg deze regel helemaal aan het begin toe:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We laden hier aleen de statische bestanden in. :) Tussen de `<head>` en `</head>` tags, na de link naar de Bootstrap bestanden, voeg je deze regel toe:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+De browser leest bestanden in de opgegeven volgorde, dus we moeten ervoor zorgen dat dit op de juiste plek staat. Anders wordt de code in ons bestand overschreven door de code in de Bootstrap bestanden. We hebben net aan onze template verteld waar onze CSS staat.
+
+Je bestand zou er nu zo uit moeten zien:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Ok, sla het bestand op en vernieuw de site!
+
+![Figuur 14.2](images/color2.png)
+
+Goed werk! Misschien moeten we onze site een beetje ruimte geven en de marge aan de linker kant groter maken? Laten we dit proberen!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Voeg dit aan je CSS toe, sla het bestand op, en kijk wat er veranderd is!
+
+![Figuur 14.3](images/margin2.png)
+
+Misschien kunnen we het lettertype in onze header aanpassen? Kopieer en plak dit in je `<head>` in het `blog/templates/blog/post_list.html` bestand:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Let weer op de volgorde en zet het vóór de link naar `blog/statig/css/blog.css`. Deze regel importeert een lettertype van Google wat *Lobster* heet. (https://www.google.com/fonts).
+
+Zoek het `h1 a` declaratieblok op (de code tussen de haken `{` en `}`) in het CSS bestand `blog/static/css/blog.css`. Voeg nu de regel `font-family: 'Lobster';` toe tussen de haken, en ververs je pagina:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figuur 14.3](images/font.png)
+
+Geweldig!
+
+Zoals hierboven vermeld, hanteert CSS een concept van klassen. Hiermee kun je een deel van je HTML code een naam geven, en een stijl alleen op dit gedeelte toepassen zonder gevolgen voor de andere delen. Dit is super handig! Misschien heb he bijvoorbeeld twee divs die allebei iets anders doen (bijvoorbeeld je header en je blog post). Met behulp van een klasse kun je ze anders stylen.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We gaan nu declaratieblokken toevoegen aan verschillende selectors. Selectors die beginnen met `.` hebben betrekking op klassen. Er is heel veel goede uitleg en tutorials over CSS te vinden op het web die je kunnen helpen om de volgende code te begrijpen. Voor nu, knip-en-plak de onderstaande code in je `blog/static/css/blog.css` bestand:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Vervolgens omring je de HTML code die die posts weergeeft met klassedeclaraties. Vervang dit:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in `blog/templates/blog/post_list.html` met dit:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Sla de bestanden op en ververs je website.
+
+![Figuur 14.4](images/final.png)
+
+Whoohoo! Ziet er gaaf uit, toch? Bekijk de code die je zojuist geplakt hebt en probeer de plekken te vinden waar je in de HTML klassen toegevoegd hebt, die je vervolgens in de CSS hebt gebruikt. Wat zou je wijzigen als je de datum bijvoorbeeld turquoise wil maken?
+
+Wees niet bang om een beetje met de CSS te spelen en wat dingen te veranderen. Met de CSS spelen helpt je om te begrijpen wat de verschillende dingen doen. Als er per ongeluk iets stuk gaat, maak je geen zorgen! Je kunt het altijd weer ongedaan maken!
+
+We raden u echt aan om de gratis online cursussen "Basic HTML & HTML5" en "Basic CSS" op [freeCodeCamp](https://learn.freecodecamp.org/) te nemen. Hiermee leer je alles over het mooier maken van websites met HTML en CSS.
+
+Klaar voor het volgende hoofdstuk?! :)
\ No newline at end of file
diff --git a/nl-NL/deploy/README.md b/nl-NL/deploy/README.md
new file mode 100644
index 00000000000..49a5df81a81
--- /dev/null
+++ b/nl-NL/deploy/README.md
@@ -0,0 +1,246 @@
+# Uitrollen!
+
+> **Opmerking** Het volgende hoofdstuk kan soms een beetje moeilijk zijn om doorheen te komen. Zet door en maak het af. Software uitrollen is een belangrijk onderdeel van het ontwikkelproces. Dit hoofdstuk staat in het midden van de tutorial zodat je je mentor om hulp kunt vragen met het online krijgen van je website, wat iets ingewikkelder is. Dit betekent dat je de tutorial later altijd nog zelf kunt afmaken als je tijd tekort komt.
+
+Tot nu toe was je website alleen maar beschikbaar op je eigen computer. Nu leer je hoe je je website kunt uitrollen! Uitrollen is het publiceren van jouw applicatie op het internet zodat mensen eindelijk jouw app kunnen zien. :)
+
+Zoals je geleerd hebt moet een website op een server geplaatst zijn. Er zijn veel server providers beschikbaar op het internet. Wij zullen [PythonAnywhere](https://www.pythonanywhere.com/) gebruiken. PythonAnywhere is gratis voor kleine applicaties die niet zoveel bezoekers hebben, dus voor nu zal het voor jou voldoende zijn.
+
+De andere externe dienst die we zullen gebruiken is [GitHub](https://www.github.com), een code hosting dienst. Er zijn ook anderen beschikbaar, maar bijna alle programmeurs hebben tegenwoordig een GitHub account, en nu jij ook!
+
+Deze drie diensten zijn belangrijk. Je eigen (lokale) computer is de plek waar je verder bouwt en test aan je applicatie. Wanneer je tevreden bent met de wijzigingen, plaats je een kopie van je programma op GitHub. Je website staat op PythonAnywhere en je kunt 'm updaten door middel van een nieuwe kopie van je code van GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Het aanmaken van je Git repository
+
+Git houdt wijzigingen in een bepaalde set bestanden bij in wat een code 'repository' (oftewel "repo" in het kort) als een soort bewaarplaats. Laten we er één creëren voor ons project. Open je console en draai de volgende commando's, in de `djangogirls` map:
+
+> **Note** Controleer of je in de goede map zit te werken met een `pwd` (Mac OS X/Linux) of `cd` (Windows) commando voordat je de repository creëert. Je zou in de `djangogirls` map moeten zitten.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Je hoeft slechts één keer per project een git repository te creëren (en je hoeft nooit meer je gebruikersnaam en e-mail in te vullen).
+
+Git houdt alle wijzigingen in alle bestanden en mappen in deze map bij, maar er zijn ook een paar bestanden die daarbij genegeerd mogen worden. We kunnen dit aangeven door een bestand genaamd `.gitignore` in de hoofdmap aan te maken. Open je editor en maak een nieuw bestand aan met de volgende inhoud:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+En sla het op als `.gitignore` in de "djangogirls" map.
+
+> **Opmerking** De punt aan het begin van de bestandsnaam is belangrijk! Als je tegen problemen aanloopt bij het creëren van het bestand (Macs vinden het niet leuk als je via de Finder een bestand dat begint met een punt aanmaakt, bijvoorbeeld), gebruik dan de "Opslaan als" functie in je editor; daar kan niks misgaan. En zorg ervoor dat je geen `.txt`, `.py`, of een andere extensie aan de bestandsnaam toevoegt -- het wordt alleen herkend door Git als de naam alléén `.gitignore` is. Linux en MacOS behandelen bestanden met een naam die begint met `.` (zoals `.gitignore`) als verborgen en het standaard `ls`-commando laat deze bestanden niet zien. Gebruik in plaats daarvan `ls -a` om he `.gitignore` bestand te zien.
+> 
+> **Opmerking** Een van de besanden die je genoemd hebt in je `.gitignore` bestand is `db.sqlite3`. Dit bestand is je lokale database waar al je gebruikers en posts worden opgeslagen. We zullen de standaard web programmeer praktijk volgen, wat betekent dat we aparte databases voor je lokale site en je live website op PythonAnywhere zullen gebruiken. De database voor PythonAnywhere zou SQLite kunnen zijn, zoals je lokale omgeving, maar meestal gebruik je een die MySQL heet. Die kan met veel meer bezoekers overweg dan SQLite. Omdat we de SQLite database negeren voor de GitHub kopie, betekent het dat de superuser en alle posts die je aangemaakt hebt alleen maar lokaal (op je eigen laptop) beschikbaar zullen zijn, en dat je voor de live website nieuwe moet creëren. Zie je lokale database als een speeltuin waar je veel verschillende dingen kunt uitproberen, zonder dat je bang hoeft te zijn dat je al je echte posts perongeluk verwijdert van je blog.
+
+Het is een goed idee om een `git status` commando te gebruiken voor `git add` of wanneer je niet meer helemaal zeker weet welke bestanden je ookalweer hebt gewijzigd. Dit voorkomt nare verrassingen, zoals het toevoegen en committen van verkeerde bestanden. Het `git status` commando weergeeft informatie over alle gewijzigde en klaargezette bestanden, de status van de 'tak' (branch) en nog veel meer. Het resultaat zou hierop moeten lijken:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Als laatste stap slaan we onze wijzigingen op. Ga naar je console en draai de volgende commando's:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Je code op GitHub zetten
+
+Ga naar [GitHub.com](https://www.github.com) en registreer een nieuwe, gratis, account. (als je dat tijdens de workshop voorbereidingen al gedaan hebt, tof!) Zorg er dan voor dat je je wachtwoord onthoudt (voeg het toe aan je wachtwoordbeheerder, als je die gebruikt).
+
+Maak dan een nieuwe repository aan, en geef hem de naam "my-first-blog". Het vakje met "initialize with a README" kun je uitgevinkt laten, de .gitignore optie kun je ook leeg laten (we hebben dat al handmatig gedaan) en laat de licentie op 'None' staan.
+
+![](images/new_github_repo.png)
+
+> **Note** De naam `my-first-blog` is belangrijk - je kunt je repo natuurlijk ook anders noemen, maar je gaat de naam heel veel tegenkomen in onderstaande instructies, dus let dan op dat je de naam elke keer goed vervangt. Het is waarschijnlijk makkelijker om gewoon de naam `'my-first-blog'` aan te houden.
+
+Op het volgende scherm zul je de clone URL van je repo zien, wat we in de volgende commando's zullen gebruiken:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Nu moeten we de GitHub repository op je computer koppelen aan de repo op GitHub.
+
+Typ het volgende in je console (vervang `<your-github-username>` met de gebruikersnaam die je hebt gekozen toen je je GitHub account creëerde, maar zonder de haken -- de URL moet overeenkomen met de URL die je zojuist gezien hebt):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Wanneer je naar GitHub pusht, wordt gevraagd naar je GitHub gebruikersnaam en wachtwoord (of rechtstreeks in je terminal, of in een pop-up), nadat je je wachtwoord en gebruikersnaam hebt ingevuld zie je ongeveer zoiets:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Je code staat nu op GitHub. Kijk maar! Je zult zien dat het in goed gezelschap verkeert - [Django](https://github.com/django/django), de [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), en vele andere gave open source projecten hebben ook hun code op GitHub staan. :)
+
+# Je blog op PythonAnywhere zetten
+
+## Meld je aan voor een PythonAnywhere account
+
+> **Opmerking** Het zou kunnen dat je al eerder een PythonAnywhere account hebt aangemaakt tijdens de installatiestappen. Als dat zo is, hoef je dat niet nog een keer te doen.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Het configureren van de site op PythonAnywhere
+
+Ga terug naar het hoofd [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) door op het logo te klikken, en kies de optie om een "Bash" console op te starten - dat is de PythonAnywhere versie van de terminal, net zoals die op je eigen computer.
+
+![De 'Nieuwe console' sectie op de PythonAnywhere web interface, met een knop voor 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Opmerking** PythonAnywhere is gebaseerd op Linux, dus als je op Windows werkt zal de terminal er een beetje anders uitzien dan die op je eigen computer.
+
+Voor het deployen van de applicatie op PythonAnywhere moeten we de code van GitHub overhevelen, en dan PythonAnywhere configureren om het te herkennen en als webapplicatie te behandelen. Er zijn manieren om dit handmatig te doen, maar PythonAnywhere heeft ook een hulpmiddel dat dit allemaal voor je doet. Laten we dat eerst installeren:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+Dat zou enkele dingen als `Collecting pythonanywhere` moeten printen, en uiteindelijk eindigen met een regel die zegt `Successfully installed (...) pythonanywhere- (...)`.
+
+Nu draaien we het hulpmiddel om onze app automatisch vanaf GitHub te configureren. Typ het volgende in de console op PythonAnywhere (vergeet niet om je GitHub gebruikersnaam in te vullen in plaats van `<your-github-username>`, zodat de URL overeenkomt met de URL van GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+Als je kijkt wat er gebeurt, zie je wat het doet:
+
+- Je code wordt van GitHub gedownload
+- Er wordt een virtualenv aangemaakt op PythonAnywhere, net als op je eigen computer
+- Het bestand met settings wordt geupdatet met wat settings voor de deploy
+- Er wordt een database opgesteld op PythonAnywhere met behulp van het `manage.py migrate` commando
+- Je statische bestanden worden klaargezet (je leert hier straks meer over)
+- PythonAnywhere wordt geconfigureerd om via de API jouw webapplicatie te tonen
+
+Op PythonAnywhere zijn al deze stappen geautomatiseerd, maar het zijn dezelfde stappen die je met een andere provider zou moeten doorlopen.
+
+Het voornaamste wat je nu moet onhouden is dat je database op PythonAnywhere volledig gescheiden is van de database op je eigen computer, dus je kunt verschillende posts en admin accounts hebben. Daarom moeten we, net zoals we net op je eigen computer gedaan hebben, de admin account weer initialiseren met `createsuperuser`. PythonAnywhere heeft al automatisch je virtualenv voor je gestart, dus alles wat je hoeft te doen is:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Typ de details in voor je admin gebruiker. Het is het handigst als je dezelfde gebruikt als op je eigen computer om verwarring te voorkomen, tenzij je het wachtwoord op PythonAnywhere veiliger wil maken.
+
+Als je wil kun je nu ook kijken naar je code op PythonAnywhere door `ls` te gebruiken:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+Je kunt ook naar de "Files" pagina gaan en door je bestanden navigeren met behulp van de ingebouwde PythonAnywhere bestandsbrowser. (vanaf de Console pagina kun je naar andere pagina's in PythonAnywhere via de menuknop in de rechterbovenhoek. Zodra je op één van de pagina's bent zijn er links naar de andere pagina's aan de bovenkant.)
+
+## Je bent live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Opmerking** Dit is een tutorial voor beginners, en tijdens het deployen hebben we een aantal stappen genomen die vanuit een veiligheidsoogpunt niet ideaal zijn. Als en wanneer je besluit om dit project voort te zetten, of met een nieuw project begint, is het handig om de [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) te bekijken voor wat tips om je site beter te beveiligen.
+
+## Debugging tips
+
+Als je een error ziet terwijl je het `pa_autoconfigure_django.py` script draait, zijn dit de meest voorkomende oorzaken:
+
+- Vergeten om je PythonAnywhere API token aan te maken.
+- Een foutje in je GitHub URL
+- Als je een error ziet die meldt *"Could not find your settings.py"*, komt dat waarschijnlijk omdat het niet gelukt is om al je bestanden aan Git toe te voegen, en/of het is niet gelukt om ze naar GitHub te sturen. Kijk nog eens naar het Git hoofdstuk hierboven
+- Als je je eerder aangemeld hebt voor een PythonAnywhere account en een fout had met collectstatic, heb je waarschijnlijk een oudere versie van SQLite (bijv. 3.8.2) voor uw account. Meld je in dat geval aan voor een nieuw account en probeer de commando's in de PythonAnywhere sectie hierboven.
+
+Als je een errormelding krijgt als je je site probeert te bezoeken is de eerste plek om te kijken voor wat debugging informatie is in de **error log**. Je vindt een link naar de logs op de PythongAnywhere ["Web" pagina](https://www.pythonanywhere.com/web_app_setup/). Kijk of er daar errormeldingen zijn; de meest recente staan onderaan.
+
+Er zijn ook wat meer [algemene debugging tips op de PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+En vergeet niet, je coach is hier om je te helpen!
+
+# Bekijk je site!
+
+De standaardpagina voor uw site zou "It worked" moeten zeggen, net zoals het op uw lokale computer doet. Probeer `/admin/` toe te voegen aan het einde van de URL, en je zal worden meegenomen naar de admin site. Log in met de gebruikersnaam en wachtwoord, en u ziet dat u nieuwe posts kunt toevoegen op de server -- Vergeet niet dat de berichten van uw lokale testdatabase niet naar uw live blog zijn verzonden.
+
+Zodra u een paar posts hebt aangemaakt, kunt u terugkeren naar uw lokale setup (niet PythonAnywhere). Vanaf hier moet u werken aan uw lokale setup om veranderingen te maken. Dit is een veel gebruikte workflow in de webontwikkeling – maak lokaal veranderingen, push deze wijzigingen naar GitHub en trek de wijzigingen naar uw live Web server. Dit stelt je in staat om te werken en te experimenteren zonder je live Web site te breken. Gaaf, toch?
+
+Geef jezelf een *FLINK* schouderklopje! Serverimplementaties zijn een van de moeilijkste onderdelen van de webontwikkeling en het kost vaak enkele dagen voordat ze werken. Maar je site is live, op het echte internet!
\ No newline at end of file
diff --git a/nl-NL/deploy/install_git.md b/nl-NL/deploy/install_git.md
new file mode 100644
index 00000000000..3237b9843bb
--- /dev/null
+++ b/nl-NL/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is een "version control system" ("versie controle systeem") dat door veel programmeurs gebruikt wordt. Deze software houdt de wijzigingen in een bestand bij zodat je later weer een specifieke versie kunt opvragen. Een beetje zoals de "wijzigingen bijhouden" functie in een wordprocessor (zoals Microsoft Word of LibreOffice Writer), maar veel geavanceerder.
+
+## Git Installeren
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Je kunt Git downloaden van [git-scm.com](https://git-scm.com/). Je kunt bij alle stappen op "volgende" drukken behalve bij deze twee: in de stap waar je gevraagd wordt je editor te kiezen, kies je voor Nano, en in de stap genaamd "Adjusting your PATH environment" kies je voor "Use Git and optional Unix tools from the Windows Command Prompt" (de laatste optie). Op die na zijn alle standaardinstellingen prima. "Checkout Windows-style, commit Unix-style line endings" is goed.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git van [git-scm.com](https://git-scm.com/) en volg de aanwijzingen.
+
+> **Opmerking** Als je OS X 10.6, 10.7 of 10.8 gebruikt, moet je de versie van git hiervandaan installeren: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/nl-NL/deploy/signup_pythonanywhere.md b/nl-NL/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..68a4a0cbd2b
--- /dev/null
+++ b/nl-NL/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is een service om Python code "in de cloud" te runnen. Wij zullen het gaan gebruiken om onze site op te hosten, live en op het internet.
+
+We zullen de blog die we bouwen op PythonAnywhere hosten. Meld je aan voor een "Beginner" account op PythonAnywhere (de gratis rang is prima, je hebt geen creditcard nodig).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![De PythonAnywhere aanmeldingspagina met de knop om een gratis 'Beginner' account te maken](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Opmerking** Bij het kiezen van uw gebruikersnaam, vergeet niet dat de URL van uw blog de vorm `jouwgebruikersnaam.pythonanywhere.com` zal aannemen, dus kies ofwel uw eigen (bij)naam of een naam met waar uw blog over gaat. Sla uw wachtwoord goed op (voeg deze eventueel toe aan uw wachtwoordbeheerder, als u er een gebruikt).
+
+## Een PythonAnywhere API-token maken
+
+Dit is iets wat je maar één keer hoeft te doen. Wanneer je je hebt aangemeld voor PythonAnywhere, zal je worden meegenomen naar je dashboard. Vind de link in de buurt van de rechterbovenkant van je "Account" pagina:
+
+![Account link rechts boven op de pagina](../deploy/images/pythonanywhere_account.png)
+
+selecteer dan het tabblad "API token" en druk op de knop die zegt "Nieuwe API token maken".
+
+![De API token tab op de accountpagina](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/nl-NL/django/README.md b/nl-NL/django/README.md
new file mode 100644
index 00000000000..334231fc455
--- /dev/null
+++ b/nl-NL/django/README.md
@@ -0,0 +1,27 @@
+# Wat is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is een gratis en open source web-framework, geschreven in Python. Een web-framework is een set onderdelen die je helpen om sneller en makkelijker websites te maken.
+
+Als je een website aan het bouwen bent, dan heb je altijd een vergelijkbare set aan onderdelen nodig: een manier om met gebruikersauthenticatie om te gaan (registreren, inloggen, uitloggen), een beheerderspaneel voor de website, formulieren, een manier om bestanden te uploaden, etc.
+
+Gelukkig voor ons hebben andere mensen allang opgemerkt dat webontwikkelaars steeds dezelfde problemen tegenkomen bij het bouwen van een nieuwe site, dus zijn ze samen opgetrokken en hebben verschillende frameworks gecreëerd (Django is daar één van) die je kant-en-klare onderdelen geven om te gebruiken.
+
+Frameworks zijn er dus om te voorkomen dat je steeds het wiel opnieuw hoeft uit te vinden en om dubbel werk te voorkomen bij het bouwen van een nieuwe site.
+
+## Waarom heb je een framework nodig?
+
+Om beter te begrijpen wat Django precies doet moeten we kijken naar de servers. Het allereerste wat een server moet weten is dat jij wil dat de server jou een website voorschotelt.
+
+Stel je een postbus (port) voor die binnenkomende brieven (requests) controleert. Dit wordt gedaan door een webserver. De webserver leest de brief en verstuurt vervolgens een antwoord met een webpagina. Maar wanneer je wat wilt sturen, heb je ook wat inhoud nodig. Django is iets wat je helpt de inhoud te creëren.
+
+## Wat gebeurt er als iemand een website opvraagt van jouw server?
+
+Wanneer een request wordt ingediend bij de webserver, wordt het doorgespeeld naar Django, wat vervolgens probeert uit te zoeken wat er precies gevraagd wordt. Het kijkt eerst naar het adres van de webpagina om te bepalen wat er moet gebeuren. Dit gedeelte wordt gedaan door Django's **urlresolver** (het adres van een website wordt ook wel URL genoemd - Uniform Resource Locator - dus de naam *urlresolver* betekent 'url oplosser'). De urlresolver is niet heel slim: het kijkt gewoon naar patronen en probeert een overeenkomst met de URL te vinden. Django controleert de patronen van boven naar beneden en als er een overeenkomst is gevonden wordt de request doorgestuurd naar de bijbehorende functie (die een *view* genoemd wordt).
+
+Stel je een postbode met een brief voor. Ze loopt langs de straat en controleert elk huisnummer met die op de brief. Wanneer het overeenkomt, brengt ze de brief daar. Dit is hoe de urlresolver werkt!
+
+In de *view* functie worden alle interessante dingen gedaan: we kunnen de database bekijken en er informatie uit opvragen. Misschien heeft de gebruiker gevraagd om iets in de data te wijzigen? Net zoals een brief met het verzoek "verander alsjeblieft de omschrijving van mijn baan", kan de *view* controleren of je daar wel toestemming voor hebt. Als je die toestemming hebt wordt de omschrijving geüpdatet en wordt een bericht teruggestuurd met: "Gedaan!" Vervolgens genereert de *view* een antwoord wat Django naar de webbrowser van de gebruiker kan sturen.
+
+Bovenstaande beschrijving is een beetje versimpeld, maar je hoeft nog niet alle technische details te weten. Een algemeen beeld hebben is voor nu voldoende.
+
+Dus in plaats van dat we de details induiken, beginnen we met het maken van iets met Django en leren we alle belangrijke dingen terwijl we er mee bezig zijn!
\ No newline at end of file
diff --git a/nl-NL/django_admin/README.md b/nl-NL/django_admin/README.md
new file mode 100644
index 00000000000..f7c6b553e16
--- /dev/null
+++ b/nl-NL/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+Om berichten die we zojuist gemodelleerd hebben toe te voegen, te bewerken of te verwijderen, gebruiken we de Django admin.
+
+Laten we het `blog/admin.py` bestand openen in de code editor en de inhoud daarvan vervangen door:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Zoals je ziet importeren we het Post model omschreven in het vorige hoofdstuk. Om ons model zichtbaar te maken op de admin pagina, moeten we het model eerst registreren met `admin.site.register(Post)`.
+
+OK, nu is het tijd om ons Post model te bekijken. Vergeet niet om `python manage.py runserver` te draaien in de terminal om de webserver op te starten. Open je browser en typ het adres http://127.0.0.1:8000/admin/. Je ziet een loginpagina zoals deze:
+
+![Login pagina](images/login_page2.png)
+
+Om in te loggen moet je eerst een *superuser* aanmaken: een gebruikersaccount wat controle heeft over de hele site. Ga terug naar je terminal en typ `python.manage.py createsuperuser`, en druk op enter.
+
+> Onthoud: om nieuwe commando's in te voeren terwijl de webserver nog draait moet je een nieuw terminalscherm openen en je virtualenv activeren. We hebben uitgelegd hoe je nieuwe commando's moet schrijven in het **Je eerste Django project!** hoofdstuk, in het **De webserver opstarten** gedeelte.
+
+{% filename %}Mac OS X of Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Wanneer gevraagd, voer je username (kleine letters, zonder spaties), email adres en wachtwoord in. **Maak je geen zorgen als je niet kunt zien wat je typt bij het invoeren van je wachtwoord - dat hoort.** Typ het in en druk op `enter` om verder te gaan. De uitvoer zou er als volgt uit moeten zien (met natuurlijk je eigen gebruikersnaam en email):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Ga weer terug naar je browser. Log in met de gegevens van de superuser die je zojuist hebt aangemaakt; je zou nu het dashboard van de Django admin moeten zien.
+
+![Django admin](images/django_admin3.png)
+
+Ga naar Posts en experimenteer er er een beetje mee. Voeg vijf of zes blogposts toe. Maak je geen zorgen over de inhoud - het is alleen zichtbaar op je lokale computer -- je kunt tekst kopiëren en plakken van deze tutorial om tijd te besparen. :)
+
+Zorg ervoor dat ten minste twee of drie posts (maar niet alle) een publicatiedatum hebben. Dit zal later van pas komen.
+
+![Django beheer](images/edit_post3.png)
+
+Als je meer wil weten over de Django admin, neem dan eens een kijkje in Django's documentatie: https://docs.djangoproject.com/en/2.2/ref/contrib/admin
+
+Dit is een goed moment om jezelf te trakteren op een kopje koffie (of thee), of om even wat te eten om weer energie te krijgen. Je hebt net je eerste Django model gemaakt - je verdient een kleine pauze!
\ No newline at end of file
diff --git a/nl-NL/django_forms/README.md b/nl-NL/django_forms/README.md
new file mode 100644
index 00000000000..a7232bd5c62
--- /dev/null
+++ b/nl-NL/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django formulieren
+
+Het laatste wat we nog willen doen op onze website is een mooie manier maken om blogposts toe te voegen en te bewerken. Django's `admin` is cool, maar het is nogal moeilijk om aan te passen en mooi te maken. Met `forms` hebben we absolute controle over onze interface - we kunnen bijna alles doen wat we willen!
+
+Het mooie aan Django formulieren is dat we óf één helemaal zelf kunnen definiëren, óf een `ModelForm` kunnen maken waarmee de inhoud van het formulier in het model opgeslagen wordt.
+
+Dit is precies wat we willen doen: we gaan een formulier maken voor ons `Post` model.
+
+Zoals elk belangrijk onderdeel van Django, hebben formulieren hun eigen bestand: `forms.py`.
+
+Eerst maken we een bestand aan met deze naam in de `blog` map.
+
+    blog
+       └── forms.py
+    
+
+Ok, open het bestand in je editor en schrijf de volgende code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We moeten eerst Django formulieren importeren (`from django import forms`), net zoals ons `Post` model (`from .models import Post`).
+
+Zoals je waarschijnlijk al door hebt, is `PostForm` de naam van ons formulier. We moeten Django vertellen dat dit formulier een `ModelForm` is (zodat Django automatisch wat magie voor ons uitvoert). Daar zorgt `forms.ModelForm` voor.
+
+Vervolgens hebben we `class Meta`, waar we Django vertellen welk model gebruikt moet worden om dit formulier te creëren (`model=Post`).
+
+Tot slot kunnen we zeggen welke velden ons formulier moet hebben. In dit voorbeeld willen we alleen de `title` en `text` zichtbaar hebben - `author` moet de persoon zijn die op dat moment is ingelogd (jij!) en `created_date` zou automatisch aangemaakt moeten worden op het moment dat we een post maken (door middel van code), toch?
+
+Dat was het! Het enige wat we nu moeten doen is het formulier via een *view* in een template zichtbaar maken.
+
+Daarvoor maken we wederom een link naar de pagina, een URL, een view en een template.
+
+## Link naar een pagina met het formulier
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We moeten het formulier weergeven. Dit kunnen we doen met (bijvoorbeeld) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We hebben een `Opslaan` -knop nodig. Dat doen we met een HTML-knop: `<button type="submit">Opslaan</button>`.
+* En ten slotte, net na de opening `<form ...>`-tag moeten we {% raw %}`{% csrf_token %}`{% endraw %} toevoegen. Dat is heel belangrijk, want het maakt je formulieren veilig! Als je dit stuk vergeet, zal Django klagen wanneer je het formulier probeert te bewaren:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Het formulier opslaan
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Formulier checken
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Formulier aanpassen
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Beveiliging
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/nl-NL/django_installation/README.md b/nl-NL/django_installation/README.md
new file mode 100644
index 00000000000..61dafc3b996
--- /dev/null
+++ b/nl-NL/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installatie
+
+> **Opmerking** Als je een Chromebook gebruikt, sla dan dit hoofdstuk over en zorg ervoor dat je de [Chromebook Setup](../chromebook_setup/README.md) instructies volgt.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/nl-NL/django_installation/instructions.md b/nl-NL/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/nl-NL/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/nl-NL/django_models/README.md b/nl-NL/django_models/README.md
new file mode 100644
index 00000000000..039e6bcde02
--- /dev/null
+++ b/nl-NL/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+Wat we nu willen maken is iets dat alle berichten zal opslaan in onze blog. Maar om dat te kunnen doen moeten we het eerst hebben over `objecten`.
+
+## Objecten
+
+Er bestaat een concept binnen programmeren dat `object-georiënteerd programmeren` wordt genoemd. Het idee is dat, in plaats van alles als een saaie opeenvolging van programmeerinstructies te schrijven, we dingen kunnen modelleren en definiëren hoe ze omgaan met elkaar.
+
+Dus wat is een object? Het is een verzameling eigenschappen en acties. Het klinkt raar, maar we zullen je een voorbeeld geven.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/nl-NL/django_orm/README.md b/nl-NL/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/nl-NL/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/nl-NL/django_start_project/README.md b/nl-NL/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/nl-NL/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/nl-NL/django_templates/README.md b/nl-NL/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/nl-NL/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/nl-NL/django_urls/README.md b/nl-NL/django_urls/README.md
new file mode 100644
index 00000000000..f115dbc2d0e
--- /dev/null
+++ b/nl-NL/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URL's
+
+We gaan onze eerste webpagina maken: een homepage voor je blog! Maar laten we eerst wat leren over Django URL's.
+
+## Wat is een URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/nl-NL/django_views/README.md b/nl-NL/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/nl-NL/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/nl-NL/dynamic_data_in_templates/README.md b/nl-NL/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/nl-NL/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/nl-NL/extend_your_application/README.md b/nl-NL/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/nl-NL/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/nl-NL/how_the_internet_works/README.md b/nl-NL/how_the_internet_works/README.md
new file mode 100644
index 00000000000..8df9d5cb6cf
--- /dev/null
+++ b/nl-NL/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Hoe het internet werkt
+
+> Voor thuislezers: dit hoofdstuk wordt behandeld in de [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> Dit hoofdstuk is geïnspireerd door de presentatie "How the Internet works" door Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+Gokje: je gebruikt het Internet zeker elke dag? Maar weet je écht wat er gebeurt als je een adres zoals https://djangogirls.org in je browser ingeeft en op de `enter` knop drukt?
+
+Het eerste wat je moet weten is dat een website gewoon wat bestanden zijn die bij elkaar op een harde schijf staan -- net zoals je films, je muziek of je foto's. Er is echter één dingetje dat uniek is voor websites: ze bevatten computercode genaamd HTML.
+
+Als je nog niet zo bekend bent met programmeren, kan het in het begin lastig zijn om HTML te begrijpen. Je webbrowsers (zoals Chrome, Safari, Firefox, etc.) zijn er anders wel gek op. Web browsers zijn ontworpen om deze code te begrijpen. Ze volgen de instructies in die code en tonen de bestanden waar jouw website uit bestaat, precies zoals jij het wilt.
+
+Net zoals bij elk bestand, moeten we de HTML bestanden ergens op een harde schijf opslaan. Voor het Internet gebruiken we speciale, krachtige computers genaamd *servers*. Ze hebben geen scherm, muis of toetsenbord omdat hun voornaamste doel het opslaan en serveren (aanleveren) van gegevens is (denk aan een serveerster die in een restaurant jouw bestelde drankje komt aanleveren). Dit is waarom ze *servers* worden genoemd - omdat ze jouw data *serveren*.
+
+Ok, maar je wilt weten hoe het internet er uit ziet, nietwaar?
+
+We hebben een plaatje voor jou getekend! Het ziet er zo uit:
+
+![Figuur 1.1](images/internet_1.png)
+
+Ziet er uit als een puinhoop, toch? In feite is het een netwerk van aaneengesloten machines (de hierboven genoemde *servers*). Honderdduizenden machines! Vele, vele kilometers kabels over de hele wereld! Je kunt een onderzeeër kabel kaart website bekijken (http://submarinecablemap.com) om te zien hoe ingewikkeld het net is. Hier is een screenshot van de website:
+
+![Figuur 1.2](images/internet_3.png)
+
+Het is fascinerend, nietwaar? Maar het is uiteraard niet mogelijk om een kabel te hebben tussen elk apparaat dat verbonden is met het internet. Dus, om een machine te bereiken (bijvoorbeeld degene waarop https://djangogirls.org staat), moeten we een verzoek versturen dat langs vele, vele verschillende machines gaat.
+
+Het ziet er zo uit:
+
+![Figuur 1.3](images/internet_2.png)
+
+Stel je voor dat wanneer je naar https://djangogirls.org een brief typt waarin staat: "Beste Django Girls, ik wil de djangogirls.org website zien. Stuur die naar me, alsjeblieft! "
+
+Je brief gaat naar het dichtsbijzijnde postkantoor. Dan gaat 'ie naar een ander postkantoor iets dichter bij de bestemming, dan naar een volgend postkantoor nog wat dichterbij, en weer één daaropvolgend, totdat de brief afgeleverd kan worden op diens eindbestemming. Het bijzondere is nu dat als je meerdere brieven stuurt (*data pakketten*) naar dezelfde bestemming, ze via héél verschillende postkantoren (*routers*) kunnen gaan. Dit hangt er maar vanaf hoe ze verdeeld worden op ieder postkantoor.
+
+![Figuur 1.4](images/internet_4.png)
+
+Zo werkt het - je verstuurt een bericht en verwacht een antwoord. In plaats van pen en papier gebruik je bytes met gegevens, maar het idee is hetzelfde!
+
+In plaats van adressen met een straatnaam, woonplaats, postcode en landnaam gebruiken we IP-adressen. Je computer vraagt eerst aan het DNS (Domein Naam Systeem) om 'djangogirls.org' om te zetten naar een IP-adres. Dat werkt een beetje als een ouderwets telefoonboek waarin je de naam kunt opzoeken van de persoon die je wilt bellen en dan diens telefoonnummer en adres vindt.
+
+Als je een brief verstuurt, moet die brief gekenmerkt worden met een adres, een postzegel en dergelijke om goed af te kunnen leveren. Je gebruikt ook een taal die de ontvanger begrijpt, nietwaar? Datzelfde geldt voor de *data pakketten* die je verzendt om een website te zien. We gebruiken een werkvoorschrift dat HTTP (Hypertext Transfer Protocol) heet.
+
+In principe moet je, als je een web site hebt, een *server* (machine) hebben waarop die web site staat. Als de *server* een inkomend *verzoek* ontvangt (in een brief), verstuurt hij de web site terug (in een andere brief).
+
+Aangezien dit een Django tutorial is, vraag je je misschien af wat Django dan doet. Als je een antwoord verzendt, wil je niet altijd precies hetzelfde naar iedereen sturen. Een persoonlijke touch toevoegen aan de brieven is veel fijner, vooral voor degene die jou net aangeschreven had, toch? Django helpt je met het opstellen van deze persoonlijke, interessante brieven. :)
+
+Genoeg gekletst nu; tijd om iets te maken!
\ No newline at end of file
diff --git a/nl-NL/html/README.md b/nl-NL/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/nl-NL/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/nl-NL/installation/README.md b/nl-NL/installation/README.md
new file mode 100644
index 00000000000..48a4facaf2f
--- /dev/null
+++ b/nl-NL/installation/README.md
@@ -0,0 +1,68 @@
+# Als je deze tutorial thuis volgt
+
+Als je deze tutorial thuis volgt en niet op een van de [Django Girls evenementen](https://djangogirls.org/events/), kun je dit hoofdstuk in z'n geheel overslaan en rechtstreeks naar het [Hoe werkt het internet](../how_the_internet_works/README.md) hoofdstuk gaan.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/nl-NL/intro_to_command_line/README.md b/nl-NL/intro_to_command_line/README.md
new file mode 100644
index 00000000000..59d40351706
--- /dev/null
+++ b/nl-NL/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introductie van de opdrachtregel
+
+> Voor thuislezers: dit hoofdstuk wordt behandeld in de [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/nl-NL/intro_to_command_line/open_instructions.md b/nl-NL/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..344b9d2d2e5
--- /dev/null
+++ b/nl-NL/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Afhankelijk van je Windowsversie en je soort toetsenbord, zou één van de volgende commando's een venster moeten openen (je moet misschien een beetje experimenteren, maar je hoeft vast niet al deze suggesties te proberen):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/nl-NL/python_installation/README.md b/nl-NL/python_installation/README.md
new file mode 100644
index 00000000000..02c7df5c9a6
--- /dev/null
+++ b/nl-NL/python_installation/README.md
@@ -0,0 +1,15 @@
+# Laten we beginnen met Python
+
+We zijn er eindelijk!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/nl-NL/python_installation/instructions.md b/nl-NL/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/nl-NL/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/nl-NL/python_introduction/README.md b/nl-NL/python_introduction/README.md
new file mode 100644
index 00000000000..1f7f1b3841b
--- /dev/null
+++ b/nl-NL/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Inleiding Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## De Python command prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/nl-NL/template_extending/README.md b/nl-NL/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/nl-NL/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/nl-NL/whats_next/README.md b/nl-NL/whats_next/README.md
new file mode 100644
index 00000000000..37b2207ae2b
--- /dev/null
+++ b/nl-NL/whats_next/README.md
@@ -0,0 +1,43 @@
+# Wat nu?
+
+Feliciteer jezelf! **Je bent helemaal geweldig**. Wij zijn trots! <3
+
+### Wat moet je nu doen?
+
+Take a break and relax! You have just done something really huge.
+
+Volg Django Girls op [Facebook](http://facebook.com/djangogirls) of [Twitter](https://twitter.com/djangogirls) om up to date te blijven.
+
+### Kan je andere bronnen aanbevelen?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/nl/GLOSSARY.md b/nl/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/nl/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/nl/README.md b/nl/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/nl/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/nl/SUMMARY.md b/nl/SUMMARY.md
new file mode 100644
index 00000000000..9ef04c0a3f3
--- /dev/null
+++ b/nl/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installatie](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [Hoe het internet werkt](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Inleiding Python](python_introduction/README.md)
+* [Wat is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Uitrollen!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/nl/chromebook_setup/README.md b/nl/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/nl/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/nl/chromebook_setup/instructions.md b/nl/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/nl/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/nl/code_editor/README.md b/nl/code_editor/README.md
new file mode 100644
index 00000000000..16a79113b88
--- /dev/null
+++ b/nl/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> Voor de lezers thuis: dit hoofdstuk wordt behandeld in de [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+Je staat op het punt om je eerste regel code te schrijven. Tijd om een code editor te downloaden!
+
+> **Opmerking** Als je een Chromebook gebruikt, sla dit hoofdstuk dan over en zorg ervoor dat je de [Chromebook installatie](../chromebook_setup/README.md) instructies volgt.
+> 
+> **Opmerking** Het zou kunnen dat je dit eerder in het Installatie hoodstuk al gedaan hebt. Als dat zo is kun je rechtstreeks door naar het volgende hoofdstuk!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/nl/code_editor/instructions.md b/nl/code_editor/instructions.md
new file mode 100644
index 00000000000..0327cb14b21
--- /dev/null
+++ b/nl/code_editor/instructions.md
@@ -0,0 +1,31 @@
+Er zijn ontzettend veel verschillende code editors en het komt grotendeels neer op persoonlijke voorkeur. De meeste Python programmeurs gebruiken complexe maar uiterst krachtige IDEs (geïntegreerde software-ontwikkelomgeving) zoals PyCharm. Dat is waarschijnlijk minder geschikt voor een beginner. Onze aanbevelingen zijn even krachtig en een stuk eenvoudiger.
+
+Onze suggesties staan hieronder, maar vraag gerust je coach wat hun voorkeur is - het maakt het makkelijker om hulp van hen te krijgen.
+
+## Gedit
+
+Gedit is een open-source, gratis programma dat beschikbaar is voor alle besturingssystemen.
+
+[Download het hier](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download het hier](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download het hier](https://atom.io/)
+
+## Waarom installeren wij een code editor?
+
+Je vraagt je misschien af waarom we een speciaal bewerkingsprogramma installeren, in plaats van een programma als Word of Notepad te gebruiken.
+
+De eerste reden is dat de code **plain text** (platte tekst) moet zijn, en het probleem met programma's zoals Word en Textedit is dat ze helemaal geen plain text produceren: ze produceren rich text (met lettertypes en opmaak), die ze opslaan als [RTF (Rich Text Format](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+De tweede reden is dat alle code editors gespecialiseerd zijn in het schrijven van code, zodat ze nuttige functies hebben zoals het markeren van de code met kleur, of automatisch aanhalingstekens sluiten.
+
+We zien dit later allemaal in actie. Al snel zul je je oude vertrouwde editor als een van je favoriete gereedschappen beschouwen. :)
\ No newline at end of file
diff --git a/nl/css/README.md b/nl/css/README.md
new file mode 100644
index 00000000000..62290ec652d
--- /dev/null
+++ b/nl/css/README.md
@@ -0,0 +1,304 @@
+# CSS - Maak het mooi!
+
+Onze blog ziet er nog steeds nogal lelijk uit, toch? Tijd om hem mooi te maken! Daarvoor gebruiken we CSS.
+
+## Wat is CSS?
+
+Cascading Style Sheets (CSS) is een taal die gebruikt wordt om het uiterlijk en de opmaak van een website geschreven in markup taal (zoals HTML) te beschrijven. Zie het als make-up voor onze webpagina. ;)
+
+Maar we willen niet weer helemaal vanuit het niets beginnen, toch? We maken wederom gebruik van iets wat programmeurs gratis via het internet delen. Het wiel opnieuw uitvinden is saai, toch?
+
+## We maken gebruik van Bootstrap!
+
+Bootstrap is een van de meest populaire HTML en CSS frameworks om mooie websites te ontwikkelen: https://getbootstrap.com/
+
+Het werd geschreven door programmeurs die voor Twitter werkten. Nu wordt het onderhouden door vrijwillers van over de hele wereld!
+
+## Bootstrap installeren
+
+Om Bootstrap te installeren moet je het volgende toevoegen aan je `.html` bestand:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+Dit voegt geen bestanden toe aan je project. Het verwijst alleen naar bestanden die al op het internet staan. Probeer maar eens: Open je website en vernieuw de pagina. Dit is het resultaat!
+
+![Figuur 14.1](images/bootstrap1.png)
+
+Dit ziet er al een stuk beter uit!
+
+## Statische bestanden in Django
+
+Tenslotte zullen we een kijkje nemen naar de bestanden die we **statische bestanden** hebben genoemd. Statische bestanden zijn al je CSS-bestanden en afbeeldingen. Hun inhoud is niet afhankelijk van de context en is hetzelfde voor elke gebruiker.
+
+### Waar zet je statische bestanden in Django
+
+Django weet al waar het de statische bestanden voor de ingebouwde 'admin'-app kan vinden. Nu hoeven we slechts wat statische bestanden voor onze eigen app, `blog`, toe te voegen.
+
+We doen dit door een folder met de naam `static` aan te maken binnenin de blog applicatie:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django vindt automatisch mappen die "static" genoemd zijn binnen je applicatiemappen, en kan de inhoud daarvan vervolgens als statische bestanden gebruiken.
+
+## Je eerste CSS bestand!
+
+Laten we een CSS-bestand aanmaken, om je eigen stijl aan je website toe te voegen. Maak een nieuwe map aan genaamd: `css` binnen je `static` map. Maak daarna een nieuw bestand genaamd: `blog.css` aan binnen deze `css` map. Klaar?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Tijd om wat CSS te schrijven! Open het `blog/static/css/blog.css` bestand in je code editor.
+
+We zullen hier niet te diep ingaan op het customiseren en leren over CSS. Er staan een aanbeveling voor een gratis cursus CSS op het einde van deze pagina als je meer wil leren hierover.
+
+Maar laten we wat details veranderen. Misschien kunnen we de kleur van onze header veranderen? Om kleuren te begrijpen gebruiken computers speciale kleurcodes. Deze codes beginnen met `#`, gevolgd door een combinatie van 6 letters (A-F) en cijfers (0-9). De code voor de kleur blauw is bijvoorbeeld `#0000FF`. Je vindt een groot overzicht van kleurcodes hier: http://www.colorpicker.com/. Je kunt ook voorgedefinieerde kleuren gebruiken zoals `red` en `green`.
+
+In je `blog/static/css/blog.css` bestand moet je de volgende code toevoegen:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a{
+    color: #FCA205;
+}
+```
+
+`h1 a` is een CSS Selector. Dit betekent dat we onze stijl toepassen op elk `a` element binnen een `h1` element. Dus als we bijvoorbeeld iets hebben als `<h1><a href="">link</a></h1>`, wordt de `h1 a` stijl die we hebben opgegeven toegepast. In dit geval vertellen we het element zijn kleur te veranderen naar `#FCA205`, wat oranje is. Natuurlijk kun je hier elke kleur opgeven die je wilt!
+
+In een CSS bestand bepalen we de stijl voor de elementen in het HTML bestand. De eerste manier waarop we elementen identificeren, is met de naam van het element. Je hebt deze eerder voorbij zien komen als tags uit het HTML hoofdstuk. Dingen zoals `a`, `h1` en `body` zijn allemaal namen van elementen. We kunnen elementen ook identificeren bij het attribuut `class` of het attribuut `id`. Class en id zijn namen die je zelf aan een element geeft. Een class definieert een groep van elementen, en id's verwijzen naar specifieke elementen. Je kunt bijvoorbeeld de volgende tag identificeren door de tag naam `a`, de class `external_link`, of het id `link_to_wiki_page` te gebruiken:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Je kunt meer over CSS lezen op [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We moeten ook ons HTML template laten weten dat we wat CSS toegevoegd hebben. Open het `blog/templates/blog/post_list.html` bestand en voeg deze regel toe, helemaal bovenaan het bestand:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We laden hier aleen de statische bestanden in. :) Tussen de `<head>` en `</head>` tags, na de link naar de Bootstrap bestanden, voeg je deze regel toe:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+De browser leest bestanden in de opgegeven volgorde, dus we moeten ervoor zorgen dat dit op de juiste plek staat. Anders wordt de code in ons bestand overschreven door de code in de Bootstrap bestanden. We hebben net aan onze template verteld waar onze CSS staat.
+
+Je bestand zou er nu zo uit moeten zien:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Ok, sla het bestand op en vernieuw de site!
+
+![Figuur 14.2](images/color2.png)
+
+Goed werk! Misschien moeten we onze site een beetje ruimte geven en de marge aan de linker kant groter maken? Laten we dit proberen!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Voeg dit aan je CSS toe, sla het bestand op, en kijk wat er veranderd is!
+
+![Figuur 14.3](images/margin2.png)
+
+Misschien kunnen we het lettertype in onze header aanpassen? Kopieer en plak dit in je `<head>` in het `blog/templates/blog/post_list.html` bestand:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Let weer op de volgorde en zet het vóór de link naar `blog/statig/css/blog.css`. Deze regel importeert een lettertype van Google wat *Lobster* heet. (https://www.google.com/fonts).
+
+Zoek het `h1 a` declaratieblok op (de code tussen de haken `{` en `}`) in het CSS bestand `blog/static/css/blog.css`. Voeg nu de regel `font-family: 'Lobster';` toe tussen de haken, en ververs je pagina:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figuur 14.3](images/font.png)
+
+Geweldig!
+
+Zoals hierboven vermeld, hanteert CSS een concept van klassen. Hiermee kun je een deel van je HTML code een naam geven, en een stijl alleen op dit gedeelte toepassen zonder gevolgen voor de andere delen. Dit is super handig! Misschien heb he bijvoorbeeld twee divs die allebei iets anders doen (bijvoorbeeld je header en je blog post). Met behulp van een klasse kun je ze anders stylen.
+
+Leef je uit en benoem delen van je HTML code. Voeg als volgt een klasse genaamd `page-header` toe aan de `div` die de header bevat:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+En voeg nu de klasse `post` toe aan de `div` die je blog post bevat.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We gaan nu declaratieblokken toevoegen aan verschillende selectors. Selectors die beginnen met `.` hebben betrekking op klassen. Er is heel veel goede uitleg en tutorials over CSS te vinden op het web die je kunnen helpen om de volgende code te begrijpen. Voor nu, knip-en-plak gewoon onderstaande code in je `blog/static/css/blog.css` bestand:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Vervolgens omring je de HTML code die die posts weergeeft met klassedeclaraties. Vervang dit:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in `blog/templates/blog/post_list.html` met dit:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Sla de bestanden op en ververs je website.
+
+![Figuur 14.4](images/final.png)
+
+Whoohoo! Ziet er gaaf uit, toch? Bekijk de code die je zojuist geplakt hebt en probeer de plekken te vinden waar je in de HTML klassen toegevoegd hebt, die je vervolgens in de CSS hebt gebruikt. Wat zou je wijzigen als je de datum bijvoorbeeld turquoise wil maken?
+
+Wees niet bang om een beetje met de CSS te spelen en wat dingen te veranderen. Met de CSS spelen helpt je om te begrijpen wat de verschillende dingen doen. Als er per ongeluk iets stuk gaat, maak je geen zorgen! Je kunt het altijd weer ongedaan maken!
+
+We raden je aan om deze gratis online [Codecademy HTML & CSS cursus](https://www.codecademy.com/tracks/web) te doen. Hiermee leer je alles over het mooier maken van websites met CSS.
+
+Klaar voor het volgende hoofdstuk?! :)
\ No newline at end of file
diff --git a/nl/deploy/README.md b/nl/deploy/README.md
new file mode 100644
index 00000000000..b2c3141e4d4
--- /dev/null
+++ b/nl/deploy/README.md
@@ -0,0 +1,260 @@
+# Uitrollen!
+
+> **Opmerking** Het volgende hoofdstuk kan soms een beetje moeilijk zijn om doorheen te komen. Zet door en maak het af. Software uitrollen is een belangrijk onderdeel van het ontwikkelingsprocess. Dit hoofdstuk staat in het midden van de tutorial zodat je je mentor om hulp kunt vragen met het online krijgen van je website, wat iets ingewikkelder is. Dit betekent dat je de tutorial later altijd nog zelf kunt afmaken als je tijd tekort komt.
+
+Tot nu toe was je website alleen maar beschikbaar op je eigen computer. Nu leer je hoe je je website kunt uitrollen! Uitrollen is het publiceren van jouw applicatie op het internet zodat mensen eindelijk jouw app kunnen zien. :)
+
+Zoals je geleerd hebt moet een website op een server geplaatst zijn. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+De andere externe dienst die we zullen gebruiken is [GitHub](https://www.github.com), een code hosting dienst. Er zijn ook anderen beschikbaar, maar bijna alle programmeurs hebben tegenwoordig een GitHub account, en nu jij ook!
+
+Deze drie diensten zijn belangrijk. Je eigen (lokale) computer is de plek waar je verder bouwt en test aan je applicatie. Wanneer je tevreden bent met de wijzigingen, plaats je een kopie van je programma op GitHub. Je website staat op PythonAnywhere en je kunt 'm updaten door middel van een nieuwe kopie van je code van GitHub.
+
+# Git
+
+> **Opmerking** Als je de stappen voor installatie al gevolgd hebt, hoef je dit niet nog een keer te doen. Je kunt het volgende gedeelte overslaan en beginnen met het aanmaken van je Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Het aanmaken van je Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/nl/deploy/install_git.md b/nl/deploy/install_git.md
new file mode 100644
index 00000000000..c6f146ae1f2
--- /dev/null
+++ b/nl/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is een "version control system" ("versie controle systeem") dat door veel programmeurs gebruikt wordt. Deze software houdt de wijzigingen in een bestand bij zodat je later weer een specifieke versie kunt opvragen. Een beetje zoals the "track changes" in Microsoft Word, maar veel krachtiger.
+
+## Git Installeren
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Je kunt Git downloaden van [git-scm.com](https://git-scm.com/). Je kunt bij alle stappen op "volgende" klikken, op één na; in de vijfde stap genaamd "Adjusting your PATH environment" kies je "Use Git and optional Unix tools from the Windows Command Prompt" (de laatste optie). Op die na zijn alle standaardinstellingen prima. "Checkout Windows-style, commit Unix-style line endings" is goed.
+
+Vergeet niet om de command prompt of powershell te herstarten nadat de installatie succesvol afgerond is. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git van[git-scm.com](https://git-scm.com/) en volg de instructies.
+
+> **Opmerking** Als je OS X 10.6, 10.7 of 10.8 gebruikt, moet je de versie van git hiervandaan installeren: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/nl/deploy/signup_pythonanywhere.md b/nl/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/nl/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/nl/django/README.md b/nl/django/README.md
new file mode 100644
index 00000000000..3ab501ca1a8
--- /dev/null
+++ b/nl/django/README.md
@@ -0,0 +1,27 @@
+# Wat is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is een gratis en open source web-framework, geschreven in Python. Een web-framework is een set onderdelen die je helpen om sneller en makkelijker websites te maken.
+
+Als je een website aan het bouwen bent, dan heb je altijd een vergelijkbare set aan onderdelen nodig: een manier om met gebruikersauthenticatie om te gaan (registreren, inloggen, uitloggen), een beheerderspaneel voor de website, formulieren, een manier om bestanden te uploaden, etc.
+
+Gelukkig voor ons hebben andere mensen allang opgemerkt dat webontwikkelaars steeds dezelfde problemen tegenkomen bij het bouwen van een nieuwe site, dus zijn ze samen opgetrokken en hebben verschillende frameworks gecreëerd (Django is daar één van) die je kant-en-klare onderdelen geven om te gebruiken.
+
+Frameworks zijn er dus om te voorkomen dat je steeds het wiel opnieuw hoeft uit te vinden en om dubbel werk te voorkomen bij het bouwen van een nieuwe site.
+
+## Waarom heb je een framework nodig?
+
+Om beter te begrijpen wat Django precies doet moeten we kijken naar de servers. Het allereerste wat een server moet weten is dat jij wil dat de server jou een website voorschotelt.
+
+Stel je een postbus (port) voor die binnenkomende brieven (requests) controleert. Dit wordt gedaan door een webserver. De webserver leest de brief en verstuurt vervolgens een antwoord met een webpagina. Maar wanneer je wat wilt sturen, heb je ook wat inhoud nodig. Django is iets wat je helpt de inhoud te creëren.
+
+## Wat gebeurt er als iemand een website opvraagt van jouw server?
+
+Wanneer een request wordt ingediend bij de webserver, wordt het doorgespeeld naar Django, wat vervolgens probeert uit te zoeken wat er precies gevraagd wordt. Het kijkt eerst naar het adres van de webpagina om te bepalen wat er moet gebeuren. Dit gedeelte wordt gedaan door Djangos **urlresolver** (het adres van een website wordt ook wel URL genoemd - Uniform Resource Locator - dus de naam *urlresolver* betekent 'url oplosser'). De urlresolver is niet heel slim: het kijkt gewoon naar patronen en probeert een overeenkomst met de URL te vinden. Django controleert de patronen van boven naar beneden en als er een overeenkomst is gevonden wordt de request doorgestuurd naar de bijbehorende functie (die een *view* genoemd wordt).
+
+Stel je een postbode met een brief voor. Ze loopt langs de straat en controleert elk huisnummer met die op de brief. Wanneer het overeenkomt, brengt ze de brief daar. Dit is hoe de urlresolver werkt!
+
+In de *view* functie worden alle interessante dingen gedaan: we kunnen de database bekijken en er informatie uit opvragen. Misschien heeft de gebruiker gevraagd om iets in de data te wijzigen? Net zoals een brief met het verzoek "verander alsjeblieft de omschrijving van mijn baan", kan de *view* controleren of je daar wel toestemming voor hebt. Als je die toestemming hebt wordt de omschrijving geüpdatet en wordt een bericht teruggestuurd met: "Gedaan!" Vervolgens genereert de *view* een antwoord wat Django naar de webbrowser van de gebruiker kan sturen.
+
+Natuurlijk is de beschrijving hierboven een beetje vereenvoudigd, maar je hoeft nog niet alle technische dingen te begrijpen. Een algemeen idee van hoe het werkt is genoeg.
+
+Dus inplaats van te veel in de details te gaan, zullen we simpelweg beginnen met iets in Django te maken en leren we de belangrijke onderdelen onderweg!
\ No newline at end of file
diff --git a/nl/django_admin/README.md b/nl/django_admin/README.md
new file mode 100644
index 00000000000..9a520a6d51b
--- /dev/null
+++ b/nl/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+Om berichten die we zojuist gemodelleerd hebben toe te voegen, te bewerken of te verwijderen, gebruiken we de Django admin.
+
+Open het `blog/admin.py` bestand en vervang de inhoud door:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Zoals je ziet importeren we het Post model omschreven in het vorige hoofdstuk. Om ons model zichtbaar te maken op de admin pagina, moeten we het model eerst registreren met `admin.site.register(Post)`.
+
+OK, nu is het tijd om ons Post model te bekijken. Vergeet niet om `python manage.py runserver` te draaien in de terminal om de webserver op te starten. Open je browser en typ het adres http://127.0.0.1:8000/admin/. Je ziet een loginpagina zoals deze:
+
+![Login pagina](images/login_page2.png)
+
+Om in te loggen moet je eerst een *superuser* aanmaken: een gebruikersaccount wat controle heeft over de hele site. Ga terug naar je terminal en typ `python.manage.py createsuperuser`, en druk op enter.
+
+> Onthoud: om nieuwe commando's in te voeren terwijl de webserver nog draait moet je een nieuw terminalscherm openen en je virtualenv activeren. We hebben uitgelegd hoe je nieuwe commando's moet schrijven in het **Je eerste Django project!** hoofdstuk, in het **De webserver opstarten** gedeelte.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/nl/django_forms/README.md b/nl/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/nl/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/nl/django_installation/README.md b/nl/django_installation/README.md
new file mode 100644
index 00000000000..9d73c5d1684
--- /dev/null
+++ b/nl/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installatie
+
+> **Opmerking** Als je een Chromebook gebruikt, sla dan dit hoofdstuk over en zorg ervoor dat je de [Chromebook Setup](../chromebook_setup/README.md) instructies volgt.
+> 
+> **Opmerking** Als je het installatie hoofdstuk al doorlopen hebt, heb je dit al gedaan. Je kunt meteen door naar het volgende hoofdstuk!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/nl/django_installation/instructions.md b/nl/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/nl/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/nl/django_models/README.md b/nl/django_models/README.md
new file mode 100644
index 00000000000..9113b97195f
--- /dev/null
+++ b/nl/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+Wat we nu willen maken is iets dat alle berichten zal opslaan in onze blog. Maar om dat te kunnen doen moeten we het eerst hebben over `objecten`.
+
+## Objecten
+
+Er bestaat een concept binnen programmeren dat `object-georiënteerd programmeren` wordt genoemd. Het idee is dat, in plaats van alles als een saaie opeenvolging van programmeerinstructies te schrijven, we dingen kunnen modelleren en definiëren hoe ze omgaan met elkaar.
+
+Dus wat is een object? Het is een verzameling eigenschappen en acties. Het klinkt raar, maar we zullen je een voorbeeld geven.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/nl/django_orm/README.md b/nl/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/nl/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/nl/django_start_project/README.md b/nl/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/nl/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/nl/django_templates/README.md b/nl/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/nl/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/nl/django_urls/README.md b/nl/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/nl/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/nl/django_views/README.md b/nl/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/nl/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/nl/dynamic_data_in_templates/README.md b/nl/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/nl/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/nl/extend_your_application/README.md b/nl/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/nl/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/nl/how_the_internet_works/README.md b/nl/how_the_internet_works/README.md
new file mode 100644
index 00000000000..74364902eb5
--- /dev/null
+++ b/nl/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Hoe het internet werkt
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+Het eerste wat je moet begrijpen is dat een website gewoon een stelletje opgeslagen bestanden op een harde schijf zijn. Net zoals je video's, muziek of afbeeldingen. Echter is er één dingetje dat uniek is voor websites: ze bevatten computer code genaamd HTML.
+
+Als je niet bekend bent met programmeren kan het moeilijk zijn om in eerste instantie HTML te begrijpen. Je web browsers(zoals Chrome, Safari, Firefox, etc.) zijn er anders wel gek op. Web browsers zijn ontwerpen om deze code te begrijpen. Ze volgen de instructies die omschreven staan in de code en presenteren de bestanden waar jouw website uit bestaat, precies zoals jij het wilt.
+
+Net zoals bij elk bestand, moeten we de HTML bestanden ergens op een harde schijf opslaan. Voor het Internet gebruiken we speciale, krachtige computers genaamd *servers*. Ze hebben geen scherm, muis of toetsenbord omdat hun voornaamste doel het opslaan en serveren van gegevens is. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We hebben een plaatje voor jou getekend! Het ziet er zo uit:
+
+![Figure 1.1](images/internet_1.png)
+
+Ziet er uit als een puinhoop, toch? In fact it is a network of connected machines (the above-mentioned *servers*). Honderden duizenden machines! Vele, vele kilometers kabels over de hele wereld! Je kunt een onderzeeër kabel kaart website bekijken (http://submarinecablemap.com) om te zien hoe ingewikkeld het net is. Hier is een screenshot van de website:
+
+![Figure 1.2](images/internet_3.png)
+
+Het is fascinerend, nietwaar? Maar uiteraard is het niet mogelijk om draden te hebben per machine naar elke andere machine die verbonden is met het Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+Het ziet er zo uit:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/nl/html/README.md b/nl/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/nl/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/nl/install_git.md b/nl/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/nl/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/nl/installation/README.md b/nl/installation/README.md
new file mode 100644
index 00000000000..d215a4f9af6
--- /dev/null
+++ b/nl/installation/README.md
@@ -0,0 +1,58 @@
+# Als je deze tutorial thuis volgt
+
+Als je deze tutorial thuis volgt en niet op een van de [Django Girls evenementen](https://djangogirls.org/events/), kun je dit hoofdstuk in z'n geheel overslaan en rechtstreeks naar het [Hoe werkt het internet](../how_the_internet_works/README.md) hoofdstuk gaan.
+
+Je kan dit eventueel overslaan omdat we alle informatie die hier staat dekken in de gehele tutorial. Dit is gewoon een extra pagina die alle installatie instructies verzameld op één plek. Het Django Girls evenement omvat ook een "Installatie-avond" waar we alles installeren zodat we daar ons tijdens de workshop geen zorgen meer om hoeven te maken. Dit is dus handig als je naar een workshop gaat.
+
+If you find it useful, you can follow this chapter too. Maar als je liever dingen leert dan een aantal dingen op je computer te installeren, sla dan dit hoofdstuk over en ga aan de slag! We leggen alle installatie stappen later aan je uit.
+
+Succes!
+
+# Installatie
+
+In deze workshop ga je een blog bouwen. Er zijn een paar setup taken in de tutorial waarvan het goed zou zijn om hier van tevoren alvast doorheen te werken, zodat je klaar bent om te kunnen programmeren op de dag van het evenement.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Python installeren
+
+{% include "/python_installation/instructions.md" %}
+
+# Virtualenv opzetten en Django installeren
+
+{% include "/django_installation/instructions.md" %}
+
+# Een code editor installeren
+
+{% include "/code_editor/instructions.md" %}
+
+# Git installeren
+
+{% include "/deploy/install_git.md" %}
+
+# Een GitHub account aanmaken
+
+Ga naar [GitHub.com](https://www.github.com) and registreer voor een nieuw, gratis gebruikers account.
+
+# Een PythonAnywhere account aanmaken
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Begin met lezen
+
+Gefeliciteerd! Je bent helemaal klaar om te gaan. Als je nog wat tijd over hebt voordat de workshop begint zou het handig zijn om alvast een paar van de volgende hoofdstukken te lezen:
+
+* [Hoe het internet werkt](../how_the_internet_works/README.md)
+
+* [Inleiding tot de command line](../intro_to_command_line/README.md)
+
+* [Inleiding Python](../python_introduction/README.md)
+
+* [Wat is Django?](../django/README.md)
+
+# Veel plezier met de workshop!
+
+Als je met de workshop begint kun je rechtstreeks naar [Je eerste Django project!](../django_start_project/README.md) gaan, omdat je de stof al in de eerdere hoofdstukken behandeld hebt.
\ No newline at end of file
diff --git a/nl/instructions.md b/nl/instructions.md
new file mode 100644
index 00000000000..30bd493b11b
--- /dev/null
+++ b/nl/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command dnf is not found. In that case you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/nl/intro_to_command_line/README.md b/nl/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/nl/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/nl/python_installation/README.md b/nl/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/nl/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/nl/python_installation/instructions.md b/nl/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/nl/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/nl/python_introduction/README.md b/nl/python_introduction/README.md
new file mode 100644
index 00000000000..43facccb24b
--- /dev/null
+++ b/nl/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Inleiding Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Laten we eens wat code schrijven!
+
+## De Python command prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+Om eens wat met Python te spelen, moeten we een commando venster openen op je computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Als je er klaar voor bent, volg dan de onderstaande aanwijzingen op.
+
+We willen een 'Python console' openen, dus type `python<code> in Windows of <code>python3` op OsX of Linux, daarna <0>enter</code>.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/nl/signup_pythonanywhere.md b/nl/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/nl/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/nl/template_extending/README.md b/nl/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/nl/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/nl/whats_next/README.md b/nl/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/nl/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/no-NO/GLOSSARY.md b/no-NO/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/no-NO/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/no-NO/README.md b/no-NO/README.md
new file mode 100644
index 00000000000..121da8f55bf
--- /dev/null
+++ b/no-NO/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/no-NO/SUMMARY.md b/no-NO/SUMMARY.md
new file mode 100644
index 00000000000..d9741b4f21c
--- /dev/null
+++ b/no-NO/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/no-NO/chromebook_setup/README.md b/no-NO/chromebook_setup/README.md
new file mode 100644
index 00000000000..812225fe4bc
--- /dev/null
+++ b/no-NO/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook oppsett
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/no-NO/chromebook_setup/instructions.md b/no-NO/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..cb6430b9b15
--- /dev/null
+++ b/no-NO/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Du kan hoppe over [denne delen](http://tutorial.djangogirls.org/en/installation/#install-python) hvis du ikke bruker en Chromebook. Hvis du bruker en Chromebook, vil installasjonsprosessen bli litt annerledes. Du kan ignorere resten av installasjonsinstruksene.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE er et verktøy som gir en kodeeditor og tilgang til en datamaskin som kjører på internett der du kan installere, skrive, og kjøre programvaren. Gjennom hele opplæringen, vil Cloud IDE fungere som din *lokale datamaskin*. Du vil fortsatt kjøre kommandoer i en terminal akkurat som dine klassekamerater på OS X, Ubuntu eller Windows, men terminalen din vil være koblet til en datamaskin som kjører et annet sted som Cloud IDE setter opp for deg. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Du kan velge en Cloud IDE, og følge instruksjonene for Cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Gå til [PaizaCloud IDE](https://paiza.cloud/)
+2. Registrer en konto
+3. Click *New Server* and choose the Django app
+4. Klikk knappen Terminal (på venstre side av vinduet)
+
+Nå skal du se et grensesnitt med en sidebar, knapper til venstre. Klikk på knappen "Terminal" for å åpne et terminalvindu med en prompt som dette:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+Terminalen på PaizaCloud Cloud IDE er klar for dine instruksjoner. Du kan endre størrelsen eller maksimere vinduet for å gjøre det større.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment (virtuelt miljø)
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/no-NO/code_editor/README.md b/no-NO/code_editor/README.md
new file mode 100644
index 00000000000..dc9d5688c61
--- /dev/null
+++ b/no-NO/code_editor/README.md
@@ -0,0 +1,11 @@
+# Kodeeditor
+
+> For leserne hjemme: dette kapittelet er dekket i videoen [Installere Python & kodeeditor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+Du er i ferd med å skrive din første kodelinje, så det er tid for å laste ned en kodeeditor!
+
+> **Merk** Hvis du bruker en Chromebook, hopp over dette kapittelet og pass på at du følger [Chromebook oppsett](../chromebook_setup/README.md) instruksjonene. Den skybaserte IDE du velger (PaizaCloud Cloud IDE eller AWS Cloud9) inkluderer en kodeeditor, og når du åpner en fil i ditt IDE fra filmenyen, vil du automatisk bruke kodeeditoren.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/no-NO/code_editor/instructions.md b/no-NO/code_editor/instructions.md
new file mode 100644
index 00000000000..43292f5da3e
--- /dev/null
+++ b/no-NO/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Det finnes mange forskjellige editorer og det koker hovedsakelig ned til personlige preferanser. De fleste Python-programmerere bruker avanserte men svært kraftige IDEs (Integrated Development Environments), som for eksempel PyCharm. Som en nybegynner, er det sannsynligvis mindre egnet. Våre anbefalinger er like kraftige, men veldig mye enklere.
+
+Våre forslag er nedenfor, men spør gjerne din instruktør hva de foretrekker - da vil det være enklere å få hjelp fra dem.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Last den ned her](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Last den ned her](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Last den ned her](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/no-NO/css/README.md b/no-NO/css/README.md
new file mode 100644
index 00000000000..50e6b28de44
--- /dev/null
+++ b/no-NO/css/README.md
@@ -0,0 +1,330 @@
+# CSS - gjør det pent!
+
+Bloggen vår ser fortsatt litt stygg ut, sant? På tide å gjøre den penere! Vi skal bruke CSS til det.
+
+## Hva er CSS?
+
+Cascading Style Sheets (CSS) er et språk brukt for å beskrive utseendet og formatteringen av en webside skrevet i et 'markup language' (som HTML). Behandle det som en makeup for websiden vår. ;)
+
+Men vil ønsker ikke å starte fra begynnelsen igjen, sant? Igjen, vi skal bruke noe som programmerere ga ut på internett gratis. Å finne opp hjulet på nytt er jo ikke noe gøy.
+
+## La oss bruke Bootstrap!
+
+Bootstrap er en av de mest populære rammeverkene for HTML og CSS, for å utvikle nydelige websider: https://getbootstrap.com/
+
+Det ble skrevet av utviklere som jobber for Twitter. Nå blir det videreutviklet av frivillige fra hele verden!
+
+## Installere Bootstrap
+
+For å installere Bootstrap må du åpne din `.html`-fil i kodeeditoren og legge dette til `<head>`-delen:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Dette legger ikke noen filer til i prosjektet ditt. Det peker bare på filer som finnes på internett. Så kom igjen, åpne websiden din og oppdater siden. Her er det!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Ser bedre ut allerede!
+
+## Static-filer i Django
+
+Til slutt skal vi se nærmere på det som vi kaller **static files**. Static files er alle dine CSS-filer og bilder. Innholdet avhenger ikke av forespørselkonteksten, og vil være det samme for alle brukere.
+
+### Hvor legger man static files for Django
+
+Django vet allerede hvor static-filene er for den innebygde admin-appen. Nå trenger vi å legge til noen static files for vår egen app, `blog`.
+
+Dette gjør vi ved å opprette en mappe kalt `static` inni blog-appen:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django vil automatisk finne enhver mappe kalt "static" inni noen av de andre app-mappene. Deretter vil det kunne bruke innholdet som static-filer.
+
+## Din først CSS-fil!
+
+La oss opprette en CSS-fil nå, for å legge til din egen stil på websiden. Opprett en ny mappe kalt `css` inni `static`-mappen. Deretter oppretter du en ny fil som du kaller `blog.css` inni `css`-mappen. Klar?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Det er på tide å skrive litt CSS! Åpne filen `blog/static/css/blog.css` i kodeeditoren.
+
+Vi kommer ikke til å gå i dybden på tilpasning og lære alt om CSS her. Det finnes en anbefaling for et gratis CSS-kurs på slutten av denne siden hvis du ønsker å lære mer.
+
+Men la oss i det minste gjøre litt. Kanskje vi kan endre farge på overskriftene? For å forstå farger bruker datamaskiner spesielle koder. Disse kodene starter med `#` etterfulgt av 6 bokstaver (A-F) og nummer (0-9). For eksempel er koden for blå `#0000FF`. Du kan finne fargekodene for mange farger her: http://www.colorpicker.com/. Du kan også bruke [ forhåndsdefinerte farger](http://www.w3schools.com/colors/colors_names.asp), som for eksempel `rød` og `grønn`.
+
+I filen `blog/static/css/blog.css` legger du til følgende kode:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` er en CSS Selector. Dette betyr at vi angir våre stiler til et hvilket som helst `a` element inni et `h1`-element; `h2 a`-selector gjør det samme for `h2`-elementer. Så når vi har noe sånt som `<h1><a href="">link</a></h1>`, vil `h1 a`-stilen gjelde. I dette tilfellet, ber vi om å endre fargen til `#C25100`, som er en mørk oransje. Eller du kan sette din egen farge her, men vær sikker på at den har god kontrast mot en hvit bakgrunn!
+
+I en CSS-fil bestemmer vil stiler for elementer i HTML-filen. Først identifiserer vi elementene ved hjelp av elementnavnet. Du husker kanskje disse kodene fra HTML-delen. Ting som `a`, `h1`, og `body` er alle eksempler på elementnavn. Vi identifiserer også elementer etter attributten `class` eller attributten `id`. Class og id er navn du selv gir elementet. Klasser definerer grupper av elementer, og id-er peker til spesifikke elementer. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/no-NO/deploy/README.md b/no-NO/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/no-NO/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/no-NO/deploy/install_git.md b/no-NO/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/no-NO/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/no-NO/deploy/signup_pythonanywhere.md b/no-NO/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/no-NO/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/no-NO/django/README.md b/no-NO/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/no-NO/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/no-NO/django_admin/README.md b/no-NO/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/no-NO/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/no-NO/django_forms/README.md b/no-NO/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/no-NO/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/no-NO/django_installation/README.md b/no-NO/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/no-NO/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/no-NO/django_installation/instructions.md b/no-NO/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/no-NO/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/no-NO/django_models/README.md b/no-NO/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/no-NO/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/no-NO/django_orm/README.md b/no-NO/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/no-NO/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/no-NO/django_start_project/README.md b/no-NO/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/no-NO/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/no-NO/django_templates/README.md b/no-NO/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/no-NO/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/no-NO/django_urls/README.md b/no-NO/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/no-NO/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/no-NO/django_views/README.md b/no-NO/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/no-NO/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/no-NO/dynamic_data_in_templates/README.md b/no-NO/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/no-NO/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/no-NO/extend_your_application/README.md b/no-NO/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/no-NO/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/no-NO/how_the_internet_works/README.md b/no-NO/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/no-NO/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/no-NO/html/README.md b/no-NO/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/no-NO/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/no-NO/installation/README.md b/no-NO/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/no-NO/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/no-NO/intro_to_command_line/README.md b/no-NO/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/no-NO/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/no-NO/intro_to_command_line/open_instructions.md b/no-NO/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/no-NO/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/no-NO/python_installation/README.md b/no-NO/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/no-NO/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/no-NO/python_installation/instructions.md b/no-NO/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/no-NO/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/no-NO/python_introduction/README.md b/no-NO/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/no-NO/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/no-NO/template_extending/README.md b/no-NO/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/no-NO/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/no-NO/whats_next/README.md b/no-NO/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/no-NO/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/pa-IN/GLOSSARY.md b/pa-IN/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/pa-IN/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/pa-IN/README.md b/pa-IN/README.md
new file mode 100644
index 00000000000..121da8f55bf
--- /dev/null
+++ b/pa-IN/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/pa-IN/SUMMARY.md b/pa-IN/SUMMARY.md
new file mode 100644
index 00000000000..d9741b4f21c
--- /dev/null
+++ b/pa-IN/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/pa-IN/chromebook_setup/README.md b/pa-IN/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/pa-IN/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/pa-IN/chromebook_setup/instructions.md b/pa-IN/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..2df2048e6ec
--- /dev/null
+++ b/pa-IN/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/pa-IN/code_editor/README.md b/pa-IN/code_editor/README.md
new file mode 100644
index 00000000000..0a401fb1f52
--- /dev/null
+++ b/pa-IN/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/pa-IN/code_editor/instructions.md b/pa-IN/code_editor/instructions.md
new file mode 100644
index 00000000000..82fbac15aad
--- /dev/null
+++ b/pa-IN/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/pa-IN/css/README.md b/pa-IN/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/pa-IN/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/pa-IN/deploy/README.md b/pa-IN/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/pa-IN/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/pa-IN/deploy/install_git.md b/pa-IN/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/pa-IN/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/pa-IN/deploy/signup_pythonanywhere.md b/pa-IN/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/pa-IN/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/pa-IN/django/README.md b/pa-IN/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/pa-IN/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/pa-IN/django_admin/README.md b/pa-IN/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/pa-IN/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/pa-IN/django_forms/README.md b/pa-IN/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/pa-IN/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/pa-IN/django_installation/README.md b/pa-IN/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/pa-IN/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/pa-IN/django_installation/instructions.md b/pa-IN/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/pa-IN/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/pa-IN/django_models/README.md b/pa-IN/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/pa-IN/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/pa-IN/django_orm/README.md b/pa-IN/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/pa-IN/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/pa-IN/django_start_project/README.md b/pa-IN/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/pa-IN/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/pa-IN/django_templates/README.md b/pa-IN/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/pa-IN/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/pa-IN/django_urls/README.md b/pa-IN/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/pa-IN/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/pa-IN/django_views/README.md b/pa-IN/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/pa-IN/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/pa-IN/dynamic_data_in_templates/README.md b/pa-IN/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/pa-IN/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/pa-IN/extend_your_application/README.md b/pa-IN/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/pa-IN/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/pa-IN/how_the_internet_works/README.md b/pa-IN/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/pa-IN/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/pa-IN/html/README.md b/pa-IN/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/pa-IN/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/pa-IN/installation/README.md b/pa-IN/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/pa-IN/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/pa-IN/intro_to_command_line/README.md b/pa-IN/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/pa-IN/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/pa-IN/intro_to_command_line/open_instructions.md b/pa-IN/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/pa-IN/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/pa-IN/python_installation/README.md b/pa-IN/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/pa-IN/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/pa-IN/python_installation/instructions.md b/pa-IN/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/pa-IN/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/pa-IN/python_introduction/README.md b/pa-IN/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/pa-IN/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/pa-IN/template_extending/README.md b/pa-IN/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/pa-IN/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/pa-IN/whats_next/README.md b/pa-IN/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/pa-IN/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/pl-PL/GLOSSARY.md b/pl-PL/GLOSSARY.md
new file mode 100644
index 00000000000..6c00cc9d71c
--- /dev/null
+++ b/pl-PL/GLOSSARY.md
@@ -0,0 +1,3 @@
+# Edytor kodu
+
+Edytor kodu to taka aplikacja, która pozwala Ci zapisać kod, byś mogła do niego wrócić w dowolnym, późniejszym momencie. Możesz się dowiedzieć skąd go ściągnąć z [rozdziału o edytorach kodu](./code_editor/README.md).
\ No newline at end of file
diff --git a/pl-PL/README.md b/pl-PL/README.md
new file mode 100644
index 00000000000..4f1e9030693
--- /dev/null
+++ b/pl-PL/README.md
@@ -0,0 +1,51 @@
+# Kurs Django Girls
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Niniejsza praca jest licencjonowana zgodnie z Creative Commons Attribution-ShareAlike License 4.0 International. Aby zobaczyć kopię niniejszej licencji, odwiedź http://creativecommons.org/licenses/by-sa/4.0/
+
+## Witaj
+
+Witaj w tutorialu Django Girls! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Wprowadzenie
+
+Czy kiedykolwiek czułaś, że wokół jest coraz więcej nowych technologii, a Ty zostajesz w tyle? Zastanawiałaś się kiedyś, jak zrobić stronę internetową, ale nie miałaś motywacji, by zacząć? Czy zdarzyło Ci się pomyśleć, że świat programowania jest dla Ciebie zbyt skomplikowany?
+
+No więc mamy dla Ciebie dobre nowiny! Programowanie nie jest tak trudne, jak się wydaje, a my chcemy Ci pokazać, że może być też niezłą zabawą.
+
+Ten kurs nie zamieni Cię w zawodową programistkę. Jeżeli chcesz być w tym naprawdę dobra, musisz spędzić miesiące lub nawet lata na nauce i ćwiczeniach. Ale chciałybyśmy Ci pokazać, że programowanie i pisanie stron internetowych nie jest tak trudne, jak mogłoby się wydawać. Spróbujemy wyjaśnić to i owo najprościej i najlepiej jak tylko potrafimy, abyś nie czuła się przytłoczona nową technologią.
+
+Mamy nadzieję sprawić, że pokochasz to tak jak my!
+
+## Czego nauczysz się w trakcie kursu?
+
+Jak skończysz tutorial, będziesz miała małą działającą aplikację webową: Twój blog. Pokażemy Ci, jak umieścić ją online tak, by inni mogli zobaczyć Twoją pracę!
+
+Będzie to wyglądać mniej więcej tak:
+
+![Rysunek 0.1](images/application.png)
+
+> Jeżeli przerabiasz tutorial samodzielnie i nie masz w pobliżu osoby, która pomogłaby Ci w razie problemów, zapraszamy na czat: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Ustaliliśmy z naszymi mentorami oraz poprzednimi uczestniczkami, że od czasu do czasu będą się tam pojawiać i udzielać pomocy z tutorialem! Nie bój się pytać!
+
+Ok, [zacznijmy od początku...](./how_the_internet_works/README.md)
+
+## Przerabiasz tutorial w domu?
+
+Udział w warsztatach Django Girls to niesamowite doświadczenie, ale zdajemy sobie sprawę, że nie zawsze jest to możliwe. Z tego powodu zachęcamy Ciebie, byś spróbowała przerobić tutorial w domu. Dla czytelniczek w domu, jesteśmy właśnie w trakcie przygotowywania materiałów wideo, które ułatwią samodzielne podążanie za tutorialem. Na chwilę obecną nie posiadamy wideo do wszystkich rozdziałów, ale dzień po dniu, rozdział po rozdziale kolejne materiały będą się pojawiać na kanale [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) na YouTubie.
+
+W każdym rozdziale, który posiada materiał wideo, udostępniamy link, który do niego prowadzi.
+
+## Jak możesz pomóc?
+
+Kurs jest prowadzony przez [DjangoGirls](https://djangogirls.org/). Jeżeli znajdziesz jakiś błąd lub chcesz dodać coś nowego, zapoznaj się proszę z [tymi informacjami](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Chciałabyś pomóc nam tłumaczyć tutorial na inne języki?
+
+Obecnie przechowujemy wersje językowe na platformie Crowdin.com:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Jeżeli twój język nie jest wylistowany na [Crowdinie](https://crowdin.com/), [zgłoś nowe issue](https://github.com/DjangoGirls/tutorial/issues/new), dzięki któremu poinformujesz nas, by dodać język.
\ No newline at end of file
diff --git a/pl-PL/SUMMARY.md b/pl-PL/SUMMARY.md
new file mode 100644
index 00000000000..7524c735144
--- /dev/null
+++ b/pl-PL/SUMMARY.md
@@ -0,0 +1,35 @@
+# Podsumowanie
+
+* [Wprowadzenie](README.md)
+* [Instalacja](installation/README.md) 
+  * [Wiersz poleceń](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Edytor kodu](installation/README.md#code-editor)
+  * [Środowisko wirtualne](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Instalacja (chromebook)](chromebook_setup/README.md)
+* [Jak działa internet?](how_the_internet_works/README.md)
+* [Wprowadzenie do wiersza polecenia](intro_to_command_line/README.md)
+* [Instalowanie Pythona](python_installation/README.md)
+* [Edytor tekstu](code_editor/README.md)
+* [Wprowadzenie do Pythona](python_introduction/README.md)
+* [Czym jest Django?](django/README.md)
+* [Instalowanie Django](django_installation/README.md)
+* [Twój pierwszy projekt w Django!](django_start_project/README.md)
+* [Modele w Django](django_models/README.md)
+* [Administracja Django (admin)](django_admin/README.md)
+* [Wdrażanie!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Widoki Django - czas zacząć tworzyć!](django_views/README.md)
+* [Wprowadzenie do HTML-a](html/README.md)
+* [Django ORM (QuerySet)](django_orm/README.md)
+* [Dane dynamiczne w szablonach Django](dynamic_data_in_templates/README.md)
+* [Szablony Django](django_templates/README.md)
+* [CSS - upiększ to](css/README.md)
+* [Rozbudowa szablonów](template_extending/README.md)
+* [Rozbudowa aplikacji](extend_your_application/README.md)
+* [Formularze Django](django_forms/README.md)
+* [Co dalej?](whats_next/README.md)
\ No newline at end of file
diff --git a/pl-PL/chromebook_setup/README.md b/pl-PL/chromebook_setup/README.md
new file mode 100644
index 00000000000..5418d7a2564
--- /dev/null
+++ b/pl-PL/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Instalacja na Chromebooku
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/pl-PL/chromebook_setup/instructions.md b/pl-PL/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..e58f3d9dae9
--- /dev/null
+++ b/pl-PL/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Możesz [pominąć tę sekcję](http://tutorial.djangogirls.org/en/installation/#install-python), jeżeli nie używasz Chromebooka. W przeciwnym wypadku, proces instalacji będzie wyglądał nieco inaczej. Możesz zignorować pozostałe elementy instrukcji dotyczące instalacji.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE jest narzędziem, które pełni funkcję edytora kodu oraz umożliwia dostęp do komputera uruchomionego w internecie, gdzie możesz instalować, pisać oraz uruchamiać programy. Na czas trwania tutoriala Cloud IDE będzie działać jako *komputer lokalny*. Będziesz mogła uruchamiać komendy w terminalu, tak jak inne osoby korzystające z systemu OS X, Ubuntu czy Windows, z tym że Twój terminal będzie podłączony do komputera, który ustawi dla Ciebie Cloud IDE. Oto instrukcje dotyczące różnych Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Możesz wybrać jedno z poniższych Cloud IDE i postępować zgodnie z instrukcją.
+
+#### PaizaCloud Cloud IDE
+
+1. Przejdź do [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Załóż konto
+3. Kliknij *Nowy serwer* i wybierz aplikację Django
+4. Kliknij przycisk "Terminal" (po lewej stronie okna)
+
+Teraz powinnaś zobaczyć interfejs z bocznym paskiem i przyciski po lewej stronie. Kliknij przycisk "Terminal", aby otworzyć okno terminala ze znakiem zachęty takim jak ten:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+Terminal PaizaCloud Cloud ID jest gotowy na Twoje instrukcje. Możesz zmienić rozmiar tego okna i powiększyć je, aby było troszkę większe.
+
+#### AWS Cloud9
+
+Obecnie Cloud 9 wymaga rejestracji w AWS i wprowadzenia informacji o karcie kredytowej.
+
+1. Zainstaluj Cloud 9 ze [ sklepu internetowego Chrome](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Przejdź do [c9.io](https://c9.io) i kliknij *Zacznij z AWS Cloud9*
+3. Zarejestruj konto AWS (wymaga danych karty kredytowej, ale możesz używać go za darmo)
+4. W Panelu AWS wpisz * Cloud9 * na pasku wyszukiwania i kliknij go
+5. W panelu Cloud 9 kliknij * Utwórz środowisko *
+6. Nazwij go * django-girls *
+7. Podczas konfiguracji wybierz *Utwórz nową instancję dla środowiska (EC2)* dla "Typ Środowiska" i *t2.micro* dla "Typ instancji" (powinien powiedzieć "Kwalifikuje się na poziom darmowy"). Domyślne ustawienie oszczędzania kosztów jest dobre, a pozostałe wartości możesz zachować domyślne.
+8. Kliknij *Next step*
+9. Kliknij *Create Environment*
+
+Teraz powinnaś zobaczyć interfejs z bocznym paskiem, duże główne okno z tekstem i małe okno na dole, które wygląda następująco:
+
+{% filename %}bash{% endfilename %}
+
+    twojanazwaużytkownika:~/workspace $
+    
+
+Dolny obszar jest Twoim terminalem. Możesz użyć go do wysyłania instrukcji do zdalnego komputera Cloud 9. Możesz zmienić rozmiar tego okna, aby je trochę powiększyć.
+
+#### Glitch.com Cloud IDE
+
+1. Przejdź do [Glitch.com](https://glitch.com/)
+2. Stwóż darmowe konto (https://glitch.com/signup) lub użyj swojego konta GitHub, jeśli je posiadasz. (Zobacz instrukcje GitHub poniżej)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Środowisko wirtualne
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/pl-PL/code_editor/README.md b/pl-PL/code_editor/README.md
new file mode 100644
index 00000000000..b0b37f046dc
--- /dev/null
+++ b/pl-PL/code_editor/README.md
@@ -0,0 +1,11 @@
+# Edytor kodu
+
+> Dla czytelniczek w domu: ten rozdział jest również omówiony w wideo [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+Zaraz napiszesz swoją pierwszą linijkę kodu, więc najwyższy czas zainstalować edytor kodu!
+
+> **Uwaga** Jeśli używasz już Chromebooka, pomiń ten rozdział i upewnij się, że postąpiłaś zgodnie z instrukcją [Instalacja Chromebooka](../chromebook_setup/README.md). Cloud IDE, które wybrałaś (PaizaCloud Cloud IDE or AWS Cloud9) zawiera edytor kodu, więc kiedy otworzysz plik z menu w swoim IDE, automatycznie zostanie on otworzony w edytorze.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/pl-PL/code_editor/instructions.md b/pl-PL/code_editor/instructions.md
new file mode 100644
index 00000000000..a5d71704b35
--- /dev/null
+++ b/pl-PL/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Istnieje wiele programów tego typu, jednak który wybrać? To nie takie proste, bo wybór zależy w dużej mierze od tego, czego oczekujesz od swojego edytora. Większość programistów Pythona używa bardzo skomplikowanych i niezwykle bogatych w różne funkcjonalności IDE (z ang. Integrated Development Environments - zintegrowane środowisko deweloperskie), takich jak: PyCharm. Jako osoba początkująca nie potrzebujesz jednak aż tak skomplikowanego edytora. Wystarczy coś prostszego, ale nadal dostatecznie użytecznego.
+
+Nasze propozycje prezentujemy poniżej, ale w razie czego spytaj o sugestie swojego mentora - będzie on w stanie wybrać coś zgodnego z Twoimi preferencjami.
+
+## Visual Studio Code
+
+Visual Studio Code jest edytorem kodu źródłowego opracowanym przez Microsoft dla Windows, Linux i macOS. Obejmuje on wsparcie debugowania, kontrolę wbudowanego Git, podświetlanie składni, inteligentne uzupełnianie kodu, fragmenty i refaktoryzację kodu.
+
+[Pobierz tutaj](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit to open source'owy i darmowy edytor dostępny dla wszystkich systemów operacyjnych. Czasami nie jest jednak zbyt prosty w zainstalowaniu.
+
+[Pobierz tutaj](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text jest bardzo popularnym edytorem z bezpłatnym okresem testowania i jest dostępny dla wszystkich systemów operacyjnych.
+
+[Pobierz tutaj](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom jest kolejnym popularnym edytorem. Jest darmowy, open-source'owy i dostępny dla systemów Windows, OS X i Linux.
+
+[Pobierz tutaj](https://atom.io/)
+
+## Dlaczego instalujemy edytor kodu?
+
+Może się zastanawiasz dlaczego instalujemy specjalny edytor kodu zamiast używać Notatnika albo Notepada.
+
+Podstawowym powodem jest to, że kod musi być **zwykłym, niesformatowanym tekstem**, co powoduje że nie możemy tutaj użyć programów takich jak Word czy Textedit, ponieważ produkują one nie zwykły tekst, tylko tekst sformatowany (z informacją odnośnie użytej czcionki, sposobu formatowania), używając specjalnych formatów danych, jak na przykład [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+Drugim powodem jest specjalizacja edytorów kodu - dzięki temu mogą one dostarczać bardzo użytecznych funkcjonalności, jak kolorowanie składni zgodnie z jej przeznaczeniem lub automatyczne zamykanie cudzysłowów zamiast Ciebie.
+
+Za chwilę przetestujemy wybrany edytor w akcji. Nim się obejrzysz, będziesz uważać swój edytor tekstu jako jedno z ulubionych narzędzi. :)
\ No newline at end of file
diff --git a/pl-PL/css/README.md b/pl-PL/css/README.md
new file mode 100644
index 00000000000..7e28710bb34
--- /dev/null
+++ b/pl-PL/css/README.md
@@ -0,0 +1,330 @@
+# CSS - upiększ to!
+
+Nasz blog nadal wygląda dość surowo, prawda? Czas, aby to zmienić! Użyjemy do tego CSS.
+
+## Czym jest CSS?
+
+Kaskadowe arkusze stylów (ang. Cascading Style Sheets, CSS) to język używany do określania wyglądu i formatowania strony internetowej napisanej w języku znaczników (np. HTML). Traktuj go jak make-up dla naszej strony. ;)
+
+Ale nie chcemy zaczynać od nowa, prawda? Raz jeszcze będziemy używać czegoś, co programiści opublikowali w Internecie za darmo. Odkrywanie Ameryki na nowo nie jest zabawne.
+
+## Użyjmy biblioteki Bootstrap!
+
+Bootstrap jest jednym z najpopularniejszych frameworków HTML i CSS do budowania pięknych stron: https://getbootstrap.com/
+
+Został stworzony przez programistów, którzy pracowali dla Twittera. Obecnie jest rozwijany przez kontrybutorów z całego świata!
+
+## Zainstaluj Bootstrapa
+
+Aby zainstalować Bootstrap, otwórz plik `.html` w edytorze kodu i dodaj do sekcji `<head>`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Akurat to nie doda żadnych nowych plików do Twojego projektu. Te dwie linijki wskazują na pliki, które istnieją w Internecie. Sprawdź sama, otwórz swoją stronę w przeglądarce internetowej, odśwież zawartość. No i proszę!
+
+![Rysunek 14.1](images/bootstrap1.png)
+
+Od razu wygląda lepiej, prawda?
+
+## Pliki statyczne w Django
+
+Przyjrzymy się teraz bliżej temu, co nazwałyśmy **plikami statycznymi**. Pliki statyczne to wszystkie twoje arkusze styli oraz pliki z obrazkami. Ich zawartość nie zależy od kontekstu żądania i będzie taka sama dla każdego użytkownika.
+
+### Gdzie umieścić pliki statyczne w Django?
+
+Django wie, gdzie szukać plików statycznych dla wbudowanej aplikacji "admin". Teraz musimy jeszcze dodać jakieś pliki statyczne do naszej własnej aplikacji `blog`.
+
+Wystarczy, że w naszej aplikacji stworzymy nowy folder i nazwiemy go `static`:
+
+    djangogirls
+    ├── blog
+    |     ├── migrations
+    |     ├── static
+    |     └── templates
+    └── mysite
+    
+
+Django automatycznie wyszuka każdy folder nazwany "static" w środku każdego folderu aplikacji. Zawartość tych katalogów będzie uznawana za pliki statyczne.
+
+## Twój pierwszy arkusz CSS!
+
+Stwórzmy teraz plik CSS, aby dodać nasze własne style do naszej strony WWW. Stwórz katalog o nazwie `css` w środku folderu `static`. Następnie utwórz nowy plik o nazwie `blog.css` w katalogu `css`. Gotowa?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Czas, by napisać trochę styli CSS! Otwórz `blog/static/css/blog.css` w Twoim edytorze kodu.
+
+Nie będziemy zbytnio zagłębiać się w dostosowywanie i uczenie się o CSS w tym miejscu. Jeśli chcesz dowiedzieć się więcej, istnieje rekomendacja dotycząca darmowego kursu CSS na końcu tej strony.
+
+Jednak nauczmy się chociaż troszkę. Może mogłybyśmy zmienić kolor naszych nagłówków? Do rozpoznawania kolorów komputery używają specjalnych kodów. Kody te zaczynają się od znaku `#`, po którym następuje 6 liter (A-F) lub cyfr (0-9). Na przykład kod dla koloru niebieskiego to `#0000FF`. Kody dla wielu kolorów możesz znaleźć na stronie: http://www.colorpicker.com/. Możesz również użyć uprzednio [zdefiniowanych kolorów](http://www.w3schools.com/colors/colors_names.asp), takich jak `red` (czerwony) czy `green ` (zielony).
+
+Do `blog/static/css/blog.css` powinnaś dodać następujący kod:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` to selektor CSS. Oznacza to, że zastosujemy nasze style do każdego elementu `a` znajdującego się w elemencie `h1`; selektor `h2 a` czyni to samo dla elementów `h2`. Czyli gdy mamy coś takiego jak `<h1><a href="">link</a></h1>`, styl `h1 a`, styl zostanie użyty. W tym przypadku nadajemy mu kolor `#C25100`, czyli ciemnopomarańczowy. Możesz też tutaj wstawić swój własny kolor, ale pamiętaj, by odpowiednio kontrastował z białym tłem!
+
+W pliku CSS ustalamy styl dla elementów znajdujących się w pliku HTML. Pierwszą metodą rozpoznawania elementu jest jego nazwa. Możesz pamiętać te tagi z rozdziału o HTML. Takie rzeczy jak `a`, `h1` i `body` to wszystko przykłady nazw elementów. Elementy rozpoznajemy również po atrybutach `class` lub `id`. Nazwę klasy lub id ustalasz sama dowolnie. Ta sama nazwa klasy może być przypisana do wielu elementów, ale id musi być unikalne dla całego kodu HTML. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Więcej dowiesz się o [selektorach CSS z w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+Musimy też powiedzieć naszemu szablonowi HTML, że dodałyśmy trochę styli CSS. Otwórz plik `blog/templates/blog/post_list.html` i dodaj tę linię na jego początku:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Tutaj ładujemy pliki statyczne :) Pomiędzy tagami `<head>` oraz `</head>`, po liniach linkujących do plików CSS Bootstrapa, dodaj tę linię:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Przeglądarka czyta pliki w takiej kolejności, w jakiej zostały jej podane, więc musimy się upewnić, że linię dodałyśmy w odpowiednim miejscu. Inaczej kod w naszym pliku może zostać nadpisany przez pliki Bootstrapa. Właśnie pokazaliśmy naszemu szablonowi, gdzie znajduje się nasz plik CSS.
+
+Twój plik powinien teraz wyglądać tak:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Ok, teraz zapisz plik i odśwież stronę!
+
+![Rysunek 14.2](images/color2.png)
+
+Super! Niezła robota. Może damy teraz naszej stronie trochę przestrzeni i zwiększymy margines po lewej stronie? Spróbujmy!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Dodaj powyższe do swoich stylów CSS, zapisz plik i zobacz, jak to zadziałało!
+
+![Rysunek 14.3](images/margin2.png)
+
+Może zmienimy też rodzaj czcionki w naszym nagłówku? Wklej to do sekcji `<head>` w pliku `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Tak jak wcześniej, sprawdź kolejność i umieść tę linię przed linkiem do `blog/static/css/blog/css`. Podana linia zaimportuje czcionkę pod nazwą *Lobster* z usługi Google Fonts (https://www.google.com/fonts).
+
+Znajdź blok deklaracji dla `h1 a` (to jest kod pomiędzy nawiasami `{` i `}`) w pliku CSS `blog/static/css/blog.css`. Dodaj do niego linię `font-family: 'Lobster';` pomiędzy nawiasami, po czym odśwież stronę:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Rysunek 14.3](images/font.png)
+
+Wspaniale!
+
+Jak napisałyśmy powyżej, w CSS istnieje koncepcja klas. Pozwalają one nazwać część naszego kodu HTML i aplikować style tylko do tej części, omijając wpływ tych stylów na inne części. To może być super użyteczne! Może masz dwa divy, które odpowiadają za coś innego (jak nasz header lub post). Klasa pomoże nam, gdy będziemy chciały, by wyglądały one inaczej.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+A teraz dodamy bloki deklaracji do selektorów. Selektory zaczynające się od `.` odnoszą się do klas. W Internecie jest wiele wspaniałych tutoriali dotyczących CSS, które pomogą Tobie zrozumieć następujący kod. Na razie skopiuj i wklej do `blog/static/css/blog.css` poniższy kod:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Teraz otocz kod HTML wyświetlający posty deklaracjami klas. Zamień to:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+w pliku `blog/templates/blog/post_list.html` na to:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Zapisz te pliki i odśwież swoją stronę.
+
+![Rysunek 14.4](images/final.png)
+
+Woohoo! Wygląda to niesamowicie, prawda? Sprawdź w kodzie, który przed chwilą wkleiłyśmy i poszukaj miejsc, w których dodałyśmy klasy w HTML oraz użyłyśmy ich w CSS. Gdzie dokonałabyś zmiany, gdybyś chciała, by data była w kolorze turkusowym?
+
+Nie bój się trochę pomajstrować w CSS próbując zmienić niektóre rzeczy. Zabawa z CSS pozwoli Ci lepiej zrozumieć, co robią różne rzeczy. Niczym się nie przejmuj, jeżeli coś zepsujesz - zawsze przecież można cofnąć zmiany!
+
+Naprawdę polecamy skorzystanie z bezpłatnych kursów online "Basic HTML & HTML5" i "Basic CSS" na [freeCodeCamp](https://learn.freecodecamp.org/). Pomoże to Tobie nauczyć się wszystkiego, czego potrzebujesz, by upiększyć twoje strony za pomocą CSS.
+
+Gotowa na następny rozdział?! :)
\ No newline at end of file
diff --git a/pl-PL/deploy/README.md b/pl-PL/deploy/README.md
new file mode 100644
index 00000000000..f1a8bff63b4
--- /dev/null
+++ b/pl-PL/deploy/README.md
@@ -0,0 +1,246 @@
+# Wdrażanie!
+
+> **Uwaga:** Niniejszy rozdział może być miejscami dość trudny. Bądź dzielna i przestudiuj go do końca; wdrażanie jest ważną częścią pracy nad stroną. Celowo umieściłyśmy go tutaj, aby Twój mentor był w stanie pomóc Ci przejść przez skomplikowany proces opublikowania Twojej strony w sieci. Oznacza to, że możesz wciąż ukończyć tutorial samodzielnie, jeśli zabraknie Ci czasu.
+
+Do teraz twoja strona była dostępna tylko na twoim komputerze. Właśnie teraz nauczymy się, jak ją wdrożyć! Wdrożenie to inaczej opublikowanie Twojej aplikacji w internecie, dzięki czemu możesz w końcu pokazać ją innym ludziom. :)
+
+Jak już wiesz, strona internetowa musi znajdować się na jakimś serwerze. W internecie działa wielu dostawców serwerów. Skorzystamy z usług [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere jest darmowy dla małych aplikacji, które nie przyciągają zbyt wielu odwiedzających. Z pewnością jest wystarczający dla Ciebie.
+
+Drugą zewnętrzną usługą, jakiej będziemy używać jest [GitHub](https://www.github.com), który przechowuje kod. Istnieją inne usługi, ale w dzisiejszych czasach prawie wszyscy programiści mają konto na GitHubie - i Ty dzisiaj do nich dołączysz!
+
+Te trzy miejsca będą dla Ciebie bardzo ważne. Twój lokalny komputer będzie miejscem, w którym będziesz rozwijać i testować swoją aplikację. Kiedy będziesz zadowolona ze swoich zmian, kod swojego programu umieścisz na GitHubie. Twoja strona za to będzie dostępna na PythonAnywhere i wszystkie zmiany będziesz tam ściągał ze swojej kopii kodu na GitHubie.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Tworzenie repozytorium Git
+
+Git śledzi zmiany dokonywane w zbiorze plików w czymś, co nazywamy repozytorium kodu (albo po prostu "repo", żeby było krócej). Stwórzmy takie repozytorium dla naszego projektu. Otwórz konsolę w katalogu `djangogirls` i wpisz następujące polecenia:
+
+> **Uwaga** Sprawdź bieżący katalog roboczy za pomocą polecenia `pwd` (Mac OS X/Linux) lub `cd` (Windows) przed inicjalizacją repozytorium. Powinnaś się znajdować w katalogu `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Twoja Nazwa Uzytkownika"
+    $ git config --global user.email ty@adres.pl
+    
+
+Inicjalizacja repozytorium gita jest jednorazowym zadaniem dla każdego projektu (nie będzie więcej potrzeby, byś ponownie podawał nazwę użytkownika i email).
+
+Git będzie śledzić zmiany we wszyskich plikach i folderach w tym katalogu, ale zwróć uwagę, że znajdują się w nim pewne pliki, których zmiany chcemy ignorować. By to zrobić, musimy utworzyć w tym katalogu plik, który nazwiemy `.gitignore`. Otwórz swój edytor kodu i utwórz nowy plik o następującej treści:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+I zapisz go jako `.gitignore` w katalogu "djangogirls".
+
+> **Uwaga** Ta kropka na początku nazwy pliku jest ważna! Jeżeli masz problem podczas tworzenia tego pliku (MacOS ma na przykład problem z tworzeniem plików zaczynających się od kropki za pomocą Findera), to spróbuj użyć polecenia "Zapisz jako" w swoim edytorze, to akurat jest niezawodne. I upewnij się, że nie dodałaś .txt, .py lub jakiegokolwiek innego rozszerzenia do nazwy pliku. Zostanie on rozpoznany przez Gita tylko wtedy, gdy jego nazwą jest po prostu .gitignore. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Uwaga** Jednym z plików, który wyszczególniliśmy w `.gitignore` to `db.sqlite3`. Ten plik to Twoja lokalna baza danych, w której przechowywani są wszyscy Twoi użytkownicy i posty. Będziemy podążać za standardem praktyki programowania webowego, co oznacza, że będziemy używać oddzielnych baz danych dla naszej lokalnej strony testowej oraz produkcyjnej witryny na PythonAnywhere. Bazą danych dla PythonAnywhere może być SQLite, tak jak na Twojej lokalnej maszynie. Najczęściej natomiast będziesz korzystać z bazy MySQL, która potrafi poradzić sobie z dużo większą ilością odwiedzających niż SQLite. W każdym razie, zignorowanie Twojej bazy SQLite w kopii dla GitHuba oznacza, że wszystkie posty i użytkownicy, których do tej pory stworzyłaś, będą dostępne jedynie lokalnie i będziemy musiały dodać ich ponownie na środowisku produkcyjnym. Powinnaś myśleć o swojej lokalnej bazie danych jako o dobrym placu zabaw, na którym możesz testować różne rzeczy nie bojąc się, że skasujesz prawdziwe artykuły ze swojego bloga.
+
+Dobrym nawykiem jest wpisywanie polecenia `git status` zanim wpiszesz `git add` albo gdy nie jesteś pewna co się zmieniło. Pozwala ono zabezpieczyć się przed niespodziankami takimi, jak chociażby dodanie lub skomitowanie błędnego pliku. Polecenie `git status` zwraca informację o wszystkich nieśledzonych/zmienionych/zaplanowanych do najbliższego commita plików, statusie brancha i wiele innych. Wynik powinien wyglądać podobnie do następującego:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+I na końcu zapisujemy zmiany. Przejdź do konsoli i wykonaj poniższe polecenia:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Przesyłanie kodu do GitHuba
+
+Wejdź na stronę [GitHub.com](https://www.github.com) i załóż darmowe konto użytkownika. (Jeśli zrobiłaś to na warsztatach przygotowawczych to świetnie). Zapamiętaj hasło do swojego konta (dodaj je do swojego menedżera haseł, jeśli go używasz).
+
+Następnie utwórz nowe repozytorium i nadaj mu nazwę "my-first-blog" (ang. "mój-pierwszy-blog"). Pozostaw niezaznaczone pole wyboru "initialize with README", pozostaw opcję .gitignore pustą (zrobiłyśmy to ręcznie) i pozostaw licencję jako None.
+
+![](images/new_github_repo.png)
+
+> **Uwaga** Nazwa `my-first-blog` jest ważna - mogłabyś wybrać jakąś inną, ale będziemy tej nazwy używać wiele razy i za każdym razem musiałabyś pamiętać, żeby zastępować "my-first-blog" swoją wybraną nazwą. Z tego powodu najłatwiej będzie jak użyjesz nazwy `my-first-blog`.
+
+Na następnym obrazku zostanie wyświetlony Twój URL do klonowania repozytorium, którego będziesz używać w niektórych poleceniach.
+
+![](images/github_get_repo_url_screenshot.png)
+
+Teraz musimy podpiąć repozytorium Git na komputerze do tego na GitHubie.
+
+Wpisz następujące polecenie do konsoli (zamień <your-github-username> na swoją nazwę użytkownika, którą podałaś przy tworzeniu konta na GitHubie. Nie zapomnij o usunięciu nawiasów ("<" i ">"), ten URL powinien pasować do URL-a klonującego Twoje repozytorium.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Po wykonaniu komendy push na GitHuba zostaniesz zapytana o swoją nazwę użytkownika i hasło (albo bezpośrednio w wierszu poleceń w oknie terminala albo w wyskakującym okienku). Po poprawnym wpisaniu użytkownika i hasła powinnaś zobaczyć coś takiego:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    
+    To https://github.com/ola/my-first-blog.git
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Twój kod jest teraz na GitHubie. Możesz to sprawdzić! Znajdujesz się teraz w wyśmienitym towarzystwie - [Django](https://github.com/django/django), [kurs Django Girls](https://github.com/DjangoGirls/tutorial) i wiele innych świetnych projektów open-source trzyma swój kod na GitHubie! :)
+
+# Wdrażanie bloga na PythonAnywhere
+
+## Zakładanie konta na PythonAnywhere
+
+> **Uwaga** Możliwe, że już wcześniej utworzyłaś konto na PythonAnywhere, jeśli przeszłaś przez wszystkie kroki w rozdziale instalacyjnym - nie ma potrzeby, byś robiła to drugi raz.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Konfigurowanie naszej strony w PythonAnywhere
+
+Wróć do głównego panelu [PythonAnywhere Dashboard](https://www.pythonanywhere.com/), klikając logo i wybierz opcję uruchomienia konsoli "Bash" - jest to wersja wiersza polecenia PythonAnywhere, podobnie jak na Twoim komputerze.
+
+![Sekcja 'New Console' na stronie PythonAnywhere z przyciskiem 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Uwaga** PythonAnywhere jest oparty na Linuksie, więc jeśli pracujesz na Windowsie, to konsola będzie wyglądać trochę inaczej, niż na Twoim komputerze.
+
+Wdrożenie aplikacji internetowej w PythonAnywhere polega na ściągnięciu kodu z GitHuba, a następnie skonfigurowaniu PythonAnywhere w celu rozpoznania go i rozpoczęciu wyświetlania go jako aplikacji internetowej. Istnieją manualne sposoby robienia tego, ale PythonAnywhere zapewnia narzędzie pomocnicze, które zrobi to wszystko za Ciebie. W pierwszej kolejności zainstalujmy:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+To powinno wydrukować rzeczy takie jak `Collecting pythonanywhere`, a skończyć się na linii z napisem `Successfully installed (...) pythonanywhere- (...)`.
+
+Teraz uruchamiamy pomocnika, aby automatycznie skonfigurować naszą aplikację z GitHubem. Wpisz następujące polecenie do konsoli w PythonAnywhere (nie zapomnij zamienić <your-github-username> na Twoją nazwę użytkownika GitHub, tak by Twój URL pasował do klonowanego URL-a z GitHuba).
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+Jeżeli patrzysz na proces, będziesz mogła zobaczyć:
+
+- Pobieranie kodu z GitHuba
+- Tworzenie środowiska wirtualnego na PythonAnywhere, podobnie jak na Twoim komputerze.
+- Aktualizowanie pliku ustawień z niektórych ustawień wdrażania
+- Konfigurowanie bazy danych w PythonAnywhere za pomocą polecenia `manage.py migrate`
+- Konfigurowanie plików statycznych (dowiemy się o nich później)
+- I konfigurowanie PythonAnywhere do obsługi aplikacji internetowej za pomocą interfejsu API
+
+W PythonAnywhere wszystkie te kroki są zautomatyzowane, ale są to te same kroki, które trzeba wykonać z dowolnym innym dostawcą serwera.
+
+Najważniejszym w tej chwili jest to, aby zapamiętać, że baza danych w PythonAnywhere jest całkowicie oddzielona od bazy danych na Twoim komputerze, co oznacza, że może mieć inne posty i konta administracyjne. W rezultacie, tak jak zrobiłyśmy to wcześniej na własnym komputerze, musimy zainicjować konto administratora za pomocą `createsuperuser`. PythonAnywhere automatycznie aktywował dla Ciebie Twojego virtualenva, więc jedyne, co musisz zrobić, to uruchomić:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Wpisz szczegóły dla konta swojego administratora. Najlepiej używać tych samych, których używasz na swoim komputerze, aby uniknąć nieporozumień, chyba że chcesz, aby hasło w PythonAnywhere było bezpieczniejsze.
+
+Teraz, jeśli chcesz, możesz również rzucić okiem na swój kod w PythonAnywhere używając `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py tests.py  static
+    templates  views.py
+    
+
+Możesz także przejść do zakładki "Pliki" i poruszać się za pomocą wbudowanej przeglądarki plików w PythonAnywhere. (Ze strony konsoli możesz przejść do innych stron PythonAnywhere za pomocą przycisku menu w prawym górnym rogu. Po przejściu na jedną ze stron, w pobliżu góry zobaczysz linki do innych.)
+
+## Jesteś na żywo!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Uwaga:** Jest to poradnik dla początkujących, a podczas wdrażania tej witryny użyłyśmy kilka skrótów, które nie są idealnym rozwiązaniem z punktu widzenia bezpieczeństwa. Jeśli zdecydujesz się zbudować ten projekt lub rozpocząć nowy projekt, należy przejrzeć [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/), aby uzyskać pewne wskazówki dotyczące zabezpieczania witryny.
+
+## Porady dotyczące debugowania
+
+Jeśli widzisz błąd podczas uruchamiania skryptu `pa_autoconfigure_django.py`, oto kilka typowych przyczyn:
+
+- Zapominasz utworzyć Twój PythonAnywhere API token.
+- Robisz błąd w GitHub URL
+- Jeśli zobaczysz komunikat o błędzie *"Could not find your settings.py"*, prawdopodobnie nie udało Ci się dodać wszystkich plików do Git, i / lub nie przekazałeś ich do pomyślnie do GitHuba. Jeszcze raz spójrz na sekcję Git powyżej
+- Jeśli wcześniej zarejestrowałeś konto PythonAnywhere i wystąpił błąd z collectstatic, prawdopodobnie masz starszą wersję SQLite (np. 3.8.2) dla Twojego konta. W takim przypadku zarejestruj nowe konto i wypróbuj polecenia z sekcji PythonAnywhere powyżej.
+
+Jeśli odwiedzając swoją stronę zobaczysz błąd, to pierwszym miejscem, w którym powinnaś poszukać informacji o tym, co się stało, jest Twój **dziennik błędów** (ang. "error log"). Znajdziesz do niego link na stronie [Web](https://www.pythonanywhere.com/web_app_setup/) w PythonAnywhere. Sprawdź, czy znajdują się tam jakieś komunikaty o błędach - te najświeższe znajdują się na samym dole.
+
+Są tam też dostępne [generalne porady odnośnie debugowania na stronie pomocy PythonAnywhere](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+I pamiętaj, Twój mentor jest tutaj, by Ci pomóc!
+
+# Sprawdź swoją stronę!
+
+Domyślna strona Twojej witryny powinna brzmieć "It worked!", tak jak na Twoim lokalnym komputerze. Spróbuj dodać `/admin/` na koniec swojego adresu URL - powinnaś się przenieść do panelu admina. Zaloguj się za pomocą nazwy użytkownika i hasła. Zobaczysz, że możesz dodać nowy Post na serwerze - pamiętaj, posty z Twojej lokalnej, testowej bazy danych nie będą wysyłane na Twojego produkcyjnego bloga.
+
+Po utworzeniu kilku postów możesz wrócić do konfiguracji lokalnej (nie PythonAnywhere). Od teraz powinnaś pracować na swoim lokalnym komputerze, jeżeli będziesz chciała dokonać zmian na stronie. To częsty sposób pracy w rozwijaniu stron WWW - wprowadzaj zmiany lokalnie, wypychaj je na GitHuba i zaciągaj na swój internetowy serwer WWW. Pozwala to na pracę i eksperymentowanie bez obawy, że zepsujesz działającą stronę. Całkiem nieźle, co nie?
+
+*Przybij piątkę!* Wdrożenia strony na serwery są jednym z najtrudniejszych elementów tworzenia stron internetowych i często ludzie potrzebują kilku dni, zanim wszystko zacznie poprawnie działać. Ale Tobie udało się wdrożyć swoją stronę, jest ona w prawdziwym internecie!
\ No newline at end of file
diff --git a/pl-PL/deploy/install_git.md b/pl-PL/deploy/install_git.md
new file mode 100644
index 00000000000..47fc12cfe1b
--- /dev/null
+++ b/pl-PL/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git jest "systemem kontroli wersji", którego używa wielu programistów. Program ten śledzi zmiany w plikach na przestrzeni czasu, dzięki czemu możesz później przywracać wybrane wersje tych plików. Trochę jak funkcja "Śledź zmiany" w programach do edytowania tekstu (np. programu Microsoft Word lub LibreOffice Writer), ale jest o wiele potężniejsza.
+
+## Instalacja Gita
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Możesz ściągnąć Gita z [git-scm.com](https://git-scm.com/). Naciśnij "next" na wszystkich krokach z wyjątkiem dwóch: w kroku, w którym prosi o wybranie edytora, powinnaś wybrać Nano, a w kroku zatytułowanym "Adjusting your PATH environment" wybrać "Use Git and optional Unix tools from the Windows Command Prompt" (dolna opcja). Poza tym domyślne ustawienia są w porządku. Upewnij się jeszcze, że w kroku "Configuring the line ending conversions" wybrana jest opcja "Checkout Windows-style, commit Unix-style line endings".
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Ściągnij Gita z [git-scm.com](https://git-scm.com/) i postępuj zgodnie z instrukcją.
+
+> **Uwaga**Jeżeli działasz na OS X 10.6, 10.7 lub 10.8, będziesz musiała zainstalować wersję gita dostępną tutaj: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/pl-PL/deploy/signup_pythonanywhere.md b/pl-PL/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..b73dca9e266
--- /dev/null
+++ b/pl-PL/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere jest platformą do uruchamiania kodu Pythona w chmurze. Będziemy go używać do hostowania naszej strony na żywo w internecie.
+
+Utwórz konto dla "Beginner" na PythonAnywhere (darmowy poziom jest dobry, nie potrzebujesz do niego karty kredytowej).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![Strona rejestracji PythonAnywhere z przyciskiem, aby utworzyć bezpłatne konto "Beginner".](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> ** Uwaga!** Wybierając tutaj swoją nazwę użytkownika, należy pamiętać, że adres URL bloga będzie miał postać `twojanazwa.pythonanywhere.com`, więc wybierz swój własny nick lub nazwę tego, o czym będzie blog. Pamiętaj, aby zapamiętać hasło (dodaj je do menedżera haseł, jeśli go używasz).
+
+## Tworzenie tokenu PythonAnywhere API
+
+Tę operację będziesz musiała wykonać tylko raz. Kiedy już zakończysz tworzenie konta na PythonAnywhere, zostaniesz przeniesiona do strony nawigacyjnej. Znajdź u góry na prawo link do Twojego konta (ang. Account).
+
+![Link do konta na górze strony.](../deploy/images/pythonanywhere_account.png)
+
+a następnie wybierz zakładkę o nazwie "API Token" i wciśnij przycisk, który utworzy nowy token API (ang. "Create new API token").
+
+![Zakładka z tokenem API w koncie użytkownika.](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/pl-PL/django/README.md b/pl-PL/django/README.md
new file mode 100644
index 00000000000..d2b2903fd90
--- /dev/null
+++ b/pl-PL/django/README.md
@@ -0,0 +1,27 @@
+# Czym jest Django?
+
+Django (czytaj: dżango) to darmowy i open-source'owy framework do tworzenia aplikacji webowych, napisany w Pythonie. To taki zbiór narzędzi, dzięki którym tworzenie stron internetowych jest szybsze i łatwiejsze.
+
+Gdy budujesz stronę internetową, często potrzebujesz tych samych rzeczy: uwierzytelnić użytkowników (rejestracja, logowanie, wylogowywanie), panel zarządzania stroną, formularzy, sposobu przesyłania plików itd.
+
+Na szczęście pewni programiści już kiedyś zauważyli, że wszyscy web developerzy stają przed takimi samymi problemami i stworzyli frameworki (Django jest jednym z nich), które dostarczają nam gotowych do użycia komponentów.
+
+Frameworki istnieją, by oszczędzić Ci wyważania otwartych drzwi i ułatwić Ci proces tworzenia nowej strony.
+
+## Dlaczego potrzebujesz frameworka?
+
+By zrozumieć do czego naprawdę służy Django, musimy lepiej przyjrzeć się serwerom. Pierwszą rzeczą, którą musi wiedzieć serwer, jest to, że chcesz, żeby wyświetlił Ci stronę.
+
+Wyobraź sobie skrzynkę pocztową (port), która monitorowana jest pod kątem przychodzących listów (żądań). To właśnie rola serwera WWW. Serwer czyta listę (żądanie), a następnie odsyła odpowiedź przy użyciu strony internetowej. Ale gdy chcesz coś wysłać, musisz mieć jakąś treść. A Django jest właśnie tym, co pomoże Ci stworzyć tę treść.
+
+## Co się dzieje, gdy ktoś chce otworzyć stronę z Twojego serwera?
+
+Kiedy serwer otrzymuje żądanie, przekazuje je dalej do Django, aby ten ustalił, czego właściwie ono dotyczy. Django sprawdza najpierw adres strony i decyduje, co zrobić dalej. Ta część jest wykonywana przez obecny w Django mechanizm rozpoznawania adresów (ang. **urlresolver** - zwróć uwagę, że adres strony to inaczej adres URL, czyli angielska nazwa tego modułu nie jest przypadkowa). Nie jest on zbyt inteligentny - pobiera listę wzorców i próbuje dopasować adres URL. Django sprawdza wzorce od góry do dołu i jeśli uda się znaleźć pasującą regułę, przekazuje żądanie do odpowiedniej funkcji (zwanej *widokiem*).
+
+Wyobraź sobie listonosza niosącego list. Idzie ulicą i porównuje każdy numer domu z adresem na kopercie. List zostawia w skrzynce tego domu, którego adres pasuje. Tak samo działa urlresolver!
+
+W funkcji *widoku* dzieje się wszystko to, co najciekawsze: tutaj możemy połączyć się z bazą danych i wyszukać potrzebne nam informacje. Może użytkownik poprosił o zmianę danych? To tak, jakbyś wysłała list o treści "proszę o zmianę opisu mojego stanowiska pracy". *Widok* może sprawdzić, czy masz takie uprawnienia, a następnie dokona zmiany opisu i odeśle odpowiedź "Zrobione!". Wówczas *widok* generuje odpowiedź, a Django wysyła ją do przeglądarki użytkownika.
+
+Powyższy opis jest nieco uproszczony, ale znajomość niuansów technicznych nie jest Ci na razie potrzebna. Wystarczy, że zrozumiesz ogólną zasadę działania.
+
+Dlatego nie będziemy się zbyt mocno zagłębiać w szczegóły i zacznijmy budować coś w Django. Wszystkich potrzebnych rzeczy nauczymy się po drodze!
\ No newline at end of file
diff --git a/pl-PL/django_admin/README.md b/pl-PL/django_admin/README.md
new file mode 100644
index 00000000000..7c20a581c90
--- /dev/null
+++ b/pl-PL/django_admin/README.md
@@ -0,0 +1,57 @@
+# Administracja Django (admin)
+
+W celu dodawania, edycji czy usuwania artykułów, dla których model przed chwilą stworzyłyśmy, użyjemy admina Django.
+
+Otwórzmy plik `blog/admin.py` w edytorze kodu i zamieńmy jego zawartość na:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Jak widać, importujemy (dołączamy) model Post, który zdefiniowałyśmy w poprzednim rozdziale. Aby nasz model był widoczny w panelu admina, musimy go zarejestrować za pomocą polecenia `admin.site.register(Post)`.
+
+OK, czas rzucić okiem na nasz model Post. Pamiętaj, by wpisać `python manage.py runserver` w wierszu polecenia, by uruchomić serwer. Przejdź do przeglądarki i wpisz adres http://127.0.0.1:8000/admin/. Zobaczysz stronę logowania podobną do tej:
+
+![Strona logowania](images/login_page2.png)
+
+Aby móc się zalogować, musisz utworzyć konto administratora (*superuser*) - czyli użytkownika, który posiada nieograniczony dostęp do całej strony. Wróć do wiersza polecenia, wpisz `python manage.py createsuperuser` i wciśnij enter.
+
+> Pamietaj - aby móc wprowadzić nowe polecenie podczas pracy web serwera, otwórz nowy terminal i aktywuj virtualenv. Przyjrzałyśmy się, jak wpisywać nowe komendy w rozdziale **Twój pierwszy projekt w Django!**, w sekcji **Uruchamianie serwera www**.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Po wyświetleniu komunikatu, wpisz swoją nazwę użytkownika (małymi literami, bez spacji), adres e-mail i hasło. ** Nie martw się, że nie widzisz hasła, które wpisujesz - tak powinno być.** Wpisz je i naciśnij klawisz `Enter`, aby kontynuować. Dane wyjściowe powinny wyglądać tak (gdzie nazwa użytkownika i adres e-mail powinny być Twoje):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Wróć do przeglądarki. Zaloguj się za pomocą danych logowania administratora, które wybrałaś; powinnaś zobaczyć panel administracyjny Django.
+
+![Admin Django](images/django_admin3.png)
+
+Przejdź do sekcji Posts i poeksperymentuj trochę. Dodaj pięć czy sześć wpisów do bloga. Nie martw się zawartością - widoczna ona jest tylko na Twoim komputerze - możesz skopiować i wkleić fragment tekstu z tego tutoriala, aby zaoszczędzić czas. :)
+
+Upewnij się, że co najmniej dwa lub trzy posty (ale nie wszystkie) mają ustawioną datę publikacji. Będzie to pomocne później.
+
+![Admin Django](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Jest to prawdopodobnie dobry moment, aby wziąć kawę (lub herbatę) lub coś do jedzenia, aby ponownie naładować się energią. Stworzyłaś swój pierwszy model Django - zasługujesz na małą przerwę!
\ No newline at end of file
diff --git a/pl-PL/django_forms/README.md b/pl-PL/django_forms/README.md
new file mode 100644
index 00000000000..0fc9d39b0bd
--- /dev/null
+++ b/pl-PL/django_forms/README.md
@@ -0,0 +1,479 @@
+# Formularze Django
+
+Ostatnią rzeczą, jaką potrzebujemy dla naszej strony, jest stworzenie przyjemnego sposobu dodawania i edytowania wpisów na blog. Panel administracyjny (Django `admin`) jest fajny, ale raczej ciężko się go dostosowuje do niestandardowych potrzeb i ciężko poprawić jego wygląd. Z formularzami (`forms`) mamy absolutną władzę nad naszym interfejsem - możemy zbudować niemal wszystko, co nam przyjdzie do głowy!
+
+Sympatyczną cechą formularzy Django jest to, że możemy je budować samodzielnie od zera lub posłużyć się formularzem modelu (`ModelForm`), który zapisze dane wynikowe w danym modelu.
+
+To właśnie zamierzamy zrobić: zbudujemy formularz dla naszego modelu `Post`.
+
+Jak każda istotna część Django, formularze mają swój własny plik: `forms.py`.
+
+Stwórzmy plik o takiej nazwie w katalogu `blog`.
+
+    blog
+       └── forms.py
+    
+
+Dobrze, a teraz otwórzmy edytor kodu i wprowadźmy następujący kod:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Musimy najpierw zaimportować formularze Django (`from django import forms`) oraz nasz model `Post` (`from .models import Post`).
+
+`PostForm`, jak zapewne podejrzewasz, to nazwa naszego formularza. Musimy poinformować Django, że ten formularz jest formularzem modelu (`ModelForm`), dzięki czemu Django wyręczy nas w pewnych czynnościach - właśnie za to odpowiada `forms.ModelForm`.
+
+Dalej mamy `class Meta`, gdzie przekazujemy Django informację o tym, jaki model powinien być wykorzystany do stworzenia tego formularza (`model = Post`).
+
+I wreszcie możemy wskazać, które pole (lub pola) powinny pojawić się w naszym formularzu. W tym przypadku chcemy udostępnić tylko pola `title` (tytuł) i `text` (treść wpisu) - pole autora, czyli `author` powinno zawierać aktualnie zalogowanego użytkownika (Ciebie!), zaś data stworzenia wpisu (`created_date`) powinna być ustawiana automatycznie, gdy stworzymy wpis (czyli za pomocą kodu) - zgadza się?
+
+I to wszystko! Jedyne, co potrzebujemy teraz zrobić, to użyć naszego formularza wewnątrz *widoku* i wyświetlić go w szablonie.
+
+Oto co za chwilę stworzymy: link do strony, adres URL, widok i szablon.
+
+## Odnośnik do strony z formularzem
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## Adres URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## Widok post_new
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Szablon
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* Musimy wyświetlić formularz. Możemy to zrobić np. za pomocą polecenia {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Potrzebny nam przycisk `Zapisz`. Tworzymy go jako przycisk w HTML: `<button type="submit">Save</button>`.
+* I na koniec jeszcze, zaraz po znaczniku otwierającym `<form ...>`musimy dodać {% raw %}`{% csrf_token %}`{% endraw %}. To bardzo ważne, gdyż ta linijka sprawia, że Twoje formularze są bezpieczne! Jeśli o tym zapomnisz i spróbujesz zapisać formularz, Django nie pozostawi tego bez komentarza:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Zapisujemy formularz
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Walidacja formularza
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edycja formularza
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Bezpieczeństwo
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Jeszcze jedno: czas na wdrożenie!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* Po pierwsze zapiszmy nasze zmiany i wyślijmy je na GitHuba:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Potem, w konsoli [PythonAnywhere Bash](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Nareszcie przeskakujemy do do ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (użyj przycisku menu w prawym górnym rogu konsoli) i naciśnij **Reload**. Odśwież swój blog https://yourname.pythonanywhere.com, aby zobaczyć zmiany.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/pl-PL/django_installation/README.md b/pl-PL/django_installation/README.md
new file mode 100644
index 00000000000..ab5473fe08b
--- /dev/null
+++ b/pl-PL/django_installation/README.md
@@ -0,0 +1,7 @@
+# Instalowanie Django
+
+> **Uwaga** Jeśli używasz już Chromebooka, pomiń ten rozdział i upewnij się, że postąpiłeś zgodnie z instrukcją [Instalowanie Chromebook](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/pl-PL/django_installation/instructions.md b/pl-PL/django_installation/instructions.md
new file mode 100644
index 00000000000..a2af7f2acbf
--- /dev/null
+++ b/pl-PL/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Fragmenty tego rozdziału napisane są w oparciu o kurs Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Fragmenty tego rozdziału są oparte o tutorial [django-marcador](http://django-marcador.keimlink.de/) na licencji Creative Commons Attribution-ShareAlike 4.0 International. Tutorial django-marcador jest chroniony prawami autorskimi przez Markusa Zapke-Gründemanna i in.
+
+## Środowisko wirtualne
+
+Zanim zainstalujemy Django, zapoznamy się z niezwykle użytecznym narzędziem, które pomoże utrzymać porządek poczas pracy z kodem na Twoim komputerze. Można ten krok pominąć, ale zachęcamy, żebyś tego nie robiła. Dobrze jest zacząć z możliwie najlepszą konfiguracją, gdyż zaoszczędzi Ci to wielu problemów w przyszłości!
+
+Stwórzmy zatem **środowisko wirtualne** (zwane też *virtualenv*). Jego zadaniem jest oddzielenie środowiska Pythona/Django dla każdego projektu z osobna. Oznacza to, że zmiany dokonane w obrębie jednej aplikacji nie wpłyną na działanie innych, nad którymi pracujesz. Sprytne, prawda?
+
+Jedyne, co potrzebujesz zrobić, to wybrać katalog, w którym chcesz utworzyć `virtualenv`; na przykład Twój katalog domowy. Na Windowsie może on wyglądać jak `C:\Users\Name` (gdzie `Name` jest twoim loginem).
+
+> **UWAGA:** W Windowsie upewnij się, że katalog ten nie zawiera znaków akcentowanych lub specjalnych; Jeśli Twoja nazwa użytkownika zawiera znaki akcentowane, użyj innego katalogu, na przykład `C:\djangogirls`.
+
+Na potrzeby kursu będziemy tworzyć nowy katalog `djangogirls` w Twoim katalogu domowym:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Stwórzmy nowe środowisko wirtualne o nazwie `myvenv`. Polecenie ma następujący format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Aby utworzyć nowego `virtualenv`'a, musisz otworzyć okno wiersza polecenia i wykonać polecenie `python -m venv myvenv`. Będzie to wyglądać tak:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Gdzie `myvenv` to nazwa Twojego `virtualenv`'a. Nazwa może być dowolna, ale lepiej używać tylko małych liter, bez spacji i polskich znaków. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Możemy stworzyć `virtualenv`'a w Linuksie i OS X poprzez użycie jedynie polecenia `python3 -m venv myvenv`. Przyjmie ono następującą postać:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` to nazwa Twojego `virtualenv`'a. Nazwa środowiska może być dowolna, ale lepiej używać tylko małych liter, bez spacji i polskich znaków. Dobrze jest też trzymać się krótkich nazw - będziesz do nich często wracała!
+
+> **UWAGA:** W niektórych wersjach Debiana/Ubuntu może pojawić się następujący komunikat o błędzie:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> W tym przypadku, wykonaj powyższe instrukcje i zainstaluj pakiet `python3-venv`: {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3-venv
+>     
+> 
+> **UWAGA:** W niektórych wersjach Debiana/Ubuntu inicjowanie środowiska wirtualnego w ten sposób daje obecnie następujący błąd:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Aby uniknąć tego problemu, użyj polecenia `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **UWAGA:** Jeśli wystąpi błąd taki jak
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> to zamiast tego wykonaj:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Praca z virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Uruchom wirtualne środowisko za pomocą polecenia:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Użytkownicy\Nazwa\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. W tym przypadku, otwórz inny Windows PowerShell z opcją "Uruchom jako Administrator". Następnie spróbuj, wpisując następujące polecenie przed rozpoczęciem środowiska wirtualnego:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Uruchom wirtualne środowisko za pomocą polecenia:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python3 -m pip install --upgrade pip
+    
+
+### Instalacja pakietów z pliku wymagań
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/pl-PL/django_models/README.md b/pl-PL/django_models/README.md
new file mode 100644
index 00000000000..dacab524c2b
--- /dev/null
+++ b/pl-PL/django_models/README.md
@@ -0,0 +1,202 @@
+# Modele w Django
+
+Teraz zajmiemy się tworzeniem czegoś, co będzie przechowywało wszystkie wpisy na naszym blogu. Ale zanim przystąpimy do tego, musimy poświęcić chwilę na przyjrzenie się tworom zwanym `obiektami`.
+
+## Obiekty
+
+W programowaniu istnieje pojęcie `programowania zorientowanego obiektowego`. Chodzi o to, że zamiast wpisywania nudnych sekwencji poleceń, możemy tworzyć modele różnych rzeczy i definiować w jaki sposób wchodzą ze sobą w interakcję.
+
+Zatem czym są obiekty? To po prostu zbiór pewnych właściwości i czynności. Owszem, brzmi dziwnie, ale przyjrzyjmy się temu na przykładzie.
+
+Jeśli chcemy stworzyć model kota, stworzymy obiekt o nazwie `Kot` posiadający jakieś właściwości, np. `kolor`, `wiek`, `nastrój` (np. dobry, zły, senny ;)), i `właściciel` (czyli obiekt typu `Osoba` lub pozostawimy tę właściwość pustą, wtedy mamy bezpańskiego kota).
+
+Nasz `Kot` ma określone czynności: `mrucz`, `podrap`, `jedz` (i w tym przypadku przekażemy kotu oddzielny obiekt o nazwie `KociPrzysmak` ze swoimi własnymi właściwościami, np. `smak`).
+
+    Kot
+    --------
+    kolor
+    wiek
+    nastroj
+    wlasciciel
+    mrucz()
+    podrap()
+    jedz(koci_przysmak)
+    
+
+    KociPrzysmak
+    --------
+    smak
+    
+
+Czyli w zasadzie chodzi o to, że opisujemy prawdziwe rzeczy w kodzie za pomocą właściwości (zwanych `właściwościami obiektu`) oraz czynności (zwanych `metodami`).
+
+W takim razie jak będzie wyglądał model naszego postu na blogu? Chcemy zbudować blog, zgadza się?
+
+Musimy sobie odpowiedzieć na pytanie: Czym jest post na blogu? Jakie powinien mieć właściwości?
+
+Na pewno musi zawierać zawartość tekstową oraz tytuł, prawda? Fajnie byłoby też wiedzieć, kto go napisał - czyli potrzebujemy autora. No i chcemy także znać daty, kiedy wpis został utworzony i opublikowany.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Co możemy zrobić z wpisem na blogu? Przydałaby nam się jakaś `metoda`, która opublikuje nasz wpis, zgadza się?
+
+Tak więc będziemy potrzebować metody `publish`.
+
+Skoro już wiemy, co chcemy osiągnąć, pora zacząć tworzyć model w Django!
+
+## Model w Django
+
+Wiedząc, czym jest obiekt, możemy stworzyć model Django odpowiadający naszemu wpisowi na blogu.
+
+Model w Django jest specjalnym rodzajem obiektu - jest zapisywany w `bazie danych`. Baza danych jest zbiorem informacji. Miejscem, w którym przechowujemy informacje o użytkownikach, Twoje wpisy na blogu, itd. Do zapisania naszych danych użyjemy bazy SQLite. Jest to domyślny moduł bazy danych w Django - na nasze potrzeby w zupełności wystarczy.
+
+Możesz sobie wyobrazić model w bazie danych jako arkusz kalkulacyjny z kolumnami (polami) oraz wierszami (danymi).
+
+### Tworzenie aplikacji
+
+Aby utrzymać wszystko w ładzie, stworzymy osobną aplikację wewnątrz naszego projektu. Przyjemnie jest mieć wszystko uporządkowane od samego początku. Aby stworzyć aplikację, musimy wykonać następujące polecenie w konsoli (z poziomu katalogu `djangogirls`, tam gdzie znajduje się plik `manage.py`):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Zauważysz, że nowy katalog `blog` został utworzony i zawiera kilka plików. Katalogi i pliki w naszym projekcie powinny wyglądać tak:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+Po stworzeniu aplikacji, musimy dać znać Django, że powinien jej używać. Robimy to w pliku `mysite/settings.py` - otwórz go w swoim edytorze kodu. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. Czyli efekt końcowy powinien wyglądać tak:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Tworzymy model wpisu na blogu
+
+W pliku `blog/models.py` definiujemy wszystkie obiekty zwane `Models` - jest to miejsce, w którym będziemy definiować nasz wpis na blogu.
+
+Otwórz plik `blog/models.py` w swoim edytorze kodu, usuń z niego całą zawartość i wpisz taki kod:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User', on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Upewnij się, że używasz dwóch znaków podkreślenia (`_`) po obu stronach `str`. W Pythonie używa się ich bardzo często i czasem nazywa się je "dunder" (skrót od angielskiej nazwy: "double-underscore").
+
+Wygląda przerażająco, prawda? Ale nie martw się - będziemy tłumaczyć, co te linijki znaczą!
+
+Wszystkie wiersze zaczynające się od `from` lub `import` są wierszami dodającymi jakieś elementy z innych plików. Czyli zamiast kopiowania i wklejania tych samych treści w każdym pliku, możemy po prostu zawrzeć ich fragmenty za pomocą `from... import ...`.
+
+`class Post(models.Model):` - ta linijka definiuje nasz model (jest on obiektem, czyli `object`).
+
+- `class` to specjalne słowo kluczowe, które sygnalizuje, że tworzymy obiekt.
+- `Post` to nazwa naszego modelu. Możemy nadać mu inną nazwę (bez polskich liter, znaków specjalnych i spacji). Zawsze zaczynaj nazwę modelu wielką literą.
+- `models.Model` oznacza, że nasz obiekt Post jest modelem Django. W ten sposób Django wie, że powinien go przechowywać w bazie danych.
+
+Teraz dodamy właściwości, o których wspomniałyśmy już wcześniej: `title` (tytuł), `text` (treść wpisu), `created_date` (data utworzenia), `published_date` (data publikacji) oraz `author` (autor). Do tego celu potrzebujemy określić typ każdego pola (Czy to jest tekst? Liczba? Data? Odwołanie do innego obiektu, np. użytkownika?)
+
+- `models.CharField` - tak definiujemy tekst z ograniczoną liczbą znaków.
+- `models.TextField` - a to nadaje się do dłuższych tekstów bez ograniczeń w ilości znaków. Dla treści wpisu będzie idealne, prawda?
+- `models.DateTimeField` - to jest data i godzina.
+- `models.ForeignKey` - to jest odnośnik do innego modelu.
+
+Nie będziemy tutaj wyjaśniać drobiazgowo każdego elementu kodu, gdyż zajęłoby to zbyt dużo czasu. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+A co to takiego `def publish(self):`? To jest dokładnie metoda publikująca wpis (`publish`), o której wspominaliśmy wcześniej. Wyraz `def` oznacza, że mamy do czynienia z funkcją/metodą, a `publish` to nazwa metody. Możesz zmienić nazwę metody, jeśli chcesz. Zasadą jest, że używamy małych liter oraz znaków podkreślenia zamiast spacji. Na przykład metodę, która oblicza średnią cenę, można nazwać `calculate_average_price`.
+
+Bardzo często metody coś zwracają (ang. `return`). Przykład tego znajdziesz w metodzie `__str__`. W tym przypadku wywołując metodę `__str__()` otrzymamy tekst (**string**) zawierający tytuł wpisu.
+
+Również należy zauważyć, że zarówno `def publish(self):` i `def __str__(self):` są wcięte wewnątrz naszej klasy. Ponieważ Python jest wrażliwy na odstępy, musimy wciąć nasze metody wewnątrz klasy. W przeciwnym razie metody nie będą należeć do klasy i można uzyskać nieoczekiwane zachowanie.
+
+Jeśli coś nie jest jeszcze jasne w modelach, nie wahaj się zapytać swojego mentora! Zdajemy sobie sprawę, że jest to dość skomplikowane, zwłaszcza gdy poznajesz obiekty i funkcje w tym samym czasie. Mimo wszystko mamy nadzieję, że teraz wygląda nieco mniej magicznie!
+
+### Tworzymy tabele dla modeli w bazie danych
+
+Został nam ostatni krok, a mianowicie dodanie naszego nowego modelu do bazy danych. Najpierw musimy poinformować Django, że mamy pewne zmiany w naszym modelu. (Właśnie go utworzyłyśmy!) Przejdź do okna konsoli i wpisz `python manage.py makemigrations blog`. Będzie to wyglądać tak:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Uwaga:** Pamiętaj, aby zapisać pliki, które edytujesz. W przeciwnym razie Twój komputer wykona poprzednią wersję, która może dać Tobie nieoczekiwane komunikaty o błędach.
+
+Django przygotował dla nas plik z migracjami, które musimy zastosować teraz do naszej bazy danych. Wpisz `python manage.py migrate blog`, a wynik powinien wyglądać następująco:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurra! Nasz model wpisu znajduje się teraz w naszej bazie danych! Byłoby miło to zobaczyć, prawda? Przejdź do następnego rozdziału, aby zobaczyć, jak wygląda nasz wpis!
\ No newline at end of file
diff --git a/pl-PL/django_orm/README.md b/pl-PL/django_orm/README.md
new file mode 100644
index 00000000000..0cbf3d52c9c
--- /dev/null
+++ b/pl-PL/django_orm/README.md
@@ -0,0 +1,221 @@
+# ORM i obiekty QuerySet w Django
+
+Z tego rozdziału dowiesz się, w jaki sposób Django łączy się z bazą danych i gromadzi w niej informacje. Do dzieła!
+
+## Czym jest QuerySet?
+
+Najprościej mówiąc, QuerySet jest listą obiektów danego Modelu. Za jego pomocą możesz odczytywać informacje z bazy danych, jak również je filtrować i układać w określonej kolejności.
+
+Najłatwiej uczyć się na przykładach. To co, spróbujemy?
+
+## Konsola Django
+
+Otwórz swoją lokalną konsolę Django (nie na PythonAnywhere) i wpisz następujące polecenie:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Efekt powinien wyglądać tak:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Jesteś teraz w interaktywnej konsoli Django. Przypomina ona nieco wiersz polecenia Pythona, z odrobiną dodatkowej magii Django. :) Możesz także używać w niej wszystkich poleceń Pythona.
+
+### Wszystkie obiekty
+
+Na początek spróbujmy wyświetlić wszystkie nasze wpisy. Zrób to następującym poleceniem:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Ups! Wyskoczył błąd. Mówi on nam, że nie istnieje coś takiego jak 'Post'. Oczywiście -- zapomniałyśmy go wcześniej zaimportować!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+Importujemy model `Post` z `blog.models`. Spróbujmy jeszcze raz wyświetlić wszystkie wpisy:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Pojawiła się lista wpisów, które dodałyśmy wcześniej! Utworzyłyśmy je przy pomocy panelu administracyjnego Django. Teraz jednak chciałybyśmy dodać nowy wpis używając Pythona. Jak to zrobimy?
+
+### Tworzenie obiektu
+
+W taki sposób tworzymy nowy obiekt Post w bazie danych:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Ale brakuje nam jednego składnika: `me`. Musimy przekazać instancję modelu `User` jako autora. Jak to zrobić?
+
+Najpierw zaimportujmy model User:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Jakich użytkowników mamy w bazie danych? Spróbuj tak:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+To konto administratora, które stworzyłyśmy wcześniej! Teraz uzyskajmy dostęp do naszej instancji użytkownika (podmień poniższą linię, by zawierała nazwę Twojego użytkownika):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Jak widzisz, za pomocą polecenia `get` pobrałyśmy z bazy obiekt użytkownika (`User`) z właściwością `username` o wartości 'ola'. Elegancko!
+
+Teraz możemy wreszcie stworzyć nasz post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hura! Chciałabyś sprawdzić, czy się udało?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Jest! Kolejny post na liście!
+
+### Dodajemy więcej wpisów
+
+Możesz teraz trochę się zabawić i dodać więcej postów, aby zobaczyć, jak to działa. Dodaj dwa lub trzy kolejne, a następnie przejdź do następnej części.
+
+### Filtrowanie obiektów
+
+Niezmiernie istotną cechą QuerySetów jest możliwość ich filtrowania. Dajmy na to, że chciałybyśmy znaleźć wszystkie wpisy dodane przez użytkowniczkę (User) o nazwie ola. Skorzystamy z metody `filter` zamiast `all` w `Post.objects.all()`. W nawiasach podajemy, jaki warunek bądź warunki muszą spełniać posty na blogu, aby znaleźć się w naszym zapytaniu. W naszej sytuacji chcemy, by `author` (autor) odpowiadał zmiennej `me`. W Django zapisujemy to tak: `author=me`. Teraz nasz kawałek kodu wygląda mniej-więcej tak:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+A może chcemy zobaczyć wszystkie posty, które zawierają słowo "tytuł" w polu `title`?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Uwaga:** Pomiędzy `title` a `contains` znajdują się dwa znaki podkreślenia (`_`). ORM w Django używa takiej składni, aby oddzielić nazwy pól ("title") od operacji lub filtrów ("contains"). Jeśli użyjesz tylko jednego, zobaczysz błąd o treści "FieldError: Cannot resolve keyword title_contains".
+
+Możemy także wyświetlić listę wszystkich opublikowanych wpisów. W tym celu odfiltrujmy wszystkie wpisy, które mają ustawioną datę publikacji (`published_date`) na taką, która już minęła:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Niestety, post dodany przez nas z konsoli Pythona nie został jeszcze opublikowany. Ale możemy to zmienić! Zacznij od pobrania wpisu, który chcesz opublikować:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+A następnie opublikuj go za pomocą metody `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Teraz spróbujmy jeszcze raz wyświetlić listę opublikowanych wpisów (wciśnij trzykrotnie klawisz ze strzałką do góry, a następnie zatwierdź klawiszem `Enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Kolejność obiektów
+
+QuerySety umożliwiają również porządkowanie list obiektów według określonej kolejności. Spróbujmy uporządkować je według daty utworzenia, czyli zawartości pola `created_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Możemy także odwrócić kolejność poprzez dodanie `-` na początku:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Łączenie QuerySetów
+
+Jak widziałyśmy, niektóre metody `Post.objects` zwracają nam QuerySet. Te same metody z kolei również mogą być wywoływane na QuerySetcie, co zwróci nam nowy QuerySet. W związku z tym można połączyć ich efekt poprzez **złączenie** ich razem:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+To naprawdę potężne narzędzie, które pozwala na pisanie bardzo złożonych zapytań.
+
+Doskonale! Jesteś teraz gotowa na następną część! Zamknij konsolę poleceniem:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/pl-PL/django_start_project/README.md b/pl-PL/django_start_project/README.md
new file mode 100644
index 00000000000..635fd165694
--- /dev/null
+++ b/pl-PL/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Twój pierwszy projekt w Django!
+
+> Fragment tego rozdziału opiera się o tutoriale Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Fragmenty tego rozdziału są oparte o [tutorial django-marcador](http://django-marcador.keimlink.de/) na licencji Creative Commons Attribution-ShareAlike International 4.0. Tutorial django-marcador jest chroniony prawami autorskimi przez Markusa Zapke-Gründemanna i in.
+
+Mamy zamiar stworzyć prosty blog!
+
+Pierwszy krok, który trzeba wykonać, to utworzenie nowego projektu Django. To oznacza, że skorzystamy z dostarczonych przez Django skryptów, które utworzą za nas szkielet projektu Django. Ten szkielet to zbiór katalogów i plików, których będziemy używać później.
+
+Nazwy niektórych plików i katalogów są bardzo ważne dla Django. Nie powinnaś zmieniać nazw plików, które zostaną utworzone. Przenoszenie ich w inne miejsce też nie jest dobrym pomysłem. Django wymaga zachowania pewnej struktury, by móc szybko znaleźć potrzebne rzeczy.
+
+> Pamiętaj, aby uruchamiać wszystko w virtualenvie. Jeśli nie widzisz prefiksu `(myvenv)` w konsoli, to znaczy że musisz uruchomić swój virtualenv. Wyjaśniłyśmy, jak to zrobić w rozdziale **Instalacja Django** w części **Praca z virtualenv**. Wystarczy wpisać `myvenv\Scripts\activate` w systemie Windows lub `source myvenv/bin/activate`, jeśli używasz Mac OS X lub Linux.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+Dla systemów MacOS X lub Linux, wpisz teraz do swojej konsoli następującą komendę. **Nie zapomnij dodać kropki `.` na końcu!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Kropka `.` ma kluczowe znaczenie, ponieważ dzięki niej skrypt wie, że ma zainstalować Django w bieżącym katalogu (kropka `.` to taka skrócona nazwa bieżącego katalogu).
+> 
+> **Uwaga** Kiedy będziesz przepisywać komedy, które zamieściliśmy wyżej, pamiętaj, że przepisujesz tylko tę część, która zaczyna się od `django-admin`. `(myvenv) ~/djangogirls$` są tutaj tylko po to, by pokazać Ci przykład wiersza polecenia i tego, jak będzie on wyglądał, gdy będziesz wpisywać polecenia.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Dla systemu Windows wpisz teraz do swojej konsoli następującą komendę. **Nie zapomnij dodać kropki `.` na końcu**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Kropka `.` ma kluczowe znaczenie, ponieważ dzięki niej skrypt wie, że ma zainstalować Django w bieżącym katalogu (kropka `.` to taka skrócona nazwa bieżącego katalogu).
+> 
+> **Uwaga** Kiedy będziesz przepisywać komedy, które zamieściliśmy wyżej, pamiętaj, że przepisujesz tylko tę część, która zaczyna się od `django-admin.exe`. `(myvenv) C:\Users\Name\djangogirls>` są tutaj tylko po to, by pokazać Ci przykład znaku zachęty wiersza polecenia, który będzie Ciebie zapraszał, byś wpisała komendę.
+
+<!--endsec-->
+
+`django-admin.py` jest skryptem, który utworzy katalogi i pliki za Ciebie. Powinnaś mieć teraz strukturę katalogów podobną do tej:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Uwaga**: w strukturze katalogów, możesz zobaczyć również katalog `venv`, który stworzyłyśmy wcześniej.
+
+`manage.py` jest skryptem ułatwiającym zarządzanie witryną. Za jego pomocą, oprócz wielu innych rzeczy, możemy uruchomić serwer na naszym komputerze bez potrzeby instalowania czegokolwiek.
+
+Plik `settings.py` zawiera konfigurację naszej strony.
+
+Pamiętasz, jak rozmawiałyśmy o listonoszu sprawdzającym gdzie dostarczyć list? Plik `urls.py` zawiera wzorce używane przez `urlresolver'a`.
+
+Na razie zapomnijmy o innych plikach - nie będziemy ich modyfikować. Jedyne, o czym musisz pamiętać, to żeby ich niechcący nie skasować!
+
+## Modyfikowanie ustawień
+
+Wprowadźmy parę zmian w pliku `mysite/settings.py`. Otwórz go za pomocą edytora kodu, który zainstalowałaś wcześniej.
+
+**Uwaga**: należy pamiętać, że `settings.py` jest zwykłym plikiem, jak każdy inny. Otworzysz go w edytorze kodu, przy użyciu menu "plik-> Otwórz". Powinnaś otrzymać zwykłe okno, w którym możesz przejść do pliku `settings.py` i zaznaczyć go. Możesz również otworzyć plik, przechodząc do folderu djangogirls na pulpicie, klikając na niego prawym przyciskiem myszy. Następnie wybierz edytor kodu z listy. Wybór edytora jest ważny, ponieważ możesz mieć zainstalowane inne programy, które mogą otworzyć plik, ale nie pozwolą Ci go edytować.
+
+Fajnie byłoby posługiwać się na naszej stronie właściwą strefą czasową. Przejdź do [listy stref czasowych w Wikipedii](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) i skopiuj właściwą strefę czasową (TZ) (np. `Europe/Warsaw`).
+
+W pliku `settings.py` znajdź linijkę, w której jest napisane `TIME_ZONE` i zmień ją wybierając swoją strefę czasową. Przykład:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Warsaw'
+```
+
+Kod języka składa się z języka, np. ` en ` dla języka angielskiego lub ` de ` dla języka niemieckiego i kodu kraju, np. ` de ` dla Niemiec lub ` ch ` dla Szwajcarii. Jeżeli angielski nie jest Twoim językiem ojczystym, możesz dodać tę wartość, aby domyślne przyciski i powiadomienia od Django będą w Twoim języku. Tak więc przycisk "Anuluj" zostałby przetłumaczony na język, który tu zdefiniowałaś. Django zawiera wiele gotowych tłumaczeń.
+
+Jeżeli chcesz używać innego języka, zmień jego kod, modyfikując następujący wiersz:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'pl-pl'
+```
+
+Musimy także dodać ścieżkę do plików statycznych. (Dowiemy się więcej o plikach statycznych i CSS w dalszej części kursu). Przejdź do samego *końca* pliku i pod linijką zawierającą `STATIC_URL` dodaj nową zmienną `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Gdy ` DEBUG ` jest ` True ` i ` ALLOWED_HOSTS ` jest puste, host jest sprawdzany pod kątem ` ['localhost', '127.0.0.1', '[::1]']`. To nie będzie pasować do naszej nazwy hosta w PythonAnywhere po wdrożeniu naszej aplikacji, więc zmienimy następujące ustawienie:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> ** Uwaga **: jeśli używasz Chromebooka, dodaj ten wiersz u dołu pliku settings.py: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Dodaj również `.c9users.io` do `ALLOWED_HOSTS`, jeżeli używasz cloud9
+> 
+> Jeśli hostujesz swój projekt na Glitch.com, pozwól nam chronić tajny klucz Django, który musi pozostać poufny (w przeciwnym razie każdy, kto remiksuje Twój projekt, może go zobaczyć):
+> 
+> - Najpierw utworzymy losowy tajny klucz. Ponownie otwórz terminal Glitch i wpisz następujące polecenie:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'z django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     Powinno to wyświetlić długi, losowy ciąg, idealny do użycia jako tajny klucz dla Twojej nowej strony internetowej Django. Najpierw utworzymy losowy tajny klucz. Ponownie otwórz terminal Glitch i wpisz następujące polecenie:
+> 
+> - Utwórz plik .env w katalogu głównym projektu i dodaj do niego następującą właściwość:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Inicjalizacja bazy danych
+
+Istnieje duży wybór baz danych, w których możemy trzymać dane naszej strony. My użyjemy bazy domyślnej, czyli `sqlite3`.
+
+Została ona już ustawiona w tej części pliku `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Aby utworzyć bazę danych dla naszego bloga, wykonajmy następujące polecenie w konsoli: `python manage.py migrate` (musimy być w katalogu `djangogirls`, tam gdzie znajduje się plik `manage.py`). Gdy to się uda, powinnaś zobaczyć coś takiego jak poniżej:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+I to wszystko! Czas uruchomić serwer i zobaczyć, czy nasza strona działa!
+
+## Uruchamianie serwera WWW
+
+Musisz znajdować się w katalogu zawierającym plik `manage.py` (katalog `djangogirls`). W konsoli możemy uruchomić serwer za pomocą polecenia `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Jeżeli korzystasz z Chromebooka, wykorzystaj komendę poniżej:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> Sprawdziliśmy, jak działają serwery internetowe w rozdziale **"Jak działa Internet"**.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/pl-PL/django_templates/README.md b/pl-PL/django_templates/README.md
new file mode 100644
index 00000000000..f3e2f32796b
--- /dev/null
+++ b/pl-PL/django_templates/README.md
@@ -0,0 +1,108 @@
+# Szablony Django
+
+Pora wyświetlić jakieś dane! Django udostępnia nam do tego celu przydatny zbiór wbudowanych **znaczników szablonu** (ang. template tags).
+
+## Co to są znaczniki szablonu?
+
+W HTML-u nie można tak naprawdę napisać kodu Pythona, ponieważ przeglądarki go nie rozumieją. Znają tylko HTML. Wiemy, że HTML jest raczej statyczny, a Python jest znacznie bardziej dynamiczny.
+
+**Znaczniki szablonów Django** pozwalają przesyłać obiekty podobne do Pythona do HTML, dzięki czemu możesz budować dynamiczne strony internetowe szybciej. Super!
+
+## Wyświetlamy szablon listy wpisów
+
+W poprzednim rozdziale przekazaliśmy listę postów w zmiennej `posts` do naszego szablonu. Teraz wyświetlmy ją w HTML.
+
+Aby wyświetlić zmienną w szablonie Django, używamy podwójnych nawiasów klamrowych z nazwą zmiennej w środku, w taki sposób:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Spróbuj tak zrobić w szablonie` blog/templates/blog/post_list.html`. Otwórz to w edytorze kodu i zastąp wszystko od drugiego `<div>` do trzeciego `</div>` wierszem `{{ posts }}`. Zapisz plik i odśwież stronę, by zobaczyć rezultat:
+
+![Rysunek 13.1](images/step1.png)
+
+Jak widzisz, dostaliśmy tylko tyle:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Oznacza to tyle, że Django rozumie to jako listę obiektów. Pamiętasz z rozdziału **Wprowadzenie do Pythona**, jak możemy wyświetlić zawartość listy? Tak, za pomocą pętli for! W szablonie Django używamy ich w ten sposób:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Wypróbuj tego w swoim szablonie.
+
+![Rysunek 13.2](images/step2.png)
+
+Działa! Ale chcemy, aby posty były wyświetlane jak statyczne posty, które stworzyliśmy wcześniej w rozdziale ** Wprowadzenie do HTMLa**. Możliwe jest łączenie znaczników szablonu z kodem HTML. Nasza sekcja `body` będzie wyglądać tak:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Wszystko, co zawrzesz pomiędzy `{% for %}` a `{% endfor %}` zostanie powtórzone dla każdego obiektu z listy. Odśwież swoją stronę:{% endraw %}
+
+![Rysunek 13.3](images/step3.png)
+
+Zapewne zauważyłaś, że tym razem użyłyśmy nieco innej składni: (`{{ post.title }}` lub `{{ post.text }}`)? W ten sposób uzyskujemy dostęp do danych zawartych w poszczególnych polach naszego modelu `Post`. Z kolei `|linebreaksbr` przepuszcza wpisy przez filtr, który zamienia znaczniki nowej linii na akapity.
+
+## Jeszcze jedno
+
+Dobrze byłoby sprawdzić, czy twoja strona wciąż będzie działała w publicznym Internecie, prawda? Spróbujmy ponownie wdrożyć w PythonAnywhere. Oto podsumowanie kroków…
+
+* Najpierw zapisz swój kod na GitHubie
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Teraz zaloguj się ponownie na [PythonAnywhere](https://www.pythonanywhere.com/consoles/) i przejdź do konsoli **Bash** (albo uruchom nową) i wpisz:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(pamiętaj, by podmienić `<your-pythonanywhere-domain>` na Twoją właściwą nazwę użytkownika PythonAnywhere, bez ostrych nawiasów)
+
+* Na koniec przeskocz do strony [Web](https://www.pythonanywhere.com/web_app_setup/) i naciśnij **Reload**. Aby dotrzeć do innych stron PythonAnywhere przez konsolę, użyj przycisku menu w prawym górnym rogu. Twoja zaktualizowana aplikacja powinna być już dostępna pod adresem https://subdomain.pythonanywhere.com - sprawdź to w swojej przeglądarce! Jeśli posty na blogu w witrynie PythonAnywhere nie są takie same jak posty znajdujące się na lokalnym serwerze, jest to OK. Bazy danych na komputerze lokalnym i PythonAnywhere nie synchronizują się z resztą plików.
+
+Gratulacje! Teraz śmiało, spróbuj dodać nowy post w panelu administracyjnym Django (pamiętaj, aby dodać datę publikacji (published_date)). Upewnij się, że jesteś w zalogowana jako administrator w Django dla Twojej witryny PythonAnywhere, https://subdomain.pythonanywhere.com/admin. Następnie odśwież stronę, aby zobaczyć, czy post się pojawił.
+
+Poszło jak z płatka? Jesteśmy dumne! Odejdź na chwilkę od komputera - zasłużyłaś na przerwę! :)
+
+![Rysunek 13.4](images/donut.png)
\ No newline at end of file
diff --git a/pl-PL/django_urls/README.md b/pl-PL/django_urls/README.md
new file mode 100644
index 00000000000..b1518e09e36
--- /dev/null
+++ b/pl-PL/django_urls/README.md
@@ -0,0 +1,103 @@
+# URL-e Django
+
+Zaczynamy budować naszą pierwszą stronę internetową: będzie to miejsce dla twojego bloga! Ale zanim zaczniemy, nauczmy się trochę na temat URL-i w Django.
+
+## Czym jest URL?
+
+Adres URL to adres w internecie. Możesz zobaczyć URL-a za każdym razem, gdy odwiedzasz stronę internetową - jest on widoczny w pasku adresu przeglądarki internetowej. (Tak! `127.0.0.1:8000` jest adresem URL! Też `https://djangogirls.org` jest adresem URL.)
+
+![URL](images/url.png)
+
+Każda strona w internecie potrzebuje własnego adresu URL. W ten sposób aplikacja wie, co wyświetlić użytkownikowi, który otworzy dany URL. W Django używamy tak zwanego `URLconf` (konfiguracji URL). URLconf to zestaw wzorców, które Django spróbuje dopasować do żądanego adresu URL, aby znaleźć poprawny widok.
+
+## Jak działają adresy URL w Django?
+
+Otwórzmy plik `mysite/urls.py` i przyjrzyjmy się jego treści:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Jak zauważyłaś, Django coś nam już tu umieścił.
+
+Linie między potrójnymi cudzysłowami (` '''` lub `""" `) nazywa się docstrings - możesz zapisać je na górze pliku, klasy lub metody, aby opisać, co robi. Nie będą one uruchamiane przez Pythona.
+
+Adres URL panelu administracyjnego, który odwiedzałaś w poprzednim rozdziale, jest już tutaj dodany:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+To znaczy, że dla każdego adresu zaczynającego się od `admin/` Django spróbuje dopasować odpowiedni *widok*. W tym przypadku używamy wielu adresów URL panelu administracyjnego, dlatego nie wypisujemy ich wszystkich w tym jednym małym pliku - tak jest czytelniej i bardziej estetycznie.
+
+## Twój pierwszy adres URL w Django!
+
+Czas utworzyć nasz pierwszy adres URL! Chcemy, aby adres 'http://127.0.0.1:8000/' był stroną główną naszego bloga i wyświetlał listę wpisów.
+
+Zależy nam również, aby zachować porządek w pliku `mysite/urls.py`, dlatego zaimportujemy URL-e z naszej aplikacji `blog` do głównego pliku `mysite/urls.py`.
+
+Śmiało, dodaj linię, która spowoduje zaimportowanie `blog.urls`. Będziesz musiała także zmienić pierwszy wiersz ` from django.urls...`, ponieważ użyjemy tutaj funkcji `include`, którą musimy najpierw zaimportować.
+
+Twój plik `mysite/urls.py` powinien teraz wyglądać tak:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django przekieruje wszystkie reguły z adresu 'http://127.0.0.1:8000/' do `blog.urls` i tam będzie szukał dalszych wskazówek.
+
+## blog.urls
+
+Stwórz nowy pusty plik o nazwie `urls.py` w katalogu `blog` i otwórz go w Twoim edytorze. Dokładnie tak! Dodaj te pierwsze dwie linie:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Tutaj importujemy funkcje `path` Django i wszystkie nasze widoki (`views`) z aplikacji `blog`. (Nie mamy jeszcze żadnych, ale do tego dojdziemy za chwilę!)
+
+Potem możemy dodać nasz pierwszy wzorzec adresu URL:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+Jak widzisz, teraz przyporządkowujemy widok (`view`) o nazwie `post_list` do strony głównej. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. Ten wzorzec będzie wskazówką dla Django, że `views.post_list` jest właściwym miejscem dla każdego, kto wejdzie na stronę poprzez adres 'http://127.0.0.1:8000/'.
+
+Ostatnia część, `name='post_list` jest nazwą URL, która będzie używana do zidentyfikowania widoku. Nazwa może być taka sama jak nazwa widoku albo kompletnie inna. W projekcie będziemy później używać nazw URL, więc ważne jest nazwanie każdego URL-a w aplikacji. Powinnyśmy również starać się używać nazw URL unikalnych i prostych do zapamiętania.
+
+Jeśli teraz spróbujesz odwiedzić stronę http://127.0.0.1:8000/, zobaczysz komunikat "niedostępna strona internetowa". Wynika to z faktu, że serwer (pamiętałaś o wpisaniu ` runserver`?) nie jest już uruchomiony. Spójrz na okno konsoli serwera, aby dowiedzieć się, dlaczego.
+
+![Błąd](images/error1.png)
+
+Twoja konsola pokazuje błąd, ale nie martw się - w rzeczywistości jest to całkiem użyteczne: mówi Ci, że** brak atrybutu 'post_list'**. To jest nazwa widoku (*view*), którą Django próbuje znaleźć i użyć, ale jeszcze go nie utworzyłyśmy. Na tym etapie Twój `/admin/ ` również nie będzie działać. Nie martw się, zajmiemy się tym. Jeżeli pojawiła Ci się wiadomość o innym błędzie, spróbuj zrestartować swój serwer. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/pl-PL/django_views/README.md b/pl-PL/django_views/README.md
new file mode 100644
index 00000000000..2a9733f8f51
--- /dev/null
+++ b/pl-PL/django_views/README.md
@@ -0,0 +1,44 @@
+# Widoki Django - czas zacząć tworzyć!
+
+Czas uporać się z błędem, który pozostawiłyśmy po poprzednim rozdziale! :)
+
+*Widok* jest miejscem, w którym umieszczamy "logikę" naszej aplikacji. Pobierze on informacje od modelu, który wcześniej utworzyłaś, a następnie przekaże je do szablonu (`template`). Nauczymy się tworzyć szablony w następnym rozdziale. Widoki to po prostu funkcje w Django, tylko nieco bardziej skomplikowane niż te, którymi zajmowałyśmy się w rozdziale **Wprowadzenie do Pythona**.
+
+Widoki (ang. views) są przechowywane w pliku `views.py`. Dodajmy *views* do naszego pliku `blog/views.py`.
+
+## blog/views.py
+
+OK, otwórzmy ten plik w naszym edytorze i zobaczmy, co siedzi w środku:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Nie ma tu jeszcze zbyt wiele rzeczy.
+
+Pamiętaj, że linie zaczynające się od `#` to komentarze - oznacza to, że te linie nie będą uruchamiane przez Pythona.
+
+Utwórzmy *view* zgodnie z sugestią komentarza. Najprostszy widok może wyglądać tak:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Jak widać, stworzyłyśmy funkcję (`def`) nazwaną `post_list`, która pobiera `request` i zwraca `return` wartość uzyskaną dzięki wywołaniu innej funkcji `render`, która wyrenderuje (złoży w całość) nasz szablon `blog/post_list.html`.
+
+Zapisz plik, przejdź do http://127.0.0.1:8000/ i zobacz co mamy.
+
+Znowu błąd! Przeczytaj, o co chodzi tym razem:
+
+![Błąd](images/error.png)
+
+Przynajmniej pokazuje, że serwer jest uruchomiony ponownie, ale nadal nie wygląda dobrze, prawda? Nie martw się, to po prostu błąd strony, nic strasznego! Podobnie jak komunikaty o błędach w konsoli, są one całkiem przydatne. Możesz przeczytać, że *TemplateDoesNotExist*. Naprawmy ten błąd i stwórzmy szablon - ale to już w następnym rozdziale!
+
+> Więcej na temat widoków Django dowiesz się czytając oficjalną dokumentację: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/pl-PL/dynamic_data_in_templates/README.md b/pl-PL/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..ab5aba11239
--- /dev/null
+++ b/pl-PL/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dane dynamiczne w szablonach Django
+
+Sporo rzeczy jest już na swoim miejscu: model `Post` jest zdefiniowany w `models.py`, w `views.py` mamy `post_list`, szablon też już gotowy. Ale jak to zrobić, aby nasze wpisy pojawiały się w szablonie HTML? Bo właśnie to chcemy zrobić - pobrać trochę treści (modele zapisane w bazie danych) i ładnie je wyświetlić w naszym szablonie, prawda?
+
+Dokładnie do tego przydadzą nam się *widoki*: do połączenia modeli i szablonów między sobą. W naszym widoku (*view*) `post_list` musimy pobrać modele do wyświetlenia i przekazać je do szablonu. W widoku *view* decydujemy, jaki (model) zostanie wyświetlony w szablonie.
+
+OK, więc jak to osiągniemy?
+
+Musimy otworzyć nasz plik `blog/views.py` w naszym edytorze kodu. Jak dotąd *widok* `post_list` wygląda następująco:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Pamiętasz, jak rozmawiałyśmy o dołączaniu kodu zapisanego w odrębnych plikach? Teraz jest moment, w którym musimy uwzględnić model, który napisałyśmy w `models.py`. Dodajmy wiersz `from .models import Post` w ten sposób:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+Kropka przed modelami `models` oznacza *bieżący katalog * lub *bieżącą aplikację*. `views.py` i `models.py` znajdują się w tym samym katalogu. Oznacza to, że możemy użyć `.` i nazwy pliku (bez `.py`). Następnie importujemy nazwę modelu (`Post`).
+
+Ale co dalej? Aby pobrać aktualne posty na blogu z modelu `Post`, potrzebujemy czegoś, co nazywa się `QuerySet`.
+
+## QuerySet
+
+Powinnaś być już zaznajomiona z zasadą działania obiektów typu QuerySet. Rozmawiałyśmy o tym w rozdziale [ORM Django (obiekty QuerySets)](../django_orm/README.md).
+
+Więc teraz chcemy opublikować posty na blogu posortowane według daty publikacji (`published_date`), prawda? Zrobiłyśmy to już w rozdziale QuerySets!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Teraz otwórz plik `blog/views.py` w edytorze kodu i umieść ten fragment kodu dodając go do funkcji `def post_list (request)`, ale nie zapomnij najpierw dodać `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Zauważ, że tworzymy *zmienną* dla naszego QuerySetu: `posts`. Potraktuj ją jako nazwę naszego QuerySetu. Od tej pory będziemy odnosić się do niej tylko za pomocą tej nazwy.
+
+W funkcji `render` mamy jeden parametr `request` (wszystko, co otrzymujemy od użytkownika za pośrednictwem Internetu) i inny podający plik szablonu (`'blog/post_list.html'`). Ostatni parametr, który wygląda tak: `{}` jest miejscem, w którym możemy dodać parę rzeczy do wykorzystania w szablonie. Musimy nadać im nazwy (ale póki co będziemy trzymać się nazwy `'posts'`). :) Powinno to wyglądać tak: `{'posts': posts}`. Zwróć uwagę, że ta część przed `:` jest stringiem; powinnaś wziąć ją w cudzysłów:`'`.
+
+Zatem ostatecznie nasz plik `blog/views.py` powinien wyglądać następująco:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+I to wszystko! Czas, żebyśmy wróciły do naszego szablonu i wyświetliły ten QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/pl-PL/extend_your_application/README.md b/pl-PL/extend_your_application/README.md
new file mode 100644
index 00000000000..a914d9d9661
--- /dev/null
+++ b/pl-PL/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Rozbudowa aplikacji
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Czas na odrobinę praktyki!
+
+Pierwszą rzeczą, której nasz blog potrzebuje, to strona wyświetlająca pojedynczy wpis, nieprawdaż?
+
+Mamy już model `Post`, więc nie musimy już dodawać niczego do `models.py`.
+
+## Tworzenie szablonu odnośnika do detali wpisu na blogu
+
+Zaczniemy od dodania linku wewnątrz pliku `blog/templates/blog/post_list.html`. Otwórz go w edytorze kodu. Do tej pory plik powinien wyglądać tak: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}Chcemy, aby tytuł wpisu był linkiem prowadzącym do strony ze szczegółami wpisu. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Czas wyjaśnić, co oznacza tajemnicze `{% url 'post_detail' pk=post.pk %}`. Jak można podejrzewać, zapis `{% %}` oznacza, że używamy tagów szablonu Django. Tym razem używamy takiego, który generuje dla nas adres URL!{% endraw %}
+
+Fragment `post_detail` oznacza, że Django będzie oczekiwał URL w `blog/urls.py` o nazwie name=post_detail
+
+A co z `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Teraz, gdy wejdziemy na adres http://127.0.0.1:8000/, ujrzymy błąd (co było do przewidzenia, bo nie mamy jeszcze ustawionego adresu URL ani widoku *view* dla `post_detail`). Będzie to wyglądać tak:
+
+![Błąd NoReverseMatch](images/no_reverse_match2.png)
+
+## Utwórzmy URL dla poszczególnego wpisu
+
+Dodajmy adres URL w pliku `urls.py` dla naszego *widoku (ang.view)* `post_detail`!
+
+Chcemy, aby nasz wpis i wszystkie informacje o nim, były widoczne pod tym adresem **URL**: http://127.0.0.1:8000/post/1/
+
+W pliku `blog/urls.py` stwórzmy adres URL wskazujący na *widok* o nazwie `post_detail`, który wyświetli nam cały wpis. Otwórz plik `blog/urls.py` w edytorze i dodaj wiersz: `path('post/<int:pk>/', views.post_detail, name='post_detail'),` tak, żeby otrzymać:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+Część `post/<int:pk>/` określa wzorzec URL - wytłumaczymy Tobie, co to jest:
+
+- `post/` oznacza, że adres URL powinien zaczynać się od słowa **post**, po którym nastąpi **/**. Jak na razie idzie dobrze.
+- `<int:pk>` - ta część jest trudniejsza. Oznacza ona, że Django spodziewa się liczby całkowitej i przekaże jej wartość do widoku jako zmienną `pk`.
+- `/` - i znów potrzebujemy **/**, zanim zakończymy wzorzec URL.
+
+To oznacza, że gdy wpiszesz w przeglądarce adres `http://127.0.0.1:8000/post/5/`, Django zrozumie, że potrzebujesz *widoku* zwanego `post_detail` i przekaże informację, że `pk` jest równe `5` temu *widokowi*.
+
+OK, dodałyśmy nowy wzorzec URL do `blog/urls.py`! Odświeżmy stronę: http://127.0.0.1:8000/ Boom! Serwer znów przestał działać. Spójrz w konsolę - jak oczekiwałyśmy, zdarzył się tam kolejny błąd!
+
+![AttributeError](images/attribute_error2.png)
+
+Pamiętasz, jaki jest następny krok? Dodanie widoku!
+
+## Dodajmy widok dla poszczególnego wpisu
+
+Tym razem nasz *widok* otrzymuje dodatkowy parametr `pk`. Nasz *widok* musi go "złapać", zgadza się? A więc zdefiniujmy funkcję tak: `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Teraz chcemy wyświetlić jeden i tylko jeden wpis na blogu. Aby to zrobić, możemy użyć querysetów w następujący sposób:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Ale ten kod ma problem. Jeśli nie istnieje żaden wpis (`Post`) z podanym `kluczem podstawowym` (`pk`), to otrzymamy przepaskudny błąd!
+
+![Błąd DoesNotExist](images/does_not_exist2.png)
+
+Tak nie może być! Ale Django ma dla nas coś, co rozwiąże ten problem za nas: `get_object_or_404`. W sytuacji, gdy nie istnieje żaden wpis (`Post`) z przekazaną wartością `pk`, wyświetli znacznie przyjemniejszą stronę zwaną `Page Not Found 404` albo stroną błędu 404 - informującą, że dana strona nie została znaleziona.
+
+![Nie znaleziono strony](images/404_2.png)
+
+Dobra wiadomość - możesz stworzyć własną stronę błędu 404 (`Page not found`) i upiększyć ją tak, jak tylko Ci się podoba. Ale teraz nie jest to super ważne, więc na razie pominiemy ten temat.
+
+OK, czas dodać nasz *widok* do naszego pliku `views.py`!
+
+W `blog/urls.py` stworzyłyśmy regułę URL, którą nazwałyśmy `post_detail` i która odnosi się do widoku `views.post_detail`. Oznacza to że Django będzie oczekiwało funkcji widoku o nazwie `post_detail` w pliku `blog/views.py`.
+
+Otwórzmy `blog/views.py` w edytorze kodu i dodajmy poniższy kod zaraz obok pozostałych wierszy `from`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+Oraz na końcu tego pliku dodać nasz *widok*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Tak, to czas na odświeżenie strony: http://127.0.0.1:8000/
+
+![Widok listy wpisów](images/post_list2.png)
+
+Działa! Ale co się stanie, gdy klikniesz na link w tytule wpisu?
+
+![Błąd TemplateDoesNotExist](images/template_does_not_exist2.png)
+
+O nie! Kolejny błąd! Ale wiemy już, jak sobie z nim poradzić, prawda? Musimy dodać szablon!
+
+## Stwórzmy szablon dla poszczególnego wpisu
+
+Stwórzmy teraz plik o nazwie `post_detail.html` w folderze `blog/templates/blog` i otwórzmy go w edytorze.
+
+Wprowadź następujący kod:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Po raz kolejny rozszerzamy `base.html`. W bloku `content` chcemy wyświetlić datę opublikowania wpisu (o ile istnieje), tytuł oraz treść. Ale powinnyśmy omówić kilka ważnych rzeczy, prawda?
+
+{% raw %}`{% if ... %} ... {% endif %}` jest tagiem szablonu, którego możemy użyć, gdy chcemy coś sprawdzić. (Pamiętasz `if ... else ..` z rozdziału **Wprowadzenie do Pythona**?) W tym wypadku chcemy sprawdzić czy `published_date` posta nie jest pusta.{% endraw %}
+
+OK, możemy teraz odświeżyć naszą stronę i sprawdzić, czy `TemplateDoesNotExist` już zniknął.
+
+![Strona ze szczegółami wpisu](images/post_detail2.png)
+
+Hura! Działa!
+
+# Czas na wdrożenie!
+
+Dobrze byłoby sprawdzić, czy Twoja strona dalej będzie dobrze działać na PythonAnywhere, prawda? Spróbuj ją ponownie wdrożyć.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Następnie w konsoli [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Pamiętaj, by podmienić `<your-pythonanywhere-domain>` na Twoją właściwą nazwę użytkownika PythonAnywhere, bez ostrych nawiasów).
+
+## Aktualizacja plików statycznych na serwerze
+
+Serwery takie jak PythonAnywhere lubią traktować "pliki statyczne" (takie jak pliki CSS) inaczej niż pliki Pythona, ponieważ dzięki temu mogą one je optymalizować, dzięki czemu strona ładuje się szybciej. W wyniku tego, ilekroć wprowadzamy zmiany do naszych plików CSS, musimy uruchomić dodatkowe polecenie na serwerze, by wiedział o konieczności ich aktualizacji. Komenda nazywa się `collectstatic`.
+
+Zacznij od aktywacji swojego virtualenva, jeżeli nie jest on jeszcze aktywny (PythonAnywhere używa polecenia `workon` w celu aktywacji, dokładnie tak jak komenda `source myenv/bin/activate`, której używasz na swoim komputerze):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+Komenda `manage.py collectstatic` jest trochę podobna do `manage.py migrate`. Wcześniej dokonałyśmy jakichś zmian w naszym kodzie, a teraz informujemy Django, by *zastosował* te zmiany, albo w kolekcji plików statycznych na serwerze albo w bazie danych.
+
+W każdym razie, jesteśmy już gotowe do przejścia na stronę ["Web"](https://www.pythonanywhere.com/web_app_setup/) (klikając w menu umieszczonym w prawym górnym rogu). Następnie kliknij **Reload** i spójrz na stronę https://subdomain.pythonanywhere.com, aby zobaczyć rezultat.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/pl-PL/how_the_internet_works/README.md b/pl-PL/how_the_internet_works/README.md
new file mode 100644
index 00000000000..6b8365b7a8e
--- /dev/null
+++ b/pl-PL/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Jak działa internet?
+
+> Dla czytelniczek w domu: ten rozdział jest również omówiony w wideo [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> Niniejszy rozdział został zainspirowany prelekcją "Jak działa internet" Jessiki McKellar (http://web.mit.edu/jesstess/www/).
+
+Możemy się założyć, że używasz go każdego dnia. Ale czy naprawdę wiesz, co się dzieje, gdy wpisujesz w przeglądarce adres https://djangogirls.org i wciskasz `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. Aczkolwiek strony internetowe różnią się od nich tym, że zawierają kod komputerowy zwany HTML.
+
+Jeśli do tej pory nie miałaś stycznoście z programowaniem, na początku może być Ci trudno zrozumieć czym jest HTML ale Twoje przeglądarki (takie jak Chrome, Safari, Firefox itp.) go uwielbiają. Zostały one zaprojektowane po to, by czytać ten kod, przetwarzać go i postępować zgodnie z jego instrukcjami. Prezentują pliki, z których składa się Twoja strona - by wyglądała dokładnie tak jak Ty chcesz.
+
+Tak jak w przypadku każdego innego pliku, musimy umiejscowić pliki HTML na dysku twardym. Do przechowywania plików HTML używamy specjalnych, potężnych komputerów zwanych *serwerami (ang. servers)*. Serwery nie posiadają monitorów, myszy ani klawiatur, ponieważ ich głownym celem jest przechowywanie danych i serwowanie ich. Dlatego są one nazywane *serwerami* -- ponieważ służą do *serwowania* danych.
+
+Ok, ale pewnie chciałabyś wiedzieć, jak wygląda internet?
+
+Narysowaliśmy Ci schemat Internetu! Wygląda tak:
+
+![Rysunek 1.1](images/internet_1.png)
+
+Wygląda dość chaotycznie, prawda? W rzeczywistości jest to sieć połączonych między sobą maszyn (wspomnianych wyżej *serwerów*). Setki tysięcy maszyn! Wiele, wiele kilometrów kabli na całym świecie! Możesz wejść na stronę Submarine Cable Map (http://submarinecablemap.com) i sama zobaczyć, jak skomplikowana jest ta sieć. Oto zrzut ekranu ze strony internetowej:
+
+![Rysunek 1.2](images/internet_3.png)
+
+To fascynujące, prawda? Ale niemożliwe jest stworzenie bezpośredniego połączenia kablowego między każdym komputerem w internecie. Więc aby dostać się do maszyny dostępnej w internecie (na przykład tej, na której zapisane jest https://djangogirls.org), potrzebujemy wykonać zapytanie przechodzące przez wiele, wiele różnych maszyn.
+
+Wygląda to tak:
+
+![Rysunek 1.3](images/internet_2.png)
+
+Wyobraź sobie, że po wpisaniu https://djangogirls.org, wysyłasz list o treści: "Drogie Django Girls, chcę zobaczyć stronę djangogirls.org. Wyślijcie ją do mnie, proszę! "
+
+List trafia do urzędu pocztowego najbliżej Ciebie. Potem idzie do drugiego urzędu, który znajduje się trochę bliżej Twojego adresata. Potem do kolejnego, kolejnego, kolejnego, aż w końcu zostanie doręczony do miejsca przeznaczenia. Ciekawa rzecz - jeśli wyślesz wiele listów (*pakietów danych*) do tego samego adresata, mogą przejść przez zupełnie inne urzędy pocztowe (*routery*). To zależy od tego w jaki sposób zostaną rozdzielone w każdym urzędzie.
+
+![Rysunek 1.4](images/internet_4.png)
+
+Właśnie tak to działa - wysyłasz wiadomości i oczekujesz jakiejś odpowiedzi. Zamiast papieru i długopisu używasz bitów danych, ale koncepcja jest dokładnie taka sama!
+
+Zamiast adresów z nazwą ulicy, miastem, kodem pocztowym oraz nazwą kraju, używa się adresów IP. Twój komputer najpierw pyta serwera DNS (system nazw domenowych, ang. DNS - Domain Name System) o przetłumaczenie djangogirls.org na adres IP. Działa to podobnie do dawnych książek telefonicznych, w których mogłaś poszukać adresu czy numeru po nazwisku osoby, z którą chciałaś się skontaktować.
+
+Listy muszą spełniać konkretne warunki, żeby zostały poprawnie doręczone: muszą posiadać adres, znaczek itd. Muszą być też napisane językiem zrozumiałym dla odbiorcy. To samo dotyczy *pakietów danych*, które wysyłasz, by zobaczyć jakąś stronę. Używany jest protokół HTTP (Hypertext Transfer Protocol).
+
+Tak więc, ogólnie rzecz ujmując, jeśli chcesz mieć swoją stronę internetową musisz mieć *serwer* (komputer), gdzie będzie ona funkcjonować. Gdy *serwer* odbiera przychodzące *żądania* (Twój list), wysyła Ci w odpowiedzi Twoją stronę (kolejny list).
+
+Zapytasz pewnie co robi Django, skoro masz przed sobą tutorial Django? Kiedy odpowiadasz na żądanie, nie chcesz, aby każdy dostawał tę samą odpowiedź, prawda? Zdecydowanie lepiej jest, jeśli listy są spersonalizowane i skierowane do konkretnej osoby, do tej, która napisała do Ciebie. Django pomaga Ci w tworzeniu tych spersonalizowanych, interesujących listów. :)
+
+Wystarczy teorii, zabieramy się za tworzenie!
\ No newline at end of file
diff --git a/pl-PL/html/README.md b/pl-PL/html/README.md
new file mode 100644
index 00000000000..8903b644729
--- /dev/null
+++ b/pl-PL/html/README.md
@@ -0,0 +1,227 @@
+# Wprowadzenie do HTML-a
+
+Zastanawiasz się, czym jest szablon?
+
+Szablon to plik, którego używamy do prezentacji informacji w zwięzłej formie. Używając analogii - do pisania listów również możesz użyć szablonu. Każdy list ma inną treść i adres, ale każdy z nich ma taką samą strukturę.
+
+Format szablonów Django wykorzystuje język HTML (ten sam, o którym wspominaliśmy w rozdziale **Jak działa internet**).
+
+## Co to jest HTML?
+
+HTML to prosty kod interpretowany przez Twoją przeglarkę - taką jak Chrome, Firefox czy Safari - w celu wyświetlenia strony dla użytkownika.
+
+HTML to skrót od "HyperText Markup Language". **HyperText** oznacza, że jest to tekst, który wspiera hyperlinki - czyli po prostu linki między stronami. **Markup** oznacza, że używamy tego kodu w dokumencie, żeby przekazać komuś informacje (w naszym przypadku przeglądarce), jak zinterpretować daną stronę. Kod HTML składa się ze **znaczników ** (tagów), a każdy z nich zaczyna się od `<` i kończy na`>`. Za pomocą znaczników oznaczamy **elementy**.
+
+## Twój pierwszy szablon!
+
+Stworzenie szablonu oznacza stworzenie pliku z szablonem. Bo przecież wszystko jest plikiem, zgadza się? Zapewne zdążyłaś to zauważyć.
+
+Szablony są zapisywane w katalogu `blog/templates/blog`. Zacznij więc od stworzenia katalogu `templates` wewnątrz Twojego katalogu bloga. Następnie stwórz kolejny katalog o nazwie `blog` wewnątrz katalogu na szablony:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(Być może zastanawiasz się, dlaczego tworzymy dwa katalogi o nazwie `blog` - jak się niebawem dowiesz, to użyteczna konwencja nazewnictwa. Ułatwia życie, gdy sprawy stają się bardziej skomplikowane.)
+
+A teraz stwórz plik `post_list.html` (na razie niech będzie pusty) wewnątrz katalogu `blog/templates/blog`.
+
+Popatrz, jak Twoja strona wygląda teraz: http://127.0.0.1:8000/
+
+> Jeżeli nadal otrzymujesz błąd `TemplateDoesNotExist`, spróbuj uruchomić serwer ponownie. Przejdź do wiersza polecenia, zatrzymaj serwer wciskając Ctrl+C (klawisze Control i C równocześnie), a następnie uruchom go jeszcze raz poleceniem `python manage.py runserver`.
+
+![Rysunek 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Otwórz Twój nowy plik w edytorze kodu i dodaj poniższe:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+I jak twoja strona wygląda teraz? Odwiedź stronę http://127.0.0.1:8000/, żeby się dowiedzieć.
+
+![Rysunek 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head i body
+
+Każda strona HTML jest podzielona na dwie części: **head** i **body**.
+
+* **head** jest elementem zawierającym informacje o dokumencie, które nie są wyświetlane na ekranie.
+
+* **body** zawiera wszystkie pozostałe elementy, które są częścią strony internetowej widoczną na ekranie.
+
+Używamy znacznika `<head>`, aby poinformować przeglądarkę o konfiguracji strony oraz `<body>` do przekazania informacji o tym, co właściwie znajduje się na stronie.
+
+Przykładowo, element tytułu strony możesz umieścić wewnątrz `<head>`, o tak:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Zapisz plik i odśwież swoją stronę.
+
+![Rysunek 11.3](images/step4.png)
+
+Zauważyłaś, że przeglądarka zrozumiała, że "Ola's blog" jest tytułem Twojej strony? Zinterpretowała ona `<title>Ola's blog</title>` i umieściła tekst w pasku tytułu twojej przeglądarki (będzie on również używany m.in. w zakładkach).
+
+Zapewne zauważyłaś także, że każdy znacznik otwierający posiada *znacznik zamykający*, z `/`, a także to, że elementy są *zagnieżdżane * (czyli nie możesz zamknąć danego znacznika zanim nie zostaną zamknięte znaczniki znajdujące się wewnątrz niego).
+
+To trochę jak wkładanie rzeczy do pudełek. Masz jedno wielkie pudło, `<html></html>`; wewnątrz niego znajduje się `<body></body>`, a w środku tegoż są kolejne mniejsze pudełka: `<p></p>`.
+
+Musisz przestrzegać zasad *zamykania* znaczników i *zagnieżdżania* elementów - przeciwnym razie przeglądarka może mieć problem z ich poprawnym zinterpretowaniem i Twoja strona będzie wyświetlać się niepoprawnie.
+
+## Dostosowywanie szablonu
+
+Teraz nieco się pobawmy i spróbujmy dostosować nasz szablon! Oto kilka znaczników, które nam się do tego przydadzą:
+
+* `<h1>Tytuł</h1>` dla twojego najbardziej znaczącego nagłówka
+* `<h2>Podtytuł</h2>` dla nagłówka niższego poziomu
+* `<h3>pod-podtytuł</h3>` … i tak dalej aż do `<h6>`
+* `<p>akapit tekstu</p>`
+* `<em>tekst</em>` dodaje wyróżnienie twojego tekstu
+* `<strong>text</strong>` jeszcze mocniej wyróżnia twój tekst
+* `<br>` to przejście do nowej linii (wewnątrz br nie wstawiamy niczego i nie ma też znacznika zamykającego)
+* `<a href="https://djangogirls.org">link</a>` tworzy link
+* `<ul><li>pierwsza pozycja</li><li>druga pozycja</li></ul>` tworzy listę, taką samą jak ta!
+* `<div></div>` tworzy sekcję na stronie
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Tutaj możesz zobaczyć przykład pełnego szablonu, skopiuj i wklej go do `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Daje nam to taki efekt:
+
+![Rysunek 11.4](images/step6.png)
+
+Hura! Ale jak do tej pory, nasz szablon wyświetla dokładnie **tę samą treść**. Tymczasem wspominałyśmy wcześniej, że szablony umożliwiają nam wyświetlenie **różnych** treści w **takim samym formacie**.
+
+Chcemy wyświetlić prawdziwe wpisy dodane w naszym panelu admina Django - i tym się teraz zajmiemy.
+
+## Jeszcze jedna rzecz: wdrożenie na serwer!
+
+Byłoby fajnie, gdybyśmy mogli to wszystko zobaczyć "na żywo" w Internecie, a nie tylko u siebie w komputerze. Czas na wdrożenie na serwer PythonAnywhere:
+
+### Zapisz zmiany w historii i wrzuć swój kod na GitHuba
+
+Po pierwsze, zobaczmy, jakie pliki zostały zmienione od ostatniej aktualizacji (wpisz następujące polecenie lokalnie w wierszu polecenia, nie na PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Upewnij się, że jesteś w folderze `djangogirls` i powiedz `git`owi aby dodał wszystkie zmiany z aktualnego folderu:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Zanim prześlemy wszystkie pliki, sprawdźmy, co faktycznie `git` zamierza przesłać (wszystkie pliki, które `git` prześle do repozytorium, powinny być zaznaczone na zielono):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Już blisko do końca. Teraz czas poprosić gita, aby zapisał te zmiany w historii. Dodamy za moment informację o zmianach (ang. "commit message"), gdzie opiszemy, co zostało zmienione. Możesz w tym miejscu wpisać cokolwiek zechcesz, ale warto jednak wpisać kilka słów opisujących, co robiłaś. W ten sposób łatwiej Ci będzie w przyszłości przypomnieć sobie, czego dotyczyły zapisane zmiany.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Zmieniony kod HTML na stronie."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Jak już wszystko to zrobimy, możemy wysłać (push) nasze zmiany na Githuba:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Prześlij nową wersję kodu do PythonAnywhere i ponownie załaduj swoją stronę
+
+* Otwórz [stronę konsoli na PythonAnywhere](https://www.pythonanywhere.com/consoles/) i przejdź do swojej **Bash console** (czyli po polsku "konsoli Bash") albo otwórz nową. Wpisz do niej:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+Pamiętaj by podmienić `<your-pythonanywhere-domain>` na Twoją właściwą nazwę użytkownika PythonAnywhere, bez ostrych nawiasów. Twoja nazwa poddomeny jest zwykle Twoją nazwą użytkownika PythonAnywhere, ale w niektórych przypadkach może być nieco inna (np. jeśli Twoja nazwa użytkownika zawiera wielkie litery). Więc jeśli to polecenie nie działa, należy użyć polecenia `ls` (lista plików), aby znaleźć rzeczywistą subdomenę/nazwę folderu, a następnie `cd`, aby tam przejść.
+
+Widzisz, jak ściąga się Twój kod. Jeśli chcesz sprawdzić, czy zmiany zostały ściągnięte, możesz przejść do strony **"Files"** i sprawdzić swój kod na PythonAnywhere (możesz przejść do innych stron na PythonAnywhere korzystając z menu na stronie konsoli).
+
+* Na koniec przejdź do strony ["Web"](https://www.pythonanywhere.com/web_app_setup/) i naciśnij **Reload**.
+
+I to powinno wystarczyć! Możesz śmiało odświeżyć swoją stronę w przeglądarce! Zmiany powinny być widoczne. :)
\ No newline at end of file
diff --git a/pl-PL/installation/README.md b/pl-PL/installation/README.md
new file mode 100644
index 00000000000..5edda72226c
--- /dev/null
+++ b/pl-PL/installation/README.md
@@ -0,0 +1,68 @@
+# Jeśli robisz ten kurs w domu
+
+Jeśli robisz ten kurs w domu, a nie w trakcie jednego z [warsztatów Django Girls](https://djangogirls.org/events/), możesz pominąć ten rozdział i przejść od razu do [Jak działa internet?](../how_the_internet_works/README.md).
+
+Dzieje się tak, ponieważ zajmujemy się instalowaniem rzeczy, które są potrzebne w tutorialu - jest to tylko dodatkowa strona, która gromadzi wszystkie instrukcje dotyczące instalacji w jednym miejscu (co jest przydatne w niektórych formach warsztatów). Jeśli chcesz, możesz teraz zainstalować wszystko, co jest na tej stronie. Ale jeśli wolisz zacząć naukę już teraz bez instalowania kilku nowych rzeczy na swoim komputerze, pomiń ten rozdział. Wszystko wytłumaczymy później, kiedy będzie to potrzebne.
+
+Powodzenia!
+
+# Jeśli uczestniczysz w warsztatach:
+
+Jeśli uczestniczysz w wydarzeniu Django Girls:
+
+* Twój warsztat może mieć "część instalacyjną" przed głównym warsztatem. Jeśli jesteś w części instalacyjnej, to ta strona jest dla Ciebie! Postępuj zgodnie z instrukcjami, aby uzyskać wszystko, czego potrzebujesz do warsztatów. W razie potrzeby poproś o pomoc mentorów. Na warsztatach będziesz mogła pominąć tutoriale instalacji, które już wykonałaś.
+* Organizatorzy warsztatów mogą Cię prosić, abyś w domu spróbowała zainstalować wszystkie potrzebne rzeczy na komputerze przed rozpoczęciem warsztatów. Jeśli zostałaś poproszona, aby to zrobić, ta strona jest dla Ciebie! Postępuj zgodnie z instrukcjami umieszczonymi tutaj, najlepiej jak potrafisz! Następnie, podczas głównego warsztatu, gdy dojdziesz do etapu instalacji w głównym samouczku, jeśli nie możesz go zainstalować, możesz uzyskać pomoc od swojego mentora.
+* Jeśli na Twoich warsztatach nie ma części instalacyjnej (lub nie mogłaś wziąć w niej udziału) i jeśli organizatorzy nie prosili Cię o zainstalowanie wszystkiego przed Twoim przyjazdem, pomiń tę stronę i przejdź bezpośrednio do rozdziału [ Jak działa internet?](../how_the_internet_works/README.md). Podczas pracy nad tutorialem będziesz instalować wszystko, czego potrzebujesz.
+
+# Instalacja
+
+Na tych warsztatach będziesz budować blog. W tym celu, podczas przechodzenia przez tutorial, zostaniesz poinstruowana, jak zainstalować na Twoim komputerze różnego rodzaju oprogramowanie i jak skonfigurować kilka kont online, które będą Ci potrzebne. Ta strona zbiera wszystkie instrukcje dotyczące instalacji i rejestracji w jednym miejscu (co jest przydatne w niektórych formach warsztatów).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Wiele z poniższych kroków odnosi się do "konsoli", "terminala", "wiersza poleceń" lub "linii poleceń" - wszystkie one oznaczają to samo: okno na komputerze, w którym można wprowadzać polecenia. Gdy dojdziesz do głównego tutoriala, dowiesz się więcej o wierszu polecenia. Na razie najważniejszą rzeczą jaką musisz wiedzieć to to, jak otworzyć okno wiersza polecenia i jak ono wygląda: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %} 
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Przejdź do strony [ GitHub.com ](https://www.github.com) i zarejestruj nowe, bezpłatne konto użytkownika. Pamiętaj, aby zapamiętać swoje hasło (dodaj je do swojego menedżera haseł, jeśli go używasz).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Zacznij czytać
+
+Gratulacje, jesteś gotowa, by zacząć pracę! Jeśli masz trochę czasu przed warsztatami, możesz przeczytać początkowe rozdziały:
+
+* [Jak działa internet?](../how_the_internet_works/README.md)
+
+* [Wprowadzenie do wiersza polecenia](../intro_to_command_line/README.md)
+
+* [Wprowadzenie do Pythona](../python_introduction/README.md)
+
+* [Czym jest Django?](../django/README.md)
+
+# Ciesz się warsztatami!
+
+Kiedy zaczniesz warsztaty, będziesz mogła przejść od razu do rozdziału [Twój pierwszy projekt w Django!](../django_start_project/README.md), ponieważ już przebrnęłaś przez materiał z wcześniejszych rozdziałów.
\ No newline at end of file
diff --git a/pl-PL/intro_to_command_line/README.md b/pl-PL/intro_to_command_line/README.md
new file mode 100644
index 00000000000..2e65f6a3bb8
--- /dev/null
+++ b/pl-PL/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Wprowadzenie do interfejsu wiersza polecenia
+
+> Dla czytelniczek w domu: ten rozdział jest również omówiony w wideo [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+Za chwilę napiszesz swoją pierwszą linijkę kodu. Jesteś już podekscytowana? :)
+
+**Pozwól, że przedstawimy Ci, Twojego pierwszego przyjaciela: wiersz polecenia!**
+
+Następujące kroki pokażą Ci, jak wykorzystać tajemnicze czarne okno, którego używają wszyscy hakerzy. Na początku może to wyglądać nieco przerażająco ale tak naprawdę to tylko zachęta do wpisywania komend.
+
+> **Uwaga** Podczas tego kursu będziemy używać terminów "katalog" i "folder" zamiennie, ponieważ oznaczają one tę samą rzecz.
+
+## Czym jest wiersz polecenia?
+
+Okno zwane **wierszem polecenia** lub **interfejsem wiersza polecenia** jest aplikacją tekstową służącą do przeglądania, obsługi i operowania plikami na Twoim komputerze. Podobnie jak np. Eksplorator Windows lub Finder na Macu, ale bez interfejsu graficznego. Inne nazwy dla wiersza polecenia to *cmd*, *CLI*, *prompt*, *konsola* lub *terminal*.
+
+## Uruchamiamy interfejs wiersza polecenia
+
+Aby zacząć nasze eksperymenty, musimy najpierw otworzyć nasz wiersz polecenia.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Znak zachęty
+
+Teraz powinnaś zobaczyć białe lub czarne okno, które czeka na Twoje polecenia.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Jeżeli używasz Maca lub Linuksa, powinnaś zobaczyć `$`, tak jak poniżej:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+W systemie Windows ujrzysz znak `>`, o tak:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Spójrz na powyższą sekcję Linux -- Zobaczysz coś więcej, gdy dojdziesz do dalszej części tutoriala.
+
+<!--endsec-->
+
+Każda komenda będzie poprzedzona przez `$` lub `>` i jedną spację, czego nie powinnaś wpisywać. Twój komputer zrobi to za Ciebie. :)
+
+> Jedna mała uwaga: w Twoim przypadku prompt może być poprzedzony czymś jeszcze, np. `C:\Users\ola>` lub `Olas-MacBook-Air:~ ola$` i jest to w 100% poprawne.
+
+Część do znaku `$` lub `>` razem z nim nazywana jest *znakiem zachęty wiersza polecenia* lub skrótowo *znakiem zachęty (promptem)*. Jego celem jest zachęcić Ciebie do wpisania jakiegoś polecenia.
+
+W tutorialu, jeżeli będziemy chciały, byś wpisała komendę, umieścimy przed nią również `$` lub `>`, a czasami nawet resztę znaku zachęty. Możesz śmiało zignorować lewą część i wpisać komendę zaczynającą się za promptem.
+
+## Twoja pierwsza komenda! 
+
+Zacznijmy od wpisania następującego polecenia:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+A następnie wciśnij `enter`. Oto rezultat:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+Jak widzisz, komputer właśnie wyświetlił Twoją nazwę użytkownika. Prawda, że sprytne? :)
+
+> Staraj się zawsze przepisywać polecenia zamiast je kopiować i wklejać. W ten sposób zapamiętasz więcej!
+
+## Podstawy
+
+Każdy system operacyjny ma nieco inny zestaw komend dostępnych w wierszu polecenia, zatem postępuj według instrukcji odpowiadających Twojemu systemowi operacyjnemu. To co, spróbujemy?
+
+### Bieżący katalog
+
+Miło byłoby dowiedzieć się, gdzie teraz jesteśmy, co? No to sprawdźmy. Wpisz poniższe polecenie i wciśnij `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Uwaga: 'pwd' pochodzi od angielskiego skrótu 'print working directory', czyli wyświetl katalog roboczy - ten, w którym się aktualnie znajdujemy.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+Prawdopodobnie ujrzysz coś podobnego na swoim komputerze. Kiedy otwierasz wiersz polecenia, zwykle jest on uruchamiany w folderze głównym Twojego konta użytkownika.
+
+* * *
+
+### Dowiedz się więcej o komendach
+
+Wiele poleceń, które można wpisać w wierszu polecenia ma wbudowane funkcje pomocy, które można wyświetlić i przeczytać! Na przykład, aby dowiedzieć się więcej na temat polecenia cd:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X i Linux posiada polecenie `man`, które wyświetla Ci pomoc dla danego polecenia. Spróbuj `man pwd` i zobacz, co mówi lub umieścić `man` przed innim poleceniem, aby zobaczyć jego pomoc. Wynikiem `man` jest normalna strona. Użyj spacji, aby przejść do następnej strony i `q`, aby zakończyć.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Dodawanie przyrostka`/?` do większości poleceń powoduje, że zostają wyświetlone strony pomocy. Konieczne może być przewinięcie okna polecenia, aby zobaczyć wszystkie informacje. Spróbuj `cd /?`.
+
+<!--endsec-->
+
+### Lista plików i folderów
+
+Co znajduje się w środku? Fajnie byłoby się tego dowiedzieć. Sprawdźmy:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Zmiana katalogu bieżącego
+
+Przejdźmy teraz do naszego folderu Pulpit:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Zapamiętaj, że katalog "Desktop" może być przetłumaczony na język Twojego systemu Linux. W takim przypadku, musisz wymienić `Desktop` na przetłumaczoną nazwę; na przykład dla niemieckiego tłumaczenia `Schreibtisch`.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Sprawdźmy, czy coś się faktycznie zmieniło:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Tak, to tutaj!
+
+> PRO tip: gdy wpiszesz `cd D` i wciśniesz przycisk `Tab` na klawiaturze, wiersz polecenia automatycznie uzupełni resztę nazwy, dzięki czemu będziesz mogła nawigować szybciej. Jeżeli istnieje więcej niż jeden folder o nazwie zaczynającej się na "D", wciśnij `Tab` dwukrotnie, aby wyświetlić listę możliwości.
+
+* * *
+
+### Tworzenie folderu
+
+Co powiesz na stworzenie folderu "cwiczenie" na swoim pulpicie? Zrób to w ten sposób:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir cwiczenie
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir cwiczenie
+    
+
+<!--endsec-->
+
+To niepozorne polecenie doda do Twojego pulpitu folder o nazwie `cwiczenie`. Możesz sprawdzić, czy na pewno został tam dodany - spójrz na swój pulpit albo uruchom polecenie `ls` lub `dir`! Spróbuj. :)
+
+> PRO tip: Jeżeli nie chcesz w kółko wpisywać tych samych poleceń, wciśnij na klawiaturze klawisz ze `strzałką w górę` i `strzałką w dół` aby przewinąć listę poprzednio użytych poleceń.
+
+* * *
+
+### Ćwiczenie!
+
+Małe wyzwanie dla Ciebie: wewnątrz świeżo utworzonego katalogu `cwiczenie` stwórz katalog o nazwie `test`. Użyj poleceń `cd` i `mkdir`
+
+#### Rozwiązanie:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd excercise
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Gratulacje! :)
+
+* * *
+
+### Sprzątanie
+
+Nie chcemy zostawić bałaganu, a zatem wyrzućmy wszystko, co do tej pory zrobiłyśmy.
+
+Najpierw musimy wrócić do Pulpitu:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Wykonanie `cd` wraz z `..` przeniesie Cię do katalogu nadrzędnego (czyli tego, w którym znajduje się Twój aktualny katalog).
+
+Sprawdź, gdzie jesteś:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Teraz czas usunąć katalog `cwiczenie`:
+
+> **Uwaga**: Usuwanie plików za pomocą `del`, `rmdir` lub `rm` jest nieodwracalne. To znaczy, że *Twoje pliki zostaną bezpowrotnie utracone*! Tak więc bądź ostrożna z tymi poleceniami.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r cwiczenie
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S cwiczenie
+    cwiczenie, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Gotowe! Dla pewności, że został on naprawdę usunięty, sprawdźmy to:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Wyjście
+
+To na razie tyle! Możesz teraz spokojnie zamknąć wiersz polecenia. To co, zrobimy to jak prawdziwy haker? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Fajnie, nie? :)
+
+## Podsumowanie
+
+Oto podsumowanie przydatnych poleceń:
+
+| Polecenie (Windows) | Polecenie (Mac OS / Linux) | Opis                                | Przykład                                            |
+| ------------------- | -------------------------- | ----------------------------------- | --------------------------------------------------- |
+| wyjście             | wyjście                    | zamknięcie okna                     | **wyjście**                                         |
+| cd                  | cd                         | zmiana katalogu                     | **cd test**                                         |
+| cd                  | pwd                        | pokazywane bieżącego katalogu       | **cd** (Windows) lub **pwd** (Mac OS / Linux)       |
+| dir                 | ls                         | lista katalogów/plików              | **dir**                                             |
+| copy                | cp                         | kopiowanie pliku                    | **copy c:\test\test.txt c:\windows\test.txt**   |
+| move                | mv                         | przenoszenie pliku                  | **move c:\test\test.txt c:\windows\test.txt**   |
+| mkdir               | mkdir                      | tworzenie nowego katalogu           | **mkdir testdirectory**                             |
+| rmdir (lub del)     | rm                         | usuwanie pliku                      | **del c:\test\test.txt**                          |
+| rmdir /S            | rm -r                      | usuwanie katalogu                   | **rm -r testdirectory**                             |
+| [CMD] /?            | man [CMD]                  | uzyskiwanie pomocy na temat komendy | **cd /?** (Windows) lub **man cd** (Mac OS / Linux) |
+
+To tylko garstka wszystkich poleceń, z których możesz skorzystać w wierszu polecenia, ale dzisiaj nie będziesz potrzebowała niczego więcej.
+
+Jeżeli temat Cię zainteresował, to [ss64.com](http://ss64.com) zawiera kompletny spis poleceń dla wszystkich systemów operacyjnych.
+
+## Gotowa?
+
+No to poznajmy Pythona!
\ No newline at end of file
diff --git a/pl-PL/intro_to_command_line/open_instructions.md b/pl-PL/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..09ef06f8fa7
--- /dev/null
+++ b/pl-PL/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+W zależności od wersji systemu Windows i klawiatury, jedna z poniższych instrukcji powinna otworzyć okno poleceń (być może trzeba trochę poeksperymentować, ale nie musisz wypróbowywać wszystkich tych sugestii):
+
+- Przejdź do menu Start lub ekranu i wpisz "Command Prompt" w polu wyszukiwania.
+- Idź do Start menu → Windows System → Command Prompt.
+- Idź do Start menu → All Programs → Accessories → Command Prompt.
+- Idź do początkowego ekranu, najedź myszą w lewym dolnym rogu ekranu i kliknij strzałkę w dół, która się pojawi (na ekranie dotykowym przesuń palcem od dołu ekranu). Strona aplikacji powinna się otworzyć. Kliknij w Command Prompt (wiersz polecenia) w sekcji System Windows.
+- Przytrzymaj specjalny klawisz Windows na klawiaturze i naciśnij klawisz "X". Wybierz "Command Prompt" (wiersz poleceń) z wyskakującego menu.
+- Przytrzymaj klawisz Windows i naciśnij klawisz "R", aby uzyskać okno "Run"('Uruchom"). Wpisz "cmd" w polu i kliknij przycisk OK.
+
+![Wpisz "cmd" w oknie "Uruchom""](../python_installation/images/windows-plus-r.png)
+
+W dalszej części tego tutoriala konieczne będzie otwarcie dwóch okien poleceń jednocześnie. Jednak w niektórych wersjach systemu Windows, jeśli masz już otwarte jedno okno poleceń i spróbujesz otworzyć drugie przy użyciu tej samej metody, zamiast tego wyświetli Ci się okno poleceń, które otworzyłaś jako pierwsze. Spróbuj teraz na swoim komputerze i zobacz, co się stanie! Jeśli masz tylko jedno okno poleceń, wypróbuj jedną z innych metod z powyższej listy. Przynajmniej jedna z nich powinna spowodować otwarcie nowego okna poleceń.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Przejdź do Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Prawdopodobnie jest to w Applications → Accessories → Terminal, or Applications → System → Terminal, ale może to zależeć od systemu. Jeśli tego tu nie ma, możesz spróbować z wyszukiwarką Google. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/pl-PL/python_installation/README.md b/pl-PL/python_installation/README.md
new file mode 100644
index 00000000000..6571b2b69c1
--- /dev/null
+++ b/pl-PL/python_installation/README.md
@@ -0,0 +1,15 @@
+# Poznajmy Pythona
+
+Nareszcie tutaj!
+
+Ale najpierw porozmawiajmy o tym, czym jest Python. Python jest niezwykle popularnym językiem programowania, który może służyć do tworzenia stron internetowych, gier, oprogramowania naukowego, grafiki i wielu, wielu innych rzeczy.
+
+Początki Pythona sięgają późnych lat 80., a jego głównym założeniem jest czytelność, dzięki której kod jest łatwy do zrozumienia przez ludzi (a nie tylko przez komputery!). Właśnie z tego powodu wygląda on prościej niż inne języki programowania, ale nie martw się - Python jest jednocześnie naprawdę potężny!
+
+# Instalowanie Pythona
+
+> **Uwaga** Jeśli używasz już Chromebook, pomiń ten rozdział i upewnij się, że postąpiłeś zgodnie z instrukcją [Instalowanie Chromebook](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/pl-PL/python_installation/instructions.md b/pl-PL/python_installation/instructions.md
new file mode 100644
index 00000000000..7dfee75d248
--- /dev/null
+++ b/pl-PL/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Dla czytelniczek w domu: ten rozdział jest również omówiony w wideo [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> Niniejszy podrozdział powstał w oparciu o kurs Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Framework Django został napisany w Pythonie. Potrzebujemy Pythona, żeby móc zrobić cokolwiek w Django. Zacznijmy zatem od zainstalowania go! Chcemy zainstalować Pythona 3.6, więc jeżeli posiadasz jakąkolwiek wcześniejszą wersję, będziesz musiała ją uaktualnić. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Najpierw sprawdź, czy na komputerze działa 32- lub 64-bitowa wersja systemu Windows, w linijce "Typ systemu" w oknie o informacjach o systemie. Aby przejść do tego okna, wypróbuj jedną z następujących metod:
+
+* Wciśnij klawisz Windows i klawisz Pause/Break w tym samym czasie
+* Otwórz panel sterowania z menu systemu Windows, a następnie przejdź do Zabezpieczenia Systemu, a następnie System
+* Wciśnij przycisk Windows, a następnie przejdź do Settings>System>About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+Możesz ściągnąć Pythona dla Windowsa ze strony https://www.python.org/downloads/windows/. Kliknij w link "Latest Python 3 Release - Python x.x.x". Jeżeli twój komputer pracuje na **64-bitowej** wersji Windowsa, ściągnij **Windows x86-64 executable installer**. W innym wypadku ściągnij **Windows x86 executable installer**. Po ściągnięciu instalatora, powinnaś go uruchomić (klikając dwukrotnie w niego) i postępować według wyświetlanych instrukcji.
+
+Jedna rzecz, na którą trzeba uważać: podczas instalacji zauważysz okno zaznaczone jako "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Nie zapomnij dodać Pythona do ścieżki systemowej (ang. Path)](../python_installation/images/python-installation-options.png)
+
+Kiedy instalacja się zakończy, możesz zobaczyć okienko dialogowe z linkiem, który możesz śledzić, aby dowiedzieć się więcej o Pythonie lub wersji, którą zainstalowałaś. Zamknij lub anuluj to okienko - nauczysz się więcej w tym tutorialu!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Pobierz plik o nazwie *Mac OS X 64-bit/32-bit installer*,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/pl-PL/python_introduction/README.md b/pl-PL/python_introduction/README.md
new file mode 100644
index 00000000000..f6730a22e3d
--- /dev/null
+++ b/pl-PL/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Wprowadzenie do Pythona
+
+> Fragmenty tego rozdziału oparte są na tutorialu Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Napiszmy jakiś kod!
+
+## Wiersz polecenia Pythona
+
+> Dla czytelniczek w domu: tę część uwzględnia wideo [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U).
+
+Aby rozpocząć zabawę z Pythonem, musisz otworzyć jego *wiersz polecenia* na swoim komputerze. Powinnaś już wiedzieć, jak to zrobić - nauczyłyśmy się tego w rozdziale [Wprowadzenie do interfejsu wiersza polecenia](../intro_to_command_line/README.md).
+
+Gdy już będziesz gotowa, postępuj według instrukcji poniżej.
+
+Chcemy otworzyć konsolę Pythona. Wpisz `python`, jeśli pracujesz na Windowsie, lub `python3`, jeśli pracujesz na MacOS/Linuxie i wciśnij `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Twoje pierwsze polecenie w Pythonie!
+
+Po uruchomieniu Pythona wiersz polecenia wygląda tak: `>>>`. Jest to sygnał dla nas, że od tego momentu możemy używać wyłącznie instrukcji języka Python. Nie musisz wpisywać `>>>` - Python zrobi to za Ciebie.
+
+Jeśli w którymkolwiek momencie zechcesz wyjść z konsoli Pythona, wpisz polecenie `exit()` albo użyj kombinacji klawiszy `Ctrl + Z` w Windows lub `Ctrl + D` w Macu/Linuksie. Wtedy już nie będziesz więcej widzieć `>>>`.
+
+Teraz jeszcze nie chcemy wyjść z konsoli Pythona. Chcemy się jeszcze kilku rzeczy nauczyć. Zacznijmy od wpisania działania matematycznego, np. `2 + 3` i naciśnięcia `entera`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nieźle! Widzisz, jak pojawiła się odpowiedź? Python zna się na matematyce! Powinnaś spróbować innych działań, np.:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+By wykonać potęgowanie, powiedzmy podnieść 2 do potęgi 3, musimy wpisać: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Pobaw się tym przez chwilę, a potem wróć tutaj. :)
+
+Jak widzisz, Python jest świetnym kalkulatorem. Jeżeli zastanawiasz się, co możesz z nim jeszcze zrobić…
+
+## Tekstowy typ danych (string)
+
+A jakby tak wpisać swoje własne imię? Wpisz swoje imię używając cudzysłowów, w ten sposób:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+Właśnie stworzyłaś swój pierwszy string! Jest to ciąg znaków, który może być przetwarzany przez komputer. String musi zawsze zaczynać się i kończyć tym samym znakiem. Może to być apostrof (`'`) lub cudzysłów (`"`) - nie ma różnicy! Sygnalizują one Pythonowi, że wszystko, co znajduje się pomiędzy nimi, jest stringiem.
+
+Stringi mogą być łączone. Spróbuj tak:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Czesc " + "Ola"
+'Czesc Ola'
+```
+
+Da się również mnożyć stringi za pomocą liczb:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Jeśli chciałabyś użyć apostrofu wewnątrz stringu, możesz to zrobić na dwa sposoby.
+
+Za pomocą cudzysłowu:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+lub poprzedzając apostrof odwróconym ukośnikiem (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Fajnie, co? Możesz także wyświetlić swoje imię wielkimi literami. Wpisz:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Właśnie użyłaś **metody** `upper` na swoim stringu! Metoda (jak `upper()`) to sekwencja instrukcji, które Python wykonuje na podanym obiekcie (`"Ola"`) jak tylko ją wywołasz.
+
+Jeżeli chcesz poznać liczbę liter, którą zawiera twoje imię, istnieje **funkcja** również do tego!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Zastanawiasz się, dlaczego czasami wywołujemy funkcję z `.` na końcu stringu (jak tutaj: `"Ola".upper()`), a czasami najpierw wywołujemy funkcję, a dopiero potem umieszczamy string w nawiasach? Ano, w niektórych przypadkach funkcje są związane z obiektami. Tak jak `upper()`, która może być użyta wyłącznie na stringach. Taką funkcję nazywamy wówczas **metodą**. Są również funkcje, które nie są powiązane z niczym konkretnym i mogą być używane na różnych typach obiektów, jak na przykład `len()`. Dlatego przekazujemy `"Ola"` jako parametr dla funkcji `len`.
+
+### Podsumowanie
+
+OK, wystarczy już stringów. Jak dotąd nauczyłaś się o:
+
+- **wiersz polecenia** - wpisywanie komend (kodu) w wierszu polecenia Pythona powoduje, że Python zwraca wyniki
+- **liczby i stringi** - w Pythonie liczb używamy do działań matematycznych, a stringów do obiektów tekstowych
+- **operatory** - takie jak `+` i `*`, łączą wartości produkując nowe
+- ** funkcje** - takie jak `upper()` i `len()`, wykonują działania na obiektach.
+
+Są to podstawy każdego języka programowania, jakiego przyjdzie Ci się uczyć. Gotowa na coś trudniejszego? Mamy nadzieję, że tak!
+
+## Błędy
+
+Spróbujmy czegoś nowego. Czy możemy sprawdzić długość liczby w taki sam sposób, jak długość naszego imienia? Wpisz `len(304023)` i wciśnij `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Dostałyśmy nasz pierwszy błąd! Ikona {{ warning_icon }} to sposób, w jaki będziemy Ciebie informować, że kod, który zaraz wykonasz, nie powinien zadziałać poprawnie. Popełnianie błędów (nawet intencjonalnie) to ważna część nauki!
+
+Komunikat mówi nam, że obiekty typu "int" (liczby całkowite, ang. integer) nie mają długości. Zatem co możemy zrobić? Może mogłybyśmy przekazać naszą liczbę jako string? Stringi mają ustaloną długość, zgadza się?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Działa! Użyłyśmy funkcji `str` wewnątrz funkcji `len`. Funkcja `str()` konwertuje wszystko do postaci stringów.
+
+- Funkcja `str` przekształca wartości na **stringi**
+- Funkcja `int` przekształca wartości na **liczby**
+
+> Ważne: możemy zamienić liczby na tekst, ale nie zawsze możemy zamienić tekst na liczby - czym w ogóle powinien być wynik działania `int('hello')`?
+
+## Zmienne
+
+Ważnym zagadnieniem w programowaniu są zmienne. Zmienna to nic innego jak nazwa nadana jakiejś wartości, którą potem możemy się posługiwać. Programiści używają zmiennych do przechowywania danych, dzięki czemu ich kod jest bardziej czytelny i nie muszą każdorazowo zastanawiać się, co jest czym.
+
+Przypuśćmy, że chcemy stworzyć nową zmienną zwaną `imie`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> imie = "Ola"
+```
+
+Napisałyśmy własnie, że imie równa się Ola.
+
+Jak już zauważyłaś, Twój program nie wyświetlił niczego tak, jak to robił wcześniej. Zatem skąd wiemy, że zmienna faktycznie istnieje? Wpisz `imie` i wciśnij `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> imie
+'Ola'
+```
+
+Jupi! Twoja pierwsza zmienna! :) Zawsze możesz zmienić, do czego się ona odnosi:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> imie = "Sonja"
+>>> imie
+'Sonja'
+```
+
+Możesz także używać jej w funkcjach:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(imie)
+5
+```
+
+Super, co? Zmienne mogą być czymkolwiek - liczbami również! Spróbuj:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Ale co by było, gdybyśmy użyły złej nazwy? Masz pomysł, co mogłoby się stać? Sprawdźmy!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> miasto = "Tokyo"
+>>> masto
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'masto' is not defined
+```
+
+Błąd! Jak widzisz, Python ma różne rodzaje błędów, a ten nosi nazwę **NameError**. Python zwróci Ci taki błąd, gdy będziesz próbowała używać nazwy, która nie została jeszcze utworzona. Gdybyś w przyszłości natrafiła na niego, sprawdź w swoim kodzie czy nie popełniłaś literówek w nazwach zmiennych.
+
+Poświęć chwilę czasu na zabawę i przekonaj się, co możesz z tym zrobić!
+
+## Funkcja print
+
+Spróbuj tego:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> imie = 'Maria'
+>>> imie
+'Maria'
+>>> print(imie)
+Maria
+```
+
+Kiedy wpisujesz po prostu `imie`, interpreter Pythona zwraca *odwzorowanie* stringa będącego wartością zmiennej 'imie', czyli litery M-a-r-i-a zamknięte w pojedynczym cudzysłowie''. Natomiast gdy napiszesz `print(imie)`, Python wypisze zawartość zmiennej na ekran, bez żadnego cudzysłowu, co wygląda lepiej.
+
+Jak się później przekonamy, `print()` jest szczególnie użyteczny, gdy chcemy wypisać coś z wnętrza funkcji lub gdy zechcemy wypisać wartości w kilku wierszach.
+
+## Listy
+
+Oprócz stringów i liczb całkowitych, Python dysponuje szeregiem różnych typów obiektów. Teraz zapoznamy się z typem zwanym **listą**. Listy są dokładnie tym, co myślisz: obiektami, które są listami innych obiektów. :)
+
+Śmiało, stwórzmy listę:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Tak, lista jest pusta. Niespecjalnie przydatne, co? Stwórzmy listę numerów totolotka. Nie chcemy się powtarzać za każdym razem, więc tutaj również posłużymy się zmienną:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> wyniki = [3, 42, 12, 19, 30, 59]
+```
+
+Dobrze, mamy listę! Co możemy z nią zrobić? Zobaczmy ile liczb znajduje się w tej liście. Masz pomysł, jakiej funkcji powinnaś użyć? Już z niej korzystałaś!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(wyniki)
+6
+```
+
+Tak! `len()` może zwrócić Ci liczbę obiektów zawartych w liście. Prawda że przydatne? To może teraz posortujmy listę:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> wyniki.sort()
+```
+
+Polecenie to niczego nie zwraca, po prostu zmieniło kolejność liczb zawartych w liście. Wypiszmy jej zawartość jeszcze raz i zobaczmy co się stało:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(wyniki)
+[3, 12, 19, 30, 42, 59]
+```
+
+Jak widzisz, liczby na liście są teraz uporządkowane według wartości od najniższej do najwyższej. Gratulacje!
+
+A gdybyśmy zapragnęły odwrócić kolejność? Zróbmy to!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> wyniki.reverse()
+>>> print(wyniki)
+[59, 42, 30, 19, 12, 3]
+```
+
+Jeżeli chcesz dodać coś do swojej listy, możesz to zrobić wpisując polecenie:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> wyniki.append(199)
+>>> print(wyniki)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Jeśli chcesz wyświetlić tylko pierwszą liczbę, możesz to uczynić używając **indeksów**. Indeks jest numerem mówiącym nam, w którym miejscu listy znajduje się dany element. Programiści zaczynają liczenie od zera, zatem pierwszy element Twojej listy znajduje się w miejscu oznaczonym indeksem 0, następny z indeksem 1, i tak dalej. Spróbuj tego:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(wyniki[0])
+59
+>>> print(wyniki[1])
+42
+```
+
+Jak widzisz, możesz uzyskać dostęp do każdego z elementów Twojej listy za pomocą jej nazwy oraz numeru indeksu wewnątrz nawiasów kwadratowych.
+
+By skasować coś z twojej listy, musisz użyć **indeksów**, których nauczyłyśmy się powyżej i metody `pop()`. Spróbujmy zobaczyć, jak to działa na przykładzie i powtórzmy sobie to, czego się nauczyłyśmy wyżej. Usuńmy pierwszy element z naszej listy.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(wyniki)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(wyniki[0])
+59
+>>> wyniki.pop(0)
+59
+>>> print(wyniki)
+[42, 30, 19, 12, 3, 199]
+```
+
+Wszystko zadziałało zgodnie z planem!
+
+Żeby było zabawniej, sprawdź inne indeksy: 6, 7, 1000, -1, -6 czy -1000. Sprawdż, czy jesteś w stanie przewidzieć rezultat przed użyciem instrukcji. Czy otrzymane rezultaty mają sens?
+
+Wykaz wszystkich metod dostępnych dla list znajdziesz w odpowiednim rozdziale dokumentacji Pythona: https://docs.python.org/3/tutorial/datastructures.html
+
+## Słowniki
+
+> Dla czytelniczek w domu: ten rozdział jest również omówiony w wideo [Installing Python Code Editor](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+
+Słownik przypomina nieco listę, jednak różni się tym, że dostęp do wartości uzyskujemy za pomocą klucza, a nie liczbowego indeksu. Kluczem może być dowolny ciąg znaków lub liczba. Pusty słownik tworzymy tak:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+To pokazuje, że właśnie stworzyłaś pusty słownik. Hura!
+
+A teraz spróbuj wpisać poniższą instrukcję (spróbuj użyć własnych danych):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> uczestniczka = {'imie' : 'Ola', 'kraj' : 'Polska', 'ulubione_liczby' : [7, 42, 92]}
+```
+
+Za pomocą tej instrukcji stworzyłaś właśnie zmienną o nazwie `uczestniczka` zawierającą trzy pary klucz-wartość:
+
+- Klucz `imie` wskazuje na wartość `'Ola'` (obiekt typu `string`),
+- `kraj` wskazuje na wartość `'Polska'` (kolejny `string`),
+- zaś `ulubione_liczby` odnoszą się do `[7, 42, 92]` (obiekt typu `list` zawierający trzy liczby).
+
+Za pomocą poniższej składni możesz sprawdzać wartości poszczególnych kluczy:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(uczestniczka['imie'])
+Ola
+```
+
+Widzisz, zupełnie jak w liście. Ale nie trzeba pamiętać numeru indeksu, wystarczy nazwa klucza.
+
+A co się stanie, gdy poprosimy Pythona o wartość klucza, który nie istnieje? Masz pomysł? Spróbujmy tak zrobić i zobaczmy efekt!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> uczestniczka['wiek']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'wiek'
+```
+
+Spójrz, kolejny błąd! Tym razem **KeyError**. Python próbuje Ci pomóc i wskazuje, że klucz `'wiek'` nie istnieje w tym słowniku.
+
+Kiedy powinniśmy używać słownika, a kiedy listy? To bardzo dobre pytanie! Zastanów się nad rozwiązaniem, zanim spojrzysz na odpowiedź poniżej.
+
+- Potrzebujesz ułożyć elementy w określonej kolejności? Wybierz listę.
+- Potrzebujesz powiązać wartości z kluczami, żeby mieć później łatwiejszy dostęp do nich (używając klucza)? Użyj słownika.
+
+Słowniki, podobnie jak listy, są *mutowalne*, co oznacza, że po ich utworzeniu można je nadal zmieniać. Możesz dodać do stworzonego już słownika nowe pary klucz-wartość, w taki sposób:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> uczestniczka['ulubiony_jezyk'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(uczestniczka)
+4
+```
+
+Mam nadzieję, że jak dotąd jest to zrozumiałe. :) Gotowa na dalszą zabawę ze słownikami? W następnej linijce czeka nas jeszcze więcej niesamowitości.
+
+Za pomocą polecenia `pop()` możesz usunąć element ze słownika. Założmy, że chciałabyś usunąć wpis oznaczony kluczem `'ulubione_liczby'`. Wpisz następującą instrukcję:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> uczestniczka.pop('ulubione_liczby')
+[7, 42, 92]
+>>> uczestniczka
+{'kraj': 'Polska', 'ulubiony_jezyk': 'Python', 'imie': 'Ola'}
+```
+
+Jak widać z wyświetlonego rezultatu, para klucz-wartość odpowiadająca kluczowi 'ulubione_liczby' została usunięta.
+
+Ponadto możesz także zmienić wartość odpowiadającą kluczowi, który już istnieje w słowniku. Napisz:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> uczestniczka['kraj'] = 'Niemcy'
+>>> uczestniczka
+{'kraj': 'Niemcy', 'ulubiony_jezyk': 'Python', 'imie': 'Ola'}
+```
+
+Jak widać, wartość klucza `'kraj'` została zmieniona z `'Polska'` na `'Niemcy'`. :) Ekscytujące? Hura! Właśnie nauczyłaś się kolejnej niesamowitej rzeczy.
+
+### Podsumowanie
+
+Doskonale! Wiesz już sporo o programowaniu. W tej części nauczyłaś się o:
+
+- **błędach** - umiesz już czytać ze zrozumieniem błędy pojawiające się, gdy Python nie rozumie polecenia, które mu wydałaś
+- **zmiennych** - nazwach dla obiektów, dzięki którym programuje się łatwiej, a Twój kod jest czytelniejszy
+- **listach** - listach obiektów uporządkowanych w określonej kolejności
+- **słownikach** - zbiorach obiektów przechowywanych w postaci par klucz-wartość
+
+Gotowa na następną część? :)
+
+## Porównywanie rzeczy
+
+> Dla czytelniczek w domu: tę część uwzględnia wideo [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4).
+
+Istotną częścią programowania jest porównywanie różnych rzeczy. Co najłatwiej porównać? Liczby! Zobaczmy, jak to działa:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Zastanawiasz się, dlaczego stawiamy dwa znaki równości `==` obok siebie, gdy sprawdzamy, czy liczby są równe? Pojedynczego znaku równości `=` używamy do nadawania wartości zmiennym. Zawsze, ale to **zawsze** musisz używać dwóch znaków równości `==`, gdy chcesz sprawdzić, czy dane elementy są równe. Możemy również stwierdzić, że dwie rzeczy nie są sobie równe. Aby to zrobić, używamy symbolu `!=`, tak jak to zostało pokazane na przykładzie powyżej.
+
+Użyjmy Pythona do wykonania dwóch innych zadań:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+`>` i `<` są zrozumiałe, ale co oznaczają `>=` i `<=`? Czytamy je w ten sposób:
+
+- x `>` y oznacza: x jest większe od y
+- x `<` y oznacza: x jest mniejsze od y
+- x `<=` y oznacza: x jest mniejsze lub równe y
+- x `>=` y oznacza: x jest większe lub równe y
+
+Świetnie! A chcesz zrobić coś jeszcze? Spróbuj tak:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Możesz przekazać Pythonowi tyle liczb, ile Ci się podoba, a on zawsze zwróci Ci wynik! Prawda, że sprytne?
+
+- **and** - gdy używasz operatora `and`, oba porównania muszą być prawdziwe (True), żeby całe wyrażenie było prawdziwe
+- **or** - gdy używasz operatora `or`, tylko jedno z obu porównań musi być prawdziwe, aby całe wyrażenie było prawdziwe
+
+Znasz powiedzenie "porównywać jabłka z gruszkami"? Zobaczmy, jak działa jego odpowiednik w Pythonie:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Widać, że podobnie jak w powiedzeniu, Python nie jest w stanie porównać liczby (`int`) ze stringiem (`str`). Zamiast tego zwraca nam **TypeError** i mówi nam, że te dwa typy nie mogą być porównywane ze sobą.
+
+## Obiekt logiczny (Boolean)
+
+Przypadkiem się właśnie dowiedziałaś o istnieniu innego typu obiektów w Pythonie. Nazywa się on **Boolean**.
+
+Są tylko dwa obiekty logiczne:
+
+- True - prawda
+- False - fałsz
+
+Jednak żeby Python mógł to zrozumieć, powinnaś zawsze zapisywać je tak: True (pierwsza litera wielka, reszta to małe litery). **true, TRUE, tRUE nie zadziałają -- tylko True jest poprawne.** (to samo dotyczy False.)
+
+Wartości logiczne mogą także być zmiennymi! Zobacz tutaj:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Możesz też zrobić tak:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Poćwicz i pobaw się wartościami logicznymi wpisując następujące instrukcje:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Gratulacje! Wartości logiczne są jedną z najfajniejszych możliwości w programaniu, a Ty właśnie nauczyłaś się ich używać!
+
+# Zapisujemy!
+
+> Dla czytelniczek w domu: tę część uwzględnia wideo [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk).
+
+Do tej pory pisałyśmy cały nasz kod Pythona w interpreterze, co zmusza nas do pisania linijka po linijce. Prawdziwe programy są zapisywane w plikach i uruchamiane przez **interpreter** lub **kompilator** naszego języka programowania. Dotąd uruchamiałyśmy nasze programy w **interpreterze** Pythona, wprowadzając za każdym razem najwyżej jedną linijkę kodu. Ale w następnych zadaniach będziemy potrzebowały dodać więcej niż jeden wiersz kodu, więc musimy szybko:
+
+- wyjść z interpretera Pythona
+- otworzyć wybrany przez nas edytor kodu
+- Zapisać kod do nowego pliku Pythona
+- Uruchomić go!
+
+Aby wyjść z używanego przez nas interpretera Pythona, użyj funkcji `exit()`
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+W ten sposób znajdziesz się z powrotem w wierszu polecenia.
+
+Wcześniej wybrałyśmy Edytor kodu z sekcji [Edytor kodu](../code_editor/README.md). Otwórzmy teraz edytor i napiszmy trochę kodu wewnątrz nowego pliku (lub jeśli używasz Chromebooka, stwórz nowy plik w chmurze IDE i otwórz plik, który będzie zawarty w edytorze kodu):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Oczywiście jesteś już całkiem kompetentną programistką Pythona, więc śmiało - dodaj tam więcej kodu, który poznałaś wcześniej.
+
+Teraz musimy zapisać plik i nadać mu wymowną nazwę. Nazwijmy go **python_intro.py** i zapiszmy na Pulpicie. Możemy nazwać plik jak tylko nam się podoba, ale jedna rzecz jest istotna: na końcu nazwy musi być **.py**. Rozszerzenie **.py** informuje nasz komputer, że to jest **plik wykonywalny Pythona** i Python może go uruchomić.
+
+> **Uwaga** Powinnaś zauważyć jedną z najfajniejszych rzeczy, jeśli chodzi o edytor kodu: kolory! Gdy pisałaś w konsoli Pythona, wszystko miało ten sam kolor. Teraz powinnaś zobaczyć, że funkcja `print` jest innego koloru niż string. Nazywa się to "podświetlanie składni" i jest naprawdę użyteczne podczas kodowania. Kolor wyrazów w edytorze będzie dla Ciebie wskazówką, np. łatwo rozpoznasz dzięki temu niezamknięty string albo literówkę w słowie kluczowym (tak jak `def` w funkcji). To jeden z powodów, dla których używamy edytora kodu. :)
+
+Mamy już zapisany plik, a więc czas go uruchomić! Wykorzystując wiadomości poznane w sekcji poświęconej wierszowi polecenia, użyj terminala, aby **zmienić aktualny katalog** na katalog Pulpitu.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Na Macu polecenie będzie wyglądać mniej-więcej tak:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+W Linuksie będzie tak (słowo "Desktop" może zostać przetłumaczone na polski jako "Pulpit"):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Pamiętaj, że słowo "Desktop" może zostać przetłumaczone na polski jako "Pulpit"):
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+W wierszu polecenia w systemie Windows będzie tak:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+A w Windows Powershell będzie tak:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Jeżeli utknęłaś, poproś o pomoc. To właśnie od tego są mentorzy!
+
+Teraz użyj Pythona do uruchomienia kodu z pliku w następujący sposób:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Uwaga: w Windowsie 'python3' nie będzie rozpoznawany jako polecenie. W takim wypadku użyj 'python' by wykonać ten plik:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Super! Właśnie uruchomiłaś z pliku swój pierwszy program w Pythonie. Wspaniałe uczucie, co?
+
+Teraz możemy przejść do niezwykle istotnego narzędzia w programowaniu:
+
+## If… elif… else
+
+Dużo różnych rzeczy w kodzie powinno być uruchamiane tylko wtedy, kiedy zostaną spełnione określone warunki. Dlatego Python posiada coś, co nazywa się **instrukcjami warunkowymi**.
+
+Zastąp kod w pliku **python_intro.py** następującym:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Gdybyśmy to teraz zapisały i uruchomiły, pojawiłby się błąd podobny do poniższego:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python oczekuje od nas dalszych instrukcji, które mają zostać wykonane w przypadku, gdy warunek `3 > 2` okaże się prawdziwy (czyli przyjmie wartość `True`). Sprawmy, żeby Python wypisał na ekranie "To działa!". Zmień kod w pliku **python_intro.py** na poniższy:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('To działa!')
+```
+
+Zauważyłaś, że w kolejnym wierszu nasz kod posiada wcięcie 4 spacji? Musimy tak robić, aby Python wiedział, co ma uruchomić, gdy warunek jest prawdziwy. Możesz używać jednej spacji, ale prawie każdy programista Pythona stosuje 4 spacje, aby kod wyglądał czytelniej. Pojedynczy tabulator również będzie liczył się jako 4 spacje, o ile Twój edytor tekstu został w taki sposób skonfigurowany. Jeżeli dokonałaś już wyboru, nie zmieniaj go! Jeżeli używasz już 4 spacji jako wcięć, wszystkie przyszłe wcięcia wykonuj też za pomocą 4 spacji - inaczej możesz wpaść w kłopoty.
+
+Zapisz plik i uruchom go jeszcze raz:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+To dziala!
+```
+
+Uwaga: pamiętaj, na Windowsie 'python3' nie jest rozpoznawane jako polecenie. Od tego momentu zamieniaj 'python3' na 'python' by wykonać plik.
+
+### A co jeśli warunek nie jest prawdziwy?
+
+W poprzednich przykładach kod był wykonywany wtedy, gdy warunki okazywały się prawdziwe (True). Ale Python posiada również wyrażenia `elif` i `else`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 jest jednak większe od 2')
+else:
+    print('5 nie jest większe od 2')
+```
+
+Po uruchomieniu wyświetli się:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 jest jednak większe od 2
+    
+
+Gdyby 2 było większą liczbą niż 5, wtedy zostałaby wykonana druga instrukcja. Zobaczmy, jak działa `elif`:
+
+{% filename %}python_intro.py{% endfilename %} 
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hej Ola!')
+elif name == 'Sonja':
+    print('Hej Sonja!')
+else:
+    print('Hej anonimie!')
+```
+
+i uruchommy go:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hej Sonja!
+    
+
+Widzisz co się tutaj wydarzyło? `elif` pozwala Ci na dodanie dodatkowego warunku, jeśli poprzedni warunek nie został spełniony.
+
+Po początkowej instrukcji `if` możesz dodać tyle instrukcji `elif`, ile tylko Ci się podoba. Na przykład:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python zbada każdy warunek i wyświetli:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    "Perfect, I can hear all the details"
+    
+
+## Komentarze
+
+Komentarze to linie zaczynające się od `#`. Możesz napisać cokolwiek będziesz chciała za `#`, a Python to zignoruje. Komentarze mogą spowodować, że Twój kod będzie łatwiejszy do zrozumienia przez innych.
+
+Zobaczmy, jak to wygląda:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+Nie musisz pisać komentarza dla każdej linijki kodu, ale pamiętaj, że są one pomocne, by wytłumaczyć, czemu program coś robi lub by dodać podsumowanie, gdy program robi coś skomplikowanego.
+
+### Podsumowanie
+
+W ostatnich kilku ćwiczeniach nauczyłaś się:
+
+- **porównywać rzeczy** - w Pythonie do porównywania rzeczy możesz używać operatorów `>`, `>=`, `==`, `<=`, `<` oraz `and`, `or`
+- **Boolean** - typ obiektu, który może przyjmować jedną z dwóch wartości: `True` (prawda) lub `False` (fałsz)
+- **zapisywać pliki** - przechowywać kod w plikach, co pozwala nam uruchamiać bardziej rozbudowane programy.
+- **if...elif...else** - wyrażenia, które pozwalają Ci uruchamiać kod tylko wtedy, gdy zostaną spełnione określone warunki.
+- **komentarze** - linie, których Python nie wykona, a które pozwalają Ci dokumentować kod programu
+
+Czas na ostatnią część tego rozdziału!
+
+## Twoje własne funkcje!
+
+> Dla czytelniczek w domu: tę część uwzględnia wideo [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0).
+
+Pamiętasz funkcje takie jak `len()`, które możesz uruchamiać w Pythonie? Dobra wiadomość: teraz nauczysz się pisać swoje własne funkcje!
+
+Funkcja jest zestawem poleceń, które Python ma wykonać. Każda funkcja w Pythonie zaczyna się słowem kluczowym `def`, posiada nazwę i może przyjmować parametry. Spróbujmy! Zastąp kod w pliku **python_intro.py** następującym:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hej!')
+    print('Jak się masz?')
+
+hi()
+```
+
+OK, nasza pierwsza funkcja gotowa!
+
+Być może zastanawiasz się, czemu napisałyśmy nazwę funkcji na końcu pliku. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Uruchommy to teraz i sprawdźmy, co się stanie:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hej!
+    Jak się masz?
+    
+
+Uwaga: Jeżeli to nie zadziała, nie panikuj! Wynik działania pozwoli Ci ustalić dlaczego:
+
+- Jeżeli dostajesz `NameError`, znaczy to że prawdopodobnie niepoprawnie coś wpisałaś, więc powinnaś sprawdzić czy użyłaś tej samej nazwy tworząc funkcję w `def hi():` oraz gdy ją wykonujesz w `hi()`.
+- Jeżeli dostajesz `IndentationError`, sprawdź czy obydwie linie z `print` mają tę samą liczbę spacji/tabów na początku linii: Python wymaga, by kod wewnątrz funkcji był odpowiednio wcięty. 
+- Jeżeli nie ma żadnego wyniku działania, sprawdź czy ostanie `hi()` *nie* jest przypadkiem wcięte - jeżeli jest, to ta linia stała się również częścią funkcji i nigdy nie zostanie wykonana. 
+
+Zbudujmy naszą pierwszą funkcję z parametrami. Posłużymy się wcześniejszym przykładem - funkcją, która wita każdego, kto ją uruchomi, wraz z imieniem:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(imie):
+```
+
+Jak widać, teraz nasza funkcja przyjmuje parametr, który nazwałyśmy `imie`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(imie):
+    if imie == 'Ola':
+        print('Hej Ola!')
+    elif imie == 'Sonja':
+        print('Hej Sonja!')
+    else:
+        print('Hej nieznajoma!')
+
+hi()
+```
+
+Pamiętaj: musiałyśmy dodać cztery dodatkowe spacje (razem osiem) przed funkcją `print`, ponieważ `if` musi dostać informację o tym, co powinno się wydarzyć, gdy warunek zostanie spełniony. Zobaczmy teraz, jak to działa:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'imie'
+    
+
+Ups, błąd. Na szczęście Python zwrócił nam dość przydatny komunikat. Mówi nam, że funkcja `hi()` (ta, którą stworzyłyśmy) posiada jeden wymagany argument (zwany `imie`) i że zapomniałyśmy go przekazać przy wywoływaniu funkcji. Naprawmy to na końcu naszego pliku:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+I wykonajmy ponownie:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hej Ola!
+    
+
+A gdybyśmy zmieniły imię?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+I wykonajmy:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hej Sonja!
+    
+
+A jak myślisz - co się stanie, jak wprowadzimy tam inne imię (jeszcze inne niż Ola i Sonja)? Spróbuj i przekonaj się, czy miałaś rację. Powinno się wyświetlić coś takiego:
+
+{% filename %}command-line{% endfilename %}
+
+    Hej nieznajoma!
+    
+
+Prawda, że fajnie? W ten sposób nie musisz powtarzać się za każdym razem, gdy zechcesz zmienić imię osoby, która ma zostać powitana. To właśnie dlatego funkcje są nam potrzebne - żeby nie powtarzać kodu!
+
+Zróbmy coś mądrzejszego - mamy więcej niż dwa imiona, a podanie warunku dla każdego byłoby trudne, prawda? Zastąp zawartość pliku następującym kodem:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(imie):
+    print('Hej ' + imie + '!')
+
+hi("Rachel")
+```
+
+Teraz wywołajmy ten kod:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hej Rachel!
+    
+
+Gratulacje! Właśnie nauczyłaś się pisać funkcje! :)
+
+## Pętle
+
+> Dla czytelniczek w domu: tę część uwzględnia wideo [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0).
+
+To już ostatnia część. Prawda, że szybko poszło? :)
+
+Jak już wspomniałyśmy, programiści są leniwi i nie lubią się powtarzać. W programowaniu chodzi o automatyzowanie różnych rzeczy, więc nie chcemy witać ręcznie każdej osoby po imieniu, prawda? I tu właśnie przydają nam się pętle.
+
+Pamiętasz jeszcze listy? Zróbmy listę dziewczyn:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+dziewczyny = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'Ty']
+```
+
+Chcemy powitać po imieniu każdą z nich. Mamy do tego funkcję `hi`, zatem użyjmy jej wewnątrz pętli:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for imie in dziewczyny:
+```
+
+Wyrażenie `for` zachowuje się podobnie jak `if`, a więc kod pod nimi musi być wcięty 4 spacjami.
+
+Oto kompletny kod, który umieścimy w pliku:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(imie):
+    print('Witaj ' + imie + '!')
+
+dziewczyny = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'Ty']
+for imie in dziewczyny:
+    hi(imie)
+    print('Kolejna dziewczyna')
+```
+
+A gdy go uruchomimy:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hej Rachel!
+    Kolejna dziewczyna
+    Hej Monica!
+    Kolejna dziewczyna
+    Hej Phoebe!
+    Kolejna dziewczyna
+    Hej Ola!
+    Kolejna dziewczyna
+    Hej Ty!
+    Kolejna dziewczyna
+    
+
+Jak widzisz, cokolwiek umieścisz wewnątrz wyrażenia `for` wraz z wcięciem - zostanie powtórzone dla każdego elementu listy `dziewczyny`.
+
+Możesz także użyć `for` na liczbach, używając metody `range`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Co wypisze nam na ekranie:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` jest funkcją, która tworzy listę liczb jedna po drugiej (liczby te podajesz jako parametry).
+
+Zwróć uwagę, że druga z tych liczb nie jest częścią listy stworzonej przez Pythona (to znaczy, że `range(1, 6)` liczy od 1 do 5, ale nie zawiera liczby 6). Dzieje się tak, bo "range" ma przedział jednostronnie otwarty, co oznacza, że zawiera pierwszą wartość z przedziału, ale nie zawiera ostatniej.
+
+## Podsumowanie
+
+To już wszystko. **Wspaniale Ci idzie!** To nie było wcale takie łatwe, możesz zatem być z siebie dumna. My zdecydowanie jesteśmy z Ciebie dumne, że dotarłaś do tego miejsca!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+Jak myślisz, może czas na małą przerwę? Rozciągnij się, rozprostuj nogi, daj odpocząć oczom zanim przejdziesz do kolejnego rozdziału. :)
+
+![Babeczka](images/cupcake.png)
\ No newline at end of file
diff --git a/pl-PL/template_extending/README.md b/pl-PL/template_extending/README.md
new file mode 100644
index 00000000000..29f97bb5d4e
--- /dev/null
+++ b/pl-PL/template_extending/README.md
@@ -0,0 +1,151 @@
+# Rozbudowa szablonów
+
+Kolejną fajną rzeczą, którą Django daje Ci do dyspozycji, jest możliwość **rozszerzania szablonów**. Co to oznacza? To znaczy, że możesz używać tych samych części Twojego kodu HTML na różnych stronach Twojej aplikacji.
+
+Szablony pomagają, gdy chcesz użyć te same informacje lub ten sam kod w wielu miejscach. W takim wypadku nie musisz się powtarzać w każdym pliku. I jak będziesz chciała zmienić cokolwiek, nie będziesz musiała tego zrobić w każdym szablonie, wystarczy tylko w jednym!
+
+## Tworzenie szablonu bazowego
+
+Szablon bazowy to najbardziej podstawowy szablon, który możesz rozszerzać na każdej stronie twojej aplikacji.
+
+Stwórzmy plik `base.html` w `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Następnie otwórz ten plik w edytorze kodu i skopiuj całą zawartość pliku `post_list.html` do pliku `base.html`, w taki sposób:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Następnie, w `base.html`, zamień całą zawartość `<body>` (wszystko, co znajduje się pomiędzy `<body>` a `</body>`) na to:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Mogłaś zauważyć, że zamieniło to wszystko od `{% for post in posts %}` do `{% endfor %}` na: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Ale czemu? Właśnie stworzyłaś `block`! Użyłaś znacznika szablonu `{% block %}` by zaznaczyć obszar, w który zostanie wstawiony HTML. Ten HTML będzie pochodził z innego szablonu, który rozszerza ten szablon (`base.html`). Za chwilę pokażemy Ci, jak to się robi.
+
+Teraz zapisz `base.html` i otwórz ponownie w edytorze swój `blog/templates/blog/post_list.html`. {% raw %}Usuniemy teraz wszystko powyżej `{% for post in posts %}` i poniżej `{% endfor %}`. Jak to zrobisz, plik będzie wyglądać tak:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Będziemy chciały użyć tych kliku linii jako części szablonu dla wszystkich bloków treści. Najwyższy czas dodać znaczniki block w tym pliku!
+
+{% raw %}Musimy zrobić to tak, by nasz znacznik block zgadzał się ze znacznikiem w pliku `base.html`. Chcesz też by zawierał on cały kod, który należy do twoich bloków treści. By to osiągnąć, umieść wszystko pomiędzy `{% block content %}` i `{% endblock %}`. O tak:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Została jeszcze jedna rzecz. Musimy połączyć te dwa szablony razem. To właśnie na tym polega rozszerzaniem szablonów! Dokonamy tego dodając tag extend na początku nasze pliku. Właśnie tak:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+To wszystko! Zapisz plik i sprawdź, czy Twoja strona nadal działa poprawnie. :)
+
+> Jeżeli dostaniesz błąd `TemplateDoesNotExist`, oznacza to, że nie ma jesze pliku `blog/base.html` i jednocześnie w konsoli działa uruchomiony `runserver`. Spróbuj go zatrzymać (wciskając Ctrl+C - czy razem klawisze Control i C) i uruchomić ponownie przy użyciu polecenia `python manage.py runserver`.
\ No newline at end of file
diff --git a/pl-PL/whats_next/README.md b/pl-PL/whats_next/README.md
new file mode 100644
index 00000000000..2eae946f98e
--- /dev/null
+++ b/pl-PL/whats_next/README.md
@@ -0,0 +1,43 @@
+# Co dalej?
+
+Możesz z siebie być dumna! **Jesteś absolutnie świetna**. Jesteśmy takie dumne! <3
+
+### Co teraz?
+
+Zrób sobie przerwę i zrelaksuj się. Odwaliłaś kawał dobrej roboty!
+
+Potem, upewnij się, że śledzisz Django Girls na [Facebooku](http://facebook.com/djangogirls) i [Twitterze](https://twitter.com/djangogirls) by być na bieżąco.
+
+### Czy możesz polecić kolejne materiały?
+
+Tak! Jest *wiele* materiałów online do nauki dowolnych umiejętności programistycznych - może to być całkiem zniechęcające, gdy trzeba wybrać spośród wielu stron. My wybrałyśmy te najciekawsze. Niezależnie od tego, czym interesowałaś się, zanim przybyłaś na Django Girls i niezależnie od tego, co zainteresowało Cię podczas przechodzenia tutoriala, oto kilka darmowych zasobów (lub zasobów z dużymi darmowymi komponentami), których możesz używać, aby się podszkolić.
+
+#### Django
+
+- Nasza inna książka, [Django Girls Tutorial: Extensions ](https://tutorial-extensions.djangogirls.org/)
+- [Oficjalny tutorial Django](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Wideolekcje Getting Started with Django](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS i JavaScript
+
+- [Kurs programowania webowego na Codeacademy](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Kurs Pythona na Codeacademy](https://www.codecademy.com/learn/learn-python)
+- [Kurs Pythona od Google'a](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) - wstępne ćwiczenia są bezpłatne 
+- [New Coder tutorials](http://newcoder.io/tutorials/)-jest wiele praktycznych przykładów, jak można użyć Pythona
+- [edX](https://www.edx.org/course?search_query=python) - możesz sprawdzić większość kursów za darmo, lecz jeśli chciałabyś otrzymać certyfikat lub zdobyć punkty zwiększające Twoje kwalifikacje, to może to trochę kosztować
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) - niektóre wykłady wideo są dostępne za darmo i możesz uzyskać Certyfikat Kursanta, przechodząc przez niego
+- [Python for Everybody](https://www.py4e.com/) - wolna i otwarta wersja Coursera Pythona dla każdej specjalizacji
+
+#### Praca z danymi
+
+- [Kurs data science na Codeacademy](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) - możesz sprawdzić większość kursów za darmo, lecz jeśli chciałabyś otrzymać certyfikat lub zdobyć punkty zwiększające Twoje kwalifikacje, to może to trochę kosztować
+- [Dataquest](https://www.dataquest.io/) – pierwszych 30 "misji" jest darmowych 
+
+Nie możemy się doczekać, aby zobaczyć, co zbudujesz następnym razem!
\ No newline at end of file
diff --git a/pl/README.md b/pl/README.md
index 1484daaed80..04a5b0ff6bc 100755
--- a/pl/README.md
+++ b/pl/README.md
@@ -1,52 +1,51 @@
 # Kurs Django Girls
 
-[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
 
-> Niniejsza praca jest licencjonowana zgodnie z Creative Commons Attribution-ShareAlike License 4.0 International. Aby zobaczyć kopię niniejszej licencji, odwiedź https://creativecommons.org/licenses/by-sa/4.0/
+> Niniejsza praca jest licencjonowana zgodnie z Creative Commons Attribution-ShareAlike License 4.0 International. Aby zobaczyć kopię niniejszej licencji, odwiedź http://creativecommons.org/licenses/by-sa/4.0/
 
-## Tłumaczenie
+## Witaj
 
-Ten kurs został przetłumaczony z języka angielskiego przez grupę wolontariuszy. Specjalne podziękowania za pomoc dla: Łukasza Wójcika, Agaty Grdal, Oli Sitarskiej, Marysi Lowas-Rzechonek, Anny Warzechy, Maćka Zająca, CrazyHorse, Kingi Kieczkowskiej, Mariusza Zielińskiego, Beltuska, Bartka Dobrowolskiego, Oli Sendeckiej, Michała Krzysztofa Feilera, Kamila Gałuszki, Adriangit oraz Chrisa Warricka. <3 <3
+Witaj w tutorialu Django Girls! Super Cię widzieć :) W tym tutorialu odbędziemy podróż po technologiach internetowych, oferując Tobie podgląd na wszystkie części składowych, które połączone razem tworzą sieć taką, jaką ją znamy.
+
+Jak z wszystkim, co jest nieznane, będzie to naprawdę niezła przygoda - ale nie przejmuj się, skoro już się tutaj znalazłaś, to dalej już będzie tylko z górki :)
 
 ## Wprowadzenie
 
-Czy kiedykolwiek czułaś, że wokół jest coraz więcej nowych technologii, a Ty zostajesz w tyle? Zastanawiałaś się kiedyś jak zrobić stronę internetową, ale nie miałaś motywacji by zacząć? Czy zdarzyło Ci się pomyśleć, że świat programowania jest dla Ciebie zbyt skomplikowany by nawet spróbować zrobić coś samej?
+Czy kiedykolwiek czułaś, że wokół jest coraz więcej nowych technologii, a Ty zostajesz w tyle? Zastanawiałaś się kiedyś jak zrobić stronę internetową, ale nie miałaś motywacji by zacząć? Czy zdarzyło Ci się pomyśleć, że świat programowania jest dla Ciebie zbyt skomplikowany?
 
 No więc mamy dla Ciebie dobre nowiny! Programowanie nie jest tak trudne, jak się wydaje, a my chcemy Ci pokazać, że może być też niezłą zabawą.
 
-Ten kurs nie zamieni Cię w zawodowego programistę. Jeżeli chcesz być w tym naprawdę dobra, musisz spędzić miesiące lub nawet lata na nauce i ćwiczeniach. Ale chciałybyśmy Ci pokazać, że programowanie i pisanie stron internetowych nie jest tak trudne, jak mogłoby się wydawać. Spróbujemy wyjaśnić to i owo najprościej i najlepiej jak tylko potrafimy, abyś nie czuła się przytłoczona nową technologią.
+Ten kurs nie zamieni Cię w zawodową programistkę. Jeżeli chcesz być w tym naprawdę dobra, musisz spędzić miesiące lub nawet lata na nauce i ćwiczeniach. Ale chciałybyśmy Ci pokazać, że programowanie i pisanie stron internetowych nie jest tak trudne, jak mogłoby się wydawać. Spróbujemy wyjaśnić to i owo najprościej i najlepiej jak tylko potrafimy, abyś nie czuła się przytłoczona nową technologią.
 
 Mamy nadzieję sprawić, że pokochasz to tak jak my!
 
 ## Czego nauczysz się w trakcie kursu?
 
-Gdy skończysz kurs, będziesz mieć gotową prostą aplikację internetową: swój własny blog. Pokażemy Ci jak udostępnić go w Internecie, abyś mogła pochwalić się znajomym!
+Jak skończysz tutorial, będziesz miała małą działającą aplikację webową: twój blog. Pokażemy Ci jak umieścić ją online, tak by inni mogli zobaczyć Twoją pracę!
 
 Będzie to wyglądać mniej więcej tak:
 
-![Rysunek 0.1][2]
-
- [2]: images/application.png
-
-> Jeżeli przerabiasz tutorial samodzielnie i nie masz w pobliżu osoby, która pomogłaby Ci w razie problemów, zapraszamy na czat:  [![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge). Ustaliliśmy z naszymi mentorami oraz poprzednimi uczestniczkami, że od czasu do czasu będą się tam pojawiać i udzielać pomocy z tutorialem! Nie bój się pytać!
-
-Ok, [zacznijmy od początku...][3]
-
- [3]: ./how_the_internet_works/README.md
-
-## Jak możesz pomóc?
-
-Kurs jest prowadzony przez [DjangoGirls][4]. Jeżeli znajdziesz jakiś błąd lub chcesz dodać coś nowego, zapoznaj się proszę z [tymi informacjami][5].
-
- [4]: https://djangogirls.org/
- [5]: https://github.com/DjangoGirls/tutorial/blob/master/README.md
-
-## Pomożesz nam przetłumaczyć tutorial na inne języki?
-
-Obecnie przechowujemy wersje językowe na platformie Crowdin.com:
-
-https://crowdin.com/project/django-girls-tutorial
-
-Jeżeli nie znajdziesz tam swojego języka, prosimy o [zgłoszenie][6] nowego, brakującego języka, abyśmy mogły go dodać.
-
- [6]: https://github.com/DjangoGirls/tutorial/issues/new
+![Rysunek 0.1](images/application.png)
+
+> Jeżeli przerabiasz tutorial samodzielnie i nie masz w pobliżu osoby, która pomogłaby Ci w razie problemów, zapraszamy na czat: !(https://badges. gitter. im/Join Chat. svg)![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg). Ustaliliśmy z naszymi mentorami oraz poprzednimi uczestniczkami, że od czasu do czasu będą się tam pojawiać i udzielać pomocy z tutorialem! Nie bój się pytać!</p> </blockquote> 
+> 
+> Ok, [zacznijmy od początku...](./how_the_internet_works/README.md)
+> 
+> ## Przerabiasz tutorial w domu?
+> 
+> Udział w warsztatach Django Girls to niesamowite doświadczenie, ale zdajemy sobie sprawę, że nie zawsze jest to możliwe. Z tego powodu zachęcamy Ciebie byś spróbowała przerobić tutorial w domu. Dla czytelniczek w domu, jesteśmy właśnie w trakcie przygotowywani materiałów wideo, które ułatwią samodzielne podążanie za tutorialem. Na chwilę obecną nie posiadamy wideo do wszystkich rozdziałów, ale dzień po dniu, rozdział po rozdziale kolejne materiały będą się pojawiać na kanale [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) na YouTubie.
+> 
+> W każdym rozdziale, który posiada materiał wideo, udostępniamy link, który do niego prowadzi.
+> 
+> ## Jak możesz pomóc?
+> 
+> Kurs jest prowadzony przez [DjangoGirls](https://djangogirls.org/). Jeżeli znajdziesz jakiś błąd lub chcesz dodać coś nowego, zapoznaj się proszę z [tymi informacjami](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+> 
+> ## Chciałabyś pomóc nam tłumaczyć tutorial na inne języki?
+> 
+> Obecnie przechowujemy wersje językowe na platformie Crowdin.com:
+> 
+> https://crowdin.com/project/django-girls-tutorial
+> 
+> Jeżeli twój język nie jest wylistowany na [Crowdinie](https://crowdin.com/), [zgłoś nowe issue](https://github.com/DjangoGirls/tutorial/issues/new), dzięki któremu poinformujesz nas, by dodać język.
\ No newline at end of file
diff --git a/pl/SUMMARY.md b/pl/SUMMARY.md
index 0f4a8e81f08..d699be9634b 100755
--- a/pl/SUMMARY.md
+++ b/pl/SUMMARY.md
@@ -1,26 +1,27 @@
 # Podsumowanie
 
-*   [Wprowadzenie](README.md)
-*   [Instalacja](installation/README.md)
-*   [Jak działa Internet](how_the_internet_works/README.md)
-*   [Wprowadzenie do linii poleceń](intro_to_command_line/README.md)
-*   [Instalowanie Pythona](python_installation/README.md)
-*   [Edytor kodu](code_editor/README.md)
-*   [Wprowadzenie do Pythona](python_introduction/README.md)
-*   [Czym jest Django?](django/README.md)
-*   [Instalowanie Django](django_installation/README.md)
-*   [Twój pierwszy projekt w Django!](django_start_project/README.md)
-*   [Modele w Django](django_models/README.md)
-*   [Administracja Django (admin)](django_admin/README.md)
-*   [Wdrażanie!](deploy/README.md)
-*   [Adresy URL w Django](django_urls/README.md)
-*   [Widoki Django - czas je stworzyć!](django_views/README.md)
-*   [Wprowadzenie do HTMLa](html/README.md)
-*   [ORM Django (obiekty QuerySet)](django_orm/README.md)
-*   [Dane dynamiczne w szablonach Django](dynamic_data_in_templates/README.md)
-*   [Szablony Django](django_templates/README.md)
-*   [CSS - upiększ to](css/README.md)
-*   [Rozbudowa szablonów](template_extending/README.md)
-*   [Rozbudowa aplikacji](extend_your_application/README.md)
-*   [Formularze Django](django_forms/README.md)
-*   [Co dalej?](whats_next/README.md)
+* [Wprowadzenie](README.md)
+* [Instalacja](installation/README.md)
+* [Instalacja (chromebook)](chromebook_setup/README.md)
+* [Jak działa internet](how_the_internet_works/README.md)
+* [Wprowadzenie do linii poleceń](intro_to_command_line/README.md)
+* [Instalowanie Pythona](python_installation/README.md)
+* [Edytor tekstu](code_editor/README.md)
+* [Wprowadzenie do Pythona](python_introduction/README.md)
+* [Czym jest Django?](django/README.md)
+* [Instalowanie Django](django_installation/README.md)
+* [Twój pierwszy projekt w Django!](django_start_project/README.md)
+* [Modele w Django](django_models/README.md)
+* [Administracja Django (admin)](django_admin/README.md)
+* [Wdrażanie!](deploy/README.md)
+* [Adresy URL w Django](django_urls/README.md)
+* [Widoki Django - czas zacząć tworzyć!](django_views/README.md)
+* [Wprowadzenie do HTMLa](html/README.md)
+* [Django ORM (QuerySet)](django_orm/README.md)
+* [Dane dynamiczne w szablonach Django](dynamic_data_in_templates/README.md)
+* [Szablony Django](django_templates/README.md)
+* [CSS - upiększ to](css/README.md)
+* [Rozbudowa szablonów](template_extending/README.md)
+* [Rozbudowa aplikacji](extend_your_application/README.md)
+* [Formularze Django](django_forms/README.md)
+* [Co dalej?](whats_next/README.md)
\ No newline at end of file
diff --git a/pl/chromebook_setup/README.md b/pl/chromebook_setup/README.md
new file mode 100644
index 00000000000..e8d24738a97
--- /dev/null
+++ b/pl/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Instalacja Chromebook
+
+> **Uwaga** Jeżeli wykonałeś już kroki instalacyjne, nie musisz tego robić ponownie - możesz przejść od razu do [Wprowadzenie do Pythona](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/pl/chromebook_setup/instructions.md b/pl/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..0066e8308f9
--- /dev/null
+++ b/pl/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+Możesz [pominąć tę sekcję](http://tutorial.djangogirls.org/en/installation/#install-python) jeżeli nie używasz Chromebooka. Jeżeli używasz, proces instalacji będzie wyglądał następująco. Możesz zignorować pozostałą cześć instrukcji.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. Na czas trwania tutoriala Cloud9 będzie działać jako *komputer lokalny*. Nadal będziesz mogła uruchamiać komendy w terminalu, tak jak inne osoby korzystające z systemu OS X, Ubuntu czy Windowsa, z tym że Twój terminal będzie podłączony do komputera z systemem, który ustawia dla Ciebie Cloud 9.
+
+1. Zainstaluj Cloud 9 ze [ sklepu Chrome](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Przejdź do [c9.io](https://c9.io)
+3. Załóż konto
+4. Kliknij przycisk *Utwórz nowy obszar roboczy*
+5. Nadaj mu nazwę *django-girls*
+6. Wybierz *Puste* (drugi od prawej w dolnym rzędzie z pomarańczowym logo)
+
+Teraz powinnaś zobaczyć interfejs z bocznym paskiem, duże główne okno z tekstem i małe okno na dole, które wygląda następująco:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    twojanazwaużytkownika:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Środowisko wirtualne
+
+Środowisko wirtualne (Virtual Environment - zwany także virtualenv) jest jak skrzynka, do której możemy wstawić użyteczny program komputerowy dla projektu nad którym pracujemy. Używamy go aby oddzielić od siebie różne części kodu, potrzebne nam w różnych projektach, przez co nie mieszają się one pomiędzy różnymi projektami.
+
+W swoim terminalu na dole ekranu Cloud 9 wykonaj następujące polecenie:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+Jeżeli polecenie cały czas nie chce zadziałać, poproś o pomoc swojego mentora.
+
+Następnie uruchom:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(zauważ, że w ostatniej linii użyliśmy tyldy, za którą następuje znak równości: ~=).
+
+### GitHub
+
+Załóż konto na [Githubie](https://github.com).
+
+### PythonAnywhere
+
+Tutorial Django Girls zawiera sekcję dotycząca wdrożenia, tzn. procesu przenoszenia kodu programu, który odpowiada za działanie naszej nowej aplikacji internetowej na publicznie dostępny komputer (zwany serwerem) w taki sposób, by inne osoby były wstanie zobaczyć nasze dzieło.
+
+Ta część może wydać się lekko niezrozumiała, gdy przechodzimy tutorial na Chromebooka, skoro w trakcie tutoriala używamy komputera, który już jest w Internecie (w odróżnieniu od chociażby naszego laptopa). Jednak, może ona być cały czas przydatna, byśmy traktowały nasze konto w Cloud9 jako miejsce, w którym postępuje nasz praca oraz Python Anywhere jako miejsce, gdzie możemy pokazać światu nasze dzieło, jak tylko będzie ono bardziej dokończone.
+
+Dlatego właśnie załóż nowe konto w Python Anywhere pod adresem [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/pl/code_editor/README.md b/pl/code_editor/README.md
index 3a2d0024e7b..db8333fb178 100755
--- a/pl/code_editor/README.md
+++ b/pl/code_editor/README.md
@@ -1,7 +1,11 @@
-# Edytor kodu
+# Edytor tekstu
+
+> Dla czytelniczek w domu: ten rozdział jest również omówiony w wideo [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
 
 Zaraz napiszesz swoją pierwszą linijkę kodu, więc najwyższy czas zainstalować edytor kodu!
 
+> **Uwaga** Jeśli używasz już Chromebook, pomiń ten rozdział i upewnij się, że postąpiłeś zgodnie z instrukcją [Instalacja Chromebooka](../chromebook_setup/README.md).
+> 
 > **Uwaga** Jeśli zrobiłaś to już wcześniej w rozdziale 'Instalacja' - możesz przejść od razu do następnego rozdziału!
 
-{% include "/code_editor/instructions.md" %}
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/pl/code_editor/instructions.md b/pl/code_editor/instructions.md
index 0cfce56a459..617478c39ce 100755
--- a/pl/code_editor/instructions.md
+++ b/pl/code_editor/instructions.md
@@ -1,12 +1,6 @@
 Tylko który wybrać? To nie takie proste, bo wybór zależy w dużej mierze od tego, czego oczekujesz od swojego edytora. Większość programistów Pythona używa bardzo skomplikowanych i niezwykle bogatych w różne funkcjonalności IDE (z ang. Integrated Development Environments - zintegrowane środowisko deweloperskie), takich jak: PyCharm. Jako osoba początkująca nie potrzebujesz jednak aż tak skomplikowanego edytora. Wystarczy coś prostszego, ale nadal dostatecznie użytecznego.
 
-Poniżej znajdziesz nasze propozycje, ale jeżeli masz taką możliwość, możesz poprosić o rekomendację Twojego coacha -- będzie mu łatwiej pomagać Ci podczas warsztatów.
-
-## Visual Studio Code
-VS Code to najnowszy edytor stworzony przez Microsoft. Edytor ten jest dostępny na wszystkich systemach - Windows, Linux, OsX.
-Jest całkowicie darmowy, posiada wiele pluginów ułatwiających pracę z kodem.
-
-[Pobierz tutaj](https://code.visualstudio.com/)
+Nasze sugestie prezentujemy poniżej, ale w razie czego spytaj o sugestię swojego mentora - w takiej sytuacji będzie mu łatwiej Tobie pomóc.
 
 ## Gedit
 
@@ -16,17 +10,13 @@ Gedit to open source'owy i darmowy edytor dostępny dla wszystkich systemów ope
 
 ## Sublime Text 3
 
-Sublime Text to bardzo popularny edytor z darmowym okresem testowania. Jest bardzo prosty do zainstalowania i używania, dostępny na wszystkie systemy operacyjne.
-
-`Uwaga!`
-
-Sublime jest bezpłatny tylko do celów wypróbowania - w trakcie pracy na nim, będzie wyskakiwać w różnych momentach okienko zachęcające do jego zakupu! 
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
 
 [Pobierz tutaj](https://www.sublimetext.com/3)
 
 ## Atom
 
-Atom to nowy edytor kodu stworzony przez [GitHuba](https://github.com/). Jest darmowy, ma otwarte źródła, jest łatwy do zainstalowania i używania. Dostępny na Windowsa, OS X i Linuxa.
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
 
 [Pobierz tutaj](https://atom.io/)
 
@@ -34,8 +24,8 @@ Atom to nowy edytor kodu stworzony przez [GitHuba](https://github.com/). Jest da
 
 Może się zastanawiasz dlaczego instalujemy specjalny edytor kodu zamiast używać Notatnika albo Notepada.
 
-Po pierwsze kod musi być napisany **zwykłym tekstem** (ang. "plain text"), a programy takie jak Word albo Textedit sprawiają, że wyrazy nie są tak naprawdę tylko tekstem - możesz zmieniać ich wielkość, czcionkę czy kolor. Jest to tak zwany sformatowany tekst (ang. rich text), używający różnych formatów, takich jak [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+Podstawowym powodem jest to, że kod musi być **zwykłym, niesformatowanym tekstem**, co powoduje że nie możemy tutaj użyć programów takich jak Word czy Textedit, ponieważ to co one produkują to nie jest zwykły tekst, tylko tekst sformatowany (z informacją odnośnie użytej czcionki, sposobu formatowania), używająć specjalnych formatów danych, jak na przykład [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
 
-Po drugie, edytory kodu zostały specjalnie stworzone do tego, by pisać w nich kod, więc mają wiele przydatnych opcji, takich jak podświetlanie różnych elementów składni języka programowania czy automatyczne dodawanie zamykającego cudzysłowu.
+Drugim powodem jest specjalizacja edytorów kodu - dzięki temu mogą one dostarczać bardzo użytecznych funkcjonalności, jak kolorowanie składni zgodnie z jej przeznaczeniem lub automatyczne zamykanie cudzysłowów zamiast Ciebie.
 
-Wszystko to zobaczymy w akcji. Niedługo zaczniesz myśleć o swoim edytorze kodu jako o starym, dobrym przyjacielu :)
\ No newline at end of file
+Za chwilę przetestujemy wybrany edytor w akcji. Nim się obejrzysz będziesz uważać swój edytor tekstu jako jedno z ulubionych narzędzi. :)
\ No newline at end of file
diff --git a/pl/css/README.md b/pl/css/README.md
index 1286a7e24ba..037e5fb3c5f 100755
--- a/pl/css/README.md
+++ b/pl/css/README.md
@@ -4,26 +4,28 @@ Nasz blog nadal wygląda dość surowo, prawda? Czas, aby to zmienić! Użyjemy
 
 ## Czym jest CSS?
 
-Kaskadowe arkusze stylów (ang. Cascading Style Sheets, CSS) to język używany do określania wyglądu i formatowania strony internetowej napisanej w języku znaczników (np. HTML). Traktuj go jak make-up dla naszej strony :).
+Kaskadowe arkusze stylów (ang. Cascading Style Sheets, CSS) to język używany do określania wyglądu i formatowania strony internetowej napisanej w języku znaczników (np. HTML). Traktuj go jak make-up dla naszej strony. ;)
 
-Ale nie chcemy znów zaczynać od samego początku, prawda? Użyjemy, raz jeszcze, narzędzia uprzednio stworzonego przez programistów i opublikowanego przez nich w Internecie, za darmo. Nie ma sensu ponownie wymyślać koła.
+Ale nie chcemy zaczynać od nowa, prawda? Raz jeszcze będziemy używać czegoś, co programiści wydali w Internecie za darmo. Odkrywanie Ameryki na nowo nie jest zabawne, wiesz.
 
-## Użyjmy Bootstrap!
+## Użyjmy biblioteki Bootstrap!
 
 Bootstrap jest jednym z najpopularniejszych frameworków HTML i CSS do budowania pięknych stron: https://getbootstrap.com/
 
-Został stworzony przez programistów, którzy pracowali dla Twitter-a i w chwili obecnej jest rozwijany przez ochotników z całego świata.
+Został stworzony przez programistów, którzy pracowali dla Twitter-a. Obecnie jest rozwijany przez ochotników z całego świata!
 
-## Instalacja Bootstrap
+## Zainstaluj Bootstrapa
 
-Aby zainstalować Bootstrap musisz dodać poniższe linijki do znacznika `<head>` w Twoim pliku `.html` (`blog/templates/blog/post_list.html`):
+Aby zainstalować Bootstrap musisz dodać poniższe linijki `<head>` w Twoim pliku `.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
 ```
 
-Te linijki nie dodają żadnych plików do Twojego projektu. Wskazują one po prostu na pliki, które znajdują się w Internecie. Otwórz teraz swoją przeglądarkę i odśwież stronę, a ujrzysz zmianę!
+Akurat to nie doda żadnych nowych plików do twojego projektu. Te dwie linijki wskazują na pliki, które istnieją w Internecie. Sprawdź sama, otwórz swoją stronę w przeglądarce internetowej, odśwież zawartość. No i proszę!
 
 ![Rysunek 14.1](images/bootstrap1.png)
 
@@ -31,49 +33,44 @@ Od razu wygląda lepiej, prawda?
 
 ## Pliki statyczne w Django
 
-Następną rzeczą jaką się dzisiaj nauczysz będą **pliki statyczne**. Plikami statycznymi są wszystkie arkusze CSS oraz obrazy -- pliki które nie są dynamiczne, a więc ich zawartość nie jest zależna od kontekstu żądania i są takie same dla każdego użytkownika.
+Przyjrzymy się teraz bliżej temu co nazwałyśmy **plikami statycznymi**. Pliki statyczne to wszystkie twoje arkusze stylu oraz pliki z obrazkami. Ich zawartość nie zależy od kontekstu żądania i będzie taka sama dla każdego użytkownika.
 
-Arkusz CSS jest plikiem statycznym, więc aby modyfikować style kaskadowe, musimy najpierw skonfigurować pliki statyczne w Django. Wystarczy, że zrobisz to raz. Zaczynajmy:
+### Gdzie umieścić pliki statyczne w Django
 
-### Konfigurowanie plików statycznych w Django
+Django wie, gdzie szukać plików statycznych dla wbudowanej aplikacji "admin". Teraz musimy jeszcze dodać jakieś pliki statyczne do naszej własnej aplikacji `blog`.
 
-Teraz musimy stworzyć katalog, w którym będziemy przetrzymywać nasze pliki statyczne. Utwórz katalog o nazwie `static` w folderze `djangogirls`.
+Wystarczy, że w naszej aplikacji stworzymy nowy folder i nazwiemy go `static`:
 
     djangogirls
-    ├─── static
-    └─── manage.py
-
-
-Otwórz plik z lokalizacji `mysite/settings.py` i dodaj na końcu następujące linie:
-
-```python
-STATICFILES_DIRS = (
-    os.path.join(BASE_DIR, "static"),
-)
-```
+    ├── blog
+    |     ├── migrations
+    |     ├── static
+    |     └── templates
+    └── mysite
+    
 
-Tym sposobem Django będzie wiedziało gdzie szukać plików statycznych.
+Django automatycznie wyszuka każdy folder nazwany "static" w środku każdego folderu aplikacji. Zawartość tych katalogów będzie uznawana za pliki statyczne.
 
 ## Twój pierwszy arkusz CSS!
 
-Stwórzmy teraz arkusz CSS, aby dodać do Twojej strony Twój własny styl. Stwórz katalog o nazwie `css` w środku folderu `static`. Następnie utwórz nowy plik o nazwie `blog.css` w katalogu `css`. Gotowe?
+Stwórzmy teraz plik CSS, aby dodać nasze własne style do naszej strony www. Stwórz katalog o nazwie `css` w środku folderu `static`. Następnie utwórz nowy plik o nazwie `blog.css` w katalogu `css`. Gotowa?
 
-    static
-    └─── css
-            blog.css
-
-
-Czas by napisać jakiś styl CSS! Otwórz plik `static/css/blog.css` w Twoim edytorze kodu.
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
 
-Nie będziemy się zanadto zagłębiać w style, ani uczyć się o arkuszach CSS, bo jest to całkiem łatwe i możesz nauczyć się tego samodzielnie po tym warsztacie. Naprawdę rekomendujemy spróbowanie [kursu Codeacademy HTML & CSS][2] by nauczyć się wszystkiego czego potrzebujesz o robieniu ładniejszych stron internetowych.
+Czas, by napisać trochę styli CSS! Otwórz `blog/static/css/blog.css` w Twoim edytorze kodu.
 
- [2]: https://www.codecademy.com/tracks/web
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
 
-Jednak zróbmy chociaż trochę. Może moglibyśmy zmienić kolor naszego nagłówka? Do rozpoznawania kolorów komputery używają specjalnych kodów. Kody te zaczynają się od znaku `#`, po którym następuje 6 znaków. Każdy znak to cyfra (0-9) lub litera (A-F). Możesz znaleźć kody kolorów na przykład tutaj: <http://www.colorpicker.com/>. Możesz również użyć uprzednio [zdefiniowanych kolorów][3], takich jak `red` (czerwony) czy `green ` (zielony)..
+Jednak nauczmy się chociaż troszkę. Może moglibyśmy zmienić kolor naszego nagłówka? Do rozpoznawania kolorów komputery używają specjalnych kodów. Kody te zaczynają się od znaku `#`, po którym następuje 6 liter (A-F) lub cyfr (0-9). Na przykład kod dla koloru niebieskiego to `#0000FF`. Kody dla wielu kolorów możesz znaleźć na stronie: http://www.colorpicker.com/. Możesz również użyć uprzednio [zdefiniowanych kolorów](http://www.w3schools.com/colors/colors_names.asp), takich jak `red` (czerwony) czy `green ` (zielony).
 
- [3]: http://www.w3schools.com/colors/colors_names.asp
+Do `blog/static/css/blog.css` powinnaś dodać następujący kod:
 
-Do pliku `static/css/blog.css` dodaj następujący kod:
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 h1 a {
@@ -81,34 +78,38 @@ h1 a {
 }
 ```
 
-`h1` to selektor CSS. To oznacza, że nadajemy style do każdego elementu `a` znajdującego się w elemencie `h1` (np. kiedy w kodzie mamy coś takiego: `<h1><a href="">link</a></h1>`). W tym przypadku nadajemy mu kolor `#FCA205`, czyli pomarańczowy. Oczywiście kolor jest dowolny!
+`h1` to selektor CSS. Oznacza to, że nasz styl stosujemy do wszystkich elementów `a` znajdujących się w elemencie `h1`. Czyli gdy mamy coś takiego jak `<h1><a href="">link</a></h1>`, styl `h1 a` zostanie użyty. W tym przypadku nadajemy mu kolor `#FCA205`, czyli pomarańczowy. Oczywiście kolor jest dowolny!
 
-W pliku CSS ustalamy styl dla elementów znajdujących się w pliku HTML. Elementy HTML identyfikujemy przez nazwę (n.p. `a`, `h1`, `body`), atrybut `class` lub atrybut `id`. Nazwę klasy lub id ustalasz sama dowolnie. Ta sama nazwa klasy może być przypisana do wielu elementów, ale id musi być unikalne dla całego kodu HTML. Przykładowo następujący tag możemy ostylować w CSS używając nazwy `a`, klasy `external_link` lub id `link_to_wiki_page`:
+W pliku CSS ustalamy styl dla elementów znajdujących się w pliku HTML. Pierwszą metodą rozpoznawania elementu jest jego nazwa. Możesz pamiętać te wszystkie tagi z rozdziału o HTML. Takie rzeczy jak `a`, `h1` i `body` to wszystko przykłady nazw elementów. Elementy rozpoznajemy również po atrybutach `class` lub `id`. Nazwę klasy lub id ustalasz sama dowolnie. Ta sama nazwa klasy może być przypisana do wielu elementów, ale id musi być unikalne dla całego kodu HTML. Dla przykładu, możesz zidentyfikować następujący tag używając nazwy tagu `a`, klasy `external_link` lub po jego id `link_to_wiki_page`:
 
 ```html
 <a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
 ```
 
-O selektorach CSS możesz przeczytać więcej tutaj: [CSS Selectors in w3schools][4].
+Więcej dowiesz się o [selektorach CSS z w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
 
- [4]: http://www.w3schools.com/cssref/css_selectors.asp
+Musimy też powiedzieć naszemu szablonowi HTML, że dodałyśmy trochę styli CSS. Otwórz plik `blog/templates/blog/post_list.html` i dodaj tę linię na jego początku:
 
-Następnie musimy także pokazać naszemu szablonowi HTML że dodaliśmy nowe style CSS. Otwórz plik `blog/templates/blog/post_list.html` i dodaj tę linijkę na samym jego początku:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
 ```
 
-Tym sposobem HTML załaduje nasze style CSS :) Następnie, pomiędzy `<head>` i `</head>`, zaraz za linkami do Boostrapa, dodaj poniższą linijkę. Przeglądarka czyta pliki w kolejności w której je wpiszesz, dzięki temu możemy nadpisać niektóre style Bootstrapa.
+Tutaj ładujemy pliki statyczne :) Pomiędzy tagami `<head>` oraz `</head>`, po liniach linkujących do plików CSS Bootstrapa, dodaj tę linię:
 
-```html  
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
 <link rel="stylesheet" href="{% static 'css/blog.css' %}">
 ```
 
-Właśnie pokazaliśmy naszemu szablonowi gdzie znajduje się nasz plik CSS.
+Przeglądarka czyta pliki w takiej kolejności, w jakiej zostały jej podane, więc musimy się upewnić, że linię dodałyśmy w odpowiednim miejscu. Inaczej kod w naszym pliku może zostać nadpisany przez pliki Bootstrapa. Właśnie pokazaliśmy naszemu szablonowi gdzie znajduje się nasz plik CSS.
 
 Twój plik powinien teraz wyglądać tak:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -132,13 +133,16 @@ Twój plik powinien teraz wyglądać tak:
         {% endfor %}
     </body>
 </html>
+ 
 ```
 
 Ok, teraz zapisz plik i odśwież stronę!
 
 ![Rysunek 14.2](images/color2.png)
 
-Super! Niezła robota. Może damy teraz naszej stronie trochę świeżego powietrza i zwiększymy margines po lewej stronie? Spróbujmy!
+Super! Niezła robota. Może damy teraz naszej stronie trochę przestrzeni i zwiększymy margines po lewej stronie? Spróbujmy!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 body {
@@ -146,19 +150,23 @@ body {
 }
 ```
 
-Dodaj powyższy CSS do twojego pliku, zapisz go i sprawdź jak zadziałał!
+Dodaj powyższe do swoich stylów CSS, zapisz plik i zobacz, jak to zadziałało!
 
 ![Rysunek 14.3](images/margin2.png)
 
 Może zmienimy też rodzaj czcionki w naszym nagłówku? Wklej to do sekcji `<head>` w pliku `blog/templates/blog/post_list.html`:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
 ```
 
-Ta linia zaimportuje czcionkę zwaną *Lobster*, jedną z czcionek Google (<https://www.google.com/fonts>)
+Tak jak wcześniej, sprawdź kolejność i umieść tę linię przed linkiem do `blog/static/css/blog/css`. Podana linia zaimportuje czcionkę pod nazwą *Lobster* z usługi Google Fonts (https://www.google.com/fonts).
 
-Dodaj teraz linię `font-family: "Lobster";` do pliku CSS `static/css/blog.css` wewnątrz bloku deklaracji `h1` (kod deklaracji pomiędzy nawiasami klamrowymi `{` i `}`), a następnie odśwież stronę:
+Znajdź blok deklaracji dla `h1 a` (to jest kod pomiędzy nawiasami `{` i `}`) w pliku CSS `blog/static/css/blog.css`. Dodaj do niego linię `font-family: 'Lobster';` pomiędzy nawiasami, po czym odśwież stronę:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 h1 a {
@@ -171,19 +179,22 @@ h1 a {
 
 Wspaniale!
 
-Jak wspomniano wcześniej, kaskadowe arkusze stylów używają pojęcia klasy, która w zasadzie pozwala Tobie nazwać kod HTML i zastosować style tylko do wybranych części, nie wpływając na pozostałe. To super przydatna opcja w przypadku, gdy posiadasz dwa `div`y które robią zupełnie inne rzeczy (np. nagłówek i div zawierający post), więc nie chcesz żeby wyglądały one tak samo.
+Jak napisałyśmy powyżej, w CSS istnieje koncepcja klas. Pozwalają one nazwać część naszego kodu HTML i aplikować style tylko do tej części, omijając wpływ tych stylów na inne części. To może być super użyteczne! Może masz w dwa divy, które odpowiadają za coś innego (jak nasz header lub post). Klasa pomoże nam, gdy będziemy chciały by wyglądały one inaczej.
 
 Śmiało! Nazwijmy kilka części Twojego kodu HTML. Dodaj klasę nazwaną `page-header` do Twojego `div` który zawiera nagłówek:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="page-header">
     <h1><a href="/">Django Girls Blog</a></h1>
 </div>
 ```
 
-
 Teraz dodaj klasę `post` do Twojego `div` zawierającego post bloga:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="post">
     <p>published: {{ post.published_date }}</p>
@@ -192,8 +203,9 @@ Teraz dodaj klasę `post` do Twojego `div` zawierającego post bloga:
 </div>
 ```
 
+A teraz dodamy bloki deklaracji do selektorów. Selektory zaczynające się od `.` odnoszą się do klas. W Internecie jest wiele wspaniałych tutoriali dotyczących CSS, które pomogą Tobie zrozumieć następujący kod. Na razie po prostu skopiuj i wklej do `blog/static/css/blog.css` poniższy kod:
 
-A teraz dodamy bloki deklaracji do selektorów. Selektory zaczynające się od `.` odnoszą się do klas. W Internecie dostępnych jest mnóstwo świetnych samouczków i instrukcji poświęconych CSS, dzięki którym łatwiej będzie Ci zrozumieć poniższy kod. Póki co po prostu go skopiuj, a następnie wklej w pliku `djangogirls/static/css/blog.css`:
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 .page-header {
@@ -217,7 +229,6 @@ h1, h2, h3, h4 {
 }
 
 .date {
-    float: right;
     color: #828282;
 }
 
@@ -247,6 +258,8 @@ h1, h2, h3, h4 {
 
 Teraz otocz kod HTML wyświetlający posty deklaracjami klas. Zamień to:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     <div class="post">
@@ -259,6 +272,8 @@ Teraz otocz kod HTML wyświetlający posty deklaracjami klas. Zamień to:
 
 w pliku `blog/templates/blog/post_list.html` na to:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="content container">
     <div class="row">
@@ -266,7 +281,7 @@ w pliku `blog/templates/blog/post_list.html` na to:
             {% for post in posts %}
                 <div class="post">
                     <div class="date">
-                        {{ post.published_date }}
+                        <p>published: {{ post.published_date }}</p>
                     </div>
                     <h1><a href="">{{ post.title }}</a></h1>
                     <p>{{ post.text|linebreaksbr }}</p>
@@ -281,10 +296,10 @@ Zapisz te pliki i odśwież swoją stronę.
 
 ![Rysunek 14.4](images/final.png)
 
-Woohoo! Wygląda super, prawda? Kod, który właśnie wkleiliśmy nie jest zbyt trudny, więc zapewne orientujesz się, o co w nim chodzi.
+Woohoo! Wygląda to niesamowicie, prawda? Sprawdź w kodzie, który przed chwilą wkleiłyśmy i poszukaj miejsc, w których dodałyśmy klasy w HTML oraz użyłyśmy ich w CSS. Gdzie dokonałabyś zmiany, gdybyś chciała, by data była turkusowa?
 
-Nie bój się pomajstrować trochę przy CSS, pozmieniać niektóre rzeczy. Jeżeli coś zepsujesz – nie martw się, zawsze możesz cofnąć!
+Nie bój się trochę pomajstrować w CSS próbując zmienić niektóre rzeczy. Zabawa z CSS pozwoli Ci lepiej zrozumieć, co różne rzeczy robią. Niczym się nie przejmuj, jeżeli coś zepsujesz - zawsze przecież można cofnąć zmiany!
 
-Tak czy owak, warto zrobić darmowy kurs CSS & HTML na [Codecademy][2] w ramach “powarsztatowej pracy domowej”, żeby dowiedzieć się wszystkiego czego potrzebujesz do upiększania swoich stron przy użyciu CSS.
+Naprawdę zalecamy wzięcie udziału w darmowym kursie online [Codeacademy HTML & CSS](https://www.codecademy.com/tracks/web). Pomoże on Tobie nauczyć się wszystkiego, czego potrzebujesz by upiększyć twoje strony za pomocą CSS.
 
-Gotowa na następny rozdział?! :)
+Gotowa na następny rozdział?! :)
\ No newline at end of file
diff --git a/pl/deploy/README.md b/pl/deploy/README.md
index e7835188d79..55249d9deb7 100755
--- a/pl/deploy/README.md
+++ b/pl/deploy/README.md
@@ -2,25 +2,17 @@
 
 > **Uwaga:** Niniejszy rozdział może być miejscami dość trudny. Bądź dzielna i przestudiuj go do końca; wdrażanie jest ważną częścią pracy nad stroną. Celowo umieściłyśmy go tutaj, aby Twój mentor był w stanie pomóc Ci przejść przez skomplikowany proces opublikowania Twojej strony w sieci. Oznacza to, że możesz wciąż ukończyć tutorial samodzielnie, jeśli zabraknie Ci czasu.
 
-Do tej pory Twoja strona była dostępna tylko na Twoim komputerze. Teraz nauczysz się, jak ją wdrożyć! Wdrożenie to inaczej opublikowanie Twojej aplikacji w Internecie, dzięki czemu możesz w końcu pokazać ją innym ludziom :).
+Do teraz twoja strona była dostępna tylko na twoim komputerze. Właśnie teraz nauczymy się, jak ją wdrożyć! Wdrożenie to inaczej opublikowanie Twojej aplikacji w internecie, dzięki czemu możesz w końcu pokazać ją innym ludziom. :)
 
-Jak już wiesz, strona internetowa musi znajdować się na jakimś serwerze. Istnieje wielu dostawców serwerów w Internecie (tzw. firm hostingowych). Skorzystamy z takiego, którego proces wdrażania jest stosunkowo prosty: [PythonAnywhere][1]. PythonAnywhere jest darmowy dla małych aplikacji, które nie mają zbyt dużo odwiedzających, więc na początek na pewno wystarczy.
+Jak już wiesz, strona internetowa musi znajdować się na jakimś serwerze. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
- [1]: https://pythonanywhere.com/
+Drugą zewnętrzną usługą, jakiej będziemy używać jest [GitHub](https://www.github.com), który przechowuje kod. Istnieją inne usługi, ale w dzisiejszych czasach prawie wszyscy programiści mają konto na GitHubie - i Ty dzisiaj do nich dołączysz!
 
-Drugą zewnętrzną usługą, jakiej będziemy używać jest [GitHub][2], który przechowuje kod. Istnieją inne usługi, ale w dzisiejszych czasach prawie wszyscy programiści mają konto na GitHubie - i Ty dzisiaj do nich dołączysz!
-
- [2]: https://www.github.com
-
-GitHub będzie takim miejscem pośrednim, którego użyjemy, by przetransportować Twój kod między Twoim komputerem a serwerem PythonAnywhere i z powrotem.
+Te trzy miejsca będą dla Ciebie bardzo ważne. Twój lokalny komputer będzie miejscem, w którym będziesz rozwijać i testować swoją aplikację. Kiedy będziesz zadowolona ze swoich zmian, kod swojego programu umieścisz na GitHubie. Twoja strona za to będzie dostępna na PythonAnywhere i wszystkie zmiany będziesz tam ściągał ze swojej kopii kodu na GitHubie.
 
 # Git
 
-Git jest "systemem kontroli wersji", którego używa wielu programistów. Program ten śledzi zmiany w plikach na przestrzeni czasu, dzięki czemu możesz później przywracać wybrane wersje tych plików. Działa trochę jak funkcja "śledź zmiany" w Microsoft Word, ale jest o wiele bardziej potężny.
-
-## Instalacja Gita
-
-> **Uwaga** Jeśli już wcześniej przeszłaś kroki instalacyjne, nie musisz ich powtarzać - przejdź od razu do następnego podrozdziału, żeby stworzyć repozytorium Git.
+> **Uwaga** Jeżeli wykonałaś już wszystkie kroki instalacji, nie ma potrzeby ich powtarzać - możesz przeskoczyć do następnej sekcji i zacząć tworzyć repozytorium w Gicie.
 
 {% include "/deploy/install_git.md" %}
 
@@ -28,50 +20,61 @@ Git jest "systemem kontroli wersji", którego używa wielu programistów. Progra
 
 Git śledzi zmiany dokonywane w zbiorze plików w czymś, co nazywamy repozytorium kodu (albo po prostu "repo", żeby było krócej). Stwórzmy takie repozytorium dla naszego projektu. Otwórz konsolę w katalogu `djangogirls` i wpisz następujące polecenia:
 
-> **Uwaga** Zanim utworzysz repozytorium, sprawdź w jakim katalogu obecnie się znajdujesz, wpisujac `pwd` (OSX/Linux) lub `cd` (Windows). Powinnaś się znajdować w katalogu `djangogirls`.
+> **Uwaga** Sprawdź bieżący katalog roboczy za pomocą polecenia `pwd` (Mac OS X/Linux) lub `cd` (Windows) przed inicjalizacją repozytorium. Powinnaś się znajdować w katalogu `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
 
     $ git init
     Initialized empty Git repository in ~/djangogirls/.git/
     $ git config --global user.name "Twoja Nazwa Uzytkownika"
     $ git config --global user.email ty@adres.pl
+    
 
-
-Inicjalizacja repozytorium to coś, co będziesz musiała zrobić tylko raz na dany projekt (i nie będziesz musiała już wpisywać swojej nazwy użytkownika i adresu email).
+Inicjalizacja repozytorium gita jest jednorazowym zadaniem dla każdego projektu (nie będzie więcej potrzeby, byś ponownie podawał nazwę użytkownika i email).
 
 Git będzie śledzić zmiany we wszyskich plikach i folderach w tym katalogu, ale zwróć uwagę, że znajdują się w nim pewne pliki, których zmiany chcemy ignorować. By to zrobić, musimy utworzyć w tym katalogu plik, który nazwiemy `.gitignore`. Otwórz swój edytor kodu i utwórz nowy plik o następującej treści:
 
-```
-*.pyc
-__pycache__
-myvenv
-db.sqlite3
-.DS_Store
-```
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+I zapisz go jako `.gitignore` w katalogu "djangogirls".
 
-Zapisz go jako `.gitignore` w folderze najwyższego poziomu "djangogirls".
+> **Uwaga** Ta kropka na początku nazwy pliku jest ważna! Jeżeli masz problem podczas tworzenia tego pliku (MacOS ma na przykład problem z tworzeniem plików zaczynających się od kropki za pomocą Findera), to spróbuj użyć polecenia "Zapisz jako" w swoim edytorze, to akurat jest niezawodne.
+> 
+> **Uwaga** Jednym z plików, który wyszczególniliśmy w `.gitignore` to `db.sqlite3`. Ten plik to twoja lokalna baza danych, gdzie będą się znajdować wszystkie artykuły z twojego bloga. Nie chcemy dodawać tego pliku do repozytorium, ponieważ twoja strona na PythonAnywhere będzie korzystać z innnej bazy danych. Tą bazą może być SQLite, tak jak na twojej maszynie deweloperskiej, ale najczęściej będziesz korzystać z bazy MySQL, która radzi sobie z dużą większą ilością odwiedzających. W każdym razie, zignotowanie twojej bazy SQLite w kopii na GitHubie, oznacza że wszystkie artykuły, które stworzyłaś do tej pory zostaną i będą widoczne tylko lokalnie, i będziemy musiały dodać je ponownie na środowisku produkcyjnym. Powinnaś myśleć o swojej lokalnej bazie danych jako o dobrym placu zabaw, na którym możesz testować różne rzeczy nie bojąc się, że skasujesz prawdziwe artykuły ze swojego bloga.
 
-> **Uwaga** Ta kropka na początku nazwy pliku jest ważna! Jeśli masz jakieś problemy z utworzeniem tego pliku (na przykład, jeśli pracujesz na Macu to Finder broni się przed zapisywaniem plików, które zaczynają się od kropki) to użyj "Zapisz jako" w swoim edytorze, działa bezbłędnie.
+Dobrym nawykiem jest wpisywanie polecenia `git status` zanim wpiszesz `git add` albo gdy nie jesteś pewna co się zmieniło. Pozwala ono zabezpieczyć się przed niespodziankami takimi, jak chociażby dodanie lub skomitowanie błędnego pliku. Polecenie `git status` zwraca informację o wszystkich nieśledzonych/zmienionych/zaplanowanych do najbliższego commita plików, statusie brancha i wiele innych. Wynik powinien wyglądać podobnie do następującego:
 
-Dobrym nawykiem jest wpisywanie polecenia `git status` zanim wpiszesz `git add` albo gdy nie jesteś pewna co się zmieniło. To powinno cię ustrzec przed nieprzyjemnymi niespodziankami, takimi jak dodanie lub zmienienie nieprawidłowych plików. Polecenie `git status` zwraca między innymi informacje o plikach, które zostały dodane/zmienione/usunięte. Po wpisaniu polecenia powinnaś zobaczyć coś podobnego do tego:
+{% filename %}command-line{% endfilename %}
 
     $ git status
     On branch master
-
+    
     Initial commit
-
+    
     Untracked files:
       (use "git add <file>..." to include in what will be committed)
-
+    
             .gitignore
             blog/
             manage.py
             mysite/
-
+    
     nothing added to commit but untracked files present (use "git add" to track)
-
+    
 
 I na końcu zapisujemy zmiany. Przejdź do konsoli i wykonaj poniższe polecenia:
 
+{% filename %}command-line{% endfilename %}
+
     $ git add --all .
     $ git commit -m "My Django Girls app, first commit"
      [...]
@@ -79,210 +82,151 @@ I na końcu zapisujemy zmiany. Przejdź do konsoli i wykonaj poniższe polecenia
      create mode 100644 .gitignore
      [...]
      create mode 100644 mysite/wsgi.py
+     ```
+    
+    ## Wypychanie kodu na GitHuba
+    
+    Przejdź na [GitHub.com](https://www.github.com) i załóż nowe, darmowe konto użytkonika. (Jeśli już to wcześniej zrobiłaś to super!). 
+    
+    Potem utwórz nowe repozytorium i nadaj mu nazwę "my-first-blog" (ang. "mój pierwszy blog"). Nie zaznaczaj opcji "initialize with a README", nie zmieniaj nic przy polach .gitignore (powinno być None, same załatwiliśmy tę sprawę wcześniej) i licencja też powinna być ustawiona jako None.
+    
+    &lt;img src="images/new_github_repo.png" /&gt;
+    
+    &gt; **Uwaga** Nazwa my-first-blog jest ważna - mogłabyś wybrać jakąś inną, ale będziemy tej nazwy używać wiele razy i za każdym razem musiałabyś pamiętać, żeby zastępować "my-first-blog" swoją wybraną nazwą. Z tego powodu najłatwiej będzie jak użyjesz nazwy 'my-first-blog'.
+    
+    Na następnej stronie wyświetli Ci się adres URL do klonowania Twojego repozytorium. Wybierz wersję "HTTPS" i skopiuj ją. Niedługo będziemy tego adresu potrzebować.
+    
+    &lt;img src="images/github_get_repo_url_screenshot.png" /&gt;
+    
+    Teraz musimy podpiąć repozytorium Git na komputerze do tego na GitHubie.
+    
+    Wpisz następujące polecenie do konsoli (Zamień '&lt;your-github-username&gt;' na swoją nazwę użytkownika, którą podałaś przy tworzeniu konta na GitHubie, ale bez nawiasów ostrokątnych, czyli "<" i ">"):
+    
+    {% filename %}command-line{% endfilename %}
+    
 
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
 
-## Przesyłanie naszego kodu do GitHuba
-
-Wejdź na stronę [GitHub.com][2] i utwórz nowe darmowe konto. (Jeśli już to wcześniej zrobiłaś to super!)
-
-Potem utwórz nowe repozytorium i nadaj mu nazwę "my-first-blog" (ang. "mój pierwszy blog") Nie zaznaczaj opcji "initialise with a README", nie zmieniaj nic przy polach .gitignore (powinno być None, same załatwiliśmy tę sprawę wcześniej). Licencja też powinna być ustawiona jako None.
-
-![][3]
-
- [3]: images/new_github_repo.png
-
-> **Uwaga** Nazwa `my-first-blog` jest ważna -- mogłabyś wybrać jakąś inną, ale będziemy tej nazwy używać wiele razy i za każdym razem musiałabyś pamiętać, żeby zastępować "my-first-blog" swoją wybraną nazwą. Z tego powodu najłatwiej będzie jak użyjesz nazwy `my-first-blog`.
-
-Na następnej stronie wyświetli Ci się adres URL do klonowania Twojego repozytorium. Wybierz wersję "HTTPS" i skopiuj ją. Niedługo będziemy tego adresu potrzebować.
-
-![][4]
-
- [4]: images/github_get_repo_url_screenshot.png
-
-Teraz musimy podpiąć repozytorium Git na komputerze do tego na GitHubie.
-
-Wpisz następujące polecenie do konsoli (Zamień `<your-github-username>` na swoją nazwę użytkownika, którą podałaś przy tworzeniu konta na GitHubie, ale bez nawiasów ostrokątnych, czyli "<" i ">"):
-
-    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
-    $ git push -u origin master
-
-
-Wpisz swoją nazwę użytkownika GitHub oraz hasło, a wtedy powinnaś zobaczyć coś takiego:
-
-    Username for 'https://github.com': hjwp
-    Password for 'https://hjwp@github.com':
-    Counting objects: 6, done.
-    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
-    Total 3 (delta 0), reused 0 (delta 0)
-    To https://github.com/hjwp/my-first-blog.git
-     * [new branch]      master -> master
-    Branch master set up to track remote branch master from origin.
-
-
-<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extention -->
-
-Twój kod jest teraz na GitHubie. Możesz to sprawdzić! Zważ, że znajduje się w wyśmienitym towarzystwie - [Django][5], [kurs Django Girls][6] i wiele innych świetnych projektów open-source trzyma swój kod na GitHubie :)
-
- [5]: https://github.com/django/django
- [6]: https://github.com/DjangoGirls/tutorial
-
-# Wdrażanie bloga na PythonAnywhere
-
-> **Uwaga** Możliwe, że już wcześniej utworzyłaś konto na PythonAnywhere, jeśli przeszłaś przez wszystkie kroki w rozdziale instalacyjnym - nie ma potrzeby, byś robiła to drugi raz.
-
-{% include "/deploy/signup_pythonanywhere.md" %}
-
-## Umieszczanie naszego kodu na PythonAnywhere
-
-Kiedy już zakończysz tworzenie konta na PythonAnywhere, zostaniesz przeniesiona do strony nawigacyjnej albo do strony "Konsole" (ang. "Consoles"). Wybierz opcję, by włączyć konsolę "Bash" -- to jest PythonAnywhere'owa wersja konsoli, którą masz na swoim komputerze.
-
-> **Uwaga** PythonAnywhere jest oparty na Linuksie, więc jeśli pracujesz na Windowsie to konsola będzie wyglądać trochę inaczej niż na Twoim komputerze.
-
-Umieśćmy nasz kod z GitHuba na PythonAnywhere. Zrobimy to "klonując" (ang. "clone") nasze repozytorium. Wpisz następujące polecenie do konsoli w PythonAnywhere (nie zapomnij zamienić `<your-github-username>` na swoją nazwę użytkownika):
-
-    $ git clone https://github.com/<your-github-username>/my-first-blog.git
-
-
-To polecenie ściągnie kopię twojego kodu na PythonAnywhere. By to sprawdzić, wpisz `tree my-first-blog`:
-
-    $ tree my-first-blog
-    my-first-blog/
-    ├── blog
-    │   ├── __init__.py
-    │   ├── admin.py
-    │   ├── migrations
-    │   │   ├── 0001_initial.py
-    │   │   └── __init__.py
-    │   ├── models.py
-    │   ├── tests.py
-    │   └── views.py
-    ├── manage.py
-    └── mysite
-        ├── __init__.py
-        ├── settings.py
-        ├── urls.py
-        └── wsgi.py
-
-
-### Tworzenie środowiska wirtualnego na PythonAnywhere
-
-Tak samo jak to robiłaś na swoim komputerze, możesz stworzyć środowisko wirtualne na PythonAnywhere. Polecania poniżej nieco się [różnią](https://www.reddit.com/r/learnpython/comments/4hsudz/pyvenv_vs_virtualenv/), od tych, które wykonałaś na swoim komputerze, ponieważ serwer na którym je wykonasz ma zainstalowane inne oprogramowanie. W konsoli Bash wpisz:
-
-    $ cd my-first-blog
-
-    $ virtualenv --python=python3.4 myvenv
-    Running virtualenv with interpreter /usr/bin/python3.4
-    [...]
-    Installing setuptools, pip...done.
-
-    $ source myvenv/bin/activate
-
-    (myvenv) $  pip install django==1.8.2 whitenoise
-    Collecting django
-    [...]
-    Successfully installed django-1.8.2 whitenoise-2.0
-
-
-> **Uwaga** Polecenie `pip install` może trochę potrwać. Cierpliwości, cierpliwości! Jednak jeśli trwa to dłużej niż 5 min, coś jest nie tak. Spytaj swojego mentora.
-
-<!--TODO: think about using requirements.txt instead of pip install.-->
-
-### Pobieranie plików statycznych.
-
-Zastanawiałaś się o co chodziło z "whitenoise"? Jest to narzędzie dla tak zwanych "plików statycznych". Pliki statyczne to pliki, które nie zmieniają się zbyt często, takie jak pliki HTML czy CSS. Zachowują się one inaczej na serwerach niż na naszych własych komputerach i dlatego potrzebujemy takich narzędzi jak "whitenoise", by je obsługiwać.
-
-Dowiemy się więcej o plikach statycznych później, kiedy będziemy zmieniać pliki CSS naszej strony.
-
-Na tę chwilę musimy tylko uruchomić polecenie `collectstatic` na serwerze. Polecenie to mówi Django, by zebrał wszystkie pliki statyczne, których potrzebuje na serwerze. W tym momencie chodzi głównie o pliki, które upiększają nam panel admina.
-
-    (myvenv) $ python manage.py collectstatic
-
-Będziemy z powyższego polecenia korzystać za każdym razem gdy dodamy nowe pliki statyczne. Przy kolejnych uruchomieniach tego polecenia, najprawdopodobniej zobaczysz poniższe ostrzeżenie:
-
-    You have requested to collect static files at the destination
-    location as specified in your settings:
-
-        /home/edith/my-first-blog/static
-
-    This will overwrite existing files!
-    Are you sure you want to do this?
-
-    Type 'yes' to continue, or 'no' to cancel: yes
-
-
-Wpisz "yes" i niech hula maszyna! Czy to nie piękne, jak komputer wypluwa z siebie dłuugie strony tekstu? Ja czasami wydaję ciche dźwięki, które mi się z tym kojarzą. Pip, pip, piiiip...
-
-    Copying '/home/edith/my-first-blog/myvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/actions.min.js'
-    Copying '/home/edith/my-first-blog/myvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/inlines.min.js'
-    [...]
-    Copying '/home/edith/my-first-blog/myvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/changelists.css'
-    Copying '/home/edith/my-first-blog/myvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/base.css'
-    62 static files copied to '/home/edith/my-first-blog/static'.
-
-
-### Tworzenie bazy danych na PythonAnywhere
-
-Oto kolejna różnica między Twoim komputerem a serwerem: serwer używa innej bazy danych. Tak więc możesz mieć inne konta użytkowników i posty na serwerze, a inne na swoim komputerze.
-
-Możemy zainicjować bazę danych na serwerze dokładnie w ten sam sposób, w jaki zrobiliśmy to na swoim komputerze, poleceniami `migrate` i `createsuperuser`:
-
-    (myvenv) $ python manage.py migrate
-    Operations to perform:
-    [...]
-      Applying sessions.0001_initial... OK
-
-
-    (myvenv) $ python manage.py createsuperuser
-
-
-## Publikowanie naszego bloga jako aplikacji internetowej
-
-Nasz kod znajduje się na PythonAnywhere, nasze środowisko wirtualne działa, mamy nasze pliki statyczne i zainicjowaliśmy bazę danych. Jesteśmy gotowi opublikować naszą aplikację internetową!
-
-Kliknij na logo PythonAnywhere, by wrócić do panelu nawigacyjnego, a potem kliknij na zakładkę **Web**. Następnie kliknij **Add a new web app** (czyli po polsku: "Dodaj nową aplikację internetową").
-
-Po potwierdzeniu nazwy domeny, w oknie dialogowym wybierz konfigurację ręczną, czyli po angielsku **manual configuration** (*nie* opcję "Django"). Następnie wybierz **Python 3.4** i kliknij przycisk Dalej, aby zakończyć.
-
-> **Uwaga** Upewnij się, że wybrałaś opcję "Ręczna konfiguracja", nie "Django". Jesteśmy zbyt fajne, aby używać domyślnej konfiguracji Django na PythonAnywhere ;-)
+    <br />Wpisz swoją nazwę użytkownika GitHub oraz hasło, a wtedy powinnaś zobaczyć coś takiego:
+    
+    {% filename %}command-line{% endfilename %}
+    
 
-### Ustawienie wirtualnego środowiska
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
 
-Zostaniesz przeniesiony do strony konfiguracji Twojej aplikacji internetowej, czyli do miejsca, gdzie musisz się udać, gdy chcesz zrobić zmiany w swojej aplikacji na serwerze.
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
 
-![][7]
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Możesz to sprawdzić!  Zauważ, że znajduje się w wyśmienitym towarzystwie - [Django](https://github.com/django/django), [kurs Django Girls](https://github.com/DjangoGirls/tutorial) i wiele innych świetnych projektów open-source trzyma swój kod na GitHubie. :)
+    
+    # Wdrażanie bloga na PythonAnywhere
+    
+    &gt; **Uwaga** Możliwe, że już wcześniej utworzyłaś konto na PythonAnywhere, jeśli przeszłaś przez wszystkie kroki w rozdziale instalacyjnym - nie ma potrzeby, byś robiła to drugi raz.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ##Umieszczanie naszego kodu na PythonAnywhere
+    
+    Kiedy już zakończysz tworzenie konta na PythonAnywhere, zostaniesz przeniesiona do strony nawigacyjnej albo do strony "Konsole" (ang. "Consoles"). Wybierz opcję, by włączyć konsolę "Bash" - to jest PythonAnywhere'owa wersja konsoli, którą masz na swoim komputerze.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Uwaga** PythonAnywhere jest oparty na Linuksie, więc jeśli pracujesz na Windowsie to konsola będzie wyglądać trochę inaczej niż na Twoim komputerze.
+    
+    Umieśćmy nasz kod z GitHuba na PythonAnywhere. Zrobimy to "klonując" (ang. "clone") nasze repozytorium. Wpisz następujące polecenie do konsoli w PythonAnywhere (nie zapomnij zamienić '&lt;your-github-username&gt;' na swoją nazwę użytkownika):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
- [7]: images/pythonanywhere_web_tab_virtualenv.png
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
 
-W sekcji dotyczącej środowiska wirtualnego ("Virtualenv") kliknij na czerwone pole z napisem "Enter the path to a virtualenv" i wpisz: `/home/<your-username>/my-first-blog/myvenv/`. Kliknij w niebieski prostokąt obok, aby zapisać ścieżkę przed przejściem do dalszej części.
+    <br />To polecenie ściągnie kopię twojego kodu na PythonAnywhere. By to sprawdzić, wpisz 'tree my-first-blog':
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-> **Uwaga** Podmień nazwę użytkownika na właściwą. Jeśli się pomylisz, PythonAnywhere da Ci małe ostrzeżenie.
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
 
-### Konfiguracja pliku WSGI
+    <br /><br />### Tworzenie środowiska wirtualnego na PythonAnywhere
+    
+    Tak samo jak to robiłaś na swoim komputerze, możesz stworzyć środowisko wirtualne na PythonAnywhere. W konsoli Bash wpisz:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-Django używa "protokołu WSGI", standardu serwowania stron internetowych za pomocą Pythona, którego wspiera PythonAnywhere. Musimy zedytować plik konfiguracyjny WSGI tak, aby PythonAnywhere rozpoznawał naszego Django bloga.
+$ cd my-first-blog
 
-Kliknij na link "WSGI configuration file" (w sekcji "Code" w górnej części strony - będzie nazywać się mniej więcej tak `/var/www/<twoja-nazwa-uzytkownika>_pythonanywhere_com_wsgi.py`), a zostaniesz przeniesiona do edytora.
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
 
-Skasuj całą zawartość pliku i zastąp ją następującym tekstem:
+$ source myvenv/bin/activate
 
-```python
-import os
-import sys
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
 
-path = '/home/<your-username>/my-first-blog'  # use your own username here
-if path not in sys.path:
-    sys.path.append(path)
+    <br /><br />&gt; **Uwaga** Polecenie 'pip install' może trochę potrwać.  Cierpliwości, cierpliwości!  Jednak jeśli trwa to dłużej niż 5 min, coś jest nie tak.  Spytaj swojego mentora.
+    
+    &lt;!--TODO: pomyśl o użyciu requirements.txt zamiast pip install.--&gt;
+    
+    ###Tworzenie bazy danych na PythonAnywhere
+    
+    Oto kolejna różnica między Twoim komputerem a serwerem: serwer używa innej bazy danych. Tak więc możesz mieć inne konta użytkowników i posty na serwerze, a inne na swoim komputerze.
+    
+    Możemy zainicjować bazę danych na serwerze dokładnie w ten sam sposób, w jaki zrobiliśmy to na swoim komputerze, poleceniami 'migrate' i 'createsuperuser':
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
 
-from django.core.wsgi import get_wsgi_application
-from whitenoise.django import DjangoWhiteNoise
-application = DjangoWhiteNoise(get_wsgi_application())
-```
+    <br />## Publikowanie naszego bloga jako aplikacji internetowej
+    
+    Nasz kod znajduje się na PythonAnywhere, nasze środowisko wirtualne działa, i nasza baza danych jest zainicjowana. Jesteśmy gotowi opublikować naszą aplikację internetową!
+    
+    Kliknij na logo PythonAnywhere, by wrócić do panelu nawigacyjnego, a potem kliknij na zakładkę **Web**. Następnie kliknij **Add a new web app** (czyli po polsku: "Dodaj nową aplikację internetową").
+    
+    Po potwierdzeniu nazwy domeny, w oknie dialogowym wybierz konfigurację ręczną, czyli po angielsku **manual configuration** (*nie* opcję "Django"). Następnie wybierz **Python 3.6** i kliknij przycisk Dalej, aby zakończyć.
+    
+    &gt; **Uwaga** Upewnij się, że wybrałaś opcję "Ręczna konfiguracja", nie "Django". Jesteśmy zbyt fajne, aby używać domyślnej konfiguracji Django na PythonAnywhere. ;-)
+    
+    ### Ustawienie wirtualnego środowiska
+    
+    Zostaniesz przeniesiony do strony konfiguracji PythonAnywhere dla Twojej aplikacji internetowej, czyli do miejsca, gdzie musisz się udać, gdy chcesz zrobić zmiany w swojej aplikacji na serwerze.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    W sekcji dotyczącej środowiska wirtualnego ("Virtualenv") kliknij na czerwone pole z napisem "Enter the path to a virtualenv" i wpisz: '/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/'. Kliknij w niebieski prostokąt obok, aby zapisać ścieżkę przed przejściem do dalszej części.
+    
+    &gt;**Uwaga** Zastąp własną nazwę użytkownika PythonAnywhere właściwą. Jeśli się pomylisz, PythonAnywhere da Ci małe ostrzeżenie.
+    
+    
+    ### Konfiguracja pliku WSGI
+    
+    Django używa "protokołu WSGI", standardu serwowania stron internetowych za pomocą Pythona, którego wspiera PythonAnywhere. Musimy zedytować plik konfiguracyjny WSGI tak, aby PythonAnywhere rozpoznawał naszego Django bloga.
+    
+    Kliknij na link "WSGI configuration file" (w sekcji "Code" w górnej części strony - będzie nazywać się mniej więcej tak '/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py'), i zostaniesz przeniesiona do edytora.
+    
+    Skasuj całą zawartość pliku i zastąp ją następującym tekstem:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
 
-> **Uwaga** Nie zapomnij zastąpić wszystkich wystąpień `<your-username>` swoją nazwą użytkownika.
+Zadaniem tego pliku jest powiedzenie PythonAnywhere gdzie znajduje się nasza aplikacja i jaka jest nazwa naszego pliku z ustawieniami Django.
 
-Zadaniem tego pliku jest powiedzenie PythonAnywhere gdzie znajduje się nasza aplikacja i jaka jest nazwa naszego pliku z ustawieniami Django. Również zajmuje się poznanym wcześniej narzędziem "whitenoise", służącym do obsługi plików statycznych.
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. Dowiemy się więcej o plikach statycznych później, kiedy będziemy zmieniać pliki CSS naszej strony.
 
 Naciśnij **Zapisz** i potem wróć do karty **Web**.
 
@@ -290,65 +234,24 @@ Mamy wszystko gotowe! Naciśnij duży zielony przycisk **Reload** ("Odśwież"),
 
 ## Porady dotyczące debugowania
 
-Całkiem prawdopodobne, że zamiast swojej strony zobaczysz błąd.
-Pierwszym miejscem, w którym powinnaś poszukać informacji o tym, co się stało jest twój **dziennik błędów** (ang. "error log"). Znajdziesz do niego link na karcie [Web][8] w PythonAnywhere. Sprawdź czy znajdują się tam jakieś komunikaty o błędach; te najświeższe znajdują się na samym dole strony. 
-
-Najprawdopodobniej zobaczysz tam informację, że adres pod którym znajduje się Twoja strona nie został rozpoznany przez Twoją aplikację:
-
-    Invalid HTTP_HOST header: '<your-username>.pythonanywhere.com'. You may need to add '<your-username>.pythonanywhere.com' to ALLOWED_HOSTS.
-
-Ze względów bezpieczeństwa, Twoja aplikacja odpowiada tylko na żądania adresowane do niej (tak jak Ty nie czytasz wiadomości nieadresowanych do Ciebie, z obawy, że to oszustwo).
-Musisz pomóc jej zrozumieć, jak nazywa się jej nowy dom. Na swoim komputerze otwórz plik `settings.py` znajdujący się w katalogu `mysite`. Zobaczysz w nim powód całego zamieszania - pustą tablicę:
-
-    ALLOWED_HOSTS = []
- 
-Teraz, kiedy masz już konto na PythonAnywhere i znasz swój adres, możesz go tu wpisać:
-
-    ALLOWED_HOSTS = ['<twoja-nazwa-użytkownika>.pythonanywhere.com']
-
-Zwróć uwagę, żeby podać swoją nazwę użytkownika na PythonAnywhere w miejsce `<twoja-nazwa-użytkownika>` oraz, żeby nie wpisać "https://" ani "/" :)
-Gdy zapiszesz zmiany w `settings.py` na swoim komputerze, trzeba wykonać jeszcze ponowne wdrożenie, aby znalazły się one na serwerze, co wymaga poniższych kroków.
-
-Najpierw upewnij się, że zmieniłaś tylko plik `settings.py`:
-
-    $ git status
-
-Następnie zapisz te zmiany w repozytorium:
-
-    $ git add --all
-    $ git commit -m "Added my server to ALLOWED_HOSTS"
-
-Po czym "wypchnij" zmiany do GitHuba:
-
-    $ git push
-    
-Teraz przejdź do konsoli Bash w PythonAnywhere i "ściągnij" te zmiany z GitHuba:
-
-    $ cd ~/my-first-blog
-    $ git pull
-   
-Na koniec w zakładce [Web][8] kliknij w "Reload".
-
-Inne typowe problemy to:
-
- [8]: https://www.pythonanywhere.com/web_app_setup/
+Jeśli odwiedzając swoją stronę zobaczysz błąd, to pierwszym miejscem, w którym powinnaś poszukać informacji o tym, co się stało jest twój **dziennik błędów** (ang. "error log"). Znajdziesz do niego link na karcie [Web](https://www.pythonanywhere.com/web_app_setup/) w PythonAnywhere. Sprawdź czy znajdują się tam jakieś komunikaty o błędach; te najświeższe znajdują się na samym dole strony. Typowe problemy to:
 
-*   Pominięcie jednego z kroków, które powinnyśmy zrobić w konsoli: stworzenie środowiska wirtualnego, aktywowanie go, instalacja Django, pobranie plików statycznych, migracja bazy danych.
+- Nie wykonanie jednego z kroków, które wcześniej wykonałyśmy w konsoli: stworzenie środowiska wirtualnego, aktywowanie go, instalacja w nim Django, migracja bazy danych.
 
-*   Pomyłka w ścieżce do środowiska wirtualnego w zakładce [Web][8] -- jeśli coś jest nie tak, wyświetli Ci się tam mały czerwony komunikat błędu.
+- Błąd w ścieżce do środowiska wirtualnego w zakładce Web - przeważnie, w przypadku błędu, będzie tam na czerwono mała informacja o problemie.
 
-*   Zrobienie błędu w pliku konfiguracyjnym WSGI -- czy dobrze zapisałaś ścieżkę do katalogu my-first-blog?
+- Błąd w pliku konfiguracyjny WSGI - wpisałaś poprawną ścieżkę do swojego katalogu my-first-blog?
 
-*   Czy wybrałaś tę samą wersję Pythona dla Twojego środowiska wirtualnego, co dla aplikacji internetowej? Obie powinny być 3.4.
+- Czy wybrałaś tę samą wersję Pythona dla Twojego środowiska wirtualnego, co dla aplikacji internetowej? Obie powinny być 3.6.
 
-*   Istnieje kilka [ogólnych porad dotyczących debugowania na PythonAnywhere wiki][9].
-
- [9]: https://www.pythonanywhere.com/wiki/DebuggingImportError
+Są tam też dostępne [generalne porady odnośnie debugowania na wiki PythonAnywhere](https://www.pythonanywhere.com/wiki/DebuggingImportError).
 
 I pamiętaj, Twój mentor jest tutaj, by Ci pomóc!
 
-# Twoja strona jest w Internecie!
+# Twoja strona jest w internecie!
+
+Standardowa strona dla twojej witryny powinna brzmieć "It worked!", tak jak na twoim komputerze lokalnym. Jeśli dodasz `/admin/` na koniec swojego adresu URL, powinnaś się przenieść do panelu admina. Zaloguj się swoim loginem i hasłem, a wtedy zobaczysz, że jesteś w stanie dodawać nowe posty na serwerze.
 
-Teraz na Twojej stronie w Internecie powinny widniać słowa "Welcome to Django", dokładnie tak samo jak gdy otwierasz stronę znajdującą się na dysku lokalnym. Jeśli dodasz `/admin/` na koniec swojego adresu URL, powinnaś się przenieść do panelu admina. Zaloguj się swoim loginem i hasłem, a wtedy zobaczysz, że jesteś w stanie dodawać nowe posty na serwerze.
+Jak już stworzysz kilka artykułów, możesz wrócić do swojego lokalnego środowiska (nie do PythonAnywhere). Od teraz powinnaś pracować na swoim lokalnym komputerze, jeżeli będziesz chciała dokonać zmian na stronie. To częsty sposób pracy w rozwijaniu stron www - wprowadzaj zmiany lokalnie, wypychaj je na GitHuba i zaciągaj na swój internetowy serwer www. Pozwala to na pracę i eksperymentowanie bez obawy, że zepsujesz działającą stronę. Całkiem nieźle, co nie?
 
-*Przybij piątkę!* Wdrażanie to jedna z najtrudniejszych i najbardziej skomplikowanych części projektowania stron internetowych. Często całemu zespołowi ludzi zajmuje to kilka dni zanim wszystko zacznie działać. Ale Tobie tak szybko udało się wdrożyć swoją stronę, jest ona w prawdziwym Internecie!
+*Przybij piątkę!* Wdrażanie to jedna z najtrudniejszych i najbardziej skomplikowanych części projektowania stron internetowych. Często całemu zespołowi ludzi zajmuje to kilka dni zanim wszystko zacznie działać. Ale Tobie tak szybko udało się wdrożyć swoją stronę, jest ona w prawdziwym internecie!
\ No newline at end of file
diff --git a/pl/deploy/install_git.md b/pl/deploy/install_git.md
index a5af0f2abb0..7f049d51d09 100755
--- a/pl/deploy/install_git.md
+++ b/pl/deploy/install_git.md
@@ -1,29 +1,52 @@
-<!--sec data-title="Windows" data-id="git_win" data-collapse=true ces-->
+Git jest "systemem kontroli wersji", którego używa wielu programistów. Program ten śledzi zmiany w plikach na przestrzeni czasu, dzięki czemu możesz później przywracać wybrane wersje tych plików. Działa trochę jak funkcja "śledź zmiany" w Microsoft Word, ale jest o wiele bardziej potężny.
 
-Możesz ściągnąć Gita z [git-scm.com](https://git-scm.com/). 
+## Instalacja Gita
 
-Możesz klikać "dalej dalej dalej" na każdym kroku oprócz poniższych: 
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
 
-W kroku, który nazywa się `"Adjusting your PATH environment"`, wybierz **"Run Git and associated Unix tools from the Windows command-line"** (opcję na samej górze). Poza tym domyślne ustawienia są w porządku. 
+Możesz ściągnąć Gita z [git-scm.com](https://git-scm.com/). Możesz klikać "next" we wszystkich krokach instalacji prócz jednego, w piątym kroku nazwanym "Adjusting your PATH environment", wybierz "Use Git and optional Unix tools from the Windows Command Prompt" (dolna opcja). Poza tym domyślne ustawienia są w porządku. Upewnij się jeszcze, że w kroku "Configuring the line ending conversions" wybrana jest opcja "Checkout Windows-style, commit Unix-style line endings".
 
-Upewnij się jeszcze, że w kolejnym kroku `"Configuring the line ending conversions"` wybrana jest opcja **"Checkout Windows-style, commit Unix-style line endings"**.
+Nie zapomnij zrestartować terminal linii poleceń lub powershell po instalacji zakończonej sukcesem. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Ściągnij Gita z [git-scm.com](https://git-scm.com/) i postępuj zgodnie z instrukcją.
+
+> **Uwaga**Jeżeli działasz na OS X 10.6, 10.7 lub 10.8, będziesz musiała zainstalować wersję gita dostępną tutaj: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
 
 <!--endsec-->
 
-<!--sec data-title="OS X" data-id="git_osx" data-collapse=true ces-->
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
 
-Ściągnij Gita z [git-scm.com](https://git-scm.com/) i postępuj zgodnie z instrukcją.
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+sudo dnf install git
+```
 
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="git_linux" data-collapse=true ces-->
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
 
-Możliwe, że git jest już zainstalowany domyśle, ale jeśli tak nie jest, powinien być dostępny za pośrednictwem menedżera pakietów, więc spróbuj:
+{% filename %}command-line{% endfilename %}
 
-    sudo apt-get install git
-    # or
-    sudo yum install git
-    # or
-    sudo zypper install git
+```bash
+sudo zypper install git
+```
 
 <!--endsec-->
\ No newline at end of file
diff --git a/pl/deploy/signup_pythonanywhere.md b/pl/deploy/signup_pythonanywhere.md
index 412d8af33eb..ac64f69ed5a 100755
--- a/pl/deploy/signup_pythonanywhere.md
+++ b/pl/deploy/signup_pythonanywhere.md
@@ -1,5 +1,5 @@
-Czas utworzyć darmowe konto (opcja "Beginner" - dla początkujących) na PythonAnywhere.
+Następnie, czas utworzyć darmowe konto ("Beginner" - dla początkujących) na PythonAnywhere.
 
-  * [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
 
-> **Uwaga** Wybierając swoją nazwę użytkownika, weź pod uwagę, że twój adres na PythonAnywhere będzie z nią związany `twojanazwauzytkownika.pythonanywhere.com`. Dlatego polecamy wybrać nazwę, z którą się utożsamiasz albo która jest związana z tematyką Twojego bloga.
\ No newline at end of file
+> ** Uwaga ** Wybierając tutaj swoją nazwę użytkownika, należy pamiętać, że adres URL bloga będzie miał postać `yourusername.pythonanywhere.com`, więc wybierz swój własny nick lub nazwę tego, o czym będzie blog.
\ No newline at end of file
diff --git a/pl/django/README.md b/pl/django/README.md
index 7e0dfcead95..9f2800e8bcd 100755
--- a/pl/django/README.md
+++ b/pl/django/README.md
@@ -12,15 +12,15 @@ Frameworki istnieją, by oszczędzić Ci wyważania otwartych drzwi i ułatwić
 
 By zrozumieć do czego naprawdę służy Django, musimy lepiej przyjrzeć się serwerom. Pierwszą rzeczą którą musi wiedzieć serwer jest to, że chcesz, żeby wyświetlił Ci stronę.
 
-Wyobraź sobie skrzynkę pocztową (port), która monitorowana pod kątem przychodzących listów (żądań). To właśnie rola serwera WWW. Serwer czyta list, i odsyła z powrotem odpowiedź w formie strony internetowej. Ale gdy chesz coś wysłać, musisz mieć jakąś treść. A Django jest właśnie tym, co pomoże Ci stworzyć tę treść.
+Wyobraź sobie skrzynkę pocztową (port), która monitorowana pod kątem przychodzących listów (żądań). To właśnie rola serwera WWW. Serwer czyta listę (żądanie), a następnie odsyła odpowiedź przy użyciu strony internetowej. Ale gdy chcesz coś wysłać, musisz mieć jakąś treść. A Django jest właśnie tym, co pomoże Ci stworzyć tę treść.
 
 ## Co się dzieje, gdy ktoś chce otworzyć stronę z Twojego serwera?
 
-Kiedy serwer otrzymuje żądanie, przekazuje je dalej do Django, aby ten ustalił, czego właściwie ono dotyczy. Django sprawdza najpierw adres strony i decyduje, co zrobić dalej. Ta część jest wykonywana przez obecny w Django mechanizm rozpoznawania adresów (ang. **urlresolver** - zwróć uwagę, że adres strony to inaczej adres URL, czyli angielska nazwa tego modułu nie jest przypadkowa). Nie jest on zbyt inteligentny - jego działanie sprowadza się do porównania adresu URL z listą wzorców. Django sprawdza wzorce od góry do dołu i jeśli uda mu się znaleźć pasującą regułę, jest on przekazywana do odpowiedniej funkcji (zwanej *widokiem*).
+Kiedy serwer otrzymuje żądanie, przekazuje je dalej do Django, aby ten ustalił, czego właściwie ono dotyczy. Django sprawdza najpierw adres strony i decyduje, co zrobić dalej. Ta część jest wykonywana przez obecny w Django mechanizm rozpoznawania adresów (ang. **urlresolver** - zwróć uwagę, że adres strony to inaczej adres URL, czyli angielska nazwa tego modułu nie jest przypadkowa). Nie jest on zbyt inteligentny - pobiera listę wzorców i próbuje dopasować adres URL. Django sprawdza wzorce od góry do dołu i jeśli uda się znaleźć pasującą regułę, Django przekazuje żądanie do odpowiedniej funkcji (zwanej *widokiem*).
 
 Wyobraź sobie listonosza niosącego list. Idzie ulicą i porównuje każdy numer domu z adresem na kopercie. List zostawia w skrzynce tego domu, którego adres pasuje. Tak samo działa urlresolver!
 
-W funkcji *widoku* dzieje się wszystko to, co najciekawsze: tutaj możemy połączyć się z bazą danych i wyszukać potrzebne nam informacje. Może użytkownik poprosił o zmianę danych? To tak, jakbyś wysłała list o treści "proszę o zmianę opisu mojego stanowiska pracy" - *widok* może sprawdzić, czy masz takie uprawnienia, a następnie dokona zmiany opisu i odeśle odpowiedź "Zrobione!". Wówczas *widok* generuje odpowiedź, a Django wysyła ją do przeglądarki użytkownika.
+W funkcji *widoku* dzieje się wszystko to, co najciekawsze: tutaj możemy połączyć się z bazą danych i wyszukać potrzebne nam informacje. Może użytkownik poprosił o zmianę danych? To tak, jakbyś wysłała list o treści "proszę o zmianę opisu mojego stanowiska pracy". *Widok* może sprawdzić, czy masz takie uprawnienia, a następnie dokona zmiany opisu i odeśle odpowiedź "Zrobione!". Wówczas *widok*generuje odpowiedź, a Django wysyła ją do przeglądarki użytkownika.
 
 Oczywiście powyższy opis jest nieco uproszczony, ale znajomość niuansów technicznych nie jest Ci na razie potrzebna. Wystarczy, że zrozumiesz ogólną zasadę działania.
 
diff --git a/pl/django_admin/README.md b/pl/django_admin/README.md
index 92ee66e701d..88b7dd5dcaa 100755
--- a/pl/django_admin/README.md
+++ b/pl/django_admin/README.md
@@ -1,8 +1,10 @@
 # Administracja Django (admin)
 
-Aby dodawać, modyfikować i usuwać wpisy, do których stworzyliśmy wcześniej modele, posłużymy się panelem admina Django.
+W celu dodawania, edycji czy usuwania artykułów, dla których model przed chwilą stworzyłyśmy, użyjemy admina Django.
 
-Otwórzmy plik `blog/admin.py` i zastąpmy jego zawartość poniższym:
+Otwórzmy plik `blog/admin.py` i zamieńmy jego zawartość na:
+
+{% filename %}blog/admin.py{% endfilename %}
 
 ```python
 from django.contrib import admin
@@ -13,36 +15,43 @@ admin.site.register(Post)
 
 Jak widać, importujemy (dołączamy) model Post, który zdefiniowałyśmy w poprzednim rozdziale. Aby nasz model był widoczny w panelu admina, musimy go zarejestrować za pomocą polecenia `admin.site.register(Post)`.
 
-OK, czas rzucić okiem na nasz model Post. Pamiętaj, by wpisać `python manage.py runserver` w wierszu poleceń, by uruchomić serwer. Przejdź do przeglądarki i wpisz adres http://127.0.0.1:8000/admin/ Powinnaś zobaczyć taką stronę:
+OK, czas rzucić okiem na nasz model Post. Pamiętaj, by wpisać `python manage.py runserver` w wierszu poleceń, by uruchomić serwer. Przejdź do przeglądarki i wpisz adres http://127.0.0.1: 8000/admin /. Zobaczysz stronę logowania podobną do tej:
+
+![Strona logowania](images/login_page2.png)
 
-![Strona logowania][1]
+Aby móc się zalogować, musisz utworzyć konto administratora (*superuser*) - czyli użytkownika, który posiada nieograniczony dostęp do całej strony. Wróć do wiersza poleceń, wpisz `python manage.py createsuperuser`, i wciśnij enter.
 
- [1]: images/login_page2.png
+> Pamietaj, aby móc wprowadzić nowe polecenie podczas pracy web serwera, otwórz nowy terminal i aktywuj virtualenv. Przyjrzałyśmy się, jak wpisywać nowe komendy w rozdziale **Twój pierwszy projekt w Django!**, w sekcji **Uruchamianie serwera www**.
 
-By móc się zalogować, musisz stworzyć *konto administratora* (ang. "superuser") - użytkownika, który ma całkowitą kontrolę nad stroną. Wróć do wiersza poleceń, wpisz `python manage.py createsuperuser` i zatwierdź klawiszem `Enter`. Zostaniesz poproszona o wpisanie swojej nazwy użytkownika (małymi literami, bez spacji i polskich znaków), adresu e-mail oraz hasła. Gdy będziesz wpisywała hasło, nie martw się, że nie widać żadnych znaków na ekranie. Tak ma być, wpisz hasło i wciśnij `Enter`. Treść widoczna na ekranie powinna wyglądać następująco (wpisz własną nazwę użytkownika i adres email):
+{% filename %}Mac OS X or Linux:{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
     Username: admin
     Email address: admin@admin.com
     Password:
     Password (again):
     Superuser created successfully.
+    
 
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
 
-Wróć do przeglądarki i zaloguj się danymi administratora, które wprowadziłaś wcześniej. Powinnaś zobaczyć panel admina Django.
-
-![Administracja Django (admin)][2]
-
- [2]: images/django_admin3.png
-
-Przejdź do sekcji Posts i poeksperymentuj trochę. Dodaj pięć - sześć wpisów. Nie przejmuj się ich treścią - możesz dla zaoszczędzenia czasu kopiować i wklejać treści z tego kursu :).
+![Django admin](images/django_admin3.png)
 
-Postaraj się, aby przynajmniej dwa-trzy wpisy (ale nie wszystkie!) miały ustawioną datę publikacji. Przyda nam się nieco później.
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
 
-![Administracja Django (admin)][3]
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
 
- [3]: images/edit_post3.png
+![Django admin](images/edit_post3.png)
 
-Jeśli chcesz dowiedzieć się więcej o panelu admina Django, sprawdź dokumentację Django: https://docs.djangoproject.com/en/1.8/ref/contrib/admin/
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
 
-To zdecydowanie dobra okazja na filiżankę kawy (lub herbaty) i schrupanie czegoś słodkiego. Stworzyłaś swój pierwszy model w Django - zasługujesz na małą nagrodę!
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/pl/django_forms/README.md b/pl/django_forms/README.md
index b520a51e744..9a3cbcc0805 100755
--- a/pl/django_forms/README.md
+++ b/pl/django_forms/README.md
@@ -12,10 +12,12 @@ Stwórzmy plik o takiej nazwie w katalogu `blog`.
 
     blog
        └── forms.py
-
+    
 
 Dobrze, a teraz otwórzmy go i wprowadźmy następujący kod:
 
+{% filename %}blog/forms.py{% endfilename %}
+
 ```python
 from django import forms
 
@@ -26,7 +28,7 @@ class PostForm(forms.ModelForm):
     class Meta:
         model = Post
         fields = ('title', 'text',)
-```    
+```
 
 Musimy najpierw zaimportować formularze Django (`from django import forms`) oraz, naturalnie, nasz model wpisu (`from .models import Post`).
 
@@ -34,7 +36,7 @@ Musimy najpierw zaimportować formularze Django (`from django import forms`) ora
 
 Dalej mamy `class Meta`, gdzie przekazujemy Django informację o tym, jaki model powinien być wykorzystany do stworzenia tego formularza (`model = Post`).
 
-I wreszcie możemy wskazać, które pole (lub pola) powinny pojawić się w naszym formularzu. W tym przypaku chcemy udostępnić tylko pola `title` (tytuł) i `text` (treść wpisu) - pole autora, czyli `author` powinno zawierać aktualnie zalogowanego użytkownika (Ciebie!), zaś data stworzenia wpisu (`created_date`) powinna być ustawiana automatycznie gdy stworzymy wpis (czyli za pomocą kodu) - zgadza się?
+I wreszcie możemy wskazać, które pole (lub pola) powinny pojawić się w naszym formularzu. W tym przypadku chcemy udostępnić tylko pola `title` (tytuł) i `text` (treść wpisu) - pole autora, czyli `author` powinno zawierać aktualnie zalogowanego użytkownika (Ciebie!), zaś data stworzenia wpisu (`created_date`) powinna być ustawiana automatycznie gdy stworzymy wpis (czyli za pomocą kodu) - zgadza się?
 
 I to wszystko! Jedyne, co potrzebujemy teraz zrobić, to użyć naszego formularza wewnątrz *widoku* i wyświetlić go w szablonie.
 
@@ -44,14 +46,18 @@ Oto, co za chwilę stworzymy: link do strony, adres URL, widok i szablon.
 
 Czas otworzyć plik `blog/templates/blog/base.html`. Wewnątrz `div`-a o nazwie `page-header` dodajmy odnośnik:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Zauważ, że chcemy odwołać się do naszego nowego widoku `post_new`.
+Zauważ, że chcemy odwołać się do naszego nowego widoku `post_new`. Klasa `"glyphicon glyphicon-plus"` jest dostarczana przez bootstrap, którego używamy i wyświetli nam znak plus.
 
 Po dodaniu powyższej linii Twój plik HTML powinien wyglądać następująco:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -81,23 +87,27 @@ Po dodaniu powyższej linii Twój plik HTML powinien wyglądać następująco:
 
 Po zapisaniu i odświeżeniu strony http://127.0.0.1:8000 zobaczyłaś oczywiście znajomo wyglądający błąd `NoReverseMatch`, zgadza się?
 
-## URL
+## Adres URL
 
 Otwieramy plik `blog/urls.py` i dodajemy wiersz:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-    url(r'^post/new/$', views.post_new, name='post_new'),
+url(r'^post/new/$', views.post_new, name='post_new'),
 ```
 
 Ostatecznie kod będzie wyglądał tak:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
     url(r'^post/new/$', views.post_new, name='post_new'),
 ]
 ```
@@ -108,11 +118,15 @@ Po odświeżeniu strony zobaczymy błąd `AttributeError`, ponieważ nie mamy je
 
 Czas otworzyć plik `blog/views.py` i dodać poniższe linijki obok innych wierszy z `from`:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from .forms import PostForm
 ```
 
-no i nasz *widok*:
+No i nasz *widok*:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -120,23 +134,23 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Aby stworzyć nowy formularz dla modelu `Post`, musimy wywołać funkcję `PostForm()` i przekazać ją do szablonu. Do tego *widoku* jeszcze wrócimy. Ale póki co, stwórzmy szybko szablon formularza.
+Aby stworzyć nowy formularz dla modelu `Post`, musimy wywołać funkcję `PostForm()` i przekazać ją do szablonu. Do tego *widoku* jeszcze wrócimy, ale póki co, stwórzmy szybko szablon dla formularza.
 
 ## Szablon
 
 Musimy utworzyć plik `post_edit.html` w katalogu `blog/templates/blog`. Aby nasz formularz zadziałał, niezbędne jest kilka rzeczy:
 
-*   musimy wyświetlić formularz. Możemy to zrobić np. za pomocą prostego polecenia `{% raw %}{{ form.as_p }}{% endraw %}`.
-*   powyższa linijka musi znajdować się wewnątrz znacznika formularza HTML: <`form method="POST">...</form>`
-*   potrzebny nam przycisk `Zapisz`. Tworzymy go jako przycisk w HTML: `<button type="submit">Save</button>`
-*   i na koniec jeszcze, zaraz po znaczniku otwierającym `<form ...>`, musimy dodać `{% raw %}{% csrf_token %}{% endraw %}`. To bardzo ważne, gdyż ta linijka sprawia, że Twoje formularze są bezpieczne! Jeśli o tym zapomnisz i spróbujesz zapisać formularz, Django nie pozostawi tego bez komentarza:
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* Powyższa linijka musi znajdować się wewnątrz znacznika formularza HTML: &lt;`form method="POST">...</form>`.
+* Potrzebny nam przycisk `Zapisz`. Tworzymy go jako przycisk w HTML: `<button type="submit">Save</button>`.
+* I na koniec jeszcze, zaraz po znaczniku otwierającym `<form ...>`musimy dodać {% raw %}`{% csrf_token %}`{% endraw %}. To bardzo ważne, gdyż ta linijka sprawia, że Twoje formularze są bezpieczne! Jeśli o tym zapomnisz i spróbujesz zapisać formularz, Django nie pozostawi tego bez komentarza:
 
-![Strona CSRF Forbidden][1]
-
- [1]: images/csrf2.png
+![Strona CSRF Forbidden](images/csrf2.png)
 
 OK. Podsumujmy, jak powinien wyglądać kod HTML w pliku `post_edit.html`:
 
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -151,11 +165,9 @@ OK. Podsumujmy, jak powinien wyglądać kod HTML w pliku `post_edit.html`:
 
 Czas odświeżyć stronę! Hura! Twój formularz został wyświetlony!
 
-![Nowy formularz][2]
+![Nowy formularz](images/new_form2.png)
 
- [2]: images/new_form2.png
-
-Ale zaraz zaraz! Co się stanie, gdy wpiszesz coś w pola z tytułem i treścią, a następnie spróbujesz to zapisać?
+Ale zaraz zaraz! Co się stanie, gdy wpiszesz coś w pola z `tytułem` i `treścią`, a następnie spróbujesz to zapisać?
 
 Nic! Znów jesteśmy na tej samej stronie, a nasza treść zniknęła... a nowego wpisu nie ma. Co poszło źle?
 
@@ -165,15 +177,19 @@ Odpowiedź brzmi: nic. Mamy coś jeszcze do zrobienia w naszym *widoku*.
 
 Otwórz jeszcze raz plik `blog/views.py`. W tym momencie wszystko, co mamy w widoku `post_new` to:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_new(request):
     form = PostForm()
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Gdy prześlemy formularz, wracamy do tego samego widoku, ale tym razem mamy nieco więcej danych w zapytaniu (zmiennej `request`) - a dokładnie w `request.POST`. (Nazwa POST nie ma nic wspólnego z naszymi blogowymi postami. POST wzięło się od angielskiego czasownika "post", który oznacza wysłać, nadać). Pamiętasz, że w pliku HTML nasza definicja formularza `<form>` zawierała atrybut `method="POST"`? Wszystkie pola z formularza znajdują się teraz w `request.POST`. Nie zmieniaj nazwy `POST` na cokolwiek innego (inną prawidłową wartością dla `method` jest `GET`, ale nie mamy czasu na omawianie różnic).
+Gdy prześlemy formularz, wracamy do tego samego widoku, ale tym razem mamy nieco więcej danych w zapytaniu (zmiennej `request`) - a dokładnie w `request.POST` (Nazwa POST nie ma nic wspólnego z naszymi blogowymi postami. POST wzięło się od angielskiego czasownika "post", który oznacza wysłać, nadać). Pamiętasz, że w pliku HTML nasza definicja `<form>` zawierała atrybut `method="POST"`? Wszystkie pola z formularza znajdują się teraz w `request.POST`. Nie zmieniaj nazwy `POST` na cokolwiek innego (inną prawidłową wartością dla `method` jest `GET`, ale nie mamy czasu na omawianie różnic).
+
+A więc w naszym *widoku* mamy dwie oddzielne sytuacje do obsłużenia. Pierwsza: gdy wchodzimy na stronę po raz pierwszy i chcemy pusty formularz. Druga: gdy ponownie znajdziemy się w *widoku* wraz ze wszystkimi danymi wpisanymi przez nas w formularzu. Czyli musimy dodać wyrażenie warunkowe (użyjemy do tego `if`):
 
-A więc w naszym *widoku* mamy dwie oddzielne sytuacje do obsłużenia. Pierwsza: gdy wchodzimy na stronę po raz pierwszy i chcemy pusty formularz. Druga: gdy ponownie znajdziemy się w *widoku* wraz ze wszystkimi danymi wpisanymi przez nas w formularzu. Czyli musimy dodać wyrażenie warunkowe (użyjemy do tego `if`).
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 if request.method == "POST":
@@ -182,16 +198,20 @@ else:
     form = PostForm()
 ```
 
-Teraz czas na uzupełnienie kropek `[...]`. Jeżeli zmienna `method` jest równa `POST`, to chcemy zbudować formularz `PostForm` z danymi wprowadzonymi w formularzu, zgadza się? Możemy zrobić to następująco:
+To jest czas na uzupełnienie kropek `[...]`. Jeżeli zmienna `method` jest równa `POST`, to chcemy zbudować formularz `PostForm` z danymi z formularza, zgadza się? Możemy zrobić to następująco:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST)
 ```
 
-Łatwizna! Następnie sprawdźmy, czy formularz jest wypełniony poprawnie (wszystkie wymagane pola są uzupełnione i żadna nieprawidłowa wartość nie zostanie zapisana). Użyjmy do tego `form.is_valid()`.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
 
 Sprawdzamy, czy formularz jest wypełniony poprawnie. Jeśli tak, możemy go zapisać!
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 if form.is_valid():
     post = form.save(commit=False)
@@ -200,15 +220,19 @@ if form.is_valid():
     post.save()
 ```
 
-Tak właściwie robimy teraz dwie rzeczy: zapisujemy formularz przy pomocy `form.save` oraz dodajemy autora (jako że nasz `PostForm` nie zawierał pola `author`, a jest ono wymagane!). `commit=False` sygnalizuje, że jeszcze nie chcemy zapisywać modelu `Post` - najpierw chcemy dodać autora. Przez większość czasu będziesz używała `form.save()` bez `commit=False`, ale w tym przypadku musimy zrobić to w ten sposób. `post.save()` zachowa zmiany (razem z dodanym autorem) i nasz nowy wpis na blogu jest gotowy!
+Tak właściwie robimy teraz dwie rzeczy: zapisujemy formularz przy pomocy `form.save` oraz dodajemy autora (jako że nasz `PostForm` nie zawierał pola `author`, a jest ono wymagane). `commit=False` sygnalizuje, że jeszcze nie chcemy zapisywać modelu `Post` - najpierw chcemy dodać autora. Przez większość czasu będziesz używała `form.save()` bez `commit=False`, ale w tym przypadku musimy zrobić to w ten sposób. `post.save()` zachowa zmiany (razem z dodanym autorem) i nasz nowy wpis na blogu jest gotowy!
 
-Byłoby wreszcie wspaniale, gdybyśmy mogły przejść od razu na stronę `post_detail` i zobaczyć nasz nowy wpis, prawda? Aby to było możliwe, musimy dodać dodatkowy import:
+Ostatecznie, byłoby wspaniale, gdybyśmy mogły przejść od razu na stronę `post_detail` i zobaczyć nasz nowy wpis, prawda? Aby to było możliwe, potrzebujemy jeszcze jednego importu:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import redirect
 ```
 
-Dodaj go na samym początku pliku w tej formie, albo dopisz samo `redirect` do istniejącej już pierwszej linii importów. I teraz możemy powiedzieć: przejdź na stronę `post_detail`, żeby zobaczyć nowo utworzony wpis.
+Dodaj go na samym początku pliku. I teraz możemy powiedzieć: "przejdź na stronę `post_detail`, żeby zobaczyć nowo utworzony wpis":
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 return redirect('post_detail', pk=post.pk)
@@ -218,6 +242,8 @@ return redirect('post_detail', pk=post.pk)
 
 No dobrze, pogadałyśmy sobie, to może teraz zobaczymy, jak wygląda cały nasz *widok*, co?
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_new(request):
     if request.method == "POST":
@@ -235,40 +261,40 @@ def post_new(request):
 
 Zobaczmy, czy zadziała. Przejdź na stronę http://127.0.0.1:8000/post/new/, dodaj `tytuł` i `tekst`, zapisz... i voilà! Nowy wpis został dodany, a my zostałyśmy przekierowane na stronę `post_detail`!
 
-Zapewne dostrzegłaś, że w ogóle nie zajęłyśmy się ustawianiem daty publikacji. Wprowadzimy przycisk publikacji *publish* w kursie **Django Girls: Rozszerzenia**.
+Zapewne dostrzegłaś, że ustalamy datę publikacji przed zapisaniem postu. Później wprowadzimy przycisk publikacji *publish* w kursie **Django Girls: Rozszerzenia**.
 
 Wspaniale!
 
+> Jako że niedawno używałyśmy interfejsu admina Django, system w tym momencie jest przekonany, że jesteśmy zalogowane. Niektóre sytuacje mogą doprowadzić do tego, że zostaniemy wylogowane (np. zamknięcie przeglądarki czy restart bazy danych, itd.). Jeżeli zauważysz, że przy tworzeniu wpisu pojawia się błąd związany z brakiem zalogowanego użytkownika, przejdź na stronę stronę panelu admina http://127.0.0.1:8000/admin i zaloguj się jeszcze raz. Na pewien czas problem się rozwiąże. W rozdziale **Praca domowa: zabezpiecz swoją stronę!** - zaraz po głównym kursie - czeka na Ciebie permanentne rozwiązanie tego problemu.
+
+![Błąd logowania użytkownika](images/post_create_error.png)
+
 ## Walidacja formularza
 
-Teraz pokażemy Ci, jak fajne potrafią być formularze w Django. Wpis na blogu potrzebuje uzupełnionych pól `title` i `text`. W naszym modelu `Post` nie zaznaczałyśmy (z wyjątkiem `published_date`), że te pola nie są wymagane, prawda? Dlatego Django domyślnie uważa, że muszą zostać wypełnione.
+Teraz pokażemy Ci, jak fajne potrafią być formularze w Django. Wpis na blogu potrzebuje uzupełnionych pól `title` i `text`. W naszym modelu `Post` nie powiedzieliśmy (z wyjątkiem `published_date`), że te pola nie są wymagane, więc Django domyślnie uważa, że muszą zostać wypełnione.
 
 Spróbuj zapisać formularz bez uzupełnionych pól `title` i `text`. Zgadnij, co się stanie!
 
-![Walidacja formularza][3]
-
- [3]: images/form_validation2.png
+![Walidacja formularza](images/form_validation2.png)
 
 Django dba o walidację pól w naszym formularzu, upewniając się, czy są uzupełnione poprawnie. Prawda że niesamowite?
 
-> Jako że niedawno używałyśmy interfejsu admina Django, system w tym momencie jest przekonany, że jesteśmy zalogowane. Niektóre sytuacje mogą doprowadzić do tego, że zostaniemy wylogowane (np. zamknięcie przeglądarki czy restart bazy danych). Jeżeli zauważysz, że przy tworzeniu wpisu pojawia się błąd związany z brakiem zalogowanego użytkownika, przejdź na stronę stronę panelu admina http://127.0.0.1:8000/admin i zaloguj się jeszcze raz. Na pewien czas problem się rozwiąże. W rozdziale **Praca domowa: zabezpiecz swoją stronę!** - zaraz po głównym kursie - czeka na Ciebie permanentne rozwiązanie tego problemu.
-
-![Błąd logowania użytkownika][4]
-
- [4]: images/post_create_error.png
-
 ## Edycja formularza
 
-Teraz już wiemy, jak dodać nowy formularz. Ale co w przypadku, gdy zapragniemy zmienić już istniejący? Proces jest bardzo podobny do tego, który przeszłyśmy przed chwilą. Dodajmy szybko potrzebne elementy (jeżeli masz problem ze zrozumieniem czegoś - zapytaj osobę prowadzącą kurs lub przejrzyj poprzednie rozdziały, gdyż wszystkie kroki mamy już omówione).
+Teraz już wiemy, jak dodać nowy formularz. Ale co w przypadku, gdy zapragniemy zmienić już istniejący? Proces jest bardzo podobny do tego, który przeszłyśmy przed chwilą. Stwórzmy szybko kilka ważnych rzeczy. (jeżeli masz problem ze zrozumieniem czegoś, zapytaj osobę prowadzącą kurs lub przejrzyj poprzednie rozdziały, gdyż wszystkie kroki mamy już omówione.)
 
-Otwórz `blog/templates/blog/post_detail.html` i dodaj poniższą linijkę:
+Otwórz `blog/templates/blog/post_detail.html` i dodaj poniższą linijkę
 
-```python
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
 
 dzięki czemu nasz szablon będzie wyglądał tak:
 
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -288,14 +314,18 @@ dzięki czemu nasz szablon będzie wyglądał tak:
 
 W pliku `blog/urls.py` dodajmy wiersz:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-    url(r'^post/(?P<pk>[0-9]+)/edit/$', views.post_edit, name='post_edit'),
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
 ```
 
 Wykorzystamy jeszcze raz szablon `blog/templates/blog/post_edit.html`, więc ostatnią rzeczą, której nam brakuje, jest *widok*.
 
 Otwórz `blog/views.py` i dodaj poniższy kod na samym końcu tego pliku:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_edit(request, pk):
     post = get_object_or_404(Post, pk=pk)
@@ -312,13 +342,17 @@ def post_edit(request, pk):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-To wygląda prawie tak samo, jak nasz widok `post_new`, nieprawdaż? Ale nie do końca. Po pierwsze: przekazujemy dodatkowy parametr `pk` z urls. Dalej - pobieramy model wpisu `Post` do edycji za pomocą `get_object_or_404(Post, pk=pk)`. Gdy tworzymy formularz, przekazujemy ten wpis pod zmienną `instance` zarówno w trakcie zapisywania formularza:
+To wygląda prawie tak samo, jak nasz widok `post_new`, nieprawdaż? Ale nie do końca. Po pierwsze: przekazujemy dodatkowy parametr `pk` z urls. Dalej - pobieramy model wpisu `Post` do edycji za pomocą `get_object_or_404(Post, pk=pk)`. Gdy tworzymy formularz, przekazujemy ten wpis pod zmienną `instance` zarówno w trakcie zapisywania formularza…
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST, instance=post)
 ```
 
-jak i zaraz po otwarciu formularza z wpisem do edycji:
+…jak i zaraz po otwarciu formularza z wpisem do edycji:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(instance=post)
@@ -326,27 +360,25 @@ form = PostForm(instance=post)
 
 OK. Przetestujmy, jak to działa! Przejdź na stronę `post_detail`. W górnym prawym rogu powinnaś znaleźć przycisk edycji:
 
-![Przycisk edycji][5]
-
- [5]: images/edit_button2.png
+![Przycisk edycji](images/edit_button2.png)
 
 Po kliknęciu w niego zobaczysz formularz z naszym wpisem:
 
-![Edycja formularza][6]
-
- [6]: images/edit_form2.png
+![Edycja formularza](images/edit_form2.png)
 
 Zmodyfikuj jego tytuł lub treść wedle uznania, a następnie zapisz zmiany!
 
 Gratulacje! Twoja aplikacja staje się coraz bardziej kompletna!
 
-Jeżeli potrzebujesz więcej informacji o formularzach Django, zajrzyj do dokumentacji: https://docs.djangoproject.com/en/1.8/topics/forms/
+Jeżeli potrzebujesz więcej informacji o formularzach Django, zajrzyj do dokumentacji: https://docs.djangoproject.com/en/1.11/topics/forms/
 
 ## Bezpieczeństwo
 
-Super, że możemy tworzyć posty po prostu klikając w link! Jest niestety jeden problem - teraz każdy, kto odwiedzi Twoją stronę, może stworzyć nowy post. Dobrze by było, gdyby przycisk był widoczny tylko dla Ciebie.
+Super, że możemy tworzyć posty po prostu klikając w link! Jest niestety jeden problem - aktualnie każdy, kto odwiedzi Twoją stronę, może stworzyć nowy post. Zróbmy tak, aby przycisk był widoczny tylko dla Ciebie i nikogo innego.
 
-W `blog/templates/blog/base.html` znajdź `page-header` `div` i tag<em>-a</em>, który umieściliśmy tam wcześniej. Powinien wyglądać tak:
+W `blog/templates/blog/base.html` znajdź `page-header` `div` i tag <0>a</0>, który umieściliśmy tam wcześniej. Powinien wyglądać tak:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
@@ -354,47 +386,62 @@ W `blog/templates/blog/base.html` znajdź `page-header` `div` i tag<em>-a</em>,
 
 Dodamy kolejny tag `{% if %}`, który sprawi, że link będzie widoczny tylko dla użytkowników zalogowanych jako admin. W tej grupie na razie jesteś tylko Ty! Zmień `<a>` tag, by wyglądał w ten sposób:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% if user.is_authenticated %}
     <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 {% endif %}
 ```
 
-Ten `{% if %}` spowoduje, że link zostanie wysłany do przeglądarki tylko jeśli to żądanie zostało wystosowane przez zalogowanego użytkownika. To nie chroni tworzenia wpisów w 100%, ale jest to dobry pierwszy krok. Zagadnieniu bezpieczeństwa poświęcimy więcej miejsca w rozszerzeniu do tego kursu.
+Ten `{% if %}` spowoduje, że link zostanie wysłany do przeglądarki tylko wtedy, kiedy użytkownik chcący wyświetlić tę stronę jest zalogowany. To nie chroni tworzenia wpisów w 100%, ale jest to dobry pierwszy krok. Zagadnieniu bezpieczeństwa poświęcimy więcej miejsca w rozszerzeniu do tego kursu.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
 
-Pewnie jesteś teraz zalogowana, więc jak odświeżysz stronę to nie zobaczysz różnicy. Wejdź na tę stronę używając innej przeglądarki lub w trybie prywatnym, a wtedy zobaczysz, że link się już nie pokaże!
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
 
 ## Jeszcze jedno: czas na wdrożenie!
 
 Dobrze byłoby wiedzieć, że nasza witryna nadal działa na PythonAnywhere, prawda?
 
-*   Po pierwsze zapiszmy nasze zmiany i wyślijmy je na Githuba
+* Po pierwsze zapiszmy nasze zmiany i wyślijmy je na Githuba:
 
+{% filename %}command-line{% endfilename %}
 
     $ git status
-    [...]
     $ git add --all .
     $ git status
-    [...]
-    $ git commit -m "Dodano widok tworzenia/edytowania posta bezposrednio na stronie."
+    $ git commit -m "Added views to create/edit blog post inside the site."
     $ git push
-    [...]
-
+    
 
-*   Potem, w konsoli [PythonAnywhere Bash][7]:
+* Potem, w konsoli [PythonAnywhere Bash](https://www.pythonanywhere.com/consoles/):
 
- [7]: https://www.pythonanywhere.com/consoles/
+{% filename %}command-line{% endfilename %}
 
     $ cd my-first-blog
-    $ source myvenv/bin/activate
-    (myvenv)$ git pull
+    $ git pull
     [...]
-    (myvenv)$ python manage.py collectstatic
-    [...]
-
-
-*   Na koniec, przejdźmy do podstrony [Web tab][8] i wciśnijmy **Reload** (ang. odśwież).
+    
 
- [8]: https://www.pythonanywhere.com/web_app_setup/
+* Na koniec, przejdźmy do podstrony [Web tab](https://www.pythonanywhere.com/web_app_setup/) i wciśnijmy **Reload** (ang. odśwież.
 
-I to już wszystko! Gratulacje :)
+I to już wszystko! Gratulacje :)
\ No newline at end of file
diff --git a/pl/django_installation/README.md b/pl/django_installation/README.md
index 2ca1433a389..58833a6a2f5 100644
--- a/pl/django_installation/README.md
+++ b/pl/django_installation/README.md
@@ -1,5 +1,7 @@
 # Instalowanie Django
 
-> **Uwaga** Jeśli przerobiłaś rozdział "Instalacja" to wszystko masz zrobione - możesz przejść od razu do kolejnego rozdziału!
+> **Uwaga** Jeśli używasz już Chromebook, pomiń ten rozdział i upewnij się, że postąpiłeś zgodnie z instrukcją [Instalowanie Chromebook](../chromebook_setup/README.md).
+> 
+> **Uwaga** Jeśli wykonałeś krok Instalacja to masz już wszystko zrobione - możesz przejść od razu do następnego kroku!
 
-{% include "/django_installation/instructions.md" %}
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/pl/django_installation/instructions.md b/pl/django_installation/instructions.md
index 8a0c63e49c2..c2898f5cbdb 100755
--- a/pl/django_installation/instructions.md
+++ b/pl/django_installation/instructions.md
@@ -8,87 +8,143 @@ Zanim zainstalujemy Django, zapoznamy się z niezwykle użytecznym narzędziem,
 
 Stwórzmy zatem **środowisko wirtualne** (zwane też *virtualenv*). Jego zadaniem jest oddzielenie środowiska Pythona/Django dla każdego projektu z osobna. Oznacza to, że zmiany dokonane w obrębie jednej aplikacji nie wpłyną na działanie innych, nad którymi pracujesz. Sprytne, prawda?
 
-Jedyne, co potrzebujesz zrobić, to wybrać katalog, w którym chcesz utworzyć `virtualenv`; na przykład Twój katalog domowy. W systemie Windows może on wyglądać tak: `C:\Użytkownicy\Nazwa` (gdzie `Nazwa` to twoja nazwa użytkownika, której używasz przy logowaniu się do komputera).
+Jedyne, co potrzebujesz zrobić, to wybrać katalog, w którym chcesz utworzyć `virtualenv`; na przykład Twój katalog domowy. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
 
-Na potrzeby kursu stwórzmy nowy katalog `djangogirls` w Twoim katalogu domowym:
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
 
-    mkdir djangogirls
-    cd djangogirls
+Na potrzeby kursu będziemy stwórzmy nowy katalog `djangogirls` w Twoim katalogu domowym:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
     
 
 Stwórzmy nowe środowisko wirtualne o nazwie `myvenv`. Polecenie ma następujący format:
 
-    python3 -m venv myvenv
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
     
 
-<!--sec data-title="Windows" data-id="virtualenv_win" data-collapse=true ces-->
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Aby utworzyć nowego `virtualenv`'a, musisz otworzyć okno wiersza poleceń i wykonać polecenie `python -m venv myvenv`. Będzie to wyglądać tak:
 
-Aby stworzyć nowego `virtualenv`'a, musisz otworzyć konsolę (wspominaliśmy o tym parę rozdziałów temu, pamiętasz?) i uruchom `C:\ Python34\python -m venv venv`. Efekt będzie wyglądał tak:
+{% filename %}command-line{% endfilename %}
 
-    C:\Użytkownicy\Nazwa\djangogirls> C:\Python34\python -m venv myvenv
+    C:\Users\Name\djangogirls> python -m venv myvenv
     
 
-gdzie `C:\Python34\python` to katalog, w którym zainstalowałaś wcześniej Pythona, zaś `myvenv` to nazwa Twojego `virtualenv`'a. Nazwa może być dowolna, ale lepiej używać tylko małych liter, bez spacji i polskich znaków. Dobrze jest też trzymać się krótkich nazw - będziesz do nich często wracała!
+Gdzie `myvenv` to nazwa Twojego `virtualenv`'a. Nazwa może być dowolna, ale lepiej używać tylko małych liter, bez spacji i polskich znaków. Dobrze jest też trzymać się krótkich nazw - będziesz do nich często wracała!
 
 <!--endsec-->
 
-<!--sec data-title="Linux i OS X" data-id="virtualenv_unix" data-collapse=true ces-->
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
 
-Stworzenie `virtualenv`'a w Linuksie i OS X ogranicza się jedynie do użycia polecenia `python3 -m venv myvenv`. Przyjmie ono następującą postać:
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
 
-    ~/djangogirls$ python3 -m venv myvenv
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
     
 
-`myvenv` to nazwa Twojego `virtualenv`'a. Nazwa środowiska może być dowolna, ale lepiej używać tylko małych liter, bez spacji i polskich znaków. Dobrze jest też trzymać się krótkich nazw - będziesz do nich często wracała!
+`myvenv` to nazwa Twojego `virtualenv`'a. Nazwa środowiska może być dowolna, ale lepiej używać tylko małych liter, bez spacji i polskich znaków. It is also a good idea to keep the name short as you'll be referencing it a lot!
 
-> **UWAGA:** Próba utworzenia w ten sposób środowiska wirtualnego w Ubuntu 14.04 skutkuje następującym błędem:
+> **UWAGA:** W niektórych wersjach Debiana/Ubuntu może pojawić się następujący komunikat o błędzie:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> W tym przypadku, wykonaj powyższe instrukcje i zainstaluj pakiet `python3-venv`: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **UWAGA:** W niektórych wersjach Debiana/Ubuntu inicjowanie środowiska wirtualnego w ten sposób daje obecnie następujący błąd:
+> 
+> {% filename %}command-line{% endfilename %}
 > 
 >     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
 >     
 > 
 > Aby uniknąć tego problemu, użyj polecenia `virtualenv`.
 > 
->     ~/djangogirls$ sudo apt-get install python-virtualenv
->     ~/djangogirls$ virtualenv --python=python3.4 myvenv
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
 >     
+> 
+> **UWAGA:** Jeśli wystąpi błąd taki jak
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> to zamiast tego wykonaj:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
 <!--endsec-->
 
 ## Praca z virtualenv
 
 Powyższa instrukcja utworzy katalog o nazwie `myvenv` (albo o nazwie, którą wybrałaś) zawierający nasze środowisko wirtualne (czyli w zasadzie zbiór katalogów i plików).
 
-#### Windows
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
 
 Uruchom wirtualne środowisko za pomocą polecenia:
 
+{% filename %}command-line{% endfilename %}
+
     C:\Użytkownicy\Nazwa\djangogirls> myvenv\Scripts\activate
     
 
-#### Linux i OS X
+> **Uwaga:** W systemie Windows 10 możesz otrzymać błąd w programie Windows PowerShell, który mówi, `wykonywanie skryptów jest wyłączone w tym systemie`. W tym przypadku, otwórz inny Windows PowerShell z opcją "Uruchom jako Administrator". Następnie spróbuj, wpisując następujące polecenie przed rozpoczęciem środowiska wirtualnego:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
 
 Uruchom wirtualne środowisko za pomocą polecenia:
 
-    ~/djangogirls$ source myvenv/bin/activate
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
     
 
 Nie zapomnij zastąpić `myvenv` nazwą, którą wybrałaś dla Twojego `virtualenv`!
 
 > **UWAGA:** może się zdarzyć, że polecenie `source` nie będzie dostępne. W takim przypadku spróbuj użyć poniższego:
 > 
->     ~/djangogirls$ . myvenv/bin/activate
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
 >     
 
-O tym, że Twój `virtualenv` jest uruchomiony, dowiesz się, gdy zobaczysz w swojej konsoli prompt podobny do tego:
-
-    (myvenv) C:\Użytkownicy\Nazwa\djangogirls>
-    
-
-lub:
-
-    (myvenv) ~/djangogirls$
-    
+<!--endsec-->
 
-Zwróć uwagę, że pojawił się tam prefix `(myvenv)`!
+O tym, że Twój `virtualenv` jest uruchomiony, dowiesz się, gdy zobaczysz w swojej konsoli prompt poprzedzony przedrostkiem `(myvenv)`.
 
 W trakcie pracy ze środowiskiem wirtualnym `python` będzie automatycznie odnosił się do właściwej wersji, dzięki czemu możesz używać polecenia `python` zamiast `python3`.
 
@@ -96,21 +152,50 @@ W trakcie pracy ze środowiskiem wirtualnym `python` będzie automatycznie odnos
 
 ## Instalowanie Django
 
-Teraz, gdy Twój `virtualenv` jest już uruchomiony, możesz zainstalować Django za pomocą narzędzia `pip`. W konsoli uruchom polecenie `pip install django==1.8` (zwróć uwagę, że używamy podwójnego znaku równości: `==`).
+Teraz, gdy Twój `virtualenv` jest już uruchomiony, możesz zainstalować Django.
+
+Zanim jednak to zrobimy, powinniśmy się upewnić, że mamy najnowszą wersję `pip`, oprogramowania, które używamy do zainstalowania Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
 
-    (myvenv) ~$ pip install django==1.8
-    Downloading/unpacking django==1.8
+Następnie uruchom polecenie `pip install django~=1.11.0 `(zwróć uwagę, że używamy tyldy przed znakiem równości: `~=`) do instalacji Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
     Installing collected packages: django
-    Successfully installed django
-    Cleaning up...
+    Successfully installed django-1.11.3
     
 
-w systemie Windows
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
 
-> Jeżeli w trakcie wywoływania polecenia pip otrzymasz błąd, sprawdź czy ścieżka Twojego projektu nie zawiera spacji (np. `C:\Users\Imie Nazwisko\djangogirls`). Jeżeli tak, sugerujemy przeniesienie projektu do innego katalogu bez spacji w nazwie (proponujemy `C:\djangogirls`). Gdy już to zrobisz, spróbuj wykonać powyższe polecenie jeszcze raz.
+> Jeżeli w trakcie wywoływania polecenia pip w Windows otrzymasz błąd, sprawdź czy ścieżka Twojego projektu nie zawiera spacji, kresek lub znaków specjalnych (np. `C:\Users\User Name\djangogirls`). Jeżeli tak, sugerujemy przeniesienie projektu do innego katalogu bez spacji, kresek i znaków specjalnych (propnujemy `C:\djangogirls`). Utwórz nowy virtualenv w nowym katalogu, następnie usuń stary i spróbuj ponownie wykonać powyższe polecenie. (Przenoszenie katalogu virtualenv nie będzie działać ponieważ virtualenv używa ścieżek bezwzględnych.)
+
+<!--endsec-->
 
-w systemie Linux
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Twoja linia poleceń może się zamrozić po próbie zainstalowania Django. Jeśli tak się stanie, zamiast powyższego polecenia użyj:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
 
 > Jeśli po użyciu polecenia pip w Ubuntu 12.04 otrzymasz błąd, użyj polecenia `python -m pip install -U --force-reinstall pip`, aby naprawić instalacją pip'a w środowisku wirtualnym.
 
-To wszystko! Teraz (nareszcie) jesteś gotowa do stworzenia aplikacji w Django!
+<!--endsec-->
+
+To wszystko! Teraz (nareszcie) jesteś gotowa do stworzenia aplikacji w Django!
\ No newline at end of file
diff --git a/pl/django_models/README.md b/pl/django_models/README.md
index f637f4c182b..6bf0efa5e20 100755
--- a/pl/django_models/README.md
+++ b/pl/django_models/README.md
@@ -4,13 +4,13 @@ Teraz zajmiemy się tworzeniem czegoś, co będzie przechowywało wszystkie wpis
 
 ## Obiekty
 
-W programowaniu istnieje pojęcie `programowania zorientowanego obiektowo`. Chodzi o to, że zamiast wypisywania nudnych sekwencji poleceń, możemy tworzyć modele różnych rzeczy i definiować ich zachowania względem siebie.
+W programowaniu istnieje pojęcie `programowania zorientowanego obiektowego`. Chodzi o to, że zamiast wpisywania nudnych sekwencji poleceń, możemy tworzyć modele różnych rzeczy i definiować w jaki sposób wchodzą ze sobą w interakcję.
 
 Zatem czym są obiekty? To po prostu zbiór pewnych właściwości i czynności. Owszem, brzmi dziwnie, ale przyjrzyjmy się temu na przykładzie.
 
-Jeśli chcemy stworzyć model kota, stworzymy obiekt o nazwie `Kot` posiadający jakieś właściwości, np. `kolor`, `wiek`, `nastrój` (np. dobry, zły, senny ;)), `właściciel` (czyli obiekt typu `Osoba` lub pozostawimy tę właściwość pustą, wtedy mamy bezpańskiego kota).
+Jeśli chcemy stworzyć model kota, stworzymy obiekt o nazwie `Kot` posiadający jakieś właściwości, np. `kolor`, `wiek`, `nastrój` (np. dobry, zły, senny ;)), i `właściciel` (czyli obiekt typu `Osoba` lub pozostawimy tę właściwość pustą, wtedy mamy bezpańskiego kota).
 
-Nasz `Kot` ma określone czynności: `mrucz`, `podrap`, `jedz` (i tu przekażemy kotu oddzielny obiekt o nazwie `KociPrzysmak` ze swoimi własnymi właściwościami, np. `smak`).
+Nasz `Kot` ma określone czynności: `mrucz`, `podrap`, `jedz` (i w tym przypadku przekażemy kotu oddzielny obiekt o nazwie `KociPrzysmak` ze swoimi własnymi właściwościami, np. `smak`).
 
     Kot
     --------
@@ -21,12 +21,12 @@ Nasz `Kot` ma określone czynności: `mrucz`, `podrap`, `jedz` (i tu przekażemy
     mrucz()
     podrap()
     jedz(koci_przysmak)
-
+    
 
     KociPrzysmak
     --------
     smak
-
+    
 
 Czyli w zasadzie chodzi o to, że opisujemy prawdziwe rzeczy w kodzie za pomocą właściwości (zwanych `właściwościami obiektu`) oraz czynności (zwanych `metodami`).
 
@@ -43,7 +43,7 @@ Na pewno musi zawierać zawartość tekstową oraz tytuł, prawda? Fajnie byłob
     author
     created_date
     published_date
-
+    
 
 Co możemy zrobić z wpisem na blogu? Przydałaby nam się jakaś `metoda`, która opublikuje nasz wpis, zgadza się?
 
@@ -55,7 +55,7 @@ Skoro już wiemy, co chcemy osiągnąć, pora zacząć tworzyć model w Django!
 
 Wiedząc, czym jest obiekt, możemy stworzyć model Django odpowiadający naszemu wpisowi na blogu.
 
-Model Django stanowi specjalny rodzaj obiektu - jest zapisywany w `bazie danych`. Baza danych jest zbiorem informacji. Miejscem, w którym przechowujemy informacje o użytkownikach, Twoje wpisy na blogu, itd. Do zapisania naszych danych użyjemy bazy SQLite. Jest to domyślny moduł bazy danych w Django - na nasze potrzeby w zupełności wystarczy.
+Model w Django jest specjalnym rodzajem obiektu - jest zapisywany w `bazie danych`. Baza danych jest zbiorem informacji. Miejscem, w którym przechowujemy informacje o użytkownikach, Twoje wpisy na blogu, itd. Do zapisania naszych danych użyjemy bazy SQLite. Jest to domyślny moduł bazy danych w Django - na nasze potrzeby w zupełności wystarczy.
 
 Możesz sobie wyobrazić model w bazie danych jako arkusz kalkulacyjny z kolumnami (polami) oraz wierszami (danymi).
 
@@ -63,35 +63,43 @@ Możesz sobie wyobrazić model w bazie danych jako arkusz kalkulacyjny z kolumna
 
 Aby utrzymać wszystko w ładzie, stworzymy osobną aplikację wewnątrz naszego projektu. Przyjemnie jest mieć wszystko uporządkowane od samego początku. Aby stworzyć aplikację, musimy wykonać następujące polecenie w konsoli (z poziomu katalogu `djangogirls`, tam gdzie znajduje się plik `manage.py`):
 
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
 
+{% filename %}Windows:{% endfilename %}
 
-Z pewnością zauważysz, że pojawił się nowy folder `blog` zawierający kilka plików. Czyli foldery i pliki w naszym projekcie powinny wyglądać tak:
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Zauważysz, że nowy katalog `blog` został utworzony i zawiera kilka plików. Katalogi i pliki w naszym projekcie powinny wyglądać tak:
 
     djangogirls
     ├── blog
-    │   ├── migrations
-    │   |   └── __init__.py
     │   ├── __init__.py
     │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
     │   ├── models.py
     │   ├── tests.py
     │   └── views.py
-    ├── mysite
-    │   ├── __init__.py
-    │   ├── settings.py
-    │   ├── urls.py
-    │   └── wsgi.py
-    ├── myvenv
     ├── db.sqlite3
-    └── manage.py
-
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
 
+Po stworzeniu aplikacji, musimy dać znać Django, że powinien jej używać. Posługujemy się w tym celu plikiem `mysite/settings.py`. Musimy odnaleźć nagłówek `INSTALLED_APPS` i dodać wiersz o treści `'blog',` tuż przed nawiasem zamykającym `]`. Czyli efekt końcowy powinien wyglądać tak:
 
-Po stworzeniu aplikacji musimy dać znać Django, że powinien jej używać. Posługujemy się w tym celu plikiem `mysite/settings.py`. Musimy odnaleźć nagłówek `INSTALLED_APPS` i dodać wiersz o treści `'blog',` tuż przed nawiasem zamykającym `)`. Czyli efekt końcowy powinien wyglądać tak:
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-INSTALLED_APPS = (
+INSTALLED_APPS = [
     'django.contrib.admin',
     'django.contrib.auth',
     'django.contrib.contenttypes',
@@ -99,22 +107,24 @@ INSTALLED_APPS = (
     'django.contrib.messages',
     'django.contrib.staticfiles',
     'blog',
-)
+]
 ```
 
 ### Tworzymy model wpisu na blogu
 
-W pliku `blog/models.py` definiujemy wszystkie obiekty zwane `modelami` - to jest miejsce, w którym zbudujemy model naszego wpisu na blogu.
+W pliku `blog/models.py` definiujemy wszystkie obiekty zwane `Models` - jest to miejsce, w którym będziemy definiować nasz wpis na blogu.
 
 Otwórz plik `blog/models.py`, usuń z niego całą zawartość i napisz taki kod:
 
+{% filename %}blog/models.py{% endfilename %}
+
 ```python
 from django.db import models
 from django.utils import timezone
 
 
 class Post(models.Model):
-    author = models.ForeignKey('auth.User')
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
     created_date = models.DateTimeField(
@@ -130,44 +140,53 @@ class Post(models.Model):
         return self.title
 ```
 
-> Upewnij się, czy na początku i końcu `str` używasz dokładnie dwóch znaków podkreślenia (`_`). W Pythonie używa się ich bardzo często i czasem nazywa się je "dunder" (skrót od angielskiej nazwy: "double-underscore").
+> Upewnij się, że używasz dwóch znaków podkreślenia (`_`) po obu stronach `str`. W Pythonie używa się ich bardzo często i czasem nazywa się je "dunder" (skrót od angielskiej nazwy: "double-underscore").
 
-Wygląda przerażająco, co? Ale nie martw się, wyjaśnimy o co chodzi linijka po linijce!
+Wygląda przerażająco, prawda? Ale nie martw się - będziemy tłumaczyć co te linijki znaczą!
 
-Wszystkie wiersze zaczynające się od `from` lub `import` są wierszami dodającymi jakieś elementy z innych plików. Czyli zamiast kopiowania i wklejania tych samych treści w każdym pliku, możemy po prostu zawrzeć ich fragmenty za pomocą `from ... import ...`.
+Wszystkie wiersze zaczynające się od `from` lub `import` są wierszami dodającymi jakieś elementy z innych plików. Czyli zamiast kopiowania i wklejania tych samych treści w każdym pliku, możemy po prostu zawrzeć ich fragmenty za pomocą `from... import ...`.
 
 `class Post(models.Model):` - ta linijka definiuje nasz model (jest on obiektem, czyli `object`).
 
-*   `class` to specjalne słowo kluczowe, które sygnalizuje, że tworzymy obiekt.
-*   `Post` to nazwa naszego modelu. Możemy nadać mu inną nazwę (bez polskich liter, znaków specjalnych i spacji). Zawsze zaczynaj nazwę modelu wielką literą.
-*   `models.Model` oznacza, że nasz obiekt Post jest modelem Django. W ten sposób Django wie, że powinien go przechowywać w bazie danych.
+- `class` to specjalne słowo kluczowe, które sygnalizuje, że tworzymy obiekt.
+- `Post` to nazwa naszego modelu. Możemy nadać mu inną nazwę (bez polskich liter, znaków specjalnych i spacji). Zawsze zaczynaj nazwę modelu wielką literą.
+- `models.Model` oznacza, że nasz obiekt Post jest modelem Django. W ten sposób Django wie, że powinien go przechowywać w bazie danych.
 
-Teraz dodamy właściwości, o których wspomniałyśmy już wcześniej: `title` (tytuł), `text` (treść wpisu), `created_date` (data utworzenia), `published_date` (data publikacji) oraz `author` (autor). Do tego celu potrzebujemy określić typ pola (Czy jest to tekst? Liczba? Data? Odwołanie do innego obiektu, np. użytkownika?).
+Teraz dodamy właściwości, o których wspomniałyśmy już wcześniej: `title` (tytuł), `text` (treść wpisu), `created_date` (data utworzenia), `published_date` (data publikacji) oraz `author` (autor). Do tego celu potrzebujemy określić typ każdego pola (Czy to jest tekst? Liczba? Data? Odwołanie do innego obiektu, np. Użytkownika?)
 
-*   `models.CharField` - tak definiujemy tekst z ograniczoną liczbą znaków.
-*   `models.TextField` - a to nadaje się do dłuższych tekstów bez ograniczeń w ilości znaków. Dla treści wpisu będzie idealne, prawda?
-*   `models.DateTimeField` - to jest data i godzina.
-*   `models.ForeignKey` - to jest odnośnik do innego modelu.
+- `models.CharField` - tak definiujemy tekst z ograniczoną liczbą znaków.
+- `models.TextField` - a to nadaje się do dłuższych tekstów bez ograniczeń w ilości znaków. Dla treści wpisu będzie idealne, prawda?
+- `models.DateTimeField` - to jest data i godzina.
+- `models.ForeignKey` - to jest odnośnik do innego modelu.
 
-Nie będziemy tutaj wyjaśniać drobiazgowo każdego elementu kodu, gdyż zajęłoby to zbyt dużo czasu. Zajrzyj do dokumentacji Django, jeżeli chcesz dowiedzieć się więcej o polach modelu oraz jak definiować typy inne niż opisywane powyżej (https://docs.djangoproject.com/en/1.8/ref/models/fields/#field-types).
+Nie będziemy tutaj wyjaśniać drobiazgowo każdego elementu kodu, gdyż zajęłoby to zbyt dużo czasu. Zajrzyj do dokumentacji Django, jeżeli chcesz dowiedzieć się więcej o polach modelu oraz jak definiować rzeczy inne niż opisane powyżej (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
 
-A co to takiego `def publish(self):`? To nic innego, jak nasza metoda publikująca wpis, o której wspominałyśmy wcześniej. Wyraz `def` oznacza, że mamy do czynienia z funkcją/metodą, a `publish` to nazwa metody. Możesz zmienić nazwę, jeśli chcesz. Zasadą jest, że używamy małych liter oraz znaków podkreślenia zamiast spacji. Na przykład, gdybyś chciała dodać metodę, która oblicza średnią cenę, mogłabyś ją nazwać `calculate_average_price` lub oblicz_srednia_cene.
+A co to takiego `def publish(self):`? To jest dokładnie metoda publikująca wpis (`publish`), o której wspominaliśmy wcześniej. Wyraz `def` oznacza, że mamy do czynienia z funkcją/metodą, a `publish` to nazwa metody. Możesz zmienić nazwę metody, jeśli chcesz. Zasadą jest, że używamy małych liter oraz znaków podkreślenia zamiast spacji. Na przykład metodę, która oblicza średnią cenę, można nazwać `calculate_average_price`.
 
 Bardzo często metody coś zwracają (ang. `return`). Przykład tego znajdziesz w metodzie `__str__`. W tym przypadku wywołując metodę `__str__()` otrzymamy tekst (**string**) zawierający tytuł wpisu.
 
-Jeżeli coś nadal nie jest jasne odnośnie modeli, nie bój się zapytać osoby prowadzącej kurs! Zdajemy sobie sprawę, że jest to dość skomplikowane, zwłaszcza gdy poznajesz funkcje i obiekty w tym samym czasie. Mimo wszystko mamy nadzieję, że udało nam się chociaż odrobinę rozjaśnić temat!
+Również należy zauważyć, że zarówno `def publish(self):` i `def __str__(self):` są wcięte wewnątrz naszej klasy. Ponieważ Python jest wrażliwy na odstępy, musimy wciąć nasze metody wewnątrz klasy. W przeciwnym razie metody nie będą należeć do klasy i można uzyskać nieoczekiwane zachowanie.
+
+Jeśli coś nie jest jeszcze jasne w modelach, nie wahaj się zapytać swojego mentora! Zdajemy sobie sprawę, że jest to dość skomplikowane, zwłaszcza gdy poznajesz obiekty i funkcje w tym samym czasie. But hopefully it looks slightly less magic for you now!
 
 ### Tworzymy tabele dla modeli w bazie danych
 
-Został nam ostatni krok, a mianowicie dodanie naszego nowego modelu do bazy danych. Najpierw musimy poinformować Django, że coś w naszym modelu zostało zmienione (właśnie go utworzyłyśmy!). Wpisz `python manage.py makemigrations blog`. Efekt będzie wyglądał tak:
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py makemigrations blog
     Migrations for 'blog':
-      0001_initial.py:
+      blog/migrations/0001_initial.py:
+    
       - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
 
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
 
-Django przygotował za nas plik z migracjami, które musimy teraz wykonać na naszej bazie danych. Wpisz `python manage.py migrate blog`. Powinnaś zobaczyć coś takiego:
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py migrate blog
     Operations to perform:
@@ -175,6 +194,6 @@ Django przygotował za nas plik z migracjami, które musimy teraz wykonać na na
     Running migrations:
       Rendering model states... DONE
       Applying blog.0001_initial... OK
+    
 
-
-Hurra! Nasz model wpisu na blogu znalazł się w bazie danych! Fajnie byłoby go zobaczyć, co? Aby sprawdzić jak wygląda nasz wpis, przejdź do następnego rozdziału!
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/pl/django_orm/README.md b/pl/django_orm/README.md
index 44aca464b68..9fca8d8e2a4 100755
--- a/pl/django_orm/README.md
+++ b/pl/django_orm/README.md
@@ -4,7 +4,7 @@ Z tego rozdziału dowiesz się, w jaki sposób Django łączy się z bazą danyc
 
 ## Czym jest QuerySet?
 
-Najprościej mówiąc, QuerySet jest listą obiektów danego modelu. Za jego pomocą możesz wczytywać informacje z bazy danych, jak również je filtrować i układać w określonej kolejności.
+Najprościej mówiąc, QuerySet jest listą obiektów danego Modelu. Za jego pomocą możesz odczytywać informacje z bazy danych, jak również je filtrować i układać w określonej kolejności.
 
 Najłatwiej uczyć się na przykładach. To co, spróbujemy?
 
@@ -12,14 +12,19 @@ Najłatwiej uczyć się na przykładach. To co, spróbujemy?
 
 Otwórz swoją lokalną konsolę Django (nie na PythonAnywhere) i wpisz następujące polecenie:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py shell
     
 
 Efekt powinien wyglądać tak:
 
-    (InteractiveConsole)
-    >>>
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
 
 Jesteś teraz w intrektywnej konsoli Django. Przypomina ona nieco wiersz poleceń Pythona, z odrobiną dodatkowej magii Django :) Oczywiście możesz także używać w niej wszystkich poleceń Pythona.
 
@@ -27,22 +32,31 @@ Jesteś teraz w intrektywnej konsoli Django. Przypomina ona nieco wiersz polece
 
 Na początek spróbujmy wyświetlić wszystkie nasze wpisy. Zrób to następującym poleceniem:
 
-    >>> Post.objects.all()
-    Traceback (most recent call last):
-          File "<console>", line 1, in <module>
-    NameError: name 'Post' is not defined
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
 
 Ups! Wyskoczył błąd. Mówi on nam, że nie istnieje coś takiego jak 'Post'. Oczywiście -- zapomniałyśmy go wcześniej zaimportować!
 
-    >>> from blog.models import Post
-    
+{% filename %}command-line{% endfilename %}
 
-Nic skomplikowanego: importujemy model `Post` z `blog.models`. Spróbujmy jeszcze raz wyświetlić wszystkie wpisy:
+```python
+>>> from blog.models import Post
+```
 
-    >>> Post.objects.all()
-    <QuerySet [<Post: Mój pierwszy wpis>, <Post: Kolejny tytuł wpisu>]>
-    
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
 
 Pojawiła się lista wpisów, które dodałyśmy wcześniej! Utworzyłyśmy je przy pomocy panelu administracyjnego Django. Teraz jednak chciałybyśmy dodać nowy wpis używając Pythona. Jak to zrobimy?
 
@@ -50,99 +64,140 @@ Pojawiła się lista wpisów, które dodałyśmy wcześniej! Utworzyłyśmy je p
 
 W taki sposób tworzymy nowy obiekt Post w bazie danych:
 
-    >>> Post.objects.create(author=me, title='Przykładowy tytuł', text='Test')
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
 
 Ale brakuje nam jednego składnika: `me`. Musimy przekazać instancję modelu `User` jako autora. Jak to zrobić?
 
 Najpierw zaimportujmy model User:
 
-    >>> from django.contrib.auth.models import User
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
 
 Jakich użytkowników mamy w bazie danych? Spróbuj tak:
 
-    >>> User.objects.all()
-    <QuerySet [<User: ola>]>
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
 
 To konto administratora, które stworzyłyśmy wcześniej! Teraz uzyskajmy dostęp do naszej instancji użytkownika:
 
-    me = User.objects.get(username='ola')
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
 
 Jak widzisz, za pomocą polecenia `get` pobrałyśmy z bazy obiekt użytkownika (`User`) z właściwością `username` o wartości 'ola'. Elegancko! Oczywiście musisz wprowadzić tam swoją nazwę użytkownika.
 
 Teraz możemy wreszcie stworzyć nasz post:
 
-    >>> Post.objects.create(author=me, title='Przykładowy tytuł', text='Test')
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
 
 Hura! Chciałabyś sprawdzić, czy się udało?
 
-    >>> Post.objects.all()
-    <QuerySet [<Post: Mój pierwszy wpis>, <Post: Kolejny tytuł wpisu>, <Post: Przykładowy tytuł>]>
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
 
 Jest! Kolejny post na liście!
 
 ### Dodajemy więcej wpisów
 
-Możesz teraz się pobawić i utworzyć więcej wpisów, żeby zobaczyć, jak to działa. Dodaj jeszcze 2-3 i jedziemy do następnej części.
+Możesz teraz trochę się zabawić i dodać więcej postów, aby zobaczyć, jak to działa. Dodaj dwa lub trzy kolejne, a następnie przejdź do następnej części.
 
 ### Filtrowanie obiektów
 
-Niezmiernie istotną cechą QuerySetów jest możliwość ich filtrowania. Dajmy na to, że chciałybyśmy znaleźć wszystkie wpisy dodane przez użytkowniczkę (User) o nazwie ola. Skorzystamy z metody `filter` zamiast `all` w `Post.objects.all()`. W nawiasach wpiszemy jeden lub więcej warunków, które muszą zostać spełnione, żeby nasz wpis znalazł się w QuerySecie. W naszej sytuacji chcemy, by `author` (autor) odpowiadał zmiennej `me`. W Django zapisujemy to tak: `author=me`. Teraz nasz kawałek kodu wygląda mniej więcej tak:
+Niezmiernie istotną cechą QuerySetów jest możliwość ich filtrowania. Dajmy na to, że chciałybyśmy znaleźć wszystkie wpisy dodane przez użytkowniczkę (User) o nazwie ola. Skorzystamy z metody `filter` zamiast `all` w `Post.objects.all()`. W nawiasach podajemy, jaki warunek bądź warunki muszą spełniać posty na blogu, aby znaleźć się w naszym zapytaniu. W naszej sytuacji chcemy, by `author` (autor) odpowiadał zmiennej `me`. W Django zapisujemy to tak: `author=me`. Teraz nasz kawałek kodu wygląda mniej-więcej tak:
 
-    >>> Post.objects.filter(author=me)
-    <QuerySet [<Post: Mój pierwszy wpis>, <Post: Kolejny tytuł wpisu>, <Post: Przykładowy tytuł>, <Post: Wpis numer 2>, <Post: Mój trzeci post!>, <Post: Czwarty tytuł>]>
-    
+{% filename %}command-line{% endfilename %}
 
-A gdybyśmy chciały wyświetlić wszystkie wpisy zawierające słowo 'title' w polu `tytuł`?
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
 
-    >>> Post.objects.filter(title__contains = 'tytuł')
-    <QuerySet [<Post: Kolejny tytuł wpisu>, <Post: Przykładowy tytuł>, <Post: Czwarty tytuł>]>
-    
+A może chcemy zobaczyć wszystkie posty, które zawierają słowo "tytuł" w polu `title`?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains = 'title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
 
 > **Uwaga:** Pomiędzy `title` a `contains` znajdują się dwa znaki podkreślenia (`_`). ORM w Django używa takiej składni, aby oddzielić nazwy pól ("title") od operacji lub filtrów ("contains"). Jeśli użyjesz tylko jednego, zobaczysz błąd o treści "FieldError: Cannot resolve keyword title_contains".
 
 Możemy także wyświetlić listę wszystkich opublikowanych wpisów. W tym celu odfiltrujmy wszystkie wpisy, które mają ustawioną datę publikacji (`published_date`) na taką, która już minęła:
 
-    >>> from django.utils import timezone
-    >>> Post.objects.filter(published_date__lte=timezone.now())
-    []
+{% filename %}command-line{% endfilename %}
 
->(filtr `lte` oznacza `less than or equal`, czyli `mniejszy od lub równy` - co w naszym przykładzie można rozumieć jako 'z datą publikacji dzisiejszą lub wcześniejszą /mniejszą od dzisiejszej/). Obiekt `timezone.now()` oznacza właśnie aktualną datę i godzinę. 
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
 
-Niestety, żaden z naszych wpisów, które dodaliśmy przez konsolę, nie został jeszcze opublikowany (mogą oczywiście w tym QuerySecie pojawić się wpisy dodane wcześniej w panelu admina, dla których zdefiniowałaś datę publikacji). Zmieńmy to! Zacznij od pobrania wpisu, który chcesz opublikować:
+Niestety, post dodany przez nas z konsoli Pythona nie został jeszcze opublikowany. Ale możemy to zmienić! Zacznij od pobrania wpisu, który chcesz opublikować:
 
-    >>> post = Post.objects.get(title="Przykładowy tytuł")
-    
+{% filename %}command-line{% endfilename %}
 
-A następnie opublikuj go za pomocą metody `publish`!
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
 
-    >>> post.publish()
-    
+A następnie opublikuj go za pomocą metody `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
 
 Teraz spróbujmy jeszcze raz wyświetlić listę opublikowanych wpisów (wciśnij trzykrotnie klawisz ze strzałką do góry, a następnie zatwierdź klawiszem `Enter`):
 
-    >>> Post.objects.filter(published_date__lte=timezone.now())
-    <QuerySet [<Post: Przykładowy tytuł>]>
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
 
 ### Kolejność obiektów
 
 QuerySety umożliwiają również porządkowanie list obiektów według określonej kolejności. Spróbujmy uporządkować je według daty utworzenia, czyli zawartości pola `created_date`:
 
-    >>> Post.objects.all().order_by('created_date')
-    <QuerySet [<Post: Mój pierwszy wpis>, <Post: Kolejny tytuł wpisu>, <Post: Przykładowy tytuł>, <Post: Wpis numer 2>, <Post: Mój trzeci post!>, <Post: Czwarty tytuł>]>
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all().order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
 
 Możemy także odwrócić kolejność poprzez dodanie `-` na początku:
 
-    >>> Post.objects.all().order_by('-created_date')
-    <QuerySet [<Post: Czwarty tytuł>, <Post: Mój trzeci post!>, <Post: Wpis numer 2>, <Post: Przykładowy tytuł>, <Post: Kolejny tytuł wpisu>, <Post: Mój pierwszy wpis>]>
-    
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all().order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
 
 ### Łączenie QuerySetów
 
@@ -155,5 +210,9 @@ To naprawdę potężne narzędzie, które pozwala na pisanie bardzo złożonych
 
 Doskonale! Jesteś teraz gotowa na następną część! Zamknij konsolę poleceniem:
 
-    >>> exit()
-    $
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/pl/django_start_project/README.md b/pl/django_start_project/README.md
index 77182c39ecb..fb35f49dda2 100755
--- a/pl/django_start_project/README.md
+++ b/pl/django_start_project/README.md
@@ -1,46 +1,61 @@
 # Twój pierwszy projekt w Django!
 
-> Fragment tego rozdziału jest oparty o tutoriale Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
->
-> Fragmenty tego rozdziału są oparte o [tutorial django-marcador][1] na licencji Creative Commons Attribution-ShareAlike International 4.0. Tutorial django-marcador jest chroniony prawami autorskimi przez Markusa Zapke-Gründemanna i in.
+> Fragment tego rozdziału opiera się o tutoriale Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Fragmenty tego rozdziału są oparte o [tutorial django-marcador](http://django-marcador.keimlink.de/) na licencji Creative Commons Attribution-ShareAlike International 4.0. Tutorial django-marcador jest chroniony prawami autorskimi przez Markusa Zapke-Gründemanna i in.
 
- [1]: http://django-marcador.keimlink.de/
-
-Mamy zamiar stworzyć prostego bloga!
+We're going to create a small blog!
 
 Pierwszy krok, który trzeba wykonać, to utworzenie nowego projektu Django. To oznacza, że skorzystamy z dostarczonych przez Django skryptów, które utworzą za nas szkielet projektu Django. Ten szkielet to zbiór katalogów i plików, których będziemy używać później.
 
 Nazwy niektórych plików i katalogów są bardzo ważne dla Django. Nie powinnaś zmieniać nazw plików, które zostaną utworzone. Przenoszenie ich w inne miejsce też nie jest dobrym pomysłem. Django wymaga zachowania pewnej struktury, by móc szybko znaleźć potrzebne rzeczy.
 
-> Pamiętaj, aby uruchamiać wszystko w virtualenv. Jeśli nie widzisz prefiksu `(myvenv)` w konsoli, to znaczy że musisz uruchomić swój virtualenv. Wyjaśniłyśmy, jak to zrobić w rozdziale **Instalacja Django** w części **Praca z virtualenv**. Wystarczy wpisać `myvenv\Scripts\activate` w systemie Windows lub `source myvenv/bin/activate`, jeśli używasz Mac OS / Linux.
+> Pamiętaj, aby uruchamiać wszystko w virtualenv. Jeśli nie widzisz prefiksu `(myvenv)` w konsoli, to znaczy że musisz uruchomić swój virtualenv. Wyjaśniłyśmy, jak to zrobić w rozdziale **Instalacja Django** w części **Praca z virtualenv**. Wystarczy wpisać `myvenv\Scripts\activate` w systemie Windows lub `source myvenv/bin/activate`, jeśli używasz Mac OS X lub Linux.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
 
-Dla systemów MacOS lub Linux; wpisz teraz do swojej konsoli następującą komendę; ** nie zapomnij dodać kropki `.` na końcu**:
+Dla systemów MacOS X lub Linux, wpisz teraz do swojej konsoli następującą komendę. **Nie zapomnij dodać kropki `.` na końcu!**
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Kropka `.` ma kluczowe znaczenie, ponieważ dzięki niej skrypt wie, że ma zainstalować Django w bieżącym katalogu (kropka `.` to taka skrócona nazwa bieżącego katalogu).
+> 
+> **Uwaga** Kiedy będziesz przepisywać komedy, które zamieściliśmy wyżej, pamiętaj, że przepisujesz tylko tę część, która zaczyna się od `django-admin`. `(myvenv) ~/djangogirls$` są tutaj tylko po to, by pokazać Ci przykład linii poleceń i tego jak ona będzie wyglądała, gdy będziesz do niej wpisywać polecenia.
 
+<!--endsec-->
 
-Dla Windows; **nie zapomnij dodać kropki `.` na końcu**:
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
 
-    (myvenv) C:\Users\Name\djangogirls> django-admin startproject mysite .
+Dla systemu Windows wpisz teraz do swojej konsoli następującą komendę. **Nie zapomnij dodać kropki `.` na końcu**:
 
+{% filename %}command-line{% endfilename %}
 
-> Kropka `.` ma kluczowe znaczenie, ponieważ dzięki niej skrypt wie, że ma zainicjować projekt Django w bieżącym katalogu (kropka `.` to taka skrócona nazwa bieżącego katalogu)
->
-> **Uwaga** Kiedy będziesz przepisywać komedy, które zamieściliśmy wyżej, pamiętaj, że przepisujesz tylko tę część, która zaczyna się od `django-admin` lub `django-admin.py`. Te `(myvenv) ~/djangogirls$` i `(myvenv) C:\Users\Name\djangogirls>` (zwane z ang. promptem) są tutaj tylko po to, by pokazać Ci przykład linii poleceń i tego jak ona będzie wyglądała, gdy będziesz do niej wpisywać polecenia.
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Kropka `.` ma kluczowe znaczenie, ponieważ dzięki niej skrypt wie, że ma zainstalować Django w bieżącym katalogu (kropka `.` to taka skrócona nazwa bieżącego katalogu).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
 
 `django-admin.py` jest skryptem, który utworzy katalogi i pliki za Ciebie. Powinnaś mieć teraz strukturę katalogów podobną do tej:
 
     djangogirls
-    ├── mysite
-    │   ├── __init__.py
-    │   ├── settings.py
-    │   ├── urls.py
-    │   └── wsgi.py
-    ├── myvenv
-    └── manage.py
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
 
+> **Uwaga**: w strukturze katalogów, możesz zobaczyć również katalog `venv`, który stworzyliśmy wcześniej.
 
-`manage.py` jest skryptem ułatwiającym zarządzanie aplikacją. Za jego pomocą, oprócz wielu innych rzeczy, możemy uruchomić serwer na naszym komputerze bez potrzeby instalowania czegokolwiek.
+`manage.py` jest skryptem ułatwiającym zarządzanie witryną. Za jego pomocą, oprócz wielu innych rzeczy, możemy uruchomić serwer na naszym komputerze bez potrzeby instalowania czegokolwiek.
 
 Plik `settings.py` zawiera konfigurację naszej strony.
 
@@ -52,31 +67,57 @@ Na razie zapomnijmy o innych plikach - nie będziemy ich modyfikować. Jedyne, o
 
 Wprowadźmy parę zmian w pliku `mysite/settings.py`. Otwórz go za pomocą edytora kodu, który zainstalowałaś wcześniej.
 
-Fajnie byłoby posługiwać się na naszej stronie właściwą strefą czasową. Przejdź do [listy stref czasowych w wikipedii][2] i skopiuj właściwą strefę czasową (TZ). (np. `Europe/Warsaw` )
+**Uwaga**: należy pamiętać, że `settings.py` jest zwykłym plikiem, jak każdy inny. Otworzysz go w edytorze kodu, przy użyciu menu "plik-> Otwórz". Powinieneś otrzymać zwykłe okno, w którym możesz przejść do pliku `settings.py` i zaznaczyć go. Możesz również otworzyć plik, przechodząc do folderu djangogirls na pulpicie, klikając na niego prawym przyciskiem myszy. Następnie wybierz edytor kodu z listy. Wybór edytora jest ważny, ponieważ możesz mieć zainstalowane inne programy, które mogą otworzyć plik, ale nie pozwolą ci go edytować.
 
- [2]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+Fajnie byłoby posługiwać się na naszej stronie właściwą strefą czasową. Przejdź do [listy stref czasowych w Wikipedii](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) i skopiuj właściwą strefę czasową (TZ) (np. `Europe/Warsaw`).
 
-W pliku settings.py znajdź linijkę, w której jest napisane `TIME_ZONE` i zmień ją według swoich potrzeb:
+W pliku `settings.py` znajdź linijkę, w której jest napisane `TIME_ZONE` i zmień ją wybierając swoją strefę czasową. Przykład:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 TIME_ZONE = 'Europe/Warsaw'
 ```
 
-Gdzie odpowiednio zmienisz "Europe/Warsaw"
+Kod języka składa się z języka, np. ` en ` dla języka angielskiego lub ` de ` dla języka niemieckiego i kodu kraju, np. ` de ` dla Niemiec lub ` ch ` dla Szwajcarii. Jeśli chciałabyś, aby domyślne przyciski i powiadomienia od Django były w Twoim języku, możesz to dodać. Tak więc przycisk "Anuluj" zostałby przetłumaczony na język, który tu zdefiniowałeś. [Django jest wyposażony w mnóstwo przygotowanych tłumaczeń](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Zmień kod języka, zmieniając następujący wiersz:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Musimy także dodać ścieżkę do plików statycznych. (Dowiemy się więcej o plikach statycznych i CSS w dalszej części kursu). Przejdź do samego *końca* pliku i pod linijką zawierającą `STATIC_URL` dodaj nową zmienną `STATIC_ROOT`:
 
-Musimy także dodać ścieżkę do plików statycznych (dowiesz się więcej o plikach statycznych i CSS w dalszej części kursu). Przejdź do samego końca pliku i pod linijką zawierającą `STATIC_URL` dodaj nową zmienną `STATIC_ROOT`:
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 STATIC_URL = '/static/'
-STATIC_ROOT = os.path.join(BASE_DIR, 'public', 'static')
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
 ```
 
-## Ustawienie bazy danych
+Gdy ` DEBUG ` jest ` True ` i ` ALLOWED_HOSTS ` jest puste, host jest sprawdzany pod kątem ` ['localhost', '127.0.0.1', '[::1]']`. To nie będzie pasować do naszej nazwy hosta w PythonAnywhere po wdrożeniu naszej aplikacji, więc zmienimy następujące ustawienie:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> ** Uwaga **: jeśli używasz Chromebooka, dodaj ten wiersz u dołu pliku settings.py: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Inicjalizacja bazy danych
 
 Istnieje duży wybór baz danych, w których możemy trzymać dane naszej strony. My użyjemy bazy domyślnej, czyli `sqlite3`.
 
 Została ona już ustawiona w tej części pliku `mysite/settings.py`:
 
+{% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 DATABASES = {
     'default': {
@@ -84,55 +125,78 @@ DATABASES = {
         'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
     }
 }
-```  
+```
+
+Aby utworzyć bazę danych dla naszego bloga, wykonajmy następujące polecenie w konsoli: `python manage.py syncdb` (musimy być w katalogu `djangogirls`, tam gdzie znajduje się plik `manage.py`). Gdy to się uda, powinnaś zobaczyć coś takiego jak poniżej:
 
-Aby utworzyć bazę danych dla naszego bloga, wykonajmy następujące polecenie w konsoli: `python manage.py migrate` (musimy być w katalogu `djangogirls`, tam gdzie znajduje się plik `manage.py`). Gdy to się uda, powinnaś zobaczyć coś takiego jak poniżej:
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py migrate
     Operations to perform:
-      Synchronize unmigrated apps: messages, staticfiles
-      Apply all migrations: contenttypes, sessions, admin, auth
-    Synchronizing apps without migrations:
-       Creating tables...
-          Running deferred SQL...
-       Installing custom SQL...
+      Apply all migrations: auth, admin, contenttypes, sessions
     Running migrations:
       Rendering model states... DONE
       Applying contenttypes.0001_initial... OK
       Applying auth.0001_initial... OK
       Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
       Applying contenttypes.0002_remove_content_type_name... OK
       Applying auth.0002_alter_permission_name_max_length... OK
       Applying auth.0003_alter_user_email_max_length... OK
       Applying auth.0004_alter_user_username_opts... OK
       Applying auth.0005_alter_user_last_login_null... OK
       Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
       Applying sessions.0001_initial... OK
-
+    
 
 I to wszystko! Czas uruchomić serwer i zobaczyć, czy nasza strona działa!
 
+## Uruchamianie serwera www
+
 Musisz znajdować się w katalogu zawierającym plik `manage.py` (katalog `djangogirls`). W konsoli możemy uruchomić serwer za pomocą polecenia `python manage.py runserver`:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Jeżeli korzystasz z Chromebooka, wykorzystaj komendę poniżej:
 
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
 
 Jeśli pracujesz na Windowsie i zobaczysz w tym momencie `UnicodeDecodeError`, użyj następującej komendy:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
 
+Teraz wszystko, co musisz zrobić, to sprawdzić, czy Twoja strona działa. Otwórz przeglądarkę (Firefox, Chrome, Safari, Internet Explorer lub cokolwiek innego) i wprowadź ten adres:
 
-Teraz pozostaje Ci jedynie przekonać się, czy Twoja strona działa. Otwórz przeglądarkę (Firefox, Chrome, Safari, Internet Explorer czy inną, której używasz) i wpisz adres:
+{% filename %}browser{% endfilename %}
 
     http://127.0.0.1:8000/
+    
 
+Jeśli używasz Chromebooka, zawsze odwiedzasz serwer testowy, uzyskując dostęp do:
 
-Serwer przejmie Twój wiersz poleceń i będzie go używał cały czas dopóki go nie wyłączysz. By móc wykonywać inne polecenia, otwórz nowe okienko terminala i uruchom w nim środowisko virtualenv. Aby zatrzymać serwer, wróć do okienka, w którym został on uruchomiony i wciśnij CTRL+C - klawisze Control i C jednocześnie (jeśli używasz systemu Windows to możesz też spróbować skrótu Ctrl+Break).
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
 
 Gratulacje! Właśnie stworzyłaś swoją pierwszą stronę i uruchomiłaś ją za pomocą serwera! Prawda, że wspaniale?
 
-![Działa!][3]
+![Działa!](images/it_worked2.png)
+
+Kiedy serwer internetowy jest uruchomiony, nie możesz zobaczyć nowego wiersza poleceń do wprowadzania dodatkowych poleceń. Terminal przyjmie nowy tekst, ale nie wykona nowego polecenia. Dzieje się tak dlatego, że serwer internetowy ciągle działa, aby nasłuchiwać przychodzących żądań.
+
+> Sprawdziliśmy, jak działają serwery internetowe w rozdziale **"Jak działa Internet"**.
 
- [3]: images/it_worked2.png
+Aby wpisać dodatkowe polecenia podczas działania serwera, otwórz nowe okno terminala i aktywuj virtualenv. Aby zatrzymać serwer, wróć do okienka, w którym został on uruchomiony i wciśnij CTRL+C - klawisze Control i C jednocześnie (jeśli używasz systemu Windows to możesz też spróbować skrótu Ctrl+Break).
 
-Gotowa na następny krok? Czas stworzyć treść!
+Gotowa na następny krok? Czas stworzyć treść!
\ No newline at end of file
diff --git a/pl/django_templates/README.md b/pl/django_templates/README.md
index a29267da81a..50e7688bcd8 100755
--- a/pl/django_templates/README.md
+++ b/pl/django_templates/README.md
@@ -4,9 +4,9 @@ Pora wyświetlić jakieś dane! Django udostępnia nam do tego celu przydatny zb
 
 ## Co to są znaczniki szablonu?
 
-Widzisz, w HTML nie da się używać kodu napisanego w Pythonie, ponieważ przeglądarki go nie zrozumieją. Jedyne, co rozumieją to HTML. Wiemy, że HTML jest raczej statyczny, podczas gdy Python jest znacznie bardziej dynamiczny.
+W HTML-u nie można tak naprawdę napisać kodu Pythona, ponieważ przeglądarki go nie rozumieją. Znają tylko HTML. Wiemy, że HTML jest raczej statyczny, a Python jest znacznie bardziej dynamiczny.
 
-Za pomocą **znaczników szablonu Django** możemy przemycić elementy Pythona w naszym kodzie HTML, dzięki czemu budowanie dynamicznym stron jest szybsze i łatwiejsze. Hura!
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
 ## Wyświetlamy szablon listy wpisów
 
@@ -14,23 +14,28 @@ W poprzednim rozdziale przekazaliśmy listę postów w zmiennej `posts` do nasze
 
 Aby wyświetlić zmienną w szablonie Django, używamy podwójnych nawiasów klamrowych z nazwą zmiennej w środku, w taki sposób:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {{ posts }}
 ```
 
 Spróbuj tak zrobić w szablonie` blog/templates/blog/post_list.html`. Zastąp wszystko od drugiego `<div>` do trzeciego `</div>` wierszem `{{ posts }}`. Zapisz plik i odśwież stronę, by zobaczyć rezultat:
 
-![Rysunek 13.1][1]
-
- [1]: images/step1.png
+![Rysunek 13.1](images/step1.png)
 
 Jak widzisz, dostaliśmy tylko tyle:
 
-    [<Post: My second post>, <Post: My first post>]
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
 
 Oznacza to tyle, że Django rozumie to jako listę obiektów. Pamiętasz z rozdziału **Wprowadzenie do Pythona**, jak możemy wyświetlić zawartość listy? Tak, za pomocą pętli for! W szablonie Django używamy ich w ten sposób:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     {{ post }}
@@ -39,11 +44,11 @@ Oznacza to tyle, że Django rozumie to jako listę obiektów. Pamiętasz z rozdz
 
 Wypróbuj tego w swoim szablonie.
 
-![Rysunek 13.2][2]
+![Rysunek 13.2](images/step2.png)
 
- [2]: images/step2.png
+Działa! Ale chcemy, aby posty były wyświetlane jak statyczne posty, które stworzyliśmy wcześniej w rozdziale ** Wprowadzenie do HTMLa**. Możliwe jest łączenie znaczników szablonu z kodem HTML. Nasza sekcja `body` będzie wyglądać tak:
 
-Działa! Ale chcemy je wyświetlić tak samo, jak statyczne wpisy, które tworzyłyśmy wcześniej w rozdziale **Wprowadzenie do HTMLa**. Możliwe jest łączenie znaczników szablonu z kodem HTML. Nasza sekcja `body` będzie wyglądać tak:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <div>
@@ -61,46 +66,41 @@ Działa! Ale chcemy je wyświetlić tak samo, jak statyczne wpisy, które tworzy
 
 {% raw %}Wszystko, co zawrzesz pomiędzy `{% for %}` a `{% endfor %}` zostanie powtórzone dla każdego obiektu z listy. Odśwież swoją stronę:{% endraw %}
 
-![Rysunek 13.3][3]
+![Rysunek 13.3](images/step3.png)
 
- [3]: images/step3.png
-
-Zapewne zauważyłaś, że tym razem użyłyśmy nieco innej składni: `{{ post.title }}` i `{{ post.text }}`? W ten sposób uzyskujemy dostęp do danych zawartych w poszczególnych polach naszego modelu `Post`. Z kolei `|linebreaksbr` przepuszcza wpisy przez filtr, który zamienia znaczniki nowej linii na akapity.
+Zapewne zauważyłaś, że tym razem użyłyśmy nieco innej składni: ` ({{ post.title }}` or `{{ post.text }})`? W ten sposób uzyskujemy dostęp do danych zawartych w poszczególnych polach naszego modelu `Post`. Z kolei `|linebreaksbr` przepuszcza wpisy przez filtr, który zamienia znaczniki nowej linii na akapity.
 
 ## Jeszcze jedno
 
-Dobrze byłoby sprawdzić, czy Twoja strona dalej działa w Internecie, prawda? Ponownie wyślijmy kod na PythonAnywhere. Oto małe przypomnienie jak to zrobić...
+Dobrze byłoby sprawdzić, czy twoja strona wciąż będzie działała w publicznym Internecie, prawda? Spróbujmy ponownie wdrożyć w PythonAnywhere. Oto podsumowanie kroków…
 
-*   Najpierw zapisz swój kod na Githubie
+* Najpierw zapisz swój kod na Githubie
 
+{% filename %}command-line{% endfilename %}
 
     $ git status
     [...]
     $ git add --all .
     $ git status
     [...]
-    $ git commit -m "Modyfikacja szablonu, by pokazywal posty z bazy danych"
+    $ git commit -m "Modified templates to display posts from database."
     [...]
     $ git push
+    
 
+* Teraz zaloguj się ponownie na [PythonAnywhere](https://www.pythonanywhere.com/consoles/) i przejdź do konsoli **Bash** (albo uruchom nową) i wpisz:
 
-*   Teraz zaloguj się ponownie na [PythonAnywhere][4] i przejdź do konsoli **Bash** (albo uruchom nową) i wpisz:
-
- [4]: https://www.pythonanywhere.com/consoles/
+{% filename %}PythonAnywhere command-line{% endfilename %}
 
     $ cd my-first-blog
     $ git pull
     [...]
+    
 
+* Na koniec przejdź do podstrony [Web tab](https://www.pythonanywhere.com/web_app_setup/) i naciśnij **Reload**. Twoja aktualizacja powinna być widoczna! Jeśli posty na blogu w witrynie PythonAnywhere nie pasują do postów znajdujących się na blogu hostowane na lokalnym serwerze, jest to OK. Bazy danych na komputerze lokalnym i Python Anywhere nie synchronizują się z resztą plików.
 
-*   Na koniec przejdź do podstrony [Web tab][5] i naciśnij **Reload**. Twoja aktualizacja powinna być widoczna!
-
- [5]: https://www.pythonanywhere.com/web_app_setup/
-
-Gratulacje! Teraz śmiało możesz dodać nowy wpis w swoim panelu administratora Django (nie zapomnij dodać published_date!). Następnie odśwież stronę, żeby sprawdzić, czy Twój wpis się tam pojawił.
-
-Poszło jak z płatka? Jesteśmy dumne! Odejdź na chwilkę od komputera, zasłużyłaś na przerwę. :)
+Gratulacje! Teraz możesz dodać nowy wpis do swojego administratora Django (pamiętaj, aby dodać publish_date!). Upewnij się, że jesteś administratorem Django dla swojej strony pythonanywhere, https://yourname.pythonanywhere.com/admin. Następnie odśwież stronę, aby sprawdzić, czy pojawia się tam wiadomość.
 
-![Rysunek 13.4][6]
+Poszło jak z płatka? Jesteśmy dumne! Odejdź na chwilkę od komputera - zasłużyłaś na przerwę. :)
 
- [6]: images/donut.png
+![Rysunek 13.4](images/donut.png)
\ No newline at end of file
diff --git a/pl/django_urls/README.md b/pl/django_urls/README.md
index a0f04882312..352f000cd99 100755
--- a/pl/django_urls/README.md
+++ b/pl/django_urls/README.md
@@ -1,42 +1,44 @@
-# Adresy URL w Django
+# URLe Django
 
-Za chwilę zbudujemy naszą pierwszą stronę - stronę główną Twojego bloga! Ale najpierw dowiedzmy się co nieco o adresach URL w Django.
+Zaczynamy budować naszą pierwszą stronę internetową: będzie to miejsce dla twojego bloga! Ale zanim zaczniemy, nauczmy się trochę na temat URLów w Django.
 
 ## Czym jest URL?
 
-Adres URL to po prostu adres w Internecie. Widzisz go za każdym razem, gdy odwiedzasz jakąkolwiek stronę - jest widoczny w pasku adresu Twojej przeglądarki (tak! `127.0.0.1:8000` jest adresem URL! http://djangogirls.org również):
+Adres URL to po prostu adres w internecie. Możesz zobaczyć URLa za każdym razem, gdy odwiedzasz stronę internetową - jest on widoczny w pasku adresu przeglądarki internetowej. (Tak! `127.0.0.1:8000` jest adresem URL! Też `https://djangogirls.org` jest adresem URL.)
 
-![Adres URL][1]
+![Adres URL](images/url.png)
 
- [1]: images/url.png
-
-Każda strona w Internecie potrzebuje własnego adresu URL. W ten sposób aplikacja wie, co wyświetlić użytkownikowi, który otworzy dany URL. W Django używamy tak zwanego `URLconf` (konfiguracji URL). Jest to zestaw wzorców, które Django stara się dopasować do otrzymanego adresu URL i na tej podstawie znaleźć właściwy widok.
+Każda strona w internecie potrzebuje własnego adresu URL. W ten sposób aplikacja wie, co wyświetlić użytkownikowi, który otworzy dany URL. W Django używamy tak zwanego `URLconf` (konfiguracji URL). URLconf to zestaw wzorców, które Django spróbuje dopasować do żądanego adresu URL, aby znaleźć poprawny widok.
 
 ## Jak działają adresy URL w Django?
 
 Otwórzmy plik `mysite/urls.py` i przyjrzyjmy się jego treści:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
-    # Examples:
-    # url(r'^$', 'mysite.views.home', name='home'),
-    # url(r'^blog/', include('blog.urls')),
-
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
 ]
 ```
 
 Jak zauważyłaś, Django coś nam już tu umieścił.
 
-Wiersze zaczynające się od `#` są komentarzami - co oznacza, że ich treść nie jest wykonywana przez Pythona. Prawda, że przydatne?
+Linie między potrójnymi cudzysłowami (` '''` lub `""" `) nazywa się docstrings - możesz zapisać je na górze pliku, klasy lub metody, aby opisać, co robi. Nie będą one uruchamiane przez Python.
 
 Adres URL panelu administracyjnego, który odwiedzałaś w poprzednim rozdziale, jest już tutaj dodany:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
 ```
 
 To znaczy, że dla każdego adresu zaczynającego się od `admin/` Django spróbuje dopasować odpowiedni *widok*. W tym przypadku używamy wielu adresów URL panelu administracyjnego, dlatego nie wypisujemy ich wszystkich w tym jednym małym pliku - tak jest czytelniej i bardziej estetycznie.
@@ -45,25 +47,24 @@ To znaczy, że dla każdego adresu zaczynającego się od `admin/` Django sprób
 
 Zastanawiałaś się, w jaki sposób Django kojarzy adresy URL z widokami? Cóż, ta część jest nieco bardziej złożona. Django wykorzystuje `regex`, czyli tzw. wyrażenia regularne. Regex posiada mnóstwo (naprawdę mnóstwo!) reguł, które tworzą wzorzec do wyszukania. To dość skomplikowany temat i nie będziemy tutaj wchodzić w szczegóły.
 
-Do zrozumienia wzorców, które stworzyłyśmy powyżej, potrzebnych jest tylko kilka reguł:
-
-    ^ oznacza początek tekstu
-    $ oznacza koniec tekstu
-    \d oznacza cyfrę
-    + oznacza, że poprzedni element powinien się powtórzyć przynajmniej raz
-    piszemy () aby uchwycić część wzorca
+Jeśli nadal chcesz zrozumieć, w jaki sposób stworzyliśmy wzorce, oto przykład tego procesu - będziemy potrzebować tylko ograniczonego podzbioru reguł, aby wyrazić wzorzec, którego szukamy, a mianowicie:
 
+* `^` oznacza początek tekstu
+* `$` oznacza koniec tekstu
+* `\d` oznacza cyfrę
+* `+` oznacza, że poprzedni element powinien się powtórzyć przynajmniej raz
+* piszemy () aby uchwycić część wzorca
 
-Inne znaki we wzorcu url będą rozumiane dosłownie.
+Inne znaki we wzorcu URL będą rozumiane dosłownie.
 
-Wyobraź sobie, że masz stronę, której adres to: `http://www.mysite.com/post/12345/`, gdzie `12345` to numer Twojego posta.
+Teraz wyobraź sobie, że masz stronę z takim adresem `http://www.mysite.com/post/12345/`, gdzie `12345` to numer Twojego posta.
 
 Pisanie osobnych widoków dla każdego numeru z osobna byłoby frustrujące. Z wyrażeniami regularnymi możemy stworzyć wzorzec, który dopasuje URL i znajdzie dla nas numer posta: `^post/(\d+)/$`. Rozbijmy go na mniejsze części, by zrozumieć, co tu się dzieje:
 
-*   **^post/** mówi Django, by skupił się na każdym adresie URL, który zaczyna się od wyrazu `post` (zaraz po `^`)
-*   **(\d+)** oznacza, że szukamy numeru (jedna lub więcej cyfr) i że chcemy go wyodrębnić
-*   **/** mówi Django, że następny w kolejności powinien się pojawić znak `/`
-*   **$** informuje, że to jest koniec adresu URL, co oznacza, że Django będzie szukał adresów kończących się na `/`
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** oznacza, że szukamy numeru (jedna lub więcej cyfr) i że chcemy go wyodrębnić
+* **/** mówi Django, że następny w kolejności powinien się pojawić znak `/`
+* **$** informuje, że to jest koniec adresu URL, co oznacza, że Django będzie szukał adresów kończących się na `/`
 
 ## Twój pierwszy adres URL w Django!
 
@@ -71,55 +72,58 @@ Czas utworzyć nasz pierwszy adres URL! Chcemy, aby adres 'http://127.0.0.1:8000
 
 Zależy nam również, aby zachować porządek w pliku `mysite/urls.py`, dlatego zaimportujemy URLe z naszej aplikacji `blog` do głównego pliku `mysite/urls.py`.
 
-Śmiało, usuń zakomentowane wiersze (zaczynające się od `#`) i dodaj wiersz nakazujący zaimportowanie `blog.urls` do głównego adresu (`''`).
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
 
 Twój plik `mysite/urls.py` powinien teraz wyglądać tak:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import include
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
     url(r'', include('blog.urls')),
 ]
 ```
 
 Django przekieruje wszystkie reguły z adresu 'http://127.0.0.1:8000/' do `blog.urls` i tam będzie szukał dalszych wskazówek.
 
-Kiedy tworzymy wyrażenia regularne w Pythonie, zawsze piszemy `r` na początku ciągu znaków. To jest podpowiedź dla Pythona, że w tym ciągu znaków mogą się znajdować znaki specjalne, które nie są przeznaczone dla niego, ponieważ oznaczają wyrażenie regularne.
+Pisząc wyrażenia regularne w Pythonie, zawsze dajemy `r` na początku ciągu znaków. To jest podpowiedź dla Pythona, że w tym ciągu znaków mogą się znajdować znaki specjalne, które nie są przeznaczone dla niego, ponieważ oznaczają wyrażenie regularne.
 
 ## blog.urls
 
-Stwórz nowy pusty plik `blog/urls.py`. Super! Teraz dodaj dwie pierwsze linijki:
+Stwórz nowy pusty plik o nazwie `urls.py` w katalogu `blog`. Dokładnie tak! Dodaj te pierwsze dwie linie:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
 from . import views
 ```
 
-Tutaj po prostu importujemy metody Django oraz wszystkie widoki (`views`) z naszej aplikacji `blog` (jeszcze nie mamy żadnych, ale dojdziemy do tego za chwilkę!)
+Tutaj importujemy funkcje `url` Django i wszystkie nasze widoki (`views`) z aplikacji `blog`. (Nie mamy jeszcze żadnych, ale do tego dojdziemy za chwilę!)
 
 Potem możemy dodać nasz pierwszy wzorzec adresu URL:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
 ]
 ```
 
-Jak widzisz, przyporządkowujemy widok (`view`) o nazwie `post_list` do adresu `^$`. To wyrażenie regularne będzie dopasowywać `^` (początek) i `$` (koniec) — połączenie tych dwóch znaków oznacza, że szukamy pustego ciągu znaków. I to się zgadza, ponieważ dla mechanizmów rozróżniających adresy w Django 'http://127.0.0.1:8000/' nie jest częścią adresu URL. Ten wzorzec będzie wskazówką dla Django, że `views.post_list` jest właściwym miejscem dla każdego, kto wejdzie na stronę poprzez adres 'http://127.0.0.1:8000/'.
-
-Ostatni kawałek `name='post_list` jest nazwą adresu URL, która będzie używana do zidentyfikowania widoku. Nazwa może być taka sama jak nazwa widoku albo kompletnie inna. W naszym projekcie będziemy używać właśnie nazw URL-i, więc ważne jest nazwanie każdego URL-a w aplikacji. Nazwy powinny być unikalne i łatwe do zapamiętania.
-
-Wszystko gra? Otwórz http://127.0.0.1:8000/ w przeglądarce, żeby zobaczyć rezultat.
+Jak widzisz, teraz przyporządkowujemy widok (`view`) o nazwie `post_list` do URL `^$`. To wyrażenie regularne będzie dopasowywać `^` (początek) po którym następuje `$` (koniec) - więc tylko pusty ciąg znaków będzie zgodny. I to się zgadza, ponieważ dla mechanizmów rozróżniających adresy w Django 'http://127.0.0.1:8000/' nie jest częścią adresu URL. Ten wzorzec będzie wskazówką dla Django, że `views.post_list` jest właściwym miejscem dla każdego, kto wejdzie na stronę poprzez adres 'http://127.0.0.1:8000/'.
 
-![Błąd][2]
+Ostatnia część, `name='post_list` jest nazwą URL, która będzie używana do zidentyfikowania widoku. Nazwa może być taka sama jak nazwa widoku albo kompletnie inna. W projekcie będziemy później używać nazw URL, więc ważne jest nazwanie każdego URL-a w aplikacji. Powinnyśmy również starać się używać nazw URL unikalnych i prostych do zapamiętania.
 
- [2]: images/error1.png
+Jeśli teraz spróbujesz odwiedzić stronę http://127.0.0.1:8000/, zobaczysz komunikat "niedostępna strona internetowa". Wynika to z faktu, że serwer (pamiętaj o wpisaniu ` runserver`?) nie jest już uruchomiony. Spójrz na okno konsoli serwera, aby dowiedzieć się, dlaczego.
 
-Gdzieś zniknęło "It works", zgadza się? Spokojnie, to tylko strona błędu, nic strasznego! Czasami ich treść okazuje się całkiem pomocna:
+![Błąd](images/error1.png)
 
-Jest napisane, iż **brakuje atrybutu 'post_list'**. Czy *post_list* czegoś Ci nie przypomina? Tak samo nazwaliśmy nasz widok! To oznacza, że wszystko jest w porządku, po prostu nie stworzyliśmy jeszcze naszego *widoku*. Nie martw się, zajmiemy się tym.
+Twoja konsola pokazuje błąd, ale nie martw się - w rzeczywistości jest to całkiem użyteczne: mówi ci, że** brak atrybutu 'post_list'**. To jest nazwa widoku (*view*), którą Django próbuje znaleźć i użyć, ale jeszcze go nie utworzyłyśmy. Na tym etapie Twój `/admin/ ` również nie będzie działać. Nie martw się, zajmiemy się tym.
 
-> Jeśli chciałabyś dowiedzieć się więcej na temat konfiguracji URL w Django, zajrzyj do oficjalnej dokumentacji: https://docs.djangoproject.com/en/1.8/topics/http/urls/
+> Jeśli chciałabyś dowiedzieć się więcej na temat konfiguracji URL w Django, zajrzyj do oficjalnej dokumentacji: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/pl/django_views/README.md b/pl/django_views/README.md
index 62094d19b69..bee8e798c64 100755
--- a/pl/django_views/README.md
+++ b/pl/django_views/README.md
@@ -1,8 +1,8 @@
-# Widoki Django - czas je stworzyć!
+# Widoki Django - czas zacząć tworzyć!
 
-Czas uporać się z błędem, który pozostawiłyśmy po poprzednim rozdziale. :)
+Czas uporać się z błędem, który pozostawiłyśmy po poprzednim rozdziale! :)
 
-*Widok* jest miejscem, w którym umieszczamy "logikę" naszej aplikacji. Pobierze on informacje od modelu, który wcześniej utworzyłaś, a następnie przekaże je do szablonu (`template`). Nauczymy się tworzyć szablony w następnym rozdziale. W Django widoki to po prostu funkcje, tylko nieco bardziej skomplikowane niż te, którymi zajmowałyśmy się w rozdziale **Wprowadzenie do Pythona**.
+*Widok* jest miejscem, w którym umieszczamy "logikę" naszej aplikacji. Pobierze on informacje od modelu, który wcześniej utworzyłaś, a następnie przekaże je do szablonu (`template`). Nauczymy się tworzyć szablony w następnym rozdziale. Widoki to po prostu funkcje w Django, tylko nieco bardziej skomplikowane niż te, którymi zajmowałyśmy się w rozdziale **Wprowadzenie do Pythona**.
 
 Widoki (ang. views) są przechowywane w pliku `views.py`. Dodajmy *views* do naszego pliku `blog/views.py`.
 
@@ -10,29 +10,35 @@ Widoki (ang. views) są przechowywane w pliku `views.py`. Dodajmy *views* do nas
 
 OK, otwórzmy ten plik i zobaczmy co siedzi w środku:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
 # Create your views here.
 ```
 
-Póki co niewiele. Najprostszy *widok* może wyglądać tak.
+Nie ma tu dużo rzeczy jeszcze.
+
+Pamiętaj, że linie zaczynające się od `#` to komentarze - oznacza to, że te linie nie będą uruchamiane przez Python.
+
+Utwórzmy *view* zgodnie z sugestią komentarza. Najprostszy widok może wyglądać tak:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Jak widzisz, zdefiniowałyśmy (`def`) funkcję zwaną `post_list`, która przyjmuje zapytanie (`request`) i zwraca (`return`) wynik funkcji zwanej `render`, której zadaniem jest wyrenderowanie (złożenie w całość) naszego szablonu `blog/post_list.html`.
+Jak widać, stworzyłyśmy funkcję (`def`) nazwaną `post_list`, która pobiera `request` i zwraca (`return`) funkcję `render`, która wyrenderuje (złoży w całość) nasz szablon `blog/post_list.html`.
 
-Zapisz plik, przejdź do http://127.0.0.1:8000/ i sprawdź, co teraz się stanie.
+Zapisz plik, przejdź do http://127.0.0.1:8000/ i zobacz co mamy.
 
 Znowu błąd! Przeczytaj, o co chodzi tym razem:
 
-![Błąd][1]
-
- [1]: images/error.png
+![Błąd](images/error.png)
 
-Tym razem jest łatwo: *TemplateDoesNotExist*, Naprawmy ten błąd i stwórzmy szablon - ale to już w następnym rozdziale!
+Przynajmniej pokazuje, że serwer jest uruchomiony ponownie, ale nadal nie wygląda dobrze, prawda? Nie martw się, to po prostu błąd strony, nic strasznego! Podobnie jak komunikaty o błędach w konsoli, są one całkiem przydatne. Możesz przeczytać, że *TemplateDoesNotExist*. Naprawmy ten błąd i stwórzmy szablon - ale to już w następnym rozdziale!
 
-> Więcej na temat widoków Django dowiesz się czytając oficjalną dokumentację: https://docs.djangoproject.com/en/1.8/topics/http/views/
+> Więcej na temat widoków Django dowiesz się czytając oficjalną dokumentację: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/pl/dynamic_data_in_templates/README.md b/pl/dynamic_data_in_templates/README.md
index 32533c1ac1b..67abea161ae 100755
--- a/pl/dynamic_data_in_templates/README.md
+++ b/pl/dynamic_data_in_templates/README.md
@@ -1,13 +1,15 @@
 # Dane dynamiczne w szablonach Django
 
-Sporo rzeczy jest już na swoim miejscu: model `Post` jest zdefiniowany w `models.py`, w `views.py` mamy `post_list`, szablon też już gotowy. Ale jak to zrobić, aby nasze wpisy pojawiały się w szablonie HTML? Bo to właśnie chcemy osiągnąć: pobrać treści (czyli modele zapisane w bazie) i ładnie je wyświetlić w szablonie, prawda?
+Sporo rzeczy jest już na swoim miejscu: model `Post` jest zdefiniowany w `models.py`, w `views.py` mamy `post_list`, szablon też już gotowy. Ale jak to zrobić, aby nasze wpisy pojawiały się w szablonie HTML? Bo właśnie to chcemy zrobić - pobrać trochę treści (modele zapisane w bazie danych) i ładnie je wyświetlić w naszym szablonie, prawda?
 
-Dokładnie do tego przydadzą nam się *widoki*: do połączenia modeli i szablonów między sobą. W naszym widoku (*view*) `post_list` musimy pobrać modele do wyświetlenia i przekazać je do szablonu. Innymi słowy, w naszym *widoku* decydujemy o tym, co (czyt. jaki model lub modele) zostanie wyświetlony w szablonie.
+Dokładnie do tego przydadzą nam się *widoki*: do połączenia modeli i szablonów między sobą. W naszym widoku (*view*) `post_list` musimy pobrać modele do wyświetlenia i przekazać je do szablonu. W widoku *view* decydujemy, jaki (model) zostanie wyświetlony w szablonie.
 
-OK, zatem jak możemy to osiągnąć?
+OK, więc jak to osiągniemy?
 
 Musimy otworzyć nasz plik `blog/views.py`. Jak dotąd *widok* `post_list` wygląda następująco:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
@@ -15,29 +17,34 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Pamiętasz, jak rozmawiałyśmy o dołączaniu kodu zapisanego w odrębnych plikach? Teraz przyszedł czas na dołączenie modelu, który napisałyśmy wcześniej w `models.py`. Dodajmy wiersz `from .models import Post` w następujący sposób:
+Pamiętasz, jak rozmawiałyśmy o dołączaniu kodu zapisanego w odrębnych plikach? Teraz jest moment, w którym musimy uwzględnić model, który napisałyśmy w `models.py`. Dodajmy wiersz `from .models import Post` w ten sposób:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
 from .models import Post
 ```
 
-Kropka po `from` oznacza *bieżący katalog* lub *biężącą aplikację*. Jako że pliki `views.py` i `models.py` są w tym katalogu, możemy użyć po prostu `.` i nazwy pliku (bez `.py`). Następnie importujemy nazwę modelu (`Post`).
+Kropka przed modelami `models` oznacza *bieżący katalog * lub *bieżącą aplikację*. `views.py` i `models.py` znajdują się w tym samym katalogu. Oznacza to, że możemy użyć `.` i nazwy pliku (bez `.py`). Następnie importujemy nazwę modelu (`Post`).
 
-Ale co dalej? Żeby pobrać wpisy naszego bloga z modelu `Post` potrzebujemy czegoś, co nazywa się się `QuerySet`.
+Ale co dalej? Aby pobrać aktualne posty na blogu z modelu `Post`, potrzebujemy czegoś, co nazywa się `QuerySet`.
 
 ## QuerySet
 
-Powinnaś być już zaznajomiona z zasadą działania obiektów typu QuerySet. Rozmawiałyśmy o tym w rozdziale [Django ORM (obiekty QuerySet)][1].
+Powinnaś być już zaznajomiona z zasadą działania obiektów typu QuerySet. Rozmawiałyśmy o tym w rozdziale [ORM Django (obiekty QuerySets)](../django_orm/README.md).
 
- [1]: ../django_orm/README.md
+Więc teraz chcemy opublikować posty na blogu posortowane według daty publikacji (`published_date`), prawda? Zrobiliśmy to już w rozdziale QuerySets!
 
-Więc teraz interesuje nas lista wpisów, które zostały opublikowane i posortowane według daty publikacji (`published_date`), zgadza się? Już to zrobiłyśmy w rozdziale o QuerySetach!
+{% filename %}blog/views.py{% endfilename %}
 
-    Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
 
+Teraz umieszczamy ten fragment kodu w pliku `blog/views.py` dodając go do funkcji `def post_list (request)`, ale nie zapomnij najpierw dodać `from django.utils import timezone`:
 
-Teraz umieśćmy ten kod wewnątrz pliku `blog/views.py` poprzez dodanie go do funkcji `def post_list(request)`:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
@@ -49,16 +56,16 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Zauważ, że tworzymy *zmienną* dla naszego QuerySetu: `posts`. Potraktuj ją jako nazwę naszego QuerySetu. Od tej pory będziemy odnosić się do niej tylko za pomocą tej nazwy.
-
-Ponadto w kodzie mamy funkcję `timezone.now()`, więc musimy zaimportować `timezone`.
+Ostatnią częścią, której nam brakuje, jest przekazanie QuerySetu `posts` do szablonu. Nie martw się - omówimy sposób wyświetlania go w późniejszym rozdziale.
 
-Ostatnią częścią, której nam brakuje, jest przekazanie QuerySetu `posts` do szablonu (jej wyświetlaniem w szablonie zajmiemy się w następnym rozdziale).
+Zauważ, że tworzymy *zmienną* dla naszego QuerySetu: `posts`. Potraktuj ją jako nazwę naszego QuerySetu. Od tej pory będziemy odnosić się do niej tylko za pomocą tej nazwy.
 
-W funkcji `render` mamy już parametr `request` (czyli wszystko to, co odbieramy od użytkownika przez Internet) oraz plik szablonu `'blog/post_list.html'`. Ostatni parametr, który wygląda tak: `{}` jest miejscem, w którym możemy dodać parę rzeczy do wykorzystania w szablonie. Musimy nadać im nazwy (ale póki co będziemy trzymać się nazwy `'posts'` :)). Powinno to wyglądać tak: `{'posts': posts}`. Zwróć uwagę, że ta część przed `:` jest stringiem - powinna być w środku znaków `''`.
+W funkcji `render` mamy jeden parametr `request` (wszystko, co otrzymujemy od użytkownika za pośrednictwem Internetu) i inny podający plik szablonu (`'blog/post_list.html'`). Ostatni parametr, który wygląda tak: `{}` jest miejscem, w którym możemy dodać parę rzeczy do wykorzystania w szablonie. Musimy nadać im nazwy (ale póki co będziemy trzymać się nazwy `'posts'`). :) Powinno to wyglądać tak: `{'posts': posts}`. Zwróć uwagę, że ta część przed `:` jest stringiem; powinnaś go wziąć w cudzysłów:`'`.
 
 Zatem ostatecznie nasz plik `blog/views.py` powinien wyglądać następująco:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from django.utils import timezone
@@ -71,4 +78,4 @@ def post_list(request):
 
 I to wszystko! Czas, żebyśmy wróciły do naszego szablonu i wyświetliły ten QuerySet!
 
-Jeżeli chciałabyś poczytać troszkę więcej na temat QuerySetów w Django, powinnaś rzucić okiem tutaj: https://docs.djangoproject.com/en/1.8/ref/models/querysets/
+Chcesz przeczytać trochę więcej o QuerySets w Django? Powinnaś zajrzeć tutaj: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/pl/extend_your_application/README.md b/pl/extend_your_application/README.md
index 0a81c2edbf2..ec3715905b1 100755
--- a/pl/extend_your_application/README.md
+++ b/pl/extend_your_application/README.md
@@ -10,7 +10,7 @@ Mamy już model `Post`, więc nie musimy już dodawać niczego do `models.py`.
 
 ## Tworzenie linku w szablonie
 
-Zaczniemy od dodania linku wewnątrz pliku `blog/templates/blog/post_list.html`. Do tej pory plik powinien wyglądać tak:
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -30,23 +30,31 @@ Zaczniemy od dodania linku wewnątrz pliku `blog/templates/blog/post_list.html`.
 
 {% raw %}Chcemy, aby tytuł wpisu był linkiem prowadzącym do strony ze szczegółami wpisu. Zmieńmy `<h1><a href="">{{ post.title }}</a></h1>` na link:{% endraw %}
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
 ```
 
-Teraz, gdy wejdziemy na adres http://127.0.0.1:8000/ ujrzymy błąd (co było do przewidzenia, bo nie mamy jeszcze ustawionego adresu URL ani *widoku* dla `post_detail`). Będzie to wyglądać tak:
+{% raw %}Czas by wyjaśnić co oznacza tajemnicze `{% url 'post_detail' pk=post.pk %}`. Jak można podejrzewać, zapis `{% %}` oznacza, że używamy tagów szablonu Django. Tym razem używamy takiego, który generuje za nas adres strony.{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
 
-![Błąd NoReverseMatch][1]
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
 
- [1]: images/no_reverse_match2.png
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
 
-## Utwórzmy URL dla pojedynczego wpisu
+![Błąd NoReverseMatch](images/no_reverse_match2.png)
+
+## Utwórzmy URL dla poszczególnego wpisu
 
 Dodajmy adres URL w pliku `urls.py` dla naszego *widoku* `post_detail`!
 
 Chcemy, aby nasz wpis i wszystkie informacje o nim, były widoczne pod tym adresem **URL**: http://127.0.0.1:8000/post/1/
 
-W pliku `blog/urls.py` stwórzmy adres URL wskazujący na *widok* o nazwie `post_detail`, który wyświetli nam cały wpis. Dodaj wiersz `url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),` w pliku `blog/urls.py`. Jego zawartość powinna wyglądać tak:
+W pliku `blog/urls.py` stwórzmy adres URL wskazujący na *widok* o nazwie `post_detail`, który wyświetli nam cały wpis. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. Jego zawartość powinna wyglądać tak:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
@@ -54,62 +62,63 @@ from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
 ]
 ```
 
-Ten fragment `^post/(?P<pk>[0-9]+)/$` wygląda trochę przerażająco, ale spokojnie - wyjaśnijmy wszystko krok po kroku: - znów zaczyna się od `^` -- "początek" - `post/` oznacza tylko, że zaraz po początku adres URL powinien zawierać słowo **post** i **/**. Na razie nie jest źle. - `(?P<pk>[0-9]+)` - ta część jest trudniejsza. Oznacza ona, że Django pobierze wszystko, co umieścisz w tym miejscu i przekaże to do widoku w zmiennej o nazwie `pk`. `[0-9]` dodatkowo mówi nam, że może to być tylko cyfra, nie litera (czyli wszystko pomiędzy 0 a 9). `+` oznacza, że to musi być jedna lub więcej cyfr. Czyli coś takiego: `http://127.0.0.1:8000/post//` nie jest poprawne, ale już `http://127.0.0.1:8000/post/1234567890/` jest jak najbardziej w porządku! - `/` - znów potrzebujemy **/** - `$` - "koniec"!
-
-To oznacza, że gdy wpiszesz w przeglądarce adres `http://127.0.0.1:8000/post/5/`, Django zrozumie, że potrzebujesz *widoku* zwanego `post_detail` i przekaże temu *widokowi* informację, że `pk` jest równe `5`.
-
-`pk` to skrót od `primary key` (ang. klucz główny). Nazwa ta jest często używana w projektach Django. Ale możesz nazwać tę zmienną jak Ci się żywnie podoba (tylko pamiętaj: same małe litery i znak `_` zamiast spacji!). Dla przykładu, zamiast `(?P<pk>[0-9]+)` możemy mieć zmienną `post_id`. Wówczas ten fragment wyglądałby tak: `(?P<post_id>[0-9]+)`.
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
 
-{% raw %}Czas by wyjaśnić co oznaczało tajemnicze `{% url 'post_detail' pk=post.pk %}`. Jak można podejrzewać, zapis `{% %}` oznacza, że używamy tagów szablonu Django. `url` to taki tag, który generuje za nas adres strony.
-`'post_detail'` to ten sam napis, którego użyliśmy w `urls.py` jako `name`:
-      url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'), 
-Dzięki temu Django wie, z którego wzorca zbudować adres URL. Wie zatem, że chodzi nam o coś co zaczyna się od `"post/"` potem ma liczbę `pk` a na końcu `"/"`. Jedyne czego nie wie, to jaką wartość ma mieć `pk`? Właśnie po to podajemy `pk=post.pk`, co oznacza, że `pk` ma być równe kluczowi głównemu naszego posta.
-{% endraw %}
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. Oznacza ona, że Django pobierze wszystko, co umieścisz w tym miejscu i przekaże to do widoku w zmiennej o nazwie `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` oznacza, że to musi być jedna lub więcej cyfr. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
 
-OK, dodałyśmy nowy wzorzec URL do `blog/urls.py`! Odświeżmy stronę: http://127.0.0.1:8000/ Bum! Znowu błąd! Tak jak myślałyśmy!
+To oznacza, że gdy wpiszesz w przeglądarce adres `http://127.0.0.1:8000/post/5/`, Django zrozumie, że potrzebujesz *widoku* zwanego `post_detail` i przekaże temu *widokowi* informację, że `pk` jest równe `5`.
 
-![AttributeError][2]
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
 
- [2]: images/attribute_error2.png
+![AttributeError](images/attribute_error2.png)
 
 Pamiętasz, jaki jest następny krok? Oczywiście: dodanie widoku!
 
 ## Dodajmy widok dla poszczególnego wpisu
 
-Tym razem nasz *widok* otrzymuje dodatkowy parametr `pk`. Nasz *widok* musi go "złapać", zgadza się? A więc zdefiniujmy funkcję tak: `def post_detail(request, pk):`. Zwróć uwagę, że musimy użyć dokładnie tej samej nazwy jak ta, której użyłyśmy w pliku urls (`pk`). Pominięcie tej zmiennej jest niepoprawne i spowoduje błąd!
+This time our *view* is given an extra parameter, `pk`. Nasz *widok* musi go "złapać", zgadza się? A więc zdefiniujmy funkcję tak: `def post_detail(request, pk):`. Zwróć uwagę, że musimy użyć dokładnie tej samej nazwy jak ta, której użyłyśmy w pliku urls (`pk`). Pominięcie tej zmiennej jest niepoprawne i spowoduje błąd!
 
-Teraz chcemy wyświetlić jeden i tylko jeden wpis na blogu. Aby to zrobić, możemy użyć querysetów w następujący sposób:
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
 
-    Post.objects.get(pk=pk)
+{% filename %}blog/views.py{% endfilename %}
 
+```python
+Post.objects.get(pk=pk)
+```
 
-Ale jest jeden problem. Jeśli nie istnieje żaden wpis (`Post`) zawierający przekazany `klucz główny` (`pk`) , to ujrzymy przepaskudny błąd!
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
 
-![Błąd DoesNotExist][3]
+![Błąd DoesNotExist](images/does_not_exist2.png)
 
- [3]: images/does_not_exist2.png
+Tak nie może być! Ale oczywiście Django ma dla nas coś, co rozwiąże ten problem za nas: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
 
-Tak nie może być! Ale oczywiście Django ma dla nas coś, co rozwiąże ten problem za nas: `get_object_or_404`. W sytuacji, gdy nie istnieje żaden wpis (`Post`) z przekazaną wartością `pk`, wyświetli znacznie przyjemniejszą stronę (zwaną `Page Not Found 404` albo stroną błędu 404 - informującą, że dana strona nie została znaleziona).
+![Nie znaleziono strony](images/404_2.png)
 
-![Nie znaleziono strony][4]
+Dobra wiadomość - możesz stworzyć własną stronę błędu 404 i upiększyć ją tak, jak tylko Ci się podoba. Ale teraz nie jest to super ważne, więc na razie pominiemy ten temat.
 
- [4]: images/404_2.png
+OK, time to add a *view* to our `views.py` file!
 
-Dobra wiadomość - możesz stworzyć własną stronę błędu 404 i upiększyć ją tak, jak tylko Ci się podoba. Ale teraz nie jest to super ważne, więc na razie pominiemy ten temat.
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
 
-OK, czas dodać nasz *widok* do naszego pliku `views.py`!
+We should open `blog/views.py` and add the following code near the other `from` lines:
 
-Musimy otworzyć plik `blog/views.py` i dodać następujący kod (w zasadzie zmodyfikować pierwszą linię):
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render, get_object_or_404
 ```
 
-Natomiast na końcu pliku dodajemy nasz *widok*:
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_detail(request, pk):
@@ -119,24 +128,22 @@ def post_detail(request, pk):
 
 Czas na odświeżenie strony: http://127.0.0.1:8000/
 
-![Widok listy wpisów][5]
-
- [5]: images/post_list2.png
+![Widok listy wpisów](images/post_list2.png)
 
 Działa! Ale co się stanie, gdy klikniesz na link w tytule wpisu?
 
-![Błąd TemplateDoesNotExist][6]
-
- [6]: images/template_does_not_exist2.png
+![Błąd TemplateDoesNotExist](images/template_does_not_exist2.png)
 
 O nie! Kolejny błąd! Ale wiemy już, jak sobie z nim poradzić, prawda? Musimy dodać szablon!
 
-## Stwórzmy szablon dla pojedynczego wpisu
+## Create a template for the post details
 
 W folderze `blog/templates/blog` stwórzmy plik o nazwie `post_detail.html`.
 
 Efekt będzie wyglądał tak:
 
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -155,13 +162,11 @@ Efekt będzie wyglądał tak:
 
 Znów rozszerzamy `base.html`. W bloku `content` chcemy wyświetlić datę opublikowania wpisu (o ile istnieje), tytuł oraz treść. Ale jest kilka ważnych rzeczy do omówienia, nieprawdaż?
 
-{% raw %}`{% if ... %} ... {% endif %}` jest znacznikiem szablonu, którego możemy użyć do sprawdzenia jakiegoś warunku (pamiętasz `if... else ..` z rozdziału **Wprowadzenie do Pythona**?). W naszym scenariuszu chcemy sprawdzić, czy data publikacji wpisu (`published_date`) nie jest pusta.{% endraw %}
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
 
-OK, możemy teraz odświeżyć naszą stronę i sprawdzić, czy strona `Page not found` już znikła.
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
 
-![Strona ze szczegółami wpisu][7]
-
- [7]: images/post_detail2.png
+![Strona ze szczegółami wpisu](images/post_detail2.png)
 
 Hura! Działa!
 
@@ -169,30 +174,24 @@ Hura! Działa!
 
 Dobrze byłoby sprawdzić czy nasza strona dalej będzie dobrze działać na PythonAnywhere, prawda? Spróbuj ponownie wdrożyć projekt.
 
+{% filename %}command-line{% endfilename %}
+
     $ git status
-    [...]
     $ git add --all .
     $ git status
-    [...]
-    $ git commit -m "Dodano style, oraz widok i szablon dla pojedynczego wpisu na stronie."
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
     $ git push
-    [...]
-
+    
 
-*   Potem, w konsoli [PythonAnywhere Bash][8]:
+Potem, w konsoli [PythonAnywhere Bash](https://www.pythonanywhere.com/consoles/):
 
- [8]: https://www.pythonanywhere.com/consoles/
+{% filename %}command-line{% endfilename %}
 
     $ cd my-first-blog
-    $ source myvenv/bin/activate
-    (myvenv)$ git pull
+    $ git pull
     [...]
-    (myvenv)$ python manage.py collectstatic
-    [...]
-
-
-*   Na koniec, przejdźmy do podstrony [Web tab][9] i wciśnijmy **Reload** (ang. odśwież).
+    
 
- [9]: https://www.pythonanywhere.com/web_app_setup/
+Na koniec, przejdźmy do podstrony [Web tab](https://www.pythonanywhere.com/web_app_setup/) i wciśnijmy **Reload** (ang. odśwież.
 
-I to już wszystko! Gratulacje :)
+I to już wszystko! Gratulacje :)
\ No newline at end of file
diff --git a/pl/how_the_internet_works/README.md b/pl/how_the_internet_works/README.md
index 3a2f762b4a3..3961f5a5621 100755
--- a/pl/how_the_internet_works/README.md
+++ b/pl/how_the_internet_works/README.md
@@ -1,53 +1,47 @@
-# Jak działa Internet
+# Jak działa internet
 
-> Niniejszy rozdział został zainspirowany prelekcją "Jak działa Internet" Jessiki McKellar (http://web.mit.edu/jesstess/www/).
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
 
-Możemy się założyć, że używasz go każdego dnia. Ale czy naprawdę wiesz co się dzieje, gdy wpisujesz w przeglądarce adres https://djangogirls.org i wciskasz `Enter`?
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
 
-Aby zrozumieć jak działa Internet powinnaś najpierw dowiedzieć się czym tak naprawdę jest strona internetowa, a jest ona tylko zbiorem plików zapisanych na dysku twardym. Tak samo jak twoje zdjęcia, muzyka czy filmy. Aczkolwiek strony internetowe różnią się od nich tym, że zawierają kod komputerowy zwany HTML.
+Aby zrozumieć jak działa internet powinnaś najpierw dowiedzieć się czym tak naprawdę jest strona internetowa, a jest ona tylko zbiorem plików zapisanych na dysku twardym. Tak samo jak twoje zdjęcia, muzyka czy filmy. Aczkolwiek strony internetowe różnią się od nich tym, że zawierają kod komputerowy zwany HTML.
 
 Jeśli nie miałaś wcześniej do czynienia z programowaniem, może być Ci na początku trudno zrozumieć HTML, ale przeglądarki internetowe (takie jak Chrome, Safari, Firefox itd.) uwielbiają go. Zostały one zaprojektowane po to, by czytać ten kod, przetwarzać go i postępować zgodnie z jego instrukcjami. Prezentują pliki, z których składa się Twoja strona - by wyglądała dokładnie tak jak Ty chcesz.
 
-Tak jak w przypadku każdego innego pliku, musimy umiejscowić pliki HTML na dysku twardym. Do przechowywania plików HTML używamy specjalnych, potężnych komputerów zwanych *serwerami (ang. servers)*. Serwery nie posiadają monitorów, myszy ani klawiatur, ponieważ ich głownym celem jest przechowywanie danych i serwowanie ich. Dlatego są one nazywane *serwerami* -- ponieważ służą do *serwowania* danych.
+Tak jak w przypadku każdego innego pliku, musimy umiejscowić pliki HTML na dysku twardym. Do przechowywania plików HTML używamy specjalnych, potężnych komputerów zwanych *serwerami (ang. servers)*. Serwery nie posiadają monitorów, myszy ani klawiatur, ponieważ ich głownym celem jest przechowywanie danych i serwowanie ich. That's why they're called *servers* – because they *serve* you data.
 
-Ok, ale pewnie chciałabyś wiedzieć jak wygląda Internet?
+OK, but you want to know how the Internet looks, right?
 
 Narysowaliśmy Ci schemat Internetu! Wygląda tak:
 
-![Rysunek 1.1][1]
+![Rysunek 1.1](images/internet_1.png)
 
- [1]: images/internet_1.png
+Wygląda dość chaotycznie, prawda? In fact it is a network of connected machines (the above-mentioned *servers*). Setki tysięcy maszyn! Wiele, wiele kilometrów kabli na całym świecie! Możesz wejść na stronę Submarine Cable Map (http://submarinecablemap.com) i sama zobaczyć jak skomplikowana jest ta sieć. Oto zrzut ekranu ze strony internetowej:
 
-Wygląda dość chaotycznie, prawda? W rzeczywistości jest to sieć połączonych między sobą maszyn (wspomnianych wyżej *serverów*). Setki tysięcy maszyn! Wiele, wiele kilometrów kabli na całym świecie! Możesz wejść na stronę Submarine Cable Map (http://submarinecablemap.com) i sama zobaczyć jak skomplikowana jest ta sieć. Oto zrzut ekranu ze strony internetowej:
+![Rysunek 1.2](images/internet_3.png)
 
-![Rysunek 1.2][2]
-
- [2]: images/internet_3.png
-
-To fascynujące, prawda? Ale oczywiście niemożliwe jest stworzenie bezpośredniego połączenia kablowego między każdym komputerem w Internecie. Więc aby dostać się do maszyny dostępnej w Internecie (na przykład tej, na której zapisane jest https://djangogirls.org) potrzebujemy wykonać zapytanie przechodzące przez wiele, wiele różnych maszyn.
+To fascynujące, prawda? Ale oczywiście niemożliwe jest stworzenie bezpośredniego połączenia kablowego między każdym komputerem w internecie. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
 
 Wygląda to tak:
 
-![Rysunek 1.3][3]
+![Rysunek 1.3](images/internet_2.png)
 
- [3]: images/internet_2.png
-
-Wyobraź sobie, że po wpisaniu https://djangogirls.org, wysyłasz list o treści: "Drogie Django Girls, chcę zobaczyć stronę djangogirls.org. Wyślijcie ją do mnie, proszę! "
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
 
 List trafia do urzędu pocztowego najbliżej Ciebie. Potem idzie do drugiego urzędu, który znajduje się trochę bliżej Twojego adresata. Potem do kolejnego, kolejnego, kolejnego, aż w końcu zostanie doręczony do miejsca przeznaczenia. Ciekawa rzecz - jeśli wyślesz wiele listów (*pakietów danych*) do tego samego adresata, mogą przejść przez zupełnie inne urzędy pocztowe (*routery*). To zależy od tego w jaki sposób zostaną rozdzielone w każdym urzędzie.
 
-![Rysunek 1.4][4]
-
- [4]: images/internet_4.png
+![Rysunek 1.4](images/internet_4.png)
 
-Tak, to takie proste. Wysyłasz wiadomości i oczekujesz jakiejś odpowiedzi. Oczywście, zamiast papieru i długopisu używasz bitów danych, ale koncepcja jest dokładnie taka sama!
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
 
-Zamiast adresów z nazwą ulicy, miastem, kodem pocztowym oraz nazwą kraju, używa się adresów IP. Twój komputer najpierw pyta serwera DNS (system nazw domenowych, ang. DNS - Domain Name System) o przetłumaczenie djangogirls.org na adres IP. Działa to podobnie do dawnych książek telefonicznych, w których mogłaś poszukać adresu czy numeru po nazwisku osoby, z którą chciałaś się skontaktować.
+Zamiast adresów z nazwą ulicy, miastem, kodem pocztowym oraz nazwą kraju, używa się adresów IP. Twój komputer najpierw pyta serwera DNS (system nazw domenowych, ang. DNS - Domain Name System) o przetłumaczenie djangogirls.org na adres IP. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
 
-Listy muszą spełniać konkretne warunki, żeby zostały poprawnie doręczone: muszą posiadać adres, znaczek itd. Muszą być też napisane językiem zrozumiałym dla odbiorcy. To samo dotyczy *pakietów danych*, które wysyłasz, by zobaczyć jakąś stronę. Używany jest protokół HTTP (Hypertext Transfer Protocol).
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Muszą być też napisane językiem zrozumiałym dla odbiorcy. To samo dotyczy *pakietów danych*, które wysyłasz, by zobaczyć jakąś stronę. Używany jest protokół HTTP (Hypertext Transfer Protocol).
 
 Tak więc, ogólnie rzecz ujmując, jeśli chcesz mieć swoją stronę internetową musisz mieć *serwer* (komputer), gdzie będzie ona funkcjonować. Gdy *serwer* odbiera przychodzące *żądania* (Twój list), wysyła Ci w odpowiedzi Twoją stronę (kolejny list).
 
-Zapytasz pewnie co robi Django, skoro masz przed sobą tutorial Django. Kiedy odpowiadasz na żądanie, nie chcesz aby każdy dostawał tę samą odpowiedź, prawda? Zdecydowanie lepiej jest jeśli listy są spersonalizowane i skierowane do konkretnej osoby, do tej, która napisała do Ciebie. Django pomaga Ci w tworzeniu tych spersonalizowanych, interesujących listów :).
+Since this is a Django tutorial, you might ask what Django does. Kiedy odpowiadasz na żądanie, nie chcesz aby każdy dostawał tę samą odpowiedź, prawda? Zdecydowanie lepiej jest jeśli listy są spersonalizowane i skierowane do konkretnej osoby, do tej, która napisała do Ciebie. Django pomaga Ci w tworzeniu tych spersonalizowanych, interesujących listów. :)
 
-Wystarczy teorii, zabieramy się za tworzenie!
\ No newline at end of file
+Enough talk – time to create!
\ No newline at end of file
diff --git a/pl/html/README.md b/pl/html/README.md
index 89b1db44841..e8b0c88ce20 100755
--- a/pl/html/README.md
+++ b/pl/html/README.md
@@ -2,13 +2,13 @@
 
 Zastanawiasz się czym jest szablon?
 
-Szablon to plik, którego używamy do prezentacji informacji w zwięzłej formie. Używając analogii - do pisania listów również możesz użyć szablonu. Każdy list ma inną treść i adres, ale każdy z nich ma taką samą strukturę.
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
 
-Format szablonów Django wykorzystuje język HTML (ten sam, o którym wspominaliśmy w rozdziale **Jak działa Internet**).
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
 
 ## Co to jest HTML?
 
-HTML to prosty kod interpretowany przez Twoją przeglarkę - taką jak Chrome, Firefox czy Safari - w celu wyświetlenia strony dla użytkownika.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
 HTML to skrót od "HyperText Markup Language". **HyperText** oznacza, że jest to tekst, który wspiera hyperlinki - czyli po prostu linki między stronami. **Markup** oznacza, że używamy tego kodu w dokumencie, żeby przekazać komuś informacje (w naszym przypadku przeglądarce), jak zinterpretować daną stronę. Kod HTML składa się ze **znaczników ** (tagów), a każdy z nich zaczyna się od `<` i kończy na`>`. Za pomocą znaczników oznaczamy **elementy**.
 
@@ -21,71 +21,69 @@ Szablony są zapisywane w katalogu `blog/templates/blog`. Zacznij więc od stwor
     blog
     └───templates
         └───blog
+    
 
-
-(być może zastanawiasz się, dlaczego tworzymy dwa katalogi o nazwie `blog` - jak się niebawem dowiesz, to po prostu użyteczna konwencja nazewnictwa. Ułatwia życie, gdy sprawy stają się bardziej skomplikowane.)
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
 
 A teraz stwórz plik `post_list.html` (na razie niech będzie pusty) wewnątrz katalogu `blog/templates/blog`.
 
 Popatrz, jak Twoja strona wygląda teraz: http://127.0.0.1:8000/
 
-> Jeżeli nadal otrzymujesz błąd `TemplateDoesNotExists`, spróbuj uruchomić serwer ponownie. Przejdź do wiersza poleceń, zatrzymaj serwer wciskając Ctrl+C (klawisze Control i C równocześnie), a następnie uruchom go jeszcze raz poleceniem `python manage.py runserver`.
-
-![Rysunek 11.1][1]
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
 
- [1]: images/step1.png
+![Rysunek 11.1](images/step1.png)
 
 Nie ma błędu! Gratulacje :) Niestety, twoja aplikacja nie wyświetla niczego poza pustą stroną, ponieważ Twój szablon również jest pusty. Naprawmy to.
 
 Dodaj następującą treść w pliku z szablonem:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
-    <p>Hej!</p>
-    <p>Działa!</p>
+    <p>Hi there!</p>
+    <p>It works!</p>
 </html>
 ```
 
-I jak twoja strona wygląda teraz? Kliknij, żeby się dowiedzieć: http://127.0.0.1:8000/
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
 
-![Rysunek 11.2][2]
-
- [2]: images/step3.png
+![Rysunek 11.2](images/step3.png)
 
 Zadziałało! Dobra robota :)
 
-*   Najbardziej podstawowy znacznik, `<html>`, jest zawsze na początku każdej strony internetowej, zaś `</html>` jest zawsze na końcu. Jak widzisz, cała zawartość strony zawiera się pomiędzy znacznikiem otwierającym `<html>` i zamykającym `</html>`
-*   `<p>` jest znacznikiem akapitów; `</p>` zamyka każdy akapit
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. Jak widzisz, cała zawartość strony zawiera się pomiędzy znacznikiem otwierającym `<html>` i zamykającym `</html>`
+* `<p>` jest znacznikiem akapitów; `</p>` zamyka każdy akapit
 
-## Head i body
+## Head and body
 
 Każda strona HTML jest podzielona na dwie części: **head** i **body**.
 
-*   **head** jest elementem zawierającym informacje o dokumencie, które nie są wyświetlane na ekranie.
+* **head** jest elementem zawierającym informacje o dokumencie, które nie są wyświetlane na ekranie.
 
-*   **body** zawiera wszystkie pozostałe elementy, które są częścią strony internetowej widoczną na ekranie.
+* **body** zawiera wszystkie pozostałe elementy, które są częścią strony internetowej widoczną na ekranie.
 
 Używamy znacznika `<head>`, aby poinformować przeglądarkę o konfiguracji strony oraz `<body>` do przekazania informacji o tym, co właściwie znajduje się na stronie.
 
-Przykładowo, element tytułu strony możesz umieścić wewnątrz `<head>`, o tak:
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
     <head>
-        <title>Blog Oli</title>
+        <title>Ola's blog</title>
     </head>
     <body>
-        <p>Hej!</p>
-        <p>Działa!</p>
+        <p>Hi there!</p>
+        <p>It works!</p>
     </body>
 </html>
 ```
 
 Zapisz plik i odśwież swoją stronę.
 
-![Rysunek 11.3][3]
-
- [3]: images/step4.png
+![Rysunek 11.3](images/step4.png)
 
 Zauważyłaś, że przeglądarka zrozumiała, że "Ola's blog" jest tytułem Twojej strony? Zinterpretowała ona `<title>Ola's blog</title>` i umieściła tekst w pasku tytułu twojej przeglądarki (będzie on również używany m.in. w zakładkach).
 
@@ -93,23 +91,26 @@ Zapewne zauważyłaś także, że każdy znacznik otwierający posiada *znacznik
 
 To trochę jak wkładanie rzeczy do pudełek. Masz jedno wielkie pudło, `<html></html>`; wewnątrz niego znajduje się `<body></body>`, a w środku tegoż są kolejne mniejsze pudełka: `<p></p>`.
 
-Musisz przestrzegać zasad *zamykania* znaczników i *zagnieżdżania* elementów - przeciwnym razie przeglądarka może mieć problem z ich poprawnym zinterpretowaniem i Twoja strona będzie wyświetlać się niepoprawnie.
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
 
 ## Dostosowywanie szablonu
 
 Teraz nieco się pobawmy i spróbujmy dostosować nasz szablon! Oto kilka znaczników, które nam się do tego przydadzą:
 
-*   `<h1>Nagłówek</h1>` - dla najważniejszego nagłówka na Twojej stronie
-*   `<h2>Podtytuł</h2>` dla nagłówka niższego poziomu
-*   `<h3>Pod-podtytuł</h3>` ... i tak dalej, aż do `<h6>`
-*   `<em>tekst</em>` dodaje wyróżnienie twojego tekstu
-*   `<strong>text</strong>` jeszcze mocniej wyróżnia twój tekst
-*   `<br />` to przejście do nowej linii (wewnątrz br nie wstawiamy niczego)
-*   `<a href="https://djangogirls.org">link</a>` tworzy link
-*   `<ul><li>pierwsza pozycja</li><li>druga pozycja</li></ul>` tworzy listę, taką samą jak ta!
-*   `<div></div>` tworzy sekcję na stronie
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>Podtytuł</h2>` dla nagłówka niższego poziomu
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>tekst</em>` dodaje wyróżnienie twojego tekstu
+* `<strong>text</strong>` jeszcze mocniej wyróżnia twój tekst
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` tworzy link
+* `<ul><li>pierwsza pozycja</li><li>druga pozycja</li></ul>` tworzy listę, taką samą jak ta!
+* `<div></div>` tworzy sekcję na stronie
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
 
-Poniżej przykład pełnego szablonu:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -118,7 +119,7 @@ Poniżej przykład pełnego szablonu:
     </head>
     <body>
         <div>
-            <h1><a href="">Django Girls Blog</a></h1>
+            <h1><a href="/">Django Girls Blog</a></h1>
         </div>
 
         <div>
@@ -138,18 +139,16 @@ Poniżej przykład pełnego szablonu:
 
 Stworzyliśmy tutaj trzy sekcje `div`.
 
-*   Pierwszy `div` zawiera w sobie tytuł naszego bloga - jest to nagłówek i link.
-*   Kolejne dwa elementy `div` zawierają nasze wpisy wraz z opublikowaną datą, `h2` z klikalnym tytułem wpisu oraz dwa elementy `p` (akapity) z tekstem, jeden z datą i drugi z treścią naszego wpisu.
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Kolejne dwa elementy `div` zawierają nasze wpisy wraz z opublikowaną datą, `h2` z klikalnym tytułem wpisu oraz dwa elementy `p` (akapity) z tekstem, jeden z datą i drugi z treścią naszego wpisu.
 
 Daje nam to taki efekt:
 
-![Rysunek 11.4][4]
-
- [4]: images/step6.png
+![Rysunek 11.4](images/step6.png)
 
-Hura! Ale jak do tej pory, nasz szablon wyświetla dokładnie **tę samą treść**. Tymczasem wspominałyśmy wcześniej, że szablony umożliwiają nam wyświetlenie **różnych** treści w **takim samym formacie**.
+Hura! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
 
-Chcemy wyświetlić prawdziwe wpisy dodane w naszym panelu admina Django - i tym się teraz zajmiemy.
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
 
 ## Jeszcze jedna rzecz: wdrożenie na serwer!
 
@@ -159,51 +158,56 @@ Byłoby fajnie, gdybyśmy mogli to wszystko zobaczyć "na żywo" w Internecie, a
 
 Po pierwsze, zobaczmy, jakie pliki zostały zmienione od ostatniej aktualizacji (wpisz następujące polecenie lokalnie w wierszu poleceń, nie na PythonAnywhere):
 
-    $ git status
+{% filename %}command-line{% endfilename %}
 
+    $ git status
+    
 
 Upewnij się, że jesteś w folderze `djangogirls` i powiedz `git`owi aby dodał wszystkie zmiany z aktualnego folderu:
 
-    $ git add --all .
+{% filename %}command-line{% endfilename %}
 
+    $ git add --all .
+    
 
-> **Uwaga:** `--all` (czyli angielskie "wszystko") oznacza, że `git` weźmie pod uwagę pliki, które usunęłaś (domyślnie rozpoznaje zmiany tylko w nowych lub już istniejących plikach). Pamiętaj również (vide rozdział 3), że `.` oznacza aktualny katalog.
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Pamiętaj również (vide rozdział 3), że `.` oznacza aktualny katalog.
 
 Zanim prześlemy wszystkie pliki, sprawdźmy, co faktycznie `git` zamierza przesłać (wszystkie pliki, które `git` prześle do repozytorium, powinny być zaznaczone na zielono):
 
-    $ git status
+{% filename %}command-line{% endfilename %}
 
+    $ git status
+    
 
 Już blisko do końca. Teraz czas poprosić gita, aby zapisał te zmiany w historii. Dodamy za moment informację o zmianach (ang. "commit message"), gdzie opiszemy, co zostało zmienione. Możesz w tym miejscu wpisać cokolwiek zechcesz, ale warto jednak wpisać kilka słów opisujących, co robiłaś. W ten sposób łatwiej Ci będzie w przyszłości przypomnieć sobie, czego dotyczyły zapisane zmiany.
 
-    $ git commit -m "Zmieniony kod HTML na stronie."
+{% filename %}command-line{% endfilename %}
 
+    $ git commit -m "Zmieniony kod HTML na stronie."
+    
 
 > **Uwaga:** Nie zapomnij umieścić informacji o zmianach w cudzysłowie (" ").
 
-Jak już wszystko to zrobimy, możemy wysłać (push) nasze zmiany na Githuba:
+Once we've done that, we upload (push) our changes up to GitHub:
 
-    git push
+{% filename %}command-line{% endfilename %}
 
+    $ git push
+    
 
 ### Prześlij nową wersję kodu do PythonAnywhere i ponownie załaduj swoją stronę
 
-*   Otwórz [stronę konsol na PythonAnywhere][5] i przejdź do swojej **Bash console** (czyli po polsku "konsoli Bash") albo otwórz nową. Wpisz do niej:
+* Otwórz [stronę konsol na PythonAnywhere](https://www.pythonanywhere.com/consoles/) i przejdź do swojej **Bash console** (czyli po polsku "konsoli Bash") albo otwórz nową. Wpisz do niej:
 
- [5]: https://www.pythonanywhere.com/consoles/
+{% filename %}command-line{% endfilename %}
 
     $ cd ~/my-first-blog
-    $ source myvenv/bin/activate
-    (myvenv)$ git pull
-    [...]
-    (myvenv)$ python manage.py collectstatic
+    $ git pull
     [...]
-
+    
 
 I obserwuj jak Twój kod się ściąga. Jeśli chcesz sprawdzić czy już się pobrał, możesz przejść do zakładki **Files tab** i przeglądnąć swój kod na PythonAnywhere.
 
-*   Na koniec przeskocz do zakładki [Web tab][6] i naciśnij **Reload**.
-
- [6]: https://www.pythonanywhere.com/web_app_setup/
+* Na koniec przeskocz do zakładki [Web tab](https://www.pythonanywhere.com/web_app_setup/) i naciśnij **Reload**.
 
-I to powinno wystarczyć! Możesz śmiało odświeżyć swoją stronę w przeglądarce! Zmiany powinny być widoczne :)
+I to powinno wystarczyć! Możesz śmiało odświeżyć swoją stronę w przeglądarce! Zmiany powinny być widoczne. :)
\ No newline at end of file
diff --git a/pl/install_git.md b/pl/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/pl/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/pl/installation/README.md b/pl/installation/README.md
index 05369c6365f..a4816a98492 100755
--- a/pl/installation/README.md
+++ b/pl/installation/README.md
@@ -1,10 +1,10 @@
 # Jeśli robisz ten kurs w domu
 
-Jeśli robisz ten kurs w domu, a nie w trakcie jednego z [warsztatów Django Girls](https://djangogirls.org/events/), możesz pominąć ten rozdział i przejść od razu do [Jak działa Internet](../how_the_internet_works/README.md)
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
 
-Informacje, które się tutaj znajdują, napotkasz również w kolejnych rozdziałach. W trakcie warsztatów Django Girls, instalujemy wszystko w trakcie jednego wieczoru, żeby następnego dnia nie musieć się o to martwić, więc zebraliśmy wszystkie potrzebne informacje w jedno miejsce.
+Informacje, które się tutaj znajdują, napotkasz również w kolejnych rozdziałach. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
 
-Jeśli chcesz, też możesz zainstalować wszystko od razu. Ale jeśli wolisz zacząć naukę już teraz bez instalowania najpierw kilku nowych rzeczy na swoim komputerze, pomiń ten rozdział. Wszystko wytłumaczymy później.
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
 
 Powodzenia!
 
@@ -12,6 +12,11 @@ Powodzenia!
 
 Podczas warsztatów będziesz budować bloga, ale abyś mogła zacząć programować, musimy najpierw zainstalować kilka rzeczy.
 
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
 # Zainstaluj Pythona
 
 {% include "/python_installation/instructions.md" %}
@@ -38,12 +43,16 @@ Wejdź na stronę [GitHub.com](https://www.github.com) i załóż darmowe konto
 
 # Zacznij czytać
 
-Gratulacje, jesteś gotowa, by zacząć pracę! Jeśli masz trochę czasu przed warsztatami, możesz przeczytać początkowe rozdziały:
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [Jak działa internet](../how_the_internet_works/README.md)
+
+* [Wprowadzenie do wiersza poleceń](../intro_to_command_line/README.md)
 
-  * [Jak działa Internet](../how_the_internet_works/README.md)
+* [Wprowadzenie do Pythona](../python_introduction/README.md)
 
-  * [Wprowadzenie do wiersza poleceń](../intro_to_command_line/README.md)
+* [Czym jest Django?](../django/README.md)
 
-  * [Wprowadzenie do Pythona](../python_introduction/README.md)
+# Enjoy the workshop!
 
-  * [Czym jest Django?](../django/README.md)
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/pl/instructions.md b/pl/instructions.md
new file mode 100644
index 00000000000..be0a284adad
--- /dev/null
+++ b/pl/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Creating a `virtualenv` on both Linux and OS X is as simple as running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/pl/intro_to_command_line/README.md b/pl/intro_to_command_line/README.md
index a2ee0eef7fc..79a0f05478a 100755
--- a/pl/intro_to_command_line/README.md
+++ b/pl/intro_to_command_line/README.md
@@ -1,72 +1,110 @@
 # Wprowadzenie do interfejsu wiersza poleceń
 
-Za chwilę napiszesz swoją pierwszą linijkę kodu. Jesteś już podekscytowana? :)
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
 
-**Pozwól, że przedstawimy Ci Twojego pierwszego przyjaciela: wiersz poleceń!**
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
 
-Następujące kroki pokażą Ci, jak korzystać z tajemniczego czarnego okna, którego używają wszyscy hakerzy. Na początku może to wyglądać nieco przerażająco, ale tak naprawdę to tylko zachęta do wpisywania komend.
+**Pozwól, że przedstawimy Ci, Twojego pierwszego przyjaciela: wiersz poleceń!**
 
-> **Uwaga** Podczas tego kursu będziemy używać terminów "katalog" i "folder" zamiennie, ponieważ oznaczają one tę samą rzecz.
+Następujące kroki pokażą Ci, jak wykorzystać tajemnicze czarne okno, które używają wszyscy hakerzy. Na początku może to wyglądać nieco przerażająco ale tak naprawdę to tylko zachęta do wpisywania komend.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
 
 ## Czym jest wiersz poleceń?
 
-Okno zwane **wierszem poleceń** lub **interfejsem wiersza poleceń** jest aplikacją tekstową służącą do przeglądania, obsługi i operowania plikami na Twoim komputerze. Podobnie jak np. Eksplorator Windows lub Finder na Macu, ale bez interfejsu graficznego. Inne nazwy dla wiersza poleceń to *cmd*, *CLI*, *prompt*, *konsola* lub *terminal*.
+Okno zwane **wierszem poleceń** lub **interfejsem wiersza poleceń** jest aplikacją tekstową służącą do przeglądania, obsługi i operowania plikami na Twoim komputerze. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Inne nazwy dla wiersza poleceń to *cmd*, *CLI*, *prompt*, *konsola* lub *terminal*.
 
 ## Uruchamiamy interfejs wiersza poleceń
 
 Aby zacząć nasze eksperymenty, musimy najpierw otworzyć nasz wiersz poleceń.
 
-### Windows
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
 
-Przejdź do menu Start → Wszystkie programy → Akcesoria → Wiersz poleceń.
+Go to Applications → Utilities → Terminal.
 
-### Mac OS X
+<!--endsec-->
 
-Aplikacje → Narzędzia → Terminal.
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
 
-### Linux
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
 
-Prawdopodobnie gdzieś w menu Aplikacje → Akcesoria → Terminal, ale to może zależeć od wersji Twojego systemu. Jeżeli tam nie znajdziesz, po prostu zapytaj Google. :)
+<!--endsec-->
 
 ## Prompt
 
 Teraz powinnaś zobaczyć białe lub czarne okno, które czeka na Twoje polecenia.
 
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
 Jeżeli używasz Maca lub Linuksa, powinnaś zobaczyć `$`, tak jak poniżej:
 
+{% filename %}command-line{% endfilename %}
+
     $
     
 
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
 W systemie Windows ujrzysz znak `>`, o tak:
 
+{% filename %}command-line{% endfilename %}
+
     >
     
 
-Każde polecenie będzie poprzedzone tym znakiem oraz jedną spacją, ale nie musisz ich przepisywać. Twój komputer zrobi to za Ciebie :)
+<!--endsec-->
 
-> Jedna mała uwaga: w Twoim przypadku prompt może być poprzedzony czymś jeszcze, np. `C:\Users\ola>` lub `Olas-MacBook-Air:~ ola$` i jest to w 100% poprawne. W tym tutorialu uprościmy sposób zapisu do minimum.
+Każde polecenie będzie poprzedzone tym znakiem oraz jedną spacją, ale nie musisz ich przepisywać. Twój komputer zrobi to za Ciebie. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
 
 ## Twoja pierwsza komenda! 
 
-Zacznijmy od czegoś łatwego. Wpisz to polecenie:
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ whoami
     
 
-lub
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > whoami
     
 
-A następnie wciśnij `Enter`. Oto rezultat:
+<!--endsec-->
+
+A następnie wciśnij `enter`. Oto rezultat:
+
+{% filename %}command-line{% endfilename %}
 
     $ whoami
     olasitarska
     
 
-Jak widzisz, komputer właśnie wyświetlił Twoją nazwę użytkownika. Prawda, że sprytne?:)
+Jak widzisz, komputer właśnie wyświetlił Twoją nazwę użytkownika. Prawda, że sprytne? :)
 
-> Staraj się zawsze przepisywać polecenia zamiast je kopiować i wklejać. W ten sposób zapamiętasz więcej!
+> Try to type each command; do not copy-paste. You'll remember more this way!
 
 ## Podstawy
 
@@ -74,21 +112,33 @@ Każdy system operacyjny ma nieco inny zestaw komend dostępnych w wierszu polec
 
 ### Bieżący katalog
 
-Miło byłoby dowiedzieć się, gdzie teraz jesteśmy, co? No to sprawdźmy. Wpisz poniższe polecenie i wciśnij `Enter`:
+Miło byłoby dowiedzieć się, gdzie teraz jesteśmy, co? No to sprawdźmy. Wpisz poniższe polecenie i wciśnij `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ pwd
     /Users/olasitarska
     
 
-Jeżeli używasz Windows:
+> Uwaga: 'pwd' pochodzi od angielskiego skrótu 'print working directory', czyli wyświetl katalog roboczy - ten, w którym się aktualnie znajdujemy.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd
     C:\Users\olasitarska
     
 
-Prawdopodobnie ujrzysz coś podobnego na swoim komputerze. Kiedy otwierasz wiersz poleceń, zwykle jest on uruchamiany w folderze głównym Twojego konta użytkownika.
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
 
-> Uwaga: 'pwd' pochodzi od angielskiego skrótu 'print working directory', czyli wyświetl katalog roboczy - ten, w którym się aktualnie znajdujemy.
+<!--endsec-->
+
+Prawdopodobnie ujrzysz coś podobnego na swoim komputerze. Kiedy otwierasz wiersz poleceń, zwykle jest on uruchamiany w folderze głównym Twojego konta użytkownika.
 
 * * *
 
@@ -96,6 +146,10 @@ Prawdopodobnie ujrzysz coś podobnego na swoim komputerze. Kiedy otwierasz wiers
 
 Co znajduje się w środku? Fajnie byłoby się tego dowiedzieć. Sprawdźmy:
 
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ ls
     Applications
     Desktop
@@ -104,7 +158,11 @@ Co znajduje się w środku? Fajnie byłoby się tego dowiedzieć. Sprawdźmy:
     ...
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > dir
      Directory of C:\Users\olasitarska
@@ -115,51 +173,83 @@ Windows:
     ...
     
 
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
 * * *
 
 ### Zmiana katalogu bieżącego
 
 Przejdźmy teraz do naszego folderu Pulpit:
 
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ cd Desktop
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd Desktop
     
 
+<!--endsec-->
+
 Sprawdźmy, czy coś się faktycznie zmieniło:
 
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ pwd
     /Users/olasitarska/Desktop
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd
     C:\Users\olasitarska\Desktop
     
 
+<!--endsec-->
+
 Tak, to tutaj!
 
-> PRO tip: gdy wpiszesz `cd D` i wciśniesz przycisk `Tab` na klawiaturze, wiersz poleceń automatycznie uzupełni resztę nazwy, dzięki czemu będziesz mogła nawigować szybciej. Jeżeli istnieje więcej niż jeden folder o nazwie zaczynającej się na "D", wciśnij `Tab` dwukrotnie, aby wyświetlić listę możliwości.
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
 
 * * *
 
 ### Tworzenie folderu
 
-Co powiesz na stworzenie folderu `cwiczenie` na swoim pulpicie? Zrób to w ten sposób:
+Co powiesz na stworzenie folderu cwiczenie na swoim pulpicie? Zrób to w ten sposób:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ mkdir cwiczenie
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > mkdir cwiczenie
     
 
-To niepozorne polecenie doda do Twojego pulpitu folder o nazwie `cwiczenie`. Możesz sprawdzić, czy na pewno został tam dodany - spójrz na swój pulpit albo uruchom polecenie `ls` lub `dir`! Spróbuj :)
+<!--endsec-->
+
+To niepozorne polecenie doda do Twojego pulpitu folder o nazwie `cwiczenie`. Możesz sprawdzić, czy na pewno został tam dodany - spójrz na swój pulpit albo uruchom polecenie `ls` lub `dir`! Spróbuj. :)
 
 > PRO tip: Jeżeli nie chcesz w kółko wpisywać tych samych poleceń, wciśnij na klawiaturze klawisz ze `strzałką w górę` i `strzałką w dół` aby przewinąć listę poprzednio użytych poleceń.
 
@@ -167,17 +257,25 @@ To niepozorne polecenie doda do Twojego pulpitu folder o nazwie `cwiczenie`. Mo
 
 ### Ćwiczenie!
 
-Małe wyzwanie dla Ciebie: wewnątrz świeżo utworzonego katalogu `cwiczenie` stwórz katalog o nazwie `test`. Użyj poleceń `cd` i `mkdir`.
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
 
 #### Rozwiązanie:
 
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ cd cwiczenie
     $ mkdir test
     $ ls
     test
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd cwiczenie
     > mkdir test
@@ -185,6 +283,8 @@ Windows:
     05/08/2014 07:28 PM <DIR>      test
     
 
+<!--endsec-->
+
 Gratulacje! :)
 
 * * *
@@ -195,85 +295,134 @@ Nie chcemy zostawić bałaganu, a zatem wyrzućmy wszystko, co do tej pory zrobi
 
 Najpierw musimy wrócić do Pulpitu:
 
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ cd ..
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd ..
     
 
-Wykonanie `cd` wraz z `..` przeniesie Cię do katalogu nadrzędnego (czyli tego, w którym znajduje się Twój aktualny katalog).
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
 
 Sprawdź, gdzie jesteś:
 
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ pwd
     /Users/olasitarska/Desktop
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd
     C:\Users\olasitarska\Desktop
     
 
+<!--endsec-->
+
 Teraz czas usunąć katalog `cwiczenie`:
 
-> **Uwaga**: Usuwanie plików za pomocą `del`, `rmdir` lub `rm` jest nieodwracalne. To znaczy, że *Twoje pliki zostaną bezpowrotnie utracone*! Tak więc bądź ostrożna z tymi poleceniami.
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ rm -r cwiczenie
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > rmdir /S cwiczenie
     cwiczenie, Are you sure <Y/N>? Y
     
 
+<!--endsec-->
+
 Gotowe! Dla pewności, że został on naprawdę usunięty, sprawdźmy to:
 
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ ls
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > dir
     
 
+<!--endsec-->
+
 ### Wyjście
 
-To na razie tyle! Możesz teraz spokojnie zamknąć wiersz poleceń. To co, zrobimy to jak prawdziwy haker?:)
+To na razie tyle! Możesz teraz spokojnie zamknąć wiersz poleceń. To co, zrobimy to jak prawdziwy haker? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ exit
     
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > exit
     
 
-Fajnie, nie? :)
+<!--endsec-->
+
+Cool, huh? :)
 
 ## Podsumowanie
 
 Oto podsumowanie przydatnych poleceń:
 
-| Polecenie (Windows) | Polecenie (Mac OS / Linux) | Opis                      | Przykład                                          |
-| ------------------- | -------------------------- | ------------------------- | ------------------------------------------------- |
-| exit                | exit                       | zamknięcie okna           | **exit**                                          |
-| cd                  | cd                         | zmiana katalogu           | **cd test**                                       |
-| dir                 | ls                         | lista katalogów/plików    | **dir**                                           |
-| copy                | cp                         | kopiowanie pliku          | **copy c:\test\test.txt c:\windows\test.txt** |
-| move                | mv                         | przenoszenie pliku        | **move c:\test\test.txt c:\windows\test.txt** |
-| mkdir               | mkdir                      | tworzenie nowego katalogu | **mkdir testdirectory**                           |
-| del                 | rm                         | usunięcie pliku           | **del c:\test\test.txt**                        |
-| rmdir /S            | rm -r                      | usunięcie katalogu        | **rm -r testdirectory**
+| Polecenie (Windows) | Polecenie (Mac OS / Linux) | Opis                       | Przykład                                          |
+| ------------------- | -------------------------- | -------------------------- | ------------------------------------------------- |
+| wyjście             | wyjście                    | zamknięcie okna            | **wyjście**                                       |
+| cd                  | cd                         | zmiana katalogu            | **cd test**                                       |
+| cd                  | pwd                        | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir                 | ls                         | lista katalogów/plików     | **dir**                                           |
+| copy                | cp                         | kopiowanie pliku           | **copy c:\test\test.txt c:\windows\test.txt** |
+| move                | mv                         | przenoszenie pliku         | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir               | mkdir                      | tworzenie nowego katalogu  | **mkdir testdirectory**                           |
+| rmdir (lub del)     | rm                         | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S            | rm -r                      | delete a directory         | **rm -r testdirectory**                           |
 
 To tylko garstka wszystkich poleceń, z których możesz skorzystać w wierszu poleceń, ale na dzień dzisiejszy nie będziesz potrzebowała niczego więcej.
 
-Jeżeli temat Cię zainteresował, to [ss64.com][1] zawiera kompletny spis poleceń dla wszystkich systemów operacyjnych.
-
- [1]: http://ss64.com
+Jeżeli temat Cię zainteresował, to [ss64.com](http://ss64.com) zawiera kompletny spis poleceń dla wszystkich systemów operacyjnych.
 
 ## Gotowa?
 
diff --git a/pl/python_installation/README.md b/pl/python_installation/README.md
index da17c58b8d4..25ec63eb821 100755
--- a/pl/python_installation/README.md
+++ b/pl/python_installation/README.md
@@ -4,10 +4,12 @@ Nareszcie tutaj!
 
 Ale najpierw porozmawiajmy o tym, czym jest Python. Python jest niezwykle popularnym językiem programowania, który może służyć do tworzenia stron internetowych, gier, oprogramowania naukowego, grafiki i wielu, wielu innych rzeczy.
 
-Początki Pythona sięgają późnych lat 80., a jego głównym założeniem jest czytelność, dzięki której kod jest łatwy do zrozumienia przez ludzi (a nie tylko przez komputery!). Z tego powodu Python jest uważany za znacznie prostszy od innych języków programowania. Dzięki temu łatwo się go nauczyć, ale niech Cię to nie zmyli - Python jest naprawdę potężnym językiem!
+Początki Pythona sięgają późnych lat 80., a jego głównym założeniem jest czytelność, dzięki której kod jest łatwy do zrozumienia przez ludzi (a nie tylko przez komputery!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
 
 # Instalowanie Pythona
 
-> **Uwaga** Jeśli zrobiłaś to już wcześniej w rozdziale 'Instalacja', nie ma potrzeby instalować Pythona po raz drugi - przejdź od razu do następnego rozdziału!
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
 
-{% include "/python_installation/instructions.md" %}
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/pl/python_installation/instructions.md b/pl/python_installation/instructions.md
index 095014260be..7309113909d 100755
--- a/pl/python_installation/instructions.md
+++ b/pl/python_installation/instructions.md
@@ -1,88 +1,106 @@
+> Dla czytelniczek w domu: ten rozdział jest również omówiony w wideo [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
 > Niniejszy podrozdział powstał w oparciu o kurs Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
 
-Django został napisany w Pythonie. Potrzebujemy Pythona, żeby móc cokolwiek zrobić w Django. Zacznijmy zatem od zainstalowania go! Potrzebujemy zainstalować Pythona 3.6.0, dlatego jeżeli masz już zainstalowaną jakąkolwiek starszą wersję, będziesz musiała ją uaktualnić.
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
 
-Pliki instalacyjne Pythona możesz pobrać z tej strony: https://www.python.org/downloads/release/python-360/. Lista plików do pobrania, dla wszystkich systemów znajduje się na samym dole strony. Poniżej są szczegółowe instrukcje instalacji, w zależności od Twojego systemu operacyjnego.
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
 
-<!--sec data-title="Windows" data-id="python_windows" data-collapse=true ces-->
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
 
-Wybierz wersję instalacyjną, odpowiednią dla Twojego systemu. Poniżej na zdjęciu zaznaczone są wersje dla systemu 64-bitowego (kolor zielony), oraz dla systemu 32-bitowego (kolor niebieski).
-Jeśli nie jesteś pewna jaki jest Twój system, to nie bój się zapytać mentora.
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
 
-![Lista plików instalacyjnych dla Windows](../python_installation/images/choose_version_win.png)
+![Nie zapomnij dodać Pythona do ścieżki systemowej (ang. Path)](../python_installation/images/python-installation-options.png)
 
-Po pobraniu odpowiedniego pliku np. **python-3.6.0-amd64.exe** dla systemu 64-bitowego *(lub python-3.6.0.exe dla 32-bitowego, numer wersji może się zmieniać)*, uruchom go (klikając dwukrotnie na niego) i postępuj według wyświetlanych instrukcji:
-* na pierwszym ekranie kliknij opcję **Customize installation**
-* na drugim ekranie "Optional features" zaznacz wszystkie opcje oprócz "for all users"
-* na trzecim ekranie "Advanced Options" zaznacz nastęujące opcje:
-  * Associate files with Python
-  * Create shortcuts for installed Applications
-  * Add Python to environment variables **WAŻNE**
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
 
-Jeśli masz wszystkie opcje zaznaczone, to możesz nacisnąć przycisk **Install**
+![Wpisz "cmd" w oknie "Uruchom""](../python_installation/images/windows-plus-r.png)
 
-![Opcje zaawansowane instalatora](../python_installation/images/advanced_options_win.png)
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
 
-**Uwaga**
-Jeśli bardzo dawno nie aktualizowałaś swojego systemu Windows 7, to możesz natrafić na błąd podczas instalacji, który będzie zawierać frazę podobną do "...C runtime libraries...".
-W tym wypadku uruchom instalator Python jako administrator: prawy przycisk myszy na pliku instalacyjnym -> "Uruchom jako administrator". Jeśli dalej nie będziesz mogła zainstalować, to musisz zaktualizować swój system.
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Dodawanie Pythona do zmiennej Path, starsze wersje](../python_installation/images/add_python_to_windows_path.png)
 
 <!--endsec-->
 
-<!--sec data-title="OS X" data-id="python_OSX"
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
 data-collapse=true ces-->
 
-Przejdź na stronę https://www.python.org/downloads/release/python-360/ i pobierz instalator Pythona:
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
 
-  * Pobierz plik o nazwie *Mac OS X 64-bit/32-bit installer*,
-  * Kliknij dwukrotnie na *python-3.6.0-macosx10.6.pkg*, by uruchomić instalator.
+Przejdź na stronę https://www.python.org/downloads/release/python-361/ i pobierz instalator Pythona:
 
-Sprawdź, czy instalacja zakończyła się pomyślnie - otwórz aplikację *Terminal* i uruchom polecenie `python3`:
-
-    $ python3 --version
-    Python 3.6.0
+* Pobierz plik o nazwie *Mac OS X 64-bit/32-bit installer*,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
 
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="python_linux"
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
 data-collapse=true ces-->
 
 Jest bardzo prawdopodobne, że masz już zainstalowanego Pythona wraz z systemem. Aby się upewnić (a także sprawdzić jego wersję) otwórz konsolę i wpisz następujące polecenie:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 --version
-    Python 3.6.0
+    Python 3.6.1
+    
 
-Jeżeli nie masz zainstalowanego Pythona lub chciałabyś zainstalować go w innej wersji, skorzystaj z jednego z poniższych sposobów:
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. Jeżeli nie masz zainstalowanego Pythona lub chciałabyś zainstalować go w innej wersji, skorzystaj z jednego z poniższych sposobów:
 
 <!--endsec-->
 
-<!--sec data-title="Debian or Ubuntu" data-id="python_debian"
-data-collapse=true ces-->
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
 
 Wpisz w konsoli poniższe polecenie:
 
+{% filename %}command-line{% endfilename %}
+
     $ sudo apt-get install python3.6
+    
 
 <!--endsec-->
 
-<!--sec data-title="Fedora (22+)" data-id="python_fedora22"
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
 data-collapse=true ces-->
 
 Użyj następującego polecenia w konsoli:
 
-    $ sudo dnf install python3.6
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
 
 <!--endsec-->
 
-<!--sec data-title="openSUSE" data-id="python_openSUSE"
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
 data-collapse=true ces-->
 
 Użyj następującego polecenia w konsoli:
 
+{% filename %}command-line{% endfilename %}
+
     $ sudo zypper install python3
+    
 
 <!--endsec-->
 
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
 * * *
 
-W razie jakichkolwiek wątpliwości albo jeśli coś poszło nie tak i nie wiesz, co dalej robić - zapytaj mentora lub osobę prowadzącą kurs! Czasami nie wszystko idzie tak, jak powinno i najlepszym wyjściem z sytuacji jest poprosić o pomoc kogoś bardziej doświadczonego.
+W razie jakichkolwiek wątpliwości albo jeśli coś poszło nie tak i nie wiesz, co dalej robić, zapytaj mentora lub osobę prowadzącą kurs! Czasami nie wszystko idzie tak, jak powinno i najlepszym wyjściem z sytuacji jest poprosić o pomoc kogoś bardziej doświadczonego.
\ No newline at end of file
diff --git a/pl/python_introduction/README.md b/pl/python_introduction/README.md
index 4d1737de8ed..b4c9be5bfbc 100755
--- a/pl/python_introduction/README.md
+++ b/pl/python_introduction/README.md
@@ -1,110 +1,129 @@
 # Wprowadzenie do Pythona
 
-> Fragment tego rozdziału jest oparty o tutoriale Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> Fragmenty tego rozdziału oparte są na tutorialu Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 
 Napiszmy jakiś kod!
 
 ## Wiersz poleceń Pythona
 
-Aby rozpocząć zabawę z Pythonem, musisz otworzyć jego *wiersz poleceń* na swoim komputerze. Już umiesz to robić - nauczyłaś się tego w rozdziale [Wprowadzenie do interfejsu wiersza poleceń][1].
+> Dla czytelniczek w domu: tą część uwzględnia wideo [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U).
 
- [1]: ../intro_to_command_line/README.md
+Aby rozpocząć zabawę z Pythonem, musisz otworzyć jego *wiersz poleceń* na swoim komputerze. Powinnaś już wiedzieć, jak to zrobić - nauczyłyśmy się tego w rozdziale [Wprowadzenie do interfejsu wiersza poleceń](../intro_to_command_line/README.md).
 
 Gdy już będziesz gotowa, postępuj według instrukcji poniżej.
 
-Chcemy otworzyć konsolę Pythona. 
+Chcemy otworzyć konsolę Pythona. Wpisz `python`, jeśli pracujesz na Windowsie, lub `python3`, jeśli pracujesz na MacOS/Linuxie. Wciśnij `enter`.
 
-Wpisz `python`, jeśli pracujesz na Windowsie, lub `python3`, jeśli pracujesz na MacOS/Linuxie. Wciśnij `Enter`.
+{% filename %}command-line{% endfilename %}
 
     $ python3
-    Python 3.6.0 (...)
+    Python 3.6.1 (...)
     Type "help", "copyright", "credits" or "license" for more information.
     >>>
+    
 
-**Zapamiętaj!**
+## Twoje pierwsze polecenie w Pythonie!
 
-Jeśli uruchomiłaś wiersz poleceń Pythona używając komendy **'python'**, to również w dalszej części tutoriala, tam gdzie będzie polecenie zawierające 'python3' - **używaj 'python'**.    
+Po uruchomieniu Pythona wiersz poleceń wygląda tak: `>>>`. Jest to sygnał dla nas, że od tego momentu możemy używać wyłącznie instrukcji języka Python. Nie musisz wpisać `>>>` - Python zrobi to dla ciebie.
 
-## Twoje pierwsze polecenie w Pythonie!
+Jeśli w którymkolwiek momencie zechcesz wyjść z konsoli Pythona, po prostu wpisz polecenie `exit()` albo użyj kombinacji klawiszy `Ctrl + Z` w Windows lub `Ctrl + D` w Macu/Linuksie. Nie będziesz już więcej widzieć promptu `>>>`.
 
-Po uruchomieniu Pythona, wiersz poleceń wygląda tak: `>>>`. Jest to sygnał dla nas, że od tego momentu możemy używać wyłącznie instrukcji języka Python. Nie musisz za każdym razem wpisywać `>>>` - Python zrobi to za Ciebie.
+Teraz jeszcze nie chcemy wyjść z konsoli Pythona. Chcemy się jeszcze kilku rzeczy nauczyć. Zacznijmy od wpisania działania matematycznego, np. `2 + 3` i naciśnięcia `entera`.
 
-Jeśli w którymkolwiek momencie zechcesz wyjść z konsoli Pythona, po prostu wpisz polecenie `exit()` i naciśnij enter. Alternatywnie, możesz użyć kombinacji klawiszy:
-- `Ctrl + C` w Windows lub, jeśli nie zadziałało, to `Ctrl + Z` a potem Enter (kombinacja zależy od wersji Pythona i Windowsa), albo
-- `Ctrl + D` w Macu/Linuksie.
+{% filename %}command-line{% endfilename %}
 
-Po udanym wyłączeniu konsoli Pythona, nie będziesz już więcej widzieć promptu `>>>` na początku nowej linii.
+```python
+>>> 2 + 3
+5
+```
 
-Teraz jednak nie chcemy wychodzić z konsoli Pythona. Chcemy za jej pomocą nauczyć się czegoś nowego. Zaczniemy od czegoś bardzo prostego. Spróbuj wpisać jakieś działanie matematyczne, np. `2 + 3`, i wciśnij `Enter`.
+Nieźle! Widzisz, jak pojawiła się odpowiedź? Python zna się na matematyce! Powinnaś spróbować innych działań, np.:
 
-    >>> 2 + 3
-    5
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
 
+By wykonać potęgowanie, powiedzmy podnieść 2 do potęgi 3, musimy wpisać: {% filename %}command-line{% endfilename %}
 
-Świetnie! Zauważyłaś, że na ekranie pojawiła się podpowiedź? Python umie liczyć! Spróbuj użyć innych poleceń takich jak: - `4 * 5` - `5 - 1` - `40 / 2`
+```python
+>>> 2 ** 3
+8
+```
 
-Pobaw się tym przez chwilę, a potem wróć tutaj :).
+Pobaw się tym przez chwilę, a potem wróć tutaj. :)
 
-Jak widzisz, całkiem niezły kalkulator z tego Pythona. A jeśli zastanawiasz się, co jeszcze można z nim zrobić...
+Ja widzisz, Python jest świetnym kalkulatorem. Jeżeli zastanawiasz się, co możesz z ni jeszcze zrobić…
 
 ## Stringi
 
-A jakby tak wpisać swoje własne imię? Wpisz swoje imię, używając cudzysłowów, w ten sposób:
+A jakby tak wpisać swoje własne imię? Wpisz swoje imię używając cudzysłowów, w ten sposób:
 
-    >>> "Ola"
-    'Ola'
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> "Ola"
+'Ola'
+```
 
 Właśnie stworzyłaś swój pierwszy string! Jest to ciąg znaków, który może być przetwarzany przez komputer. String musi zawsze zaczynać się i kończyć tym samym znakiem. Może to być apostrof (`'`) lub cudzysłów (`"`) - nie ma różnicy! Sygnalizują one Pythonowi, że wszystko, co znajduje się pomiędzy nimi, jest stringiem.
 
 Stringi mogą być łączone. Spróbuj tak:
 
-    >>> "Cześć " + "Ola"
-    'Cześć Ola'
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> "Czesc " + "Ola"
+'Czesc Ola'
+```
 
 Da się również mnożyć stringi za pomocą liczb:
 
-    >>> "Ola" * 3
-    'OlaOlaOla'
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
 
 Jeśli chciałabyś użyć apostrofu wewnątrz stringu, możesz to zrobić na dwa sposoby.
 
-Umieszczając string w cudzysłowie (dzięki temu apostrof wewnątrz stringu nie zostanie potraktowany jako znak kończący string):
-
-    >>> "Runnin' down the hill"
-    "Runnin' down the hill"
-
-
-lub poprzedzając apostrof odwróconym ukośnikiem (\'):
+Za pomocą cudzysłowu:
 
-    >>> 'Runnin\' down the hill'
-    "Runnin' down the hill"
+{% filename %}command-line{% endfilename %}
 
-Analogicznie, jeśli chciałabyś użyć cudzysłowu wewnątrz stringu, możesz to zrobić albo poprzez ograniczenie całego stringu parą apostrofów:
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
 
-    >>> 'Co dziś oglądamy? "Żywot Briana" czy "Sens życia"?'
-    'Co dziś oglądamy? "Żywot Briana" czy "Sens życia"?'
+lub poprzedzając apostrof odwróconym ukośnikiem (``):
 
-albo, pozostawić string w cudzysłowie, ale te wewnętrzne poprzedzić odwróconym ukośnikiem:
+{% filename %}command-line{% endfilename %}
 
-    >>> "Co dziś oglądamy? \"Żywot Briana\" czy \"Sens życia\"?"
-    'Co dziś oglądamy? "Żywot Briana" czy "Sens życia"?'
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
 
 Fajnie, co? Możesz także wyświetlić swoje imię wielkimi literami. Wpisz po prostu:
 
-    >>> "Ola".upper()
-    'OLA'
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> "Ola".upper()
+'OLA'
+```
 
-Właśnie użyłaś **funkcji** `upper` na swoim stringu! Funkcja (na przykład taka jak `upper()`) jest zestawem poleceń, które Python musi wykonać na danym obiekcie (`"Ola"`) gdy tylko ją wywołasz.
+Właśnie użyłaś **metody** `upper` na swoim stringu! Metoda (jak `upper()`) to sekwencja instrukcji, które Python wykonuje na podanym obiekcie (`"Ola"`) jak tylko ją wywołasz.
 
-A gdybyś chciała sprawdzić z ilu liter składa się Twoje imię to również możesz skorzystać z funkcji!
+Jeżeli chcesz poznać liczbę liter, którą zawiera twoje imię, istnieje **funkcja** również do tego!
 
-    >>> len("Ola")
-    3
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> len("Ola")
+3
+```
 
 Zastanawiasz się, dlaczego czasami wywołujemy funkcję z `.` na końcu stringu (jak tutaj: `"Ola".upper()`), a czasami najpierw wywołujemy funkcję, a dopiero potem umieszczamy string w nawiasach? Ano, w niektórych przypadkach funkcje są związane z obiektami. Tak jak `upper()`, która może być użyta wyłącznie na stringach. Taką funkcję nazywamy wówczas **metodą**. Są również funkcje, które nie są powiązane z niczym konkretnym i mogą być używane na różnych typach obiektów, jak na przykład `len()`. Dlatego przekazujemy `"Ola"` jako parametr dla funkcji `len`.
 
@@ -112,35 +131,41 @@ Zastanawiasz się, dlaczego czasami wywołujemy funkcję z `.` na końcu stringu
 
 OK, wystarczy już stringów. Jak dotąd nauczyłaś się o:
 
-*   **wierszu poleceń** - wpisywanie instrukcji (kodu) w wierszu poleceń Pythona powoduje wyświetlenie odpowiedzi przez Pythona
-*   **liczbach i stringach** - Python używa liczb w działaniach matematycznych oraz stringów dla obiektów tekstowych
-*   **operatorach** - takich jak + czy *, które tworzą nową wartość z tych już istniejących
-*   **funkcjach** - takich jak upper() czy len(), wykonywania działań na obiektach.
+- **wiersza poleceń** - wpisywanie komend (kodu) w wiersz poleceń Pythona powoduje, że Python zwraca wyniki
+- **liczby i stringi** - w Pythonie liczb używamy do działań matematycznych, a stringów do obiektów tekstowych
+- **operatory** - takie jak `+` i `*`, łączą wartości produkując nowe
+- ** funkcje** - takie jak `upper()` i `len()`, wykonują działania na obiektach.
 
 Są to podstawy każdego języka programowania, jakiego przyjdzie Ci się uczyć. Gotowa na coś trudniejszego? Mamy nadzieję, że tak!
 
 ## Błędy
 
-Spróbujmy czegoś nowego. Czy możemy sprawdzić długość liczby w taki sam sposób jak długość naszego imienia? Wpisz `len(304023)` i wciśnij `Enter`:
+Spróbujmy czegoś nowego. Czy możemy sprawdzić długość liczby w taki sam sposób jak długość naszego imienia? Wpisz `len(304023)` i wciśnij `enter`:
 
-    >>> len(304023)
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    TypeError: object of type 'int' has no len()
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
 
 Nasz pierwszy błąd! Komunikat mówi nam, że obiekty typu "int" (liczby całkowite, ang. integer) nie mają długości. Zatem co możemy zrobić? Może mogłybyśmy przekazać naszą liczbę jako string? Stringi mają ustaloną długość, zgadza się?
 
-    >>> len(str(304023))
-    6
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> len(str(304023))
+6
+```
 
-Działa! Użyłyśmy funkcji `str` wewnątrz funkcji `len`. Funkcja `str()` konwertuje wszystko do postaci stringów. Funkcja `len` dzięki temu otrzymała jako parametr tekst `'304023'` a nie liczbę).
+Działa! Użyłyśmy funkcji `str` wewnątrz funkcji `len`. Funkcja `str()` konwertuje wszystko do postaci stringów.
 
-*   Funkcja `str` przekształca wartości na **stringi**
-*   Funkcja `int` przekształca wartości na **liczby**
+- Funkcja `str` przekształca wartości na **stringi**
+- Funkcja `int` przekształca wartości na **liczby**
 
-> Ważne: każdą liczbę da się przekonwertować do postaci tekstowej, ale na odwrót - tekst na liczbę - już niekoniecznie, bo przecież jaki miałby być wynik polecenia `int('cześć')`? (Zadziała natomiast polecenie `int('42')`)
+> Ważne: możemy zamienić liczby na tekst, ale nie zawsze możemy zamienić tekst na liczby - czym w ogóle powinien być wynik działania `int('hello')`?
 
 ## Zmienne
 
@@ -148,61 +173,82 @@ Ważnym zagadnieniem w programowaniu są zmienne. Zmienna to nic innego jak nazw
 
 Przypuśćmy, że chcemy stworzyć nową zmienną zwaną `imie`:
 
-    >>> imie = "Ola"
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> imie = "Ola"
+```
 
-Widzisz? Nietrudne! Po prostu: "imie" równa się Ola.
+Napisałyśmy własnie, że imie równa się Ola.
 
-Jak już zauważyłaś, Twój program nie wyświetlił niczego tak, jak to robił wcześniej. Zatem skąd wiemy, że zmienna faktycznie istnieje? Po prostu wpisz `imie` i wciśnij `Enter`:
+Jak już zauważyłaś, Twój program nie wyświetlił niczego tak, jak to robił wcześniej. Zatem skąd wiemy, że zmienna faktycznie istnieje? Po prostu wpisz `imie` i wciśnij `enter`:
 
-    >>> imie
-    'Ola'
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> imie
+'Ola'
+```
 
-Jupi! Twoja pierwsza zmienna :)! Zawsze masz możliwość zmiany tego, do czego ta zmienna się odnosi:
+Jupi! Twoja pierwsza zmienna! :) Zawsze możesz zmienić, do czego się ona odnosi:
 
-    >>> imie = "Sonja"
-    >>> imie
-    'Sonja'
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> imie = "Sonja"
+>>> imie
+'Sonja'
+```
 
-Mozesz także używać jej w funkcjach:
+Możesz także używać jej w funkcjach:
 
-    >>> len(imie)
-    5
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> len(imie)
+5
+```
 
-Ekstra, co? Oczywiście zmienne mogą reprezentować cokolwiek, także liczby! Spróbuj tak:
+Super, co? Oczywiście zmienne mogą być czymkolwiek - liczbami również! Spróbuj:
 
-    >>> a = 4
-    >>> b = 6
-    >>> a * b
-    24
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
 
 Ale co by było, gdybyśmy użyły złej nazwy? Masz pomysł, co mogłoby się stać? Sprawdźmy!
 
-    >>> miasto = "Tokyo"
-    >>> masto
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    NameError: name 'masto' is not defined
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> miasto = "Tokyo"
+>>> masto
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'masto' is not defined
+```
 
 Błąd! Jak widzisz, Python ma różne rodzaje błędów, a ten nosi nazwę **NameError**. Python zwróci Ci taki błąd, gdy będziesz próbowała używać nazwy, która nie została jeszcze utworzona. Gdybyś w przyszłości natrafiła na niego, sprawdź w swoim kodzie czy nie popełniłaś literówek w nazwach zmiennych.
 
-Poświęć chwilę czasu na zabawę i przekonaj się, co możesz z tym zrobić!
+Poświęć chwilę czasu na zabawę i przekonaj się co możesz z tym zrobić!
 
 ## Funkcja print
 
 Spróbuj tego:
 
-    >>> imie = 'Maria'
-    >>> imie
-    'Maria'
-    >>> print(imie)
-    Maria
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> imie = 'Maria'
+>>> imie
+'Maria'
+>>> print(imie)
+Maria
+```
 
 Kiedy wpisujesz po prostu `imie`, interpreter Pythona zwraca *odwzorowanie* stringu będącego wartością zmiennej 'imie', czyli litery M-a-r-i-a zamknięte w pojedynczym cudzysłowie ''. Natomiast gdy napiszesz `print(imie)`, Python wypisze zawartość zmiennej na ekran, bez żadnego cudzysłowu, co wygląda lepiej.
 
@@ -210,72 +256,100 @@ Jak się później przekonamy, `print()` jest szczególnie użyteczny, gdy chcem
 
 ## Listy
 
-Oprócz stringów i liczb całkowitych, Python dysponuje bogactwem różnych typów obiektów. Teraz zapoznamy się z typem zwanym **listą**. Listy są dokładnie tym, co myślisz: obiektami, które są listami innych obiektów :)
+Oprócz stringów i liczb całkowitych, Python dysponuje bogactwem różnych typów obiektów. Teraz zapoznamy się z typem zwanym **listą**. Listy są dokładnie tym, co myślisz: obiektami, które są listami innych obiektów. :)
 
 Śmiało, stwórzmy listę:
 
-    >>> []
-    []
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> []
+[]
+```
 
 Tak, lista jest pusta. Niespecjalnie przydatne, co? Stwórzmy listę numerów totolotka. Nie chcemy się powtarzać za każdym razem, więc tutaj również posłużymy się zmienną:
 
-    >>> wyniki = [3, 42, 12, 19, 30, 59]
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> wyniki = [3, 42, 12, 19, 30, 59]
+```
 
 Dobrze, mamy listę! Co możemy z nią zrobić? Zobaczmy ile liczb znajduje się w tej liście. Masz pomysł, jakiej funkcji powinnaś użyć? Już z niej korzystałaś!
 
-    >>> len(wyniki)
-    6
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> len(wyniki)
+6
+```
 
 Tak! `len()` może zwrócić Ci liczbę obiektów zawartych w liście. Prawda że przydatne? To może teraz posortujmy listę:
 
-    >>> wyniki.sort()
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> wyniki.sort()
+```
 
 Polecenie to niczego nie zwraca, po prostu zmieniło kolejność liczb zawartych w liście. Wypiszmy jej zawartość jeszcze raz i zobaczmy co się stało:
 
-    >>> print(wyniki)
-    [3, 12, 19, 30, 42, 59]
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> print(wyniki)
+[3, 12, 19, 30, 42, 59]
+```
 
 Jak widzisz, liczby na liście są teraz uporządkowane według wartości od najniższej do najwyższej. Gratulacje!
 
 A gdybyśmy zapragnęły odwrócić kolejność? Zróbmy to!
 
-    >>> wyniki.reverse()
-    >>> print(wyniki)
-    [59, 42, 30, 19, 12, 3]
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> wyniki.reverse()
+>>> print(wyniki)
+[59, 42, 30, 19, 12, 3]
+```
 
-Proste, prawda? Jeśli chcesz dodać coś do swojej listy, możesz to zrobić wpisując polecenie:
+Jeżeli chcesz dodać coś do swojej listy, możesz to zrobić wpisując polecenie:
 
-    >>> wyniki.append(199)
-    >>> print(wyniki)
-    [59, 42, 30, 19, 12, 3, 199]
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> wyniki.append(199)
+>>> print(wyniki)
+[59, 42, 30, 19, 12, 3, 199]
+```
 
 Jeśli chcesz wyświetlić tylko pierwszą liczbę, możesz to uczynić używając **indeksów**. Indeks jest numerem mówiącym nam, w którym miejscu listy znajduje się dany element. Programiści zaczynają liczenie od zera, zatem pierwszy element Twojej listy znajduje się w miejscu oznaczonym indeksem 0, następny z indeksem 1, i tak dalej. Spróbuj tego:
 
-    >>> print(wyniki[0])
-    59
-    >>> print(wyniki[1])
-    42
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> print(wyniki[0])
+59
+>>> print(wyniki[1])
+42
+```
 
 Jak widzisz, możesz uzyskać dostęp do każdego z elementów Twojej listy za pomocą jej nazwy oraz numeru indeksu wewnątrz nawiasów kwadratowych.
 
-Aby skasować coś ze swojej listy, będziesz musiała użyć **indeksów**, których nauczyłyśmy się wyżej oraz polecenia `pop()`. Spróbujmy zobaczyć jak to działa na przykładzie i powtórzmy sobie to, czego się nauczyłyśmy wyżej. Usuńmy pierwszy element z naszej listy.
+By skasować coś z twojej listy, musisz użyć **indeksów**, których nauczyłyśmy się powyżej i metody `pop()`. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
 
-    >>> print(wyniki)
-    [59, 42, 30, 19, 12, 3, 199]
-    >>> print(wyniki[0])
-    59
-    >>> wyniki.pop(0)
-    >>> print(wyniki)
-    [42, 30, 19, 12, 3, 199]
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
 
 Wszystko zadziałało zgodnie z planem!
 
@@ -285,263 +359,362 @@ Wykaz wszystkich metod dostępnych dla list znajdziesz w odpowiednim rozdziale d
 
 ## Słowniki
 
-Słownik przypomina nieco listę, jednak różni się tym, że dostęp do wartości uzyskujemy za pomocą klucza, a nie indeksu. Kluczem może być dowolny ciąg znaków lub liczba. Pusty słownik tworzymy tak:
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
 
-    >>> {}
-    {}
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> {}
+{}
+```
 
 To pokazuje, że właśnie stworzyłaś pusty słownik. Hura!
 
-A teraz spróbuj wpisać poniższą instrukcję (spróbuj użyć własnych danych):
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> uczestniczka = {'imie' : 'Ola', 'kraj' : 'Polska', 'ulubione_liczby' : [7, 42, 92]}
 ```
 
-Za pomocą tej instrukcji stworzyłaś właśnie zmienną o nazwie `uczestniczka` zawierającą trzy pary klucz-wartość:
+With this command, you just created a variable named `participant` with three key–value pairs:
 
-*   Klucz `imie` wskazuje na wartość `'Ola'` (obiekt typu `string`),
-*   `kraj` wskazuje na wartość `'Polska'` (kolejny `string`),
-*   zaś `ulubione_liczby` odnoszą się do `[7, 42, 92]` (obiekt typu `list` zawierający trzy liczby).
+- Klucz `imie` wskazuje na wartość `'Ola'` (obiekt typu `string`),
+- `kraj` wskazuje na wartość `'Polska'` (kolejny `string`),
+- zaś `ulubione_liczby` odnoszą się do `[7, 42, 92]` (obiekt typu `list` zawierający trzy liczby).
 
 Za pomocą poniższej składni możesz sprawdzać wartości poszczególnych kluczy:
 
-    >>> print(uczestniczka['imie'])
-    Ola
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> print(uczestniczka['imie'])
+Ola
+```
 
-Widzisz, zupełnie jak w liście. Ale nie trzeba pamiętać numeru indeksu, wystarczy nazwa klucza.
+See, it's similar to a list. But you don't need to remember the index – just the name.
 
 A co się stanie, gdy poprosimy Pythona o wartość klucza, który nie istnieje? Masz pomysł? Spróbujmy tak zrobić i zobaczmy efekt!
 
-    >>> uczestniczka['wiek']
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    KeyError: 'wiek'
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> uczestniczka['wiek']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'wiek'
+```
 
 Spójrz, kolejny błąd! Tym razem **KeyError**. Python próbuje Ci pomóc i wskazuje, że klucz `'wiek'` nie istnieje w tym słowniku.
 
 Kiedy powinniśmy używać słownika, a kiedy listy? To bardzo dobre pytanie! Zastanów się nad rozwiązaniem, zanim spojrzysz na odpowiedź poniżej.
 
-*   Potrzebujesz ułożyć elementy w określonej kolejności? Wybierz listę.
-*   Potrzebujesz powiązać wartości z kluczami, żeby mieć później łatwiejszy dostęp do nich (używając klucza)? Użyj słownika.
+- Potrzebujesz ułożyć elementy w określonej kolejności? Wybierz listę.
+- Potrzebujesz powiązać wartości z kluczami, żeby mieć później łatwiejszy dostęp do nich (używając klucza)? Użyj słownika.
 
-Słowniki, podobnie jak listy, są *mutowalne*, co oznacza, że po ich utworzeniu można je nadal zmieniać. Możesz dodać do stworzonego już słownika nowe pary klucz-wartość, w taki sposób:
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
 
-    >>> uczestniczka['ulubiony_jezyk'] = 'Python'
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> uczestniczka['ulubiony_jezyk'] = 'Python'
+```
 
-Podobnie jak w przypadku list, metoda `len()` zwraca liczbę par klucz-wartość w danym słowniku. Śmiało, wpisz polecenie:
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
 
-    >>> len(uczestniczka)
-    4
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> len(uczestniczka)
+4
+```
 
-Mam nadzieję, że jak dotąd jest to zrozumiałe. :) Gotowa na dalszą zabawę ze słownikami? W następnej linijce czeka nas jeszcze więcej niesamowitości.
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
 
-Za pomocą polecenia `pop()` możesz usunąć element ze słownika. Założmy, że chciałabyś usunąć wpis oznaczony kluczem `'ulubione_liczby'`. Po prostu wpisz następującą instrukcję:
+You can use the `pop()` method to delete an item in the dictionary. Założmy, że chciałabyś usunąć wpis oznaczony kluczem `'ulubione_liczby'`. Po prostu wpisz następującą instrukcję:
 
-    >>> uczestniczka.pop('ulubione_liczby')
-    >>> uczestniczka
-    {'kraj': 'Polska', 'ulubiony_jezyk': 'Python', 'imie': 'Ola'}
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
 
-Jak widać z wyświetlonego rezultatu, para klucz-wartość odpowiadająca kluczowi 'ulubione_liczby' została usunięta.
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
 
-Ponadto możesz także zmienić wartość odpowiadającą kluczowi, który już istnieje w słowniku. Napisz:
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
 
-    >>> uczestniczka['kraj'] = 'Niemcy'
-    >>> uczestniczka
-    {'kraj': 'Niemcy', 'ulubiony_jezyk': 'Python', 'imie': 'Ola'}
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> uczestniczka['kraj'] = 'Niemcy'
+>>> uczestniczka
+{'kraj': 'Niemcy', 'ulubiony_jezyk': 'Python', 'imie': 'Ola'}
+```
 
-Jak widać, wartość klucza `'kraj'` została zmieniona z `'Polska'` na `'Niemcy'`. :) Ekscytujące? Hura! Właśnie nauczyłaś się kolejnej niesamowitej rzeczy.
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
 
 ### Podsumowanie
 
 Doskonale! Wiesz już sporo o programowaniu. W tej części nauczyłaś się o:
 
-*   **błędach** - umiesz już czytać ze zrozumieniem błędy pojawiające się, gdy Python nie rozumie polecenia, które mu wydałaś
-*   **zmiennych** - nazwach dla obiektów, dzięki którym programuje się łatwiej, a Twój kod jest czytelniejszy
-*   **listach** - listach obiektów uporządkowanych w określonej kolejności
-*   **słownikach** - zbiorach obiektów przechowywanych w postaci par klucz-wartość
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
 
 Gotowa na następną część? :)
 
 ## Porównywanie rzeczy
 
-Istotną częścią programowania jest porównywanie różnych rzeczy. Co najłatwiej porównać? Liczby oczywiście. Zobaczmy, jak to działa:
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
 
-    >>> 5 > 2
-    True
-    >>> 3 < 1
-    False
-    >>> 5 > 2 * 2
-    True
-    >>> 1 == 1
-    True
-    >>> 5 != 2
-    True
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
 
+{% filename %}command-line{% endfilename %}
 
-Dałyśmy Pythonowi różne liczby do porównania. Jak widać, potrafi on nie tylko porównywać liczby bezpośrednio, ale również wyniki działań na nich. Fajnie, nie?
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
 
-Zastanawiasz się, dlaczego stawiamy dwa znaki równości `==` obok siebie, gdy sprawdzamy, czy liczby są równe? Pojedynczego znaku równości `=` używamy do nadawania wartości zmiennym. **Zawsze, ale to zawsze** musisz używać dwóch znaków równości `==`, gdy chcesz sprawdzić, czy dane elementy są równe. Możemy również stwierdzić, że dwie rzeczy nie są sobie równe. Aby to zrobić, używamy symbolu `!=`, tak jak to zostało pokazane na przykładzie powyżej.
+Zastanawiasz się, dlaczego stawiamy dwa znaki równości `==` obok siebie, gdy sprawdzamy, czy liczby są równe? Pojedynczego znaku równości `=` używamy do nadawania wartości zmiennym. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. Możemy również stwierdzić, że dwie rzeczy nie są sobie równe. Aby to zrobić, używamy symbolu `!=`, tak jak to zostało pokazane na przykładzie powyżej.
 
 Użyjmy Pythona do wykonania dwóch innych zadań:
 
-    >>> 6 >= 12 / 2
-    True
-    >>> 3 <= 2
-    False
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
 
-`>` i `<` są zrozumiałe, ale co oznaczają `>=` i `<=`? Czytamy je w ten sposób:
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
 
-*   x `>` y oznacza: x jest większe od y
-*   x `<` y oznacza: x jest mniejsze od y
-*   x `<=` y oznacza: x jest mniejsze lub równe y
-*   x `>=` y oznacza: x jest większe lub równe y
+- x `>` y oznacza: x jest większe od y
+- x `<` y oznacza: x jest mniejsze od y
+- x `<=` y oznacza: x jest mniejsze lub równe y
+- x `>=` y oznacza: x jest większe lub równe y
 
 Świetnie! A chcesz zrobić coś jeszcze? Spróbuj tak:
 
-    >>> 6 > 2 and 2 < 3
-    True
-    >>> 3 > 2 and 2 < 1
-    False
-    >>> 3 > 2 or 2 < 1
-    True
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
 
 Możesz przekazać Pythonowi tyle liczb, ile Ci się podoba, a on zawsze zwróci Ci wynik! Prawda, że sprytne?
 
-*   **and** - gdy używasz operatora `and`, oba porównania muszą być prawdziwe (True), żeby całe wyrażenie było prawdziwe
-*   **or** - gdy używasz operatora `or`, tylko jedno z obu porównań musi być prawdziwe, aby całe wyrażenie było prawdziwe
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
 
 Znasz powiedzenie "porównywać jabłka z gruszkami"? Zobaczmy, jak działa jego odpowiednik w Pythonie:
 
-    >>> 1 > 'django'
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    TypeError: unorderable types: int() > str()
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
 
 Widać, że podobnie jak w powiedzeniu, Python nie jest w stanie porównać liczby (`int`) ze stringiem (`str`). Zamiast tego zwraca nam **TypeError** i mówi nam, że te dwa typy nie mogą być porównywane ze sobą.
 
 ## Obiekt logiczny (Boolean)
 
-Przez przypadek poznałaś nowy typ obiektu w Pythonie. Nazywa się **obiektem logicznym (Boolean)** -- i jest chyba najprostszym typem jaki istnieje.
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
 
-Są tylko dwa obiekty logiczne: 
-- True (prawda) 
-- False (fałsz)
+- True
+- False
 
-Jednak żeby Python mógł to zrozumieć, powinnaś zawsze zapisywać je tak: "True" (pierwsza litera wielka, reszta to małe litery). **true, TRUE, tRUE nie zadziałają -- tylko True jest poprawne.** (oczywiście to samo dotyczy pisowni "False".)
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
 
 Wartości logiczne mogą także być zmiennymi! Zobacz tutaj:
 
-    >>> a = True
-    >>> a
-    True
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> a = True
+>>> a
+True
+```
 
 Możesz też zrobić tak:
 
-    >>> a = 2 > 5
-    >>> a
-    False
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
 
 Poćwicz i pobaw się wartościami logicznymi wpisując następujące instrukcje:
 
-*   `True and True`
-*   `False and True`
-*   `True or 1 == 1`
-*   `1 != 2`
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
 
 Gratulacje! Wartości logiczne są jedną z najfajniejszych możliwości w programaniu, a Ty właśnie nauczyłaś się ich używać!
 
 # Zapisujemy!
 
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
 Do tej pory pisałyśmy cały nasz kod Pythona w interpreterze, co zmusza nas do pisania linijka po linijce. Prawdziwe programy są zapisywane w plikach i uruchamiane przez **interpreter** lub **kompilator** naszego języka programowania. Dotąd uruchamiałyśmy nasze programy w **interpreterze** Pythona, wprowadzając za każdym razem najwyżej jedną linijkę kodu. Ale w następnych zadaniach będziemy potrzebowały dodać więcej niż jeden wiersz kodu, więc musimy szybko:
 
-*   wyjść z interpretera Pythona
-*   otworzyć wybrany przez nas edytor kodu
-*   Zapisać kod do nowego pliku Pythona
-*   Uruchomić go!
+- wyjść z interpretera Pythona
+- otworzyć wybrany przez nas edytor kodu
+- Zapisać kod do nowego pliku Pythona
+- Uruchomić go!
 
-Aby wyjść z używanego przez nas interpretera Pythona, użyj po prostu funkcji `exit()`:
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
 
-    >>> exit()
-    $
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> exit()
+$
+```
 
 W ten sposób znajdziesz się z powrotem w wierszu poleceń.
 
-Nieco wcześniej, w sekcji [Edytor kodu][2], dokonałyśmy wyboru programu używanego przez nas do pisania kodu. Musimy go teraz otworzyć i zapisać kod w nowym pliku:
+Nieco wcześniej, w sekcji [Edytor kodu](../code_editor/README.md), dokonałyśmy wyboru programu używanego przez nas do pisania kodu. Musimy go teraz otworzyć i zapisać kod w nowym pliku:
 
- [2]: ../code_editor/README.md
+{% filename %}editor{% endfilename %}
 
 ```python
 print('Hello, Django girls!')
 ```
 
-> **Uwaga** Powinnaś zauważyć jedną z najfajniejszych rzeczy, jeśli chodzi o edytor kodu: kolory! Gdy pisałaś w konsoli Pythona, wszystko miało ten sam kolor. Teraz powinnaś zobaczyć, że funkcja `print` jest innego koloru niż string. Nazywa się to "podświetlanie składni" i jest naprawdę użyteczne podczas kodowania. Kolor wyrazów w edytorze będzie dla Ciebie wskazówką, np. łatwo rozpoznasz dzięki temu niezamknięty string albo literówkę w słowie kluczowym (tak jak `def` w funkcji). To jeden z powodów, dla których używamy edytora kodu :)
-
 Oczywiście jesteś już całkiem kompetentną programistką Pythona, więc śmiało - dodaj tam więcej kodu, który poznałaś wcześniej.
 
-Teraz musimy zapisać plik i nadać mu wymowną nazwę. Nazwijmy go **python_intro.py** i zapiszmy na Pulpicie. Możemy nazwać plik jak tylko nam się podoba, ale jedna rzecz jest istotna: na końcu nazwy musi być **.py**. Rozszerzenie **.py** informuje nasz komputer, że to jest **plik wykonywalny Pythona** i Python może go uruchomić.
+Teraz musimy zapisać plik i nadać mu wymowną nazwę. Nazwijmy go **python_intro.py** i zapiszmy na Pulpicie. Możemy nazwać plik jak tylko nam się podoba, ale jedna rzecz jest istotna: na końcu nazwy musi być **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. Nazywa się to "podświetlanie składni" i jest naprawdę użyteczne podczas kodowania. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). To jeden z powodów, dla których używamy edytora kodu. :)
 
 Mamy już zapisany plik, a więc czas go uruchomić! Wykorzystując wiadomości poznane w sekcji poświęconej wierszowi poleceń, użyj terminala, aby **zmienić aktualny katalog** na katalog Pulpitu.
 
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
 Na Macu polecenie będzie wyglądać mniej-więcej tak:
 
+{% filename %}command-line{% endfilename %}
+
     $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
 
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
 
-W Linuksie będzie tak (słowo "Desktop" może zostać przetłumaczone na polski jako "Pulpit"):
+{% filename %}command-line{% endfilename %}
 
     $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
 
+On Windows Command Prompt, it will be like this:
 
-A w systemie Windows będzie to wyglądać tak:
+{% filename %}command-line{% endfilename %}
 
     > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
 
+<!--endsec-->
 
 Jeżeli coś jest dla Ciebie niejasne, nie wahaj się poprosić o pomoc.
 
 Teraz użyj Pythona do uruchomienia kodu z pliku w następujący sposób:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
 
+```python
+> python python_intro.py
+```
 
 Super! Właśnie uruchomiłaś z pliku swój pierwszy program w Pythonie. Wspaniałe uczucie, co?
 
 Teraz możemy przejść do niezwykle istotnego narzędzia w programowaniu:
 
-## If...elif...else
+## If…elif…else
 
-Dużo różnych rzeczy w kodzie powinno być uruchamiane tylko wtedy, kiedy zostaną spełnione określone warunki. Dlatego Python posiada coś, co nazywa się **instrukcjami warunkowymi**.
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
 
 Zastąp kod w pliku **python_intro.py** następującym:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
-```  
+```
+
+If we were to save and run this, we'd see an error like this:
 
-Gdybyśmy to teraz zapisały i uruchomiły, pojawił się błąd podobny do poniższego:
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     File "python_intro.py", line 2
              ^
     SyntaxError: unexpected EOF while parsing
+    
 
+Python oczekuje od nas dalszych instrukcji, które mają zostać wykonane w przypadku, gdy warunek `3 > 2` okaże się prawdziwy (czyli przyjmie wartość `True`). Sprawmy, żeby Python wypisał na ekranie "To działa!”. Zmień kod w pliku **python_intro.py** na poniższy:
 
-Python oczekuje od nas dalszych instrukcji, które mają zostać wykonane w przypadku, gdy warunek `3 > 2` okaże się prawdziwy (czyli przyjmie wartość `True`). Sprawmy, żeby Python wypisał na ekranie "To działa!". Zmień kod w pliku **python_intro.py** na poniższy:
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 if 3 > 2:
@@ -552,14 +725,21 @@ Zauważyłaś, że w kolejnym wierszu nasz kod posiada wcięcie 4 spacji? Musimy
 
 Zapisz plik i uruchom go jeszcze raz:
 
-    $ python3 python_intro.py
-    To działa!
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+To dziala!
+```
 
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
 
 ### A co jeśli warunek nie jest prawdziwy?
 
 W poprzednich przykładach kod był wykonywany wtedy, gdy warunki okazywały się prawdziwe (True). Ale Python posiada również wyrażenia `elif` i `else`:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 5 > 2:
     print('5 jest jednak większe od 2')
@@ -569,11 +749,15 @@ else:
 
 Po uruchomieniu wyświetli się:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     5 jest jednak większe od 2
+    
 
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
 
-Gdyby 2 było większą liczbą niż 5, wtedy zostałaby wykonana druga instrukcja. Proste, nie? Zobaczmy, jak działa `elif`:
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 name = 'Sonja'
@@ -582,65 +766,93 @@ if name == 'Ola':
 elif name == 'Sonja':
     print('Hej Sonja!')
 else:
-    print('Hej nieznajoma!')
+    print('Hej anonimie!')
 ```
 
 i uruchommy go:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hej Sonja!
-
+    
 
 Widzisz co się tutaj wydarzyło? `elif` pozwala Ci na dodanie dodatkowego warunku, jeśli poprzedni warunek nie został spełniony.
 
 Po początkowej instrukcji `if` możesz dodać tyle instrukcji `elif` ile tylko Ci się podoba. Na przykład:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-glosnosc = 57
-if glosnosc < 20:
-    print("Prawie nic nie słychać.")
-elif 20 <= glosnosc < 40:
-    print("O, muzyka leci w tle.")
-elif 40 <= glosnosc < 60:
-    print("Idealnie, mogę usłyszeć wszystkie detale")
-elif 60 <= glosnosc < 80:
-    print("Dobre na imprezy")
-elif 80 <= glosnosc < 100:
-    print("Troszeczkę za głośno!")
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
 else:
-    print("Ojoj! Moje uszy! :(")
+    print("My ears are hurting! :(")
 ```
 
 Python zbada każdy warunek i wyświetli:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
-    Idealnie, mogę usłyszeć wszystkie detale
+    Idealnie, moge uslyszec wszystkie detale
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
 
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
 
 ### Podsumowanie
 
-W ostatnich trzech ćwiczeniach nauczyłaś się:
+In the last few exercises you learned about:
 
-*   **porównywać rzeczy** - w Pythonie do porównywania rzeczy możesz używać operatorów `>`, `>=`, `==`, `<=`, `<` oraz `and` i `or`
-*   **Boolean** - typ obiektu, który może przyjmować jedną z dwóch wartości: `True` (prawda) lub `False` (fałsz)
-*   **zapisywać pliki** - przechowywać kod w plikach, co pozwala nam uruchamiać bardziej rozbudowane programy.
-*   **if...elif...else** - wyrażenia, które pozwalają Ci uruchamiać kod tylko wtedy, gdy zostaną spełnione określone warunki.
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
 
 Czas na ostatnią część tego rozdziału!
 
 ## Twoje własne funkcje!
 
-Pamiętasz funkcje takie jak `len()`, które możesz uruchamiać w Pythonie? Dobra wiadomość: teraz nauczysz się pisać swoje własne funkcje!
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
 
-Funkcja jest zestawem poleceń, które Python ma wykonać. Każda funkcja w Pythonie zaczyna się słowem `def`, posiada nazwę i może przyjmować parametry. Zacznijmy od prostej funkcji. Zastąp kod w pliku **python_intro.py** następującym:
+Funkcja jest zestawem poleceń, które Python ma wykonać. Każda funkcja w Pythonie zaczyna się słowem `def`, posiada nazwę i może przyjmować parametry. Let's give it a go. Zastąp kod w pliku **python_intro.py** następującym:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
-def hej():
+def hi():
     print('Hej!')
     print('Jak się masz?')
 
-hej()
-```  
+hi()
+```
 
 OK, nasza pierwsza funkcja gotowa!
 
@@ -648,121 +860,159 @@ Być może zastanawiasz się, czemu napisałyśmy nazwę funkcji na końcu pliku
 
 Uruchommy to teraz i sprawdźmy, co się stanie:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hej!
     Jak się masz?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
 
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
 
-To nie było trudne! Zbudujmy naszą pierwszą funkcję z parametrami. Posłużymy się wcześniejszym przykładem - funkcją, która wita każdego, kto ją uruchomi, wraz z imieniem:
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
-def hej(imie):
+def hi(name):
 ```
 
 Jak widać, teraz nasza funkcja przyjmuje parametr, który nazwałyśmy `imie`:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-def hej(imie):
-    if imie == 'Ola':
+def hi(name):
+    if name == 'Ola':
         print('Hej Ola!')
-    elif imie == 'Sonja':
+    elif name == 'Sonja':
         print('Hej Sonja!')
     else:
-        print('Hej nieznajoma!')
+        print('Hej anonimie!')
 
-hej()
+hi()
 ```
 
 Pamiętaj: Musiałyśmy dodać cztery dodatkowe spacje (razem osiem) przed funkcją `print`, ponieważ `if` musi dostać informację o tym, co powinno się wydarzyć, gdy warunek zostanie spełniony. Zobaczmy teraz jak to działa:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Traceback (most recent call last):
     File "python_intro.py", line 10, in <module>
       hej()
     TypeError: hej() missing 1 required positional argument: 'imie'
-
+    
 
 Ups, błąd. Na szczęście Python zwrócił nam dość przydatny komunikat. Mówi nam, że funkcja `hej()` (ta, którą stworzyliśmy) posiada jeden wymagany argument (zwany `imie`) i że zapomniałyśmy go przekazać przy wywoływaniu funkcji. Naprawmy to na końcu naszego pliku:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-hej("Ola")
+hi("Ola")
 ```
 
-I wykonajmy ponownie:
+I wykonajmy ponownIe:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hej Ola!
-
+    
 
 A gdybyśmy zmieniły imię?
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-hej("Sonja")
+hi("Sonja")
 ```
 
 I wykonajmy:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hej Sonja!
+    
 
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
 
-A jak myślisz - co się stanie, jak wprowadzimy tam inne imię (jeszcze inne niż Ola i Sonja)? Spróbuj i przekonaj się, czy miałaś rację. Powinno sie wyświetlić coś takiego:
+{% filename %}command-line{% endfilename %}
 
     Hej nieznajoma!
+    
 
+Prawda, że fajnie? W ten sposób nie musisz powtarzać się za każdym razem, gdy zechcesz zmienić imię osoby, która ma zostać powitana. And that's exactly why we need functions – you never want to repeat your code!
 
-Prawda, że fajnie? W ten sposób nie musisz powtarzać się za każdym razem, gdy zechcesz zmienić imię osoby, która ma zostać powitana. To właśnie dlatego funkcje są nam potrzebne - żeby nie powtarzać kodu!
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
 
-Zróbmy coś sprytniejszego -- istnieje znacznie więcej niż dwa imiona i raczej ciężko byłoby pisać warunek dla każdego, co?
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
-def hej(imie):
-    print('Hej ' + imie + '!')
+def hi(name):
+    print('Hej ' + name + '!')
 
-hej("Rachel")
+hi("Rachel")
 ```
 
 Teraz wywołajmy ten kod:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hej Rachel!
+    
 
-
-Gratulacje! Właśnie nauczyłaś się pisać funkcje :)
+Gratulacje! Właśnie nauczyłaś się pisać funkcje! :)
 
 ## Pętle
 
-To już ostatnia część. Prawda, że szybko poszło? :)
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+To już ostatnia cześć. Prawda, że szybko poszło? :)
 
 Jak już wspomniałyśmy, programiści są leniwi i nie lubią się powtarzać. W programowaniu chodzi o automatyzowanie różnych rzeczy, więc nie chcemy witać ręcznie każdej osoby po imieniu, prawda? I tu właśnie przydają nam się pętle.
 
 Pamiętasz jeszcze listy? Zróbmy listę dziewczyn:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 dziewczyny = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'Ty']
 ```
 
 Chcemy powitać po imieniu każdą z nich. Mamy do tego funkcję `hej`, zatem użyjmy jej wewnątrz pętli:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 for imie in dziewczyny:
 ```
 
-Wyrażenie `for` zachowuje się podobnie jak `if`, a więc kod pod nimi musi być wcięty 4 spacjami.
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
 
 Oto kompletny kod, który umieścimy w pliku:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-def hej(imie):
-    print('Hej ' + imie + '!')
+def hi(name):
+    print('Witaj ' + name + '!')
 
 dziewczyny = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'Ty']
 for imie in dziewczyny:
-    hej(imie)
+    hi(imie)
     print('Kolejna dziewczyna')
 ```
 
-a gdy go uruchomimy:
+A gdy go uruchomimy:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hej Rachel!
@@ -775,12 +1025,14 @@ a gdy go uruchomimy:
     Kolejna dziewczyna
     Hej Ty!
     Kolejna dziewczyna
-
+    
 
 Jak widzisz, cokolwiek umieścisz wewnątrz wyrażenia `for` wraz z wcięciem - zostanie powtórzone dla każdego elementu listy `dziewczyny`.
 
 Możesz także użyć `for` na liczbach, używając metody `range`:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 for i in range(1, 6):
     print(i)
@@ -788,23 +1040,23 @@ for i in range(1, 6):
 
 Co wypisze nam na ekranie:
 
+{% filename %}command-line{% endfilename %}
+
     1
     2
     3
     4
     5
-
+    
 
 `range` jest funkcją, która tworzy listę liczb jedna po drugiej (liczby te podajesz jako parametry).
 
-Zwróć uwagę, że druga z tych liczb nie jest częścią listy stworzonej przez Pythona (to znaczy, że `range(1, 6)` liczy od 1 do 5, ale nie zawiera liczby 6). Dzieje się tak, bo "range" ma przedział jednostronnie otwarty, co oznacza, że zawiera pierwszą wartość z przedziału, ale nie zawiera ostatniej.
+Zwróć uwagę, że druga z tych liczb nie jest częścią listy stworzonej przez Pythona (to znaczy, że `range(1, 6)` liczy od 1 do 5, ale nie zawiera liczby 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
 
 ## Podsumowanie
 
 To już wszystko. **Wspaniale Ci idzie!** To nie było wcale takie łatwe, możesz zatem być z siebie dumna. My zdecydowanie jesteśmy z Ciebie dumne, że dotarłaś do tego miejsca!
 
-Jak myślisz, może czas na małą przerwę? Rozciągnij się, rozprostuj nogi, daj odpocząć oczom, zanim przejdziesz do kolejnego rozdziału. :)
-
-![Babeczka][3]
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
 
- [3]: images/cupcake.png
+![Babeczka](images/cupcake.png)
\ No newline at end of file
diff --git a/pl/signup_pythonanywhere.md b/pl/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/pl/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/pl/template_extending/README.md b/pl/template_extending/README.md
index b164fdf4ea3..145352858a3 100755
--- a/pl/template_extending/README.md
+++ b/pl/template_extending/README.md
@@ -2,11 +2,11 @@
 
 Kolejną fajną rzeczą, którą Django daje Ci do dyspozycji, jest możliwość **rozszerzania szablonów**. Co to oznacza? To znaczy, że możesz używać tych samych części Twojego kodu HTML na różnych stronach Twojej aplikacji.
 
-Dzięki temu, jeśli chcesz mieć te same informacje albo ten sam layout to nie musisz się powtarzać w każdym pliku. Tak samo jeśli chcesz coś zmienić - nie musisz edytować kilku plików, robisz to tylko raz!
+Szablony pomagają, gdy chcesz te same informacje lub ten sam układ strony użyć w wielu miejscach. W takim wypadku nie musisz się powtarzać w każdym pliku. I jak będziesz chciała zmienić cokolwiek, nie będziesz musiała tego zrobić w każdym szablonie, wystarczy tylko w jednym!
 
 ## Tworzenie szablonu bazowego
 
-Szablon bazowy to najbardziej podstawowy szablon, który możesz rozszerzać na każdej stronie Twojej aplikacji.
+Szablon bazowy to najbardziej podstawowy szablon, który możesz rozszerzać na każdej stronie twojej aplikacji.
 
 Stwórzmy plik `base.html` w `blog/templates/blog/`:
 
@@ -15,10 +15,12 @@ Stwórzmy plik `base.html` w `blog/templates/blog/`:
         └───blog
                 base.html
                 post_list.html
-
+    
 
 Następnie otwórz go i skopiuj całą zawartość pliku `post_list.html` do pliku `base.html`, w taki sposób:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -55,6 +57,8 @@ Następnie otwórz go i skopiuj całą zawartość pliku `post_list.html` do pli
 
 Następnie, w `base.html`, zamień całą zawartość `<body>` (wszystko, co znajduje się pomiędzy `<body>` a `</body>`) na to:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <body>
     <div class="page-header">
@@ -71,16 +75,20 @@ Następnie, w `base.html`, zamień całą zawartość `<body>` (wszystko, co zna
 </body>
 ```
 
-W zasadzie zastąpiłyśmy całą treść wewnątrz `{% for post in posts %}{% endfor %}` tym:
+{% raw %}Mogłaś zauważyć, że zamieniło to wszystko od `{% for post in posts %}` do `{% endfor %}` na: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% block content %}
 {% endblock %}
 ```
 
-Co to znaczy? Stworzyłaś właśnie `block` (blok), który jest znacznikiem szablonu umożliwiającym Ci wstawienie HTML wewnątrz tego bloku w innych szablonach, które rozszerzają `base.html`. Za chwilę pokażemy Ci, jak to się robi.
+Ale czemu? Właśnie stworzyłaś `block`! Użyłaś znacznika szablonu `{% block %}` by zaznaczyć obszar, w który zostanie wstawiony HTML. Ten HTML będzie pochodził z innego szablonu, który rozszerza ten szablon (`base.html`). Za chwilę pokażemy Ci, jak to się robi.
+
+To teraz zapisz `base.html` i otwórz ponownie swój `blog/templates/blog/post_list.html`. {% raw %}Usuniemy teraz wszystko powyżej `{% for post in posts %}` i poniżej `{% endfor %}`. Jak to zrobisz, plik będzie wyglądać tak:{% endraw %}
 
-Teraz zapisz zmiany, a potem otwórz jeszcze raz plik `blog/templates/blog/post_list.html`. Usuń całą zawartość z wyjątkiem zawartości znacznika body, a potem usuń także `<div class="page-header"></div>`, aby plik wyglądał tak:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
@@ -94,13 +102,29 @@ Teraz zapisz zmiany, a potem otwórz jeszcze raz plik `blog/templates/blog/post_
 {% endfor %}
 ```
 
-A teraz dodaj ten wiersz na początku pliku:
+Będziemy chciały użyć tych kliku linii jako części szablonu dla wszystkich bloków treści. Najwyższy czas dodać znaczniki blog w tym pliku!
+
+{% raw %}Musimy zrobić to tak, by nasz znacznik block zgadzał się ze znacznikiem w pliku `base.html`. Chcesz też by zawierał on cały kod, który należy do twoich bloków treści. By to osiągnąć, umieść wszystko pomiędzy `{% block content %}` i `{% endblock %}`. O tak:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-{% extends 'blog/base.html' %}
-```  
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
 
-{% raw %}To znaczy, że rozszerzamy szablon `base.html` w pliku `post_list.html`. Zostało już tylko jedno: wstaw całą treść (pomijając wiersz, który właśnie dodałyśmy) pomiędzy `{% block content %}` a `{% endblock %}`. O tak:{% endraw %}
+Została jeszcze jedna rzecz. Musimy połączyć te dwa szablony razem. To właśnie na tym polega rozszerzaniem szablonów! Dokonamy tego dodając tag extend na początku nasze pliku. Właśnie tak:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -116,8 +140,8 @@ A teraz dodaj ten wiersz na początku pliku:
         </div>
     {% endfor %}
 {% endblock %}
-```  
+```
 
 I już! Sprawdź, czy twoja strona nadal działa poprawnie. :)
 
-> Jeżeli dostajesz błąd `TemplateDoesNotExists` mówiący, że brakuje pliku `blog/base.html` i masz uruchomiony `runserver` w konsoli, spróbuj go zatrzymać (wciśnij Ctrl+C - klawisze Control i C jednocześnie) i uruchomić ponownie za pomocą polecenia `python manage.py runserver`.
+> Jeżeli dostaniesz błąd `TemplateDoesNotExist`, oznacza to, że nie ma jesze pliku `blog/base.html` i jednocześnie w konsoli działa uruchomiony `runserver`. Spróbuj go zatrzymać (wciskając Ctrl+C - czy razem klawisze Control i C) i uruchomić ponownie przy użyciu polecenia `python manage.py runserver`.
\ No newline at end of file
diff --git a/pl/whats_next/README.md b/pl/whats_next/README.md
index ee7264afc48..6a2e71c5a72 100755
--- a/pl/whats_next/README.md
+++ b/pl/whats_next/README.md
@@ -1,40 +1,25 @@
 # Co dalej?
 
-Możesz być z siebie dumna! **Jesteś absolutnie świetna**. Jesteśmy takie dumne! <3
+Możesz z siebie być dumna! **Jesteś absolutnie świetna**. Jesteśmy takie dumne! <3
 
 ### Co teraz?
 
 Zrób sobie przerwę i zrelaksuj się. Odwaliłaś kawał dobrej roboty!
 
-Zaraz po tym, upewnij się, że:
+Potem, upewnij się, że śledzisz Django Girls na [Facebooku](http://facebook.com/djangogirls) i [Twitterze](https://twitter.com/djangogirls) by być na bieżąco.
 
-*   Obserwujesz Django Girls na [Facebooku][1] lub [Twitterze][2], żeby być na bieżąco
+### Czy możesz polecić kolejne materiały?
 
- [1]: http://facebook.com/djangogirls
- [2]: https://twitter.com/djangogirls
+Tak! Po pierwsze, śmiało, sprawdź naszą inną pozycję pod tytułem [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
 
-### Czy możesz polecić kolejne materiały?
+Później możesz spróbować zasobów wyszczególnionych poniżej. Są one bardzo polecane!
 
-Tak! Najpierw możesz spróbować naszej kolejnej książki: [Django Girls Tutorial: Extensions][3] -- zawiera rozszerzenia i dodatkowe zadania związane z tym, co już tutaj przerobiłaś.
-
- [3]: https://tutorial-extensions.djangogirls.org
-
-Możesz też wypróbować materiały, które wypisałyśmy poniżej. Wszystkie bardzo polecamy!
-
-- [Oficjalna dokumentacja Django][4]
-- [instrukcje New Coder][5]
-- [kurs Code Academy Python][6]
-- [kurs Code Academy HTML & CSS][7]
-- [tutorial Django Carrots][8]
-- [książka Learn Python The Hard Way][9]
-- [video lekcje Getting Started With Django][10]
-- [książka Two Scoops of Django: Best Practices for Django 1.8][11]
-
- [4]: https://docs.djangoproject.com/en/1.8/intro/tutorial01/
- [5]: http://newcoder.io/tutorials/
- [6]: https://www.codecademy.com/en/tracks/python/
- [7]: https://www.codecademy.com/tracks/web/
- [8]: https://github.com/ggcarrots/django-carrots/
- [9]: http://learnpythonthehardway.org/book/
- [10]: http://www.gettingstartedwithdjango.com/
- [11]: https://twoscoopspress.com/products/two-scoops-of-django-1-8/
+- [Oficjalny tutorial Django](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [Tutoriale New Coder](http://newcoder.io/tutorials/)
+- [Kurs Pythona na Code Academy](https://www.codecademy.com/en/tracks/python)
+- [Kurs HTML i kurs CSS na Code Academy](https://www.codecademy.com/tracks/web)
+- [Tutorial Django Carrots](https://github.com/ggcarrots/django-carrots)
+- [Książka Learn Python The Hard Way](http://learnpythonthehardway.org/book/)
+- [Wideolekcje Getting Started with Django](http://www.gettingstartedwithdjango.com/)
+- [Książka Two Scoops of Django 1.11: Best Practices for Django Web Framework](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - możesz także poprosić o darmową licencję na ebooka kontaktując się z autorką Tracy Osborn pod adresem <tracy@limedaring.com>
\ No newline at end of file
diff --git a/ps-AF/GLOSSARY.md b/ps-AF/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/ps-AF/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/ps-AF/README.md b/ps-AF/README.md
new file mode 100644
index 00000000000..121da8f55bf
--- /dev/null
+++ b/ps-AF/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ps-AF/SUMMARY.md b/ps-AF/SUMMARY.md
new file mode 100644
index 00000000000..d9741b4f21c
--- /dev/null
+++ b/ps-AF/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/ps-AF/chromebook_setup/README.md b/ps-AF/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/ps-AF/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ps-AF/chromebook_setup/instructions.md b/ps-AF/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..2df2048e6ec
--- /dev/null
+++ b/ps-AF/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ps-AF/code_editor/README.md b/ps-AF/code_editor/README.md
new file mode 100644
index 00000000000..0a401fb1f52
--- /dev/null
+++ b/ps-AF/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ps-AF/code_editor/instructions.md b/ps-AF/code_editor/instructions.md
new file mode 100644
index 00000000000..82fbac15aad
--- /dev/null
+++ b/ps-AF/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ps-AF/css/README.md b/ps-AF/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/ps-AF/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/ps-AF/deploy/README.md b/ps-AF/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/ps-AF/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/ps-AF/deploy/install_git.md b/ps-AF/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/ps-AF/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ps-AF/deploy/signup_pythonanywhere.md b/ps-AF/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/ps-AF/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ps-AF/django/README.md b/ps-AF/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/ps-AF/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/ps-AF/django_admin/README.md b/ps-AF/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/ps-AF/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ps-AF/django_forms/README.md b/ps-AF/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/ps-AF/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ps-AF/django_installation/README.md b/ps-AF/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/ps-AF/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ps-AF/django_installation/instructions.md b/ps-AF/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/ps-AF/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ps-AF/django_models/README.md b/ps-AF/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/ps-AF/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ps-AF/django_orm/README.md b/ps-AF/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/ps-AF/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ps-AF/django_start_project/README.md b/ps-AF/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/ps-AF/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ps-AF/django_templates/README.md b/ps-AF/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/ps-AF/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ps-AF/django_urls/README.md b/ps-AF/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/ps-AF/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ps-AF/django_views/README.md b/ps-AF/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/ps-AF/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ps-AF/dynamic_data_in_templates/README.md b/ps-AF/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/ps-AF/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ps-AF/extend_your_application/README.md b/ps-AF/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/ps-AF/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ps-AF/how_the_internet_works/README.md b/ps-AF/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/ps-AF/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ps-AF/html/README.md b/ps-AF/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/ps-AF/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ps-AF/installation/README.md b/ps-AF/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/ps-AF/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ps-AF/intro_to_command_line/README.md b/ps-AF/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/ps-AF/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ps-AF/intro_to_command_line/open_instructions.md b/ps-AF/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/ps-AF/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ps-AF/python_installation/README.md b/ps-AF/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/ps-AF/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ps-AF/python_installation/instructions.md b/ps-AF/python_installation/instructions.md
new file mode 100644
index 00000000000..c266c479181
--- /dev/null
+++ b/ps-AF/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> دغه برخه د يوه ټيوټوريل کوم چي Geek Girls Carrots جوړکري دی پر بنسټ جوړه شويده. (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ps-AF/python_introduction/README.md b/ps-AF/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/ps-AF/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ps-AF/template_extending/README.md b/ps-AF/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/ps-AF/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ps-AF/whats_next/README.md b/ps-AF/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/ps-AF/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/pt-BR/GLOSSARY.md b/pt-BR/GLOSSARY.md
new file mode 100644
index 00000000000..5f8b3e897a6
--- /dev/null
+++ b/pt-BR/GLOSSARY.md
@@ -0,0 +1,3 @@
+# editor de código
+
+O editor de código é uma aplicação que lhe permite salvar seu código de tal forma que você possa editá-lo mais tarde. Você aprende a escolher e de onde baixar um no [capítulo Editor de Código](./code_editor/README.md)
\ No newline at end of file
diff --git a/pt-BR/README.md b/pt-BR/README.md
new file mode 100644
index 00000000000..b6835044c37
--- /dev/null
+++ b/pt-BR/README.md
@@ -0,0 +1,51 @@
+# Tutorial Django Girls
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Este trabalho é licenciado sob a licença Creative Commons Attribution-ShareAlike 4.0. Para ver uma cópia desta licença, visite https://creativecommons.org/licenses/by-sa/4.0/
+
+## Bem-vinda
+
+Bem-vinda ao Tutorial Django Girls! Estamos felizes em te ver aqui. :) Neste tutorial, vamos levá-lo em uma viagem por baixo do capô das tecnologias da Web oferecendo um vislumbre de todos os bits e peças que precisam se juntar para fazer a web funcionar da forma como a conhecemos.
+
+Como todas as coisas desconhecidas, esta vai ser uma aventura - mas não se preocupe, já que vocês já tiveram coragem de estar aqui, você estará bem. :)
+
+## Introdução
+
+Você já sentiu como se o mundo fosse cada vez mais tecnológico e que de alguma forma você ficou pra trás? Você já imaginou como seria criar um website, mas nunca teve motivação suficiente para começar? Você já pensou que o mundo do software é complicado demais até mesmo para você tentar fazer alguma coisa sozinha?
+
+Bem, nós temos boas notícias! Programação não é tão difícil quanto parece, e nós queremos te mostrar o quão divertido pode ser.
+
+Este tutorial não irá te transformar magicamente em uma programadora. Se você quer ser boa nisso, precisa de meses ou até mesmo anos de treino e prática. Mas nós queremos te mostrar que a programação e a criação de websites não são tão complicadas quanto parecem. Nós tentaremos explicar as diferentes etapas tão bem quanto pudermos, de forma que você não se sinta intimidada pela tecnologia.
+
+Nós esperamos conseguir fazer você amar a tecnologia tanto quanto nós amamos!
+
+## O que você vai aprender durante o tutorial?
+
+Quando terminar o tutorial, você terá uma pequena aplicação web funcional: seu próprio blog. Nós vamos mostrar como colocá-lo online para que outras pessoas vejam seu trabalho!
+
+Ele se parecerá (mais ou menos) com isso:
+
+![Figura 0.1](images/application.png)
+
+> Se você seguir o tutorial por conta própria e não tiver uma monitora para ajudar, podemos te ajudar a resolver qualquer problema por esse chat: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Nós pedimos às nossas monitoras e participantes anteriores para acessarem o chat de tempos em tempos para ajudar outras pessoas com o tutorial! Não tenha medo de fazer sua pergunta!
+
+OK, [vamos começar pelo começo...](./how_the_internet_works/README.md)
+
+## Seguindo o tutorial em casa
+
+É incrível participar de um workshop de Django Girls, mas estamos conscientes de que isso nem sempre é possível. É por isso que encorajamos você a tentar seguir este tutorial em casa. Para leitores em casa, estamos atualmente preparando vídeos que facilitarão seguir o tutorial por conta própria. Ainda é um trabalho em andamento, mas mais e mais coisas serão abordadas em breve no canal do YouTube [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed).
+
+Em cada capítulo que já abordamos, há um link que aponta para o vídeo correspondente.
+
+## Sobre o tutorial e contribuições
+
+Este tutorial é mantido por [DjangoGirls](https://djangogirls.org/). Se você encontrar quaisquer erros ou quiser atualizar o tutorial, por favor, [siga as orientações de contribuição](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Você gostaria de nos ajudar a traduzir este tutorial para outros idiomas?
+
+No momento, traduções estão sendo mantidas na plataforma crowdin.com em:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Se o seu idioma não está listado no [crowdin](https://crowdin.com/), por favor [abra uma requisição](https://github.com/DjangoGirls/tutorial/issues/new) informando-nos do idioma para que possamos adicioná-lo.
\ No newline at end of file
diff --git a/pt-BR/SUMMARY.md b/pt-BR/SUMMARY.md
new file mode 100644
index 00000000000..9229437ca08
--- /dev/null
+++ b/pt-BR/SUMMARY.md
@@ -0,0 +1,35 @@
+# Sumário
+
+* [Introdução](README.md)
+* [Instalação](installation/README.md) 
+  * [Linha de Comando](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Editor de código](installation/README.md#code-editor)
+  * [Ambiente Virtual](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Configuração do Chromebook](chromebook_setup/README.md)
+* [Como a Internet funciona](how_the_internet_works/README.md)
+* [Introdução à linha de comando](intro_to_command_line/README.md)
+* [Instalação do Python](python_installation/README.md)
+* [Editor de Código](code_editor/README.md)
+* [Introdução ao Python](python_introduction/README.md)
+* [O que é Django?](django/README.md)
+* [Instalação do Django](django_installation/README.md)
+* [Seu primeiro projeto Django!](django_start_project/README.md)
+* [Modelos do Django](django_models/README.md)
+* [Django Admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views - hora de criar!](django_views/README.md)
+* [Introdução ao HTML](html/README.md)
+* [QuerySets e ORM do Django](django_orm/README.md)
+* [Dados dinâmicos em templates](dynamic_data_in_templates/README.md)
+* [Templates do Django](django_templates/README.md)
+* [CSS - Deixe tudo mais bonito!](css/README.md)
+* [Estendendo os templates](template_extending/README.md)
+* [Amplie sua aplicação](extend_your_application/README.md)
+* [Formulários do Django](django_forms/README.md)
+* [O que vem agora?](whats_next/README.md)
\ No newline at end of file
diff --git a/pt-BR/chromebook_setup/README.md b/pt-BR/chromebook_setup/README.md
new file mode 100644
index 00000000000..e647bf6414e
--- /dev/null
+++ b/pt-BR/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Configuração do Chromebook
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/pt-BR/chromebook_setup/instructions.md b/pt-BR/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..1e7b9d1795e
--- /dev/null
+++ b/pt-BR/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Você pode [pular este capítulo](http://tutorial.djangogirls.org/en/installation/#install-python) se não estiver usando um Chromebook. Caso esteja, sua experiência de instalação será um pouco diferente. Você pode ignorar o restante das instruções de instalação.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+O IDE na nuvem é uma ferramenta que fornece um editor de código e acesso a um computador em execução na Internet, onde você pode instalar, gravar e executar software. Pela duração desse tutorial, o IDE na nuvem funcionará como sua * máquina local *. Você ainda estará executando comandos em uma interface de terminal (ou prompt de comando), como suas colegas de oficina no OS X, Ubuntu ou Windows, mas seu prompt estará conectado a um computador remoto configurado pelo Cloud 9. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Você pode escolher uma das IDEs na nuvem e seguir as instruções.
+
+#### IDE na Nuvem PaizaCloud
+
+1. Vá para *PaizaCloud Cloud IDE *
+2. Registre-se
+3. Clique em *Novo Servidor* e escolha o aplicativo Django
+4. Clique no botão Terminal (no lado esquerdo da janela)
+
+Agora você deve ver uma interface com uma barra lateral, botões no canto esquerdo. Clique no botão "Terminal" para abrir a janela de terminal com prompt desta maneira:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+O terminal na IDE na nuvem PaizaCloud está pronto para suas instruções. Você pode ajustar o tamanho ou maximizar a janela para torná-la um pouco maior.
+
+#### AWS Cloud9
+
+Atualmente o Cloud 9 requer que você se cadastre com AWS e insira as informações do cartão de crédito.
+
+1. Instale o Cloud 9 através do [Chrome Web Store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Acesse [c9.io](https://c9.io) e clique em *Iniciar com AWS Cloud9*
+3. Cadastre-se em uma conta AWS (requer informações de cartão de crédito, mas você pode usá-la gratuitamente)
+4. No painel de controle da AWS, digite *Cloud9* na barra de pesquisa e clique nele
+5. No painel de controle do Cloud 9, click em *Create environment*
+6. Nomeie como *django-girls*
+7. Ao configurar, selecione *Criar uma nova instância para o ambiente (EC2)* para "Tipo de Ambiente" e o *t2.micro* "Tipo de Instância" (deve dizer "Free-tier elegíveel."). A configuração padrão de economia de custos está bem e você pode manter o outro padrão.
+8. Clique em *Próximo passo*
+9. Clique em *Criar ambiente*
+
+Agora, a sua tela deve exibir uma interface com uma barra lateral, uma grande janela principal com algum texto e uma pequena janela na parte inferior, semelhante a isto:
+
+{% filename %}bash{% endfilename %}
+
+    seunomedeusuário:~/workspace $
+    
+
+Essa janela na parte inferior é o seu terminal. Você pode usá-la para enviar instruções para o computador remoto Cloud 9. Se preferir, você pode redimensioná-la para que fique um pouco maior.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Crie uma conta (https://glitch.com/signup) ou use a sua conta do GitHub se tiver uma. (Veja instruções abaixo)
+3. Clique * Novo projeto* e escolha*hello-webpage*
+4. Clique na lista suspensa de Ferramentas (no lado esquerdo inferior da janela), em seguida clique no botão Terminal para abrir a aba terminal com um prompt assim:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Depois que esse arquivos foram criados, vá para o Terminal e execute os seguintes comandos para criar seu primeiro projeto Django:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Ambiente Virtual
+
+Um ambiente virtual (também chamado virtualenv) é como uma caixa privada em que podemos colocar código de computador útil em um projeto em que estamos trabalhando. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/pt-BR/code_editor/README.md b/pt-BR/code_editor/README.md
new file mode 100644
index 00000000000..d6178a240cb
--- /dev/null
+++ b/pt-BR/code_editor/README.md
@@ -0,0 +1,11 @@
+# Editor de Código
+
+> Para leitoras em casa: esse capítulo é abordado no vídeo [Instalando Python & Editor de Código](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+Você está prestes a escrever sua primeira linha de código, então é hora de baixar um editor de código!
+
+> **Observação:** se você estiver usando um Chromebook, pule este capitulo e certifique-se de seguir as instruções em [Chromebook Setup](../chromebook_setup/README.md). A IDE na nuvem que escolher (PaizaCloud Cloud IDE ou AWS Cloud9) inclui um editor de código, e quando abrir um arquivo na IDE a partir do menu Arquivos, você estará automaticamente usando este editor de código.
+> 
+> Nota: Você pode ter realizado essa etapa no [Capítulo de Instalação](../installation/README.md). Em caso positivo, é possível pular direto para o próximo capítulo!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/pt-BR/code_editor/instructions.md b/pt-BR/code_editor/instructions.md
new file mode 100644
index 00000000000..5ae90633ae8
--- /dev/null
+++ b/pt-BR/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Existem muitos editores de código diferentes e escolher um trata-se essencialmente de preferência pessoal. A maioria dos programadores de Python usa os complexos, mas extremamente poderosos IDEs (Integrated Development Environments, ou, em português, Ambientes de Desenvolvimento Integrado), tais como o PyCharm. Para um iniciante, entretanto, estas IDEs não são muito adequadas; nossas recomendações são igualmente poderosas, mas bem mais simples.
+
+Nossas sugestões estão logo abaixo, mas sinta-se livre para perguntar à sua monitora quais são suas preferências - será mais fácil escolher com a ajuda dela.
+
+## Visual Studio Code
+
+O Visual Studio Code é um editor de código desenvolvido pela Microsoft para Windows, Linux e macOS. Inclui suporte para depuração, controle Git incorporado, destaque de sintaxe, conclusão de código inteligente, snippets e reação de código.
+
+[Baixe-o aqui](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit é um editor open-source, gratuito, disponível para todos os sistemas operacionais.
+
+[Baixe-o aqui](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+O Sublime Text é um editor muito popular. Ele tem um período de avaliação gratuito e está disponível para vários sistemas operacionais.
+
+[Baixe-o aqui](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom é outro editor popular. É gratuito, aberto e disponível para Windows, OS X e Linux. Atom é desenvolvido por [GitHub](https://github.com/).
+
+[Baixe-o aqui](https://atom.io/)
+
+## Por que estamos instalando um editor de código?
+
+Você deve estar se perguntando porque estamos instalando esse software editor de código específico ao invés de usar algo como Word ou Bloco de Notas.
+
+A primeira razão é que o código precisa estar em **texto puro, sem formatação**, e programas como o Word e o Textedit não produzem texto puro de fato. Eles produzem texto rico (com fontes e formatação), usando formatos personalizados, como [RTF](https://en.wikipedia.org/wiki/Rich_Text_Format) (Rich Text Format, ou Formato de Texto Rico, em português).
+
+A segunda razão é que editores de código são especializados em edição de código, então eles possuem funcionalidades úteis, como destacar o código com cores de acordo com seu significado ou fechar aspas automaticamente.
+
+Veremos tudo isso em ação mais pra frente. Logo, logo, seu bom e velho editor de código será uma de suas ferramentas preferidas. :)
\ No newline at end of file
diff --git a/pt-BR/css/README.md b/pt-BR/css/README.md
new file mode 100644
index 00000000000..65b78ca0222
--- /dev/null
+++ b/pt-BR/css/README.md
@@ -0,0 +1,330 @@
+# CSS - deixe tudo mais bonito!
+
+Nosso blog ainda está um pouco feio, né? Está na hora de deixar ele mais bonitinho! Para isso, nós usaremos o CSS.
+
+## O que é CSS?
+
+Cascading Style Sheets (CSS - Folhas de Estilo em Cascata, em português) é uma linguagem utilizada para descrever o visual e a formatação de um website escrito numa linguagem de marcação (como HTML). Considere como uma maquiagem para a nossa página web. :)
+
+Mas não queremos começar do zero de novo, né? Mais uma vez, usaremos algo que outros programadores lançaram na Internet de graça. Você sabe, reinventar a roda não é divertido.
+
+## Vamos usar o Bootstrap!
+
+Bootstrap é um dos frameworks de HTML e CSS mais populares para desenvolver websites mais bonitinhos: https://getbootstrap.com/
+
+Foi escrito por programadores que já trabalharam no Twitter e agora é desenvolvido por voluntários de todo o mundo!
+
+## Instalar o Bootstrap
+
+Para instalar o Bootstrap, abra o arquivo `.html` no seu editor de código e adicione o trecho abaixo à seção `<head>`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Isso não adiciona nenhum arquivo ao seu projeto, apenas aponta para arquivos que existem na Internet. Então vá em frente, abra seu website e atualize a página. Aqui está!
+
+![Figura 14.1](images/bootstrap1.png)
+
+Já está mais bonita!
+
+## Arquivos estáticos no Django
+
+Finalmente, vamos dar uma olhada mais de perto nessas coisas que chamamos de **arquivos estáticos**. Arquivos estáticos são todos os seus CSS e imagens. Seu conteúdo não depende do contexto de requisição e será o mesmo para todos os usuários.
+
+### Onde colocar os arquivos estáticos para o Django
+
+O Django já sabe onde encontrar os arquivos estáticos para o app "admin" pré-instalado. Agora só precisamos adicionar alguns arquivos estáticos para o nosso próprio app, `blog`.
+
+Fazemos isso criando uma pasta chamada `static` dentro da aplicação blog:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+O Django vai encontrar automaticamente quaisquer pastas chamadas "static" dentro de todas as pastas dos seus apps. Então ele será capaz de usar seu conteúdo como arquivos estáticos.
+
+## Seu primeiro arquivo CSS!
+
+Vamos criar um arquivo CSS agora, para adicionar seu próprio estilo à sua página web. Crie um novo diretório chamado `css` dentro de seu diretório `static`. Em seguida, crie um novo arquivo chamado `blog.css` dentro do diretório `css`. Pronta?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Hora de escrever um pouco de CSS! Abra o arquivo `blog/static/css/blog.css` no seu editor de código.
+
+Nós não vamos nos aprofundar muito no aprendizado do CSS aqui. No final desta página há uma recomendação para um curso gratuito de CSS se você quiser aprender mais.
+
+Mas vamos fazer pelo menos um pouco. Vamos mudar a cor do nosso cabeçalho? Para entender as cores, os computadores usam códigos especiais. Esses códigos começam com `#` e são seguidos de 6 letras (A-F) e números (0-9). Por exemplo, o código para o azul é `#0000FF`. Você pode encontrar os códigos de diversas cores aqui: http://www.colorpicker.com/. Você pode também usar [cores predefinidas](http://www.w3schools.com/colors/colors_names.asp), como `red` e `green`.
+
+Em seu arquivo `blog/static/css/blog.css`, adicione o seguinte código:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` é um seletor CSS. Isto significa que estamos aplicando nossos estilos a qualquer elemento `um` dentro de um elemento `h1`; o seletor `h2 a` faz a mesma coisa com elementos `h2`. Então quando tivermos algo como um `<h1><a href="">link</a></h1>`, o estilo `h1 a` será aplicado. Neste caso, estamos dizendo para mudar sua cor para `#C25100`, que é um laranja escuro. Ou você pode colocar sua própria cor, mas certifique-se de que ela tenha um bom contraste com um fundo branco!
+
+Em um arquivo CSS, nós determinamos estilos para elementos do arquivo HTML. A primeira maneira de identificar elementos é usando seus nomes. Você pode se lembrar desses nomes porque são a mesma coisa que as tags da seção HTML. `a`, `h1` e `body` são exemplos de nomes de elementos. Também identificamos elementos pelo atributo `class` ou pelo atributo `id`. Class e id são nomes que você mesma dá ao elemento. Classes definem grupos de elementos e ids apontam para elementos específicos. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Você pode ler mais sobre [Seletores CSS no w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+Nós também precisamos dizer ao nosso template HTML que adicionamos algum CSS. Abra o arquivo `blog/templates/blog/post_list.html` no editor de código e adicione esta linha bem no começo dele:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Estamos apenas carregando arquivos estáticos aqui. :) Adicione a seguinte linha entre as tags `<head>` e `</head>` e depois dos links para os arquivos CSS do Bootstrap:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+O navegador lê os arquivos na ordem em que são apresentados, então precisamos ter certeza de que eles estão no lugar certo. Do contrário, o código no nosso arquivo poderia ser sobrescrito pelo código dos arquivos do Bootstrap. Acabamos de dizer ao nosso template onde está o nosso arquivo CSS.
+
+Agora, seu arquivo deve estar assim:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, salve o arquivo e atualize o site!
+
+![Figura 14.2](images/color2.png)
+
+Bom trabalho! Que tal a gente dar um pouco de espaço ao nosso site e aumentar a margem do lado esquerdo? Vamos tentar!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Adicione isto ao seu CSS, salve o arquivo e veja como funciona!
+
+![Figura 14.3](images/margin2.png)
+
+E que tal customizar a fonte no nosso cabeçalho? Cole o seguinte na seção `<head>` do arquivo `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Assim como antes, cheque a ordem e a posição antes do link para `blog/static/css/blog.css`. Esta linha importará do Google Fonts (https://www.google.com/fonts) uma fonte chamada *Lobster*.
+
+Encontre o bloco de declaração `h1 a` (o código entre chaves `{` e `}`) no arquivo CSS `blog/static/css/blog.css`. Agora, adicione a linha `font-family: 'Lobster';` entre as chaves e atualize a página:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figura 14.3](images/font.png)
+
+Incrível!
+
+Como mencionado acima, o CSS tem um conceito de classes. Essas classes permitem que você nomeie uma parte do código HTML e aplique estilos apenas a esta parte sem afetar nenhuma outra. Isto pode ser super útil! Talvez você tenha duas divs que estão fazendo coisas diferentes (como o seu cabeçalho e seu post). Uma classe pode ajudá-la a diferenciá-los.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Agora, adicionaremos blocos de declaração a seletores diferentes. Seletores começando com `.` se referem às classes. Existem vários tutoriais e explicações excelentes sobre CSS na Web que podem te ajudar a entender melhor o código a seguir. Por enquanto, copie e cole esse código em seu arquivo `mysite/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Agora inclua declarações de classes no código HTML que exibe os posts. No arquivo blog/templates/blog/post_list. html, substitua isto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+por isto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Salve esses arquivos e atualize seu site.
+
+![Figura 14.4](images/final.png)
+
+Uau! Está lindo, né? Olhe para o código que acabamos de colar para encontrar os locais onde adicionamos classes no HTML e as usamos no CSS. Onde você faria uma mudança se você quisesse a data na cor turquesa?
+
+Não tenha medo de mexer um pouco com esse CSS e tentar mudar algumas coisas. Brincar com o CSS pode ajudá-la a entender o que diferentes coisas estão fazendo. Se quebrar algo, não se preocupe - você sempre pode desfazer!
+
+Nós realmente recomendamos os cursos gratuitos "HTML Básico" e "CSS Básico" do [freeCodeCamp](https://learn.freecodecamp.org/) They can help you learn all about making your websites prettier with HTML and CSS.
+
+Pronta para o próximo capítulo?! :)
\ No newline at end of file
diff --git a/pt-BR/deploy/README.md b/pt-BR/deploy/README.md
new file mode 100644
index 00000000000..475ab0cbb00
--- /dev/null
+++ b/pt-BR/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Observação:** Pode ser um pouco difícil chegar ao final desse capítulo. Persista e termine-o; o deploy é uma parte importante do processo de desenvolvimento de um website. Colocar o seu site no ar é um pouco mais complicado, então esse capítulo está no meio do tutorial para que sua monitora possa lhe ajudar nessa tarefa. Isto significa que você pode terminar o tutorial por conta própria se o tempo acabar.
+
+Até agora, seu site só estava disponível no seu computador. Agora você aprenderá como implantá-lo (fazer o 'deploy')! O deploy é o processo de publicação da sua aplicação na Internet de forma que as pessoas possam, finalmente, vê-la. :)
+
+Como você aprendeu, um website precisa estar em um servidor. Existem vários provedores de servidores na internet, nós vamos usar o [PythonAnywhere](https://www.pythonanywhere.com/). O PythonAnywhere é gratuito para pequenas aplicações que não recebem muitos visitantes, então vai ser suficiente para você por enquanto.
+
+O outro serviço externo que usaremos é [GitHub](https://www.github.com), que é um serviço de hospedagem de código. Existem outros, mas atualmente quase todos os programadores possuem uma conta no GitHub e agora, você também terá a sua!
+
+Estes três lugares serão importantes para você. Seu computador local é o lugar onde você fará o desenvolvimento e testes. Quando estiver satisfeita com as mudanças, você colocará uma cópia de seu programa no GitHub. Seu site estará na PythonAnywhere e você irá atualizá-lo ao subir uma nova cópia do seu código para o GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Começando o seu repositório no Git
+
+O Git controla as alterações em um determinado conjunto de arquivos no que chamamos de repositório de código (ou "repo"). Vamos criar um para o nosso projeto. Abra o seu console e execute esses comandos no diretório `djangogirls`:
+
+> **Observação:** Verifique o seu diretório atual com um `pwd` (OSX/Linux) ou o comando `cd` (Windows) antes de inicializar o repositório. Você deve estar na pasta `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Seu Nome"
+    $ git config --global user.email voce@exemplo.com
+    
+
+Só é necessário iniciar o repositório Git uma vez por projeto (e você não vai precisar preencher seu nome de usuário e e-mail nunca mais).
+
+O Git irá controlar as alterações em todos os arquivos e pastas neste diretório, mas existem alguns arquivos que queremos que ele ignore. Fazemos isso através da criação de um arquivo chamado `.gitignore` no diretório base. Abra seu editor e crie um novo arquivo com o seguinte conteúdo:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+E salve-o como `.gitignore` na pasta "djangogirls".
+
+> **Observação:** O ponto no início do nome do arquivo é importante! Se você estiver tendo alguma dificuldade em criá-lo (Macs, por exemplo, não gostam quando você tenta criar arquivos que começam com um ponto por meio do Finder), use a função "Salvar Como..." no seu editor; não tem como errar. E certifique-se de não adicionar *.txt *, *.py *, ou qualquer outra extensão ao nome do arquivo - ele só será reconhecido pelo Git se o nome for apenas *.gitignore *. Linux e MacOS consideram arquivos em que o nome começa com `.` (como o `.gitignore`) como ocultos e o comando `ls` não mostrará esses arquivos Ao invés disso use `ls-a` para ver o arquivo `.gitignore`.
+> 
+> **Observação:** Um dos arquivos especificados no seu `.gitignore` é o `db.sqlite3`. Este arquivo é o seu banco de dados local, onde todos os seus posts ficarão guardados. Seguiremos a prática padrão de programação na web, o que significa que usaremos bancos de dados separados para o seu site de teste local e seu site ao vivo no PythonAnywhere. Esse banco poderia ser SQLite, como na sua máquina de desenvolvimento, mas normalmente você utilizará um chamado MySQL, que consegue lidar com bem mais visitantes ao site do que o SQLite. De qualquer forma, ignorando o seu banco de dados SQLite para a cópia do GitHub, todos os posts criados até agora vão estar disponíveis apenas no seu ambiente local, e você vai ter que criá-los novamente em produção. Pense no seu banco de dados local como um bom parque de diversões onde você pode testar coisas diferentes e não ter medo de apagar os posts reais do seu blog.
+
+É uma boa idéia usar um comando `git status` antes de `git add` ou sempre que você não tiver certeza do que mudou. Isso evitará quaisquer surpresas, como os arquivos errados serem adicionados ou "commitados". O comando `git status` mostra informações sobre arquivos que não estão sendo controlados, arquivos que foram modificados ou preparados (staged), o status do branch, e muito mais. A saída do comando deve ser parecida com o seguinte:
+
+{% filename %}linha de comando{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+E finalmente salvamos nossas alterações. Vá para o seu console e execute estes comandos:
+
+{% filename %}linha de comando{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Subindo o seu código para o GitHub
+
+Vá para [GitHub.com](https://www.github.com) e cadastre uma conta de usuário. (Se você já fez isso em preparação para a oficina, ótimo!) Certifique-se de lembrar da sua senha (adicione-a ao seu gerenciador de senhas, se usar um).
+
+Em seguida, crie um novo repositório chamado "my-first-blog". Deixe a caixa "Initialize with a README" desmarcada, deixe a opção do .gitignore em branco (nós já fizemos isso manualmente) e deixe a licença como "None".
+
+![](images/new_github_repo.png)
+
+> **Observação:** O nome `my-first-blog` é importante - você poderia escolher qualquer outra coisa, mas ele vai aparecer várias vezes nas instruções abaixo, e você teria que substituir todas as vezes. É mais fácil simplesmente manter o nome `my-first-blog`.
+
+Na próxima tela, você verá a URL de clonagem do seu repositório, que utilizará em alguns dos comandos a seguir:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Agora precisamos conectar o repositório Git no seu computador com o que existe no GitHub.
+
+Digite o seguinte no seu terminal (substitua `<your-github-username>` pelo nome de usuário que você escolheu quando criou sua conta no GitHub, mas sem os sinais de menor e maior):
+
+{% filename %}linha de comando{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Quando você enviar para o GitHub, seu nome de usuário e senha do GitHub serão solicitados (na própria janela de linha de comando ou em uma janela pop-up), e depois de inserir suas credenciais, você deverá ver algo assim:
+
+{% filename %}linha de comando{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+O seu código agora está no GitHub. Vai lá ver! Você perceberá que ele esta em ótima companhia - o [Django](https://github.com/django/django), o [Tutorial Django Girls](https://github.com/DjangoGirls/tutorial) e vários outros incríveis projetos open source também hospedam seu código no GitHub. :)
+
+# Configurando o seu blog no PythonAnywhere
+
+## Crie uma conta no PythonAnywhere
+
+> **Observação:** Você talvez já tenha criado uma conta no PythonAnywhere durante os passos de instalação. Nesse caso, não precisa criar outra.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configurando o seu site no PythonAnywhere
+
+Navegue para a [Dashboard do PythonAnywhere](https://www.pythonanywhere.com/) clicando no logo e escolha a opção de iniciar um console "Bash" -- essa é a versão do PythonAnywhere da linha de comando, igual à que existe no seu computador.
+
+![A seção 'New Console' na interface web do PythonAnywhere, com o botão para abrir o 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Observação:** O PythonAnywhere é baseado em Linux, então se você estiver no Windows, o console terá uma cara um pouco diferente do que aparece no seu computador.
+
+Fazer o deploy de uma aplicação web no PythonAnywhere envolve baixar o seu código do GitHub e configurar o PythonAnywhere para reconhecê-lo e começar a servi-lo como uma aplicacão web. Existem formas manuais de fazer isso, mas o PythonAnywhere fornece uma ferramenta que vai fazer tudo pra você. Vamos instalar ela primeiro:
+
+{% filename %}linha de comando do PythonAnywhere{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+Isso deve mostrar na tela coisas como `Collecting pythonanywhere`, e depois de algum tempo finalizar com uma linha dizendo `Successfully installed (...) pythonanywhere (...)`.
+
+Agora vamos executar a ferramenta para configurar a nossa aplicação a partir do GitHub automaticamente. Digite os seguintes comandos no console do PythonAnywhere (não se esqueça de usar o seu nome de usuário do GitHub ao invés de `<your-github-username>`):
+
+{% filename %}linha de comando do PythonAnywhere{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+Enquanto assiste a execução da ferramenta, você pode ver o que ela está fazendo:
+
+- Baixando o seu código do GitHub;
+- Criando um virtualenv no PythonAnywhere, igual ao que existe no seu computador
+- Atualizando o seu arquivo de configuração com algumas configurações sobre o deploy;
+- Criando um banco de dados no PythonAnywhere usando o comando `manage.py migrate`;
+- Criando os seus arquivos estáticos (nós aprenderemos sobre eles mais tarde)
+- E configurando o PythonAnywhere para servir a sua web app através da sua API.
+
+No PythonAnywhere, todos esses passos são automatizados, mas são os mesmos que você executaria ao utilizar qualquer outro provedor.
+
+Agora, é importante notar que o seu banco de dados no PythonAnywhere é completamente separado do banco de dados no seu computador — isso significa que eles têm posts e contas de admin diferentes. Por causa disso, da mesma forma que fizemos nos nossos computadores, precisamos iniciar a conta de admin com o comando *createsuperuser*. O PythonAnywhere já ativou o seu virtualenv automaticamente, então tudo o que você precisa fazer é executar o comando:
+
+{% filename %}linha de comando do PythonAnywhere{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Digite as informações sobre a sua conta de admin. É mais fácil usar as mesmos que usou no seu computador pra evitar qualquer confusão, a menos que você queira criar uma senha mais segura para a conta no PythonAnywhere.
+
+Agora, se quiser, você pode dar uma olhada no seu código no PythonAnywhere usando `ls`:
+
+{% filename %}linha de comando do PythonAnywhere{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+Você também pode visitar a aba "Files" e dar uma olhada usando o gerenciador de arquivos do PythonAnywhere. (Da página do console, você pode navegar para outras páginas do PythonAnywhere utilizando o botão menu no canto superior direito. Quando você estiver em uma dessas páginas, outros links serão exibidos perto do topo.)
+
+## Estamos no ar!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Observação:** Este é um tutorial para iniciantes e ao fazer o deploy do site desta forma, nós tomamos alguns atalhos que não são ideais do ponto de vista de segurança. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Dicas de debugging
+
+Se você vir um erro ao rodar o script `pa_autoconfigure_django.py`, aqui vão algumas causas comuns:
+
+- Esquecer de criar um token de API do PythonAnywhere.
+- Digitar a URL do seu GitHub incorretamente.
+- Se você vir um erro dizendo *"Could not find your settings.py"* (settings.py não encontrado), você provavelmente não adicionou todos os seus arquivos ao Git e/ou você não fez o push deles para o GitHub. Dê uma revisada na sessão sobre Git acima
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+Se você vir um erro ao visitar o seu site, o primeiro lugar para procurar informações sobre ele é o **log de erros**. Você vai encontrar um link para o log na aba [Web](https://www.pythonanywhere.com/web_app_setup/) do PythonAnywhere. Verifique se há alguma mensagem de erro no log; as mais recentes estarão no final.
+
+Há também algumas [dicas de debugging no site de ajuda da PythonAnywhere](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+E lembre-se, a sua monitora está aí pra ajudar!
+
+# Visite o seu site!
+
+A página padrão no seu site deverá dizer "It worked!" ("Funcionou!"), igual ao seu ambiente local. Adicione `/admin` ao final da URL e você será levada ao site de administração. Faça o login com o nome de usuário e a senha, e você verá que pode adicionar novas postagens no servidor -- lembre-se de que as postagens do banco de dados de teste local não foram enviadas para o seu blog no ar.
+
+Depois de criar alguns posts, você pode voltar para o seu ambiente local (não o PythonAnywhere). Daqui pra frente você deve trabalhar no seu ambiente local para fazer alterações. Este workflow é comum no desenvolvimento web – fazer alteracões locais, subir essas alteracões pro GitHub, e baixar essas alterações para o seu servidor web de produção. Isto permite que você desenvolva e experimente sem quebrar o seu site que está no ar. Bem legal, né?
+
+Você merece *MUITOS* parabéns! Deploys em servidores são uma das partes mais complicadas do desenvolvimento web e não é incomum levar vários dias até conseguir fazer com que isso funcione. Mas você já tem seu site publicado na internet!
\ No newline at end of file
diff --git a/pt-BR/deploy/install_git.md b/pt-BR/deploy/install_git.md
new file mode 100644
index 00000000000..3c35b937d27
--- /dev/null
+++ b/pt-BR/deploy/install_git.md
@@ -0,0 +1,52 @@
+O Git é um "sistema de controle de versão" usado por muitos programadores. Este software pode acompanhar mudanças em arquivos ao longo do tempo para que você possa recuperar versões específicas mais tarde. É parecido com o recurso "Controlar Alterações" dos processadores de texto (e.x Microsoft Word ou Libre Writer), mas muito mais poderoso.
+
+## Instalando o Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Você pode baixar o Git em [git-scm.com](https://git-scm.com/). Você pode clicar "próximo" em todas as etapas seguintes, exceto em duas delas: na etapa onde se pede para que escolha o seu editor, você deve escolher Nano, e na etapa "Ajustando o seu ambiente PATH", escolha "Usar Git e ferramentas opcionais Unix para Prompt de comando Windows" (a opção de baixo). Fora isso, as configurações padrão estão ótimas. "Checkout Windows-style, commit Unix-style line endings" está bom.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Baixe o Git em [git-scm.com](https://git-scm.com/) e siga as instruções.
+
+> **Observação:** Se estiver rodando o OS X 10.6, 10.7, ou 10.8, você precisará instalar essa versão do git: [Instalado Git para o OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/pt-BR/deploy/signup_pythonanywhere.md b/pt-BR/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..64c2a821bf5
--- /dev/null
+++ b/pt-BR/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere é um serviço para execução de código Python em servidores "na nuvem". Nós vamos utilizá-lo para hospedar nosso site e deixá-lo no ar na internet.
+
+Vamos hospedar o blog que estamos construindo no PythonAnywhere. Cadastre uma conta "Begginer" (de iniciante) no PythonAnywhere (o pacote gratuito é suficiente, você não precisa de um cartão de crédito).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![Página do PythonAnywhere mostrando o botão para criar a conta "Beginner" (iniciante)](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> ** Observação ** Quando escolher seu nome de usuário no PythonAnywhere, lembre que a URL do blog será `seunomedeusuário.pythonanywhere.com `, então use algo como o seu apelido ou um nome que descreva o assunto do blog. Além disso, certifique-se de lembrar sua senha (adicione-a ao seu gerenciador de senhas, se você usar um).
+
+## Criando um token de API do PythonAnywhere
+
+Você só precisará fazer isso uma vez. Depois de se registrar no PythonAnywhere, você será levada ao seu painel de controle. Encontre o link para a página de "Account" (conta, em português) próximo ao topo no lado direito:
+
+![Link para a conta no topo direito na página](../deploy/images/pythonanywhere_account.png)
+
+em seguida, selecione a guia chamada "API Token" e aperte o botão que diz "Create new API token" (criar novo token API").
+
+![Aba de token da API na página da conta](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/pt-BR/django/README.md b/pt-BR/django/README.md
new file mode 100644
index 00000000000..d1253c5e18a
--- /dev/null
+++ b/pt-BR/django/README.md
@@ -0,0 +1,27 @@
+# O que é Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) é um framework para aplicações web gratuito e de código aberto, escrito em Python. Um web framework é um conjunto de componentes que ajuda você a desenvolver sites de forma mais rápida e fácil.
+
+Quando você está construindo um site, sempre precisa de um conjunto similar de componentes: uma maneira de lidar com a autenticação do usuário (inscrever-se, fazer login, fazer logout), um painel de gerenciamento para o seu site, formulários, uma forma de upload de arquivos, etc.
+
+Felizmente, outras pessoas perceberam muito tempo atrás que desenvolvedores web enfrentam problemas similares quando estão construindo um novo site, então elas se juntaram e criaram frameworks (Django é um deles) que te dão componentes já prontos para usar.
+
+Frameworks existem para evitar que você tenha que reinventar a roda e para ajudar a aliviar parte do trabalho extra quando você está construindo um novo site.
+
+## Por que você precisa de um framework?
+
+Para entender para quê o Django de fato serve, precisamos olhar os servidores mais de perto. Primeiramente, o servidor precisa saber que você quer que ele te sirva uma página web.
+
+Imagine uma caixa de correio (porta) que monitora cartas recebidas (requisição). Isso é feito por um servidor web. O servidor web lê a carta e então envia a resposta com uma página web. Mas quando quer enviar alguma coisa, você precisa ter um conteúdo. O Django vai te ajudar a criar esse conteúdo.
+
+## O que acontece quando alguém solicita um site do seu servidor?
+
+Quando uma requisição chega a um servidor web, ela é passada para o Django, que tenta entender o que está sendo requisitado de fato. Primeiro, ele pega um endereço de página web e tenta descobrir o que fazer. Isso parte é feito pelo **urlresolver** do Django (note que um endereço de website é chamado de URL - Uniform Resource Locator -- Localizador de Recursos Uniforme, em tradução livre --, então o nome *urlresolver* faz sentido). Ele não é muito inteligente - ele pega uma lista de padrões e tenta achar em qual deles a URL se encaixa. O Django checa os padrões de cima pra baixo, e se algum se encaixa, ele passa a requisição para a função associada (que é chamada de *view*).
+
+Imagine uma funcionária dos Correios com uma carta. Ela está andando pela rua e compara cada número de casa com o que está na carta. Se os números forem correspondentes, ela entrega a carta lá. É assim que funciona o urlresolver!
+
+Todas as coisas interessantes são feitas dentro da função *view*: podemos dar uma olhada no banco de dados para procurar algumas informações. O usuário solicitou alguma mudança nos dados? Como uma carta dizendo "Por favor mude a descrição do meu emprego." A *view* pode checar se você tem permissão para fazer isso, e então atualizar a descrição do emprego e enviar de volta a mensagem: "Pronto!" Então a *view* gera uma resposta e o Django pode enviá-la para o navegador web do usuário.
+
+A descrição acima é um pouco simplificada, mas você não precisa saber todos os detalhes técnicos ainda. Uma ideia geral já é o suficiente.
+
+Então, ao invés de mergulharmos fundo nos detalhes, vamos começar criando algo com o Django e ir aprendendo as partes importantes durante o caminho!
\ No newline at end of file
diff --git a/pt-BR/django_admin/README.md b/pt-BR/django_admin/README.md
new file mode 100644
index 00000000000..4f5173021a0
--- /dev/null
+++ b/pt-BR/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django Admin
+
+Para adicionar, editar e deletar os posts que acabamos de modelar, nós usaremos o admin do Django.
+
+Vamos abrir o arquivo `blog/admin.py` no editor de código e substituir o conteúdo pelo seguinte:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Como você pode ver, nós importamos (incluímos) o modelo Post definido no capítulo anterior. Para tornar nosso modelo visível na página de administração, precisamos registrá-lo com `admin.site.register(Post)`.
+
+OK, hora de olhar para o nosso modelo de Post. Lembre-se de executar `python manage.py runserver` no console para iniciar o servidor web. Vá para o seu navegador e digite o endereço http://127.0.0.1:8000/admin/. Você verá uma página de login como essa:
+
+![Página de login](images/login_page2.png)
+
+Para fazer login, você precisa criar um *superusuário (superuser)* - uma conta de usuário que pode controlar tudo no site. Volte à linha de comando, digite `python manage.py createsuperuser` e aperte Enter.
+
+> Lembre-se: para escrever novos comandos enquanto o servidor web estiver rodando, abra uma nova janela do terminal e ative seu virtualenv. Nós revisamos como escrever novos comandos no capítulo **Seu primeiro projeto Django!**, na seção **Iniciando o servidor web**.
+
+{% filename %}Mac OS X ou Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Quando for solicitado, insira seu nome de usuário (letras minúsculas, sem espaços), e-mail e senha. **Não se preocupe por não conseguir ver a senha que está digitando - é assim mesmo.** Digite a senha e aperte a tecla `enter` para continuar. A saída deve parecer com isso (onde o nome de usuário e o email devem ser os seus):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Volte ao seu navegador. Faça login com as credenciais de superusuário que você escolheu; você deverá ver o painel de controle de administração do Django.
+
+![Django Admin](images/django_admin3.png)
+
+Vá para as postagens e experimente um pouco com elas. Adicione cinco ou seis postagens. Não se preocupe com o conteúdo -- ele só é visível para você no seu computador local -- você pode copiar e colar algum texto deste tutorial para economizar tempo. :)
+
+Certifique-se de que pelo menos duas ou três postagens (mas não todas) têm a data de publicação definida. Isso será útil depois.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Esse provavelmente é um bom momento para pegar um café (ou chá) ou algo para comer para recuperar as energias. Você criou seu primeiro modelo em Django e merece uma pausa!
\ No newline at end of file
diff --git a/pt-BR/django_forms/README.md b/pt-BR/django_forms/README.md
new file mode 100644
index 00000000000..60ad68404aa
--- /dev/null
+++ b/pt-BR/django_forms/README.md
@@ -0,0 +1,479 @@
+# Formulários do Django
+
+Por último, queremos uma forma legal de adicionar e editar as postagens do nosso blog. A `ferramenta de administração` do Django é legal, mas é um pouco difícil de personalizar e de deixar mais bonita. Com `formulários`, temos poder absoluto sobre nossa interface - podemos fazer quase tudo que pudermos imaginar!
+
+Uma coisa legal do Django é que podemos tanto criar um formulário do zero, como criar um `ModelForm` que salva o resultado do formulário em um determinado modelo.
+
+É exatamente isso que queremos fazer: criar um formulário para o nosso modelo `Post`.
+
+Assim como todas as partes importantes do Django, forms têm seu próprio arquivo: `forms.py`.
+
+Precisamos criar um arquivo com este nome dentro da pasta `blog`.
+
+    blog
+       └── forms.py
+    
+
+Agora vamos abri-lo no editor de código e digitar o seguinte:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Primeiro, precisamos importar o módulo de formulários do Django (*from django import forms*) e, obviamente, o nosso modelo *Post* (*from .models import Post*).
+
+`PostForm`, como você já deve suspeitar, é o nome do nosso formulário. Precisamos dizer ao Django que esse form é um `ModelForm` (pro Django fazer algumas mágicas para nós) – `forms.ModelForm` é o responsável por essa parte.
+
+Em seguida, temos a `class Meta` em que dizemos ao Django qual modelo deverá ser usado para criar este formulário (`model = Post`).
+
+Por fim, podemos dizer quais campos devem entrar no nosso formulário. Neste cenário, queremos que apenas o `title` e o `text` sejam expostos -- `author` deve ser a pessoa que está logada no sistema (nesse caso, você!) e `created_date` deve ser configurado automaticamente quando criamos um post (no código), correto?
+
+E é isso! Tudo o que precisamos fazer agora é usar o formulário em uma *view* e mostrá-lo em um template.
+
+Novamente, criaremos um link para a página, uma URL, uma view e um template.
+
+## Link para a página com o formulário
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+Vamos abrir o arquivo `blog/urls.py` no editor de código e adicionar a linha:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+O código final deve se parecer com isso:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## View post_new
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* Temos que exibir o formulário. Podemos fazer isso com (por exemplo) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Precisamos de um botão `Salvar`. Fazemos isso com um botão HTML: `<button type="submit">Save</button>`.
+* E finalmente, depois de abrir a tag `<form ...>`, precisamos adicionar {% raw %}`{% csrf_token %}`{% endraw %}. Isso é muito importante, pois é isso que torna o nosso formulário seguro! Se você esquecer esta parte, o Django vai reclamar quando você tentar salvar o formulário:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Salvando o formulário
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+     post = form.save(commit=False)
+     post.author = request.user
+     post.published_date = timezone.now()
+     post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+     if request.method == "POST":
+         form = PostForm(request.POST)
+         if form.is_valid():
+             post = form.save(commit=False)
+             post.author = request.user
+             post.published_date = timezone.now()
+             post.save()
+             return redirect('post_detail', pk=post.pk)
+     else:
+         form = PostForm()
+     return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Validação de formulários
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Editando o formulário
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+     post = get_object_or_404(Post, pk=pk)
+     if request.method == "POST":
+         form = PostForm(request.POST, instance=post)
+         if form.is_valid():
+             post = form.save(commit=False)
+             post.author = request.user
+             post.published_date = timezone.now()
+             post.save()
+             return redirect('post_detail', pk=post.pk)
+     else:
+         form = PostForm(instance=post)
+     return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Segurança
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Mais uma coisa: hora de implantar!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* Primeiro, faça o commit do seu novo código e dê o comando push para colocá-lo no Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Então, em um [console Bash do PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finalmente, vá para a [página "Web"](https://www.pythonanywhere.com/web_app_setup/) (use o botão de menu no canto superior direito do console) e pressione **Recarregar**. Atualize seu blog https://subdominio.pythonanywhere.com para ver as mudanças.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/pt-BR/django_installation/README.md b/pt-BR/django_installation/README.md
new file mode 100644
index 00000000000..ea0e2b98897
--- /dev/null
+++ b/pt-BR/django_installation/README.md
@@ -0,0 +1,7 @@
+# Instalação do Django
+
+> **Observação:** Se você está usando um Chromebook, pule este capítulo e certifique-se de seguir as instruções para [ Configuração do Chromebook](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/pt-BR/django_installation/instructions.md b/pt-BR/django_installation/instructions.md
new file mode 100644
index 00000000000..6e429020862
--- /dev/null
+++ b/pt-BR/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Esta seção baseia-se em tutoriais da Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parte deste capítulo é baseada em [tutorial django-marcador](http://django-marcador.keimlink.de/) licenciado sob Creative Commons Attribution-ShareAlike 4.0 International License. O tutorial do django-marcador é protegido por direitos autorais por Markus Zapke-Gründemann et al.
+
+## Ambiente virtual
+
+Antes de instalar o Django, vamos instalar uma ferramenta muito útil para ajudar a manter o ambiente de trabalho no nosso computador organizado. Você pode pular esse passo, mas ele é altamente recomendado. Começar com a melhor instalação possível poupará você de muito trabalho no futuro!
+
+Vamos criar um **ambiente virtual** (também chamado um *virtualenv*). O virtualenv isolará seu código Python/Django em um ambiente organizado por projetos. Isso significa que as alterações que você fizer em um website não afetarão os outros projetos que você estiver desenvolvendo ao mesmo tempo. Legal, né?
+
+Tudo o que você precisa fazer é encontrar o diretório em que você quer criar o `virtualenv`; seu diretório Home, por exemplo. No Windows, pode aparecer como `C:\Users\Name` (onde `Nome` é seu usuário de login).
+
+> ** Observação:** No Windows, certifique-se de que esse diretório não contém palavras acentuadas ou caracteres especias; se o seu usuário contém caracteres acentuados, use um diretório diferente, por exemplo: ` C:\djangogirls`.
+
+Para este tutorial, usaremos um novo diretório `djangogirls` no seu diretório home:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls 
+    $ cd djangogirls
+    
+
+Vamos criar um virtualenv chamado `myvenv`. O formato geral desse comando é:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Para criar um novo `virtualenv`, você deve abrir o terminal e executar `python -m venv myvenv`. Deve ficar assim:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Onde `myvenv` é o nome do seu `virtualenv`. Você pode usar qualquer outro nome, mas sempre use minúsculas e não use espaços, acentos ou caracteres especiais. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Podemos criar um `virtualenv` no Linux ou no OS X executando `python3 -m venv myvenv`. Deve ficar assim:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` é o nome do seu `virtualenv`. Você pode usar qualquer outro nome, mas use sempre letras minúsculas e não use espaços entre as palavras. Também é uma boa ideia manter o nome curto pois você vai escrevê-lo muitas vezes!
+
+> **Observação:** Em algumas versões do Debian/Ubuntu, você pode receber o seguinte erro:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> Caso você receba esse erro, siga as instruções acima e instale o pacote `python3-venv`: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **Observação:** Em algumas versões do Debian/Ubuntu, iniciar o ambiente virtual com este comando gera o seguinte erro:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Para contornar esse problema, use o comando `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **Oservação:** Se você obtiver um erro como
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> no lugar do comando mostrado acima, execute esse:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Trabalhando com o virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Inicie o seu ambiente virtual executando:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. Neste caso, abra uma outra janela do Windows PowerShell com a opção de "Executar como Administrador". Assim, execute o comando abaixo antes de iniciar o seu ambiente virtual:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> A vantagem é que você não necessita trocar entre o editor do Windows e a interface command-line.
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Inicie o seu ambiente virtual executando:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Instalando pacotes com requisitos
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). Se sim, considere movê-lo para outro lugar sem espaços, acentos ou caracteres especiais (sugestão: `C:\djangogirls`). Crie um novo virtualenv no diretório recém-criado, exclua o mais velho e tente novamente executar o comando acima. (Mover o diretório de virtualenv não vai funcionar pois o virtualenv usa caminhos absolutos.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/pt-BR/django_models/README.md b/pt-BR/django_models/README.md
new file mode 100644
index 00000000000..2f1811711da
--- /dev/null
+++ b/pt-BR/django_models/README.md
@@ -0,0 +1,201 @@
+# Modelos do Django
+
+Queremos criar algo que armazene todos os posts em nosso blog. Mas para fazer isto, temos que falar um pouco sobre `objects`.
+
+## Objetos
+
+Existe um conceito em programação chamado `programação orientada a objetos`. A ideia é que ao invés de escrever tudo como uma sequência entediante de instruções de programação, possamos modelar as coisas e definir como elas interagem umas com as outras.
+
+Então o que é um objeto? É uma coleção de propriedades e ações. Isto pode parecer estranho, mas vamos mostrar um exemplo.
+
+Se quisermos modelar um gato, podemos criar um objeto `Gato` que possui propriedades como `cor`, `idade`, `humor` (como bom, mal ou sonolento ;)), e `dono` (que seria atribuído a um objeto de `Pessoa` – ou talvez, no caso de um gato de rua, essa propriedade seja vazia).
+
+`Gato` também realiza algumas ações: `ronronar`, `arranhar` ou `alimentar`-se (em que podemos dar ao gato alguma `ComidaDeGato`, que poderia ser um objeto separado com propriedades como `sabor`).
+
+    Gato
+    --------
+    cor
+    idade
+    temperamento
+    dono
+    ronronar()
+    arranhar()
+    alimentar(comida_de_gato)
+    
+
+    ComidaDeGato
+    ------------
+    sabor
+    
+
+A ideia básica é descrever coisas reais em código a partir de suas propriedades (chamadas de `atributos`) e ações (chamadas de `métodos`).
+
+Como vamos modelar as postagens do blog, então? Queremos construir um blog, certo?
+
+Para isto, precisamos responder as questões: O que é um post de blog? Que propriedades (atributos) ele deve ter?
+
+Bem, com certeza uma postagem precisa de um texto com seu conteúdo e um título, certo? Também seria legal saber quem a escreveu – então precisamos de um autor. Finalmente, queremos saber quando a postagem foi criada e publicada. Para ficar chique, vamos fazer em inglês.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Que tipo de ações podem ser feitas com uma postagem? Seria legal ter um `método` que publique a postagem, não é mesmo?
+
+Então, nós precisaremos de um método para publicar (`publish`).
+
+Como já sabemos o que queremos alcançar, podemos começar a modelar em Django!
+
+## Modelos do Django
+
+Sabendo o que um objeto é, criamos um modelo no Django para a postagem do blog.
+
+Um modelo no Django é um tipo especial de objeto -- ele é salvo em um `banco de dados`. Um banco de dados é uma coleção de dados. Ele é um local em que você vai salvar dados sobre usuários, suas postagens, etc. Usaremos um banco de dados chamado SQLite para armazenar as nossas informações. Este é o banco de dados padrão do Django -- e ele será suficiente neste primeiro momento.
+
+Você pode pensar em um modelo de banco de dados como uma planilha com colunas (campos) e linhas (dados).
+
+### Criando uma aplicação
+
+Para manter tudo arrumado, vamos criar uma aplicação separada dentro do nosso projeto. É muito bom ter tudo organizado desde o início. Para criar uma aplicação, precisamos executar o seguinte comando no prompt (a partir do diretório `djangogirls` onde está o arquivo `manage.py`):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Você vai notar que um novo diretório `blog` foi criado e que ele contém vários arquivos. Algo como a lista abaixo:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+Depois de criar uma aplicação, também precisamos dizer ao Django que ele deve usá-la. Fazemos isso no arquivo `mysite/settings.py` -- abra-o no seu editor de código. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. O resultado final ficará assim:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Criando um modelo de postagem para o nosso blog
+
+No arquivo `blog/models.py` definimos todos os objetos chamados `Modelos` -- este é um lugar em que vamos definir nossa postagem do blog.
+
+Vamos abrir `blog/models.py` no editor de código, apagar tudo dele e escrever o seguinte código:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Certifique-se de que usou dois caracteres de sublinhado (`_`) em cada lado de `str`. Esta convenção é utilizada frequentemente em Python e, muitas vezes, a chamamos de "dunder" (vem da expressão em inglês "double-underscore" - sublinhado duplo em português).
+
+Parece assustador, né? Mas não se preocupe, vamos explicar o que essas linhas significam!
+
+Todas as linhas começando com `from` ou `import` são linhas que adicionam pedaços de outros arquivos. Então ao invés de copiar e colar as mesmas coisas em cada arquivo, podemos incluir algumas partes com `from... import ...`.
+
+`class Post(models.Model):` - esta linha define o nosso modelo (é um `objeto`).
+
+- `class` é uma palavra-chave especial que indica que estamos definindo um objeto.
+- `Post` é o nome do nosso modelo. Nós podemos dar um nome diferente (mas precisamos evitar caracteres especiais e espaços em branco). Sempre inicie o nome de uma classe com uma letra em maiúsculo.
+- `models.Model` significa que o Post é um modelo de Django, então o Django sabe que ele deve ser salvo no banco de dados.
+
+Agora definiremos as propriedades comentadas acima: `title`, `text`, `created_date`, `published_date` e `author`. Para fazer isso, é necessário definir um tipo para cada campo (É um texto? Um número? Uma data? Uma relação com outro objeto, por exemplo, um usuário?)
+
+- `models.CharField` - é assim que definimos um texto com um número limitado de caracteres.
+- `models.TextField` - este campo é para textos sem um limite fixo. Parece ideal para o conteúdo de um blog, né?
+- `models.DateTimeField` - este é uma data e hora.
+- `models.ForeignKey` - este é um link para outro modelo.
+
+Nós não explicaremos cada pedaço de código aqui pois isso levaria muito tempo. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+E `def publish(self):`? Esse é justamente o método `publish` de que falamos anteriormente. `def` significa que se trata de uma função/método e que `publish` é seu nome. Você pode mudar o nome do método, se quiser. A regra para nomes é sempre usar letras minúsculas e no lugar dos espaços em branco, usar o caractere sublinhado (_). Por exemplo, um método que calcula o preço médio poderia se chamar `calculate_average_price` (do inglês, calcular_preco_medio).
+
+Métodos muitas vezes retornam (`return`) algo. Um exemplo disto é o método `__str__`. Neste caso, quando chamarmos `__str__()`, obteremos um texto (**string**) com o título do Post.
+
+Lembre-se também de que tanto `def publish(self):` quanto `def __str__(self):` são endentados para dentro da classe. E porque Python é sensível a espaços em branco, precisamos endentar todos os nossos métodos para dentro da classe. Caso contrário, os métodos não pertencerão à classe e você poderá obter um comportamento inesperado.
+
+Se algo ainda não está claro sobre modelos, sinta-se livre para perguntar para sua monitora! Sabemos que é complicado, especialmente porque você está aprendendo o que são objetos e funções ao mesmo tempo. Mas esperamos que isto se pareça um pouco menos com mágica agora!
+
+### Criando tabelas para nossos modelos no banco de dados
+
+O último passo é adicionar nosso novo modelo ao banco de dados. Primeiramente, precisamos fazer com que o Django entenda que fizemos algumas alterações nos nossos modelos. (Acabamos de criar um modelo de Post!) Vá para o console e digite `python manage.py makemigrations blog`. Deve ficar assim:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Observação:** Lembre-se de salvar os arquivos que você editar. Caso contrário, o computador executará uma versão antiga que pode gerar mensagens de erro inesperadas.
+
+O Django preparou um arquivo de migração que precisamos aplicar ao nosso banco de dados. Digite `python manage.py migrate blog` e a saída deve ser:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Uhuu! Nosso modelo Post já está no banco de dados! Seria legal vê-lo, né? Vá para o próximo capítulo para descobrir como nosso Post se parece!
\ No newline at end of file
diff --git a/pt-BR/django_orm/README.md b/pt-BR/django_orm/README.md
new file mode 100644
index 00000000000..b6ba8d76d66
--- /dev/null
+++ b/pt-BR/django_orm/README.md
@@ -0,0 +1,221 @@
+# QuerySets e ORM do Django
+
+Neste capítulo você vai aprender como o Django se conecta ao banco de dados e como ele armazena dados. Vamos nessa!
+
+## O que é um QuerySet?
+
+Um QuerySet (conjunto de busca) é, em essência, uma lista de objetos de um dado modelo. QuerySet permite que você leia os dados a partir de uma base de dados, filtre e ordene.
+
+É mais fácil aprender usando exemplos. Vamos lá?
+
+## O Shell do Django
+
+Abra o seu terminal (não o PythonAnywhere) e digite o seguinte comando:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+O resultado deve ser:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Agora você está no console interativo do Django. Ele é como o prompt do Python, só que com umas mágicas adicionais ;). Você pode usar todos os comandos do Python aqui também, é claro.
+
+### Todos os objetos
+
+Primeiro, vamos tentar mostrar todas as nossas postagens. Podemos fazer isso com o seguinte comando:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! Um erro apareceu. Ele nos diz que não existe algo chamado Post. É verdade -- nós esquecemos de importá-lo antes!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+Mas isso é simples: basta importar o modelo `Post` de dentro do `blog.models`. Vamos tentar mostrar todas as postagens novamente:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+É uma lista dos posts que criamos mais cedo! Nós criamos estes posts utilizando a interface do Django admin. No entanto, agora queremos criar novos posts utilizando Python. Como fazemos isso?
+
+### Criando um objeto
+
+É assim que se cria um objeto Post no banco de dados:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Mas aqui temos um ingrediente faltando: `me`. Precisamos passar uma instância do modelo `User` como autor. Como fazemos isso?
+
+Primeiro vamos importar o modelo User:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Quais usuários temos no nosso banco de dados? Experimente isso:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+Este é o superusuário que criamos anteriormente! Vamos pegar uma instância do usuário agora (ajuste esta linha para usar seu próprio nome de usuário):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Como você pode ver, agora `obtém` um `Usuário` com um `nome de usuário` que é igual a 'ola'. Arrumado!
+
+Agora finalmente podemos criar nosso post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Uhuu! Quer ver se funcionou?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+É isso aí, mais um post na lista!
+
+### Adicionando mais postagens
+
+Agora você pode se divertir um pouco e adicionar algumas postagens para ver como funciona. Adicione mais uns 2 ou 3 posts pelo Python e siga para a próxima parte.
+
+### Filtrando objetos
+
+Um recurso importante dos QuerySets é a possibilidade de filtrá-los. Digamos que queremos encontrar todos as postagens escritas pela usuária ola. Para isto, usamos `filter` ao invés de `all` em `Post.objects.all()`. Entre parênteses, indicamos quais condições precisam ser atendidas por um post para que ele entre no nosso queryset. No nosso caso, a condição é: `author` é igual a `me`. A maneira de escrever isso no Django é: `author=me`. Agora o nosso trecho de código ficará assim:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+E se quisermos ver todos os posts que contenham a palavra 'title' no campo `title`?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Observação:** Existem dois caracteres de sublinhado (`_`) entre `title` e `contains`. O ORM do Django utiliza esta sintaxe para separar nomes de campo ("title") e operações ou filtros (como "contains"). Se você usar apenas um sublinhado, obterá um erro como "FieldError: Cannot resolve keyword title_contains".
+
+Você também pode obter uma lista de todos os posts publicados. Fazemos isso filtrando todos os posts com uma `published_date` definida no passado:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Infelizmente, o post que nós criamos pelo console do Python não está publicado ainda. Podemos mudar isso! Primeiro, busque a instância do post que queremos publicar:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+Então vamos publicá-lo com o nosso método `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Agora, busque novamente a lista de posts publicados (aperte a seta para cima algumas vezes e pressione `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordenando objetos
+
+Um QuerySet também nos permite ordenar a lista de objetos. Vamos tentar ordenar as postagens pelo campo `created_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Também podemos inverter a ordem adicionando `-` no início:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Consultas Complexas com Encadeamento de Métodos
+
+Como você viu, alguns métodos em `Post.objects` retornam um QuerySet. Esses mesmos métodos podem, por sua vez, ser invocados num QuerySet, o que resultará num novo QuerySet. Dessa forma, você pode combinar seus efeitos **encadeando-los** juntos:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Isso é muito poderoso e nos permite criar consultas bastante complexas.
+
+Legal! Você já está pronta para a próxima parte! Para fechar o terminal, digite:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/pt-BR/django_start_project/README.md b/pt-BR/django_start_project/README.md
new file mode 100644
index 00000000000..4135d004157
--- /dev/null
+++ b/pt-BR/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Seu primeiro projeto Django!
+
+> Parte deste capítulo é baseada nos tutoriais da Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parte deste capítulo é baseado no [django-marcador tutorial](http://django-marcador.keimlink.de/) licenciado sobre Creative Commons Attribution-ShareAlike 4.0 International License. O tutorial do django-marcador é protegido por direitos autorais por Markus Zapke-Gründemann et al.
+
+Nós vamos criar um blog simples!
+
+O primeiro passo é iniciar um novo projeto Django. Basicamente, isso significa que devemos rodar alguns scripts providos pelo Django que vão criar um esqueleto de projeto Django para nós. O resultado é um conjunto de diretórios e arquivos que nós iremos utilizar e modificar mais tarde.
+
+Os nomes de alguns arquivos e diretórios são muito importantes para o Django. Você não deve renomear os arquivos que estamos prestes a criar. Mover para um lugar diferente também não é uma boa idéia. O Django precisa manter uma certa estrutura para conseguir encontrar algumas coisas importantes.
+
+> Lembre-se de rodar tudo no virtualenv. Se você não vê um prefixo `(myvenv)` em seu console, é necessário ativar o virtualenv. Nós explicamos como fazer isso no capítulo **Instalação do Django** na parte **Ambiente Virtual**. Digitar `myvenv\Scripts\activate` no Windows ou `source myvenv/bin/activate` no Mac OS / Linux fará isso para você.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+No MacOS ou no console do Linux, rode o comando abaixo (**não esqueça de adicionar o ponto `.` no final</0!>):</p> 
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> O ponto `.` é crucial por que ele diz para o script instalar o Django no diretório atual (o ponto `.` é um atalho para referenciar este diretório).
+> 
+> **Observação:** Quando digitar o comando acima, lembre-se de digitar apenas a parte que começa em `django-admin`. A parte `(myvenv) ~/djangogirls$` apresentada aqui é apenas um exemplo do que pode aparecer no seu terminal quando você digitar seus comandos.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+No Windows, rode o seguinte comando (**não esqueça de adicionar o ponto `.` no final!**):
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> O ponto `.` é crucial por que ele diz para o script instalar o Django no diretório atual (o ponto `.` é um atalho para referenciar este diretório).
+> 
+> **Observação:** Quando digitar o comando acima, lembre-se de digitar apenas a parte que começa em `django-admin.exe`. A parte `(myvenv) C:\Users\Name\djangogirls>` apresentada aqui é apenas um exemplo do que pode aparecer no seu terminal quando você digitar seus comandos.
+
+<!--endsec-->
+
+`django-admin` é um script que criará os diretórios e arquivos para você. Agora, você deve ter uma estrutura de diretório parecida com isso:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Observação:** em sua estrutura de diretórios, você também verá o o diretório do virtualenv, `venv`, que criamos antes.
+
+`manage.py` é um script que ajuda com a gestão do site. Com ele, podemos iniciar um servidor de web no nosso computador sem instalar nada, entre outras coisas.
+
+O arquivo `settings.py` contém a configuração do seu site.
+
+Lembra de quando falamos sobre um carteiro verificando onde entregar uma carta? O arquivo `urls.py` contém uma lista dos padrões usados por `urlresolver`.
+
+Vamos ignorar os outros arquivos por enquanto pois não vamos modificá-los. Só precisamos lembrar de não excluí-los por acidentalmente!
+
+## Mudando as configurações
+
+Vamos fazer algumas alterações no `mysite/settings.py`. Abra o arquivo usando o editor de código que você instalou anteriormente.
+
+**Observação:** Lembre-se de que o `settings.py` é um arquivo comum, como qualquer outro. Você pode abri-lo de dentro do editor de código usando as ações de menu "Arquivo-> Abrir". Assim, você deve encontrá-lo na janela usual para selecionar arquivos e abri-lo. Ou então, é possível abrir o arquivo navegando até o diretório do djangogirls e abrindo o arquivo com o botão direito. Uma vez clicado, selecione o seu editor de código preferido da lista. Selecionar o editor apropriado é importante uma vez que você pode ter outros programas instalados que podem abrir o arquivo, mas não editá-lo.
+
+Para começar, seria bom ter a hora correta no nosso site. Para isto, você configurar o fuso horário correto de onde está. Se você estiver no Brasil, é bem provável que o fuso horário seja `America/Sao_Paulo` (aqui conhecido como horário de Brasília). Caso queira saber mais, vá para [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) e copie e cole o fuso horário correspondende à sua localização.
+
+Em `settings.py`, localize a linha que contém `TIME_ZONE` e modifique para escolher seu próprio fuso horário:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'America/Sao_Paulo'
+```
+
+Um código de idioma se refere à língua, por exemplo, `en` para inglês ou `pt` para português e o código do país, por exemplo, `br` para Brasil ou `pt` para a Portugal. Já que o inglês provavelmente não é sua língua nativa, você pode pode adicionar um novo código de país para deixar os botões padrão e notificações de Django em seu idioma. Assim, você teria por exemplo um botão "Cancel" traduzido para a língua da sua escolha (ex: "Cancelar" em português). [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+Se você quiser um idioma diferente do inglês, especifique o código de idioma alterando a seguinte linha:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'pt-BR'
+```
+
+Também precisamos adicionar o caminho para os arquivos estáticos. (Discutiremos tudo sobre arquivos estáticos e CSS mais adiante no tutorial.) Vá até o *final* do arquivo e, logo abaixo da linha com `STATIC_URL`, adicione uma nova variável chamada `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Quando `DEBUG` for `True` e `ALLOWED_HOSTS` estiver vazia, o domínio do site será validado como `['localhost', '127.0.0.1', '[::1]']`. Isso não corresponderá ao nosso domínio no PythonAnywhere quando implantarmos a nossa aplicação, então vamos mudamos a seguinte configuração:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Observação:** Se você estiver utilizando um Chromebook, adicione esta linha ao final do arquivo settings.py: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Também inclua `.c9users.io` à lista de `ALLOWED_HOSTS` se você estiver utilizando o cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Configurando um banco de dados
+
+Existem vários software de banco de dados diferentes que podem armazenar dados para o seu site. Nós vamos usar o padrão do Django, o `sqlite3`.
+
+Isto já está configurado nesta parte do seu arquivo `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Para criar um banco de dados para o nosso blog, vamos executar o seguinte comando no console. Digite: `python manage.py migrate` (precisamos estar no diretório que contém o arquivo `manage.py` `djangogirls`). Se isso der certo, você deve ver algo assim:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform: 
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations: 
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+Pronto! Hora de iniciar o servidor web e ver se nosso site está funcionando!
+
+## Iniciando o servidor web
+
+Você precisa estar no diretório que contém o arquivo `manage.py` (o diretório `djangogirls`). No console, nós podemos iniciar o servidor web executando o `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Se você usa um Chromebook, execute este comando:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> Nós revisamos como servidores web funcionam no capítulo **Como a Internet funciona**.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/pt-BR/django_templates/README.md b/pt-BR/django_templates/README.md
new file mode 100644
index 00000000000..ed450602e92
--- /dev/null
+++ b/pt-BR/django_templates/README.md
@@ -0,0 +1,108 @@
+# Templates do Django
+
+Hora de exibir dados! O Django já vem com algumas **tags de template** que são úteis pra isso.
+
+## O que são tags de template?
+
+Sabe, em HTML não podemos incluir código Python porque os browsers só entendem HTML. Sabemos que o HTML é bem estático, enquanto o Python é muito mais dinâmico.
+
+**Tags de template Django** nos permitem transformar código similar a Python em código HTML para que você possa construir sites dinâmicos mais rápido e mais facilmente. Legal!
+
+## Templates para lista de posts
+
+No capítulo anterior, fornecemos para o nosso template uma lista de postagens e a variável <o>posts</o>. Agora vamos exibi-las em HTML.
+
+Pra mostrar uma variável em um template do Django, usamos chaves duplas com o nome da variável, assim:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Tente fazer isso no seu template `blog/templates/blog/post_list.html`. Abra-o no editor de código e substitua tudo desde o segundo `<div>` até o terceiro `</div>` com `{{ posts }}`. Salve o arquivo e atualize a página para ver o resultado:
+
+![Figura 13.1](images/step1.png)
+
+Como você pode ver, obtivemos apenas:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Isto significa que o Django entende essa variável como uma lista de objetos. Em **Introdução ao Python** aprendemos como exibir listas, lembra? Sim, com laços "for"! Em um template do Django você pode criá-los assim:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Tente fazer isso no seu template.
+
+![Figura 13.2](images/step2.png)
+
+Funciona! Mas nós queremos que eles sejam exibidos como os posts estáticos que criamos anteriormente no capítulo de **Introdução a HTML**. Nós podemos misturar HTML com tags de template. O conteúdo da tag `body` ficará assim:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Tudo o que você colocar entre `{% for %}` e `{% endfor %}` será repetido para cada objeto na lista. Atualize a página:{% endraw %}
+
+![Figura 13.3](images/step3.png)
+
+Você notou que dessa vez nós usamos uma notação um pouco diferente (`{{ post.title }}` ou `{{ post.text }}`)? Estamos acessando os dados em cada um dos campos que definimos no modelo do `Post`. Além disso, `|linebreaks` está passando o texto do post por um filtro, convertendo quebras de linha em parágrafos.
+
+## Mais uma coisa
+
+Seria bom ver se seu site ainda funciona na internet, né? Vamos tentar implantar a PythonAnywhere novamente. Aqui está um resumo dos passos…
+
+* Primeiro, envie seu código para o Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Em seguida, faça login em [PythonAnywhere](https://www.pythonanywhere.com/consoles/) e vá para seu **console de Bash** (ou comece um novo) e execute:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Lembre-se de substituir `<your-pythonanywhere-domain>` pelo seu subdomínio PythonAnywhere, mas sem os colchetes angulares, ou seja, sem < e >).
+
+* Finalmente, pule para a aba ["Web" page](https://www.pythonanywhere.com/web_app_setup/) e aperte **Reload** em sua aplicação. (Para acessar outras páginas do PythonAnywhere a partir do console, utilize o botão do menu na parte superior direita). A sua atualização deve estar ativa em https://subdomain.pythonanywhere.com - confira pelo navegador! Tudo bem se as postagens em seu site PythonAnywhere não coincidirem com as postagens que aparecem no blog hospedado no seu servidor local. Os bancos de dados em seu computador local e no Python Anywhere não sincronizam com o resto de seus arquivos.
+
+Parabéns! Agora vá em frente e tente adicionar um novo post no seu administrador Django (lembre-se de adicionar published_data!). Assegure-se que você está no administrador Django do seu site pythonanywhere, https://subdomain.pythonanywhere.com/admin. E então, recarregue a página para verificar se o seu post é mostrado.
+
+Funciona? Estamos orgulhosas! Saia do seu computador um pouquinho - você merece um descanso. :3
+
+![Figura 13.4](images/donut.png)
\ No newline at end of file
diff --git a/pt-BR/django_urls/README.md b/pt-BR/django_urls/README.md
new file mode 100644
index 00000000000..104c551fd11
--- /dev/null
+++ b/pt-BR/django_urls/README.md
@@ -0,0 +1,103 @@
+# URLs
+
+Estamos prestes a construir nossa primeira página Web: uma página inicial para o seu blog! Mas primeiro, vamos aprender um pouco mais sobre as URLs do Django.
+
+## O que é uma URL?
+
+Uma URL é um endereço da web. Você pode ver uma URL toda vez que você visita um website - ela aparece na barra de endereços do seu navegador. (Sim! `127.0.0.1:8000` é uma URL! E `https://djangogirls.org` também é uma URL.)
+
+![URL](images/url.png)
+
+Cada página na Internet precisa de sua própria URL. Desta forma, sua aplicação sabe o que deve mostrar a um usuário que abre uma URL. Em Django, usamos algo chamado `URLconf` (configuração de URLs). URLconf é um conjunto de padrões que o Django vai usar para comparar com a URL recebida para encontrar a resposta correta.
+
+## Como funcionam as URLs em Django?
+
+Abra o arquivo `mysite/urls.py` no seu editor de código preferido e veja o que aparece:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Como você pode ver, o Django já colocou alguma coisa aqui para nós.
+
+Linhas entre aspas triplas (`'''` ou `"""`) são chamadas de docstrings -- você pode escrevê-las no topo de um arquivo, classe ou método para descrever o que ele faz. Elas não serão executadas pelo Python.
+
+A URL do admin, que você visitou no capítulo anterior, já está aqui:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Isso significa que para cada URL que começa com `admin/`, o Django irá encontrar uma *view* correspondente. Neste caso nós estamos incluindo várias URLs de admin de uma vez a partir de uma lista criada pelo próprio Django em <0>admin.site.urls</0>. Desta forma, não temos que repetir todas URLs no nosso modesto arquivo -- é mais legível e mais limpo.
+
+## Sua primeira URL no Django!
+
+É hora de criar nossa primeira URL! Queremos que http://127.0.0.1:8000 / seja a página inicial do nosso blog e exiba uma lista de posts.
+
+Também queremos manter o arquivo de `mysite/urls.py` limpo, e portanto importaremos as URLS da nossa aplicação `blog` no arquivo principal `mysite/urls.py`.
+
+Vá em frente, adicione uma linha que importará `blog.urls` Você também irá precisar alterar a linha `from django.urls...` porque nós estamos utilizando a função `include` aqui, então você precisará adicionar aquele import para a linha.
+
+O seu arquivo `mysite/urls.py` deve agora se parecer com isto:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+O Django agora irá redirecionar tudo o que entra em 'http://127.0.0.1:8000 /'para `blog.urls` e procurar por novas instruções lá.
+
+## blog.urls
+
+Crie um novo arquivo vazio chamado `urls.py` no diretório `blog`. É fácil! Basta adicionar essas duas linhas:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Aqui, estamos importando do Django a função `url` e todas as nossas `views` do aplicativo `blog`. (Não temos nenhuma ainda, mas chegaremos a isso em um minuto!)
+
+Depois disso podemos adicionar nosso primeiro padrão de URLs:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+Como você pode ver, estamos agora atribuindo uma `view` chamada `post_list` à URL raiz. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. Este padrão dirá ao Django que `views.post_list` é o lugar correto aonde ir se alguém entra em seu site pelo endereço 'http://127.0.0.1:8000 /'.
+
+A última parte, `name='post_list'`, é o nome da URL que será usado para identificar a view. Pode ser o mesmo nome da view, mas também pode ser algo completamente diferente. Nós vamos usar URLs nomeadas mais à frente, então é importante nomearmos agora todas as URLs de nossa aplicação. Também devemos fazer com que os nomes das URLs sejam únicos e fáceis de lembrar.
+
+Se você tentar visitar http://127.0.0.1:8000 / agora, vai encontrar alguma mensagem do tipo 'página web não disponível'. Isso ocorre porque o servidor (lembre-se de digitar `runserver`?) não está mais funcionando. Dê uma olhada na sua janela de console do servidor para descobrir o porquê.
+
+![Erro](images/error1.png)
+
+Seu console está mostrando um erro, mas não se preocupe -- este erro é bastante útil: ele está dizendo que não existe nenhum atributo **post_list** no módulo de views. Esse é o nome da *view* que Django está tentando encontrar e usar, mas ainda não a criamos. Por enquanto, seu `/admin/` também não funcionará. Mas não se preocupe, nós chegaremos lá. Se você vir uma mensagem de erro diferente, tente reiniciar seu servidor da web. Para fazer isso, na janela do console que esta executando o servidor web, interrompa o processo pressionando Ctrl+C (as teclas Control e C juntas). On Windows, you might have to press Ctrl+Break. Então, você precisará reiniciar o servidor web executando o comando `python manage.py runserver`.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/pt-BR/django_views/README.md b/pt-BR/django_views/README.md
new file mode 100644
index 00000000000..7b09393fd38
--- /dev/null
+++ b/pt-BR/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views -- hora de criar!
+
+É hora de resolver o bug que criamos no capítulo anterior! :)
+
+Uma *view* é o lugar onde nós colocamos a "lógica" da nossa aplicação. Ela vai extrair informações do `model` que você criou e entregá-las a um `template`. Nós vamos criar um template no próximo capítulo. Views são apenas funções Python um pouco mais complicadas do que aquelas que criamos no capítulo **Introdução ao Python**.
+
+As views são colocadas no arquivo `views.py`. Nós vamos adicionar nossas *views* ao arquivo `blog/views.py`.
+
+## blog/views.py
+
+OK, vamos abrir o arquivo e ver o que tem nele:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Ainda não tem muita coisa aqui.
+
+Lembre-se de que as linhas começando com `#` são comentários -- isto significa que elas não serão executadas pelo Python.
+
+Vamos criar uma *view* (como o comentário em inglês acima sugere). Vamos criar uma view simples agora:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Como você pode ver, nós criamos uma função (`def`) chamada `post_list` que leva a `solicitação` e irá `retornar` o valor que recebe ao chamar outra função `render` que irá renderizar (montar) nosso modelo `blog/post_list.html`.
+
+Salve o arquivo e abra a página http://127.0.0.1:8000/ para ver o que acontece.
+
+Outro erro! Veja o que está acontecendo agora:
+
+![Erro](images/error.png)
+
+O erro mostra que o servidor pelo menos está sendo executado, mas ainda não parece certo, né? Não se preocupe, é apenas uma página de erro: nada a temer! Como as mensagens de erro no console, estas também são muito úteis. Você pode ler *TemplateDoesNotExist*, que significa "template não existe", em inglês. Vamos corrigir este bug e criar um modelo no próximo capítulo!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/pt-BR/dynamic_data_in_templates/README.md b/pt-BR/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..1e1ab0110dc
--- /dev/null
+++ b/pt-BR/dynamic_data_in_templates/README.md
@@ -0,0 +1,86 @@
+# Dados dinâmicos em templates
+
+Até o momento, temos diferentes peças: o modelo `Post` está definido em `models.py`, temos `post_list` em `views.py` e o template adicionado. Mas como faremos de fato para que as postagens apareçam no nosso template em HTML? Porque é isso que nós queremos: pegar algum conteúdo (modelos salvos no banco de dados) e exibi-lo de uma maneira bacana no nosso template, certo?
+
+E isso é exatamente o que as *views* devem fazer: conectar modelos e templates. Vamos precisar pegar os modelos que queremos exibir e passá-los para o template na nossa lista de postagens `post_list` *view*. Em uma *view*, nós decidimos o que (qual modelo) será exibido em um template.
+
+Tudo bem, e como vamos fazer isso?
+
+Precisamos abrir o nosso `blog/views.py`. Até agora, a *view* `post_list` se parece com isso:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Lembra de quando falamos sobre a inclusão de código que foi escrito em arquivos diferentes? Agora é o momento em que precisamos que incluir o modelo que temos escrito em `models.py`. Vamos adicionar a linha `from .models import Post` assim:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+O ponto antes de `models` significa *diretório atual* ou *aplicativo atual*. Tanto `views.py` como `models.py` estão no mesmo diretório. Isto significa que podemos usar `.` e o nome do arquivo (sem `py`). Em seguida, importamos o nome do modelo (`Post`).
+
+E o que vem agora? Para pegar os posts reais do modelo `Post`, precisamos de uma coisa chamada `QuerySet`.
+
+## QuerySet
+
+Você já deve estar familiarizada com o modo que os QuerySets funcionam. Nós conversamos sobre isso no [capítulo QuerySets e ORM do Django](/django_orm/README. html).</p> 
+
+Agora queremos classificar as postagens publicadas por `published_date`, certo? Nós já fizemos isso no capítulo sobre QuerySets!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Agora vamos colocar esse pedaço de código dentro do arquivo `blog.views.py` adicionando-o à função `def post_list(request)`. Não esqueça de adicionar `from django.utils import timezone` antes!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+
+def post_list(request): 
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date') 
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Note que criamos uma *variável* para nosso o QuerySet: `posts`. Esse é o nome do nosso QuerySet. De agora em diante, podemos nos referir a ele por este nome.
+
+Na função `render` já temos um parâmetro `request` (tudo o que recebemos do usuário através da Internet) e um arquivo de template (`'blog/post_list.html'`). O último parâmetro -- `{}` -- é um lugar em que podemos acrescentar algumas coisas para o template usar. Precisamos nomear os parâmetros (continuaremos com `'posts'`, por enquanto). :) Deve ficar assim: `{'posts': posts}`. Note que a parte antes de `:` é uma string; por isso você precisa colocá-la entre aspas: `"`.
+
+Agora, nosso arquivo `blog/views.py` deve ter essa cara:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date') 
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+Pronto! Hora de voltar para o nosso template e exibir essa QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/pt-BR/extend_your_application/README.md b/pt-BR/extend_your_application/README.md
new file mode 100644
index 00000000000..f1174ff3bbd
--- /dev/null
+++ b/pt-BR/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Amplie sua aplicação
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Hora de praticar!
+
+A primeira coisa que precisamos em nosso blog é, obviamente, uma página para mostrar uma postagem, né?
+
+Já temos um modelo de `Post`, então não precisamos adicionar nada ao `models.py`.
+
+## Criando um link para os detalhes de um post
+
+Vamos começar com a adição de um link dentro do arquivo `blog/templates/blog/post_list.html`. Neste momento ele deve se parecer com: Abra-o no editor de código e, até agora, deve ficar assim:{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %} Queremos um link no título do post dentro da página de lista de posts apontando para a página de detalhes do post respectivo. Vamos mudar `<h2><a href="">{{ post.title }}</a></h2>` e adicionar um link para a página de detalhe:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Hora de explicar o misterioso `{% url 'post_detail' pk=post.pk %}`. Como você deve suspeitar, a notação `{% %}` significa que estamos usando as tags de template do Django. Dessa vez, usamos uma que cria uma URL para nós!{% endraw %}
+
+A parte `post_detail` significa que o Django espera uma URL no arquivo `blog/urls.py` com o nome definido como name='post_detail'
+
+E quanto ao `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Agora, quando formos para: http://127.0.0.1:8000/, veremos um erro (como esperado, já que existe uma URL, mas não uma *view* para `post_detail`). Vai se parecer com isso:
+
+![erro NoReverseMatch](images/no_reverse_match2.png)
+
+## Criando uma URL para a página de detalhes de um post
+
+Vamos criar uma URL em `urls.py` para a nossa `post_detail` *view*!
+
+Queremos que a página de detalhes do nosso primeiro post seja exibida por essa **URL**: http://127.0.0.1:8000/post/1/
+
+Vamos criar uma URL no arquivo `blog/urls.py` que aponta para uma *view* chamada `post_detail`, que vai nos mostrar o post completo. Abra o arquivo `blog/urls.py` no editor de código e adicione a linha `path('post/<int:pk>/', views.post_detail, name='post_detail'),` para que o arquivo fique assim:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+A parte `post/<int:pk>/` especifica um padrão de URL – vamos explicar:
+
+- `post/` significa apenas que a URL deve começar com a palavra **post** seguida por **/**. Até aqui, tudo bem.
+- `<int:pk>` – essa parte é um pouco mais complicada. Ela nos diz que o Django espera um objeto do tipo inteiro e que vai transferi-lo para a view como uma variável chamada `pk`.
+- `/` – por fim, precisamos adicionar uma **/** ao final da nossa URL.
+
+Isso significa que se você digitar `http://127.0.0.1:8000/post/5/` em seu navegador, o Django vai entender que você está procurando uma *view* chamada `post_detail` e vai transferir a informação de que `pk` é igual a `5` para essa *view*.
+
+Legal, adicionamos um novo padrão de URL para `blog/urls.py`! Vamos atualizar a página: http://127.0.0.1:8000 / Boom! O servidor parou de funcionar de novo. Dê um olhada no console -- como esperado, há ainda outro erro!
+
+![AttributeError](images/attribute_error2.png)
+
+Você se lembra qual é o próximo passo? Claro: adicionar uma view!
+
+## Adicionando a view de detalhes do post
+
+Desta vez, a nossa *view* recebe um parâmetro extra: `pk`. Nossa *view* precisa pegá-lo, certo? Então vamos definir nossa função como `def post_detail (request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Agora, queremos receber apenas um post do blog. Para isso, podemos usar queries (buscas) como esta:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Mas este código tem um problema. Se não houver nenhum `Post` com a `chave primária` (`pk`) fornecida, teremos um erro horroroso!
+
+![erro DoesNotExist](images/does_not_exist2.png)
+
+Não queremos isso! Mas, claro, o Django vem com algo que vai lidar com isso para nós: `get_object_or_404`. Caso não haja nenhum `Post` com o `pk`, o Django exibirá uma página muito mais agradável que aquela mensagem de erro -- `Page Not Found 404` (página não encontrada).
+
+![Página não encontrada](images/404_2.png)
+
+A boa notícia é que você pode criar sua própria página de `Page not found` e torná-la tão bonita quanto quiser. Mas isso não é super importante agora, então vamos deixar pra lá.
+
+Hora de adicionar uma *view* ao nosso arquivo `views.py`!
+
+Em `blog/urls.py`, criamos uma regra de URL chamada `post_detail` que se refere a uma view chamada `views.post_detail`. Isto significa que o Django espera uma função chamada `post_detail` dentro de `blog/views.py`.
+
+Vamos abrir `blog/views.py` e adicionar o seguinte código perto das outras linhas `from`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+E no final do arquivo, vamos adicionar a nossa *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+É isso aí, está na hora de atualizar a página: http://127.0.0.1:8000/
+
+![View da lista de posts](images/post_list2.png)
+
+Funcionou! Mas o que acontece quando você clica em um link no título de um post do blog?
+
+![erro TemplateDoesNotExist](images/template_does_not_exist2.png)
+
+Ah não! Outro erro! Mas nós já sabemos como lidar com isso, né? Precisamos adicionar um template!
+
+## Criando um template para os detalhes do post
+
+Vamos criar um arquivo em `blog/templates/blog` chamado `post_detail.html`.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Mais uma vez estamos estendendo `base.html`. No bloco `content`, queremos exibir a data de publicação (published_date) do post (se houver), título e texto. Mas ainda temos algumas coisas importantes para discutir, certo?
+
+{% raw %}`{% if ... %} ... {% endif %}` é uma tag de template que podemos usar quando queremos conferir alguma coisa. (Lembra de `if ... else ...` do capítulo **Introdução ao Python**?). Neste cenário nós queremos conferir se a `published_date` de um post não está vazia.{% endraw %}
+
+Pronto, podemos atualizar nossa página e ver se aquele `Page not found` sumiu.
+
+![Página de detalhes da postagem](images/post_detail2.png)
+
+Uhuu! Funcionou!
+
+# Hora do Deploy!
+
+Seria bom ver se seu site ainda estará trabalhando no PythonAnywhere, né? Vamos tentar fazer a implantação novamente.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Agora, em um [console Bash do PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Lembre-se de substituir `<your-pythonanywhere-domain>` com o nome do seu subdomínio PythonAnywhere, sem os colchetes angulares, ou seja, sem < e >).
+
+## Atualizando os arquivos estáticos no servidor
+
+Servidores como o PythonAnywhere tratam arquivos estáticos (como os arquivos CSS) de forma diferente dos arquivos em Python, por que assim podem otimizar para que eles carreguem mais rápido. Como resultado, sempre que alteramos nossos arquivos CSS, precisamos rodar um comando extra no servidor para dizer a ele que os atualize. O comando se chama `collectstatic`.
+
+Comece ativando seu virtualenv, se ele já não estiver ativo (para isso, o PythonAnywhere usa um comando chamado `workon` que é bem parecido com o comando `source myenv/bin/activate` que vosê usa no seu computador):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+O comando `manage.py collectstatic` é mais ou menos como `manage.py migrate`. Agora, fazemos algumas mudanças no nosso código e dizemos ao Django que as aplique (*apply*) à coleção de arquivos estáticos, ou ao banco de dados.
+
+Em qualquer caso, nós agora estamos prontos para saltar para a ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (do botão menu à direita do console) e pressionar **Reload**, checando a página https://subdomain.pythonanywhere.com para ver o resultado.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/pt-BR/how_the_internet_works/README.md b/pt-BR/how_the_internet_works/README.md
new file mode 100644
index 00000000000..75e201c1177
--- /dev/null
+++ b/pt-BR/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Como a Internet funciona
+
+> Para leitoras em casa: este capítulo é abordado no vídeo [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> Este capítulo é inspirado na palestra "Como a Internet funciona" de Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+Apostamos que você usa a Internet todos os dias. Mas você sabe realmente o que acontece quando digita um endereço como https://djangogirls.org em seu navegador e aperta `Enter`?
+
+A primeira coisa que você precisa entender é que um site é só um monte de arquivos salvos em um disco rígido. No entanto, há uma parte que é exclusiva para sites: ela inclui códigos de computador chamados HTML.
+
+Se você não estiver familiarizada com a programação, pode ser difícil compreender o HTML no começo, mas seus navegadores da web (como o Chrome, Safari, Firefox, etc) amam ele. Os navegadores da Web são projetados para entender esse código, seguir suas instruções e apresentar os arquivos de que um site é feito, exatamente como deve.
+
+Como qualquer arquivo, os arquivos HTML precisam ser armazenados num disco rígido. Para a internet, usamos poderosos computadores especiais chamados *servidores*. Eles não têm uma tela, um mouse ou um teclado, porque sua finalidade principal é armazenar dados e servi-los. É por isso que eles são chamados de *servidores* - eles *servem* dados a você.
+
+OK, mas você quer saber com o quê a internet se parece, certo?
+
+Fizemos um desenho para ajudar! Veja:
+
+![Figura 1.1](images/internet_1.png)
+
+Que bagunça, né? Na verdade, a internet é uma rede de máquinas conectadas (os *servidores* mencionados acima). São centenas de milhares de máquinas! Muitos, muitos quilômetros de cabos em todo o mundo! Para ver o quão complicada a internet é, você pode visitar um site (http://submarinecablemap.com/) que mostra o mapa com dos cabos submarinos. Aqui está um screenshot do site:
+
+![Figura 1.2](images/internet_3.png)
+
+Fascinante, né? Mas não é possível ter um fio ligando todas as máquinas que estão conectadas à internet. Logo, para alcançar uma máquina (por exemplo aquela onde https://djangogirls.org está salva), precisamos passar uma requisição por muitas máquinas diferentes.
+
+É algo assim:
+
+![Figura 1.3](images/internet_2.png)
+
+Imagine que quando digita http://djangogirls.org, você envia uma carta que diz: "Queridas Django Girls, eu desejo ver o site djangogirls.org. Enviem-no para mim, por favor!"
+
+Sua carta vai para a agência dos correios mais próxima de você. Então, ela vai para outra agência um pouco mais perto do destinatário e, em seguida, para outra e outra até ser entregue. A única coisa diferente é que se você enviar muitas cartas (*pacotes de dados*) para o mesmo lugar, elas podem passar por agências totalmente diferentes (*roteadores*). Isso depende de como elas são distribuídas em cada agência.
+
+![Figura 1.4](images/internet_4.png)
+
+Funciona assim - você envia mensagens e espera alguma resposta. Ao invés de papel e caneta, você usa bytes de dados, mas a ideia é a mesma!
+
+Ao invés de endereços com o nome da rua, cidade, código postal e nome do país, na internet usamos endereços de IP. Primeiro seu computador pergunta pelo DNS (Domain Name System - Sistema de Nome de Domínio) para traduzir djangogirls.org para um endereço de IP. Isso funciona mais ou menos como as antigas listas telefônicas em que você podia procurar o número e endereço da pessoa que queria contactar.
+
+Quando você envia uma carta, ela precisa ter certas características para ser entregue corretamente: um endereço, um selo, etc. E você usa uma linguagem que o destinatário compreende, certo? O mesmo se aplica aos *pacotes de dados* que você envia para acessar um site. Nós usamos um protocolo chamado HTTP (Hypertext Transfer Protocol).
+
+Então, de forma simplificada, um site precisa ter um *servidor* (máquina) onde ele vive. Quando o *servidor* recebe uma *solicitação* de entrada (numa carta), ele envia em respota seu website (em outra carta).
+
+Este é um tutorial de Django, então você deve estar imaginando o que o Django faz. Quando envia uma resposta, nem sempre você quer mandar a mesma coisa para todo mundo. É muito melhor que as cartas sejam personalizadas, especialmente para a pessoa que acabou de nos escrever, né? O Django nos ajuda a criar essas cartas personalizadas. :)
+
+Chega de falar, é hora de criar!
\ No newline at end of file
diff --git a/pt-BR/html/README.md b/pt-BR/html/README.md
new file mode 100644
index 00000000000..c885196ca25
--- /dev/null
+++ b/pt-BR/html/README.md
@@ -0,0 +1,227 @@
+# Introdução ao HTML
+
+Você pode se perguntar: o que é um template?
+
+Template é um arquivo que nós podemos reutilizar para apresentar diferentes informações em um formato consistente – por exemplo, você pode usar um template para te ajudar a escrever uma carta, pois mesmo que cada carta contenha mensagens diferentes e possa estar endereçada a pessoas diferentes, elas compartilharão o mesmo formato.
+
+O formato do template do Django é descrito em uma linguagem chamada HTML (esse é o mesm HTML que mencionamos no primeiro capítulo -- **Como a Internet funciona**).
+
+## O que é HTML?
+
+HTML é um código interpretado pelo seu navegador - como Chrome, Firefox ou Safari - para exibir uma página web ao usuário.
+
+HTML significa "HyperText Markup Language". **HiperText** significa que é um tipo de texto que suporta hiperlinks entre páginas. **Marcação** nada mais é que marcar um documento com códigos que dizem para alguém (nesse caso, o navegador web) como a página deverá ser interpretada. Códigos em HTML são feitos com **tags**, cada uma começando com `<` e terminando com `>`. Estas tags representam **elementos de marcação**.
+
+## Seu primeiro template!
+
+Criar um template significa criar um arquivo de template. Tudo é um arquivo, certo? Provavelmente você já deve ter notado isso.
+
+Os templates são salvos no diretório `blog/templates`. Então, crie um diretório chamado `templates` dentro do diretório do seu blog. Em seguida, crie outro diretório chamado `blog` dentro do diretório templates:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(Você deve estar se perguntando porque nós precisamos de dois diretórios chamados `blog` - como você descobrirá mais para frente, essa é uma convenção que facilita a nossa vida quando as coisas começam a ficar mais complicadas.)
+
+E agora nós criamos o arquivo `post_list.html` (deixe-o em branco por enquanto) dentro do diretório `blog/templates/blog`.
+
+Veja como o nosso site está agora: http://127.0.0.1:8000/
+
+> Se você ainda tem um erro `TemplateDoesNotExist`, tente reiniciar o seu servidor. Entre na linha de comando, interrompa o servidor pressionando Ctrl+C (Control seguido da tecla C, juntas) e reinicie-o rodando `python manage.py runserver`.
+
+![Figura 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Abra o novo arquivo no editor de código e adicione o seguinte:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+Como está o nosso site agora? Visite a página descobrir: http://127.0.0.1:8000/
+
+![Figura 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## "Head" e "body"
+
+Cada página HTML também é dividida em dois elementos: **head** (cabeçalho) e **body** (corpo).
+
+* **head** é um elemento que contém informações sobre o documento que não são mostradas na tela.
+
+* **body** é um elemento que contém tudo o que é exibido como parte de uma página da web.
+
+Nós usamos a tag `<head>` para dizer ao navegador quais são as configurações da página. Por sua vez, a tag `<body>` diz ao navegador qual é o conteúdo de fato da página.
+
+Por exemplo, você pode incluir o elemento título de uma página web dentro da tag `<head>`. Veja:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Salve o arquivo e atualize a página.
+
+![Figura 11.3](images/step4.png)
+
+Viu como o navegador entendeu que "Ola's blog" é o título da página? Ele interpretou `<title>Ola's blog</title>` e colocou o texto na barra de título do seu navegador (o texto também será usado nos favoritos e outras coisas mais).
+
+Provavelmente você já deve ter notado que cada tag de abertura casa com uma *tag de fechamento*, com uma `/`, e que os elementos estão *aninhados* (ex.: você não pode fechar uma tag específica antes que todas as outras tags dentro dela estejam fechadas).
+
+É como colocar coisas dentro de caixas. Você tem uma grande caixa, `<html></html>`; dentro dela há `<body></body>`, e esta contém caixas ainda menores: `<p></p>`.
+
+Você precisa seguir essas regras de *fechamento* de tags, e de *aninhamento* de elementos - se não fizer isso, o navegador provavelmente não interpretará seu código da maneira correta e sua página será exibida incorretamente.
+
+## Personalize seu template
+
+Agora você pode se divertir um pouco tentando personalizar o seu template! Aqui estão algumas tags úteis para isso:
+
+* `<h1>Um título</h1>` para o título da seção principal exibido na página
+* `<h2>Um sub-título</h2>` para um título um nível abaixo
+* `<h3>Um sub-sub-título</h3>` ... e por aí vai, até `<h6>`
+* `<p>Um parágrafo de texto</p>`
+* `<em>texto</em>` enfatiza seu texto
+* `<strong>text</strong>` enfatiza fortemente seu texto
+* `<br>` quebra a linha (você não pode digitar nada dentro da tag br e ela não possui uma tag de fechamento correspondente)
+* `<a href="https://djangogirls.org">link</a>` cria um link
+* `<ul><li>primeiro item</li><li>segundo item</li></ul>` cria uma lista, exatamente como essa!
+* `<div></div>` define uma seção da página
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Aqui vai um exemplo de um template completo; copie e cole dentro de `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Isso nos dá o seguinte efeito:
+
+![Figura 11.4](images/step6.png)
+
+Uhuu! Mas, até o momento, nosso template mostra **sempre a mesma informação** - sendo que, anteriormente, nós falávamos sobre templates como uma maneira para exibir informações **diferentes** em um **mesmo formato**.
+
+O que nós realmente queremos fazer é exibir as postagens reais que foram adicionadas no Django admin - e isso é o que faremos em seguida.
+
+## Mais uma coisa: implantação (deploy)!
+
+Seria bom ver tudo isto na Internet, certo? Vamos fazer mais um deploy no PythonAnywhere:
+
+### Commit, e dê push para subir seu código no GitHub
+
+Antes de tudo, vamos ver que arquivos foram modificados desde que nós fizemos a última implantação (execute esses comandos localmente, não no PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Assegure-se de que você está no diretório `djangogirls` e vamos dizer ao `git` para incluir todas as mudanças feitas nele:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Antes de fazermos o upload de todos os arquivos, vamos verificar quais deles o `git` enviará (todos os arquivos marcados para upload pelo `git` aparecerão em verde):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Estamos quase lá! Agora é hora de dizer ao git para salvar essa modificação em seu histórico. Daremos a ele uma "mensagem de commit" em que descrevemos as modificações que foram feitas. Você pode escrever o que quiser agora, mas é mais útil escrever algo descritivo que te ajude no futuro a lembrar das coisas que fez.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Uma vez feito isso, faremos o upload (push) das nossas mudanças para o Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Baixe seu novo código no PythonAnywhere e recarregue o seu aplicativo da web
+
+* Abra a [página de consoles do PythonAnywhere](https://www.pythonanywhere.com/consoles/) e vá para o seu **console do Bash** (ou inicie um novo). Em seguida, execute:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+Você precisará substituir `<your-pythonanywhere-domain>` com o seu subdomínio PythonAnywhere, sem os colchetes angulares (< >). O nome do seu subdomínio normalmente é o mesmo nome de usuário do seu PythonAnywhere, mas em alguns casos este pode ser um pouco diferente (por exemplo, se o nome possuir letras maísculas). Sendo assim, caso o comando não funcione, utilize o comando `ls` (lista de arquivos) para encontrar o seu subdomínio/nome da pasta e então execute `cd` para acessá-lo.
+
+Agora veja o seu código ser baixado. Se você quiser verificar se ele chegou, você pode pular para a **página "Arquivos"**e visualizar seu código no PythonAnywhere (você pode acessar outras páginas do PythonAnywhere a partir do botão de menu na página do console).
+
+* Finalmente, pule para a aba ["Web" page](https://www.pythonanywhere.com/web_app_setup/) e aperte **Reload** em sua aplicação.
+
+Sua atualização deve estar no ar! Vá em frente e atualize seu site no navegador. As alterações devem estar visíveis. :)
\ No newline at end of file
diff --git a/pt-BR/install_git.md b/pt-BR/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/pt-BR/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/pt-BR/installation/README.md b/pt-BR/installation/README.md
new file mode 100644
index 00000000000..04bf499a871
--- /dev/null
+++ b/pt-BR/installation/README.md
@@ -0,0 +1,68 @@
+# Se você estiver fazendo o tutorial em casa
+
+Se você estiver fazendo o tutorial em casa e não em um dos [eventos Django Girls](https://djangogirls.org/events/), pode pular este capítulo e ir direto para o capítulo [Como a internet funciona](../how_the_internet_works/README.md).
+
+Isso porque nós cobrimos a instalação dos itens a medida que eles são necessários no tutorial -- Essa é apenas uma página adicional que reúne todas as instruções de instalação em um só lugar (que é útil para alguns formatos de oficinas). Você pode escolher instalar tudo que está nessa página nesse momento se você quiser. Mas se você quer começar a aprender coisas antes de instalar um monte de coisas no seu computador, pule este capítulo e nós explicaremos os componentes de instalação para você mais tarde, a medida que são necessários.
+
+Boa sorte!
+
+# Se você está participando de uma oficina
+
+Se você está participando de uma oficina de um [ Evento Django Girls ](https://djangogirls.org/events/):
+
+* Sua oficina pode ter um "grupo de instalação" antes da oficina principal. Se você está com um grupo de instalação, essa página é para você! Siga as instruções aqui contidas para ter tudo que precisa para a oficina instalada, com a ajuda de instrutores, se necessário. Então, no workshop principal, poderás saltar as intruções de instalação que encontrares no tutorial principal, quando aparecerem.
+* A organização do evento pode ter pedido para você tentar realizar a instalação de tudo em casa antes do workshop começar. Se te pediram isto, esta página é para você! Siga as instruções. Então, no dia do evento quando chegar na etapa de instalação, se você não tiver conseguido instalar algo, você poderá pedir ajuda para a sua treinadora.
+* Se o seu workshop não tem uma seção de instalação (ou você não a consegue localizar) e os organizadores não lhe pedirem para tentar instalar tudo antes que você chegue, pule esta página e vá direto para [Como a internet funciona](../how_the_internet_works/README.md). Você irá instalar tudo o que precisa enquanto faz o tutorial.
+
+# Instalação
+
+Neste tutorial, você irá criar um blog. Para fazer isso, ao longo do tutorial você receberá instruções de como instalar diversos programas no seu computador e configurar algumas contas online conforme necessário. Esta página reune as instruções de instalação e registro em um só lugar (o que vai ser útil para a alguns formatos de workshop).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Vários dos passos abaixos referenciam o "console", "terminal", "janela de comandos", ou "linha de comandos" - todos significam a mesma coisa: uma janela no seu computador onde você pode inserir comandos. Quando você chegar ao tutorial principal, você irá aprender mais sobre a linha de comandos. Por agora, a coisa principal que você precisará saber é como abrir uma janela de comandos e como ela se parece: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Vá para [GitHub.com](https://www.github.com) e registre uma nova conta, de graça. Assegure-se de lembrar a sua senha (e a adicione ao seu gerenciador de senhas, caso você tenha um).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Comece a ler
+
+Parabéns, você tem tudo configurado e pronto para começar! Se você ainda tem algum tempo antes do workshop, seria útil começar a ler alguns dos capítulos de início:
+
+* [Como a internet funciona](../how_the_internet_works/README.md)
+
+* [Introdução à linha de comando](../intro_to_command_line/README.md)
+
+* [Introdução ao Python](../python_introduction/README.md)
+
+* [O que é Django?](../django/README.md)
+
+# Aproveite o workshop!
+
+Quando você começar a oficina, já será capaz de ir direto para o [seu primeiro projeto Django!](../django_start_project/README.md) porque já vai ter visto todo o material dos capítulos anteriores.
\ No newline at end of file
diff --git a/pt-BR/instructions.md b/pt-BR/instructions.md
new file mode 100644
index 00000000000..d042926b29a
--- /dev/null
+++ b/pt-BR/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for you instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/pt-BR/intro_to_command_line/README.md b/pt-BR/intro_to_command_line/README.md
new file mode 100644
index 00000000000..6b5437844b5
--- /dev/null
+++ b/pt-BR/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introdução à linha de comando
+
+> Para as leitoras em casa: este capítulo é coberto no vídeo [Sua nova amiga: a linha de comando](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+É emocionante, não?! Em poucos minutos você vai escrever sua primeira linha de código! :)
+
+**Vamos apresentá-la à sua primeira nova amiga: a linha de comando!**
+
+As etapas a seguir mostrarão como usar a janela preta que todos os hackers usam. Pode parecer um pouco assustador no começo, mas é apenas um prompt esperando por comandos.
+
+> **Observação:** Note que ao longo deste tutorial, intercalamos o uso dos termos 'diretório' e 'pasta', mas eles significam a mesma coisa.
+
+## O que é a linha de comando?
+
+A janela, que geralmente é chamada de **linha de comando** ou **interface de linha de comando**, é uma aplicação de texto para ver e manipular arquivos em seu computador. É como o Windows Explorer ou o Finder no Mac, mas sem a interface gráfica. Outros nomes para a linha de comando são: *cmd*, *CLI*, *prompt*, *console* ou *terminal*.
+
+## Abra a interface de linha de comando
+
+Para começar alguns experimentos, precisamos abrir a nossa interface de linha de comando.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+Agora você deve ver uma janela branca ou preta que está à espera de seus comandos.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Se você está usando Mac ou Linux, você provavelmente verá um `$`, como esse:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+No Windows, você provavelmente verá um `>`, assim:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Dê uma olhada na seção Linux logo acima -- você verá algo mais como isso quando você chegar ao PythonAnywhere depois no tutorial.
+
+<!--endsec-->
+
+Cada comando vai ser precedido por um `$` ou `>` e um espaço, mas você não deve digitar isso. Seu computador vai fazer isso por você. :)
+
+> Uma pequena observação: pode ser que apareça algo como `C:\Users\ola>` ou `Olas-MacBook-Air:~ ola$` antes do cursor e isso está 100% correto.
+
+A parte que vai até e inclui o `$` ou o `>` é chamada de *prompt de linha de comando*, ou *prompt*, de forma breve. Ele está pedindo que você digite algo.
+
+No tutorial, quando quisermos que você digite um comando, incluiremos o `$` ou `>` e, algumas vezes, algum texto adicional à esquerda. Ignore o que está à esquerda e apenas digite o comando que inicia após o prompt.
+
+## Seu primeiro comando (Uhuu!)
+
+Vamos começar digitando este comando:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+E então pressione a tecla `enter`. Este é o resultado:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+Como você pode ver, o computador acabou de mostrar seu nome de usuário na tela. Legal, né? :)
+
+> Tente escrever cada comando, não copie e cole. Assim você vai se lembrar melhor deles!
+
+## O Básico
+
+Cada sistema operacional tem o seu próprio conjunto de instruções para a linha de comando, então certifique-se de que você está seguindo as instruções do seu sistema operacional. Vamos tentar, certo?
+
+### Pasta atual
+
+Quer saber em que diretório está agora? Digite o seguinte comando e clique `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Observação: 'pwd' significa 'print working directory' (imprima/mostre o diretório de trabalho).
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+Você provavelmente vai ver algo parecido em seu computador. A linha de comando geralmente inicia no diretório principal do usuário, também chamado de diretório "home", em Inglês.
+
+* * *
+
+### Aprenda mais sobre um comando
+
+Muitos comandos que você digita no Prompt de comand possuem um painel de ajuda integrada que você pode abrir e ler! Por exemplo, para entender melhor sobre o comando do diretório atual:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+SO X e Linux tem um comando `man`, que ajuda você nos comandos. Tente `mand pwd` e veja o que ele diz, ou coloque `man` antes de outros comandos para ver seus menus de ajuda. A saída `man` é normalmente paginada. Use a barra de espaço para ir para a próxima página, e `q` para sair do menu de ajuda.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Colocando um sufixo `/?` para a maioria dos comandos, irá imprimir uma página de ajuda. Você pode precisar rolar a janela do seu comando para ver tudo. Tente `cd /?`.
+
+<!--endsec-->
+
+### Listando arquivos e pastas
+
+Então, o que tem no seu computador? Vamos descobrir:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Mudar a pasta atual
+
+Agora vamos para a pasta Desktop:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note que o nome do diretório "Desktop" pode estar traduzido para a linguagem da sua conta Linux. Se for o caso, você irá precisar mudar `Desktop` para o nome traduzido; como exemplo, `Área de trabalho` em português.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Verifique se realmente mudamos de pasta:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Aqui está!
+
+> Dica de profissional: se você digitar `cd D` e apertar a tecla `tab` no seu teclado, a linha de comando preencherá automaticamente o resto do nome para que você possa navegar rapidamente. Se houver mais de uma pasta cujo nome comece com "D", aperte a tecla `tab` duas vezes para obter uma lista de opções.
+
+* * *
+
+### Criando Pastas
+
+Que tal criar uma pasta para praticarmos em sua área de trabalho? Você pode fazer assim:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+Esse pequeno comando criará uma pasta com o nome `practice` na sua área de trabalho. Você pode verificar se está lá ao olhar na sua Área de trabalho ou executando o comando `ls` ou `dir`! Experimente. :)
+
+> Dica de profissional: Se você não quiser digitar o mesmo comando várias vezes, tente pressionar `seta para cima` e `seta para baixo` no teclado para percorrer comandos usados recentemente.
+
+* * *
+
+### Pratique!
+
+Um pequeno desafio para você: em sua recém criada pasta `practice`, crie uma pasta chamada `test`. (Use os comandos `cd` e `mkdir`.)
+
+#### Solução:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Boa! :)
+
+* * *
+
+### Arrumando
+
+Nós não queremos que você deixe uma bagunça, então vamos remover tudo que fizemos até aqui.
+
+Primeiro, precisamos voltar para a Área de trabalho:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Usando o comando `..` com o `cd` irá mudar sua pasta atual para o diretório pai (ou seja, a pasta que contém sua pasta atual).
+
+Verifique onde você está:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Agora é hora de deletar a pasta `practice`:
+
+> **Atenção**: A exclusão de arquivos usando `del`, `rmdir` ou `rm` é irreversível; ou seja, os *arquivos excluídos são perdidos para sempre*! Então, tenha cuidado com este comando.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Pronto! Para ter certeza de que a pasta foi excluída, vamos checar:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Saindo
+
+Isso é tudo por agora! Você pode fechar a janela da sua linha de comando agora sem medo. Vamos fazer isso do jeito hacker, certo? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Massa, né? :)
+
+## Sumário
+
+Aqui vai uma lista com alguns comandos úteis:
+
+| Comando (Windows) | Comando (Mac OS / Linux) | Descrição                     | Exemplo                                            |
+| ----------------- | ------------------------ | ----------------------------- | -------------------------------------------------- |
+| exit              | exit                     | Fecha a janela                | **exit**                                           |
+| cd                | cd                       | Muda a pasta                  | **cd test**                                        |
+| cd                | pwd                      | Mostra o diretório atual      | **cd** (Windows) ou **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | Lista as pastas e/ou arquivos | **dir**                                            |
+| copy              | cp                       | Copia um arquivo              | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | Move um arquivo               | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | Cria uma pasta                | **mkdir testdirectory**                            |
+| rmdir (ou del)    | rm                       | Exclui arquivo                | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | Exclui diretório              | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | obtém ajuda para um comando   | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+Esses são apenas alguns dos comandos que você pode executar na sua linha de comandos, mas você não irá utilizar outros por hoje.
+
+Se estiver com curiosidade, [ss64.com](http://ss64.com) contém uma referência completa dos comandos de todos os sistemas operacionais.
+
+## Pronta?
+
+Vamos mergulhar no mundo do Python!
\ No newline at end of file
diff --git a/pt-BR/intro_to_command_line/open_instructions.md b/pt-BR/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..32d46178f95
--- /dev/null
+++ b/pt-BR/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Dependendo da sua versão do Windows e do seu teclado, um dos seguintes deverá abrir uma janela de comando (você talvez tenha que experimentar um pouco, mas não precisa tentar todas essas sugestões):
+
+- Vá para o menu ou tela de iniciar, e digite "Prompt de comando" no campo de busca.
+- Vá para o menu Iniciar → Sistema Windows → Prompt de comando.
+- Vá em Iniciar → Todos os Programas → Acessórios → Prompt de comando.
+- Vá para a tela Iniciar, passe o mouse sobre o canto inferior esquerdo da tela, e clique na seta para baixo que aparecerá (Em touch screen, passe o dedo sobre a parte inferior da tela). A página "Aplicativos" deve abrir. Clique em Prompt de comando na seção Sistema Windows.
+- Pressione a tecla Windows no seu teclado e aperte a tecla "X" em seguida. Escolha "Prompt de comando" no menu pop-up.
+- Mantenha pressionada a tecla Windows e pressione a tecla "R" para obter uma janela de "Executar". Digite "cmd" na caixa e clique no botão OK.
+
+![Digite "cmd" na janela "Run"](../python_installation/images/windows-plus-r.png)
+
+Ainda neste tutorial, você precisará ter duas janelas de comando abertas ao mesmo tempo. Entretanto, em algumas versões do Windows, se você já tem uma janela de comando aberta e tentar abrir uma segunda usando o mesmo método, Ao invés de abrir o sistema apontará para a que você já tem aberto. Agora tente no seu computador e veja o que acontece! Se você só obter uma janela de comando, tente um dos outros métodos listados acima. Ao menos um deles deve resultar em uma nova janela de comando.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Vá para Aplicações → Utilidades → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Provavelmente está em aplicações → Acessórios → Terminal, ou Aplicativos → Sistema → Terminal, mas isso pode depender do seu sistema. Se não estiver lá, você pode tentar utilizar o Google. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/pt-BR/python_installation/README.md b/pt-BR/python_installation/README.md
new file mode 100644
index 00000000000..0381486d534
--- /dev/null
+++ b/pt-BR/python_installation/README.md
@@ -0,0 +1,15 @@
+# Vamos começar com o Python
+
+Finalmente chegamos aqui!
+
+Mas primeiro, vamos falar sobre o que é Python. Python é uma linguagem de programação muito popular que pode ser usada para criar sites, jogos, software científicos, gráficos e muito, muito mais.
+
+O Python foi criado na década de 1980 e seu principal objetivo é ser legível por seres humanos (e não apenas pelas máquinas!). Por isso ele parece mais simples que outras linguagens de programação, mas não se preocupe - o Python também é muito poderoso!
+
+# Instalação do Python
+
+> **Observação:** Se você está usando um Chromebook, pule este capítulo e certifique-se de seguir as instruções para [ Configuração do Chromebook](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/pt-BR/python_installation/instructions.md b/pt-BR/python_installation/instructions.md
new file mode 100644
index 00000000000..cc35d719224
--- /dev/null
+++ b/pt-BR/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Para leitoras em casa: esse capítulo é abordado no vídeo [Instalando Python & Editor de Código](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> Esta seção baseia-se em tutoriais das Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django é escrito em Python. Precisamos de Python para fazer qualquer coisa no Django. Vamos começar por instalá-lo! Queremos que você instale a versão mais recente do Python 3, então, se você tiver uma versão anterior, precisará atualizá-la. Se você já tem versão {{ book.py_min_version }} ou superior, deve funcionar normalmente.
+
+Por favor, instale o Python normal da seguinte maneira, mesmo tenha o Anaconda instalado no seu computador.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Primeiramente, verifique se o seu computador está rodando uma versão 32-bit ou 64-bit do Windows, na linha "Tipo de Sistema" na página de informação do Sistema. Para chegar a essa página, tente um desses métodos:
+
+* Aperte as teclas do Windows e "Pause/Break" ao mesmo tempo
+* Abra o seu Painel de Controle pelo menu do Windows, e navegue para "Sistema e Segurança", depois "Sistema"
+* Aperte o botão do Windows no seu teclado, então navegue para Configurações > Sistema > Sobre
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. Ele começará a fazer sugestões assim que você começar a digitar. Você pode selecionar a sugestão assim que ela aparecer.
+
+Você pode baixar Python para Windows do site https://www.python.org/downloads/windows/. Clique no link "Versão mais recente do Python 3 - Python x.x.x". Se o seu computador está executando uma versão **64-bit** do Windows, baixe o instalador executável **Windows x86-64**. Caso contrário, baixe o instalador executável **Windows x86**. Depois de baixar o instalador, você deve executá-lo (com clique duplo) e seguir as instruções fornecidas.
+
+Uma coisa para prestar atenção: durante a instalação, você notará uma janela marcada "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Não se esqueça de adicionar o Python ao Path](../python_installation/images/python-installation-options.png)
+
+Quando a instalação for concluída, pode aparecer uma caixa de diálogo com um link que você pode seguir para saber mais sobre Python ou sobre a versão que instalou. Feche ou cancele essa caixa de diálogo -- você vai aprender mais neste tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Faça o download do arquivo *Mac OS X 64-bit/32-bit installer*,
+* Dê um duplo clique no arquivo *python-3.6.1-macosx10.6.pkg* para iniciar a instalação.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Digite o seguinte comando em seu terminal:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use o seguinte comando no terminal:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use o seguinte comando no terminal:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verifique se a instalação foi bem sucedida abrindo o terminal e digitando o comando `python3`:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+Se você tem alguma dúvida ou se alguma coisa deu errado e você não tem a menor ideia do que fazer, pergunte ao seu instrutor! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/pt-BR/python_introduction/README.md b/pt-BR/python_introduction/README.md
new file mode 100644
index 00000000000..0aadf8db2b7
--- /dev/null
+++ b/pt-BR/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introdução ao Python
+
+> Parte deste capítulo é baseada no tutorial das Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Vamos escrever um pouco de código!
+
+## Interpretador de Python
+
+> Para leitoras em casa: esta parte é abordada no vídeo [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U).
+
+Para começar a trabalhar com Python, precisamos abrir uma * linha de comando* (ou prompt) no computador. Você provavelmente já sabe como fazer isso - aprendeu no capítulo [ Introdução à Linha de Comando ](../intro_to_command_line/README.md).
+
+Assim que estiver pronta, siga as instruções abaixo.
+
+Para abrir um prompt de comando do Python, digite `python` no Windows ou `python3` no Mac OS/Linux e clique `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Seu primeiro comando em Python!
+
+Depois de executar o comando python, o prompt mudou para `>>>`. Isso significa que, por enquanto, só podemos executar comandos na linguagem Python. Você não precisa digitar `>>>` - o Python fará isso por você.
+
+Se a qualquer momento você quiser sair do prompt do Python, digite `exit()` ou use o atalho `Ctrl + Z` no Windows e `Ctrl + D` no Mac ou Linux. Fazendo isso, você não vai mais ver o `>>>`.
+
+Por enquanto, não vamos sair do prompt do Python. Queremos aprender mais sobre ele. Para começar, vamos digitar um pouco de matemática, como `2 + 3`, e clicar `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Legal! Viu como a resposta apareceu? O Python sabe matemática! Você pode tentar outros comandos:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Para executar cálculo exponencial, como 2 elevado a 3, digitamos: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Brinque um pouco com isso e depois volte aqui. :)
+
+Como você pode ver, o Python é uma ótima calculadora. Se você está se perguntando o que mais pode fazer…
+
+## Strings
+
+Que tal o seu nome? Digite seu primeiro nome entre aspas, desse jeito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+Você acabou de criar sua primeira string! Uma string é uma sequência de caracteres que pode ser processada pelo computador. Ela deve sempre começar e terminar com o mesmo caractere. Este caractere pode ser aspas duplas (`"`) ou simples (`'`) (não há nenhuma diferença!). Elas dizem ao Python que o que está entre elas é uma string.
+
+Strings podem ser juntadas. Tente isto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Olá " + "Ola"
+'Olá Ola'
+```
+
+(Ola é o nome das duas criadoras do Django Girls!). Você também pode multiplicar strings por um número:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Se você precisa colocar uma apóstrofe dentro de uma string, pode fazê-lo de duas maneiras.
+
+Usando aspas duplas:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Roda d'água" 
+"Roda d'água"
+```
+
+ou "escapando" a aspa simples (o que sinaliza para o Python que aquele sinal é uma apóstrofe, e não uma aspa marcando o final da string) com uma contra-barra (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Roda d\'água" 
+"Roda d'água"
+```
+
+Legal, hein? Para ver seu nome em letras maiúsculas, basta digitar:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Você acabou de usar a **função** `upper` na sua string! Uma função (como `upper()`) é um conjunto de instruções que o Python tem que realizar em um determinado objeto (`"Ola"`) sempre que você o chamar.
+
+Se você quer saber o número de letras contidas em seu nome, há uma **função** para isso também!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Talvez você esteja se perguntando porque algumas vezes chamamos funções com um `.` depois de uma string (como `"Ola".upper()`) e outras vezes primeiro chamamos a função e depois colocamos a string entre parênteses. Bem, em alguns casos, funções pertencem a objetos - como `upper()`, que só pode ser utilizada em strings. Nesse caso, nós chamamos a função de **método**. Outras vezes, elas não pertencem a nada específico e podem ser usadas em diferentes tipos de objetos, como a função `len()`. É por isso que fornecemos `"Ola"` como parâmetro para a função `len`.
+
+### Sumário
+
+OK, chega de strings. Até agora, você aprendeu sobre:
+
+- **o prompt** - digitar comandos (códigos) no interpretador de Python resulta em respostas em Python
+- **números e strings** - no Python, números são usados para matemática e strings, para objetos de texto
+- **operadores** - como `+` e `*`, combinam valores para produzir um novo valor
+- **funções** - como `upper()` e `len()`, executam ações nos objetos.
+
+Esse é o básico de todas as linguagens de programação. Pronta para algo mais difícil? Apostamos que sim!
+
+## Erros
+
+Vamos tentar algo novo. Será que conseguimos saber a extensão de um número da mesma forma que descobrimos a dos nossos nomes? Digite `len(304023)` e clique `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Temos nosso primeiro erro! O ícone {{ warning_icon }} é a forma que o Pyhton tem para avisar que o código que você está prestes a executar não vai funcionar conforme o esperado. Cometer erros (inclusive intencionalmente) é uma parte importante da aprendizagem!
+
+Nossa primeira mensagem de erro nos diz que objetos do tipo "int" (inteiros, naturais) não têm comprimento algum. O que podemos fazer agora? Podemos escrever nosso número como string? Strings têm comprimento, certo?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Funcionou! Usamos a função `str` dentro da função `len`. A função `str ()` converte tudo em strings.
+
+- A função `str` converte as coisas em **strings**
+- A função `int` converte as coisas em **números inteiros**
+
+> Importante: podemos converter números em texto, mas nem sempre é possível converter texto em números - o que `int('hello')` quer dizer?
+
+## Variáveis
+
+Variáveis são um conceito importante em programação. Uma variável é apenas um nome que você atribui a um objeto. Programadores armazenam dados nelas para tornar seus códigos mais legíveis e para não ter que lembrar a todo momento o que são certas coisas.
+
+Se quisermos criar uma nova variável chamada `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+Digitamos: name igual Ola.
+
+Como você deve ter percebido, a última linha de código não retornou nada como nos exemplos anteriores. Então como vamos saber se a variável realmente existe? Basta digitar `name` e clicar `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Uhuuu! Sua primeira variável! :) Você pode mudar o valor dela:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+Você pode usá-la também em funções:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Incrível, né? Variáveis podem ser qualquer coisa, então podem ser números também! Tente isso:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+E se digitarmos errado o nome da variável? Você consegue imaginar o que aconteceria? Vamos tentar!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Um erro! O Python tem diferentes tipos de erros e este é chamado **NameError**. Ele mostrará esta mensagem se você tentar usar uma variável que ainda não foi definida. Se encontrar esse erro mais tarde, confira no seu código se você não digitou errado o nome de uma variável.
+
+Brinque com isso por um tempo e veja o que consegue fazer!
+
+## A função print
+
+Tente o seguinte:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Quando você digita `name`, o interpretador de Python responde com a *representação* da variável 'name' na forma de string, que é sequência de letras M-a-r-i-a, entre aspas simples. Quando você disser para o Python `print(name)`, ele vai "imprimir" (ou mostrar) na tela o conteúdo da variável sem as aspas.
+
+Como veremos mais tarde, `print()` também é útil quando queremos imprimir algo dentro de funções ou quando queremos imprimir algo em várias linhas.
+
+## Listas
+
+Além de strings e números inteiros, o Python tem muitos tipos diferentes de objetos. Agora, vamos apresentar um chamado **lista**. Listas são objetos que são listas de outros objetos. :)
+
+Vá em frente e crie uma lista:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Sim, esta é uma lista vazia. Não é muito útil, né? Vamos criar uma outra composta por números de loteria. Para não precisar repetir o código o tempo todo, vamos atribuí-la a uma variável:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+Legal, criamos uma lista! O que podemos fazer com ela? Vamos ver quantos números de loteria ela contém. Você tem ideia de que a função deve usar para isso? Você já aprendeu ;)
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Sim! `len()` pode te dizer o número de objetos que fazem parte de uma lista. Uma mão na roda, né? Agora vamos organizá-los:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Isso não retorna nada, apenas muda a ordem em que os números aparecem na lista. Vamos imprimi-la outra vez e ver o que acontece:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Agora os números estão ordenados do menor para o maior. Parabéns!
+
+E se quisermos inverter a ordem? Vamos fazer isso!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+Moleza, né? Se quiser adicionar alguma coisa à sua lista, digite o seguinte comando:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Se quiser ver apenas o primeiro número da lista, pode usar **índices**. Um índice é o número que diz onde na lista um item está. Programadores preferem começar a contar a partir do zero, então o primeiro objeto em sua lista está no índice 0, o segundo no 1 e assim por diante. Tente isso:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Como você pode ver, podemos acessar diferentes objetos na lista usando o nome da lista e o índice do objeto entre colchetes.
+
+Para apagar algum objeto da sua lista, você precisa usar **índices**, como aprendemos acima, e o método `pop()`. Vamos usar um exemplo para reforçar o que já aprendemos: vamos deletar o primeiro número de nossa lista.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Funcionou perfeitamente!
+
+Agora, tente alguns outros índices, como: 6, 7, 1000, -1, -6 ou -1000. Veja se consegue prever o resultado antes de executar o comando. Os resultados fazem sentido para você?
+
+Uma lista de todos os métodos disponíveis nesta seção pode ser encontrada na documentação do Python: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dicionários
+
+> Para leitoras em casa: esta seção é abordada no vídeo [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+
+Um dicionário é similar a uma lista, mas para acessar seus valores você usa uma chave ao invés de um índice. Uma chave pode ser qualquer string ou número. A sintaxe para definir um dicionário vazio é:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Você acabou de criar um dicionário vazio. Uhuuu!
+
+Agora escreva o seguinte comando (e tente colocar suas próprias informações):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+Com esse comando, você criou uma variável chamada `participant` com três pares de chave-valor:
+
+- A chave `name` aponta para o valor `'Ola'` (um objeto do tipo `string`),
+- a chave `country` aponta para `'Poland'` (outra `string`),
+- e a chave `favorite_numbers` aponta para `[7, 42, 92]` (uma `lista` de três números).
+
+Você pode verificar o conteúdo de chaves individuais com a sintaxe:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+É similar a uma lista, mas você não precisa lembrar o índice - apenas o nome.
+
+O que acontece se perguntarmos ao Python qual é o valor de uma chave que não existe? Você consegue adivinhar? Vamos testar e descobrir!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Olha, outro erro! Esse é um **KeyError**. O Python é bastante prestativo e te diz que a chave `'age'` não existe no nesse dicionário.
+
+Você deve estar se perguntando quando deveria usar um dicionário ou uma lista. Essa é uma questão importante. Pense sobre ela antes de ver a resposta nas próximas linhas.
+
+- Você precisa de uma sequência ordenada de itens? Use uma lista.
+- Você precisa associar valores a chaves para poder procurá-los eficientemente (pela chave) mais tarde? Use um dicionário.
+
+Dicionários, assim como listas, são *mutáveis*. Isso significa que eles podem ser alterados depois de criados. Você pode adicionar um novo par chave-valor a um dicionário depois de ele ser criado, por exemplo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Esperamos que esteja fazendo sentido até agora. :) Pronta para mais diversão com dicionários?
+
+Você pode usar o método `pop()` para deletar um item do dicionário. Se quiser excluir a entrada correspondente à chave `'favorite_numbers'`, por exemplo, basta digitar o seguinte comando:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Como você pode ver no resultado, o par chave-valor correspondente à chave 'favorite_numbers' foi excluído.
+
+Além disso, você pode mudar o valor associado a uma chave já criada no dicionário. Digite:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Agora, o valor da chave `'country'` foi alterado de `'Poland'` para `'Germany'`. :) Emocionante? Uhu! Você acabou de aprender outra coisa incrível.
+
+### Sumário
+
+Legal! Agora você sabe muito sobre programação. ;) Nesta última parte, você aprendeu sobre:
+
+- **erros** - você já sabe como ler e entender mensagens de erro que aparecem quando o Python não entende um comando que você deu;
+- **variáveis** - são nomes para objetos que permitem que você programe facilmente e deixam seu código mais legível;
+- **listas** - são listas de objetos armazenados em uma ordem específica;
+- **dicionários** - contêm objetos armazenados como pares chave-valor.
+
+Animada para a próxima parte? :)
+
+## Compare coisas
+
+> Para leitoras em casa: esta seção é abordada no vídeo [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4).
+
+Grande parte da programação consiste em comparar coisas. O que é mais fácil comparar? Números! Vamos ver como funciona:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Você deve estar se perguntando por que colocamos dois sinais de igual `==` lado a lado para verificar se os números são iguais. Nós usamos um único `=` para atribuir valores a variáveis. Você sempre, **sempre**, precisa colocar dois `==` se quiser verificar se as coisas são iguais. Também é possível afirmar que as coisas são diferentes. Para isso, usamos o símbolo `!=`, como mostrado no exemplo acima.
+
+Dê ao Python mais duas tarefas:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+Já vimos `>` e `<`, mas o que significam `>=` e `<=`? Leia da seguinte forma:
+
+- x `>` y significa: x é maior que y
+- x `<` y significa: x é menor que y
+- x `<=` y significa: x é menor ou igual a y
+- x `>=` y significa: x é maior ou igual a y
+
+Fantástico! Quer fazer mais? Tente isto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Você pode pedir ao Python para comprar quantos números quiser e ele vai te dar uma resposta! Espertinho, não é?
+
+- **and** - se você usar o operador `and`, as duas comparações terão que ser verdadeiras para que a expressão seja verdadeira (True)
+- **or** - se você usar o operador `or`, apenas uma das comparações precisa ser verdadeira para que a expressão seja verdadeira (True)
+
+Já ouviu a expressão "comparar alhos com bugalhos"? Vamos tentar o equivalente em Python:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Aqui, vemos que assim como não podemos comparar alhos com bugalhos, o Python não é capaz de comparar um número (`int`) e uma string (`str`). Em vez de retornar um resultado, ele mostrou um **TypeError** e nos disse que os dois tipos não podem ser comparados um ao outro.
+
+## Booleanos
+
+Aliás, você acabou de aprender sobre um novo tipo de objeto em Python. Ele se chama **booleano**.
+
+Existem apenas dois objetos booleanos:
+
+- True (verdadeiro)
+- False (falso)
+
+Para que o Python entenda, você precisa escrever exatamente 'True' (primeira letra maiúscula e as outras minúsculas - mas sem as aspas). **true, TRUE ou tRUE não vão funcionar - só True está correto.** (A mesma coisa vale para 'False').
+
+Booleanos também podem ser variáveis! Veja:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Você também pode fazer desse jeito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Pratique e divirta-se com os valores booleanos tentando executar os seguintes comandos:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Parabéns! Booleanos são um dos recursos mais interessantes na programação, e você acabou de aprender como usá-los!
+
+# Salve!
+
+> Para leitoras em casa: esta seção é abordada no vídeo [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk).
+
+Até agora, escrevemos todos os códigos no interpretador de Python, que nos limita a digitar uma linha por vez. Programas normais são salvos em arquivos e executados pelo nosso **interpretador** de linguagem de programação ou **compilador**. Até aqui, executamos nossos programas uma linha de cada vez no **interpretador** de Python. Vamos precisar de mais de uma linha de código para as próximas tarefas, então vamos rapidamente:
+
+- Sair do interpretador de Python
+- Abrir o editor de código que escolhemos antes
+- Salvar algum código em um novo arquivo de Python
+- Executar o código!
+
+Para sair do interpretador de Python, use a função `exit()`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Isso vai levá-la de volta ao prompt de comando.
+
+Mais cedo, nós escolhemos um editor de código da seção [code editor](../code_editor/README.md). Vamos precisar abrir o editor agora e escrever algum código em um novo arquivo (ou se você estiver utilizando um Chromebook, crie um novo arquivo no IDE da nuvem e o abra, que será incluso ao editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Você já é uma desenvolvedora Python bastante experiente, então sinta-se livre para escrever códigos com o que aprendeu hoje. ;)
+
+Agora, precisamos salvar o arquivo e dar a ele um nome descritivo. Vamos nomear o arquivo **python_intro.py** e salvá-lo na sua área de trabalho. Podemos chamá-lo como quisermos, mas é importante que o nome termine com **.py**. A extensão **.py** diz ao sistema operacional que esse é um **arquivo Python executável** e o interpretador de Python pode rodá-lo.
+
+> **Observação**: Você deve reparar numa das coisas mais legais nos editores de código: cores! No interpretador de Python, tudo é da mesma cor, mas no editor você deve estar vendo que a função `print` tem uma cor diferente da string que ela recebe como argumento. Isso se chama destaque de sintaxe ("syntax highlightning", do Inglês) e é uma funcionalidade muito útil quando escrevemos código. As cores de cada elemento nos dão dicas importantes. Elas avisam, por exemplo, sobre strings que esquecemos de fechar ou palavras reservadas que digitamos errado (como a palavra `def` na definição de uma função, que veremos adiante). Esta é uma das razões pelas quais usamos um editor de código. :)
+
+O arquivo está salvo, então é hora de executá-lo! Com as habilidades que você aprendeu na seção sobre linhas de comando, use o terminal para **ir para os diretórios no desktop**.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Em um Mac, o comando é esse:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+No Linux, ficará assim:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Lembre-se de que a palavra "Desktop" pode estar traduzida para o seu idioma local.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+No prompt de comando Windows, é assim:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+E no Windows Powershell, é assim:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Se você tiver alguma dificuldade, é só pedir ajuda. Sua monitora está aqui para isso!
+
+Agora, use o interpretador de Python para executar o código que está no arquivo, assim:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Observação: no Windows, 'python3' não é reconhecido como um comando. Em vez disso, use 'python' para executar o arquivo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Muito bom! Você acabou de rodar o seu primeiro programa Python que foi salvo a um arquivo. Sente-se incrível?
+
+Agora, você pode começar a aprender uma ferramenta essencial na programação:
+
+## If … elif … else
+
+Várias coisas em um código só podem ser executadas se determinadas condições forem atendidas. É por isso que o Python tem um comando chamado **if**.
+
+Substitua o código no arquivo **python_intro.py** pelo seguinte:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Se você salvar e executar esse código, verá um erro como este:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+O Python espera que lhe demos instruções que devem ser executadas caso a condição `3 > 2` seja verdadeira (ou `True`). Vamos tentar fazer o Python mostrar na tela o texto "Funciona!". Altere o seu código no seu arquivo **python_intro.py** para isto:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('Funciona!')
+```
+
+Notou que a linha após o "if" começa com 4 espaços? Precisamos dessa endentação para que o Python saiba quais linhas executar se a condição dentro do if for verdadeira. Você pode quantos espaços quiser, mas por convenção os programadores Python usam 4, para que os códigos fiquem mais uniformes. Uma tabulação conta como quatro espaços se você configurar seu editor de texto assim. Quando escolher quantos espaços usar, não mude! Se começou a endentar com quatro espaços, siga esse padrão em todo o código - ou você poderá encontrar problemas.
+
+Salve-o e execute novamente:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+Funciona!
+```
+
+Observação: Lembre-se que no Windows 'python3' não é reconhecido como um comando. Se você usa esse sistema operacional, de agora em diante, substitua 'python3' 'python' para executar o arquivo.
+
+### E se uma condição não for verdadeira?
+
+Nos exemplos anteriores, o código foi executado somente quando as condições eram verdadeiras, mas o Python também tem as instruções `elif` e `else`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 é maior que 2')
+else:
+    print('5 não é maior que 2')
+```
+
+Quando esse código for executado, o Python mostrará:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 é maior que 2
+    
+
+Se 2 fosse um número maior que 5, o segundo comando seria executado. Fácil, né? Vamos ver como funciona o `elif`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Olá Ola!')
+elif name == 'Sonja':
+    print('Olá Sonja!')
+else:
+    print('Olá estranho!')
+```
+
+e executando:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Olá Sonja!
+    
+
+Viu o que aconteceu? O `elif` possibilita adicionar uma condição que só vai ser executada se a primeira condição for falsa.
+
+Você pode adicionar quantos `elif` quiser depois do `if`. Por exemplo:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20: 
+    print("Está um pouco baixo")
+elif 20 <= volume < 40: 
+    print("Está bom para música ambiente")
+elif 40 <= volume < 60: 
+    print("Perfeito, posso ouvir todos os detalhes")
+elif 60 <= volume < 80: 
+    print("Ótimo para festas!")
+elif 80 <= volume < 100: 
+    print("Está muito alto!")
+else: 
+    print("Meus ouvidos doem! :(")
+```
+
+O Python testa cada condição na sequência em que aparece no código e então mostra:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfeito, posso ouvir todos os detalhes
+    
+
+## Comentários
+
+Comentários são linhas que começam com `#`. Você pode escrever o que quiser após o # `` e o Python vai ignorar. Comentários podem tornar seu código mais fácil para outras pessoas entenderem.
+
+Vamos ver como funciona:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Mudar o volume se estiver muito alto ou muito baixo
+if volume < 20 or volume > 80
+    volume = 50
+    print("Bem melhor!")
+```
+
+Você não precisa escrever um comentário para cada linha de código, mas eles são úteis para explicar porque o seu código faz alguma coisa ou para fornecer um breve resumo de algo mais complexo.
+
+### Sumário
+
+Nos últimos exercícios você aprendeu:
+
+- a **comparar coisas** - em Python, você pode comparar objetos usando os operadores `>`, `>=`, `==`, `<=`, `<` e `and`, `or`;
+- **booleano** - um tipo de objeto que só tem dois valores possíveis: `True` ou `False`;
+- a **salvar arquivos** - armazenar código em arquivos para que você possa executar programas maiores;
+- **if... elif... else** - instruções que permitem que você execute o código somente se determinadas condições forem atendidas;
+- **comentários** - linhas que o Python não executa e que permitem que você documente seu código.
+
+É hora da última parte deste capítulo!
+
+## Suas próprias funções!
+
+> Para leitoras em casa: esta parte do capítulo é abordada no vídeo [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0).
+
+Lembra de funções como `len()`? Boas notícias: agora você vai aprender como escrever suas próprias funções!
+
+Uma função é um sequência de instruções que o Python deve executar. Cada função em Python se inicia com a palavra reservada `def`, possui um nome e pode ter parâmetros. Vamos fazer uma tentativa. Substitua o código no **python_intro.py** com o seguinte:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Olá!')
+    print('Tudo bem?')
+
+hi()
+```
+
+Ok, nossa primeira função está pronta!
+
+Você pode se perguntar por que escrevemos o nome da função na parte inferior do arquivo. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Vamos executá-lo agora e ver o que acontece:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Olá!
+    Tudo bem?
+    
+
+Observação: se não funcionou, não entre em pânico! A saída (o output) vai te ajudar a entender o que aconteceu:
+
+- Se você recebeu uma mensagem `NameError`, provavelmente foi um erro de digitação, então confira se usou o mesmo nome ao criar a função com `def hi()` e quando a chamou no final com `hi()`.
+- Se recebeu uma mensagem `IdentationError`, confira se as duas linhas de `print` têm o mesmo recuo no começo: o Python precisa que o código dentro da função esteja bem alinhado.
+- Se a função não retornou nenhum resultado, certifique-se de que o útlimo `hi()`*não* esteja endentado - se ele estiver, essa linha vai se tornar parte da função e o Python não vai receber nenhum comando para executar.
+
+Foi fácil, né? Vamos construir nossa primeira função com parâmetros. Usaremos o exemplo anterior - uma função que diz 'olá' para quem o executa - com o nome dessa pessoa:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+Como você pode ver, agora demos um parâmetro chamado `name` para nossa função:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Olá Ola!')
+    elif name == 'Sonja':
+        print('Olá Sonja!')
+    else:
+        print('Olá estranho!')
+
+hi()
+```
+
+Não esqueça: a função `print` está endentada com 4 espaços depois do `if`. Isso é necessário porque a função só rodará se a condição for verdadeira. Vamos ver como isso funciona:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, um erro. Felizmente, Python nos fornece uma mensagem de erro bastante útil. Ela diz que a função `hi()` (aquela que declaramos) tem um argumento obrigatório (chamado `name`) e que nós esquecemos de passá-lo ao chamar a função. Vamos corrigi-lo na parte inferior do arquivo:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+E rode novamente:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Olá Ola!
+    
+
+E se mudarmos o nome?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+E rode novamente:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Olá Sonja!
+    
+
+Agora, o que você acha que aconteceria se escrevesse um outro nome (diferente de "Ola" ou "Sonja")? Faça um teste e veja se estava certa. Deve aparecer o seguinte:
+
+{% filename %}command-line{% endfilename %}
+
+    Olá estranho!
+    
+
+Legal, né? Dessa maneira você não precisa se repetir (Dry - don't repeat yourself) cada vez que for mudar o nome da pessoa que a função pretende cumprimentar. E é exatamente por isso que precisamos de funções - você não quer precisar repetir seu código!
+
+Vamos fazer algo mais inteligente - há mais de dois nomes e escrever uma condição para cada um seria difícil, certo? Modifique o conteúdo do seu arquivo com o seguinte:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Olá ' + name + '!')
+
+hi("Rachel")
+```
+
+Vamos chamar o código agora:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Olá Rachel!
+    
+
+Parabéns! Você acabou de aprender como criar funções. :)
+
+## Laços
+
+> Para leitoras em casa: esta parte do capítulo é abordada no vídeo [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0).
+
+Essa já é a última parte do capítulo! Rápido, né? :)
+
+Programadores não gostam de repetir código. Programar é automatizar coisas, então não queremos cumprimentar cada pessoa manualmente, certo? É aí que entram os laços (ou "loops", em Inglês).
+
+Ainda se lembra das listas? Vamos fazer uma lista de garotas:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'você']
+```
+
+Queremos cumprimentar todas elas pelos seus nomes. Temos a função `hi` para fazer isso, então vamos usá-la em um laço:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+A instrução `for` se comporta de maneira similar ao `if`; o código abaixo de qualquer uma destas instrução deve ser endentado com quatro espaços.
+
+Aqui está o código completo que será salvo no arquivo:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Olá ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'você']
+for name in girls:
+    hi(name)
+    print('Próxima')
+```
+
+E quando rodamos:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Olá Rachel!
+    Próxima
+    Olá Monica!
+    Próxima
+    Olá Phoebe!
+    Próxima
+    Olá Ola!
+    Próxima
+    Olá você!
+    Próxima
+    
+
+Como você pode ver, tudo o que colocar dentro de uma instrução `for` com endentação será repetido para cada elemento da lista `girls`.
+
+Você também pode usar o `for` em números usando a função `range`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Que deve imprimir:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` é uma função que cria uma lista de números que se seguem um após o outro (os números são dados por você como parâmetros).
+
+Note que o segundo desses dois números não está incluído na lista que o Python mostrou (em `range(1, 6)`, conta de 1 a 5, mas o 6 não é incluído). Isso porque o intervalo é semiaberto, o que significa que ele inclui o primeiro valor, mas não o último.
+
+## Sumário
+
+É isso. **Arrasou!** Esse foi um capítulo difícil, então você deve estar orgulhosa. Nós estamos orgulhosas de você por ter conseguido ir tão longe!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+Talvez você queira fazer uma breve pausa - se espreguiçar, andar um pouco, descansar os olhos - antes de ir para o próximo capítulo. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/pt-BR/signup_pythonanywhere.md b/pt-BR/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/pt-BR/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/pt-BR/template_extending/README.md b/pt-BR/template_extending/README.md
new file mode 100644
index 00000000000..25776ebb770
--- /dev/null
+++ b/pt-BR/template_extending/README.md
@@ -0,0 +1,151 @@
+# Estendendo os templates
+
+Outra coisa boa que o Django tem para você é o **template extending** - extensão de templates. O que isso significa? Significa que você pode usar as mesmas partes do seu HTML em diferentes páginas do seu site.
+
+Templates ajudam quando você quer usar a mesma informação ou layout em mais de um lugar. Você não precisa se repetir em todos os arquivos. E, caso queira mudar algo, você não precisa fazê-lo em todos os templates, apenas em um!
+
+## Criando um template base
+
+Um template base é o template mais básico sobre o qual você construirá em cada página do seu site.
+
+Vamos criar um arquivo `base.html` na pasta `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Em seguida, abra o arquivo no editor de código e copie tudo de `post_list.html` para `base.html`, desse jeito:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Então, em `base.html`, substitua todo o seu `<body>` (tudo entre `<body>` e `</body>`) por isso:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Você pode ver que essa ação substituiu tudo a partir de `{% for post in posts %}` até `{% endfor %}` por: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Mas por quê? Você acabou de criar um `bloco`! Você usou o a etiqueta de template (template tag) `{% block %}` para criar uma área que terá HTML inserido nela. Esse HTML virá de outro template que vai estender este template (`base.html`). Nós vamos te mostrar como fazer isso já já.
+
+Agora, salve `base.html` e abra novamente o seu `blog/templates/blog/post_list.html` no editor de código. {% raw %} Remova tudo acima de `{% for post in posts %}` e abaixo de `{% endfor %}`. Quando terminar, o arquivo deve estar parecido com isso: {% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Queremos usar isso como parte do nosso template para todos os blocos de conteúdo. É hora de adicionar as tags (etiquetas) de blocos neste arquivo!
+
+{% raw %}Você quer que sua etiqueta de bloco coincida com a etiqueta no seu arquivo `base.html`. Você também quer que inclua todo o código que pertence aos seus blocos de conteúdo. Para isso, coloque tudo entre `{% block content %}` e `{% endblock %}`. Assim:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Só falta uma coisa. Precisamos juntar estes dois templates. Isto é o que significa 'estender templates'! Vamos fazer isso adicionando uma etiqueta de extensão ao início do arquivo. Assim:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+É isso! Salve o arquivo e veja se o seu site ainda está funcionando corretamente. :)
+
+> Se você receber o erro `TemplateDoesNotExist`, significa que não há um arquivo em `blog/base.html` e você está rodando o `runserver` na janela do terminal. Tente encerrá-lo (apertando Ctrl+C -- as teclas Control e C juntas) e reiniciá-lo rodando o comando `python manage.py runserver`.
\ No newline at end of file
diff --git a/pt-BR/whats_next/README.md b/pt-BR/whats_next/README.md
new file mode 100644
index 00000000000..9d414a8cfef
--- /dev/null
+++ b/pt-BR/whats_next/README.md
@@ -0,0 +1,43 @@
+# O que vem agora?
+
+Parabéns! Você **arrasou**. Estamos orgulhosas! <3
+
+### O que fazer agora?
+
+Tire uma pausa e relaxe! Você acabou de fazer algo realmente grande.
+
+Depois disso, certifique-se de seguir o Django Girls no [Facebook](http://facebook.com/djangogirls) ou no [Twitter](https://twitter.com/djangogirls) para se manter atualizada.
+
+### Vocês podem recomendar outras fontes de informação?
+
+Sim! Existem *muitos* recursos online para aprender todos os tipos de habilidade de programação – pode ser bastante assustador decidir para onde prosseguir, mas nos te damos cobertura. Quaisquer que fossem seus interesses antes de vir à Django Girls, e quaisquer interesses você tenha adquirido ao longo do tutorial, aqui estão alguns recursos gratuitos (ou recursos com grandes partes gratuitas) que você pode usar para chegar até onde deseja estar.
+
+#### Django
+
+- Nosso outro livro: [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Tutorial oficial do Django](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Começando com as aulas de vídeo do Django](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Curso de desenvolvimento web do Codecademy](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Curso de Python do Code Academy](https://www.codecademy.com/learn/learn-python)
+- [Curso Python do Google](https://developers.google.com/edu/python/)
+- Livro [Learn Python The Hard Way](http://learnpythonthehardway.org/book/) - os exercícios iniciais são grátis
+- [Tutoriais New Coder](http://newcoder.io/tutorials/) - uma variedade de exemplos práticos que você pode usar Python
+- [edX](https://www.edx.org/course?search_query=python) – você pode assistir a maior parte dos cursos de graça, porem se você quiser um certificado ou créditos para validação em curso superior, então haverá um custo
+- [Especialização em Python do Coursera](https://www.coursera.org/specializations/python) - alguns videos podem ser assistidos de graça e você pode ganhar um certificado por atender aos cursos
+- [Python para todos](https://www.py4e.com/) - uma versão gratuita e aberta do Coursera Python para especialização de todo mundo
+
+#### Trabalhando com dados
+
+- [Codecademy curso de data science](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – você pode assistir a maior parte dos cursos de graça, porem se você quiser um certificado ou créditos para validação em curso superior, então haverá um custo
+- [Dataquest](https://www.dataquest.io/) – as primeiras 30 "missões" são gratuitas
+
+Mal podemos esperar para ver o que você vai construir da próxima vez!
\ No newline at end of file
diff --git a/pt-PT/GLOSSARY.md b/pt-PT/GLOSSARY.md
new file mode 100644
index 00000000000..da7757b3038
--- /dev/null
+++ b/pt-PT/GLOSSARY.md
@@ -0,0 +1,3 @@
+# editor de texto
+
+O editor de código é uma aplicação que permite guardar o teu código, possibilitando a sua edição posteriomente. Tu podes aprender onde arranjar um no [Capítulo editor de código](./code_editor/README.md)
\ No newline at end of file
diff --git a/pt-PT/README.md b/pt-PT/README.md
new file mode 100644
index 00000000000..46247f28c9d
--- /dev/null
+++ b/pt-PT/README.md
@@ -0,0 +1,51 @@
+# Tutorial Django Girls
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Este trabalho é licenciado sob a licença Creative Commons Attribution-ShareAlike 4.0. Para aceder a uma cópia desta licença, visita https://creativecommons.org/licenses/by-sa/4.0/
+
+## Bem-vindo
+
+Bem-vindo ao Tutorial de Django Girls! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introdução
+
+Já alguma vez sentiste que o mundo é cada vez mais e mais sobre tecnológia para a qual (ainda) não te encontras familiarizado? Já pensaste como criar um site, mas nunca tiveste motivação suficiente para começar? Alguma vez achaste que o mundo do software é demasiado complicado para tentares fazer alguma coisa autonomamente?
+
+Bem, então temos boas notícias para ti! Programar não é tão difícil como parece e queremos mostrar-te como pode ser divertido.
+
+Este tutorial não te irá transformar magicamente num programador. Se queres ser bom nisso, precisas de meses ou mesmo anos de aprendizagem e de prática. Mas queremos mostrar-te que programar ou criar websites não é tão complicado como parece. Vamos tentar explicar diferentes as diferentes partes tão bem quanto conseguirmos, de forma a que não te sintas intimidado pela tecnologia.
+
+Esperamos conseguir que gostes tanto de tecnologia como nós!
+
+## O que vais aprender neste tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+Ele irá (mais ou menos) ter esta aparência:
+
+![Figura 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Pedimos aos nossos formadores e anteriores participantes que estarem lá de tempos a tempos e ajudassem outros com o tutorial! Não tenhas medo de colocar lá a tua questão!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## Sobre o tutorial e contribuições
+
+Este tutorial é mantido por [DjangoGirls](https://djangogirls.org/). Se encontrares algum erro ou desejares atualizar o tutorial por favor [segue as orientações de contribuição](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/pt-PT/SUMMARY.md b/pt-PT/SUMMARY.md
new file mode 100644
index 00000000000..4ec62bed6ad
--- /dev/null
+++ b/pt-PT/SUMMARY.md
@@ -0,0 +1,35 @@
+# Índice
+
+* [Introdução](README.md)
+* [Instalação](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Instalação (chromebook)](chromebook_setup/README.md)
+* [Como funciona a Internet](how_the_internet_works/README.md)
+* [Introdução à linha de comandos](intro_to_command_line/README.md)
+* [Instalação do Python](python_installation/README.md)
+* [Editor de texto](code_editor/README.md)
+* [Introdução ao Python](python_introduction/README.md)
+* [O que é o Django?](django/README.md)
+* [Instalação do Django](django_installation/README.md)
+* [O teu primeiro projeto Django!](django_start_project/README.md)
+* [Modelos do Django](django_models/README.md)
+* [Django administrador](django_admin/README.md)
+* [Implantar!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introdução ao HTML](html/README.md)
+* [ORM do Django (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [O que se segue?](whats_next/README.md)
\ No newline at end of file
diff --git a/pt-PT/chromebook_setup/README.md b/pt-PT/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/pt-PT/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/pt-PT/chromebook_setup/instructions.md b/pt-PT/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..2df2048e6ec
--- /dev/null
+++ b/pt-PT/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/pt-PT/code_editor/README.md b/pt-PT/code_editor/README.md
new file mode 100644
index 00000000000..7b011eb3097
--- /dev/null
+++ b/pt-PT/code_editor/README.md
@@ -0,0 +1,11 @@
+# Editor de Código
+
+> Para os leitores em casa: este capítulo é coberto no vídeo [Instalando Python & Editor de Código](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+Estás prestes a escrever a tua primeira linha de código, assim está na hora de descarregares um editor!
+
+> **Nota**: Se estás a usar um Chromebook, salta este capítulo e assegura-te que segues as instruções [Chromebook Setup](../chromebook_setup/README.md). A nuvem de IDE que escolheres (PaizaCloud Cloud IDE ou AWS Cloud9) inclui um editor de código, e quando abrires um arquivo no teu IDE a partir do menu File, estarás automaticamente a usar o editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/pt-PT/code_editor/instructions.md b/pt-PT/code_editor/instructions.md
new file mode 100644
index 00000000000..9d35e1c7d2f
--- /dev/null
+++ b/pt-PT/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Existem muitos editores diferentes e trata-se essencialmente de preferência pessoal. A maioria dos programadores de Python usam IDEs (Integrated Development Environments) complexos mas extremamente poderosos, como por exemplo o PyCharm. Para um principiante, no entanto, será provavelmente menos adequado; as nossas recomendações são igualmente poderosas, mas bem mais simples.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Faz download aqui](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Faz download aqui](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Faz download aqui](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/pt-PT/css/README.md b/pt-PT/css/README.md
new file mode 100644
index 00000000000..2b63cb552bd
--- /dev/null
+++ b/pt-PT/css/README.md
@@ -0,0 +1,330 @@
+# CSS - deixa as coisas bonitas!
+
+O nosso blog ainda parece muito feio, certo? Está na hora de o deixar melhor! Para isso, nós usaremos o CSS.
+
+## O que é CSS?
+
+Cascading Style Sheets (CSS - Folhas de Estilo em Cascata, em português) é uma linguagem utilizada para descrever o visual e a formatação de um website escrito numa linguagem de marcação (como HTML). Vê-la como uma maquilhagem para a nossa página web. :)
+
+Mas nós não queremos começar novamente do zero, certo? Mais uma vez, vamos usar algo que outros programadores lançaram na Internet de gratuitamente. Tu sabes, que reinventar a roda não é divertido.
+
+## Vamos usar o Bootstrap!
+
+Bootstrap é um dos frameworks HTML e CSS mais populares para desenvolver bonitos websites: https://getbootstrap.com/
+
+Foi escrito por programadores que trabalharam no Twitter. Agora é desenvolvido por voluntários espalhados por todo o mundo!
+
+## Instalar o Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figura 14.1](images/bootstrap1.png)
+
+Já está mais bonita!
+
+## Ficheiros estáticos em Django
+
+Vamos finalmente ver em pormenor o que temos chamado **ficheiros estáticos**. Os arquivos estáticos são todos os teus CSS e imagens. O seu conteúdo não depende do contexto de requisição e será o mesmo para qualquer utilizador.
+
+### Onde colocar os ficheiros estáticos no Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+Fazemos isso criando uma pasta chamada `static` dentro da aplicação blog:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+O Django vai encontrar automaticamente quaisquer pastas chamadas "static" dentro de quaisquer pastas das tuas apps. Então ele será capaz de usar o seu conteúdo como arquivos estáticos.
+
+## O teu primeiro ficheiro CSS!
+
+Vamos criar agora um arquivo CSS, para adicionar o teu próprio estilo à tua página web. Cria um novo directório chamado `css` dentro da tua pasta `static`. Depois cria um novo ficheiro chamado `blog.css` dentro da pasta `css`. Pronta?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Está na altura de escrever CSS! Abre o ficheiro `blog/static/css/blog.css` no teu editor de código.
+
+Não vamos aprofundar muito a personalização e aprendizagem sobre CSS aqui. Existe no final desta página uma recomendação para um curso gratuito de CSS, caso pretendas aprender mais.
+
+Mas vamos fazer pelo menos um pouco disto. Maybe we could change the color of our headers? Para perceber cores, os computadores usam códigos especiais. Esses códigos começam com `#` e são seguidos de 6 letras (A-F) e números (0-9). Por exemplo, o código para a cor azul é `#0000FF`. Podes encontrar os códigos de diversas cores aqui: http://www.colorpicker.com/. Também podes usar [cores pré-definidas](http://www.w3schools.com/colors/colors_names.asp), como `red` (vermelho), e `green` (verde.
+
+Adiciona o seguinte código ao ficheiro `blog/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` é um selector de CSS. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. Então quando tivermos algo como um `<h1><a href="">link</a></h1>`, o estilo `h1 a` será aplicado. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+Num arquivo CSS nós determinamos estilos para os elementos do arquivo HTML. A primeira forma de identificar elementos é pelo o nome do elemento. Podes te lembrar destes como etiquetas da seção HTML. Coisas como `a` `h1` e `body` são exemplos de nomes de elementos. Nós também identificamos elementos pelo atributo `class` ou o atributo `id`. Class e id são nomes que tu mesmo dás ao elemento. As classes definem grupos de elementos, e ids apontam para os elementos específicos. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Podes ler mais sobre [Seletores CSS no w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Estamos apenas a carregar os arquivos estáticos aqui. :) Entre as tags `<head>` e `</head>`, depois dos links para os arquivos CSS do Bootstrap, adiciona esta linha:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+O navegador lê os arquivos na ordem em que são dados, então precisamos de ter a certeza de que isso está no sitio certo. Caso contrário, o código no nosso arquivo pode ser sobrescrito pelo código dos arquivos do Bootstrap. Acabamos de dizer ao nosso template onde se encontra o nosso arquivo CSS.
+
+O teu arquivo deverá ficar parecido como isto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, guarda o arquivo e atualiza o site!
+
+![Figura 14.2](images/color2.png)
+
+Bom trabalho! Talvez nós também queiramos dar um pouco de ar ao nosso site e aumentar a margem do lado esquerdo? Vamos tentar!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Adiciona isto ao teu CSS, guarda o arquivo e vê como ele funciona!
+
+![Figura 14.3](images/margin2.png)
+
+Talvez nós possamos personalizar a fonte no nosso cabeçalho? Cola isto no teu `<head>` no `blog/templates/blog/post_list.html` arquivo:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Assim como antes, verifica a ordem e coloca-a antes do link em `blog/static/css/blog.css`. Esta linha importará do Google Fonts (https://www.google.com/fonts) uma fonte chamada *Lobster*.
+
+Encontra o bloco de declaração `h1 a` (o código entre chaves `{` e `}`) no arquivo CSS `blog/static/css/blog.css`. Agora adiciona a linha `font-family: 'Lobster';` entre as chaves e atualiza a página:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figura 14.3](images/font.png)
+
+Excelente!
+
+Como mencionado acima, o CSS tem um conceito de classes. Estas permitem que nomeies uma parte do código HTML e apliques estilos apenas para esta parte, sem afetar outras partes. Isto pode ser super útil! Talvez tenhas duas divs que estão a fazer algo diferente (como o teu cabeçalho e o teu post). Uma classe pode ajudar-te a fazê-los parecer diferentes.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Agora iremos adicionar blocos de declaração a seletores diferentes. Seletores começando com `.` referem-se às classes. Existem vários manuais de instruções e explicações excelentes sobre CSS na Web que podem te ajudar a entender melhor o seguinte código. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Então envolve o código HTML que exibe os posts com declarações de classes. Substitui isto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+no `blog/templates/blog/post_list.html` por isto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Guarda esses arquivos e atualiza o teu site.
+
+![Figura 14.4](images/final.png)
+
+Woohoo! Está incrível, certo? Olha para o código que acabamos de colar para encontrar os locais onde adicionamos as classes no HTML e as usamos no CSS. Onde é que farias a mudança se tu quisesses a data na cor turquesa?
+
+Não tenhas medo de ajustar um pouco com este CSS e de tentar mudar algumas coisas. Brincar com o CSS pode ajudar-te a perceber quais as diferentes coisas se estão a fazer. Se partires alguma coisa, não te preocupes - tu podes sempre desfazê-lo!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Pronto para o próximo capítulo?! :)
\ No newline at end of file
diff --git a/pt-PT/deploy/README.md b/pt-PT/deploy/README.md
new file mode 100644
index 00000000000..67f39aee6f4
--- /dev/null
+++ b/pt-PT/deploy/README.md
@@ -0,0 +1,246 @@
+# Implantar!
+
+> **Nota** O capítulo seguinte pode ser às vezes um bocado difícil de completar. Persiste e termina-o; A implantação é uma parte importante do processo de desenvolvimento do website. Colocar o teu website on-line é um bocado mais complicado, por isso este capítulo encontra-se no meio do tutorial para que o teu treinador te possa ajudar nesta tarefa. Isto significa que ainda podes terminar o tutorial por conta própria se ficares sem tempo.
+
+Até agora, o teu website só estava disponível no teu computador. Agora vais aprender como implantá-lo! A implantação é o processo de publicar o teu aplicativo na Internet para que as pessoas possam finalmente ir e ver o teu app. :)
+
+Como aprendeste, um website tem de estar localizado num servidor. Existe na internet muitos fornecedores de servidor disponíveis, vamos usar o [PythonAnywhere](https://www.pythonanywhere.com/). O PythonAnyWhere é grátis para pequenas aplicações que não possuem muitos visitantes, então ele será por enquanto suficiente para ti.
+
+O outro serviço externo que usaremos é [GitHub](https://www.github.com), que é um serviço de hospedagem de código. Existem outros, mas quase todos os programadores possuem uma conta no GitHub atualmente e agora tu também!
+
+Estes três locais serão importantes para ti. O teu computador local será o local onde tu fazes o desenvolvimento e os testes. Quando estiveres feliz com as mudanças, irás colocar uma cópia do teu programa no GitHub. O teu website estará na PythonAnywhere e irás ter que o atualizar, ao obteres uma nova cópia do teu código do GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Iniciar o nosso repositório no Git
+
+O Git controla as alterações para um determinado conjunto de arquivos que chamamos de repositório de código (ou "repo"). Vamos iniciar uma para nosso projeto. Abre o console e executa estes comandos, no diretório `djangogirls`:
+
+> **Nota**: Verifica o teu diretório de trabalho atual com um `pwd` (OSX/Linux) ou o comando `cd` (Windows) antes de inicializar o repositório. Deves estar na pasta `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Só necessitamos de iniciar o repositório git apenas uma vez por projeto (e não será necessário colocar novamente o nome do utilizador e email).
+
+O Git irá rastrear as alterações para todos os arquivos e pastas neste diretório, mas existem alguns arquivos que queremos ignorar. Fazemos isto através da criação de um arquivo chamado `.gitignore` no diretório base. Abre o teu editor e cria um novo arquivo com o seguinte conteúdo:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+Guarda-o como `.gitignore` na pasta "djangogirls".
+
+> **Nota** O ponto no início do nome do arquivo é importante! Se estás com algum tipo de dificuldade em criá-lo (por exemplo, os Macs não gostam de criar arquivos que começam com um ponto através do Finder), usa o recurso "Guardar Como" no teu editor; que nunca irá falhar. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Nota** Um dos arquivos que especificaste no teu `.gitignore` é `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/pt-PT/deploy/install_git.md b/pt-PT/deploy/install_git.md
new file mode 100644
index 00000000000..dc14d8f47fa
--- /dev/null
+++ b/pt-PT/deploy/install_git.md
@@ -0,0 +1,52 @@
+O Git é um "sistema de controle de versão" usado por muitos programadores. Este software pode rastrear as mudanças nos arquivos ao longo do tempo para que possas recuperar as versões específicas mais tarde. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Instalar o Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Podes descarregar o Git em [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Tirando isso, as configurações padrão estão ótimas. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Nota** Se estiveres a executar o OS X 10.6, 10.7, ou 10.8, vais precisar de instalar a versão do git daqui: [Instalador Git para o OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/pt-PT/deploy/signup_pythonanywhere.md b/pt-PT/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/pt-PT/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/pt-PT/django/README.md b/pt-PT/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/pt-PT/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/pt-PT/django_admin/README.md b/pt-PT/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/pt-PT/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/pt-PT/django_forms/README.md b/pt-PT/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/pt-PT/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/pt-PT/django_installation/README.md b/pt-PT/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/pt-PT/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/pt-PT/django_installation/instructions.md b/pt-PT/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/pt-PT/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/pt-PT/django_models/README.md b/pt-PT/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/pt-PT/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/pt-PT/django_orm/README.md b/pt-PT/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/pt-PT/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/pt-PT/django_start_project/README.md b/pt-PT/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/pt-PT/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/pt-PT/django_templates/README.md b/pt-PT/django_templates/README.md
new file mode 100644
index 00000000000..0c846eee661
--- /dev/null
+++ b/pt-PT/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figura 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figura 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figura 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/pt-PT/django_urls/README.md b/pt-PT/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/pt-PT/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/pt-PT/django_views/README.md b/pt-PT/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/pt-PT/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/pt-PT/dynamic_data_in_templates/README.md b/pt-PT/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/pt-PT/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/pt-PT/extend_your_application/README.md b/pt-PT/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/pt-PT/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/pt-PT/how_the_internet_works/README.md b/pt-PT/how_the_internet_works/README.md
new file mode 100644
index 00000000000..64402ceaf64
--- /dev/null
+++ b/pt-PT/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Como funciona a Internet
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Browsers são desenhados para perceber este código, seguir as suas instruções, e apresentar estes ficheiros que constroem o teu site exactamente da forma que queres.
+
+Como com qualquer outro ficheiro, precisamos de guardar ficheiros HTML num disco rígido. Para a Internet, usamos computadores especiais e poderosos chamados *servidores*. Estes não tem um monitor, rato nem teclado, porque o seu propósito principal é guardar e enviar dados. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+Fizemos-te um desenho! Parece isto:
+
+![Figura 1.1](images/internet_1.png)
+
+Parece uma confusão, certo? In fact it is a network of connected machines (the above-mentioned *servers*). Centenas de milhares de máquinas! Muitos, muitos quilómetros de cabos à volta do mundo! Podes visitar o website Mapa de Cabos Submarinos (http://submarinecablemap.com) para ver o quão complicada é a rede. Aqui está uma captura de écran do website:
+
+![Figura 1.2](images/internet_3.png)
+
+Fascinante, não é? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+Parece-se com isto:
+
+![Figura 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+A carta vai para os correios mais próximos de ti. Depois vai para outros que ficam um pouco mais perto do destinatário, depois outro e outro até que é entregue no destino. A única coisa diferente é que se enviares muitas cartas (*pacotes de dados*) para o mesmo destino, eles podem chegar lá através de estações de correios completamente diferentes (*routers*). Isto depende de como são distribuídos em cada estação de correios.
+
+![Figura 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Em vez de moradas com nomes de ruas, código postal e nome do país, usamos endereços de IP. Primeiro, o teu computador pede ao DNS (do inglês *Domain Name System*, Sistema de Nomes de Domínios) que traduza djangogirls.org para um endereço de IP. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Também usas uma linguagem que o destinatário percebe, certo? O mesmo se aplica a *pacotes de dados* que envias para ver um website. Usamos um protocolo chamado HTTP (*Hypertext Transfer Protocol*, Protocolo de Transferência de Hipertexto).
+
+Quando tens um website, também precisas de ter um *servidor* (máquina) onde ele vive. Quando o *servidor* recebe um *pedido* (numa carta), ele responde com um website (noutra carta).
+
+Since this is a Django tutorial, you might ask what Django does. Quando envias uam resposta, não queres sempre enviar a mesma coisa para toda a gente. É muito melhor se as tuas cartas forem personalizadas à pessoa que acabou de te escrever, certo? Django ajuda-te a criar estas cartas personalizadas e interessantes. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/pt-PT/html/README.md b/pt-PT/html/README.md
new file mode 100644
index 00000000000..37ae1377231
--- /dev/null
+++ b/pt-PT/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figura 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figura 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figura 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figura 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/pt-PT/install_git.md b/pt-PT/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/pt-PT/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/pt-PT/installation/README.md b/pt-PT/installation/README.md
new file mode 100644
index 00000000000..62bb168a838
--- /dev/null
+++ b/pt-PT/installation/README.md
@@ -0,0 +1,68 @@
+# Se estás a fazer o tutorial em casa
+
+Se estás a fazer o tutorial em casa, e não num dos [eventos Django Girls](https://djangogirls.org/events/), podes saltar este capítulo e ir directamente para [Como funciona a Internet?](../how_the_internet_works/README.md).
+
+Isto porque enunciamos como instalar as coisas no decorrer dos tutoriais -- esta é apenas uma página adicional que reune todas as intruções (o que se torna útil para alguns dos formatos de workshop). Podes escolher instalação de tudo o que se encontra nesta página, agora mesmo, se o desejares. Mas se quiseres começar a aprender algo antes de estares a instalar uma data de coisas no teu computador, salta este capítulo e posteriormente vamos-te indicando o que e como instalar, consoante necessário.
+
+Boa sorte!
+
+# Se estiveres a assistir a um workshop
+
+Se estiveres a um dos eventos [Dango Girls](https://djangogirls.org/events/):
+
+* O teu workshop deve ter uma "secção de instalação" antes do workshop principal. Se estiveres na secção de instalação, esta página é para ti! Segue as instruções aqui para obteres tudo o que precisas para o ter o workshop, com a ajuda dos monitores caso necessites. Então, no workshop principal, poderás saltar as intruções de instalação que encontrares no tutorial principal, quando aparecerem.
+* A organização do workshop poderá ter-te perguntado se tentaste reslizar a instalação no computador, em casa antes de vires para o workshop. Se te oriposeram a isso, esta página é para ti! Segue estas instruções, o melhor que poderes. Então, no workshop principal, quando chegares ao passo da instalação no tutorial principal, se tiveste alguma dificuldade na instalação poderás encontrar ajuda junto do teu monitor.
+* Se o teu workshop n tem uma secção de instalação (ou não conseguiste obtê-la), e se os organizadores não te pediram para tentar instalar tudo antes de chegares, salta esta página e segue diretamente para o capítulo [Como funciona a internet](../how_the_internet_works/README.md). Irás instalar tudo o que precisas no seguimento do tutorial.
+
+# Instalação
+
+Neste tutorial isrás construir um blog. Nesse sentido, no seguimento do tutorial terás as instruções de como instalar o software no teu computador e configurar algumas contas online conforme serão necessárias. Esta página reune toda a instalação e instruções de inscrição (que será útil para laguns formatos de workshop).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/configuração_chromebook/instrucoes.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Muitos dos passos abaixo, referenciam "console", "terminal", "janela de comando" ou "linha de comando" -- todos significam a mesma coisa: uma janela no teu computador onde podes digitar comandos. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Começar a ler
+
+Parabéns, está tudo preparado e pronto a começar! Se ainda tens algum tempo antes do workshop, seria útil começares a ler alguns dos capítulos iniciais:
+
+* [Como funciona a Internet](../how_the_internet_works/README.md)
+
+* [Introdução à linha de comandos](../intro_to_command_line/README.md)
+
+* [Introdução ao Python](../python_introduction/README.md)
+
+* [O que é o Django?](../django/README.md)
+
+# Disfruta do workshop!
+
+Quando iniciares o workshop, poderás de ir, diretamente, para o [O teu primeiro projeto em Django!](../django_start_project/README.md) porque já realizaste o material nos capítulos anteriores.
\ No newline at end of file
diff --git a/pt-PT/instructions.md b/pt-PT/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/pt-PT/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/pt-PT/intro_to_command_line/README.md b/pt-PT/intro_to_command_line/README.md
new file mode 100644
index 00000000000..878b50d9815
--- /dev/null
+++ b/pt-PT/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introdução à interface da linha de comandos
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Vamos apresentar-te à tua primeira nova amiga: a linha de comandos!**
+
+Os passos a seguir vão mostrar-te como usar a janela preta que todos os hackers usam. Pode parecer um pouco assustadora mas na verdade está só à espera que lhe dês comandos.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## O que é a linha de comandos?
+
+A janela a que chamamos **linha de comandos**, é uma aplicação de texto para ver, controlar e alterar ficheiros no computador. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Outros nomes para a linha de comandos são: *cmd*, *CLI*, *consola* ou *terminal*.
+
+## Abre a interface da linha de comandos
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Linha de Comandos
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## O teu primeiro comando (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Básicos
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Directório actual
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd "Ambiente de Trabalho"
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solução:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Índice
+
+Here is a summary of some useful commands:
+
+| Comando (Windows) | Comando (Mac OS / Linux) | Descrição                    | Exemplo                                            |
+| ----------------- | ------------------------ | ---------------------------- | -------------------------------------------------- |
+| sair              | sair                     | fechar a janela              | **sair**                                           |
+| cd                | cd                       | mudar de directório          | **cd test**                                        |
+| cd                | pwd                      | show the current directory   | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | listar directórios/ficheiros | **dir**                                            |
+| copy              | cp                       | copiar ficheiro              | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | mover ficheiro               | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | criar um novo directório     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file                | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory           | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command       | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Pronta?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/pt-PT/intro_to_command_line/open_instructions.md b/pt-PT/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/pt-PT/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/pt-PT/python_installation/README.md b/pt-PT/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/pt-PT/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/pt-PT/python_installation/instructions.md b/pt-PT/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/pt-PT/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/pt-PT/python_introduction/README.md b/pt-PT/python_introduction/README.md
new file mode 100644
index 00000000000..e22c9982760
--- /dev/null
+++ b/pt-PT/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introdução ao Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Índice
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Índice
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Índice
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Índice
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/pt-PT/signup_pythonanywhere.md b/pt-PT/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/pt-PT/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/pt-PT/template_extending/README.md b/pt-PT/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/pt-PT/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/pt-PT/whats_next/README.md b/pt-PT/whats_next/README.md
new file mode 100644
index 00000000000..e11dd47e5d6
--- /dev/null
+++ b/pt-PT/whats_next/README.md
@@ -0,0 +1,43 @@
+# O que se segue?
+
+Parabéns! Tu és **demais**. Estamos orgulhosos! <3
+
+### O que fazer agora?
+
+Take a break and relax! You have just done something really huge.
+
+Depois disso, confirma se estás a seguir o Django Girls no [Facebook](http://facebook.com/djangogirls) ou no [Twitter](https://twitter.com/djangogirls) para te manteres atualizado.
+
+### Podes recomendar outro tipo de recursos adicionais?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/pt/GLOSSARY.md b/pt/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/pt/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/pt/README.md b/pt/README.md
index 2a1da91860c..01736ae0502 100755
--- a/pt/README.md
+++ b/pt/README.md
@@ -1,94 +1,51 @@
-# Tutorial Django Girls
+# Django Girls Tutorial
 
-[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
 
- [1]: https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
 
-> Este trabalho é licenciado sob a licença Creative Commons Attribution-ShareAlike 4.0. Para ver uma cópia desta licença, visite https://creativecommons.org/licenses/by-sa/4.0/
+## Welcome
 
-## Translation
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
 
-This tutorial has been translated from English to Portuguese by a group of awesome volunteers. 
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
 
-Special thanks for help goes out to:
+## Introduction
 
-* Adailton do Nascimento 
-* Adam Victor Nazareth Brandizzi 
-* Antonio Luis 
-* Annanda Sousa 
-* Adjamilton Junior 
-* Bernardo Fontes 
-* Camilla Achutti
-* Carla Suarez
-* Cleiton Lima 
-* clemente.jnr
-* danieltex 
-* Eric Hideki 
-* Flavio Barros 
-* Fabio C. Barrionuevo da Luz 
-* ffabiorj 
-* Gabriela Cavalcante da Silva 
-* Herbert Fortes
-* Leandro Silva Araujo 
-* Lucas Magnum 
-* 1pedro 
-* Joao Luiz Lorencetti  
-* Katyanna Moura 
-* Kleber C Pinheiro 
-* Leandro Barbosa 
-* Leonardo Alves dos Santos 
-* Marcel Ribeiro Dantas 
-* joepreludian 
-* Rafael Biagioni de Fazio 
-* Pablo Palacios 
-* Paulo Alem 
-* Raony Guimares Correo do Carmo Lisboa Cardenas 
-* RSiP22
-* Vivian Macedo
-* Willie Lawrence 
-* Ricardo Manhães Savii
-Wow! <3 <3 
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
 
-## Introdução
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
 
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
 
-Você já sentiu como se o mundo fosse cada vez mais tecnológico e que de alguma forma você tenha ficado pra trás? Você já imaginou como seria criar um website mas nunca teve motivação suficiente para começar? Você já pensou que o mundo do software é complicado demais até mesmo para você tentar fazer alguma coisa sozinha?
+We hope that we'll be able to make you love technology as much as we do!
 
-Bem, nós temos boas notícias para você! Programação não é tão difícil quanto parece e nós queremos te mostrar o quão divertido pode ser.
+## What will you learn during the tutorial?
 
-Este tutorial não irá te transformar magicamente em uma programadora. Se você quer ser boa nisso, precisa de meses ou até mesmo anos de treino e prática. Porém, nós queremos te mostrar que a programação ou criação de websites não é tão complicada quanto parece. Nós tentaremos explicar as diferentes etapas tão bem quanto pudermos, de forma que você não se sinta intimidada pela tecnologia.
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
 
-Nós esperamos conseguir fazer você amar a tecnologia tanto quanto nós amamos!
+It will (more or less) look like this:
 
-## O que você irá aprender durante o tutorial?
+![Figure 0.1](images/application.png)
 
-Quando você tiver terminado o tutorial você terá uma aplicação web simples e funcional: seu próprio blog. Nós vamos mostrar como colocá-lo online, para que outras pessoas vejam seu trabalho!
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
 
-Seu blog se parecerá (mais ou menos) com isso:
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
 
-![Figura 0.1][2]
+## Following the tutorial at home
 
- [2]: images/application.png
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
 
-> Se você está seguindo o tutorial por conta própria e não tem uma treinadora ou treinador para ajudar em caso de qualquer problema, nós temos um chat para você: [![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)[1]. Sempre pedimos às nossas treinadoras e participantes anteriores que acessem lá de tempos em tempos e ajudem outras pessoas com o tutorial! Não tenha medo de fazer sua pergunta lá!
+In every chapter already covered, there is a link that points to the correct video.
 
-OK, [vamos pelo começo...][3]
+## About and contributing
 
- [3]: ./how_the_internet_works/README.md
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
 
-## Sobre o tutorial e contribuições
+## Would you like to help us translate the tutorial into other languages?
 
-Este tutorial é mantido por [DjangoGirls][4]. Se você encontrar quaisquer erros ou quiser atualizar o tutorial, por favor [siga as orientações de contribuição][5].
-
- [4]: https://djangogirls.org/
- [5]: https://github.com/DjangoGirls/tutorial/blob/master/README.md
-
-## Gostaria de nos ajudar a traduzir o tutorial para outros idiomas?
-
-no momento, as traduções estão sendo mantidas na plataforma crowdin.com em:
+Currently, translations are being kept on crowdin.com platform at:
 
 https://crowdin.com/project/django-girls-tutorial
 
-Se o seu idioma não está listado no crowdin, por favor [open a new issue][6] informando o idioma para que possamos adicioná-lo.
-
- [6]: https://github.com/DjangoGirls/tutorial/issues/new
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/pt/SUMMARY.md b/pt/SUMMARY.md
index adb12056799..7a45700a27d 100755
--- a/pt/SUMMARY.md
+++ b/pt/SUMMARY.md
@@ -1,26 +1,27 @@
-# Sumário
+# Summary
 
-* [Introdução](README.md)
-* [Como funciona a internet?](how_the_internet_works/README.md)
-* [Introdução à linha de comando](intro_to_command_line/README.md)
-* [Instalação do Python](python_installation/README.md)
-* [Editor de Código](code_editor/README.md)
-* [Introdução ao Python](python_introduction/README.md)
-* [O que é Django?](django/README.md)
-* [Instalação do Django](django_installation/README.md)
-* [Criando um projeto](django_start_project/README.md)
-* [Modelos do Django](django_models/README.md)
-* [Administração](django_admin/README.md)
-* [Implantação!](deploy/README.md)
-* [Urls](django_urls/README.md)
-* [Views - hora de criar!](django_views/README.md)
-* [Introdução a HTML](html/README.md)
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
 * [Django ORM (Querysets)](django_orm/README.md)
-* [Dados dinâmicos nos templates](dynamic_data_in_templates/README.md)
-* [Templates](django_templates/README.md)
-* [CSS - Deixe mais bonito](css/README.md)
-* [Estendendo os templates](template_extending/README.md)
-* [Amplie sua aplicação](extend_your_application/README.md)
-* [Formulários](django_forms/README.md)
-* [Domínio](domain/README.md)
-* [O que vem depois?](whats_next/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/pt/chromebook_setup/README.md b/pt/chromebook_setup/README.md
index 9f5e8456440..a4843977603 100644
--- a/pt/chromebook_setup/README.md
+++ b/pt/chromebook_setup/README.md
@@ -1,5 +1,5 @@
-# Configuração do Chromebook
+# Chromebook setup
 
-> **Nota** Se você já seguiu os passos de Instalação, não é necessário fazer isso de novo – você pode pular direto para [Introdução ao Python](../python_introduction/README.md).
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
 
-{% include "/chromebook_setup/instructions.md" %}
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/pt/chromebook_setup/instructions.md b/pt/chromebook_setup/instructions.md
index 5957ae7005a..809281456d3 100644
--- a/pt/chromebook_setup/instructions.md
+++ b/pt/chromebook_setup/instructions.md
@@ -1,83 +1,60 @@
-Você pode [pular essa seção totalmente](http://tutorial.djangogirls.org/en/installation/#install-python) se você não estiver 
-usando um Chromebook. Se você estiver usando, seus passos de instalação serão um pouco diferentes. Você pode ignorar o resto 
-das instruções de instalação.
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
 
 ### Cloud 9
 
-Cloud 9 é uma ferramenta que lhe fornece um editor de código e acesso a um
-computador rodando na Internet onde você pode instalar, escrever, e rodar
-software. Durante esse tutorial, o Cloud 9 irá atuar como sua _máquina local_. 
-Você continuará a executar comandos em uma interface de terminal, como seus
-companheiros de classe em um OS X, Ubuntu, ou Windows, mas seu terminal 
-estará conectado em um computador que está rodando em algum outro lugar, com as
-configuraçoes que o Cloud 9 fez para você.
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
 
-1. Instale o Cloud 9 a partir da [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
 2. Go to [c9.io](https://c9.io)
-3. Registre uma conta
-4. Clique em _Create a New Workspace_
-5. Nomeie como _django-girls_
-6. Selecione o _Blank_ (segundo a direita, na linha de baixo com a logo laranja)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
 
-Agora você deve ver uma interface com uma barra lateral, uma grande janela principal com
-algum texto, e uma pequena janela embaixo que parece com algo como isso:
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
 
 {% filename %}Cloud 9{% endfilename %}
-```
-yourusername:~/workspace $
-```
 
-Essa área abaixo é o seu _terminal_, onde você irá encontrar o computador Cloud 9
-preparado para suas instruções. você pode redimencionar essa janela para torná-la
-um pouco maior.
+    yourusername:~/workspace $
+    
 
-### Ambiente Virtual
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
 
-Um ambiente virtual (também chamado de virtualenv) é como uma caixa privada onde nós
-podemos colocar códigos de computador úteis para um projeto em que estamos trabalhando.
-Nós usamos um ambiente virtual para manter os vários bits de código que nós queremos
-usar em nosso projeto em separado, para que as coisas não se misturem entre diferentes 
-projetos.
+### Virtual Environment
 
-Em seu terminal, na parte de baixo da interface do Cloud 9, execute o seguinte:
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
 
 {% filename %}Cloud 9{% endfilename %}
-```
-sudo apt install python3.5-venv
-```
 
-Se isso não funcionar, peça uma ajuda ao seu treinador.
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
 
-Em seguida, execute:
+Next, run:
 
 {% filename %}Cloud 9{% endfilename %}
-```
-mkdir djangogirls
-cd djangogirls
-python3.5 -mvenv myvenv
-source myvenv/bin/activate
-pip install django~=1.9.0
-```
 
-(note que na última linha nós usamos um "til" seguido de um sinal de igual: ~=).
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
 
 ### Github
 
-Crie uma conta no [Github](https://github.com).
+Make a [Github](https://github.com) account.
 
 ### PythonAnywhere
 
-O tutorial Django Girls inclui uma seção que é chamada Deployment,
-que é o processo de pegar o código criado para nossa nova aplicação web e 
-movê-lo para um computador de acesso público (chamado de servidor), para
-que outras pessoas possam ver o seu trabalho.
-
-Essa parte é um pouco estranha quando o tutorial é feito por um Chromebook,
-já que nós já estamos usando um computador que está na Internet (ao contrário de, 
-digamos, um laptop). Entretanto, ainda é útil, se nós pudermos pensar em nosso 
-ambiente de trabalho no Cloud 9 como um lugar de desenvolvimento de nosso trabalho 
-e Python Anywhere como um lugar para exibir nossas coisas assim que elas se 
-tornarem mais completas.
- 
-Sendo assim, registre com uma nova conta em Python Anywhere
-[www.pythonanywhere.com](https://www.pythonanywhere.com).
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/pt/code_editor/instructions.md b/pt/code_editor/instructions.md
index 8a8135bc7e7..074cd86196e 100755
--- a/pt/code_editor/instructions.md
+++ b/pt/code_editor/instructions.md
@@ -1,43 +1,31 @@
-# Editor de Código
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
 
-Você está prestes a escrever sua primeira linha de código, então é hora de baixar um editor de código!
-
-Existem muitos editores diferentes e em grande parte se resume a preferência pessoal. A maioria dos programadores Python usa as complexas, mas extremamente poderosas IDEs (Integrated Development Environments, ou em português, Ambiente de desenvolvimento Integrado), tais como PyCharm. Para um iniciante, entretanto, estas IDE's são menos convenientes; nossas recomendações são bem mais simples, porém, igualmente poderosas.
-
-Nossas sugestões estão abaixo, mas sinta-se livre para perguntar ao seu coach quais são as suas preferências - assim vai ser mais fácil obter a ajuda deles.
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
 
 ## Gedit
 
-Gedit é um editor open-source, gratuito, disponível para todos os sistemas operacionais.
-
-[Baixe aqui][1]
+Gedit is an open-source, free editor, available for all operating systems.
 
- [1]: https://wiki.gnome.org/Apps/Gedit#Download
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
 
 ## Sublime Text 3
 
-Sublime Text 3 é um editor muito popular com um período de avaliação gratuita. É fácil de instalar e usar, e está disponível para todos os sistemas operacionais.
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
 
-[Baixe aqui][2]
-
- [2]: https://www.sublimetext.com/3
+[Download it here](https://www.sublimetext.com/3)
 
 ## Atom
 
-Atom é um novo editor de código criado pelo [GitHub][3]. Ele é gratuito, open-source, fácil de instalar e fácil de usar. Está disponível para Windows, OSX e Linux.
-
- [3]: https://github.com/
-
-[Baixe aqui][4]
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
 
- [4]: https://atom.io/
+[Download it here](https://atom.io/)
 
-# Por que estamos instalando um editor de código?
+## Why are we installing a code editor?
 
-Você deve estar se perguntando porque estamos instalando esse software editor de código especial ao invés de usar algo como Word ou Bloco de Notas.
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
 
-Primeiro é que código precisa ser ** texto sem formatação **, e o problema com programas como Word e Textedit é que eles na verdade não produzem texto sem formatação, eles fazem "rich text" (com fontes e formatação), usando formatos personalizados como RTF.
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
 
-A segunda razão é que editores de código são especializados em editar código, então eles podem oferecer recursos úteis, como realce de código com cores de acordo com o seu significado, ou automaticamente fechar citações para você.
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
 
-Nós vamos ver isso em ação depois. Em breve você terá seu editor de código como uma das suas ferramentas favoritas. :)
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/pt/deploy/README.md b/pt/deploy/README.md
index 6460c2d78fd..b44e2eaaf73 100755
--- a/pt/deploy/README.md
+++ b/pt/deploy/README.md
@@ -1,319 +1,260 @@
-# Implantação!
+# Deploy!
 
-> **Nota** O capítulo seguinte pode ser, às vezes, um pouco difícil de percorrer. Persista e termine-o; Implantação é uma parte importante do processo de desenvolvimento de website. Este capítulo está localizado no meio do tutorial para que sua tutora possa lhe ajudar com o processo ligeiramente complexo de colocar seu site online. Isto significa que você ainda pode terminar o tutorial por conta própria se você não tiver tempo.
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
 
-Até agora, seu site só estava disponível no seu computador. Agora você vai aprender como publicar ele na internet! A implantação é o processo de publicação do seu aplicativo na Internet de tal forma que as pessoas possam, finalmente, ver seu aplicativo :).
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
 
-Como você aprendeu, um website precisa estar localizado num servidor. Existem muitos provedores, mas iremos utilizar o que tem um processo de deploy relativamente simples: [PythonAnywhere](https://pythonanywhere.com/). PythonAnywhere é gratuito para aplicações pequenas que não possuem muitos visitantes, então será suficiente para você por enquanto.
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
-O outro serviço externo que usaremos é [GitHub](https://www.github.com), que é um serviço de hospedagem de código. Existem outros, mas muitas das pessoas que programam possuem uma conta no GitHub atualmente e agora você também!
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
 
-Esses três locais serão importantes para você. Seu computador local será o local aonde você faz o desenvolvimento e testes. Quando você estiver satisfeita com as mudanças, você colocará uma cópia de seu programa no GitHub. Seu website estará no PythonAnywhere e você irá atualizá-lo pegando uma nova cópia de seu código a partir do GitHub.
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
 
 # Git
 
-> **Nota** Se você já passou pelos passos de Instalação, não há necessidade de fazer isso novamente – você pode pular para a
-próxima seção e começar a criar seu repositório Git.
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
 
 {% include "/deploy/install_git.md" %}
 
-## Começando nosso repositório no Git
+## Starting our Git repository
 
-Git controla as alterações para um determinado conjunto de arquivos no que chamamos de repositório de código (ou "repo"). Vamos começar um para nosso projeto. Abra o console e execute esses comandos, no diretório `djangogirls`:
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
 
-> **Nota**: Verifique o seu diretório de trabalho atual com um `pwd` (OSX/Linux) ou o comando `cd` (Windows) antes de inicializar o repositório. Você deve estar na pasta `djangogirls`.
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
 
 {% filename %}command-line{% endfilename %}
-```
-$ git init
-Initialized empty Git repository in ~/djangogirls/.git/
-$ git config --global user.name "Your Name"
-$ git config --global user.email you@example.com
-```
 
-Inicializar o repositório git é algo que só precisamos fazer uma vez por projeto (e você não terá que re-introduzir o nome de usuário e e-mail nunca mais)
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
 
-Git irá controlar as alterações para todos os arquivos e pastas neste diretório, mas existem alguns arquivos que queremos ignorar. Fazemos isso através da criação de um arquivo chamado `.gitignore` no diretório base. Abra seu editor e crie um novo arquivo com o seguinte conteúdo:
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
 
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
 
 {% filename %}.gitignore{% endfilename %}
-```
-*.pyc
-*~
-__pycache__
-myvenv
-db.sqlite3
-/static
-.DS_Store
-```
-
-E salve como `.gitignore` na pasta "djangogirls".
-
-> **Nota**: O ponto no início do nome do arquivo é importante! Se você está tendo alguma dificuldade em criá-la (Macs não gostam de criar arquivos que começam com um ponto através do Finder, por exemplo), use o recurso "Save As" no seu editor que sempre funciona.
-
-> **Nota** Um dos arquivos que você especificou em seu arquvio `.gitignore` é o `db.sqlite3`. Esse arquivo é o seu banco de
-dados local, aonde todos as suas postagens estão armazenadas. Nós não queremos adicionar isso no seu repositório porquê seu
-website no PythonAnywhere estará usando um banco de dados diferente. Esse banco de dados poderia ser o SQLite, como na sua
-máquina de desenvolvimento, mas geralmente você irá usar um chamado MySQL, o qual pode lidar com muito mais visitantes que o
-SQLite. De qualquer forma, ignorar seu banco de dados SQLite na cópia no GitHub, significa que todos as  postagens que você
-criou até agora vão ficar disponíceis apenas localmente, e você terá que adicioná-las novamente em produção. Você deve pensar no seu banco de dados local como um bom "playground", onde você pode testar coisas diferentes e não ter medo de apagar as
-postagens reais de seu blog.
-
-É uma boa idéia para usar um comando de `git status` antes de `git add` ou sempre que você não tiver certeza do que foi alterado. Isso previne que surpressas aconteçam, tais como adicionar ou fazer "commit" de arquivos errados. O comando `git status` retorna informações sobre qualquer arquivo "untracked/modified/staged" (não rastreado/modificado/encenado), status da branch e muito mais. A saída deve ser semelhante a:
 
-{% filename %}command-line{% endfilename %}
-```
-$ git status
-On branch master
-
-Initial commit
-
-Untracked files:
-  (use "git add <file>..." to include in what will be committed)
-
-        .gitignore
-        blog/
-        manage.py
-        mysite/
-
-nothing added to commit but untracked files present (use "git add" to track)
-```
-
-E finalmente nós salvamos nossas alterações, Vá para o seu console e execute estes comandos:
-
-{% filename %}command-line{% endfilename %}
-```
-$ git add --all .
-$ git commit -m "My Django Girls app, first commit"
- [...]
- 13 files changed, 200 insertions(+)
- create mode 100644 .gitignore
- [...]
- create mode 100644 mysite/wsgi.py
- ```
- 
-## Empurrando o nosso código para GitHub
-
-Vá para [GitHub.com](https://www.github.com) e cadastre uma nova e gratuita conta de usuário. (Se você já fez isso na preparação
-no workshop, parabéns!)
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
 
-Em seguida, crie um novo repositório, e dê o nome "my-first-blog". Deixe o "initialise with a README" desmarcado, deixe a opção .gitignore em branco (já fizemos isso manualmente) e a licença como None.
+And save it as `.gitignore` in the "djangogirls" folder.
 
-<img src="images/new_github_repo.png" />
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
 
-> **Nota** O nome `my-first-blog` é importante -- você poderia escolher outra coisa, mas vamos usá-lo muitas vezes nas instruções abaixo e você teria que substituí-lo cada vez. É provavelmente mais fácil ficar com o nome `my-first-blog`.
-
-Na tela seguinte, você será mostrada um clone da URL do seu repo. Escolha a versão "HTTPS",copie, e vamos colá-la no terminal em breve:
-
-<img src="images/github_get_repo_url_screenshot.png" />
-
-Agora precisamos conectar o repositório Git no seu computador com o no GitHub.
-
-Digite o seguinte em seu console (Substitua `<your-github-username>` pelo nome de usuário que você usou quando criou sua conta
-no GitHub, mas sem os sinais `<` e `>`):
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
 
 {% filename %}command-line{% endfilename %}
-```
-$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
-$ git push -u origin master
-```
-
-Digite seu GitHub username e senha, e você deve ver algo como isto:
 
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
 
 {% filename %}command-line{% endfilename %}
-```
-Username for 'https://github.com': hjwp
-Password for 'https://hjwp@github.com':
-Counting objects: 6, done.
-Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
-Total 3 (delta 0), reused 0 (delta 0)
-To https://github.com/hjwp/my-first-blog.git
- * [new branch]      master -> master
-Branch master set up to track remote branch master from origin.
-```
-
-<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extention -->
-
-Seu código agora está no GitHub. Vá e confira! Você irá descobrir que está em boa companhia - [Django](https://github.com/django/django), o [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial) e muitos outros grandes projetos de software de código aberto também hospedam seu código no GitHub :)
-
-# Criação de nosso blog em PythonAnywhere
-
-> **Nota** Você já deve ter criado uma conta no PythonAnywhere anteriormente, durante os passos de instalação – se sim, não é
-preciso fazer isso novamente
 
-{% include "/deploy/signup_pythonanywhere.md" %}
-
-## Puxando nosso código para a PythonAnywhere
-
-Quando você se inscreve para PythonAnywhere, você é levado ao seu painel de controle ou página "Consoles". Escolha a opção para iniciar o console "Bash" -- que é a versão PythonAnywhere de um console, como aquela no seu PC
-
-> **Nota**: PythonAnywhere é baseado em Linux, assim se você estiver no Windows o console vai parecer um pouco diferente do que está no seu computador.
-
-Vamos puxar nosso código a partir do GitHub para a PythonAnywhere através da criação de um "clone" do repo. Digite o seguinte no console da PythonAnywhere (não se esqueça de usar seu nome de usuário no lugar de `<your-github-username>`):
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-{% filename %}PythonAnywhere command-line{% endfilename %}
-```
 $ git clone https://github.com/<your-github-username>/my-first-blog.git
-```
-
-Isto puxará uma cópia do seu código para PythonAnywhere. Confira digitando:
-
-{% filename %}PythonAnywhere command-line{% endfilename %}
-```
-$ tree my-first-blog
-my-first-blog/
-├── blog
-│   ├── __init__.py
-│   ├── admin.py
-│   ├── migrations
-│   │   ├── 0001_initial.py
-│   │   └── __init__.py
-│   ├── models.py
-│   ├── tests.py
-│   └── views.py
-├── manage.py
-└── mysite
-    ├── __init__.py
-    ├── settings.py
-    ├── urls.py
-    └── wsgi.py
-```
-
-### Criando um virtualenv na PythonAnywhere
-
-Assim como fez em seu próprio computador, você pode criar um virtualenv na PythonAnywhere. No console Bash, digite:
-
 
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
     {% filename %}PythonAnywhere command-line{% endfilename %}
-    20:20 ~ $ cd my-first-blog
-
-    20:20 ~ $ virtualenv --python=python3.5 myvenv
-    Running virtualenv with interpreter /usr/bin/python3.5
-    [...]
-    Installing setuptools, pip...done.
-
-    20:20 ~ $ source myvenv/bin/activate
-
-    (mvenv)20:20 ~ $ pip install django~=1.11.0 whitenoise~=2.0
-    Collecting django
-    [...]
-    Successfully installed django-1.11.5 whitenoise-2.0
-
-> **Nota** O passo `pip install` pode levar alguns minutos.  Paciência, paciência! Mas se levar mais de cinco minutos, algo
-está errado. Pergunte a sua treinadora.
-
-### Coleta de arquivos estáticos.
-
-Você estava imaginando o que é "whitenoise"? É uma ferramenta para servir os chamados "arquivos estáticos". Arquivos estáticos funcionam de forma diferente nos servidores em comparação com nosso próprio computador, e precisamos de uma ferramenta como o "whitenoise" para atendê-los.
-
-Vamos descobrir um pouco mais sobre arquivos estáticos mais tarde no tutorial, quando vamos editar o CSS para o nosso site.
-
-Por enquanto só precisamos executar um comando extra chamado "collectstatic" no servidor. Isso diz pro Django reunir todos os arquivos estáticos que ele precisa no servidor. Em sua maioria, estes são os arquivos estáticos que fazem o site do admin bonito no momento.
-
-    20:20 ~ $ python manage.py collectstatic
-
-    You have requested to collect static files at the destination
-    location as specified in your settings:
-
-        /home/edith/my-first-blog/static
+    
 
-    This will overwrite existing files!
-    Are you sure you want to do this?
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
 
-    Type 'yes' to continue, or 'no' to cancel: yes
-
-
-### Criando o banco de dados em PythonAnywhere
-
-Aqui está outra coisa que é diferente entre seu computador e o servidor -- ele usa um banco de dados diferente. Então as contas de usuário e postagens podem ser diferentes no servidor e no seu computador.
-
-Nós podemos inicializar o banco de dados no servidor da mesma maneira que fizemos em nosso próprio computador, com `migrate` e  `createsuperuser`:
-
-{% filename %}PythonAnywhere command-line{% endfilename %}
-```
-(mvenv) $ python manage.py migrate
-Operations to perform:
-[...]
-  Applying sessions.0001_initial... OK
-(mvenv) $ python manage.py createsuperuser
-```
-
-## Publicando nosso blog como um aplicativo web
-
-Agora nosso código está na PythonAnywhere, nossa virtualenv está pronta e o banco de dados está inicializado, estamos prontos para publicá-lo como um aplicativo da web!
-
-Clique em voltar para o painel de controle da PythonAnywhere clicando no seu logotipo e clique na guia **Web**. E finalmente
-aperte **Add a new web app**.
-
-Após a confirmação de seu nome de domínio, escolha **manual configuration** (N.B. -  *não* a opção "Django") na caixa de diálogo. Em seguida, escolha **Python 3.5** e clique em "Next" para concluir o assistente.
-
-> **Nota** certifique-se de escolher a opção "Manual configuration", não a "Django". Nós somos demais para o padrão de configuração Django da PythonAnywhere ;-)
-
-### Definindo o virtualenv
-
-Você será levado para a tela de configuração da PythonAnywhere para seu webapp, que é onde você precisará de ir quando quiser fazer alterações no aplicativo no servidor.
-
-<img src="images/pythonanywhere_web_tab_virtualenv.png" />
-
-Na seção "Virtualenv", clique no texto vermelho que diz "Enter the path to a virtualenv" e digite: `/home/<your-PythonAnywhere-username>/my-first-blog/myvenv/`.  Clique na caixa azul com a "checkmark" (marca de seleção) para salvar o "path" (caminho) antes de proseguir.
-
-> **Nota**: substitua seu próprio nome de usuário PythonAnywhere conforme apropriado. Se você cometer um erro, PythonAnywhere irá mostrar um pequeno aviso.
-
-### Configurando o arquivo WSGI
-
-Django funciona usando o "WSGI protocol", um padrão para servir sites usando Python, que tem suporte na PythonAnywhere. A maneira que configuramos PythonAnywhere para reconhecer nosso blog Django é editando um arquivo de configuração do WSGI.
-
-Clique no link "WSGI configuration file" (na seção "Code" perto do topo da página - -ele vai ser nomeado algo como `/var/www/<your-username>_pythonanywhere_com_wsgi.py`), e você será levada para um editor.
-
-Apague todo o conteúdo atual e substitua com algo parecido com isto:
-
-{% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
-```python
-import os
-import sys
-
-path = '/home/<your-PythonAnywhere-username>/my-first-blog'  # use your own PythonAnywhere username here
-if path not in sys.path:
-    sys.path.append(path)
-
-os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
-
-from django.core.wsgi import get_wsgi_application
-from django.contrib.staticfiles.handlers import StaticFilesHandler
-application = StaticFilesHandler(get_wsgi_application())
-```
-
-> **Nota** não se esqueça de substituir por seu próprio nome de usuário PythonAnywhere onde diz `<your-username>`
-> **Nota** Na linha quatro, nós nos certificamos que Python anywhere saiba como encontrar nossa aplicação. É muito importante
-que esse nome "path" (caminho) esteja correto, e especiamente que não exista espaços extras aqui. Senão você verá um "ImportError" no registro de erro.
-
-O que esse arquivo faz é dizer PythonAnywhere onde mora a nossa aplicação web e qual o nome do arquivo de configurações Django.
-
-O `StaticFilesHandler` é para lidar com o nosso CSS. Isso é cuidado automaticamente para você, durante o desenvolvimento local,
-executando o comando `runserver`. Nós falaremos um pouco mais sobre arquivos estáticos mais tarde nesse tutorial, quando editarmos o CSS para o nosso site.
-
-
-Aperte **Save** e então volte para a guia **Web**.
-
-Já terminamos! Aperte o grande botão verde de **Reload**e você será capaz de ir ver o seu aplicativo. Você encontrará um link para ele no topo da página.
-
-## Dicas de debugging
-
-Se você ver um erro quando você tentar visitar o seu site, o primeiro lugar para procurar alguma informação de debugging é no seu **error log** -- você encontrará um link para isso em  PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). Veja se há mensagens de erro lá. As mais recentes estão na parte inferior. Problemas comuns incluem:
-
--  esquecer um dos passos que fizemos no console: criando o virtualenv, ativá-lo, instalando o Django nele, migrando o banco de dados
-- cometer um erro no "path" (caminho) do virtualenv na guia web -- haverá geralmente uma pequena mensagem de erro vermelha lá, se há um problema.
-- Você usou a mesma versão do Python para seu virtualenv e para sua app web? Ambas devem ser 3.5. 
-
-Existem também alfumas [dicas gerais de debugging no wiki da PythonAnywhere](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-E lembre-se, sua treinadora está aqui para ajudar!
+$ cd my-first-blog
 
-# Você está ao vivo!
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
 
-A página padrão para seu site deve dizer "Bem-vindo ao Django", como acontece no seu PC local. Tente adicionar `/admin/` no final da URL, e você será levado a administração do site. Faça login com o nome de usuário e senha, e você verá que você pode adicionar novas postagens no servidor.
+$ source myvenv/bin/activate
 
-Uma vez que você tenha algumas postagens criadas, você pode voltar para sua configuração local (não no PythonAnywhere). A partir de agora você deve trabalhar em sua configuração local para fazer mudanças. Esse é o fluxo de trabalho comum no desenvolvimento web – fazer alterações localmente, enviar essas mudanças para o GitHub, e mandar suas alterações para o seu servidor Web de produção. Isso permite você trabalhar e experimentar sem quebrar seu site Web que está online. Muito legal, não é?
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
 
-Dê em você mesma um *enorme* tapinha nas costas - implantações de servidor são uma das partes mais difíceis do desenvolvimento web, e muitas vezes leva dias antes de fazer funcionar. Mas você tem seu site publicado, na Internet, simples assim!
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/pt/deploy/install_git.md b/pt/deploy/install_git.md
index fc8b553b2b7..e7d88e0ffb4 100644
--- a/pt/deploy/install_git.md
+++ b/pt/deploy/install_git.md
@@ -1,65 +1,52 @@
-Git é um "sistema de controle de versão" usado por muitos programadores - um software que controla mudanças nos arquivos ao longo 
-do tempo para que você possa recuperar versões específicas depois. Um pouco parecido com o recurso de "controlar mudanças" no 
-Microsoft Word, mas muito mais poderoso.
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
 
-## Instalando o Git
+## Installing Git
 
-<!--sec data-title="Windows" data-id="git_install_windows"
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
 data-collapse=true ces-->
 
-Você pode baixar o Git em [git-scm.com](https://git-scm.com/). Você pode apertar "next next next" em todos os passos exceto um; no 
-quinto passo, chamado "Adjusting your PATH environment", escolha "Use Git and optional Unix tools from the Windows Command Prompt"
-(a última opção). Para as outras opções, o padrão está ótimo. Checkout Windows-style, commit Unix-style line endings funcionam
-bem.
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
 
-<!--endsec-->
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
 
-<!--sec data-title="OS X" data-id="git_install_OSX"
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
 data-collapse=true ces-->
 
-Baixe o Git em [git-scm.com](https://git-scm.com/) e siga as instruções.
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
 
-> **Nota** Se você estiver rodando o OS X 10.6, 10.7, or 10.8, você vai precisar instalar a versão do Git daqui: 
-[INstalador do Git para OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
 
 <!--endsec-->
 
-<!--sec data-title="Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
 data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
+
 ```bash
 $ sudo apt-get install git
 ```
 
 <!--endsec-->
 
-<!--sec data-title="Fedora (up to 21)" data-id="git_install_fedora_21"
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
 data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```bash
-$ sudo yum install git
-```
-
-<!--endsec-->
 
-<!--sec data-title="Fedora 22+" data-id="git_install_fedora_22"
-data-collapse=true ces-->
-
-{% filename %}command-line{% endfilename %}
 ```bash
 $ sudo dnf install git
 ```
 
 <!--endsec-->
 
-<!--sec data-title="openSUSE" data-id="git_install_openSUSE"
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
 data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
+
 ```bash
 $ sudo zypper install git
 ```
 
-<!--endsec-->
+<!--endsec-->
\ No newline at end of file
diff --git a/pt/deploy/signup_pythonanywhere.md b/pt/deploy/signup_pythonanywhere.md
index 423680abc66..ca66bd0de69 100644
--- a/pt/deploy/signup_pythonanywhere.md
+++ b/pt/deploy/signup_pythonanywhere.md
@@ -1,7 +1,5 @@
-Em seguida, é hora de se inscrever com uma conta "Beginner" na PythonAnywhere.
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
 
 * [www.pythonanywhere.com](https://www.pythonanywhere.com/)
 
-> **Nota** ao escolher seu nome de utilizador aqui, tenha em mente que a URL do seu blog terá a forma `yourusername.pythonanywhere.com`,
-então escolha seu nickname ou o nome que escolher para o blog.
-
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/pt/django/README.md b/pt/django/README.md
index 418fc3c7262..c62c145305b 100755
--- a/pt/django/README.md
+++ b/pt/django/README.md
@@ -1,33 +1,27 @@
-# O que é Django?
+# What is Django?
 
-Django (/ˈdʒæŋɡoʊ/ _jang-goh_) é um framework gratuito e de código aberto para a criação de aplicações web, escrito em Python. É um framework web, ou seja, é um conjunto de componentes que ajuda a desenvolver sites de forma mais rápida e mais fácil.
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
 
-Veja, quando você está construindo um site, você sempre precisa de um conjunto similar de componentes: uma maneira de lidar com
-a autenticação do usuário (inscrever-se, realizar login, realizar logout), um painel de gerenciamento para o seu site,
-formulários, upload de arquivos, etc.
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
 
-Felizmente para você, há tempos atrás, outras pessoas notaram várias semelhanças nos problemas enfrentados pelos desenvolvedores web quando estão criando um novo site, então eles uniram-se e criaram os frameworks (Django é um deles) que lhe dão componentes prontos, que você pode usar.
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
 
-Frameworks existem para salvar você de ter que reinventar a roda e ajudam a aliviar a sobrecarga quando você está construindo um
-novo site.
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
 
-## Por que você precisa de um framework?
+## Why do you need a framework?
 
-Para entender o que o Django é na verdade, precisamos olhar mais de perto os servidores. A primeira coisa é que um servidor precisa saber é que você quer ele para disponibilizar uma página da Web.
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
 
-Imagine uma caixa de correio (porta) que é monitorada por cartas recebidas (requisição). Isso é feito por um servidor web. O servidor web lê a carta e envia uma resposta com uma página web. Mas, quando você quer enviar alguma coisa, você precisa ter um
-conteúdo. E o Django é aquilo que vai lhe ajudar a criar esse conteúdo.
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
 
-## O que acontece quando alguém solicita um site do seu servidor?
+## What happens when someone requests a website from your server?
 
-Quando chega uma requisição para o servidor web, ela é passada para o Django, que tenta descobrir do que ela se trata. Primeiro
-ele pega o endereço web e tenta descobrir o que fazer. Essa parte é feita pelo **urlresolver** do Django. (Note que o endereço de um site se chama URL - Uniform Resource Locator, em português Localizador de Recursos Uniforme, dessa forma o nome *urlresolver*, ou resolvedor de urls, faz sentido). Isso não é muito complexo - ele pega uma lista de padrões e tenta corresponder com a URL. O Django verifica os padrões de cima para baixo e, se algo é correspondido, passa a solicitação para a função associada (que é chamada *view*).
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
 
-Imagine os Correios entregando uma carta. Uma funcionária vai andando por uma determinda rua e verificando o número de cada casa
-com o que está na carta. Se ele corresponder, ela coloca a carta lá. É assim que funciona o urlresolver!
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
 
-Todas as coisas interessantes são feitas dentro da *view*: podemos dar uma olhada no banco de dados para procurar algumas informações. Talvez o usuário queira mudar algo nos dados? Como uma carta dizendo: "Por favor mude a descrição do meu emprego." - a *view* checa se você tem permissão para fazer isso e então atualiza a descrição do emprego pra você, enviando em seguida uma mensagem: "Feito!". Então a *view* gera uma resposta e o Django pode enviá-la para o navegador web do cliente.
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
 
-Claro, a descrição acima é muito simplificada, mas você não precisa saber detalhes técnicos ainda. Ter uma ideia geral já é suficiente.
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
 
-Então, em vez de mergulhar em muitos detalhes, nós simplesmente vamos começar criando algo com o Django e aprenderemos todas as partes importantes ao longo do caminho!
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/pt/django_admin/README.md b/pt/django_admin/README.md
index ab2564602b5..46a5afbb500 100755
--- a/pt/django_admin/README.md
+++ b/pt/django_admin/README.md
@@ -1,10 +1,11 @@
-# Administração
+# Django admin
 
-Para adicionar, editar e remover postagens que nós criamos usaremos o Django admin.
+To add, edit and delete the posts we've just modeled, we will use Django admin.
 
-Vamos abrir o arquivo `blog/admin.py` e substituir seu conteúdo por:
+Let's open the `blog/admin.py` file and replace its contents with this:
 
 {% filename %}blog/admin.py{% endfilename %}
+
 ```python
 from django.contrib import admin
 from .models import Post
@@ -12,39 +13,45 @@ from .models import Post
 admin.site.register(Post)
 ```
 
-Como você pode ver, nós importamos (incluímos) o modelo Post definido no capítulo anterior. Para tornar nosso modelo visível na página de administração, nós precisamos registrá-lo com: `admin.site.register(Post)`.
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
 
-OK, hora de olhar para o nosso modelo de Post. Lembre-se de executar `python manage.py runserver` no console para executar o servidor web. Vá para o navegador e digite o endereço http://127.0.0.1:8000/admin/ Você verá uma página de login assim:
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
 
-![Página de login](images/login_page2.png)
+![Login page](images/login_page2.png)
 
-Para fazer login você precisa criar um *superuser* - um usuário que possui controle sobre tudo no site. Volte para o terminal e digite `python manage.py createsuperuser`, pressione enter.
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
 
-> Lembre-se, para escrever novos comandos enquanto o servidor web estiver rodando, abra um novo terminal e ative seu ambiente
-virtual. Nós revisamos como escrever novos comandos no capítulo <b>Seu primeiro projeto Django!</b>, na seção <b>Iniciando o servidor web</b>.
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
 
-Quando perguntado, digite seu nome de usuário (minúsculas, sem espaços), endereço de email, e senha. Não se preocupe que você não pode ver a senha que você está digitando - é assim que deve ser. Apenas digite e pressione `enter` para continuar. A saída deve parecer com essa (onde username e email devem ser os seus):
+{% filename %}Mac OS X or Linux:{% endfilename %}
 
-{% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py createsuperuser
-Username: admin
-Email address: admin@admin.com
-Password:
-Password (again):
-Superuser created successfully.
-```
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
 
-Volte para a o navegador e faça login com as credenciais de superuser que você escolheu, você deve visualizar o painel de controle do Django admin.
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
 
-![Administração do Django](images/django_admin3.png)
+![Django admin](images/django_admin3.png)
 
-Vá para as postagens e experimente um pouco com elas. Adicione cinco ou seis postagens. Não se preocupe com o conteúdo - você pode copiar e colar algum texto deste tutorial para o conteúdo para economizar tempo :).
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
 
-Certifique-se que pelo menos duas ou três postagens (mas não todas) tenham a data de publicação definida. Isso será útil depois.
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
 
-![Administração do Django](images/edit_post3.png)
+![Django admin](images/edit_post3.png)
 
-Se você quiser saber mais sobre o Django admin, você deve conferir a documentação do Django: https://docs.djangoproject.com/en/1.9/ref/contrib/admin/
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
 
-Este é provavelmente um bom momento para tomar um café (ou chá) ou comer alguma coisa para repor as energias. Você criou seu primeiro modelo de Django - você merece um pouco de descanso!
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/pt/django_forms/README.md b/pt/django_forms/README.md
index bb825cf8d03..1d9efebffe4 100755
--- a/pt/django_forms/README.md
+++ b/pt/django_forms/README.md
@@ -1,22 +1,23 @@
-# Formulários do Django
+# Django Forms
 
-Por último, queremos uma forma legal de adicionar e editar as postagens do nosso blog. A `ferramenta de administração` do Django é legal, mas ela é um pouco difícil de customizar e de deixar mais bonita. Se usarmos `formulários` teremos controle absoluto sobre nossa interface - podemos fazer qualquer coisa que imaginarmos!
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
 
-Uma coisa legal do Django é que nós podemos tanto criar um formulário do zero como podemos criar um `ModelForm` que salva o resultado do formulário para um determinado modelo.
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
 
-Isso é exatamente o que nós queremos fazer: criaremos um formulário para o nosso modelo `Post`.
+This is exactly what we want to do: we will create a form for our `Post` model.
 
-Assim como toda parte importante do Django, os formulários tem seu próprio arquivo: `forms.py`.
+Like every important part of Django, forms have their own file: `forms.py`.
 
-Precisamos criar um arquivo com este nome dentro da pasta `blog`.
+We need to create a file with this name in the `blog` directory.
 
     blog
        └── forms.py
+    
 
-
-Ok, vamos abri-lo e escrever nele o seguinte:
+OK, let's open it and type the following code:
 
 {% filename %}blog/forms.py{% endfilename %}
+
 ```python
 from django import forms
 
@@ -26,35 +27,37 @@ class PostForm(forms.ModelForm):
 
     class Meta:
         model = Post
-        fields = ('title', 'text')
+        fields = ('title', 'text',)
 ```
 
-Primeiro precisamos importar o módulo de formulários do Django (`from django import forms`) e, obviamente, nosso modelo `Post` (`from .models import Post`).
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
 
-`PostForm`, como você já deve suspeitar, é o nome do nosso formulário. Precisamos dizer ao Django que este formulário é um `ModelForm` (assim o Django pode fazer a mágica pra gente) - o `forms.ModelForm` é o responsável por isso.
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
 
-Segundo, nós temos a classe `Meta` onde dizemos ao Django qual modelo deveria ser usado para criar este formulário (`model = Post`).
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
 
-Finalmente, nós podemos dizer qual(is) campo(s) deveriam entrar em nosso formulário. Nesse cenário nós queremos apenas o `title` e `text` para ser exposto - `author` deveria ser a pessoa que está logada no sistema (nesse caso, você!) e `created_date` deveria ser setado automaticamente quando nós criamos um post (no código), correto?
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
 
-E é isso aí! Tudo o que precisamos fazer agora é usar o formulário em uma *view* e mostrá-lo em um template.
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
 
-Então, mais uma vez, nós iremos criar: um link para a página, uma URL, uma view e um template.
+So once again we will create a link to the page, a URL, a view and a template.
 
-## Link para a página com o formulário
+## Link to a page with the form
 
-É hora de abrir `blog/templates/blog/base.html`. Nós iremos adicionar um link na `div` de nome `page-header`:
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Note que nós queremos chamar nossa nova view de `post_new`.
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
 
-Depois de adicionar a linha, seu html deve se parecer com isso:
+After adding the line, your HTML file should now look like this:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -82,20 +85,22 @@ Depois de adicionar a linha, seu html deve se parecer com isso:
 </html>
 ```
 
-Depois de salvar e recarregar a página `http://127.0.0.1:8000` você verá, obviamente, um erro familiar: `NoReverseMatch`, certo?
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
 
 ## URL
 
-Vamos abrir o arquivo `blog/urls.py` e escrever:
+We open `blog/urls.py` and add a line:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 url(r'^post/new/$', views.post_new, name='post_new'),
 ```
 
-O código final deve se parecer com isso:
+And the final code will look like this:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
@@ -107,42 +112,45 @@ urlpatterns = [
 ]
 ```
 
-Após atualizar o site, nós veremos um `AttributeError`, já que nós não ainda temos a view `post_new` implementada. Vamos adicioná-la agora.
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
 
-## A view post_new
+## post_new view
 
-Hora de abrir o arquivo `blog/views.py` e adicionar as linhas seguintes com o resto das linhas `from`:
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from .forms import PostForm
 ```
 
-e então a nossa *view*:
+And then our *view*:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_new(request):
     form = PostForm()
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Para criar um novo formulario `Post`, nós devemos chamar `PostForm()` e passá-lo para o template. Nós voltaremos para esta *view*, mas por agora, vamos criar rapidamente um template para o formulário.
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
 
-## Template (modelos)
+## Template
 
-Precisamos criar um arquivo `post_edit.html` na pasta `blog/templates/blog`. Pra fazer o formulário funcionar precisamos de muitas coisas:
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
 
-- Temos que exibir o formulário. Podemos fazer isso com (por exemplo) um simplesmente {% raw %}`{{ form.as_p }}`{% endraw %}.
-- A linha acima precisa estar entre as tags HTML form: `<form method="POST">...</form>`
-- Precisamos de um botão `Salvar`. Fazemos isso com um botão HTML: `<button type="submit">Save</button>`
-- E finalmente, depois de abrir a tag `<form ...>` precisamos adicionar um {% raw %}`{% csrf_token %}`{% endraw %}. Isso é muito importante, pois faz com que nosso formulário seja seguro! O Django vai reclamar se você esquecer de adicionar isso e tentar salvar o formulário:
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
 
-![CSFR Página Proibida](images/csrf2.png)
+![CSFR Forbidden page](images/csrf2.png)
 
-Beleza, então vamos ver como ficou o HTML `post_edit.html`:
+OK, so let's see how the HTML in `post_edit.html` should look:
 
 {% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -155,32 +163,34 @@ Beleza, então vamos ver como ficou o HTML `post_edit.html`:
 {% endblock %}
 ```
 
-Hora de atualizar! Há! Seu formulário apareceu!
+Time to refresh! Yay! Your form is displayed!
 
-![Formulário novo](images/new_form2.png)
+![New form](images/new_form2.png)
 
-Mas, espere um minuto! Quando você digita alguma coisa nos campos `title` e `text` e tenta salvar, o que acontece?
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
 
-Nada! Estamos novamente na mesma página e nosso texto sumiu... E nenhum post foi adicionado. Então o que deu errado?
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
 
-A resposta é: nada. Precisamos trabalhar um pouco mais na nossa *view*.
+The answer is: nothing. We need to do a little bit more work in our *view*.
 
-## Salvando o formulário
+## Saving the form
 
-Abra `blog/views.py` mais uma vez. Atualmente tudo que temos na visão `post_new` é:
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_new(request):
     form = PostForm()
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Quando nós enviamos o formulário, somos trazidos de volta para a mesma visão, mas desta vez temos mais alguns dados no `request`, mais especificamente em `request.POST` (o nome não tem nada com uma "postagem" de blog , tem a ver com o fato de que estamos "postando" dados). Você se lembra que no arquivo HTML nossa definição de ` <form> ` tem a variável `method="POST"`? Todos os campos vindos do "form" estarão disponíveis agora em `request.POST`. Você não deveria renomear `POST` para nada diferente disso (o único outro valor válido para `method` é `GET`, mas nós não temos tempo para explicar qual é a diferença).
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
 
-Então, na nossa *view*, nós temos duas situações separadas para lidar. A primeira é quanto acessamos a página pela primeira vez e queremos um formulário em branco. E a segunda, é quando nós temos que voltar para a *view* com todos os dados do formulário que nós digitamos. Desse modo, precisamos adicionar uma condição (usaremos `if` para isso).
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 if request.method == "POST":
     [...]
@@ -188,18 +198,20 @@ else:
     form = PostForm()
 ```
 
-Está na hora de preencher os pontos`[...]`. Se `method` é `POST` então nós queremos construir o `PostForm` com os dados que veem do formulário, certo? Nós iremos fazer assim:
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 form = PostForm(request.POST)
 ```
 
-Fácil! A próxima coisa é verificar se o formulário está correto(todos os campos requeridos estão definidos e nenhum valor incorreto foi enviado). Fazemos isso com `form.is_valid()`.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
 
-Verificamos se o formulário é válido e se estiver tudo certo, podemos salvá-lo!
+We check if the form is valid and if so, we can save it!
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 if form.is_valid():
     post = form.save(commit=False)
@@ -208,27 +220,30 @@ if form.is_valid():
     post.save()
 ```
 
- Basicamente, temos duas coisas aqui: salvamos o formulário com `form.save` e adicionados um autor(já que não tinha o campo `author` em `PostForm`, e este campo é obrigatório!). `commit=False` significa que não queremos salvar o modelo `Post` ainda - queremos adicionar autor primeiro. Na maioria das vezes você irá usar `form.save()`, sem `commit=False`, mas neste caso, precisamos fazer isso. `post.save()` irá preservar as alterações (adicionando o autor) e será criada uma nova postagem no blog!
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
 
-Finalmente, seria fantástico se nós pudéssemos imediatamente ir à página `post_detail` da nossa recém-criada postagem no blog, certo? Para fazer isso nós precisamos fazer mais um import:
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import redirect
 ```
 
-Adicione-o logo no início do seu arquivo. E agora podemos dizer: vá para a página `post_detail` da recém-criada postagem.
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 return redirect('post_detail', pk=post.pk)
 ```
 
-`blog.views.post_detail` é o nome da view para qual queremos ir. Lembra que essa *view* exige uma variável `pk`? Para passar ela para `views` usamos `pk=post.pk`, onde post é a recém-criada postagem no blog.
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
 
-Ok, nós falamos muito, mas provavelmente queremos ver como toda a *view* se parece agora, certo?
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_new(request):
     if request.method == "POST":
@@ -244,40 +259,42 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Vamos ver se funciona. Vá para o página http://127.0.0.1:8000/post/new/, adicione um `title` e o `text`, salve... e voilà! O novo blog post é adicionado e nós somos redirecionados para a página de `post_detail`!
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
 
-Você provavelmente notou que nós estamos definindo a data de publicação antes de salvar a postagem. Mais adiante, nós vamos introduzir um _botão de publicação_ no __Django Girls Tutorial: Extensões__.
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
 
-Isso é incrível!
+That is awesome!
 
-> Como nós recentemente usamos a interface de administração do Django, o sistema ainda pensa que nós estamos "logados". Existem algumas situações que poderiam nos levar a estar "deslogados" (fechando o browser, reiniciando o DB, etc.). Se, durante a criação de uma postagem, você perceber que está recebendo erros referentes a falta de um usuário "logado", vá para a página de administração http://127.0.0.1:8000/admin e faça o login novamente. Isso resolverá o problema temporariamente. Existe um ajuste permanente esperando por você no capítulo __lição de casa: adicionando segurança ao seu site!__ após o tutorial principal.
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
 
-![Erro de login](images/post_create_error.png)
+![Logged in error](images/post_create_error.png)
 
-## Validação de formulários
+## Form validation
 
-Agora, nós lhe mostraremos como os fórmularios são legais. A postagem do blog precisa ter os campos `title` e `text`. Em nosso modelo `Post` não dissemos (em oposição a `published_date`) que esses campos não são necessários, então o Django, por padrão, fica na expectativa que estejão definidos.
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
 
-Tente salvar o formulário sem `title` e `text`. Adivinhe o que vai acontecer!
+Try to save the form without `title` and `text`. Guess what will happen!
 
-![Validação de formulário](images/form_validation2.png)
+![Form validation](images/form_validation2.png)
 
-Django está tomando conta da validação de todos os campos de nosso formulário, cerfificando que estão corretos. Não é incrível?
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
 
-## Editando o formulário
+## Edit form
 
-Agora já sabemos como adicionar um novo formulário. Mas e se quisermos editar um já existente? É muito semelhante ao que fizemos. Vamos criar algumas coisas importantes rapidamente (se você não entender alguma coisa - você deve perguntar a seu professor ou veja os capítulos anteriores, já cobrimos todas essas etapas anteriormente).
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
 
-Abra `blog/templates/blog/post_detail.html` e adicione a linha:
+Open `blog/templates/blog/post_detail.html` and add the line
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
 
-Agora o template (modelo) estará parecido com:
+so that the template will look like this:
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -295,18 +312,20 @@ Agora o template (modelo) estará parecido com:
 {% endblock %}
 ```
 
-Em `blog/urls.py` adicionamos esta linha:
+In `blog/urls.py` we add this line:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
     url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
 ```
 
-Nós reutilizaremos o modelo `blog/templates/blog/post_edit.html`, então a última coisa que falta é uma *view*.
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
 
-Vamos abrir `blog/views.py` e adicionar no final do arquivo:
+Let's open `blog/views.py` and add this at the very end of the file:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_edit(request, pk):
     post = get_object_or_404(Post, pk=pk)
@@ -323,97 +342,106 @@ def post_edit(request, pk):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Isso é quase exatamente igual a nossa view de `post_new`, certo? Mas não totalmente. Primeira coisa: passamos um parâmetro extra `pk` de urls . Em seguida: pegamos o modelo `Post` que queremos editar com `get_object_or_404 (Post, pk=pk)` e então, enquanto criamos um formulário, passamos esta postagem como uma `instância`, ambos quando salvamos o formulário...
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 form = PostForm(request.POST, instance=post)
 ```
 
-…e quando nós acabamos de abrir um formulário com essa postagem para editar:
+…and when we've just opened a form with this post to edit:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 form = PostForm(instance=post)
 ```
 
-Ok, vamos testar se funciona! Vamos para a página `post_detail`. Deve haver um botão editar no canto superior direito:
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
 
-![Botão editar](images/edit_button2.png)
+![Edit button](images/edit_button2.png)
 
-Quando você clicar nele você verá o formulário com a nossa postagem:
+When you click it you will see the form with our blog post:
 
-![Editando o formulário](images/edit_form2.png)
+![Edit form](images/edit_form2.png)
 
-Sinta-se livre para mudar o título ou o texto e salvar as mudanças!
+Feel free to change the title or the text and save the changes!
 
-Parabéns! Sua aplicação está ficando cada vez mais completa!
+Congratulations! Your application is getting more and more complete!
 
-Se você precisar de mais informações sobre formulários do Django você deve ler a documentação: https://docs.djangoproject.com/en/1.9/topics/forms/
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
 
-## Segurança
+## Security
 
-Ser capaz de criar novas postagens apenas clicando em um link é incrível! Mas agora, qualquer um que visitar nosso site será capaz de criar uma nova postagem no blog, e isso, provavelmente não é algo que você quer. Vamos fazer com que o botão apareça apenas para você e mais ninguém.
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
 
-Em `blog/templates/blog/base.html`, encontre nossa `div` `page-header` e a tag "anchor" que você colocou lá anteriormente. Deve se parecer com isso:
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Nós vamos adicionar outra tag `{% if %}` aqui, que fará com que o link seja exibido apenas para usuários que estiverem "logados" como admin. Nesse momento, é apenas você! Altere a tag `<a>` para algo como:
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% if user.is_authenticated %}
     <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 {% endif %}
 ```
 
-Esse `{% if %}` fará com que o link seja enviado para o browser apenas se o usuário que requisitar a página estiver "logado". Isso não protege a criação de novas postagens completamente, mas é um bom primeiro passo. Nós falaremos mais sobre segurança nas lições de extensão.
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
 
-Lembra do icone de edição que nós acabamos de adicionar a nossa página de detalhes? Nós também queremos adicionar a mesma alteração lá, para que outras pessoas não sejam capazes de editar postagens existentes.
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
 
-Abra `blog/templates/blog/post_detail.html` e encontre essa linha:
+Open `blog/templates/blog/post_detail.html` and find this line:
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
 
-Altere ela para isso:
+Change it to this:
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% if user.is_authenticated %}
      <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 {% endif %}
 ```
 
-Como você deve estar "logada", se você atualizar a página, não verá nada de diferente. Carregue a página em um navegador diferente ou em uma janela anônima, e então, veja que o link não é exibido, assim como o icone também não é!
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
 
-## Mais uma coisa: hora de implantar!
+## One more thing: deploy time!
 
-Vamos ver se tudo isso funciona na PythonAnywhere. Tempo para outro deploy!
+Let's see if all this works on PythonAnywhere. Time for another deploy!
 
-* Primeiro, commit o seu novo código e coloque no Github
+* First, commit your new code, and push it up to Github:
 
-```bash
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added views to create/edit blog post inside the site."
-$ git push
-```
+{% filename %}command-line{% endfilename %}
 
-* Então, em um [console PythonAnywhere Bash][7]:
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
 
-```bash
-$ cd my-first-blog
-$ git pull
-```
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
-* Finalmente, pule para [Web tab](https://www.pythonanywhere.com/web_app_setup/) e aperte **Reload**.
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
 
-E deve ser isso! Parabéns :)
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/pt/django_installation/README.md b/pt/django_installation/README.md
index 6ba4f92c823..7834993e063 100755
--- a/pt/django_installation/README.md
+++ b/pt/django_installation/README.md
@@ -1,9 +1,7 @@
-# Instalação do Django
+# Django installation
 
-> **Nota** Se você estiver usando um Chromebook, pule esse capítulo e certifique-se de seguir as instruções para 
-[Configuração do Chromebook](../chromebook_setup/README.md)
-
-> **Nota** Se você já fez os passos de Instalação, então você já superou essa etapa – você pode ir direto para o próximo
-capítulo!
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
 
 {% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/pt/django_installation/instructions.md b/pt/django_installation/instructions.md
index 94907490ad1..0bc080f7055 100644
--- a/pt/django_installation/instructions.md
+++ b/pt/django_installation/instructions.md
@@ -1,207 +1,201 @@
-> Parte deste capítulo é baseado nos tutoriais do Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 > 
-> Parte deste capítulo é baseado no [django-marcador tutorial][1] licenciado sobre Creative Commons Attribution-ShareAlike 4.0 International License. O tutorial do django-marcador é protegido por direitos autorais por Markus Zapke-Gründemann et al.
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
 
- ## Ambiente virtual
+## Virtual environment
 
-Antes de instalarmos o Django, nós iremos instalar uma ferramenta extremamente útil que irá ajudar a manter seu ambiente de desenvolvimento arrumado em seu computador. É possível ignorar este passo, mas ele é altamente recomendado. Começar com a melhor configuração possível te salvará de muitos problemas no futuro!
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
 
-Então, vamos criar um **ambiente virtual**(também chamado um *virtualenv*). Isso isolará sua configuração Python/Django em uma base por projeto, significa que quaisquer mudanças que fizer em um website não afetará quaisquer outras aplicações que estiver desenvolvendo a parte. Arrumado, certo?
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
 
-Tudo o que você precisa fazer é encontrar um diretório no qual você deseja criar o `virtualenv`; Seu diretório Home, por exemplo. No Windows pode parecer como `C:\Usuário\Nome` (onde `Nome` é o nome do seu login).
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
 
-> __NOTA:__ No Windows, certifique-se que esse diretório  não contenha acento ou caracteres especiais; se o seu nome de
-usuário contém caracteres de acento, use um diretório diferente, como por exemplo: `C:\djangogirls`.
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
 
-Para este tutorial usaremos um novo diretório `djangogirls` dentro do seu diretório home:
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
 
 {% filename %}command-line{% endfilename %}
-```
-$ mkdir djangogirls
-$ cd djangogirls
-```
 
-Nós vamos fazer um virtualenv chamado `myvenv`. O formato geral desse comando é:
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 -m venv myvenv
-```
-<!--sec data-title="Windows" data-id="virtualenv_installation_windows"
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
 data-collapse=true ces-->
 
-Para criar um novo `virtualenv`, você precisa abrir o console(Nós falamos sobre isso alguns capítulos atrás, lembra-se?) e executar `C:\Python35\python -m venv myvenv`. Será algo parecido com isto:
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
 
 {% filename %}command-line{% endfilename %}
-```
-C:\Users\Name\djangogirls> C:\Python35\python -m venv myvenv
-```
 
-onde `C:\Python35\python` é o diretório em que você previamente instalou Python e `myvenv` é o nome da sua `virtualenv`. Você pode usar qualquer outro nome, mas sempre use minúsculas e sem espaços, acentos ou caracteres especiais. Também é uma boa ideia manter o nome curto - você irá referenciar muito a ele!
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
 
 <!--endsec-->
 
-<!--sec data-title="Linux and OS X" data-id="virtualenv_installation_linuxosx"
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
 data-collapse=true ces-->
 
-Criar um `virtualenv` tanto no Linux como OS X é tão simples quanto executar `python3 -m venv myvenv`. Será algo parecido com isto:
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 -m venv myvenv
-```
 
-`myvenv` é o nome da sua `virtualenv`. Você pode usar qualquer outro nome, mas sempre use minúsculas e não use espaços entre os nomes. Também é uma boa ideia manter o nome curto - você irá referenciar muito a ele!
+    $ python3 -m venv myvenv
+    
 
-> __NOTA:__ Em algumas versões do Debian/Ubuntu você pode se depara com o seguinte erro:
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
 
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
 > {% filename %}command-line{% endfilename %}
->```
-> The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
->    apt-get install python3-venv
-> You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
->```
->
-> Nesse caso, siga as instruções acima e instale o pacote `python3-venv`:
->{% filename %}command-line{% endfilename %}
->```
->$ sudo apt-get install python3-venv
->```
-
-> __NOTA:__ Em algumas versões do Debian/Ubuntu inicializar o ambiente virtual dessa forma retorna o seguinte erro:
-
->{% filename %}command-line{% endfilename %}
->```
->Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
->```
-
-> Para contornar isso, use o comando `virtualenv` em seu lugar.
-
->{% filename %}command-line{% endfilename %}
->```
->$ sudo apt-get install python-virtualenv
->$ virtualenv --python=python3.5 myvenv
->```
-
-> __NOTA:__ Se você teve um erro como
-
->{% filename %}command-line{% endfilename %}
->```
->E: Unable to locate package python3-venv
->```
-
-> então execute:
->
->{% filename %}command-line{% endfilename %}
->```
->sudo apt install python3.5-venv
->```
+> 
+>     sudo apt install python3.6-venv
+>     
 
 <!--endsec-->
 
-## Trabalhando com o virtualenv
+## Working with virtualenv
 
-O comando acima criará um diretório chamado `myvenv` (ou qualquer nome que você tenha escolhido) que contém o nosso ambiente virtual(basicamente um conjunto de diretórios e arquivos)
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
 
-<!--sec data-title="Windows" data-id="virtualenv_windows"
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
 data-collapse=true ces-->
 
-Inicie seu ambiente virtual executando:
+Start your virtual environment by running:
 
 {% filename %}command-line{% endfilename %}
-```
-C:\Users\Name\djangogirls> myvenv\Scripts\activate
-```
-
- > __NOTA:__ No Windows 10 você pode ter um erro no Windows PowerShell que diz `execution of scripts is disabled on this system`. Nesse caso, abra outro Windows PowerShell com a opção "Run as Administrator".  E então tente digitar o seguinte
- comando antes de iniciar seu ambiente virtual:
->
->{% filename %}command-line{% endfilename %}
->```
->C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
->     Execution Policy Change
->     The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
->```
-
-<!--endsec-->  
-
-<!--sec data-title="Linux and OS X" data-id="virtualenv_linuxosx"
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
 data-collapse=true ces-->
 
-Inicie seu ambiente virtual executando:
+Start your virtual environment by running:
 
 {% filename %}command-line{% endfilename %}
-```
-$ source myvenv/bin/activate
-```
 
-Lembre-se de substituir `myvenv` com seu nome escolhido do `virtualenv`!
+    $ source myvenv/bin/activate
+    
 
-> **NOTE:** às vezes `source(fonte)` pode não estar disponível. Nesses casos, tente fazer isso:
->
->{% filename %}command-line{% endfilename %}
->```
->$ . myvenv/bin/activate
->```
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
 
 <!--endsec-->
 
-Você vai saber que tem um `virtualenv` funcionando quando ver o prompt no seu console com o prefixo `(myenv)`:
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
 
-Ao trabalhar dentro de um ambiente virtual, `python` irá automaticamente se referir a versão correta para que possa utilizar `python` em vez de `python3`.
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
 
-Ok, nós temos todas as dependências importantes no lugar. Finalmente podemos instalar o Django!
+OK, we have all important dependencies in place. We can finally install Django!
 
-## Instalando o Django
+## Installing Django
 
-Agora que você tem a sua `virtualenv` inicializada, você pode instalar Django. 
+Now that you have your `virtualenv` started, you can install Django.
 
-Antes de nós fazermos isso, nós devemos ter certeza que temos a última versão do `pip`, o software que nós usamos para instalar
-o Django:
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~$ pip install --upgrade pip
-```
 
-E então execute `pip install django~=1.9.0` (note que nós usamos um til seguido por um sinal de igual: `~=`) para instalar
-o Django.
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~$ pip install django~=1.9.0
-Downloading/unpacking django==1.9
-Installing collected packages: django
-Successfully installed django
-Cleaning up...
-```
-
-<!--sec data-title="Windows" data-id="django_err_windows"
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
 data-collapse=true ces-->
 
->Se você receber um erro ao chamar o pip na plataforma Windows por favor, verifique se o caminho do projeto contém espaços, acentos ou caracteres especiais (exemplo, `C:\Users\User Name\djangogirls`). Se sim, por favor considere usar outro lugar sem espaços, acentos ou caracteres especiais (sugestão é: `C:\djangogirls`). Crie um novo virtualenv no diretório novo, então
-remova o diretório antigo e tente o comando acima novamente. (Mover o diretório virtualenv não funciona já que o virtualenv usa
-caminhos absolutos.)
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
 
 <!--endsec-->
 
-<!--sec data-title="Windows 8 and Windows 10" data-id="django_err_windows8and10"
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
 data-collapse=true ces-->
 
-> Sua linha de comando pode congelar depois de você tentar instalar o Django. Se isso acontecer, ao invéz do comando acima use:
->
->{% filename %}command-line{% endfilename %}
->```
->C:\Users\Name\djangogirls> python -m pip install django~=1.9.0
->```
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
 
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="django_err_linux"
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
 data-collapse=true ces-->
 
-> Se você receber um erro ao chamar pip no Ubuntu 12.04 por favor execute `python -m pip install -U --force-reinstall pip` para corrigir a instalação do pip no virtualenv.
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
 
 <!--endsec-->
 
-É isso! Agora você está (finalmente) pronta para criar uma aplicação Django!
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/pt/django_models/README.md b/pt/django_models/README.md
index 77a3fbfe566..7aa11d11732 100755
--- a/pt/django_models/README.md
+++ b/pt/django_models/README.md
@@ -1,101 +1,103 @@
-# Modelos do Django
+# Django models
 
-Agora o que nós queremos criar é algo que armazene todos os posts no nosso blog. Mas para fazer isso precisamos aprender um pouco mais sobre coisas chamadas `objetos`.
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
 
-## Objetos
+## Objects
 
-Existe um conceito na programação chamado `Programação Orientada à Objetos (POO)`. A ideia é que ao invés de escrever tudo como uma chata sequência de instruções de programação podemos modelar as coisas e definir como elas interagem umas com as outras.
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
 
-Então o que é um objeto? É uma coleção de propriedades e ações. Isto pode parecer estranho, mas vamos lhe dar um exemplo.
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
 
-Se queremos modelar um gato nós criaremos um objeto `Gato` que possui algumas propriedades, por exemplo `cor`, `idade`, `humor` (bom, mau, sonolento ;)), `dono` (que é um objeto da classe `Pessoa` ou, caso seja um gato de rua, essa propriedade é vazia).
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
 
-E então o `Gato` tem algumas ações: `ronronar`, `arranhar` ou `comer` (no qual vamos dar ao gato alguma `ComidaDeGato `, que poderia ser um objeto separado com propriedades, como `sabor`).
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
 
-```
-Gato
--------
-cor
-idade
-humor
-dono
-ronronar()
-arranhar()
-comer(comida_de_gato)
-```
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
 
-```
-ComidaDeGato
--------
-sabor
-```
+    CatFood
+    --------
+    taste
+    
 
-Então, basicamente, a ideia é descrever coisas reais no código com propriedades(chamadas de `propriedades do objeto`) e ações (chamadas de `métodos`).
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
 
-Como nós iremos modelar as postagens do blog então? Queremos criar um blog, certo?
+How will we model blog posts then? We want to build a blog, right?
 
-Precisamos responder essas perguntas: o que é uma postagem de blog? Que propriedades deve ter?
+We need to answer the question: What is a blog post? What properties should it have?
 
-Bem, com certeza nossa postagem no blog precisa de algum texto com conteúdo e um título, certo? Também seria bom saber quem a escreveu - então precisamos de um autor. Finalmente, queremos saber quando a postagem foi criada e publicada.
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
 
-```
-Post
---------
-title
-text
-author
-created_date
-published_date
-```
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
 
-Que tipo de coisas podem ser feitas com uma postagem? Seria legal ter algum `método` que publique a postagem, não é mesmo?
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
 
-Então precisamos de um método chamado `publish`.
+So we will need a `publish` method.
 
-Como já sabemos o que queremos alcançar, podemos começar a modelagem em Django!
+Since we already know what we want to achieve, let's start modeling it in Django!
 
-## Modelo do Django
+## Django model
 
-Sabendo o que um objeto é, nós criaremos um modelo no Django para a postagem no blog.
+Knowing what an object is, we can create a Django model for our blog post.
 
-Um modelo no Django é um tipo especial de objeto - ele é salvo em um `banco de dados`. Um banco de dados é uma coleção de dados. O banco de dados é um local onde você vai salvar dados sobre os usuários, suas postagens, etc. Usaremos um banco de dados chamado SQLite para armazenar as nossas informações. Este é o adaptador de banco de dados padrão Django -- ele vai ser o suficiente para nós neste momento.
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
 
-Você pode pensar em um modelo de banco de dados como uma planilha com colunas (campos) e linhas (dados).
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
 
-### Criando uma aplicação
+### Creating an application
 
-Para manter tudo arrumado vamos criar um aplicativo separado dentro do nosso projeto. É muito bom ter tudo organizado desde o início. Para criar um aplicativo precisamos executar o seguinte comando no console (a partir do diretório `djangogirls` onde está o arquivo `manage.py`):
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
 
-{% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py startapp blog
-```
+{% filename %}Mac OS X and Linux:{% endfilename %}
 
-Você vai notar que um novo diretório `blog` é criado e que ele agora contém um número de arquivos. Nossos diretórios e arquivos no nosso projeto devem se parecer com este:
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
 
-```
-djangogirls
-├── blog
-│   ├── __init__.py
-│   ├── admin.py
-│   ├── apps.py
-│   ├── migrations
-│   │   └── __init__.py
-│   ├── models.py
-│   ├── tests.py
-│   └── views.py
-├── db.sqlite3
-├── manage.py
-└── mysite
-    ├── __init__.py
-    ├── settings.py
-    ├── urls.py
-    └── wsgi.py
-```
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
 
-Depois de criar um aplicativo também precisamos dizer ao Django que deve usá-lo. Fazemos isso no arquivo `mysite/settings.py`. Precisamos encontrar o `INSTALLED_APPS` e adicionar uma linha com `'blog',` logo acima do `]`. É assim que o produto final deve ficar assim:
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 INSTALLED_APPS = [
     'django.contrib.admin',
@@ -108,20 +110,21 @@ INSTALLED_APPS = [
 ]
 ```
 
-### Criando o modelo Post do nosso blog
+### Creating a blog post model
 
-No arquivo `blog/models.py` definimos todos os objetos chamados `Modelos` - este é um lugar em que vamos definir nossa postagem do blog.
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
 
-Vamos abrir `blog/models.py`, remova tudo dele e escreva o código como este:
+Let's open `blog/models.py`, remove everything from it, and write code like this:
 
 {% filename %}blog/models.py{% endfilename %}
+
 ```python
 from django.db import models
 from django.utils import timezone
 
 
 class Post(models.Model):
-    author = models.ForeignKey('auth.User')
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
     created_date = models.DateTimeField(
@@ -137,57 +140,60 @@ class Post(models.Model):
         return self.title
 ```
 
-> Certifique-se de ter usado dois caracteres (`_`) em cada lado de `str`. Essa convenção é usada freqüentemente em Python e às vezes a chamamos de "dunder" (abreviação de "double-underscore" ou "duplo sublinhado").
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
 
-É assustador, não? Mas não se preocupe, vamos explicar o que estas linhas significam!
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
 
-Todas as linhas começando com `from` ou `import` são linhas que adicionam alguns pedaços de outros arquivos. Então ao invés de copiar e colar as mesmas coisas em cada arquivo, podemos incluir algumas partes com `from... import ...`.
+`class Post(models.Model):` – this line defines our model (it is an `object`).
 
-`class Post(models.Model):` - esta linha define o nosso modelo (é um `objeto`).
-- `class` é uma palavra-chave especial que indica que estamos definindo um objeto.
-- `Post` é o nome do nosso modelo, podemos lhe dar um nome diferente (mas é preciso evitar os espaços em branco e caracteres especiais). Sempre comece um nome de classe com uma letra maiúscula.
-- `models.Model` significa que o Post é um modelo de Django, então o Django sabe que ele deve ser salvo no banco de dados.
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
 
-Agora podemos definir as propriedades que discutimos: `title`, `text`, `created_date`, `published_date` e `author`. Para isso precisamos definir um tipo de campo (é um texto? É um número? Uma data? Uma relação com outro objeto, como por exemplo, um usuário?).
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
 
-- `models.CharField` - assim é como você define um texto com um número limitado de caracteres.
-- `models.TextField` - este é para textos longos, sem um limite. Será ideal para um conteúdo de post de blog, certo?
-- `models.DateTimeField` - este é uma data e hora.
-- `models.ForeignKey` - este é um link para outro modelo.
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
 
-Nós não vamos explicar cada pedaço de código aqui, pois isso levaria muito tempo. Você deve olhar a documentação do Django se você quiser saber mais sobre campos do Model e como definir coisas além destas descritas acima (https://docs.djangoproject.com/en/1.9/ref/models/fields/#field-types).
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
 
-E sobre o `def publish(self):`? Ele é exatamente o nosso método `publish` que falávamos antes. `def`, significa que se trata de um função/método. `publish` é o nome do método. Você pode alterar, se quiser. A regra é que usamos letras minúsculas e sublinhados em vez de espaços em branco (ou seja, se você quer ter um método que calcula o preço médio, você poderia chamá-lo `calculate_average_price`).
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
 
-Métodos muitas vezes `retornam (return)` algo. Há um exemplo disso no método `__str__`. Nesse cenário, quando chamamos `__str__()` receberemos um texto (**string**), com um título do Post.
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
 
-Note também que ambos, `def publish(self):` e `def __str__(self):` estão indentados dentro de nossa classe. Devido Python ser sensitivo a espaços em branco, nós precisamos indentar nossos métodos dentro da classe. Senão, os métodos não pertencerão a classe, e isso pode resultar em comportamentos inesperados.
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
 
-Se algo ainda não está claro sobre modelos, sinta-se livre para perguntar a sua treinadora! Sabemos que é muito complicado, especialmente quando se aprende o que são objetos e funções ao mesmo tempo. Mas espero que se pareça um pouco menos mágico para você agora!
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
 
-### Criando tabelas para nossos modelos no banco de dados
+### Create tables for models in your database
 
-O último passo é adicionar nosso novo modelo em nosso banco de dados. Primeiro temos que fazer o Django saber que nós temos algumas mudanças em nosso modelo (só criamos isso), digite `python manage.py makemigrations blog`. Será algo parecido com isto:
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py makemigrations blog
-Migrations for 'blog':
-  0001_initial.py:
-  - Create model Post
-```
 
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
 
-Django preparou um arquivo de migração para nós que temos de aplicar agora em nosso banco de dados, digite `python manage.py migrate blog`, e a saída deve ser algo como:
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py migrate blog
-Operations to perform:
-  Apply all migrations: blog
-Running migrations:
-  Rendering model states... DONE
-  Applying blog.0001_initial... OK
-```
 
-Viva! Nosso modelo de Post está agora em nosso banco de dados, seria um prazer vê-lo, certo? Salte para o próximo capítulo para ver com sua postagem se parece!
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/pt/django_orm/README.md b/pt/django_orm/README.md
index dce97940cc2..31c47f27764 100755
--- a/pt/django_orm/README.md
+++ b/pt/django_orm/README.md
@@ -1,37 +1,39 @@
-# QuerySets e ORM do Django
+# Django ORM and QuerySets
 
-Neste capítulo você vai aprender como Django se conecta ao banco de dados e como ele armazena dados. Vamos nessa!
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
 
-## O que é um QuerySet?
+## What is a QuerySet?
 
-Um QuerySet (conjunto de pesquisa), no fundo, é uma lista de objetos de um dado modelo. Um QuerySet permite que você leia os dados do banco, filtre e ordene o mesmo.
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
 
-É mais fácil aprender por exemplos. Vamos tentar?
+It's easiest to learn by example. Let's try this, shall we?
 
-## O Shell do Django
+## Django shell
 
-Abra seu console local (não no PythonAnywhere) e digite esse comando:
+Open up your local console (not on PythonAnywhere) and type this command:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py shell
-```
 
-O efeito deve se parecer com isso:
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 (InteractiveConsole)
 >>>
 ```
 
-Agora você está no console interativo do Django. Ele é como o prompt do Python, só que com umas mágicas Django adicionais :). Você pode usar todos os comandos do Python aqui também, é claro.
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
 
-### Todos os objetos
+### All objects
 
-Antes, vamos tentar mostrar todas as nossas postagens. Podemos fazer isso com o seguinte comando:
+Let's try to display all of our posts first. You can do that with the following command:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.all()
 Traceback (most recent call last):
@@ -39,161 +41,178 @@ Traceback (most recent call last):
 NameError: name 'Post' is not defined
 ```
 
-Oops! Um erro apareceu. Ele nos diz que não existe algo chamado Post. É verdade -- nós esquecemos de importá-lo primeiro!
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> from blog.models import Post
 ```
 
-Isso é simples: importamos o modelo `Post` de dentro do `blog.models`. Vamos tentar mostrar todas as postagens novamente:
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.all()
 <QuerySet [<Post: my post title>, <Post: another post title>]>
 ```
 
-É uma lista das postagens que criamos anteriormente! Criamos essas postagens usando a interface de administração do Django. No entanto, agora queremos criar novas postagens utilizando o python, então, como é que fazemos isso?
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
 
-### Criando um objeto
+### Create object
 
-É assim que você cria um objeto Post no banco de dados:
+This is how you create a new Post object in database:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.create(author=me, title='Sample title', text='Test')
 ```
 
-Mas aqui temos um ingrediente que está faltando: `me`. Precisamos passar uma instância do modelo `User` como autor. Como fazer isso?
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
 
-Primeiro vamos importar o modelo User:
+Let's import User model first:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> from django.contrib.auth.models import User
 ```
 
-Quais usuários temos no nosso banco de dados? Experimente isso:
+What users do we have in our database? Try this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> User.objects.all()
-<QuerySet [<User: Ana>]>
+<QuerySet [<User: ola>]>
 ```
 
-É o superusuário que criamos anteriormente! Vamos obter uma instância de usuário agora:
+This is the superuser we created earlier! Let's get an instance of the user now:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
-me = User.objects.get(username='Ana')
+>>> me = User.objects.get(username='ola')
 ```
 
-Como você pode ver, nós agora usamos um `get` para pegar um `User` com um `username` igual a 'Ana'. Claro, você tem que adaptar essa linha ao seu nome de usuário.
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
 
-Agora finalmente podemos criar nossa primeira postagem:
+Now we can finally create our post:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.create(author=me, title='Sample title', text='Test')
 ```
 
-Viva! Quer ver se funcionou?
+Hurray! Wanna check if it worked?
+
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.all()
 <QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
 ```
 
-Ai está, mais uma postagem na lista!
+There it is, one more post in the list!
 
-### Adicione mais postagens
+### Add more posts
 
-Agora você pode se divertir um pouco e adicionar mais postagens para ver como funciona. Adicione mais 2-3 e siga para a próxima parte.
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
 
-### Filtrar objetos
+### Filter objects
 
-Os QuerySets são muito usados pela habilidade de filtrar objectos. Digamos que queremos encontrar todos as postagens escritas pela usuária Ana. Nós usaremos o `filter` em vez de `all` em `Post.objects.all()`. Entre parênteses indicamos as condições que precisam ser atendidas por uma postagem de blog para que ela entre em nosso queryset. Em nosso caso, a condição é que  `author` deve ser igual a `me`. A maneira de escrever isso no Django é: `author=me`. Agora o nosso trecho de código parece como este:
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.filter(author=me)
 [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
 ```
 
-Ou talvez nós queiramos ver todas as postagenss que contenham a palavra 'title' no campo de `title`?
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.filter(title__contains='title')
 [<Post: Sample title>, <Post: 4th title of post>]
 ```
 
-> **Nota** Existem dois caracteres de sublinhado (`_`) entre o `title` e `contains`. Django ORM usa esta sintaxe para separar nomes de campo ("title") e operações ou filtros ("contains"). Se você usar apenas um sublinhado, você obterá um erro como "FieldError: Cannot resolve keyword title_contains".
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
 
-Você também pode obter uma lista de todas as postagens publicadas. Fazemos isso filtrando todos os posts com `published_date` definido no passado:
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> from django.utils import timezone
 >>> Post.objects.filter(published_date__lte=timezone.now())
 []
 ```
 
-Infelizmente, nenhuma de nossas postagens feitas a partir do console do Python estão publicadas ainda. Mas nós podemos mudar isso! Primeiro obtenha uma instância de uma postagem que queremos publicar:
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> post = Post.objects.get(title="Sample title")
 ```
 
-E então vamos publicá-la com o nosso método `publish`!
+And then publish it with our `publish` method:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> post.publish()
 ```
 
-Agora, tente obter a lista de postagens publicadas novamente (pressione o botão da seta para cima 3 vezes e tecle `enter`):
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.filter(published_date__lte=timezone.now())
 [<Post: Sample title>]
 ```
 
-### Ordenando objetos
+### Ordering objects
 
-Um QuerySet também nos permite ordenar a lista de objetos. Vamos tentar ordenar as postagens pelo campo `created_date`:
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.order_by('created_date')
 [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
 ```
 
-Você também pode inverter a ordem adicionando um `-` no início:
+We can also reverse the ordering by adding `-` at the beginning:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.order_by('-created_date')
 [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
 ```
 
-### Encadeando QuerySets 
+### Chaining QuerySets
 
-Você pode também combinar QuerySets pelo **encadeamento** deles em sequência:
+You can also combine QuerySets by **chaining** them together:
 
-```
->>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-```
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
 
-Isso é realmente poderoso e permite que você escreva pesquisas ("queries") bem complexas.
+This is really powerful and lets you write quite complex queries.
 
-Legal! Você já está pronta para a próxima parte! Para fechar o terminal digite:
+Cool! You're now ready for the next part! To close the shell, type this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> exit()
 $
-```
+```
\ No newline at end of file
diff --git a/pt/django_start_project/README.md b/pt/django_start_project/README.md
index 0b0cc0750ff..fe1abc7ca9a 100755
--- a/pt/django_start_project/README.md
+++ b/pt/django_start_project/README.md
@@ -1,107 +1,123 @@
-# Seu primeiro projeto Django!
+# Your first Django project!
 
-> Parte deste capítulo é baseado nos tutoriais do Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 > 
-> Parte deste capítulo é baseado no [django-marcador tutorial](http://django-marcador.keimlink.de/) licenciado sobre Creative Commons Attribution-ShareAlike 4.0 International License. O tutorial do django-marcador é protegido por direitos autorais por Markus Zapke-Gründemann et al.
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
 
- Nós vamos criar um blog simples!
+We're going to create a small blog!
 
-O primeiro passo para criá-lo é começar um novo projeto de Django. Basicamente, isto significa que vamos executar alguns scripts fornecidos pelo Django que irão criar o esqueleto de um projeto Django para nós: um bando de diretórios e arquivos que usaremos mais tarde.
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
 
-Os nomes de alguns arquivos e diretórios são muito importantes para o Django. Não renomeie os arquivos que estamos prestes a criar. Mover para um lugar diferente também não é uma boa idéia. Django precisa manter uma determinada estrutura para ser capaz de encontrar coisas importantes.
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
 
-> Lembre-se de executar tudo no virtualenv. Se você não vê um prefixo `(myvenv)` em seu console, você precisa ativar o virtualenv. Nós explicamos como fazer isso no capítulo de __instalação do Django__ na parte __Trabalhando com virtualenv__. Você pode fazer isso digitando o seguinte comando: `myvenv\Scripts\activate` no Windows ou `source myvenv/bin/activate` no Mac OS / Linux.
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
 
-<!--sec data-title="OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
 
-No seu console Mac OS X ou Linux, você deve executar o seguinte comando. **Não se esqueça de adicionar o ponto `.` no final!**
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ django-admin startproject mysite .
-```
-> O ponto `.` é crucial porque ele informa ao script para instalar o Django no seu diretório atual (para o qual o ponto `.` é uma referência abreviada).
 
- > **Nota** Durante a digitação do comando acima, lembre-se que você apenas digita a parte que começa com `django-admin`. 
-A parte `(myvenv) ~/djangogirls$` mostrada aqui é apenas um exemplo de prompt que está convidando você a digitar algo em sua linha de comando.
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
 
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
 
-No Windows você deve executar o seguinte comando. **(Não se esqueça de adicionar o ponto `.` no final**:
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) C:\Users\Name\djangogirls> django-admin.py startproject mysite .
-```
-> O ponto `.` é crucial porque ele informa ao script para instalar o Django no seu diretório atual (para o qual o ponto `.` é uma referência abreviada).
 
-> **Nota** Durante a digitação do comando acima, lembre-se que você apenas digita a parte que começa com `django-admin.py`.
-A parte `(myvenv) C:\Users\Name\djangogirls>` mostrada aqui é apenas um exemplo de prompt que está convidando você a digitar algo em sua linha de comando.
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
 
 <!--endsec-->
 
-`Django-admin` é um script que irá criar os diretórios e arquivos para você. Agora, você deve ter um diretório estrutura que se parece com isso:
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
 
-```
-djangogirls
-├───manage.py
-└───mysite
-        settings.py
-        urls.py
-        wsgi.py
-        __init__.py
-```
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
 
-`manage.py` é um script que ajuda com a gestão do site. Com isso seremos capazes de iniciar um servidor de web no nosso computador sem instalar nada, entre outras coisas.
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
 
-O arquivo `settings.py` contém a configuração do seu site.
+The `settings.py` file contains the configuration of your website.
 
-Lembra quando falamos sobre um carteiro verificando onde entregar uma carta? arquivo `urls.py` contém uma lista dos padrões usados por `urlresolver`.
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
 
-Vamos ignorar os outros arquivos por agora - nós não vamos mudá-los. A única coisa a lembrar é não excluí-los por acidente!
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
 
-## Alterando as configurações
+## Changing settings
 
-Vamos fazer algumas alterações no `mysite/settings.py`. Abra o arquivo usando o editor de código que você instalou anteriormente.
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
 
-Seria bom ter a hora correta no nosso site. Vá para a [lista da Wikipedia de fusos horários](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) e copie seu fuso horário relevante (TZ) (por exemplo. `America/Sao_Paulo`).
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
 
-Em settings.py, localize a linha que contém `TIME_ZONE` e modifique para escolher seu próprio fuso horário:
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
-TIME_ZONE = 'America/Sao_Paulo'
+TIME_ZONE = 'Europe/Berlin'
 ```
 
-Modifique "America/Sao_Paulo", conforme o caso
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
 
-Nós também precisaramos adicionar um caminho para arquivos estáticos (nós vamos descobrir tudo sobre arquivos estáticos e CSS mais tarde no tutorial). Desça até o *final* do arquivo e logo abaixo da entrada `STATIC_URL`, adicione um novo um chamado `STATIC_ROOT`:
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 STATIC_URL = '/static/'
 STATIC_ROOT = os.path.join(BASE_DIR, 'static')
 ```
 
-Quando a variável `DEBUG` está como `True` e `ALLOWED_HOSTS` é vazio, o host considera `['localhost', '127.0.0.1', '[::1]']`. Isso não corresponde ao seu nome de usuário no PythonAnywhere. Uma vez que você fez a implantação da sua aplicação, nós devemos mudar as seguintes propriedades no arquivo `mysite/settings.py`:
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
-ALLOWED_HOSTS = ['127.0.0.1', '<your_username>.pythonanywhere.com']
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
 ```
 
-> **Note**: Se você está usando um Chromebook, adicione esta linha ao final do seu arquivo settings.py:
-> `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
 
-## Instalação de um banco de dados
+## Set up a database
 
-Há vários softwares de banco de dados diferentes que podem armazenar dados para o seu site. Nós vamos usar o padrão, `sqlite3`.
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
 
-Isto já está configurado nesta parte do seu arquivo `mysite/settings.py`:
+This is already set up in this part of your `mysite/settings.py` file:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 DATABASES = {
     'default': {
@@ -111,76 +127,76 @@ DATABASES = {
 }
 ```
 
-Para criar um banco de dados para o nosso blog, vamos fazer o seguinte no console. Digite: `python manage.py migrate` (precisamos estar no diretório `djangogirls` que contém o arquivo `manage.py`). Se isso der certo, você deve ver algo como isto:
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py migrate
-Operations to perform:
-  Apply all migrations: auth, admin, contenttypes, sessions
-Running migrations:
-  Rendering model states... DONE
-  Applying contenttypes.0001_initial... OK
-  Applying auth.0001_initial... OK
-  Applying admin.0001_initial... OK
-  Applying admin.0002_logentry_remove_auto_add... OK
-  Applying contenttypes.0002_remove_content_type_name... OK
-  Applying auth.0002_alter_permission_name_max_length... OK
-  Applying auth.0003_alter_user_email_max_length... OK
-  Applying auth.0004_alter_user_username_opts... OK
-  Applying auth.0005_alter_user_last_login_null... OK
-  Applying auth.0006_require_contenttypes_0002... OK
-  Applying auth.0007_alter_validators_add_error_messages... OK
-  Applying sessions.0001_initial... OK
-```
-
-E está pronto! Hora de iniciar o servidor web e ver se nosso site está funcionando!
 
-## Iniciando o servidor web
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
 
-Você precisa estar no diretório que contém o arquivo `manage.py` (o diretório `djangogirls`). No console, nós podemos iniciar o servidor web executando o `python manage.py runserver`:
+{% filename %}command-line{% endfilename %}
 
- {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py runserver
-```
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
 
-Se você está em um Chromebook, use esse comando:
+If you are on a Chromebook, use this command instead:
 
 {% filename %}Cloud 9{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
-```
 
-Se você está em um Windows e isso falhar com um `UnicodeDecodeError`, use esse comando:
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py runserver 0:8000
-```
 
-Agora tudo que você precisa fazer é verificar se seu site está sendo executado - abra seu navegador (Firefox, Chrome, Safari, Internet Explorer ou o que quer que seja que você usa) e digite o endereço:
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
 
 {% filename %}browser{% endfilename %}
-```
-http://127.0.0.1:8000/
-```
 
-Se você estiver usando um Chromebook, você sempre irá visitar seu servidor de testes acessando:
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
 
 {% filename %}browser{% endfilename %}
-```
-https://django-girls-<your cloud9 username>.c9users.io
-```
 
-Parabéns! Você criou seu primeiro site e o executou usando um servidor de web! Não é impressionante?
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
 
 ![It worked!](images/it_worked2.png)
 
-Enquanto o servidor web estiver rodando você não verá um novo prompt na linha de comando esperando por comandos adicionais. O terminal aceitará texto novo, mas não vai executar novos comandos. Devido a contínua execução do servidor web que fica aguardando por entrada de requisições.
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
 
-> Nós revisamos como os servidores web trabalham no capítulo <b>Como a Internet funciona</b>.
+> We reviewed how web servers work in the **How the Internet works** chapter.
 
-Para digitar mais comandos enquanto o servidor web estiver rodando , abra uma nova janela de terminal e ative seu virtualenv. Para parar o servidor de web, volte para a janela na qual ele está sendo executado e pressionando CTRL + C - botões de controle e C juntos (no Windows, você pode ter que pressionar Ctrl + Break).
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
 
-Pronto para o próximo passo? Está na hora de criar algum conteúdo!
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/pt/django_templates/README.md b/pt/django_templates/README.md
index 6f769a43a01..263eb1fd835 100755
--- a/pt/django_templates/README.md
+++ b/pt/django_templates/README.md
@@ -1,53 +1,55 @@
-# Templates do Django
+# Django templates
 
-Hora de exibir algum dado! Django nos dá  __tags de templates__ embutidas bastante úteis para isso.
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
 
-## O que são tags de template?
+## What are template tags?
 
-Como pode ver, você não pode colocar código Python no HTML, porque os navegadores não irão entender. Eles apenas conhecem HTML. Nós sabemos que HTML é bastante estático, enquanto Python é muito mais dinâmico.
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
 
-As __Tags de template Django__ nos permite transformar objetos Python em código HTML, para que você possa construir sites dinâmicos de forma mais rápida e mais fácil. Uhuu!
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
-## Template para exibir uma lista de postagens
+## Display post list template
 
-No capitulo anterior, nós fornecemos ao nosso template uma lista de postagens e a variável <o>posts</o>. Agora vamos exibir essa lista em nosso HTML.
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
 
-Para exibir uma variável no template do Django, nós usamos colchetes duplos com o nome da variável dentro, por exemplo:
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {{ posts }}
 ```
 
-Tentar fazer isso no seu template `blog/templates/blog/post_list.html`. Substitua tudo a partir do segundo `< div >` até o terceiro `< / div >` por `{{ posts }}`. Salve o arquivo e atualize a página para ver os resultados:
-
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
 
 ![Figure 13.1](images/step1.png)
 
-Como você pode ver, tudo que temos é:
+As you can see, all we've got is this:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <QuerySet [<Post: My second post>, <Post: My first post>]>
 ```
 
-Isto significa que o Django a entende como uma lista de objetos. Lembra da __Introdução ao Python__ de podemos exibir listas? Sim, com os loops! Em um template do Django, fazemos isso da seguinte maneira:
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     {{ post }}
 {% endfor %}
 ```
 
-Tente fazer isso no seu template.
+Try this in your template.
 
 ![Figure 13.2](images/step2.png)
 
-Funciona! Mas nós queremos que eles sejam exibidos como os posts estáticos, como os que criamos anteriormente no capítulo de __Introdução a HTML__. Nós podemos misturar HTML com tags de template. O conteúdo da tag `body` ficará assim:
-
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div>
     <h1><a href="/">Django Girls Blog</a></h1>
@@ -62,43 +64,43 @@ Funciona! Mas nós queremos que eles sejam exibidos como os posts estáticos, co
 {% endfor %}
 ```
 
-{% raw %}Tudo que você coloca entre `{% for %}` e `{% endfor %}` será repetido para cada objeto na lista. Atualize sua página::{% endraw %}
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
 
 ![Figure 13.3](images/step3.png)
 
-Você notou que dessa vez nós usamos uma notação um pouco diferente `{{ post.title }}` ou `{{ post.text }}`? Nós estamos acessando os dados em cada um dos campos que definimos no model do `Post`. Além disso, `|linebreaksbr` está passando o texto da postagem por um filtro, convertendo quebras de linha em parágrafos.
-
-## Mais uma coisa
-
-Seria bom ver se seu site ainda estará funcionando na internet, certo? Vamos tentar fazer a implantação na PythonAnywhere novamente. Aqui está um resumo dos passos...
-
-*   Primeiro, envie seu código para o Github
-   
-   {% filename %}command-line{% endfilename %}
-   ```
-   $ git status
-   [...]
-   $ git add --all .
-   $ git status
-   [...]
-   $ git commit -m "Modified templates to display posts from database."
-   [...]
-   $ git push
-   ```
-   
-*   Em seguida, faça login em [PythonAnywhere](https://www.pythonanywhere.com/consoles/) e vá para seu **Bash console** (ou comece um novo) e execute:
-
-    {% filename %}command-line{% endfilename %}
-    ```
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
     $ cd my-first-blog
     $ git pull
-    [...] 
-    ```
+    [...]
+    
 
-*   Finalmente, pule para a [Web tab](https://www.pythonanywhere.com/web_app_setup/) e aperte **Reload** em seu aplicativo web. Sua atualização deve estar ao vivo!  Se suas postagens do blog em seu site PythonAnywhere não coincidirem com as postagens que aparecem no blog hospedado em seu servidor local, está tudo bem. O banco de dados em seu computador local e o da Python Anywhere não estão sincronizados junto com o resto de seus arquivos.
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
 
-Parabéns! Agora vá em frente e tente adicionar um novo post em seu Django admin (Lembre-se de adicionar published_date!). Certifique-se que você está no admin do Django de seu site pythonanywhere, https://yourname.pythonanywhere.com/admin. E então atualize sua página para ver se a postagem aparece lá
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
 
-Funciona como mágica? Estamos orgulhosas! Afaste-se do seu computador um pouco, você ganhou uma pausa. :)
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
 
-![Figure 13.4](images/donut.png)
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/pt/django_urls/README.md b/pt/django_urls/README.md
index 5538dad2a57..c491b27de5c 100755
--- a/pt/django_urls/README.md
+++ b/pt/django_urls/README.md
@@ -1,20 +1,21 @@
 # Django URLs
 
-Estamos prestes a construir nossa primeira página Web - uma página inicial para o seu blog! Mas primeiro, vamos aprender um pouco mais sobre Django URLs.
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
 
-## O que é uma URL?
+## What is a URL?
 
-Uma URL é simplesmente um endereço web, você pode ver uma URL toda vez que você visita qualquer site - é visível na barra de endereços do seu navegador (Sim! `127.0.0.1:8000` é uma URL! E http://djangogirls.org também é uma URL):
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
 
 ![Url](images/url.png)
 
-Cada página na Internet precisa de sua própria URL. Desta forma, seu aplicativo sabe o que deve mostrar ao usuário que abre uma URL. No Django, nós usamos algo chamado `URLconf` (configuração de URL), que é um conjunto de padrões que o Django vai tentar coincidir com a URL recebida, para encontrar a visão correta.
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
 
-## Como funcionam as URLs em Django?
+## How do URLs work in Django?
 
-Vamos abrir o arquivo `mysite/urls.py` e ver com que ele se parece:
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
 
 {% filename %}mysite/urls.py{% endfilename %}
+
 ```python
 """mysite URL Configuration
 
@@ -28,56 +29,58 @@ urlpatterns = [
 ]
 ```
 
-Como você pode ver, o Django já colocou alguma coisa lá pra nós.
+As you can see, Django has already put something here for us.
 
-Linhas entre aspas triplas (`'''` ou `"""`)  são chamadas docstrings – você pode escrevê-las no início do arquivo, classe ou
-método para descrever o que é feito. Essas linhas não serão executadas pelo Python.
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
 
-A URL do admin, que você visitou no capítulo anterior já está aqui:
+The admin URL, which you visited in previous chapter, is already here:
 
 {% filename %}mysite/urls.py{% endfilename %}
+
 ```python
     url(r'^admin/', admin.site.urls),
 ```
 
-Isso significa que para cada URL que começa com `admin /` o Django irá encontrar uma *view* correspondente. Neste caso nós estamos incluindo um monte de URLs admin para que isso não fique tudo empacotado neste pequeno arquivo -- fica mais legível e mais limpo.
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
 
 ## Regex
 
-Você quer saber como o Django coincide as URLs com as views? Bem, esta parte é complicada. o Django usa a `regex` -- abreviação de "expressões regulares". Regex tem muitas (muitas!) normas que formam um padrão de pesquisa. Como regexes são um tópico avançado, nós não veremos em detalhes como elas funcionam.
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
 
-Se você ainda quiser entender como criamos os padrões, aqui está um exemplo do processo - só precisamos de um subconjunto limitado de regras para expressar o padrão que procuramos, ou seja:
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
 
-* `^` para o início do texto
-* `$` para o final do texto
-* `\d` para um dígito
-* `+` para indicar que o item anterior deve ser repetido pelo menos uma vez 
-* `()` para capturar parte do padrão
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
 
-Qualquer outra coisa na definição da url será literalmente considerada.
+Anything else in the URL definition will be taken literally.
 
-Agora imagine que você tem um site com o endereço assim: `http://www.mysite.com/post/12345/`, onde `12345` é o número do seu post.
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
 
-Escrever views separadas para todos os números de post seria muito chato. Com expressões regulares podemos criar um padrão que irá coincidir com a url e extrair o número para nós: `^post/(\d+)/$`. Vamos separar em etapas o que estamos fazendo aqui:
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
 
-*   **^post/** está dizendo ao Django para pegar tudo que tenha `post/` no início da url (logo após o `^`)
-*   **(\d+)** significa que haverá um número (um ou mais dígitos) e que queremos o número capturado e extraído
-*   **/** diz para o Django que outro caractere `/` deve estar na sequência
-*   **$** indica o final da URL, significando que apenas sequências terminando com o `/` irão corresponder a esse padrão
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
 
-## Sua primeira URL Django!
+## Your first Django URL!
 
-É hora de criar nossa primeira URL! Queremos http://127.0.0.1:8000 / para ser uma página inicial do nosso blog e exibir uma lista de posts.
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
 
-Também queremos manter o arquivom`mysite/urls.py` limpo, então nós importaremos as URLs da nossa aplicação `blog` para o arquivo principal `mysite/urls.py`.
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
 
-Vá em frente, adicione uma linha que irá importar `blog.urls`. Note que nós estamos usando a função `include` aqui, então **você precisará** adicionar ela no "import", na primeira linha do arquivo.
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
 
-Seu arquivo `mysite/urls.py` deve agora se parecer com isso:
+Your `mysite/urls.py` file should now look like this:
 
 {% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import include
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
@@ -86,39 +89,41 @@ urlpatterns = [
 ]
 ```
 
-O Django agora irá redirecionar tudo o que entra em 'http://127.0.0.1:8000 /'para `blog.urls` e procurar por novas instruções lá.
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
 
-Ao escrever expressões regulares em Python sempre é colocado `r` na frente da sequência de caracteres ("string"). Isso é só uma dica útil para Python que a sequência pode conter caracteres especiais que não são destinadas para Python em si, mas em vez disso são parte da expressão regular.
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
 
 ## blog.urls
 
-Crie um novo arquivo vazio `blog/urls.py`. Tudo bem! Adicione estas duas primeiras linhas:
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
 ```
 
-Aqui nós estamos apenas importando a função `url` do Django e todos as nossas `views` do aplicativo `blog` (ainda não temos nenhuma, mas teremos em um minuto!)
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
 
-Depois disso nós podemos adicionar nosso primeiro padrão de URL:
+After that, we can add our first URL pattern:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
 ]
 ```
 
-Como você pode ver, estamos agora atribuindo uma `view` chamada `post_list` para a URL `^$`. Essa expressão regular corresponderá a `^` (um começo) seguido por `$` (um fim) - então somente uma sequência vazia irá corresponder. E isso está correto, porque para os resolvedores de URL do Django, ' http://127.0.0.1:8000 /' não é uma parte da URL. Este padrão irá mostrar ao Django que `views.post_list` é o lugar certo para ir, se alguém entra em seu site pelo endereço 'http://127.0.0.1:8000 /'.
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
 
-A última parte, `name='post_list'`, é o nome da URL que será usado para identificar a view. Ele pode ser o mesmo nome da view, mas também pode ser algo completamente diferente. Nós iremos usar URLs nomeadas mais tarde no projeto, então é importante nomear cada URL da app. Nós devemos também tentar manter os nomes das URLs únicos e fáceis de lembrar.
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
 
-Se você tentar visitar http://127.0.0.1:8000/ agora, então você verá uma mensagem do tipo 'web page not available' (página não disponível). Isso acontece porquê o servidor (lembra de digitar `runserver`?) não está mais rodando. De uma olhada na janela do console do servidor para descobrir o porquê.
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
 
 ![Error](images/error1.png)
 
-O seu console está exibindo um erro, mas não se preocupe – ele é bem útil: Ele está dizendo a você que existe um __no attribute 'post_list'__. Esse é o nome da *view* que o Django está tentando encontrar e usar, mas nós ainda não a criamos. Nesse momento sua `/admin/` também não funciona. Não se preocupe – nós chegaremos lá.
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
 
-> Se você quer saber mais sobre Django URLconfs, veja a documentação oficial: https://docs.djangoproject.com/en/1.9/topics/http/urls/
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/pt/django_views/README.md b/pt/django_views/README.md
index 402c336aa70..07afe091a52 100755
--- a/pt/django_views/README.md
+++ b/pt/django_views/README.md
@@ -1,42 +1,44 @@
-# Views Do Django - hora de criar!
+# Django views – time to create!
 
-É hora de resolver o bug que criamos no capítulo anterior :)
+Time to get rid of the bug we created in the last chapter! :)
 
-Uma *view* é um lugar onde nós colocamos a "lógica" da nossa aplicação. Ela irá solicitar informações que estão no `model` que você criou anteriormente e passá-las para um `template`. Nós vamos criar um template no próximo capítulo. Views são apenas funções Python que são um pouco mais complicadas do que aquelas que fizemos no capítulo **Introdução ao Python**.
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
 
-As views são postas no arquivo `views.py`. Nós vamos adicionar nossas *views* no arquivo `blog/views.py`.
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
 
 ## blog/views.py
 
-OK, vamos abrir esse arquivo e ver o que tem nele:
+OK, let's open up this file and see what's in there:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
 # Create your views here.
 ```
 
-Não tem muita coisa ainda.
+Not too much stuff here yet.
 
-Lembre-se que as linhas iniciadas com `#` são comentários – isso significa que essas linhas não serão executadas pelo Python.
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
 
-A *view* mais simples pode se parecer com isso:
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Como você pode ver, nós criamos uma função (`def`) chamada `post_list` que recebe um `request` e `retorna (return)` uma função `render` será irá renderizar (montar) nosso modelo `blog/post_list.html`.
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
 
-Salve o arquivo, vá para http://127.0.0.1:8000 / e veja o que temos agora.
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
 
-Outro erro! Leia o que está acontecendo agora:
+Another error! Read what's going on now:
 
 ![Error](images/error.png)
 
-Esse mostra que o servidor está, pelo menos, rodando novamente. Mas ainda não é o suficiente, ou é? Não se preocupe, é apenas uma página de erro, nada para se ter medo! Assim como nas mensagens de erro em um console, elas são muito úteis. Você pode ler que o template não existe - *TemplateDoesNotExist*. Vamos consertar esse bug e criar um template no próximo capítulo!
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
 
-> Aprenda mais sobre as views do Django lendo a documentação oficial:  https://docs.djangoproject.com/en/1.9/topics/http/views/
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/pt/dynamic_data_in_templates/README.md b/pt/dynamic_data_in_templates/README.md
index f2db6d28709..807bb666ebc 100755
--- a/pt/dynamic_data_in_templates/README.md
+++ b/pt/dynamic_data_in_templates/README.md
@@ -1,14 +1,15 @@
-# Dados dinânmicos nos templates
+# Dynamic data in templates
 
-Nós temos diferentes peças aqui: o model `Post` está definido em `models.py`, nós temos `post_list` no `views.py` e o template adicionado. Mas como nós faremos de fato para fazer com que as nossas postagens apareçam no nosso template em HTML? Porque é isso que nós queremos: pegar algum conteúdo (models salvos no banco de dados) e exibi-lo de uma maneira bacana no nosso template, certo?
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
 
-E isso é exatamente o que as *views* devem fazer: conectar models e templates. Na nossa *view* `post_list` nós vamos precisar pegar os models que queremos exibir e passá-los para o template. Então, basicamente, em uma *view* nós decidimos o que (um model) será exibido no template.
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
 
-Certo, e como nós faremos isso?
+OK, so how will we achieve this?
 
-Precisamos abrir o nosso `blog/views.py`. Até agora a *view*`post_list` se parece com isso:
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
@@ -16,33 +17,35 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Lembra quando falamos sobre a inclusão de código escrito em arquivos diferentes? Agora é o momento em que temos de incluir o model que temos escrito em `models.py`. Vamos adicionar a linha `from .models import Post` desta forma:
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from .models import Post
 ```
 
-O ponto antes de `models` significa o *diretório atual* ou o *aplicativo atual*. Ambos `views.py` e `models.py` estão no mesmo diretório. Isso significa que ns podemos usar um `.` e o nome do arquivo (sem `.py`). Então nós importamos o nome do modelo (`Post`).
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
 
-E o que vem agora? Para pegar os posts reais do model `Post` nós precisamos de uma coisa chamada `QuerySet`.
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
 
 ## QuerySet
 
-Você já deve estar familiarizada com o modo que os QuerySets funcionam. Nós conversamos sobre isso no [capítulo Django ORM (QuerySets)](../django_orm/README.md).
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
 
-Agora nós estamos interessadas em uma lista de posts que são publicados e classificados por `published_date`, certo? Nós já fizemos isso no capítulo QuerySets!
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
 ```
 
-Agora nós colocamos este pedaço de código dentro do arquivo `blog/views.py` adicionando-o à função `def post_list(request)`,
-mas não se esqueça de primeiro adicionar `from django.utils import timezone`:
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from django.utils import timezone
@@ -53,15 +56,16 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-A última, e omitida, parte está passando o QuerySet para o template de contexto. Não se preocupe – nós iremos explicar como exibir ele posteriormente.
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
 
-Por favor, note que criamos uma *variável* para o nosso QuerySet: `posts`. Trate isto como o nome do nosso QuerySet. De agora em diante nós podemos nos referir a ele por este nome.
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
 
-Na função `render` nós temos um parâmetro `request` (tudo o que recebemos do usuário através da Internet) e outro informando o arquivo de template (`'blog/post_list.html'`). O último parâmetro, `{}`, é o lugar em que podemos acrescentar algumas coisas para que o template use. Precisamos nomeá-los (ficaremos com `'posts'` por enquanto :)). Deve ficar assim: `{'posts': posts}`. Por favor, observe que a parte antes de `:` é uma string; você precisa envolver ela com aspas: `''`.
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
 
-Então, finalmente nosso arquivo `blog/views.py` deve se parecer com isto:
+So finally our `blog/views.py` file should look like this:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from django.utils import timezone
@@ -72,6 +76,6 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {'posts': posts})
 ```
 
-Feito! Hora de voltar para o nosso template e exibir essa QuerySet!
+That's it! Time to go back to our template and display this QuerySet!
 
-Se quiser ler mais sobre QuerySets no Django você deve dar uma olhada aqui: https://docs.djangoproject.com/en/1.9/ref/models/querysets/
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/pt/extend_your_application/README.md b/pt/extend_your_application/README.md
index 2b886777b14..0bae760be7c 100755
--- a/pt/extend_your_application/README.md
+++ b/pt/extend_your_application/README.md
@@ -1,17 +1,17 @@
-# Amplie sua aplicação
+# Extend your application
 
-Já concluímos todos os passos necessários para a criação do nosso site: sabemos como criar um modelo, uma url, uma view e um template. Também sabemos como melhorar a aparência do nosso website.
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
 
-Hora de praticar!
+Time to practice!
 
-A primeira coisa que precisamos no nosso blog é, obviamente, uma página para mostrar uma postagem, certo?
+The first thing we need in our blog is, obviously, a page to display one post, right?
 
-Já temos um modelo de `Post`, então não precisamos adicionar nada ao `models.py`.
+We already have a `Post` model, so we don't need to add anything to `models.py`.
 
-## Criar um link de template para um "detalhe" da postagem
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-Vamos começar com a adição de um link dentro do arquivo `blog/templates/blog/post_list.html`. Neste momento ele deve se parecer com:
-{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
 {% extends 'blog/base.html' %}
 
@@ -28,112 +28,122 @@ Vamos começar com a adição de um link dentro do arquivo `blog/templates/blog/
 {% endblock %}
 ```
 
-{% raw %}Nós queremos ter um link com o título da postagem na lista de postagens para a página de detalhes da postagem. Vamos mudar `<h1><a href="">{{ post.title }}</a></h1>` para que ele redirecione para a página de detahles da postagem:{% endraw %}
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
 ```
 
-{% raw %}Tempo para explicar o misterioso `{% url 'blog.views.post_detail' pk=post.pk %}`. Como você pode suspeitar, a notação  `{% %}` significa que estamos usando as tags de template do Django. Desta vez, vamos usar uma que vai criar uma URL para nós!{% endraw %}
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
 
-`blog.views.post_detail` é um caminho para uma *view* `post_detail` que queremos criar. Preste atenção: `blog` é o nome da sua aplicação (o diretório `blog`), `views` vem do nome do arquivo `views.py` e, a última parte - `post_detail` - é o nome da *view*.
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
 
-Agora quando formos para: http://127.0.0.1:8000/ teremos um erro (como esperado, já que não temos uma URL ou uma *view* para `post_detail`). Vai se parecer com isso:
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
 
 ![NoReverseMatch error](images/no_reverse_match2.png)
 
 ## Create a URL to a post's detail
 
-Vamos criar a URL em `urls.py` para a nossa *view* `post_detail`!
+Let's create a URL in `urls.py` for our `post_detail` *view*!
 
-Nós queremos que nosso primerio detalhe de postagem seja exibido através dessa **URL**: http://127.0.0.1:8000/post/1/
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
 
-Vamos criar uma URL no arquivo `blog/urls.py` para direcionar o Django para uma *view* de nome `post_detail`, que irá exibir uma postagem de blog completa. Adicione a linha `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` ao arquivo `blog/urls.py`. O arquivo deve ficar dessa forma:
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
 
 urlpatterns = [
-    url(r'^$', views.post_list),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
 ```
 
-O trecho ``^post/(?P<pk>\d+)/$`` parece assustador, mas não se preocupe – nós iremos explicar ele para você:
- - ele começa com `^` novamente - "o início".
-- `post/` apenas significa que após o início, a URL deve ter a palavra __post__ e um __/__. Até aqui, tudo bem. 
-- `(?P<pk>\d+)` - essa parte é mais complicada. Isso significa que o Django vai pegar tudo que você colocar aqui e transferir para uma view através de uma variável chamada `pk`. `\d` também nos diz que só pode ser um número, não uma letra (tudo entre 0 e 9). `+` significa que precisa existir um ou mais dígitos. Então, algo como `http://127.0.0.1:8000/post//`, não é válido, mas `http://127.0.0.1:8000/post/1234567890/` é perfeitamente ok!
-- `/` - então precisamos de um __/__ outra vez.
-- `$` - "o fim"!
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
 
-Isso significa que, se você digitar `http://127.0.0.1:8000/post/5/` em seu navegador, Django vai entender que você está procurando uma *view* chamada `post_detail` e transferir a informação de que `pk` é igual a `5` para aquela *view*.
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
 
-`pk` é uma abreviação para `primary key` (chave primária). Esse é o nome geralmente usado nos projetos feitos em Django. Mas você pode dar o nome que quiser às variáveis (lembre-se: minúsculas e `_` ao invés de espaços em branco!). Por exemplo em vez de `(?P<pk>\d+)` podemos ter uma variável`post_id`, então esta parte ficaria como: `(?P<post_id>\d+)`.
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
 
-OK, nós adicionamos um novo padrão de URL ao `blog/urls.py`! Vamos atualizar a página: http://127.0.0.1:8000/ Boom! O servidor parou de funcionar novamente. Dê uma olhada no console – como esperado, temos outro erro!
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
 
 ![AttributeError](images/attribute_error2.png)
 
-Você se lembra qual é o próximo passo? Claro: adicionar uma view!
+Do you remember what the next step is? Of course: adding a view!
 
-## Adicioando a view de detalhe da postagem
+## Add a post's detail view
 
-Desta vez a nossa *view* recebe um parâmetro extra, `pk`. Nossa *view* precisa pegá-la, certo? Então vamos definir nossa função como `def post_detail (request, pk):`. Observe que precisamos usar exatamente o mesmo nome que especificamos em urls (`pk`). Omitir essa variável é errado e resultará em um erro!
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
 
-Agora queremos receber apenas um post do blog. Para isso podemos usar querysets como este:
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 Post.objects.get(pk=pk)
 ```
 
-Mas este código tem um problema. Se não houver nenhum `Post` com a `chave primária` (`pk`) fornecida teremos um erro horroroso!
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
 
 ![DoesNotExist error](images/does_not_exist2.png)
 
-Não queremos isso! Mas, claro, o Django vem com algo que vai lidar com isso para nós: `get_object_or_404`. Caso não haja nenhum `Post` com o `pk` informado, ele exibirá uma página muito mais agradável (chamada `Page Not Found 404` - página não encontrada).
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
 
 ![Page not found](images/404_2.png)
 
-A boa notícia é que você realmente pode criar sua própria página de `Page not found` e torná-la tão bonita quanto você quiser. Mas isso não é super importante agora, então nós vamos pular essa parte.
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
 
-Ok, hora de adicionar uma *view* ao nosso arquivo `views.py`!
+OK, time to add a *view* to our `views.py` file!
 
-Devemos abrir `blog/views.py` e adicionar o seguinte código perto das outras linha com `from`:
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render, get_object_or_404
 ```
 
-E no final do arquivo, adicionaremos a nossa *view*:
+And at the end of the file we will add our *view*:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_detail(request, pk):
     post = get_object_or_404(Post, pk=pk)
     return render(request, 'blog/post_detail.html', {'post': post})
 ```
 
-Sim. Está na hora de atualizar a página: http://127.0.0.1:8000 /
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
 
 ![Post list view](images/post_list2.png)
 
-Funcionou! Mas o que acontece quando você clica em um link no título do post do blog?
+It worked! But what happens when you click a link in blog post title?
 
 ![TemplateDoesNotExist error](images/template_does_not_exist2.png)
 
-Ah não! Outro erro! Mas nós já sabemos como lidar com isso, não é? Precisamos adicionar um template!
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
 
-## Criação de um template para o detalhe da postagem
+## Create a template for the post details
 
-Vamos criar um arquivo em `blog/templates/blog` chamado `post_detail.html`.
+We will create a file in `blog/templates/blog` called `post_detail.html`.
 
-Será algo parecido com isto:
+It will look like this:
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -150,38 +160,38 @@ Será algo parecido com isto:
 {% endblock %}
 ```
 
-Mais uma vez estamos estendendo `base.html`. No bloco `content` queremos exibir o published_date (data de publicação) da postagem (se houver), título e texto. Mas devemos discutir algumas coisas importantes, certo?
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
 
-{% raw %}`{% if ... %} ... {% endif %}` é uma tag de template que podemos usar quando queremos verificar algo (Lembra do `if ... else...` do **capítulo introdução ao Python**?). Neste cenário, queremos verificar se `published_date` de uma postagem não está vazia.{% endraw %}
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
 
-Ok, podemos atualizar nossa página e ver se o  `TemplateDoesNotExist`já se foi.
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
 
 ![Post detail page](images/post_detail2.png)
 
-Yay! Funciona!
+Yay! It works!
 
-## Mais uma coisa: hora de implantar!
+## One more thing: deploy time!
 
-Seria bom ver se seu site ainda estará trabalhando em PythonAnywhere, certo? Vamos tentar fazer deploy novamente.
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
-$ git push
-```
 
-Então, em um [console Bash do PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd my-first-blog
-$ git pull
-[...]
-```
 
-E finalmente, pule para a [tab Web](https://www.pythonanywhere.com/web_app_setup/) e aperte **Reload**.
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
 
-E deve ser isso! Parabéns :)
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/pt/how_the_internet_works/README.md b/pt/how_the_internet_works/README.md
index 89851d94849..efd95c3f4b2 100755
--- a/pt/how_the_internet_works/README.md
+++ b/pt/how_the_internet_works/README.md
@@ -1,45 +1,47 @@
-# Como funciona a internet
+# How the Internet works
 
-> Este capítulo é inspirado na palestra "Como a Internet funciona" de Jessica McKellar (http://web.mit.edu/jesstess/www/).
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
 
-Apostamos que você usa a Internet todos os dias. Mas você sabe realmente o que acontece quando você digita um endereço como https://djangogirls.org em seu navegador e pressiona `Enter`?
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
 
-A primeira coisa que você precisa entender é que um site é só um monte de arquivos salvos em um disco rígido. Assim como acontece com os filmes, músicas ou fotos que você tem no computador. No entanto, existe uma parte que é exclusiva para sites: essa parte inclui código de computador chamado HTML.
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
 
-Se você não estiver familiarizada com programação, pode ser difícil compreender o HTML no começo, mas seu navegador web (como o Chrome, Safari, Firefox, etc) ama ele. Navegadores web são projetados para entender esse código, seguir suas instruções e apresentar todos esses arquivos de que seu site é feito, exatamente do jeito que você quer que eles sejam apresentados.
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
 
-Então, igual a todos os outros arquivos, os arquivos HTML precisam ser armazenados em um disco rígido. Para a internet, nós usamos especiais e poderosos computadores chamados de *servidores*. Eles não têm tela, mouse ou teclado, porque sua finalidade principal é armazenar dados e servi-los. É por isso que eles são chamados de *servidores*..--porque eles *servem*, a você, dados.
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
 
-OK, mas você quer saber com o quê a internet se parece, certo?
+OK, but you want to know how the Internet looks, right?
 
-Fizemos um desenho pra você! Veja:
+We drew you a picture! It looks like this:
 
-![Figura 1.1](images/internet_1.png)
+![Figure 1.1](images/internet_1.png)
 
-Parece uma bagunça, não é? Na verdade é uma rede de máquinas conectadas (os *servidores* mencionados acima). Centenas de milhares de máquinas! Muitos, muitos quilômetros de cabos por todo o mundo! Para ver o quão complicada a internet é, você pode visitar um site (http://submarinecablemap.com/) que mostra um mapa com os cabos submarinos. Aqui está uma captura de tela do site:
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
 
-![Figura 1.2](images/internet_3.png)
+![Figure 1.2](images/internet_3.png)
 
-Fascinante, não? Mas, obviamente, não é possível ter um cabo que ligue todas as todas máquinas conectas na internet. Logo, para chegar em uma máquina (por exemplo aquela onde https://djangogirls.org está salva), nós precisamos passar uma requisição através de muitas e muitas máquinas diferentes.
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
 
-O que parece com isso:
+It looks like this:
 
-![Figura 1.3](images/internet_2.png)
+![Figure 1.3](images/internet_2.png)
 
-Imagine que, quando você digita https://djangogirls.org, você envia uma carta que diz: "Queridas djangoGirls.org, eu desejo ver o site da Django Girls. Envie pra mim, por favor!"
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
 
-Sua carta vai para a agência dos correios mais próxima de você. Depois vai para outra que é um pouco mais perto de seu destinatário, depois para outra e outra, até que ela seja entregue ao seu destino. A única diferença é que, se você enviar muitas cartas (*pacotes de dados*) para o mesmo lugar, cada carta pode passar por diferentes agências de correios (*roteadores*). Isso depende de como elas são distribuídas em cada agência.
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
 
-![Figura 1.4](images/internet_4.png)
+![Figure 1.4](images/internet_4.png)
 
-Sim, é simples assim. Você envia mensagens e espera alguma resposta. Claro, ao invés de papel e caneta você usa bytes de dados, mas a ideia é a mesma!
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
 
-Em vez de endereços com o nome da rua, cidade, código postal e nome do país, nós usamos endereços IP. Primeiro, seu computador pede ao DNS (Domain Name System - Sistema de Nome de Domínio) para traduzir djangogirls.org para um endereço IP. O funcionamento dele se parece um pouco com as antigas listas telefônicas onde você pode olhar para o nome da pessoa que quer entrar em contato e achar o seu número de telefone e endereço.
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
 
-Quando você envia uma carta, ela precisa ter certas características para ser entregue corretamente: um endereço, selo, etc. Você também usa uma linguagem que o receptador compreende, certo? O mesmo acontece com os *pacotes de dados* que você envia para ver um site: você usa um protocolo chamado HTTP (Hypertext Transfer Protocol - Protocolo de Transferência de Hipertexto).
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
 
-Então, basicamente, quando você tem um site, você precisa ter um *servidor* (máquina) onde ele fica hospedado. O *servidor* está à espera de quaisquer *requisições* recebidas (cartas que solicitam ao servidor o envio do seu site) e ele envia de volta seu site (em outra carta).
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
 
-Como este é um tutorial de Django você vai perguntar o que o Django faz. Quando você envia uma resposta nem sempre você quer enviar a mesma coisa para todo mundo. Será muito melhor se suas cartas forem personalizadas, especial para a pessoa que acabou de escrever para você, certo? O Django ajuda você a criar essas personalizadas e interessantes cartas :).
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
 
-Chega de falar, é hora de criar!
+Enough talk – time to create!
\ No newline at end of file
diff --git a/pt/html/README.md b/pt/html/README.md
index 92e9b15e081..004985089c2 100755
--- a/pt/html/README.md
+++ b/pt/html/README.md
@@ -1,44 +1,44 @@
-# Introdução a HTML
+# Introduction to HTML
 
-Você pode se perguntar: e o que é um template?
+What's a template, you may ask?
 
-Um template é um arquivo que nós podemos reutilizar para apresentar diferentes informações de uma forma consistente. Por exemplo, você poderia usar um template para te ajudar a escrever uma carta, pois, embora cada carta possua uma mensagem e um destino diferente, todas compartilham o mesmo formato.
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
 
-O formato do template do Django é descrito em uma linguagem chamada HTML (esse é o mesmo HTML que mencionamos no primeiro capítulo __Como a Internet funciona__).
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
 
-## O que é HTML?
+## What is HTML?
 
-HTML é um código simples que é interpretado pelo seu navegador web - como o Chrome, o Firefox ou o Safari - para exibir uma página web para o usuário.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
-HTML significa "HyperText Markup Language". __HiperText__ significa que é um tipo de texto que suporta hiperlinks entre páginas. __Markup__ nada mais é que marcar um documento com códigos que dizem para alguém (nesse caso, o navegador web) como a página deverá ser interpretada. Código em HTML é feito com __tags__, cada uma começando com `<` e terminando com `>`. Essas tags marcam os __elementos__.
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
 
-## Seu primeiro template!
+## Your first template!
 
-Criar um template significa criar um arquivo de template. Tudo é um arquivo, certo? Provavelmente você já deve ter notado isso.
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
 
-Os templates são salvos no diretório `blog/templates/blog`. Então, crie um diretório chamado `templates` dentro do diretório do seu blog. Em seguida, crie outro diretório chamado `blog` dentro da diretório templates:
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
 
     blog
     └───templates
         └───blog
     
 
-(Você deve estar se perguntando porque nós precisamos de dois diretórios chamados `blog` - como você descobrirá mais para frente, essa é uma simples e útil convenção que facilita a vida quando as coisas começarem a ficar mais complicadas.)
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
 
-E agora crie o arquivo `post_list.html` (deixe-o em branco por agora) dentro do diretório `blog/templates/blog`.
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
 
-Veja como o nosso site está se parecendo agora: http://127.0.0.1:8000/
+See how your website looks now: http://127.0.0.1:8000/
 
-> Se ocorrer um erro de `TemplateDoesNotExists` tente reiniciar o seu servidor. Entre na linha de comando, pare o servidor pressionando Ctrl+C (Control seguido da tecla C, juntas) e reinicie-o rodando `python manage.py runserver`.
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
 
 ![Figure 11.1](images/step1.png)
 
-Acabaram-se os erros! Parabéns :) Entretanto, nosso site não mostra nada a não ser uma página em branco. Isso porque o nosso template está vazio. Então precisamos consertar isso.
-
-Adicione a seguinte linha dentro do template:
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
 
+Add the following to your template file:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <p>Hi there!</p>
@@ -46,28 +46,29 @@ Adicione a seguinte linha dentro do template:
 </html>
 ```
 
-Como nosso site se parece agora? Clique para descobrir: http://127.0.0.1:8000/
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
 
 ![Figure 11.2](images/step3.png)
 
-Funcionou! Bom trabalho :)
+It worked! Nice work there :)
 
-- A tag mais básica, `<html>`, estará sempre no começo de qualquer página da web, assim como, `</html>` sempre estará no fim. Como você pode ver, todo o conteúdo de um website se encontra entre a tag de início `<html>` e entre a tag de fim `</html>`
-- `<p>` é a tag que denomina parágrafos; `</p>` determina o fim de cada parágrafo
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
 
-## Head & body
+## Head and body
 
-Cada página HTML também é dividida em dois elementos: __head__ (cabeça) e __body__ (corpo).
+Each HTML page is also divided into two elements: **head** and **body**.
 
-- __head__ é um elemento que contém informações sobre o documento que não são mostradas na tela.
+* **head** is an element that contains information about the document that is not displayed on the screen.
 
-- __body__ é um elemento que contém tudo o que é exibido como parte de uma página de um site.
+* **body** is an element that contains everything else that is displayed as part of the web page.
 
-Nós usamos a tag `<head>` para dizer ao navegador sobre as configurações da página. Por sua vez, a tag `<body>` diz ao navegador o que há de verdade na página.
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
 
-Por exemplo, você pode por o elemento título de uma página web dentro da tag `<head>`. Veja:
+For example, you can put a web page title element inside the `<head>`, like this:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <head>
@@ -80,35 +81,37 @@ Por exemplo, você pode por o elemento título de uma página web dentro da tag
 </html>
 ```
 
-Salve o arquivo e atualize sua página.
+Save the file and refresh your page.
 
 ![Figure 11.3](images/step4.png)
 
-Viu como o navegador entendeu que "Ola's blog" é o título da página? Ele interpretou `<title>Ola's blog</title>` e colocou o texto na barra de título do seu navegador (e também será usado para os favoritos e outras coisas mais).
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
 
-Provavelmente você já deve ter notado que cada tag de abertura casa com uma _tag de fechamento_, com uma `/`, e que os elementos estão _aninhados_ (ex.: você não pode fechar uma tag em particular antes que todas as outras tags que estiverem dentro dela já estejam fechadas).
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
 
-É como colocar coisas dentro de caixas. Você tem uma grande caixa, `<html></html>`; dentro dela há `<body></body>`, sendo que esta ainda contém caixas menors: `<p></p>`.
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
 
-Você precisa seguir essas regras de _fechamento_ de tags, e de _aninhamento_ de elementos - se você não fizer isso, o navegador poderá não estar apto para interpretar seu código de maneira correta e sua página será exibida de maneira incorreta.
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
 
-## Customize seu template
+## Customize your template
 
-Agora você pode se divertir um pouco tentando customizar o seu template! Aqui estão algumas tags úteis para isso:
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
 
-- `<h1>Um título</h1>` - para o título mais importante
-- `<h2>Um sub-título</h2>` para um título um nível abaixo
-- `<h3>Um sub-sub-título</h3>` ... e por aí vai, até `<h6>`
-- `<em>texto</em>` enfatiza seu texto
-- `<strong>text</strong>` enfatiza fortemente seu texto
-- `<br />` pula para a próxima linha (você não pode colocar nada dentro de br)
-- `<a href="https://djangogirls.org">link</a>` cria um link
-- `<ul><li>primeiro item</li><li>segundo item</li></ul>` cria uma lista, exatamente como essa!
-- `<div></div>` define uma seção da página
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
 
-Aqui está um exemplo de um template completo:
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <head>
@@ -116,7 +119,7 @@ Aqui está um exemplo de um template completo:
     </head>
     <body>
         <div>
-            <h1><a href="">Django Girls Blog</a></h1>
+            <h1><a href="/">Django Girls Blog</a></h1>
         </div>
 
         <div>
@@ -134,81 +137,77 @@ Aqui está um exemplo de um template completo:
 </html>
 ```
 
-Nós criamos três seções `div` aqui.
+We've created three `div` sections here.
 
-- O primeiro elemento `div` possui o título do nosso blog - é um título e um link
-- Os outros dois elementos `div` possuem nossas postagens com a data de publicação, `h2` com o título da postagem que é clicável e dois `p`s (parágrafos) de texto, um para a data e outro para o texto da postagem.
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
 
-Isso nos dá o seguinte efeito:
+It gives us this effect:
 
 ![Figure 11.4](images/step6.png)
 
-Yaaay! Mas, até agora, nosso template mostra exatamante __sempre a mesma informação__ - sendo que, anteriormente, nós falávamos sobre templates como uma maneira para exibir informações __diferentes__ em um __mesmo formato__.
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
 
-O que nós realmente queremos fazer é exibir postagens reais que foram adicionadas no Django admin - e isso é o que faremos em seguida.
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
 
-## Mais uma coisa: implantação ("deploy")!
+## One more thing: deploy!
 
-Seria bom ver tudo isto na Internet, certo? Vamos fazer outra implantação ("deploy") no PythonAnywhere:
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
 
-### Commit, e ponha seu código no GitHub
-
-Primeiro de tudo, vejamos quais arquivos foram alterados desde a última implantação  (execute esses comandos localmente, não
-no PythonAnywhere):
+### Commit, and push your code up to Github
 
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-```
 
-Verifique se você está no diretório `djangogirls` e vamos dizer ao `git` para incluir todas as mudanças dentro deste diretório:
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
 
 {% filename %}command-line{% endfilename %}
-```
-$ git add --all .
-```
 
-> __Nota__ `--all` significa que o `git` também reconhecerá se você deletou algum arquivo (por padrão, o git apenas reconhece arquivos criados/modificados). Lembre-se também (do capítulo 3) que `.` significa o diretório atual.
+    $ git add --all .
+    
 
-Antes de nós fazermos o upload de todos os arquivos, vamos confirmar o que o `git` enviará (todos os arquivos que o `git` for enviar deverá aparece em verde):
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-```
 
-Estamos quase lá! Agora é hora de dizer a ele para salvar essa modificação em seu histórico. Nós daremos a ele uma "mensagem de commit" onde nós descrevemos as modificações que fizemos. Você pode escrever o que você quiser agora, mas será mais útil se você escrever alguma coisa mais descritiva, algo para você poder se lembrar, no futuro, das coisas que você fez.
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
 
 {% filename %}command-line{% endfilename %}
-```
-$ git commit -m "Changed the HTML for the site."
-```
 
-> __Nota__ Certifique-se que você usou aspas duplas para delimitar a mensagem do commit.
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
 
-Após termos feito isso, nós fazemos o upload (envio) das nossas mudanças para o PythonAnywhere:
+Once we've done that, we upload (push) our changes up to GitHub:
 
 {% filename %}command-line{% endfilename %}
-```
-$ git push
-```
 
-### Empurre seu novo código para o PythonAnywhere e recarregue o seu aplicativo web
+    $ git push
+    
 
-*   Abra a [página de consoles de PythonAnywhere] (https://www.pythonanywhere.com/consoles/) e vá para o seu **console Bash** (ou inicie um novo). Em seguida, execute:
- 
- {% filename %}command-line{% endfilename %}
-```
-$ cd ~/my-first-blog
-$ git pull
-[...]
-```
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
 
-E veja seu código sendo baixado. Se você deseja verificar se já chegou, pode ir para a **Files tab** e ver seu código no PythonAnywhere.
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
 
-*   Finalmente, pule para a [Web tab](https://www.pythonanywhere.com/web_app_setup/) e aperte **Reload** em seu aplicativo web.
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
 
- [6]: https://www.pythonanywhere.com/web_app_setup/
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
 
-Sua atualização deve estar ao vivo! Vá em frente e atualize seu site no navegador. As alterações devem ser visíveis :)
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/pt/installation/README.md b/pt/installation/README.md
index 43dee9094f8..a7c627136c8 100644
--- a/pt/installation/README.md
+++ b/pt/installation/README.md
@@ -1,53 +1,58 @@
-# Se você está lendo o tutorial em casa
+# If you're doing the tutorial at home
 
-Se você est lendo o tutorial em casa, e não em um [evento Django Girls](https://djangogirls.org/events/), você pode pular esse capítulo por completo agora e ir direto para o capítulo [Como a Internet funciona?](../how_the_internet_works/README.md).
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
 
-A razão disso é porque nós simplesmente cobrimos essas coisas por todo o tutorial, e essa é apenas uma página adicional que reune todas as instruções de instalação em um lugar só. O evento Django Girls inclui um "Install Fest" onde nós instalamos tudo para que não seja necessário nos preocuparmos com isso durante o workshop, então isso é útil para nós.
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
 
-Se você achar útil, você pode seguir adiante nesse capítulo também. Mas se você quiser começar a aprender antes de instalar um monte de coisas em seu computador, pule esse capítulo e nós iremos explicar a parte sobre instalação para você mais tarde.
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
 
-Boa Sorte!
+Good luck!
 
-# Instalação
-No workshop você irá criar um blog, e existem algumas etapas de configuração no tutorial que seria bom trabalharmos antecipadamente para que você esteja pronto para escrever código no dia do workshop.
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
 
 <!--sec data-title="Chromebook setup (if you're using one)"
-data-id="chromebook_setup" data-collapse=true ces-->
-{% include "/chromebook_setup/instructions.md" %}
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
 <!--endsec-->
 
-# Instale o Python
+# Install Python
+
 {% include "/python_installation/instructions.md" %}
 
-# Configure um ambiente virtual e instale o Django
+# Set up virtualenv and install Django
+
 {% include "/django_installation/instructions.md" %}
 
-# Instale um editor de código
+# Install a code editor
+
 {% include "/code_editor/instructions.md" %}
 
-# Instale o Git
+# Install Git
+
 {% include "/deploy/install_git.md" %}
 
-# Crie uma conta no GitHub
-Vá até o [GitHub.com](https://www.github.com) e registre ("sign up") uma conta de usuário nova e grátis.
+# Create a GitHub account
 
-# Crie uma conta PythonAnywhere
-{% include "/deploy/signup_pythonanywhere.md" %}
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
 
+# Create a PythonAnywhere account
 
-# Começe a leitura
+{% include "/deploy/signup_pythonanywhere.md" %}
 
-Parabéns, você está com tudo preparado para seguir adiante! Se você ainda tiver um tempo livre antes do workshop, seria bom começar a leitura dos capítulos iniciais:
+# Start reading
 
-* [Como a Internet funciona](../how_the_internet_works/README.md)
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
 
-* [Introdução a linha de comando](../intro_to_command_line/README.md)
+* [How the internet works](../how_the_internet_works/README.md)
 
-* [Introdução ao Python](../python_introduction/README.md)
+* [Introduction to the command line](../intro_to_command_line/README.md)
 
-* [O que é Django?](../django/README.md)
+* [Introduction to Python](../python_introduction/README.md)
 
+* [What is Django?](../django/README.md)
 
-# Aproveite o workshop!
+# Enjoy the workshop!
 
-Qunado você começar o workshop, você será capaz de ir direto para [Seu primeiro projeto Django!](../django_start_project/README.md) porque você já leu o material dos capítulos iniciais.
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/pt/intro_to_command_line/README.md b/pt/intro_to_command_line/README.md
index ef0b40045f2..5fb6d48dd1f 100755
--- a/pt/intro_to_command_line/README.md
+++ b/pt/intro_to_command_line/README.md
@@ -1,411 +1,429 @@
-# Introdução à linha de comando
+# Introduction to the command-line interface
 
-É emocionante, não?! Você vai escrever sua primeira linha de código em poucos minutos! :)
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
 
-**Deixe-nos apresentá-lo a sua primeira nova amiga: a linha de comando!**
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
 
-As etapas a seguir mostrarão a você como usar a janela preta que todos os hackers usam. Pode parecer um pouco assustador no começo, mas, na verdade, é apenas um prompt esperando por comandos seus.
+**Let us introduce you to your first new friend: the command line!**
 
-## O que é uma linha de comando?
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
 
-A janela, que normalmente é chamada de **linha de comando** ou **interface de linha de comando**, é um aplicativo baseado em texto para visualização, manipulação e manuseio de arquivos em seu computador (como por exemplo, o Windows Explorer ou o Finder no Mac, mas sem a interface gráfica). Outros nomes para a linha de comando são: *cmd*, *CLI*, *prompt*, *console* ou *terminal*.
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
 
-## Abra a interface de linha de comando
+## What is the command line?
 
-Para começar alguns experimentos, precisamos abrir a nossa interface de linha de comando primeiro.
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
 
-### Windows
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
 
-<!--sec data-title="Windows" data-id="windows_prompt" data-collapse=true ces-->
-Vá em Iniciar → Todos os Programas → Acessórios → Prompt de comando.
 <!--endsec-->
 
-### Mac OS X
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
 
-<!--sec data-title="OS X" data-id="OSX_prompt" data-collapse=true ces-->
-Applications → Utilities → Terminal.
 <!--endsec-->
 
-### Linux
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
 
-<!--sec data-title="Linux" data-id="linux_prompt" data-collapse=true ces-->
-Provavelmente você vai achar em Applications → Accessories → Terminal, mas isso depende do seu sistema operacional. Qualquer coisa é só procurar no Google :)
 <!--endsec-->
 
 ## Prompt
 
-Agora você deve agora estar vendo uma janela branca ou preta que está à espera de seus comandos.
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
 
-<!--sec data-title="OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
-Se você estiver em Mac ou num Linux, você provavelmente verá um `$`, como este:
 {% filename %}command-line{% endfilename %}
-```
-$
-```
+
+    $
+    
+
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_prompt2" data-collapse=true ces-->
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
 
-No Windows, é um sinal de `>`, como este:
+On Windows, it's a `>` sign, like this:
 
 {% filename %}command-line{% endfilename %}
-```
->
-```
-<!--endsec-->
+
+    >
     
 
-Cada comando será antecedido por este sinal e um espaço, mas você não precisa digitá-lo. Seu computador fará isso por você :)
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
 
-> Apenas uma pequena nota: no seu caso, talvez exista algo como `C:\Users\seunome>` ou `SeuNome-MacBook Air: ~ seunome$` antes do sinal do prompt isto estará 100% correto. Neste tutorial nós apenas simplificaremos ele para o mínimo.
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
 
-A parte até o e incluíndo o `$` ou o `>` é chamada  de prompt de linha de comando, ou para abreviar, prompt.  Ele está a esperando você digitar alguma coisa.
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
 
-## Seu primeiro comando (YAY!)
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
 
-Vamos começar com algo simples. Digite o seguinte comando:
+## Your first command (YAY!)
 
-<!--sec data-title="OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
-{% filename %}command-line{% endfilename %}
-```
-$ whoami
-```
-<!--endsec-->
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
 
-<!--sec data-title="Windows" data-id="windows_whoami" data-collapse=true ces-->
 {% filename %}command-line{% endfilename %}
-```
-> whoami
-```
+
+    $ whoami
+    
+
 <!--endsec-->
 
-Depois aperte o `Enter`. Esse é o nosso resultado:
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ whoami
-seunome
-```
 
-Como você pode ver, o computador acabou de apresentar seu nome de usuário. Elegante, não é?:)
-=======
+    > whoami
+    
+
 <!--endsec-->
 
-Depois tecle Enter. Essa é nossa saída:
+And then hit `enter`. This is our result:
 
 {% filename %}command-line{% endfilename %}
-```
-$ whoami
-seunome
-```
 
-Como você pode ver, o computador só apresentou seu nome de usuária. Elegante, né?:)
-
-> Tente digitar cada comando, não copiar e colar. Você vai se lembrar mais facilmente dessa forma!
+    $ whoami
+    olasitarska
+    
 
-## O Básico
+As you can see, the computer has just printed your username. Neat, huh? :)
 
-Cada sistema operacional tem o seu próprio conjunto de instruções para a linha de comando, então se certifique que você está seguindo as instruções do seu sistema operacional. Vamos tentar, certo?
+> Try to type each command; do not copy-paste. You'll remember more this way!
 
-### Pasta atual
+## Basics
 
-Seria legal saber em que pasta estamos agora, certo? Vamos ver. Digite o seguinte comando e aperte o `enter`:
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
 
+### Current directory
 
-<!--sec data-title="OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
 
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ pwd
-/Users/seunome
-```
 
-> Nota: 'pwd' quer dizer 'print working directory' (exiba diretório que estamos trabalhando).
+    $ pwd
+    /Users/olasitarska
+    
 
-<!--endsec-->
+> Note: 'pwd' stands for 'print working directory'.
 
-Windows:
+<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_cd" data-collapse=true ces-->
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> cd
-C:\Users\seunome
-```
-> Nota: 'cd' vem de 'change directory' (mude de diretório). Se seu Windows tem powershell, você pode usar pwd como no Linux ou Mac OS X.
 
-<!--endsec-->
+    > cd
+    C:\Users\olasitarska
+    
 
-Provavelmente você vai ver algo parecido na sua máquina. Geralmente, um vez que você abre a linha de comando você já começa na pasta Home.
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
 
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
 
 * * *
 
-### Listando arquivos e pastas
+### List files and directories
 
-Então o que tem nele? Seria legal descobrir. Vamos ver:
+So what's in it? It'd be cool to find out. Let's see:
 
-<!--sec data-title="OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ ls
-Applications
-Desktop
-Downloads
-Music
-...
-```
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_dir" data-collapse=true ces-->
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> dir
- Directory of C:\Users\seunome
-05/08/2014 07:28 PM <DIR>      Applications
-05/08/2014 07:28 PM <DIR>      Desktop
-05/08/2014 07:28 PM <DIR>      Downloads
-05/08/2014 07:28 PM <DIR>      Music
-...
-```
-<!--endsec-->* * *
 
-### Entrar em outra pasta
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
 
-Talvez a gente queira entrar na nossa pasta Desktop?
+### Change current directory
 
-<!--sec data-title="OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd Desktop
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_move_to" data-collapse=true ces-->
+    $ cd Desktop
+    
 
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> cd Desktop
-```
+
+    > cd Desktop
+    
+
 <!--endsec-->
 
-Veja se realmente entramos na pasta:
-<!--sec data-title="OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ pwd
-/Users/seunome/Desktop
-```
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
 <!--endsec-->
-<!--sec data-title="Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> cd
-C:\Users\seunome\Desktop
-```
-<!--endsec-->    
 
-Aqui está!
+    > cd
+    C:\Users\olasitarska\Desktop
+    
 
-> Dica de profissional: se você digitar `cd D` e apertar a tecla `tab` no seu teclado, a linha de comando irá preencher automaticamente o resto do nome para que você possa navegar rapidamente. Se houver mais de uma pasta que comece com "D", aperte a tecla `tab` duas vezes para obter uma lista de opções.
+<!--endsec-->
 
-* * *
+Here it is!
 
-### Criando uma pasta
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
 
-Que tal criar um diretório Django Girls na sua área de trabalho? Você pode fazer assim:
+* * *
+
+### Create directory
 
+How about creating a practice directory on your desktop? You can do it this way:
 
-<!--sec data-title="OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ mkdir djangogirls
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_mkdir" data-collapse=true ces-->
+    $ mkdir practice
+    
 
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> mkdir djangogirls
-```
-<!--endsec-->
+
+    > mkdir practice
     
-Este comando vai criar uma pasta com o nome `djangogirls` no nosso desktop. Você pode verificar se ela está lá, só de olhar na sua área de trabalho ou executando um comando `ls` (Mac ou Linux) ou `dir` (Windows)! Experimente :)
 
-> Dica de profissional: Se você não quiser digitar o mesmo comando várias vezes, tente pressionar `seta para cima` e `seta para baixo` no teclado para percorrer comandos usados recentemente.
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
 
 * * *
 
-### Exercite-se!
+### Exercise!
 
-Um pequeno desafio para você: dentro da pasta `djangogirls` que voce acabou de criar, crie uma outra pasta chamada `teste`. Use os comandos `cd` e `mkdir`.
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
 
-#### Solução:
+#### Solution:
 
-<!--sec data-title="OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd djangogirls
-$ mkdir test
-$ ls
-test
-```
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_test_dir" data-collapse=true ces-->
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> cd djangogirls
-> mkdir teste
-> dir
-05/08/2014 07:28 PM <DIR>      teste
-```
-<!--endsec-->    
 
-Parabéns! :)
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
 
 * * *
 
-### Limpando
+### Clean up
 
-Não queremos deixar uma bagunça, então vamos remover tudo o que fizemos até agora.
+We don't want to leave a mess, so let's remove everything we did until that point.
 
-Primeiro precisamos voltar para a pasta Desktop:
+First, we need to get back to Desktop:
 
-<!--sec data-title="OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd ..
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_back" data-collapse=true ces-->
+    $ cd ..
+    
+
+<!--endsec-->
 
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> cd ..
-```
+
+    > cd ..
+    
+
 <!--endsec-->
 
-Usando `..` com o comando `cd` nós mudaremos do diretório atual para o diretório pai (que significa o diretório que contém o diretório atual).
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
 
-Veja onde você está:
+Check where you are:
 
-<!--sec data-title="OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ pwd
-/Users/seunome/Desktop
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_cd3" data-collapse=true ces-->
+    $ pwd
+    /Users/olasitarska/Desktop
+    
 
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> cd
-C:\Users\seunome\Desktop
-```
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
 <!--endsec-->
 
-Agora é hora de excluir o diretório `djangogirls`.
+Now time to delete the `practice` directory:
 
-> **Atenção**: A exclusão de arquivos usando `del`, `rmdir` ou `rm` é irrecuperável, significando *Arquivos excluídos vão embora para sempre*! Então, tenha cuidado com este comando.
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
 
-<!--sec data-title="OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ rm -r djangogirls
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_rmdir" data-collapse=true ces-->
+    $ rm -r practice
+    
+
+<!--endsec-->
 
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> rmdir /S djangogirls
-djangogirls, Are you sure <Y/N>? Y
-```
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
 <!--endsec-->
-Pronto! Para ter certeza que a pasta foi realmente excluída, vamos checar:
 
-OS X e Linux:
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ ls
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_dir2" data-collapse=true ces-->
+    $ ls
+    
 
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> dir
-```
+
+    > dir
+    
+
 <!--endsec-->
 
-### Saindo
+### Exit
 
-Por enquanto é isso! Agora você fechar a linha de comando com segurança. Vamos fazer do jeito hacker, certo? :)
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
 
-<!--sec data-title="OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ exit
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_exit" data-collapse=true ces-->
+    $ exit
+    
 
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> exit
-```
-<!--endsec-->    
 
-Legal, não é? :)
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
 
-## Sumário
+## Summary
 
-Aqui vai uma lista de alguns comandos úteis:
+Here is a summary of some useful commands:
 
-| Comando (Windows) | Comando (Mac OS / Linux) | Descrição                     | Exemplo                                           |
-| ----------------- | ------------------------ | ----------------------------- | ------------------------------------------------- |
-| exit              | exit                     | Fecha a janela                | **exit**                                          |
-| cd                | cd                       | Muda a pasta                  | **cd test**                                       |
-| dir               | ls                       | Lista as pastas e os arquivos | **dir**                                           |
-| copy              | cp                       | Copia um arquivo              | **copy c:\test\test.txt c:\windows\test.txt** |
-| move              | mv                       | Move um arquivo               | **move c:\test\test.txt c:\windows\test.txt** |
-| mkdir             | mkdir                    | Cria uma pasta                | **mkdir testdirectory**                           |
-| del               | rm                       | Deleta uma pasta e/ou arquivo | **del c:\test\test.txt**                        |
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
 
-Estes são apenas alguns dos poucos comandos que você pode executar em sua linha de comando, mas você não vai usar mais nada do que isto hoje.
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
 
-Se você estiver curioso, [ss64.com](http://ss64.com) contém uma referência completa de comandos para todos os sistemas operacionais.
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
 
-## Pronta?
+## Ready?
 
-Vamos mergulhar no Python!
+Let's dive into Python!
\ No newline at end of file
diff --git a/pt/python_installation/README.md b/pt/python_installation/README.md
index 4e25eaf3a16..93f81cb42d9 100755
--- a/pt/python_installation/README.md
+++ b/pt/python_installation/README.md
@@ -1,15 +1,15 @@
-# Vamos começar com Python
+# Let’s start with Python
 
-Finalmente chegamos aqui!
+We're finally here!
 
-Mas primeiro, vamos falar um pouco sobre o que o Python é. Python é uma linguagem de programação muito popular que pode ser usada para criar sites, jogos, softwares científicos, gráficos e muito, muito mais.
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
 
-O Python é originário do final da década de 1980 e seu principal objetivo é ser legível por seres humanos (não apenas por máquinas!). Por isso ele parece muito mais simples do que outras linguagens de programação. Isso faz ele ser mais fácil de aprender, mas não se engane, Python também é muito poderoso!
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
 
-# Instalação do Python
+# Python installation
 
-> **Nota** Se você estiver usando um Chromebook, pule esse capítulo e certifique-se de seguir essas instruções [Chromebook Setup](../chromebook_setup/README.md).
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
 
-> **Nota** Se você já fez os passos de instalação, não existe necessidade de fazer isso de novo - você pode pular direto para o próximo capítulo!
-
-{% include "/python_installation/instructions.md" %}
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/pt/python_installation/instructions.md b/pt/python_installation/instructions.md
index 0299b8b3924..31cde2d0baf 100644
--- a/pt/python_installation/instructions.md
+++ b/pt/python_installation/instructions.md
@@ -1,107 +1,106 @@
-> Leitores em casa: esse capítulo está disponível em vídeo (em inglês) [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
 
-> Essa seção é baseada em um tutorial feito por Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
 
-O Django é escrito em Python. Nós precisamos de Python para fazer qualquer coisa com Django. Vamos começar instalando ele! Nós queremos que você instale o Python 3.5, então se você tiver alguma versão anterior, você precisará fazer uma atualização.
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
 
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
 
-<!--sec data-title="Windows" data-id="python_windows" data-collapse=true ces-->
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
 
-Primeiro verifique se o seu computador está rodando uma versão 32-bit ou uma versão 64-bit do Windows em https://support.microsoft.com/en-au/kb/827218. Você pode baixar o Python para Windows a partir do website
-https://www.python.org/downloads/windows/. Clique no link "Latest Python 3 Release - Python x.x.x". Se o seu computador está rodando uma versão **64-bit** do Windows, baixe o **Windows x86-64 executable installer**. Senão, baixe o **Windows x86 executable installer**. Após baixar o instalador, você deve executá-lo (duplo clique nele) e seguir as instruções apresentadas.
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
 
-Uma coisa para se atentar: Durante a instalação você irá notar uma janela com a marcação "Setup". Certifique-se de selecionar "Add Python 3.5 to PATH" na caixa de seleção e clicar em "Install Now", como mostrado aqui:
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
 
-![Não se esqueça de adicionar Python no Path](../python_installation/images/python-installation-options.png)
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
 
-Nos passos a seguir, você usará a Linha de Comando do Windows (**nós também iremos falar sobre ela com você**). Por enquanto, se você precisar digitar alguns comandos, vá para o menu Iniciar → Todos os Programas → Acessórios → Prompt de Comando. Você pode também manter pressionada a tecla Windows e pressionar a tecla "R" até a janela "Executar" ("Run") aparecer. Para abrir a Linha de Comando, digite "cmd" e pressione o enter na janela "Executar" ("Run"). (Nas versões mais novas do Windows, você pode precisar pesquisar por "Prompt de Comando" ("Command Prompt"), já que ele, às vezes está escondido.)
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
 
-![Digite "cmd" na janela "Executar" ("Run")](../python_installation/images/windows-plus-r.png)
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
 
-Nota: se você estiver usando uma versão antiga do Windows (7, Vista, ou qualquer uma anterior a essas) e o instalador do Python 3.5.x falhar com um erro, você pode tentar:
-1. instalar todas as Atualizações do Windows e tentar instalar Python 3.5 novamente; ou
-2. instalar uma [versão antiga do Python](https://www.python.org/downloads/windows/), por exemplo, [3.4.4](https://www.python.org/downloads/release/python-344/).
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
 
-Se você instalar um versão antiga do Python, a tela de instalação pode parecer um pouco diferente da mostrada abaixo. Certifique-se de rolar a página para baixo para ver "Add python.exe to Path", e então clique no botão a esquerda e escolha "Will be installed on local hard drive":
-
-![Adicionar o Python no Path, versões antigas](../python_installation/images/add_python_to_windows_path.png)
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
 
 <!--endsec-->
 
-<!--sec data-title="OS X" data-id="python_OSX"
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
 data-collapse=true ces-->
 
-> **Nota** Antes de você instalar o Python no OS X, você deve ter certeza que as configurações de seu Mac permitem a instalação de pacotes que não são da App Store. Vá até Preferências do Sistema (está na pasta Aplicações), clique em "Segurança & Privacidade," e então na aba "General". Se estiver configurado "Mac App Store" em "Allow apps downloaded from:", altere para "Mac App Store and identified developers."
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
 
-Você precisa ir no website https://www.python.org/downloads/release/python-351/ e baixar o instalador Python:
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
 
-* Baixe o arquivo *Mac OS X 64-bit/32-bit installer*,
-* Duplo clique em *python-3.5.1-macosx10.6.pkg* para rodar o instalador.
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
 
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="python_linux"
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
 data-collapse=true ces-->
 
-É bem provável que você já tenha o Python instalado. Para checar se você tem ele instalado (e qual versão é), abra o console e digite o seguinte comando:
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 --version
-Python 3.5.1
-```
 
-Se você tem uma 'micro versão' do Python diferente instalada, por exemplo 3.5.0, então você não precisa fazer uma atualização. Se você não tem o Python instalado, ou se você quer uma versão diferente, você pode instalá-la como a seguir:
+    $ python3 --version
+    Python 3.6.1
+    
 
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
 
 <!--endsec-->
 
-<!--sec data-title="Debian or Ubuntu" data-id="python_debian"
-data-collapse=true ces-->
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
 
 Type this command into your console:
 
 {% filename %}command-line{% endfilename %}
-```
-$ sudo apt-get install python3.5
-```
+
+    $ sudo apt-get install python3.6
+    
 
 <!--endsec-->
 
-<!--sec data-title="Fedora (22+)" data-id="python_fedora22"
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
 data-collapse=true ces-->
 
-Use esse comando em seu console:
+Use this command in your console:
 
 {% filename %}command-line{% endfilename %}
-```
-$ sudo dnf install python3
-```
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
 
 <!--endsec-->
 
-<!--sec data-title="openSUSE" data-id="python_openSUSE"
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
 data-collapse=true ces-->
 
-Use esse comando em seu console:
+Use this command in your console:
 
 {% filename %}command-line{% endfilename %}
-```
-$ sudo zypper install python3
-```
+
+    $ sudo zypper install python3
+    
 
 <!--endsec-->
 
-Verifique se a instalação foi feita com sucesso abrindo a aplicação *Terminal* e executando o comando `python3`:
+Verify the installation was successful by opening a command prompt and running the `python3` command:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 --version
-Python 3.5.1
-```
 
-**NOTA:** Se você estiver no Windows e retornar uma mensagem de erro dizendo que o `python3` não foi encontrado, tente usando `python` (sem o `3`) e cheque se ainda pode ser a versão 3.5 do Python.
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
 
-----
+* * *
 
-Se você tiver qualquer dúvida, ou se alguma coisa sair errado e você não tem ideia do que fazer, por favor pergunte ao seu treinador! Algumas vezes as coisas não correm de maneira fluida e é melhor pedir ajuda a alguém com mais experiência.
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/pt/python_introduction/README.md b/pt/python_introduction/README.md
index 7fef5529b2c..c1642302532 100755
--- a/pt/python_introduction/README.md
+++ b/pt/python_introduction/README.md
@@ -1,141 +1,149 @@
-# Introdução ao Python
+# Introduction to Python
 
-> Parte deste capítulo é baseado nos Tutoriais de Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 
-Vamos escrever um pouco de código!
+Let's write some code!
 
-## Interpretador Python
+## Python prompt
 
-> Leitores em casa: essa parte está disponível em vídeo (em inglês) [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
 
-Para começar a brincar com Python nós precisamos abrir uma *linha de comando* no seu computador. Você já deve saber como fazer isso -- você aprendeu no capítulo [Introdução à Linha de Comando][2].
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
 
-Assim que estiver pronto, siga as instruções abaixo.
+Once you're ready, follow the instructions below.
 
-Nós queremos abrir o Python em um terminal, então digite `python` no Windows, `python3` no Mac OS/Linux, e tecle `Enter`.
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3
-Python 3.5.1 (...)
-Type "help", "copyright", "credits" or "license" for more information.
->>>
-```
 
-## Seu primeiro comando Python!
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
 
-Depois de executar o comando Python, o prompt mudou para `>>>`. Para nós, isso significa que por enquanto só utilizaremos comandos na linguagem Python. Você não precisa digitar `>>>` - O Python fará isso por você.
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
 
-Se você deseja sair do console do Python, apenas digite `exit()` ou use o atalho `Ctrl + Z` no Windows e `Ctrl + D` no Mac/Linux. Então você não vai ver mais o `>>>`.
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
 
-Mas agora não queremos sair da linha de comando do Python. Queremos aprender mais sobre ela. Vamos, então, fazer algo muito simples. Por exemplo, tente digitar alguma operação matemática, como `2 + 3` e aperte o `Enter`.
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 2 + 3
 5
 ```
 
-Incrível! Vê como a resposta simplesmente aparece? O Python conhece matemática! Você pode tentar outros comandos como:
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
 
-- `4 * 5` 
-- `5 - 1` 
+- `4 * 5`
+- `5 - 1`
 - `40 / 2`
 
-Para desenvolver cálculo exponencial, digamos 2 elevado a potência de 3, nós digitamos:
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 2 ** 3
 8
 ```
 
-Divirta-se com isso por um tempo e depois volte aqui :).
+Have fun with this for a little while and then get back here. :)
 
-Como você pode ver, o Python é uma ótima calculadora. Se você está se perguntando o que mais você pode fazer...
+As you can see, Python is a great calculator. If you're wondering what else you can do…
 
 ## Strings
 
-Que tal o seu nome? Digite seu primeiro nome entre aspas, desse jeito:
+How about your name? Type your first name in quotes like this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> "Ana"
-'Ana'
+>>> "Ola"
+'Ola'
 ```
 
-Você acabou de criar sua primeira string! String é uma sequência de caracteres que pode ser processada pelo computador. A string sempre precisa iniciar e terminar com o mesmo caractere. Este pode ser aspas duplas(`"`) ou simples(`'`) - elas dizem ao Python que o que está dentro delas é uma string.
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
 
-Strings podem ser concatenadas (colocadas juntas). Tente isto:
+Strings can be strung together. Try this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> "Oi " + "Ana"
-'Oi Ana'
+>>> "Hi there " + "Ola"
+'Hi there Ola'
 ```
 
-Você também pode multiplicar strings usando um número:
+You can also multiply strings with a number:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> "Ana" * 3
-'AnaAnaAna'
+>>> "Ola" * 3
+'OlaOlaOla'
 ```
 
-Se você precisa colocar um apóstrofo dentro de sua string, existem duas maneiras de fazer.
+If you need to put an apostrophe inside your string, you have two ways to do it.
 
-Usando aspas duplas:
+Using double quotes:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Runnin' down the hill"
 "Runnin' down the hill"
 ```
 
-
-ou escapando o apóstrofo com uma barra invertida (`\`):
+or escaping the apostrophe with a backslash (``):
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 'Runnin\' down the hill'
 "Runnin' down the hill"
 ```
 
-Legal, hein? Para ver seu nome em letras maiúsculas, basta digitar:
+Nice, huh? To see your name in uppercase letters, simply type:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> "Ana".upper()
-'ANA'
+>>> "Ola".upper()
+'OLA'
 ```
 
-Você acabou de usar o __método__ `upper` na sua string! Um método (como `upper()`) é um conjunto de instruções que o Python realiza em um determinado objeto (`"Ana"`), sempre que você chamar por ele.
-
-Se você quer saber o número de letras do seu nome, existe um __método__ para isso também!
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
 
+If you want to know the number of letters contained in your name, there is a **function** for that too!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> len("Ana")
+>>> len("Ola")
 3
 ```
 
-Se perguntando porque algumas vezes você chama métodos com um `.` no fim de uma string (como `"Ana".upper()`) e algumas vezes você primeiro chama a função colocando a string nos parênteses? Bem, em alguns casos, métodos pertencem a objetos, como `upper()`, que só pode ser utilizada em strings. Nesse caso, nós chamamos a função de **método**. Outras vezes, métodos não pertencem a nada específico e podem ser usadas em diferentes tipos de objetos, assim como `len()`. É por isso que nós estamos fornecendo `"Ana"` como um parâmetro para a função `len`.
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
 
-### Sumário
+### Summary
 
-OK, chega de strings. Até agora você aprendeu sobre:
+OK, enough of strings. So far you've learned about:
 
-*   **o prompt** - digitar comandos (códigos) no interpretador Python resulta em respostas em Python
-*   **números e strings** - no Python, números são usados para matemática e strings para objetos de texto
-*   **operadores** - como `+` e `\*`, combinam valores para produzir um novo valor
-*   **métodos** - como `upper()` e `len()`, executam ações nos objetos.
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
 
-Isso é o básico sobre todas as linguagens de programação que você for aprender. Pronto para algo mais difícil? Apostamos que sim!
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
 
-## Erros
+## Errors
 
-Vamos tentar algo novo. Podemos obter o tamanho de um número da mesma forma que podemos encontrar o tamanho do nosso nome? Digite `len(304023)` e pressione `Enter`:
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(304023)
 Traceback (most recent call last):
@@ -143,63 +151,68 @@ Traceback (most recent call last):
 TypeError: object of type 'int' has no len()
 ```
 
-Temos nosso primeiro erro! Ele diz que objetos do tipo "int" (inteiros, apenas números) não têm nenhum comprimento. Então o que podemos fazer agora? Talvez possamos escrever nosso número como uma string? Strings têm um comprimento, certo?
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(str(304023))
 6
 ```
 
-Funcionou! Usamos a função `str` dentro da função `len`. `str ()` converte tudo para strings.
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
 
-- A função `str` converte as coisas em __strings__
-- A função `int` converte as coisas em __números inteiros__
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
 
-> Importante: podemos converter números em texto, mas nós não podemos, necessariamente, converter texto em números - de qualquer
-forma, o que `int('hello')` quer dizer?
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
 
-## Variáveis
+## Variables
 
-Um conceito importante na programação é o conceito de variáveis. Uma variável não é nada mais do que um nome para alguma coisa, de tal forma que você possa usá-la mais tarde. Os programadores usam essas variáveis para guardar dados, para fazer seus códigos mais legíveis e para não ter que se lembrar sempre o que algumas coisas significam.
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
 
-Digamos que queremos criar uma nova variável chamada `nome`:
+Let's say we want to create a new variable called `name`:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> nome = "Ana"
+>>> name = "Ola"
 ```
 
-Vê? É simples! É só fazer: nome igual a Ana.
+We type name equals Ola.
 
-Como você percebeu, seu programa não retornou nada como fez anteriormente. Então como sabemos que a variável realmente existe? Simplesmente digite `nome` e tecle `Enter`:
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> nome
-'Ana'
+>>> name
+'Ola'
 ```
 
-Yippee! Sua primeira variável! :) Você sempre pode mudar o seu valor:
+Yippee! Your first variable! :) You can always change what it refers to:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> nome = "Sonja"
->>> nome
+>>> name = "Sonja"
+>>> name
 'Sonja'
 ```
 
-Você pode usá-la também em métodos:
+You can use it in functions too:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> len(nome)
+>>> len(name)
 5
 ```
 
-Incrível, não? Claro, variáveis podem ser qualquer coisa, então podem ser números também! Tente isso:
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> a = 4
 >>> b = 6
@@ -207,243 +220,264 @@ Incrível, não? Claro, variáveis podem ser qualquer coisa, então podem ser n
 24
 ```
 
-Mas, e se digitarmos o nome errado? Você consegue adivinhar o que aconteceria? Vamos tentar!
-
+But what if we used the wrong name? Can you guess what would happen? Let's try!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> cidade = "Tokyo"
->>> ciddae
+>>> city = "Tokyo"
+>>> ctiy
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
-NameError: name 'ciddae' is not defined
+NameError: name 'ctiy' is not defined
 ```
 
-Um erro! Como você pode ver, Python tem diferentes tipos de erros e este é chamado **NameError**. Python dará este erro se você tentar usar uma variável que não foi definida ainda. Se você encontrar esse erro depois, veja se no seu código se você não digitou o nome de uma variável errado.
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
 
-Brinque com isso por um tempo e veja o que você consegue fazer!
+Play with this for a while and see what you can do!
 
-## A função print
+## The print function
 
-Tente isso:
+Try this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> nome = 'Maria'
->>> nome
+>>> name = 'Maria'
+>>> name
 'Maria'
->>> print(nome)
+>>> print(name)
 Maria
 ```
 
-Quando você apenas digita `nome`, o interpretador Python responde com a *representação* como string da variável 'nome', que são as letras M-a-r-i-a, entre aspas simples. Quando você diz `print(nome)`, Python vai "imprimir" o conteúdo da variável na tela, sem as aspas, o que é mais puro.
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
 
-Como veremos mais tarde, `print()` também é útil quando queremos imprimir algo dentro de funções, ou quando queremos imprimir algo em várias linhas.
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
 
-## Listas
+## Lists
 
-Além de strings e inteiros, o Python tem vários tipos diferentes de objetos. Vamos apresentar um chamado **lista**. Listas são exatamente o que você acha que elas são: elas são objetos que são listas de outros objetos :)
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
 
-Vá em frente e crie uma lista:
+Go ahead and create a list:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> []
 []
 ```
 
-Sim, esta é uma lista vazia. Não é muito, não é? Vamos criar uma lista dos números da loteria. Como não queremos ficar repetindo o código todo o tempo vamos criar uma variável para ela:
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> loteria = [3, 42, 12, 19, 30, 59]
+>>> lottery = [3, 42, 12, 19, 30, 59]
 ```
 
-Tudo certo, nós temos uma lista! O que podemos fazer com isso? Vamos ver quantos números de loteria existem nesta lista. Você tem ideia de qual função deve usar para isso? Você já sabe disso!
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> len(loteria)
+>>> len(lottery)
 6
 ```
 
-Sim! `len()` pode te dar o número de objetos que fazem parte de uma lista. Uma mão na roda, não? Vamos organizar isso agora:
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> loteria.sort()
+>>> lottery.sort()
 ```
 
-Isso não retorna nada, apenas troca a ordem em que os números aparecem na lista. Vamos imprimir isso outra vez e ver o que acontece:
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> print(loteria)
+>>> print(lottery)
 [3, 12, 19, 30, 42, 59]
 ```
 
-Como você pode ver, os números na nossa lista estão ordenados do menor para o maior. Parabéns!
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
 
-Talvez a gente queira inverter essa ordem? Vamos fazer isso!
+Maybe we want to reverse that order? Let's do that!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> loteria.reverse()
->>> print(loteria)
+>>> lottery.reverse()
+>>> print(lottery)
 [59, 42, 30, 19, 12, 3]
 ```
 
-Moleza né? Se você quiser adicionar alguma coisa à sua lista, você pode fazer isto digitando o seguinte comando:
+If you want to add something to your list, you can do this by typing this command:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> loteria.append(199)
->>> print(loteria)
+>>> lottery.append(199)
+>>> print(lottery)
 [59, 42, 30, 19, 12, 3, 199]
 ```
 
-Se você quiser mostrar apenas o primeiro número você pode usar **índices**. Um índice é um número que diz onde um item da lista está. Os computadores gostam de iniciar a contagem por 0, então o primeiro objeto tem índice 0, o próximo tem índice 1 e por aí vai. Tente isso:
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> print(loteria[0])
+>>> print(lottery[0])
 59
->>> print(loteria[1])
+>>> print(lottery[1])
 42
 ```
 
-Como você pode ver, você pode acessar diferentes objetos na sua lista usando o nome da lista e o índice do objeto dentro dos colchetes.
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
 
-Para apagar alguma coisa de sua lista, você precisará usar __indexes__ como nós aprendemos acima e o método `pop()`. Vamos
-tentar um exemplo e reforçar o que aprendemos previamente; nós iremos apagar o primeiro número de nossa lista.
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> print(loteria)
+>>> print(lottery)
 [59, 42, 30, 19, 12, 3, 199]
->>> print(loteria[0])
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
 59
->>> loteria.pop(0)
->>> print(loteria)
+>>> print(lottery)
 [42, 30, 19, 12, 3, 199]
 ```
 
-Isso funcionou com perfeição!
+That worked like a charm!
 
-Por diversão extra, tente alguns outros índices: 6, 7, 1000, -1, -6 ou -1000. Veja se você consegue prever o resultado antes de tentar o comando. Os resultados fazem sentido?
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
 
-Você pode encontrar uma lista de todos os métodos disponíveis neste capítulo na documentação do Python: https://docs.python.org/3/tutorial/datastructures.html
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
 
-## Dicionários
+## Dictionaries
 
-> Leitores em casa: essa parte está disponível em vídeo (em inglês) [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
 
-Um dicionário é semelhante a uma lista, mas você pode acessar valores através de uma chave ao invés de um índice. Uma chave pode ser qualquer string ou número. A sintaxe para definir um dicionário vazio é:
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> {} 
-    {}
-```    
+>>> {}
+{}
+```
 
-Isso mostra que você acabou de criar um dicionário vazio. Hurra!
+This shows that you just created an empty dictionary. Hurray!
 
-Agora, tente escrever o seguinte comando (tente substituir com as suas próprias informações também):
+Now, try writing the following command (try substituting your own information, too):
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> participante = {'nome': 'Ana', 'pais': 'Polonia', 'numeros_favoritos': [7, 42, 92]}
-```  
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
 
-Com esse comando, você acabou de criar uma variável chamada `participante` com três pares de chave-valor:
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
 
-- A chave `name` aponta para o valor `'Ana'` (um objeto `string`),
-- `pais` aponta para `'Polonia'` (outra `string`),
-- `numeros_favoritos` apontam para `[7, 42, 92]` (uma `list` com três números nela).
+You can check the content of individual keys with this syntax:
 
-Você pode checar o conteúdo de chaves individuais com a sintaxe:
+{% filename %}command-line{% endfilename %}
 
-```  
->>> print(participante['nome'])
-Ana
-```      
+```python
+>>> print(participant['name'])
+Ola
+```
 
-Veja, é similar a uma lista. Mas você não precisa lembrar o índice - apenas o nome.
+See, it's similar to a list. But you don't need to remember the index – just the name.
 
-O que acontece se pedirmos ao Python o valor de uma chave que não existe? Você consegue adivinhar? Vamos tentar e descobrir!
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> participante['idade']
+>>> participant['age']
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
-KeyError: 'idade'
+KeyError: 'age'
 ```
 
-Olha, outro erro! Esse é um **KeyError**. Python é bastante prestativo e te diz que a chave `'idade'` não existe nesse dicionário.
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
 
-Quando usar um dicionario ou uma lista? Bem, um bom ponto para refletir. Pense em uma solução antes de olhar a resposta na próxima linha.
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
 
-- Você precisa de uma sequência ordenada de itens? Use uma list.
-- Você precisa associar valores com chaves, assim você pode procurá-los eficientemente (pela chave) mais tarde? Use um dictionary.
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
 
-Dicionários, como listas, são *mutáveis*, ou seja, que podem ser mudados depois que são criados. Você pode adicionar novos pares de chave/valor para o dicionário após sua criação, como:
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> participante['linguagem_favorita'] = 'Python'
+>>> participant['favorite_language'] = 'Python'
 ```
 
-Como as lists, usar o método `len()` em dicionários retorna o número de pares chave-valor no dicionario. Vá em frente e digite o comando:
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> len(participante)
+>>> len(participant)
 4
 ```
 
-Espero que isso faça sentido até agora. :) Pronta para mais diversão com dicionários? Pule na próxima linha para coisas incríveis.
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
 
-Você pode usar o comando `pop()` para deletar um item no dicionario. Digamos, se você quer excluir a entrada correspondente a chave `'numeros_favoritos'`, basta digitar o seguinte comando:
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> participante.pop('numeros_favoritos')
->>> participante
-{'pais': 'Polonia', 'linguagem_favorita': 'Python', 'nome': 'Ana'}
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
 ```
 
-Como você pode ver no retorno, o par chave-valor correspondente à chave 'numeros_favoritos' foi excluído.
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
 
-Além disso você pode mudar o valor associado com uma chave já criada no dicionário. Digite:
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
->>> participante['pais'] = 'Alemanha'
->>> participante
-{'pais': 'Alemanha', 'linguagem_favorita': 'Python', 'nome': 'Ana'}
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
 ```
 
-Como você pode ver, o valor da chave `'pais'` foi alterado de `'Polonia'` para `'Alemanha'`. :) Emocionante? Hurra! Você acabou de aprender outra coisa incrível.
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
 
-### Sumário
+### Summary
 
-Incrível! Agora você sabe muito sobre programação. Nesta última parte você aprendeu sobre:
+Awesome! You know a lot about programming now. In this last part you learned about:
 
-- __erros__ - agora você sabe como ler e entender erros que aparecem se o Python não entender um comando que você passou
-* __variáveis__ - nomes para objetos que permitem você programar facilmente e deixar seu código mais legível
-* __listas__ - listas de objetos armazenados em uma ordem específica
-* __dicionários__ - objetos armazenados como pares chave-valor
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
 
-Empolgado(a) para o próximo passo? :)
+Excited for the next part? :)
 
-## Compare coisas
+## Compare things
 
-> Leitores em casa: essa parte está disponível em vídeos (em inglês) [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
 
-Grande parte da programação consiste em comparar coisas. O que é mais fácil de comparar? Números, é claro. Vamos ver como isso funciona:
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 5 > 2
 True
@@ -456,15 +490,15 @@ True
 >>> 5 != 2
 True
 ```
-    
 
-Demos ao Python alguns números para comparar. Como você pode ver, Python pode comparar não só números mas também resultados de métodos. Legal, hein?
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
 
-Você está se perguntando por que colocamos dois sinais de igual `==` lado a lado para comparar se os números são iguais? Nós usamos um único `=` para atribuir valores a variáveis. Você sempre, **sempre** precisa colocar dois `==` se quiser verificar se as coisas são iguais. Também é possível afirmar que as coisas são desiguais entre si. Para isso, usamos o símbolo `! =`, conforme mostrado no exemplo acima.
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
 
-Dê ao Python mais duas tarefas:
+Give Python two more tasks:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 6 >= 12 / 2
 True
@@ -472,16 +506,17 @@ True
 False
 ```
 
-`>` e `<` são fáceis, mas o que `>=` e `<=` significam? Leia eles da seguinte forma:
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
 
-- x `>` y significa: x é maior que y
-- x `<` y significa: x é menor que y
-- x `< =` y significa: x é menor ou igual a y
-- x `>=` y significa: x é maior ou igual a y
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
 
-Fantástico! Quer mais? Tente isto:
+Awesome! Wanna do one more? Try this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 6 > 2 and 2 < 3
 True
@@ -489,252 +524,265 @@ True
 False
 >>> 3 > 2 or 2 < 1
 True
-``` 
+```
 
-Você pode dar ao Python quantos números você quiser para comparar, e ele vai te dar uma resposta! Espertinho, certo?
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
 
-- __and__ - se você usar o operador `and`, ambas as comparações terão que ser verdadeiras para que todo o comando seja verdadeiro
-- __or__ - se você usar o operador `or`, apenas uma das comparações precisa ser verdadeira para que o comando todo seja verdadeiro
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
 
-Já ouviu a expressão "comparar maçãs com laranjas"? Vamos tentar o equivalente em Python:
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 1 > 'django'
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
-TypeError: unorderable types: int() > str()
+TypeError: '>' not supported between instances of 'int' and 'str'
 ```
 
-Aqui vemos que assim como na expressão, Python não é capaz de comparar um número (`int`) e uma string (`str`).
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
 
-Em vez disso, ele mostrou um **TypeError** e nos disse que os dois tipos não podem ser comparados entre si.
+## Boolean
 
-##Booleano
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
 
-Acidentalmente, você aprendeu sobre um novo tipo de objeto em Python. Ele é chamado de __Booleano__ -- e provavelmente é o tipo mais fácil que existe.
+There are only two Boolean objects:
 
-Existem apenas dois objetos booleanos:
-- True (verdadeiro)
-- False (falso)
+- True
+- False
 
-Mas para o Python entender isso, você precisa sempre escrever True (primeira letra maiúscula, com o resto das letras em minúsculo). true, TRUE, tRUE não vai funcionar -- só True é correto. (O mesmo se aplica ao False, claro.)
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
 
-Booleanos podem ser variáveis também! Veja:
+Booleans can be variables, too! See here:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> a = True
 >>> a
 True
 ```
 
-Você também pode fazer desse jeito:
+You can also do it this way:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> a = 2 > 5
 >>> a
 False
 ```
 
-Pratique e divirta-se com os valores booleanos, tentando executar os seguintes comandos:
+Practice and have fun with Booleans by trying to run the following commands:
 
 - `True and True`
 - `False and True`
 - `True or 1 == 1`
 - `1 != 2`
 
-Parabéns! Booleanos são um dos recursos mais interessantes na programação, e você acabou de aprender como usá-los!
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
 
-# Salvando o Código!
+# Save it!
 
-> Leitores em casa: essa parte está disponível em vídeos (em inglês) [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk).
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
 
-Até agora nós escrevemos todo nosso código em um interpretador python, o que nos limita a uma linha de código a cada momento. Programas normais são salvos em arquivos e executados pelo nosso **interpretador** de linguagem de programação ou **compilador**. Até agora nós executamos nossos programas uma linha de cada vez no **interpretador** Python. Nós vamos precisar de mais de uma linha de código para as próximas tarefas, então precisaremos rapidamente:
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
 
-- Sair do interpretador Python
-- Abrir o editor de código de sua escolha
-- Salvar algum código em um novo arquivo python
-- Executá-lo!
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
 
-Para sair do interpretador Python que estamos usando, simplesmente digite a função `exit()`:
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> exit()
 $
 ```
 
-Isso vai colocá-la de volta no prompt de comando.
+This will put you back into the command prompt.
 
-Anteriormente, nós escolhemos um editor de código da seção do [editor de código][4]. Nós precisamos abrir o editor agora e escrever algum código em um novo arquivo:
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
 
 {% filename %}editor{% endfilename %}
+
 ```python
 print('Hello, Django girls!')
 ```
 
-Obviamente, você agora é uma desenvolvedora Python com alguma experiência, então sinta-se livre para escrever algum código com o que 
-aprendeu hoje.
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
 
-Agora, nós precisamos salvar o arquivo e nomeá-lo de forma descritiva. Vamos chamar o arquivo de **python_intro.py** e 
-salvá-lo em seu desktop. Nós podemos nomeá-lo da maneira que quisermos, mas a parte importante aqui é garantir que termine
-com __.py__. A extensão __.py__ informa ao nosso sistema operacional que o arquivo é um **arquivo Python executável** e
-o Python pode rodá-lo.
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
 
-> **Nota** Você deve ter observado uma das coisas mais legais sobre editores de código: cores! No console do Python, tudo era da mesma cor, mas agora você deve ver que a função `print` tem uma cor diferente da sequência de caracteres no seu interior. Isso é chamado de "realce de sintaxe", e é uma ajuda muito útil quando está programando. Perceba a cor das coisas e você vai obter uma dica para quando você esquecer de fechar uma seqüência de caracteres, ou fazer um erro de digitação em um nome de palavra-chave (como `def` em uma função, que veremos abaixo). Esta é uma das razões pelas quais que nós usamos um editor de código :)
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
 
-Obviamente, você é um desenvolvedor python bastante experiente agora, então sinta-se livre para escrever um código que você aprendeu hoje.
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
 
-Agora temos de salvar o arquivo e dê um nome descritivo. Vamos chamar o arquivo **python_intro.py** e salve-o em seu desktop. Podemos nomear o arquivo tudo o que quisermos, o importante aqui é ter certeza que o arquivo termina no **py**, isto diz nosso computador, que é um **arquivo executável de python** e Python pode executá-lo.
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
 
-Com o arquivo salvo, é hora de executá-lo! Usando as habilidades que você aprendeu na seção de linha de comando, use o terminal
-**change directories - cd** para ir para o desktop.
+<!--endsec-->
 
-<!--sec data-title="OS X" data-id="python_OSX"
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
 data-collapse=true ces-->
 
-Em um Mac, o comando será parecido com isto:
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd ~/Desktop
-```
+
+    $ cd ~/Desktop
+    
+
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="python_linux"
-data-collapse=true ces-->
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
 
-No Linux, será assim (a palavra "Desktop" pode estar traduzida para seu "Área de Trabalho"):
+On Windows Command Prompt, it will be like this:
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd ~/Desktop
-```
+
+    > cd %HomePath%\Desktop
+    
 
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="python_windows" data-collapse=true ces-->
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
 
-E no windows, vai ser assim:
+And on Windows Powershell, it will be like this:
 
 {% filename %}command-line{% endfilename %}
-```
-> cd %HomePath%\Desktop
-```
+
+    > cd $Home\Desktop
+    
+
 <!--endsec-->
 
-Se você ficar confusa, é só pedir ajuda.
+If you get stuck, just ask for help.
 
-Em seguida, use o Python para executar o código do arquivo assim:
+Now use Python to execute the code in the file like this:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hello, Django girls!
-```
 
-Nota: no Windows 'python3' não é reconhecido como um comando. Em vez disso, use 'python' para executar o arquivo:
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 > python python_intro.py
 ```
 
-Muito bem! Você acabou de executar seu primeiro programa em python que foi salvo em um arquivo. Se sente ótima?
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
 
-Você pode agora passar para uma ferramenta essencial na programação:
+You can now move on to an essential tool in programming:
 
-## if...elif...else
+## If … elif … else
 
-Muitas coisas no código só podem ser executadas se determinadas condições forem atendidas. É por isso que o Python tem uma coisa chamada **declaração if**.
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
 
-Substitua o código no arquivo **python_intro.py** para isto:
+Replace the code in your **python_intro.py** file with this:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
 ```
 
-Se salvarmos isso e rodar o arquivo, nós veremos um erro como este:
+If we were to save and run this, we'd see an error like this:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-File "python_intro.py", line 2
-         ^
-SyntaxError: unexpected EOF while parsing
-```
 
-Python espera que nós forneçamos mais instruções que serão supostamente executadas caso a condição `3 > 2` venha a ser verdadeira (ou `True` nesse caso). Vamos tentar fazer o Python imprimir "It works!". Altere o seu código no seu arquivo **python_intro.py** para isto:
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
     print('It works!')
 ```
 
-Você percebeu que identamos a próxima linha com 4 espaços? Precisamos fazer isso para que o Python saiba qual código será executado se o resultado for True. Você pode fazer com 1 espaço, mas quase todos os programadores Python fazem com 4 para deixar as coisas arrumadas. Um único `tab` também vai contar como 4 espaços.
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
 
-Salve o arquivo e execute novamente:
+Save it and give it another run:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 $ python3 python_intro.py
 It works!
 ```
 
-Nota: Lembre-se que no Windows, 'python3' não é reconhecido como um comando. A partir de agora, substitua 'python3' por
-'python' para executar o arquivo.
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
 
-### E se a condição não for True?
+### What if a condition isn't True?
 
-Nos exemplos anteriores, o código era executado apenas quando as condições eram verdadeiras - True. Mas Python também tem
-as declarações `elif` e `else`:
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 5 > 2:
-    print('5 é de fato maior que 2')
+    print('5 is indeed greater than 2')
 else:
-    print('5 não é maior que 2')
+    print('5 is not greater than 2')
 ```
 
-Quando isso é executado será impresso:
+When this is run it will print out:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-5 é de fato maior que 2
-```
 
-Se 2 fosse um número maior que 5, então o segundo comando seria executado. Simples, não é? Vamos ver como o `elif` funciona:
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
-nome = 'Sonja'
-if nome == 'Ana':
-    print('Hey Ana!')
-elif nome == 'Sonja':
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
     print('Hey Sonja!')
 else:
     print('Hey anonymous!')
 ```
 
-e depois de executar:
+and executed:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hey Sonja!
-```
 
-Vê o que acontece aqui? `elif` permite que você adicione condições extras que acontecem se as condiçes anteriores falharem.
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
 
-Você pode adicionar quantas declarações `elif` você quiser após a declaração `if` inicial. Por exemplo:
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 volume = 57
 if volume < 20:
@@ -751,22 +799,22 @@ else:
     print("My ears are hurting! :(")
 ```
 
-O Python roda cada um dos testes em sequência e imprime:
+Python runs through each test in sequence and prints:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Perfect, I can hear all the details
-```
 
-## Comentários
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
 
-Comentários são linhas que começam com um `#`. Você pode escrever qualquer coisa que você quiser após o `#` que o Python irá
-ignorar completamente. Comentários podem deixar seu código mais fácil de  ser entendido por outras pessoas.
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
 
-Vejamos como isso se parece:
+Let's see how that looks:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 # Change the volume if it's too loud or too quiet
 if volume < 20 or volume > 80:
@@ -774,229 +822,241 @@ if volume < 20 or volume > 80:
     print("That's better!")
 ```
 
-Você não precisa escrever um comentário para cada linha de código, mas eles são úteis para explicar o por quê de seu código
-estar fazendo algo, ou para prover um sumário se estiver fazendo algo complexo.
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
 
-### Sumário
+In the last few exercises you learned about:
 
-Nos poucos exercícios anteriores você aprendeu:
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
 
-- __comparar as coisas__ - em Python, você pode comparar as coisas usando os operadores `>`, `>=`, `==`, `<=`, `<` e o `and`, `or`
-- __Booleano__ - um tipo de objeto que só tem um dos dois valores: `True` ou `False`
-- __Salvando arquivos__ - armazenamento de código em arquivos assim você pode executar programas maiores.
-- __if... elif... else__ - instruções que permitem que você execute o código somente se determinadas condições forem atendidas.
-- __comentários__ - linhas que o Python não executa que deixam você documentar o seu código
+Time for the last part of this chapter!
 
-É hora da última parte deste capítulo!
+## Your own functions!
 
-## Suas próprias funções!
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
 
-Se lembra de funções como `len()` que você pode executar no Python? Bem, boas notícias, agora você vai aprender a escrever suas próprias funções!
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
 
-Uma função é uma sequência de instruções que o Python deve executar. Cada função em Python começa com a palavra-chave `def`, seguida de um nome para a função e opcionalmente uma lista de parâmetros. Vamos começar com uma função simples. Substitua o código no **python_intro.py** com o seguinte:
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi():
-    print('Olá!')
-    print('Como vai você?')
+    print('Hi there!')
+    print('How are you?')
 
 hi()
-``` 
+```
 
-Ok, nossa primeira função está pronta!
+Okay, our first function is ready!
 
-Você pode se perguntar por que escrevemos o nome da função na parte inferior do arquivo. Porque Python lê o arquivo e executa de cima para baixo. Então, para usar a nossa função, temos de reescrevê-la na parte inferior.
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
 
-Vamos executa-lo agora e ver o que acontece:
+Let's run this now and see what happens:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Olá!
-Como vai você?
-```
 
-Isso foi fácil! Vamos construir nossa primeira função com parâmetros. Usaremos o exemplo anterior - uma função que diz 'hi' para quem o executa - com um nome:
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
-def hi(nome):
+def hi(name):
 ```
 
-Como você pode ver, nós demos a nossa função um parâmetro que ns chamamos de `nome`:
+As you can see, we now gave our function a parameter that we called `name`:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
-def hi(nome):
-    if nome == 'Ana':
-        print('Hi Ana!')
-    elif nome == 'Sonja':
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
         print('Hi Sonja!')
     else:
-        print('Hi anônima!')
+        print('Hi anonymous!')
 
 hi()
 ```
 
-Lembre-se: A função `print` é identada com quatro espaços dentro da declaração `if`. A razão disso é porque a função roda
-quando a condição é satisfeita. Vamos ver como isso funciona agora:
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Traceback (most recent call last):
-File "python_intro.py", line 10, in <module>
-  hi()
-TypeError: hi() missing 1 required positional argument: 'nome'
-```
 
-Oops, um erro. Ainda bem que o Python nos dá uma mensagem de erro clara.
-Ela nos informa que a função `hi()` (a que nós definimos) requer um argumento (chamado `nome`) e que nós nos esquecemos de
-passá-lo quando chamamos a função.
-Vamos consertar isso no final do arquivo:
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
-hi("Ana")
+hi("Ola")
 ```
 
-E execute o arquivo novamente:
+And run it again:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi Ana!
-```
 
-E se nós mudarmos o nome?
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 hi("Sonja")
 ```
 
-E executá-lo:
+And run it:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi Sonja!
-```
 
-Agora, o que você acha que irá acontecer se você escrever outro nome lá, como o que chamamos de argumento? (Nem Ana, nem Sonja.) Tente e veja se você está certa. Deveria colocar isso na tela:
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
 
 {% filename %}command-line{% endfilename %}
-```
-Hi anônima!
-```
 
-Isso é incrível, não é? Dessa forma você não tem que repetir o código toda vez que você quiser trocar o nome da pessoa que a função deve cumprimentar. E é justamente por isso que nós precisamos de funções – você nunca quer repetir seu código!
+    Hi anonymous!
+    
 
-Vamos fazer algo mais elaborado – existem muitos nomes, e escrever uma condição para cada um seria muito trabalhoso, não é?
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
-def hi(nome):
-    print('Hi ' + nome + '!')
+def hi(name):
+    print('Hi ' + name + '!')
 
 hi("Rachel")
 ```
 
-Vamos chamar o código agora
+Let's call the code now:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi Rachel!
-```
 
-Parabéns! Você acabou de aprender como escrever funções! :)
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
 
-## Laços de repetição
+## Loops
 
-> Leitores em casa: essa parte está disponível em vídeos (em inglês) [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0).
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
 
-Essa já é a última parte. Isso foi rápido, não? :)
+This is the last part already. That was quick, right? :)
 
-Programadoras não gostam de ficar se repetindo. Programação sempre sobre automatizar coisas, então nós não queremos cumprimentar cada pessoa por seu nome manualmente, certo? É ai que os laços de repetiço entram em cena.
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
 
-Ainnda se lembra das listas? Vamos fazer uma lista de garotas:
+Still remember lists? Let's do a list of girls:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
-garotas = ['Rachel', 'Monica', 'Phoebe', 'Ana', 'You']
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
 ```
 
-Nós queremos comprimentar todas elas por seus nomes. Nós temos a função `hi` para fazer isso, então vamos fazer isso com um laço de repetição:
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
-for nome in garotas:
+for name in girls:
 ```
 
-A declaração ```for``` se comporta  de maneira similar a da declaração ```if```; os dois códigos abaixo precisam estar
-identados com quatro espaços.
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
 
-Aqui está o código completo que irá para dentro do arquivo:
+Here is the full code that will be in the file:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
-def hi(nome):
-    print('Hi ' + nome + '!')
+def hi(name):
+    print('Hi ' + name + '!')
 
-garotas = ['Rachel', 'Monica', 'Phoebe', 'Ana', 'You']
-for nome in garotas:
-    hi(nome)
-    print('Próxima garota')
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
 ```
 
-A nós rodamos ele:
+And when we run it:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi Rachel!
-Próxima garota
-Hi Monica!
-Próxima garota
-Hi Phoebe!
-Próxima garota
-Hi Ana!
-Próxima garota
-Hi You!
-Próxima garota
-```
 
-Como você pode ver, tudo que você colocar dentro da declaração `for`, com a indentação (aqueles quatro espaços a partir da margem esquerda) será repetido para cada elemento da lista `garotas`.
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
 
-Você também pode usar o `for` com numeros usando a função `range`:
+You can also use `for` on numbers using the `range` function:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 for i in range(1, 6):
     print(i)
 ```
 
-Que irá imprimir:
+Which would print:
 
 {% filename %}command-line{% endfilename %}
-```
-1
-2
-3
-4
-5
-```
 
-`range` é uma função que cria uma lista de numeros em sequência (esses numeros são fornecidos por você como parâmetros).
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
 
-Note que o segundo desses numeros não é incluído na lista que é exibida pelo Python (o que significa que `range(1, 6)` conta de 1 até 5, não inclui o número 6). É por isso que "range" é meio aberta ("half-open"), e com isso nós queremos dizer que a função inclui o primiero valor, mas não o último.
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
 
-## Sumário
+## Summary
 
-É isso. __Você arrebentou!__ Esse foi um capítulo exigente, então você deve se sentir orgulhosa. Nós definitivamente estamos orgulhosas de você chegar tão longe!
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
 
-Você deve estar querendo, por um momento, fazer alguma outra coisa – alongar, dar uma volta por aí, descansar os olhos. Faça isso antes de passar para o próximo capítulo. :)
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
 
-![Cupcake](images/cupcake.png)
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/pt/template_extending/README.md b/pt/template_extending/README.md
index 6f8d00b3ecc..35997f913d3 100755
--- a/pt/template_extending/README.md
+++ b/pt/template_extending/README.md
@@ -1,14 +1,14 @@
-# Estendendo os templates
+# Template extending
 
-Outra coisa boa que o Django tem pra você é o __template extending__. O que isso significa? Isso significa que você pode usar as mesmas partes do seu HTML em diferentes páginas do seu site.
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
 
-Templates são úteis quando você quer usar a mesma informação/layout em mais de um lugar. Você não precisa ficar se repetindo em cada arquivo. E, se você quiser mudar alguma coisa, não precisa fazer isso em todos os templates, apenas em um!
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
 
-## Criar template base
+## Create a base template
 
-Um template base é o template mais básico que você estenderá em cada página do seu site.
+A base template is the most basic template that you extend on every page of your website.
 
-Vamos criar um arquivo `base.html` na pasta `blog/templates/blog/`:
+Let's create a `base.html` file in `blog/templates/blog/`:
 
     blog
     └───templates
@@ -17,9 +17,10 @@ Vamos criar um arquivo `base.html` na pasta `blog/templates/blog/`:
                 post_list.html
     
 
-Abra-o e copie tudo que está no arquivo `post_list.html` para `base.html`, desse jeito:
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -54,9 +55,10 @@ Abra-o e copie tudo que está no arquivo `post_list.html` para `base.html`, dess
 </html>
 ```
 
-Então em `base.html`, substitua todo seu `<body>` (tudo entre `<body>` e `</body>`) com isso:
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <body>
     <div class="page-header">
@@ -73,19 +75,21 @@ Então em `base.html`, substitua todo seu `<body>` (tudo entre `<body>` e `</bod
 </body>
 ```
 
-{% raw %}Basicamente nós substituimos tudo entre `{% for post in posts %}{% endfor %}` por:{% endraw %}
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% block content %}
 {% endblock %}
 ```
 
-Mas, por quê? Você acabou de criar um `block` (bloco)! Você usou uma tag de template `{% block %}` para criar uma área onde será inserido HTML. Esse HTML virá de outro template que estende esse template (`base.html`). Nós vamos te mostrar como fazer isso já já.
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
 
-Agora salve `base.html` e abra o arquivo `blog/templates/blog/post_list.html` novamente. {% raw %}Você irá remover tudo que estiver acima de `{% for post in posts %}` e abaixo de `{% endfor %}`. Quando terminar, o arquivo ficará dessa forma:{% endraw %}
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     <div class="post">
@@ -98,12 +102,12 @@ Agora salve `base.html` e abra o arquivo `blog/templates/blog/post_list.html` no
 {% endfor %}
 ```
 
-Nós queremos usar essa parte de nosso template para todos os blocos "content".
-Hora de adicionar tags de bloco ("block") nesse arquivo!
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
 
-{% raw %}Você quer que sua tag de bloco ("block") corresponda com a tag em seu arquivo `base.html`. Você também quer que ela inclua todo o código que pertence ao seus blocos "content". Para fazer isso, coloque tudo entre `{% block content %}` e `{% endblock %}`. Dessa forma:{% endraw %}
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% block content %}
     {% for post in posts %}
@@ -118,9 +122,10 @@ Hora de adicionar tags de bloco ("block") nesse arquivo!
 {% endblock %}
 ```
 
-Só falta uma coisa. Nós precisamos fazer a conexão entre esses dois templates.  É isso que "extendendo templates" significa! Nós iremos fazer isso adicionando uma tag de extender ("extends") ao início do arquivo. Dessa forma:
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -137,6 +142,6 @@ Só falta uma coisa. Nós precisamos fazer a conexão entre esses dois templates
 {% endblock %}
 ```
 
-É isso! Veja se o seu site ainda está funcionando direito :)
+That's it! Check if your website is still working properly. :)
 
-> Se ocorrer um erro de `TemplateDoesNotExists`, que diz que não existe nenhum arquivo chamado `blog/base.html` e se você tiver o `runserver` executando no terminal, tenta interrompê-lo (precionando Ctrl+C - o botão Control mais o botão C juntos) e reinicie ele rodando o comando `python manage.py runserver`.
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ro-RO/GLOSSARY.md b/ro-RO/GLOSSARY.md
new file mode 100644
index 00000000000..4b91f3c7293
--- /dev/null
+++ b/ro-RO/GLOSSARY.md
@@ -0,0 +1,3 @@
+# editor de cod
+
+Editorul de cod este o aplicaţie care vă permite să salvaţi codul, astfel încât să îl puteți revizui și modifica mai târziu. Puteţi afla de unde puteți downloada unul din [capitolul de editor de cod](./code_editor/README.md)
\ No newline at end of file
diff --git a/ro-RO/README.md b/ro-RO/README.md
new file mode 100644
index 00000000000..e1aa7992ed1
--- /dev/null
+++ b/ro-RO/README.md
@@ -0,0 +1,51 @@
+# Tutorial Django Girls
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Această lucrare este licențiată sub licența Internațională Creative Commons Attribution-ShareAlike 4.0. Pentru a vedea o copie a acestei licențe, vizitează https://creativecommons.org/licenses/by-sa/4.0/
+
+## Bine ai venit
+
+Bine ai venit la Tutorialul Django Girls! Ne bucurăm să te vedem aici :) În acest tutorial, te vom ghida în călătoria minunată prin lumea tehnologiilor web, oferindu-ți o imagine a tuturor părților care trebuie conectate în așa fel ca aplicațiile web să funcționeze bine.
+
+Ca în cazul tuturor lucrurilor necunoscute, aceasta va fi o aventură - dar nu-ți face griji, dacă ți-ai făcut deja curaj să ajungi aici, vei fi în regulă. :)
+
+## Introducere
+
+Ai simţit vreodată că lumea este din ce în ce mai legată de tehnologii la care (încă) nu te pricepi? Te-ai întrebat vreodată cum poți crea un site web, dar nu ai avut niciodată suficientă motivaţie ca să începi? Te-ai gândit vreodată că lumea software-ului este prea complicată pentru a încerca să creezi ceva independent?
+
+Ei bine, avem o veste bună pentru tine! Programarea nu este atât de complicată pe cât pare şi vrem să-ţi arătăm cât de distractivă poate fi.
+
+Acest tutorial nu te va transforma în mod magic într-o programatoare. Dacă vrei să fii bună la asta, ai nevoie de luni sau chiar ani de învăţare şi practică. Dar vrem să-ţi arătăm că programarea sau crearea de site-uri nu este atât de complicată precum pare. Vom încerca să-ți explicăm diferite aspecte ale programării web atât de bine cât putem, astfel încât să nu te simţi intimidată de tehnologie.
+
+Sperăm că te vom putea face să iubești tehnologia la fel de mult ca noi!
+
+## Ce vei învăţa pe parcursul acestui tutorial?
+
+La sfârșitul acestui tutorial, vei avea o mică aplicație web - blogul tău personal. Noi îți vom arăta cum să îți postezi blogul online, astfel încât să fie văzut de lume!
+
+Acesta va arăta (mai mult sau mai puţin) astfel:
+
+![Figura 0.1](images/application.png)
+
+> Dacă lucrezi cu tutorialul de una singură şi nu ai un mentor care să te ajute în caz de probleme, avem un sistem de chat pentru tine: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Amrugat mentorii noștri și participanții anteriori să fie acolo din când în când și să-i ajute pe alții cu tutorialul! Nu-ți fie teamă să pui întrebări acolo!
+
+OK, [să începem de la început...](./how_the_internet_works/README.md)
+
+## Dacă urmezi tutorialul de acasă
+
+Este fantastic să iei parte la un atelier Django Girls, dar suntem conştienţi că nu este întotdeauna posibil să participi la unul în persoană. De aceea, îte încurajăm să încerci acest tutorial chiar de acasă. Pentru cele care ne citesc de acasă, ne pregătim să facem videoclipuri care vor facilita urmărirea acestui tutorial de una singură. Ideea este în curs de desfăşurare, dar din ce în ce mai multe lucruri vor fi acoperite în curând pe canalul de YouTube [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed).
+
+În fiecare capitol deja acoperit, există un link către videoclipul corect.
+
+## Despre şi contribuții
+
+Acest tutorial este menținut de [DjangoGirls](https://djangogirls.org/). Dacă găsești greșeli sau dorești să actualizezi tutorialul, te rugăm să [urmezi ghidul de contribuție](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Dorești să ne ajuți să traducem tutorialul în alte limbi?
+
+În prezent, traducerile sunt păstrate pe platforma crowdin.com:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Dacă limba ta nu este listată pe [crowdin](https://crowdin.com/), te rugăm să [deschizi un issue](https://github.com/DjangoGirls/tutorial/issues/new) informându-ne despre limba pe care o vrei, pentru a o putea adăuga.
\ No newline at end of file
diff --git a/ro-RO/SUMMARY.md b/ro-RO/SUMMARY.md
new file mode 100644
index 00000000000..d9c1d35697b
--- /dev/null
+++ b/ro-RO/SUMMARY.md
@@ -0,0 +1,35 @@
+# Cuprins
+
+* [Introducere](README.md)
+* [Instalare](installation/README.md) 
+  * [Linia de comandă](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Editor de cod](installation/README.md#code-editor)
+  * [Mediul Virtual](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Instalare (Chromebook)](chromebook_setup/README.md)
+* [Cum funcționează Internetul](how_the_internet_works/README.md)
+* [Introducere în linia de comandă](intro_to_command_line/README.md)
+* [Instalare Python](python_installation/README.md)
+* [Editor de cod](code_editor/README.md)
+* [Introducere în Python](python_introduction/README.md)
+* [Ce este Django?](django/README.md)
+* [Instalarea Django](django_installation/README.md)
+* [Primul tău proiect Django!](django_start_project/README.md)
+* [Modele în Django](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [URL-uri în Django](django_urls/README.md)
+* [Django views.py - e timul să creăm!](django_views/README.md)
+* [Introducere în HTML](html/README.md)
+* [Django ORM (Seturi de interogare)](django_orm/README.md)
+* [Date dinamice în template-uri](dynamic_data_in_templates/README.md)
+* [Template-uri în Django](django_templates/README.md)
+* [CSS - fă-l frumos](css/README.md)
+* [Extinderea template-urilor](template_extending/README.md)
+* [Extinde-ți aplicația](extend_your_application/README.md)
+* [Formele în Django](django_forms/README.md)
+* [Ce urmează?](whats_next/README.md)
\ No newline at end of file
diff --git a/ro-RO/chromebook_setup/README.md b/ro-RO/chromebook_setup/README.md
new file mode 100644
index 00000000000..42afd87c3c3
--- /dev/null
+++ b/ro-RO/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Setup Chromebook
+
+> **Notă** Dacă ai trecut deja prin [pașii de instalare](../installation/README.md), nu este nevoie să faci acest lucru din nou – poți trece direct la [Introducere în Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ro-RO/chromebook_setup/instructions.md b/ro-RO/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..0441ad9c302
--- /dev/null
+++ b/ro-RO/chromebook_setup/instructions.md
@@ -0,0 +1,157 @@
+Poţi [sări peste această secţiune](http://tutorial.djangogirls.org/en/installation/#install-python) dacă nu foloseşti Chromebook. Dacă îl folosești, experiența de instalare va fi puțin diferită. Poți ignora restul instrucţiunilor de instalare.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE este un instrument care îți oferă un editor de cod şi acces la un calculator care rulează pe Internet, în care poți instala, scrie şi executa software-ul. Pe durata acestui tutorial, Cloud IDE va funcționa ca și *calculatorul tău local *. Tu vei rula comenzile în interfața terminalului la fel ca și colegii care folosesc OS X, Ubuntu sau Windows, dar terminalul pe care îl vei folosi tu este conectat la un calculator care rulează în altă parte, pe care Cloud IDE ți l-a configurat. Aici sunt instrucţiunile pentru Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9). Poţi alege unul dintre programele Cloud IDE şi urmări instrucţiunile programului Cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Deschide aplicaţia [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Creează-ți un cont
+3. Fă click pe *Server nou* și alege aplicația Django
+4. Fă click pe butonul Terminal (în partea stângă a ferestrei)
+
+Acum ar trebui să vezi o interfaţă cu o bară laterală cu butoane în stânga. Fă click pe butonul Terminal pentru a deschide fereastra terminalului, care va afişa:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+Terminalul de pe PaizaCloud Cloud IDE este pregătit pentru instrucțiunile tale. Poți redimensiona sau maximiza această fereastră pentru a o face puțin mai mare.
+
+#### AWS Cloud9
+
+Actual, Cloud 9 îți cere să te înregistrezi cu AWS și să introduci datele cardului tău de credit.
+
+1. Instalează Cloud 9 din [magazinul de aplicații Chrome](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Mergi la [c9.io](https://c9.io) și fă click pe *Începe cu Cloud9 AWS*
+3. Înscrie-te pentru un cont AWS (necesită informații despre cardul de credit, dar îl poți folosi gratuit)
+4. În tabloul de bord AWS, introdu *Cloud9* în bara de căutare și fă click pe el
+5. În tabloul de bord Cloud 9, fă click pe *Creare Mediu*
+6. Numește-l *django-girls*
+7. La configurarea setărilor, selectează *Creați o nouă instanță pentru mediu (EC2)* pentru "Tipul de mediu" și *t2. icro* "Tip de instanţă" (ar trebui să spună "Eligibil pentru rang gratuit"). Setarea implicită de reducere a costurilor este bună și poți păstra celelalte valori implicite.
+8. Fă click pe * Server nou *
+9. Fă click pe *Creează Mediu*
+
+Acum ar trebui să vezi o interfață cu o bară laterală, o mare fereastră principală cu ceva text şi o fereastră mică în partea de jos care arată cam aşa:
+
+{% filename %}bash{% endfilename %}
+
+    numeutilizator:~/workspace $
+    
+
+Această zonă de jos este terminalul tău. Poți folosi terminalul pentru a trimite instrucțiuni calculatorului din Cloud 9. Poți redimensiona fereastra pentru a o face puțin mai mare.
+
+#### IDE Cloud Glitch.com
+
+1. Mergi la [Glitch.com](https://glitch.com/)
+2. Înscrie-te pentru un cont (https://glitch.com/signup) sau folosește contul tău GitHub dacă ai unul. (Vezi instrucțiunile GitHub de mai jos.)
+3. Fă lick pe *New Project* și alege *hello-webpage*
+4. Fă click pe lista verticală de instrumente Tools (în partea din stânga jos a ferestrei), apoi pe butonul Terminal pentru a deschide fereastra terminalului cu un prompt ca acesta:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@numele-proiectului-tău-glitch:~
+    
+
+Când folosești Glitch.com ca și Cloud IDE, nu e nevoie să creezi un mediu virtual. În schimb, creează următoarele fișiere manual:
+
+{% 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
+```
+
+Odată ce aceste fișiere sunt create, mergi în Terminal și execută următoarele comenzi pentru a crea primul tău proiect Django:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+Pentru a vedea mesaje de eroare detaliate, poți activa jurnalele de depanare Django pentru aplicația Glitch. Doar adaugă la sfârșitul fișierului `mysite/settings.py:</p>
+
+<p>{% filename %}mysite/settings.py{% endfilename %}</p>
+
+<pre><code class="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,
+        },
+    },
+}
+`</pre> 
+
+Asta va crea un fișier `debug.log` care detaliază operațiunile în Django și orice mesaje de eroare care ar putea apărea. Cu ajutorul acestui fișier este mai ușor să remediezi site-ul dacă nu funcționează.
+
+Repornirea iniţială a proiectului Glitch ar trebui să eşueze. (Dacă faci clic pe butonul derulant de sus `Afișați` apoi faci clic pe `Într-o fereastră nouă`, vei primi un mesaj de eroare `DisallowedHost` . Nu-ți face griji în această etapă, tutorialul va remedia această problemă de îndată ce actualizezi setările Django ale proiectului în fișierul `mysite/settings.py`.
+
+### Mediul Virtual
+
+Un mediu virtual (numit și virtualenv) este ca o cutie privată în care putem să punem cod de calculator util pentru un proiect la care lucrăm. Putem folosi medii virtuale pentru a păstra diverse bucăți de cod de care avem nevoie pentru diferite proiecte, pentru a nu le amesteca între proiecte.
+
+Execută:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(observă că pe ultima linie conține o tildă urmată de semnul egal: `~=`).
+
+### GitHub
+
+Creează-ți un cont [GitHub](https://github.com).
+
+### PythonAnywhere
+
+Tutorialul Django Girls include o secţiune despre ceea ce se numeşte Deployment, care este procesul de luare a codului care alimentează noua aplicație web și de mutare a acesteia pe un calculator accesibil publicului (numit server), astfel încât alți oameni să-ți poată vedea munca.
+
+Această parte este puţin ciudată când urmezi tutorialul pe un Chromebook, deoarece folosești deja un calculator care se află pe internet (spre deosebire de un laptop, de exemplu). Totuși, este bine de stiut: poți considera Cloud 9 ca un spațiu de lucru sau munca ta în curs de desfășurare și Python Anywhere ca locul în care îți poți prezenta proiectul odată ce acesta se apropie de final.
+
+Așadar, creează-ți un cont nou pe Python Anywhere la [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ro-RO/code_editor/README.md b/ro-RO/code_editor/README.md
new file mode 100644
index 00000000000..a64af781909
--- /dev/null
+++ b/ro-RO/code_editor/README.md
@@ -0,0 +1,11 @@
+# Editor de cod
+
+> Pentru cititorii de acasă: acest capitol este acoperit în video-ul  Instalarea Python & amp; Editor de cod </ 0>.</p> </blockquote> 
+> 
+> Ești pe cale să scrii prima linie de cod, așa că e timpul să descarci un editor de cod!
+> 
+> > **Notă** Dacă folosești un Chromebook, sari peste acest capitol și asigură-te că urmezi instrucțiunile [de configurare Chromebook](../chromebook_setup/README.md). Mediul de dezvoltare integrat (IDE) în cloud pe care l-ai ales (PaizaCloud Cloud IDE sau AWS Cloud9) include un editor de cod, iar când deschizi un fişier în IDE din meniul de fişiere, vei folosi automat editorul.
+> > 
+> > **Notă** S-ar putea să fi făcut acest lucru mai devreme în capitolul Instalare - dacă da, atunci poți trece imediat la capitolul următor!
+> 
+> {% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ro-RO/code_editor/instructions.md b/ro-RO/code_editor/instructions.md
new file mode 100644
index 00000000000..c7bcf301da3
--- /dev/null
+++ b/ro-RO/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Există o mulţime de programe diferite de editare şi, în mare măsură, alegerea se reduce la preferinţa personală. Cei mai mulți programatori Python utilizează MPI-uri (Medii de Programare Integrate) complexe, însă extrem de puternice, precum PyCharm. Pentru un începător, totuși, ele sunt mai puțin adecvate; recomandările noastre sunt la fel de puternice, dar mult mai simple.
+
+Sugestiile noastre sunt mai jos, dar nu ezita să o întrebi pe antrenoarea ta ce preferințe are - va fi mai ușor să obții ajutor de la ea.
+
+## Visual Studio Code
+
+Visual Studio Code este un editor de cod dezvoltat de Microsoft pentru Windows, Linux şi macOS. Acesta include suport pentru depanare, control Git încorporat, evidențiere de sintaxă, completare de cod inteligentă, fragmente și refactorizare de cod.
+
+[Descarcă-l de aici](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit este un editor open-source, gratuit, disponibil pentru toate sistemele de operare.
+
+[Descarcă-l de aici](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Subline Text este un editor foarte popular cu o perioadă de evaluare nelimitată și gratuită și este disponibil pentru toate sistemele de operare.
+
+[Descarcă-l de aici](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom este un alt editor popular. Este gratuit, open-source și disponibil pentru Windows, OS X și Linux. Atom este dezvoltat de [GitHub](https://github.com/).
+
+[Descarcă-l de aici](https://atom.io/)
+
+## De ce instalăm un editor de cod?
+
+Poate te întrebi de ce instalăm acest program special de editat cod, în loc să folosim ceva precum Word sau Notepad.
+
+În primul rând, codul trebuie să fie **text simplu**, iar problema cu programele ca Word și Textedit este că ele nu produc text simplu, ci text îmbogățit (cu fonturi și formatare), folosind formate ca [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+Al doilea motiv este că editoarele de cod sunt specializate în editarea codului, astfel încât ele pot oferi funcționalități utile precum colorarea codului în funcție de semnificația lui sau închiderea automată a ghilimelelor.
+
+Vom vedea toate acestea în acțiune mai târziu. În curând, vei ajunge să te gândești la vechiul tău editor de cod ca unul dintre instrumentele tale preferate. :)
\ No newline at end of file
diff --git a/ro-RO/css/README.md b/ro-RO/css/README.md
new file mode 100644
index 00000000000..7c41b573a1c
--- /dev/null
+++ b/ro-RO/css/README.md
@@ -0,0 +1,265 @@
+# CSS - fă-l frumos!
+
+Blog-ul nostru încă arată destul de urât, nu-i așa? E timpul să-l facem frumos! Pentru asta vom folosi CSS.
+
+## Ce este CSS?
+
+Cascading Style Sheets (CSS) este un limbaj folosit pentru a descrie aspectul vizual și formatarea unui website scris într-un limbaj de marcaj (ca HTML). Poate fi considerat ca machiaj pentru pagina noastră web :)
+
+Dar nu vrem să o luăm de la început, nu-i așa? Încă o dată, vom folosi ceva ce programatorii au lansat gratuit pe internet. Reinventarea roții nu este distractivă, la urma urmei.
+
+## Hai să folosim Bootstrap!
+
+Bootstrap este unul din cele mai populare framework-uri HTML și CSS pentru dezvoltarea website-urilor frumoase: https://getbootstrap.com/
+
+A fost scris de programatorii care au lucrat la Twitter. Acum e dezvoltat de voluntari din toată lumea!
+
+## Instalarea Bootstrap
+
+Pentru a instala Bootstrap, deschide fișierul `.html` în editorul de cod și adaugă codul următor în secțiune `<head>`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Aceasta nu adaugă niciun fișier la proiect, ci doar face referință la fișiere care există pe Internet. Deschide website-ul și actualizează pagina. Iat-o!
+
+![Figura 14.1](images/bootstrap1.png)
+
+Deja arată mai frumos!
+
+## Fișierele statice în Django
+
+În sfârșit ne vom uita mai atent la lucrurile pe care le numim **fișiere statice**. Fișierele statice sunt toate imaginile și fișierele CSS. Conținutul acestora nu depinde de contextul cererii la server și va fi la fel pentru orice utilizator.
+
+### Unde se pun fișierele statice pentru Django
+
+Django deja știe unde să găsească fișierele statice pentru aplicația "admin" preconfigurată. Acum trebuie doar să adaugi niște fișiere statice pentru aplicația `blog`.
+
+Facem asta prin crearea unui dosar numit `static` înăuntrul blog-ului:
+
+    djangogirls 
+    ├── blog 
+    │ ├── migrations 
+    │ ├── static 
+    │ └── templates 
+    └── mysite
+    
+
+Django va găsi automat orice dosar numit "static" în oricare din dosarele aplicațiilor tale. Apoi va putea folosi conţinutul lor ca fişiere statice.
+
+## Primul tău fișier CSS!
+
+Hai să creăm un fișier CSS acum, pentru a adăuga propriul stil pe pagina ta web. Creează un director nou numit `css` în interiorul directorului `static`. Apoi creează un nou fișier numit `blog.css` în interiorul directorului `css`. Gata?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+E timpul să scrii niște CSS! Deschide fișierul `blog/static/css/blog.css` în editorul de cod.
+
+Nu vom învăța în detaliu despre personalizarea CSS aici. La sfârșitul acestei pagini există o recomandare pentru un curs gratuit de CSS, dacă vrei să aflii mai multe.
+
+Dar hai să facem cel puțin ceva. Poate am putea schimba culoarea header-ului? Pentru a înțelege culorile, calculatoarele ulilizează niște coduri speciale. Aceste coduri încep cu `#` urmat de 6 litere (A-F) și numere (0-9). De exemplu, codul pentru culoarea albastră este `#0000FF`. Poți găsi codurile pentru mai multe culori aici: http://www.colorpicker.com/. Poți de asemenea utiliza [culori predefinite](http://www.w3schools.com/colors/colors_names.asp), precum `red` - roșu și `green` - verde.
+
+În fișierul `blog/static/css/blog.css` adaugă următorul cod:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` este un Selector CSS. Asta înseamnă că aplicăm stilurile noastre la orice element `a` în interiorul unui element `h1` ; selectorul `h2 a ` face același lucru pentru elementele `h2`. Așa că atunci când avem ceva de genul `<h1><a href="">link</a></h1>`, stilul `h1 a` va fi aplicat. În acest caz, noi îi spunem să își schimbe culoarea în `#C25100`, care reprezintă culoarea oranj. Sau poți pune culoarea ta proprie aici, dar asigură-te că are un contrast bun cu un fundal alb!
+
+Într-un fișier CSS determinăm stilurile pentru elementele din fișierul HTML. Primul mod în care identificăm elementele este cu numele elementului. Poate îți amintești de acestea ca tag-uri din secţiunea HTML. Lucruri ca `a`, `h1`, şi `bodz` sunt exemple de nume de elemente. De asemenea putem identifica elementele după atributul `class` sau atributul `id`. Numele de clasă și id le definești singură. Clasele definesc grupuri de elemente, iar id-urile indică elemente specifice. De exemplu, ai putea identifica următorul element folosind numele elementului `a`, clasa `external_link`, sau id-ul `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Poți citi mai multe despre [selectori CSS pe w3school](http://www.w3schools.com/cssref/css_selectors.asp).
+
+De asemenea, trebuie să-i spunem șablonului nostru HTML că am adăugat CSS. Deschide fișierul `blog/templates/blog/post_list.html` în editorul de cod și adaugă această linie la începutul acestuia:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Noi doar încărcăm fișierele statice aici. :) Între tag-urile `<head>` și `</head>`, după link-urile către fișierele CSS Bootstrap, adaugă această linie:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Browser-ul citește fișierele în ordinea în care sunt transmise, așa că trebuie să ne asigurăm că se află în locul potrivit. În caz contrar, codul din fișierul nostru poate fi rescris de codul din fișierele Bootstrap. Tocmai i-am spus șablonului unde se află fișierul nostru CSS.
+
+Fișierul tău trebuie să arate așa:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Bine, salvează fișierul și actualizează pagina!
+
+![Figura 14.2](images/color2.png)
+
+Bună treabă! Poate am vrea să-i dăm site-ului un pic de spațiu și să mărim marginea din partea stângă? Să încercăm!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Adaugă asta la codul tău CSS, salvează fișierul și vezi cum funcționează!
+
+![Figura 14.3](images/margin2.png)
+
+Poate putem personaliza font-ul din header? Inserează asta în `<head>` în fișierul `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Ca și înainte, verifică ordinea și plasează linia înainte de link-ul către `blog/static/css/blog.css`. Această linie va importa un font numit *Lobster* din Google Fonts (https://www.google.com/fonts).
+
+Găsește blocul de declarații `h1 a` (codul dintre paranteze `{` și `}`) în fișierul CSS `blog/static/css/blog. ss`. Acum adaugă linia `font-family: 'Lobster';` între paranteze și actualizează pagina:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figura 14.3](images/font.png)
+
+Grozav!
+
+Cum am menționat mai înainte, CSS are conceptul de clase. Acestea îți permit să numești o parte din codul HTML și să aplici stiluri numai la această parte, fără a afecta alte părți. Acest lucru poate fi foarte util! Poate ai două div-uri care fac ceva diferit (de exemplu, header şi postare). O clasă te poate ajuta să le faci să arate diferit.
+
+Acum numește câteva părți ale codului HTML. Înlocuiește `header` care conține header-ul tău cu următorul cod:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+Acum adaugă o clasă `post` la `article` care conține un post de blog.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Acum vom adăuga blocuri de declarare la selectoare diferite. Selectoarele care încep cu `.` se referă la clase. Există multe tutoriale și explicații despre CSS pe Internet care te ajută să înțelegi următorul cod. Pentru moment, doar copiază-l și inserează-l în fișierul `blog/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+<0>
+    <1>published: {{ post.published_date }}</1>
+    <2>{{ post.title }}</2>
+    <3>{{ post.text|linebreaksbr }}</3>
+</0>
+```
+
+Apoi înconjoară codul HTML care afișează postările cu declarații de clase. Înlocuiește asta:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+în `blog/templates/blog/post_list.html` cu acest cod:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Salvează fișierele și actualizează site-ul.
+
+![Figura 14.4](images/final.png)
+
+Uau! Arată super, așa-i? Hai să ne uităm la codul pe care l-am copiat ca să găsim locurile unde am adăugat clasele în HTML și le-am folosit în CSS. Unde ai face schimbarea dacă ai dori ca data să fie de culoare turcoaz?
+
+Nu-ți fie teamă să experimentezi cu acest CSS și să încerci să modifici unele lucruri. Joaca cu CSS te poate ajuta să înțelegi ce fac diferite lucruri. Dacă strici ceva, nu-ți face griji – poți oricând să anulezi schimbarea!
+
+Îți recomandăm să urmezi cursurile online gratuite "Basic HTML & HTML5" şi "Basic CSS" pe [freeCodeCamp](https://learn.freecodecamp.org/). Ele te pot ajuta să înveți cum să-ți înfrumusețezi site-urile cu HTML și CSS.
+
+Gata pentru capitolul următor?! :)
\ No newline at end of file
diff --git a/ro-RO/deploy/README.md b/ro-RO/deploy/README.md
new file mode 100644
index 00000000000..d7759dc6f58
--- /dev/null
+++ b/ro-RO/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Notă**: Următorul capitol poate fi, uneori, un pic cam greu de înțeles. Să persistăm şi să-l ducem până la capăt; deployment-ul este o parte importantă a procesului de dezvoltare a site-ului. Acest capitol este plasat la mijlocul tutorialului, astfel încât mentorul să poată ajuta în procesul un pic mai complicat de a duce website-ul online. Aceasta înseamnă că e posibil de terminat tutorialul pe cont propriu, dacă nu rămâne timp.
+
+Pînă acum, website-ul nostru a fost valabil doar pe computer-ul nostru. Acum vom învăța cum să facem deploy! Deployment-ul este procesul de publicare a aplicației pe Internet, astfel încât aplicația să fie vizibilă pentru toți. :)
+
+După cum am învățat, un website trebuie să fie localizat pe un server. Sunt o mulțime de furnizoare de server valabile pe internet, noi vom folosi [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere este gratuit pentru aplicații mici care nu au mulți visitatori și cu siguranță va fi suficient pentru noi acum.
+
+Celălalt serviciu extern pe care-l vom utiliza este [GitHub](https://www.github.com), un serviciu de găzduire de cod. Există și altele, însă aproape toţi programatorii au un cont de GitHub acum, așa că, acum, vom avea și noi!
+
+Aceste trei locuri vor fi importante pentru noi. Computer-ul local va fi locul unde vom face dezvoltarea codului și testarea lui. Cînd suntem ok cu schimbările, vom plasa o copie a programului pe GitHub. Website-ul nostru va fi pe PythonAnywhere și îl vom actualiza luînd o copie nouă a codului de pe GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Inițializarea repository-ului Git propriu
+
+Git depistează modificările unui anumit set de fişiere în ceea ce se numeşte un repository de cod (sau, pe scurt, "repo"). Să începem unul pentru proiectul nostru. Deschidem consola şi executăm aceste comenzi, în directoriul `djangogirls`:
+
+> **Notă** Putem verifica mapa curentă de lucru cu comanda `pwd` (Mac OS X/Linux) sau `cd` (Windows) înainte de a inițializa repo-ul. Ar trebui să fim în mapa `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Numele tău"
+    $ git config --global user.email tu@exemplu.com
+    
+
+Inițializarea repo-ului git este ceva ce trebuie să facem doar odată la proiect (și nu va trebui de introdus numele de utilizator și email-ul de fiecare dată).
+
+Git va urmări modificările făcute în toate fişierele şi mapele în această directorie, dar există unele fişiere pe vrem să le ignore. Facem acest lucru prin crearea unui fişier numit `.gitignore` în directoriul de bază. Deschidem editorul de cod şi creăm un nou fişier cu următorul conținut:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+Și îl salvăm ca `.gitignore` în mapa "djangogirls".
+
+> **Note** Punctul de la începutul numelui de fișier este important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+Este o idee bună să folosiți comanda `git status` înaintea celei de `git add` sau ori de câte ori nu ești sigură legat de ceea ce s-a schimbat. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Și în cele din urmă salvăm modificările. Intră în consolă și rulează aceste comenzi:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/ro-RO/deploy/install_git.md b/ro-RO/deploy/install_git.md
new file mode 100644
index 00000000000..5425bcccd98
--- /dev/null
+++ b/ro-RO/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git este un "sistem de versionare" folosit de mulți programatori. Acest software poate să urmărească schimbările făcute în fișiere de-a lungul timpului, pentru a putea reveni la anumite versiuni mai târziu. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Instalarea Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Putem descărca Git aici [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). În afară de aceasta, valorile implicite sunt ok. Verificarea în stil Windows și sfârşiturile de linie de cod pentru commit-uri în stil Unix sunt ok.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Notă** Dacă e rulat OS X 10.6, 10.7 sau 10.8, trebuie de instalat versiunea Git-ului de aici: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ro-RO/deploy/signup_pythonanywhere.md b/ro-RO/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..974aa297ee6
--- /dev/null
+++ b/ro-RO/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere este un serviciu pentru a executa codul Python pe "cloud" servere. O să-l utilizăm pentru a publica site-ul, live în Internet.
+
+O să publicăm blogul nostru pe PythonAnywhere. Înregistrați un account "Beginner" pe PythonAnywhere (pentru un account gratis nu aveți nevoie de un card credit).
+
+* [https://www.pythonanywhere.com/registration/register/beginner/](https://www.pythonanywhere.com/)
+
+![Pagina de înergistrare pe PythonAnywhere cu buton pentru a crea un 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Notă** Când îți alegi numele de utilizator aici, ține minte că adresa URL a blogului tău va lua forma de `numeutilizator.pythonanywhere.com`, așa că alege ori propria ta poreclă sau un nume care spune despre ce va fi blogul tău. Țineți minte să-ți amintiți despre parola (adăugați-l în manager de parole, dacă îl utilizați).
+
+## Crearea unui token API pe PythonAnywhere
+
+Trebuie să faceți acesta numai o dată. O să fiți redirecționați pe dashboard-ul. Găsiți link-ul pe pagina "Account":
+
+![Linkul la Account în colțul din sus-dreapta a paginii](../deploy/images/pythonanywhere_account.png)
+
+apoi selectați tab-ul "API token" și apăsați butonul "Create new API token" (Creați API token nou).
+
+![Tab-ul cu tokene API pe pagina Account](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ro-RO/django/README.md b/ro-RO/django/README.md
new file mode 100644
index 00000000000..e23b8386492
--- /dev/null
+++ b/ro-RO/django/README.md
@@ -0,0 +1,27 @@
+# Ce este Django?
+
+Django (*/ˈdʒæŋɡoʊ/ jang-goh*) este un framework gratuit și open-source pentru aplicații web, scris în Python. Un framework este un set de compenente care te ajută să îți dezvolți site-ul mai rapid și mai ușor.
+
+Atunci când construiești un web site, întodeauna vei avea nevoie de un set similar de compenente: o modalitate de a manipula autentificarea utilizatorului (înregistrare, autentificare, deconectare), un panou de administrare pentru web site-ul tău, forme și o modalitate de a încărca fișiere, etc.
+
+Din fericire pentru tine, cu mult timp în urmă alți oameni au observat că dezvoltatorii web întâmpină probleme similare atunci când construiesc un web site nou, așa că ei au făcut echipă și au creat aceste framework-uri (infrastructuri) (Django fiind unul dintre acestea) care îți oferă componente gata făcute pentru folosire.
+
+Framework-urile există pentru a te salva de la necesitatea de a reinventa roata și a te ajuta să treci peste lucrurile de rutină când creezi site-ul tău web.
+
+## De ce ai nevoie de un framework?
+
+Pentru a înțelege de ce avem nevoie de Django, avem nevoie să aruncăm o privire mai atentă la servere. Primul lucru este că serverul trebuie să știe că tu vrei de la el să îți reprezinte o pagină web.
+
+Imaginează-ți o cutie poștală (port) căreia îi sunt monitorizate scrisorile primite (cereri). Acest lucru este făcut de un server web. Serverul web citește scrisoarea, și trimite un răspuns cu o pagină web. Dar când dorești să transmiți ceva, trebuie să ai careva conținut. Și Django este ceva care te ajută să creezi acel conținut.
+
+## Ce se întâmplă când cineva solicită un site web de pe server?
+
+Când un web server primește o cerere, ea este transmisă către Django, care încearcă să-și dea seama ce de fapt este solicitat. Mai întâi primește o adresă de pagină web și încearcă să-și dea seama ce să facă. Această parte se face prin **urlresolver**-ul la Django (o adresă de pagină web se numește URL (Uniform Resource Locator) - Localizator Uniform de Resurse, deci numele de *urlresolver* are sens). Nu este prea inteligent - ia o listă de modele și încearcă să le potrivească cu URL-ul. Django verifică modelele de sus până jos și dacă se potrivește ceva, Django trimite cererea la funcția potrivită (care se numește *view*).
+
+Imaginează-ți un poștaș cu o scrisoare. Ea trece de-a lungul străzii și compară la fiecare casă numărul cu cel de pe scrisoare. Dacă coincid, ea lasă scrisoarea acolo. Așa lucrează urlresolver-ul!
+
+În funcția *view* se realizează toate lucrurile interesante: ne putem uita într-o bază de date pentru a căuta o informație anumită. Poate utilizatorul a solicitat să schimbe ceva în baza de date? Cum ar fi o scrisoare „Vă rog să schimbați descrierea job-ului meu.” Un *view* poate verifica dacă îți este permis să faci asta, apoi să actualizeze descrierea job-ului pentru tine și să răspundă cu un mesaj de confirmare: „Gata!”.
+
+Desigur descrierea de mai sus este un pic simplificată, dar nu este nevoie să știți toate lucrurile tehnice la moment. Este suficient să vă faceți o idee generală.
+
+Deci, în loc să ne adâncim în detalii, pur și simplu vom începe a crea ceva cu Django și vom învăța toate părțile importante pe parcurs!
\ No newline at end of file
diff --git a/ro-RO/django_admin/README.md b/ro-RO/django_admin/README.md
new file mode 100644
index 00000000000..9dd55fdd85a
--- /dev/null
+++ b/ro-RO/django_admin/README.md
@@ -0,0 +1,57 @@
+# Consola de admin din Django
+
+Pentru adăugarea, editarea și ștergerea articolelor pe care tocmai le-am descris în modele, vom utiliza consola de admin din Django.
+
+Deschideți fișierul `blog/admin.py` în editorul de cod și înlocuiește conținutul său cu textul următor:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Așa cum poți observa, importăm (includem) modelul Post definit în capitolul anterior. Pentru a face modelul vizibil în consola de admin, trebuie să înregistrăm modelul cu instrucțiunea `admin.site.register(Post)`.
+
+OK, acum este timpul să ne uităm la modelul Post. Reamintește-ți să rulezi comanda ` python manage.py runserver ` în linia de comandă pentru a rula serverul web. Deschideți în browser adresa http://127.0.0.1:8000/admin/. O să vedeți pagina de login:
+
+![Pagina de login](images/login_page2.png)
+
+Pentru a vă logați în consola de admin, trebuie să creați un *superuser* - un utilizator ce are control asupra tuturor resurselor din site. Pentru a crea un superuser trebuie să executați din linia de comandă `python manage.py createsuperuser`.
+
+> Țineți minte pentru a scrie comenzile noi când serverul web este pornit, trebuie să deschideți o nouă linie de comandă și să activați virtualenv corespunzător. Ați văzut cum să scrieți comenzile noi în capitolul **Primul proiectul Django!**, în secția **Pornirea serverului web**.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Vi se va cere să introduceți username (cu litere mici și fără spații), o adresă de email și parolă pentru user. **Nu vă faceți grijă că nu vedeți parola pe care o tapați – așa și trebuie să fie.** Introduceți-l și apăsați `enter` pentru a continua. Ceea ce veți vedea trebuie să fie asemănătoare cu (unde username și email ar trebui să fie cele introduse de voi):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Întoarce-ți la browserul web. Conectează-ți cu credențialele superuserului pe care tocmai l-ați creat; veți putea să vedeți consola de admin din Django.
+
+![Django admin](images/django_admin3.png)
+
+Mergeți la Articolele și experementați cu ei. Adăugați cinci ori șase posturile de blog. Nu vă faceți grija de conținutul - el este vizibil numai pe calculatorul vostru local - puteți să faceți o copie de text din acest tutorial pentru a păstra timp. :)
+
+Asigura-ți că cel puțin două sau trei postări (dar nu toate) au setat câmpul publish date. Va fi de folos mai târziu.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Ăsta este un moment bun să-vi luați o cafea (sau ceai) sau ceva de mâncare pentru a prinde energie. Ați creat primul tău model de Django - meritați o pauză!
\ No newline at end of file
diff --git a/ro-RO/django_forms/README.md b/ro-RO/django_forms/README.md
new file mode 100644
index 00000000000..712da385a03
--- /dev/null
+++ b/ro-RO/django_forms/README.md
@@ -0,0 +1,479 @@
+# Formulare în Django
+
+La final vrem să adăugăm la proiectul nostru o metodă pentru a crea sau edita postări de blog. Consola de `admin` din Django este ajutătoare, dar este destul de greu să o perosnalizezi și să o faci frumoasă. Cu `forms` avem putere absolută în crearea interfeței noastre - putem face aproape tot ce ne putem imagina!
+
+Un lucru util la formularele (forms) Django este că putem defini unul de la zero, sau putem crea un `ModelForm` care va salva ce se găsește în formular în model.
+
+Asta ne și propunem să facem: vom crea un formular pentru modelul nostru `Post`.
+
+La fel ca și celălalte componente importante din Django, formularele au propriul lor fișier: `forms.py`.
+
+Trebuie să creăm un fișier cu acest nume în directorul `blog`.
+
+    blog
+       └── forms.py
+    
+
+Hai să-l deschidem în editorul de cod și tapăm comandă următoare:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Dintâi, Trebuie să importăm formularele Django (`from django import forms`) și, evident, modelul nostru `Post` (`from .models import Post`).
+
+După cum probabil suspectați, `PostForm` este numele formularului nostru. Trebuie să îi spunem lui Django că acest formular este un `ModelForm` (astfel încât Django îi aplică un pic de magie pentru noi) - `forms.ModelForm` se ocupă de asta.
+
+Apoi, avem `class Meta`, unde îi spunem lui Django care model ar trebui să fie folosit pentru a creea acest formular (`model = Post`).
+
+La final, putem să spunem care câmp(uri) ar trebui să ajungă în formular. În acest scenariu ne dorim să expundem doar `title` (titlul) și `text` (textul) - `author` (autorul) ar trebui să fie persoana care este acum autentificată (adică tu!) iar `created_date` (data de creare) ar trebui să fie setată automat când creăm postul (din cod), nu?
+
+Și gata! Tot ce trebuie să facem acum e să folosim formularul într-un *view* și să-l afișăm într-un template.
+
+Deci încă o dată vom crea: un link către pagină, un URL, un view și un template.
+
+## Link către o pagină cu formularul
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Șablon
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* Noi trebuie să afișăm pe formular. Putem să facem acesta (de exemplu) în mod următor {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Avem nevoie de butonul `Save` (Salvează). Facem acesta cu un buton HTML: `<button type="submit">Save</button>`.
+* Și în final, după deschiderea tăgului `<form ...>` noi trebuie să adăugăm {% raw %}`{% csrf_token %}`{% endraw %}. Acesta este foarte important pentru că face formulare protejate! Dacă nu faceți acesta, Django va da o eroare când o să încercați să-l salvați pe formular:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Salvarea formularului
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Validație formularelor
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Editarea formularului
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Securitate
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Un alt lucru: lansați site-ul!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* Dintâi, faceți un commit de cod și un push pe GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Apoi în [linie de comandă pe PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* În sfârșit, mergeți la pagina ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (utilizați butonul din meniu în colțul de sus-dreapta) și apăsați **Reload**. Faceți un refresh a paginii https://subdomain.pythonanywhere.com pentru a vizualiza schimbările.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ro-RO/django_installation/README.md b/ro-RO/django_installation/README.md
new file mode 100644
index 00000000000..c00f2cfaae0
--- /dev/null
+++ b/ro-RO/django_installation/README.md
@@ -0,0 +1,7 @@
+# Instalarea Django
+
+> **Notă** Dacă utilizați un Chromebook, treceți peste acest capitol și asigurați-vă că urmați instrucțunile de [setare a Chromebook-ului](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ro-RO/django_installation/instructions.md b/ro-RO/django_installation/instructions.md
new file mode 100644
index 00000000000..189ea2fa220
--- /dev/null
+++ b/ro-RO/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> O parte din această secţiune se bazează pe Tutoriale de Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parte din această secţiune se bazează pe [django-marcador tutorial](http://django-marcador.keimlink.de/) sub licenţa de Creative Commons Attribution-ShareAlike 4.0 International License. Django-marcador tutorial este protejat de Copyright de Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Înainte de a instala Django o să treceți prin pașii de instalare a unui instrument extrem de folos pentru a păstra mediu de programare ordonat pe calculatorul vostru. Este posibil să omiteți acest pas, dar el este foarte recomandat. Porinind de la cea mai buna metodă de configurare o să vă păstrați de mulțime de probleme în viitor!
+
+Haideți să creăm un **virtual environment** (de asemenea numit *virtualenv*). Virtualenv va izola setarea Python/Django pe bază a proiectului. Acest lucru înseamnă că orice modificare a unui singur site nu va afecta pe alte care sunt în curs de dezvoltare. Ordonat, corect?
+
+Tot ce trebuie să faceţi este să găsiți un directoriu, în care doriţi să creaţi `virtualenv`; directoriul home, de exemplu. Pe Windows, acesta ar putea arăta ca `C:\Users\Name` (unde `Name` este numele vostru de utilizator).
+
+> **NOTĂ:** Pe Windows, asiguraţi-vă că acest directoriu nu conţine caractere accentuate sau speciale; în cazul în care numele de utilizator conţine caractere accentuate, folosiţi un alt directoriu, de exemplu, `C:\djangogirls`.
+
+Pentru acest tutorial vom folosi un directoriu nou `djangogirls` din directoriul home:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Vom face un virtualenv numit `myvenv`. Comanda generală va fi în format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Pentru a crea un nou `virtualenv`, aveți nevoie de a deschide linie de comandă și să executați `python -m venv myvenv`. El va arăta în mod următor:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Unde `myvenv` este numele `virtualenv` vostru. Puteţi utiliza orice alt nume, dar preferați caracterele mici şi nu folosiți spații, accente sau caractere speciale. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Putem crea un `virtualenv` atât pe Linux şi OS X prin executarea `python3 -m venv myvenv`. Acesta se va arăta astfel:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+Unde `myvenv` este numele `virtualenv` vostru. Puteţi utiliza orice alt nume, dar preferați caracterele mici şi nu folosiți spații. De asemenea, este o idee bună să păstrați numele scurt - voi o să-l menționați mult!
+
+> **NOTĂ:** Pe unele versiuni de Debian/Ubuntu este posibil să primiţi următoarea eroare:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> În acest caz, urmaţi instrucţiunile de mai sus şi instalați pachetul de `python3-venv`: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTĂ:** Pe unele versiuni de Debian/Ubuntu crearea environment-ului virtual în fel respectiv dă eroarea următoare:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Pentru a rezolva problema respectivă, folosiți de comanda `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTĂ:** Dacă primiţi eroarea următoare
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> atunci executați:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Lucru cu virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Porniţi environment-ul virtual prin executarea:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. În cazul acesta deschideți un alt Windows PowerShell, selectând opțiunea "Run as Administrator". Apoi, încercaţi să executați următoarea comandă înainte de a porni environment-ul virtual:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Instalarea pachetelor cu requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ro-RO/django_models/README.md b/ro-RO/django_models/README.md
new file mode 100644
index 00000000000..e72231fecb8
--- /dev/null
+++ b/ro-RO/django_models/README.md
@@ -0,0 +1,201 @@
+# Modele în Django
+
+Ceea ce ne dorim să creăm acum este ceva ce va păstra toate posturile blog-ului nostru. Dar pentru a putea face acest lucru trebuie să vorbim un pic despre lucruri numite `obiecte`.
+
+## Obiecte
+
+În programare există un concept numit `programare orientată pe obiecte`. Ideea este că în loc de a scrie totul ca o secvenţă plictisitoare de instrucţiuni de programare, putem modela lucruri şi defini modul în care ei interacţionează unul cu altul.
+
+Deci, ce este un obiect? Este o colecţie de proprietăţi şi acţiuni. Sună ciudat, dar vă vom da un exemplu.
+
+În cazul în care dorim să modelăm o pisică, vom crea un obiect `Cat`, care are unele proprietăţi, cum ar fi `color`, `age`, `mood` (cum ar fi bun, rău sau somnoros ;)), şi `owner` (care ar putea fi asociat cu un obiect de `Person` – sau, poate, în cazul pisicii abandonate, proprietatea această ar putea fi goală).
+
+`Cat` are niște acțiuni: `purr`, `scratch`, or `feed` (în cazul, în care noi vom da pisicii niște `CatFood`, care ar putea fi un obiect sepărat cu diferite proprietăți, de exemplu, `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+În principiu, idea este de a descrie lucruri reale cu cod, utilizând proprietăți (numite `proprietățile obiectului`) și acțiuni (numite `metode`).
+
+Cum vom modela posturile din blog? Dorim să creăm un blog, corect?
+
+Trebuie să răspundem la o întrebare: Ce este un post din blog? Care proprietăți el trebuie să aibă?
+
+Ok, într-adevăr, un post din blog are nevoie de text, care este conținutul și titlu, corect? Ar fi bine să cunoaștem cine l-a scris – de aceea avem nevoie și de autor. În sfârșit, dorim să știm când postul a fost creat și publicat.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Care lucruri ar putea fi făcute cu un post de blog? Ar fi bine să avem `o metodă` care publică un post, corect?
+
+O să avem nevoie de o metodă numită `publish`.
+
+Pentru că noi deja știm ce noi dorim să obținem, trebuie să începem să facem modele în Django!
+
+## Modele în Django
+
+Știînd ce este un obiect, putem crea un model în Django pentru postul de blog.
+
+Model în Django este un tip special de obiect – el este salvat în `baza de date`. O bază de date este o colecție de date. Acesta este un loc în care o să păstrăm informație despre utilizatorii, posturile de blog, ș.a. Noi o să utilizăm baza de date SQLite pentru a păstra date. Acesta este conector de baza de date implicit din Django - va fi suficient pentru scopurile nostre.
+
+Puteți imagina un model din bază de date ca un tabel cu coloane (atribute) și rânduri (date).
+
+### Crearea aplicației
+
+Pentru a păstra totul ordonat, o să creăm o aplicație sepărată în proiectul nostru. E bine să avem totul ordonat de la început. Pentru a crea aplicație avem nevoie de a executa următoare comandă în linie de comandă (din directoriu `djangogirls` unde este fișierul `manage.py`):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Veți observa că directoriu nou `blog` este creat și conține niște fișiere. Directoriile și fișierele în proiectul nostru trebuie să arată în felul următor:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+După crearea aplicației avem nevoie ca Django o să utilizeze. Noi facem acest lucru în fișierul `mysite/settings.py` -- el trebuie să fie deschis în editorul de cod. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. Rezultatul final trebuie să arate în fel următor:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Crearea modelului de un post de blog
+
+În fișierul `blog/models.py` definim pe toate obiectele numite `Models` – acesta este locul, unde o să definim un post de blog.
+
+Deschideți fișierul `blog/models.py` în editorul de cod și ștergeți totul din el și scrieți codul ca urmează:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Verificați că utilzați două bare de jos (`_`) în fiecare parte a `str`. Acest standard este utilizat frecvent în Python și uneori este numit "dunder" (scurtare pentru "double-underscore").
+
+E înfricoșător? Dar nu vă îngrijorați - o să explicăm ce înseamnă codul dat!
+
+Toate liniile, începând cu `from` or `import` sunt liniile ce adaugă niște biți din alte fișire. De aceea în loc de a copia și a inserta aceeași lucruri în fiecare fișier, noi putem iclude niște părți cu `from ... import ...`.
+
+`class Post(models.Model):` – linie această definește modelul nostru (el este `un obiect`).
+
+- `class` este un cuvânt special care indică că noi definim un obiect.
+- `Post` este denumirea modelului nostru. Putem s-o numim altfel (dar trebuie să evităm caractere speciale și spații libere). Mereu începeți denumirea clasei cu o majusculă.
+- `models.Model` însemnă că Post este un model în Django, de aceea Django știe că el trebuie să fie păstrat în bază de date.
+
+Acum noi definim proprietăți despre care noi am vorbit: `title`, `text`, `created_date`, `published_date` și `author`. Pentru a face acesta trebuie să definim tipurile fiecărui atribut (Acesta este text? E număr? E dată? E relație cu un alt obiect, de exemplu User?)
+
+- `models.CharField` – este cum definiți text cu numărul limitat de caractere.
+- `models.TextField` – este pentru text lung fără limite. Sună ideal pentru conținut unui post de blog, corect?
+- `models.DateTimeField` – este dată și timp.
+- `models.ForeignKey` – este relație cu un alt model.
+
+Noi n-o să explicăm toate detaliile aici, pentru că va lua mult timp. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+Ce despre `def publish(self):`? Acesta este metodă `publish` despre care am vorbit anterior. `def` înseamnă că acesta este o funcție/metodă și `publish` este denumirea acestei metode. Puteți să schimbați denumirea metodei, dacă doriți. Regulă de a crea denumirele corecte este că trebuie să utilizăm caractere mici și bare de jos în loc de spații. De exemplu, o metodă care calculează preț mediu ar putea fi numită `calculate_average_price`.
+
+Metode returnează des niște valori utilizând cuvântul cheie `return`. Un exemplu este metoda `__str__`. În cazul dat, când executăm `__str__()` primim text (**string**) cu titlu postului.
+
+Observați că `def publish(self):` și `def __str__(self):` sunt aliniate in clasa. Din motivul că Python este sensitiv la spații, este necesar să aliniem metodele în clase. Altfel, metode nu va fi a clasei și puteți să primiți o funcționare neașteptată.
+
+Dacă ceva despre modele nu este clar, întrebați-l pe mentorul vostru! Noi sțim că e complicat, în dosebit când aflați despre obiecte și funcții deodată. Dar sperăm că atunci este mai clar!
+
+### Crearea tabelelor pentru modele în baza de date
+
+Ultimul lucru este de a adăuga modelul nou la baza de date. Cel dintâi trebuie să facem ca Django să știe despre shimbari în model. (Noi tocmai am făcut schimbare!) În linie de comandă executați `python manage.py makemigrations blog`. Este urmatoare:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Notă:** Nu uitați să sălvați fișierele pe care le editați. Altfel, calculatorul va executa versiunea anterioară ce poate da erori neașteptate.
+
+Django a generat fișierul de migrare pe care trebuie s-o aplicăm la baza de date. Executați `python manage.py migrate blog` și rezultatul trebuie să fie următor:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Ura! Modelul Post este în baza de date! Va fi bine s-o vedem, corect? În capitolul următor o să aflați, cum este Post!
\ No newline at end of file
diff --git a/ro-RO/django_orm/README.md b/ro-RO/django_orm/README.md
new file mode 100644
index 00000000000..1111f47cccf
--- /dev/null
+++ b/ro-RO/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM și QuerySets
+
+În acest capitol veţi învăţa cum Django se conectează la baza de date şi stochează informație în ea. Haideti sa începem!
+
+## Ce este un QuerySet?
+
+QuerySet este, în genere, o listă de obiecte de anumit model. QuerySets dă posibilitate de a citi, filtra și sorta date dintr-o bază de date.
+
+E mai ușo să învățăm după exemplu. Să ne încercăm?
+
+## Django shell
+
+Deschideți linie de comandă pe calculatorul vostru (nu pe PythonAnywhere) și executați comandă următoare:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Rezultatul trebuie să fie următor:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Sunteți acum în linie de comandă Django. Este ca Python prompt, dar cu niște funcții magice adiționale. :) Python și aici.
+
+### Toate obiecte
+
+Hai să încercăm să afișăm toate posturile noastre. Executați comandă următoare:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! Am primit o eroare. Ea ne arată că nu numele Post nu e definit. E corect - noi am uitat să-l importăm!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+Importăm model `Post` din `blog.models`.Hai să afișăm pe toate posturile încă o dată:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Acesta este o listă de posturi pe ca le-am creat înainte! Noi am creat aceste posturi, utilizând interfața Django admin. Dar acum dorim să creăm posturi noi, utilizând Python. Cum obținem asta?
+
+### Crearea obiectului
+
+Acesta este cum să creați un nou obiect Post în baza de date:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Dar un ingredient lipsește: `me`. Avem nevoie să transmitem un exemplar de modelul `User` ca autor. Cum putem să obținem acesta?
+
+Hai să facem un import a modelului User:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Care utilizatorii avem în baza de date? Încercați codul următor:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+Acesta este utilizator cu super privilegiu, pe care i-am creat înainte! Hai să obținem un exemplar de utilizator (schimbați linie următoare ca să utilizați numele vostru de utilizator):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Acum noi facem `get` a utilizatorului `User` cu `username` care este 'ola'. Ordonat!
+
+Acum putem să cream un post de blog:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Ura! Doriți să verificați dacă s-a primit?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Avem un alt post in listă!
+
+### Adaugați mai multe posturi
+
+Acum puteți să adăugați mai multe posturi pentru a se adopta la acest proces. Mai adăugați doi sau trei posturi și trecem la capitolul următor.
+
+### Filtrarea obiectelor
+
+Functie importantă a QuerySets este abilitate de filtrare. Hai să găsim toate posturile utilizatorului ola. O să utilizăm `filter` în loc de `all` în `Post.objects.all()`. În paranteze o să indicăm condiție(ile) de filtrare la cere un post de blog trebuie să corespundă. În cazul nostru condiție este că `author` trebuie să fie egal cu `me`. Modul de a scrie acesta în Django este următor: `author=me`. Acum codul este următor:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Sau poate dorim să afișăm pe toate posturile care conțin cuvântul 'title' în atributul `title`?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Notă** Între `title` și `contains` este două bare de jos (`_`). Regulă aceasta este utilizată de Django's ORM pentru a sepăra denumirea atributului ("title") și operațiilor sau filtrelor ("contains"). Dacă utilizați numai una bară de jos, o să primiți o eroare de tip "FieldError: Cannot resolve keyword title_contains".
+
+Puteți să afișați o listă de posturi publicate. Facem asta, filtrând posturile care au `published_date` cu dată în trecut:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Din păcate, postul pe care noi i-am adăugat din linie de comandă Python încă nu este publicat. Dar putem schimba acesta! Dintâi trebuie să obținem postul pe care dorim să-l publicăm:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+Apoi îl publicăm, utilizând metoda `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Acum încercăm să obținem o listă de posturile (apăsați săgeată trei ori și apoi `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Sortarea obiectelor
+
+Utilizând QuerySets puteți să sortați listă de obiecte. Pentru a le sorta după tribubutul `created_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Putem să inversăm sortare, adăugând `-` la început:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Interogările complexe, utilizând o serie de metode
+
+După cum ați văzut, niște metode ale `Post.objects` returnează QuerySet. Aceași metode pot să fie utilizate pentru filtrarea a QuerySet-ului, și voi returna un nou QuerySet. Astfel, puteți să combinați efectul, utilizând o serie (**chaining**) de filtre:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Acesta dă posibilitate de a executa interogările complexe.
+
+Acum sunteți gată de următorul capitol! Pentru a închide linie de comandă executați:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ro-RO/django_start_project/README.md b/ro-RO/django_start_project/README.md
new file mode 100644
index 00000000000..e120dcb45c6
--- /dev/null
+++ b/ro-RO/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Primul proiect Django!
+
+> O parte capitolului acesta este bazată pe tutoriale realizate de Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parte din acest capitol se bazează pe [django-marcador tutorial](http://django-marcador.keimlink.de/) sub licenţa de Creative Commons Attribution-ShareAlike 4.0 International License. Tutorialul django-marcador este protejat de drepturi de autor de Markus Zapke-Gründemann et al.
+
+O să creăm un mic blog!
+
+Primul pas este de a crea un nou proiect Django. În principiu, acesta înseamnă că o să executăm niște Django scripturi care vor crea o structură proiectului Django. Acesta este numai un număr de directoriile și fișierile pe care vom utiliza în viitor.
+
+Denumirele unor fișiere și directorii sunt foarte importante în Django. Nu trebuie să redenumiți fișierile pe care urmați o să le creați. Mutarea lor într-un loc diferit nu este o idee bună. Django trebuie să mențină o structură anumită pentru a afla lucruri importante.
+
+> Trebuie să țineți minte să executați toate comenzile în virtualenv. Dacă nu vedeți prefix-ul `(myvenv)` în linie de comandă, trebuie să activați virtualenv. Am explicat cum să faceți acesta în secțiune **Django installation** în capitolul **Working with virtualenv**. Executând `myvenv\Scripts\activate` în Windows sau `source myvenv/bin/activate` în Mac OS X sau Linux va face acesta.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+În linie de comandă Mac OS X sau Linux executați comandă următoare. Nu uitați să adăugați punct la sfârșit `.`!
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Punct `.` este important pentru că el indică ca Django să fie instalat în directoriu curent (punct `.` este o referență).
+> 
+> **Notă** Când executați comandă de mai sus, țineți minte că trebuie să tapați numai o parte care începe cu `django-admin`. `(myvenv) ~/djangogirls$` este doar un exemplu de prompt în linie de comandă care va arăta că trebuie de a tapa comandă.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+În Windows puteți să executați comandă următoare **(Nu uitați să adăugați punct `.` la sfârșit)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Punct `.` este foarte important pentru că astfel Django va fi instalat în directoriu curent (punct `.` este o abreviere).
+> 
+> **Notă** Când executați comandă de mai sus, țineți minte că trebuie să tapați numai o parte care începe cu `django-admin.exe`. Parte `(myvenv) C:\Users\Name\djangogirls>` este un exemplu de prompt care va arăta că trebuie de a tapa o comandă în linie de comandă.
+
+<!--endsec-->
+
+`django-admin.py` este un script care va crea directoriile și fișierile. Acum trebuie să aveți următoare structura directoriilor:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Notă**: în structura directoriului o să vedeți directoriu `venv` care a fost creat înainte.
+
+`manage.py` este un script care ajută în managementul site-ului. Cu ajutorul lui putem (printre alte lucruri) să pornim web serverul pe calculatorul fără a instala instrumente adăugătoare.
+
+Fișierul `settings.py` conține configurația site-ului.
+
+Ținteți minte am vorbit despre trasmiterea corespondenței, verificând unde să livrăm scriisoare? Fișierul `urls.py` conține o listă de scheme, utlizate de `urlresolver`.
+
+Hai să ignorăm până când alte fișierile pentru că n-o să le modificăm. Un lucru de care trebuie să ținem minte este ca să nu le ștergem!
+
+## Modificarea setărilor
+
+Hai să facem niște schimbări în fișier `mysite/settings.py`. Deschideți fișierul, utilizând editorul de cod pe care l-ai instalat.
+
+**Notă**: Țineți minte că fișierul `settings.py` este un fișier obiișnuit, ca și alte. Puteți să-l deschideți din editorul de cod, utilizând meniu "file -> open". O fereastră obișnuită trebuie să fie deschisă în care puteți să alegeți fișierul `settings.py`. Un alt mod de a deschide este de a merge la directoriu djangogirls de pe desktop și a face dublu-click pe el. Apoi alegeți editorul de cod din listă. Este important să alegeți editorul de cod pentru că există programe care pot să deschidă fișierul, dar n-o să vă da voie să-l editați.
+
+Ar fi plăcut să avem timp corect pe site-ul nostru. Deschideți [listă de fusuri orare din Wikipedia](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) și copiați fusul apropiat (TZ) (de exemplu `Europe/Berlin`).
+
+În `settings.py`, găsiți o linie care conține `TIME_ZONE` și o modificați ca ea să conțină fusul ales. De exemplu:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+Codul de limbă constă din limbă, de exemplu `en` pentru engleză sau `de` pentru germană, și codul de țară, de exemplu `de` pentru germană sau `ch` pentru for Elveția. Dacă engleză nu este limbă nativă, puteți să adăugați codul de mai jos pentru a face ca butoanele standarde și notificațiile de la Django să fie în limba voastră. În astfel mod, butonul "Cancel" va fi tradus în limbă definită aici. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+Dacă doriți o altă limbă, schimbați codul de limbă, schimbând linie următoare:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Avem nevoie să adăugăm o cale pentru fișiere statice. (O să aflăm despre fișiere statice și CSS mai târziu în tutorial.) La *sfârșitul* fișierului, sub textul `STATIC_URL` adăugați o linie nouă `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Când `DEBUG` este `True` și `ALLOWED_HOSTS` n-are valoare, host este validat în domeniu `['localhost', '127.0.0.1', '[::1]']`. Acesta v-a fi diferit de denumirea domeniului pe PythonAnywhere când o să publicăm aplicație, de aceea schimbăm configurație următoare:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Notă**: Dacă utilizați pe Chromebook, adăugați linie aceasta la sfârșitul fișierului settings.py: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Mai adăugați `.amazonaws.com` la sfârșitul `ALLOWED_HOSTS`, dacă utilizați cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Setare bazei de date
+
+Există multe baze de date pentru a păstra dată pentru site-ul vostru. O să utilizăm opțiune standartă, `sqlite3`.
+
+Acesta este deja predifinit în parte acesta a fișierului `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Pentru a crea baza de date pentru blogul vostru, hai să executăm comandă următoare în linie de comandă: `python manage.py migrate` (trebuie să fim în directoriu `djangogirls` care conține fișierul `manage.py`). Dacă totul va fi bine, o să vedeți codul următor:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+Și am terminat! Este timp să pornim serverul web și să vedem că website-ul lucrează!
+
+## Pornirea serverului web
+
+Trebuie să fiți în directoriu care conține fișierul `manage.py` (directoriu `djangogirls`). În linie de comandă, putem să pornim serverul web, executând `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Dacă utilizați Chromebook, executați comandă de mai jos:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> Am făcut cunoștință cum lucrează serverul web în capitolul **Cum lucrează Internet**.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ro-RO/django_templates/README.md b/ro-RO/django_templates/README.md
new file mode 100644
index 00000000000..47d036857fa
--- /dev/null
+++ b/ro-RO/django_templates/README.md
@@ -0,0 +1,108 @@
+# Template-urile în Django
+
+Este timp să afișăm ceva date! Django are un instrument incorporat pentru acesta **template tags**.
+
+## Ce reprezintă tăgurile din template?
+
+În HTML nu puteți să srieți codul Python, pentru că browser-ul nu poate să-l interpreteze. Ei știu numai HTML. Noi știm că HTML este destul de static, dar Python este mai dinamic.
+
+**Tăgurile din Django template** ne dă posibilitate de a utiliza Python în HTML, deci puteți să construiți site-urile dinamice mai rapid. E bun!
+
+## Afișarea articolului în template
+
+În capitolul precedent am transmis o listă de articole în template, utilizând variabilă `posts`. Acum trebuie să le afișăm în HTML.
+
+Pentru a afișa o variabilă în Django template, utilizăm we use paranteze paralele duble cu denumirea variabilei în ei, în mod următor:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Încercați acesta în template `blog/templates/blog/post_list.html`. Deschideți-l în editorul de cod, și schimbați tot cod începând cu al doilea `<div>` până la al treilea `</div>` cu `{{ posts }}`. Salvați fișierul și faceți un refresh a paginii pentru a vedea rezultate:
+
+![Figura 13.1](images/step1.png)
+
+Am primit următoare:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Acesta înseamnă că Django știe că acesta este o listă de obiecte. Ținteți minte cum noi putem afișa liste de la capitol **Introducere în Python**? Da, utilizând cicluri! În Django template facem acesta în mod următor:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Încercați acesta în template-ul vostru.
+
+![Figura 13.2](images/step2.png)
+
+Lucrează! Dar noi dorim ca articolele să fie afișate în mod similar cu acela cum noi am afișat articolele create mai înainte în capitolul **Introducere în HTML**. Puteți să combinați HTML și tăgurile de template. `body` va arăta în mod următor:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Totul ce puneți între `{% for %}` și `{% endfor %}` va fi repetat pentru fiecare obiect în lista. Faceți refresh a paginii:{% endraw %}
+
+![Figura 13.3](images/step3.png)
+
+Ați observat că am utilizat o notație diferită (`{{ post.title }}` sau `{{ post.text }}`)? Accesăm data din câmpurile definite în modelul `Post`. `|linebreaksbr` este un pipe (filtru) care aplică un filtru asupra text pentru a converta linii de întrerupere în paragrafe.
+
+## Încă ceva
+
+Ar fi bun să vedem dacă website-ul va lucra în Internet? Hai să-l afișăm pe PythonAnywhere. Acesta este un rezumat al pașilor…
+
+* Dintâi faceți un push pe GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Deschideți [pagină de linii de comandă pe PythonAnywhere](https://www.pythonanywhere.com/consoles/) și deschideți **linie de comandă** (sau deschideți nouă). Apoi, executați:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Trebuie să substituiți `<your-pythonanywhere-domain>` cu denumirea sub-domeniului pe PythonAnywhere, fără paranteze unghiulare.)
+
+* În sfârșit, deschideți [pagina "Web"](https://www.pythonanywhere.com/web_app_setup/) și apăsați **Reload** în aplicație web. (Pentru a accesa alte pagine pe PythonAnywhere din consola, utilizați butonul de meniu în colțul de sus-dreapta.) Schimbările trebuie să fie live pe https://subdomain.pythonanywhere.com -- verificați în browser! Dacă articolele de pe site-ul pe PythonAnywhere nu sunt aceeași ca și cele de pe site-ul local, acesta este OK. Baza de date pe calculatorul local și Python Anywhere nu sincronizează împreună cu alte fișiere.
+
+Felicitări! Acum mergem mai departe și încercăm să adăugăm articolul nou din panel de administrare Django (țineți minte că trebuie de adăugat published_date (data de publicare)!) Fiți siguri că sunteți în panel de administrare Django al site-ului vostru pe pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Faceți un refresh a paginii pentru a verifica dacă articol a fost afișat.
+
+Lucrează? Suntem mândri! Acum puteți să odihniți :)
+
+![Figura 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ro-RO/django_urls/README.md b/ro-RO/django_urls/README.md
new file mode 100644
index 00000000000..293cf01a932
--- /dev/null
+++ b/ro-RO/django_urls/README.md
@@ -0,0 +1,103 @@
+# URL-urile în Django
+
+Acuma putem să facem prima pagină: pagină principală pentru blogul vostru! Dar dintâi, hai să învățăm ceva despre Django URL-urile.
+
+## Ce este URL?
+
+URL este o adresa web. Vedeți URL fiecare dată când voi vizitați website - el este afișat în bara de adrese a browser-ului. (Da! `127.0.0.1:8000` este URL! Și `https://djangogirls.org` tot este URL.)
+
+![URL](images/url.png)
+
+Fiecare pagina din Internet are nevoie de URL. În așa mod, aplicație știe ce ea trebuie să afișeze utilizatorului care deschide acest URL. În Django, noi utilizăm un instrument denumit `URLconf` (configurație URL). URLconf este un set de modeluri pe care Django va încerca să compare cu URL solicitat pentru a găsi un view corect.
+
+## Cum URL-urile lucrează în Django?
+
+Hai să deschidem fișierul `mysite/urls.py` în editorul de cod și să vedem cum el arată:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+După cum vedeți, Django deja a generat careva cod.
+
+Liniile între paranteze triple (`'''` sau `"""`) sunt numite docstrings (șir de documentație) – puteți să-l scrieți la începutul fișierului, clasei sau metodei pentru a descrie ce el face. Ele nu vor fi interpretate de Python.
+
+URL panelului de administrare, pe care l-ați vizitat în capitolul precedent, este deja acolo:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Acesta înseamnă că pentru fiecare URL care începe cu `admin/`, Django va găsi un *view* corespunzător. În cazul acesta, noi includem mai multe URL-urile din panel de administrare ca ele să nu fie într-un singur fișier - așa codul se citește mai ușor și este mai curat.
+
+## Primul tău Django URL!
+
+Este timp să creăm primul URL! Noi dorim ca 'http://127.0.0.1:8000/' să fie pagina principală a blogului nostru și să afișează o listă de articole.
+
+Noi mai dorim să păstrăm fișierul `mysite/urls.py` curat, de aceea o să facem import URL-urilor din aplicație `blog` în fișierul principal `mysite/urls.py`.
+
+Mergeți mai departe și adăugați o linie care va importa `blog.urls`. Înca trebuie să schimbăm linia `from django.urls…` pentru că noi utilizăm funcția `include`, de aceea trebuie să adăugăm aceasta linie de import.
+
+Fișierul `mysite/urls.py` trebuie să arăte în mod următor:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django va redireționa totul de 'http://127.0.0.1:8000/' la `blog.urls` și caută instrucțiunele următoare acolo.
+
+## blog.urls
+
+Faceți un fișier nou `urls.py` în directoriu `blog` și deschideți-l în editorul de cod. Adăugați liniile următoare:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Aici noi facem un import a funției din Django `path` și a tuturor `views` din aplicație `blog`. (Până când nu le avem, dar o să le creăm!)
+
+După acesta putem să adăugăm primul model de URL:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+După cum vedeți, noi atribuim `view` numit `post_list` la URL principal. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. Aest model va spune lui Django că `views.post_list` este un loc corect de a începe când cineva va introduce adresa site-ului vostru 'http://127.0.0.1:8000/'.
+
+Ultima parte, `name='post_list'`, este denumirea URL-ului care va fi utilizat pentru identificarea view-ului. Acesta poate fi la fel ca denumirea view-ului dar poate fi ceva complet diferit. O să utilizăm URL cu denumire mai târziu în proiect, de aceea este important să denumim fiecare URL în aplicație. Noi trebuie să păstrăm denumirile URL-urilor unice și ușor de a le aminti.
+
+Dacă vizitați http://127.0.0.1:8000/ o să vedeți un mesaj că 'pagină web nu este disponibilă'. Acesta este din cauza că server (țineți minte să executați comandă `runserver`?) nu lucrează. Verificați linie de comandă a server-ului vostru și găsiți cauza.
+
+![Eroare](images/error1.png)
+
+Consola arată o eroare, dar nu faceți grijă – ea este utilă: ea vă spune că **atributul 'post_list'** nu există. Acesta este denumirea *view* pe care Django încearcă să găsească și s-o utilizeze, dar noi n-am creat-o până când. Acum `/admin/` tot nu va lucra. Nu vă faceți grijă - o s-o corectăm. Dacă vedeți o altă eroare, restartați serverul. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ro-RO/django_views/README.md b/ro-RO/django_views/README.md
new file mode 100644
index 00000000000..ad4601785a1
--- /dev/null
+++ b/ro-RO/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views - este timpul să le creăm!
+
+Este timp să corectăm eroare pe care am creat-o în ultim capitol :)
+
+*view* este loc unde noi punem toata logica aplicației. El va solicita informație de la `model` pe care l-am creat mai înainte și va transmite `template`-ului. O să creăm template în capitolul următor. View-urile sunt doar funțiile Python care sunt puțin mai complicate decât cele pe care le-am scris în capitolul **Introducere în Python**.
+
+View-urile sunt plasate în fișierul `views.py`. O să adăugăm *views* în fișier `blog/views.py`.
+
+## blog/views.py
+
+OK, hai să deschidem fișierul dat în editorul de cod și să vedem ce este în el:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Nu prea multe lucruri aici.
+
+Țineți minte că liniile care încep cu `#` sunt comentarii – acesta înseamnă ca ele nu vor fi interpretate de Python.
+
+Hai să creăm *view* cum ne propune comentariu. Adăugați un view mic:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Am creat o funcție (`def`) numită `post_list` care are `request` ca parametry și va returna `return` o valoare care ea primește de la executarea funcției `render` care va face template-ul nostru `blog/post_list.html`.
+
+Salvați fișierul, mergeți la http://127.0.0.1:8000/ și vedeți ce s-a primit.
+
+O altă eroare! Citiți ce s-a întâmplat acum:
+
+![Eroare](images/error.png)
+
+Acesta arată că server lucrează, dar nici acum nu arăte corect? Nu faceți grijă, acesta este doar o pagină de eroare! Ca și erorile în consola, ei sunt destul de utile. Puteți să vedeți că *TemplateDoesNotExist* (Template nu există). Hai s-o corectăm eroare această și să creăm template în capitol următor!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ro-RO/dynamic_data_in_templates/README.md b/ro-RO/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..1528a354903
--- /dev/null
+++ b/ro-RO/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Date dinamice în template-uri
+
+Avem câteva lucruri: model `Post` care este definit în `models.py`, `post_list` în `views.py` și template. Dar cum să facem ca posturile noastre să apare în template-ul HTML? Pentru că ceea ce noi dorim este de a arăta careva content (modele salvate în baza de date) în template-ul, corect?
+
+Acesta este ceea ce *views* trebuie să facă: conecta modele și template-uri. În *view* `post_list` trebuie să obținem pe toate modele, pe care vream să le afișăm și să le transmitem la template. În *view* noi decidem care modele va fi afișate în template.
+
+OK, dar cum obținem asta?
+
+Trebuie să deschidem `blog/views.py` în editorul de cod. Până când `post_list` *view* este următor:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Țineți minte am vorbit despre încorporarea codului care este scris în fișiere diferite? Acum este momentul când trebuie să includem modelul pe care l-am scris în `models.py`. O să adăugăm linie `from .models import Post` în mod următor:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+Punct înainte de `models` înseamnă *directoriu curent* sau *aplicație curentă*. `views.py` și `models.py` sunt în același directoriu. Acesta înseamnă că putem utiliza `.` și denumirea fișierului (fără `.py`). Apoi facem import de denumirea modelului (`Post`).
+
+Dar ce urmează? Pentru a obține posturile de blog din modelul `Post` noi avem nevoie de `QuerySet`.
+
+## QuerySet
+
+Trebuie să știți cum QuerySets lucrează. Acest subiect s-a discutat în [capitolul Django ORM (QuerySets)](../django_orm/README.md).
+
+Acum dorim să obținem posturile de blog sortate după `published_date`, corect? Deja am făcut acesta în capitolul QuerySets!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Hai să deschidem fișierul `blog/views.py` în editorul de cod, și să adăugăm codul următor în funcție `def post_list(request)` -- dar nu uitați să adăugați `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Trebuie să atrageți atenția că creați o *variabilă* pentru QuerySet: `posts`. Acesta va fi denumirea QuerySet-ului. De acum puteți să-l referiți după dunumire.
+
+În funcția `render` avem un parametru `request` (tot ce primim de la utilizatorul din Internet) și al doilea parametru cu denumirea template-ului (`'blog/post_list.html'`). În ultimul parametru, `{}`, putem adăuga niște variabile care vor fi utilizate în template. Trebuie să le denumim (o să utilizăm `'posts'` până când). :) Trebuie să aibă următoare structură: `{'posts': posts}`. Atrageți atenția că o parte înainte `:` este un șir; trebuie să-l utilizați cu ghilimele: `''`.
+
+În sfârșit fișierul `blog/views.py` trebuie să conțină cod următor:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+Asta e! Este timpul să afișăm datele din QuerySet în template!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ro-RO/extend_your_application/README.md b/ro-RO/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/ro-RO/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ro-RO/how_the_internet_works/README.md b/ro-RO/how_the_internet_works/README.md
new file mode 100644
index 00000000000..c7c8dfb9d61
--- /dev/null
+++ b/ro-RO/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Cum funcționează Internetul
+
+> Pentru cititorii de acasă: acest capitol este acoperit în video [Cum funcționează Internetul](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> Acest capitol este inspirat de o discuție "Cum funcționează Internetul" de Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+Suntem siguri că utilizați Internetul în fiecare zi. Dar știți ce anume se întâmplă când voi întroduceți o adresă, de exemplu, https://djangogirls.org, în browser și apăsați pe `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Browserele de web sunt făcute să înțeleagă acest cod, să-i urmeze instrucțiunile și să prezinte toate aceste fișiere din care e format website-ul tău exact așa cum vrei tu să fie prezentate.
+
+Ca orice fișier, și cele care conțin HTML trebuie stocate undeva, pe un hard disk. În cazul internetului, folosim computere speciale foarte puternice numite *servere*. Ele nu au monitor, mouse sau tastatură pentru că principalul lor scop e să stocheze și să livreze date. De aceea se și numesc *servere* -- pentru că ne *servesc* date.
+
+OK, dar probabil vrei să știi cum arată Internetul, așa-i?
+
+Ți-am desenat o schemă! Arată așa:
+
+![Figura 1.1](images/internet_1.png)
+
+Cam haos, nu? De fapt, este o rețea de computere conectate (*serverele* mai sus menționate). Sute de mii de computere! Mulți, mulți kilometri de cabluri în toată lumea! Poți vizita un site cu Harta Cablurilor Submarine (http://submarinecablemap.com/) să vezi cât de alambicată e rețeaua. Uite un screenshot de pe site:
+
+![Figura 1.2](images/internet_3.png)
+
+E fascinant, nu-i așa? Dar, evident, nu e posibil să existe un cablu care să unească toate calculatoarele conectate la Internet. Așa că, pentru a ajunge la un calculator (de exemplu la cel pe care e salvat https://djangogirls.org) trebuie să transmitem o cerere prin multe, multe alte computere.
+
+Arată așa:
+
+![Figura 1.3](images/internet_2.png)
+
+Imaginează-ți că atunci când tastezi https://djangogirls.org, trimiți o scrisoare care zice: "Dragă Django Girls, vreau să văd site-ul djangogirls.org. Vă rog să mi-l trimiteți!”
+
+Scrisoarea ta ajunge la oficiul poștal cel mai apropiat. Apoi ajunge la altul, care e puțin mai aproape de destinatar, apoi la altul, și la altul până ce e livrat la destinație. Singur unic lucru este că dacă transmiteți multe litere (*pachete de date*) în aceeași loc, ei poate să meargă prin oficille poștale total diferite (*routere*). Acesta depinde de cum ei sunt distribuite în fiecare oficiu.
+
+![Figura 1.4](images/internet_4.png)
+
+Da, e atât de simplu. Trimiți mesaje și aștepți răspunsuri. Desigur, în loc de hârtie și pix folosești biți de date, dar ideea e aceeași!
+
+În loc de adrese cu numele străzii, oraș, cod și numele țării, folosim adrese IP. Computerul tău cere de la DNS (Domain Name System) să traducă djangogirls.org într-o adresă IP. Seamănă puțin cu vechile cărți de telefoane în care ați putut să căutați numele persoanei pe care ați dorit s-o contactați și îi găsiți numărul de telefon și adresa.
+
+Când trimiteți o scrisoare, trebuie să aibă anumite elemente ca să fie expediată corect: adresă, timbru etc. De asemeni, folosești un limbaj pe care destinatarul îl înțelege, nu? Aceeași aplică și pentru *pachete de date* pe care transmiteți ca să vedeți pe website. Este utilizat protocolul numit HTTP (Hypertext Transfer Protocol).
+
+Deci, practic, atunci când aveți un site, trebuie să aveți un *server* (calculator) unde să-l țineți. Când *server* primește o cerere *request* (în scriisoare), el transmite înapoi website-ul (în altă scriisoare).
+
+Pentru că acesta e un tutorial Django, poate vă întrebați ce face Django. Când trimiți un răspuns, nu vrei întotdeauna să trimiți același lucru tuturor. E mult mai bine dacă scrisorile tale sunt personalizate special pentru persoana care tocmai ți-a scris, nu? Django te ajută să creezi aceste scrisori personalizate și interesante. :)
+
+Gata cu vorba, e timpul să creăm!
\ No newline at end of file
diff --git a/ro-RO/html/README.md b/ro-RO/html/README.md
new file mode 100644
index 00000000000..7ccf890d117
--- /dev/null
+++ b/ro-RO/html/README.md
@@ -0,0 +1,227 @@
+# Introducere în HTML
+
+Poate vă intrebați ce este un template?
+
+Template este un fișier pe care îl putem să reutilizăm pentru a prezenta informație într-un format consistent - de exemplu, ați putea să utilizați pe template pentru a scrie o scriisoare, dar fiecare scriisoare poate să conțină un mesaj diferit și poate să fie adresat persoanelor diferite, dar ei sunt de aceeași format.
+
+Format unui template din Django este descris în limbajul denumit HTML (pe care noi l-am menționat în primul capitol **Cum lucrează Internetul**).
+
+## Ce este HTML?
+
+HTML este un cod care este interpretat de web browser – Chrome, Firefox sau Safari – pentru a afișa pagina web utilizatorului.
+
+HTML înseamnă "HyperText Markup Language". **HyperText** înseamnă că acesta este un tip de text care suportă hyper-linkuri între pagini. **Markup** înseamnă că am marcat pe document cu codul pentru a executa (în cazul nostru browser) codul din pagina. Codul HTML este constuit din **tăguri**, care se încep cu `<` și se termin cu `>`. Aceste tăguri reprezintă **elemente** de markup.
+
+## Primul template!
+
+Crearea unui template înseamnă crearea unui fișier de template. Totul este compus din fișiere, corect? Probabil, deja ați observat acesta.
+
+Templături sunt salvate în directoriu `blog/templates/blog`. Dintâi creați un directoriu numit `templates` în directoriu de blog. Apoi creați un alt directoriu numit `blog` în directoriu templates:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(Poate vă întrebați de ce este nevoie de doi directorii denumite `blog` – acesta este o convenție de denumire care face lucruri mai ușoare când structura devine complicată.)
+
+Acum creați fișier `post_list.html` (păstrați-l fără informație până când) în directoriu `blog/templates/blog`.
+
+Puteți să vedeți site-ul acum: http://127.0.0.1:8000/
+
+> Dacă vedeți o eroare `TemplateDoesNotExist`, restartați serverul. În linie de comandă opriți serverul, apăsând pe Ctrl+C (Control și C keys împreună) și porniți-l executând comandă `python manage.py runserver`.
+
+![Figura 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Deschideți fișier în editor de cod și adăugați marcajul următor:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+Cum arată website-ul acum? Vizitați-l pe http://127.0.0.1:8000/
+
+![Figura 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head și body
+
+Fiecare pagina HTML este divizată în două elemente: **head** și **body**.
+
+* **head** este un element care conține informație despre document și nu este afișat pe ecran.
+
+* **body** este un element care conține totul ce este afișat pe o pagină web.
+
+Noi utilizăm `<head>` pentru ca browser să știe despre configurație paginii, și `<body>` pentru a arăta ce este pe o pagină.
+
+De exemplu, putem pune elementul pentru a afișa titlu paginii web în `<head>`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Salvează fișierele și actualizează site-ul.
+
+![Figura 11.3](images/step4.png)
+
+Vedeți cum browser a înțeles că "Ola's blog" este titlu paginii voastre? El s-a înterpretat `<title>Ola's blog</title>` și a pus textul în bara de titlu a browser-ului vostru (el va fi utilizat pentru bookmark ș.a.).
+
+Probabil voi ați observat că fiecare tăg de început are *un tăg de sfârșit*, cu `/`, și că elemente sunt *inserate unul în altul* (voi nu puteți închide un tăg anumit până când cele care sunt în el, nu sunt închise).
+
+Acesta seamănă cu aranjarea lucrurilor într-o cutie. Aveți o mare cutie, `<html></html>`; în care este `<body></body>`, care conține cutii mai mici: `<p></p>`.
+
+Trebuie să urmați reguli de tăgurilor de *închidere*, și elementelor *incluse unul în altul* – dacă nu veți face acesta, browser-ul n-o să poată interpreta codul corect și pagina va fi afișată greșit.
+
+## Personalizați template-ul vostru
+
+Acum puteți să distrați și să încercați să personalizați template-ul vostru! Acesta sunt câteva tăguri care va fi de folos:
+
+* `<h1>Titlu</h1>` pentru cel mai important titlu
+* `<h2>Sub-titlu</h2>` pentru un titlu de nivel următor
+* `<h3>Sub-sub-titlu</h3>` ... așa mai departe, până `<h6>`
+* `<p>Un paragraf de text</p>`
+* `<em>text</em>` accentuează textul vostru
+* `<strong>text</strong>` face textul vostru să fie evidențiat
+* `<br>`merge la linie următoare (nu puteți pune nimic în br și el n-are tăgul de închidere)
+* `<a href="https://djangogirls.org">link</a>` creează un
+* `<ul><li>primul punct</li><li>al doilea punct</li></ul>` face un list, ca acesta!
+* `<div></div>` definește o secție a paginii
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Acesta este un exemplu a template-ului, copiați-l și plasați-l în `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Acesta dă efectul următor:
+
+![Figura 11.4](images/step6.png)
+
+Uau! Dar până când template-ul nostru afișează **informație statică** – dar înainte noi am vorbit despre un template care va afișa **diferită** informație **în aceeași format**.
+
+Ceea ce noi dorim obținem mai departe este de a afișa posturi reale adăugate din panelă de administrare Django – o să facem acesta.
+
+## Un alt lucru: lansați site-ul!
+
+Va fi bine de văzut site-ul pe Internet, corect? Hai să facem un alt PythonAnywhere deploy:
+
+### Faceți un commit, push codului vostru pe GitHub
+
+Cel dintâi, hai să vedem ce fișiere s-au schimbat în comparație cu ultimul deploy (executați comenzile aceste pe calculatorul vostru, nu pe PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Asigurați-vă că sunteți în directoriu `djangogirls` și hai să spunem ca `git` să include pe toate fișiere schimbate în acest directoriu:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Înainte de a încărca pe toate fișiere, hai să verificăm ce `git` va încărca (toate fișiere pe care `git` va încărca vor fi de culoare verde):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Aproape terminăm, acum este timp să-i spunem să salvăm schimbare această în istorie. O să facem un mesaj de commit unde o să descriem ce s-a schimbat. Puteți să tapați orice, dar este folositor să tapați ceva explicativ ca să țineți minte în viitor ce ați făcut.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Când sunteți gată, încărcați (push) schimbările pe GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Faceți pull codului nou pe PythonAnywhere, și restartați aplicație web
+
+* Deschideți [pagină de linii de comandă pe PythonAnywhere](https://www.pythonanywhere.com/consoles/) și deschideți **linie de comandă** (sau deschideți nouă). Apoi, executați:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+Trebuie să substituiți `<your-pythonanywhere-domain>` cu denumirea sub-domeniului pe PythonAnywhere, fără paranteze unghiulare. Denumirea sub-domeniului este numele de utilizator vostru pe PythonAnywhere, dar în niște cazuri poate fi diferit (dacă numele de utilizator conține majuscule). Dacă codul dat nu lucrează, utilizați comandă `ls` (afișarea fișierilor) pentru a găsi denumirea sub-domeniului/directoriului, și apoi `cd` în el.
+
+Acum observați cum codul se descarcă. Dacă doriți să verificați dacă fișierele au fost descarcate, puteți să deschideți **pagină "Files"** și vedeți codul vostru pe PythonAnywhere (pagina cu fișiere puteți să găsiți din meniu pe pagina cu linie de comandă).
+
+* În sfârșit, deschideți [pagina "Web"](https://www.pythonanywhere.com/web_app_setup/) și apăsați **Reload** în aplicație web.
+
+Acum trebuie să vedeți schimbările voastre live! Reîncărcați website-ul vostru în browser. Trebuie să vedeți schimbările. :)
\ No newline at end of file
diff --git a/ro-RO/installation/README.md b/ro-RO/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/ro-RO/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ro-RO/intro_to_command_line/README.md b/ro-RO/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b092d6d23ff
--- /dev/null
+++ b/ro-RO/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Sumar
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ro-RO/intro_to_command_line/open_instructions.md b/ro-RO/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/ro-RO/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ro-RO/python_installation/README.md b/ro-RO/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/ro-RO/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ro-RO/python_installation/instructions.md b/ro-RO/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/ro-RO/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ro-RO/python_introduction/README.md b/ro-RO/python_introduction/README.md
new file mode 100644
index 00000000000..72910d0b00a
--- /dev/null
+++ b/ro-RO/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Sumar
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Sumar
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Sumar
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Sumar
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ro-RO/template_extending/README.md b/ro-RO/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/ro-RO/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ro-RO/whats_next/README.md b/ro-RO/whats_next/README.md
new file mode 100644
index 00000000000..9a3e7d525fb
--- /dev/null
+++ b/ro-RO/whats_next/README.md
@@ -0,0 +1,43 @@
+# Ce urmează?
+
+Felicitări! **Ești absolut grozavă**. Suntem mândri! <3
+
+### Ce poți face acum?
+
+Ia o pauză și realazează-te! Tocmai ai realizat ceva important.
+
+După aceea, urmărește Django Girls pe [Facebook](http://facebook.com/djangogirls) sau [Twitter](https://twitter.com/djangogirls) pentru a rămâne la curent.
+
+### Poți să recomanzi niște resurse suplimentare?
+
+Da! Există *o mulțime de resurse* online pentru a învăța tot felul de abilități de programare - poate fi destul de greu să îți dai seama unde să mergi mai departe, dar te ajutăm noi. Indiferent de interesele tale înainte să ajungi la Django Girls și de alte interese trezite pe parcursul tutorialului, aici sunt niște resurse gratuite (sau în mare parte gratuite) pe care le poți folosi pentru a ajunge unde vrei să fii.
+
+#### Django
+
+- Cealaltă carte a noastră, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Tutorialul oficial Django](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Lecții video despre noțiuni de bază în Django](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – unele lecții video pot fi auditate gratuit și poti primi un certificat Coursera dacă participi la aceste cursuri
+
+#### HTML, CSS și JavaScript
+
+- [Cursul de web development oferit de Codecademy](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Cursul Python oferit de Codecademy](https://www.codecademy.com/learn/learn-python)
+- [Cursul Python oferit de Google](https://developers.google.com/edu/python/)
+- Cartea [Learn Python The Hard Way](http://learnpythonthehardway.org/book/) - exercițiile inițiale sunt gratuite
+- [Tutoriale New Coder](http://newcoder.io/tutorials/) – asta include o varietate de exemple practice despre cum poti utiliza Python
+- [edX](https://www.edx.org/course?search_query=python) – poți audita cele mai multe cursuri gratuit, dar dacă vrei un certificat sau credite pentru o calificare în învăţământul superior, atunci acesta va costa bani
+- [Coursera Python specialization](https://www.coursera.org/specializations/python) - unele lecții video pot fi auditate gratuit și poți primi un certificat de Coursera dacă participi la aceste cursuri
+- [Pythonfor Everybody](https://www.py4e.com/) - o versiune gratuită și deschisă a cursului Coursera Python for Everybody specialization
+
+#### Lucrul cu date
+
+- [Cursul de data science oferit de Codecademy](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – poți audita cele mai multe cursuri gratuit, dar dacă vrei un certificat sau credite pentru o calificare în învăţământul superior, atunci acesta va costa bani
+- [Dataquest](https://www.dataquest.io/) - primele 30 de "misiuni" sunt gratuite
+
+Abia așteptăm să vedem ce construiești în continuare!
\ No newline at end of file
diff --git a/ro/GLOSSARY.md b/ro/GLOSSARY.md
new file mode 100644
index 00000000000..582c8d1710c
--- /dev/null
+++ b/ro/GLOSSARY.md
@@ -0,0 +1,3 @@
+# editor de cod
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/ro/README.md b/ro/README.md
new file mode 100644
index 00000000000..f1309c32175
--- /dev/null
+++ b/ro/README.md
@@ -0,0 +1,51 @@
+# Tutorial Django Girls
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figura 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ro/SUMMARY.md b/ro/SUMMARY.md
new file mode 100644
index 00000000000..f02ce2218c0
--- /dev/null
+++ b/ro/SUMMARY.md
@@ -0,0 +1,27 @@
+# Cuprins
+
+* [Introducere](README.md)
+* [Instalare](installation/README.md)
+* [Instalare (Chromebook)](chromebook_setup/README.md)
+* [Cum funcționează Internetul](how_the_internet_works/README.md)
+* [Introducere în linia de comandă](intro_to_command_line/README.md)
+* [Instalare Python](python_installation/README.md)
+* [Editor de cod](code_editor/README.md)
+* [Introducere în Python](python_introduction/README.md)
+* [Ce este Django?](django/README.md)
+* [Instalarea Django](django_installation/README.md)
+* [Primul tău proiect Django!](django_start_project/README.md)
+* [Modele în Django](django_models/README.md)
+* [Consola de admin din Django](django_admin/README.md)
+* [Implementează!](deploy/README.md)
+* [Url-urile în Django](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introducere în HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Date dinamice în template-uri](dynamic_data_in_templates/README.md)
+* [Template-urile în Django](django_templates/README.md)
+* [CSS - fă-o frumoasă](css/README.md)
+* [Extinderea template-urilor](template_extending/README.md)
+* [Extinde aplicația ta](extend_your_application/README.md)
+* [Formele în Django](django_forms/README.md)
+* [Ce urmează?](whats_next/README.md)
\ No newline at end of file
diff --git a/ro/chromebook_setup/README.md b/ro/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/ro/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ro/chromebook_setup/instructions.md b/ro/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/ro/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ro/code_editor/README.md b/ro/code_editor/README.md
new file mode 100644
index 00000000000..cf5a83ef5ff
--- /dev/null
+++ b/ro/code_editor/README.md
@@ -0,0 +1,11 @@
+# Editor de cod
+
+> Pentru cititorii de acasă: acest capitol este acoperit în  Instalarea Python & amp; Editor de cod </ 0>.</p> </blockquote> 
+> 
+> Ești pe cale să scrii prima linie de cod, așa că e timpul să descarci un editor de cod!
+> 
+> > **Notă** Dacă utilizați un Chromebook, treceți peste acest capitol și asigurați-vă că urmați [setare Chromebook](../chromebook_setup/README.md).
+> > 
+> > **Notă** S-ar putea să fi făcut acest lucru mai devreme în capitolul Instalare - dacă da, atunci poți trece imediat la capitolul următor!
+> 
+> {% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ro/code_editor/instructions.md b/ro/code_editor/instructions.md
new file mode 100644
index 00000000000..140190eaea1
--- /dev/null
+++ b/ro/code_editor/instructions.md
@@ -0,0 +1,31 @@
+Există o mulţime de programe diferite de editare şi, în mare măsură, alegerea se reduce la preferinţa personală. Cei mai mulți programatori Python utilizează MPI-uri (Medii de Programare Integrate) complexe, însă extrem de puternice, precum PyCharm. Pentru un începător, totuși, ele sunt mai puțin adecvate; recomandările noastre sunt la fel de puternice, dar mult mai simple.
+
+Sugestiile noastre sunt mai jos, dar nu ezitați să întrebați trainer-ul dvs. ce preferințe au - va fi mai ușor să obțineți ajutor de la ei.
+
+## Gedit
+
+Gedit este un editor gratuit, open-source, disponibil pentru toate sistemele de operare.
+
+[Descarcă-l de aici](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Descarcă-l de aici](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Descarcă-l de aici](https://atom.io/)
+
+## De ce instalăm un editor de cod?
+
+V-ați putea întreba de ce instalăm acest program special de editat coduri, în loc să folosim ceva precum Word sau Notepad.
+
+În primul rând, codul trebuie să fie **text simplu**, iar problema cu programele ca Word și Textedit este aceea că ele nu produc text simplu, ele produc text bogat (cu fonturi și formatare) folosind formatul ca [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+Al doilea motiv este că editoarele de cod sunt specializate în editarea codului, astfel încât ele pot oferi funcționalități utile ca colorarea codului în funcție de semnificația lui, sau închiderea automată a ghilimelelor în locul tău.
+
+Vom vedea toate acestea în acțiune mai târziu. În curând, vei ajunge să te gândești la vechiul tău editor de cod ca unul dintre instrumentele tale preferate. :)
\ No newline at end of file
diff --git a/ro/css/README.md b/ro/css/README.md
new file mode 100644
index 00000000000..9c0adeead01
--- /dev/null
+++ b/ro/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Blog-ul nostru încă arată destul de urât, corect? E timpul să-l facem frumos! Pentru asta vom folosi CSS.
+
+## Ce este CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Să folosim procesul de Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Instalăm Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figura 14.1](images/bootstrap1.png)
+
+Deja arată mai frumos!
+
+## Fișierele statice în Django
+
+În sfârșit ne vom uita mai atent la lucrurile pe care le numim **fișiere statice**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Unde se pun fișierele statice pentru Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+Facem asta prin crearea unui dosar numit `static` înăuntrul blog-ului:
+
+    djangogirls 
+    ├── blog 
+    │ ├── migrations 
+    │ ├── static 
+    │ └── templates 
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Primul fișier CSS!
+
+Let's create a CSS file now, to add your own style to your web page. Crează un director nou numit `css` în interiorul directorului `static`. Apoi crează un nou fișier numit `blog.css` înăuntrul directorului `css`. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Timpul pentru a scrie niște CSS! Deschide fișierul `blog/static/css/blog.css` în editorul de cod.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+Dar hai să facem cel puțin ceva. Poate am putea schimba culoarea header-ului? Pentru a înțelege culorile, calculatoarele ulilizează niște coduri speciale. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. Poți de asemenea utiliza [culori predefinite](http://www.w3schools.com/colors/colors_names.asp), precum `red` - roșu și `green` - verde.
+
+Adaugă următorul cod în fișierul `blog/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {     
+    color: #FCA205; 
+}
+```
+
+`h1 a` este un Selector CSS. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. În acest caz, noi spunem să își schimbe culoarea în `#FCA205`, care reprezintă oranjul. Desigur poți pune culoarea ta proprie aici!
+
+Într-un fișier CSS determinăm stilurile pentru elementele într-un fișier HTML. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Numele de clase și id le definești singur. Clasele definesc grupuri de elemente, și id-urile indică la niște elemente anumite. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. În acest moment i-am spus șablonului unde se află fișierul nostru CSS.
+
+Fișierul tău trebuie să arate așa:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Bine, salvează fișierul și actualizează pagina!
+
+![Figura 14.2](images/color2.png)
+
+Bună treabă! Poate ai vrea să-i dai site-ului un pic de air și să mărești marginea din partea stângă? Să încercăm!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figura 14.3](images/margin2.png)
+
+Poate putem personaliza font-ul din header? Inserează aceasta în `<head>` din fișierul `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {     
+    color: #FCA205;     
+    font-family: 'Lobster'; 
+}
+```
+
+![Figura 14.3](images/font.png)
+
+Grozav!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Numește câteva părți din codul HTML. Adaugă o clasă numită `page-headers` la `div`-ul care conține headerul:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+Acum adaugă o clasă `post` la `div`-ul care conține un post de blog.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+Acum vom adăuga blocuri de declarare la selectoare diferite. Selectoarele care încep cu `.` se referă la clase. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. Pentru moment, doar copiază-l și inserează-l in fișierul `blog/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Apoi selectează codul HTML care afișează posturile cu declarațiile de clase. Înlocuiește asta:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+în `blog/templates/blog/post_list.html` cu asta:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Salvează fișierele și actualizează site-ul.
+
+![Figura 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Gata pentru capitolul următor?! :)
\ No newline at end of file
diff --git a/ro/deploy/README.md b/ro/deploy/README.md
new file mode 100644
index 00000000000..bd65669892c
--- /dev/null
+++ b/ro/deploy/README.md
@@ -0,0 +1,257 @@
+# Implementează!
+
+> **Notă**: Următorul capitol poate fi, uneori, un pic cam greu de înțeles. Persistă şi du-l până la capăt; deployment-ul este o parte importantă a procesului de dezvoltare a site-ului. Acest capitol este plasat la mijlocul tutorialului, astfel încât mentorul să te poată ajuta în procesul un pic mai complicat de a-ți duce website-ul online. Aceasta înseamnă că puteţi termina tutorialul pe cont propriu, dacă nu vă rămâne timp.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deployment-ul este procesul de publicare a aplicației tale pe Internet, astfel încât aplicația să fie vizibilă pentru toți. :)
+
+Așa cum ați învățat, un website trebuie să fie localizat pe un server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+Celălalt serviciu extern pe care-l vom utiliza este [GitHub](https://www.github.com), un serviciu de găzduire de cod. Există și altele, însă aproape toţi programatorii au un cont de GitHub acum, așa că, acum, vei avea și tu unul!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Inițializarea repository-ului Git propriu
+
+Git depistează modificările unui anumit set de fişiere în ceea ce se numeşte un repository de cod (sau, pe scurt, "repo"). Să începem unul pentru proiectul nostru. Deschideți consola şi executaţi aceste comenzi, în directoriul `djangogirls`:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. Ar trebui să fiți în mapa `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Numele tău"
+    $ git config --global user.email tu@exemplu.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git va urmări modificările făcute în toate fişierele şi mapele în această directorie, dar există unele fişiere pe vrem să le ignore. Facem acest lucru prin crearea unui fişier numit `.gitignore` în directoriul de bază. Deschide editorul de cod şi creați un nou fişier cu următorul conținut:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** Punctul de la începutul numelui de fișier este important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+Este o idee bună să folosiți comanda `git status` înaintea celei de `git add` sau ori de câte ori nu ești sigură legat de ceea ce s-a schimbat. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    Primul commit:
+    
+    Fișiere încă neurmărite:
+      (folosiți "git add <nume-fișier>..." pentru a-l include în commit)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Și în cele din urmă salvăm modificările. Intră în consolă și rulează aceste comenzi:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Du-te și verifică-l!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/ro/deploy/install_git.md b/ro/deploy/install_git.md
new file mode 100644
index 00000000000..a6a72250c30
--- /dev/null
+++ b/ro/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git este un "sistem de versionare" folosit de mulți programatori. Acest software poate să urmărească schimbările făcute în fișiere de-a lungul timpului, pentru a putea reveni la anumite versiuni mai târziu. Seamănă cu funcția de "urmărire modificări" din Microsoft Word, dar este mult mai puternic.
+
+## Instalarea Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Puteţi descărca Git aici [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). În afară de aceasta, valorile implicite sunt bune. Verificarea în stil Windows și sfârşiturile de linie de cod pentru commit-uri în stil Unix sunt bune.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Descărcați Git aici [git-scm.com](https://git-scm.com/) şi urmaţi instrucţiunile.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ro/deploy/signup_pythonanywhere.md b/ro/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/ro/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ro/django/README.md b/ro/django/README.md
new file mode 100644
index 00000000000..7281569f5ad
--- /dev/null
+++ b/ro/django/README.md
@@ -0,0 +1,27 @@
+# Ce este Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. Un framework este un set de componente ce facilitează implementarea unui site web foarte rapid și ușor.
+
+Când faci un site web, întotdeauna vei avea nevoie de un grup de componente comune site-urilor web: un sistem de autentificare (înregistrare user, logare user, delogare), panou de administrare a site-ului, formulare, încărcare (upload) fișiere, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## De ce ai nevoie de un framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imaginează-ți o cutie poștală (port) căreia îi sunt monitorizate scrisorile primite (cereri). Acest lucru este făcut de un server web. The web server reads the letter and then sends a response with a webpage. Dar când dorești să transmiți ceva, trebuie să ai careva conținut. Și Django este ceva care te ajută să creezi acel conținut.
+
+## Ce se întâmplă când cineva solicită un site web de pe server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imaginează-ți un poștaș cu o scrisoare. Ea trece de-a lungul străzii și compară la fiecare casă numărul cu cel de pe scrisoare. Dacă coincid, ea lasă scrisoarea acolo. Așa lucrează urlresolver-ul!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Poate utilizatorul a solicitat să schimbe ceva în baza de date? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Desigur descrierea de mai sus este un pic simplificată, dar nu ai nevoie să știi toate lucrurile tehnice la moment. Este suficient să-ți faci o idee generală.
+
+Deci, în loc să ne adâncim în detalii, pur și simplu vom începe a crea ceva cu Django și vom învăța toate părțile importante pe parcurs!
\ No newline at end of file
diff --git a/ro/django_admin/README.md b/ro/django_admin/README.md
new file mode 100644
index 00000000000..6152d2f66e4
--- /dev/null
+++ b/ro/django_admin/README.md
@@ -0,0 +1,57 @@
+# Consola de admin din Django
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Așa cum poți observa, importăm (includem) modelul Post definit în capitolul anterior. Pentru a face modelul vizibil în consola de admin, trebuie să înregistrăm modelul cu instrucțiunea `admin.site.register(Post)`.
+
+OK, acum este timpul să ne uităm la modelul Post. Reamintește-ți să rulezi comanda ` python manage.py runserver ` în linia de comandă pentru a rula serverul web. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Pagina de login](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ro/django_forms/README.md b/ro/django_forms/README.md
new file mode 100644
index 00000000000..7e91832a131
--- /dev/null
+++ b/ro/django_forms/README.md
@@ -0,0 +1,447 @@
+# Formulare în Django
+
+La final vrem să adăugăm la proiectul nostru o metodă pentru a crea sau edita postări de blog. Consola de `admin` din Django este ajutătoare, dar este destul de greu să o perosnalizezi și să o faci frumoasă. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+Un lucru util la formularele (forms) Django este că putem defini unul de la zero, sau putem crea un `ModelForm` care va salva ce se găsește în formular în model.
+
+Asta ne și propunem să facem: vom crea un formular pentru modelul nostru `Post`.
+
+La fel ca și celălalte componente importante din Django, formularele au propriul lor fișier: `forms.py`.
+
+Trebuie să creăm un fișier cu acest nume în directorul `blog`.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Trebuie să importăm prima dată formularele Django (`from django import forms`) și, evident, modelul nostru `Post` (`from .models import Post`).
+
+După cum probabil suspectați, `PostForm` este numele formularului nostru. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Apoi, avem `class Meta`, unde îi spunem lui Django care model ar trebui să fie folosit pentru a creea acest formular (`model = Post`).
+
+La final, putem să spunem care câmp(uri) ar trebui să ajungă în formular. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+Și gata! Tot ce trebuie să facem acum e să folosim formularul într-un *view* și să-l afișăm într-un template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link către o pagină cu formularul
+
+Este momentul să deschidem` blog/templates/blog/base.html`. Vom adăuga un link in `div` -ul ` page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/ro/django_installation/README.md b/ro/django_installation/README.md
new file mode 100644
index 00000000000..86ce3f145bb
--- /dev/null
+++ b/ro/django_installation/README.md
@@ -0,0 +1,7 @@
+# Instalarea Django
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ro/django_installation/instructions.md b/ro/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/ro/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ro/django_models/README.md b/ro/django_models/README.md
new file mode 100644
index 00000000000..0d3317cd8d3
--- /dev/null
+++ b/ro/django_models/README.md
@@ -0,0 +1,199 @@
+# Modele în Django
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ro/django_orm/README.md b/ro/django_orm/README.md
new file mode 100644
index 00000000000..b887cb67c96
--- /dev/null
+++ b/ro/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+În acest capitol veţi învăţa cum Django se conectează la baza de date şi stochează informație în ea. Haideti sa începem!
+
+## Ce este un QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ro/django_start_project/README.md b/ro/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/ro/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ro/django_templates/README.md b/ro/django_templates/README.md
new file mode 100644
index 00000000000..b58428a902c
--- /dev/null
+++ b/ro/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figura 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figura 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figura 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figura 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ro/django_urls/README.md b/ro/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/ro/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/ro/django_views/README.md b/ro/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/ro/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/ro/dynamic_data_in_templates/README.md b/ro/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/ro/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/ro/extend_your_application/README.md b/ro/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/ro/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/ro/how_the_internet_works/README.md b/ro/how_the_internet_works/README.md
new file mode 100644
index 00000000000..e4065d6d7bc
--- /dev/null
+++ b/ro/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Cum funcționează Internetul
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+Primul lucru pe care trebuie să-l știi este că un website este o grămadă de fișiere salvate pe un hard disk. Just like your movies, music, or pictures. Totuși, paginile web au ceva special: conțin un cod numit HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+Ca orice fișier, și cele care conțin HTML trebuie stocate undeva, pe un hard disk. În cazul internetului, folosim computere speciale foarte puternice numite *servere*. Ele nu au monitor, mouse sau tastatură pentru că principalul lor scop e să stocheze și să livreze date. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+Ți-am desenat o schemă! Arată așa:
+
+![Figura 1.1](images/internet_1.png)
+
+Cam haos, nu? In fact it is a network of connected machines (the above-mentioned *servers*). Sute de mii de computere! Mulți, mulți kilometri de cabluri în toată lumea! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Uite un screenshot de pe site:
+
+![Figura 1.2](images/internet_3.png)
+
+E fascinant, nu-i așa? Dar, evident, nu e posibil să existe un cablu care să unească toate computerele conectate la Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+Arată așa:
+
+![Figura 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Scrisoarea ta ajunge la oficiul poștal cel mai apropiat. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figura 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+În loc de adrese cu numele străzii, oraș, cod și numele țării, folosim adrese IP. Computerul tău cere de la DNS (Domain Name System) să traducă djangogirls.org într-o adresă IP. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. De asemeni, folosești un limbaj pe care destinatarul îl înțelege, nu? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. Când trimiți un răspuns, nu vrei întotdeauna să trimiți același lucru tuturor. E mult mai bine dacă scrisorile tale sunt personalizate special pentru persoana care tocmai ți-a scris, nu? Django te ajută să creezi aceste scrisori personalizate și interesante. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ro/html/README.md b/ro/html/README.md
new file mode 100644
index 00000000000..2ae31dd0d57
--- /dev/null
+++ b/ro/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figura 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figura 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figura 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figura 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ro/install_git.md b/ro/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ro/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ro/installation/README.md b/ro/installation/README.md
new file mode 100644
index 00000000000..429fc96acb7
--- /dev/null
+++ b/ro/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [Ce este Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ro/instructions.md b/ro/instructions.md
new file mode 100644
index 00000000000..d042926b29a
--- /dev/null
+++ b/ro/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for you instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ro/intro_to_command_line/README.md b/ro/intro_to_command_line/README.md
new file mode 100644
index 00000000000..60f0e0cd7e7
--- /dev/null
+++ b/ro/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Sumar
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ro/python_installation/README.md b/ro/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/ro/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ro/python_installation/instructions.md b/ro/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/ro/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ro/python_introduction/README.md b/ro/python_introduction/README.md
new file mode 100644
index 00000000000..18fd19cba54
--- /dev/null
+++ b/ro/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Sumar
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Sumar
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Sumar
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Sumar
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ro/signup_pythonanywhere.md b/ro/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/ro/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ro/template_extending/README.md b/ro/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/ro/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ro/whats_next/README.md b/ro/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/ro/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/ru-RU/GLOSSARY.md b/ru-RU/GLOSSARY.md
new file mode 100644
index 00000000000..86fce21027d
--- /dev/null
+++ b/ru-RU/GLOSSARY.md
@@ -0,0 +1,3 @@
+# Текстовый редактор
+
+Текстовый редактор - это приложение, которое позволяет тебе сохранить свой код, чтобы вернуться к нему позднее. Информацию о том, где можно таким обзавестись, можно найти в главе [Текстовый редактор](./code_editor/README.md)
\ No newline at end of file
diff --git a/ru-RU/README.md b/ru-RU/README.md
new file mode 100644
index 00000000000..b3d59f65a14
--- /dev/null
+++ b/ru-RU/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. Чтобы ознакомиться с содержанием этой лицензии, посети страницу 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, но мы понимаем, что это не всегда возможно. Поэтому мы рекомендуем тебе попробовать выполнить задания дома. Для тех, кто читает руководство дома, мы подготавливаем видео. Оно облегчит самостоятельное изучение руководства. Скоро у нас будет YouTube канал [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed). А пока мы работаем над ним, прочитай это руководство :)
+
+В каждой главе, для которой видео уже снято, есть соответствующая ссылка.
+
+## Сотрудничество и дополнительная информация
+
+Это руководство поддерживается [DjangoGirls](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), чтобы мы могли добавить его.
\ No newline at end of file
diff --git a/ru-RU/SUMMARY.md b/ru-RU/SUMMARY.md
new file mode 100644
index 00000000000..cc3483e2773
--- /dev/null
+++ b/ru-RU/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-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Установка (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)
+* [URL-адреса Django](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)
\ No newline at end of file
diff --git a/ru-RU/chromebook_setup/README.md b/ru-RU/chromebook_setup/README.md
new file mode 100644
index 00000000000..b1830563155
--- /dev/null
+++ b/ru-RU/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Настройка Chromebook
+
+> **Примечание** Если ты уже прошла раздел [Установка](../installation/README.md), не нужно делать это заново - можешь сразу перейти к[Ведению в Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ru-RU/chromebook_setup/instructions.md b/ru-RU/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..40b9c644c7e
--- /dev/null
+++ b/ru-RU/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Можешь [пропустить этот раздел](http://tutorial.djangogirls.org/en/installation/#install-python), если ты не используешь Chromebook. Если же у тебя Chromebook, процесс установки будет немного иным. Ты можешь игнорировать остальные инструкции по установке.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9)
+
+Cloud IDE - это инструмент, предоставляющий тебе редактор кода и доступ к компьютеру в интернете, на котором ты можешь установить, записать и выполнить программу. На протяжении данного урока Cloud IDE будет использоваться как твой *локальный компьютер*. Ты будешь работать в терминале (так же, как и твои одноклассники на OS X, Ubuntu или Windows), но твой терминал будет подключен к компьютеру где-нибудь в Нидерландах или Германии, который Cloud9 установили специально для тебя. Здесь инструкции для облачных сред IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Ты можешь выбрать одну из облачных IDE. Далее следуй инструкциям.
+
+#### PaizaCloud Cloud IDE
+
+1. Перейди на [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Зарегистрируй аккаунт
+3. Нажми *New Sever* и выбери *Django app*
+4. Нажмите кнопку запуска (в левой части окна)
+
+Теперь ты должна увидеть интерфейс с боковой панелью, кнопки слева. Нажми кнопку запуска, чтобы открыть окно терминала со строкой вроде этой:
+
+{% 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 введи *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. Ты можешь изменить размер этого окна, чтобы увеличить терминал.
+
+#### Glitch.com Cloud IDE
+
+1. Перейдите на сайт [Glitch.com](https://glitch.com/)
+2. Зарегистрируйте учетную запись (https://glitch.com/signup) или используйте свою учетную запись GitHub, если она у вас есть. (См. Инструкции GitHub ниже.)
+3. Нажмите на кнопку new project и выберите команду hello-webpage
+4. Щелкните раскрывающийся список Инструменты (в левой нижней части окна), затем нажмите кнопку Терминал, чтобы открыть вкладку терминала с такой подсказкой:
+
+{% filename %} Терминал{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+При использовании Glitch.com в качестве облачной IDE вам не нужно создавать виртуальную среду. Вместо этого создайте вручную следующие файлы:
+
+{% 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
+```
+
+После создания этих файлов перейдите в Терминал и выполните следующие команды, чтобы создать свой первый проект Django:
+
+{% filename %}Терминал{% endfilename %}
+
+    django-admin.py startproject mysite .
+    Обновить
+    
+
+Чтобы видеть подробные сообщения об ошибках, вы можете активировать журналы отладки Django для своего приложения Glitch. Просто добавьте следующее в конец файла ` mysite / settings.py `.
+
+{% 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,
+        },
+    },
+}
+```
+
+Это создаст файл ` debug.log ` с подробным описанием операций Django и любых сообщений об ошибках, которые могут появиться, что значительно упростит исправление, если ваш веб-сайт не работает.
+
+Первоначальный перезапуск проекта Glitch должен завершиться ошибкой. (Если вы щелкните верхнюю кнопку раскрывающегося списка `Показать`, а затем щелкните `В новом окне`, вы получите сообщение об ошибке `DisallowedHost`.) Не беспокойтесь об этом на данном этапе, это руководство будет исправлено, как только вы обновите настройки Django вашего проекта в файле `mysite/settings.py`.
+
+### Виртуальная среда
+
+Виртуальная среда (также называемая виртуальная программа) похожа на частный ящик, в который мы можем поместить полезный компьютерный код для проекта, над которым мы работаем. Мы используем их, чтобы хранить отдельные фрагменты кода, которые мы хотим для наших различных проектов, чтобы они не путались между проектами.
+
+Запустить:
+
+{% filename %}Cloud 9{% endfilename %} 
+
+    mkdir djangogirls
+    djangogirls
+    python3 -m venv
+    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).
\ No newline at end of file
diff --git a/ru-RU/code_editor/README.md b/ru-RU/code_editor/README.md
new file mode 100644
index 00000000000..7af6ee40195
--- /dev/null
+++ b/ru-RU/code_editor/README.md
@@ -0,0 +1,11 @@
+# Текстовый редактор
+
+> Для тех, кто занимается дома: эта глава описывается в видео [Установка Python и текстового редактора](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+Приступаем к написанию первых строк кода - пора загрузить текстовый редактор!
+
+> **Примечание:** Если вы используете Chromebook, то пропустите эту главу и убедитесь, что вы следуете инструкциям по установке [Chromebook Setup](../chromebook_setup/README.md). Выбранная вами облачное IDE (PaizaCloud Cloud IDE или AWS Cloud9) содержит редактор кода, и когда вы открываете файл в вашем IDE из меню File, вы автоматически используете редактор.
+> 
+> **Примечание** Если ты уже прошла шаги установки, то можешь смело переходить к следующей главе!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ru-RU/code_editor/instructions.md b/ru-RU/code_editor/instructions.md
new file mode 100644
index 00000000000..e0002ff0eb3
--- /dev/null
+++ b/ru-RU/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Существует много различных редакторов и в основном все сводится к личным предпочтениям. Большинство Python программистов используют сложные, но чрезвычайно мощные IDE (англ. Integrated Development Environments - Интегрированные среды разработки), такие как PyCharm. Однако они, вероятно, не очень подходят для начинающих; мы предлагаем столь же мощные, но куда более простые варианты.
+
+Ниже приведен перечень наших предпочтений, но также можешь попросить совета у своего наставника - будет проще получить помощь от него.
+
+## Visual Studio Code
+
+Visual Studio Code — это редактор исходного кода, разработанный Microsoft для Windows, Linux и macOS. Включает в себя отладчик, инструменты для работы с Git, подсветку синтаксиса, систему автодополнения, сниппеты, и средства для рефакторинга.
+
+[Скачать его можно здесь](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit является открытым, бесплатным редактором, доступным для всех операционных систем.
+
+[Скачать его можно здесь](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text - это очень популярный текстовый редактор с бесплатным пробным периодом. Он легко устанавливается и прост в использовании, а также доступен для всех операционных систем.
+
+[Скачать его можно здесь](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom - еще один популярный редактор. Он бесплатный, с открытым исходным кодом и доступен для Windows, OS X и Linux. Atom разработан [GitHub](https://github.com/).
+
+[Скачать его можно здесь](https://atom.io/)
+
+## Зачем нам нужен редактор кода?
+
+Ты можешь спросить — зачем устанавливать отдельную программу для редактирования кода, если можно использовать Word или Notepad?
+
+Во-первых, код должен должен храниться в виде **простого текста**, а проблема таких программ, как Word или Textedit в том, что они не сохраняют файлы в этом виде, а используют "обогащённый" текст (с форматированием и шрифтами), например, [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+Вторая причина в том, что специализированные редакторы предоставляют множество полезных для программирования возможностей, такие как цветную подсветку кода в зависимости от его смысла и автоматически закрывающиеся кавычки.
+
+Позже мы увидим всё это в действии. Скоро ты начнешь думать о своем редакторе кода как о проверенном любимом инструменте :)
\ No newline at end of file
diff --git a/ru-RU/css/README.md b/ru-RU/css/README.md
new file mode 100644
index 00000000000..b8abe5ec794
--- /dev/null
+++ b/ru-RU/css/README.md
@@ -0,0 +1,332 @@
+# CSS - сделай это красивым!
+
+Наш блог все еще выглядит довольно скверно, не так ли? Пора сделать его красивым! Для этого будем использовать CSS.
+
+## Что такое CSS?
+
+Каскадные таблицы стилей (CSS) - это язык, используемый для описания внешнего вида и форматирования веб-сайта, написанного на языке разметки (например, HTML). Рассматривай это как макияж для нашей веб-страницы :)
+
+Но ты же не хочешь начинать все сначала, правда? Повторюсь, мы будем использовать все то, что другие программисты выложили в интернет бесплатно. Не очень-то интересно изобретать велосипед еще раз :)
+
+## Давай использовать Bootstrap!
+
+Bootstrap - один из самых популярных HTML и CSS фреймворков для разработки красивых сайтов: https://getbootstrap.com/
+
+Он был написан программистами из Twitter, а сейчас разрабатывается волонтерами со всего мира!
+
+## Установка Bootstrap
+
+Для установки Bootstrap открой файл содержащий код `.html` в редакторе и добавь эти строки в заголовок `<head>`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous"><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Это не добавит никаких файлов в твой проект. Этот код просто указывает на то, что эти файлы существуют в Интернете. Поэтому открой сайт и обнови страницу, где ты обнаружишь изменения!
+
+![Рисунок 14.1](images/bootstrap1.png)
+
+Выглядит уже лучше!
+
+## Статические файлы в Django
+
+Наконец мы ближе познакомимся с тем, что называли **статическими файлами**. Статические файлы - это файлы CSS и изображения. Их содержимое не зависит от контекста запроса и будет одинаковым для всех пользователей.
+
+### Куда поместить статические файлы в Django
+
+Django уже знает, где искать статические файлы для встроенного приложения"admin". Теперь нам нужно добавить статические файлы в наше собственное приложение, `blog`.
+
+Мы сделаем это, создав папку `static` внутри каталога с нашим приложением:
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Django автоматически найдет все папки с именем "static" внутри папок приложений. Теперь можно использовать их содержимое как статические файлы :)
+
+## Твой первый CSS файл!
+
+Давай создадим CSS файл, чтобы украсить нашу веб-страницу. Создай новую папку под названием `css` внутри твоей папки `static`. Затем создайте новый файл под названием `blog.css` внутри папки `css`. Готова?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Пришло время написать несколько строк CSS! Открой файл `blog/static/css/blog.css` в своем редакторе кода.
+
+Мы не будем слишком углубляться в настройки и изучение CSS здесь. В конце страницы находятся рекомендованные бесплатные CSS курсы, если вы захотите изучить CSS самостоятельно.
+
+Но давай сделаем хотя бы немного. Может мы могли бы поменять цвет наших заголовков? Чтобы понимать цвета, компьютеры используют специальные коды. Эти коды начинаются с `#`, состоят из букв (A-F) и цифр (0-9). Например, код для синего цвета - `#0000FF`. Коды многих цветов можно найти здесь: http://www.colorpicker.com/. Также можешь пользоваться [предопределенными цветами](http://www.w3schools.com/colors/colors_names.asp), такими как `red` и `green`.
+
+В файле `blog/static/css/blog.css` тебе нужно добавить следующий код:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    цвет: #C25100;
+}
+
+```
+
+`h1 a` это CSS селектор. Это означает, что мы применяем наши стили к любым элементам `a`, внутри элемента `h1`; селектор `h2 a` делает то же самое для элементов `h2`. Поэтому, когда у нас есть что-то вроде `<h1><a href="">ссылка</a></h1>`, будет применяться стиль `h1 a`. В этом случае, мы говорим сменить этот цвет на `#C25100`, то есть на темно-оранжевый. Или же вы можете поместить сюда свой собственный цвет, но убедитесь, что у него хороший контраст на белом фоне!
+
+В CSS файле мы определяем стили для элементов HTML файла. Первый способ определить элементы — по имени. Ты должна помнить эти теги из HTML. `a`, `h1`, `head` - все это примеры имен элементов. Мы также назначить элементу `класс` или атрибут `id`. Class и id – это имена, которые ты сама присваиваешь элементам. Классы (сlass) определяют группы элементов, а идентификаторы (id) указывают на конкретные элементы. Например, вы можете идентифицировать следующий элемент, используя имя элемента `a`, класс `external_link` или идентификатор `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Вы можете прочитать больше о CSS селекторах на [w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+Нам также нужно сообщить нашему шаблону HTML что мы добавили CSS стили. Откройте файл `blog/templates/blog/post_list.html` в редакторе кода и добавьте эту строчку в самое начало:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Мы просто загружаем статические файлы :) Между `<head>` и `</head>`, после ссылки на файлы загрузки CSS, добавьте эту строку:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Браузер считывает файлы в том порядке, в котором он их получил, так что мы должны убедиться, что они находятся в нужном месте. В противном случае код в нашем файле может быть переопределен кодом в Bootstrap файлах. Мы только что сказали нашему шаблону, где находится наш CSS файл.
+
+Твой файл должен теперь выглядеть следующим образом:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+ОК, сохрани файл и обнови страницу!
+
+![Рисунок 14.2](images/color2.png)
+
+Отличная работа! Может быть, мы также хотели бы добавить нашему веб-сайту немного пространства и увеличить отступ слева? Давай попробуем!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Добавь это к твоему CSS, сохрани файл и посмотри, как это работает!
+
+![Рисунок 14.3](images/margin2.png)
+
+Возможно, мы можем настроить шрифт нашего заголовка? Вставь это внутрь тега `<head>` в файле `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Как и прежде, проверьте порядок и место перед ссылкой на `blog/static/css/blog.css`. Эта строка будет импортировать шрифт *Lobster* из Google Fonts (https://www.google.com/fonts).
+
+Найди блок стилей (код между фигурными скобками `{` и `}`) для `h1` в CSS файле `blog/static/css/blog.css`. Теперь добавьте строку `font-family: 'Lobster';` между фигурными скобками и обновите страницу:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Рисунок 14.3](images/font.png)
+
+Отлично!
+
+Как упоминалось выше, CSS имеет концепцию классов. Они позволяют назвать часть HTML-кода и применить стили только к этой части, не влияя на другие части. Это может быть супер полезно! Возможно, у вас есть два div, которые делают что-то разное (например, заголовок и ваше сообщение). Класс может помочь вам сделать их выглядеть иначе.
+
+Идите вперед и назовите некоторые части HTML-кода. Замените `header`, который содержит ваш заголовок, следующим:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+
+```
+
+А теперь добавьте класс `post` в ваш `article`, содержащий сообщение в блоге.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+
+```
+
+А теперь добавим определения блоков для различных селекторов. Селекторы, которые начинают с символа `.` относятся к классам. Существует много хороших справочников о CSS в Интернете, которые могут помочь вам понять следующий код. А сейчас просто скопируйте и вставьте его в файл `blog/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+
+```
+
+Далее переделайте HTML код, отображающий посты. замените:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+в `blog/templates/blog/post_list.html` этим кодом:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Сохраните эти файлы и обновить свой веб-сайт.
+
+![Рисунок 14.4](images/final.png)
+
+Юююхуууу! Выглядит неплохо, ведь так? :) Посмотрите на код, который мы только что вставили. Мы добавили классы в HTML и использовали их в CSS. Где бы вы вносили изменения, если бы вы хотели, чтобы дата была бирюзой?
+
+Не бойтесь возиться с CSS - попробуйте изменить некоторые вещи. Игра с CSS может помочь вам понять, что делают разные вещи. Если вы нарушите что-то, не беспокойтесь - вы всегда можете отменить это!
+
+Мы весьма рекомендуем пройти бесплатные онлайн-курсы "Basic HTML & HTML5" и "Basic CSS" на [freeCodeCamp](https://learn.freecodecamp.org/). Они могут помочь тебе узнать все о том, что делает тебе сайты красивее с HTML и CSS.
+
+Готовы к следующей главе?! :)
\ No newline at end of file
diff --git a/ru-RU/deploy/README.md b/ru-RU/deploy/README.md
new file mode 100644
index 00000000000..f0aed20e66e
--- /dev/null
+++ b/ru-RU/deploy/README.md
@@ -0,0 +1,246 @@
+# Публикация!
+
+> **Примечание**: Эта глава может показаться сложной. Будь упорна, развертывание сайта на сервере является важной частью веб-разработки. Данная глава намеренно расположена в середине учебника для того, чтобы твой наставник смог помочь с таким мудреным процессом, как публикация сайта. Так ты сможешь самостоятельно закончить все главы, даже если время будет поджимать.
+
+До сих пор твой сайт был доступен только с твоего компьютера. Сейчас ты узнаешь, как "развернуть" свой сайт! Развертывание (deploy) — это процесс публикации приложения в интернете, чтобы люди могли наконец увидеть твое творение. :)
+
+Как ты уже знаешь, веб-сайт должен располагаться на сервере. В интернете есть много сервер-провайдеров, мы будем использовать [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere предоставляется бесплатно для небольших приложений с небольшим числом посетителей, что более чем достаточно для нас.
+
+Другим внешним сервисом, которым мы будем пользоваться, является [GitHub](https://www.github.com) — сервис хостинга кода. Существуют и другие похожие сервисы, но практически у каждого программиста есть GitHub аккаунт, теперь будет и у тебя!
+
+Эти три места будут важны для вас. Ваш локальный компьютер будет местом, где вы будете вести разработку и тестирование. Когда вы удовлетворены изменениями, вы разместите копию вашей программы на GitHub. Ваш веб-сайт будет на PythonAnywhere, и вы будете обновлять его, получая новые копии вашего кода с GitHub.
+
+# Git
+
+> **Примечание** Если ты уже прошла шаги установки, не нужно делать это снова - можешь пропустить этот раздел и приступать к созданию Git репозитория.
+
+{% include "/deploy/install_git.md" %}
+
+## Создаём Git-репозиторий
+
+Git отслеживает изменения определенного набора файлов, которая называется репозиторием (сокращенно "репо"). Давайте создадим один для нашего проекта. Откройте консоль и запустите эти команды в папке `djangogirls`:
+
+> **Примечание**Проверьте свой текущий рабочий каталог с помощью команд `pwd` (Mac OS X/Linux) или `cd` (Windows), прежде чем инициализировать репозиторий. Ты должна находиться в директории `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Инициализировать git-репозиторий необходимо только один раз за проект (и тебе больше не придется снова вводить имя пользователя и адрес электронной почты).
+
+Git будет отслеживать изменения всех файлов и каталогов в заданной директории, однако некоторые из них мы предпочли бы игнорировать. Для этого нам нужно создать файл `.gitignore` в корневом каталоге репозитория. Открой редактор и создай новый файл со следующим содержанием:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+И сохрани его как `.gitignore` в корневом каталоге "djangogirls".
+
+> **Примечание**: Точка в начале имени файла имеет важное значение! Если у тебя есть проблемы с созданием таких файлов (Mac не позволит создать файл с названием, начинающимся с точки, через Finder, например), тогда используй кнопку "Сохранить как" в меню своего редактора кода, это точно поможет. И убедись, что не добавила `.txt`, `.py`, или другое расширение к имени файла - Git распознает это только в том случае, если имя содержит только `.gitignore`. Linux и MacOS считают файлы с именами, начинающимися с `.` (например, `.gitignore`) скрытыми, и обычная команда `ls` не показывает эти файлы. Используйте команду `ls -a`, чтобы увидеть файл `.gitignore`.
+> 
+> **Примечание** Один из файлов, заданных в ваш файл `.gitignore` — `db.sqlite3`. Этот файл ваша локальная база данных, где хранятся все записи ваших пользователей. 2 Мы будем следовать стандартным практикам веб-программирования; это значит, что мы будем использовать отдельные базы данных для вашего локального тестового сайта и вашего живого сайта на PythonAnywhere. База данных PythonAnywhere может быть SQLite, так же как и на вашем устройстве для разработки, но, обычно, вы будете использовать базу данных, называемую MySQL, которая может работать с гораздо большим числом посетителей, нежели SQLite. В любом случае, игнорирование вашей SQLite базы данных для GitHub означает, что все записи и суперпользователь созданные вами будут доступны только локально, и необходимо создать новые для производства. Вы должны думать о вашей локальной базе данных как о хорошей игровой площадке, где вы можете проверить разные вещи и не бояться, что вы удалите ваши реальные сообщения из вашего блога.
+
+Использовать команду `git status` перед `git add` или в любой другой момент, когда ты не уверен, что изменилось — хорошая идея. Это убережёт тебя от таких неприятных сюрпризов, таких как добавление или "коммит" неправильных файлов. Команда `git status` возвращает информацию обо всех ранее неотслеживаемых/изменённых/добавленных в git файлах, а также статус ветки и многое другое. Результат должен быть аналогичен следующему:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+И, наконец, мы сохраним наши изменения. Переключись на консоль и набери:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Публикация твоего кода на GitHub
+
+Перейди на [GitHub.com](https://www.github.com) и зарегистрируйся для нового бесплатного аккаунта. (Если вы уже сделали это в мастерской prep, это здорово!) Убедитесь, что помните свой пароль (добавите его в ваш менеджер паролей, если вы им пользуетесь).
+
+Дальше создай новый репозиторий с именем "my-first-blog". Не ставь галочку на пункте "initialize with a README" и отметь опции .gitignore(мы создадим этот файл вручную) и License как None.
+
+![](images/new_github_repo.png)
+
+> **Примечание:** Имя репозитория `my-first-blog` имеет очень большое значение. Ты конечно можешь придумать другое название, но оно встречается много раз в руководстве и тебе придется каждый раз менять его на своё. Возможно, проще остановиться на варианте `my-first-blog`.
+
+На следующем экране, вы увидите URL клона вашего repo, которым вы будете пользоваться при помощи нижеуказанных команд:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Теперь нам нужно связать твой локальный Git репозиторий на компьютере с репозиторием на GitHub.
+
+Напечатай в консоль (замени `&lt;your-github-username&gt;`имя пользователя на свое, то есть на то, которое указала при создании аккаунта GitHub, но без угловых скобок - URL должен совпадать с клоном URL, которое ты видишь):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Когда ты отправляешь (push) на GitHub, тебе придется указать имя пользователя и пароль (либо прямо здесь в командной строке или во всплывающем окне), после ввода учетных данных, должно появиться что-то вроде этого:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    
+    To https://github.com/ola/my-first-blog.git
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Теперь твой код загружен на GitHub. Зайди на сайт и проверь! Вы найдете его в компании – [Django](https://github.com/django/django), [ Django Girls туториала](https://github.com/DjangoGirls/tutorial) и многих других проектов c открытым исходным кодом на GitHub. :)
+
+# Настройка нашего блога на PythonAnywhere
+
+## Регистрация аккаунта на PythonAnywhere
+
+> **Примечание** Возможно, ты уже завела учётную запись на PythonAnywhere ранее — если так, не нужно повторять это снова.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Настройка нашего сайта на PythonAnywhere
+
+Вернись в главное меню [PythonAnywhere Dashboard](https://www.pythonanywhere.com/), кликнув на логотип и выбери опцию запуска консоли Bash - это версия консоли PythonAnywhere как и на твоем компьютере.
+
+![В разделе «Новой консоли» в веб-версии PythonAnywhere, с помощью кнопки "Bash"](images/pythonanywhere_bash_console.png)
+
+> **Примечание**: PythonAnywhere использует Linux, так что если ты используешь Windows, то терминал и команды могут немного отличаться от того, к чему ты привыкла на своем компьютере.
+
+Развёртывание веб-приложения на PythonAnywhere включает в себя загрузку твоего кода с GitHub и настройку PythonAnywhere, чтобы распознать его и запустить в качестве веб-приложения. Существуют ручные способы, чтобы сделать это, но PythonAnywhere предоставляет вспомогательный инструмент, который сделает это за тебя. Давай сначала установим его:
+
+{% filename %}command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+В консоли должно напечататься что-то подобное`Collecting pythonanywhere` и в конце `Successfully installed (...) pythonanywhere- (...)`.
+
+Теперь мы запустим помощника для автоматической настройки нашего приложения с GitHub. Введи следующую команду в консоли на PythonAnywhere (не забудь использовать свою учетную запись на GitHub в `&lt;your-github-username&gt;`, так чтобы URL совпадал с URL клона на GitHub):
+
+{% filename %}command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+Когда ты увидишь, как это работает, то ты сможешь понять, что именно оно делает:
+
+- Скачивает твой код с GitHub
+- Создается virtualenv на PythonAnywhere абсолютно точно так же, как и на твоем компьютере
+- Обновляет твой файл настроек с некоторыми параметрами развертывания
+- Создаем базу данных на PythonAnywhere, используя команду `manage.py migrate`
+- Настраивает твои статичные файлы(мы узнаем об этом позже)
+- И настраивает PythonAnywhere для обслуживания твоего веб-приложения через API
+
+На PythonAnywhere все эти шаги автоматизированы, но это те же самые шаги, которые необходимо будет выполнить с любым другим сервер-провайдером.
+
+Главное, что сейчас нужно отметить - база данных PythonAnywhere на самом деле полностью отделена от базы данных на твоем компьютере. Это значит, что они могут иметь разные посты и админские учетные записи. В результате как мы уже сделали на нашем компьютере, необходимо инициализировать учетную запись администратора с помощью `createsuperuser`. PythonAnywhere автоматически активирует твой virtualenv, поэтому всё, что нужно сделать это:
+
+{% filename %}command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Введи сведения для учетной записи администратора. Лучше всего использовать те же, что ты использовала на своем компьютере во избежание путаницы, если ты не хочешь сделать пароль на PythonAnywhere более безопасным.
+
+Теперь, если ты хочешь, то ты можешь посмотреть на код на PythonAnywhere используя `ls`:
+
+{% filename %}command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.pytests.py  static
+    templates  views.py
+    
+
+Ты также можешь перейти во вкладку "Files" и перемещаться по PythonAnywhere с помощью встроенного в браузер файлового менеджера. (Со страницы Console ты можешь перейти на другие страницы PythonAnywhere из кнопки меню, расположенной в верхнем правом углу. Если ты находишься на одной из страниц, ссылки на другие страницы расположены рядом сверху.)
+
+## Ты в сети!
+
+Теперь твой сайт в публичном Интернете! Перейди во вкладку "Web" на PythonAnywhere, чтобы получить ссылку на твой сайт. Ты можешь поделиться ей с кем угодно. :)
+
+> **Примечание:** Это учебник для начинающих и при разворачивании сайта мы использовали несколько приёмов, которые не являются идеальными с точки зрения безопасности. Если ты решила построить на этом проект или начать новый, то следует просмотреть [Django чеклист для развертывания](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/), который содержит некоторые советы по защите твоего сайта.
+
+## Советы по отладке
+
+Если вы видите ошибку во время выполнения скрипта `pa_autoconfigure_django.py`, вот несколько распространенных причин:
+
+- Не был создан PythonAnywhere API токен - ключ, для обеспечения доступа.
+- Была допущена ошибка в URL GitHub репозитория
+- Если ты видишь ошибку *"Could not find your settings.py"*, это вероятно потому, что не удалось добавить все твои файлы в Git и/или ты не успешно загрузила их на GitHub. Посмотри инструкции еще раз в разделе Git выше
+- Если вы ранее зарегистрировали учетную запись PythonAnywhere и имели ошибку collectstatic, у вас вероятно старая версия SQLite (например, 3.8.2) для вашей учетной записи. В этом случае войди в новую учетную запись и попробу команды в вышеприведенном разделе PythonAnywhere.
+
+Если видишь ошибку при попытке посетить свой сайт, для отладочной информации первым делом смотри **журнал ошибок**. Ты найдешь линк на него на PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/) странице. Посмотри, нет ли там сообщений о каких-нибудь ошибках; самые последние из них приведены ниже.
+
+Также можешь посмотреть [общие советы по отладке на вики PythonAnywhere](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+И помни: твой инструктор здесь, чтобы помогать!
+
+# Проверить свой сайт!
+
+Стандартная страница твоего сайта должна включать приветствие "Welcome to Django", точно также как было на локальном компьютере. Попробуй добавить `/admin/` к концу адреса сайта и перейдешь к панели администратора сайта. Войди используя имя пользователя и пароль, и ты увидишь, что можешь добавить новые записи на сервер - не забудь, что записи с твоей тестовой базы данных не будут отправлены на твой "живой" блог.
+
+После того, как ты создала несколько постов, ты можешь вернуться к локальной настройке(не PythonAnywhere). Тут тебе следует работать для создания изменений. Это общий процесс веб-разработки - делать изменения локально, загружать эти изменения на GitHub и отправлять эти изменения на реальный веб-сервер. Это позволяет тебе работать и экспериментировать без нарушения работы твоего веб-сайта. Довольно круто, да?
+
+Ты заслужила *огромную* похвалу! Развертывание сервера — одна из самых каверзных частей веб-разработки, и на это нередко уходит несколько дней, прежде чем заставишь всё работать. Но у тебя получился живой сайт, в настоящем интернете!
\ No newline at end of file
diff --git a/ru-RU/deploy/install_git.md b/ru-RU/deploy/install_git.md
new file mode 100644
index 00000000000..aa6497cf51a
--- /dev/null
+++ b/ru-RU/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git — это "система контроля версий", используемая множеством программистов. Эта программа отслеживает изменения, происходящие с файлами, чтобы впоследствии можно было восстановить состояние кода на нужный момент времени. Немного схоже с функцией "отслеживание изменений" в тестовых процессорах (например, Microsoft Word или LibreOffice Writer), только более мощное.
+
+## Установка Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Ты можешь загрузить Git с официального сайта [git-scm.com](https://git-scm.com/). Ты можешь нажимать "дальше дальше дальше" на всех этапах установки за исключением одного: на пятом шаге, который называется "Adjusting your PATH environment" ("Настройка системной переменной PATH"), выберите "Run Git and associated Unix tools from the Windows command-line" ("Запуск Git и соответствующих Unix утилит через командную строку Windows", нижняя опция). Все остальные настройки можно оставить по умолчанию. Опция "Checkout Windows-style, commit Unix-style line endings" будет неплохим выбором.
+
+Не забудьте перезапустить командную строку или PowerShell после успешного завершения установки. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Загрузите Git с [git-scm.com](https://git-scm.com/) и следуйте инструкциям.
+
+> **Заметка** Если вы используете OS X 10.6, 10.7, or 10.8, вам необходимо установить версию git, расположенную здеесь: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ru-RU/deploy/signup_pythonanywhere.md b/ru-RU/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..d4b60b1127d
--- /dev/null
+++ b/ru-RU/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnyway это сервис позволяющий запускать код написанный на языке Python на сервере в "облаке". Мы используем его для хостинга нашего веб-сайта в интернете.
+
+Зарегистрируй на PythonAnywhere аккаунт как "Beginner" ("новичок") (бесплатной версии достаточно, кредитная карточка не понадобится).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![На странице регистрации PythonAnywhere имеется кнопка для создания бесплатной учетной записи «Beginner»](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Примечание**: При выборе имени пользователя, помни, что URL блога примет вид `yourusername.pythonanywhere.com`, так что остановись либо на своём нике, либо на имени, связанном с тематикой блога. Кроме того, убедись, что запомнила свой пароль (добавь его в свой менеджер паролей, если пользуешься таковым).
+
+## Создание API ключа на PythonAnywhere
+
+Это то, что вам только нужно сделать один раз. Когда вы зарегистрировались на PythonAnywhere, вы переместитесь на dashboard. Найди ссылку расположенную вверху справа на свою страницу "Account":
+
+![Ссылка на аккаунт расположена вверху справа на странице](../deploy/images/pythonanywhere_account.png)
+
+затем выберите вкладку с именем «API token» и нажмите кнопку с надписью "Create new API token".
+
+![API token вкладка на странице Аккаунт](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ru-RU/django/README.md b/ru-RU/django/README.md
new file mode 100644
index 00000000000..0ad2e16ea49
--- /dev/null
+++ b/ru-RU/django/README.md
@@ -0,0 +1,27 @@
+# Что же такое Django?
+
+Django - бесплатный web-фреймворк, написанный на Python. Фреймворк - это набор компонентов, которые помогают разрабатывать веб-сайты быстро и просто.
+
+Каждый раз при разработке веб-сайтов требуются похожие компоненты: способ аутентифицировать пользователей (вход, выход, регистрация), панель управления сайтом, формы, инструменты для загрузки файлов и т. д.
+
+К счастью, другие люди уже обратили внимание на возникновение однотипных проблем при веб-разработке, так что они объединились и создали фреймворки (Django и другие), которые предлагают нам готовые шаблоны для использования.
+
+Фреймворки существуют, чтобы облегчить процесс разработки и позволить нам не изобретать велосипед.
+
+## Зачем нам нужен фреймворк?
+
+Чтобы понять, для чего же нам нужен Django, нам нужно ближе познакомиться с серверами. Во-первых, сервер должен узнать о том, что мы ждем от него веб-страницу.
+
+Представь себе почтовый ящик (порт), который проверяется на наличие новых писем (запросов). Это делает веб-сервер. Веб-сервер читает письмо, а затем отправляет ответ (веб-страницу). Однако, чтобы что-то отправить нам надо это что-то иметь. И Django как раз и отвечает за создание контента, который будет отправлен в ответе.
+
+## Что происходит, когда кто-то запрашивает веб-сайт у твоего сервера?
+
+Когда на сервер приходит запрос, он переадресуется Django, который пытается понять что же конкретно от него просят. Для начала он берет адрес веб-страницы и пробует понять, что нужно делать. За эту часть в Django отвечает **urlresolver** (адрес веб-сайта называется URL - Uniform Resource Locator - Единый указатель ресурсов, так что название *urlresolver*, resolver == распознаватель, имеет определенный смысл). Он не слишком умен, поэтому просто берет список шаблонов и пытается сопоставить их с URL. Django сверяет шаблоны сверху вниз и, если что-то совпадает, он переправляет запрос соответствующей функции (которая называется *view*).
+
+Представь себе почтальона с письмом. Она идет вниз по улицы и сверяет номера домов с адресом на письме. Если они совпадают, то она оставляет письмо. Так же работает и urlresolver!
+
+Но самые интересные вещи происходят в функции *view*: мы, например, можем обращаться к базе данных за определенной информацией. Может быть пользователь попросил изменить какую-нибудь информацию? Как будто в письме написано: "Пожалуйста, поменяйте описание моей работы". Функция *view* может проверить, имеете ли вы разрешение делать это, а затем обновит описание работы и отправит обратно ответ: "Готово!"
+
+Вышеуказанное описание немного упрощено, но вам сейчас нет необходимости знать все технические "тонкости". Достаточно понимать основную идею.
+
+Так что, не углубляясь слишком в детали, начнем что-то создавать с Django и будем изучать важные особенности по мере продвижения!
\ No newline at end of file
diff --git a/ru-RU/django_admin/README.md b/ru-RU/django_admin/README.md
new file mode 100644
index 00000000000..a547db299fb
--- /dev/null
+++ b/ru-RU/django_admin/README.md
@@ -0,0 +1,57 @@
+# Администрирование Django
+
+Чтобы добавлять, редактировать и удалять записи, для которых мы только сделали модель, нам потребуется использовать права администратора в Django.
+
+Откройте файл `blog/admin.py` в редакторе кода и замените его содержимое на:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Как ты можешь заметить, мы импортировали (включили) модель Post, которая была определена в предыдущей главе. Чтобы наша модель стала доступна на странице администрирования, нам нужно зарегистрировать её при помощи `admin.site.register(Post)`.
+
+Хорошо, теперь нам нужно взглянуть на модель Post. Не забудь запустить веб-сервер командой `python manage.py runserver`. Перейдите в ваш браузер и введите адрес http://127.0.0.1:8000/admin /. Ты увидишь страничку авторизации:
+
+![Страница авторизации](images/login_page2.png)
+
+Чтобы залогиниться, тебе сначала нужно создать суперпользователя *superuser* - пользователя, который имеет полный доступ к управлению сайтом. Вернись к консоли, напечатай `python manage.py createsuperuser`, и нажми Enter.
+
+> Помните о том, что вводить новые команды нужно в режиме работающего сервера, откройте новое окно терминала и активируйте ваше вируальное окружение (virtualenv). Мы рассмотрели, как писать новые команды **вашего первого проекта Django!** главе, в разделе **Запуск веб-сервера**.
+
+{% filename %}Mac OS X или Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+При появлении запроса введи имя пользователя (строчными буквами, без пробелов), адрес электронной почты и пароль. **Не беспокойся, что ты не видишь печатаемый пароль - так и должно быть.** Напечатай его и нажми `enter` чтобы продолжить. Результат должен выглядеть следующим образом (имя пользователя и почта соответственно будут твоими):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Вернись в браузер и войди в систему при помощи имени пользователя и пароля, которые ты только что выбрала. Ты должна попасть в панель управления Django.
+
+![Django admin](images/django_admin3.png)
+
+Перейди к записям (Post) и поэкспериментируй немного с ними. Добавь 5-6 записей в блог. Не переживай за контент - он видим тебе только на твоем локальном компьютере - ты можешь скопировать-вставить текст из этого туториала, чтобы сэкономить время. :)
+
+Убедитесь, чтобы хотя бы у двух-трёх постов (но не у всех) была дата публикации. Это может быть полезным в будущем.
+
+![Django admin](images/edit_post3.png)
+
+Если ты хочешь узнать больше об администрировании Django, то ознакомься с этим разделом официальной документации: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Сейчас, вероятно, подходящий момент, чтобы порадовать себя кружечкой кофе (или чая), а также съесть чего-нибудь для пополнения энергии. Ты только что создал(а) свою первую Django модель и заслужил(а) перерыв!
\ No newline at end of file
diff --git a/ru-RU/django_forms/README.md b/ru-RU/django_forms/README.md
new file mode 100644
index 00000000000..cf50bf23ab3
--- /dev/null
+++ b/ru-RU/django_forms/README.md
@@ -0,0 +1,479 @@
+# Формы в Django
+
+Последним, что нам стоит сделать для нашего веб-сайта является удобный способ добавления и редактирования записей. Django `admin`-панель удобна, но её дизайн сложно изменять. С `forms` (формами) мы будем иметь абсолютную власть над нашим интерфейсом - мы сможем сделать практически все, что только можно придумать!
+
+В формах Django удобно то, что мы можем создать новую форму с нуля или воспользоваться `ModelForm` для сохранения содержимого форм в модель.
+
+Это как раз то, что нам нужно сделать: мы создадим форму для модели `Post`.
+
+Как и любая важная часть Django, формы имеют свой собственный файл: `forms.py`.
+
+Нам нужно создать файл с таким именем в директории `blog`.
+
+    blog
+       └── forms.py
+    
+
+OK, давайте откроем его в редакторе кода и напечатаем следующий код:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Для начала нам нужно импортировать формы Django (`from django import forms`) и, разумеется, нашу модель `Post` (`from .models import Post`).
+
+`PostForm`, как ты, вероятно, подозреваешь, это имя для нашей формы. Нам нужно также сообщить Django, что эта форма относится к `ModelForm` (чтобы он смог поколдовать для нас) - `forms.ModelForm` поможет с этим.
+
+Затем, мы имеем `class Meta`, где мы определяем какая модель будет использоваться для создания формы (`model = Post`).
+
+В завершении мы можем указать, какие поля должны присутствовать в нашей форме. В этом сценарии мы хотим, чтобы только `title` и `text` отображались - `author` должен быть пользователем, который вошел в систему под своим логином (ты!) и `created_date` должна автоматически устанавливаться при создании записи (то есть в коде), верно?
+
+Вот и все! Всё, что нам теперь осталось сделать - это использовать форму в *представлении* и отобразить её в шаблоне.
+
+Итак, еще раз мы создадим ссылку на страницу, URL, представление и шаблон.
+
+## Ссылка на страницу с формой
+
+Прежде чем мы добавим ссылку, нам нужно несколько иконок, чтобы использовать как кнопки для ссылки. Для этого руководства, загрузите [файл earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) и сохраните его в папке `blog/templates/blog/icons/`
+
+> Замечание: Для загрузки SVG изображения, откройте контекстное меню на ссылке (обычно правой кнопкой мыши по нему) и выберите "Сохранить ссылку как". В диалоговом окне, попросив, где сохранить файл, перейдите в каталог `djangogirls` вашего проекта Django, и в том подкаталоге `blog/templates/blog/icons/`, и сохранить файл там.
+
+Пора открыть `blog/templates/blog/base.html` в редакторе кода. Теперь мы можем использовать этот файл значков в базовом шаблоне следующим образом. В элементе `div` внутри раздела `header` мы добавим ссылку перед элементом `h1`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Обратите внимание, что мы хотим назвать наше новое представление `post_new`. [Иконка SVG](https://icons.getbootstrap.com/icons/file-earmark-plus/) предоставлена [иконками Bootstrap](https://icons.getbootstrap.com/) , и на экране появится значок страницы с подписью плюс. Мы используем директиву шаблона Django под названием `include`. Это включит содержимое файла в шаблон Django. Веб-браузер знает, как обрабатывать этот тип контента без какой-либо дополнительной обработки.
+
+> Вы можете скачать все иконки Bootstrap [здесь](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Разархивируйте файл и скопируйте все файлы изображений SVG в новую папку внутри `blog/templates/blog/` под названием `icons`. Таким образом, вы можете получить доступ к иконке `pencil-fill.svg` , используя путь к файлу `blog/templates/blog/icons/pencil-fill.svg`
+
+После редактирования строки, ваш HTML-файл должен выглядеть следующим образом:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+После сохранения и обновления страницы http://127.0.0.1:8000 вы увидите знакомый `NoReverseMatch` . Это так? Хорошо!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## Представление post_new
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Шаблон
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* Нам необходимо отобразить форму на страницу. Это можно сделать (например) с помощью {% raw %}`{{ form.as_p }}`{% endraw %}
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Нам потребуется кнопка `Save`. Мы реализуем при помощи HTML-кнопки: `<button type="submit">Save</button>`.
+* Наконец, после открытия `&lt;form ...&gt;` тега, нам необходимо добавить {% raw %}`{% csrf_token %}`{% endraw %}. Это очень важно, поскольку так мы делаем форму защищенной! Если вы забудете об этой части, Django будет "жаловаться", когда вы попытаетесь сохранить форму:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Сохраняем данные из формы
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Валидация формы
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Форма редактирования
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Безопасность
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## И последнее: публикация!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* Сначала нам нужно сделать commit и push нового кода в репозиторий Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Затем набери в [Bash консоли PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Наконец, прыжок на [страницу «Веб»](https://www.pythonanywhere.com/web_app_setup/) (используйте кнопку меню в верхнем правом углу консоли) и клик по **Reload**. Обновите ваш https://subdomain.pythonanywhere.com блог, чтобы увидеть изменения.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ru-RU/django_installation/README.md b/ru-RU/django_installation/README.md
new file mode 100644
index 00000000000..eb582bf5009
--- /dev/null
+++ b/ru-RU/django_installation/README.md
@@ -0,0 +1,7 @@
+# Установка Django
+
+> **Примечание** Если вы используете Chromebook, пропустите эту главу и следуйте инструкции по [Установке Chromebook](../chromebook_setup/README.md).
+> 
+> **Примечание** Если ты уже выполнила установку - можешь сразу переходить к следующей главе!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ru-RU/django_installation/instructions.md b/ru-RU/django_installation/instructions.md
new file mode 100644
index 00000000000..4fdf124896b
--- /dev/null
+++ b/ru-RU/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Отдельные части этой главы основаны на учебных пособиях Geek Girls Carrots (http://django.carrots.pl/).
+> 
+> Отдельные части этой главы основаны на [учебном пособии django-marcador](http://django-marcador.keimlink.de/), лицензированном под Creative Commons Attribution-ShareAlike 4.0 International License. Руководство django-marcador защищено авторским правом Markus Zapke-Gründemann et al.
+
+## Виртуальное окружение
+
+Перед установкой Django мы попросим тебя установить крайне полезный инструмент, который поможет тебе содержать среду разработки в чистоте. Можно пропустить этот шаг, но мы очень советуем этого не делать. Использование лучших рекомендаций с самого начала убережёт от многих проблем в будущем!
+
+Итак, давай создадим **виртуальное окружение** (оно также называется *virtualenv*). Virtualenv будет изолировать зависимости Python/Django для каждого отдельного проекта. Это значит, что изменения одного сайта никогда не затронут другие сайты, которые вы разрабатываете. Удобно, правда?
+
+Все что тебе нужно сделать -- найти директорию, в которой мы создадим `virtualenv`; домашний каталог вполне подойдет. Для Windows адрес будет выглядеть так: `C:\Users\Name` (где `Name` твое имя пользователя).
+
+> **ПРИМЕЧАНИЕ:** На Windows убедитесь, что этот каталог не содержит в имени специальные символы; Если ваше имя пользователя содержит кириллические знаки, используйте другой каталог, например `C:\djangogirls`.
+
+Мы будем использовать отдельную директорию `djangogirls` в домашнем каталоге:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Мы создадим виртуальное окружение под именем `myvenv`. В общем случае команда будет выглядеть так:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Чтобы создать новое виртуальное окружение `virtualenv`, вам нужно открыть командную строку и запустить `python -м venv myvenv`. Он будет выглядеть следующим образом:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Где `myvenv` — имя вашего `virtualenv`. Ты можешь выбрать любое имя, использовать можно только прописные буквы, без пробелов и специальных символов. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Для Linux и OS X достаточно набрать `python3 -m venv myvenv`, чтобы создать `virtualenv`. Это будет выглядеть так:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` -- имя виртуального окружения `virtualenv`. Опять же, только строчные буквы и никаких пробелов. Имя виртуального окружения лучше выбирать покороче — его часто придется набирать!
+
+> **ПРИМЕЧАНИЕ:** В некоторых версиях Debian/Ubuntu может появиться следующее сообщение об ошибке:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> В этом случае, следуй нижеуказанной инструкции и установи пакет `python3-venv`: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **ПРИМЕЧАНИЕ:** В некоторых версиях Debian/Ubuntu при инициировании виртуального окруженя выдает следующую ошибку:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Чтобы обойти эту проблему используй команду `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **ПРИМЕЧАНИЕ:** Если вы получаете такое сообщение:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> вместо этого запустите:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Работаем с virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Запусти виртуальное окружение, выполнив:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. В этом случае откройте Windows PowerShell с помощью параметра «Запуск от имени администратора». Затем попробуйте ввести следующую команду перед запуском виртуальной среды:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Вы хотите изменить политику исполнения? [Y] Да  [A] Да для всех  [N] Нет  [L] Нет для всех  [S] Приостановить [?] Справка (по умолчанию "N"): А
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> Преимущество в том, что тебе не нужно переключаться между окном редактора и командной строкой
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Запусти виртуальное окружение, выполнив:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Не забудь поменять `myvenv` на выбранное для `virtualenv` имя!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+Ты поймешь, что `virtualenv` запущен, когда увидишь префикс `(myvenv)` в командной строке.
+
+При работе с виртуальным окружением, команда `python` будет автоматически обращаться к правильной версии языка, так что тебе не обязательно использовать `python3`.
+
+Отлично, теперь мы будем хранить все важные зависимости в одном месте. Наконец можно установить Django!
+
+## Установка Django {#django}
+
+Теперь, когда твой `virtualenv` запущен, ты можешь установить Django.
+
+Но перед этим мы должны убедиться, что у нас установлена последняя версия `pip`, программы, которую мы будем использовать для установки Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Установка пакетов с требованиями
+
+Файл требований хранит список зависимостей для установки с использованием `pip install`:
+
+Сначала создай файл `requirements.txt` внутри папки `djangogirls /`, используя редактор кода, который ты установила ранее. Ты можешь сделать это, открыв новый файл в редакторе кода и затем сохранив его как `requirements.txt` в папке `djangogirls /`. Ваша папка будет выглядеть следующим образом:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+В файл `static/css/requirements.txt` следует добавить следующий код:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Теперь введи `pip install -r requirements.txt` для установки Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). Если проблема в этом, то, пожалуйста, перенеси свой проект в другое место, адрес которого не будет содержать пробелы и специальные символы (советуем в: `C:\djangogirls`). Создай новый virtualenv в новой директории, а затем удали старый и повтори команды выше. (Перемещение директории virtualenv не будет работать, потому что virtualenv использует абсолютные пути.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> При возникновении ошибки при вызове pip под Ubuntu 12.04, пожалуйста, запусти `python -m pip install -U --force-reinstall pip`, чтобы исправить установку pip в virtualenv.
+
+<!--endsec-->
+
+Вот и оно! Теперь ты (наконец-то) готова создать свое Django приложение!
\ No newline at end of file
diff --git a/ru-RU/django_models/README.md b/ru-RU/django_models/README.md
new file mode 100644
index 00000000000..c24d613fecc
--- /dev/null
+++ b/ru-RU/django_models/README.md
@@ -0,0 +1,201 @@
+# Модели Django
+
+Нам нужно что-то, что будет хранить все записи нашего блога. Но прежде, давай поговорим о вещах, называемых `объектами`.
+
+## Объекты
+
+В программировании существует особая концепция, она называется -- `объектно-ориентированным программированием`. Идея заключается в том, что вместо скучной последовательности инструкций мы моделируем вещи и описываем как они взаимодействуют друг с другом.
+
+Так что же такое объект? Это совокупность поведения и свойств. Звучит странно, но мы приведем пример.
+
+Если мы хотим смоделировать кошку, то создадим объект `Cat`, который обладает определенными свойствами, например, `color` (цвет), `age` (возраст), `mood` (настроение: плохое, хорошее, сонное ;)), `owner` (хозяин, например другой объект -- `Person` или, если кошка дикая, это свойство будет пустым).
+
+Объект `Cat` будет иметь набор определенных действий: `purr` (мурчать), `scratch` (царапаться) или `feed` (кормить, где мы дадим кошке немного `CatFood` (кошачьей еды), которая так же может быть отдельным объектом со своими свойствами, например `taste` (вкусом)
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+Основная идея, таким образом, заключается в описании объекта в коде, используя его параметры (`свойства объекта`) и доступные ему действия (`методы`).
+
+Так как же мы смоделируем запись в блоге? Нам же нужен блог, верно?
+
+Для начала стоит ответить на вопрос: что такое запись в блоге? Какие свойства она имеет?
+
+Ну, запись содержит какой-то текст и заголовок, это наверняка, верно? Было бы неплохо также знать кто её написал -- так что нам нужен автор. Ну и в заключении, нам нужно знать когда запись создана и когда опубликована.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Какие вещи можно сделать с записью в блоге? Было бы неплохо иметь `метод` для её публикации, согласна?
+
+Так что нам пригодится метод `publish`.
+
+Ну и раз уж мы определились с тем, что хотим получить, давай начнем моделирование в Django!
+
+## Модель в Django
+
+Зная, что представляет из себя объект, мы можем создать Django модель для записи в блоге.
+
+Модель в Django — это особый вид объекта и он сохраняется в `базе данных`. База данных представляет собой совокупность различных данных. Это то место, где ты будешь хранить информацию о своих пользователях, записях в блоге и т.д. Мы будем использовать базу данных SQLite для хранения информации. Это стандартная база данных в Django -- её вполне хватит для наших нужд сейчас.
+
+Ты можешь представить модель в базе данных как электронную таблицу с колонками (полями) и строками (данными).
+
+### Создание приложения
+
+Для аккуратности мы создадим отдельное приложение в нашем проекте. Очень удобно иметь хорошо организованное рабочее место с самого начала. Для создания приложения нам понадобиться набрать следующую инструкцию в командной строке (из директории `djangogirls`, где находится файл `manage.py`):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Обрати внимание, что в нашем проекте появилась новая папка `blog`, которая содержит некоторые файлы. Итак, структура нашего проекта будет выглядеть следующим образом:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+После того как приложение создано, нам нужно сообщить Django, что теперь он должен его использовать. Мы делаем это в файле `mysite/settings.py`, откройте его в своем редакторе кода. Нам нужно найти `INSTALLED_APPS` и добавить к списку `'blog',` прямо перед `]`. Конечный результат должен выглядеть следующим образом:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Создание модели записи в блоге
+
+В файле `blog/models.py` мы определяем все объекты называемые`Models` - в этом месте мы определим наши записи для блога.
+
+Открой файл `blog/models.py` в редакторе кода, удали весь текст и вставь на его место следующий код:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Убедись, что использовала два символа нижнего подчеркивания (`_`) с обоих сторон от метода `str`. Это соглашение часто используется при программировании на Python, и иногда его называют "dunder" (сокращение от англ. "double-underscore").
+
+Смотрится страшно, да? Но не волнуйся, мы объясним что значит каждая строка кода!
+
+Строки, начинающиеся с `from` или `import`, открывают доступ к коду из других файлов. Так что, вместо того, чтобы копировать и вставлять один и тот же код во все файлы, мы можешь сослаться на него при помощи `from ... import ...`.
+
+`class Post(models.Model):` -- эта строка определяет нашу модель (`объект`).
+
+- `class` это специальное ключевое слово для определения объектов.
+- `Post` это имя нашей модели, мы можем поменять его при желании (специальные знаки и пробелы использовать нельзя). Всегда начинай имена классов с большой буквы.
+- `models.Model` означает что объект Post является моделью Django, так Django поймет, что он должен сохранить его в базу данных.
+
+Дальше мы задаем свойства, о которых уже говорили: `title`, `text`, `created_date`, `published_date` и `author`. Чтобы это сделать нам нужно определиться с типом полей (это текст? число? дата? ссылка на другой объект? например, на пользователя?)
+
+- `models.CharField` -- так мы определяем текстовое поле с ограничением на количество символов.
+- `models.TextField` - так определяется поле для неограниченно длинного текста. Выглядит подходящим для содержимого поста, верно?
+- `models.DateTimeField` -- дата и время.
+- `models.ForeignKey` -- ссылка на другую модель.
+
+Мы не будем объяснять каждый участок кода, поскольку на это уйдет слишком много времени. Ознакомься с официальной документаций Django — если хочешь узнать больше о полях моделей и о том как определять разные объекты, то эта ссылка может помочь: (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+Как насчет `def publish(self):`? Это как раз метод `публикации` для записи, о котором мы говорили. `def` означает, что создаётся функция/метод, а `publish` — это название этого метода. Можно изменить имя метода, если хочешь. Существует правило для имён функций: нужно использовать строчные буквы, а пробелы заменять на подчёркивания. Например метод, вычисляющий среднюю цену может называться `calculate_average_price`.
+
+Методы часто `возвращают` что-то. Например, метод `__str__`. В наше случае, после вызова метода `__str__()` мы получим текст (**строку**) с заголовком записи.
+
+Также заметь, что оба метода `def publish(self):` и `ef __str__(self):` расположены с отступом внутри нашего класса. Поскольку Python чувствителен к пробелы, нам нужно использовать отступы для методов внутри класса. В противном случае методы не будут принадлежать к классу, и вы можете получить некоторое неожиданное поведение.
+
+Если тема моделей тебе до сих пор непонятна -- не стесняйся обратиться к тренеру! Мы знаем, что она действительно сложна, особенно когда ты изучаешь параллельно что такое объекты и функции. Но мы надеемся, что все это кажется тебе теперь не магией!
+
+### Создаем таблицы моделей в базе данных
+
+Последним шагом будет добавление нашей модели в базу данных. Сначала мы должны дать Django знать, что сделали изменения в нашей модели (мы её только что создали. (Мы только что создали его!) Перейдите в окно консоли и тип `python manage.py makemigrations blog`. Должно получиться примерно так:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Примечание:** Не забудьте сохранить файлы, которые вы редактировали. В противном случае ваш компьютер будет выполнять предыдущие версии, которые могут вызвать неожиданные сообщения об ошибках.
+
+Django создал для нас файл с миграцией для базы данных. Набери `python manage.py migrate blog`, результат должен быть следующим:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Ура! Модель записи для блога теперь в базе данных, было бы неплохо посмотреть на неё, верно? Тогда переходи к следующей главе!
\ No newline at end of file
diff --git a/ru-RU/django_orm/README.md b/ru-RU/django_orm/README.md
new file mode 100644
index 00000000000..f7fedb2fbca
--- /dev/null
+++ b/ru-RU/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM и QuerySet
+
+В этой главе ты узнаешь как Django подключается к базе данных и сохраняет в неё информацию. Давай начнем!
+
+## Что такое QuerySet?
+
+QuerySet, по сути, список объектов заданной модели. QuerySet позволяет читать данные из базы данных, фильтровать и изменять их порядок.
+
+Проще научиться на примере. Давай попробуем, согласна?
+
+## Интерактивная консоль Django
+
+Открой свой локальный терминал (не на PythonAnywhere), и набери следующую команду:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Результат должен быть таким:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Ты находишься в интерактивной консоли Django. По сути, это та же интерактивная консоль Python, но с дополнительной магией от Django :). Здесь ты также можешь использовать весь синтаксис Python, разумеется.
+
+### Все объекты
+
+Давай попробуем вывести на экран все записи в нашем блоге. Ты можешь сделать это следующей командой:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Упс! Появилось сообщение об ошибке. Она говорит, что не существует объекта с именем Post. И это верно -- мы забыли импортировать его!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+Все просто: мы импортируем модель `Post` из `blog.models`. Давай попробуем получить все записи блога еще раз:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Это список записей, с которыми мы работали до этого! Мы создали их через панель администратора Django. Теперь же, мы хотим создавать записи через Python, так как же мы этого добьемся?
+
+### Создаем объект
+
+Создать объект Post в базе данных можно следующим образом:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Но у нас есть один недочет: `me`. Мы должны передать этой переменной экземпляр модели `User`, который будет отвечать за автора записи. Как это сделать?
+
+Давай импортируем модель user для начала:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Какие пользователи есть в нашей базе данных? Попробуй эту команду:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+Это же суперюзер, которого мы создали ранее! Теперь давай создадим экземпляр пользователя (скорректируй эту строку под свое собственное имя пользователя):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Как ты видишь, теперь мы`get` `User` с именем `username`, которое равно "ola". Аккуратно!
+
+Теперь мы наконец можем создать наш пост:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Ура! Хочешь проверить, что все работает?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Есть, еще один пост в списке!
+
+### Добавляем записи
+
+Можешь немножко повеселиться и добавить еще записей, чтобы увидеть как система работает. Добавь 2 или 3, затем переходи к новой части.
+
+### Фильтрация объектов
+
+Важной особенностью QuerySets является возможность фильтровать объекты. Предположим, нам нужно найти все записи пользователя ola. Мы используем метод `filter` вместо метода `all` в `Post.objects.all()`. В кавычках мы укажем условия, по которым будет построена выборка записей. В нашей ситуации условием будет являться равенство поля `author` переменной `me`. В Django мы можем написать это следующим образом: `author=me`. Теперь наш код выглядит следующим образом:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+А может быть мы хотим получить все записи, содержащие слово 'title' в поле `title`?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Примечание**: Обрати внимание на два символа нижнего подчеркивания (`_`) между `title` и `contains`. Django's ORM использует этот синтаксис для разделения имен полей ("title") и операций или фильтров ("contains"). Если ты используешь только один символ нижнего подчеркивания, то получишь ошибку "FieldError: Cannot resolve keyword title_contains".
+
+Ты также можешь получить список всех опубликованных записей. Мы просто отфильтруем записи по полю `published_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+К сожалению, пост, который мы добавили в консоли Python еще не опубликован. Мы можем изменить это! Сначала выберем запись, которую мы хотим опубликовать:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+Дальше мы опубликуем её с помощью метода `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Теперь попробуй получить список опубликованных сообщений снова (нажмите стрелку вверх 3 раза и затем `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Сортировка объектов
+
+QuerySets позволяет сортировать объекты. Давай попробуем сортировку по полю `created_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Мы также можем изменить порядок на противоположный, добавив `-` в начало условия:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Сложные запросы при помощи цепочки вызовов
+
+Как ты видела, некоторые методы в `Post.objects` возвращают QuerySet. Эти же методы можно снова вызвать на QuerySet и они вернут уже новый QuerySet. Таким образом ты можешь комбинировать их эффект по цепочке **связывая** вместе:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Это — мощный и удобный инструмент, позволяющий писать сложные запросы.
+
+Отлично! Теперь ты готова к следующей части! Чтобы закрыть интерактивную консоль, набери:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ru-RU/django_start_project/README.md b/ru-RU/django_start_project/README.md
new file mode 100644
index 00000000000..58ea3d8a913
--- /dev/null
+++ b/ru-RU/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Твой первый проект на Django!
+
+> Часть этой главы основана на учебных пособиях Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Отдельные части этой главы основаны на учебном пособии [django-marcador ](http://django-marcador.keimlink.de/), лицензированном под Creative Commons Attribution-ShareAlike 4.0 International License. Руководство django-marcador защищено авторским правом Markus Zapke-Gründemann et al.
+
+Давайте сделаем небольшой блог!
+
+Первый шаг — создать новый проект Django. Попросту, это значит что мы запустим несколько стандартных скриптов из поставки Django, который создадут для нас скелет проекта. Это просто куча каталогов и файлов, которые мы будем использовать позже.
+
+Имена этих каталог и файлов очень важны для Django. Ты не должна переименовывать их. Перемещать их в другое место тоже не самая удачная идея. Django необходима определенная структуру, чтобы иметь возможность найти важные вещи.
+
+> Не забудьте: вы должны запускать все команды в virtualenv. Если ты не видишь в командной строке префикс `(myvenv)`, то необходимо активировать virtualenv. Мы объясняли как это сделать в разделе **Работаем с virtualenv** главы **Установка Django**. Для этого нужно набрать `myvenv\Scripts\activate` в Windows или `source myvenv/bin/activate` в Mac OS / Linux.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+В консоли Mac OS или Linux нужно запустить следующую команду; **не забудьте добавить точку `.` в конце**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> `.` Точка крайне важна, потому что говорит скрипту устанавливать Django в вашем текущем каталоге (который и обозначается сокращённо точкой `.`).
+> 
+> **Примечание** При вводе команд выше, помните что вам нужно набирать только часть, начинающуюся с `django-admin`. (myvenv) ~/djangogirls$ и `(myvenv) C:\Users\Name\djangogirls` — это просто примеры строк-приглашений терминала для последующего ввода команд.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+В Windows тебе необходимо запустить следующую команду **(Не забудь добавить точку `.` в конце)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> `.` Точка крайне важна, потому что говорит скрипту устанавливать Django в вашем текущем каталоге (который и обозначается сокращённо точкой `.`).
+> 
+> **Примечание** При вводе команд выше, помните что вам нужно набирать только часть, начинающуюся с `django-admin.exe`. (myvenv) ~/djangogirls$ и `(myvenv) C:\Users\Name\djangogirls` — это просто примеры строк-приглашений терминала для последующего ввода команд.
+
+<!--endsec-->
+
+`django-admin.py` это скрипт, который создаст необходимую структуру директорий и файлы для нас. Ты должна теперь иметь следующую структуру проекта:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Примечание**: в структуре каталогов, вы также увидите ваш `venv` каталог, который мы создали раньше.
+
+`manage.py` это скрипт, который помогает управлять сайтом. С помощью него мы сможем запустить веб-сервер на твоем компьютере без установки дополнительных программ.
+
+Файл `settings.py` содержит настройки для твоего веб-сайта.
+
+Помнишь нашу аналогию с почтальоном? Файл `urls.py` содержит список шаблонов, по которым ориентируется `urlresolver`.
+
+Давай пока забудем про остальные файлы - мы не будем их изменять. Только не удали их случайно!
+
+## Изменяем настройки
+
+Давай внесем изменения в `mysite/settings.py`. Открой файл в текстовом редакторе, который ты выбрала ранее.
+
+**Примечание**: Имейте в виду, что `settings.py` является обычным файлом, как и любой другой. Вы можете открыть его из редактора кода, используя «файл-> открыть» меню действия. Вы должны попасть в привычное окно программы, в котором можно перейти к файлу `settings.py` и выбрать его. Кроме того можно открыть файл, перейдя к папке djangogirls на вашем рабочем столе и щелкнув правой кнопкой мыши на файле. Затем выберите ваш редактор кода из списка. Выбор редактора имеет важное значение, так как, возможно, у вас имеются другие установленные программы, которыми можно открыть файл, но нельзя редактировать его.
+
+Было бы неплохо установить корректный часовой пояс на нашем сайте. Перейди к [Списку часовых поясов Википедии](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) и скопируй соответствующий вам часовой пояс (TZ) (например, `Europe/Berlin`).
+
+В файле settings.py найди строку, содержащую `TIME_ZONE`, и модифицируй её в соответствии со своим часовым поясом. Например:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+Код языка состоят из языка, например `en` для английского или `de` для немецкого языка и код страны, например `de` для Германии или `ch` для Швейцарии. Если английский - это не ваш родной язык, то можно добавить язык, чтобы изменить кнопки по умолчанию и уведомления с Django на ваш родной языке. Таким образом, кнопка «Отмена» будет переведена на язык, который вы определили здесь. [Django предоставляет множество готовых переводов](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+Если вам нужен другой язык, измените код языка, изменив следующую строку:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Также необходимо добавить путь (path) для статичных файлов (static files). (Со статических файлах и CSS мы разберемся чуть позже в тьюториале.) Иди вниз к *концу* файла, и прямо под `STATIC_URL` данными, добавь новые `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Когда `DEBUG` установлен в значение `True` и `ALLOWED_HOSTS` не установлен, то хост располагается на `['localhost', '127.0.0.1', '[::1]']`. Это не соответствуют нашему имени хоста на PythonAnywhere после того, как мы развернули наше приложение, поэтому мы поменяем следующие настройки:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Примечание**: Если ты используешь Chromebook, то добавь эту строку в конец своего settings.py файла: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Также добавь `.amazonaws.com` в `ALLOWED_HOSTS` если используешь cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Создание базы данных
+
+Существует множество различных баз данных, которые могут хранить данные для твоего сайта. Мы будем использовать стандартную -- `sqlite3`.
+
+Она уже выбрана по умолчанию в файле `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Чтобы создать базу данных для нашего блога, набери в командной строке следующее: `python manage.py migrate` (мы должны быть в директории `djangogirls`, где расположен файл `manage.py`). Если все прошло успешно, то ты увидишь следующий результат:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+И мы закончили! Пришло время запустить веб-сервер и посмотреть работает ли наш веб-сайт!
+
+## Запуск веб-сервера
+
+Ты должна быть в директории, где расположен файл `manage.py` (в нашем случае -- `djangogirls`). Запустим веб-сервер из командной строки: `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Если вы работаете на Хромбуке, то используйте эту команду:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> Мы сделали обзор того, как работает веб-сервер в главе **Как работает Интернет**.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ru-RU/django_templates/README.md b/ru-RU/django_templates/README.md
new file mode 100644
index 00000000000..a3e33fae889
--- /dev/null
+++ b/ru-RU/django_templates/README.md
@@ -0,0 +1,108 @@
+# Шаблоны Django
+
+Пришло время отобразить данные на сайте! Django поможет нам с этим при помощи встроенных **тегов шаблонов**.
+
+## Что представляют из себя теги шаблонов?
+
+Как видишь, в HTML нельзя помещать код Python, поскольку браузеры не понимают его. Они знают только HTML. Мы помним, что HTML статичен, в то время как Python позволяет делать динамические изменения.
+
+**Теги шаблонов Django** позволяют нам вставлять Python в HTML, так что ты можешь создавать динамические веб-сайты быстрее и проще. То что надо!
+
+## Отображаем шаблон списка записей
+
+В предыдущей главе мы передали нашему шаблону список записей в переменной `posts`. Теперь мы отобразим его в HTML.
+
+Чтобы вставить переменную в шаблон Django, нам нужно использовать двойные фигурные скобочки с именем переменной внутри:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Попробуй это в шаблоне `blog/templates/blog/post_list.html`. Открой это в редакторе кода и замени все со второй `<div>` до третьего `</div>` на `{{ posts }}`. Сохрани файл и обнови страницу, чтобы увидеть результат:
+
+![Рисунок 13.1](images/step1.png)
+
+Как ты можешь заметить, мы получили следующую строку:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Это показывает, что Django понял переменную как список объектов. Помнишь из главы **Введение в Python** как мы можем аккуратно отобразить список? Правильно, циклом for! В шаблонах Django ты можешь использовать их таким образом:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Попробуй вставить это в свой шаблон.
+
+![Рисунок 13.2](images/step2.png)
+
+Сработало! Но мы хотим, чтобы они отображались как статические записи, которые мы создавали в главе **Введение в HTML**. ты можешь смешивать HTML и теги шаблонов. Наш элемент `body` будет выглядеть следующим образом:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Всё что ты поместишь между `{% for %}` и `{% endfor %}` будет повторено для каждого объекта в списке. Обнови страницу:{% endraw %}
+
+![Рисунок 13.3](images/step3.png)
+
+Ты заметила, что мы использовали немного другую запись в этот раз `{{ post.title }}` или `{{ post.text }}`)? Мы обращаемся к различным полям нашей модели `Post`. Также `|linebreaks` прогоняет текст через фильтр, для преобразования переносов строк в параграфы.
+
+## Еще один момент
+
+Пришло время еще раз убедиться, что наш сайт будет работать в сети, согласна? Попробуем развернуть новую версию сайта на PythonAnywhere. Краткий обзор необходимых шагов...
+
+* Сначала загрузи свой код на GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Затем заходим на [PythonAnywhere](https://www.pythonanywhere.com/consoles/), открываем **Bash console** и набираем команду:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Не забудьте заменить `<your-pythonanywhere-domain>` на ваше имя пользователя PythonAnywhere, без угловых скобок.)
+
+* Наконец, переключись на вкладку [Web](https://www.pythonanywhere.com/web_app_setup/) и нажми кнопку **Reload**. (Чтобы перейти на другие страницы PythonAnywhere из консоли, используйте кнопку меню в верхнем правом углу.) Ваше обновление должно быть доступно на https://subdomain.pythonanywhere.com - проверьте его в браузере! Если сообщения в блоге на сайте PythonAnywhere не соответствуют сообщениям, появляющимся на блоге, размещенном на локальном сервере, то это нормально. Базы данных на локальном компьютере и на PythonAnywhere не синхронизируются с остальными вашими файлами.
+
+Поздравляем! Теперь иди вперед и попробуй добавить новую должность в Django admin (не забудь добавить published_date!) Убедись, что ты находишься на Django admin для твоего сайта pythonanywhere, https://subdomain.pythonanywhere.com/admin. Затем обнови свою страницу, чтобы увидеть, появляется ли там сообщение.
+
+Работает восхитительно? Мы гордимся тобой! Отойди от компьютера немного - ты заработала перерыв. 
+
+![Рисунок 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ru-RU/django_urls/README.md b/ru-RU/django_urls/README.md
new file mode 100644
index 00000000000..0f01a569fc9
--- /dev/null
+++ b/ru-RU/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+Мы собираемся создать нашу первую веб-страницу: домашнюю страницу для вашего блога! Но сначала давайте немного узнаем о URL-адресах Django.
+
+## Что такое URL-адрес?
+
+URL — это просто адрес в интернете. Ты можешь видеть URL каждый раз при посещении веб-сайта - он отображается в адресной строке. (Да! `127.0.0.1:8000` это URL-адрес! И `https://djangogirls.org` — тоже URL.)
+
+![URL](images/errorpng)
+
+Любая страница в Интернете нуждается в собственном URL-адресе. Таким образом, ваше приложение знает, что оно должно показать пользователю, который открывает этот URL-адрес. В Django, мы используем кое-что под названием `URLconf` (URL configuration). URLconf — это набор шаблонов, которые Django попробует сопоставить с полученным URL, чтобы выбрать правильный метод для отображения (view).
+
+## Как URL-адреса работают в Django?
+
+Давай откроем файл `mysite/urls.py` в нашем редакторе и посмотрим, как он выглядит:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Как можешь заметить, Django уже кое-что разместил здесь для нас.
+
+Строки между тройными кавычками (`'''` или `"""`) называются строчками документации - ты можешь написать их вверху файла, класса или метода, для того чтобы объяснить, что оно делает. Интерпретатор Python пропустит их при выполнении скрипта.
+
+URL-адрес администрирования, который мы посещали в предыдущей главе, уже здесь присутствует:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Эта черточка означает, что для каждого URL-адреса, начинающегося с `admin`, Django найдет соответствующий ему *view* (представление). В этом случае мы охватываем большое количество различных URL-адресов, которые явно не прописаны в этом маленьком файле -- так гораздо аккуратней и более читабельно.
+
+## Твой первый URL-адрес в Django!
+
+Пришло время создать твой первый URL-адрес! Мы хотим, чтобы 'http://127.0.0.1:8000/' возвращал домашнюю страничку нашего блога со списком записей в ней.
+
+Мы также хотим сохранить файл `mysite/urls.py` в максимально аккуратном виде, так что мы импортируем URL-адреса для нашего приложения `blog` в файл `mysite/urls.py`.
+
+Вперёд, добавь строку для импорта `blog.urls`. Обрати внимание, что здесь мы используем функцию `include`, поэтому тебе придется импортировать её в строке `from django.urls...`.
+
+Ваш файл `mysite/urls.py` должен выглядеть следующим образом:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django теперь будет перенаправлять все запросы 'http://127.0.0.1:8000/' к `blog.urls` и искать там дальнейшие инструкции.
+
+## blog.urls
+
+Создайте новый пустой файл с именем `urls.py` в каталоге `blog` и откройте его в редакторе кода. Хорошо! Добавьте эти две первые строки:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Так мы импортировали все методы Django `path` и все `views` (представления) из приложения `blog` (у нас их пока нет, но через минуту они появятся!)
+
+После этого мы можем добавить наш первый URL-шаблон:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+Как ты можешь заметить, мы связали `view` с именем `post_list` и корневой URL-адрес. Этот шаблон URL-адреса будет соответствовать пустой строке и URL распознаватель Django будет игнорировать имя домена (например, http://127.0.0.1:8000 /), с префиксом полного пути url. Этот шаблон скажет Django, что `views.post_list` — это правильное направление для запроса к твоему веб-сайту расположенного по адресу 'http://127.0.0.1:8000/'.
+
+Последняя часть `name='post_list'` — это имя URL, которое будет использовано чтобы идентифицировать представление (view). Оно может быть таким же, как имя представления (англ. view), а может и чем-то совершенно другим. Мы будем использовать именованные URL позднее в проекте, так что, важно указывать их имена в приложении уже сейчас. Мы также должны попытаться сохранить имена URL-адресов уникальными и легко запоминающимися.
+
+Если вы попытаетесь зайти на http://127.0.0.1:8000 теперь, то вы сможете увидите сообщение, что-то вроде «веб-страницы не доступны». Это потому, что сервер (Помните, набрав `runserver`?) больше не работает. Взгляните на окно консоли вашего сервера, чтобы выяснить, почему.
+
+![Ошибка](images/error1.png)
+
+Ваша консоль показывает ошибку, но не волнуйтесь – это на самом деле очень полезно: вам сообщают, что **no attribute 'post_list'** ("отсутствует атрибут 'post_list'"). Это имя *view*, что Django пытается найти и использовать, но мы его еще не создали. На данном этапе ваша `/admin/` также не будет работать. Не беспокойся, мы этим займемся. Если вы видите другое сообщение об ошибке, попробуйте перезагрузить веб-сервер. Для этого в окне консоли, где запущен веб-сервер, останови его нажатием клавиш Ctrl+C (клавиши Control и C вместе). В Windows можешь нажать Ctrl+Break. Затем тебе надо перезапустить веб-сервер при помощи команды `python manage.py runserver`.
+
+> Если хочешь узнать больше о Django URLconfs, посмотри официальную документацию: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ru-RU/django_views/README.md b/ru-RU/django_views/README.md
new file mode 100644
index 00000000000..7dbc0a3681c
--- /dev/null
+++ b/ru-RU/django_views/README.md
@@ -0,0 +1,44 @@
+# Представления (views) в Django – время создавать!
+
+Пришло время избавиться от ошибки, на которую мы наткнулись в прошлой главе! :)
+
+*view* это то место, где мы разместим "логику" работы нашего приложения. Оно запросит информацию из `модели`, которую мы создали ранее, и передаст её в `шаблон`. Шаблонами мы займёмся в следующей главе. Представления (views) это просто функции Python, которые лишь чуть сложнее чем те, которые мы написали в главе **Введение в Python**.
+
+Представления размещаются в файле `views.py`. Мы добавим свои *представления* в файл `blog/views.py`.
+
+## blog/views.py
+
+Хорошо, давай откроем этот файл в нашем редакторе кода и посмотрим на его содержимое:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Пока еще здесь есть немного содержимого.
+
+Помните, что строки, начиная с `#` - это комментарии; то есть это значит, что эти строки не будут работать на Python.
+
+Давайте создадим *представление* как комментарий. Добавьте следующее минимальное представление ниже:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Как видишь, мы создали метод (`def`) с именем `post_list`, который принимает `request` в качестве аргумента и `return` (возвращает) результат работы метода `render`, который соберет наш шаблон страницы `blog/post_list.html`.
+
+Сохрани файл, перейди по адресу http://127.0.0.1:8000/ и посмотри что у нас получилось.
+
+Другая ошибка! Читаем, что произошло:
+
+![Ошибка](images/error.png)
+
+Нам показывают, что сервер снова работает, по крайней мере; но ход его работы все еще выглядит неправильно, так ведь? Не стоит беспокоиться, это всего лишь страница ошибки, бояться нечего! Так же как и сообщения об ошибках в консоли, эти сообщения тоже полезны. Вы можете прочитать, что *TemplateDoesNotExist*. Давайте исправим эту ошибку и создадим шаблон в следующей главе!
+
+> Подробнее о представлениях в Django можно узнать из официальной документации: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ru-RU/dynamic_data_in_templates/README.md b/ru-RU/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..e9556f09d9c
--- /dev/null
+++ b/ru-RU/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Динамически изменяющиеся данные в шаблонах
+
+Отдельные части уже размещены в нужных местах: модель `Post`, определенна в файле `models.py`, `post_list` - в файле `views.py` и добавлен шаблон. Но как нам отобразить записи в шаблоне HTML-страницы? Ведь именно это нам мы и хотим добиться: взять определенный контент (модели, сохраненные в базе данных) и аккуратно отобразить их в шаблоне, верно?
+
+Для этого и предназначены *представления*: соединять между собой модели и шаблоны. В `post_list` *view* нужно будет взять модели, которые мы хотим отобразить и затем передать их шаблону. Таким образом, в *представлениях (view)* мы определяем что (какая модель) будет отображена в шаблоне.
+
+Хорошо, так как мы этого добьемся?
+
+Нам нужно открыть файл `blog/views.py` в редакторе кода. Так что *представление* `post_list` будет выглядеть следующим образом:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Помнишь мы говорили о включении кода из других файлов? Теперь нам нужно включить модель, которую мы определили в файле `models.py`. Мы добавим строку `from .models import Post` следующим образом:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+Точка перед `models` означает *текущую директорию* или *текущее приложение*. Оба файла `Views.py` и `models.py` находятся в одном и том же каталоге. Это значит, что мы можем использовать точку `.` и имя файла (без `.py`). Затем мы импортируем модель (`Post`).
+
+Но что дальше? Чтобы получить реальную запись из модели `Post`, нам нужен так называемый `QuerySet`.
+
+## QuerySet
+
+Ты уже должна быть знакома с принципом работы QuerySets. Мы говорили о нем в главе [Django ORM (QuerySets)](../django_orm/README.md).
+
+Сейчас вы хотим список записей блога, отсортированный по `published_date`, верно? Мы уже делали это в главе QuerySets!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Итак, давай откроем файл `blog/views.py` в редакторе кода, и добавим этот фрагмент кода в функцию `def post_list(request)` - но не забудь в начало файла добавить `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+Чтобы отобразить наш QuerySet в списке постов блога, осталось сделать всего две вещи:
+
+1. Передать `posts ` QuerySet в контекст шаблона, изменив вызов функции `render` (мы сделаем это прямо сейчас).
+2. Изменить шаблон для отображения `posts` QuerySet (мы разберемся с этим чуть позже).
+
+Пожалуйста, обрати внимание, что мы создали *переменную* для QuerySet: `posts`. Можешь думать о неё как об имени для нашего QuerySet. Теперь мы можем обращаться к нему, используя имя.
+
+В функции `render` мы уже имеем параметр `request` (т.е. все что мы получим от пользователя в качестве запроса через Интернет) и файл шаблона `'blog/post_list.html'`). Последний параметр, который выглядит как `{}`, это место, куда мы можем добавить что-нибудь для использования в шаблоне. Мы должны задавать имена, передаваемым шаблону вещам (мы будем придерживаться `'posts'` прямо сейчас). :) В итоге параметр будет выглядеть следующим образом: `{'posts': posts}`. Обрати внимание, что часть перед `:` является строкой; её нужно обернуть в кавычки: `"`.
+
+В результате файл `blog/views.py` должен выглядеть следующим образом:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+Вот и все! Теперь пришло время перейти к шаблону и отобразить QuerySet на странице!
+
+Хочешь подробнее узнать о QuerySets в Django? Тогда тебе пригодится официальная документация: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ru-RU/extend_your_application/README.md b/ru-RU/extend_your_application/README.md
new file mode 100644
index 00000000000..a868e2d27ce
--- /dev/null
+++ b/ru-RU/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Расширяем свое приложение
+
+Мы уже выполнили часть необходимых шагов для создания веб-сайта: мы знаем как создать модель, URL, представление и шаблон. Мы также знаем как улучшить визуальный дизайн с помощью CSS.
+
+Время практики!
+
+Первое, что нам потребуется в блоге - страница для отображения конкретной записи, верно?
+
+У нас уже есть модель `Post`, так что нам не нужно добавлять дополнительный код в файл `models.py`.
+
+## Создадим в шаблоне ссылку на страницу поста
+
+Мы начнем с добавления ссылки внутри файла `blog/templates/blog/post_list.html`. Откройте его в редакторе кода, и сейчас он должен выглядеть следующим образом: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}Нам хотелось бы иметь ссылку с заголовка поста в списке на страницу подробной информации о посте. Давай изменим `<h2><a href="">{{ post.title }}</a></h2>` чтобы получилась ссылка на страницу с полным содержанием поста:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Самое время разобраться с загадочным `{% url 'post_detail' pk=post.pk %}`. Как можешь предположить, синтаксис `{% %}` означает использование тегов шаблонов Django. На этот раз мы используем тот, что создаст для нас URL!{% endraw %}
+
+Часть `post_detail` означает, что Django будет ожидать URL в `blog/urls.py` с именем =post_detail
+
+А что же `pk=post.pk`? `pk` - это сокращение от первичного ключа (primary key), которое является уникальным идентификатором для каждой записи в базе данных. Каждая Django модель имеет поле, которое служит своим первичным ключом, и любое другое имя, которое оно имеет, так же можно назвать как "pk". Поскольку мы не определили специальный primary key в нашей модели `Post`, Django создаст его для нас (по умолчанию это будет число, которое увеличивается на единицу для каждой записи, например 1, 2, 3) и добавит его в поле с именем `pk` для каждой из наших записей. Мы получаем доступ к первичному ключу напечатав `post.pk`, таким же образом мы получаем доступ и к другим полям (`title`, `author`, и т.д.) в нашем объекте `Post`!
+
+Теперь, когда мы перейдем по адресу http://127.0.0.1:8000/ мы получим ошибку (как и ожидается, поскольку у нас нет прописанного URL и *view* для `post_detail`). Она будет выглядеть следующим образом:
+
+![NoReverseMatch ошибка](images/no_reverse_match2.png)
+
+## Создадим URL для страницы поста
+
+Давай создадим URL в `urls.py` для *представления* `post_detail`!
+
+Мы хотим, чтобы адрес страницы нашего первого поста был таким: **URL**: http://127.0.0.1:8000/post/1/
+
+Давай создадим URL в файле `blog/urls.py` и укажем Django на *представление* под названием `post_detail`, которое будет отображать пост целиком. Открой файл `blog/urls.py` в редакторе кода и добавь строку `path('post/<int:pk>/', views.post_detail, name='post_detail'),` так, что файл должен выглядить следующим образом:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+Эта часть `post/<int:pk>/` указывает шаблон URL-адреса – далее мы объясним это для тебя:
+
+- `post/` означает, что URL-адрес должен начинаться со слова **post** и далее следует **/**. Пока все в порядке.
+- `<int:pk>`– эта часть сложнее. Она означает, что Django ожидает целое числовое значение и передаст его в представление как переменную с именем `pk`.
+- `/`- затем нам нужно **/** снова, до окончания URL-адреса.
+
+Это значит, что если ты введешь адрес `http://127.0.0.1:8000/post/5/` в браузер, Django должен понять, что тебе требуется *view* с именем `post_detail`, и передать информацию о переменной `pk` (равной `5`) этому *view*.
+
+ОК мы добавили новый шаблон URL-адреса для `blog/urls.py`! Давайте обновите страницу: http://127.0.0.1:8000 / Бууум! Сервер снова остановил работу. Посмотрим в консоль – как и ожидалось, теперь еще есть другая ошибка!
+
+![AttributeError](images/attribute_error2.png)
+
+Помнишь, каким должен быть следующий шаг? Конечно: добавить представление!
+
+## Добавим представление для страницы поста
+
+В этот раз наше *view* получит дополнительный параметр `pk`. Но как дать нашему *view* знать о нем? Для этого мы определим функцию как `def post_detail(request, pk):`. Обрати внимание, что параметр должен иметь точно такое же имя как, мы выбрали для обработки `urls` (`pk`). Также обрати внимание, что и пропуск переменной будет неправилен и приведет к ошибке!
+
+Теперь мы хотим получить одну конкретную запись из блога. Для того, чтобы сделать это,мы можем использовать набор запросов (querysets), например такой:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Однако в этом коде есть проблема. Если не существует экземпляра объекта `Post` с заданным `primary key` (`pk`) мы получим очень страшную ошибку!
+
+![DoesNotExist ошибка](images/does_not_exist2.png)
+
+Мы этого не хотим! К счастью, Django, конечно, имеет средство, которое позволит нам её обойти: `get_object_or_404`. В случае, если не существует экземпляра объекта `Post` с заданным `pk`, мы получим намного более приятную страницу (которая называется `Page Not Found 404`.
+
+![Страница не найдена](images/404_2.png)
+
+Хорошая новость в том, что ты можешь сделать свою собственную страницу `Page not found`, и сделать ее достаточно привлекательной на свой вкус. Но для нас сейчас это не самая важная задача, и поэтому мы её пропустим.
+
+Хорошо, пришло время добавить *view* в файл `views.py`!
+
+В `blog/urls.py` мы создали URL-правило с именем `post_detail`, которое отсылает в представление, названное `views.post_detail`. Это означает, что Django будет ожидать представления функция с именем `post_detail` внутри `blog/views.py`.
+
+Пришло время открыть `blog/views.py` файл в редакторе кода и добавить следующие строки рядом со строками `from`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+И в конце файла мы добавим наше *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Да. Пришло время обновить страницу: http://127.0.0.1:8000/
+
+![Post list view](images/does_not_exist2.png)
+
+Заработало! Только что произойдет, если ты попробуешь перейти по ссылке из заголовка записи?
+
+![TemplateDoesNotExist ошибка](images/does_not_exist2.png)
+
+Ой, нет! Другая ошибка! Но мы уже знаем как с ней справиться, верно? Нам нужно добавить шаблон!
+
+## Создадим шаблон для страницы поста
+
+Мы создадим файл `post_detail.html` в директории `blog/templates/blog`, и откроем его в редакторе кода.
+
+Набери следующий код:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+И снова мы расширяем `base.html`. В блоке `content` мы отображаем дату публикации (published_date, если она существует), заголовок и текст. Нам также нужно обсудить пару важных вещей, хорошо?
+
+{% raw %}`{% if ... %} ... {% endif %}` это тег шаблона, который мы можем использовать, если нам нужно что-то проверить. (Помнишь конструкцию `if ... else ..` из главы **Введение в Python**?) В этом сценарии мы хотим проверить, содержит ли `published_date` нашей записи данные или нет.{% endraw %}
+
+Отлично, можешь перезагрузить страницу и проверить пропала ли теперь ошибка `TemplateDoesNotExist`.
+
+![Post detail страница](images/does_not_exist2.png)
+
+Ура! Все работает!
+
+# Время развертывания!
+
+Было бы неплохо проверить, что веб-сайт все еще работает на PythonAnywhere, верно? Давай еще раз проведем развертывание.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Затем набери в [Bash консоли PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Не забудьте заменить `<your-pythonanywhere-domain>` на ваше имя пользователя PythonAnywhere, без угловых скобок.)
+
+## Обновление статических файлов на сервере
+
+Серверы, такие как PythonAnywhere любят обрабатывать "статичные файлы" (такие как CSS-файлы) отдельно от Python-файлов, потому что они могут оптимизировать их загружаться быстрее. В результате всякий раз, когда мы вносим изменения в наши CSS-файлы, нам нужно выполнить дополнительную команду на сервере, чтобы сказать ему обновить их. Команда называется `collectstatic`.
+
+Начните с активации вашего virtualenv, если она еще не активна (PythonAnywhere использует для этого команду под названием `workon`, это также как и `source myenv/bin/activate` команда, которую вы используете на вашем собственном компьютере):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+Команда `manage.py collectstatic` немного похожа `manage.py migrate`. Мы вносим некоторые изменения в наш код, а затем мы говорим Django чтобы он *применил* эти изменения для коллекции статических файлов на сервере, либо в базе данных.
+
+В любом случае, мы теперь готовы перепрыгнуть на ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (из меню кнопки в верхнем правом углу консоли) и кликнуть **Reload**, а затем смотри на страницу https://subdomain.pythonanywhere.com чтобы увидеть результат.
+
+Вот и все. Ты справилась!
\ No newline at end of file
diff --git a/ru-RU/how_the_internet_works/README.md b/ru-RU/how_the_internet_works/README.md
new file mode 100644
index 00000000000..b349ca95faf
--- /dev/null
+++ b/ru-RU/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Как работает Интернет
+
+> Для занимающихся дома: эта глава освещена в видео [Как работает Интернет](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> Эта глава основана на выступлении «Как работает Интернет» Джессики Маккеллар (http://web.mit.edu/jesstess/www/).
+
+Можем поспорить, что ты пользуешься Интернетом каждый день. Но знаешь ли ты на самом деле, что происходит после ввода адреса, такого как https://djangogirls.org, в браузер и нажатия `Enter`?
+
+Первое, что тебе нужно понять, это то, что веб-сайт представляет собой просто группу файлов, сохраненных на жестком диске. Тем не менее, есть одна особенность, которая является уникальной для сайтов: они содержат компьютерный код, называемый HTML.
+
+Если ты не знакома с программированием, то сначала может быть трудно понять HTML, но твой веб-браузер (например, Chrome, Safari, Firefox, и т. д.) обожает его. Веб-браузеры созданы для того чтобы понимать этот код, следовать его указаниям и представлять файлы, из которых состоит твой веб-сайт, именно так, как ты этого хочешь.
+
+Как и с любым файлом, нам нужно хранить HTML файлы где-то на жестком диске. Для Интернета мы используем специальные мощные компьютеры, называемые *серверами*. У них нет экрана, мыши или клавиатуры, потому что их основной целью является хранение и обслуживание данных. Вот почему они называются *серверами*--потому что они *обслуживают* (serve) твои данные.
+
+ОК, но ты ведь хочешь знать, как выглядит Интернет, так?
+
+Мы нарисовали тебе картинку! Он выглядит вот так:
+
+![Рисунок 1.1](images/internet_1.png)
+
+Довольно беспорядочно, правда? На самом деле, это сеть связанных машин (упомянутых выше *серверов*). Сотен тысяч машин! Много, много километров кабелей по всему миру! Ты можешь посетить веб-сайт с картой подводных кабелей (http://submarinecablemap.com/), чтобы увидеть, насколько сложной является сеть. Вот скриншот с сайта:
+
+![Рисунок 1.2](images/internet_3.png)
+
+Поразительно, не так ли? Однако, очевидно, что невозможно соединить кабелем каждую машину, подключенную к Интернету. Таким образом, чтобы достичь нужной машины (например, хранящей https://djangogirls.org), мы должны передать запрос через множество других машин.
+
+Это выглядит приблизительно так:
+
+![Рисунок 1.3](images/internet_2.png)
+
+Представь себе, что когда ты вводишь https://djangogirls.org, то отправляешь письмо, в котором говорится: «Дорогие Django Girls, я хочу увидеть сайт djangogirls.org. Отправьте мне его, пожалуйста!»
+
+Твое письмо отправляется в ближайшее почтовое отделение. Затем оно направляется в другое, которое немного ближе к адресату, а затем в следующее и так далее до его доставки в пункт назначения. Единственное отличие в том, что при отправке множества писем (*пакетов данных*) по одному адресу, каждое из них может пойти через совершенно разные почтовые отделения (*маршрутизаторы*). Это зависит от того, как они были распределены в каждом отделении.
+
+![Рисунок 1.4](images/internet_4.png)
+
+Да, так это и работает - ты отправляешь сообщения и ждешь ответа. Конечно, вместо бумаги и ручки используются байты данных, но идея та же!
+
+Вместо адресов с названием улицы, города, почтового индекса и названия страны мы используем IP-адреса. Твой компьютер сначала просит DNS (Domain Name System) перевести djangogirls.org в IP-адрес. Это работает примерно как в случае старых телефонных книг, где можно по имени человека, с которым ты хочешь связаться, найти его номер телефона и адрес.
+
+Когда ты отправляешь письмо, оно должно обладать определенными особенностями, чтобы его доставили правильно: адресом, маркой и т. д. Ты также используешь язык, который понимает получатель, верно? То же самое относится к *пакетам данных*, которые ты отправляешь, чтобы увидеть веб-сайт. Мы используем протокол под названием HTTP (англ. HyperText Transfer Protocol, протокол передачи гипертекста).
+
+Поэтому, в принципе, когда у тебя есть веб-сайт, то необходимо иметь и *сервер* (машину), где он находится. Когда *сервер* получает входящий *запрос* (в письме), он отправляет обратно твой веб-сайт (в другом письме).
+
+Поскольку это руководство по Django, разумно будет спросить -- что же он делает в этой системе. Когда ты отправляешь ответ, то ты не всегда хочешь отправлять одно и то же письмо всем получателям. Намного лучше, если твои письма являются персонифицированными, особенно для человека, который только что сам тебе написал, правильно? Django помогает нам с созданием этих персонализированных, интересных писем. :)
+
+Ну, хватит болтать, пришло время творить!
\ No newline at end of file
diff --git a/ru-RU/html/README.md b/ru-RU/html/README.md
new file mode 100644
index 00000000000..46dc28d60c8
--- /dev/null
+++ b/ru-RU/html/README.md
@@ -0,0 +1,227 @@
+# Введение в HTML
+
+Так что же это за шаблон, ты можешь спросить.
+
+Шаблон -- это файл, который мы можем использовать повторно для отображения различной информации в заданном формате, например, ты можешь использовать шаблон, чтобы упростить написание письма, поскольку письма хоть и различаются по содержанию и получателю, но сохраняют общую структуру.
+
+Шаблоны в Django написаны на языке, называемом HTML (это тот HTML, о котором было упоминание в первой главе **Как работает Интернет**).
+
+## Что такое HTML?
+
+HTML -- это простой код, который может быть интерпретирован твоим браузером -- таким как Chrome, Firefox или Safari -- чтобы отобразить веб-страницу пользователю.
+
+HTML (от англ. "HyperText Markup Language") - язык гипертекстовой разметки. **Гипертекст** - это тип текста, поддерживающий гиперссылки между страницами. Под **Разметкой** понимается введение в документ кода, который будет сообщать браузеру как правильно отобразить страницу. HTML код строится при помощи **тегов**, каждый из которых начинается символом `<` и заканчивается - `>`. Эти теги представляют **элементы** разметки.
+
+## Твой первый шаблон!
+
+Создание шаблона означает создание файла шаблона. Все есть файл, верно? Ты уже заметила это, наверно.
+
+Шаблоны сохраняются в директории `blog/templates/blog`. Для начала создай директорию `templates` внутри папки blog. Затем создай другую директорию `blog` внутри папки templates:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(Ты, вероятно, можешь задаться вопросом: зачем нам нужны две директории с одинаковым названием `blog` - как ты узнаешь позже, это просто удобное соглашение об именовании, которое делает жизнь проще, когда вещи серьезно усложняются.)
+
+Теперь создай файл `post_list.html` (для начала оставь его пустым) внутри директории `blog/templates/blog`.
+
+Посмотри как выглядит твой веб-сайт после этого: http://127.0.0.1:8000/
+
+> Если возникает ошибка `TemplateDoesNotExist`, попробуй перезапустить сервер. Перейди в командную строку, останови веб-сервер нажатием Ctrl+C (Ctrl и С одновременно) и запусти его снова командой `python manage.py runserver`.
+
+![Рисунок 11.1](images/step1.png)
+
+Ошибки больше нет! Молодец! :) Однако, твой сайт пока отображает пустую страницу, так как твой шаблон пуст. Нужно это исправить.
+
+Открой новый файл в текстовом редакторе и добавь следующее:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+Как теперь выглядит твой веб-сайт? Перейди сюда, чтобы узнать: http://127.0.0.1:8000/
+
+![Рисунок 11.2](images/step3.png)
+
+Сработало. Хорошо постаралась! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head и body
+
+Каждая HTML-страница также делится на два элемента: **head** и **body**.
+
+* **head** -- это элемент, содержащий информацию о документе, которая не отображается на экране.
+
+* **body** -- это элемент, который содержит все, что будет отражено на веб-странице.
+
+Мы используем тег `<head>` чтобы сообщить браузеру о настройках страницы и тег `<body>` - о её содержимом.
+
+Например, ты можешь разместить заголовок веб-страницы между тегов `<head>`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Сохрани файл и обнови страницу.
+
+![Рисунок 11.3](images/step4.png)
+
+Видишь, как браузер понял, что "Ola's blog" -- это заголовок страницы? Он понял `<title>Ola's blog</title>` и разместил текст в заголовке вкладки в твоем браузере (заголовок также будет использоваться при сохранении закладок и т.п.).
+
+Вероятно, ты уже заметила, что каждый открывающий тег имеет пару -- *закрывающий*, с символом `/`, элементы таким образом становятся *вложенными* (ты не можешь закрыть тег, пока остаются открытыми теги внутри него).
+
+Это как складывать вещи в коробки. У нас есть одна большая коробка, `<html></html>`; внутри неё лежит коробка `<body></body>`, которая содержит еще меньшие коробки: `<p></p>`.
+
+Ты должна следовать этим правилам *закрытия* тегов и *вложенности* элементов, если ты станешь их нарушать - браузер не сможет интерпретировать код и корректно отобразить страницу.
+
+## Настраиваем шаблон
+
+Ты можешь немного повеселиться сейчас и попробовать настроить шаблон по своему вкусу! Вот несколько полезных тегов:
+
+* `<h1>Заголовок</h1>` - главный заголовок страницы
+* `<h2>Подзаголовок</h2>` для заголовков второго уровня
+* `<h3>Заголовок третьего уровня</h3>` ... и так далее, вплоть до `<h6>`
+* `<p>Текстовый параграф</p>`
+* `<em>текст</em>` подчеркивает твой текст
+* `<strong>текст</strong>` - жирный шрифт
+* `<br>` переход на следующую строку (внутрь br тега нельзя ничего поместить и закрывающий тег отсутствует)
+* `<a href="https://djangogirls.org">link</a>` создает ссылку
+* `<ul><li>первый элемент</li><li>второй элемент</li></ul>` создает список, такой же как этот!
+* `<div></div>` определяет раздел страницы
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Вот пример полного шаблона, скопируйте и вставьте его в `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Это даст нам следующий эффект:
+
+![Рисунок 11.4](images/step6.png)
+
+Ура! Однако, до сих пор наш шаблон отображал лишь **одну и ту же информацию** - тогда как раньше мы говорили, что шаблоны позволяют нам отображать **различную** информацию в **одном и том же формате**.
+
+Что мы действительно хотим - это отображать существующие записи, добавленные через панель администратора Django, этим и займемся в следующий раз.
+
+## И ещё кое-что: публикация!
+
+Хотелось бы увидеть все это в живую в интернете, согласна? Давай проведем еще одно развертывание веб-сайта на PythonAnywhere:
+
+### Commit и push кода в репозиторий Github
+
+Во-первых, давай посмотрим, какие файлы были изменены с момента последнего развертывания (выполни эти команды локально, не на PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Убедись, что находишься в директории `djangogirls` и сообщи `git` выбрать все изменения в пределах этой папки:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add
+    
+
+Прежде чем мы загрузим файлы, давай проверим, что именно `git` будет загружать (все файлы, который `git` готов отправить на сервер отмечаются шрифтом зеленого цвета):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Мы почти у цели, пришло время сохранить изменения в истории. К сохраняемой версии мы приложим небольшое сообщение, в котором кратко опишем изменения. Можешь набрать в качестве сообщения все что захочешь, однако, полезно выбирать информативную запись, так будет проще вспомнить внесенные изменения в будущем.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Примечание** Убедись, что оборачиваешь комментарий в двойные кавычки. 
+
+После того, как мы сделали это, мы загрузим (сделаем push) изменения на Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Загружаем новый код на PythonAnywhere и перезапускаем веб-приложение
+
+* Открой вкладку ["терминалы"](https://www.pythonanywhere.com/consoles/) на PythonAnywhere и переключись на уже запущенную **консоль Bash** (или новую). Затем набери следующую команду:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+Не забудьте заменить `<your-pythonanywhere-domain>` на ваше имя пользователя PythonAnywhere, без угловых скобок. Ваше имя поддомена обычно является вашим именем пользователя на PythonAnywhere но в некоторых случаях оно может немного отличаться (например, если ваше имя пользователя содержит заглавные буквы). Так что если эта команда не работает, используйте команду `ls` (файлы списка) чтобы найти ваше фактическое имя поддомена/папки, а затем `cd` туда.
+
+Теперь наблюдайте как ваш код загружается. Если хочешь проверить, загрузился ли он, можешь перейти в **"Files" page** и посмотреть свой код на PythonAnywhere (можешь также переходить на другие страницы PythonAnywhere из кнопки меню на странице с консолью).
+
+* Наконец, переключись на вкладку [Web](https://www.pythonanywhere.com/web_app_setup/) и нажми кнопку **Reload** на своем веб-приложении.
+
+Обновления должны отобразиться на веб-сайте! Переключись на него и обнови страницу в браузере. Ты должна сразу заметить изменения. :)
\ No newline at end of file
diff --git a/ru-RU/installation/README.md b/ru-RU/installation/README.md
new file mode 100644
index 00000000000..16ddec1574d
--- /dev/null
+++ b/ru-RU/installation/README.md
@@ -0,0 +1,68 @@
+# Если ты занимаешься дома
+
+Если ты занимаешься по этому руководству дома, а не на одной из [встреч Django Girls](https://djangogirls.org/events/), то можешь пропустить этот раздел и сразу перейти к главе [Как работает интернет](../how_the_internet_works/README.md).
+
+Это потому, что мы раскрываем тему установок, так как они необходимы в тьюториалах -- это просто дополнительная страница, которая собирает все инструкции по установке в одном месте (что полезно для некоторых форматов воркшопов). Вы можете выбрать для установки все, что находится на этой странице прямо сейчас, если хотите. Но если ты хочешь начать обучение до установки программ на компьютер, пропусти эту главу. Мы будем объяснять все про установку по ходу руководства, по мере необходимости.
+
+Удачи!
+
+# Если вы посещаете семинар
+
+Если вы посещаете одно из мероприятий [Django Girls events](https://djangogirls.org/events/):
+
+* Ваш воркшоп может включать в себя «вечеринку установки» перед основным воркшопом. Если вы находитесь на вечеринке установки, эта страница именно для вас! Следуйте инструкциям здесь, чтобы получить все, что вам нужно установить для воркшопа, прибегайте к помощи тренеров при необходимости. Затем на основном воркшопе, вы сможете пропустить инструкции по установке; также вы будете встречаться с ними в основном тьюториале, когда вы его получите.
+* Организаторы вашего воркшопа могут попросить вас, чтобы вы попробовали у себя дома установить все на вашем компьютере до начала воркшопа. Если вас попросили сделать, эта страница именно для вас! Следуйте здесь инструкциям изо всех сил. Затем на основном воркшопе, когда вы получите шаги для установки в основном тьюториале, если вы не смогли установить какие-то элементы, то вы можете получить помощь от вашего наставника.
+* Если ваш воркшоп не проводит "вечеринку установки" (или вы не смогли присутствовать), и, если организаторы не просят вас установить все, прежде чем вы приехали; пропустите эту страницу и переходите прямо к главе [как Интернет работает](../how_the_internet_works/README.md). Вы будете устанавливать все, что вам нужно, так как вы работаете через тьюториал.
+
+# Установка
+
+В этом руководстве вы будете создавать блог. Для того чтобы сделать это, по ходу тьюториала вам будет поручено установить различные программы на вашем компьютере, и настроить некоторые учетные записи в сети, по мере их необходимости. Эта страница содержит в себе все инструкции по установке и регистрации (что полезно для некоторых форматов воркшопов).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Краткое введение в командную строку {#command-line}
+
+Многие из нижеследующих шагов ссылаются на "консоль", "терминал", "командное окно" или "командная строка" -- это означает то же самое: окно на компьютере, где вы можете ввести команды. Когда вы дойдете до главного руководства, вы узнаете больше о командной строке. Сейчас главное, что необходимо знать - как открыть окно команды и как оно выглядит: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Установка Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Установка редактора кода {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Настрока virtualenv и установка Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Установка Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Создание учётной записи на GitHub {#github-account}
+
+Иди на [GitHub.com](https://www.github.com) и зарегистрируй новый бесплатный аккаунт. Убедись, что запомнила свой пароль (добавь его в менеджер паролей, если пользуешься им).
+
+# Создание учётной записи на PythonAnywhere {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Начинай читать
+
+Поздравляем, всё готово к работе! Если у тебя ещё осталось немного свободного времени до семинара, было бы полезно прочитать несколько первых глав:
+
+* [Как работает Интернет](../how_the_internet_works/README.md)
+
+* [Знакомство с командной строкой](../intro_to_command_line/README.md)
+
+* [Введение в Python](../python_introduction/README.md)
+
+* [Что же такое Django?](../django/README.md)
+
+# Наслаждайся воркшопом!
+
+Когда начнется семинар, ты сможешь сразу перейти к главе [Твой первый проект на Django!](../django_start_project/README.md), так как ты уже освоила материал предыдущих глав.
\ No newline at end of file
diff --git a/ru-RU/intro_to_command_line/README.md b/ru-RU/intro_to_command_line/README.md
new file mode 100644
index 00000000000..199811865e6
--- /dev/null
+++ b/ru-RU/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Знакомство с командной строкой
+
+> Для тех, кто проходит руководство дома: о материале этой главы рассказывает видео [Ваш новый друг — командная строка](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+Вот это да! Всего через несколько минут ты напишешь свою первую строку кода! :)
+
+**Позволь представить нашего первого нового друга: командную строку!**
+
+Следующие шаги покажут, как использовать черное окно, которым пользуются все хакеры. Сначала оно может показаться немного пугающим, но, на самом деле, это просто окно, которое ждет от тебя команды.
+
+> **Примечание** Пожалуйста, обрати внимание, что в этом руководстве мы используем термины «каталог» и «папка» взаимозаменяемо: эти слова обозначают одно и то же.
+
+## Что такое командная строка?
+
+Окно, которое обычно называют **командной строкой** или **интерфейсом командной строки (англ. CLI, Command Line Interface)**, является текстовым приложением для просмотра, обработки и манипулирования файлами на вашем компьютере. Она делает то же, что и Проводник в Windows или Finder в Mac OS X, но у неё нет графического интерфейса. Другими названиями для командной строки являются: *cmd*, *CLI*, *prompt*, *консоль* или *терминал*.
+
+## Открываем интерфейс командной строки
+
+Для того, чтобы начать экспериментировать, нам нужно сначала открыть интерфейс командной строки.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Командная строка
+
+Теперь ты должна увидеть окно белого или черного цвета, которое ожидает команд.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Если у тебя Mac или Linux, ты, скорее всего, увидишь знак `$` в конце строки:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Если у тебя Windows, строка скорее всего будет оканчиваться символом `>`, вот так:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Можешь заглянуть в инструкцию для пользовательниц Linux чуть выше — нам что-то подобное ещё встретится, когда мы дойдём до PythonAnywhere.
+
+<!--endsec-->
+
+Перед каждой командой будет стоять знак `$` или `>` и пробел. Но тебе не нужно их печатать! Компьютер сделает это за тебя. :)
+
+> Небольшое примечание: перед курсором командной строки может быть написано что-то вроде `C:\Users\ola>` или `Olas-MacBook-Air:~ola$`. Это абсолютно нормально.
+
+То, что написано до знака `$` или `>`, плюс сам знак, всё вместе называется *приглашением командной строки*. Как правило, оно включает адрес папки, в которой ты сейчас находишься. Оно приглашает тебя ввести в окно команду.
+
+Далее в руководстве перед каждой командой, которую тебе нужно будет ввести, мы будем писать символ `$` или `>`. Иногда слева от него мы будем добавлять ещё немного текста. Не обращай внимания на левую часть и просто печатай команду — она начинается после символа приглашения.
+
+## Твоя первая команда (УРА!)
+
+Давай введём следующую команду:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+И затем нажми `Enter`. Вот что получилось:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami 
+    olasitarska
+    
+
+Как видишь, компьютер только что вывел на экран твоё имя пользователя. Классно, а? :)
+
+> Постарайся набирать каждую команду вручную, а не копировать и вставлять. Так ты больше запомнишь!
+
+## Основы
+
+В каждой операционной системе набор команд для командной строки немного отличается, поэтому не забывай следовать инструкциям для своей операционной системы. Давай попробуем, готова?
+
+### Текущий каталог
+
+Было бы неплохо знать, где мы находимся сейчас, верно? Давай посмотрим. Набери эту команду и нажми `Enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Примечание: 'pwd' означает 'print working directory' (вывести рабочий каталог).
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+Ты, вероятно, увидишь нечто похожее на своем компьютере. Когда ты открываешь командную строку, то обычно находишься в домашнем каталоге текущего пользователя.
+
+* * *
+
+### Как узнать больше о команде
+
+У многих команд для командной строки есть встроенная справка! Например, вот как узнать подробнее о команде, которая показывает, в какой папке ты сейчас находишься:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+В OS X и Linux есть команда `man` — справка о других командах (на английском языке). Набери `man pwd` и посмотри, что пишут о команде pwd. Используй `man` с другими командами, чтобы посмотреть для них справку. Как правило, справки `man` выводятся постранично. Нажми пробел, чтобы перейти на следующую страницу. Чтобы выйти, нажми `q`.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Чтобы вывести справку, почти к любой команде можно добавить `/?`. Чтобы прочитать всю справку, возможно, придётся прокрутить текст вниз. Попробуй набрать `cd /?`.
+
+<!--endsec-->
+
+### Список файлов и каталогов
+
+Так что же в нем? Было бы здорово узнать. Давайте посмотрим:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Смена текущего каталога
+
+Теперь вернемся в наш каталог рабочего стола:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Обрати внимание, что название каталога "Desktop" может быть переведено на язык твоей учётной записи в системе Linux. В таком случае набери вместо `Desktop` переводное название: например, `"Рабочий стол"` (в кавычках — они нужны, чтобы командная строка поняла кириллицу).
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Проверь, что рабочий каталог действительно изменился:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Вот и он!
+
+> Совет от профи: если ты введешь `cd D` и затем нажмешь `Tab` на клавиатуре, в командной строке будет автоматически набрана остальная часть имени, что позволит быстрее перемещаться по каталогам. Если c «D» начинается название не одной папки, нажми `Tab` дважды, чтобы получить список вариантов.
+
+* * *
+
+### Создание каталога
+
+Как насчет создания каталога practice на рабочем столе? Вы можете сделать это таким образом:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+Эта маленькая команда создаст папку с именем `practice` на рабочем столе. Ты можешь проверить, появилась ли она, просто взглянув на рабочий стол или введя команду `ls` (для Linux и macOS) или `dir` (если у тебя Windows)! Попробуй. :)
+
+> Совет от профи: если ты не хочешь вводить одни и те же команды снова и снова, попробуй нажать на стрелку вверх и стрелку вниз на клавиатуре для просмотра недавно использованных команд.
+
+* * *
+
+### Тренируемся!
+
+Небольшая задачка: в недавно созданной папке `practice` создай папку с названием `test`. Используй команды `cd` и `mkdir`
+
+#### Решение:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Поздравляем! :)
+
+* * *
+
+### Чистка
+
+Мы не хотим оставлять беспорядок, поэтому давай удалим все, что мы создали до этого момента.
+
+Во-первых, мы должны вернуться на рабочий стол:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd..
+    
+
+<!--endsec-->
+
+Используя `..` с командой `cd`, ты можешь сменить текущий каталог на родительский (то есть каталог, который содержит в себе текущий).
+
+Проверь, где ты находишься:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Пришло время удалить каталог `practice`:
+
+> **Внимание:** удаление файлов с помощью `del`, `rmdir` или `rm` необратимо. Это означает, что *удалённые файлы будут потеряны навсегда!* Поэтому будь очень осторожна с этими командами.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Готово! Давай проверим, что папка действительно удалена:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Выход
+
+Вот и всё на данный момент! Теперь можно безопасно закрыть командную строку. Давай сделаем это как хакеры, согласна? 
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Круто, да? :)
+
+## Подведём итоги
+
+Вот краткий обзор некоторых полезных команд:
+
+| Команда (Windows) | Команда (Mac OS / Linux) | Описание                | Пример                                              |
+| ----------------- | ------------------------ | ----------------------- | --------------------------------------------------- |
+| выход             | выход                    | Закрыть окно            | **выход**                                           |
+| cd                | cd                       | изменить каталог        | **cd test**                                         |
+| cd                | pwd                      | вывести текущий каталог | **cd** (Windows) или **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | список каталогов/файлов | **dir**                                             |
+| copy              | cp                       | копировать файл         | **copy c:\test\test.txt c:\windows\test.txt**   |
+| move              | mv                       | переместить файл        | **move c:\test\test.txt c:\windows\test.txt**   |
+| mkdir             | mkdir                    | создать новый каталог   | **mkdir testdirectory**                             |
+| rmdir (or del)    | rm                       | удалить файл            | **del c:\test\test.txt**                          |
+| rmdir /S          | rm -r                    | удалить папку           | **rm -r testdirectory**                             |
+| [CMD] /?          | man [CMD]                | справка для команды     | **cd /?** (Windows) или **man cd** (Mac OS / Linux) |
+
+Это лишь некоторые из команд, которые можно использовать в командной строке, но сегодня тебе больше и не пригодится.
+
+Если тебе интересно, [ss64.com](http://ss64.com) содержит полный справочник команд для всех операционных систем.
+
+## Готова продолжить?
+
+Давай погрузимся в мир Python!
\ No newline at end of file
diff --git a/ru-RU/intro_to_command_line/open_instructions.md b/ru-RU/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..a0b187be473
--- /dev/null
+++ b/ru-RU/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+В зависимости от твоей версии Windows и того, какая у тебя клавиатура, одно из следующих действий открое окно командной строки (возможно, придётся немного поэкспериментировать, но все варианты пробовать необязательно):
+
+- Перейди в меню Пуск (или на экран Пуск), в строке поиска набери "Командная строка".
+- Перейди в меню Пуск → Windows → Командная строка.
+- Перейди в меню Пуск → Все программы → Служебные → Командная строка.
+- Перейди на экран Пуск, наведи мышь на нижний левый угол экрана и нажми на стрелочку вниз, которая появится там. (Если у тебя тачскрин, листни пальцем снизу вверх.) Откроется страница "Приложения". Выбери пункт "Командная строка" в разделе "Windows".
+- Удерживая клавишу Windows на клавиатуре, нажми X. В появившемся меню выбери пункт "Командная строка".
+- Удерживая клавишу Windows, нажми R, чтобы появилось окно "Выполнить". Набери в строке cmd и нажми OK.
+
+![Набери "cmd" в окне "Выполнить"](../python_installation/images/windows-plus-r.png)
+
+В какой-то момент тебе понадобятся два окна командной строки одновременно. Однако в некоторых версиях Windows, если ты попытаешься запустить вторую командную строку, когда одна уже запущена тем же способом, ты вместо этого попадёшь в уже открытое окно командной строки. Попробуй у себя на компьютере и посмотри, что будет! Если у тебя получается открыть только одно окно командной строки, попробуй какой-нибудь другой из вышеприведённых способов в списке. По крайней мере один из них сможет открыть новое окно командной строки.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Перейди в Приложения → Прочие → Терминал.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Вероятно, командная строка скрывается по адресу: Приложения → Стандартные → Терминал или Приложения → Система → Терминал, но это может зависеть от конкретной системы. Если не сможешь найти — Google поможет :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ru-RU/python_installation/README.md b/ru-RU/python_installation/README.md
new file mode 100644
index 00000000000..a17b7ef99bf
--- /dev/null
+++ b/ru-RU/python_installation/README.md
@@ -0,0 +1,15 @@
+# Давай начнем работать с Python
+
+Мы, наконец-то, здесь!
+
+Для начала, позволь рассказать что такое Python. Python - это очень популярный язык программирования, который может использоваться для создания веб-сайтов, игр, научного программного обеспечения, графики и многого, многого другого.
+
+Python возник в конце 80-х годов, и его основной целью является быть удобным для чтения людьми (не только машинами!). Вот почему это выглядит проще, чем другие языки программирования, но не волнуйтесь – Python при этом еще и очень мощный!
+
+# Установка Python
+
+> **Примечание** Если вы используете Chromebook, пропустите эту главу и убедитесь, что следуете инструкции [Установка на Chromebook](../chromebook_setup/README.md).
+> 
+> **Примечание** Если ты уже выполнила установку, снова этого делать не нужно - смело приступай к следующей главе!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ru-RU/python_installation/instructions.md b/ru-RU/python_installation/instructions.md
new file mode 100644
index 00000000000..4d9585f0327
--- /dev/null
+++ b/ru-RU/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Для тех, кто занимается дома: эта глава описывается в видео [Установка Python и текстового редактора](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> Этот подраздел основан на руководстве Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django написан на Python. Нам нужен Python, чтобы сделать что-нибудь в Django. Давай начнем с его установки! Мы хотим, чтобы ты установила самую свежую версию Python 3, поэтому, если у тебя уже есть более ранняя версия, то её придется обновить. Если у тебя уже есть эта версия или повыше, то всё должно пройти нормально.
+
+Пожалуйста, установите обычный Python даже если Anaconda установлена на твоем компьютере.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Для начала проверь, какая версия Windows у тебя на компьютере — 32-битная или 64-битная. Это будет указано в строке «Тип системы» на странице «Сведения о системе». Чтобы попасть туда, попробуй один из этих способов:
+
+* Нажмите одновременно клавишу Windows и клавишу Pause/Break
+* Откройте панель управления из меню Windows, затем перейдите в Система & Безопасность, затем перейдите в Система
+* Нажми клавишу Windows, затем перейди по разделам Настройки > Система > О системе
+* Найдите пункт "Информация о системе" в меню Windows Start. Для этого нажмите на кнопку "Старт" на экране или кнопку со значком "Windows" на клавиатуре - и начните вводить "Информация о системе". По мере ввода на экране будут появляться подсказки. Как только в подсказке появится пункт "Информация о системе", нажмите на него. 
+
+Ты можешь загрузить Python для Windows с официального веб-сайта: https://www.python.org/downloads/windows/. Перейди по ссылке "Latest Python 3 Release - Python x.x.x". Если у тебя установлена **64-битная** версия Windows, скачай **Windows x86-64 executable installer**. Если нет — скачай **Windows x86 executable installer**. После загрузки дистрибутива ты должна запустить его (двойным щелчком) и следовать инструкциям.
+
+Обрати внимание на экран мастера установки, который называется "Setup" (Настройка). Убедитесь, что вы выбираете "Добавить Python" по адресу "Добавить Python к системной переменной" и нажать на "Установить сейчас", как показано здесь (может немного отличаться в зависимости от версии)
+
+![Не забудьте добавить Python в системную переменную Path](../python_installation/images/python-installation-options.png)
+
+Когда установка закончится, ты можешь увидеть предложение узнать больше о Python или об установленной тобой версии. Закрой это окно — ты узнаешь намного больше в этом руководстве!
+
+Примечание: Если вы используете старую версию Windows (7, Vista, или любой более старой версии) и установщик Python {{ book.py_version }} завершился ошибкой, установите все обновления Windows и попробуйте установить Python снова. Если ошибка не исчезла, попробуйте установить версию Python {{book.py_min_release}} с [ Python.org ](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} нужен Python {{ book.py_min_version }} или выше, который не поддерживает Windows XP или более ранние версии.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> ** Примечание ** Перед установкой Python в OS X вы должны убедиться, что настройки вашего Mac позволяют устанавливать сторонние пакеты, по мимо тех, что доступны в App Store. Перейдите в Системные настройки (они находятся в папке «Приложения»), нажмите «Безопасность и конфиденциальность», а затем - вкладку «Общие». Если для параметра «Разрешить загрузку приложений из:» установлено значение «Mac App Store», измените его на «Mac App Store и сторонние разработчики».
+
+Вам необходимо зайти на сайт https://www.python.org/downloads/mac-osx/ и загрузить последнюю версию установщика Python:
+
+* Скачай файл *Mac OS X 64-bit/32-bit installer*,
+* Дважды щелкните *python-{{ book.py_release }}-macosx10.9.pkg* для запуска программы установки.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Очень вероятно, что у вас уже установлен Python. Чтобы проверить, установлен ли он у вас (и какая это версия), откройте консоль и введите следующую команду:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+Если у вас установлена другая версия Python, по крайней мере {{ book.py_min_version }} (например, {{ book.py_min_release }}), то вам не нужно обновиться. Если у вас не установлен Python, или если вы хотите использовать другую версию, сначала проверьте, что вы используете Linux со следующей командой:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+После этого, в зависимости от результата, следуй одной из инструкций по установке ниже.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Введи эту команду в консоль:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Используй следующую команду в консоли:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+Если вы находитесь на более старых версиях Fedora, вы можете получить сообщение об ошибке, что команда `dnf` не найдена. В этом случае вам нужно использовать `yum` вместо dnf.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Используй следующую команду в консоли:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3.6
+    
+
+<!--endsec-->
+
+Убедись, что установка прошла успешно, открыв приложение *Терминал* и запустив команду `python3`:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+Показанная версия может отличаться от {{ book.py_release }} -- она должна совпадать с установленной версией.
+
+**ПРИМЕЧАНИЕ:** Если вы на Windows, и вы получите сообщение об ошибке, `python3` не был найден, попробуйте использовать `python` (без `3`) и проверить, если он все еще может быть версия Python, которая является . или выше. Если это не сработает, вы можете открыть новую командную строку и повторить попытку; это произойдет, если вы используете командную строку, оставив открытыми перед установкой Python.
+
+* * *
+
+Если у тебя остались какие-либо сомнения, или что-то пошло не так и ты понятия не имеешь что делать дальше - спроси своего тренера! Иногда дела идут не совсем гладко, поэтому лучше попросить помощи у кого-то с большим опытом.
\ No newline at end of file
diff --git a/ru-RU/python_introduction/README.md b/ru-RU/python_introduction/README.md
new file mode 100644
index 00000000000..2f3579c3e3b
--- /dev/null
+++ b/ru-RU/python_introduction/README.md
@@ -0,0 +1,1071 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Введение в Python
+
+> Часть этой главы основана на учебных пособиях Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Давай напишем немного кода!
+
+## Консоль Python
+
+> Для читателей дома: Эта часть объясняется в видео [основы Python: целые числа, строки, списки, переменных и ошибки](https://www.youtube.com/watch?v=MO63L4s-20U).
+
+Чтобы начать играть с Python, нам нужно открыть *командную строку* на твоем компьютере. Ты уже должна знать, как это сделать -- мы изучали это в главе [Введение в интерфейс командой строки](../intro_to_command_line/README.md).
+
+После того, как будешь готова, следуйте приведенным ниже инструкциям.
+
+Мы хотим открыть консоль Python, так что набери `python` если работаешь в Windows, или `python3` для Mac OS/Linux, и нажми `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Введите "help", "copyright", "credits" или "license" для дополнительной информации.
+    >>>
+    
+
+## Твоя первая команда Python!
+
+После запуска Python, консоль изменилась на `>>>`. Для нас это означает, что сейчас мы можем использовать только команды на языке Python. Тебе не нужно вводить `>>>` - Python будет делать это за нас.
+
+Если ты хочешь выйти из консоли Python, в любой момент -- просто введи `exit()` или используй сочетание клавиш `Ctrl + Z` для Windows и `Ctrl + D` для Mac/Linux. Тогда ты больше не будешь видеть `>>>`.
+
+Сейчас мы не хотим выходить из консоли Python. Мы хотим больше узнать о нем. Начнем с ввода математических действий, таких как `2 + 3` и нажмем `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Хорошо! Видела как появился ответ? Python знает математику! Можешь попробовать и другие команды, например:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Для вычисления экспоненциала, скажем, 2 в степени 3, мы набираем в консоли: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Поиграй с этим немного и затем вернись сюда. :)
+
+Как видишь, Python является прекрасным калькулятором. Если тебе интересно, что еще можно сделать…
+
+## Строки
+
+Как насчет твоего имени? Введи свое имя в кавычках, вот так:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+Сейчас ты создала свою первую строку! Это последовательность символов, которые могут быть обработаны компьютером. Строка должна всегда начинаться и заканчиваться одинаковым символом. Им может быть как одинарная (`'`), так и двойная (`"`) кавычка (разницы нет!) Кавычки говорят Python'у, что внутри них находится строка.
+
+Строки можно объединять. Попробуй так:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+Ты также можешь умножать строки на число:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Если тебе нужно поставить апостроф внутри строки, то есть два способа сделать это.
+
+Используя двойные кавычки:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+или экранировав апостроф обратной косой чертой (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Прикольно, да? Чтобы увидеть своё имя прописными буквами, просто набери:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Ты только что использовала **функцию** `upper` для своей строки! Функция (такая как `upper()`) представляет собой набор инструкций, который должен выполнить Python на заданном объекте (в нашем случае: `"Ola"`) при её вызове.
+
+Если ты хочешь узнать количество букв в своём имени, то и для этого тоже существует **функция**!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Интересно, почему иногда мы вызываем функцию добавлением `.` к концу строки (как `"Ola".upper()`), а иногда сначала пишем имя функции и затем помещаем строку в скобки? Итак, в некоторых случаях функции принадлежат объектам, например функция `upper()`, которая может быть применена только к строкам. В этом случае мы называем функцию **методом**. В другом случае, функции не относятся к чему-то конкретному и могут использоваться для различных типов объектов, например функция `len()`. Вот почему мы передаем `"Ola"` в качестве параметра функции `len`.
+
+### Содержание
+
+OK, достаточно о строках. Пока ты узнала о:
+
+- **консоль** - ввод команд (кода) в интерактивную командную строку Python приводит к ответам на Python
+- **числа и строки** - в Python числа используются для вычислений, а строки - для текстовых объектов
+- **операторы** - такие как `+` и `*`, производят действия над значениями для получения нового
+- **функции** - такие как `upper()` и `len()`, выполняют действия над объектами.
+
+Таковы основы каждого языка программирования, который ты можешь выучить. Готова к чему-то посложнее? Мы уверены, что готова!
+
+## Ошибки
+
+Давай попробуем кое-что новенькое. Можем ли мы получить длину числа так же, как длину твоего имени? Введи `len(304023)` и нажми `Enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Мы получили нашу первую ошибку! {{ warning_icon }} иконка в нашем случае показывает, что код, который мы пытаемся запустить, не будет работать так, как мы этого ожидаем. Делать ошибки (даже преднамеренные) - это неотъемлемая часть процесса обучения!
+
+Наша ошибка говорит о том, что у объектов типа «int» (целые числа) нет длины. Так что же мы можем сейчас сделать? Может быть мы можем написать наше число в виде строки? У строк ведь есть длина, верно?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Сработало! Мы использовали функцию `str` внутри функции `len`. `str()` преобразует все в строки.
+
+- Функция `str` преобразует объекты в **строки**
+- Функция `int` преобразует объекты в **целые числа**
+
+> Важно: мы можем преобразовать число в текст, но не всегда удается преобразовать текст в числа - например, каков будет результат `int('hello')`?
+
+## Переменные
+
+Переменные -- важное понятие в программировании. Переменная -- это не более чем имя для чего-то, чтобы использовать его позднее. Программисты используют переменные для хранения данных, чтобы их код был более читабельным, и для того, чтобы им не пришлось запоминать что есть что.
+
+Допустим, мы хотим создать новую переменную с именем `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+Мы указали, что имя равно Ola.
+
+Как ты уже заметила, твоя программа не возвращает ничего, как было ранее. Так откуда мы знаем, что переменная действительно существует? Просто введи `name` и нажми `Enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Ура! Твоя первая переменная:)! Ты всегда можешь изменить то, к чему она относится:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+```
+
+Ты можешь использовать их также и в функциях:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Круто, правда? Переменными, конечно, может быть что угодно, и цифры тоже! Попробуй следующее:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Но что делать, если мы использовали неправильное имя? Можешь догадаться, что произойдет? Давай попробуем!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Ошибка! Как ты можешь видеть, в Python есть различные типы ошибок, эта называется **NameError**. Python выдаст эту ошибку при попытке использовать переменную, которая пока не определена. При возникновении этой ошибки проверь свой код, чтобы узнать, не написала ли ты неправильно имя переменной.
+
+Попрактикуйся в этом какое-то время и посмотри, что ты сможешь сделать!
+
+## Функция print
+
+Попробуй ввести:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Если просто ввести `name`, интерпретатор Python вернет строковое *представление* переменной 'name', которым, в нашем случае, являются буквы M-a-r-i-a, окруженные одинарными кавычками, ''. Когда ты вводишь `print(name)`, Python "печатает" содержание переменной на экран, без кавычек, что удобнее.
+
+Как мы увидим позднее, `print()` пригодится, когда нам будет нужно печатать что-то изнутри функций, или когда мы захотим напечатать что-то на нескольких строчках.
+
+## Списки
+
+Помимо строк и целых чисел Python имеет богатую коллекцию других типов объектов. Сейчас мы собираемся представить тебе один из них - **list** (список). Списки - это именно то, о чем ты подумала: объекты, которые являются списками других объектов. :)
+
+Давай начнем с создания списка:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Да, это пустой список. Не особенно полезен, да? Давай создадим список лотерейных номеров. Мы не хотим повторять их каждый раз, так что присвоим список переменной:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+Замечательно, у нас есть список! Что мы можем с ним сделать? Для начала посмотрим как много лотерейных номеров в нашем списке. Есть идеи какую функцию можно использовать для этого? Ты её уже знаешь!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Точно! `len()` вернет тебе количество объектов в списке. Удобно, правда? Может быть мы теперь отсортируем его:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Эта команда не возвращает ничего, она просто меняет порядок номеров в списке. Давайте выведем его на экран и посмотрим что получилось:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Как видишь, номера в списке теперь отсортированы от меньшего к большему. Поздравляем!
+
+Может быть нам нужно изменить порядок? Давай сделаем это!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+Если хочешь добавить что-то к своему списку, то можешь воспользоваться этой командой:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Если ты хочешь получить первый номер в списке, то можешь воспользоваться **индексами**. Индекс - это номер позиции в списке, на котором находится нужное нам значение. Программисты предпочитают начать считать с 0, так что первому объекту в списке соответствует индекс 0, следующему —1, и так далее. Попробуй ввести:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Как видишь, ты можешь обратиться к различным объектам в своем списке используя имя списка и индекс объекта в квадратных скобках.
+
+Чтобы удалить что-то из вашего списка, нужно использовать **индексы**, как мы узнали выше, и метод `pop()`. Давай попробуем закрепить пройденное примером; мы будем удалять первый элемент из нашего списка.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Сработало как по волшебству!
+
+В качестве дополнительной тренировки попробуй следующие индексы: 6, 7, 1000, -1, -6 и -1000. Сможешь предсказать результат? Видишь логику работы?
+
+Ты можешь найти перечень всех методов, относящихся к списку, в этой главе официальной документации Python: https://docs.python.org/3/tutorial/datastructures.html
+
+## Словари
+
+> Для занимающихся дома: эта глава освещена в видео [Как работает Интернет](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+
+Словари схожи со списками, но ты обращаешься к значениям словаря по ключу, а не по индексу. Ключом может быть любая строка или число. Давай создадим пустой словарь:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Это показывает что мы создали пустой словарь. Ура!
+
+Теперь попробуй следующую команду (можешь заменить значения на своё имя, страну и т. д.):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+Этой командой ты создала переменную `participant` с тремя парами ключ-значение:
+
+- Ключ `name`, указывающий на значение `'Ola'` (`строковый` объект),
+- ключ `country`, указывающий на значение `'Poland'` (еще одна `строка`),
+- и ключ `favorite_numbers`, указывающий на значение `[7, 42, 92]` (объект типа `список` с тремя числами внутри).
+
+Значение конкретного ключа можно узнать следующим образом:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Видишь, синтаксис похож на работу со списком. Но вместо того чтобы запоминать индекс, тебе нужно помнить ключ.
+
+Что случится, если мы спросим у Python значение несуществующего в словаре ключа? Можешь предположить? Давай попробуем и узнаем наверняка!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Смотри, другая ошибка! Эта называется **KeyError**. Python услужливо напоминает, что ключа `'age'` не существует в словаре.
+
+Когда стоит использовать словарь, а когда список? Это хороший вопрос для самостоятельного размышления. Сделай предположение перед тем, как читать дальше.
+
+- Тебе нужна упорядоченная последовательность элементов? Список - наш выбор.
+- Тебе нужны сочетания ключ - значение, чтобы быстро искать значения (по ключу) в дальнейшем? Словарь отлично подойдет.
+
+Словари, как и списки, *изменяемы*, т. е. они могут быть изменены после того как были созданы. Ты можешь добавить новые пары ключ/значение в словарь следующим образом:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Как и в случае со списками, применяя функцию `len()` к словарю, ты получишь число пар ключ/значение. Попробуй сама:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Надеюсь, все вышеизложенное понятно. :) Готова к новым приключениям со словарями? На следующей строке тебя ждут изумительные вещи.
+
+Ты можешь использовать команду `pop` для удаления элементов из словаря. Скажем, ты хочешь удалить элемент с ключом `'favorite_numbers'`, просто набери следующую команду:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Как видно, пара ключ-значение с ключом 'favorite_numbers' была удалена.
+
+Помимо этого, ты можешь заменить значение, ассоциированное с уже существующим ключом. Набери:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Значение, на которое ссылается ключ `'country'` было изменено с `'Poland'` на `'Germany'`. Захватывает? Еще бы! Ты выучила еще одну потрясающую штуку.
+
+### Содержание
+
+Шикарно! Теперь ты знаешь немало о программировании. Мы познакомились с:
+
+- **ошибками** - теперь ты знаешь как читать и анализировать ошибки, которые возникают, если Python не понимает твоей команды
+- **переменными** - именами для объектов, которые упрощают твой код и делают его более читабельным
+- **списками** - последовательностями объектов в заданном порядке
+- **словарями** - объектами, хранящими пары ключ-значение
+
+Готова к продолжению? :)
+
+## Сравниваем вещи
+
+> Для занимающихся дома: эта глава освещена в видео [Как работает Интернет](https://www.youtube.com/watch?v=7bzxqIKYgf4).
+
+Немалая часть программирования требует сравнения вещей. Что проще всего сравнить друг с другом? Числа, конечно. Давай посмотрим как это работает:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+Мы дали Python несколько чисел для сравнения. Как видишь, Python может не только сравнивать числа, но и значения математических выражений, таких как `2 * 2`, а так же сравнивать результат функции `len([4, 5])` - `2` . Неплохо, да?
+
+Хочешь спросить почему мы написал двойной символ равенства `==`, чтобы проверить одинаковы ли числа? Потому что одинарные символ равенства `=` уже задействован под присваивание значения переменным. Ты всегда, **всегда** должна писать два символа равенства `==`, если хочешь проверить одинаковы ли объекты. Мы также можем проверить различаются ли объекты. Для этого, мы используем `!=`, как показано в примере выше.
+
+Дадим Python еще два задания:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+С `>` и `<` все понятно, но что значат `>=` и `<=`? Читай их следующим образом:
+
+- x `>` y означает: x больше y
+- x `<` y означает: x меньше y
+- x `<=` y означает: x меньше или равен y
+- x `>=` y означает: x больше или равен y
+
+Супер! Хочешь еще? Тогда попробуй вот это:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Ты можешь передать Python так много чисел, как захочешь, и он будет возвращать ответ! Хитро, правда?
+
+- **and** - если ты используешь `and` оператор, оба сравнения по бокам от него должны быть True (верны), чтобы результат всей команды был равен True
+- **or** - если ты используешь `or` оператор, достаточно одному из сравнений по бокам от него быть равным True, чтобы результат всей команды также равнялся True
+
+Ты когда-нибудь слышала выражение "сравнивать яблоки и апельсины"? Попробуем что-то подобное в Python:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Как мы видим, Python не знает как сравнить число (`int`) и строку (`str`) между собой. Поэтому он просто возвращает нам ошибку **TypeError** и предупреждает, что объекты заданных типов не могут быть сравнены.
+
+## Логические значения
+
+Кстати, вы только что узнали о новом типе объекта на Python. Он называется **Boolean**.
+
+Существует только два логических объекта:
+
+- True
+- False
+
+Чтобы Python понимал тебя, ты всегда должна писать True с заглавной буквы (остальные прописные). **true, TRUE, tRUE не будет восприниматься -- только True.** (Та же логика применима к False, само собой.)
+
+Ты можешь присваивать переменным логические значения! Смотри сюда:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Или это можно сделать так:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Попрактикуйся и развлекись с логическими значениями на примере этих выражений:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Поздравляем! Логические значения одна из самых классных фишек программирования и ты только что научилась ими пользоваться!
+
+# Сохраняй!
+
+> Для занимающихся дома: эта глава освещена в видео [Как работает Интернет](https://www.youtube.com/watch?v=dOAg6QVAxyk).
+
+До сих пор мы писали весь код в интерактивной консоли, где Python сразу анализировал, обрабатывал и выполнял наши команды. Мы были ограничены одной строкой. Обычно, программы сохраняются в файлах и выполняются **интерпретатором** или **компилятором** нашего языка программирования. Пока мы только просили **интерпретатор** Python выполнять наши однострочные команды из консоли. Однако, нам понадобится больше места для следующих задач, поэтому задача минимум:
+
+- Закрыть интерактивную консоль Python
+- Открыть наш текстовый редактор
+- Сохранить код в новом файле
+- Запустить его!
+
+Чтобы закрыть интерактивную консоль Python просто набери функцию ~~~ exit()~~~ :
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Это вернет тебя в командную строку.
+
+Ранее мы выбрали редактор кода из раздела [редактор кода](../code_editor/README.md). Теперь нам нужно открыть редактор и написать код в новый файл (или если вы используете Chromebook, создайте новый файл в облачном IDE и откройте файл, который будет включен в редактор кода):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Очевидно, ты уже искушенный Python разработчик, так что не стесняйся добавить что-нибудь по своему вкусу из ране изученного.
+
+Теперь нам нужно сохранить файл с кодом и дать ему подходящее имя. Давай назовем его **python_intro.py** и сохраним на рабочий стол. Мы можем назвать файл как хотим, но важно чтобы название заканчивалось на **.py**. Расширение **.py** говорит операционной системе, что это **исполняемый файл python**, и Python может его запустить.
+
+> **Примечание** Ты должна уде была заметить одну из крутейших вещей в редакторах кода: цвета! В интерактивной консоли Python весь текст был одного цвета, сейчас же функция `print` должна отличаться по цвету от текста, который передается в неё в качестве атрибута. Это называется «синтаксическая подсветка», и это действительно удобная штука для программирования. Цвет подсветки может подсказать тебе о незакрытой кавычке или опечатке в ключевом слове (таком как `def` в определении функции, с которым мы скоро познакомимся). Это одна из причин, по которой мы используем редакторы кода. :) :)
+
+После сохранения файла пришло время запустить его! Используя навыки из раздела о командной строки, открой терминал и **поменяй текущую директорию** на рабочий стол.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Для Mac команда будет выглядеть так:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+На Линукс это будет так:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Помните, что слово "Рабочий стол" может быть переведено на ваш локальный язык.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+В командной строке Windows это будет так:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+И для Windows Powershell это будет выглядеть так:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Если ты застряли, попроси помощи. Именно для этого здесь нужны наставники!
+
+Теперь используй Python чтобы запустить код в файле:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Примечание: в Windows 'python3' не распознается как команда. Вместо этого используй 'python' для выполнения файла:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Отлично! Ты только что запустила свою первую программу, чей код был сохранен в файле. Чувствуешь воодушевление?
+
+Можно передвигаться дальше к такому незаменимому в программировании инструменту как:
+
+## If … elif … else
+
+Зачастую определенный код в программе должен выполняться только при соблюдении определенных условий. Поэтому в Python есть такая вещь как **условный оператор if**.
+
+Замени код в своем файле **python_intro.py** на:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Если мы сохраним его и запустим, то получим ошибку:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python предполагает, что мы должны дать ему инструкции, которые будут им выполнены при соблюдении условия `3 > 2` (т. е. при равенстве условия логическому значению `True`). Давай попробуем заставить Python напечатать на экране “It works!”. Внеси следующие изменения в **python_intro.py**:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Обратила внимание как мы сделали отступ во второй строке из 4 символов пробела? Мы поступаем так, чтобы Python понимал какой код после условного оператора if должен быть выполнен, если условие равно True. Можно ограничиться и одним пробелом, однако, практически все программисты Python используют 4, чтобы код выглядел аккуратно и читабельно. Один Tab будет также считаться за 4 пробела - до тех пор, пока тебе это позволяет редактор кода. Когда ты сделала свой выбор, не меняй его! Если у ты уже используешь 4 пробела в качестве отступа, то и для всех будущих отступов используй ихи, в противном случае ты можешь столкнуться с проблемами.
+
+Сохраняем и запускаем еще раз:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Примечание: запомни, что в Windows 'python3' не распознается как команда. Теперь замени 'python3' на 'python' для выполнения файла.
+
+### Что, если условие не True?
+
+В предыдущем пример код выполнялся только когда условие равнялось True. Однако, Python имеет операторы `elif` и `else`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+Если запустить этот код, он напечатает:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+Если 2 больше 5, то будет выполнена следующая команда. Просто, правда? Давай посмотрим как работает оператор `elif`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+и запускаем:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+Видишь, что произошло? `elif` позволяет добавить дополнительные условия, которые запускаются если предыдущие не срабатывают.
+
+Можно использовать сколько угодно `elif` после первого `if`. Например:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python проходит через каждую проверку условия и выводит:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Комментарии
+
+Комментарии - это строки, начинающиеся с `#`. Вы можете написать все, что вы хотите после `#` и Python будет игнорировать это. Комментарии могут упростить ваш код для понимания другими людьми.
+
+Давайте посмотрим, как это выглядит:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+Вам не нужно писать комментарий для каждой строки кода, но они полезны для объяснения, почему ваш код что-то делает, или предоставление сводной информации, когда она делает что-то сложное.
+
+### Содержание
+
+В последних трех упражнениях ты познакомилась с:
+
+- **сравнением вещей** - в Python ты можешь сравнивать вещи друг с другом при помощи `>`, `>=`, `==`, `<=`, `<` и `and`, `or` операторов
+- **Boolean** - тип объекта, который может иметь только два значения: `True` или `False`
+- **сохранением файлов** - хранение кода в файлах позволяет выполнять длинные программы.
+- **if...elif...else** - условные операторы, которые позволяют выполнять код только при определенных условиях.
+- **комментариями** - строки, на которых Python не будет выполняться, что позволит документировать ваш код
+
+Пришло время для последней части этой главы!
+
+## Твоя собственная функция!
+
+> Для занимающихся дома: эта глава освещена в видео [Как работает Интернет](https://www.youtube.com/watch?v=5owr-6suOl0).
+
+Помнишь функции, такие как `len()`, которые можно использовать в Python? Тогда у нас есть хорошие новости — сейчас ты научишься писать свои собственные функции!
+
+Функция - это последовательность инструкций, которые должен выполнить Python. Каждая функция в Python начинается с ключевого слова `def`, имеет свое имя и параметры. Давай посмотрим. Замени код в **python_intro.py** на следующий:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Отлично, наша первая функция готова!
+
+Ты можешь задаться вопросом, почему мы написали имя функции в конце файла. Когда мы пишем `def hi():` и далее строки с отступом, мы описываем инструкции, которые определяют, что должна выполнять функция `hi()`. Python прочитает и запомнит эти инструкции, но они не будут выполнены немедленно. Чтобы попросить Python выполнить эту функцию мы должны написать вызов этой функции: `hi()`. Python читает файл и исполняет его сверху вниз, поэтому мы описываем функцию в файле перед тем, как вызываем ее.
+
+Давай запустим и посмотрим что произойдет:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Примечание: если это не работало, не паникуй! Вывод поможет вам определить, почему:
+
+- Если ты получила `KeyError`, это вероятно означает, что ты ввела что-то неправильное, поэтому проверь, что ты использовала одно то же имя при создании функции с `def hi():` и при вызове функции с `hi()`</0>.
+- Если вы получили `IndentationError`, проверь, что обе строки `print` имеют одинаковые пробелы в начале строки: python хочет, чтобы весь код внутри функции был аккуратно выровнен.
+- Если вообще нет вывода, проверь, что последний `hi()` не имеет отступов - если есть, эта строка тоже станет частью функции и никогда не будет выполняться.
+
+Это было просто! Давай напишем нашу первую функцию с параметрами. Мы будем использовать предыдущий пример - функцию, которая пишет 'hi' и имя пользователя:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+Как ты можешь заметить, мы передали нашей функции параметр `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Помни: функция `print` расположена внутри блока оператора `if` с отступом в четыре пробела. Это потому, что она запускается тогда, когда выполняется условие. Давай посмотрим, как это работает:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Упс, ошибка. К счастью, Python выдает довольно подробное сообщение об ошибке. Оно говорит нам, что функция `hi()` (которую мы определили) имеет один обязательный аргумент (`name`) и мы забыли передать его при вызове функции. Давай исправим это в конце файла:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+И запустим еще раз:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+И если мы поменяем имя?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+И повторим:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Теперь, как ты думаешь, что произойдет, если ты наберешь другое имя? (Не Ola или Sonja) Попробуй сама и проверь была ли ты права. Результат должен быть таким:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+Шикарно, верно? Так тебе не придется повторяться каждый раз, когда ты захочешь изменить имя. И это именно та причина, для которой нам и нужны функции - ты никогда не захочешь повторять свой код!
+
+Давай сделаем кое-что умнее - тут больше двух имен, и создание условия для каждого было бы сложным, правда? Замени часть своего файла на следующее:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Давай выполним этот код:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Поздравляем! Ты только что научилась писать свои собственные функции :)
+
+## Циклы
+
+> Для занимающихся дома: эта глава освещена в видео [Как работает Интернет](https://www.youtube.com/watch?v=aEA6Rc86HF0).
+
+Ну вот и последняя часть. Быстро время пролетело, верно? :)
+
+Программисты не любят повторяться. Программирование — это автоматизация вещей, поэтому мы не хотим приветствовать каждого человека по имени вручную, верно? Здесь пригодятся циклы.
+
+Еще помнишь о списках? Давай создадим список девушек:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+Мы хотим поздороваться с каждой по имени. У нас есть функция `hi`, которая этим и занимается, так что давай поместим её в цикл:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+Оператор ~~~ for~~~ работает по схожему принципу что и ~~~ if~~~ ; код после обоих операторов должен иметь отступ в четыре пробела.
+
+Ниже полный код, который должен быть у нас в файле:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+И после запуска:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+Как ты можешь заметить, все команды внутри цикла `for` (с отступом от левого края) будут выполняться для каждого элемента списка `girls`.
+
+Ты также можешь использовать цикл `for` на числах, используя функцию `range`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Что выведет на экран:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+Функция `range` создает список чисел, следующих от первого до второго с заданным шагом (начало, конец и шаг мы передаем функции как параметры, если шаг не указать, как в примере выше, он будет по умолчанию равен 1).
+
+Обрати внимание что второе число (конец списка) не включается в результат работы функции (`range(1, 6)` создает список от 1 до 5, не включающий 6). Это потому, что «range» — полуоткрытый диапазон, то есть включает в себя первое значение, но не включает последнего.
+
+## Содержание
+
+Вот и всё. **Ты чертовски крута!** Эта глава была непростой, так что ты можешь гордиться собой. Мы-то точно тобой гордимся — вон как далеко продвинулась уже!
+
+Для официального и полного руководства загляни на https://docs.python.org/3/tutorial/. Там ты найдешь более углубленные и подробные инструкции по изучению языка. Удачи! :)
+
+Тебе может потребоваться перерыв - прогуляйся и дай отдых глазам перед тем, как мы перейдем к следующей главе. :)
+
+![Пирожок](images/cupcake.png)
\ No newline at end of file
diff --git a/ru-RU/template_extending/README.md b/ru-RU/template_extending/README.md
new file mode 100644
index 00000000000..ecfc9c9bd2c
--- /dev/null
+++ b/ru-RU/template_extending/README.md
@@ -0,0 +1,151 @@
+# Расширение шаблона
+
+Еще одной удобной вещью в Django является **расширение шаблонов**. Что это значит? Ты можешь использовать различные блоки HTML-кода для разных частей своего веб-сайта.
+
+Шаблоны помогают, когда вы хотите использовать одну и ту же информацию или один и тот же макет в более чем одном месте. Вам не придется повторяться в каждом файле. И если вы хотите что-то изменить, то вы не должны делать это в каждом шаблоне, так как он всего один!
+
+## Создаем базовый шаблон
+
+Базовый шаблон - это наиболее общая типовая форма страницы, которую ты расширяешь для отдельных случев.
+
+Давай создадим файл `base.html` в директории `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Теперь открой его в редакторе кода и скопируй все из `post_list.html` файла в `base.html` файл примерно так:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Затем в файле `base.html` замени все между тегами `<body>` и `</body>` следующим кодом:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Как ты заметила, мы заменили все из `{% for post in posts %}` на `{% endfor %}` с: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Но почему? Ты только что создала `блок`! Ты использовала тег шаблона `{% block %}`, чтобы создать область, в которую будет вставляться HTML. Что HTML будет поступать из другого шаблона, который расширяет этот шаблон (`base.html`). Мы покажем как это сделать через секунду.
+
+Теперь сохрани `base.html` и снова открой ваш `blog/templates/blog/post_list.html` файл в редакторе кода. {% raw %}Тебе предстоит удалить все, что выше `{% for post in posts %}` и ниже `{% endfor %}`. Когда ты закончишь, файл будет выглядеть следующим образом:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Мы хотим использовать это как часть нашего шаблона для всех блоков контента. Пришло время добавить теги блока в этот файл!
+
+{% raw %}Вы хотите, чтобы ваш тег блока соответствовал тегу в файле `base.html`. Вы также хотите включить весь код, который принадлежит к блокам контента. Для этого поместите все между `{% block content %}` и `{% endblock %}`. Таким образом:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Осталось только одно. Нам нужно соединить эти два шаблона друг с другом. Это то, что называется "расширить шаблон"! Мы сделаем это, добавив тег расширения к началу файла. Вот так:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Готово! Сохрани файл и проверь, работает ли твой веб-сайт нормально. :)
+
+> Если у тебя появилась ошибка `TemplateDoesNotExist`, это означает, что отсутствует файл `blog/base.html` и в консоли работает `runserver`. Попробуй остановить его (одновременным нажатием Ctrl+C - клавиш Control и C одновременно) и перезапусти сервер с помощью команды `Python manage.py runserver`.
\ No newline at end of file
diff --git a/ru-RU/whats_next/README.md b/ru-RU/whats_next/README.md
new file mode 100644
index 00000000000..3ae04d9b307
--- /dev/null
+++ b/ru-RU/whats_next/README.md
@@ -0,0 +1,43 @@
+# Что дальше?
+
+Поздравь себя! **Ты нереально крута**. Мы очень гордимся! <3
+
+### Что делать дальше?
+
+Сделай перерыв и расслабься. Ты только что закончила огромную работу.
+
+Подпишись на страничку Django Girls в [Facebook](http://facebook.com/djangogirls) и [Twitter](https://twitter.com/djangogirls), чтобы оставаться в курсе новостей.
+
+### Можем ли мы посоветовать дополнительные ресурсы для обучения?
+
+Да! Есть *много* онлайн-ресурсов для изучения всех видов языков программирования - это может быть довольно сложно определиться, куда идти дальше, но мы поможем разобраться с этим. Какими были ваши интересы, прежде чем вы пришли в Django Girls, и все, что вас заинтересовало, поработав с нашим учебником; вот некоторые бесплатные ресурсы (или ресурсы с большим количеством бесплатных компонентов) можно использовать для достижения ваших целей.
+
+#### Django
+
+- Еще одна наша книга, [Django Girls Учебник: расширения](https://tutorial-extensions.djangogirls.org/)
+- [Django официальный учебник](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Начало работы с Django видео уроки](http://www.gettingstartedwithdjango.com/)
+- Django для всех – курс видео-лекций на Coursera, которые можно посмотреть бесплатно, а за отдельную плату получить сертификат о прохождении
+
+#### HTML, CSS и JavaScript
+
+- [Курс веб-разработки на Codecademy](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Курс Python в Codecademy](https://www.codecademy.com/learn/learn-python)
+- [Python курс в Google](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) - начальные упражнения бесплатно
+- [Новый кодер учебники](http://newcoder.io/tutorials/) – это целый ряд практических примеров того, как вы могли бы использовать Python
+- [edX](https://www.edx.org/course?search_query=python) – вы можете просмотреть большинство курсов бесплатно, но если вы хотите сертификат или подтверждение квалификации высшего образования, то это будет стоить денег
+- [Python специализация в Coursera](https://www.coursera.org/specializations/python) – некоторые видео лекции могут просматриваться бесплатно и вы можете заработать сертификат Coursera, прослушивая эти курсы
+- [Python для всех](https://www.py4e.com/) - свободные и открытые версии Coursera Python для всех специализации
+
+#### Работа с данными
+
+- [Codecademy курс по data science ](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – вы можете просмотреть большинство курсов бесплатно, но если вы хотите сертификат или подтверждение квалификации высшего образования, то это будет стоить денег
+- [Dataquest](https://www.dataquest.io/) – первые 30 «миссий» бесплатно
+
+Ждем с нетерпением твой следующий проект!
\ No newline at end of file
diff --git a/ru/README.md b/ru/README.md
index 397afd30aa4..b025c435d69 100755
--- a/ru/README.md
+++ b/ru/README.md
@@ -1,22 +1,20 @@
 # Руководство Django Girls
 
-[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
 
-> Это руководство распространяется под международной лицензией Creative Commons Attribution-ShareAlike 4.0
-Чтобы ознакомиться с содержанием этой лицензии, посети: https://creativecommons.org/licenses/by-sa/4.0/
+> Это руководство распространяется под международной лицензией Creative Commons Attribution-ShareAlike 4.0. Чтобы ознакомиться с содержанием этой лицензии, посети страницу https://creativecommons.org/licenses/by-sa/4.0/
 
-## Вступительное слово
+## Добро пожаловать
 
-Добро пожаловать в руководство Django Girls! Мы рады тебя здесь видеть :) В этом руководстве мы заглянем за кулисы веб-технологий и дадим 
-базовое представление о тех вещах, которые собираются в общую картину веба таким, каким мы его знаем.
+Добро пожаловать в учебник Django Girls! Мы рады видеть тебя :) В этом пособии мы заглянем под капот веб-технологий, взглянем на все куски кода, которые потом соберутся в одно целое.
 
-Как и с любой незнакомой темой – это будет приключением. Но не волнуйся, тебе уже хватило смелости оказаться здесь, так что всё будет хорошо :) 
+Как и все неизвестное - это может быть немного страшно. Но не беспокойся, ты уже достаточно преодолела, чтобы зайти сюда :)
 
 ## Введение
 
 Ты когда-нибудь чувствовала, что мир становится все более и более технологичным, в то время как ты остаёшься где-то позади? Ты задумывалась о том, как создать веб-сайт, но мотивации начать никогда не хватало? Приходило ли тебе в голову, что мир программного обеспечения слишком сложен, чтобы пробовать сделать что-то самой?
 
-Тогда у нас есть для тебя хорошие новости! Программирование – не такая уж сложная задача, как кажется, и мы покажем тебе, как весело это может быть.
+Тогда у нас для тебя хорошие новости! Программирование – не такая уж сложная задача, как кажется, и мы покажем тебе, как весело это может быть.
 
 Это руководство не превратит тебя волшебным образом в программиста. Если ты хочешь добиться мастерства, то потребуются месяцы, а может быть и годы обучения и практики. Однако, мы хотим показать тебе, что программирование или создание веб-сайтов не настолько сложная задача как может показаться. Мы постараемся объяснить все настолько хорошо, насколько сможем, чтобы ты не чувствовала себя запуганной техническими деталями.
 
@@ -24,37 +22,30 @@
 
 ## Что ты узнаешь из этого руководства?
 
-После прохождения руководства у тебя будет простое работающее веб-приложение: свой собственный блог. Мы покажем, как разместить его онлайн, чтобы другие увидели твою работу!
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
 
 Он будет выглядеть следующим образом (более или менее):
 
 ![Рисунок 0.1](images/application.png)
 
-> Если ты будешь работать над учебником самостоятельно и без тренера, который смог бы помочь при необходимости, то у нас есть для тебя чат: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge). Мы попросили наших тренеров и успешно прошедших обучение участников заглядывать туда время от времени и помогать остальным! Не стесняйся задавать там свои вопросы!
-
-Хорошо, [давай начнем с начала...][3]
-
- [3]: ./how_the_internet_works/README.md
-
-## Прохождение руководства дома
-
-Принимать участие в воркшопе Django Girls – это потрясающе, но мы понимаем, что не всегда есть такая возможность. Поэтому мы приветствуем прохождение
-данного руководства дома. В настоящий момент мы готовим видео, которое поможет следовать руководству самостоятельно. Работа над ними ещё не закончена,
-но все больше и больше тем скоро будут разобраны на YouTube-канале [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed).
-
-## Сотрудничество и дополнительная информация
-
-Это руководство поддерживается [DjangoGirls][4]. Если ты нашла ошибки или хочешь обновить информацию, пожалуйста, [следуй этим рекомендациям][5].
-
- [4]: https://djangogirls.org/
- [5]: https://github.com/DjangoGirls/tutorial/blob/master/README.md
-
-## Хочешь помочь с переводом руководства на другие языки?
-
-В настоящее время перевод координируется через платформу crowdin.com:
-
-https://crowdin.com/project/django-girls-tutorial
-
-Если твоего языка нет в списке на crowdin, пожалуйста, [дай нам знать][6], чтобы мы могли его добавить.
-
- [6]: https://github.com/DjangoGirls/tutorial/issues/new
+> Если ты будешь работать над учебником самостоятельно и без наставника, который бы смог помочь при необходимости, то у нас есть для тебя чат: !( Chat.svg)![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg). Мы попросили наших тренеров и успешно прошедших обучение участников заглядывать туда время от времени и помогать остальным! Не стесняйся задавать там свои вопросы!</p> </blockquote> 
+> 
+> Хорошо, [давай начнем...](./how_the_internet_works/README.md)
+> 
+> ## Выполняя задания дома
+> 
+> Замечательно, если ты примешь участие в воркшопе Django Girls, но мы понимаем, что это не всегда возможно. Поэтому мы рекомендуем тебе попробовать выполнить задания дома. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. Скоро у нас будет YouTube канал [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed). А пока мы работаем над ним, прочитай это руководство :)
+> 
+> В каждой главе, для которой видео уже снято, есть соответствующая ссылка.
+> 
+> ## Сотрудничество и дополнительная информация
+> 
+> Это руководство поддерживается [DjangoGirls](https://djangogirls.org/). Если ты нашла ошибки или хочешь обновить информацию, пожалуйста, [следуй этим рекомендациям](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+> 
+> ## Would you like to help us translate the tutorial into other languages?
+> 
+> Перевод, в настоящее время, проводится на платформе crowdin.com:
+> 
+> https://crowdin.com/project/django-girls-tutorial
+> 
+> If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ru/SUMMARY.md b/ru/SUMMARY.md
index 9fc224ba38a..bd87ef392f5 100755
--- a/ru/SUMMARY.md
+++ b/ru/SUMMARY.md
@@ -1,26 +1,27 @@
 # Содержание
 
-*   [Введение](README.md)
-*   [Установка](installation/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)
-*   [URL-адреса Django](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)
+* [Введение](README.md)
+* [Установка](installation/README.md)
+* [Установка (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)
+* [URL-адреса Django](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)
\ No newline at end of file
diff --git a/ru/chromebook_setup/README.md b/ru/chromebook_setup/README.md
new file mode 100644
index 00000000000..4bf9ab8ff9b
--- /dev/null
+++ b/ru/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Настройка Chromebook
+
+> **Примечание** Если вы уже проходили через шаги установки, не нужно делать это снова – можно перейти прямо к [Введению в Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ru/chromebook_setup/instructions.md b/ru/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..48a89dd1e72
--- /dev/null
+++ b/ru/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+Можешь [пропустить этот раздел](http://tutorial.djangogirls.org/en/installation/#install-python), если ты не используешь Chromebook. Если же у тебя Chromebook, процесс установки будет немного иным. Вы можете игнорировать остальные инструкции по установке.
+
+### Cloud9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. На протяжении всего курса Cloud9 будет выступать в качестве вашего *локального сервера*. Вы будете работать в терминале (так же, как и ваши одноклассники на OS X, Ubuntu или Windows), но ваш терминал будет подключен к компьютеру где-нибудь в Нидерландах или Германии, которых Cloud9 установили специально для вас.
+
+1. Установка Cloud9 из [Интернет-магазина Chrome](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Перейти на [c9.io](https://c9.io)
+3. Зарегистрируйте учетную запись
+4. Нажмите кнопку *создать новую рабочую область (Create a New Workspace)*
+5. Назовите его *django-girls*
+6. Выберите *blank* (второй справа в нижней строке с оранжевым логотипом)
+
+Теперь вы должны увидеть интерфейс боковой панели, большое главное окно с текстом и небольшое окно в нижней части, которая выглядит примерно так:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Виртуальное окружение
+
+Виртуальное окружение (также называемое virtualenv или venv) является "коробкой", куда мы можем сложить полезные для нашей программы вещи. Мы используем его, чтобы держать различные биты кода, которые мы хотим использовать для нашего проекта отдельно, не смешивая с другими проектами.
+
+В вашем терминале в нижней части интерфейса Cloud9 выполните следующую команду:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+Если это по-прежнему не работает, спросите вашего наставника помочь.
+
+Далее запустите:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(обратите внимание, что в последней строке мы используем знак равенства после знака тильды: ~=).
+
+### GitHub
+
+Создайте аккаунт на [GitHub](https://github.com)
+
+### PythonAnywhere
+
+Django Girls пособие включает в себя раздел о "развертывании" - процессе публикации вашего сайта в Интернете.
+
+Эта часть является немного странной, когда у нас Chromebook, поскольку мы используем компьютер, который находится в Интернете (в отличие от, скажем, ноутбука). Однако, это все равно необходимо. Представьте, что Cloud9 - средство для нашей работы, а PythonAnywhere - место для показа.
+
+Зарегистрируйся на [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ru/code_editor/README.md b/ru/code_editor/README.md
index 614a388258e..23c67b58a4b 100755
--- a/ru/code_editor/README.md
+++ b/ru/code_editor/README.md
@@ -1,9 +1,11 @@
 # Текстовый редактор
 
-> Для проходящих курс дома: эта глава рассмотрена в видео [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+> Для тех, кто занимается на дому: эта глава рассматривается в видео [Установка Python и текстового редактора](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
 
-Приступаем к написанию первых строк кода — пора загрузить текстовый редактор!
+Приступаем к написанию первых строк кода - пора загрузить текстовый редактор!
 
-> **Примечание:** если ты уже все сделала в главе, посвященной установке, то можешь смело переходить к следующей главе!
+> **Примечание** Если вы используете Chromebook, пропустите эту главу и убедитесь, что вы будете следовать инструкциям по [Установке Chromebook](../chromebook_setup/README.md).
+> 
+> **Примечание**: Если ты уже все сделала в главе, посвященной установке, то можешь смело переходить к следующей главе!
 
-{% include "/code_editor/instructions.md" %}
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ru/code_editor/instructions.md b/ru/code_editor/instructions.md
index 2d48fbd69fb..0d935727a5b 100755
--- a/ru/code_editor/instructions.md
+++ b/ru/code_editor/instructions.md
@@ -1,6 +1,6 @@
-Существует много различных редакторов, и в основном все сводится к личным предпочтениям. Большинство Python-программистов используют сложные, но чрезвычайно мощные IDE (англ. Integrated Development Environments — Интегрированные среды разработки), такие как PyCharm. Однако они, вероятно, не очень подходят для начинающих; мы предлагаем столь же мощные, но куда более простые варианты.
+Существует много различных редакторов и в основном все сводится к личным предпочтениям. Большинство Python программистов используют сложные, но чрезвычайно мощные IDE (англ. Integrated Development Environments - Интегрированные среды разработки), такие как PyCharm. Однако они, вероятно, не очень подходят для начинающих; мы предлагаем столь же мощные, но куда более простые варианты.
 
-Ниже приведен перечень наших предпочтений, но также можешь попросить совета у своего тренера — будет проще получить помощь от него.
+Ниже приведен перечень наших предпочтений, но также можешь попросить совета у своего наставника - будет проще получить помощь от него.
 
 ## Gedit
 
@@ -10,22 +10,22 @@ Gedit является открытым, бесплатным редакторо
 
 ## Sublime Text 3
 
-Sublime Text — это очень популярный текстовый редактор с бесплатным пробным периодом. Он легко устанавливается и прост в использовании, а также доступен для всех операционных систем.
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
 
 [Скачать его можно здесь](https://www.sublimetext.com/3)
 
 ## Atom
 
-Atom — это новейший текстовый редактор от [GitHub](https://github.com/). Он является бесплатным, открытым, легко устанавливается и прост в использовании. Доступен для Windows, OSX и Linux.
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
 
 [Скачать его можно здесь](https://atom.io/)
 
 ## Зачем нам нужен редактор кода?
 
-Ты можешь спросить — зачем устанавливать отдельную программу для редактирования кода, если можно использовать Word или Notepad?
+Ты можешь спросить - зачем устанавливать отдельную программу для редактирования кода, если можно использовать Word или Notepad.
 
-Во-первых, код должен должен храниться в виде **простого текста**, а проблема таких программ, как Word или Textedit в том, что они не сохраняют файлы в этом виде, а используют "обогащённый" текст (с форматированием и шрифтами), например, [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+Во-первых, код должен должен храниться в виде **простого текста**, а проблема таких программ, как Word или Textedit в том, что они не сохраняют файлы в этом виде, а используют "обогащенный" текст (с форматированием и шрифтами), например, [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
 
-Вторая причина в том, что специализированные редакторы предоставляют множество полезных для программирования возможностей, такие как цветную подсветку кода в зависимости от его смысла и автоматически закрывающиеся кавычки.
+Вторая причина в том, что специализированные редакторы созданы именно для работы с кодом и имеют дополнительные удобные возможности, например, подсветку кода в соответствии с его значением или автоматически закрывающиеся кавычки.
 
-Позже мы увидим всё это в действии. Скоро ты начнешь думать о своем редакторе кода как о проверенном любимом инструменте :)
+Позже мы увидим все это в действии. Скоро ты начнешь думать о своем редакторе кода как о проверенном любимом инструменте :)
\ No newline at end of file
diff --git a/ru/css/README.md b/ru/css/README.md
index 6b119a3f3f4..02f03299a93 100755
--- a/ru/css/README.md
+++ b/ru/css/README.md
@@ -1,308 +1,304 @@
-# CSS — сделай это красиво!
+# CSS - сделай это красивым!
 
-Наш блог всё ещё выглядит довольно скверно, не так ли? Пора сделать его красивым! Для этого будем использовать CSS.
+Наш блог все еще выглядит довольно скверно, не так ли? Пора сделать его красивым! Для этого будем использовать CSS.
 
 ## Что такое CSS?
 
-Каскадные таблицы стилей (англ. Cascading Style Sheets, или сокращённо CSS) — специальный язык, используемый для описания внешнего вида и форматирования сайта, написанного на языке разметки (как HTML). Воспринимай это как своего рода макияж для нашей веб-страницы ;)
+Каскадные таблицы стилей (CSS) - это язык, используемый для описания внешнего вида и форматирования веб-сайта, написанного на языке разметки (например, HTML). Рассматривай это как макияж для нашей веб-страницы :)
 
-Но мы же не хотим начинать всё с нуля, правда? Мы просто снова возьмём что-то, что уже было создано программистами и опубликовано в Интернете для свободного пользования. Ты же знаешь, заново изобретать велосипед совсем не весело.
+Но ты же не хочешь начинать все сначала, правда? Повторюсь, мы будем использовать все то, что другие программисты выложили в интернет бесплатно. Не очень-то интересно изобретать велосипед еще раз :)
 
 ## Давай использовать Bootstrap!
 
-Bootstrap — один из наиболее популярных HTML и CSS фреймворков для разработки красивых сайтов: https://getbootstrap.com/
+Bootstrap - один из самых популярных HTML и CSS фреймворков для разработки красивых сайтов: https://getbootstrap.com/
 
-Он был написан программистами, которые работали в Twitter, а сейчас совершенствуется волонтёрами со всего мира.
+Он был написан программистами из Twitter, а сейчас разрабатывается волонтерами со всего мира!
 
 ## Установка Bootstrap
 
-Для установки Bootstrap тебе нужно добавить следующие строки в `<head>` твоего `.html` файла (`blog/templates/blog/post_list.html`):
+Для установки Bootstrap необходимо добавить в `<head>` твоего `.html` файла следующее:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
 ```
 
-Это не добавит ни одного файла к твоему проекту. Эти строки просто указывают на файлы, опубликованные в Интернете. Просто продолжай, открой свой веб-сайт и обнови страницу. Вот и результат!
-
-![Рисунок 14.1][1]
+Это не добавит файлов к твоему проекту. Эти строки просто указывают на файлы опубликованные в Интернете.
 
- [1]: images/bootstrap1.png
+![Рисунок 14.1](images/bootstrap1.png)
 
 Выглядит уже лучше!
 
 ## Статические файлы в Django
 
-Теперь мы ближе познакомимся с теми таинственными **статическими файлами**. Статическими файлами называются все файлы CSS и изображения, т.е. файлы, которые не изменяются динамически, их содержание не зависит от контекста запроса и будет одинаково для всех пользователей.
+Наконец мы ближе познакомимся с тем, что называли **статическими файлами**. Статические файлы - это файлы CSS и изображения. Их содержимое не зависит от контекста запроса и будет одинаковым для всех пользователей.
 
 ### Куда поместить статические файлы в Django
 
-Django уже знает, где искать статические файлы для встроенного приложения "admin". Теперь нам нужно добавить статические файлы для своего приложения `blog`.
+Django уже знает где найти статические файлы для встроенного приложения "admin". Теперь нужно добавить несколько статических файлов в наше собственное приложение, `blog`.
 
 Мы сделаем это, создав папку `static` внутри каталога с нашим приложением:
 
-```
-djangogirls
-├── blog
-│   ├── migrations
-│   └── static
-└── mysite
-```
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
 
-Django будет автоматически находить папки `static` внутри всех каталогов твоих приложений и сможет использовать их содержимое в качестве статических файлов.
+Django автоматически найдет все папки с именем "static" внутри папок приложений. Теперь можно использовать их содержимое как статические файлы :)
 
 ## Твой первый CSS файл!
 
-Давай создадим CSS файл, чтобы добавить свой собственный стиль для твоей веб-страницы. Создай новую папку под названием `css` внутри твоей папки `static`. Затем создай новый файл под названием `blog.css` внутри папки `css`. Готово?
+Давай создадим CSS файл, чтобы украсить нашу веб-страницу. Создай новую папку под названием `css` внутри твоей папки `static`. Затем создайте новый файл под названием `blog.css` внутри папки `css`. Готова?
 
-```
-djangogirls
-└─── blog
-     └─── static
-          └─── css
-               └─── blog.css
-```
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
 
 Пришло время написать несколько строк CSS! Открой файл `blog/static/css/blog.css` в своем редакторе кода.
 
-Мы не будем здесь погружаться слишком глубоко в процесс настройки и изучения CSS, поскольку это так просто, что ты сможешь изучить этот материал самостоятельно после этого руководства. В конце этой главы мы порекомендуем тебе бесплатный курс для дальнейшего изучения.
-
-Но давай сделаем хотя бы немного. Возможно, мы могли бы изменить цвет заголовка?
-Чтобы понимать цвета, компьютеры используют специальные коды. Они начинаются с `#` и далее следуют 6 букв (A-F) и цифр (0-9). Ты можешь найти коды цветов, например, здесь: http://www.colorpicker.com/. Также можешь пользоваться [предопределенными цветами][3], такими как `red` и `green`.
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
 
- [3]: http://www.w3schools.com/cssref/css_colornames.asp
+Но давай сделаем хотя бы немного. Возможно, мы могли бы изменить цвет заголовка? Чтобы понимать цвета, компьютеры используют специальные коды. Эти коды начинаются с `#`, состоят из букв (A-F) и цифр (0-9). Например, код для синего цвета - `#0000FF`. Коды многих цветов можно найти здесь: http://www.colorpicker.com/. Также можешь пользоваться [предопределенными цветами](http://www.w3schools.com/colors/colors_names.asp), такими как `red` и `green`.
 
 В файле `blog/static/css/blog.css` тебе нужно добавить следующий код:
 
 {% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 h1 a {
-    color: #FCA205;
+    color: #FCA205;
 }
 ```
 
-`h1 a` — это CSS-селектор. Это означает, что мы применяем наши стили к каждому элементу `a` внутри элемента `h1` (например, когда у нас в коде что-то вроде: `<h1><a href="">link</a></h1>`). В этом случае мы говорим о том, что нужно изменить цвет элемента на `#FCA205`, то есть на оранжевый. Конечно, ты можешь указать свой собственный цвет!
+`h1 a` это CSS селектор. Это означает, что мы применяем наши стили к `любому элементу внутри элемента <code>h1`</code>. Поэтому, когда у нас есть `<h1><a href="">ссылка</a></h1>`, `h1` будет применяться стиль. В этом случае мы говорим о том, что нужно изменить цвет элемента на `#FCA205`, то есть на оранжевый. Конечно, ты можешь указать свой собственный цвет!
 
-В CSS файле мы определяем стили для элементов файла HTML. Элементы идентифицируются именами (то есть `a`, `h1`, `body`), атрибутом `class` или атрибутом `id`. Class и id – это имена, которые ты сама присваиваешь элементам. Классы (сlass) определяют группы элементов, а идентификаторы (id) указывают на конкретные элементы. Например, следующий тег может быть идентифицирован CSS с использованием имени тега `a`, класса `external_link` или идентификатора `link_to_wiki_page`:
+В CSS файле мы определяем стили для элементов файла HTML. Первый способ определить элементы — по имени. Ты должна помнить эти теги из HTML. `a`, `h1`, `head` - все это примеры имен элементов. Мы также назначить элементу `класс` или атрибут `id`. Class и id – это имена, которые ты сама присваиваешь элементам. Классы (сlass) определяют группы элементов, а идентификаторы (id) указывают на конкретные элементы. Например, следующий тег может быть идентифицирован CSS с использованием имени тега `a`, класса `external_link` или идентификатора `link_to_wiki_page`:
 
 ```html
 <a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
 ```
 
-Почитай про CSS селекторы в [CSS Selectors на w3schools][4].
-
- [4]: http://www.w3schools.com/cssref/css_selectors.asp
+Вы можете прочитать больше о CSS селекторах на [w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
 
-Затем нам также нужно сообщить нашему HTML-шаблону о том, что мы добавили CSS. Открой файл `blog/templates/blog/post_list.html` и добавь эту строку в самое начало:
+Затем нам также нужно сообщить нашему HTML-шаблону о том, что мы добавили CSS. Открой файл `blog/templates/blog/post_list.html` и добавь эту строку в самом начале:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 ```
 
-Мы просто загружаем здесь статические файлы :)
-Далее между `<head>` и `</head>`, после ссылок на файлы Bootstrap CSS, добавь такую строку:
+Мы просто загружаем статические файлы :) Между `<head>` и `</head>`, после ссылки на файлы загрузки CSS, добавьте эту строку:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <link rel="stylesheet" href="{% static 'css/blog.css' %}">
 ```
-Браузер читает файлы в порядке их следования, поэтому нам необходимо удостовериться, что файл расположен в необходимом месте. Иначе код нашего файла может переопределить код в файлах Bootstrap.
-Мы только что сказали нашему шаблону, где находится наш CSS файл.
+
+Браузер считывает файлы в том порядке, в котором он их получил, так что мы должны убедиться, что они находятся в нужном месте. В противном случае код в нашем файле может быть переопределен кодом в Bootstrap файлах. Мы только что сказали нашему шаблону, где находится наш CSS файл.
 
 Твой файл должен теперь выглядеть следующим образом:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
-    <head>
-        <title>Django Girls blog</title>
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
-        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
-    </head>
-    <body>
-        <div>
-            <h1><a href="/">Django Girls Blog</a></h1>
-        </div>
-
-        {% for post in posts %}
-            <div>
-                <p>published: {{ post.published_date }}</p>
-                <h1><a href="">{{ post.title }}</a></h1>
-                <p>{{ post.text|linebreaksbr }}</p>
-            </div>
-        {% endfor %}
-    </body>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
 </html>
 ```
 
-Ок, сохрани файл и обнови страницу!
+ОК, сохрани файл и обнови страницу!
 
-![Рисунок 14.2][5]
-
- [5]: images/color2.png
+![Рисунок 14.2](images/color2.png)
 
 Отличная работа! Может быть, мы также хотели бы добавить нашему веб-сайту немного пространства и увеличить отступ слева? Давай попробуем!
 
 {% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 body {
-    padding-left: 15px;
+    padding-left: 15px;
 }
 ```
 
 Добавь это к твоему CSS, сохрани файл и посмотри, как это работает!
 
-![Рисунок 14.3][6]
-
- [6]: images/margin2.png
+![Рисунок 14.3](images/margin2.png)
 
 Возможно, мы можем настроить шрифт нашего заголовка? Вставь это внутрь тега `<head>` в файле `blog/templates/blog/post_list.html`:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
-<link href="https://fonts.googleapis.com/css?family=Lobster&subset=latin,cyrillic" rel="stylesheet" type="text/css">
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
 ```
 
-Как и ранее, проверь порядок и вставь эту строку перед ссылкой на `blog/statid/css/blog.css`. Эта строка импортирует шрифт под названием *Lobster* из шрифтов Google (https://www.google.com/fonts).
+Как и прежде, проверьте порядок и место перед ссылкой на `blog/static/css/blog.css`. Эта строка будет импортировать шрифт *Lobster* из Google Fonts (https://www.google.com/fonts).
 
-Теперь добавь строку `font-family: 'Lobster';` в CSS файле `blog/static/css/blog.css` внутри блока определения стиля `h1 a` (код помещается между скобками `{` и `}`) и обнови страницу:
+Найди блок стилей (код между фигурными скобками `{` и `}`) для `h1` в CSS файле `blog/static/css/blog.css`. Теперь добавьте строку `font-family: 'Lobster';` между фигурными скобками и обновите страницу:
 
 {% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 h1 a {
-    color: #FCA205;
-    font-family: 'Lobster';
+    color: #FCA205;
+    font-family: 'Lobster';
 }
 ```
 
-![Рисунок 14.3][7]
-
- [7]: images/font.png
+![Рисунок 14.3](images/font.png)
 
 Отлично!
 
-Как было указано выше, в CSS используется концепция классов, которая позволяет назвать часть HTML кода и применять стили только для этой части без всякого эффекта для других. Это очень полезно, если у тебя есть, скажем, два блока div, но они выполняют совершенно разные функции (как ваш заголовок и пост), следовательно, ты не хочешь, чтобы они выглядели одинаково.
+Как упоминалось выше, CSS имеет концепцию классов. Они позволяют назвать часть HTML-кода и применить стили только к этой части, не влияя на другие части. Это может быть супер полезно! Возможно, у вас есть два div, которые делают что-то разное (например, заголовок и ваше сообщение). Класс может помочь вам сделать их выглядеть иначе.
 
-Дадим имена определённым частям HTML кода. Добавь класс под названием `page-header` в блок `div`, содержащий наш заголовок, как это сделано здесь:
+Дайте имена определенным частям HTML кода. Добавьте класс под названием `page-header` в блок `div`, содержащий ваш заголовок, как это сделано здесь:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="page-header">
-    <h1><a href="/">Django Girls Blog</a></h1>
+    <h1><a href="/">Django Girls Blog</a></h1>
 </div>
 ```
 
-А теперь добавь класс `post` в твой `div`, содержащий сообщение в блоге:
+А теперь добавьте класс `post` в ваш `div`, содержащий сообщение в блоге.
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="post">
-    <p>published: {{ post.published_date }}</p>
-    <h1><a href="">{{ post.title }}</a></h1>
-    <p>{{ post.text|linebreaksbr }}</p>
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
 </div>
 ```
 
-Теперь добавим определения блоков для различных селекторов. Селекторы, которые начинают с символа `.`, относятся к классам. В Интернете много хороших справочников по CSS, которые могут помочь тебе понять следующий код. А сейчас просто скопируй и вставь код в файл `djangogirls/static/css/blog.css`:
+А теперь добавим определения блоков для различных селекторов. Селекторы, которые начинают с символа `.` относятся к классам. Существует много хороших справочников о CSS в Интернете, которые могут помочь вам понять следующий код. А теперь, просто скопируй и вставь код в файл `djangogirls/static/css/blog.css`:
 
 {% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 .page-header {
-    background-color: #ff9400;
-    margin-top: 0;
-    padding: 20px 20px 20px 40px;
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
 }
 
 .page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
-    color: #ffffff;
-    font-size: 36pt;
-    text-decoration: none;
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
 }
 
 .content {
-    margin-left: 40px;
+    margin-left: 40px;
 }
 
 h1, h2, h3, h4 {
-    font-family: 'Lobster', cursive;
+    font-family: 'Lobster', cursive;
 }
 
 .date {
-    color: #828282;
+    float: right;
+    color: #828282;
 }
 
 .save {
-    float: right;
+    float: right;
 }
 
 .post-form textarea, .post-form input {
-    width: 100%;
+    width: 100%;
 }
 
 .top-menu, .top-menu:hover, .top-menu:visited {
-    color: #ffffff;
-    float: right;
-    font-size: 26pt;
-    margin-right: 20px;
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
 }
 
 .post {
-    margin-bottom: 70px;
+    margin-bottom: 70px;
 }
 
 .post h1 a, .post h1 a:visited {
-    color: #000000;
+    color: #000000;
 }
 ```
 
-Далее переделаем код HTML, отображающий посты, используя классы. Замени:
+Далее переделайте HTML код, отображающий посты. замените:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
-    <div class="post">
-        <p>published: {{ post.published_date }}</p>
-        <h1><a href="">{{ post.title }}</a></h1>
-        <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endfor %}
 ```
 
 в `blog/templates/blog/post_list.html` этим кодом:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="content container">
-    <div class="row">
-        <div class="col-md-8">
-            {% for post in posts %}
-                <div class="post">
-                    <div class="date">
-                        <p>Опубликовано: {{ post.published_date }}</p>
-                    </div>
-                    <h1><a href="">{{ post.title }}</a></h1>
-                    <p>{{ post.text|linebreaksbr }}</p>
-                </div>
-            {% endfor %}
-        </div>
-    </div>
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        {{ post.published_date }}
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaks }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
 </div>
 ```
 
-Сохрани эти файлы и обнови свой веб-сайт.
-
-![Рисунок 14.4][8]
+Сохраните эти файлы и обновить свой веб-сайт.
 
- [8]: images/final.png
+![Рисунок 14.4](images/final.png)
 
-Юхууу! Выглядит прекрасно, не так ли? Код, который мы только что вставили, на самом деле не сложный для понимания, и ты, просто прочитав его, сможешь понять большую часть.
+Юююхуууу! Выглядит неплохо, ведь так? :) Посмотрите на код, который мы только что вставили. Мы добавили классы в HTML и использовали их в CSS. Где бы вы вносили изменения, если бы вы хотели, чтобы дата была бирюзой?
 
-Не бойся немного повозиться с этим CSS-файлом и попробуй поменять некоторые вещи. Если что-то сломается, не волнуйся, ты всегда можешь отменить предыдущее действие!
+Не бойтесь возиться с CSS - попробуйте изменить некоторые вещи. Игра с CSS может помочь вам понять, что делают разные вещи. Если вы нарушите что-то, не беспокойтесь - вы всегда можете отменить это!
 
-В любом случае, мы настоятельно рекомендуем пройти бесплатный онлайн курс [Codeacademy HTML & CSS course ][2] в виде домашней работы после воркшопа, чтобы изучить всё, что нужно знать об оформлении веб-сайтов с помощью CSS.
+Мы настоятельно рекомендуем пройти бесплатный курс [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). Это может помочь вам узнать все о том, что делает ваши сайты красивее с CSS.
 
-Готова к следующей главе?! :)
+Готовы к следующей главе?! :)
\ No newline at end of file
diff --git a/ru/deploy/README.md b/ru/deploy/README.md
index 694ef34f7c4..d0168dd9e54 100755
--- a/ru/deploy/README.md
+++ b/ru/deploy/README.md
@@ -1,308 +1,254 @@
-# Разверните!
+# Публикация!
 
 > **Примечание**: Эта глава может показаться сложной. Будь упорна, развертывание сайта на сервере является важной частью веб-разработки. Данная глава намеренно расположена в середине учебника для того, чтобы твой наставник смог помочь с таким мудреным процессом, как публикация сайта. Так ты сможешь самостоятельно закончить все главы, даже если время будет поджимать.
 
-До настоящего момента твой сайт был доступен только для локального просмотра, теперь же ты узнаешь, как развернуть его на удалённом сервере! Развертывание (deploy) — это процесс публикации приложения в интернете, чтобы люди могли наконец увидеть твое творение :)
+До сих пор твой сайт был доступен только с твоего компьютера. Сейчас ты узнаешь, как "развернуть" свой сайт! Развертывание (deploy) — это процесс публикации приложения в интернете, чтобы люди могли наконец увидеть твое творение. :)
 
-Как ты уже знаешь, веб-сайт должен располагаться на сервере. Есть много компаний, предоставляющих сервера в интернете. Мы воспользуемся услугами одной из них, с довольно простым процессом публикации: [PythonAnywhere][1]. PythonAnywhere бесплатен для маленьких приложений с небольшим числом посетителей, и этого будет для нас более чем достаточно.
+Как ты уже знаешь, веб-сайт должен располагаться на сервере. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
- [1]: https://pythonanywhere.com/
+Другим внешним сервисом, которым мы будем пользоваться, является [GitHub](https://www.github.com) — сервис хостинга кода. Существуют и другие похожие сервисы, но практически у каждого программиста есть GitHub аккаунт, теперь будет и у тебя!
 
-Другим внешним сервисом, которым мы воспользуемся, будет [GitHub][2] — сервис хостинга кода. Существуют и другие похожие сервисы, но практически у каждого программиста есть GitHub аккаунт, теперь будет и у тебя!
-
- [2]: https://www.github.com
-
-В итоге твой код будет в трёх местах. На локальном компьютере ты будешь заниматься разработкой и тестированием. Когда результат тебя устроит, ты загрузишь свою программу на GitHub. А твой сайт будет на PythonAnywhere, и ты сможешь обновлять его, просто загружая новую версию кода с GitHub.
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
 
 # Git
 
-> **Примечание:** если ты уже выполнила установку, незачем повторять её вновь — можешь сразу переходить к следующему разделу и начать создание собственного Git-репозитория.
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
 
 {% include "/deploy/install_git.md" %}
 
 ## Создаём Git-репозиторий
 
-Git отслеживает изменения определенного набора файлов, который называется репозиторием (сокращенно "репо"). Давайте создадим такой для нашего проекта. Открой консоль и запусти эти команды в папке `djangogirls`:
+Git отслеживает изменения определенного набора файлов, которая называется репозиторием (сокращенно "репо"). Давайте создадим один для нашего проекта. Откройте консоль и запустите эти команды в папке `djangogirls`:
 
-> **Примечание:** проверь текущий рабочий каталог с помощью команд `pwd` (OSX/Linux) или `cd` (Windows) перед инициализацией нового репозитория. Ты должна находиться в директории `djangogirls`.
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. Ты должна находиться в директории `djangogirls`.
 
 {% filename %}command-line{% endfilename %}
-```
-$ git init
-Initialized empty Git repository in ~/djangogirls/.git/
-$ git config --global user.name "Your Name"
-$ git config --global user.email you@example.com
-```
 
-Инициализировать git-репозиторий придется только один раз за проект (и тебе больше не придется вводить имя пользователя и адрес электронной почты).
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
 
 Git будет отслеживать изменения всех файлов и каталогов в заданной директории, однако некоторые из них мы предпочли бы игнорировать. Для этого нам нужно создать файл `.gitignore` в корневом каталоге репозитория. Открой редактор и создай новый файл со следующим содержанием:
 
 {% filename %}.gitignore{% endfilename %}
-```
-*.pyc
-*~
-__pycache__
-myvenv
-db.sqlite3
-/static
-.DS_Store
-```
 
-И сохрани его как `.gitignore` в корневом каталоге "djangogirls".
+    *.pyc
+    __pycache__
+    myvenv
+    db.sqlite3
+    .DS_Store
+    
 
-> **Примечание:** точка в начале имени файла имеет важное значение! Если у тебя есть проблемы с созданием таких файлов (Mac не позволит создать файл с названием, начинающимся с точки, через Finder, например), тогда используй кнопку «Сохранить как» в меню своего редактора кода, это точно поможет.
+И сохрани его как `.gitignore` в корневом каталоге "djangogirls".
 
-> **Примечание:** среди файлов, которые мы перечислили в `.gitignore`, есть `db.sqlite3`. Этот файл содержит твою локальную базу данных, где будут храниться твои посты. Мы не добавляем его в репозиторий, поскольку твой сайт на PythonAnywhere будет использовать другую базу данных. Эта база данных тоже может быть SQLite, как на твоём рабочем компьютере, но обычно используется MySQL, которая может справиться с большим количеством посетителей, чем SQLite. В любом случае, поскольку мы не копируем базу данных SQLite на Github, все посты, которые ты уже создала, будут доступны только на твоём локальном компьютере, и тебе придётся заново создать их на опубликованном сайте. Рассматривай свою локальную базу данных как удобную игровую площадку, где ты можешь тестировать различные идеи и не бояться удалить настоящий пост из своего блога.
+> **Примечание**: Точка в начале имени файла имеет важное значение! Если у тебя есть проблемы с созданием таких файлов (Mac не позволит создать файл с названием, начинающимся с точки, через Finder, например), тогда используй кнопку "Сохранить как" в меню своего редактора кода, это точно поможет.
+> 
+> **Примечание** Один из файлов, заданных в ваш файл `.gitignore` — `db.sqlite3`. Этот файл является локальной базой данных, где хранятся все ваши сообщения. Мы не будем добавлять ее к нашему репозиторию, потому что наш сайт на PythonAnywhere будет использовать другую базу данных. Эта база данных может быть как SQLite, так и многие другие, но обычно вы будете использовать MySQL, которая может выдержать гораздо большее число посетителей, нежели SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
 
-Используй команду `git status` перед `git add` или в любой другой момент, когда ты не уверена, что изменения — хорошая идея. Это убережёт тебя от таких неприятных сюрпризов, как добавление неправильных файлов. Команда `git status` возвращает информацию обо всех ранее неотслеживаемых/изменённых/добавленных в git файлах, а также статус ветки и многое другое. Результат должен быть похож на:
+Использовать команду `git status` перед `git add` или в любой другой момент, когда ты не уверен, что изменилось — хорошая идея. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-On branch master
-
-Initial commit
-
-Untracked files:
-  (use "git add <file>..." to include in what will be committed)
-
-        .gitignore
-        blog/
-        manage.py
-        mysite/
 
-nothing added to commit but untracked files present (use "git add" to track)
-```
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
 
 И, наконец, мы сохраним наши изменения. Переключись на консоль и набери:
 
 {% filename %}command-line{% endfilename %}
-```
-$ git add --all .
-$ git commit -m "My Django Girls app, first commit"
- [...]
- 13 files changed, 200 insertions(+)
- create mode 100644 .gitignore
- [...]
- create mode 100644 mysite/wsgi.py
- ```
-
-
-## Загружаем код в репозиторий GitHub
-
-Зайди на [GitHub.com][2] и создай новую бесплатную учётную запись (если это уже сделано во время подготовки к воркшопу — здорово!).
-
-Затем создай новый репозиторий и назови его "my-first-blog". Не выбирай опцию "initialise with a README", не создавай файл .gitignore (мы сделаем это локально сами) и оставь лицензию None.
-
-![][3]
-
- [3]: images/new_github_repo.png
-
-> **Примечание:** имя репозитория `my-first-blog` для нас очень важно — ты можешь, конечно, придумать другое название, но оно будет встречаться множество раз в руководстве, и тебе придется заменять его каждый раз на своё. Будет проще для начала остановиться на нашем варианте: `my-first-blog`.
-
-На следующем экране ты найдёшь URL для клонирования репозитория. Выбери вариант "HTTPS" и скопируй ссылку:
-
-![][4]
-
- [4]: images/github_get_repo_url_screenshot.png
-
-Теперь нужно связать локальный репозиторий с репозиторием на GitHub.
-
-Напечатай у себя в консоли следующую команду (замени `<your-github-username>` на имя, указанное при создании аккаунта на GitHub, но без угловых скобок):
-
-{% filename %}command-line{% endfilename %}
-```
-$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
-$ git push -u origin master
-```
-
-Введи свое имя пользователя и пароль от аккаунта GitHub; ты должна увидеть что-то такое:
-
-{% filename %}command-line{% endfilename %}
-```
-Username for 'https://github.com': hjwp
-Password for 'https://hjwp@github.com':
-Counting objects: 6, done.
-Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
-Total 3 (delta 0), reused 0 (delta 0)
-To https://github.com/hjwp/my-first-blog.git
- * [new branch]      master -> master
-Branch master set up to track remote branch master from origin.
-```
-
-<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
-
-Твой код теперь на GitHub. Зайди на сайт и проверь! Ты найдешь его в хорошей компании: [фреймворк Django][5], [этот учебник][6], а также многие другие великолепные проекты с исходным кодом размещены на GitHub :)
-
-
- [5]: https://github.com/django/django
- [6]: https://github.com/DjangoGirls/tutorial
-
-# Настройка нашего блога на PythonAnywhere
-
-> **Примечание:** возможно, ты уже завела учётную запись на PythonAnywhere ранее — если так, нет нужды повторять это вновь.
-
-{% include "/deploy/signup_pythonanywhere.md" %}
 
-## Загружаем код на PythonAnywhere
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+    [...]
+    13 files changed, 200 insertions(+)
+    create mode 100644 .gitignore
+    [...]  create mode 100644 mysite/wsgi.py
+    ``` 
+    
+    
+    ## Публикация на GitHub
+    Переди на [GitHub.com](https://www.github.com) и зарегистрируй новый бесплатный аккаунт. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />Примечание: Имя репозитория my-first-blog имеет большое значение - ты, конечно, можешь придумать другое название, но оно будет встречаться множество раз в руководстве и тебе придется заменять его каждый раз на свое. Вероятно, проще просто придерживаться имени `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Зайди на сайт и проверь!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Давай загрузим наш код из GitHub на PythonAnywhere, создав "клон" репозитория. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-После регистрации на PythonAnywhere ты будешь перемещена на страницу «Consoles». Выбери опцию старта консоли «Bash» — это версия консоли PythonAnywhere, аналогичная твоему локальному терминалу.
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
 
-<img src="images/pythonanywhere_bash_console.png" alt="Указатель на Bash при выборе консоли" />
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-> **Примечание:** PythonAnywhere использует Linux, так что если ты используешь Windows, то терминал и команды могут немного отличаться от того, к чему ты привыкла на своём компьютере.
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
 
-Давай загрузим наш код из GitHub на PythonAnywhere, создав «клон» репозитория. Введи следующую команду в консоли на PythonAnywhere (не забудь заменить `<your-github-username>` на свою учётку GitHub):
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-{% filename %}PythonAnywhere command-line{% endfilename %}
-```
-$ git clone https://github.com/<your-github-username>/my-first-blog.git
-```
-
-Эта команда загрузит копию твоего кода на PythonAnywhere. Проверь это, набрав `tree my-first-blog`:
-
-{% filename %}PythonAnywhere command-line{% endfilename %}
-```
-$ tree my-first-blog
-my-first-blog/
-├── blog
-│   ├── __init__.py
-│   ├── admin.py
-│   ├── migrations
-│   │   ├── 0001_initial.py
-│   │   └── __init__.py
-│   ├── models.py
-│   ├── tests.py
-│   └── views.py
-├── manage.py
-└── mysite
-    ├── __init__.py
-    ├── settings.py
-    ├── urls.py
-    └── wsgi.py
-```
-
-
-### Создаём виртуальное окружение на PythonAnywhere
-
-Так же как ты делала на своем компьютере, ты можешь создать виртуальное окружение на PythonAnywhere. В консоли Bash введи следующую команду:
-
-{% filename %}PythonAnywhere command-line{% endfilename %}
-```
 $ cd my-first-blog
 
-$ virtualenv --python=python3.6 myvenv
-Running virtualenv with interpreter /usr/bin/python3.6
-[...]
-Installing setuptools, pip...done.
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
 
 $ source myvenv/bin/activate
 
-(myvenv) $  pip install django~=1.11.0
-Collecting django
-[...]
-Successfully installed django-1.11.3
-```
-
-
-> **Примечание:** выполнение команды `pip install` может занять несколько минут. Терпение, терпение! Однако если это заняло больше 5 минут, что-то не так. Спроси своего инструктора.
-
-<!--TODO: think about using requirements.txt instead of pip install.-->
-
-### Создаём базу данных на PythonAnywhere
-
-Есть ещё одно отличие твоего локального компьютера и сервера — они используют разные базы данных. Таким образом, пользовательские аккаунты и записи в блоге на сервере и локальном компьютере могут отличаться друг от друга.
-
-Нам нужно инициализировать базу данных на сервере так же, как мы это сделали на твоем компьютере, — с помощью команд `migrate` и `createsuperuser`:
-
-{% filename %}PythonAnywhere command-line{% endfilename %}
-```
-(mvenv) $ python manage.py migrate
-Operations to perform:
-[...]
-  Applying sessions.0001_initial... OK
-(mvenv) $ python manage.py createsuperuser
-```
-
-## Публикация нашего блога как веб-приложения
-
-Теперь наш код загружен на PythonAnywhere, виртуальное окружение готово и база данных инициализирована — мы готовы опубликовать блог как веб-приложение!
-
-Вернись в панель управления PythonAnywhere, нажав на лого в верхнем левом углу, затем переключись на вкладку **Web** и нажми кнопку **Add a new web app**.
-
-После подтверждения доменного имени выбери **Manual configuration** (NB: *не* «Django»!) в диалоговом окне. Затем выбери **Python 3.6** и заверши работу мастера.
-
-> **Примечание:** убедись, что ты выбрала опцию "Manual configuration", а не "Django". Мы слишком круты для стандартного настройщика PythonAnywhere для Django ;-)
-
-### Настройка виртуального окружения
-
-Ты будешь перенесена на страницу настройки веб-приложения PythonAnywhere, куда тебе будет нужно заходить каждый раз, когда потребуется внести изменения в приложении на сервере.
-
-![][7]
-
- [7]: images/pythonanywhere_web_tab_virtualenv.png
-
-В секции "Virtualenv" кликни по красному тексту "Enter the path to a virtualenv" и набери `/home/<your-username>/my-first-blog/myvenv/`. Нажми на синий прямоугольник с галочкой, чтобы сохранить изменения, прежде чем двигаться дальше.
-
-> **Примечание**: замени имя пользователя на своё. Если ты допустишь ошибку, PythonAnywhere выдаст предупреждение.
-
-### Настройка файла WSGI
-
-Django использует протокол WSGI, стандартный протокол для обслуживания веб-сайтов, использующих Python, который поддерживается PythonAnywhere. Используя файл настроек WSGI, мы позволим PythonAnywhere распознать наш Django блог.
-
-Кликни по ссылке "WSGI configuration file" (в секции «Code» наверху страницы — она будет выглядеть следующим образом: `/var/www/<your-username>_pythonanywhere_com_wsgi.py`), и ты переключишься на редактор.
-
-Удали все содержимое и замени его чем-то вроде этого:
-
-{% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
-```python
-import os
-import sys
-
-path = os.path.expanduser('~/my-first-blog')
-if path not in sys.path:
-    sys.path.append(path)
-
-os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
-
-from django.core.wsgi import get_wsgi_application
-from django.contrib.staticfiles.handlers import StaticFilesHandler
-application = StaticFilesHandler(get_wsgi_application())
-```
-
-Задача данного файла — сказать PythonAnywhere, где находится наше веб-приложение и как называется файл настроек Django.
-
-`StaticFilesHandler` нужен для обработки наших CSS. Она происходит автоматически во время разработки при запуске `runserver`. Мы чуть больше узнаем о статических файлах чуть позже, когда будем изменять стили нашего сайта.
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. Мы ближе познакомимся со статическими файлами в дальнейшем, когда начнем писать CSS для нашего сайта.
 
 Нажми **Save** и переключись на вкладку **Web**.
 
-Мы всё сделали! Нажми на большую зеленую кнопку **Reload**, и можешь проверить своё приложение. Ссылку можно найти в верхней части страницы.
+Мы все сделали! Нажми на большую зеленую кнопку **Reload** и можешь проверять свое приложение. Ссылку можно найти в верхней части страницы.
 
 ## Советы по отладке
 
-Если видишь ошибку при попытке посетить свой сайт, для получения отладочной информации первым делом просмотри **журнал ошибок**. Ссылку на него ты найдёшь на [вкладке Web][8] на PythonAnywhere. Посмотри, нет ли там сообщений о каких-нибудь ошибках; самые последние из них приведены ниже. Они включают:
-
- [8]: https://www.pythonanywhere.com/web_app_setup/
-
--   Пропуск одного из шагов в консоли: создание virtualenv, её активация, установка Django в виртуальное окружение, инициализация базы данных.
+Если видишь ошибку при попытке посетить свой сайт, для отладочной информации первым делом смотри **журнал ошибок**. Ссылку на него ты найдёшь на [вкладке Web](https://www.pythonanywhere.com/web_app_setup/) на PythonAnywhere. Посмотри, нет ли там сообщений о каких-нибудь ошибках; самые последние из них приведены ниже. Они включают:
 
--   Ошибка в пути к virtualenv — рядом должно появиться небольшое предупреждение, если PythonAnywhere не может найти виртуальное окружение по указанному адресу.
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
 
--   Ошибка в файле настроек WSGI — ты правильно указала путь к директории my-first-blog?
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
 
--   Ты выбрала одну и ту же версию Python для virtualenv и для веб-приложения? Обе должны быть 3.6.
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
 
-*   Также можешь посмотреть [общие советы по отладке на вики PythonAnywhere][9].
+- Ты выбрала одну и ту же версию Python для virtualenv и для веб-приложения? Обе должны быть 3.6.
 
- [9]: https://www.pythonanywhere.com/wiki/DebuggingImportError
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
 
-И помни: твой инструктор здесь, чтобы помогать тебе!
+И помни: твой инструктор здесь, чтобы помогать!
 
 # Ты в сети!
 
-Стандартная страница твоего сайта должна включать приветствие "Welcome to Django", точно так же как было на локальном компьютере. Попробуй добавить `/admin/` к концу адреса сайта, и перейдёшь к панели администратора сайта. Войди под своим именем и паролем и увидишь форму для добавления новых записей в блог.
+The default page for your site should say "It worked!", just like it does on your local computer. Попробуй добавить `/admin/` к концу адреса сайта и перейдешь к панели администратора сайта. Войди под своим именем и паролем и увидишь форму для добавления новых записей в блог.
 
-После того, как создашь несколько записей, ты можешь вернуться к своей локальной версии приложения (а не на PythonAnywhere). С этого момента для внесения изменений тебе нужно работать в своей локальной версии. Это обычный подход в веб-программировании: изменять код локально, загружать изменения на GitHub, а затем подтягивать изменения на сервер с сайтом. Такой подход позволяет тебе работать и экспериментировать, не рискуя сломать свой сайт. Круто, правда?
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
 
-Ты заслужила *огромную* похвалу! Развёртывание сервера — одна из самых каверзных частей веб-разработки, и нередко уходит несколько дней, прежде чем заставишь всё работать. А у нас уже есть работающий в сети веб-сайт, вот так вот!
+Ты заслужила *огромную* похвалу! Развертывание сервера — одна из самых каверзных частей веб-разработки, и не редко уходит несколько дней, прежде чем заставишь всё работать. А у нас уже есть работающий в сети веб-сайт, вот так вот!
\ No newline at end of file
diff --git a/ru/deploy/install_git.md b/ru/deploy/install_git.md
index 9382ebdcb11..db272fd1968 100755
--- a/ru/deploy/install_git.md
+++ b/ru/deploy/install_git.md
@@ -1,50 +1,52 @@
-Git — это «система управления версиями», используемая множеством программистов. Эта программа отслеживает изменения, происходящие с файлами, чтобы впоследствии можно было восстановить состояние кода на нужный момент времени. Это немного похоже на функцию отслеживания изменений в Microsoft Word, но куда мощнее.
+Git — это "система управления версиями", используемая множеством программистов. Эта программа отслеживает изменения, происходящие с файлами, чтобы впоследствии можно было восстановить состояние кода на нужный момент времени. Это немного похоже на функцию отслеживания изменений в Microsoft Word, но куда мощнее.
 
 ## Установка Git
 
-<!--sec data-title="Windows" data-id="git_install_windows"
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
 data-collapse=true ces-->
 
-Ты можешь загрузить Git с официального сайта [git-scm.com](https://git-scm.com/). Ты можешь нажимать "дальше, дальше, дальше" на всех этапах установки за исключением одного: на пятом шаге, который называется "Adjusting your PATH environment" (Настройка системной переменной Path), выбери "Use Git and optional Unix tools from the Windows Command Prompt" (Запуск Git и соответствующих Unix утилит через командную строку Windows, нижняя опция). Все остальные настройки можно оставить по умолчанию. Также неплохо будет выбрать опцию "Checkout Windows-style, commit Unix-style line endings".
+Ты можешь загрузить Git с официального сайта [git-scm.com](https://git-scm.com/). Ты можешь нажимать кнопку "Далее" ("Next") на всех этапах, кроме одного; на 5-м шаге с названием "Настройка переменной PATH", выберите "Использовать Git и дополнительные инструменты UNIX из командной строки Windows"(нижняя кнопка). Все остальные настройки можно оставить по умолчанию. Опция "Checkout Windows-style, commit Unix-style line endings" будет неплохим выбором.
 
-После окончания установки не забудь перезапустить командную строку или powershell.
-<!--endsec-->
+Не забудьте перезагрузить (закрыть и открыть заново) командную строку или powershell после успешной установки. <!--endsec-->
 
-<!--sec data-title="OS X" data-id="git_install_OSX"
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
 data-collapse=true ces-->
 
 Загрузи Git с официального сайта [git-scm.com](https://git-scm.com/) и просто следуй инструкциям по установке.
 
-> **Примечание:** если ты используешь OS X 10.6, 10.7 или 10.8, тебе придётся установить git отсюда: [Установка Git для OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+> **Заметка** Если вы используете OS X 10.6, 10.7, or 10.8, вам необходимо установить версию git, расположенную здеесь: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
 
 <!--endsec-->
 
-<!--sec data-title="Debian и Ubuntu" data-id="git_install_debian_ubuntu"
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
 data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
+
 ```bash
 $ sudo apt-get install git
 ```
 
 <!--endsec-->
 
-<!--sec data-title="Fedora" data-id="git_install_fedora"
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
 data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
+
 ```bash
 $ sudo dnf install git
 ```
 
 <!--endsec-->
 
-<!--sec data-title="openSUSE" data-id="git_install_openSUSE"
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
 data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
+
 ```bash
 $ sudo zypper install git
 ```
 
-<!--endsec-->
+<!--endsec-->
\ No newline at end of file
diff --git a/ru/deploy/signup_pythonanywhere.md b/ru/deploy/signup_pythonanywhere.md
index 823a5146e54..ca66bd0de69 100755
--- a/ru/deploy/signup_pythonanywhere.md
+++ b/ru/deploy/signup_pythonanywhere.md
@@ -1,5 +1,5 @@
-Теперь нам потребуется создать бесплатный аккаунт уровня "Beginner" на PythonAnywhere.
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
 
-  * [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
 
-> **Примечание:** при выборе имени пользователя помни, что URL блога примет вид `yourusername.pythonanywhere.com`, так что остановись либо на своём нике, либо на имени, связанном с тематикой блога.
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ru/django/README.md b/ru/django/README.md
index ec5d5790b8b..e98bbf770c5 100755
--- a/ru/django/README.md
+++ b/ru/django/README.md
@@ -1,27 +1,27 @@
-# Что такое Django?
+# Что же представляет из себя Django?
 
-Django (*/ˈdʒæŋɡoʊ/ джанго*) — бесплатный и свободный фреймворк для веб-приложений, написанный на Python. Фреймворк — это набор компонентов, которые помогают разрабатывать веб-сайты быстро и просто.
+Django - бесплатный web-фреймворк, написанный на Python. Фреймворк - это набор компонентов, которые помогают разрабатывать веб-сайты быстро и просто.
 
 Каждый раз при разработке веб-сайтов требуются похожие компоненты: способ аутентифицировать пользователей (вход, выход, регистрация), панель управления сайтом, формы, инструменты для загрузки файлов и т. д.
 
-К счастью для нас, другие люди обратили внимание на возникновение однотипных проблем при веб-разработке, так что они объединились и создали фреймворки (Django и другие), которые предлагают нам готовые шаблоны для использования.
+К счастью, другие люди уже обратили внимание на возникновение однотипных проблем при веб-разработке, так что они объединились и создали фреймворки (Django и другие), которые предлагают нам готовые шаблоны для использования.
 
-Фреймворки существуют, чтобы облегчить процесс разработки и позволить нам не изобретать колесо.
+Фреймворки существуют, чтобы облегчить процесс разработки и позволить нам не изобретать велосипед.
 
 ## Зачем нам нужен фреймворк?
 
-Чтобы понять, для чего же нам нужен Django, нам нужно ближе познакомиться с серверами. Во-первых, сервер должен узнать о том, что мы ждём от него веб-страницу.
+Чтобы понять, для чего же нам нужен Django, нам нужно ближе познакомиться с серверами. Во-первых, сервер должен узнать о том, что мы ждем от него веб-страницу.
 
-Представь себе почтовый ящик (порт), который проверяется на наличие новых писем (запросов). Это делает веб-сервер. Когда письмо приходит, сервер читает его и отправляет ответ с веб-страничкой. Однако чтобы что-то отправить, нам надо это что-то иметь. И Django как раз и отвечает за создание контента, который будет отправлен в ответе.
+Представь себе почтовый ящик (порт), который проверяется на наличие новых писем (запросов). Это делает веб-сервер. Веб-сервер читает письмо, а затем отправляет ответ (веб-страницу). Однако, чтобы что-то отправить нам надо это что-то иметь. И Django как раз и отвечает за создание контента, который будет отправлен в ответе.
 
 ## Что происходит, когда кто-то запрашивает веб-сайт у твоего сервера?
 
-Когда на сервер приходит запрос, он переадресуется Django, который пытается сообразить, что же конкретно от него просят. Для начала он берет адрес веб-страницы и пробует понять — что же нужно сделать. Эту часть процесса в Django выполняет **urlresolver** (адрес веб-сайта называется URL — Uniform Resource Locator — Единый указатель ресурсов, так что название *urlresolver*, resolver == определитель, имеет определенный смысл). Он не слишком умён, поэтому просто берет список шаблонов и пытается сопоставить их с URL. Django сверяет шаблоны сверху вниз и, если что-то совпадает, он переправляет запрос соответствующей функции (которая называется *view*).
+Когда на сервер приходит запрос, он переадресуется Django, который пытается понять что же конкретно от него просят. Для начала он берет адрес веб-страницы и пробует понять, что нужно делать. За эту часть в Django отвечает **urlresolver** (адрес веб-сайта называется URL - Uniform Resource Locator - Единый указатель ресурсов, так что название *urlresolver*, resolver == определитель, имеет определенный смысл). Он не слишком умен, поэтому просто берет список шаблонов и пытается сопоставить их с URL. Django сверяет шаблоны сверху вниз и, если что-то совпадает, он переправляет запрос соответствующей функции (которая называется *view*).
 
-Представь себе почтальона с письмом. Она идет вниз по улице и сверяет номера домов с адресом на письме. Если они совпадают, то она оставляет письмо. Так же работает и urlresolver!
+Представь себе почтальона с письмом. Она идет вниз по улицы и сверяет номера домов с адресом на письме. Если они совпадают, то она оставляет письмо. Так же работает и urlresolver!
 
-Но самые интересные вещи происходят в функции *view*: мы, например, можем обращаться к базе данных за определенной информацией. Может быть пользователь попросил изменить какую-нибудь информацию? Как будто в письме написано: "Пожалуйста, поменяйте описание моей работы." Функция *view* может проверить, имеете ли вы разрешение делать это, а затем обновит описание работы и отправит обратно ответ: "Готово!". Затем функция *view* сгенерирует ответ, и Django сможет отправить его веб-браузеру пользователя.
+Но самые интересные вещи происходят в функции *view*: мы, например, можем обращаться к базе данных за определенной информацией. Может быть пользователь попросил изменить какую-нибудь информацию? Как будто в письме написано: "Пожалуйста, поменяйте описание моей работы". Функция *view* может проверить, имеете ли вы разрешение делать это, а затем обновит описание работы и отправит обратно ответ: "Готово!"
 
 В реальности все немного сложнее, однако тебе не обязательно знать все технические навороты прямо сейчас. Достаточно основной концепции.
 
-Так что вместо погружения в пучины нюансов мы просто начнем работать с Django и познакомимся со всеми важными особенностями по мере продвижения!
+Так что вместо погружения в пучины нюансов, мы просто начнем работать с Django и познакомимся со всеми важными особенностями по мере продвижения!
\ No newline at end of file
diff --git a/ru/django_admin/README.md b/ru/django_admin/README.md
index 146a70a6839..99c7b7ce8aa 100755
--- a/ru/django_admin/README.md
+++ b/ru/django_admin/README.md
@@ -1,10 +1,11 @@
 # Администрирование Django
 
-Чтобы добавлять, редактировать и удалять записи, для которых мы только что создали модель, мы используем панель управления администратора Django.
+To add, edit and delete the posts we've just modeled, we will use Django admin.
 
-Давай откроем файл `blog/admin.py` и заменим его содержимое на:
+Let's open the `blog/admin.py` file and replace its contents with this:
 
 {% filename %}blog/admin.py{% endfilename %}
+
 ```python
 from django.contrib import admin
 from .models import Post
@@ -12,44 +13,45 @@ from .models import Post
 admin.site.register(Post)
 ```
 
-Как ты можешь заметить, мы импортировали (включили) модель Post, которую определили в предыдущей главе. Чтобы наша модель стала доступна на странице администрирования, нам нужно зарегистрировать её при помощи `admin.site.register(Post)`.
+Как ты можешь заметить, мы импортировали (включили) модель Post, которая была определена в предыдущей главе. Чтобы наша модель стала доступна на странице администрирования, нам нужно зарегистрировать её при помощи `admin.site.register(Post)`.
 
-Хорошо, теперь нам нужно взглянуть на модель Post. Не забудь запустить веб-сервер командой `python manage.py runserver`. Перейди в браузер и набери адрес http://127.0.0.1:8000/admin/. Ты увидишь страницу авторизации:
+Хорошо, теперь нам нужно взглянуть на модель Post. Не забудь запустить веб-сервер командой `python manage.py runserver`. Go to your browser and type the address http://127.0.0.1:8000/admin/. Ты увидишь страничку авторизации:
 
-![Страница авторизации][1]
+![Страница авторизации](images/login_page2.png)
 
- [1]: images/login_page2.png
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
 
-Чтобы залогиниться, тебе сначала нужно создать *суперпользователя (англ. superuser)* — пользователя, который имеет полный доступ к управлению сайтом. Вернись к командной строке, набери `python manage.py createsuperuser`, и нажми Enter.
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
 
-> Не забудь: чтобы выполнять команды во время работы сервера, открой новое окно терминала и активируй в нём виртуальное окружение. Мы описывали ввод новых команд в разделе <b>Запуск веб-сервера</b> главы <b>Твой первый проект на Django!</b>.
+{% filename %}Mac OS X or Linux:{% endfilename %}
 
-При появлении запроса введи имя пользователя (строчными буквами, без пробелов), адрес электронной почты и пароль. Не беспокойся, если пароль не появляется на экране по мере ввода, так и задумано. Просто напечатай его и нажми `Enter`, чтобы продолжить. Результат должен выглядеть следующим образом (имя пользователя и почта, соответственно, будут твоими):
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
 
-{% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py createsuperuser
-Username: admin
-Email address: admin@admin.com
-Password:
-Password (again):
-Superuser created successfully.
-```
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
 
-Вернись в браузер и войди в систему при помощи имени пользователя и пароля, которые ты только что выбрала. Ты должна попасть в панель управления Django.
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
 
-![Администрирование Django][2]
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
 
- [2]: images/django_admin3.png
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
 
-Перейди к разделу Posts и немного поэкспериментируй с ним. Добавь пять или шесть постов. Не беспокойся о содержании — можешь просто скопировать и вставить текст из этого учебника, чтобы сэкономить время :)
+![Django admin](images/django_admin3.png)
 
-Убедись, что выбрала для двух или трёх записей (но не больше) дату публикации. Это пригодится позднее.
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
 
-![Администрирование Django][3]
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
 
- [3]: images/edit_post3.png
+![Django admin](images/edit_post3.png)
 
-Если ты хочешь узнать больше об администрировании Django, то ознакомься с этим разделом официальной документации: https://docs.djangoproject.com/en/1.8/ref/contrib/admin/.
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
 
-Сейчас, вероятно, подходящий момент, чтобы порадовать себя кружечкой кофе (или чая), а также съесть чего-нибудь для восполнения энергии. Ты только что создала свою первую модель Django и заслужила перерыв!
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ru/django_forms/README.md b/ru/django_forms/README.md
index 2178859f898..3551ad38349 100755
--- a/ru/django_forms/README.md
+++ b/ru/django_forms/README.md
@@ -1,8 +1,8 @@
 # Формы в Django
 
-Последним, что нам стоит сделать для нашего веб-сайта, является удобный способ добавления и редактирования записей. `admin`-панель Django удобна, но её дизайн сложно изменять. С `forms` (формами) у нас будет абсолютная власть над интерфейсом блога — мы сможем сделать практически всё, что только можно придумать!
+Последним, что нам стоит сделать для нашего веб-сайта является удобный способ добавления и редактирования записей. Django `admin`-панель удобна, но её дизайн сложно изменять. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
 
-Формы Django удобны тем, что мы можем создать новую форму с нуля или воспользоваться `ModelForm` для сохранения содержимого формы в модель.
+В формах Django удобно то, что мы можем создать новую форму с нуля или воспользоваться `ModelForm` для сохранения содержимого форм в модель.
 
 Это как раз то, что нам нужно сделать: мы создадим форму для модели `Post`.
 
@@ -10,14 +10,14 @@
 
 Нам нужно создать файл с таким именем в директории `blog`.
 
-```
-blog
-   └── forms.py
-```
+    blog
+       └── forms.py
+    
 
-Теперь открой его и набери следующее:
+OK, let's open it and type the following code:
 
 {% filename %}blog/forms.py{% endfilename %}
+
 ```python
 from django import forms
 
@@ -25,71 +25,74 @@ from .models import Post
 
 class PostForm(forms.ModelForm):
 
-    class Meta:
-        model = Post
-        fields = ('title', 'text',)
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
 ```
 
 Для начала нам нужно импортировать формы Django (`from django import forms`) и, разумеется, нашу модель `Post` (`from .models import Post`).
 
-`PostForm`, как ты, вероятно, подозреваешь, — это имя для нашей формы. Нам нужно также сообщить Django, что эта форма относится к `ModelForm` (чтобы он смог поколдовать для нас) — `forms.ModelForm` поможет с этим.
+`PostForm`, как ты, вероятно, подозреваешь, это имя для нашей формы. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
 
-Дальше у нас `class Meta`, где мы определяем, какая модель будет использоваться для создания формы (`model = Post`).
+Затем, мы имеем `class Meta`, где мы определяем какая модель будет использоваться для создания формы (`model = Post`).
 
-В завершение мы можем указать, какие поля должны присутствовать в нашей форме. Сейчас нам требуются только поля `title` и `text` — `author` будет автоматически выбран в зависимости от авторизованного пользователя (тебя), а `created_date` должна автоматически проставляться в момент создания записи (т.е. через код), верно?
+В завершении мы можем указать, какие поля должны присутствовать в нашей форме. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
 
-Вот и всё! Теперь мы можем использовать форму в *представлении* и отобразить её в шаблоне.
+Вот и все! Всё, что нам теперь осталось сделать - это использовать форму в *представлении* и отобразить её в шаблоне.
 
-Поэтому снова нам необходимо создать ссылку на страницу, URL-адрес, представление и шаблон.
+So once again we will create a link to the page, a URL, a view and a template.
 
 ## Ссылка на страницу с формой
 
 Пришло время открыть файл `blog/templates/blog/base.html`. Мы добавим ссылку в элемент `div` с именем `page-header`:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Обрати внимание, что мы назвали новое представление `post_new`. Класс `glyphicon glyphicon-plus` определён в используемой нами теме bootstrap — таким образом мы выведем значок плюса.
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
 
-После добавления строки твой html-файл должен выглядеть следующим образом:
+After adding the line, your HTML file should now look like this:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
-    <head>
-        <title>Django Girls blog</title>
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
-        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
-        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
-    </head>
-    <body>
-        <div class="page-header">
-            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
-            <h1><a href="/">Django Girls Blog</a></h1>
-        </div>
-        <div class="content container">
-            <div class="row">
-                <div class="col-md-8">
-                    {% block content %}
-                    {% endblock %}
-                </div>
-            </div>
-        </div>
-    </body>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
 </html>
 ```
 
-После сохранения файла и перезагрузки страницы по адресу http://127.0.0.1:8000 ты, конечно, увидишь знакомую ошибку `NoReverseMatch`, верно?
+Сохрани файл и перезагрузи страницу по адресу http://127.0.0.1:8000, ты должна увидеть знакомую ошибку `NoReverseMatch`, так?
 
 ## URL
 
 Нам нужно открыть файл `blog/urls.py` и добавить строку:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 url(r'^post/new/$', views.post_new, name='post_new'),
 ```
@@ -97,6 +100,7 @@ url(r'^post/new/$', views.post_new, name='post_new'),
 Окончательная версия файла будет выглядеть следующим образом:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
@@ -108,103 +112,106 @@ urlpatterns = [
 ]
 ```
 
-После перезагрузки веб-сайта мы увидим ошибку `AttributeError`, поскольку представление `post_new` не реализовано. Давай добавим его прямо сейчас.
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
 
 ## Представление post_new
 
 Самое время открыть файл `blog/views.py` и добавить следующую строку к остальным, начинающимся с `from`:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from .forms import PostForm
 ```
 
-А затем наше *представление*:
+And then our *view*:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_new(request):
-    form = PostForm()
-    return render(request, 'blog/post_edit.html', {'form': form})
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Чтобы создать новую форму `Post`, нам потребуется вызвать `PostForm()` и передать её шаблону. Мы ещё вернёмся к этому *представлению*, а пока давай быстро создадим шаблон под форму.
+Чтобы создать новую форму `Post`, нам потребуется вызвать `PostForm()` и передать её шаблону. We will go back to this *view*, but for now, let's quickly create a template for the form.
 
 ## Шаблон
 
-Нам нужно создать файл `post_edit.html` в директории `blog/templates/blog`. Чтобы заставить форму работать, нам потребуется несколько вещей:
+Нам нужно создать файл `post_edit.html` в директории `blog/templates/blog`. Чтобы заставить её работать, нам потребуется несколько вещей:
 
--   Нам нужно отобразить форму. Мы можем сделать это, к примеру, простым `{% raw %}{{ form.as_p }}{% endraw %}`.
--   Строка выше должна быть обёрнута в HTML-теги `<form method="POST">...</form>`
--   Нам потребуется кнопка `Save`. Мы добавим её при помощи HTML-кнопки: `<button type="submit">Save</button>`
--   И, наконец, сразу после открытия тега `< form... >` мы должны добавить `{% raw %}{% csrf_token %}{% endraw %}`. Это очень важно, поскольку так мы делаем форму защищённой! Django будет ругаться, если ты забудешь добавить этот код:
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* Строка выше должна быть обернута в HTML-теги `<form method="POST">...</form>`.
+* Нам потребуется кнопка `Save`. Мы реализуем при помощи HTML-кнопки: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. Это очень важно, поскольку так мы делаем форму защищенной! If you forget about this bit, Django will complain when you try to save the form:
 
-![Страница CSFR Forbidden][1]
+![Страница CSFR Forbidden](images/csrf2.png)
 
- [1]: images/csrf2.png
-
-Хорошо, давай посмотрим, как должен выглядеть HTML-код в файле `post_edit.html`:
+OK, so let's see how the HTML in `post_edit.html` should look:
 
 {% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
 {% block content %}
-    <h1>New post</h1>
-    <form method="POST" class="post-form">{% csrf_token %}
-        {{ form.as_p }}
-        <button type="submit" class="save btn btn-default">Save</button>
-    </form>
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
 {% endblock %}
 ```
 
 Время обновить страницу! Ура! Форма отображается!
 
-![Новая форма][2]
-
- [2]: images/new_form2.png
+![Новая форма](images/new_form2.png)
 
-Но подожди минутку! Если ты наберёшь что-нибудь в полях `title` и `text` и попробуешь сохранить — что произойдёт?
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
 
-Ничего! Мы снова на той же странице и наш текст пропал... и новая запись не была добавлена. Так что же пошло не так?
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
 
-Ответ прост: ничего. Нам нужно сделать кое-что ещё, чтобы новое *представление* заработало.
+Ответ прост: ничего. Нам нужно сделать кое-что еще, чтобы новое *представление* заработало.
 
 ## Сохраняем данные из формы
 
-Снова открой файл `blog/views.py`. Всё, что у нас есть в представлении `post_new`, выглядит пока следующим образом:
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_new(request):
-    form = PostForm()
-    return render(request, 'blog/post_edit.html', {'form': form})
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-После отправки формы мы возвращаемся к тому же представлению, но в этот раз с новыми данными в `request`, а точнее, в `request.POST` (имя POST не имеет ничего общего с "постом" в блоге, оно связано с тем, что мы "публикуем" данные). Помнишь, что в HTML-файле определение `<form>` имеет параметр `method="POST"`? Все поля формы теперь находятся в `request.POST`. Ты не должна переименовывать `POST` во что-то другое (другое доступное значение параметра `method` — `GET`, но у нас сейчас нет времени объяснять разницу).
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? Все поля формы теперь находятся в `request.POST`. Ты не должна переименовывать `POST` во что-то другое (другое доступное значение параметра `method` - `GET`, но у нас нет времени объяснять разницу сейчас).
 
-Получается, что в представлении *view* нам нужно обработать две разные ситуации. Первая: когда мы только зашли на страницу и хотим получить пустую форму. Вторая: когда мы возвращаемся к *представлению* со всей информацией, которую мы ввели в форму. Таким образом, нам потребуется ввести условие (для этого мы будем использовать условный оператор `if`):
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. Таким образом, нам потребуется ввести условие (мы будем использовать условный оператор `if` для этой цели):
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 if request.method == "POST":
-    [...]
+    [...]
 else:
-    form = PostForm()
+    form = PostForm()
 ```
 
-Теперь заполним строку, занятую `[...]`. Если `method` — `POST`, тогда мы хотим построить `PostForm` с данными из формы, верно? Мы добьёмся этого следующим образом:
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 form = PostForm(request.POST)
 ```
 
-Легко! Дальше мы проверим, корректна ли форма (все ли необходимые поля заполнены и не отправлено ли некорректных значений). Мы сделаем это при помощи `form.is_valid()`.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
 
-Мы проверяем, допустимо ли содержимое формы, и, если всё в порядке, сохраняем её!
+Мы проверяем допустимо ли содержание формы и, если все в порядке, сохраняем её!
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 if form.is_valid():
     post = form.save(commit=False)
@@ -213,27 +220,30 @@ if form.is_valid():
     post.save()
 ```
 
-Фактически мы выполняем две операции: сохраняем форму `form.save` и добавляем автора (поскольку обязательного поля `author` нет в `PostForm`!). `commit=False` означает, что мы пока не хотим сохранять модель `Post` — сначала нужно добавить автора. В основном ты будешь использовать `form.save()`, без `commit=False`, но в данном случае нам это пригодится. `post.save()` сохранит изменения (после добавления автора), и новая запись будет создана!
+Практически мы выполняем две операции: сохраняем форму `form.save` и добавляем автора (поскольку обязательного поля `author` нет в `PostForm`). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
 
-Наконец, будет прекрасно, если мы сможем сразу переходить к странице `post_detail` после добавления новой записи, согласна? Для этого нам понадобится еще один импорт:
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import redirect
 ```
 
-Добавь эту строку в начало файла. Теперь мы можем сделать переадресацию на страницу `post_detail` для созданной записи:
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 return redirect('post_detail', pk=post.pk)
 ```
 
-`post_detail` — это имя представления, которое нам необходимо. Помнишь, что это *представление* требует переменную `pk`? Чтобы передать её представлению, мы используем аргумент `pk=post.pk`, где `post` — это новая запись в блоге!
+`post_detail` is the name of the view we want to go to. Помнишь, что это *представление* требует переменную `pk`? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
 
-Хорошо, мы многое обсудили, пора взглянуть на *представление* полностью, верно?
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_new(request):
     if request.method == "POST":
@@ -249,44 +259,42 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Проверим, всё ли работает. Перейди по адресу http://127.0.0.1:8000/post/new/, добавь текст в поля `title` и `text`, затем сохрани… и вуаля! Новая запись создана, и мы перешли на страницу `post_detail`!
+Проверим, все ли работает. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
 
-Возможно, ты заметила, что мы устанавливаем дату публикации перед сохранением поста. В последствии мы сделаем _кнопку публикации_ в __Django Girls Tutorial: Extensions__.
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
 
 Это круто!
 
-> Поскольку мы недавно использовали панель администратора Django, система до сих пор думает, что мы авторизованы. Существует несколько случаев, когда мы можем случайно выйти из аккаунта (закрытие браузера, перезапуск базы данных и т.д.). Если ты получаешь ошибку при попытке сохранения записи, то потребуется перейти на страницу http://127.0.0.1:8000/admin и авторизоваться в системе снова. Это решит проблему. В главе **Домашнее задание: добавляем безопасность нашему веб-сайту!** после основного учебника описано окончательное решение этой проблемы.
-
-![Ошибка при выходе из аккаунта][4]
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. Это решит проблему. В главе **Домашнее задание: добавляем безопасность нашему веб-сайту!** после основного учебника приводится перманентное исправление.
 
- [4]: images/post_create_error.png
+![Ошибка при выходе из аккаунта](images/post_create_error.png)
 
 ## Валидация формы
 
-Теперь мы покажем тебе, насколько круты формы в Django. Запись в блоге должна иметь поля `title` и `text`. В нашей модели `Post` мы не указываем, что эти поля необязательны (в отличие от `published_date`), так что Django по умолчанию будет ожидать, что пользователь их заполнит.
+Теперь мы покажем тебе насколько круты формы в Django. Запись в блоге должна иметь поля `title` и `text`. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
 
-Попробуй сохранить форму с незаполненными полями `title` и `text`. Угадай, что произойдёт!
+Try to save the form without `title` and `text`. Guess what will happen!
 
-![Валидация формы][3]
+![Валидация формы](images/form_validation2.png)
 
- [3]: images/form_validation2.png
-
-Django заботится о проверке всех полей в нашей форме на корректность. Разве не шикарно?
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
 
 ## Форма редактирования
 
-Теперь мы знаем, как добавить новую форму. Но что, если мы хотим внести исправления в уже существующую запись? По сути это схожая с предыдущей задача. Давай быстро создадим пару важных вещей (если ты чего-то не понимаешь, спроси своего тренера или загляни в предыдущие главы, поскольку мы уже объясняли все необходимые шаги).
+Теперь мы знаем как добавить новую форму. Но что, если мы хотим внести исправления в уже существующую запись? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
 
-Открой `blog/templates/blog/post_detail.html` и добавь следующую строку:
+Open `blog/templates/blog/post_detail.html` and add the line
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
 
-так, чтобы шаблон выглядел следующим образом:
+so that the template will look like this:
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -307,15 +315,17 @@ Django заботится о проверке всех полей в нашей
 В файле `blog/urls.py` добавь:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
     url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
 ```
 
 Мы будем использовать повторно шаблон `blog/templates/blog/post_edit.html`, так что осталось лишь отсутствующее *представление*.
 
-Давай откроем файл `blog/views.py` и добавим в самый конец следующее:
+Let's open `blog/views.py` and add this at the very end of the file:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_edit(request, pk):
     post = get_object_or_404(Post, pk=pk)
@@ -332,108 +342,106 @@ def post_edit(request, pk):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Выглядит практически идентично представлению `post_new`, верно? Но не совсем. Во-первых, мы передаём параметр `pk` из URL-адреса. Кроме того, мы получаем модель `Post` для редактирования при помощи `get_object_or_404(Post, pk=pk)` и передаём экземпляр post в качестве `instance` форме и при сохранении…
+Выглядит практически идентично представлению `post_new`, верно? Но не совсем. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 form = PostForm(request.POST, instance=post)
 ```
 
-… и когда мы открываем форму для редактирования:
+…and when we've just opened a form with this post to edit:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 form = PostForm(instance=post)
 ```
 
-Хорошо, давай удостоверимся, что всё работает! Перейди на страницу `post_detail`. Ты должна увидеть кнопку редактирования в правом верхнем углу:
-
-![Кнопка Редактировать (Edit)][5]
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
 
- [5]: images/edit_button2.png
+![Кнопка редактирования](images/edit_button2.png)
 
-Когда ты её нажмёшь, то увидишь форму с выбранной записью:
+Когда ты её нажмешь, то увидишь форму с выбранной записью:
 
-![Форма редактирования][6]
+![Форма редактирования](images/edit_form2.png)
 
- [6]: images/edit_form2.png
+Feel free to change the title or the text and save the changes!
 
-Поменяй заголовок и текст, а затем сохрани запись!
+Поздравляем! Твое приложение становится все более сложным!
 
-Поздравляем! Твое приложение становится всё более сложным!
-
-Если тебе нужно больше информации о формах в Django, обратись к официальной документации: https://docs.djangoproject.com/en/1.11/topics/forms/
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
 
 ## Безопасность
 
-Круто иметь возможность создавать новые посты, просто перейдя по ссылке! Однако сейчас кто угодно из посетителей твоего сайта может создать новую запись в блоге, а это, скорее всего, совсем не то, чего бы тебе хотелось. Давай сделаем так, чтобы кнопка показывалась для нас, а не кого-либо ещё.
+Круто иметь возможность создавать новые посты просто нажав на ссылку! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
 
-В файле `blog/templates/blog/base.html` найди `page-header` `div` и тег `<a>`, который мы добавили ранее. Должно выглядеть примерно так:
+В файле `blog/templates/blog/base.html`, найди `page-header` `div` и тег &lta&gt который мы добавили ранее. Должно выглядеть примерно так:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Мы добавим сюда ещё один тег `{% if %}`, чтобы ссылка показывалась только пользователям, вошедшим в админку. То есть пока что — только тебе! Измени тег `<a>`, чтобы получилось так:
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Измени тег `< >`, чтобы получилось так:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% if user.is_authenticated %}
     <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 {% endif %}
 ```
 
-Из-за этого `{% if %}` ссылка будет отправлена в браузер, только если запрашивающий страницу пользователь вошёл в систему. Это не обезопасит создание новых постов полностью, но для начала и это неплохо. Мы подробнее рассмотрим вопросы безопасности в дополнении к учебнику.
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. Это не обезопасит создание новых постов полностью, но для начала и это неплохо. Мы подробнее рассмотрим вопросы безопасности в дополнении к учебнику.
 
-Помнишь иконку редактирования, которую мы добавили на страницу поста? Чтобы посторонние не смогли менять уже созданные посты, нам нужно изменить страничку похожим образом.
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
 
-Открой файл `blog/templates/blog/post_detail.html` и найди такую строку:
+Open `blog/templates/blog/post_detail.html` and find this line:
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
 
-Замени её на следующее:
+Change it to this:
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% if user.is_authenticated %}
      <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 {% endif %}
 ```
 
-Поскольку ты авторизована, никаких изменений после обновления страницы ты не увидишь. Но попробуй загрузить страницу в другом браузере или в режиме инкогнито, и увидишь, что ссылка не отобразится!
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
 
-## Ещё одна вещь: развёртывание!
+## Еще одна вещь: развертывание!
 
-Теперь давай посмотрим, как это будет работать на PythonAnywhere. Пришло время для очередного развёртывания!
+Теперь давай посмотрим как это будет работать на PythonAnywhere. Пришло время для очередного развертывания!
 
-*   Сначала нам нужно сделать commit и push нового кода в репозиторий Github
+* Сначала нам нужно сделать commit и push нового кода в репозиторий Github:
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added views to create/edit blog post inside the site."
-$ git push
-```
 
-*   Затем набери в [Bash-консоли PythonAnywhere][7]:
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
 
- [7]: https://www.pythonanywhere.com/consoles/
+* Затем набери в [Bash консоли PythonAnywhere](https://www.pythonanywhere.com/consoles/):
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd my-first-blog
-$ git pull
-[...]
-```
 
-*   И нажми **Reload** на вкладке [Web tab][8].
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
- [8]: https://www.pythonanywhere.com/web_app_setup/
+* И нажми **Reload** на вкладке [Web tab](https://www.pythonanywhere.com/web_app_setup/).
 
-Вот и всё! Поздравляем :)
+Вот и все! Поздравляем :)
\ No newline at end of file
diff --git a/ru/django_installation/README.md b/ru/django_installation/README.md
index 84722fc6765..dfe462b88f2 100755
--- a/ru/django_installation/README.md
+++ b/ru/django_installation/README.md
@@ -1,5 +1,7 @@
 # Установка Django
 
-> **Примечание:** если ты уже выполнила установку — можешь пропустить эту часть и сразу перейти к следующей главе!
+> **Примечание** Если вы используете Chromebook, пропустите эту главу и следуйте инструкции по [Установке Chromebook](../chromebook_setup/README.md).
+> 
+> **Примечание** Если ты уже выполнила установку — можешь пропустить эту часть и сразу перейти к следующей главе!
 
-{% include "/django_installation/instructions.md" %}
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ru/django_installation/instructions.md b/ru/django_installation/instructions.md
index 1e03835b329..6c51ba73534 100755
--- a/ru/django_installation/instructions.md
+++ b/ru/django_installation/instructions.md
@@ -1,6 +1,6 @@
-> Отдельные части этой главы основаны на учебных пособиях Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
-
-> Отдельные части этой главы основаны на [учебном пособии django-marcador](http://django-marcador.keimlink.de/), лицензированном под Creative Commons Attribution-ShareAlike 4.0 International License. Руководство django-marcador защищено авторским правом Markus Zapke-Gründemann et al.
+> Отдельные части этой главы основаны на учебных пособиях Geek Girls Carrots (http://django.carrots.pl/).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Руководство django-marcador защищено авторским правом Markus Zapke-Gründemann et al.
 
 ## Виртуальное окружение
 
@@ -8,194 +8,194 @@
 
 Итак, давай создадим **виртуальное окружение** (оно также называется *virtualenv*). Virtualenv будет изолировать зависимости Python/Django для каждого отдельного проекта. Это значит, что изменения одного сайта никогда не затронут другие сайты, которые вы разрабатываете. Удобно, правда?
 
-Всё, что тебе нужно сделать — найти директорию, в которой мы создадим `virtualenv`; домашний каталог вполне подойдёт. Для Windows адрес будет выглядеть так: `C:\Users\Name` (где `Name` — твоё имя пользователя).
+Все что тебе нужно сделать -- найти директорию, в которой мы создадим `virtualenv`; домашний каталог вполне подойдет. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
 
-> __Примечание:__ Если ты работаешь в Windows, удостоверься, что в названии директории нет специальных символов или символов с диакритическими знаками; если в твоём имени пользователя есть такие символы, выбери другую директорию, например, `C:\djangogirls`.
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
 
 Мы будем использовать отдельную директорию `djangogirls` в домашнем каталоге:
 
 {% filename %}command-line{% endfilename %}
-```
-$ mkdir djangogirls
-$ cd djangogirls
-```
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
 
 Мы создадим виртуальное окружение под именем `myvenv`. В общем случаем команда будет выглядеть так:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 -m venv myvenv
-```
 
-<!--sec data-title="Windows" data-id="virtualenv_installation_windows"
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
 data-collapse=true ces-->
 
-Чтобы создать новое `virtualenv`, тебе нужно открыть командную строку и набрать `python -m venv myvenv`. Это будет выглядеть так:
+Чтобы создать новое виртуальное окружение `virtualenv`, вам нужно открыть командную строку и запустить `python -м venv myvenv`. Он будет выглядеть следующим образом:
 
 {% filename %}command-line{% endfilename %}
-```
-C:\Users\Name\djangogirls> python -m venv myvenv
-```
 
-Здесь `myvenv` — имя твоего `virtualenv`. Ты можешь выбрать другое имя, но используй можно только прописные буквы, без пробелов и специальных символов. Имя виртуального окружения выбирай покороче — тебе придётся часто его набирать!
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Где `myvenv` — имя вашего `virtualenv`. Ты можешь выбрать любое имя, использовать можно только прописные буквы, без пробелов и специальных символов. Имя виртуального окружения лучше выбирать покороче — его предстоит набирать не раз!
 
 <!--endsec-->
 
-<!--sec data-title="Linux и OS X" data-id="virtualenv_installation_linuxosx"
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
 data-collapse=true ces-->
 
-В Linux и OS X достаточно набрать `python3 -m venv myvenv`, чтобы создать `virtualenv`:
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 -m venv myvenv
-```
-
-`myvenv` — имя виртуального окружения `virtualenv`. Можешь выбрать другое имя, но используй только строчные буквы и никаких пробелов. Имя виртуального окружения лучше выбирать покороче — набирать его предстоит не раз!
-
-> __Примечание:__ В некоторых версиях Debian/Ubuntu может произойти следующая ошибка:
-
->{% filename %}command-line{% endfilename %}
->```
->The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
->    apt-get install python3-venv
->You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
->```
->
-> В таком случае следуй приведённым инструкциям и установи пакет `python3-venv`:
->{% filename %}command-line{% endfilename %}
->```
->$ sudo apt-get install python3-venv
->```
-
-> __Примечание:__ В некоторых версиях of Debian/Ubuntu при таком способе создания виртуального окружения ты можешь получить такую ошибку:
-
->{% filename %}command-line{% endfilename %}
->```
->Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
->```
-
-> Чтобы обойти её, используй команду `virtualenv`.
-
->{% filename %}command-line{% endfilename %}
->```
->$ sudo apt-get install python-virtualenv
->$ virtualenv --python=python3.6 myvenv
->```
-
-> __Примечание:__ Если ты получаешь следующую ошибку
-
->{% filename %}command-line{% endfilename %}
->```
->E: Unable to locate package python3-venv
->```
-
-> то тогда запусти команду:
->
->{% filename %}command-line{% endfilename %}
->```
->sudo apt install python3.6-venv
->```
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` -- имя виртуального окружения `virtualenv`. Опять же, только строчные буквы и никаких пробелов. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **ПРИМЕЧАНИЕ:** В некоторых версиях Debian/Ubuntu может появиться следующее сообщение об ошибке:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **ПРИМЕЧАНИЕ:** В некоторых версиях Debian/Ubuntu при инициировании виртуального окруженя выдает следующую ошибку:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Чтобы обойти эту проблему используй команду `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **ПРИМЕЧАНИЕ:** Если вы получаете такое сообщение:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> вместо этого запустите:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
 
 <!--endsec-->
 
 ## Работаем с virtualenv
 
-Указанная выше команда создаст директорию `myvenv` (или другую, в зависимости от выбранного имени), которая будет содержать виртуальное окружение (по сути — набор файлов и папок).
+Вышеуказанная команда создаст директорию `myvenv` (или другую, в зависимости от выбранного имени), которая будет содержать виртуальное окружение (по сути -- набор файлов и папок).
 
-<!--sec data-title="Windows" data-id="virtualenv_windows"
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
 data-collapse=true ces-->
 
 Запусти виртуальное окружение, выполнив:
 
 {% filename %}command-line{% endfilename %}
-```
-C:\Users\Name\djangogirls> myvenv\Scripts\activate
-```
-
-> __ПРИМЕЧАНИЕ:__ в Windows 10 при работе в Windows PowerShell ты можешь получить ошибку вида `execution of scripts is disabled on this system`. В этом случае открой ещё другое окно Windows PowerShell, выбрав опцию «Запустить от имени Администратора». Перед использованием виртуального окружения попробуй запустить следующую команду:
->
->{% filename %}command-line{% endfilename %}
->```
->C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
->     Execution Policy Change
->     The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
->```
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **Примечание:** На Windows 10 вы можете получить сообщение об ошибке в Windows PowerShell, в котором сказано `на этой системы отключено выполнение скриптов`. В этом случае откройте Windows PowerShell с помощью параметра «Запуск от имени администратора». Затем попробуйте ввести следующую команду перед запуском виртуальной среды:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
 
 <!--endsec-->
 
-<!--sec data-title="Linux и OS X" data-id="virtualenv_linuxosx"
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
 data-collapse=true ces-->
 
 Запусти виртуальное окружение, выполнив:
 
 {% filename %}command-line{% endfilename %}
-```
-$ source myvenv/bin/activate
-```
+
+    $ source myvenv/bin/activate
+    
 
 Не забудь поменять `myvenv` на выбранное для `virtualenv` имя!
 
-> __ПРИМЕЧАНИЕ:__ иногда команда `source` может быть недоступна. В таком случае используй следующий метод:
->
->{% filename %}command-line{% endfilename %}
->```
->$ . myvenv/bin/activate
->```
+> **ПРИМЕЧАНИЕ:** иногда команда `source` может быть недоступна. В таком случае, используй следующий метод:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
 
 <!--endsec-->
 
-Ты поймёшь, что `virtualenv` запущено, когда увидишь префикс `(myvenv)` в начале приглашения командной строки.
+Ты поймешь, что `virtualenv` запущено, когда увидишь префикс в командной строке.
 
-При работе с виртуальным окружением команда `python` будет автоматически обращаться к правильной версии языка, так что тебе не обязательно использовать `python3`.
+При работе с виртуальным окружением, команда `python` будет автоматически обращаться к правильной версии языка, так что тебе не обязательно использовать `python3`.
 
 Отлично, теперь мы будем хранить все важные зависимости в одном месте. Наконец можно установить Django!
 
 ## Установка Django
 
-После запуска `virtualenv` ты можешь установить Django.
+Now that you have your `virtualenv` started, you can install Django.
 
-Перед этим мы должны удостовериться, что у тебя установлена последняя версия `pip` — программы, которую мы используем для установки Django.
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~$ pip install --upgrade pip
-```
 
-Затем запусти команду `pip install django~=1.11.0` (обрати внимание на тильду со знаком равенства: `~=`), чтобы установить Django.
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~$ pip install django~=1.11.0
-Collecting django~=1.11.0
-  Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
-Installing collected packages: django
-Successfully installed django-1.11.3
-```
-
-<!--sec data-title="Windows" data-id="django_err_windows"
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
 data-collapse=true ces-->
 
-> Если ты получаешь сообщение об ошибке при запуске pip, проверь, что путь к директории с проектом не содержит пробелов или специальных символов (`C:\Users\User Name\djangogirls`). Если проблема в этом, то, пожалуйста, перенеси свой проект в другое место, адрес которого не будет содержать пробелов и специальных символов (предлагаем `C:\djangogirls`). Создай новое виртуальное окружене в новой директории, после этого удали старое и попробуй запустить команду установки Django заново (перемещение виртуального окружения не сработает, поскольку в нём используются абсолютные пути).
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Создай новый virtualenv в новой директории, а затем удали старый и повтори команды выше. (Перемещение директории virtualenv не будет работать, потому что virtualenv использует абсолютные пути.)
 
 <!--endsec-->
 
-<!--sec data-title="Windows 8 и Windows 10" data-id="django_err_windows8and10"
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
 data-collapse=true ces-->
 
-> При попытке установки Django твоя командная строка может зависнуть. Если это произошло, вместо приведённой выше команды используй:
->
->{% filename %}command-line{% endfilename %}
->```
->C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
->```
+> Командная строка может зависнуть после попытки установить Django. Если это произойдет, вместо команды выше, используй эту:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\имя_пользователя\djangogirls> python -m pip install django~=1.11.0
+>     
 
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="django_err_linux"
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
 
 > При возникновении ошибки при вызове pip под Ubuntu 12.04, пожалуйста, запусти `python -m pip install -U --force-reinstall pip`, чтобы исправить установку pip в virtualenv.
 
 <!--endsec-->
 
-Вот и всё! Теперь ты (наконец-то) готова создать своё Django-приложение!
+Вот и оно! Теперь ты (наконец то) готова создать свое Django приложение!
\ No newline at end of file
diff --git a/ru/django_models/README.md b/ru/django_models/README.md
index f0b7feca40c..aa2840e76ab 100755
--- a/ru/django_models/README.md
+++ b/ru/django_models/README.md
@@ -1,34 +1,32 @@
 # Модели Django
 
-Нам нужно что-то, что будет хранить все записи нашего блога. Но прежде давай поговорим о вещах, называемых `объектами`.
+Нам нужно что-то, что будет хранить все записи нашего блога. Но прежде, давай поговорим о вещах, называемых `объектами`.
 
 ## Объекты
 
-В программировании существует особая концепция, она называется `объектно-ориентированным программированием`. Идея заключается в том, что вместо скучной последовательности инструкций мы моделируем вещи и описываем, как они взаимодействуют друг с другом.
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
 
 Так что же такое объект? Это совокупность поведения и свойств. Звучит странно, но мы приведем пример.
 
-Если мы хотим смоделировать кошку, то создадим объект `Cat`, который обладает определенными свойствами, например, `color` (цвет), `age` (возраст), `mood` (настроение: плохое, хорошее, сонное ;)), `owner` (хозяин, например, другой объект — `Person` — или, если кошка дикая, это свойство будет пустым).
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
 
-Объект `Cat` будет иметь набор определённых действий: `purr` (мурчать), `scratch` (царапаться) или `feed` (кормить, где мы дадим кошке немного `CatFood` — кошачьей еды, которая так же может быть отдельным объектом со своими свойствами, например, `taste` — вкусом).
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
 
-```
-Cat
---------
-color
-age
-mood
-owner
-purr()
-scratch()
-feed(cat_food)
-```
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
 
-```
-CatFood
---------
-taste
-```
+    CatFood
+    --------
+    taste
+    
 
 Основная идея, таким образом, заключается в описании объекта в коде, используя его параметры (`свойства объекта`) и доступные ему действия (`методы`).
 
@@ -36,17 +34,16 @@ taste
 
 Для начала стоит ответить на вопрос: что такое запись в блоге? Какие свойства она имеет?
 
-Ну, запись наверняка содержит какой-то текст и заголовок, верно? Было бы неплохо также знать, кто её написал — так что нам нужен автор. Ну и в заключении, нам нужно знать, когда запись создана и когда опубликована.
+Ну, запись содержит какой-то текст и заголовок, это наверняка, верно? It would be also nice to know who wrote it – so we need an author. Ну и в заключении, нам нужно знать когда запись создана и когда опубликована.
 
-```
-Post
---------
-title
-text
-author
-created_date
-published_date
-```
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
 
 Какие вещи можно сделать с записью в блоге? Было бы неплохо иметь `метод` для её публикации, согласна?
 
@@ -56,9 +53,9 @@ published_date
 
 ## Модель в Django
 
-Зная, что представляет из себя объект, мы можем создать модель Django для записи в блоге.
+Зная, что представляет из себя объект, мы можем создать Django модель для записи в блоге.
 
-Модель в Django — это объект определённого свойства: он хранится в `базе данных`. База данных представляет собой совокупность различных данных. Это то место, где ты будешь хранить информацию о своих пользователях, записях в блоге и т.д. Мы будем использовать базу данных SQLite для хранения информации. Это стандартная база данных в Django — её сейчас вполне хватит для наших нужд.
+A model in Django is a special kind of object – it is saved in the `database`. База данных представляет собой совокупность различных данных. Это то место, где ты будешь хранить информацию о своих пользователях, записях в блоге и т.д. Мы будем использовать базу данных SQLite для хранения информации. This is the default Django database adapter – it'll be enough for us right now.
 
 Ты можешь представить модель в базе данных как электронную таблицу с колонками (полями) и строками (данными).
 
@@ -66,38 +63,41 @@ published_date
 
 Для аккуратности мы создадим отдельное приложение в нашем проекте. Очень удобно иметь хорошо организованное рабочее место с самого начала. Для создания приложения нам понадобиться набрать следующую инструкцию в командной строке (из директории `djangogirls`, где находится файл `manage.py`):
 
-{% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py startapp blog
-```
+{% filename %}Mac OS X and Linux:{% endfilename %}
 
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
 
-Обрати внимание, что в нашем проекте появилась новая папка `blog`, которая содержит некоторые файлы. Таким образом, структура нашего проекта будет выглядеть так:
+{% filename %}Windows:{% endfilename %}
 
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
 
-```
-djangogirls
-├── blog
-│   ├── __init__.py
-│   ├── admin.py
-│   ├── apps.py
-│   ├── migrations
-│   │   └── __init__.py
-│   ├── models.py
-│   ├── tests.py
-│   └── views.py
-├── db.sqlite3
-├── manage.py
-└── mysite
-    ├── __init__.py
-    ├── settings.py
-    ├── urls.py
-    └── wsgi.py
-```
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
 
-После того, как приложение создано, нам нужно сообщить Django, что теперь он должен его использовать. Мы сделаем это с помощью файла `mysite/settings.py`. Нам нужно найти `INSTALLED_APPS` и добавить к списку `'blog',` прямо перед `]`. Конечный результат должен выглядеть следующим образом:
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 INSTALLED_APPS = [
     'django.contrib.admin',
@@ -112,18 +112,19 @@ INSTALLED_APPS = [
 
 ### Создание модели записи в блоге
 
-В файле `blog/models.py` мы определяем все `Модели` — модель записи для блога также пойдёт сюда.
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
 
-Открой файл `blog/models.py`, удали весь текст и вставь на его место следующий код:
+Let's open `blog/models.py`, remove everything from it, and write code like this:
 
 {% filename %}blog/models.py{% endfilename %}
+
 ```python
 from django.db import models
 from django.utils import timezone
 
 
 class Post(models.Model):
-    author = models.ForeignKey('auth.User')
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
     created_date = models.DateTimeField(
@@ -139,59 +140,60 @@ class Post(models.Model):
         return self.title
 ```
 
-> Убедись, что использовала два символа нижнего подчёркивания (`_`) с обеих сторон от метода `str`. Это соглашение часто используется при программировании на Python, и иногда его называют "dunder" (сокращение от англ. "double-underscore").
+> Double-check that you use two underscore characters (`_`) on each side of `str`. Это соглашение часто используется при программировании на Python, и иногда его называют "dunder" (сокращение от англ. "double-underscore").
 
-Смотрится страшно, да? Но не волнуйся, мы объясним, что значит каждая строка кода!
+It looks scary, right? But don't worry – we will explain what these lines mean!
 
-Строки, начинающиеся с `from` или `import`, открывают доступ к коду из других файлов. Так что вместо того, чтобы копировать и вставлять один и тот же код во все файлы, ты можешь сослаться на него при помощи `from ... import ...`.
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
 
-`class Post(models.Model):` — эта строка определяет нашу модель (`объект`).
+`class Post(models.Model):` – this line defines our model (it is an `object`).
 
--   `class` — это специальное ключевое слово для определения объектов.
--   `Post` — это имя нашей модели, мы можем поменять его при желании (специальные знаки и пробелы использовать нельзя). Всегда начинай имена классов с прописной буквы.
--   `models.Model` означает, что объект Post является моделью Django, так Django поймет, что он должен сохранить его в базу данных.
+- `class` это специальное ключевое слово для определения объектов.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` означает что объект Post является моделью Django, так Django поймет, что он должен сохранить его в базу данных.
 
-Дальше мы задаем свойства, о которых уже говорили: `title`, `text`, `created_date`, `published_date` и `author`. Чтобы это сделать, нам нужно определиться с типом полей (это текст? число? дата? ссылка на другой объект? например, на пользователя?).
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
 
--   `models.CharField` — так мы определяем текстовое поле с ограничением на количество символов.
--   `models.TextField` — так определяется поле для неограниченно длинного текста. Выглядит подходящим для содержимого поста, верно?
--   `models.DateTimeField` — дата и время.
--   `models.ForeignKey` — ссылка на другую модель.
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
 
-Мы не будем объяснять каждую запятую, поскольку на это уйдет слишком много времени. Ознакомься с официальной документаций Django: если хочешь узнать больше о полях моделей и о том, как определять разные объекты, то эта ссылка может помочь: (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
 
-Что насчёт `def publish(self):`? Это как раз метод `публикации` для записи, о котором мы говорили. `def` означает, что создаётся функция/метод, а `publish` — это название этого метода. Можно изменить имя метода, если хочешь. Существует правило для имён функций: нужно использовать строчные буквы, а пробелы заменять на подчёркивания. Например, метод, вычисляющий среднюю цену, может называться `calculate_average_price`.
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
 
-Методы часто `возвращают` что-то. Например, метод `__str__`. В наше случае после вызова метода `__str__()` мы получим текст (**строку**) с заголовком записи.
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
 
-Также обрати внимание, что оба метода `def publish(self):` и `def __str__(self):` внутри класса имеют дополнительный отступ. Поскольку в Python важны отступы, нам необходимо использовать их для методов внутри класса — иначе методы не будут принадлежать к классу, и при запуске программы может получиться что-то неожиданное.
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
 
-Если тема моделей тебе до сих пор непонятна — не стесняйся обратиться к тренеру! Мы знаем, что она действительно сложна, особенно когда ты изучаешь параллельно объекты и функции. Но мы надеемся, что всё это больше не кажется тебе магией!
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
 
-### Создаём таблицы моделей в базе данных
+### Создаем таблицы моделей в базе данных
 
-Последним шагом будет добавление нашей модели в базу данных. Сначала мы должны дать Django знать, что сделали изменения в нашей модели (мы её только что создали!). Набери `python manage.py makemigrations blog`. Должно получиться примерно так:
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py makemigrations blog
-Migrations for 'blog':
-  blog/migrations/0001_initial.py:
-  - Create model Post
-```
 
-**Примечание:** не забудь сохранить отредактированные файлы. Иначе твой компьютер выполнит команду с их предыдущей версией, и могут появиться неожиданные ошибки.
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
 
-Django создал для нас файл с миграцией для базы данных. Набери `python manage.py migrate blog`, результат должен быть следующим:
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py migrate blog
-Operations to perform:
-  Apply all migrations: blog
-Running migrations:
-  Rendering model states... DONE
-  Applying blog.0001_initial... OK
-```
 
-Ура! Модель записи для блога теперь в базе данных, и было бы неплохо посмотреть на неё, верно? Тогда переходи к следующей главе!
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ru/django_orm/README.md b/ru/django_orm/README.md
index 3cde0a4b1e1..db72e1ef0e1 100755
--- a/ru/django_orm/README.md
+++ b/ru/django_orm/README.md
@@ -1,37 +1,39 @@
 # Django ORM и QuerySet
 
-В этой главе ты узнаешь, как Django подключается к базе данных и сохраняет в неё информацию. Давай начнём!
+В этой главе ты узнаешь как Django подключается к базе данных и сохраняет в неё информацию. Давай начнем!
 
 ## Что такое QuerySet?
 
-QuerySet, по сути, — список объектов заданной Модели. QuerySet позволяет читать данные из базы данных, фильтровать и изменять их порядок.
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
 
 Проще научиться на примере. Давай попробуем, согласна?
 
 ## Интерактивная консоль Django
 
-Открой свой локальный терминал (не на PythonAnywhere) и набери следующую команду:
+Открой свой локальный терминал (не на PythonAnywhere), и набери следующую команду:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py shell
-```
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
 
 Результат должен быть таким:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 (InteractiveConsole)
 >>>
 ```
 
-Ты находишься в интерактивной консоли Django. По сути, это та же интерактивная консоль Python, но с магией Django :) Ты можешь использовать весь синтаксис Python, разумеется.
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
 
 ### Все объекты
 
 Давай попробуем вывести на экран все записи в нашем блоге. Ты можешь сделать это следующей командой:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.all()
 Traceback (most recent call last):
@@ -39,37 +41,41 @@ Traceback (most recent call last):
 NameError: name 'Post' is not defined
 ```
 
-Упс! Ошибка. Она говорит, что не существует объекта с именем Post. И это верно — мы забыли импортировать его!
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> from blog.models import Post
 ```
 
-Всё просто: мы импортируем модель `Post` из `blog.models`. Давай попробуем получить все записи блога ещё раз:
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.all()
 <QuerySet [<Post: my post title>, <Post: another post title>]>
 ```
 
-Это список записей, с которыми мы работали до этого! Мы создали их через панель администратора Django. Теперь же мы хотим создавать записи с помощью Python, так как же мы этого добьёмся?
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
 
-### Создаём объект
+### Создаем объект
 
 Создать объект Post в базе данных можно следующим образом:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.create(author=me, title='Sample title', text='Test')
 ```
 
-Но у нас есть один недочёт: `me`. Мы должны передать этой переменной экземпляр модели `User`, который будет отвечать за автора записи. Как это сделать?
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
 
-Давай для начала импортируем модель User:
+Давай импортируем модель user для начала:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> from django.contrib.auth.models import User
 ```
@@ -77,98 +83,108 @@ NameError: name 'Post' is not defined
 Какие пользователи есть в нашей базе данных? Попробуй эту команду:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> User.objects.all()
 <QuerySet [<User: ola>]>
 ```
 
-Это суперпользователь, которого мы создали ранее! Нам нужен его экземпляр:
+This is the superuser we created earlier! Let's get an instance of the user now:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> me = User.objects.get(username='ola')
 ```
 
-Как ты можешь заметить, мы получили (`get`) пользователя (`User`) с именем `username` 'ola'. Шикарно! В твоём случае имя, конечно, может отличаться.
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
 
-Теперь мы, наконец, можем создать наш пост:
+Теперь мы наконец можем создать наш пост:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.create(author=me, title='Sample title', text='Test')
 ```
 
-Ура! Хочешь проверить, что всё работает?
+Ура! Хочешь проверить, что все работает?
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.all()
 <QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
 ```
 
-Есть, ещё один пост в списке!
+Есть, еще один пост в списке!
 
 ### Добавляем записи
 
-Можешь повеселиться и добавить ещё записей. 2-3 будет достаточно.
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
 
 ### Фильтрация объектов
 
-Важной особенностью QuerySets является возможность фильтровать объекты. Предположим, нам нужно найти все записи пользователя ola. Мы используем метод `filter` вместо метода `all` в `Post.objects.all()`. В скобках мы укажем условия, по которым будет построена выборка записей. В нашей ситуации условием будет являться равенство поля `author` переменной `me`. В Django мы можем написать это следующим образом: `author=me`. Теперь наш код выглядит следующим образом:
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. Мы используем метод `filter` вместо метода `all` в `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Теперь наш код выглядит следующим образом:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.filter(author=me)
 [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
 ```
 
-А может быть мы хотим получить все записи со словом 'title' в поле `title`?
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.filter(title__contains='title')
 [<Post: Sample title>, <Post: 4th title of post>]
 ```
 
-> **Примечание**: обрати внимание на два символа нижнего подчёркивания (`_`) между `title` и `contains`. Django ORM использует этот синтаксис для разделения имён полей ("title") и операций или фильтров ("contains"). Если ты используешь только один символ нижнего подчёркивания, то получишь ошибку "FieldError: Cannot resolve keyword title_contains".
+> **Примечание**: Обрати внимание на два символа нижнего подчеркивания (`_`) между `title` и `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
 
-Ты также можешь получить список всех опубликованных записей. Мы просто отфильтруем записи по полю `published_date`:
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> from django.utils import timezone
 >>> Post.objects.filter(published_date__lte=timezone.now())
 []
 ```
 
-К сожалению, пост, который мы добавили в консоли Python, ещё не опубликован. Мы можем изменить это! Сначала выберем запись, которую мы хотим опубликовать:
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> post = Post.objects.get(title="Sample title")
 ```
 
-Дальше мы опубликуем её с помощью метода `publish`!
+Дальше мы опубликуем её с помощью метода `publish`:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> post.publish()
 ```
 
-Теперь попробуй получить список опубликованных сообщений снова (нажми стрелку вверх 3 раза и затем `enter`):
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.filter(published_date__lte=timezone.now())
 [<Post: Sample title>]
 ```
 
-
 ### Сортировка объектов
 
 QuerySets позволяет сортировать объекты. Давай попробуем сортировку по полю `created_date`:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.order_by('created_date')
 [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
@@ -177,26 +193,26 @@ QuerySets позволяет сортировать объекты. Давай 
 Мы также можем изменить порядок на противоположный, добавив `-` в начало условия:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> Post.objects.order_by('-created_date')
-[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
 ```
 
-
 ### Соединение QuerySets
 
 QuerySets можно **сцеплять**, создавая цепочки:
 
-```
->>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-```
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
 
-Это мощный и удобный инструмент, позволяющий писать сложные запросы.
+Это — мощный и удобный инструмент, позволяющий писать сложные запросы.
 
 Отлично! Теперь ты готова к следующей части! Чтобы закрыть интерактивную консоль, набери:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> exit()
 $
-```
+```
\ No newline at end of file
diff --git a/ru/django_start_project/README.md b/ru/django_start_project/README.md
index 40418630914..c9d6fa0dd1c 100755
--- a/ru/django_start_project/README.md
+++ b/ru/django_start_project/README.md
@@ -1,120 +1,123 @@
 # Твой первый проект на Django!
 
-> Часть этой главы основана на учебных пособиях Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Руководство django-marcador защищено авторским правом Markus Zapke-Gründemann et al.
 
-> Отдельные части этой главы основаны на учебном пособии [django-marcador ][1], лицензированном под Creative Commons Attribution-ShareAlike 4.0 International License. Руководство django-marcador защищено авторским правом Markus Zapke-Gründemann et al.
+We're going to create a small blog!
 
- [1]: http://django-marcador.keimlink.de/
+Первый шаг — создать новый проект Django. Попросту, это значит что мы запустим несколько стандартных скриптов из поставки Django, который создадут для нас скелет проекта. Это просто куча каталогов и файлов, которые мы будем использовать позже.
 
-Мы собираемся создать простой блог!
+Имена этих каталог и файлов очень важны для Django. Ты не должна переименовывать их. Перемещать их в другое место тоже не самая удачная идея. Django необходима определенная структуру, чтобы иметь возможность найти важные вещи.
 
-Первый шаг — создать новый проект Django. В сущности, это значит, что мы запустим несколько стандартных скриптов из поставки Django, которые создадут для нас скелет проекта. Это просто куча каталогов и файлов, которые мы используем позже.
+> Не забудь: ты должна запускать все команды в virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. Мы объясняли как это сделать в разделе **Работаем с virtualenv** главы **Установка Django**. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
 
-Названия этих каталогов и файлов очень важны для Django. Ты не должна переименовывать их. Перемещать их в другое место тоже не самая удачная идея. Django необходима определенная структура, чтобы иметь возможность найти важные вещи.
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
 
-> Не забудь: ты должна запускать все команды в virtualenv. Если ты не видишь в командной строке префикса `(myvenv)`, то необходимо активировать virtualenv. Мы объясняли, как это сделать, в разделе __Работаем с virtualenv__ главы __Установка Django__. Для этого нужно набрать `myvenv\Scripts\activate` в Windows или `source myvenv/bin/activate` в Mac OS / Linux.
-
-<!--sec data-title="OS X или Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
-
-В консоли Mac OS или Linux нужно запустить следующую команду (**не забудь добавить точку `.` в конце**):
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ django-admin startproject mysite .
-```
 
-> Точка `.` крайне важна, потому что говорит скрипту установить Django в вашем текущем каталоге (который и обозначается сокращённо точкой `.`)
->
-> **Примечание:** при вводе приведённой командs помни, что тебе нужно набирать только часть, начинающуюся с `django-admin`. `(myvenv) ~/djangogirls$` — это просто пример строки-приглашения терминала.
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> `.` Точка крайне важна, потому что говорит скрипту устанавливать Django в вашем текущем каталоге (который и обозначается сокращённо точкой `.`).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
 
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
 
-В Windows запусти следующую команду (**не забудь добавить точку `.` в конце**):
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
-```
-> Точка `.` крайне важна, потому что говорит скрипту установить Django в вашем текущем каталоге (который и обозначается сокращённо точкой `.`)
 
-> **Примечание:** при вводе приведённой команды помни, что тебе нужно набирать только часть, начинающуюся с `django-admin.py`. `(myvenv) C:\Users\Name\djangogirls>` — это просто пример приглашения командной строки.
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> `.` Точка крайне важна, потому что говорит скрипту устанавливать Django в вашем текущем каталоге (который и обозначается сокращённо точкой `.`).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
 
 <!--endsec-->
 
-`django-admin.py` — это скрипт, который создаст необходимую структуру директорий и файлы для нас. Теперь у твоего проекта должна быть следующая структура:
+`django-admin.py` это скрипт, который создаст необходимую структуру директорий и файлы для нас. Ты должна теперь иметь следующую структуру проекта:
 
-```
-djangogirls
-├───manage.py
-└───mysite
-        settings.py
-        urls.py
-        wsgi.py
-        __init__.py
-```
-> **Примечание:** в своей структуре директорий ты также увидишь ранее созданную нами директорию с виртуальным окружением.
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
 
-`manage.py` — это другой скрипт, который помогает с управлением сайтом. С помощью него мы, помимо прочего, сможем запустить веб-сервер на твоем компьютере без установки дополнительных программ.
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
 
 Файл `settings.py` содержит настройки для твоего веб-сайта.
 
 Помнишь нашу аналогию с почтальоном? Файл `urls.py` содержит список шаблонов, по которым ориентируется `urlresolver`.
 
-Давай пока забудем про остальные файлы — мы не будем их изменять. Только не удали их случайно!
-
+Давай пока забудем про остальные файлы - мы не будем их изменять. Только не удали их случайно!
 
 ## Изменяем настройки
 
-Давай внесём изменения в `mysite/settings.py`. Открой файл в текстовом редакторе, который ты выбрала ранее.
-
-**Примечание:** помни, что `settings.py` — самый обычный файл. Ты можешь открыть его из своего редактора кода, используя меню «Файл -> Открыть». При этом ты увидишь обычное окно, в которой ты можешь перейти к своему файлу `settings.py` и выбрать его. Либо ты можешь открыть этот файл, перейдя в директорию проекта djangogirls на твоём рабочем столе и щёлкнув по нему правой кнопкой мыши; затем выбери свой редактор кода из предложенного списка. Важно выбрать именно редактор, поскольку у тебя могут быть установлены программы, которые откроют наш файл, но не позволят его изменить.
+Давай внесем изменения в `mysite/settings.py`. Открой файл в текстовом редакторе, который ты выбрала ранее.
 
-Было бы неплохо установить корректный часовой пояс на нашем сайте. Перейди к [списку часовых поясов википедии][2] и скопируй название своего часового пояса (TZ) (например, `Europe/Moscow`).
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
 
- [2]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+Было бы неплохо установить корректный часовой пояс на нашем сайте. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
 
-В файле settings.py найди строку, содержащую `TIME_ZONE`, и измени её в соответствии со своим часовым поясом:
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
-TIME_ZONE = 'Europe/Moscow'
+TIME_ZONE = 'Europe/Berlin'
 ```
 
-Код языка состоит из сокращённого названия языка, например `en` для английского или `ru` для русского, и кода страны, например, `ru` для России или 'ch' для Швейцарии. Тебе понадобиться эта настройка, если ты хочешь, чтобы все встроенные кнопки и уведомления от Django были на твоём языке. Таким образом, надпись на кропке «Cancel» будет переведена на заданный тобой язык [Django поставляется с большим набором готовых переводов](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
 
-Измени язык, отредактировав следующую строку:
+Change the language code by changing the following line:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
-LANGUAGE_CODE = 'ru-ru'
+LANGUAGE_CODE = 'de-ch'
 ```
 
-
-Нам также необходимо добавить в настройки информацию о расположении статических файлов (мы познакомимся со статическими файлами и CSS в следующих главах). Спустись в *конец* файла и после переменной `STATIC_URL` добавь новую — `STATIC_ROOT`:
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 STATIC_URL = '/static/'
 STATIC_ROOT = os.path.join(BASE_DIR, 'static')
 ```
 
-Когда натройка `DEBUG` имеет значение `True`, а настройка `ALLOWED_HOSTS` пуста, имя хост твоего веб-сайта сверяется со списком `['localhost', '127.0.0.1', '[::1]']`.
-Ни одно из значений не соответствует имени хоста на PythonAnywhere при публикации нашего приложения, поэтому нам необходимо изменить следующую настройку:
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
-ALLOWED_HOSTS = ['127.0.0.1', '<твоё_имя_пользователя>.pythonanywhere.com']
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
 ```
 
-## Настройка базы данных
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
 
-Существует множество различных баз данных, которые могут хранить данные для твоего сайта. Мы будем использовать стандартную — `sqlite3`.
+Существует множество различных баз данных, которые могут хранить данные для твоего сайта. Мы будем использовать стандартную -- `sqlite3`.
 
 Она уже выбрана по умолчанию в файле `mysite/settings.py`:
 
 {% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 DATABASES = {
     'default': {
@@ -124,66 +127,76 @@ DATABASES = {
 }
 ```
 
+Чтобы создать базу данных для нашего блога, набери в командной строке следующее: `python manage.py migrate` (мы должны быть в директории `djangogirls`, где расположен файл `manage.py`). Если все прошло успешно, то ты увидишь следующий результат:
+
+{% filename %}command-line{% endfilename %}
 
-Чтобы создать базу данных для нашего блога, набери в командной строке следующее: `python manage.py migrate` (мы должны быть в директории `djangogirls`, где расположен файл `manage.py`). Если всё прошло успешно, то ты увидишь следующий результат:
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+И мы закончили! Пришло время запустить веб-сервер и посмотреть работает ли наш веб-сайт!
+
+## Starting the web server
+
+Ты должна быть в директории, где расположен файл `manage.py` (в нашем случае -- `djangogirls`). Запустим веб-сервер из командной строки: `python manage.py runserver`:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py migrate
-Operations to perform:
-  Apply all migrations: auth, admin, contenttypes, sessions
-Running migrations:
-  Rendering model states... DONE
-  Applying contenttypes.0001_initial... OK
-  Applying auth.0001_initial... OK
-  Applying admin.0001_initial... OK
-  Applying admin.0002_logentry_remove_auto_add... OK
-  Applying contenttypes.0002_remove_content_type_name... OK
-  Applying auth.0002_alter_permission_name_max_length... OK
-  Applying auth.0003_alter_user_email_max_length... OK
-  Applying auth.0004_alter_user_username_opts... OK
-  Applying auth.0005_alter_user_last_login_null... OK
-  Applying auth.0006_require_contenttypes_0002... OK
-  Applying auth.0007_alter_validators_add_error_messages... OK
-  Applying sessions.0001_initial... OK
-```
 
-Вот и всё! Пришло время запустить веб-сервер и посмотреть, работает ли наш веб-сайт!
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
 
-## Запуск веб-сервера
+If you are on a Chromebook, use this command instead:
 
-Ты должна быть в директории, где расположен файл `manage.py` (в нашем случае — `djangogirls`). Запустим веб-сервер из командной строки: `python manage.py runserver`:
+{% filename %}Cloud 9{% endfilename %}
 
-{% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py runserver
-```
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
 
-Если ты работаешь в Windows, и команда падает с ошибкой `UnicodeDecodeError`, используй вместо неё другую:
+Если вы используете Windows, и команда падает с ошибкой `UnicodeDecodeError`, используйте вместо неё другую:
 
 {% filename %}command-line{% endfilename %}
-```
-(myvenv) ~/djangogirls$ python manage.py runserver 0:8000
-```
 
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
 
-Теперь тебе нужно проверить, работает ли веб-сайт — открой браузер (Firefox, Chrome, Safari, Internet Explorer или любой другой) и набери следующий адрес:
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
 
 {% filename %}browser{% endfilename %}
-```
-http://127.0.0.1:8000/
-```
 
-Поздравляем! Ты только что создала свой первый веб-сайт и запустила его на веб-сервере! Ну не круто ли?
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
 
-![Сработало!][3]
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Поздравляем! Ты только что создала свой первый веб-сайт и запустила его на веб-сервере! Ну не круто ли?
 
- [3]: images/it_worked2.png
+![Сработало!](images/it_worked2.png)
 
-Пока работает веб-сервер, в терминале не будет приглашения для ввода команд. Ты всё ещё сможешь ввести текст, но не сможешь выполнить никакую другую команду. Это происходит потому, что сервер продолжает работу, "слушая" входящие запросы.
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
 
-> Мы рассматривали, как работают веб-сервера, в главе <b>Как работает интернет</b>.
+> We reviewed how web servers work in the **How the Internet works** chapter.
 
-Веб-сервер займёт командную строку, пока ты его не остановишь. Чтобы и дальше иметь возможность набирать команды, открой ещё одно окно терминала и активируй в нём виртуальное окружение. Чтобы остановить веб-сервер, перейди обратно в окно, в котором он работает, и нажми CTRL + C — кнопки Control и C вместе (в Windows может потребоваться нажать клавиши Ctrl + Break).
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
 
-Готова к следующему шагу? Пришло время создать содержимое для нашего блога!
+Готова к следующему шагу? Пришло время создать наполнение для нашего блога!
\ No newline at end of file
diff --git a/ru/django_templates/README.md b/ru/django_templates/README.md
index a8bb37e22fb..8ebca0c37a9 100755
--- a/ru/django_templates/README.md
+++ b/ru/django_templates/README.md
@@ -2,113 +2,105 @@
 
 Пришло время отобразить данные на сайте! Django поможет нам с этим при помощи встроенных **тегов шаблонов**.
 
-## Что представляют из себя теги шаблонов?
+## Что представляются из себя теги шаблонов?
 
-Как видишь, в HTML нельзя помещать код Python, поскольку браузеры не понимают его. Они знают только HTML. Мы помним, что HTML статичен, в то время как Python позволяет динамические изменения.
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
 
-__Теги шаблонов Django__ позволяют нам вставлять Python в HTML, так что ты можешь создавать динамические веб-сайты быстрее и проще. То, что надо!
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
 ## Отображаем шаблон списка записей
 
 В предыдущей главе мы передали нашему шаблону список записей в переменной `posts`. Теперь мы отобразим его в HTML.
 
-Чтобы вставить переменную в шаблон Django, нам нужно использовать двойные фигурные скобки с именем переменной внутри:
+Чтобы вставить переменную в шаблон Django, нам нужно использовать двойные фигурные скобочки с именем переменной внутри:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {{ posts }}
 ```
 
 Попробуй это в шаблоне `blog/templates/blog/post_list.html`. Замени всё, начиная со второго `<div>` и вплоть до третьего `</div>` кодом `{{ posts }}`. Сохрани файл и обнови страницу, чтобы увидеть результат:
 
-![Рисунок 13.1][1]
-
- [1]: images/step1.png
+![Рисунок 13.1](images/step1.png)
 
 Как ты можешь заметить, мы получили следующую строку:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <QuerySet [<Post: My second post>, <Post: My first post>]>
 ```
 
-Это показывает, что Django понял переменную как список объектов. Помнишь из главы __Введение в Python__, как мы можем аккуратно отобразить список? Правильно, циклом for! В шаблонах Django ты можешь использовать их таким образом:
+Это показывает, что Django понял переменную как список объектов. Помнишь из главы **Введение в Python** как мы можем аккуратно отобразить список? Правильно, циклом for! В шаблонах Django ты можешь использовать их таким образом:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
-    {{ post }}
+    {{ post }}
 {% endfor %}
 ```
 
 Попробуй вставить это в свой шаблон.
 
-![Рисунок 13.2][2]
-
- [2]: images/step2.png
+![Рисунок 13.2](images/step2.png)
 
-Сработало! Но мы хотим, чтобы они отображались как статические записи, которые мы создавали в главе __Введение в HTML__. Ты можешь смешивать HTML и теги шаблонов. Наш элемент `body` будет выглядеть следующим образом:
+Сработало! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. ты можешь смешивать HTML и теги шаблонов. Наш элемент `body` будет выглядеть следующим образом:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div>
-    <h1><a href="/">Django Girls Blog</a></h1>
+    <h1><a href="/">Django Girls Blog</a></h1>
 </div>
 
 {% for post in posts %}
-    <div>
-        <p>published: {{ post.published_date }}</p>
-        <h1><a href="">{{ post.title }}</a></h1>
-        <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endfor %}
 ```
 
-{% raw %}Всё, что ты поместишь между `{% for %}` и `{% endfor %}`, будет повторено для каждого объекта в списке. Обнови страницу:{% endraw %}
+{% raw %}Всё что ты поместишь между `{% for %}` и `{% endfor %}` будет повторено для каждого объекта в списке. Обнови страницу:{% endraw %}
 
-![Рисунок 13.3][3]
+![Рисунок 13.3](images/step3.png)
 
- [3]: images/step3.png
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? Мы обращаемся к различным полям нашей модели `Post`. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
 
-Ты заметила, что мы использовали немного другую запись в этот раз: `{{ post.title }}` или `{{ post.text }}`? Мы обращаемся к различным полям нашей модели `Post`. Также `|linebreaksbr` прогоняет текст через фильтр для преобразования переносов строк в параграфы.
+## Еще один момент
 
-## Ещё один момент
-
-Пришло время ещё раз убедиться, что наш сайт будет работать в сети, согласна? Попробуем развернуть новую версию сайта на PythonAnywhere. Краткий обзор необходимых шагов...
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
 
 * Сначала загружаем код на Github
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-[...]
-$ git add --all .
-$ git status
-[...]
-$ git commit -m "Modified templates to display posts from database."
-[...]
-$ git push
-```
 
-* Затем заходим на [PythonAnywhere][4], открываем **Bash console** и набираем команду:
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
 
- [4]: https://www.pythonanywhere.com/consoles/
+* Затем заходим на [PythonAnywhere](https://www.pythonanywhere.com/consoles/), открываем **Bash console** и набираем команду:
 
 {% filename %}PythonAnywhere command-line{% endfilename %}
-```
-$ cd my-first-blog
-$ git pull
-[...]
-```
-
-* Наконец, переключаемся на вкладку [Web][5] и жмём кнопку **Reload**. Обновления запущены в жизнь! Даже если записи в твоём блоге на PythonAnywhere отличаются от записей в блоге на локальном сервере, то всё в порядке. Базы данных на твоём локальном компьютере и на PythonAnywhere не синхронизируются, в отличиет от остальных файлов проекта.
 
- [5]: https://www.pythonanywhere.com/web_app_setup/
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
-Поздравляем! Теперь попробуй добавить новые записи через панель администратора Django (не забывай указывать published_date!). Удостоверься, что ты в панели администратора своего сайта на PythonAnywhere (https://yourname.pythonanywhere.com/admin). Затем обнови страницу, чтобы проверить, появились ли новые записи.
+* Наконец, переключаемся на вкладку [Web](https://www.pythonanywhere.com/web_app_setup/) и жмем кнопку **Reload**. Обновления запущены в жизнь! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
 
-Работает как по волшебству? Есть чем гордиться! Отойди от компьютера на секунду — ты заслужила перерыв :)
+Поздравляем! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
 
-![Рисунок 13.4][6]
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
 
- [6]: images/donut.png
+![Рисунок 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ru/django_urls/README.md b/ru/django_urls/README.md
index 4b0be98812c..7a1e2e712b6 100755
--- a/ru/django_urls/README.md
+++ b/ru/django_urls/README.md
@@ -1,22 +1,21 @@
-# URL-адреса Django
+# Django URLs
 
-Мы собираемся сделать нашу первую веб-страничку — домашнюю страницу твоего блога! Но для начала давай чуть ближе познакомимся с URL-адресами в Django.
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
 
 ## Что такое URL-адрес?
 
-URL — это просто адрес в интернете. Ты можешь увидеть URL каждый раз, когда посещаешь веб-сайт — он отображается в адресной строке твоего браузера (да, `127.0.0.1:8000` — это URL-адрес! И `https://djangogirls.org` — тоже URL):
+URL — это просто адрес в интернете. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` это URL-адрес! And `https://djangogirls.org` is also a URL.)
 
-![URL-адрес][1]
+![URL-адрес](images/url.png)
 
- [1]: images/url.png
-
-Любая страница в Интернете нуждается в собственном URL-адресе. Таким образом ваше приложение точно знает, что показать пользователю, который открывает конкретный URL-адрес. В Django мы используем так называемый `URLconf` (англ. URL configuration, конфигурация URL). URLconf — это набор шаблонов, которые Django попробует сравнить с полученным URL, чтобы выбрать правильный метод для отображения (view).
+Любая страница в Интернете нуждается в собственном URL-адресе. This way your application knows what it should show to a user who opens that URL. В Django мы используем кое-что под названием `URLconf` (англ. URL configuration, конфигурация URL). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
 
 ## Как URL-адреса работают в Django?
 
 Давай откроем файл `mysite/urls.py` в нашем редакторе и посмотрим, как он выглядит:
 
 {% filename %}mysite/urls.py{% endfilename %}
+
 ```python
 """mysite URL Configuration
 
@@ -30,55 +29,58 @@ urlpatterns = [
 ]
 ```
 
-Как можешь заметить, Django уже кое-что разместил здесь для нас.
+As you can see, Django has already put something here for us.
 
-Строки, расположенные между тройными кавычками (`'''` или `"""`), называются `docstrings` — ты можешь добавить их в начале файла, класса или метода для описания их функциональности. Python будет их игнорировать при запуске приложения.
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. Интерпретатор Python пропустит их при выполнении скрипта.
 
-URL-адрес раздела администрирования, который мы посещали в предыдущей главе, уже здесь присутствует:
+The admin URL, which you visited in previous chapter, is already here:
 
 {% filename %}mysite/urls.py{% endfilename %}
+
 ```python
     url(r'^admin/', admin.site.urls),
 ```
 
-Таким образом, любому URL-адресу, начинающемуся с `admin/`, Django будет находить соответствующее *view* (представление). В этом случае мы охватываем большое количество различных URL-адресов, которые явно не прописаны в этом маленьком файле — так он становится более аккуратным и удобочитаемым.
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
 
 ## Regex
 
-Ты спрашиваешь себя, как Django сопоставляет URL-адреса и представления? Ну, это не так просто. В Django используются так называемые регулярные выражения (англ. «regular expressions» — сокращённо `regex`). Регулярные выражения имеют множество (множество!) правил, которые формируют поисковый шаблон. Поскольку регулярные выражения являются довольно сложной темой, мы не будем рассматривать их подробно.
+Спрашиваешь себя, как Django сопоставляет URL-адреса и представления? Ну, это не так просто. В Django используются так называемые регулярные выражения (англ. "regular expressions" — сокращённо `regex`). Регулярные выражения имеют множество (множество!) правил, которые формируют поисковый шаблон. Поскольку регулярные выражения являются довольно сложной темой, мы остановимся на них чуть подробнее.
 
-Если ты все еще хочешь разобраться в написании шаблонов, приведём пример — нам потребуется лишь ограниченное число правил для описания шаблона, а именно:
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
 
-* ^ — начало текста;
-* $ — конец текста;
-* \d — цифра;
-* `+` — чтобы указать, что предыдущий элемент должен быть повторен как минимум один раз;
-* () — для получения части шаблона.
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
 
-Всё остальное в шаблоне URL будет интерпретироваться буквально.
+Anything else in the URL definition will be taken literally.
 
-Теперь представь, что у нас есть веб-сайт с адресом `http://www.mysite.com/post/12345/`, где `12345` — номер записи в блоге.
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
 
-Писать представления для всех номеров будет весьма утомительно. С помощью регулярных же выражений мы можем создать шаблон, соответствующий url, который позволит извлекать из адреса номер: `^post/(\d+)/$`. Давай разобьём шаблон на части, чтобы понять логику его работы:
+Писать представления для всех номеров будет весьма утомительно. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
 
-* **^post/** говорит Django рассматривать url с `post/` в начале (сразу после `^`);
-* **(\d+)** означает, что дальше должен присутствовать номер (одна или несколько цифр) и мы хотим извлечь его из url;
-* **/** говорит Django об очередном символе `/` после номера;
-* **$** означает конец url, т.е. шаблону соответствуют только адреса с `/` на конце.
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** означает, что дальше должен присутствовать номер (одна или несколько цифр) и мы хотим извлечь его из url
+* **/** говорит Django об очередном символе `/` после номера
+* **$** означает конец url, т.е. шаблону соответствуют только адреса с `/` на конце
 
-## Твой первый URL-адрес в Django!
+## Your first Django URL!
 
-Пришло время создать твой первый URL-адрес! Мы хотим, чтобы 'http://127.0.0.1:8000/' возвращал домашнюю страничку нашего блога со списком записей в нём.
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
 
-Мы также хотим сохранить файл `mysite/urls.py` в максимально аккуратном виде, так что мы импортируем URL-адреса для нашего приложения `blog` в `mysite/urls.py`.
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
 
-Вперёд, добавь строку для импорта `blog.urls`. Обрати внимение, что здесь мы используем функцию `include`, поэтому тебе придется импортировать её в первой строке своего файла.
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
 
 Файл `mysite/urls.py` должен выглядеть следующим образом:
 
 {% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import include
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
@@ -89,39 +91,39 @@ urlpatterns = [
 
 Django теперь будет перенаправлять все запросы 'http://127.0.0.1:8000/' к `blog.urls` и искать там дальнейшие инструкции.
 
-При написании регулярных выражений на Python всегда указывай `r` в начале строки. Это полезный намёк для Python, что строка может содержать специальные символы, предназначенные не для самого Python, а для регулярного выражения.
+Writing regular expressions in Python is always done with `r` in front of the string. Это полезный намек для Python, что строка может содержать специальные символы, предназначенные не для самого Python, а для регулярного выражения.
 
 ## blog.urls
 
-Создай новый пустой файл `blog/urls.py`. Отлично! Добавь в него следующие две строки:
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
 ```
 
-Так мы импортировали функцию `url` Django и все `views` (представления) из приложения `blog` (у нас их пока нет, но через минуту они появятся!)
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
 
 После этого мы можем добавить наш первый URL-шаблон:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
 ]
 ```
 
-Как ты можешь заметить, мы связали `view` под именем `post_list` с URL-адресом `^$`. Это регулярное выражение будет соответствовать `^` (началу) и следующему `$` (концу), т.е. пустой строке. Это правильно, потому что для обработчиков URL в Django 'http://127.0.0.1:8000/' не является частью URL. Этот шаблон скажет Django, что `views.post_list` — это правильное направление для запроса к твоему веб-сайту по адресу 'http://127.0.0.1:8000/'.
-
-Последняя часть `name='post_list'` — это имя URL, которое будет использовано, чтобы идентифицировать его. Оно может быть таким же, как имя представления (англ. view), а может и чем-то совершенно другим. Мы будем использовать именованные URL позднее в проекте, поэтому важно указывать их имена уже сейчас. Мы также должны попытаться сохранить имена URL-адресов уникальными и легко запоминающимися.
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. Это правильно, потому что для обработчиков URL в Django 'http://127.0.0.1:8000/' не является частью URL. Этот шаблон скажет Django, что `views.post_list` — это правильное направление для запроса к твоему веб-сайту по адресу 'http://127.0.0.1:8000/'.
 
-Если сейчас ты попытаешься открыть страницу http://127.0.0.1:8000/ в браузере, то увидишь сообщение о том, что веб-страница недоступна. Это произошло потому, что сервер (помнишь, как мы набирали `runserver`?) перестал обрабатывать запросы. Чтобы понять почему, открой окно своей командной строки.
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. Оно может быть таким же, как имя представления (англ. view), а может и чем-то совершенно другим. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
 
-![Ошибка][2]
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
 
- [2]: images/error1.png
+![Ошибка](images/error1.png)
 
-В твоей командной строке появилось сообщение об ошибке, но не беспокойся — оно, на самом деле, довольно полезно. Ты можешь прочесть, что не существует атрибута с именем 'post_list' — __no attribute 'post_list'__. Это название **представления**, которое Django пытается найти и использовать, но мы же его ещё не создали. В данный момент раздел `/admin/` тоже не будет работать. Не беспокойся, мы этим займёмся.
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
 
-> Если хочешь узнать больше о Django URLconfs, посмотри официальную документацию: https://docs.djangoproject.com/en/1.11/topics/http/urls/
+> Если хочешь узнать больше о Django URLconfs, посмотри официальную документацию: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/ru/django_views/README.md b/ru/django_views/README.md
index 69c4186af4b..ced3e677dfe 100755
--- a/ru/django_views/README.md
+++ b/ru/django_views/README.md
@@ -1,8 +1,8 @@
-# Представления в Django – время создавать!
+# Django views – time to create!
 
-Пришло время избавиться от ошибки, на которую мы наткнулись в прошлой главе :)
+Пришло время избавиться от ошибки, на которую мы наткнулись в прошлой главе! :)
 
-*view*, или *представление*, — это то место, где мы разместим «логику» работы нашего приложения. Оно запросит информацию из `модели`, которую мы создали ранее, и передаст её в `шаблон`. Шаблонами мы займёмся в следующей главе. Представления похожи на методы в Python и лишь немногим сложнее того, с чем мы уже сталкивались в главе __Введение в Python__.
+*view* это то место, где мы разместим "логику" работы нашего приложения. Оно запросит информацию из `модели`, которую мы создали ранее, и передаст её в `шаблон`. Шаблонами мы займёмся в следующей главе. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
 
 Представления размещаются в файле `views.py`. Мы добавим свои *представления* в файл `blog/views.py`.
 
@@ -11,34 +11,34 @@
 Хорошо, давай откроем этот файл и посмотрим на его содержимое:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
 # Create your views here.
 ```
 
-Не слишком много кода.
+Not too much stuff here yet.
 
-Помнишь, что строки, начинающиеся с символа `#` — это комментарии? То есть Python не будет пытаться запустить их содержимое.
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
 
- Простейшее *представление* может выглядеть следующим образом.
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Как ты можешь заметить, мы создали функцию (`def`) с именем `post_list`, которая принимает `request` в качестве аргумента и возвращает (`return`) результат работы функции `render`, которая уже соберёт наш шаблон страницы `blog/post_list.html`.
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
 
-Сохрани файл, перейди по адресу http://127.0.0.1:8000/ и посмотри, что у нас получилось.
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
 
 Другая ошибка! Читаем, что произошло:
 
-![Ошибка][1]
-
- [1]: images/error.png
+![Ошибка](images/error.png)
 
-Это значит, что, по крайней мере, сервер снова работает, но что-то всё же пошло не так, верно? Не беспокойся, это просто страница с сообщением об ошибке, бояться совершенно нечего! Как и сообщения об ошибках в консоли, такие страницы чрезвычайно полезны. Здесь ты можешь прочесть: *TemplateDoesNotExist* — такого шаблона не существует. Давай исправим ошибку и создадим шаблон в следующей главе!
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
 
-> Подробнее о представлениях в Django можно узнать из официальной документации: https://docs.djangoproject.com/en/1.11/topics/http/views/
+> Подробнее о представлениях в Django можно узнать из официальной документации: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/ru/dynamic_data_in_templates/README.md b/ru/dynamic_data_in_templates/README.md
index 06109f7c694..4db279f8bee 100755
--- a/ru/dynamic_data_in_templates/README.md
+++ b/ru/dynamic_data_in_templates/README.md
@@ -1,78 +1,81 @@
 # Динамически изменяющиеся данные в шаблонах
 
-Отдельные части уже размещены в нужных местах: модель `Post` определена в файле `models.py`, `post_list` — в файле `views.py`, и добавлен шаблон. Но как нам отобразить записи в шаблоне HTML-страницы? Ведь именно этого нам и нужно добиться: взять определённый контент (модели, сохранённые в базе данных) и аккуратно отобразить их в шаблоне, верно?
+Отдельные части уже размещены в нужных местах: модель `Post`, определенна в файле `models.py`, `post_list` - в файле `views.py` и добавлен шаблон. Но как нам отобразить записи в шаблоне HTML-страницы? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
 
-Для этого и предназначены *представления*: соединять между собой модели и шаблоны. В `post_list` *представлению* нужно будет взять модели, которые мы хотим отобразить, и передать их шаблону. Таким образом, в *представлениях* мы определяем, что (какая модель) будет отображена в шаблоне.
+Для этого и предназначены *представления*: соединять между собой модели и шаблоны. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
 
-Хорошо, так как мы этого добьёмся?
+OK, so how will we achieve this?
 
-Нам нужно открыть файл `blog/views.py`. Пока что *представление* `post_list` выглядит следующим образом:
+Нам нужно открыть файл `blog/views.py`. Таким образом *представление* `post_list` будет выглядеть следующим образом:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
 def post_list(request):
-    return render(request, 'blog/post_list.html', {})
+    return render(request, 'blog/post_list.html', {})
 ```
 
-Помнишь, мы говорили о включении кода из других файлов? Теперь нам нужно включить модель, которую мы определили в файле `models.py`. Мы добавим строку `from .models import Post` следующим образом:
+Помнишь мы говорили о включении кода из других файлов? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from .models import Post
 ```
 
-Точка перед `models` означает *текущую директорию* или *текущее приложение*. Поскольку `views.py` и `models.py` находятся в одной директории, мы можем использовать точку `.` и имя файла (без расширения `.py`). Затем мы импортируем модель (`Post`).
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Затем мы импортируем модель (`Post`).
 
-Но что дальше? Чтобы получить реальную запись из модели `Post`, нам нужен `QuerySet`.
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
 
 ## QuerySet
 
-Ты уже должна быть знакома с принципом работы QuerySet. Мы говорили о нём в главе [Django ORM (QuerySets)][1].
-
- [1]: ../django_orm/README.md
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
 
-Сейчас нас интересует список записей блога, отсортированных по `published_date`, согласна? Мы уже делали это в главе о QuerySet!
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
 ```
 
-Теперь нам нужно включить эту строку кода в файл`blog/views.py`, добавив её в функцию `def post_list(request)`, но сначала не забудь добавить строку `from django.utils import timezone`:
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from django.utils import timezone
 from .models import Post
 
 def post_list(request):
-    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-    return render(request, 'blog/post_list.html', {})
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
 ```
 
-Нам осталось передать QuerySet `posts` в шаблон (мы расскажем о том, как отобразить его на странице, в следующей главе).
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
 
-Пожалуйста, обрати внимание, что мы создали *переменную* для QuerySet: `posts`. Можешь думать о ней как об имени для нашего QuerySet. Теперь мы можем обращаться к нему, используя имя.
+Пожалуйста, обрати внимание, что мы создали *переменную* для QuerySet: `posts`. Можешь думать о неё как об имени для нашего QuerySet. Теперь мы можем обращаться к нему, используя имя.
 
-В функции `render` у нас уже есть параметр `request` (т.е. всё, что мы получим от пользователя в качестве запроса через Интернет) и файл шаблона `'blog/post_list.html'`. Последний параметр, который выглядит как `{}`, — это место, куда мы можем добавить что-нибудь для использования в шаблоне. Мы должны задавать имена передаваемым шаблону вещам (прямо сейчас мы остановимся на `'posts'` :)). В итоге параметр будет выглядеть следующим образом: `{'posts': posts}`. Обрати внимание, что часть перед `:` является строкой; её нужно обернуть в кавычки `''`.
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. Мы должны задавать имена, передаваемым шаблону вещам (мы будем придерживаться `'posts'` прямо сейчас). :) В итоге параметр будет выглядеть следующим образом: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
 
 В результате файл `blog/views.py` должен выглядеть следующим образом:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from django.utils import timezone
 from .models import Post
 
 def post_list(request):
-    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-    return render(request, 'blog/post_list.html', {'posts': posts})
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
 ```
 
-Вот и всё! Теперь пришло время перейти к шаблону и отобразить QuerySet на странице!
+Вот и все! Теперь пришло время перейти к шаблону и отобразить QuerySet на странице!
 
-Подробнее о QuerySets в Django можно узнать в официальной документации: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/ru/extend_your_application/README.md b/ru/extend_your_application/README.md
index 55f778f80c1..fcb6236bdc6 100755
--- a/ru/extend_your_application/README.md
+++ b/ru/extend_your_application/README.md
@@ -1,62 +1,61 @@
 # Расширяем свое приложение
 
-Мы уже выполнили часть необходимых шагов для создания веб-сайта: мы знаем как создать модель, URL, представление и шаблон. Мы также знаем, как улучшить визуальный дизайн с помощью CSS.
+Мы уже выполнили часть необходимых шагов для создания веб-сайта: мы знаем как создать модель, URL, представление и шаблон. Мы также знаем как улучшить визуальный дизайн с помощью CSS.
 
-Время для практики!
+Время практики!
 
-Первое, что нам потребуется в блоге — страница для отображения конкретной записи, верно?
+Первое, что нам потребуется в блоге - страница для отображения конкретной записи, верно?
 
 У нас уже есть модель `Post`, так что нам не нужно добавлять дополнительный код в файл `models.py`.
 
 ## Создадим в шаблоне ссылку на страницу поста
 
-Мы начнём с добавления ссылки внутри файла `blog/templates/blog/post_list.html`. Пока он выглядит следующим образом:
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 ```html
 {% extends 'blog/base.html' %}
 
 {% block content %}
-    {% for post in posts %}
-        <div class="post">
-            <div class="date">
-                {{ post.published_date }}
-            </div>
-            <h1><a href="">{{ post.title }}</a></h1>
-            <p>{{ post.text|linebreaksbr }}</p>
-        </div>
-    {% endfor %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
 {% endblock %}
 ```
 
-{% raw %}Нам хотелось бы иметь ссылку с заголовка поста в списке на страницу с подробной информацией о посте. Давай изменим `<h1><a href="">{{ post.title }}</a></h1>`, чтобы получилась ссылка на пост:{% endraw %}
+{% raw %}Нам хотелось бы иметь ссылку с заголовка поста в списке на страницу подробной информации о посте. Давай изменим `<h1><a href="">{{ post.title }}</a></h1>` чтобы получилась ссылка на пост:{% endraw %}
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
 ```
 
 {% raw %}Самое время разобраться с загадочным `{% url 'post_detail' pk=post.pk %}`. Как можешь предположить, синтаксис `{% %}` означает использование тегов шаблонов Django. На этот раз мы используем тот, что создаст для нас URL!{% endraw %}
 
-Параметр `post_urls` означает, что Django будет искать URL с именем `post_detail` в файле `blog.urls.py`.
-
-А что насчёт `pk=post.pk`? `pk` — это сокращение от primary key (первичный ключ). Он уникальным образом определяет каждую запись в базе данных. Поскольку мы не задали первичного ключа в нашей модели `Post`, Django создал такой ключ за нас (по умолчанию это порядковый номер, то есть 1, 2, 3…) и добавил поле `pk` к каждой записи блога. Для получения первичного ключа мы напишем `post.pk` — точно так же, как мы получали значения остальных полей (`title`, `author` и т.д.) нашего объекта `Post`.
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
 
-Теперь, когда мы перейдем по адресу http://127.0.0.1:8000/, мы получим ошибку (как и ожидается, поскольку у нас нет прописанного URL и *представления* для `post_detail`). Она будет выглядеть следующим образом:
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
 
-![Ошибка NoReverseMatch][1]
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
 
- [1]: images/no_reverse_match2.png
+![Ошибка NoReverseMatch](images/no_reverse_match2.png)
 
 ## Создадим URL для страницы поста
 
-Давай создадим в `urls.py` URL для *представления* `post_detail`!
+Давай создадим URL в `urls.py` для *представления* `post_detail`!
 
-Мы хотим, чтобы наш первый пост отображался на странице со следующим **URL**-адресом: http://127.0.0.1:8000/post/1/
+Мы хотим, чтобы адрес страницы нашего первого поста был таким: **URL**: http://127.0.0.1:8000/post/1/
 
-Давай создадим URL в файле `blog/urls.py` и укажем Django на *представление* под названием `post_detail`, которое будет отображать пост целиком. Добавь строчку `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` в файл `blog/urls.py`. Файл должен выглядеть примерно так:
+Давай создадим URL в файле `blog/urls.py` и укажем Django на *представление* под названием `post_detail`, которое будет отображать пост целиком. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. Файл должен выглядеть примерно так:
 
 {% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
@@ -67,143 +66,132 @@ urlpatterns = [
 ]
 ```
 
-Фрагмент `^post/(?P<pk>[0-9]+)/$` выглядит страшновато, но не волнуйся — мы его сейчас поясним:
-- он начинается с `^`, что означает, как мы помним, "начало строки";
-- `post/` значит всего лишь, что после начала строки URL должен содержать слово **post** и косую черту **/**. Пока всё в порядке.
-- `(?P<pk>\d+)` — эта часть посложнее. Она означает, что Django возьмёт всё, что придется на эту часть строки, и передаст представлению в качестве переменной `pk` (обрати внимание, что её имя соответствуем имени переменной, используемой в качестве первичного ключа в файле `blog/templates/blog/post_list.html`). `\d+` означает, что допустимы только цифры (от 0 до 9), но не буквы. `+` означает, что цифр должно быть одна или более. Таким образом, адрес `http://127.0.0.1:8000/post//` будет недействительным, а `http://127.0.0.1:8000/post/1234567890/` совершенно правильным!
-- `/` — затем нам нужен еще один символ __/__;
-- `$` — «конец»!
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
 
-Если ты введёшь адрес `http://127.0.0.1:8000/post/5/` в браузер, Django должен понять, что тебе требуется *представление* под именем `post_detail`, и передать информацию о переменной `pk` (равной `5`) этому *представлению*.
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. Она означает, что Django возьмет все, что придется на эту часть строки и передаст представлению в качестве переменной `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` означает, что цифр должно быть от одной и больше. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
 
-Славненько, мы добавили новый шаблон URL в файл `blog/urls.py`! Давай обновим страницу: http://127.0.0.1:8000/. Бууум! Сервер снова перестал работать. Проверь консоль — как и ожидалось, ещё одна ошибка!
+Если ты введешь адрес `http://127.0.0.1:8000/post/5/` в браузер, Django должен понять, что тебе требуется *представление* под именем `post_detail`, и передать информацию о переменной `pk` (равной `5`) этому *представлению*.
 
-![AttributeError][2]
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
 
- [2]: images/attribute_error2.png
+![AttributeError](images/attribute_error2.png)
 
 Помнишь, каким должен быть следующий шаг? Конечно: добавить представление!
 
 ## Добавим представление для страницы поста
 
-В этот раз *представление* получит дополнительный параметр `pk`. Но как дать нашему *представлению* знать о нём? Для этого мы определим функцию как `def post_detail(request, pk):`. Обрати внимание, что мы должны использовать то же имя переменной, что мы выбрали для обработки URL (`pk`). Пропуск переменной будет неправилен и приведёт к ошибке!
+This time our *view* is given an extra parameter, `pk`. Но как дать нашему *представлению* знать о нем? Для этого мы определим функцию как `def post_detail(request, pk):`. Обрати внимание, что мы должны использовать тоже имя переменной, что мы выбрали для обработки URL (`pk`). Пропуск переменной будет неправилен и приведет к ошибке!
 
-Теперь мы хотим получить одну конкретную запись из блога. Для этого потребуется использовать QuerySet:
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 Post.objects.get(pk=pk)
 ```
 
-Однако в этом коде есть проблема. Если не существует экземпляра объекта `Post` с заданным `primary key` (`pk`), мы получим страшную ошибку!
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
 
-![Ошибка DoesNotExist][3]
+![Ошибка DoesNotExist](images/does_not_exist2.png)
 
- [3]: images/does_not_exist2.png
+Мы этого не хотим! Однако, Django, конечно, имеет средство, которое позволит нам её обойти: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
 
-Мы этого не хотим! Однако в Django, конечно, есть средство, которое позволит нам её обойти: `get_object_or_404`. В случае, если не существует экземпляра объекта `Post` с заданным `pk`, мы получим намного более приятную страницу (которая называется `Page Not Found 404`).
+![Страница не найдена](images/404_2.png)
 
-![Страница не найдена][4]
+Хорошая новость в том, что ты можешь сделать свою страницу `Page not found`. Но для нас сейчас это не самая важная задача и мы её пропустим.
 
- [4]: images/404_2.png
+OK, time to add a *view* to our `views.py` file!
 
-Хорошая новость состоит в том, что ты можешь сделать свою страницу `Page not found`. Но для нас сейчас это не самая важная задача, и мы её пропустим.
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
 
-Хорошо, пришло время добавить *представление* в файл `views.py`!
-
-В файле `blog/urls.py` мы создали шаблон URL под названием `post_detail`, который ссылался на представление под названием `views.post_detail`. Это значит, что Django ожидает найти функцию-представление с названием `post_detail` в `blog/views.py`.
-
-Нам нужно открыть файл `blog/views.py` и добавить в него следующий код:
+We should open `blog/views.py` and add the following code near the other `from` lines:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render, get_object_or_404
 ```
 
-— рядом с другими строками, начинающимися с `from`. В конец же файла мы добавим наше новое *представление*:
+And at the end of the file we will add our *view*:
 
 {% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_detail(request, pk):
-    post = get_object_or_404(Post, pk=pk)
-    return render(request, 'blog/post_detail.html', {'post': post})
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
 ```
 
-Вот так. Теперь обнови страницу http://127.0.0.1:8000/
+Именно. Теперь обнови страницу http://127.0.0.1:8000/
 
-![Представление списка записей][5]
+![Представление списка записей](images/post_list2.png)
 
- [5]: images/post_list2.png
+Заработало! Только что произойдет, если ты попробуешь перейти по ссылке из заголовка записи?
 
-Заработало! Только что произойдёт, если ты попробуешь перейти по ссылке из заголовка записи?
+![Ошибка TemplateDoesNotExist](images/template_does_not_exist2.png)
 
-![Ошибка TemplateDoesNotExist][6]
+Ой, нет! Другая ошибка! Но мы уже знаем как иметь с ней дело, верно? Нам нужно добавить шаблон!
 
- [6]: images/template_does_not_exist2.png
-
-Ой, нет! Другая ошибка! Но мы уже знаем, как иметь с ней дело, верно? Нам нужно добавить шаблон!
-
-## Создадим шаблон для страницы поста
+## Create a template for the post details
 
 Мы создадим файл `post_detail.html` в директории `blog/templates/blog`.
 
-Он должен содержать следующее:
+Должно получиться примерно так:
 
 {% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
 {% block content %}
-    <div class="post">
-        {% if post.published_date %}
-            <div class="date">
-                {{ post.published_date }}
-            </div>
-        {% endif %}
-        <h1>{{ post.title }}</h1>
-        <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endblock %}
 ```
 
 И снова мы расширяем `base.html`. В блоке `content` мы отображаем дату публикации (published_date, если она существует), заголовок и текст. Нам также нужно обсудить пару важных вещей, хорошо?
 
-{% raw %}`{% if ... %} ... {% endif %}` — это тег шаблона, который мы можем использовать, если нам нужно что-то проверить (помнишь конструкцию `if ... else ..` из главы **Введение в Python**?). В данном случае мы хотим проверить, не пуста ли дата публикации  поста — `published_date`.{% endraw %}
-
-Отлично, можешь перезагрузить страницу и проверить, пропала ли ошибка `Page not found`.
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
 
-![Отдельная страницы записи][7]
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
 
- [7]: images/post_detail2.png
+![Отдельная страницы записи](images/post_detail2.png)
 
-Ура! Всё работает!
+Ура! Все работает!
 
-## Ещё одна вещь: развёртывание!
+## Еще одна вещь: развертывание!
 
-Было бы неплохо проверить, что веб-сайт всё ещё будет работать на PythonAnywhere, верно? Давай еще раз проведём развёртывание.
+Было бы неплохо проверить, что веб-сайт все еще будет работать на PythonAnywhere, верно? Давай еще раз проведем развертывание.
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
-$ git push
-```
 
-Затем набери в [Bash-консоли PythonAnywhere][8]:
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
 
- [8]: https://www.pythonanywhere.com/consoles/
+Затем набери в [Bash консоли PythonAnywhere](https://www.pythonanywhere.com/consoles/):
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd my-first-blog
-$ git pull
-[...]
-```
 
-И нажми **Reload** на вкладке [Web][9].
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
- [9]: https://www.pythonanywhere.com/web_app_setup/
+И нажми **Reload** на вкладке [Web tab](https://www.pythonanywhere.com/web_app_setup/).
 
-Вот и всё! Поздравляем :)
+Вот и все! Поздравляем :)
\ No newline at end of file
diff --git a/ru/how_the_internet_works/README.md b/ru/how_the_internet_works/README.md
index 76f31772038..05245c921fe 100755
--- a/ru/how_the_internet_works/README.md
+++ b/ru/how_the_internet_works/README.md
@@ -1,55 +1,47 @@
 # Как работает Интернет
 
-> Для проходящих курс дома: эта глава рассмотрена в видео [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
 
-> Эта глава вдохновлена выступлением «Как работает Интернет» Джессики Маккеллар (http://web.mit.edu/jesstess/www/).
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
 
-Можем поспорить, что ты пользуешься Интернетом каждый день. Но знаешь ли ты на самом деле, что происходит после ввода адреса, например, https://djangogirls.org, в браузер и нажатия `Enter`?
+Первое, что тебе нужно понять, это то, что веб-сайт представляет собой просто группу файлов, сохраненных на жестком диске. Так же, как твои фильмы, музыка или фотографии. Тем не менее, есть одна особенность, которая является уникальной для сайтов: они содержат компьютерный код, называемый HTML.
 
-Первое, что тебе нужно понять, это то, что веб-сайт представляет собой просто группу файлов, сохраненных на жёстком диске. Так же, как твои фильмы, музыка или фотографии. Тем не менее, есть одна особенность, которая является уникальной для сайтов: они содержат компьютерный код, называемый HTML.
+Если ты не знакома с программированием, то сначала может быть трудно понять HTML, но твой веб-браузер (например, Chrome, Safari, Firefox, и т. д.) обожает его. Веб-браузеры созданы для того чтобы понимать этот код, следовать его указаниям и представлять файлы, из которых состоит твой веб-сайт, именно так, как ты этого хочешь.
 
-Если ты не знакома с программированием, то сначала может быть трудно понять HTML, но твой веб-браузер (например, Chrome, Safari, Firefox, и т. д.) обожает его. Веб-браузеры созданы для того, чтобы понимать этот код, следовать его указаниям и представлять файлы, из которых состоит твой веб-сайт, именно так, как ты этого хочешь.
+Как и с любым файлом, нам нужно хранить HTML файлы где-то на жестком диске. Для Интернета мы используем специальные мощные компьютеры, называемые *серверами*. У них нет экрана, мыши или клавиатуры, потому что их основной целью является хранение и обслуживание данных. That's why they're called *servers* – because they *serve* you data.
 
-Как и с любым файлом, нам нужно хранить HTML файлы где-то на жёстком диске. Для Интернета мы используем специальные, мощные компьютеры, называемые *серверами*. У них нет экрана, мыши или клавиатуры, потому что их основной целью является хранение и обслуживание данных. Вот почему они называются *серверами* — потому что они *обслуживают* (serve) твои данные.
-
-Хорошо, но ты хочешь знать, как выглядит Интернет, так?
+OK, but you want to know how the Internet looks, right?
 
 Мы нарисовали тебе картинку! Он выглядит вот так:
 
-![Рисунок 1.1][1]
-
- [1]: images/internet_1.png
-
-Довольно беспорядочно, правда? На самом деле, это сеть связанных машин (упомянутых выше *серверов*). Сотен тысяч машин! Километры и километры кабелей по всему миру! На веб-сайте с картой подводных кабелей (http://submarinecablemap.com/) ты сможешь увидеть, насколько сложной является сеть. Вот скриншот с сайта:
-
-![Рисунок 1.2][2]
-
- [2]: images/internet_3.png
+![Рисунок 1.1](images/internet_1.png)
 
-Поразительно, не так ли? Однако, очевидно, что невозможно соединить друг с другом кабелем все машины, подключенные к Интернету. Таким образом, чтобы достичь нужной машины (например, хранящей https://djangogirls.org), мы должны передать запрос через множество других машин.
+Довольно беспорядочно, правда? In fact it is a network of connected machines (the above-mentioned *servers*). Сотен тысяч машин! Много, много километров кабелей по всему миру! Ты можешь посетить веб-сайт с картой подводных кабелей (http://submarinecablemap.com/), чтобы увидеть, насколько сложной является сеть. Вот скриншот с сайта:
 
-Этот процесс выглядит следующим образом:
+![Рисунок 1.2](images/internet_3.png)
 
-![Рисунок 1.3][3]
+Поразительно, не так ли? Однако, очевидно, что невозможно соединить кабелем каждую машину, подключенную к Интернету. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
 
- [3]: images/internet_2.png
+Это выглядит приблизительно так:
 
-Представь себе, что когда ты вводишь адрес https://djangogirls.org, то отправляешь письмо, в котором говорится: «Дорогие Django Girls, я хочу увидеть сайт djangogirls.org. Отправьте мне его, пожалуйста!»
+![Рисунок 1.3](images/internet_2.png)
 
-Твое письмо отправляется в ближайшее почтовое отделение. Затем оно направляется в другое, которое немного ближе к адресату, а затем в следующее и так далее до его доставки в пункт назначения. Единственное отличие в том, что при отправке множества писем (*пакетов данных*) по одному адресу каждое из них может пойти через совершенно разные почтовые отделения (*маршрутизаторы*). Это зависит от того, как они были распределены в каждом отделении.
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
 
-![Рисунок 1.4][4]
+Твое письмо отправляется в ближайшее почтовое отделение. Затем оно направляется в другое, которое немного ближе к адресату, а затем в следующее и так далее до его доставки в пункт назначения. Единственное отличие в том, что при отправке множества писем (*пакетов данных*) по одному адресу, каждое из них может пойти через совершенно разные почтовые отделения (*маршрутизаторы*). Это зависит от того, как они были распределены в каждом отделении.
 
- [4]: images/internet_4.png
+![Рисунок 1.4](images/internet_4.png)
 
-Да, все так просто. Ты отправляешь сообщения и ждешь ответа. Конечно, вместо бумаги и ручки ты используешь байты данных, но идея та же!
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
 
-Вместо адресов с названием улицы, города, почтового индекса и названия страны мы используем IP-адреса. Твой компьютер сначала просит DNS (Domain Name System) перевести djangogirls.org в IP-адрес. Это работает примерно как в случае старых телефонных книг, где можно по имени человека, с которым ты хочешь связаться, найти его номер телефона и адрес.
+Вместо адресов с названием улицы, города, почтового индекса и названия страны мы используем IP-адреса. Твой компьютер сначала просит DNS (Domain Name System) перевести djangogirls.org в IP-адрес. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
 
-Когда ты отправляешь письмо, оно должно обладать определенными особенностями, чтобы его доставили правильно: адресом, маркой и т.д. Ты также используешь язык, который понимает получатель, верно? То же самое относится к *пакетам данных*, которые ты отправляешь, чтобы увидеть веб-сайт. Мы используем протокол под названием HTTP (англ. HyperText Transfer Protocol, протокол передачи гипертекста).
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Ты также используешь язык, который понимает получатель, верно? То же самое относится к *пакетам данных*, которые ты отправляешь, чтобы увидеть веб-сайт. Мы используем протокол под названием HTTP (англ. HyperText Transfer Protocol, протокол передачи гипертекста).
 
 Поэтому, в принципе, когда у тебя есть веб-сайт, то необходимо иметь и *сервер* (машину), где он находится. Когда *сервер* получает входящий *запрос* (в письме), он отправляет обратно твой веб-сайт (в другом письме).
 
-Поскольку это руководство по Django, разумно будет спросить — что же он делает в этой системе. Когда ты отправляешь ответ, то ты не всегда хочешь отправлять одно и то же письмо всем получателям. Намного лучше, если твои письма являются персонифицированными, особенно для человека, который только что тебе написал сам, правильно? Django помогает тебе с созданием этих персонализированных, интересных писем :).
+Since this is a Django tutorial, you might ask what Django does. Когда ты отправляешь ответ, то ты не всегда хочешь отправлять одно и то же письмо всем получателям. Намного лучше, если твои письма являются персонифицированными, особенно для человека, который только что сам тебе написал, правильно? Django помогает нам с созданием этих персонализированных, интересных писем. :)
 
-Ну, хватит болтать, время заняться делом!
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ru/html/README.md b/ru/html/README.md
index a75a1c30b1a..c9b42083dfb 100755
--- a/ru/html/README.md
+++ b/ru/html/README.md
@@ -1,46 +1,44 @@
 # Введение в HTML
 
-«Так что же это за шаблон?» — можешь спросить ты.
+Так что же это за шаблон, ты можешь спросить.
 
-Шаблон — это файл, который ты можешь использовать повторно для отображения различной информации в заданном формате; например, ты можешь использовать шаблон, чтобы упростить написание письма, поскольку письма хоть и различаются по содержанию и получателю, но сохраняют общую структуру.
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
 
-Шаблоны в Django написаны на языке, называемом HTML (это тот HTML, о котором было упоминание в первой главе __Как работает Интернет__).
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
 
 ## Что такое HTML?
 
-HTML — это простой код, который может быть интерпретирован твоим браузером — таким как Chrome, Firefox или Safari — чтобы отобразить веб-страницу пользователю.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
-HTML (от англ. "HyperText Markup Language") — язык гипертекстовой разметки. __Гипертекст__ — это тип текста, поддерживающий гиперссылки между страницами. Под __разметкой__ понимается введение в текст документа кода, который будет говорить браузеру (в нашем случае), как интерпретировать веб-страницу. HTML код строится при помощи __тегов__, каждый из которых должен начинаться с `<` и заканчиваться `>`. Эти теги представляют __элементы__ разметки.
+HTML (от англ. "HyperText Markup Language") - язык гипертекстовой разметки. **Гипертекст** - это тип текста, поддерживающий гиперссылки между страницами. Под **Разметкой** понимается введение в документ кода, который будет сообщать браузеру как правильно отобразить страницу. HTML код строится при помощи **тегов**, каждый из которых начинается символом `<` и заканчивается - `>`. Эти теги представляют **элементы** разметки.
 
 ## Твой первый шаблон!
 
-Создание шаблона означает создание файла шаблона. Всё есть файл, верно? Ты уже наверняка заметила это.
+Создание шаблона означает создание файла шаблона. Все есть файл, верно? Ты уже заметила это, наверно.
 
 Шаблоны сохраняются в директории `blog/templates/blog`. Для начала создай директорию `templates` внутри папки blog. Затем создай другую директорию `blog` внутри папки templates:
 
-```
-blog
-└───templates
-    └───blog
-```
+    blog
+    └───templates
+        └───blog
+    
 
-(Ты, вероятно, можешь задаться вопросом: зачем нам нужны две директории с одинаковым названием `blog` — как ты узнаешь позже, это просто удобное соглашение об именовании, которое делает жизнь проще, когда вещи серьезно усложняются.)
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
 
 Теперь создай файл `post_list.html` (для начала оставь его пустым) внутри директории `blog/templates/blog`.
 
 Посмотри как выглядит твой веб-сайт после этого: http://127.0.0.1:8000/
 
-> Если тебя всё ещё встречает ошибка `TemplateDoesNotExists`, попробуй перезапустить сервер. Перейди в командную строку, останови веб-сервер нажатием Ctrl+C (Ctrl и С одновременно) и запусти его снова командой `python manage.py runserver`.
+> Если возникает ошибка `TemplateDoesNotExist`, попробуй перезапустить сервер. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
 
-![Рисунок 11.1][1]
+![Рисунок 11.1](images/step1.png)
 
- [1]: images/step1.png
-
-Ошибки больше нет! Поздравляем :) Однако твой веб-сайт всё равно ничего не отображает, кроме пустой страницы, поскольку твой шаблон пуст. Нам нужно это исправить.
+Ошибки больше не! Поздравляем :) Однако, твой веб-сайт все равно ничего не отображает, кроме пустой страницы, поскольку твой шаблон пуст. Нам нужно это исправить.
 
 Добавь следующий код в файл шаблона:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <p>Hi there!</p>
@@ -48,30 +46,29 @@ blog
 </html>
 ```
 
-Как теперь выглядит твой веб-сайт? Нажми сюда, чтобы узнать: http://127.0.0.1:8000/
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
 
-![Рисунок 11.2][2]
-
- [2]: images/step3.png
+![Рисунок 11.2](images/step3.png)
 
 Заработало! Хорошая работа :)
 
-- Наиболее базовой тег, `<html>`, всегда присутствует в начале веб-страницы, а `</html>` — в конце. Как ты можешь заметить, основной контент веб-сайта находится между тегами `<html>` и `</html>`.
-- `<p>` — это тег для параграфов; `</p>`, соответственно, закрывает каждый параграф.
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. Как ты можешь заметить, основной контент веб-сайта находится между тегами `<html>` и `</html>`
+* `<p>` - это тег для параграфов; `</p>`, соответственно, закрывает каждый параграф
 
-## Head и body
+## Head and body
 
-Каждая HTML-страница также делится на два элемента: __head__ и __body__.
+Каждая HTML-страница также делится на два элемента: **head** и **body**.
 
-- __head__ — это элемент, содержащий информацию о документе, которая не отображается на экране.
+* **head** -- это элемент, содержащий информацию о документе, которая не отображается на экране.
 
-- __body__ — это элемент, который содержит всё, что будет отражено на веб-странице.
+* **body** -- это элемент, который содержит все, что будет отражено на веб-странице.
 
-Мы используем тег `<head>`, чтобы сообщить браузеру о настройках страницы, и тег `<body>` — о её содержимом.
+Мы используем тег `<head>` чтобы сообщить браузеру о настройках страницы и тег `<body>` - о её содержимом.
 
-Например, ты можешь разместить элемент title между тегов `<head>`:
+For example, you can put a web page title element inside the `<head>`, like this:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <head>
@@ -84,39 +81,37 @@ blog
 </html>
 ```
 
-
 Сохрани файл и обнови страницу.
 
-![Рисунок 11.3][3]
+![Рисунок 11.3](images/step4.png)
 
- [3]: images/step4.png
+Видишь, как браузер понял, что "Ola's blog" -- это заголовок страницы? Он понял `<title>Ola's blog</title>` и разместил текст в заголовке вкладки в твоем браузере (заголовок также будет использоваться при сохранении закладок и т.п.).
 
-Видишь, как браузер понял, что «Ola's blog» — это заголовок страницы? Он распознал `<title>Ola's blog</title>` и разместил текст в заголовке вкладки в твоем браузере (заголовок также будет использоваться при сохранении закладок и т.п.).
-
-Вероятно, ты уже заметила, что каждый открывающий тег имеет пару — *закрывающий*, с символом `/`, элементы таким образом становятся *вложенными* (ты не можешь закрыть тег, пока остаются открытыми теги внутри него).
+Вероятно, ты уже заметила, что каждый открывающий тег имеет пару -- *закрывающий*, с символом `/`, элементы таким образом становятся *вложенными* (ты не можешь закрыть тег, пока остаются открытыми теги внутри него).
 
 Это как складывать вещи в коробки. У нас есть одна большая коробка, `<html></html>`; внутри неё лежит коробка `<body></body>`, которая содержит еще меньшие коробки: `<p></p>`.
 
-Ты должна следовать этим правилам *закрытия* тегов и *вложенности* элементов: если ты их нарушишь, браузер не сможет интерпретировать код и корректно отобразить страницу.
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
 
 ## Настраиваем шаблон
 
-Сейчас ты можешь немного повеселиться и попробовать настроить шаблон по своему вкусу! Вот несколько полезных тегов:
+Ты можешь немного повеселиться сейчас и попробовать настроить шаблон по своему вкусу! Вот несколько полезных тегов:
 
-- `<h1>Заголовок</h1>` — главный заголовок страницы;
-- `<h2>Подзаголовок</h2>` — для заголовков второго уровня;
-- `<h3>Заголовок третьего уровня</h3>` … и так далее, вплоть до `<h6>`;
-- `<p>A paragraph of text</p>`
-- `<em>текст</em>` подчёркивает твой текст;
-- `<strong>текст</strong>` — жирный шрифт;
-- `<br />` — переход на следующую строку (внутрь br тега нельзя ничего поместить);
-- `<a href="https://djangogirls.org">link</a>` создаёт ссылку;
-- `<ul><li>первый элемент</li><li>второй элемент</li></ul>` создаёт список, такой же как этот!
-- `<div></div>` определяет раздел страницы.
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>Подзаголовок</h2>` для заголовков второго уровня
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>текст</em>` подчеркивает твой текст
+* `<strong>текст</strong>` - жирный шрифт
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` создает ссылку
+* `<ul><li>первый элемент</li><li>второй элемент</li></ul>` создает список, такой же как этот!
+* `<div></div>` определяет раздел страницы
 
-Вот пример готового шаблона, скопруй его содержимое в файл `blog/templates/blog/post_list.html`:
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <head>
@@ -142,85 +137,77 @@ blog
 </html>
 ```
 
-Мы создали три `div` элемента:
+Мы создали три `div` элемента.
 
-- Первый элемент `div` содержит название блока, которое также является ссылкой.
-- Два других `div` элемента содержат текст записи и дату публикации: `h2` тег с заголовком записи, который также является ссылкой, и два `p` (параграфа) с текстом, один для даты, а другой — для самого текста записи.
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Два других `div` элемента содержат текст записи и дату публикации, `h2` тег с заголовком записи, который также является ссылкой, и два `p` (параграфа) с текстом, один для даты и другой для самого текста записи.
 
 Это даст нам следующий эффект:
 
-![Рисунок 11.4][4]
-
- [4]: images/step6.png
+![Рисунок 11.4](images/step6.png)
 
-Ура! Однако до сих пор наш шаблон отображал лишь __одну и ту же информацию__ — тогда как раньше мы говорили, что шаблоны позволяют нам отображать __различную__ информацию в __одном и том же формате__.
+Ура! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
 
-Что мы действительно хотим, так это отображать существующие записи, добавленные через панель администратора Django; этим и займёмся в следующий раз.
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
 
-## Еще одно: развёртывание!
+## Еще одно: развертывание!
 
-Хотелось бы увидеть всё это в живую в интернете, согласна? Давай проведем еще одно развертывание веб-сайта на PythonAnywhere.
+Хотелось бы увидеть все это в живую в интернете, согласна? Давай проведем еще одно развертывание веб-сайта на PythonAnywhere:
 
 ### Commit и push кода в репозиторий Github
 
-Во-первых, давай посмотрим, какие файлы были изменены с момента последнего развёртывания (выполни эти команды локально, не на PythonAnywhere):
+Во-первых, давай посмотрим, какие файлы были изменены с момента последнего развертывания (выполни эти команды локально, не на PythonAnywhere):
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-```
 
-Убедись, что находишься в директории `djangogirls`, и попроси `git` выбрать все изменения в пределах папки:
+    $ git status
+    
+
+Убедись, что находишься в директории `djangogirls` и сообщи `git` выбрать все изменения в пределах папки:
 
 {% filename %}command-line{% endfilename %}
-```
-$ git add --all .
-```
 
-> **Примечание**: `-all` («всё») означает, что `git` также обратит внимание на удалённые файлы (по умолчанию он отслеживает новые/изменённые файлы). Также помни (из третьей главы), что `.` означает текущую директорию.
+    $ git add --all .
+    
 
-Прежде чем мы загрузим файлы, давай проверим, что именно `git` будет загружать (все файлы, который `git` готов отправить на сервер, отмечаются шрифтом зелёного цвета):
+> **Примечание:** `--all` обозначает то, что `git` также обратит внимание на удаленные файлы (по умолчанию он отслеживает новые/измененные файлы). Также помни (из третьей главы), что `.` означает текущую директорию.
+
+Прежде чем мы загрузим файлы, давай проверим, что именно `git` будет загружать (все файлы, который `git` готов отправить на сервер отмечаются шрифтом зеленого цвета):
 
 {% filename %}command-line{% endfilename %}
-```
-$ git status
-```
 
-Мы почти у цели, пришло время сохранить изменения в истории. К сохраняемой версии мы добавим небольшое сообщение, в котором кратко опишем изменения. Можешь набрать в качестве сообщения всё, что захочешь, однако полезно использовать информативную запись, так будет проще вспомнить внесённые изменения в будущем.
+    $ git status
+    
+
+Мы почти у цели, пришло время сохранить изменения в истории. К сохраняемой версии мы приложим небольшое сообщение, в котором кратко опишем изменения. Можешь набрать в качестве сообщения все что захочешь, однако, полезно выбирать информативную запись, так будет проще вспомнить внесенные изменения в будущем.
 
 {% filename %}command-line{% endfilename %}
-```
-$ git commit -m "Changed the HTML for the site."
-```
 
+    $ git commit -m "Changed the HTML for the site."
+    
 
-> __Примечание__: убедись, что используешь двойные кавычки вокруг комментария.
+> **Примечание**: Убедись что используешь двойные кавычки вокруг комментария.
 
-После того, как мы сделали это, мы загрузим (заpush'им) изменения на Github:
+Once we've done that, we upload (push) our changes up to GitHub:
 
 {% filename %}command-line{% endfilename %}
-```
-$ git push
-```
 
+    $ git push
+    
 
 ### Загружаем новый код на PythonAnywhere и перезапускаем веб-приложение
 
-* Открой вкладку ["терминалы"][5] на PythonAnywhere и переключись на уже запущенную **консоль Bash** (или новую). Затем набери следующую команду:
-
- [5]: https://www.pythonanywhere.com/consoles/
+* Открой вкладку ["терминалы"](https://www.pythonanywhere.com/consoles/) на PythonAnywhere и переключись на уже запущенную **консоль Bash** (или новую). Затем набери следующую команду:
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd ~/my-first-blog
-$ git pull
-[...]
-```
 
-Можешь обратить внимание, как твой код будет загружаться на сервер. Если хочешь проверить успешность процедуры — открой вкладку **Файлы** и просмотри свой код на PythonAnywhere.
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
 
-* Наконец, переключись на вкладку [Web][6] и нажми кнопку **Reload**.
+Можешь обратить внимание как твой код будет загружаться на сервер. Если хочешь проверить успешность процедуры - открой вкладку **Файлы** и просмотри свой код на PythonAnywhere.
 
- [6]: https://www.pythonanywhere.com/web_app_setup/
+* Наконец, переключись на вкладку [Web](https://www.pythonanywhere.com/web_app_setup/) и нажми кнопку **Reload**.
 
-Обновления должны отобразиться на веб-сайте! Переключись на него и обнови страницу. Ты должна сразу заметить улучшения :)
+Обновления должны отобразиться на веб-сайте! Переключись на него и обнови страницу. Ты должна сразу заметить улучшения. :)
\ No newline at end of file
diff --git a/ru/install_git.md b/ru/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ru/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ru/installation/README.md b/ru/installation/README.md
index f58402ce0fb..779fc01f46d 100755
--- a/ru/installation/README.md
+++ b/ru/installation/README.md
@@ -1,16 +1,21 @@
 # Если ты занимаешься дома
 
-Если ты занимаешься по этому руководство дома, а не на одной из [встреч Django Girls](https://djangogirls.org/events/), то можешь пропустить этот раздел и приступить сразу же к главе [Как работает интернет](../how_the_internet_works/README.md).
+Если ты занимаешься по этому руководству дома, а не на одной из [встреч Django Girls](https://djangogirls.org/events/), то можешь пропустить этот раздел и сразу перейти к главе [Как работает интернет](../how_the_internet_works/README.md).
 
-Дело в том, что мы всё равно рассматриваем все эти вещи по ходу руководства, а в этом разделе мы просто собрали все инструкции по установке вместе. Встречи Django Grils включают в себя "вечер настроек", когда мы устанавливаем всё что нужно, чтобы не тратить на это время в течение основного семинара, это очень удобно для нас.
+Дело в том, что мы всё равно рассматриваем все эти вещи по ходу руководства, а в этом разделе мы просто собрали все инструкции по установке вместе. Мы устраиваем "вечер настроек" перед встречей Django Girls. Там мы устанавливаем все, что нам потребуется в работе. Это очень удобно, так мы не тратим время основного семинара.
 
-Если ты также считаешь эту идею удачной, то можешь следовать содержанию главы. Чтобы сразу перейти к изучению нового материала, пропустив установку необходимых программ, просто пропусти эту главу - мы будем объяснять все необходимые вещи по мере продвижения по руководству.
+If you find it useful, you can follow this chapter too. Но если ты хочешь начать обучение до установки программ на компьютер, пропусти эту главу. Мы будем объяснять все про установку по ходу руководства.
 
 Удачи!
 
 # Установка
 
-В процессе мастер-класса мы будем создавать блог и у нас есть несколько подготовительных задач по установке, которые не помешало бы выполнить заранее, чтобы тебе не пришлось отвлекаться от программирования.
+В процессе мастер-класса мы будем создавать блог и у нас есть несколько подготовительных задач по установке, которые было бы неплохо выполнить заранее, чтобы все было готово к работе.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
 
 # Установка Python
 
@@ -38,12 +43,16 @@
 
 # Начинай читать
 
-Поздравляем, всё готово к работе! Если у тебя ещё осталось немного свободного времени до семинара, было бы полезно начать читать одну из первых глав:
+Поздравляем, всё готово к работе! Если у тебя ещё осталось немного свободного времени до семинара, было бы полезно прочитать несколько первых глав:
+
+* [Как работает Интернет](../how_the_internet_works/README.md)
+
+* [Знакомство с командной строкой](../intro_to_command_line/README.md)
 
-  * [Как работает Интернет](../how_the_internet_works/README.md)
+* [Введение в Python](../python_introduction/README.md)
 
-  * [Введение в командную строку](../intro_to_command_line/README.md)
+* [Что такое Django?](../django/README.md)
 
-  * [Введение в Python](../python_introduction/README.md)
+# Наслаждайся семинаром!
 
-  * [Что же представляет из себя Django?](../django/README.md)
+Когда начнется семинар, ты сможешь сразу перейти к главе [Твой первый проект на Django!](../django_start_project/README.md), так как ты уже освоила материал предыдущих глав.
\ No newline at end of file
diff --git a/ru/instructions.md b/ru/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/ru/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ru/intro_to_command_line/README.md b/ru/intro_to_command_line/README.md
index e359abb91ee..c0db14a6fd5 100755
--- a/ru/intro_to_command_line/README.md
+++ b/ru/intro_to_command_line/README.md
@@ -1,113 +1,110 @@
 # Знакомство с командной строкой
 
-> Для проходящих курс дома: эта глава рассмотрена в видео [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
 
-Вот это интересно, да?! Ты напишешь свою первую строку кода всего через несколько минут :)
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
 
-__Позволь представить нашего первого нового друга: командную строку!__
+**Позволь представить нашего первого нового друга: командную строку!**
 
-Следующие шаги покажут, как использовать чёрное окно, которым пользуются все хакеры. В начале оно может показаться немного пугающим, но, на самом деле это просто окно, которое ждет от тебя команды.
+Следующие шаги покажут как использовать черное окно, которым пользуются все хакеры. В начале оно может показаться немного пугающим, но, на самом деле это просто окно, которое ждет от тебя команды.
 
-> **Примечание** Пожалуйста, обрати внимание, что в этой книге мы используем термины «каталог» и «папка» взаимозаменяемо, эти слова обозначают одно и то же.
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
 
 ## Что такое командная строка?
 
-Окно, которое обычно называют __командной строкой__ или __интерфейсом командной строки (англ. CLI, Command Line Interface)__, является текстовым приложением для просмотра, обработки и манипулирования файлами на твоём компьютере. Как Проводник Windows или Finder на Mac, но без графического интерфейса. Другими названиями для командной строки являются: *cmd*, *CLI*, *prompt*, *консоль* или *терминал*.
+Окно, которое обычно называют **командной строкой** или **интерфейсом командной строки (англ. CLI, Command Line Interface)**, является текстовым приложением для просмотра, обработки и манипулирования файлами на вашем компьютере. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Другими названиями для командной строки являются: *cmd*, *CLI*, *prompt*, *консоль* или *терминал*.
 
 ## Открываем интерфейс командной строки
 
 Для того, чтобы начать экспериментировать, нам нужно сначала открыть интерфейс командной строки.
 
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
 
-<!--sec data-title="Windows" data-id="windows_prompt" data-collapse=true ces-->
+Go to Start menu → Windows System → Command Prompt.
 
-Перейди в меню Пуск → Служебные — Windows → Командная строка.
-
-> В старых версиях Windows можешь поискать в меню Пуск → Все программы → Стандартные → Командная строка.
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
 
 <!--endsec-->
 
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
 
-<!--sec data-title="OS X" data-id="OSX_prompt" data-collapse=true ces-->
-
-Приложения → Утилиты → Терминал.
+Go to Applications → Utilities → Terminal.
 
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="linux_prompt" data-collapse=true ces-->
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
 
-Вероятно, командная строка скрывается по адресу: Приложения → Стандартные → Терминал, но это может зависеть от конкретной системы. Если не сможешь найти — Google поможет :)
+Вероятно, командная строка скрывается по адресу: Приложения → Стандартные → Терминал, но это может зависеть от конкретной системы. Если не сможешь найти - Google поможет. :)
 
 <!--endsec-->
 
 ## Командная строка
 
-Теперь ты должна увидеть окно белого или чёрного цвета, которое ожидает команд.
-
-<!--sec data-title="OS X и Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+Теперь ты должна увидеть окно белого или черного цвета, которое ожидает команд.
 
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
 
 Если ты используешь Mac или Linux, то, вероятно, увидишь символ `$`:
 
 {% filename %}command-line{% endfilename %}
-```
-$
-```
-<!--endsec-->
 
+    $
+    
 
-<!--sec data-title="Windows" data-id="windows_prompt2" data-collapse=true ces-->
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
 
 В Windows ты увидишь знак `>`:
 
 {% filename %}command-line{% endfilename %}
-```
->
-```
+
+    >
+    
+
 <!--endsec-->
 
-Каждую команду будет предварять этот знак и один пробел, но тебе не придется их вводить. Компьютер сделает это за нас :)
+Каждую команду будет предварять этот знак и один пробел, но тебе не придется их вводить. Компьютер сделает это за нас. :)
 
-> Небольшое примечание: в твоем случае до знака командной строки может быть что-то вроде `C:\Users\ola >` или `Olas-MacBook-Air:~ ola$`, и это правильно на 100%. В данном руководстве мы просто будем сокращать запись до разумного минимума.
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
 
-Всё, что выводится до твоей команды, включая символ `$` или `>`, называется *приглашением командной строки*. Оно приглашает тебя ввести что-нибудь.
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
 
-В этом руководстве, когда тебе нужно будет ввести какую-либо команду, мы будем предварять её символом `$` или `>`, иногда добавляя что-то слева. Ты можешь пропустить всё, что слева, и просто ввести команду, которая начинается сразу после приглашения командной строки.
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
 
 ## Твоя первая команда (УРА!)
 
-Давай начнем с чего-то простого. Введи следующую команду:
+Let's start by typing this command:
 
-<!--sec data-title="OS X и Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ whoami
-```
 
-<!--endsec-->
+    $ whoami
+    
 
+<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_whoami" data-collapse=true ces-->
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> whoami
-```
+
+    > whoami
+    
 
 <!--endsec-->
 
 И затем нажми `enter`. Вот наш результат:
 
 {% filename %}command-line{% endfilename %}
-```
-$ whoami
-olasitarska
-```
 
-Как видишь, компьютер только что напечатал твоё имя пользователя. Аккуратный, правда? :)
+    $ whoami 
+    olasitarska
+    
 
-> Попробуй набирать каждую команду самостоятельно, а не копировать и вставлять. Так ты запомнишь больше!
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
 
 ## Основы
 
@@ -115,311 +112,318 @@ olasitarska
 
 ### Текущий каталог
 
-Было бы неплохо узнать, где мы находимся сейчас, верно? Давай посмотрим. Введи следующую команду и нажми `enter`:
-
-<!--sec data-title="OS X и Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+Было бы приятно знать, где мы находимся сейчас, верно? Давай посмотрим. Введи следующую команду и нажми `enter`:
 
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ pwd
-/Users/olasitarska
-```
 
-> Примечание: 'pwd' значит 'print working directory' (вывести рабочий каталог).
+    $ pwd
+    /Users/olasitarska
+    
 
-<!--endsec-->
+> Примечание: «pwd» означает «вернуть рабочий каталог» 'print working directory'.
 
+<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_cd" data-collapse=true ces-->
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> cd
-C:\Users\olasitarska
-```
-> Примечание: 'cd' значит 'change directory' (сменить каталог). Если ты используешь powershell, можешь ввести pwd — как на Linux или Mac OS X.
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
 
 <!--endsec-->
 
 Ты, вероятно, увидишь нечто похожее на своем компьютере. Когда ты открываешь командную строку, то обычно находишься в домашнем каталоге текущего пользователя.
 
----
+* * *
 
 ### Список файлов и каталогов
 
-Так что же в нем? Было бы здорово узнать. Давай посмотрим:
+Так что же в нем? Было бы здорово узнать. Давайте посмотрим:
 
-<!--sec data-title="OS X и Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ ls
-Applications
-Desktop
-Downloads
-Music
-...
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_dir" data-collapse=true ces-->
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
 
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> dir
- Directory of C:\Users\olasitarska
-05/08/2014 07:28 PM <DIR>      Applications
-05/08/2014 07:28 PM <DIR>      Desktop
-05/08/2014 07:28 PM <DIR>      Downloads
-05/08/2014 07:28 PM <DIR>      Music
-...
-```
-> Примечание: В powershell ты можешь использовать 'ls', как в Linux и Mac OS X.
-<!--endsec-->
 
----
+    > dir
+      Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR> Applications
+    05/08/2014 07:28 PM <DIR> Desktop
+    05/08/2014 07:28 PM <DIR> Downloads
+    05/08/2014 07:28 PM <DIR> Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
 
 ### Смена текущего каталога
 
-Теперь вернёмся в наш каталог рабочего стола:
+Теперь вернемся в наш каталог рабочего стола:
 
-<!--sec data-title="OS X и Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd Desktop
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_move_to" data-collapse=true ces-->
+    $ cd Desktop
+    
+
+<!--endsec-->
 
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> cd Desktop
-```
+
+    > cd Desktop
+    
+
 <!--endsec-->
 
 Проверь, что рабочий каталог действительно изменился:
 
-<!--sec data-title="OS X и Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ pwd
-/Users/olasitarska/Desktop
-```
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
 <!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_cd2" data-collapse=true ces-->
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> cd
-C:\Users\olasitarska\Desktop
-```
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
 <!--endsec-->
 
 Вот и он!
 
-> Совет от профи: если ты введешь `cd D` и затем нажмешь `Tab` на клавиатуре, в командной строке будет автоматически набрана остальная часть имени, что позволит быстрее перемещаться по каталогам. Если c «D» начинается название не одной папки, нажми `Tab` дважды, чтобы получить список вариантов.
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
 
----
+* * *
 
 ### Создание каталога
 
-Как насчет создания каталога practice на рабочем столе? Ты можешь сделать это таким образом:
+Как насчет создания каталога practice на рабочем столе? Вы можете сделать это таким образом:
 
-<!--sec data-title="OS X и Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ mkdir practice
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_mkdir" data-collapse=true ces-->
+    $ mkdir practice
+    
+
+<!--endsec-->
 
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> mkdir practice
-```
+
+    > mkdir practice
+    
+
 <!--endsec-->
 
-Эта маленькая команда создаст папку с именем `practice` на рабочем столе. Ты можешь проверить, появилась ли она, просто взглянув на рабочий стол или введя команду `ls` (для Linux и macOS) или `dir` (если у тебя Windows)! Попробуй :)
+Эта маленькая команда создаст папку с именем `practice` на рабочем столе. Ты можешь проверить, появилась ли она, просто взглянув на рабочий стол или введя команду `ls` / `dir`! Попробуй. :)
 
-> Совет от профи: если ты не хочешь вводить одни и те же команды снова и снова, попробуй нажать на `стрелку вверх` и `стрелку вниз` на клавиатуре для просмотра недавно использованных команд.
+> ПРО совет: Если ты не хочешь вводить одни и те же команды снова и снова, попробуйте нажать на `стрелку вверх` и `стрелку вниз` на клавиатуре, чтобы просмотреть недавно использованные команды.
 
----
+* * *
 
 ### Тренируемся!
 
-Небольшая задачка: в недавно созданной папке `practice` создай папку с названием `test`. Используй команды `cd` и `mkdir`.
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
 
 #### Решение:
 
-<!--sec data-title="OS X и Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd practice
-$ mkdir test
-$ ls
-test
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_test_dir" data-collapse=true ces-->
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
 
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> cd practice
-> mkdir test
-> dir
-05/08/2014 07:28 PM <DIR>      test
-```
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
 <!--endsec-->
 
 Поздравляем! :)
 
----
+* * *
 
 ### Чистка
 
-Мы не хотим оставлять беспорядок, поэтому давай удалим всё, что мы создали до этого момента.
+Мы не хотим оставлять беспорядок, поэтому давай удалим все, что мы создали до этого момента.
 
 Во-первых, мы должны вернуться на рабочий стол:
 
-<!--sec data-title="OS X и Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd ..
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_back" data-collapse=true ces-->
+    $ cd ..
+    
 
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> cd ..
-```
+
+    > cd..
+    
+
 <!--endsec-->
 
-Используя `..` с командой `cd`, ты можешь сменить текущий каталог на родительский (то есть каталог, содержащий в себе текущий).
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
 
 Проверь, где ты находишься:
 
-<!--sec data-title="OS X и Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ pwd
-/Users/olasitarska/Desktop
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_cd3" data-collapse=true ces-->
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
 
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> cd
-C:\Users\olasitarska\Desktop
-```
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
 <!--endsec-->
 
 Пришло время удалить каталог `practice`:
 
-> __Внимание__: удаление файлов с помощью `del`, `rmdir` или `rm` необратимо, это означает, что _удалённые файлы будут потеряны навсегда_! Поэтому будь очень осторожна с этими командами.
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
 
-<!--sec data-title="Windows Powershell, OS X и Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ rm -r practice
-```
-<!--endsec-->
 
-<!--sec data-title="Командная строка Windows" data-id="windows_rmdir" data-collapse=true ces-->
+    $ rm -r practice
+    
 
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> rmdir /S practice
-practice, Are you sure <Y/N>? Y
-```
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
 <!--endsec-->
 
 Готово! Давай проверим, что папка действительно удалена:
 
-<!--sec data-title="OS X и Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ ls
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_dir2" data-collapse=true ces-->
+    $ ls
+    
+
+<!--endsec-->
 
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> dir
-```
+
+    > dir
+    
+
 <!--endsec-->
 
 ### Выход
 
-Вот и все на данный момент! Теперь можно безопасно закрыть командную строку. Давай сделаем это как хакеры, согласна? :)
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
 
-<!--sec data-title="OS X и Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-$ exit
-```
-<!--endsec-->
 
-<!--sec data-title="Windows" data-id="windows_exit" data-collapse=true ces-->
+    $ exit
+    
+
+<!--endsec-->
 
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
 
 {% filename %}command-line{% endfilename %}
-```
-> exit
-```
+
+    > exit
+    
+
 <!--endsec-->
 
-Круто, да?:)
+Круто, да? :)
 
-## Подведём итоги
+## Содержание
 
 Вот краткий обзор некоторых полезных команд:
 
-Команда (Windows) | Команда (Mac OS / Linux) | Описание                | Пример
------------------ | ------------------------ | ----------------------- | ---------------------------------------------
-exit              | exit                     | Закрыть окно            | **exit**
-cd                | cd                       | изменить каталог        | **cd test**
-cd                | pwd                      | вывести текущий каталог | **cd** (Windows) или **pwd** (Mac OS / Linux)
-dir               | ls                       | список каталогов/файлов | **dir**
-copy              | cp                       | копировать файл         | **copy c:\test\test.txt c:\windows\test.txt**
-move              | mv                       | переместить файл        | **move c:\test\test.txt c:\windows\test.txt**
-mkdir             | mkdir                    | создать новый каталог   | **mkdir testdirectory**
-rmdir (или del)   | rm                       | удалить файл            | **del c:\test\test.txt**
-rmdir /S          | rm -r                    | удалить каталог         | **rm -r testdirectory**
+| Команда (Windows) | Команда (Mac OS / Linux) | Описание                   | Пример                                            |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| выход             | выход                    | Закрыть окно               | **выход**                                         |
+| cd                | cd                       | изменить каталог           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | список каталогов/файлов    | **dir**                                           |
+| copy              | cp                       | копировать файл            | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | переместить файл           | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | создать новый каталог      | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
 
 Это лишь некоторые из команд, которые можно использовать в командной строке, но сегодня тебе больше и не пригодится.
 
-Если тебе интересно, [ss64.com][1] содержит полный справочник команд для всех операционных систем.
-
- [1]: http://ss64.com
+Если тебе интересно, [ss64.com](http://ss64.com) содержит полный справочник команд для всех операционных систем.
 
-## Готова продолжить?
+## Готова?
 
-Давай погрузимся в мир Python!
+Давай погрузимся в мир Python!
\ No newline at end of file
diff --git a/ru/python_installation/README.md b/ru/python_installation/README.md
index 5e055e87ad2..f444584c48d 100755
--- a/ru/python_installation/README.md
+++ b/ru/python_installation/README.md
@@ -1,13 +1,15 @@
 # Давай начнем работать с Python
 
-Мы наконец-то здесь!
+Мы, наконец-то, здесь!
 
-Но сначала позволь рассказать, что такое Python. Python — это очень популярный язык программирования, который может использоваться для создания веб-сайтов, игр, научного программного обеспечения, графики и многого, многого другого.
+Для начала, позволь рассказать что такое Python. Python - это очень популярный язык программирования, который может использоваться для создания веб-сайтов, игр, научного программного обеспечения, графики и многого, многого другого.
 
-Python возник в конце 80-х годов, и его основная цель — быть понятным для людей (а не только машин!). Именно поэтому он выглядит намного проще, чем другие языки программирования. Это делает его простым для изучения, но не волнуйся, Python кроме этого еще и очень мощный язык!
+Python возник в конце 80-х годов, и его основной целью является быть удобным для чтения людьми (не только машинами!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
 
 # Установка Python
 
- **Примечание:** если ты уже прошла шаги установки, не нужно делать это снова — можешь переходить прямо к следующей главе!
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
 
-{% include "/python_installation/instructions.md" %}
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ru/python_installation/instructions.md b/ru/python_installation/instructions.md
index 687e9faaada..185ed1f7323 100755
--- a/ru/python_installation/instructions.md
+++ b/ru/python_installation/instructions.md
@@ -1,108 +1,106 @@
-> Для проходящих руководство дома: эта глава рассмотрена в видео [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
 
-> Этот подраздел основан на руководстве Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
 
-Django написан на Python. Нам нужен Python, чтобы сделать что-нибудь в Django. Давай начнем с его установки! Мы хотим, чтобы ты установила Python 3.6, поэтому, если у тебя уже есть более ранняя версия, то её придется обновить.
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
 
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
 
-<!--sec data-title="Windows" data-id="python_windows" data-collapse=true ces-->
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
 
-Для начала проверь, какая версия Windows у тебя установлена — 32-битная или 64-битная. Для этого нажми Windows + Pause/Break, чтобы открыть окно «Сведения о системе», и посмотри, что написано в строке «Тип системы». Ты можешь загрузить Python для Windows с официального веб-сайта: https://www.python.org/downloads/windows/. Перейди по ссылке «Latest Python 3 Release - Python x.x.x». Если у тебя установлена **64-битная** версия Windows, скачай **Windows x86-64 executable installer**. Если нет — скачай **Windows x86 executable installer**.  После загрузки дистрибутива ты должна запустить его (двойной щелчок) и следовать инструкциям. Важно запомнить путь (каталог), куда ты установила Python. Это понадобится позже!
+![Не забудьте добавить Python в системную переменную Path](../python_installation/images/python-installation-options.png)
 
-Обрати внимание на второй экран мастера установки, который называется «Customize» (Настройка): тебе нужно пролистать его вниз и выбрать опцию «Add Python 3.6 to the PATH» (Добавить Python 3.6 к системной переменной PATH), как на рисунке:
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
 
-![Не забудь добавить Python в системную переменную Path](../python_installation/images/python-installation-options.png)
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
 
-Чуть дальше тебе понадобится командная строка Windows (о которой мы расскажем отдельно). Пока что, если тебе нужно ввести какую-нибудь команду, перейди в меню Пуск → Служебные — Windows → Командная строка. Или ты можешь зажать кнопку Windows и нажать кнопку «R», чтобы появился диалог «Выполнить». Для запуска командной строки введи «cmd» и нажми enter. (В новых версиях Windows тебе, возможно, придётся воспользоваться поиском — «Командная строка» иногда скрыта).
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
 
-![Введи "cmd" в окне "Выполнить"](../python_installation/images/windows-plus-r.png)
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
 
-Примечание: если ты используешь старую версию Windows (7, Vista или ещё более старую версию) и установка Python 3.6.x завершается выводом сообщения об ошибке, ты можешь попробовать:
-1. либо установить все доступные обновления Windows и попробовать установить Python 3.6 заново;
-2. либо установить [более раннюю версию Python](https://www.python.org/downloads/windows/), например, [3.4.6](https://www.python.org/downloads/release/python-346/).
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
 
-Если тебе пришлось установить раннюю версию Python, экран установки можешь выглядеть чуть иначе. Не забудь прокрутить окно до строки «Add python.exe to Path», затем нажми кнопку слева от неё и выбери пункт «Will be installed on local hard drive»:
-
-![Добавление Python в переменную Path, ранние версии](../python_installation/images/add_python_to_windows_path.png)
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
 
 <!--endsec-->
 
-<!--sec data-title="OS X" data-id="python_OSX"
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
 data-collapse=true ces-->
 
-> **Примечание:** перед установкой Python в OS X тебе нужно проверить, что в настройках твоего Mac разрешено устанавливать пакеты, загруженные не из App Store. Перейди в Системный настройки (в папке «Программы»), нажми «Защита и безопасность» и выбери вкладку «Общие». Если в разделе «Разрешать загрузки из:» выбран вариант «App Store для Mac», смени его на «App Store для Mac и от установленных разработчиков».
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
 
-Тебе нужно перейти по ссылке https://www.python.org/downloads/release/python-361/ и скачать дистрибутив Python:
+Тебе нужно перейти по ссылки https://www.python.org/downloads/release/python-361/ и скачать дистрибутив Python:
 
-  * Скачай файл *Mac OS X 64-bit/32-bit installer*,
-  * Сделай двойной щелчок на *python-3.4.3-macosx10.6.pkg* для запуска установщика.
+* Скачай файл *Mac OS X 64-bit/32-bit installer*,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
 
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="python_linux"
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
 data-collapse=true ces-->
 
 Вполне вероятно, что у тебя уже установлен Python. Чтобы проверить это (а также версию языка), открой консоль и введи следующую команду:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 --version
-Python 3.6.1
-```
 
-Если Python не установлен или ты хочешь использовать другую версию языка, то можешь установить его следующим образом:
+    $ python3 --version
+    Python 3.6.1
+    
 
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. Если Python не установлен, или ты хочешь использовать другую версию языка, то можешь установить его следующим образом:
 
 <!--endsec-->
 
-<!--sec data-title="Debian или Ubuntu" data-id="python_debian"
-data-collapse=true ces-->
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
 
 Введи эту команду в консоль:
 
 {% filename %}command-line{% endfilename %}
-```
-$ sudo apt-get install python3.6
-```
+
+    $ sudo apt-get install python3.6
+    
 
 <!--endsec-->
 
-<!--sec data-title="Fedora" data-id="python_fedora"
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
 data-collapse=true ces-->
 
 Используй следующую команду в консоли:
 
 {% filename %}command-line{% endfilename %}
-```
-$ sudo dnf install python3
-```
 
-Если у тебя старая версия Fedora, то ты можешь получить ошибку «command dfn is not found». В этом случае используй yum.
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
 
 <!--endsec-->
 
-<!--sec data-title="openSUSE" data-id="python_openSUSE"
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
 data-collapse=true ces-->
 
 Используй следующую команду в консоли:
 
 {% filename %}command-line{% endfilename %}
-```
-$ sudo zypper install python3
-```
+
+    $ sudo zypper install python3
+    
 
 <!--endsec-->
 
-Убедись, что установка прошла успешно, открыв приложение *Терминал* и запустив команду `python3`:
+Verify the installation was successful by opening a command prompt and running the `python3` command:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 --version
-Python 3.6.1
-```
 
-**ПРИМЕЧАНИЕ:** если ты используешь Windows и получила ошибку с сообщением, что `python3` не найден, попробуй ввести `python` (без `3`) и проверь, будет ли это версия Python 3.6.
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
 
-----
+* * *
 
-Если у тебя остались какие-либо сомнения или что-то пошло не так и ты понятия не имеешь, что делать дальше, — спроси своего тренера! Иногда дела идут не совсем гладко, поэтому лучше попросить помощи у кого-то с большим опытом.
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Иногда дела идут не совсем гладко, поэтому лучше попросить помощи у кого-то с большим опытом.
\ No newline at end of file
diff --git a/ru/python_introduction/README.md b/ru/python_introduction/README.md
index 4d9c69a8339..9b00e3e43a4 100755
--- a/ru/python_introduction/README.md
+++ b/ru/python_introduction/README.md
@@ -1,75 +1,76 @@
 # Введение в Python
 
-> Часть этой главы основана на учебных пособиях Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 
 Давай напишем немного кода!
 
 ## Консоль Python
 
-> Для проходящих руководство дома: этот раздел рассмотрен в видео [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U).
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
 
-Чтобы начать играть с Python, нам нужно открыть *командную строку* на твоём компьютере. Ты уже должна знать, как это сделать — мы изучали это в главе [Введение в интерфейс командой строки][1].
+Чтобы начать играть с Python, нам нужно открыть *командную строку* на твоем компьютере. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
 
- [1]: ../intro_to_command_line/README.md
+После того, как будешь готова, следуйте приведенным ниже инструкциям.
 
-Когда будешь готова, следуй приведенным ниже инструкциям.
-
-Мы хотим открыть консоль Python, так что набери `python`, если работаешь в Windows, или `python3` для Mac OS/Linux, и нажми `enter`.
+Мы хотим открыть консоль Python, так что набери `python` если работаешь в Windows, или `python3` для Mac OS/Linux, и нажми `enter`.
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3
-Python 3.6.1 (...)
-Type "help", "copyright", "credits" or "license" for more information.
->>>
-```
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
 
 ## Твоя первая команда Python!
 
-После запуска Python командная строка изменилась на `>>>`. Для нас это означает, что сейчас мы можем использовать только команды на языке Python. Тебе не нужно вводить `>>>` — Python будет делать это за нас.
+После запуска Python, консоль изменилась на `>>>`. Для нас это означает, что сейчас мы можем использовать только команды на языке Python. You don't have to type in `>>>` – Python will do that for you.
 
-Если ты хочешь выйти из консоли Python, в любой момент — просто введи `exit()` или используй сочетание клавиш `Ctrl + Z` для Windows и `Ctrl + D` для Mac/Linux. Тогда ты больше не будешь видеть `>>>`.
+Если ты хочешь выйти из консоли Python, в любой момент -- просто введи `exit()` или используй сочетание клавиш `Ctrl + Z` для Windows и `Ctrl + D` для Mac/Linux. Тогда ты больше не будешь видеть `>>>`.
 
-Пока что мы не хотим выходить из консоли Python. Мы хотим узнать больше о ней. Давай начнём с чего-нибудь совсем простого. Например, попробуй набрать простое математическое выражение, вроде `2 + 3`, и нажми `enter`.
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 2 + 3
 5
 ```
 
-Прекрасно! Видишь, как выскочил ответ? Python знает математику! Ты можешь попробовать другие команды, например:
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
 
 - `4 * 5`
 - `5 - 1`
 - `40 / 2`
 
-Чтобы вычислить степень числа, например, 2 в кубе, мы вводим:
-{% filename %}command-line{% endfilename %}
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 2 ** 3
 8
 ```
 
-Поиграй с этим немного и затем вернись сюда :).
+Поиграй с этим немного и затем вернись сюда. :)
 
-Как видишь, Python является прекрасным калькулятором. Если тебе интересно, что ещё можно сделать...
+As you can see, Python is a great calculator. If you're wondering what else you can do…
 
 ## Строки
 
-Как насчет твоего имени? Введи своё имя в кавычках, вот так:
+Как насчет твоего имени? Введи свое имя в кавычках, вот так:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Ola"
 'Ola'
 ```
 
-Ты только что создала свою первую строку! Это последовательность символов, которые могут быть обработаны компьютером. Строка должна всегда начинаться и заканчиваться одинаковым символом. Им может быть одинарная (`'`) или двойная (`"`) кавычка (разницы нет!) Кавычки говорят Python'у, что внутри них находится строка.
+Сейчас ты создала свою первую строку! Это последовательность символов, которые могут быть обработаны компьютером. Строка должна всегда начинаться и заканчиваться одинаковым символом. Им может быть одинарная (`'`) или двойная (`"`) кавычка (разницы нет!) Кавычки говорят Python'у, что внутри них находится строка.
 
 Строки могут быть слиты воедино. Попробуй так:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Hi there " + "Ola"
 'Hi there Ola'
@@ -78,6 +79,7 @@ Type "help", "copyright", "credits" or "license" for more information.
 Ты также можешь умножать строки на число:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Ola" * 3
 'OlaOlaOla'
@@ -85,17 +87,19 @@ Type "help", "copyright", "credits" or "license" for more information.
 
 Если тебе нужно поставить апостроф внутри строки, то есть два способа сделать это.
 
-Используй двойные кавычки:
+Использование двойных кавычек:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Runnin' down the hill"
 "Runnin' down the hill"
 ```
 
-или поставь перед апострофом обратную косую черту (`\`):
+или предварение апострофа обратной косой чертой (``):
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 'Runnin\' down the hill'
 "Runnin' down the hill"
@@ -104,31 +108,33 @@ Type "help", "copyright", "credits" or "license" for more information.
 Прикольно, да? Чтобы увидеть своё имя прописными буквами, просто набери:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> "Ola".upper()
 'OLA'
 ```
 
-Ты только что использовала __метод__ `upper` своей строки! Метод (такой как `upper()`) представляет собой набор инструкций, который должен выполнить Python над заданным объектом (в нашем случае: `"Ola"`) при его вызове.
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
 
-Если ты хочешь узнать количество букв в своём имени, то и для этого тоже существует функция!
+If you want to know the number of letters contained in your name, there is a **function** for that too!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> len("Ola")
 3
 ```
 
-Интересно, почему иногда мы вызываем функцию добавлением `.` к концу строки (как `"Ola".upper()`), а иногда сначала пишем имя функции и затем помещаем строку в скобки? Ну, в некоторых случаях функции принадлежат объектам, например, функция `upper()`, которая может быть применена только к строкам. В этом случае мы называем функцию __методом__. В другом случае функции не относятся к чему-то конкретному и могут использоваться для различных типов объектов, например, функция `len()`. Вот почему мы передаем `"Ola"` в качестве параметра функции `len`.
+Интересно, почему иногда мы вызываем функцию добавлением `.` к концу строки (как `"Ola".upper()`), а иногда сначала пишем имя функции и затем помещаем строку в скобки? Ну, в некоторых случаях функции принадлежат объектам, например функция `upper()`, которая может быть применена только к строкам. В этом случае мы называем функцию **методом**. В другом случае функции не относятся к чему-то конкретному и могут использоваться для различных типов объектов, например функция `len()`. Вот почему мы передаем `"Ola"` в качестве параметра функции `len`.
 
-### Подведём итог
+### Содержание
 
-Хорошо, достаточно о строках. Пока ты узнала следующее:
+OK, достаточно о строках. Пока ты узнала о:
 
-*   __командная строка__ — ввод команд (кода) в интерактивную командную строку Python приводит к ответам на Python;
-*   __числа и строки__ — в Python числа используются для вычислений, а строки - для текстовых объектов;
-*   __операторы__, такие как + и *, объединяют значения для получения нового;
-*   __функции__, такие как upper() и len(), выполняют действия над объектами.
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
 
 Таковы основы каждого языка программирования, который ты можешь выучить. Готова к чему-то посложнее? Мы уверены, что готова!
 
@@ -137,69 +143,75 @@ Type "help", "copyright", "credits" or "license" for more information.
 Давай попробуем кое-что новенькое. Можем ли мы получить длину числа так же, как длину твоего имени? Введи `len(304023)` и нажми `Enter`:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(304023)
 Traceback (most recent call last):
-  File "<stdin>", line 1, in <module>
+File "<stdin>", line 1, in <module>
 TypeError: object of type 'int' has no len()
 ```
 
-Мы получили нашу первую ошибку! Она говорит о том, что у объектов типа «int» (целые числа) нет длины. Так что же мы можем сейчас сделать? Может быть, мы можем написать наше число в виде строки? У строк ведь есть длина, верно?
+Мы получили нашу первую ошибку! Она говорит о том, что у объектов типа «int» (целые числа) нет длины. Так что же мы можем сейчас сделать? Может быть мы можем написать наше число в виде строки? У строк ведь есть длина, верно?
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(str(304023))
 6
 ```
 
-Сработало! Мы использовали функцию `str` внутри функции `len`. `str()` преобразует всё в строки.
+Сработало! Мы использовали функцию `str` внутри функции `len`. `str()` преобразует все в строки.
 
--   Функция `str` преобразует объекты в __строки__
--   Функция `int` преобразует объекты в __целые числа__
+- Функция `str` преобразует объекты в **строки**
+- Функция `int` преобразует объекты в **целые числа**
 
-> Важно: мы можем преобразовать число в текст, но не всегда удается преобразовать текст в числа — например, каков будет результат `int('hello')`?
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
 
 ## Переменные
 
-Переменные — важное понятие в программировании. Переменная — это всего лишь имя для чего-то, чтобы использовать его позднее. Программисты используют переменные для хранения данных, чтобы их код был более читабельным, и для того, чтобы им не пришлось запоминать что есть что.
+Переменные -- важное понятие в программировании. Переменная -- это не более чем имя для чего-то, чтобы использовать его позднее. Программисты используют переменные для хранения данных, чтобы их код был более читабельным, и для того, чтобы им не пришлось запоминать что есть что.
 
 Допустим, мы хотим создать новую переменную с именем `name`:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> name = "Ola"
 ```
 
-Видишь? Это очень легко! Просто введи: name равно Ola.
+We type name equals Ola.
 
 Как ты уже заметила, твоя программа не возвращает ничего, как было ранее. Так откуда мы знаем, что переменная действительно существует? Просто введи `name` и нажми `Enter`:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> name
 'Ola'
 ```
 
-Ура! Твоя первая переменная:)! Ты всегда можешь изменить то, к чему она относится:
+Yippee! Your first variable! :) You can always change what it refers to:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> name = "Sonja"
 >>> name
-'Sonja'
 ```
 
-Ты также можешь использовать переменные и в функциях:
+Ты можешь использовать их также и в функциях:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(name)
 5
 ```
 
-Круто, правда? Переменными, конечно, может быть что угодно, и цифры тоже! Попробуй следующее:
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> a = 4
 >>> b = 6
@@ -210,6 +222,7 @@ TypeError: object of type 'int' has no len()
 Но что делать, если мы использовали неправильное имя? Можешь догадаться, что произойдет? Давай попробуем!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> city = "Tokyo"
 >>> ctiy
@@ -227,6 +240,7 @@ NameError: name 'ctiy' is not defined
 Попробуй ввести:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> name = 'Maria'
 >>> name
@@ -237,15 +251,16 @@ Maria
 
 Если просто ввести `name`, интерпретатор Python вернет строковое *представление* переменной 'name', которым, в нашем случае, являются буквы M-a-r-i-a, окруженные одинарными кавычками, ''. Когда ты вводишь `print(name)`, Python "печатает" содержание переменной на экран, без кавычек, что удобнее.
 
-Как мы увидим позднее, `print()` пригодится, когда нам будет нужно печатать что-то изнутри функций или когда мы захотим напечатать что-то на нескольких строчках.
+Как мы увидим позднее, `print()` пригодится когда нам будет нужно печатать что-то изнутри функций или когда мы захотим напечатать что-то на нескольких строчках.
 
 ## Списки
 
-Помимо строк и целых чисел Python имеет богатую коллекцию других типов объектов. Сейчас мы собираемся представить тебе один из них — **list** (список). Списки — это именно то, о чём ты подумала: объекты, которые являются списками других объектов :)
+Помимо строк и целых чисел Python имеет богатую коллекцию других типов объектов. Сейчас мы собираемся представить тебе один из них - **list** (список). Списки - это именно то, о чем ты подумала: объекты, которые являются списками других объектов. :)
 
 Давай начнем с создания списка:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> []
 []
@@ -254,28 +269,32 @@ Maria
 Отлично, это пустой список. Не особенно полезен, да? Давай создадим список лотерейных номеров. Мы не хотим повторять их каждый раз, так что присвоим список переменной:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery = [3, 42, 12, 19, 30, 59]
 ```
 
-Замечательно, у нас есть список! Что мы можем с ним сделать? Для начала посмотрим, как много лотерейных номеров в нашем списке. Есть идеи, какую функцию можно использовать для этого? Ты её уже знаешь!
+Замечательно, у нас есть список! Что мы можем с ним сделать? Для начала посмотрим как много лотерейных номеров в нашем списке. Есть идеи какую функцию можно использовать для этого? Ты её уже знаешь!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(lottery)
 6
 ```
 
-Точно! `len()` вернет тебе количество объектов в списке. Удобно, правда? Пожалуй, мы теперь отсортируем его:
+Точно! `len()` вернет тебе количество объектов в списке. Удобно, правда? Может быть мы теперь отсортируем его:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery.sort()
 ```
 
-Эта команда не возвращает ничего, она просто меняет порядок номеров в списке. Давайте выведем его на экран и посмотрим, что получилось:
+Эта команда не возвращает ничего, она просто меняет порядок номеров в списке. Давайте выведем его на экран и посмотрим что получилось:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(lottery)
 [3, 12, 19, 30, 42, 59]
@@ -283,27 +302,30 @@ Maria
 
 Как видишь, номера в списке теперь отсортированы от меньшего к большему. Поздравляем!
 
-Может, нам нужно обратить порядок? Давай сделаем это!
+Может быть нам нужно изменить порядок? Давай сделаем это!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery.reverse()
 >>> print(lottery)
 [59, 42, 30, 19, 12, 3]
 ```
 
-Просто, правда? Если хочешь добавить что-то к своему списку, то можешь воспользоваться этой командой:
+If you want to add something to your list, you can do this by typing this command:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> lottery.append(199)
 >>> print(lottery)
 [59, 42, 30, 19, 12, 3, 199]
 ```
 
-Если ты хочешь получить только первый номер в списке, то можешь воспользоваться **индексами**. Индекс — это номер позиции в списке, на котором находится нужное нам значение. Программисты предпочитают начать считать с 0, так что первому объекту в списке соответствует индекс 0, следующему —1, и так далее. Попробуй ввести:
+Если ты хочешь получить первый номер в списке, то можешь воспользоваться **индексами**. Индекс это номер позиции в списке, на котором находится нужное нам значение. Программисты предпочитают начать считать с 0, так что первому объекту в списке соответствует индекс 0, следующему —1, и так далее. Попробуй ввести:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(lottery[0])
 59
@@ -313,9 +335,10 @@ Maria
 
 Как видишь, ты можешь обратиться к различным объектам в своем списке используя имя списка и индекс объекта в квадратных скобках.
 
-Чтобы удалить что-либо из списка, тебе понадобятся **индексы**, с которыми мы уже разобрались выше, и команда `pop()`. Давай попробуем закрепить пройденное на примере: мы будем удалять первый элемент из нашего списка.
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(lottery)
 [59, 42, 30, 19, 12, 3, 199]
@@ -329,50 +352,54 @@ Maria
 
 Сработало как заклинание!
 
-В качестве дополнительной тренировки попробуй следующие индексы: 6, 7, 1000, -1, -6 и -1000. Можешь предсказать результат? Видишь логику работы?
+В качестве дополнительной тренировки попробуй следующие индексы: 6, 7, 1000, -1, -6 и -1000. Сможешь предсказать результат? Видишь логику работы?
 
 Ты можешь найти перечень всех методов, относящихся к списку, в этой главе официальной документации Python: https://docs.python.org/3/tutorial/datastructures.html
 
 ## Словари
 
-> Для проходящих руководство дома: этот раздел рассмотрен в видео [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
 
-Словари схожи со списками, но ты обращаешься к значениям словаря по ключу, а не по индексу. Ключом может быть любая строка или число. Давай создадим пустой словарь:
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> {}
 {}
 ```
 
-Это показывает, что мы создали пустой словарь. Ура!
+Это показывает что мы создали пустой словарь. Ура!
 
-Теперь попробуй следующую команду (можешь заменить значения на своё имя, страну и т.д.):
+Now, try writing the following command (try substituting your own information, too):
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
 ```
 
-Этой командой ты создала переменную `participant` с тремя парами ключ/значение:
+With this command, you just created a variable named `participant` with three key–value pairs:
 
--   ключ `name`, указывающий на значение `'Ola'` (объект типа `строка`),
--   ключ `country`, указывающий на значение `'Poland'` (еще одна `строка`),
--   и ключ `favorite_numbers`, указывающий на значение `[7, 42, 92]` (объект типа `список` с тремя числами внутри).
+- Ключ `name`, указывающий на значение `'Ola'` (`строковый` объект),
+- ключ `country`, указывающий на значение `'Poland'` (еще одна `строка`),
+- и ключ `favorite_numbers`, указывающий на значение `[7, 42, 92]` (объект типа `список` с тремя числами внутри).
 
 Значение конкретного ключа можно узнать следующим образом:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> print(participant['name'])
 Ola
 ```
 
-Видишь, синтаксис похож на работу со списком. Но вместо того, чтобы запоминать индекс, тебе нужно помнить ключ.
+See, it's similar to a list. But you don't need to remember the index – just the name.
 
 Что случится, если мы спросим у Python значение несуществующего в словаре ключа? Можешь предположить? Давай попробуем и узнаем наверняка!
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> participant['age']
 Traceback (most recent call last):
@@ -380,33 +407,36 @@ Traceback (most recent call last):
 KeyError: 'age'
 ```
 
-Смотри, другая ошибка! Эта называется **KeyError**. Python услужливо напоминает, что ключа `'age'` нет в словаре.
+Смотри, другая ошибка! Эта называется **KeyError**. Python услужливо напоминает, что ключа `'age'` не существует в словаре.
 
 Когда стоит использовать словарь, а когда список? Это хороший вопрос для самостоятельного размышления. Сделай предположение перед тем, как читать дальше.
 
--   Тебе нужна упорядоченная последовательность элементов? Список — наш выбор.
--   Тебе нужны сочетания ключ/значение, чтобы быстро искать значения (по ключу) в дальнейшем? Словарь отлично подойдет.
+- Тебе нужна упорядоченная последовательность элементов? Список - наш выбор.
+- Тебе нужны сочетания ключ - значение, чтобы быстро искать значения (по ключу) в дальнейшем? Словарь отлично подойдет.
 
-Словари, как и списки, *изменяемы*, т. е. они могут быть изменены после того как были созданы. Ты можешь добавить новые пары ключ/значение в словарь следующим образом:
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> participant['favorite_language'] = 'Python'
 ```
 
-Так же как в примере со списками, использование функции `len()` вернёт число пар ключ/значение в словаре. Попробуй сама:
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> len(participant)
 4
 ```
 
-Надеюсь, всё вышеизложенное понятно. :) Готова к новым приключениям со словарями? На следующей строке тебя ждут изумительные вещи.
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
 
-Ты можешь использовать команду `pop()` для удаления элементов из словаря. Скажем, ты хочешь удалить элемент с ключом `'favorite_numbers'`. Просто набери следующую команду:
+You can use the `pop()` method to delete an item in the dictionary. Скажем, ты хочешь удалить элемент с ключом `'favorite_numbers'`, просто набери следующую команду:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> participant.pop('favorite_numbers')
 [7, 42, 92]
@@ -414,38 +444,39 @@ KeyError: 'age'
 {'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
 ```
 
-Как видишь, пара ключ/значение с ключом 'favorite_numbers' была удалена.
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
 
-Помимо этого, ты можешь заменить значение, связанное с уже существующим ключом. Набери:
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> participant['country'] = 'Germany'
 >>> participant
 {'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
 ```
 
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
 
-Значение, на которое ссылается ключ `'country'`, изменилось с `'Poland'` на `'Germany'`. :) Захватывает? Ещё бы! Ты выучила еще одну потрясающую штуку!
-
-### Подведём итог
+### Содержание
 
 Шикарно! Теперь ты знаешь немало о программировании. Мы познакомились с:
 
-*   __ошибками__ — теперь ты знаешь как читать и анализировать ошибки, которые возникают, если Python не понимает твоей команды;
-*   __переменными__ — именами для объектов, которые упрощают твой код и делают его более читабельным;
-*   __списками__ — последовательностями объектов в заданном порядке;
-*   __словарями__ — объектами, хранящими пары ключ/значение.
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
 
 Готова к продолжению? :)
 
-## Сравнение вещей
+## Сравниваем вещи
 
-> Для проходящих руководство дома: этот раздел рассмотрен в видео [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4).
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
 
-Немалая часть программирования требует сравнения вещей. Что проще всего сравнить друг с другом? Числа, конечно. Давай посмотрим, как это работает:
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 5 > 2
 True
@@ -459,13 +490,14 @@ True
 True
 ```
 
-Мы передали Python несколько чисел для сравнения. Как ты можешь заметить, Python сравнивает не только числа, но и результаты методов (например, умножения). Неплохо, правда?
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
 
-Хочешь спросить, почему мы написал двойной символ равенства `==`, чтобы проверить, одинаковы ли числа? Потому что одинарные символ равенства `=` уже задействован под присваивание значения переменным. Ты всегда, __всегда__ должна писать два символа равенства `==`, если хочешь проверить, одинаковы ли объекты. Мы также можем проверить, различаются ли объекты. Для этого мы используем `!=`, как показано в примере выше.
+Хочешь спросить почему мы написал двойной символ равенства `==`, чтобы проверить одинаковы ли числа? Потому что одинарные символ равенства `=` уже задействован под присваивание значения переменным. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. Мы также можем проверить различаются ли объекты. Для этого, мы используем `!=`, как показано в примере выше.
 
 Дадим Python еще два задания:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 6 >= 12 / 2
 True
@@ -473,16 +505,17 @@ True
 False
 ```
 
-С `>` и `<` все понятно, но что значат `>=` и `<=`? Читай их следующим образом:
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
 
--   x `>` y означает: x больше y
--   x `<` y означает: x меньше y
--   x `<=` y означает: x меньше или равен y
--   x `>=` y означает: x больше или равен y
+- x `>` y означает: x больше y
+- x `<` y означает: x меньше y
+- x `<=` y означает: x меньше или равен y
+- x `>=` y означает: x больше или равен y
 
 Супер! Хочешь еще? Тогда попробуй вот это:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 6 > 2 and 2 < 3
 True
@@ -492,36 +525,39 @@ False
 True
 ```
 
-Ты можешь передать Python столько чисел, сколько захочешь, и он будет возвращать ответ! Хитро, правда?
+Ты можешь передать Python так много чисел, как захочешь, и он будет возвращать ответ! Хитро, правда?
 
--   __and__ — если ты используешь оператор `and`, оба сравнения по бокам от него должны быть True (верны), чтобы результат всей команды был равен True.
--   __or__ — если ты используешь оператор `or`, достаточно одному из сравнений по бокам от него быть равным True, чтобы результат всей команды также равнялся True.
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
 
-Ты когда-нибудь слышала выражение "сравнивать яблоки с апельсинами"? Попробуем сделать что-то подобное в Python:
+Ты когда-нибудь слышала выражение "сравнивать яблоки и апельсины"? Попробуем что-то подобное в Python:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> 1 > 'django'
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
-TypeError: unorderable types: int() > str()
+TypeError: '>' not supported between instances of 'int' and 'str'
 ```
 
-Как мы видим, Python не знает, как сравнить число (`int`) и строку (`str`) между собой. Поэтому он просто возвращает нам ошибку **TypeError** и предупреждает, что объекты заданных типов не могут быть сравнены.
+Как мы видим, Python не знает как сравнить число (`int`) и строку (`str`) между собой. Поэтому он просто возвращает нам ошибку **TypeError** и предупреждает, что объекты заданных типов не могут быть сравнены.
 
 ## Логические значения
 
-Между прочим, ты только что познакомилась с новым типом объектов в Python. Он называется __Boolean__ (логический) — и это, наверное, самый простой тип из всех.
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
 
-Существует только два логических объекта в Python:
-- True (Истина),
-- False (Ложь).
+- True
+- False
 
-Чтобы Python понимал тебя, ты всегда должна писать True с заглавной буквы (остальные прописные). **true, TRUE, tRUE не будет восприниматься — только True.** (Та же логика применима к False, само собой.)
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
 
 Ты можешь присваивать переменным логические значения! Смотри сюда:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> a = True
 >>> a
@@ -531,6 +567,7 @@ True
 Или так:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> a = 2 > 5
 >>> a
@@ -539,164 +576,169 @@ False
 
 Попрактикуйся с логическими значениями на примере этих выражений:
 
--   `True and True`
--   `False and True`
--   `True or 1 == 1`
--   `1 != 2`
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
 
-Поздравляем! Логические значения — одна из самых классных фишек программирования, и ты только что научилась ими пользоваться!
+Поздравляем! Логические значения одна из самых классных фишек программирования и ты только что научилась ими пользоваться!
 
 # Сохраняй!
 
-> Для проходящих руководство дома: этот раздел рассмотрен в видео [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk).
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
 
-До сих пор мы писали весь код в интерактивной консоли, где Python сразу анализировал, обрабатывал и выполнял наши команды. Мы были ограничены одной строкой. Обычно, программы сохраняются в файлах и выполняются **интерпретатором** или **компилятором** нашего языка программирования. Пока мы только просили **интерпретатор** Python выполнять наши однострочные команды из консоли. Однако нам понадобиться больше места для следующих задач, поэтому задача минимум:
+До сих пор мы писали весь код в интерактивной консоли, где Python сразу анализировал, обрабатывал и выполнял наши команды. Мы были ограничены одной строкой. Обычно, программы сохраняются в файлах и выполняются **интерпретатором** или **компилятором** нашего языка программирования. Пока мы только просили **интерпретатор** Python выполнять наши однострочные команды из консоли. Однако, нам понадобиться больше места для следующих задач, поэтому задача минимум:
 
-- закрыть интерактивную консоль Python;
-- открыть наш текстовый редактор;
-- сохранить код в новом файле;
-- запустить его!
+- Закрыть интерактивную консоль Python
+- Открыть наш текстовый редактор
+- Сохранить код в новом файле
+- Запустить его!
 
-Чтобы закрыть интерактивную консоль Python, просто набери функцию `exit()`:
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 >>> exit()
 $
 ```
 
-Это вернёт тебя в командную строку.
+Это вернет тебя в командную строку.
 
-В главе [Текстовый редактор][2] мы выбрали себе редактор. Нам нужно открыть его сейчас и записать следующий код в новый файл:
-
- [2]: ../code_editor/README.md
+Ранее мы выбрали редактор кода в разделе [Текстовый редактор](../code_editor/README.md). Открой его сейчас и напиши следующий код:
 
 {% filename %}editor{% endfilename %}
+
 ```python
 print('Hello, Django girls!')
 ```
 
-Очевидно, ты уже искушенный Python разработчик, так что не стесняйся добавить что-нибудь по своему вкусу из ранее изученного.
+Очевидно, ты уже искушенный Python разработчик, так что не стесняйся добавить что-нибудь по своему вкусу из ране изученного.
 
-Теперь нам нужно сохранить файл с кодом и дать ему подходящее имя. Давай назовем его **python_intro.py** и сохраним на рабочий стол. Мы можем назвать файл как хотим, но важно, чтобы название заканчивалось на **.py**. Расширение **.py** говорит операционной системе, что это **исполняемый файл python**, и Python может его запустить.
+Теперь нам нужно сохранить файл с кодом и дать ему подходящее имя. Давай назовем его **python_intro.py** и сохраним на рабочий стол. Мы можем назвать файл как хотим, но важно чтобы название заканчивалось на **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
 
-> **Примечание** Ты должна уже была заметить одну из крутейших вещей в редакторах кода: цвета! В интерактивной консоли Python весь текст был одного цвета, сейчас же функция `print` должна отличаться по цвету от текста, который передается в неё в качестве аргумента. Это называется «синтаксическая подсветка», и это действительно удобная штука для программирования. Цвет подсветки может подсказать тебе о незакрытой кавычке или опечатке в ключевом слове (таком как `def` в определении функции, с которым мы скоро познакомимся). Это одна из причин, по которой мы используем редакторы кода :)
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. Это называется «синтаксическая подсветка», и это действительно удобная штука для программирования. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). Это одна из причин, по которой мы используем редакторы кода. :)
 
+После сохранения файла пришло время запустить его! Используя навыки из раздела о командной строки, открой терминал и **поменяй текущую директорию** на рабочий стол.
 
-После сохранения файла пришло время запустить его! Используя навыки из раздела о командной строке, открой терминал и **поменяй текущую директорию** на рабочий стол.
-
-<!--sec data-title="OS X" data-id="python_OSX"
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
 data-collapse=true ces-->
 
 Для Mac команда будет выглядеть так:
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd ~/Desktop
-```
+
+    $ cd ~/Desktop
+    
+
 <!--endsec-->
 
-<!--sec data-title="Linux" data-id="python_linux"
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
 data-collapse=true ces-->
 
-Для Linux (слово "Desktop" может быть переведено на твой язык, например "Рабочий стол"):
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
 
 {% filename %}command-line{% endfilename %}
-```
-$ cd ~/Desktop
-```
+
+    $ cd ~/Desktop
+    
 
 <!--endsec-->
 
-<!--sec data-title="Командная строка Windows" data-id="python_windows" data-collapse=true ces-->
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
 
-В командной строке Windows команда будет такой:
+On Windows Command Prompt, it will be like this:
 
 {% filename %}command-line{% endfilename %}
-```
-> cd %HomePath%\Desktop
-```
-<!--endsec-->
 
+    > cd %HomePath%\Desktop
+    
 
-<!--sec data-title="Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
 
-В Windows Powershell команда будет такой:
+And on Windows Powershell, it will be like this:
 
 {% filename %}command-line{% endfilename %}
-```
-> cd $Home\Desktop
-```
-<!--endsec-->
 
+    > cd $Home\Desktop
+    
 
-Если возникли проблемы — просто обратись за помощью.
+<!--endsec-->
+
+Если возникли проблемы - просто обратись за помощью.
 
-Теперь используй Python, чтобы запустить код в файле:
+Теперь используй Python чтобы запустить код в файле:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hello, Django girls!
-```
 
-Примечание: Windows не распознаёт команду 'python3'. Вместо этогодля запуска файла используй команду 'python':
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 > python python_intro.py
 ```
 
-Отлично! Ты только что запустила свою первую программу, код которой был сохранен в файле. Чувствуешь воодушевление?
+Отлично! Ты только что запустила свою первую программу, чей код был сохранен в файле. Чувствуешь воодушевление?
 
 Можно передвигаться дальше к такому незаменимому в программировании инструменту как:
 
-## If...elif...else
+## If … elif … else
 
-Зачастую определенный код в программе должен выполняться только при соблюдении определенных условий. Поэтому в Python есть такая вещь как **условный оператор if**.
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
 
 Замени код в своем файле **python_intro.py** на:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
 ```
 
-Если мы сохраним его и запустим, то получим ошибку:
+If we were to save and run this, we'd see an error like this:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-File "python_intro.py", line 2
-         ^
-SyntaxError: unexpected EOF while parsing
-```
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
 
 Python предполагает, что мы должны дать ему инструкции, которые будут им выполнены при соблюдении условия `3 > 2` (т. е. при равенстве условия логическому значению `True`). Давай попробуем заставить Python напечатать на экране “It works!”. Внеси следующие изменения в **python_intro.py**:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
     print('It works!')
 ```
 
-Обратила внимание, что мы сделали отступ во второй строке из 4 символов пробела? Мы поступаем так, чтобы Python понимал, какой код после условного оператора if должен быть выполнен, если условие равно True. Можно ограничиться и одним пробелом, однако практически все программисты Python используют 4, чтобы код выглядел аккуратно и читабельно. Каждая `табуляция` также считается за 4 пробела.
+Обратила внимание как мы сделали отступ во второй строке из 4 символов пробела? Мы поступаем так, чтобы Python понимал какой код после условного оператора if должен быть выполнен, если условие равно True. Можно ограничиться и одним пробелом, однако, практически все программисты Python используют 4, чтобы код выглядел аккуратно и читабельно. Каждая `табуляция` также считается за 4 пробела.
 
-Сохраняем и запускаем ещё раз:
+Сохраняем и запускаем еще раз:
 
 {% filename %}command-line{% endfilename %}
+
 ```python
 $ python3 python_intro.py
 It works!
 ```
 
-Примечание: запомни, что Windows не распознаёт команду 'python3'. Всегда используй 'python' вместо 'python3' для запуска файлов.
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
 
 ### Что, если условие не True?
 
-В предыдущем примере код выполнялся только когда условие равнялось True. Однако Python имеет операторы `elif` и `else`:
+В предыдущем пример код выполнялся только когда условие равнялось True. Однако, Python имеет операторы `elif` и `else`:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 5 > 2:
     print('5 is indeed greater than 2')
@@ -707,14 +749,15 @@ else:
 Если запустить этот код, он напечатает:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-5 is indeed greater than 2
-```
 
-Если 2 больше 5, то будет выполнена следующая команда. Просто, правда? Давай посмотрим, как работает оператор `elif`:
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 name = 'Sonja'
 if name == 'Ola':
@@ -728,16 +771,17 @@ else:
 и запускаем:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hey Sonja!
-```
 
-Видишь, что произошло? `elif` позволяет добавить дополнительные условия, которые запускаются, если предыдущие не срабатывают.
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+Видишь, что произошло? `elif` позволяет добавить дополнительные условия, которые запускаются если предыдущие не срабатывают.
 
 Можно использовать сколько угодно `elif` после первого `if`. Например:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 volume = 57
 if volume < 20:
@@ -757,18 +801,19 @@ else:
 Python проходит через каждую проверку условия и выводит:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Perfect, I can hear all the details
-```
 
-## Комментарии
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
 
-Комментариями — это строки, начинающиеся с символа `#`. Ты можешь написать всё, что тебе заблагорассудится, после символа `#`, и Python не обратит на это внимания. Комментарии могут помочь другим людям быстрее понять твой код.
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
 
-Давай посмотрим, как они выглядят:
+Let's see how that looks:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 # Change the volume if it's too loud or too quiet
 if volume < 20 or volume > 80:
@@ -776,30 +821,30 @@ if volume < 20 or volume > 80:
     print("That's better!")
 ```
 
-Тебе не стоит писать комментарий для каждой строки кода, но он может быть полезен, чтобы пояснить причину определённых действий или добавить описание, когда код делает что-то особенно сложное.
-
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
 
-### Подведём итог
+### Содержание
 
-В последних трёх упражнениях ты познакомилась с:
+In the last few exercises you learned about:
 
-- __сравнением вещей__ — в Python ты можешь сравнивать вещи друг с другом при помощи `>`, `>=`, `==`, `<=`, `<` и операторов `and`, `or`;
-- __Boolean__ — типом объекта, который может иметь только два значения: `True` или `False`;
-- __сохранением файлов__ — хранение кода в файлах позволяет выполнять длинные программы;
-- __if...elif...else__ — условными операторами, которые позволяют выполнять код только при определенных условиях;
-- __комментариями__ — строками, которые Python не запускает и которые позволяют документировать твой код.
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
 
 Пришло время для последней части этой главы!
 
 ## Твоя собственная функция!
 
-> Для проходящих руководство дома: этот раздел рассмотрен в видео [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0).
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
 
-Помнишь функции, такие как `len()`, которые можно использовать в Python? Тогда у нас есть хорошая новость — сейчас ты научишься писать свои собственные функции!
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
 
-Функция — это последовательность инструкций, которые должен выполнить Python. Каждая функция в Python начинается с ключевого слова `def`, имеет свое имя и параметры. Давай начнем с простого примера. Замени код в **python_intro.py** на следующий:
+Функция - это последовательность инструкций, которые должен выполнить Python. Каждая функция в Python начинается с ключевого слова `def`, имеет свое имя и параметры. Let's give it a go. Замени код в **python_intro.py** на следующий:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi():
     print('Hi there!')
@@ -808,28 +853,29 @@ def hi():
 hi()
 ```
 
-
 Отлично, наша первая функция готова!
 
-Ты можешь задаться вопросом, почему мы написали имя функции в конце файла. Причина в том, что Python читает и исполняет код из файла сверху вниз. Поэтому для использования нашей функции мы должны вызвать её в конце файла.
+Ты можешь задаться вопросом, почему мы написали имя функции в конце файла. Причина в том, что Python читает и исполняет код из файла сверху вниз. Поэтому, для использования нашей функции мы должны вызвать её в конце файла.
 
-Давай запустим и посмотрим, что произойдет:
+Давай запустим и посмотрим что произойдет:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi there!
-How are you?
-```
 
-Примечание: если это не сработало, не поддавайся панике! Вывод командной строки поможет тебе понять, почему так произошло:
-- Если ты получила ошибку `NameError`, то, возможно, ты что-то неправильно ввела, поэтому проверь, что ты использовала одно и то же имя при создании функции в строке `def hi():` и при её вызове в строке `hi()`.
-- Если ты получила ошибку `IndentationError`, проверь, что обе строки с вызовом `print` начинаются с одинакового количества проблелов: python хочет, чтобы весь код внутри функции был аккуратно выровнен.
-- Если при запуске команда не вывела вообще ничего, проверь, чтобы в начале последней строки `hi()` *не было* отступа — если он есть, эта строка тоже становится частью функции, и функция никогда не запустится.
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
 
-Давай напишем нашу первую функцию с параметрами. Мы будем использовать предыдущий пример — функцию, которая пишет 'hi' и имя пользователя:
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
 ```
@@ -837,6 +883,7 @@ def hi(name):
 Как ты можешь заметить, мы передали нашей функции параметр `name`:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
     if name == 'Ola':
@@ -852,56 +899,59 @@ hi()
 Помни: функция `print` расположена внутри блока оператора `if` с отступом в четыре пробела. Это потому, что она запускается тогда, когда выполняется условие. Давай посмотрим, как это работает:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Traceback (most recent call last):
-File "python_intro.py", line 10, in <module>
-  hi()
-TypeError: hi() missing 1 required positional argument: 'name'
-```
 
-Упс, ошибка. К счастью, Python выдает довольно подробное сообщение об ошибке. Оно говорит нам, что функция `hi()` (которую мы определили) имеет один обязательный аргумент (`name`), и мы забыли передать его при вызове функции. Давай исправим это в конце файла:
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Упс, ошибка. К счастью, Python выдает довольно подробное сообщение об ошибке. Оно говорит нам, что функция `hi()` (которую мы определили) имеет один обязательный аргумент (`name`) и мы забыли передать его при вызове функции. Давай исправим это в конце файла:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 hi("Ola")
 ```
 
-И запустим ещё раз:
+И запустИм еще раз:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi Ola!
-```
 
-А если мы поменяем имя?
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+И если мы поменяем имя?
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 hi("Sonja")
 ```
 
-И повторим:
+И повторИм:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi Sonja!
-```
 
-Теперь, как ты думаешь, что произойдет, если ты наберешь другое имя? (Не Ola или Sonja) Попробуй сама и проверь, была ли ты права. Результат должен быть таким:
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
 
 {% filename %}command-line{% endfilename %}
-```
-Hi anonymous!
-```
 
-Шикарно, верно? Так тебе не придется повторяться каждый раз, когда ты захочешь изменить имя. И это именно та причина, для которой нам и нужны функции — ты никогда не захочешь повторять свой код!
+    Hi anonymous!
+    
+
+Шикарно, верно? Так тебе не придется повторяться каждый раз, когда ты захочешь изменить имя. And that's exactly why we need functions – you never want to repeat your code!
 
-Давай попробуем что-то похитрее — существует немало имён, и писать условие для каждого будет тяжело, правда?
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
     print('Hi ' + name + '!')
@@ -912,17 +962,16 @@ hi("Rachel")
 Давай выполним этот код:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi Rachel!
-```
 
+    $ python3 python_intro.py
+    Hi Rachel!
+    
 
-Поздравляем! Ты только что научилась писать свои собственные функции :)
+Поздравляем! Ты только что научилась писать свои собственные функции! :)
 
 ## Циклы
 
->  Для проходящих руководство дома: этот раздел рассмотрен в видео [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0).
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
 
 Ну вот и последняя часть. Быстро время пролетело, верно? :)
 
@@ -931,6 +980,7 @@ Hi Rachel!
 Еще помнишь о списках? Давай создадим список девушек:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
 ```
@@ -938,15 +988,17 @@ girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
 Мы хотим поздороваться с каждой по имени. У нас есть функция `hi`, которая этим и занимается, так что давай поместим её в цикл:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 for name in girls:
 ```
 
-Оператор `for` работает по схожему принципу что и `if`; в коде после обоих операторов должен быть отступ в четыре пробела.
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
 
 Ниже полный код, который должен быть у нас в файле:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
     print('Hi ' + name + '!')
@@ -957,28 +1009,29 @@ for name in girls:
     print('Next girl')
 ```
 
-И после запуска:
+И после ИсполненИя:
 
 {% filename %}command-line{% endfilename %}
-```
-$ python3 python_intro.py
-Hi Rachel!
-Next girl
-Hi Monica!
-Next girl
-Hi Phoebe!
-Next girl
-Hi Ola!
-Next girl
-Hi You!
-Next girl
-```
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
 
 Как ты можешь заметить, все команды внутри цикла `for` (с отступом от левого края) будут выполняться для каждого элемента списка `girls`.
 
-Ты также можешь использовать цикл `for` с числами с помощью функции `range`:
+Ты также можешь использовать цикл `for` на числах, используя функцию `range`:
 
 {% filename %}python_intro.py{% endfilename %}
+
 ```python
 for i in range(1, 6):
     print(i)
@@ -987,24 +1040,22 @@ for i in range(1, 6):
 Что выведет на экран:
 
 {% filename %}command-line{% endfilename %}
-```
-1
-2
-3
-4
-5
-```
 
-Функция `range` создает список чисел, следующих от первого до второго с заданным шагом (начало, конец и шаг мы передаем функции как параметры; если шаг не указать, как в примере выше, он будет по умолчанию равен 1).
+    1
+    2
+    3
+    4
+    5
+    
 
-Обрати внимание что второе число (конец списка) не включается в результат работы функции (`range(1, 6)` создает список от 1 до 5, не включающий 6). Это потому, что «range» — полуоткрытый диапазон, то есть включает в себя первое значение, но не включает последнего.
+Функция `range` создает список чисел, следующих от первого до второго с заданным шагом (начало, конец и шаг мы передаем функции как параметры, если шаг не указать, как в примере выше, он будет по умолчанию равен 1).
 
-## Подведём итог
+Обрати внимание что второе число (конец списка) не включается в результат работы функции (`range(1, 6)` создает список от 1 до 5, не включающий 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
 
-Вот и всё. __Ты чертовски крута!__ Эта глава была непростой, так что ты можешь гордиться собой. Мы-то точно тобой гордимся — вон как далеко продвинулась уже!
+## Содержание
 
-Тебе может потребоваться перерыв — прогуляйся и дай отдых глазам перед тем, как мы перейдем к следующей главе. :)
+Вот и всё. **Ты чертовски крута!** Эта глава была непростой, так что ты можешь гордиться собой. Мы-то точно тобой гордимся — вон как далеко продвинулась уже!
 
-![Пирожок][3]
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
 
- [3]: images/cupcake.png
+![Пирожок](images/cupcake.png)
\ No newline at end of file
diff --git a/ru/signup_pythonanywhere.md b/ru/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/ru/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ru/template_extending/README.md b/ru/template_extending/README.md
index 938e88b0d00..f45b0e778e6 100755
--- a/ru/template_extending/README.md
+++ b/ru/template_extending/README.md
@@ -1,110 +1,113 @@
 # Расширение шаблона
 
-Ещё одной удобной вещью в Django является __расширение шаблонов__. Что это значит? Ты можешь использовать одни и те же блоки HTML-кода для разных частей своего веб-сайта.
+Еще одной удобной вещью в Django является **расширение шаблонов**. Что это значит? Ты можешь использовать различные блоки HTML-кода для разных частей своего веб-сайта.
 
-Так тебе не придётся повторяться каждый раз, когда потребуется использовать ту же информацию/структуру. И если появится необходимость что-то изменить, не придётся вносить правки в каждую страницу: достаточно скорректировать шаблон!
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
 
-## Создаём базовый шаблон
+## Create a base template
 
-Базовый шаблон — это наиболее общая типовая форма страницы, которую ты расширяешь для отдельных случев.
+Базовый шаблон - это наиболее общая типовая форма страницы, которую ты расширяешь для отдельных случев.
 
 Давай создадим файл `base.html` в директории `blog/templates/blog/`:
 
-```
-blog
-└───templates
-    └───blog
-            base.html
-            post_list.html
-```
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
 
-Теперь открой его и скопируй всё из `post_list.html` в `base.html`:
+Теперь открой его и скопируй все из `post_list.html` в `base.html`:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
-    <head>
-        <title>Django Girls blog</title>
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
-        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
-        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
-    </head>
-    <body>
-        <div class="page-header">
-            <h1><a href="/">Django Girls Blog</a></h1>
-        </div>
-
-        <div class="content container">
-            <div class="row">
-                <div class="col-md-8">
-                {% for post in posts %}
-                    <div class="post">
-                        <div class="date">
-                            {{ post.published_date }}
-                        </div>
-                        <h1><a href="">{{ post.title }}</a></h1>
-                        <p>{{ post.text|linebreaksbr }}</p>
-                    </div>
-                {% endfor %}
-                </div>
-            </div>
-        </div>
-    </body>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
 </html>
 ```
 
-Затем в файле `base.html` замени всё между тегами `<body>` и `</body>` следующим кодом:
+Затем в файле `base.html` замени все между тегами `<body>` и `</body>` следующим кодом:
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <body>
-    <div class="page-header">
-        <h1><a href="/">Django Girls Blog</a></h1>
-    </div>
-    <div class="content container">
-        <div class="row">
-            <div class="col-md-8">
-            {% block content %}
-            {% endblock %}
-            </div>
-        </div>
-    </div>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
 </body>
 ```
 
-Мы просто заменили всё между `{% for post in posts %}{% endfor %}` следующим:
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
 
 {% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% block content %}
 {% endblock %}
 ```
 
-Что это означает? Ты только что создала `block` — тег шаблона, позволяющий вставлять HTML-код этого блока в другие шаблоны, расширяющие `base.html`. Мы покажем, как это сделать, через секунду.
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). Мы покажем как это сделать через секунду.
 
-Теперь сохрани всё и открой `blog/templates/blog/post_list.html` снова.
-{% raw %}Тебе нужно удалить всё до `{% for post in posts %}` и после `{% endfor %}`. В итоге файл будет выглядеть следующим образом:{% endraw %}
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
-    <div class="post">
-        <div class="date">
-            {{ post.published_date }}
-        </div>
-        <h1><a href="">{{ post.title }}</a></h1>
-        <p>{{ post.text|linebreaksbr }}</p>
-    </div>
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
 {% endfor %}
 ```
 
-Мы хотим использовать это фрагмент в твоём шаблоне для отображения содержимого. Пора добавить теги блоков в этот файл!
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
 
-{% raw %}Нам нужно, чтобы новый тег блока соответствовал тегу в файле `base.html`. Также нам необходимо включить весь код, который соответствует твоему блоку с содержимым. Для этого расположи всё между `{% block content %}` и `{% endblock %}`. Вот так:{% endraw %}
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Таким образом:{% endraw %}
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% block content %}
     {% for post in posts %}
@@ -118,31 +121,27 @@ blog
     {% endfor %}
 {% endblock %}
 ```
-А теперь добавь следующую строку в начало файла:
 
-```
-    {% extends 'blog/base.html' %}
-```
-
-Осталось последнее: нам нужно связать эти два шаблона друг с другом. Ведь именно для этого и нужно расширение шаблонов! Мы сделаем это, добавив тег `extends` в начало файла. Вот так:
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
 
 {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
 {% block content %}
-    {% for post in posts %}
-        <div class="post">
-            <div class="date">
-                {{ post.published_date }}
-            </div>
-            <h1><a href="">{{ post.title }}</a></h1>
-            <p>{{ post.text|linebreaksbr }}</p>
-        </div>
-    {% endfor %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
 {% endblock %}
 ```
 
-Готово! Проверь, что твой веб-сайт работает нормально :)
+Готово! Проверь, что твой веб-сайт работает нормально. :)
 
-> Если появилась ошибка `TemplateDoesNotExists`, это значит, что нет файла `blog/base.html` и `runserver` запущен в командной строке. Попробуй остановить его (одновременно нажми Ctrl + C) и перезапусти веб-сервер командой `python manage.py runserver`.
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ru/whats_next/README.md b/ru/whats_next/README.md
index 246ffba63ee..23755b89b13 100755
--- a/ru/whats_next/README.md
+++ b/ru/whats_next/README.md
@@ -1,40 +1,25 @@
 # Что дальше?
 
-Поздравь себя! __Ты нереально крута__. Мы очень гордимся! <3
+Поздравь себя! **Ты нереально крута**. Мы очень гордимся! <3
 
 ### Что делать дальше?
 
 Сделай перерыв и расслабься. Ты только что закончила огромную работу.
 
-И не забудь подписаться на страничку Django Girls в [Facebook][1] и [Twitter][2], чтобы оставаться в курсе новостей.
-
- [1]: http://facebook.com/djangogirls
- [2]: https://twitter.com/djangogirls
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
 
 ### Можем ли мы посоветовать дополнительные ресурсы для обучения?
 
-Конечно! Прежде всего попробуй [Учебнике Django Girls: Дополнительные темы][3].
-
- [3]: https://tutorial-extensions.djangogirls.org
-
-Позднее ты можешь попробовать ресурсы из списка ниже. Мы очень рекомендуем каждый из них!
-
-- [Django's official tutorial][4]
-- [New Coder tutorials][5]
-- [Code Academy Python course][6]
-- [Code Academy HTML & CSS course][7]
-- [Django Carrots tutorial][8]
-- [Learn Python The Hard Way book][9]
-- [Getting Started With Django video lessons][10]
-- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book][11]
-- [Hello Web App: Learn How to Build a Web App][12]
-
- [4]: https://docs.djangoproject.com/en/1.11/intro/tutorial01/
- [5]: http://newcoder.io/tutorials/
- [6]: https://www.codecademy.com/en/tracks/python
- [7]: https://www.codecademy.com/tracks/web
- [8]: https://github.com/ggcarrots/django-carrots/
- [9]: http://learnpythonthehardway.org/book/
- [10]: http://www.gettingstartedwithdjango.com/
- [11]: https://www.twoscoopspress.com/products/two-scoops-of-django-1-11
- [12]: https://hellowebapp.com/
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/sk-SK/GLOSSARY.md b/sk-SK/GLOSSARY.md
new file mode 100644
index 00000000000..38a876ffe64
--- /dev/null
+++ b/sk-SK/GLOSSARY.md
@@ -0,0 +1,3 @@
+# editor kódu
+
+Editor kódu je aplikácia, pomocou ktorej môžeš svoj kód uložiť, takže sa k nemu môžeš neskôr vrátiť. Kde ho môžeš zohnať, zistíš v [kapitole o editore kódu](./code_editor/README.md)
\ No newline at end of file
diff --git a/sk-SK/README.md b/sk-SK/README.md
new file mode 100644
index 00000000000..42e80b7e521
--- /dev/null
+++ b/sk-SK/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutoriál
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Toto dielo je zverejnené pod medzinárodnou licenciou Creative Commons Attribution-ShareAlike ("uvedenie autora – rovnaké šírenie") 4.0. Ak chcete zobraziť kópiu tejto licencie, navštívte https://creativecommons.org/licenses/by-sa/4.0/
+
+## Vitaj
+
+Vitaj na Django Girls! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Úvod
+
+Mala si niekedy pocit, že svet je stále viac a viac o technológiách a ku ktorým (zatiaľ) nemáš vzťah? Uvažovala si niekedy, že by si si vytvorila webovú stránku, ale nikdy si nemala dostatok motivácie začať? Zdalo sa ti niekedy, že svet softvéru je pre teba príliš komplikovaný a že sama nezvládneš nič vytvoriť?
+
+Máme pre teba dobrú správu! Programovanie nie je také zložité, ako sa zdá a chceme ti ukázať, aké môže byť zábavné.
+
+Tento návod z teba neurobí programátorku mávnutím čarovného prútika. Ak chceš byť v tom dobrá, čakajú ťa mesiace či dokonca roky štúdia a praxe. Chceme ti ale ukázať, že vytvorenie webovej stránky nie je také ťažké, ako sa zdá. Pokúsime sa ti vysvetliť rôzne technológie tak, aby si sa ich nemusela báť.
+
+Dúfame, že sa ti tieto veci zapáčia tak veľmi ako nám!
+
+## Čo ťa tento návod naučí?
+
+Po skončení budeš mať funkčnú webovú aplikáciu: tvoj vlastný blog. Ukážeme ti, ako ho zverejniť na webe, kde ho môže každý navštíviť!
+
+Výsledok bude vyzerať asi takto:
+
+![Obrázok 0.1](images/application.png)
+
+> Ak budeš na tomto projekte pracovať sama a nemáš mentora, ktorý ti pomáha, môžeš v prípade problémov navštíviť tento chat: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Požiadali sme našich mentorov, ale aj absolventky, aby sa na tomto chate občas ukázali a pomohli ostatným! Neboj sa opýtať čomu nerozumieš!
+
+OK, [začnime pekne po poriadku...](./how_the_internet_works/README.md)
+
+## Sledovanie tutoriálu doma
+
+Je úžasné, zúčastniť sa Django Girls workshopu, ale uvedomujeme si, že nie vždy je možné byť na niektorom. Preto ti odporúčami aby si skúsila postupovať podľa tohto tutoriálu doma. Pre tých ktorí sú doma, v súčasnosti pripravujeme videá, ktoré umožnia jednoduchšie sledovanie tutoriálu doma. Stále sa na tom pracuje, ale viac a viac vecí bude čoskoro na [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube kanály.
+
+V každej kapitole ktorá už bola spracovaná sa nachádza odkaz na príslušné video.
+
+## Informácie a možnosti ako sa zapojiť
+
+Tento návod vytvorili a udržiavajú [DjangoGirls](https://djangogirls.org/). Ak nájdeš chyby alebo by si chcela aktualizovať tento návod, prosím [postupuj podľa pokynov](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Chceš pomôcť s prekladom do iných jazykov?
+
+V súčasnosti koordinujeme preklady cez platformu crowdin.com:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Ak tvoj jazyk nie je v zozname na [crowdin. com](https://crowdin.com/), [daj nám prosím vedieť](https://github.com/DjangoGirls/tutorial/issues/new) aký jazyk máme pridať.
\ No newline at end of file
diff --git a/sk-SK/SUMMARY.md b/sk-SK/SUMMARY.md
new file mode 100644
index 00000000000..aaed5622cd8
--- /dev/null
+++ b/sk-SK/SUMMARY.md
@@ -0,0 +1,35 @@
+# Zhrnutie
+
+* [Úvod](README.md)
+* [Inštalácia](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Inštalácia (chromebook)](chromebook_setup/README.md)
+* [Ako funguje Internet](how_the_internet_works/README.md)
+* [Úvod do príkazového riadku](intro_to_command_line/README.md)
+* [Inštalácia Pythonu](python_installation/README.md)
+* [Editor kódu](code_editor/README.md)
+* [Úvod do jazyka Python](python_introduction/README.md)
+* [Čo je Django?](django/README.md)
+* [Inštalácia Django](django_installation/README.md)
+* [Tvoj prvý Django projekt!](django_start_project/README.md)
+* [Django modely](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Nasadenie!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views - čas tvoriť!](django_views/README.md)
+* [Úvod do HTML](html/README.md)
+* [Django ORM (tvorba dotazov)](django_orm/README.md)
+* [Dynamické dáta v šablónach](dynamic_data_in_templates/README.md)
+* [Šablóny Django](django_templates/README.md)
+* [CSS - skrášli to](css/README.md)
+* [Rozširovanie šablón](template_extending/README.md)
+* [Ako rozšíriť aplikáciu](extend_your_application/README.md)
+* [Formuláre Django](django_forms/README.md)
+* [Čo ďalej?](whats_next/README.md)
\ No newline at end of file
diff --git a/sk-SK/chromebook_setup/README.md b/sk-SK/chromebook_setup/README.md
new file mode 100644
index 00000000000..8a60c03eea0
--- /dev/null
+++ b/sk-SK/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Nastavenie Chromebooku
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/sk-SK/chromebook_setup/instructions.md b/sk-SK/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..6c0b1205a27
--- /dev/null
+++ b/sk-SK/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Túto časť [môžeš preskočiť](http://tutorial.djangogirls.org/en/installation/#install-python) ak nepoužívaš Chromebook. Ak ho používaš, tak tvoja inštalácia bude trochu iná. Môžeš odignorovať zvyšok inštalačného postupu.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE je nástroj ktorý ti poskytne editor kódu a prístup na počítač, ktorý beží v cloude na internete, kde môžeš inštalovať, písať a spúšťať softvér. Počas tohto tutoriálu, Cloud IDE sa bude tváriť ako tvoj *lokálny stroj*. Príkazy budeš zadávať do terminálového rozhrania, tak ako tvoji spolužiaci čo používajú OS X, Ubuntu, alebo Windows, ale tvoj terminál bude pripojený na počítač, ktorý beží niekde inde a ktorý Cloud IDE pripraví pre teba. Tu sú inštrukcie pre cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Môžeš si vybrať jedno z Cloud IDE riešení a postupovať podľa inštrukcií pre zvolený typ IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtuálne prostredie
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/sk-SK/code_editor/README.md b/sk-SK/code_editor/README.md
new file mode 100644
index 00000000000..086a259ac0c
--- /dev/null
+++ b/sk-SK/code_editor/README.md
@@ -0,0 +1,11 @@
+# Editor kódu
+
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) videu.
+
+O chvíľu napíšeš svoj prvý riadok kódu, takže je načase si stiahnuť editor kódu!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/sk-SK/code_editor/instructions.md b/sk-SK/code_editor/instructions.md
new file mode 100644
index 00000000000..9cb0b770a8a
--- /dev/null
+++ b/sk-SK/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Existuje veľa rôznych editorov a zväčša sa vyberajú podľa osobných preferencií. Väčšina Python programátorov používa zložité, ale veľmi výkonné IDE (integrované vývojové prostredie), ako napríklad PyCharm. Pre začiatočníka je to pravdepodobne menej vhodné; naše odporúčania sú rovnako výkonné, ale oveľa jednoduchšie.
+
+Naše návrhy sú uvedené nižšie, ale neváhaj sa opýtať svojho mentora, aké sú jeho preferencie - bude ti jednoduchšie vedieť pomocť.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Stiahni si ho odtiaľto](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Stiahni si ho odtiaľto](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Stiahni si ho odtiaľto](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/sk-SK/css/README.md b/sk-SK/css/README.md
new file mode 100644
index 00000000000..d8bca8b7593
--- /dev/null
+++ b/sk-SK/css/README.md
@@ -0,0 +1,330 @@
+# CSS - skrášli to!
+
+Náš blog vyzerá zatiaľ dosť škaredo, však? Je čas to napraviť! Použijeme na to CSS.
+
+## Čo je CSS?
+
+Kaskádové štýly (CSS, angl. Cascading Style Sheets) je jazyk, ktorý sa používa na popis vzhľadu a formátovania webstránky napísanej v značkovacom jazyku (napríklad HTML). Predstav si to ako make-up pre našu webstránku. ;)
+
+Ale nechceme začať od nuly, že? Znovu budeme používať niečo, čo programátori zverejnili na internete zadarmo. Ako vieš, vymýšlať koleso nie je žiadna zábava.
+
+## Použime Bootstrap!
+
+Bootstrap je jedným z najpopulárnejších HTML a CSS frameworkov pre vývoj krásnych webových stránok: https://getbootstrap.com/
+
+Bol napísaný programátormi, ktorí pracovali pre Twitter. Teraz je vyvíjaný dobrovoľníkmi z celého sveta!
+
+## Inštalácia Bootstrapu
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Obrázok 14.1](images/bootstrap1.png)
+
+Už to vyzerá lepšie!
+
+## Statické súbory v Djangu
+
+Konečne sa pozrieme zblízka na veci, ktoré nazývame **statické súbory**. Statické súbory sú všetky vaše CSS a obrázky. Ich obsah nie je závislý na kontexte žiadosti a budú rovnaké pre každého používateľa.
+
+### Kam umiestniť statické súbory pre Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+To urobíme tak, že vo vnútri našej aplikácie blog vytvoríme adresár s názvom `static`:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django automaticky nájde všetky zložky s názvom "static" vo všetkých priečinkoch tvojej aplikácie. Následne bude možné použiť ich obsah ako statické súbory.
+
+## Tvoj prvý CSS súbor!
+
+Vytvorme teraz CSS súbor, ktorý tvojej web stránke pridá tvoj vlastný štýl. Vytvor nový adresár s názvom `css` vnútri adresára `static`. Potom vytvor nový súbor s názvom `blog.css` vo vnútri tohto adresára `css`. Pripravená?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Je čas napísať trochu CSS! Otvor v editore kódu súbor `blog/static/css/blog.css`.
+
+Tu sa nebudeme do hĺbky zaoberať úpravou a štúdiom CSS. Na konci tejto stránky sa nachádza odkaz na bezplatný CSS kurz, ak sa o tom cheš dozvedieť viacej.
+
+Ale urobme aspoň niečo. Maybe we could change the color of our headers? Počítače používajú špeciálne kódy, aby rozumeli farbám. Tieto kódy sa začínajú `#` potom nasleduje 6 písmen (A-F) a číslice (0-9). Napríklad kód pre modrú je `#0000FF`. Kódy farieb nájdeš napríklad tu: http://www.colorpicker.com/. Môžeš tiež použiť [preddefinované farby](http://www.w3schools.com/colors/colors_names.asp) ako napríklad `red` (červená) alebo `green` (zelená).
+
+V súbore `blog/static/css/blog.css` pridaj nasledujúci kód:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` je CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. Takže keď máme niečo ako: `<h1><a href="">link</a></h1>` použije sa naň `h1 a` štýl. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+V CSS súbore definujeme štýly pre elementy v HTML súbore. Prvý spôsob, akým môžme identifikovať elementy je názov elementu. Môžno si pamätáte tieto značky z HTML sekcie. Veci ako `a`,`h1`, a `body` sú príklady názvov elementov. Elementy taktiež identifikujeme pomocou atribútu `class` alebo atribútu `id`. Triedy (class) a id sú názvy, ktorými nazveš elementy. Triedy definujú skupiny elementov a id-čká poukazujú na konkrétne elementy. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+O [CSS selektoroch ](http://www.w3schools.com/cssref/css_selectors.asp) si môžeš prečítať viac na stránkach w3schools.
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Tu sme len nahrali statické súbory. :) Medzi `<head>` a `</head>`, po odkazoch na Bootstrap CSS súbory pridať tento riadok:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Prehliadač číta súbory ktoré dostane zaradom, takže musíme sa uistiť, že sú na správnom mieste. Inak kód v našich súboroch môžu byť prepísané kódom z Bootstrap súborov. Práve sme našej šablóne povedali, kde sa nachádza náš CSS súbor.
+
+Súbor by mal teraz vyzerať asi takto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, ulož súbor a obnov stránku!
+
+![Obrázok 14.2](images/color2.png)
+
+Pekne! Možno by sme chceli dať našej webovej stránke trochu vzduchu. Zväčšíme okraj na ľavej strane? Skúsme to!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Pridaj to do svojho CSS, ulož súbor a pozri, ako to funguje!
+
+![Obrázok 14.3](images/margin2.png)
+
+Mohli by sme trochu upraviť font v našej hlavičke, nie? Skopíruj toto do svojej hlavičky `<head>` v súbore `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Rovnako ako predtým, skontroluj poradie a umiestni pred odkaz na `blog/static/css/blog.css`. Tento riadok bude importovať font pod názvom *Lobster* z Google Fonts (https://www.google.com/fonts).
+
+Nájdite `h1 a` deklaračný blok (kód medzi zátvorkami `{` a `}`) v súbore CSS ` blog/static/css/blog.css `. Teraz pridajte riadok` font-family: 'Lobster';` medzi zátvorky a obnovte stránku:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Obrázok 14.3](images/font.png)
+
+Super!
+
+Ako bolo uvedené vyššie, CSS má koncept tried. Triedy umožnia pomenovať časti HTML kódu a použiť štýly iba na tejto časti, bez ovplyvnenia ostatných častí. To môže byť super užitočné! Možno máš dva div-y, ktoré robia niečo iné (ako hlavička a tvoj príspevok). Triedy ti umožnia aby vyzerala každá inak.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Teraz pridáme deklarácie rôznym selektorom. Selektory, ktoré začínajú `.` sa týkajú tried. Na webe je ohľadne CSS veľa skvelých tutorialov a vysvetlení, ktoré ti pomôžu pochopiť nasledujúci kód. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Teraz s deklaráciami tried obklop HTML kód, ktorý zobrazuje posty. Nahraď toto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+v súbore `blog/templates/blog/post_list.html` týmto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Ulož tieto súbory a obnov svoju web stránku.
+
+![Obrázok 14.4](images/final.png)
+
+Woohoo! Vyzerá to úžasne, že áno? Pozrite sa na kód, ktorý sme práve vložili, nájdi miesta, kde sme pridali triedy v HTML a použili sme ich v CSS. Kde by si spravila zmenu, ak by si chcela dátum, tyrkysovej farby?
+
+Neboj sa trochu pohrať s týmto CSS a pokús sa zmeniť niektoré veci. Hraním sa s CSS, môžeš pochopiť, čo robia rôzne veci. Ak niečo pokazíš, neboj sa, môžeš vždy vrátiť zmeny späť!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Pripravená na ďalšiu kapitolu?! :)
\ No newline at end of file
diff --git a/sk-SK/deploy/README.md b/sk-SK/deploy/README.md
new file mode 100644
index 00000000000..08cea90d7b3
--- /dev/null
+++ b/sk-SK/deploy/README.md
@@ -0,0 +1,246 @@
+# Nasadenie!
+
+> **Poznámka** Občas bude možno trochu ťažké prehrýzť sa touto kapitolou. Vydrž a dokonči ju, nasadenie je dôležitou časťou vývoja webových stránok. Táto kapitola je umiestnená uprostred tutoriálu, aby ti mentor/ka mohol/a pomôcť s trochu náročnejšími časťami procesu spúšťania tvojej webovej stránky online. To znamená, že môžeš dokončiť tutoriál aj sama, ak ti nevyjde čas.
+
+Až doteraz, tvoja webová stránka bola dostupná len v počítači. Teraz sa naučíš, ako ju nasadiť! Nasadenie je proces publikovania aplikácie na internete, takže ju ľudia konečne budú môcť vidieť. :)
+
+Ako už vieš, webová stránka musí byť umiestnená na serveri. Na Internete je dostupné mnoho poskytovateľov servrov, my použijeme [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere je bezplatný pre malé aplikácie, ktoré nemajú príliš veľa návštevníkov, takže zatiaľ ti to určite bude stačiť.
+
+Ďalšou externou službou, ktorú budeme využívať je [GitHub](https://www.github.com), kde sa uchovávajú zdrojové kódy. Existujú aj ďalšie podobné služby, no dnes už majú takmer všetci programátori na GitHube konto a teraz ho už budeš mať aj ty!
+
+Tieto tri miesta budú pre teba dôležité. Lokálny počítač bude miestom, kde budeš vyvíjať a testovať. Keď si spokojná so zmenami, uložíš kópiu programu na GitHub. Tvoja webová stránka bude na PythonAnywhere a budeš ju aktualizovať stiahnutím novej kópie svojho kódu z GitHub-u.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Založenie Git repozitára
+
+Git sleduje zmeny na konkrétnej množine súborov, v niečom, čo sa nazýva úložisko kódu alebo repozitár (skrátene "repo"). Založme si repo pre náš projekt. Otvor konzolu a spusti nasledujúce príkazy v adresári `djangogirls`:
+
+> **Poznámka** Skontroluj si aktuálny pracovný adresár s príkazom`pwd` (Mac OS X/Linux) alebo `cd` (Windows) pred inicializáciou repozitára. Mala by si byť v priečinku `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Inicializácia git repozitára je niečo, čo musíme urobiť len raz za projekt (a už nikdy nebudeš musieť znovu zadať užívateľské meno a e-mail).
+
+Git bude sledovať zmeny všetkých súborov a priečinkov v tomto adresári, ale sú aj niektoré súbory, ktoré chceme ignorovať. To urobíme tak, že vytvoríme súbor s názvom `.gitignore` v základnom adresári. Otvor si editor a vytvor nový súbor s týmto obsahom:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+A ulož ho ako `.gitignore` v priečinku "djangogirls".
+
+> **Poznámka** Bodka na začiatku názvu súboru je dôležitá! Ak máš problém vytvoriť takýto súbor (napríklad Macom sa nepáči, ak chceš cez Vyhľadávanie (Finder) vytvoriť súbory, ktoré sa začínajú bodkou), potom použi funkciu "Uložiť ako" vo svojom editore, to je spôsob akým sa to určite uloží. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Poznámka** Jeden zo súborov, ktoré ste zadali v súbore `.gitignore` je `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. Svoju lokálnu databázu si môžeš predstaviť ako pieskovisko na ktorom si môžeš vyskúšať rôzne veci a nebáť sa že zmažeš reálne príspevky zo svojho blogu.
+
+Vždy je dobré použiť príkaz `git status` pred `git add` alebo kedykoľvek, keď si nebudeš istá, či sa niečo zmenilo. To ti pomôže vyhnúť sa prekvapeniam ako napríklad pridanie nesprávnych súborov. Príkaz `git status` dáva informácie o nesledovaných (untracked) či zmenených (modified) súboroch, alebo súboroch pripravených na zmenu (staged), o stave vetvy a veľa ďalších vecí. Výstup by mal byť podobný nasledovnému:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+A nakoniec uložíme naše zmeny. Teraz prejdi na konzolu a zadaj nasledujúce príkazy:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Potom vytvor nové úložisko a pomenuj ho "my-first-blog". Checkbox "inicializuj s README" nechaj nezaškrtnutý, voľbu .gitignore nechaj prázdnu (urobili sme to manuálne) a Licenciu nechaj ako None.
+
+![](images/new_github_repo.png)
+
+> **Poznámka** Názov `my-first-blog` je dôležitý -- mohla by si si vybrať aj niečo iné, ale bude sa to ďalej vyskytovať veľakrát a musela by si to zakaždým nahradiť. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Teraz musíme pripojiť Git repozitár v počítači k tomu na GitHube.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Tvoj kód je na GitHube. Kľudne si to over! Zistíš, že sa nachádza vo vyberanej spoločnosti - [Django](https://github.com/django/django), [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial) a mnoho iných skvelých open sourcových softvérových projektov uchováva svoj kód na GitHube. :)
+
+# Vytvorenie nášho blogu na PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Poznámka** Možno si už účet na PythonAnywhere vytvorila počas inštalácie - ak áno, nemusíš to robiť znova.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Poznámka** PythonAnywhere je založený na Linuxe, takže ak si vo Windowse, konzola bude vyzerať trochu inak ako v tvojom počítači.
+
+Nasadenie webovej aplikácie na PythonAnywhere znamená stiahnutie kódu z GitHubu, a nakonfigurovania PythonAnywhere aby ho rozpoznal a začal ho poskytovať ako webovú aplikáciu. Sú manuálne spôsoby ako to urobiť, ale PythonAnywhere poskytuje pomocný nástroj, ktorý všetko urobí za teba. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Teraz spustíme pomocníka, ktorý automaticky nakonfiguruje našu aplikáciu z GitHubu. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## Si online!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Tipy pre ladenie
+
+Ak uvídíš chybu počas behu `pa_autoconfigure_django.py` skriptu, toto sú najčastejšie dôvody:
+
+- Zabudla si vytvoriť PythonAnywhere API token.
+- Urobila si chybu v tvojej GitHub URL
+- Ak sa ti zobrazí chybové hlásenie, že *"Could not find your settings.py"*, pravdepodobne je to spôsobené tým, že sa ti nepodarilo pridať všetky súbory do Git a/alebo sa ich nepodarilo úspešne pridať na GitHub. Znovu sa pozri na Git odstavec vyššie
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+Ak pri pokuse navštíviť svoju stránku uvidíš chybu, prvým miestom, kde hľadať problém je **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). Pozri, či tam nie sú nejaké chybové hlášky - tie najnovšie sú naspodku.
+
+Môžeš skúsiť aj [Všeobecné tipy na ladenie na PythonAnywhere help stránke](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+A nezabudni, tvoj tréner je tu na to, aby ti pomohol!
+
+# Pozri sa na svoju stránku!
+
+Hlavná stránka tvojej aplikácie by ťa mala vítať nápisom "It worked!", tak ako na tvojom počítači. Skús pridať `/admin/` na koniec adresy URL, a budeš presmerovaná na stránky administrácie. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Keď vytvoríš niekolľko príspevkov, môžeš sa vrátiť do tvojho lokálneho prostredia (nie PythonAnywhere). Na zmenách by si mala pracovať v lokálnom prostredí. To je štandardný pracovný postup pri vývoji webových aplikácií - urobíš zmeny lokálne, dáš tieto zmeny na GitHub a stiahneš zmeny na svoj webový server. To ti umožní pracovať a experimentovať bez pokazenia živej webovej stránky. Docela cool, nie?
+
+*OHROMNE* sa potľapkaj po chrbte! Nasadenie serveru je jedna z najzradnejších častí vývoja web stránok a často zaberie ľuďom aj niekoľko dní, kým to spojazdnia. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/sk-SK/deploy/install_git.md b/sk-SK/deploy/install_git.md
new file mode 100644
index 00000000000..6a2dcbaca2f
--- /dev/null
+++ b/sk-SK/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git je "systém na správu verzií", ktorý využíva množstvo programátorov. Tento softvér sleduje v priebehu času zmeny v tvojich súboroch, takže sa kedykoľvek môžeš vrátiť ku konkrétnej verzii. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Inštalácia Gitu
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Git si môžeš stiahnuť z [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). V ostatných prípadoch sú predvolené nastavenia v poriadku. Možnosť "Checkout Windows-style, commit Unix-style line endings" je OK.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Poznámka:** Ak používaš OS X 10.6, 10.7 alebo 10.8, budeš musieť nainštalovať verziu git-tu odtialto: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sk-SK/deploy/signup_pythonanywhere.md b/sk-SK/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ab840315a21
--- /dev/null
+++ b/sk-SK/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Vytváranie PythonAnywhere API tokenu
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/sk-SK/django/README.md b/sk-SK/django/README.md
new file mode 100644
index 00000000000..b34f090de45
--- /dev/null
+++ b/sk-SK/django/README.md
@@ -0,0 +1,27 @@
+# Čo je Django?
+
+Django (*džängou*) je bezplatný a open source webový framework na vytváranie webových aplikácií, a je napísaný v Pythone. Webový framework je súbor komponentov, ktoré ti pomôžu vytvárať stránky rýchlejšie a ľahšie.
+
+Pri tvorení webových stránok, potrebuješ vždy sadu podobných komponentov: spôsob, ako riešiť autentifikáciu užívateľov (registráciu, prihlásenie, odhlásenie), kontrolný panel web stránky, formuláre, spôsob, ako nahrávať súbory, atď.
+
+Našťastie si iní ľudia už dávno všimli, že weboví vývojári čelia pri tvorbe nového webu podobným problémom, takže sa spojili a vytvorili frameworky (Django je jedným z nich) a tie ti poskytujú hotové komponenty, ktoré môžeš použiť.
+
+Frameworky sú tu na to, aby si nemusela znovu vynájsť koleso. Uľahčia ti tvorbu nových web stránok.
+
+## Prečo potrebuješ framework?
+
+Aby sme pochopili, čo vlastne Django je, potrebujeme sa zblízka pozrieť na servre. Prvá vec, čo o nich musíš vedieť, je, že budú obsluhovať tvoju stránku.
+
+Predstav si poštovú schránku (port), na ktorej sa sledujú prichádzajúce listy (žiadosti). To vlastne robí web server. Web server si prečíta list a pošle odpoveď v podobe web stránky. Ale ak chceš niečo poslať, potrebuješ mať nejaký obsah. A Django je to, čo ti ten obsah pomôže vytvoriť.
+
+## Čo sa stane, ak niekto požiada web stránku z tvojho servera?
+
+Keď na webový server príde žiadosť, tá je preposlaná do Djanga, ktoré sa pokúsi zistiť, čoho sa vlastne žiadosť týka. Najprv si zoberie adresu webstránky a zisťuje, čo má urobiť. Túto časť vykonáva Django **urlresolver** (všimni si, že adresa webstránku sa nazýva - Uniform Resource Locator - URL, takže názov *urlresolver* dáva zmysel). Nie je to žiadna veda - zoberie zoznam vzorov (patterns) a porovnáva ich s URL. Django overuje vzory od vrchu smerom dolu a ak nájde zhodu, pošle žiadosť príslušnej funkcii (ktorá sa nazýva *view* - pohľad).
+
+Predstav si poštárku s listom. Kráča ulicou a porovnáva čísla domov s číslom na liste. Ak sa zhoduje, nechá tam list. Takto funguje urlresolver!
+
+Vo funkcii *view* sa dejú všetky zaujímavé veci: môžeme sa pozrieť do databázy a vyhľadať nejaké informácie. Čo ak užívateľ požiada o zmenu v údajoch? Napríklad listom, v ktorom je žiadosť "Prosím, zmeňte popis mojej práce." *view* overí, či máš oprávnenie na túto zmenu, potom aktualizuje popis tvojej práce a naspäť pošle správu: "Hotovo!". Následne *view* vygeneruje odpoveď a Django ho pošle do uživateľovho prehliadača.
+
+Samozrejme, vyššie uvedený popis je trochu zjednodušený, ale zatiaľ ešte nepotrebuješ vedieť všetky technické detaily. Pre všeobecnú predstavu to však stačí.
+
+Takže namiesto zložitého študovania detailov, jednoducho začneme v Djangu niečo vytvárať a všetky dôležité veci sa naučíme popri tom!
\ No newline at end of file
diff --git a/sk-SK/django_admin/README.md b/sk-SK/django_admin/README.md
new file mode 100644
index 00000000000..efdd0e2ce56
--- /dev/null
+++ b/sk-SK/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+Na pridávanie, editovanie a mazanie postov, ktoré sme práve namodelovali, budeme používať Django admina.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Ako vidíš, importujeme model Post definovaný v predchádzajúcej kapitole. Aby bol náš model viditeľný na adminskej stránke, musíme ho zaregistrovať pomocou `admin.site.register(Post)`.
+
+OK, je čas pozrieť sa na náš Post model. Nezabudni v konzole spustiť web server pomocou príkazu `python manage.py runserver`. V prehliadači zadaj adresu http://127.0.0.1:8000/admin/. Zobrazí sa ti takáto prihlasovacia stránka:
+
+![Prihlasovacia stránka](images/login_page2.png)
+
+Pre prihlásenie musíš vytvoriť *superusera* - užívateľa, ktorý má kontrolu nad všetkým na stránke. Vráť sa do príkazového riadku, napíš `python manage.py createsuperuser` a stlač enter.
+
+> Ak chceš zadať viac príkazov, kým web server beží, otvor nové okno terminálu a aktivuj svoj virtualenv. Ako písať príkazy sme si povedali v kapitole **Tvoj prvý Django projekt!** v odstavci **Spustenie webového serveru**.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Po výzve zadaj svoje meno (malé písmená, bez medzier), emailovú adresu a heslo. **Netráp sa, že nevidíš heslo ktoré zadávaš - tak to má byť.** Len ho zadaj a stlač `enter`. Výstup by mal vyzerať asi takto (kde užívateľské meno a email by mali byť tvoje vlastné):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Vráť sa do prehliadača. Prihlás sa zvolenými údajmi ako superuser, mala by sa ti zobraziť nástenka (dashboard) Django admina.
+
+![Django admin](images/django_admin3.png)
+
+Choď do kategórie Posts a experimentuj trocha. Pridaj 5 alebo 6 blog postov. Netráp sa s obsahom - je viditeľný len pre teba na tvojom lokálnom počítači - môžeš skopírovať nejaký text z tohto tutoriálu aby si ušetril čas. :)
+
+Uisti sa, že aspoň dva alebo tri posty (ale nie všetky) majú nastavený dátum publikovania. Bude to neskôr užitočné.
+
+![Django admin](images/edit_post3.png)
+
+Ak chceš vedieť viac o Django admine, pozri si dokumentáciu Djanga: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Teraz je asi vhodný čas dať si kávu (alebo čaj), alebo niečo pod zub a nabrať trochu energie. Práve si vytvorila svoj prvý Django model - zaslúžiš si trochu oddychu!
\ No newline at end of file
diff --git a/sk-SK/django_forms/README.md b/sk-SK/django_forms/README.md
new file mode 100644
index 00000000000..af3df80d1fe
--- /dev/null
+++ b/sk-SK/django_forms/README.md
@@ -0,0 +1,479 @@
+# Formuláre Django
+
+Posledná vec, ktorú chceme urobiť na našej web stránke je vytvoriť príjemný spôsob pridávania a úpravy blog postov. Django `admin` je v pohode, ale ťažko sa prispôsobuje a upravuje do krajšej podoby. Pomocou `formulárov` budeme mať absolútnu moc nad naším rozhraním - môžeme urobiť takmer čokoľvek, čo si vieme predstaviť!
+
+Na Django formulároch je fajn, že ich môžeme vytvoriť úplne od nuly alebo vytvoriť `ModelForm`, ktorý uloží výsledok formulára do modelu.
+
+A toto je presne to, čo chceme urobiť: vytvoríme formulár pre náš `Post` model.
+
+Tak ako všetky ostatné dôležité časti Djanga, formuláre majú svoj vlastný súbor: `forms.py`.
+
+Musíme vytvoriť súbor s týmto názvom v adresári `blog`.
+
+    blog
+       └── forms.py
+    
+
+OK, otvorme ho v editore a napíšme nasledovný kód:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Najskôr musíme naimportovať Django formuláre (`from django import forms`) a samozrejme aj náš `Post` model (`from .models import Post`).
+
+`PostForm`, ako asi správne predpokladáš, je názov nášho formulára. Musíme Djangu povedať, že tento formulár je `ModelForm` (aby Django pre nás mohlo trochu čarovať) - za to je zodpovedný `forms.ModelForm`.
+
+Ďalej máme `triedu Meta`, kde Djangu povieme, ktorý model by mal byť použitý na vytvorenie tohto formulára (`model = Post`).
+
+Nakoniec môžeme Djangu povedať, ktoré formuláre budú v našom formulári. V tomto scenári, chceme aby boli zobrazené iba `title` (nadpis) a `text` - `author` by mala byť aktuálne prihlásená osoba (teda ty!) a dátum vytvorenia `created_date` by mal byť automaticky nastavený pri vytvorení postu (t.j. v kóde), však?
+
+To je všetko! Jediné, čo treba teraz urobiť, je použiť formulár v *zobrazení* (angl. view) a zobraziť ho v šablóne.
+
+Takže ešte raz vytvoríme link na stránku, URL, zobrazenie a šablónu.
+
+## Link na stránku s formulárom
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## view post_new
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Šablóna
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* Musíme zobraziť formulár. Môžeme to urobiť (napríklad) pomocou {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Potrebujeme tlačidlo `Uložiť`. Vytvoríme ho ako HTML tlačidlo: `<button type="submit">Uložiť</button>`.
+* A nakoniec, hneď za otváracím tagom `<form ...>` musíme pridať `{% raw %}{% csrf_token %}{% endraw %}`. Toto je veľmi dôležité, vďaka tomu je formulár bezpečný! Ak si na to zabudla, Django sa bude sťažovať keď sa pokúsiš uložiť formulár:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Uloženie formuláru
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Validácia formuláru
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Úprava formuláru
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Bezpečnosť
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Ešte jedna vec: čas nasadiť aplikáciu!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Potom v [konzole PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/sk-SK/django_installation/README.md b/sk-SK/django_installation/README.md
new file mode 100644
index 00000000000..173fc3db932
--- /dev/null
+++ b/sk-SK/django_installation/README.md
@@ -0,0 +1,7 @@
+# Inštalácia Django
+
+> **Poznámka:** Ak používate Chromebook, preskočte túto kapitolu a postupujte podľa pokynov na [nastavenie Chromebooku](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/sk-SK/django_installation/instructions.md b/sk-SK/django_installation/instructions.md
new file mode 100644
index 00000000000..bf6d1a54b05
--- /dev/null
+++ b/sk-SK/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Časť tejto kapitoly je založené na tutorialoch Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Časť tejto kapitoly je založená na [django-marcador tutorial](http://django-marcador.keimlink.de/) licencovanej pod medzinárodnou licenciou Creative Commons Attribution-ShareAlike 4.0. Tutoriál django-marcador je autorsky chránený Markusom Zapke-Gründemannom et al.
+
+## Virtuálne prostredie
+
+Skôr ako nainštalujeme Django, nainštalujeme si extrémne užitočný nástroj, ktorý ti pomôže udržiavať poriadok pri programovaní na tvojom počítači. Je možné tento krok preskočiť, no veľmi ho odporúčame. Začať s najlepším možným nastavením ti ušetrí kopec problémov v budúcnosti!
+
+Takže poďme vytvoriť **virtuálne prostredie** (alebo aj *virtualenv*). Virtualenv oddelí nastavenia Python/Django pre každý projekt zvlášť. To znamená, že zmeny, ktoré urobíš na jednej web stránke, neovplyvnia iné stránky, ktoré vyvíjaš. Šikovné, však?
+
+Jediné, čo musíš urobiť je nájsť adresár, v ktorom chceš `virtualenv` vytvoriť, napríklad tvoj domovský adresár. Vo Windowse by mohol vyzerať napríklad `C:\Users\Meno` (kde `Meno` predstavuje tvoj login).
+
+> **POZNÁMKA:** Vo Windowse, sa uisti, že tento adresár neobsahuje špeciálne znaky, alebo znaky s diakritikou; ak tvoje uživateľské meno obsahuje znaky s diakritikou, použi iný adresár, napr. `C:\djangogirls`.
+
+V tomto tutoriale budeme používať nový adresár `djangogirls` v tvojom domovskom adresári:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Vytvoríme virtualenv s názvom `myenv`. Všeobecný príkaz má takýto formát:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Ak chceš vytvoriť nové `virtualenv`, musíš otvoriť príkazový riadok a spustiť `python -m venv myvenv`. Bude to vyzerať takto:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+`myvenv` je názov tvojho `virtualenv`-u. Môžeš použiť aj iný názov, ale používaj malé písmená a žiadne medzery, diakritiku alebo špeciálne znaky. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Vytvoriť `virtualenv` na Linuxe a OS X vyžaduje iba jednoduché spustenie `python3 -m venv myvenv`. Bude to vyzerať takto:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` je názov tvojho `virtualenv`-u. Môžeš použiť aj iný názov, ale ostaň pri malých písmenách a nepoužívaj medzery. Je tiež dorbé použiť krátky názov, pretože naň budeš často odkazovať!
+
+> **POZNÁMKA:** Niektoréverzie systému Debian/Ubuntu môžu zobraziť nasledujúcu chybu:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> V tomto prípade postupuj podľa pokynov uvedených vyššie a nainštaluj si balík `python3-venv`: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **POZNÁMKA:** V niektorých verziách Debian/Ubuntu inicializovanie virtuálneho prostredia týmto spôsobom vráti nasledovnú chybu:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Obídeme to týmto príkazom `virtualenv`-u.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **POZNÁMKA:** Ak sa ti objaví chybu ako
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> potom namiesto toho spusti:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Práca s virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Virtuálne prostredie spusti príkazom:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Meno\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. V tomto prípade, otvor ďalší Windows PowerShell s možnosťou "Spustiť ako správca". Potom skús spustiť nasledovný príkaz predtým ako aktivuj svoje virtualenv:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/sk-SK/django_models/README.md b/sk-SK/django_models/README.md
new file mode 100644
index 00000000000..e43f14d69e2
--- /dev/null
+++ b/sk-SK/django_models/README.md
@@ -0,0 +1,206 @@
+# Django modely
+
+Teraz pôjdeme vytvoriť niečo, čo bude uchovávať naše príspevky v blogu. Aby sme to vedeli spraviť, musíme si najskôr povedať niečo o `objektoch`.
+
+## Objekty
+
+V programovaní sa používa pojem `objektovo orientované programovanie`. Myšlienka spočíva v tom, že namiesto vypisovania nudných sekvencií programátorských príkazov môžeme veci modelovať a definovať ako majú navzájom komunikovať.
+
+Takže čo je to objekt? Je to zbierka vlastností a akcií. Znie to čudne, ale ukážeme si príklad.
+
+Ak chceme namodelovať mačku, vytvoríme objekt `Macka`, ktorá má nejaké vlastnosti, napríklad: `farba`, `vek`, `nalada` (t. j. dobrá, zlá, ospalá ;)), a `majitel` (ktorý je objektom `Osoba` alebo možno v prípade túlavej mačky bude táto vlastnosť prázdna).
+
+Ďalej má `Macka` niekoľko akcií: `priast`, `skrabat` alebo `krmit` (v ktorej dáme mačke nejaké `MacacieZradlo`, ktoré by mohlo byť samostatným objektom s vlastnosťami, t. j. `chut`).
+
+    Macka
+    --------
+    farba
+    vek
+    nalada
+    majitel
+    priast()
+    skrabat()
+    krmit(mac_zradlo)
+    
+    
+    MacacieZradlo
+    --------
+    chut
+    
+
+    MacacieZradlo
+    --------
+    chut
+    
+
+Takže v podstate myšlienka je popísať reálne veci kódom pomocou vlastností (ktorým hovoríme `vlastnosti objektu/object properties`) a akcií (tie nazývame `metódy`).
+
+Ako teda budeme modelovať blog post? Chceme predsa vytvoriť blog, nie?
+
+Musíme odpovedať na otázku: Čo je vlastne blog post? Aké vlastnosti by mal mať?
+
+No, náš blog post určite potrebuje nejaký text s obsahom a titulkom, nie? Bolo by tiež fajn vedieť, kto ho napísal - takže potrebujeme autora. A nakoniec, chceme vedieť, kedy bol post vytvorený a zverejnený.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Čo všetko môžeme s blog postom robiť? Bolo by dobré mať nejakú `metódu`, ktorá post publikuje, však?
+
+Takže budeme potrebovať metódu `publish`.
+
+Keďže už vieme, čo chceme dosiahnuť, začnime tvoriť model v Djangu!
+
+## Django model
+
+Keďže už vieme, čo je objekt, môžeme vytvoriť Django model pre náš blog post.
+
+Model v Djangu je špeciálny typ objektu - je uložený v `databáze`. Databáza je súbor údajov. Je to miesto, kde budeš ukladať informácie o užívateľoch, príspevkoch na blogu, atď. Na ukladanie údajov budeme používať databázu SQLite. Je to štandardný východzí databázový adaptér v Djangu -- nateraz nám bude stačiť.
+
+Model v databáze si môžeš predstaviť ako tabuľku so stĺpcami (polia) a riadkami (dáta).
+
+### Vytvorenie aplikácie
+
+Aby sme mali všetko pekne upratané, vytvoríme vo vnútri nášho projektu samostatnú aplikáciu. Je dobré mať všetko zorganizované hneď od začiatku. Aby sme vytvorili aplikáciu, musíš v konzole spustiť nasledujúci príkaz (v adresári `djangogirls`, kde sa nachádza súbor `manage.py`):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Uvidíš, že pribudne nový adresár `blog`, ktorý obsahuje množstvo súborov. Adresáre a súbory v našom projekte by mali vyzerať takto:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+Po vytvorení aplikácie tiež musíš Djangu povedať, že ju má použiť. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. Takže výsledok nášho snaženia bude vyzerať takto:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Vytvorenie modelu blog postu
+
+V súbore `blog/models.py` definujeme všetky objekty, ktoré sa nazývajú `modely` - na tomto mieste definujeme náš blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Dvakrát skontroluj, či si použila 2 podčiarkovníky (`_`) na oboch stranách `str`. Táto konvencia sa v Pythone často používa a niekedy sa tomu hovorí "dunder" (skratka pre anglické Double-UNDERscore).
+
+Vyzerá to strašidelne, nie? Ale neboj sa, vysvetlíme si, čo tieto riadky znamenajú!
+
+Všetky riadky začínajúce s `from` alebo `import` pridávajú časti z iných súborov. Takže namiesto kopírovania rovnakých vecí v každom súbore môžeme zahrnúť niektoré časti pomocou `from ... import ...`.
+
+`class Post(models.Model):` - tento riadok definuje náš model (je to `objekt`).
+
+- `class` je špeciálne kľúčové slovo, ktoré naznačuje, že definujeme objekt.
+- `Post` je meno nášho modelu. Môžeme mu dať iný názov (ale musíme sa vyhnúť špeciálnym a prázdnym znakom). Názov triedy vždy začni písmenami.
+- `models.Model` znamená, že Post je Django Model, takže Django vie, že by mal byť uložený v databáze.
+
+Teraz zadefinujeme vlastnosti, o ktorých sme hovorili: `title` (titulka), `text`, `created_date` (dátum vytvorenia), `published_date` (dátum zverejnenia) a `author` (autor). Na to ale musíme zadefinovať typ každého poľa (Je to text? Číslo? Dátum? Vzťah k inému objektu, napr. objektu User?)
+
+- `modely. CharField` - takto môžeš definovať text s obmedzeným počtom znakov.
+- `models.TextField` - toto je pre dlhé texty bez obmedzenia. To znie ideálne pre blogový príspevok, nie?
+- `models.DateTimeField` - dátum a čas.
+- `models.ForeignKey` - odkaz na iný model.
+
+Nebudeme si tu vysvetľovať každý kúsok kódu, pretože by to zabralo príliš veľa času. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+A čo `def publish(self):`? To je presne tá metóda `publish`, o ktorej sme hovorili predtým. `def` znamená, že ide o funkciu/metódu a `publish` je názov metódy. Názov metódy môžeš zmeniť, ak chceš. Pravidlo pre názvy metód je, že používame malé písmená a podčiarkovníky namiesto medzier. Napríklad metóda, ktorá vypočíta priemernú cenu by sa mohla nazývať `pocitaj_priemernu_cenu`.
+
+Metódy často niečo vracajú (angl. `return`). Príklad nájdeš napríklad v metóde `__str__`. V tomto prípade, keď zavoláme `__str__()`, dostaneme text (**string**) s názvom postu.
+
+Tiež si všimni, že `def publish(self):` a `def __str__(self):` sú odsadené vo vnútri našej triedy. Pretože Python je citlivý na medzery, musíme odsadiť naše metódy vo vnútri triedy. Inak metódy nebudú patriť do triedy, a môže dojsť k neočakávanému správaniu.
+
+Ak čokoľvek nie je jasné, neváhaj a spýtaj sa mentora/ku! Je nám jasné, že je to komplikované, najmä ak sa učíš, čo sú objekty a funkcie súčasne. Ale dúfame, že teraz už to vyzerá trochu menej magicky!
+
+### Vytváranie tabuliek pre modely v databáze
+
+Posledným krokom je pridať náš nový model do databázy. Najprv musíme Djangu dať vedieť, že sme urobili nejaké zmeny v našom modeli. (Práve sme ho vytvorili!) Choď do konzoly a zadaj `python manage.py makemigrations blog`. Bude to vyzerať takto:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Poznámka:** Nezabudni uložiť súbory ktoré upravuješ. Inak počítač spustí starú verziu, ktorá môže skončiť chybou.
+
+Django pripravil migračný súbor, ktorý musíme aplikovať na našu databázu. Napíš `python manage.py migrate blog` a výstup by mal byť:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurá! Náš Post model je už v databáze! Bolo by fajn ho vidieť, nie? Prejdi na nasledujúcu kapitolu a uvidíš ako vyzerá tvoj Post!
\ No newline at end of file
diff --git a/sk-SK/django_orm/README.md b/sk-SK/django_orm/README.md
new file mode 100644
index 00000000000..98b4d69c8b6
--- /dev/null
+++ b/sk-SK/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM a QuerySety
+
+V tejto kapitole sa naučíš, ako sa Django pripája k databáze a ukladá do nej údaje. Poďme na to!
+
+## Čo je QuerySet?
+
+QuerySet je zoznam objektov daného modelu. QuerySet ti umožňuje čítať dáta z databázy, filtrovať a zoraďovať ich.
+
+Najjednoduchšie bude ukázať si to na príklade. Vyskúšajme si to.
+
+## Django shell (konzola)
+
+Otvor si lokálnu konzolu (nie na PythonAnywhere) a napíš tento príkaz:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Toto by sa ti malo zobraziť:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### Všetky objekty
+
+Skúsme najskôr zobraziť všetky naše príspevky. To sa robí nasledovným príkazom:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Ups! Objavila sa chybová hláška! Hovorí nám, že nič také ako Post (príspevok) neexistuje. To je správne - zabudli sme ho totiž najskôr naimportovať!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+Naimportujeme model `Post` z `blog.models`. Skúsme teda znova zobraziť všetky príspevky:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Je to zoznam príspevkov, ktoré sme už predtým vytvorili! Vytvorili sme ich pomocou Django administrátorského rozhrania. No radi by sme vytvorili nové príspevky pomocou Pythonu, tak ako na to?
+
+### Vytvorenie objektu
+
+Takto vytvoríš nový Post objekt v databáze:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Chýba nám však jedna prísada: `me`. Ako autorku musíme vložiť inštanciu `User` modelu. Ako to urobiť?
+
+Najskôr naimportujme User model:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Akých užívateľov máme v našej databáze? Skús toto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Teraz už konečne môžeme vytvoriť náš prvý príspevok:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurá! Chceš si overiť, či to fungovalo?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Je to tam, jeden príspevok v zozname pribudol!
+
+### Pridaj viac príspevkov
+
+Teraz sa môžeš trochu pobaviť a pridať pár ďalších príspevkov, aby si si vyskúšala ako to funguje. Pridaj dva-tri ďalšie príspevky a potom poďme na ďalšiu časť.
+
+### Filtrovanie objektov
+
+Dôležitou vlastnosťou QuerySetov je možnosť ich filtrovať. Povedzme, že chceme nájsť všetky príspevky, ktorých autorom je užívateľ (User) ola. Použijeme `filter` namiesto `all` v príkaze `Post.objects.all()`. V zátvorkách definujeme jednu alebo viac podmienok, ktoré majú byť splnené príspevkom, aby skončil v tvojom querysete. V našom prípade je to `author`, ktorý sa rovná `me`. V Djangu to napíšeš takto: `author=me`. Náš kúsok kódu bude teraz vyzerať takto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Skúsme vyhľadať všetky príspevky, ktoré obsahujú slovo 'title' v políčku `title`?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Poznámka** Medzi `title` a `contains` sú dva podčiarkovníky (`_`). Django ORM používa túto syntax, aby oddelil názvy polí ("title") a operácie či filtre ("contains"). Ak použiješ iba jeden podčiarkovník, dostaneš chybu "FieldError: Cannot resolve keyword title_contains".
+
+Môžeš tiež získať zoznam všetkých publikovaných postov. To urobíme vyfiltrovaním príspevkov, ktoré majú nastavený `published_date` v minulosti:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Bohužiaľ, príspevok, ktorý sme pridali z konzoly Pythonu, ešte nie je publikovaný. To môžeme zmeniť! Najskôr získaj inštanciu postu, ktorý chceme publikovať:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+A potom ho zverejni pomocou našej metódy `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Teraz skús získať zoznam publikovaných postov znova (stlač šípku hore trikrát a stlač `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Zoradenie objektov
+
+QuerySety tiež umožňujú zoradiť zoznamy objektov. Skúsme ich zoradiť podľa dátumu vytvorenia (pole `created_date`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Poradie môžeme vymeniť pridaním `-` na začiatok:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+To je skutočne silný nástroj, ktorým môžeš písať pomerne komplexné požiadavky (queries).
+
+Super! Teraz si pripravená na ďalšiu časť! Shell zatvoríš príkazom:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/sk-SK/django_start_project/README.md b/sk-SK/django_start_project/README.md
new file mode 100644
index 00000000000..4addc8f828e
--- /dev/null
+++ b/sk-SK/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Tvoj prvý Django projekt!
+
+> Časť tejto kapitoly je založená na tutoriáli Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Časti tejto kapiolty sú založená na [django-marcador tutorial](http://django-marcador.keimlink.de/) pod licenciou Creative Commons Attribution-ShareAlike 4.0 International License. Tutoriál django-marcador je autorsky chránený Markusom Zapke-Gründemannom et al.
+
+Vytvoríme jednoduchý blog!
+
+Prvý krok je vytvoriť nový Django projekt. To v podstate znamená, že spustíme pár skriptov, poskytovaných Djangom, ktoré pre nás vytvoria kostru Django projektu. Je to len pár zložiek a súborov, ktoré použijeme neskôr.
+
+Mená niektorých súborov a zložiek sú pre Django veľmi dôležité. Súbory, ktoré teraz vytvoríme, by si nemala premenovať. Ich presúvanie na iné miesto taktiež nie je dobrý nápad. Django potrebuje udržovať určitú štruktúru, aby bol schopný nájsť dôležité veci.
+
+> Nezabudni všetko spúšťať vo virtualenv. Pokiaľ vo svojej konzole nevidíš prefix `(myvenv)` musíš aktivovať virtualenv. Ako na to bolo vysvetlené v kapitole **Inštalácia Django** v časti **Práca s virtualenv**. Pokiaľ napíšeš `myvenv\Scripts\activate` na Windowsoch, alebo `source myvenv/bin/activate` na Mac OS X alebo Linux, malo by všetko fungovať.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+Vo svojej Mac OS X alebo Linux konzole spusti tento príkaz; **nezabudni pridať bodku `.` na konci**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Bodka `.` je dôležitá, pretože hovorí skriptom, aby nainštalovali Django v tvojej aktuálnej zložke (pre ktorú je bodka `.` skratkou).
+> 
+> **Poznámka** Pri písaní predchádzajúceho príkazu nezabudni, že píšeš len časť, ktorá začína django-admin alebo `django-admin. py`. `(myvenv) ~/djangogirls$` zobrazené tu je len príkladom cesty, kam budeš zadávať svoje príkazy.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Vo Windowse spusti tento príkaz; **nezabudni pridať bodku `.` na konci**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Bodka `.` je dôležitá, pretože hovorí skriptom, aby nainštalovali Django v tvojej aktuálnej zložke (pre ktorú je bodka `.` skratkou).
+> 
+> **Poznámka** Pri písaní predchádzajúceho príkazu nezabudni, že píšeš len časť, ktorá začína `django-admin.exe`. `(myvenv) C:\Users\Name\djangogirls>` zobrazené tu je len príkladom cesty, kam budeš zadávať svoje príkazy.
+
+<!--endsec-->
+
+`django-admin.py` je skript, ktorý pre teba vytvorí zložky a súbory. Momentálne by si mala mať štruktúru adresárov, ktorá vyzerá takto:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Poznámka**: adresárovej štruktúre, uvidíš `venv` adresár, ktorý sme vytvorili.
+
+`manage.py` je skript, ktorý pomáha so správou stránky. Okrem iného budeme vďaka nemu môcť spustiť na našom počítači webový server, bez toho, aby sme inštalovali čokoľvek iné.
+
+Súbor `settings.py` obsahuje konfiguráciu tvojej webovej stránky.
+
+Pamätáš, keď sme rozprávali o doručovateľovi listov, ktorý zisťuje kam doručiť list? `urls.py` obsahuje zoznam vzorov, ktoré používa `urlresolver`.
+
+Zatiaľ ignorujme ostatné súbory, keďže ich teraz aj tak nebudeme meniť. Jediná vec na ktorú netreba zabudnúť je, že ich nesmieš omylom zmazať!
+
+## Zmena nastavení
+
+Spravme pár zmien v `mysite/settings.py`. Otvor súbor v editore kódu, ktorý si si nainštalovala predtým.
+
+**Poznámka**: Pamätaj, že `settings.py` je obyčajný súbor, ako každý iný. Môžeš ho otvoriť z kodového editoru, pomocou "Súbor -> Otvoriť" možnosti v menu. Malo by sa ti zobraziť štandardné okno v ktorom vyhľadáš svoj `settings.py` súbor a označíš ho. Prípadne môžeš ísť do priečinka djangogirls na pracovnej ploche a kliknúť na súbor pravým tlačidlom myši. Potom vyber editor kódu zo zoznamu. Výber editora je dôležitý, pretože môžeš mať nainštalované iné programy, ktoré dokážu tento súbor otvoriť, ale nedovolia ti ho upravovať.
+
+Bolo by dobré mať na našej stránke správny čas. Choď na [zoznam časových pásiem na wikipedii](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) a skopíruj svoje časové pásmo (napr. `Europe/Berlin`).
+
+V súbore `settings.py`, nájdi riadok, ktorý obsahuje `TIME_ZONE` a uprav ho tak, aby obsahoval tvoje časové pásmo. Napríklad:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. Potom bude tlačidlo "Cancel" preložené do jazyka, ktorý tu definuješ. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Budeme tiež musieť pridať cestu pre statické súbory. (Dozvieme sa všetko o statických súboroch a CSS neskôr v tutoriále.) Prejdi na *koniec* súboru a pod `STATIC_URL` riadkom, pridaj ďalší s názvom `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Keď `DEBUG` je `True` a `ALLOWED_HOSTS` je prázdne, host je overovaný vôči `['localhost', '127.0.0.1', '[::1]']`. Toto sa nebude zhodovať s naším hostname na PythonAnywhere, keď nasadíme našu aplikáciu, kvôli tomu zmeníme nasledovné nastavenie:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Poznámka**: Ak používaš Chromebook, pridaj nasledovný riadok na koniec settings.py súboru: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Nastavenie databázy
+
+Existuje veľa rôznych databázových softvérov, ktoré umožňujú ukladať údaje pre tvoje web stránky. My budeme používať predvolenú databázu - `sqlite3`.
+
+Tá je už nastavená v tejto časti súboru `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Databázu pre náš blog vytvoríme spustením tohto príkazu v konzole: `python manage.py migrate` (musíme byť v adresári `djangogirls`, ktorý obsahuje súbor `manage.py`). Ak všetko prešlo dobre, mala by si vidieť niečo takéto:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+A je to! Teraz treba spustiť webový server a uvidíme či je naša web stránka funkčná!
+
+## Spustenie webového servera
+
+Musíš sa nachádzať v adresári, v ktorom sa nachádza súbor `manage.py` (adresár `djangogirls`). V konzole spustíme webový server zadaním `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Ak používaš Chromebook, použi nasledovný príkaz:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> Ako webový server funguje sme si povedali v kapitole **Ako funguje Internet**.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/sk-SK/django_templates/README.md b/sk-SK/django_templates/README.md
new file mode 100644
index 00000000000..39e70ae8b50
--- /dev/null
+++ b/sk-SK/django_templates/README.md
@@ -0,0 +1,108 @@
+# Šablóny Django
+
+Je na čase zobraziť nejaké údaje! Na to nám Django ponúka užitočné vstavané **šablónové tagy**.
+
+## Čo sú to šablónové tagy?
+
+V HTML vlastne nemôžeš písať Pythonský kód, pretože prehliadače mu nerozumejú. Poznajú len HTML. Vieme, že HTML je skôr statické, kým Python je oveľa dynamickejší.
+
+**Šablónové tagy v Djangu** nám umožňujú previesť Pythonovské veci do HTML, takže dynamické webové stránky môžeš vytvoriť rýchlejšie. Paráda!
+
+## Zobraz šablónu so zoznamom príspevkov
+
+V predchádzajúcej kapitole sme našej šablóne dali zoznam príspevkov v premennej `posts`. Teraz to zobrazíme v HTML.
+
+Na vypísanie premennej v Django šablónach použijeme dvojitú zloženú zátvorku s názvom premennej vo vnútri, asi takto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Vyskúšaj to vo svojej šablóne `blog/templates/blog/post_list.html`. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Ulož súbor a obnov stránku, aby si videla výsledky:
+
+![Obrázok 13.1](images/step1.png)
+
+Ako vidíš, dostali sme len toto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+To znamená, že to Django chápe ako zoznam objektov. Pamätáš si z kapitoly **Úvod do Pythonu** ako môžeme zobraziť zoznamy? Áno, cyklami! V Django šablóne ich urobíš takto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Vyskúšaj si to vo svojej šablóne.
+
+![Obrázok 13.2](images/step2.png)
+
+Funguje to! Ale my chceme, aby sa príspevky zobrazili ako tie statické, ktoré sme vytvorili predtým v kapitole **Úvod do HTML**. Môžeš skombinovať HTML a šablónové tagy. Naše `body` bude vyzerať takto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Všetko, čo dáš medzi `{% for %}` a `{% endfor %}` sa bude opakovať pre každý objekt v zozname. Obnov svoju stránku:{% endraw %}
+
+![Obrázok 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? Pristupujeme k údajom v každom z polí definovanom v našom `Post` modeli. Okrem toho `|linebreaks` preposiela texty príspevkov cez filter, ktorý konvertuje zalomenie riadkov na odstavce.
+
+## Ešte jedna vec
+
+Bolo by fajn vidieť či bude tvoja web stránka stále funkčná aj na Internete, však? Skúsme to znova nasadiť na PythonAnywhere. Tu je rekapitulácia postupu…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Potom sa prihlás do [PythonAnywhere](https://www.pythonanywhere.com/consoles/) a choď do **Bash konzoly** (alebo spusti novú) a zadaj:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/sk-SK/django_urls/README.md b/sk-SK/django_urls/README.md
new file mode 100644
index 00000000000..98208b8360e
--- /dev/null
+++ b/sk-SK/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URL
+
+Chystáme sa vytvoriť našu prvú webovú stránku: domovská stránka tvojho blogu! Ale ešte predtým sa poďme naučiť niečo o Django URL.
+
+## Čo je URL?
+
+A URL is a web address. URL si môžeš všimnúť zakaždým, keď navštíviš webovú stránku - vidno ju v prehliadači. (Áno! `127.0.0.1:8000` je URL! A `https://djangogirls.org` je tiež URL.)
+
+![URL](images/url.png)
+
+Každá stránka na internete potrebuje svoju vlastnú URL. Týmto spôsobom aplikácia vie, čo by mala ukázať užívateľovi, ktorý otvorí URL. V Djangu používame takzvaný `URLconf` (URL konfigurácia). URLconf je súbor vzorov, ktoré sa Django pokúsi priradiť podľa prijatej URL, aby tak našiel správne zobrazenie.
+
+## Ako fungujú URL v Djangu?
+
+Otvorme súbor `mysite/urls.py` v editore kódu a pozrime sa, ako vyzerá:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Ako vidíš, Django sem už pre nás niečo umiestnil.
+
+Riadky medzi trojitými uvodzovkami (`'''` or `"""`) sa nazývajú docstringy - môžeš ich pridať na začiatku suboru, triedy, alebo metódy aby si popísala čo robí. Python ich nespustí.
+
+Adminovská URL, ktorú si navštívila v predchádzajúcej kapitole je už tu:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Tento riadok znamená, že pre každú URL, ktorá začína na `admin` Django nájde zodpovedajúce *zobrazenie (view)*. V tomto prípade pridávame množstvo adminovských URL, takže to nie je všetko natlačené v jednom malom súbore -- je to čitateľnejšie a čistejšie.
+
+## Tvoja prvá Django URL!
+
+Je čas vytvoriť našu prvú URL! Chceme, aby 'http://127.0.0.1:8000/' bola domovská stránka nášho blogu a zobrazovala zoznam príspevkov.
+
+Tiež chceme udržiavať súbor `mysite/urls.py` čistý, takže naimportujeme URL z našej aplikácie `blog` do hlavného súboru `mysite/urls.py`.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Súbor `mysite/urls.py` by mal teraz vyzerať takto:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django teraz presmeruje všetko, čo prichádza na 'http://127.0.0.1:8000/' do `blog.urls` a tam bude hľadať ďalšie inštrukcie.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Tu iba importujeme Django metódu `path` a všetky naše `views` z aplikácie `blog` (zatiaľ žiadne nemáme, ale k tomu sa o chvíľu dostaneme!)
+
+Potom môžeme pridať náš prvý URL vzor:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+Posledná časť `name='post_list'` je názov URL, ktorý sa použije na identifikáciu zobrazenia. Názov URL môže byť rovnaký ako názov view, ale pokojne to môže byť aj niečo úplne iné. Neskôr budeme v projekte používať pomenované URL, takže je dôležité pomenovať všetky URL v aplikácii. Názvy by mali byť unikátne a ľahké na zapamätanie.
+
+Ak sa teraz pokúsiš navštiviť http://127.0.0.1:8000/ uvidíš správu, že stránka nie je dostupná ('web page not available'). Toto je z toho dôvodu že server (spomínaš si keď si spúšťala `runserver`?) už nebeží. Pozri sa na konzolu svojho serveru, aby si zistila prečo.
+
+![Chyba](images/error1.png)
+
+Konzola zobrazuje chybu, ale neboj sa - je to pomerne užitočné: hovorí ti, že neexistuje atribút post_list (**no attribute 'post_list'**). To je názov *view*, ktorý sa Django pokúša nájsť a použiť, ale sme ho ešte nevytvorili. V tejto fáze `/admin/` tiež nefunguje. Žiadne obavy, aj k tomu sa dostaneme. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/sk-SK/django_views/README.md b/sk-SK/django_views/README.md
new file mode 100644
index 00000000000..5aa3d461411
--- /dev/null
+++ b/sk-SK/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views - čas tvoriť!
+
+Je čas zbaviť sa toho bugu, čo sme vytvorili v poslednej kapitole! :)
+
+*View* je miesto, kam dávame "logiku" našej aplikácie. Bude požadovať informáciu z `modelu`, ktorý si už vytvorila a pošle to do `šablóny`. Šablónu (template) budeme vytvárať v nasledujúcej kapitole. Views sú vlastne len metódy Pythonu, ktoré sú trochu zložitejšie, ako tie, ktoré sme písali v kapitole **Úvod do Pythonu**.
+
+Views sú umiestnené v súbore `views.py`. Naše *views* budeme pridávať do súboru `blog/views.py`.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Je tu toho málo zatiaľ.
+
+Ako si spomínaš riadky začínajúce s `#` sú komentáre - to znamená, že ich Python nespustí.
+
+Vytvorme *view* ako nám komentár naznačuje. Pridaj nasledovný minimálny view pod komentárom:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Ulož súbor a prejdi na http://127.0.0.1:8000 / a pozri sa, čo sa udeje.
+
+Ďalšia chyba! Prečítaj si, o čo ide tentokrát:
+
+![Chyba](images/error.png)
+
+Ukazuje, že server aspoň znovu beží, ale stále to nie je ono, že? Neboj sa, je to len chybová stránka, nič čoho sa treba báť! Podobne ako chyby v konzole, sú vlastne velkom úťitočné. Dočítaš sa, že *TemplateDoesNotExist*. Poďme opraviť túto chybu a vytvoríme šablónu v nasledujúcej kapitole!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/sk-SK/dynamic_data_in_templates/README.md b/sk-SK/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..269c711ab79
--- /dev/null
+++ b/sk-SK/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamické dáta v šablónach
+
+Máme rozdielne kúsky na svojom mieste: `Post` model je definovaný v `models.py`, máme `post_list` v `views.py` a pridanú šablónu. Ale ako prinútime HTML šablónu, aby zobrazovala náš príspevok? Pretože to je to, čo chceme urobiť - vziať nejaký obsah (modely uložené v databáze) a zobraziť ich pekne v našej šablóne, že?
+
+To je presne to, čo majú *views* robiť: spojiť modely a šablóny. V našom `post_list` *view* potrebujeme vziať modely ktoré chceme zobraziť a posunúť ich do šablóny. Takže sa rozhodneme vo *view* čo (model) bude zobrazené v šablóne.
+
+Dobre, takže ako toto dosiahneme?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Pamätáš si, keď sme rozprávali o zahrnutí kódu napísanom v rozdielnych súboroch? Teraz nastal čas kedy musíme zahrnúť model, ktorý sme napísali v `models.py`. Pridáme tento riadok `from .models import Post` takto:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+Bodka za `from` znamená *aktuálna zložka* alebo *aktuálna aplikácia*. `views.py` aj `models.py` sú v rovnakom adresári. To znamená, že môžeme použiť `.` a názov súboru (bez `.py`). Potom importujeme názov modelu (`Post`).
+
+Ale čo ďalej? Na to aby sme boli schopní vziať konkrétny príspevok blogu z `Post` modelu potrebujeme niečo, čo sa volá `QuerySet`.
+
+## QuerySet
+
+Už by si mala vedieť ako funguje QuerySets. Hovorili sme o tom v kapitole [Django ORM (QuerySets)](../django_orm/README.md).
+
+Takže teraz chceme zoznam príspevkov, ktoré sú uverejnené a zoradené podľa `published_date`, však? To sme už spravili v kapitole QuerySets!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Vezmi prosím na vedomie, že vytvárame *premennú* pre náš QuerySet: `posts`. Považuj to za meno nášho QuerySetu. Odteraz ho môžeme referovať pod týmto menom.
+
+V `render` funkcii už máme jeden parameter `request` (všetko čo príjmeme od užívateľa cez Internet) a ďalší ktorý poskytuje súbor šablóny `'blog/post_list.html'`). Posledný parameter, `{}` je miesto na ktoré môžeme dať nejaké veci ktoré môže použiť šablóna. Potrebujeme im dať mená (zatiaľ sa budeme držať `'posts'`). :) Malo by to vyzerať takto: `{'posts': posts}`. Všimni si, že časť pred `:` je reťazec: potrebuješ ju obaliť do úvodzoviek:`"`.
+
+Nakoniec by náš súbor `blog/views.py` mal vyzerať takto:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+To je všetko! Čas prejsť na našu šablónu a zobraziť tento QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/sk-SK/extend_your_application/README.md b/sk-SK/extend_your_application/README.md
new file mode 100644
index 00000000000..aa3c15a84c8
--- /dev/null
+++ b/sk-SK/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Ako rozšíriť aplikáciu
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Čas na precvičovanie!
+
+Prvá vec, ktorú potrebujeme na našom blogu je, aby stránka zobrazila jeden príspevok, však?
+
+Už máme `Post` model, takže nepotrebujeme do `models.py` pridávať nič iné.
+
+## Vytvorenie šablóny odkazu na post detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}Chceme, aby link z titulku príspevku smeroval na stránku detailov príspevku. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Je na čase vysvetliť záhadné `{% url 'post_detail' pk=post.pk %}`. Ako možno tušíš, `{% %}` notácia znamená, že používame tagy Django šablóny. Tentoraz použijeme jeden, ktorý pre nás vytvorí URL!{% endraw %}
+
+`post_detail` časť znamená, že Django bude očakávať URL v `blog/urls.py` s name=post_detail
+
+A čo s `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Teraz keď pôjdeme na: http://127.0.0.1:8000/ uvidíme chybu (ako sa dá očakávať, keďže ešte nemáme URL alebo *view* pre `post_detail`). Bude to vyzerať takto:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Vytvor URL na detail príspevku
+
+Vytvorme URL v `urls.py` pre náš `post_detail` *view*!
+
+Chceme, aby sa detaily nášho prvého príspevku zobrazili na tomto **URL**: http://127.0.0.1:8000/post/1/
+
+Vytvorme URL v súbore `blog/urls.py` tak, aby odkazoval Django na *view* nazvaný `post_detail`, ktorý zobrazí celý príspevok blogu. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+To znamená, že ak zadáš `http://127.0.0.1:8000/post/5/` do svojho prehliadača, Django pochopí, že hľadáš *view* s názvom `post_detail` a prenesie informácie z `pk` rovné `5` do toho *view*.
+
+OK, pridali sme nový URL vzor `blog/urls.py`! Poďme obnoviť stránku: http://127.0.0.1:8000 / Boom! Server znova prestal bežať. Pozri sa do konzoly - ako sa aj dalo očakávať je tam ďalšia chyba!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Pridaj view do detailu príspevku
+
+Tentokrát má náš *view* extra parameter, `pk`. Náš *view* ho potrebuje zachytiť, však? Takže definujeme našu funkciu ako `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Teraz chceme aby sme dostali jeden a len jeden príspevok blogu. Na to môžeme použiť querysets takto:
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Ale tento kód má problém. Pokiaľ tu nie je žiaden `Post` s daným `primárnym kľúčom`(`pk`) budeme mať veľmi škaredú chybu!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+To nechceme! But luckily Django comes with something that will handle that for us: `get_object_or_404`. V príade, že neexistuje žiaden `Post` s daným `pk` zobrazí oveľa krajšiu stránku, `Page Not Found 404`.
+
+![Stránka nenájdená](images/404_2.png)
+
+Dobrá správa je, že si môžeš vytvoriť svoju vlastnú `Page not found` stránku a spraviť ju tak peknú ako len chceš. Ale to nie je momentálne príliš dôležité, takže to preskočíme.
+
+Dobre, čas pridať *view* do nášho `views.py` súboru!
+
+V `blog/urls.py` sme vytvorili URL pravidlo s názvom `post_detail`, ktoré odkazuje na zobrazenie s názvom `views.post_detail`. To znamená, že Django očakáva zobrazovaciu funkciu s názvom `post_detail` v súbore `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+A na konci súboru pridáme náš *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Áno. Nastal čas obnoviť stránku: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+Funguje to! Ale čo sa stane, keď klikneš na odkaz v názve príspevku blogu?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Ale nie! Ďalšia chyba! Ale už vieme, s čim mám dočinenia, že? Potrebujeme pridať šablónu!
+
+## Vytvor šablónu pre detaily príspevku
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Znova raz rozširujeme `base.html`. V bloku `content` chceme zobraziť published_date príspevku (pokiaľ existuje), titulok a text. Ale mali by sme prebrať pár dôležitých vecí, však?
+
+{% raw %}`{% if ... %} ... {% endif %}` je tag šablóny, ktorý môžeme použiť ak chceme niečo skontrolovať. (Pamätáš si `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+Dobre, môžeme obnoviť našu stránku a pozrieť sa, či `TemplateDoesNotExist` zmizlo.
+
+![Post detail page](images/post_detail2.png)
+
+Jupí! Funguje to!
+
+# Je čas nasadiť!
+
+Bolo by dobré vedieť, či tvoja stránka stále funguje na PythonAnywhere, však? Pokúsme sa ju znova nasadiť.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Potom v [Bash konzole PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Aktualizovanie statických súborov na serveri
+
+Servre ako PythonAnywhere sa ku "statickým súborom" (ako CSS súbory) správajú inak ako ku Python súborom, lebo ich môžu optimalizovať, aby ich bolo možné rýchlejšie načítať. Kvôli tomu, keď meníme naše CSS súbory, musíme spustiť ďalší príkaz na servri aby ich akutalizoval. Názov príkazu je `collectstatic`.
+
+Začni spustením virtualenvu, ak už nie je aktívny (PythonAnywhere používa príkaz `workon`, je to presne ako `source myenv/bin/activate` príkaz, ktorý si použila na vlastnom počítači):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+`manage.py collectstatic` príkaz sa trochu podobá na `manage.py migrate`. Urobíme zmeny v našom kóde a potom povieme Django, aby aplikoval (*apply*) tie zmeny, buď na statické súbory na servri, alebo do databázy.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/sk-SK/how_the_internet_works/README.md b/sk-SK/how_the_internet_works/README.md
new file mode 100644
index 00000000000..2403ab1b3c5
--- /dev/null
+++ b/sk-SK/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Ako funguje Internet
+
+> Pre čitateľov doma: Táto kapitola je spracovaná v [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) videu.
+> 
+> Táto kapitola je inšpirovaná prednáškou "Ako funguje Internet" od Jessicy McKellar (http://web.mit.edu/jesstess/www/).
+
+Stavíme sa, že Internet používaš každý deň. Ale vieš, čo sa deje, keď napíšeš adresu, ako https://djangogirls.org do prehliadača a stlačíš `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Webové prehliadače sú navrhnuté na to, aby rozumeli kódu, nasledovali jeho inštrukcie a prezentovali súbory, ktoré tvoria tvoju webovú stránku presne tak, ako to chceš.
+
+Ako s každým súborom, potrebujeme uložiť HTML súbor niekde na pevnom disku. V prípade Interntu používame špeciálne, výkonné počítače nazývane *servery*. Nemajú obrazovku, myš alebo klávesnicu, pretože ich hlavnou úlohou je ukladať dáta a poskytovať ich. Preto ich voláme *serveri* -- pretože *poskytujú* (anglicky serve) tvoje dáta.
+
+OK, avšak chceš vedieť, ako vyzerá Internet, že?
+
+Nakreslili sme ti obrázok! Vyzerá takto:
+
+![Obrázok 1.1](images/internet_1.png)
+
+Vyzerá to ako neporiadok, že? V skutočnosti je to sieť prepojených strojov (hore spomenutých *serverov*). Stoviek a tisícok strojov! Mnoho, mnoho kilometrov káblov po celom svete! Môžeš navštíviť stránku Submarine Cable Map (http://submarinecablemap.com) aby si videla nakoľko komplikovaná sieť to je. Tu je obrázok zo stránky:
+
+![Obrázok 1.2](images/internet_3.png)
+
+Nie je to fascinujúce? But it is not possible to have a wire between every machine connected to the Internet. Takže na to, aby sme boli schopní kontaktovať stroj (napríklad ten na ktorom je uložená stránka https://djangogirls.org) musíme poslať žiadosť cez mnoho, mnoho rozdielnych strojov.
+
+Vyzerá to takto:
+
+![Obrázok 1.3](images/internet_2.png)
+
+Predstav si, že keď napíšeš https://djangogirls.org, pošleš list, v ktorom stojí: "Drahé Django Girls, chcem vidieť stránku djangogirls.org. Prosím pošli mi ju!"
+
+Tvoj list ide na najbližšiu poštu. Potom ide na ďalšiu, ktorá je o čosi bližšie adresátovi, potom na ďalšiu a ďalšiu až kým nedorazí do svojej destinácie. Jediná unikátna vec je, že ako pošleš mnoho listov (*data paketov*) na rovnaké miesto, môžu ísť cez úplne odlišné pošty (*routy*). Záleží to na tom, ako sú distribuované na každej pošte.
+
+![Obrázok 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Namiesto adries s menom ulice, mesta, PSČ a krajinou používame IP adresy. Tvoj počítač sa najprv opýta DNS (Domain Name System) aby preložil djangogirls.org na IP adresu. Funguje to trocha ako staré dobré telefónne zoznamy, kde si môžeš vyhľadať meno osoby ktorú chceš kontaktovať a nájsť jej telefón a adresu.
+
+Keď pošleš list, musí mať určité náležitosti, aby ho bolo možné správne doručiť: adresu, známku atď. Taktiež používaš jazyk, ktorému adresát rozumie, že? Rovnako to funguje aj s *data paketmi* ktoré pošleš aby sa ti zobrazila stránka. Používame protokol s názvom HTTP (Hypertext Transfer Protocol).
+
+Takže, v podstate, keď máš webovú stránku, musíš mať *server* (stroj) na ktorom bude žiť. Keď *server* obdrží prichádzajúcu *požiadavku* (v liste), pošle naspäť tvoju webovú stránku (v ďalšom liste).
+
+Keďže toto je Django tutoriál, spýtaš sa, čo robí Django. Keď pošleš odpoveď, nechceš vždy poslať rovnaké veci každému. Je oveľa lepšie ak sú tvoje listy osobné, hlavne pre osobu, ktorá ti práve teraz napísala, že? Django ti pomáha vytvoriť tieto osobné, zaujímavé listy. :)
+
+Dosť bolo rečí, je čas tvoriť!
\ No newline at end of file
diff --git a/sk-SK/html/README.md b/sk-SK/html/README.md
new file mode 100644
index 00000000000..e1b7273be49
--- /dev/null
+++ b/sk-SK/html/README.md
@@ -0,0 +1,227 @@
+# Úvod do HTML
+
+Môžno sa pýtaš, čo jej šablóna?
+
+Šablóna je súbor, ktorý môžeme znova opakovane použiť, aby sme prezentovali nové informácie v konzistentnom formáte - šablónu môžeš použiť napríklad ako pomôcku pri písaní listu, pretože aj napriek tomu, že každý list môže obsahovať rozdielnu správu a byť adresovaný inej osobe, bude mať rovnaký formát.
+
+Formát Django šablóny je popísaný v jazyku nazývanom HTML (to je to HTML, ktoré sme spomenuli v prvej kapitole **Ako funguje Internet**).
+
+## Čo je HTML?
+
+HTML je kód, ktorý je interpretovaný tvojím webovým prehliadačom - ako napríklad Chrome, Firefox alebo Safari - aby tak zobrazil užívateľom webové stránky.
+
+HTML znamená "HyperText Markup Language". **HyperText** znamená, že sa jedná o typ textu, ktorý podporuje hypertextové odkazy medzi stránkami. **Markup** znamená, že sme vzali dokument a označili ho kódom aby sme niečomu povedali (v tomto prípade prehliadaču) ako interpretovať stránku. HTML kód je budovaný pomocou **tagov**, ktoré začínajú znakom `<` a končia znakom `>`. Tieto tagy reprezentujú značkovacie (Markup) **elementy**.
+
+## Tvoja prvá šablóna!
+
+Vytvorenie šablóny znamená vytvorenie súboru šablóny. Všetko je súbor, však? To si si asi už všimla.
+
+Šablóny sú uložené v zložke `blog/templates/blog`. Takže najprv vytvor v zložke blogu zložku s názvom `templates`. Potom vytvor ďalšiu zložku s názvom `blog` v zložke templates:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+A teraz vytvor súbor `post_list.html` (zatiaľ ho ponechaj prázdny) v zložke `blog/templates/blog`.
+
+Pozri sa, ako momentálne vyzerá tvoja stránka: http://127.0.0.1:8000/
+
+> Pokiaľ stále vidíš chybu `TemplateDoesNotExist`, skús vyreštartovať svoj server. Choď do príkazového riadku, zastav server stlačením Ctrl+C (stlač naraz tlačidlá Control a C) a spusti ho znova pomocou príkazu `python manage.py runserver`.
+
+![Obrázok 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+Takže ako momentálne vyzerá tvoja stránka? To môžeš zistiť kliknutím na: http://127.0.0.1:8000/
+
+![Obrázok 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head a body
+
+Každá HTML stránka je taktiež rozdelená do dvoch elementov: **head** a **body**.
+
+* **head** je element, ktorý obsahuje informácie o dokumente, ktoré nie sú zobrazené na obrazovke.
+
+* **body** je element, ktorý obsahuje všetko ostatné zobrazené ako časť webovej stránky.
+
+`<head>` používame, aby sme povedali prehliadaču o konfigurácii stránky a `<body>` aby sme mu povedali, čo na stránke je.
+
+Napríklad môžeš dať stránke titulok pomocou title elementu v hlavičke `<head>` takto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Ulož súbor a znova načítaj svoju stránku.
+
+![Obrázok 11.3](images/step4.png)
+
+Všimni si ako prehliadač rozumie, že "Ola's blog" je titulok tvojej stránky? Interpretuje `<title>Ola's blog</title>` a vkladá text ako názov záložky (tento názov bude použitý aj keď si stránku uložíš do záložky a tak ďalej).
+
+Pravdepodobne si taktiež všimneš, že každý začínajúci tag má svoj *uzatvárajúci tag* obsahujúci `/`, a že elementy sú *vnorené* (tj. nemôžeš daný tag zatvoriť, kým nie sú taktiež zatvorené všetky tagy, ktoré sú v jeho vnútri).
+
+Je to ako vkladať veci do krabice. Máš jednú veľkú krabicu, `<html></html>`; vo vnútri je `<body></body>`, a tá obsahuje menšie krabice: `<p></p>`.
+
+Musíš dodržovať pravidlá *uzatvárania* tagov a *vnorenia* elementov - pokiaľ ich nebudeš dodržovať, prehliadač nemusí správne interpretovať tagy a tvoja stránka bude zobrazená nesprávne.
+
+## Uprav svoju šablónu
+
+Môžeš sa trocha pohrať s tým, že budeš upravovať svoju šablónu! Tu je zopár užitočných tagov:
+
+* `<h1>Hlavný nádpis</h1>` - pre tvoj najdôležitejší nádpis
+* `<h2>Podnádpis</h2>` pre nádpis na nižšej úrovni
+* `<h3>Pod-podnádpis</h3>`.. a tak ďalej až do `<h6>`
+* `<p>Odsek textu</p>`
+* `<em>text</em>` zdôrazňuje tvoj text
+* `<strong>text</strong>` zvýrazňuje tvoj text o čosi viac
+* `<br>` vkladá nový riadok (do br nemôžeš nič vložiť a nemá uzatvárací tag)
+* `<a href="https://djangogirls.org">link</a>` vytvára odkaz
+* `<ul><li>prvá položka</li><li>druhá položka</li></ul>` vytvára zoznam ako tento!
+* `<div></div>` definuje sekciu stránky
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Tu je príklad úplnej šablóny, skopíruj ho do súboru `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Výsledok je nasledovný:
+
+![Obrázok 11.4](images/step6.png)
+
+Jupí! Ale zatiaľ naša šablóna zobrazila len presne **rovnaké informácie** - kým pred chvíľou sme hovorili, že nám šablóny dovoľujú zobrazovať **rozdielne** informácie v **rovnakom formáte**.
+
+To čo v skutočnosti chceme spraviť je zobraziť reálne príspevky pridané v Django admin rozhraní - a to je to, čo teraz spravíme.
+
+## Ešte jedna vec: nasaďte to!
+
+Bolo by skvelé, ak by sme všetky tieto veci mohli vidieť naživo na Internete, že? Spravme ďalšie PythonAnywhere nasadenie:
+
+### Commit, and push your code up to GitHub
+
+Najprv sa pozrime, ktoré súbory sa zmenili od posledného nasadenia (tieto príkazy spusti lokálne, nie na PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Uisti sa, že si v zložke `djangogirls` a následne povedzme `gitu` nech zahrnie všetky zmeny v zložke:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Predtým, ako nahráme všetky súbory, skontrolujme čo bude `git` nahrávať (všetky súbory, ktoré `git` nahrá by teraz mali byť zelené):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Už sme skoro tam, teraz nastal čas mu povedať, aby uložil tieto zmeny v jeho histórii. Dáme mu "commit správu", kde popíšeme, čo sme zmenili. V tomto štádiu môžeš napísať čokoľvek, čo chceš, ale je nápomocné napísať čosi, čo je popisné natoľko, že si budeš v budúcnosti pamätať, čo si spravila.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Zmeny v HTML pre stránku."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Po tom, čo sme to dokončili, nahráme (push) naše zmeny na Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Stiahni svoj kód na PythonAnywhere a obnov svoju webovú aplikáciu
+
+* Otvor [konzolovú stránku PythonAnywhere](https://www.pythonanywhere.com/consoles/) a prejdi do svojej **Bash konzoly** (alebo naštartuj novú). Potom zadaj:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Aktualizácia by mala prebehnuť a zmeny by mali byť dostupne v živej verzii! Obnov svoju stránku v prehliadači. Zmeny by mali byť viditeľné. :)
\ No newline at end of file
diff --git a/sk-SK/installation/README.md b/sk-SK/installation/README.md
new file mode 100644
index 00000000000..6d030284fd9
--- /dev/null
+++ b/sk-SK/installation/README.md
@@ -0,0 +1,68 @@
+# Pokiaľ robíš tutoriál doma
+
+Pokiaľ robíš tento tutoriál doma, nie na jednej z [Django Girls akcií](https://djangogirls.org/events/), môžeš úplne preskočiť túto kapitolu a pokračovať rovno na kapitolu [Ako funguje Internet](../how_the_internet_works/README.md).
+
+Je to preto, lebo v tutoriále sa zaoberáme inštaláciou vecí, ktoré sú potrebné - to je len ďalšia stránka, ktorá zhromažďuje všetky pokyny na inštaláciu na jednom mieste (čo je užitočné pre niektoré formáty workshopov). Môžete nainštalovať všetko, čo je na tejto stránke práve teraz, ak si budete priať. Ale pokiaľ sa chceš začať učiť predtým, ako si nainštaluješ množstvo vecí na svoj počítač, preskoč túto kapitolu a my ti vysvetlíme inštalačnú časť neskôr keď to budeš potrebovať.
+
+Veľa šťastia!
+
+# Ak ste sa zúčastňuješ workshopu
+
+Ak si sa zúčastnila jedného [Django girls stretnutia](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Prejdite na adresu [ GitHub.com ](https://www.github.com) a zaregistrujte si nový bezplatný používateľský účet. Nezabudnite si heslo zapamätať (ak používate správcu hesiel, pridajte si ho tam).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Začni si čítať
+
+Gratulujeme, si pripravená začať! Pokiaľ máš stále zvyšný čas pred začiatkom workshopu, bolo by užitočné, ak by si si prečítala pár začiatočníckych kapitol:
+
+* [Ako funguje Internet](../how_the_internet_works/README.md)
+
+* [Úvod do príkazového riadku](../intro_to_command_line/README.md)
+
+* [Úvod do jazyka Python](../python_introduction/README.md)
+
+* [Čo je Django?](../django/README.md)
+
+# Uži si workshop!
+
+Keď začne workshop, budeš môcť prejsť priamo na [Tvoj prvý Django projekt!](../django_start_project/README.md), lebo si už absolvovala látku v predchádzajucích kapitol.
\ No newline at end of file
diff --git a/sk-SK/intro_to_command_line/README.md b/sk-SK/intro_to_command_line/README.md
new file mode 100644
index 00000000000..ed5abc16274
--- /dev/null
+++ b/sk-SK/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Úvod do rozhrania príkazového riadku
+
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) videu.
+
+Je to vzrušujúce, však? Už o pár minút napíšeš svoj prvý riadok kódu! :)
+
+**Dovoľ nám predstaviť ti tvojho nového priateľa: príkazový riadok!**
+
+Nasledujúce kroky ti ukážu ako používať tú čiernu obrzovku, čo používajú všetci hackeri. Zo začiatku môže vyzerať trochu desivo, ale je to naozaj len riadok, čo čaká na tvoje príkazy.
+
+> **Poznámka** Prosím všimni si, že v knižke používame výrazy 'adresár' aj 'zložka' zameniteľne, no ich význam je rovnaký.
+
+## Čo je to príkazový riadok?
+
+Okno, ktoré sa zvyčajne nazýva **príkazový riadok** alebo **rozhranie príkazového riadku** je textová aplikácia na prehliadanie, spracovanie a manipuláciu so súbormi v tvojom počítači. V podstate je to ako Prieskumník vo Windowse alebo Finder na Macu, akurát bez grafického rozhrania. Ďalšie názvy pre príkazový riadok môžu byť: *cmd*, *CLI*, *prompt*, *konzola* alebo *terminál*.
+
+## Otvor rozhranie príkazového riadku
+
+Aby sme mohli trochu experimentovať, musíme najskôr rozhranie príkazového riadku otvoriť.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Príkazový riadok
+
+Teraz by si už mala vidieť biele alebo čierne okno, ktoré čaká na tvoje príkazy.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Ak si na Macu alebo Linuxe, zrejme uvidíš `$`, presne takto:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Tvoj prvý príkaz (Hurá!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Základy
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Aktuálny adresár
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Zmena aktuálneho adresára
+
+Teraz prejdime do adresára Plochy:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Riešenie:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Zhrnutie
+
+Here is a summary of some useful commands:
+
+| Príkaz (Windows) | Príkaz (Mac OS / Linux) | Popis                           | Príklad                                            |
+| ---------------- | ----------------------- | ------------------------------- | -------------------------------------------------- |
+| exit             | exit                    | zatvorí okno                    | **exit**                                           |
+| cd               | cd                      | zmení adresár                   | **cd test**                                        |
+| cd               | pwd                     | ukáž akutuálny adresár          | **cd** (Windows) alebo **pwd** (Mac OS / Linux)    |
+| dir              | ls                      | vypíše zoznam adresárov/súborov | **dir**                                            |
+| copy             | cp                      | kopíruje súbor                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move             | mv                      | presunie súbor                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir            | mkdir                   | vytvorí nový adresár            | **mkdir testdirectory**                            |
+| rmdir (or del)   | rm                      | vymazať súbor                   | **del c:\test\test.txt**                         |
+| rmdir /S         | rm -r                   | odstráni adresár/súbor          | **rm -r testdirectory**                            |
+| [CMD] /?         | man [CMD]               | get help for a command          | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Pripravená?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/sk-SK/intro_to_command_line/open_instructions.md b/sk-SK/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..d183810a4aa
--- /dev/null
+++ b/sk-SK/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+V závislosti od vašej verzie systému Windows a klávesnice, jedna z týchto možností by mala otvoriť príkazové okno (budete musieť trochu experimentovať, ale nemusíte vyskúšať všetky tieto návrhy):
+
+- Prejdite do ponuky Štart alebo obrazovky a do poľa Hľadať zadajte "Príkazový riadok".
+- Prejdite na Štart menu → Systém Windows → Príkazový riadok.
+- Choď na menu Štart → Všetky programy → Príslušenstvo → Príkazový riadok.
+- Prejdite na domovskú obrazovku, umiestnite kurzor myši v ľavom dolnom rohu obrazovky a kliknite na šípku nadol, ktorá sa zobrazí (na dotykovej obrazovke, rýchlymi pohybmi prsta nahor z dolnej časti obrazovky). Zoznam aplikácii by sa mal zobraziť. Kliknite na príkazový riadok v časti systému Windows.
+- Podržte špeciálnu klávesu Windows na klávesnici a stlačte klávesu "X". Výber "Príkazový riadok" z kontextového menu.
+- Podržte klávesu Windows a stlačte tlačidlo "R" sa zobrazí okno "Run". Zadajte "cmd" do poľa a kliknite na tlačidlo OK.
+
+![Zadaj "cmd" v "Run" okne](../python_installation/images/windows-plus-r.png)
+
+Ďalej v tomto tutoriále, budete musieť mať dva príkazové okná otvorené súčasne. Avšak v niektorých verziách systému Windows, ak už máte otvorené jedno okno príkazového riadku a pokúsite sa otvoriť druhé pomocou rovnakej metódy, to spôsobí zobrazenie príkazového okna, ktoré už máte otvorené. Skúste to teraz na vašom počítači a uvidíte, čo sa stane! Ak sa zobrazí len jedno príkazové okno, skúste jeden z ďalších postupov v zozname vyššie. Aspoň jeden z nich by mať za následok otvorenie nového príkazového okna.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Choď do Aplikácie → Nástroje → Terminál.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Je to pravdepodobne aplikácie → Príslušenstvo → terminál, alebo aplikácie → systém → terminál, ale to môže závisieť na vašom systéme. Ak to tam nie je, môžete sa pokúsiť to vyhladať na Google. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sk-SK/python_installation/README.md b/sk-SK/python_installation/README.md
new file mode 100644
index 00000000000..0dbd3cf6ace
--- /dev/null
+++ b/sk-SK/python_installation/README.md
@@ -0,0 +1,15 @@
+# Začnime s Pythonom
+
+Konečne sme tu!
+
+Na začiatok si povedzme, čo je Python. Python je veľmi obľúbený programovací jazyk, ktorý možno využiť na vytváranie webstránok, hier, vedeckých programov, grafiky a veľa, veľa ďalšieho.
+
+Python vznikol koncom 80-tych rokov minulého storočia a jeho hlavným cieľom bola čitateľnosť pre ľudí (nie len pre stroje!). Toto je dôvod, prečo vyzerá jednoduchšie, než ostatné programovacie jazyky, ale netráp sa - napriek tomu Python je naozaj silný!
+
+# Inštalácia Pythonu
+
+> **Poznámka:** Ak používaš Chromebook, preskoč túto kapitolu a postupuj podľa pokynov na [inštaláciu na Chromebookoch](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/sk-SK/python_installation/instructions.md b/sk-SK/python_installation/instructions.md
new file mode 100644
index 00000000000..ed44842ffff
--- /dev/null
+++ b/sk-SK/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) videu.
+> 
+> Táto časť je založená na príručke Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django je napísaný v jazyku Python. Python potrebujeme na všetko, čo chceme robiť v Djangu. Začnime teda s inštaláciou! Chceme, aby si si nainštalovala Python 3,, takže ak máš staršiu verziu, budeš ju musieť upgradovať. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Stlač klávesu Windows a klávesu Pause/Break v rovnakom čase
+* Otvor v ovládacom paneli v ponuke Windows, potom prejdi do Systém a Zabezpečenia, potom Systém
+* Stlačte tlačidlo Windows a potom prejdite na položku Nastavenia > Systém > Informácie
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Stiahni si súbor s *Mac OS X 64/32-bitovým inštalátorom*,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/sk-SK/python_introduction/README.md b/sk-SK/python_introduction/README.md
new file mode 100644
index 00000000000..9e72f6989be
--- /dev/null
+++ b/sk-SK/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Úvod do jazyka Python
+
+> Časť tejto kapitoly je založená na tutoriáli Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Poďme napísať nejaký kód!
+
+## Python prompt
+
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) videu.
+
+Aby sme mohli začať s Pythonom, musíte otvoriť *príkazový riadok* (angl. command line) na svojom počítači. Už by ste mali vedieť ako sa to robí -- naučili ste sa to v [ Úvode do príkazového riadku](../intro_to_command_line/README.md).
+
+Ak ste hotoví, pokračujte s inštrukciami nižšie.
+
+Chceme otvoriť Python konzolu, takže napíšte `python` na Windowse alebo `python3` na Mac OS alebo Linux a stlačte `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Váš prvý príkaz v Pythone!
+
+Po spustení príkazu Python sa prompt zmenil na `>>>`. Pre nás to znamená, že odteraz by sme mali písať príkazy iba v jazyku Python. Nemusíte písať `>>>` - Python to urobí pre Vás.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Potom už nebudete vidieť toto: `>>>`.
+
+Zatiaľ nechceme opustiť Python konzolu. Chceme sa o nej dozvedieť viac. Začnime tým, že skúsime matematiku, napr. ` 2 + 3 `a stlač `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Super! Vidíte ako vyskočilo riešenie? Python vie počítať! Môžete skúsiť aj ďalšie príkazy, ako:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Aby sme vypočítali mocninu, povedzme 2 na tretiu, zadáme: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Pobavte sa s tým trošku, potom sa vráťte späť . :)
+
+Ako vidíte, Python je dobrá kalkulačka. A ak ste zvedaví, čo všetko ešte vie…
+
+## Reťazce ("Stringy")
+
+Čo tak tvoje meno? Napíš svoje meno v úvodzovkách:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" 
+"Ola"
+```
+
+Práve si vytvorila svoj prvý reťazec! Je postupnosť znakov, ktoré môžu byť spracované počítačom. Reťazec musí vždy začínať a končíť s rovnakým znakom. Sú to jednoduché (`'`) alebo dvojité (`"`) úvodzovky (nie je medzi nimi žiadny rozdiel!). Úvodzovky naznačujú, že to čo je medzi nimi je reťazec (string).
+
+Reťazce možno spájať dohromady. Skús toto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ahoj" + "Ola" 
+'Ahoj Ola'
+```
+
+Reťazce môžete násobiť aj s číslom:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3 
+'OlaOlaOla'
+```
+
+Ak potrebujete dať apostrof do vnútra reťazca, máte dva spôsoby, ako to urobiť.
+
+Použitím dvojitých úvodzoviek:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill" 
+"Runnin' down the hill"
+```
+
+alebo pomocou spätného lomítka - tento znak (ak je napísaný pred úvodzovkou) povie, že ona je súčasťou reťazca a nie koniec / začiatok reťazca (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill' 
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper() 
+'OLA'
+```
+
+Práve si použila `upper` **metódu** na reťazci! Metóda (ako `upper()`) je postupnosť inštrukcií, ktoré Python vykonáva na danom objekte (`"Ola"`), potom, čo ju zavoláš.
+
+Ak chcete poznať počet písmen, ktoré sú obsiahnuté vo vašom mene, tak na to má Python **funkciu** tiež!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola") 
+3
+```
+
+Ste zvedaví, prečo voláme niekedy funkciu s bodkou (`.`) na konci reťazca (ako `"Ola".upper()`) a niekedy najprv voláme funkciu a reťazec vložíme do zátvoriek? V niektorých prípadoch funkcie patria k objektom, ako napr. `upper()`, čo môže byt vykonaná len na reťazcoch. V takomto prípade sa tieto funkcie volajú **metódy**. Inokedy funkcie nepatria k žiadnemu konkrétnemu objektu a môžu byť použité na rôzne typy objektov, rovnako ako `len()`. Preto zadáme `"Ola"` ako parameter pre funkciu `len`.
+
+### Zhrnutie
+
+OK, dosť už reťazcoch. Zatiaľ ste sa naučili o:
+
+- **prompt** - píšeme príkazy (kód) do Python promptu, z čoho dostaneme výsledky zase v jazyku Python
+- **čísla a reťazce** - v Pythone sú čísla použité pre počítanie a reťazce pre textové objekty
+- **operátory** - ako `+` alebo `*`, z daných hodnôt vyrobia novú hodnotu
+- **funkcie** - napr. `upper()` alebo `len()`, vykonávajú činnosti na objektoch.
+
+Toto sú základy každého programovacieho jazyka. Ste pripravení na niečo ťažšie? Stavíme sa, že áno!
+
+## Chyby
+
+Teraz skúsme niečo nové. Je možné zistiť dĺžku nejakého čísla rovnako ako sme to robili s našim menom? Napíšte `len(304023)` a stlačte `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Funguje to! Použili sme funkciu `str` vo vnútri funkcie `len`. Funkcia `str()` prevedie všetko na reťazce.
+
+- Funkcia `str` prevedie (konvertuje) všetko na **reťazce** (angl. string)
+- Funkcia `int` prevedie všetko na **int** (celé čísla)
+
+> Dôležité: je možné konvertovať čísla na reťazce, ale opačne sa to nedá vždy - inak čo by bolo napr. `int('hello')`?
+
+## Premenné
+
+Veľmi dôležitý pojem v programovaní je pojem premennej. Premenná je nič iné ako názov niečoho, čo môžeme použiť aj neskoršie v programe. Programátori používajú premenné aby v nich ukladali dáta, aby ich zdrojový kód bol prehľadnejší a aby nemuseli všetko držať v hlave.
+
+Povedzme, že chceme vytvoriť novú premennú s názvom `meno`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> meno = "Ola"
+```
+
+Zadáme meno sa rovná Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> meno
+'Ola'
+```
+
+Hurá! Vaša prvá premenná! :) Vždy je možné zmeniť jej obsah:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> meno = "Sonja"
+>>> meno
+'Sonja'
+```
+
+Môžete ju použiť aj vo funkciách:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(meno)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Ale čo by sa stalo, keby sme použili zlý názov? Uhádnete, čo sa stane? Skúsme!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> mesto = "Tokyo"
+>>> mseto
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'mseto' is not defined
+```
+
+Chyba! Ako vidíte, Python má viacero chýb a táto jedna sa volá **NameError**. Python vám hodí túto chybu ak sa pokúsite použiť premennú ktorá ešte nebola definovaná. Ak sa stretnete s touto chybou v budúcnosti, vždy skontrolujte svoj kód, či nemáte preklep v niektorom názve.
+
+Bavte sa s tým trošku, a potom uvidíme čo môžeme ešte urobiť!
+
+## Funkcia print
+
+Vyskúšajte toto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> meno = 'Maria'
+>>> meno
+'Maria'
+>>> print(meno)
+Maria
+```
+
+Ak zadáte len `meno`, Python interpreter odpovie reťazcovou *reprezentáciou* premennej 'meno', teda písmenami M-a-r-i-a medzi jednoduchými úvodzovkami, ''. Keď napíšete `print(meno)`, Python vypíše obsah premennej na obrazovku, bez úvodzoviek, čo vyzerá krajšie.
+
+Ako uvidíme neskôr, funkcia `print()` je tiež užitočná, keď chceme tlačiť veci z funkcií, alebo ak chceme tlačiť veci na viacerých riadkoch.
+
+## Zoznamy
+
+Okrem reťazcov a celých čísel, má Python všetky možné typy objektov. Teraz sa zoznámime s typom, ktorý sa volá **zoznam** (list). Zoznamy sú presne to, čo si myslíte, že sú: objekty, ktoré sú zoznamami iných objektov. :)
+
+Poďme na to, vytvorte zoznam:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Áno, tento zoznam je prázdny. Nie veľmi užitočné, však? Vytvorme zoznam s číslami lotérie. Nechceme sa dokola opakovať, takže ho hneď aj priradíme do premennej:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> loteria = [3, 42, 12, 19, 30, 59]
+```
+
+OK, máme zoznam! Čo s ním môžeme urobiť? Pozrime sa, koľko čísel lotérie máme v zozname. Máte predstavu, ktorú funkciu by sme mohli použiť? Toto už predsa viete!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(loteria)
+6
+```
+
+Áno! `len()` vám vráti počet objektov v zozname. Šikovné, nie? Možno by sme to teraz mohli usporiadať:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> loteria.sort()
+```
+
+Nič nám to nevrátilo, iba sa zmenilo poradie poradie, v ktorom sa čísla zobrazia v zozname. Vytlačme to znova a pozrime sa, čo sa stalo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(loteria)
+[3, 12, 19, 30, 42, 59]
+```
+
+Ako vidíte, čísla vo vašom zozname sú teraz zoradené od najnižšej po najvyššiu hodnotu. Gratulujeme!
+
+Chceli by sme otočiť poradie? Urobme to!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> loteria.reverse()
+>>> print(loteria)
+[59, 42, 30, 19, 12, 3]
+```
+
+Ak chceš pridať niečo do svojho zoznamu, môžeš to urobiť zadaním tohto príkazu:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> loteria.append(199)
+>>> print(loteria)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Ak chcete zobraziť iba prvé číslo, môžete to urobiť pomocou **indexov**. Index je číslo, ktoré hovorí, kde v zozname sa položka nachádza. Programátori radi počítajú od nuly, takž eprvý objekt vo vašom zozname je na indexe 0, ďalší je na 1 a tak ďalej. Vyskúšajte toto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(loteria[0])
+59
+>>> print(loteria[1])
+42
+```
+
+Ako vidíte, k rôznym objektom vo vašom zozname môžete pristupovať použitím názvu zoznamu a indexom objektu v hranatých zátvorkách.
+
+Aby ste odstránili niečo zo svojho zoznamu, budete potrebovať **indexy**, ako sme sa dozvedeli vyššie a príkaz `pop()`. Vyskúšajme to na príklade a zopakujme si, čo sme sa už naučili; zmažeme prvé číslo v našom zozname.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(loteria)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(loteria[0])
+59
+>>> loteria.pop(0)
+59
+>>> print(loteria)
+[42, 30, 19, 12, 3, 199]
+```
+
+Funguje to ako hodinky!
+
+Pre zábavu vyskúšajte aj nejaké iné indexy: 6, 7, 1000, -1, -6 alebo -1000. Skúste predpovedať výsledok predtým ako príkaz použijete. Dávajú výsledky zmysel?
+
+Zoznam všetkých dostupných metód pre zoznamy v tejto kapitole dokumentácie Pythonu: https://docs.python.org/3/tutorial/datastructures.html
+
+## Slovníky
+
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) videu.
+
+Slovník je podobný ako zoznam, ale k jeho hodnotám pristupujete vyhľadaním kľúča namiesto číselného indexu. Kľúč môže byť akýkoľvek reťazec alebo číslo. Syntax na definovanie prázdneho slovníka je:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+To znamená, že ste práve vytvorili prázdny slovník. Hurá!
+
+Teraz skúste napísať nasledujúci príkaz (skúste ale nahradiť hodnoty vlastnými údajmi):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ucastnicka = {'meno': 'Ola', 'krajina': 'Slovensko', 'oblubene_cisla': [7, 42, 92]}
+```
+
+Týmto príkazom ste práve vytvorili premennú s názvom `ucastnicka` s tromi pármi kľúč-hodnota:
+
+- Kľúč `meno` odkazuje na hodnotu `"Ola"` (objekt typu `reťazec/string`),
+- `krajina` odkazuje na `"Slovensko"` (ďalší `reťazec`),
+- a `oblubene_cisla` smeruje na `[7, 42, 92]` (`zoznam` s tromi číslami).
+
+Obsah jednotlivých kľúčov môžete skontrolovať touto syntaxou:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(ucastnicka['meno'])
+Ola
+```
+
+Ako vidíte, podobá sa to na zoznam. Ale nemusíte si pamätať index - stačí meno.
+
+Čo sa stane ak si od Pythonu vypýtame hodnotu kľúča, ktorý neexistuje? Uhádnete? Vyskúšajme to a uvidíme!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> ucastnicka['vek']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'vek'
+```
+
+Aha, ďalšia chyba! Táto sa volá **KeyError** (chyba kľúča). Python je nápomocný a povie vám, že kľúč `'vek'` v tomto slovníku neexistuje.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Potrebuješ zoradenú postupnosť položiek? Vyber si zoznam (list).
+- Potrebuješ priraďovať hodnoty kľúčovým slovám, aby si si ich mohla efektívne (podľa kľúča) neskôr vyhľadať? Použi slovník (dictionary).
+
+Slovníky, rovnako ako zoznamy sú *premenlivé*, čo znamená, že ich môžeme zmeniť po ich vytvorení. Po vytvorení môžeš do slovníka pridať nové dvojice kľúč/hodnota takto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ucastnicka['oblubeny_jazyk'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(ucastnicka)
+4
+```
+
+Dúfam, že to dáva zmysel. :) Pripravená na trochu zábavy so slovníkmi? Tak šup na ďalší riadok za úžasnými vecami.
+
+Na odstránenie položky zo slovníka môžeš použiť metódu `pop()`. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ucastnicka.pop('oblubene_cisla')
+[7, 42, 92]
+>>> ucastnicka
+{'meno': 'Ola', 'krajina': 'Slovensko', 'oblubeny_jazyk': 'Python'}
+```
+
+Ako vidíš z výstupu, pár kľúč-hodnota zodpovedajúci kľúču 'oblubene_cisla' bol vymazaný.
+
+Taktiež môžeš zmeniť hodnotu priradenú k už vytvorenému kľúču v slovníku. Napíš:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ucastnicka['krajina'] = 'Nemecko'
+>>> ucastnicka
+{'krajina': 'Nemecko', 'oblubeny_jazyk': 'Python', 'meno': 'Ola'}
+```
+
+Ako vidíš, hodnota kľúča `"krajina"` sa zmenila z `"Poľsko"` na `"Nemecko"`. :) Vzrušujúce? Hurá! Práve si sa naučila ďalšiu úžasnú vec.
+
+### Zhrnutie
+
+Skvelé! Teraz už vieš o programovaní dosť veľa. Pozrime sa, čo sme si vysvetlili v poslednej časti:
+
+- **chyby** (angl. error) - teraz už vieš ako čítať a rozumieť chybám, ktoré sa zobrazia, ak Python nerozumie príkazu, ktorý mu zadáš
+- **premenné** - názvy objektov, ktoré ti uľahčujú písanie kódu a robia tiež kód zrozumiteľnejším
+- **zoznamy** (angl. list) - zoznam objektov uložených v určitom poradí
+- **slovníky** (angl. dictionary) - objekty uložené v pároch kľúč-hodnota
+
+Tešíš sa na ďalšiu časť? :)
+
+## Porovnávanie vecí
+
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) videu.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Zaujíma ťa, prečo sme použili dve "rovná sa" `==` vedľa seba, aby sme porovnali, či sú čísla rovnaké? Jeden znak `=` používame na priraďovanie hodnôt premenným. Takže, ak chceš skontrolovať, či sú veci rovnaké, musíš vždy, úplne **vždy** použiť dve `==`. Taktiež môžeme zisťovať, či sa veci navzájom líšia. Na to použijeme symbol `!=`, ako bolo uvedené v príklade vyššie.
+
+Zadaj Pythonu ešte dve úlohy:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+`>` a `<` sme už videli, ale čo znamenajú `>=` a `<=`? Prečítať ich môžeš takto:
+
+- x `>` y znamená: x je väčšie ako y
+- x `<` y znamená: x je menšie ako y
+- x `<=` y znamená: x je menšie alebo sa rovná y
+- x `> =` y znamená: x je väčšie alebo sa rovná y
+
+Skvelé! Chceš vyskúšať ešte jeden? Skús toto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Môžeš dať Pythonu toľko čísel, koľko chceš a on ti dá vždy odpoveď! Vcelku šikovné, nie?
+
+- **and** - ak použiješ operátor `and`, obidve porovnávané veci musia byť pravdivé (True), aby príkaz bol pravdivý (True)
+- **or** - ak použiješ operátor `or`, stačí aby jedna z porovnávaných vecí bola pravdivá, aby bol celý príkaz pravda (True)
+
+Už ste počula výraz "porovnávať hrušky s jablkami"? Skúsme pythonský ekvivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Tu vidíš, že tak ako nevieme porovnávať hrušky s jablkami, ani Python neviem porovnať číslo (`int`) s reťazcom (`str`). Namiesto toho vypíše chybu **TypeError** a povie nám, ktoré dva typy sa nedajú porovnať.
+
+## Logické hodnoty (Boolean)
+
+Mimochodom práve si sa naučila nový typ objektu v Pythone. Volá sa **Boolean**.
+
+Existujú iba dva typy Booleovských objektov:- True (Pravda)- False (Nepravda):
+
+- True
+- False
+
+Aby ich Python spoznal, musíš vždy napísať 'True' (s veľkým písmenom na začiatku a zvyšok malým písmom). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Logické hodnoty môžu byť aj premenné. Aha:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Môžeš to urobiť aj takto:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Precvič si to a zabav sa s logickými premennými - skús spustiť tieto príkazy:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Gratulujeme! Logické hodnoty patria k tomu najužitočnejšiemu z programovania a ty si sa práve naučila, ako sa používajú!
+
+# Ulož to!
+
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) videu.
+
+Zatiaľ sme písali všetok pythonský kód do konzoly interpretera, čiže môžeme na jedenkrát zadať iba jeden riadok kódu. Normálne programy sú uložené v súboroch, ktoré spúšťa buď **interpreter** alebo **kompilátor**. Doteraz sme spúšťali naše programy riadok po riadku v **interpreteri** Pythonu. Na ďalšie úlohy budeme potrebovať viac ako jeden riadok kódu, takže teraz rýchlo musíme:
+
+- Ukončiť interpreter Pythonu
+- Otvoriť si zvolený editor kódu
+- Uložiť v ňom nejaký kód do nového pythonského súboru
+- Spustiť ho!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Tak sa dostaneš späť na príkazový riadok.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Samozrejme, teraz si už vcelku skúsená Python developerka, takže kľudne napíš nejaký kód, ktorý si sa dnes naučila.
+
+Teraz uložíme súbor a dáme mu nejaký zrozumiteľný názov. Nazvime ho **python_intro.py** a ulož ho plochu. Tento súbor môžeš nazvať akokoľvek chceš, ale dôležité je, aby jeho názov končil **.py**. Prípona **.py** nášmu operačnému systému hovorí, že je to **súbor spustiteľný Pythonom** a môže ho spustiť Pythonom.
+
+> **Poznámka** Všimni si jednu z najúžasnejších vecí editorov kódu: farby! V pythonskej konzole bolo všetko napísané jednou farbou, teraz však vidíš, že funkcia `print` je napísaná inou farbou ako reťazec. Toto sa nazýva "zvýraznenie syntaxe" a pri programovaní je to fakt užitočná vec. Farba výrazov ti môže pomôcť, ak máš neuzavretý reťazec či preklep v názve špeciálnych slov (ako napríklad `def` vo funkcii, ktorú uvidíme neskôr). Toto je jedným z dôvodov, prečo používame editor kódu. :)
+
+Súbor máme uložený, je čas ho spustiť! Pomocou poznatkov z kapitoly o príkazovom riadku, pomocou Terminálu **zmeň adresár** na plochu.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Na Macu bude príkaz vyzerať takto:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+Funguje to!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### Čo ak podmienka nie je pravdivá?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 je naozaj viac ako 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Ahoj Ola!')
+elif name == 'Sonja':
+    print('Ahoj Sonja!')
+else:
+    print('Ahoj neznama!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ahoj Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Super, pocujem vsetky detaily
+    
+
+## Komentáre
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Zhrnutie
+
+In the last few exercises you learned about:
+
+- **porovnávať veci** - v Pythone môžeš porovnávať veci pomocou znamienok `>`, `>=`, `==`, `<=`, `<` a operátorov `and`, `or`
+- **Booleovské/logické premenné** - typ objektu, ktorý môže mať len jednu z dvoch hodnôt: `True` (pravda) alebo `False` (nepravda)
+- **Ukladať súbory** - ukladanie kódu v súboroch, takže môžete spúšťať väčšie programy.
+- **if... elif... else** - príkazy, ktoré ti umožňujú spustiť kód, iba ak sú splnené určité podmienky.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Tvoje vlastné funkcie!
+
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) videu.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Ahoj!')
+    print('Ako sa mas?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ahoj!
+    Ako sa mas?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- Ak sa ti zjaví `NameError`, to znamená, že si niečo chybne napísala, takže by si mala overiť, že si použila rovnaké meno, keď si vytvárala pomocou `def hi()` a keď si ju zavolala pomocou `hi()`.
+- Ak sa ti zjaví `IndentationError`, uisti sa, že oba `print` riadky, majú rovnaký počet medzier od začiatku riadku: python vyžaduje aby všetky riadky boli pedatne zarovnané.
+- Ak nevidíš žiaden výstup, tak sa pozri či posledné `hi()` *nie je* odsadené - ak je, ten riadok sa stal súčasťou funkcie a nikdy nedojde k jeho spusteniu.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(meno):
+    if meno == 'Ola':
+        print('Ahoj Ola!')
+    elif meno == 'Sonja':
+        print('Ahoj Sonja!')
+    else:
+        print('Ahoj neznama!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'meno'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ahoj Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ahoj Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Ahoj neznáma!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(meno):
+    print('Ahoj ' + meno + '!')
+
+hi("Katka")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ahoj Katka!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Cykly
+
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) videu.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+dievcata = ['Katka', 'Monika', 'Zuzka', 'Ola', 'Ty']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for meno in dievcata:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(meno):
+    print('Ahoj ' + meno + '!')
+
+dievcata = ['Katka', 'Monika', 'Zuzka', 'Ola', 'Ty']
+for meno in dievcata:
+    hi(meno)
+    print('Dalsie dievca')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ahoj Katka!
+    Dalsie dievca
+    Ahoj Monika!
+    Dalsie dievca
+    Ahoj Zuzka!
+    Dalsie dievca
+    Ahoj Ola!
+    Dalsie dievca
+    Ahoj Ty!
+    Dalsie dievca
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Zhrnutie
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/sk-SK/template_extending/README.md b/sk-SK/template_extending/README.md
new file mode 100644
index 00000000000..113a996dc17
--- /dev/null
+++ b/sk-SK/template_extending/README.md
@@ -0,0 +1,151 @@
+# Rozširovanie šablón
+
+Ďalšia super možnosť, ktorú ti Django ponúka je **rozširovanie šablón**. Znamená to, že môžeš použiť rovnaké časti HTML kódu na rôznych stránkach svojho webu.
+
+Šablóny ti pomôžu, keď chceš použiť rovnaké informácie alebo zobrazenie na viac ako jednom mieste. Nemusíš dokola opakovať to isté. A ak chceš niečo zmeniť, nemusíš to urobiť v každej šablóne, len v jednej!
+
+## Vytvorenie základnej šablóny
+
+Základná šablóna je najzákladnejšia šablóna, ktorú rozširuješ na každej stránke svojej web stránky.
+
+Vytvorme súbor `base.html` v `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Potom v `base.html` nahraď celé `<body>` (všetko medzi `<body>` a `</body>`) týmto:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Možno si si všimla, že toto nahradilo všetko od `{% for post in posts %}` po `{% endfor %}` s: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Ale prečo? Práve si vytvorila `block`! Použila si šablónový tag `{% block %}` aby si vytvoila časť, do ktorej bude vložené HTML. To HTML bude pochádzať z inej šablóny, ktorá rozšíri túto šablónu (`base.html`). Hneď ti ukážeme, ako sa to robí.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}Odstrániš všetko nad `{% for post in posts %}` a pod `{% endfor %}`. Keď skončíš, súbor bude vyzerať nasledovne:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Chceme toto použiť ako súčasť našej šablóny pre všetky bloky. Je čas pridať blokové tagy do tohto súboru!
+
+{% raw %}Blokový tag by sa mal zhodovať s tagom v `base.html` súbore. Taktiež by mal obsahovať celý kód, čo patrí do tvojích obsahových blokov. Aby si to urobila, vlož všetko medzi `{% block content %}` a `{% endblock %}`. Takto:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Ešte zostála len jediná vec. Potrebujeme prepojiť tieto dve šablóny. O tomto je rozširovanie šablón! Urobíme to pridaním extends tagu na začiatku súboru. Nasledovne:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> Ak sa ti zobrazí chyba `TemplateDoesNotExist`, to znamená, že neexistuje `blog/base.html` súbor a `runserver` beží v konzole. Skús ho zastaviť (stlačením Ctrl+C – Control a C tlačidiel spolu) a spusti ho znova pomocou príkazu `python manage.py runserver`.
\ No newline at end of file
diff --git a/sk-SK/whats_next/README.md b/sk-SK/whats_next/README.md
new file mode 100644
index 00000000000..33232915660
--- /dev/null
+++ b/sk-SK/whats_next/README.md
@@ -0,0 +1,43 @@
+# Čo ďalej?
+
+Môžeš si zablahoželať! **Si úplne úžasná**. Sme hrdí! <3
+
+### Čo robiť teraz?
+
+Take a break and relax! You have just done something really huge.
+
+Potom začni sledovať Django Girls na [Facebooku](http://facebook.com/djangogirls) alebo [Twitteri](https://twitter.com/djangogirls) a zostaň informovaná.
+
+### Viete odporučiť ďalšie zdroje?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/sk/README.md b/sk/README.md
index e2f0d550b3f..31b0986e47c 100755
--- a/sk/README.md
+++ b/sk/README.md
@@ -1,48 +1,51 @@
-# Príručka k Django Girls
+# Django Girls Tutoriál
 
-[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
 
 > Toto dielo je zverejnené pod medzinárodnou licenciou Creative Commons Attribution-ShareAlike ("uvedenie autora – rovnaké šírenie") 4.0. Ak chcete zobraziť kópiu tejto licencie, navštívte https://creativecommons.org/licenses/by-sa/4.0/
 
+## Vitaj
+
+Vitaj na Django Girls! Sme radi, že ťa tu vidíme :) V tomto tutoriále ti ukážeme čo je pod kapotou webových technológií. Ponúkneme ti pohľad na všetky čiastky a kúsky, ktoré musia do seba zapadnúť aby web fungoval tak ako ho poznáme.
+
+Ako so všetkými vecami, ktoré sú neznáme, aj toto bude dobrodružstvo - ale neboj sa, keďže si sa už odvážila byť tu, všetko bude v poriadku :)
+
 ## Úvod
 
-Mala si niekedy pocit, že svet je stále viac a viac o technológiách a ty v nich zaostávaš? Uvažovala si niekedy, že by si si vytvorila webovú stránku, ale nikdy si nemala dosť motivácie začať? Zdalo sa ti niekedy, že svet softvéru je pre teba príliš komplikovaný a že sama nezvládneš nič vytvoriť?
+Mala si niekedy pocit, že svet je stále viac a viac o technológiách a ku ktorým (zatiaľ) nemáš vzťah? Uvažovala si niekedy, že by si si vytvorila webovú stránku, ale nikdy si nemala dostatok motivácie začať? Zdalo sa ti niekedy, že svet softvéru je pre teba príliš komplikovaný a že sama nezvládneš nič vytvoriť?
 
 Máme pre teba dobrú správu! Programovanie nie je také zložité, ako sa zdá a chceme ti ukázať, aké môže byť zábavné.
 
-Tento návod z teba neurobí mávnutím čarovného prútika programátorku. Ak chceš byť dobrá, čakajú ťa mesiace či dokonca roky štúdia a praxe. Chceme ti ale ukázať, že vytvorenie webovej stránky nie je také ťažké, ako sa zdá. Pokúsime sa ti vysvetliť rôzne technológie tak, aby si sa ich nemusela báť.
+Tento návod z teba neurobí programátorku mávnutím čarovného prútika. Ak chceš byť v tom dobrá, čakajú ťa mesiace či dokonca roky štúdia a praxe. Chceme ti ale ukázať, že vytvorenie webovej stránky nie je také ťažké, ako sa zdá. Pokúsime sa ti vysvetliť rôzne technológie tak, aby si sa ich nemusela báť.
 
 Dúfame, že sa ti tieto veci zapáčia tak veľmi ako nám!
 
 ## Čo ťa tento návod naučí?
 
-Po skončení budeš mať funkčnú webovú aplikáciu: tvoj vlastný blog. Ukážeme ti, ako ho zverejniť na webe, kde ho môže každý navštíviť!
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
 
 Výsledok bude vyzerať asi takto:
 
-![Obrázok 0.1][2]
+![Obrázok 0.1](images/application.png)
 
- [2]: images/application.png
+> Ak budeš na tomto projekte pracovať sama a nemáš mentora, ktorý ti pomáha, môžeš v prípade problémov navštíviť tento chat: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Požiadali sme našich mentorov, ale aj absolventky, aby sa na tomto chate občas ukázali a pomohli ostatným! Neboj sa opýtať čomu nerozumieš!
 
-> Ak budeš na tomto projekte pracovať sama a nemáš mentora, ktorý ti pomáha, môžeš v prípade problémov navštíviť tento chat: [![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge). Požiadali sme našich mentorov, ale aj absolventky, aby sa na tomto chate občas ukázali a pomohli ostatným, ktorí môžu zápasiť s problémami! Neboj sa pripojiť a opýtať sa, na čo potrebuješ!
+OK, [začnime pekne po poriadku...](./how_the_internet_works/README.md)
 
-OK, [začnime pekne po poriadku...][3]
+## Sledovanie tutoriálu doma
 
- [3]: ./how_the_internet_works/README.md
+Je úžasné, zúčastniť sa Django Girls workshopu, ale uvedomujeme si, že nie vždy je možné byť na niektorom. Preto ti odporúčami aby si skúsila postupovať podľa tohto tutoriálu doma. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. Stále sa na tom pracuje, ale viac a viac vecí bude čoskoro na [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube kanály.
 
-## Informácie a možnosti ako sa zapojiť
+V každej kapitole ktorá už bola spracovaná sa nachádza odkaz na príslušné video.
 
-Tento návod vytvorili a udržiavajú [DjangoGirls][4]. Ak nájdete chyby alebo by ste chceli aktualizovať tento návod, prosím [postupujte podľa pokynov][5].
+## Informácie a možnosti ako sa zapojiť
 
- [4]: https://djangogirls.org/
- [5]: https://github.com/DjangoGirls/tutorial/blob/master/README.md
+Tento návod vytvorili a udržiavajú [DjangoGirls](https://djangogirls.org/). Ak nájdeš chyby alebo by si chcela aktualizovať tento návod, prosím [postupuj podľa pokynov](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
 
-## Chceš pomôcť s prekladom do iných jayzkov?
+## Would you like to help us translate the tutorial into other languages?
 
 V súčasnosti koordinujeme preklady cez platformu crowdin.com:
 
 https://crowdin.com/project/django-girls-tutorial
 
-Ak tvoj jazyk nie je v zozname na crowdin.com, [daj nám prosím vedieť][6] a povedz, aký jazyk máme pridať.
-
- [6]: https://github.com/DjangoGirls/tutorial/issues/new
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/sk/SUMMARY.md b/sk/SUMMARY.md
index 4db235abfb7..cc6f58b1b5b 100755
--- a/sk/SUMMARY.md
+++ b/sk/SUMMARY.md
@@ -1,26 +1,27 @@
 # Zhrnutie
 
-*   [Úvod](README.md)
-*   [Inštalácia](installation/README.md)
-*   [Ako funguje Internet](how_the_internet_works/README.md)
-*   [Úvod do príkazového riadku](intro_to_command_line/README.md)
-*   [Inštalácia Pythonu](python_installation/README.md)
-*   [Editor kódu](code_editor/README.md)
-*   [Úvod do jazyka Python](python_introduction/README.md)
-*   [Čo je Django?](django/README.md)
-*   [Inštalácia Django](django_installation/README.md)
-*   [Tvoj prvý Django projekt!](django_start_project/README.md)
-*   [Django modely](django_models/README.md)
-*   [Django admin](django_admin/README.md)
-*   [Nasadenie!](deploy/README.md)
-*   [Django url](django_urls/README.md)
-*   [Django views - čas tvoriť!](django_views/README.md)
-*   [Úvod do HTML](html/README.md)
-*   [Django ORM (tvorba dotazov)](django_orm/README.md)
-*   [Dynamické dáta v šablónach](dynamic_data_in_templates/README.md)
-*   [Šablóny Django](django_templates/README.md)
-*   [CSS - aby to pekne vyzeralo](css/README.md)
-*   [Rozširovanie šablón](template_extending/README.md)
-*   [Ako rozšíriť aplikáciu](extend_your_application/README.md)
-*   [Formuláre Django](django_forms/README.md)
-*   [Čo ďalej?](whats_next/README.md) 
+* [Úvod](README.md)
+* [Inštalácia](installation/README.md)
+* [Inštalácia (chromebook)](chromebook_setup/README.md)
+* [Ako funguje Internet](how_the_internet_works/README.md)
+* [Úvod do príkazového riadku](intro_to_command_line/README.md)
+* [Inštalácia Pythonu](python_installation/README.md)
+* [Editor kódu](code_editor/README.md)
+* [Úvod do jazyka Python](python_introduction/README.md)
+* [Čo je Django?](django/README.md)
+* [Inštalácia Django](django_installation/README.md)
+* [Tvoj prvý Django projekt!](django_start_project/README.md)
+* [Django modely](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Nasadenie!](deploy/README.md)
+* [Django url](django_urls/README.md)
+* [Django views - čas tvoriť!](django_views/README.md)
+* [Úvod do HTML](html/README.md)
+* [Django ORM (tvorba dotazov)](django_orm/README.md)
+* [Dynamické dáta v šablónach](dynamic_data_in_templates/README.md)
+* [Šablóny Django](django_templates/README.md)
+* [CSS - skrášli to](css/README.md)
+* [Rozširovanie šablón](template_extending/README.md)
+* [Ako rozšíriť aplikáciu](extend_your_application/README.md)
+* [Formuláre Django](django_forms/README.md)
+* [Čo ďalej?](whats_next/README.md)
\ No newline at end of file
diff --git a/sk/chromebook_setup/README.md b/sk/chromebook_setup/README.md
new file mode 100644
index 00000000000..bdda98ad71d
--- /dev/null
+++ b/sk/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Nastavenie Chromebooku
+
+> **Poznámka:** Ak už máš po inštalácii, môžeš ísť rovno na [Úvod do Python-u](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/sk/chromebook_setup/instructions.md b/sk/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..e32f5518288
--- /dev/null
+++ b/sk/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+Túto časť [môžeš preskočiť](http://tutorial.djangogirls.org/en/installation/#install-python) ak nepoužívaš Chromebook. Ak ho používaš, tak tvoja inštalácia bude trochu iná. Môžeš odignorovať zvyšok inštalačného postupu.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. Počas tohto tutoriálu Cloud 9 sa bude tvariť ako tvoj *lokálny stroj*. Príkazy budeš zadávať do terminálového rozhrania, tak ako tvoji spolužiaci čo používajú OS X, Ubuntu, alebo Windows, ale tvoj temrinál bude pripojený na počítač, ktorý beží niekde inde a ktorý Cloud 9 pripraví pre teba.
+
+1. Nainštaluj si Cloud 9 z [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Hoď na [c9.io](https://c9.io)
+3. Založ si učet
+4. Klikni na *Create a New Workspace*
+5. Pomenuj ho *django-girls*
+6. Zvoľ *Blank* (druhý sprava v dolnom riadku čo má oranžové logo)
+
+Teraz by si mala vidieť rozhranie s bočnou lištou, veľké hlavné okno s trochu textu a malé okno v dolnej časti, ktoré vyzerá takto nejak:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtuálne prostredie
+
+Virtuálne prostredie (tiež nazývané virtualenv) je ako súkromná krabica, do ktorej môžeme uložiť úžitočný počítačový kód patriaci projektu na ktorom pracujeme. Používame ich na oddelenie rôznych častí kódu pre rôzne projekty, aby sa nám nepomiešali veci medzi rôznymi projektami.
+
+V termináli, v spodnej časti Cloud 9 rozhrania, spusti nasledovné:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+Ak to ešte stále nefunguje, požiadaj svojho mentora/ku o pomoc.
+
+Ďalej zadaj nasledovné príkazy:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(všimni si, že v poslednom riadku sme použili vlnovku a za ňou znamienko rovnosti).
+
+### Github
+
+Vytvor si [Github](https://github.com) účet.
+
+### PythonAnywhere
+
+Django Girls tutoriál obsahuje kapitolu o tom čomu sa hovorí nasadenie (Deployment). Je to proces prenesenia kódu, ktorý používa tvoja nová webová aplikácia, na verejne dostupný počítač (ešte nazývaný aj server) aby aj ostatný ludia videli tvoju prácu.
+
+Táto časť je trochu divná, keď pracuješ s týmto tutoriálom na Chromebooku, lebo už používaš počítač, ktorý je na internete (v porovnani s laptopom). Napriek tomu, je stále užitočná, lebo si môžeme predstaviť Cloud 9 pracovné prostredie ako miesto kde sa nachádza rozpracovaná práca a Python Anywhere ako miesto, kde ukážeme našu prácu, ktorá bude hotová.
+
+Teda vytvor si nový Python Anywhere účet na [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/sk/code_editor/README.md b/sk/code_editor/README.md
index 97a5ffc6e23..cc121db0a7b 100755
--- a/sk/code_editor/README.md
+++ b/sk/code_editor/README.md
@@ -1,7 +1,11 @@
 # Editor kódu
 
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) videu.
+
 O chvíľu napíšeš svoj prvý riadok kódu, takže je načase si stiahnuť editor kódu!
 
+> **Poznámka:** Ak používaš Chromebook, preskoč túto kapitolu a postupuj podľa pokynov na [nastavenie Chromebooku](../chromebook_setup/README.md).
+> 
 > **Poznámka** Toto si už možno spravila v kapitole Inštalácia - ak áno, môžeš pokračovať rovno na ďalšiu kapitolu!
 
 {% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/sk/code_editor/instructions.md b/sk/code_editor/instructions.md
index b2d8c066e7f..927ae8ba097 100755
--- a/sk/code_editor/instructions.md
+++ b/sk/code_editor/instructions.md
@@ -1,31 +1,31 @@
 Existuje veľa rôznych editorov a zväčša sa vyberajú podľa osobných preferencií. Väčšina Python programátorov používa zložité, ale veľmi výkonné IDE (integrované vývojové prostredie), ako napríklad PyCharm. Pre začiatočníka je to pravdepodobne menej vhodné; naše odporúčania sú rovnako výkonné, ale oveľa jednoduchšie.
 
-Naše návrhy sú uvedené nižšie, ale neváhaj sa opýtať svojho trénera, aké sú jeho preferencie - potom bude jednoduchšie od neho získať pomoc.
+Naše návrhy sú uvedené nižšie, ale neváhaj sa opýtať svojho mentora, aké sú jeho preferencie - bude ti jednoduchšie vedieť pomocť.
 
 ## Gedit
 
-Gedit je open-source, editor zdarma dostupný pre všetky operačné systémy.
+Gedit je open-source, editor zdarma, dostupný pre všetky operačné systémy.
 
-[Stiahni si tu](https://wiki.gnome.org/Apps/Gedit#Download)
+[Stiahni si ho odtiaľto](https://wiki.gnome.org/Apps/Gedit#Download)
 
 ## Sublime Text 3
 
-Sublime Text je veľmi populárny editor so skúšobnou verziou zdarma. Je jednoduchý na inštaláciu a používanie, je dostupný pre všetky operačné systémy.
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
 
-[Stiahni si tu](https://www.sublimetext.com/3)
+[Stiahni si ho odtiaľto](https://www.sublimetext.com/3)
 
 ## Atom
 
-Atom je veľmi nový editor vytvorený [GitHubom](https://github.com/). Je zdarma, open-source, jednoduchý na inštaláciu a používanie. Je dostupný pre Windows, OS X a Linux.
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
 
-[Stiahni si tu](https://atom.io/)
+[Stiahni si ho odtiaľto](https://atom.io/)
 
 ## Prečo inštalujeme editor?
 
-Môžete Vás zaujímať, prečo inštalujeme takýto špeciálny editor kódu, radšej než používať niečo ako Word alebo Notepad.
+Môže ťa zaujímať, prečo inštalujeme takýto špeciálny editor kódu, namiesto použitia niečoho ako Word alebo Notepad.
 
-Prvý dôvod je, že kód musí byť **čistý text** a problém s programami ako Word a Textedit je ten, že v skutočnosti nevytvárajú čistý text, produkujú obohatený text (s fontom a formátovaním), používajú vlastné formáty ako [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+Prvý dôvod je, že kód musí byť **čistý text** a problém s editormi ako Word a Textedit je ten, že v skutočnosti nevytvárajú čistý text, produkujú obohatený text (s fontom a formátovaním), používajú vlastné formáty ako [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
 
-Druhý dôvod je, že editor kódu je špecializovaný na editáciu kódu, takže môže poskytovať pomocné funkcie ako zvýraznenie kódu farbou podľa jeho významu alebo automaticky za Vás uzatvárať úvodzovky.
+Druhý dôvod je, že editor kódu je špecializovaný na editáciu kódu, takže môže poskytovať pomocné funkcie ako zvýraznenie kódu farbou podľa jeho významu, alebo automaticky za teba uzatvárať úvodzovky.
 
-Všetko uvidíme neskôr. Čoskoro budeš premýšľať o svojom starom vernom editore ako o svojom obľúbenom nástroji :)
\ No newline at end of file
+Všetko uvidíme neskôr. Čoskoro budeš považovať svoj starý verný editor za svoj obľúbený nástroj. :)
\ No newline at end of file
diff --git a/sk/css/README.md b/sk/css/README.md
index 5c6611baa15..b3b5d275dbc 100755
--- a/sk/css/README.md
+++ b/sk/css/README.md
@@ -4,19 +4,21 @@ Náš blog vyzerá zatiaľ dosť škaredo, však? Je čas to napraviť! Použije
 
 ## Čo je CSS?
 
-Kaskádové štýly (CSS, angl. Cascading Style Sheets) je jazyk, ktorý sa používa na popis vzhľadu a formátovania webstránky napísanej v značkovacom jazyku (napríklad HTML). Predstav si to ako make-up pre našu webstránku :).
+Kaskádové štýly (CSS, angl. Cascading Style Sheets) je jazyk, ktorý sa používa na popis vzhľadu a formátovania webstránky napísanej v značkovacom jazyku (napríklad HTML). Predstav si to ako make-up pre našu webstránku. ;)
 
-Ale asi nechceme začať úplne od nuly, však? Znova použijeme niečo, čo už bolo vytvorené programátormi a sprístupnené na internete zadarmo. Veď vieš, znovuobjavovanie kolesa nie je žiadna zábava.
+Ale my nechceme začať od nuly, zasa, že áno? Znovu budeme používať niečo, čo programátori zverejnili na internet zadarmo. Ako viete, vymýšlať koleso nie je žiadna zábava.
 
-## Používajme Bootstrap!
+## Použime Bootstrap!
 
 Bootstrap je jedným z najpopulárnejších HTML a CSS frameworkov pre vývoj krásnych webových stránok: https://getbootstrap.com/
 
-Bol napísaný programátormi, ktorí pracovali pre Twitter a ďalej ho vyvíjajú dobrovoľníci z celého sveta.
+Bol napísaný programátormi, ktorí pracovali pre Twitter. Teraz je vyvíjaný dobrovoľníkmi z celého sveta!
 
 ## Inštalácia Bootstrapu
 
-Na inštaláciu Bootstrapu musíš pridať do hlavičky `<head>` vo svojom `.html` súbore (`blog/templates/blog/post_list.html`) toto:
+Aby si nainštalovala Bootstrap, potrebuješ pridať nasledovnú vec do `<head>` v tvojom `.html` súbore:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
@@ -25,90 +27,89 @@ Na inštaláciu Bootstrapu musíš pridať do hlavičky `<head>` vo svojom `.htm
 
 Nepridá to do tvojho projektu žiadne súbory. Iba to ukazuje na súbory, ktoré už existujú na internete. Skúsme to, otvor svoju webstránku a obnov stránku. Tu to máme!
 
-![Obrázok 14.1][1]
-
- [1]: images/bootstrap1.png
+![Obrázok 14.1](images/bootstrap1.png)
 
-Už teraz vyzerá lepšie!
+Už to vyzerá lepšie!
 
 ## Statické súbory v Djangu
 
-Konečne sa pozrieme zblízka na veci, ktoré nazývame **statické súbory**. Sú to všetky tvoje CSS a obrázky -- súbory, ktoré nie sú dynamické, takže ich obsah nezávisí od kontextu požiadavky a budú rovnaké pre všetkých užívateľov.
+Konečne sa pozrieme zblízka na veci, ktoré nazývame **statické súbory**. Statické súbory sú všetky vaše CSS a obrázky. Ich obsah nie je závislý na kontexte žiadosti a budú rovnaké pre každého používateľa.
 
 ### Kam umiestniť statické súbory pre Django
 
-Ako si už videla, keď sme spustili `collectstatic` na serveri, Django už vie, kde má nájsť statické súbory pre vstavané "adminské" aplikácie. Teraz už musíme len pridať nejaké statické súbory pre našu vlastnú aplikáciu, `blog`.
+Django už vie, kde nájsť statické súbory pre zabudovanú aplikáciu "admin". Teraz už len musíme pridať niektoré statické súbory pre našu vlastnú aplikáciu, `blog`.
 
 To urobíme tak, že vo vnútri našej aplikácie blog vytvoríme adresár s názvom `static`:
 
-```
-djangogirls
-├── blog
-│   ├── migrations
-│   └── static
-└── mysite
-```
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
 
-Django automaticky nájde všetky priečinky s názvom "static" vo všetkých priečinkoch tvojich aplikácií a bude môcť používať ich obsah ako statické súbory.
+Django automaticky nájde všetky zložky s názvom "static" vo všetkých priečinkoch tvojej aplikácie. Potom bude možné použiť ich obsah ako statické súbory.
 
 ## Tvoj prvý CSS súbor!
 
-Vytvorme teraz CSS súbor, ktorý tvojej web stránke pridá vlastný štýl. Vytvor nový adresár s názvom `css` vnútri adresára `static`. Potom vytvor nový súbor s názvom `blog.css` vo vnútri tohto adresára `css`. Pripravená?
-
-```
-djangogirls
-└─── blog
-     └─── static
-          └─── css
-               └─── blog.css
-```
-
-Je čas napísať nejaké CSS! Otvor v editore kódu súbor `blog/static/css/blog.css`.
+Vytvorme teraz CSS súbor, ktorý tvojej web stránke pridá tvoj vlastný štýl. Vytvor nový adresár s názvom `css` vnútri adresára `static`. Potom vytvor nový súbor s názvom `blog.css` vo vnútri tohto adresára `css`. Pripravená?
 
-Nepôjdeme príliš do hĺbky ohľadne prispôsobovania web stránky a učenia sa CSS, pretože je to celkom jednoduché a môžeš sa to naučiť sama po tomto workshope. Odporúčame ti urobiť si [kurz Codeacademy HTML & CSS][2], tam sa dozvieš všetko, čo potrebuješ vedieť, aby bola tvoja webstránka vďaka CSS krajšia.
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
 
- [2]: https://www.codecademy.com/tracks/web
+Je čas napísať trochu CSS! Otvor v editore kódu súbor `blog/static/css/blog.css`.
 
-Ale urobme aspoň niečo. Čo keby sme zmenili farbu hlavičky? Počítače používajú špeciálne kódy, aby rozumeli farbám. Začínajú `#`, potom nasleduje 6 písmen (A-F) a číslic (0-9). Kódy farieb nájdeš napríklad tu: http://www.colorpicker.com/. Môžeš tiež použiť [preddefinované farby][3] ako napríklad `red` (červená) alebo `green` (zelená).
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
 
- [3]: http://www.w3schools.com/cssref/css_colornames.asp
+Ale urobme aspoň niečo trochu. Čo keby sme zmenili farbu hlavičky? Počítače používajú špeciálne kódy, aby rozumeli farbám. Tieto kódy sa začínajú `#` potom nasleduje 6 písmen (A-F) a číslice (0-9). Napríklad kód pre modrú je `#0000FF`. Kódy farieb nájdeš napríklad tu: http://www.colorpicker.com/. Môžeš tiež použiť [preddefinované farby](http://www.w3schools.com/colors/colors_names.asp) ako napríklad `red` (červená) alebo `green` (zelená).
 
 V súbore `blog/static/css/blog.css` pridaj nasledujúci kód:
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 h1 a {
     color: #FCA205;
 }
 ```
 
-`h1 a` je CSS Selector. To znamená, že náš štýl aplikujeme na akýkoľvek element `a` vo vnútri elementu `h1` (napríklad ak máme v kóde niečo takéto: `<h1><a href="">link</a></h1>`). V tomto prípade elementu hovoríme, aby zmenil svoju farbu na `#FCA205`, čo je oranžová. Samozrejme, sem môžeš zadať vlastnú farbu!
+`h1 a` je CSS Selector. To znamená, že sme naše štýly použili na akýkoľvek prvok `a`, vo vnútri prvku `h1`. Takže keď máme niečo ako: `<h1><a href="">link</a></h1>` použije sa naň `h1, a` štýl. V tomto prípade elementu hovoríme, aby zmenil svoju farbu na `#FCA205`, čo je oranžová. Samozrejme, sem môžeš zadať vlastnú farbu!
 
-V CSS súbore definujeme štýly pre elementy v HTML súbore. Elementy sa identifikujú podľa svojho názvu (t. j. `a` `h1`, `body`), atribútom `class` (trieda) alebo atribútom `id`. Triedy a id sú názvy, ktorými nazveš elementy. Triedy definujú skupiny elementov a idy poukazujú na konkrétne elementy. Napríklad, nasledujúci tag môže byť identifikovaný v CSS pomocou tagu `a`, triedy `external_link` a idu `link_to_wiki_page`:
+V CSS súbore definujeme štýly pre elementy v HTML súbore. Prvý spôsob, akým môžme identifikovať elementy je názov elementu. Môžno si pamätáte tieto značky z HTML sekcie. Veci ako `a`,`h1`, a `body` sú príklady názvov elementov. Elementy taktiež identifikujeme pomocou atribútu `class` alebo atribútu `id`. Triedy (class) a id sú názvy, ktorými nazveš elementy. Triedy definujú skupiny elementov a id-čká poukazujú na konkrétne elementy. Napríklad, nasledujúci tag môže byť identifikovaný v CSS pomocou mena tagu `a`, triedy `external_link`, alebo id `link_to_wiki_page`:
 
 ```html
 <a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
 ```
 
-Prečítaj si o [CSS selektoroch na w3schools][4].
+O [CSS selektoroch ](http://www.w3schools.com/cssref/css_selectors.asp) si môžeš prečítať viac na stránkach w3schools.
 
- [4]: http://www.w3schools.com/cssref/css_selectors.asp
+Ešte musíme povedať našej HTML šablóne, že sme pridali nejaké CSS. Otvor súbor `blog/templates/blog/post_list.html` a pridaj tento riadok na úplný začiatok:
 
-Potom musíme povedať našej HTML šablóne, že sme pridali nejaké CSS. Otvor súbor `blog/templates/blog/post_list.html` a pridaj tento riadok na úplný začiatok:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
 ```
 
-Práve načítavame statické súbory :). Potom medzi `<head>` a `</head>`, po odkazoch na CSS súbory Bootstrapu pridaj nasledujúci riadok (prehliadač číta súbory v poradí, v akom sú zadané, takže kód v našom súbore môže prepísať už načítaný kód z Bootstrapu):
+Tu sme len nahrali statické súbory. :) Medzi `<head>` a `</head>`, po odkazoch na Bootstrap CSS súbory pridať tento riadok:
 
-    html
-    <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
 
-Práve sme našej šablóne povedali, kde sa nachádza náš CSS súbor.
+Prehliadač číta súbory ktoré dostane zaradom, takže musíme sa uistiť, že sú na správnom mieste. Inak kód v našich súboroch môžu byť prepísané kódom z Bootstrap súborov. Práve sme našej šablóne povedali, kde sa nachádza náš CSS súbor.
 
 Súbor by mal teraz vyzerať asi takto:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -136,11 +137,11 @@ Súbor by mal teraz vyzerať asi takto:
 
 OK, ulož súbor a obnov stránku!
 
-![Obrázok 14.2][5]
+![Obrázok 14.2](images/color2.png)
 
- [5]: images/color2.png
+Pekne! Možno by sme chceli dať našej webovej stránke trochu vzduchu. Zväčšíme okraj na ľavej strane? Skúsme to!
 
-Pekne! Možno by sme chceli dať našej webovej stránke trochu vzduchu. Zväčšíme okraj na ľavej strane? Skúsme si to!
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 body {
@@ -150,19 +151,21 @@ body {
 
 Pridaj to do svojho CSS, ulož súbor a pozri, ako to funguje!
 
-![Obrázok 14.3][6]
-
- [6]: images/margin2.png
+![Obrázok 14.3](images/margin2.png)
 
 Mohli by sme trochu upraviť font v našej hlavičke, nie? Skopíruj toto do svojej hlavičky `<head>` v súbore `blog/templates/blog/post_list.html`:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
-<link href="https://fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
 ```
 
-Tento riadok naimportuje z Google fontov (https://www.google.com/fonts) font, ktorý sa volá *Lobster*.
+Rovnako ako predtým, skontroluj poradie a umiestni pred odkaz na `blog/static/css/blog.css`. Tento riadok bude importovať font pod názvom *Lobster* z Google Fonts (https://www.google.com/fonts).
+
+Nájdite `h1 a` deklaračný blok (kód medzi zátvorkami `{` a `}`) v súbore CSS ` blog/static/css/blog.css `. Teraz pridajte riadok` font-family: 'Lobster';` medzi zátvorky a obnovte stránku:
 
-Teraz pridaj riadok `font-rodina: 'Lobster';` do CSS súboru `blog/static/css/blog.css` vnútri deklarácie `h1 a` (to je ten kód medzi zátvorkami `{` a `}`) a obnov stránku:
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 h1 a {
@@ -171,15 +174,15 @@ h1 a {
 }
 ```
 
-![Obrázok 14.3][7]
-
- [7]: images/font.png
+![Obrázok 14.3](images/font.png)
 
 Super!
 
-Ako sme už spomenuli vyššie, CSS má koncept tried, ktorými v podstate pomenuješ časť HTML kódu a aplikuješ štýly len na túto konkrétnu časť, bez vplyvu na ostatné časti. Je to super užitočné, ak máš dva div-y, z ktorých každý robí niečo úplne iné (napríklad hlavička a príspevok), takže nechceš, aby vyzerali rovnako.
+Ako bolo uvedené vyššie, CSS má koncept tried. Triedy umožnia pomenovať časti HTML kódu a použiť štýly iba na tejto časti, bez ovplyvnenia ostatných častí. To môže byť super užitočné! Možno máš dva div-y, ktoré robia niečo iné (ako hlavička a tvoj príspevok). Triedy ti umožnia aby vyzerala každá inak.
+
+Skús pomenovať niektoré časti HTML kódu. Pridaj triedu s názvom `page-header` do `div`u, ktorý obsahuje takúto nejakú hlavičku:
 
-Skús pomenovať niektoré časti HTML kódu. Pridaj triedu s názvom `page-header` do `div`u, ktorý obsahuje hlavičku, takto nejako:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <div class="page-header">
@@ -189,6 +192,8 @@ Skús pomenovať niektoré časti HTML kódu. Pridaj triedu s názvom `page-head
 
 A teraz pridaj triedu, `post` do `div`u, v ktorom je blog post.
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="post">
     <p>published: {{ post.published_date }}</p>
@@ -199,6 +204,8 @@ A teraz pridaj triedu, `post` do `div`u, v ktorom je blog post.
 
 Teraz pridáme deklarácie rôznym selektorom. Selektory, ktoré začínajú `.` sa týkajú tried. Na webe je ohľadne CSS veľa skvelých tutorialov a vysvetlení, ktoré ti pomôžu pochopiť nasledujúci kód. Ale teraz len skopíruj a vlož nasledujúci kód do súboru `blog/static/css/blog.css`:
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 .page-header {
     background-color: #ff9400;
@@ -221,7 +228,6 @@ h1, h2, h3, h4 {
 }
 
 .date {
-    float: right;
     color: #828282;
 }
 
@@ -251,6 +257,8 @@ h1, h2, h3, h4 {
 
 Teraz s deklaráciami tried obklop HTML kód, ktorý zobrazuje posty. Nahraď toto:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     <div class="post">
@@ -263,6 +271,8 @@ Teraz s deklaráciami tried obklop HTML kód, ktorý zobrazuje posty. Nahraď to
 
 v súbore `blog/templates/blog/post_list.html` týmto:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="content container">
     <div class="row">
@@ -270,7 +280,7 @@ v súbore `blog/templates/blog/post_list.html` týmto:
             {% for post in posts %}
                 <div class="post">
                     <div class="date">
-                        {{ post.published_date }}
+                        <p>published: {{ post.published_date }}</p>
                     </div>
                     <h1><a href="">{{ post.title }}</a></h1>
                     <p>{{ post.text|linebreaksbr }}</p>
@@ -283,14 +293,12 @@ v súbore `blog/templates/blog/post_list.html` týmto:
 
 Ulož tieto súbory a obnov svoju web stránku.
 
-![Obrázok 14.4][8]
-
- [8]: images/final.png
+![Obrázok 14.4](images/final.png)
 
-No paráda! Vyzerá to super, nie? Kód, ktorý sme práve vložili, fakt nie je veľmi ťažké pochopiť a väčšinu asi pochopíš už len tým, že ho prečítaš.
+Woohoo! Vyzerá to úžasne, že áno? Pozrite sa na kód, ktorý sme práve vložili, nájdi miesta, kde sme pridali triedy v HTML a použili sme ich v CSS. Kde by si spravila zmenu, ak by si chcela dátum, tyrkysovej farby?
 
-Neboj sa trochu pohrať s týmto CSS, skús niektoré veci zmeniť. Ak niečo pokazíš, nevadí, vždy sa môžeš vrátiť späť!
+Neboj sa trochu pohrať s týmto CSS a pokús sa zmeniť niektoré veci. Hraním sa s CSS, môžeš pochopiť, čo robia rôzne veci. Ak niečo pokazíš, neboj sa, môžeš vždy vrátiť zmeny späť!
 
-Mimochodom, naozaj odporúčame tento bezplatný on-line [kurz HTML & CSS Codeacademy ][2] ako domácu úlohu po skončení tohto workshopu, kde sa naučíš všetko, čo potrebuješ vedieť, aby boli tvoje webové stránky s CSS krajšie.
+Naozaj odporúčame, tento kurz zadarmo on-line [ CSS & Codeacademy HTML](https://www.codecademy.com/tracks/web). Môžeš sa dozvedieť všetko o tom, ako môžeš svoje stránky skrášliť pomocou CSS.
 
-Pripravená na ďalšiu kapitolu?! :)
+Pripravená na ďalšiu kapitolu?! :)
\ No newline at end of file
diff --git a/sk/deploy/README.md b/sk/deploy/README.md
index fe4a059474e..e1d7e803573 100755
--- a/sk/deploy/README.md
+++ b/sk/deploy/README.md
@@ -1,297 +1,231 @@
 # Nasadenie!
 
-> **Poznámka** Občas bude možno trochu ťažké prehrýzť sa touto kapitolou. Vydrž a dokonči ju, nasadenie je dôležitou časťou vývoja webových stránok. Táto kapitola je umiestnená uprostred tutorialu, takže mentor ti môže pomôcť s trochu náročnejšími časťami procesu spúšťania tvojej web stránky online. To znamená, že môžeš dokončiť tutorial aj sama, ak ti nevyjde čas.
+> **Poznámka** Občas bude možno trochu ťažké prehrýzť sa touto kapitolou. Vydrž a dokonči ju, nasadenie je dôležitou časťou vývoja webových stránok. Táto kapitola je umiestnená uprostred tutoriálu, aby ti mentor/ka mohol/a pomôcť s trochu náročnejšími časťami procesu spúšťania tvojej webovej stránky online. To znamená, že môžeš dokončiť tutoriál aj sama, ak ti nevyjde čas.
 
-Až doteraz bola tvoja web stránka dostupná len v tvojom počítači, teraz sa však naučíš, ako ju nasadiť! Nasadenie je proces publikovania aplikácie na internete, takže ju ľudia konečne môžu vidieť :).
+Až do teraz, tvoja webová stránka bola dostupná len v počítači. Teraz sa naučíš, ako ju nasadiť! Nasadenie je proces publikovania aplikácie na internete, takže ju ľudia konečne budú môcť vidieť. :)
 
-Ako už vieš, web stránka musí byť umiestnená na serveri. Na internete je množstvo poskytovateľov serverov. My použijeme jedného, ktorý má pomerne jednoduchý proces nasadenia: [PythonAnywhere][1]. PythonAnywhere je bezplatný pre malé aplikácie, ktoré nemajú príliš veľa návštevníkov, takže zatiaľ ti to určite bude stačiť.
+Ako už vieš, webová stránka musí byť umiestnená na serveri. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
- [1]: https://pythonanywhere.com/
+Ďalšou externou službou, ktorú budeme využívať je [GitHub](https://www.github.com), kde sa uchovávajú zdrojové kódy. Existujú aj ďalšie podobné služby, no dnes už majú takmer všetci programátori na GitHube konto a teraz ho už budeš mať aj ty!
 
-Ďalšou externou službou, ktorú budeme využívať je [GitHub][2], kde sa uchovávajú zdrojové kódy. Existujú aj ďalšie takéto služby, no dnes už majú takmer všetci programátori na GitHube konto a teraz ho budeš mať už aj ty!
-
- [2]: https://www.github.com
-
-GitHub použijeme ako odrazový mostík na prenos nášho kódu z a do PythonAnywhere.
+Tieto tri miesta budú pre teba dôležité. Lokálny počítač bude miestom, kde budeš vyvíjať a testovať. Keď si spokojná so zmenami, uložíš kópiu programu na GitHub. Tvoja webová stránka bude na PythonAnywhere a budeš ju aktualizovať stiahnutím novej kópie svojho kódu z GitHub-u.
 
 # Git
 
-Git je "systém na správu verzií", ktorý využíva množstvo programátorov. Tento softvér sleduje v priebehu času zmeny v tvojich súboroch, takže sa kedykoľvek môžeš vrátiť ku konkrétnej verzii. Niečo ako funkcia "sledovať zmeny" vo Worde, ale oveľa výkonnejšie.
-
-## Inštalácia Gitu
-
-> **Poznámka** Ak si už kroky inštalácie robila, nemusíš to robiť znova a môžeš preskočiť na ďalšiu časť a začať vytvárať Git repozitár.
+> **Poznámka** Ak už máš za sebou inštaláciu, nemusíš to robiť znovu a môžeš preskočiť na ďalšiu časť a začať s vytváraním Git repozitára.
 
 {% include "/deploy/install_git.md" %}
 
-## Spustenie Git repozitára
+## Založenie Git repozitára
 
 Git sleduje zmeny na konkrétnej množine súborov, v niečom, čo sa nazýva úložisko kódu alebo repozitár (skrátene "repo"). Založme si repo pre náš projekt. Otvor konzolu a spusti nasledujúce príkazy v adresári `djangogirls`:
 
-> **Poznámka** Skontroluj si aktuálny pracovný adresár s príkazom`pwd` v OSX/Linux alebo `cd` vo Windowse pred inicializáciou úložiska. Mala by si byť v priečinku `djangogirls`.
+> **Poznámka** Skontroluj si aktuálny pracovný adresár s príkazom`pwd` (Mac OS X/Linux) alebo `cd` (Windows) pred inicializáciou repozitára. Mala by si byť v priečinku `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
 
-```
-$ git init
-Initialized empty Git repository in ~/djangogirls/.git/
-$ git config --global user.name "Your Name"
-$ git config --global user.email you@example.com
-```
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
 
 Inicializácia git repozitára je niečo, čo musíme urobiť len raz za projekt (a už nikdy nebudeš musieť znovu zadať užívateľské meno a e-mail).
 
 Git bude sledovať zmeny všetkých súborov a priečinkov v tomto adresári, ale sú aj niektoré súbory, ktoré chceme ignorovať. To urobíme tak, že vytvoríme súbor s názvom `.gitignore` v základnom adresári. Otvor si editor a vytvor nový súbor s týmto obsahom:
 
-```
-*.pyc
-__pycache__
-myvenv
-db.sqlite3
-.DS_Store
-```
-
-A ulož ho ako `.gitignore` do hlavného adresára "djangogirls".
-
-> **Poznámka** Bodka na začiatku názvu súboru je dôležitá! Ak máš problém vytvoriť takýto súbor (napríklad Macom sa nepáči, ak chceš cez Vyhľadávanie (Finder) vytvoriť súbory, ktoré sa začínajú bodkou), potom použi funkciu "Uložiť ako" vo svojom editore, to je nepriestrelné.
-
-Vždy je dobré použiť príkaz `git status` pred `git add` alebo kedykoľvek, keď si nebudeš istá, čo sa zmenilo. To ti pomôže vyhnúť sa prekvapeniam ako napríklad pridanie nesprávnych súborov. Príkaz `git status` dáva informácie o nesledovaných (untracked) či zmenených (modified) súboroch, alebo súboroch pripravených na zmenu (staged), o stave vetvy a veľa ďalšieho. Výstup by mal vyzerať takto nejako:
-
-```
-$ git status
-On branch master
-
-Initial commit
-
-Untracked files:
-  (use "git add <file>..." to include in what will be committed)
-
-        .gitignore
-        blog/
-        manage.py
-        mysite/
-
-nothing added to commit but untracked files present (use "git add" to track)
-```
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+A ulož ho ako `.gitignore` v priečinku "djangogirls".
+
+> **Poznámka** Bodka na začiatku názvu súboru je dôležitá! Ak máš problém vytvoriť takýto súbor (napríklad Macom sa nepáči, ak chceš cez Vyhľadávanie (Finder) vytvoriť súbory, ktoré sa začínajú bodkou), potom použi funkciu "Uložiť ako" vo svojom editore, to je spôsob akým sa to určite uloží.
+> 
+> **Poznámka** Jeden zo súborov, ktoré ste zadali v súbore `.gitignore` je `db.sqlite3`. Tento súbor je vaša lokálna databáza, kde sú všetky vaše príspevky skladované. Nechceme to pridať do repozitára, lebo tvoja webová stránka na PythonAnywhere bude používať inú databázu. Možno to bude SQLite, tak ako na stroji na ktorom vyvíjaš, ale zvyčajne použiješ databázu, ktorá sa volá MySQL, ktorá zvládne oveľa viac navštevníkov ako SQLite. Či tak alebo onak, ignorovaním SQLite databázy v kópii na GitHub-e, všetky príspevky, ktoré si vytvorila doteraz, zostanú dostupné len lokálne, a budeš ich musieť znovu pridať na produkčnej stránke. Svoju lokálnu databázu si môžeš predstaviť ako pieskovisko na ktorom si môžeš vyskúšať rôzne veci a nebáť sa že zmažeš reálne príspevky zo svojho blogu.
+
+Vždy je dobré použiť príkaz `git status` pred `git add` alebo kedykoľvek, keď si nebudeš istá, či sa niečo zmenilo. To ti pomôže vyhnúť sa prekvapeniam ako napríklad pridanie nesprávnych súborov. Príkaz `git status` dáva informácie o nesledovaných (untracked) či zmenených (modified) súboroch, alebo súboroch pripravených na zmenu (staged), o stave vetvy a veľa ďalších vecí. Výstup by mal byť podobný nasledovnému:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
 
 A nakoniec uložíme naše zmeny. Teraz prejdi na konzolu a zadaj nasledujúce príkazy:
 
-```
-$ git add -A .
-$ git commit -m "My Django Girls app, first commit"
-[...]
-13 files changed, 200 insertions(+)
-create mode 100644 .gitignore
-[...]
-create mode 100644 mysite/wsgi.py
-```
-
-## Prenos nášho kódu na GitHub
-
-Choď na [GitHub.com][2] a zaregistruj sa na nové bezplatné konto. (Ak si to už urobila v prípravke na workshop, tak to je skvelé!)
-
-Potom vytvor nové úložisko a pomenuj ho "my-first-blog". Nechaj políčko "initialise with README" nezaškrtnuté, možnosť .gitignore nechaj prázdnu (to sme už urobili ručne) a nechaj licenciu nastavenú ako None.
-
-![][3]
-
- [3]: images/new_github_repo.png
-
-> **Poznámka** Názov `my-first-blog` je dôležitý -- mohla by si si vybrať aj niečo iné, ale bude sa to ďalej vyskytovať veľakrát a musela by si to zakaždým nahradiť. Asi bude ľahšie, ak ostaneš pri názve `my-first-blog`.
-
-Na ďalšej obrazovke sa zobrazí klon URL tvojho repozitára. Vyber si verziu "HTTPS", skopírujte ju, a o chvíľu ju použijeme v termináli:
-
-![][4]
-
- [4]: images/github_get_repo_url_screenshot.png
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (Ak si to už urobila počas prípravy na workshop, tak to je super!)
+    
+    Potom, vytvor nový repozitár a pomenuj ho "moj-prvy-blog". Checkbox "inicializuj s README" nechaj nezaškrtnutý, voľbu .gitignore nechaj prázdnu (urobili sme to manuálne) a Licenciu nechaj ako None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Poznámka** Názov `moj-prvy-blog` je dôležitý -- môžeš si vybrať aj niečo iné, ale v ďalších inštrukciách sa to bude vyskytovať veľakrát a musela by si to zakaždým nahradiť. Asi bude ľahšie, ak ostaneš pri názve `moj-prvy-blog`.
+    
+    Na ďalšej obrazovke, sa ti zobrazí URL tvojho klonu repozitára. Zvoľ "HTTPS" verziu, skopíruj ju a o chvíľu ju vložíme do terminálu:
+    <img src="images/github_get_repo_url_screenshot.png" />
+    Teraz musíme prepjiť Git repozitár na tvojom počítači s tým na Githube.
+    
+    Napíš do konzoly nasledujúci príkaz: (nahraď `<your-github-username>` svojím uživateľským menom na Githube, ale bez lemných zátvoriek):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Zadaj svoje Github uživateľské meno a heslo a uvidíš niečo podobné tomuto:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Tvoj kód je na Githube. Kľudne si to over!  Zistíš, že sa nachádza vo vyberanej spoločnosti - [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), a mnoho iných skvelých open source-ových softvérových projektov ukladá svoj kód na GitHube. :)
+    
+    
+    # Umiestnenie nášho blogu na PythonAnywhere
+    
+    &gt; **Poznámka** Možno si si už vytvorila účet na PythonAnzwhere počas inštalácie - ak áno, tak nemusíš to robiť znova.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Stiahnutie nášho kódu na PythonAnywhere
+    
+    Keď si sa zaregistrovala do PythonAnywhere, budeš presmerovaná na dashboard alebo "Consoles" stránku. Vyber si možnosť spustiť "Bash" konzolu - to je PythonAnywhere konzola, podobná ako na tvojom počítači.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Poznámka** PythonAnywhere ja založené na Linuxe, takže ak používaš Windows, konzola sa bude líšiť od tej na tvojom počítači.
+    
+    Poďme teraz natiahnuť náš kód z GitHubu na PythonAnywhere vytvorením "klonu" nášho repozitára. Zadaj nasledujúci príkaz do konzoly na PythonAnywhere (nezabudni použiť užívateľské meno z GitHubu namiesto &lt;your-github-username&gt;):
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />Toto stiahne kópiu tvojho kódu na PythonAnywhere. Over si to zadaním príkazu `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Vytvorenie virtualenv na PythonAnywhere
+    
+    Presna tak ako na tvojom počítači, môžeš vytvoriť virtualenv na PythonAnywhere. V Bash konzole, zadaj príkaz:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-Teraz musíme pripojiť Git repozitár v počítači k tomu na GitHube.
-
-Napíš do konzoly nasledujúci príkaz (nahraď `<tvoje-github-meno>` svojím užívateľským menom na GitHube, ale bez lomených zátvoriek):
-
-```
-$ git remote add origin https://github.com/<tvoje-github-meno>/my-first-blog.git
-$ git push -u origin master
-```
-
-Zadaj svoje užívateľské meno a heslo na GitHube a malo by sa ti zobraziť niečo takého:
-
-```
-Username for 'https://github.com': hjwp
-Password for 'https://hjwp@github.com':
-Counting objects: 6, done.
-Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
-Total 3 (delta 0), reused 0 (delta 0)
-To https://github.com/hjwp/my-first-blog.git
- * [new branch]      master -> master
-Branch master set up to track remote branch master from origin.
-```
-
-<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extention -->
-
-Tvoj kód je na GitHube. Kľudne si to over! Zistíš, že sa nachádza vo vyberanej spoločnosti - [Django][5], [Django Girls Tutorial][6] a mnoho iných skvelých open sourcových softvérových projektov uchováva svoj kód na GitHube :)
-
- [5]: https://github.com/django/django
- [6]: https://github.com/DjangoGirls/tutorial
-
-# Vytvorenie nášho blogu na PythonAnywhere
-
-> **Poznámka** Možno si už účet na PythonAnywhere vytvorila počas inštalácie - ak áno, nemusíš to robiť znova.
-
-{% include "/deploy/signup_pythonanywhere.md" %}
-
-## Natiahnutie nášho kódu na PythonAnywhere
-
-Po registrácii na PythonAnywhere, budeš presmerovaná na svoju nástenku alebo stránku "Konzoly". Vyber si možnosť spustiť "Bash" konzolu - to je PythonAnywhere verzia konzoly, rovnaká ako na tvojom počítači.
-
-> **Poznámka** PythonAnywhere je založený na Linuxe, takže ak si vo Windowse, konzola bude vyzerať trochu inak ako v tvojom počítači.
-
-Poďme teraz natiahnuť náš kód z GitHubu na PythonAnywhere vytvorením "klonu" nášho repo. Zadaj nasledujúci príkaz do konzoly na PythonAnywhere (nezabudni použiť užívateľské meno z GitHubu namiesto `<tvoje-github-meno>`):
-
-```
-$ git clone https://github.com/<tvoje-github-meno>/my-first-blog.git
-```
-
-Toto natiahne kópiu tvojho kódu na PythonAnywhere. Môžeš si to overiť zadaním `tree my-first-blog`:
-
-```
-$ tree my-first-blog
-my-first-blog/
-├── blog
-│   ├── __init__.py
-│   ├── admin.py
-│   ├── migrations
-│   │   ├── 0001_initial.py
-│   │   └── __init__.py
-│   ├── models.py
-│   ├── tests.py
-│   └── views.py
-├── manage.py
-└── mysite
-    ├── __init__.py
-    ├── settings.py
-    ├── urls.py
-    └── wsgi.py
-```
-
-### Vytvorenie virtualenv na PythonAnywhere
-
-Tak ako si to urobila vo svojom počítači, virtualenv môžeš vytvoriť aj na PythonAnywhere. V Bash konzole zadaj:
-
-```
 $ cd my-first-blog
 
-$ virtualenv --python=python3.4 myvenv
-Running virtualenv with interpreter /usr/bin/python3.4
-[...]
-Installing setuptools, pip...done.
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
 
 $ source myvenv/bin/activate
 
-(mvenv) $  pip install django==1.8 whitenoise
-Collecting django
-[...]
-Successfully installed django-1.8 whitenoise-2.0
-```
-
-> **Poznámka:** Krok `pip install` môže trvať aj niekoľko minút. Trpezlivosť, trpezlivosť! Ale ak to trvá dlhšie ako 5 minút, niečo nie je v poriadku. Spýtaj sa svojho tútora.
-
-<!--TODO: think about using requirements.txt instead of pip install.-->
-
-### Zber statických súborov.
-
-Zaujímalo ťa, čo je to vlastne ten "whitenoise"? Je to nástroj na obsluhu takzvaných "statických súborov". Statické súbory su také súbory, ktoré sa pravidelne nemenia, ani nespúšťajú kód programu, ako napríklad HTML či CSS súbory. Na serveroch fungujú inak ako na tvojom počítači a na ich obsluhu potrebujeme nástroj ako je "whitenoise".
-
-O statických súboroch sa naučíme trochu viac neskôr, keď budeme upravovať CSS pre našu stránku.
-
-Teraz len musíme na serveri spustiť jeden príkaz navyše - `collectstatic`. Ten povie Djangu, aby na serveri zhromaždil všetky statické súbory, ktoré potrebuje. Práve teraz sú to väčšinou súbory, ktoré zabezpečujú, aby adminská stránka vyzerala dobre.
-
-```
-(mvenv) $ python manage.py collectstatic
-
-You have requested to collect static files at the destination
-location as specified in your settings:
-
-    /home/edith/my-first-blog/static
-
-This will overwrite existing files!
-Are you sure you want to do this?
-
-Type 'yes' to continue, or 'no' to cancel: yes
-```
-
-Napíš "yes" a ono to zmizne! Aj ty zbožňuješ vyrábať stránky plné výstupov z počítačov alebo nepochopiteľného textu? Ja osobne si k tomu vymýšľam čudné zvuky. Brp, brp, brp...
-
-```
-Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/actions.min.js'
-Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/inlines.min.js'
-[...]
-Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/changelists.css'
-Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/base.css'
-62 static files copied to '/home/edith/my-first-blog/static'.
-```
-
-### Vytvorenie databázy na PythonAnywhere
-
-Ďalšia vec, v ktorej sa líši tvoj počítač od servera: používa inú databázu. Takže užívateľské kontá a posty sa môžu na serveri líšiť od tých v počítači.
-
-Môžeme inicializovať databázu na serveri, rovnako ako sme to urobili v tvojom počítači, pomocou `migrate` a `createsuperuser`:
-
-```
-(mvenv) $ python manage.py migrate
-Operations to perform:
-[...]
-  Applying sessions.0001_initial... OK
-
-
-(mvenv) $ python manage.py createsuperuser
-```
-
-## Publikovanie nášho blogu ako webovú aplikáciu
-
-Teraz je náš kód na PythonAnywhere, náš virtualenv pripravený, statické súbory sú zhromaždené a databáza inicializovaná. Môžeme to teda zverejniť ako webovú aplikáciu!
-
-Kliknutím na logo PythonAnywhere sa vráť na nástenku a tam klikni na kartu **Web**. Nakoniec, stlač **Add a new web app** (Pridaj novú aplikáciu).
-
-Po potvrdení názvu tvojej domény, vyber v dialógu **manual configuration** (pozor, *nie* "Django" možnosť). Ďalej vyber **Python 3.4** a kliknutím na tlačidlo Ďalej dokonči sprievodcu.
-
-> **Poznámka** Uisti sa, že si si vybrala možnosť "Manual configuration" (Manuálne nastavenie), nie "Django". Sme príliš cool, aby sme používali predvolené nastavenia PythonAnywhere Django ;-)
-
-### Nastavenie virtualenv
-
-Budeš presmerovaná na PythonAnywhere konfiguračnú obrazovku pre tvoju aplikáciu. Sem budeš musieť chodiť vždy, keď budeš chcieť urobiť nejaké zmeny v tvojej aplikácii na serveri.
-
-![][7]
-
- [7]: images/pythonanywhere_web_tab_virtualenv.png
-
-V časti "Virtualenv" klikni na červený text "Enter the path to a virtualenv" a zadaj: `/home/<toje-uzivatelske-meno>/my-first-blog/myvenv/`. Klikni na modré políčko s fajočkou a ulož tak cestu predtým, ako budeš pokračovať ďalej.
-
-> **Poznámka** Nahraď svoje užívateľské meno podľa potreby. Ak urobíš chybu, PythonAnywhere ti zobrazí malé upozornenie.
-
-### Konfigurácia súboru WSGI
-
-Django funguje pomocou "protokolu WSGI", ktorý je štandardom pre obsluhu webových stránok pomocou Pythonu, a ktorý PythonAnywhere podporuje. Aby PythonAnywhere rozpoznal náš Django blog, musíme upraviť WSGI konfiguračný súbor.
-
-Klikni na link "WSGI configuration file" (v časti "Code" v hornej časti stránky -- bude sa volať nejako takto `/var/www/<tvoje-uzivatelske-meno>_pythonanywhere_com_wsgi.py`) a dostaneš sa do editora.
-
-Vymaž celý obsah a nahraď ho niečím takýmto:
-
-```python
-import os
-import sys
-
-path = '/home/<tvoje-uzivatelske-meno>/my-first-blog'  # use your own username here
-if path not in sys.path:
-    sys.path.append(path)
-
-os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
-
-from django.core.wsgi import get_wsgi_application
-from whitenoise.django import DjangoWhiteNoise
-application = DjangoWhiteNoise(get_wsgi_application())
-```
-
-> **Poznámka** Nezabudni nahradiť svoje vlastné užívateľské meno namiesto `<tvoje-uzivatelske-meno>`
-
-Úlohou tohto súboru je povedať PythonAnywhere, kde nájde našu aplikáciu a ako sa volá súbor s nastaveniami Djanga. Taktiež nastavuje nástroj "whitenoise" pre statické súbory.
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; ** Poznámka ** "pip install" krok môže trvať niekoľko minút.  Trpezlivosť, trpezlivosť!  Ale ak trvá viac ako päť minút, niečo nie je v poriadku.  Opýtaj sa svojho mentora.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Vytváranie databázy na PythonAnywhere
+    
+    Ďalšia vec, ktorá je iná na tvojom počítači a na serveri: používa sa iná databáza. Takže používateľské kontá a príspevky na serveri a v počítači sa môžu líšiť.
+    
+    Rovnako ako sme to urobili na tvojom počítači, zopakuj krok pri inicializácii databázy na serveri, s `migrate` a `createsuperuser`:
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Zverejnenie nášho blogu ako webovej aplikácie
+    
+    Náš kód je teraz na PythonAnywhere, virtualenv je pripravené a databáza je inicializovaná. Sme pripravení publikovať webovú aplikáciu!
+    
+    Kliknutím na logo PythonAnywhere sa vráť na nástenku a tam klikni na kartu Web. Nakoniec, stlač **Add a new web app** (Pridaj novú aplikáciu).
+    
+    Po potvrdení názvu tvojej domény, vyber v dialógu **manual configuration** (pozor, nie "Django" možnosť). Ďalej vyber **Python 3.6** a kliknutím na tlačidlo Ďalej dokonči sprievodcu.
+    
+    &gt; **Poznámka** Uisti sa že si zvolila "Manual configuration", a nie "Django" možnosť. Sme príliš cool aby sme použili predvolené Django nastavenia PythonAnywhere. ;-)
+    
+    
+    ### Nastavenie virtualenv
+    
+    Budeš presmerovaná na PythonAnywhere konfiguračnú obrazovku pre tvoju aplikáciu. Sem budeš musieť chodiť vždy, keď budeš chcieť urobiť nejaké zmeny v tvojej aplikácii na serveri.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    V časti "Virtualenv", klikni na červený text "Enter the path to a virtualenv", a zadah `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Klikni na modré políčko s fajočkou a ulož tak cestu predtým, ako budeš pokračovať ďalej.
+    
+    &gt; **Poznámka** Nahraď svoje PythonAnywhere uživateľské meno podľa potreby. Ak urobíš chybu, PythonAnywhere zobrazí malé upozornenie.
+    
+    
+    ### Konfigurácia WSGI súboru 
+    
+     Django funguje pomocou "protokolu WSGI", ktorý je štandardom pre obsluhu webových stránok pomocou Pythonu, a ktorý PythonAnywhere podporuje. Aby PythonAnywhere rozpoznal náš Django blog, musíme upraviť WSGI konfiguračný súbor.
+    
+    Klikni na link "WSGI configuration file" (v časti "Code" v hornej časti stránky -- bude sa volať nejako takto `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`) a dostaneš sa do editora.
+    
+    Zmaž celý obsah a nahraď ho nasledovným:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+Úlohou tohto súboru je oznámiť PythonAnywhere kde sa naša aplikácia nachádza a aký je názov súboru s Django nastaveniami.
+
+`StaticFilesHandler` sa stará o naše CSS. O toto sa stará automaticky príkaz `runserver`, počas vývoja na lokálnom počítači. O statických súboroch sa naučíme trochu viac neskôr, keď budeme upravovať CSS pre našu stránku.
 
 Klikni na **Save** a vráť sa na kartu **Web**.
 
@@ -299,26 +233,24 @@ Hotovo! Klikni na veľké zelené tlačidlo **Reload** a potom sa už môžeš p
 
 ## Tipy pre ladenie
 
-Ak pri pokuse navštíviť svoju stránku uvidíš chybu, prvým miestom, kde hľadať problém je **error log**. Odkaz naňho nájdeš na PythonAnywhere v [karte Web][8]. Pozri, či tam nie sú nejaké chybové hlášky - tie najnovšie sú naspodku. Najčastejšie problémy bývajú:
-
- [8]: https://www.pythonanywhere.com/web_app_setup/
+Ak pri pokuse navštíviť svoju stránku uvidíš chybu, prvým miestom, kde hľadať problém je **error log**. Odkaz naňho nájdeš na PythonAnywhere v [karte Web](https://www.pythonanywhere.com/web_app_setup/). Pozri, či tam nie sú nejaké chybové hlášky - tie najnovšie sú naspodku. Najčastejšie problémy bývajú:
 
-*   Vynechaný krok, ktorý sme robili v konzole: vytvorenie virtualenv, jeho aktivácia, inštalácia Djanga do virtualenvu, spustenie collectstatic, presun databázy.
+- Vynechaný krok, ktorý sme robili v konzole: vytvorenie virtualenv, jeho aktivácia, inštalácia Djanga do virtualenvu, spustenie collectstatic, presun databázy.
 
-*   Chyba v ceste virtualenv v karte Web -- ak je nejaký problém, zvyčajne tam bude malá červená chybová hláška.
+- Chyba v ceste virtualenv v karte Web -- ak je nejaký problém, zvyčajne tam bude malá červená chybová hláška.
 
-*   Chyba vo WSGI konfiguračnom súbore -- zadala si cestu do adresára my-first-blog správne?
+- Chyba vo WSGI konfiguračnom súbore -- zadala si cestu do adresára my-first-blog správne?
 
-*   Vybrala si si rovnakú verziu Pythonu pre virtualenv ako pre webovú aplikáciu? Obidve by mali byť 3.4.
+- Vybrala si si rovnakú verziu Pythonu pre virtualenv ako pre webovú aplikáciu? Obidve by mali byť 3.6.
 
-*   Môžeš skúsiť aj [Všeobecné tipy na ladenie na PythonAnywhere wiki][9].
-
- [9]: https://www.pythonanywhere.com/wiki/DebuggingImportError
+Môžeš skúsiť aj [Všeobecné tipy na ladenie na PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
 
 A nezabudni, tvoj tréner je tu na to, aby ti pomohol!
 
 # Si online!
 
-Hlavná stránka tvojej aplikácie by ťa mala vítať nápisom "Welcome to Django", tak ako na tvojom počítači. Skús pridať `/admin/` na koniec adresy URL, a budeš presmerovaná na stránky administrácie. Prihlás sa s užívateľským menom a heslom a uvidíš, že môžeš pridávať nové príspevky (posty) na server.
+Hlavná stránka tvojej aplikácie by ťa mala vítať nápisom "It worked!", tak ako na tvojom počítači. Skús pridať `/admin/` na koniec adresy URL, a budeš presmerovaná na stránky administrácie. Prihlás sa s užívateľským menom a heslom a uvidíš, že môžeš pridávať nové príspevky (posty) na server.
+
+Keď vytvoríš niekolľko príspevkov, môžeš sa vrátiť do tvojho lokálneho prostredia (nie PythonAnywhere). Na zmenách by si mala pracovať v lokálnom prostredí. To je štandardný pracovný postup pri vývoji webových aplikácií - urobíš zmeny lokálne, dáš tieto zmeny na GitHub a stiahneš zmeny na svoj webový server. To ti umožní pracovať a experimentovať bez pokazenia živej webovej stránky. Docela cool, nie?
 
-*OHROMNE* sa potľapkaj po chrbte! Nasadenie serveru je jedna z najzradnejších častí vývoja web stránok a často zaberie ľuďom aj niekoľko dní, kým to spojazdnia. Ale ty už máš teraz svoju stránku online, na skutočnom internete!
+*OHROMNE* sa potľapkaj po chrbte! Nasadenie serveru je jedna z najzradnejších častí vývoja web stránok a často zaberie ľuďom aj niekoľko dní, kým to spojazdnia. Ale ty už máš teraz svoju stránku online, na skutočnom internete!
\ No newline at end of file
diff --git a/sk/deploy/install_git.md b/sk/deploy/install_git.md
index 584d4bcd159..80abc7b0db0 100755
--- a/sk/deploy/install_git.md
+++ b/sk/deploy/install_git.md
@@ -1,19 +1,52 @@
-### Windows
+Git je "systém na správu verzií", ktorý využíva množstvo programátorov. Tento softvér sleduje v priebehu času zmeny v tvojich súboroch, takže sa kedykoľvek môžeš vrátiť ku konkrétnej verzii. Niečo ako funkcia "sledovať zmeny" vo Worde, ale oveľa výkonnejšie.
+
+## Inštalácia Gitu
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
 
 Git si môžeš stiahnuť z [git-scm.com](https://git-scm.com/). Môžeš bez obáv klikať na "ďalej ďalej ďalej" pri všetkých krokoch okrem jedného. V kroku 5, označenom ako "Nastavenie prostredia PATH", zvoľ "Spustiť Git a príslušné Unixové nástroje z príkazového riadku systému Windows" (spodná možnosť). V ostatných prípadoch sú predvolené nastavenia v poriadku. Možnosť "Checkout Windows-style, commit Unix-style line endings" je OK.
 
-### MacOS
+Nezabudnite reštartovať príkazový riadok alebo powershell po úspešnom dokončení inštalácie. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
 
 Stiahni si Git z [git-scm.com](https://git-scm.com/) a riaď sa inštrukciami.
 
-### Linux
+> **Poznámka:** Ak používate OS X 10.6, 10.7 alebo 10.8, budete musieť nainštalovať verziu git-tu odtialto: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
 
-Ak ho ešte nemáš nainštalovaný, git by mal byť dostupný pomocou správcu balíčkov, takže vyskúšaj:
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
 
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
 ```
-sudo apt-get install git
-# or
-sudo yum install git
-# or
-sudo zypper install git
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
 ```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sk/deploy/signup_pythonanywhere.md b/sk/deploy/signup_pythonanywhere.md
index d0bd7bbc141..ca66bd0de69 100755
--- a/sk/deploy/signup_pythonanywhere.md
+++ b/sk/deploy/signup_pythonanywhere.md
@@ -1,5 +1,5 @@
-Je čas prihlásiť sa zdarma k účtu "Beginner" na PythonAnywhere.
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
 
-  * [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
 
-> **Poznámka** Pri výbere používateľského mena, mysli na to, že URL tvojho blogu bude v tvare `tvojeuzivatelskemeno.pythonanywhere.com`, takže si vyber prezývku alebo názov o čom tvoj blog je.
\ No newline at end of file
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/sk/django/README.md b/sk/django/README.md
index b63ab11c197..6173c1f402a 100755
--- a/sk/django/README.md
+++ b/sk/django/README.md
@@ -1,26 +1,26 @@
 # Čo je Django?
 
-Django (*džängou*) je bezplatný a open source webový framework na vytváranie webových aplikácií, napísaný v Pythone. Webový framework je súbor komponentov, ktoré ti pomôžu vytvárať stránky rýchlejšie a ľahšie.
+Django (*džängou*) je bezplatný a open source webový framework na vytváranie webových aplikácií, a je napísaný v Pythone. Webový framework je súbor komponentov, ktoré ti pomôžu vytvárať stránky rýchlejšie a ľahšie.
 
 Pri tvorení webových stránok, potrebuješ vždy sadu podobných komponentov: spôsob, ako riešiť autentifikáciu užívateľov (registráciu, prihlásenie, odhlásenie), kontrolný panel web stránky, formuláre, spôsob, ako nahrávať súbory, atď.
 
-Našťastie si iní ľudia už dávno všimli, že weboví vývojári čelia pri tvorbe nového webu podobným problémom, takže sa spojili a vytvorili frameworky (Django je jedným z nich) a tie ti poskytujú hotové komponenty, ktoré môžeš používať.
+Našťastie si iní ľudia už dávno všimli, že weboví vývojári čelia pri tvorbe nového webu podobným problémom, takže sa spojili a vytvorili frameworky (Django je jedným z nich) a tie ti poskytujú hotové komponenty, ktoré môžeš použiť.
 
-Frameworky sú tu na to, aby si nemusela znovu vynájsť koleso. Pomôžu ti uľahčiť tvorbu nových web stránok.
+Frameworky sú tu na to, aby si nemusela znovu vynájsť koleso. Uľahčia ti tvorbu nových web stránok.
 
 ## Prečo potrebuješ framework?
 
-Aby sme pochopili, čo vlastne Django je, potrebujeme sa zblízka pozrieť na servery. Prvá vec, čo o nich musíš vedieť, je, že budú obsluhovať tvoju stránku.
+Aby sme pochopili, čo vlastne Django je, potrebujeme sa zblízka pozrieť na serveri. Prvá vec, čo o nich musíš vedieť, je, že budú obsluhovať tvoju stránku.
 
-Predstav si poštovú schránku (port), na ktorej sa sledujú prichádzajúce listy (žiadosti). To vlastne robí web server. Web server prečíta list a pošle odpoveď v podobe web stránky. Ale ak chceš niečo poslať, potrebuješ mať nejaký obsah. A Django je to, čo ti obsah pomôže vytvoriť.
+Predstav si poštovú schránku (port), na ktorej sa sledujú prichádzajúce listy (žiadosti). To vlastne robí web server. Web server si prečíta list a pošle odpoveď v podobe web stránky. Ale ak chceš niečo poslať, potrebuješ mať nejaký obsah. A Django je to, čo ti ten obsah pomôže vytvoriť.
 
-## Čo sa stane, ak niekto požaduje z tvojho servera web stránku?
+## Čo sa stane, ak niekto požiada web stránku z tvojho servera?
 
-Keď na webový server príde žiadosť, tá je preposlaná do Djanga, ktoré sa pokúsi zistiť, čoho sa vlastne žiadosť týka. Najprv si zoberie adresu webstránky a zisťuje, čo má urobiť. Túto časť vykonáva Django **urlresolver** (všimni si, že adresa webstránku sa nazýva - Uniform Resource Locator - URL, takže názov *urlresolver* dáva zmysel). Nie je to nič extra inteligentné - zoberie zoznam vzorov a porovnáva ich s URL. Django overuje vzory od vrchu po spodok a ak nájde zhodu, Django pošle žiadosť príslušnej funkcii (ktorá sa nazýva *view* - pohľad).
+Keď na webový server príde žiadosť, tá je preposlaná do Djanga, ktoré sa pokúsi zistiť, čoho sa vlastne žiadosť týka. Najprv si zoberie adresu webstránky a zisťuje, čo má urobiť. Túto časť vykonáva Django **urlresolver** (všimni si, že adresa webstránku sa nazýva - Uniform Resource Locator - URL, takže názov *urlresolver* dáva zmysel). Nie je to žiadna veda - zoberie zoznam vzorov (patterns) a porovnáva ich s URL. Django overuje vzory od vrchu smerom dolu a ak nájde zhodu, pošle žiadosť príslušnej funkcii (ktorá sa nazýva *view* - pohľad).
 
 Predstav si poštárku s listom. Kráča ulicou a porovnáva čísla domov s číslom na liste. Ak sa zhoduje, nechá tam list. Takto funguje urlresolver!
 
-Vo funkcii *view* sa dejú všetky zaujímavé veci: môžeme sa pozrieť do databázy a vyhľadať nejaké informácie. Čo ak užívateľ požiada o zmenu v údajoch? Napríklad listom, v ktorom je žiadosť "Prosím, zmeňte popis mojej práce." *view* overí, či máš oprávnenie na túto zmenu, potom aktualizuje popis tvojej práce a naspäť pošle správu: "Hotovo!". Potom *view* vygeneruje odpoveď a Django ju môže odoslat tvojmu webovému prehliadaču.
+Vo funkcii *view* sa dejú všetky zaujímavé veci: môžeme sa pozrieť do databázy a vyhľadať nejaké informácie. Čo ak užívateľ požiada o zmenu v údajoch? Napríklad listom, v ktorom je žiadosť "Prosím, zmeňte popis mojej práce." *view* overí, či máš oprávnenie na túto zmenu, potom aktualizuje popis tvojej práce a naspäť pošle správu: "Hotovo!". Následne *view* vygeneruje odpoveď a Django ho pošle do uživateľovho prehliadača.
 
 Samozrejme, vyššie uvedený popis je trochu zjednodušený, ale zatiaľ ešte nepotrebuješ vedieť všetky technické detaily. Pre všeobecnú predstavu to však stačí.
 
diff --git a/sk/django_admin/README.md b/sk/django_admin/README.md
index 660bd303332..f54188be183 100755
--- a/sk/django_admin/README.md
+++ b/sk/django_admin/README.md
@@ -4,6 +4,8 @@ Na pridávanie, editovanie a mazanie postov, ktoré sme práve namodelovali, bud
 
 Otvorme súbor `blog/admin.py` a nahraďme jeho obsah týmto:
 
+{% filename %}blog/admin.py{% endfilename %}
+
 ```python
 from django.contrib import admin
 from .models import Post
@@ -13,37 +15,43 @@ admin.site.register(Post)
 
 Ako vidíš, importujeme model Post definovaný v predchádzajúcej kapitole. Aby bol náš model viditeľný na adminskej stránke, musíme ho zaregistrovať pomocou `admin.site.register(Post)`.
 
-OK, je čas pozrieť sa na náš Post model. Nezabudni v konzole spustiť web server pomocou príkazu `python manage.py runserver`. Spusti prehliadač a zadaj adresu http://127.0.0.1:8000/admin/. Uvidíš takúto prihlasovaciu stránku:
+OK, je čas pozrieť sa na náš Post model. Nezabudni v konzole spustiť web server pomocou príkazu `python manage.py runserver`. V prehliadači zadaj adresu http://127.0.0.1:8000/admin/. Zobrazí sa ti takáto prihlasovacia stránka:
 
-![Prihlasovacia stránka][1]
+![Prihlasovacia stránka](images/login_page2.png)
 
- [1]: images/login_page2.png
+Pre prihlásenie musíš vytvoriť *superusera* - užívateľa, ktorý má kontrolu nad všetkým na stránke. Vráť sa do príkazového riadku, napíš `python manage.py createsuperuser` a stlač enter.
 
-Pre prihlásenie musíš vytvoriť *superusera* - užívateľa, ktorý má kontrolu nad všetkým na stránke. Vráť sa do príkazového riadku, napíš `python manage.py createsuperuser` a stlač enter. Po výzve zadaj svoje meno (malé písmená, bez medzier), emailovú adresu a heslo. Ak nevidíš heslo, ktoré zadávaš, tým sa netráp - tak to má byť. Len ho zadaj a pokračuj stlačením `enter`. Výstup by mal vyzerať asi takto (kde užívateľské meno a email by mali byť tvoje vlastné):
+> Ak chceš zadať viac príkazov, kým web server beží, otvor nové okno terminálu a aktivuj svoj virtualenv. Ako písať príkazy sme si povedali v kapitole **Tvoj prvý Django projekt!** v odstavci **Spustenie webového serveru**.
 
-```
-(myvenv) ~/djangogirls$ python manage.py createsuperuser
-Username: admin
-Email address: admin@admin.com
-Password:
-Password (again):
-Superuser created successfully.
-```
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
 
-Vráť sa do prehliadača. Prihlás sa zvolenými údajmi ako superuser, mala by sa ti zobraziť nástenka (dashboard) Django admina.
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
 
-![Django admin][2]
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
 
- [2]: images/django_admin3.png
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
 
-Prejdi do Postov a trochu experimentuj. Pridaj päť či šesť blog postov. Netráp sa veľmi s obsahom - trebárs skopíruj a vlož text z tohto tutorialu, nech ušetríš čas :).
+![Django admin](images/django_admin3.png)
 
-Uisti sa, že aspoň dva alebo tri posty (ale nie všetky) majú nastavený dátum publikovania. Bude to neskôr užitočné.
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
 
-![Django admin][3]
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
 
- [3]: images/edit_post3.png
+![Django admin](images/edit_post3.png)
 
-Ak chceš vedieť viac o Django admine, pozri si dokumentáciu Djanga: https://docs.djangoproject.com/en/1.8/ref/contrib/admin/
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
 
-Teraz je asi vhodný čas dať si kávu (alebo čaj), alebo niečo pod zub a nabrať trochu energie. Práve si vytvorila svoj prvý Django model - zaslúžiš si trochu oddychu!
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/sk/django_forms/README.md b/sk/django_forms/README.md
index abc352653b9..fc92ec8c1bb 100755
--- a/sk/django_forms/README.md
+++ b/sk/django_forms/README.md
@@ -4,18 +4,19 @@ Posledná vec, ktorú chceme urobiť na našej web stránke je vytvoriť príjem
 
 Na Django formulároch je fajn, že ich môžeme vytvoriť úplne od nuly alebo vytvoriť `ModelForm`, ktorý uloží výsledok formulára do modelu.
 
-To je presne, čo chceme robiť: vytvoríme formulár pre náš `Post` model.
+A toto je presne to, čo chceme urobiť: vytvoríme formulár pre náš `Post` model.
 
 Tak ako všetky ostatné dôležité časti Djanga, formuláre majú svoj vlastný súbor: `forms.py`.
 
 Musíme vytvoriť súbor s týmto názvom v adresári `blog`.
 
-```
-blog
- └── forms.py
-```
+    blog
+       └── forms.py
+    
 
-OK, otvorme to a napíšme tento kód:
+OK, otvorme ho a napíšme nasledovný kód:
+
+{% filename %}blog/forms.py{% endfilename %}
 
 ```python
 from django import forms
@@ -29,30 +30,34 @@ class PostForm(forms.ModelForm):
         fields = ('title', 'text',)
 ```
 
-Najskôr musíme importovať Django formuláre (`from django import forms`) a, samozrejme, náš `Post` model (`from .models import Post`).
+Najskôr musíme naimportovať Django formuláre (`from django import forms`) a samozrejme aj náš `Post` model (`from .models import Post`).
 
-`PostForm`, ako asi správne predpokladáš, je meno nášho formulára. Musíme Djangu povedať, že tento formulár je `ModelForm` (aby Django pre nás mohlo trochu čarovať) - za to je zodpovedný `forms.ModelForm`.
+`PostForm`, ako asi správne predpokladáš, je názov nášho formulára. Musíme Djangu povedať, že tento formulár je `ModelForm` (aby Django pre nás mohlo trochu čarovať) - za to je zodpovedný `forms.ModelForm`.
 
 Ďalej máme `triedu Meta`, kde Djangu povieme, ktorý model by mal byť použitý na vytvorenie tohto formulára (`model = Post`).
 
-Nakoniec môžeme Djangu povedať, ktoré formuláre budú v našom formulári. Pri tomto scenári, chceme boli zobrazené iba `title` (nadpis) a `text` - `author` by mala byť aktuálne prihlásená osoba (teda ty!) a dátum vytvorenia `created_date` by mal automaticky nastavený pri vytvorení postu (t.j. v kóde).
+Nakoniec môžeme Djangu povedať, ktoré formuláre budú v našom formulári. V tomto scenári, chceme aby boli zobrazené iba `title` (nadpis) a `text` - `author` by mala byť aktuálne prihlásená osoba (teda ty!) a dátum vytvorenia `created_date` by mal byť automaticky nastavený pri vytvorení postu (t.j. v kóde), však?
 
 To je všetko! Jediné, čo treba teraz urobiť, je použiť formulár v *zobrazení* (angl. view) a zobraziť ho v šablóne.
 
-Takže ešte raz vytvoríme: link na stránku, URL, zobrazenie a šablónu.
+Takže ešte raz vytvoríme link na stránku, URL, zobrazenie a šablónu.
 
 ## Link na stránku s formulárom
 
 Je čas otvoriť `blog/templates/blog/base.html`. Pridáme link do `divu` s názvom `page-header`:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Všimni si, že chceme zavolať náš nový view (zobrazenie) `post_new`.
+Všimnite si, že chceme zavolať naše nové view `post_new`. Trieda `"glyphicon glyphicon-plus"` je poskytnutá bootstrap témou ktorú používame a ona zobrazí znamienko plus pre nás.
 
 Po pridaní riadku by tvoj html súbor mal vyzerať asi takto:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -86,34 +91,42 @@ Keď uložíš a obnovíš stránku http://127.0.0.1:8000 uvidíš samozrejme zn
 
 Otvor `blog/urls.py` a pridaj riadok:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 url(r'^post/new/$', views.post_new, name='post_new'),
 ```
 
 A výsledný kód bude vyzerať takto:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
     url(r'^post/new/$', views.post_new, name='post_new'),
 ]
 ```
 
-Po obnovení stránky uvidíme chybu `AttributeError`, pretože nemáme implementovaný view (zobrazenie) `post_new`. Pridajme ho teraz.
+Po obnovení stránky uvidíme chybu `AttributeError`, pretože nemáme implementovaný view `post_new`. Pridajme ho teraz.
 
-## view (zobrazenie) post_new
+## view post_new
 
 Teraz otvoríme súbor `blog/views.py` a pridáme tam nasledujúce riadky so zvyškom importovacích riadkov `from`:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from .forms import PostForm
 ```
 
-a náš *view*:
+A potom náš *view*:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -127,17 +140,17 @@ Nový formulár `Post` vytvoríme tak, že sputíme `PostForm()` a prepošleme h
 
 Musíme vytvoriť súbor `post_edit.html` v adresári `blog/ templates/blog`. Aby formulár fungoval, potrebujeme niekoľko vecí:
 
-*   musíme zobraziť formulár. To môžeme urobiť jednoducho takto `{% raw %}{{ form.as_p }}{% endraw %}`.
-*   riadok vyššie musí byť obalený HTML tagom: `<form method="POST">...</form>`
-*   potrebujeme tlačidlo `Uložiť`. Vytvoríme ho ako HTML tlačidlo: `<button type="submit">Uložiť</button>`
-*   a nakoniec, hneď za otváracím tagom `<form ...>` musíme pridať `{% raw %}{% csrf_token %}{% endraw %}`. Toto je veľmi dôležité, vďaka tomu je formulár bezpečný! Ak na túto časť zabudneš, Django sa bude pri ukladaní formuláru sťažovať:
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* Riadok vyššie musí byť obalený HTML tagom: `<form method="POST">...</form>`.
+* Potrebujeme tlačidlo `Uložiť`. Vytvoríme ho ako HTML tlačidlo: `<button type="submit">Uložiť</button>`.
+* A nakoniec, hneď za otváracím tagom `<form ...>` musíme pridať `{% raw %}{% csrf_token %}{% endraw %}`. Toto je veľmi dôležité, vďaka tomu je formulár bezpečný! Ak si na to zabudla, Django sa bude sťažovať keď sa pokúsiš uložiť formulár:
 
-![CSFR Zakázaná stránka][1]
-
- [1]: images/csrf2.png
+![CSFR Zakázaná stránka](images/csrf2.png)
 
 OK, pozrime sa, ako by malo vyzerať HTML v `post_edit.html`:
 
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -152,11 +165,9 @@ OK, pozrime sa, ako by malo vyzerať HTML v `post_edit.html`:
 
 Obnovíme stránku! Aha! Tvoj formulár je na svete!
 
-![Nový formulár][2]
+![Nový formulár](images/new_form2.png)
 
- [2]: images/new_form2.png
-
-Ale počkaj chvíľku! Keď niečo zadáš niečo do polí `title` a `text` a skúsiš to uložiť - čo sa stane?
+Ale počkaj! Keď zadáš niečo do polí `title` a `text` a skúsiš to uložiť - čo sa stane?
 
 Nič! Sme stále na rovnakej stránke a náš text je preč... a žiaden nový príspevok sa nepridal. Takže čo sa pokazilo?
 
@@ -166,6 +177,8 @@ Odpoveď znie: nič. Akurát budeme mať ešte trochu práce v našom *view* (zo
 
 Znova otvor `blog/views.py`. Momentálne máme v `post_new` len toto:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 def post_new(request):
     form = PostForm()
@@ -174,25 +187,31 @@ def post_new(request):
 
 Keď odošleme formulár, vrátime sa do rovnakého view, ale teraz už máme v `request` aj nejaké údaje, presnejšie v `request.POST` (názov nemá nič spoločné s "postom" na blogu, ide len o to, že posielame - "postujeme" údaje). Pamätáš si, že naša definícia formuláru `<form>` v HTML súbore mala premennú `method="POST"`? Všetky polia z formulára sú teraz v `request.POST`. `POST` by si nemala premenovať na nič iné (jediná ďalšia platná hodnota pre premennú `method` je `GET`, teraz ale nemáme čas vysvetliť si rozdiel).
 
-Takže v našom *view* máme vyriešiť dve samostatné situácie. Po prvé: keď prídeme na stránku po prvýkrát a chceme prázdny formulár. Po druhé: keď sa vrátime do *view* so všetkými vyplnenými údajmi formulára. Takže potrebujeme pridať podmienku (na to použijeme `if`).
+Takže v našom *view* musíme ošetriť dva rôzne prípady: prvý, ak pristupujeme na stránku prvýkrát a chceme prázdny formulár, a druhý, keď sa vrátime na *view* s už predvyplnenými údajmi formulára. Takže potrebujeme pridať podmienku (na to použijeme `if`):
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 if request.method == "POST":
-     [...]
+    [...]
 else:
-     form = PostForm()
+    form = PostForm()
 ```
 
-Je čas na vyplnenie bodky `[...]`. Ak `method` je `POST` potom chceme vytvoriť `PostForm` s údajmi z formulára, však? To urobíme takto:
+Je čas nahradiť tri bodky `[...]`. Ak ide o `metódu` `POST` tak cheme vytvoriť `PostForm` s datami z formulára, však? Urobíme to takto:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST)
 ```
 
-Ľahké! Ďalej skontrolujme či je formulár v poriadku (všetky povinné polia sú vyplnené a nie sú zadané žiadne nesprávne hodnoty). To urobíme pomocou `form.is_valid()`.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
 
 Skonotrolujeme, či je formulár platný a ak áno, môžeme ho uložiť!
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 if form.is_valid():
     post = form.save(commit=False)
@@ -201,23 +220,29 @@ if form.is_valid():
     post.save()
 ```
 
-V podstate urobím dve veci: uložíme formulár pomocou `form.save` a pridáme autora (keďže pole `author` nebolo v `PostForm` nebolo, no toto pole je povinné!). `commit=False` znamená, že ešte nechce uložiť model `Post` - najskôr chceme pridať autora. Väčšinou budeš používať `form.save()` bez `commit=False`, no v tomto prípade, to takto musíme spraviť. `post.Save()` uchová zmeny (pridanie autora) a máme vytvorený nový blog post!
+V podstate urobím dve veci: uložíme formulár pomocou `form.save` a pridáme autora (keďže pole `author` nebolo v `PostForm`, avšak toto pole je povinné). `commit=False` znamená, že ešte nechceme uložiť model `Post` - najskôr chceme pridať autora. Väčšinou budeš používať `form.save()` bez `commit=False`, no v tomto prípade, to takto musíme spraviť. `post.save()` uchová zmeny (pridanie autora) a máme vytvorený nový blog príspevok!
+
+A bolo by skvelé, keby sme sa potom ihneď dostali na stránku `post_detail` nášho novovytvoreného blog postu, nie? Aby sme to vedeli urobiť, budeme potrebovať ešte jeden import:
 
-A bolo by skvelé, keby sme sa potom ihneď dostali na stránku `post_detail` nášho novovytvoreného blog postu, nie? Na to ale budeme potrebovať ešte jeden import:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import redirect
 ```
 
-Pridaj to úplne na začiatok súboru. A teraz môžeme povedať: prejdi na stránku `post_detail` novovytvoreného postu.
+Pridaj tento riadok úplne na začiatok súboru. A teraz môžeme povedať: prejdi na stránku `post_detail` novovytvoreného príspevku":
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    return redirect('post_detail', pk=post.pk)
+return redirect('post_detail', pk=post.pk)
 ```
 
-`post_detail` je názov view - zobrazenia, kam chceme ísť. Spomínaš si, že tento *view* vyžaduje premennú `pk`? Aby sme ju odovzdali zobrazenia, použijeme `pk=post.pk`, kde `post` je novo vytvorený blog post!
+`blog. views. post_detail` je názov view, kam chceme ísť. Spomínaš si, že tento *view* vyžaduje premennú `pk`? Aby sme ju odovzdali do view, použijeme `pk=post.pk`, kde `post` je novovytvorený blog post!
+
+OK, dosť sme hovorili, už je na čase pozrieť sa ako teraz vyzerá celý *view*, však?
 
-Ok, dosť sme hovorili, ale asi by bolo dobré pozrieť sa ako celý *view* vyzerá, však?
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -234,35 +259,33 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Pozrime sa, či to funguje. Poď na stránku http://127.0.0.1:8000/post/new/, pridaj `title` a `text`, ulož to... and voilà! Nový blog post je pridaný my sme presmerovaní na stránku `post_detail`!
+Pozrime sa, či funguje. Poď na stránku http://127.0.0.1:8000/post/new/, pridaj `title` a `text`, ulož to... a voilà! Nový blog post je pridaný a my sme presmerovaní na stránku `post_detail`!
 
 Možno si si všimla, že pred uložením postu nastavujeme dátum publikovania. Neskôr v **Django Girls Tutorial: Rozšírenie** sa zoznámime s *tlačidlom Publikovať*.
 
 To je úžasné!
 
+> Keďže sme nedávno použili administrátorské rozhranie Djanga, systém si myslí, že sme stále prihlásení. Existuje zopár situácií, ktoré by mohli spôsobiť odhlásenie (zatvorenie prehliadača, reštart databázy a podobne). Pokiaľ by sa ti zobrazovala chyba pri vytváraní postu upozorňujúca na neprihláseného užívateľa, choď na adminskú stránku http://127.0.0.1:8000/admin and prihlás sa znova. Toto dočasne vyrieši problém. Čaká však na teba aj permanentné riešenie v kapitole **Domáca úloha: zvýš svojej stránke bezpečnosť!** po skončení hlavného tutorialu.
+
+![Chyba prihlásenia](images/post_create_error.png)
+
 ## Validácia formuláru
 
 Teraz si ukážeme, aké sú Django formuláre super. Príspevok na blogu (post) musí mať polia `title` a `text`. V našom modeli `Post` sme nepovedali (na rozdiel od `published_date`), že tieto polia sú nepovinné, takže Django štandardne očakáva, že budú nastavené.
 
-Skús uložiť formulár bez `title` a `text`. Hádaj, čo sa stane!
-
-![Validácia formuláru][3]
+Skús uložiť formulár bez `title` a `text`. Pokús sa uhádnuť, čo sa stane!
 
- [3]: images/form_validation2.png
+![Validácia formuláru](images/form_validation2.png)
 
 Django overí, či sú všetky polia formulára správne. Nie je to skvelé?
 
-> Keďže sme nedávno použili administrátorské rozhranie Djanga, systém si myslí, že sme prihlásení. Existuje zopár situácií, ktoré by mohli spôsobiť odhlásenie (zatvorenie prehliadača, reštart databázy a podobne). Pokiaľ by sa ti zobrazovala chyba pri vytváraní postu upozorňujúca na neprihláseného užívateľa, choď na adminskú stránku http://127.0.0.1:8000/admin and prihlás sa znova. Toto dočasne vyrieši problém. Čaká však na teba aj permanentné riešenie v kapitole **Domáca úloha: zvýš svojej stránke bezpečnosť!** po skončení hlavného tutorialu.
-
-![Chyba prihlásenia][4]
-
- [4]: images/post_create_error.png
-
 ## Úprava formuláru
 
-Teraz už vieme, ako sa pridáva nový formulár. Ale čo ak chceme upravovať existujúci? Veľmi podobne, ako to, čo sme práve spravili. Vytvorme rýchlo pár dôležitých vecí (ak niečomu nerozumieš, opýtaj sa svojho trénera alebo sa pozri na predchádzajúce kapitoly, pretože všetky tieto kroky sme si už prebrali).
+Teraz už vieme, ako sa pridáva nový formulár. Ale čo ak chceme upravovať existujúci? Je to veľmi podobné tomu, čo sme práve spravili. Poďme rýchlo vytvoriť niektoré dôležité veci. (ak niečomu nerozumieš, opýtaj sa svojho trénera alebo sa pozri na predchádzajúce kapitoly, pretože všetky tieto kroky sme si už prebrali.)
 
-Otvor `blog/templates/blog/post_detail.html` a pridaj tento riadok:
+Otvor `blog/templates/blog/post_detail.html` a pridaj tento riadok
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
@@ -270,6 +293,8 @@ Otvor `blog/templates/blog/post_detail.html` a pridaj tento riadok:
 
 takže šablóna teraz bude vyzerať takto:
 
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -289,13 +314,17 @@ takže šablóna teraz bude vyzerať takto:
 
 V `blog/urls.py` pridáme tento riadok:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-         url(r'^post/(?P<pk>[0-9]+)/edit/$', views.post_edit, name='post_edit'),
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
 ```
 
 Znova použijeme šablónu `blog/templates/blog/post_edit.html`, takže posledná vec, čo nám chýba je *view*.
 
-Otvorme 0>blog/views.py</code> a na úplný koniec súboru pridaj toto:
+Otvor `blog/views.py` a na úplný koniec súboru pridaj toto:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_edit(request, pk):
@@ -313,13 +342,17 @@ def post_edit(request, pk):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-To vyzerá skoro tak isto ako náš view `post_new`, však? Ale nie úplne. Po prvé: odovzdávame navyše parameter `pk` z URL. A ďalej: pomocou `get_object_or_404(Post, pk=pk)` dostaneme model `Post`, ktorý chceme upravovať a potom pri vytváraní formuláru odovzdávame tento post ako parameter `instance`, keď budeme formulár ukladať:
+To vyzerá skoro tak isto ako náš view `post_new`, však? Ale nie úplne. Po prvé: odovzdávame navyše parameter `pk` z URL. A ďalej: pomocou `get_object_or_404(Post, pk=pk)` získame `Post` model, ktorý chceme upravovať a následne pri vytváraní formuláru odovzdáme tento post ako parameter `instance`, aj v prípade keď ukladáme formulár…
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST, instance=post)
 ```
 
-a tiež keď sme formulár otvorili s týmto postom určeným na úpravu:
+…aj v prípade keď sme otvorili formulár za účelom úpravy daného príspevku:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(instance=post)
@@ -327,33 +360,33 @@ form = PostForm(instance=post)
 
 OK, vyskúšajme, či to funguje! Poďme na stránku `post_detail`. V pravom hornom rohu by malo byť tlačidlo na úpravu:
 
-![Tlačidlo Upraviť][5]
-
- [5]: images/edit_button2.png
-
-Keď naňho klikneš, uvidíš formulár s našim blog postom:
+![Tlačidlo Upraviť](images/edit_button2.png)
 
-![Úprava formuláru][6]
+Keď naňho klikneš, uvidíš formulár s našim blog príspevkom:
 
- [6]: images/edit_form2.png
+![Úprava formuláru](images/edit_form2.png)
 
 Môžeš si vyskúšať zmeniť názov alebo text a uložiť zmeny!
 
 Gratulujeme! Tvoja aplikácia je čím ďalej dokonalejšia!
 
-Ak potrebuješ viac informácií o Django formulároch, prečítaj si dokumentáciu: https://docs.djangoproject.com/en/1.8/topics/forms/
+Ak potrebuješ viac informácií o Django formulároch, prečítaj si dokumentáciu: https://docs.djangoproject.com/en/1.11/topics/forms/
 
 ## Bezpečnosť
 
-Možnosť vytvárať nové posty len kliknutím na link je úžasná! Ale, v tejto chvíli, ktokoľvek, kto navštívi tvoju stránku, bude môcť pridať nový blog post a to asi nie je presne to, čo by si chcela. Urobme to tak, že sa tlačidlo zobrazí nikomu inému okrem teba.
+Možnosť vytvárať nové príspevky len kliknutím na link je úžasná! Ale, v tejto chvíli, každý kto navštívi tvoju stránku, bude môcť pridať nový blog post a to asi nie je to, čo by si chcela. Urobme to tak, že sa tlačidlo zobrazí len tebe.
 
 V `blog/templates/blog/base.html` nájdi náš `div` `page-header` a kotviaci tag, ktorý si tam umiestnila už predtým. Mal by vyzerať takto:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Do neho pridáme ďalší tag `{% if %}`, vďaka ktorému sa link zobrazí len užívateľom, ktorí sú prihlásení ako admina. Momentálne si to len ty! Zmeň tag `< >`, aby vyzeral takto:
+Do neho pridáme ďalší tag `{% if %}`, vďaka ktorému sa link zobrazí len užívateľom, ktorí sú prihlásení ako admin. Momentálne si to len ty! Zmeň `<a>` aby vyzeral takto:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% if user.is_authenticated %}
@@ -361,39 +394,54 @@ Do neho pridáme ďalší tag `{% if %}`, vďaka ktorému sa link zobrazí len u
 {% endif %}
 ```
 
-Tento `{% if %}` zabezpečí, aby bol link odoslaný do prehliadača, len ak je používateľ požadujúci stránku prihlásený. Nezabráni to vytváraniu nových postov úplne, ale je to dobrý prvý krok. Viac o bezpečnosti si povieme v rozširujúcich lekciách.
+Tento `{% if %}` zabezpečí, aby bol link odoslaný do prehliadača, len ak je používateľ požadujúci stránku prihlásený. Nezabráni to vytváraniu nových príspevkov úplne, ale je to dobrý prvý krok. Viac o bezpečnosti si povieme v rozširujúcich lekciách.
+
+Spomínaš si na ikonku na upravovanie ktorú sme práve pridali na našu stránku s detailmi? Rovnakú zmenu chceme pridať aj sem, aby iný ludia nemohli upravovať existujúce príspevky.
+
+Otvor `blog/templates/blog/post_detail.html` a pridaj tento riadok:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Zmeň ho na toto:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
 
-Keďže si zrejme prihlásená, ak obnovíš stránku, neuvidíš žiadnu zmenu. Načítaj však stránku v inom prehliadači alebo v inkognito okne a uvidíš, že link sa nezobrazí!
+Kede si pravdepodobne prihlásená, ak obnovíš stránku, neuvidíš nič. Načítaj stránku v inom prehliadači, alebo incognito okne (nazývané "InPrivate" vo Windows Edge) a uvidíš, že sa odkaz nezobrazuje a ikonka tiež nie!
 
 ## Ešte jedna vec: čas nasadiť aplikáciu!
 
 Pozrime sa, či to všetko funguje na PythonAnywhere. Je čas na ďalšie nasadenie!
 
-*   Najprv odovzdaj svoj nový kód a pošli ho na Github
+* Najprv ulož (commit) svoj nový kód a pošli ho na Github:
 
-```
-$ git status
-$ git add -A .
-$ git status
-$ git commit -m "Pridane views na vytvorenie/editovanie blog postu vo vnutri stranky."
-$ git push
-```
+{% filename %}command-line{% endfilename %}
 
-*   Potom v [Bash konzole PythonAnywhere][7]:
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
 
- [7]: https://www.pythonanywhere.com/consoles/
+* Potom v [konzole PythonAnywhere](https://www.pythonanywhere.com/consoles/):
 
-```
-$ cd my-first-blog
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```
+{% filename %}command-line{% endfilename %}
 
-*   A nakoniec preskoč na [kartu Web][8] and klinki na **Reload**.
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
- [8]: https://www.pythonanywhere.com/web_app_setup/
+* A nakoniec preskoč na [kartu Web](https://www.pythonanywhere.com/web_app_setup/) and klinki na **Reload**.
 
-A to by malo byť všetko! Gratulujeme :)
+A to by malo byť všetko! Gratulujeme :)
\ No newline at end of file
diff --git a/sk/django_installation/README.md b/sk/django_installation/README.md
index 77aace25152..53e2319d570 100755
--- a/sk/django_installation/README.md
+++ b/sk/django_installation/README.md
@@ -1,5 +1,7 @@
 # Inštalácia Django
 
+> **Poznámka:** Ak používate Chromebook, preskočte túto kapitolu a postupujte podľa pokynov na [nastavenie Chromebooku](../chromebook_setup/README.md).
+> 
 > **Poznámka** Ak si už prešla krokmi Inštalácie, tak toto už máš hotové a môžeš ísť rovno na ďalšiu kapitolu!
 
 {% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/sk/django_installation/instructions.md b/sk/django_installation/instructions.md
index b35d55ab25f..ed109d4de38 100755
--- a/sk/django_installation/instructions.md
+++ b/sk/django_installation/instructions.md
@@ -1,99 +1,150 @@
-> Časť tejto kapitoly je založené na tutorialoch Geek Girls Carrots (http://django.carrots.pl/).
->
+> Časť tejto kapitoly je založené na tutorialoch Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
 > Časť tejto kapitoly je založená na [django-marcador tutorial](http://django-marcador.keimlink.de/) licencovanej pod medzinárodnou licenciou Creative Commons Attribution-ShareAlike 4.0. Tutoriál django-marcador je autorsky chránený Markusom Zapke-Gründemannom et al.
 
 ## Virtuálne prostredie
 
-Skôr ako nainštalujeme Django, nainštalujeme si extrémne užitočný nástroj, ktorý ti pomôže udržiavať poriadok pri kódovaní v tvojom počítači. Je možné tento krok preskočiť, no veľmi ho odporúčame. Začať s najlepším možným nastavením ti ušetrí kopec problémov v budúcnosti!
+Skôr ako nainštalujeme Django, nainštalujeme si extrémne užitočný nástroj, ktorý ti pomôže udržiavať poriadok pri programovaní na tvojom počítači. Je možné tento krok preskočiť, no veľmi ho odporúčame. Začať s najlepším možným nastavením ti ušetrí kopec problémov v budúcnosti!
 
 Takže poďme vytvoriť **virtuálne prostredie** (alebo aj *virtualenv*). Virtualenv oddelí nastavenia Python/Django pre každý projekt zvlášť. To znamená, že zmeny, ktoré urobíš na jednej web stránke, neovplyvnia iné stránky, ktoré vyvíjaš. Šikovné, však?
 
-Jediné, čo musíš urobiť je nájsť adresár, v ktorom chceš `virtualenv` vytvoriť, napríklad tvoj domovský adresár. Vo Windowse by mohol vyzerať napríklad `C:\Users\Meno` (kde `Meno` predstavuje tvoj login).
+Jediné, čo musíš urobiť je nájsť adresár, v ktorom chceš `virtualenv` vytvoriť, napríklad tvoj domovský adresár. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
 
 V tomto tutoriale budeme používať nový adresár `djangogirls` v tvojom domovskom adresári:
 
-```
-mkdir djangogirls
-cd djangogirls
-```
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
 
 Vytvoríme virtualenv s názvom `myenv`. Všeobecný príkaz má takýto formát:
 
-```
-python3 -m venv myvenv
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Ak chceš vytvoriť nové `virtualenv`, musíš otvoriť príkazový riadok a spustiť `python -m venv myvenv`. Bude to vyzerať takto:
+
+{% filename %}command-line{% endfilename %}
 
-### Windows
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
 
-Ak chceš vytvoriť nový `virtualenv`, musíš otvoriť konzolu (hovorili sme o tom pár kapitol dozadu, pamätáš?) a spusti `C:\Python34\python -m venv myvenv`. Bude to vyzerať takto:
+`myvenv` je názov tvojho `virtualenv`-u. Môžeš použiť aj iný názov, ale používaj malé písmená a žiadne medzery, diakritiku alebo špeciálne znaky. Je tiež dorbé použiť krátky názov, pretože naň budeš často odkazovať!
 
-```
-C:\Users\Meno\djangogirls> C:\Python34\python -m venv myvenv
-```
+<!--endsec-->
 
-kde `C:\Python34\python` je adresár, v ktorom máš nainštalovaný Python a `myvenv` je názov tvojho `virtualenv`-u. Môžeš použiť aj iný názov, ale používaj malé písmená a žiadne medzery, diakritiku alebo špeciálne znaky. Je tiež dobré použiť krátky názov - budeš naňho často odkazovať!
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
 
-### Linux a OS X
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
 
-Vytvoriť `virtualenv` na Linuxe a OS X vyžaduje iba jednoduché spustenie `python3 -m venv myvenv`. Bude to vyzerať takto:
+{% filename %}command-line{% endfilename %}
 
-```
-~/djangogirls$ python3 -m venv myvenv
-```
+    $ python3 -m venv myvenv
+    
 
-`myvenv` je názov tvojho `virtualenv`-u. Môžeš použiť aj iný názov, ale ostaň pri malých písmenách a nepoužívaj medzery. Je tiež dorbé použiť krátky názov, pretože naň budeš často odkazovať!
+`myvenv` je názov tvojho `virtualenv`-u. Môžeš použiť aj iný názov, ale ostaň pri malých písmenách a nepoužívaj medzery. It is also a good idea to keep the name short as you'll be referencing it a lot!
 
-> **POZNÁMKA:** Inicializácia virtuálneho prostredie na Ubuntu 14,04 týmto spôsobom v súčasnosti dáva takúto chybu:
->
+> **POZNÁMKA:** Niektoréverzie systému Debian/Ubuntu môžu zobraziť nasledujúcu chybu:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> V tomto prípade postupuj podľa pokynov uvedených vyššie a nainštaluj si balík `python3-venv`: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **POZNÁMKA:** V niektorých verziách Debian/Ubuntu inicializovanie virtuálneho prostredia týmto spôsobom vráti nasledovnú chybu:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
 >     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
->
->
+>     
+> 
 > Obídeme to týmto príkazom `virtualenv`-u.
->
->     ~/djangogirls$ sudo apt-get install python-virtualenv
->     ~/djangogirls$ virtualenv --python=python3.4 myvenv
->
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **POZNÁMKA:** Ak sa ti objaví chybu ako
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> potom namiesto toho spusti:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
 
 ## Práca s virtualenv
 
 Vyššie uvedený príkaz vytvorí adresár s názvom `myvenv` (alebo akékoľvek meno si vybrala), ktorý obsahuje naše virtuálne prostredie (v podstate kopec adresárov a súborov).
 
-#### Windows
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
 
 Virtuálne prostredie spusti príkazom:
 
-```
-C:\Users\Meno\djangogirls> myvenv\Scripts\activate
-```
+{% filename %}command-line{% endfilename %}
 
-#### Linux a OS X
+    C:\Users\Meno\djangogirls> myvenv\Scripts\activate
+    
 
-Virtuálne prostredie spusti príkazom:
+> **Poznámka:** Vo Windows 10 sa môže vyskytnúť chyba vo Windows PowerShell, ktorá hovorí `execution of scripts is disabled on this system`. V tomto prípade, otvor ďalší Windows PowerShell s možnosťou "Spustiť ako správca". Potom skús spustiť nasledovný príkaz predtým ako aktivuj svoje virtualenv:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
 
-```
-~/djangogirls$ source myvenv/bin/activate
-```
+<!--endsec-->
 
-Nezabudni nahradiť `myvenv` názvom svojho `virtualenv`-u!
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
 
-> **POZNÁMKA:** niekedy `source` nemusí byť k dispozícii. V takom prípade vyskúšaj použiť:
->
->     ~/djangogirls$ . myvenv/bin/activate
->
+Virtuálne prostredie spusti príkazom:
 
-To, že je `virtualenv` spustený, zistíš, keď bude príkazový riadok v konzole vyzerať takto:
+{% filename %}command-line{% endfilename %}
 
-```
-(myvenv) C:\Users\Name\djangogirls>
-```
+    $ source myvenv/bin/activate
+    
 
-alebo:
+Nezabudni nahradiť `myvenv` názvom svojho `virtualenv`-u!
 
-```
-(myvenv) ~/djangogirls$
-```
+> **POZNÁMKA:** niekedy `source` nemusí byť k dispozícii. V takom prípade vyskúšaj použiť:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
 
-Všimni si, že sa tam objavila predpona `(myenv)`!
+<!--endsec-->
+
+To, že je `virtualenv` spustený, zistíš, keď bude príkazový riadok v konzole bude mať na začiatku `(myenv)`.
 
 Pri práci vo virtuálnom prostredí bude `python` automaticky odkazovať na správnu verziu, takže môžeš pokojne používať `python` namiesto `python3`.
 
@@ -101,22 +152,50 @@ OK, všetko potrebné máme prichystané. Konečne môžeme nainštalovať Djang
 
 ## Inštalácia Djanga
 
-Teraz, keď máš `virtualenv` spustený, môžeš nainštalovať Django pomocou príkazu `pip`. V konzole spusti `pip install django==1.8` (všimni si, že používame dvojité rovná sa: `==`).
+Teraz keď máš `virtualenv` spustené, môžeš nainštalovať Django.
+
+Predtým ako to urobíme, mali by sme sa uistiť, že je nainštalovaná najnovšia verzia `pip`, softvéru ktorý použijeme na inštalovanie Djanga:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Potom spusti `pip install django~=1.11.0` (všimni si že používame tildu po ktorej nasleduje znamienko rovná sa: `~=`) aby si nainštalovala Django.
+
+{% filename %}command-line{% endfilename %}
 
-```
-(myvenv) ~$ pip install django==1.8
-Downloading/unpacking django==1.8
-Installing collected packages: django
-Successfully installed django
-Cleaning up...
-```
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
 
-vo Windowse
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
 
-> Ak sa objaví chyba pri spustení pip vo Windowse, skontroluj, či cesta/názov tvojho projektu neobsahuje medzery, diakritiku alebo špeciálne znaky (napr. `C:\Users\Tvoje Meno\djangogirls`). Ak obsahuje, mala by si zvážiť presun na iné miesto, bez medzier, diakritiky a špeciálnych znakov (napríklad: `C:\djangogirls`). Po presune prosím vyskúšaj vyššie uvedený príkaz znova.
+> Ak sa objaví chyba pri spustení pip vo Windowse, skontroluj, či cesta/názov tvojho projektu neobsahuje medzery, diakritiku alebo špeciálne znaky (napr. `C:\Users\Tvoje Meno\djangogirls`). Ak obsahuje, mala by si zvážiť použitie iného miesta, bez medzier, diakritiky a špeciálnych znakov (napríklad: `C:\djangogirls`). Vytvor nové virtualenv v novom adresári, potom odstráň starý a zopakuj vyššie uvedený príkaz. (Presunutie virtualenv adresára nebude fungovať, lebo virtualenv používa absolútne cesty.)
 
-na Linuxe
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Príkazový riadok sa možno zamrazí po tom čo sa pokúsiš nainštalovať Django. Ak sa to stane, namiesto hore uvedeného príkazu použi:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
 
 > Ak sa objaví chyba pri spustejní pip v Ubuntu 12.04 spusti `python -m pip install - U --force-reinstall pip`, čím sa opraví inštalácia pip vo virtualenv-e.
 
-To je všetko! Teraz si už (konečne) pripravená vytvoriť Django aplikáciu!
+<!--endsec-->
+
+To je všetko! Teraz si už (konečne) pripravená vytvoriť Django aplikáciu!
\ No newline at end of file
diff --git a/sk/django_models/README.md b/sk/django_models/README.md
index c8f52509254..72727f2cdea 100755
--- a/sk/django_models/README.md
+++ b/sk/django_models/README.md
@@ -1,6 +1,6 @@
 # Django modely
 
-Teraz pôjdeme vytvoriť niečo, čo bude uchovávať naše posty v blogu. Aby sme to vedeli spraviť, musíme si najskôr povedať niečo o `objektoch`.
+Teraz pôjdeme vytvoriť niečo, čo bude uchovávať naše príspevky v blogu. Aby sme to vedeli spraviť, musíme si najskôr povedať niečo o `objektoch`.
 
 ## Objekty
 
@@ -8,44 +8,47 @@ V programovaní sa používa pojem `objektovo orientované programovanie`. Myšl
 
 Takže čo je to objekt? Je to zbierka vlastností a akcií. Znie to čudne, ale ukážeme si príklad.
 
-Ak chceme modelovať mačku, vytvoríme objekt `Macka`, ktorá má nejaké vlastnosti, napríklad: `farba`, `vek`, `nalada` (t. j. dobra, zla, ospala ;)), a `majitel` (ktorý je objektom `Osoba` alebo možno v prípade túlavej mačky bude táto vlastnosť prázdna).
-
-Ďalej má `Macka` niekoľko akcií: `priast`, `skrabat` alebo `krmit` (v ktorej dáme mačke nejaké `MacacieZradlo`, ktoré by mohlo byť samostatným objektom s vlastnosťami, t.j. `chut`).
-
-```
-Macka
---------
-farba
-vek
-nalada
-majitel
-priast()
-skrabat()
-krmit(mac_zradlo)
-
-
-MacacieZradlo
---------
-chut
-```
+Ak chceme namodelovať mačku, vytvoríme objekt `Macka`, ktorá má nejaké vlastnosti, napríklad: `farba`, `vek`, `nalada` (t. j. dobrá, zlá, ospalá ;)), a `majitel` (ktorý je objektom `Osoba` alebo možno v prípade túlavej mačky bude táto vlastnosť prázdna).
+
+Ďalej má `Macka` niekoľko akcií: `priast`, `skrabat` alebo `krmit` (v ktorej dáme mačke nejaké `MacacieZradlo`, ktoré by mohlo byť samostatným objektom s vlastnosťami, t. j. `chut`).
+
+    Macka
+    --------
+    farba
+    vek
+    nalada
+    majitel
+    priast()
+    skrabat()
+    krmit(mac_zradlo)
+    
+    
+    MacacieZradlo
+    --------
+    chut
+    
+
+    MacacieZradlo
+    --------
+    chut
+    
 
 Takže v podstate myšlienka je popísať reálne veci kódom pomocou vlastností (ktorým hovoríme `vlastnosti objektu/object properties`) a akcií (tie nazývame `metódy`).
 
-Ako teda budeme modelovať blog post? Chceme vytvoriť blog, však?
+Ako teda budeme modelovať blog post? Chceme predsa vytvoriť blog, nie?
 
 Musíme odpovedať na otázku: Čo je vlastne blog post? Aké vlastnosti by mal mať?
 
 No, náš blog post určite potrebuje nejaký text s obsahom a titulkom, nie? Bolo by tiež fajn vedieť, kto ho napísal - takže potrebujeme autora. A nakoniec, chceme vedieť, kedy bol post vytvorený a zverejnený.
 
-```
-Post
---------
-title
-text
-author
-created_date
-published_date
-```
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
 
 Čo všetko môžeme s blog postom robiť? Bolo by dobré mať nejakú `metódu`, ktorá post publikuje, však?
 
@@ -65,34 +68,43 @@ Model v databáze si môžeš predstaviť ako tabuľku so stĺpcami (polia) a ri
 
 Aby sme mali všetko pekne upratané, vytvoríme vo vnútri nášho projektu samostatnú aplikáciu. Je dobré mať všetko zorganizované hneď od začiatku. Aby sme vytvorili aplikáciu, musíš v konzole spustiť nasledujúci príkaz (v adresári `djangogirls`, kde sa nachádza súbor `manage.py`):
 
-```
-~/djangogirls$ (myvenv) python manage.py startapp blog
-```
+{% filename %}Mac OS X and Linux:{% endfilename %}
 
-Uvidíš, že bude vytvorený nový adresár `blog`, ktorý obsahuje množstvo súborov. Adresáre a súbory v našom projekte by mali vyzerať takto:
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
 
-```
-djangogirls
-├── mysite
-|       __init__.py
-|       settings.py
-|       urls.py
-|       wsgi.py
-├── manage.py
-└── blog
-    ├── migrations
-    |       __init__.py
-    ├── __init__.py
-    ├── admin.py
-    ├── models.py
-    ├── tests.py
-    └── views.py
-```
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
 
-Po vytvorení aplikácie tiež musíš Djangu povedať, že by ju mal použiť. To urobíme v súbore `mysite/settings.py`. Musíme nájsť `INSTALLED_APPS` a pridať riadok obsahujúci `'blog'` tesne pred uzatváraciu zátvorku`)`. Takže výsledok nášho snaženia bude vyzerať takto:
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-INSTALLED_APPS = (
+INSTALLED_APPS = [
     'django.contrib.admin',
     'django.contrib.auth',
     'django.contrib.contenttypes',
@@ -100,14 +112,16 @@ INSTALLED_APPS = (
     'django.contrib.messages',
     'django.contrib.staticfiles',
     'blog',
-)
+]
 ```
 
 ### Vytvorenie modelu blog postu
 
-V súbore `blog/models.py` definujeme všetky objekty, ktoré sa nazývajú `modely` - na tomto mieste definujeme náš blog post.
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
 
-Otvor `blog/models.py`, všetko z neho odstráň a napíš tento kód:
+{% filename %}blog/models.py{% endfilename %}
 
 ```python
 from django.db import models
@@ -115,7 +129,7 @@ from django.utils import timezone
 
 
 class Post(models.Model):
-    author = models.ForeignKey('auth.User')
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
     created_date = models.DateTimeField(
@@ -133,51 +147,58 @@ class Post(models.Model):
 
 > Dvakrát skontroluj, či si použila 2 podčiarkovníky (`_`) na oboch stranách `str`. Táto konvencia sa v Pythone často používa a niekedy sa tomu hovorí "dunder" (skratka pre anglické Double-UNDERscore).
 
-Vyzerá to asi strašidelne. Ale neboj sa, vysvetlíme si, čo tieto riadky znamenajú!
+It looks scary, right? But don't worry – we will explain what these lines mean!
 
-Všetky riadky začínajúce s `from` alebo `import` pridávajú časti z iných súborov. Takže namiesto kopírovania rovnakých vecí v každom súbore môžeme zahrnúť niektoré časti pomocou `from ... import ...`.
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
 
-`class Post(models.Model):` - tento riadok definuje náš model (je to `objekt`).
+`class Post(models.Model):` – this line defines our model (it is an `object`).
 
-*   `class` je špeciálne kľúčové slovo, ktoré naznačuje, že definujeme objekt.
-*   `Post` je meno nášho modelu. Môžeme mu dať iný názov (ale musíme sa vyhnúť špeciálnym a prázdnym znakom). Názov triedy vždy začnite písmenami.
-*   `models.Model` znamená, že Post je Django Model, takže Django vie, že by mal byť uložený v databáze.
+- `class` je špeciálne kľúčové slovo, ktoré naznačuje, že definujeme objekt.
+- `Post` je meno nášho modelu. Môžeme mu dať iný názov (ale musíme sa vyhnúť špeciálnym a prázdnym znakom). Názov triedy vždy začni písmenami.
+- `models.Model` znamená, že Post je Django Model, takže Django vie, že by mal byť uložený v databáze.
 
-Teraz zadefinujeme vlastnosti, o ktorých sme hovorili: `title` (titulka), `text`, `created_date` (dátum vytvorenia), `published_date` (dátum zverejnenia) a `author` (autor). Na to ale musíme zadefinovať typ každého poľa (Je to text? Číslo? Dátum? Vzťah k inému objektu, t.j. používateľovi?).
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
 
-*   `modely. CharField` - takto môžeš definovať text s obmedzeným počtom znakov.
-*   `models.TextField` - toto je pre dlhé texty bez obmedzenia. To znie ideálne pre blogový príspevok, nie?
-*   `models.DateTimeField` - dátum a čas.
-*   `models.ForeignKey` - odkaz na iný model.
+- `modely. CharField` - takto môžeš definovať text s obmedzeným počtom znakov.
+- `models.TextField` - toto je pre dlhé texty bez obmedzenia. To znie ideálne pre blogový príspevok, nie?
+- `models.DateTimeField` - dátum a čas.
+- `models.ForeignKey` - odkaz na iný model.
 
-Nebudeme si tu vysvetľovať každý kúsok kódu, pretože by to zabralo príliš veľa času. Ak chceš vedieť viac o poliach modelu a definovaní ďalších vecí okrem tých, čo sme popísali vyššie, skús sa pozrieť do dokumentácie Djanga (https://docs.djangoproject.com/en/1.8/ref/models/fields/#field-types).
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
 
-A čo `def publish(self):`? To je presne tá metóda `publish`, o ktorej sme hovorili predtým. `def` znamená, že ide o funkciu/metódu a `publish` je názov metódy. Názov metódy môžeš zmeniť, ak chceš. Pravidlo pre názvy je, že používame malé písmená a podčiarkovníky namiesto medzier. Napríklad metóda, ktorá vypočíta priemernú cenu by sa mohla nazývať `pocitaj_priemernu_cenu`.
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
 
-Metódy často niečo vracajú (angl. `return`). Príklad nájdeš napríklad v metóde `__str__`. V tomto prípade, keď zavoláme `__str__()`, dostaneme text (**string**) s názvom postu.
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
 
-Ak čokoľvek nie je jasné, neváhaj a spýtaj sa mentora! Je nám jasné, že je to komplikované, najmä ak sa učíš, čo sú objekty a funkcie súčasne. Ale dúfame, že teraz už to vyzerá trochu menej magicky!
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
 
 ### Vytváranie tabuliek pre modely v databáze
 
-Posledným krokom je pridať náš nový model do databázy. Najprv musíme Djangu dať vedieť, že sme urobili nejaké zmeny v našom modeli (práve sme ho vytvorili!). Napíš `python manage.py makemigrations blog`. Bude to vyzerať takto:
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
 
-```
-(myvenv) ~/djangogirls$ python manage.py makemigrations blog
-Migrations for 'blog':
-  0001_initial.py:
-  - Create model Post
-```
+{% filename %}command-line{% endfilename %}
 
-Django pre nás pripravil migračný súbor, ktorý musíme aplikovať na našu databázu. Napíš `python manage.py migrate blog` a výstup by mal byť:
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
 
-```
-(myvenv) ~/djangogirls$ python manage.py migrate blog
-Operations to perform:
-  Apply all migrations: blog
-Running migrations:
-  Rendering model states... DONE
-  Applying blog.0001_initial... OK
-```
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
 
-Hurá! Náš Post model je už v databáze! Bolo by fajn ho vidieť, nie? Prejdi na nasledujúcu kapitolu a uvidíš ako vyzerá tvoj Post!
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/sk/django_orm/README.md b/sk/django_orm/README.md
index cd44d0d7549..baeda3fcf5e 100755
--- a/sk/django_orm/README.md
+++ b/sk/django_orm/README.md
@@ -4,47 +4,56 @@ V tejto kapitole sa naučíš, ako sa Django pripája k databáze a ukladá do n
 
 ## Čo je QuerySet?
 
-QuerySet je v podstate zoznam objektov daného modelu. QuerySet ti umožňuje čítať dáta z databázy, filtrovať ich a zoraďovať.
+QuerySet je zoznam objektov daného modelu. QuerySet ti umožňuje čítať dáta z databázy, filtrovať a zoraďovať ich.
 
 Najjednoduchšie bude ukázať si to na príklade. Vyskúšajme si to.
 
 ## Django shell (konzola)
 
-Otvor svoju lokálnu konzolu (nie na PythonAnywhere) a napíš tento príkaz:
+Otvor si lokálnu konzolu (nie na PythonAnywhere) a napíš tento príkaz:
 
-```
-(myvenv) ~/djangogirls$ python manage.py shell
-```
+{% filename %}command-line{% endfilename %}
 
-Malo by to mať tento efekt:
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
 
-```
+Toto by sa ti malo zobraziť:
+
+{% filename %}command-line{% endfilename %}
+
+```python
 (InteractiveConsole)
 >>>
 ```
 
-Teraz si v interaktívnej Django konzole. Je to ako konzola Pythonu, ale s trochou Django mágie :). Môžeš tu, samozrejme, použiť všetky príkazy Pythonu.
+Nachádzaš sa v interaktívnej Django konzole. Je to ako konzola Pythonu, ale s trochou Django mágie :). Môžeš v nej samozrejme použiť všetky Pythonovské príkazy.
 
 ### Všetky objekty
 
-Skúsme najskôr zobraziť všetky naše príspevky. To môžeš urobiť týmto príkazom:
+Skúsme najskôr zobraziť všetky naše príspevky. To sa robí nasledovným príkazom:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.all()
 Traceback (most recent call last):
       File "<console>", line 1, in <module>
 NameError: name 'Post' is not defined
 ```
 
-Ups! Objavila sa chybová hláška! Hovorí nám, že žiaden Post (príspevok) neexistuje. To je správne - zabudli sme ho totiž najskôr naimportovať!
+Ups! Objavila sa chybová hláška! Hovorí nám, že nič také ako Post (príspevok) neexistuje. To je správne - zabudli sme ho totiž najskôr naimportovať!
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> from blog.models import Post
 ```
 
-Je to jednoduché: importujeme model `Post` z `blog.models`. Skúsme teda znova zobraziť všetky príspevky:
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.all()
 <QuerySet [<Post: my post title>, <Post: another post title>]>
 ```
@@ -55,7 +64,9 @@ Je to zoznam príspevkov, ktoré sme už predtým vytvorili! Vytvorili sme ich p
 
 Takto vytvoríš nový Post objekt v databáze:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.create(author=me, title='Sample title', text='Test')
 ```
 
@@ -63,34 +74,44 @@ Chýba nám však jedna prísada: `me`. Ako autorku musíme vložiť inštanciu
 
 Najskôr naimportujme User model:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> from django.contrib.auth.models import User
 ```
 
 Akých užívateľov máme v našej databáze? Skús toto:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> User.objects.all()
 <QuerySet [<User: ola>]>
 ```
 
 To je superuser, ktorého sme už vytvorili predtým. Teraz získajme inštanciu tohto užívateľa:
 
+{% filename %}command-line{% endfilename %}
+
 ```python
-ja = User.objects.get(username='ola')
+>>> me = User.objects.get(username='ola')
 ```
 
-Ako vidíš, teraz získame (angl. `get`) užívateľa (angl. `User`) s užívateľským meno (angl. `username`), ktoré sa rovná 'ola'. Aké elegantné! Samozrejme musíš si to upraviť na svoje meno.
+Ako vidíš, teraz získame (angl. `get`) užívateľa (angl. `User`) s užívateľským meno (angl. `username`), ktoré sa rovná 'ola'. Aké elegantné! Samozrejme musíš si to zmeniť tak aby tam bolo tvoje meno.
 
 Teraz už konečne môžeme vytvoriť náš prvý príspevok:
 
-```
->>> Post.objects.create(author=ja, title='titulka', text='Test')
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
 ```
 
 Hurá! Chceš si overiť, či to fungovalo?
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.all()
 <QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
 ```
@@ -99,29 +120,35 @@ Je to tam, jeden príspevok v zozname pribudol!
 
 ### Pridaj viac príspevkov
 
-Teraz sa môžeš trochu pobaviť a pridať pár ďalších postov, aby si videla, ako to funguje. Pridaj dva-tri ďalšie príspevky a potom poďme na ďalšiu časť.
+Teraz sa môžeš trochu pobaviť a pridať pár ďalších príspevkov, aby si si vyskúšala ako to funguje. Pridaj dva-tri ďalšie príspevky a potom poďme na ďalšiu časť.
 
 ### Filtrovanie objektov
 
-Dôležitou vlastnosťou QuerySetov je možnosť ich filtrovať. Povedzme, že chceme nájsť všetky príspevky, ktorých autorom je užívateľ (User) ola. Použijeme `filter` namiesto `all` v príkaze `Post.objects.all()`. V zátvorkách definujeme jednu alebo viac podmienok, ktoré majú byť splnené príspevkom, aby skončil v tvojom querysete. V našom prípade je to `author`, ktorý sa rovná `ja`. V Djangu to napíšeš takto: `author=ja`. Náš kúsok kódu bude teraz vyzerať takto:
+Dôležitou vlastnosťou QuerySetov je možnosť ich filtrovať. Povedzme, že chceme nájsť všetky príspevky, ktorých autorom je užívateľ (User) ola. Použijeme `filter` namiesto `all` v príkaze `Post.objects.all()`. V zátvorkách definujeme jednu alebo viac podmienok, ktoré majú byť splnené príspevkom, aby skončil v tvojom querysete. V našom prípade je to `author`, ktorý sa rovná `me`. V Djangu to napíšeš takto: `author=me`. Náš kúsok kódu bude teraz vyzerať takto:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.filter(author=ja)
-[<Post: titulka>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4ta titulka postu>]
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
 ```
 
-Alebo neskúsime vyhľadať všetky príspevky, ktoré obsahujú slovo 'titulka' v políčku `title`?
+Skúsme vyhľadať všetky príspevky, ktoré obsahujú slovo 'title' v políčku `title`?
 
-```
->>> Post.objects.filter(title__contains='titulka')
-[<Post: titulka>, <Post: 4ta titulka postu>]
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
 ```
 
 > **Poznámka** Medzi `title` a `contains` sú dva podčiarkovníky (`_`). Django ORM používa túto syntax, aby oddelil názvy polí ("title") a operácie či filtre ("contains"). Ak použiješ iba jeden podčiarkovník, dostaneš chybu "FieldError: Cannot resolve keyword title_contains".
 
 Môžeš tiež získať zoznam všetkých publikovaných postov. To urobíme vyfiltrovaním príspevkov, ktoré majú nastavený `published_date` v minulosti:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> from django.utils import timezone
 >>> Post.objects.filter(published_date__lte=timezone.now())
 []
@@ -129,35 +156,45 @@ Môžeš tiež získať zoznam všetkých publikovaných postov. To urobíme vyf
 
 Bohužiaľ, príspevok, ktorý sme pridali z konzoly Pythonu, ešte nie je publikovaný. To môžeme zmeniť! Najskôr získaj inštanciu postu, ktorý chceme publikovať:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> post = Post.objects.get(title="Sample title")
 ```
 
-A potom ho publikuj pomocou našej metódy `publish`!
+A potom ho zverejni pomocou našej metódy `publish`:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> post.publish()
 ```
 
 Teraz skús získať zoznam publikovaných postov znova (stlač šípku hore trikrát a stlač `enter`):
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.filter(published_date__lte=timezone.now())
 [<Post: Sample title>]
 ```
 
-### Radenie objektov
+### Zoradenie objektov
 
 QuerySety tiež umožňujú zoradiť zoznamy objektov. Skúsme ich zoradiť podľa dátumu vytvorenia (pole `created_date`):
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.order_by('created_date')
 [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
 ```
 
-Môžeme ich tiež zoradiť naopak pridaním `-` na začiatok:
+Poradie môžeme vymeniť pridaním `-` na začiatok:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> Post.objects.order_by('-created_date')
 [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
 ```
@@ -166,15 +203,16 @@ Môžeme ich tiež zoradiť naopak pridaním `-` na začiatok:
 
 QuerySety môžeš dokonca kombinovať pomocou **reťazenia**:
 
-```
->>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
-```
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
 
-To je skutočne mocný nástroj, s ktorým môžeš písať dosť komplexné požiadavky (queries).
+To je skutočne silný nástroj, ktorým môžeš písať pomerne komplexné požiadavky (queries).
 
-Super! Teraz už si pripravená na ďalšiu časť! Shell zatvoríš príkazom:
+Super! Teraz si pripravená na ďalšiu časť! Shell zatvoríš príkazom:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> exit()
 $
-```
+```
\ No newline at end of file
diff --git a/sk/django_start_project/README.md b/sk/django_start_project/README.md
index cedf1ce9682..26bb6288af9 100755
--- a/sk/django_start_project/README.md
+++ b/sk/django_start_project/README.md
@@ -1,46 +1,59 @@
 # Tvoj prvý Django projekt!
 
-> Časť tejto kapitoly je založená na tutoriáli Geek Girls Carrots (http://django.carrots.pl/).
->
-> Časti tejto kapiolty sú založená na [django-marcador tutorial][1] pod licenciou Creative Commons Attribution-ShareAlike 4.0 International License. Tutoriál django-marcador je autorsky chránený Markusom Zapke-Gründemannom et al.
+> Časť tejto kapitoly je založená na tutoriáli Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Časti tejto kapiolty sú založená na [django-marcador tutorial](http://django-marcador.keimlink.de/) pod licenciou Creative Commons Attribution-ShareAlike 4.0 International License. Tutoriál django-marcador je autorsky chránený Markusom Zapke-Gründemannom et al.
 
- [1]: http://django-marcador.keimlink.de/
-
-Vytvoríme jednoduchý blog!
+We're going to create a small blog!
 
 Prvý krok je vytvoriť nový Django projekt. To v podstate znamená, že spustíme pár skriptov, poskytovaných Djangom, ktoré pre nás vytvoria kostru Django projektu. Je to len pár zložiek a súborov, ktoré použijeme neskôr.
 
 Mená niektorých súborov a zložiek sú pre Django veľmi dôležité. Súbory, ktoré teraz vytvoríme, by si nemala premenovať. Ich presúvanie na iné miesto taktiež nie je dobrý nápad. Django potrebuje udržovať určitú štruktúru, aby bol schopný nájsť dôležité veci.
 
-> Nezabudni všetko spúšťať vo virtualenv. Pokiaľ vo svojej konzole nevidíš prefix `(myvenv)` musíš aktivovať virtualenv. Ako na to bolo vysvetlené v kapitole **Inštalácia Django** v časti **Práca s virtualenv**. Pokiaľ napíšeš `myvenv\Scripts\activate` na Windowsoch, alebo `source myvenv/bin/activate` na Mac OS / Linux, malo by všetko fungovať.
+> Nezabudni všetko spúšťať vo virtualenv. Pokiaľ vo svojej konzole nevidíš prefix `(myvenv)` musíš aktivovať virtualenv. Ako na to bolo vysvetlené v kapitole **Inštalácia Django** v časti **Práca s virtualenv**. Pokiaľ napíšeš `myvenv\Scripts\activate` na Windowsoch, alebo `source myvenv/bin/activate` na Mac OS X alebo Linux, malo by všetko fungovať.
 
-Vo svojej MacOS alebo Linux konzole spusti tento príkaz; **nezabudni pridať bodku `.` na konci**:
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
 
-```
-(myvenv) ~/djangogirls$ django-admin startproject mysite .
-```
+Vo svojej Mac OS X alebo Linux konzole spusti tento príkaz; **nezabudni pridať bodku `.` na konci**
 
-Na Windowsoch: **nezabudni pridať bodku `.` na konci**:
+{% filename %}command-line{% endfilename %}
 
-```
-(myvenv) C:\Users\Name\djangogirls> django-admin.py startproject mysite .
-```
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Bodka `.` je dôležitá, pretože hovorí skriptom, aby nainštalovali Django v tvojej aktuálnej zložke (pre ktorú je bodka `.` skratkou).
+> 
+> **Poznámka** Pri písaní predchádzajúceho príkazu nezabudni, že píšeš len časť, ktorá začína django-admin alebo `django-admin. py`. `(myvenv) ~/djangogirls$` zobrazené tu je len príkladom cesty, kam budeš zadávať svoje príkazy.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Vo Windowse spusti tento príkaz; **nezabudni pridať bodku `.` na konci**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Bodka `.` je dôležitá, pretože hovorí skriptom, aby nainštalovali Django v tvojej aktuálnej zložke (pre ktorú je bodka `.` skratkou).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
 
-> Bodka `.` je dôležitá, pretože hovorí skriptom, aby nainštalovali Django v tvojej aktuálnej zložke (pre ktorú je bodka `.` skratkou)
->
-> **Poznámka** Pri písaní predchádzajúcich príkazov nezabudni, že píšeš len časti, ktoré začínajú `django-admin` alebo `django-admin.py`. `(myvenv) ~/djangogirls$` a `(myvenv) C:\Users\Name\djangogirls>` sú len príkladom cesty, kam budeš zadávať svoje príkazy.
+<!--endsec-->
 
 `django-admin.py` je skript, ktorý pre teba vytvorí zložky a súbory. Momentálne by si mala mať štruktúru adresárov, ktorá vyzerá takto:
 
-```
-djangogirls
-├───manage.py
-└───mysite
-        settings.py
-        urls.py
-        wsgi.py
-        __init__.py
-```
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Poznámka**: adresárovej štruktúre, uvidíš `venv` adresár, ktorý sme vytvorili.
 
 `manage.py` je skript, ktorý pomáha so správou stránky. Okrem iného budeme vďaka nemu môcť spustiť na našom počítači webový server, bez toho, aby sme inštalovali čokoľvek iné.
 
@@ -54,31 +67,57 @@ Zatiaľ ignorujme ostatné súbory, keďže ich teraz aj tak nebudeme meniť. Je
 
 Spravme pár zmien v `mysite/settings.py`. Otvor súbor v editore kódu, ktorý si si nainštalovala predtým.
 
-Bolo by dobré mať na našej stránke správny čas. Choď na [zoznam časových pásiem na wikipedii][2] a skopíruj svoje časové pásmo (TZ). (napr. `Europe/Bratislava`)
+**Poznámka**: Pamätaj, že `settings.py` je obyčajný súbor, ako každý iný. Môžeš ho otvoriť z kodového editoru, pomocou "Súbor -> Otvoriť" možnosti v menu. Malo by sa ti zobraziť štandardné okno v ktorom vyhľadáš svoj `settings.py` súbor a označíš ho. Prípadne môžeš ísť do priečinka djangogirls na pracovnej ploche a kliknúť na súbor pravým tlačidlom myši. Potom vyber editor kódu zo zoznamu. Výber editora je dôležitý, pretože môžeš mať nainštalované iné programy, ktoré dokážu tento súbor otvoriť, ale nedovolia ti ho upravovať.
+
+Bolo by dobré mať na našej stránke správny čas. Choď na [zoznam časových pásiem na wikipedii](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) a skopíruj svoje časové pásmo (napr. `Europe/Berlin`).
+
+V súbore `settings.py`, nájdi riadok, ktorý obsahuje `TIME_ZONE` a uprav ho tak, aby obsahoval tvoje časové pásmo. Napríklad:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
- [2]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+Jazykoví kód sa skladá z jazyka, napr. `en` pre angličtinu alebo `de` pre nemčinu a kódu krajiny, napr. `de` pre Nemecko, alebo `ch` pre Švajčiarsko. Toto si pridaj, ak chceš aby predvolené tlačidlá a oznamenia v Djangu boli v tvojom jazyku. Potom bude tlačidlo "Cancel" preložené do jazyka, ktorý tu definuješ. [Django je dodávaný s množstvom pripravených prekladov](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
 
-V súbore settings.py, nájdi riadok, ktorý obsahuje `TIME_ZONE` a uprav ho tak, aby obsahoval tvoje časové pásmo:
+Zmeň kódu jazyka zmenou nasledujúceho riadku:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-TIME_ZONE = 'Europe/Bratislava'
+LANGUAGE_CODE = 'de-ch'
 ```
 
-Prípadne zvoľ iné pásmo ako "Europe/Bratislava", ak je to potrebné
+Budeme tiež musieť pridať cestu pre statické súbory. (Dozvieme sa všetko o statických súboroch a CSS neskôr v tutoriále.) Prejdi na *koniec* súboru a pod `STATIC_URL` riadkom, pridaj ďalší s názvom `STATIC_ROOT`:
 
-Tiež budeme musieť pridať cestu k statickým súborom (všetko o statických súboroch a CSS sa dozvieme neskôr v ďalších kapitolách tutorialu). Prejdi dole na *koniec* súboru a hneď pod záznam `STATIC_URL` pridaj nový s názvom `STATIC_ROOT`:
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 STATIC_URL = '/static/'
 STATIC_ROOT = os.path.join(BASE_DIR, 'static')
 ```
 
+Keď `DEBUG` je `True` a `ALLOWED_HOSTS` je prázdne, host je overovaný vôči `['localhost', '127.0.0.1', '[::1]']`. Toto sa nebude zhodovať s naším hostname na PythonAnywhere, keď nasadíme našu aplikáciu, kvôli tomu zmeníme nasledovné nastavenie:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Poznámka**: Ak používaš Chromebook, pridaj nasledovný riadok na koniec settings.py súboru: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
 ## Nastavenie databázy
 
 Existuje veľa rôznych databázových softvérov, ktoré umožňujú ukladať údaje pre tvoje web stránky. My budeme používať predvolenú databázu - `sqlite3`.
 
 Tá je už nastavená v tejto časti súboru `mysite/settings.py`:
 
+{% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 DATABASES = {
     'default': {
@@ -90,55 +129,74 @@ DATABASES = {
 
 Databázu pre náš blog vytvoríme spustením tohto príkazu v konzole: `python manage.py migrate` (musíme byť v adresári `djangogirls`, ktorý obsahuje súbor `manage.py`). Ak všetko prešlo dobre, mala by si vidieť niečo takéto:
 
-```
-(myvenv) ~/djangogirls$ python manage.py migrate
-Operations to perform:
-  Synchronize unmigrated apps: messages, staticfiles
-  Apply all migrations: contenttypes, sessions, admin, auth
-Synchronizing apps without migrations:
-   Creating tables...
-      Running deferred SQL...
-   Installing custom SQL...
-Running migrations:
-  Rendering model states... DONE
-  Applying contenttypes.0001_initial... OK
-  Applying auth.0001_initial... OK
-  Applying admin.0001_initial... OK
-  Applying contenttypes.0002_remove_content_type_name... OK
-  Applying auth.0002_alter_permission_name_max_length... OK
-  Applying auth.0003_alter_user_email_max_length... OK
-  Applying auth.0004_alter_user_username_opts... OK
-  Applying auth.0005_alter_user_last_login_null... OK
-  Applying auth.0006_require_contenttypes_0002... OK
-  Applying sessions.0001_initial... OK
-```
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
 
 A je to! Teraz treba spustiť webový server a uvidíme či je naša web stránka funkčná!
 
+## Spustenie webového servera
+
 Musíš sa nachádzať v adresári, v ktorom sa nachádza súbor `manage.py` (adresár `djangogirls`). V konzole spustíme webový server zadaním `python manage.py runserver`:
 
-```
-(myvenv) ~/djangogirls$ python manage.py runserver
-```
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Ak používaš Chromebook, použi nasledovný príkaz:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
 
 Ak si vo Windowse a padne ti to s chybovou hláškou `UnicodeDecodeError`, použi namiesto toho tento príkaz:
 
-```
-(myvenv) ~/djangogirls$ python manage.py runserver 0:8000
-```
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
 
 Teraz už musíš len skontrolovať, či tvoja web stránka funguje. Otvor si prehliadač (Firefox, Chrome, Safari, Internet Explorer alebo čokoľvek používaš) a zadaj adresu:
 
-```
-http://127.0.0.1:8000/
-```
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+Ak používaš Chromebook, budeš vždy pristupovať na test server zadaním nasledovnej adresy:
 
-Príkazový riadok bude obsadený webovým serverom, až kým ho nezastavíš. Ak chceš zadať viac príkazov, kým je spustený, otvor nové okno terminálu a aktivuj svoj virtualenv. Ak chceš zastaviť webový server, prepni sa späť do okna, v ktorom beží a stlač Ctrl + C súčasne (na Windowse možno budeš musiť stlačiť Ctrl + Break).
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
 
 Blahoželáme! Práve si vytvorila svoju prvú web stránku, ktorá beží na tvojom webovom serveri. Nie je to úžasné?
 
-![Fungovalo to!][3]
+![Fungovalo to!](images/it_worked2.png)
+
+Kým je spustený webový server, nebude možné zadať nové príkazy v príkazovom riadku. Terminál bude akceptovať nový text, ale nebude spúšťať nové príkazy. Je to kvôli tomu, že webový server nerpretržite beží a čaká na prichádzajúce požiadavky (requests).
+
+> Ako webový server funguje sme si povedali v kapitole **Ako funguje Internet**.
 
- [3]: images/it_worked2.png
+Ak chceš zadať ďalšie príkazy, kým webový server beží, otvor nové terminálové okno a aktivuj svoj virtualenv. Ak chceš zastaviť webový server, prepni sa späť do okna, v ktorom beží a stlač Ctrl + C súčasne (na Windowse možno budeš musiť stlačiť Ctrl + Break).
 
-Pripravená na ďalší krok? Je na čase vytvoriť nejaký obsah!
+Pripravená na ďalší krok? Je na čase vytvoriť nejaký obsah!
\ No newline at end of file
diff --git a/sk/django_templates/README.md b/sk/django_templates/README.md
index b663e3cf443..760b3fd0e58 100755
--- a/sk/django_templates/README.md
+++ b/sk/django_templates/README.md
@@ -4,9 +4,9 @@ Je na čase zobraziť nejaké údaje! Na to nám Django ponúka užitočné vsta
 
 ## Čo sú to šablónové tagy?
 
-V HTML vlastne nemôžeš písať pythonský kód, pretože prehliadače mu nerozumejú. Poznajú len HTML. Vieme, že HTML je skôr statické, kým Python je oveľa dynamickejší.
+V HTML vlastne nemôžeš písať Pythonský kód, pretože prehliadače mu nerozumejú. Poznajú len HTML. Vieme, že HTML je skôr statické, kým Python je oveľa dynamickejší.
 
-**Django šablónové tagy** nám umožňujú previesť Pythonské veci do HTML, takže dynamické webové stránky môžeš vytvoriť rýchlejšie a jednoduchšie. Paráda!
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
 ## Zobraz šablónu so zoznamom príspevkov
 
@@ -14,24 +14,28 @@ V predchádzajúcej kapitole sme našej šablóne dali zoznam príspevkov v prem
 
 Na vypísanie premennej v Django šablónach použijeme dvojitú zloženú zátvorku s názvom premennej vo vnútri, asi takto:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {{ posts }}
 ```
 
-Vyskúšaj to vo svojej šablóne `blog/templates/blog/post_list.html`. Nahraď všetko od druhého `<div>` po tretí `</div>` týmto kódom: `{{ posts }}`. Ulož súbor a obnov stránku, aby sme videli výsledky:
-
-![Obrázok 13.1][1]
+Vyskúšaj to vo svojej šablóne `blog/templates/blog/post_list.html`. Nahraď všetko od druhého `<div>` po tretí `</div>` týmto kódom: `{{ posts }}`. Ulož súbor a obnov stránku, aby si videla výsledky:
 
- [1]: images/step1.png
+![Obrázok 13.1](images/step1.png)
 
 Ako vidíš, dostali sme len toto:
 
-```
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
 <QuerySet [<Post: My second post>, <Post: My first post>]>
 ```
 
 To znamená, že to Django chápe ako zoznam objektov. Pamätáš si z kapitoly **Úvod do Pythonu** ako môžeme zobraziť zoznamy? Áno, cyklami! V Django šablóne ich urobíš takto:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     {{ post }}
@@ -40,11 +44,11 @@ To znamená, že to Django chápe ako zoznam objektov. Pamätáš si z kapitoly
 
 Vyskúšaj si to vo svojej šablóne.
 
-![Obrázok 13.2][2]
+![Obrázok 13.2](images/step2.png)
 
- [2]: images/step2.png
+Funguje to! Ale my chceme, aby sa príspevky zobrazili ako tie statické, ktoré sme vytvorili predtým v kapitole **Úvod do HTML**. Môžeš skombinovať HTML a šablónové tagy. Naše `body` bude vyzerať takto:
 
-Funguje to! Ale my chceme, aby sa zobrazili ako tie statické príspevky, ktoré sme vytvorili predtým v kapitole **Úvod do HTML**. Môžeš skombinovať HTML a šablónové tagy. Naše `body` bude vyzerať takto:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <div>
@@ -62,47 +66,41 @@ Funguje to! Ale my chceme, aby sa zobrazili ako tie statické príspevky, ktoré
 
 {% raw %}Všetko, čo dáš medzi `{% for %}` a `{% endfor %}` sa bude opakovať pre každý objekt v zozname. Obnov svoju stránku:{% endraw %}
 
-![Obrázok 13.3][3]
+![Obrázok 13.3](images/step3.png)
 
- [3]: images/step3.png
-
-Všimla si si, že sme tentokrát použili trochu odlišné zápisy `{{ post.title }}` alebo `{{ post.text }}`? Pristupujeme k údajom v každom z polí definovanom v našom `Post` modeli. Okrem toho `|linebreaksbr` preposiela texty príspevkov cez filter, ktorý konvertuje zalomenie riadkov na odstavce.
+Všimla si si, že sme tentokrát použili trochu iný zápis `{{ post.title }}` alebo `{{ post.text }}`? Pristupujeme k údajom v každom z polí definovanom v našom `Post` modeli. Okrem toho `|linebreaks` preposiela texty príspevkov cez filter, ktorý konvertuje zalomenie riadkov na odstavce.
 
 ## Ešte jedna vec
 
-Bolo by fajn vidieť či bude tvoja web stránka stále funkčná aj na Internete, však? Skúsme to znova nasadiť na PythonAnywhere. Tu je rekapitulácia postupu...
-
-*   Najskôr pošli svoj kód na Github
+Bolo by fajn vidieť či bude tvoja web stránka stále funkčná aj na Internete, však? Skúsme to znova nasadiť na PythonAnywhere. Tu je rekapitulácia postupu…
 
-```
-$ git status
-[...]
-$ git add -A .
-$ git status
-[...]
-$ git commit -m "Modified templates to display posts from database."
-[...]
-$ git push
-```
+* Najskôr pošli svoj kód na Github
 
-*   Potom sa prihlás do [PythonAnywhere][4] a choď do **Bash konzoly** (alebo spusti novú) a zadaj:
+{% filename %}command-line{% endfilename %}
 
- [4]: https://www.pythonanywhere.com/consoles/
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
 
-```
-$ cd my-first-blog
-$ git pull
-[...]
-```
+* Potom sa prihlás do [PythonAnywhere](https://www.pythonanywhere.com/consoles/) a choď do **Bash konzoly** (alebo spusti novú) a zadaj:
 
-*   A nakoniec prejdi na [záložku Web][5] a stlač **Reload** na svojej webovej aplikácii. Aktualizácia by mala byť online!
+{% filename %}PythonAnywhere command-line{% endfilename %}
 
- [5]: https://www.pythonanywhere.com/web_app_setup/
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
-Gratulujeme! Teraz skús pridať nový príspevok v Django adminovi (nezabudni pridať published_date!), potom obnov stránku a pozri sa, či sa príspevok zobrazí.
+* A nakoniec prejdi na [záložku Web](https://www.pythonanywhere.com/web_app_setup/) a stlač **Reload** na svojej webovej aplikácii. Aktualizácia by mala byť online! Ak sa blogové príspevky na tvojej PythonAnywhere stránke nezhodujú s príspevkami na blogu ktorý beží na tvojom lokálnom počítači, to je v poriadku. Databázy na tvojom lokálnom počítači a na PythonAnywhere sa nesznchronizujú spolu so zvyšnými subormi.
 
-Funguje ako hodinky? Sme hrdí! Teraz si na chvíľku oddýchni od počítača, zaslúžiš si trochu voľna. :)
+Gratulujeme! Teraz skús pridať nový príspevok cez Django admin (nezabudni pridať published_date!). Uisti sa, že si v Django admin prostredi na svojej stránke na PythonAnywhere, https://yourname.pythonanywhere.com/admin. Následne obnov stránku aby si zistila či sa príspevok tam objaví.
 
-![Obrázok 13.4][6]
+Funguje ako hodinky? Sme hrdí! Teraz si na chvíľku oddýchni od počítača, zaslúžiš si prestávku. :)
 
- [6]: images/donut.png
+![Obrázok 13.4](images/donut.png)
\ No newline at end of file
diff --git a/sk/django_urls/README.md b/sk/django_urls/README.md
index 358bab87c2e..0e3c347c4b2 100755
--- a/sk/django_urls/README.md
+++ b/sk/django_urls/README.md
@@ -1,14 +1,12 @@
-# Django url
+# Django URL
 
-Chystáme sa vytvoriť našu prvú web stránku: domovská stránka tvojho blogu! Ale ešte predtým sa poďme naučiť niečo o Django url.
+Chystáme sa vytvoriť našu prvú webovú stránku: domovská stránka tvojho blogu! Ale ešte predtým sa poďme naučiť niečo o Django URL.
 
 ## Čo je URL?
 
-URL je jednoducho webová adresa. URL si môžeš všimnúť zakaždým, keď navštíviš webovú stránku - vidno ju v prehliadači v adresnom riadku (áno! `127.0.0.1:8000` je URL! A `https://djangogirls.org` je tiež URL):
+URL je jednoducho povedané webová adresa. URL si môžeš všimnúť zakaždým, keď navštíviš webovú stránku - vidno ju v prehliadači. (Áno! `127.0.0.1:8000` je URL! A `https://djangogirls.org` je tiež URL.)
 
-![Url][1]
-
- [1]: images/url.png
+![Url](images/url.png)
 
 Každá stránka na internete potrebuje svoju vlastnú URL. Týmto spôsobom aplikácia vie, čo by mala ukázať užívateľovi, ktorý otvorí URL. V Djangu používame takzvaný `URLconf` (URL konfigurácia). URLconf je súbor vzorov, ktoré sa Django pokúsi priradiť podľa prijatej URL, aby tak našiel správne zobrazenie.
 
@@ -16,72 +14,77 @@ Každá stránka na internete potrebuje svoju vlastnú URL. Týmto spôsobom apl
 
 Otvorme súbor `mysite/urls.py` v editore kódu a pozrime sa, ako vyzerá:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
-    # Examples:
-    # url(r'^$', 'mysite.views.home', name='home'),
-    # url(r'^blog/', include('blog.urls')),
-
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
 ]
 ```
 
 Ako vidíš, Django sem už pre nás niečo umiestnil.
 
-Riadky, ktoré začínajú s `#` sú komentáre - to znamená, že tie riadky Python nespustí. Šikovné, nie?
+Riadky medzi trojitými uvodzovkami (`'''` or `"""`) sa nazývajú docstringy - môžeš ich pridať na začiatku suboru, triedy, alebo metódy aby si popísala čo robí. Python ich nespustí.
+
+Adminovská URL, ktorú si navštívila v predchádzajúcej kapitole je už tu:
 
-Adminská URL, ktorú si navštívila v predchádzajúcej kapitole je už tu:
+{% filename %}mysite/urls.py{% endfilename %}
 
 ```python
-url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
 ```
 
-To znamená, že pre každú URL, ktorá začína na `admin` Django nájde zodpovedajúce *zobrazenie (view)*. V tomto prípade pridávame množstvo adminských URL, takže to nie je všetko natlačené v jednom malom súbore -- je to čitateľnejšie a čistejšie.
+Tento riadok znamená, že pre každú URL, ktorá začína na `admin` Django nájde zodpovedajúce *zobrazenie (view)*. V tomto prípade pridávame množstvo adminovských URL, takže to nie je všetko natlačené v jednom malom súbore -- je to čitateľnejšie a čistejšie.
 
 ## Regex
 
-Zaujíma ťa, ako Django porovnáva URL so zobrazeniami? No, to je trochu zložitejšie. Django používa `regex`, čo je skratka pre "regulárne výrazy". Regex má veľa (veľa!) pravidiel, ktoré tvoria vzor vyhľadávania. Keďže regexy sú pokročilá téma, nebudeme sa nimi veľmi detailne zaoberať.
+Zaujíma ťa, ako Django porovnáva URL so zobrazeniami? No, táto časť je trochu zložitejšia. Django používa `regex`, čo je skratka pre "regulárne výrazy". Regex má veľa (veľa!) pravidiel, ktoré tvoria vyhľadávací vzor. Keďže regexy sú pokročilá téma, nebudeme sa nimi veľmi detailne zaoberať.
 
-Ak chceš porozumieť tvorbe vzorov, tu je príklad procesu - budeme potrebovať iba obmedzenú množinu pravidiel, ktorými vyjadríme vzor, ktorý hľadáme, konkrétne:
+Ak chceš porozumieť tvorbe vzorov, tu je príklad postupu - budeme potrebovať iba obmedzenú množinu pravidiel, ktorými zapíšeme vzor, ktorý hľadáme, konkrétne:
 
-```
-^ pre začiatok textu
-$ pre koniec textu
-\d pre číslicu
-+ indikuje, že predchádzajúca položka sa má zopakovať aspoň raz
-() ohraničuje časť vzoru
-```
+* `^` znamená začiatok textu
+* `$` znamená koniec textu
+* `\d` znamená číslica
+* `+` znamená, že predchádzajúci prvok sa má opakovať aspon jeden krát
+* `()` znamená, že chceme zachytiť časť vzoru
 
-Všetko ostatné v definícii url bude brané doslovne.
+Všetko ostatné v definícii URL bude brané doslovne.
 
 Teraz si predstav, že máš webovú stránky s adresou napríklad `http://www.mysite.com/post/12345/`, kde `12345` je číslo tvojho postu.
 
-Písať samostatné views pre všetky čísla postov by bolo vážne otravné. S regulárnym výrazom však vieme vytvoriť vzor, ktorý bude zodpovedať url a vyextrahovať z nej číslo, ktoré potrebujeme: `^post/(\d+)/$`. Rozoberme si to na drobné, aby sme videli, čo sa tu vlastne deje:
+Písať samostatné zobrazenia pre všetky čísla postov by bolo naozaj otravné. Pomocou regulárnych výrazov však vieme vytvoriť vzor, ktorý bude zodpovedať URL a vytiahnuť z nej číslo, ktoré potrebujeme: `^post/(\d+)/$`. Rozoberme si to na drobné, aby sme videli, čo sa tu vlastne deje:
 
-*   **^post/** hovorí Djangu, aby zobral čokoľvek, čo má na začiatku url `post` (hneď po `^`)
-*   **(\d+)** znamená, že tam bude číslo (jedna alebo viac číslic) a že chceme číslo zachytiť a extrahovať
-*   **/** povie Djangu, že bude nasledovať ďalší znak `/`
-*   **$** potom označuje koniec adresy URL, čo znamená, že vzoru budú zodpovedať iba reťazce s `/` na konci
+* **^post/** hovorí Djangu, aby zobral čokoľvek, čo má na začiatku url `post` (hneď po `^`)
+* **(\d+)** znamená, že tam bude číslo (jedna alebo viac číslic) a že chceme číslo zachytiť a vytiahnuť
+* **/** povie Djangu, že bude nasledovať ďalší znak `/`
+* **$** potom označuje koniec adresy URL, čo znamená, že vzoru budú zodpovedať iba reťazce s `/` na konci
 
-## Tvoja prvá Django url!
+## Tvoja prvá Django URL!
 
 Je čas vytvoriť našu prvú URL! Chceme, aby 'http://127.0.0.1:8000/' bola domovská stránka nášho blogu a zobrazovala zoznam príspevkov.
 
-Tiež chceme udržiavať súbor `mysite/urls.py` čistý, takže naimportujeme url z našej aplikácie `blog` do hlavného súboru `mysite/urls.py`.
+Tiež chceme udržiavať súbor `mysite/urls.py` čistý, takže naimportujeme URL z našej aplikácie `blog` do hlavného súboru `mysite/urls.py`.
 
-Neboj sa, zmaž všetky zakomentované riadky (tie, čo začínajú `#`) a pridaj riadok, ktorý naimportuje `blog.urls` do hlavnej url (`''`).
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
 
 Súbor `mysite/urls.py` by mal teraz vyzerať takto:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import include
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
     url(r'', include('blog.urls')),
 ]
 ```
@@ -92,16 +95,20 @@ Pri písaní regulárnych výrazov je vždy dobré pridať pred reťazec `r`. To
 
 ## blog.urls
 
-Vytvor nový prázdny súbor `blog/urls.py`. Dobre! Pridaj tieto prvé dva riadky:
+Vytvor nový prázdny súbor s názvom `urls.py` v priečinku `blog`. Dobre! Pridaj tieto dva riadky:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
 from . import views
 ```
 
-Tu iba importujeme Django metódy a všetky naše `views` z aplikácie `blog` (zatiaľ žiadne nemáme, ale k tomu sa o chvíľu dostaneme!)
+Tu iba importujeme Django metódu `url` a všetky naše `views` z aplikácie `blog` (zatiaľ žiadne nemáme, ale k tomu sa o chvíľu dostaneme!)
 
-Potom môžeme pridať náš prvý URL vzor:
+Následne, môžeme pridať náš prvý URL vzor:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 urlpatterns = [
@@ -111,16 +118,12 @@ urlpatterns = [
 
 Ako vidíš, priradili sme `view` s názvom `post_list` tejto URL: `^$`. Tento regulárny výraz sa bude zhodovať iba ak po `^` (začiatku) bude nasledovať `$` (koniec) - takže zodpovedať bude iba prázdny reťazec. To je správne, pretože v Django URL prekladači 'http://127.0.0.1:8000/' nie je súčasťou URL. Tento vzor povie Djangu, že `views.post_list` je to správne miesto, kam treba ísť, ak niekto vstúpi na stránku cez adresu 'http://127.0.0.1:8000/'.
 
-Posledná časť `name='post_list'` je názov URL, ktorý sa použije na identifikáciu view. Názov URL môže byť rovnaký ako názov view, ale pokojne to môže byť aj niečo úplne iné. Neskôr budeme v projekte používať pomenované URL, takže je dôležité pomenovať všetky URL v aplikácii. Názvy by mali byť unikátne a ľahké na zapamätanie.
-
-Všetko v poriadku? Otvor http://127.0.0.1:8000/ vo svojom prehliadači a pozri sa na výsledok.
-
-![Chyba][2]
+Posledná časť `name='post_list'` je názov URL, ktorý sa použije na identifikáciu zobrazenia. Názov môže byť rovnaký ako názov zobrazenia, ale pokojne to môže byť aj niečo úplne iné. Neskôr budeme v projekte používať pomenované URL, takže je dôležité pomenovať všetky URL v aplikácii. Názvy by mali byť unikátne a ľahké na zapamätanie.
 
- [2]: images/error1.png
+Ak sa teraz pokúsiš navštiviť http://127.0.0.1:8000/ uvidíš správu, že stránka nie je dostupná ('web page not available'). Toto je z toho dôvodu že server (spomínaš si keď si spúšťala `runserver`?) už nebeží. Pozri sa na konzolu svojho serveru, aby si zistila prečo.
 
-"Funguje to!" zmizlo, čo? Neboj sa, je to len chybová stránka, nič, čoho by si sa mala báť! Vlastne bývajú celkom užitočné:
+![Chyba](images/error1.png)
 
-Môžeš si prečítať, že neexistuje **žiadny atribút post_list**. Pripomína ti *post_list* niečo? Tak sme nazvali náš view! To znamená, že je všetko v poriadku, len sme ešte nevytvorili náš *view*. Žiadne obavy, aj k tomu sa dostaneme.
+Konzola zobrazuje chybu, ale neboj sa - je to pomerne užitočné: hovorí ti, že neexistuje atribút post_list (**no attribute 'post_list'**). To je názov *view*, ktorý sa Django pokúša nájsť a použiť, ale sme ho ešte nevytvorili. V tejto fáze `/admin/` tiež nefunguje. Žiadne obavy, aj k tomu sa dostaneme.
 
-> Ak chceš vedieť viac o Django URLconfs, pozri sa na oficiálnu dokumentáciu: https://docs.djangoproject.com/en/1.8/topics/http/urls/
+> Ak chceš vedieť viac o Django URLconfs, pozri sa na oficiálnu dokumentáciu: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/sk/django_views/README.md b/sk/django_views/README.md
index 8512c29d0ee..5fdb75edc92 100755
--- a/sk/django_views/README.md
+++ b/sk/django_views/README.md
@@ -1,6 +1,6 @@
 # Django views - čas tvoriť!
 
-Je čas zbaviť sa toho bugu, čo sme vytvorili v poslednej kapitole :)
+Je čas zbaviť sa toho bugu, čo sme vytvorili v poslednej kapitole! :)
 
 *View* je miesto, kam dávame "logiku" našej aplikácie. Bude požadovať informáciu z `modelu`, ktorý si už vytvorila a pošle to do `šablóny`. Šablónu (template) budeme vytvárať v nasledujúcej kapitole. Views sú vlastne len metódy Pythonu, ktoré sú trochu zložitejšie, ako tie, ktoré sme písali v kapitole **Úvod do Pythonu**.
 
@@ -10,29 +10,35 @@ Views sú umiestnené v súbore `views.py`. Naše *views* budeme pridávať do s
 
 OK, otvorme tento súbor a pozrime sa, čo je v ňom:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
 # Create your views here.
 ```
 
-Veľa toho nie je. Najjednoduchší *view* môže vyzerať zhruba takto.
+Je tu toho málo zatiaľ.
+
+Ako si spomínaš riadky začínajúce s `#` sú komentáre - to znamená, že ich Python nespustí.
+
+Vytvorme *view* ako nám komentár naznačuje. Pridaj nasledovný minimálny view pod komentárom:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Ako vidíš, vytvorili sme metódu (`def`) nazvanú `post_list`, ktorá použije `request` (žiadosť) a `return` (vráti) metódu `render`, ktorou vykreslí (spojí dokopy) našu šablónu `blog/post_list.html`.
+Ako vidíš, vytvorili sme funkciu (`def`) nazvanú `post_list`, ktorá použije `request` (žiadosť) a `return` (vráti) metódu `render`, ktorá vytvorí (spojí dokopy) našu šablónu `blog/post_list.html`.
 
-Ulož súbor, prejdi na http://127.0.0.1:8000 / a pozri sa, čo sa udeje.
+Ulož súbor a prejdi na http://127.0.0.1:8000 / a pozri sa, čo sa udeje.
 
 Ďalšia chyba! Prečítaj si, o čo ide tentokrát:
 
-![Chyba][1]
-
- [1]: images/error.png
+![Chyba](images/error.png)
 
-To je jednoduché: *TemplateDoesNotExist*. Opravme túto chybu a v nasledujúcej kapitole vytvorme šablónu!
+Ukazuje, že server aspoň znovu beží, ale stále to nie je ono, že? Neboj sa, je to len chybová stránka, nič čoho sa treba báť! Podobne ako chyby v konzole, sú vlastne velkom úťitočné. Dočítaš sa, že *TemplateDoesNotExist*. Poďme opraviť túto chybu a vytvoríme šablónu v nasledujúcej kapitole!
 
-> Viac informácií o Django views získaš v oficiálnej dokumentácii: https://docs.djangoproject.com/en/1.8/topics/http/views/
+> Viac informácií o Django views získaš v oficiálnej dokumentácii: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/sk/dynamic_data_in_templates/README.md b/sk/dynamic_data_in_templates/README.md
index cb6675ff9ab..72923b7bc7f 100755
--- a/sk/dynamic_data_in_templates/README.md
+++ b/sk/dynamic_data_in_templates/README.md
@@ -1,13 +1,15 @@
 # Dynamické dáta v šablónach
 
-Máme rozdielne kúsky na svojom mieste: `Post` model je definovaný v `models.py`, máme `post_list` v `views.py` a pridanú šablónu. Ale ako prinútime HTML šablónu, aby zobrazovala náš príspevok? Pretože to je to, čo chceme: vziať nejaký obsah (modely uložené v databáze) a zobraziť ich pekne v našej šablóne, že?
+Máme rozdielne kúsky na svojom mieste: `Post` model je definovaný v `models.py`, máme `post_list` v `views.py` a pridanú šablónu. Ale ako prinútime HTML šablónu, aby zobrazovala náš príspevok? Pretože to je to, čo chceme urobiť - vziať nejaký obsah (modely uložené v databáze) a zobraziť ich pekne v našej šablóne, že?
 
-To je presne to, čo majú *views* robiť: spojiť modely a šablóny. V našom `post_list` *view* potrebujeme vziať modely ktoré chceme zobraziť a posunúť ich do šablóny. Takže sa v podstate rozhodneme vo *view* čo (model) bude zobrazené v šablóne.
+To je presne to, čo majú *views* robiť: spojiť modely a šablóny. V našom `post_list` *view* potrebujeme vziať modely ktoré chceme zobraziť a posunúť ich do šablóny. Takže sa rozhodneme vo *view* čo (model) bude zobrazené v šablóne.
 
-Dobre, takže ako to dosiahneme?
+Dobre, takže ako toto dosiahneme?
 
 Musíme otvoriť náš `blog/views.py`. Zatiaľ `post_list` *view* vyzerá takto:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
@@ -17,28 +19,32 @@ def post_list(request):
 
 Pamätáš si, keď sme rozprávali o zahrnutí kódu napísanom v rozdielnych súboroch? Teraz nastal čas kedy musíme zahrnúť model, ktorý sme napísali v `models.py`. Pridáme tento riadok `from .models import Post` takto:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from .models import Post
 ```
 
-Bodka za `from` znamená *aktuálna zložka* alebo *aktuálna aplikácia*. Pretože `views.py` a `models.py` sú v rovnakej zložke, môžeme jednoducho použiť `.` a meno súboru (bez `.py`). Potom importujeme názov modelu (`Post`).
+Bodka za `from` znamená *aktuálna zložka* alebo *aktuálna aplikácia*. `views.py` aj `models.py` sú v rovnakom adresári. To znamená, že môžeme použiť `.` a názov súboru (bez `.py`). Potom importujeme názov modelu (`Post`).
 
 Ale čo ďalej? Na to aby sme boli schopní vziať konkrétny príspevok blogu z `Post` modelu potrebujeme niečo, čo sa volá `QuerySet`.
 
 ## QuerySet
 
-Už by si mala vedieť ako funguje QuerySets. Hovorili sme o tom v kapitole [Django ORM (QuerySets)][1].
+Už by si mala vedieť ako funguje QuerySets. Hovorili sme o tom v kapitole [Django ORM (QuerySets)](../django_orm/README.md).
 
- [1]: ../django_orm/README.md
+Takže teraz chceme zoznam príspevkov, ktoré sú uverejnené a zoradené podľa `published_date`, však? To sme už spravili v kapitole QuerySets!
 
-Takže teraz máme záujem o zoznam príspevkov blogu, ktoré sú uverejnené a zoradené podľa `published_date`, však? To sme už spravili v kapitole QuerySets!
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
 ```
 
-Teraz vložíme tento kus kódu do súboru `blog/views.py` pridaním do funkcie `def post_list(request)`:
+Teraz vložíme tento kus kódu do súboru `blog/views.py` pridaním funkcie `def post_list(request)`, ale nezabudni najprv pridať `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
@@ -50,16 +56,16 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Vezmi prosím na vedomie, že vytvárame *premennú* pre náš QuerySet: `posts`. Považuj to za meno nášho QuerySetu. Odteraz ho môžeme referovať pod týmto menom.
+Posledná chýbajúca časť je predanie `posts` QuerySetu do šablóny. Neboj sa, v nasledujúcej kapitole si ukážeme ako ju zobraziť.
 
-Taktiež, kód používa funkciu `timezone.now()`, takže musíme pridať import pre `timezone`.
-
-Posledná chýbajúca časť je predanie `posts` QuerySetu do šablóny (v nasledujúcej kapitole si ukážeme ako ju zobraziť).
+Vezmi prosím na vedomie, že vytvárame *premennú* pre náš QuerySet: `posts`. Považuj to za meno nášho QuerySetu. Odteraz ho môžeme referovať pod týmto menom.
 
-V `render` funkcii už máme parameter `request` (takže všetko čo príjmeme od užívateľa cez Internet) a súbor šablóny `'blog/post_list.html'`. Posledný parameter, ktorý vyzerá takto: `{}` je miesto na ktoré môžeme dať nejaké veci ktoré môže použiť šablóna. Potrebujeme im dať mená (zatiaľ sa budeme držať `'posts'` :)). Malo by to vyzerať takto: `{'posts': posts}`. Všimni si, že časť pred `:` je reťazec: potrebuješ ju obaliť do úvodzoviek `''`.
+V `render` funkcii už máme jeden parameter `request` (všetko čo príjmeme od užívateľa cez Internet) a ďalší ktorý poskytuje súbor šablóny `'blog/post_list.html'`). Posledný parameter, `{}` je miesto na ktoré môžeme dať nejaké veci ktoré môže použiť šablóna. Potrebujeme im dať mená (zatiaľ sa budeme držať `'posts'`). :) Malo by to vyzerať takto: `{'posts': posts}`. Všimni si, že časť pred `:` je reťazec: potrebuješ ju obaliť do úvodzoviek:`"`.
 
 Nakoniec by náš súbor `blog/views.py` mal vyzerať takto:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from django.utils import timezone
@@ -72,4 +78,4 @@ def post_list(request):
 
 To je všetko! Čas prejsť na našu šablónu a zobraziť tento QuerySet!
 
-Pokiaľ si chceš prečítať niečo viac o QuerySets v Djangu mala by si sa pozrieť sem: https://docs.djangoproject.com/en/1.8/ref/models/querysets/
+Pokiaľ si chceš prečítať niečo viac o QuerySets v Djangu mala by si sa pozrieť sem: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/sk/extend_your_application/README.md b/sk/extend_your_application/README.md
index 1c5797d4793..fb8e66d177f 100755
--- a/sk/extend_your_application/README.md
+++ b/sk/extend_your_application/README.md
@@ -10,7 +10,7 @@ Už máme `Post` model, takže nepotrebujeme do `models.py` pridávať nič iné
 
 ## Vytvorenie šablóny odkazu na post detail
 
-Začneme tak, že pridáme link do súboru `blog/templates/blog/post_list.html`. Zatiaľ by mal vyzerať nejako takto:
+Začneme s pridaním odkazu v `blog/templates/blog/post_list.html` súbore. Zatiaľ by mal vyzerať takto: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -30,19 +30,21 @@ Začneme tak, že pridáme link do súboru `blog/templates/blog/post_list.html`.
 
 {% raw %}Chceme, aby link z titulku príspevku smeroval na stránku detailov príspevku. Zmeňme `<h1><a href="">{{ post.title }}</a></h1>` tak, aby odkazoval na stránku detailu príspevku:{% endraw %}
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
 ```
 
 {% raw %}Je na čase vysvetliť záhadné `{% url 'post_detail' pk=post.pk %}`. Ako možno tušíš, `{% %}` notácia znamená, že používame tagy Django šablóny. Tentoraz použijeme jeden, ktorý pre nás vytvorí URL!{% endraw %}
 
-`blog.views.post_detail` je cesta k `post_detail` *view* ktorý chceme vytvoriť. Poznámka: `blog` je názov aplikácie (zložky `blog`), `views` je meno súboru `views.py` a posledná časť - `post_detail` - je meno *view*.
+`post_detail` časť znamená, že Django bude očakávať URL v `blog/urls.py` s name=post_detail
 
-Teraz keď pôjdeme na: http://127.0.0.1:8000/ uvidíme chybu (ako sa dá očakávať, keďže nemáme URL alebo *view* pre `post_detail`). Bude to vyzerať takto:
+A čo s `pk=post.pk`? `pk` je skratka pre primárny kľúč, ktorý jednoznačne určuje každý záznam v databáze. Keďže sme neurčili primárny kľúč v našom `Post` modely, Django ho vytvorí namiesto nás (štandardne je to číslo ktoré sa zvýši o jedna pre každý záznam, t.j. 1, 2, 3) a pridá ho ako pole s názvom `pk` ku každému z našich príspevkov. K primárny kľúču môžeme pristupovať napísaním `post.pk`, rovnako ako pristupujeme iným poliam (`titul`, `autor`, atď) v našom `Post` objekte!
 
-![NoReverseMatch error][1]
+Teraz keď pôjdeme na: http://127.0.0.1:8000/ uvidíme chybu (ako sa dá očakávať, keďže ešte nemáme URL alebo *view* pre `post_detail`). Bude to vyzerať takto:
 
- [1]: images/no_reverse_match2.png
+![NoReverseMatch error](images/no_reverse_match2.png)
 
 ## Vytvor URL na detail príspevku
 
@@ -50,7 +52,9 @@ Vytvorme URL v `urls.py` pre náš `post_detail` *view*!
 
 Chceme aby sa detaily nášho prvého príspevku zobrazili na tejto **URL**: http://127.0.0.1:8000/post/1/
 
-Vytvorme URL v súbore `blog/urls.py` tak, aby odkazoval Django na *view* nazvaný `post_detail`, ktorý zobrazí celý príspevok blogu. Pridaj riadok `url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),` do súboru `blog/urls.py`. Súbor by mal vyzerať takto:
+Vytvorme URL v súbore `blog/urls.py` tak, aby odkazoval Django na *view* nazvaný `post_detail`, ktorý zobrazí celý príspevok blogu. Pridaj riadok `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` do súboru `blog/urls.py`. Súbor by mal vyzerať takto:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
@@ -58,58 +62,63 @@ from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
 ]
 ```
 
-Táto časť `^post/(?P<pk>[0-9]+)/$` vyzerá desivo, ale neboj sa - o chvíľu ti ju vysvetlíme: - znova začína s `^` -- začiatkom - `post/` znamená len, že po začiatku by URL mala obsahovať slová **post** a **/**. Zatiaľ je všetko v poriadku. - `(?P<pk>[0-9]+)` - táto časť je zložitejšia. Znamená to, že Django vezme všetko, čo tu vložíš a premiestni to do premennej s názvom `pk`. `[0-9]` nám tiež hovorí, že to môžu byť len čísla, nie písmená (takže všetko medzi 0 a 9). `+` znamená, že musíme mať aspoň jedno číslo. Takže niečo ako `http://127.0.0.1:8000/post//` nie je validné, ale `http://127.0.0.1:8000/post/1234567890/` je úplne v poriadku! - `/` - potom znova potrebujeme **/** - `$` - "koniec"!
+Táto časť `^post/(?P<pk>\d+)/$` vyzerá desivo, ale bez obáv - vysvetlíme si:
 
-To znamená, že ak zadáš `http://127.0.0.1:8000/post/5/` do svojho prehliadača, Django pochopí, že hľadáš *view* s názvom `post_detail` a prenesie informácie z `pk` rovné `5` do toho *view*.
+- začína to opäť s `^` - "začiatok".
+- `post/` len znamená, že na začiatku, URL by mala obsahovať slovo **post** a **/**. Zatiaľ všetko v poriadku.
+- `(?P<pk>\d+)` - táto časť je zložitejšia. Znamená to, že Django vezme všetko, čo tu vložíš a premiestni to do premennej s názvom `pk`. (Všimni si, že to zodpovedá názvu ktorý sme dali primárnemu kľúču v `blog/templates/blog/post_list.html`!) `\d` nám hovorí, že to môže byť iba číslica, nie písmeno (takže všetko od 0 po 9). `+` znamená, že musíme mať aspoň jedno číslo. Takže niečo ako `http://127.0.0.1:8000/post//` nie je validné, ale `http://127.0.0.1:8000/post/1234567890/` je úplne v poriadku!
+- `/` – potom potrebujeme **/** ešte raz.
+- `$` – "koniec"!
 
-`pk` je skratka pre `primárny kľúč (primary key)`. Tento názov je často používaný v Django projektoch. Ale môžeš si pomenovať svoje premenná ako chceš (pamätaj: malé písmená a `_` namiesto medzier!). Napríklad namiesto `(?P<pk>[0-9]+)` môžeme mať premennú `post_id`, takže táto časť by vyzerala: `(?P<post_id>[0-9]+)`.
-
-Dobre, pridali sme nový vzor URL do `blog/urls.py`! Obnovme stránku: http://127.0.0.1:8000/ Boom! Ďalšia chyba! Ako sa dalo očakávať!
+To znamená, že ak zadáš `http://127.0.0.1:8000/post/5/` do svojho prehliadača, Django pochopí, že hľadáš *view* s názvom `post_detail` a prenesie informácie z `pk` rovné `5` do toho *view*.
 
-![AttributeError][2]
+OK, pridali sme nový URL vzor `blog/urls.py`! Poďme obnoviť stránku: http://127.0.0.1:8000 / Boom! Server znova prestal bežať. Pozri sa do konzoly - ako sa aj dalo očakávať je tam ďalšia chyba!
 
- [2]: images/attribute_error2.png
+![AttributeError](images/attribute_error2.png)
 
 Pamätáš si, čo je ďalší krok? Samozrejme: pridávanie view!
 
 ## Pridaj view do detailu príspevku
 
-Tentokrát má náš *view* extra parameter `pk`. Náš *view* ho potrebuje zachytiť, že? Takže definujeme našu funkciu ako `def post_detail(request, pk):`. Všimni si, že musíme použiť rovnaké meno, ako to, ktoré sme špecifikovali v Url (`pk`). Vynechanie tejto premmenej je nesprávne a bude mať za následok chybu!
+Tentokrát má náš *view* extra parameter, `pk`. Náš *view* ho potrebuje zachytiť, že? Takže definujeme našu funkciu ako `def post_detail(request, pk):`. Všimni si, že musíme použiť rovnaké meno, ako to, ktoré sme špecifikovali v Url (`pk`). Vynechanie tejto premmenej je nesprávne a bude mať za následok chybu!
 
-Teraz chceme aby sme dostali jeden a iba jeden príspevok blogu. Na to môžeme použiť querysets takto:
+Teraz chceme aby sme dostali jeden a len jeden príspevok blogu. Na to môžeme použiť querysets takto:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 Post.objects.get(pk=pk)
 ```
 
-Ale tento kód má problém. Pokiaľ tu nie je žiaden `Post` s daným `primárnym kľúčom`(`pk`) budeme mať super škaredú chybu!
-
-![DoesNotExist error][3]
-
- [3]: images/does_not_exist2.png
+Ale tento kód má problém. Pokiaľ tu nie je žiaden `Post` s daným `primárnym kľúčom`(`pk`) budeme mať veľmi škaredú chybu!
 
-To nechceme! Ale samozrejme Django prichádza s niečim, čo si s tým poradí: `get_object_or_404`. V príade, že neexistuje žiaden `Post` s daným `pk` zobrazí oveľa krajšiu stránku (nazývanú `Page Not Found 404`).
+![DoesNotExist error](images/does_not_exist2.png)
 
-![Page not found][4]
+To nechceme! Ale samozrejme Django prichádza s niečim, čo si s tým poradí: `get_object_or_404`. V príade, že neexistuje žiaden `Post` s daným `pk` zobrazí oveľa krajšiu stránku, `Page Not Found 404`.
 
- [4]: images/404_2.png
+![Page not found](images/404_2.png)
 
 Dobrá správa je, že si môžeš vytvoriť svoju vlastnú `Page not found` stránku a spraviť ju tak peknú ako len chceš. Ale to nie je momentálne príliš dôležité, takže to preskočíme.
 
 Dobre, čas pridať *view* do nášho `views.py` súboru!
 
-Mali by sme otvoriť `blog/views.py` a pridať nasledujúci kód:
+V `blog/urls.py` sme vytvorili URL pravidlo s názvom `post_detail`, ktoré odkazuje na zobrazenies názvom `views.post_detail`. To znamená, že Django očakáva zobrazovaciu funkciu s nazvom `post_detail` v súbore `blog/views.py`.
+
+Mali by sme otvoriť `blog/views.py` a pridať nasledovný kód ku ostatným `from` riadkom:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render, get_object_or_404
 ```
 
+A na konci súboru pridáme náš *view*:
 
-Blízko riadkov `from`. A na konci súboru pridáme náš *view*:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_detail(request, pk):
@@ -117,27 +126,24 @@ def post_detail(request, pk):
     return render(request, 'blog/post_detail.html', {'post': post})
 ```
 
-
 Áno. Nastal čas obnoviť stránku: http://127.0.0.1:8000/
 
-![Post list view][5]
-
- [5]: images/post_list2.png
+![Post list view](images/post_list2.png)
 
 Funguje to! Ale čo sa stane, keď klikneš na odkaz v názve príspevku blogu?
 
-![TemplateDoesNotExist error][6]
-
- [6]: images/template_does_not_exist2.png
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
 
 Ale nie! Ďalšia chyba! Ale už vieme, s čim mám dočinenia, že? Potrebujeme pridať šablónu!
 
-## Vytvor šablónu pre detail príspevku
+## Vytvor šablónu pre detaily príspevku
 
 Vytvoríme súbor v `blog/templates/blog` s názvom `post_detail.html`.
 
 Bude to vyzerať takto:
 
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -156,13 +162,11 @@ Bude to vyzerať takto:
 
 Znova raz rozširujeme `base.html`. V bloku `content` chceme zobraziť published_date príspevku (pokiaľ existuje), titulok a text. Ale mali by sme prebrať pár dôležitých vecí, však?
 
-{% raw %}`{% if ... %} ... {% endif %}` je tag šablóny, ktorý môžeme použiť ak chceme niečo skontrolovať (pamätáš na `if ... else ..` z kapitoly **Úvod do Pythonu**?). V tomto prípade chceme skontrolovať, či `published_date` príspevku nie je prázdny.{% endraw %}
-
-Dobre, môžeme obnoviť našu stránku a pozrieť sa, či `Page not found` zmizlo.
+{% raw %}`{% if ... %} ... {% endif %}` je tag šablóny, ktorý môžeme použiť ak chceme niečo skontrolovať. (Pamätáš si `if ... else ..` z **Úvodu do Pythonu**?) V tomto prípade chceme overiť či `published_date` príspevku nie je prázdny.{% endraw %}
 
-![Post detail page][7]
+Dobre, môžeme obnoviť našu stránku a pozrieť sa, či `TemplateDoesNotExist` zmizlo.
 
- [7]: images/post_detail2.png
+![Post detail page](images/post_detail2.png)
 
 Jupí! Funguje to!
 
@@ -170,29 +174,24 @@ Jupí! Funguje to!
 
 Bolo by dobré vedieť, či tvoja stránka stále funguje na PythonAnywhere, že? Pokúsme sa ju znova nasadiť.
 
-```
-$ git status
-$ git add -A .
-$ git status
-$ git commit -m "Pridaný view a šablóna pre detail príspevku blogu a taktiež CSS pre stránku."
-$ git push
-```
+{% filename %}command-line{% endfilename %}
 
-*   Potom v [Bash konzole PythonAnywhere][8]:
+    $ git status
+    $ git add --al .
+    $ git status
+    $ git commit -m "Pridaný view a šablóna pre detail príspevku blogu a taktiež CSS pre stránku."
+    $ git push
+    
 
- [8]: https://www.pythonanywhere.com/consoles/
+Potom v [Bash konzole PythonAnywhere](https://www.pythonanywhere.com/consoles/):
 
-```
-$ cd my-first-blog
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```
+{% filename %}command-line{% endfilename %}
 
-*   A nakoniec preskoč na [kartu Web][9] and klinki na **Reload**.
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
- [9]: https://www.pythonanywhere.com/web_app_setup/
+A nakoniec preskoč na [kartu Web](https://www.pythonanywhere.com/web_app_setup/) and klinki na **Reload**.
 
-A to by malo byť všetko! Gratulujeme :)
+A to by malo byť všetko! Gratulujeme :)
\ No newline at end of file
diff --git a/sk/how_the_internet_works/README.md b/sk/how_the_internet_works/README.md
index 0991dbd9c0d..cb52a868f49 100755
--- a/sk/how_the_internet_works/README.md
+++ b/sk/how_the_internet_works/README.md
@@ -1,5 +1,7 @@
 # Ako funguje Internet
 
+> Pre čitateľov doma: Táto kapitola je spracovaná v [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) videu.
+> 
 > Táto kapitola je inšpirovaná prednáškou "Ako funguje Internet" od Jessicy McKellar (http://web.mit.edu/jesstess/www/).
 
 Stavíme sa, že Internet používaš každý deň. Ale vieš, čo sa deje, keď napíšeš adresu, ako https://djangogirls.org do prehliadača a stlačíš `enter`?
@@ -8,39 +10,31 @@ Prvá vec, ktorú potrebuješ vedieť je, že webové stránky sú len kopa súb
 
 Pokiaľ nemáš skúsenosti s programovaní, môže byť pochopenie HTML zo začiatku zložité, ale tvoj webový prehliadač (ako Chrome, Safari, Firefox atď.) ho milujú. Webové prehliadače sú navrhnuté na to, aby rozumeli kódu, nasledovali jeho inštrukcie a prezentovali súbory, ktoré tvoria tvoju webovú stránku presne tak, ako to chceš.
 
-Ako s každým súborom, potrebujeme uložiť HTML súbor niekde na pevnom disku. V prípade Interntu používame špeciálne, výkonné počítače nazývane *servery*. Nemajú obrazovku, myš alebo klávesnicu, pretože ich hlavnou úlohou je ukladať dáta a poskytovať ich. Preto ich voláme *servery* -- pretože *poskytujú* (anglicky serve) tvoje dáta.
+Ako s každým súborom, potrebujeme uložiť HTML súbor niekde na pevnom disku. V prípade Interntu používame špeciálne, výkonné počítače nazývane *servery*. Nemajú obrazovku, myš alebo klávesnicu, pretože ich hlavnou úlohou je ukladať dáta a poskytovať ich. Preto ich voláme *serveri* -- pretože *poskytujú* (anglicky serve) tvoje dáta.
 
 OK, avšak chceš vedieť, ako vyzerá Internet, že?
 
 Nakreslili sme ti obrázok! Vyzerá takto:
 
-![Obrázok 1.1][1]
+![Obrázok 1.1](images/internet_1.png)
 
- [1]: images/internet_1.png
+Vyzerá to ako neporiadok, že? V skutočnosti je to sieť prepojených strojov (hore spomenutých *serverov*). Stoviek a tisícok strojov! Mnoho, mnoho kilometrov káblov po celom svete! Môžeš navštíviť stránku Submarine Cable Map (http://submarinecablemap.com) aby si videla nakoľko komplikovaná sieť to je. Tu je obrázok zo stránky:
 
-Vyzerá to ako neporiadok, že? V skutočnosti je to sieť prepojených strojov (nedávno spomenutých *serverov*). Stoviek a tisícok strojov! Mnoho, mnoho kilometrov káblov po celom svete! Môžeš navštíviť stránku Submarine Cable Map (http://submarinecablemap.com) aby si videla nakoľko komplikovaná sieť to je. Tu je obrázok zo stránky:
-
-![Obrázok 1.2][2]
-
- [2]: images/internet_3.png
+![Obrázok 1.2](images/internet_3.png)
 
 Nie je to fascinujúce? Ale zjavne nie je možné mať kábel medzi každým strojom pripojeným k Internetu. Takže na to, aby sme boli schopní kontaktovať stroj (napríklad ten na ktorom je uložená stránka https://djangogirls.org) musíme poslať žiadosť cez mnoho, mnoho rozdielnych strojov.
 
 Vyzerá to takto:
 
-![Obrázok 1.3][3]
-
- [3]: images/internet_2.png
+![Obrázok 1.3](images/internet_2.png)
 
 Predstav si, že keď napíšeš https://djangogirls.org, pošleš list, v ktorom stojí: "Drahé Django Girls, chcem vidieť stránku djangogirls.org. Prosím pošli mi ju!"
 
 Tvoj list ide na najbližšiu poštu. Potom ide na ďalšiu, ktorá je o čosi bližšie adresátovi, potom na ďalšiu a ďalšiu až kým nedorazí do svojej destinácie. Jediná unikátna vec je, že ako pošleš mnoho listov (*data paketov*) na rovnaké miesto, môžu ísť cez úplne odlišné pošty (*routy*). Záleží to na tom, ako sú distribuované na každej pošte.
 
-![Obrázok 1.4][4]
-
- [4]: images/internet_4.png
+![Obrázok 1.4](images/internet_4.png)
 
-Áno, je to tak jednoduché. Pošleš správu a očakávaš nejakú odpoveď. Samozrejme, namiesto papiera a pera použijes byty dát, ale myšlienka je rovnaká!
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
 
 Namiesto adries s menom ulice, mesta, PSČ a krajinou používame IP adresy. Tvoj počítač sa najprv opýta DNS (Domain Name System) aby preložil djangogirls.org na IP adresu. Funguje to trocha ako staré dobré telefónne zoznamy, kde si môžeš vyhľadať meno osoby ktorú chceš kontaktovať a nájsť jej telefón a adresu.
 
@@ -48,6 +42,6 @@ Keď pošleš list, musí mať určité náležitosti, aby ho bolo možné sprá
 
 Takže, v podstate, keď máš webovú stránku, musíš mať *server* (stroj) na ktorom bude žiť. Keď *server* obdrží prichádzajúcu *požiadavku* (v liste), pošle naspäť tvoju webovú stránku (v ďalšom liste).
 
-Keďže toto je Django tutoriál, spýtaš sa, čo robí Django. Keď pošleš odpoveď, nechceš vždy poslať rovnaké veci každému. Je oveľa lepšie ak sú tvoje listy osobné, hlavne pre osobu, ktorá ti práve teraz napísala, že? Django ti pomáha vytvoriť tieto osobné, zaujímavé listy :).
+Keďže toto je Django tutoriál, spýtaš sa, čo robí Django. Keď pošleš odpoveď, nechceš vždy poslať rovnaké veci každému. Je oveľa lepšie ak sú tvoje listy osobné, hlavne pre osobu, ktorá ti práve teraz napísala, že? Django ti pomáha vytvoriť tieto osobné, zaujímavé listy. :)
 
 Dosť bolo rečí, je čas tvoriť!
\ No newline at end of file
diff --git a/sk/html/README.md b/sk/html/README.md
index 280869a6940..75ae0ac13d9 100755
--- a/sk/html/README.md
+++ b/sk/html/README.md
@@ -2,73 +2,72 @@
 
 Môžno sa pýtaš, čo jej šablóna?
 
-Šablóna je súbor, ktorý môžeme znova opakovane použiť, aby sme prezentovali nové informácie v konzistentnom formáte - šablónu môžeš použiť napríklad ako pomôcku pri písaní listu, pretože aj napriek tomu, že každý list môže obsahovať rozdielnu správu a byť adresovaný inej osobe, budú mať rovnaký formát.
+Šablóna je súbor, ktorý môžeme znova opakovane použiť, aby sme prezentovali nové informácie v konzistentnom formáte - šablónu môžeš použiť napríklad ako pomôcku pri písaní listu, pretože aj napriek tomu, že každý list môže obsahovať rozdielnu správu a byť adresovaný inej osobe, bude mať rovnaký formát.
 
-Formát Django šablóny je popísaný v jazyk nazývanom HTML (to je to HTML, ktoré sme spomenuli v prvej kapitole **Ako funguje Internet**).
+Formát Django šablóny je popísaný v jazyku nazývanom HTML (to je to HTML, ktoré sme spomenuli v prvej kapitole **Ako funguje Internet**).
 
 ## Čo je HTML?
 
-HTML je jednoduchý kód, ktorý je interpretovaný tvojím webovým prehliadačom - ako napríklad Chrome, Firefox alebo Safari - aby tak zobrazil užívateľom webové stránky.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
-HTML znamená "HyperText Markup Language". **HyperText** znamená, že sa jedná o typ textu, ktorý podporuje hypertextové odkazy medzi stránkami. **Markup** znamená, že sme vzali dokument a označili ho kódom aby sme niečomu povedali (v tomto prípade prehliadaču) ako interpretovať stránku. HTML kód je budovaný za pomoci **tagov**, každý začínajúci znakom `<` a končiaci znakom `>`. Tieto tagy reprezentujú značkovacie (Markup) **elementy**.
+HTML znamená "HyperText Markup Language". **HyperText** znamená, že sa jedná o typ textu, ktorý podporuje hypertextové odkazy medzi stránkami. **Markup** znamená, že sme vzali dokument a označili ho kódom aby sme niečomu povedali (v tomto prípade prehliadaču) ako interpretovať stránku. HTML kód je budovaný za pomoci **tagov**, ktoré začínajú znakom `<` a končia znakom `>`. Tieto tagy reprezentujú značkovacie (Markup) **elementy**.
 
 ## Tvoja prvá šablóna!
 
-Vytvorenie šablóny znamená vytvorenie súboru šablóny.
+Vytvorenie šablóny znamená vytvorenie súboru šablóny. Všetko je súbor, však? To si si asi už všimla.
 
 Šablóny sú uložené v zložke `blog/templates/blog`. Takže najprv vytvor v zložke blogu zložku s názvom `templates`. Potom vytvor ďalšiu zložku s názvom `blog` v zložke templates:
 
-```
-blog
-└───templates
-    └───blog
-```
+    blog
+    └───templates
+        └───blog
+    
 
-(Možno sa pýtaš prečo potrebujeme dve zložky s menom `blog` - ako neskôr zistíš, je to len užitočna konvencia, ktorá ti uľahčí život keď veci začnú byť komplikovanejšie.)
+(Možno sa pýtaš prečo potrebujeme dve zložky s menom `blog` - ako neskôr zistíš, je to len užitočna konvencia, ktorá ti uľahčí život keď sa veci začnú komplikovať.)
 
 A teraz vytvor súbor `post_list.html` (zatiaľ ho ponechaj prázdny) v zložke `blog/templates/blog`.
 
 Pozri sa, ako momentálne vyzerá tvoja stránka: http://127.0.0.1:8000/
 
-> Pokiaľ stále vidíš chybu `TemplateDoesNotExists`, skús reštartovať tvoj server. Použi príkazový riadok, zastav server stlačením Ctrl+C (stlač naraz tlačidlá Control a C) a spusti ho znova pomocou príkazu `python manage.py runserver`.
+> Pokiaľ stále vidíš chybu `TemplateDoesNotExist`, skús vyreštartovať svoj server. Choď dp príkazového riadku, zastav server stlačením Ctrl+C (stlač naraz tlačidlá Control a C) a spusti ho znova pomocou príkazu `python manage.py runserver`.
 
-![Obrázok 11.1][1]
-
- [1]: images/step1.png
+![Obrázok 11.1](images/step1.png)
 
 Žiadne ďalšie chyby! Gratulujeme :) Avšak tvoja stránka zatiaľ neukazuje nič, okrem prázdnej stránky, pretože tvoja šablóna je taktiež prázdna. To musíme opraviť.
 
 Pridaj nasledujúci kód do tvojho súboru šablóny:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
-    <p>Ahoj!</p>
-    <p>Funguje to!</p>
+    <p>Hi there!</p>
+    <p>It works!</p>
 </html>
 ```
 
 Takže ako momentálne vyzerá tvoja stránka? To môžeš zistiť kliknutím na: http://127.0.0.1:8000/
 
-![Obrázok 11.2][2]
-
- [2]: images/step3.png
+![Obrázok 11.2](images/step3.png)
 
 Funguje to! Dobrá práca :)
 
-*   Najzákladnejší tag, `<html>`, je vždy na začiatku každej webovej stránky a `</html>` je vždy na jej konci. Ako môžeš vidieť, celý obsah stránky sa nachádza medzi začínajúcim tagom `<html>` a uzatvárajúcim tagom `</html>`
-*   `<p>` je tag pre element odstavca; `</p>` uzatvára každý odstavec
+* Najzákladnejší tag, `<html>`, je vždy na začiatku každej webovej stránky a `</html>` je vždy na jej konci. Ako môžeš vidieť, celý obsah stránky sa nachádza medzi začínajúcim tagom `<html>` a uzatvárajúcim tagom `</html>`
+* `<p>` je tag pre element odstavca; `</p>` uzatvára každý odstavec
 
-## Head & body
+## Head a body
 
 Každá HTML stránka je taktiež rozdelená do dvoch elementov: **head** a **body**.
 
-*   **head** je element, ktorý obsahuje informácie o dokumente, ktoré nie sú zobrazené na obrazovke.
+* **head** je element, ktorý obsahuje informácie o dokumente, ktoré nie sú zobrazené na obrazovke.
 
-*   **body** je element, ktorý obsahuje všetko ostatné zobrazené ako časť webovej stránky.
+* **body** je element, ktorý obsahuje všetko ostatné zobrazené ako časť webovej stránky.
 
 `<head>` používame, aby sme povedali prehliadaču o konfigurácii stránky a `<body>` aby sme mu povedali, čo na stránke je.
 
-Napríklad môžeš dať stránke titulok za použitia title elementu vo vnútri `<head>` takto:
+Napríklad môžeš dať stránke titulok pomocou title elementu v hlavičke `<head>` takto:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -76,41 +75,42 @@ Napríklad môžeš dať stránke titulok za použitia title elementu vo vnútri
         <title>Ola's blog</title>
     </head>
     <body>
-        <p>Ahoj!</p>
-        <p>Funguje to!</p>
+        <p>Hi there!</p>
+        <p>It works!</p>
     </body>
 </html>
 ```
 
 Ulož súbor a znova načítaj svoju stránku.
 
-![Obrázok 11.3][3]
-
- [3]: images/step4.png
+![Obrázok 11.3](images/step4.png)
 
-Všimni si ako prehliadač rozumie, že "Ola's blog" je titulok tvojej stránky? Interpretuje `<title>Ola's blog</title>` a vkladá text ako názov záložky (tento názov bude použitý aj keď si stránku uložíte a tak ďalej).
+Všimni si ako prehliadač rozumie, že "Ola's blog" je titulok tvojej stránky? Interpretuje `<title>Ola's blog</title>` a vkladá text ako názov záložky (tento názov bude použitý aj keď si stránku uložíš do záložky a tak ďalej).
 
 Pravdepodobne si taktiež všimneš, že každý začínajúci tag má svoj *uzatvárajúci tag* obsahujúci `/`, a že elementy sú *vnorené* (tj. nemôžeš daný tag zatvoriť, kým nie sú taktiež zatvorené všetky tagy, ktoré sú v jeho vnútri).
 
 Je to ako vkladať veci do krabice. Máš jednú veľkú krabicu, `<html></html>`; vo vnútri je `<body></body>`, a tá obsahuje menšie krabice: `<p></p>`.
 
-Musíš nasledovať tieto pravidlá *uzatvárania* tagov a *vnorenia* elementov - pokiaľ ich nebudeš dodržovať, prehliadač nemusí byť schopný správne interpretovať tagy a tvoja stránka bude zobrazená nesprávne.
+Musíš dodržovať pravidlá *uzatvárania* tagov a *vnorenia* elementov - pokiaľ ich nebudeš dodržovať, prehliadač nemusí správne interpretovať tagy a tvoja stránka bude zobrazená nesprávne.
 
 ## Uprav svoju šablónu
 
-Môžeš sa trocha pohrať s tým, že budeš upravovať svoju šablónu! Tu je pár užitočných tagov:
+Môžeš sa trocha pohrať s tým, že budeš upravovať svoju šablónu! Tu je zopár užitočných tagov:
 
-*   `<h1>Hlavný nádpis</h1>` - pre tvoj najdôležitejší nádpis
-*   `<h2>Podnádpis</h2>` pre nádpis na nižšej úrovni
-*   `<h3>Pod-podnádpis</h3>`.. a tak ďalej až do `<h6>`
-*   `<em>text</em>` zdôrazňuje tvoj text
-*   `<strong>text</strong>` zvýrazňuje tvoj text o čosi viac
-*   `<br />` vkladá nový riadok (do br nemôžeš nič vložiť)
-*   `<a href="https://djangogirls.org">link</a>` vytvára odkaz
-*   `<ul><li>prvá položka</li><li>druhá položka</li></ul>` vytvára zoznam ako tento!
-*   `<div></div>` definuje sekciu stránky
+* `<h1>Hlavný nádpis</h1>` - pre tvoj najdôležitejší nádpis
+* `<h2>Podnádpis</h2>` pre nádpis na nižšej úrovni
+* `<h3>Pod-podnádpis</h3>`.. a tak ďalej až do `<h6>`
+* `<p>Odsek textu</p>`
+* `<em>text</em>` zdôrazňuje tvoj text
+* `<strong>text</strong>` zvýrazňuje tvoj text o čosi viac
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` vytvára odkaz
+* `<ul><li>prvá položka</li><li>druhá položka</li></ul>` vytvára zoznam ako tento!
+* `<div></div>` definuje sekciu stránky
 
-Tu je príklad celej šablóny:
+Tu je príklad úplnej šablóny, skopíruj ho do súboru `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -119,18 +119,18 @@ Tu je príklad celej šablóny:
     </head>
     <body>
         <div>
-            <h1><a href="">Django Girls Blog</a></h1>
+            <h1><a href="/">Django Girls Blog</a></h1>
         </div>
 
         <div>
             <p>published: 14.06.2014, 12:14</p>
-            <h2><a href="">Môj prvý príspevok</a></h2>
+            <h2><a href="">My first post</a></h2>
             <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
         </div>
 
         <div>
             <p>published: 14.06.2014, 12:14</p>
-            <h2><a href="">Môj druhý príspevok</a></h2>
+            <h2><a href="">My second post</a></h2>
             <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
         </div>
     </body>
@@ -139,18 +139,16 @@ Tu je príklad celej šablóny:
 
 Vytvorili sme tri `div` sekcie.
 
-*   Prvá `div` sekcia obsahuje titulok nášho blogu - je to nádpis a odkaz
-*   Ďalšie dva `div` elementy obsahujú príspevky blogu s časom publikovania, `h2` s nádpisom príspevku, na ktorý sa dá kliknúť a dva `p` (odstavce) textu, jeden pre dátum a druhý pre náš príspevok.
-
-Dá nám to tento efekt:
+* Prvá `div` sekcia obsahuje titulok nášho blogu - je to nádpis a odkaz
+* Ďalšie dva `div` elementy obsahujú príspevky blogu s časom publikovania, `h2` nádpisom príspevku, na ktorý sa dá kliknúť a dva `p` (odstavce) textu, jeden pre dátum a druhý pre náš príspevok.
 
-![Obrázok 11.4][4]
+Výsledok je nasledovný:
 
- [4]: images/step6.png
+![Obrázok 11.4](images/step6.png)
 
 Jupí! Ale zatiaľ naša šablóna zobrazila len presne **rovnaké informácie** - kým pred chvíľou sme hovorili, že nám šablóny dovoľujú zobrazovať **rozdielne** informácie v **rovnakom formáte**.
 
-To čo v skutočnosti chceme spraviť je zobraziť reálne príspevky v našom Django admin rozhraní - a to je to, čo teraz spravíme.
+To čo v skutočnosti chceme spraviť je zobraziť reálne príspevky pridané v Django admin rozhraní - a to je to, čo teraz spravíme.
 
 ## Ešte jedna vec: nasaďte to!
 
@@ -160,57 +158,56 @@ Bolo by skvelé, ak by sme všetky tieto veci mohli vidieť naživo na Internete
 
 Najprv sa pozrime, ktoré súbory sa zmenili od posledného nasadenia (tieto príkazy spusti lokálne, nie na PythonAnywhere):
 
-```
-$ git status
-```
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
 
 Uisti sa, že si v zložke `djangogirls` a následne povedzme `gitu` nech zahrnie všetky zmeny v zložke:
 
-```
-$ git add -A .
-```
+{% filename %}command-line{% endfilename %}
 
-> **Poznámka** - `-A` (skratka pre "all" (všetko)) znamená, že `git` rozozná, ak si vymazala súbory (štandardne rozoznáva len nové/modifikované súbory). Pamätaj si tiež (bolo to v kapitole 3), že `.` znamená aktuálny adresár.
+    $ git add --all .
+    
 
-Predtým, ako nahrajeme všetky súbory, skontrolujme čo bude `git` nahrávať (všetky súbory, ktoré `git` nahraje by teraz mali byť zelené):
+> **Poznámka** - `--all` znamená, že `git` rozozná, ak si vymazala súbory (štandardne rozoznáva len nové/modifikované súbory). Spomeň si tiež (bolo to v kapitole 3), že `.` znamená aktuálny adresár.
 
-```
-$ git status
-```
+Predtým, ako nahráme všetky súbory, skontrolujme čo bude `git` nahrávať (všetky súbory, ktoré `git` nahrá by teraz mali byť zelené):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
 
 Už sme skoro tam, teraz nastal čas mu povedať, aby uložil tieto zmeny v jeho histórii. Dáme mu "commit správu", kde popíšeme, čo sme zmenili. V tomto štádiu môžeš napísať čokoľvek, čo chceš, ale je nápomocné napísať čosi, čo je popisné natoľko, že si budeš v budúcnosti pamätať, čo si spravila.
 
-```
-$ git commit -m "Zmeny v HTML pre stránku."
-```
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Zmeny v HTML pre stránku."
+    
 
 > **Poznámka** - Uisti sa, že si použila dvojité úvodzovky okolo commit správy.
 
-Po tom, čo sme to dokončili, nahrajeme (push) naše zmeny na Github:
+Po tom, čo sme to dokončili, nahráme (push) naše zmeny na Github:
 
-```
-git push
-```
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
 
 ### Stiahni svoj kód na PythonAnywhere a obnov svoju webovú aplikáciu
 
-*   Otvor [konzolovú stránku PythonAnywhere][5] a prejdi do svojej **Bash konzole** (alebo naštartuj novú). Potom zadaj:
+* Otvor [konzolovú stránku PythonAnywhere](https://www.pythonanywhere.com/consoles/) a prejdi do svojej **Bash konzoly** (alebo naštartuj novú). Potom zadaj:
 
- [5]: https://www.pythonanywhere.com/consoles/
+{% filename %}command-line{% endfilename %}
 
-```
-$ cd ~/my-first-blog
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
 
 A sleduj ako sa tvoj kód sťahuje. Pokiaľ chceš skontrolovať, že dorazil, môžeš skočiť do **záložky Files** a pozrieť sa na svoj kód na PythonAnywhere.
 
-*   Nakoniec skoč do [záložky Web][6] a stlač **Reload** na tvojej webovej aplikácii.
-
- [6]: https://www.pythonanywhere.com/web_app_setup/
+* Nakoniec skoč do [záložky Web](https://www.pythonanywhere.com/web_app_setup/) a stlač **Reload** na tvojej webovej aplikácii.
 
-Tvoj update by mal byť dokončený a funkčný! Obnov svoju stránku v prehliadači. Zmeny by mali byť viditeľné :)
+Aktualizácia by mala prebehnuť a zmeny by mali byť dostupne v živej verzii! Obnov svoju stránku v prehliadači. Zmeny by mali byť viditeľné. :)
\ No newline at end of file
diff --git a/sk/install_git.md b/sk/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/sk/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sk/installation/README.md b/sk/installation/README.md
index dfd190ddb3a..d220cf57051 100755
--- a/sk/installation/README.md
+++ b/sk/installation/README.md
@@ -1,16 +1,21 @@
 # Pokiaľ robíš tutoriál doma
 
-Pokiaľ robíš tento tutoriál doma, nie na jednej z [Django Girls akcií](https://djangogirls.org/events/), môžeš úplne preskočiť túto kapitolu a pokračovať rovno s kapitolou [Ako funguje Internet](../how_the_internet_works/README.md).
+Pokiaľ robíš tento tutoriál doma, nie na jednej z [Django Girls akcií](https://djangogirls.org/events/), môžeš úplne preskočiť túto kapitolu a pokračovať rovno na kapitolu [Ako funguje Internet](../how_the_internet_works/README.md).
 
-Je to preto, že tieto veci pokryjeme v celom tutoriále a toto je len dodatočná stránka, ktorá zjednocuje všetky inštalačné inštrukcie na jednom mieste. Django Girls akcie obsahujú "Inštalačné večery", kde nainštalujeme všetko, aby sme sa s tým nemuseli trápiť počas workshopu, takže táto stránka je pre nás užitočná.
+Je to preto, že tieto veci spomenieme počas tutoriálu a toto je len dodatočná stránka, ktorá zjednocuje všetky inštalačné inštrukcie na jednom mieste. Django Girls akcie obsahujú "Inštalačné večery", kde nainštalujeme všetko, aby sme sa s tým nemuseli trápiť počas workshopu, takže táto stránka je pre nás užitočná.
 
-Pokiaľ ti táto kapitola príde užitočná, môžeš si ju celú prejsť. Ale pokiaľ sa chceš začať učiť veci predtým, ako si nainštalujete množstvo vecí na svoj počítač, preskoč túto kapitolu a my ti vysvetlíme inštalačnú časť neskôr.
+If you find it useful, you can follow this chapter too. Ale pokiaľ sa chceš začať učiť predtým, ako si nainštaluješ množstvo vecí na svoj počítač, preskoč túto kapitolu a my ti vysvetlíme inštalačnú časť neskôr.
 
 Veľa šťastia!
 
 # Inštalácia
 
-Počas workshopu budeš vytvárať blog a v tutoriále je pár nastavení, ktoré by bolo dobré prejsť predtým, aby si bola pripravení začať programovať.
+Počas workshopu budeš vytvárať blog a v tutoriále je pár nastavení, ktoré by bolo dobré prejsť predtým, aby si bola pripravená začať programovať.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
 
 # Inštalácia Pythonu
 
@@ -36,14 +41,18 @@ Choď na [GitHub.com](https://www.github.com) a založ (Sign Up) si nový účet
 
 {% include "/deploy/signup_pythonanywhere.md" %}
 
-# Začni čítať
+# Začni si čítať
 
 Gratulujeme, si pripravená začať! Pokiaľ máš stále zvyšný čas pred začiatkom workshopu, bolo by užitočné, ak by si si prečítala pár začiatočníckych kapitol:
 
-  * [Ako funguje Internet](../how_the_internet_works/README.md)
+* [Ako funguje Internet](../how_the_internet_works/README.md)
+
+* [Úvod do príkazového riadku](../intro_to_command_line/README.md)
+
+* [Úvod do jazyka Python](../python_introduction/README.md)
 
-  * [Úvod do príkazového riadku](../intro_to_command_line/README.md)
+* [Čo je Django?](../django/README.md)
 
-  * [Úvod do jazyka Python](../python_introduction/README.md)
+# Uži si workshop!
 
-  * [Čo je Django?](../django/README.md)
+Keď začne workshop, budeš môcť prejsť priamo na [Tvoj prvý Django projekt!](../django_start_project/README.md), lebo si už absolvovala látku v predchádzajucích kapitol.
\ No newline at end of file
diff --git a/sk/instructions.md b/sk/instructions.md
new file mode 100644
index 00000000000..07c6fdd4182
--- /dev/null
+++ b/sk/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period. It's easy to install and use, and it's available for all operating systems.
+
+[Stiahni si ho odtiaľto](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source, easy to install and easy to use. It's available for Windows, OS X and Linux.
+
+[Stiahni si ho odtiaľto](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/sk/intro_to_command_line/README.md b/sk/intro_to_command_line/README.md
index 704842c5210..7f1c414e4cd 100755
--- a/sk/intro_to_command_line/README.md
+++ b/sk/intro_to_command_line/README.md
@@ -1,6 +1,8 @@
 # Úvod do rozhrania príkazového riadku
 
-Hm, je to vzrušujúce, však? Už o pár minút napíšeš svoj prvý riadok kódu :)
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) videu.
+
+Je to vzrušujúce, však? Už o pár minút napíšeš svoj prvý riadok kódu! :)
 
 **Dovoľ nám predstaviť ti tvojho nového priateľa: príkazový riadok!**
 
@@ -10,66 +12,97 @@ Nasledujúce kroky ti ukážu ako používať tú čiernu obrzovku, čo použív
 
 ## Čo je to príkazový riadok?
 
-Okno, ktoré sa zvyčajne nazýva **príkazový riadok** alebo **rozhranie príkazového riadku** je textová aplikácia na prehliadanie, spracovanie a manipuláciu so súbormi v tvojom počítači. V podstate ako Prieskumník vo Windowse alebo Finder na Macu, akurát bez grafického rozhrania. Ďalšie názvy pre príkazový riadok môžu byť: *cmd*, *CLI*, *prompt*, *konzola* alebo *terminál*.
+Okno, ktoré sa zvyčajne nazýva **príkazový riadok** alebo **rozhranie príkazového riadku** je textová aplikácia na prehliadanie, spracovanie a manipuláciu so súbormi v tvojom počítači. V podstate je to ako Prieskumník vo Windowse alebo Finder na Macu, akurát bez grafického rozhrania. Ďalšie názvy pre príkazový riadok môžu byť: *cmd*, *CLI*, *prompt*, *konzola* alebo *terminál*.
 
 ## Otvor rozhranie príkazového riadku
 
 Aby sme mohli trochu experimentovať, musíme najskôr rozhranie príkazového riadku otvoriť.
 
-### Windows
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Prejdite na Štart menu → Systém Windows → Príkazový riadok.
+
+> V starších verziách systému Windows, pozrite v Štart menu → Všetky programy → Príslušenstvo → Príkazový riadok.
 
-Choď na menu Štart → Všetky programy → Príslušenstvo → Príkazový riadok.
+<!--endsec-->
 
-### Mac OS X
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
 
-Aplikácie → Nástroje → Terminál.
+Choď do Aplikácie → Nástroje → Terminál.
 
-### Linux
+<!--endsec-->
 
-Pravdepodobne to nájdeš pod Aplikácie → Príslušenstvo → Terminál, ale to závisí na tvojom systéme. Ak to tam nie je, tak si to jednoducho vygoogli :)
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Pravdepodobne ho nájdeš pod Aplikácie → Príslušenstvo → Terminál, ale to závisí na tvojom systéme. Ak to tam nie je, tak si to jednoducho vygoogli. :)
+
+<!--endsec-->
 
 ## Príkazový riadok
 
 Teraz by si už mala vidieť biele alebo čierne okno, ktoré čaká na tvoje príkazy.
 
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
 Ak si na Macu alebo Linuxe, zrejme uvidíš `$`, presne takto:
 
-```
-$
-```
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Na Windowse je to znak `>`, takýto:
+
+{% filename %}command-line{% endfilename %}
 
-Na Windowse to je znak `>`, takýto:
+    >
+    
 
-```
->
-```
+<!--endsec-->
 
-Každý príkaz budeš zadávať za tento znak a jednu medzeru. Ty to ale písať nemusíš, urobí to za teba tvoj počítač :)
+Každý príkaz budeš zadávať za tento znak a jednu medzeru. Ty to ale písať nemusíš, urobí to za teba tvoj počítač. :)
 
-> Len malá poznámka: v tvojom prípade môže byť pred znakom $ niečo ako `C:\Users\ola>` alebo `Olas-MacBook-Air:~ ola$` a to je úplne v poriadku. V tomto tutoriale to ale zjednodušíme na úplné minimum.
+> Len krátka poznámka: v tvojom prípade môže tam byť pred niečo ako `C:\Users\ola>` alebo `Olas-MacBook-Air:~ ola$` a to je úplne v poriadku.
+
+Časť po a vrátane `$` alebo `>` sa nazýva *príkazový riadok*, alebo *prompt* skrátene. Je to miesto kde zadávaš príkazy.
+
+V tutoriále, keď chceme, aby si zadala príkaz, použijeme `$` alebo `>`, a občas aj väčšmej doľava. Môžeš ignorovať ľavú čast a zadaj príkaz, ktorý sa začína po prompte.
 
 ## Tvoj prvý príkaz (Hurá!)
 
-Začnime s niečím jednoduchým. Napíš tento príkaz:
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
 
-```
-$ whoami
-```
+<!--endsec-->
 
-alebo
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
 
-```
-> whoami
-```
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
 
 A stlač `enter`. Toto je výsledok:
 
-```
-$ whoami
-olasitarska
-```
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
 
-Ako vidíš, počítač práve vypísal tvoje užívateľské meno. Milé, nie?:)
+Ako vidíš, počítač práve vypísal tvoje užívateľské meno. Milé, nie? :)
 
 > Skús každý príkaz napísať, nielen kopírovať. Viac si tak zapamätáš!
 
@@ -81,48 +114,66 @@ Každý operačný systém má trochu iné príkazy pre príkazový riadok, tak
 
 Bolo by fajn vedieť, kde sa nachádzame, však? Zistime to. Napíš tento príkaz a stlač `enter`:
 
-```
-$ pwd
-/Users/olasitarska
-```
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
 
-Ak si vo Windowse:
+{% filename %}command-line{% endfilename %}
 
-```
-> cd
-C:\Users\olasitarska
-```
-
-Na svojom stroji pravdepodobne uvidíš niečo takéto. Keď otvoríš príkazový riadok, zvyčajne začneš vo svojom domovskom adresári.
+    $ pwd
+    /Users/olasitarska
+    
 
 > Poznámka: 'pwd' je skratka pre 'print working directory'.
 
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Poznámka: 'cd' znamená 'change directory', teda zmena priečinku. V powershell môžeš použiť pwd tak ako na Linuxe alebo Mac OS X.
+
+<!--endsec-->
+
+Na svojom stroji pravdepodobne uvidíš niečo takéto. Keď otvoríš príkazový riadok, zvyčajne začneš vo svojom domovskom adresári.
+
 * * *
 
 ### Zoznam súborov a adresárov
 
 Tak čo je v ňom? Bolo by super zistiť to. Pozrime sa na to:
 
-```
-$ ls
-Applications
-Desktop
-Downloads
-Music
-...
-```
-
-Windows:
-
-```
-> dir
- Directory of C:\Users\olasitarska
-05/08/2014 07:28 PM <DIR>      Applications
-05/08/2014 07:28 PM <DIR>      Desktop
-05/08/2014 07:28 PM <DIR>      Downloads
-05/08/2014 07:28 PM <DIR>      Music
-...
-```
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Poznámka: V powershelli môžeš použiť aj 'ls' ako na Linuxe alebo Mac OS X. <!--endsec-->
 
 * * *
 
@@ -130,33 +181,49 @@ Windows:
 
 Teraz prejdime do adresára Plochy:
 
-```
-$ cd Desktop
-```
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    > cd Desktop
+    
 
-```
-> cd Desktop
-```
+<!--endsec-->
 
 Skontroluj, či sa adresár skutočne zmenil:
 
-```
-$ pwd
-/Users/olasitarska/Desktop
-```
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
 
-Windows:
+{% filename %}command-line{% endfilename %}
 
-```
-> cd
-C:\Users\olasitarska\Desktop
-```
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
 
 A je to!
 
-> Profi tip: ak napíšeš `cd D` a potom stlačíš `tab`, príkazový riadok automaticky doplní zvyšok názvu, takže sa môžeš adresáre prechádzať rýchlejšie. Ak na "D" začína viac ako jeden adresár, stlač `tab` dvakrát a dostaneš zoznam možností.
+> Profi tip: ak napíšeš `cd D` a potom stlačíš `tab`, príkazový riadok automaticky doplní zvyšok názvu, takže adresáre môžeš prechádzať rýchlejšie. Ak na "D" začína viac ako jeden adresár, stlač `tab` dvakrát a dostaneš zoznam možností.
 
 * * *
 
@@ -164,17 +231,25 @@ A je to!
 
 Čo takto vytvoriť pokusný adresár na ploche? Urobíš to takto:
 
-```
-$ mkdir pokus
-```
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ mkdir pokus
+    
 
-```
-> mkdir practice
-```
+<!--endsec-->
 
-Tento príkazík vytvorí adresár s názvom `pokus` na tvojej ploche. Či je adresár naozaj tam môžeš zistiť jednoducho pohľadom na Plochu alebo spustením príkazu `ls` alebo `dir`! Vyskúšaj to :)
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+Tento príkazík vytvorí adresár s názvom `pokus` na tvojej ploche. Či je adresár naozaj tam môžeš zistiť jednoducho pohľadom na Plochu alebo spustením príkazu `ls` alebo `dir`! Vyskúšaj to. :)
 
 > Profi tip: ak sa ti nechce vypisovať stále dookola tie isté príkazy, skús sa stlačením `šípky hore` a `šípky dole` vrátiť k nedávno použitým príkazom.
 
@@ -182,25 +257,33 @@ Tento príkazík vytvorí adresár s názvom `pokus` na tvojej ploche. Či je ad
 
 ### Cvičenie!
 
-Malá výzva pre teba: v tvojom čerstvo vytvorenom adresári `pokus` vytvor adresár s názvom `test`. Použi príkazy `cd` a `mkdir`.
+Malá výzva pre teba: v čerstvo vytvorenom adresári `pokus` vytvor adresár s názvom `test`. (Použi príkazy `cd` a `mkdir`.)
 
 #### Riešenie:
 
-```
-$ cd pokus
-$ mkdir test
-$ ls
-test
-```
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ cd pokus
+    $ mkdir test
+    $ ls
+    test
+    
 
-```
-> cd pokus
-> mkdir test
-> dir
-03/20/2016 11:05 AM <DIR>      test
-```
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    03/20/2016 11:05 AM <DIR>      test
+    
+
+<!--endsec-->
 
 Gratulujeme! :)
 
@@ -212,74 +295,114 @@ Nechceme po sebe nechať neporiadok, takže odstránime všetko, čo sme doteraz
 
 Najkôr sa musíme vrátiť späť na Plochu:
 
-```
-$ cd ..
-```
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ cd ..
+    
 
-```
-> cd ..
-```
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
 
 Pomocou `..` s príkazom `cd` zmeníš svoj aktuálny adresár na rodičovský adresár (to je ten adresár, v ktorom sa nachádza tvoj aktuálny adresár).
 
 Skontroluj, kde sa nachádzaš:
 
-```
-$ pwd
-/Users/olasitarska/Desktop
-```
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ pwd
+    /Users/olasitarska/Desktop
+    
 
-```
-> cd
-C:\Users\olasitarska\Desktop
-```
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
 
 Je na čase zmazať adresár `pokus`:
 
-> **Pozor**: mazanie súborov pomocou `del` `rmdir` alebo `rm` je neodvolateľné, teda *odstránené súbory budú navždy preč*! Takže s týmito príkazmi buď opatrná.
+> **Pozor**: mazanie súborov pomocou `del` `rmdir` alebo `rm` je neodvolateľné, teda *odstránené súbory budú navždy odtranené*! Takže s týmito príkazmi buď opatrná.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
 
-```
-$ rm -r pokus
-```
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ rm -r pokus
+    
 
-```
-> rmdir /S pous
-pokus, Are you sure <Y/N>? Y
-```
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S pous
+    pokus, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
 
 Hotovo! Uistime sa, či je to naozaj vymazané:
 
-```
-$ ls
-```
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ ls
+    
 
-```
-> dir
-```
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
 
 ### Ukončenie
 
-Nateraz je to všetko! Môžeš pokojne zatvoriť príkazový riadok. Urobme to hackersky, dobre?:)
+Nateraz je to všetko! Môžeš pokojne zatvoriť príkazový riadok. Urobme to hackersky, dobre? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
 
-```
-$ exit
-```
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ exit
+    
 
-```
-> exit
-```
+<!--endsec-->
 
-Super, čo?:)
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Super, čo? :)
 
 ## Zhrnutie
 
@@ -287,20 +410,20 @@ Tu je prehľad niektorých užitočných príkazov:
 
 | Príkaz (Windows) | Príkaz (Mac OS / Linux) | Popis                           | Príklad                                           |
 | ---------------- | ----------------------- | ------------------------------- | ------------------------------------------------- |
-| exit             | exit                    | zatvorí okno                    | **exit**                                          |
+| ukončenie        | ukončenie               | zatvorí okno                    | **ukončenie**                                     |
 | cd               | cd                      | zmení adresár                   | **cd test**                                       |
+| cd               | pwd                     | ukáž akutuálny adresár          | **cd** (Windows) alebo **pwd** (Mac OS / Linux)   |
 | dir              | ls                      | vypíše zoznam adresárov/súborov | **dir**                                           |
 | copy             | cp                      | kopíruje súbor                  | **copy c:\test\test.txt c:\windows\test.txt** |
 | move             | mv                      | presunie súbor                  | **move c:\test\test.txt c:\windows\test.txt** |
 | mkdir            | mkdir                   | vytvorí nový adresár            | **mkdir testdirectory**                           |
-| del              | rm                      | odstráni adresár/súbor          | **del c:\test\test.txt**                        |
+| rmdir (or del)   | rm                      | vymazať súbor                   | **del c:\test\test.txt**                        |
+| rmdir /S         | rm -r                   | odstráni adresár/súbor          | **rm -r testdirectory**                           |
 
 Toto je len veľmi malá časť príkazov, ktoré môžeš spustiť vo svojom príkazovom riadku, ale dnes budeš potrebovať len tieto.
 
-Ak ťa to zaujalo, na [ss64.com][1] nájdeš kompletný prehľad príkazov pre všetky operačné systémy.
-
- [1]: http://ss64.com
+Ak ťa to zaujalo, na [ss64.com](http://ss64.com) nájdeš kompletný prehľad príkazov pre všetky operačné systémy.
 
 ## Pripravená?
 
-Vrhnime sa na Python!
+Vrhnime sa na Python!
\ No newline at end of file
diff --git a/sk/python_installation/README.md b/sk/python_installation/README.md
index ad2ee900d15..7a570bb516a 100755
--- a/sk/python_installation/README.md
+++ b/sk/python_installation/README.md
@@ -4,10 +4,12 @@ Konečne sme tu!
 
 Na začiatok si povedzme, čo je Python. Python je veľmi obľúbený programovací jazyk, ktorý možno využiť na vytváranie webstránok, hier, vedeckých programov, grafiky a veľa, veľa ďalšieho.
 
-Python vznikol koncom 80-tych rokov minulého storočia a jeho hlavným cieľom bola čitateľnosť pre ľudí (nie len pre stroje!). To je dôvod, prečo vyzerá oveľa jednoduchšie ako iné programovacie jazyky. Vďaka tomu je ľahké sa ho naučiť, ale nebojte sa, Python je tiež naozaj výkonný!
+Python vznikol koncom 80-tych rokov minulého storočia a jeho hlavným cieľom bola čitateľnosť pre ľudí (nie len pre stroje!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
 
 # Inštalácia Pythonu
 
+> **Poznámka:** Ak používate Chromebook, preskočte túto kapitolu a postupujte podľa pokynov na [nastavenie Chromebooku](../chromebook_setup/README.md).
+> 
 > **Poznámka** Ak si sa už cez kroky inštalácie prepracovala, nemusíš to robiť znova - môžeš preskočiť rovno na nasledujúcu kapitolu!
 
 {% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/sk/python_installation/instructions.md b/sk/python_installation/instructions.md
index f14b8bae1f3..bea7cb1be45 100755
--- a/sk/python_installation/instructions.md
+++ b/sk/python_installation/instructions.md
@@ -1,64 +1,106 @@
-> Táto časť je založená na príručke Geek Girls Carrots (http://django.carrots.pl/)
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) videu.
+> 
+> Táto časť je založená na príručke Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
 
-Django je napísané v Pythone. Python potrebujeme na všetko, čo chceme robiť v Djangu. Začnime teda s inštaláciou! Chceme, aby si si nainštalovala Python 3.4, takže ak máš staršiu verziu, budeš ju musieť upgradovať.
+Django je napísané v Pythone. Python potrebujeme aby sme urobili hocičo vv Djangu. Začnime tým, že si ho nainštalujeme. Chceme aby si si nainštalovala Python 3.6, takže ak máš staršiu verziu budeš si ju musieť aktualizovať.
 
-### Windows
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
 
-Python pre Windows si môžeš stiahnuť z webstránky https://www.python.org/downloads/release/python-343/. Po stiahnutí súboru ***.msi***, ho spusti (dvojklikom) a postupuj podľa inštrukcií. Je dôležité zapamätať si cestu (adresár), kde je nainštalovaný Python. Ešte to budeme potrebovať!
+Najprv si over, či tvoj počítač beží na 32-bitovej alebo 64-bitovej verzii Windows-u, stlačením Windows tlačidlo + Pause/Break tlačidlo, čo otvorí informácie o tvojom systéme. Pozri sa na riadok "Typ systému". Python pre Windows si môžeš stiahnuť z webstránky https://www.python.org/downloads/windows/. Klikni na "Latest Python 3 Release - Python x.x.x" link. Ak tvoj počítač beží na **64-bitovej** verzii Windows-u, stiahni si **Windows x86-64 executable installer**. Inak si stiahni **Windows x86 executable installer**. Po stiahnutí inštalačného súboru, spusti ho (dvojklikom) a postupuj podľa inštrukcií v ňom.
 
-Jedna vec, na ktorú si treba dať pozor: na druhej obrazovke sprievodcu inštaláciou, označenej ako "Prispôsobiť" (Customize), nezabudni prejsť dole a vybrať možnosť "Pridať python.exe do Cesty", takto:
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
 
-![Nezabudni pridať Python do Cesty](../python_installation/images/add_python_to_windows_path.png)
+![Nezabudni pridať Python do Cesty](../python_installation/images/python-installation-options.png)
 
-### Linux
+V ďalších krokoch, budeš používať Windows príkazový riadok (o ktorom ti tiež povieme viac). Zatiaľ, keď potrebuješ zadať nejake príkazy, choď do Štart → Systém Windows → Príkazový riadok. Alebo môžes stlačiť a držať tlačidlo so znakom Windows a k tomu stlačiť tlačidlo "R" kým sa neobjaví "Run" okno. Aby si spustila Príkazový riadok, zadaj "cmd" a stlač enter v "Run" okne. (No novších verziách Windows, možno budeš musieť vyhľadať "Command Prompt" ("Príkazový riadok"), lebo je niekedý skrytý.)
+
+![Zadaj "cmd" v "Run" okne](../python_installation/images/windows-plus-r.png)
+
+Poznámka: Ak používaš staršiu verziu systému Windows (7, Vista alebo ktorúkoľvek staršú verziu) a Python 3.6.x Inštalátor skončí s chybovou hláškou, môžeš skúsiť:
+
+1. nainštalovať všetky Windows aktualizácie a skúsiť nainštalovať Python 3.6 znovu; alebo
+2. nainštalovať [staršiu Python verziu](https://www.python.org/downloads/windows/), napr., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+Ak si nainštaluješ staršiu Python verziu, inštalačně okno môže vypadať inak ako je to zobrazené hore. Uisti sa, že označíš "Add python.exe to Path", následne klikni na tlačidlo vľavo a zvoľ "Will be installed on local hard drive" ("Bude nainštalované na lokálny pevný disk"):
+
+![Pridaj Python do Path, staršie verzie](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Poznámka:** Pred inštaláciou Python na OS X, mala by si povoliť v nastaveniach svojho Mac-u inštaláciu balíkov, ktoré nie sú z App Store. Choď do System Preferences (je to v priečinku Applications), klikni na "Security & Privacy," a potom na tab "General". Ak nastavenie: "Allow apps downloaded from:" je nastavené na "Mac App Store," zmeň ho na "Mac App Store and identified developers."
+
+Inštalačný program Pythonu si môžeš stiahnuť zo stránky https://www.python.org/downloads/release/python-361/:
+
+* Stiahni si súbor s *Mac OS X 64/32-bitovým inštalátorom*,
+* Dvojklikom na *python-3.6.1-macosx10.6.pkg* spusti inštalačný program.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
 
 Je veľmi pravdepodobné, že Python už máš predinštalovaný. Pre kontrolu, či je naozaj nainštalovaný (a ktorá verzia), spusti konzolu a napíš tento príkaz:
 
-```
-$ python3 -- version
-Python 3.4.3
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
 
-Ak nemáš Python nainštalovaný, alebo ak chceš inú verziu, môžeš ho nainštalovať takto:
+Ak máš inú mikro verziu Pythonu nainštalovanú, e.g. 3.6.0, nemusíš ju aktualizovať. Ak nemáš Python nainštalovaný, alebo ak chceš inú verziu, môžeš ho nainštalovať takto:
 
-#### Debian alebo Ubuntu
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
 
 Zadaj do konzoly tento príkaz:
 
-```
-$ sudo apt-get install python3.4
-```
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
 
-#### Fedora
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
 
 Použi v konzole tento príkaz:
 
-```
-$ sudo dnf instal python3.4
-```
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
 
-#### openSUSE
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
 
 Použi v konzole tento príkaz:
 
-```
-$ sudo zypper install python3
-```
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
 
-### OS X
+<!--endsec-->
 
-Inštalačný program Pythonu si môžeš stiahnuť zo stránky https://www.python.org/downloads/release/python-343/:
+Ak si chceš overiť, že inštalácia bola úspešná, otvor príkazový riadok a spusti príkaz `python3`:
 
-  * Stiahni si súbor s *Mac OS X 64/32-bitovým inštalátorom*,
-  * Dvojklikom na *python-3.4.3-macosx10.6.pkg* spusti inštalačný program.
+{% filename %}command-line{% endfilename %}
 
-Ak si chceš overiť, že inštalácia bola úspešná, otvor aplikáciu *Terminal* a spusti príkaz `python3`:
+    $ python3 --version
+    Python 3.6.1
+    
 
-```
-$ python3 -- version
-Python 3.4.3
-```
+**POZNÁMKA:** Ak používaš Windows a objavý sa ti chybová hláška, že `python3` nebol najdený, skús použiť `python` (bez čísla `3`) a over či to náhodou nie je Python 3.6 verzia.
 
 * * *
 
-V prípade nejakých pochybností, alebo ak sa niečo pokazilo a nemáš tušenie, čo robiť ďalej - opýtaj sa svojho trénera! Niekedy veci nejdú úplne hladko a je lepšie požiadať o pomoc niekoho, kto má viac skúseností.
+V prípade nejakých pochybností, alebo ak sa niečo pokazilo a nemáš tušenie, čo robiť ďalej - opýtaj sa svojho trénera! Niekedy veci nejdú úplne hladko a je lepšie požiadať o pomoc niekoho, kto má viac skúseností.
\ No newline at end of file
diff --git a/sk/python_introduction/README.md b/sk/python_introduction/README.md
index 68c95dbd202..1273bb25969 100755
--- a/sk/python_introduction/README.md
+++ b/sk/python_introduction/README.md
@@ -1,23 +1,26 @@
 # Úvod do jazyka Python
 
-> Časť tejto kapitoly je založená na tutoriáli Geek Girls Carrots (http://django.carrots.pl/).
+> Časť tejto kapitoly je založená na tutoriáli Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 
 Poďme napísať nejaký kód!
 
 ## Python prompt
 
-Aby sme mohli začať s Pythonom, musíte otvoriť *príkazový riadok* (angl. command line) na svojom počítači. Už by ste mali vedieť ako sa to robí -- naučili ste sa to v jednom z predchádzajúcich kapitol.
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) videu.
+
+Aby sme mohli začať s Pythonom, musíte otvoriť *príkazový riadok* (angl. command line) na svojom počítači. Už by ste mali vedieť ako sa to robí -- naučili ste sa to v [ Úvode do príkazového riadku](../intro_to_command_line/README.md).
 
 Ak ste hotoví, pokračujte s inštrukciami nižšie.
 
 Chceme otvoriť Python konzolu, takže napíšte `python` na Windowse alebo `python3` na Mac alebo OS/Linux a stlačte `enter`.
 
-```
-$ python3
-Python 3.4.3 (...)
-Type "help", "copyright", "credits" or "license" for more information.
->>>
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
 
 ## Váš prvý príkaz v Pythone!
 
@@ -25,25 +28,40 @@ Po spustení príkazu Python sa prompt zmenil na `>>>`. Pre nás to znamená že
 
 Ak by ste chceli kedykoľvek ukončiť konzolu Pythonu, len napíšte `exit()` alebo môžete použiť aj skratku `Ctrl + Z` vo Windowse alebo `Ctrl + D` pre Mac/Linux. Potom už nebudete vidieť toto: `>>>`.
 
-Ale teraz ešte vôbec nechceme ukončiť konzolu Python. Chceme sa o ňom naučiť viac. Začínajme s niečím jednoduchým. Napríklad skúste napísať nejaký matematický výraz, ako `2 + 3` a stlačte `enter`.
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> 2 + 3
 5
 ```
 
-Super! Vidíte ako vyskočilo riešenie? Python vie počítať! Môžete skúsiť aj ďalšie príkazy, ako: - `4 * 5` - `5 - 1` - `40 / 2`
+Super! Vidíte ako vyskočilo riešenie? Python vie počítať! Môžete skúsiť aj ďalšie príkazy, ako:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
 
-Bavte sa s tým trošku, potom sa vráťte späť k nám :).
+Aby sme vypočítali mocninu, povedzme 2 na tretiu, zadáme: {% filename %}command-line{% endfilename %}
 
-Ako vidíte, Python je dobrá kalkulačka. A ak ste zvedaví, čo všetko vie ešte...
+```python
+>>> 2 ** 3
+8
+```
+
+Bavte sa s tým trošku, potom sa vráťte späť k nám. :)
+
+Ako vidíte, Python je dobrá kalkulačka. A ak ste zvedaví, čo všetko vie ešte…
 
 ## Reťazce
 
 Čo tak vaše meno? Napíšte svoje meno v úvodzovkách:
 
-```
->>> "Ola"
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" 
 "Ola"
 ```
 
@@ -51,15 +69,19 @@ Práve ste vytvorili svoj prvý reťazec! Je postupnosť znakov, ktoré môžu b
 
 Reťazce možno spájať dohromady. Skús toto:
 
-```
->>> "Ahoj" + "Ola"
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ahoj" + "Ola" 
 'Ahoj Ola'
 ```
 
 Reťazce môžete násobiť aj s číslom:
 
-```
->>> "Ola" * 3
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3 
 'OlaOlaOla'
 ```
 
@@ -67,31 +89,39 @@ Ak potrebujete dať apostrof do vnútra reťazca, máte dva spôsoby, ako to uro
 
 Použitím dvojitých úvodzoviek:
 
-```
->>> "Runnin' down the hill"
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill" 
 "Runnin' down the hill"
 ```
 
 alebo pomocou spätného lomítka - tento znak (ak je napísaný pred úvodzovkou) povie, že ona je súčasťou reťazca a nie koniec / začiatok reťazca (``):
 
-```
->>> 'Runnin\' down the hill'
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill' 
 "Runnin' down the hill"
 ```
 
 Pekné, hm? Ak chcete vidieť svoje meno veľkými písmenami, jednoducho zadajte:
 
-```
->>> "Ola".upper()
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper() 
 'OLA'
 ```
 
-Práve ste použili `upper` **funkciu** na svoj reťazec! Funkcia (ako `upper()`) je postupnosť inštrukcií, ktoré Python vykonáva na danom objekte (`"Ola"`), potom, čo ju zavoláte.
+Práve si použila `upper` **metódu** na reťazci! Metóda (ako `upper()`) je postupnosť inštrukcií, ktoré Python vykonáva na danom objekte (`"Ola"`), potom, čo ju zavoláš.
 
-Ak chcete poznať počet písmen, ktoré sú obsiahnuté vo vašom mene, tak na to má Python funkciu tiež!
+Ak chcete poznať počet písmen, ktoré sú obsiahnuté vo vašom mene, tak na to má Python **funkciu** tiež!
 
-```
->>> len("Ola")
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola") 
 3
 ```
 
@@ -101,10 +131,10 @@ Ste zvedaví, prečo voláme niekedy funkciu s bodkou (`.`) na konci reťazca (a
 
 OK, dosť už reťazcoch. Zatiaľ ste sa naučili o:
 
-*   **prompt** - píšeme príkazy (kód) do Python promptu, z čoho dostaneme výsledky zase v jazyku Python
-*   **čísla a reťazce** - v Pythone sú čísla použité pre počítanie a reťazce pre textové objekty
-*   **operátory** - ako + alebo *, z daných hodnôt vyrobia novú hodnotu (číslo či reťazec...)
-*   **funkcie** - napr. upper() alebo len(), vykonávajú činnosti na objektoch.
+- **prompt** - píšeme príkazy (kód) do Python promptu, z čoho dostaneme výsledky zase v jazyku Python
+- **čísla a reťazce** - v Pythone sú čísla použité pre počítanie a reťazce pre textové objekty
+- **operátory** - ako `+` alebo `*`, z daných hodnôt vyrobia novú hodnotu
+- **funkcie** - napr. `upper()` alebo `len()`, vykonávajú činnosti na objektoch.
 
 Toto sú základy každého programovacieho jazyka. Ste pripravení na niečo ťažšie? Stavíme sa, že áno!
 
@@ -112,7 +142,9 @@ Toto sú základy každého programovacieho jazyka. Ste pripravení na niečo ť
 
 Teraz skúsme niečo nové. Je možné zistiť dĺžku nejakého čísla rovnako ako sme to robili s našim menom? Napíšte `len(304023)` a stlačte `enter`:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> len(304023)
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
@@ -121,15 +153,17 @@ TypeError: object of type 'int' has no len()
 
 Dostali sme našu prvú chybovú hlášku! Hovorí nám, že objekty typu "int" (celé čísla, angl. integers) nemajú dĺžku. Tak čo môžeme teraz robiť? Možno by sme mohli napísať naše číslo ako reťazec? Reťazce majú dĺžku, pravda?
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> len(str(304023))
 6
 ```
 
 Funguje to! Použili sme funkciu `str` vo vnútri funkcie `len`. Funkcia `str()` prevedie všetko na reťazce.
 
-*   Funkcia `str` prevedie (konvertuje) všetko na **reťazce** (angl. string)
-*   Funkcia `int` prevedie všetko na **int** (celé čísla)
+- Funkcia `str` prevedie (konvertuje) všetko na **reťazce** (angl. string)
+- Funkcia `int` prevedie všetko na **int** (celé čísla)
 
 > Dôležité: je možné konvertovať čísla na reťazce, ale opačne sa to nedá vždy - inak čo by bolo napr. `int('hello')`?
 
@@ -139,37 +173,47 @@ Veľmi dôležitý pojem v programovaní je pojem premennej. Premenná je nič i
 
 Povedzme, že chceme vytvoriť novú premennú s názvom `meno`:
 
-```
->>> name = "Ola"
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> meno = "Ola"
 ```
 
-Vidíte? Je to jednoduché: meno rovná sa Ola.
+We type name equals Ola.
 
 Ako ste si to zbadali už, váš program nič nevrátil späť ako to robil v predchádzajúcich príkladoch. Tak ako vieme, či tá premenná existuje? Jednoducho napíšte `meno` a stlačte `enter`:
 
-```
->>> name
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> meno
 'Ola'
 ```
 
-Hurá! Vaša prvá premenná :)! Vždy je možné zmeniť jej obsah:
+Hurá! Vaša prvá premenná! :) Vždy je možné zmeniť jej obsah:
 
-```
->>> name = "Sonja"
->>> name
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> meno = "Sonja"
+>>> meno
 'Sonja'
 ```
 
 Môžete ju použiť aj vo funkciách:
 
-```
->>> len(name)
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(meno)
 5
 ```
 
 Úžasné, že? Samozrejme premenné môžu byť hocičo, takže aj čísla! Skúste toto:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> a = 4
 >>> b = 6
 >>> a * b
@@ -178,7 +222,9 @@ Môžete ju použiť aj vo funkciách:
 
 Ale čo by sa stalo, keby sme použili zlý názov? Uhádnete, čo sa stane? Skúsme!
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> mesto = "Tokyo"
 >>> mseto
 Traceback (most recent call last):
@@ -194,7 +240,9 @@ Bavte sa s tým trošku, a potom uvidíme čo môžeme ešte urobiť!
 
 Vyskúšajte toto:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> meno = 'Maria'
 >>> meno
 'Maria'
@@ -208,37 +256,47 @@ Ako uvidíme neskôr, funkcia `print()` je tiež užitočná, keď chceme tlači
 
 ## Zoznamy
 
-Okrem reťazcov a celých čísel, má Python všetky možné typy objektov. Teraz sa zoznámime s typom, ktorý sa volá **zoznam** (list). Zoznamy sú presne to, čo si myslíte, že sú: objekty, ktoré sú zoznamami iných objektov :)
+Okrem reťazcov a celých čísel, má Python všetky možné typy objektov. Teraz sa zoznámime s typom, ktorý sa volá **zoznam** (list). Zoznamy sú presne to, čo si myslíte, že sú: objekty, ktoré sú zoznamami iných objektov. :)
 
 Poďme na to, vytvorte zoznam:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> []
 []
 ```
 
 Áno, tento zoznam je prázdny. Nie veľmi užitočné, však? Vytvorme zoznam s číslami lotérie. Nechceme sa dokola opakovať, takže ho hneď aj priradíme do premennej:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> loteria = [3, 42, 12, 19, 30, 59]
 ```
 
 OK, máme zoznam! Čo s ním môžeme urobiť? Pozrime sa, koľko čísel lotérie máme v zozname. Máte predstavu, ktorú funkciu by sme mohli použiť? Toto už predsa viete!
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> len(loteria)
 6
 ```
 
 Áno! `len()` vám vráti počet objektov v zozname. Šikovné, nie? Možno by sme to teraz mohli usporiadať:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> loteria.sort()
 ```
 
 Nič nám to nevrátilo, iba sa zmenilo poradie poradie, v ktorom sa čísla zobrazia v zozname. Vytlačme to znova a pozrime sa, čo sa stalo:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> print(loteria)
 [3, 12, 19, 30, 42, 59]
 ```
@@ -247,15 +305,19 @@ Ako vidíte, čísla vo vašom zozname sú teraz zoradené od najnižšej po naj
 
 Chceli by sme otočiť poradie? Urobme to!
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> loteria.reverse()
 >>> print(loteria)
 [59, 42, 30, 19, 12, 3]
 ```
 
-Jednoduché, však? Ak chcete pridať niečo do svojho zoznamu, môžete tak urobiť zadaním tohto príkazu:
+If you want to add something to your list, you can do this by typing this command:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> loteria.append(199)
 >>> print(loteria)
 [59, 42, 30, 19, 12, 3, 199]
@@ -263,7 +325,9 @@ Jednoduché, však? Ak chcete pridať niečo do svojho zoznamu, môžete tak uro
 
 Ak chcete zobraziť iba prvé číslo, môžete to urobiť pomocou **indexov**. Index je číslo, ktoré hovorí, kde v zozname sa položka nachádza. Programátori radi počítajú od nuly, takž eprvý objekt vo vašom zozname je na indexe 0, ďalší je na 1 a tak ďalej. Vyskúšajte toto:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> print(loteria[0])
 59
 >>> print(loteria[1])
@@ -272,15 +336,18 @@ Ak chcete zobraziť iba prvé číslo, môžete to urobiť pomocou **indexov**.
 
 Ako vidíte, k rôznym objektom vo vašom zozname môžete pristupovať použitím názvu zoznamu a indexom objektu v hranatých zátvorkách.
 
-Aby ste odstránili niečo zo svojho zoznamu, budete potrebovať **indexy**, ako sme sa dozvedeli vyššie a príkaz **del** (del je skratka pre odstránenie, angl. delete). Vyskúšajme to na príklade a zopakujme si, čo sme sa už naučili; zmažeme prvé číslo v našom zozname.
+Aby ste odstránili niečo zo svojho zoznamu, budete potrebovať **indexy**, ako sme sa dozvedeli vyššie a príkaz `pop()`. Vyskúšajme to na príklade a zopakujme si, čo sme sa už naučili; zmažeme prvé číslo v našom zozname.
 
-```
->>> print(loteria)
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
 [59, 42, 30, 19, 12, 3, 199]
->>> print(loteria[0])
+>>> print(lottery[0])
 59
->>> del loteria[0]
->>> print(loteria)
+>>> lottery.pop(0)
+59
+>>> print(lottery)
 [42, 30, 19, 12, 3, 199]
 ```
 
@@ -292,9 +359,13 @@ Zoznam všetkých dostupných metód pre zoznamy v tejto kapitole dokumentácie
 
 ## Slovníky
 
-Slovník je podobný ako zoznam, ale k jeho hodnotám pristupujete vyhľadaním kľúča namiesto indexu. Kľúč môže byť akýkoľvek reťazec alebo číslo. Syntax na definovanie prázdneho slovníka je:
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) videu.
 
-```
+Slovník je podobný ako zoznam, ale k jeho hodnotám pristupujete vyhľadaním kľúča namiesto číselného indexu. Kľúč môže byť akýkoľvek reťazec alebo číslo. Syntax na definovanie prázdneho slovníka je:
+
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> {}
 {}
 ```
@@ -303,19 +374,23 @@ To znamená, že ste práve vytvorili prázdny slovník. Hurá!
 
 Teraz skúste napísať nasledujúci príkaz (skúste ale nahradiť hodnoty vlastnými údajmi):
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> ucastnicka = {'meno': 'Ola', 'krajina': 'Slovensko', 'oblubene_cisla': [7, 42, 92]}
 ```
 
 Týmto príkazom ste práve vytvorili premennú s názvom `ucastnicka` s tromi pármi kľúč-hodnota:
 
-*   Kľúč `meno` odkazuje na hodnotu `"Ola"` (objekt typu `reťazec/string`),
-*   `krajina` odkazuje na `"Slovensko"` (ďalší `reťazec`),
-*   a `oblubene_cisla` smeruje na `[7, 42, 92]` (`zoznam` s tromi číslami).
+- Kľúč `meno` odkazuje na hodnotu `"Ola"` (objekt typu `reťazec/string`),
+- `krajina` odkazuje na `"Slovensko"` (ďalší `reťazec`),
+- a `oblubene_cisla` smeruje na `[7, 42, 92]` (`zoznam` s tromi číslami).
 
 Obsah jednotlivých kľúčov môžete skontrolovať touto syntaxou:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> print(ucastnicka['meno'])
 Ola
 ```
@@ -324,7 +399,9 @@ Ako vidíte, podobá sa to na zoznam. Ale nemusíte si pamätať index - stačí
 
 Čo sa stane ak si od Pythonu vypýtame hodnotu kľúča, ktorý neexistuje? Uhádnete? Vyskúšajme to a uvidíme!
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> ucastnicka['vek']
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
@@ -335,37 +412,46 @@ Aha, ďalšia chyba! Táto sa volá **KeyError** (chyba kľúča). Python je ná
 
 Kedy by používať slovník alebo zoznam? No, to je dobrá otázka. Porozmýšľaj predtým, ako si pozrieš odpoveď v nasledujúcom riadku.
 
-*   Potrebuješ zoradenú postupnosť položiek? Vyber si zoznam (list).
-*   Potrebuješ priraďovať hodnoty kľúčovým slovám, aby si si ich mohla efektívne (podľa kľúča) neskôr vyhľadať? Použi slovník (dictionary).
+- Potrebuješ zoradenú postupnosť položiek? Vyber si zoznam (list).
+- Potrebuješ priraďovať hodnoty kľúčovým slovám, aby si si ich mohla efektívne (podľa kľúča) neskôr vyhľadať? Použi slovník (dictionary).
 
 Slovníky, rovnako ako zoznamy sú *premenlivé*, čo znamená, že ich môžeme zmeniť po ich vytvorení. Po vytvorení môžeš do slovníka pridať nové dvojice kľúč/hodnota takto:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> ucastnicka['oblubeny_jazyk'] = 'Python'
 ```
 
 Tak ako pri zoznamoch, použitím metódy `len()` na slovníkoch dostaneš počet párov kľúč-hodnota v slovníku. Poďme na to, zadaj tento príkaz:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> len(ucastnicka)
 4
 ```
 
 Dúfam, že to dáva zmysel. :) Pripravená na trochu zábavy so slovníkmi? Tak šup na ďalší riadok za úžasnými vecami.
 
-Na odstránenie položky zo slovníka môžeš použiť príkaz `del`. Napríklad ak chceš odstrániť položku zodpovedajúcu kľúču `'oblubene_cisla'`, zadaj nasledujúci príkaz:
+Na odstránenie položky zo slovníka môžeš použiť metódu `pop()`. Napríklad ak chceš odstrániť položku zodpovedajúcu kľúču `'oblubene_cisla'`, zadaj nasledujúci príkaz:
 
-```
->>> del ucastnicka['oblubene_cisla']
->>> ucastnicka
-{'krajina': 'Slovensko', 'oblubeny_jazyk': 'Python', 'meno': 'Ola'}
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
 ```
 
 Ako vidíš z výstupu, pár kľúč-hodnota zodpovedajúci kľúču 'oblubene_cisla' bol vymazaný.
 
 Taktiež môžeš zmeniť hodnotu priradenú k už vytvorenému kľúču v slovníku. Napíš:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> ucastnicka['krajina'] = 'Nemecko'
 >>> ucastnicka
 {'krajina': 'Nemecko', 'oblubeny_jazyk': 'Python', 'meno': 'Ola'}
@@ -377,18 +463,22 @@ Ako vidíš, hodnota kľúča `"krajina"` sa zmenila z `"Poľsko"` na `"Nemecko"
 
 Skvelé! Teraz už vieš o programovaní dosť veľa. Pozrime sa, čo sme si vysvetlili v poslednej časti:
 
-*   **chyby** (angl. error) - teraz už vieš ako čítať a rozumieť chybám, ktoré sa zobrazia, ak Python nerozumie príkazu, ktorý mu zadáš
-*   **premenné** - názvy objektov, ktoré ti uľahčujú písanie kódu a robia tiež kód zrozumiteľnejším
-*   **zoznamy** (angl. list) - zoznam objektov uložených v určitom poradí
-*   **slovníky** (angl. dictionary) - objekty uložené v pároch kľúč-hodnota
+- **chyby** (angl. error) - teraz už vieš ako čítať a rozumieť chybám, ktoré sa zobrazia, ak Python nerozumie príkazu, ktorý mu zadáš
+- **premenné** - názvy objektov, ktoré ti uľahčujú písanie kódu a robia tiež kód zrozumiteľnejším
+- **zoznamy** (angl. list) - zoznam objektov uložených v určitom poradí
+- **slovníky** (angl. dictionary) - objekty uložené v pároch kľúč-hodnota
 
 Tešíš sa na ďalšiu časť? :)
 
 ## Porovnávanie vecí
 
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) videu.
+
 Veľkú časť programovania predstavuje porovnávanie veci. Čo je najjednoduchšia vec na porovnanie? Čísla, samozrejme. Pozrime sa, ako to funguje:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> 5 > 2
 True
 >>> 3 < 1
@@ -407,23 +497,27 @@ Zaujíma ťa, prečo sme použili dve "rovná sa" `==` vedľa seba, aby sme poro
 
 Zadaj Pythonu ešte dve úlohy:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> 6 >= 12 / 2
 True
 >>> 3 <= 2
 False
 ```
 
-`>` a `<` sú jasné, ale čo znamenajú `>=` a `<=`? Prečítať ich môžeš takto:
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
 
-*   x `>` y znamená: x je väčšie ako y
-*   x `<` y znamená: x je menšie ako y
-*   x `<=` y znamená: x je menšie alebo sa rovná y
-*   x `> =` y znamená: x je väčšie alebo sa rovná y
+- x `>` y znamená: x je väčšie ako y
+- x `<` y znamená: x je menšie ako y
+- x `<=` y znamená: x je menšie alebo sa rovná y
+- x `> =` y znamená: x je väčšie alebo sa rovná y
 
 Skvelé! Chceš vyskúšať ešte jeden? Skús toto:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> 6 > 2 and 2 < 3
 True
 >>> 3 > 2 and 2 < 1
@@ -434,31 +528,38 @@ True
 
 Môžeš dať Pythonu toľko čísel, koľko chceš a on ti dá vždy odpoveď! Vcelku šikovné, nie?
 
-*   **and** - ak použiješ operátor `and`, obidve porovnávané veci musia byť pravdivé (True), aby príkaz bol pravda (True)
-*   **or** - ak použiješ operátor `or`, stačí aby jedna z porovnávaných vecí bola pravdivá, aby bol celý príkaz pravda (True)
+- **and** - ak použiješ operátor `and`, obidve porovnávané veci musia byť pravdivé (True), aby príkaz bol pravdivý (True)
+- **or** - ak použiješ operátor `or`, stačí aby jedna z porovnávaných vecí bola pravdivá, aby bol celý príkaz pravda (True)
 
 Už ste počula výraz "porovnávať hrušky s jablkami"? Skúsme pythonský ekvivalent:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> 1 > 'django'
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
-TypeError: unorderable types: int() > str()
+TypeError: '>' not supported between instances of 'int' and 'str'
 ```
 
 Tu vidíš, že tak ako nevieme porovnávať hrušky s jablkami, ani Python neviem porovnať číslo (`int`) s reťazcom (`str`). Namiesto toho vypíše chybu **TypeError** a povie nám, ktoré dva typy sa nedajú porovnať.
 
 ## Logické hodnoty (Boolean)
 
-Práve si spoznala nový typ objektov v Pythone. Volá sa **logická hodnota** (po anglicky im hovoríme Boolean), pravdepodobne najjednoduchší typ, ktorý existuje.
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
 
-Existujú iba dva typy Booleovských objektov: - True (Pravda) - False (Nepravda)
+Existujú iba dva typy Booleovských objektov:- True (Pravda)- False (Nepravda):
+
+- True
+- False
 
 Aby ich Python spoznal, musíš vždy napísať 'True' (s veľkým písmenom na začiatku a zvyšok malým písmom). **true, TRUE, tRUE nebudú fungovať -- iba True je správne.** (Samozrejme, to isté platí aj pre 'False'.)
 
 Logické hodnoty môžu byť aj premenné. Aha:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> a = True
 >>> a
 True
@@ -466,7 +567,9 @@ True
 
 Môžeš to urobiť aj takto:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> a = 2 > 5
 >>> a
 False
@@ -474,132 +577,187 @@ False
 
 Precvič si to a zabav sa s logickými premennými - skús spustiť tieto príkazy:
 
-*   `True and True`
-*   `False and True`
-*   `True or 1 == 1`
-*   `1 != 2`
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
 
 Gratulujeme! Logické hodnoty patria k tomu najužitočnejšiemu z programovania a ty si sa práve naučila, ako sa používajú!
 
 # Ulož to!
 
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) videu.
+
 Zatiaľ sme písali všetok pythonský kód do konzoly interpretera, čiže môžeme na jedenkrát zadať iba jeden riadok kódu. Normálne programy sú uložené v súboroch, ktoré spúšťa buď **interpreter** alebo **kompilátor**. Doteraz sme spúšťali naše programy riadok po riadku v **interpreteri** Pythonu. Na ďalšie úlohy budeme potrebovať viac ako jeden riadok kódu, takže teraz rýchlo musíme:
 
-*   Ukončiť interpreter Pythonu
-*   Otvoriť si zvolený editor kódu
-*   Uložiť v ňom nejaký kód do nového pythonského súboru
-*   Spustiť ho!
+- Ukončiť interpreter Pythonu
+- Otvoriť si zvolený editor kódu
+- Uložiť v ňom nejaký kód do nového pythonského súboru
+- Spustiť ho!
 
-Pre opustenie interpretera Pythonu, ktorý sme doteraz používali, zadaj jednoducho funkciu ~~~ exit()~~~:
+Pre opustenie interpretera Pythonu, ktorý sme doteraz používali, zadaj jednoducho funkciu `exit()`
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 >>> exit()
 $
 ```
 
 Tak sa dostaneš späť na príkazový riadok.
 
-Už skôr si si vybrala editor kódu v kapitole [editor kódu][1]. Teraz ho potrebujeme otvoriť a napísať v ňom do nového súboru nejaký kód:
+Už skôr si si vybrala editor kódu v kapitole [editor kódu](../code_editor/README.md). Teraz ho potrebujeme otvoriť a napísať v ňom do nového súboru nejaký kód:
 
- [1]: ../code_editor/README.md
+{% filename %}editor{% endfilename %}
 
 ```python
 print('Hello, Django girls!')
 ```
 
-> **Poznámka** Všimni si jednu z najúžasnejších vecí editorov kódu: farby! V pythonskej konzole bolo všetko napísané jednou farbou, teraz však vidíš, že funkcia `print` je napísaná inou farbou ako reťazec. Toto sa nazýva "zvýraznenie syntaxe" a pri programovaní je to fakt užitočná vec. Farba výrazov ti môže pomôcť, ak máš neuzavretý reťazec či preklep v názve špeciálnych slov (ako napríklad `def` vo funkcii, ktorú uvidíme neskôr). Toto je jedným z dôvodov, prečo používame editor kódu :)
-
 Samozrejme, teraz si už vcelku skúsená Python developerka, takže kľudne napíš nejaký kód, ktorý si sa dnes naučila.
 
 Teraz uložíme súbor a dáme mu nejaký zrozumiteľný názov. Nazvime ho **python_intro.py** a ulož ho plochu. Tento súbor môžeš nazvať akokoľvek chceš, ale dôležité je, aby jeho názov končil **.py**. Prípona **.py** nášmu operačnému systému hovorí, že je to **súbor spustiteľný Pythonom** a môže ho spustiť Pythonom.
 
+> **Poznámka** Všimni si jednu z najúžasnejších vecí editorov kódu: farby! V pythonskej konzole bolo všetko napísané jednou farbou, teraz však vidíš, že funkcia `print` je napísaná inou farbou ako reťazec. Toto sa nazýva "zvýraznenie syntaxe" a pri programovaní je to fakt užitočná vec. Farba výrazov ti môže pomôcť, ak máš neuzavretý reťazec či preklep v názve špeciálnych slov (ako napríklad `def` vo funkcii, ktorú uvidíme neskôr). Toto je jedným z dôvodov, prečo používame editor kódu. :)
+
 Súbor máme uložený, je čas ho spustiť! Pomocou poznatkov z kapitoly o príkazovom riadku, pomocou Terminálu **zmeň adresár** na plochu.
 
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
 Na Macu bude príkaz vyzerať takto:
 
-```
-$ cd ~/Desktop
-```
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
 
 Na Linuxe to bude takto (slovo "Desktop" bude možno preložené):
 
-```
-$ cd ~/Desktop
-```
+{% filename %}command-line{% endfilename %}
 
-A vo Windowse bude príkaz vyzerať takto:
+    $ cd ~/Desktop
+    
 
-```
-> cd %HomePath%\Desktop
-```
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+Vo Windowse v Command Prompt, to bude takto:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+A vo Windows Powershell bude príkaz vyzerať takto:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
 
 Ak máš akékoľvek ťažkosti, stačí požiadať o pomoc.
 
 Teraz použi Python na spustenie kódu v súbore:
 
-```
-$ python3 python_intro.py
-Hello, Django girls!
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Poznámka na Windowse python3 príkaz neexistuje. Použi python na spustenie súboru:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
 ```
 
 Výborne! Práve si spustila svoj prvý pythonský program uložený v súbore. Skvelý pocit, však?
 
 Teraz sa môžeš posunúť na ďalší základný nástroj v programovaní:
 
-## If...elif...else
+## If … elif … else
 
 Kopec vecí v kóde sa má spúšťať len ak sú splnené nejaké podmienky. Práve na to používa Python príkaz **if**.
 
 Nahraď kód v súbore **python_intro.py** týmto:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
 ```
 
 Ak to uložíš a spustíš, dostaneš túto chybu:
 
-```
-$ python3 python_intro.py
-File "python_intro.py", line 2
-          ^
-SyntaxError: unexpected EOF while parsing
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
 
 Python očakáva, že od nás dostane ďalšie inštrukcie, ktoré majú byť vykonané ak je podmienka `3 > 2` pravdivá (teda ak bude mať hodnotu `True`). Skúsme zariadiť, aby Python napísal "Funguje to!". Zmeň svoj kód v súbore **python_intro.py** takto:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
-    print('Funguje to!')
+    print('It works!')
 ```
 
 Všimla si si, ako sme odsadili druhý riadok o 4 medzery? To musíme urobiť preto, aby Python vedel, ktorú časť kódu má spustiť ak je výsledok pravdivý. Môžeš použiť len jednu medzeru, ale takmer všetci programátori v Pythone používajú 4 medzery, aby bol kód dobre čitateľný. Jeden `tab` sa tiež počíta ako 4 medzery.
 
 Ulož to a spusti to znova:
 
-```
+{% filename %}command-line{% endfilename %}
+
+```python
 $ python3 python_intro.py
 Funguje to!
 ```
 
+Poznámka: Zapamätaj si že Windows nepozná príkaz "python3". Od teraz a naďalej, nahraď "python3" príkazom "python"pri spúšťaní súborov.
+
 ### Čo ak podmienka nie je pravdivá?
 
 V predchádzajúcich príkladoch, bol kód vykonaný len vtedy, keď podmienky boli pravdivé. Ale Python má tiež príkazy `elif` a `else`:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 5 > 2:
-    print('5 je naozaj viac ako 2')
+    print('5 is indeed greater than 2')
 else:
-    print('5 nie je viac ako 2')
+    print('5 is not greater than 2')
 ```
 
 Keď to spustíš, vypíše to:
 
-```
-$ python3 python_intro.py
-5 je naozaj viac ako 2
-```
+{% filename %}command-line{% endfilename %}
 
-Ak by 2 bolo väčšie ako 5, spustil by sa druhý príkaz. Jednoduché, nie? Pozrime sa, ako funguje `elif`:
+    $ python3 python_intro.py
+    5 je naozaj viac ako 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 name = 'Sonja'
@@ -613,54 +771,80 @@ else:
 
 a po spustení:
 
-```
-$ python3 python_intro.py
-Ahoj Sonja!
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ahoj Sonja!
+    
 
 Všimla si si, čo sa stalo? `elif` ti dovolí pridať dodatočné podmienky, ktoré sa spustia, ak sú predchádzajúce nesplnené.
 
 Za prvý `if` môžeš dať `elif` toľkokrát, koľko len chceš. Napríklad:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-hlasitost = 57
-if hlasitost < 20:
-    print("Vcelku ticho.")
-elif 20 <= hlasitost < 40:
-    print("Fajn na hudbu v pozadi")
-elif 40 <= hlasitost < 60:
-    print("Super, pocujem vsetky detaily")
-elif 60 <= hlasitost < 80:
-    print("Vyborne na party")
-elif 80 <= hlasitost < 100:
-    print("Trochu hlucne!")
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
 else:
-    print("Bolia ma usi! :(")
+    print("My ears are hurting! :(")
 ```
 
 Python prejde všetkými podmienkami v poradí a vypíše:
 
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Super, pocujem vsetky detaily
+    
+
+## Komentáre
+
+Komentáre su riadky, ktoré sa začínajú s `#`. Po `#` môžeš napísať hocičo, Python to bude ignorovať. Komentáre urobia tvoj kód čitateľnejším pre iných ludí.
+
+Pozrime sa ako to vyzerá:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
 ```
-$ python3 python_intro.py
-Super, pocujem vsetky detaily
-```
+
+Nemusíš písať komentár pre každý riadok kódu čo napíšeš, ale je užitočné vysvetliť prečo tvoj kód niečo robǐ, alebo stručne popísať keď robí niečo zložité.
 
 ### Zhrnutie
 
 V posledných troch cvičeniach si sa naučila:
 
-*   **porovnávať veci** - v Pythone môžeš porovnávať veci pomocou znamienok `>`, `>=`, `==`, `<=`, `<` a operátorov `and`, `or`
-*   **Booleovské/logické premenné** - typ objektu, ktorý môže mať len jednu z dvoch hodnôt: `True` (pravda) alebo `False` (nepravda)
-*   **Ukladať súbory** - ukladanie kódu v súboroch, takže môžete spúšťať väčšie programy.
-*   **Ak... elif... inde** - príkazy, ktoré ti umožňujú spustiť kód, iba ak sú splnené určité podmienky.
+- **porovnávať veci** - v Pythone môžeš porovnávať veci pomocou znamienok `>`, `>=`, `==`, `<=`, `<` a operátorov `and`, `or`
+- **Booleovské/logické premenné** - typ objektu, ktorý môže mať len jednu z dvoch hodnôt: `True` (pravda) alebo `False` (nepravda)
+- **Ukladať súbory** - ukladanie kódu v súboroch, takže môžete spúšťať väčšie programy.
+- **if... elif... else** - príkazy, ktoré ti umožňujú spustiť kód, iba ak sú splnené určité podmienky.
+- **comments** - lines that Python won't run which let you document your code
 
 Teraz je čas na poslednú časť tejto kapitoly!
 
 ## Tvoje vlastné funkcie!
 
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) videu.
+
 Pamätáš si funkcie ako napríklad `len()`, ktoré môžeš v Pythone spúšťať? Máme pre teba dobrú správu - teraz sa naučíš ako napísať vlastnú funkciu!
 
-Funkcia je postupnosť inštrukcií, ktoré by mal Python spustiť. Každá funkcia v Pythone začína kľúčovým slovom `def`, má svoje meno a môže mať nejaké parametre. Začnime s niečím ľahkým. Nahraď kód v **python_intro.py** týmto:
+Funkcia je postupnosť inštrukcií, ktoré by mal Python spustiť. Každá funkcia v Pythone začína kľúčovým slovom `def`, má svoje meno a môže mať nejaké parametre. Let's give it a go. Nahraď kód v **python_intro.py** týmto:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi():
@@ -676,20 +860,31 @@ Možno sa čuduješ prečo sme na koniec súboru napísali názov funkcie. To pr
 
 Spusťme to a pozrime sa, čo sa stane:
 
-```
-$ python3 python_intro.py
-Ahoj!
-Ako sa mas?
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ahoj!
+    Ako sa mas?
+    
 
-To bolo ľahké! Poďme vytvoriť našu prvú funkciu s parametrami. Použijeme predchádzajúci príklad - funkcia, ktorá hovorí "ahoj" osobe, ktorá ju spustí - s menom:
+Poznámka: Ak nefunguje, nepanikár! Výstup ti pomôže zistiť dôvod, prečo:
+
+- Ak sa ti zjaví `NameError`, to znamená, že si niečo chybne napísala, takže by si mala overiť, že si použila rovnaké meno, keď si vytvárala pomocou `def hi()` a keď si ju zavolala pomocou `hi()`.
+- Ak sa ti zjaví `IndentationError`, uisti sa, že oba `print` riadky, majú rovnaký počet medzier od začiatku riadku: python vyžaduje aby všetky riadky boli pedatne zarovnané.
+- Ak nevidíš žiaden výstup, tak sa pozri či posledné `hi()` *nie je* odsadené - ak je, ten riadok sa stal súčasťou funkcie a nikdy nedojde k jeho spusteniu.
+
+Poďme vytvoriť našu prvú funkciu s parametrami. Použijeme predchádzajúci príklad - funkcia, ktorá hovorí "ahoj" osobe, ktorá ju spustí - s menom:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
-def hi(meno):
+def hi(name):
 ```
 
 Ako vidíš, dali sme našej funkcii parameter, ktorý sme nazvali `meno`:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(meno):
     if meno == 'Ola':
@@ -704,50 +899,60 @@ hi()
 
 Zapamätaj si: Funkcia `print` je odsadená o 4 medzery vo vnútri príkazu `if`. Je to preto, lebo funkcia sa spustí, len ak je splnená podmienka. Pozrime sa ako to funguje:
 
-```
-$ python3 python_intro.py
-Traceback (most recent call last):
-File "python_intro.py", line 10, in <module>
-  hi()
-TypeError: hi() missing 1 required positional argument: 'meno'
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'meno'
+    
 
 Ups, chyba. Našťastie Python nám dáva vcelku užitočnú chybovú hlášku. Hovorí nám, že funkcia `hi()` (tá, čo sme definovali) má jeden povinný argument (s názvom `meno`) a že sme mu ju zabudli zadať pri volaní funkcie. Opravme to na konci súboru:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 hi("Ola")
 ```
 
 A znova ho spusti:
 
-```
-$ python3 python_intro.py
-Ahoj Ola!
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ahoj Ola!
+    
 
 A čo ak zmeníme meno?
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 hi("Sonja")
 ```
 
 A spustíme to:
 
-```
-$ python3 python_intro.py
-Ahoj Sonja!
-```
+{% filename %}command-line{% endfilename %}
 
-No a čo si myslíš, čo sa stane, ak tam napíšeš iné meno? (Nie Ola ani Sonja.) Vyskúšaj to a uvidíš, či bol tvoj predpoklad správny. Malo by ti vypísať toto:
+    $ python3 python_intro.py
+    Ahoj Sonja!
+    
 
-```
-Ahoj neznáma!
-```
+No a čo si myslíš, čo sa stane, ak tam napíšeš iné meno? (Nie Ola ani Sonja). Vyskúšaj a uvidíš, či bol tvoj predpoklad správny. Malo by ti vypísať toto:
+
+{% filename %}command-line{% endfilename %}
+
+    Ahoj neznáma!
+    
 
 Úžasné, nie? Vďaka tomu nemusíš prepisovať dokola to isté zakaždým, keď chceš zmeniť meno osoby, ktorú má funkcia pozdraviť. A to je presne dôvod, prečo potrebujeme funkcie - aby sme nemuseli opakovať svoj kód!
 
 Urobme to teda trochu rozumnejšie - existujú viac ako dve mená a písať podmienku pre každé by bolo trochu náročné, však?
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(meno):
     print('Ahoj ' + meno + '!')
@@ -757,35 +962,44 @@ hi("Katka")
 
 Teraz spusťme kód:
 
-```
-$ python3 python_intro.py
-Ahoj Katka!
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ahoj Katka!
+    
 
 Gratulujeme! Práve si sa naučila ako sa píšu funkcie! :)
 
 ## Cykly
 
+> Pre čitateľov doma: Táto kapitola je spracovaná v [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) videu.
+
 Toto je už posledná časť. Išlo to rýchlo, však? :)
 
 Programátori sa neradi opakujú. Programovanie je o automatizácii vecí, takže nechceme zdraviť každú osobu manuálne, nie? A vtedy nám prídu vhod cykly.
 
 Ešte si spomínaš na zoznamy? Pripravme zoznam dievčat:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 dievcata = ['Katka', 'Monika', 'Zuzka', 'Ola', 'Ty']
 ```
 
 Chceme ich pozdraviť všetky menom. Na to máme funkciu `hi`, tak ju použime v cykle:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 for meno in dievcata:
 ```
 
-Príkaz ~~~ for ~~~ sa správa podobne ako príkaz ~~~ if ~~~ ; kód pod oboma z nich musí byť odsadený o štyri medzery.
+    for sa správa podobne ako ```if``` príkaz. Kód v riadku pod nimi musí byť odsadený štyrmi medzerami.
 
 Tu je plný kód, ktorý napíšeme do súboru:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(meno):
     print('Ahoj ' + meno + '!')
@@ -798,38 +1012,42 @@ for meno in dievcata:
 
 A keď to spustíme:
 
-```
-$ python3 python_intro.py
-Ahoj Katka!
-Dalsie dievca
-Ahoj Monika!
-Dalsie dievca
-Ahoj Zuzka!
-Dalsie dievca
-Ahoj Ola!
-Dalsie dievca
-Ahoj Ty!
-Dalsie dievca
-```
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Ahoj Katka!
+    Dalsie dievca
+    Ahoj Monika!
+    Dalsie dievca
+    Ahoj Zuzka!
+    Dalsie dievca
+    Ahoj Ola!
+    Dalsie dievca
+    Ahoj Ty!
+    Dalsie dievca
+    
 
 Ako vidíš, všetko, čo dáš do príkazu `for` s oddsadením sa bude opakovať pre každý prvok zoznamu `dievcata`.
 
 `for` môžeš pomocou funkcie `range` použiť aj na čísla:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 for i in range(1, 6):
-     print(i)
+    print(i)
 ```
 
 Čo vypíše:
 
-```
-1
-2
-3
-4
-5
-```
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
 
 `range` je funkcia, ktorá vytvára zoznam čísel s postupnosťou čísel (krajné čísla funkcii poskytneš ako parametre).
 
@@ -841,6 +1059,4 @@ To je všetko. **Si úplne geniálna!** Toto bola náročná kapitola, takže by
 
 Teraz možno krátko rob niečo iné - natiahni sa trochu, poprechádzaj sa, nechaj svoje oči oddýchnuť si - a potom prejdeme na ďalšiu kapitolu. :)
 
-![Koláčik][2]
-
- [2]: images/cupcake.png
+![Koláčik](images/cupcake.png)
\ No newline at end of file
diff --git a/sk/signup_pythonanywhere.md b/sk/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/sk/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/sk/template_extending/README.md b/sk/template_extending/README.md
index 93b60fb0f98..38c179389b2 100755
--- a/sk/template_extending/README.md
+++ b/sk/template_extending/README.md
@@ -1,25 +1,26 @@
 # Rozširovanie šablón
 
-Ďalšou milou vecou, ktorú ti Django ponúka je **rozširovanie šablón**. Znamená to, že môžeš použiť rovnaké časti HTML kódu na rôznych stránkach svojho webu.
+Ďalšia super možnosť, ktorú ti Django ponúka je **rozširovanie šablón**. Znamená to, že môžeš použiť rovnaké časti HTML kódu na rôznych stránkach svojho webu.
 
-Vďaka tomu nemusíš všetko opakovať v každom súbore, ak chceš použiť rovnakú informáciu alebo layout. A ak chceš niečo zmeniť, nemusíš to robiť v každej šablóne zvlášť, ale iba raz!
+Šablóny ti pomôžu, keď chceš použiť rovnaké informácie alebo zobrazenie na viac ako jednom mieste. Nemusíš dokola opakovať to isté. A ak chceš niečo zmeniť, nemusíš to urobiť v každej šablóne, len v jednej!
 
 ## Vytvorenie základnej šablóny
 
-Základná šablóna je jednoducho šablóna, ktorú rozširuješ na každej stránke svojej web stránky.
+Základná šablóna je najzákladnejšia šablóna, ktorú rozširuješ na každej stránke svojej web stránky.
 
 Vytvorme súbor `base.html` v `blog/templates/blog/`:
 
-```
-blog
-└───templates
-    └───blog
-            base.html
-            post_list.html
-```
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
 
 Otvor ho a skopíruj doň všetko z `post_list.html` do súboru `base.html`:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -56,6 +57,8 @@ Otvor ho a skopíruj doň všetko z `post_list.html` do súboru `base.html`:
 
 Potom v `base.html` nahraď celé `<body>` (všetko medzi `<body>` a `</body>`) týmto:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <body>
     <div class="page-header">
@@ -72,16 +75,20 @@ Potom v `base.html` nahraď celé `<body>` (všetko medzi `<body>` a `</body>`)
 </body>
 ```
 
-V podstate sme nahradili všetko medzi `{% for post in posts %}{% endfor %}` týmto:
+{% raw %}Možno si si všimla, že toto nahradilo všetko od `{% for post in posts %}` po `{% endfor %}` s: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% block content %}
 {% endblock %}
 ```
 
-Čo to znamená? Práve si vytvorila `block` (blok), čo je vlastne šablóna tagov, ktorá ti umožní vkladať HTML v tomto bloku do ďalších šablón, ktoré rozširujú `base.html`. Hneď ti ukážeme, ako sa to robí.
+Ale prečo? Práve si vytvorila `block`! Použila si šablónový tag `{% block %}` aby si vytvoila časť, do ktorej bude vložené HTML. To HTML bude pochádzať z inej šablóny, ktorá rozšíri túto šablónu (`base.html`). Hneď ti ukážeme, ako sa to robí.
+
+Teraz ulož `base.html` a znova otvor `blog/templates/blog/post_list.html`. {% raw %}Odstrániš všetko nad `{% for post in posts %}` a pod `{% endfor %}`. Keď skončíš, súbor bude vyzerať nasledovne:{% endraw %}
 
-Teraz to ulož a znova otvor `blog/templates/blog/post_list.html`. Zmaž všetko, okrem toho, čo je vnútri body a tiež zmaž `<div class="page-header"></div>`, takže súbor bude vyzerať takto:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
@@ -95,13 +102,29 @@ Teraz to ulož a znova otvor `blog/templates/blog/post_list.html`. Zmaž všetko
 {% endfor %}
 ```
 
-A teraz pridaj tento riadok na začiatok súboru:
+Chceme toto použiť ako súčasť našej šablóny pre všetky bloky. Je čas pridať blokové tagy do tohto súboru!
+
+{% raw %}Blokový tag by sa mal zhodovať s tagom v `base.html` súbore. Taktiež by mal obsahovať celý kód, čo patrí do tvojích obsahových blokov. Aby si to urobila, vlož všetko medzi `{% block content %}` a `{% endblock %}`. Takto:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-{% extends 'blog/base.html' %}
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
 ```
 
-{% raw %}To znamená, že rozširujeme šablónu `base.html` v `post_list.html`. Už ostáva len jedna vec: daj všetko (teda okrem riadku, ktorý sme práve pridali) medzi `{% block content %}` a `{% endblock %}`. Takto:{% endraw %}
+Ešte zostála len jediná vec. Potrebujeme prepojiť tieto dve šablóny. O tomto je rozširovanie šablón! Urobíme to pridaním extends tagu na začiatku súboru. Nasledovne:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -119,6 +142,6 @@ A teraz pridaj tento riadok na začiatok súboru:
 {% endblock %}
 ```
 
-A je to! Skontroluj či tvoja web stránka funguje tak, ako má :)
+A je to! Skontroluj či tvoja web stránka funguje tak, ako má. :)
 
-> Ak sa ti zobrazí chyba `TemplateDoesNotExists`, ktorá hovorí, že súbor `blog/base.html` neexistuje a v konzole ti beží `runserver`, skús ho zastaviť (stlačením Ctrl + C) a reštartuj ho spustením príkazu `python manage.py runserver`.
+> Ak sa ti zobrazí chyba `TemplateDoesNotExist`, to znamená, že neexistuje `blog/base.html` súbor a `runserver` beží v konzole. Skús ho zastaviť (stlačením Ctrl+C – Control a C tlačidiel spolu) a spusti ho znova pomocou príkazu `python manage.py runserver`.
\ No newline at end of file
diff --git a/sk/whats_next/README.md b/sk/whats_next/README.md
index 006d2d16ac3..f12b9b3499f 100755
--- a/sk/whats_next/README.md
+++ b/sk/whats_next/README.md
@@ -6,35 +6,20 @@ Môžeš si zablahoželať! **Si úplne úžasná**. Sme hrdí! <3
 
 Daj si pauzu a oddýchni si. Práve si urobila niečo ohromné.
 
-Potom nezabudni:
+Potom začni sledovať Django Girls na [Facebooku](http://facebook.com/djangogirls) alebo [Twitteri](https://twitter.com/djangogirls) a zostaň informovaná.
 
-*   Sledovať Django Girls na [Facebooku][1] alebo [Twitteri][2] a zostať informovaná
+### Viete odporučiť ďalšie zdroje?
 
- [1]: http://facebook.com/djangogirls
- [2]: https://twitter.com/djangogirls
+Áno! Ako prvé, neváhaj a vyskúšaj našu ďalšiu knihu [Django Girls Tutorial: Rozšírenie](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
 
-### Viete odporučiť ďalšie zdroje?
+Neskôr môžeš skúsiť zdroje uvedené nižšie. Všetky sú veľmi odporúčané!
 
-Áno! Ako prvé, neváhaj a vyskúšaj našu ďalšiu knihu [Django Girls Tutorial: Rozšírenie][3].
-
- [3]: https://tutorial-extensions.djangogirls.org
-
-Neskôr môžeš skúsiť zdroje uvedené nižšie. Všetky veľmi odporúčame!
-
-- [Django's official tutorial][4]
-- [New Coder tutorials][5]
-- [Code Academy Python course][6]
-- [Code Academy HTML & CSS course][7]
-- [Django Carrots tutorial][8]
-- [Learn Python The Hard Way book][9]
-- [Getting Started With Django video lessons][10]
-- [Two Scoops of Django: Best Practices for Django 1.8 book][11]
-
- [4]: https://docs.djangoproject.com/en/1.8/intro/tutorial01/
- [5]: http://newcoder.io/tutorials/
- [6]: https://www.codecademy.com/en/tracks/python
- [7]: https://www.codecademy.com/tracks/web
- [8]: http://django.carrots.pl/en/
- [9]: http://learnpythonthehardway.org/book/
- [10]: http://www.gettingstartedwithdjango.com/
- [11]: https://twoscoopspress.com/products/two-scoops-of-django-1-8
+- [Oficiálny Django návod](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python kurz](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS kurz](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorál](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way kniha](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video návod](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - môžeš požiadať o licenciu na e-knihu zdarma kontaktovaním autorky Tracy Osborn e-mailom: <tracy@limedaring.com>
\ No newline at end of file
diff --git a/sl-SI/GLOSSARY.md b/sl-SI/GLOSSARY.md
new file mode 100644
index 00000000000..3c2fa641e9b
--- /dev/null
+++ b/sl-SI/GLOSSARY.md
@@ -0,0 +1,3 @@
+# urejevalnik programske kode
+
+Urejevalnik programske kode je aplikacija, ki ti omogoča urejanje in shranjevanje programske kode. Več o tem v poglavju [Urejevalnik programske kode](./code_editor/README.md)
\ No newline at end of file
diff --git a/sl-SI/README.md b/sl-SI/README.md
new file mode 100644
index 00000000000..f92cb1bb4b2
--- /dev/null
+++ b/sl-SI/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Dobrodošli
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Uvod
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Si se kdaj spraševala, kako bi naredila svojo spletno stran, vendar nisi imela dovolj motivacije, da bi jo dejansko naredila? Se ti je kdaj zdelo, da je svet programiranja zate preveč zapleten?
+
+Imamo dobre novice! Programiranje sploh ni težko! Pravzaprav je zelo zabavno. :)
+
+This tutorial will not magically turn you into a programmer. Če želiš biti v programiranju res dobra, potrebuješ mesece ali pa celo leta vaje. Mi ti želimo le pokazati, da programiranje in izdelava spletnih strani, nista tako zapletena, kot se to sprva zdi. Stvari ti bomo predstavili na preprost in sproščen način, ki pa bo še vseeno dovolj natančen.
+
+Upamo, da ti bo, ko končaš s tem vodičem, svet moderne tehnologije všeč vsaj približno toliko, kot je nam!
+
+## Česa se bomo naučili?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+Zgledal bo (približno) tako:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Naše mentorje in bivše udeležence delavnic smo prosili, da sodelujejo na tem forumu in ti pomagajo, če rabiš pomoč! Nič se ne boj, brez sramu vprašaj za pomoč!
+
+OK, [pa začnimo...](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## O avtorjih in razvijalcih
+
+Ta vodič je delo organizacije [DjangoGirls](https://djangogirls.org/). Če najdeš kakršnokoli napako, ali pa če želiš kaj dodati, sledi [navodilom za prispevanje](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Prevodi se trenutno nahajajo v aplikaciji crowdin.com na naslovu:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/sl-SI/SUMMARY.md b/sl-SI/SUMMARY.md
new file mode 100644
index 00000000000..a8c37a56397
--- /dev/null
+++ b/sl-SI/SUMMARY.md
@@ -0,0 +1,35 @@
+# Povzetek
+
+* [Uvod](README.md)
+* [Namestitev](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [Kako deluje internet](how_the_internet_works/README.md)
+* [Osnove dela z ukazno vrstico](intro_to_command_line/README.md)
+* [Namestitev Pythona](python_installation/README.md)
+* [Urejevalnik programske kode](code_editor/README.md)
+* [Uvod v Python](python_introduction/README.md)
+* [Kaj je Django?](django/README.md)
+* [Namestitev Djanga](django_installation/README.md)
+* [Tvoj prvi Django projekt!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Postavitev!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Uvod v HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Djangove predloge](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Razširitev predloge](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django obrazci](django_forms/README.md)
+* [Kaj pa zdaj?](whats_next/README.md)
\ No newline at end of file
diff --git a/sl-SI/chromebook_setup/README.md b/sl-SI/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/sl-SI/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/sl-SI/chromebook_setup/instructions.md b/sl-SI/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..a7ccd9ae27e
--- /dev/null
+++ b/sl-SI/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Prijavi se za brezplačni račun
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtualno okolje
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/sl-SI/code_editor/README.md b/sl-SI/code_editor/README.md
new file mode 100644
index 00000000000..2784a6dade0
--- /dev/null
+++ b/sl-SI/code_editor/README.md
@@ -0,0 +1,11 @@
+# Urejevalnik programske kode
+
+> Za domače bralke: to poglavje je pokrito v videu [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+Si tik pred tem, da napišeš svoj prvi program, zato je čas, da si preneseš urejevalnik programske kode!
+
+> **Opomba** Če uporabljaš Chromebook, lahko to poglavje preskočiš in slediš navodilom v [Chromebook namestitev](../chromebook_setup/README.md). Oblačni IDE, ki ga boš izbrala (PaizaCloud IDE ali AWS Cloud9), vsebuje urejevalnik kode. Ko odpreš datoteko v svojem IDE iz menija Datoteka, se bo samodejno odprl urejevalnik.
+> 
+> **Opomba** Morda si to storila že prej v poglavju [Namestitev](../installation/README.md). Če je temu tako, skoči naprej na naslednje poglavje!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/sl-SI/code_editor/instructions.md b/sl-SI/code_editor/instructions.md
new file mode 100644
index 00000000000..b8630e3e25c
--- /dev/null
+++ b/sl-SI/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Obstaja veliko različnih urejevalnikov programske kode. Izbira je bolj ali manj stvar okusa. Python programerji običajno uporabljajo zmogljiva integrirana razvojna okolja (IDE - Integrated Development Environment) kot je PyCharm. Kot začetnici ti uporabe teh okolij ne priporočamo, saj so za tvoje potrebe dovolj preprostejši urejevalniki, ki so prav tako zmogljivi, vendar precej prijaznejši za uporabo.
+
+Naši predlogi so našteti spodaj. Če nisi prepričana, katerega bi izbrala, za mnenje vprašaj še svojo mentorico. Z veseljem ti bo pomagala.
+
+## Visual Studio Code
+
+Visual Studi Code je urejvalnik izvorne kode, ki so ga razvili pri Microsoftu za Windows, Linux in macOS. Vključuje podporo za razhroščevanje, vključuje Git nadzor, osvetljevanje sintakse, inteligentno dokončanje kode, odseke in predelavo kode.
+
+[Naložiš ga tukaj](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit je odprtokodni, brezplačni urejevalnik, ki je na voljo za vse operacijske sisteme.
+
+[Naložiš ga tukaj](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text je zelo priljubljen urejevalnik z brezplačno preizkusno dobo, ki je na voljo za vse operacijske sisteme.
+
+[Naložiš ga tukaj](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom je priljubljen urejevalnik. Je brezplačen, odprtokoden, na voljo pa je za Windows, OS X in Linux. Razvili so ga pri [GitHub-u](https://github.com/).
+
+[Naložiš ga tukaj](https://atom.io/)
+
+## Zakaj nameščamo urejevalnik kode?
+
+Morda se sprašuješ, zakaj namestiti urejevalnik programske kode, namesto tega, da bi uporabili nekaj, kot je Word ali Notepad.
+
+Glavni razlog je to, da mora programska koda biti **navadno besedilo** , problem s programi kot sta Word in Textedit pa je, da proizvajajo obogateno besedilo (besedilo, ki vsebuje različne pisave in je oblikovano) z lastnim oblikovanjem, kot denimo [RTF](https://en.wikipedia.org/wiki/Rich_Text_Format) (Rich Text Format).
+
+Drugi razlog je v tem, da so urejevalniki kode namenjeni urejanju kode, zato imajo koristne funkcije, kot denimo osvetljevanje kode glede na pomen ali samodejno zapiranje navedkov.
+
+Kasneje bomo te stvari videli v praksi. Kmalu boši o svojem urejevalniku kode razmišljala, kot o enem izmed naljubših orodji. :)
\ No newline at end of file
diff --git a/sl-SI/css/README.md b/sl-SI/css/README.md
new file mode 100644
index 00000000000..9b3a9f63667
--- /dev/null
+++ b/sl-SI/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Naš blog zaenkrat nima ravno elegantnega videza. Čas je, da ga polepšamo! Uporabili bomo CSS.
+
+## Kaj je CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Uporabimo Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Namestitev Bootstrapa
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Malo bolje je že!
+
+## Djangove statične datoteke
+
+Podrobneje si poglejmo že omenjene, famozne **statične datoteke**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Kje v Djangu živijo statčne datoteke
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+To narediš tako, da, znotraj aplikacije blog, ustvariš nov imenik z imenom `static`:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Prvi koraki v jeziku CSS!
+
+Let's create a CSS file now, to add your own style to your web page. Najprej naredi nov imenik z imenom `css`, v njem pa še enega z imenom `static`. Nato znotraj imenika `css` ustvari novo css datoteko `blog.css`. Pripravljena?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Končno lahko začnemo s pisanjem CSS kode! V svojem urejevalniku odpri prej ustvarjeno datoteko `blog/static/css/blog.css`.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+Malce pa si vseeno poglejmo že zdaj. Maybe we could change the color of our headers? Za barve računalniki uporabljajo posebne kode. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. Obstajajo pa tudi [vnaprej določene barve](http://www.w3schools.com/colors/colors_names.asp), ki jih lahko opišeš kar z angleškimi imeni, kot recimo `red` za rdečo in `green` za zeleno.
+
+V datoteko `blog/static/css/blog.css` dodaj sledečo kodo:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` je oznaka, ki pove, kateri del HTML kode želimo s CSS kodo, ki oznaki sledi, spremeniti. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+V datoteki CSS bomo torej določili slog za vsak del HTML kode. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class in id sta oznaki, ki ju za nek element določiš sama. Oznaka class opisuje skupino značk, id pa le eno samo značko. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. S tem smo predlogi uspešno povedali, kje živi naš CSS. :)
+
+Naša CSS datoteka trenutno zgleda takole:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, datoteko shrani in v brskalniku osveži spletno stran!
+
+![Figure 14.2](images/color2.png)
+
+Odlično! Dodajmo strani še malo zamika na levi in desni.
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Kako pa bi spremenili vrsto pisave našega besedila? Znotraj značke `<head>` v datoteki `blog/templates/blog/post_list.html` dodaj:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Odlično!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Zdaj lahko opisanim delom strani dodamo CSS kodo, ki bo določala oblikovanje le-teh. Koda, ki opisuje določen razred, se bo vedno začela z znakom `.` in takoj zatem imenom razreda. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Dodane CSS razrede moramo dodati še v našo HTML kodo. Zamenjaj tale del kode:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+, ki se nahaja v datoteki `blog/templates/blog/post_list.html`, s sledečo kodo:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Shrani datoteko in osveži spletno stran.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Pripravljena na naslednje poglavje?! :)
\ No newline at end of file
diff --git a/sl-SI/deploy/README.md b/sl-SI/deploy/README.md
new file mode 100644
index 00000000000..92cdcf7ae55
--- /dev/null
+++ b/sl-SI/deploy/README.md
@@ -0,0 +1,246 @@
+# Postavitev!
+
+> **Opomba** Nekatera mesta tega poglavja se vam bodo morda zdela zahtevna. Ne vrzite puške v koruzo in se prebijte do konca; postavitev je pomemben korak v razvoju spletne strani. To poglavje se nahaja na sredini vodiča, zato da vam lahko vaš mentor oz. mentorica pomaga pri zahtevnejših korakih objave spletne strani. Tako lahko vodič končate tudi sami, če bi vam slučajno zmanjkalo časa.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Postavitev pomeni objaviti vašo aplikacijo na spletu, da bodo ljudje lahko končno uvideli vašo aplikacijo. :)
+
+Sedaj že veste, da mora biti spletna stran na strežniku. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+Pri postavitvi bomo uporabili še eno zunanjo storitev: [GitHub](https://www.github.com) - storitev za gostovanje kode. Seveda so na voljo tudi druge rešitve, a večina programerjev ima GitHub račun. In sedaj ga imate tudi vi!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Ustvarimo Git repozitorij
+
+Git sledi sprememba določenemu naboru datotek, ki ga imenujemo repozitorij kode (ali na kratko "repo"). Ustvarimo repozitorij za naš projekt. Odprite upravljalnik in v imeniku `djangogirls` zaženite te ukaze:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. Nahajati se morate v mapi `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Inicializir prazen Git repozitorij v ~/djangogirls/.git/
+    $ git config --global user.name "Vaše ime"
+    $ git config --global user.email vaš.naslov@primer.si
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git sledi spremembam datotek in map v tem imeniku. Kaj pa če želimo, da sistem ne sledi spremembam določenih datotek? V izvirnem imeniku ustvarimo datoteko `.gitignore`. Odprite urejevalnik in ustvarite novo datoteko s sledečo vsebino:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Opomba** Ne pozabite pike na začetku imena, saj je pomembna! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+Dobra navada je, da zaženete ukaz `git status` preden zaženete `git add` oziroma ne veste, kaj je bilo spremenjeno. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Na koncu shranimo spremembe. V vašem upravljalniku zaženite te ukaze:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/sl-SI/deploy/install_git.md b/sl-SI/deploy/install_git.md
new file mode 100644
index 00000000000..dc5fe553e75
--- /dev/null
+++ b/sl-SI/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git je "sistem za porazdeljeno dokumentiranje sprememb in izdajanje različic datotek", ki ga uporablja veliko programerjev. Ta programska oprema sledi spremembam v vaših datotekah, kar vam omogoča, da lahko v nadaljevanju prikličete prejšnje različice. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Namestitev Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Sistem za porazdeljeno dokumentiranje sprememb in izdajanje različic datotek oz. Git lahko prenesete iz spletnega mesta [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Sicer pa so privzete nastavitve v redu. Ukaz checkout v Windows slogu in ukaz commit v Unix slogu je dobra izbira.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sl-SI/deploy/signup_pythonanywhere.md b/sl-SI/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/sl-SI/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/sl-SI/django/README.md b/sl-SI/django/README.md
new file mode 100644
index 00000000000..694367c0c92
--- /dev/null
+++ b/sl-SI/django/README.md
@@ -0,0 +1,27 @@
+# Kaj je Django?
+
+Django (*džango*) je brezplačno odprtokodno ogrodje, narejeno v programskem jeziku Python. Ogrodje je skupek že napisanih programov, ki ti pomagajo spletne strani graditi hitreje in lažje.
+
+Kot si opazila, obstajajo določeni gradniki, ki jih ima vsaka spletna stran: sistem za registriranje, plošča za upravljanje spletne strani, kontaktni obrazec, sistem za nalaganje datotek in podobno.
+
+Na srečo so se našli ljudje, ki so to ugotovili in so skupaj razvili ogrodja (kot je Django), ki nam nudijo že narejene določene komponente spletne strani.
+
+Ogrodja nas torej rešujejo pred ponovnim odkrivanjem stvari, ki so že dolgo znane oziroma narejene. To jasno precej pospeši postopek razvoja spletnih strani.
+
+## Zakaj potrebujemo ogrodja?
+
+Da bi res dobro razumeli, kaj pravzaprav je Django, si podrobneje oglejmo spletni strežnik. Prva stvar, ki jo mora strežnik vedeti je, da od njega želiš podatke o spletni strani.
+
+Predstavljaj si nabiralnik, ki čaka na prejeta pisma. Točno to počno spletni strežniki. Preberejo pismo in pošljejo odgovor v obliki spletne strani. Ta spletna stran pa mora jasno imeti neko vsebino. Pri ustvarjanju le-te, ti bo pomagal Django.
+
+## Kaj se zgodi, ko nekdo od našega strežnika zahteva spletno stran?
+
+Ko strežnik dobi prošnjo po spletni strani, jo preda Djangu, ta pa poskuša ugotoviti, kaj točno ta prošnja od njega hoče. Najprej pogleda naslov spletne strani in poskuša na podlagi le-tega ugotoviti, kaj se od njega zahteva. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Predstavljaj si poštarja, ko dostavlja pismo. Ko hodi po ulici, da bi ga dostavil, mora za vsak naslov preveriti, če je isti, kot tisti na pismu. Ko najde pravi naslov, pismo tam odloži. Django deluje povsem enako!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Recimo, da želi uporabnik spremeniti svoje podatke, ki jih imamo shranjene v bazi. Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/sl-SI/django_admin/README.md b/sl-SI/django_admin/README.md
new file mode 100644
index 00000000000..5a613026be0
--- /dev/null
+++ b/sl-SI/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Kot vidiš, smo uvozili paket Post o katerem smo govorili v prejšnjem poglavju. Če hočemo, da bomo podatki, ki jih bomo s paketom Post ustvarili vidni, ga moramo registrirati z `admin.site.register(Post)`.
+
+OK, zdaj si lahko bolj podrobno ogledamo Post. Ne pozabi v ukazni vrstici pognati ukaza `python manage.py runserver`. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/sl-SI/django_forms/README.md b/sl-SI/django_forms/README.md
new file mode 100644
index 00000000000..9dd977e21c7
--- /dev/null
+++ b/sl-SI/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django obrazci
+
+Naš zadnji korak je ustvariti enostaven način za dodajanje in urejanje vnosov. `Admin` v Django je odličen, ampak težko prilagodljiv. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+Z obrazci Django lahko definiramo povsem nov obrazec ali pa ustvarimo `ModelForm`, ki vnos v obrazec shrani v model.
+
+To pa je naravnost to, kar želimo storiti: ustvarili bomo obrazec za našo objavo - `Post`.
+
+Kot vsi ključni deli ogrodja Django so tudi obrazci v svoji datoteki: `forms.py`.
+
+V imeniku `Blog` ustvarimo datoteko s tem imenom.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+Kot ste najbrž že uganili je `PostForm` ime našega obrazca. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Nato definiramo `class Meta`, kjer določimo model, ki bo podlaga za naš obrazec (`model = Post`).
+
+Na koncu še določimo polje oziroma polja, ki jih bodo v našem obrazcu. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+To je vse! Edino kar nam sedaj še preostane je, da obrazec uporabimo v *view* in ga prikažemo v predlogi.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Povezava do strani z obrazcem
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Predloga
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Potrebujemo še gumb `Shrani`. Za to uporabimo kar gumb HTML `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. S tem zavarujemo naš obrazec! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Shranjevanje obrazca
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/sl-SI/django_installation/README.md b/sl-SI/django_installation/README.md
new file mode 100644
index 00000000000..b12181f51a0
--- /dev/null
+++ b/sl-SI/django_installation/README.md
@@ -0,0 +1,7 @@
+# Namestitev Djanga
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/sl-SI/django_installation/instructions.md b/sl-SI/django_installation/instructions.md
new file mode 100644
index 00000000000..aed630a2fc6
--- /dev/null
+++ b/sl-SI/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Vodič django-marcador tutorial je avtorsko delo Markus Zapke-Gründemann et al.
+
+## Virtualno okolje
+
+Preden namestiš Django, se boš seznanila z zelo uporabnim orodjem, ki ti bo omogočilo vzpostavitev urejenega delovnega prostora. Ta korak sicer ni obvezen, vendar pa je zelo priporočljiv. Uporaba virtualnega okolja nam dolgoročno prihrani veliko težav!
+
+Ustvarimo torej **virtualno okolje** (angl. virtual environment ali *virtualenv*). Navidezno/virtualno okolje bo omejilo spremembe, ki jih bomo naredili v Pythonu in Djangu, le na naš projekt. To pomeni, da omenjene spremembe ne bodo vplivale na noben drug projekt, ki ga imaš morda tudi na računalniku. To se zdi smiselno.
+
+Za začetek najdi imenik, v katerem želiš ustvariti `virtualno okolje`. Recimo tvoj domači imenik. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+V tem vodiču bomo v tvojem domačen imeniku ustvarili nov imenik `djangogirls`:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Zdaj bomo ustvarili navidezno okolje `myvenv`. Splošen ukaz zgleda nekako takole:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. Ubistvu si lahko zmisliš katerokoli ime, ki vsebuje le male črke in ne vsebuje presledkov, naglasov in podobnih posebnih znakov. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+myvenv je ime tvojega virtualnega okolja. Ubistvu si lahko zmisliš katerokoli ime, ki vsebuje le male črke in ne vsebuje presledkov, naglasov in podobnih posebnih znakov. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To lahko rešiš tako, da raje uporabiš ukaz `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Delo z virtualnim okoljem
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Virtualno okolje zaženeš takole:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/sl-SI/django_models/README.md b/sl-SI/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/sl-SI/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/sl-SI/django_orm/README.md b/sl-SI/django_orm/README.md
new file mode 100644
index 00000000000..fcab2b74437
--- /dev/null
+++ b/sl-SI/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM in QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/sl-SI/django_start_project/README.md b/sl-SI/django_start_project/README.md
new file mode 100644
index 00000000000..4c6654e1276
--- /dev/null
+++ b/sl-SI/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Tvoj prvi Django projekt!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Vodič django-marcador tutorial je avtorsko delo Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+Za začetek ustvarimo nov Django projekt. To bomo naredili s pomočjo programčka, ki smo ga dobili ob namestitvi Djanga. Ustvaril nam bo nekaj imenikov in datotek, ki nam bodo omogočile lažji in hitrejši začetek.
+
+Imena nekaterih imenikov in datotek so Djangu zelo pomembna. Zato datotek, ki jih bomo v nadaljevanju ustvarili, ne preimenuj. Prav tako jih raje ne premikaj. Django ima namreč za veliko datotek v spominu shranjeno, kje približno se nahajajo in kako se jim reče, zato ga lahko s spremembami zmedemo.
+
+> Ne pozabi, da moraš projekt delati znotraj virtualnega okolja. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. Kako se to naredi smo podrobno pojasnili v poglavjih **Namestitev Djanga** in **Osnove dela z ukazno vrstico**. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Pika je pomembna, ker programu pove, da mora v trenutni imenik (okrajšava zanj je .) namestiti Django).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Pika je pomembna, ker programu pove, da mora v trenutni imenik (okrajšava zanj je .) namestiti Django).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` je program, ki bo zate naredil nekaj imenikov in datotek. Recimo takih:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+`settings.py` vsebuje podatke o nastavitvah naše spletne strani.
+
+`urls.py` pove, kateri del spletne strani naj se pokaže, ko v brskalnik vpišemo določen url naslov.
+
+Ostale datoteke zaenkrat prezrimo, saj jih ne bomo rabili spreminjati. Nikakor pa jih ne spreminjaj ali briši!
+
+## Spreminjanje nastavitev
+
+Malce bomo spremenili datoteko `mysite/settings.py`. Odpri jo v urejevalniku programske kode, ki si ga prej namestila.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+Na naši strani bi bilo dobro imeti pravilen čas in datum. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+Obstaja veliko različne programske opreme, ki lahko shranjuje podatke za našo stran (taki programski opremi rečemo podatkovna baza). Uporabili bomo privzeto, `sqlite3`.
+
+Kot lahko opazimo v `mysite/settings.py`, je sqlite3 že nastavljena:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Podatkovno bazo bomo ustvarili z ukazom: `python manage.py migrate` (biti moramo v imeniku `djangogirls`, saj le ta vsebuje datoteko `manage.py`). Pokazati se mora nekaj takšnega:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+Končano! Zdaj lahko zaženemo strežnik in se prepričamo, da naša stran deluje!
+
+## Starting the web server
+
+Biti moraš v imeniku `djangogirls`, saj le ta vsebuje datoteko `manage.py`. Strežnik zaženeš tako, da v ukazno vrstico vpišeš `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/sl-SI/django_templates/README.md b/sl-SI/django_templates/README.md
new file mode 100644
index 00000000000..8182f0531ef
--- /dev/null
+++ b/sl-SI/django_templates/README.md
@@ -0,0 +1,108 @@
+# Djangove predloge
+
+Vstavimo na spletno stran nekaj besedila! Django nam pri tem izdatno pomaga z značkami **template**.
+
+## Kaj so značke template?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Prikazovanje objav na blogu
+
+V prejšnjem poglavju smo seznam objav shranili v spremenljivko `posts`. Te objave moramo še prikazati kot HTML.
+
+Za izpis spremenljivke v Djangovih predlogah bomo uporabili zavite oklepaje, znotraj njih pa bomo dali spremenljivko:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Naredi to v predlogi `blog/templates/blog/post_list.html`. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Datoteko shrani, osveži stran in si oglej rezultate:
+
+![Figure 13.1](images/step1.png)
+
+Vse, kar smo dobili, je tole:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Django torej našo spremenljivko razume kot seznam objektov. Se še spomniš, kako se v Pythonu izpiše elemente seznama? Prav si uganila. Z zanko! V predlogah zanko narediš takole:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Preizkusi to še v svoji predlogi.
+
+![Figure 13.2](images/step2.png)
+
+Deluje! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. K sreči se izkaže, da lahko v značke template dodajamo tudi HTML kodo. `body` bo zdaj zgledal takole:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Vsa koda, ki je med `{% for %}` in `{% endfor %}` se bo ponovila za vsak objekt v seznamu. Osveži svojo stran:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? Razlika je v tem, da dostopamo do različnih delov naše baze podatkov `Post`. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## Še nekaj
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Nato se ponovno prijavi v [Pythona nAnywhere](https://www.pythonanywhere.com/consoles/), pojdi na **Bash console**(ali pa odpri novo) in zaženi:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/sl-SI/django_urls/README.md b/sl-SI/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/sl-SI/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/sl-SI/django_views/README.md b/sl-SI/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/sl-SI/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/sl-SI/dynamic_data_in_templates/README.md b/sl-SI/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/sl-SI/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/sl-SI/extend_your_application/README.md b/sl-SI/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/sl-SI/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/sl-SI/how_the_internet_works/README.md b/sl-SI/how_the_internet_works/README.md
new file mode 100644
index 00000000000..f44b76dbed9
--- /dev/null
+++ b/sl-SI/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Kako deluje internet
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Narejeni so namreč tako, da to kodo razumejo. Razbrati znajo napisane ukaze, ki jih koda vsebuje, in po njihovih navodilih prikazati spletno stran.
+
+Kot vsako datoteko, moramo tudi HTML datoteke shraniti na trdi disk računalnika. Računalnikom, na katerih so shranjene spletne strani, rečemo *strežniki*. Strežniki nimajo ekrana, miške in tipkovnice, saj je njihov glavni namen shraniti podatki in omogočiti, da si z njimi lahko postrežemo. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+Narisali smo ti sliko! Internet deluje nekako tako:
+
+![Figure 1.1](images/internet_1.png)
+
+Nenavadno, kajne? In fact it is a network of connected machines (the above-mentioned *servers*). Na milijone računalnikov! Ogromna mreža kablov, razpredena po celem svetu! Obiščeš lahko spletno stran Cable Map (http://submarinecablemap.com). Tam boš videla, kako zapletena mreža je internet. Tule je slika iz njihove spletne strani:
+
+![Figure 1.2](images/internet_3.png)
+
+Fascinantno! But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+Nekako tako:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+To pismo gre na najbližjo pošto, od tod gre na pošto, ki je še nekoliko bližje želenemu naslovu in tako nadaljuje, dokler ne pride do želenega naslova. Edina razlika, če primerjamo to pošiljanje s pošiljanjem v internetu je, da v internetu dejansko pošljemo več pisem (*podatkovnih paketov*) na isto pošto (strežnik). Ta pisma pa gredo lahko do končnega naslova (strežnika) skozi povsem različne pošte (*omrežne usmerjevalnike*). 
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Namesto običajnega naslova, ki vsebuje naslov ulice, poštno številko in ime države, v računalništvu uporabljamo IP naslov, ki predstavlja naslov računalnika. Tvoj računalnik bo, ko vidi naslov djangogirls.org, s pomočjo sistema DNS (Domain Name System), ta naslov pretvoril v IP. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Napisati pa ga moraš jasno v jeziku, ki ga naslovnik razume. Enako velja za *podatkovne pakete*, ki jih računalnik pošlje, da lahko vidi spletno stran. Za to se uporablja protokol HTTP (Hypertext Transfer Protocol).
+
+Povzemimo vso zgodbo. Če želiš imeti svojo spletno stran, moraš torej datoteke, iz katerih je sestavljena, naložiti na poseben računalnik, ki se mu reče *strežnik*. Ko *strežnik* dobi neko *prošnjo* (v pismu), kot odgovor pošlje spletno stran (v drugem pismu).
+
+Since this is a Django tutorial, you might ask what Django does. Ko strežnik pošlje odgovor na prošnjo, ta odgovor ni nujno vedno enak za vsakega uporabnika. Veliko bolje je, če je ta prošnja (pismo) spreminja glede na to, komu je poslana. To bi znalo priti prav zlasti takrat, ko je odgovor namenjen nekomu, ki si mu odgovor poslal nedolgo nazaj. To zveni smiselno, kajne? Django nam bo pomagal delati tovrstna zanimiva pisma, ki se spreminjajo glede na naslovnika. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/sl-SI/html/README.md b/sl-SI/html/README.md
new file mode 100644
index 00000000000..61302f1dea0
--- /dev/null
+++ b/sl-SI/html/README.md
@@ -0,0 +1,227 @@
+# Uvod v HTML
+
+Kaj je predloga?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## Kaj je HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML je kratica za "HyperText Markup Language". **HyperText** pomeni, da gre za vrsto besedila, ki vsebuje povezave (oziroma hiperpovezave) med (spletnimi) stranmi. **Markup** pomeni značka. V jeziku HTML namreč poznamo veliko posebnih značk (oznak), ki brskalnikom povedo, kako oblikovati besedilo, ki neki znački sledi. Vsaka značka se začne z znakom `<`, ki mu sledi ime značke in konča z znakom `>`. Že samo z značkami lahko zgradimo kakršnokoli spletno stran.
+
+## Tvoja prva predloga!
+
+Predloga je torej zgolj HTML datoteka, ki vsebuje nekaj posebnih ukazov (značk) in besedilo.
+
+Vse predloge bomo shranjevali v mapo `blog/templates/blog`. Za začetek moraš torej, znotraj osnovnega imenika blog, ustvariti mapo `templates`. Znotraj te naredi še mapo `blog`:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+Ustvari datoteko `post_list.html` (zaenkrat naj bo prazna) in jo shrani v `blog/templates/blog`.
+
+Zdaj si lahko stran ogledaš na naslovu http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Vsaka spletna stran se deli na dva dela: **head** in **body**.
+
+* **head** je element, ki se ga na strani ne vidi. Kaj točno je njegov namen, bomo videli kasneje.
+
+* **body** je element, ki vsebuje "vidni" del strani. Velik del spletne strani je zgrajen na podlagi kode, ki je znotraj tega elementa.
+
+V elementu `<head>` brskalniku pojasnimo določene lastnosti naše spletne strani, v elementu `<body>` pa opišemo samo vsebino strani.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Shrani datoteko in osveži stran.
+
+![Figure 11.3](images/step4.png)
+
+Si opazila, kako je brskalnik uporabil element title? Besedilo `<title>Ola's blog</title>` je privzel za naslov zavihka, v katerem je odprta tvoja stran.
+
+Kot si verjetno že opazila, vsaki znački oblike <besedilo>, sledi značka oblike `<besedilo/>`. Temu rečemo, da druga značka *zapre* prvo. Opisane pare značk lahko *gnezdimo* (to pomeni, da neke značke ne smemo zapreti, dokler niso zaprte vse značke, ki so znotraj nje).
+
+Predstavljaj si, da imaš veliko škatel, ki jih zlagaš eno v drugo. Največja je `<html></html>`. Znotraj nje položiš `<body></body>` in nato še v slednjo daš nove, manjše škatlice, kot je pri nas `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Spreminjanje predlog
+
+Malce se pozabavaj in svojo predlogo poskusi spremeniti! Tukaj je par uporabnih značk:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>podnaslov</h2>` - za malce manj pomembne naslove
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>besedilo</em>` - za nagnjeno besedilo
+* `<strong>besedilo</strong>` - za odebeljeno besedilo
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` - povezava
+* `<ul><li>prvi element</li><li>drugi element</li></ul>` - za seznam, takšnega kot je ta, ki ga bereš
+* `<div></div>` - za definiranje novega dela spletne strani
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit ne mi porta gravida na eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit ne mi porta gravida na eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Naša stran zdaj zgleda takole:
+
+![Figure 11.4](images/step6.png)
+
+Super! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## Še nekaj: objavimo stran!
+
+Vse narejene spremembe bi si bilo dobro ogledati še na "pravi" spletni strani. Prenesimo spremenjene datoteke na PythonAnywhere:
+
+### Commit, and push your code up to GitHub
+
+Za začetek poglej, katere datoteke so bile spremenjene (na tvojem računalniku, ne na PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Preden boš datoteke naložila, preveri, katere je `git` izbral (le-te bodo zelene barve):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Zagotoviti moramo še, da bo git zabeležil, kakšno spremembo smo naredili. Napisati moramo torej, kaj smo naredili (commit message). Napišeš lahko načeloma karkoli, vendar je zelo priporočljivo, da je opis smiseln, saj boš kasneje na podlagi tega opisa lahko ugotovila in kdaj si naredila določeno spremembo.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Nalaganje spremenjene kode na PythonAnywhere
+
+* Na PythonAnyehere pojdi na del strani, kjer je ukazna vrstica (Bash console). Poženi:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/sl-SI/installation/README.md b/sl-SI/installation/README.md
new file mode 100644
index 00000000000..92e58675fe9
--- /dev/null
+++ b/sl-SI/installation/README.md
@@ -0,0 +1,68 @@
+# Za tiste, ki temu vodiču sledite same
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/sl-SI/intro_to_command_line/README.md b/sl-SI/intro_to_command_line/README.md
new file mode 100644
index 00000000000..70cbbbc472b
--- /dev/null
+++ b/sl-SI/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Osnove dela z ukazno vrstico
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Najprej pa te moramo seznaniti z zelo uporabnim in zabavnim orodjem: ukazno vrstico!**
+
+Nadaljni koraki te bodo seznanili z uporabo črnega okna, ki ga uporablja vsak pravi heker. Sprva deluje malce nenavadno, vendar je dejansko zgolj program, v katerega vpisuješ ustrezne ukaze.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## Kaj je ukazna vrstica?
+
+Okno, ki mu rečemo **ukazna vrstica** ali **ukazna lupina**, je program, ki omogoča raznovrstno delo z datotekami na računalniku, kot je brisanje, pregledovanje, urejanje in dodajanje. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Angleška imena za ukazno vrstico, ki si jih morda že slišala so recimo: *cmd*, *CLI*, *prompt*, *console* in *terminal*.
+
+## Zagon ukazne vrstice
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Ukazna vrstica
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Tvoj prvi ukaz :)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    ana
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Osnove
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Trenutni imenik
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/ana
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Uporabniki\ana
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Rešitev:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Povzetek
+
+Here is a summary of some useful commands:
+
+| Ukaz (Windows) | Ukaz (Mac OS/ Linux) | Opis                                                   | Primer                                             |
+| -------------- | -------------------- | ------------------------------------------------------ | -------------------------------------------------- |
+| izhod          | izhod                | zapri okno                                             | **izhod**                                          |
+| cd             | cd                   | spremeni imenik                                        | **cd test**                                        |
+| cd             | pwd                  | show the current directory                             | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir            | ls                   | izpiši imenike/datoteke, vsebovane v trenutnem imeniku | **dir**                                            |
+| copy           | cp                   | kopiraj datoteko                                       | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move           | mv                   | premakni datoteko                                      | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir          | mkdir                | ustvari nov imenik                                     | **mkdir testniimenik**                             |
+| rmdir (or del) | rm                   | delete a file                                          | **del c:\test\test.txt**                         |
+| rmdir /S       | rm -r                | delete a directory                                     | **rm -r testdirectory**                            |
+| [CMD] /?       | man [CMD]            | get help for a command                                 | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Pripravljena?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/sl-SI/intro_to_command_line/open_instructions.md b/sl-SI/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/sl-SI/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sl-SI/python_installation/README.md b/sl-SI/python_installation/README.md
new file mode 100644
index 00000000000..a4668f8b99d
--- /dev/null
+++ b/sl-SI/python_installation/README.md
@@ -0,0 +1,15 @@
+# Začnimo s programiranjem v Pythonu
+
+Končno!
+
+Za začetek povejmo, kaj Python pravzaprav je. Python je zelo priljubljen programski jezik, ki ga lahko uprabljamo za delanje spletnih strani, igric, računalniške grafike in še mnogih drugih programov.
+
+Python je nastal v poznih 80-ih letih. Njegov glavni namen je, da je prijazen tudi do programerjev (ne le do računalnikov!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Namestitev Pythona
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/sl-SI/python_installation/instructions.md b/sl-SI/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/sl-SI/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/sl-SI/python_introduction/README.md b/sl-SI/python_introduction/README.md
new file mode 100644
index 00000000000..57022fc045a
--- /dev/null
+++ b/sl-SI/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Uvod v Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Pythonova ukazna vrstica
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Prvi ukaz v programske jeziku Python!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Nizi
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ana"
+'Ana'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Pozdravljena " + "Ana"
+'Pozdravljena Ana'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ana" * 3
+'AnaAnaAna'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Spust'li smo eno črko."
+"Spust'li smo eno črko."
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Spust\'li smo eno črko.'
+'Spust'li smo eno črko.'
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ana".upper()
+'ANA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ana")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Povzetek
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Napake
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- Funkcija `str` pretvori poljuben objekt v objekt niz.
+- Funkcija `int` pretvori poljuben objekt v objekt število (**integer** oziroma int)
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Spremenljivke
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ime = "Ana"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ime
+'Ana'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ime = "Anja"
+>>> ime
+'Anja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(ime)
+4
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> mesto = "Ljubljana"
+>>> mseto
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'mseto' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## Funkcija print
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ime = 'Micka'
+>>> ime
+'Micka'
+>>> print(ime)
+Micka
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Seznami
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> loterija = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(loterija)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> loterija.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(loterija)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> loterija.reverse()
+>>> print(loterija)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> loterija.append(199)
+>>> print(loterija)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(loterija[0])
+59
+>>> print(loterija[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(loterija)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(loterija[0])
+59
+>>> loterija.pop(0)
+59
+>>> print(loterija)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Slovarji
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- Ključ `ime` ima vrednost `'Ana'` (`niz`),
+- `država` ima vrednost `'Slovenija'` (ponovno `niz`),
+- ključ `najljubša_števila` pa vrednost `[7, 42, 92]` (`seznam` s tremi elementi).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- So tvoji podatki urejeni (po abecedi, velikosti ipd.). Izberi seznam.
+- Imajo tvoji podatki edinstveno lastnost (ključ), po kateri jih lahko razlikuješ med seboj? Uporabi slovar.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Povzetek
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Primerjanje
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y pomeni: x je večje od y
+- x `<` y pomeni: x je manjše od y
+- x `<=` y pomeni: x je manjše ali enako y
+- x `>=` y means: x je večje ali enako y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Logika
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Shranjevanje!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Zapri tolmač
+- Odpri poljuben urejevalnik programske kode
+- Ustvari novo python datoteko in vanjo napiši nekaj kode
+- Zaženi!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. Tako obarvanje nam lahko zelo pomaga. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). Barve so vsekakor eden izmed razlogov, zakaj uporabljamo urejevalnike. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### Kaj pa, če pogoj ni resničen?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Povzetek
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Funkcije
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Zanke
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Povzetek
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/sl-SI/template_extending/README.md b/sl-SI/template_extending/README.md
new file mode 100644
index 00000000000..e66e9727469
--- /dev/null
+++ b/sl-SI/template_extending/README.md
@@ -0,0 +1,151 @@
+# Razširitev predloge
+
+Še ena lepa stvar, ki jo Django omogoča, je **razširjanje predlog**. Kaj je razširjanje predlog? Razširjanje predlog pomeni, da lahko, na več straneh svoje spletne strani, uporabiš isti del HTML dokumenta.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+Osnovna predloga je najbolj temeljna predloga, iz katere boš kasneje naredila vse ostale strani na svoji spletni strani.
+
+V `blog/templates` ustvari datoteko `base.html`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+V datoteki `base.html` zamenjaj vsebino značke `<body>` (vse med `<body>` in `</body>`) s temle:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). Ne skrbi, kmalu si bomo to pogledali še na primeru.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Takole:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/sl-SI/whats_next/README.md b/sl-SI/whats_next/README.md
new file mode 100644
index 00000000000..e12465cd34a
--- /dev/null
+++ b/sl-SI/whats_next/README.md
@@ -0,0 +1,43 @@
+# Kaj pa zdaj?
+
+Čestitamo! **Genialka si** Zelo smo ponosni! <3
+
+### Kaj pa zdaj?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Kako naprej?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/sl/GLOSSARY.md b/sl/GLOSSARY.md
new file mode 100644
index 00000000000..3c2fa641e9b
--- /dev/null
+++ b/sl/GLOSSARY.md
@@ -0,0 +1,3 @@
+# urejevalnik programske kode
+
+Urejevalnik programske kode je aplikacija, ki ti omogoča urejanje in shranjevanje programske kode. Več o tem v poglavju [Urejevalnik programske kode](./code_editor/README.md)
\ No newline at end of file
diff --git a/sl/README.md b/sl/README.md
new file mode 100644
index 00000000000..7fd55c10949
--- /dev/null
+++ b/sl/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Uvod
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Si se kdaj spraševala, kako bi naredila svojo spletno stran, vendar nisi imela dovolj motivacije, da bi jo dejansko naredila? Se ti je kdaj zdelo, da je svet programiranja zate preveč zapleten?
+
+Imamo dobre novice! Programiranje sploh ni težko! Pravzaprav je zelo zabavno. :)
+
+This tutorial will not magically turn you into a programmer. Če želiš biti v programiranju res dobra, potrebuješ mesece ali pa celo leta vaje. Mi ti želimo le pokazati, da programiranje in izdelava spletnih strani, nista tako zapletena, kot se to sprva zdi. Stvari ti bomo predstavili na preprost in sproščen način, ki pa bo še vseeno dovolj natančen.
+
+Upamo, da ti bo, ko končaš s tem vodičem, svet moderne tehnologije všeč vsaj približno toliko, kot je nam!
+
+## Česa se bomo naučili?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+Zgledal bo (približno) tako:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Naše mentorje in bivše udeležence delavnic smo prosili, da sodelujejo na tem forumu in ti pomagajo, če rabiš pomoč! Nič se ne boj, brez sramu vprašaj za pomoč!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## O avtorjih in razvijalcih
+
+Ta vodič je delo organizacije [DjangoGirls](https://djangogirls.org/). Če najdeš kakršnokoli napako, ali pa če želiš kaj dodati, sledi [navodilom za prispevanje](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/sl/SUMMARY.md b/sl/SUMMARY.md
new file mode 100644
index 00000000000..65c53ee7403
--- /dev/null
+++ b/sl/SUMMARY.md
@@ -0,0 +1,27 @@
+# Povzetek
+
+* [Uvod](README.md)
+* [Namestitev](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [Kako deluje internet](how_the_internet_works/README.md)
+* [Osnove dela z ukazno vrstico](intro_to_command_line/README.md)
+* [Namestitev Pythona](python_installation/README.md)
+* [Urejevalnik programske kode](code_editor/README.md)
+* [Uvod v Python](python_introduction/README.md)
+* [Kaj je Django?](django/README.md)
+* [Namestitev Djanga](django_installation/README.md)
+* [Tvoj prvi Django projekt!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Postavitev!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Uvod v HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Djangove predloge](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Razširitev predloge](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django obrazci](django_forms/README.md)
+* [Kaj pa zdaj?](whats_next/README.md)
\ No newline at end of file
diff --git a/sl/chromebook_setup/README.md b/sl/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/sl/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/sl/chromebook_setup/instructions.md b/sl/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/sl/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/sl/code_editor/README.md b/sl/code_editor/README.md
new file mode 100644
index 00000000000..edd3117719a
--- /dev/null
+++ b/sl/code_editor/README.md
@@ -0,0 +1,11 @@
+# Urejevalnik programske kode
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+Si tik pred tem, da napišeš svoj prvi program, zato je čas, da namestiš urejevalnik programske kode!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/sl/code_editor/instructions.md b/sl/code_editor/instructions.md
new file mode 100644
index 00000000000..8d1bae65171
--- /dev/null
+++ b/sl/code_editor/instructions.md
@@ -0,0 +1,31 @@
+Obstaja veliko različnih urejevalnikov programske kode. Izbira je bolj ali manj stvar okusa. Python programerji običajno uporabljajo zmogljiva integrirana razvojna okolja (IDE - Integrated Development Environment) kot je PyCharm. Kot začetnici ti uporabe teh okolij ne priporočamo, saj so za tvoje potrebe dovolj preprostejši urejevalniki, ki so prav tako zmogljivi, vendar precej prijaznejši za uporabo.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit je odprtokoden, brezplačen urejevalnik, ki je na voljo za vse operacijske sisteme.
+
+[Naložiš ga tukaj](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Naložiš ga tukaj](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Naložiš ga tukaj](https://atom.io/)
+
+## Zakaj potrebujemo urejevalnik programske kode?
+
+Verjetno se sprašuješ, zakaj želimo, da namestiš urejevalnik programske kode, namesto, da bi uporabila katerega izmed navadnih in bolj poznanih urejevalnikov besedila, kot sta Word in Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/sl/css/README.md b/sl/css/README.md
new file mode 100644
index 00000000000..5057b65fbd0
--- /dev/null
+++ b/sl/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Naš blog zaenkrat nima ravno elegantnega videza. Čas je, da ga polepšamo! Uporabili bomo CSS.
+
+## Kaj je CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Uporabimo Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Namestitev Bootstrapa
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Malo bolje je že!
+
+## Djangove statične datoteke
+
+Podrobneje si poglejmo že omenjene, famozne **statične datoteke**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Kje v Djangu živijo statčne datoteke
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+To narediš tako, da, znotraj aplikacije blog, ustvariš nov imenik z imenom `static`:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Prvi koraki v jeziku CSS!
+
+Let's create a CSS file now, to add your own style to your web page. Najprej naredi nov imenik z imenom `css`, v njem pa še enega z imenom `static`. Nato znotraj imenika `css` ustvari novo css datoteko `blog.css`. Pripravljena?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Končno lahko začnemo s pisanjem CSS kode! V svojem urejevalniku odpri prej ustvarjeno datoteko `blog/static/css/blog.css`.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+Malce pa si vseeno poglejmo že zdaj. Si želiš recimo spremeniti barvo glave tvojega bloga? Za barve računalniki uporabljajo posebne kode. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. Obstajajo pa tudi [vnaprej določene barve](http://www.w3schools.com/colors/colors_names.asp), ki jih lahko opišeš kar z angleškimi imeni, kot recimo `red` za rdečo in `green` za zeleno.
+
+V datoteko `blog/static/css/blog.css` dodaj sledečo kodo:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` je oznaka, ki pove, kateri del HTML kode želimo s CSS kodo, ki oznaki sledi, spremeniti. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. Koda, ki je znotraj zavitih oklepajev, bo spremenila barvo pisave v `#FCA205`, ki je odtenek oranžne. Barvo lahko seveda izbereš tudi po lastnem okusu!
+
+V datoteki CSS bomo torej določili slog za vsak del HTML kode. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class in id sta oznaki, ki ju za nek element določiš sama. Oznaka class opisuje skupino značk, id pa le eno samo značko. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. S tem smo predlogi uspešno povedali, kje živi naš CSS. :)
+
+Naša CSS datoteka trenutno zgleda takole:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, datoteko shrani in v brskalniku osveži spletno stran!
+
+![Figure 14.2](images/color2.png)
+
+Odlično! Dodajmo strani še malo zamika na levi in desni.
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Kako pa bi spremenili vrsto pisave našega besedila? Znotraj značke `<head>` v datoteki `blog/templates/blog/post_list.html` dodaj:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Odlično!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Poimenuj par delov svoje HTML kode. Za začetek dodaj razred z imenom `glava` znački `div`, ki vsebuje glavo spletne strani.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+Znački `div`, ki vsebuje objavo na blogu, dodaj razred `objava`.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+Zdaj lahko opisanim delom strani dodamo CSS kodo, ki bo določala oblikovanje le-teh. Koda, ki opisuje določen razred, se bo vedno začela z znakom `.` in takoj zatem imenom razreda. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. Za nas pa bo zaenkrat zadoščalo zgolj prekopiranje sledeče kode v datoteko `blog/static/css/blog.css`.
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Dodane CSS razrede moramo dodati še v našo HTML kodo. Zamenjaj tale del kode:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+, ki se nahaja v datoteki `blog/templates/blog/post_list.html`, s sledečo kodo:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Shrani datoteko in osveži spletno stran.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Pripravljena na naslednje poglavje?! :)
\ No newline at end of file
diff --git a/sl/deploy/README.md b/sl/deploy/README.md
new file mode 100644
index 00000000000..627b073cfc3
--- /dev/null
+++ b/sl/deploy/README.md
@@ -0,0 +1,260 @@
+# Postavitev!
+
+> **Opomba** Nekatera mesta tega poglavja se vam bodo morda zdela zahtevna. Ne vrzite puške v koruzo in se prebijte do konca; postavitev je pomemben korak v razvoju spletne strani. To poglavje se nahaja na sredini vodiča, zato da vam lahko vaš mentor oz. mentorica pomaga pri zahtevnejših korakih objave spletne strani. Tako lahko vodič končate tudi sami, če bi vam slučajno zmanjkalo časa.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Postavitev pomeni objaviti vašo aplikacijo na spletu, da bodo ljudje lahko končno uvideli vašo aplikacijo. :)
+
+Sedaj že veste, da mora biti spletna stran na strežniku. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+Pri postavitvi bomo uporabili še eno zunanjo storitev: [GitHub](https://www.github.com) - storitev za gostovanje kode. Seveda so na voljo tudi druge rešitve, a večina programerjev ima GitHub račun. In sedaj ga imate tudi vi!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Ustvarimo Git repozitorij
+
+Git sledi sprememba določenemu naboru datotek, ki ga imenujemo repozitorij kode (ali na kratko "repo"). Ustvarimo repozitorij za naš projekt. Odprite upravljalnik in v imeniku `djangogirls` zaženite te ukaze:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. Nahajati se morate v mapi `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Inicializir prazen Git repozitorij v ~/djangogirls/.git/
+    $ git config --global user.name "Vaše ime"
+    $ git config --global user.email vaš.naslov@primer.si
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git sledi spremembam datotek in map v tem imeniku. Kaj pa če želimo, da sistem ne sledi spremembam določenih datotek? V izvirnem imeniku ustvarimo datoteko `.gitignore`. Odprite urejevalnik in ustvarite novo datoteko s sledečo vsebino:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Opomba** Ne pozabite pike na začetku imena, saj je pomembna! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+Dobra navada je, da zaženete ukaz `git status` preden zaženete `git add` oziroma ne veste, kaj je bilo spremenjeno. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Na koncu shranimo spremembe. V vašem upravljalniku zaženite te ukaze:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Pojdite na spletno stran in se prepričajte!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Prenesimo kodo iz spletnega mesta GitHub, tako da ustvarimo "klon" repozitorija. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. S statičnimi datotekami se bomo podrobneje seznanili v nadaljevanju, ko bomo urejali CSS datoteko za našo stran.
+
+Pritisnite **Save** in pojdite nazaj na zavihek **Web**.
+
+To je to! Pritisnite gumb **Reload** in lahko si boste ogledali vašo aplikacijo. Na vrhu strani se bo pojavila povezava od strani.
+
+## Nasveti za razhroščevanje
+
+Če opazite napako, ko greste na vašo spletno stran, je prvi naslov za razhroščevanje **error log**. Povezavo najdete v zavihku [Web](https://www.pythonanywhere.com/web_app_setup/) na PythonAnywhere. Preverite, ali je zabeleženo kakšno sporočilo o napakah; novejše so na dnu. Pogoste napake so:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Ali sta različici Pythona v virtualnem okolju in spletni aplikaciji enaki? Obe morata biti 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+Vedno pa se lahko obrnete na vašega mentorja!
+
+# Aplikacija je v etru!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Poizkusite dodati `/admin/` na koncu URL-ja in prikazati se morala admin stran. Prijavite se z uporabniškim imenom in geslom. Sedaj lahko dodajate nove objave na strežniku.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Dajte si *VELIK* aplavz! Postavitev na strežnik je med najzahtevnejšimi koraki spletnega razvoja in nemalokrat traja več dni, preden deluje, tako kot mora. Vam pa je uspelo zagnati spletno stran, kar tako!
\ No newline at end of file
diff --git a/sl/deploy/install_git.md b/sl/deploy/install_git.md
new file mode 100644
index 00000000000..c16ce3f9418
--- /dev/null
+++ b/sl/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git je "sistem za porazdeljeno dokumentiranje sprememb in izdajanje različic datotek", ki ga uporablja veliko programerjev. Ta programska oprema sledi spremembam v vaših datotekah, kar vam omogoča, da lahko v nadaljevanju prikličete prejšnje različice. Delovanje je podobno "Sledi spremembam" v programu Microsoft Word, vendar veliko bolj zmogljivo.
+
+## Namestitev Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Sistem za porazdeljeno dokumentiranje sprememb in izdajanje različic datotek oz. Git lahko prenesete iz spletnega mesta [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Sicer pa so privzete nastavitve v redu. Ukaz checkout v Windows slogu in ukaz commit v Unix slogu je dobra izbira.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Git prenesite iz spletnega mesta [git-scm.com](https://git-scm.com/) in sledite navodilom.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sl/deploy/signup_pythonanywhere.md b/sl/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/sl/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/sl/django/README.md b/sl/django/README.md
new file mode 100644
index 00000000000..16c0b3616d2
--- /dev/null
+++ b/sl/django/README.md
@@ -0,0 +1,27 @@
+# Kaj je Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. Ogrodje je skupek že napisanih programov, ki ti pomagajo spletne strani graditi hitreje in lažje.
+
+Kot si opazila, obstajajo določeni gradniki, ki jih ima vsaka spletna stran: sistem za registriranje, plošča za upravljanje spletne strani, kontaktni obrazec, sistem za nalaganje datotek in podobno.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Zakaj potrebujemo ogrodja?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Predstavljaj si nabiralnik, ki čaka na prejeta pisma. Točno to počno spletni strežniki. The web server reads the letter and then sends a response with a webpage. Ta spletna stran pa mora jasno imeti neko vsebino. Pri ustvarjanju le-te, ti bo pomagal Django.
+
+## Kaj se zgodi, ko nekdo od našega strežnika zahteva spletno stran?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Predstavljaj si poštarja, ko dostavlja pismo. Ko hodi po ulici, da bi ga dostavil, mora za vsak naslov preveriti, če je isti, kot tisti na pismu. Ko najde pravi naslov, pismo tam odloži. Django deluje povsem enako!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Recimo, da želi uporabnik spremeniti svoje podatke, ki jih imamo shranjene v bazi. Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Zgornji opis je resda malce poenostavljen, vendar pa povzame vse tisto, kar moraš zaenkrat vedeti.
+
+Zdaj vemo dovolj, da se lahko začnemo ukvarjati z razvijanjem aplikacije. Vse ostale pomembne stvari bomo povedali sproti.
\ No newline at end of file
diff --git a/sl/django_admin/README.md b/sl/django_admin/README.md
new file mode 100644
index 00000000000..a9ce9cd5012
--- /dev/null
+++ b/sl/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Kot vidiš, smo uvozili paket Post o katerem smo govorili v prejšnjem poglavju. Če hočemo, da bomo podatki, ki jih bomo s paketom Post ustvarili vidni, ga moramo registrirati z `admin.site.register(Post)`.
+
+OK, zdaj si lahko bolj podrobno ogledamo Post. Ne pozabi v ukazni vrstici pognati ukaza `python manage.py runserver`. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/sl/django_forms/README.md b/sl/django_forms/README.md
new file mode 100644
index 00000000000..65d1d953464
--- /dev/null
+++ b/sl/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django obrazci
+
+Naš zadnji korak je ustvariti enostaven način za dodajanje in urejanje vnosov. `Admin` v Django je odličen, ampak težko prilagodljiv. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+Z obrazci Django lahko definiramo povsem nov obrazec ali pa ustvarimo `ModelForm`, ki vnos v obrazec shrani v model.
+
+To pa je naravnost to, kar želimo storiti: ustvarili bomo obrazec za našo objavo - `Post`.
+
+Kot vsi ključni deli ogrodja Django so tudi obrazci v svoji datoteki: `forms.py`.
+
+V imeniku `Blog` ustvarimo datoteko s tem imenom.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Najprej uvozimo obrazce Django (`from django import forms`) in nato pričakovano naš model za `Post` (`from .models import Post`).
+
+Kot ste najbrž že uganili je `PostForm` ime našega obrazca. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Nato definiramo `class Meta`, kjer določimo model, ki bo podlaga za naš obrazec (`model = Post`).
+
+Na koncu še določimo polje oziroma polja, ki jih bodo v našem obrazcu. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+To je vse! Edino kar nam sedaj še preostane je, da obrazec uporabimo v *view* in ga prikažemo v predlogi.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Povezava do strani z obrazcem
+
+Čas je da odpremo `blog/templates/blog/base.html`. Dodali bomo elemnt `div`, ki ga bomo poimenovali `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Sedaj ste shranili in osvežili stran na naslovu http://127.0.0.1:8000 in ponovno se je pojavila dobro znana `NoReverseMatch`.
+
+## URL
+
+Odprite `blog/urls.py` in dodajte to vrstico:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+Vaša koda je seda:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Odprite datoteko `blog/views.py` in vpišite spodnje vrstice skupaj z vrsticami `from`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Če želite ustvariti nov obrazec `Post`, moramo zagnati `PostForm()` in ga posredovati predlogi. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Predloga
+
+Ustvariti v imeniku `blog/templates/blog` ustvarite datoteko `post_edit.html`. Da bo obrazec deloval, moramo narediti naslednje:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* Zgornjo vrstico je potrebno oviti s HTML oznako za obrazec: `<form method="POST">...</form>`.
+* Potrebujemo še gumb `Shrani`. Za to uporabimo kar gumb HTML `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. S tem zavarujemo naš obrazec! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Osvežite stran! To! Vaš obrazec se pravilno prikaže!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+Odgovor: nikjer. Potrebno bo dopolniti funkcijo *view*.
+
+## Shranjevanje obrazca
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? Vsa polja obrazca so sedaj v `request.POST`. Ne preimenujte `post` (edina druga dovoljena `metoda` je `GET` - žal nimamo časa, da bi se poglobili v razlike).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. Da bi naša funkcija pravilno razrešila obe situacijo moramo dodati pogoj (uporabili bomo `if`):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+Preverimo, ali je obrazec veljaven. Če je, lahko shranimo podatke!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Opravka imamo z dvema zadevama: obrazec shranimo z `form.save`, dodamo avtorja (ker v `PostForm` nimamo polja `author` in je to polje obvezno). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/sl/django_installation/README.md b/sl/django_installation/README.md
new file mode 100644
index 00000000000..6bc17d5ab2c
--- /dev/null
+++ b/sl/django_installation/README.md
@@ -0,0 +1,7 @@
+# Namestitev Djanga
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/sl/django_installation/instructions.md b/sl/django_installation/instructions.md
new file mode 100644
index 00000000000..fbf262f9ac6
--- /dev/null
+++ b/sl/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Vodič django-marcador tutorial je avtorsko delo Markus Zapke-Gründemann et al.
+
+## Virtualno okolje
+
+Preden namestiš Django, se boš seznanila z zelo uporabnim orodjem, ki ti bo omogočilo vzpostavitev urejenega delovnega prostora. Ta korak sicer ni obvezen, vendar pa je zelo priporočljiv. Uporaba virtualnega okolja nam dolgoročno prihrani veliko težav!
+
+Ustvarimo torej **virtualno okolje** (angl. virtual environment ali *virtualenv*). Navidezno/virtualno okolje bo omejilo spremembe, ki jih bomo naredili v Pythonu in Djangu, le na naš projekt. To pomeni, da omenjene spremembe ne bodo vplivale na noben drug projekt, ki ga imaš morda tudi na računalniku. To se zdi smiselno.
+
+Za začetek najdi imenik, v katerem želiš ustvariti `virtualno okolje`. Recimo tvoj domači imenik. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+V tem vodiču bomo v tvojem domačen imeniku ustvarili nov imenik `djangogirls`:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Zdaj bomo ustvarili navidezno okolje `myvenv`. Splošen ukaz zgleda nekako takole:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. Ubistvu si lahko zmisliš katerokoli ime, ki vsebuje le male črke in ne vsebuje presledkov, naglasov in podobnih posebnih znakov. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+myvenv je ime tvojega virtualnega okolja. Ubistvu si lahko zmisliš katerokoli ime, ki vsebuje le male črke in ne vsebuje presledkov, naglasov in podobnih posebnih znakov. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To lahko rešiš tako, da raje uporabiš ukaz `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Delo z virtualnim okoljem
+
+S prejšnjimi ukazi si ustvarila imenik z imenom `myvenv` (oziroma z imenom, ki si ga izbrala sama), ki predstavlja virtualno okolje (v bistvu je to zgolj kup imenikov in datotek).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Virtualno okolje zaženeš takole:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Virtualno okolje zaženeš takole:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Ne pozabi nadomestiti imena `myvnev` z imenom, ki se ga izbrala!
+
+> **OPOMBA:** če `source` noče delovati, poskusi naslednje:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+Ko delaš z virtualnim okoljem, je privzeta različica `pythona` enaka tisti, ki jo ima virtualno okolje. Zato lahko vedno uporabljaš ukaz `python` namesto `python3`.
+
+OK, teren je pripravljen. Končno lahko namestimo Django!
+
+## Namestitev Djanga
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> Če dobiš napako, ko zaženeš ukaz pip na operacijskem sistemu Ubuntu 12.04, poženi ukaz `python -m pip install -U --force-reinstall pip`.
+
+<!--endsec-->
+
+To je to! Zdaj si (končno) pripravljena, da narediš svojo Django aplikacijo!
\ No newline at end of file
diff --git a/sl/django_models/README.md b/sl/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/sl/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/sl/django_orm/README.md b/sl/django_orm/README.md
new file mode 100644
index 00000000000..4940e4e883c
--- /dev/null
+++ b/sl/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM in QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/sl/django_start_project/README.md b/sl/django_start_project/README.md
new file mode 100644
index 00000000000..78d90e7c6d2
--- /dev/null
+++ b/sl/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Tvoj prvi Django projekt!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Vodič django-marcador tutorial je avtorsko delo Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+Za začetek ustvarimo nov Django projekt. To bomo naredili s pomočjo programčka, ki smo ga dobili ob namestitvi Djanga. Ustvaril nam bo nekaj imenikov in datotek, ki nam bodo omogočile lažji in hitrejši začetek.
+
+Imena nekaterih imenikov in datotek so Djangu zelo pomembna. Zato datotek, ki jih bomo v nadaljevanju ustvarili, ne preimenuj. Prav tako jih raje ne premikaj. Django ima namreč za veliko datotek v spominu shranjeno, kje približno se nahajajo in kako se jim reče, zato ga lahko s spremembami zmedemo.
+
+> Ne pozabi, da moraš projekt delati znotraj virtualnega okolja. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. Kako se to naredi smo podrobno pojasnili v poglavjih **Namestitev Djanga** in **Osnove dela z ukazno vrstico**. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Pika je pomembna, ker programu pove, da mora v trenutni imenik (okrajšava zanj je .) namestiti Django).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Pika je pomembna, ker programu pove, da mora v trenutni imenik (okrajšava zanj je .) namestiti Django).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` je program, ki bo zate naredil nekaj imenikov in datotek. Recimo takih:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+`settings.py` vsebuje podatke o nastavitvah naše spletne strani.
+
+`urls.py` pove, kateri del spletne strani naj se pokaže, ko v brskalnik vpišemo določen url naslov.
+
+Ostale datoteke zaenkrat prezrimo, saj jih ne bomo rabili spreminjati. Nikakor pa jih ne spreminjaj ali briši!
+
+## Spreminjanje nastavitev
+
+Malce bomo spremenili datoteko `mysite/settings.py`. Odpri jo v urejevalniku programske kode, ki si ga prej namestila.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+Na naši strani bi bilo dobro imeti pravilen čas in datum. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+Obstaja veliko različne programske opreme, ki lahko shranjuje podatke za našo stran (taki programski opremi rečemo podatkovna baza). Uporabili bomo privzeto, `sqlite3`.
+
+Kot lahko opazimo v `mysite/settings.py`, je sqlite3 že nastavljena:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Podatkovno bazo bomo ustvarili z ukazom: `python manage.py migrate` (biti moramo v imeniku `djangogirls`, saj le ta vsebuje datoteko `manage.py`). Pokazati se mora nekaj takšnega:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+Končano! Zdaj lahko zaženemo strežnik in se prepričamo, da naša stran deluje!
+
+## Starting the web server
+
+Biti moraš v imeniku `djangogirls`, saj le ta vsebuje datoteko `manage.py`. Strežnik zaženeš tako, da v ukazno vrstico vpišeš `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+Če si na Windowsih in dobiš napako `UnicodeDecodeError`, uporabi sledečo različico prejšnjega ukaza:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Čestitke! Naredila si svojo prvo spletno stran na svojem lastnem strežniku!
+
+![Deluje!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Si pripravljena na naslednje poglavje? Čas je, da na našo stran kaj napišemo!
\ No newline at end of file
diff --git a/sl/django_templates/README.md b/sl/django_templates/README.md
new file mode 100644
index 00000000000..59999efdaa5
--- /dev/null
+++ b/sl/django_templates/README.md
@@ -0,0 +1,106 @@
+# Djangove predloge
+
+Vstavimo na spletno stran nekaj besedila! Django nam pri tem izdatno pomaga z značkami **template**.
+
+## Kaj so značke template?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Prikazovanje objav na blogu
+
+V prejšnjem poglavju smo seznam objav shranili v spremenljivko `posts`. Te objave moramo še prikazati kot HTML.
+
+Za izpis spremenljivke v Djangovih predlogah bomo uporabili zavite oklepaje, znotraj njih pa bomo dali spremenljivko:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Naredi to v predlogi `blog/templates/blog/post_list.html`. Vso kodo med drugo značko `<div>` in tretjo značko `</div>` z `{{ posts }}`. Datoteko shrani, osveži stran in si oglej rezultate:
+
+![Figure 13.1](images/step1.png)
+
+Vse, kar smo dobili, je tole:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Django torej našo spremenljivko razume kot seznam objektov. Se še spomniš, kako se v Pythonu izpiše elemente seznama? Prav si uganila. Z zanko! V predlogah zanko narediš takole:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Preizkusi to še v svoji predlogi.
+
+![Figure 13.2](images/step2.png)
+
+Deluje! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. K sreči se izkaže, da lahko v značke template dodajamo tudi HTML kodo. `body` bo zdaj zgledal takole:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Vsa koda, ki je med `{% for %}` in `{% endfor %}` se bo ponovila za vsak objekt v seznamu. Osveži svojo stran:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? Razlika je v tem, da dostopamo do različnih delov naše baze podatkov `Post`. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## Še nekaj
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* Za začetek kodo prenesimo na Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Nato se ponovno prijavi v [Pythona nAnywhere](https://www.pythonanywhere.com/consoles/), pojdi na **Bash console**(ali pa odpri novo) in zaženi:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Za konec se premakni na [Web tab](https://www.pythonanywhere.com/web_app_setup/) in v svoji aplikaciji pritisni **Reload**. Najnovejša verzija tvoje strani je objavljena! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Čestitke! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/sl/django_urls/README.md b/sl/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/sl/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/sl/django_views/README.md b/sl/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/sl/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/sl/dynamic_data_in_templates/README.md b/sl/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/sl/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/sl/extend_your_application/README.md b/sl/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/sl/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/sl/how_the_internet_works/README.md b/sl/how_the_internet_works/README.md
new file mode 100644
index 00000000000..2d3eb7609df
--- /dev/null
+++ b/sl/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Kako deluje internet
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+Si vedela, da je spletna stran zgolj množica datotek, shranjenih na trdem disku ? Povsem enako kot tvoje slike, glasba in filmi. Posebnost datotek, ki sestavljajo spletno stran, je le, da vsebujejo programsko kodo, ki ji rečemo HTML.
+
+Če še nisi nikoli programirala, se to morda sliši malce nenavadno, vendar pa spletni brskalniki (kot so Chrome, Safari, Firefox ipd.), programsko kodo HTML obožujejo. Narejeni so namreč tako, da to kodo razumejo. Razbrati znajo napisane ukaze, ki jih koda vsebuje, in po njihovih navodilih prikazati spletno stran.
+
+Kot vsako datoteko, moramo tudi HTML datoteke shraniti na trdi disk računalnika. Računalnikom, na katerih so shranjene spletne strani, rečemo *strežniki*. Strežniki nimajo ekrana, miške in tipkovnice, saj je njihov glavni namen shraniti podatki in omogočiti, da si z njimi lahko postrežemo. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+Narisali smo ti sliko! Internet deluje nekako tako:
+
+![Figure 1.1](images/internet_1.png)
+
+Nenavadno, kajne? In fact it is a network of connected machines (the above-mentioned *servers*). Na milijone računalnikov! Ogromna mreža kablov, razpredena po celem svetu! Obiščeš lahko spletno stran Cable Map (http://submarinecablemap.com). Tam boš videla, kako zapletena mreža je internet. Tule je slika iz njihove spletne strani:
+
+![Figure 1.2](images/internet_3.png)
+
+Fascinantno! Vendar pa jasno tvoj računalnik ne more biti s kabli povezan z vsemi strežniki, ki so povezani na internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+Nekako tako:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+To pismo gre na najbližjo pošto, od tod gre na pošto, ki je še nekoliko bližje želenemu naslovu in tako nadaljuje, dokler ne pride do želenega naslova. Edina razlika, če primerjamo to pošiljanje s pošiljanjem v internetu je, da v internetu dejansko pošljemo več pisem (*podatkovnih paketov*) na isto pošto (strežnik). Ta pisma pa gredo lahko do končnega naslova (strežnika) skozi povsem različne pošte (*omrežne usmerjevalnike*). 
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Namesto običajnega naslova, ki vsebuje naslov ulice, poštno številko in ime države, v računalništvu uporabljamo IP naslov, ki predstavlja naslov računalnika. Tvoj računalnik bo, ko vidi naslov djangogirls.org, s pomočjo sistema DNS (Domain Name System), ta naslov pretvoril v IP. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Napisati pa ga moraš jasno v jeziku, ki ga naslovnik razume. Enako velja za *podatkovne pakete*, ki jih računalnik pošlje, da lahko vidi spletno stran. Za to se uporablja protokol HTTP (Hypertext Transfer Protocol).
+
+Povzemimo vso zgodbo. Če želiš imeti svojo spletno stran, moraš torej datoteke, iz katerih je sestavljena, naložiti na poseben računalnik, ki se mu reče *strežnik*. Ko *strežnik* dobi neko *prošnjo* (v pismu), kot odgovor pošlje spletno stran (v drugem pismu).
+
+Since this is a Django tutorial, you might ask what Django does. Ko strežnik pošlje odgovor na prošnjo, ta odgovor ni nujno vedno enak za vsakega uporabnika. Veliko bolje je, če je ta prošnja (pismo) spreminja glede na to, komu je poslana. To bi znalo priti prav zlasti takrat, ko je odgovor namenjen nekomu, ki si mu odgovor poslal nedolgo nazaj. To zveni smiselno, kajne? Django nam bo pomagal delati tovrstna zanimiva pisma, ki se spreminjajo glede na naslovnika. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/sl/html/README.md b/sl/html/README.md
new file mode 100644
index 00000000000..5c98642be18
--- /dev/null
+++ b/sl/html/README.md
@@ -0,0 +1,213 @@
+# Uvod v HTML
+
+Kaj je predloga?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## Kaj je HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML je kratica za "HyperText Markup Language". **HyperText** pomeni, da gre za vrsto besedila, ki vsebuje povezave (oziroma hiperpovezave) med (spletnimi) stranmi. **Markup** pomeni značka. V jeziku HTML namreč poznamo veliko posebnih značk (oznak), ki brskalnikom povedo, kako oblikovati besedilo, ki neki znački sledi. Vsaka značka se začne z znakom `<`, ki mu sledi ime značke in konča z znakom `>`. Že samo z značkami lahko zgradimo kakršnokoli spletno stran.
+
+## Tvoja prva predloga!
+
+Predloga je torej zgolj HTML datoteka, ki vsebuje nekaj posebnih ukazov (značk) in besedilo.
+
+Vse predloge bomo shranjevali v mapo `blog/templates/blog`. Za začetek moraš torej, znotraj osnovnega imenika blog, ustvariti mapo `templates`. Znotraj te naredi še mapo `blog`:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+Ustvari datoteko `post_list.html` (zaenkrat naj bo prazna) in jo shrani v `blog/templates/blog`.
+
+Zdaj si lahko stran ogledaš na naslovu http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+Napake ni več! Čestitke :) Vendar pa je naša stran zaenkrat še precej dolgočasna, saj ni na njej nič objavljenega. Zdaj je končno prišel čas, da to spremenimo.
+
+V predlogo dodaj sledečo kodo:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+Deluje! Odlično :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. Vsa preostala koda, ki jo bomo pisali, bo torej med tema dvema značkama
+* `<p>` označuje začetek novega odstavka, `</p>` pa konec
+
+## Head and body
+
+Vsaka spletna stran se deli na dva dela: **head** in **body**.
+
+* **head** je element, ki se ga na strani ne vidi. Kaj točno je njegov namen, bomo videli kasneje.
+
+* **body** je element, ki vsebuje "vidni" del strani. Velik del spletne strani je zgrajen na podlagi kode, ki je znotraj tega elementa.
+
+V elementu `<head>` brskalniku pojasnimo določene lastnosti naše spletne strani, v elementu `<body>` pa opišemo samo vsebino strani.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Shrani datoteko in osveži stran.
+
+![Figure 11.3](images/step4.png)
+
+Si opazila, kako je brskalnik uporabil element title? Besedilo `<title>Ola's blog</title>` je privzel za naslov zavihka, v katerem je odprta tvoja stran.
+
+Kot si verjetno že opazila, vsaki znački oblike <besedilo>, sledi značka oblike `<besedilo/>`. Temu rečemo, da druga značka *zapre* prvo. Opisane pare značk lahko *gnezdimo* (to pomeni, da neke značke ne smemo zapreti, dokler niso zaprte vse značke, ki so znotraj nje).
+
+Predstavljaj si, da imaš veliko škatel, ki jih zlagaš eno v drugo. Največja je `<html></html>`. Znotraj nje položiš `<body></body>` in nato še v slednjo daš nove, manjše škatlice, kot je pri nas `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Spreminjanje predlog
+
+Malce se pozabavaj in svojo predlogo poskusi spremeniti! Tukaj je par uporabnih značk:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>podnaslov</h2>` - za malce manj pomembne naslove
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>besedilo</em>` - za nagnjeno besedilo
+* `<strong>besedilo</strong>` - za odebeljeno besedilo
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` - povezava
+* `<ul><li>prvi element</li><li>drugi element</li></ul>` - za seznam, takšnega kot je ta, ki ga bereš
+* `<div></div>` - za definiranje novega dela spletne strani
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit ne mi porta gravida na eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit ne mi porta gravida na eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+V zgornji predlogi smo ustvarili tri elemente `div`.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Drugi dva `div`-a vsebujeta objave na blogu z datumi objave, naslovi in vsebino objav.
+
+Naša stran zdaj zgleda takole:
+
+![Figure 11.4](images/step6.png)
+
+Super! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## Še nekaj: objavimo stran!
+
+Vse narejene spremembe bi si bilo dobro ogledati še na "pravi" spletni strani. Prenesimo spremenjene datoteke na PythonAnywhere:
+
+### Nalaganje kode na Github
+
+Za začetek poglej, katere datoteke so bile spremenjene (na tvojem računalniku, ne na PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Prepričaj se, da si res v imeniku `djangogirls` in naroči `gitu`, da sporoči vse spremembe, ki so se zgodile znotraj tega imenika:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Ne pozabi (poglavje 3), da je `.` oznaka za trenutni imenik.
+
+Preden boš datoteke naložila, preveri, katere je `git` izbral (le-te bodo zelene barve):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Zagotoviti moramo še, da bo git zabeležil, kakšno spremembo smo naredili. Napisati moramo torej, kaj smo naredili (commit message). Napišeš lahko načeloma karkoli, vendar je zelo priporočljivo, da je opis smiseln, saj boš kasneje na podlagi tega opisa lahko ugotovila in kdaj si naredila določeno spremembo.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Opomba:** Pri besedilo v git-u moraš vedno uporabiti dvojne narekovaje.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Nalaganje spremenjene kode na PythonAnywhere
+
+* Na PythonAnyehere pojdi na del strani, kjer je ukazna vrstica (Bash console). Poženi:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+Koda se zdaj nalaga na strežnik. Če želiš preveriti, ali se je že naložila, pojdi na **zavihek Files**in si oglej kodo.
+
+* Premakni se zdaj na zavihek [Web](https://www.pythonanywhere.com/web_app_setup/) in pritisni **Reload**.
+
+Tvoje spremembe so zdaj javno obavljene! Osveži stran in si jo oglej. Spremembe bi morale biti vidne. :)
\ No newline at end of file
diff --git a/sl/install_git.md b/sl/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/sl/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sl/installation/README.md b/sl/installation/README.md
new file mode 100644
index 00000000000..d79602fe6da
--- /dev/null
+++ b/sl/installation/README.md
@@ -0,0 +1,58 @@
+# Za tiste, ki temu vodiču sledite same
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+Vsa nadaljna navodila so namreč že del vodiča. To je le stran, na kateri so skupaj zbrana vsa navodila za namestitev. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Vso srečo!
+
+# Namestitev
+
+Na delavnici boš naredila svoj blog. Ker je izdelava le-tega kar dolga, bi bilo super, če že pred delavnico namestiš par reči, saj boš tako lahko, na dan delavnice, takoj začela s programiranjem.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Namestitev programskega jezika Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Vzpostavitev virtualnega okolja in namestitev orodja Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Namestitev urejevalnika programske kode
+
+{% include "/code_editor/instructions.md" %}
+
+# Namestitev sistema Git
+
+{% include "/deploy/install_git.md" %}
+
+# Ustvarjanje GitHub računa
+
+Pojdi na [GitHub.com](https://www.github.com) in si ustvari nov, brezplačen račun.
+
+# Ustvarjanje PythonAnywhere računa
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Začni z branjem
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [Kako deluje internet](../how_the_internet_works/README.md)
+
+* [Uvod v ukazno vrstico](../intro_to_command_line/README.md)
+
+* [Uvod v Python](../python_introduction/README.md)
+
+* [Kaj je Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/sl/instructions.md b/sl/instructions.md
new file mode 100644
index 00000000000..30bd493b11b
--- /dev/null
+++ b/sl/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command dnf is not found. In that case you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/sl/intro_to_command_line/README.md b/sl/intro_to_command_line/README.md
new file mode 100644
index 00000000000..d4d4cfff5eb
--- /dev/null
+++ b/sl/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Osnove dela z ukazno vrstico
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Najprej pa te moramo seznaniti z zelo uporabnim in zabavnim orodjem: ukazno vrstico!**
+
+Nadaljni koraki te bodo seznanili z uporabo črnega okna, ki ga uporablja vsak pravi heker. Sprva deluje malce nenavadno, vendar je dejansko zgolj program, v katerega vpisuješ ustrezne ukaze.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## Kaj je ukazna vrstica?
+
+Okno, ki mu rečemo **ukazna vrstica** ali **ukazna lupina**, je program, ki omogoča raznovrstno delo z datotekami na računalniku, kot je brisanje, pregledovanje, urejanje in dodajanje. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Angleška imena za ukazno vrstico, ki si jih morda že slišala so recimo: *cmd*, *CLI*, *prompt*, *console* in *terminal*.
+
+## Zagon ukazne vrstice
+
+Delo z ukazno vrstico bomo začeli z zagonom le-te.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Verjetno se nahaja v Applications → Accessories → Terminal, vendar je to odvisno od tega, katero verzijo Linuxa imaš naloženo. Če je tam ni, pogooglaj. :)
+
+<!--endsec-->
+
+## Ukazna vrstica
+
+Pred sabo imaš torej odprto črno ali belo okno, ki čaka, da vanj vpišeš ustrezne ukaze.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Če uporabljaš operacijski sistem Mac ali Linux, se prva vrstica v ukazni lupini verjetno začne takole:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Na operacijskem sistemu Windows pa tako:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Vsak ukaz se bo začel s tem znakom in presledkom, vendar tebi tega ne bo treba pisati vsakič znova. To bo zate naredil tvoj računalnik. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Tvoj prvi ukaz :)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+Nato pritisni `enter`. Rezultat je približno tak:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    ana
+    
+
+Kot si opazila, je računalnik izpisal tvoje ime. Super? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Osnove
+
+Vsak operacijski sistem ima malce različen nabor ukazov v ukazni vrstici, zato se vedno prepričaj, da spremljaš navodila za svoj operacijski sistem.
+
+### Trenutni imenik
+
+Če želimo delati z datotekami, bi bilo za začetek uporabno vedeti, v katerem direktoriju se nahajamo. Vpiši sledeči ukaz in pritisni `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/ana
+    
+
+> Opomba: 'pwd' pomeni 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Uporabniki\ana
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+Nekaj podobnega si verjetno dobila tudi ti. Ko odpreš ukazno vrstico, je tvoj imenik običajno enak domačemu imeniku prijavljenega uporabnika.
+
+* * *
+
+### Izpis datotek in imenikov
+
+Bi rada izpisala vse imenike in datoteke, ki so v tvojem trenutnem imeniku? To narediš takole:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Uporabniki\ana
+    05/08/2014 07:28 PM <DIR>      Aplikacije
+    05/08/2014 07:28 PM <DIR>      Namizje
+    05/08/2014 07:28 PM <DIR>      Prenosi
+    05/08/2014 07:28 PM <DIR>      Glasba
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Sprememba imenika
+
+Premaknimo se v imenik Namizje:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Namizje
+    
+
+<!--endsec-->
+
+Preveri, če si se res premaknila:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/ana/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Uporabniki\ana\Namizje
+    
+
+<!--endsec-->
+
+Deluje! Super!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Ustvarjanje imenika
+
+Kako pa bi ustvarili nov imenik? Recimo takole:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir vaja
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir vaja
+    
+
+<!--endsec-->
+
+Ta ukaz bo naredil nov imenik z imenom `vaja` znotraj našega trenutnaga imenika. To lahko preveriš tako, da vpišeš ukaz `ls` oziroma `dir`, ali pa greš pogledat v imenik s pomočjo programa Finder oziroma Explorer! Poskusi. :)
+
+> UPORABEN namig: Če nočeš vedno znova vpisovati istega ukaza, lahko s pomočje pritiskanja puščic `gor` in `dol` na tipkovnici, pregledaš nedavno uporabljene ukaze.
+
+* * *
+
+### Vaja!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Rešitev:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd vaja
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd vaja
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Čestitke! :)
+
+* * *
+
+### Čistka :)
+
+Ustvarjenih imenikov ne potrebujemo več, zato jim odstranimo.
+
+Za začetek se pomaknimo nazaj v nadrejeni imenik:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Preverimo našo lokacijo:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/ana/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Uporabniki\ana\Namizje
+    
+
+<!--endsec-->
+
+Pripravljeni smo za odstranitev imenika `vaja`:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r vaja
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S vaja
+    vaja, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Končano! Preverimo imenik:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Izhod
+
+Zaenkrat smo se naučili dovolj, zato lahko ukazno vrstico zapremo. Naredimo to kot pravi hekerji? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Super? :)
+
+## Povzetek
+
+Tu je še povzetek nekaterih uporabnih ukazov:
+
+| Ukaz (Windows) | Ukaz (Mac OS/ Linux) | Opis                                                   | Primer                                            |
+| -------------- | -------------------- | ------------------------------------------------------ | ------------------------------------------------- |
+| izhod          | izhod                | zapri okno                                             | **izhod**                                         |
+| cd             | cd                   | spremeni imenik                                        | **cd test**                                       |
+| cd             | pwd                  | show the current directory                             | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir            | ls                   | izpiši imenike/datoteke, vsebovane v trenutnem imeniku | **dir**                                           |
+| copy           | cp                   | kopiraj datoteko                                       | **copy c:\test\test.txt c:\windows\test.txt** |
+| move           | mv                   | premakni datoteko                                      | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir          | mkdir                | ustvari nov imenik                                     | **mkdir testniimenik**                            |
+| rmdir (or del) | rm                   | delete a file                                          | **del c:\test\test.txt**                        |
+| rmdir /S       | rm -r                | delete a directory                                     | **rm -r testdirectory**                           |
+
+To je le nekaj osnovnih ukazov za ukazno vrstico. Drugih danes ne boš potrebovala.
+
+Če ti je bilo to poglavje zanimivo in bi rada izvedela še kaj več, imaš na strani [ss64.com](http://ss64.com) seznam vseh ukazov za vse operacijske sisteme.
+
+## Pripravljena?
+
+Začnimo s programskim jezikom Python!
\ No newline at end of file
diff --git a/sl/python_installation/README.md b/sl/python_installation/README.md
new file mode 100644
index 00000000000..593af7d0089
--- /dev/null
+++ b/sl/python_installation/README.md
@@ -0,0 +1,15 @@
+# Začnimo s programiranjem v Pythonu
+
+Končno!
+
+Za začetek povejmo, kaj Python pravzaprav je. Python je zelo priljubljen programski jezik, ki ga lahko uprabljamo za delanje spletnih strani, igric, računalniške grafike in še mnogih drugih programov.
+
+Python je nastal v poznih 80-ih letih. Njegov glavni namen je, da je prijazen tudi do programerjev (ne le do računalnikov!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Namestitev Pythona
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/sl/python_installation/instructions.md b/sl/python_installation/instructions.md
new file mode 100644
index 00000000000..541ba389c36
--- /dev/null
+++ b/sl/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Ne pozabi dodati Pythona v Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+Pojdi na spletno stran https://www.python.org/downloads/release/python-361/ in nato:
+
+* Prenesi datoteko *Mac OS X 64-bit/32-bit*,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Python je na tvojem računalniku verjetno že nameščen. To preveriš tako, da odpreš ukazno vrstico in vpišeš sledeči ukaz:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. Če slučajno še ni nameščen, to narediš takole:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Vpiši sledeči ukaz:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Vpiši sledeči ukaz:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Vpiši sledeči ukaz:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Namestitev se včasih lahko zakomplicira zato je bolje, da za pomoč prosiš nekoga z več izkušnjami.
\ No newline at end of file
diff --git a/sl/python_introduction/README.md b/sl/python_introduction/README.md
new file mode 100644
index 00000000000..f7baa3a94d8
--- /dev/null
+++ b/sl/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Uvod v Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Končno lahko začnemo s programiranjem!
+
+## Pythonova ukazna vrstica
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+Za začetek odpri *ukazno vrstico*. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Ko imaš odprto, sledi nadaljnim navodilom.
+
+Odpreti želimo Pythonovo ukazno vrstico, zato v ukazno vrstico vpiši `python` v Windowsih oziroma `python3` na Mac OS/Linux in pritisni `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Prvi ukaz v programske jeziku Python!
+
+Ko si uspešno zagnala pythonovo ukazno vrstico, se je začetek vrstice spremenil v `>>>`. To pomeni, da lahko začneš z vpisovanjem Pythonovih ukazov. You don't have to type in `>>>` – Python will do that for you.
+
+Če želiš Pythonovo ukazno vrstico zapreti, vanjo vpiši `exit()`, ali pa pritisni `Ctrl + Z` na Windowsih oziroma `Ctrl + D` na Mac OS/Linux. Opazila boš, da se vrstica ne bo več začenjala z `>>>`.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Malo se še poigraj z računanjem, nato pa nadaljuj z branjem. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Nizi
+
+Pythonu gredo dobro tudi imena. Vpiši svoje ime znotraj narekovajev:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ana"
+'Ana'
+```
+
+Pravkar si naredila svoj prvi niz! To je zaporedje znakov, ki ga računalnik zna prebrati. Nizi se morajo vedno začeti in končati z enojnim `'` ali dvojnim `"` narekovajem (med njima ni razlike!). Narekovaji Pythonu povedo, da je tisto, kar je znotraj njih, niz.
+
+Nize lahko združuješ. Takole:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Pozdravljena " + "Ana"
+'Pozdravljena Ana'
+```
+
+Lahko jih množiš s številko:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ana" * 3
+'AnaAnaAna'
+```
+
+Če želiš, da je narekovaj del niza, lahko to narediš na dva načina.
+
+Z uporabo dvojnih narekovajev:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Spust'li smo eno črko."
+"Spust'li smo eno črko."
+```
+
+ali pa z uporabo enojnih narekovajev in leve poševnice (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Spust\'li smo eno črko.'
+'Spust'li smo eno črko.'
+```
+
+Super! Kako pa bi črke imena spremenila v velike tiskane?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ana".upper()
+'ANA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ana")
+3
+```
+
+Kot si opazila, smo funkcijo enkrat uporabili na koncu niza in prednjo postavili piko (`"Ana".upper()`), drugič pa smo niz dali kar v funkcijo (len("Ana")). Gre za to, da je, v nekaterih primerih, funkcija del objekta. `upper()` je recimo del objekta nizi. V takem primeri funkciji rečemo **meotda**. Po drugi strani pa je funkcija lahko povsem neodvisna in jo lahko uporabimo za katerikoli objekt. Tak primer je `len()`. Zato smo niz `"Ana"` prej lahko vstavili kar v funkcijo `len`.
+
+### Povzetek
+
+OK, zaenkrat vemo dovolj o nizih. Poglejmo, česa vsega smo se že naučili:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+To so osnove vsakega programskega jezika. Si pripravljena na kaj težjega? Seveda si!
+
+## Napake
+
+Misliš da bi se dalo, z ustrezno funkcijo, dobiti dolžino številke? Vpiši `len(304023)` in pritisni `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Python nam javi napako! Reče, da objekt "int" (integer, celo število) nima dolžine. Kaj pa zdaj? Kateri objekti, ki jih poznamo, pa imajo dolžino? Nizi. Seveda! Poskusimo pretvoriti število v niz.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Zmaga! S pomočjo funkcije `str()`, smo pretvorili objekt število v objekt niz in nato s pomočjo `len()` izračunali dolžino niza. Funkcija `str()` pretvori v niz katerikoli objekt.
+
+- Funkcija `str` pretvori poljuben objekt v objekt niz.
+- Funkcija `int` pretvori poljuben objekt v objekt število (**integer** oziroma int)
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Spremenljivke
+
+Pomemben del vsakega programskega jezika so spremenljivke. Spremenljivka ni nič drugega kot ime, ki ga daš neki vrednosti (številki, nizu,...) in ga kasneje uporabiš za priklic te vrednosti. Programerji spremenljivke uporabljamo za shranjevanje podatkov in boljšo preglednost kode.
+
+Naredimo spremenljivko z imenom `ime`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ime = "Ana"
+```
+
+We type name equals Ola.
+
+Kot si opazila, program ničesar izpisal. Kako torej vemo, kakšno vrednost ima spremenljivka? Še enkrat napiši ime spremenljivke in pritisni `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ime
+'Ana'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ime = "Anja"
+>>> ime
+'Anja'
+```
+
+Spremenljivke lahko podtikaš tudi funkcijam:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(ime)
+4
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Kaj pa se zgodi, če spremenljivko pokličemo z napačnim imenom? Poskusimo!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> mesto = "Ljubljana"
+>>> mseto
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'mseto' is not defined
+```
+
+Python javi napako! Kot vidiš, ima Python različne vrste napak. Tej, ki nam jo javilo, se reče **NameError**. Python ti bo to napako javil, če boš poklicala spremenljivko, ki ne obstaja. Če boš kdaj naletela na to napako, torej vedno preverila, če si se zatipkala ali zmotila.
+
+Poskusi ustvariti še kakšno drugo spremenljivko, da se z njimi še bolje spoznaš!
+
+## Funkcija print
+
+Napiši tole:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ime = 'Micka'
+>>> ime
+'Micka'
+>>> print(ime)
+Micka
+```
+
+Ko napišeš `ime`, se bo Pythonov tolmač odzval z *vrednostjo* spremenljivke 'ime', ki je v tem primeru niz , sestavljen iz črk M-i-c-k-a. Ko pa napišeš print(ime), bo Python "sprintal" vsebino spremenljivke na ekran, brez narekovajev.
+
+Kasneje bomo videli, da je funkcija `print()` uporabna tudi, ko želimo izpisate vrednosti znotraj funkcije ali ko želimo izpisate vrednosti v večih vrsticah.
+
+## Seznami
+
+Polek nizov in števil Python pozna še mnoge druge objekte. Seznanili se bomo z objektom, ki mu rečemo **seznam**. Že ime nam namigne, kaj seznam je: objekt, ki je seznam objektov. :)
+
+Definirajmo torej naš prvi seznamček:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Prazen je. To ni ravno navdušujoče. Naredi raje seznam loterijskih številk. Pisanje si zmanjšaj tako, da ga shraniš v spremenljivko:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> loterija = [3, 42, 12, 19, 30, 59]
+```
+
+Tako, naredila si svoj prvi omembe vreden seznam. Kaj pa zdaj? Za začetek preveri, koliko je dolg. Kako se že to naredi? :)
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(loterija)
+6
+```
+
+Tako je! `len()` zna ugotoviti tudi dolžino seznama. To se izkaže za zelo uporabno. Razporedimo sedaj števila v seznamu po vrsti:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> loterija.sort()
+```
+
+Ta metoda ne vrne ničesar. Spremeni pa vrsti red števil v seznamu. Izpiši seznam, da se prepričaš, če je Python naredil prav.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(loterija)
+[3, 12, 19, 30, 42, 59]
+```
+
+Kot vidiš so števila res razporejena od najmanjšega proti največjemu. Čestitke!
+
+Kaj pa, če bi želeli vrstni red obrniti? Poskusimo!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> loterija.reverse()
+>>> print(loterija)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> loterija.append(199)
+>>> print(loterija)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Če želiš dobiti iz seznama nek določen element, lahko to narediš s pomočjo **indeksov**. Indeks pove, na katerem mestu v seznamu se nek element nahaja. Pri je malce neobičajno le to, da se štetje mest začne z indeksom 0 in ne 1 kot si verjetno pričakovala. Napiši tole:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(loterija[0])
+59
+>>> print(loterija[1])
+42
+```
+
+Do poljubnega elementa torej dostopamo z imenom seznama in želenim indeksom znotraj oglatih oklepajev.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Deluje! :)
+
+Za zabavo lahko preizkusiš še indekse: 6, 7, 1000, -1, -6 ali -1000. Poskusi predvideti rezultat, še preden ti ga pove Python. So rezultati smiselni?
+
+Vse metode, ki jih Python ima za sezname, si lahko ogledaš v Pythonovi dokumentaciji: https://docs.python.org/3/tutorial/datastructures.html
+
+## Slovarji
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Uspešno si naredila prazen slovar! :)
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> udeleženec = {'ime': 'Ana', 'država': 'Slovenija', 'najljubša_števila': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- Ključ `ime` ima vrednost `'Ana'` (`niz`),
+- `država` ima vrednost `'Slovenija'` (ponovno `niz`),
+- ključ `najljubša_števila` pa vrednost `[7, 42, 92]` (`seznam` s tremi elementi).
+
+Vrednost ključev lahko ugotoviš tudi na sledeč način:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(udeleženec['ime'])
+Ana
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+Kaj pa se zgodi, če od Pythona želimo vrednost ključa, ki ga ni? Kaj misliš? Poskusi!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> udeleženec['ime']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Pridelali smo napako! Tej se reče **KeyError**. Python je prijazen in nam pove tudi, da je do take napake prišlo pri ključu `'ime'`.
+
+Kdaj uporabiti slovar in kdaj seznam? To je dobro vprašanje. :) Razmisli o tem sama, nato pa poglej spodaj napisane odgovore.
+
+- So tvoji podatki urejeni (po abecedi, velikosti ipd.). Izberi seznam.
+- Imajo tvoji podatki edinstveno lastnost (ključ), po kateri jih lahko razlikuješ med seboj? Uporabi slovar.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> udeleženec['najljubši_jezik'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(udeleženec)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Če želiš recimo izbrisati ključ `'najljubša_števila'`, napiši sledeče:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> udeleženec['država'] = 'Avstrija'
+>>> udeleženec
+{'država': 'Avstrija', 'najljubši_jezik': 'Python', 'ime': 'Ana'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Povzetek
+
+Odlično ti gre! Zdaj veš že zelo veliko o programiranju. Povzemimo zadnja dognanja:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Odlično! Gremo hitro naprej. :)
+
+## Primerjanje
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Te zanima, zakaj smo uporabili dvojni enačaj `==`, ko smo ugotavljali, če sta dve števili enaki? Razlog je preprost. Enojni enačaj `=` uporabljamo že za definiranje spremenljivk. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. Podobno lahko za ugotavljanje, če dve stvari nista enaki, uporabimo znak `!=`.
+
+Poskusi še tole:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y pomeni: x je večje od y
+- x `<` y pomeni: x je manjše od y
+- x `<=` y pomeni: x je manjše ali enako y
+- x `>=` y means: x je večje ali enako y
+
+Odlično! Naredi še par primerov. Recimo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Python zna torej primerjati poljubno mnogo števil. Kako pa mu to uspe?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Si že slišala za izraz "primerjanje jabolk in pomaranč"? Si? Python tudi! Zanj takšno primerjanje enako sledečemu:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Podobno napako smo že videli v prvi polovici tega poglavja. Python ne zna primerjati števil (int) in nizov (string), zato javi **TypeError** in nam pove, da teh dveh tipov med seboj ne moremo primerjati.
+
+## Logika
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Boolean lahko uporabimo tudi pri spremenljivkah! Takole:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Lahko pa tudi tako:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Z objektom Boolean se lahko še bolje spoznaš tako da preizkusiš sledeče ukaze:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Čestitke! Pravkar si spoznala enega izmed najbolj uporabnih pripomočkov pri programiranju - Boolean!
+
+# Shranjevanje!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+Dosedaj smo programsko kodo pisali kar direktno v tolmač, kar pa nas je precej omejevalo, saj smo lahko vnašali le eno vrstico kode naenkrat. Običajno programe najprej shranimo v datoteko, nato pa jih izvedeta **tolmač** ali **prevajalnik** programskega jezika, ki ga uporabljamo (v našem primeru je to Python). Zaenkrat smo programe izvajali s pomočjo Pythonovega **tolmača**, po eno vrstico naenkrat. V nadaljevanju bomo potrebovali več kot le eno vrstico kode, zato naredi naslednje:
+
+- Zapri tolmač
+- Odpri poljuben urejevalnik programske kode
+- Ustvari novo python datoteko in vanjo napiši nekaj kode
+- Zaženi!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Zdaj si ponovno v običajni ukazni vrstici.
+
+Odpri urejevalnik, ki si ga izbrala v poglavju [urejevalniki programske kode](../code_editor/README.md). Ustvari novo datoteko in vanjo prepiši sledečo kodo:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Z urejevalnikom se lahko malce spoznaš, tako da vanj prepišeš nekaj kode od prej.
+
+Datoteko bomo zdaj shranili in ji dali pametno ime. Poimenuj jo recimo **python_intro.py**in jo shrani na namizje. Datoteko lahko seveda poimenuješ povsem poljubno, važno je le, da se ime konča z **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. Tako obarvanje nam lahko zelo pomaga. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). Barve so vsekakor eden izmed razlogov, zakaj uporabljamo urejevalnike. :)
+
+Zdaj lahko datoteko zaženeš! Za začetek uporabi svoje znanje ukazne vrstice in **spremeni imenik** v namizje.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Na Mac-u, ukaz zgleda približno takole:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Če se ti kje zatakne, povprašaj za pomoč mentorja.
+
+S pomočjo Python-a našo datoteko izvršimo takole:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Odlično! Pravkar si zagnala svoj prvi program.
+
+Zdaj se lahko spoznamo z enim izmed bistvenih programerskih orodij:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Kodo, ki je v datoteki **python_intro.py** zamenjaj s tole:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Težava je v tem, da nismo povedali, kaj naj se zgodi, če je pogoj `3 > 2` resničen (enak `True`). Naredimo zdaj program, ki bo izpisal "It works!". Spremeni kodo v datoteki **python_intro.py**:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Si opazila, da smo vrstico po if stavku zamaknili? To moraš narediti vedno, zato da Python ve, kaj pognati, če je pogoj resničen. Narediš lahko le en presledek, vendar je koda bolj pregledna, če jih narediš več. S tipko `tab` recimo narediš 4 presledke.
+
+Datoteko shrani in ponovno poženi:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### Kaj pa, če pogoj ni resničen?
+
+Dosedaj smo se pogovarjali le o kodi, ki se izvede, če pogoj velja. Če pa pogoj ni resničen ali drugačen, si lahko pomagamo s stavkoma `elif` in `else`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+Zgornji program bo izpisal:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+program izpiše:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+`elif` torej doda še dodaten pogoj, ki se preveri, če je prejšnji pogoj neresničen.
+
+Po začetnem `if` stavku, lahko dodaš lahko poljubno število `elif` stavkov. Recimo:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python začne po vrsti preverjati pogoje, se ustavi, ko pride do resničnega in izvede ustrezno kodo, ki temu pogoju sledi:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Povzetek
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Čas je za zadnje podpoglavje!
+
+## Funkcije
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+Funkcija je zaporedje ukazov, ki jih Python izvede, ko mu podamo ime funkcije. Vsaka funkcija se začne z besedo `def`, ima svoje ime in določene argumente. Let's give it a go. Kodo v datoteki **python_intro.py** zamenjaj s sledečo:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Super, naredila si svojo prvo funkcijo!
+
+Verjetno se sprašuješ, zakaj smo na koncu datoteke napisali ime funkcije. To smo naredili zato, ker Python prebere celo datoteko in nato izvede vso kodo. S stavkom def torej funkcijo le definiramo, s klicem hi(), pa zahtevamo, da naj jo Python izvede.
+
+Poženi zdaj ta programček in si oglej rezultat:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+Kot vidiš, smo funkciji dodali argument `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Ne pozabi: Funkcija `print`, ki sledi `if` stavku v zgornji kodi, je zamaknjena. S tem Pythonu povemo, da je ta koda znotraj if stavka in se izvede le, ko je izpolnjen nek pogoj. Zaženi zdaj program:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Dobimo napako. Na srečo nam Python dokaj natančno pove, v čem je težava. Pove nam, da naša funkcija `hi()` potrebuje argument, mi pa smo ga pozabili dodati, ko smo funkcijo klicali. Popravimo to napako:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+Program ponovno poženi:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+Kaj pa, če za argument damo kakšno drugo ime?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+Poženi:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+Funkcije so zelo uporabna stvar, saj nam lahko, če jih pravilno uporabimo, precej zmanjšajo količino kode. Če ne bi uporabili funkcije, bi v našem primeru morali vsakič, ko dobimo ime osebe, sami vedno znova napisati tisti print stavek. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Poženi program:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Čestitke! Pisanje funkcij zdaj obvladaš! :)
+
+## Zanke
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+Prišli smo do zadnjega dela tega poglavja.
+
+Kot smo že omenili, programerji ne maramo večkrat pisati podobne kode. Konec koncev je smisel programiranja ravno to, da računalnik naredi čimveč sam. Pri pisanju krajše kode, nam pomagajo zanke.
+
+Se še spomniš seznamov? Naredimo seznam deklet:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+Vsako izmed njih želimo pozdraviti po imenu. Uporabili bomo zanko, znotraj nje pa že napisano funkcijo `hi`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Tole je celotna koda:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+Ko program zaženemo, dobimo nekaj takega:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+Koda, ki je znotraj `for` zanke, se torej res ponovi za vsak element seznama `girls`.
+
+`for` zanko pa lahko narediš tudi s pomočjo funkcije `range`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Rezultat:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` je funkcija, ki ustvari seznam zaporednih števil (do posamičnega števila lahko dostopamo preko spremenljivke i).
+
+Iz zgornjega primera se vidi tudi, da druga številka, ki jo podamo funkciji range, ni vključena v seznam števil. `range(1, 6)` torej naredi seznam števil od (vključno) 1 do (vključno) 5. That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Povzetek
+
+To je to. **Obvladaš!** Lahko si ponosna nase, saj je bilo to poglavje kar zahtevno. Veseli smo, predelala že tako velik del tega vodiča!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Mafin](images/cupcake.png)
\ No newline at end of file
diff --git a/sl/signup_pythonanywhere.md b/sl/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/sl/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/sl/template_extending/README.md b/sl/template_extending/README.md
new file mode 100644
index 00000000000..2554a4e68c1
--- /dev/null
+++ b/sl/template_extending/README.md
@@ -0,0 +1,147 @@
+# Razširitev predloge
+
+Še ena lepa stvar, ki jo Django omogoča, je **razširjanje predlog**. Kaj je razširjanje predlog? Razširjanje predlog pomeni, da lahko, na več straneh svoje spletne strani, uporabiš isti del HTML dokumenta.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+Osnovna predloga je najbolj temeljna predloga, iz katere boš kasneje naredila vse ostale strani na svoji spletni strani.
+
+V `blog/templates` ustvari datoteko `base.html`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Nato jo odpri in vanjo prekopiraj celotno vsebino datoteke `post_list.html`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+V datoteki `base.html` zamenjaj vsebino značke `<body>` (vse med `<body>` in `</body>`) s temle:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). Ne skrbi, kmalu si bomo to pogledali še na primeru.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Takole:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Končano! Poglej svojo stran in preveri, če vse deluje kot mora. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/sl/whats_next/README.md b/sl/whats_next/README.md
new file mode 100644
index 00000000000..1453c7367ba
--- /dev/null
+++ b/sl/whats_next/README.md
@@ -0,0 +1,25 @@
+# Kaj pa zdaj?
+
+Čestitamo! **Genialka si** Zelo smo ponosni! <3
+
+### Kaj pa zdaj?
+
+Vzemi si premor in se spočij. Naredila si ogromno.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Kako naprej?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/sr-CS/GLOSSARY.md b/sr-CS/GLOSSARY.md
new file mode 100644
index 00000000000..dd04f709b2d
--- /dev/null
+++ b/sr-CS/GLOSSARY.md
@@ -0,0 +1,3 @@
+# Code editor
+
+Editor koda je aplikacija koja ti omogućava da sačuvaš kod na kom radiš, tako da mu se kasnije možeš vratiti. Gdje možeš naći isti saznaćeš u poglavlju [Editor koda](./code_editor/README.md)
\ No newline at end of file
diff --git a/sr-CS/README.md b/sr-CS/README.md
new file mode 100644
index 00000000000..8ee2589b8de
--- /dev/null
+++ b/sr-CS/README.md
@@ -0,0 +1,51 @@
+# Django Girls Priručnik
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Ovo delo je pod licencom Creative Commons Attribution-ShareAlike 4.0 International License
+
+## Dobrodošli
+
+Dobrodošli u Django Girls Priručnik! Srećni smo što si ovde. :) U ovom tutorijalu, vodimo te na putovanje u srce veb tehnologija, zavirićemo "ispod haube" i detaljno pregledati sve delove koji moraju da se uklope da bi veb bio onakav kakvog ga poznajemo.
+
+Kao i sa bilo čime nepoznatim, ovo će biti avantura - ali bez brige, pošto imaš hrabrosti da budeš ovde, sve će biti OK. :)
+
+## Uvod
+
+Da li si ikada imala osećaj da se svet sve više i više svodi na tehnologije koje ti (još) nisu bliske? Da li si se ikada pitala kako da napraviš internet stranicu, ali nikada nisi bila dovoljno motivisana da zaista počneš? Da li si ikada pomislila da je svet softvera za tebe prekomplikovan čak i da počneš da radiš nešto samostalno?
+
+E, pa, dobre vesti za tebe! Programiranje nije tako teško kakvim se čini i mi želimo da ti pokažemo koliko zanimljivo može da bude.
+
+Ovaj priručnik te neće magijom pretvoriti u programerku. Ako želiš da postaneš dobra u programiranju, potrebni su meseci, pa čak i godine učenja i vežbe. Ali mi želimo da ti pokažemo da programiranje ili kreiranje internet stranica nije tako komplikovano kakvim se čini. Pokušaćemo da objasnimo različite deliće što bolje možemo, tako da se ne bi bila zastrašena tehnologijom.
+
+Nadamo se da ćemo učiniti da zavoliš tehnologiju onoliko koliko je mi volimo!
+
+## Šta ćeš naučiti iz ovog priručnika?
+
+Kada budeš završila sa ovim priručnikom, imaćeš jednu malu internet aplikaciju koja zapravo radi: svoj blog. Pokazaćemo ti kako da je objaviš na internetu, tako da drugi mogu da vide tvoj rad!
+
+Tvoj blog će (manje-više) izgledati ovako:
+
+![Slika 0.1](images/application.png)
+
+> Ako samostalno prelaziš materiju u ovom priručniku i nemaš instruktora koji bi ti pomogao u slučaju da naiđeš na problem, imamo sistem ćaskanja za tebe: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Pitali smo naše instruktore i prethodne učesnike da se sa vremena na vreme nađu drugima i pomognu im sa priručnikom! Nemoj se ustručavati ni plašiti da postaviš pitanje ovde!
+
+OK, [hajde da krenemo od početka...](./how_the_internet_works/README.md)
+
+## Praćenje priručnika kod kuće
+
+Neverovatno je učestvovati u Django Girls radionici, ali svesni smo da to nije uvek moguće. Zato te podstičemo da pokušaš da pratiš ovaj priručnik kod kuće. Za čitateljke kod kuće, trenutno pripremamo video zapise koji će vam olakšati da pratite ovaj priručnik na svoju ruku. Ovo je i dalje nešto na čemu radimo, ali sve više materijala će uskoro biti pokriveno na YouTube kanalu [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed).
+
+U svakom poglavlju koje je već pokriveno, postoji link koji ćete uputiti na odgovarajući video.
+
+## O priručniku i doprinosima
+
+Ovaj priručnik održavaju [DjangoGirls](https://djangogirls.org/). Ako naiđeš na greške ili ako želiš da ažuriraš priručnik, molimo te [ da pratiš uputstva kako možeš da napraviš doprinos.](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Želiš li da nam pomogneš da prevedemo ovaj priručnik na neki drugi jezik?
+
+Trenutno se prevodi drže na crowdin.com platformi na:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Ako tvoj jezik nije naveden na [crowdin](https://crowdin.com/), molimo te [Otvori novi issue](https://github.com/DjangoGirls/tutorial/issues/new) da bismo saznali o kom jeziku se radi, tako da ga možemo dodati.
\ No newline at end of file
diff --git a/sr-CS/SUMMARY.md b/sr-CS/SUMMARY.md
new file mode 100644
index 00000000000..1358299c586
--- /dev/null
+++ b/sr-CS/SUMMARY.md
@@ -0,0 +1,35 @@
+# Pregled
+
+* [Uvod](README.md)
+* [Instalacija](installation/README.md) 
+  * [Komandna linija](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Editor koda](installation/README.md#code-editor)
+  * [Virtuelno okruženje](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Instalacija (chromebook)](chromebook_setup/README.md)
+* [Kako internet radi](how_the_internet_works/README.md)
+* [Uvod u komandnu liniju](intro_to_command_line/README.md)
+* [Instalacija Python-a](python_installation/README.md)
+* [Editor koda](code_editor/README.md)
+* [Uvod u Python](python_introduction/README.md)
+* [Šta je Django?](django/README.md)
+* [Django instalacija](django_installation/README.md)
+* [Tvoj prvi Django projekat!](django_start_project/README.md)
+* [Django modeli](django_models/README.md)
+* [Django Admin](django_admin/README.md)
+* [Objavi!](deploy/README.md)
+* [Django URL adrese](django_urls/README.md)
+* [Django views - vreme je za stvaranje!](django_views/README.md)
+* [Uvod u HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dinamični podaci u šablonima](dynamic_data_in_templates/README.md)
+* [Django šabloni](django_templates/README.md)
+* [CSS - za ulepšavanje](css/README.md)
+* [Proširenje šablona](template_extending/README.md)
+* [Proširite svoju aplikaciju](extend_your_application/README.md)
+* [Django oblici](django_forms/README.md)
+* [Šta je sledeće?](whats_next/README.md)
\ No newline at end of file
diff --git a/sr-CS/chromebook_setup/README.md b/sr-CS/chromebook_setup/README.md
new file mode 100644
index 00000000000..0e32cc5a5f6
--- /dev/null
+++ b/sr-CS/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Podešavanje Chromebook-a
+
+> **Napomena** Ako su već odrađeni [koraci za instalaciju](../installation/README.md), nema ppotrebe da se to ponovo radi - možeš da pređeš pravo na [Uvod u Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/sr-CS/chromebook_setup/instructions.md b/sr-CS/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..6bc649b60ad
--- /dev/null
+++ b/sr-CS/chromebook_setup/instructions.md
@@ -0,0 +1,159 @@
+Možeš da [preskočiš ovo poglavlje](http://tutorial.djangogirls.org/en/installation/#install-python) ako ne koristiš Chromebook. Ako koristiš, tvoja instalacija će biti nešto drugačija. Možeš da zanemariš ostatak uputstva za instalaciju.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE je alatka koja vam omogućava uređivanje kodova i pristup računaru umreženom na internet, gde možete da instalirate, pišete, i pokrenete softver. Tokom ovog priručnika, Cloud IDE će poslužiti kao Vaš *lokalni računar*. I dalje ćes pokretati naredbe u terminalu, baš kao i Vaše kolege koje koriste OS X, Ubuntu ili Windows, ali će Vaš terminal biti povezan sa računarom pokrenutim negde drugde tamo gde je cloud IDE to podesio za tebe. Evo cloud IDE uputstava (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Možete da izaberete jedan od Cloud IDE-jeva i da pratite njegove instrukcije.
+
+#### PaizaCloud Cloud IDE
+
+1. Idite na [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Napravite Vaš nalog
+3. Kliknite na *New Server* i izaberite Django aplikaciju
+4. Kliknite na dugme sa nazivom "Terminal"(sa leve strane prozora)
+
+Sada bi trebalo da vidite interfejs sa trakom sa opcijama sa leve strane. Kliknite "Terminal" dugme kako biste otvorili terminal sa komandama:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+Terminal na PaizaCloud Cloud IDE je sada spreman za vaše komande. Možete da promenite veličinu prozora kako biste ga učinili malo većim.
+
+#### AWS Cloud9
+
+U ovu trenutku Cloud 9 zahteva da se prijavite na AWS i unesete informacije o kreditnoj kartici. 
+
+1. Instalirajte Cloud 9 iz  Chrome web prodavnice </ 0</li> 
+    
+    - Idite na [ c9.io ](https://c9.io) i kliknite * Počnite sa AVS Cloud9 *
+    - Prijavite se za AVS nalog (zahteva podatke o kreditnoj kartici, ali možete ga koristiti i besplatno)
+    - Na AWS kontrolnoj tabli unesite * Cloud9 * u traku za pretragu i kliknite je
+    - Na Cloud 9 kontrolnoj tabli, kliknite * Kreiraj okruženje *
+    - Dajte mu ime * django-girls ​​*
+    - Dok konfigurišete podesavanja, odaberite * Kreirajte novu instancu za okruženje (EC2) * za "Tip okruženja" i * t2.micro * "Tip instance" (trebalo bi da piše "Slobodni-nivo dostupan."). Osnovna podesavanja za uštedu troškova su u redu i možete zadržati ostale zadane vrednosti.
+    - Kliknite na * Sledeći korak *
+    - Kliknite na * Kreirajte okruženje *</ol> 
+    
+    Sada bi trebalo da vidite interfejs sa bočnom trakom, veliki glavni prozor sa nekim tekstom i mali prozor na dnu koji izgleda ovako:
+    
+    {% filename %}bash{% endfilename %}
+    
+        yourusername:~/workspace $
+        
+    
+    Ovo donje područje je vaš terminal. Možete koristiti terminal da biste poslali uputstva udaljenom Cloud 9 računaru. Možete da promenite veličinu tog prozora da biste ga malo povećali.
+    
+    #### Glitch.com Cloud IDE
+    
+    1. Idi na [Glitch.com](https://glitch.com/)
+    2. Registruj se (https://glitch.com/signup) ili koristi svoj GitHub nalog, ako ga imaš. (Pogledaj uputstva za GitHub ispod.)
+    3. Klikni na *New Project* i izaberi *hello-webpage*
+    4. Klikni na padajuću listu Tools (u donjem levom uglu prozora), a zatim na dugme Terminal da otvoriš novu karticu terminala, slično ovome:
+    
+    {% filename %}Terminal{% endfilename %}
+    
+        app@ime-tvog-glitch-projekta:~
+        
+    
+    Kada koristiš Glitch.com kao svoj cloud IDE, ne moraš da praviš virtuelno okruženje.
+    
+    {% 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
+    ```
+    
+    Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+    
+    {% filename %}Terminal{% endfilename %}
+    
+        django-admin.py startproject mysite .
+        refresh
+        
+    
+    In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+    
+    {% 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,
+            },
+        },
+    }
+    ```
+    
+    This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+    
+    The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+    
+    ### Virutelno okruženje
+    
+    A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+    
+    Run:
+    
+    {% filename %}Cloud 9{% endfilename %}
+    
+        mkdir djangogirls
+        cd djangogirls
+        python3 -m venv myvenv
+        source myvenv/bin/activate
+        pip install django~={{ book.django_version }}
+        
+    
+    (note that on the last line we use a tilde followed by an equal sign: `~=`).
+    
+    ### GitHub
+    
+    Make a [GitHub](https://github.com) account.
+    
+    ### PythonAnywhere
+    
+    The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+    
+    This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+    
+    Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/sr-CS/code_editor/README.md b/sr-CS/code_editor/README.md
new file mode 100644
index 00000000000..f0babfc827f
--- /dev/null
+++ b/sr-CS/code_editor/README.md
@@ -0,0 +1,11 @@
+# Uređivač koda
+
+> Za one koji čitaju ovo kod kuće: ovo poglavlje je pokriveno u [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) videu.
+
+Uskoro ćete napisati svoju prvu liniju koda, tako da je vreme da preuzmete uređivač koda!
+
+> **Napomena** Ukoliko koristite Chromebook, preskočite ovo poglavlje i postarajte se da sledite instrukcije u [Chromebook podešavanjima](../chromebook_setup/README.md). Cloud IDE koji izaberete (PaizaCloud Cloud IDE or AWS Cloud9) uključuje editor koji će se automatski pokrenuti kada otvorite fajl u svom IDE-u fajl meniju.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/sr-CS/code_editor/instructions.md b/sr-CS/code_editor/instructions.md
new file mode 100644
index 00000000000..0e9867a3961
--- /dev/null
+++ b/sr-CS/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Postoji puno različitih editora i izbor se uglavnom svodi na lične preference. Većina Pajton programera koriste kompleksne ali veoma snazne IDE (Integrisana razvojna okruženja), poput PyCharm-a. Međutim, kao početniku to je verovatno manje pogodno; naše preporuke su podjednako snažne, ali mnogo jednostavnije.
+
+Naše sugestije slede u nastavku, ali slobodno možete da pitate svog instruktora za njegove preporuke - jer bi tako bilo dosta lakše da dobijete njegovu pomoć.
+
+## Visual Studio Code
+
+Visual Studio Code je uređivač izvornog koda koji je razvio Microsoft za Windows, Linux i macOS. To uključuje podršku za uklanjanje grešaka, ugrađenu Git kontrolu, isticanje sintakse, inteligentno dovršavanje koda, isečke i proces restrukturiranja postojećeg računarskog koda.
+
+[Preuzmite ovde](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit je otvorenog koda, besplatni uređivač, dostupan za sve operativne sisteme.
+
+[Preuzmite ovde](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text je vrlo popularan uređivač sa slobodnim periodom procene i dostupan je za sve operativne sisteme.
+
+[Preuzmite ovde](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom je još jedan popularni urednik. Besplatan je, otvorenog koda i dostupan za Windows, OS X i Linux. Atom je razvio [ GitHub ](https://github.com/).
+
+[Preuzmite ovde](https://atom.io/)
+
+## Zašto instaliramo uređivač koda?
+
+Možda se pitate zašto instaliramo ovaj poseban softver za uređivanje koda, umesto da koristimo nešto poput Word-a ili Notepad-a.
+
+Prvi razlog je taj što kod treba da bude ** običan tekst **, a problem sa programima kao što su Word i Textedit je taj što oni zapravo ne proizvode običan tekst, oni stvaraju bogat tekst (sa fontom i formatiranjem), korišćenjem prilagođenih formata kao što je [ RTF (Format obogađenog teksta) ](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+Drugi razlog je taj što su uređivači koda specijalizovani za uređivanje koda, tako da mogu pružiti korisne funkcije poput isticanja koda bojom prema njegovom značenju ili automatski zatvaranja citata za vas.
+
+Sve ćemo to videti u akciji kasnije. Uskoro ćete pomisliti na svog pouzdanog starog uređivača koda kao jednog od svojih omiljenih alata. :)
\ No newline at end of file
diff --git a/sr-CS/css/README.md b/sr-CS/css/README.md
new file mode 100644
index 00000000000..f45bfa57ff0
--- /dev/null
+++ b/sr-CS/css/README.md
@@ -0,0 +1,330 @@
+# CSS - vreme je za ulepšavanje!
+
+Naš blog izgleda poprilično ružno, zar ne? Vreme je da ga osvežimo! Iskoristićemo CSS za to.
+
+## Šta je CSS?
+
+CSS (eng. Cascading Style Sheets) je jezik koji se koristi za opisivanje izgleda i formatiranje veb sajta napisanog u jeziku za označavanje (poput HTML-a). Možete smatrati da je to šminka za Vaš veb sajt. :)
+
+Ali ne želimo da počnemo sve ispočetka, zar ne? Da napomenemo još jednom, koristićemo nešto što su programeri objavili ranije na internetu, potpuno besplatno. Izmišljanje tople vode ponovo nije baš zabavno.
+
+## Hajde da koristimo Bootstrap!
+
+Bootstrap je jedna od najpopularnijih HTML i CSS biblioteka za razvoj lepih veb sajtova: https://getbootstrap.com/
+
+Inicijalno je napisana je od strane programera koji su radili u Twitter-u. Trenutno se razvija od strane developera širom sveta.
+
+## Instalacija Bootstrap-a
+
+Kako biste instalirali Bootstrap, otvorite Vaš `.html` fajl u editoru i u `<head>` odeljku dodajte ovo:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Ova naredba ne dodaje ni jedan novi fajl u Vaš projekat. Umesto toga, samo pokazuje fajlove koji postoje na Internetu. Samo napred, otvorite svoj veb sajt i osvežite stranicu. Evo ga!
+
+![Slika 14.1](images/bootstrap1.png)
+
+Već izgleda lepše!
+
+## Statički fajlovi u Djangu (Django)
+
+Najzad ćemo detaljnije pogledati ono što smo zvali **statički fajlovi**. To predstavlja sav Vaš CSS i sve slike. Njihov sadržaj ne zavisi od konteksta zahteva i jednak je za svakog korisnika.
+
+### Gde staviti statičke fajlove u Django-u
+
+Django sam zna gde da nađe statičke fajlove za ugrađene "admin" aplikacije. Sada samo treba da dodamo neke statičke fajlove za našu novu aplikaciju, `blog`.
+
+To ćemo uraditi tako što ćemo kreirati folder pod nazivom `static` unutar blog aplikacije:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django će automatski da pronađe bilo koji folder koji je nazvan "static" (statički) unutar nekog od foldera Vaše aplikacije. Zatim će biti moguće da koristite pronađeni sadržaj kao statičke fajlove.
+
+## Vaš prvi CSS dokument!
+
+Hajde da kreiramo sada CSS fajl, kako bismo dodali malo stila veb stranici. Kreirajte novi direktorijum koji se zove `css` unutar Vašeg `static` direktorijuma. Zatim kreirajte novi fajl po imenu `blog.css` unutar tog `css` direktorijuma. Spremni?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Vreme je da napišete neki CSS! Otvorite `blog/static/css/blog.css` fajl u svom editoru.
+
+Nećemo pričati opširno o personalizovanju i učenju CSS-a ovde, jer postoji preporuka za besplatan CSS kurs na kraju ove stranice, ukoliko želite da naučite više.
+
+Ali, hajde da ipak uradimo neke stvari. Možda bismo mogli da promenimo boju zaglavlja? Kako bi razumeli boje, računari koriste određene kodove. Ti kodovi počinju sa `#`, nakon čega sledi 6 slova (A–F) i brojeva (0–9). Na primer, kod za plavu boju je `#0000FF`. Za mnoge boje, možete da pronađete kodove na ovom linku: http://www.colorpicker.com/. Moguće je i koristiti [unapred podešene boje](http://www.w3schools.com/colors/colors_names.asp) kao što su `red` (crvena) i `green` (zelena).
+
+Trebalo bi da dodate sledeću liniju koda u Vašem `blog/static/css/blog.css` fajlu:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` je CSS selektor. To znači da primenjujemo naš stil na bilo koji `a` element unutar `h1` elementa; selektor `h2 a` radi potpuno istu stvar za `h2` elemente. Dakle, kada imamo liniju koda kao što je `<h1><a href="">link</a></h1>`, tada će se primeniti `h1 a` stil. U ovom slučaju, uneli smo naredbu da se boja promeni u `#C25100`, što je zapravo tamno narandžasta. Možete da unesete i Vašu željenu boju, ali se postarajte da ima dobar kontrast naspram bele pozadine!
+
+U CSS fajlovima određujemo stilove za elemente u HTML fajlovima. Prvi način na koji možemo da identifikujemo elemente je pomoću imena elemenata. Možda Vam je to poznatije pod nazivom tagovi, iz dela sa HTML-om. Stvari kao što su `a`, `h1`, i `body` su primeri imena elemenata. Takođe, identifikujemo elemente i prema atributu `class` ili atributu `id`. Class (klasa) i id (identifikacioni broj) su imena koja sami dodeljujete elementima. Klase predstavljaju grupe elemenata, a identifikacioni brojevi pokazuju jedan određeni element. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Možete da pročitate više o tome na linku [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+Takođe, moramo da na neki način obavestimo HTML obrazac da smo dodali neki CSS. Otvorite `blog/templates/blog/post_list.html` fajl u editoru i dodajte ovu liniju na samom početku:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Sada samo učitavamo statičke fajlove. :) Između `<head>` i `</head>` tagova, nakon linkova do Bootstrap CSS fajlova, dodajte sledeću liniju:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Pretraživač učitava fajlove po redosledu od početka do kraja, tako da moramo da budemo sigurni da je ova linija koda na pravom mestu. U suprotnom, kod u našem fajlu može da bude "pregažen" od strane koda iz Bootstrap fajla. Ovim smo na neki način rekli našem obrascu gde je lociran naš CSS fajl.
+
+Vaš fajl bi trebalo sada da izgleda ovako:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+U redu, sada sačuvajte fajl i osvežite sajt!
+
+![Slika 14.2](images/color2.png)
+
+Lepo urađeno! Možda bismo mogli da damo našem sajtu malo prostora i da povećamo marginu sa leve strane? Hajde da to pokušamo!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Dodajte to Vašem CSS-u, sačuvajte fajl i pogledajte šta ste dobili!
+
+![Slika 14.3](images/margin2.png)
+
+Možda bismo mogli da podesimo željeni font u našem zaglavlju? Nalepite ovo u Vaš `<head>` u fajlu `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Kao i prošli put, proverite redosled i mesto na koje postavljate link, unutar `blog/static/css/blog.css` fajla. Ova linija koda će iz Google Fontova (https://www.google.com/fonts) uvesti font koji se zove *Lobster*.
+
+Pronađite blok u kojem je deklarisan `h1 a` (deo koda između zagrada `{` `}`) u CSS fajlu `blog/static/css/blog.css`. Dodajte liniju `font-family: 'Lobster';` između zagrada i osvežite stranicu:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Slika 14.3](images/font.png)
+
+Odlično!
+
+Kao što je napomenuto ranije, u CSS-u postoje klase. One omogućavaju da odredite deo HTML koda i da primenite određene stilove na taj deo, bez ikakvog uticaja na ostale delove. To može da bude jako korisno! Možda imate dve celine (div-ovi) koje rade potpuno različite stvari (kao na primer zaglavlje i post). Klase mogu da Vam pomognu da učinite da ti delovi izgledaju drugačije.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Sada ćemo dodati deklaracione blokove različitim selektorima. Selektori počinju `.` (tačkom) za razliku od klasa. Postoje mnogi odlični priručnici i objašnjenja o CSS-u na internetu koji mogu da Vam pomognu da razumete sledeći kod. Za sada, kopirajte ga i nalepite u Vaš `blog/static/css/blog.css` fajl:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Zatim umetnite HTML kod koji prikazuje post između deklaracija klasa. Zamenite sledeći deo:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+u `blog/templates/blog/post_list.html` fajlu ovim delom:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Sačuvajte ove fajlove i osvežite svoj sajt.
+
+![Slika 14.4](images/final.png)
+
+Vauuu! Izgleda odlično, zar ne? Pogledajte kod koji smo nalepili kako biste videli gde su dodate klase u HTML-u i upotrebljene u CSS-u. Gde biste načinili izmenu, ako biste želeli da obojite datum u tirkizno?
+
+Ne plašite se da malo eksperimentišete sa CSS-om i da pokušate da promenite neke stvari. Igranje CSS-om može da Vam pomogne da razumete kako različite stvari funkcionišu. Ako negde pogrešite, ne brinite - uvek možete da se vratite korak unazad!
+
+Zaista preporučujemo polaganje besplatnih online kurseva "Basic HTML & HTML5" i „Basic CSS“ na [ freeCodeCamp ](https://learn.freecodecamp.org/). Oni vam mogu pomoći da naučite sve o tome kako da napravite vaše web stranice lepše koristeci HTML i CSS.
+
+Da li ste spremni za sledeće poglavlje?! :)
\ No newline at end of file
diff --git a/sr-CS/deploy/README.md b/sr-CS/deploy/README.md
new file mode 100644
index 00000000000..4c7a5dc21e5
--- /dev/null
+++ b/sr-CS/deploy/README.md
@@ -0,0 +1,246 @@
+# Obezbedite dostupnost!
+
+> **Napomena** Sledeće poglavlje može ponekad da bude zahtevno. Istrajte i završite ga; dostupnost je važan deo procesa pravljenja sajtova. Ovo poglavlje je postavljeno u sredinu priručnika kako bi Vaš mentor mogao da Vam pomogne u vezi sa postavljanjem sajta na internet. To znači da i dalje možete da završite priručnik sami, ukoliko Vam ponestane vremena.
+
+Do sada, Vaš sajt je bio dostupan isključivo na Vašem računaru. Sada ćete naučiti kako da ga dopremite na internet! Ovaj proces se odnosi na objavljivanje Vaše aplikacije na internetu, tako da ljudi konačno mogu da je vide. :)
+
+Kao što ste do sada naučili, sajt mora da se nalazi na nekom serveru. Postoji dosta provajdera za servere koji su dostupni na internetu, a mi ćemo koristiti [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere je besplatan za male aplikacije koje nemaju puno posetilaca, tako da će to za sada biti dovoljno.
+
+Drugi servis koji ćemo koristiti je [GitHub](https://www.github.com), koji će nam omogućiti hostovanje kodova. Postoje i drugi servisi, ali ovih dana skoro svi programeri imaju GitHub nalog, tako da ćete i Vi napraviti jedan!
+
+Ta tri mesta će Vam biti važna. Vaš lokalni računar će biti mesto gde razvijate program i testirate ga. Kada budete bili zadovoljni izmenama, možete da postavite kopiju svog programa na GitHub. Vaš sajt će biti na PythonAnywhere i ažuriraćete ga preuzimanjem nove kopije koda sa GitHub-a.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Pokretanje Git skladišta
+
+Git prati izmene na određenom skupu fajlova koji se nalaze u nečemu što se naziva skladište za kodove (eng. code repository). Hajde da kreiramo jedno skladište za naš projekat. Otvorite konzolu i ukucajte sledeće komande, u `djangogirls` direktorijumu:
+
+> **Napomena** Proverite trenutni radni direktorijum pomoću `pwd` (Mac OS/Linux) ili `cd` (Windows) komande, pre inicijalizovanja skladišta. Trebalo bi da se nalazite u `djangogirls` folderu.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Inicijalizovanje Git skladišta je nešto što treba da se uradi samo jednom tokom rada na projektu (nakon toga nećete više morati da unosite korisničko ime i email).
+
+Git će pratiti sve izmene na svim fajlovima i folderima u ovom direktorijumu, ali postoje neki fajlovi za koje želimo da budu ignorisani. To se radi kreiranjem fajla `.gitignore` u osnovnom direktorijumu. Otvorite editor i kreirajte novi fajl sa sledećim sadržajem:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+Sačuvajte to kao `.gitignore` u "djangogirls" folderu.
+
+> **Napomena** Tačka na početku naziva fajla je važna! Ukoliko imate poteškoće tokom kreiranja (Apple-ovi računari ne vole kada kreirate fajlove koji počinju tačkom putem Finder-a) koristite "Save As" (sačuvajte kao) opciju u editoru, to bi trebalo da pomogne. I budite sigurni da niste dodali `.txt`, `.py` ili neku drugu ekstenziju u naziv - fajl će biti prepoznat od strane Git-a samo ako je ime `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Napomena** Jedan od fajlova koje ste naveli u `.gitignore` je i `db.sqlite3`. Taj fajl je Vaša lokalna baza podataka, gde su sačuvani svi korisnici i postovi. Mi ćemo ovde pratiti standardnu praksu u veb programiranju, koja podrazumeva korišćenje odvojenih baza podataka za lokalni test sajt i za sajt na PythonAnywhere. PythonAnywhere baza podataka može da bude SQLite, kao i Vaša mašina na kojoj radite, ali se obično koristi MySQL koji može da podrži dosta više posetilaca sajta nego SQLite. Kako god, isključivanje SQLite baze podataka iz GitHub kopije znači da će svi postovi i korisnici koje ste kreirali do sada moći da budu dostupni isključivo lokalno i Vi ćete morati da kreirate nove tokom rada. Trebalo bi da posmatrate Vašu lokalnu bazu podataka kao poligon na kom možete da testirate različite stvari i da se ne plašite da ćete da izbrišete neki stvaran post sa Vašeg bloga.
+
+Dobra ideja je da koristite `git status` komandu pre komande `git add` ili kada god niste sigurni u to šta je sve izmenjeno. To će pomoći da se spreče stvari kao što su dodavanje ili objavljivanje pogrešnih fajlova. Komanda `git status` vraća informacije o svim neispraćenim, izmenjenim ili organizovanim fajlovima, status ogranka (eng. branch status) i dr. Izlaz bi trebalo da izgleda ovako:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Datoteke bez praćenja:
+     (koristite „git add <file> ...“ da biste uključili šta će biti objavljeno)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    ništa nije dodato za objavljivanje, ali prisutne su i datoteke bez praćenja (za praćenje koristite „git add“)
+    
+
+I na kraju, možemo da sačuvamo izmene pomoću sledećih komandi:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Objavljivanje koda na GitHub-u
+
+Idite na [GitHub.com](https://www.github.com) i napravite nov, besplatan nalog. (Ako ste to već odradili tokom priprema za ovu radionicu, utoliko bolje!) Postarajte se da zapamtite Vašu šifru (dodajte je u svoj organizator za šifre (eng. password manager) ukoliko ga koristite).
+
+Zatim, kreirajte novo skladište i nazovite ga "my-first-blog". Ostavite "initialize with a README" polje prazno, takođe ostavite .gitignore opciju nepopunjenu (to smo već uradili ručno) i postavite licencu kao "None".
+
+![](images/new_github_repo.png)
+
+> **Napomena** Naziv `my-first-blog` je važan - možete da izaberete neki drugi naziv, ali biste u tom slučaju kasnije morali svaki put da ga menjate jer je tokom sledećih instrukcija svuda korišćen navedeni naziv. Verovatno je lakše ostaviti ga kao `my-first-blog`.
+
+Na sledećem prikazu, videćete URL za kloniranje Vašeg skladišta, koji ćete koristiti u nekim od sledećih komandi:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Sada treba da povežemo Git skladište na Vašem računaru sa onim na GitHub-u.
+
+Ukucajte sledeće komande u konzolu (zamenite `<your-github-username>` sa korisničkim imenom koje ste uneli kada ste kreirali GitHub nalog, ali bez uglastih zagrada - URL bi trebalo da se poklapa sa URL-om za kloniranje koji ste videli):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Kada objavljujete na GitHubu, moraćete da unesete korisničko ime i šifru (ili u komandnoj liniji ili u pop-up prozoru) i nakon unošenja podataka ćete videti nešto što bi trebalo ovako da izgleda:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Vaš kod je sada na GitHub-u. Pogledajte! Naćićete ga u dobrom društvu - [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial) i mnogi drugi dobri projekti otvorenog koda takođe drže svoj kod na GitHub-u. :)
+
+# Podešavanje bloga na PythonAnywhere
+
+## Napravite nalog na PythonAnywhere
+
+> **Napomena** možda ste već kreirali nalog na PythonAnywhere ranije, tokom instalacije - ukoliko je to slučaj, nema potreba da ga kreirate ponovo.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Podešavanje sajta na PythonAnywhere
+
+Vratite se natrag na glavnu [PythonAnywhere kontrolnu tablu](https://www.pythonanywhere.com/) klikom na logo i izaberite opciju da pokrenete "Bash" konzolu - to je PythonAnywhere verzija komandne linije, koja izgleda kao ona na Vašem računaru.
+
+![Odeljak "New Console" (nova konzola) na PythonAnywhere interfejsu, sa dugmetom za "bash"](images/pythonanywhere_bash_console.png)
+
+> **Napomena** PythonAnywhere se zasniva na Linux-u, tako da će konzola izgledati drugačije od one na Vašem računaru ukoliko koristite Windows.
+
+Dopremanje veb aplikacije na PythonAnywhere uključuje povlačenje koda sa GitHub-a i zatim konfigurisanje okruženja kako bi kod bio prepoznat kao veb aplikacija. Postoje načini na koje to može ručno da se uradi, ali PythonAnywhere obezbeđuje pomoćni alat koji će to sve uraditi umesto Vas. Hajde da ga prvo instaliramo:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+Ovo bi trebalo da ispiše neke stvari kao `Collecting pythonanywhere` i da se eventualno završi natpisom `Successfully installed (...) pythonanywhere- (...)`.
+
+Sada treba da pokrenemo alat koji će nam pomoći da automatski konfigurišemo našu aplikaciju sa GitHub-a. Ukucajte sledeće u konzolu na PythonAnywhere (ne zaboravite da upotrebite Vaše GitHub korisničko ime umesto `<your-github-username>`, tako da se URL poklapa sa URL-om za kloniranje sa GitHub-a):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+Dok posmatrate kako se to izvršava, moći ćete da vidite šta se dešava:
+
+- Preuzimanje Vašeg koda sa GitHub-a
+- Kreiranje virtuelnog okruženja na PythonAnywhere, koje je kao ono na Vašem računaru
+- Ažuriranje fajla sa podešavanjima
+- Pokretanje baze podataka na PythonAnywhere korišćenjem `manage.py migrate` komande
+- Podešavanje statičkih fajlova (pričaćemo više o njima kasnije)
+- Konfigurisanje PythonAnywhere da radi sa Vašom aplikacijom putem API-ja
+
+Na PythonAnywhere su svi ovi koraci automatizovani i isti su kao i svi koraci kroz koje bi trebalo da prođete ako koristite nekog drugog server provajdera.
+
+Glavna stvar koju treba da primetite je da je Vaša baza podataka na PythonAnywhere u potpunosti razdvojena od baze podataka na Vašem računaru, tako da može da ima drugačije naloge za postovanje i za administratore. Kao rezultat, trebalo bi da inicijalizujemo admin nalog pomoću `createsuperuser`, kao što smo to uradili na Vašem računaru. PythonAnywhere je automatski pokrenuo virtuelno okruženje za Vas, tako da je sve što treba da uradite pokretanje sledećih komandi:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Unesite podatke o administratoru. Najbolje je da koristite iste one kao na Vašem računaru, kako bi se izbegla bilo kakva zabuna, osim ako ne želite da šifru na PythonAnywhere dodatno osigurate.
+
+Sada, ukoliko to želite, možete da pogledate Vaš kod na PythonAnywhere korišćenjem naredbe `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+Možete takođe da odete na stranicu "Files" (fajlovi) i da je pretražujete koristeći ugrađeni PythonAnywhere pretraživač. (Sa stranice sa konzolom možete da odete do ostalih PythonAnywhere stranica iz menija u gornjem desnom uglu). Kada se jednom nađete na nekoj od stranica, blizu vrha možete da pronađete linkove do ostalih)
+
+## Oživeli ste projekat!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Napomena** Ovo je priručnik za početnike i zbog toga smo tokom dopremanja ovog sajta primenili nekoliko prečica koje nisu baš idealne, gledano sa stanovišta sigurnosti. Ako i kada odlučite da nadogradite na ovaj projekat ili započnete novi projekat, trebalo bi da pogledate [ Kontrolni spisak za postavljanje u Djangu ](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) za neke savete o obezbeđivanju web lokacije.
+
+## Saveti za otklanjanje grešaka
+
+Ukoliko vidite grešku tokom pokretanja skripte `pa_autoconfigure_django.py`, evo nekoliko uobičajenih razloga:
+
+- Možda ste zaboravili da kreirate PythonAnywhere API token.
+- Možda ste pogrešili u GitHub URL-u
+- Ukoliko vidite poruku *"Could not find your settings.py"*, verovatno niste uspeli da dodate sve Vaše fajlove na Git i/ili ih niste postavili uspešno na GitHub. Pogledajte još jednom prethodni deo koji se odnosi na Git
+- Ako ste se prethodno prijavili za PythonAnywhere nalog i imali ste grešku sa collectstatic, verovatno imate stariju verziju SQLite (npr. 3.8.2) za svoj nalog. U tom slučaju se prijavite za novi nalog i isprobajte naredbe iz gornjeg odeljka PythonAnywhere.
+
+Ako dobijate poruku o grešci kada pokušate da odete na sajt, prvo mesto na kom bi trebalo da potražite više informacija o otklanjanju greške je **evidencija o greškama** (eng. error log). Možete da pronađete link do te evidencije na PythonAnywhere ["Web" stranici](https://www.pythonanywhere.com/web_app_setup/). Pogledajte da li se tu nalaze bilo kakve poruke o greškama; one najnovije se nalaze na dnu.
+
+Takođe postoje i neki [opšti saveti o uklanjanju grešaka na PythonAnywhere sajtu za pomoć](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+I zapamtite, Vaš instruktor je tu da Vam pomogne!
+
+# Pogledajte svoj sajt!
+
+Na podrazumevanoj stranici za Vaš sajt bi trebalo da piše "It worked!" (Uspeh!), kao i na Vašem lokalnom računaru. Pokušajte da dodate nastavak `/admin/` na kraju URL-a i to će vas odvesti na sajt za administratore. Ulogujte se sa korisničkim imenom i šifrom i videćete da možete da dodate nove postove na server, samo zapamtite - postovi sa Vaše lokalne baze podataka za testiranje se ne šalju na Vaš blog.
+
+Jednom kada kreirate nekoliko postova, možete da se vratite na Vaša lokalna podešavanja (ne na PythonAnywhere). Odatle bi trebalo da radite na lokalnim podešavanjima, ukoliko biste želeli da napravite neku izmenu. To je uobičajeni tok rada u veb programiranju - napravite izmene lokalno, postavite to na GitHub i zatim ih pošaljete dalje na vaš veb server. To omogućava da radite i eksperimentišete bez obustavljanja rada Vašeg sajta. Prilično kul, zar ne?
+
+Potapšite sebe po ramenu, jer to i zaslužujete! Dopremanje na server je jedna od težih stvari u veb razvoju i često je potrebno ljudima po nekoliko dana da to savladaju. Ali Vi ste uspeli da pokrenete svoj sajt uživo na internetu!
\ No newline at end of file
diff --git a/sr-CS/deploy/install_git.md b/sr-CS/deploy/install_git.md
new file mode 100644
index 00000000000..6eeea4e5326
--- /dev/null
+++ b/sr-CS/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git je "kontrolni sistem za ažuriranje programa" koji koristi veliki broj programera. Ovaj softver može da prati promene u fajlovima tako da u nekom trenutku možete da pozovete neku od prošlih verzija programa. To je slično opciji "praćenja promena" u programima za obradu teksta (kao što su npr. Microsoft Word ili LibreOffice Writer), samo što je mnogo moćnije.
+
+## Instaliranje Git-a
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Možete da preuzmete Git sa [git-scm.com](https://git-scm.com/). Možete da kliknete na "next" (sledeći korak) tokom svakog koraka, osim u dva slučaja: u koraku gde treba da izaberete editor (potrebno je da izaberete Nano) i u koraku koji se zove "Adjusting your PATH environment" (prilagođavanje Vašeg PATH okruženja), gde treba da izaberete opciju na dnu - "Use Git and optional Unix tools from the Windows Command Prompt" (Koristite Git i Unix alate iz Windows komandne linije). Osim toga, podrazumevane opcije su u redu. Opcija "Checkout Windows-style, commit Unix-style line endings" je dobra.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Preuzmite Git sa linka [git-scm.com](https://git-scm.com/) i pratite instrukcije.
+
+> **Napomena** Ukoliko imate operativni sistem X 10.6, 10.7 ili 10.8, potrebno je da preuzmete verziju sa ovog linka: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sr-CS/deploy/signup_pythonanywhere.md b/sr-CS/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..715829c5f0a
--- /dev/null
+++ b/sr-CS/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere je servis za pokretanje Python kodova na cloud serverima. Mi ćemo ga koristiti za hostovanje našeg sajta, uživo i na internetu.
+
+Hostovaćemo blog koji pravimo na PythonAnywhere. Ulogujte se na nalog za "početnike" na PythonAnywhere (najniži nivo je u redu, neće Vam trebati kreditna kartica).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![PythonAnywhere stranica za prijavljivanje ima dugme za kreiranje naloga za "početnike"](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Napomena** Prilikom izbora korisničkog imena, imajte na umu da će URL Vašeg bloga imati formu `korisničkoime.pythonanywhere.com`, tako da bi trebalo da birate ili Vaše ime, nadimak ili naziv onoga o čemu je taj blog. Takođe, pobrinite se da zapamtite šifru (dodajte je u Vaš oraganizator šifara (eng. password manager), ako ga koristite).
+
+## Kreiranje PythonAnywhere API tokena
+
+Ovo je nešto što treba da se uradi samo jednom. Kada napravite nalog na PythonAnywhere, bićete prebačeni na Vašu kontrolnu tablu. Sa gornje desne strane pronađite link do stranice sa Vašim nalogom:
+
+![Link do naloga na gornjem desnom delu stranice](../deploy/images/pythonanywhere_account.png)
+
+Zatim izaberite karticu koja se zove "API token" i kliknite na dugme koje se zove "Create new API token" (kreiraj novi API token).
+
+![Kartica API tokena na stranici naloga](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/sr-CS/django/README.md b/sr-CS/django/README.md
new file mode 100644
index 00000000000..a57b92e20a7
--- /dev/null
+++ b/sr-CS/django/README.md
@@ -0,0 +1,27 @@
+# Šta je Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) je besplatna aplikacija i biblioteka otvorenog koda, napisana u Python-u. Veb biblioteka je skup napisanih komponenata koje pomažu da brže i lakše razvijete sajtove.
+
+Kada pravite veb sajt, uvek Vam je potreban sličan skup komponenata: način na koji ćete da se izborite sa potvrđivanjem autentičnosti korisnika (npr. logovanje ili pravljenje naloga), kontrolni panel za veb sajt, forme, načini učitavanja fajlova itd.
+
+Srećom, ljudi su davno primetili da se veb developeri suočavaju sa sličnim problemima tokom pravljenja nekog sajta, tako da su se udružili i stvorili biblioteke (Django je jedna od njih) koje Vam obezbeđuju gotove komponente koje mogu da se koriste.
+
+Biblioteke postoje kako bi Vas poštedele izmišljanja stvari koje već postoje i da bi Vam ublažile indirektne troškove tokom pravljenja novog sajta.
+
+## Zašto Vam je potrebna biblioteka?
+
+Kako biste razumeli za šta Django služi, moramo da malo bolje pogledamo servere i njihov način rada. Prva stvar koju server treba da zna je to da želite da podrži vašu veb stranicu.
+
+Zamislite poštansko sanduče (u ovom slučaju port) koje se nadgleda zbog nadolazećih pisama (u ovom slučaju su to zahtevi). To se obavlja pomoću veb servera. Veb server će da pročita pristiglo pismo i zatim da pošalje odgovor pomoću veb stranice. Međutim, kada nešto želite da pošaljete, morate da imate nekakav sadržaj te pošiljke. Django je upravo nešto što Vam pomaže da kreirate taj sadržaj.
+
+## Šta se desi kada neko uputi zahtev veb sajtu sa Vašeg servera?
+
+Kada zahtev dođe do veb servera, prosleđuje se Django-u koji pokušava da otkrije šta je zapravo sadržaj tog zahteva. Prvo uzima adresu veb stranice i pokušava da shvati šta s tim da radi. Ovaj deo se obavlja pomoću Django **urlresolver-a** (primetite da se veb adresa zapravo zove URL (eng. Uniform Resource Locator), tako da je ime *urlresolver* prilično smisleno). To nije preterano komplikovano - uzima se lista šablona i pokušava se da se pronađe odgovarajući URL. Django pregleda šablone od vrha ka dnu i ukoliko pronađe poklapanje, tada se prosleđuje zahtev nekoj dodeljenoj funkciji (koja se naziva *view* (prikaz)).
+
+Zamislite poštara sa pismom. On prolazi kroz ulicu i proverava svaki broj kuće u odnosu na onaj na pismu. Ukoliko nađe poklapanje, tu dostavi pismo. To je način na koji radi urlresolver!
+
+U *view* funkciji se dešavaju sve zanimljive stvari: možemo da pogledamo bazu podataka kako bismo potražili neku informaciju. Možda korisnik želi da promeni neke podatke? Isto kao što bi u tom metaforičkom pismu bilo napisano "Molim Vas, promenite opis mog posla", *view* funkcija može da proveri da li ste ovlašćeni da to uradite, a zatim da promeni opis posla za Vas i da Vam pošalje poruku - "Urađeno!" Tada *view* generiše odgovor, a Django može da ga pošalje do korisnikovog pretraživača.
+
+Prethodni opis je malo pojednostavljen, ali Vam još uvek nije potrebno da znate sve tehničke stvari. Trenutno je opšta slika dovoljna.
+
+Umesto da ulazimo previše u detalje, počećemo da pravimo nešto uz pomoć Django-a i naučićemo usput važne lekcije!
\ No newline at end of file
diff --git a/sr-CS/django_admin/README.md b/sr-CS/django_admin/README.md
new file mode 100644
index 00000000000..0a66bbbda23
--- /dev/null
+++ b/sr-CS/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django Admin
+
+Kako bismo dodali, izmenili ili izbrisali postove koje smo upravo podesili, koristićemo Django admina.
+
+Hajde da otvorimo `blog/admin.py` fajl u editoru i da zamenimo njegov sadržaj ovim:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Kao što možete da vidite, uvozimo model posta koji je definisan u prethodnom poglavlju. Kako bi naš model bio vidljiv na admin stranici, potrebno je da ga registrujemo pomoću `admin.site.register(Post)`.
+
+Ok, vreme je da pogledamo naš model. Ne zaboravite da pokrenete `python manage.py runserver` u konzoli kako biste pokrenuli veb server. Idite na Vaš pretraživač i ukucajte adresu http://127.0.0.1:8000/admin/. Trebalo bi da vidite stranicu koja ovako izgleda:
+
+![Stranica za prijavljivanje](images/login_page2.png)
+
+Kako biste se ulogovali, potrebno je da kreirate *superuser-a* (super korisnika) - korisnički nalog koji ima kontrolu nad svim stvarima na tom sajtu. Zatim se vratite na komandnu liniju i ukucajte `python manage.py createsuperuser` i pritisnite enter.
+
+> Ne zaboravite da napišete nove komande dok je veb server pokrenut, da otvorite nov prozor terminala i da aktivirate virtuelno okruženje. Pokazali smo kako da napišete nove komande u poglavlju **Vaš prvi Django projekat!**, u delu **Pokretanje veb servera**.
+
+{% filename %}Mac OS X ili Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Nakon toga, ukucajte svoje korisničko ime (malim slovima, bez razmaka), e-mail adresu i šifru. **Ne brinite ako ne možete da vidite šifru dok je kucate - to tako i treba da bude.** Zatim pritisnite `enter` da biste nastavili. Izlaz bi trebalo da izgleda ovako (gde bi korisničko ime i e-mail trebalo da budu Vaši):
+
+    Korisničko ime: ola
+    E-mail adresa ola@example.com
+    Šifra:
+    Šifra (ponovo):
+    Super korisnik je uspešno kreiran.
+    
+
+Vratite se na svoj pretraživač. Ulogujte se sa podacima super korisnika koje ste odabrali; trebalo bi da vidite Django kontrolnu tablu za admine.
+
+![Django Admin](images/django_admin3.png)
+
+Idite na postove i eksperimentišite malo s njima. Dodajte pet ili šest postova na blogu. Ne brinite za sadržaj - to je vidljivo isključivo na Vašem lokalnom računaru. Možete da prekopirate neki tekst iz ovog priručnika, kako biste uštedeli vreme. :)
+
+Pobrinite se da najmanje dva ili tri posta (ali ne svi) imaju podešen datum objave. To će kasnije biti od koristi.
+
+![Django Admin](images/edit_post3.png)
+
+Ako želite znati više o administratoru Django, proverite Djangovu dokumentaciju: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Ovo je verovatno zgodan trenutak da uzmete kafu (ili čaj) ili nešto da pojedete i da se osvežite. Uspeli ste da napravite Vaš prvi Django model - zaslužujete da se malo odmorite!
\ No newline at end of file
diff --git a/sr-CS/django_forms/README.md b/sr-CS/django_forms/README.md
new file mode 100644
index 00000000000..817755318df
--- /dev/null
+++ b/sr-CS/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forme
+
+Na kraju, stvar koju želimo da uradimo na našem blogu je da omogućimo da se lako dodaju i izmenjuju postovi. Django `admin` je kul, ali ga je teško prilagoditi i učiniti lepim. Uz pomoć `formi` možemo da imamo apsolutnu kontrolu nad našim interfejsom - možemo da uradimo skoro sve što zamislimo!
+
+Dobra stvar u vezi sa Django formama je ta što možemo ili da ih definišemo ispočetka ili možemo da definišemo `formu modela` koja će sačuvati rezultat forme za model.
+
+To je upravo ono što želimo da uradimo: da kreiramo formu za naš `Post` model.
+
+Kao i svaki važan deo Django biblioteke, forme imaju svoj fajl: `forms.py`.
+
+Moramo da kreiramo fajl sa ovakvim nazivom u `blog` direktorijumu.
+
+    blog
+       └── forms.py
+    
+
+Ok, hajde da to otvorimo u editoru i da ukucamo sledeći kod:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Prvo moramo da uvezemo listu sa Django formama (ukucaćemo `from django import forms`) i naš `Post` model (naredbom `from .models import Post`).
+
+`PostForm` je, kao što možete i da pretpostavite, naziv naše forme. Moramo da kažemo Django-u da je ta forma u stvari `forma modela` (tako da Django može da odradi magičan deo posla za nas) - za to je odgovorna `forms.ModelForm` komanda.
+
+Zatim, imamo `class Meta` naredbu, gde kažemo Django-u koji model bi trebalo da se koristi da se napravi ova forma (`model = Post`).
+
+Konačno, možemo da kažemo koja polja bi trebalo da budu u našoj formi. U ovom slučaju želimo da jedino `naslov` i `tekst` budu vidljivi - `autor` bi trebalo da bude osoba koja je trenutno ulogovana (Vi), a `datum` bi trebalo da bude automatski podešen kada kreiramo post (npr. u kodu).
+
+To je sve! Ono što treba sada da uradimo je da iskoristimo formu u *pregledu* i da je prikažemo u obrascu.
+
+Dakle, još jednom ćemo kreirati link do stranice, URL, pregled i obrazac.
+
+## Link do stranice sa formom
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new prikaz
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Šablon
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* Moramo da prikažemo formu. To možemo da uradimo (na primer) uz pomoć linije {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Potrebno nam je `Sačuvaj` dugme. To radimo pomoću HTML dugmeta: `<button type="submit">Sačuvaj</button>`.
+* I na kraju, odmah nakon otvaranja `<form ...>` taga, moramo da dodamo {% raw %}`{% csrf_token %}`{% endraw %}. Ovo je veoma važno jer čini Vašu formu bezbednom! Ako to zaboravite, Django će da se žali kada pokušate da sačuvate formu:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Čuvanje forme
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Validacija forme
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Uređivanje forme
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Sigurnost
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Još jedna stvar: vreme razvijanja!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* Prvo otkucajte Vaš kod i postavite ga na GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Zatim, u [PythonAnywhere Bash konzoli](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Konačno, idite na [veb stranicu](https://www.pythonanywhere.com/web_app_setup/) (koristite dugme za meni u gornjem desnom uglu konzole) i kliknite na **osveži**. Osvežite Vaš https://subdomain.pythonanywhere.com blog da vidite izmene.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/sr-CS/django_installation/README.md b/sr-CS/django_installation/README.md
new file mode 100644
index 00000000000..a3864e1ae11
--- /dev/null
+++ b/sr-CS/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django instalacija
+
+> **Napomena** Ukoliko koristite Chromebook, preskočite ovo poglavlje i postarajte se da sledite instrukcije navedene u [Chromebook podešavanjima](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/sr-CS/django_installation/instructions.md b/sr-CS/django_installation/instructions.md
new file mode 100644
index 00000000000..c90fbcf5ca6
--- /dev/null
+++ b/sr-CS/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Deo ove sekcije je zasnovan na Geek Girls Carrots priručnicima (https://github.com/ggcarrots/django-carrots/).
+> 
+> Takođe, jedan deo je zasnovan na [django-marcador priručniku](http://django-marcador.keimlink.de/) pod Creative Commons Attribution-ShareAlike 4.0 International licencom. Sva prava za django-marcador priručnik zadržava Markus Zapke-Gründemann.
+
+## Virtuelno okruženje
+
+Pre nego što instaliramo Django, potrebno je instalirati prilično koristan alat koji je odgovoran za preglednost okruženja u kom se kodira. Ovaj korak se može preskočiti, ali to nije preporučljivo. Počinjanje sa najboljim mogućim podešavanjima će Vas poštedeti dosta muka u budućnosti!
+
+Hajde da napravimo **virtuelno okruženje** (koje se takođe naziva još i *virtualenv*). Virtualenv će izolovati podešavanja za Python/Django za svaki projekat posebno. To znači da bilo koja izmena koju napravite na jednom sajtu neće imati uticaja na ostale sajtove koje trenutno pravite. Lepo, zar ne?
+
+Sve što treba da uradite je da pronađete direktorijum u kom želite da kreirate `virtualenv`; na primer, vaš početni direktorijum. Na Windows-u, to bi trebalo da izgleda ovako `C:\Users\Name` (gde je `Name` ime vašeg naloga).
+
+> **NAPOMENA:** Ukoliko koristite Windows, pobrinite se da ovaj direktorijum ne sadrži akcentovane ili neke specijalne karaktere. Ako Vaše korisničko ime sadrži akcentovane karaktere, upotrebite drugi direktorijum, npr. `C:\djangogirls`.
+
+Za ovaj priručnik ćemo koristiti novi direktorijum `djangogirls`, iz Vašeg početnog direktorijuma:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Napravićemo virtualenv po imenu `myvenv`. Glavna komanda će biti u formatu:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Kako biste kreirali novi `virtualenv`, potrebno je da otvorite komandnu liniju i da pokrenete `python -m venv myvenv`. To bi trebalo da izgleda ovako:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Gde je `myvenv` ime Vašeg `virtualenv-a`. Možete da koristite bilo koje drugo ime, ali je potrebno da sadrži isključivo mala slova i da nema razmake, akcente ili neke specijalne karaktere. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Možemo da kreiramo `virtualenv` i na Linux-u i na OS X, pokretanjem `python3 -m venv myvenv`. To bi trebalo da izgleda ovako:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` je ime Vašeg `virtualenv-a`. Možete da koristite bilo koje drugo ime, ali je potrebno da sadrži isključivo mala slova i da nema razmake. Takođe je dobra ideja da ime bude kratko, jer ćete ga često pisati!
+
+> **NAPOMENA:** Na nekim verzijama Debian/Ubuntu-a možete da dobijete sledeću grešku:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> U tom slučaju, pratite instrukcije koje su prethodno navedene i instalirajte `python3-venv` paket: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NAPOMENA:** Na nekim verzijama Debian/Ubuntu-a, pokretanje virtuelnog okruženja vraća sledeću grešku:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Kako biste to zaobišli, koristite komandu `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NAPOMENA:** Ukoliko dobijete grešku
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> Tada pokrenite:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Rad sa virtualenv-om
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Pokrenite Vaše virtuelno okruženje komandom:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. U tom slučaju, otvorite još jedan Windows PowerShell pomoću opcije "Pokreni kao administrator". Zatim, pre pokretanja virtuelnog okruženja, ukucajte sledeću komandu:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Instaliranje paketa i neophodnih stavki
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/sr-CS/django_models/README.md b/sr-CS/django_models/README.md
new file mode 100644
index 00000000000..a8fc2e3c7ba
--- /dev/null
+++ b/sr-CS/django_models/README.md
@@ -0,0 +1,201 @@
+# Django modeli
+
+Ono što želimo sada da napravimo je nešto što će da skladišti sve postove sa našeg bloga. Da bismo to uradili, potrebno je da se upoznamo sa stvarima koje se nazivaju `objekti`.
+
+## Objekti
+
+U programiranju postoji jedan koncept koji se naziva `objektno-orijentisano programiranje`. Ideja je da možemo da modelujemo stvari i definišemo način na koji interaguju međusobno, umesto da pišemo sve kao deo jedne sekvence programskog koda.
+
+Dakle, šta je to objekat? To je skup svojstava i akcija. Možda to zvuči čudno, ali daćemo Vam primer.
+
+Ako želimo da modelujemo mačku, kreiraćemo objekat `Mačka` koji ima svojstva kao što su `boja`, `godine`, `raspoloženje` (npr. dobro, loše ili pospano ;)) i `vlasnik` (što može biti pripisano objektu `Osoba`, ili možda u slučaju mačke lutalice, ovo može da ostane prazno polje).
+
+Zatim, `Mačka` ima određene akcije: `predenje`, `grebanje` ili `hranjenje` (u tom slučaju ćemo da damo mački `HranuZaMačke`, što može da bude poseban objekat sa svojstvima kao što je npr. `ukus`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+U suštini, ideja je da opišemo realne stvari u kodu pomoću svojstava (koja se nazivaju `svojstva objekta`) i akcija (koje se nazivaju `metode`).
+
+Kako ćemo u tom slučaju da modelujemo postove na blogu? Želimo da napravimo blog, zar ne?
+
+Moramo da odgovorimo na pitanje: šta je to zapravo blog post? Koja svojstva bi trebalo da ima?
+
+Pa, naš blog sigurno treba da ima tekst sa svojim sadržajem i naslovom, zar ne? Takođe, bilo bi dobro da znamo ko je napisao tekst - znači potreban nam je autor. I na kraju, želimo da znamo kada je post kreiran i objavljen.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Kakve sve stvari mogu da se urade sa postom? Bilo bi lepo da postoji neki `metod` koji objavljuje post, zar ne?
+
+To znači da će nam trebati metod za `objavljivanje`.
+
+Pošto znamo šta želimo da postignemo, hajde da krenemo da to modelujemo u Django-u!
+
+## Django model
+
+Ako znamo šta nam je objekat, možemo da kreiramo Django model za naš blog post.
+
+Model u Django-u je posebna vrsta objekta i čuva se u `bazi podataka`. To je skup podataka. Takoreći, to je mesto gde se skladište informacije o korisnicima, postovima itd. Za skladištenje naših podataka ćemo koristiti SQLite bazu podataka. To je podrazumevani Django adapter za bazu podataka i za sada nam je to sasvim dovoljno.
+
+Možete da zamislite model u bazi podataka kao jednu veliku tabelu sa kolonama koje predstavljaju polja i redovima koji predstavljaju podatke.
+
+### Kreiranje aplikacije
+
+Kako bismo sve držali uredno, kreiraćemo posebnu aplikaciju unutar našeg projekta. Veoma je lepo imati sve organizovano od samog početka. Da bismo kreirali aplikaciju, potrebno je da pokrenemo sledeću komandu u konzoli (iz `djangogirls` direktorijuma, gde se nalazi fajl `manage.py`):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Primetićete da je kreiran novi `blog` direktorijum i da sadrži broj fajlova. Direktorijumi i fajlovi u našem projektu bi trebalo da izgledaju ovako:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+Nakon kreiranja aplikacije, moramo na neki način da kažemo Django-u da treba da je koristi. To radimo u fajlu `mysite/settings.py` - otvorite ga u editoru. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. Tako da, na kraju to treba da izgleda ovako:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Kreiranje modela posta
+
+U fajlu `blog/models.py` definišemo sve objekte koji se nazivaju `Modeli` - to je mesto u kom ćemo da definišemo naš blog post.
+
+Hajde da otvorimo `blog/models.py` u editoru, uklonimo sve iz fajla i da napišemo kod koji izgleda ovako:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Proverite da li koristite dve donje crte (`_`) na svakoj strani `str`. Ova konvencija se često koristi u Python-u i ponekad to nazivamo "dunder" (skraćeno od "double-underscore").
+
+Izgleda zastrašujuće, zar ne? Ali, ne brinite - objasnićemo Vam šta ove linije znače!
+
+Sve linije koje počinju sa `from` ili `import` su linije koje dodaju neke bite iz drugih fajlova. Tako da, umesto da kopirate uvek istu stvar u svakom fajlu, sada možete da jednostavno uključite neke delove pomoću `from... import ...`.
+
+`class Post(models.Model):` – ova linija definiše naš model (kao `objekat`).
+
+- `class` je specijalna reč koja ukazuje na to da definišemo objekat.
+- `Post` je ime našeg modela. Možemo da mu damo drugačiji naziv (ali moramo da izbegnemo specijalne karaktere i razmake). Uvek treba pisati ime klase velikim početnim slovom.
+- `models.Model` znači da je Post u stvari Django Model, tako da Django zna da bi trebalo da ga sačuva u bazi podataka.
+
+Zatim, definišemo svojstva o kojima smo pričali: `naslov`, `tekst`, `datum_kreiranja`, `datum_objave` i `autor`. Da bismo to uradili, potrebno je da definišemo tip svakog polja (da li je to tekst? Broj? Datum? Relacija sa drugim objektom, kao npr. korisnik?)
+
+- `models.CharField` - ovo je način da definišete tekst sa ograničenim brojem karaktera.
+- `models.TextField` - ovo je način da predstavite dug tekst, bez ograničenja. Zvuči savršeno za sadržaj posta, zar ne?
+- `models.DataTimeField` - ovo predstavlja datum i vreme.
+- `models.ForeignKey` - ovo je link do drugog modela.
+
+Ovde nećemo objašnjavati svaku sitnicu u kodu, jer bi za to trebalo previše vremena. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+Šta je sa `def publish(self):`? Ovo je upravo metod za `objavljivanje` o kom smo pričali ranije. `def` znači da je u pitanju funkcija/metod, a `publish` je ime metoda. Ako želite, možete da ga promenite. Jedino pravilo je da koristite mala slova i donje crte umesto razmaka. Na primer, metod koji izračunava prosečnu cenu bi se mogao nazvati `calculate_average_price`.
+
+Metodi često vraćaju nešto naredbom `return`. Postoji jedan primer toga u `__str__` metodu. U tom slučaju, kada pozovemo `__str__()` dobijamo tekst (**string**) sa naslovom posta.
+
+Takođe, primetite da su i `def publish(self):` i `def __str__(self):` uvučeni unutar naše klase. Pošto je Python osetljiv na razmake, moramo da uvučemo metode unutar klase. U suprotnom, metodi neće pripadati klasi i može da se dogodi neko neočekivano ponašanje.
+
+Ukoliko Vam nešto još uvek nije jasno u vezi sa modelima, slobodno pitajte svog mentora. Znamo da je komplikovano, naročito kada učite o objektima i funkcijama u isto vreme. Ali, nadamo se da sada vidite malo jasniju sliku!
+
+### Kreiranje tabela za modele u Vašoj bazi podataka
+
+U poslednjem koraku ćemo dodati naš novi model u bazu podataka. Prvo, moramo da obavestimo Django-a da imamo neke izmene u našem modelu. (Upravo smo ih napravili!) Idite na prozor sa konzolom i ukucajte `python manage.py makemigrations blog`. To bi trebalo da izgleda ovako:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Napomena:** Ne zaboravite da zapamtite fajlove koje izmenite. U suprotnom će Vaš računar da izvrši prethodnu verziju i mogu da se jave neke neočekivane greške.
+
+Django je pripremio fajl za nas, koji sada treba da upotrebimo u našoj bazi podataka. Ukucajte `python manage.py migrate blog` i izlaz bi trebalo da izgleda ovako:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Uspeli smo! Naš post model se sada nalazi u bazi podataka! Bilo bi lepo da možemo da ga vidimo, zar ne? Pogledajte u sledećem poglavlju kako naš post sada izgleda!
\ No newline at end of file
diff --git a/sr-CS/django_orm/README.md b/sr-CS/django_orm/README.md
new file mode 100644
index 00000000000..b36c675567b
--- /dev/null
+++ b/sr-CS/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM i Query postavke
+
+U ovom poglavlju ćemo naučiti kako se Django povezuje sa bazom podataka i kako čuva te podatke. Hajde da to otkrijemo!
+
+## Šta su to Query postavke?
+
+Query postavke (eng. QuerySets) su lista objekata za dati model. One omogućavaju da čitate podatke iz baze, da ih filtrirate i sortirate.
+
+Najlakše je da to naučite na primeru. Hajde da to pokušamo, hoćemo li?
+
+## Django shell
+
+Otvorite Vašu lokalnu konzolu (ne onu na PythonAnywhere) i ukucajte ovu komandu:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Trebalo bi da dobijete ovo:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Sada ste u Django interaktivnoj konzoli. To je nešto slično Python konzoli, samo sa dodatnim Django efektima :) Ovde takođe možete da koristite Python naredbe.
+
+### Svi objekti
+
+Hajde prvo da pokušamo da prikažemo sve naše postove. To možete da uradite sledećom komandom:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Ups! Pojavila se greška koja nam govori da post ne postoji. To je tačno - zaboravili smo da ga prvo uvezemo!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+Uvešćemo model `Post` iz `blog.models`. Hajde da sada ponovo pokušamo da prikažemo sve postove:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Ovo je lista postova koje smo ranije kreirali. To smo učinili koristeći Django admin interfejs. Ali sada želimo da kreiramo nove postove koristeći Python. Kako ćemo to da uradimo?
+
+### Kreirajte objekat
+
+Ovo je način na koji kreirate novi post objekat u bazi podataka:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Ali nam nešto ovde nedostaje: `mi`. Potrebno je da prosledimo instancu modela `korisnik` kao autora. Kako da to uradimo?
+
+Hajde da prvo uvezemo model korisnika:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Koje sve korisnike imamo u našoj bazi podataka? Pokušajte ovo da ukucate:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+Ovo je super korisnik, kog smo kreirali ranije! Hajde da sada dobijemo instancu korisnika (prilagodite ovu liniju tako da u njoj piše Vaše korisničko ime):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Kao što možete da vidite, sada dobijamo `korisnika` sa `korisničkim imenom` 'ola'. Odlično!
+
+Sada konačno možemo da kreiramo naš post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Uspeli smo! Želite li da proverite da li radi?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Evo ga, još jedan post na listi!
+
+### Dodajte još postova
+
+Sada možete i da se malo zabavite i da dodajete još postova kako biste razumeli kako ovo funkcioniše. Dodajte još 2-3 posta i pređite na naredni deo.
+
+### Filtrirajte objekte
+
+Važan deo Query postavki je mogućnost da ih filtrirate. Hajde da pokušamo da pronađemo sve postove koje je kreirao korisnik "ola". Koristićemo `filter` umesto `all` u `Post.objects.all()`. U zagradama navodimo uslove koje postovi treba da zadovolje kako bi završili u našim query stavkama. U ovom slučaju, uslov je da `autor` treba da bude isto što i `ja`. Način na koji ćemo to predstaviti U Django-u je `author=me`. Sada, naš deo koda izgleda ovako:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Ili možda želimo da vidimo sve postove koji sadrže reč "naslov" (eng. title) u `naslovu`?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Napomena** Postoje dve donje crte (`_`) između `naslova` i `sadržaja`. Django ORM korisnici koriste to pravilo da razdvoje nazive ("title") i operacije ili filtere ("contains"). Ukoliko koristite samo jednu donju crtu, dobićete grešku koja govori da te ključne reči ne postoje (eng. "FieldError: Cannot resolve keyword title_contains").
+
+Možete takođe da dobijete listu svih objavljenih postova. To radimo filtriranjem svih postova koji imaju `published_date` podešen u prošlosti:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Nažalost, post koji smo dodali pomoću Python konzole nije još uvek objavljen. Ali, to možemo da promenimo! Prvo je potrebno da dobijemo instancu željenog posta:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+A zatim da ga objavimo pomoću našeg `publish` metoda (metoda za objavljivanje):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Pokušajte sada da ponovo dobijete listu objavljenih postova (pritisnite tri puta strelicu na gore, a zatim pritisnite `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Sortiranje objekata
+
+Query stavke Vam takođe omogućavaju da sortirate listu objekata. Hajde da pokušamo da ih sortiramo pomoću `created_date` polja:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Možemo takođe i da obrnemo redosled sortiranog niza, dodavanjem `-` na samom početku:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Kompleksni upiti i ulančane metode
+
+Kao što ste i videli, neke metode iz `Post.objects` vraćaju query stavke. Iste metode se zapravo mogu pozivati i za same query stavke, nakon čega bi vraćale nove query stavke. Tako da, možete to da kombinujete **ulančavanjem** tih metoda zajedno:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Ovo je prilično moćno svojstvo i omogućava Vam da pišete prilično kompleksne upite.
+
+Odlično! Sada ste spremni za sledeći deo! Da zatvorite shell, ukucajte sledeće:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/sr-CS/django_start_project/README.md b/sr-CS/django_start_project/README.md
new file mode 100644
index 00000000000..b37176d3fa9
--- /dev/null
+++ b/sr-CS/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Vaš prvi Django projekat!
+
+> Deo ovog poglavlja je zasnovan na priručnicima iz Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Delovi ovog poglavlja su takođe zasnovani na [django-marcador priručniku](http://django-marcador.keimlink.de/), pod Creative Commons Attribution-ShareAlike 4.0 Internacionalnom Licencom. Sva prava za django-marcador priručnik zadržava Markus Zapke-Gründemann.
+
+Napravićemo mali blog!
+
+Prvi korak je da pokrenemo novi Django projekat. U suštini, to znači da ćemo pokrenuti neke skripte napisane u Django-u koje će kreirati kostur našeg Django projekta. To je samo skup direktorijuma i fajlova koji ćemo kasnije koristiti.
+
+Imena nekih fajlova i direktorijuma su veoma važna. Ne biste smeli da menjate nazive tih fajlova, koje ćemo sada kreirati. Takođe, ni njihovo premeštanje u druge foldere nije dobra ideja. Django treba da održi određenu strukturu kako bi mogao da pronađe važne stvari.
+
+> Ne zaboravite da sve pokrenete u virtualenv-u. Ukoliko ne vidite u svojoj konzoli prefiks `(myvenv)`, potrebno je da aktivirate svoj virtualenv. Objasnili smo kako da to uradite u poglavlju **Django instalacija** u delu **Rad sa virtualenv-om**. To možete da uradite kucanjem `myvenv\Scripts\activate` na Windows-u ili `source myvenv/bin/activate` na Mac OS X ili Linux-u.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+Potrebno je da pokrenete sledeću komandu u Vašoj Mac OS ili Linux konzoli.** Ne zaboravite da dodate tačku `.` na kraju!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Tačka `.` je izuzetno važna jer govori skripti da instalira Django u trenutnom direktorijumu (za koji je ta tačka `.` referenca).
+> 
+> **Napomena** Kada kucate prethodnu komandu, zapamtite da kucate samo deo koji počinje sa `django-admin`. Deo `(myvenv) ~/djangogirls$` koji je ovde prikazan je samo primer ulaza gde treba da unesete input na Vašoj komandnoj liniji.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Na Windowsu bi trebalo da pokrenete sledeću komandu **(ne zaboravite da dodate tačku na kraju)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Tačka je jako važna jer govori skripti da instalira Django u trenutnom direktorijumu (za koji je ta tačka referenca).
+> 
+> **Napomena** Kada unosite prethodnu komandu, zapamtite da samo unosite deo koji počinje sa `django-admin.exe`. Deo `(myvenv) C:\Users\Name\djangogirls>` koji je ovde prikazan je samo primer ulaza koji očekuje Vaš input u komandnoj liniji.
+
+<!--endsec-->
+
+`django-admin.py` je skripta koja za Vas kreira direktorijume i fajlove. Sada bi trebalo da imate strukturu direktorijuma koja izgleda ovako:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Napomena**: U Vašoj strukturi direktorijuma, videćete takođe `venv` direktorijum koji smo ranije kreirali.
+
+`manage.py` je skripta koja pomaže u vezi sa organizovanjem sajta. Ona nam omogućava između ostalog da pokrenemo veb server na našem računaru bez dodatnih instalacija.
+
+Fajl `settings.py` sadrži konfiguraciju Vašeg veb sajta.
+
+Sećate li se priče o poštaru koji proverava gde da dostavi pismo? Fajl `urls.py` sadrži listu šablona koje koristi `urlresolver`.
+
+Zanemarimo za sada ostale fajlove, tako da ih nećemo menjati. Jedina stvar koju treba da zapamtite je da ne smete da ih obrišete!
+
+## Promena podešavanja
+
+Hajde da napravimo izmene u `mysite/settings.py`. Otvorite fajl pomoću editora koji ste ranije instalirali.
+
+**Napomena**: Ne zaboravite da je `settings.py` običan fajl, kao i svaki drugi. Možete da ga otvorite u editoru pomoću opcije "file -> open". Zatim bi trebalo da se otvori prozor pomoću kog možete da pronađete i izaberete `settings.py` fajl. Takođe, možete da otvorite fajl pronalaženjem djangogirls foldera na desktopu i desnim klikom na isti. Onda, sa liste izaberite editor. Važno je da izaberete editor jer možda imate druge programe koji su instalirani i koji mogu da otvore fajl ali ne mogu da ga izmene.
+
+Bilo bi lepo da imamo ispravno podešeno vreme na sajtu. Idite na [Wikipedia listu vremenskih zona](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) i kopirajte određenu vremensku zonu (eng. Time Zone) (npr. ` Evropa/Berlin`).
+
+U fajlu `settings.py` pronađite liniju koja sadrži `TIME_ZONE` i izmenite je tako da se odnosi na Vašu izabranu vremensku zonu. Na primer:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+Jezički kod se sastoji od jezika, npr. `en` za engleski ili `de` za Nemački, dok je državni kod npr. `de` za Nemačku ili `ch` za Švajcarsku. Ukoliko engleski nije Vaš maternji jezik, možete da dodate ovaj deo kako biste učinili da opcije i obaveštenja u Django-u budu na Vašem jeziku. Tako biste imali "Cancel" dugme prevedeno na Vaš jezik koji ste tu definisali. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+Ako želite neki drugi jezik, promenite jezički kod tako što ćete izmeniti sledeću liniju:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Takođe treba da dodamo putanju za statičke fajlove. (Naučićemo sve o njima i o CSS-u kasnije) Idite do kraja fajla i ispod `STATIC_URL` dela dodajte novi deo `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Kada je `DEBUG` podešen na `True` i kada je `ALLOWED_HOSTS` prazan, host se poredi sa `['localhost', '127.0.0.1', '[::1]']`. To neće odgovarati našem imenu hosta na PythonAnywhere kada postavimo našu aplikaciju, tako da moramo da izmenimo sledeća podešavanja:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Napomena**: Ukoliko koristite Chromebook, dodajte ovu liniju na dnu podešavanja settings.py fajla: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Takođe dodajte `.amazonaws.com` u `ALLOWED_HOSTS` ukoliko koristite cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Podesite bazu podataka
+
+Postoji puno različitih softvera koji rade sa bazama podataka. Mi ćemo koristiti podrazumevani - `sqlite3`.
+
+Ovo je već podešeno unutar `mysite/settings.py` fajla:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Hajde da ukucamo sledeću liniju u konzolu kako bismo kreirali bazu podataka za naš blog: `python manage.py migrate` (moramo da budemo u `djangogirls` direktorijumu koji sadrži `manage.py` fajl). Ukoliko je sve prošlo kako treba, trebalo bi da dobijete ovako nešto:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+I gotovi smo! Vreme je da pokrenemo veb server i da vidimo da li naš sajt radi!
+
+## Pokretanje veb servera
+
+Potrebno je da se nalazite u direktorijumu koji sadrži fajl `manage.py` (`djangogirls` direktorijum). U konzoli, možemo da pokrenemo server komandom `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Ako koristite Chromebook, koristite sledeću komandu umesto prethodno navedene:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> Napravili smo pregled toga kako server radi u poglavlju **Kako internet funkcioniše**.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/sr-CS/django_templates/README.md b/sr-CS/django_templates/README.md
new file mode 100644
index 00000000000..4a79e4107f2
--- /dev/null
+++ b/sr-CS/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django šabloni
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Slika 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Slika 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Slika 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/sr-CS/django_urls/README.md b/sr-CS/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/sr-CS/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/sr-CS/django_views/README.md b/sr-CS/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/sr-CS/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/sr-CS/dynamic_data_in_templates/README.md b/sr-CS/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..e2b4de18f8f
--- /dev/null
+++ b/sr-CS/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dinamični podaci u šablonima
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/sr-CS/extend_your_application/README.md b/sr-CS/extend_your_application/README.md
new file mode 100644
index 00000000000..d8a7444db9d
--- /dev/null
+++ b/sr-CS/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Proširite svoju aplikaciju
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/sr-CS/how_the_internet_works/README.md b/sr-CS/how_the_internet_works/README.md
new file mode 100644
index 00000000000..289d07f18eb
--- /dev/null
+++ b/sr-CS/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Kako internet radi
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Brauzeri su dizajnirani tako da razumeju ovaj kod, prate njegova uputsva i prikazuju ove fajlove od kojih se vaš veb-sajt sastoji, baš na način kako želite.
+
+Kao i sa svakim fajlom, HTML fajlove treba čuvati negde na hard disku. Za internet se koriste posebni, jaki kompjuteri koje zovemo *serveri*. Oni nemaju ekran, miš ili tastaturu, pošto im je glavna namera čuvanje podataka koje će servirati. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+Nacrtali smo vam sliku! Izgleda ovako:
+
+![Slika 1.1](images/internet_1.png)
+
+Potpuni nered, zar ne? In fact it is a network of connected machines (the above-mentioned *servers*). Stotine hiljada mašina! Mnogo, mnogo kilometara kabla širom sveta! Možete posetiti Submarine Cable Map veb-sajt (http://submarinecablemap.com) da vidite koliko je ova mreža komplikovana. Evo jedne slike ekrana sa tog veb-sajta:
+
+![Slika 1.2](images/internet_3.png)
+
+Fascinantno, zar ne? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+To izgleda ovako:
+
+![Slika 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Vaše pismo ide do pošte najbliže vama. Zatim ide do još jedne koja je malo bliža primaocu, zatim do još jedne, i još jedne dok ne bude dostavljno na svoju destinaciju. Jedina jedinstvena stvar je da kada šaljete mnogo pisama (*pakete podataka*) na isto mesto, oni idu kroz skroz različite pošte (*rutere*). Ovo zavisi od načina na koji se isporučuju u svakoj pošti.
+
+![Slika 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Umesto adrese koja se sastoji od naziva ulice, grada, poštanskog broja i naziva zemlje, koristimo IP adrese. Vaš računar prvo pita DNS (Domain Name System) da prevede djangogirls.org u IP adresu. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Koristite i jezik koji primalac razume, zar ne? Isto važi i za *pakete podataka* koje šaljete da biste videli neki veb-sajt. Koristimo jedan protokol koji se zove HTTP (Hypertext Transfer Protocol).
+
+Praktično, kada imate veb-sajt, potrebno je da imate *server* (mašinu) gde on živi. Kada *server* primi dolazeći *zahtev* (u pismu), šelje ga nazad veb-sajtu (u drugom pismu).
+
+Since this is a Django tutorial, you might ask what Django does. Kada pošaljete odgovor, ne želite uvek poslati istu stvar svakome. Mnogo je bolje ako vaša pisma specijalno prilagođena svakoj osobno onoj koja vam je baš pisala, zar ne? Django vam pomaže pri kreiranju ovakvih, personalizovanih, interesantnih pisama. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/sr-CS/html/README.md b/sr-CS/html/README.md
new file mode 100644
index 00000000000..a1afa70f108
--- /dev/null
+++ b/sr-CS/html/README.md
@@ -0,0 +1,227 @@
+# Uvod u HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Slika 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Slika 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Slika 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Slika 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/sr-CS/install_git.md b/sr-CS/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/sr-CS/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sr-CS/installation/README.md b/sr-CS/installation/README.md
new file mode 100644
index 00000000000..74242f0993f
--- /dev/null
+++ b/sr-CS/installation/README.md
@@ -0,0 +1,68 @@
+# Ako radite tutorial kod kuće
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/sr-CS/instructions.md b/sr-CS/instructions.md
new file mode 100644
index 00000000000..d042926b29a
--- /dev/null
+++ b/sr-CS/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for you instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/sr-CS/intro_to_command_line/README.md b/sr-CS/intro_to_command_line/README.md
new file mode 100644
index 00000000000..0dce558ab23
--- /dev/null
+++ b/sr-CS/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Uvod u interfejs komandne linije
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Upoznaćemo vas sa vašim novim prijateljem: komandnom linijom!**
+
+Naredni koraci će vam pokazati kako da koristite onaj crni prozor koji svi hakeri koriste. Možda će delovati pomalo strašno u početku, ali je to zapravo jedan program koji čeka vaše komande.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## Šta je komandna linija?
+
+Prozor koji se obično naziva ** komandna linija** ili **interfejs komandne linije** je tekstualno bazirana aplikacija za pregled, rukovanje i manipulaciju fajlovima na vašem kompjuteru. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Drugi nazivi za komandnu liniju su: *cmd*, *CLI*, *prompt*, *konzola* ili *terminal*.
+
+## Otvorite interfejs komandne linije
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Vaša prva komanda (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Osnove
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Trenutni direktorijum
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Rešenje:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Kratak pregled
+
+Here is a summary of some useful commands:
+
+| Komande (Windows) | Komande (Mac OS / Linux) | Opis                            | Primer                                             |
+| ----------------- | ------------------------ | ------------------------------- | -------------------------------------------------- |
+| exit              | exit                     | zatvara prozor                  | **exit**                                           |
+| cd                | cd                       | menja direktorijum              | **cd test**                                        |
+| cd                | pwd                      | show the current directory      | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | izlistava direktorijume/fajlove | **dir**                                            |
+| copy              | cp                       | kopira fajl                     | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | premešta fajl                   | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | pravi novi direktorijum         | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file                   | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory              | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command          | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Spremni?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/sr-CS/intro_to_command_line/open_instructions.md b/sr-CS/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/sr-CS/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sr-CS/python_installation/README.md b/sr-CS/python_installation/README.md
new file mode 100644
index 00000000000..fe1c20c30db
--- /dev/null
+++ b/sr-CS/python_installation/README.md
@@ -0,0 +1,15 @@
+# Počnimo sa Python-om
+
+Konačmo smo ovde!
+
+Ali prvo, rećićemo vam šta je Python. Python je veoma popularni programski jezik koji se može koristiti za pravljenje veb-sajtova, video igara, naučnog softvera, grafike i još mnogo, mnogo toga.
+
+Python je nastao krajem 1980-ih godina i njegov glavni cilj je da bude lak za čitanje ne samo mašinama, nego i ljudima. This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Instalacija Python-a
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/sr-CS/python_installation/instructions.md b/sr-CS/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/sr-CS/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/sr-CS/python_introduction/README.md b/sr-CS/python_introduction/README.md
new file mode 100644
index 00000000000..a7a6317cdf8
--- /dev/null
+++ b/sr-CS/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Uvod u Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Vaša prva Python komanda!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Stringovi
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Kratak pregled
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Greške
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- Funkcija `str` konvertuje stvari **stringove**
+- Funkcija `int` konvertuje stvari u **integere**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Varijable
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ime= "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ime
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> naziv= "Sonja"
+>>> naziv
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(naziv)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## Print funkcija
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ime= 'Maria'
+>>> ime
+'Maria'
+>>> print(ime)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Liste
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Rečnici
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- Ključ `ime` pokazuje na vrednost `'Ola'` (što je `string` objekat),
+- `zemlja` pokazuje na vrednost `'Poljska'` (još jedan`string`),
+- i `omiljeni_brojevi` pokazuje na `[7, 42, 92]` (`listu` sa brojevima unutar nje).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Da li vam treba uređena sekvrenca elemenata? Koristite listu.
+- Da li vam je potrebno da pridružite vrednosti ključevima, tako da ih kasnije možete efikasno (po ključu) tražiti? Koristite rečnik.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> ucesnik['zemlja'] = 'Nemacka'
+>>> ucesnik
+{'zemlja': 'Nemacka', 'omiljeni_jezik': 'Python', 'ime': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Kratak pregled
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Poređenje stvari
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y znači: x je veće od y
+- x `<` y znači: x je manje od y
+- x `<=` y znači: x je manje ili jednako y
+- x `>=` y znači: x je veće ili jednako y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Sačuvajte!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Zatvorite Python interpreter
+- Otvorite editor koda po vašem izboru
+- Snimite neki kod u novi python fajl
+- Pokrenite ga!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. Ovo se naziva "naglašavanje sintakse" i jako je korisno za kodiranje. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). Ovo je jeda od razloga zašto koristimo editore koda. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Kratak pregled
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Kratak pregled
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/sr-CS/signup_pythonanywhere.md b/sr-CS/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/sr-CS/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/sr-CS/template_extending/README.md b/sr-CS/template_extending/README.md
new file mode 100644
index 00000000000..0caa32fcd8d
--- /dev/null
+++ b/sr-CS/template_extending/README.md
@@ -0,0 +1,151 @@
+# Širenje šablona
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/sr-CS/whats_next/README.md b/sr-CS/whats_next/README.md
new file mode 100644
index 00000000000..a9a446ff0b9
--- /dev/null
+++ b/sr-CS/whats_next/README.md
@@ -0,0 +1,43 @@
+# Šta je sledeće?
+
+Čestitajte sebi! **Vi ste potpuno fantastični**. Mi smo ponosni! <3
+
+### Šta sad da radim?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Da li možete da preporučite neke dodatne izvore?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/sr/chromebook_setup/instructions.md b/sr/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/sr/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/sr/code_editor/README.md b/sr/code_editor/README.md
new file mode 100644
index 00000000000..404011f1b7d
--- /dev/null
+++ b/sr/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/sr/code_editor/instructions.md b/sr/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/sr/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/sr/css/README.md b/sr/css/README.md
new file mode 100644
index 00000000000..04d5996ae52
--- /dev/null
+++ b/sr/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/sr/deploy/README.md b/sr/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/sr/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/sr/deploy/signup_pythonanywhere.md b/sr/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/sr/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/sv-SE/GLOSSARY.md b/sv-SE/GLOSSARY.md
new file mode 100644
index 00000000000..b66a86dc53d
--- /dev/null
+++ b/sv-SE/GLOSSARY.md
@@ -0,0 +1,3 @@
+# kod-editor
+
+Kod editor är en applikation som tillåter dig att spara din kod så du kommer att kunna komma tillbaka till det senare. Vi visar dig hur du kan hämta en i kapitlet [Kod editor](./code_editor/README.md)
\ No newline at end of file
diff --git a/sv-SE/README.md b/sv-SE/README.md
new file mode 100644
index 00000000000..3d88e15f23e
--- /dev/null
+++ b/sv-SE/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Detta verk är licensierat under Creative Commons Attribution-Sharealike 4.0 International License. För att se en kopia av denna licens, besök https://creativecommons.org/licenses/by-sa/4.0/
+
+## Välkommen
+
+Välkommen till Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduktion
+
+Känner du också att världen handlar mer och mer om teknik och att du på något sätt halkat på efterkälken? Har du någonsin undrat hur du skapar en hemsida men inte haft tillräckligt med motivation för att börja? Har du någonsin tänkt att programmering är för komplicerat för att ens försöka dig på något på egen hand?
+
+Då har vi goda nyheter för dig! Programmering är inte så svårt som det verkar och vi vill visa dig hur kul det kan vara.
+
+Handledningen kommer inte magiskt att förvandla dig till en programmerare. För att bli en bra programmerare krävs månader eller år av lärande och praktik. Men vi vill visa dig att programmering och att skapa webbplatser inte är så komplicerat som det verkar. Vi kommer att försöka förklara olika bitar så gott vi kan, så att du inte skräms av tekniken.
+
+Vi hoppas att vi kan få dig att älska programmering lika mycket som vi gör!
+
+## Vad kommer du att lära dig under handledningen?
+
+Efter handledningen kommer du ha att ha en enkel, fungerande webbapplikation: din egna blogg. Vi kommer att visa hur du publicerar den online, så att andra kan se vad du har gjort!
+
+Den kommer att se ut ungefär så här:
+
+![Figur 0.1](images/application.png)
+
+> Om du jobbar själv, utan handledning, och inte har någon som kan hjälpa dig om du stöter på problem så finns det en chatt för dig: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Tidigare coacher och deltagare kommer att finnas där och hjälpa andra då och då! Var inte rädd för att ställa dina frågor där!
+
+Okej, [låt oss börja från början...](./how_the_internet_works/README.md)
+
+## Att följa tutorialen hemifrån
+
+Det är fantastiskt att delta i en Django Girls workshop, men vi är medvetna om att det inte alltid är möjligt att närvara vid en. Det är därför vi uppmuntrar dig att försöka följa denna handledning hemifrån. För läsare hemma, förbereder vi för närvarande videor som gör det lättare att följa handledningen på egen hand. Det är fortfarande ett pågående arbete, men fler och fler saker kommer snart att täckas på YouTube-kanalen [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed).
+
+I varje kapitel som redan täcks finns en länk som leder till rätt video.
+
+## Om oss och att bidra
+
+Denna tutorial underhålls av [DjangoGirls](https://djangogirls.org/). Om du hittar några felaktigheter eller vill uppdatera något, vänligen [följ riktlinjerna för att bidra](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Vill du hjälpa oss översätta handledningen till fler språk?
+
+För tillfället sköts översättningar på crowdin.com:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Om ditt språk inte finns listat på [crowdin](https://crowdin.com/), vänligen [skapa ett "issue"](https://github.com/DjangoGirls/tutorial/issues/new) och skriv vilket språk det gäller så kan vi lägga till det.
\ No newline at end of file
diff --git a/sv-SE/SUMMARY.md b/sv-SE/SUMMARY.md
new file mode 100644
index 00000000000..f664f9ced66
--- /dev/null
+++ b/sv-SE/SUMMARY.md
@@ -0,0 +1,35 @@
+# Sammanfattning
+
+* [Introduktion](README.md)
+* [Installation](installation/README.md) 
+  * [Kommandorad](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Kodredigerare](installation/README.md#code-editor)
+  * [Virtuell miljö](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [Hur Internet fungerar](how_the_internet_works/README.md)
+* [Introduktion till kommandoraden](intro_to_command_line/README.md)
+* [Installera Python](python_installation/README.md)
+* [Kod-editor](code_editor/README.md)
+* [Introduktion till Python](python_introduction/README.md)
+* [Vad är Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Ditt första Django-projekt!](django_start_project/README.md)
+* [Django modeller](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Publicera!](deploy/README.md)
+* [Django URL](django_urls/README.md)
+* [Django vyer - dags att skapa!](django_views/README.md)
+* [Introduktion till HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamisk data i mallar](dynamic_data_in_templates/README.md)
+* [Django mallar](django_templates/README.md)
+* [CSS - gör det tjusigt](css/README.md)
+* [Mallutökning](template_extending/README.md)
+* [Utöka din applikation](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [Vad kommer härnäst?](whats_next/README.md)
\ No newline at end of file
diff --git a/sv-SE/chromebook_setup/README.md b/sv-SE/chromebook_setup/README.md
new file mode 100644
index 00000000000..6959bd0fd85
--- /dev/null
+++ b/sv-SE/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Uppsättning av ChromeBook
+
+> **Obs** Om du redan har gått igenom [installationsstegen](../installation/README.md) behöver du inte göra detta igen – du kan hoppa direkt till [Introduktion till Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/sv-SE/chromebook_setup/instructions.md b/sv-SE/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..5109578ea95
--- /dev/null
+++ b/sv-SE/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Du kan [hoppa över denna sektion](http://tutorial.djangogirls.org/en/installation/#install-python) om du inte använder en Chromebook. Om det är så att du använder en Chromebook kommer din installation se lite annorlunda ut. Du kan ignorera resten av installations instruktionerna.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE är ett verktyg som ger användaren en kod-editor och tillgång till en dator på internet på vilken du kan installera, skriva och köra mjukvara. Under denna introduktion kommer Cloud IDE vara din *lokala maskin*. Du kommer fortfarande att köra din kommandon i terminalen, precis som dina klasskamrater som sitter på OS X, Ubuntu, eller Windows, men din terminal kommer vara kopplat till en dator som Cloud IDE har satt upp till dig. Här är instruktionerna för cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Du kan välja en Cloud IDE och följ anvisningen för den Cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Gå till [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Skapa ett konto
+3. Klicka på *Ny Server* och välj Django-appen
+4. Klicka på Terminal knappen (på vänster sida av fönstret)
+
+Nu bör du se ett gränssnitt med en sidofält, och några knappar på vänster. Klicka ”Terminal” knappen för att öppna terminal-fönstret som ser ut såhär:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+Terminalen på PaizaCloud Cloud IDE är förberedd för dina instruktioner. Du kan ändra storlek på eller maximera fönstret för att göra det lite större.
+
+#### AWS Cloud9
+
+För närvarande kräver Cloud 9 att du registrerar dig med AWS och ange kreditkort information.
+
+1. Installera Cloud 9 från [Chrome webbutiken](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Gå till [c9.io](https://c9.io) och klicka på *Kom igång med AWS Cloud9*
+3. Registrera dig för ett AWS-konto (kräver kreditkortsinformation, men du kan använda det gratis)
+4. I AWS kontrollpanelen anger du *Cloud9* i sökfältet och klickar på den
+5. I Cloud9 panelen klickar du på *Create environment*
+6. Döp den till *django-girls*
+7. Medan du anger inställningar, välj *Create a new instance for environment (EC2)* för "Environment Type" och *t2.micro* "Instance type" (det bör säga "Free-tier eligible."). Standardinställningen för kostnadsbesparingar är bra och du kan behålla de andra standardinställningarna.
+8. Klicka på *Next step*
+9. Klicka på *Create Environment*
+
+Nu kan du se ett gränssnitt med en navigation vid sidan, ett stort huvud-fönster med någon text och ett litet fönster nertill som ser ut typ så här:
+
+{% filename %}bash{% endfilename %}
+
+    dittanvändarnamn:~/workspace $
+    
+
+Detta nedre område är din terminal. Du kan använda terminalen för att skicka instruktioner till fjärrdatorn Cloud9. Du kan ändra fönstrets storleken för att göra det lite större.
+
+#### Glitch.com Cloud IDE
+
+1. Gå till [Glitch.com](https://glitch.com/)
+2. Registrera ett nytt konto (https://glitch.com/signup) eller använd ditt GitHub-konto om du har ett. (Se GitHub-instruktionerna nedan.)
+3. Klicka på *New Project* och välj *hello-webpage*
+4. Klicka på rullgardinslistan Tools (längst ner till vänster i fönstret) och sedan på Terminal-knappen för att öppna terminalfliken med en prompt som ser ut så här:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+När du använder Glitch.com som din moln-IDE behöver du inte skapa en virtuell miljö. Skapa istället följande filer manuellt:
+
+{% 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
+```
+
+När dessa filer har skapats går du till Terminalen och kör följande kommandon för att skapa ditt första Django-projekt:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+För att se detaljerade felmeddelanden kan du aktivera Djangos felsökningsloggar för din Glitch-applikation. Lägg helt enkelt till följande i slutet av filen `mysite/settings.py`.
+
+{% 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,
+        },
+    },
+}
+```
+
+Detta kommer att skapa filen `debug.log` som beskriver Django-operationer och eventuella felmeddelanden som kan komma upp, vilket gör felen mycket lättare att fixa om din webbplats inte fungerar.
+
+Den första omstarten av Glitch-projektet kommer misslyckas. (Om du klickar på den övre rullgardinsmenyn `Show` och sedan klickar på `In a New Window`, kommer du att få felmeddelandet `DisallowedHost`. Oroa dig inte för det just nu, guiden kommer att fixa detta så snart du uppdaterar Django-inställningarna för ditt projekt i filen `mysite/settings.py`.
+
+### Virtuell miljö
+
+En virtuell miljö (även kallad virtualenv) är som en privat låda som vi kan stoppa användbar datorkod i för ett projekt vi arbetar med. Vi använder dem för att hålla olika kodbitar vi vill ha för våra olika projekt separerade så saker inte blandas ihop mellan projekt.
+
+Kör:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(observera att på sista raden använder vi ett tilde följt av ett likamedtecken: `~=`).
+
+### GitHub
+
+Skapa ett [GitHub](https://github.com)-konto.
+
+### PythonAnywhere
+
+Django Girls handledning innehåller ett avsnitt om det som kallas Deployment (även kallat driftsättning eller publicering), som innebär att ta koden som driver din nya webbapplikation och flytta den till en offentligt tillgänglig dator (kallad server) så att andra personer kan se ditt arbete.
+
+Denna del är lite udda när du följer handledningen på en Chromebook eftersom vi redan använder en dator som är på Internet (i motsats till en vanlig bärbar dator). Men det är fortfarande användbart, eftersom vi kan se vår arbetsyta på Cloud 9 som en plats för vårt pågående arbete och Python Anywhere som en plats att visa upp våra grejer när de är mer kompletta.
+
+Så registrera ett nytt Python Anywhere-konto på [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/sv-SE/code_editor/README.md b/sv-SE/code_editor/README.md
new file mode 100644
index 00000000000..346f848a05e
--- /dev/null
+++ b/sv-SE/code_editor/README.md
@@ -0,0 +1,11 @@
+# Kod-editor
+
+> För läsare hemma: detta kapitel täcks av videon [installera Python & kodredigeraren](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+Du är på väg att skriva din första rad kod, så det är dags att ladda ner en kod-editor!
+
+> **Obs** Om du använder en Chromebook, hoppa över detta kapitel och följ istället instruktionerna i [Chromebook-installation](../chromebook_setup/README.md). Det cloud IDE du valde (PaizaCloud Cloud IDE eller AWS Cloud9) innehåller en kod-editor, och när du öppnar en fil i din IDE från Arkiv-menyn använder du automatiskt editoren.
+> 
+> **Obs** Du kanske redan har gjort detta i [Installationskapitlet](../installation/README.md) – i så fall du kan hoppa vidare till nästa kapitel!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/sv-SE/code_editor/instructions.md b/sv-SE/code_editor/instructions.md
new file mode 100644
index 00000000000..57208ed3c20
--- /dev/null
+++ b/sv-SE/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Det finns mängder av olika editorer och till största del handlar det om personliga preferenser. De flesta Python-programmerare använder komplexa men väldigt kraftfulla IDEer (Integrated Development Enviroments), som till exempel PyCharm. Som nybörjare kan detta dock vara mindre lämpligt, våra rekommendationer är lika kraftfulla, men betydligt enklare.
+
+Våra förslag är listade nedan, men fråga gärna din coach vilken editor de föredrar - det gör det enklare att få hjälp av dem.
+
+## Visual Studio Code
+
+Visual Studio Code är en källkodsredigerare som utvecklats av Microsoft för Windows, Linux och macOS. Den innehåller stöd för felsökning, inbäddad Git-kontroll, syntaxmarkering, intelligent kodkomplettering, kodsnuttar, och kodrefaktorering.
+
+[Ladda ner den här](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit är gratis, open-source och tillgänglig för alla operativsystem.
+
+[Ladda ner den här](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text är en väldigt populär editor med en fri testperiod och finns tillgänglig för alla operativsystem.
+
+[Ladda ner den här](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom är en annan populär editor. Den är gratis, open-source och finns för Windows, OS X och Linux. Atom är utvecklat av [GitHub](https://github.com/).
+
+[Ladda ner den här](https://atom.io/)
+
+## Varför installerar vi en kodredigerare?
+
+Du kanske undrar varför vi installerar ett speciellt program för att redigera kod istället för att bara använda något som Word eller Notepad.
+
+För det första måste kod vara **oformaterad text**, och problemet med program som Word eller Textedit är att de inte skapar oformaterad text, de skapar formaterad text (med typsnitt och stilar) i speciella format som [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+Den andra anledningen är att kod-editorer är specialiserade för att redigera kod och kan erbjuda användbara funktioner som markering med färger beroende på kodens betydelse eller automatiskt avsluta citattecken åt dig.
+
+Vi kommer att se allt detta i praktiken senare. Snart kommer du tänka på din trogna gamla editor som ett av dina favoritverktyg. :)
\ No newline at end of file
diff --git a/sv-SE/css/README.md b/sv-SE/css/README.md
new file mode 100644
index 00000000000..6191081bea9
--- /dev/null
+++ b/sv-SE/css/README.md
@@ -0,0 +1,330 @@
+# CSS - gör det tjusigt!
+
+Vår blogg är fortfarande ganska ful, eller hur? Dags att göra den snygg! Vi kommer använda CSS för det.
+
+## Vad är CSS?
+
+Cascading Style Sheets (CSS) är ett språk som används för att beskriva utseende och format av en webbsida skriven i ett märkspråk (som HTML). Tänk dig sminkning för vår webbsida. ;)
+
+Men vi vill inte börja helt från början, eller hur? Än en gång använder vi något som programmerare gjort tillgängligt på Internet, helt gratis. Att återuppfinna hjulet är ju inte så roligt.
+
+## Låt oss använda Bootstrap!
+
+Bootstrap är ett av de mest populära HTML- och CSS-ramverken för att bygga snygga webbsidor: https://getbootstrap.com/
+
+Det skapades av programmerare som arbetade på Twitter och utvecklas nu av frivilliga från hela världen!
+
+## Installera Bootstrap
+
+För att installera Bootstrap, öppna din `.html`-fil i kod-editorn och lägg till detta i sektion `<head>`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Detta lägger inte till några filer i ditt projekt. Det bara pekar på filer som finns på Internet. Öppna nu webbsidan och ladda om sidan. Här är den!
+
+![Figur 14.1](images/bootstrap1.png)
+
+Det ser redan bättre ut!
+
+## Statiska filer i Django
+
+Vi ska äntligen ta en närmare titt på dessa saker vi kallat **statiska filer**. Statiska filer är alla dina CSS- och bildfiler. Deras innehåll beror inte på klientens förfrågan och kommer att vara lika för alla användare.
+
+### Var ska vi lägga statiska filer för Django?
+
+Django vet redan var den ska hitta statiska filer för den inbyggda "admin"-appen. Nu behöver vi bara lägga till några statiska filer för vår egen app, `blog`.
+
+Vi gör det genom att skapa en mapp kallad `static` i vår blogg-app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django kommer automatiskt hitta alla mappar kallade "static" i någon av dina app-mappar, och kommer kunna använda dess innehåll som statiska filer.
+
+## Din första CSS-fil!
+
+Nu ska vi skapa en CSS-fil, för att lägga till din egen stil till din webbsida. Skapa en ny mapp kallad `css` i din `static`-mapp. Skapa sen en ny fil som du kallar `blog.css` inne i `css`-mappen. Redo?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Dags att skriva lite CSS! Öppna upp filen `blog/static/css/blog.css` i din kod-editor.
+
+Vi kommer inte gå djupare in på att skräddarsy och lära oss CSS här. Det finns en rekommendation för en gratis CSS kurs på slutet av denna sida om du är sugen på att lära dig mer.
+
+Men låt oss ändra åtminstone lite grann. Vi kanske kan ändra färgen på rubriken? För att förstå färger använder datorer speciella koder. De börjar med `#` följt av 6 bokstäver (A-F) och siffror (0-9). Till exempel är koden för blå `#0000FF`. Du kan hitta exempel på färgkoder här: http://www.colorpicker.com/. Du kan också använda [fördefinierade färger](http://www.w3schools.com/colors/colors_names.asp), som `red` och `green`.
+
+Lägg till följande i filen `blog/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` är en CSS Selektor. Det innebär att vi tillämpar våra stilar på alla `a`-element inom ett `h1`-element; `h2 a` selektoren gör samma sak för `h2`-elementen. Så när vi har något i stil med `<h1><a href="">länk</a></h1>`, kommer `h1 a`-stilen gälla. I detta fall säger vi åt den att ändra sin färg till `#C25100`, vilket är mörk orange. Eller så kan du lägga din egen färg här, men se till att den har god kontrast mot en vit bakgrund!
+
+I en CSS-fil bestämmer vi stilar för element i HTML-filen. Det första sättet vi identifierar element är med elementnamnet. Du kanske minns dessa som taggar från HTML-avsnittet. Saker som `a`, `h1` och `body` är alla exempel på elementnamn. Vi identifierar även element genom attributet `class` eller attributet `id`. Class och id är namn du själv ger elementet. Class definierar grupper av element, medan id pekar på specifika element. Till exempel kan du identifiera följande element genom att använda elementnamnet `a`, klassen `external_link` eller id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Du kan läsa mer om [CSS Selektorer hos w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+Vi behöver också berätta för vår HTML-mall att vi har lagt till lite CSS. Öppna filen `blog/templates/blog/post_list.html` och lägg till denna rad i början:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Vi laddar bara in statiska filer här. :) Mellan `<head>` och `</head>` taggarna, efter länkarna till Bootstraps CSS-filer, lägg till följande rad:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Webbläsaren läser filerna i den ordning som de anges, så vi behöver se till att dessa är på rätt plats. Annars kanske koden i vår fil skrivs över av kod i Bootstrap-filerna. Vi berättade just för vår mall var CSS-filen finns.
+
+Filen ska nu se ut såhär:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, spara filen och ladda om sidan!
+
+![Figur 14.2](images/color2.png)
+
+Bra jobbat! Kanske skulle vi också vilja ge vår webbsida lite mer luft och öka marginalen på vänstersidan? Låt oss prova!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Lägg till detta i CSS-filen, spara filen och se hur det ändras!
+
+![Figur 14.3](images/margin2.png)
+
+Vi kanske kan anpassa typsnittet i rubriken? Kopiera detta till `<head>` i filen `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Som tidigare, kontrollera ordningen och placera den nya länken ovanför `blog/static/css/blog.css`. Denna rad kommer att importera ett teckensnitt kallat *Lobster* från Google Fonts (https://www.google.com/fonts).
+
+Hitta deklarationsblocket till `h1 a` (koden mellan klammerparenteserna `{` och `}`) i CSS-filen `blog/static/css/blog.css`. Lägga nu till raden `font-family: 'Lobster';` mellan klammerparenteserna och uppdatera sidan:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figur 14.3](images/font.png)
+
+Toppen!
+
+Som tidigare nämnt har CSS ett koncept av klasser. Dessa tillåter dig att namnge en del av HTML-koden och använda formatmallar till enbart denna del, utan att det påverkar andra delar. Detta kan vara väldigt användbart! Kanske har du två div-taggar som gör något specifikt (som din rubrik och ditt inlägg). En klass kan hjälpa dig att få dem att se annorlunda ut.
+
+Fortsätt med att namnge delar av HTML-koden. Ersätt elementet `header` som innehåller din rubrik med följande:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+Och lägg nu till en klass `post` i din `article` som innehåller ett blogginlägg.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Vi kommer nu lägga till deklarations-block till olika selektorer. Selektorer som börjar med `.` avser klasser. Det finns mängder av bra guider och förklaringar om CSS på webben som kan hjälpa dig förstå följande kod. Men för stunden, kopiera den bara till filen `blog/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Sen omger vi HTML-koden som visar inlägg med deklarationer av klasser. Ersätt detta:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+i filen `blog/templates/blog/post_list.html` med detta:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Spara filerna och ladda om sidan.
+
+![Figur 14.4](images/final.png)
+
+Hurra! Ser snyggt ut, eller hur? Titta på den kod som vi just klistrade in och hitta de platser där vi lagt till klasser i HTML och som vi använde i CSS-filen. Var skulle du göra ändringen om du vill att datumet ska vara turkos?
+
+Var inte rädd för att experimentera med CSS och ändra utseendet på saker. Att leka runt med CSS kan hjälpa dig att förstå vad de olika sakerna gör. Om du har sönder något, ingen fara - du kan alltid ångra ändringarna!
+
+Vi rekommenderar starkt att du läser de kostnadsfria onlinekurserna "Basic HTML & HTML5" och "Basic CSS" på [freeCodeCamp](https://learn.freecodecamp.org/). De kan lära dig allt om att göra dina webbplatser snyggare med HTML och CSS.
+
+Redo för nästa kapitel?! :)
\ No newline at end of file
diff --git a/sv-SE/deploy/README.md b/sv-SE/deploy/README.md
new file mode 100644
index 00000000000..afd800c5fc8
--- /dev/null
+++ b/sv-SE/deploy/README.md
@@ -0,0 +1,246 @@
+# Publicera!
+
+> **Obs!** Detta kapitel kan bitvis vara besvärligt att ta sig igenom. Försök härda ut och ta dig igenom det, distribution är en viktig del av att utveckla webbsidor. Det här kapitlet är placerat i mitten av totorialen så att din mentor kan hjälpa dig med den något besvärligare processen att publicera din webbsida på nätet. Detta innebär att du kan avsluta tutorialen på egen hand om tiden tar slut.
+
+Fram tills nu var din hemsida endast tillgänglig på din dator. Nu lär du dig att publicera det! Publicering är processen att göra din applikation tillgänglig på internet så att andra kan se och använda din app. :)
+
+Som du lärt dig behöver en hemsida ligga på en server. Det finns många serverleverantörer tillgängliga på internet, vi ska använda [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere är gratis för små applikationer som inte har alltför många besökare så det kommer definitivt räcka för dig nu.
+
+Den andra externa tjänsten som vi kommer att använda är [GitHub](https://www.github.com), vilket är en tjänst för kodlagring. Det finns andra tjänster, men nästan alla programmerare har ett GitHub-konto dessa dagar, och snart har även du ett!
+
+Dessa tre platser kommer att vara viktiga för dig. Din lokala dator kommer vara den plats där du gör utveckling och testning. När du är nöjd med ändringarna lägger du en kopia av ditt program på GitHub. Din webbplats kommer att finnas på PythonAnywhere och du uppdaterar den genom att få en ny kopia av din kod från GitHub.
+
+# Git
+
+> **Obs** Om du redan gått igenom [installationsstegen](../installation/README.md) finns det ingen anledning att göra dem igen – du kan hoppa vidare till nästa avsnitt och börja skapa ditt Git-repo.
+
+{% include "/deploy/install_git.md" %}
+
+## Skapa vårt Git-repo
+
+Git spårar ändringar i en viss uppsättning filer i vad som kallas ett kod-repositorium (eller kort sagt "repo"). Låt oss skapa ett för vårt projekt. Öppna din konsol och köra dessa kommandon, i katalogen `djangogirls`:
+
+> **Obs** Kontrollera din aktuella arbetskatalog med `pwd` (Mac OS X/Linux) eller `cd` (Windows) innan du initierar repot. Du bör vara i mappen `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initierade tomt Git-arkiv i ~/djangogirls/.git/
+    $ git config --global user.name "Ditt Namn"
+    $ git config --global user.email din.epost@example.com
+    
+
+Initiera git-repot är något vi bara behöver göra en gång per projekt (och du behöver inte ange användarnamn och e-post någonsin igen).
+
+Git kommer spåra ändringar över alla filer och mappar i den här katalogen, men det finns några filer som vi vill ignorera. Vi gör detta genom att skapa en fil som heter `.gitignore` i baskatalogen. Öppna din editor och skapa en ny fil med följande innehåll:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+Och spara den som `.gitignore` i topp-nivån av mappen "djangogirls".
+
+> **Obs** Punkten i början av filnamnet är viktigt! Om du får problem med att skapa filen (Mac-datorer gillar inte att du skapar filer som börjar med en punkt via Finder, till exempel), använd funktionen "Spara som" i din redaktör; det är skottsäkert. Och var noga med att inte lägga till `.txt`, `.py` eller någon annan tillägg till filnamnet - det kommer endast att erkännas av Git om namnet bara är `.gitignore`. Linux och MacOS hanterar filer med ett namn som börjar med `.` (t.ex. `.gitignore`) som dolda och det normala `ls` kommandot kommer inte att visa dessa filer. Använd istället `ls -a` för att se filen `.gitignore`
+> 
+> **Obs** En av de filer du angav i din `.gitignore`-fil är `db.sqlite3`. Den filen är din lokala databas, där alla dina användare och inlägg lagras. Vi följer standard-praxis för webbprogrammering, vilket innebär att vi använder separata databaser för din lokala testsite och din live-webbplats på PythonAnywhere. PythonAnywhere-databasen kan vara SQLite, som på din utvecklingsmaskin, men oftast kommer du att använda en som kallas MySQL som kan hantera många fler besökare än SQLite. Hursomhelst, genom att ignorera din SQLite-databas för GitHub-kopian kommer alla de inlägg och superanvändare du skapat hittills endast att vara tillgängliga lokalt, och du måste skapa nya i produktion. Du bör se din lokala databas som en bra lekplats där du kan testa olika saker och inte vara rädd för att du kommer att ta bort dina riktiga inlägg från din blogg.
+
+Det är en bra idé att använda kommandot `git status` före `git add` eller om du är osäker på vad som har förändrats. Detta kommer hjälpa till att förhindra att överraskningar inträffar, till exempel att fel filer läggs till eller commitas. Kommandot `git status` returnerar information om alla ospårade/modifierade/incheckade filer, gren-status och mycket mer. Resultatet bör likna följande:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Och slutligen sparar vi våra ändringar. Gå till din konsol och kör dessa kommandon:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pusha din kod till GitHub
+
+Gå till [GitHub.com](https://www.github.com) och registrera dig för ett nytt, gratis användarkonto. (Om du redan gjorde det under workshop-förberedelserna är det toppen! Se till att komma ihåg ditt lösenord (lägg till det i din lösenordshanterare, om du använder en).
+
+Skapa sedan en ny databas och ge den namnet ”my-first-blog”. Lämna kryssrutan "initialize with a README" urbockad, lämna fältet för .gitignore tomt (vi har gjort det manuellt) och låt licensen vara "None".
+
+![](images/new_github_repo.png)
+
+> **Obs** Namnet `my-first-blog` är viktigt – du kan välja något annat, men det kommer att inträffa massor av gånger i instruktionerna nedan, och du skulle behöva ersätta det varje gång. Det är nog lättare att hålla sig till namnet `my-first-blog`.
+
+På nästa skärm kommer ditt repos klonings-URL visas, den kommer du att använda i några av de kommandon som följer:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Nu måste vi koppla upp Git-repot på din dator med det på GitHub.
+
+Skriv in följande i konsolen (ersätt `<your-github-username>` med det användarnamn du angav när du skapade ditt GitHub-konto, men utan vinkelparenteserna -- URL:en ska matcha den klonings-URL du just såg):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+När du pushar till GitHub kommer du bli ombedd att fylla i ditt användarnamn och lösenord (antingen direkt där i kommandoradsfönstret eller i ett popup-fönster) och efter att du har angett uppgifterna bör du se något som det här:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Din kod är nu på GitHub. Gå och kolla in den! Du kommer se att den är i gott sällskap – [Django](https://github.com/django/django), [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial) och många andra stora projekt med öppen källkod har sin kod på GitHub. :)
+
+# Publicera vår blogg på PythonAnywhere
+
+## Registrera ett PythonAnywhere-konto
+
+> **Obs** Du kanske redan har skapat ett PythonAnywhere-konto tidigare under installationsstegen – i så fall behöver du inte göra det igen.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Konfigurera vår webbplats på PythonAnywhere
+
+Gå tillbaka till [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) genom att klicka på logotypen, och välj alternativet att starta en "Bash"-konsol – det är PythonAnywheres version av en kommandorad, precis som den på din dator.
+
+![Avsnittet 'New Console' i PythonAnywheres webbgränssnitt, med en knapp för 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Obs** PythonAnywhere är baserat på Linux, så om du kör Windows, kommer konsolen att se lite annorlunda ut än den på din dator.
+
+Att installera en webbapp på PythonAnywhere innebär att du drar ner din kod från GitHub, och sedan konfigurerar PythonAnywhere att känna igen den och börja serva den som en webbapplikation. Det finns manuella sätt att göra det, men PythonAnywhere erbjuder ett hjälpverktyg som gör allt åt dig. Låt oss installera det först:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+Det bör skriva ut vissa saker som `Collecting pythonanywhere` och så småningom avslutas det med en rad som säger `Successfully installed (...) pythonanywhere- (...)`.
+
+Nu kör vi hjälpverktyget för att automatiskt konfigurera vår app från GitHub. Skriv in följande i konsolen på PythonAnywhere (glöm inte att använda ditt användarnamn på GitHub istället för `<your-github-username>`, så att URL:en matchar klonens URL från GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+När du ser det köra, kommer du att kunna se vad det gör:
+
+- Laddar ner din kod från GitHub
+- Skapar en virtualenv på PythonAnywhere, precis som den på din egen dator
+- Uppdaterar din inställningsfil med några driftinställningar
+- Ställer in en databas på PythonAnywhere genom att använda kommandot `manage.py migrate`
+- Konfigurerar statiska filer (vi lär oss om dessa senare)
+- Och konfigurerar PythonAnywhere för att serva din webbapp via dess API
+
+På PythonAnywhere är alla dessa steg automatiserade, men de är samma steg som du skulle behöva gå igenom med någon annan serverleverantör.
+
+Det viktigaste att inse just nu är att din databas på PythonAnywhere faktiskt är helt skild från din databas på din egen dator, så den kan ha olika inlägg och administratörskonton. Därmed måste vi initiera administratörskontot med `createsuperuser`, precis som vi gjorde på din egen dator. PythonAnywhere har automatiskt aktiverat din virtualenv åt dig, så allt du behöver göra är att köra:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Skriv in uppgifterna för din administratörsanvändare. Det är bäst att använda samma som du använder på din egen dator för att undvika förvirring, såvida du inte vill göra lösenordet på PythonAnywhere säkrare.
+
+Nu, om du vill, kan du också ta en titt på din kod på PythonAnywhere med `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+Du kan också gå till sidan "Files" och navigera runt med PythonAnywheres inbyggda filläsare. (Från konsolsidan, kan du komma till andra PythonAnywhere-sidor via menyknappen i det övre högra hörnet. När du är på en av sidorna, finns det länkar till de andra nära toppen.)
+
+## Nu är du live!
+
+Din webbplats ska nu vara live på Internet! Klicka på PythonAnywheres sida "Web" för att få en länk till den. Du kan dela denna med vem du vill. :)
+
+> **Obs** Detta är en nybörjarhandledning och genom att distribuera denna webbplats har vi tagit några genvägar som inte är idealiska ur säkerhetssynpunkt. Om och när du väljer att bygga vidare på detta projekt, eller startar ett nytt projekt, bör du granska [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) för tips om hur du säkrar din webbplats.
+
+## Tips för debuggning
+
+Om du får ett fel när du kör `pa_autoconfigure_django.py`, är här några vanliga anledningar:
+
+- Du har glömt att skapa din PythonAnywhere API-token.
+- Du har skrivit fel i din GitHub-URL
+- Om du ser ett fel som säger *"Could not find your settings.py"* är det förmodligen för att du inte lyckades lägga till alla dina filer till Git och/eller att du inte pushade dem till GitHub. Ta en extra titt på Git-avsnittet ovan.
+- Om du tidigare registrerade ett PythonAnywhere-konto och fick ett fel med collectstatic har du förmodligen en äldre version av SQLite (t.ex. 3.8.2) på ditt konto. I så fall, registrera ett nytt konto och kör kommandona i PythonAnywhere-avsnittet ovan.
+
+Om du får ett fel när du besöker din webbplats är den första platsen att leta efter felsökningsinformation i din **error log**. Du hittar en länk till denna på PythonAnywheres ["Web"-sida](https://www.pythonanywhere.com/web_app_setup/). Se om det finns några felmeddelanden där; de senaste är längst ned.
+
+Det finns också några [allmänna debugg-tips på PythonAnywheres hjälp-sida](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+Och kom ihåg, din coach finns här för att hjälpa till!
+
+# Kolla in din webbsida!
+
+Standardsidan för din webbplats bör säga "It worked!", precis som den gör på din lokala dator. Försök att lägga till `/admin/` till slutet av webbadressen och du kommer att tas till administratörssidan. Logga in med användarnamn och lösenord så ser du att du kan lägga till nya inlägg på servern -- kom ihåg, inläggen från din lokala testdatabas skickades inte till din liveblogg.
+
+När du har skapat några inlägg kan du gå tillbaka till din lokala installation (inte PythonAnywhere). Från och med nu bör du arbeta med din lokala installation för att göra ändringar. Detta är ett vanligt arbetsflöde inom webbutveckling – gör lokala ändringar, pusha dessa ändringar till GitHub, och hämta dina ändringar till din live-webbserver. Detta gör att du kan arbeta och experimentera utan att ha sönder din live-webbsida. Ganska coolt va?
+
+Ge dig själv en *STOR* klapp på axeln! Serverpublicering är en av de svåraste delarna inom webbutveckling och det tar ofta flera dagar innan folk får det att fungera. Men du har din webbplats live, på Internet!
\ No newline at end of file
diff --git a/sv-SE/deploy/install_git.md b/sv-SE/deploy/install_git.md
new file mode 100644
index 00000000000..7652a0d623c
--- /dev/null
+++ b/sv-SE/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git är ett versionshanteringssystem som används av många programmerare. Med Git kan ändringar som gjorts i dina filer spåras över tiden så att du kan komma åt specifika versioner senare. Lite som ”spåra ändringar” funktionen i ordbehandlare program (t ex Microsoft Word eller LibreOffice Writer), men mycket mer kraftfull.
+
+## Installera Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Du kan ladda ner Git från [git-scm.com](https://git-scm.com/). Du kan trycka ”nästa” på alla åtgärder utom två: i steget där den frågar att välja din kod-redaktör, du bör välja Nano, och i steget med titeln ”Adjusting your PATH environment", välj ”Use Git and optional Unix tools from the Windows Command Prompt” (alternativet längst ned). Annars är resten av standardvärdena bra. Lämna kryssrutan fylld för alternativet "Checkout Windows-style, commit Unix-style line endings".
+
+Glöm inte att starta om kommandotolken eller PowerShell efter installationen slutförts. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Ladda ner Git från [git-scm.com](https://git-scm.com/) och följ instruktionerna.
+
+> **Obs** Om du kör OS X 10.6, 10.7 eller 10.8, du kommer att behöva installera versionen av git härifrån: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sv-SE/deploy/signup_pythonanywhere.md b/sv-SE/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ff8de66eb94
--- /dev/null
+++ b/sv-SE/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere är en tjänst för att köra Python-kod på servrar "i molnet". Vi ska använda det som värd för vår webbplats, live och på Internet.
+
+Vi kommer att värda den blogg som vi bygger på PythonAnywhere. Anmäl dig till ett "Beginner" konto på PythonAnywhere (gratis nivån är bra, du behöver inte ett kreditkort).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![PythonAnywhere registreringssidan som visar knappen för att skapa ett gratis "Beginner"-konto](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Obs** När du väljer ditt användarnamn, kom ihåg att din bloggadress kommer att ta formen `ditt användarnamn.pythonallwhere.com`, välj antingen ditt eget smeknamn eller ett namn på vad din blogg handlar om. Också, kom ihåg ditt lösenord (lägg till det i din lösenordshanterare, om du använder en).
+
+## Skapa en PythonAnywhere API-token
+
+Det här är något du bara behöver göra en gång. När du har anmält dig till PythonAnywhere kommer du att tas till din instrumentpanel. Hitta länken längst upp till höger på sidan "Account":
+
+!["Account" länken längst upp till höger på webbsidan](../deploy/images/pythonanywhere_account.png)
+
+välj sedan fliken som heter "API token" och tryck på knappen som heter "Create new API token".
+
+![API-token fliken på "Account" webbsidan](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/sv-SE/django/README.md b/sv-SE/django/README.md
new file mode 100644
index 00000000000..ce5a1821e10
--- /dev/null
+++ b/sv-SE/django/README.md
@@ -0,0 +1,27 @@
+# Vad är Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) är ett fritt webbapplikations-ramverk med öppen källkod, skrivet i Python. Ett webb-ramverk är en uppsättning komponenter som hjälper dig att utveckla webbplatser snabbare och enklare.
+
+När du bygger en webbplats, måste du alltid ha en liknande uppsättning av komponenter: ett sätt att hantera användarautentisering (registrera dig, logga in, logga ut), en förvaltningspanel för din webbplats, blanketter, ett sätt att ladda upp filer, osv.
+
+Lyckligtvis för dig, andra personer märkte för länge sedan att webbutvecklare står inför liknande problem när man bygger en ny webbplats, så att de slagit sig ihop och skapat webb-ramverk (Django är en av dem) som ger dig färdiga komponenter att använda.
+
+Ramverk finns för att rädda dig från att ha uppfinna hjulet på nytt och för att lindra några av allmänna omkostnader när du bygger en ny webbplats.
+
+## Varför behöver du en ramverk?
+
+För att förstå vad Django är faktiskt till för, måste vi ta en närmare titt på servrarna. Det första är att servern behöver veta att du vill tjäna dig en webbsida.
+
+Föreställ dig en brevlåda (port) som övervakas för inkommande brev (begäran). Detta görs av en webbserver. Webbservern läser brevet och skickar en webbsida som svar. Men om du vill skicka något, du behöver ha vissa innehåll. Och Django är något som hjälper dig att skapa det innehållet.
+
+## Vad händer när någon begär en webbplats från din server?
+
+När en begäran kommer till en webbserver, skickas det till Django som försöker räkna ut vad begärs faktiskt. Den tar en webbadress först och försöker räkna ut vad ska göras. Denna del görs av Django's **urlresolver** (observera att en webbadress kallas en URL – Uniform Resource Locator – så namnen *urlresolver* är vettigt). Den är inte så smart – den tar en lista med mönster och försöker matcha URL-adressen. Django kontrollerar mönster från topp till botten och om något matchas, överförs Django begäran till den associerade funktionen (som kallas *vy*).
+
+Föreställ dig en brevbärare med ett brev. Hon går längs gatan och kontrollerar varje husnummer mot den på brevet. Om det matchar, sätter hon brevet där. Så här fungerar urlresolvern!
+
+Det är i funktionen *vy* som alla intressanta saker görs: vi kan titta på en databas för att leta efter information. Kanske begärde användaren att ändra något i datan? Som ett brev som säger "Ändra beskrivningen av mitt jobb." *Vyn* kan kontrollera om du får göra det, kan sedan uppdatera jobbbeskrivningen för dig och skicka tillbaka ett meddelande: "Klar!" Då genererar *vyn* ett svar och Django kan skicka det till användarens webbläsare.
+
+Beskrivningen ovan är lite förenklad, men du behöver inte veta alla tekniska saker än. Att ha en allmän idé är nog.
+
+Så istället för att dyka för mycket in i detaljer, börjar vi skapa något med Django och vi kommer att lära oss alla viktiga delar längs vägen!
\ No newline at end of file
diff --git a/sv-SE/django_admin/README.md b/sv-SE/django_admin/README.md
new file mode 100644
index 00000000000..2039575cdd3
--- /dev/null
+++ b/sv-SE/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+För att lägga till, redigera och ta bort de inlägg som vi just skapat modeller för använder vi Django admin.
+
+Öppna filen `blog/admin.py` i kodredigeraren och ersätta dess innehåll med detta:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Som du kan se importerar vi (inkluderar) modellen Post definierad i förra kapitlet. För att göra vår modell synlig på administratörssidan måste vi registrera modellen med `admin.site.register(Post)`.
+
+OK, dags att titta på vår modell Post. Kom ihåg att köra `python manage.py runserver` i konsolen för att köra webbservern. Gå till din webbläsare och skriv in adressen http://127.0.0.1:8000/admin/. Du kommer att se en inloggningssida lik denna:
+
+![Login page](images/login_page2.png)
+
+För att logga in måste du skapa en *superanvändare* - ett användarkonto som har kontroll över allt på webbplatsen. Gå tillbaka till kommandoraden, skriv `python manage.py createsuperuser` och tryck enter.
+
+> Kom ihåg: För att skriva nya kommandon medan webbservern körs, öppna ett nytt terminalfönster och aktivera din virtualenv. Vi gick igenom hur man skriver nya kommandon i kapitlet **Ditt första Django-projekt!** i avsnittet **Starta webbservern**.
+
+{% filename %}Mac OS X eller Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+När du blir ombedd, skriv in ditt användarnamn (med gemener, inga mellanslag), e-postadress och lösenord. **Oroa dig inte för att du inte kan se lösenordet du skriver in – det är så det ska vara.** Skriv in det och tryck `enter` för att fortsätta. Utskriften ska se ut så här (där användarnamn och e-post ska vara dina egna):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Återgå till din webbläsare. Logga in med superanvändarens användaruppgifter du valde; du bör se Django admins instrumentpanel.
+
+![Django admin](images/django_admin3.png)
+
+Gå till Posts och experimentera lite. Lägg till fem eller sex blogginlägg. Oroa dig inte för innehållet – det är bara synligt för dig på din lokala dator – du kan kopiera och klistra in text från den här handledningen för att spara tid. :)
+
+Se till att minst två eller tre inlägg (men inte alla) har publiceringsdatum. Det kommer att vara till hjälp senare.
+
+![Django admin](images/edit_post3.png)
+
+Om du vill veta mer om Django admin, kolla in Djangos dokumentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Detta är förmodligen ett bra ögonblick att ta en kaffe (eller te) eller något att äta för att ge dig energi. Du skapade din första Django-modell – du förtjänar en liten paus!
\ No newline at end of file
diff --git a/sv-SE/django_forms/README.md b/sv-SE/django_forms/README.md
new file mode 100644
index 00000000000..761033cb9af
--- /dev/null
+++ b/sv-SE/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django-formulär
+
+Det sista vi vill göra på vår hemsida är att skapa ett trevligt sätt att lägga till och redigera blogginlägg. Djangos `admin` är cool, men den är ganska svår att anpassa och få snygg. Med `forms` kommer vi att ha absolut makt över vårt gränssnitt – vi kan göra nästan vad som helst som vi kan föreställa oss!
+
+Det fina med Django-formulär är att vi antingen kan definiera ett från grunden eller skapa en `ModelForm` som kommer att spara resultatet från formuläret till modellen.
+
+Detta är exakt vad vi vill göra: vi kommer att skapa ett formulär för vår `Post`-modell.
+
+Precis som varje viktig del i Django har formulär sin egen fil: `forms.py`.
+
+Vi måste skapa en fil med det namnet i katalogen `blog` .
+
+    blog
+       └── forms.py
+    
+
+OK, låt oss öppna den i kodredigeraren och skriv följande kod:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Först måste vi importera Django-formulär (`from django import forms`) och vår `Post`-modell (`from .models import Post`).
+
+`PostForm`, som du förmodligen anar, är namnet på vårt formulär. Vi måste berätta för Django att detta formulär är en `ModellForm` (så Django kommer att göra lite magi för oss) – `forms.ModelForm` är ansvarig för det.
+
+Därefter har vi `class Meta`, där vi berättar för Django vilken modell som ska användas för att skapa detta formulär (`model = Post`).
+
+Slutligen kan vi säga vilka fält som ska finnas i vårt formulär. I det här scenariot vill vi endast att `title` och `text` ska exponeras – `author` ska vara den person som för närvarande är inloggad (du! och `created_date` bör automatiskt ställas in när vi skapar ett inlägg (dvs i koden), eller hur?
+
+Och det är det! Allt vi behöver göra nu är att använda formuläret i en *view* och visa det i en mall.
+
+Så återigen kommer vi att skapa en länk till sidan, en URL, en vy och en mall.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/sv-SE/django_installation/README.md b/sv-SE/django_installation/README.md
new file mode 100644
index 00000000000..242c23bc711
--- /dev/null
+++ b/sv-SE/django_installation/README.md
@@ -0,0 +1,7 @@
+# Installera Django
+
+> **Obs** Om du använder en Chromebook, hoppa över detta kapitel och följ istället instruktionerna i [Chromebook Setup](../chromebook_setup/README.md).
+> 
+> **Obs** Om du redan har gått igenom [installationsstegen](../installation/README.md) så har du redan gjort detta – då kan du gå direkt till nästa kapitel!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/sv-SE/django_installation/instructions.md b/sv-SE/django_installation/instructions.md
new file mode 100644
index 00000000000..44053685536
--- /dev/null
+++ b/sv-SE/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Delar av det här avsnittet är baserat på en handledning av Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> En del av det här avsnittet är baserad på [django-marcador tutorial](http://django-marcador.keimlink.de/) licensierad under Creative Commons Attribution-ShareAlike 4.0 International License. Handledningen för django-marcador är upphovsrättsskyddad av Markus Zapke-Gründemann m. fl.
+
+## Virtuell miljö
+
+Innan vi installerar Django kommer vi installera ett mycket användbart verktyg för att hålla din kodningsmiljö välstädad på din dator. Det är möjligt att hoppa över detta steg, men det rekommenderas starkt. Att börja med den bästa möjliga installationen kommer att spara dig en hel del problem i framtiden!
+
+Så, låt oss skapa en **virtuell miljö** (även kallad *virtualenv*). Virtualenv kommer att isolera din Python/Django-installation per projekt. Detta innebär att eventuella ändringar du gör på en webbsida inte kommer påverka andra webbsidor du också utvecklar. Trevligt, eller hur?
+
+Allt du behöver göra är att hitta en katalog där du vill skapa din `virtualenv`; din hemkatalog, till exempel. På Windows kan den se ut som `C:\Users\Name` (där `Name` är namnet på din inloggning).
+
+> **OBS:** I Windows, se till att denna katalog inte innehåller accenter eller specialtecken; om ditt användarnamn innehåller accentuerade tecken, använd en annan katalog, till exempel, `C:\djangogirls`.
+
+För denna handledning kommer vi att använda en ny katalog `djangogirls` i din hemkatalog:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Vi kommer att göra en virtualenv som heter `myvenv`. Kommandot kommer att vara på formatet:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+För att skapa en ny `virtualenv` måste du öppna kommandotolken och köra `python -m venv myvenv`. Det kommer att se ut så här:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Där `myvenv` är namnet på din `virtualenv`. Du kan använda något annat namn, men håll dig till gemener och använda inga mellanslag, accenter eller specialtecken. Det är också en bra idé att hålla namnet kort – du kommer att referera till det mycket!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Vi kan skapa en `virtualenv` på både Linux och OS X genom att köra `python3 -m venv myvenv`. Det kommer att se ut så här:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` är namnet på din `virtualenv`. Du kan använda något annat namn, men håll dig till gemener och använda inga mellanslag. Det är också bra att hålla namnet kort – du kommer att referera till det mycket!
+
+> **OBS:** På vissa versioner av Debian/Ubuntu kan du få följande fel:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> I så fall, följ instruktionerna ovan och installera `python3-venv`-paketet: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **OBS:** Vissa versioner av Debian/Ubuntu som initierar den virtuella miljön på det här sättet ger för närvarande följande fel:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> För att komma runt detta, använd kommandot `virtualenv` istället.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **OBS:** Om du får ett fel som detta
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> kör istället:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Arbeta med virtualenv
+
+Kommandot ovan kommer att skapa en katalog som heter `myvenv` (eller vilket namn du än väljer) som innehåller vår virtuella miljö (i princip ett gäng kataloger och filer).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Starta din virtuella miljö genom att köra:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **OBS:** På Windows 10 kan du få ett fel i Windows PowerShell som säger `execution of scripts is disabled on this system`. I så fall, öppna en annan Windows PowerShell med alternativet "Kör som administratör". Skriv sedan följande kommando innan du startar din virtuella miljö:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **OBS:** För användare av den populära editorn VS Code, som kommer med en integrerad terminal baserad på Windows PowerShell, om du vill hålla fast vid den integrerade terminalen, kan du köra följande kommando för att aktivera din virtuella miljö:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> Fördelen är att du inte behöver växla mellan redigerarfönster och kommandoradsfönster
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Starta din virtuella miljö genom att köra:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Kom ihåg att ersätta `myvenv` med ditt valda `virtualenv`-namn!
+
+> **OBS:** Om kommandot `source` inte är tillgängligt, prova att göra detta istället:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+Du vet att du har startat `virtualenv` när du ser att prompten i din konsol är prefixad med `(myvenv)`.
+
+När du arbetar i en virtuell miljö kommer `python` automatiskt att hänvisa till rätt version så du kan använda `python` istället för `python3`.
+
+OK, vi har alla viktiga beroenden på plats. Vi kan äntligen installera Django!
+
+## Installera Django {#django}
+
+Nu när du har startat din `virtualenv` kan du installera Django.
+
+Innan vi gör det bör vi se till att vi har den senaste versionen av `pip`, den programvara vi använder för att installera Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installera paket med krav (requirements)
+
+En kravfil håller en lista över beroenden som ska installeras med `pip install`:
+
+Skapa först filen `requirements.txt` inuti mappen `djangogirls/` med kodeditorn du installerade tidigare. Du gör detta genom att öppna en ny fil i kodeditorn och sedan sparar den som `requirements.txt` i mappen `djangogirls/` Din katalog kommer att se ut så här:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+Lägg till följande i filen `djangogirls/requirements.txt`:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Kör nu `pip install -r requirements.txt` för att installera Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> Om du får ett fel när du kör pip på Windows, kontrollera om ditt projekts sökväg innehåller mellanslag, accenter eller specialtecken (till exempel `C:\Users\User Name\djangogirls`). Om det gör det, överväg att använda en annan plats utan mellanslag, accenter eller specialtecken (till exempel: `C:\djangogirls`). Skapa en ny virtualenv i den nya katalogen, ta sedan bort den gamla och prova kommandot ovan igen. (Att flytta virtualenv-mappen kommer inte fungera eftersom virtualenv använder absoluta sökvägar.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Din kommandorad kan frysa när du försöker installera Django. Om detta händer, kör detta istället för kommandot ovan:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> Om du får ett fel när du kör pip på Ubuntu 12.04 kör `python -m pip install -U --force-reinstall pip` för att fixa pip-installationen i din virtualenv.
+
+<!--endsec-->
+
+Det var det! Du är nu (äntligen) redo att skapa en Django-applikation!
\ No newline at end of file
diff --git a/sv-SE/django_models/README.md b/sv-SE/django_models/README.md
new file mode 100644
index 00000000000..685e469f03c
--- /dev/null
+++ b/sv-SE/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objekt
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/sv-SE/django_orm/README.md b/sv-SE/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/sv-SE/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/sv-SE/django_start_project/README.md b/sv-SE/django_start_project/README.md
new file mode 100644
index 00000000000..872579badf4
--- /dev/null
+++ b/sv-SE/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Ditt första Django-projekt!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/sv-SE/django_templates/README.md b/sv-SE/django_templates/README.md
new file mode 100644
index 00000000000..7d14c2e3b29
--- /dev/null
+++ b/sv-SE/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figur 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figur 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figur 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/sv-SE/django_urls/README.md b/sv-SE/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/sv-SE/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/sv-SE/django_views/README.md b/sv-SE/django_views/README.md
new file mode 100644
index 00000000000..1af0b49e4cf
--- /dev/null
+++ b/sv-SE/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Fel](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/sv-SE/dynamic_data_in_templates/README.md b/sv-SE/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/sv-SE/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/sv-SE/extend_your_application/README.md b/sv-SE/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/sv-SE/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/sv-SE/how_the_internet_works/README.md b/sv-SE/how_the_internet_works/README.md
new file mode 100644
index 00000000000..9ca1bce172f
--- /dev/null
+++ b/sv-SE/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Hur Internet fungerar
+
+> För läsare hemma: detta kapitel är täckt i filmen [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> Detta kapitlet är inspirerat av Jessica McKellars föredrag "How the Internet Works" (http://web.mit.edu/jesstess/www/).
+
+Vi satsar på att du använder Internet varje dag. Men vet du vad som faktiskt händer när du skriver in en adress som https://djangogirls.org i din webbläsare och trycker på `retur`?
+
+Det första du behöver förstå är att en webbplats består av ett gäng filer som sparas på en hårddisk -- precis som dina filmer, musik, eller bilder. Men det finns en sak som är unik för hemsidor: de innehåller programkod som kallas HTML.
+
+Om du inte är bekant med programmering kan det vara svårt att förstå HTML först, men din webbläsare (som Chrome, Safari, Firefox, etc.) älskar det. Webbläsare är designade för att förstå denna kod, följa dess instruktioner och presentera alla filer som din hemsida är gjord av precis på det sättet som du vill att de ska presenteras.
+
+Precis som med alla filer måste vi lagra HTML-filer någonstans på en hårddisk. För Internet använder vi speciella kraftfulla datorer som kallas *servrar*. De har ingen skärm, mus eller tangentbord, för deras huvudsyfte är att lagra data och göra den åtkomlig. Det är därför de kallas *servrar* - eftersom de *serverar* din information.
+
+Okej, men du vill säkert veta hur Internet ser ut, eller hur?
+
+Vi har ritat en bild åt dig! Så här ser det ut:
+
+![Figur 1.1](images/internet_1.png)
+
+Visst ser det stökigt ut? Egentligen är det ett nätverk av anslutna datorer (ovan nämnda *servers*). Hundratusentals datorer! Många, många mil av kabel runt världen! Du kan besöka en karta över undervattenskablar (http://submarinecablemap.com) som visar hur komplicerat nätet är. Här är en skärmdump från hemsidan:
+
+![Figur 1.2](images/internet_3.png)
+
+Visst är det fascinerande? Men självklart går det inte att ha en kabel mellan varje dator som är ansluten till Internet. Så får att nå en dator (till exempel den där https://djangogirls.org finns sparad) måste vi skicka en begäran genom många olika datorer.
+
+Så här ser det ut:
+
+![Figur 1.3](images/internet_2.png)
+
+Tänk dig att, när du skriver https://djangogirls.org, skickar du ett brev där det står: "Hej Django Girls, jag vill se hemsidan djangogirls.org. Snälla skicka den till mig!"
+
+Ditt brev går till postkontoret närmast dig. Sen skickas det vidare till ett kontor som är lite närmare adressaten, och så vidare tills det når sin destination. Det unika är att även om du skickar många brev (*datapaket*) till samma plats kan de transporteras via helt olika postkontor (*routrar*). Det beror på hur de distribueras vid varje kontor.
+
+![Figur 1.4](images/internet_4.png)
+
+Ja, så simpelt är det. Du skickar meddelanden och förväntar dig ett svar. Istället för papper och penna använder du byte data, men idén är den samma!
+
+Istället för adresser med gatunamn, ort, postnummer och land, använder vi IP-adresser. Din dator ber en DNS-server (Domain Name System) att översätta djangogirls.org till en IP-adress. Det fungerar lite som en gammaldags telefonkatalog där du kan leta efter namnet på en person du vill kontakta och hitta deras telefonnummer och adress.
+
+När du skickar ett brev behövs några olika saker för att det ska komma fram ordentligt: en adress, frimärke osv. Du använder även ett språk som mottagaren förstår, eller hur? Detsamma gäller de *datapaket* som du skickar till en webbplats. Vi använder ett protokoll som kallas HTTP (Hypertext Transfer Protocol).
+
+Så när du har en hemsida måste du helt enkelt ha en *server* där den bor. När *servern* tar emot en inkommande *begäran* (i ett brev), skickar den tillbaka din webbplats (i ett annat brev).
+
+Eftersom detta är en tutorial för Django, kommer du säkert fråga vad Django gör. När du skickar ett svar, vill du inte alltid skicka samma sak till alla. Det är mycket bättre om dina brev är personliga till personen som precis har skrivit till dig, eller hur? Django hjälper dig att skapa dessa personliga, intressanta brev. :)
+
+Nog med prat- dags att skapa något!
\ No newline at end of file
diff --git a/sv-SE/html/README.md b/sv-SE/html/README.md
new file mode 100644
index 00000000000..b48a43def2c
--- /dev/null
+++ b/sv-SE/html/README.md
@@ -0,0 +1,227 @@
+# Introduktion till HTML
+
+Du kanske undrar vad en mall är?
+
+En mall är en fil som vi kan återanvända för att presentera information med olika innehåll i ett konsekvent format – till exempel kan du använda en mall för att hjälpa dig att skriva ett brev. För även om varje brev kan innehålla olika meddelanden och adresseras till olika personer, kommer de att dela samma format.
+
+En Django-malls format skrivs på ett språk som heter HTML (det är den HTML vi nämnde i det första kapitlet, **Hur Internet fungerar**).
+
+## Vad är HTML?
+
+HTML är kod som tolkas av din webbläsare – till exempel Chrome, Firefox eller Safari – för att visa en webbsida för användaren.
+
+HTML står för "HyperText Markup Language". **HyperText** betyder att det är en typ av text som stöder hyperlänkar mellan sidor. **Markup** betyder att vi har tagit ett dokument och markerat det med kod för att berätta något (i det här fallet, en webbläsare) hur man tolkar sidan. HTML-kod är byggd med **taggar**, var och en som börjar med `<` och slutar med `>`. Dessa taggar representerar markup-**element**.
+
+## Din första mall!
+
+Att skapa en mall innebär att skapa en mallfil. Allt är en fil, eller hur? Du har förmodligen märkt detta redan.
+
+Mallar sparas i katalogen `blog/templates/blog` . Så skapa först en katalog som heter `templates` i katalogen blog. Skapa därefter en annan katalog som heter `blog` i din mallkatalog:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(Du kanske undrar varför vi behöver två kataloger som båda heter `blog` – som du kommer att upptäcka senare är detta en användbar namnkonvention som gör livet lättare när saker och ting börjar bli mer komplicerade.)
+
+Skapa nu filen `post_list.html` (lämna den tom för nu) i katalogen `blog/templates/blog` .
+
+Se nu hur din webbplats ser ut: http://127.0.0.1:8000/
+
+> Om du fortfarande får ett fel `TemplateDoesNotExist`, försök att starta om din server. Gå till kommandoraden, stoppa servern genom att trycka på Ctrl+C (Control- och C-tangenten tillsammans) och starta den igen genom att köra kommandot `python manage.py runserver`.
+
+![Figur 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Öppna den nya filen i kodeditorn, och lägg till följande:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+Hur ser din webbplats ut nu? Besök den för att få veta: http://127.0.0.1:8000/
+
+![Figur 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head och body
+
+Varje HTML-sida är också uppdelad i två element: **head** och **body**.
+
+* **head** är ett element som innehåller information om dokumentet som inte visas på skärmen.
+
+* **body** är ett element som innehåller allt annat som visas som en del av webbsidan.
+
+Vi använder `<head>` för att berätta för webbläsaren om konfigurationen av sidan, och `<body>` för att berätta vad som faktiskt finns på sidan.
+
+Du kan till exempel lägga in en webbsidas titel-element i `<head>`, så här:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Spara filen och ladda om sidan.
+
+![Figur 11.3](images/step4.png)
+
+Märkte du hur webbläsaren har förstått att "Ola's blog" är titeln på din sida? Den har tolkat `<title>Ola's blog</title>` och placerat texten i titelfältet i din webbläsare (den kommer också att användas för bokmärken och så vidare).
+
+Förmodligen har du också märkt att varje öppningstagg matchas av en *stängningstagg*, med ett `/`, och att elementen är *nästlade* (dvs du kan inte stänga en viss tagg förrän alla som var inne i den också har stängts).
+
+Det är som att lägga saker i lådor. Du har en stor låda, `<html></html>`; inuti den finns `<body></body>`, och den innehåller ännu mindre lådor: `<p></p>`.
+
+Du måste följa dessa regler för *stängnings*-taggar, och för *nästlade* element – om du inte gör det kan webbläsaren kanske inte tolka dem korrekt och din sida kommer att visas felaktigt.
+
+## Anpassa din mall
+
+Du kan nu ha lite skoj och försöka anpassa din mall! Här är några användbara taggar:
+
+* `<h1>En rubrik</h1>` för din viktigaste rubrik
+* `<h2>En underrubrik</h2>` för en rubrik på nästa nivå
+* `<h3>En under-underrubrik</h3>` …och så vidare, upp till `<h6>`
+* `<p>Ett stycke text</p>`
+* `<em>text</em>` betonar din text
+* `<strong>text</strong>` betonar starkt din text
+* `<br>` går till en annan rad (du kan inte sätta något inuti br och det finns ingen stängningstagg)
+* `<a href="https://djangogirls.org">länk</a>` skapar en länk
+* `<ul><li>första elementet</li><li>andra elementet</li></ul>` skapar en lista, precis som denna!
+* `<div></div>` definierar ett avsnitt på sidan
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Här är ett exempel på en komplett mall, kopiera och klistra in den i `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Det ger oss denna effekt:
+
+![Figur 11.4](images/step6.png)
+
+Yaaay! Men hittills visar vår mall bara exakt **samma information** hela tiden – medan vi tidigare pratade om mallar som tillåter oss att visa **olika** information i **samma format**.
+
+Vad vi verkligen vill göra är att visa riktiga inlägg som lagts till i vår Django admin – och det är dit vi ska härnäst.
+
+## En sak till: driftsätt!
+
+Det skulle vara bra att se allt detta leva på Internet, eller hur? Låt oss göra ytterligare en driftsättning på PythonAnywhere:
+
+### Commita och pusha din kod till GitHub
+
+Allra först, låt oss se vilka filer som har ändrats sedan vi senast driftsatte (kör dessa kommandon lokalt, inte på PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Se till att du är i katalogen `djangogirls` och säg till `git` att inkludera alla ändringar i denna katalog:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Innan vi laddar upp alla filer, låt oss kontrollera vad `git` kommer att ladda upp (alla filer som `git` kommer ladda upp ska visas i grönt):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Vi är nästan klara, nu är det dags att berätta för git att spara den här förändringen i dess historik. Vi kommer att ange ett "commit-meddelande" där vi beskriver vad vi har ändrat. Du kan skriva vad du vill i detta skede, men det är bra att skriva något beskrivande så att du i framtiden kan komma ihåg vad du har gjort.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+När vi har gjort det så laddar vi upp (pushar) våra ändringar till GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Dra ner din nya kod till PythonAnywhere och ladda om din webbapp
+
+* Öppna sidan [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) och gå till din **Bash-konsol** (eller starta en ny). Kör sedan:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+Du måste ersätta `<your-pythonanywhere-domain>` med ditt faktiska subdomännamn utan vinkelparenteser. Ditt subdomännamn är normalt sett ditt användarnamn på PythonAnywhere men i vissa fall kan det vara lite annorlunda (t.ex. om ditt användarnamn innehåller stora bokstäver). Så om detta kommando inte fungerar, använd kommandot `ls` (listar filer) för att hitta din faktiska subdomän/mappnamn och kör `cd` dit.
+
+Se nu hur din kod laddas ner. Om du vill kontrollera att den har anlänt, kan du hoppa över till sidan **"Files"** och visa din kod på PythonAnywhere (du kan nå andra PythonAnywhere-sidor från menyknappen på konsolsidan).
+
+* Slutligen, hoppa över till sidan ["Web"](https://www.pythonanywhere.com/web_app_setup/) och klicka på **Reload** på din webbapp.
+
+Din uppdatering bör vara live! Gå vidare och uppdatera din webbsida webbläsaren. Ändringarna bör vara synliga. :)
\ No newline at end of file
diff --git a/sv-SE/install_git.md b/sv-SE/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/sv-SE/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sv-SE/installation/README.md b/sv-SE/installation/README.md
new file mode 100644
index 00000000000..3570a87b8e8
--- /dev/null
+++ b/sv-SE/installation/README.md
@@ -0,0 +1,68 @@
+# Om du följer handledningen hemifrån
+
+Om du följer handledningen hemma, och inte vid ett [Django Girls-event](https://djangogirls.org/events/), kan du helt hoppa över detta kapitel och gå direkt till kapitlet [Hur Internet fungerar](../how_the_internet_works/README.md).
+
+Detta beror på att vi går igenom installationen av saker som behövs i handledningen – detta är bara en tilläggssida som samlar alla installationsinstruktioner på ett ställe (vilket är användbart för vissa workshop-format). Du kan välja att installera allt som listas på denna sida nu om du vill. Men om du vill lära dig saker innan du installerar en massa saker på datorn, hoppa över detta kapitel så kommer vi att förklara installationsdelarna för dig senare, allteftersom de behövs.
+
+Lycka till!
+
+# Om du deltar i en workshop
+
+Om du deltar i ett [Django Girls-event](https://djangogirls.org/events/):
+
+* Din workshop kanske har en "installationsfest" innan huvud-workshopen. Om du är på en installationsfest är den här sidan till för dig! Följ instruktionerna här för att få allt du behöver inför workshopen installerad, med hjälp av coacharna om det behövs. På huvud-workshopen kommer du sen kunna hoppa över installationsinstruktionerna som du stöter på i huvudhandledningen.
+* Arrangörerna av din workshop kan ha bett dig att prova att installera allt på datorn hemma innan workshopen startar. Om du har blivit ombedd att göra det är den här sidan till för dig! Följ instruktionerna här, så gott du kan. Sedan på huvud-workshopen, när du kommer till ett installationssteg i huvudhandledningen och om du inte kunde få den delen installerad kan du få hjälp av din coach.
+* Om din workshop inte har en installationsfest (eller om du inte kunde delta) och om arrangörerna inte bad dig att försöka installera allt innan du kom: hoppa över denna sida och gå direkt till kapitlet [Hur Internet fungerar](../how_the_internet_works/README.md). Du kommer att installera allt du behöver när du går igenom handledningen.
+
+# Installation
+
+I den här handledningen kommer du att skapa en blogg. För att göra det kommer du att instrueras om hur man installerar olika program på din dator och registrera några online-konton allteftersom behövs. Denna sida samlar alla installations- och registreringsanvisningar på ett ställe (vilket är användbart för vissa workshopformat).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Kort introduktion till kommandoraden {#command-line}
+
+Många av stegen nedan refererar till "konsolen", "terminal", "kommandofönster" eller "kommandorad" – alla dessa betyder samma sak: ett fönster på din dator där du kan skriva in kommandon. När du kommer till huvudhandledningen får du lära dig mer om kommandoraden. För tillfället är det viktigaste du behöver veta hur du öppnar ett kommandofönster och hur det ser ut: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Installera Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Installera en kodeditor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Ställ in virtualenv och installera Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Installera Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Skapa ett GitHub-konto {#github-account}
+
+Gå till [GitHub.com](https://www.github.com) och registrera ett nytt, gratis användarkonto. Kom ihåg ditt lösenord (lägg till det i din lösenordshanterare om du använder en).
+
+# Skapa ett PythonAnywhere-konto {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Börja läsa
+
+Grattis, du är redo att köra! Om du fortfarande har lite tid innan workshopen kan det vara bra att börja läsa några av de första kapitlen:
+
+* [Hur internet fungerar](../how_the_internet_works/README.md)
+
+* [Introduktion till kommandoraden](../intro_to_command_line/README.md)
+
+* [Introduktion till Python](../python_introduction/README.md)
+
+* [Vad är Django?](../django/README.md)
+
+# Ha så kul på workshopen!
+
+När du påbörjar workshopen kommer du att kunna gå direkt till [Ditt första Django-projekt!](../django_start_project/README.md) eftersom du redan gått igenom materialet i de tidigare kapitlen.
\ No newline at end of file
diff --git a/sv-SE/instructions.md b/sv-SE/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/sv-SE/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/sv-SE/intro_to_command_line/README.md b/sv-SE/intro_to_command_line/README.md
new file mode 100644
index 00000000000..6ff0621a396
--- /dev/null
+++ b/sv-SE/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduktion till kommandotolken
+
+> För läsare hemma: detta kapitel omfattas av videon [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+Visst är det spännande!?! Inom bara några minuter kommer du skriva din första rad kod! :)
+
+**Låt oss introducera dig till din första nya vän: kommandotolken!**
+
+De följande stegen kommer att visa dig hur du använder det svarta fönstret som alla hackers använder. Det kan se lite läskigt ut i början, men egentligen är det bara ett fönster som väntar på instruktioner från dig.
+
+> **Obs** Genom hela denna bok används termerna 'katalog' och 'mapp' synonymt.
+
+## Vad är kommandotolken?
+
+Fönstret, som oftast kallas **kommandotolken** eller **terminalen**, är ett textbaserat program för att visa, hantera och ändra filer på din dator. Ungefär som Windows Utforskaren eller Finder på Mac, men utan det grafiska gränssnittet. Andra namn på kommandotolken är: *cmd*, *CLI*, *prompt*, *konsol* eller *terminal*.
+
+## Öppna kommandotolken
+
+För att starta några experiment så behöver vi öppna kommandotolken.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+Du borde nu se ett vitt eller svart fönster som väntar på dina kommandon.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Om du är på Mac eller Linux, så ser du nog en `$`, såhär:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+På Windows, så ser du nog en `>`, såhär:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Kolla på Linux-sektionen precis ovan nu -- du kommer att se mer som det när du kommer till PythonAnywhere senare i handledningen.
+
+<!--endsec-->
+
+Varje kommando kommer att infogas av ett `$` eller `>` och ett mellanrum, men du ska inte skriva det. Din dator kommer att göra det åt dig. :)
+
+> En liten notis: i ditt fall kan det vara något som `C:\Users\ola>` eller `Olas-MacBook-Air:~ ola$` och det är 100% OK.
+
+Delen fram till och med `$` eller `>` kallas *kommandoradsprompten* eller kort och gott *prompten*. Den uppmanar dig att mata in något där.
+
+I handledningen, när vi vill att du ska skriva in ett kommando, kommer vi att inkludera `$` eller `>`, och ibland ännu mer till vänster. Ignorera den vänstra delen och skriv bara in kommandot, som börjar efter prompten.
+
+## Ditt första kommando (WOHO!)
+
+Börja med att skriva detta kommando:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+Och tryck sedan `Enter`. Detta blir resultatet:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+Som ni kan se har datorn precis skrivit ut ditt användarnamn. Snyggt, va? :)
+
+> Försök att skriva varje kommando för hand, utan att kopiera och klistra in. På så sätt kommer du komma ihåg bättre!
+
+## Grunderna
+
+Varje operativsystem har lite olika kommandon för terminalen, så följ instruktionerna för ditt operativsystem. Nu kör vi!
+
+### Aktuell katalog
+
+Visst hade det varit bra att veta var vi är? Skriv in detta kommando och tryck `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Notis: 'pwd' står för 'print working directory', alltså 'skriv ut nuvarande mapp'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+Du ser säkert något liknande på din dator. När du öppnar terminalen brukar du starta i användarens hemmamapp.
+
+* * *
+
+### Lär dig mer om ett kommando
+
+Många kommandon som du kan skriva i kommandotolken har inbyggd hjälp som du kan visa och läsa! Till exempel, för att lära sig mer om kommandot som visar vilken mapp du är i:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X och Linux har ett `man` kommando, vilket ger dig hjälp med kommandon. Testa `man pwd` och se vad den säger, eller lägg `man` före andra kommandon för att se hjälp om dem. Utmatningen av `man` har normalt sidor. Använd mellanslag för att gå till nästa sida, och `q` för att sluta visa hjälpsidan.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Om du lägger till `/?` suffix till flesta kommandon kommer att visa hjälpsidan. Du kan behöva skrolla upp i kommandotolken för att se allt. Testa `cd /?`.
+
+<!--endsec-->
+
+### Lista filer och mappar
+
+Så vad finns här? Det hade varit kul att se. Vi testar:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Ändra aktuell mapp
+
+Låt oss gå till Skrivbordets mapp:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Notera att mapp-namnet "Desktop" kan vara översatt till språket på ditt Linux-konto. Om det är så, så behöver du ändra `Desktop` till det översatta ordet; till exempel, `Schreibtisch` på Tyska.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Kolla om det verkligen är ändrat:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Här är det!
+
+> Tips: Om du skriver `cd D` och sen klickar på `tab` på ditt tangentbord, så kommer kommandotolken att automatiskt skriva in resten av namnet för att navigera snabbare. Om det finns fler än en mapp som startar med "D", klicka på `tab` tangenten två gånger för att få en lista med alternativ.
+
+* * *
+
+### Skapa mapp
+
+Vad sägs om att skapa en test-mapp på ditt skrivbord? Du kan göra det så här:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir övning
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir övning
+    
+
+<!--endsec-->
+
+Det här lilla kommandot kommer att skapa en mapp med namnet `övning` på ditt skrivbord. Du kan kolla om det är där genom att kolla på ditt skrivbord eller genom att göra `ls` eller `dir` kommandot! Prova det. :)
+
+> Tips: Om du inte vill skriva samma kommando om och om igen, försök trycka på `uppåtpilen` och `nedåtpilen` på ditt tangentbord för att bläddra bland kommandon som du nyligen använt.
+
+* * *
+
+### Övning!
+
+En liten utmatning för dig: i din nyligen skapade `övning` mapp, skapa en mapp som heter `test`. (Använd `cd` och `mkdir` kommandona.)
+
+#### Lösning:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd övning
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Grattis!
+
+* * *
+
+### Rensa upp
+
+Vi vill inte lämna en röra, så låt oss ta bort allt som vi gjort tills nu.
+
+Först, måste vi gå tillbaka till Skrivbordet:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Om man använder `..` med `cd` kommandot så kommer det att ändra din nuvarande mapp till förälder mappen (det är, mappen som innehåller din nuvarande mapp).
+
+Kolla var du är:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Nu är det dags att radera `övning` mappen:
+
+> **Varning**: Borttagning av filer med `del`, `rmdir` eller `rm` är oåterkalleligt, alltså är *de raderade filerna borta för alltid*! Så var väldigt försiktig med det här kommandot.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r övning
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S övning
+    övning, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Klart! För att vara säker på att den är raderad, låt oss kolla:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Avsluta
+
+Nu är det klart för nu! Du kan nu stänga kommandotolken. Låt oss göra det på hacker sättet, okej? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Coolt, va? :)
+
+## Sammanfattning
+
+Här är en sammanfattning av några viktiga kommandon:
+
+| Kommando (Windows) | Kommando (Mac OS / Linux) | Beskrivning              | Exempel                                               |
+| ------------------ | ------------------------- | ------------------------ | ----------------------------------------------------- |
+| exit               | exit                      | stäng fönstret           | **exit**                                              |
+| cd                 | cd                        | ändra katalog            | **cd test**                                           |
+| cd                 | pwd                       | visa nuvarande katalog   | **cd** (Windows) eller **pwd** (Mac OS / Linux)       |
+| dir                | ls                        | lista kataloger/filer    | **dir**                                               |
+| copy               | cp                        | kopiera fil              | **copy c:\test\test.txt c:\windows\test.txt**     |
+| move               | mv                        | flytta fil               | **move c:\test\test.txt c:\windows\test.txt**     |
+| mkdir              | mkdir                     | skapa en ny katalog      | **mkdir testkatalog**                                 |
+| rmdir (eller del)  | rm                        | ta bort en fil           | **del c:\test\test.txt**                            |
+| rmdir /S           | rm -r                     | ta bort en mapp          | **rm -r testkatalog**                                 |
+| [CMD] /?           | man [CMD]                 | få hjälp om ett kommando | **cd /?** (Windows) eller **man cd** (Mac OS / Linux) |
+
+Dessa är få av alla andra kommandon som du kan köra i kommandotolken, men du kommer inte att använda fler än de idag.
+
+Om du är nyfiken så innehåller [ss64.com](http://ss64.com) en komplett lista med kommandon för alla operativsystem.
+
+## Redo?
+
+Låt ås dyka in i Python!
\ No newline at end of file
diff --git a/sv-SE/intro_to_command_line/open_instructions.md b/sv-SE/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..9a9ef02e92a
--- /dev/null
+++ b/sv-SE/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Beroende på vilken version du har av Windows och vilket tangentbord, en av de följande bör öppna ett kommandofönster (du kan behöva experimentera lite, men du behöver inte försöka alla de här förslagen):
+
+- Gå till Start-menyn eller startskärmen och skriv "Kommandotolk" i sökfältet.
+- Gå till Start-menyn → Windows System → Kommandotolk.
+- Gå till Start-menyn → Alla Program → Tillbehör → Kommandotolk.
+- Gå till startskärmen, håll musen i det nedre vänstra hörnet av skärmen och klicka på nedåtpilen som visas (på pekskärmar, slå istället upp från botten av skärmen). App-sidan bör öppnas. Klicka på Kommandotolk i Windows System avsnittet.
+- Håll in Windows-tangenten på ditt tangentbord och klicka på "X" tangenten. Välj "Kommandotolk" från popup-menyn.
+- Håll in Windows-tangenten och klicka på "R" för att visa ett "Kör" fönster. Skriv in "cmd" i fönstret och klicka på OK.
+
+![Skriv "cmd" i "Kör" fönstret](../python_installation/images/windows-plus-r.png)
+
+Senare i den här handledningen så kommer du att behöva ha två kommandotolkar öppna samtidigt. Dock på vissa versioner av Windows, om du redan har en kommandotolk öppen och du försöker att öppna en till med samma metod, så kommer den istället att peka till kommandotolken som redan är öppen. Försök nu på din dator och se vad som händer! Om du fortfarande bara har en kommandotolk, försök en av dem andra metoderna i listan ovan. Åtminstone en av de borde resultera i att en ny kommandotolk öppnas.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Gå till Applikationer → Verktyg → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Det är förmodligen under Applikationer → Tillbehör → Terminal, eller Applikationer → System → Terminal, men det kan variera beroende på ditt system. Om det inte finns där, så kan du försöka att Googla det. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/sv-SE/python_installation/README.md b/sv-SE/python_installation/README.md
new file mode 100644
index 00000000000..3b9cdff9e2b
--- /dev/null
+++ b/sv-SE/python_installation/README.md
@@ -0,0 +1,15 @@
+# Komma igång med Python
+
+Vi är äntligen här!
+
+Men först, låt oss berätta vad Python är. Python är ett väldigt populärt programmeringsspråk som kan användas för att skapa webbsidor, spel, vetenskapsapplikationer, grafiker och mycket, mycket mer.
+
+Python har sitt ursprung i slutet av 1980-talet och dess huvudsakliga mål är att vara läsbar för människor (inte bara maskiner!). Det är därför det ser enklare ut än andra programmeringsspråk, men oroa dig inte – Python är också riktigt kraftfullt!
+
+# Installera Python
+
+> **Obs** Om du använder en Chromebook, hoppa över detta kapitel och följ istället instruktionerna i [Chromebook Setup](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/sv-SE/python_installation/instructions.md b/sv-SE/python_installation/instructions.md
new file mode 100644
index 00000000000..197fcea0a6b
--- /dev/null
+++ b/sv-SE/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> För läsare hemifrån: det här kapitlet täcks i [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) videon.
+> 
+> Den här sektionen är baserad på en handledning av Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django är skrivet i Python. Vi behöver Python för att göra något i Django. Låt oss börja genom att installera det! Vi vill att du installerar den senaste versionen av Python 3, så om du har någon tidigare version, så behöver du uppgradera den. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Installera normala Python som följande, även om du har Anaconda installerad på din dator.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Först kolla om din dator kör en 32-bit version eller en 64-bit version av Windows, på "System typ" raden i System Info sidan. För att nå denna sida, försök en av dessa metoder:
+
+* Tryck ned Windows-tangenten och Pause/Break-tangenten samtidigt
+* Öppna Kontrollpanelen från Windows-menyn och navigera sedan till System & Säkerhet, sen System
+* Tryck på Windows-knappen och navigera sedan till Inställningar > System > Om
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+Du kan ladda ned Python till Windows från deras hemsida https://www.python.org/downloads/windows/. Klicka på länken "Latest Python 3 Release - Python x.x.x". Om din dator kör en **64-bit** version av Windows, ladda ned **Windows x86-64 executable installer**. Ladda annars ned **Windows x86 executable installer**. Kör installationsfilen efter att du har laddat ned den genom att dubbelklicka på den.
+
+En sak att se upp för: Under installation kommer du se ett fönster markerat "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Glöm inte att lägga till Python till Path](../python_installation/images/python-installation-options.png)
+
+När installationen är klar kan det komma upp en dialogruta med en länk som du kan följa för att lära dig mer om Python eller om ersionen du installerade. Stäng eller avbryt den dialogen -- du kommer att lära dig mer i den här handledningen!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Ladda ned *Mac OS X 64-bit/32-bit installer* filen,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/sv-SE/python_introduction/README.md b/sv-SE/python_introduction/README.md
new file mode 100644
index 00000000000..294b2ca1e21
--- /dev/null
+++ b/sv-SE/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduktion till Python
+
+> Delar av det här kapitlet är baserat på en handledning av Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Låt oss skriva lite kod!
+
+## Python-prompten
+
+> För läsare hemma: denna del omfattas av videon [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U).
+
+För att börja använda Python behöver vi öppna upp *kommandotolken* på datorn. Du bör redan veta hur man gör det – du lärde dig det i kapitlet [Introduktion till kommandotolken](../intro_to_command_line/README.md) .
+
+När du är redo, följ instruktionerna nedan.
+
+Vi vill öppna en Python-konsol, så skriv `python` på Windows eller `python3` på Mac OS/Linux och tryck `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Ditt första Python-kommando!
+
+Efter att ha kört Python-kommandot ändrades prompten till `>>>`. För oss innebär detta att vi för tillfället endast får använda kommandon i Python-språket. Du behöver inte skriva in `>>>` – Python kommer att göra det åt dig.
+
+Om du någon gång vill avsluta Python-konsolen, skriv `exit()` eller använd genvägen `Ctrl + Z` för Windows och `Ctrl + D` för Mac/Linux. Då ser du inte `>>>` längre.
+
+För tillfället vill vi inte lämna Python-konsolen. Vi vill lära oss mer om den. Låt oss börja med att skriva lite matematik, skriv `2 + 3` och tryck `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Snyggt! Ser du hur svaret dök upp? Python kan matematik! Du kan prova andra kommandon som:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+För att utföra potensräkning, säg 2 upphöjt till 3, skriver vi: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Ha kul med detta ett tag och kom sedan tillbaka hit. :)
+
+Som du kan se är Python en utmärkt kalkylator. Om du undrar vad mer du kan göra…
+
+## Strängar
+
+Vad sägs om ditt namn? Skriv ditt förnamn i citattecken så här:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+Du har nu skapat din första sträng! Det är en sekvens av tecken som kan behandlas av en dator. Strängen måste alltid börja och sluta med samma tecken. Dessa kan vara enkla (`'`) eller dubbla (`"`) citationsecken (det är ingen skillnad!) Citationstecknen talar om för Python att det som är inuti dem är en sträng.
+
+Strängar kan strängas ihop. Prova detta:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+Du kan också multiplicera strängar med ett nummer:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Om du behöver sätta en apostrof i din sträng, finns det två sätt att göra det.
+
+Använd dubbla citattecken:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+eller undanta apostrofen med ett omvänt snedstreck (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Snyggt, va? För att se ditt namn i versaler, skriv:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Du använde just `upper`-**metoden** på din sträng! En metod (som `upper()`) är en sekvens av instruktioner som Python måste utföra på ett visst objekt (`"Ola"`) när du kallar den.
+
+Om du vill veta antalet bokstäver som finns i ditt namn, finns det en **funktion** för det också!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Undrar du varför man ibland anropar funktioner med en `.` i slutet av en sträng (som `"Ola".upper()`) och ibland anropar du först en funktion och placerar strängen inom parenteser? Tja, i vissa fall tillhör funktioner objekt, som `upper()`, som endast kan utföras på strängar. I det fallet kallar vi funktionen för en **metod**. I andra fall tillhör funktioner inte något specifikt och kan användas på olika typer av objekt, precis som `len()`. Därför anger vi `"Ola"` som en parameter till funktionen `len`
+
+### Sammanfattning
+
+OK, nog om strängar. Hittills har du lärt dig om:
+
+- **prompten** – att skriva kommandon (kod) i Python-prompten resulterar i svar i Python
+- **tal och strängar** – i Python används nummer för matematik och strängar för textobjekt
+- **operatorer** – som `+` och `*`, kombinera värden för att producera ett nytt
+- **funktioner** – som `upper()` och `len()`, utför åtgärder på objekt.
+
+Dessa är grunderna i varje programmeringsspråk du lär dig. Redo för något svårare? Vi slår vad om att du är!
+
+## Fel
+
+Låt oss prova något nytt. Kan vi få längden på ett nummer på samma sätt som vi kunde ta reda på längden på vårt namn? Skriv `len(304023)` och tryck `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Vi fick vårt första fel! {{ warning_icon }}-ikonen är vårt sätt att förvarna dig om att den kod du är på väg att köra inte fungerar som förväntat. Att göra misstag (även avsiktliga) är en viktig del av inlärningsprocessen!
+
+Det står att objekt av typen "int" (heltal, heltal) inte har någon längd. Så vad kan vi göra nu? Vi kanske kan skriva vårt nummer som en sträng? Strängar har en längd, eller hur?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Det fungerade! Vi använde funktionen `str` inuti funktionen `len`. `str()` konverterar allt till strängar.
+
+- Funktionen `str` omvandlar saker till **strängar**
+- Funktionen `int` omvandlar saker till **heltal**
+
+> Viktigt: vi kan konvertera siffror till text, men vi kan inte nödvändigtvis konvertera text till siffror – vad skulle `int('hello')` betyda?
+
+## Variabler
+
+Ett viktigt begrepp inom programmering är variabler. En variabel är inget annat än ett namn för något så att du kan använda det senare. Programmerare använder dessa variabler för att lagra data, göra deras kod mer läsbar och så att de inte behöver komma ihåg vad saker är.
+
+Låt oss säga att vi vill skapa en ny variabel som heter `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+Vi skriver name är lika med Ola.
+
+Som du märkte returnerade ditt program inte något som det gjorde tidigare. Så hur vet vi att variabeln faktiskt existerar? Ange `name` och tryck `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Jippi! Din första variabel! :) Du kan alltid ändra vad den refererar till:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+Du kan använda den i funktioner också:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Grymt, eller hur? Variabler kan vara vad som helst – siffror också! Prova detta:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Men tänk om vi använde fel namn? Kan du gissa vad som skulle hända? Låt oss försöka!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Ett fel! Som du kan se har Python olika typer av fel och detta kallas ett **NameError**. Python kommer att ge dig detta fel om du försöker använda en variabel som ännu inte har definierats. Om du stöter på detta fel senare, kontrollera din kod för att se om du har skrivit fel.
+
+Lek med detta ett tag och se vad du kan göra!
+
+## print-funktionen
+
+Prova det här:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+När du bara skriver `name`, svarar Pythontolken med sträng-*representationen* av variabeln 'name', vilken är bokstäverna M-a-r-i-a, omgivna av enkla citattecken, ''. När du säger `print(name)`, kommer Python att "skriva ut" innehållet i variabeln till skärmen, utan citationstecken, vilket är snyggare.
+
+Som vi kommer att se senare, är `print()` också användbar när vi vill skriva ut saker inifrån funktioner, eller när vi vill skriva ut saker på flera rader.
+
+## Listor
+
+Utöver strängar och heltal, har Python alla möjliga typer av olika objekt. Nu ska vi introducera ett som heter **lista**. Listor är precis vad du tror att de är: objekt som är listor över andra objekt. :)
+
+Kör vidare och skapa en lista:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Ja, den här listan är tom. Inte särskilt användbar, eller hur? Låt oss skapa en lista över lottnummer. Vi vill inte upprepa oss hela tiden, så vi kommer att lägga listan i en variabel också:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+Okej, vi har en lista! Vad kan vi göra med den? Låt oss se hur många lottnummer det finns i en lista. Har du någon aning om vilken funktion du ska använda för det? Du vet det redan!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Ja! `len()` kan ge dig antalet objekt i en lista. Praktisk, eller hur? Nu kommer vi kanske sortera den:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Detta returnerar ingenting, det ändrade bara ordningen som talen visas i listan. Låt oss skriva ut den igen och se vad som hände:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Som du ser är talen i din lista nu sorterade från lägsta till högsta värde. Grattis!
+
+Vi kanske vill vända på ordningen? Låt oss göra det!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+Om du vill lägga till något i din lista, kan du göra detta genom att skriva detta kommando:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Om du bara vill visa det första talet kan du göra detta med **index**. Ett index är det tal som säger var i en lista ett objekt förekommer. Programmerare föredrar att börja räkna på 0, så det första objektet i din lista är vid index 0, nästa är vid 1, och så vidare. Prova det här:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Som du kan se kan du komma åt olika objekt i din lista med hjälp av listans namn och objektets index inuti hakparenteser.
+
+För att ta bort något från din lista måste du använda **index** som vi lärt oss ovan och metoden `pop()`. Låt oss prova ett exempel och förstärka det vi lärt oss tidigare; vi kommer att ta bort det första talet från vår lista.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Det gick som smort!
+
+För extra skoj, prova några andra index: 6, 7, 1000, -1, -6 eller -1000. Se om du kan förutse resultatet innan du provar kommandot. Är resultaten vettiga?
+
+Du kan hitta en lista över alla tillgängliga listmetoder i detta kapitel i Pythondokumentationen: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> För läsare hemma: denna del omfattas av videon [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+
+En dictionary liknar en lista, men du får tillgång till värden genom att slå upp en nyckel istället för ett numeriskt index. En nyckel kan vara en sträng eller ett tal. Syntaxen för att definiera en tom dictionary är:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Detta visar att du just skapat en tom dictionary. Hurra!
+
+Prova att skriva följande kommando (prova också att ersätta informationen med din egen):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+Med det kommandot skapade du just en variabel som heter `participant` med tre nyckelvärdepar:
+
+- Nyckeln `name` pekar på värdet `'Ola'` (ett `sträng`-objekt),
+- `country` pekar på `'Poland'` (ytterligare en `sträng`),
+- och `favorite_numbers` pekar på `[7, 42, 92]` (en `lista` med tre tal).
+
+Du kan kontrollera innehållet för enskilda nycklar med denna syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Se, det liknar en lista. Men du behöver inte komma ihåg indexet – bara namnet.
+
+Vad händer om vi frågar Python efter värdet av en nyckel som inte finns? Kan du gissa? Låt oss prova och se!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Titta, ett till fel! Det här felet är ett **KeyError**. Python är hjälpsamt och berättar att nyckeln `'age'` inte finns i den här dictionaryn.
+
+När ska du använda en dictionary eller en lista? Tja, det är en bra tanke att överväga. Fundera över svaret innan du tittar på det i nästa rad.
+
+- Behöver du bara en ordnad sekvens av objekt? Använd en lista.
+- Behöver du associera värden med nycklar, så att du kan slå upp dem effektivt (via nyckeln) senare? Använd en dictionary.
+
+Dictionaries, liksom listor, är *muterbara*, vilket innebär att de kan ändras efter att de har skapats. Du kan lägga till nya nyckel-värde par till en dictionary efter att den skapats, så här:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Jag hoppas att det känts vettigt fram till nu. :) Redo för mer skoj med dictionaries? Läs vidare för några fantastiska saker.
+
+Du kan använda metoden `pop()` för att ta bort ett objekt i dictionaryn. Om du vill ta bort nyckel-värde-paret som hör till nyckeln `'favorite_numbers'`, skriv in följande kommando:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Som du kan se från utskriften har nyckel-värde-paret som hörde till nyckeln 'favorite_numbers' tagits bort.
+
+Utöver detta kan du också ändra ett värde som associeras med en redan skapad nyckel i dictionaryn. Skriv detta:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Som du kan se har värdet på nyckeln `'country'` ändrats från `'Poland'` till `'Germany'`. :) Spännande? Hurrah! Du har precis lärt dig ytterligare något fantastisk.
+
+### Sammanfattning
+
+Grymt! Du vet mycket om programmering nu. I den här sista delen lärde du dig om:
+
+- **fel** – du vet nu hur man läser och förstår fel som dyker upp om Python inte förstår ett kommando du har gett det
+- **variabler** – namn för objekt som gör att du kan koda enklare och göra din kod mer läsbar
+- **listor** – listor över objekt som lagras i en viss ordning
+- **dictionaries** – objekt lagrade som nyckelvärdepar
+
+Taggad inför nästa del? :)
+
+## Jämföra saker
+
+> För läsare hemma: denna del omfattas av videon [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4).
+
+En stor del av programmering handlar om att jämföra saker. Vad är det enklaste att jämföra? Tal! Låt oss se hur det fungerar:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Undrar du varför vi sätter två likhetstecken `==` bredvid varandra för att jämföra om talen är lika? Vi använder ett enda `=` för att tilldela värden till variabler. Du behöver alltid, **alltid** använda två av dem – `==` – om du vill kontrollera om saker är lika. Vi kan också konstatera att saker och ting är olika varandra. För det använder vi symbolen `!=`, enligt exemplet ovan.
+
+Ge Python ytterligare två uppgifter:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+Vi har sett `>` och `<`, men vad betyder `>=` och `<=` ? Tolka dem så här:
+
+- x `>` y betyder: x är större än y
+- x `<` y betyder: x är mindre än y
+- x `<=` y betyder: x är mindre än eller lika med y
+- x `>=` y betyder: x är större än eller lika med y
+
+Grymt! Vill du göra ett kommando till? Prova detta:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Du kan ge Python så många tal att jämföra som du själv vill, och det kommer att ge dig ett svar! Ganska smart, eller hur?
+
+- **and** – om du använder operatorn `and` måste båda jämförelserna vara sanna för att hela kommandot ska vara sant
+- **or** – om du använder operatorn `or` behöver bara en av jämförelserna vara sant för att hela kommandot ska vara sant
+
+Har du hört talas om uttrycket "jämföra äpplen med päron"? Vi provar Python-motsvarigheten:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Här ser du att precis som i talesättet, kan Python inte jämföra ett tal (`int`) och en sträng (`str`). Istället visas ett **TypeError** och säger att de två typerna inte kan jämföras.
+
+## Boolean
+
+Förresten, du lärde dig just om en ny typ av objekt i Python. Det kallas **Boolean**.
+
+Det finns bara två booleska objekt:
+
+- True
+- False
+
+Men för att Python ska förstå detta, måste du alltid skriva det som "True" (första bokstaven versal, med resten av bokstäverna gemena). **true, TRUE, och tRUE fungerar inte – endast True är korrekt.** (Samma sak gäller även 'False'.)
+
+Booleaner kan även vara variabler! Se här:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Du kan också göra på detta sätt:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Träna och ha kul med booleaner genom att försöka köra följande kommandon:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Grattis! Booleaner är en av de coolaste finesserna inom programmering, och du har precis lärt dig att använda dem!
+
+# Spara!
+
+> För läsare hemma: denna del omfattas av videon [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk).
+
+Hittills har vi skrivit all vår python-kod i tolken, vilket begränsar oss till att ange en rad kod åt gången. Normala program sparas i filer och körs av vårt programmeringsspråks **interpretator** eller **kompilator**. Hittills har vi kört våra program en rad åt gången i Python-**interpretatorn**. Vi kommer att behöva mer än en rad kod för de kommande uppgifterna, så vi kommer snabbt behöva:
+
+- Avsluta Python-tolken
+- Öppna valfri kodeditor
+- Spara lite kod i en ny python-fil
+- Kör den!
+
+För att avsluta Pythontolken som vi har använt, skriv in funktionen `exit()`
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Detta kommer att ta dig tillbaka till kommandotolken.
+
+Tidigare valde vi ut en kodeditor från avsnittet [Kod-editor](../code_editor/README.md). Vi kommer nu att behöva öppna redigeraren och skriva lite kod till en ny fil (eller om du använder en Chromebook, skapa en ny fil i molnet IDE och öppna filen, som kommer öppnas i den medföljande kodeditorn):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Du är såklart en ganska erfaren Python-utvecklare nu, så skriv gärna lite kod som du har lärt dig idag.
+
+Nu behöver vi spara filen och ge den ett beskrivande namn. Låt oss kalla filen **python_intro.py** och spara den på skrivbordet. Vi kan namnge filen vadsomhelst, men det viktigaste är att se till att filnamnet slutar med **.py**. Filändelsen **.py** berättar för vårt operativsystem att detta är en **körbar Python-fil** och att Python kan köra den.
+
+> **Observera** Du bör lägga märke till en av de häftigaste sakerna med kodredigerare: färger! I Python-konsolen hade allt samma färg; nu bör du se att funktionen `print` är en annan färg än strängen. Detta kallas "syntax highlighting", och det är en riktigt användbar finess vid kodning. Färgen på saker kommer att ge dig ledtrådar, såsom oavslutade strängar eller en stavfel i ett nyckelordsnamn (som `def` i en funktion, som vi kommer se nedan). Detta är en av anledningarna till att vi använder en kodeditor. :)
+
+Med filen sparad är det dags att köra den! Använda de färdigheter du har lärt dig i kommandoradsavsnittet, använd terminalen till **byta katalog** till skrivbordet.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+På en Mac kommer kommandot att se ut ungefär så här:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+På Linux kommer det att bli så här:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Kom ihåg att ordet "Desktop" kan vara översatt till ditt lokala språk.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+I Windows Command Prompt, kommer det att vara så här:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+Och i Windows Powershell, kommer det att vara så här:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Om du fastnar, be om hjälp. Det är precis vad coacherna är här för!
+
+Använd nu Python för att köra koden i filen så här:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Obs: på Windows känns "python3" inte igen som ett kommando. Använd istället "python" för att köra filen:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Okej! Du körde just ditt första Python-program som var sparat till en fil. Känns det fantastiskt?
+
+Du kan nu gå vidare till ett viktigt verktyg inom programmering:
+
+## If … elif … else
+
+Många saker i koden ska endast utföras när vissa villkor uppfylls. Det är därför Python har något som heter **if-satser**.
+
+Ersätt koden i din **python_intro.py**-fil med detta:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Om vi skulle spara och köra detta skulle vi få se ett fel:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python förväntar sig att vi ger ytterligare instruktioner till det som utförs om villkoret `3 > 2` visar sig vara sant (eller `True` för den delen). Låt oss försöka få Python att skriva ut “It works!”. Ändra koden i din **python_intro.py**-fil till detta:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+La du märke till hur vi ökade indraget på nästa kodrad med 4 mellanslag? Vi måste göra detta så att Python vet vilken kod som ska köras om resultatet är sant. Du kan använda ett mellanslag, men nästan alla Python-programmerare använder 4 för att få det att se snyggt ut. En enda tabb kommer också att räknas som 4 mellanslag så länge din textredigerare är inställd så. När du gjort ditt val, ändra dig inte! Om du redan gjort indragen med 4 mellanslag, gör framtida indrag med 4 mellanslag, också - annars kan du stöta på problem.
+
+Spara och kör igen:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Obs: Kom ihåg att på Windows känns "python3" inte igen som ett kommando. Hädanefter, ersätt "python3" med "python" för att köra filen.
+
+### Vad händer om ett tillstånd inte är sant?
+
+I tidigare exempel utfördes koden endast när villkoren var sanna. Men Python har också `elif` och `else`-satser:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+När detta körs kommer Python skriva ut:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+Om 2 vore ett större tal än 5 skulle det andra kommandot köras. Låt oss se hur `elif` fungerar:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+och vid körning:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+Såg du vad som hände där? `elif` låter dig lägga till extra villkor som körs om tidigare villkor misslyckas.
+
+Du kan lägga till så många `elif`-satser som du vill efter din ursprungliga `if`-sats. Till exempel:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python går igenom varje test i ordning och skriver ut:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Kommentarer
+
+Kommentarer är rader som börjar med `#`. Du kan skriva vad du vill efter `#` och Python kommer att ignorera det. Kommentarer kan göra din kod enklare för andra att förstå.
+
+Låt oss se hur det ser ut:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+Du behöver inte skriva en kommentar för varje kodrad, men de är användbara för att förklara varför din kod gör något, eller ge en sammanfattning när den gör något komplext.
+
+### Sammanfattning
+
+I de senaste övningarna har du lärt dig om:
+
+- **jämförelser** – i Python kan du jämföra saker med `>`, `>=`, `==`, `<=`, `<` och operatorerna `and` och `or`
+- **Boolean** – en typ av objekt som bara kan ha ett av två värden: `True` eller `False`
+- **Spara filer** – lagra kod i filer så att du kan köra större program.
+- **if … elif … else** – satser som låter dig köra kod när endast vissa villkor uppfylls.
+- **kommentarer** - rader som Python inte kör som låter dig dokumentera din kod
+
+Dags för den sista delen i det här kapitlet!
+
+## Dina egna funktioner!
+
+> För läsare hemma: denna del omfattas av videon [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0).
+
+Kommer du ihåg funktioner som `len()` som du kan köra i Python? Goda nyheter – du kommer nu att lära dig att skriva dina egna funktioner!
+
+En funktion är en sekvens av instruktioner som Python ska utföra. Varje funktion i Python börjar med nyckelordet `def`, måste namnges och kan ha parametrar. Vi ger det ett försök. Ersätt koden i din **python_intro.py**-fil med följande:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okej, vår första funktion är redo!
+
+Du kanske undrar varför vi har skrivit namnet på funktionen längst ner i filen. När vi skriver `def hi():` och de efterföljande indragna linjerna så skriver vi instruktioner för vad funktionen `hi()` ska göra. Python kommer att läsa och komma ihåg dessa instruktioner, men kommer inte köra funktionen än. För att berätta för Python att vi vill köra funktionen måste vi anropa funktionen med `hi()`. Python läser filen och exekverar den uppifrån och ner, så vi måste definiera funktionen i filen innan vi kallar den.
+
+Låt oss köra koden och se vad som händer:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Obs: om det inte fungerar, ingen panik! Utskriften kommer att hjälpa dig att förstå varför:
+
+- Om du får ett `NameError`, betyder det förmodligen att du skrivit något fel, så kontrollera att du använde samma namn när du skapade funktionen med `def hi():` och när du anropar den med `hi()`.
+- Om du får ett `IndentationError`, kontrollera att båda `print`-raderna har samma blanktecken i början av en rad: python vill att all kod inuti funktionen ska vara snyggt justerad.
+- Om det inte finns någon utskrift alls, kontrollera att den sista raden `hi()` *inte* är indragen - om den är det, kommer den raden att bli en del av funktionen också, och den kommer aldrig att köras.
+
+Låt oss bygga vår första funktion med parametrar. Vi kommer att ändra det tidigare exemplet – en funktion som säger "hi" till den person som kör den – med ett namn:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+Som du kan se gav vi nu vår funktion en parameter som vi kallade `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Kom ihåg: Funktionen `print` är indragen med fyra mellanslag inuti `if`-satsen. Detta beror på att funktionen körs när villkoret är uppfyllt. Låt oss se hur det fungerar nu:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Hoppsan, ett fel. Lyckligtvis ger Python oss ett ganska användbart felmeddelande. Det säger oss att funktionen `hi()` (den vi definierade) kräver ett argument (`name`) och att vi glömde att skicka med det när vi anropade funktionen. Låt oss fixa det längst ner i filen:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+Och kör igen:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+Och om vi ändrar namnet?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+Och kör:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Vad tror du kommer att hända om du skriver ett annat namn där? (Inte Ola eller Sonja.) Prova och se om du har rätt. Det ska skrivas ut så här:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+Detta är fantastiskt, eller hur? Nu behöver du inte upprepa dig varje gång du vill ändra namnet på personen som funktionen ska hälsa på. Och det är just därför vi behöver funktioner – du vill aldrig upprepa dig i din kod!
+
+Låt oss göra något smartare – det finns fler namn än två, och att skriva ett villkor för var och ett skulle vara svårt, eller hur? Ersätt innehållet i din fil med följande:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Kör nu koden:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Grattis! Du lärde dig precis hur man skriver funktioner! :)
+
+## Loopar
+
+> För läsare hemma: denna del omfattas av videon [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0).
+
+Vi har redan kommit till sista delen. Det gick snabbt, eller hur? :)
+
+Programmerare tycker inte om att upprepa sig. Programmering handlar om att automatisera saker, så vi vill inte hälsa på varje person med deras namn manuellt, eller hur? Det är där loopar kommer till hands.
+
+Kom du ihåg listor? Låt oss göra en lista över tjejer:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+Vi vill hälsa på alla med deras namn. Vi har funktionen `hi` för att göra det, så låt oss använda den i en loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+Uttrycket `for` uppför sig på samma sätt som uttrycket `if`, koden under båda dessa måste indenteras med fyra mellanslag.
+
+Här är den fullständiga koden som kommer att finnas i filen:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+Och när vi kör det:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+Som du kan se kommer allt du lägger in i en `for`-sats med indrag att upprepas för varje element i listan `girls`.
+
+Du kan också använda `for` på tal med funktionen `range`
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Vilket skulle skriva ut:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` är en funktion som skapar en lista med tal som följer den ena efter den andra (dessa tal tillhandahålls som parametrar av dig).
+
+Observera att det andra av dessa två tal inte ingår i listan av utdata från Python (dvs `range(1, 6)` räknar från 1 till 5, men inkluderar inte talet 6). Det beror på att "range" är halvöppen, och med det menar vi att det inkluderar det första värdet, men inte det sista.
+
+## Sammanfattning
+
+Det var det. **Du rockar fett!** Det här var ett knepigt kapitel, så känn dig stolt över dig själv. Vi är definitivt stolta över dig för att du har kommit så här långt!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+Du kanske vill göra något annat en kort stund – stretcha, promenera lite, vila ögonen – innan du går vidare till nästa kapitel. :)
+
+![Muffin](images/cupcake.png)
\ No newline at end of file
diff --git a/sv-SE/signup_pythonanywhere.md b/sv-SE/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/sv-SE/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/sv-SE/template_extending/README.md b/sv-SE/template_extending/README.md
new file mode 100644
index 00000000000..5dec334db4d
--- /dev/null
+++ b/sv-SE/template_extending/README.md
@@ -0,0 +1,151 @@
+# Mallutökning
+
+En annan trevlig sak Django har åt dig är **mallutökning**. Vad betyder detta? Det innebär att du kan använda samma delar av din HTML för olika sidor på din webbplats.
+
+Mallar hjälper dig när du vill använda samma information eller layout på mer än ett ställe. Du behöver inte upprepa dig själv i varje fil. Och om du vill ändra något behöver du inte göra det i varje mall, bara en!
+
+## Skapa en basmall
+
+En basmall är den mest grundläggande mallen som du utökar på varje sida på din webbplats.
+
+Låt oss skapa en `base.html` fil i `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Öppna sedan upp den i kodeditorn och kopiera allt från `post_list.html` till `base.html` fil, så här:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Därefter, i `base.html`, ersätt hela din `<body>` (allt mellan `<body>` och `</body>`) med detta:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Du kanske märker att detta ersatte allt från `{% for post in posts %}` till `{% endfor %}` med: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Men varför? Du har precis skapat ett `block`! Du använde malltaggen `{% block %}` för att skapa ett område som kommer att ha HTML insatt i den. HTML-koden kommer från en annan mall som utökar denna mall (`base.html`). Vi kommer att visa dig hur du ska göra detta om ett ögonblick.
+
+Spara nu `base.html` och öppna din `blog/templates/blog/post_list.html` i kodeditorn. {% raw %}Du kommer att ta bort allt över `{% for post in posts %}` och under `{% endfor %}`. När du är klar kommer filen att se ut så här:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Vi vill använda detta som en del av vår mall för alla innehållsblock. Dags att lägga till blocktaggar till denna fil!
+
+{% raw %}Du vill att din blocktagg ska matcha taggen i din `base.html`. Du vill också att den ska innehålla all kod som hör hemma i dina innehållsblock. För att göra det, lägg allt mellan `{% block content %}` och `{% endblock %}`. Såhär:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Bara en sak kvar. Vi behöver sammankoppla de här två mallarna. Detta är vad mallutökning handlar om! Vi kommer att göra detta genom att lägga till en "extends"-tagg till början av filen. Såhär:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Det är allt! Spara filen, och kontrollera att din webbplats fortfarande fungerar som den ska. :)
+
+> Om du får felet `TemplateDoesNotExist`, betyder det att det inte finns någon `blog/base.html`-fil och du har `runserver` körandes i konsolen. Försök att stoppa den (genom att trycka på Ctrl+C – Control- och C-tangenten tillsammans) och starta om den genom att köra kommandot `python manage.py runserver`.
\ No newline at end of file
diff --git a/sv-SE/whats_next/README.md b/sv-SE/whats_next/README.md
new file mode 100644
index 00000000000..90beba9d27b
--- /dev/null
+++ b/sv-SE/whats_next/README.md
@@ -0,0 +1,43 @@
+# Vad kommer härnäst?
+
+Gratulera dig själv! **Du är helt fantastisk**. Vi är stolta! <3
+
+### Vad gör du härnäst?
+
+Ta en paus och koppla av! Du har just gjort något riktigt stort.
+
+Efter det, se till att följa Django Girls på [Facebook](http://facebook.com/djangogirls) eller [Twitter](https://twitter.com/djangogirls) för att hålla dig uppdaterad.
+
+### Kan du rekommendera några ytterligare resurser?
+
+Ja! Det finns en *hel* del resurser på nätet för att lära sig alla typer av kunskaper i programmering – det kan vara ganska skrämmande att hitta du ska titta på härnäst, men vi hjälper dig. Oavsett dina intressen var innan du kom till Django Girls, och vilka intresserar du har utvecklat under handledningen, här är några gratis resurser (eller resurser med stora fria komponenter) du kan använda för att komma dit du vill vara.
+
+#### Django
+
+- Vår andra bok, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Djangos officiella handledning](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Komma igång med Django videolektioner](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – några videoföreläsningar kan spelas gratis och du kan erhålla ett certifikat från Coursera genom att gå dessa kurser
+
+#### HTML, CSS och JavaScript
+
+- [Codecademys webbutveckling kurs](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademys Python kurs](https://www.codecademy.com/learn/learn-python)
+- [Googles Python kurs](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way bok](http://learnpythonthehardway.org/book/) – de inledande övningarna är gratis
+- [New Coder tutorials](http://newcoder.io/tutorials/) – detta är en mängd praktiska exempel på hur du kan använda Python
+- [edX](https://www.edx.org/course?search_query=python) – du kan läsa de flesta kurser gratis, men om du vill ett certifikat eller krediter mot en examen kommer det att kosta pengar
+- [Courseras Python specialisering](https://www.coursera.org/specializations/python) – några videoföreläsningar kan spelas gratis och du kan tjäna ett Coursera certifikat genom att ta dessa kurser
+- [Python for Everybody](https://www.py4e.com/) - en fri och öppen version av Coursera Python for Everybody specialisering
+
+#### Arbeta med data
+
+- [Codecademys datavetenskapskurs](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – du kan läsa de flesta kurser gratis, men om du vill ett certifikat eller krediter mot en examen kommer det att kosta pengar
+- [Dataquest](https://www.dataquest.io/) – dem första 30 ”uppdragen” är gratis
+
+Vi kan inte vänta att se vad du bygger nästa!
\ No newline at end of file
diff --git a/sv/chromebook_setup/README.md b/sv/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/sv/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/sv/chromebook_setup/instructions.md b/sv/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/sv/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/sv/code_editor/README.md b/sv/code_editor/README.md
new file mode 100644
index 00000000000..404011f1b7d
--- /dev/null
+++ b/sv/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/sv/code_editor/instructions.md b/sv/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/sv/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/sv/deploy/signup_pythonanywhere.md b/sv/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/sv/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/sv/django_orm/README.md b/sv/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/sv/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ta-IN/GLOSSARY.md b/ta-IN/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/ta-IN/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/ta-IN/README.md b/ta-IN/README.md
new file mode 100644
index 00000000000..faf53861a94
--- /dev/null
+++ b/ta-IN/README.md
@@ -0,0 +1,51 @@
+# டான்ஜோ மாணவியர் பயிற்சி
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ta-IN/SUMMARY.md b/ta-IN/SUMMARY.md
new file mode 100644
index 00000000000..640d0fae5a0
--- /dev/null
+++ b/ta-IN/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [குறியீடு தொகுப்பி (Code editor)](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/ta-IN/chromebook_setup/README.md b/ta-IN/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/ta-IN/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ta-IN/chromebook_setup/instructions.md b/ta-IN/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..73c90192876
--- /dev/null
+++ b/ta-IN/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+நீங்கள் Chromebook பயன்படுத்தவில்லை என்றால் [இந்த பிரிவினை தவிர்க்கலாம் ](http://tutorial.djangogirls.org/en/installation/#install-python). நீங்கள் chromebook பயன்படுத்தினால் உங்கள் நிறுவல் அனுபவம் கொஞ்சம் வித்தியாசமாக இருக்கும். Chromebook பயனர்கள் , பின்வரும் நிறுவல் விதிமுறைகளைப் புறக்கணிக்கலாம்.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+கிளவுட் ஐடிஇ என்பது ஒரு குறியீடு எடிட்டரையும் மற்றும் கணினி இயங்கும் அணுகலையும் வழங்கும் ஒரு கருவியாகும். இணையத்தில் நீங்கள் மென்பொருளை நிறுவலாம், எழுதலாம் மற்றும் இயக்கலாம். வரும் இந்த டுடோரியல் கலங்கலில், கிளவுட் ஐடிஇ உங்கள் உள்ளூர் இயந்திரமாக செயல்படும். நீங்கள் இன்னும் OS X, Ubuntu அல்லது Windows முனைய இடைமுகத்தில் உங்கள் கட்டளைகளை இயக்குகிறார், ஆனால் உங்கள் முனையம் இயங்கும் கணினியுடன் இணைக்கப்படும் மேகக்கணி IDE உங்களுக்காக அமைக்கும் வேறு எங்காவது. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). நீங்கள் cloud IDEs ஏதேனும் ஒன்றை தேர்வு செய்து, இந்த வழிமுறைகளை பின்பற்றவும்.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ta-IN/code_editor/README.md b/ta-IN/code_editor/README.md
new file mode 100644
index 00000000000..151d22fab6f
--- /dev/null
+++ b/ta-IN/code_editor/README.md
@@ -0,0 +1,11 @@
+# குறியீடு தொகுப்பி (Code editor)
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+நீங்கள் உங்களது முதல் நிரல்(program) வரியை எழுத போகிறிர்கள் அதனால் இப்போது குறியீடு தொகுப்பி (Code editor) ஒன்றை தரவிறக்கம் (DOWNLOAD) செய்ய வேண்டிய நேரம் வந்துவிட்டது .
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ta-IN/code_editor/instructions.md b/ta-IN/code_editor/instructions.md
new file mode 100644
index 00000000000..9458942d285
--- /dev/null
+++ b/ta-IN/code_editor/instructions.md
@@ -0,0 +1,37 @@
+குறியீடு தொகுப்பி (Code editor)கள் பல உண்டு ஆனால் எதை பயன் படுத்துவது என்பது சொந்த விருப்பத்தை பொறுத்தது. பெரும்பாலான Python நிரலாக்குனர்கள்(programmerகள்) சிக்கலான ஆனால் சக்திவாய்ந்த PyCharm போன்ற IDE( (Integrated Development Environment)க்களை பயன்படுத்துகிறார்கள். அது ஒரு துவக்குனராக உங்களுக்கு பொருத்தமற்றதாக இருக்கலாம். ஆனால் எங்களது பரிந்துரைகள் எளிமையான ஆனால் அதற்கு இணையான சக்திவாய்ந்ததாக இருக்கும். 
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ta-IN/css/README.md b/ta-IN/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/ta-IN/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/ta-IN/deploy/README.md b/ta-IN/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/ta-IN/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/ta-IN/deploy/install_git.md b/ta-IN/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/ta-IN/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ta-IN/deploy/signup_pythonanywhere.md b/ta-IN/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/ta-IN/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ta-IN/django/README.md b/ta-IN/django/README.md
new file mode 100644
index 00000000000..1cee5857c6e
--- /dev/null
+++ b/ta-IN/django/README.md
@@ -0,0 +1,27 @@
+# டிஜாங்க் என்றால் என்ன?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) பைதான் இல் எழுதப்பட்ட ஒரு இலவச மற்றும் திறந்த மூல வலை பயன்பாட்டு கட்டமைப்பாகும். வலைத்தள கட்டமைப்பானது வலைத்தளங்களை வேகமாகவும் எளிதாகவும் உருவாக்க உதவுகின்ற ஒரு கூறுகளின் தொகுப்பு ஆகும்.
+
+நீங்கள் ஒரு வலைத்தளத்தை உருவாக்கும் போது, நீங்கள் எப்போதும் இதே போன்ற கூறுகளின் தொகுப்பு தேவை: பயனர் அங்கீகாரத்தை (கையொப்பமிடுதல், உள்நுழைதல், வெளியேறுதல்), உங்கள் வலைத்தளத்திற்கான நிர்வாக குழு, வடிவங்கள், கோப்புகளை பதிவேற்ற ஒரு வழி.
+
+நீங்கள் அதிர்ஷ்டவசமாக, மற்றவர்கள் ஒரு புதிய தளத்தை உருவாக்கும் போது இதே போன்ற சிக்கல்களை வலை டெவலப்பர்கள் எதிர்கொள்கிறார்கள் என்பதைக் கவனித்திருக்கிறார்கள், அதனால் அவர்கள் அணிவகுத்து, கட்டமைக்கப்பட்ட கூறுகளை உருவாக்கியுள்ளனர்(Django).
+
+சக்கரங்களை புதிதாக்குவதற்கும், ஒரு புதிய தளத்தை உருவாக்கும்போது மேல்நிலை சிலவற்றைத் தணிப்பதற்கும் உதவுவதற்கு கட்டமைப்புகள் உள்ளன.
+
+## உங்களுக்கு ஒரு கட்டமைப்பை ஏன் வேண்டும்?
+
+டான்ஜோ உண்மையில் என்னவென்று புரிந்துகொள்ள, சேவையகங்களில் ஒரு நெருக்கமான பார்வை எடுக்க வேண்டும். முதல் விஷயம் என்னவென்றால், சர்வர் உங்களுக்கு ஒரு வலைப்பக்கத்தை சேவை செய்ய வேண்டும் என்று தெரிந்து கொள்ள வேண்டும்.
+
+உள்வரும் எழுத்துக்கள் (கோரிக்கைகள்) கண்காணிக்கப்படும் ஒரு அஞ்சல் பெட்டி (துறைமுகம்) கற்பனை செய்து பாருங்கள். இது வலை சேவையகத்தால் செய்யப்படுகிறது. வலை சேவையகம் கடிதத்தை படித்து, ஒரு வலைப்பக்கத்தில் பதிலை அனுப்புகிறது. ஆனால் நீங்கள் ஏதாவது அனுப்ப விரும்பும் போது, நீங்கள் சில உள்ளடக்கங்களைக் கொண்டிருக்க வேண்டும். மற்றும் உள்ளடக்கத்தை உருவாக்குவதற்கு உதவுகிற ஒன்று தான் ஜான்மோ.
+
+## உங்கள் சேவையகத்திலிருந்து யாரோ ஒரு வலைத்தளத்தை கோரும் போது என்ன நடக்கிறது?
+
+ஒரு கோரிக்கை வலை சேவையகத்திற்கு வரும் போது, அது உண்மையில் கேட்கப்பட்டதை கண்டுபிடிக்க முயற்சிக்கும் டிஜாங்கிற்கு அனுப்பப்படுகிறது. இது முதல் வலைப்பக்கத்தை எடுக்கும் மற்றும் என்ன செய்ய வேண்டும் என்பதை கண்டுபிடிக்க முயற்சிக்கிறது. இந்த பகுதி, டிஜாங்கோ**urlresolver**செய்யப்படுகிறது. (ஒரு வலைத்தள முகவரி URL ஐ அழைக்கப்படுகிறது - யூனிஃபார்ம் ஆதார லொக்கேட்டர் - எனவே பெயர்*urlresolver* என்பது அர்த்தம்). மிகவும் புத்திசாலி இல்லை-இது ஒரு பட்டியல் எடுக்கும் மற்றும்URLஐ பொருத்த முயற்சிக்கிறது. ஜான் மேலிருந்து கீழிருந்து வடிவங்களை சரிபார்க்கிறது மற்றும் ஏதேனும் பொருந்துகிறதா எனில், டிஜாங்கோ கோரிக்கையை தொடர்புடைய செயல்பாடு (இது*பார்வை*என்று அழைக்கப்படுகிறது) க்கு அனுப்பும்.
+
+கடிதத்துடன் ஒரு மின்னஞ்சல் கேரியர் கற்பனை செய்து பாருங்கள். அவர் தெருவில் நடந்து சென்று கடிதத்தின் மீது ஒவ்வொரு வீட்டின் எண்ணையும் சரிபார்க்கிறார். அது பொருந்தும் என்றால், அவர் அங்கு கடிதம் வைக்கிறது. Urlresolver எவ்வாறு வேலை செய்கிறது!
+
+* பார்வை*செயல்பாடு, அனைத்து சுவாரஸ்யமான விஷயங்கள் செய்யப்படுகின்றன: சில தகவலைப் பார்க்க ஒரு தரவுத்தளத்தைப் பார்க்கலாம். தரவு எதையாவது மாற்றுவதற்கு பயனர் கேட்டாரா? ஒரு கடிதத்தை போலவே, "என் வேலையை விவரிப்பதை தயவு செய்து மாற்றவும்."*பார்வை*அதை செய்ய அனுமதிக்கப்பட்டுள்ளதா என சரிபார்க்கவும், பின்னர் உங்களுக்கான வேலை விவரத்தை புதுப்பித்து, ஒரு செய்தியை அனுப்பவும்: "முடிந்தது!" பின்னர்*பார்வை*ஒரு பதிலை உருவாக்குகிறது மற்றும் டான்ஜோ அதை பயனரின் வலை உலாவியில் அனுப்ப முடியும்.
+
+மேலே உள்ள விளக்கம் சிறிது எளிதானது, ஆனால் இன்னும் தொழில்நுட்ப விஷயங்களை நீங்கள் அறிய வேண்டியதில்லை. ஒரு பொது யோசனை கொண்ட போதுமானது.
+
+அதற்கு பதிலாக டைவிங் விவரங்கள் மிகவும், நாங்கள் ஜான் ஏதாவது உருவாக்க ஆரம்பிக்கும் மற்றும் நாம் வழியில் அனைத்து முக்கிய பகுதிகள் கற்று கொள்கிறேன்!
\ No newline at end of file
diff --git a/ta-IN/django_admin/README.md b/ta-IN/django_admin/README.md
new file mode 100644
index 00000000000..bc8fc908341
--- /dev/null
+++ b/ta-IN/django_admin/README.md
@@ -0,0 +1,57 @@
+# டான்ஜோ நிர்வாகி
+
+நாங்கள் மாதிரியுள்ள பதில்களைச் சேர்க்க, திருத்த மற்றும் நீக்க, நாங்கள் டிஜாங்கோ நிர்வாகியைப் பயன்படுத்துவோம்.
+
+குறியீட்டு ஆசிரியர் உள்ள`வலைப்பதிவு/ admin.py`கோப்பைத் திறந்து, அதனுடன் அதன் உள்ளடக்கங்களை மாற்றலாம்:
+
+{% filename%}வலைப்பதிவு/admin.py {%endfilename%}
+
+```python
+django.contrib இறக்குமதி நிர்வாகி இருந்து
+இருந்து. மோடல்கள் இறக்குமதி போஸ்ட்
+
+admin.site.register (போஸ்ட்)
+```
+
+நீங்கள் பார்க்க முடியும் என, நாம் முந்தைய அத்தியாயத்தில் வரையறுக்கப்பட்ட போஸ்ட் மாதிரி (அடங்கும்) இறக்குமதி. நிர்வாகி பக்கத்தில் எங்கள் மாதிரி தெரியும், நாங்கள்`admin.site.register`உடன் மாதிரி பதிவு செய்ய வேண்டும்.
+
+சரி, எங்கள் போஸ்ட் மாதிரி பார்க்க நேரம். Remember to run `python manage.py runserver` in the console to run the web server. உங்கள் உலாவிக்கு சென்று, முகவரி http://127.0.0.1.100000/admin/. இது போன்ற உள்நுழைவுப் பக்கத்தைக் காண்பீர்கள்:
+
+![புகுபதிகை பக்கம்](images/login_page2.png)
+
+உள்நுழைய, நீங்கள் * superuser*உருவாக்க வேண்டும் - தளத்தில் உள்ள எல்லாவற்றையும் கட்டுப்படுத்தும் ஒரு பயனர் கணக்கு. மீண்டும் கட்டளை வரியில் சென்று,`python manage.py createsuperuser`என டைப் செய்து Enter விசையை அழுத்தவும்.
+
+> நினைவில், வலை சேவையகம் இயங்கும் போது புதிய கட்டளைகளை எழுத, ஒரு புதிய முனைய சாளரத்தை திறந்து, உங்கள் விர்ச்சுவல்வாவை செயல்படுத்தவும். ** உங்கள் முதல் டான்ஜோ திட்டம்!**அத்தியாயம், ** வலை சேவையகத்தை**பிரிவில் துவக்க புதிய கட்டளைகளை எப்படி எழுதுவது என்பதை நாங்கள் மதிப்பாய்வு செய்தோம்.
+
+{% filename%} Mac OS X அல்லது Linux: {% endfilename%}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+கேட்கப்படும் போது, உங்கள் பயனர் பெயர் (ஸ்மால், ஸ்பேஸ் இல்லை), மின்னஞ்சல் முகவரி மற்றும் கடவுச்சொல்லை உள்ளிடவும். **நீங்கள் தட்டச்சு செய்யும் கடவுச்சொல்லைப் பார்க்க முடியாது என்று கவலைப்பட வேண்டாம் - இது எப்படி இருக்க வேண்டும் என்று.**அதை உள்ளிடவும், தொடர `உள்ளிடவும்`அழுத்தவும். வெளியீடு இதைப் போல இருக்க வேண்டும் (பயனர்பெயர் மற்றும் மின்னஞ்சல் உங்கள் சொந்தவையாக இருக்க வேண்டும்):
+
+    பயனர்பெயர்: ஓலா
+    மின்னஞ்சல் முகவரி: ola@example.com
+    கடவுச்சொல்:
+    கடவுச்சொல் (மீண்டும்):
+    சூப்பர்ஸர் வெற்றிகரமாக உருவாக்கப்பட்டது.
+    
+
+உங்கள் உலாவிக்குத் திரும்புக. நீங்கள் தேர்ந்தெடுத்த சூப்பர்ஸரின் சான்றுகளுடன் உள்நுழைக; நீங்கள் Django நிர்வாக கட்டுப்பாட்டு அறை பார்க்க வேண்டும்.
+
+![டான்ஜோ நிர்வாகி](images/django_admin3.png)
+
+இடுகைகளுக்கு சென்று சிறிது முயற்சி செய். ஐந்து அல்லது ஆறு இடுகைகள் சேர்க்கவும். உள்ளடக்கத்தைப் பற்றி கவலைப்பட வேண்டாம் - இது உங்கள் உள்ளூர் கணினியில் மட்டுமே உங்களுக்கு தெரியும் - நேரம் சேமிக்க இந்த டுடோரியலில் இருந்து சில உரைகளை நகலெடுக்கலாம். :)
+
+குறைந்தபட்சம் இரண்டு அல்லது மூன்று பதிவுகள் (ஆனால் அனைத்தையும் அல்ல) வெளியீட்டு தேதி தொகுப்பு என்பதை உறுதிப்படுத்தவும். இது பின்னர் உதவியாக இருக்கும்.
+
+![டான்ஜோ நிர்வாகி](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+இது ஒரு காபி (அல்லது தேநீர்) அல்லது உங்களை மீண்டும் உற்சாகப்படுத்துவதற்கு சாப்பிட ஏதாவது ஒரு நல்ல தருணமாக இருக்கலாம். நீங்கள் உங்கள் முதல் ஜான்ஜோ மாடலை உருவாக்கிவிட்டீர்கள் - சிறிது இடைவெளி தேவை!
\ No newline at end of file
diff --git a/ta-IN/django_forms/README.md b/ta-IN/django_forms/README.md
new file mode 100644
index 00000000000..09054b8b1e5
--- /dev/null
+++ b/ta-IN/django_forms/README.md
@@ -0,0 +1,479 @@
+# டான்ஜோ
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's`admin`குளிர்ச்சியாக உள்ளது, ஆனால் தனிப்பயனாக்க மற்றும் அழகாக செய்ய கடினமாக உள்ளது. `படிவங்களுடன்`எங்களின் இடைமுகத்தின் மீது முழு அதிகாரம் இருக்கும் - நாம் கற்பனை செய்யக்கூடிய எதையும் செய்யமுடியும்!
+
+டிஜாங்க் வடிவங்களைப் பற்றிய நல்ல விஷயம் என்னவென்றால், நாம் புதிதாக ஒன்றை வரையறுக்கலாம் அல்லது ஒரு மாதிரி`ModelForm` உருவாக்கலாம், இது படிவத்தின் விளைவாக மாதிரியாக சேமிக்கப்படும்.
+
+இதுதான் நாம் செய்ய வேண்டியது: நாங்கள் எங்கள்`Post`மாதிரிக்காக ஒரு படிவத்தை உருவாக்கும்.
+
+டிஜாங்கின் முக்கியமான ஒவ்வொரு பகுதியையும் போல, படிவங்கள் அவற்றின் சொந்த கோப்பைக் கொண்டுள்ளன:`forms.py`.
+
+` வலைப்பதிவின்`கோப்பகத்தில் இந்த பெயருடன் ஒரு கோப்பை உருவாக்க வேண்டும்.
+
+    வலைப்பதிவு
+        └── forms.py
+    
+
+சரி, அதை குறியீடு ஆசிரியர் திறக்க மற்றும் பின்வரும் குறியீடு தட்டச்சு செய்யலாம்:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+நாம் முதலில் டிஜாங்கோ வடிவங்களை(`ஜான் இறக்குமதி வடிவங்களில் இருந்து`)மற்றும் எங்கள் ` போஸ்ட்`மாதிரி (` இருந்து. மாடல்கள் இறக்குமதி இடுகை`)இறக்குமதி செய்ய வேண்டும்.
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ta-IN/django_installation/README.md b/ta-IN/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/ta-IN/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ta-IN/django_installation/instructions.md b/ta-IN/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/ta-IN/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ta-IN/django_models/README.md b/ta-IN/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/ta-IN/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ta-IN/django_orm/README.md b/ta-IN/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/ta-IN/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ta-IN/django_start_project/README.md b/ta-IN/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/ta-IN/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ta-IN/django_templates/README.md b/ta-IN/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/ta-IN/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ta-IN/django_urls/README.md b/ta-IN/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/ta-IN/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ta-IN/django_views/README.md b/ta-IN/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/ta-IN/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ta-IN/dynamic_data_in_templates/README.md b/ta-IN/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/ta-IN/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ta-IN/extend_your_application/README.md b/ta-IN/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/ta-IN/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ta-IN/how_the_internet_works/README.md b/ta-IN/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/ta-IN/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ta-IN/html/README.md b/ta-IN/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/ta-IN/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ta-IN/installation/README.md b/ta-IN/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/ta-IN/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ta-IN/intro_to_command_line/README.md b/ta-IN/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/ta-IN/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ta-IN/intro_to_command_line/open_instructions.md b/ta-IN/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/ta-IN/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ta-IN/python_installation/README.md b/ta-IN/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/ta-IN/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ta-IN/python_installation/instructions.md b/ta-IN/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/ta-IN/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ta-IN/python_introduction/README.md b/ta-IN/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/ta-IN/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ta-IN/template_extending/README.md b/ta-IN/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/ta-IN/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ta-IN/whats_next/README.md b/ta-IN/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/ta-IN/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/ta/GLOSSARY.md b/ta/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/ta/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/ta/README.md b/ta/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/ta/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ta/SUMMARY.md b/ta/SUMMARY.md
new file mode 100644
index 00000000000..6bf0769a90a
--- /dev/null
+++ b/ta/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [குறியீடு தொகுப்பி (Code editor)](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/ta/chromebook_setup/README.md b/ta/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/ta/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ta/chromebook_setup/instructions.md b/ta/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..76e3ba7b97a
--- /dev/null
+++ b/ta/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+நீங்கள் ஒரு Chromebook பயன்படுத்தவில்லை என்றால் [இந்த பிரிவு சரி தவிர்க்க](http://tutorial.djangogirls.org/en/installation/#install-python) முடியும். நீங்கள் chromebook பயன்படுத்தினால் உங்கள் நிறுவல் அனுபவத்தை கொஞ்சம் வித்தியாசமாக இருக்கும். Chromebook பயனர்கள் , பின்வரும் நிறுவல் விதிமுறைகளைப் புறக்கணிக்கலாம்.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ta/code_editor/README.md b/ta/code_editor/README.md
new file mode 100644
index 00000000000..b1fecf67140
--- /dev/null
+++ b/ta/code_editor/README.md
@@ -0,0 +1,11 @@
+# குறியீடு தொகுப்பி (Code editor)
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+நீங்கள் உங்களது முதல் நிரல்(program) வரியை எழுத போகிறிர்கள் அதனால் இப்போது குறியீடு தொகுப்பி (Code editor) ஒன்றை தரவிறக்கம் (DOWNLOAD) செய்ய வேண்டிய நேரம் வந்துவிட்டது .
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ta/code_editor/instructions.md b/ta/code_editor/instructions.md
new file mode 100644
index 00000000000..05d308358b5
--- /dev/null
+++ b/ta/code_editor/instructions.md
@@ -0,0 +1,31 @@
+குறியீடு தொகுப்பி (Code editor)கள் பல உண்டு ஆனால் எதை பயன் படுத்துவது என்பது சொந்த விருப்பத்தை பொறுத்தது. பெரும்பாலான Python நிரலாக்குனர்கள்(programmerகள்) சிக்கலான ஆனால் சக்திவாய்ந்த PyCharm போன்ற IDE( (Integrated Development Environment)க்களை பயன்படுத்துகிறார்கள். அது ஒரு துவக்குனராக உங்களுக்கு பொருத்தமற்றதாக இருக்கலாம். ஆனால் எங்களது பரிந்துரைகள் எளிமையான ஆனால் அதற்கு இணையான சக்திவாய்ந்ததாக இருக்கும். 
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ta/css/README.md b/ta/css/README.md
new file mode 100644
index 00000000000..04d5996ae52
--- /dev/null
+++ b/ta/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/ta/deploy/README.md b/ta/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/ta/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/ta/deploy/install_git.md b/ta/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ta/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ta/deploy/signup_pythonanywhere.md b/ta/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/ta/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ta/django/README.md b/ta/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/ta/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/ta/django_admin/README.md b/ta/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/ta/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ta/django_forms/README.md b/ta/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/ta/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/ta/django_installation/README.md b/ta/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/ta/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ta/django_installation/instructions.md b/ta/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/ta/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ta/django_models/README.md b/ta/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/ta/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ta/django_orm/README.md b/ta/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/ta/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ta/django_start_project/README.md b/ta/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/ta/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ta/django_templates/README.md b/ta/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/ta/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ta/django_urls/README.md b/ta/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/ta/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/ta/django_views/README.md b/ta/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/ta/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/ta/dynamic_data_in_templates/README.md b/ta/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/ta/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/ta/extend_your_application/README.md b/ta/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/ta/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/ta/how_the_internet_works/README.md b/ta/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/ta/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ta/html/README.md b/ta/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/ta/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ta/install_git.md b/ta/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/ta/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ta/installation/README.md b/ta/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/ta/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ta/instructions.md b/ta/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/ta/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ta/intro_to_command_line/README.md b/ta/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/ta/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ta/python_installation/README.md b/ta/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/ta/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ta/python_installation/instructions.md b/ta/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/ta/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ta/python_introduction/README.md b/ta/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/ta/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ta/signup_pythonanywhere.md b/ta/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/ta/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/ta/template_extending/README.md b/ta/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/ta/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ta/whats_next/README.md b/ta/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/ta/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/te-IN/GLOSSARY.md b/te-IN/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/te-IN/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/te-IN/README.md b/te-IN/README.md
new file mode 100644
index 00000000000..121da8f55bf
--- /dev/null
+++ b/te-IN/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/te-IN/SUMMARY.md b/te-IN/SUMMARY.md
new file mode 100644
index 00000000000..d9741b4f21c
--- /dev/null
+++ b/te-IN/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/te-IN/chromebook_setup/README.md b/te-IN/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/te-IN/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/te-IN/chromebook_setup/instructions.md b/te-IN/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..2df2048e6ec
--- /dev/null
+++ b/te-IN/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/te-IN/code_editor/README.md b/te-IN/code_editor/README.md
new file mode 100644
index 00000000000..0a401fb1f52
--- /dev/null
+++ b/te-IN/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/te-IN/code_editor/instructions.md b/te-IN/code_editor/instructions.md
new file mode 100644
index 00000000000..82fbac15aad
--- /dev/null
+++ b/te-IN/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/te-IN/css/README.md b/te-IN/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/te-IN/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/te-IN/deploy/README.md b/te-IN/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/te-IN/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/te-IN/deploy/install_git.md b/te-IN/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/te-IN/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/te-IN/deploy/signup_pythonanywhere.md b/te-IN/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/te-IN/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/te-IN/django/README.md b/te-IN/django/README.md
new file mode 100644
index 00000000000..ec91fde6fad
--- /dev/null
+++ b/te-IN/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+జాంగొ ఒక ఉచిత మరియు ఓపెన్ సొర్స్ వెబ్ ఫ్రెమ్ వర్క్ ,జాంగొని పైతాన్ లో వ్రాయడమైనది. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/te-IN/django_admin/README.md b/te-IN/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/te-IN/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/te-IN/django_forms/README.md b/te-IN/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/te-IN/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/te-IN/django_installation/README.md b/te-IN/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/te-IN/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/te-IN/django_installation/instructions.md b/te-IN/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/te-IN/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/te-IN/django_models/README.md b/te-IN/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/te-IN/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/te-IN/django_orm/README.md b/te-IN/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/te-IN/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/te-IN/django_start_project/README.md b/te-IN/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/te-IN/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/te-IN/django_templates/README.md b/te-IN/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/te-IN/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/te-IN/django_urls/README.md b/te-IN/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/te-IN/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/te-IN/django_views/README.md b/te-IN/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/te-IN/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/te-IN/dynamic_data_in_templates/README.md b/te-IN/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/te-IN/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/te-IN/extend_your_application/README.md b/te-IN/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/te-IN/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/te-IN/how_the_internet_works/README.md b/te-IN/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/te-IN/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/te-IN/html/README.md b/te-IN/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/te-IN/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/te-IN/installation/README.md b/te-IN/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/te-IN/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/te-IN/intro_to_command_line/README.md b/te-IN/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/te-IN/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/te-IN/intro_to_command_line/open_instructions.md b/te-IN/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/te-IN/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/te-IN/python_installation/README.md b/te-IN/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/te-IN/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/te-IN/python_installation/instructions.md b/te-IN/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/te-IN/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/te-IN/python_introduction/README.md b/te-IN/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/te-IN/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/te-IN/template_extending/README.md b/te-IN/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/te-IN/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/te-IN/whats_next/README.md b/te-IN/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/te-IN/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/te/GLOSSARY.md b/te/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/te/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/te/README.md b/te/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/te/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/te/SUMMARY.md b/te/SUMMARY.md
new file mode 100644
index 00000000000..7a45700a27d
--- /dev/null
+++ b/te/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/te/chromebook_setup/README.md b/te/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/te/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/te/chromebook_setup/instructions.md b/te/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/te/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/te/code_editor/README.md b/te/code_editor/README.md
new file mode 100644
index 00000000000..404011f1b7d
--- /dev/null
+++ b/te/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/te/code_editor/instructions.md b/te/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/te/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/te/css/README.md b/te/css/README.md
new file mode 100644
index 00000000000..04d5996ae52
--- /dev/null
+++ b/te/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/te/deploy/README.md b/te/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/te/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/te/deploy/install_git.md b/te/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/te/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/te/deploy/signup_pythonanywhere.md b/te/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/te/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/te/django/README.md b/te/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/te/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/te/django_admin/README.md b/te/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/te/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/te/django_forms/README.md b/te/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/te/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/te/django_installation/README.md b/te/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/te/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/te/django_installation/instructions.md b/te/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/te/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/te/django_models/README.md b/te/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/te/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/te/django_orm/README.md b/te/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/te/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/te/django_start_project/README.md b/te/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/te/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/te/django_templates/README.md b/te/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/te/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/te/django_urls/README.md b/te/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/te/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/te/django_views/README.md b/te/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/te/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/te/dynamic_data_in_templates/README.md b/te/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/te/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/te/extend_your_application/README.md b/te/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/te/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/te/how_the_internet_works/README.md b/te/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/te/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/te/html/README.md b/te/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/te/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/te/installation/README.md b/te/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/te/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/te/intro_to_command_line/README.md b/te/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/te/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/te/python_installation/README.md b/te/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/te/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/te/python_installation/instructions.md b/te/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/te/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/te/python_introduction/README.md b/te/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/te/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/te/template_extending/README.md b/te/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/te/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/te/whats_next/README.md b/te/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/te/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/th-TH/GLOSSARY.md b/th-TH/GLOSSARY.md
new file mode 100644
index 00000000000..745a03d1fe9
--- /dev/null
+++ b/th-TH/GLOSSARY.md
@@ -0,0 +1,3 @@
+# โปรแกรมแก้ไขโค้ด
+
+โปรแกรมแก้ไขโค้ด คือ โปรแกรมที่ช่วยให้คุณบันทึกโค้ดของคุณและกลับมาดูในภายหลังได้ คุณสามารถหาโปรแกรมนี้ได้จากบท [โปรแกรมแก้ไขโค้ด](./code_editor/README.md)
\ No newline at end of file
diff --git a/th-TH/README.md b/th-TH/README.md
new file mode 100644
index 00000000000..91a3b74fb2f
--- /dev/null
+++ b/th-TH/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> งานนี้ได้รับการอนุญาตภายใต้อนุญาตสร้างสรรค์คอมมอนส์ครีเอทีฟ 4.0 อินเตอร์เนชั่นแนล สำเนาใบอนุญาต ชม https://creativecommons.org/licenses/by-sa/4.0/thai
+
+## ยินดีต้อนรับ
+
+ยินดีต้อนรับเข้าสู่บทเรียนของ Django Girls! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## บทนำ
+
+คุณเคยรู้สึกไหมว่าโลกเราทุกวันนี้ มีเทคโนโลยีใหม่ๆมากขึ้นทุกวัน จนคุณตามไม่ทัน? และเคยรู้สึกไหมว่า ไม่มีแรงจูงใจที่จะเริ่มสร้างเว็บไซต์? เคยคิดไหมว่า โลกของการทำซอฟต์แวร์ช่างซับซ้อนมากเกินไปสำหรับคุณ หากจะลงมือทำเอง?
+
+เรามีข่าวดีสำหรับคุณ! การเขียนโปรแกรมมันไม่ยากเหมือนอย่างที่คิด และเราจะโชว์ให้ดูถึงความสนุกของมัน
+
+บทเรียนนี้ ไม่ได้ทำให้คุณกลายร่างเป็นโปรแกรมเมอร์ได้ในทันทีทันได้ ถ้าคุณต้องการที่จะเป็นโปรแกรมเมอร์ที่เก่ง คุณต้องการเวลาเพื่อเรียนรู้และฝึกฝน ไม่ว่าจะหลายเดือนหรือหลายปี แต่เราอยากจะแสดงให้คุณดูว่า การเขียนโปรแกรมหรือสร้างเว็บไซต์ไม่ได้ยุ่งยากอะไรขนาดนั้น เราจะพยายามอธิบายให้เข้าใจง่ายที่สุดเท่าที่จะทำได้ เพราะงั้นคุณไม่จำเป็นต้องกลัวอะไรเกี่ยวกับเทคโนโลยีสายนี้
+
+เราหวังว่า จะทำให้คุณหลงรักเทคโนโลยีมากได้เท่าๆ กับที่พวกเรารักมัน!
+
+## คุณจะได้เรียนรู้อะไรบ้างในบทเรียนนี้?
+
+เมื่อคุณเรียนจนจบบทเรียนนี้แล้ว คุณจะสามารถสร้างเว็บแอพลิเคชั่นอย่างง่ายๆ และใช้งานได้จริง นั่นก็คือบล็อกของคุณเอง เราจะแสดงให้คุณดูว่าเราจะอัพโหลดบล็อกของคุณลงบนอินเตอร์เน็ตได้อย่างไร คนอื่นในโลกนี้ก็จะเห็นงานของคุณด้วยไง!
+
+ซึ่งผลลัพธ์จะออกมาประมาณนี้ (อาจจะต่างจากนี้หน่อย แต่ไม่มาก):
+
+![รูปที่ 0.1](images/application.png)
+
+> หากคุณเรียนบทเรียนนี้ด้วยตัวคุณเอง โดยที่ไม่มีใครช่วยคุณ เรามีช่องทางให้คุณผ่านช่องทางสนทนา: !(https://badges. gitter. im/Join Chat. svg)![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg) ซึ่งเราได้ขอให้โค้ชและคนที่เคยผ่านบทเรียนนี้มาช่วยตอบคำถามให้กับคนอื่นที่มาเรียนบทเรียนนี้ด้วย! อย่ากลัวที่จะถามคำถามนะ!</p> </blockquote> 
+> 
+> โอเค, [เรามาเริ่มกันเลยดีกว่า...](./how_the_internet_works/README.md)
+> 
+> ## การทำตามบทเรียนจากที่บ้าน
+> 
+> มันจะสุดยอดมากถ้าได้เป็นส่วนหนึ่งในการประชุมเชิงปฏิบัติการ Django Girls แต่เราตระหนักดีว่า มันไม่เสมอไปที่จะได้เข้าร่วม นี่คือเหตุผลที่เราแนะนำให้คุณลองทำตามบทเรียนนี้ที่บ้าน สำหรับผู้อ่านทางบ้าน ตอนนี้เรากำลังเตรียมวิดีโอที่จะช่วยให้การศึกษาบทเรียนด้วยตัวคุณเองง่ายยิ่งขึ้น มันยังอยู่ในระหว่างการดำเนินการ แต่จะมีการเพิ่มเนื้อหามากขึ้นในเร็วๆนี้ ที่ช่อง [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) บน YouTube
+> 
+> ในบทที่เราครอบคลุมแล้ว จะมีการเชื่อมโยงไปยังวิดิโอที่เกี่ยวข้อง
+> 
+> ## เกี่ยวกับบทเรียนนี้ และ การร่วมพัฒนา
+> 
+> บทเรียนนี้ดูแลโดย [DjangoGirls](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) และบอกเราว่าคุณต้องการให้เราเพิ่มภาษาอะไร
\ No newline at end of file
diff --git a/th-TH/SUMMARY.md b/th-TH/SUMMARY.md
new file mode 100644
index 00000000000..cec7b67aab1
--- /dev/null
+++ b/th-TH/SUMMARY.md
@@ -0,0 +1,35 @@
+# ภาพรวม
+
+* [บทนำ](README.md)
+* [การติดตั้ง](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [การติดตั้ง (chromebook)](chromebook_setup/README.md)
+* [อินเทอร์เน็ตทำงานอย่างไร](how_the_internet_works/README.md)
+* [แนะนำการใช้บรรทัดคำสั่ง](intro_to_command_line/README.md)
+* [การติดตั้ง Python](python_installation/README.md)
+* [Code editor (โปรแกรมแก้ไขโค้ด)](code_editor/README.md)
+* [ความรู้เบื้องต้นเกี่ยวกับ Python](python_introduction/README.md)
+* [Django คืออะไร?](django/README.md)
+* [การติดตั้ง Django](django_installation/README.md)
+* [Django project แรก ของคุณ!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django view - ได้เวลาสร้างแล้ว!](django_views/README.md)
+* [แนะนำให้รู้จัก HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [ข้อมูลแบบ dynamic ใน template](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS - จับแต่งหน้าให้สวยปิ๊ง](css/README.md)
+* [การ extend template](template_extending/README.md)
+* [เพิ่มความสามารถให้เว็บคุณ](extend_your_application/README.md)
+* [Django Form](django_forms/README.md)
+* [หลังจากนี้?](whats_next/README.md)
\ No newline at end of file
diff --git a/th-TH/chromebook_setup/README.md b/th-TH/chromebook_setup/README.md
new file mode 100644
index 00000000000..0257355193b
--- /dev/null
+++ b/th-TH/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# ติดตั้ง Chromebook
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/th-TH/chromebook_setup/instructions.md b/th-TH/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..e7a00893167
--- /dev/null
+++ b/th-TH/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+คุณสามารถ[ข้ามส่วนนี้ไป](http://tutorial.djangogirls.org/en/installation/#install-python)หากคุณไม่ได้ใช้ Chromebook ถ้าหากคุณใช้ การติดตั้งจะแตกต่างกันเล็กน้อย คุณสามารถมองข้ามส่วนที่เหลือของขั้นตอนการติดตั้ง
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### สภาพแวดล้อมเสมือน
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/th-TH/code_editor/README.md b/th-TH/code_editor/README.md
new file mode 100644
index 00000000000..98a401fb50e
--- /dev/null
+++ b/th-TH/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> สำหรับผู้อ่านที่บ้าน: บทนี้ครอบคลุมเรื่องนี้ [วิดีโอการติดตั้ง Python และ Code Editer](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s)
+
+คุณกำลังจะเขียนบรรทัดแรกของ code ดังนั้น ได้เวลาที่จะดาวน์โหลด code editor ซักตัวนึง
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/th-TH/code_editor/instructions.md b/th-TH/code_editor/instructions.md
new file mode 100644
index 00000000000..4107be5aeeb
--- /dev/null
+++ b/th-TH/code_editor/instructions.md
@@ -0,0 +1,37 @@
+ในตอนนี้มีโปรแกรม editor อยู่มากมาย ซึ่งก็ขึ้นอยู่กับความชอบของแต่ละคนว่าชอบโปรแกรมตัวไหน โปรแกรมเมอร์จำนวนมากใช้ IDEs (Integrated Development Environments) ที่ซับซ้อน แต่มีประสิทธิภาพมาก เช่น PyCharm สำหรับมือใหม่นั้น เราขอแนะนำให้ใช้โปรแกรมที่มีประสิทธิภาพเทียบเคียงกัน และใช้งานได้ง่ายกว่ามาก
+
+ด้านล่างนี้คือโปรแกรมที่เราแนะนำ คุณสามารถสอบถามโค้ชของคุณ หรือ โปรแกรมเมอร์คนอื่นๆ ถึงคำแนะนำเกี่ยวกับโปรแกรมเหล่านี้ เพื่อง่ายต่อการทำความเข้าใจโปรแกรมมากยิ่งขึ้น
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[ดาวน์โหลดได้ ที่นี่](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[ดาวน์โหลดได้ ที่นี่](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[ดาวน์โหลดได้ ที่นี่](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/th-TH/css/README.md b/th-TH/css/README.md
new file mode 100644
index 00000000000..1befa5250f9
--- /dev/null
+++ b/th-TH/css/README.md
@@ -0,0 +1,330 @@
+# CSS - จับแต่งหน้าให้สวยปิ๊ง!
+
+อุต๊ะ บล๊อคของเราทำไมดูน่าเกลียดอย่างนี้ ได้เวลาที่จะทำให้มันดีขึ้น เราจะใช้ CSS สำหรับการปรับแต่ง
+
+## อะไรคือ CSS?
+
+Cascading Style Sheets (CSS) เป็นภาษาที่ใช้สำหรับอธิบายลักษณะ และรูปแบบของเว็บไซต์ที่ถูกเขียนในรูปภาษามาร์กอับ (เช่น HTML) อาจจะเรียกมันว่า เป็น make-up สำหรับเว็บไซต์ก็ได้นะ. ;)
+
+แต่เราไม่อยากเริ่มใหม่ตั้งแต่ต้นอีกครั้งใช่ไหม? เราจะใช้สิ่งที่โปรแกรมเมอร์ปล่อยออกมาบนอินเทอร์เน็ตฟรี การสร้างล้อใหม่ไม่สนุกคุณก็รู้
+
+## Bootstrap คือคำตอบ!
+
+Bootstrap เป็นหนึ่งใน frameworks ภาษา HTML และ CSS ที่ได้รับความนิยมอย่างสูงสำหรับการพัฒนาเว็บไซด์ให้สวยงาม: http://getbootstrap.com/
+
+มันถูกเขียนโดยเหล่าโปรแกรมเมอร์ที่เคยทำงานให้กับ Twitter และตอนนี้ได้ถูกพัฒนาต่อโดยอาสาสมัครจากทั่วทุกมุมโลก!
+
+## ติดตั้ง Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![รูปที่ 14.1](images/bootstrap1.png)
+
+ดูดีขึ้นแล้ว!
+
+## Static files ใน Django
+
+ในที่สุดเราก็จะได้ดูสิ่งที่เราเรียกกันว่า **static file** Static files คือ ไฟล์บรรจุ CSS และ รูปภาพต่างๆ ของคุณทั้งหมด Their content doesn't depend on the request context and will be the same for every user.
+
+### แล้วจะเราเก็บไฟล์ static ไว้ที่ไหนสำหรับ Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+เราสามารถทำแบบนั้นได้โดยสร้างโฟลเดอร์ชื่อ `static` ข้างในแอป blog:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django จะค้นหาโฟลเดอร์ชื่อ "static" ในทุกโฟลเดอร์ของแอป โดยอัตโนมัติ แล้วจะใช้ข้อมูลที่อยู่ในตัวของมันเป็น static files ได้
+
+## ไฟล์ CSS แรกของคุณ!
+
+มาสร้างไฟล์ CSS กัน! เพื่อให้หน้าเว็บของคุณสวยปิ๊ง สร้างไดเรกทอรีชื่อ `css` ข้างในไดเรกทอรี `static` ของคุณ จากนั้นสร้างไฟล์ใหม่ชื่อ `blog.css` ข้างในไดเรกทอรี `css` เมื่อสักครู่ พร้อมหรือยัง?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+ได้เวลาเขียน CSS กันแล้ว! เปิดไฟล์ `blog/static/css/blog.css` ด้วยตัวแก้ไขโค้ดของคุณ
+
+ในที่นี้เราจะไม่ลงรายละเอียดไปถึงการปรับแต่งและการเรียนเกี่ยวกับ CSS ที่ลึกมากเกินไป ที่ด้านล่างของเพจนี้จะมีรายละเอียดเกี่ยวกับคอร์ส CSS ฟรี ถ้าคุณต้องการที่จะเรียนรู้เพิ่มเติม
+
+แต่ตอนนี้เราจะลองตกแต่งสักเล็กน้อย Maybe we could change the color of our headers? การจะเข้าใจสีนั้น คอมพิวเตอร์จะใช้รหัสพิเศษ โค้ดเหล่านี้ขึ้นต้นด้วย `#` แล้วตามด้วยตัวอักษร 6 ตัว (A ถึง F) และตัวเลข (0 ถึง 9) ตัวอย่างเช่น โค้ดสำหรับสีฟ้าคือ `#0000FF` คุณสามารถหารหัสสีต่างๆได้จากเว๊บนี้ http://www.colorpicker.com/ คุณอาจใช้ [สีที่กำหนดไว้แล้ว](http://www.w3schools.com/colors/colors_names.asp) เช่น `red` และ `green`.
+
+ในไฟล์ `blog/static/css/blog.css` ของคุณ ควรเพิ่มโค้ดต่อไปนี้ลงไป:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` คือการเลือกโดย CSS This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+ในไฟล์ CSS เราจะกำหนดลักษณะรูปแบบต่างๆ ให้กับองค์ประกอบที่อยู่ในไฟล์ HTML The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. class และ id คือชื่อที่คุณตั้งให้กับองค์ประกอบในหน้าเว็บเอง class กำหนดกลุ่มขององค์ประกอบ และ id ระบุไปยังองค์ประกอบที่จำเพาะเจาะจง For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+คุณสามารถอ่านเพิ่มเติมได้ที่นี่ [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp)
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. ตรงนี้เราบอก tempate ไปว่าจะหาไฟล์ CSS ของเราได้จากที่ไหน
+
+ตอนนี้ ไฟล์ของคุณควรมีหน้าตาแบบนี้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+โอเค บันทึกไฟล์และโหลดหน้าเว็บอีกครั้ง!
+
+![รูปที่ 14.2](images/color2.png)
+
+คุณเก่งมาก! บางทีเราอาจต้องการให้เว็บของเรามีพื้นที่ส่วนขอบด้านซ้ายสักเล็กน้อยไหม? ลองนี่!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+แอดนี่ไปยัง CSS ของคุณ บันทึกไฟล์แล้วดูว่ามันใช้งานได้มั้ย!
+
+![รูปที่ 14.3](images/margin2.png)
+
+บางที เราอยากจะปรับแต่งแบบอักษรในส่วนหัวของเรา? ลองเพิ่มบรรทัดนี้ใน `<head>` ในไฟล์ `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![รูปที่ 14.3](images/font.png)
+
+ดีงาม!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+เราจะเพิ่มส่วนประกาศ ที่จะใช้เลือกในแต่ละบล็อคที่เราได้กำหนด ตัวเลือกที่เริ่มต้นด้วยเครื่องหมายจุด `.` จะใช้กับการเลือก class มีเว็บที่มีบทเรียนดีๆที่สอนและอธิบายเกี่ยวกับ CSS อยู่มากมาย ที่จะช่วยคุณเข้าใจโค้ดด้านล่างนี้ For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+จากนั้นแทนที่โค้ด HTML ที่แสดงโพสต์ของเราด้วยโค้ดที่เราได้ทำกับปรับแต่งหน้าตา:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+ในไฟล์ `blog/templates/blog/post_list.html` ด้วยโค้ดนี้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+บันทึกไฟล์และโหลดหน้าเว็บอีกครั้ง
+
+![รูปที่ 14.4](images/final.png)
+
+วู้ฮู้! มันดูเจ๋งสุดๆเลยใช่มั้ยล่ะ? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. คุณจะเปลี่ยนตรงไหนถ้าคุณอยากจะทำให้วันที่เปลี่ยนเป็นสีฟ้าเทอร์คอยซ์?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. ลองเล่นกับ CSS แล้วมันจะช่วยให้คุณเข้าใจว่าสิ่งต่างๆทำงานยังไง ถ้าคุณทำมันเจ๊ง ก็ไม่ต้องห่วง คุณสามารถใช้คำสั่งย้อนกลับ (undo) ได้!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+พร้อมสำหรับบทต่อไปหรือยัง?! :)
\ No newline at end of file
diff --git a/th-TH/deploy/README.md b/th-TH/deploy/README.md
new file mode 100644
index 00000000000..3faa8651b42
--- /dev/null
+++ b/th-TH/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **หมายเหตุ** บทนี้อาจจะไม่ง่ายนักที่จะผ่านไปได้ ขอให้อดทนและทำให้เสร็จ; deployment เป็นส่วนสำคัญในกระบวนการพัฒนาเว็บไซต์ บทนี้อยู่ในครึ่งทางของบทเรียนทั้งหมด ดังนั้นผู้ช่วยของคุณจะพาคุณนำเว็บไซต์ออนไลน์โดยจะมีขั้นตอนยุ่งยากเล็กน้อย ซึ่งหมายความว่า ถึงคุณมีเวลาไม่พอ ก็จะยังสามารถจบบทนี้ได้แน่นอน
+
+จนถึงตอนนี้คุณสามารถเปิดดูเว็บไซต์ของคุณจากคอมพิวเตอร์ของคุณเท่านั้น Now you will learn how to deploy it! Deploying คือกระบวนการเผยแพร่โปรแกรมของคุณขึ้นสู่อินเทอร์เน็ต สุดท้ายแล้ว ทุกคนก็จะสามารถเห็นเว็บของคุณได. :)
+
+อย่างที่คุณได้ทราบ เว็บไซต์นั้นอาศัยอยู่ในเครื่องเซิร์ฟเวอร์ มันมีผู้ให้บริการเซิร์ฟเวอร์จำนวนมากบนอินเทอร์เน็ต แต่เราจะใช้ [PythonAnywhere](https://www.pythonanywhere.com/) PythonAnywhere นั้นฟรีสำหรับแอปพลิเคชันขนาดเล็กที่มีผู้เข้าชมมีจำนวนไม่มาก ดังนั้นมันจึงเพียงพอสำหรับคุณในตอนนี้
+
+มีบริการภายอื่นที่เราจะใช้เช่นกัน คือ [GitHub](https://www.github.com) ซึ่งเป็นบริการที่เก็บโค้ดของเรา จริงๆ ก็มีบริการจากที่อื่นเช่นกัน แต่โปรแกรมเมอร์เกือบทุกคนในตอนนี้มีบัญชี GitHub และคุณก็กำลังจะมีด้วยเช่นกัน!
+
+These three places will be important to you. เครื่องคอมพิวเตอร์ของคุณจะเป็นที่ที่คุณพัฒนาและทดสอบ เมื่อคุณพอใจกับการเปลี่ยนแปลงแล้ว คุณจะทำสำเนาโปรแกรมของคุณไว้ใน GitHub เว็บไซต์ของคุณจะอยู่ใน PythonAnywhere และคุณจะอัพเดตมันได้ โดยคุณจะได้รับสำเนาของโค้ดของคุณจาก GitHub
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## เริ่มต้นจาก Git repository
+
+Git ติดตามการเปลี่ยนแปลงของไฟล์เป็นชุด โดยเรียกชุดไฟล์เหล่านี้ว่า โค้ด repository (หรือสั้นๆ ว่า "repo") เริ่มจากโครงการของเรา เปิดคอนโซลของคุณ และรันคำสั่งต่อไปนี้ในไดเรกทอรี `djangogirls`:
+
+> **หมายเหตุ** ตรวจสอบไดเรกทอรีปัจจุบันโดยใช้คำสั่ง `pwd` (สำหรับ OSX/Linux) หรือ `cd` (สำหรับ Windows) ก่อนจะเริ่มสร้าง repository คุณควรอยู่ในโฟลเดอร์ `djangogirls`
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+การเริ่มต้น git repository เป็นสิ่งที่เราทำเพียงครั้งเดียวในแต่ละโปรเจค (และคุณไม่จำเป็นต้องป้อน username และ email อีกเลยหลังจากนี้)
+
+Git จะติดตามการเปลี่ยนแปลงในทุกไฟล์และโฟลเดอร์ที่อยู่ภายในไดเรกทอรีนี้ แต่ก็จะมีบางไฟล์ที่เราไม่ต้องการให้ติดตาม สามารถทำได้โดยสร้างไฟล์ชื่อ `.gitignore` ในไดเรกทอรีบนสุด เปิดตัวแก้ไขไฟล์ และสร้างไฟล์ที่มีเนื้อหาดังนี้:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+จากนั้นจึงบันทึกไฟล์โดยใช้ชื่อว่า `.gitignore` ที่อยู่ในโฟลเดอร์ "djangogirls"
+
+> **หมายเหตุ** เครื่องหมายจุดที่อยู่หน้าชื่อไฟล์นั้นสำคัญมาก! ถ้าคุณมีปัญหาในการสร้างไฟล์นี้ (เช่น Mac ไม่ชอบให้คุณสร้างไฟล์ที่เริ่มต้นด้วยเครื่องหมายจุดใน Finder) ดังนั้น คุณควรใช้ "Save As" จากตัวแก้ไขไฟล์แทน And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+ควรใช้คำสั่ง `git status` ก่อนที่จะใช้คำสั่ง `git add` หรือเมื่อใดก็ตามที่คุณไม่แน่ใจว่า มีการเปลี่ยนแปลงอะไรไปบ้าง วิธีนี้จะช่วยให้คุณไม่เจอเหตุการณ์แปลกๆ เช่น คุณเพิ่มไฟล์ผิดไฟล์ หรือยืนยันการบันทึกไฟล์ผิดไฟล์ คำสั่ง `git status` จะบอกข้อมูลเกี่ยวกับสถานะของไฟล์ที่ ไม่ได้ติดตาม/มีการแก้ไข/พร้อมบันทึกการแก้ไข และสถานะอื่นๆ ผลลัพธ์ควรมีหน้าตาเหมือนอย่างด้านล่างนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+และสุดท้าย เราบันทึกการเปลี่ยนแปลง เปิดคอนโซลของคุณและใช้คำสั่ง:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## การส่งโค้ดของเราไปยัง GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+จากนั้นจึงสร้าง repository ใหม่ โดยใช้ชื่อว่า "my-first-blog" ยังไม่ต้องติ๊กที่ "initialise with a README" และไม่ต้องทำอะไรกับตัวเลือก .gitignore (เราทำไปแล้ว) และไม่ต้องแก้ไข License
+
+![](images/new_github_repo.png)
+
+> **หมายเหตุ** ชื่อ `my-first-blog` นั้นสำคัญ - คุณสามารถใช้ชื่ออื่นได้ แต่ชื่อนี้จะปรากฎตลอดทั้งหน้านี้ และคุณจำเป็นต้องเปลี่ยนชื่อตามทุกครั้ง It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+ตอนนี้เราจะทำการชี้ Git repository บนคอมพิวเตอร์ของเราไปยัง GitHub
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+ตอนนี้โค้ดของคุณได้อยู่บน GitHub แล้ว ลองไปดู ว่ามันอยู่บน GitHub แล้วจริงมั้ย! คุณจะเห็นว่ามีบริษัทเจ๋งๆ อย่าง - [Django](https://github.com/django/django), [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial) และโครงการโอเพ่นซอร์สซอฟต์แวร์มากมาย ก็เก็บโค้ดไว้ที่ GitHub :)
+
+# การติดตั้งบล็อกของเราใน PythonAnywhere
+
+## สมัครใช้บัญชี PythonAnywhere
+
+> **หมายเหตุ** คุณอาจจะได้สร้างบัญชีของ PythonAnywhere แล้ว - ถ้าเป็นเช่นนั้น คุณก็ไม่จำเป็นต้องทำมันอีกครั้ง
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## การกำหนดค่าเว็บไซต์ของเราใน PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![ส่วน 'New Console' บน PythonAnywhere เว็บอินเตอร์เฟส กับปุ่มสำหรับ 'bash'](images/pythonanywhere_bash_console.png)
+
+> **หมายเหตุ** PythonAnywhere นั้นใช้ Linux เป็นฐาน หากคุณใช้ Windows คอนโซลที่คุณเห็นจะมีหน้าตาที่ต่างไปจากคอนโซลบนคอมพิวเตอร์ของคุณ
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+ตอนนี้ ถ้าคุณต้องการ คุณยังสามารถดูโค้ดของคุณได้ใน PythonAnywhere โดยใช้ `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## คุณกำลังออนไลน์แล้วนะตอนนี้!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## เคล็ดลับในการ Debugging
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+ถ้าคุณเห็นข้อผิดพลาดเกิดขึ้นเมื่อคุณเข้าดูหน้าเว็บ ที่แรกที่คุณควรตรวจสอบก็คือใน **error log** You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). ลองหาดูว่ามันมีข้อความแสดงข้อผิดพลาดในนั้นมั้ย โดยข้อผิดพลาดล่าสุดจะปรากฎอยู่ด้านล่าง
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+และอย่าลืม โค้ชของคุณอยู่ที่นี่เพื่อมาช่วยคุณนะ!
+
+# มาดูเว๊บไซต์ของคุณกัน!
+
+หน้าเริ่มต้นสำหรับเว็บไซต์ของคุณควรจะโชว์ "It worked!" แบบเดียวกับที่โชว์อยู่บนเครื่องคอมพิวเตอร์ของคุณ ลองเพิ่ม `/admin/` ต่อท้าย URL แล้วคุณจะได้หน้าเพจ admin ของคุณ Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. มันเจ๋งใช่มะ?
+
+ให้รางวัล *ใหญ่* กับตัวคุณเองหน่อย! การนำเว็บขึ้นบนเซิร์ฟเวอร์นั้นเป็นขั้นตอนที่ยุ่งยากในการพัฒนาเว็บไซต์ และคนส่วนมากใช้เวลาสองสามวันกว่าจะทำให้มันทำงานได้ But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/th-TH/deploy/install_git.md b/th-TH/deploy/install_git.md
new file mode 100644
index 00000000000..a800f18a538
--- /dev/null
+++ b/th-TH/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git คือ "version control system" ถูกใช้โดยโปรแกรมเมอร์จำนวนมาก ซอฟต์แวร์นี้สามารถติดตามการเปลี่ยนแปลงของไฟล์ในทุกช่วงเวลาเพื่อให้คุณสามารถย้อนกลับไปยังเวอร์ชันเก่าๆ ได้ในภายหลัง A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## ติดตั้ง Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+คุณสามารถดาวน์โหลด Git ได้จาก [git-scm.com](https://git-scm.com/) You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). นอกเหนือจากนั้น ใช้ค่าเริ่มต้นก็โอเคแล้ว นั่นคือ Checkout Windows-style, commit Unix-style line endings
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/th-TH/deploy/signup_pythonanywhere.md b/th-TH/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..1295ab2c36c
--- /dev/null
+++ b/th-TH/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## การสร้าง PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/th-TH/django/README.md b/th-TH/django/README.md
new file mode 100644
index 00000000000..97648819ee9
--- /dev/null
+++ b/th-TH/django/README.md
@@ -0,0 +1,27 @@
+# Django คืออะไร?
+
+Django (อ่านว่า *แจง-โก้*) เป็น web application framework ที่ฟรีและเป็นโอเพ่นซอร์ส เขียนโดยใช้ภาษา Python มีส่วนประกอบต่างๆ ที่ช่วยให้คุณสามารถพัฒนาเว็บไซต์ได้อย่างรวดเร็วและง่าย
+
+เมื่อคุณสร้างเว็บไซต์, คุณมักจะต้องการส่วนประกอบที่ใช้บ่อยๆ เช่น วิธีจัดการจับผู้ใช้ (สร้างผู้ใช้ใหม่, เข้าระบบ, ออกจากระบบ), ตัวจัดการเว็บไซต์, ฟอร์ม, วิธีอัปโหลดไฟล์ และ อื่นๆ
+
+เป็นโชคดีของคุณ เพราะคนในสมัยก่อนก็เจอปัญหานี้แหละเวลาทำเว็บ เพราะงั้นเค้าเลยรวมตัวกันทำ framework ขึ้นมา (Django ก็เป็นหนึ่งในนั้น) ซึ่งจะมีส่วนประกอบสำเร็จรูปให้เราได้ใช้
+
+Framework มีไว้เพื่อให้คุณไม่ต้องสร้างอะไรที่ซ้ำกับของเดิม และประหยัดเวลาในการทำได้มาก
+
+## ทำไมเราต้องการ framework?
+
+การที่จะเข้าใจว่า Django มีไว้ทำอะไร เราต้องดูในส่วนของ server โดยสิ่งที่ server ทำคือการส่งหน้าเว็บกลับมาให้คุณ
+
+ลองจินตนาการถึงกล่องจดหมาย (พอร์ต) ซึ่งจดหมายที่เข้ามา​ (request) จะถูกตรวจสอบ ซึ่งตรงนี้ เว็บเซิร์ฟเวอร์เป็นคนจัดการ เว็บเซิร์ฟเวอร์อ่านจดหมาย และตอบกลับเป็นหน้าเว็บเพจ แต่ก่อนที่คุณจะส่ง คุณจำเป็นต้องมีเนื้อหาที่จะส่งไปก่อน ซึ่ง Django คือสิ่งที่จะช่วยคุณสร้างเนื้อหา
+
+## เกิดอะไรขึ้นเมื่อมีบางคนร้องขอหน้าเว็บจากเซิร์ฟเวอร์ของคุณ
+
+เมื่อการร้องขอ(request) ถูกส่งมาถึงเว็บเซิร์ฟเวอร์ มันจะถูกส่งต่อมาที่ Django ซึ่ง Django จะพยายามที่จะดูว่าอะไรที่ถูกร้องขอมากันแน่ โดยจะดูจากที่อยู่เว็บที่ร้องขอมาเป็นอันดับแรกและพยายามที่จะดูว่าจะทำอย่างไรกับมันดี งานในส่วนนี้ถูกจัดการโดย **urlresolver** ของ Djagno (หมายเหตุ ที่อยู่เว็บไซต์เรียกว่า URL - Uniform Resource Locator - เพราะงั้นชื่อ *urlresolver* ก็สมเหตุสมผล) จริงๆ มันก็ไม่ใช่วิธีที่ฉลาดหรอกนะ - เพราะมันรับรายการของรูปแบบมา แล้วพยามจะมาจับคู่กับ URL ทีละอัน โดย Django จะตรวจสอบรูปแบบ จากบนลงล่าง หากมีบางอย่างตรงกับรูปแบบที่มี Django จะส่ง request ไปยังฟังก์ชั่นที่รับผิดชอบ (ซึ่งเรียกว่า *view*)
+
+ลองนึกถึงคนส่งจดหมายคนหนึ่ง เขาจะเดินไปตามถนน เช็คดูบ้านเลขที่ของแต่ละบ้านแล้วนำมาเทียบกับที่อยู่บนจดหมาย ถ้าที่อยู่ตรงกัน เขาก็จะหย่อนจดหมายลงไปในตู้จดหมายไว้ให้ นี่คือวิธีที่ urlresolver ทำงานยังไงล่ะ!
+
+ในฟังก์ชั่น *view* ทุกสิ่งเกิดน่าสนใจเกิดขึ้นที่นี่: เราสามารถดูฐานข้อมูลเพื่อหาข้อมูลที่เราต้องการได้ บางทีผู้ใช้ อาจจะอยากเปลี่ยนข้อมูลบางอย่างก็เป็นได้? เช่นเราบอกว่า "เฮ้ย ช่วยเปลี่ยนรายละเอียดเกี่ยวกับงานของฉันให้หน่อยสิ" *view* ที่ว่า จะสามารถเช็คได้ว่าคุณได้รับอนุญาตให้เปลี่ยนมั้ย ถ้าคุณไดรับอนุญาต มันก็จะทำการเปลี่ยนให้คุณและส่งข้อความมาบอกคุณว่า: "เรียบร้อยแล้ว!" หลังจากนั้น *view* จะสร้างการตอบสนองและ Django สามารถส่งข้อมูลนั้นไปยังเว็บเบราเซอร์ของผู้ใช้ได้
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/th-TH/django_admin/README.md b/th-TH/django_admin/README.md
new file mode 100644
index 00000000000..9a21cdb346a
--- /dev/null
+++ b/th-TH/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+การ เพิ่ม, แก้ไข และ ลบโพสต์ที่เราเพิ่งสร้างโมเดลไปนั้น เราจะทำโดยใช้ Django admin
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+อย่างที่คุณเห็น เรามีการ import (รวม) โมเดลโพสต์ที่เราได้ทำในบทที่แล้วมาด้วย การทำให้โมเดลของเราปรากฎในหน้า admin เราต้องทำการลงทะเบียนโมเดลของเรา โดยใช้ `admin.site.register(Post)`.
+
+เอาล่ะ มาดูกันว่าโมเดลโพสต์ของเราหน้าตาเป็นไง อย่าลืมรัน `python manage.py runserver` ในคอนโซลเพื่อเปิดใช้เว็บเซิร์ฟเวอร์ ไปยังเบราว์เซอร์ของคุณ และพิมพ์ http://127.0.0.1:8000/admin/ คุณจะเห็นหน้าเข้าสู่ระบบ แบบนี้:
+
+![หน้าล็อกอิน](images/login_page2.png)
+
+การเข้าสู่ระบบ คุณต้องสร้าง *superuser* - ซึ่งสามารถควบคุมทุกอย่างบนเว็บนี้ได้ กลับไปยัง command line หรือบรรทัดคำสั่ง พิมพ์ `python manage.py createsuperuser` จากนั้นกด enter
+
+> โปรดจำไว้ว่า ในการเขียนคำสั่งใหม่ในขณะที่เว๊บเซอร์เวอร์กำลังรันอยู่นั้น ให้เปิดหน้าต่างเทอร์มินัลใหม่และเปิดใช้งาน virtualenv เราสามารถตรวจสอบวิธีการเขียนคำสั่งใหม่ในบท **โปรเจ็ค Django แรกของคุณ!** ในส่วน ** การเริ่มต้นเว็บเซิร์ฟเวอร์ </ 0></p> </blockquote> 
+> 
+> {% filename %}Mac OS X or Linux:{% endfilename %}
+> 
+>     (myvenv) ~/djangogirls$ python manage.py createsuperuser
+>     
+> 
+> {% filename %}Windows:{% endfilename %}
+> 
+>     (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+>     
+> 
+> เมื่อได้รับแจ้ง ให้พิมพ์ username (ด้วยตัวพิมพ์เล็ก ไม่เว้นช่องว่าง) อีเมล์ และรหัสผ่าน **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. ผมลัพธ์ควรมีหน้าตาแบบนี้ (username และอีเมล์ควรจะเป็นของคุณเอง)
+> 
+>     Username: ola
+>     Email address: ola@example.com
+>     Password:
+>     Password (again):
+>     Superuser created successfully.
+>     
+> 
+> กลับไปยังเบราว์เซอร์ของคุณ เข้าระบบด้วยบัญชีที่คุณเพิ่งสร้างเมื่อสักครู่ คุณก็จะเห็นหน้าแดชบอร์ดของ Django admin แล้วตอนนี้
+> 
+> ![Django admin](images/django_admin3.png)
+> 
+> Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+> 
+> ตรวจสอบให้แน่ใจว่า อย่างน้อยสองหรือสามโพสต์ (แต่ไม่ต้องทั้งหมด) มีการตั้งค่าวันที่เผยแพร่ เราจะใช้ประโยชน์จากส่วนนี้ในภายหลัง
+> 
+> ![Django admin](images/edit_post3.png)
+> 
+> If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+> 
+> ตอนนี้น่าจะเป็นช่วงเวลาจิบกาแฟ (หรือชา) หรือหาอะไรทานเพื่อเพิ่มพลัง คุณได้สร้างโมเดล Django แรกของคุณ - และคุณสมควรที่จะได้พักบ้าง!
\ No newline at end of file
diff --git a/th-TH/django_forms/README.md b/th-TH/django_forms/README.md
new file mode 100644
index 00000000000..2fb0e0dcc76
--- /dev/null
+++ b/th-TH/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Form
+
+สิ่งสุดท้ายที่เราต้องการทำในเว็บไซต์ของเราคือการสร้างส่วนที่เอาไว้แก้ไขบล็อกโพสต์ของเรา หน้า Django `admin` นั้น ก็เจ๋งดีอยู่หรอกนะ แต่ก็ปรับแต่งได้ค่อนข้างยากอยู่เหมือนกัน With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+สิ่งที่ดีอย่างหนึ่งของ Django form คือ เราสามารถเริ่มสร้างจากศูนย์เลย หรือสร้าง `ModelForm` ซึ่งจะบันทึกผลลัพธ์จากฟอร์มไปยังโมเดลของเราทันที
+
+นี่คือสิ่งที่เราต้องการจะทำ: เราจะสร้างฟอร์มจากโมเดล `Post` ของเรา
+
+เช่นเดียวกับทุกส่วนของ Django ฟอร์ม ก็มีไฟล์เป็นของตัวเอง คือ: `forms.py`.
+
+เราต้องสร้างไฟล์นี้ภายในไดเรกทอรี `blog`
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm` ใช่อย่างที่คุณสงสัยนั่นแหละ, มันคือชื่อฟอร์มของเรานั่นเอง เราต้องบอกให้ Django รู้ว่า ฟอร์มของเราคือ `ModelForm` (Django จะร่ายมนต์บางอย่างให้เรา) - `forms.ModelForm` จะเป็นผู้รับผิดชอบดังกล่าว
+
+ถัดมา เรามี `class Meta` ที่ซึ่งเราจะบอก Django ว่าฟอร์มนี้ จะใช้โมเดลอะไร (`model = Post`).
+
+สุดท้าย เราสามารถบอกได้ว่า เราจะใช้ฟิลด์ไหนบ้างในฟอร์มของเรา ในที่นี้ เราจะใช้แค่ `title` และ `text` เท่านั้น - `author` ควรจะเป็นคนที่ตอนนี้ login อยู่ (ก็คุณนั่นแหละ!) และ `created_date` ควรจะถูกกำหนดโดยอัตโนมัติเมื่อเราสร้างโพสต์ (เช่น ในโค้ด) ถูกป่ะ?
+
+และนั่นแหละ! สิ้งที่เราต้องทำทั้งหมดในตอนนี้คือใช้ฟอร์มข้างใน *view* และโชว์มันในเทมเพลต
+
+และเป็นอีกครั้งที่เราจะสร้างลิงค์ไปยังหน้าเพจ, URL, view และ เทมแพลต
+
+## ลิงค์ไปยังหน้าเว็บด้วยฟอร์ม
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## เทมเพลต
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* เราจำเป็นต้องมีปุ่ม `Save` เราสามารถทำได้โดยใช้ HTML button: `<button type="submit">Save</button>`
+* และสุดท้าย หลังจากเปิด tag `<form ...>` เราต้องเพิ่ม `{% raw %}{% csrf_token %}{% endraw %}` ซึ่งส่วนี้สำคัญมาก เพราะมันทำให้ฟอร์มของคุณปลอดภัยขึ้น! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## บันทึกฟอร์ม
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## การแก้ไขฟอร์ม
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## ความปลอดภัย
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## มีอีกอย่างนึง: ได้เวลาเอาขึ้นเซิร์ฟเวอร์!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* อย่างแรก บันทึกโค้ดใหม่ของคุณ และส่งไปเก็บไว้ที่ Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* ต่อมา ในคอนโซล [PythonAnywhere Bash](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/th-TH/django_installation/README.md b/th-TH/django_installation/README.md
new file mode 100644
index 00000000000..e234f351ab4
--- /dev/null
+++ b/th-TH/django_installation/README.md
@@ -0,0 +1,7 @@
+# การติดตั้ง Django
+
+> **หมายเหตุ** ถ้าคุณใช้ Chromebook ให้ข้ามบทนี้ไป และให้แน่ใจว่าคุณทำตามคำแนะนำในการ [ติดตั้ง Chromebook](../chromebook_setup/README.md)
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/th-TH/django_installation/instructions.md b/th-TH/django_installation/instructions.md
new file mode 100644
index 00000000000..9d017985e1f
--- /dev/null
+++ b/th-TH/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> บางส่วนของบทนี้ยึดหลักจากบทเรียนของ Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. บทเรียน django-marcador เป็นลิขสิทธิ์ของ Markus Zapke-Gründemann
+
+## สภาพแวดล้อมเสมือน
+
+ก่อนที่เราจะติดตั้ง Django เราจะให้คุณติดตั้งเครื่องมีที่มีประโยชน์สุดๆ ตัวนึงก่อน ซึ่งช่วยให้คุณมีสภาพแวดล้อมในการทำงานที่ไม่รบกวนระบบหลักของคุณ คุณจะข้ามขั้นตอนนี้ไปก็ได้นะ แต่เราขอแนะนำอย่างแรง การทำสิ่งนี้จะช่วยให้คุณเจอปัญหาน้อยที่สุดภายในอนาคตอันใกล้นี้!
+
+เอาล่ะ มาสร้าง **สภาพแวดล้อมเสมือน** กัน (เรียกว่า *virtualenv*). Virtualenv จะช่วยแยกสภาพแวดล้อมของ Python/Django ออกจากระบบหลัก ซึ่งหมายความว่า ขณะที่คุณกำลังสร้างเว็บไซต์ จะไม่มีผลกระทบกับระบบอื่นๆ ที่กำลังพัฒนาอยู่ เจ๋งใช่ไหมล่ะ?
+
+ทั้งหมดที่คุณต้องการคือ หาไดเรกทอรีที่คุณต้องการจะสร้าง `virtualenv`; เช่น ไดเรกทอรี home เป็นต้น บน Windows จะมีหน้าตาประมาณนี้ `C:\Users\Name` (ซึ่ง `Name` คือชื่อ login ของคุณ)
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+สำหรับบทเรียนนี้ เราจะใช้ไดเรกทอรีใหม่ ชื่อ `djangogirls` ภายในไดเรกทอรี home ของคุณ
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+เราจะสร้าง virtualenv เรียกว่า `myvenv` คำสั่งทั่วไปจะอยู่ในรูปแบบ:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+`myvenv` คือชื่อของ `virtualenv` ของคุณ คุณจะใช้ชื่ออื่นก็ได้นะ แต่ขอแค่ให้ใช้ตัวพิมพ์เล็กและไม่มีช่องว่างหรือใช้อักขระพิเศษ It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+สร้าง `virtualenv` ทั้งใน Linux และ OS X นั้นง่ายมาก แค่รันคำสั่ง `python3 -m venv myvenv` จะมีหน้าตาประมาณนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` คือชื่อ `virtualenv` ของคุณ คุณจะใช้ชื่ออื่นก็ได้นะ แต่ขอแค่ให้ใช้ตัวพิมพ์เล็กและไม่มีช่องว่าง ถ้าจะให้ดีคุณควรที่จะใช้ชื่อสั้นๆ เพราะคุณต้องอ้างถึงมันบ่อยมาก!
+
+> **หมายเหตุ: ** ในบางรุ่นของ Debian/Ubuntu คุณอาจได้รับข้อความที่แสดงข้อผิดพลาดต่อไปนี้:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> การแก้ปัญหา, ให้ใช้คำสั่ง `virtualenv` แทน
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **หมายเหตุ:** ถ้าคุณได้รับข้อผิดพลาดเช่น
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> ให้คุณรันนี่แทน
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## การทำงานกับ virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+เริ่มใช้สภาพแวดล้อมเสมือน โดยใช้คำสั่ง:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/th-TH/django_models/README.md b/th-TH/django_models/README.md
new file mode 100644
index 00000000000..2b290118bfd
--- /dev/null
+++ b/th-TH/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+สิ่งที่เราจะสร้างต่อไปคือ สิ่งที่เราไว้เก็บโพสต์ทั้งหมดในบล็อกของเรา แต่การที่จะทำแบบนั้นเราจะมาทำความรู้จักกับสิ่งหนึ่งที่เรียกว่า `objects`.
+
+## Objects
+
+มีแนวคิดหนึ่งในการเขียนโปรแกรม ที่เรียกว่า `การเขียนโปรแกรมเชิงวัตถุ` The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+แล้ว วัตถุ คืออะไร? มันคือชุดของคุณสมบัติและการกระทำ อาจจะฟังดูแปลกๆ แต่เรากำลังจะอธิบายคุณด้วยตัวอย่างนี้
+
+หากเราต้องการสร้างโมเดล แมว เราจะทำการสร้างวัตถุ `แมว` ซึ่งมีคุณสมบัติต่างๆ เช่น: `สี`, `อายุ`, `อารมณ์` (เช่น อารมณ์ดี, อารมณ์ไม่ดี, ง่วงนอน ;)), และ `เจ้าของ` (ซึ่งก็คือวัตถุ `คน` หรือบางกรณีเช่นแมวจรจัด ก็จะไม่มีเจ้าของ)
+
+นอกจากนี้ `แมว` สามารถกระทำอะไรบางอย่าง: `คราง`, `เกา` หรือ `ให้อาหาร` (ซึ่งเราก็จะให้แมวกิน `อาหารแมว`, อาจจะเป็นวัตถุอื่นที่มีคุณสมบัตต่างๆ เช่น `รสชาติ`).
+
+    แมว
+    --------
+    สี
+    อายุ
+    อารมณ์
+    เจ้าของ
+    คราง()
+    เกา()
+    ให้อาหาร(อาหาร_แมว)
+    
+
+    อาหารแมว
+    --------
+    รสชาติ
+    
+
+ไอเดียนี้ถูกนำไปใช้ในการอธิบายสิ่งต่างๆ ภายในโค้ด ด้วย คุณสมบัติ (เรียกว่า `object properties`) และ การกระทำ (เรียกว่า `methods`).
+
+แล้วเราจะโมเดลโพสของบล็อกเราอย่างไร? เราต้องการสร้างบล็อก ถูกไหม?
+
+เราต้องตอบคำถามเหล่านี้เสียก่อน: บล็อกโพสต์คืออะไร? ควรมีคุณสมบัติอะไรบ้าง?
+
+แน่นอนว่า บล็อกของเราต้องการข้อความ ทั้งเนื้อหาและชื่อเรื่อง จริงไหม? It would be also nice to know who wrote it – so we need an author. สุดท้าย เราต้องการรู้ว่า โพสต์เราถูกสร้างและเผยแพร่เมื่อไหร่
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+มีอะไรบ้างที่เราต้องทำเกี่ยวกับบล็อกโพสต์? มันจะดีถ้าเรามี `method` สำหรับเผยแพร่โพสต์ จริงไหม?
+
+ดังนั้น เราต้องการ method `publish`
+
+ตอนนี้เรารู้แล้วว่าสุดท้ายเราต้องการอะไร เรามาเริ่มโมเดลใน Django กัน!
+
+## Django model
+
+การได้รู้ว่าวัตถุคืออะไรแล้ว เราสามารถสร้าง Django model สำหรับบล็อกโพสต์ของเรา
+
+A model in Django is a special kind of object – it is saved in the `database`. ฐานข้อมูล คือ ชุดของข้อมูล คุณจะเก็บข้อมูลของผู้ใช้ บล็อกโพสต์ของคุณ และอื่นๆ ลงที่นี่ เราจะใช้ฐานข้อมูล SQLite สำหรับเก็บข้อมูลของเรา This is the default Django database adapter – it'll be enough for us right now.
+
+คุณอาจจะคิดได้ว่า โมเดลในฐานข้อมูลคือ ตารางคำนวณที่มี คอลัมน์ (fields) และ แถว (ข้อมูล)
+
+### สร้าง application
+
+เพื่อความเป็นระเบียบเรียบร้อย เราจะสร้าง application ภายใน project ของเรา การจัดระเบียบตั้งแต่เริ่มต้น เป็นสิ่งที่ดีที่ควรทำ การสร้าง application เราต้องรันคำสั่งต่อไปนี้ในคอนโซลของเรา (จากในไดเรกทอรี `djangogirls` ที่มีไฟล์ `manage.py` อยู่ข้างใน):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+คุณจะเห็นไดเรกทอรี `blog` เพิ่มขึ้นมา และด้านในก็มีไฟล์อีกจำนวนหนึ่ง ไดเรกทอรีและไฟล์ใน project ของเรา ควรจะมีหน้าตาประมาณนี้:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+หลังจากที่เราสร้าง application เราต้องบอกให้ Django รู้ด้วยว่าเราจะใช้มัน We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. ผลลัพธ์สุดท้ายของเราหน้าตาควรจะออกมาเป็นแบบนี้:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### สร้างโมเดลของบล็อกโพสต์
+
+ในไฟล์ `blog/models.py` เราจะกำหนดวัตถุทั้งหมด เรียกว่า `Models` - ซึ่งเราจะกำหนดบล็อกโพสต์ของเราไว้ที่นี่
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> ตรวจสอบว่าคุณใช้ขีดล่าง (`_`) สองขีดในแต่ละข้างของ `str` (ซ้ายสองขีด ขวาสองขีด) รูปแบบนี้เป็นรูปแบบสากลในหมู่ผู้ใช้ Python บางทีก็เรียกพวกมันว่า "dunder" (ย่อมาจาก "double-underscore")
+
+ดูน่ากลัวเหมือนกันเนอะ ว่ามั้ย? แต่ไม่ต้องห่วงนะ เราจะอธิบายให้คุณฟังว่าขีดๆพวกนั้นหมายความว่ายังไง!
+
+ทุกบรรทัดที่ขึ้นต้นด้วย `from` หรือ `import` คือการที่เรายืมบางส่วนจากไฟล์อื่นๆมาใช้ ดังนั้น แทนที่เราจะคัดลอกและวางสิ่งเดิมๆให้เหมือนๆกันในทุกๆไฟล์ เราสามารถใส่แค่บางส่วนโดยใช้ `from ... import ...`.
+
+`class Post(models.Model):` - บรรทัดนี้คือการเริ่มสร้างโมเดลของเรา (มันคือ `object` นั่นเอง)
+
+- `class` เป็นคำพิเศษ บ่งบอกว่าเรากำลังจะสร้างวัตถุ
+- `Post` เป็นชื่อโมเดลของเรา ซึ่งสามรถตั้งเป็นชื่ออื่นได้ (แต่เราต้องหลีกเลี่ยงการใช้อักขระพิเศษ และ การเคาะเว้นช่องว่าง) ชื่อ class จะต้องขึ้นต้นด้วยตัวอักษรตัวใหญ่เสมอ
+- `models.Model` บอกเราว่า Post คือ Django Model ดังนั้น Django รู้ว่ามันควรถูกบันทึงลงในฐานข้อมูล
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? ตัวเลข? วันที่? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+เราจะไม่อธิบายทุกส่วนของโค้ดทั้งหมดในที่นี้ เนื่องจากจะใช้เวลานานเกินไป You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+แล้วส่วนนี้ `def publish(self):` คืออะไร? นี่คือเมธอด `publish` ที่เราเคยบอกไปก่อนหน้านี้ไง `def` คือ ฟังก์ชั่น/เมธอด และ `publish` คือชื่อของ method คุณสามารถเปลี่ยนชื่อ method ของคุณได้ ถ้าคุณต้องการ การตั้งชื่อจะมีกฎคือ เราจะใช้ตัวพิมพ์เล็กและใช้ขีดล่าง (_) แทนช่องว่าง เช่น เรามี method สำหรับคำนวณราคาเฉลี่ย เราจะตั้งชื่อว่า `calculate_average_price`
+
+Method ส่วนใหญ่มักจะ `return` บางอย่างออกมา There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+ถ้ายังมีข้อสงสัยเกี่ยวกับโมเดล อย่าลังเลที่จะถามโค้ชของคุณนะ! เรารู้ว่ามันซับซ้อน โดยเฉพาะเมื่อคุณได้เรียนรู้ทั้ง วัตถุและฟังก์ชั่น ในเวลาเดียวกัน But hopefully it looks slightly less magic for you now!
+
+### สร้างตารางสำหรับโมเดลในฐานข้อมูลของคุณ
+
+ขั้นตอนสุดท้ายนี้คือ การเพิ่มโมเดลลงในฐานข้อมูลของเรา ก่อนอื่นเราต้องบอกให้ Django รู้ว่าเรามีการเปลี่ยนแปลงในโมเดลของเรา (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. หน้าตาก็จะประมาณนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+ฮู้เร่! โมเดลโพสต์ของเราอยู่ในฐานข้อมูลแล้ว! อยากเห็นข้อมูลข้างในแล้วใช่มั้ยล่ะ? ไปดูในบทถัดไปกันเลยแล้วคุณจะเห็นว่าโพสต์ขอคุณหน้าตาเป็นยังไง!
\ No newline at end of file
diff --git a/th-TH/django_orm/README.md b/th-TH/django_orm/README.md
new file mode 100644
index 00000000000..458d8805174
--- /dev/null
+++ b/th-TH/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM และ QuerySets
+
+ในบทนี้ คุณจะได้เรียนรู้การเชื่อต่อ Django กับ ฐานข้อมูล และเก็บข้อมูลลงในนั้น เริ่มกันเลย!
+
+## QuerySet คืออะไร?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+ใช้ตัวอย่างจะเห็นภาพกว่า มาลองดูกันเลยไหม?
+
+## Django shell
+
+เปิดคอนโซลบนเครื่องคุณ (ไม่ใช่บน PythonAnywhere) และใช้คำสั่งนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+ผลลัพธ์ควรเป็นดังนี้:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### วัตถุทั้งหมด
+
+ลองแสดงผลของทุกโพสต์กัน คุณสามารถทำได้โดยใช้คำสั่งต่อไปนี้:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+อุ๊ย! เกิดข้อผิดพลาดขึ้นมาล่ะ มันบอกเราว่าไม่มี Post ซึ่งแน่ล่ะ - ก็เราลืม import มันก่อนไง!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+เรา import โมเดล `Post` จาก `blog.models` เรามาลองแสดงโพสต์ทั้งหมดกันดูอีกที:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+มันคือลิสต์ของโพสต์ที่เราได้สร้างไว้ก่อนหน้านี้! เราสร้างโพสต์เหล่านี้จากหน้า Django admin ตอนนี้ เราต้องการสร้างโพสต์ใหม่โดยใช้ Python แล้วเราจะทำมันได้ยังไงล่ะ?
+
+### สร้างวัตถุ
+
+นี่คือวิธีการสร้างวัตถุโพสต์ใหม่ในฐานข้อมูล:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+แต่เราขาดอะไรไปอย่างนึง: `ตัวเรา` เราต้องการส่งวัตถุในโมเดล `User` ให้เป็นผู้เขียน แล้วเราจะทำยังไงล่ะ?
+
+เราต้อง import โมเดล User ก่อน:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+เรามีผู้ใช้อยู่ในฐานข้อมูลไหมนะ? ลองนี่:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+ตอนนี้ เราก็สามารถสร้างโพสต์ของเราได้แล้ว:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+ฮูเร้! มาดูกัน ว่ามีอะไรเพิ่มมาบ้าง?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+มีโพสต์มากกว่าหนึ่งอันแล้ว!
+
+### เพิ่มโพสต์
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### ตัวกรองวัตถุ
+
+ส่วนสำคัญของ QuerySet คือ ความสามารถในการกรองข้อมูล สมมติว่าเราต้องการหาโพสต์ทั้งหมดที่ผู้ใช้มีผู้ใช่ที่ชื่อ ola เป็นคนเขียน เราจะใช้ `filter` แทน `all` ใน `Post.objects.all()` In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. วิธีการเขียนใน Django ก็คือ: `author=me` ตอนนี้ ผลลัพธ์จากการกรองจะเป็นดังนี้:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+หรือบางที เราอยากเห็นโพสต์ทั้งหมดที่มีคำว่า 'title' อยู่ข้างในฟิลด์ `title`?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **หมายเหตุ** มีขีดล่างสองอัน (`_`) ระหว่าง `title` และ `contains` Django ORM นั้นใช้รูปแบบนี้ในการ แยกชื่อฟิลด์ ("title") และตัวดำเนินการหรือตัวกรอง ("contains") ถ้าคุณใช้ขีดล่างแค่อันเดียว คุณจะพบกับข้อผิดพลาด "FieldError: Cannot resolve keyword title_contains"
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+จากนั้น เผยแพร่โพสต์โดยใช้ method `publish` ของเรา:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### จัดเรียงวัตถุ
+
+QuerySet ให้คุณสามารถจัดเรียงรายการของวัตถุได้ มาลองเรียงลำดับตาม `created_date` กัน:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+เรายังสามารถกลับผลการจัดเรียงได้โดยเพิ่ม `-` ไว้ที่ด้านหน้า:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+ตรงนี้มีประโยชน์มากๆ และช่วยให้คุณสร้าง query ที่ซับซ้อนได้
+
+แจ๋ว! คุณพร้อมสำหรับบทถัดไปแล้ว! ปิดคอนโซลโดย:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/th-TH/django_start_project/README.md b/th-TH/django_start_project/README.md
new file mode 100644
index 00000000000..6312fe0423f
--- /dev/null
+++ b/th-TH/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Django project แรก ของคุณ!
+
+> บางส่วนของบทนี้ยึดหลักจากบทเรียนของ Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> บางส่วนของบทนี้ยึดหลักจาก [django-marcador tutorial](http://django-marcador.keimlink.de/) ที่ได้รับอนุญาตภายใต้ Creative Commons Attribution-ShareAlike 4.0 International License บทเรียน django-marcador เป็นลิขสิทธิ์ของ Markus Zapke-Gründemann
+
+เราจะมาสร้างบล็อกแบบง่ายๆ กัน!
+
+ขั้นตอนแรกคือการสร้าง Django project ใหม่ โดยทั่วไปแล้ว เราจะทำการเรียกใช้สคริปต์บางอย่างที่มาพร้อมกับ Django ซึ่งจะทำการสร้างโครงของ project Django ให้กับเรา ซึ่งประกอบไปด้วย ไฟล์และไดเรกทอรีจำนวนหนึ่งที่เราจะใช้ต่อไป
+
+บางชื่อในบางไฟล์และไดเรกทอรีนั้นสำคัญมากๆ สำหรับ Django และคุณไม่ควรเปลี่ยนชื่อไฟล์เหล่านั้น และการย้ายไฟล์เหล่านั้นไปยังที่อื่น ก็ไม่ใช่ความคิดที่ดีแน่ๆ Django นั้นต้องการโครงสร้างที่แน่นอน เพื่อที่จะสามารถหาสิ่งที่จำเป็นที่จะต้องใช้ได้
+
+> อย่าลืมที่จะรันทุกสิ่งอย่างภายใต้ virtualenv If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. เราอธิบายวิธีทำไว้แล้วในบท **การติดตั้ง Django** อยู่ในส่วนของ **การทำงานกับ virtualenv** โดยพิมพ์ `myvenv\Scripts\activate` บน Windows หรือ `source myvenv/bin/activate` บน Mac OS หรือ บน Linux มันจะจัดการให้คุณเอง
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> เครื่องหมายจุด `.` นี้ สำคัญ เพราะเป็นตัวบอกว่าให้ติดตั้ง Django ลงในไดเรกทอรีปัจจุบัน (ใช้เครื่องหมาย `.` เป็นการอ้างอิงถึงไดเรกทอรีปัจจุบันแบบลัด).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> เครื่องหมายจุด `.` นี้ สำคัญ เพราะเป็นตัวบอกว่าให้ติดตั้ง Django ลงในไดเรกทอรีปัจจุบัน (ใช้เครื่องหมาย `.` เป็นการอ้างอิงถึงไดเรกทอรีปัจจุบันแบบลัด).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` เป็นสคริปต์สำหรับสร้างไฟล์และไดเรกทอรีให้กับคุณ และตอนนี้คุณควรจะมีโครงสร้างไฟล์และไดเรกทอรีตามนี้:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+ไฟล์ `settings.py` ประกอบไปด้วยไฟล์ที่กำหนดค่าต่างๆ ในเว็บไซต์ของคุณ
+
+จำเกี่ยวกับคนส่งจดหมายได้ไหม? `urls.py` คือไฟล์ที่มีรายการรูปแบบที่ถูกนำไปใช้ใน `urlresolver`.
+
+ไฟล์อื่นๆ เราไว้ว่ากันทีหลัง สิ่งสำคัญตอนนี้คือ อย่าเผลอไปลบไฟล์พวกนี้เล่นล่ะ!
+
+## เปลี่ยนการตั้งค่า
+
+เรามาแก้ไขไฟล์ `mysite/settings.py` กัน เปิดไฟล์นี้ด้วยโปรแกรมแก้ไขโค้ดที่คุณติดตั้งไว้แล้ว
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+คงจะดีไม่น้อยถ้าเว็บของเรามีการตั้งค่าเวลาที่ถูกต้อง Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## ตั้งค่าฐานข้อมูล
+
+มีซอฟต์แวร์ฐานข้อมูลจำนวนมากที่สามารถเก็บข้อมูลของเว็บคุณได้ เราจะใช้ฐานข้อมูลเริ่มต้น คือ `sqlite3`.
+
+ซึ่งได้ถูกตั้งค่าไว้เรียบร้อยแล้วในไฟล์ `mysite/settings.py` ของคุณ:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+การสร้งฐานข้อมูลสำหรับบล็อกของเรา เริ่มต้นด้วยการใช้คำสั่งต่อไปนี้ในคอนโซล: `python manage.py migrate` (เราจำเป็นต้องอยู่ไดเรกทอรี `djangogirls` ซึ่งมีไฟล์ `manage.py` อยู่ด้านใน) ถ้าทุกอย่างเป็นไปด้วยดี คุณจะเห็นผลคล้ายๆ แบบนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+เป็นอันเสร็จสิ้น! ได้เวลาเปิดเว็บเซิร์ฟเวอร์และดูว่าเว็บเราทำงานไหม!
+
+## การเปิดใช้เว็บเซิร์ฟเวอร์
+
+คุณต้องอยู่ในไดเรกทอรีที่มีไฟล์ `manage.py` (ไดเรกทอรี `djangogirls` นั่นเอง) ในคอนโซล เราสามารถเริ่มต้นเว็บเซิร์ฟเวอร์โดยรันคำสั่ง `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/th-TH/django_templates/README.md b/th-TH/django_templates/README.md
new file mode 100644
index 00000000000..62c8291bf66
--- /dev/null
+++ b/th-TH/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+ได้เวลาแสดงข้อมูลกันบ้างแล้ว! Django นั้นให้เครื่องมือที่ทำงานนี้ได้อย่างสะดวก นั้นคือ **template tags**
+
+## แล้วอะไรคือ template tags?
+
+ใน HTML นั้น คุณไม่สามารถเขียนโค้ด Python ลงไปได้ เพราะเบราว์เซอร์ไม่เข้าใจภาษา Python พวกมันเข้าใจเฉพาะ HTML เรารู้ว่า HTML นั้นข้อมูลจะเป็นแบบ static (คือเป็นเว็บที่มีการแสดงผลได้อย่างเดียว) ขณะที่ Python นั้นจะเป็นแบบ dynamic มากกว่า (คือเป็นเว็บที่มีการตอบโต้ รับส่งข้อมูลระหว่างตัวเว็บกับผู้เข้าชม)
+
+**Django template tags** นั้นทำให้เราสามารถใช้โค้ดที่เหมือนกับ Python ให้เป็น HTML, ดังนั้นคุณสามารถสร้างหน้าเว็บแบบไดนามิกอย่างรวดเร็วและง่ายขึ้น เจ๋งสุดๆ!
+
+## แสดง template รายการโพสต์
+
+ในบทที่แล้ว เราส่งรายการของโพสต์จากในตัวแปร `posts` ไปยัง template และตอนนี้เราจะแสดงรายการโพสต์ออกมาในรูปแบบ HTML
+
+การจะแสดงผลค่าตัวแปรใน Django template เราจะใช้วงเล็บก้ามปูสองอัน ที่มีชื่อตัวแปรอยู่ข้างใน แบบนี้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+ลองแก้ไขไฟล์ template `blog/templates/blog/post_list.html` Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. บันทึกไฟล์และโหลดหน้าเว็บอีกครั้งเพื่อดูผลลัพธ์:
+
+![รูปที่ 13.1](images/step1.png)
+
+อย่างที่คุณเห็น เราได้ผลลัพธ์แบบนี้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+ตรงนี้หมายความว่า Django สามารถเข้าใจและรู้ว่านี่คือรายการวัตถุ ยังจำวิธีที่เราแสดงรายการจากในบท **แนะนำให้รู้จัก Python** ได้ไหม? ใช่แล้ว ใช้การวนลูปไง! ใน Django template เราสามารถทำแบบนี้ได้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+ลองแบบนี้ใน template ของคุณ
+
+![รูปที่ 13.2](images/step2.png)
+
+มันทำงานถูกต้อง! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. คุณสามารถผสมผสานการใช้ HTML กับ template tag ในส่วน `body` จะมีหน้าตาแบบนี้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}ทุกสิ่งที่คุณใส่ไประหว่าง `{% for %}` และ `{% endfor %}` จะถูกทำซ้ำหลายรอบตามจำนวนวัตถุในรายการ โหลดหน้าเว็บอีกครั้ง:{% endraw %}
+
+![รูปที่ 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? เราเข้าถึงแต่ละข้อมูลที่ได้สร้างไว้ในโมเดล `Post` ของเรา Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## ส่วนสุดท้าย
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* จากนั้นไปที่ [PythonAnywhere](https://www.pythonanywhere.com/consoles/) และไปยังส่วน **Bash console** (หรือเปิดอันใหม่) และรันคำสั่ง:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/th-TH/django_urls/README.md b/th-TH/django_urls/README.md
new file mode 100644
index 00000000000..00ff71bfc09
--- /dev/null
+++ b/th-TH/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+เรากำลังจะสร้างหน้าเว็บแรกของเรา: เป็นหน้าแรกสำหรับบล็อกของคุณ! แต่ก่อนอื่น เรามาเรียนเรื่อง Django urls กันซักหน่อย
+
+## URL คืออะไร?
+
+A URL is a web address. คุณเห็น URL ทุกครั้งที่เข้าดูเว็บไซต์ - มันปรากฎอยู่ในช่องที่อยู่ของเบราว์เซอร์ของคุณ (ใช่แล้ว! `127.0.0.1:8000` ก็คือ URL! และ `https://djangogirls.org` ก็คือ URL เช่นกัน)
+
+![URL](images/url.png)
+
+ทุกหน้าเว็บบนอินเทอร์เน็ต ต้องมี URL เป็นของตัวเอง วิธีนี้ทำให้แอปพลิเคชั่นของคุณรู้ว่าควรจะแสดงหน้าไหนให้กับผู้ใช้ที่เปิด URL นั้น ใน Django เราใช้สิ่งที่เรียกว่า `URLconf` (URL configuration) URLconf คือชุดของรูปแบบที่ Django จะพยายามจับคู่ให้ตรงกับ URL ที่ได้รับมาเพื่อหา view ที่ถูกต้อง
+
+## URL ทำงานอย่างไรใน Django?
+
+ลองเปิดไฟล์ `mysite/urls.py` ขึ้นมาและดูว่าข้างในเป็นอย่างไร:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+อย่างที่คุณเห็น Django ได้เตรียมอะไรอะไรไว้ให้เราในที่นี้บ้างแล้ว
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. มันจะไม่ถูกรันโดย Python
+
+Admin URL คือหน้าที่คุณได้เข้าไปชมในบทก่อนหน้า แล้วมันก็อยู่ที่นี่แล้ว:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+บรรทัดนี้หมายความว่า ทุก URL ที่ขึ้นต้นด้วย `admin/` Django จะหา *view* ที่สอดคล้องให้ In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/th-TH/django_views/README.md b/th-TH/django_views/README.md
new file mode 100644
index 00000000000..c550950176c
--- /dev/null
+++ b/th-TH/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+ได้เวลาแก้บั๊กในบทก่อนหน้านี้แล้ว! :)
+
+*view* คือส่วนที่เราใส่ "logic" ของโปรแกรมของเรา โดยจะขอข้อมูลจาก `model` ที่คุณสร้างก่อนหน้านี้และส่งไปยัง `template` เราจะสร้าง template ในบทถัดไป View นั้นเป็นเพียงฟังก์ชั่นใน Python ซึ่งมีความซับซ้อนกว่าที่เราเคยสร้างในบท **ความรู้เบื้องต้นเกี่ยวกับ Python** นิดหน่อย
+
+view จะอยู่ในไฟล์ `views.py` เราจะเพิ่ม *view* ของเราลงในไฟล์ `blog/views.py`
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+บักทึกไฟล์ แล้วไปที่ http://127.0.0.1:8000/ และดูว่าเกิดไรขึ้น
+
+เกิดข้อผิดพลาดอีกแล้ว! ลองอ่านดูว่าเกิดไรขึ้นตอนนี้:
+
+![ข้อผิดพลาด](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? ไม่ต้องกังวลไป มันก็แค่ข้อความที่แสดงถึงข้อผิดพลาด ไม่มีอะไรให้ต้องกลัวเลย! มันก็เหมือนข้อความที่แสดงข้อผิดพลาดในคอนโซล จริงๆแล้วมันมีประโยชน์มากเลยนะ คุณอ่านได้ว่า *TemplateDoesNotExist* งั้นเรามาแก้บั๊คและสร้างเทมเพลตในบทต่อไปกันเลย!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/th-TH/dynamic_data_in_templates/README.md b/th-TH/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..35dcbdd331d
--- /dev/null
+++ b/th-TH/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# ข้อมูลแบบ dynamic ใน template
+
+ตอนนี้ เรามีชิ้นส่วนต่างๆ คือ: โมเดล `Post` ที่กำหนดไว้ในไฟล์ `models.py` มี `post_list` ใน `views.py` และ template แต่เราจะทำยังไงให้โพสต์ของเราปรากฎใน HTML template ของเรา? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+และนี่คือสิ่งที่ *view* จะจัดการ: เชื่อมโมเดลและ template เข้าด้วยกัน In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+ยังจำตอนที่เราคุยกันเกี่ยวกับการนำเข้าโค้ดที่เขียนอยู่ในไฟล์อื่นได้ไหม? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). จากนั้นเราก็นำเข้าชื่อของโมเดล (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+จำไว้ว่าตอนนี้เราได้สร้าง *ตัวแปร* สำหรับ QuerySet ของเรา: นั่นคือ `posts` คิดซะว่าเป็นชื่อ QuerySet ของเรา และเราจะใช้ชื่อนี้ในการอ้างถึงในครั้งหน้า
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. เราต้องตั้งชื่อให้กับค่าเหล่านั้น (เราจะใช้ชื่อ `'posts'` ในตอนน). :) ผลลัพธ์ควรมีหน้าตาแบบนี้: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+สุดท้าย ไฟล์ `blog/views.py` ของเราจะมีหน้าตาแบบนี้:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+เรียบร้อย! ถึงเวลาที่จะกลับไปยัง template ของเรา และแสดงผล QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/th-TH/extend_your_application/README.md b/th-TH/extend_your_application/README.md
new file mode 100644
index 00000000000..f490c241dab
--- /dev/null
+++ b/th-TH/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# เพิ่มความสามารถให้เว็บคุณ
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+ได้เวลาฝึกแล้ว!
+
+สิ่งแรกที่เราต้องการสำหรับบล็อกของเราคือ หน้าเว็บที่จะแสดงโพสต์หนึ่งโพสต์ของเรา ถูกมั้ย?
+
+ซึ่งเรามีโมเดล `Post` แล้ว ดังนั้น เราไม่จำเป็นต้องเพิ่มอะไรลงไปใน `models.py`.
+
+## สร้าง template ที่แสดงหน้ารายละเอียดของโพสต์
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}ได้เวลาอธิบายบรรทัดเหล่านี้แล้ว `{% url 'post_detail' pk=post.pk %}` คุณอาจสงสัยว่าสัญลักษณ์ `{% %}` นี้หมายถึงอะไร มันหมายถึง เรากำลังใช้ template tag ของ Django ตอนนี้เราจะใช้มันเพื่อสร้าง URL ให้กับเรา!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+ตอนนี้ เปิดหน้า: http://127.0.0.1:8000/ เราจะเจอข้อผิดพลาด (ตามที่คาดเอาไว้, เนื่องจากเรายังไม่มี URL หรือ *view* สำหรับ `post_detail`) โดยมีหน้าตาแบบนี้:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## สร้าง URL สำหรับ รายละเอียดโพสต์
+
+สร้าง URL ไฟล์ `urls.py` สำหรับ `post_detail` *view* ของเรา!
+
+เราต้องการให้ละเอียดของโพสต์แรกของเรา แสดงที่นี่ **URL**: http://127.0.0.1:8000/post/1/
+
+เรามาสร้าง URL ในไฟล์ `blog/urls.py` ที่ชี้ให้ Django ไปยัง *view* ที่ใช้ชื่อ `post_detail`, ซึ่งจะแสดงหน้าโพสต์ Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+นั่นหมายถึง ถ้าคุณป้อน `http://127.0.0.1:8000/post/5/` เข้าไปยังเบราว์เซอร์ของคุณ Django จะเข้าใจว่าคุณกำลังมองหา *view* ที่ชื่อว่า `post_detail` และส่งข้อมูลคือ `pk` ซึ่งมีค่าเท่ากับ `5` ไปยัง *view*
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## เพิ่ม view รายละเอียดของโพสต์
+
+ตอนนี้ *view* ของเราจะได้พารามิเตอร์เพิ่มเข้ามาคือ `pk` Our *view* needs to catch it, right? ดังนั้นเราจะสร้างฟังก์ชั่นใหม่ โดยใช้ `def post_detail(request, pk):` Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+ตอนนี้ เราต้องการโพสต์เดียวเท่านั้น เราสามารถทำได้ โดยใช้ queryset แบบนี้:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+แต่โค้ดนี้มีปัญหา ถ้าเกิดว่ามันไม่มี `Post` ตามค่า `primary key` (`pk`) ที่ส่งมา เราจะได้ข้อผิดพลาดหน้าตาน่าเกลียดสุดๆ!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+เราไม่ต้องการแบบนี้! But luckily Django comes with something that will handle that for us: `get_object_or_404`. ในกรณีที่ไม่มี `Post` จากค่า `pk` ที่ส่งไป มันจะแสดงหน้าเว็บที่ดูดีกว่าให้เรา (เรียกว่าหน้า `Page Not Found 404`)
+
+![Page not found](images/404_2.png)
+
+ข่าวดีคือ คุณสามารถสร้างหน้า `Page not found` เป็นของคุณเองได้ และทำให้สวยแค่ไหนก็ได้ตามที่คุณต้องการ แต่ตอนนี้ยังมันไม่จำเป็นเท่าไหร่นัก เราจะขอข้ามไปก่อน
+
+เอาล่ะ ได้เวลาเพิ่ม *view* ไปยังไฟล์ `views.py` ของเราแล้ว!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+ได้เวลาโหลดหน้าเว็บนี้ใหม่: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+ใช้ได้แล้ว! แต่ เกิดอะไรขึ้นเมื่อคุณคลิกที่ลิงค์บนหัวข้อโพสต์?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+โอ้ ไม่นะ! ข้อผิดพลาดอีกอันแล้ว! แต่เรารู้วิธีรับมือปัญหานี้แล้ว ใช่มั้ย? เราต้องเพิ่ม template ยังไงล่ะ!
+
+## สร้าง template ที่แสดงหน้ารายละเอียดของโพสต์
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+เป็นอีกครั้งที่เรา extend ไฟล์ `base.html` ใน block `content` เราต้องการแสดง published_date ของโพสต์ (ถ้ามี), หัวข้อ และ เนื้อหา แต่เราควรจะมาปรึกษากันถึงเรื่องสำคัญอีกอย่างก่อน ดีมั้ย?
+
+{% raw %}`{% if ... %} ... {% endif %}` คือ template tag ที่เราสามารถใช้ เมื่อเราต้องการตรวจสอบบางอย่าง (จำ `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+เอาล่ะ เรามาลองโหลดหน้าเว็บของเราอีกครั้ง ตอนนี้หน้า `Page not found` ควรจะหายไปแล้ว
+
+![Post detail page](images/post_detail2.png)
+
+เย้! ใช้ได้แล้ว!
+
+# ได้เวลา Deploy!
+
+มันคงจะดี ถ้าเราจะดูหน้าเว็บของเราทำงานอยู่บน PythonAnywhere อีกครั้ง ใช่มั้ย? มา deploy กันอีกครั้ง
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+ต่อมา ใน [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/th-TH/how_the_internet_works/README.md b/th-TH/how_the_internet_works/README.md
new file mode 100644
index 00000000000..f9ae5eedc9f
--- /dev/null
+++ b/th-TH/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# อินเทอร์เน็ตทำงานอย่างไร
+
+> สำหรับผู้อ่านทางบ้าน ส่วนนี้จะครอบคลุมในส่วนวิดิโอของ [Python Basics: Dictionaries](https://www.youtube.com/watch?v=oM9yAA09wdc)
+> 
+> บทเรียนนี้ได้แรงบันดาลใจจาก "How the Internet works" โดย Jessica McKellar (http://web.mit.edu/jesstess/www/)
+
+เรารู้ว่าคุณใช้อินเทอร์เน็ตแทบทุกวัน แต่คุณรู้ไหมว่าจริงๆ แล้ว เวลาที่คุณพิมพ์ที่อยู่เว็บ เช่น https://djangogirls.org และกดปุ่ม `enter` มันมีอะไรเกิดขึ้นบ้าง?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. เว็บเบราว์เซอร์ถูกออกแบบมาเพื่อทำความเข้าใจรหัสเหล่านี้ ทำตามคำสั่งและแสดงผลจาไฟล์เว็บไซต์ของคุณ ให้ตรงกับสิ่งที่คุณต้องการ
+
+เช่นเดียวกับไฟล์ทุกไฟล์ เราต้องการเก็บไฟล์ HTML ลงบนฮาร์ดดิสก์ สำหรับอินเทอร์เน็ตนั้น เราใช้เครื่องคอมพิวเตอร์พิเศษ และทรงพลัง เรียก่วา *servers* คอมพิวเตอร์เหล่านี้ ไม่มีหน้าจอ เมาส์ หรือแป้นพิมพ์ เพราะหน้าที่หลักคือการเก็บข้อมูลและให้บริการข้อมูลเหล่านี้ นั่นคือที่มาของชื่อ *servers* เพราะพวกเขา *serve* ข้อมูลให้คุณ
+
+แต่คุณอยากการรู้ว่าอินเทอร์เน็ตหน้าตาเป็นยังไง ใช่มั้ย?
+
+เราวาดรูปมาให้คุณ! และมันหน้าตาแบบนี้:
+
+![รูปที่ 1.1](images/internet_1.png)
+
+ดูยุ่งเหยิง ไม่เป็นระเบียบ ใช่ไหม? จริงๆ มันคือเครือข่ายที่เชื่อมต่อเครื่องต่างๆ เข้าด้วยกัน (เครื่องที่ว่าก็คือ *servers* นั่นเอง) นับแสนเครื่อง! สายเคเบิ้ลไกลหลายกิโลเมตรทั่วโลก! คุณสามารถไปชมแผนที่เคเบิ้ลใต้น้ำได้ที่ (http://submarinecablemap.com) เพื่อดูว่าซับซ้อนขนาดไหน นี่เป็นภาพตัวตัวอย่างจากเว็บข้างต้น:
+
+![รูปที่ 1.2](images/internet_3.png)
+
+น่าสนใจใช่ไหม? But it is not possible to have a wire between every machine connected to the Internet. ดังนั้น การเข้าถึงเครื่อง (ตัวอย่างเช่นเครื่องที่เก็บเว็บ https://djangogirls.org ไว้) เราจำเป็นต้องผ่านการ ร้องขอ จำนวนมาก และผ่านหลายเครื่อง
+
+หน้าตาประมาณนี้:
+
+![รูปที่ 1.3](images/internet_2.png)
+
+ลองนึกภาพว่า เมื่อคุณพิมพ์ http://djangogirls.org เป็นการส่งจดหมายเพื่อบอกว่า: "เฮ้ Django Girls เราอยากดูหน้าเว็บ djangogirls.org จัง ได้โปรดช่วยส่งมันมาให้ฉันดูหน่อย!"
+
+จดหมายของคุณส่งไปยังที่ไปรษณีย์ใกล้บ้านคุณ และมันก็ถูกส่งต่อไปยังที่อื่นที่อยู่ห่างบ้านคุณไปนิดหน่อย และส่งไปเรื่อยๆ ไปเรื่อยๆ จนกระทั่งถึงปลายทาง สิ่งที่เป็นเอกลักษณ์คือ ถ้าคุณส่งจดหมายจำนวนมาก (*data packets*) ไปยังที่เดิม จดหมายเหล่านั้นจะถูกส่งต่อไปยังไปรษณีย์อื่นๆ (*routers*) ที่แตกต่างกันโดยสิ้นเชิง ขึ้นกับว่าพวกเขากระจายแต่ละสำนักงานยังไง
+
+![รูป 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+แทนที่จะเป็นที่อยู่ ชื่อถนน ชื่อเมือง รหัสไปรษณีย์และชื่อประเทศ เราจะใช้ที่อยู่ IP แทน เครื่องคอมของคุณจะถามไปยัง DNS (Domain Name System) ที่จะแปลงชื่อ djangogirls.org ไปเป็นที่อยู่ IP ก่อน มันทำงานคล้ายๆ กับสมุดโทรศัพท์สมัยก่อน ซึ่งคุณสามารถหาเบอร์โทรศัพท์และที่อยู่จากชื่อที่อยู่ในสมุดโทรศัพท์ได้
+
+เมื่อคุณต้องการส่งจดหมาย คุณต้องใช้สิ่งอื่นร่วมด้วยเพื่อให้การส่งถูกต้อง: คือ ที่อยู่ สแตมป์ ฯลฯ คุณใช้ภาษาที่ผู้รับจดหมายเข้าใจด้วย ถูกมั้ย? เช่นเดียวกันกับ *data packets* ที่ส่งไปเพื่อขอดูเว็บไซต์ เราใช้กระบวนการหรือ protocol ที่เรียกว่า HTTP (Hypertext Transfer Protocol)
+
+ดังนั้น โดยทั่วไป หากคุณมีเว็บไซต์ คุณต้องมี *server* (เครื่อง) ที่เก็บเว็บไซต์ เมื่อ *server* ได้รับ *request* เข้ามา (มีจดหมายส่งมา) มันจะส่งเว็บไซต์กลับไป (จดหมายตอบกลับ)
+
+คุณคงสงสัย นี่คือบทเรียน Django แล้ว Django ทำอะไรบ้าง เมื่อคุณต้องการตอบกลับ คุณไม่จำเป็นต้องส่งข้อมูลที่เหมือนๆ กัน ไปยังทุกคน มันจะดีกว่ามาก ถ้าจดหมายของคุณนั้นส่งไปในรูปแบบส่วนบุคคล โดยเฉพาะอย่างยิ่งสำหรับคุณที่เขียนถึงคุณ ถูกไหม? Django ช่วยคุณสร้างสิ่งเหล่านั้น ทำให้เป็นจดหมายที่น่าสนใจยิ่ง. :)
+
+เอาล่ะพูดเยอะแล้ว เรามาเริ่มทำกันเลยดีกว่า!
\ No newline at end of file
diff --git a/th-TH/html/README.md b/th-TH/html/README.md
new file mode 100644
index 00000000000..560741dfd54
--- /dev/null
+++ b/th-TH/html/README.md
@@ -0,0 +1,227 @@
+# ความรู้เบื้องต้นเกี่ยวกับ HTML
+
+คุณอาจจะสงสัยว่าเทมเพลต (template) คืออะไร?
+
+Template คือ ไฟล์ที่เราจะสามารถนำมาใช้นำเสนอข้อมูลที่แตกต่างกันออกไป - ตัวอย่างเช่น คุณอาจจะใช้ template สำหรับช่วยเขียนจดหมาย เพราะแต่ละฉบับมีข้อความและที่อยู่ต่างกันไปในแต่ละคน แต่ใช้รูปแบบเดียวกัน
+
+รูปแบบ template ของ Django จะถูกอธิบายโดยใช้ภาษาที่เรียกว่า HTML (เป็น HTML อันเดียวกับที่เราได้เกริ่นไว้ตอนต้นของบท **อินเทอร์เน็ตทำงานอย่างไร**)
+
+## HTML คืออะไร?
+
+HTML เป็นโค้ดง่ายๆ ที่ถูกใช้โดยเว็บเบราว์เซอร์ - เช่น Chrome, Firefox หรือ Safari - เพื่อแสดงผลหน้าเว็บให้กับผู้ใช้
+
+HTML ย่อมาจาก "HyperText Markup Language" **HyperText** หมายถึง เป็นชนิดของข้อความที่มีการเชื่อมโยงไปหน้าเว็บอื่นๆ ได้ **Markup** หมายถึง เราทำเครื่องหมายสักอย่างไว้ที่เอกสารด้วยโค้ดเพื่อทำบางอย่าง (ในที่นี้ เบราว์เซอร์) หรือวิธีการแปลงหน้าเพจ HTML โค้ด สร้างขึ้นจาก **tag** แต่ละ tag เริ่มต้นด้วย `<` และลงท้ายด้วย `>` tag เหล่านี้ถูกทำเครื่องหมายว่าเป็น **element**.
+
+## template แรกของคุณ!
+
+การสร้าง template ที่ว่า คือการสร้างไฟล์ template ทุกอย่างล้วนคือไฟล์ ถูกไหม? คุณคงสังเกตเห็นแล้ว
+
+template ทั้งหลายนั้นถูกบันทึกไว้ที่ไดเรกทอรี `blog/templates/blog` ดังนั้น เราจะสร้างไดเรกทอรีชื่อ `templates` ข้างในไดเรกทอรี blog ของคุณ จากนั้นสร้างไดเรกทอรีเพิ่ม ชื่อ `blog` ข้างในไดเรกทอรี template เมื่อครู่:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+ตอนนี้ให้สร้างไฟล์ `post_list.html` (ยังไม่ต้องมีอะไรข้างใน) ข้างในไดเรกทอรี `blog/templates/blog`
+
+มาดูกันว่าตอนนี้เว็บเราแสดงผลยังไง: http://127.0.0.1:8000/
+
+> ถ้าคุณยังเจอข้อผิดพลาด `TemplateDoesNotExists` ให้ลองปิดและเปิดเซิร์ฟเวอร์อีกครั้ง โดยเปิดบรรทัดคำสั่ง หยุดการทำงานของเซิร์ฟเวอร์โดยใช้คีย์ Ctrl+C (ปุ่ม Control และ C พร้อมกัน) และเริ่มอีกครั้งโดยใช้คำสั่ง `python manage.py runserver`
+
+![รูปที่ 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+แล้วหน้าเว็บคุณตอนนี้เป็นไงนะ? ไปยังหน้านี้ซิ: http://127.0.0.1:8000/
+
+![รูปที่ 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body (หัวและเนื้อหา)
+
+ในแต่หน้า HTML ถูกแบ่งเป็นสองส่วน: **head** และ **body**.
+
+* **head** คือส่วนของข้อมูลต่างๆ ที่เกี่ยวกับเอกสาร แต่ไม่ปรากฎหรือแสดงผลบนหน้าจอ
+
+* **body** คือส่วนที่เหลือทั้งหมดที่แสดงผลอยู่บนหน้าเว็บเพจ
+
+เราใช้ `<head>` เพื่อบอกเบราว์เซอร์เกี่ยวกับการกำหนดค่าต่างๆ ของหน้าเพจ และ `<body>` บอกเกี่ยวกับเนื้อหาบนหน้าเว็บจริงๆ
+
+ตัวอย่างเช่น คุณสามารถใส่ title อยู่ภายใน tag `<head>` แบบนี้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+บันทึกไฟล์และโหลดหน้าเว็บอีกครั้ง
+
+![รูปที่ 11.3](images/step4.png)
+
+สังเกตดูว่า เบราว์เซอร์เข้าใจว่า "Ola's blog" นั้คือ title ของหน้าเว็บคุณไหม? เบราว์เซอร์ ได้ทำการแปล `<title>Ola's blog</title>` และแทนที่ข้อความบนแถบ title บนเบราว์เซอร์คุณ (และถูกใช้เมื่อเราทำที่คั่นหน้าด้วยเช่นกัน)
+
+บางทีคุณจะสังเกตเห็นเช่นกันว่าแต่ละ tag ที่เปิดนั้นจะมีการ *ปิด tag* โดยใช้ `/` แต่ละองค์กระกอบจะอยู่ *ข้างใน* (เช่น ไม่สามารถปิด tag ได้จนกว่า ทุก tag ที่อยู่ข้างในมันเองจะยังไม่ได้ปิด)
+
+เหมือนกับการใส่สิ่งของลงในกล่อง คุณมีหนึ่งกล่องใหญ่ `<html></html>`; ข้างในนั้นคือ `<body></body>` และมีกล่องเล็กๆ อยู่ข้างใน: `<p></p>`.
+
+คุณต้องทำตามกฎในการ *ปิด* tag และการ *ซ้อนกัน* ของแต่ละองค์ประกอบ - ไม่เช่นนั้น เบราว์เซอร์อาจไม่สามารถแสดงผลได้อย่างถูกต้อง
+
+## ปรับแต่ง template ของคุณ
+
+ตอนนี้คุณจะได้สนุกกับการปรับแต่งและลองแก้นิดๆ หน่อยๆ ใน template ของคุณ! และนี่คือ tag ที่น่าสนใจที่จะลองเล่น:
+
+* `<h1>A heading</h1>` สำหรับหัวเรื่องที่สำคัญที่สุด
+* `<h2>A sub-heading</h2>` สำหรับหัวเรื่องระดับถัดมา
+* `<h3>A sub-sub-heading</h3>` ... และไปจนถึง `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` เน้นข้อความของคุณ
+* `<strong>text</strong>` ทำให้ข้อความที่เน้นหนาขึ้น
+* `<br>` ขึ้นบรรทัดใหม่ (คุณไม่สามารถใส่อะไรลงใน br ได้)
+* `<a href="https://djangogirls.org">link</a>` สร้างการเชื่อมโยง
+* `<ul><li>first item</li><li>second item</li></ul>` สร้างรายการ เหมือนเช่นอันนี้!
+* `<div></div>` สร้างส่วนของหน้าเพจ
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+และนี่ก็คือตัวอย่างของ template ตัวเต็ม บันทึกและวางมันลงใน `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+โดยจะทำให้มีผลแบบนี้:
+
+![รูปที่ 11.4](images/step6.png)
+
+เย้! แต่ตอนนี้ template แสดงผลโดยใช้ **ข้อมูลเดิม** ในขณะที่ก่อนหน้านี้ เราพูดถึง template ที่แสดงผลข้อมูล **ต่างกันออกไป** แต่อยู่ใน **รูปแบบเดียวกัน**.
+
+สิ่งที่เราต้องการคือ แสดงโพสต์ที่เราได้เพิ่มในหน้า Django admin - และนั่นคือสิ่งที่เราจะทำต่อไป
+
+## มีอีกอย่างนึง: deploy!
+
+เราทำให้ไปโผล่บนอินเทอร์เน็ตน่าจะดี ว่าไหม? เรามา deploy บน PythonAnywhere อีกกัน
+
+### Commit และ push โค้ดของคุณไปยัง Github
+
+ก่อนอื่น มาดูกันว่าไฟล์ไหนถูกเปลี่ยนแปลงไปบ้างจากครั้งล่าสุด (ใช้คำสั่งต่อไปนี้บนเครื่องคุณเอง ไม่ใช่บน PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+ตรวจสอบว่าอยู่ในไดเรกทอรี `djangogirls` หรือไม่ และใช้ `git` ในการรวมทุกไฟล์ที่เราแก้ไขภายในไดเรกทอรีเข้ามาด้วย:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+ก่อนเราละอัปโหลดไฟล์ทั้งหมด ตรวจสอบดูว่า `git` จะอัปไฟล์ไหนไป (ไฟล์ที่ `git` จะอัปโหลดจะเป็นตัวอักษรสีเขียว):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+เราเกือบเสร็จแล้ว ตอนนี้ถึงเวลาที่จะบันทึกการเปลี่ยนแปลงนี้แล้ว เรากำลังจะ "เขียนข้อความบันทึก" ซึ่งอธิบายสิ่งที่เราเปลี่ยนแปลงไป คุณสามารถพิมพ์อะไรก็ได้ตามที่ต้องการ แต่มันจะช่วยได้มาก หากเราอธิบายให้ตัวคุณเองจำสิ่งที่คุณทำลงไปได้ ในอนาคต
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+เมื่อเสร็จแล้ว เราจะทำการอัปโหลด (push) การเปลี่ยนแปลงไปที่ Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### ดึงโค้ดล่าสุดของคุณมาที่ PythonAnywhere และโหลดเว็บของคุณอีกครั้ง
+
+* เปิด [หน้าคอนโซล PythonAnywhere](https://www.pythonanywhere.com/consoles/) และไปยัง **Bash console** ของคุณ (หรือเริ่มอันใหม่) จากนั้นใช้คำสั่ง:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+เว็บที่ปรับปรุงใหม่ควรจะโชว์บนอินเตอร์เน็ตแล้ว! ลองโหลดหน้าบนเบราว์เซอร์ของคุณ คุณน่าจะได้เห็นความเปลี่ยนแปลงแล้วล่ะ :)
\ No newline at end of file
diff --git a/th-TH/installation/README.md b/th-TH/installation/README.md
new file mode 100644
index 00000000000..d29b3353075
--- /dev/null
+++ b/th-TH/installation/README.md
@@ -0,0 +1,68 @@
+# หากคุณเรียนบทเรียนนี้ที่บ้าน
+
+หากคุณเรียนบทเรียนนี้ที่บ้าน และไม่ใช่ [Django Girls events](https://djangogirls.org/events/) คุณสามารถข้ามบทนี้ และเริ่มบทถัดไป คือ [อินเทอร์เน็ตทำงานอย่างไร?](../how_the_internet_works/README.md) ได้เลย
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/th-TH/intro_to_command_line/README.md b/th-TH/intro_to_command_line/README.md
new file mode 100644
index 00000000000..d98acc375fb
--- /dev/null
+++ b/th-TH/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# ความรู้เบื้องต้นเกี่ยวกับ command-line interface
+
+> สำหรับผู้อ่านทางบ้าน ส่วนนี้จะครอบคลุมในส่วนวิดิโอของ [Python Basics: Dictionaries](https://www.youtube.com/watch?v=jvZLWhkzX-8)
+
+มันน่าตื่นเต้นใช่มั้ยล้าาา?! คุณจะได้เริ่มเขียนโค้ดบรรทัดแรกของคุณในอีกไม่กี่นาทีนี้แล้ว! :)
+
+**เราขอแนะนำให้รู้จักเพื่อนใหม่ของคุณ: command line หรือ บรรทัดคำสั่ง!**
+
+จากนี้ไปเราจะแนะนำการใช้หน้าต่างสีดำเหมือนกับที่แฮกเกอร์ใช้ มันอาจจะดูน่ากลัวซักหน่อยในตอนแรก แต่มันก็แค่สิ่งที่รอรับคำสั่งจากคุณเท่านั้นเอง
+
+> **หมายเหตุ** ตลอดบทเรียนในหนังสือเล่มนี้ เราจะใช้คำว่า 'directory' และ 'folder' ผสมๆ กัน แต่มันก็คือสิ่งเดียวกันนั่นแหละ
+
+## Command line (บรรทัดคำสั่ง) คืออะไร?
+
+หน้าต่างที่เรียกว่า **command line** หรือ **command-line interface** คือโปรแกรมสำหรับดู จัดการ และแก้ไขไฟล์ต่างๆ ที่อยู่ในเครื่องของคุณ แต่จะอยู่ในรูปแบบที่เป็นโหมดข้อความเท่านั้น มันก็คล้ายๆกับ Windows Explorer หรือ Finder บน Mac เพียงแต่มัน graphical interface แค่นั้นแหละ Command line หรือ บรรทัดคำส่ังมีชื่อเรียกอื่นๆด้วย อย่างเช่น *cmd*, *CLI*, *prompt*, *console* หรือ *terminal*
+
+## การเปิด command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## คำสั่งแรกของคุณ (เย้!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## พื้นฐาน
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### ไดเรกทอรีปัจจุบัน
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### เฉลย:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## ภาพรวม
+
+Here is a summary of some useful commands:
+
+| คำสั่ง (วินโดวส์) | คำสั่ง (Mac OS / ลินุกซ์) | คำอธิบาย                | ตัวอย่างการใช้คำส่ัง                               |
+| ----------------- | ------------------------- | ----------------------- | -------------------------------------------------- |
+| exit              | exit                      | ปิดหน้าต่าง             | **exit**                                           |
+| cd                | cd                        | เปลี่ยนไดเรกทอรี        | **cd test**                                        |
+| cd                | pwd                       | แสดงผลไดเรกทอรีปัจจุบัน | **cd** (Windows) หรือ **pwd** (Mac OS / Linux)     |
+| dir               | ls                        | ดูรายการไดเรกทอรี/ไฟล์  | **dir**                                            |
+| copy              | cp                        | คัดลอกไฟล์              | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                        | ย้ายไฟล์                | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                     | สร้างไดเรกทอรีใหม่      | **mkdir testdirectory**                            |
+| rmdir (หรือ del)  | rm                        | ลบไฟล์                  | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                     | ลบไดเรกทอรี             | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                 | get help for a command  | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## พร้อมหรือยัง?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/th-TH/intro_to_command_line/open_instructions.md b/th-TH/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/th-TH/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/th-TH/python_installation/README.md b/th-TH/python_installation/README.md
new file mode 100644
index 00000000000..47d80b83332
--- /dev/null
+++ b/th-TH/python_installation/README.md
@@ -0,0 +1,15 @@
+# เริ่มต้นด้วย Python
+
+ในที่สุด เราก็มาถึงจุดนี้!
+
+ขอเราเล่าก่อนละกันว่า Python คืออะไร Python นั้นคือภาษาการโปรแกรมที่ได้รับความนิยมอย่างมาก สามารถนำไปสร้างซอฟต์แวร์ต่างๆ ได้มากมายเช่น เว็บไซต์ เกม ซอฟต์แวร์ด้านวิทยาศาสตร์ กราฟิก และอื่นๆ อีกมากมาย
+
+ภาษา Python กำเนิดขึ้นช่วงปลาย 1980 และเป้าหมายหลักของภาษาคือ มนุษย์อย่างเราๆ สามารถอ่านได้ง่าย (ไม่เพียงเฉพาะเครื่องเท่านั้น) นั่นเป็นเหตุผลว่าทำไมมันถึงได้ดูง่ายกว่าภาษาโปรแกรมอื่นๆ แต่ก็ไม่ต้องกังวลไป Python นั้นมีประสิทธิภาพสูงมาก
+
+# การติดตั้ง Python
+
+> **หมายเหตุ** ถ้าคุณใช้ Chromebook ข้ามบทนี้ และแน่ใจว่าคุณทำตามบทแนะนำ [ติดตั้ง Chromebook](../chromebook_setup/README.md)
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/th-TH/python_installation/instructions.md b/th-TH/python_installation/instructions.md
new file mode 100644
index 00000000000..6e8b575e65b
--- /dev/null
+++ b/th-TH/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> สำหรับผู้อ่านทางบ้าน: บทนี้ครอบคลุมวิดีโอในส่วนของ [การติดตั้ง Python และ Code Editer](https://www.youtube.com/watch?v=pVTaqzKZCdA)
+> 
+> ในส่วนของบทนี้ อ้างอิงมาจากบทเรียนของ Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/th-TH/python_introduction/README.md b/th-TH/python_introduction/README.md
new file mode 100644
index 00000000000..e82a7740910
--- /dev/null
+++ b/th-TH/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# ความรู้เบื้องต้นเกี่ยวกับ Python
+
+> บางส่วนของบทนี้ยึดหลักจากบทเรียนของ Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+มาเริ่มเขียนโค้ดกันเถอะ!
+
+## Python prompt
+
+> สำหรับผู้อ่านทางบ้าน ส่วนนี้จะครอบคลุมในส่วนวิดิโอของ [Python Basics: Integers, Strings, Lists, Variables และ Errors](https://www.youtube.com/watch?v=MO63L4s-20U)
+
+ก่อนที่เราจะเริ่มใช้งาน Python เราจะต้องเปิด *command line* บนคอมพิวเตอร์ของคุณซะก่อน คุณควรที่จะรู้ว่าคุณต้องทำยังไง คุณเรียนมันไปแล้วในบท [Intro to Command Line](../intro_to_command_line/README.md)
+
+เมื่อคุณพร้อม ก็เริ่มทำตามขั้นตอนด้านล่างนี้ได้เลย
+
+เราต้องการเปิดคอนโซล Python ฉะนั้นพิมพ์ `python` บนระบบปฏิบัติการ Windows หรือ `python3` บน ระบบปฏิบัติการ Mac OS/Linux แล้วกด `enter`
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## คำสั่ง Python แรกของคุณ!
+
+หลังจากที่เรารันคำสั่ง Python ข้อความพร้อมรับก็จะเปลี่ยนเป็น `>>>`. สำหรับเรา นั่นหมายถึงตอนนี้เราสามารถที่จะใช้คำสั่งในภาษา Python ได้เพียงอย่างเดียวเท่านั้น คุณไม่ต้องพิมพ์ `>>>` Python จะทำให้คุณเอง
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. หลังจากนั้นคุณจะไม่เห็น `>>>` อีกต่อไป
+
+สำหรับตอนนี้ เราไม่อยากออกไปจากส่วนควบคุม Python เรายังอยากเรียนเพิ่มเติ่มเกี่ยวกับ Python งั้นเรามาเริ่มจากการพิมพ์คำสั่งเกี่ยวกับคณิตศาสตร์ อย่างเช่น `2 + 3` แล้วกด `enter`
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+หูยยยดีอ่ะ! เห็นคำตอบที่โผล่ขึ้นมามั้ย? Python คำนวณได้ด้วย! คุณสามารถลองคำสั่งอื่นๆอย่าง:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+ในการคำนวณเลขยกกำลัง เช่น 2 ยกกำลัง 3 เราก็พิมพ์: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+ลองสนุกกับมันซักหน่อย แล้วกลับมาที่นี่นะ :)
+
+อย่างที่คุณเห็น Python เป็นเครื่องคิดเลขที่เยี่ยมมาก ถ้าคุณอยากรู้ว่าคุณสามารถทำอะไรกับมันได้อีก...
+
+## String
+
+ชื่อคุณเป็นไง? ลองพิมพ์ชื่อของคุณในเครื่องหมายคำพูดหรืออัญประกาศ แบบนี้:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+คุณเพิ่งสร้าง string แรกของคุณ! String เป็นลำดับของตัวอักษรหลายๆตัวเรียงต่อกันที่สามารถประมวลผลได้โดยคอมพิวเตอร์ String นั้นต้องอยู่ในเครื่องหมายคำพูดหรืออัญประกาศเสมอ มันอาจจะเป็นอัญประกาศเดี่ยว (`'`) หรืออัญประกาศคู่ (`"`) (ซึ่งเราสามารถใช้ได้ทั้งคู่!) เครื่องหมายคำพูดหรืออัญประกาศเหล่านี้จะบอก Python ว่าข้างในนั้นคือ string
+
+เราสามารถนำ String มารวมกันได้ ลองนี่:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+นอกจากนี้ คุณยังสามารถคูณจำนวน string ได้อีกด้วย:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+ถ้าคุณต้องการใส่เครื่องหมายวรรคตอนหรืออะพอสทรอฟี (') ใน string คุณสามารถทำได้สองวิธี
+
+ใช้เครื่องหมายอัญประกาศคู่:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+หรือใช้เครื่องหมายวรรคตอนหรืออะพอสทรอฟรีร่วมกับเครื่องหมายทับขวา (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+คุณเพิ่งใช้ `upper` **method** กับ string ของคุณ เมธอท (เช่น `upper()`) เป็นลำดับของคำสั่งของ Python ที่มีการดำเนินการบนวัตถุที่กำหนด (`"Ola"`) เมื่อคุณเรียกใช้มัน
+
+ถ้าคุณอยากรู้ว่าชื่อของคุณมีกี่ตัวอักษร มันก็มี **function** ที่ทำหน้าที่นี้เหมือนกัน!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+คุณสงสัยมั้ยว่า ทำไมบางครั้งคุณเรียกใช้ฟังก์ชั่นโดยมี `.` อยู่ท้าย string (เช่น `"Ola".upper()`) และบางครั้งก็เรียกใช้ฟังก์ชั่นโดยมี string อยู่ในวงเล็บ? คืองี้ บางกรณี ฟังก์ชั่นก็เป็นของวัตถุ เช่น `upper()` ซึ่งสามารถใช้ได้เฉพาะกับ string ในกรณีนี้ เราเรียกฟังก์ชั่นว่า **method** กรณีอื่นๆ ที่ฟังก์ชั่นไม่ได้เป็นของวัตถุใดวัตถุหนึ่ง และยังสามารถใช้ได้กับวัตถุชนิดอื่นๆ ได้ เช่น `len()` นั่นคือเหตุผลที่เราใช้ `"Ola"` เป็นพารามิเตอร์ให้กับฟังก์ชัน `len`
+
+### บทสรุป
+
+เอาล่ะ พอก่อนเนอะสำหรับ string จนถึงตอนนี้คุณได้เรียนรู้เกี่ยวกับ:
+
+- **prompt** - คือการพิมพ์คำสั่ง (โค้ด) ลงใน Python prompt ซึ่งผลที่ได้จะมาจากการรันโค้ด Python
+- **numbers and strings** - ในภาษา Python ตัวเลขจะใช้ในการคำนวณทางคณิตศาสตร์และ string จะใช้สำหรับวัตถุประเภทข้อความ
+- **operators** - เช่น `+` และ `*` จะเป็นการรวมค่าเพื่อใช้ให้การหาค่าใหม่
+- **functions** – เช่น `upper()` และ `len()` จะทำงานกับวัตถุ
+
+สิ่งเหล่านี้เป็นพื้นฐานของทุกภาษาเขียนโปรแกรมที่คุณเรียนรู้ คุณพร้อมสำหรับอะไรที่ยากกว่านี้แล้วใช่มั้ย? เรารู้ว่าคุณพร้อม!
+
+## ความผิดพลาด
+
+มาลองทำอะไรใหม่ๆกันบ้าง เราจะหาความยาวของตัวเลขได้เหมือนกับที่เราหาความยาวของชื่อเราได้มั้ยนะ? ลองพิมพ์ `len(304023)` แล้วกด `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+เราเพิ่งเจอข้อผิดพลาดแรกของเรา! สัญลักษณ์ {{ warning_icon }} จะเป็นวิธีที่เราจะบอกกับคุณว่า โค้ดที่คุณกำลังจะรันนั้นจะไม่สามารถทำงานได้อย่างที่คุณคาดหวัง การทำผิดพลาด (รวมถึงความผิดพลาดที่เจตนา) เป็นส่วนสำคัญของการเรียนรู้!
+
+ข้อผิดพลาดนี้บอกเราว่า "int" (integer หรือ จำนวนเต็ม) นั้นไม่สามารถหาความยาวได้ แล้วเราจำทำยังไงล่ะทีนี้? บางทีเราน่าจะเปลี่ยนให้ตัวเลขของเราเป็น string? เพราะ string มีความยาว จริงมั๊ย?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+เฮ้ย มันใช้ได้! เราใช้ฟังก์ชัน `str` ข้างในฟังก์ชัน `len` อีกที, `str()` จะแปลงทุกอย่างให้เป็น string
+
+- ฟังก์ชัน `str` จะแปลงสิ่งต่างๆ ให้กลายเป็น **string**
+- ฟังก์ชัน `int` จะแปลงสิ่งต่างๆ ให้กลายเป็น **integer**
+
+> สิ่งสำคัญที่ต้องทราบ: เราสามารถแปลงตัวเลขให้กลายเป็นข้อความได้ แต่เราไม่สามารถแปลงข้อความให้เป็นตัวเลขได้ - `int('hello')` จะแปลงคำว่า hello ให้กลายเป็นจำนวนเต็มได้ยังไงล่ะเนี่ย?
+
+## ตัวแปร
+
+แนวคิดสำคัญในการเขียนโปรแกรมคือ การใช้ตัวแปร ตัวแปรนั้นไม่มีอะไรมากกว่าการเป็นชื่อ ที่คุณสามารถนำไปใช้ในภายหลังได้ โปรแกรมเมอร์ใช้ตัวแปรในการเก็บข้อมูล มันทำให้อ่านโค้ดได้ง่ายขึ้นและยังช่วยให้พวกเขาไม่ต้องจำค่าต่างๆที่อยู่ในโปรแกรม
+
+สมมุติว่าเราอยากจะสร้างตัวแปลที่ใช้ชื่อว่า `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+เราก็พิมพ์ name เท่ากับ Ola
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+วู้ฮู้วว! ตัวแปรแรกของคุณ! :) คุณสามารถเปลี่ยนค่าที่ตัวแปรสื่อถึงได้ตลอดนะ:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+คุณใช้มันในฟังก์ชั่นก็ได้นะ:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+แต่ถ้าเกิดเราใช้ชื่อตัวแปรไม่ถูกล่ะ? คุณเดาได้มั้ยว่าจะเกิดอะไรขึ้น? มาลองดูกัน!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+เออเร่อ! คุณจะเห็นได้ว่า Python มีข้อผิดพลาดหลากหลายชนิด และข้อผิดพลาดนี้เรียกว่า **NameError** Python จะแสดงข้อผิดพลาดนี้ออกมา ถ้าคุณพยายามใช้ตัวแปรที่ยังไม่มีหรือยังไม่ได้กำหนด ถ้าคุณพบข้อผิดพลาดนี้ในภายหลัง ลองตรวจโค้ดของคุณดู คุณอาจจะพิมพ์ชื่อผิดซักที่ก็เป็นได้
+
+ลองเล่นกับมันดูนะ และดูว่าคุณสามารถทำอะไรได้แค่ไหน!
+
+## ฟังก์ชั่นการแสดงผล
+
+ลองนี่:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+เมื่อคุณพิมพ์ `name` ตัวประมวลผลของภาษา Python จะตอบกลับมาด้วย string ของตัวแปร 'name' *ที่อ้างถึง* ซึ่งก็คือตัวอักษร M-a-r-i-a ที่มีเครื่องหมายอัญประกาศเดี่ยวครอบอยู่ เมื่อคุณใช้ `print(name)` Python จะ "แสดง" เนื้อหาที่อยู่ในตัวแปรออกมาบนหน้าจอ โดยที่ไม่มีเครื่องหมายอัญประกาศ ซึ่งจะดูเรียบร้อยกว่า
+
+เราจะเห็นได้ในภายหลังว่า `print()` นั้นมีประโยชน์เมื่อเราต้องการแสดงผลของค่าบางอย่างที่อยู่ข้างในฟังก์ชั่น หรือเมื่อเราต้องการแสดงผลทีละหลายๆ บรรทัด
+
+## List
+
+นอกจาก string และ interger แล้ว Python ยังมีประเภทข้อมูลชนิดต่างๆ อยู่อีก ตอนนี้เราจะแนะนำให้คุณรู้จักหนึ่งในนั้น ซึ่งก็คือ **list** List คือสิ่งที่คุณคิดไว้นั้นแหละ: เป็นวัตถุที่เก็บรายการของวัตถุอื่นๆ ยังไงล่ะ :)
+
+มาลองสร้าง list กัน:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+ใช่แล้ว นี่คือ list ว่างเปล่า ไม่ค่อยมีประโยชน์เลยใช่มั้ย? เราลองมาสร้าง list ของหมายเลขลอตเตอรี่กัน เราจะไม่ทำแบบเดิมซ้ำๆ แล้ว ดังนั้นเราจะใส่ไว้ในตัวแปรซะเลย:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+เอาล่ะ เรามี list แล้ว! แล้วเราทำอะไรกับมันได้บ้างล่ะ? เรามาดูกันว่า เรามีหมายเลขลอตเตอรี่อยู่กี่อันภายใน list คุณพอรู้มั้ยว่าเราจะใช้ฟังก์ชั่นไหน? แน่นอน คุณรู้อยู่แล้ว!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+ใช่แล้ว! ฟังก์ชัน `len()` จะบอกคุณได้ว่ามีวัตถุอยู่ใน list กี่อัน สะดวกดีใช่มั้ยล่ะ? บางทีเราควรจะเรียงเลขข้างในนะ:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+ไม่มีอะไรตอบกลับมาเลย เพราะมันแค่เปลี่ยนลำดับของ list งั้นเราลองพิมพ์ list ออกมาดูอีกทีว่าเกิดอะไรขึ้น:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+อย่างที่คุณเห็น ตัวเลขใน list ของคุณถูกเรียงจากน้อยไปหามาก ยินดีด้วย!
+
+บางทีเราต้องการจะกลับด้านจากมากไปหาน้อย? มาลองกันเลย!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+ถ้าคุณอยากจะเพิ่มอะไรซักอย่างเข้าไปใน list คุณสามารถทำได้โดยใช้คำสั่ง:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+ถ้าคุณต้องการจะแสดงเฉพาะหมายเลขแรก คุณสามารถทำได้โดยใช้ **indexes** ดัชนีคือตัวเลขที่บอกตำแหน่งของสิ่งที่อยู่ใน list โปรแกรมเมอร์จะเริ่มนับจาก 0 เพราะฉะนั้นสิ่งที่อยู่เป็นอันดับแรกในลิสต์ ก็คือ ดัชนีหมายเลข 0 ถัดไปก็คือ 1 และต่อไปเรื่อยๆ ลองนี่:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+คุณจะเห็นได้ว่า คุณสามารถเข้าถึงสิ่งที่อยู่ใน list โดยใช้ชื่อของ list และระบุดัชนีตำแหน่งข้างในวงเล็บเหลี่ยม
+
+ในการลบบางสิ่งจาก list ของคุณ คุณจะต้องใช้ **ดัชนี** ดังที่เราได้เรียนไปแล้วจากด้านบน รวมถึงการใช้เมธอด `pop()` เรามาลองทำตามตัวอย่างนี้เพื่อทบทวนสิ่งที่เรียนมาข้างต้น เราจะทำการลบเลขตัวแรกออกจาก list ของเรา
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+มันทำงานได้ถูกต้องเหมือนมีเวทมนตร์เลยล่ะ!
+
+เพื่อความสนุกยิ่งขึ้น ลองใช้ค่าดัชนีอื่นๆ เช่น: 6, 7, 1000, -1, -6 หรือ -1000 แล้วดูว่าคุณสามารถเดาผลลัพธ์ก่อนที่จะลองพิมพ์คำสั่งได้มั้ย แล้วผลลัพธ์ที่ว่า มันสมเหตุสมผลมั้ย?
+
+คุณสามารถหาฟังก์ชั่นทั้งหมดของ list ได้จากเอกสารในเว็บ Python: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionary
+
+> สำหรับผู้อ่านทางบ้าน ส่วนนี้จะครอบคลุมในส่วนวิดิโอของ [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c)
+
+Dictionary นั่นก็คล้ายๆกับ list แต่การเข้าถึงค่าของตัวแปรข้างในต้องใช้ key แทนที่ดัชนี ซึ่ง key นั้นสามารถเป็นได้ทั้ง string หรือ ตัวเลข ส่วนไวยากรณ์(วากยสัมพันธ์) สำหรับสร้าง dictionary เปล่าๆนั้นคือ:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+นี่แสดงว่า คุณเพิ่งสร้าง dictionary เปล่าขึ้นมาแล้ว ฮูเร่!
+
+ตอนนี้ มาลองใช้คำสั่งตามนี้ (ลองเปลี่ยนข้อมูลข้างในด้วยนะ):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+คำสั่งนี้ เป็นการสร้างตัวแปร ชื่อ `participant` ซึ่งมี key-value สามค่า:
+
+- Key ชื่อ `name` ชี้ไปยังค่า `'Ola'` (เป็นวัตถุประเภท `string`)
+- `country` ชี้ไปยัง `'Poland'` (เป็น `string` อีกอัน),
+- และ `favorite_numbers` ชี้ไปยัง `[7, 42, 92]` (เป็น `list` ที่มีตัวเลขสามตัวข้างใน)
+
+คุณสามารถตรวจสอบค่าที่อยู่ในแต่ละ key ได้จาก:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+เห็นรึเปล่าว่ามันคล้าย list นะ และคุณไม่จำเป็นต้องจำดัชนี ใช้แค่จำชื่อก็พอ
+
+จะเกิดไรขึ้น ถ้าคุณต้องการหาค่าจาก key ที่ไม่มีอยู่จริง? มาลองดูกัน!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+ดูสิ! เกิดข้อผิดพลาดอีกอันนึงแล้ว! อันนี้เรียกว่า **KeyError** Python พยายามช่วยเราด้วยการบอกว่า key ชื่อ `'age'` ไม่มีอยู่ใน dictionary
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- ถ้าคุณต้องการข้อมูลที่เป็นลำดับ? ใช้ list
+- ถ้าคุณต้องการเชื่องโยงค่าข้อมูลโดยใช้ key เพื่อที่จะค้นหาได้ในภายหลังอย่างมีประสิทธิภาพ (โดยใช้ key)? ใช้ dictionary
+
+Dictionary ก็คล้ายๆกับ list คือมัน *mutable* หมายถึงเราสามารถแก้ไขค่าต่างๆ ข้างใน dictionary ได้ หลังจากที่เราสร้างมันขึ้นมาแล้ว คุณสามารถเพิ่ม key - value เข้าไปยัง dictionary ที่สร้างขึ้นมาแล้ว แบบนี้:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+เราหวังว่าคุณคงเข้าใจมันบ้างแล้วนะ :) คุณพร้อมที่จะรับความสนุกของ dictionary แล้วใช่มั้ย? ลองอ่านต่อไปสิ สิ่งที่น่าอัศจรรย์อยู่ถัดไปจากบรรทัดนี้แล้ว
+
+คุณสามารถใช้คำสั่ง `pop()` เพื่อลบสมาชิกภายใน dictionary ได้ Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+อย่างที่คุณเห็นจากผลลัพธ์ ค่าของ key-value ที่อยู่ใน key 'favorite_number' ได้ถูกลบไปแล้ว
+
+นอกจากนี้ คุณยังสามารถเปลี่ยนค่าต่างๆ ที่มี key อยู่ข้างใน dictionary อยู่แล้ว ลองพิมพ์ตามนี้ดู:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+อย่างที่คุณเห็น ค่าของ key ที่ชื่อ `'country'` ถูกเปลี่ยนจาก `'Poland'` เป็น `'Germany'` :) น่าตื่นเต้นใช่ไหม? ฮู้เร่! คุณได้รู้สิ่งที่น่าอะเมซิงอีกหนึ่งอย่างแล้ว
+
+### บทสรุป
+
+เจ๋งไปเลย! ตอนนี้คุณได้เรียนรู้เกี่ยวกับการเขียนโปรแกรมเพิ่มมากขึ้นแล้ว ในส่วนที่ผ่านมา คุณได้เรียนรู้เกี่ยวกับ:
+
+- **errors** - ตอนนี้คุณได้รู้วิธีการอ่านและทำความเข้าใจเกี่ยวกับข้อผิดพลาดต่างๆ ที่ Python ได้แสดงให้คุณเห็น เมื่อ Python ไม่เข้าใจเกี่ยวกับคำสั่งที่คุณป้อนเข้าไป
+- **variables** หรือ ตัวแปร - ชื่อสำหรับวัตถุต่างๆ ที่ช่วยให้คุณเขียนโค้ดได้ง่ายขึ้น และยังทำให้โค้ดอ่านง่ายมากขึ้นอีกด้วย
+- **list** - ลิสต์ที่เก็บรายการวัตถุอย่างเป็นลำดับที่เฉพาะเจาะจง
+- **dictionary** - ข้อมูลของวัตถุจะถูกเก็บอยู่ในรูปแบบของคู่ key-value
+
+ตื่นเต้นสำหรับส่วนถัดไปแล้วใช่มั้ย? :)
+
+## การเปรียบเทียบสิ่งต่างๆ
+
+> สำหรับผู้อ่านทางบ้าน ส่วนนี้จะครอบคลุมในส่วนวิดิโอของ [Python Basics: Dictionaries](https://www.youtube.com/watch?v=7bzxqIKYgf4)
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+คุณคงสงสัยว่าทำไมต้องใช้เครื่องหมายเท่ากับถึงสองอันติดกันแบบนี้ `==` เพื่อเปรียบเทียบว่าตัวเลขนั้นเท่ากันหรือไม่? เพราะเราใช้เครื่องหมาย `=` อันเดียว สำหรับกำหนดค่าให้กับตัวแปรไปแล้วนั่นเอง คุณจำเป็นต้องใส่เครื่องหมาย `==` **เสมอ** ถ้าคุณต้องการตรวจสอบว่าทั้งสองค่าเท่ากันหรือไม่ นอกจากนี้เรายังสามารถเปรียบเทียบสิ่งที่ไม่เท่ากันได้อีกด้วย เราใช้เครื่องหมาย `!=` เหมือนในตัวอย่างด้านบน
+
+ลองให้ Python ทำเพิ่มอีกซักสองคำสั่ง:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+เรารู้จักเครื่องหมาย `>` และ `<` แล้วเครื่องหมาย `>=` กับ `<=` ล่ะ มันหมายถึงอะไร? มันอ่านแบบนี้:
+
+- x `>` y หมายถึง: x มีค่ามากกว่า y
+- x `<` y หมายถึง: x มีค่าน้อยกว่า y
+- x `<=` y หมายถึง: x มีค่าน้อยกว่าหรือเท่ากับ y
+- x `>=` y หมายถึง: x มีค่ามากกว่าหรือเท่ากับ y
+
+เจ๋งไปเลย! อยากทำอีกมั้ย? ลองนี่สิ:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+คุณสามารถให้ Python เปรียบเทียบตัวเลขหลายๆตัวได้มากเท่าที่คุณต้องการ แล้วมันก็ให้คำตอบกับคุณเสมอด้วย! ฉลาดสุดๆ เลยใช่ป่ะ?
+
+- **and** - ถ้าคุณใช้ `and` หากต้องการได้ค่า True ค่าของทั้งคู่ต้องเป็นจริง
+- **or** - ถ้าคุณใช้ `or` หากต้องการได้ค่า True ค่าใดค่าหนึ่งต้องเป็นจริง
+
+คุณเคยได้คำนี้ไหม "เปรียบเทียบแอปเปิ้ลกับส้ม" เรามาลองอะไรที่คล้ายๆ กันนี้ บน Python กัน:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+จะเห็นได้ว่า Python ไม่สามารถเปรียบเทียบค่าของตัวเลขจำนวนเต็ม (`int`) และ string (`str`) ได้ Python แสดงข้อผิดพลาด **TypeError** ออกมา และบอกเราว่า สองชนิดนี้ไม่สามารถเปรียบเทียบกันได้
+
+## ค่าบูลีน
+
+คุณเพิ่งบังเอิญได้เรียนรู้เกี่ยวกับชนิดของวัตถุชนิดใหม่ในภาษา Python นั้นก็คือ **Boolean** หรือ ค่าบูลีน
+
+Boolean มีเพียงแค่สองค่าเท่านั้น คือ:
+
+- True (จริง)
+- False (ไม่จริง)
+
+ถ้าจะให้ Python เข้าใจสิ่งนี้ คุณต้องเขียนให้ถูกต้องแบบนี้เสมอ 'True' (ตัวแรกเป็นตัวอักษรตัวใหญ่ นอกนั้นเป็นตัวเล็กหมด) **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Boolean ก็สามารถเป็นตัวแปรได้เช่นกัน! ลองดูนี่:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+คุณสามารถทำแบบนี้ได้เช่นกัน:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+ลองซ้อมและสนุกไปกับ Boolean โดยลองใช้คำสั่งเหล่านี้:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+ยินดีด้วย! Boolean เป็นฟีเจอร์ที่เจ๋งสุดๆในการเขียนโปรแกรม และคุณเพิ่งได้เรียนรู้วิธีใช้มัน!
+
+# เซฟซะ!
+
+> สำหรับผู้อ่านทางบ้าน ส่วนนี้จะครอบคลุมในส่วนวิดิโอของ [Python Basics: Dictionaries](https://www.youtube.com/watch?v=dOAg6QVAxyk)
+
+จนถึงตอนนี้ เราก็ได้เขียนโค้ด python ทั้งหมดลงในตัวแปลคำสั่ง ซึ่งจะมีข้อจำกัดในเรื่องการป้อนคำสั่งทีละบรรทัด โปรแกรมปกติจะถูกบันทึกลงในไฟล์และเรียกใช้งานโดย **อินเตอร์พรีเตอร์** หรือ **คอมไพเลอร์** จนถึงตอนนี้เราได้รันโค้ดของเราทีละบรรทัดใน Python **อินเตอร์พรีเตอร์** (ตัวแปลคำสั่ง) จากนี้ไปเราจำเป็นต้องใช้โค้ดมากกว่าหนึ่งบรรทัด งั้นตอนนี้เราจำเป็นต้อง:
+
+- ออกจาก Python interpreter
+- เปิดโปรแกรมแก้ไขโค้ดที่เราเลือก
+- บันทึกโค้ดลงในไฟล์ python ไฟล์ใหม่
+- แล้วเรียกใช้มัน!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+หลังจากเรียกใช้ฟังก์ชัน คุณจะถูกพากลับมายัง command prompt
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+จริงๆ แล้วตอนนี้ คุณก็มีความรู้เกี่ยวกับ Python พอตัวแล้ว งั้นลองเขียนโค้ดที่คุณได้เรียนจากวันนี้ดู
+
+ตอนนี้เราต้องบันทึกไฟล์ และตั้งชื่อที่มีความหมาย เราจะตั้งชื่อว่า **python_intro.py** และบันทึกไฟล์เก็บไว้ที่หน้าจอเดสก์ท็อปของคุณ เราสามารถตั้งชื่อไฟล์อะไรใดก็ได้ที่เราต้องการ แต่สิ่งที่สำคัญก็คือชื่อไฟล์ต้องลงท้ายด้วย **.py** นามสกุล **.py** จะบอกระบบปฏิบัติการว่าเป็น **python executable file** และ Python สามารถรันไฟล์นี้ได้
+
+> **หมายเหตุ** คุณคงสังเกตเห็นสิ่งที่เจ๋งสุดๆอย่างนึงของ code editor นั้นก็คือสีนั่นเอง! ในคอนโซล Python ทุกอย่างจะเป็นสีเดียวกันหมด ตอนนี้คุณจะเห็นว่าฟังก์ชัน `print` มีสีที่ต่างจาก string มันมีชื่อว่า "syntax highlighting" และเป็นฟีเจอร์ที่มีประโยชน์มากๆ เมื่อเขียนโค้ด ซึ่งสีแต่ละสีจะบ่งบอกสิ่งที่แตกต่างกัน เช่น string ที่ไม่ได้ปิดด้วยเครื่องหมายอัญประกาศหรือชื่อ keyword ที่พิมพ์ผิด (เช่น `def` ซึ่งเดี๋ยวเราจะได้เห็นตัวอย่างด้านล่างนี้) นี่เป็นหนึ่งเหตุผลว่าทำไมเราถึงใช้โปรแกรมแก้ไขโค้ด. :)
+
+เรามีไฟล์แล้ว ตอนนี้ถึงเวลาที่เราจะรันมัน! โดยใช้ความรู้ที่เราเรียนมาในบทการใช้บรรทัดคำสั่ง ใช้เทอร์มินัลโดย **เปลี่ยนไดเรกทอรี** ไปยังหน้าจอเดสก์ท็อป
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+บน Mac คำสั่งที่ใช้จะมีลักษณะแบบนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### ถ้าเกิดว่า เงื่อนไขไม่เป็นจริงล่ะ?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## คอมเม้นท์
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### บทสรุป
+
+In the last few exercises you learned about:
+
+- **การเปรียบเทียบสิ่งต่างๆ** - ใน Python คุณสามารถเปรียบเทียบสิ่งต่างๆ โดยใช้ `>`, `>=`, `==`, `<=`, `<` และ `and`, `or`
+- **Boolean** - คือชนิดของวัตถุซึ่งมีเพียงสองค่าคือ: `True` และ `False`
+- **การบันทึกไฟล์** - คือการบันทึกโค้ดลงในไฟล์ ทำให้คุณสามารถรันโปรแกรมขนาดใหญ่ได้
+- **if... elif... else** - ช่วยให้คุณรันโค้ดเมื่อตรงตามเงื่อนไขที่ต้องการ
+- **comments** - เป็นบรรทัดที่ Python จะไม่รัน ช่วยให้คุณสามารถเขียนโน้ตเล็กๆเกี่ยวกับโค้ดนั้นๆได้
+
+Time for the last part of this chapter!
+
+## สร้างฟังก์ชั่นของคุณเอง!
+
+> สำหรับผู้อ่านทางบ้าน ส่วนนี้จะครอบคลุมในส่วนวิดิโอของ [Python Basics: Dictionaries](https://www.youtube.com/watch?v=5owr-6suOl0)
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- ถ้ามันโชว์ว่า `NameError` นั่นหมายถึงคุณพิมพ์อะไรผิด ดังนั้นคุณควรตรวจสอบว่า คุณใช้ชื่อเดียวกันเมื่อสร้างฟังก์ชั่นด้วย เช่นคุณสร้างฟังก์ชั่นชื่อ ` def hi(): ` เมื่อคุณเรียกใช้ฟังก์ชั่น ก็ควรเรียกใช้ชื่อ `hi()` เป็นต้น
+- ถ้าโปรแกรมโชว์ว่า `IndentationError` ให้ตรวจสอบว่าบรรทัดทั้งสองบรรทัดที่คุณพิมพ์ว่า `print` นั้น มีการเคาะเว้นวรรคที่เท่ากัน: Python ต้องการให้โค้ดทั้งหมดที่อยู่ในฟังก์ชั่นสอดคคล้องกันอย่างเรียบร้อย
+- ถ้าหากโปรแกรมไม่แสดงเอาต์พุตใดๆเลย ให้ตรวจสอบว่า `hi()` *ไม่*ได้ถูกเยื้อง ถ้ามันถูกเยื้อง บรรทัดนี้จะถูกรวมเป็นส่วนหนึ่งของฟังก์ชั่นด้วย และมันจะไม่ถูกรัน
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## การทำซ้ำ
+
+> สำหรับผู้อ่านทางบ้าน ส่วนนี้จะครอบคลุมในส่วนวิดิโอของ [Python Basics: Dictionaries](https://www.youtube.com/watch?v=aEA6Rc86HF0)
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## บทสรุป
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/th-TH/template_extending/README.md b/th-TH/template_extending/README.md
new file mode 100644
index 00000000000..76aa9bd0aa4
--- /dev/null
+++ b/th-TH/template_extending/README.md
@@ -0,0 +1,151 @@
+# การขยายเทมแพลต
+
+ความเจ๋งอีกอย่างหนึ่งของ Django คือ **ความสามารถในการขยายเทมเพลต** มันหมายความว่าไงล่ะ? มันก็หมายความว่า คุณสามารถใช้ส่วนเดียวกันของ HTML ของคุณในหลายๆ หน้าของเว็บไซต์ของคุณ
+
+เทมเพลตช่วยคุณได้ เมื่อคุณต้องการใช้ข้อมูลเดิมหรือเค้าโครงเดียวกันมากกว่าหนึ่งครั้ง คุณไม่ต้องทำซ้ำในทุกๆไฟล์ และถ้าหากคุณต้องการปรับเปลี่ยนบางอย่าง คุณก็ไม่จำเป็นต้องทำในทุกๆเทมเพลต คุณแค่ทำในเทมเพลตเดียวเท่านั้น
+
+## สร้างเทมเพลตพื้นฐาน
+
+เทมเพลตพื้นฐาน คือเทมเพลตที่เรียบง่ายที่สุด ที่คุณจะสามารถนำไปสร้างเป็นหน้าอื่นในเว็บของคุณได้
+
+สร้างไฟล์ `base.html` ใน `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+จากนั้น ในไฟล์ `base.html` ให้แทน `<body>` ทั้งหมด (ทุกสิ่งระหว่าง `<body>` และ `</body>`) ด้วย:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %} คุณอาจจะสังเกตว่ามันแทนที่ทุกๆอย่างตั้งแต่ `{% for post in posts %}` ไปจนถึง `{% endfor %}` ด้วย: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+แต่ทำไมล่ะ? คุณเพิ่งสร้าง `block` นี่นา! คุณใช้ template tag `{% block %}` ในการสร้างพื้นที่ที่จะแทรก HTML ไว้ ซึ่ง HTML นั้นจะมาจากอีกเทมเพลตนึงที่ขยายเทมเพลตนี้ (`base.html`) เดี๋ยวเราจะแสดงให้คุณเห็นว่าคุณควรทำยังไง
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}คุณกำลังจะลบทุกอย่างก่อน `{% for post in posts %}` และหลัง`{% endfor %}` เมื่อคุณทำสำเร็จ หน้าตาของไฟล์มันจะเป็นแบบนี้: {% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+เราต้องการใช้ข้อมูลนี้เป็นส่วนหนึ่งของเทมเพลตของเราสำหรับบล็อกเนื้อหาทั้งหมด ได้เวลาเพิ่มแท็กบล็อคในไฟล์นี้แล้ว!
+
+{% raw %}คุณจะต้องให้แท็กบล็อกของคุณเหมือนกับแท็กในไฟล์ `base.html` คุณยังต้องรวมโค้ดทั้งหมดที่อยู่ในบล็อคเนื้อหาของคุณ ในการจะทำแบบนั้น เราต้องใส่ทุกอย่างลงไประหว่าง `{% block content %}` และ `{% endblock %}` แบบนี้:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+ตอนนี้ก็เหลือแค่อย่างเดียวที่เราต้องทำ ก็คือการเชื่อมเทมเพลตสองอันนี้เข้าด้วยกัน นี่แหละคือทั้งหมดของการขยายเทมเพลต เราจะทำโดยเพิ่มแท็กขยายลงในตอนต้นของไฟล์ แบบนี้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> ถ้าคอมพิวเตอร์โชว์ว่า `TemplateDoesNotExist` หมายความว่า มันไม่มีไฟล์ `blog/base.html` และคุณมี `runserver` ที่กำลังรันอยู่ในคอนโซล ลองหยุดการทำงานของเซิร์ฟเวอร์ (โดยกดปุ่ม Ctrl+C - ปุ่ม Ctrl และปุ่ม C พร้อมกัน) และรีสตาร์ทเซิร์ฟเวอร์ด้วยการรันคำสั่ง `python manage.py runserver`
\ No newline at end of file
diff --git a/th-TH/whats_next/README.md b/th-TH/whats_next/README.md
new file mode 100644
index 00000000000..42e2f2d66f1
--- /dev/null
+++ b/th-TH/whats_next/README.md
@@ -0,0 +1,43 @@
+# จะมีอะไรต่อหลังจากนี้?
+
+ยินดีกับความสำเร็จของคุณ! **คุณเจ๋งสุดๆไปเลย** เราภูมิใจในตัวคุณนะ! <3
+
+### แล้วตอนนี้เราจะทำอะไรดี?
+
+Take a break and relax! You have just done something really huge.
+
+หลังจากนั้น อย่าลืมที่จะติดตาม Django Girls บน [Facebook](http://facebook.com/djangogirls) หรือ [Twitter](https://twitter.com/djangogirls) เพื่อรับข่าวสารล่าสุด
+
+### คุณแนะนำบทเรียนเพิ่มเติมให้ได้ไหม?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/th/GLOSSARY.md b/th/GLOSSARY.md
new file mode 100644
index 00000000000..745a03d1fe9
--- /dev/null
+++ b/th/GLOSSARY.md
@@ -0,0 +1,3 @@
+# โปรแกรมแก้ไขโค้ด
+
+โปรแกรมแก้ไขโค้ด คือ โปรแกรมที่ช่วยให้คุณบันทึกโค้ดของคุณและกลับมาดูในภายหลังได้ คุณสามารถหาโปรแกรมนี้ได้จากบท [โปรแกรมแก้ไขโค้ด](./code_editor/README.md)
\ No newline at end of file
diff --git a/th/README.md b/th/README.md
new file mode 100644
index 00000000000..8f05e4b9542
--- /dev/null
+++ b/th/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> งานนี้ได้รับการอนุญาตภายใต้อนุญาตสร้างสรรค์คอมมอนส์ครีเอทีฟ 4.0 อินเตอร์เนชั่นแนล สำเนาใบอนุญาต ชม https://creativecommons.org/licenses/by-sa/4.0/thai
+
+## Thai
+
+Msaduxarea123@gmail.com Msaduxarea@gmail.com
+
+Msaduxarea@gmail.com
+
+## บทนำ
+
+Internet wifi และเคยรู้สึกไหมว่า ไม่มีแรงจูงใจที่จะเริ่มสร้างเว็บไซต์? เคยคิดไหมว่า โลกของการทำซอฟต์แวร์ช่างซับซ้อนมากเกินไปสำหรับคุณ หากจะลงมือทำเอง?
+
+เรามีข่าวดีสำหรับคุณ! การเขียนโปรแกรมมันไม่ยากเหมือนอย่างที่คิด และเราจะโชว์ให้ดูถึงความสนุกของมัน
+
+ไทย ถ้าคุณต้องการที่จะเป็นโปรแกรมเมอร์ที่เก่ง คุณต้องการเวลาเพื่อเรียนรู้และฝึกฝน ไม่ว่าจะหลายเดือนหรือหลายปี แต่เราอยากจะแสดงให้คุณดูว่า การเขียนโปรแกรมหรือสร้างเว็บไซต์ไม่ได้ยุ่งยากอะไรขนาดนั้น เราจะพยายามอธิบายให้เข้าใจง่ายที่สุดเท่าที่จะทำได้ เพราะงั้นคุณไม่จำเป็นต้องกลัวอะไรเกี่ยวกับเทคโนโลยีสายนี้
+
+เราหวังว่า จะทำให้คุณหลงรักเทคโนโลยีมากได้เท่าๆ กับที่พวกเรารักมัน!
+
+## คุณจะได้เรียนรู้อะไรบ้างในบทเรียนนี้?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+ซึ่งผลลัพธ์จะออกมาประมาณนี้ (อาจจะต่างจากนี้หน่อย แต่ไม่มาก):
+
+![รูปที่ 0.1](images/application.png)
+
+> หากคุณเรียนบทเรียนนี้ด้วยตัวคุณเอง โดยที่ไม่มีใครช่วยคุณ เรามีช่องทางให้คุณผ่านช่องทางสนทนา: !(https://badges. gitter. im/Join Chat. svg)![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg) ซึ่งเราได้ขอให้โค้ชและคนที่เคยผ่านบทเรียนนี้มาช่วยตอบคำถามให้กับคนอื่นที่มาเรียนบทเรียนนี้ด้วย! อย่ากลัวที่จะถามคำถามนะ!</p> </blockquote> 
+> 
+> โอเค, [เรามาเริ่มกันเลยดีกว่า...](./how_the_internet_works/README.md)
+> 
+> ## การทำตามบทเรียนจากที่บ้าน
+> 
+> มันจะสุดยอดมากถ้าได้เป็นส่วนหนึ่งในการประชุมเชิงปฏิบัติการ Django Girls แต่เราตระหนักดีว่า มันไม่เสมอไปที่จะได้เข้าร่วม นี่คือเหตุผลที่เราแนะนำให้คุณลองทำตามบทเรียนนี้ที่บ้าน For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+> 
+> In every chapter already covered, there is a link that points to the correct video.
+> 
+> ## เกี่ยวกับบทเรียนนี้ และ การร่วมพัฒนา
+> 
+> บทเรียนนี้ดูแลโดย [DjangoGirls](https://djangogirls.org/) ถ้าคุณเห็นข้อผิดพลาดหรืออยากจะอัปเดตบทเรียนนี้ กรุณา [ดูรายละเอียด แนวทางการร่วมพัฒนา](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+> 
+> ## Would you like to help us translate the tutorial into other languages?
+> 
+> Currently, translations are being kept on crowdin.com platform at:
+> 
+> https://crowdin.com/project/django-girls-tutorial
+> 
+> If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/th/SUMMARY.md b/th/SUMMARY.md
new file mode 100644
index 00000000000..f9f88f9391d
--- /dev/null
+++ b/th/SUMMARY.md
@@ -0,0 +1,27 @@
+# ภาพรวม
+
+* [บทนำ](README.md)
+* [การติดตั้ง](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [อินเทอร์เน็ตทำงานอย่างไร](how_the_internet_works/README.md)
+* [แนะนำการใช้บรรทัดคำสั่ง](intro_to_command_line/README.md)
+* [การติดตั้ง Python](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [แนะนำให้รู้จัก Python](python_introduction/README.md)
+* [Django คืออะไร?](django/README.md)
+* [การติดตั้ง Django](django_installation/README.md)
+* [Django project แรก ของคุณ!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [แนะนำให้รู้จัก HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [ข้อมูลแบบ dynamic ใน template](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [การ extend template](template_extending/README.md)
+* [เพิ่มความสามารถให้เว็บคุณ](extend_your_application/README.md)
+* [Django Form](django_forms/README.md)
+* [หลังจากนี้?](whats_next/README.md)
\ No newline at end of file
diff --git a/th/chromebook_setup/README.md b/th/chromebook_setup/README.md
new file mode 100644
index 00000000000..52dba5fabef
--- /dev/null
+++ b/th/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# ติดตั้ง Chromebook
+
+> **หมายเหตุ** ถ้าคุณทำงานผ่านขั้นตอนการติดตั้งมาแล้ว ไม่จำเป็นต้องทำสิ่งนี้อีก – คุณสามารถข้ามตรงไปข้างหน้าเพื่อ[ทำความรู้จักภาษา Python](../python_introduction/README.md)
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/th/chromebook_setup/instructions.md b/th/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..d841745e7b0
--- /dev/null
+++ b/th/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+คุณสามารถ[ข้ามส่วนนี้ไป](http://tutorial.djangogirls.org/en/installation/#install-python)หากคุณไม่ได้ใช้ Chromebook ถ้าคุณไม่ได้ใช้ ประสบการณ์การติดตั้งจะแตกต่างกันเล็กน้อย คุณสามารถมองข้ามส่วนที่เหลือของขั้นตอนการติดตั้ง
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. สำหรับระยะเวลา ของบทเรียนนี้ Cloud 9 จะทำหน้าที่เป็น *local machine* คุณจะยังคงใช้คำสั่งในอินเตอร์เฟซเทอร์มินัลเหมือนเพื่อนบน OS X, Ubuntu หรือ Windows แต่เทอร์มินัลของคุณจะเชื่อมต่อกับคอมพิวเตอร์ที่ใช้ที่อื่นที่ Cloud 9 ตั้งค่าไว้สำหรับคุณ
+
+1. ติดตั้ง Cloud 9 จาก [Chrome เว็บสโตร์](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. ไปที่ [c9.io](https://c9.io)
+3. ลง​ทะเบียน​บัญชี​ผู้​ใช้
+4. คลิก*สร้างพื้นที่ทำงานใหม่*
+5. ตั้งชื่อมันว่า *django-girls*
+6. เลือก *Blank* (ที่ 2 จากขวาแถวล่างมีโลโก้สีส้ม)
+
+ตอนนี้ คุณควรเห็นอินเทอร์เฟซกับแถบข้าง หน้าต่างหลักใหญ่กับข้อความ และหน้าต่างขนาดเล็กด้านล่างที่มีลักษณะดังนี้:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    ชื่อผู้ใช้ของคุณ: ~ /workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### สภาพแวดล้อมเสมือน
+
+สภาพแวดล้อมเสมือน (เรียกว่าเป็น virtualenv) เป็นเหมือนกล่องส่วนตัวที่เราสามารถบรรจุโค๊ดคอมพิวเตอร์ที่เป็นประโยชน์ ลงไปสำหรับโครงการที่เรากำลังทำงานอยู่ เราใช้มันเพื่อเก็บบิตของโค๊ดมากมาย ที่เราต้องการแยกโครงการหลายๆโครงการออกจากกัน ทำให้ไม่มีการผสมกันระหว่างโครงการ
+
+ใน terminal ของคุณ ที่ด้านล่างของอินเตอร์เฟซ Cloud 9 เรียกใช้ดังนี้:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+ถ้าไม่สำเร็จ ถามโค้ชของคุณสำหรับความช่วยเหลือ
+
+จากนั้น เรียกใช้:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(หมายเหตุว่า บรรทัดสุดท้าย เราใช้ tilde ตาม ด้วยเครื่องหมายเท่ากับ: ~ =)
+
+### Github
+
+สร้างบัญชี [Github](https://github.com)
+
+### PythonAnywhere
+
+บทเรียน Django Girls ประกับด้วย ส่วนที่เรียกหว่า Deployment ซึ่งเป็นกระบวนการของการรับโค๊ดที่สนับสนุนแอ็พพลิเคชันเว็บใหม่ของคุณ และการย้ายไปยังคอมพิวเตอร์สาธารณะที่สามารถเข้าถึงได้ (เรียกว่าเซิร์ฟเวอร์) ทำให้คนอื่นสามารถเห็นผลงานของคุณได้
+
+ส่วนนี้แปลกเล็กน้อย เมื่อทำตามบทเรียนบน Chromebook เนื่องจากเรากำลังใช้คอมพิวเตอร์ที่อยู่บนอินเทอร์เน็ตอยู่แล้ว (ที่ตรงกันข้ามกับ laptop ที่พูดถึง) อย่างไรก็ตามก็ยังมีประโยชน์อยู่ เนื่องจากเราสามารถคิดว่า Cloud 9 เป็นสถานที่ทำงานของเรา หรือ "แสดงความคืบหน้า" งานของเราและ Python Anywhere เป็นสถานที่เพื่อแสดงผลงานที่เรา เมื่อมันเริ่มจะสมบูรณ์มากขึ้น
+
+ดังนั้น สมัครสมาชิกสำหรับงบัญชี Python Anywhere ใหม่ได้ที่ [www.pythonanywhere.com](https://www.pythonanywhere.com)
\ No newline at end of file
diff --git a/th/code_editor/README.md b/th/code_editor/README.md
new file mode 100644
index 00000000000..3a0f0e8f58f
--- /dev/null
+++ b/th/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> สำหรับผู้อ่านที่บ้าน: บทนี้ครอบคลุมเรื่องนี้ [วิดีโอการติดตั้ง Python และ Code Editer](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s)
+
+คุณกำลังจะเขียนบรรทัดแรกของ code ดังนั้น ได้เวลาที่จะดาวน์โหลด code editor ซักตัวนึง
+
+> **หมายเหตุ** ถ้าคุณใช้ Chromebook ข้ามบทนี้ และแน่ใจว่าคุณทำตามบทแนะนำ [ติดตั้ง Chromebook](../chromebook_setup/README.md)
+> 
+> **หมายเหตุ** คุณอาจได้ทำก่อนหน้านี้ในบทการติดตั้งเสร็จแล้ว – ถ้าดังนั้น คุณสามารถข้ามไปข้างหน้า ในบทถัดไป
+
+{% include "code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/th/code_editor/instructions.md b/th/code_editor/instructions.md
new file mode 100644
index 00000000000..f8b1f093f01
--- /dev/null
+++ b/th/code_editor/instructions.md
@@ -0,0 +1,31 @@
+ในตอนนี้มีโปรแกรม editor อยู่มากมาย ซึ่งก็ขึ้นอยู่กับความชอบของแต่ละคนว่าชอบโปรแกรมตัวไหน โปรแกรมเมอร์จำนวนมากใช้ IDEs (Integrated Development Environments) ที่ซับซ้อน แต่มีประสิทธิภาพมาก เช่น PyCharm สำหรับมือใหม่นั้น เราขอแนะนำให้ใช้โปรแกรมที่มีประสิทธิภาพเทียบเคียงกัน และใช้งานได้ง่ายกว่ามาก
+
+ด้านล่างนี้คือโปรแกรมที่เราแนะนำ คุณสามารถสอบถามโค้ชของคุณ หรือ โปรแกรมเมอร์คนอื่นๆ ถึงคำแนะนำเกี่ยวกับโปรแกรมเหล่านี้ เพื่อง่ายต่อการทำความเข้าใจโปรแกรมมากยิ่งขึ้น
+
+## Gedit
+
+Gedit เป็นโปรแกรม editor โอเพนซอร์ส และ ฟรี ซึ่งรองรับทุกระบบปฎิบัติการ
+
+[ดาวน์โหลดได้ ที่นี่](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[ดาวน์โหลดได้ ที่นี่](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[ดาวน์โหลดได้ ที่นี่](https://atom.io/)
+
+## ทำไมเราต้องติดตั้งโค้ด editor?
+
+คุณอาจจะสงสัยว่า ทำไมเราจะติดตั้งซอฟต์แวร์โค้ด editor ด้วยล่ะ ใช้ Word หรือ Notepad ก็น่าจะได้นี่
+
+ประการแรก คือ code ต้องเป็น **plain text** และจะมีปัญหากับโปรแกรม เช่น Word หรือ Textedit เพราะมันไม่ได้ผลิด plain text มัน ผลิต rich text (ที่ประกอบด้วย fonts และ การจัดรูปแบบ) หรือมีการใช้รูปแบบที่กำหนดเอง เช่น [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+ประการที่สอง คือ ผู้เขียนcode จะมีความเชี่ยวชาญในการแก้ไขcode ตังนั้นอาจต้องมีfeaturesที่เป็นประโยชน์มาช่วย เช่นตัวไฮไลต์code ด้วยสีที่บอกความหมายของมัน หรือ ตัวอัญประการที่ปิดอัตโนมัติ
+
+เราจะได้เห็นเหตุการณ์ทั้งหมดหลังจากนี้ คุณจะกลับมาคิดถึง code editor ตัวเก่าๆที่น่าเชื่อุถือ และเลือกตัวหนึ่งมาเป็นเครื่องมือที่คุณชอบที่สุด. :)
\ No newline at end of file
diff --git a/th/css/README.md b/th/css/README.md
new file mode 100644
index 00000000000..503551b11f8
--- /dev/null
+++ b/th/css/README.md
@@ -0,0 +1,304 @@
+# CSS - จับแต่งหน้าให้สวยปิ๊ง!
+
+อุต๊ะ บล๊อคของเราทำไมดูน่าเกลียดอย่างนี้ ได้เวลาที่จะทำให้มันดีขึ้น เราจะใช้ CSS สำหรับการปรับแต่ง
+
+## อะไรคือ CSS?
+
+Cascading Style Sheets (CSS) เป็นภาษาที่ใช้สำหรับอธิบายลักษณะ และรูปแบบของเว็บไซต์ที่ถูกเขียนในรูปภาษามาร์กอับ (เช่น HTML) อาจจะเรียกมันว่า เป็น make-up สำหรับเว็บไซต์ก็ได้นะ. ;)
+
+แต่เราไม่อยากเริ่มใหม่ตั้งแต่ต้นอีกครั้งใช่ไหม? เราจะใช้สิ่งที่โปรแกรมเมอร์ปล่อยออกมาบนอินเทอร์เน็ตฟรี การสร้างล้อใหม่ไม่สนุกคุณก็รู้
+
+## Bootstrap คือคำตอบ!
+
+Bootstrap เป็นหนึ่งใน frameworks ภาษา HTML และ CSS ที่ได้รับความนิยมอย่างสูงสำหรับการพัฒนาเว็บไซด์ให้สวยงาม: http://getbootstrap.com/
+
+มันถูกเขียนโดยเหล่าโปรแกรมเมอร์ที่เคยทำงานให้กับ Twitter และตอนนี้ได้ถูกพัฒนาต่อโดยอาสาสมัครจากทั่วทุกมุมโลก!
+
+## ติดตั้ง Bootstrap
+
+การติดตั้ง Bootstrap คุณต้องเพิ่มสิ่งนี้ `<head>`ในไฟล์ `.html` ของคุณ:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+มันจะไม่เพิ่ม files ใดๆที่โปรเจคของคุณ มันแค่ทำหน้าที่ชี้ไปยัง files ที่มีอยู่แล้วบนอินเตอร์เน็ด ก็ดำเนินการต่อไป เปิดเว็บไซด์ของคุณและรีเฟรช หน้าตาจะเป็นอย่างนี้ แท้เด้มมมม
+
+![รูปที่ 14.1](images/bootstrap1.png)
+
+ดูดีขึ้นแล้ว!
+
+## Static files ใน Django
+
+ในที่สุดเราก็จะได้ดูสิ่งที่เราเรียกกันว่า **static file** Static files คือ ไฟล์บรรจุ CSS และ รูปภาพต่างๆ ของคุณทั้งหมด Their content doesn't depend on the request context and will be the same for every user.
+
+### แล้วจะเราเก็บไฟล์ static ไว้ที่ไหนสำหรับ Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+เราสามารถทำแบบนั้นได้โดยสร้างโฟลเดอร์ชื่อ `static` ข้างในแอป blog:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## ไฟล์ CSS แรกของคุณ!
+
+Let's create a CSS file now, to add your own style to your web page. สร้างไดเรกทอรีชื่อ `css` ข้างในไดเรกทอรี `static` ของคุณ จากนั้นสร้างไฟล์ใหม่ชื่อ `blog.css` ข้างในไดเรกทอรี `css` เมื่อสักครู่ พร้อมหรือยัง?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+ได้เวลาเขียน CSS กันแล้ว! เปิดไฟล์ `blog/static/css/blog.css` ด้วยตัวแก้ไขโค้ดของคุณ
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+แต่ตอนนี้เราจะลองตกแต่งสักเล็กน้อย บางทีเราอาจจะลองเปลี่ยนสีข้อความส่วนหัวของเรา? การจะเข้าใจสีนั้น คอมพิวเตอร์จะใช้รหัสพิเศษ These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. คุณอาจใช้ [สีที่กำหนดไว้แล้ว](http://www.w3schools.com/colors/colors_names.asp) เช่น `red` และ `green`.
+
+ในไฟล์ `blog/static/css/blog.css` ของคุณ ควรเพิ่มโค้ดต่อไปนี้ลงไป:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` คือการเลือกโดย CSS This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. ในกรณีนี้ คือการบอกว่า เราต้องการให้เปลี่ยนสีให้เป็นรหัส `#FCA205` ซึ่งคือสีส้มนั่นเอง แน่นอนว่าคุณสามารถเปลี่ยนเป็นสีที่คุณต้องการได้นะ!
+
+ในไฟล์ CSS เราจะกำหนดลักษณะรูปแบบต่างๆ ให้กับองค์ประกอบที่อยู่ในไฟล์ HTML The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. class และ id คือชื่อที่คุณตั้งให้กับองค์ประกอบในหน้าเว็บเอง class กำหนดกลุ่มขององค์ประกอบ และ id ระบุไปยังองค์ประกอบที่จำเพาะเจาะจง For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. ตรงนี้เราบอก tempate ไปว่าจะหาไฟล์ CSS ของเราได้จากที่ไหน
+
+ตอนนี้ ไฟล์ของคุณควรมีหน้าตาแบบนี้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+โอเค บันทึกไฟล์และโหลดหน้าเว็บอีกครั้ง!
+
+![รูปที่ 14.2](images/color2.png)
+
+คุณเก่งมาก! บางทีเราอาจต้องการให้เว็บของเรามีพื้นที่ส่วนขอบด้านซ้ายสักเล็กน้อยไหม? ลองนี่!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![รูปที่ 14.3](images/margin2.png)
+
+บางที เราอยากจะปรับแต่งแบบอักษรในส่วนหัวของเรา? ลองเพิ่มบรรทัดนี้ใน `<head>` ในไฟล์ `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![รูปที่ 14.3](images/font.png)
+
+ดีงาม!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+มาตั้งชื่อให้กับบางส่วนในโค้ด HTML กัน เพิ่ม class ชื่อ `page-header` ให้กับ `div` ซึ่งมีส่วนหัวของโพสต์คุณ เช่น:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+และตอนนี้ เพิ่ม class `post` ให้กับ `div` ที่มีบล็อกโพสต์
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+เราจะเพิ่มส่วนประกาศ ที่จะใช้เลือกในแต่ละบล็อคที่เราได้กำหนด ตัวเลือกที่เริ่มต้นด้วยเครื่องหมายจุด `.` จะใช้กับการเลือก class There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. สำหรับตอนนี้ คัดลอกและวางลงในไฟล์ `blog/static/css/blog.css` ของคุณ:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+จากนั้นแทนที่โค้ด HTML ที่แสดงโพสต์ของเราด้วยโค้ดที่เราได้ทำกับปรับแต่งหน้าตา:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+ในไฟล์ `blog/templates/blog/post_list.html` ด้วยโค้ดนี้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+บันทึกไฟล์และโหลดหน้าเว็บอีกครั้ง
+
+![รูปที่ 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+พร้อมสำหรับบทต่อไปหรือยัง?! :)
\ No newline at end of file
diff --git a/th/deploy/README.md b/th/deploy/README.md
new file mode 100644
index 00000000000..1fff1b4b775
--- /dev/null
+++ b/th/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **หมายเหตุ** บทนี้อาจจะไม่ง่ายนักที่จะผ่านไปได้ ขอให้อดทนและทำให้เสร็จ; deployment เป็นส่วนสำคัญในกระบวนการพัฒนาเว็บไซต์ บทนี้อยู่ในครึ่งทางของบทเรียนทั้งหมด ดังนั้นผู้ช่วยของคุณจะพาคุณนำเว็บไซต์ออนไลน์โดยจะมีขั้นตอนยุ่งยากเล็กน้อย ซึ่งหมายความว่า ถึงคุณมีเวลาไม่พอ ก็จะยังสามารถจบบทนี้ได้แน่นอน
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying คือกระบวนการเผยแพร่โปรแกรมของคุณขึ้นสู่อินเทอร์เน็ต สุดท้ายแล้ว ทุกคนก็จะสามารถเห็นเว็บของคุณได. :)
+
+อย่างที่คุณได้ทราบ เว็บไซต์นั้นอาศัยอยู่ในเครื่องเซิร์ฟเวอร์ There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+มีบริการภายอื่นที่เราจะใช้เช่นกัน คือ [GitHub](https://www.github.com) ซึ่งเป็นบริการที่เก็บโค้ดของเรา จริงๆ ก็มีบริการจากที่อื่นเช่นกัน แต่โปรแกรมเมอร์เกือบทุกคนในตอนนี้มีบัญชี GitHub และคุณก็กำลังจะมีด้วยเช่นกัน!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## เริ่มต้นจาก Git repository
+
+Git ติดตามการเปลี่ยนแปลงของไฟล์เป็นชุด โดยเรียกชุดไฟล์เหล่านี้ว่า โค้ด repository (หรือสั้นๆ ว่า "repo") เริ่มจากโครงการของเรา เปิดคอนโซลของคุณ และรันคำสั่งต่อไปนี้ในไดเรกทอรี `djangogirls`:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. คุณควรอยู่ในโฟลเดอร์ `djangogirls`
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git จะติดตามการเปลี่ยนแปลงในทุกไฟล์และโฟลเดอร์ที่อยู่ภายในไดเรกทอรีนี้ แต่ก็จะมีบางไฟล์ที่เราไม่ต้องการให้ติดตาม สามารถทำได้โดยสร้างไฟล์ชื่อ `.gitignore` ในไดเรกทอรีบนสุด เปิดตัวแก้ไขไฟล์ และสร้างไฟล์ที่มีเนื้อหาดังนี้:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **หมายเหตุ** เครื่องหมายจุดนำหน้าชื่อไฟล์นั้นสำคัญมาก! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+ควรใช้คำสั่ง `git status` ก่อนที่จะใช้คำสั่ง `git add` หรือเมื่อใดก็ตามที่คุณไม่แน่ใจว่า มีการเปลี่ยนแปลงอะไรไปบ้าง This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+และสุดท้าย เราบันทึกการเปลี่ยนแปลง เปิดคอนโซลของคุณและใช้คำสั่ง:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. ลองไปดูกันว่าจริงไหม!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    เรามาเริ่มดึงโค้ดของเราจาก GitHub มายัง PythonAnywhere โดยการสร้าง "clone" ของ repo ของเรา Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. เราจะมาคุยกันต่อเกี่ยวกับไฟล์ static เร็วๆ นี้ เมื่อเราจะแก้ไข CSS สำหรับเว็บไซต์ของเรา
+
+กดปุ่ม **Save** และกลับไปยังแท็บ **Web**
+
+เรียบร้อยแล้ว! คลิกที่ปุ่มเขียวๆ ใหญ่ๆ **Reload** และคุณจะสามารถดูเว็บของคุณได้ คุณจะเห็นลิงค์ปรากฎอยู่บนสุดของหน้า
+
+## เคล็ดลับการ Debugging
+
+ถ้าคุณเห็นข้อผิดพลาดเกิดขึ้นเมื่อคุณเข้าดูหน้าเว็บ ที่แรกที่คุณควรตรวจสอบคือใน **error log** คุณจะเห็นลิงค์นี้บน แท็บ [Web tab](https://www.pythonanywhere.com/web_app_setup/) ใน PythonAnywhere หากมีข้อผิดพลาด ก็จะปรากฎที่นี่ โดยข้อผิดพลาดล่าสุดจะปรากฎอยู่ด้านล่าง ปัญหาที่พบบ่อยได้แก่:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- คุณใช้ Python เวอร์ชันเดียวกันกับทั้ง virtualenv และเว็บของคุณหรือไม่? ทั้งคู่ควรจะใช้ 3.6 เหมือนกัน
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+และอย่าลืม โค้ชของคุณช่วยคุณได้!
+
+# คุณกำลังออนไลน์!
+
+The default page for your site should say "It worked!", just like it does on your local computer. ลองเพิ่ม `/admin/` ต่อท้าย URL และคุณจะได้หน้า admin เข้าระบบด้วย username และ password และคุณจะสามารถเพิ่มโพสต์ใหม่ได้ บนเซิร์ฟเวอร์
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+ให้รางวัล *ใหญ่* กับตัวคุณเองหน่อย! การนำเว็บขึ้นบนเซิร์ฟเวอร์เป็นขั้นตอนที่ยุ่งยากในการพัฒนาเว็บไซต์ และ บางคนมักใช้เวลาสองสามวันกว่าจะเอาขึ้นได้ แต่คุณมีเว็บไซต์ที่พร้อมใช้ บนอินเตอร์เน็ตจริงๆ แล้วตอนนี้!
\ No newline at end of file
diff --git a/th/deploy/install_git.md b/th/deploy/install_git.md
new file mode 100644
index 00000000000..290a93b11c5
--- /dev/null
+++ b/th/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git คือ "version control system" ถูกใช้โดยโปรแกรมเมอร์จำนวนมาก ซอฟต์แวร์นี้สามารถติดตามการเปลี่ยนแปลงของไฟล์ในทุกช่วงเวลาเพื่อให้คุณสามารถย้อนกลับไปยังเวอร์ชันเก่าๆ ได้ในภายหลัง คล้ายกับฟีเจอร์ "track changes" ใน Microsoft Word แต่มีประสิทธิภาพมากกว่า
+
+## ติดตั้ง Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+คุณสามารถดาวน์โหลด Git ได้จาก [git-scm.com](https://git-scm.com/) You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). นอกเหนือจากนั้น ใช้ค่าเริ่มต้นก็โอเคแล้ว นั่นคือ Checkout Windows-style, commit Unix-style line endings
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+ดาวน์โหลด Git จาก [git scm.com](https://git-scm.com/) และทำตามคำคู่มือการติดตั้ง
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/th/deploy/signup_pythonanywhere.md b/th/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/th/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/th/django/README.md b/th/django/README.md
new file mode 100644
index 00000000000..3395de23668
--- /dev/null
+++ b/th/django/README.md
@@ -0,0 +1,27 @@
+# Django คืออะไร?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. มีส่วนประกอบต่างๆ ที่ช่วยให้คุณสามารถพัฒนาเว็บไซต์ได้อย่างรวดเร็วและง่าย
+
+เมื่อคุณสร้างเว็บไซต์, คุณมักจะต้องการส่วนประกอบที่ใช้บ่อยๆ เช่น วิธีจัดการจับผู้ใช้ (สร้างผู้ใช้ใหม่, เข้าระบบ, ออกจากระบบ), ตัวจัดการเว็บไซต์, ฟอร์ม, วิธีอัปโหลดไฟล์ และ อื่นๆ
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## ทำไมเราต้องการ framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+ลองจินตนาการถึงกล่องจดหมาย (พอร์ต) ซึ่งจดหมายที่เข้ามา​ (request) จะถูกตรวจสอบ ซึ่งตรงนี้ เว็บเซิร์ฟเวอร์เป็นคนจัดการ The web server reads the letter and then sends a response with a webpage. แต่ก่อนที่คุณจะส่ง คุณจำเป็นต้องมีเนื้อหาที่จะส่งไปก่อน ซึ่ง Django คือสิ่งที่จะช่วยคุณสร้างเนื้อหา
+
+## เกิดอะไรขึ้นเมื่อมีบางคนร้องขอหน้าเว็บจากเซิร์ฟเวอร์ของคุณ
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+ลองนึกถึงคนส่งจดหมายนางนึง นางจะเดินไปตามถนนแล้วก็ส่องดูบ้านเลขที่ในแต่ละบ้าน ถ้าตรงกัน นางก็จะหย่อนจดหมายลงไปให้ นี่คือวิธีที่ urlresolver ทำงานไงล่ะ!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. บางทีผู้ใช้ อาจจะอยากเปลี่ยนข้อมูลบางอย่างก็เป็นได้? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+แน่นอนว่าคำอธิบายข้างต้นฟังดูเหมือนง่าย แต่คุณไม่จำเป็นรู้รายละเอียดทางเทคนิคทั้งหมดหรอกนะ รู้ไอเดียทั่วๆ ไปก็เพียงพอแล้วล่ะ
+
+ดังนั้น แทนที่เราจะลงลึกในรายละเอียดให้มากกว่านี้ เรามาสร้างบางอย่างด้วย Django แบบง่ายๆ และเราจะได้เรียนกรู้ส่วนที่สำคัญไปพร้อมๆ กันเลย!
\ No newline at end of file
diff --git a/th/django_admin/README.md b/th/django_admin/README.md
new file mode 100644
index 00000000000..dd5a92ce1a2
--- /dev/null
+++ b/th/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+อย่างที่คุณเห็น เรามีการ import (รวม) โมเดลโพสต์ที่เราได้ทำในบทที่แล้วมาด้วย การทำให้โมเดลของเราปรากฎในหน้า admin เราต้องทำการลงทะเบียนโมเดลของเรา โดยใช้ `admin.site.register(Post)`.
+
+เอาล่ะ มาดูกันว่าโมเดลโพสต์ของเราหน้าตาเป็นไง อย่าลืมรัน `python manage.py runserver` ในคอนโซลเพื่อเปิดใช้เว็บเซิร์ฟเวอร์ Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![หน้าล็อกอิน](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/th/django_forms/README.md b/th/django_forms/README.md
new file mode 100644
index 00000000000..b167270b0ff
--- /dev/null
+++ b/th/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Form
+
+สิ่งสุดท้ายที่เราต้องการทำในเว็บไซต์ของเราคือการสร้างส่วนที่เอาไว้แก้ไขบล็อกโพสต์ของเรา หน้า Django `admin` นั้น ก็เจ๋งดีอยู่หรอกนะ แต่ก็ปรับแต่งได้ค่อนข้างยากอยู่เหมือนกัน With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+สิ่งที่ดีอย่างหนึ่งของ Django form คือ เราสามารถเริ่มสร้างจากศูนย์เลย หรือสร้าง `ModelForm` ซึ่งจะบันทึกผลลัพธ์จากฟอร์มไปยังโมเดลของเราทันที
+
+นี่คือสิ่งที่เราต้องการจะทำ: เราจะสร้างฟอร์มจากโมเดล `Post` ของเรา
+
+เช่นเดียวกับทุกส่วนของ Django ฟอร์ม ก็มีไฟล์เป็นของตัวเอง คือ: `forms.py`.
+
+เราต้องสร้างไฟล์นี้ภายในไดเรกทอรี `blog`
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+ก่อนอื่น เราต้องนำเข้า Django form เสียก่อน(`from django import forms`) และแน่นอน โมเดล `Post` ของเรา (`form .models import Post`).
+
+`PostForm` ใช่อย่างที่คุณสงสัยนั่นแหละ, ชื่อฟอร์มของเรานั่นเอง We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+ถัดมา เรามี `class Meta` ที่ซึ่งเราจะบอก Django ว่าฟอร์มนี้ จะใช้โมเดลอะไร (`model = Post`).
+
+สุดท้าย เราสามารถบอกได้ว่า เราจะใช้ฟิลด์ไหนบ้างในฟอร์มของเรา In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+และนั่นแหละ! ที่เราต้องทำตอนนี้คือใช้ฟอร์มข้างใน *view* และแสดงมันออกมาใน template
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## ลิงค์ไปยังหน้าเว็บด้วยฟอร์ม
+
+ได้เวลาเปิดไฟล์ `blog/templates/blog/base.html` เราจะเพิ่มลิงค์ใน `div` ชื่อ `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+หลังจากบันทึกไฟล์ และโหลดหน้าเว็บ http://127.0.0.1:8000 อีกครั้ง คุณจะเจอกับข้อผิดพลาด `NoReverseMatch`, คุ้นๆ ไหม?
+
+## URL
+
+เปิดไฟล์ `blog/urls.py` และเพิ่มบรรทัดนี้:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+โค้ดสุดท้ายจะมีหน้าตาแบบนี้:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+ได้เวลาเปิดไฟล์ `blog/views.py` และเพิ่มบรรทัดเหล่านี้ลงไปพร้อมกับ `form`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+การสร้างฟอร์ม `Post` ใหม่, เราต้องเรียกใช้ `PostForm()` และส่งไปให้ template We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+เราต้องสร้างไฟล์ `post_edit.html` ในไดเรกทอรี `blog/templates/blog`, ในการสร้างฟอร์มนั้น เราต้องการสองสามอย่าง:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. ซึ่งส่วนี้สำคัญมาก เพราะมันทำให้ฟอร์มของคุณปลอดภัยขึ้น! If you forget about this bit, Django will complain when you try to save the form:
+
+![หน้า CSFR Forbidden](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+ได้เวลาโหลดหน้าใหม่อีกครั้ง! เย้! ฟอร์มของคุณปรากฎขึ้นมาแล้ว!
+
+![ฟอร์มใหม่](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+คำตอบคือ: ไม่มีอะไรผิดหรอก เราต้องทำเพิ่มเติมเล็กน้อยใน *view*.
+
+## บันทึกฟอร์ม
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? ข้อมูลทั้งหมดจากฟอร์มตอนนี้คือใน `request.POST` เราไม่ควรเปลี่ยนชื่อ `POST` ไปเป็นอย่างอื่น (มีอีกหนึ่งค่าที่ใช้ได้สำหรับ `method` คือ `GET`, แต่เราไม่มีเวลาพอที่จะอธิบายความแตกต่างในตอนนี้)
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. ดังนั้น เราต้องเพิ่มเงื่อนไขเหล่านี้ (เราจะใช้ `if` ในการจัดการ):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+เราตรวจสอบฟอร์ม ถ้าฟอร์มถูกต้อง เราก็สามารถบันทึกได้!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+โดยทั่วไป เรามีสองสิ่งตรงนี้: เราบันทึกฟอร์มด้วย `form.save` และเราเพิ่มผู้เขียน (ซึ่งเราไม่มี `author` ในฟอร์ม `PostForm` และข้อมูลส่วนนี้นั้นจำเป็นต้องม). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. ยังจำได้ไหมที่ *view* นั้นต้องการตัวแปร `pk` ? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+มาดูกันว่าทำงานถูกต้องไหม Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+เจ๋งไปเลย!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. ตรงนี้จะแก้ไขปัญหาได้ชั่วคราว ซึ่งการแก้ปัญหานี้แบบถาวร รอคุณอยู่ในบท **การบ้าน: เพิ่มความปลอดภัยให้เว็บคุณ!** หลังจากจบบทเรียนหลักนี้แล้ว
+
+![เข้าระบบผิดพลาด](images/post_create_error.png)
+
+## Form validation
+
+ตอนนี้ เราจะแสดงให้คุณได้เห็นถึงความเจ๋งของฟอร์ม Django บล็อกโพสต์ของเราต้องการข้อมูล `title` และ `text` In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## การแก้ไขฟอร์ม
+
+ตอนนี้คุณทราบวิธีเพิ่มฟอร์มใหม่แล้ว แต่ถ้าเกิดคุณยังแก้ไขของเดิมที่มีอยู่แล้วล่ะ? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+เปิดไฟล์ `blog/urls.py` และเพิ่มบรรทัดนี้:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+เราจะนำ template `blog/templates/blog/post_edit.html` มาใช้อีกครั้ง ดังนั้นสิ่งที่ขาดไปสิ่งสุดท้ายคือ *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+หน้าตาเกือบจะเหมือนกับ view `post_new` ของเราเลยว่าไหม? แต่ไม่ใช่ทั้งหมด For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![ปุ่มแก้ไข](images/edit_button2.png)
+
+เมื่อคุณคลิกมัน คุณจะเห็นฟอร์มพร้อมข้อมูลของโพสต์เรา:
+
+![การแก้ไขฟอร์ม](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+ยินดีด้วย! แอพของคุณใกล้จะเสร็จเข้าไปทุกทีแล้ว!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## ความปลอดภัย
+
+การสร้างโพสต์ใหม่โดยแค่คลิกที่ลิงค์นั้น มันสุดยอดมาก! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+ในไฟล์ `blog/templates/blog/base.html` ตรงส่วน `page-header` `div` ควรมีหน้าตาแบบนี้:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! เปลี่ยน tag `<a>` ให้มีหน้าตาแบบนี้:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. นี่เป็นขั้นแรกในการป้องกันการสร้างโพสต์ใหม่เท่านั้น ยังมีส่วนอื่นที่เราต้องทำเพิ่มเติม เราจะอธิบายเรื่องความปลอดภัยในบทเสริมถัดไป
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## มีอีกอย่างนึง: ได้เวลาเอาขึ้นเซิร์ฟเวอร์!
+
+มาดูกันว่า มันจะทำงานได้บน PythonAnywhere ไหม ได้เวลาเอาขึ้นแล้ว!
+
+* อย่างแรก บันทึกโค้ดใหม่ของคุณ และส่งไปเก็บไว้ที่ Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* ต่อมา ในคอนโซล [PythonAnywhere Bash](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* สุดท้าย เปิด [Web tab](https://www.pythonanywhere.com/web_app_setup/) และกด **Reload**.
+
+และนั่นควรเสร็จแล้ว! ยินดีด้วย :)
\ No newline at end of file
diff --git a/th/django_installation/README.md b/th/django_installation/README.md
new file mode 100644
index 00000000000..8773833cbd5
--- /dev/null
+++ b/th/django_installation/README.md
@@ -0,0 +1,7 @@
+# การติดตั้ง Django
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/th/django_installation/instructions.md b/th/django_installation/instructions.md
new file mode 100644
index 00000000000..a7dd4de63be
--- /dev/null
+++ b/th/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. บทเรียน django-marcador เป็นลิขสิทธิ์ของ Markus Zapke-Gründemann
+
+## สภาพแวดล้อมเสมือน
+
+ก่อนที่เราจะติดตั้ง Django เราจะให้คุณติดตั้งเครื่องมีที่มีประโยชน์สุดๆ ตัวนึงก่อน ซึ่งช่วยให้คุณมีสภาพแวดล้อมในการทำงานที่ไม่รบกวนระบบหลักของคุณ คุณจะข้ามขั้นตอนนี้ไปก็ได้นะ แต่เราขอแนะนำอย่างแรง การทำสิ่งนี้จะช่วยให้คุณเจอปัญหาน้อยที่สุดภายในอนาคตอันใกล้นี้!
+
+เอาล่ะ มาสร้าง **สภาพแวดล้อมเสมือน** กัน (เรียกว่า *virtualenv*). Virtualenv จะช่วยแยกสภาพแวดล้อมของ Python/Django ออกจากระบบหลัก ซึ่งหมายความว่า ขณะที่คุณกำลังสร้างเว็บไซต์ จะไม่มีผลกระทบกับระบบอื่นๆ ที่กำลังพัฒนาอยู่ เจ๋งใช่ไหมล่ะ?
+
+ทั้งหมดที่คุณต้องการคือ หาไดเรกทอรีที่คุณต้องการจะสร้าง `virtualenv`; เช่น ไดเรกทอรี home เป็นต้น On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+สำหรับบทเรียนนี้ เราจะใช้ไดเรกทอรีใหม่ ชื่อ `djangogirls` ภายในไดเรกทอรี home ของคุณ
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+เราจะสร้าง virtualenv เรียกว่า `myvenv` คำสั่งทั่วไปจะอยู่ในรูปแบบ:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. คุณใช้ชื่ออื่นได้นะ แต่ขอแค่ให้ใช้ตัวพิมพ์เล็กไม่มีช่องว่าง, หรืออักขระพิเศษเป็นพอ It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` คือชื่อ `virtualenv` ของคุณ คุณใช้ชื่ออื่นได้นะ แต่ขอให้ใช้ตัวพิมพ์เล็กไม่มีช่องว่างหรืออักขระพิเศษเป็นพอ It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> การแก้ปัญหา, ให้ใช้คำสั่ง `virtualenv` แทน
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## การทำงานกับ virtualenv
+
+คำสั่งข้างต้น จะสร้างไดเรกทอรีชื่อ `myvenv` (หรือชื่อที่คุณเลือก) ข้างในจะมีสภาพแวดล้อม (โดยทั่วไป จะมีทั้งไดเรกทอรีและไฟล์จำนวนนึง)
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+เริ่มใช้สภาพแวดล้อมเสมือน โดยใช้คำสั่ง:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+เริ่มใช้สภาพแวดล้อมเสมือน โดยใช้คำสั่ง:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+อย่าลืมแทนที่ `myvenv` ด้วยชื่อ `virtualenv` ที่คุณได้สร้างไว้!
+
+> **หมายเหตุ:** บางครั้งคำสั่ง `source` จะไม่มีให้ใช้ ในกรณีนี้ให้ทำคำสั่งนี้แทน:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+เมื่อทำงานกับสภาพแวดล้อมเสมือน `python` จะอ้างถึงเวอร์ชันที่ถูกต้องให้ ซึ่งจะทำให้คุณใช้คำสั่ง `python` แทนคำสั่ง `python3` ได้เลย.
+
+โอววเคย์ ในที่สุดตอนนี้เราพร้อมที่ติดตั้ง Django กันแล้ว!
+
+## การติดตั้ง Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> ถ้าเกิด error ตอนรันคำสั่ง pip บน Ubuntu 12.04 ให้ลองใช้คำสั่ง `python -m pip install -U --force-reinstall pip` เพื่อแก้ไข
+
+<!--endsec-->
+
+นั่นล่ะ! ตอนนี้คุณก็พร้อม(สักที)ที่จะสร้าง Django application แล้ว!
\ No newline at end of file
diff --git a/th/django_models/README.md b/th/django_models/README.md
new file mode 100644
index 00000000000..4cdae74de93
--- /dev/null
+++ b/th/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+สิ่งที่เราจะสร้างต่อไปคือ สิ่งที่เราไว้เก็บโพสต์ทั้งหมดในบล็อกของเรา แต่การที่จะทำแบบนั้นเราจะมาทำความรู้จักกับสิ่งหนึ่งที่เรียกว่า `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+แล้ว วัตถุ คืออะไร? มันคือชุดของคุณสมบัติและการกระทำ อาจจะฟังดูแปลกๆ แต่เรากำลังจะอธิบายคุณด้วยตัวอย่างนี้
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+ไอเดียนี้ถูกนำไปใช้ในการอธิบายสิ่งต่างๆ ภายในโค้ด ด้วย คุณสมบัติ (เรียกว่า `object properties`) และ การกระทำ (เรียกว่า `methods`).
+
+แล้วเราจะโมเดลโพสของบล็อกเราอย่างไร? เราต้องการสร้างบล็อก ถูกไหม?
+
+เราต้องตอบคำถามเหล่านี้เสียก่อน: บล็อกโพสต์คืออะไร? ควรมีคุณสมบัติอะไรบ้าง?
+
+แน่นอนว่า บล็อกของเราต้องการข้อความ ทั้งเนื้อหาและชื่อเรื่อง จริงไหม? It would be also nice to know who wrote it – so we need an author. สุดท้าย เราต้องการรู้ว่า โพสต์เราถูกสร้างและเผยแพร่เมื่อไหร่
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+มีอะไรบ้างที่เราต้องทำเกี่ยวกับบล็อกโพสต์? มันจะดีถ้าเรามี `method` สำหรับเผยแพร่โพสต์ จริงไหม?
+
+ดังนั้น เราต้องการ method `publish`
+
+ตอนนี้เรารู้แล้วว่าสุดท้ายเราต้องการอะไร เรามาเริ่มโมเดลใน Django กัน!
+
+## Django model
+
+การได้รู้ว่าวัตถุคืออะไรแล้ว เราสามารถสร้าง Django model สำหรับบล็อกโพสต์ของเรา
+
+A model in Django is a special kind of object – it is saved in the `database`. ฐานข้อมูล คือ ชุดของข้อมูล คุณจะเก็บข้อมูลของผู้ใช้ บล็อกโพสต์ของคุณ และอื่นๆ ลงที่นี่ เราจะใช้ฐานข้อมูล SQLite สำหรับเก็บข้อมูลของเรา This is the default Django database adapter – it'll be enough for us right now.
+
+คุณอาจจะคิดได้ว่า โมเดลในฐานข้อมูลคือ ตารางคำนวณที่มี คอลัมน์ (fields) และ แถว (ข้อมูล)
+
+### สร้าง application
+
+เพื่อความเป็นระเบียบเรียบร้อย เราจะสร้าง application ภายใน project ของเรา การจัดระเบียบตั้งแต่เริ่มต้น เป็นสิ่งที่ดีที่ควรทำ การสร้าง application เราต้องรันคำสั่งต่อไปนี้ในคอนโซลของเรา (จากในไดเรกทอรี `djangogirls` ที่มีไฟล์ `manage.py` อยู่ข้างใน):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### สร้างโมเดลของบล็อกโพสต์
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. รูปแบบนี้เป็นรูปแบบสากลในหมู่ผู้ใช้ Python บางทีก็เรียกพวกมันว่า "dunder" (ย่อมาจาก "double-underscore")
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` เป็นคำพิเศษ บ่งบอกว่าเรากำลังจะสร้างวัตถุ
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` บอกเราว่า Post คือ Django Model ดังนั้น Django รู้ว่ามันควรถูกบันทึงลงในฐานข้อมูล
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### สร้างตารางสำหรับโมเดลในฐานข้อมูลของคุณ
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/th/django_orm/README.md b/th/django_orm/README.md
new file mode 100644
index 00000000000..1ff8de1781b
--- /dev/null
+++ b/th/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM และ QuerySets
+
+ในบทนี้ คุณจะได้เรียนรู้การเชื่อต่อ Django กับ ฐานข้อมูล และเก็บข้อมูลลงในนั้น เริ่มกันเลย!
+
+## QuerySet คืออะไร?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+ใช้ตัวอย่างจะเห็นภาพกว่า มาลองดูกันเลยไหม?
+
+## Django shell
+
+เปิดคอนโซลบนเครื่องคุณ (ไม่ใช่บน PythonAnywhere) และใช้คำสั่งนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+ผลลัพธ์ควรเป็นดังนี้:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### วัตถุทั้งหมด
+
+ลองแสดงผลของทุกโพสต์กัน คุณสามารถทำได้โดยใช้คำสั่งต่อไปนี้:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### สร้างวัตถุ
+
+นี่คือวิธีการสร้างวัตถุโพสต์ใหม่ในฐานข้อมูล:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+นำเข้าโมเดล User ก่อน:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+เรามีผู้ใช้อยู่ในฐานข้อมูลไหมนะ? ลองนี่:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+ตอนนี้ เราก็สามารถสร้างโพสต์ของเราได้แล้ว:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+ฮูเร้! มาดูกัน ว่ามีอะไรเพิ่มมาบ้าง?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+มีโพสต์มากกว่าหนึ่งอันแล้ว!
+
+### เพิ่มโพสต์
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### ตัวกรองวัตถุ
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. เราจะใช้ `filter` แทน `all` ใน `Post.objects.all()` In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. ตอนนี้ ผลลัพธ์จากการกรองจะเป็นดังนี้:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **หมายเหตุ** มีขีดล่างสองอัน (`_`) ระหว่าง `title` และ `contains` Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+จากนั้น เผยแพร่โพสต์โดยใช้ method `publish` ของเรา:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### จัดเรียงวัตถุ
+
+QuerySet ให้คุณสามารถจัดเรียงรายการของวัตถุได้ มาลองเรียงลำดับตาม `created_date` กัน:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+เรายังสามารถกลับผลการจัดเรียงได้โดยเพิ่ม `-` ไว้ที่ด้านหน้า:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+นอกจากนี้คุณยังสามารถรวม QuerySet โดยการ **chaining** เข้าไว้ด้วยกัน:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+ตรงนี้มีประโยชน์มากๆ และช่วยให้คุณสร้าง query ที่ซับซ้อนได้
+
+แจ๋ว! คุณพร้อมสำหรับบทถัดไปแล้ว! ปิดคอนโซลโดย:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/th/django_start_project/README.md b/th/django_start_project/README.md
new file mode 100644
index 00000000000..cb40b65df7c
--- /dev/null
+++ b/th/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Django project แรก ของคุณ!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. บทเรียน django-marcador เป็นลิขสิทธิ์ของ Markus Zapke-Gründemann
+
+We're going to create a small blog!
+
+ขั้นตอนแรกคือการสร้าง Django project ใหม่ โดยทั่วไปแล้ว เราจะทำการเรียกใช้สคริปต์บางอย่างที่มาพร้อมกับ Django ซึ่งจะทำการสร้างโครงของ project Django ให้กับเรา ซึ่งประกอบไปด้วย ไฟล์และไดเรกทอรีจำนวนหนึ่งที่เราจะใช้ต่อไป
+
+บางชื่อในบางไฟล์และไดเรกทอรีนั้นสำคัญมากๆ สำหรับ Django และคุณไม่ควรเปลี่ยนชื่อไฟล์เหล่านั้น และการย้ายไฟล์เหล่านั้นไปยังที่อื่น ก็ไม่ใช่ความคิดที่ดีแน่ๆ Django นั้นต้องการโครงสร้างที่แน่นอน เพื่อที่จะสามารถหาสิ่งที่จำเป็นที่จะต้องใช้ได้
+
+> อย่าลืมที่จะรันทุกสิ่งอย่างภายใต้ virtualenv If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. เราอธิบายวิธีทำไว้แล้วในบท **การติดตั้ง Django** อยู่ในส่วนของ **การทำงานกับ virtualenv** Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> เครื่องหมายจุด `.` นี้ สำคัญ เพราะเป็นตัวบอกว่าให้ติดตั้ง Django ลงในไดเรกทอรีปัจจุบัน (ใช้เครื่องหมาย `.` เป็นการอ้างอิงถึงไดเรกทอรีปัจจุบันแบบลัด).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> เครื่องหมายจุด `.` นี้ สำคัญ เพราะเป็นตัวบอกว่าให้ติดตั้ง Django ลงในไดเรกทอรีปัจจุบัน (ใช้เครื่องหมาย `.` เป็นการอ้างอิงถึงไดเรกทอรีปัจจุบันแบบลัด).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` เป็นสคริปต์สำหรับสร้างไฟล์และไดเรกทอรีให้กับคุณ และตอนนี้คุณควรจะมีโครงสร้างไฟล์และไดเรกทอรีตามนี้:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+ไฟล์ `settings.py` ประกอบไปด้วยไฟล์ที่กำหนดค่าต่างๆ ในเว็บไซต์ของคุณ
+
+จำเกี่ยวกับคนส่งจดหมายได้ไหม? `urls.py` คือไฟล์ที่มีรายการรูปแบบที่ถูกนำไปใช้ใน `urlresolver`.
+
+ไฟล์อื่นๆ เราไว้ว่ากันทีหลัง สิ่งสำคัญตอนนี้คือ อย่าเผลอไปลบไฟล์พวกนี้เล่นล่ะ!
+
+## เปลี่ยนการตั้งค่า
+
+เรามาแก้ไขไฟล์ `mysite/settings.py` กัน เปิดไฟล์นี้ด้วยโปรแกรมแก้ไขโค้ดที่คุณติดตั้งไว้แล้ว
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+คงจะดีไม่น้อยถ้าเว็บของเรามีการตั้งค่าเวลาที่ถูกต้อง Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+มีซอฟต์แวร์ฐานข้อมูลจำนวนมากที่สามารถเก็บข้อมูลของเว็บคุณได้ เราจะใช้ฐานข้อมูลเริ่มต้น คือ `sqlite3`.
+
+ซึ่งได้ถูกตั้งค่าไว้เรียบร้อยแล้วในไฟล์ `mysite/settings.py` ของคุณ:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+การสร้งฐานข้อมูลสำหรับบล็อกของเรา เริ่มต้นด้วยการใช้คำสั่งต่อไปนี้ในคอนโซล: `python manage.py migrate` (เราจำเป็นต้องอยู่ไดเรกทอรี `djangogirls` ซึ่งมีไฟล์ `manage.py` อยู่ด้านใน) ถ้าทุกอย่างเป็นไปด้วยดี คุณจะเห็นผลคล้ายๆ แบบนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+เป็นอันเสร็จสิ้น! ได้เวลาเปิดเว็บเซิร์ฟเวอร์และดูว่าเว็บเราทำงานไหม!
+
+## Starting the web server
+
+คุณต้องอยู่ในไดเรกทอรีที่มีไฟล์ `manage.py` (ไดเรกทอรี `djangogirls` นั่นเอง) ในคอนโซล เราสามารถเริ่มต้นเว็บเซิร์ฟเวอร์โดยรันคำสั่ง `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+ถ้าคุณอยู่บนวินโดวส์ และเกิดข้อผิดพลาด `UnicodeDecodeError` ให้ใช้คำสั่งนี้แทน:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+ขอแสดงความยินดี! คุณเพิ่งสร้างเว็บแรกของคุณและรันมันบนเว็บเซิร์ฟเวอร์! เจ๋งไปเลยว่าไหม?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+พร้อมสำหรับขั้นถัดไปแล้ว? ถึงเวลาสร้างเนื้อในเว็บกันแล้ว!
\ No newline at end of file
diff --git a/th/django_templates/README.md b/th/django_templates/README.md
new file mode 100644
index 00000000000..a7a1f600d37
--- /dev/null
+++ b/th/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+ได้เวลาแสดงข้อมูลกันบ้างแล้ว! Django นั้นให้เครื่องมือที่ทำงานนี้ได้อย่างสะดวก นั้นคือ **template tags**
+
+## แล้วอะไรคือ template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## แสดง template รายการโพสต์
+
+ในบทที่แล้ว เราส่งรายการของโพสต์จากในตัวแปร `posts` ไปยัง template และตอนนี้เราจะแสดงรายการโพสต์ออกมาในรูปแบบ HTML
+
+การจะแสดงผลค่าตัวแปรใน Django template เราจะใช้วงเล็บก้ามปูสองอัน ที่มีชื่อตัวแปรอยู่ข้างใน แบบนี้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+ลองแก้ไขไฟล์ template `blog/templates/blog/post_list.html` แทนที่ทุกอย่างจาก `<div>` ที่สอง ไปจนถึง `</div>` ที่สาม โดยแทนที่ด้วย `{{ posts }}` บันทึกไฟล์และโหลดหน้าเว็บอีกครั้งเพื่อดูผลลัพธ์:
+
+![รูปที่ 13.1](images/step1.png)
+
+อย่างที่คุณเห็น เราได้ผลลัพธ์แบบนี้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+ตรงนี้หมายความว่า Django สามารถเข้าใจและรู้ว่านี่คือรายการวัตถุ ยังจำวิธีที่เราแสดงรายการจากในบท **แนะนำให้รู้จัก Python** ได้ไหม? ใช่แล้ว ใช้การวนลูปไง! ใน Django template เราสามารถทำแบบนี้ได้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+ลองแบบนี้ใน template ของคุณ
+
+![รูปที่ 13.2](images/step2.png)
+
+มันทำงานถูกต้อง! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. คุณสามารถผสมผสานการใช้ HTML กับ template tag ในส่วน `body` จะมีหน้าตาแบบนี้:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}ทุกสิ่งที่คุณใส่ไประหว่าง `{% for %}` และ `{% endfor %}` จะถูกทำซ้ำหลายรอบตามจำนวนวัตถุในรายการ โหลดหน้าเว็บอีกครั้ง:{% endraw %}
+
+![รูปที่ 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? เราเข้าถึงแต่ละข้อมูลที่ได้สร้างไว้ในโมเดล `Post` ของเรา Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## ส่วนสุดท้าย
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* อันดับแรก นำไฟล์ขึ้นไปที่ Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* จากนั้นไปที่ [PythonAnywhere](https://www.pythonanywhere.com/consoles/) และไปยังส่วน **Bash console** (หรือเปิดอันใหม่) และรันคำสั่ง:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* สุดท้าย ไปยัง [Web tab](https://www.pythonanywhere.com/web_app_setup/) และกดปุ่ม **Reload** บนเว็บของคุณ การแก้ไขของคุณจะปรากฎเป็นล่าสุดแล้ว! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+ยินดีด้วย! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![รูปที่ 13.4](images/donut.png)
\ No newline at end of file
diff --git a/th/django_urls/README.md b/th/django_urls/README.md
new file mode 100644
index 00000000000..9c4c821b678
--- /dev/null
+++ b/th/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## URL คืออะไร?
+
+URL นั้นคือที่อยู่ของเว็บ You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` ก็คือ URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+ทุกหน้าเว็บบนอินเทอร์เน็ต ต้องมี URL เป็นของตัวเอง This way your application knows what it should show to a user who opens that URL. ใน Django เราใช้สิ่งที่เรียกว่า `URLconf` (URL configuration) URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## URL ทำงานอย่างไรใน Django?
+
+ลองเปิดไฟล์ `mysite/urls.py` ขึ้นมาและดูว่าข้างในเป็นอย่างไร:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+คุณสงสัยไหมว่า Django จับคู่ URL เข้ากับ view ยังไง? ตรงนี้จะซับซ้อนนิดหน่อย Django ใช้ `regex` ย่อมาจาก "regular expressions" Regex มีกฎที่มากมาย (มากมายจริงๆ!) ที่ใช้เป็นรูปแบบในการค้นหา เนื่องจาก regexe เป็นหัวข้อขั้นสูง เราจะไม่ลงรายละเอียดมากนัก
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+การเขียนหน้า view สำหรับทุกหมายเลขโพสต์ คงจะทำให้น่ารำคาญมาก With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** หมายความว่า ตรงนี้ต้องเป็นตัวเลข (หนึ่งตัวหรือมากกว่า) และเราต้องการหมายเลขนี้แหละ
+* **/** บอก django ว่ามี `/` ต่อท้ายอีกอัน
+* **$** บ่งบอกถึงจุดสิ้นสุดของ URL หมายถึงว่า url ต้องลงท้ายด้วย `/` เท่านั้นถึงจะตรงกับรูปแบบนี้
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+ไฟล์ `mysite/urls.py` ของคุณควรมีหน้าตาดังนี้:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django จะจัดการทุกคำร้องขอที่เข้ามาที่ 'http://127.0.0.1:8000/' ไปยัง `blog.urls` และดูว่าจะทำอะไรต่อจากนี้
+
+Writing regular expressions in Python is always done with `r` in front of the string. ซึ่งเป็นประโยชน์กับ Python เพราะอาจจะมีอักขระพิเศษที่มีผลกับ regular expression
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+ต่อมา เราจะเพิ่มรูปแบบ URL ของเรา:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. ซึ่งถูกต้อง เพราะ Django ประมวลดูว่า URL 'http://127.0.0.1:8000/' นั้นไม่ใช่ส่วนหนึ่งของ URL รูปแบบนี้จะบอก Django ว่า `views.post_list` คือที่ๆ ต้องมาดู เมื่อมีใครสักคนเข้ามายังหน้า 'http://127.0.0.1:8000/'
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. ตรงนี้สามารถใช้ชื่อเดียวกันกับ view ได้ แต่ก็ยังคงเป็นสิ่งที่แตกต่างกันอย่างสิ้นเชิงได้เช่นกัน We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![ข้อผิดพลาด](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> หากคุณต้องการข้อมูลเพิ่มเติมเกี่ยวกับ Django URLconf คุณสามารถดูได้ที่หน้าเอกสารของโครงการ Django: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/th/django_views/README.md b/th/django_views/README.md
new file mode 100644
index 00000000000..294cc741875
--- /dev/null
+++ b/th/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+ได้เวลาแก้บั๊กในบทก่อนหน้านี้แล้ว! :)
+
+*view* คือส่วนที่เราใส่ "logic" ของโปรแกรมของเรา โดยจะขอข้อมูลจาก `model` ที่คุณสร้างก่อนหน้านี้และส่งไปยัง `template` เราจะสร้าง template ในบทถัดไป Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+view จะอยู่ในไฟล์ `views.py` เราจะเพิ่ม *view* ของเราลงในไฟล์ `blog/views.py`
+
+## blog/views.py
+
+โอเค เปิดไฟล์นี้ขึ้นมาดูว่ามีอะไรข้างใน:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+เกิดข้อผิดพลาดอีกแล้ว! ลองอ่านดูว่าเกิดไรขึ้นตอนนี้:
+
+![ข้อผิดพลาด](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> ข้อมูลเพิ่มเติมเกี่ยวกับ Django view สามารถดูได้ที่หน้าเอกสารของโครงการ Django: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/th/dynamic_data_in_templates/README.md b/th/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..123875244be
--- /dev/null
+++ b/th/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# ข้อมูลแบบ dynamic ใน template
+
+ตอนนี้ เรามีชิ้นส่วนต่างๆ คือ: โมเดล `Post` ที่กำหนดไว้ในไฟล์ `models.py` มี `post_list` ใน `views.py` และ template แต่เราจะทำยังไงให้โพสต์ของเราปรากฎใน HTML template ของเรา? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+และนี่คือสิ่งที่ *view* จะจัดการ: เชื่อมโมเดลและ template เข้าด้วยกัน In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+ตอนนี้เราจะเปิดไฟล์ `blog/views.py` ตอนนี้ *view* `post_list` จะมีหน้าตาแบบนี้:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+ยังจำตอนที่เราคุยกันเกี่ยวกับการนำเข้าโค้ดที่เขียนอยู่ในไฟล์อื่นได้ไหม? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). จากนั้นเราก็นำเข้าชื่อของโมเดล (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+จำไว้ว่าตอนนี้เราได้สร้าง *ตัวแปร* สำหรับ QuerySet ของเรา: นั่นคือ `posts` คิดซะว่าเป็นชื่อ QuerySet ของเรา และเราจะใช้ชื่อนี้ในการอ้างถึงในครั้งหน้า
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. เราต้องตั้งชื่อให้กับค่าเหล่านั้น (เราจะใช้ชื่อ `'posts'` ในตอนน). :) ผลลัพธ์ควรมีหน้าตาแบบนี้: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+สุดท้าย ไฟล์ `blog/views.py` ของเราจะมีหน้าตาแบบนี้:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+เรียบร้อย! ถึงเวลาที่จะกลับไปยัง template ของเรา และแสดงผล QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/th/extend_your_application/README.md b/th/extend_your_application/README.md
new file mode 100644
index 00000000000..63ccfa61472
--- /dev/null
+++ b/th/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# เพิ่มความสามารถให้เว็บคุณ
+
+เราได้เรียนรู้ขั้นตอนทั้งหมดในการสร้างเว็บไซต์แล้ว: เรารู้วิธีสร้าง โมเดล, url, view และ template รวมถึงการทำให้เว็บเราสวยงามขึ้น
+
+ได้เวลาฝึกแล้ว!
+
+สิ่งแรกที่เราต้องการสำหรับบล็อกของเราคือ หน้าเว็บที่จะแสดงโพสต์หนึ่งโพสต์ของเรา ถูกไหม?
+
+ซึ่งเรามีโมเดล `Post` แล้ว ดังนั้น เราไม่จำเป็นต้องเพิ่มอะไรลงไปใน `models.py`.
+
+## สร้าง template ที่แสดงหน้ารายละเอียดของโพสต์
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}เราต้องการที่จะมีลิงค์ที่ชื่อของโพสต์ในหน้ารายการโพสต์ เพื่อไปยังหน้ารายละเอียดของโพสต์ เปลี่ยนบรรทัด `<h1><a href="">{{ post.title }}</a></h1>` ให้เป็นแบบนี้:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}ได้เวลาอธิบายบรรทัดเหล่านี้แล้ว `{% url 'post_detail' pk=post.pk %}` คุณอาจสงสัยสัญลักษณ์ `{% %}` นี้ ซึ่งก็คือ เรากำลังใช้ template tag ของ Django ตอนนี้เราจะใช้เพื่อสร้าง URL ให้กับเรา!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## สร้าง URL สำหรับ รายละเอียดโพสต์
+
+สร้าง URL ไฟล์ `urls.py` สำหรับ `post_detail` *view* ของเรา!
+
+เราต้องการให้รายละเอียดของโพสต์แรกของเรา แสดงโดยการเข้าถึง **URL**: http://127.0.0.1:8000/post/1/
+
+เรามาสร้าง URL ในไฟล์ `blog/urls.py` ให้ชี้ Django ไปยัง *view* ชื่อ `post_detail`, ซึ่งจะแสดงหน้าโพสต์ Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. ตอนนี้ ไฟล์ของคุณควรมีหน้าตาแบบนี้:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. มันหมายถึง Django จะรับข้อมูลเข้ามา และส่งต่อไปยัง view โดยผ่านตัวแปรชื่อ `pk` (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` หมายถึง ต้องมีตัวเลขอย่างน้อยหนึ่งหลัก So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+นั่นคือ ถ้าคุณป้อน `http://127.0.0.1:8000/post/5/` มายังเบราว์เซอร์ของคุณ Django จะเข้าใจว่าคุณกำลังมองหา *view* ชื่อ `post_detail` และส่งข้อมูลคือ `pk` ซึ่งมีค่าเท่ากับ `5` ไปยัง *view* นั้น.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+คุณยังจำขั้นตอนถัดไปได้ไหม? แน่นอน: เพิ่ม view ใหม่!
+
+## เพิ่ม view รายละเอียดของโพสต์
+
+This time our *view* is given an extra parameter, `pk`. *view* ของเราต้องจับมันไว้ ใช่ไหม? ดังนั้นเราจะสร้างฟังก์ชันใหม่ โดยใช้ `def post_detail(request, pk):` สังเกตว่าเราต้องใช้ชื่อเดียวกันกับชื่อที่เรากำหนดไว้ใน url (`pk`) การละเว้นตัวแปรนี้ จะทำให้เกิดขึ้นผิดพลาด!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+เราไม่ต้องการแบบนี้! แต่ แน่ล่ะ Django มาพร้อมกับสิ่งที่สามารถจัดการปัญหานี้ได้: `get_object_or_404` In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+ข่าวดีคือ คุณสามารถสร้างหน้า `Page not found` เป็นของคุณเองได้ และทำให้สวยแค่ไหนก็ได้ตามแต่คุณต้องการ แต่ตอนนี้ยังไม่จำเป็นเท่าไหร่นัก เราจะขอข้ามไปก่อน
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+ได้เวลาโหลดหน้าเว็บนี้ใหม่: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+ใช้ได้แล้ว! แต่ เกิดอะไรขึ้นเมื่อคุณคลิกที่ลิงค์บนชื่อโพสต์?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+โอ้ ไม่นะ! ข้อผิดพลาดอีกแล้ว! แต่เรารู้วิธีรับมือปัญหานี้แล้ว ถูกไหม? เราต้องเพิ่ม template ไงล่ะ!
+
+## Create a template for the post details
+
+เราจะสร้างไฟล์ใน `blog/templates/blog` ชื่อ `post_detail.html`.
+
+ผลลัพธ์จะคล้ายนี้:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+เป็นอีกครั้งที่เรา extend ไฟล์ `base.html` ใน block `content` เราต้องการแสดง published_date ของโพสต์ (ถ้ามี), ชื่อโพสต์ และ เนื้อหา แต่เราควรจะมาคุยกันถึงเรื่องสำคัญอีกอย่างก่อน ดีไหม?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+เย้! ใช้ได้แล้ว!
+
+## มีอีกอย่างนึง: ได้เวลาเอาขึ้นเซิร์ฟเวอร์!
+
+มันคงจะดี ถ้าเราจะดูหน้าเว็บของเราทำงานอยู่บน PythonAnywhere อีกครั้ง ใช่ไหม? มา deploy กันอีกครั้ง
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+ต่อมา ในคอนโซล [PythonAnywhere Bash](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+สุดท้าย เปิด [Web tab](https://www.pythonanywhere.com/web_app_setup/) และกด **Reload**.
+
+และนั่นควรเสร็จแล้ว! ยินดีด้วย :)
\ No newline at end of file
diff --git a/th/how_the_internet_works/README.md b/th/how_the_internet_works/README.md
new file mode 100644
index 00000000000..1286a44f469
--- /dev/null
+++ b/th/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# อินเทอร์เน็ตทำงานอย่างไร
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+สิ่งแรกที่คุณควรรู้คือ เว็บไซต์นั้นเป็นเพียงชุดของไฟล์ที่ถูกบันทึกอยู่ในฮาร์ดดิสก์ เช่นเดียวกับไฟล์ภาพยนต์ เพลง หรือรูปภาพ แต่สิ่งที่ทำให้เว็บไซต์นั้นต่างออกไปคือ: เว็บไซต์มีการรวมรหัสคอมพิวเตอร์ไปด้วย ซึ่งเรียกว่า HTML
+
+หากคุณไม่คุ้นเคยกับการเขียนโปรแกรมเลย อาจจะยากสักหน่อยที่จะเข้าใจ HTML ในครั้งแรก แต่เว็บเบราว์เซอร์ของคุณนั้น​ (เช่น Chrome, Safari, Firefox และอื่นๆ) รักมันเลยล่ะ เว็บเบราว์เซอร์ถูกออกแบบมาเพื่อทำความเข้าใจรหัสเหล่านี้ ทำตามคำสั่งและแสดงผลจาไฟล์เว็บไซต์ของคุณ ให้ตรงกับสิ่งที่คุณต้องการ
+
+เช่นเดียวกับไฟล์ทุกไฟล์ เราต้องการเก็บไฟล์ HTML ลงบนฮาร์ดดิสก์ สำหรับอินเทอร์เน็ตนั้น เราใช้เครื่องคอมพิวเตอร์พิเศษ และทรงพลัง เรียก่วา *servers* คอมพิวเตอร์เหล่านี้ ไม่มีหน้าจอ เมาส์ หรือแป้นพิมพ์ เพราะหน้าที่หลักคือการเก็บข้อมูลและให้บริการข้อมูลเหล่านี้ That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+เราวาดรูปมาให้คุณ! และมันหน้าตาแบบนี้:
+
+![รูปที่ 1.1](images/internet_1.png)
+
+ดูยุ่งเหยิง ไม่เป็นระเบียบ ใช่ไหม? In fact it is a network of connected machines (the above-mentioned *servers*). นับแสนเครื่อง! สายเคเบิ้ลไกลหลายกิโลเมตรทั่วโลก! คุณสามารถไปชมแผนที่เคเบิ้ลใต้น้ำได้ที่ (http://submarinecablemap.com) เพื่อดูว่าซับซ้อนขนาดไหน นี่เป็นภาพตัวตัวอย่างจากเว็บข้างต้น:
+
+![รูปที่ 1.2](images/internet_3.png)
+
+น่าสนใจใช่ไหม? แต่แน่นอนว่า มันไม่ได้เชื่อมกันระหว่างทุกเครื่องที่เชื่อมต่ออินเทอร์เน็ตหรอก So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+หน้าตาประมาณนี้:
+
+![รูปที่ 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+จดหมายของคุณส่งไปยังที่ไปรษณีย์ใกล้บ้านคุณ และมันก็ถูกส่งต่อไปยังที่อื่นที่อยู่ห่างบ้านคุณไปนิดหน่อย และส่งไปเรื่อยๆ ไปเรื่อยๆ จนกระทั่งถึงปลายทาง สิ่งที่เป็นเอกลักษณ์คือ ถ้าคุณส่งจดหมายจำนวนมาก (*data packets*) ไปยังที่เดิม จดหมายเหล่านั้นจะถูกส่งต่อไปยังไปรษณีย์อื่นๆ (*routers*) ที่แตกต่างกันโดยสิ้นเชิง ขึ้นกับว่าพวกเขากระจายแต่ละสำนักงานยังไง
+
+![รูป 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+แทนที่จะเป็นที่อยู่ ชื่อถนน ชื่อเมือง รหัสไปรษณีย์และชื่อประเทศ เราจะใช้ที่อยู่ IP แทน เครื่องคอมของคุณจะถามไปยัง DNS (Domain Name System) ที่จะแปลงชื่อ djangogirls.org ไปเป็นที่อยู่ IP ก่อน It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. คุณใช้ภาษาที่ผู้รับจดหมายเข้าใจด้วย ถูกไหม? เช่นเดียวกันกับ *data packets* ที่ส่งไปเพื่อขอดูเว็บไซต์ เราใช้กระบวนการหรือ protocol ที่เรียกว่า HTTP (Hypertext Transfer Protocol)
+
+ดังนั้น โดยทั่วไป หากคุณมีเว็บไซต์ คุณต้องมี *server* (เครื่อง) ที่เก็บเว็บไซต์ เมื่อ *server* ได้รับ *request* เข้ามา (มีจดหมายส่งมา) มันจะส่งเว็บไซต์กลับไป (จดหมายตอบกลับ)
+
+Since this is a Django tutorial, you might ask what Django does. เมื่อคุณต้องการตอบกลับ คุณไม่จำเป็นต้องส่งข้อมูลที่เหมือนๆ กัน ไปยังทุกคน มันจะดีกว่ามาก ถ้าจดหมายของคุณนั้นส่งไปในรูปแบบส่วนบุคคล โดยเฉพาะอย่างยิ่งสำหรับคุณที่เขียนถึงคุณ ถูกไหม? Django ช่วยคุณสร้างสิ่งเหล่านั้น ทำให้เป็นจดหมายที่น่าสนใจยิ่ง. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/th/html/README.md b/th/html/README.md
new file mode 100644
index 00000000000..97b4a04308d
--- /dev/null
+++ b/th/html/README.md
@@ -0,0 +1,213 @@
+# แนะนำให้รู้จัก HTML
+
+อะไรคือ template คุณอาจสงสัย?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## HTML คืออะไร?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML ย่อมาจาก "HyperText Markup Language" **HyperText** หมายถึง เป็นชนิดของข้อความที่มีการเชื่อมโยงไปหน้าเว็บอื่นๆ ได้ **Markup** หมายถึง เราทำเครื่องหมายสักอย่างไว้ที่เอกสารด้วยโค้ดเพื่อทำบางอย่าง (ในที่นี้ เบราว์เซอร์) หรือวิธีการแปลงหน้าเพจ HTML โค้ด สร้างขึ้นจาก **tag** แต่ละ tag เริ่มต้นด้วย `<` และลงท้ายด้วย `>` tag เหล่านี้ถูกทำเครื่องหมายว่าเป็น **element**.
+
+## template แรกของคุณ!
+
+การสร้าง template ที่ว่า คือการสร้างไฟล์ template ทุกอย่างล้วนคือไฟล์ ถูกไหม? คุณคงสังเกตเห็นแล้ว
+
+template ทั้งหลายนั้นถูกบันทึกไว้ที่ไดเรกทอรี `blog/templates/blog` ดังนั้น เราจะสร้างไดเรกทอรีชื่อ `templates` ข้างในไดเรกทอรี blog ของคุณ จากนั้นสร้างไดเรกทอรีเพิ่ม ชื่อ `blog` ข้างในไดเรกทอรี template เมื่อครู่:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+ตอนนี้ให้สร้างไฟล์ `post_list.html` (ยังไม่ต้องมีอะไรข้างใน) ข้างในไดเรกทอรี `blog/templates/blog`
+
+มาดูกันว่าตอนนี้เว็บเราแสดงผลยังไง: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![รูปที่ 11.1](images/step1.png)
+
+ไม่มีข้อผิดพลาดแล้ว! ขอแสดงความยินดี :) อย่างไรก็ตาม เว็บของคุณก็ยังไม่มีอะไรใดๆ นอกจากหน้าว่างเปล่า เพราะว่า template ของคุณยังไม่มีอะไรข้างใน เราต้องแก้ไขมัน
+
+ลองเพิ่มบรรทัดเหล่านี้ลงในไฟล์ template:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![รูปที่ 11.2](images/step3.png)
+
+มันทำงานแล้ว! ทำได้ดีมาก :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. อย่างที่คุณเห็น เนื้อหาทั้งหมดของเว็บไซต์ เกิดขึ้นระหว่าง tag เริ่มต้น `<html>` และปิดท้ายด้วย tag `</html>`
+* `<p>` คือ tag สำหรับองค์ประกอบที่เป็น ย่อหน้า; `</p>` ปิดแต่ละย่อหน้า
+
+## Head and body
+
+ในแต่หน้า HTML ถูกแบ่งเป็นสองส่วน: **head** และ **body**.
+
+* **head** คือส่วนของข้อมูลต่างๆ ที่เกี่ยวกับเอกสาร แต่ไม่ปรากฎหรือแสดงผลบนหน้าจอ
+
+* **body** คือส่วนที่เหลือทั้งหมดที่แสดงผลอยู่บนหน้าเว็บเพจ
+
+เราใช้ `<head>` เพื่อบอกเบราว์เซอร์เกี่ยวกับการกำหนดค่าต่างๆ ของหน้าเพจ และ `<body>` บอกเกี่ยวกับเนื้อหาบนหน้าเว็บจริงๆ
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+บันทึกไฟล์และโหลดหน้าเว็บอีกครั้ง
+
+![รูปที่ 11.3](images/step4.png)
+
+สังเกตดูว่า เบราว์เซอร์เข้าใจว่า "Ola's blog" นั้คือ title ของหน้าเว็บคุณไหม? เบราว์เซอร์ ได้ทำการแปล `<title>Ola's blog</title>` และแทนที่ข้อความบนแถบ title บนเบราว์เซอร์คุณ (และถูกใช้เมื่อเราทำที่คั่นหน้าด้วยเช่นกัน)
+
+บางทีคุณจะสังเกตเห็นเช่นกันว่าแต่ละ tag ที่เปิดนั้นจะมีการ *ปิด tag* โดยใช้ `/` แต่ละองค์กระกอบจะอยู่ *ข้างใน* (เช่น ไม่สามารถปิด tag ได้จนกว่า ทุก tag ที่อยู่ข้างในมันเองจะยังไม่ได้ปิด)
+
+เหมือนกับการใส่สิ่งของลงในกล่อง คุณมีหนึ่งกล่องใหญ่ `<html></html>`; ข้างในนั้นคือ `<body></body>` และมีกล่องเล็กๆ อยู่ข้างใน: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## ปรับแต่ง template ของคุณ
+
+ตอนนี้คุณจะได้สนุกกับการปรับแต่งและลองแก้นิดๆ หน่อยๆ ใน template ของคุณ! และนี่คือ tag ที่น่าสนใจที่จะลองเล่น:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` สำหรับหัวเรื่องระดับถัดมา
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` เน้นข้อความของคุณ
+* `<strong>text</strong>` ทำให้ข้อความที่เน้นหนาขึ้น
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` สร้างการเชื่อมโยง
+* `<ul><li>first item</li><li>second item</li></ul>` สร้างรายการ เหมือนเช่นอันนี้!
+* `<div></div>` สร้างส่วนของหน้าเพจ
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+เราได้สร้าง `div` ไว้เป็นสามส่วน
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* อีกสอง `div` คือส่วนที่แสดงเนื้อหาบล็อกและวันที่เผยแพร่ โดยใช้ `h2` สำหรับหัวข้อโพสต์ และใช้สอง `p` (ย่อหน้า) สำหรับวันที่และสำหรับบล็อกโพสต์ของเรา
+
+โดยจะทำให้มีผลแบบนี้:
+
+![รูปที่ 11.4](images/step6.png)
+
+เย้! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## มีอีกอย่างนึง: deploy!
+
+เราทำให้ไปโผล่บนอินเทอร์เน็ตน่าจะดี ว่าไหม? เรามา deploy บน PythonAnywhere อีกกัน
+
+### Commit และ push โค้ดของคุณไปยัง Github
+
+ก่อนอื่น มาดูกันว่าไฟล์ไหนถูกเปลี่ยนแปลงไปบ้างจากครั้งล่าสุด (ใช้คำสั่งต่อไปนี้บนเครื่องคุณเอง ไม่ใช่บน PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+ตรวจสอบว่าอยู่ในไดเรกทอรี `djangogirls` หรือไม่ และใช้ `git` ในการรวมทุกไฟล์ที่เราแก้ไขภายในไดเรกทอรีเข้ามาด้วย:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). ยังจำ (จากบทที่ 3) เครื่องหมาย `.` หมายถึงไดเรกทอรีปัจจุบัน
+
+ก่อนเราละอัปโหลดไฟล์ทั้งหมด ตรวจสอบดูว่า `git` จะอัปไฟล์ไหนไป (ไฟล์ที่ `git` จะอัปโหลดจะเป็นตัวอักษรสีเขียว):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+เราเกือบเสร็จแล้ว ตอนนี้ถึงเวลาที่จะบันทึกการเปลี่ยนแปลงนี้แล้ว เรากำลังจะ "เขียนข้อความบันทึก" ซึ่งอธิบายสิ่งที่เราเปลี่ยนแปลงไป คุณสามารถพิมพ์อะไรก็ได้ตามที่ต้องการ แต่มันจะช่วยได้มาก หากเราอธิบายให้ตัวคุณเองจำสิ่งที่คุณทำลงไปได้ ในอนาคต
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **หมายเหตุ** ตรวจสอบให้แน่ใจว่าคุณใช้อัญประกาศคู่กับข้อความบันทึก
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### ดึงโค้ดล่าสุดของคุณมาที่ PythonAnywhere และโหลดเว็บของคุณอีกครั้ง
+
+* เปิด [หน้าคอนโซล PythonAnywhere](https://www.pythonanywhere.com/consoles/) และไปยัง **Bash console** ของคุณ (หรือเริ่มอันใหม่) จากนั้นใช้คำสั่ง:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+โค้ดใหม่ได้ถูกดาวน์โหลดลงมาแล้ว หากต้องการตรวจสอบดู คุณสามารถไปยัง **Files tab** และดูโค้ดของคุณบน PythonAnywhere
+
+* สุดท้าย ไปยัง [Web tab](https://www.pythonanywhere.com/web_app_setup/) และกดปุ่ม **Reload** บนเว็บของคุณ
+
+เว็บที่ปรับปรุงใหม่ควรจะขึ้นแล้ว! ลองโหลดหน้าบนเบราว์เซอร์ของคุณ หน้าเว็บควรจะเปลี่ยนแล้ว. :)
\ No newline at end of file
diff --git a/th/install_git.md b/th/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/th/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/th/installation/README.md b/th/installation/README.md
new file mode 100644
index 00000000000..4ceddee01d8
--- /dev/null
+++ b/th/installation/README.md
@@ -0,0 +1,58 @@
+# หากคุณเรียนบทเรียนนี้ที่บ้าน
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+ทั้งนี้เพราะเราอยากจะรวมวิธีการติดตั้งทั้งหมด มาไว้ที่เดียวกันให้หมด The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+โชคดีนะ!
+
+# การติดตั้ง
+
+ในเวิร์กช็อปนี้ คุณจะได้สร้างบล็อก และจะมีการเตรียมเครื่องมือที่จำเป็นก่อนการเริ่มเรียน เพื่อให้คุณพร้อมในการเริ่มโค้ดได้
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# ติดตั้ง Python
+
+{% include "/python_installation/instructions.md" %}
+
+# ตั้งค่า virtualenv และ ติดตั้ง Django
+
+{% include "/django_installation/instructions.md" %}
+
+# ติดตั้งโปรแกรมแก้ไขโค้ด
+
+{% include "/code_editor/instructions.md" %}
+
+# ติดตั้ง Git
+
+{% include "/deploy/install_git.md" %}
+
+# สร้างบัญชี GitHub
+
+ไปที่เว็บ [GitHub.com](https://www.github.com) และลงทะเบียนเป็นผู้ใช้ใหม่
+
+# สร้างบัญชีผู้ใช้ใหม่ ที่ PythonAnywhere
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# เริ่มอ่านบทเรียนเหล่านี้
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [อินเทอร์เน็ตทำงานอย่างไร](../how_the_internet_works/README.md)
+
+* [แนะนำการใช้บรรทัดคำสั่ง](../intro_to_command_line/README.md)
+
+* [แนะนำให้รู้จัก Python](../python_introduction/README.md)
+
+* [Django คืออะไร?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/th/instructions.md b/th/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/th/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/th/intro_to_command_line/README.md b/th/intro_to_command_line/README.md
new file mode 100644
index 00000000000..29d29561f2b
--- /dev/null
+++ b/th/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# แนะนำการใช้บรรทัดคำสั่ง
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**ขอแนะนำให้รู้จักเพื่อนใหม่ของคุณ: บรรทัดคำสั่ง!**
+
+จากนี้ไปจะแนะนำการใช้หน้าต่างดำๆ เหมือนกับที่แฮกเกอร์ใช้ มันอาจจะดูน่ากลัวสักหน่อยในตอนแรก แต่ มันก็แค่สิ่งรอรับคำสั่งจากคุณเท่านั้นเอง
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## อะไรคือบรรทัดคำสั่ง?
+
+หน้าต่างที่เรียกว่า **บรรทัดคำสั่ง** หรือ **อินเทอร์เฟซบรรทัดคำส่ัง** คือโปรแกรมสำหรับดู จัดการ และแก้ไขไฟล์ต่างๆ ที่อยู่ในเครื่องของคุณ แต่จะอยู่ในรูปแบบที่เป็นโหมดข้อความเท่านั้น It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. บรรทัดคำส่ังมีชื่อเรียกอื่นเหมือนกัน คือเรียกว่า *cmd*, *CLI*, *prompt*, *console* หรือ *terminal*.
+
+## เปิดอินเทอร์เฟซบรรทัดคำสั่ง
+
+ก่อนจะเริ่มใช้ เราต้องเปิดมันขึ้นมาก่อน
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+ส่วนใหญ่จะอยู่ที่เมนู Applications → Accessories → Terminal แต่นั่นขึ้นกับระบบที่ใช้อยู่ ถ้าไม่อยู่ในนี้ ลอง Google หาดูนะ. :)
+
+<!--endsec-->
+
+## Prompt
+
+ตอนนี้คุณควรเห็นหน้าสีขาวหรือสีดำที่รอคุณป้อนคำสั่งอยู่
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+ถ้าคุณใช้ Mac หรือ ลินุกซ์ คุณอาจจะเห็นเครื่องหมาย `$` แบบนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+บนวินโดวส์ จะเป็นเครื่องหมาย `>` แบบนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+ทุกคำสั่งจะต่อท้ายเครื่องเหล่านี้หนึ่งบรรทัด แต่คุณไม่จำเป็นต้องพิมพ์เอง คอมพิวเตอร์จะทำให้คุณเอง. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## คำสั่งแรกของคุณ (เย้!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+จากนั้นกด `enter` นี่คือผลลัพธ์ของเรา:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## พื้นฐาน
+
+แต่ละระบบปฏิบัติการที่มีชุดคำสั่งมาให้แตกต่างกัน ควรแน่ใจว่าคุณทำตามคำสั่งของระบบปฏิบัติการที่ใช้อยู่ เรามาลองกันเลยมั๊ย?
+
+### ไดเรกทอรีปัจจุบัน
+
+มันน่าจะดีใช่ไหม หากเรารู้ว่าตอนนี้เราอยู่ไหนแล้ว? ลองมาดูกัน ลองพิมพ์คำสั่งนี้ แล้วกด `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> หมายเหตุ: 'pwd' ย่อมาจาก 'print working directory'
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+คุณจะเห็นผลลัพธ์ที่ต่างไปเล็กน้อยบนเครื่องของคุณ ซึ่งผลที่ได้มักจะเริ่มที่ไดเรกทอรีบ้านของคุณ
+
+* * *
+
+### แสดงรายการไฟล์และไดเรกทอรี
+
+มันคืออะไรกันนะ? มาดูกัน:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### เปลี่ยนไดเรกทอรีปัจจุบัน
+
+ตอนนี้ เราลองไปที่ไดเรกทอรี Desktop ของเรากัน:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+ลองตรวจสอบดูซิ ว่าเปลี่ยนจริงไหม
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+เปลี่ยนแล้วจริงด้วย!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### สร้างไดเรกทอรี
+
+มาลองสร้างไดเรกทอรีชื่อ practice บน desktop ดูเป็นไง? คุณสามารถทำได้แบบนี้:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+คำสั่งน้อยๆ นี้จะสร้างโฟลเดอร์ชื่อ `practice` บน desktop ของคุณ คุณสามารถตรวจดูได้ใน Desktop ของคุณ โดยใช้คำสั่ง `ls` หรือ `dir` ! ลองเลย. :)
+
+> คำแนะนำจากโปร: ถ้าคุณไม่อยากพิมพ์คำสั่งเดิมซ้ำๆ ลองกดปุ่ม `ลูกศรขึ้น` และ `ลูกศรลง` บนแป้นพิมพ์ของคุณ เพื่อดูว่าคุณใช้คำสั่งล่าสุดอะไรบ้าง
+
+* * *
+
+### มาซ้อมมือกันเถอะ!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### เฉลย:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+ยินดีด้วย! :)
+
+* * *
+
+### ทำความสะอาด
+
+เราไม่ต้องการทิ้งสิ่งเหล่านี้ไว้ เรามาลบของพวกนี้ออกกันก่อนเลยละกัน
+
+ขั้นแรก เราต้องกลับไปที่ Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+ลองตรวจสอบดู:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+ต่อไป มาลบไดเรทอรี `practice` กัน:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+เรียบร้อย! มาดูซิว่าไฟล์ถูกลบไปจริงๆ หรือยัง:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### จบการทำงาน
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## ภาพรวม
+
+สรุปคำสั่งที่มีประโยชน์:
+
+| คำสั่ง (วินโดวส์) | คำสั่ง (Mac OS / ลินุกซ์) | คำอธิบาย                   | ตัวอย่างการใช้คำส่ัง                              |
+| ----------------- | ------------------------- | -------------------------- | ------------------------------------------------- |
+| exit              | exit                      | ปิดหน้าต่าง                | **exit**                                          |
+| cd                | cd                        | เปลี่ยนไดเรกทอรี           | **cd test**                                       |
+| cd                | pwd                       | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                        | ดูรายการไดเรกทอรี/ไฟล์     | **dir**                                           |
+| copy              | cp                        | คัดลอกไฟล์                 | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                        | ย้ายไฟล์                   | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                     | สร้างไดเรกทอรีใหม่         | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                        | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                     | delete a directory         | **rm -r testdirectory**                           |
+
+คำสั่งเหล่านี้เป็นเพียงส่วนหนึ่งที่คุณสามารถเรียกใช้ได้ แต่ในวันนี้คุณจะได้ใช้เพียงเท่านี้ล่ะ
+
+ถ้าคุณอยากรู้เพิ่มเติม [ss64.com](http://ss64.com) มีข้อมูลอ้างอิงเกี่ยวกับคำสั่งครบทุกระบบปฏิบัติการที่สมบูรณ์
+
+## พร้อมหรือยัง?
+
+เราไปดำดิ่งลงสู่โลกของ Python กัน!
\ No newline at end of file
diff --git a/th/python_installation/README.md b/th/python_installation/README.md
new file mode 100644
index 00000000000..bcfc3492533
--- /dev/null
+++ b/th/python_installation/README.md
@@ -0,0 +1,15 @@
+# เริ่มต้นด้วย Python
+
+ในที่สุด เราก็มาถึงจุดนี้!
+
+ขอเราเล่าก่อนละกันว่า Python คืออะไร Python นั้นคือภาษาการโปรแกรมที่ได้รับความนิยมอย่างมาก สามารถนำไปสร้างซอฟต์แวร์ต่างๆ ได้มากมายเช่น เว็บไซต์ เกม ซอฟต์แวร์ด้านวิทยาศาสตร์ กราฟิก และอื่นๆ อีกมากมาย
+
+ภาษา Python กำเนิดขึ้นช่วงปลาย 1980 และเป้าหมายหลักของภาษาคือ มนุษย์อย่างเราๆ สามารถอ่านได้ง่าย (ไม่เพียงเฉพาะเครื่องเท่านั้น) This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# การติดตั้ง Python
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/th/python_installation/instructions.md b/th/python_installation/instructions.md
new file mode 100644
index 00000000000..e4ee96319b6
--- /dev/null
+++ b/th/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![อย่าลืมเพิ่ม Python ไปยัง Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+คุณต้องไปที่เว็บไซต์ https://www.python.org/downloads/release/python-361/ และดาวน์โหลดตัวติดตั้ง:
+
+* ดาวน์โหลดไฟล์ *Mac OS X 64-bit/32-bit installer*
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+มีโอกาสสูงที่คุณจะมี Python ติดตั้งอยู่แล้ว ตรวจสอบว่าได้ติดตั้งแล้ว (และเป็นรุ่นอะไร) เปิดคอนโซลขึ้นมา และพิมพ์คำสั่งต่อไปนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. ถ้าคุณยังไม่ได้ติดตั้ง Python หรือ ถ้าคุณต้องการรุ่นอื่น คุณสามารถติดตั้งได้ ตามนี้:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+ใช้คำสั่งต่อไปนี้ในคอนโซลของคุณ:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+ใช้คำสั่งต่อไปนี้ในคอนโซลของคุณ:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+ใช้คำสั่งต่อไปนี้ในคอนโซลของคุณ:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! บางครั้ง กระบวนการจะไม่ราบรื่นอย่างที่คิด มันจะดีกว่าถ้าคุณจะขอความช่วยเหลือจากคนอื่นที่มีประสบการณ์มาก่อน
\ No newline at end of file
diff --git a/th/python_introduction/README.md b/th/python_introduction/README.md
new file mode 100644
index 00000000000..2121e020d8f
--- /dev/null
+++ b/th/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# แนะนำให้รู้จัก Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+มาลองเขียนโค้ดกันเลย!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+การที่เราจะเริ่มเล่นกับ Python นั้น เราต้องเปิด *บรรทัดคำสั่ง* ขึ้นมาเสียก่อน You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+เมื่อคุณพร้อมแล้ว ทำตามคำสั่งด้านล่างนี้
+
+เราต้องเปิดคอนโซล Python ขึ้นมา โดยพิมพ์คำสั่ง `python` บนวินโดวส์ `python3` บน Mac OS/ลินุกซ์ และกดปุ่ม `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## คำสั่ง Python แรกของคุณ!
+
+หลังจากรันคำสั่ง Python ตัวรอรับคำสั่งจะเปลี่ยนเป็น `>>>`. สำหรับเราตอนนี้ หมายความว่าเราสามารถใช้ได้เฉพาะคำสั่งภาษา Python You don't have to type in `>>>` – Python will do that for you.
+
+ถ้าคุณต้องการออกจากคอนโซล Python แค่พิมพ์ `exit()` คือใช้คีย์ลัด `Ctrl + Z` บนวินโดวส์ และ `Ctrl + D` สำหรับ Mac/ลินุกซ์ แล้วเครื่องหมาย `>>>` จะหายไป
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+ลองสนุกกับมันสักพักนะ แล้วกลับมาตรงนี้ต่อกัน. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## String
+
+เอาเป็น ชื่อของคุณเป็นไง? ลองพิมพ์ชื่อของคุณในเครื่องหมายคำพูดแบบนี้:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+ตอนนี้คุณได้สร้าง string แรกของคุณแล้ว! มันเป็นลำดับของอักขระซึ่งสามารถประมวลผลได้โดยคอมพิวเตอร์ string นั้นต้องอยู่ในเครื่องหมายคำพูดเสมอ สามารถใช้ได้ทั้งเครื่องหมายคำพูดเดี่ยว (`'`) หรือเครื่องหมายคำพูดคู่ (`"`) (ซึ่งใช้ได้เหมือนกันทั้งคู่!) เครื่องหมายคำพูดบอก Python ว่า ข้างในนั้นคือ string
+
+string สามารถนำมาต่อกันได้ ลองนี่:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+นอกจากนี้ คุณยังสามารถคูณจำนวน string ได้อีกด้วย:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+ถ้าคุณต้องใส่เครื่องหมายจุดลูกน้ำข้างใน string คุณทำได้สองวิธี:
+
+ใช้อัญประกาศคู่:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+หรือใช้ร่วมกับเครื่องหมาย backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+แจ๋ว ใช่ไหม? ถ้าอยากได้ตัวพิมพ์ใหญ่ทั้งหมด เพียงใช้:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+คุณอาจสงสัย ทำไมบางครั้งเราเรียกใช้ฟังก์ชันโดยใช้จุด `.` ท้าย string (เช่น `"Ola".upper()`) และบางครั้งก็ใช้ฟังก์ชันโดยมี string อยู่ในวงเล็บ? คืองี้ บางกรณี ฟังก์ชันเป็นสิ่งที่อยู่ในวัตถุ เช่น `upper()` ซึ่งสามารถใช้ได้เฉพาะกับ string ในกรณีนี้ เราเรียกฟังก์ชันว่า **method** กรณีอื่น ฟังก์ชันไม่ได้เป็นของวัตถุใดวัตถุหนึ่ง และยังสามารถใช้ได้กับวัตถุชนิดอื่นๆ ได้ เช่น `len()` นั่นคือเหตุผลที่เราใส่ `"Ola"` เป็นพารามิเตอร์ให้กับฟังก์ชัน `len`
+
+### ภาพรวม
+
+เอาล่ะ พอก่อนสำหรับ string ตอนนี้คุณได้รู้เกี่ยวกับ:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+สิ่งเหล่านี้เป็นพื้นฐานของทุกภาษาโปรแกรมที่คุณเรียนรู้ พร้อมสำหรับของที่ยากกว่านี้แล้วใช่ไหม? เรารู้ว่าคุณพร้อม!
+
+## ข้อผิดพลาด
+
+มาลองของใหม่กัน เราจะสามารถหาความยาวของตัวเลขได้เหมือนกับหาความยาวของชื่อเราได้ไหมนะ? ลองพิมพ์ `len(304023)` แล้วกด `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+แล้วเราก็เจอข้อผิดพลาดอันแรกแล้ว! ซึ่งบอกเราว่าวัตถุชนิด "int" (ตัวเลข) นั้นไม่มีความยาว แล้วทำไงทีนี้? บางทีเราน่าจะเขียนให้เป็นรูปแบบเดียวกับ string? เพราะ string มีความยาว จริงมั๊ย?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+เฮ้ย มันใช้ได้! เราใช้ฟังก์ชัน `str` ข้างในฟังก์ชัน `len` อีกที, `str()` จะแปลงทุกอย่างให้เป็น string
+
+- ฟังก์ชัน `str` แปลงสิ่งต่างๆ ให้กลายเป็น **string**
+- ฟังก์ชัน `int` แปลงสิ่งต่างๆ ให้กลายเป็น **integer**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## ตัวแปร
+
+แนวคิดสำคัญในการเขียนโปรแกรมคือ การใช้ตัวแปร ตัวแปรนั้นไม่มีอะไรมากกว่า ชื่อ สำหรับบางสิ่งบางอย่างที่คุณนำไปใช้ในภายหลังได้ โปรแกรมเมอร์ใช้ตัวแปรในการเก็บข้อมูล ทำให้โค้ดอ่านง่ายขึ้นและช่วยให้พวกเขาไม่จำเป็นต้องจดจำสิ่งต่างว่าเป็นอะไรบ้าง
+
+สมมติว่าเราต้องการสร้างตัวแปรที่ชื่อ `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+คุณน่าจะสังเกตเห็นว่า โปรแกรมของคุณไม่ตอบอะไรกลับมาเหมือนแต่ก่อน แล้วเราดูได้ไงว่ามีตัวแปรนี้อยู่จริงๆ? ลองพิมพ์ `name` แล้วกด `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+คุณสามารถใช้มันในฟังก์ชันได้เช่นกัน:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+ถ้าเกิดเราใช้ชื่อตัวแปรไม่ถูกล่ะ? คุณเดาได้ไหมว่าจะเกิดอะไรขึ้น? ลองดูกัน!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+ข้อผิดพลาดไงล่ะ! คุณจะเห็นได้ว่า Python มีข้อผิดพลาดหลากหลายชนิด และอันนี้เรียกว่า **NameError** Python จะส่งข้อผิดพลาดนี้ออกมา เพื่อคุณพยายามใช้ตัวแปรที่ยังไม่มีหรือยังไม่มีการกำหนด ถ้าคุณพบข้อผิดพลาดนี้ในภายหลัง ลองตรวจโค้ดของคุณดู คุณอาจจะพิมพ์ชื่อผิดสักที่ก็เป็นได้
+
+ลองเล่นกับมันดูสักพักนะ และดูว่าคุณสามารถทำอะไรได้แค่ไหน!
+
+## ฟังก์ชันการแสดงผล
+
+ลองนี่ดู:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+เมื่อคุณพิมพ์ `name` ตัวประมวลผลภาษา Python ตอบกลับมาด้วย string ที่ตัวแปร 'name' *อ้างถึง* ซึ่งก็คือตัวอักษร M-a-r-i-a ที่มีเครื่องหมายอัญประกาศเดี่ยวครอบอยู่ เมื่อใช้ `print(name)` Python จะ "แสดงผล" เนื้อหาที่อยู่ในตัวแปรออกมาทางหน้าจอ โดยไม่มีเครื่องหมายอัญประกาศแต่อย่างใด
+
+เราจะเจอในภายหลังว่า `print()` มีประโยชน์เมื่อเราต้องการแสดงผลค่าบางอย่างที่อยู่ข้างในฟังก์ชัน หรือเมื่อต้องการแสดงผลออกมาทีละหลายๆ บรรทัด
+
+## List
+
+นอกจาก string และ ตัวเลข แล้ว Python ยังมีประเภทข้อมูลชนิดต่างๆ อยู่อีก ตอนนี้เราจะแนะนำให้รู้หนึ่งในนั้น คือ **list** List คือสิ่งที่คุณคิดไว้นั้นแหละ: เป็นวัตถุที่เก็บรายการของวัตถุอื่นๆ ไงล่ะ. :)
+
+มาลองสร้าง list กัน:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+ใช่แล้ว นี่คือ list ว่างเปล่า ไม่มีประโยชน์เลยใช่ไหม? มาสร้าง list ของหมายเลขสลากกัน เราจะไม่ทำแบบเดิมซ้ำๆ แล้ว ดังนั้นเราจะใส่ไว้ในตัวแปรเสียเลย:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+เอาล่ะ เรามี list แล้ว! เราทำอะไรกับมันได้บ้างล่ะ? มาดูกันว่า เรามีหมายเลขสลากอยู่กี่อันภายใน list คุณพอรู้ไหมว่าเราจะใช้ฟังก์ชันไหน? แน่นอน คุณรู้อยู่แล้ว!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+ใช่แล้ว! ฟังก์ชัน `len()` บอกคุณได้ว่ามีวัตถุอยู่ใน list เท่าไหร่ สะดวกดีใช่ไหม? ตอนนี้บางที เราสามารถเรียงเลขข้างในได้นะ:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+ไม่มีอะไรตอบกลับมา มันเปลี่ยนลำดับที่อยู่ list มาลองพิมพ์ออกมาดูอีกทีว่าเกิดอะไรขึ้น:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+อย่างที่คุณเห็น หมายเลขใน list ถูกจัดเรียงเรียบร้อยแล้ว จากน้อยไปหามาก ยินดีด้วย!
+
+บางทีเราต้องการกลับด้านลำดับข้างใน? มาลองกันเลย!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+ถ้าคุณต้องการแสดงเฉพาะหมายเลขแรก คุณสามารถทำได้โดยใช้ **ดัชนี** ดัชนีคือตัวเลขที่บอกตำแหน่งสิ่งอยู่ที่อยู่ list โปรแกรมเมอร์นั้นจะเริ่มนับที่ 0 ดังนั้น สิ่งที่อยู่เป็นอันดับแรกใน list คือ ดัชนีหมายเลข 0 ถัดไปคือ 1 และต่อไปเรื่อยๆ ลองนี่ดู:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+คุณจะเห็นได้ว่า คุณสามารถเข้าถึงสิ่งที่อยู่ใน list โดยใช้ชื่อของ list และระบุดัชนีข้างในวงเล็บก้ามปู
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+ทำงานได้ถูกต้อง ประดุจดั่งมีเวทมนต์เลยล่ะ!
+
+เพื่อความสนุก ลองใช้ดัชนีค่าอื่น เช่น: 6, 7, 1000, -1, -6 หรือ -1000 แล้วดูว่าคุณสามารถเดาผลลัพธ์ก่อนที่จะลองรันได้ไหม แล้วผลลัพธ์ที่ว่า สมเหตุสมผลหรือไหม?
+
+คุณสามารถหาฟังก์ชันทั้งหมดของ list ได้จากเอกสารในเว็บ Python: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionary
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+นี่แสดงว่า คุณเพิ่งสร้าง dictionary เปล่าขึ้นมาแล้ว ฮูเร่!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- key ชื่อ `name` ชี้ไปยัง value `'Ola'` (เป็นวัตถุประเภท `string`)
+- `country` ชี้ไปยัง `'Poland'` (เป็น `string` อีกอัน),
+- และ `favorite_numbers` ชี้ไปยัง `[7, 42, 92]` (เป็น `list` ที่มีตัวเลขสามตัวข้างใน)
+
+คุณสามารถตรวจสอบค่าที่อยู่ในแต่ละ key ได้จาก:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+จะเกิดไรขึ้น ถ้าคุณต้องการหาค่าจาก key ที่ไม่มีอยู่จริง? มาลองดูกัน!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+ข้อผิดพลาดอีกอัน! อันนี้เรียกว่า **KeyError** Python พยามบอกว่า key ชื่อ `'age'` ไม่มีอยู่ใน dictionary
+
+เราจะรู้ได้ไงว่าควรใช้ dictionary หรือ list ตอนไหน? ถามได้ดี เราควรที่จะมีวิธีแก้ปัญหาในใจก่อนที่จะดูคำตอบในบรรทัดถัดไป
+
+- คุณต้องต้อการข้อมูลที่เป็นลำดับใช่หรือไหม? ใช้ list
+- คุณต้องการเชื่องโยงค่าข้อมูลโดยใช้ key เพื่อที่จะค้นหาได้ในภายหลังอย่างมีประสิทธิภาพ (โดยใช้ key)? ใช้ dictionary
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. เช่น ถ้าคุณต้องการลบรายการที่มี key `'favorite_numbers'` เพียงแค่คุณใช้คำสั่งต่อไปนี้:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### ภาพรวม
+
+แจ๋ว! ตอนนี้คุณได้รู้เกี่ยวกับการเขียนโปรแกรมเพิ่มมากขึ้นแล้ว ในส่วนที่ผ่านมา คุณได้รู้เกี่ยวกับ:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+ตื่นเต้นสำหรับส่วนถัดไปแล้วใช่ไหม? :)
+
+## การเปรียบเทียบสิ่งต่างๆ
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+คุณคงสงสัยว่าทำไมต้องใช้เครื่องหมายเท่ากับถึงสองอันติดกันแบบนี้ `==` ระหว่างสิ่งที่ต้องการเปรียบเทียบว่าเท่ากันหรือไม่? เราใช้เครื่องหมาย `=` อันเดียว สำหรับกำหนดค่าให้กับตัวแปรไปแล้วนั่นเอง You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. นอกจากนี้เรายังสามารถเปรียบเทียบสิ่งที่ไม่เท่ากันได้อีกด้วย เราใช้เครื่องหมาย `!=` เหมือนในตัวอย่างที่แล้ว
+
+ให้ Python ทำเพิ่มเติมอีกสองคำสั่ง:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y หมายถึง: x มากกว่า y
+- x `<` y หมายถึง: x น้อยกว่า y
+- x `<=` y หมายถึง: x น้อยกว่าหรือเท่ากับ y
+- x `>=` y หมายถึง: x มากกว่าหรือเท่ากับ y
+
+แจ๋ว! อยากทำเพิ่มอีกหน่อยไหม? ลองนี่ดู:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+คุณสามารถให้ Python เปรียบเทียบตัวเลขได้มากเท่าที่ต้องการ และมันก็ให้คำตอบกลับมาเสมอด้วย! ฉลาดสุดๆ เลยใช่ไหม?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+คุณเคยได้คำนี้ไหม "เปรียบเทียบ แอปเปิ้ลกับส้ม" เรามาลองอะไรที่คล้ายๆ กันนี้ บน Python กัน:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+จะเห็นได้ว่า Python ไม่สามารถเปรียบเทียบค่าของตัวเลข (`int`) และ string (`str`) ได้ Python เลขแสดงข้อผิดพลาด **TypeError** ออกมา และบอกเราว่า สองชนิดนี้ไม่สามารถเปรียบเทียบกันได้
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Boolean สามารถเป็นตัวแปรได้เช่นกัน! ลองดูนี่:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+คุณสามารถทำแบบนี้ได้เช่นกัน:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+ลองซ้อมและสนุกไปกับ Boolean โดยลองใช้คำสั่งเหล่านี้:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+ยินดีด้วย! Boolean เป็นฟีเจอร์ที่เจ๋งสุดๆ ในการเขียนโปรแกรม และคุณเพิ่งได้เรียนรู้วิธีใช้มันเรียบร้อยแล้ว!
+
+# เซฟซะ!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+จนถึงบัดดี้ เราก็ได้เขียนโค้ด python ทั้งหมดลงใน interpreter ซึ่งก็มีข้อจำกัดเรื่องการป้อนคำสั่งทีละบรรทัด โปรแกรมปกติจะถูกบันทึกลงไฟล์และเรียกใช้งานโดย **interpreter** หรือ **คอมไพเลอร์** เราได้รันโค้ดของเราทีละบรรทัดใน Python **interpreter** ตอนนี้เราต้องการที่รันทีละคำสั่งสำหรับงานถัดไป ตอนนี้เราจำเป็นต้อง:
+
+- ออกจาก Python interpreter
+- เปิดตัวแก้ไขโค้ดที่คุณเลือก
+- บันทึกโค้ด python บางอย่างลงไฟล์
+- แล้วเรียกใช้มัน!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+หลังจากเรียกใช้ฟังก์ชัน คุณจะถูกพากลับมายังบรรทัดคำสั่งของระบบ
+
+ก่อนหน้านี้ เราได้เลือกว่าจะใช้โปรแกรมแก้ไขโค้ดจากบท [โปรแกรมแก้ไขโค้ด](../code_editor/README.md) เปิดใช้งานโปรแกรมและเขียนโค้ดบางอย่างลงไฟล์
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+จริงๆ แล้วตอนนี้ คุณก็มีความรู้เกี่ยวกับ Python พอตัวแล้ว เพราะงั้นลองเขียนโค้ดที่คุณได้รู้วันนี้ดู
+
+ตอนนี้เราต้องบันทึกไฟล์ และตั้งชื่อที่สื่อความหมายให้ ตั้งชื่อว่า **python_intro.py** และบันทึกไฟล์เก็บไว้ที่เดสก์ท็อปของคุณ เราสามารถตั้งชื่อไฟล์ชื่อใดก็ได้ตามต้องการ แต่สิ่งที่สำคัญคือชื่อไฟล์ต้องลงท้ายด้วยนามสกุล **.py** The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. มีชื่อเรียกว่า "syntax highlighting" และเป็นฟีเจอร์ที่มีประโยชน์มากๆ เมื่อเขียนโค้ด The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). นี่เป็นหนึ่งเหตุผลว่าทำไมเราถึงใช้โปรแกรมแก้ไขโค้ด. :)
+
+เรามีไฟล์แล้ว ถึงเวลาที่เราจะรันมัน! โดยใช้ความรู้ที่เราเรียนมาในบทการใช้บรรทัดคำสั่ง ใช้เทอร์มินัลโดย **เปลี่ยนไดเรกทอรี** ไปยังเดสก์ท็อป
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+บน Mac คำสั่งที่ใช้จะมีลักษณะเหมือนแบบนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+ถ้าคุณติดปัญหา ขอความช่วยเหลือได้เลย
+
+ตอนนี้ ใช้คำสั่ง Python เพื่อรันไฟล์โค้ดของเรา แบบนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+นี่แหละ! คุณเพิ่งรันโปรแกรม Python แรกของคุณที่อยู่บนไฟล์ รู้สึกดีใช่ไหม?
+
+ตอนนี้คุณสามารถไปต่อยัง เครื่องมือสำคัญในการเขียนโปรแกรม:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+แทนที่โค้ดในไฟล์ **python_intro.py** ให้เป็นดังนี้:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python ต้องการให้เราเพิ่มเติมคำสั่งที่ต้องจะต้องรัน ถ้าเงื่อนไข `3 > 2` นั้นเป็นจริง (หรือ `True` นั่นเอง) เราให้ Python แสดงผล “It works!” ละกัน แก้ไขโค้ดในไฟล์ **python_intro.py** แบบนี้:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+สังเกตวิธีที่เราเยื้องบรรทัดถัดลงมาโดยใช้ 4 ช่องว่างไหม? เราต้องทำแบบนี้เพื่อให้ Python รู้ว่า เราต้องการรันโค้ดถ้าเงื่อนไขนั้นเป็นจริง คุณสามารถใช้ช่องว่างเดียวนะ แต่เหมือนโปรแกรมเมอร์ Python นั้นจะใช้ 4 ช่องว่าง เพื่อทำให้ดูเรียบร้อย `แท็บ` ก็นับเป็น 4 ช่องว่างเช่นกัน
+
+บันทึกไฟล์และลองรันอีกครั้ง:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### ถ้าเกิดว่า เงื่อนไขไม่เป็นจริงล่ะ?
+
+ในตัวอย่างที่แล้ว โค้ดจะถูกรันก็ต่อเมื่อเงื่อนไขเท่ากับ True เท่านั้น แต่ Python ยังมีอย่างอื่นเช่นกัน คือ `elif` และ `else` :
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+เมื่อเรารัน จะแสดงผลออกมาดังนี้:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+และลองรัน:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+มีเกิดอะไรขึ้นบ้าง? `elif` ให้คุณสามารถเพิ่มเงื่อนไขเพิ่มเติมลงไปได้ หากเงื่อนไขก่อนหน้านี้ไม่เป็นจริง
+
+คุณสามารถเพิ่ม `elif` ได้มากเท่าที่ต้องการ ตามหลัง `if` ตัวอย่างเช่น:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python จะรันและทดสอบแต่ละเงื่อนไข จากนั้นก็แสดงผลออกมา:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### ภาพรวม
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+เอาล่ะ ได้เวลาสำหรับส่วนสุดท้ายในบทนี้แล้ว!
+
+## ฟังก์ชันของคุณเอง!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+ฟังก์ชันคือลำดับของคำสั่งที่ Python จะดำเนินการหรือรัน แต่ละฟังก์ชันใน Python เริ่มด้วยคำว่า `def` ตามด้วยชื่อ และสามารถรับพารามิเตอร์ได้ Let's give it a go. แทนที่โค้ดในไฟล์ **python_intro.py** ให้เป็นดังนี้:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+เอาล่ะ ฟังก์ชันแรกของเราพร้อมแล้ว!
+
+คุณคงสงสัย ทำไมเราต้องเขียนชื่อฟังก์ชันที่ด้านท้ายของไฟล์ด้วย ทั้งนี้เพราะ Python อ่านไฟล์และดำเนินการรันจาก บทลงล่าง ดังนั้น การที่จะใช้ฟังก์ชันของเรา เราจึงต้องเขียนชื่อฟังก์ชันด้านล่าง
+
+ลองรันและดูว่าเกิดอะไรขึ้น:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+ดังที่คุณเห็น ตอนนี้เรามีฟังก์ชันที่มีพารามิเตอร์เรียกว่า `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+ข้อควรจำ: ฟังก์ชัน `print` เยื้องเข้าไปสี่บรรทัดภายในคำสั่ง `if` นั่นเพราะฟังก์ชันจะถูกเรียกเมื่อเงื่อนไขถูกต้อง มาดูกันว่ามันทำงานยังไง:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+อุปส์ เกิดข้อผิดพลาด แต่โชคดี ที่ Python บอกเราว่าข้อผิดพลาดเกิดจากอะไร มันบอกเราว่า ฟังก์ชัน `hi()` (ที่เราสร้างไว้) ต้องการหนึ่งพารามิเตอร์ (เรียกว่า `name`) และเราลืมส่งไปเมื่อเรียกใช้ฟังก์ชัน มาแก้ไขที่ด้านล่างของไฟล์กัน:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+และลองรันอีกครั้ง:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+และถ้าเราเปลี่ยนชื่อล่ะ?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+และรันมัน:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+แจ๋วเลย ใช่ไหม? ด้วยวิธีนี้ คุณไม่จำเป็นต้องพิมพ์ซ้ำทุกครั้งที่คุณต้องการเปลี่ยนชื่อของบุคคลที่เราต้องการทักทาย And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+มาลองรันกัน:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+ขอแสดงความยินดี! คุณได้เรียนรู้วิธีเขียนฟังก์ชันแล้ว! :)
+
+## การทำซ้ำ
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+นี่เป็นส่วนสุดท้ายของบทนี้แล้ว เร็วเนอะว่ามั๊ย? :)
+
+โปรแกรมเมอร์นั้นไม่ชอบทำอะไรซ้ำไปมา การเขียนโปรแกรมนั้นเป็นการทำงานอย่างอัตโนมัติ ดังนั้นเราจริงไม่ต้องการทักทายทุกๆ คน ด้วยชื่อของพวกเขาด้วยมือในทุกๆ ชื่อ จริงไหม? และการทำซ้ำจะเข้ามาช่วยในส่วนนี้
+
+ยังจำ list ได้ใช่ไหม? เรามาสร้างรายการของชื่อสาวๆ กัน:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+เราต้องการที่จะทักทายด้วยชื่อพวกเขาทั้งหมด เรามีฟังก์ชัน `hi` เพื่อทำสิ่งนั้นอยู่แล้ว เรามาใช้พร้อมๆ ไปกับการทำซ้ำกัน:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+และนี่คือโค้ดทั้งหมดของไฟล์:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+และเมื่อเรารันไฟล์:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+อย่างที่คุณเห็น ทุกสิ่งที่อยู่ภายในคำสั่ง `for` จะถูกทำซ้ำและวนเข้าไปในรายชื่อที่อยู่ใน list `girls`.
+
+คุณสามารถใช้ `for` กับตัวเลขได้เช่นกัน โดยใช้ฟังก์ชัน `range`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+ซึ่งจะแสดงผล:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` คือฟังก์ชันที่จะสร้าง list ของตัวเลข โดยมีเลขเริ่มต้นและสิ้นสุด (ซึ่งเลขเหล่านี้ใส่เข้ามาเป็นพารามิเตอร์ของฟังก์ชัน)
+
+หมายเหตุ เลขตัวที่สองของฟังก์ชันนั้นจะไม่ถูกรวมเข้ามาด้วย (ความหมายคือ `range(1, 6)` จะนับจาก 1 ถึง 5 แต่ไม่รวมเลข 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## ภาพรวม
+
+มีเพียงเท่านี้แหละ **คุณเจ๋งมาก!** จริงๆ บทนี้เป็นบทที่ยาก และคุณควรจะภูมิใจในตัวเองนะ เราภูมิใจในตัวคุณนะที่คุณมาถึงจุดนี้ได้!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![คัพเค้ก](images/cupcake.png)
\ No newline at end of file
diff --git a/th/signup_pythonanywhere.md b/th/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/th/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/th/template_extending/README.md b/th/template_extending/README.md
new file mode 100644
index 00000000000..5d3688bc958
--- /dev/null
+++ b/th/template_extending/README.md
@@ -0,0 +1,147 @@
+# การ extend template
+
+อีกความเก่งข้อหนึ่งของ Django คือ **ความสามารถในการ extend template** หมายความว่าไง? มันหมายถึงว่า คุณสามารถใช้ชิ้นส่วน HTML เดียว ได้กับหลายๆ หน้าของเว็บคุณ
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+template หลัก คือ template ที่เป็นพื้นฐานที่สุด ที่คุณสามารถนำไปสร้างเป็นหน้าอื่นในเว็บของคุณได้
+
+สร้างไฟล์ `base.html` ใน `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+จากนั้นเปิดไฟล์และคัดลองทุกบรรทัดจาก `post_list.html` ไปยังไฟล์ `base.html` แบบนี้:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+จากนั้น ในไฟล์ `base.html` แทนที่ทุกสิ่งใน `<body>` (ทุกสิ่งระหว่าง `<body>` และ `</body>`) ด้วย:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). เราจะแสดงวิธีให้คุณดูเร็วๆ นี้ล่ะ
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. แบบนี้:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+เสร็จแล้ว! ลองดูว่าเว็บเรายังทำงานอยู่ไหม. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/th/whats_next/README.md b/th/whats_next/README.md
new file mode 100644
index 00000000000..1972225467b
--- /dev/null
+++ b/th/whats_next/README.md
@@ -0,0 +1,25 @@
+# หลังจากนี้?
+
+ยินดีกับความสำเร็จของคุณ! **คุณเจ๋งมากๆ** เราภูมิใจในตัวคุณนะ! <3
+
+### ทำอะไรต่อจากนี้?
+
+พักสักครู่และผ่อนคลาย คุณเพิ่งทำบางสิ่งที่ยิ่งใหญ่ได้สำเร็จมา
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### แนะนำบทเรียนเพิ่มเติมให้ได้ไหม?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/tl-PH/GLOSSARY.md b/tl-PH/GLOSSARY.md
new file mode 100644
index 00000000000..72915dcd29a
--- /dev/null
+++ b/tl-PH/GLOSSARY.md
@@ -0,0 +1,3 @@
+# sulatan ng Wikang Pamprograma
+
+Ang Code editor ay isang aplikasyon na nagbigay sayo na pagkakataon na i-save ang iyong code para mabalikan mo mayamaya. Pwede kang matuto kung saan ka pede makakuha mula [kabanata ng Code editor](./code_editor/README.md)
\ No newline at end of file
diff --git a/tl-PH/README.md b/tl-PH/README.md
new file mode 100644
index 00000000000..8d0b8b57910
--- /dev/null
+++ b/tl-PH/README.md
@@ -0,0 +1,51 @@
+# Django Tutorial para sa mga Babae
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Ang proyekto na eto ay lisensyado sa Creative Commons Attribution-ShareAlike 4.0 International License. Para makita mo ang konpya ng lisensya, bumisita sa https://creativecommons.org/licenses/by-sa/4.0/
+
+## Mabuhay
+
+Maligayang pagdating sa Django Tutorial para sa mga Kababaihan! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduksiyon
+
+Nakaramdam ka na ba na ang mundo ay punong-puno ng mga teknolohiya na hindi mo (pa) maintindihan? Nagtaka ka na ba kung paano gumawa ng isang website ngunit wala kang sapat na pagganyak na magsimula? Naisipan mo na ba na ang mga sofware sa mundo ay parang napakahirap para gawin mong mag-isa?
+
+Wag mag-alala, may magandang balita kami para sa iyo. Ang Programming ay hindi mahirap gaya ng inaakala mo at gusto naming ipakita sa iyo kung gaano kasaya ito.
+
+Ang tutorial na ito ay hindi basta na lang mag-uwi sa iyo na maging isang programmer. If gusto mong gumaling dito, kailangan mo ng ilang buwan o kahit isang taon na pag-aaral at pagsasanay. Pero gusto naming ipakita sa iyo na ang programming o paglikha ng mga website ay hindi mahirap gaya ng inaakala mo. Susubukan namin na ipaliwanag ang iba't ibang piraso na malinaw hangang sa makakaya namin, para hindi ka matakot sa teknolohiya.
+
+Kami ay umaasa na magustuhan mo rin ang teknolohiya gaya ng pagmamahal namin dito!
+
+## Ano ang matutunan mo sa loob ng tutorial na ito?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+Ito ay magiging katulad (humigit-kumulang) nito:
+
+![Tambilang 0.1](images/application.png)
+
+> Kung susubukan mo ang tutorial na ikaw lang mag-isa at wala kang coach na makakatulong sa iyo kung may problema, mayroon kaming isang chat system para sa iyo:[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Hiniling namin ang aming mga coaches at dating nagdalo na bumisita ng paulit-ulit para makutulong sa iba na nag tutorial! Huwag matakot magtanong doon!
+
+Sige, [magsimula tayo sa simula...](./how_the_internet_works/README.md)
+
+## Sundin ang tutorial sa bahay
+
+Nakakagulat ang pagdalo sa workshop ng Django Girls, ngunit alam namin na hindi talaga posible na palaging makadalo. Ito ang dahilan kung bakit namin kayo hinimuk na sundan ang tutorial sa bahay mo. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. Ito kasalukuyang ginagawa pa, pero mas marami pang mga bagay ang aming i-vocer sa [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) na YouTube channel.
+
+Sa bawat kabanata na nadaanan na, may mga link na nagturo sa tamang video.
+
+## Tungol at Pag-ambag
+
+Ang tutorial na ito ay minamantini ni [DjangoGirls](https://djangogirls.org/). Kung may makita kang mga mali or gusto mong i-update ang tutorial, [pakitingnan ang mga pangpatnubay kung paano mag-ambag](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Sa ngayon, ang mga pagsasalin ay nakalagay sa plataporma ng crowdin.com sa:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/tl-PH/SUMMARY.md b/tl-PH/SUMMARY.md
new file mode 100644
index 00000000000..709bf544cb5
--- /dev/null
+++ b/tl-PH/SUMMARY.md
@@ -0,0 +1,35 @@
+# Buod
+
+* [Pambungad](README.md)
+* [Instalasyon](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Instalasyon (chromebook)](chromebook_setup/README.md)
+* [Paano gumagana ang Internet](how_the_internet_works/README.md)
+* [Introduksyon sa command line](intro_to_command_line/README.md)
+* [Pag-install ng Python](python_installation/README.md)
+* [Sulatan ng Wikang Pamprograma](code_editor/README.md)
+* [Introduksyon sa Python](python_introduction/README.md)
+* [Ano ang Django?](django/README.md)
+* [Pag-install ng Django](django_installation/README.md)
+* [Ang una mong proyekto sa Django!](django_start_project/README.md)
+* [Mga model ng Django](django_models/README.md)
+* [Admin ng Django](django_admin/README.md)
+* [I-deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Mga view ng Django - oras na para maglikha!](django_views/README.md)
+* [Introduksyon sa HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic na datos sa mga template](dynamic_data_in_templates/README.md)
+* [Django na mga template](django_templates/README.md)
+* [CSS - gawin itong maganda](css/README.md)
+* [Pag-extend ng Template](template_extending/README.md)
+* [I-extend ang iyong application](extend_your_application/README.md)
+* [Mga Form ng Django](django_forms/README.md)
+* [Ano ang sunod?](whats_next/README.md)
\ No newline at end of file
diff --git a/tl-PH/chromebook_setup/README.md b/tl-PH/chromebook_setup/README.md
new file mode 100644
index 00000000000..dcd931f1722
--- /dev/null
+++ b/tl-PH/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Setup ng Chromebook
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/tl-PH/chromebook_setup/instructions.md b/tl-PH/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..77f8682ba51
--- /dev/null
+++ b/tl-PH/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Pwede kang [lumaktaw sa seksiyon na ito](http://tutorial.djangogirls.org/en/installation/#install-python) kung hindi ka gumagamit ng Chromebook. Kung oo, ang iyong karanasan sa pag-install ay medyo mag-iiba. Pwede mo nang isawalang bahala ang iba mga tagubilin sa pag-install.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Ang Cloud IDE ay isang kagamitan na nagbibigay sayo ng code editor at pahintulot na makagamit ng gumaganang kompyuter sa internet na kung saan ay pwede kang mag-install, gumawa, at magpagana ng software. Para sa tagal ng pag-aaral na ito, ang Cloud IDE ay magsisilbing *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual na Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/tl-PH/code_editor/README.md b/tl-PH/code_editor/README.md
new file mode 100644
index 00000000000..c99a9d14c66
--- /dev/null
+++ b/tl-PH/code_editor/README.md
@@ -0,0 +1,11 @@
+# Sulatan ng Wikang Pamprograma
+
+> Para sa mga nagbabasa sa bahay: ang kabanata na ito ay kalapik sa [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) na video.
+
+Ang unang linya ng iyong programa sa Python ay ang simula ng lahat, kaya't napakahalaga na kumuha ka ng magandang pagsusulatan at paghuhulmahan ng iyong mga proyekto!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/tl-PH/code_editor/instructions.md b/tl-PH/code_editor/instructions.md
new file mode 100644
index 00000000000..dfaf78e4b5a
--- /dev/null
+++ b/tl-PH/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Napakarami mong pagpipilian pagdating sa pagsusulatan ng iyong mga proyekto at maaari mo itong ibase kung saan ka mas komportableng magtrabaho. Karamihan sa mga gumagamit ng Python na wikang pamprograma ay pumipili ng mga kumplikado ngunit makapangyarihang IDEs (tinatawag na Integrated Development Environments), katulad ng PyCharm. Ngunit bilang baguhan sa larangang ito, nirerekomenda namin na magsimula ka muna sa payak at magaan na mga pamamaraan at kagamitan.
+
+Ang aming mga mungkahi ay nasa ibaba, pero huwag mag-atubiling magtanong sa iyong coach kung ano ang iyong mga kagustuhan - mas madaling makakuha ng tulong mula sa kanila.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Gamitin ang Atom](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Gamitin ang Atom](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Gamitin ang Atom](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/tl-PH/css/README.md b/tl-PH/css/README.md
new file mode 100644
index 00000000000..a4d39defbf8
--- /dev/null
+++ b/tl-PH/css/README.md
@@ -0,0 +1,330 @@
+# CSS - gawing nating maganda!
+
+Pangit pa ang ating kasalukuyang blog, hindi ba? Oras na para pagandahin ito! Gagamitin natin ang CSS para riyan.
+
+## Ano ang CSS?
+
+Ang Cascading Style Sheets (CSS) ay isang wika na ginagamit para ilarawan ang itsura at pagkalatag ng mga website ma gumagakip ng markup na wika gaya ng HTML. Isipin itong pampaganda ng ating mga pahina sa web. ;)
+
+Pero hindi natin gusto na magsimula uli sa wala, tama ba? Sa makaisa pa, gagamitin natin ang isang bagay na pinalabas nga mga programmer na libre sa Internet. Ang paggugol ng panahon na mag-isip ng bagong programa ay hindi biro, alam mo yan.
+
+## Gamitin natin ang Bootstrap!
+
+Ang Bootstrap ay isa sa mga pinakasikat na mga balangkas ng HTML ay CSS para makagawa ng magagandang mga website: https://getbootstrap.com/
+
+Ito ay isinulat ng mga programmer na nagtatrabaho sa Twitter. Sa ngayon, ito ay patuloy na ginagawa ng mga boluntaryo galing sa ibat ibang sulok ng mundo!
+
+## Mag-install ng Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Tambilang 14.1](images/bootstrap1.png)
+
+Gumaganda na siya!
+
+## Static Files sa Django
+
+Sa wakas ay titingnan natin nang masinsinan ang mga bagay na tinatawag nating **static files**. Ang static na mga gile ay ang iyong mga CSS at mga larawan. Ang laman nila ay hindi nakadepende sa nilalaman ng request at ito ay pareho lang sa bawat user.
+
+### Saan ilagay ang static na mga file para sa Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+Magagawa natin yan sa pamamagitan ng paglikha ng folder na pinangalanang `static` sa loob ng blog na app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Si Django ay kusang maghanap ng mga folder na tinawag na "static" sa loob ng iyong mga app na mga folders. Pagkatapos ay pede na niyang gamitin ang mga laman nito isip mga static na mga file.
+
+## Ang iyong unang CSS file!
+
+Gagawa tayo ng CSS na file, para pagandahin ang iyong web page. Gumawa ng bagong directory na `css` sa loob ng iyong `static` directory. Pagkatapos, gumawa ka ng bagong file na `blog.css` sa loob nitong `css` directory mo. Handa ka na ba?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Oras na para magsulat ng CSS! Buksan ang `blog/static/css/blog.css` na file sa loob ng iyong editor ng code.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+Pero gumawa naman tayo kahit kaunti lang. Maybe we could change the color of our headers? Para maunawaan ang mga kulay, ang kompyuter ay sumusunod sa mga special codes o mga numero at letra na nagsisimbolo ng kulay. Ang mga code na ito ay nagsimula sa `#` at sinundan ng 6 na letra (A-F) at mga numero (0-9). Halimbawa, ang code para sa asul ay `#0000FF`. Maari mong makita ang mga color code sa iba't ibang kulay dito: http://www.colorpicker.com/. Maari ka ding gumamit ng mga [nakatakdang mga kulay](http://www.w3schools.com/colors/colors_names.asp), tulad ng `red (o pula)` at `green (o berde)`.
+
+Sa iyong `blog/static/css/blog.css` na file, kailangan mong idagdag ang sumusunod na code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` ay isang Selector ng CSS. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. Kung mayroon kang `<h1><a href="">link</a></h1>` na gaya nito, ang estilo na `h1 a` ay magagamit. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+Sa loob ng CSS file nakabase ang estilo ng mga elemento sa loob ng HTML na file. Ang unang pamamaraan na makilala natin ang mga elemento ay gamit ang pangalan ng elemento. Maari mong naalala ang mga tag na ito mula sa pangkat ng HTML. Mga bagay gaya ng `a`, `h1`, at `body` ay puro mga halimbawa ng mga pangalan ng elemento. Maaari din nating kilalanin ang mga elemento sa pamamagitan ng katangian na `class` o sa katangian na `id`. Ang class at id ay mga pangalan na sarili mong ibinigay sa mga elemento. Ang mga class ay nagbibigay kahulugan sa mga grupo ng mga elemento, at ang id ay nagtuturo sa mga tiyak na mga elemento. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Maari ka pang magbasa ng higit pa tungkol sa mga [Selector ng CSS sa w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Nagloload lang kami ng mga static na file dito. :) Sa gitna ng `<head>` at `</head>` na mga tag, kasunod ng mga link sa mga CSS file ng Bootstrap, idagdag mo ang linya na ito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Ang browser ang nagbabasa sa mga file sa hanay na ibinigay, kaya kinakailangan nating isiguro na nasa tamang lugar ito. Kung hindi, ang mga code sa ating file ay mapangingibawan ng code ng mga file ng Bootstrap. Kakasabi lang natin sa ating template kung saan nakalagay ang ating CSS na file.
+
+Ang file mo ay dapat maging katulad nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Sige, i-save ang file at i-refresh ang site!
+
+![Tambilang 14.2](images/color2.png)
+
+Magaling! Siguro dapat din nating bigyan ang ating website ng kaunnting simoy ng hangin at dagdagan ang baybay sa kaliwang bahagi? Subukan natin ito!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Idagdag mo ito sa iyong CSS, i-save ang file at tingnan kung paano ito gumagana!
+
+![Tambilang 14.3](images/margin2.png)
+
+Maari nating i-customize ang istilo ng mga letra sa ating header? Idikit ito sa iyong `<head>` sa `blog/templates/blog/post_list.html` na file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Tulad ng dati, pakitingnan ang pagkasunod-sunod at ilagay bago ang link sa `blog/static/css/blog.css`. Ang linyang ito ay mag-import ng istilo ng letra na tinatawag na *Lobster* mula sa mga Font ng Google (https://www.google.com/fonts).
+
+Hanapin ang `h1 a` na deklerasyon na bloke (ang code sa pagitan ng braces `{` at `}`) sa loob ng CSS na file na `blog/static/css/blog.css`. Ngayon, idagdag ang linya na `font-family: 'Lobster';` sa pagitan ng mga kawing, at i-refresh ang pahina:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Tambilang 14.3](images/font.png)
+
+Mainam!
+
+Gaya ng binanggit sa taas, ang CSS ay mayroon konsepto ng mga class. Ang mga ito ay gamit para mapangalanan mo ang parte ng iyong HTML na code at i-apply ang istilo sa parte na ito lamang, na hindi makaapekto sa ibang bahagi. Ito ay sobrang makakatulong! Maari na mayroon kang dalawang div na kakaiba ang gamit (gaya ng iyong header at ang iyong post). Ang class ay makakatulong para gawing magkaiba ang kanilang anyo.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Ngayon, aming idadagdag ang deklerasyon na mga bloke sa iba ibang mga selector. Ang mga selector na nagsimula sa `.` ay may kaugnayan sa mga classes. Mayroong maraming magagandang tutorial doon at mga pagpapaliwanag tungkol sa CSS sa Web na makakatulong sa iyo sa pag-intindi sa mga sumusunod na code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Pagkatapos, palibutan ang HTML code na nagdidisplay ng mga post nang mga deklerasyon ng mga class. Palitan mo ito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+sa loob ng `blog/templates/blog/post_list.html` nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+I-save ang mga file na iyon at i-refresh ang iyong website.
+
+![Tambilang 14.4](images/final.png)
+
+Woohoo! Kagilas-gilas di ba? Tingnan mo ang iyong code na kakadikit lang natin para mahanap mo ang lugar na dinagdagan natin ng mga class sa loob ng HTML at ginamit sa CSS. Saan mo gawin ang mga pagbabago kung gusto mong palitan ang kulay ng petsa ng turquoise (o turkesa)?
+
+Huwag matakot paglaruan ng konti ang CSS at subukang baguhin ang mga istilo. Ang paglalarong CSS ay makakatulong sa iyo para maintindihan mo kung ano ang ginagawa ng iba't ibang bagay. Kung may nasira ka, huwag mag-alala - pwedeng-pwede mong ibalik ito sa dati!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Handa ka naba sa sunod na kabanata?! :)
\ No newline at end of file
diff --git a/tl-PH/deploy/README.md b/tl-PH/deploy/README.md
new file mode 100644
index 00000000000..0ea6ee8b30e
--- /dev/null
+++ b/tl-PH/deploy/README.md
@@ -0,0 +1,246 @@
+# I-deploy!
+
+> **Paalala** Ang sumunod na kabanata ay maaring masyadong mahirap maintindihan paminsan-minsan. Magtiyaga at tapusin ito; ang pag-deploy ay isang pinaka-importanteng bahagi sa proseso ng paggawa ng mga website. Ang kabanatang ito ay nilagay sa gitnang bahagi ng tutorial para ang iyong tagapayo ay makatulong sa mga medyo mahirap na proseso sa pag-gawang online ng iyong website. Ibig sabihin nito, pwede mo pa ring tapusin ang tutorial na ikaw lang kahit maubusan ka pa ng oras.
+
+Hanggang ngayon, ang iyong website ay magagamit lang sa iyong kompyuter. Sa ngayon, matutunan mo kung paano ito i-deploy! Ang pag-deploy ay isang proseso ng paglathala ng iyong application sa Internet para sa wakas ay mapuntahan at makita ng mga tao ang iyong app. :)
+
+Base sa natutunan mo, ang website ay kinakailangang nakalagay sa isang server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+Ang isa pang external service na gagamitin ay ang [GitHub](https://www.github.com), na isang service ng naghohost ng mga code. Mayroon pang pang ibang mga providers, pero karamihan sa mga programmer ngayon ay mayroon nang account sa Github, at ngayon ikaw din!
+
+Ang tatlong lugar na ito ay importante para sa iyo. Ang iyong lokal na komputer kung saan gagawin mo ang pag-dedevelop at pag-test. Kung masaya kana sa mga pagbabago, ikaw ay maglalagay ng kopya ng iyong program sa Github. Ang iyong website ay nandoon sa PythonAnywhere at atin itong i-update sa pamamagitan ng pagkuha ng bagong kopya ng iyong code mula sa Github.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Pinapaandar ang ating repository sa Git
+
+Ang Git ay nagsubaybay sa mga pagbabago sa isang partikular na grupo ng file sa loob ng tinatawag na repository ng code (o "repo" sa maikli). Umpisahan natin ang isa para sa iyong proyekto. Buksan ang iyong consile at patakuhin ang mga command na ito, sa loob ng directory ng `djangogirls`:
+
+> **Paalala** TIyakin ang iyong kasalukuyang working directory gamit ang `pwd` (Mac OS X/Linux) o `cd` (Windows) na command bago i-initialize ang repository. Dapat na nasa loob ka ng `djangogirls` na folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Ang pag-initialize ng git repository ay kailangang gawin nang isang beses lang sa bawat proyekto (at hindi na kinakailangang maglagay pa ng bansag at email kailanman).
+
+Ang git ay magsubaybay sa mga pagbabago sa lahat ng mga file at mga folder sa loob ng directory, pero maaring may mga files na gusto nating isawalang-bahala. Gagawin natin ito sa pamamagitan ng paglikha ng file na tinatawag na `.gitignore` sa loob ng base na directory. Buksan ang iyong editor at maglikha ng bagong file na may sumusunod na nilalaman:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+At i-save ito isip `.gitignore` sa loob ng "djangogirls" na folder.
+
+> **Paalala** Ang tuldok sa harap ng pangalan ng file ay importante! Kung ikaw ay nahihirapan sa paglikha nito (ang Mac ay hindi gusto na maglikha ka ng mga file na nagisisumula sa isang tulod sa pamamagitan ng Finder, halimbawa), kung gayon ay gamitin ang "Save As" na katangian ng iyong editor; ito ay himpit. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Paalala** Isa sa mga file na nilakip mo sa iyong `.gitignore` file ay si `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. Isipin mo ang iyong local na database na isang magandang palaruan kung saan pede mung masubukan ang ibat-ibang bagay na walang takot na mabura mo ang mga tunay na post galing sa iyong blog.
+
+Mainam na gamitin mo muna ang `git status` na commmand bago ka mag `git add` o kapag hindi ka sigurado kung ano ang nagbago. Nakakatulong ito para hindi ka mabigla sa mga pangyayari, gaya ng mga maling file na nasali at na-commit. Ang `git status` na command ay naghahatid ng mga impormasyon sa lahat ng mga file na hindi naka track/binago/at na-stage, ang estado ng branch, at marami pang iba. Ang output ay dapat kagaya ng sumusunod:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+At sa wakas, ating i-save ang ating mga binago. Pumunta iyong console at patakbuhin ang mga command na ito:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/tl-PH/deploy/install_git.md b/tl-PH/deploy/install_git.md
new file mode 100644
index 00000000000..5e98157b305
--- /dev/null
+++ b/tl-PH/deploy/install_git.md
@@ -0,0 +1,52 @@
+Ang Git ay isang "version control system" na ginagamit ng napakaraming mga programmer. Ang software na ito ay maaring magsubaybay sa mga pagbabago sa mga files sa paglipas ng panahon para matandaan mo ang mga bersyon mamaya. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Pag-install ng Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Maari kang mag-download ng Git mula sa [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Maliban dyan, ang mga default na setting ay mainam na. Tingnan ang Windows-style, maganda ang pag-commit ng Unix-style na line endings.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Paalala**Kung ang gamit mo ay OS X 10.6, 10.7 o 10.8, kailangan mong i-install ang bersyon ng git galing dito: [Git Installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/tl-PH/deploy/signup_pythonanywhere.md b/tl-PH/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/tl-PH/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/tl-PH/django/README.md b/tl-PH/django/README.md
new file mode 100644
index 00000000000..2b31cdf3e4b
--- /dev/null
+++ b/tl-PH/django/README.md
@@ -0,0 +1,27 @@
+# Ano ang Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) ay isang libre at open source na framework ng web application, na sinulat sa Python. Isang web framework na bumubuo ng mga bahagi na makakatulong sa iyo na maggawa ng mga website nang mabilis at madali.
+
+Kung gumagawa ka ng isang website, kinakailangan mo lagi ng parehang grupo nga mga sangkap: pamamaraan para mag-authenticate ng user (pagsign-up, pagsign-in, pagsign-out), isang panel para sa pangangasiwa ng iyong website, at mga form, at pamamaraan para sa pag-upload ng mga files, at iba pa.
+
+Maswerte ka, maraming tao ang nakapansin na ang mga develepor ay kadalasang makadanas ng pare-parehang problema sa paggawa ng bagong site, kaya sila ay nagsamasama para gawin ang mga framework (isa na dito ang Django) na nagbigay sa iyo ng mga handang magagamit na mga sangkap.
+
+Ang mga framework ay nilikha para maiwasan mong gawin ulit ang mga bagay-bagay at makakatulong para mabawasan ang gastusin sa paggawa ng bagong site.
+
+## Bakit mo kinakailangan ng framework?
+
+Para maintindihan mo kung para saan talaga ang Django, kailangan nating tingnan nang maigi ang ating mga server. Una, dapat malaman ng server na gusto mo itong magpakita ng mga web page.
+
+Isipin mo ang isang buson (port) na nagsubaybay sa mga padating na mga sulat (requests). Ito ay ginagawa ng web server. Ang web server ay nagbabasa ng mga sulat at nagpadala ng sagot sa pamamagitan ng webpage. Pero sa oras na gustong mong magpadala, kinakailangan na meron kang nilalaman. Ang Django ay makakatulong sa paglikha ng iyong mga nilalaman.
+
+## Ano ang mangyari kung may maghingi ng website galing sa iyong server?
+
+Kapag dumating ang hiling sa web server, ipapasa ito sa Django na nagbibigay pagpapakahulugan sa hiling na natanggap. Kukuha ito muna ng address ng web page at subukang intindihin kung ano ang dapat gawin. Ang parte na ito ay ginagawa ng **urlresolver** ni Django (paalala na ang address ng website ay tinatawag na URL - Uniform Resource Locator - kaya ang pangalan na *urlresolver* ay may kabuluhan). Hindi ito masyadong matalino - kukuha lang ito ng lista ng mga parisan at susubukang ipares ang katugmang URL. Si Django ay magsusuri ng mga parisan mula sa taas hanggang sa baba at kung may makita itong pares, ipapasa ni Django ang request sa isang kasamahan na function (na tinatawag na *view*).
+
+Isipan ang isang tagapagpadala ng mga sulat na may dalang liham. Naglalakad siya sa mga kalsada at isa-isa niyang tiningnan ang bawat bahay kung may tugma sa address na nakasulat sa liham. Kung may tugma, ilalagay niya ang liham doon. Ganito nagtatrabaho ang isang urlresolver!
+
+Sa *view* na function, lahat ng mga kaayayang mga bagay ay nagawa, pede mong tingnan ang database para magkuha ng mga impormasyon. Maaring hiniling ng user na baguhin ang data? Gaya ng isang liham na nagsasabing, "Pakipalitan ang paglalarawan ng aking trabaho." Maaring tingnan ng *view* kung ikaw ay may pahintulot na gawin ito, saka i-update niya ang paglalarawan ng trabaho para sa iyo at magpapadala ng mensahe na: "Tapos na!". Pagkatapos ang *view* ay gagawa ng sagot at ipapadala ito ni Django sa web browser ng user.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/tl-PH/django_admin/README.md b/tl-PH/django_admin/README.md
new file mode 100644
index 00000000000..7048c3e4036
--- /dev/null
+++ b/tl-PH/django_admin/README.md
@@ -0,0 +1,57 @@
+# Admin ng Django
+
+Para makadagdag, maka-edit, at makabura ng mga post na kakamodel lang, gagamitin natin ang admin ng Django.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Sa makikita mo, ating ini-import (isinama) ang model na Post na ating binigyan kahulugan sa dating kabanata. Para makita sa pahina ng admin ang ating model, kailangan natin itong i-rehistro gamit ang `admin.site.register(Post)`.
+
+Sige, oras na para tingnan ang ating model na Post. Huwag kalimutan na patakbuhin ang `python manage.py runserver` sa iyong console para gumana ang web server. Pumunta sa iyong browser at ilagay ang address na ito http://127.0.0.1:8000/admin/. Makikita mo ang pahina sa pag-login gaya nito:
+
+![Pahina para sa Login](images/login_page2.png)
+
+Para maglog-in, kailangan mong maglikha ng *superuser* - isang user account na may kontrol sa lahat ng laman ng site. Bumalik sa command line, at i-type ang `python manage.py createsuperuser`, at pindutin ang enter.
+
+> Tandaan, para maka sulat ng bagong mga command habang tumatakbo ang iyong web server, magbukas ng bagong terminal window at gawing aktibo ang iyong virtualenv. Kami ay nagbalik-aral kung paano magsulat ng mga bagong command kabanata na **Your first Django project!**, sa loob ng seksyon na **Starting the web server**.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/tl-PH/django_forms/README.md b/tl-PH/django_forms/README.md
new file mode 100644
index 00000000000..7fcd054993b
--- /dev/null
+++ b/tl-PH/django_forms/README.md
@@ -0,0 +1,475 @@
+# Mga Form ng Django
+
+Ang pinakahuling bagay na gusto nating gawin sa ating website ay ang paglikha ng magandang para para magdagdag at mag-edit ng mga post sa blog. Ang `admin ng Django` ay maganda, ngunit mahirap itong i-customize at pagandahin. Gamit ang mga `forms` magkakaroon tayo ng kapangyarihan sa ating interface - maari nating magawa ang kung ano man ang maisip natin!
+
+Ang maganda tungkol sa mga form ng Django ay maari tayong maglikha mula sa wala o maglikha ng `ModelForm` na magsi-save sa mga resulta ng form sa iyong model.
+
+Ito talaga ang gusto nating gawin: ang paglikha ng form para sa ating model na `Post`.
+
+Gaya ng bawat importanteng parte ng Django, ang mga form ay mayroong sariling file: `forms.py`.
+
+Kailangan nating maglikha ng file sa loob ng `blog` na directory na may ganitong pangalan.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+Ang `PostForm`, gaya ng suspetsa mo, ay ang pangalan ng ating form. Kailangan nating sabihan si Django na ang form na ito ay isang `ModelForm` (kaya gagawin ni Django ang mahika para sa atin) - `forms.ModelForm` ay responsable para dito.
+
+Sa sunod, meron tayong `class Meta`, kung saan sasabihan natin si Django kung alling model ang dapat gagamitin sa paglikha ng form na ito (`model = Post`).
+
+Sa wakas, pipiliin natin kung aling mga field ang dapat nasa form natin. Sa senaryo na ito, gusto lang natin na ipakita ang `pamagat` at `teksto` - `ang may-akda` ay dapat ang taong naka login (ikaw!) at ang `created_date` ay dapat awtomatikong na-set habang naglilikha tayo ng post (iyan ay sa loob ng code), di ba?
+
+At yan na! Ang kailangan nalang natin gawin ngayon ay ang paggamit ng form sa loob ng *view* at i-display ito sa loob ng template.
+
+Sa makaisa pa, gagawa tayo ng link papunta sa page, sa URL, sa view at sa template.
+
+## I-link sa isang page na may mga form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Kailangan natin ng `Save` na button. Magagawa natin ito gamit ang HTML button: `<button type="submit">Save</button>`.
+* At sa wakas, pagkatapos na opening na `<form ...>` tag, kailangan nating idagdag ang {% raw %}`{% csrf_token %}`{% endraw %}. Ito ay napakahalaga, dahil ginawa nitong matatag ang iyong mga form! Kung nakalimutan mo ang parte na ito, magsusumbong si Django kung susubukan mong i-save ang form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Nagsisave ng form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+{% filename %}blog/views.py{% endfilename %}
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Pagpapabalido ng Form
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## I-edit ang form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Seguridad
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## May isang bagay pa: oras na para mag-deploy!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Pagkatapos, sa loob ng [PythonAnywhere na Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/tl-PH/django_installation/README.md b/tl-PH/django_installation/README.md
new file mode 100644
index 00000000000..9fd8b8f05b3
--- /dev/null
+++ b/tl-PH/django_installation/README.md
@@ -0,0 +1,7 @@
+# Pag-install ng Django
+
+> **Paalala** Maaring gumagamit ka ng Chromebook, kung ganon, laktawan ang kabanatang ito at siguraduhing masunod mo ang mga tagubilin sa [Chromebook na Pag-setup](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/tl-PH/django_installation/instructions.md b/tl-PH/django_installation/instructions.md
new file mode 100644
index 00000000000..20bc6f4c62a
--- /dev/null
+++ b/tl-PH/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Kasama sa tuntuning ito ay nakabase sa mga tutorial ng Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Kasama sa tuntining ito ay nakabase sa [tutorial ng django-marcador](http://django-marcador.keimlink.de/) na lisensyado sa ilalim ng Creative Commons Attribution-ShareAlike 4.0 International License. Ang django-marcador na tutorial ay nakacopyright kay Markus Zapke-Gründemann et al.
+
+## Virtual na Kaligiran
+
+Bago tayo mag-install ng Django, mag-install muna tayo nang isa pang napakaimportanteng kagamitan na makakatulong na maging malinis ang ating coding environment sa iyong kompyuter. Maaring laktawan ang hakbang na ito, ngunit lubusan namin itong nirerekomenda. Ang pagsimula sa pinakamagandang setup na posible ay makaiwas sa napakaraming problema sa hinaharap!
+
+Kaya, maglikha tayo ng **virtual na environment** (tinatawag din na *virtualenv*). Ang virtualenv ay magbubukod sa iyong Python/Django na setup sa bawat proyekto. Ibig sabihin nito, lahat ng iyong mga binago sa iyong website ay hindi makaapekto sa iba mong ginagawa. Malinis, di ba?
+
+Ang kinakailangan mo lang gawin ay maghanap ng directory kung saan gusto mong maglikha ng `virtualenv`; ang iyong home directory, halimbawa. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+Para sa tutorial na ito, gagamit tayo ng bagong directory na `djangogirls` mula sa iyong home na directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Gagawa tayo ng isang virtualevn na tinatawag na `myenv`. Ang general na command ay nasa ganitong format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Para maglikha ng bagong `virtualenv`, kailangan mong buksan ang command prompt at patakbuhin ang `python -m venv myvenv`. Maging kagaya ito nito:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Kung saan ang `myvenv` ay ang pangalan ng iyong `virtualenv`. Maari kang gumamit ng ibang pangalan, pero mainam na gagamit ka ng maliliit na titik at walang mga agwat, tuldik o mga espesyal na letra. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` ang pangalan ng iyong `virtualenv`. Maari ka ring gumamit ng ibang pangalan, ngunit dapat maliit na titik at walang mga agwat. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **PAALALA:** Sa ibang bersyon ng Debian/Ubuntu maaring magatanggap ka ng sumunod na mga error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> Para dito, sundin mo ang mga tagubilin sa taas at mag-install ng `python3-venv` na package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **PAALALA:** Sa ibang bersyon ng Debian/Ubuntu ang pagpatakbo ng virtual environment na ito ay kasalukuyang magbigay ng sumusunod na problema:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Para maiwasan ito, gamitin mo ang `virtualenv` na ito.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **PAALALA:** Kung may error gaya nito
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> sa halip patakbuhin ito:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Paggamit ng virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Patakbuhin ang iyong virtual na environment sa pamamagitan ng pagpagpatakbo ng:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. Kapag nangyari ito, magbukas ng isa pang Windows PowerShell gamit ang "Run as Administrator" na opsyon. Pagkatapos, subukang magtype ng sumusunod na mga command bago patakbuhin ang iyong virtual na environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         Ang execution policy ay nakakatulong para maprotektahan ka sa mga script na hindi mo pinagkatiwalaan. Ang pagbaago ng execution policy ay maaring maghantad sa iyong sa mga panganib sa seguridad na nalalarawan sa about_Execution_Poilicies na mga pangtulong na mga paksa sa http://go.microsoft.com/fwlink/?LinkID=135170. Gusto mo bang baguhin ang iyong execution policy? [Y] Oo  [A] Oo sa Lahat  [N] Hindi  [L] Hindi sa Lahat  [S] I-suspende  [?] Tulong ( ang default ay "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/tl-PH/django_models/README.md b/tl-PH/django_models/README.md
new file mode 100644
index 00000000000..14eec43e0c9
--- /dev/null
+++ b/tl-PH/django_models/README.md
@@ -0,0 +1,201 @@
+# Mga model ng Django
+
+Ang gusto nating ilikha ngayon ay isang bagay na mag-imbak ng lahat ng ating mga post sa loob nag ating blog. Pero para magawa natin ito dapat nating pag-usapan ang tungkol sa mga bagay na tinatawag na `objects`.
+
+## Mga Object
+
+May isang konsepto sa pag-proprogram na tinatawag na `object-oriented na programming`. Ang ideya ay imbes na isulat ang lahat isip isang napakataas na datig ng mga programming na instruksyon, maari nating i-model ang mga bagay-bagay at bigyang kahulugan kung paano sila makipaghalubilo sa bawat isa.
+
+Kaya ano ang ibig sabihin ng object? Ito ay isang koleksyon ng mga katangian at mga askyon. Medyo kakaiba, pero bibigyan namin kayo ng halimbawa.
+
+Kung gusto mo na i-model ang isang pusa, gagawa tayo ng isang object na `Cat` na may mga katangian tulad ng `kulay`, `edad`, `kalagayan` (gaya ng maganda, pangit, o inaantok ;)), at ang `may-ari`(na maari ding gawing `Person` na object - o pede din na walang laman sa kaso ng mga gala na pusa).
+
+Pagkatapos ang `Cat` ay may mga aksyon: `purr`, `scratch`, o `feed` (kung saan, bibigyan natin ang pusa ng `CatFood` na maari ding gawing hiwalay na object na may katangian na gaya ng `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+Kaya, ang idea ay ang paglalarawan ng mga tunay na bagay sa ating code na may mga katangian (tinawag na `object properties`) at mga aksyon (tinatawag na mga `method`).
+
+Paano kaya natin i-model ang ating blog post? Gusto nating gumawa ng blog, di ba?
+
+Kailangan nating sagutin ang tano na: Ano ang blog post? Ano ang mga katangian na dapat meron ito?
+
+Sigurado tayo na ang ating blog post ay nangangailangan ng mga tekso sa nilalaman at sa pamagat nito, di ba? Mainam din na malaman natin kung sino ang nagsulat nito - kaya kailangan natin ng may-akda. Sa huli. gusto din nating malaman kung kailan nalikha at nailathala ang post.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Ano ang mga klaseng bagay ang maaring magawa sa blog post? Maganda kung makakaroon ng isang `method` na maglalathala ng mga post, di ba?
+
+Kaya, mangangailangan tayo ng `paglathala` na method.
+
+Dahil alam na natin kung ano ang gusto nating matamo, simulan na natin itong i-model sa Django!
+
+## Model ng Django
+
+Alam na natin kung ano ang object, maari na tayong maglikha ng model ng Django para sa ating blog post.
+
+Ang model sa Django ay isang espesyal na uri ng object - nakasave ito sa loob ng `database`. Ang database ay isang koleksyon ng mga datos. Ito ay lugar kung saan mo itatago ang mga impormasyon tungkol sa mga gumagamit, iyong mga blog post, at iba pa. Gagamit tayo ng SQLite na database para itago ang ating mga datos. Ito ay isang default na Django database adapter - ok na sa ating ito sa ngayon.
+
+Maaring mong isipin ang model sa isang database isip isang spreadsheet na may mga tudling (fields) at mga hanay (datos).
+
+### Paglikha ng aplikasyon
+
+Para maging malinis ang lahat, maglikha tayo ng hiwalay na aplikasyon sa loob ng ating proyekto. Maganda na maayos ang lahat sa simula pa lang. Para maglikha ng aplikasyon, kailangan nating patakbuhin ang sumusunod na command sa ating console (mula sa `djangogirls` na directory kung saan nandoon ang ating `manage.py` na file):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Paglikha ng model ng blog post
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Pakisuriin ulit at tingnan kong gumagamit ka ng dalawang salungguhit (`_`) sa bawat panig ng `str`. Ang kombensiyon na ito ay kadalasang ginagamit sa Python at minsan din naming tinatawag na "dunder" (pinaikling anyo ng "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` ay isang espesyal na keyword na nagpapakita na tayo ay nagbibigay kahulugan sa isang object.
+- Ang `Post` ay ang pangalan ng ating model. Maari natin itong bigyan ng ibang pangalan (pero dapat nating iwasan ang mga espesyal na titik at ang mga whitespace). Parating simulan ang pangalan ng class sa malaking titik.
+- Ang ibig sabihin ng `models.Model` ay ang Post ay isang Model ng Django, kaya alam ni Django na ito ay dapat nakasave sa database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- Ang `models.CharField` - ito ang paraan para ating ilarawan ang tekso na may nakatakdang bilang ng mga letra.
+- Ang `models.TextField` - ay para sa mga mahabang teksto na walang nakatakdang haba. Ito ay tamang-tama para gawing nilalaman ng blog post, di ba?
+- Ang `models.DateTimeField` - ito ay ang petsa at ang oras.
+- Ang `models.ForeignKey` - ay pag-uugnay sa isa pang model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Maglikha ng mga table para sa model sa loob ng database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/tl-PH/django_orm/README.md b/tl-PH/django_orm/README.md
new file mode 100644
index 00000000000..744103d2623
--- /dev/null
+++ b/tl-PH/django_orm/README.md
@@ -0,0 +1,221 @@
+# ORM at QuerySets ng Django
+
+Sa kabanatang ito matutunan mo kung paano si Django magkonek sa database at maglagay ng mga datos dito. Tara na!
+
+## Ano ang QuerySet?
+
+Ang QuerySet ay, masasabi natin na isang listahan ng mga object sa isang binigay na Model. Ang QuerySet ay nagbigay ng pamamaraan para mabasa mo ang mga datos mula sa database, mag-filter nito at mag-ayos ayon sa pagkasunod-sunod nito.
+
+Mas madali pag natutunan mo ito sa pamamagitan ng halimbawa, tara na?
+
+## Shell ng Django
+
+Bukasan ang iyong local na console (hindi yung sa PythonAnywhere) at i-type ang command na ito:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Ang epekto nito ay dapat ganito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### Lahat ng mga object
+
+Subukan nating magdisplay ng lahat ng ating mga post muna. Magagawa mo ito sa pamamagitan ng sumunod na command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Ayy! May problemang nakita. Sinasabi nito na walang umiiral na Post. Tama po ito - nakalimutan nating mag-import muna!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Ito ay ang listahan ng mga post na nalikha natin kanina lang. Nilikha natin ang mga post na mga ito gamit ang admin interface ng Django. Pero ngayon gusto nating maglikha ng mga bagong post gamit ang Python, paano kaya natin magagawa ito?
+
+### Create object
+
+Ito ang paraan para maglikha ng bagong Post na object sa ating database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Pero may nalilimutan tayong isang sangkap dito: `me`. Kailangan nating magpasa ng instance ng `User` na model isip may-akda. Paano natin magawa ito?
+
+Mag-import muna tayo ng User na model:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Anong mga gumagamit ang nasa loob ng ating database? Subukan natin ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Ngayon makakalikha na tayo ng post sa wakas:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Yay! Gusto mong tingnan kung gumana ba ito?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Ayon, may isang nadagdag na post sa listahan!
+
+### Magdagdag pa ng mga post
+
+Maari kang maglaro muna at magdagdag pa nga mga post para makita mo kung paano ito gumagana. Magdagdag ng dalawa o tatlo pa at pagkatapos ay punta na tayo sa sumunod na parte.
+
+### Mag-filter ng mga object
+
+Ang malaking parte ng QuerySet ay ang abilidad na pagfilter nito. Sabihin natin na gusto nating hanapin ang lahat ng post na sinulat ng user na si ola. Gagamit tayo ng `filter` sa halip na `all` sa ating `Post.objects.all()`. Sa panaklong, sasabihin natin ang (mga) kondisyon na dapat makita sa blog post para mapunta siya sa ating queryset. Sa kaso natin, ang kondisyon ay ang `author` ay dapat katumbas na `me`. Ang pamamaraan ng pagsulat nito sa Django ay `author=me`. Ngayon ang ating piraso ng code ay maging kagaya nito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+O maari din na gusto nating makita ang mga post na naglalaman ng salitang 'title' sa ating `title` na field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Paalala** May dalawang salungguhit na letra (`_`) sa pagitan ng `title` at ang `contains`. Ang ORM ni Django ay gumagamit ng mga tuntunin para ihiwalay ang mga field name na ("title") at ang mga operasyon o mga filter na ("contains"). Kung gagamit ka lang ng isang salungguhit, makakuha ka ng error gaya ng "FieldError: Cannot resolve keyword title_contains".
+
+Maaring ding makuha mo ang lahat ng nalathala na mga post. Magagawa natin ito sa pamamagitan ng pagfilter sa lahat ng posts na mayroong `published_date` na nakalipas na:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Sa kasamaang palad, ang post na ating nadagdag mula sa console ng Python ay hindi pa nalathala. Pero mababago natin ito! Una, kukuha tayo ng instance ng post na gusto nating ilathala:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+At i-publish ito gamit ang ating `publish` na method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Ngayon, subukan mong kumuha ng mga nailathala na mga post ulit (pindutin ang up na key ng tatlong beses at pindutin ang `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Pagkakaayos ng mga Object
+
+Ang QuerySet ay magtutulot sa iyo na ayusin ang lista ng mga object. Subukan nating iayos sila sa pamamagitan ng `created_date` na field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Maari din nating ibaligtad ang pagkakasunod sa pamamagitan ng pagdagdag ng `-` sa simula:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Ito ay tunay na makapangyarihan at sa pamamagitan nito maari kang gumawa ng mga komplekado na mga query.
+
+Magaling! Handa ka na ngayon sa susunod na parte! Para isara ang shell, i-type mo ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/tl-PH/django_start_project/README.md b/tl-PH/django_start_project/README.md
new file mode 100644
index 00000000000..710f0835fea
--- /dev/null
+++ b/tl-PH/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Ang kauna-unahang proyekto mo sa Django!
+
+> Kasama sa kabanatang ito ay nakabase sa mga tutorial ng Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Kasama sa kabanatang ito ay nakasalig sa [django-marcador na tutorial](http://django-marcador.keimlink.de/) na lisensyado sa ilalim ng Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador na tutorial ay nakacopyright kay Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+Ang unang hakbang ay ang pagsimula ng bagong proyekto sa Django. Ibig sabihin nito, magpapatakbo tayo ng mga script na ibinigay ni Django na maglikha ng banghay ng proyekto ng Django para sa atin. Ito ay lipon lang ng mga directory at mga file na gagamitin natin mamaya.
+
+Ang pangalan ng ibang file at directory ay nakaimportante para kay Django. Hindi mo dapat palitan ng pangalan ang mga file na ating malikha. Ang paglipat nito sa ibang lugar ay hindi rin magandang ideya. Kinakailangan ni Django na panatilihin ang istraktura nito para mahanap niya ang mga importanteng bagay.
+
+> Tandaan na patakbuhin ang mga ito sa loob ng virtualenv. Kung hindi ka makakita ng unlapi na `(myenv)` sa iyong console, kailangan mong gamitin ang iyong virtualenv. Ating naipaliwanag kung paano ito gawin sa **pag-install ng Django** na kabanata sa parte na **Working with virtualenv**. Ang pagtype ng `myenv\Scripts\activate` sa Windows o `source myenv/bin/activate` sa Mac OS X o Linux ang gagawa nito para sa iyo.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+Sa iyong Mac OS X o Linux na console, dapat mong patakbuhin ang sumusunod na mga command. **Huwag kalimutan ang magdagdag the tuldok `.` sa bandang huli!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Ang tuldok `.` ay mahalaga dahil nagsasabi ito sa script na i-install ang Django sa kasalukuyang directory (kung saan ang tuldok `.` ay ang pinaikling pagbanggit).
+> 
+> **Paalala** Habang nagtatype ng command sa taas, tandaan na ang dapat mo lang i-type ang parte na nagsisimula sa `django-admin`. Ang `(myenv) ~/djangogirls$` na parteng pinakita dito ay isa lang halimbawa sa prompt na magkukuha sa iyong input sa iyong command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Sa Windows dapat mong patakbuhin ang sumusunod na command. **(Huwag kalimutang magdagdag ng tuldok `.` sa bandang huli)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Ang period `.` ay mahalaga dahil ito ang nagsasabi sa script na i-install ang Django sa kasalukuyang directory (kung saan ang tuldok `.` ay ang pinaikling pagbanggit).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+Ang `django-admin.py` ay isang script na maglilikha ng mga directory at mga files para sa iyo. Sa ngayon dapat mayroon ka ng directory structure gaya nito:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Paalala**: sa iyong directory structure, makikita mo rin ang iyong `venv` na directory na nilikha natin kanina.
+
+Ang `manage.py` ay isang script na makakatulong sa pagpapamahala ng site. Gamit ito maaari tayong (bukod sa iba pang mga bagay) magpatakbo sa web server sa kompyuter nang hindi mag-install ng kahit na ano.
+
+Ang `settings.py` ay ang file na naglalaman ng mga kompigurasyon ng iyong website.
+
+Naalala mo ba noong nag-usap tayo tungkol sa mail carrier na nagsururi kung saan magpadala ng sulat? Ang `urls.py` ay isang file na nalalaman ng lista ng mga pattern na ginagamit ng `urlresolver`.
+
+Balewalain muna natin ang ibang mga file, sa ngayon hindi natin sila babaguhin. Ang dapat mo lang tandaan ay huwag aksidenteng mabura ang mga ito!
+
+## Pagbago ng mga setting
+
+Ngayon gagawa tayo ng mga pagbabago sa `mysite/settings.py`. Buksa ang file gamit ang iyong editor ng code na ininstall kanina.
+
+**Paalala**: Laging isipin na ang `settings.py` ay isang karaniwang file lang, gaya ng iba. Maari mo itong buksan sa loob ng editor ng code, gamit ang "file -> open" na aksyon ng menu. Ito ay magpalabas ng karaniwang window kung saan maari kang mag-navigate sa iyong `settings.py` at piliin ito. Ang alternatibo, maari mong buksan ang file sa pamamagitan ng pagnavigate sa djangogirls na folder sa iyong desktop at pag right-click nito. Pagkatapos, piliin mo ang iyong editor ng code mula sa listahan. Ang pagpili ng editor ay importante dahil maaring may ibang programang nakainstall na makapagbukas nito ngunit hindi ka hahayaang makapag-edit nito.
+
+Maganda sana kung may tamang oras tayo sa ating website. Pumunta sa [lista ng mga time zone ni Wikipedia](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) at kopyahin ang iyong time zone (TX) (e.g. `Europe/Berlin`).
+
+Sa `settings.py`, hanapin ang linya na naglalaman ng `TIME_ZONE` at baguhin ito gamit ang iyong timezone. Halimbawa:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. Kaya magkakaroon ka ng "Cancel" na button na naisalin sa wika na iyong binigay dito. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Kailangan din nating magdagdag ng mga path para sa ating static na mga file. (Malalaman natin ang lahat tungkol sa mga static na files at mga CSS sa mamayang parte ng tutorial.) Bumaba sa *katapusan* ng file, at sa baba ng `STATIC_URL` na entry, magdagdag ng bago na tinatawag na `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Kung ang `DEBUG` ay `True` at ang `ALLOWED_HOSTS` ay walang laman, ang host ay ihahambing sa `['localhost','127.0.0.1','[::1]']`. Ito ay hindi magtugma sa ating hostname sa PythonAnywhere pagkatapos nating i-deploy ang ating aplikasyon kaya kailangan nating baguhin ang sumusunod na setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Paalala**: Kung ikaw ay gumagamit ng Chromebook, idagdag ang linyang ito sa baba ng iyong settings.py na file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage''`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Mag-setup ng database
+
+May maraming iba-ibang dabatase na software ang maaaring magstore ng mga datos para sa ating site. Gagamit tayo ng default na, `sqlite3`.
+
+Ito ay nakaset-up na sa parteng ito ng ating `mysite/settings.py` na file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Para maglikha ng database para sa ating blog, patakbuhin natin ang sumunod sa ating console: `python manage.py migrate`(kailangan na nasa `djangogirls` na directory tayo na naglalaman ng `manage.py` na file). Kung walang problema, dapat makakita ka ng gaya nito:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+At tapos na tayo! Oras na para patakbuhin ang ating web server at tingnan kung gumana ang ating website!
+
+## Nagpapatakbo ng web server
+
+Kailangan kang nasa loob ng directory na naglalaman ng `manage.py` na file (ang `djangogirls` na directory). Sa console, mapatakbo natin ang web server sa pamamagitan ng pagpatakbo ng `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Kung ikaw ay nasa Chromebook, sa halip ay gamitin mo ang command na ito:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> Ating pinagbalik-aralan kung paano gumagana ang mga web server sa **How the Internet words** na kabanata.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/tl-PH/django_templates/README.md b/tl-PH/django_templates/README.md
new file mode 100644
index 00000000000..e454292ce80
--- /dev/null
+++ b/tl-PH/django_templates/README.md
@@ -0,0 +1,108 @@
+# Mga template ng Django
+
+Oras na para magpakita ng mga datos! Ang Django ay nagbibigay sa atin ng mga nakakatulong na mga built-it na mga **template na tags** para dito.
+
+## Ano ang mga template tags?
+
+Makita mo, sa HTML, hindi ka maaring magsulat ng code na Python, dahil hindi ito maiintindihan ng mga browser. Alam lang nila ang HTML. Alam natin na ang HTML ay hindi nababago, habang ang Python ay pabago-bago.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Magdisplay ng Post List na Template
+
+Sa nakaraang kabanata, binigyan natin ang ating template ng lista ng mga posts sa ating `posts` na variable. Ngayon, maari na natin itong ilagay sa HTML.
+
+Para magprint ng variable sa templates ng Django, gagamit tayo ng dobleng pamukod na may pangalan ng variable sa loob, gaya nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Subukan mo ito sa loob ng iyong `blog/templates/blog/post_list.html` na template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. I-save ang file, at i-refresh ang pahina para makita ang mga resulta:
+
+![Tambilang 13.1](images/step1.png)
+
+Gaya nang makikita mo, ang lahat ng nakuha natin ay ito lang:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Ibig sabihin nito ay naintindihan ni Django na ito ay isang lista ng mga object. Natandaan mo mula sa **Introduksyon sa Python** kung paano nati mapakita ang mga lista? Oo, gamit ang for loops! Sa Django template gagawin natin ito gaya nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Subukan ito sa iyong template.
+
+![Tambilang 13.2](images/step2.png)
+
+Gumana ito! Pero gusto nating i-display ang mga post gaya ng mga static na post na ginawa natin kanina sa **Introduksyon sa HTML** na kabanata. Maari mong ihalo ang HTML at ang mga template tags. Ang ating `body` ay magmukhang ganito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Lahat ng nilagay mo sa pagitan ng `{% for %}` at `{% endfor %}` ay uulitin sa bawat object na nasa list. I-refresh ang iyong pahina:{% endraw %}
+
+![Tambilang 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? Tayo ay kukuha ng mga datos sa bawat field na nakalarawan sa ating `Post` na model. At, ang `|linebreaksbr` ay nagpipe nga mga teskto ng post sa filter para i-convert ang mga line-break sa mga talata.
+
+## Isa pang bagay
+
+Magandang tingnan kung ang website ay gumagana pa rin sa publikong Internet, di ba? Subukan nating mag-deploy sa PythonAnywhere ulit. Eto ay pagbibigay buod sa mga hakbang…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Pagkatapos, maglog ulit sa [PythonAnywhere](https://www.pythonanywhere.com/consoles/) at pumunta sa iyong **Bash na console** (o magpatakbo ng isa pa), at patakbuhin ang:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/tl-PH/django_urls/README.md b/tl-PH/django_urls/README.md
new file mode 100644
index 00000000000..e679a9c8f5a
--- /dev/null
+++ b/tl-PH/django_urls/README.md
@@ -0,0 +1,103 @@
+# Mga URL ng Django
+
+Tayo ay gagawa ng ating kauna-unahang webpage: ang homepage para sa iyong blog! Pero una, pag-aralan muna natin ang tungkol sa mga URLs ng Django.
+
+## Ano ang URL?
+
+A URL is a web address. Makikita mo ang URL sa bawat oras na bibisita ka ng website - makikita mo ito sa address bar ng iyong browser. (Oo! ang `127.0.0.1:8000` ay isang URL! At ang `https://djangogirls.org` ay isa ring URL.)
+
+![URL](images/url.png)
+
+Bawat pahina na nasa Internet ay nangangailangan ng sariling URL. Sa ganitong paraan, malalaman ng iyong aplikasyon kung ano dapat ang ipakita niya sa user na nagbubukas ng URL na ito. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## Paano gumagana ang mga URL sa Django?
+
+Buksan natin ang `mysite/urls.py` na file sa ating editor ng code at tingnan natin ang laman nito:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Makikita mo, may nilagay na si Django doon para sa atin.
+
+Ang mga linya sa pagitan ng tripleng mga panipi (`'''` or `"""`) ay tinatawag na mga docstrings - maari mo silang isulat sa taas ng file, class, o method para ilarawan kung ano ang ginagawa nito. Hindi sila papatakbuhin ni Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Ang ibig sabihin ng linyang ito ay bawat URL na nagsisimula sa `admin/`, si Django ay maghahanap ng katugmang *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/tl-PH/django_views/README.md b/tl-PH/django_views/README.md
new file mode 100644
index 00000000000..863fb17278c
--- /dev/null
+++ b/tl-PH/django_views/README.md
@@ -0,0 +1,44 @@
+# Mga view ng Django - oras na para maglikha!
+
+Oras na para ayusin ang bug na nagawa natin sa huling kabanata! :)
+
+Ang *view* ay isang lugar kung saan natin ilalagay ang "logic" ng ating aplikasyon. Humihingi ito ng mga impormasyon galing sa ating `model` na nalikha dati at ipasa niya ito sa `template`. Gagawa tayo ng template sa susunod na kabanata. Ang mga view ay mga functions ng Python na medyo mahirap kung ikumpara natin sa mga nasulat natin sa **Introduksyon sa Python** na kabanata.
+
+Ang mga view ay nakalagay sa `views.py` na file. Magdadagdag tayo ng *views* sa ating `blog/views.py` na file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Maglikha ng iyong mga view dito.
+```
+
+Wala pang masyadong nakasulat dito.
+
+Tandaan na ang linya na nagsisimula sa `#` ay mga komento - ibig sabihin na ang mga linyang ito ay hindi papatakbuhin ni Python.
+
+Gagawa tayo ng *view* gaya ng inimungkahe sa komento. Idagdag ang sumusunod na minimal view sa baba nito:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+I-save ang file, puntahan ang http://127.0.0.1:8000/ at tingnan kung ano ang laman.
+
+May ibang error na naman! Basahin kung ano ang nangyari ngayon:
+
+![Error](images/error.png)
+
+Ito ay nagpapakita na ang server ay tumatakbo na ulit, pero hindi pa rin ito tama, di ba? Huwag mag-alala, isa lang itong error page, walang dapat na katakutan! Gaya ng mga error messages sa console, ang mga ito ay talagang nakakatulong. Mabasa mo ang *TemplateDoesNotExist*. Ayusin natin ang bug at maglikha tayo ng template sa susunod na kabanata!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/tl-PH/dynamic_data_in_templates/README.md b/tl-PH/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..28b28f20e77
--- /dev/null
+++ b/tl-PH/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Mga dynamic na datos sa mga template
+
+Mayroon tayong iba-ibang piraso na nakaposisyon: ang `Post` na model na nakadefine sa `models.py`, ang `post_list` sa `views.py` at ang template na dinagdag. Ngunit paano natin gawin na mapakita ang ating mga post sa ating HTML template? Dahil yan ang gusto nating gawin - kumuha ng mga nilalaman (mga model nakasave sa database) at ipakita itong mabuti sa ating template, di ba?
+
+Ito ang eksaktong dapat gawain ng *views*: magkonek sa mga model at mga template. Sa ating `post_list` na *view*, kailangan nating kunin ang mga model na gusto nating i-display at ipasa ang mga ito sa ating template. Sa *view* pagpasyahan natin kung anong model ang idisplay sa template.
+
+Sige, kaya paano natin magagawa ito?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Naalala mo iyong pinag-usapan natin ang tungkol sa pag-include na mga code na naisulat sa iba-ibang mga file? Ngayon na ang oras na kailangan nating i-include ang ating model na sinulat sa `models.py`. Magdagdag tayo ng linya na `from .models import Post` gaya nito:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+Ang ibig sabihin ng tuldok bago ang `models` ay *kasalukuyang directory* o *kasalukuyang aplikasyon*. Ang `views.py` at `models.py` ay parehong nasa kagayang directory. Ibig sabihin nito, maari tayong gumamit ng `.` at ang pangalan ng file (na walang `.py`). Pagkatapos i-import natin ang pangalan ng model na (`Post`).
+
+Pero ano ang kasunod? Para makuha ang tunay na blog post mula sa `Post` na model, kailangan natin ang tinatawag na `QuerySet`.
+
+## QuerySet
+
+Dapat kabisado mo na kung paano gumagana ang QuerySets. Napag-usapan na natin ang tungkol dito sa [Django ORM (QuerySets) na kabanata](../django_orm/README.md).
+
+Ngayon, gusto natin na ang nalathala na mga blog posts ay nasuri ayon sa pagkasunod-sunod ng `published_date`, tama ba? Nagawa na natin ito sa QuerySets na kabanata!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Tandaan na naglikha tayo ng *variable* para sa ating QuerySet: `posts`. Isipin itong pangalan ng ating QuerySet. Simula ngayon, tatawagin natin ito sa pamamagitan ng pangalan na ito.
+
+Sa `render` na function mayroon tayong isang parameter na `request` (lahat ng natanggap natin mula sa user sa pamamagitan ng Internet) at isa pa na nagbigay ng template file (`'blog/post_list.html'`). Ang pinakahuling parameter, `{}`, ay lugar kung saan maari tayong magdagdag ng mga bagay para magamit ng ating template. Kailangan natin silang bigyan ng pangalan (sa ngayon `'posts'` pa rin ang gagamitin natin). :) Dapat itong maging kagaya nito: `{'posts': posts}`. Tandaan na ang parte bago ang `:` ay isang string; dapat itong nakabalot sa mga panipi: `"`.
+
+Sa wakas ang ating `blog/views.py` na file ay maging kagaya nito:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+Ayun na! Oras na para bumalik sa aming template at ipakita itong QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/tl-PH/extend_your_application/README.md b/tl-PH/extend_your_application/README.md
new file mode 100644
index 00000000000..1177547af6b
--- /dev/null
+++ b/tl-PH/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Patagalin pa ang iyong application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Gumawa ng isang template sa detalye ng isang post
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Maglikha ng URL para sa detalye ng post
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Magdagdag ng view para sa detalye ng post
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Gumawa ng template para sa mga detalye ng post
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/tl-PH/how_the_internet_works/README.md b/tl-PH/how_the_internet_works/README.md
new file mode 100644
index 00000000000..cfc173e6200
--- /dev/null
+++ b/tl-PH/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Paano gumagana ang Internet
+
+> Para sa mga nagbabasa sa bahay: sa kabanatang ito nakalakip ang [Paano Gumagana ang Internet](https://www.youtube.com/watch?v=oM9yAA09wdc) na video.
+> 
+> Ang kabanatang ito ay binigyang inspirasyon sa talumpati ni Jessica McKellar na "How the Internet works" (http://web.mit.edu/jesstess/www/).
+
+Sa tingin namin ay araw-araw kang gumagamit ng Internet. Pero alam mo ba kung ano talaga ang nangyari kapag nag-type ka na address gaya ng https://djangogirls.org sa iyong browser at pinindot ang `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Ang mga web browser ay ginawa para magbasa ng code, sumunod sa mga instruksyon, at magpresenta sa mga file na ito na bumuo sa iyong website, eksakto kung paano mo ito gusto.
+
+Sa bawat file, kailangan nating ilagay ang mga HTML files sa hard disk. Para sa Internet, gagamit tayo ng espesyal, malalakas na mga kompyuter na tinatawag na *servers*. Wala silang screen, mouse o keyboard, dahil ang pangunahin gamit lang nila ay magstore ng datos at magsilbi nito. Kaya sila tinawag na *servers* - dahil sila ay *tagasilbi* ng iyong mga datos.
+
+Sige, ngunit gusto mong malaman kung paano gumana ang Internet, di ba?
+
+Ginuhit namit ito para sa iyo! Mukha itong ganito:
+
+![Tambilang 1.1](images/internet_1.png)
+
+Ang gulo, di ba? Sa totoo lang, ito ay isang network ng mga nakakonektang mga makina (ang nabanggit na mga *servers*). Daan-dang libong mga makina! Marami, napakaraming kilometro na mga kable sa buong mundo! Maari mong bisitahin ang Submarine Cable Map na website (http://submarinecablemap.com) para makita mo kung gaano ito ka masalimuot ang net. Ito ang screenshot mula sa website:
+
+![Tambilang 1.2](images/internet_3.png)
+
+Kawili-wili ito, di ba? But it is not possible to have a wire between every machine connected to the Internet. Kaya, para maabot ang mga makina (halimbawa, ang makina kung saan naka-save ang https://djangogirls.org) kailangan nating magpasa ng request sa napakarami at iba-ibang mga makina.
+
+Maging kagaya ito ito:
+
+![Tambilang 1.3](images/internet_2.png)
+
+Isipin na kung magtatype ka ng https://djangogirls.org, ikaw ay nagpapadala ng sulat na nagsasabing: "Minamahal kong Django Girls, gusto kong makita ang djangogirls.org na website. Ipadala ito sa akin, please!"
+
+Ang iyong sulat ay napunta sa iyong pinakamalapit na post office. Pagkatapos ay napunta ito sa malapit ng kaunti sa pinapadalhan mo, tapos sa isa pa, at isa pa hanggang sa napadala na ito sa destinasyon. Ang tanging nag-iisang bagay lang, kung mag papadala ka ng maraming mga sulat (*data packets*) sa parehong lugar, maaring silang mapunta sa iba-ibang mga koreo (*routers*). Nakadepende ito kung paano sila naipamahagi sa bawat opisina.
+
+![Tambilang 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Sa halip na mga address na may mga pangalan ng daan, zip code, at pangalan ng bansa, gagamit tayo ng IP na mga address. Ang iyong komputer ay magtatanong muna sa DNS (Domain Name System) na isalin ang djangogirls.org sa IP address. Gumana ito gaya ng mga lumang mga phonebook kung saan maghahanap ka na pangalan ng tao na gusto mong ikontak at hanapin ang kanilang numero ng telepono at address.
+
+Kung magpapadala ka ng sulat, kailangan itong magkaroon nga mga tiyak na katangian para mapadala ito ng tama: ang address, ang selyo, at iba pa. Maari ka ring gumamit ng wika na maiintindihan ng tagatanggap, di ba? Pareho din sa *data packets* na pinadala mo para makita ang website. Gumamit tayo ng protocol na tinatawag ng HTTP (Hypertext Transfer Protocol).
+
+Kaya, kung mayroon kang website, kailangan mong magkaroon ng *server* (makina) kung saan ito nakatira. Kung ang *server* ay nakatanggap ng paparating na *request* (sa sulat), ipapadala nito pabalik ang iyong website (sa ibang sulat).
+
+Dahil ito ay isang Django na tutorial, maaring nakapagtanong ka kung ano ang ginagawa ni Django. Kung magpapadala ka ng sagot, hindi mo kinakailangan magpadala ng parehang mensahe sa lahat. Mas maganda kung ang mga sulat ay personalized, lalong lalo na sa tao na kakasulat lang sa iyo, di ba? Si Django ay tumutulong sa iyo para makalikha ng mga personalized at kawili-wili na mga sulat. :)
+
+Tapos na ang usapan - oras na para lumikha!
\ No newline at end of file
diff --git a/tl-PH/html/README.md b/tl-PH/html/README.md
new file mode 100644
index 00000000000..56d81723763
--- /dev/null
+++ b/tl-PH/html/README.md
@@ -0,0 +1,227 @@
+# Introduksyon sa HTML
+
+Ano ang template, maaring nakapagtanong ka?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+Ang format ng Django template ay inilarawan sa wika na tinatawag na HTML (ito ang HTML na nabanggit natin sa unang kabanata, **Paano gumagana ang Internet**).
+
+## Ano ang HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+Ang HTML ay kumakatawan sa "HyperText Markup Language". Ang **HyperText** na ibig sabihin ay tipo ng teksto na sumusuporta ng mga hyperlinks sa pagitan ng pahina. Ang **Markup** na ibig sabihin na kumukuha tayo ng dokumento at minarkahan ito ng code para magsabi (sa kasong ito, ang browser) kung paano isalin ang pahina. Ang HTML code ay nagawa gamit ang mga **tags**, bawat isa ay nagsisimula sa `<` at nagtatapos sa `>`. Ang mga tag na ito ay kumakatawan sa markup na mga **elemento**.
+
+## Ang iyong unang template!
+
+Ang paggawa ng isang template ay nangangahulugan ng paggawa ng isang template file. Lahat ay file, tama? Malamang ay napuna mo na ito.
+
+Ang mga templates ay naka-save sa `blog/templates/blog` na directory. Una, ay gumawa ng isang directory na tinatawag na `templates` sa loob ng iyong blog directory. Pagkatapos ay gumawa ng isa pang directory na tinatawag na `blog` sa loob ng iyong templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+At ngayon, gumawa ng isang `post_list.html` na file (hayaan itong blangko sa ngayon) sa loob ng `blog/templates/blog` na directory.
+
+Tingnan kung ano ang hitsura ng iyong website ngayon: http://127.0.0.1:8000/
+
+> Kung mayroon ka pang error na `TemplateDoesNotExist`, subukan mong i-restart ang iyong server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Tambilang 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+Ano ang hitsura ng iyong website ngayon? Dalawin ito upang malaman: http://127.0.0.1:8000/
+
+![Tambilang 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Ulo at katawan
+
+Ang bawat HTML page ay nahahati din sa dalawang elemento: **head** at **body**.
+
+* Ang **head** ay isang elemento na naglalaman ng impormasyon tungkol sa dokumento na hindi ipinapakita sa screen.
+
+* Ang **body** ay isang elemento na naglalaman ng lahat ng bagay na ipinapakita bilang parte ng web page.
+
+Ating ginagamit ang `<head>` upang sabihan ang browser tungkol sa kumpigurasyon ng page, at `<body>` upang sabihan ito kung ano talaga ang nasa page.
+
+Halimbawa, maaari mong ilagay ang web page title na elemento sa loob ng `<head>`, katulad nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+I-save ang file at i-refresh ang iyong page.
+
+![Tambilang 11.3](images/step4.png)
+
+Punain kung paano naintindihan ng browser na ang "Blog ni Ola" ay ang pamagat ng iyong page? Binigyan-kahulugan nito ang `<title>Ola'sblog</title>` at inilagay ang teksto sa title bar ng iyong browser (ito rin ay gagamitin para sa mga bookmark at iba pa).
+
+Marahil ay napansin mo rin na ang bawat isang opening tag ay itinugma sa *closing tag*, na may ``, at ang mga elemento ay *nested* (i.e. hindi mo maisasara ang partikular na tag hanggang ang lahat ng mga nasa loob nito ay naisara na rin).
+
+Ito ay kagaya ng paglalagay ng mga bagay sa mga kahon. Ikaw ay mayroong isang malaking kahon, `<html></html>`; sa loob nito ay mayroong `<body></body>`, at ito ay naglalaman ng mas maliit na mga kahon: `<p></p>`.
+
+Kinakailangan mong sundin ang mga panuntunan na ito ng *closing* ng mga tag, at ng *nesting* ng mga elemento - kung hindi mo ito gawin, ang browser ay maaaring hindi mabigyang-kahulugan ito ng maayos at ang iyong pahina ay maipapakita ng hindi tama.
+
+## I-customize ang template
+
+Maaari ka na ngayong magkaroon ng kaunting kasiyahan at subukang i-customize ang iyong template! Nandito ang ilang mga kapaki-pakinabang na mga tag para diyan:
+
+* `<h1>A heading</h1>` para sa iyong pinaka-importanteng heading
+* `<h2>A sub-heading</h2>` para sa isang heading sa susunod na antas
+* `<h3>A sub-sub-heading</h3>`… at iba pa, hanggang `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` binibigyang-diin ang iyong teksto
+* `<strong>text</strong>`mahigpit na binibigyang-diin ang iyong teksto
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` lumilikha ng isang link
+* `<ul><li> first item</li><li>second item</li></ul>` gumagawa ng isang listahan, kagaya ng isang ito!
+* `<div></div>` tumutukoy sa isang seksyon ng pahina
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Nandito ang isang halimbawa ng isang buong template, kopyahin at ilagay ito sa `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Ito ay nagbibigay sa atin ng effect na ito:
+
+![Tambilang 11.4](images/step6.png)
+
+Yaay! Ngunit sa ngayon, ang ating template ay nagpapakita lamang ng eksaktong **the same information** - samantalang kanina tayo ay nag-uusap tungkol sa mga template bilang nagpapahintulot sa ating magpakita ng **different** impormasyon sa **same format**.
+
+Ang gusto talaga nating gawin ay ang magpakita ng mga totoong post na naidagdag sa ating Django admin - at diyan ang sunod nating pupuntahan.
+
+## Isa pang bagay: mag-deploy!
+
+Makabubuting makita ang lahat ng ito at live sa Internet, hindi ba? Gumawa tayo ulit ng ibang PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+Una sa lahat, tingnan natin kung anong mga file ang nagbago mula noong huli tayong nag-deploy (patakbuhin ang mga command sa lugar na ito, hindi sa PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Bago natin i-upload ang lahat ng mga file, tingnan natin kung ano ang i-a-upload ni `git` (ang lahat ng mga file na i-a-upload ni `git` ay dapat nang lumitaw ngayon sa berde):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Malapit na tayo, oras na ngayon upang sabihan ito na i-save ang mga pagbabago sa kasaysayan nito. Bibigyan natin ito ng isang "commit message" kung saan natin ilalaraan kung ano ang ating mga binago. Maaari kang mag-type ng kahit na anong gusto mo sa yugtong ito, ngunit makatutulong mag-type ng isang bagay na naglalarawan upang maaalala mo ang iyong nagawa sa hinaharap.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Binago ang HTML para sa site na ito."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Sa sandaling nagawa na natin iyan, i-a-upload natin (ipasa) ang ating mga pagbabago sa Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Hilahin ang iyong bagong code pababa sa PythonAnywhere, at i-reload ang iyong web app
+
+* Buksan ang [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) at pumunta sa iyong **Bash console** (o magsimula ng panibago). Pagkatapos ay patakbuhin ang:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/tl-PH/installation/README.md b/tl-PH/installation/README.md
new file mode 100644
index 00000000000..2af1c6932cb
--- /dev/null
+++ b/tl-PH/installation/README.md
@@ -0,0 +1,68 @@
+# Kung ginagawa mo ang pagtuturo sa bahay
+
+Kung ginagawa mo ang pagtuturo sa bahay, hindi sa isa sa mga [Django Girls events](https://djangogirls.org/events/), maaari mong ganap na laktawan ang kabanatang ito ngayon at dumiretso sa [Paano gumana ang Internet](../how_the_internet_works/README.md) na kabanata.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/tl-PH/intro_to_command_line/README.md b/tl-PH/intro_to_command_line/README.md
new file mode 100644
index 00000000000..ccb1132d23b
--- /dev/null
+++ b/tl-PH/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduksyon sa command-line na interface
+
+> Para sa mga magbabasa sa bahay: ang kabanatang ito ay kalakip sa [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) na video.
+
+Ito ay kapanapanabik, hindi ba?! Magsusulat ka ng pinakauna mong linya ng code sa loob lamang ng ilang minuto! :)
+
+**Ipapakilala ka namin sa iyong kauna-una at bagong kaibigan: ang command line!**
+
+The sumusunod na mga hakbang ay magpapakita sa iyo ng isang black na window na ginagamit ng lahat ng mga hacker. Maaring itong nakakatakot sa simula pero ito ay isang prompt lang na naghahantay ng mga utos galing sa iyon.
+
+> **Paalala** Tandaan na sa kabuuan ng aklat na ito gagamit tayo ng mga termino na minsan napagpalit, ang 'directory' at 'folder', ngunit sila ay iisa at pareho lang.
+
+## Ano ang command line?
+
+Ang window, na kadalasang tinatawag na **command line** o **command-line na interface**, ay isang text-based na aplikasyon para makita, makontrol, at mamanipula ang mga file sa iyong kompyuter. Kagaya lang ito ng Windows Explorer o Finder sa Mac, ngunit walang graphical na interface. Ang ibang pangalan ng command line ay: *cmd*, *CLI*, *prompt*, *console* o *terminal*.
+
+## Buksan ang command-line na interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Ang una mong command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Mga Basic
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Kasalukuyang directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solusyon:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Buod
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Paglalarawan                       | Halimbawa                                          |
+| ----------------- | ------------------------ | ---------------------------------- | -------------------------------------------------- |
+| exit              | exit                     | isara ang window                   | **exit**                                           |
+| cd                | cd                       | baguhin ang directory              | **cd tesr**                                        |
+| cd                | pwd                      | ipakita ang kasalukuyang directory | **cd** (Windows) o **pwd** (Mac OS / Linux)        |
+| dir               | ls                       | lista ng mga directory/files       | **dir**                                            |
+| kopya             | cp                       | kopyahin ang file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| ilipat            | mv                       | maglipat ng file                   | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | maglikha ng bagong directory       | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | burahin ang file                   | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | magbura ng directory               | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command             | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Handa ka na ba?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/tl-PH/intro_to_command_line/open_instructions.md b/tl-PH/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/tl-PH/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/tl-PH/python_installation/README.md b/tl-PH/python_installation/README.md
new file mode 100644
index 00000000000..e9df8659e96
--- /dev/null
+++ b/tl-PH/python_installation/README.md
@@ -0,0 +1,15 @@
+# Simulan natin ang Pythin
+
+Nandito na tayo sa wakas!
+
+Pero una, sasabihin muna namin kung ano ang Python. Ang python ay isang popular na wika na ginagamit sa programming na maaring gamitin sa paglikha ng mga website, mga laro, mga scientific na mga sofware, graphics at marami pang iba.
+
+Ang python ay nagsimula sa katapusan ng 1980 at ang pangunahing layunin nito ay para madali itong mabasa ng mga tao (hindi lang sa mga makina!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Pag-install ng python
+
+> **Paalala** Kung ikaw ay gumagamit ng isang Chromebook, laktawan ang kabanatang ito at siguraduhin na masunod mo ang mga tagubilin sa [Chromebook Setup](../chromebook_setup/README.md).
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/tl-PH/python_installation/instructions.md b/tl-PH/python_installation/instructions.md
new file mode 100644
index 00000000000..08b5182c676
--- /dev/null
+++ b/tl-PH/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Para sa mga magbabasa sa bahay: ang kabanatang ito ay kalakip sa [Installing Python& Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) na video.
+> 
+> Ang bahaging ito ay naka-base sa isang tutorial ng Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/tl-PH/python_introduction/README.md b/tl-PH/python_introduction/README.md
new file mode 100644
index 00000000000..62b77039ad2
--- /dev/null
+++ b/tl-PH/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduksyon sa Python
+
+> Parte ng kabanatang ito ay nakabase sa tutorial ng Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Prompt ng python
+
+> Para sa mga nagbabasa sa bahay: ang parteng ito ay nalakip sa [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) na video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Ang una mong Python na pag-uutos!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 -1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Mga String
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Buod
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – ang pagta-type ng mga utos (code) patungo sa Python ay nagdudulot ng mga resulta ng mga kasagutan sa Python
+- **numbers and strings** –sa Python, ang mga numero ay ginagamit sa math at ang mga strings para sa text objects
+- **operators** – tulad ng `+` and `*`, pagsamahin ang mga value upang makagawa ng bago
+- **mga function** – tulad ng `upper()` at `len()`, ay nagsasagawa ng mga aksyon sa mga objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Mga problema
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- Ang `str` na function ay nagko-convert ng mga bagay para maging **strings**
+- Ang `int` na function ay nagko-convert ng mga bagay para maging **integers**
+
+> Mahalaga: maari nating i-convert ang mga numero para maging teksto, ngunit hindi natin maaaring i-convert ang teksto para maging mga numero – magiging ano ang `int('hello')` kung gayon?
+
+## Mga variable
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}commad-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## Ang print na function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Mga Lista
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reversed()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Mga Diksyunaryo
+
+> Para sa mga nagbabasa sa bahay: ang parteng ito ay nakalakip sa [Basics sa Python: Mga Diksyonaryo](https://www.youtube.com/watch?v=ZX1CVvZLE6c) na video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- Ang key na `name` ay nagtuturo sa value na `'Ola'` (na isang `string` na object),
+- ang `country` ay nagtuturo sa `'Poland'` (isa na namang `string`),
+- at ang `favorite_numbers` nagtuturo sa `[7, 42, 92]` (isang `lista` na may tatlong numero sa loob nito).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Kailangan mo ba ng nakahanay na pagkakasunod ng mga aytems? Gumamit ng list.
+- Kailangan mo bang i-ugnay ang mga value sa mga key, upang mahusay mong mahanap ang mga ito (sa pamamagitan ng key) sa ibang pagkakataon? Gumamit ng diksyunaryo.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Buod
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** - alam mo na paano magbasa at umintindi ng mga error na makikita kung si Python ay hindi nakaintindi sa command na binigay dito
+- **variables** - mga pangalan para sa object na makakatulong na madaling makagawa ng code at gawing madaling basahin ang iyong code
+- **lists** - mga lista ng mga object na nakahanay sa isang partikular na pagkakasunod
+- **dictionaries** - mga object na nakaimbak gamit ang key-value na mga pares
+
+Excited for the next part? :)
+
+## Ihambing ang mga bagay
+
+> Para sa mga nababasaha sa bahay: ang parteng ito ay nakalakip sa [Basics ng Python: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) na video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- ang ibig sabihin ng x `>` y ay: x ay mas malaki pa sa y
+- ang ibig sabihin ng x `<` y ay: si x ay maliit pa sa y
+- ang ibig sabihin ng x `<=` y ay: si x maliit pa o katumbas ni y
+- ang ibig sabihin ng x `>=` y ay: si x ay mas malaki pa o katumbas ni y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** - kung gagamit ka ng `and` na operator, ang inihambing ay dapat kailangang True para maging True ang buong command
+- **or** - kung gagamit ka ng `or` operator, isa lang sa inihambing ang dapat True para maging True ang buong command
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# I-save ito!
+
+> Para sa mga nagbabasa sa bahay: ang parteng ito ay nakalakip na sa [Python Basics: Saving Files at "If" na mga statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) na video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Lumabas sa Python na interpreter
+- Buksan ang iyong code editor na napili
+- Mag-save ng ilang code sa bagong python na file
+- Patakbuhin ito!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Paalala** Dapat mapansin mo ang pinakamagandang bagay tungkol sa mga code editor: ang mga kulay! Sa Python na console, ang lahat ay may parehong kulay; ngayon dapat makita mo na ang `print` na function ay magkaiba ang kulay sa string. Ito ay tinatawag na "syntax highlighting", ay ito ay sobrang nakakatulong na feature habang gumagawa ng code. Ang mga kulay ng bagay-bagay ay magbibigay sa iyo ng mga mungkahi, gaya ng hindi nasara na mga strings o may typo sa pangalan ng keyword (tulad ng `def` sa isang function, na makikita natin sa baba). Ito ang isa sa mga rason kung bakit tayo gumagamit ng code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### Paano kung ang kondisyon ay hindi True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Mahusay, naririnig ko ang lahat ng mga detalye
+    
+
+## Mga Komento
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Palitan ang volume kung ito ay masyadong maingay o masyadong mahina
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Buod
+
+In the last few exercises you learned about:
+
+- **Paghambing ng mga bagay-bagay** - sa Python maari mong ihambing ang mga bagay-bagay gamit ang `>`, `>=`, `==`, `<=`, `<` at ang `and`, `or` na mga operators
+- **Boolean** - isang tipo ng object na maari lang magkaroon ng dalawang value: `True` o `False`
+- **Pag-save ng files** - ang pag-store ng code sa mga file para mapatakbo ang malaking mga program.
+- **if … elif … else** - mga statement na magbibigay sa atin ng kakayahan na magpatakbo ng code kung naabot ang iilang mga konsiyon lamang.
+- **mga comments** linya na hindi papatakbuhin ni Python na nagbibigay sa atin ng paraan na madokumento natin ang ating code
+
+Time for the last part of this chapter!
+
+## Ang iyong sariling mga function!
+
+> Para sa mga nagbabasa sa bahay: ang parteng ito ay nakalakip sa [Basics sa Python: Mga Functions](https://www.youtube.com/watch?v=5owr-6suOl0) na video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- Kung nakakuha ka ng `NameError`, siguro ang ibig sabihin nito ay may na-type kang mali, kaya dapat suriin mo kung gumagamit ka ba ng parehong pangaan habang naglikha ng function gamit ang `def hi();` at habang tinatawag ito gamit ang `hi()`.
+- Kung nakakuha ka ng `IndentationError`, tingnan kung ang dalawang `print` na mga linya ay mayroong whitespace sa simula ng linya: gusto ni python na maganda ang pagkalinya ng mga code sa loob ng function.
+- Kung wala talagang output, tingnan kung ang huling `hi()` *ay hindi* naka-indent - kung naka-indent, ang linyang iyan ay magiging parte din ng function, at hindi ito mapatakbo kahit kailan.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Mga Loop
+
+> Para sa mga nagbabasa sa bahay: ang parteng ito ay nakalakip sa [Basics sa Python: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) na video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+para sa pangalan ng mga babae:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Sunod na babae
+    Hi Monica!
+    Sunod na babae
+    Hi Phoebe!
+    Sunod na babae
+    Hi Ola!
+    Sunod na babae
+    Hi You!
+    Sunod na babae
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+para sa i sa range na (1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Buod
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/tl-PH/template_extending/README.md b/tl-PH/template_extending/README.md
new file mode 100644
index 00000000000..161e45e16af
--- /dev/null
+++ b/tl-PH/template_extending/README.md
@@ -0,0 +1,151 @@
+# Pag-extend ng template
+
+Isa pang magandang bagay na mayroon ang Django para sa iyo ay **template extending**. Ano ang ibig sabihin nito? Ibig sabihin nito ay maaari mong gamitin ang parehong mga parte ng iyong HTML sa iba't ibang pahina ng iyong website.
+
+Ang mga template ay nakatutulong kapag gusto mong gamitin ang parehong impormasyon o layout sa higit sa isang lugar. Hindi mo na kinakailangan na ulitin ang iyong sarili sa bawat file. At kung gusto mong baguhin ang isang bagay, hindi mo na kinakailangan na gawin ito sa bawat template, sa isa lang!
+
+## Gumawa ng isang base template
+
+Ang isang base template ay ang pinaka basic na template na ginagamit mo sa bawat pahina ng iyong website.
+
+Gumawa tayo ng isang `base.html` na file sa `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Pagkatapos, sa `base.html`, palitan ang iyong kabuuang `<body>` (everything between `<body>` and `</body>`) nito:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Maaaring napansin mo na pinalitan nito ang lahat ng mula sa `{% for post in posts %}` sa `{% endfor %}` ng: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Pero bakit? Ikaw ay nakagawa ng isang `block`! Ginamit mo ang template tag na `{% block %}` upang gumawa ng lugar na magkakaroon ng HTML na nakalakip dito. Ang HTML na ito ay manggagaling sa ibang template na ini-extend ang template na ito (`base.html`). Ipapakita namin sa iyo kung paano ito gawin maya-maya.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}Tatanggalin mo ang lahat ng nasa taas ng `{% for post in posts %}` at sa baba `{% endfor %}`. Kapag tapos ka na, ang file ay magiging kagaya nito: {% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Gusto nating gagamitin ito isip parte ng ating template para sa lahat ng mga content block. Oras na para magdagdag ng block na tags sa file na ito!
+
+{% raw %}Gusto mo na ang iyong block tag ay magtugma sa tag ng iyong `base.html` na file. Gusto mo ring itong maglakip ng lahat ng code na pag-aari ng iyong content blocks. Para gawin ito, ilagay lahat sa pagitan ng `{% block content %}` at `{% endblock %}`. Gaya nito:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Isang bagay na lang ang natira. Kailangan nating ikonekta ang dalawang templates. Ito ang ibig sabihin ng pag-extend na mga templates! Gagawin natin ito sa pamamagitan ng pagdagdag ng extend na tag sa simula ng file. Gaya nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> Kung may nakuha kang error na `TemplateDoesNotExist`, ibig sabihin ay walang `blog/base.html` na file at ang `runserver` ay tumatakbo sa iyong console. Subukang ihinto ito (sa pamamagitan ng pag-pindut ng Ctrl+C - ang Control at ang C na mga key ng sabay) at i-start itong muli sa pamamagitan ng pagpapatakbo ng isang `python manage.py runserver` na pag-uutos.
\ No newline at end of file
diff --git a/tl-PH/whats_next/README.md b/tl-PH/whats_next/README.md
new file mode 100644
index 00000000000..4f685ef3a8b
--- /dev/null
+++ b/tl-PH/whats_next/README.md
@@ -0,0 +1,43 @@
+# Ano ang susunod?
+
+Batiin ang sarili!**You're totally awesome**. Ipinagmamalaki ka namin! <3
+
+### Ano ang dapat gawin ngayon?
+
+Take a break and relax! You have just done something really huge.
+
+Pagkatapos niyan, siguraduhin na sundan ang Django Girls sa [Facebook](http://facebook.com/djangogirls) o [Twitter](https://twitter.com/djangogirls) upang manatiling updated.
+
+### Maaari ka bang magrekomenda ng karagdagan na resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/tl/GLOSSARY.md b/tl/GLOSSARY.md
new file mode 100644
index 00000000000..72915dcd29a
--- /dev/null
+++ b/tl/GLOSSARY.md
@@ -0,0 +1,3 @@
+# sulatan ng Wikang Pamprograma
+
+Ang Code editor ay isang aplikasyon na nagbigay sayo na pagkakataon na i-save ang iyong code para mabalikan mo mayamaya. Pwede kang matuto kung saan ka pede makakuha mula [kabanata ng Code editor](./code_editor/README.md)
\ No newline at end of file
diff --git a/tl/README.md b/tl/README.md
new file mode 100644
index 00000000000..5ed328574a2
--- /dev/null
+++ b/tl/README.md
@@ -0,0 +1,51 @@
+# Django Tutorial para sa mga Babae
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Ang proyekto na eto ay lisensyado sa Creative Commons Attribution-ShareAlike 4.0 International License. Para makita mo ang konpya ng lisensya, bumisita sa https://creativecommons.org/licenses/by-sa/4.0/
+
+## Mabuhay
+
+Maligayang pagdating sa Django Tutorial para sa mga Kababaihan! Masaya kami na makita ka dito :) Sa tutorial na ito, dadalhin ka namin sa isang paglalakbay sa kasulok-sulokang bahagi ng mga teknolohiya sa web, naghahandog sa iyo na makita mo ang mga piraso na bumubuo para gumagawa ang web basi sa ating nalalaman.
+
+Sa lahat nang mga hindi nalalaman na mga bagay-bagay, ito ay magiging isang pakikipagsapalaran - pero wag mag-alala, dahil nagkaroon ka na ng lakas ng loob para makasali, kayang-kaya mo lang eto :)
+
+## Introduksiyon
+
+Nakaramdam ka na ba na ang mundo ay punong-puno ng mga teknolohiya na hindi mo (pa) maintindihan? Nagtaka ka na ba kung paano gumawa ng isang website ngunit wala kang sapat na pagganyak na magsimula? Naisipan mo na ba na ang mga sofware sa mundo ay parang napakahirap para gawin mong mag-isa?
+
+Wag mag-alala, may magandang balita kami para sa iyo. Ang Programming ay hindi mahirap gaya ng inaakala mo at gusto naming ipakita sa iyo kung gaano kasaya ito.
+
+Ang tutorial na ito ay hindi basta na lang mag-uwi sa iyo na maging isang programmer. If gusto mong gumaling dito, kailangan mo ng ilang buwan o kahit isang taon na pag-aaral at pagsasanay. Pero gusto naming ipakita sa iyo na ang programming o paglikha ng mga website ay hindi mahirap gaya ng inaakala mo. Susubukan namin na ipaliwanag ang iba't ibang piraso na malinaw hangang sa makakaya namin, para hindi ka matakot sa teknolohiya.
+
+Kami ay umaasa na magustuhan mo rin ang teknolohiya gaya ng pagmamahal namin dito!
+
+## Ano ang matutunan mo sa loob ng tutorial na ito?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+Ito ay magiging katulad (humigit-kumulang) nito:
+
+![Tambilang 0.1](images/application.png)
+
+> Kung susubukan mo ang tutorial na ikaw lang mag-isa at wala kang coach na makakatulong sa iyo kung may problema, mayroon kaming isang chat system para sa iyo:[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Hiniling namin ang aming mga coaches at dating nagdalo na bumisita ng paulit-ulit para makutulong sa iba na nag tutorial! Huwag matakot magtanong doon!
+
+Sige, [magsimula tayo sa simula...](./how_the_internet_works/README.md)
+
+## Sundin ang tutorial sa bahay
+
+Nakakagulat ang pagdalo sa workshop ng Django Girls, ngunit alam namin na hindi talaga posible na palaging makadalo. Ito ang dahilan kung bakit namin kayo hinimuk na sundan ang tutorial sa bahay mo. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. Ito kasalukuyang ginagawa pa, pero mas marami pang mga bagay ang aming i-vocer sa [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) na YouTube channel.
+
+Sa bawat kabanata na nadaanan na, may mga link na nagturo sa tamang video.
+
+## Tungol at Pag-ambag
+
+Ang tutorial na ito ay minamantini ni [DjangoGirls](https://djangogirls.org/). Kung may makita kang mga mali or gusto mong i-update ang tutorial, [pakitingnan ang mga pangpatnubay kung paano mag-ambag](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Sa ngayon, ang mga pagsasalin ay nakalagay sa plataporma ng crowdin.com sa:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/tl/SUMMARY.md b/tl/SUMMARY.md
new file mode 100644
index 00000000000..c1a4076b4bf
--- /dev/null
+++ b/tl/SUMMARY.md
@@ -0,0 +1,27 @@
+# Buod
+
+* [Pambungad](README.md)
+* [Instalasyon](installation/README.md)
+* [Instalasyon (chromebook)](chromebook_setup/README.md)
+* [Paano gumagana ang Internet](how_the_internet_works/README.md)
+* [Introduksyon sa command line](intro_to_command_line/README.md)
+* [Pag-install ng Python](python_installation/README.md)
+* [Sulatan ng Wikang Pamprograma](code_editor/README.md)
+* [Introduksyon sa Python](python_introduction/README.md)
+* [Ano ang Django?](django/README.md)
+* [Pag-install ng Django](django_installation/README.md)
+* [Ang una mong proyekto sa Django!](django_start_project/README.md)
+* [Mga model ng Django](django_models/README.md)
+* [Admin ng Django](django_admin/README.md)
+* [I-deploy!](deploy/README.md)
+* [Mga url ng Django](django_urls/README.md)
+* [Mga view ng Django - oras na para maglikha!](django_views/README.md)
+* [Introduksyon sa HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic na datos sa mga template](dynamic_data_in_templates/README.md)
+* [Django na mga template](django_templates/README.md)
+* [CSS - gawin itong maganda](css/README.md)
+* [Pag-extend ng Template](template_extending/README.md)
+* [I-extend ang iyong application](extend_your_application/README.md)
+* [Mga Form ng Django](django_forms/README.md)
+* [Ano ang sunod?](whats_next/README.md)
\ No newline at end of file
diff --git a/tl/chromebook_setup/README.md b/tl/chromebook_setup/README.md
new file mode 100644
index 00000000000..f88d6fc8d39
--- /dev/null
+++ b/tl/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Setup ng Chromebook
+
+> **Tandaan** Kung nagawa mo na ang mga hakbang sa pag-install, hindi na kailangan gawin ito uli – pwede ka nang dumiretso sa [Introduksyon sa Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/tl/chromebook_setup/instructions.md b/tl/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..4d607283acf
--- /dev/null
+++ b/tl/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+Pwede kang [lumaktaw sa seksiyon na ito](http://tutorial.djangogirls.org/en/installation/#install-python) kung hindi ka gumamit ng Chromebook. Kung ikaw ay, ang iyong karanasan sa pag-install ay medyo kakaiba. Pede mo nang isawalang bahala ang iba mga tagubilin sa pag-install.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. Sa durasyon ng tutorial, ang Cloud 9 ay magsilbi mong *local machine*. Magpapatakbo ka pa rin ng mga direksyon sa interface ng terminal gaya ng mga kamag-aral na gumagamit ng OS X, Ubuntu, or Windows, pero ang terminal mo nakaugnay sa isang kompyuter na pinatakabo sa ibang lugar na hinanda ni Cloud 9 para sa ito.
+
+1. I-install ang Cloud 9 mula sa [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Pumunta sa [c9.io](https://c9.io)
+3. Magsign-up ng account
+4. I-click ang *Maglikha ng Bagong Workspace*
+5. Pangalanan mo ito nang *django-girls*
+6. Piliin ang *Blanko* (pangalawa mula sa kanan, sa ibabang hanay na may dalandan na logo)
+
+Ngayon, makikita mo na dapat ang interface na may sidebar, isang malaking pangunahing window na maroong mga teksto, at isang maliit na window sa baba gaya nito:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    iyongusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual na Environment
+
+Ang virtual na kaligirian (tinatawag din na virtualenv) ay parang isang pribadong kahon kung saan pede mong ilagay ang mga code ng computer na ginawa mo para sa isang proyekto. Ginagamit namin ito para lalagyan ng mga piraso ng aming code na ginamit naming sa iba-ibang proyekto para ihiwalay nang hindi mahalo sa pagitan ng mga proyekto.
+
+Sa iyong terminal sa baba ng interface ng Cloud 9, patakbuhin mo ang sumunod:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If hindi pa rin gumagana, humingi ka ng tulong sa iyong coach.
+
+Sa sunod, patakbuhin ang:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(paalala na sa huling linya, kami ay gumagamit ng tilde na sinundan ng equal na sign: ~=).
+
+### Github
+
+Gumawa ng account sa [Github](https://github.com).
+
+### PythonAnywhere
+
+Kalakip sa Tutorial ng Django Girls ay isang seksyon na tinatawag na Deployment, ito ay isang proseso kung saan gagamiting ang iyong code para paganahin ang iyong bagong web application at paglipat nito sa isang kompyuter na pwedeng ma-access (tinatawag na server) para makita ng ibang tao ang iyong ginagawa.
+
+Ang parte na ito ay medyo kakaiba kung gumamit ka ng Chromebook sa tutorial na ito dahil tayo ay gumagamit na ng kompyuter na nakakonekta sa Internet (kumpara sa tinatawag nating, laptop). Gayun pa man, nakakatulong pa rin ito, pwede nating isipan na ang workspace ng Cloud 9 ay isang lugar o ating "kasalukuyang" gawing at ang Python Anywhere ay lugar kung saan pwede nating ipakita ang ating nagawa.
+
+Kaya naman, magsign-up para sa bagong account sa Python Anywhere sa [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/tl/code_editor/README.md b/tl/code_editor/README.md
new file mode 100644
index 00000000000..0928867c417
--- /dev/null
+++ b/tl/code_editor/README.md
@@ -0,0 +1,11 @@
+# Sulatan ng Wikang Pamprograma
+
+> Para sa mga nagbabasa sa bahay: ang kabanata na ito ay kalapik sa [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) na video.
+
+Ang unang linya ng iyong programa sa Python ay ang simula ng lahat, kaya't napakahalaga na kumuha ka ng magandang pagsusulatan at paghuhulmahan ng iyong mga proyekto!
+
+> **Paalala**Kung ikaw ay gumamagamit ng Chromebook, laktawan omo ang kabanata na ito ay siguraduhing sundin ang mga tagubilin sa [Chromebook Setup](../chromebook_setup/README.md).
+> 
+> **Paalala** Baka nagawa mo na ito kanina sa kabanata ng pag-install - kung gayon, pwede kang dumeretso sa susunod na kabanata!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/tl/code_editor/instructions.md b/tl/code_editor/instructions.md
new file mode 100644
index 00000000000..58fa661b34c
--- /dev/null
+++ b/tl/code_editor/instructions.md
@@ -0,0 +1,31 @@
+Napakarami mong pagpipilian pagdating sa pagsusulatan ng iyong mga proyekto at maaari mo itong ibase kung saan ka mas komportableng magtrabaho. Karamihan sa mga gumagamit ng Python na wikang pamprograma ay pumipili ng mga kumplikado ngunit makapangyarihang IDEs (tinatawag na Integrated Development Environments), katulad ng PyCharm. Ngunit bilang baguhan sa larangang ito, nirerekomenda namin na magsimula ka muna sa payak at magaan na mga pamamaraan at kagamitan.
+
+Ang aming mga mungkahi ay nasa ibaba, pero huwag mag-atubiling magtanong sa iyong coach kung ano ang iyong mga kagustuhan - mas madaling makakuha ng tulong mula sa kanila.
+
+## Gedit
+
+Ang Gedit ay libreng open source na panulat na maaaring gamitin sa lahat ng klase ng operating systems.
+
+[Gamitin ang Atom](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Gamitin ang Atom](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Gamitin ang Atom](https://atom.io/)
+
+## Bakit natin ini-install ang editor ng code?
+
+Baka nagtataka ka kung bakit nag-install tayo ng espesyal na software na editor ng code, imbes na gumamit ng Word o Notepad.
+
+Ang unang rason ay ang code ay kinakailangang **plain na teksto**, at ang problema ng mga programa gaya ng Word at Textedit ay hindi sila naglabas ng plain na teksto, sila ay naglabas ng rich na teksto ( na may mga istilo ng letra at istilo ng pagkalatag), gamit ang mga custom na format gaya ng [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+Ang pangalawang rason ay ang mga editor na code ay natatangi para sa pag-edit ng code, kaya sila ay nagbibigay ng mga nakakatulong na mga katangian gaya ng pag-highlight ng code gamit ang kulay ayon sa kahulugan nito, o awtomatikong magsara ng mga quote para sa iyo.
+
+Makikita natin ang mga ito na gumagana maya-maya, makapag-isip ka na ang lumang editor ng code na ito na isa sa mga paborito mong mga kagamitan. :)
\ No newline at end of file
diff --git a/tl/css/README.md b/tl/css/README.md
new file mode 100644
index 00000000000..ec1e94c23ce
--- /dev/null
+++ b/tl/css/README.md
@@ -0,0 +1,304 @@
+# CSS - gawing nating maganda!
+
+Pangit pa ang ating kasalukuyang blog, hindi ba? Oras na para pagandahin ito! Gagamitin natin ang CSS para riyan.
+
+## Ano ang CSS?
+
+Ang Cascading Style Sheets (CSS) ay isang wika na ginagamit para ilarawan ang itsura at pagkalatag ng mga website ma gumagakip ng markup na wika gaya ng HTML. Isipin itong pampaganda ng ating mga pahina sa web. ;)
+
+Pero hindi natin gusto na magsimula uli sa wala, tama ba? Sa makaisa pa, gagamitin natin ang isang bagay na pinalabas nga mga programmer na libre sa Internet. Ang paggugol ng panahon na mag-isip ng bagong programa ay hindi biro, alam mo yan.
+
+## Gamitin natin ang Bootstrap!
+
+Ang Bootstrap ay isa sa mga pinakasikat na mga balangkas ng HTML ay CSS para makagawa ng magagandang mga website: https://getbootstrap.com/
+
+Ito ay isinulat ng mga programmer na nagtatrabaho sa Twitter. Sa ngayon, ito ay patuloy na ginagawa ng mga boluntaryo galing sa ibat ibang sulok ng mundo!
+
+## Mag-install ng Bootstrap
+
+Para ma-instal ang Bootstrap, kailangan mo itong ilaya sa `<head>` na iyong `.html` na file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+Ito ay hindi nagdadagdag ng mga file sa iyong proyekto. Ito ay nagtuturo lamang sa mga file na nakalagay sa Internet. Sige subukan mo, buksan mo ang iyong website at i-refresh ang pahina. Eto na!
+
+![Tambilang 14.1](images/bootstrap1.png)
+
+Gumaganda na siya!
+
+## Static Files sa Django
+
+Sa wakas ay titingnan natin nang masinsinan ang mga bagay na tinatawag nating **static files**. Ang static na mga gile ay ang iyong mga CSS at mga larawan. Ang laman nila ay hindi nakadepende sa nilalaman ng request at ito ay pareho lang sa bawat user.
+
+### Saan ilagay ang static na mga file para sa Django
+
+Alam na ni Django kung saan hanapin ang static na mga file para sa kalakip na "admin" app. Ngayon, kailangan na lang nating idagdag ang static na mga file para sa sarili nating app, `blog`.
+
+Magagawa natin yan sa pamamagitan ng paglikha ng folder na pinangalanang `static` sa loob ng blog na app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Si Django ay kusang maghanap ng mga folder na tinawag na "static" sa loob ng iyong mga app na mga folders. Pagkatapos ay pede na niyang gamitin ang mga laman nito isip mga static na mga file.
+
+## Ang iyong unang CSS file!
+
+Gagawa tayo ng CSS na file, para pagandahin ang iyong web page. Gumawa ng bagong directory na `css` sa loob ng iyong `static` directory. Pagkatapos, gumawa ka ng bagong file na `blog.css` sa loob nitong `css` directory mo. Handa ka na ba?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Oras na para magsulat ng CSS! Buksan ang `blog/static/css/blog.css` na file sa loob ng iyong editor ng code.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+Pero gumawa naman tayo kahit kaunti lang. Siguro maaari nating baguhin ang kulay ng header? Para maunawaan ang mga kulay, ang kompyuter ay sumusunod sa mga special codes o mga numero at letra na nagsisimbolo ng kulay. Ang mga code na ito ay nagsimula sa `#` at sinundan ng 6 na letra (A-F) at mga numero (0-9). Halimbawa, ang code para sa asul ay `#0000FF`. Maari mong makita ang mga color code sa iba't ibang kulay dito: http://www.colorpicker.com/. Maari ka ding gumamit ng mga [nakatakdang mga kulay](http://www.w3schools.com/colors/colors_names.asp), tulad ng `red (o pula)` at `green (o berde)`.
+
+Sa iyong `blog/static/css/blog.css` na file, kailangan mong idagdag ang sumusunod na code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` ay isang Selector ng CSS. Ibig sabihin nito na kinakapit natin ang ating mga estilo sa kahit ano na `a` na elemento na nasa loob ng `h1` na elemento. Kung mayroon kang `<h1><a href="">link</a></h1>` na gaya nito, ang estilo na `h1 a` ay magagamit. Sa kaso na ito, sinabihan natin ito na palitan ang kulay nito nang `#FCA205`, ang orange (o dalandan). Siyempre, pede ilagay ang sarili mong kulay dito!
+
+Sa loob ng CSS file nakabase ang estilo ng mga elemento sa loob ng HTML na file. Ang unang pamamaraan na makilala natin ang mga elemento ay gamit ang pangalan ng elemento. Maari mong naalala ang mga tag na ito mula sa pangkat ng HTML. Mga bagay gaya ng `a`, `h1`, at `body` ay puro mga halimbawa ng mga pangalan ng elemento. Maaari din nating kilalanin ang mga elemento sa pamamagitan ng katangian na `class` o sa katangian na `id`. Ang class at id ay mga pangalan na sarili mong ibinigay sa mga elemento. Ang mga class ay nagbibigay kahulugan sa mga grupo ng mga elemento, at ang id ay nagtuturo sa mga tiyak na mga elemento. Halimbawa, maari mong kilalanin ang sumusunod na tag sa pamamagitan ng paggamit ng pangalan ng tag na `a`, sa `external_link` na class, o sa `link_to_wiki_page` na id:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+Maari ka pang magbasa ng higit pa tungkol sa mga [Selector ng CSS sa w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+Kailangan din nating sabihan ang ating template ng HTML na may dinagdag tayo na mga CSS. Buksan ang `blog/templates/blog/post_list.html` na file at idagdag ang linya na ito sa pinakasimula nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+Nagloload lang kami ng mga static na file dito. :) Sa gitna ng `<head>` at `</head>` na mga tag, kasunod ng mga link sa mga CSS file ng Bootstrap, idagdag mo ang linya na ito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Ang browser ang nagbabasa sa mga file sa hanay na ibinigay, kaya kinakailangan nating isiguro na nasa tamang lugar ito. Kung hindi, ang mga code sa ating file ay mapangingibawan ng code ng mga file ng Bootstrap. Kakasabi lang natin sa ating template kung saan nakalagay ang ating CSS na file.
+
+Ang file mo ay dapat maging katulad nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>blog ng Django Girls</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Blog ng Django Girls</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>inilathala: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Sige, i-save ang file at i-refresh ang site!
+
+![Tambilang 14.2](images/color2.png)
+
+Magaling! Siguro dapat din nating bigyan ang ating website ng kaunnting simoy ng hangin at dagdagan ang baybay sa kaliwang bahagi? Subukan natin ito!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Idagdag mo ito sa iyong CSS, i-save ang file at tingnan kung paano ito gumagana!
+
+![Tambilang 14.3](images/margin2.png)
+
+Maari nating i-customize ang istilo ng mga letra sa ating header? Idikit ito sa iyong `<head>` sa `blog/templates/blog/post_list.html` na file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Tulad ng dati, pakitingnan ang pagkasunod-sunod at ilagay bago ang link sa `blog/static/css/blog.css`. Ang linyang ito ay mag-import ng istilo ng letra na tinatawag na *Lobster* mula sa mga Font ng Google (https://www.google.com/fonts).
+
+Hanapin ang `h1 a` na deklerasyon na bloke (ang code sa pagitan ng braces `{` at `}`) sa loob ng CSS na file na `blog/static/css/blog.css`. Ngayon, idagdag ang linya na `font-family: 'Lobster';` sa pagitan ng mga kawing, at i-refresh ang pahina:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Tambilang 14.3](images/font.png)
+
+Mainam!
+
+Gaya ng binanggit sa taas, ang CSS ay mayroon konsepto ng mga class. Ang mga ito ay gamit para mapangalanan mo ang parte ng iyong HTML na code at i-apply ang istilo sa parte na ito lamang, na hindi makaapekto sa ibang bahagi. Ito ay sobrang makakatulong! Maari na mayroon kang dalawang div na kakaiba ang gamit (gaya ng iyong header at ang iyong post). Ang class ay makakatulong para gawing magkaiba ang kanilang anyo.
+
+Sige at pangalanan mo ang ibang parte ng iyong HTML code. Magdagdag ng klase na tinatawag na `page-header` sa iyong `div` na naglalaman ng iyong header, gaya nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Blog ng Django Girls</a></h1>
+</div>
+```
+
+At ngayon, magdagdag ng class na `post` sa iyong `div` na naglalaman ng iyong blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>nailathala: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+Ngayon, aming idadagdag ang deklerasyon na mga bloke sa iba ibang mga selector. Ang mga selector na nagsimula sa `.` ay may kaugnayan sa mga classes. Mayroong maraming magagandang tutorial doon at mga pagpapaliwanag tungkol sa CSS sa Web na makakatulong sa iyo sa pag-intindi sa mga sumusunod na code. Sa ngayon, kopyahin at idikit ito sa inyong `blog/static/css/blog.css` na file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Pagkatapos, palibutan ang HTML code na nagdidisplay ng mga post nang mga deklerasyon ng mga class. Palitan mo ito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>nailathala: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+sa loob ng `blog/templates/blog/post_list.html` nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>nailathala: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+I-save ang mga file na iyon at i-refresh ang iyong website.
+
+![Tambilang 14.4](images/final.png)
+
+Woohoo! Kagilas-gilas di ba? Tingnan mo ang iyong code na kakadikit lang natin para mahanap mo ang lugar na dinagdagan natin ng mga class sa loob ng HTML at ginamit sa CSS. Saan mo gawin ang mga pagbabago kung gusto mong palitan ang kulay ng petsa ng turquoise (o turkesa)?
+
+Huwag matakot paglaruan ng konti ang CSS at subukang baguhin ang mga istilo. Ang paglalarong CSS ay makakatulong sa iyo para maintindihan mo kung ano ang ginagawa ng iba't ibang bagay. Kung may nasira ka, huwag mag-alala - pwedeng-pwede mong ibalik ito sa dati!
+
+Minumungkahi talaga namin na kunin mo ang libre na online course na < 0>Codeacademy HTML & CSS</a>. Ito ay makakatulong sa iyo upang matutunan mo ang lahat tungkol sa pagpapaganda ng iyong website gamit ang CSS.
+
+Handa ka naba sa sunod na kabanata?! :)
\ No newline at end of file
diff --git a/tl/deploy/README.md b/tl/deploy/README.md
new file mode 100644
index 00000000000..ca879042f62
--- /dev/null
+++ b/tl/deploy/README.md
@@ -0,0 +1,261 @@
+# I-deploy!
+
+> **Paalala** Ang sumunod na kabanata ay maaring masyadong mahirap maintindihan paminsan-minsan. Magtiyaga at tapusin ito; ang pag-deploy ay isang pinaka-importanteng bahagi sa proseso ng paggawa ng mga website. Ang kabanatang ito ay nilagay sa gitnang bahagi ng tutorial para ang iyong tagapayo ay makatulong sa mga medyo mahirap na proseso sa pag-gawang online ng iyong website. Ibig sabihin nito, pwede mo pa ring tapusin ang tutorial na ikaw lang kahit maubusan ka pa ng oras.
+
+Hanggang ngayon, ang iyong website ay magagamit lang sa iyong kompyuter. Sa ngayon, matutunan mo kung paano ito i-deploy! Ang pag-deploy ay isang proseso ng paglathala ng iyong application sa Internet para sa wakas ay mapuntahan at makita ng mga tao ang iyong app. :)
+
+Base sa natutunan mo, ang website ay kinakailangang nakalagay sa isang server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+Ang isa pang external service na gagamitin ay ang [GitHub](https://www.github.com), na isang service ng naghohost ng mga code. Mayroon pang pang ibang mga providers, pero karamihan sa mga programmer ngayon ay mayroon nang account sa Github, at ngayon ikaw din!
+
+Ang tatlong lugar na ito ay importante para sa iyo. Ang iyong lokal na komputer kung saan gagawin mo ang pag-dedevelop at pag-test. Kung masaya kana sa mga pagbabago, ikaw ay maglalagay ng kopya ng iyong program sa Github. Ang iyong website ay nandoon sa PythonAnywhere at atin itong i-update sa pamamagitan ng pagkuha ng bagong kopya ng iyong code mula sa Github.
+
+# Git
+
+> **Paalala** Maaring nagawa mo ang mga hakbang sa pag-install, hindi mo na kailangang gawin ito ulit - pwede kang dumeretso sa sunod na seksiyon at magsimulang maglikha ng iyong repository sa Git.
+
+{% include "/deploy/install_git.md" %}
+
+## Pinapaandar ang ating repository sa Git
+
+Ang Git ay nagsubaybay sa mga pagbabago sa isang partikular na grupo ng file sa loob ng tinatawag na repository ng code (o "repo" sa maikli). Umpisahan natin ang isa para sa iyong proyekto. Buksan ang iyong consile at patakuhin ang mga command na ito, sa loob ng directory ng `djangogirls`:
+
+> **Paalala** TIyakin ang iyong kasalukuyang working directory gamit ang `pwd` (Mac OS X/Linux) o `cd` (Windows) na command bago i-initialize ang repository. Dapat na nasa loob ka ng `djangogirls` na folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Ang pag-initialize ng git repository ay kailangang gawin nang isang beses lang sa bawat proyekto (at hindi na kinakailangang maglagay pa ng bansag at email kailanman).
+
+Ang git ay magsubaybay sa mga pagbabago sa lahat ng mga file at mga folder sa loob ng directory, pero maaring may mga files na gusto nating isawalang-bahala. Gagawin natin ito sa pamamagitan ng paglikha ng file na tinatawag na `.gitignore` sa loob ng base na directory. Buksan ang iyong editor at maglikha ng bagong file na may sumusunod na nilalaman:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+At i-save ito isip `.gitignore` sa loob ng "djangogirls" na folder.
+
+> **Paalala** Ang tuldok sa harap ng pangalan ng file ay importante! Kung ikaw ay nahihirapan sa paglikha nito (ang Mac ay hindi gusto na maglikha ka ng mga file na nagisisumula sa isang tulod sa pamamagitan ng Finder, halimbawa), kung gayon ay gamitin ang "Save As" na katangian ng iyong editor; ito ay himpit.
+> 
+> **Paalala** Isa sa mga file na nilakip mo sa iyong `.gitignore` file ay si `db.sqlite3`. Ang file na yan ay ang iyong local na database, kung saan lahat ng mga post mo ay nakalagay. Hindi natin gustong isali ito sa iyong repository dahil ang website mo sa PythonAnywhere ay gagamit ng ibang database. Ang database na yan ay maaring SQLite, gaya ng iyong pang-develop na machine, pero kadalasan gagamit ka ng MySQL, mas marami itong bisita na makakaya kaysa sa SQLite. Alinman dito, ang pagsawalang-bahala sa iyong SQLite na data para sa iyong kopya sa github, ay pamamaraan para ang lahat ng post na iyong nalikha ay mananatili at magagamit lamang sa iyong lokalidad, pero kailangan mo pa ring isali ito uli sa production. Isipin mo ang iyong local na database na isang magandang palaruan kung saan pede mung masubukan ang ibat-ibang bagay na walang takot na mabura mo ang mga tunay na post galing sa iyong blog.
+
+Mainam na gamitin mo muna ang `git status` na commmand bago ka mag `git add` o kapag hindi ka sigurado kung ano ang nagbago. Nakakatulong ito para hindi ka mabigla sa mga pangyayari, gaya ng mga maling file na nasali at na-commit. Ang `git status` na command ay naghahatid ng mga impormasyon sa lahat ng mga file na hindi naka track/binago/at na-stage, ang estado ng branch, at marami pang iba. Ang output ay dapat kagaya ng sumusunod:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+At sa wakas, ating i-save ang ating mga binago. Pumunta iyong console at patakbuhin ang mga command na ito:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Pumunta sa [GitHub.com](https://www.github.com) at magsign-up ng bago, at libreng user account. (Kung nagawa mo na ito sa paghahanda sa workshop, magaling!)
+    
+    Pagkatapos, maglikha ng bagong repository, at pangalanan mo ito nang "my-first-blog". Hayaan ang "initialize with a README" na checkbox na hindi naka tsek, hayaan ang opsyon na .gitignore na walang laman (nagawa natin ito nang manu-mano) at hayaan ang Lisensya na naka-set sa None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Paalala** Importante ang pangalan na `my-first-blog` – pwede kang pumili ng iba, pero ito ay maraming beses na makikita mo sa mga instruksiyon sa baba, at kailangan mo itong palitan sa bawat beses. Mas madali kung ang gamitin mo nalang na pangalan ay ang `my-first-blog`.
+    
+    Sa kasunod na screen, ipapakita sa clone URL ng iyong repo. Piliin ang "HTTPS" na bersyon, kopyahin ito, at agad natin itong idikit sa terminal:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Ngayon kailang nating ikabit ang repository ng Git sa iyong kompyuter doon sa kopya ng Github.
+    
+    I-type ang sumusunod sa iyong console (Palitan ang `<your-github-username>` ng basag na nilagay mo sa paglikha mo ng iyong Github na account, pero walang mga angle-bracket):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Ilagay ang iyong GitHub na username at password at makikita mo ang gaya nito:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Ang iyong code ay nasa GitHub na. Puntahan at suriin ito!  Makikita mo na ito ay nasa magandang grupo – [Django](https://github.com/django/django), ang [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), at marami pang ibang magagandang mga open-source proyekto na mga software na nakahost din ang code sa Github. :)
+    
+    
+    # Sini-setup ang iyong blog sa PythonAnywhere
+    
+    &gt; **Paalala** Maaring nakalikha ka na ng account sa PythonAnywhere sa pag-install na baitang - kung gayon, hindi mo na kalilangan itong ulitin.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    Kung nakasign-up ka sa PythonAnywhere, dadalhin ka sa iyong dashboard o "Consoles" na pahina. Piliin ang opsyon para patakbuhin ang console na "Bash" - yan ang bersyon ng PythonAnywhere na console, gaya ng sa iyong kompyuter.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Paalala** Ang PythonAnywhere ay nakabatay sa Linux, kung ikaw ay nasa Windows, ang console ay medyo kakaiba sa console ng kompyuter mo.
+    
+    Ating hahatakin ang ating code galing sa Github papunta sa PythonAnywhere sa pamamagitan ng paglikha ng "clone" ng ating repo. I-type mo ang sumusunod sa iyong console sa PythonAnywhere (wag kalimot na gamiting ang iyong GitHub na bansag kapalit ng `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />Ito ay maghahatag ng kopya ng iyong code papunta sa PythonAnywhere. Suriin ito sa pamamagitan ng pag-type ng `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Tulad ng ginawa mo sa iyong sariling kompyuter, pwede kang maglikha ng virtualenv sa PythonAnywhere. Sa loob ng console ng Bash, i-type ang:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Paalala** Ang hakbang na `pip install` ay maaring tatagal ng ilang minuto.  Tiis, tiis!  Kung ito ay tatagal ng lampas na limang minuto, may problema.  Tanungin ang iyong coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Paglikha ng database sa PythonAnywhere
+    
+    Ito pa ang ibang bagay na kakaiba sa iyong kompyuter at server: ito ay gumagamit ng ibang database. Kaya ang mga user account at mga post ay maaring kakaiba sa iyong server at sa iyong kompyuter.
+    
+    Tulad ng ginawa natin sa iyong sariling kompyuter, uulitin natin ang hakbang sa pag-initialize ng database sa iyong server, gamit ang `migrate` at `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Mga operasyon na kailangang gawin: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Paglathala ng ating blog isip isang web app
+    
+    Ngayon ang ating code ay nasa PythonAnywhere na, ang ating virtualenv ay handa na, at na initialize na ang database. Handa na kaming ilathala ito isip isang web app!
+    
+    I-click pabalik sa PythonAnywhere na dashboard sa pamamagitan ng pag-click sa logo nito, and then i-click ang **Web** na tab. Sa wakas, pindutin ang **Add a new web app**.
+    
+    Pagkatapos ikompirma ang pangalan ng iyong domain, piliin ang **manual configuration** (N.B. - *not* the "Django" option) sa loob ng dialog. Kasunod, piliin ang **Python 3.6**, at i-click ang Next para tapusin ang wizard.
+    
+    &gt; **Paalala** Siguraduhing napili mo ang opsyon na "Manual configuration", hindi yung "Django". Masyado tayong cool para sa default na Django setup ng PythonAnywhere. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    Dadalhin ka sa config screen ng PythonAnywhere sa iyong webapp, kung saan ka kailangang pumunta sa tuwing gusto mong gumawa na pagbabago sa iyong app na nasa server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    Sa loob ng "Virtualenv" na bahagi, i-click ang pulang teksto na nagsasabing "Enter the path to a virtualenv", at pumasok sa `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. I-click ang asul na kahon na may checkmark para i-save ang path bago magpatuloy.
+    
+    &gt; **Paalala** Palitan ang iyong bansa sa PythonAnywhere kung kinakailangan. Kung may mga mali, magpapakita ang PythonAnywhere ng mga konting babala.
+    
+    
+    ### Configuring the WSGI file
+    
+    Ang Django ay gumagana gamit ang "WSGI protocol", isang pamantayan sa pagpapatakbo ng mga website gamit ang Python, na sinusuportahan ni PythonAnywhere. Ang pamamaraan na ma-configure ang PythonAnywhere para makilala nya ang ating blog sa Django ay sa pamamagitan ng pag-edit ng WSGI na configuration file.
+    
+    I-click ang link ng "WSGI configuration file" (sa loob ng "Code" na seksiyon malapit sa taas ng pahina - tatawagin itong `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), at dadalhin ka sa isang editor.
+    
+    Burahin ang lahat ng lamat at palitan ito nang sumusunod: 
+    
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+Ang trabaho ng file na ito ay para sabihan si PythonAnywhere kung saan ang ating web app nakatira at kung ano ang pangalan ng file para sa setting ng Django.
+
+Ang `StaticFilesHandler` ay para sa pagbabahagi ng ating CSS. Ito ay awtomatikong nagawa para sayo habang nagdedevelop sa lokal sa pamamagitan ng pagpatakbo ng `runserver` na command. Malalaman natin ito nang masinsinan ang tungkol sa static na mga file sa huling parte ng tutorial, kung saan i-edit natin ang CSS para sa ating site.
+
+Banatan ang **Save** na button at bumalik sa **Web** na tab.
+
+Tapos na tayo! Banatan ang malaking berdeng **Reload** na button at maari mo nang matingnan ang iyong application. Makikita mo ang link sa taas ng pahina.
+
+## Mga tip para sa pag-debug
+
+Kung may nakita kang mga problema habang binista mo ang iyong website, ang una mong dapat tingnan ay ang mga debugging na impormasyon sa loob ng iyong **error log**. Makakakita ka ng link papunta dito sa [Web tab](https://www.pythonanywhere.com/web_app_setup/) ng PythonAnywhere. Tingnan kung may mga error na mga mensahe sa loob; ang pinakabago ay nasa ilalim. Ang mga karaniwang problema ay lakip nito:
+
+- Kung malimutan ang isa sa mga hakbang na ginawa natin sa console: paglikha ng virtualenv, pag-activate nito, pag-install ng Django sa loob nito, at paglipat ng database.
+
+- Kung may nagawang mali sa path ng virtualenv sa loob ng Web tab - kadalasan ay mayroon itong mga maliliit na pulang error message sa loob, kung may problema.
+
+- May mga mali sa loob ng WSGI na configuration file - nakuha mo bang maayos ang daan papunta sa iyong my-first-blog na folder?
+
+- Pinili mo ba ang parehang bersyon ng Python sa iyong virtualenv gaya ng ginawa mo sa web app? Ang dalawa ay dapat 3.6.
+
+Mayroon ding mga [karaniwang debugging na mga tip sa wiki ng PythonAnywhere](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+At wag kalimutan, nandito ang iyong coach para tumulong!
+
+# Buhay ka pa!
+
+Ang default na pahina ng iyong website ay dapat nagsasabing "It worked!", gaya ng ginawa nito sa iyong lokal na kompyuter. Subukan mong magdagdag ng `/admin/` sa bandang huli ng URL, at dadalhin ka nito sa site ng admin. Maglog-in gamit ang iyong bansag at password, at makikita mo na maari kang magdagdag ng mga bagong Post sa server.
+
+Kapay may nalikha ka nang mga posts, maari kang bumalik sa iyong lokal na setup (hindi sa PythonAnywhere). Mula dito, dapat kang magtrabaho sa iyong lokal na setup para sa mga pagbabago. Ito ay karaniwang pamamaraan sa web development - gumawa ng update sa lokal, i-push ang mga binago sa Github, at hatakin ang mga ito sa iyong live na Web server. Ito ay nagbibigay sa iyo ng pagkakataon na magtrabaho at mag-eksperimento na hindi nasisira ang iyong live na Web site. Galing, di ba?
+
+Bigyan mo ang sarili mo ng isang *NAPAKALAKING* tapik sa likod mo! Ang pag deploy sa server ay isa sa mga mahihirap ng parte ng web development at ito ay kadalasang aabot ng ilang araw bago nila mapatakbo ito. Pero ikaw ay nakapatakbo ng sa iyong site nang live, sa tunay na Internet nang ganon na lang!
\ No newline at end of file
diff --git a/tl/deploy/install_git.md b/tl/deploy/install_git.md
new file mode 100644
index 00000000000..5a0185848f8
--- /dev/null
+++ b/tl/deploy/install_git.md
@@ -0,0 +1,52 @@
+Ang Git ay isang "version control system" na ginagamit ng napakaraming mga programmer. Ang software na ito ay maaring magsubaybay sa mga pagbabago sa mga files sa paglipas ng panahon para matandaan mo ang mga bersyon mamaya. Parang katulad ng "track changes" na katangian ng Microsoft Word, pero mas malakas pa.
+
+## Pag-install ng Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Maari kang mag-download ng Git mula sa [git-scm.com](https://git-scm.com/). Maari mong pindoting ang "next" sa lahat ng mga hakbang maliban sa isa: sa panglimang hakbang na may pamagat na "Adjusting your PATH environment", piliin ang "Use Git and optional Unix tools from the Windows Command Prompt" (ang opsyon sa baba). Maliban dyan, ang mga default na setting ay mainam na. Tingnan ang Windows-style, maganda ang pag-commit ng Unix-style na line endings.
+
+Huwag kalimutan na i-restart ang command prompt o powershell pagkatapos nang matagumpay na pag-install. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Mag-download ng Git mula sa [git-scm.com](https://git-scm.com/) at sundan mo lang ang mga instruksiyon.
+
+> **Paalala**Kung ang gamit mo ay OS X 10.6, 10.7 o 10.8, kailangan mong i-install ang bersyon ng git galing dito: [Git Installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/tl/deploy/signup_pythonanywhere.md b/tl/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/tl/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/tl/django/README.md b/tl/django/README.md
new file mode 100644
index 00000000000..5b858c3a36c
--- /dev/null
+++ b/tl/django/README.md
@@ -0,0 +1,27 @@
+# Ano ang Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) ay isang libre at open source na framework ng web application, na sinulat sa Python. Isang web framework na bumubuo ng mga bahagi na makakatulong sa iyo na maggawa ng mga website nang mabilis at madali.
+
+Kung gumagawa ka ng isang website, kinakailangan mo lagi ng parehang grupo nga mga sangkap: pamamaraan para mag-authenticate ng user (pagsign-up, pagsign-in, pagsign-out), isang panel para sa pangangasiwa ng iyong website, at mga form, at pamamaraan para sa pag-upload ng mga files, at iba pa.
+
+Maswerte ka, maraming tao ang nakapansin na ang mga develepor ay kadalasang makadanas ng pare-parehang problema sa paggawa ng bagong site, kaya sila ay nagsamasama para gawin ang mga framework (isa na dito ang Django) na nagbigay sa iyo ng mga handang magagamit na mga sangkap.
+
+Ang mga framework ay nilikha para maiwasan mong gawin ulit ang mga bagay-bagay at makakatulong para mabawasan ang gastusin sa paggawa ng bagong site.
+
+## Bakit mo kinakailangan ng framework?
+
+Para maintindihan mo kung para saan talaga ang Django, kailangan nating tingnan nang maigi ang ating mga server. Una, dapat malaman ng server na gusto mo itong magpakita ng mga web page.
+
+Isipin mo ang isang buson (port) na nagsubaybay sa mga padating na mga sulat (requests). Ito ay ginagawa ng web server. Ang web server ay nagbabasa ng mga sulat at nagpadala ng sagot sa pamamagitan ng webpage. Pero sa oras na gustong mong magpadala, kinakailangan na meron kang nilalaman. Ang Django ay makakatulong sa paglikha ng iyong mga nilalaman.
+
+## Ano ang mangyari kung may maghingi ng website galing sa iyong server?
+
+Kapag dumating ang hiling sa web server, ipapasa ito sa Django na nagbibigay pagpapakahulugan sa hiling na natanggap. Kukuha ito muna ng address ng web page at subukang intindihin kung ano ang dapat gawin. Ang parte na ito ay ginagawa ng **urlresolver** ni Django (paalala na ang address ng website ay tinatawag na URL - Uniform Resource Locator - kaya ang pangalan na *urlresolver* ay may kabuluhan). Hindi ito masyadong matalino - kukuha lang ito ng lista ng mga parisan at susubukang ipares ang katugmang URL. Si Django ay magsusuri ng mga parisan mula sa taas hanggang sa baba at kung may makita itong pares, ipapasa ni Django ang request sa isang kasamahan na function (na tinatawag na *view*).
+
+Isipan ang isang tagapagpadala ng mga sulat na may dalang liham. Naglalakad siya sa mga kalsada at isa-isa niyang tiningnan ang bawat bahay kung may tugma sa address na nakasulat sa liham. Kung may tugma, ilalagay niya ang liham doon. Ganito nagtatrabaho ang isang urlresolver!
+
+Sa *view* na function, lahat ng mga kaayayang mga bagay ay nagawa, pede mong tingnan ang database para magkuha ng mga impormasyon. Maaring hiniling ng user na baguhin ang data? Gaya ng isang liham na nagsasabing, "Pakipalitan ang paglalarawan ng aking trabaho." Maaring tingnan ng *view* kung ikaw ay may pahintulot na gawin ito, saka i-update niya ang paglalarawan ng trabaho para sa iyo at magpapadala ng mensahe na: "Tapos na!". Pagkatapos ang *view* ay gagawa ng sagot at ipapadala ito ni Django sa web browser ng user.
+
+Syempre, ang paglalarawan sa itaas ay ginawang simple, pero hindi mo pa kailangang malaman ang lahat ng mga teknikal na bagay. Ang pagkaroon ng pangkaraniwang ideya ay sapat na.
+
+Kaysa humatak ka sa napakaraming mga detalye, gagawa lang tayo ng mga bagay sa Django at ating pag-aralan ang mga importanteng parte na ating madaanan!
\ No newline at end of file
diff --git a/tl/django_admin/README.md b/tl/django_admin/README.md
new file mode 100644
index 00000000000..a0d28855251
--- /dev/null
+++ b/tl/django_admin/README.md
@@ -0,0 +1,57 @@
+# Admin ng Django
+
+Para makadagdag, maka-edit, at makabura ng mga post na kakamodel lang, gagamitin natin ang admin ng Django.
+
+Ating buksan ang `blog/admin.py` na file at palitan ang laman nito:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Sa makikita mo, ating ini-import (isinama) ang model na Post na ating binigyan kahulugan sa dating kabanata. Para makita sa pahina ng admin ang ating model, kailangan natin itong i-rehistro gamit ang `admin.site.register(Post)`.
+
+Sige, oras na para tingnan ang ating model na Post. Huwag kalimutan na patakbuhin ang `python manage.py runserver` sa iyong console para gumana ang web server. Pumunta sa iyong browser at ilagay ang address na ito http://127.0.0.1:8000/admin/. Makikita mo ang pahina sa pag-login gaya nito:
+
+![Pahina para sa Login](images/login_page2.png)
+
+Para maglog-in, kailangan mong maglikha ng *superuser* - isang user account na may kontrol sa lahat ng laman ng site. Bumalik sa command line, at i-type ang `python manage.py createsuperuser`, at pindutin ang enter.
+
+> Tandaan, para maka sulat ng bagong mga command habang tumatakbo ang iyong web server, magbukas ng bagong terminal window at gawing aktibo ang iyong virtualenv. Kami ay nagbalik-aral kung paano magsulat ng mga bagong command kabanata na **Your first Django project!**, sa loob ng seksyon na **Starting the web server**.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/tl/django_forms/README.md b/tl/django_forms/README.md
new file mode 100644
index 00000000000..ba1a50fcd27
--- /dev/null
+++ b/tl/django_forms/README.md
@@ -0,0 +1,443 @@
+# Mga Form ng Django
+
+Ang pinakahuling bagay na gusto nating gawin sa ating website ay ang paglikha ng magandang para para magdagdag at mag-edit ng mga post sa blog. Ang `admin ng Django` ay maganda, ngunit mahirap itong i-customize at pagandahin. Gamit ang mga `forms` magkakaroon tayo ng kapangyarihan sa ating interface - maari nating magawa ang kung ano man ang maisip natin!
+
+Ang maganda tungkol sa mga form ng Django ay maari tayong maglikha mula sa wala o maglikha ng `ModelForm` na magsi-save sa mga resulta ng form sa iyong model.
+
+Ito talaga ang gusto nating gawin: ang paglikha ng form para sa ating model na `Post`.
+
+Gaya ng bawat importanteng parte ng Django, ang mga form ay mayroong sariling file: `forms.py`.
+
+Kailangan nating maglikha ng file sa loob ng `blog` na directory na may ganitong pangalan.
+
+    blog
+       └── forms.py
+    
+
+Sige, buksan ito at i-type ang sumusunod na code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Kalingan natin unang i-import ang mga form ng Django (`galing sa django import forms`) at, syempre, ang model ng ating `Post` (`mula sa .models import Post`).
+
+Ang `PostForm`, gaya ng suspetsa mo, ay ang pangalan ng ating form. Kailangan nating sabihan si Django na ang form na ito ay isang `ModelForm` (kaya gagawin ni Django ang mahika para sa atin) - `forms.ModelForm` ay responsable para dito.
+
+Sa sunod, meron tayong `class Meta`, kung saan sasabihan natin si Django kung alling model ang dapat gagamitin sa paglikha ng form na ito (`model = Post`).
+
+Sa wakas, pipiliin natin kung aling mga field ang dapat nasa form natin. Sa senaryo na ito, gusto lang natin na ipakita ang `pamagat` at `teksto` - `ang may-akda` ay dapat ang taong naka login (ikaw!) at ang `created_date` ay dapat awtomatikong na-set habang naglilikha tayo ng post (iyan ay sa loob ng code), di ba?
+
+At yan na! Ang kailangan nalang natin gawin ngayon ay ang paggamit ng form sa loob ng *view* at i-display ito sa loob ng template.
+
+Sa makaisa pa, gagawa tayo ng link papunta sa page, sa URL, sa view at sa template.
+
+## I-link sa isang page na may mga form
+
+Oras na para buksan ang `blog/template/blog/base.html`. Magdadagdag tayo ng link sa loob ng `div` na pinangalanang `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Paalala na gusto nating tawagin ang ating bagong view na `post_new`. Ang class na `"glyphicon glyphicon-plus"` ay handa na sa pamamagitang ng bootstrap theme na ginagamit natin, at magdidisplay ito ng plus sign para sa atin.
+
+Pagkatapos maidagdag ang linya, ang iyong HTML file ay maging kagaya nito:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>blog ng Django Girls</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Blog ng Django Girls</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Pagkatapos i-save at i-refresh ang page na http://127.0.0.1:8000, siyempre makakita ka ng pamilyar na error na`NoReverseMatch`, di ba?
+
+## URL
+
+Bubuksan nating ang `blog/urls.py` at idagdag ang linya:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+At ang katapusang code ay maging ganito:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+Pagkatapos mag-refresh sa site, makikita natin ang `AttributeError`, ito ay dahil wala pa tayong `post_new` na view na nagawa. Ating idagdag ito ngayon.
+
+## post_new view
+
+Oras na para buksan ang file na `blog/views.py` at idagdag ang sumusunod na mga linya sa ibang `from` na mga hanay:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+At ang atin ding *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Para makalikha ng bagong form na `Post`, kailagan nating tawagin ang `PostForm()` at ipasa ito sa mga template. Babalikan natin ang *view* na ito, pero sa ngayon, gagawa tayo ng madaliang template para sa ating form.
+
+## Template
+
+Kailangan nating maglikha ng file na `post_edit.html` sa loob ng `blog/templates/blog` na directory. Para gagana ang form, may mga bagay pa tayong dapat gawin:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* Ang linya sa itaas ay kailangang nakabalot sa HTML form na tag: `<form method="POST">...</form>`.
+* Kailangan natin ng `Save` na button. Magagawa natin ito gamit ang HTML button: `<button type="submit">Save</button>`.
+* At sa wakas, pagkatapos na opening na `<form ...>` tag, kailangan nating idagdag ang {% raw %}`{% csrf_token %}`{% endraw %}. Ito ay napakahalaga, dahil ginawa nitong matatag ang iyong mga form! Kung nakalimutan mo ang parte na ito, magsusumbong si Django kung susubukan mong i-save ang form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+Sige, tingnan natin kung ano dapat ang hitsura ng HTML sa `post_edit.html`:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>Bagong Post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Mag-save</button>
+    </form>
+{% endblock %}
+```
+
+Oras na para mag-refresh! Yay! Nakadisplay na ang ating form!
+
+![Bagong form](images/new_form2.png)
+
+Pero, teka muna! Kung mag-type ka sa `pamagat` at `teksto` na mga field at subukang i-save, ano ang mangyari?
+
+Wala! Tayo ay babalik sa parehong pahina at nawala ang ating tekso... at walang bagong post ang nadagdag. Kaya saan nagkaproblema?
+
+Ang sagot ay: wala. May kailangan lang tayong gawin sa ating *view*.
+
+## Nagsisave ng form
+
+Buksan ulit ang `blog/views.py`. Sa ngayon, ang laman lang ng `post_new` na vieiw ay ang sumusunod:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Kung nagpasa tayo ng form, dadalhin tayo pabalik sa parehong view, pero ngayon may mga karagdagang mga datos na sa ating `request`, para mas maging partikular sa loob ng `request.POST` (ang pagkakapangalan ay walang kinalaman sa blog "post"; ito ay dahil tayo ay nagpopost ng data). Tandaan kung paano sa loob ng HTML file, ang ating `<form>`pagbigay kahulugan ay mayroong variable na `method="POST"`? Lahat ng mga field galing sa form ay nasa `request.POST` na. Hindi mo dapat baguhin ang pangalan ng `POST` sa kahit ano (ang isa pang balidong value para sa `method` ay si `GET`, pero wala na tayong oras para ipaliwanag ang kaibahan).
+
+Kaya sa ating *view* mayroon tayong hiwalay ng mga sitwasyon na dapat kailangang gawin: una, kung bibisitahin natin ang pahina sa unang beses at gusto natin na walang laman ang form, at pangalawa, kung gusto nating bumalik sa *view* na may laman nang lahat na na-type natin. Kaya kailangan nating magdagdag ng kondisyon (gagamit tayo ng `if` para dito):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+Oras na para gawin ang mga dots `[...]`. Kung ang `method` ay `POST`, gusto nating gawin ang `PostForm` na may lamang datos galing sa form, tama ba? Gagawin natin ito gaya ng sumunod:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+Susuriin natin ang form kung ito ay balido, para ma-save natin!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+{% filename %}blog/views.py{% endfilename %}
+```
+
+Pangunahin na, mayroon tayong dalawang bagay dito: i-save natin ang form gamit ang `form.save` at magdagdag ng may-akda (dahil wala tayong `may-akda` na field sa `PostForm` at ang field na ito ay kinakailangan. Ang ibig sabihin ng `commit=False` ay hindi muna natin gustong i-save ang model na `Post` - magdagdag muna tayo ng may-akda. Kadalasan gagamit ka ng `form.save()` na walang `commit=False`, pero sa ngayon, kailangan natin itong idagdag. Ang `post.save()` ay magiimbak sa mga pagbabago (magdagdag ng may-akda) at ang bagong blog post at nilikha!
+
+Sa wakas, mas maganda kung tayo ay makakapunta ng direkta sa ating `post_detail` na pahina para sa ating bagong nalikha na blog post, tama ba? Para gawin ito, kailangan natin ng isa pang import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Idagdag ito sa pinakasimula ng file. At ngayon pede nating sabihin na, "pumunta sa `post_detail` na pahina para sa kakalikhang post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` ang pangalan sa view na gusto nating puntahan. Tandaan na ang *view* na ito ay nangangailangan ng `pk` na variable? Para mapasa ito sa ating mga view, gagamit tayo ng `pk=post.pk`, kung saan ang `post` at ang kakalikha lang na blog post!
+
+Sige, dami na nating sinabi, ngunit gusto siguro nating makita ang kung naano na ang kabuoang *view* ngayon, tama ba?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Tingnan natin kung gumana ba. Pumunta sa pahina na http://127.0.0.1:8000/post/new/, magdagdag ng `pamagat` at `teksto`, i-save ito... at tingnan! Ang bagong blog post ay nadagdag na at tayo ay pinasa sa `post_detail` na pahina!
+
+Siguro ay napansin mo na nag-set muna tayo ng paglathala na petsa bako tayo nag-save ng post. Maya-mata, aming ianunsyo ang *publish na button* sa **Django Girls Tutorial: Extensions**.
+
+Yan ay kasindak-sindak!
+
+> Dahil bago lang natin ginamit ang interface ng Django admin, inisip ng sistema na tayo ay nakalog-in pa. Mayroong mga sitwasyon na magresulta sa ating paglog-out (nasara ang browser, na-restart ang DB, at iba pa). Kung, gagawa ng post, at napansin mo na may mga problema tungkol sa walang nakalog-in na user, pumunta sa admin page na http://127.0.0.1:8000/admin at maglog-in ulit. Ito ay panandaliang mag-ayos sa problema. May permanenteng solusyong na nag-aabang sa iyo sa **Gawaing Bahay: magdagdag ng seguridad sa iyong website!** na kabanata pagkatapos ng pangunahing tutorial.
+
+![May problema sa paglog-in](images/post_create_error.png)
+
+## Pagpapabalido ng Form
+
+Ngayon, ipapakita namin kung gaano kahusay ang mga form ng Django. Ang blog post ay kinakailangan na mayroon `pamagat` at `teksto` na mga field. Sa ating `Post` na model, hindi natin sinabi na ang mga field na ito (kumpara sa `published_date` ay hindi kinakailangan, kaya si Django ay umaasa na naka-set ang mga ito.
+
+Subukang i-save ang form na walang `pamagat` at `teksto`. Hulaan kung ano ang mangyari!
+
+![Pagpapabalido ng Form](images/form_validation2.png)
+
+Si Django ay sinisuguro na ang lahat ng field sa ating form ay tama. Kagilas-gilas di ba?
+
+## I-edit ang form
+
+Ngayon, alam na natin kung paano magdagdag ng bagong form. Ngunit paano kung gusto natin i-edit ang umiiral na? Ito ay parehong-pareho lang sa ginawa natin kanina. Gagawa tayo ng mga importanteng bagay nang mabilisan. (Kung meron kang bagay na hindi maiintindihan, magtanong sa iyong taga sanay o hanapin sa nakalipas na mga kabanata, yamang atin ng napag-aralan and mga hakbang na ito.)
+
+Buksan ang `blog/templates/blog/post_detail.html` at idagdag ang susunod na linya
+
+{% filename %}blog/templates/blog/post/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+nang sa gayon ang template ay magmumukhang ganito:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Sa `blog/urls.py` idagdag natin itong linya:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+Gagamitin natin uli ang template na `blog/templates/blog/post_edit.html`, kaya ang kulang nalang natin ay ang *view*.
+
+Buksan natin ang `blog/views.py` at idagdag ito sa katapusan ng file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Ito ay halos kapareho sa ating `post_new` na view, di ba? Pero hindi talaga lubos. Una sa lahat, nagpasa tayo ng dagdag na `pk` na parameter mula sa ating mga url. Sa sunod, kukunin natin ang `Post` model na gusto nating i-edit gamit ang `get_object_or_404(Post, pk=pk)` at pagkatapos, sa paglikha ng form, ipasa natin ang post na ito isip `instance`, pareho sila sa pag-save natin sa form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+... at pagkatapos nating buksan ang form gamit ang post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+Sige, tingnan natin kung gumana ba! Puntahan natin ang `post_detail` na pahina. Dapat mayroon itong edit na button sa kaliwang itaas:
+
+![Edit na button](images/edit_button2.png)
+
+Pag-click mo nito makikita mo ang blog post sa ating form:
+
+![I-edit ang form](images/edit_form2.png)
+
+Huwag mag-atubiling magpalit ng pamaga at tesko at i-save ang mga pagbabago!
+
+Binabati ko kayo! Ang iyong application ay unti-unti nang nakompleto!
+
+Kung kailangan mo nang karagdagang impormasyon tungkol sa mga forms sa Django, dapat mong basahin ang dokumentasyon: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Seguridad
+
+Ang paglikha ng mga bagong post sa pamamagitan lang ng pag-clik ng link ay kamangha-mangha! Pero sa ngayon, kung sinuman ang bumisita sa iyong site ay maaring maglikha ng bagong blog post, at yan ang hindi mo siguro gustong mangyari. Gawin natin ito na ang button ay makikita mo lang pero hindi sa ibang tao.
+
+Sa `blog/templates/blog/base.html`, hanapin ang `page-header` na `div` at ang anchor na tag na nilagay natin kanina. Maging kagaya ito nito:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Magdadagdag tayo ng isa pang `{% if %}` na tag dito, at ang link ay makikita lamang ng mga gumagamit na naka log-in sa admin. Sa ngayon, ikaw palang! Palitan ang `<a>` na tag para maging kagaya nito:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+Ang `{% if %}` ay maging sanhi na ang link ay ipapadala sa browser kung ang gumamit na humingi sa pahina ay nakalog-in. Hindi ito nagproprotekta sa paglikha ng mga bagong posts, pero maganda na itong hakbang. Tatalakayin natin ang karamihan sa mga seguridad doon sa extention na mga klase.
+
+Natandaan mo ba ang edit na icon na kakadagdag lang natin sa pahina na detalye? Gusto din nating magdagdag ng kaparehang pagbabago dito. Para ang ibang tao ay hindi maaring mag-edit ng umiiral na mga post.
+
+Buksan ang `blog/templates/blog/post_detail.html` at hanapin ang linya na ito:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Palitan ito ng ganito:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Dahil maari kang nakalog-in, kung i-refresh mo ang pahina, wala kang makikitang kakaiba. I-load ang page sa ibang browser or sa window na naka incognito (tinanatawag na "InPrivate" sa Windows Edge), bagaman, at makikita mo ang linki ay hindi makikita, at ang icon ay wala din!
+
+## May isang bagay pa: oras na para mag-deploy!
+
+Tingnan natin kung gagana ito sa PythonAnywhere. Oras na para gumawa ng isa pang pag-deploy!
+
+* Una, i-commit ang iyong bagong code, at ipasa ito sa Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Nagdagdag ng mga view para makalikha/mag-edit ng blog post sa loob ng site"
+    $ git push
+    
+
+* Pagkatapos, sa loob ng [PythonAnywhere na Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Sa katapusan, puntahan ang iyong [Web tab](https://www.pythonanywhere.com/web_app_setup/) at pindutin ang **Reload**.
+
+Ay dyan na natapos! Binabati ko kayo! :)
\ No newline at end of file
diff --git a/tl/django_installation/README.md b/tl/django_installation/README.md
new file mode 100644
index 00000000000..cafabae49a8
--- /dev/null
+++ b/tl/django_installation/README.md
@@ -0,0 +1,7 @@
+# Pag-install ng Django
+
+> **Paalala** Maaring gumagamit ka ng Chromebook, kung ganon, laktawan ang kabanatang ito at siguraduhing masunod mo ang mga tagubilin sa [Chromebook na Pag-setup](../chromebook_setup/README.md).
+> 
+> **Paalala** If natapos mo ang mga hakbang sa pag-install nagawa mo na ito - maari kang dumiretso sa susunod na kabanata!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/tl/django_installation/instructions.md b/tl/django_installation/instructions.md
new file mode 100644
index 00000000000..b8bdc1708d9
--- /dev/null
+++ b/tl/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Kasama sa tuntuning ito ay nakabase sa mga tutorial ng Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Kasama sa tuntining ito ay nakabase sa [tutorial ng django-marcador](http://django-marcador.keimlink.de/) na lisensyado sa ilalim ng Creative Commons Attribution-ShareAlike 4.0 International License. Ang django-marcador na tutorial ay nakacopyright kay Markus Zapke-Gründemann et al.
+
+## Virtual na Kaligiran
+
+Bago tayo mag-install ng Django, mag-install muna tayo nang isa pang napakaimportanteng kagamitan na makakatulong na maging malinis ang ating coding environment sa iyong kompyuter. Maaring laktawan ang hakbang na ito, ngunit lubusan namin itong nirerekomenda. Ang pagsimula sa pinakamagandang setup na posible ay makaiwas sa napakaraming problema sa hinaharap!
+
+Kaya, maglikha tayo ng **virtual na environment** (tinatawag din na *virtualenv*). Ang virtualenv ay magbubukod sa iyong Python/Django na setup sa bawat proyekto. Ibig sabihin nito, lahat ng iyong mga binago sa iyong website ay hindi makaapekto sa iba mong ginagawa. Malinis, di ba?
+
+Ang kinakailangan mo lang gawin ay maghanap ng directory kung saan gusto mong maglikha ng `virtualenv`; ang iyong home directory, halimbawa. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+Para sa tutorial na ito, gagamit tayo ng bagong directory na `djangogirls` mula sa iyong home na directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Gagawa tayo ng isang virtualevn na tinatawag na `myenv`. Ang general na command ay nasa ganitong format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Para maglikha ng bagong `virtualenv`, kailangan mong buksan ang command prompt at patakbuhin ang `python -m venv myvenv`. Maging kagaya ito nito:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Kung saan ang `myvenv` ay ang pangalan ng iyong `virtualenv`. Maari kang gumamit ng ibang pangalan, pero mainam na gagamit ka ng maliliit na titik at walang mga agwat, tuldik o mga espesyal na letra. Maganda din na gagawin mong maikli ang iyong pangalan - gagamitin natin ito nang maraming beses!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` ang pangalan ng iyong `virtualenv`. Maari ka ring gumamit ng ibang pangalan, ngunit dapat maliit na titik at walang mga agwat. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **PAALALA:** Sa ibang bersyon ng Debian/Ubuntu maaring magatanggap ka ng sumunod na mga error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Ang virtual na environment ay hindi matagumpay na nalikha dahil walang ensurepip na magagamit.  Sa mga sistema na Debian/Ubuntu, kinakailangan mong mag-install ng python3-venv na package gamit ang sumunod na mga command.
+>        apt-get install python3-venv
+>     Maaring kailangan mong gumamit ng sudo sa command na iyan.  Pagkatapos mag-install ng python3-venv na package, ilikha mo ulit ang iyong virtual na environment.
+>     
+> 
+> Para dito, sundin mo ang mga tagubilin sa taas at mag-install ng `python3-venv` na package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **PAALALA:** Sa ibang bersyon ng Debian/Ubuntu ang pagpatakbo ng virtual environment na ito ay kasalukuyang magbigay ng sumusunod na problema:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Para maiwasan ito, gamitin mo ang `virtualenv` na ito.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **PAALALA:** Kung may error gaya nito
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> sa halip patakbuhin ito:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Paggamit ng virtualenv
+
+Ang command sa taas ay maglikha ng directory na tinatawag na `myenv` (o kung ano mang pangalan ang napili mo) na naglalaman ng ating virtual environment (sa simpleng salita, mga directory at mga files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Patakbuhin ang iyong virtual na environment sa pamamagitan ng pagpagpatakbo ng:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **PAALALA:** sa Windows 10 maaring makakatanggap ka ng error sa Windows PowerShell na nagsasabi na ang `pagpatakbo ng mga script ay nakadisable sa sistemang ito`. Kapag nangyari ito, magbukas ng isa pang Windows PowerShell gamit ang "Run as Administrator" na opsyon. Pagkatapos, subukang magtype ng sumusunod na mga command bago patakbuhin ang iyong virtual na environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         Ang execution policy ay nakakatulong para maprotektahan ka sa mga script na hindi mo pinagkatiwalaan. Ang pagbaago ng execution policy ay maaring maghantad sa iyong sa mga panganib sa seguridad na nalalarawan sa about_Execution_Poilicies na mga pangtulong na mga paksa sa http://go.microsoft.com/fwlink/?LinkID=135170. Gusto mo bang baguhin ang iyong execution policy? [Y] Oo  [A] Oo sa Lahat  [N] Hindi  [L] Hindi sa Lahat  [S] I-suspende  [?] Tulong ( ang default ay "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Patakbuhin ang iyong virtual environment sa pamamagitan ng pagpapatakbo ng:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Huwag kalimutan na palitan ang `myenv` sa iyong napili na `virtualenv` na pangalan!
+
+> **PAALALA:** minsan ang `source` ay maaaring hindi magagamit. Kung gayon, subukan mong gawin ito:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+Malalamon mo kung ang iyong `virtualenv` ay nakatakbo na kung makikita mo ang prompt sa iyong console na may unlapi na `(myenv)`.
+
+Kung gumagamit ka ng virtual na environment, si `python` ay awtomatikong magtukoy sa tamang bersyon para magamit mo ang `python` sa halip na ang `python3`.
+
+Sige, mayroon na lahat nang kinakailangan natin. Sa wakas maari na nating i-install ang Django!
+
+## Nag-iinstall ng Django
+
+Ngayon napatakbo mo na ang iyong `virtualenv`, pwede mo nang i-install ang Django.
+
+Pero bago yan, dapat nakasiguro tayo na pinakabago ang bersyon natin ng `pip`, ang software na gagamitin natin sa pag-install ng Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Pagkatapos, patakbuhin ang `pip install django~=1.11.0`(tandaan na gumamagamit tayo ng tilde kasunod ng sagisag ng katumbas: `~=` para mag-install ng Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> Kung may problema sa pagtawag ng pip sa Windows na platform, pakitingnan kung ang pathname ng iyong proyekto ay walang mga agwat, mga tuldik o mga espesyal na titik (halimbawa, `C:\Users\User Name\djangogirls`). Kung ganon, gumamit ka ng ibang lugar na walang mg agwat, tuldik o mga espesyal na mga letra (suggestion: `C:\djangogirls`). Maglikha ng bagong virtualenv sa loob ng bagong directory, tapos burahin mo ang dati at subukan ulit ang command sa taas. (Ang paglipat sa virtualenv na directory ay hindi gagana dahil ang virtualenv ay gumagamit ng absolute na mga path.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Ang command line mo ay maaring mag-freeze habang nag-iinstall ka ng Django. Kung ganon, gamitin mo ito sa halip ng code sa taas:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> Kung may problema sa pagtawag ng pip sa Ubuntu 12.04, patakbuhin ang `python -m pip install -U --force-reinstall pip` para maayos ang pag-install ng pip sa loob ng virtualenv.
+
+<!--endsec-->
+
+Ayan na! (Sa wakas) Handa ka nang maglikha ng Django application!
\ No newline at end of file
diff --git a/tl/django_models/README.md b/tl/django_models/README.md
new file mode 100644
index 00000000000..2058711606b
--- /dev/null
+++ b/tl/django_models/README.md
@@ -0,0 +1,199 @@
+# Mga model ng Django
+
+Ang gusto nating ilikha ngayon ay isang bagay na mag-imbak ng lahat ng ating mga post sa loob nag ating blog. Pero para magawa natin ito dapat nating pag-usapan ang tungkol sa mga bagay na tinatawag na `objects`.
+
+## Mga Object
+
+May isang konsepto sa pag-proprogram na tinatawag na `object-oriented na programming`. Ang ideya ay imbes na isulat ang lahat isip isang napakataas na datig ng mga programming na instruksyon, maari nating i-model ang mga bagay-bagay at bigyang kahulugan kung paano sila makipaghalubilo sa bawat isa.
+
+Kaya ano ang ibig sabihin ng object? Ito ay isang koleksyon ng mga katangian at mga askyon. Medyo kakaiba, pero bibigyan namin kayo ng halimbawa.
+
+Kung gusto mo na i-model ang isang pusa, gagawa tayo ng isang object na `Cat` na may mga katangian tulad ng `kulay`, `edad`, `kalagayan` (gaya ng maganda, pangit, o inaantok ;)), at ang `may-ari`(na maari ding gawing `Person` na object - o pede din na walang laman sa kaso ng mga gala na pusa).
+
+Pagkatapos ang `Cat` ay may mga aksyon: `purr`, `scratch`, o `feed` (kung saan, bibigyan natin ang pusa ng `CatFood` na maari ding gawing hiwalay na object na may katangian na gaya ng `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+Kaya, ang idea ay ang paglalarawan ng mga tunay na bagay sa ating code na may mga katangian (tinawag na `object properties`) at mga aksyon (tinatawag na mga `method`).
+
+Paano kaya natin i-model ang ating blog post? Gusto nating gumawa ng blog, di ba?
+
+Kailangan nating sagutin ang tano na: Ano ang blog post? Ano ang mga katangian na dapat meron ito?
+
+Sigurado tayo na ang ating blog post ay nangangailangan ng mga tekso sa nilalaman at sa pamagat nito, di ba? Mainam din na malaman natin kung sino ang nagsulat nito - kaya kailangan natin ng may-akda. Sa huli. gusto din nating malaman kung kailan nalikha at nailathala ang post.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Ano ang mga klaseng bagay ang maaring magawa sa blog post? Maganda kung makakaroon ng isang `method` na maglalathala ng mga post, di ba?
+
+Kaya, mangangailangan tayo ng `paglathala` na method.
+
+Dahil alam na natin kung ano ang gusto nating matamo, simulan na natin itong i-model sa Django!
+
+## Model ng Django
+
+Alam na natin kung ano ang object, maari na tayong maglikha ng model ng Django para sa ating blog post.
+
+Ang model sa Django ay isang espesyal na uri ng object - nakasave ito sa loob ng `database`. Ang database ay isang koleksyon ng mga datos. Ito ay lugar kung saan mo itatago ang mga impormasyon tungkol sa mga gumagamit, iyong mga blog post, at iba pa. Gagamit tayo ng SQLite na database para itago ang ating mga datos. Ito ay isang default na Django database adapter - ok na sa ating ito sa ngayon.
+
+Maaring mong isipin ang model sa isang database isip isang spreadsheet na may mga tudling (fields) at mga hanay (datos).
+
+### Paglikha ng aplikasyon
+
+Para maging malinis ang lahat, maglikha tayo ng hiwalay na aplikasyon sa loob ng ating proyekto. Maganda na maayos ang lahat sa simula pa lang. Para maglikha ng aplikasyon, kailangan nating patakbuhin ang sumusunod na command sa ating console (mula sa `djangogirls` na directory kung saan nandoon ang ating `manage.py` na file):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Paglikha ng model ng blog post
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Pakisuriin ulit at tingnan kong gumagamit ka ng dalawang salungguhit (`_`) sa bawat panig ng `str`. Ang kombensiyon na ito ay kadalasang ginagamit sa Python at minsan din naming tinatawag na "dunder" (pinaikling anyo ng "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` ay isang espesyal na keyword na nagpapakita na tayo ay nagbibigay kahulugan sa isang object.
+- Ang `Post` ay ang pangalan ng ating model. Maari natin itong bigyan ng ibang pangalan (pero dapat nating iwasan ang mga espesyal na titik at ang mga whitespace). Parating simulan ang pangalan ng class sa malaking titik.
+- Ang ibig sabihin ng `models.Model` ay ang Post ay isang Model ng Django, kaya alam ni Django na ito ay dapat nakasave sa database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- Ang `models.CharField` - ito ang paraan para ating ilarawan ang tekso na may nakatakdang bilang ng mga letra.
+- Ang `models.TextField` - ay para sa mga mahabang teksto na walang nakatakdang haba. Ito ay tamang-tama para gawing nilalaman ng blog post, di ba?
+- Ang `models.DateTimeField` - ito ay ang petsa at ang oras.
+- Ang `models.ForeignKey` - ay pag-uugnay sa isa pang model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Maglikha ng mga table para sa model sa loob ng database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/tl/django_orm/README.md b/tl/django_orm/README.md
new file mode 100644
index 00000000000..956289eaa17
--- /dev/null
+++ b/tl/django_orm/README.md
@@ -0,0 +1,218 @@
+# ORM at QuerySets ng Django
+
+Sa kabanatang ito matutunan mo kung paano si Django magkonek sa database at maglagay ng mga datos dito. Tara na!
+
+## Ano ang QuerySet?
+
+Ang QuerySet ay, masasabi natin na isang listahan ng mga object sa isang binigay na Model. Ang QuerySet ay nagbigay ng pamamaraan para mabasa mo ang mga datos mula sa database, mag-filter nito at mag-ayos ayon sa pagkasunod-sunod nito.
+
+Mas madali pag natutunan mo ito sa pamamagitan ng halimbawa, tara na?
+
+## Shell ng Django
+
+Bukasan ang iyong local na console (hindi yung sa PythonAnywhere) at i-type ang command na ito:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Ang epekto nito ay dapat ganito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Ikaw ngayon ay nasa interactive console na ni Django. Gaya lang ito ng prompt ng Pythod, pero may mga karagdagang mahika ni Django. :) Maari mong magamit ang lahat ng mga command ni Python dito, siyempre.
+
+### Lahat ng mga object
+
+Subukan nating magdisplay ng lahat ng ating mga post muna. Magagawa mo ito sa pamamagitan ng sumunod na command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Ayy! May problemang nakita. Sinasabi nito na walang umiiral na Post. Tama po ito - nakalimutan nating mag-import muna!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Ito ay ang listahan ng mga post na nalikha natin kanina lang. Nilikha natin ang mga post na mga ito gamit ang admin interface ng Django. Pero ngayon gusto nating maglikha ng mga bagong post gamit ang Python, paano kaya natin magagawa ito?
+
+### Create object
+
+Ito ang paraan para maglikha ng bagong Post na object sa ating database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Pero may nalilimutan tayong isang sangkap dito: `me`. Kailangan nating magpasa ng instance ng `User` na model isip may-akda. Paano natin magawa ito?
+
+Mag-import muna tayo ng User na model:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Anong mga gumagamit ang nasa loob ng ating database? Subukan natin ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+Ito ay ang superuser na nilikha natin kanina! Ngayon ay kukuha tayo ng instance ng user na ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Gaya ng makikita mo, may `nakuha` tayong isang `User` na may `bansag` na katumbas ng 'ola'. Mahusay! Siyempre, kailangan natin itong baguhin gamit ang ating sariling bansag.
+
+Ngayon makakalikha na tayo ng post sa wakas:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Yay! Gusto mong tingnan kung gumana ba ito?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Ayon, may isang nadagdag na post sa listahan!
+
+### Magdagdag pa ng mga post
+
+Maari kang maglaro muna at magdagdag pa nga mga post para makita mo kung paano ito gumagana. Magdagdag ng dalawa o tatlo pa at pagkatapos ay punta na tayo sa sumunod na parte.
+
+### Mag-filter ng mga object
+
+Ang malaking parte ng QuerySet ay ang abilidad na pagfilter nito. Sabihin natin na gusto nating hanapin ang lahat ng post na sinulat ng user na si ola. Gagamit tayo ng `filter` sa halip na `all` sa ating `Post.objects.all()`. Sa panaklong, sasabihin natin ang (mga) kondisyon na dapat makita sa blog post para mapunta siya sa ating queryset. Sa kaso natin, ang kondisyon ay ang `author` ay dapat katumbas na `me`. Ang pamamaraan ng pagsulat nito sa Django ay `author=me`. Ngayon ang ating piraso ng code ay maging kagaya nito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+O maari din na gusto nating makita ang mga post na naglalaman ng salitang 'title' sa ating `title` na field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Paalala** May dalawang salungguhit na letra (`_`) sa pagitan ng `title` at ang `contains`. Ang ORM ni Django ay gumagamit ng mga tuntunin para ihiwalay ang mga field name na ("title") at ang mga operasyon o mga filter na ("contains"). Kung gagamit ka lang ng isang salungguhit, makakuha ka ng error gaya ng "FieldError: Cannot resolve keyword title_contains".
+
+Maaring ding makuha mo ang lahat ng nalathala na mga post. Magagawa natin ito sa pamamagitan ng pagfilter sa lahat ng posts na mayroong `published_date` na nakalipas na:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Sa kasamaang palad, ang post na ating nadagdag mula sa console ng Python ay hindi pa nalathala. Pero mababago natin ito! Una, kukuha tayo ng instance ng post na gusto nating ilathala:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+At i-publish ito gamit ang ating `publish` na method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Ngayon, subukan mong kumuha ng mga nailathala na mga post ulit (pindutin ang up na key ng tatlong beses at pindutin ang `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Pagkakaayos ng mga Object
+
+Ang QuerySet ay magtutulot sa iyo na ayusin ang lista ng mga object. Subukan nating iayos sila sa pamamagitan ng `created_date` na field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Maari din nating ibaligtad ang pagkakasunod sa pamamagitan ng pagdagdag ng `-` sa simula:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Pag-chain ng mga QuerySet
+
+Maari mo ding pagsamahin ang mga QuerySet sa pamamagitan ng **pag-chain** nila ng sabay-sabay:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+Ito ay tunay na makapangyarihan at sa pamamagitan nito maari kang gumawa ng mga komplekado na mga query.
+
+Magaling! Handa ka na ngayon sa susunod na parte! Para isara ang shell, i-type mo ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/tl/django_start_project/README.md b/tl/django_start_project/README.md
new file mode 100644
index 00000000000..dcc6c53f9ee
--- /dev/null
+++ b/tl/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Ang kauna-unahang proyekto mo sa Django!
+
+> Kasama sa kabanatang ito ay nakabase sa mga tutorial ng Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Kasama sa kabanatang ito ay nakasalig sa [django-marcador na tutorial](http://django-marcador.keimlink.de/) na lisensyado sa ilalim ng Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador na tutorial ay nakacopyright kay Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+Ang unang hakbang ay ang pagsimula ng bagong proyekto sa Django. Ibig sabihin nito, magpapatakbo tayo ng mga script na ibinigay ni Django na maglikha ng banghay ng proyekto ng Django para sa atin. Ito ay lipon lang ng mga directory at mga file na gagamitin natin mamaya.
+
+Ang pangalan ng ibang file at directory ay nakaimportante para kay Django. Hindi mo dapat palitan ng pangalan ang mga file na ating malikha. Ang paglipat nito sa ibang lugar ay hindi rin magandang ideya. Kinakailangan ni Django na panatilihin ang istraktura nito para mahanap niya ang mga importanteng bagay.
+
+> Tandaan na patakbuhin ang mga ito sa loob ng virtualenv. Kung hindi ka makakita ng unlapi na `(myenv)` sa iyong console, kailangan mong gamitin ang iyong virtualenv. Ating naipaliwanag kung paano ito gawin sa **pag-install ng Django** na kabanata sa parte na **Working with virtualenv**. Ang pagtype ng `myenv\Scripts\activate` sa Windows o `source myenv/bin/activate` sa Mac OS X o Linux ang gagawa nito para sa iyo.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+Sa iyong Mac OS X o Linux na console, dapat mong patakbuhin ang sumusunod na mga command. **Huwag kalimutan ang magdagdag the tuldok `.` sa bandang huli!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Ang tuldok `.` ay mahalaga dahil nagsasabi ito sa script na i-install ang Django sa kasalukuyang directory (kung saan ang tuldok `.` ay ang pinaikling pagbanggit).
+> 
+> **Paalala** Habang nagtatype ng command sa taas, tandaan na ang dapat mo lang i-type ang parte na nagsisimula sa `django-admin`. Ang `(myenv) ~/djangogirls$` na parteng pinakita dito ay isa lang halimbawa sa prompt na magkukuha sa iyong input sa iyong command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Sa Windows dapat mong patakbuhin ang sumusunod na command. **(Huwag kalimutang magdagdag ng tuldok `.` sa bandang huli)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Ang period `.` ay mahalaga dahil ito ang nagsasabi sa script na i-install ang Django sa kasalukuyang directory (kung saan ang tuldok `.` ay ang pinaikling pagbanggit).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+Ang `django-admin.py` ay isang script na maglilikha ng mga directory at mga files para sa iyo. Sa ngayon dapat mayroon ka ng directory structure gaya nito:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Paalala**: sa iyong directory structure, makikita mo rin ang iyong `venv` na directory na nilikha natin kanina.
+
+Ang `manage.py` ay isang script na makakatulong sa pagpapamahala ng site. Gamit ito maaari tayong (bukod sa iba pang mga bagay) magpatakbo sa web server sa kompyuter nang hindi mag-install ng kahit na ano.
+
+Ang `settings.py` ay ang file na naglalaman ng mga kompigurasyon ng iyong website.
+
+Naalala mo ba noong nag-usap tayo tungkol sa mail carrier na nagsururi kung saan magpadala ng sulat? Ang `urls.py` ay isang file na nalalaman ng lista ng mga pattern na ginagamit ng `urlresolver`.
+
+Balewalain muna natin ang ibang mga file, sa ngayon hindi natin sila babaguhin. Ang dapat mo lang tandaan ay huwag aksidenteng mabura ang mga ito!
+
+## Pagbago ng mga setting
+
+Ngayon gagawa tayo ng mga pagbabago sa `mysite/settings.py`. Buksa ang file gamit ang iyong editor ng code na ininstall kanina.
+
+**Paalala**: Laging isipin na ang `settings.py` ay isang karaniwang file lang, gaya ng iba. Maari mo itong buksan sa loob ng editor ng code, gamit ang "file -> open" na aksyon ng menu. Ito ay magpalabas ng karaniwang window kung saan maari kang mag-navigate sa iyong `settings.py` at piliin ito. Ang alternatibo, maari mong buksan ang file sa pamamagitan ng pagnavigate sa djangogirls na folder sa iyong desktop at pag right-click nito. Pagkatapos, piliin mo ang iyong editor ng code mula sa listahan. Ang pagpili ng editor ay importante dahil maaring may ibang programang nakainstall na makapagbukas nito ngunit hindi ka hahayaang makapag-edit nito.
+
+Maganda sana kung may tamang oras tayo sa ating website. Pumunta sa [lista ng mga time zone ni Wikipedia](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) at kopyahin ang iyong time zone (TX) (e.g. `Europe/Berlin`).
+
+Sa `settings.py`, hanapin ang linya na naglalaman ng `TIME_ZONE` at baguhin ito gamit ang iyong timezone. Halimbawa:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+Ang code ng wika ay binubuo ng wika, halimbawa `en` para sa Ingles or `de` para sa Aleman, at ang code ng bansa, halimbawa `de` para sa Alemanya o `ch` para sa Switzerland. Gusto mo itong idagdag kung gusto mo na ang mga default na mga button at ang mga notipikasyon mula sa Django ay nasa iyong wika. Kaya magkakaroon ka ng "Cancel" na button na naisalin sa wika na iyong binigay dito. [Ang Django ay mayroon ng maraming nahandang pagsasalin](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Baguhin ang code ng wika sa pamamagitan ng pagbago sa sumusunod na linya:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Kailangan din nating magdagdag ng mga path para sa ating static na mga file. (Malalaman natin ang lahat tungkol sa mga static na files at mga CSS sa mamayang parte ng tutorial.) Bumaba sa *katapusan* ng file, at sa baba ng `STATIC_URL` na entry, magdagdag ng bago na tinatawag na `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Kung ang `DEBUG` ay `True` at ang `ALLOWED_HOSTS` ay walang laman, ang host ay ihahambing sa `['localhost','127.0.0.1','[::1]']`. Ito ay hindi magtugma sa ating hostname sa PythonAnywhere pagkatapos nating i-deploy ang ating aplikasyon kaya kailangan nating baguhin ang sumusunod na setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Paalala**: Kung ikaw ay gumagamit ng Chromebook, idagdag ang linyang ito sa baba ng iyong settings.py na file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage''`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Mag-setup ng database
+
+May maraming iba-ibang dabatase na software ang maaaring magstore ng mga datos para sa ating site. Gagamit tayo ng default na, `sqlite3`.
+
+Ito ay nakaset-up na sa parteng ito ng ating `mysite/settings.py` na file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Para maglikha ng database para sa ating blog, patakbuhin natin ang sumunod sa ating console: `python manage.py migrate`(kailangan na nasa `djangogirls` na directory tayo na naglalaman ng `manage.py` na file). Kung walang problema, dapat makakita ka ng gaya nito:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+At tapos na tayo! Oras na para patakbuhin ang ating web server at tingnan kung gumana ang ating website!
+
+## Nagpapatakbo ng web server
+
+Kailangan kang nasa loob ng directory na naglalaman ng `manage.py` na file (ang `djangogirls` na directory). Sa console, mapatakbo natin ang web server sa pamamagitan ng pagpatakbo ng `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Kung ikaw ay nasa Chromebook, sa halip ay gamitin mo ang command na ito:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+Kung ikaw ay nasa Windows at hindi gumana na may `UnicodeDecodeError`, sa halip ay gamitin mo ang command na ito:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Ngayon, kailangan mo lang siguruhin na ang iyong website ay gumagana. Buksan ang browser (Firefox, Chrome, Safari, Internet Explorer o kahit anung ginagamit mo) at ilagay ang address na ito:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+Kung ikaw ay gumagamit ng Chromebook, parating bibisitahin mo ang test na server sa pamamagitan ng:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Binabati ko kayo! Nakalikha kana ng kaunaunhan mong website at napatakbo ito gamit ang web server! Ang galing di ba?
+
+![Gumana ito!](images/it_worked2.png)
+
+Habang tumatakbo ang web server, wala kang makikitang bagong command-line na prompt para maglagay ng karagdagang mga command. Ang terminal ay tatanggap ng mga bagong teksto pero hindi nito patatakbuhin ang mga bagong command. Ito ay dahil ang web server ay parating nakatakbo para mag-antay ng mga paparating na mga request.
+
+> Ating pinagbalik-aralan kung paano gumagana ang mga web server sa **How the Internet words** na kabanata.
+
+Para magtype ng karagdagang mga command habang tumatakbo ang web server, magbukas ng bagong terminal window at i-activate ang iyong virtualenv. Para pahintuin ang web server, bumalik sa window kung saan ito napatakbo at pindutin ang CTRL+C - Control at C na mga key ng sabay-sabay (sa Windows, maaring kailangan mong pinduting ang Ctrl+Break).
+
+Handa na ba sa sunod na hakbang? Oras na para maglikha ng mga nilalaman!
\ No newline at end of file
diff --git a/tl/django_templates/README.md b/tl/django_templates/README.md
new file mode 100644
index 00000000000..bb086a13a3f
--- /dev/null
+++ b/tl/django_templates/README.md
@@ -0,0 +1,106 @@
+# Mga template ng Django
+
+Oras na para magpakita ng mga datos! Ang Django ay nagbibigay sa atin ng mga nakakatulong na mga built-it na mga **template na tags** para dito.
+
+## Ano ang mga template tags?
+
+Makita mo, sa HTML, hindi ka maaring magsulat ng code na Python, dahil hindi ito maiintindihan ng mga browser. Alam lang nila ang HTML. Alam natin na ang HTML ay hindi nababago, habang ang Python ay pabago-bago.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Magdisplay ng Post List na Template
+
+Sa nakaraang kabanata, binigyan natin ang ating template ng lista ng mga posts sa ating `posts` na variable. Ngayon, maari na natin itong ilagay sa HTML.
+
+Para magprint ng variable sa templates ng Django, gagamit tayo ng dobleng pamukod na may pangalan ng variable sa loob, gaya nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Subukan mo ito sa loob ng iyong `blog/templates/blog/post_list.html` na template. Palitan ang lahat mula sa pangalawa `<div>`hanggang sa pangatlong `</div>` ng `{{ posts }}`. I-save ang file, at i-refresh ang pahina para makita ang mga resulta:
+
+![Tambilang 13.1](images/step1.png)
+
+Gaya nang makikita mo, ang lahat ng nakuha natin ay ito lang:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Ibig sabihin nito ay naintindihan ni Django na ito ay isang lista ng mga object. Natandaan mo mula sa **Introduksyon sa Python** kung paano nati mapakita ang mga lista? Oo, gamit ang for loops! Sa Django template gagawin natin ito gaya nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Subukan ito sa iyong template.
+
+![Tambilang 13.2](images/step2.png)
+
+Gumana ito! Pero gusto nating i-display ang mga post gaya ng mga static na post na ginawa natin kanina sa **Introduksyon sa HTML** na kabanata. Maari mong ihalo ang HTML at ang mga template tags. Ang ating `body` ay magmukhang ganito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Blog ng Django Girls</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Lahat ng nilagay mo sa pagitan ng `{% for %}` at `{% endfor %}` ay uulitin sa bawat object na nasa list. I-refresh ang iyong pahina:{% endraw %}
+
+![Tambilang 13.3](images/step3.png)
+
+Napansin mo ba na gumagamit tayo ng kakaibang notasyon ngayon (`{{ post.title }}` or `{{ post.text }})`? Tayo ay kukuha ng mga datos sa bawat field na nakalarawan sa ating `Post` na model. At, ang `|linebreaksbr` ay nagpipe nga mga teskto ng post sa filter para i-convert ang mga line-break sa mga talata.
+
+## Isa pang bagay
+
+Magandang tingnan kung ang website ay gumagana pa rin sa publikong Internet, di ba? Subukan nating mag-deploy sa PythonAnywhere ulit. Eto ay pagbibigay buod sa mga hakbang…
+
+* Una, itulak ang iyong code sa Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Binago ang mga template para magdisplay ng mga post galing sa database."
+    [...]
+    $ git push
+    
+
+* Pagkatapos, maglog ulit sa [PythonAnywhere](https://www.pythonanywhere.com/consoles/) at pumunta sa iyong **Bash na console** (o magpatakbo ng isa pa), at patakbuhin ang:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Sa katapusan, puntahahan ang [Web tab](https://www.pythonanywhere.com/web_app_setup/) at pindutin ang **Reload** sa iyong web app. Ang iyong update ay dapat naka-live! Kung ang mga blog post sa ating PythonAnywhere na site ay hindi tugma sa mga post na makikita sa blog na nakahost sa ating local na serva, okay lang yan. Ang database sa ating local na kompyuter at sa Python Anywhere ay hindi nakasync gaya ng iba nating mga file.
+
+Maligayang bati! Ngayon dumiretso ka na at subukan mong magdagdag ng bagong post sa iyong Django admin (tandaan magdagdag ng published_date!) Siguraduhin na nasa Django admin ka ng iyong pythonanywhere na site, https://yourname.pythonanywhere.com/admin. Pagkatapos i-refresh ang iyong pahina at tingnan kung makita mo ang post mo doon.
+
+Parang anting-anting di ba? Ipinagmamalaki ka namin! Lumayo muna ng saglit sa iyong kompyuter - dapat kang magpahinga. :)
+
+![Tambilang 13.4](images/donut.png)
\ No newline at end of file
diff --git a/tl/django_urls/README.md b/tl/django_urls/README.md
new file mode 100644
index 00000000000..0925c2329b9
--- /dev/null
+++ b/tl/django_urls/README.md
@@ -0,0 +1,129 @@
+# Mga URL ng Django
+
+Tayo ay gagawa ng ating kauna-unahang webpage: ang homepage para sa iyong blog! Pero una, pag-aralan muna natin ang tungkol sa mga URLs ng Django.
+
+## Ano ang URL?
+
+Ang URL ay isang web address lamang. Makikita mo ang URL sa bawat oras na bibisita ka ng website - makikita mo ito sa address bar ng iyong browser. (Oo! ang `127.0.0.1:8000` ay isang URL! At ang `https://djangogirls.org` ay isa ring URL.)
+
+![Url](images/url.png)
+
+Bawat pahina na nasa Internet ay nangangailangan ng sariling URL. Sa ganitong paraan, malalaman ng iyong aplikasyon kung ano dapat ang ipakita niya sa user na nagbubukas ng URL na ito. Sa Django, gagamit tayo ng tinatawag na `URLconf` (kompigurasyon ng URL). Ang URLconf ay isang grupo ng mga pattern na susubukang itugma ni Django sa hiniling na URL para mahanap nito ang tamang view.
+
+## Paano gumagana ang mga URL sa Django?
+
+Buksan natin ang `mysite/urls.py` na file sa ating editor ng code at tingnan natin ang laman nito:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+Makikita mo, may nilagay na si Django doon para sa atin.
+
+Ang mga linya sa pagitan ng tripleng mga panipi (`'''` or `"""`) ay tinatawag na mga docstrings - maari mo silang isulat sa taas ng file, class, o method para ilarawan kung ano ang ginagawa nito. Hindi sila papatakbuhin ni Python.
+
+Ang admin URL, na binisita natin sa nakaraang kabanata ay nandito na:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+Ang ibig sabihin ng linyang ito ay bawat URL na nagsisimula sa `admin/`, si Django ay maghahanap ng katugmang *view*. Sa kasong ito, naglakip tayo ng napakaraming admin URLS kaya hindi ito lahat nakasiksik sa maliit na file na ito - mas madaling mabasa at malinis ito.
+
+## Regex
+
+Naisip mo ba kung paano tinugma ni Django ang mga URL sa mga view? Buweno, ang parteng ito ay mahirap. Si Django ay gumagamit ng mga `regex`, pinaikli sa "regular expressions". Si regex ay mayroong napakaraming (napakarami!) mga patakaran na bumuo sa search pattern. Dahil ang mga regex ay malalim na paksa, hindi natin idetalye kung paano ito gumagana.
+
+Kung gusto mo pa ring maintindihan kung paano natin nilikha ang mga pattern, heto ang isang halimbawa ng proseso - mangangailangan lang tayo ng makitid na kubtangkas ng mga patakara para ipahayag ang pattern na ating hinahanap:
+
+* `^` para sa simula ng teksto
+* `$` para sa katapusan ng teksto
+* `\d` para sa numero
+* `+` para ipakita ang nakaraang aytem ay dapat ulitin nang hindi kukulangin ng isa
+* `()` para kunin ang parte ng pattern
+
+Kahit anong parte ng URL na nagbibigay-kahulugan ay literal na kukukunin.
+
+Ngayon, isipin mo na may website ka na may address gaya ng `http://www.mysite.com/post/12345/`, kung saan ang `12345` ay ang numero ng iyong post.
+
+Ang pagsulat ng hiwalay na mga view para sa lahat ng numero ng mga post ay sobrang nakakaasar. Gamit ang mga regular na ekspresyon, maari tayong maglikha ng pattern na magtugma sa ating URL at kukuha ng numero para sa atin: `^post/(\d+)/$`. Hahatiin natin ito sa pira-piraso para makita natin kung ano ang ginagawa natin dito:
+
+* Ang **^post/** ay nagsasabi kay Django na kunin ang lahat ng may `post` sa simula ng url (pagkatapos ng `^`)
+* Ibig sabihin ng **(\d+)** ay may mga numero (isa o higit pa na numero) at gusto nating hulihin at kukunin ang numero
+* ang **/** ay nagsasabi kay django na dapat may `/` na karakter na sumunod
+* Ang **$** ay nagpapahiwatig sa katapusan ng URL, ibig sabihin na ang mga string lang na nagtatapos sa `/` ay tutugma sa pattern na ito
+
+## Ang iyong kauna-unang URL ng Django!
+
+Oras na para maglikha ng ating unang URL! Gusto natin na ang 'http://127.0.0.1:8000/' ang magiging home page ng ating blog at para i-display ang lista ng mga post.
+
+Gusto din natin na panatilihin ang `mysite/urls.py` na file na malinis, kaya mag-import lang tayo ng mga URL mula sa ating `blog` na aplikasyon papunta sa pangunahing `mysite/urls.py` na file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Ang iyong `mysite/urls.py` na file ay dapat kagaya nito:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Si Django ngayon ay mag-redirect sa lahat ng papasok sa 'http://127.0.0.1:8000/' sa `blog.urls` at maghanap ng karagdagang instruksyon doon.
+
+Ang pagsulat nga mga regular expression sa Python ay parating ginagawa na may `r` sa harap ng string. Ito ay nakakatulong na palatandaan para sa Python na ang string ay maaring maglaman ng mga espesyal na karakter na hindi para sa Python, kundi sa halip ay para sa regular na expression.
+
+## blog.urls
+
+Maglikha ng bago na walang laman na file na pinangalangang `urls.py` sa `blog` na directory. O sige! Idagdag mo ang unang dalawang linya:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Dito iniimport natin ang function ng Django na `url` at ang lahat ng ating mga `view` mula sa `blog` na aplikasyon. (Wala pa tayong kahit na ano, pero pupunta tayo dyan pagkatapos ng ilang minuto!)
+
+Pagkatapos niyan, maari nating idagdag ang ating unang URL na pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+Gaya ng makikita mo, tayo ngayon ay naglalaan na ng `view` na tinatawag na `post_list` sa `^$` na URL. Ang regular expression ay magtutugma sa `^` (ang simula) kasunod ng `$` (ang katapusan) - kaya ang string na walang laman lang ang matugma. Tama iyan, dahil sa loob ng mga resolver ng Django URL, ang 'http://127.0.0.1:8000/' ay hindi parte ng URL. Ang patter na ito ay magsasabi kay Django na ang `view.post_list` ay ang tamang lugar na puntahan kung may bumibista sa iyong website sa 'http://127.0.0.1:8000/' na address.
+
+Ang huling parte, ang `name='post_list'`, ay ang pangalan ng URL na gagamitin natin para matukoy ang view. Maari itong kaparehas sa pangalan ng ating view ngunit maari din itong ganap na magkaiba. Gagamitin natin mamaya ang mga napangalangang mga URL sa ating proyekto, kaya importante na pangalanan ang bawat URL sa app. Dapat din nating subukan na gawing pambihira ang pangalan ng mga URL at madaling tandaan.
+
+Kung bibisitahin mo ang http://127.0.0.1:8000/ ngayon, makikita mo ang mensahe na nagsasabing 'web page not available'. Ito ay dahil ang server (naalala mo ang pagtype natin ng `runserver`?) natin ay hindi na nakatakbo. Tingnan ang iyong server console window para malaman kung bakit.
+
+![Error](images/error1.png)
+
+Ang iyong console ay nagpapakita ng error, ngunit huwag mag-alala - ito ay talagang nakakatulog: sinasabi nito na mayroon kang **walang attribute na 'post_list'**. Iyan ang pangalan ng *view* na sinubukang hanapin at gamitin ni Django, ngunit hindi pa natin ito nalikha. Sa puntong ito ang `/admin/` ay hindi rin gagana. Huwag mag-alala - dadating din tayo diyan.
+
+> Kung gusto mong malaman ng masinsinan ang tungkol sa Django URLconfs, tingnan ang opisyal na dokumentasyon: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/tl/django_views/README.md b/tl/django_views/README.md
new file mode 100644
index 00000000000..fd85a0e12de
--- /dev/null
+++ b/tl/django_views/README.md
@@ -0,0 +1,44 @@
+# Mga view ng Django - oras na para maglikha!
+
+Oras na para ayusin ang bug na nagawa natin sa huling kabanata! :)
+
+Ang *view* ay isang lugar kung saan natin ilalagay ang "logic" ng ating aplikasyon. Humihingi ito ng mga impormasyon galing sa ating `model` na nalikha dati at ipasa niya ito sa `template`. Gagawa tayo ng template sa susunod na kabanata. Ang mga view ay mga functions ng Python na medyo mahirap kung ikumpara natin sa mga nasulat natin sa **Introduksyon sa Python** na kabanata.
+
+Ang mga view ay nakalagay sa `views.py` na file. Magdadagdag tayo ng *views* sa ating `blog/views.py` na file.
+
+## blog/views.py
+
+Sige, buksan natin ang file at tingnan kung ano ang nilalaman nito:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Maglikha ng iyong mga view dito.
+```
+
+Wala pang masyadong nakasulat dito.
+
+Tandaan na ang linya na nagsisimula sa `#` ay mga komento - ibig sabihin na ang mga linyang ito ay hindi papatakbuhin ni Python.
+
+Gagawa tayo ng *view* gaya ng inimungkahe sa komento. Idagdag ang sumusunod na minimal view sa baba nito:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Gaya ng makikita mo, naglikha tayo ng function (`def`) na tinatawag na `post_list` na kukuha ng mga `request` at `magbalik` ng function na `render` na mag render (bumuo) sa ating template na `blog/post_list.html`.
+
+I-save ang file, puntahan ang http://127.0.0.1:8000/ at tingnan kung ano ang laman.
+
+May ibang error na naman! Basahin kung ano ang nangyari ngayon:
+
+![Error](images/error.png)
+
+Ito ay nagpapakita na ang server ay tumatakbo na ulit, pero hindi pa rin ito tama, di ba? Huwag mag-alala, isa lang itong error page, walang dapat na katakutan! Gaya ng mga error messages sa console, ang mga ito ay talagang nakakatulong. Mabasa mo ang *TemplateDoesNotExist*. Ayusin natin ang bug at maglikha tayo ng template sa susunod na kabanata!
+
+> Pag-aralan pa ng masinsinan ang tungkol sa Django views sa pamamagitan ng pagbasa ng opisyal na dokumentasyon: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/tl/dynamic_data_in_templates/README.md b/tl/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..9da1ea5bba9
--- /dev/null
+++ b/tl/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Mga dynamic na datos sa mga template
+
+Mayroon tayong iba-ibang piraso na nakaposisyon: ang `Post` na model na nakadefine sa `models.py`, ang `post_list` sa `views.py` at ang template na dinagdag. Ngunit paano natin gawin na mapakita ang ating mga post sa ating HTML template? Dahil yan ang gusto nating gawin - kumuha ng mga nilalaman (mga model nakasave sa database) at ipakita itong mabuti sa ating template, di ba?
+
+Ito ang eksaktong dapat gawain ng *views*: magkonek sa mga model at mga template. Sa ating `post_list` na *view*, kailangan nating kunin ang mga model na gusto nating i-display at ipasa ang mga ito sa ating template. Sa *view* pagpasyahan natin kung anong model ang idisplay sa template.
+
+Sige, kaya paano natin magagawa ito?
+
+Kailangan nating buksan ang `blog/views.py`. Sa ngayon ganito ang itsura na ating `post_list` na *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Naalala mo iyong pinag-usapan natin ang tungkol sa pag-include na mga code na naisulat sa iba-ibang mga file? Ngayon na ang oras na kailangan nating i-include ang ating model na sinulat sa `models.py`. Magdagdag tayo ng linya na `from .models import Post` gaya nito:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+Ang ibig sabihin ng tuldok bago ang `models` ay *kasalukuyang directory* o *kasalukuyang aplikasyon*. Ang `views.py` at `models.py` ay parehong nasa kagayang directory. Ibig sabihin nito, maari tayong gumamit ng `.` at ang pangalan ng file (na walang `.py`). Pagkatapos i-import natin ang pangalan ng model na (`Post`).
+
+Pero ano ang kasunod? Para makuha ang tunay na blog post mula sa `Post` na model, kailangan natin ang tinatawag na `QuerySet`.
+
+## QuerySet
+
+Dapat kabisado mo na kung paano gumagana ang QuerySets. Napag-usapan na natin ang tungkol dito sa [Django ORM (QuerySets) na kabanata](../django_orm/README.md).
+
+Ngayon, gusto natin na ang nalathala na mga blog posts ay nasuri ayon sa pagkasunod-sunod ng `published_date`, tama ba? Nagawa na natin ito sa QuerySets na kabanata!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Ngayon ilagay natin ang pirasong code na ito sa loob ng `blog/views.py` na file sa pamamagitan ng pagdagdag nito sa function na `def post_list(request)`, pero huwag kalimutang idagdag muna ang `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+Ang pinakahuling kulang na parte ay ang pagpasa sa mga `post` na QuerySet sa konteksto ng template. Huwag mag-alala - madadaanan natin kung paano ipakita ito sa mamayang kabanata.
+
+Tandaan na naglikha tayo ng *variable* para sa ating QuerySet: `posts`. Isipin itong pangalan ng ating QuerySet. Simula ngayon, tatawagin natin ito sa pamamagitan ng pangalan na ito.
+
+Sa `render` na function mayroon tayong isang parameter na `request` (lahat ng natanggap natin mula sa user sa pamamagitan ng Internet) at isa pa na nagbigay ng template file (`'blog/post_list.html'`). Ang pinakahuling parameter, `{}`, ay lugar kung saan maari tayong magdagdag ng mga bagay para magamit ng ating template. Kailangan natin silang bigyan ng pangalan (sa ngayon `'posts'` pa rin ang gagamitin natin). :) Dapat itong maging kagaya nito: `{'posts': posts}`. Tandaan na ang parte bago ang `:` ay isang string; dapat itong nakabalot sa mga panipi: `"`.
+
+Sa wakas ang ating `blog/views.py` na file ay maging kagaya nito:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+Ayun na! Oras na para bumalik sa aming template at ipakita itong QuerySet!
+
+Gustong magbasa pa ng kakaunti tungkol sa QuerySets sa Django? Dapat kang tumingin dito: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/tl/extend_your_application/README.md b/tl/extend_your_application/README.md
new file mode 100644
index 00000000000..991d737fa4d
--- /dev/null
+++ b/tl/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Patagalin pa ang iyong application
+
+Nakumpleto na natin ang lahat ng iba't ibang hakbang na kinakailangan para sa paglikha ng ating website: alam na natin kung paano ang pagsulat ng isang model, url, view at template. Alam na rin natin kung paano pagandahin ang ating website.
+
+Oras na para mag-ensayo!
+
+Ang unang bagay na kailangan natin sa ating blog ay, malinaw naman na, isang page para ipakita ang isang post, hindi ba?
+
+Mayroon na tayong isang `Post` na modelo, kaya hindi na natin kailangang magdagdag ng kahit ano pa sa `models.py`.
+
+## Gumawa ng isang template sa detalye ng isang post
+
+Magsimula tayo sa pamamagitan ng pagdagdag ng link sa loob na `blog/templates/blog/post_list.html` na file. Dapat itong maging kagaya nito: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %} Gusto natin magkaroon ng lnk mula sa pamagat ng post sa ating listahan ng mga post papunta sa detalye na pahina ng post. Baguhin natin ang `<h1><a href="">{{ post.title }}</a></h1>` para maglink ito sa detail page ng post: {% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %} Oras na para ipaliwanag ang misteryosong `{% url 'post_detail' pk=post.pk %}`. Gaya ng suspetsa mo, ang `{% %}` na notasyon na ang ibig sabihin ay gumagamit tayo ng template tags ni Django. Sa oras na ito gagamit tayo ng isa pa na maglikha ng url para sa atin!{% endraw %}
+
+Ang `post_detail` na parte ay nangahulugang ang Django ay nag-antabay ng URL sa `blog/urls.py` na may pangalang=post_detail
+
+At paano na ang tungkol sa `pk=post.pk`? Ang `pk` ay ang pinaikling anyo ng primary key, na isang bugtong na pangalan para sa bawat rekord na nasa database. Dahil hindi natin gustong magtakda ng primary key sa ating `Post` na model, si Django ay gagawa para sa atin (ang default, ay isang numero na lumalaki ng isa sa bawat rekord, i.e. 1, 2, 3) at magdagdag nito isip field na may pangalang `pk` para sa bawat post natin. Ma-access natin ang primary key sa pamamagitan ng pagsulat ng `post.pk`, katulad ng pag-access natin sa ibang mga field na (`title`,`author`, etc.) sa ating `Post` na object!
+
+Ngayon, puntahan natin ang http://127.0.0.1:8000/ kung sa magkaroon tayo ng error (gaya ng iniasahan, dahil wala pa tayong URL o ang *view* para sa `post_detail`). Maging kagaya ito nito:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Maglikha ng URL para sa detalye ng post
+
+Maglikha tayo ng URL sa `urls.py` para sa ating `post_detail` na *view*!
+
+Gusto natin ang ating kaunaunahang detalye ng post na mapakita sa **URL** na ito: http://127.0.0.1:8000/post/1/
+
+Gagawa tayo ng URL sa loob ng `blog/urls.py` na file na magtuturo kay Django sa *view* na pinangalanang `post_detail`, na magpapakita sa buong blog post. Idagdag ang linyang `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` sa `blog/urls.py` na file. Ang file ay dapat maging katulad nito:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+Ang parteng ito `^post/(?P<pk>\d+)/$` ay mukhang nakakatakot, ngunit huwag mag-alala - ipapaliwanag namin yan sa iyo:
+
+- ito ay nagsisimula sa `^` uulitin ko - "ang simula".
+- Ang `post` ay nangangahulugang pagkatapos ng simula, ang URL ay dapat naglalaman ng salitang **post** at ang **/**. Sa ngayon, mabuti naman.
+- `(?P<pk>\d+)` – ang parteng ito ay mas mapandaya. Ibig sabihin ang Django ay kukunin ang lahat ng nilagay mo dito at ilipat ito sa view isip isang variable na tinatawag na `pk`. (Tandaan na ito ay tumugma sa pangalan na binigay natin sa primary key na variable sa ating `blog/templates/blog/post_list.html`!) Ang `\d` ay nagsasabi din sa atin na ito ay maaring numero lamang, hindi isang letra (lahat ng nasa pagitang ng 0 at 9). Ibig sabihin ng `+` ay kailangang merong isa or higit pa na mga numero doon. Kaya ang gaya ng `http://127.0.0.1:8000/post//` ay hindi tama, ngunit ang `http://127.0.0.1:8000/post/1//234567890/` ay tamang-tama!
+- `/` - pagkatapos kailangan natin ng **/** uli.
+- `$` - "ang wakas"!
+
+Ibig sabihin nito, kung maglagay ka ng `http://127.0.0.1:8000/post/5/` sa iyong browser, maiintindihan ni Django na ikaw ay naghahanap ng *view* na tinatawag na `post_detail` at maglipat ng impormasyon na ang `pk` ay katumbas ng `5` sa *view* na iyan.
+
+OK, nagdagdag na tayo ng bagong URL pattern sa `blog/urls.py`! I-refresh natin ang pahina: http:://127.0.0.1:8000. Yun! Ang server ay huminto na naman. Tingnan ang console - gaya ng inaasahan, may ibang error na naman!
+
+![AttributeError](images/attribute_error2.png)
+
+Naalala mo ba kung ano ang sunod na hakbang nito? Siyempre: ang pagdagdag ng view!
+
+## Magdagdag ng view para sa detalye ng post
+
+Sa oras na ito, ang *view* natin ay binigyan pa ng isa pang parameter, `pk`. Ang *view* natin ay dapat sasalo nito, di ba? Kaya ating i-define ang ating function isip `def post_detail(request, pk):`. Tandaan na kailangan nating gamitin ang parehong pangalan na nilagay natin sa mga url (`pk`). Ang pagtanggal sa variable na ito ay mali at magresulta sa isang error!
+
+Ngayon, gusto nating kumuha ng isa at isa lang na blog post. Para gawin ito, maari tayong gumamit ng mga queryset, gaya nito:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Ngunit ang code na ito ay may problema. Kung walang `Post` na may nakatugmang `primary key` (`pk`), magkakaroon ng tayo ng lubhang pangit na error!
+
+![DoesNotExist na error](images/does_not_exist2.png)
+
+Hindi natin gusto ito! Pero, siyempre, kasama ng Django ang isang bagay na mag-aayos nito para sa atin: `get_object_or_404`. Kung walang `Post` na tugma sa `pk`, magpapakita ito na mas magandang pahina, ang `Page Not Found 404` na pahina.
+
+![Hindi mahanap ang pahina](images/404_2.png)
+
+Ang magandang balita ay maari tayong maglikha ng ating sariling `Page not found` na pahina at gawing maganda ito ayon sa gusto mo. Pero hindi ito lubhang importante sa ngayon, kaya lalaktawan lang natin ito.
+
+Sige, oras na para magdagdag ng *view* sa ating <0>views.py</code> na file!
+
+Sa `blog/urls.py`, gumawa tayo ng URL na patakaran na pinangalanang `post_detail` na tumutukoy sa view na tinatawag na `views.post_detail`. Ibig sabihin na si Django ay umaasa na may view na function na tinatawag na `post_detail` sa loob ng `blog/views.py`.
+
+Dapat nating buksan ang `blog/views.py` at idagdag ang sumunod na mga code malapit sa ibang `from` na mga linya:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+At sa pinakadulo ng file, idadagdag natin ang ating *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Oo. Oras na para i-refresh ang pahina: http://127.0.0.1:8000/
+
+![View ng Post list](images/post_list2.png)
+
+Gumana ito! Pero ano ang mangyari kapag nagclick ka sa link sa pamagat ng blog post?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Naku! Ibang error na naman! Pero alam na natin kung paano ayusin ito, di ba? Kailangan nating magdagdag ng template!
+
+## Gumawa ng template para sa mga detalye ng post
+
+Gagawa tayo ng file sa `blog/templates/blog` na tinatawag na `post_detail.html`.
+
+Maging kagaya ito nito:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Sa makaisa pa, tayo ay nag-extend sa `base.html`. Sa loob ng `content` na block, gusto nating ipakita ang publish_date ng post (kung meron), pamagat at teksto. Pero dapat nating pag-usapan ang mga importanteng mga bagay, tama ba?
+
+{% raw %}`{% if ... %} ... {% endif %}` ay isang template tag na magagamit natin kung may gusto tayong tingnan. (Tandaan na ang `if ... else ..` mula sa **Introduksyon sa Python** na kabanata?) Sa senaryong ito, gusto nating tingnan kung ang `published_date` ng post ay mayroon laman.{% endraw %}
+
+Sige, maari nating i-refresh ang ating pahina at tingnan kung wala na ang `TemplateDoesNotExist`.
+
+![Pahina ng detalye ng post](images/post_detail2.png)
+
+Yay! Gumana ito!
+
+## Isa pang bagay: oras na para mag-deploy!
+
+Maganda na makita natin ang ating website na gumagana sa PythonAnywhere, tama ba? Subukan nating magdeploy ulit.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Pagkatapos sa [PythonAnywhere na Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Sa wakas, pumunta sa [Web tab](https://www.pythonanywhere.com/web_app_setup/) at pindutin ang **Reload**.
+
+At dyan na natapos! Maligayang bati :)
\ No newline at end of file
diff --git a/tl/how_the_internet_works/README.md b/tl/how_the_internet_works/README.md
new file mode 100644
index 00000000000..79446a9a876
--- /dev/null
+++ b/tl/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Paano gumagana ang Internet
+
+> Para sa mga nagbabasa sa bahay: sa kabanatang ito nakalakip ang [Paano Gumagana ang Internet](https://www.youtube.com/watch?v=oM9yAA09wdc) na video.
+> 
+> Ang kabanatang ito ay binigyang inspirasyon sa talumpati ni Jessica McKellar na "How the Internet works" (http://web.mit.edu/jesstess/www/).
+
+Sa tingin namin ay araw-araw kang gumagamit ng Internet. Pero alam mo ba kung ano talaga ang nangyari kapag nag-type ka na address gaya ng https://djangogirls.org sa iyong browser at pinindot ang `enter`?
+
+Ang unang dapat nating maintindihan na ang website ay isang grupo na mga file naka save sa isang hard disk. Gaya ng mga palabas, musika o mga larawan. Ngunit, may isang parte na pambihira sa mga website: naglalaman ito ng computer code na tinatawag na HTML.
+
+Kung hindi mo kabisado ang pagpoprogram, maaring mahirap intindihin ang HTML sa una, pero ang mga browser mo (gaya ng Chrome, Safari, Firefox, at iba pa) ay nagkagusto dito. Ang mga web browser ay ginawa para magbasa ng code, sumunod sa mga instruksyon, at magpresenta sa mga file na ito na bumuo sa iyong website, eksakto kung paano mo ito gusto.
+
+Sa bawat file, kailangan nating ilagay ang mga HTML files sa hard disk. Para sa Internet, gagamit tayo ng espesyal, malalakas na mga kompyuter na tinatawag na *servers*. Wala silang screen, mouse o keyboard, dahil ang pangunahin gamit lang nila ay magstore ng datos at magsilbi nito. Kaya sila tinawag na *servers* - dahil sila ay *tagasilbi* ng iyong mga datos.
+
+Sige, ngunit gusto mong malaman kung paano gumana ang Internet, di ba?
+
+Ginuhit namit ito para sa iyo! Mukha itong ganito:
+
+![Tambilang 1.1](images/internet_1.png)
+
+Ang gulo, di ba? Sa totoo lang, ito ay isang network ng mga nakakonektang mga makina (ang nabanggit na mga *servers*). Daan-dang libong mga makina! Marami, napakaraming kilometro na mga kable sa buong mundo! Maari mong bisitahin ang Submarine Cable Map na website (http://submarinecablemap.com) para makita mo kung gaano ito ka masalimuot ang net. Ito ang screenshot mula sa website:
+
+![Tambilang 1.2](images/internet_3.png)
+
+Kawili-wili ito, di ba? Pero maliwanag naman, na imposible na magkaroon ng wire sa bawat makina na nakakonekta sa Internet. Kaya, para maabot ang mga makina (halimbawa, ang makina kung saan naka-save ang https://djangogirls.org) kailangan nating magpasa ng request sa napakarami at iba-ibang mga makina.
+
+Maging kagaya ito ito:
+
+![Tambilang 1.3](images/internet_2.png)
+
+Isipin na kung magtatype ka ng https://djangogirls.org, ikaw ay nagpapadala ng sulat na nagsasabing: "Minamahal kong Django Girls, gusto kong makita ang djangogirls.org na website. Ipadala ito sa akin, please!"
+
+Ang iyong sulat ay napunta sa iyong pinakamalapit na post office. Pagkatapos ay napunta ito sa malapit ng kaunti sa pinapadalhan mo, tapos sa isa pa, at isa pa hanggang sa napadala na ito sa destinasyon. Ang tanging nag-iisang bagay lang, kung mag papadala ka ng maraming mga sulat (*data packets*) sa parehong lugar, maaring silang mapunta sa iba-ibang mga koreo (*routers*). Nakadepende ito kung paano sila naipamahagi sa bawat opisina.
+
+![Tambilang 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Sa halip na mga address na may mga pangalan ng daan, zip code, at pangalan ng bansa, gagamit tayo ng IP na mga address. Ang iyong komputer ay magtatanong muna sa DNS (Domain Name System) na isalin ang djangogirls.org sa IP address. Gumana ito gaya ng mga lumang mga phonebook kung saan maghahanap ka na pangalan ng tao na gusto mong ikontak at hanapin ang kanilang numero ng telepono at address.
+
+Kung magpapadala ka ng sulat, kailangan itong magkaroon nga mga tiyak na katangian para mapadala ito ng tama: ang address, ang selyo, at iba pa. Maari ka ring gumamit ng wika na maiintindihan ng tagatanggap, di ba? Pareho din sa *data packets* na pinadala mo para makita ang website. Gumamit tayo ng protocol na tinatawag ng HTTP (Hypertext Transfer Protocol).
+
+Kaya, kung mayroon kang website, kailangan mong magkaroon ng *server* (makina) kung saan ito nakatira. Kung ang *server* ay nakatanggap ng paparating na *request* (sa sulat), ipapadala nito pabalik ang iyong website (sa ibang sulat).
+
+Dahil ito ay isang Django na tutorial, maaring nakapagtanong ka kung ano ang ginagawa ni Django. Kung magpapadala ka ng sagot, hindi mo kinakailangan magpadala ng parehang mensahe sa lahat. Mas maganda kung ang mga sulat ay personalized, lalong lalo na sa tao na kakasulat lang sa iyo, di ba? Si Django ay tumutulong sa iyo para makalikha ng mga personalized at kawili-wili na mga sulat. :)
+
+Tapos na ang usapan - oras na para lumikha!
\ No newline at end of file
diff --git a/tl/html/README.md b/tl/html/README.md
new file mode 100644
index 00000000000..a17e9011fd2
--- /dev/null
+++ b/tl/html/README.md
@@ -0,0 +1,213 @@
+# Introduksyon sa HTML
+
+Ano ang template, maaring nakapagtanong ka?
+
+Ang template ay isang file na maari nating gamitin ulit para magpakita ng iba't ibang impormasyon sa isang matatag na format - halimbawa, maari kang gumamit ng template na makakatulong sa iyo sa pagsulat ng liham, dahil maaring bawat sulat ay maaring maglaman na iba't-ibang mensahe at naka-address sa ibang tao, sila ay mag-sishare ng parehong format.
+
+Ang format ng Django template ay inilarawan sa wika na tinatawag na HTML (ito ang HTML na nabanggit natin sa unang kabanata, **Paano gumagana ang Internet**).
+
+## Ano ang HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+Ang HTML ay kumakatawan sa "HyperText Markup Language". Ang **HyperText** na ibig sabihin ay tipo ng teksto na sumusuporta ng mga hyperlinks sa pagitan ng pahina. Ang **Markup** na ibig sabihin na kumukuha tayo ng dokumento at minarkahan ito ng code para magsabi (sa kasong ito, ang browser) kung paano isalin ang pahina. Ang HTML code ay nagawa gamit ang mga **tags**, bawat isa ay nagsisimula sa `<` at nagtatapos sa `>`. Ang mga tag na ito ay kumakatawan sa markup na mga **elemento**.
+
+## Ang iyong unang template!
+
+Ang paggawa ng isang template ay nangangahulugan ng paggawa ng isang template file. Lahat ay file, tama? Malamang ay napuna mo na ito.
+
+Ang mga templates ay naka-save sa `blog/templates/blog` na directory. Una, ay gumawa ng isang directory na tinatawag na `templates` sa loob ng iyong blog directory. Pagkatapos ay gumawa ng isa pang directory na tinatawag na `blog` sa loob ng iyong templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(Maaaring ngtataka ka kung bakit kailangan ng dalawang directories na parehong tinatawag na `blog` –sa iyong matutuklasan mamaya, ito ay isa lamang na kapaki-pakinabang na naming na kombensyon na magpapadali ng buhay kapag ang mga bagay ay maging mas kumplikado.)
+
+At ngayon, gumawa ng isang `post_list.html` na file (hayaan itong blangko sa ngayon) sa loob ng `blog/templates/blog` na directory.
+
+Tingnan kung ano ang hitsura ng iyong website ngayon: http://127.0.0.1:8000/
+
+> Kung mayroon ka pang error na `TemplateDoesNotExist`, subukan mong i-restart ang iyong server. Pumunta sa command line, ihinto ang server sa pamamagitan ng pag-press ng Ctrl+C (Kontrol at C na mga key, nang sabay) at i-start itong muli sa pamamagitan ng pgpapatakbo ng isang `python manage.py runserver` na command.
+
+![Tambilang 11.1](images/step1.png)
+
+Wala nang error! Binabati kita :) Subalit, ang iyong website ay walang pina-publish na kahit ano maliban sa isang page na walang laman, dahil ang iyong template ay wala ring laman. Kailangan natin itong ayusin.
+
+Idagdag ang sumusunod sa iyong template na file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Kumusta!</p>
+    <p>Ito ay gumagana!</p>
+</html>
+```
+
+Ano ang hitsura ng iyong website ngayon? Dalawin ito upang malaman: http://127.0.0.1:8000/
+
+![Tambilang 11.2](images/step3.png)
+
+Gumana siya! Magaling na gawa :)
+
+* Ang pinaka-basic na tag, `<html>`, ay palaging simula ng kahit anong web page at ang `</html>` ay palaging katapusan. Gaya ng iyong nakikita, ang kabuuang nilalaman ng website ay nasa pagitan ng pansimulang tag `<html>` at pangwakas na tag `</html>`
+* `<p>` ay isang tag pra sa mga elemento ng talata;`</p>` ngwawakas ng bawat talata
+
+## Ulo at katawan
+
+Ang bawat HTML page ay nahahati din sa dalawang elemento: **head** at **body**.
+
+* Ang **head** ay isang elemento na naglalaman ng impormasyon tungkol sa dokumento na hindi ipinapakita sa screen.
+
+* Ang **body** ay isang elemento na naglalaman ng lahat ng bagay na ipinapakita bilang parte ng web page.
+
+Ating ginagamit ang `<head>` upang sabihan ang browser tungkol sa kumpigurasyon ng page, at `<body>` upang sabihan ito kung ano talaga ang nasa page.
+
+Halimbawa, maaari mong ilagay ang web page title na elemento sa loob ng `<head>`, katulad nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Blog ni Ola</title>
+    </head>
+    <body>
+        <p>Kumusta!</p>
+        <p>Ito ay gumagana!</p>
+    </body>
+</html>
+```
+
+I-save ang file at i-refresh ang iyong page.
+
+![Tambilang 11.3](images/step4.png)
+
+Punain kung paano naintindihan ng browser na ang "Blog ni Ola" ay ang pamagat ng iyong page? Binigyan-kahulugan nito ang `<title>Ola'sblog</title>` at inilagay ang teksto sa title bar ng iyong browser (ito rin ay gagamitin para sa mga bookmark at iba pa).
+
+Marahil ay napansin mo rin na ang bawat isang opening tag ay itinugma sa *closing tag*, na may ``, at ang mga elemento ay *nested* (i.e. hindi mo maisasara ang partikular na tag hanggang ang lahat ng mga nasa loob nito ay naisara na rin).
+
+Ito ay kagaya ng paglalagay ng mga bagay sa mga kahon. Ikaw ay mayroong isang malaking kahon, `<html></html>`; sa loob nito ay mayroong `<body></body>`, at ito ay naglalaman ng mas maliit na mga kahon: `<p></p>`.
+
+Kinakailangan mong sundin ang mga panuntunan na ito ng *closing* ng mga tag, at ng *nesting* ng mga elemento - kung hindi mo ito gawin, ang browser ay maaaring hindi mabigyang-kahulugan ito ng maayos at ang iyong pahina ay maipapakita ng hindi tama.
+
+## I-customize ang template
+
+Maaari ka na ngayong magkaroon ng kaunting kasiyahan at subukang i-customize ang iyong template! Nandito ang ilang mga kapaki-pakinabang na mga tag para diyan:
+
+* `<h1>A heading</h1>` para sa iyong pinaka-importanteng heading
+* `<h2>A sub-heading</h2>` para sa isang heading sa susunod na antas
+* `<h3>A sub-sub-heading</h3>`… at iba pa, hanggang `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` binibigyang-diin ang iyong teksto
+* `<strong>text</strong>`mahigpit na binibigyang-diin ang iyong teksto
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` lumilikha ng isang link
+* `<ul><li> first item</li><li>second item</li></ul>` gumagawa ng isang listahan, kagaya ng isang ito!
+* `<div></div>` tumutukoy sa isang seksyon ng pahina
+
+Nandito ang isang halimbawa ng isang buong template, kopyahin at ilagay ito sa `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls na blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls na Blog</a></h1>
+        </div>
+
+        <div>
+            <p>Nailathala noong: 14.06.2014, 12:14</p>
+            <h2><a href="">Ang aking unang post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">Aking pangalawang post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+Gumawa tayo ng tatlong `div` na mga seksyon dito.
+
+* Ang unang `div` na elemento ay naglalaman sa pamagat ng ating blog - ito ay isang heading at isang link
+* Ang dalawa pang `div` na mga elemento ay naglalaman ng ating mga blogpost na mayroong petsa ng pag-publish, `h2` na mayroong isang pamagat ng post na maaaring i-click at dalawang `p`s (talata) ng teksto, isa para sa petsa at isa para sa ating blogpost.
+
+Ito ay nagbibigay sa atin ng effect na ito:
+
+![Tambilang 11.4](images/step6.png)
+
+Yaay! Ngunit sa ngayon, ang ating template ay nagpapakita lamang ng eksaktong **the same information** - samantalang kanina tayo ay nag-uusap tungkol sa mga template bilang nagpapahintulot sa ating magpakita ng **different** impormasyon sa **same format**.
+
+Ang gusto talaga nating gawin ay ang magpakita ng mga totoong post na naidagdag sa ating Django admin - at diyan ang sunod nating pupuntahan.
+
+## Isa pang bagay: mag-deploy!
+
+Makabubuting makita ang lahat ng ito at live sa Internet, hindi ba? Gumawa tayo ulit ng ibang PythonAnywhere deploy:
+
+### Mag-commit, at ipasa ang iyong code sa Github
+
+Una sa lahat, tingnan natin kung anong mga file ang nagbago mula noong huli tayong nag-deploy (patakbuhin ang mga command sa lugar na ito, hindi sa PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Siguraduhin na ikaw ay nasa `djangogirls` na directory at sabihan natin si `git` para isama ang lahat ng mga pagbabago sa loob ng directory na ito:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` ay nangangahulugan na `git` ay makakikilala kung nagbura ka ng mga file (bilang default, ito ay nakakikilala lamang ng mga bago/binagong file). Alalahanin rin na (simula sa kabanata 3) na `.` ay nangangahulugan na kasalukuyang directory.
+
+Bago natin i-upload ang lahat ng mga file, tingnan natin kung ano ang i-a-upload ni `git` (ang lahat ng mga file na i-a-upload ni `git` ay dapat nang lumitaw ngayon sa berde):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Malapit na tayo, oras na ngayon upang sabihan ito na i-save ang mga pagbabago sa kasaysayan nito. Bibigyan natin ito ng isang "commit message" kung saan natin ilalaraan kung ano ang ating mga binago. Maaari kang mag-type ng kahit na anong gusto mo sa yugtong ito, ngunit makatutulong mag-type ng isang bagay na naglalarawan upang maaalala mo ang iyong nagawa sa hinaharap.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Binago ang HTML para sa site na ito."
+    
+
+> **Note** Siguraduhin na gumamit ng dobleng quotes sa paligid ng commit message.
+
+Sa sandaling nagawa na natin iyan, i-a-upload natin (ipasa) ang ating mga pagbabago sa Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Hilahin ang iyong bagong code pababa sa PythonAnywhere, at i-reload ang iyong web app
+
+* Buksan ang [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) at pumunta sa iyong **Bash console** (o magsimula ng panibago). Pagkatapos ay patakbuhin ang:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+At pagmasdan ang iyong code na dina-download. Kung gusto mong i-check na ito ay nakarating na, maaari kang pumunta sa **File tab** at tingnan ang iyong code sa PythonAnywhere.
+
+* Sa wakas, pumunta sa [Web tab](https://www.pythonanywhere.com/web_app_setup/) at pindutin ang **Reload** sa iyong wep app.
+
+Ang iyong update ay dapat live! Magpatuloy at i-refresh ang iyong website sa browser. Ang mga pagbabago ay dapat makita. :)
\ No newline at end of file
diff --git a/tl/install_git.md b/tl/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/tl/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/tl/installation/README.md b/tl/installation/README.md
new file mode 100644
index 00000000000..186d2fae81a
--- /dev/null
+++ b/tl/installation/README.md
@@ -0,0 +1,58 @@
+# Kung ginagawa mo ang pagtuturo sa bahay
+
+Kung ginagawa mo ang pagtuturo sa bahay, hindi sa isa sa mga [Django Girls events](https://djangogirls.org/events/), maaari mong ganap na laktawan ang kabanatang ito ngayon at dumiretso sa [Paano gumana ang Internet](../how_the_internet_works/README.md) na kabanata.
+
+Ito ay dahil isinama na natin ang mga bagay na ito sa buong pagtuturo, at ito ay isang karagdagang pahina lamang na nagtitipon ng lahat ng mga direksyon sa pag-install sa isang lugar. Kabilang sa Django Girls na kaganapan ang isang "Gabi ng Pag-install" kung saan natin ini-install ang lahat para hindi na natin kailangang mag-abala pa dito sa oras ng workshop, kaya ito ay nakatutulong sa atin.
+
+If you find it useful, you can follow this chapter too. Ngunit kung gusto mo nang magsimulang mag-aral ng mga bagay-bagay bago mag-install ng mga bagay sa iyong computer, laktawan ang kabanatang ito at ipapaliwanag namin ang pag-i-install na parte sa iyo sa ibang pagkakataon.
+
+Good luck!
+
+# Instalasyon
+
+Sa workshop, ikaw ay gagawa ng isang blog, at mayroong mga ilang gawain sa pag-setup sa tutorial na makabubuti na trabahuin muna upang maging handa ka nang magsimula na mag-code sa araw.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# I-install ang Pyhthon
+
+{% include "/python_installation/instructions.md" %}
+
+# I-set up ang vitualenv at i-install ang Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Mag-install ng isang code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# I-install ang Git
+
+{% include "/deploy/install_git.md" %}
+
+# Gumawa ng isang GitHub na account
+
+Pumunta sa [GitHub.com](https://www.github.com) at mag-sign up para sa isang panibago, at libreng user account.
+
+# Gumawa ng isang PythonAnywhere na account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Magsimulang magbasa
+
+Maligayang bati, tapos ka na sa pag-setup at handa ka na! Kung may oras ka pa bago ang workshop, mas makabubuti kung magsimula ka nang magbasa ng iilan sa mga nauunang mga kabanata:
+
+* [Paano gumagana ang Internet](../how_the_internet_works/README.md)
+
+* [Introduksyon sa command line](../intro_to_command_line/README.md)
+
+* [Introduksyon sa Python](../python_introduction/README.md)
+
+* [Ano ang Django?](../django/README.md)
+
+# Sana magustuhan mo ang workshop!
+
+Kung magsimula ka na ng workshop, magagawa mong dumiretso sa [Unang Django na proyekto mo!](../django_start_project/README.md) dahil kalakip na ang materyal sa mga naunang kabanata.
\ No newline at end of file
diff --git a/tl/instructions.md b/tl/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/tl/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/tl/intro_to_command_line/README.md b/tl/intro_to_command_line/README.md
new file mode 100644
index 00000000000..e9c0d2cf1c5
--- /dev/null
+++ b/tl/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduksyon sa command-line na interface
+
+> Para sa mga magbabasa sa bahay: ang kabanatang ito ay kalakip sa [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) na video.
+
+Ito ay kapanapanabik, hindi ba?! Magsusulat ka ng pinakauna mong linya ng code sa loob lamang ng ilang minuto! :)
+
+**Ipapakilala ka namin sa iyong kauna-una at bagong kaibigan: ang command line!**
+
+The sumusunod na mga hakbang ay magpapakita sa iyo ng isang black na window na ginagamit ng lahat ng mga hacker. Maaring itong nakakatakot sa simula pero ito ay isang prompt lang na naghahantay ng mga utos galing sa iyon.
+
+> **Paalala** Tandaan na sa kabuuan ng aklat na ito gagamit tayo ng mga termino na minsan napagpalit, ang 'directory' at 'folder', ngunit sila ay iisa at pareho lang.
+
+## Ano ang command line?
+
+Ang window, na kadalasang tinatawag na **command line** o **command-line na interface**, ay isang text-based na aplikasyon para makita, makontrol, at mamanipula ang mga file sa iyong kompyuter. Kagaya lang ito ng Windows Explorer o Finder sa Mac, ngunit walang graphical na interface. Ang ibang pangalan ng command line ay: *cmd*, *CLI*, *prompt*, *console* o *terminal*.
+
+## Buksan ang command-line na interface
+
+Para makasimulang mag-eksperimento, kailangan muna nating buksan ang command-line na interface.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Pumunta sa Start menu → Windows System → Command Prompt.
+
+> Sa mga lumang bersyon ng Windows, hanapin sa Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Pumunta sa Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Siguro nasa loob ito ng Applications → Accessories → Terminal, ngunit nakadepende ito sa iyong sistem. Kung wala ito dito, i-Goggle lang ito. :)
+
+<!--endsec-->
+
+## Prompt
+
+Dapat makakita ka ng isang white o black na window na naghihintay isa iyong mga commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Kung ikaw ay nasa Mac o Linux, siguro nakakita ka ng `$`, gaya nito:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Sa windows, ito ay `>` na sign, gaya nito:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Bawat command ay nakaprepend nang sign na ito at isang space, ngunit hindi mo na kailangang itype ito. Ang kompyuter na ang gagawa nito para sa iyo. :)
+
+> Isang maliit na paalala: sa kaso mo maaring may makikita kang `C:\Users\ola>` o `Olas-Macbook-Air:~ ola$` bago ang prompt na sign, at ito 100% OK lang.
+
+Ang parte hanggang at kasali ang `$` o ang `>` ay tinatawag na *command line prompt*, o *prompt* kung pinaikli. Ito ay magprompt sa iyo na mag-input dito.
+
+Sa tutorial, kung gusto namin na magtype ka ng command, isasali na namin ang `$` o `>`, at minsan may nadagdag pa sa kaliwa. Maari mong ibalewala ang kaliwang parte at magtype lang ng command na nagsisimula pagkatapos ng prompt.
+
+## Ang una mong command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+At pindutin ang `enter`. Ito ang ating resulta:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+Gaya ng makikita mo, ang kompyuter ay nagprinta sa iyong bansag. Malinis, di ba? :)
+
+> Subukan mong magtype ng bawat command; huwag mag copy-paste. Mas matandaan mo ito sa ganitong paraan!
+
+## Mga Basic
+
+Bawat operating system ay may medyo iba-ibang set ng mga commands para sa command line, kaya siguradihing sumunod sa mga instruksyon para sa iyong operating system. Subukan natin ito, tara na?
+
+### Kasalukuyang directory
+
+Mas maganda kapag alam natin kung saan tayo, di ba? Tingnan natin. I-type ang command na ito at pindutin ang `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Paala: 'print working directory' ang kahulugan ng 'pwd'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Tandaan: ang 'cd' ay kumakatawan sa 'change directory'. Gamit ang powershell maaari kang gumamit ng pwd gaya ng sa Linux o Mac OS X.
+
+<!--endsec-->
+
+Maaring nakakita ka ng kagaya nito sa iyong makina. Kapag nabuksan mo na ang command line, kadalasang magsisimula ka iyong home directory ng user.
+
+* * *
+
+### Lista ng mga file at mga directory
+
+Ano ang dapat nasa loob ito. Maganda kung ating makita ito. Tingnan natin:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Tandaan: Sa powershell, maaari kang gumamit ng 'ls' gaya ng sa Linux at Mac OS X. <!--endsec-->
+
+* * *
+
+### Magpalit ng kasalukuyang directory
+
+Ngayon, puntahan nating ang ating Desktop na directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Tingnan kung nabago ba talaga ito:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Nandito na!
+
+> PRO tip: kung mag type ka ng `cd D` at magpindut ng `tab` sa iyong keyboard, ang command line ay awtomatikong maglagay ng buong pangalan para mabilis mo itong manavigate. Kung mayroong higit sa isang folder na nagsisimula sa "D", pindutin ang `tab` na key ng dalawang beses para makuha mo ang lista ng mga options.
+
+* * *
+
+### Maglikha ng directory
+
+Paano kaya kung maglikha ka ng practice directory sa iyong desktop? Maari mo itong gawin sa ganitong paraan:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+Ang maliit na command na ito ay maglikha ng folder na may pangalang `practice` sa iyong desktop. Maari mo itong tingnan sa pamamagitan ng pagpunta sa iyong Desktop o sa pamamagitan ng pagpapatakbo ng `ls` o `dir` na command! Subukan ninyo ito. :)
+
+> PRO tip: kung hindi mo gustong magtype ng parehong mga command ng paulit-ulit, subukang pindutin ang `up arrow` at `down arrow` sa iyong keyboard para maikot ang mga kakagamit lang na mga command.
+
+* * *
+
+### Mag-ehersisyo!
+
+May maliit na pagsusubok para sa iyo: sa iyong kakalikha na `practice` na directory, maglikha ng directory na tatawaging `test`. (Gamitin ang `cd` at `mkdir` na mga command.)
+
+#### Solusyon:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Maligayang bati! :)
+
+* * *
+
+### Maglinis
+
+Hindi natin gustong mag-iwan ng kalat, kaya burahin natin ang lahat ng nagawa natin hanggang sa puntong ito.
+
+Una, kailangan nating makabalik sa Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Gamit ang `..` kasabay ng `cd` na command ay magbabago sa iyong kasalukuyang directory sa magulang na directory (ito ay and directory na naglalaman ng iyong kasalukuyang directory).
+
+Suriin kung nasaan ka na:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Ngayon ay oras na para burahin ang `practice` na directory:
+
+> **Bigyang pansin>**: Ang pagbura ng file gamit ang `del`, `rmdir` o `rm` ay hindi na marecover ulit, ibig sabihin na *ang mga naburang file ay mawala na magpakailanman*! Dapat maging maingat sa command na ito.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Tapos na! Para masiguro na nabura talaga ito, tingnan natin ito:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+Iyan na sa ngayon. Maari mo nang isara ang command line ngayon. Gagawin natin ito sa hacker na paraan, okay ba? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, di ba? :)
+
+## Buod
+
+Ito ang buod ng iilang mga command:
+
+| Command (Windows) | Command (Mac OS / Linux) | Paglalarawan                       | Halimbawa                                         |
+| ----------------- | ------------------------ | ---------------------------------- | ------------------------------------------------- |
+| exit              | exit                     | isara ang window                   | **exit**                                          |
+| cd                | cd                       | baguhin ang directory              | **cd tesr**                                       |
+| cd                | pwd                      | ipakita ang kasalukuyang directory | **cd** (Windows) o **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | lista ng mga directory/files       | **dir**                                           |
+| kopya             | cp                       | kopyahin ang file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| ilipat            | mv                       | maglipat ng file                   | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | maglikha ng bagong directory       | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | burahin ang file                   | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | magbura ng directory               | **rm -r testdirectory**                           |
+
+Ang mga ito ay iilan lang sa mga command na maari mong mapatakbo sa iyong command line, ngunit hindi ka gagamit ng higit pa dito sa ngayon.
+
+Kung ikaw ay curious, ang [ss64.com](http://ss64.com) ay naglalaman ng kompletong lista ng mga command para sa lahat ng operating systems.
+
+## Handa ka na ba?
+
+Pumunta na tayo sa Python!
\ No newline at end of file
diff --git a/tl/python_installation/README.md b/tl/python_installation/README.md
new file mode 100644
index 00000000000..dbd4eaae720
--- /dev/null
+++ b/tl/python_installation/README.md
@@ -0,0 +1,15 @@
+# Simulan natin ang Pythin
+
+Nandito na tayo sa wakas!
+
+Pero una, sasabihin muna namin kung ano ang Python. Ang python ay isang popular na wika na ginagamit sa programming na maaring gamitin sa paglikha ng mga website, mga laro, mga scientific na mga sofware, graphics at marami pang iba.
+
+Ang python ay nagsimula sa katapusan ng 1980 at ang pangunahing layunin nito ay para madali itong mabasa ng mga tao (hindi lang sa mga makina!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Pag-install ng python
+
+> **Paalala** Kung ikaw ay gumagamit ng isang Chromebook, laktawan ang kabanatang ito at siguraduhin na masunod mo ang mga tagubilin sa [Chromebook Setup](../chromebook_setup/README.md).
+> 
+> **Paalala** Kung nagawa mo na ang mga mga hakbang sa pag-install, hindi na kailangan na gawin pa itong muli - maaari ka nang dumiretso sa susunod na kabanata!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/tl/python_installation/instructions.md b/tl/python_installation/instructions.md
new file mode 100644
index 00000000000..ceeff59126d
--- /dev/null
+++ b/tl/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> Para sa mga magbabasa sa bahay: ang kabanatang ito ay kalakip sa [Installing Python& Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) na video.
+> 
+> Ang bahaging ito ay naka-base sa isang tutorial ng Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Ang Django ay nakasulat sa Python. Kinakailangan natin ang Python upang gumawa ng kahit na ano sa Django. Magsimula tayo sa pag-install nito! Gusto namin na i-install mo ang Python 3.6, kaya kung mayroon kang mas naunang bersyon, kakailanganin mong i-upgrade ito.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Una, i-check kung ang iyong computer ay gumagamit ng isang 32-bit na bersyon o isang 64-bit na bersyon ng Windows, sa pamamagitan ng pagpindot ng Windows key + Pause/Break key na magbubukas sa impormasyon ng iyong System, at tingnan ang "System type" na linya. Maaari kang mag-download ng Python para sa Windows mula sa website na https://www.python.org/downloads/windows/. Pindutin ang "Latest Python 3 Release - Python x.x.x" na link. Kung ang iyong computer ay gumagamit ng isang **64-bit** na bersyon ng Windows, i-download ang **Windows x86-64 executable installer**. Kung hindi man, i-download ang **Windows x86 executable installer**. Pagkatapos i-download ang installer, dapat mo itong gamitin (i-double click ito) at sundin ang mga tagubilin doon.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Huwag kalimutan na idagdag ang Python sa Path](../python_installation/images/python-installation-options.png)
+
+Sa mga susunod na hakbang, ikaw ay gagamit ng Windows Command Line (na sasabihin namin sa iyo ang tungkol dito). Sa ngayon, kung kailangan mong mag-type ng ilang mga pag-uutos, pumunta sa Start menu → Windows System → Command Prompt. Maaari mo rin na panatilihing hawak ang Windows key at pindutin ang "R" -key hanggang ang "Run" na window ay lumabas. Upang buksan ang Command Line, i-type ang "cmd" at pindutin ang enter sa "Run" na window. (Sa bagong bersyon ng Windows, maaaring kailangan mong maghanap ng "Command Prompt" dahil minsan ito ay nakatago.)
+
+![Mag-type ng "cmd" sa "Run" na window](../python_installation/images/windows-plus-r.png)
+
+Paalala: Kung ikaw ay gumagamit ng lumang bersyon ng Windows (7, Vista, o kahit anung lumang bersyon) at ang Python 3.6.x na installer ay nag-fail na may error, maaring mong subukan ang kahit saan sa:
+
+1. mag-install ng lahat ng Windows Updates at subukang mag-install ng Python 3.6 ulit; o
+2. mag-install ng [lumang bersyon ng Pything](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+Kung ikaw ay nag-install ng lumang bersyon ng Python, ang installation screen ay maaring kakaiba ang screen mo kung ihambing sa ipinakita sa taas. Siguraduhing na scroll down mo para makita ang "Add python.exe to Path", pagkatapos i-click ang button sa kaliwa at piliin ang "Will be installed on local hard drive":
+
+![Magdagdag ng Python sa Path, mga lumang bersyon](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Paalala** Bago mag-install ng Python sa OS X, dapat siguraduhin mo na ang Mac settings ay nagpahintulot na mag-install ng mga packages na hindi galing sa App Store. Pumunta sa System Preferences (nasa loob ng Applications na folder), i-click ang "Security & Privacy," at pagkatapos ang "General" na tab. Kung ang iyong "Allow apps downloaded from:" ay naka-set sa "Mac App Store," baguhin ito sa "Mac App Store and identified developers."
+
+Kailangan pumunta ka sa website na https://www.python.org/downloads/release/python-361/ at mag-download ng installer ng Python:
+
+* Mag-download ng *Mac OS X 64-bit/32-bit installer* na file,
+* I-double click ang *python-3.6.1-macosx10.6.pkg* para mapatakbo ang installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Malamang na nainstall mo na ang Python out of of the box. Para masuri kung nainstall mo ito (at ano ang bersyon nito), buksan ang console at mag-type sa sumusunod na command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+Kung mayroon kang ibang 'micro version' ng Python na naka-install, e.g. 3.6.0, hindi mo na kailangang mag-upgrade. Kung wala kang Python na naka-install, o kung gusto mo ng ibang bersyon, maari mong i-install ito gamit ang sumusunod:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+I-type ang command na ito sa iyong console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Gamitin ang command na ito sa iyong console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Gamitin ang command na ito sa iyong console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Suriin kung ang pag-install ay matagumpay sa pamamagitan ng pagbukas ng command prompt at pagpapatakbo ng `python3` na command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**PAALALA:** Kung ikaw ay nasa Windows at nakakuha ka ng error message na ang `python3` ay hindi nakita, subukang gumamit ng `python` (na walang `3`) at suriin kung ito ba ay bersyon na Python 3.6.
+
+* * *
+
+Kung may mga bagay na hindi sigurado, o kung may problema at wala kang ideya kung ano ang sunod na gagawin, magtanong sa inyong coach! Minsan mahihirapan ka sa mga bagay-bagay at mas mabuting humingi ng tulong sa may karanasan dito.
\ No newline at end of file
diff --git a/tl/python_introduction/README.md b/tl/python_introduction/README.md
new file mode 100644
index 00000000000..95421511720
--- /dev/null
+++ b/tl/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduksyon sa Python
+
+> Parte ng kabanatang ito ay nakabase sa tutorial ng Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Magsulat tayong code!
+
+## Prompt ng python
+
+> Para sa mga nagbabasa sa bahay: ang parteng ito ay nalakip sa [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) na video.
+
+Para magsimulang maglaro ng Python, kailangan nating buksan ang *command line* ng iyong kompyuter. Dapat alam mo na kung paano gawin ito - natutunan na natin ito sa [Intro sa Command Line](../intro_to_command_line/README.md) na kabanata.
+
+Kapag handa ka na, sundin ang mga direksyon sa ibaba.
+
+Gusto nating buksan ang Python na console, kaya magtype ng `python` sa Windows o `python3` sa Mac OS/Linux at pindutin ang `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Ang una mong Python na pag-uutos!
+
+Pagkatapos patakbuhin ang Python na command, ang prompt ay mabago sa `>>>`. Para sa atin, ibig nitong sabihin na sa ngayon maari lang tayong gumamit ng mga command sa Python na wika. Hindi mo na kailangang mag-type sa `>>>` - gagawin na iyan ng Python para sa iyo.
+
+Kung gusto mong umalis sa Python na console sa kahit anung punto, magtype lang ng `exit()` para sa Windows at `Ctrl + D` para sa Mac/Linux. Kung gayon ay hindi mo na makikita pa ang `>>>`.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Ayos! Nakita mo paano lumabas ang sagot? Alam ng Python ang matematika! Maaari mong subukan ang mga pag-uutos kagaya ng:
+
+- `4 * 5`
+- `5 -1`
+- `40 / 2`
+
+Para magpagana ng exponential na mga kalkulasyon, sabihin nating 2 to the power 3, magtype tayo ng: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Magsaya muna dito ng mga ilang sandali at pagkatapos ay bumalik na dito. :)
+
+Gaya na nakikita mo, ang Python ay isang magandang calculator. Maaring nagtataka ka kung ano pa ang kayang gawin nito…
+
+## Mga String
+
+Paano na ang iyong pangalan? I type ang iyong unang pangalan sa loob ng panipi gaya nito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+Ngayon ay nalikha mo na ang iyong kauna-unahang string! Ito ay isang pagkasunod-sunod ng mga karakter na maaring iprosesa sa pamamagitan ng kompyuter. Ang string ay dapat parang nagsimula at nagtapos sa parehong karakter. Ito ay maaring isang single (`'`') o double (`"`) na mga quote (walang kaibahan!) Ang mga quote ay magsasabi kay Python na ang laman nito ay isang string,.
+
+Ang mga string ay maaring ikabit sa bawat isa. Subukan ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+Maari ka ring mag-multiply sa mga string gamit ang mga number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Kung kailangan mong maglagay ng kudlit sa loob ng iyong string, mayroon kang dalawang paraan para gawin ito.
+
+Gumamit ng double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+o sa pag-escape sa kudlit gamit ang backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Maganda, di ba? Para makita ang iyong pangalan sa malaki ang letra, itype ang:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Kakagamit mo lang ng `upper` na **method</0> sa iyong string! Ang method (gaya ng `upper()`) ay isang sequence ng mga instruksyon na kailangang patakbuhin ni Python sa isang object (`"Ola"` pagkatapos mong tawagin ito.</p> 
+
+Kung gusto mong malaman ang bilang ng mga letra na nilalaman ng iyong pangalan, may mga **function** para din dyan!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Nagtataka ka ba kung bakit minsan tinatawag mo ang functions gamit ang `.` sa katapusan ng isang string (tulad ng `"Ola".upper()`) at minsan una mong tatawagin ang isang function at ilalagay ang string sa mga panaklong? Sa ibang mga kaso, ang mga function ay napapabilang sa mga bagay, tulad ng `upper()`, na magagawa lamang sa mga strings. Sa kasong ito, tinatawag natin ang function na isang **method**. Sa ibang oras, ang mga function ay hindi napapabilang sa kahit na ano at magagamit sa iba't ibang uri ng mga objects, tulad ng `len()`. Ito ang dahilan kung bakit kami ay nagbibigay ng `"Ola"` bilang parameter sa `len` na function.
+
+### Buod
+
+Ok, tama nang mga strings. Sa ngayon iyong natutunan ang tungkol sa:
+
+- **the prompt** – ang pagta-type ng mga utos (code) patungo sa Python ay nagdudulot ng mga resulta ng mga kasagutan sa Python
+- **numbers and strings** –sa Python, ang mga numero ay ginagamit sa math at ang mga strings para sa text objects
+- **operators** – tulad ng `+` and `*`, pagsamahin ang mga value upang makagawa ng bago
+- **mga function** – tulad ng `upper()` at `len()`, ay nagsasagawa ng mga aksyon sa mga objects.
+
+Ito ang mga pangunahing kaalaman ng bawat wika ng programming na iyong matututunan. Handa ka na ba para sa mas mahirap? Sigurado kaming handa ka na!
+
+## Mga problema
+
+Sumubok tayo ng bago. Makukuha ba natin ang haba ng isang numero sa parehong paraan na makukuha natin ang haba ng ating pangalan? I-type ang `len(304023)` at pindutin ang `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Nakatanggap tayo ng una nating problema! Sinasabi nito na ang mga object na may uri na "int" (mga integer, mga buong numero) ay walang haba. So, anong magagawa natin ngayon? Siguro ay maaari nating isulat ang ating numero bilang isang string? Ang mga string ay may haba, tama?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Gumana ito! Ginamit natin ang `str` na function sa loob ng `len` na function. Ang `str()` ang nagko-convert ng lahat sa mga string.
+
+- Ang `str` na function ay nagko-convert ng mga bagay para maging **strings**
+- Ang `int` na function ay nagko-convert ng mga bagay para maging **integers**
+
+> Mahalaga: maari nating i-convert ang mga numero para maging teksto, ngunit hindi natin maaaring i-convert ang teksto para maging mga numero – magiging ano ang `int('hello')` kung gayon?
+
+## Mga variable
+
+Isang mahalagang konsepto sa programming ang mga variable. Ang variable ay walang iba kundi isang pangalan para sa isang bagay upang ito ay iyong magamit mamaya. Ginagamit ng mga programmer ang mga variable na ito upang mag-imbak ng data, gawing nababasa ang kanilang code at upang hindi na nila kailanganing alalahanin kung ano ang mga bagay.
+
+Sabihin natin na gusto nating gumawa ng isang bagong variable na tinatawag na `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+Tulad ng napansin mo, ang iyong program ay hindi naging kagaya ng dati. Kaya paano natin malalaman na ang variable ay talagang mayroon? I-enter lamang ang `name` at pindutin ang `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yehey! Ang iyong unang variable! :) Maaari mong baguhin kung anong tinutukoy nito:
+
+{% filename %}commad-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+Maaari mo rin itong gamitin sa mga function:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Ang galing, hindi ba? Syempre, ang mga variable ay maaaring maging kahit ano - mga numero rin! Subukan ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Pero paano kung ginamit natin ang maling pangalan? Mahuhulaan mo ba kung ano ang mangyayari? Subukan natin!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Isang pagkakamali! Kagaya ng nakikita mo, ang Python ay mayroong magkakaibang pagkakamali at itong isang ito ay tinatawag na isang **NameError**. Bibigyan ka ng Python ng pagkakamaling ito kung susubukan mong gumamit ng isang variable na hindi pa natutukoy. Kapag nakatagpo ka ng pagkakamaling ito sa susunod, suriin ang iyong code upang tingnan kung mayroon kang na mistype na kahit anong pangalan.
+
+Paglaruan ito ng ilang sandali at alamin kung ano ang makakaya mong gawin!
+
+## Ang print na function
+
+Subukan ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Habang kaka-type mo lang ng `pangalan`, ang Python Interpreter ay sumasagot gamit ang string na *representasyon* ng variable na 'name', kung saan ang mga letra M-a-r-i-a, ay napalibutan ng single quotes, ". Kung sasabihin mong `print(name)`, si Python ay mag-print ng nilalaman ng mga variable sa screen, na walang mga quotes, na mas malinis.
+
+Gaya ng makikita natin maya-maya, ang `print()` ay nakakatulong kung gusto nating iprint ang mga bagay-bagay mula sa loob ng mga function, o kung gusto nating i-print ang napakaraming mga linya.
+
+## Mga Lista
+
+Bukod sa mga string at mga integer, si Python ay mayroong iba't ibang tipo ng mga object. Ngayon, gusto naming ipakita sa iyo ang tinatawag nating **list**. Ang mga listahan ay eksaktong kung ano man ang sa tingin mo ang mga ito: ang mga bagay na mga listahan ng ibang mga bagay. :)
+
+Sige at gumawa ng isang listahan:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Oo, ang listahan na ito ay walang laman. Hindi kapaki-pakinabang, hindi ba? Gumawa tayo ng isang listahan ng mga numero sa lotto. Hindi natin gustong ulitin ang ating sarili sa lahat ng pagkakataon, kaya ilalagay din natin ito sa isang variable:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+Ang galing, mayroon na tayong isang listahan! Anong magagawa natin dito? Tingnan natin kung ilang mga numero sa lotto ang nasa listahan. Mayroon ka bang kahit anong ideya kung anong function ang gigimitin mo para diyan? Alam mo na ito!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Oo! Ang `len()` ay makapagbibigay sa iyo ng bilang ng mga bagay sa isang listahan. Madaling gamitin, hindi ba? Maaari na nating ayusin ito ngayon:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Hindi nito ibinabalik ang kahit na ano, binago lamang nito ang pagkakasunod-sunod ng paglabas ng mga numero sa listahan. I-print natin ulit ito at tingnan kung ano ang nangyari:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Kagaya ng nakikita mo, ang mga numero sa iyong listahan ay naka-ayos na simula sa pinaka-mababa hanggang pinaka-mataas na halaga. Congrats!
+
+Maaaring gusto nating baliktarin ang pagkakasunod-sunod? Gawin natin iyan!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reversed()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Kung gusto mong ipakita ang unang numero lamang, magagawa mo ito sa pamamagitan ng paggamit ng **indexes**. Ang index ay ang numero na nagsasabi kung saan sa listahan makikita ang isang bagay. Mas pinipili ng mga programmer ang magsimulang magbilang sa 0, upang ang unang bagay sa iyong listahan ay nasa index 0, ang sunod ay nasa 1, at iba pa. Subukan ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Gaya ng makikita mo, maaari kang mag-access ng iba-ibang objects sa iyong listahan sa pamamagitan ng paggamit sa pangalan ng listahan at nang index ng object na nasa loob ng square bracket.
+
+Para magbura mula sa iyong listahan, kailangan mong gumamit ng mga **indexes** gaya ng natutonan natin sa taas at ang `pop()` na method. Subukan natin ang isang halimbawa para madagdagan pa ang ating natutunan kanina: ibubura natin ang unang numero sa ating listahan.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Gumamo ito ng ganoon kadali lang!
+
+Para mas masaya, subukan ang ibang mga indexes: 6, 7, 1000, -1, -6 o -1000. Tingnan kung mahulaan mo ang resulta bago patakbuhin ang command. May kabuluhan ba ang mga resulta?
+
+Makakakita ka ng lista sa lahat ng list.na mga methods sa kabanatang ito ng dokumentasyon ng Python: https://docs.python.org/3/tutorial/datastructures.html
+
+## Mga Diksyunaryo
+
+> Para sa mga nagbabasa sa bahay: ang parteng ito ay nakalakip sa [Basics sa Python: Mga Diksyonaryo](https://www.youtube.com/watch?v=ZX1CVvZLE6c) na video.
+
+Ang diksyonaryo ay pareha lang sa lista, pero maari mong makuha ang halaga sa pamamagitan ng paghanap gamit ang key sa halip na ang numeric na index. Ang syntax para mag-define ng diksyonaryong walang laman ay:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Nagpapakita ito na kakalikha mo lang ng diksyonaryong walang laman. Hurray!
+
+Ngayon, subukang isulat ang sumunod na mga command (subukan ding magpalit na iyong sariling impormasyon):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+Gamit ang command na ito, nakalikha ka ng variable na pinangalanang `participant` na may tatlong key-value na pares:
+
+- Ang key na `name` ay nagtuturo sa value na `'Ola'` (na isang `string` na object),
+- ang `country` ay nagtuturo sa `'Poland'` (isa na namang `string`),
+- at ang `favorite_numbers` nagtuturo sa `[7, 42, 92]` (isang `lista` na may tatlong numero sa loob nito).
+
+Maarii mong suriin ang mga nilalaman ng bawat indibidwal na mga keys gamit ang syntax na ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Kita mo, pareho lang ito sa list. Ngunit hindi mo na kailangang alahanin ang index - ang pangalan lang.
+
+Ano ang mangyari kapag tatanungin natin si Python kung ano ang halaga ng isang key na hindi umiiral? Mahulaan mo ba? Subukan natin ito at tingnan!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Tingnan mo, isa na namang error! Ito ay isang **KeyError**. Si Python ay nakakatulong at nagsasabi na ang key na `'age'` ay hindi umiiral sa diksyonaryo.
+
+Kailan ka dapat gagamit ng diksyonaryo o lista? Isa itong magandang punto na dapat isipin. Gumawa ng solusyon sa isip mo bago tingnan ang sagot sa sunod na linya.
+
+- Kailangan mo ba ng nakahanay na pagkakasunod ng mga aytems? Gumamit ng list.
+- Kailangan mo bang i-ugnay ang mga value sa mga key, upang mahusay mong mahanap ang mga ito (sa pamamagitan ng key) sa ibang pagkakataon? Gumamit ng diksyunaryo.
+
+Ang mga diksyunaryo, tulad ng mga listahan, ay *mutable*, ibig sabihin maari silang mabago pagkatapos silang likhain. Maaari kang magdagdag ng bagong pares ng key-value sa isang diskyunaryo pagkatapos itong malikha, katulad nito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Katulad ng mga listahan, ang paggamit ng `len()` na method sa mga diksyunaryo ay nagbibigay ng numero ng pares ng key-value na nasa diksyunaryo. Magpatuloy at i-type ang command na ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Umaasa ako na ito ay may katuturan pa hanggang sa ngayon. :) Handa ka na ba para sa mas maraming saya gamit ang mga diksyunaryo? Patuloy na magbasa para sa mga kahanga-hangang mga bagay.
+
+Maaari mong gamitin ang `pop()` na method para burahin ang item sa diksyunaryo. Halimbawa, kung gusto mong burahin ang entry na tumutugma sa key `'favorite_numbers'`, i-type lamang ang sumusunod na command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Gaya ng makikita mo sa output, ang key-value pair na nagtutukoy sa 'favorite_numbers' na key ay binura na.
+
+At ito din, maari mong baguhin ang halaga na nakaugnay sa nalikha na na key sa diksyonaryo. I-type ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Gaya ng makikita mo, ang halaga ng key na `'country'` ay pinalitan ng >0>'Germany'</code> mula sa `'Poland'`. :) Nakaka-excite ba? Hurray! Natuto ka ng kahanga-hangang bagay.
+
+### Buod
+
+Ang galing! Marami ka nang nalalaman tungkol sa programming ngayon. Sa huling parte na ito natutunan mo ang tungkol sa:
+
+- **errors** - alam mo na paano magbasa at umintindi ng mga error na makikita kung si Python ay hindi nakaintindi sa command na binigay dito
+- **variables** - mga pangalan para sa object na makakatulong na madaling makagawa ng code at gawing madaling basahin ang iyong code
+- **lists** - mga lista ng mga object na nakahanay sa isang partikular na pagkakasunod
+- **dictionaries** - mga object na nakaimbak gamit ang key-value na mga pares
+
+Nasasabik ka na para sa sumunod na parte? :)
+
+## Ihambing ang mga bagay
+
+> Para sa mga nababasaha sa bahay: ang parteng ito ay nakalakip sa [Basics ng Python: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) na video.
+
+Ang malaking parte ng programming ay may kinalaman sa paghambing ng mga bagay. Ano ang pinakamadaling bagay na mahambing? Numero, siyempre. Tingnan natin kung paano ito gumagana:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+Binigyan natin si Python ng ilang numero para ihambing. Gaya ng makikita mo, hindi lang numero ang maaaring ihambing ni Python, ngunit pati na rin ang mga resulta ng mga method. Maganda, di ba?
+
+Nagtaka ka ba kung bakit naglagay tayo ng dalawang equal na sign `==` na magkasunod para maghambing kung magkumbas ba ang mga numero? Tayo ay gagamit ng `=` para mag-assign ng mga values sa mga variable. Dapat parati, **parating** kailangan mong maglagay ng dalawa - `==` - kung gusto mong suriin ko magkatumbas ba ang bawat isa. Maari din nating sabihin na ang dalawang bagay ay hindi magkatugma. Para dito, gagamit tayo ng symbol na `!=`, gaya ng pinapakita sa halimbawa.
+
+Bigyan si Python na dalawa pang mga gawain:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- ang ibig sabihin ng x `>` y ay: x ay mas malaki pa sa y
+- ang ibig sabihin ng x `<` y ay: si x ay maliit pa sa y
+- ang ibig sabihin ng x `<=` y ay: si x maliit pa o katumbas ni y
+- ang ibig sabihin ng x `>=` y ay: si x ay mas malaki pa o katumbas ni y
+
+Magaling! Gusto mong gumawa pa ng isa? Subukan ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Maarin mong bigyan si Python ng maraming numero na gusto mong ihambing, at ito ay magbibigay sa iyo ng sagot! Matalino, di ba?
+
+- **and** - kung gagamit ka ng `and` na operator, ang inihambing ay dapat kailangang True para maging True ang buong command
+- **or** - kung gagamit ka ng `or` operator, isa lang sa inihambing ang dapat True para maging True ang buong command
+
+Nakakarinig ka na ba ng ekspresyon na "comparing apples to oranges"? Subukan natin ang katumbas nito sa Python:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Dito makikita mo na gaya ng nasa ekspresyon, si Python ay hindi maaring maghambing ng numero (`int`) at isang string `str`). Sa halip, magpapakita ito ng **TypeError** at nagsasabi na ang magkaibang uri ay hindi maaaring ihambing.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+May dalawang Boolean na mga objects lang:
+
+- True
+- False
+
+Pero para maintindihan ito ni Python, kailangan mo itong isulat palagi isip 'True' (ang unang letra ay malaki ang titik, at ang iba pang mga letra ay nasa maliit na titik). **true, TRUE, and tRUE ay hindi gagana - ang True lang ang tama.** (Pareho din sa 'False', siyempre.)
+
+Ang mga Boolean ay maari ding gawing variable din! Tingnan ito:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Maari mo ding gawin ito sa ganitong paraan:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Magsanay at magkatuwaan sa mga Booleans sa pamamagitan ng pagpapatakbo sa mga sumunod na mga command:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Maligayang bati! Ang boolean ay isa sa mga pinakamagandang katangian sa programming, at natutunan mo na kung paano gamitin ito!
+
+# I-save ito!
+
+> Para sa mga nagbabasa sa bahay: ang parteng ito ay nakalakip na sa [Python Basics: Saving Files at "If" na mga statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) na video.
+
+Hanggang sa panahong ito sinulat natin lahat ng ating python na code sa interpreter, na naglimita sa atin na maglagay ng isang linyang code sa isang beses. Ang mga normal na mga programs ay naka-save sa mga file at pinapatakbo ng ating programming language na **interpreter** o **compiler**. Hanggang sa panahong ito, pinapatakbo natin ang ating mga program na paisa-isang linya sa Python na **interpreter**. Kakailanganin natin ng higit pa sa isang linya ng code para sa ating susunod na mga gagawin, kaya dapat madali natin itong gawin:
+
+- Lumabas sa Python na interpreter
+- Buksan ang iyong code editor na napili
+- Mag-save ng ilang code sa bagong python na file
+- Patakbuhin ito!
+
+Para lumabas mula sa interpreter ng Python na ginagamit natin, simpleng magtype lang ng `exit()` na function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Ito ay magbabalik sa iyo papunta sa command prompt.
+
+Kanina, pumili tayo ng code editor mula sa seksyon ng mga [code editor](../code_editor/README.md). Kailangan nating buksan ang editor ngayon at magsulat ng ilang code sa ating bagong file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Maliwanag na ikaw ay isang magaling na Python developer na ngayon, kaya huwag mag-atubiling magsulat ng ilang code gamit ang mga natutunan mo ngayon.
+
+Ngayon, kailangan nating i-save ang file at bigyan ito nang paglalarawan na pangalan. Tawagin natin ang file bilang **pythin_intro.py** at i-save ito sa iyong desktop. Maari natin itong pangalanan ng kahit na ano, ngunit ang importanteng parte lang dito ay dapat siguraduhin na ang file ay nagtatapos sa **.py**. Ang extension na **.py** ay nagsasabi sa ating operating system na ito ay isang **Python na executable file** at ang Python ay maaring magpatakbo nito.
+
+> **Paalala** Dapat mapansin mo ang pinakamagandang bagay tungkol sa mga code editor: ang mga kulay! Sa Python na console, ang lahat ay may parehong kulay; ngayon dapat makita mo na ang `print` na function ay magkaiba ang kulay sa string. Ito ay tinatawag na "syntax highlighting", ay ito ay sobrang nakakatulong na feature habang gumagawa ng code. Ang mga kulay ng bagay-bagay ay magbibigay sa iyo ng mga mungkahi, gaya ng hindi nasara na mga strings o may typo sa pangalan ng keyword (tulad ng `def` sa isang function, na makikita natin sa baba). Ito ang isa sa mga rason kung bakit tayo gumagamit ng code editor. :)
+
+Kung na-save na ang file, oras na para patakbuhin ito! Gamit ang mga abilidad na natutunan natin sa command line na seksyon, gumamit ng terminal para **baguhin ang mga directory** sa desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Sa Mac, ang command ay kaparehas nito:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Sa Linux, maging kagaya ito nito (ang salitang "Desktop" ay maaring nakasalin sa iyong lokal na wika):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+Sa Windows na Command Prompt, dapat ito ganito:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+At sa Windows na Powershell, dapat ito kagaya nito:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Kung ikaw ay hindi nakausad, humingi lang ng tulong.
+
+Ngayon, gumamit ng Python para magpatakbo ng code sa file gaya nito:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Paalala: sa Windows ang 'Python3' ay hindi kinilala na isang command. Sa halip, gumamit ng 'python' para patakbuhin ang file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Sige! Napatakbo mo ang una mong Python na program naka-save sa file? Maganda sa pakiramdam?
+
+Maari ka nang pumunta sa mga mahalagang kagamitan sa programming:
+
+## If … elif … else
+
+Maraming mga bagay sa code ang dapat mapatakbo kung ang mga kondisyon ay naabot. Ito ang dahilan kung bakit ang Python ay may tinatawag na **if statements**.
+
+Palitan ang code sa iyong **python_intro.py** na file nito:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Kung atin itong i-save at patakbuhin, makakakita tayo ng error gaya nito:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Umaasa si Python na magbibigay pa tayo ng karagdagan instruksyon sa kanya na papatakbuhin kung ang condition na `3 > 2` (o `True` para dito). Subukan natin na magprint si Python ng "It works!". Palitan ang code sa iyong **python_intro.py** na file nito:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Napansin mo kung paano natin iniindent ang sunod na linya ng code sa pamamagitan ng 4 na puwang? Kailangan nating gawin ito para malaman ni Python kung anong code ang papatakbuhin kung ang resulta ay true. Maari kang maglagay ng isang agwat, pero halos lahat ng mga programmer sa Python ay gumamit ng 4 para malinis itong tingnan. Ang single na `tab` ay bibilang din sa 4 na agwat.
+
+I-save ito at patakbuhin ito ulit:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Paalala: Tandaan na sa Windows, ang 'python3' ay hindi kilalang command. Mula sa ngayon, palitan natin ang 'python3' ng 'python' para ma-execute ang file.
+
+### Paano kung ang kondisyon ay hindi True?
+
+Sa huling mga halimbawa, ang code ay gumana lang kung ang kondisyon ay True. Ngunit si Python ay mayroon ding `elif` at `else` na mga statement:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+Kung ito ay papatakbuhin, mag-print out ito ng:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+at pinapatakbo:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+Kita mo kung ano ang nangyari dito? Ang `elif` ay binigyan ka ng karagdagang mga kondisyon na mapatakbo kung ang huling condition ay nakaligtaan.
+
+Maari kang magdagdag nang maraming `elif` na mga statement kahit na ano ang gusto mo pagkatapos ng iyong pangunang `if` na statement. Halimbawa:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Si Python ay titingnan ang bawat test ayon sa pagkakasunod at magprint ng:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Mahusay, naririnig ko ang lahat ng mga detalye
+    
+
+## Mga Komento
+
+Ang mga komento ay mga linyang nagsisimula sa `#`. Maaring kang magsulat ng kahit na anong gusto mo pagkatapos ng `#` at ibalewala ito ni Python. Ang mga komento ay kailangan para madaling maintindihan ng ibang tao ang iyong code.
+
+Tingnan natin kung paano ito:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Palitan ang volume kung ito ay masyadong maingay o masyadong mahina
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+Hindi mo kailangang magsulat ng komento sa bawat linya ng iyong code, ngunit nakakatulong sila para magpaliwanag kung ano ang ginagawa ng iyong code, o magbigay ng buod kung ito ay gumawa ng komplikadong mga bagay.
+
+### Buod
+
+Sa huling mga exercise natutunan mo ang tungkol sa:
+
+- **Paghambing ng mga bagay-bagay** - sa Python maari mong ihambing ang mga bagay-bagay gamit ang `>`, `>=`, `==`, `<=`, `<` at ang `and`, `or` na mga operators
+- **Boolean** - isang tipo ng object na maari lang magkaroon ng dalawang value: `True` o `False`
+- **Pag-save ng files** - ang pag-store ng code sa mga file para mapatakbo ang malaking mga program.
+- **if … elif … else** - mga statement na magbibigay sa atin ng kakayahan na magpatakbo ng code kung naabot ang iilang mga konsiyon lamang.
+- **mga comments** linya na hindi papatakbuhin ni Python na nagbibigay sa atin ng paraan na madokumento natin ang ating code
+
+Oras na para sa huling parte ng kabanatang ito!
+
+## Ang iyong sariling mga function!
+
+> Para sa mga nagbabasa sa bahay: ang parteng ito ay nakalakip sa [Basics sa Python: Mga Functions](https://www.youtube.com/watch?v=5owr-6suOl0) na video.
+
+Natandaan mo ba ang mga functions gaya ng `len()` na maari mong patakbuhin sa Python? Magandang balita - matutunan mo ngayon kung paano magsulat ng sariling mong mga function!
+
+Ang function ay isang sunod-sunod na mga instruksyon na dapat patakbuhin ni Python. Bawat function sa Python ay nagsisimula sa keyword na `def`, ay binagay na pangalan at maaring magkaroon ng ilang mga parameters. Let's give it a go. Palitan ang code sa **python_intro.py** ng sumusunod:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Sige, ang ating kauna-unahang function ay handa na!
+
+Maaring nagtaka ka kung bagit natin isinulat ang pangalan ng function sa baba ng file. Ito ay dahil ang Python ay nagbabasa lang ng mga file at nag-execute ito mula sa taas papuntang pababa. Kaya para magamit ang function, dapat mo itong isulat ulit sa baba.
+
+Patakbuhin natin ito ngayon at tingnan kung ano ang mangyari:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Paala: Kung ito ay hindi gumagana - huwag mag-alala! Ang output ay makakatulong sa iyo para malaman mo kung bakit:
+
+- Kung nakakuha ka ng `NameError`, siguro ang ibig sabihin nito ay may na-type kang mali, kaya dapat suriin mo kung gumagamit ka ba ng parehong pangaan habang naglikha ng function gamit ang `def hi();` at habang tinatawag ito gamit ang `hi()`.
+- Kung nakakuha ka ng `IndentationError`, tingnan kung ang dalawang `print` na mga linya ay mayroong whitespace sa simula ng linya: gusto ni python na maganda ang pagkalinya ng mga code sa loob ng function.
+- Kung wala talagang output, tingnan kung ang huling `hi()` *ay hindi* naka-indent - kung naka-indent, ang linyang iyan ay magiging parte din ng function, at hindi ito mapatakbo kahit kailan.
+
+Gawin natin ang ating unang function na may mga parameter. Gagamitin natin ang ating huling halimbawa - isang function na nagsasabi ng 'hi' sa taong nagpapatakbo nito - na may pangalan:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+Gaya ng makikita mo, binigyan natin ang ating function ng isang parameter na tinatawag na `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Tandaan: Ang `print` na function ay naka-indent ng apat na agwat sa loob ng `if` na statement. Ito ay dahil ang function ay tatakbo kung ang kondisyon ay tumugma. Tingnan natin kung paano ito gumana:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, may problema. Buti nalang nagbibigay si Python ng sobrang nakakatulong na error na mensahe. Nagsasabi ito sa atin na ang function na `hi()` (ang nilikha natin) ay may kinakailangan na argumento (tinatawag na `name`) at nalimutan natin itong ipasa habang tinatawag natin ang function. Aayusin natin ito sa baba ng file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+At patakbuhin ito ulit:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+At paano kung babaguhin natin ang pangalan?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+At patakbuhin ito:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Ngayon, ano ang naisip mong mangyari kung magsulat tayo ng ibang pangalan dyan? (Hindi Ola o Sonja.) Subukan mo ito at tingnan kong tama ka. Dapat magprint ito ng ganito:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+Ang galing nito, di ba? Sa ganitong paraan hindi mo kailangang ulit-ulitin ang iyong sarili sa bawat oras na gusto mong baguhin ang pangalan ng tao na dapat batiin ng function. At ito talaga ang dahilan kung bakit kailangan natin ng mga function - hindi natin gusto na ulitin ang iyong code!
+
+Gagawa pa tayo ng mas matalino pa - mayroong mas higit pa sa dalawang pangalan, at ang pagsulat ng kondisyon sa bawat isa ay mahirap, di ba?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Tawagin natin ang code ngayon:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Maligayang bati! Natutunan mo na kung paano magsulat ng mga functions! :)
+
+## Mga Loop
+
+> Para sa mga nagbabasa sa bahay: ang parteng ito ay nakalakip sa [Basics sa Python: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) na video.
+
+Ito na ang pinakahuling parte. Madaling lang, di ba? :)
+
+Hindi gusto ng mga programmer na ulitin ang kanilang mga sarili. Ang programming ay para ma-automate ang mga bagay-bagay, para hindi na natin babatiin ang bawat tao gamit ang kanilang pangalan nang mano-mano, di ba? Lubhang nakakatulong dito ang mga loops.
+
+Naalala mo pa ang mga lista? Gagawa tayo ng lista ng mga babae:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+Gusto nating batiin silang lahat gamit ang kanilang pangalan. Tayo ay mayroong `hi` na function para gawin yan, kaya gamitin natin ito sa isang loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+para sa pangalan ng mga babae:
+```
+
+Ang ```para``` ang pahayag ay kumikilos nang pareho sa ```kung``` pahayag; ang code sa baba ay parehong kailangan na i-indent nang apat na espasyo.
+
+Narito ang kabuuang code na nasa loob ng file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+At kapag pinatakbo natin ito:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Sunod na babae
+    Hi Monica!
+    Sunod na babae
+    Hi Phoebe!
+    Sunod na babae
+    Hi Ola!
+    Sunod na babae
+    Hi You!
+    Sunod na babae
+    
+
+Tulad ng nakikita mo, lahat ng inilagay mo sa loob ng isang `for` na pahayag na mayroong indent ay uulitin para sa bawat elemento ng listahan `girls`.
+
+Maaari mo ring gamitin ang `for` sa mga numero gamit ang `range` na function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+para sa i sa range na (1, 6):
+    print(i)
+```
+
+Na magpi-print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` ay isang function na gumagawa ng isang listahan ng mga numero na sumusunod sa isa pagkatapos ng isa (ang mga numerong ito ay binibigay mo bilang mga parameter).
+
+Tandaan na ang pangalawa sa mga numerong ito ay hindi kasama sa listahan na ini-output ng Python (nangangahulugan na ang `range(1, 6)` ay nagbibilang mula 1 hanggang 5, pero hindi kasama ang numerong 6). Ito ay dahil ang "range" ay kalahating nakabukas, at ibig sabihin nito ay kasama dito ang unang halaga, pero hindi ang huli.
+
+## Buod
+
+Iyan na yun.**You totally rock!** Ito ay isang nakakalitong kabanata, kaya dapat mong ipagmalaki ang iyong sarili. Ipinagmamalaki ka namin sa iyong narating!
+
+Maaaring gusto mong gumawa sandali ng ibang bagay - uminat, maglakad sa paligid ng kaonti, ipahinga ang iyong mga mata bago pumunta sa susunod na kabanata. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/tl/signup_pythonanywhere.md b/tl/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/tl/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/tl/template_extending/README.md b/tl/template_extending/README.md
new file mode 100644
index 00000000000..0a0d4da3979
--- /dev/null
+++ b/tl/template_extending/README.md
@@ -0,0 +1,147 @@
+# Pag-extend ng template
+
+Isa pang magandang bagay na mayroon ang Django para sa iyo ay **template extending**. Ano ang ibig sabihin nito? Ibig sabihin nito ay maaari mong gamitin ang parehong mga parte ng iyong HTML sa iba't ibang pahina ng iyong website.
+
+Ang mga template ay nakatutulong kapag gusto mong gamitin ang parehong impormasyon o layout sa higit sa isang lugar. Hindi mo na kinakailangan na ulitin ang iyong sarili sa bawat file. At kung gusto mong baguhin ang isang bagay, hindi mo na kinakailangan na gawin ito sa bawat template, sa isa lang!
+
+## Gumawa ng isang base template
+
+Ang isang base template ay ang pinaka basic na template na ginagamit mo sa bawat pahina ng iyong website.
+
+Gumawa tayo ng isang `base.html` na file sa `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Pagkatapos ay buksan ito at kopyahin lahat mula sa `post_list.html` sa `base.html` na file, kagaya nito:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Pagkatapos, sa `base.html`, palitan ang iyong kabuuang `<body>` (everything between `<body>` and `</body>`) nito:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}Maaaring napansin mo na pinalitan nito ang lahat ng mula sa `{% for post in posts %}` sa `{% endfor %}` ng: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Pero bakit? Ikaw ay nakagawa ng isang `block`! Ginamit mo ang template tag na `{% block %}` upang gumawa ng lugar na magkakaroon ng HTML na nakalakip dito. Ang HTML na ito ay manggagaling sa ibang template na ini-extend ang template na ito (`base.html`). Ipapakita namin sa iyo kung paano ito gawin maya-maya.
+
+Ngayon, i-save ang `base.html` at buksan ang `blog/templates/blog/post_list.html` ulit. {% raw %}Tatanggalin mo ang lahat ng nasa taas ng `{% for post in posts %}` at sa baba `{% endfor %}`. Kapag tapos ka na, ang file ay magiging kagaya nito: {% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+Gusto nating gagamitin ito isip parte ng ating template para sa lahat ng mga content block. Oras na para magdagdag ng block na tags sa file na ito!
+
+{% raw %}Gusto mo na ang iyong block tag ay magtugma sa tag ng iyong `base.html` na file. Gusto mo ring itong maglakip ng lahat ng code na pag-aari ng iyong content blocks. Para gawin ito, ilagay lahat sa pagitan ng `{% block content %}` at `{% endblock %}`. Gaya nito:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Isang bagay na lang ang natira. Kailangan nating ikonekta ang dalawang templates. Ito ang ibig sabihin ng pag-extend na mga templates! Gagawin natin ito sa pamamagitan ng pagdagdag ng extend na tag sa simula ng file. Gaya nito:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Iyan na! Tingnan ang iyong website kung gumagana pa rin ito. :)
+
+> Kung may nakuha kang error na `TemplateDoesNotExist`, ibig sabihin ay walang `blog/base.html` na file at ang `runserver` ay tumatakbo sa iyong console. Subukang ihinto ito (sa pamamagitan ng pag-pindut ng Ctrl+C - ang Control at ang C na mga key ng sabay) at i-start itong muli sa pamamagitan ng pagpapatakbo ng isang `python manage.py runserver` na pag-uutos.
\ No newline at end of file
diff --git a/tl/whats_next/README.md b/tl/whats_next/README.md
new file mode 100644
index 00000000000..658031e1768
--- /dev/null
+++ b/tl/whats_next/README.md
@@ -0,0 +1,25 @@
+# Ano ang susunod?
+
+Batiin ang sarili!**You're totally awesome**. Ipinagmamalaki ka namin! <3
+
+### Ano ang dapat gawin ngayon?
+
+Magpahinga at huminahon. Ikaw ay nakagawa pa lamang ng isang napakalaking bagay.
+
+Pagkatapos niyan, siguraduhin na sundan ang Django Girls sa [Facebook](http://facebook.com/djangogirls) o [Twitter](https://twitter.com/djangogirls) upang manatiling updated.
+
+### Maaari ka bang magrekomenda ng karagdagan na resources?
+
+Ayos! Una, sige at subukan ang aming ibang libro, na tinatawag na [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Sa ibang pagkakataon, maaari mong subukan ang mga resources na nakalista sa ibaba. Ang lahat ng ito ay napaka-rekomendado!
+
+- [Ang opisyal na tutorial ng Django](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [Mga tutorial ng Bagong Coder](http://newcoder.io/tutorials/)
+- [Kurso ng Code Academy Python](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS na kurso](https://www.codecademy.com/tracks/web)
+- [Tutorial ng Django Carrots](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way na libro](http://learnpythonthehardway.org/book/)
+- [Pagsisimula sa Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework na libro](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - maaari ka ring humiling ng isang libreng eBook na lisensya sa pamamagitan ng pakikipag-ugnayan sa may akda na si Tracy Osborn sa <tracy@limedaring.com>
\ No newline at end of file
diff --git a/tr-TR/GLOSSARY.md b/tr-TR/GLOSSARY.md
new file mode 100644
index 00000000000..1e503fa6881
--- /dev/null
+++ b/tr-TR/GLOSSARY.md
@@ -0,0 +1,3 @@
+# kod editörü
+
+Kod editörü, kodunuza sonradan geri dönebilmeniz için kodu kaydeden bir uygulamadır. Nereden edinebileceğinizi [Kod editörü bölümü](./code_editor/README.md)nde bulabilirsiniz
\ No newline at end of file
diff --git a/tr-TR/README.md b/tr-TR/README.md
new file mode 100644
index 00000000000..cf65763bb57
--- /dev/null
+++ b/tr-TR/README.md
@@ -0,0 +1,51 @@
+# Django Girls Eğitimi
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Bu eser Creative Commons Attribution-ShareAlike 4.0 International License ile lisanslıdır. Bu lisansın bir örneğini görmek için https://creativecommons.org/licenses/by-sa/4.0/ adresine gidebilirsiniz
+
+## Hoşgeldiniz
+
+Django Girls Eğitimi'ne hoşgeldin! Sizi burada gördüğümüz için mutluyuz. :) Bu eğitici yazıda, sizi web teknolojileri başlığı altında bir yolculuğa çıkaracağız ve web'in bildiğimiz şekilde çalışması için bir araya gelmesi gereken tüm bitlerin ve parçaların bir görüntüsünü sunacağız. 
+
+Tüm bilinmeyen şeylerde olduğu gibi, bu bir macera olacak - ama endişelenmeyin, burada olma cesaretini çoktan geçtiğiniz için, gayet iyi olacaksınız. :)
+
+## Giriş
+
+Hiç senin (henüz) yakın ilişki kuramadığın teknolojinin dünyayı giderek daha fazla kapladığını hissettiğin oldu mu? Hiç web sayfalarının nasıl yapıldığını merak edip başlamak için gereken motivasyona sahip olmadığınız oldu mu? Yazılım dünyasının sizin için, kendi başınıza bir şeyler yapmayı denemek için bile, çok karmaşık olduğunu düşündünüz mü?
+
+Öyleyse, sizin için iyi haberlerimiz var! Programlama göründüğü kadar zor değil ve size ne kadar keyifli olabileceğini göstermek istiyoruz.
+
+Bu eğitim sihirli bir şekilde sizi bir programcıya dönüştürmeyecek. Eğer bu konuda iyi olmak istiyorsanız, aylara ve hatta yıllara dayanan bir öğrenme ve pratiğe ihtiyacınız var. Fakat biz size programlamanın ya da websayfası oluşturmanın göründüğü kadar da karmaşık olmadığını göstermek istiyoruz. Farklı parçaları, değişik kısımları anlatabildiğimiz kadar iyi anlatmaya gayret edeceğiz ki artık teknoloji gözünüzü korkutmasın.
+
+Ümit ederiz ki sizin de teknolojiyi bizim kadar sevmenizi sağlayabiliriz!
+
+## Bu eğitim ile ne öğreneceksiniz?
+
+Eğitimi bitirdiğinizde, küçük bir çalışan web uygulamanız olacak: kendi blogunuz. Size çevrimiçi olarak nasıl yayınlandığını göstereceğiz, böylece başkaları çalışmanızı görecek!
+
+Aşağı yukarı şu şekilde gözükecek:
+
+![Şekil 0.1](images/application.png)
+
+> Eğer eğitimi kendi başınıza takip ediyorsanız ve bir problem yaşadığınızda size yardım edebilecek bir mentörünüz yoksa, size yardım edebileceğimiz bir sohbet sistemimiz var:[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Daha önce katılmış olan kişilerden ve eğitmenlerimizden zaman zaman chat odasında bulunmalarını ve eğitimi takip eden kişilere yardımcı olmalarını istedik! Chat odasında sorularınızı sormaktan çekinmeyin!
+
+Tamam, [hadi en baştan başlayalım...](./how_the_internet_works/README.md)
+
+## Eğitimi evden takip etmek
+
+Bir Django Girls atölyesine katılmak harika, ama katılmanın her zaman mümkün olmayabileceğinin farkındayız. Bu nedenle, bu eğitimi evde takip etmeyi denemenizi tavsiye ediyoruz. Evde okuyanlar için, şu anda eğitimi kendi başına izlemeyi kolaylaştıracak videolar hazırlıyoruz. Bu hala devam eden bir çalışma, ancak yakında [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) Youtube kanalında (İngilizce) giderek daha da fazla konu ele alınacak.
+
+Ele alınmış olan her bölümde, ilgili videoya ait bir bağlantı var.
+
+## Hakkında ve katkıda bulunma
+
+Bu eğitim [DjangoGirls](https://djangogirls.org/) tarafından sürdürülmektedir. Eğer hatalar bulursanız ve eğitimi güncellemek isterseniz lütfen [katkıda bulunma kılavuzunu takip edin](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Bu eğitimi diğer dillere çevirmemize yardımcı olmak ister misiniz?
+
+Şuan çeviriler crowdin.com platformunda tutuluyor:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Eğer diliniz [crowdin](https://crowdin.com/)'de listelenmemişse, lütfen [yeni bir konu aç](https://github.com/DjangoGirls/tutorial/issues/new) aracılığıyla bizi bilgilendirin ki dilinizi ekleyebilelim.
\ No newline at end of file
diff --git a/tr-TR/SUMMARY.md b/tr-TR/SUMMARY.md
new file mode 100644
index 00000000000..cee88afa072
--- /dev/null
+++ b/tr-TR/SUMMARY.md
@@ -0,0 +1,35 @@
+# Özet
+
+* [Giriş](README.md)
+* [Kurulum](installation/README.md) 
+  * [Komut Satırı](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Kod Editörü](installation/README.md#code-editor)
+  * [Sanal Ortam](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Kurulum (chromebook)](chromebook_setup/README.md)
+* [İnternet nasıl çalışır](how_the_internet_works/README.md)
+* [Komut satırına giriş](intro_to_command_line/README.md)
+* [Python kurulumu](python_installation/README.md)
+* [Kod editörü](code_editor/README.md)
+* [Python'a giriş](python_introduction/README.md)
+* [Django nedir?](django/README.md)
+* [Django kurulumu](django_installation/README.md)
+* [İlk Django projen!](django_start_project/README.md)
+* [Django modelleri](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Yayına alın!](deploy/README.md)
+* [Django URL'leri](django_urls/README.md)
+* [Django views - yaratma zamanı geldi!](django_views/README.md)
+* [HTML'ye giriş](html/README.md)
+* [Django ORM ve QuerySets (Sorgu Setleri)](django_orm/README.md)
+* [Template içinde dinamik veri](dynamic_data_in_templates/README.md)
+* [Django templateleri](django_templates/README.md)
+* [CSS - Güzelleştirin](css/README.md)
+* [Template genişletmek](template_extending/README.md)
+* [Uygulamanı genişlet](extend_your_application/README.md)
+* [Django Formları](django_forms/README.md)
+* [Sırada ne var?](whats_next/README.md)
\ No newline at end of file
diff --git a/tr-TR/chromebook_setup/README.md b/tr-TR/chromebook_setup/README.md
new file mode 100644
index 00000000000..8a03467f6db
--- /dev/null
+++ b/tr-TR/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook kurulumu
+
+> **Not** Eğer halihazırda [kurulum adımlarını](../installation/README.md), tamamladıysanız, bunu tekrar yapmanıza gerek yok - doğrudan [Python'a Giriş](../python_introduction/README.md) bölümüne atlayabilirsiniz.
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/tr-TR/chromebook_setup/instructions.md b/tr-TR/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..81c24aca342
--- /dev/null
+++ b/tr-TR/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Chromebook kullanmıyorsanız, [bu bölümü atlayabilirsiniz](http://tutorial.djangogirls.org/en/installation/#install-python). Chromebook kullanıyorsanız kurulum deneyiminiz biraz farklı olacaktır. Diğer yükleme yönergelerini göz ardı edebilirsiniz.
+
+### Bulut Tabanlı Geliştirme Ortamı (IDE) (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE, size İnternette yazılım yükleyebileceğiniz, yazabileceğiniz ve çalıştırabileceğiniz bir kod düzenleyicisi ve çalışan bir bilgisayara erişim sağlayan bir araçtır. Eğitim boyunca, Cloud IDE sizin *yerel makinanız* gibi davranacak. OS X, Ubuntu veya Windows'daki sınıf arkadaşlarınız gibi terminal arayüzünde komut çalıştırmaya devam edeceksiniz, ancak terminaliniz Cloud IDE'nin sizin yerinize kuracağı başka bir bilgisayara bağlanacaktır. Cloud IDE(PaizaCloud bulut IDE, AWS Cloud9)'ler için talimatlar burada. Cloud IDE'lerden birini seçin ve o IDE'nin talimatlarini takip edin.
+
+#### PaizaCloud Cloud IDE
+
+1. [PaizaCloud Cloud IDE](https://paiza.cloud/)'ye gidin
+2. Bir hesap oluşturun
+3. *New Server* a tıklayıp Django app i seçin
+4. Pencerenin sol tarafındaki Terminal butonuna tıklayalım
+
+Şimdi arayüzün sol tarafında bir takım buttonları görmeniz gerekiyor. "Terminal" buttonuna tıklayıp aşağıdaki komut satırını gösteren bir ekran açın:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+PaizaCloud Cloud IDE'nin terminali sizin komutlarınızı girmeniz icin hazırlanacak. Terminal penceresinin boyunu değiştirebilir ve en büyük boyuta getirebilirsiniz.
+
+#### AWS Cloud9
+
+Cloud 9 kullanmak için bir AWS üyeliğine sahip olmanız ve kredi kartı bilgilerinizi girmeniz gerekiyor.
+
+1. [Chrome Web Mağazası](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)'ndan Cloud 9 uygulamasını yükleyin
+2. [c9.io](https://c9.io) sayfasına gidin ve *AWS Cloud9'u kullanmaya başlayın* butonuna tıklayın
+3. Bir AWS hesabı açın (kredi kartı bilgilerinizi girmeniz gerekiyor, fakat ücretsiz kullanabilirsiniz)
+4. AWS in paneline gidip arama çubuğuna *Cloud9* girin ve tıklayın
+5. Cloud 9 panelinde *Create environment* a tıklayın
+6. *django-girls* ismini verin
+7. Ayarları (Settings) tanımlarken "Environment Type" için *Create a new instance for environment (EC2)* ve "Instance type" için *t2.micro* seçin ("Free-tier eligible." yazısı görünmeli). Halihazırdaki ayarları uygundur ve olduğu gibi bırakın.
+8. *Next step* e tıklayın
+9. *Create environment* a tıklayın
+
+Şimdi, bir yan panel, içinde bir takım yazıların olduğu büyük bir ana ekran ve altta aşağıdaki yazıya benzeyen küçük bir panel olan yeni bir arayüz görmelisiniz:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+Aşağıdaki bölge sizin terminalizdir. Bu terminali kullanarak Cloud 9 bigisayarına komut gönderebilirsiniz. Tercih ederseniz bu pencereyi büyütebilirsiniz.
+
+#### Glitch.com'un Bulut IDE'si
+
+1. [Glitch.com](https://glitch.com/) adresine gidin
+2. Kaydol (https://glitch.com/signup) yada GitHub hesabınla kaydol. (See GitHub instructions below.)
+3. Tıkla*Yeni Proje*seç*karşılama web sayfası*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Sanal ortam (Virtual environment)
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Bir [GitHub](https://github.com) hesabı oluşturun.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/tr-TR/code_editor/README.md b/tr-TR/code_editor/README.md
new file mode 100644
index 00000000000..1ae2f6254f1
--- /dev/null
+++ b/tr-TR/code_editor/README.md
@@ -0,0 +1,11 @@
+# Kod editörü
+
+> Evden takip edenler için: Bu bölüm [Pythonu kurma & Kod Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) videosunda işlenmiştir.
+
+İlk kod satırınızı yazmak üzeresiniz, bu yüzden önce bir kod editörü edinme zamanı!
+
+> **Not** Eğer Chromebook kullanıyorsanız, bu bölümü atlayın ve [Chromebook Kurulumu](../chromebook_setup/README.md)'ndaki talimatları takip ettiğinizden emin olun. Seçtiğiniz bulut IDE (PaizaCloud Bulut IDE veya AWS Cloud9) bir kod editörü içerir ve IDE'nizde dosya menüsünden bir dosyayı açtığınızda, otomatik olarak bu editörü kullanıyor olacaksınız.
+> 
+> **Not** Siz bunu daha önce [Kurulum bölümünde](../installation/README.md) yapmış olabilirsiniz – öyleyse, hemen bir sonraki bölüme atlayabilirsiniz! 
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/tr-TR/code_editor/instructions.md b/tr-TR/code_editor/instructions.md
new file mode 100644
index 00000000000..24cf7eb1a02
--- /dev/null
+++ b/tr-TR/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Birçok farklı kod editörü var, hangi editörü kullanacağınız kişisel tercihinize bağlı. Çoğu Python programcısı, PyCharm gibi karmaşık fakat son derece güçlü IDE'leri (Integrated Development Environments-Entegre Geliştirme Ortamları) kullanır. Başlangıç seviyesi için bunlar muhtemelen pek uygun olmayacaktır. Bizim önerdiklerimiz aynı derecede güçlü fakat çok daha basit editörler olacak.
+
+Bizim tavsiyelerimiz aşağıdakiler, ama mentörünüze tercihleri hakkında danışabilirsiniz, onlardan yardım almak bunu daha kolay olacaktır.
+
+## Visual Studio Code
+
+Visual Studio Code Microsoft tarafından Windows, Linux ve macOS işletim sistemleri için geliştirilmiş bir kod editörüdür. Özellikleri arasında hata ayıklama (debugging) desteği, gömülü Git yönetimi, kod renklendirme (syntax highlighting), zeki kod tamamlama (code completion), kod parçaları (snippets) yönetimi, ve kod düzenleme (refactoring) vardır.
+
+[Buradan indirin](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit açık kaynaklı, ücretsiz bir editördür. Tüm işletim sistemlerinde kullanılabilir.
+
+[Buradan indirin](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text, ücretsiz deneme süresi olan çok popüler bir editördür ve tüm işletim sistemleri için mevcuttur.
+
+[Buradan indirin](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom, başka bir popüler editör. Ücretsiz, açık kaynaklı ve Windows, OS X ve Linux için kullanılabilir. Atom [GitHub](https://github.com/) tarafından geliştirilmiştir.
+
+[Buradan indirin](https://atom.io/)
+
+## Neden bir kod editörü kuruyoruz?
+
+Neden Word ya da Notepad kullanmak yerine, özel bir kod editörü yazılımı kurduğumuzu merak ediyor olabilirsiniz.
+
+Birinci nedeni yazdığımız kodun **düz metin** olması gerektiği içindir ki Word ve Textedit gibi programlar aslında düz metin değil zengin metin üretirler (font ve biçim desteği içeren) ve [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format) gibi özel formatlar kullanılar.
+
+İkinci sebep ise kod editörlerinin kod düzenlemek için -örneğin kodu anlamına bağlı olarak renklendirme veya otomatik parantez kapatma desteği gibi- özelleşmiş olmasıdır.
+
+Bütün bunları birazdan deneyimleyeceğiz. Yakında emektar kod editörünüz en gözde araçlarınızdan birine dönüşecektir :)
\ No newline at end of file
diff --git a/tr-TR/css/README.md b/tr-TR/css/README.md
new file mode 100644
index 00000000000..1f861d6f9aa
--- /dev/null
+++ b/tr-TR/css/README.md
@@ -0,0 +1,330 @@
+# CSS - sayfanı güzelleştir!
+
+Blogumuz hala epey çirkin gözüküyor, değil mi? Güzelleştirme zamanı! Bunun için CSS kullanacağız.
+
+## CSS Nedir?
+
+Cascading Style Sheets (yani stil şablonu, kısaca CSS) bir işaretleme dili (örneğin HTML) ile yazılmış bir web sitesinin görünüm ve biçimini tanımlamakta kullanılan bir dildir. Bunu, web sayfamızın bir tür makyajı gibi düşünün ;)
+
+Fakat tekrar sıfırdan başlamak istemiyoruz, değil mi? Bir kez daha, programcıların internette ücretsiz sundukları bir şeyi kullanacağız. Bilirsiniz, tekerleği yeniden icat etmek pek eğlenceli değil.
+
+## Haydi Bootstrap kullanalım!
+
+Bootstrap güzel websiteleri geliştirmek için en yaygın olarak kullanılan HTML ve CSS tabanlı çözümlerden biridir: https://getbootstrap.com/
+
+Bootstrap Twitter yazılımcıları tarafından geliştirilmeye başlanmış. Şu anda dünyanın her yerinden gönüllüler tarafından geliştirilmektedir!
+
+## Bootstrap Kurulumu
+
+Bootstrap yüklemek için `.html` uzantılı dosyanızı kod düzenleyicisinde açın ve `<head>` bölümüne şunları ekleyin:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Bu satırlar projeye yeni dosya eklemez. Ancak İnternet'te var olan dosyalara işaret eder. Şimdi websitenizi açın ve sayfayı yenileyin. İşte oldu!
+
+![Şekil 14.1](images/bootstrap1.png)
+
+Şimdiden daha güzel görünüyor!
+
+## Django'da statik dosyalar
+
+Son olarak **statik dosyalar** dediğimiz şeylere daha yakından bakalım. Statik dosyalar, tüm CSS dosyaları ve resimlerindir. İçeriklerini istek içeriğine bağlı değildir ve her kullanıcı için aynıdır.
+
+### Django'da statik dosyaları nereye koymalı
+
+Django dahili "admin" uygulaması için statik dosyaları önceden nerede bulacağını biliyor. Şimdi kendi `blog` uygulamamız için bazı statik dosyalar eklememiz gerekiyor.
+
+Bunu blog uygulamamızın içine `static` isimli bir klasör oluşturarak yapacağız:
+
+    djangogirls 
+    ├── blog 
+    │ ├── migrations
+    │ ├── static
+    │ └── templates
+    └── mysite
+    
+
+Django otomatik olarak uygulama klasörlerinizin içindeki "static" adlı klasörleri bulur. Böylece bunların içeriklerini statik dosya olarak kullanabilir.
+
+## İlk CSS dosyanız!
+
+Şimdi web sayfana kendi stilini eklemen için bir CSS dosyası oluşturalım. `static` klasörü içinde `css` adlı yeni bir klasör oluştur. Şimdi de `css` klasörü içinde `blog.css` adlı yeni bir dosya oluştur. Hazır mısınız?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Şimdi CSS yazma zamanı! `blog/static/css/blog.css` dosyasını kod editöründe açın.
+
+Burada CSS'yi özelleştirme ve öğrenmeyle ilgili çok derinlemesine gidemeyeceğiz. Daha fazla bilgi edinmek isterseniz, bu sayfanın sonunda ücretsiz CSS kursu için bir tavsiye var.
+
+Ama, en azından biraz yapalım. Acaba başlık renklerimizi mi değiştirsek? Bilgisayarlar renkleri anlamak için özel kodlar kullanır. Bu kodlar `#` ile başlar ve 6 harf(A-F) ve sayıyla(0-9) devam eder. Örneğin, mavinin renk kodu `#0000FF` dur. Birçok renk için renk kodlarını buradan bulabilirsiniz: http://www.colorpicker.com/. Ayrıca [tanımlı renkler](http://www.w3schools.com/colors/colors_names.asp)i de kullanabilirsiniz, `red` (kırmızı) ve `green` (yeşil) gibi.
+
+`blog/static/css/blog.css` dosyanıza şu kodu eklemelisiniz:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` bir CSS seçicisidir (selector). Bu bizim stillerimizi `h1` öğesi içindeki herhangi bir `a` öğesine uyguladığınız anlamına gelir; `h2 a` seçicisi `h2` öğeleri için aynı şeyi yapar. Yani `<h1><a href="">bağlantı</a></h1>` gibi bir öğemiz olduğunda, ona `h1 a` stilimiz uygulanıyor. Böylelikle, o öğeye rengini`#Fca205` yani koyu turuncu olarak değiştirmesini söylüyoruz. Ya da burada kendi renginizi koyabilirsiniz ama beyaz arka plan ile iyi bir kontrastı olmasına dikkat edin!
+
+Bir CSS dosyasında, HTML dosyasındaki öğeler için stil belirleriz. Öğeleri tanımlamanın ilk yolu öğe adıdır. Bunları HTML bölümünden etiketler olarak hatırlıyor olabilirsiniz. Bunların hepsi öğe adına örnektir: `a`, `h1` ve `body`. Öğeleri aynı zamanda `class` ve `id` öznitelikleri ile tanımlarız. Sınıf ve id (kimlik), bir öğeye senin tarafından verilen isimlerdir. Sınıflar bir öğe grubunu tanımlar, id'ler ise belirli bir öğeye işaret ederler. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+CSS hakkında daha fazla bilgi edinmek için [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp) u okuyabilirsin.
+
+HTML şablonumuza (template) da birtakım CSS eklemeleri yaptığımızı bildirmemiz gerekiyor. `blog/templates/blog/post_list.html` dosyasını kod editöründe açıp en başına şu satırı ekleyin:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+Burada sadece statik dosyalar ekliyoruz :) `<head>` ve `</head>` etiketleri arasına, bootstrap CSS dosyalarından sonra, şu satırı ekleyin:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Tarayıcı, dosyaları verilen sırada okuyor. O yüzden doğru yerde olduğundan emin olmalıyız. Aksi takdirde Bootstrap dosyalar bizim kodumuzun üzerine yazabilir. Az evvel şablonumuza (template) CSS dosyamızın sadece nerede olduğunu söyledik.
+
+Şimdi dosyanız şöyle görünmeli:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>yayınlandı: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Tamam, dosyayı kaydedip sayfayı yenileyin!
+
+![Şekil 14.2](images/color2.png)
+
+Güzel bir iş çıkardınız! Şimdi de sitemizi biraz rahatlatıp sol kenar boşluğunu arttırsak mı? Hadi deneyelim!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Bunu CSS dosyana ekleyip kaydet ve bak bakalım nasıl çalışıyor!
+
+![Şekil 14.3](images/margin2.png)
+
+Belki de başlığımızın yazı tipini özelleştirebiliriz? Aşağıdaki satırı `blog/templates/blog/post_list.html` dosyasının içinde `<head>` bölümüne yapıştırın:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Daha önce yaptığımız gibi, sıralamayı ve yerini kontrol edelim `blog/static/css/blog.css` den önce olmalı. Bu satır Google Fonts'tan *Lobster* adlı bir font yükler (https://www.google.com/fonts).
+
+`blog/static/css/blog.css` CSS dosyasında `h1 a` tanımlama bölümünü bulalım ( `{` ve `}` sembolleri arasındaki kod). `font-family: 'Lobster';` satırını parantezler arasına kopyalayıp sayfayı yenileyin:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Şekil 14.3](images/font.png)
+
+Harika!
+
+Yukarıda bahsettiğimiz üzere, CSS'te sınıf (class) diye bir kavram var. Sınıflar, HTML kodunuzun bir kısmına isim vermenize yarar ve diğer kısımların stilini değiştirmeden yalnızca o kısmın stilini değiştirmenizi sağlar. Bu çok yararlı olabilir! Çok farklı şeyler yapan iki div'iniz var diyelim (örneğin biri başlık diğeri gönderinin metni). Sınıf farklı görünmelerini sağlamana yardımcı olur.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>yayınlandı: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+Şimdi farklı seçicilere (selectors) bildirim (deklarasyon) blokları ekleyeceğiz. `.` ile başlayan seçiciler sınıflara işaret eder. Web'de, aşağıdaki kodu anlamanıza yardımcı olacak pek güzel CSS öğreticileri ve açıklamaları mevcut. Şimdilik sadece bu kodu kopyalayıp `blog/static/css/blog.css` dosyamıza yapıştıralım:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Sonra, blog gönderilerini gösteren HTML kodunu, sınıf bildirimleri içine alın. Şu kısmı değiştirin:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>yayınlandı: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+`blog/templates/blog/post_list.html` i bununla değiştirelim:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Bu dosyaları kaydedin ve web sayfanızı yenileyin.
+
+![Şekil 14.4](images/final.png)
+
+Yaşasın! Harika görünüyor değil mi? Şimdi yapıştırdığımız koda bakıp CSS tarafından kullanılan sınıf eklediğimiz HTML bölümlerini bulalım. Tarihi turkuaz rengine çevirmek için nereyi değiştirirdiniz?
+
+CSS ile biraz oynamaktan çekinme ve birkaç şeyi değiştirmeye calış. CSS ile oynamak neyin neyi etkilediğini anlamak için çok faydalı. Bir şey bozarsanız, merak etmeyin- her zaman geri alabilirsiniz!
+
+Kesinlikle [freeCodeCamp](https://learn.freecodecamp.org/) adresindeki ücretsiz 'Temel HTML& HTML5" ve "Temel CSS" derslerini almanızı öneriyoruz. Bu dersler websitelerinizi HTML ve CSS ile daha güzel yapmayı öğrenmenize yardım edebilir.
+
+Sonraki bölüm için hazır mısınız?! :)
\ No newline at end of file
diff --git a/tr-TR/deploy/README.md b/tr-TR/deploy/README.md
new file mode 100644
index 00000000000..a0258c21a9f
--- /dev/null
+++ b/tr-TR/deploy/README.md
@@ -0,0 +1,247 @@
+# Yayına alın!
+
+> **Not** Bir sonraki bölüm ara ara zor gelebilir. Dayanın ve bölümü bitirin; yayına alma, website geliştirme sürecinin önemli bir parçasıdır. Biraz daha uğraştırıcı olan websitesini canlıya alma işine eğitmeninizin yardım edebilmesi için bu bölümü tutorial'ın ortasına yerleştirdik. Böylece eğer zaman yetmezse tutorial'ı kendi başınıza bitirebilirsiniz.
+
+Şimdiye kadar web sitenize sadece kendi bilgisayarınızdan girilebiliyordu. Şimdi onu nasıl canlıya alacağınızı öğreneceksiniz! Yayına alma uygulamanızı internette yayınlama sürecidir, böylelikle insanlar sonunda gidip uygulamanızı görebilirler. :)
+
+Öğrendiğimiz üzere, bir websitesi bir sunucunun üstünde olmalıdır. İnternette birçok sunucu sağlayıcısı var, biz bunlardan [PythonAnywhere](https://www.pythonanywhere.com/) i kullanacağız. PythonAnywhere ücretsiz olduğu ve çok fazla ziyaretçisi olmayan küçük uygulamalar için uygun olduğu için kesinlikle yeterli olacaktır.
+
+Dışarıdan kullanacağımız diğer servis bir kod barındırma hizmeti olan [Github](https://www.github.com). Başkaları da var, ama neredeyse her programcının bir Github hesabı var, sizin de olacak!
+
+Bu üç yer sizin için önemli olacak. Lokal bilgisayarınız geliştirme ve test yaptığınız yer olacak. Değişikliklerden memnun olduğunuzda programınızın bir kopyasını Github'a koyacaksınız. Web siteniz PythonAnywhere üzerinde olacak ve onu kodunuzun bir kopyasını Github'dan alarak güncelleyeceksiniz.
+
+# Git
+
+> **Not** Eğer [kurulum adımlarını](../installation/README.md) gerçekleştirdiyseniz, bunu tekrar yapmaya gerek yoktur - bir sonraki bölüme geçebilir ve Git deponuzu oluşturmaya başlayabilirsiniz.
+
+{% include "/deploy/install_git.md" %}
+
+## Git repomuzu oluşturalım
+
+Git, bir kod deposu (repository veya kısaca "repo") olarak adlandırılan belirli dosyalardaki değişiklikleri izler. Projemiz için bir tane oluşturalım. Konsolunuzu açın ve `djangogirls` klasöründe aşağıdaki komutları çalıştırın:
+
+> **Not** Reponuzu oluşturmadan önce `pwd` (Mac OS X/Linux) ya da `cd` (Windows) komutu ile şu an çalışmakta olan dizininizi kontrol edin. `djangogirls` dizininde olmanız gerekiyor.
+
+{% filename %}komut-satırı{% endfilename %}
+
+    Hatırlatma: Kullanıcı adı seçerken Türkçe karakter kullanmayın.
+    $ git init 
+    Initialized empty Git repository in ~/djangogirls/.git/ 
+    $ git config --global user.name "Adınız" 
+    $ git config --global user.email you@example.com
+    
+
+Git reposunu başlatmak proje başına sadece bir kere yapmamız gereken bir şeydir (ve kullanıcı adınız ve mailinizi tekrar girmeniz gerekmeyecek).
+
+Git bu dizindeki tüm dizin ve dosyalardaki değişiklikleri kaydedecek, ama takip etmemesini istediğimiz bazı dosyalar var. Bunu dizinin dibinde `.gitignore` adında bir dosya oluşturarak yapıyoruz. Editörünüzü açın ve aşağıdaki içeriklerle yeni bir dosya yaratın:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Veritabanı
+    db.sqlite3
+    
+    # Proje ana dizininde statik klasör
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+Ve onu `.gitignore` ismi ile "djangogirls" dizinine kaydedin.
+
+> **Not** Dosya adının başındaki nokta önemli! Eğer dosyayı oluştururken zorluk yaşarsanız (örneğin Mac'ler Finder'dan nokta ile başlayan bir dosya oluşturmanızdan hoşlanmazlar), editörünüzdeki "Farklı Kaydet" özelliğini kullanın böylece çalışacaktır. Dosya adına `.txt`,`.py` veya başka dosya uzantılarını eklemediğinizden emin olun-- Git sadece `.gitignore` uzantılı dosyaları tanıyacaktır. Linux ve MacOS `.` ile başlayan dosya isimlerimi saklar (örn. `.gitignore`) ve normal `ls` komutu bu dosyaları göztermez. `.gitignore` dosyasını görmek için `ls -a` komutunu kullanın.
+> 
+> **Not** `.gittignore` dosyasında belirttiğiniz dosyalardan biri `db.sqlite3` dosyası. Bu yerel veritabanı, tüm kullanıcılar ve mesajların saklandığı dosyadır. Standart web programlama uygulamasını izleyerek, yerel test siteniz ve PythonAnywhere'deki canlı web siteniz için ayrı veritabanları kullanacağız. Bu veritabanı geliştirme makinenizdeki gibi SQLite olabilir ama genelde sitenizdeki çok daha fazla ziyaretçiyi kaldırabilecek MySQL adı verilen bir veritabanı kullanacaksınız. Her iki durumda da, GitHub kopyası için SQLite veritabanınızı yok saymanız, şu ana kadar oluşturduğunuz tüm gönderilerin lokalinizde kalması ve yalnızca lokal olarak kullanılabilmeniz anlamına geliyor. Canlıda onlara ulaşabilmeniz için yeniden eklemek zorundasınız. Lokal veritabanınızı farklı şeyleri test edebileceğiniz ve blogunuzdaki gerçek gönderilerinizi silmekten korkmayacağınız iyi bir oyun alanı olarak düşünmelisiniz.
+
+`git add` kullanmadan önce veya nelerin değiştiğinden emin değilseniz, `git status` komutunu kullanmakta yarar var. Bu, yanlış dosyaların eklenmesi ve gönderilmesi gibi istenmeyen sürprizlerin engelenmesine yardımcı olacak. `git status` komutu, takip edilmeyen/değişen/gönderilecek dosyalar (staged), dal durumu (branch status) gibi bilgiler verir. Çıktıda aşağıdakine benzer olmalıdır:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Ve son olarak değişikliklerimizi kaydediyoruz. Komut satırına gidin ve aşağıdaki komutları çalıştırın:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Kodunu GitHub'a yollama (Push)
+
+[GitHub.com](https://www.github.com)'a gidin ve ücretsiz yeni bir kullanıcı hesabı oluşturun. (Eğer atölye hazırlıklarında bunu zaten yaptıysanız, bu harika!) Parolanızı hatırladığınızdan emin olun (eğer kullanıyorsanız, parolanızı yöneticinize ekleyin).
+
+Sıra depomuzu oluşturmaya geldi. 'New Repository' tuşuna tıklayıp "my-first-blog" adında bir Github deposu oluşturalım. "initialize with a README" ve ".gitignore" kutularının seçili olmadığından emin olalım (zaten .gitignore dosyamızı kendimiz oluşturmuştuk). Son olarak License seçeneğinde 'None' ı seçelim.
+
+![](images/new_github_repo.png)
+
+> **Not** `my-first-blog` ismi önemli -- başka bir şey de seçebilirsiniz, ama aşağıdaki yönergelerde çok geçiyor, her seferinde değiştirmeniz gerekir. En kolayı `my-first-blog` ismi ile devam etmek.
+
+Bir sonraki ekranda, reponuzun klonlama URL'ini goreceksiniz, bu URL takip eden bir kac komutta kullanacagiz:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Şimdi bilgisayarınızdaki Git reposunu Github'daki repo ile ilişkilendirmemiz gerekiyor.
+
+Aşağıdakini komut satırına yazın (`< your-github-username>`) kısmını Github hesabını yarattığınız sırada kullandığınız kullanıcı adı ile değiştirin, büyüktür küçüktür işaretlerini eklemeyin):
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git remote add origin https://github.com/<github-kullanıcı-adınız>/my-first-blog.git 
+    $ git push -u origin master
+    
+
+GitHub’a bastığınızda, GitHub kullanıcı adınız ve şifreniz istenecektir (komut satırı penceresinde veya açılan pencerede) ve kimlik bilgilerini girdikten sonra şöyle bir şey görmelisiniz:
+
+{% filename %}komut satırı{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/zeynep/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Kodunuz artık Github'da. Hemen gidip bakın! İyi bir çevrede olduğunu göreceksiniz - [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), ve daha birçok harika açık kaynak yazılım projesi de kodlarını Github'da tutuyor. :)
+
+# Blogumuzun PythonAnywhere üzerinde kurulumu
+
+## PythonAnywhere hesabı oluşturma
+
+> **Not** En baştaki kurulum adımlarında PythonAnywhere hesabını açmış olabilirsiniz - öyleyse bu kısmı tekrar yapmanıza gerek yok.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Sitemizin PythonAnywhere üzerinde yapılandırılması
+
+Ana [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) a logosuna tıklayarak dönelim ve bir "Bash" console başlatalım – bu bilgisayarınızdaki komut satırının PythonAnywhere versiyonudur.
+
+![PythonAnywhere web arayüzündeki 'New Console' bölümünde, 'bash' için butona tıkla](images/pythonanywhere_bash_console.png)
+
+> **Not:** PythonAnywhere Linux tabanlıdır, eğer Windows kullanıyorsan, bilgisyarındaki konsoldan biraz farklı görünür.
+
+PythonAnywhere'de bir web yazılımı konuşlandırmak için kodun GitHub'dan çekilmesi ve PythonAnywhere'in bu kodu tanıyabilmesi ve çalıştırması için yapılandırmamız gerekiyor. Bu iş manuel olarak yapabilir ama PythonAnywhere bunu kolaylıkla yapabilmek için yardımcı bir araç sunar. İlk önce bu aracı kuralım:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+Bu komut ekrana bir takım şeyler yazar, mesela `Collecting pythonanywhere` den başlayıp, sonunda `Successfully installed (...) pythonanywhere- (...)` gibi bir şey der.
+
+Şimdi, programımızı otomatik olarak yapılandırmak için bu komutu calıştıralım. Aşağıdakileri PythonAnywhere konsoluna yazın (`<your-github-username>` yerine kendi Github kullanıcı adınızı yazmayı unutmayın):
+
+{% filename %}PythonAnywhere komut satırı{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+Bu komut çalışırken neler olup bittiğini izleyebilirsiniz:
+
+- Kodunuz GitHub'dan çekiliyor
+- PythonAnywhere üzerinde kendi bilgisayarınızdaki gibi bir virtualenv oluşturuluyor
+- Yayına almak için gerekli ayarlar (settings) dosyası güncelleniyor
+- Yine `manage.py migrate` komutu ile PythonAnywhere üzerinde veritabanı oluşturuluyor
+- Sabit dosyaların (bunları daha sonra öğreneceğiz) oluşturuluyor
+- Ve web uygulamanızın API sinin PythonAnywhere tarafından sunulması için ayarlar yapılıyor
+
+Bu adımlar PythonAnywhere'de otomatikleştirilmiştir, ancak farklı sunucu sağlayıcıları ile yapılacak olan adımlarla aynıdır.
+
+Şu an dikkat edilmesi gereken en önemli şey PythonAnywhere'teki veritabanınızın aslında kendi bilgisayarınızdaki veritabanından tamamen ayrı olmasıdır, böylece farklı yayınlara ve yönetici hesaplarına sahip olabilir. Bu nedenle, aynen kendi bilgisayarımızda yapmış olduğumuz gibi, `createsuperuser` ile bir admin kullacısını oluşturmamız gerekiyor. PythonAnywhere otomatik olarak virtualenv i başlatmış olduğu için, bu kullanıcıyı hemen oluşturabiliriz:
+
+{% filename %}PythonAnywhere komut satırı{% endfilename %}
+
+    (<kullanici-adiniz>.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Admin kullanıcısının detaylarını girin. Daha önce kendi bilgisayarınızda oluşturduğunuz kullanıcı detayları ile aynı tutarsanız hatırlamak daha kolay olacaktır, fakat güvenlik açısından PythonAnywhere üzerindeki şifreyi daha zor tanımlamak isteyebiliriz.
+
+Şimdi, isterseniz, PythonAnywhere üzerindeki kodlara `ls` komutu ile göz atabilirsiniz:
+
+{% filename %}PythonAnywhere komut satırı{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+"Files" sekmesine giderek de PythonAnywhere in sunduğu arayüz ile dosyaları gezinebilirsiniz. (Sağ üst köşedeki menü butonunu kullanarak, konsol sayfasından diğer PythonAnywhere sayfalarına geçebilirsiniz. Bu sayfaların birindeyken, sayfanın yukarısında diğer sayfalara olan linkleri görebilirsiniz.)
+
+## Şimdi Canlı Yayındasınız!
+
+Siteniz artık halka açık internette yayınlanmalıdır! Bir bağlantı almak için PythonAnywhere "Web" sayfasına tıklayın. Bunu istediğiniz herhangi biriyle paylaşabilirsiniz. :)
+
+> **Not** Bu kılavuz başlangıçlara yönelik olduğu için basit tutmak amacıyla siteyi yayına alırken güvenlik açısından ideal olmayan bir kaç seçim yaptık. Eğer bu projeyi geliştirmek veya yeni bir projeye başlamak isterseniz, güvenlik tavsiyeleri için [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) sayfasını inceleyin.
+
+## Hata ayıklama önerileri
+
+`pa_autoconfigure_django.py` komut dosyasını çalıştırırken bir hata görürseniz, bunun yaygın birkaç nedeni vardır:
+
+- PythonAnywhere API tokeni oluşturmayı unutmak.
+- GitHub URL'nizde bir hata yapmak
+- *"Could not find your settings.py"* hatası genellikle tüm gerekli dosyaların Git'e eklenmemiş ve/veya GitHub'a başarılı olarak push edilmemiş olmasından kaynaklanır. Tekrar Git bölümüne bakın
+- Eğer daha önce PythonAnywhere hesabına kaydolduysanız ve collectstatic hatası ile karşılaştıysanız, büyük ihtimalle hesabınızda SQLite'ın eski versiyonunu (örneğin 3.8.2) kullanıyorsunuzdur. Bu durumda, yeni bir hesap açın ve PythonAnywhere bölümündeki komutları tekrar deneyin.
+
+Websitenizi ziyaret ettiğiniz zaman bir hata ile karşılaşırsanız ilk bakacağınız yer **error log** dosyasıdır. PythonAnywhere [Web](https://www.pythonanywhere.com/web_app_setup/) sekmesinde bu dosyaya link bulabilirsiniz. Hata mesajlarını buradan kontrol edebilrisiniz; en yakın zamandaki hatalar en sonda yer alır.
+
+[PythonAnywhere wiki üzerinde bazı genel hata giderme tüyoları](http://help.pythonanywhere.com/pages/DebuggingImportError) mevcuttur.
+
+Ve eğitmeniniz size yardıma hazır, unutmayın!
+
+# Sitenize göz atın!
+
+Siteniz için bulunan varsayılan sayfa ''İşe yaradı!'' demelidir. Tıpkı yerel bilgisayarınızda olduğu gibi. URL'nin sonuna `/admin/` yazın, 'giriş' tuşuna bastığınızda admin sitesi açılacak. Kullanıcı adı ve parola ile giriş yapın, sunucuya yeni Mesaj ekleyebileceğinizi göreceksiniz - yerel test veritabanınızdaki yayınların canlı blogunuza gönderilmediğini unutmayın.
+
+Birkaç gönderi oluşturduktan sonra, lokal kurulumunuza geri dönebilirsiniz (PythonAnywhere'e değil). Değişiklikleri lokalinizde yapacaksınız. Bu web geliştirmekte yaygın bir akışıdır - değişiklikleri yerel olarak yapar, sonra bu değişiklikleri GitHub'a gönderip canlı Web sunucusuna çekersiniz. Bu canlı web sitenizi bozmadan çalışmanızı ve yeni şeyler denemenizi sağlar. Bayağı havalı, di mi?
+
+Kendinize *KOCAMAN* bir aferin diyin! Yayına alma web geliştirme işinin en uğraştırmalı kısımlarından biridir ve genelde çalışana kadar insanların birkaç gününü alır. Ama işte siteniz canlıda, gerçek internette!
\ No newline at end of file
diff --git a/tr-TR/deploy/install_git.md b/tr-TR/deploy/install_git.md
new file mode 100644
index 00000000000..f6a14d441f0
--- /dev/null
+++ b/tr-TR/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git, birçok programcı tarafından kullanılan bir "sürüm kontrol sistemi"dir. Bu yazılım dosyaların zaman içindeki değişimlerini izler, böylelikle sonradan eski sürümlere ulaşabilirsiniz. Bir parça, kelime işlemcisi programlarındaki (Microsoft Word ve ya LibreOffice Writer v.b.) "değişikleri izleme" özelliği gibi, ama çok daha güçlü.
+
+## Git'i kurmak
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Git'i [git-scm.com](https://git-scm.com/) adresinden indirebilirsiniz. İki adım hariç bütün adımlarda "next"e basarak ilerleyebilirsiniz. Editör seçiminin sorulduğu adımda, Nano seçeneğini seçin. "Adjusting your PATH environment" adımında ise "Run Git and associated Unix tools from the Windows command-line" (en alttaki opsiyonu) seçin. Onun dışında varsayılanları seçebilirsiniz. Satır sonları için kodu çekerken Windows-stilini, kodu gönderirken Unix-stilini kullanın.
+
+Kurulum başarıyla tamamlandıktan sonra uçbirimi veya PowerShell'i yeniden başlatmayı unutmayın.<!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Git'i [git-scm.com](https://git-scm.com/)'den indirin ve yönergeleri izleyin.
+
+> **Not** Eğer OS X 10.6, 10.7 ya da 10.8 kullanıyorsanız, giti buradan indirmeniz gerekmektedir: [OS X Snow Leopard için Git Kurulumu](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/tr-TR/deploy/signup_pythonanywhere.md b/tr-TR/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..f93b317ee73
--- /dev/null
+++ b/tr-TR/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere, "bulutta" bulunan sunucularda Python kodunu çalıştırmak için kullanılan bir hizmettir. Sitemizi, canlı ve internette barındırmak için bunu kullanacağız.
+
+Geliştirdiğimiz blogu PythonAnywhere üzerinde sunacağız. PythonAnywhere'de bir "Beginner" hesabı açın (ücretsiz seviye yeterli, kredi kartına ihtiyacınız yok).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![Ücretsiz 'Beginner' hesabı oluşturmak için PythonAnywhere kayıt sayfası düğmesi](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Not** Burada kullanıcı adınızı seçerken, blogunuzun URL'sinin `yourusername.pythonanywhere.com`, şeklini alacağını unutmayın, bu nedenle ya blogunuzun neyle ilgili ise ona uygun isim veya kendi isminizi kullanabilirsiniz. Ayrıca, parolanızı hatırladığınızdan emin olun (sadece bir kişi kullanıyorsa, şifre yöneticinize ekleyin).
+
+## PythonAnywhere API token oluşturma
+
+Bu yalnızca bir kere yapmanız gereken bir şey. PythonAnywhere için kaydolduğunuzda, kontrol panelinine yönlendirileceksiniz. "Hesap" sayfanızın sağ üst kısmındaki bağlantıyı bulun:
+
+![Hesap bağlantısı sayfanın sağ üst tarafında](../deploy/images/pythonanywhere_account.png)
+
+sonra "API token" isimli sekmeyi seçin ve "Create new API token" yazan butona tıklayın.
+
+![Hesaplar sayfasındaki API token sekmesi](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/tr-TR/django/README.md b/tr-TR/django/README.md
new file mode 100644
index 00000000000..c76b588dd98
--- /dev/null
+++ b/tr-TR/django/README.md
@@ -0,0 +1,27 @@
+# Django nedir?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) Python ile yazılmış özgür ve açık kaynak bir web uygulama iskeletidir (framework). Bir web iskeleti, websitesi geliştirmeyi hızlandıran ve kolaylaştıran bir grup bileşendir.
+
+Bir web sitesi geliştirdiğinizde benzer türde bileşenlere her zaman ihtiyacınız olur: kullanıcılar için kimlik denetimi (üye olma, üye girişi, üye çıkışı), websiteniz için bir yönetim paneli, formlar, dosyaları yüklemek için bir yol, vs.
+
+Şanslısınız ki, uzun zaman önce başkaları web geliştiricilerinin yeni bir site yaratırken benzer problemlerle karşı karşıya geldiğini farkettiler ve takım kurup, kullanmanız için hazır bileşenleri olan iskeletler (ki Django bunlardan bir tanesi) oluşturdular.
+
+Frameworkler, siz yeni bir site oluştururken yükünüzü hafifletmek için tekerleği yeniden icat etmek zorunda.
+
+## Neden bir iskelete ihtiyacınız var?
+
+Django'nun aslında ne işe yaradığını anlamak için, sunuculara daha yakından bakmamız gerekiyor. İlk olarak sunucunun, onun size bir web sitesi sunmasını istediğinizi bilmesi gerekiyor.
+
+Bir posta kutusunun (port) gelen mektuplar (requests) için izlendiğini düşünün. Bu bir web sunucusu tarafından yapılıyor. Web sunucusu mektubu okur ve ardından bir web sayfası ile cevap verir. Ama bir şey gönderecekseniz, içeriğe ihtiyacınız var. Django içeriği oluşturmanıza yardımcı olan bir şeydir.
+
+## Birisi sunucunuzdan bir web sitesi istediğinde ne olur?
+
+Bir istek bir web sunucusuna geldiğinde, Django'ya aktarılır aslında ve Django da istenin ne olduğunu anlamaya çalışır. O da önce bir web sayfası adresi alır ve ne yapacağını anlamaya çalışır. Bu kısım Django'nun **url çözücüsü** (urlresolver) tarafından yapılıyor (websitesi adresine URL - Uniform Resource Locator - deniyor, dolayısıyla *url çözücü* ismi mantıklı oluyor). Çok akıllı değildir - kalıpların bir listesini alır ve URL'yi eşleştirmeye çalışır. Django kalıpları üstten alta doğru denetler ve eşleşen bir şey varsa isteği ilgili işleve (*view* olarak adlandırılan) aktarır.
+
+Mektup dağıtan bir postacı düşünün. Sokak boyunca yürüyor ve her evin numarasını mektubun üstündeki numara ile karşılaştırıyor. Eğer eşleşirse, mektubu oraya koyuyor. Url çözücü işte böyle çalışır!
+
+Tüm ilginç şeyler *view (görünüm)* fonksiyonunda yapılır: bir bilgi için veritabanına bakabiliriz. Belki de kullanıcı veride bir şeyin değişmesini istemiştir? "Lütfen iş tanımımı değiştirin." diyen bir mektup gibi. *View* bunu yapmaya izninizin olup olmadığını kontrol eder, iş tanımınızı sizin için günceller ve geri "Tamamdır!" mesajı yollar. Sonra *view* bir yanıt üretir ve Django bunu kullanıcının web tarayıcısına gönderebilir.
+
+Tabi ki yukarıdaki biraz basitleştirilmiş bir açıklama, ama şimdilik bütün teknik ayrıntıyı bilmene gerek yok. Genel bir fikrin olması yeterli.
+
+Doğrudan çok fazla detaya girmek yerine, Django ile bir şeyler oluşturacağız ve önemli kısımları yolda öğreneceğiz!
\ No newline at end of file
diff --git a/tr-TR/django_admin/README.md b/tr-TR/django_admin/README.md
new file mode 100644
index 00000000000..395f21f0cd2
--- /dev/null
+++ b/tr-TR/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+Az önce modellediğimiz gönderilere ekleme, düzenleme ya da silme işlemi yapmak için Django admini kullanacağız.
+
+Şimdi `blog/admin.py` dosyasını açarak içeriğini aşağıdaki şekilde değiştirelim:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Gördüğünüz gibi, bir önceki bölümde tanımladığımız gönderi modelini admin.py dosyamıza dahil (import) ettik. Admin sayfasında modelimizi görünür kılabilmek için, modeli `admin.site.register(Post)` ile kaydetmemiz gerekiyor.
+
+Tamam, artık admin sayfasında gönderi modelimize göz atabiliriz. Web sunucusunu çalıştırmak için komut satırında `python manage.py runserver` komutunu çalıştırmayı unutmayın. Tarayıcınıza gidin ve adresi yazın http://127.0.0.1:8000/admin/. Bunun gibi bir giriş ekranı göreceksiniz:
+
+![Giriş sayfası](images/login_page2.png)
+
+Giriş yapabilmek için, sitedeki her şey üzerinde kontrolü olan *superuser* - bir kullanıcı hesabı oluşturmanız gerekiyor. Komut satırına geri giderek `python manage.py createsuperuser` yazın ve enter'a basın.
+
+> Ağ sunucusu açıkken yeni komut yazmak için, yeni bir terminal penceresi açıp sanal ortamınızı (virtualenv) aktive etmeniz gerekmektedir. **Web sunucusu başlatma** bölümünün, **Sizin ilk Django projeniz!** kısmında yeni komutların nasıl yazılacağını gözden geçirdik.
+
+{% filename %}Mac OS X veya Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Giriş satırı geldiğinde, kullanıcı adınızı (küçük harfler ile ve boşluksuz), email adresinizi ve parolanızı girin. **Yazdığınız şifreyi göremezseniz endişelenmeyin - olması gereken budur.** Devam etmek için şifreyi yazıp `enter` 'a basın. Çıktı şunun gibi olmalıdır ( belirtilen kullanıcı adı ve eposta size ait olmalı):
+
+    Kullanıcı Adı: admin
+    Eposta adresi: admin@admin.com
+    Parola:
+    Parola (tekrar)
+    Süper kullanıcı başarıyla oluşturuldu.
+    
+
+Tarayıcınıza dönün. Oluşturduğunuz superuser'ın bilgileri ile giriş yaptığınızda Django'nun admin panelini göreceksiniz.
+
+![Django admin](images/django_admin3.png)
+
+Posts linkine tıklayın ve biraz kurcalayın. Beş veya altı blog yazısı ekleyin. İçeriği kafanıza takmayın - içerik sadece sizin yerel bilgisayarınızda görülür- zaman kazanmak için kılavuz'dan bir kaç paragraf kopyalayıp yapıştırabilirsiniz. :)
+
+En azından iki ya da üç yazıya (ama hepsinin değil) yayınlama tarihi girdiğinizden emin olun. Bunu ileriki adımlarda kullanacağız.
+
+![Django admin](images/edit_post3.png)
+
+Eğer Django admin ile ilgili daha fazla şey öğrenmek istiyorsanız, Django dokümantasyonuna göz atabilirsiniz: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Şu an muhtemelen enerjinizi geri toplamak için bir şeyler yemek veya kahve( ya da çay) içmek için iyi bir zaman. İlk Django modelinizi yarattınız. Küçük bir molayı hak ettiniz!
\ No newline at end of file
diff --git a/tr-TR/django_forms/README.md b/tr-TR/django_forms/README.md
new file mode 100644
index 00000000000..89942005b2d
--- /dev/null
+++ b/tr-TR/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+Blogumuzda yapmak istediğimiz son şey blog yazılarını eklemek ve düzenlemek için güzel bir yapı oluşturmak. Django'nun `admin` arayüzü çok havalı, ama özelleştirilmesi ve güzel hale getirilmesi oldukça zor. `forms` (formlar) ile kendi arayüzümüz üstünde mutlak bir güce sahip olacağız - neredeyse hayal ettiğimiz her şeyi yapabiliriz!
+
+Django formlarının güzel yanı, hem sıfırdan bir form tanımlayabilmemiz hem de sonuçları modele kaydedecek bir `ModelForm` oluşturabilmemizdir.
+
+Tam olarak yapmak istediğimiz şey: `Post` modelimiz için bir form oluşturmak.
+
+Django'nun diğer önemli parçaları gibi, formların da kendi dosyası var: `forms.py`.
+
+`blog` dizinimizde bu isimde bir dosya oluşturmalıyız.
+
+    blog
+       └── forms.py
+    
+
+Tamam, hadi dosyayı açalım ve aşağıdaki kodu yazalım:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Önce Django formları (`from django import forms`) ve tabii ki `Post` modelimizi (`from .models import Post`) import komutu ile dahil etmeliyiz.
+
+Tahmin etmiş olabileceğiniz gibi, formumuzun ismi `PostForm`. Django'ya bu formun bir `ModelForm` olduğunu belirtmeliyiz. Bunu `forms.ModelForm` sayesinde Django bizim için yapacaktır.
+
+Sırada Django'ya bu formu oluşturmak için hangi modelin kullanılması gerektiğini (`model = Post`) anlattığımız `class Meta` var.
+
+Son olarak, formumuzda hangi alan(lar)ın bulunması gerektiğini söyleyebiliriz. Bu senaryoda sadece `title` ve `text` alanlarının gösterilmesini istiyoruz - `author` şu anda giriş yapmış olması gereken kişidir (yani siz!) ve biz ne zaman yeni bir yazı oluşturursak `created_date` otomatik olarak (örn. kod içinde) ayarlanmalıdır, değil mi?
+
+Ve hepsi bu kadar! Şimdi tek yapmamız gereken formu bir *view* içinde kullanıp, template (şablon) içinde göstermek.
+
+Bir kere daha sayfaya bir bağlantı, bir url, bir view ve bir template oluşturacağız.
+
+## Formun bulunduğu sayfaya bağlantı oluşturma
+
+Linki eklemeden önce, buton olarak kullanabileceğimiz bazı ikonlara ihtiyacımız var. Bu öğretici için [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) dosyasını indirin ve `blog/templates/blog/icons/` klasörüne kaydedin.
+
+> Not: SVG görüntüsünü indirmek için, bağlam menüsünü açın (genellikle üzerine sağ tıklayarak) ve "Bağlantıyı farklı kaydet"i seçin. Dosyayı nereye kaydedeceğinizi soran iletişim kutusunda, Django projenizin `djangogirls` dizinine gidin, içindeki `blog/templates/blog/icons/` alt dizinine girin ve dosyayı oraya kaydedin.
+
+Kod düzenleyicide `blog/templates/blog/base.html` dosyasını açma zamanı geldi. Şimdi bu ikon dosyasını ana şablonun içinden aşağıda gösterildiği gibi kullanabiliriz. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. `include` adlı bir Django şablon yönergesi kullanıyoruz. Bu, dosyanın içeriğini Django şablonuna enjekte edecektir. Web tarayıcısı, herhangi bir işlem yapmadan bu tür içeriği nasıl kullanacağını bilir.
+
+> Tüm Bootstrap simgelerini [buradan](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip) indirebilirsiniz. Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. Bu şekilde, `blog/templates/blog/icons/pencil-fill.svg` dosya yolunu kullanarak `pencil-fill.svg` gibi bir simgeye erişebilirsiniz.
+
+Satırı düzenledikten sonra, HTML dosyanız artık şu şekilde görünmelidir:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Dosyayı kaydedip http://127.0.0.1:8000 sayfasını yeniledikten sonra, siz de bilindik `NoReverseMatch` hatasını görüyor olmalısınız, görüyorsunuz değil mi? Güzel!
+
+## URL
+
+`blog/urls.py` dosyasını açıp şu satırı ekleyelim:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+Ve kodun son hali şu şekilde görünecektir:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+Sayfayı yeniledikten sonra `post_new` view'ını oluşturmadığımız için `AttributeError` hatası alacağız. Şimdi onu ekleyelim.
+
+## post_new view
+
+Şimdi `blog/views.py` dosyasını açıp aşağıdaki satırları diğer `from` satırlarının olduğu yere ekleyelim:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+Ve sonra bizim *view*'ımız:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Yeni bir `Post` formu oluşturmak için `PostForm()` fonksiyonunu çağırmak ve template'e iletmek gerekir. *view* kısmına geri döneceğiz, ancak şimdilik form için bir template oluşturalım.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* Formu göstermek zorundayız. Örneğin bunu şu şekilde yapabiliriz {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* Bir `Kaydet` butonuna ihtiyacımız var. Bunu Bir HTML butonu ile yapıyoruz: `<button type="submit">Kaydet</button>`.
+* Ve son olarak, açılıştan hemen sonra `<form ...>` etiketini eklememiz gerekiyor {% raw %}`{% csrf_token %}`{% endraw %}. Formlarımızın güvenliğini sağladığı için bu çok önemlidir! Eğer bu kısmı unutursak, formu kaydetmeye çalıştığımızda Django şikayet edecektir:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>Yeni post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Kaydet</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Formu kaydetme
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? Bunu şu şekilde yapacağız:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Bakalım çalışacak mı? Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+Süper!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Oturum hatası](images/post_create_error.png)
+
+## Form doğrulama
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form doğrulama](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Form düzenleme
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Öncelikle düzenleme butonunu temsil eden ikonu kaydedelim. [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) dosyasını indirin ve `blog/templates/blog/icons/` konumuna kaydedin.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Güvenlik
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Son bir şey daha: deployment (yayına alma) zamanı!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* İlk önce kodumuzu commit edelim, sonra Github'a push edelim:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Site içinde blog yayını oluşturmak/düzenlemek için görünümler eklendi."
+    $ git push
+    
+
+* Sonra bir [PythonAnywhere Bash konsol](https://www.pythonanywhere.com/consoles/) una gidip:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Son olarak, ["Web" page](https://www.pythonanywhere.com/web_app_setup/) bölümüne geçin (konsolun sağ üst tarafındaki menü düğmesini kullanın) ve **Yeniden yükle** tuşuna basın. Değişiklikleri görmek için https://subdomain.pythonanywhere.com blogunuzu yenileyin.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/tr-TR/django_installation/README.md b/tr-TR/django_installation/README.md
new file mode 100644
index 00000000000..61f3a909fa2
--- /dev/null
+++ b/tr-TR/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django kurulumu
+
+> **Not** Eğer Chromebook kullanıyorsanız, bu bölümü atlayın ve [Chromebook Kurulumu](../chromebook_setup/README.md)'ndaki talimatları takip ettiğinizden emin olun.
+> 
+> **Not** Eğer [kurulum adımlarını](../installation/README.md) halihazırda tamamladıysanız, bunu zaten yapmışsınızdır - doğrudan bir sonraki bölüme geçebilirsiniz!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/tr-TR/django_installation/instructions.md b/tr-TR/django_installation/instructions.md
new file mode 100644
index 00000000000..ec604a24a4c
--- /dev/null
+++ b/tr-TR/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Bu bölümün bir kısmı Geek Girls Carrots tarafından hazırlanmış eğitimlere dayanılarak hazırlanmıştır (https://github.com/ggcarrots/django-carrots).
+> 
+> Bölümün bu kısmı [django-marcador tutorial](http://django-marcador.keimlink.de/) e dayandırılmış ve Creative Commons Attribution-ShareAlike 4.0 International License koruması altında lisansı alınmıştır. Django-marcador tutorial'ının hakları Markus Zapke-Gründemann'e aittir.
+
+## Sanal ortam (Virtual environment)
+
+Django'yu yüklemeden önce kod ortamınızı düzenli tutmak için son derece yararlı bir araç yükleyeceğiz. Bu adımı atlayabilirsiniz, fakat atlamamanızı tavsiye ederiz. En iyi olası kurulum ile başlamanız sizi gelecekteki bir sürü sorundan koruyacaktır!
+
+Öyleyse bir **virtual environment** (diğer adıyla *virtualenv*) kuralım. Virtualenv Python/Django kurulumunuzu her proje için ayrı tutup izole eder. Bu, bir websitesine yapacağınız değişikliklerin diğer geliştirdiklerinize yansımayacağı anlamına gelir. Muazzam, değil mi?
+
+Yapmanız gereken tek şey `virtualenv` oluşturmak için bir dizin bulmak; örneğin giriş dizininiz. Windows'ta şöyle görünebilir: `C:\Users\Name` (`Name` yerine kullanıcı adınız gelir).
+
+> **NOTE:** Windows'ta bu dizinin özel karakterler içermediğinden emin olun; eğer kullanıcı adınız özel karakterler içeriyorsa, farklı bir dizin kullanın. Örneğin: `C:\djangogirls`.
+
+Bu eğitim için giriş dizininizde yeni açtığımız `djangogirls` adlı bir klasör kullanacağız:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+`myvenv` adında bir virtualenv oluşturacağız. Genel komut aşağıdaki şekilde olacak:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Yeni bir `virtualenv` yaratmak için, komut satırını açmanız ve `python -m venv myvenv`'u çalıştırmanız gerekir. Böyle görünecektir:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Burada `myvenv`, `virtualenv`'inizin ismidir. İstediğiniz herhangi bir ismi kullanabilirsiniz, ama küçük harfle yazılmasına ve boşluk, aksan karakterleri (örn: å) ve özel karakterleri kullanmamaya dikkat edin. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Hem Linux hem de OS X 'teyken `python3 -m venv myvenv` komutuyla bir `virtualenv` oluşturabiliriz. Şu şekilde gözükecektir:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+Burada `myvenv` sizin `virtualenv`'inizin ismi. Dilerseniz istediğiniz herhangi bir isim kullanabilirsiniz, ama büyük harf ve boşluk kullanmamaya dikkat edin. Ayrıca ismi kısa tutmak işinize yarayacaktır zira bu ismi çokça kullanıyor olacaksınız!
+
+> **NOT:** Debian/Ubuntu'nun bazı sürümlerinde aşağıdaki hatayı alabilirsiniz:
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     Ensurepip kullanılamadığından sanal ortam başarıyla oluşturulamadı.  Debian/Ubuntu sistemlerinde, aşağıdaki komutu kullanarak python3-venv paketini yüklemeniz gerekir.
+>        apt install python3-venv
+>     sudo komutu ile kullanmanız gerekebilir.  python3-venv paketini indirdikten sonra, virtualenv'inizi yeniden oluşturun. 
+>     
+> 
+> Bu durumda, yukarıdaki yönergeleri izleyin ve `python3-venv` paketini yükleyin:
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> Bu şekilde Debian/Ubuntu'nun bazı sürümlerinde sanal ortamı başlatırken o anda aşağıdaki hatayı alabilirsiniz:
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     Error: Command '['/home/zeynep/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Bu sorunu çözmek için `virtualenv` komutunu kullanabilirsiniz.
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOT:** Eğer aşağıdaki gibi bir hata alırsanız
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> o zaman yerine bunu çalıştırın:
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Virtualenv ile çalışmak
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Şu komutu çalıştırarak virtualenv'i başlatın:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. Bu durumda, başka bir Windows PowerShell'i, "Yönetici Olarak Çalıştır" seçeneğiyle açın. Bundan sonra sanal ortamınızı başlatmadan önce aşağıdaki komutları yazmayı deneyin:
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> Bu durumun avantajı ise editor ve komut-satırı arasında pencere değistirmek zorunda olmamamız
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Şu komutu çalıştırarak virtualenv'i başlatın:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+`myvenv` kısmını seçtiğiniz `virtualenv` ismi ile değiştirmeyi unutmayın!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+Konsolunuzda komut isteminizin başında `(myvenv)` gördüğünüzde `virtualenv`'in çalıştığını anlayabilirsiniz.
+
+Virtualenv ile çalışırken `python` otomatik olarak doğru sürümü çalıştıracaktır. Yani `python3` yerine `python` yazabilirsiniz.
+
+Artık bütün gerekli uygulamaları bir araya getirdiğimize göre sonunda Django'yu yükleyebiliriz!
+
+## Django'yu yüklemek {#django}
+
+`virtualenv`'i çalıştırdığınıza göre, şimdi Django'yu yükleyebilirsiniz.
+
+Bunu yapmadan önce, bilgisayarımızın, Django yüklemek için kullanacağımız yazılım olan `pip`'in en son versiyonuna sahip olduğundan emin olmalıyız:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Requirements ile paketleri yüklemek
+
+Requirements dosyası `pip install` ile yüklenmesi gereken paketlerin listesini tutar:
+
+Önceden indirdiğimiz editör kullanarak `djangogirls/` klasoru icinde `requirements.txt` dosyasini olusturalim. Bunu kod editöründe yeni bir dosya açıp, sonra `requirements.txt` olarak `djangogirls/` klasöründe kaydederek yapın. Klasorlerin boyle gozukmesi gerek:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+`djangogirls/requirements.txt` dosyanıza şu kodu eklemelisiniz:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Simdi, Django kurmak için `pip install -r requirements.txt` komutunu çalıstırın.
+
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). Eğer böyleyse, lütfen boşluksuz veya özel karaktersiz bir yer kullanmayı düşünün (öneri: `C:\djangogirls`). Yeni dizinde yeni bir virtualenv oluşturun, sonra eskisini silin ve yukarıdaki komutu tekrar deneyin. (virtualenv dizinini taşımak işe yaramayacaktır çünkü virtualenv <0>absolute path</0> kullanır.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     C:\Kullanici\Isim\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> Eğer Ubuntu 12.04 işletim sisteminde pip komutunu çağırırken bir hata iletisiyle karşılaştıysanız `python -m pip install -U --force-reinstall pip` komutunu çalıştırarak pip kurulumunu onarmayı deneyin.
+
+<!--endsec-->
+
+İşte bu kadar! Sonunda Django uygulamanızı oluşturmaya hazırsınız!
\ No newline at end of file
diff --git a/tr-TR/django_models/README.md b/tr-TR/django_models/README.md
new file mode 100644
index 00000000000..b784da51efe
--- /dev/null
+++ b/tr-TR/django_models/README.md
@@ -0,0 +1,201 @@
+# Django modelleri
+
+Şimdi blogumuzdaki bütün yazıları kaydedebileceğimiz bir şey oluşturmak istiyoruz. Ama bunu yapabilmek için önce `nesne` dediğimiz şeylerden (objects) bahsetmemiz gerekiyor.
+
+## Nesneler (Objects)
+
+Programlamada `nesneye yönelik programlama` denen bir kavram bulunuyor. Buradaki ana fikir her şeyi sıkıcı program komutları dizisi şeklinde yazmak yerine, konseptleri modelleyip birbirleri ile nasıl etkileşime geçeceklerini tanımlamak.
+
+Peki bir nesne nedir? Nesne bir özellikler ve hareketler bütünüdür. Kulağa garip geliyor olabilir, bir örnekle açıklayalım.
+
+Eğer bir kediyi modellemek istiyorsak, `Kedi` nesnesini oluştururuz ve bu nesne şöyle özelliklere sahip olur: `renk`, `yas`, `ruh_hali` (örneğin; iyi, kötü, uykulu ;)) ve `sahibi` (ki bu da bir `insan` nesnesi olur ya da eğer sokak kedisi ise bu özellik boş olabilir).
+
+Ayrıca `Kedi` bazı hareketlere sahiptir: `miyavla`, `tirmala` ya da `beslen` (bu durumda kediye biraz `KediMamasi` vermemiz gerekir ki o da kendine ait özellikleri olan başka bir nesne olarak tanımlanabilir, bu durumda onun özellikleri arasında da `tat` yer alabilir).
+
+    Kedi
+    --------
+    renk 
+    yas 
+    ruh_hali 
+    sahibi 
+    miyavla() 
+    tirmala() 
+    beslen(kedi_mamasi)
+    
+
+    KediMamasi
+    -------- 
+    tat
+    
+
+Yani aslında ana fikir, gerçek nesneleri kod içinde özellikleri (`nesne özellikleri`) ve hareketleri (`metodlar`) ile tanımlamak.
+
+Öyleyse blog gönderilerini nasıl modelleyeceğiz? Bir blog tasarlamak istiyoruz, degil mi?
+
+Cevaplamamız gereken soru: Bir blog gönderisi nedir? Özellikleri ne olmalıdır?
+
+Tabii ki blog gönderimizin içeriği için yazı ve bir de başlık lazım, değil mi? Kimin yazdığını da bilsek iyi olur - dolayısı ile bir de yazara ihtiyacımız var. Son olarak, gönderinin ne zaman yaratıldığını ve yayınlandığını da bilmek isteyebiliriz.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Bir blog gönderisi ile ne tür şeyler yapılabilir? Gönderiyi yayınlayan bir `method` olması güzel olurdu, değil mi?
+
+Bu yüzden `publish` metoduna ihtiyacımız olacak.
+
+Ne elde etmek istediğimizi bildiğimize göre, haydi bunu Django'da modellemeye başlayalım!
+
+## Django modeli
+
+Nesnenin ne olduğunu bildiğimize göre, blog gönderimiz için bir Django modeli oluşturabiliriz.
+
+Django'da modeller özel bir çeşit nesnedir - `veritabanı`'na kaydedilir. Veritabanı (database) belirli bir veri topluluğuna verdiğimiz isim. Veritabanında, kullanıcılar, blog gönderileri, vs. ile ilgili bilgileri saklarız. Verilerimizi depolamak için SQLite veritabanını kullanacağız. Bu varsayılan Django veritabanı adaptörü - şimdilik bizim için yeterli olacaktır.
+
+Veritabanındaki bir modeli, sütunları (alan adı) ve satırları (veri) olan bir hesap çizelgesi olarak düşünebilirsiniz.
+
+### Uygulama oluşturma
+
+Her şeyi derli toplu tutmak için, projemizin içinde ayrı bir uygulama oluşturacağız. Her şeyin en başından düzenli olması çok iyidir. Bir uygulama oluşturmak için aşağıdaki komutu konsolda çalıştırmamız gerekiyor (`djangogirls` dizininden `manage.py` dosyasının bulunduğu yer):
+
+{% filename %}Mac OS X ve Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Yeni bir `blog` dizininin oluşturulduğunu ve bir dizi dosya içerdiğini fark edeceksiniz. Projemizdeki dizinler ve dosyalar şu sekilde görünüyor olmalı:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+Uygulamamızı oluşturduktan sonra, Django'ya bunu kullanmasını söylememiz lazım. Bunu `mysite/settings.py` dosyasından yapacağız -- kod editörümüzde açalım. `INSTALLED_APPS`'ı bulup `]` karakterinin üzerindeki satıra `'blog.apps.BlogConfig',` yazmamız lazım. Sonuç aşağıdaki gibi görünmeli:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Post (Blog gönderisi) modeli oluşturma
+
+`blog/models.py` dosyasında `Models` denilen bütün nesneleri tanımlıyoruz - burası blog postumuzu tanımlayacağımız yer.
+
+Şimdi `blog/models.py` dosyasını açalım ve içindeki her şeyi silip şu kodu yazalım:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> `str`'nin her iki tarafında da 2 tane alt çizgi (`_`) kullandığımızdan emin olalım. İki alt çizgi Python dilinde sık kullanılır, bazen "dunder" olarak da anılır ("double-underscore"un kısaltması).
+
+Biraz korkunç görünüyor, değil mi? Ama merak etmeyin - hepsinin ne anlama geldiğini tek tek anlatacağız!
+
+`from` veya `import` ile başlayan tüm satırlar başka yerlerden bir şeyleri projemize dahil eder. Yani, başka yerlerde tanımlanmış kodları dosyalarımıza kopyalamak yerine, bu kodların bir kısmını `from ... import ...` kullanarak kodumuza dahil edebiliriz.
+
+`class Post(models.Model):` - bu satır modelimizi tanımlıyor (bir `nesne`).
+
+- `class` bir nesne tanımladığımızı belirten anahtar kelime.
+- `Post` modelimizin ismi. Başka bir isim de verebilirdik (yeter ki özel karakterler ve boşluk kullanmayalım). class isimleri her zaman büyük harf ile başlamalıdır.
+- `models.Model` Post'un bir Django Modeli olduğunu belirtir, bu şekilde Django onu veritabanında tutması gerektiğini bilir.
+
+Şimdi daha önce bahsettiğimiz özellikleri tanımlayabiliriz: `title`, `text`, `created_date`, `published_date` ve `author`. Bunun için her alanın türünü tanımlamamız gerekir (Bir metin mi? Bir numara mı? Bir tarih mi? Başka bir nesneye referans mı, örneğin User?)
+
+- `models.CharField` - belirli bir uzunluktaki metinleri tanımlamak için kullanılır.
+- `models.TextField` - bu da uzun metinleri tanımlar. Blog gönderileri için biçilmiş kaftan, değil mi?
+- `models.DateTimeField` - bu da gün ve saati tanımlamada kullanılır.
+- `models.ForeignKey` - başka bir modele referans tanımlar.
+
+Burada her detayı anlatmıyoruz, çünkü çok fazla vakit alır. Model alanları (model fields) hakkında daha fazla bilgi edinmek ve yukarıda açıklananların dışındaki alanları nasıl tanımlayacağınızı öğrenmek istiyorsanız Django dokümantasyonuna bir göz atabilirsiniz (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+Peki ya `def publish(self):` nedir? Bu, daha önce bahsettiğimiz `publish` metodu. `def` bunun bir fonksiyon/method olduğunu söylüyor. `publish` ise methodumuzun ismi. Eğer isterseniz metodun adını değiştirebilirsiniz. Methodlara isim verirken küçük harf kullanmaya ve boşluk yerine alt çizgi kullanmaya dikkat ediyoruz. Örneğin ortalama fiyatı hesaplayan bir methoda `ortalama_fiyati_hesapla` ismi verilebilir.
+
+Genellikle methodlar bir şeyler döndürür (`return` anahtar kelimesi döndür anlamına gelir). `__str__` methodunda bunun örneğini görebiliriz. Bu durumda, `__str__()` methodunu çağırdığımızda Post başlığını içeren bir metin (**string**) elde ederiz.
+
+Aynı zamanda hem `def publish(self):` satırının, hem de `def __str__(self):` satırının sınıfımızın içinde girintili (indented) bir şekilde yazıldığına dikkat edin. Python boşluklara duyarlı olduğu için class'ın içindeki metodları girintili olarak yazmamız gerekiyor. Aksi takdirde methodlar class'a ait olmaz ve beklenmedik davranışlarla karşılaşabilirsiniz.
+
+Buraya kadar model hakkında anlamadığın bir şeyler varsa mentörüne sormaktan çekinme! Bu konuların biraz karmaşık olduğunun farkındayız. Özellikle hem nesneleri hem de fonksiyonları aynı anda öğrenmek kolay değil. Umarız gizemi biraz azalmaya başlamıştır!
+
+### Modeller için veritabanında tablo oluşturma
+
+Son adımımız yeni modelimizin veritabanına eklenmesini sağlamak. Öncelikle Django'nun modelimizde bazı değişiklikler yaptığımızı bilmesini sağlamalıyız. (Daha yeni oluşturduk!) Komut satırına gidelim ve `python manage.py makemigrations blog` yazalım. Şöyle görünmeli:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Not:** Düzenlediğiniz dosyaları kaydetmeyi unutmayın. Aksi takdirde, bilgisayarınız önceki sürümü çalıştırarak beklenmedik hatalar verebilir.
+
+Django bize veritabanımıza uygulayabileceğimiz bir taşıma (migration) dosyası oluşturdu. `python manage.py migrate blog` yazdığın zaman şunu görmelisin:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Yaşasın! Post modelimiz artık veritabanımızda! Görsek ne güzel olur, değil mi? Gelecek bölümde Post'un nasıl göründügünü göreceğiz!
\ No newline at end of file
diff --git a/tr-TR/django_orm/README.md b/tr-TR/django_orm/README.md
new file mode 100644
index 00000000000..042ffe51ae4
--- /dev/null
+++ b/tr-TR/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM ve QuerySets (SorguSetleri)
+
+Bu bölümde Django'nun veritabanına nasıl bağlandığını ve veriyi nasıl sakladığını öğreneceğiz. Hadi başlayalım!
+
+## QuerySet (SorguSeti) Nedir?
+
+QuerySet (SorguSeti), esas olarak, verilen bir modele ait nesnelerin listesidir. QuerySet veritabanından veri okumamıza, veriyi filtrelememize ve sıralamamıza imkan sağlar.
+
+En kolayı örnek ile öğrenmektir. Hadi deneyelim, olur mu?
+
+## Django shell (kabuk)
+
+Bilgisayarımızdaki konsolu açalım (PythonAnywhere'dekini değil) ve şu komutu yazalım:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Etkisi aşağıdaki gibi olmalı:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+Şu an Django'nun etkileşimli konsolundayız. Python istemine benziyor, ama biraz Django büyüsü eklenmiş :) Kuşkusuz burada da Python komutlarının tümünü kullanabiliriz.
+
+### Tüm nesneler
+
+Önce tüm post'larımızı görüntülemeyi deneyelim. Bunu aşağıdaki komut ile yapabiliriz:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Ahh! Bir hata meydana geldi. Bize Post'un tanımlı olmadığını söylüyor. Bu doğru, öncesinde post'u dahil etmeyi (import) unuttuk!
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+`blog.models`'dan `Post` modelini dahil ettik (import). Tekrar bütün post'ları görüntülemeyi deneyelim:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: Gönderi başlığım>, <Post: Diğer bir gönderi başlığı>]>
+```
+
+Bu daha önce oluşturduğumuz post'ların listesi! Bu post'ları Django admin arayüzü ile oluşturduk. Fakat şimdi Python kullanarak yeni post'lar oluşturmak istiyoruz, peki bunu nasıl yaparız?
+
+### Nesne oluşturma
+
+Veritabanına yeni bir gönderi eklemek için:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> Post.objects.create(author=ben, title='Harika bir gönderi', text='Ne desem bilemedim')
+```
+
+Ancak bir eksiğimiz var: `ben`. Gönderinin author (yazar) özelliğine `User` (kullanıcı) modelinden türetilen bir nesneyi parametre olarak vermemiz gerekiyor. Nasıl verebiliriz?
+
+Öncelikle User (kullanıcı) modelini dahil edelim:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Veritabanımızda hangi kullanıcılar var? Şu şekilde görebiliriz:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: zeynep>]>
+```
+
+Bu daha önce yarattığımız süper kullanıcı (superuser)! Şimdi bu kullanıcının örneğini (instance) alalım (bu satırı kendi kullanıcı adınızı kullanmak için değiştirin):
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+ben = User.objects.get(username='zeynep')
+```
+
+Görebildiğiniz gibi, şimdi `kullanıcı adı` 'zeynep' olan bir `User` aldık. Temiz!
+
+Gönderimizi artık kaydedebiliriz:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> Post.objects.create(author=ben, title='Harika bir gönderi', text='Ne desem bilemedim')
+<Post: Harika bir gönderi>
+```
+
+Yaşasın! Çalışıp çalışmadığını kontrol etmek ister misin?
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: Gönderi başlığım>, <Post: Diğer bir gönderi başlığı>,<Post: Harika bir gönderi>]>
+```
+
+İşte bu kadar, listede bir gönderi daha!
+
+### Daha fazla post ekle
+
+Şimdi daha fazla post ekleyerek biraz eğlenebilir ve nasıl çalıştığını görebiliriz. İki veya üç tane daha ekleyelim ve sıradaki bölüme geçelim.
+
+### Nesneleri filtrelemek
+
+QuerySet'lerin büyük bir bölümü nesneleri filtreleme yeteneğidir. Diyelim ki, Zeynep tarafından yazılmış tüm post'ları (gönderileri) bulmak istiyoruz. `Post.objects.all()` içindeki `all` yerine `filter` kullanacağız. Parantez içine istediğimiz blog gönderilerinin sağlaması gereken şartları belirteceğiz. Örneğimizde, `author` `ben`'e eşitti. Django'da bu filtreyi şöyle yazıyoruz: `author=ben`. Şu an kod parçacığımız şöyle görünüyor:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=ben)
+[<Post: Gönderi 1>, <Post: Gönderi 2>, <Post: Harika bir gönderi>, <Post: Nefis bir gönderi>]
+```
+
+Ya da belki `title` (başlık) alanında içinde 'Nefis' kelimesini içeren tüm gönderileri görmek istiyoruz?
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='Nefis')
+[<Post: Nefis bir gönderi>]
+```
+
+> **Not** `title` ve `contains` arasında iki tane alt çizgi (`_`) var. Django'nun ORM'i bu söz dizimini, özelliği ("title") ve operasyon veya filtreyi ("contains") ayırmak için kullanır. Eğer sadece tek bir alt çizgi kullanırsanız, "FieldError: Cannot resolve keyword title_contains" şeklinde bir hata alacaksınız.
+
+Ayrıca yayınlanmış tüm post'ların bir listesini alabiliriz. Bunu `published_date` (yayinlanma_tarihi) alanı geçmiş bir tarih olan tüm gönderileri filtreleyerek yapıyoruz:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Maalesef python konsolundan eklediğimiz post (gönderi) henüz yayınlanmadı. Fakat bunu değiştirebiliriz! Önce yayınlamak istediğimiz bir gönderi nesnesi bulalım:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Harika bir gönderi")
+```
+
+Ardından `publish` (yayinla) methodu ile gönderiyi yayınlayalım:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Şimdi yayınlanmış gönderileri tekrar almaya çalışalım (3 kez yukarı ok tuşuna ve ardından `enter` tuşuna basın):
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Harika bir gönderi>]
+```
+
+### Nesneleri Sıralama
+
+QuerySets ayrıca nesne listesini sıralamanızı da sağlar. Nesneleri `created_date` (yaratilma_tarihi) özelliğine göre sıralamayı deneyelim:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Gönderi 1>, <Post: Gönderi 2>, <Post: Harika bir gönderi>, <Post: Nefis bir gönderi>]
+```
+
+Başına `-` ekleyerek sıralamayı tersine de çevirebiliriz:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: Nefis bir gönderi>, <Post: Harika bir gönderi>, <Post: Gönderi 2>, <Post: Gönderi 1>]>
+```
+
+### QuerySets (SorguSetlerini) Zincirlemek (Chaining)
+
+Gördüğünüz gibi `Post.objects`'teki bazı metotlar QuerySet döner. Ayrıca aynı metotlar sırayla bir QuerySet'te çağırılabilir ve ardından yeni bir QuerySet döndürülebilir. Böylelikle QuerySet'lerini **zincirleyerek** etkilerini birleştirebilirsin:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Gönderi 2>, <Post:Harika bir gönderi!>, <Post: Nefis bir gönderi>, <Post: Gönderi 1>]>
+```
+
+Zincirleme gerçekten çok güçlüdür ve oldukça karmaşık sorgular yazmanıza imkan sağlar.
+
+Güzel! Şimdi bir sonraki bölüm için hazırız. Komut satırını kapatmak için, şunu yazalım:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/tr-TR/django_start_project/README.md b/tr-TR/django_start_project/README.md
new file mode 100644
index 00000000000..3db5322e0a7
--- /dev/null
+++ b/tr-TR/django_start_project/README.md
@@ -0,0 +1,260 @@
+# İlk Django projen!
+
+> Bu bölümün bir kısmı Geek Girls Carrots tarafından hazırlanmış eğitimlere dayanılarak hazırlanmıştır (https://github.com/ggcarrots/django-carrots).
+> 
+> Bu bölümün [django-marcador tutorial](http://django-marcador.keimlink.de/)'a dayanan bazı kısımları Creative Commons Attribution-ShareAlike International License altında lisanslanmıştır. Django-marcador tutorial'ının hakları Markus Zapke-Gründemann'e aittir.
+
+Küçük bir blog oluşturacağız!
+
+İlk adım yeni bir Django projesi başlatmaktır. Aslında, bizim için bir Django projesinin iskeletini yaratacak Django tarafından sağlanan bazı komut dosyaları çalıştıracağız. Bu sadece daha sonra kullanacağımız dosyalar ve dizinler grubudur.
+
+Bazı dosya ve dizinlerin isimleri Django için çok önemlidir. Oluşturmak üzere olduğumuz dosyaları yeniden adlandırmamalısınız. Onları başka bir yere taşımak da iyi bir fikir değil. Django'nun önemli şeyleri bulabilmesi için belirli yapısını koruması gerekir.
+
+> virtualenv içindeki her şeyi çalıştırmayı unutmayın. Eğer konsolunuzda `(myenv)` öneki görmüyorsanız, virtualenv'inizi aktive etmeniz gerekir. **Django yükleme** bölümünün **Virtualenv ile çalışma** kısmında nasıl yapılacağını açıkladık. Windows'ta `myvenv\Scripts\activate` ya da, Mac OS ya da Linux'ta `source myvenv/bin/activate` yazmak bunu sizin için yapacaktır.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+MacOS veya Linux konsolunuzda aşağıdaki komutu çalıştırmalısınız; **sonuna nokta `(.)` koymayı unutmayın**
+
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Nokta `.` bu durumda çok önemlidir çünkü; koda, Django'yu şu an bulunduğunuz dizine kurmasını söyler. (nokta `.` şu anki dizine bir kısayoldur).
+> 
+> **Not** Yukarıdaki komutu yazarken, sadece `django-admin` ile başlayan kısmı yazmanız gerektiğini unutmayın. Burada gösterilen `(myvenv) ~/djangogirls$` kısmı, sadece komut satırında girdinizi davet eden komut istemi örneğidir.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Windows'ta aşağıdaki komutu çalıştırmalısınız. **(Sonuna nokta `.` koymayı unutmayın)**:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Nokta `.` bu durumda çok önemlidir çünkü; koda, Django'yu şu an bulunduğunuz dizine kurmasını söyler. (nokta `.` şu anki dizine bir kısayoldur).
+> 
+> **Not** Yukarıdaki komutu yazarken, sadece `django-admin.exe` ile başlayan bölümü yazmanız gerektiğini unutmayın. Burada gösterilmiş olan `(myvenv) C:\Users\Name\djangogirls>` kısmı komut satırına girdiğiniz davet edecek olan komut istemi örneğidir.
+
+<!--endsec-->
+
+`django-admin.py` sizin için dosya ve dizinler oluşturacak bir komut dosyasıdır. Şimdi aşağıdaki gibi görünen bir dizin yapınız olmalı:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Not**: Dizin yapınızda, daha önceden oluşturduğumuz `venv` dizinini de göreceksiniz.
+
+`manage.py` site yönetimine yardımcı olan bir komut dosyasıdır. Bu dosya sayesinde, başka herhangi bir şey kurmadan bilgisayarımızda bir web sunucusunu başlatabileceğiz.
+
+`settings.py` dosyası, web sitesinizin ayarlarını içerir.
+
+Bir mektubu nereye götüreceğini kontrol eden postacının hakkında konuştuğumuzu hatırlıyor musun? `urls.py` dosyası `urlresolver`(urlçözümleyici) tarafından kullanılan kalıpların bir listesini içerir.
+
+Şu an için değişiklik yapmayacağımız diğer dosyaları yoksayalım. Unutmamanız gereken tek şey kazayla onları silmeyin!
+
+## Ayarları değiştirme
+
+Hadi `mysite/settings.py` dosyasında bazı değişiklikler yapalım. Daha önceden kurduğunuz kod düzenleyicinizi (editör) kullanarak dosyayı açın.
+
+**Not**: `settings.py` dosyasının da diğerleri gibi normal bir dosya olduğunu aklınızda tutun. Bunu kod düzenleyicisi içerisinde "dosya -> aç" menü eylemini kullanarak açabilirsiniz. Bu, size `settings.py` dosyanıza gidebileceğiniz ve bu dosyayı seçebileceğiniz her zamanki klasik pencereyi açacaktır. Alternatif olarak, bu dosyayı masaüstünüzdeki djangogirls klasörüne gidip sağ tıklayarak açabilirsiniz. Sonra, listeden kod düzenleyicinizi seçin. Dosyayı açabilen ancak düzenlemenize izin vermeyecek diğer programların yüklü olması ihtimaline karşın kod düzenleyicinin seçilmesi önem arz etmektedir.
+
+Web sitemizin doğru bir saate sahip olması güzel olurdu. [Wikipedia'nın zaman dilimleri listesine](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) gidin ve ilgili saat dilimini kopyalayın (ZD) (Ör. `Europe/Berlin`).
+
+`settings.py` dosyasında `TIME_ZONE` ifadesini içeren satırı bulun ve kendi seçtiğiniz zaman dilimine göre uyarlayın:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Istanbul'
+```
+
+Bir dil kodu, dil (ör. İngilizce için `en` veya Almanca için `de`) ve ülke kodundan (ör. Almanya için `de` veya İsviçre için `ch`) oluşmaktadır. Eğer İngilizce ana diliniz değilse, varsayılan butonları ve Django uyarılarının dilini kendi dilinize değiştirmek için bunu ekleyebilirsiniz. Böylece "İptal" butonu burada tanımladığınız dile çevrilmiş olacaktır. Django hazırlanmış çok sayıda çeviri ile gelmektedir.
+
+Farklı bir dil istiyorsanız, aşağıdaki satırı değiştirerek dil kodunu seçin:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Ayrıca statik dosyalar için bir yol eklememiz gerekmektedir. (Eğitici ders içerisinde statik dosyalar ve CSS hakkında ayrıntılı bilgi bulabilirsiniz.) Dosyanın *son*'una gidin, hemen altında sadece `STATIC_URL` girişi yapın, `STATIC_ROOT` adında yeni birim ekleyin:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+`DEBUG(Hata Ayıklama)` `True(Doğru)` ve `ALLOWED_HOSTS` boş olduğu zaman ana bilgisayar `['localhost', '127.0.0.1', '[::1]']`'a karşı doğrulanır. Bu, uygulamamızı dağıttıktan sonra, PythonAnywhere'deki anamakine adıyla eşleşmeyecek bu yüzden aşağıdaki ayarları değiştireceğiz:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Not**: Eğer Chromebook kullanıyorsanız bu satırı settings.py dosyanızın en altına ekleyiniz: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Ayrıca eğer amazon kullanıyorsanız `ALLOWED_HOSTS`'a `.amazonaws.com` 'i ekleyin
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Bir veritabanı kur
+
+Web uygulamalarınız için farklı birçok veritabanı yazılımı vardır. Biz varsayılanı kullanacağız, `sqlite3`.
+
+Sqlite varsayılan olduğu için zaten `mysite/settings.py` dosyamızda kurulu:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Blogumuzun veritabanını oluşturmak için konsolda şu komutu çalıştırın: `python manage.py migrate` (`manage.py` dosyasını içeren `djangogirls` klasöründe olmalıyız). İşler iyi giderse şöyle bir şey görmelisiniz:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... Tamam
+    
+
+Hepsi bu kadar! Web sunucusunu (web server) çalıştırma ve websitemizin çalıştığını görme zamanı!
+
+## Web sunucusunu başlatmak
+
+`manage.py` dosyasının bulunduğu dizinde olmalıyız (`djangogirls` klasörü). Konsol üzerinden `python manage.py runserver` komutunu çalıştırarak web sunucusunu başlatabilirsiniz:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Eğer Chromebook üzerindeyseniz, bunun yerine şu komutu kullanın:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}tarayıcı{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> Web sunucuları nasıl çalışır **How the Internet works (İnternet Nasıl Çalışır)** bölümünde görmüştük.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/tr-TR/django_templates/README.md b/tr-TR/django_templates/README.md
new file mode 100644
index 00000000000..3ff3848d457
--- /dev/null
+++ b/tr-TR/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templateleri
+
+Bazı verileri gösterme zamanı! Django bunun için bize faydalı bazı yerleşik **template etiketleri** sunuyor.
+
+## Template etiketleri nedir?
+
+Görüyoruz ki aslında, HTML'de Python kodu yazamayız, çünkü tarayıcılar bunu anlamaz. Tarayıcılar yalnızca HTML'den anlar. Biliyoruz ki Python daha dinamik bir dil iken, HTML oldukça statiktir.
+
+**Django template etiketleri** Python benzeri yapıların HTML'ye aktarılmasını sağlar, böylece dinamik web sitelerini daha kolay ve hızlı oluşturabiliriz!
+
+## Gönderi listesi template'ini gösterme
+
+Bir önceki bölümde, template'e `posts` değişkeni içinde gönderiler listesi verdik. Şimdi, bunu HTML'de göstereceğiz.
+
+Django şablonunda (template) bir değişken (variable) yazdırmak için, değişken adını çift kıvrımlı parantez içinde şu şekilde kullanırız:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Bunu `blog/templates/blog/post_list.html` şablonunda deneyelim. Dosyayı kod editöründe açalım ve ikinci `<div>`'den üçüncü `</div>`'e kadar olan her şeyi `{{ posts }}` ile değiştirelim. Ne olduğunu görmek için dosyayı kaydedip sayfayı yenileyelim:
+
+![Şekil 13.1](images/step1.png)
+
+Gördüğümüz sadece bu:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: İkinci gönderim>, <Post: İlk gönderim>]>
+```
+
+Yani Django bunu bir nesneler listesi olarak algılıyor. **Python'a giriş**'ten listelerin nasıl gösterildiğini hatırlıyor musun? Evet, döngülerle! Bir Django template ile bunu şöyle yaparsın:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Bunu kendi template'imizle deneyelim.
+
+![Şekil 13.2](images/step2.png)
+
+İşe yarıyor! Fakat bunların daha önce **HTML'ye giriş** bölümünde oluşturduğumuz statik gönderiler gibi görünmesini istiyoruz. HTML ve template etiketlerini karıştırabiliriz. `body` şöyle görünecektir:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>yayınlandı: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}`{% for %}` ve `{% endfor %}` arasına koyduğunuz her şey listedeki her nesne için tekrarlanır. Sayfanı yenile:{% endraw %}
+
+![Şekil 13.3](images/step3.png)
+
+Bu sefer biraz daha farklı bir notasyon kullandığımızın farkında mısınız (`{{ post.title }}` or `{{ post.text }})`)? Böylece `Post` modelinde tanımlanan alanlardaki verilere ulaşıyoruz. Ayrıca `|linebreaks` (satırsonu), gönderilerin metnini, satır sonlarını paragraflara çeviren bir filtreden geçiriyor.
+
+## Bir şey daha
+
+Web sitemizin İnternet'te hâlâ çalıştığını görmek iyi olacak, değil mi? PythonAnywhere'e yükleyelim yine. Adımları hatırlayalım…
+
+* İlk önce kodumuzu Github'a push komutu ile yükleyelim
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Veritabanındaki gönderileri görüntülemek için değiştirilmiş şablonlar."
+    [...]
+    $ git push
+    
+
+* [PythonAnywhere](https://www.pythonanywhere.com/consoles/)'e bağlanalım ve **Bash konsolu**'na gidelim (veya yeni bir konsol açalım) ve şunu çalıştıralım:
+
+{% filename %}PythonAnywhere komut-satırı{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Köşeli parantez olmadan `<your-pythonanywhere-domain>` yerine gerçek PythonAnywhere alt etki alanınızı koymayı unutmayın.)
+
+* Son olarak, [Web sekmesi](https://www.pythonanywhere.com/web_app_setup/)ne gidip uygulamanızın **Yenile** butonuna basın. (Konsoldan diğer PythonAnywhere sayfalarına ulaşmak için, sağ üst köşedeki menü düğmesini kullanın.) Güncellemeniz https://isminiz.pythonanywhere.com adresinde yayınlanmalıdır - tarayıcıda kontrol edin! Eğer PythonAnywhere sitesindeki gönderilerin içeriği ile lokal sunucunuzda bulunan gönderilerin içeriği aynı değilse sorun değil. Lokal bilgisayarınızdaki veritabanı ile Python Anywhere'deki veritabanı, diğer dosyalarınız gibi eşitlenmiyor.
+
+Tebrikler! Şimdi Django admin üzerinden yeni bir gönderi eklemeyi deneyin (published_date eklemeyi unutmayın!) PythonAnywhere sitenizin Django admininde olduğunuzdan emin olun, https://subdomain.pythonanywhere.com/admin. Arkasından gönderileri görebilmek için oradaki sayfanızı yenileyin.
+
+Şiir gibi çalışıyor, değil mi? Gurur duyabiliriz! Şimdi bilgisayar başından bir süre kalkalım, çünkü bir molayı hak ettik. :)
+
+![Şekil 13.4](images/donut.png)
\ No newline at end of file
diff --git a/tr-TR/django_urls/README.md b/tr-TR/django_urls/README.md
new file mode 100644
index 00000000000..8be6c0e40c4
--- /dev/null
+++ b/tr-TR/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URL'leri
+
+İlk web sayfamızı yapmak üzereyiz: blogunuzun anasayfası! Ama önce, biraz Django url'lerini öğrenmeye başlayalım.
+
+## URL nedir?
+
+URL basitçe bir web adresidir. Her defasında bir web sitesini ziyaret ettiğinde bir URL görürsün. Tarayıcının adres çubuğunda görünmektedir. (Evet! `127.0.0.1:8000` bir URL'dir! Ve `https://djangogirls.org` da bir URL'dir)
+
+![Link](images/url.png)
+
+İnternetteki her sayfanın kendi URL'si olması gerekir. Böylelikle bir URL açıldığında uygulama ne göstermesi gerektiğini bilir. Django'da `URLconf` (URL konfigürasyonu) denilen bir şey kullanıyoruz. URLconf Django'nun doğru viewı bulmak için istenen URL ile eşleştirmeyi deneyeceği desenler dizinidir.
+
+## URL'ler Django'da nasıl çalışır?
+
+Kod editörümüzde `mysite/urls.py` dosyasını açalım ve neye benzediğine bakalım:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Gördüğünüz gibi Django bu dosyaya bizim için bir şeyler koymuş bile.
+
+Üçlü tırnaklar (`'''` or `"""`) arasındaki satırlara docstrings denir - bunları bir dosyanın, sınıfın ya da metodun en üstüne ne yaptıklarını anlatmak için yazabilirsiniz. Python bunları çalıştırmaz.
+
+Önceki bölümde gördüğümüz yönetici URL'si burada:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Bu satırın anlamı Django, `admin` ile başlayan her URL için ona uyan bir *view* bulur demektir. Bu durumda bir sürü yönetici URL'lerini ekliyoruz, böylece hepsi bu küçük dosyanın içinde sıkıştırılmış bir şekilde durmuyor -- bu hali daha okunabilir ve düzenli.
+
+## İlk Django URL'iniz!
+
+İlk URL'mizi oluşturma zamanı. 'http://127.0.0.1:8000/' adresinin bloğumuzun anasayfası olmasını ve gönderilerin bir listesini görüntülemesini istiyoruz.
+
+Aynı zamanda `mysite/urls.py` dosyasını temiz tutmak istiyoruz, bu yüzden `blog` uygulamamızdan `mysite/urls.py` ana dosyamıza URL'leri aktarıyoruz (import).
+
+Devam edip, `blog.urls`'i import edecek bir satır ekleyelim. Ayrıca `from django.urls…` satırını değiştirmelisiniz çünkü `include` fonksiyonunu burada kullanıyoruz, böylece bunu satıra eklemelisiniz.
+
+`mysite/urls.py` dosyamız şöyle olmalı:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django artık 'http://127.0.0.1:8000/' adresine gelen her şeyi `blog.urls`'e yönlendirecek ve oradaki yönergelere bakacak.
+
+## blog.urls
+
+`blog` dizini içinde `urls.py` adında yeni bir boş dosya oluşturalım ve kod editöründe açalım. Tamam! Şu ilk iki satırı ekleyelim:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Burada `blog` uygulamasından Django'nun `path` fonksiyonunu ve bütün `views` fonksiyonlarını dahil ediyoruz (import). (Şu an hiç url'imiz yok ama birazdan olacak!)
+
+Bundan sonra ilk URL kalıbımızı ekleyebiliriz:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+Gördüğünüz üzere, ana URL'e `post_list` adında bir `view` atıyoruz. Bu URL kalıbı boş bir dizeyle eşleşecek ve Django URL çözümleyicisi, tam URL yolunun önüne gelen alan adını (yani, http://127.0.0.1:8000/) yok sayacaktır. Bu kalıp, Django'ya eğer siteye biri 'http://127.0.0.1:8000/' adresinden gelirse gitmesi gereken yerin `views.post_list` olduğunu söylüyor.
+
+Son kısım `name='post_list'`, görünümü (view) tanımlamak için kullanılan URL'in adıdır. Bu view'un adı ile aynı olabilir ama tamamen farklı bir şey de olabilir. Bundan sonra projede isimlendirilmiş URL'leri kullanıyor olacağız, bu yüzden uygulamadaki her URL'i isimlendirmek önemli. Aynı zamanda URL isimlerini eşsiz ve kolay hatırlanabilir şekilde seçmeliyiz.
+
+Eğer şimdi http://127.0.0.1:8000/ adresine gitmeyi denerseniz, 'sayfanıza ulaşılamıyor' tarzında bir mesaj görürsünüz. Bunun nedeni sunucunun (`runserver` yazdığınızı hatırlıyor musunuz?) artık çalışmıyor olması. Sebebini bulmak için sunucunuzdaki komut penceresine bakın.
+
+![Hata](images/error1.png)
+
+Konsolunuz bir hata gösteriyor, ama endişelenmeyin -aslında bu oldukça kullanışlı: bize **'post_list' özelliği yok** diyor. Bu Django'nun bulup kullanmaya çalıştığı *view*'ın adı. Ama onu henüz oluşturmadık. Bu aşamada `/admin/` de çalışmayacaktır. Hiç merak etmeyin, oraya geleceğiz. Farklı bir hata görürseniz, web sunucunuzu yeniden başlatmayı deneyin. Bunun için web sunucunun çalıştığı windows konsolunda Ctrl+C ( Control ve C tuşuna birlikte) basarak durdurun. Windows'ta Ctrl+Boşluk tuşlarına basmanız gerekebilir. Sonra web sunucusunu `python manage.py runserver` komutuyla tekrar başlatmalısınız.
+
+> Eğer Django URLconfs hakkında daha fazla bilgi almak isterseniz resmi dokümana göz atın: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/tr-TR/django_views/README.md b/tr-TR/django_views/README.md
new file mode 100644
index 00000000000..c364beb6744
--- /dev/null
+++ b/tr-TR/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views - yaratma zamanı geldi!
+
+Bir önceki bölümde ortaya çıkan hatayı ortadan kaldırma vakti geldi! :)
+
+*view*, uygulamamızın "mantığının" ifade edildiği yerdir. Daha önce oluşturduğumuz `model` den bilgi alarak `template`'e iletir. "template"i ise gelecek bölümde oluşturacağız. View'ler bildiğiniz Python fonksiyonlarıdır. Ancak, **Python'a Giriş** bölümünde yazdığımız fonksiyonlardan biraz daha karmaşıktır.
+
+View'ler `views.py` dosyasında yer alır. Şimdi, *view*'larımızı `blog/views.py` dosyasına ekleyelim.
+
+## blog/views.py
+
+Tamam, şimdi bu dosyayı açalım ve içinde ne olduğuna bakalım:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Henüz fazla bir şey yok.
+
+`#` ile başlayan satırların yorumlar olduğunu unutmayın - bu # ile başlayan satırların Python tarafından çalıştırılmayacağı anlamına geliyor.
+
+Hadi yorumun önerdiği gibi bir *view* oluşturalım. Bunun için alttaki viewı en alta ekleyin:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Dosyamızı kaydedelim ve http://127.0.0.1:8000/ adresine gidip bakalım.
+
+Bir başka hata! Okuyup neler olduğunu anlamaya çalışalım:
+
+![Hata](images/error.png)
+
+İyi tarafından bakarsak bu hata en azından sunucumuzun yeniden çalıştığını gösteriyor, ama hala bir şeyler yanlış, değil mi? Dert etmeyin, sadece bir hata sayfası, korkacak bir şey yok! Komut satırındaki hata mesajları gibi bunlar da aslında oldukça yararlılar. *TemplateDoesNotExist* hatası alıyoruz, yani Template bulunamadı. Gelecek bölümde bu hatayı template oluşturarak düzeltelim!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/tr-TR/dynamic_data_in_templates/README.md b/tr-TR/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..d540e25c0e2
--- /dev/null
+++ b/tr-TR/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Template içinde dinamik veri
+
+Birkaç parçayı yerine oturttuk: `Post` (gönderi) modelini `models.py`'de tanımladık, `views.py`'de `post_list` (gönderi listesi) var ve template ekledik. Ama gönderilerimizi HTML'de görünür kıldık mı? Çünkü yapmak istediğimiz şey bu -bazı içerikleri (veritabanında kayıtlı modeller) al ve şablonumuzda göster, değil mi?
+
+Bu tam olarak *view*'lerin yapmasını beklediğimiz şey: modelleri ve template'leri bağlamak. `post_list` *view* 'ımızda göstermek istediğimiz modelleri alıp template'e iletmemiz gerekecek. *view* ile template içinde neyin (hangi modelin) gösterileceğine karar veriyoruz.
+
+Tamam, peki nasıl yapacağız?
+
+`blog/views.py`'ı açacağız. Şu anda `post_list` *view*'ı şöyle:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Kodları farklı dosyalara eklemekten bahsettiğimizi hatırlıyor musunuz? Şu an `models.py` içinde yazdığımız modeli kullanma zamanı. `from .models import Post` şeklinde bir satır ekleyeceğiz:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+`models`'dan önceki nokta, *mevcut dizin* veya *mevcut uygulama* anlamına geliyor. Hem `views.py` hem de `models.py` aynı dizindedir. Bu şu anlama geliyor: `.` ve dosya ismini (`.py` olmadan) kullanabiliriz. Arkasından modelin adını (`Post`)'u dahil ediyoruz (import ediyoruz).
+
+Sırada ne var? `Post` modelinden gerçek blog gönderilerini almak için `QuerySet` denilen sorgu setine ihtiyacımız var.
+
+## QuerySet (Sorgu Seti)
+
+QuerySet'in nasıl çalıştığı konusunda bir fikriniz oluşmuştur. [Django ORM (QuerySets) bölümü](../django_orm/README.md)nde konuşmuştuk.
+
+Şimdi yayınlanmış ve `published_date`'e (yayınlanma tarihine) göre sıralanmış bir gönderi listesi istiyoruz, değil mi? Bunu QuerySets bölümünde yapmıştık zaten!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Şimdi `blog/views.py` dosyasına `def post_list(request)` fonksiyonunu ekleyin ama öncelikle `from django.utils import timezone` eklemeyi unutmayın:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+QuerySet'imizi blogumuzun gönderi listesinde görüntülemek için yapmamız gereken iki şey var:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+QuerySet'imiz için bir *değişken* yarattığımıza dikkat edin: `posts`. Bu QuerySet'in ismi. Bundan sonra ondan ismi ile bahsedebiliriz.
+
+`render` fonksiyonunda `request` (internet aracılığıyla kullanıcıdan aldığımız her şey) adında ve başka bir şablon dosyası (`'blog/post_list.html'`) veren parametremiz var. Son parametremiz `{}`, şablonu kullanmak için bir şeyler ekleyebileceğimiz bir yer. Bunlara isimler vermemiz gerekiyor (`'posts'` ismini kullanmaya devam edeceğiz şimdilik). :) Şöyle olması lazım: `{'posts': posts}`. `:` 'dan önceki kısım string bunu not edelim; çift tırnak: `"` içine almamız gerekiyor.
+
+Nihayetinde `blog/views.py` şu şekle gelmiş olmalı:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+İşte bu kadar! Template'e geri gidip QuerySet'leri görünür hale getirme zamanı!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/tr-TR/extend_your_application/README.md b/tr-TR/extend_your_application/README.md
new file mode 100644
index 00000000000..914ef4c3482
--- /dev/null
+++ b/tr-TR/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Uygulamanı genişlet
+
+Websitemizi oluşturmak için gerekli olan adımların hepsini tamamladık: bir modelin, url'nin, view'in ve template(şablon)'in nasıl yazılacağını biliyoruz. Websitemizi nasıl güzelleştirebiliriz, onu da biliyoruz.
+
+Pratik zamanı!
+
+Blog'umuzda lazım olan ilk şey bir gönderiyi göstermek için bir sayfa, değil mi?
+
+Halihazırda bir `Post` modelimiz var, dolayısıyla `models.py` dosyasına bir şey eklememize gerek yok.
+
+## Bir gönderinin detayı için bir template(şablon) linki oluşturun
+
+`blog/templates/blog/post_list.html` dosyasına bir link (bağlantı) ekleyerek başlayacağız. Bu dosyayı kod düzenleyicisinde açalım, şimdiye kadar yaptıklarımızın şöyle gözüküyor olması lazım:
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}Gönderi listesindeki bir gönderinin başlığından bir gönderinin detay sayfasına bir link (bağlantı) olsun istiyoruz. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Gizemli `{% url 'post_detail' pk=post.pk %}` satırını anlatma zamanı. Şüphelendiğiniz üzere, `{% %}` notasyonu, Django template tags (şablon etiketleri) kullandığımız manasına geliyor. Bu sefer bizim için URL oluşturacak bir şablon (template) etiketi kullanacağız!{% endraw %}
+
+`post_detail` kısmı Django'nun `blog/urls.py/` dosyasının içinde post_detail adlı bir URL beklediği anlamına gelir.
+
+Peki `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Her Django modelinin birincil anahtarı olarak hizmet veren bir alanı vardır ve diğer adı ne olursa olsun, "pk" olarak da adlandırılabilir. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Şimdi http://127.0.0.1:8000/ adresine gittiğimizde bir hata ile karşılaşacağız (`post_detail` için bir URL ya da *görüntü (view)* olmadığı için hatayı almamız normal). Hata böyle görünecektir:
+
+![NoReverseMatch error (Tersi yok hatası)](images/no_reverse_match2.png)
+
+## Bir gönderinin detayı için URL oluşturun
+
+`post_detail` *view*'ımız için `urls.py`'un içinde bir URL oluşturalım!
+
+İlk gönderimizin detayının şu **URL**'de gösterilmesini istiyoruz: http://127.0.0.1:8000/post/1/
+
+`blog/urls.py` dosyasında `post_detail` adında bir Django *view*'ına işaret eden bir URL yapalım. Bu <1>view</1> bir gönderinin tümünü gösterecek. Kod düzenleyicide `blog/urls.py` dosyasını açın ve `path('post/<int:pk>/', views.post_detail, name='post_detail'),` satırını ekleyin, böylece dosya şöyle görünür:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+`post/<int:pk>/` kısmı bir URL kalıbı belirtir - sizin için bunu açıklayalım:
+
+- `post/`, URL'nin **post** kelimesi ile başlayıp ardından ** / ** ile devam etmesi gerektiği anlamına gelir.
+- `<int:pk>` - bu bölüm daha zorlayıcı. Django'nun bir tamsayı değeri beklediği ve onu `pk` adlı bir değişken olarak bir görünüme(view) aktaracağı anlamına gelir.
+- `/` - URL'yi bitirmeden önce **/** 'e tekrar ihtiyacımız var.
+
+Bu şu demek, eğer tarayıcınıza `http://127.0.0.1:8000/post/5/` yazarsanız, Django `post_detail` adında bir *view* aradığınızı anlar ve `pk` eşittir `5` bilgisini *view*'e aktarır.
+
+Tamamdır.`blog/urls.py`!'e yeni bir URL kalıbı ekledik! Http://127.0.0.1:8000/ sayfasını yenileyelim.Boom! Sunucu çalıştırmayı tekrar durdurdu. Konsola göz at, beklendiği gibi bir hata daha var!
+
+![AttributeError (Özellik hatası)](images/attribute_error2.png)
+
+Bir sonraki adımın ne olduğunu hatırlıyor musunuz? Tabi ki: view(görünüm)'ü eklemek!
+
+## Gönderi detayı için bir view ekleyin
+
+Bu sefer *view*'ımıza `pk` adında bir parametre ekleyeceğiz. *view*'ümüzün onu yakalaması gerekiyor, değil mi? Fonksiyonumuzu `def post_detail(request, pk):` olarak tanımlayacağız. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Ayrıca, bu değişkeni atlamanın yanlış olduğunu ve bir hatayla sonuçlanacağını unutmayın!
+
+Şimdi sadece ve sadece bir tane blog gönderisi almak istiyoruz. Bunu yapmak için şunun gibi sorgu setlerini/kümelerini kullanabiliriz:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Ama bu kodun bir problemi var. Eğer gelen `primary key` (`pk` - tekil anahtar) ile bir `Post` (gönderi) yoksa, çok çirkin bir hatamız olacak!
+
+![DoesNotExist error (Yok hatası)](images/does_not_exist2.png)
+
+Bunu istemiyoruz! Ama tabi Django'da bunu ele alan bir şey var: `get_object_or_404`. Eğer verilen `pk` ile bir `Post` bulunamazsa, çok daha güzel bir sayfa gösterilecek (`Sayfa bulunamadı 404` sayfası.
+
+![Page not found (Sayfa bulunamadı)](images/404_2.png)
+
+İyi haber şu, kendi `Sayfa bulunamadı` sayfasını yapabilir ve istediğiniz kadar güzelleştirebilirsiniz. Ama şu anda çok önemli değil, o yüzden bu kısmı atlayacağız.
+
+Tamam, `views.py` dosyamıza bir *view* ekleme zamanı!
+
+`blog/urls.py` içinde `views.post_detail` denilen bir görünüm ifade eden `post_detail` adında bir URL kuralı oluşturduk. Bu, Django'nun ` blog/views.py </ 0> içinde <code> post_detail </ 0> adlı bir görünüm fonksiyonu bekleyeceği anlamına gelir.</p>
+
+<p><code>blog/views.py` 'i açmalıyız ve diğer `from` satırının yanına şu kodları eklemeliyiz:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+Ve dosyanın sonuna kendi *view*'ımızı ekleyeceğiz:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Evet. http://127.0.0.1:8000/ sayfasını tazeleme zamanı
+
+![Post list view (Gönderi listesi görünümü)](images/post_list2.png)
+
+Çalıştı! Fakat blog gönderisi başlığındaki bir bağlantıya tıkladığınızda ne oluyor?
+
+![TemplateDoesNotExist error (Template yok hatası)](images/template_does_not_exist2.png)
+
+Of hayır! Başka bir hata! Ama onu nasıl halledeceğimizi biliyoruz, di mi? Bir template eklememiz gerekiyor!
+
+## Post(gönderi) detayları için bir template(şablon) oluştur
+
+`blog/templates/blog` dizininde `post_detail.html` adında bir dosya oluşturalım ve kod düzenleyicisinde açalım.
+
+Aşağıdaki kodu girin:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Bir kere daha `base.html` dosyasıa ekleme yapacağız. `content` blogunda bir gönderinin varsa published_date, title ve text'ini göstermek istiyoruz. Ama daha önemli şeyleri konuşmalıyız, değil mi?
+
+{% raw %}`{% if ... %} ... {% endif %}` bir şeyi kontrol etmek istediğimizde kullanabileceğimiz bir şablon etiketidir. ( `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+Tamam, şimdi sayfamızı yenileyerek `TemplateDoesNotExist` hatası kaybolmuş mu görebiliriz.
+
+![Post detail page (Gönderi detay sayfası)](images/post_detail2.png)
+
+Heyo! Çalışıyor!
+
+# Yayına alma zamanı!
+
+Sitenizin hala PythonAnywhere'de çalışıp çalışmadığına bakmakta fayda var, değil mi? Yeniden taşımayı deneyelim.
+
+{% filename %}komut satırı{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Detaylı blog gönderileri için CSS'e ilaveten view ve template eklendi."
+    $ git push
+    
+
+Sonra bir [PythonAnywhere Bash konsol](https://www.pythonanywhere.com/consoles/) una gidip:
+
+{% filename %}PythonAnywhere komut satırı{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Sunucudaki statik dosyaları güncelleyelim
+
+PythonAynwhere gibi sunucular "statik dosyalar"a (CSS dosyaları gibi) Python dosyalarından farklı davranır çünkü onları daha hızlı yüklenmesi için optimize edebilir. Sonuç olarak, CSS dosyalarında her değişiklik yaptığınızda, sunucuya onları güncellediğimizi söylemek için ilave bir komut çalıştırmalıyız. Bu komuta `collectstatic` adı verilir.
+
+Daha önceden çalıştırdığın virtualenv'in hala etkin değilse tekrar aktive ederek başlayın. (PythonAnywhere bunu yapmak için `workon` adlı bir komut kullanır. Kendi bilgisayarında kullandığın `source myenv/bin/activate` komutu gibi.):
+
+{% filename %}PythonAnywhere komut satırı{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+`manage.py collectstatic` komutu biraz `manage.py migrate` komutu gibidir. Kodumuzda bazı değişiklikler yapıp Django'ya bu değişiklikleri sunucunun statik dosyalar yığınına ya da veritabanına uygulamasını söyledik.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/tr-TR/how_the_internet_works/README.md b/tr-TR/how_the_internet_works/README.md
new file mode 100644
index 00000000000..fadfc019fac
--- /dev/null
+++ b/tr-TR/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# İnternet Nasıl Çalışır
+
+> Evdeki okuyucular için: bu bölüm [İnternet Nasıl Çalışır](https://www.youtube.com/watch?v=oM9yAA09wdc) videosunda anlatıldı.
+> 
+> Bu bölüm Jessica McKellar'ın "İnternet Nasıl Çalışır" adlı konuşmasından esinlenilerek oluşturuldu. (http://web.mit.edu/jesstess/www/).
+
+İddia ediyoruz ki her gün İnternet'i kullanıyorsunuz. Fakat tarayıcınıza https://djangogirls.org gibi bir adres girip `enter` tuşuna bastığınızda neler olduğunu biliyor musunuz?
+
+Anlamanız gereken ilk şey bir web sitesi, bir sabit diskte saklanan birtakım dosyalardan (filmleriniz, müzikleriniz ve fotoğraflarınız gibi) ibarettir. Ancak, web sitelerine özel şöyle bir durum var: HTML adı verilen bir bilgisayar kodu içerirler. 
+
+Eğer programlamayla aşina değilseniz başta HTML'yi kavramak zor olabilir, ama web tarayıcılarınız (Chrome, Safari, Firefox, vs.) ona bayılıyor. Web tarayıcılarınız bu kodu anlamak, komutlarını yerine getirmek ve size bu websitesini oluşturan dosyaları sunmak için tasarlanmıştır, tam da olmasını istediğiniz gibi.
+
+Her dosya gibi, bu HTML dosyalarını da sabit diskte bir yerde saklamamız gerekir. Internet için, *sunucu (server)* denilen özel ve güçlü bilgisayarlar kullanıyoruz. Bir ekranları, fareleri ya da klavyeleri yok çünkü esas amaçları veriyi saklamak ve sunmak. Bu yüzden onlara *sunucular* diyoruz – çünkü size veri *sunuyorlar*.
+
+Tamam ama yinede Internetin nasıl gözüktüğünü görmek istersiniz değil mi?
+
+Size bir resmini çizdik, İnternet işte buna benzer:
+
+![Şekil 1.1](images/internet_1.png)
+
+Çok karışık, değil mi? Aslında birbirine bağlanmış bir makina ağıdır (yukarıda bahsedilen *servers*). Yüz binlerce makine! Dünyanın dört bir yanını saran yüz binlerce kilometrelik kablolar! İnternet'in ne kadar karışık olduğunu görmek için denizaltı kablo haritası web sitesine(http://submarinecablemap.com) göz atabilirsiniz. İşte web sitesinden bir ekran görüntüsü:
+
+![Şekil 1.2](images/internet_3.png)
+
+Büyüleyici, değil mi? Ama, İnternet'e bağlanan her makine arasında bir kablo olması mümkün değil. Yani, bir makineye erişmek için (örneğin, https://djangogirls.org sitesinin kayıtlı olduğu) birçok farklı makine üzerinden istek geçmesi gereklidir.
+
+Şöyle gözükmekte:
+
+![Şekil 1.3](images/internet_2.png)
+
+https://djangogirls.org yazdığınızda: "Sevgili Django Girls, djangogirls.org websitesini görmek istiyorum. Lütfen bana gönderin!" diyen bir mektup gönderdiğinizi düşünün.
+
+Mektubunuz size en yakın postaneye gider. Daha sonra sizden biraz daha uzak bir postaneye gider, daha sonra biraz daha uzaktakine, daha uzağa ve en son gitmesi gereken yere. Tek farklı olan, aynı yere bir çok mektup(*veri paketi*) gönderirseniz, tamamen farklı postanelerden(*yönlendirici*) geçebilir. Bu, her bir postanede nasıl dağıtım yapıldığına bağlıdır.
+
+![Şekil 1.4](images/internet_4.png)
+
+Evet, bu kadar basit. Bir mektup yollarsınız ve cevap beklersin. Tabii ki, kağıt kalem yerine bayt biriminde veri kullanırsınız, fakat fikir aynı!
+
+Sokak adı, şehir, alan kodu ve ülke adı yerine, biz IP adreslerini kullanırız. Bilgisayarınız ilk olarak DNS'den (Domain Name System - Alan Adı Sistemi) djangogirls.org adresini bir IP adresine çevirmesini ister. Bu bir nebze burada iletişim kurmak istediğiniz kişinin adına bakarak telefon numarası ve adresini bulabildiğiniz eski telefon rehberleri gibi çalışır.
+
+Bir mektup gönderdiğinizde, bazı özelliklerin doğru olarak teslim edilecek olması gerekir: bir adres, bir pul vs. Ayrıca alıcının anlayacağı bir dil kullanıyorsunuz, değil mi? Aynısı bir web sitesini görmek için gönderdiğiniz *veri paketleri* için de geçerli. HTTP(Hypertext Transfer Protocol - HiperMetin transfer protokolü) adı verilen bir protokol kullanırız.
+
+Basit olarak, bir web siteniz olduğunda, içinde yaşayacağı bir *sunucu* makineniz olması gerekli. *Sunucu* (bir mektupla gelen) bir *istek* aldığında, (başka bir mektupla) size web sitenizi gönderir.
+
+Bu bir Django eğitimi olduğundan, Django'nun ne yaptığını sorabilirsiniz. Bir yanıt gönderirken, herkese her zaman aynı şeyi göndermek istemezsiniz. Mektupları özellikle size yazan kişi için kişiselleştirmek çok daha iyi, değil mi? Django bu kişiselleştirilmiş, ilginç mektupları yazmanıza yardımcı olur. :)
+
+Yeterince konuştuk - Yaratma zamanı!
\ No newline at end of file
diff --git a/tr-TR/html/README.md b/tr-TR/html/README.md
new file mode 100644
index 00000000000..8650d7e2d7b
--- /dev/null
+++ b/tr-TR/html/README.md
@@ -0,0 +1,227 @@
+# HTML'ye giriş
+
+Template nedir diye sorabilirsiniz.
+
+Template (şablon), farklı bilgileri hep aynı biçimde sunmak için tekrar tekrar kullanabileceğimiz bir dosyadır - örneğin, mektup yazmanıza yardımcı olan bir template kullanabilirsiniz çünkü yazacağınız tüm mektuplar farklı mesajlar içerse ve farklı kişilere gönderilse de aynı sayfa düzenine sahip olacaktır.
+
+Bir Django template'inin formatı HTML adını verdiğimiz bir dilde tanımlanır (**İnternet nasıl çalışır** adlı ilk bölümde bahsettiğimiz HTML).
+
+## HTML nedir?
+
+HTML kullanıcıya basit bir web sayfası görüntülemek için web tarayıcınız tarafından - Chrome, Firefox veya Safari gibi - yorumlanan basit bir koddur.
+
+HTML "HyperText Markup Language" (HiperMetin İşaretleme Dili) anlamına gelir. **HyperText** (HiperMetin) sayfalar arası bağlantıları destekleyen türden bir metin demektir. **Markup** (işaretleme), bir belgeyi alıp onu kodlarla işaretleyerek, nasıl yorumlanacağını (tarayıcıya) söylemek demektir. HTML kodu **etiketler** ile oluşturulur, etiketlerin her biri `<` ile başlar ve `>` ile biter. Bu etiketler biçimlendirme **öğelerini** temsil eder.
+
+## İlk template'iniz!
+
+Bir template oluşturmak bir template dosyası oluşturmak demektir. Her şey bir dosyadır, değil mi? Bunu muhtemelen zaten fark etmişsinizdir.
+
+Template'lar `blog/templates/blog` dizininde saklanır. Öyleyse blog klasörü altında `templates` adlı bir klasör oluşturalım. Sonra da templates klasörü altında yine `blog` adlı bir klasör oluşturalım:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(`blog` diye adlandırılan iki dizine niye ihtiyacımız olduğunu merak edebilirsiniz - daha sonra anlayacağınız üzere, sitemiz karmaşıklaştıkça bu şekilde isimlendirme tarzı işimizi oldukça kolaylaştırır.)
+
+Şimdi de `blog/templates/blog` dizini içine `post_list.html` adlı bir dosya oluşturalım (şimdilik içini boş bırakalım).
+
+Web sitemizin nasıl göründüğüne bir bakalım: http://127.0.0.1:8000/
+
+> Eğer hala `TemplateDoesNotExist` hatası alıyorsanız, sunucunuzu yeniden başlatmayı deneyin. Komut satırına girin, Ctrl+C (Kontrol ve C tuşlarına beraber) basarak sunucuyu durdurun ve `python manage.py runserver` komutunu çalıştırarak yeniden başlatın.
+
+![Şekil 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Yeni dosyayı kod düzenleyicisinde açıp şunları ekleyelim:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Merhaba!</p>
+    <p>Çalışıyor!</p>
+</body>
+</html>
+```
+
+Web siteniz şu anda nasıl görünüyor? Öğrenmek için bir bakalım: http://127.0.0.1:8000/
+
+![Şekil 11.2](images/step3.png)
+
+Çalıştı! Tebrikler! :)
+
+* `<DOCTYPE html>` satırı bir HTML etiketi değildir. Yalnızca belge türünü bildirir. Burada tarayıcıya belge türünün [HTML5](https://html.spec.whatwg.org/#the-doctype) olduğunu bildirir. Bu her zaman herhangi bir HTML5 dosyasının başlangıcıdır.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Kafa ve vücut
+
+Aynı zamanda tüm HTML sayfaları **head** ve **body** olmak üzere iki öğeye ayrılır.
+
+* **head** belge hakkında ekranda görüntülenmeyen bilgiler içeren öğedir.
+
+* **body** ise ekranda gösterilen tüm öğeleri içeren öğedir.
+
+`<head>` öğesini tarayıcıya sayfanın yapılandırmasını anlatmak için, `<body>` öğesini ise sayfada aslında ne olduğunu anlatmak için kullanırız.
+
+Örnek olarak, bir web sayfası başlık ögesini `<head>` içine koyabilirsiniz, bunun gibi:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ayşe'nin blogu</title>
+    </head>
+    <body>
+        <p>Merhaba!</p>
+        <p>Çalışıyor!</p>
+    </body>
+</html>
+```
+
+Dosyayı kaydedin ve sayfanızı yenileyin.
+
+![Şekil 11.3](images/step4.png)
+
+Tarayıcınızın "Zeynep'in blogu" başlığını nasıl anladığını fark ettiniz mi? `<title>Zeynep'in blogu</title>` kısmını başlık olarak yorumlayarak yazıyı tarayıcının başlık kısmına yerleştirdi. (Bu yazı yer işaretleri gibi yerlerde de kullanılır).
+
+Her açılan etiketin `/` ile başlayan bir *kapatan etiket*'i ile kapatılması gerekmektir. Ayrıca bu etiketler *iç içe* yerleştirilebilir (bu da bir etiketi kapatabilmek için, içindeki tüm etiketlerin kapanmış olmasını gerektirir).
+
+Bir şeyleri kutulara yerleştirmek gibi. Büyük bir kutuda `<html></html>` olsun; onun içinde `<body></body>` kutusu olsun, onun da içinde daha küçük kutular olsun: `<p></p>`.
+
+Bu *kapatma* etiketleri ve *yuvalama* ögeleri kurallarını takip etmeye ihtiyacınız vardır - eğer yapmazsanız tarayıcı onları gerektiği gibi açıklayamayabilir ve sayfanız hatalı olarak görüntülenecektir.
+
+## Template özelleştirme
+
+Şimdi artık biraz eğlenip template'inizi özelleştirmeyi deneyebilirsiniz! İşte bunun için faydalı birkaç etiket:
+
+* `<h1>Bir başlık</h1>` en önemli başlığınız (ana başlık)
+* `<h2>Bir alt başlık</h2>` - bir sonraki seviyedeki bir başlık için
+* `<h3>Bir alt-alt başlık</h3>`…ve böyle `<h6>`'ya kadar gider
+* `<p>Metin paragrafı</p>`
+* `<em>metin</em>` metni vurgular
+* `<strong>metin</strong>` metni iyice vurgular
+* `<br>`alt satıra gider (br etiketi ve > işaretinin arasına bir şey konulmaz)
+* `<a href="https://djangogirls.org">bağlantı</a>` bağlantı oluşturur
+* `<ul><li>ilk madde</li><li>ikinci madde</li></ul>` - tıpkı bunun gibi bir liste yapar!
+* `<div></div>` - sayfanın bir bölümünü tanımlar
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` bağımsız, kendi kendine yeten içeriği belirtir
+* `<section></section>` bir belgedeki bir bölümü tanımlar
+* `<header></header>` bir belge veya bölüm için bir başlık belirtir
+* `<main></main>` bir belgenin ana içeriğini belirtir
+* `<aside></aside>` kenar çubuğu gibi yerleştirildiği içeriğin dışında bazı içerikleri tanımlar
+* `<footer></footer>` bir belge veya bölüm için bir alt bilgi tanımlar
+* `<time></time>` belirli bir zamanı tanımlar (yada zaman aralığını)
+
+İşte komple bir template örneği, kopyalayın ve `blog/templates/blog/post_list.html` içine yapıştırın:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>yayınlandı: 14.06.2014, 12:14</time>
+            <h2><a href="">İlk Blogum</a></h2>
+            <p>Çok heyecanlıyım! Bu benim ilk blogum. Ne kadar zevkli bir işmiş bilgisayarlarla uğraşmak. Artık bilgisayar başından kalkmam. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Ne kadar zevkli bir işmiş bilgisayarlarla uğraşmak. Artık bilgisayar başından kalkmam. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Bize yaşattığı duygu:
+
+![Şekil 11.4](images/step6.png)
+
+Yaşasın! Şimdiye dek, şablonumuz tam olarak sadece **aynı bilgiyi** görüntüler - öncesinde ise şablonlardan **aynı formatta** **farklı** bilgileri görüntülememizden bahsediyorduk.
+
+Aslında yapmak istediğimiz Django yöneticimize eklenen gerçek postaları açmak - bundan sonra oraya gidiyoruz.
+
+## Bir şey daha: deployment (yayına alma) zamanı!
+
+Bunları İnternet'te canlı olarak görmek çok güzel olur, değil mi:
+
+### Kodumuzu commit ve push komutları ile Github'a yükleyelim
+
+İlk önce son deployment dan sonra hangi dosyaların değiştiğine bakalım. Bu komutları lokal bilgisayarımızda çalıştıralım, PythonAnywhere'de değil:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git status
+    
+
+`djangogirls` dizininde olduğumuzdan emin olalım ve `git` 'e bu dizinde yapılan tüm değişiklikleri dahil etmesini söyleyelim:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git add .
+    
+
+Dosyalarımızı yüklemeden önce `git`'in hangilerini yükleyeceğine (`git`'in yükleyeceği dosyalar yeşil gösterilir) bakalım:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git status
+    
+
+Neredeyse bitirdik, şimdi bu değişikliği tarihçesine kaydetmesini söyleyelim. Commit için değişiklikleri açıklayan bir mesaj yazalım. Bu aşamada istediğimizi yazabiliriz, fakat tanımlayıcı yazılar gelecekte neler yapmış olduğumuzu hatırlatması açısından faydalı olacaktır.
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git commit -m "Site için HTML dosyasını değiştirdim."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Bunu bir kez yapıp, değişikliklerimizi GitHub'a yükledik (ittik):
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git push
+    
+
+### Pull ile yeni kodu PythonAnywhere e alıp web uygulamasını tekrar yükleyelim
+
+* [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/)sayfasını ve **Bash console** u açalım (ya da yeni bir tane açalım). Sonra da çalıştıralım:
+
+{% filename %}PythonAnywhere komut satırı{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. Kontrol etmek istersen, **Files** sekmesine gidip kodunu PythonAnywhere üzerinde görebilirsin (Konsol sayfasındaki menü butonundan diğer PythonAnywhere sayfalarına ulaşabilirsin).
+
+* Son olarak, [Web sekmesi](https://www.pythonanywhere.com/web_app_setup/)ne gidip uygulamanızın **Yenile** butonuna basın.
+
+Güncelleme hazır olmalı! Devam edelim ve tarayıcıda web sitesini yenileyelim. Değişiklikler görünüyor olmalı. :)
\ No newline at end of file
diff --git a/tr-TR/installation/README.md b/tr-TR/installation/README.md
new file mode 100644
index 00000000000..297cd1899dc
--- /dev/null
+++ b/tr-TR/installation/README.md
@@ -0,0 +1,68 @@
+# Eğer tutorial'ı evde yapıyorsanız
+
+Eğer tutorial'ı [Django Girls etkinliklerinden](https://djangogirls.org/events/) birinde değil de evde yapıyorsanız, bu bölümü şimdi tamamen atlayabilirsiniz ve direkt [İnternet nasıl çalışıyor](../how_the_internet_works/README.md) bölümüne geçebilirsiniz.
+
+Çünkü kılavuz boyunca gerekli yükleme işlemlerini zaten işliyoruz, bu kısım kurulum talimatlarının tek yerde toparlandığı ek bir sayfa sadece (bu yöntem bazı atölye formatları için kullanışlıdır). Eğer istiyorsanız şimdi bu sayfadaki her şeyi yüklemeyi seçebilirsiniz. Ama bilgisayarınıza birkaç şey yüklemeden önce bir şeyler öğrenmeye başlamak istiyorsanız, bu bölümü atlayın. Daha sonra kurulum kısmını size açıklayacağız.
+
+İyi şanslar!
+
+# Eğer bir atölyeye katılıyorsanız
+
+Eğer [Django Girls](https://djangogirls.org/events/) etkinliklerinden birine katılıyorsanız:
+
+* Atölye'de, atölye gününden önce "kurulum partisi" olabilir. Eğer kurulum partisindeysen, bu sayfa senin için! Atölye için gerekli olacak kurulumları tamamlamak için buradaki talimatları takip et. Eğer ihtiyacın varsa koçlarının yardımını alabilirsin. Daha sonra atölye gününde, kılavuzdaki kurulum talimatlarını atlayabilirsiniz.
+* Atölyedeki organizatörler senden atölye gününden önce evde bilgisayarına her şeyi kurmanı isteyebilir. Eğer böyle bir istekle karşılaştıysan, bu sayfa senin için! Buradaki talimatları elinden geldiğince izle. Eğer gerekli kurulumları yapamadıysanız, daha sonra atölye günü kılavuzdaki kurulum adımına ulaştığınızda koçunuzdan yardım alabilirsiniz.
+* Atölyenizde bir kurulum partisi yoksa (veya katılamadıysanız) ve organizatörler sizden atölye gününden önce her şeyi kurmayı denemenizi istemedilerse, bu sayfayı atlayın ve doğruca [İnternet nasıl çalışır](../how_the_internet_works/README.md) bölümüne gidin. Kılavuz boyunca çalışırken ihtiyacınız olan her şeyi yükleyeceksiniz.
+
+# Kurulum
+
+Bu kılavuzda bir blog geliştireceksiniz. Bunu yapmak için, kılavuz boyunca bilgisayarınıza çeşitli yazılımların nasıl kurulacağı ve gerektiğinde bazı çevrimiçi hesaplarına nasıl kaydolunacağı konusunda bilgilendirileceksiniz. Bu sayfa, tüm kurulum ve kaydolma talimatlarını tek bir yerde toplar (bu yöntem bazı atölye formatları için kullanışlıdır).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Aşağıdaki adımların çoğu, "konsol", "terminal", "komut penceresi" veya "komut satırı" na atıfta bulunur - bu terimlerin hepsi aynı anlama gelir: bilgisayarınızda komutları girebileceğiniz bir pencere. Ana kılavuza ulaştığınızda, komut satırı hakkında daha fazla bilgi edinebilirsiniz. Şimdilik, bilmeniz gereken en önemli şey bir komut penceresinin nasıl açılacağı ve nasıl göründüğüdür: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Python'ı Yükleyin {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Bir kod düzenleyicisi yükleyin {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Git'i yükleyin {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+[GitHub.com](https://www.github.com)'a gidin ve ücretsiz yeni bir kullanıcı hesabı oluşturun. Şifrenizi hatırladığınızdan emin olun (eğer şifrenizi yöneticisi kullanıyorsanız, yöneticinize ekleyin).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Okumaya başlayın
+
+Tebrikler, ayarlarınız tamam ve hazırsınız! Eğer atölyeden önce hala vaktiniz var ise, başlangıç bölümlerinden bazılarını okumanız yararlı olacaktır:
+
+* [İnternet nasıl çalışır](../how_the_internet_works/README.md)
+
+* [Komut satırına giriş](../intro_to_command_line/README.md)
+
+* [Python'a giriş](../python_introduction/README.md)
+
+* [Django nedir?](../django/README.md)
+
+# Çalışmanın tadına varın!
+
+Atölyeye başladığınızda doğrudan [İlk Django projen!](../django_start_project/README.md) bölümüne gidebilirsiniz çünkü çoktan önceki bölümlerde bu konuları çözdük.
\ No newline at end of file
diff --git a/tr-TR/intro_to_command_line/README.md b/tr-TR/intro_to_command_line/README.md
new file mode 100644
index 00000000000..7b817ba1630
--- /dev/null
+++ b/tr-TR/intro_to_command_line/README.md
@@ -0,0 +1,440 @@
+# Komut satırı arayüzüne giriş
+
+> Evden okuyanlar için: Bu bölüm [ Yeni arkadaşınız: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) videosu içinde anlatıldı.
+
+Heyecanlı değil mi?! Birkaç dakika içinde ilk kod satırınızı yazacaksın! :)
+
+**Sizi yeni arkadaşınızla tanıştıralım: komut satırı!**
+
+Gelecek aşamalar size tüm "hacker"ların kullandığı siyah pencerenin nasıl kullanıldığını gösterecek. Başta biraz korkutucu görünebilir fakat bu sadece sizden komut bekleyen bir pencere.
+
+> **Not** Lütfen kitap boyunca 'dizin' ve 'klasör' terimlerini birbirinin yerine kullandığımızı ve aynı anlama geldiklerini not unutmayın.
+
+## Komut satırı nedir?
+
+Genellikle **komut satırı** veya **komut satırı arabirimi** adı verilen pencere, bilgisayarınızdaki dosyaları görmek, düzenlemek ve yönetmek için kullanılan metin tabanlı bir uygulamadır. Bu tıpkı windows gezgini yada mac'teki finder gibi fakat grafiksel arayüzü olmadan. Komut satırının diğer adları: *cmd*, *CLI*, *komut istemcisi*, *konsol* veya *terminal (uçbirim)*dir.
+
+## Komut satırı arabirimini açın
+
+Birkaç deneme yapmak için öncelikle komut satırı arabirimini açmamız gerekir.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## İstemci
+
+Şimdi komutlarınızı bekleyen beyaz veya siyah bir pencere görmelisiniz.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Eğer Mac veya Gnu/Linux kullanıyorsanız, yüksek ihtimalle `$` işareti göreceksiniz, tıpkı bunun gibi:
+
+{% filename %}komut satırı{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Windows'da ise `>` işareti göreceksiniz, bunun gibi:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Hemen şimdi hemen yukarıdaki Linux bölümüne bir göz atın - daha sonra bu kılavuzda PythonAnywhere'e gittiğinizde buna benzer bir şey göreceksiniz.
+
+<!--endsec-->
+
+Her komutun başında `$` ya da `>` ve bir boşluk vardır fakat bu kısmı yazmak zorunda değilsiniz. Bilgisayarınız bunu sizin için yapacaktır. :)
+
+> Küçük bir not: sizin durumunuzda komut isteminden önce `C:\Users\ola>` veya `Olas-MacBook-Air:~ ola$` gibi ifadeler olabilir, bu durumda kesinlikle sorun yok.
+
+Başında `$` veya `>` içeren kısımlar *komut satırı istemi* veya kısaca *komut istemi*'dir. Buraya bir şey girmenizi ister.
+
+Bu kılavuzda bir komut girmeniz istendiğinde, örnek komutlarda genellikle sol tarafa `$` ya da `>` ekleyeceğiz. Sol taraftaki bu kısmı göz ardı edebilir ve işlemi başlatan komutu girebilirsiniz.
+
+## İlk komutunuz (Yaşasın!)
+
+Aşağıdaki komutu yazarak başlayalım:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}komut satırı{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+Ve ardından `enter` tuşuna basın. Sonucumuz bu:
+
+{% filename %}komut satırı{% endfilename %}
+
+    $ whoami zeynep
+    
+
+Gördüğünüz gibi bilgisayar kullanıcı adınızı yazdı. Şahane, değil mi ? :)
+
+> Her komutu yazmaya çalışın; kopyala - yapıştır yapmayın. Böylece daha akılda kalıcı olur!
+
+## Temeller
+
+Her işletim sistemi komut satırı için birbirinden biraz farklı komutlar kullanır, bu nedenle işletim sisteminize uygun yönergeleri izlediğinizden emin olun. Hadi deneyelim mi?
+
+### Geçerli Dizin
+
+Şimdi nerede olduğumuzu bilmek güzel olurdu, değil mi? Bakalım. Bu komutu yazın ve `enter` tuşuna basın:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/zeynep
+    
+
+> Not: 'pwd'nin anlamı 'print working directory' yani 'çalışma dizinini yazdır'dır.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\zeynep
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+Muhtemelen makinenizde benzer bir yazı göreceksiniz. Komut satırını açtığınızda genellikle kullanıcınızın ev dizininde başlarsınız.
+
+* * *
+
+### Komut hakkında daha fazla bilgi edinin
+
+Komut istemine yazabileceğiniz birçok komut görüntüleyebileceğiniz ve okuyabileceğiniz yerleşik bir yardım açıklaması sunar! Örneğin, geçerli dizin 'cd' komutu hakkında daha fazla bilgi edinmek için:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X ve Linux, komutlar hakkında size yardımcı olan bir `man` komutuna sahiptir. `man pwd`'yi deneyin ve ne yazdığını görün ya da diğer komutların önüne `man` koyup diğerleri hakkındaki yardımları görün. `man` komutunun çıktısı genellikle sayfa gibidir. Bir sonraki sayfaya geçmek için boşluk çubuğunu ve yardımdan çıkmak için `q` tuşunu kullanın.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Çoğu komutun sonuna `/?` ekleyince, yardım sayfasını gösterir. Yardım sayfasının tümünü görmek için komut pencerenizi yukarı kaydırmanız gerekebilir. `cd /?` komutunu deneyin.
+
+<!--endsec-->
+
+### Dosya ve dizinleri listele
+
+Yani içeride ne var? Bilmek harika olurdu. Haydi bakalım:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Uygulamalar
+    Masaüstü
+    İndirilenler
+    Müzik
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Geçerli dizini değiştir
+
+Şimdi, haydi Masaüstü dizinimize gidelim:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Masaüstü
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Unutmayın "Desktop" dizinin adı Linux hesabınızın diline çevrilmiş olabilir. Bu durumda, `Desktop` yerine çevrilmiş ismi kullanmanız gerekecek. Örneğin; Türkçe için `Masaüstü`.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Gerçekten değişmiş mi bir bakalım:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+İşte oldu!
+
+> Profesyonel İpucu: Eğer `cd D` yazarsanız ve klavyenizden `tab` tuşuna basarsanız, komut satırı ismin geri kalanını tamamlar ve daha hızlı gezersiniz. Eğer "D" ile başlayan birden fazla klasör varsa, diğer seçenekleri görmek için `tab` tuşuna iki kez basın.
+
+* * *
+
+### Dizin oluşturun
+
+Masaüstünüzde bir uygulama dizin oluşturmaya ne dersiniz? Bu şekilde yapabilirsiniz:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir uygulama
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir uygulama
+    
+
+<!--endsec-->
+
+Bu küçük komut masaüstünüzde `uygulama` isimli bir klasör oluşturacaktır. Masaüstünü bakarak olup olmadığını kontrol edebilirsiniz ya da `ls` veya `dir` komutlarını kullanabilirsiniz! Deneyin. :)
+
+> Profesyonel ipucu: Eğer aynı komutları tekrar tekrar yazmak istemiyorsanız, `yukarı ok` ve `aşağı ok` tuşlarına basarak en son kullandığınız komutlar arasında geçiş yapabilirsiniz.
+
+* * *
+
+### Alıştırma!
+
+Sizin için ufak bir alıştırma: yeni oluşturduğunuz `uygulama` dizininde `test` adında bir dizin oluşturun. (`cd` ve `mkdir` komutlarını kullanın.)
+
+#### Çözüm:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd uygulama
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Tebrikler! :)
+
+* * *
+
+### Temizlik
+
+Ortalığı dağınık bırakmak istemeyiz, haydi yaptığımız her şeyi silelim.
+
+İlk önce Masaüstü'ne dönmemiz gerek:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+`cd` komutu ile `..` kullanmak sizi geçerli dizinin bir üst dizinine götürür (bu şu anki dizinin ana dizinidir).
+
+Nerede olduğunuzu kontrol edin:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}komut satırı{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Şimdi `uygulama` dizinini silme vakti:
+
+> **Dikkat**: `del`, `rmdir` veya `rm` komutları kullanılarak yapılan silme işlemleri geri alınamaz, bunun anlamı: *silinen dosyalar sonsuza dek yok olur*! Yani bu komutları kullanırken çok dikkatli olun.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}komut satırı{% endfilename %}
+
+    $ rm -r uygulama
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Bitti! Gerçekten silindiğinden emin olalım:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}komut satırı{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Çıkış
+
+Şimdilik bu kadar! Şimdi komut satırını güvenle kapatabilirsiniz. Bunu "hacker" tarzında yapalım, tamam mı? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Harika, değil mi? :)
+
+## Özet
+
+İşte bazı yararlı komutların özeti:
+
+| Komut (Windows)  | Komut (Mac OS - GNU/Linux) | Açıklama                | Örnek                                              |
+| ---------------- | -------------------------- | ----------------------- | -------------------------------------------------- |
+| exit             | exit                       | pencereyi kapatır       | **exit**                                           |
+| cd               | cd                         | dizin değiştir          | **cd test**                                        |
+| cd               | pwd                        | geçerli dizini göster   | **cd** (Windows) veya **pwd** (Mac OS / Linux)     |
+| dir              | ls                         | dizin/dosyaları listele | **dir**                                            |
+| copy             | cp                         | dosya kopyala           | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move             | mv                         | dosya taşı              | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir            | mkdir                      | yeni bir dizin oluştur  | **mkdir testdizini**                               |
+| rmdir (veya del) | rm                         | dosyayı silin           | **del c:\test\test.txt**                         |
+| rmdir /S         | rm -r                      | klasörü siliniz         | **rm - r testdizini**                              |
+| [CMD] /?         | man [CMD]                  | komut için yardım al    | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+Bunlar komut satırında çalıştırabileceğiniz komutlardan sadece birkaçı, fakat bugün bundan daha fazlasını kullanmayacaksınız.
+
+Eğer merak ediyorsanız, [ss64.com](http://ss64.com) adresinden tüm işletim sistemleri için tüm komutların kullanımına ulaşabilirsiniz.
+
+## Hazır mısınız?
+
+Haydi Python'a giriş yapalım!
\ No newline at end of file
diff --git a/tr-TR/intro_to_command_line/open_instructions.md b/tr-TR/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..96e09c33a3a
--- /dev/null
+++ b/tr-TR/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Windows sürümünüze ve klavyenize bağlı olarak, aşağıdaki seçeneklerden birinin bir komut penceresi açması gerekir (biraz deneme yapmanız gerekebilir, ancak tüm önerileri denemeniz gerekmez):
+
+- Başlat menüsüne veya ekranına gidin ve arama alanına "Komut İstemcisi" girin.
+- Başlat'a gidin → Windows sistemi → Komut istemcisi.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Sonra bu eğitimde aynı anda iki komut penceresi açma ihtiyacınız olacak. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Şimdi bunu bilgisayarınızda deneyin ve ne olduğuna bakın! Eğer bir tane komut penceresi varsa, aşağıdaki listede bulunan yöntemlerden birini deneyin. En azından bir tanesi yeni bir komut penceresi açılmasını sağlayacaktır.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Uygulamalar→ Araçlar → Terminal yolunu takip edin.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Muhtemelen Uygulamalar → Aksesuarlar → Terminal ya da Uygulamalar → Sistem → Terminal altındadır, nerede olduğu sisteminize bağlıdır. Eğer orada değilse, Google'da arayabilirsiniz. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/tr-TR/python_installation/README.md b/tr-TR/python_installation/README.md
new file mode 100644
index 00000000000..91ef2a4197f
--- /dev/null
+++ b/tr-TR/python_installation/README.md
@@ -0,0 +1,15 @@
+# Hadi Python ile başlayalım
+
+Nihayet buradayız!
+
+Fakat önce, size Python'un ne olduğunu açıklayalım. Python web siteleri, oyunlar, bilimsel yazılımlar, grafikler ve çok daha fazlasını oluşturmak için kullanılan bir programlama dilidir.
+
+Python'un kökleri 1980'li yılların sonlarına dayanmaktadır ve ana hedefi sadece makineler değil insanlar tarafından da okunabilir olmaktır. Bu nedenle öbür programlama dillerinden daha basit görünür, ama merak etmeyin - Python da hakikaten güçlü!
+
+# Python kurulumu
+
+> **Not** Eğer Chromebook kullanıyorsanız bu bölümü geçin ve [Chromebook Kurulumu](../chromebook_setup/README.md)'daki talimatları takip edin.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/tr-TR/python_installation/instructions.md b/tr-TR/python_installation/instructions.md
new file mode 100644
index 00000000000..cd8a7447c9f
--- /dev/null
+++ b/tr-TR/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Evdeki okuyucular için: bu bölüm [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) isimli videoda anlatılmıştır.
+> 
+> Bu bölüm Geek Girls Carrots (https://github.com/ggcarrots/django-carrots) tarafından hazırlanmış bir öğreticiye dayanmaktadır
+
+Django, Python dilinde yazılmıştır. Django'da herhangi bir şey yapmak için Python'a ihtiyaç duyarız. Hadi Python'ın kurulumunu yaparak başlayalım! Sizden Python 3 en son sürümünü yüklemenizi istiyoruz. Yani, eğer daha önceki bir sürüme sahipseniz, güncellemeniz gerekecek. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Lütfen bilgisayarınızda Anaconda yüklü olsa bile normal Python'u aşağıdaki gibi kurun.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Öncelikle, bilgisayarınızın Sistem Bilgisi sayfasındaki "Sistem türü" satırından, Windows'un 32 bit mi yoksa 64 bit mi olduğunu kontrol edin. Bu sayfaya ulaşmak için aşağıdaki yöntemlerden birini deneyin:
+
+* Windows tuşuna ve Pause/Break tuşuna aynı anda basın
+* Windows menüsünden Denetim Masası'nı açın, ardından Sistem & Güvenlik, ardından Sistem seçeneğine gidin
+* Windows düğmesine basın, ardından Ayarlar> Sistem> Hakkında'ya gidin
+* Windows Başlat menüsünde "Sistem Bilgileri"ni arayın. Bunu yapmak için, Başlat düğmesine tıklayın veya Windows tuşuna basın, sonra `Sistem Bilgileri` yazmaya başlayın. Yazdığınız anda önerilerde bulunmaya başlayacaktır. Girişi göründüğünde seçebilirsiniz.
+
+Windows için Python'ı https://www.python.org/downloads/windows/ adresinden indirebilirsiniz. "Latest Python 3 Release - Python x.x.x" bağlantısına tıklayın. Eğer bilgisayarınız **64-bit** versiyon Windows çalıştırıyorsa, **Windows x86-64 executable installer**'ı indirin. Değilse, **Windows x86 executable installer**'ı indirin. Yükleyiciyi indirdikten sonra, çalıştırmalısınız (üzerine çift tıklayarak) ve oradaki talimatları takip etmelisiniz.
+
+Dikkat edilmesi gereken nokta: Yükleme esnasında "Setup" ("Kur") işaretli bir pencere farkedeceksiniz. Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+Kurulum tamamlandığında, Python veya yüklediğiniz sürüm hakkında daha fazla bilgi edinmeniz için bir bağlantı içeren bir iletişim kutusu görebilirsiniz. Bu iletişim kutusunu kapatın ya da iptal edin - bu kılavuzda daha fazla şey öğreneceksiniz!
+
+Not: Windows'un daha eski bir sürümünü (7, Vista veya herhangi bir eski sürüm) kullanıyorsanız ve Python {{ book.py_version }} yükleyici bir hata ile başarısız olursa, tüm Windows Güncellemelerini yükleyin ve Python'u yeniden yüklemeyi deneyin. Hala hatayla karşılaşıyorsanız, [Python.org](https://www.python.org/downloads/windows/) adresinden {{ book.py_min_release }} Python sürümünü yüklemeyi deneyin.
+
+> Django {{ book.django_version }}, Windows XP veya önceki sürümleri desteklemeyen Python {{ book.py_min_version }} veya üstüne ihtiyaç duyar.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* *Mac OS X 64-bit/32-bit installer* dosyasını indirin,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+Python'un farklı bir sürümüne sahipseniz, en azından {{ book.py_min_version }} (örneğin, {{ book.py_min_release }}), o zaman yükseltmeniz gerekmez. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/tr-TR/python_introduction/README.md b/tr-TR/python_introduction/README.md
new file mode 100644
index 00000000000..b034c6877cd
--- /dev/null
+++ b/tr-TR/python_introduction/README.md
@@ -0,0 +1,1073 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Python'a giriş
+
+> Bu bölümün bir kısmı Geek Girls Carrots tarafından hazırlanmış eğitimlere dayanılarak hazırlanmıştır (https://github.com/ggcarrots/django-carrots).
+
+Biraz kod yazalım!
+
+## Python komut istemi (prompt)
+
+> Evdeki okuyucular için: Bu kısım [Python Temelleri: Tamsayılar, Dizeler, Listeler, Değişkenler ve Hatalar](https://www.youtube.com/watch?v=MO63L4s-20U) videosunda bulunabilir.
+
+Python'la oynamaya başlamadan önce bilgisayarımızda bir *komut satırı* açmamız gerekiyor. Bunu zaten nasıl yapacağınızı artık biliyorsunuz, [Komut satırına giriş](../intro_to_command_line/README.md) bölümünde öğrenmiştiniz.
+
+Hazır olduğunuzda, aşağıdaki talimatları takip edin.
+
+Bir Python konsolu açmak istiyoruz; öyleyse Windows'ta `python`, Mac OS/Linux'ta `python3` yazıp, `enter`'a basın.
+
+{% filename %}komut satırı{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## İlk Python komutunuz!
+
+Python komutunu çalıştırdıktan sonra, komut istemi `>>>` şeklinde değişti. Bizim için bu, şimdi yalnızca Python dilinde komutlar kullanabileceğimiz anlamına geliyor. `>>>` yazmanıza gerek yok - Python bunu sizin için yapacak.
+
+Eğer herhangi bir zamanda Python komut satırından çıkmak isterseniz, yalnızca `exit()` yazmanız ya da Windows için `Ctrl + Z`, Mac/Linux için `Ctrl + D` kısa yolunu kullanmanız yeterli. Bunu yaptığınız taktirde artık `>>>` yazısını görmeyeceksiniz.
+
+Şimdilik, Python konsolundan çıkmak istemiyoruz. Bu konuda daha fazla bilgi edinmek istiyoruz. Biraz matematik yazarak başlayalım (` 2 + 3 ` gibi) ve `enter` 'a basalım.
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Güzel! Cevap nasıl da çıktı görüyor musun? Python matematik biliyor! Sen de diğer komutları şöyle deneyebilirsin:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Üstel hesaplama yapmak için 2 üzeri 3 deyin, şöyle yazalım: {% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Bunları biraz kurcalayıp eğlen, sonra tekrar burada buluşalım. :)
+
+Gördüğün gibi Python çok iyi bir hesap makinesi. Eğer başka neler yapabileceğini merak ediyorsan...
+
+## String'ler (dizeler)
+
+Mesela ismin? İsmini tırnak işaretleri içerisinde şu şekilde yaz:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> "Zeynep"
+'Zeynep'
+```
+
+İlk string'ini oluşturdun! String (dize), bilgisayar tarafından işlenebilen ve karakterlerden oluşan dizilerin genel adıdır. Bir string her zaman aynı özel karakterle başlamalı ve aynı özel karakterle bitmelidir. Tek tırnak (`'`) veya çift tırnak (`"`) olabilir (aralarında herhangi bir fark yok!). Tırnak işaretleri Python'da içlerinde olan şeyin bir string olduğunu ifade eder.
+
+Stringler birbirlerine eklenebilir. Şunu dene:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> "Merhaba " + "Zeynep"
+'Merhaba Zeynep'
+```
+
+Ayrıca stringleri bir sayı ile çarpabilirsin:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> "Zeynep" * 3
+'ZeynepZeynepZeynep'
+```
+
+Eğer stringinin içerisine bir tırnak işareti koymak istiyorsan, bunun için iki seçeneğin var.
+
+Çift tırnak kullanarak:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> "Turgut Uyar'ın dizeleriyiz"
+"Turgut Uyar'ın dizeleriyiz"
+```
+
+veya backslash (` \ `) kullanarak:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> 'Turgut Uyar\'ın dizeleriyiz'
+"Turgut Uyar'ın dizeleriyiz"
+```
+
+Hoş değil mi? İsminin tamamını büyük harf yapmak için, sadece şunu yazman yeterli:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> "Zeynep".upper()
+'ZEYNEP'
+```
+
+String'in üzerinde `upper` **fonksiyon**unu kullandın! Bir fonksiyon (`upper()` gibi), çağırıldığında (calling) Python'un girdi olarak verilen bir obje (`"Zeynep"`) üzerinde gerçekleştirmesi gereken bir dizi işleme denilir.
+
+Eğer ismindeki harflerin sayısını öğrenmek istiyorsan bunun için de bir **fonksiyon** var!
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> len("Zeynep")
+6
+```
+
+Fonksiyonları neden bazen stringin sonunda bir `.` ile (`"Zeynep".upper()` gibi) ve bazen de önce fonksiyonu çağırıp sonra parantez içerisine stringi yazarak kullandığımızı merak ediyor musun? Pekala, bazı durumlarda, fonksiyonlar bir takım nesnelere aittirler, mesela `upper()`, yalnızca stringler üzerinde kullanılabilir. Böyle durumlarda, bu tarz fonksiyonlara biz **method** ismini veriyoruz. Diğer durumlarda, bir fonksiyon özel olarak bir nesneye ait olmayıp, farklı çeşitlerde nesneler üzerinde de kullanılabilir, aynı `len()` gibi. İşte bu nedenle `"Zeynep"` stringini `len` fonksiyonuna bir parametre olarak veriyoruz.
+
+### Özet
+
+Tamam, stringlerden yeterince bahsettik. Şu ana kadar şu konuları öğrendin:
+
+- **komut istemi** – komutları (kod) Python'un komut istemine yazdığınızda Python'da sonuçlandırarak yanıtlar üretir
+- **sayılar ve dizeler** – Python'da sayılar matematik için dizeler ise metin nesneleri için kullanılmaktadır
+- **operatörler** `+` ve `*` gibi, değerleri birleştirerek yeni bir değer üretmek için kullanılmaktadır
+- **fonksiyonlar** `upper()` ve `len()` gibi, nesneler üzerinde eylemler gerçekleştirmektedirler.
+
+Bunlar öğreneceğiniz her programlama dilinin temelleri. Biraz daha zor bir şey için hazır mısın? İddiaya gireriz öylesin!
+
+## Hatalar
+
+Şimdi yeni bir şey deneyelim. Bir sayının uzunluğunu, bir string'in uzunluğunu bulduğumuz gibi bulabilir miyiz? Bunu görmek için `len(304023)` yazıp `enter` a basalım:
+
+{% filename %}{{ warning_icon }} komut satırı{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+İlk hatamızı aldık! {{ warning_icon }} ikonu çalıştırmak üzere olduğunuz programın beklediğiniz gibi çalışmayacağı konusunda sizi ikaz eder. Hatalar yapmak (kasıtlı olanlar bile) öğrenmenin önemli bir kısmı!
+
+Nesne türü "int" (tam sayılar, tüm sayılar) in uzunluğu olmadığını söylüyor. Şimdi ne yapabiliriz? Belki de rakamı bir string olarak yazabiliriz? Stringlerin bir uzunluğu var, değil mi?
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+İşe yaradı! `str` fonksiyonunu `len` fonksiyonunun içinde kullandık. `str` her şeyi string'e çeviriyor.
+
+- `str` fonksiyonu, değişkenleri **stringe** çeviriyor
+- `int` fonksiyonu değişkenleri **integera** çeviriyor
+
+> Önemli: Sayıları metin durumuna getirebiliriz ama metni sayılar durumuna tam olarak getiremeyebiliriz - yine de `int('hello')` olsa ne olurdu?
+
+## Değişkenler
+
+Programlamada en önemli konulardan biri değişkenlerdir. Değişken (variable), daha sonra kullanmak istediğiniz bir yapıya verdiğiniz isimdir. Programcılar değişkenleri verileri tutmak ya da kodlarını daha okunabilir ve anlaşılabilir kılmak için kullanırlar ve böylece her şeyi sürekli akıllarında tutmaya gerek kalmaz.
+
+`name` adında bir değişken yaratmak istediğimizi varsayalım:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> name = "Ayşe"
+```
+
+name (isim) eşittir "Ayşe" yazalım.
+
+Farkettiğiniz gibi, program daha öncekilerinin aksine bu kez hiçbir cevap vermedi. O zaman böyle bir değişkenin gerçekten tanımlı olduğunu nasıl bilebiliriz? Basitçe, `name` yazıp `enter` tuşuna basalım:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> name
+'Ayşe'
+```
+
+Yaşasın! İşte bu senin ilk değişkenin! :) Bu değişkenin işaret ettiği şeyi her zaman değiştirebilirsin:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> name = "Suzan"
+>>> name
+'Suzan'
+```
+
+Bu değişkeni fonksiyonlar içinde de kullanabilirsin:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Harika değil mi? Tabii ki değişkenler, sayılar da dahil herhangi bir şey olabilir. Şunu deneyin:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Peki ya değişkenin adını yanlış kullanırsak? Ne olacağını tahmin ediyor musun? Deneyelim!
+
+{% filename %}{{ warning_icon }} komut satırı{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Bir hata! Gördüğünüz gibi, Python birçok hata çeşidine sahip ve bu hatanın adı **NameError**, yani İsimlendirme Hatası. Tanımlamadığınız bir değişkenin adını kullanmaya çalışırsanız, Python size bu hatayı verir. Eğer bu hata ile daha sonra karşılaşırsanız, kodunuzdaki değişkenlerin adını doğru yazıp yazmadığınızı kontrol edin.
+
+Bununla biraz oynayıp, neler yapabildiğinizi görün!
+
+## Yazdırma (Print) İşlevi
+
+Şunu deneyin:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> name = 'Merve'
+>>> name
+'Merve'
+>>> print(name)
+Merve
+```
+
+Sadece `name` yazdığınız zaman, Python yorumlayıcısından 'name' değişkeninin dize olarak *temsili* döner, yani tek tırnaklar içine alınmış M-e-r-v-e harfleri. Eğer `print(name)` derseniz Python ekrana değişkenin içeriğini yazdıracaktır, bu kez tırnaklar olmaksızın, daha temiz biçimde.
+
+Daha ileride göreceğimiz gibi `print()`, işlevlerin içindeyken bir şey yazdırmak istediğimizde ya da bazı şeyleri birden fazla satırda yazdırmak istediğimizde de kullanışlıdır.
+
+## Listeler
+
+Python, string (dize) ve integerın (tam sayı) yanı sıra, çok değişik türlerde nesnelere sahiptir. Şimdi, **liste** türünü tanıtacağız. Listeler tam da düşündüğünüz gibidir: diğer nesnelerin listesi olan nesne. :)
+
+Yeni bir liste yaratmakla devam edelim:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Evet, liste boş. Çok kullanışlı sayılmaz, değil mi? Hadi loto numaralarıyla liste oluşturalım. Sürekli kendimizi tekrar etmek istemeyiz, o yüzden listeyi değişkene atayalım:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+Pekala, listeyi oluşturduk! Onunla ne yapabiliriz? Hadi listede kaç tane loto numarası olduğunu görelim. Hangi fonksiyonu kullanman gerektiği hakkında bir fikrin var mı? Zaten bildiğin bir fonksiyon!
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Evet! `len()` listedeki nesne sayısını verir. Kullanışlı, değil mi? Belki de şu an listeyi sıralarız:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Bu hiçbir cevap vermez, sadece listedeki numaraların sırasını değiştirir. Şimdi listeyi yazdıralım ve ne olduğunu görelim:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Gördüğünüz gibi, listedeki sayılar artık küçükten büyüğe sıralı. Tebrikler!
+
+Belki de sıralamayı ters çevirmek isteriz? Hadi yapalım!
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+Kolay, değil mi? Listeye yeni bir eleman eklemek isterseniz, şu komutu yazarak yapabilirsiniz:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Sadece listedeki ilk elemanı göstermek isterseniz, **indexes** (indeksler) ile yapabilirsiniz. İndeks elemanın listede nerede olduğunu belirten numaradır. Programcılar sıfırdan başlamayı tercih ederler, bu yüzden listedeki ilk eleman listenin 0. indeksindedir, sonraki 1. indeksindedir ve böyle devam eder. Şunu deneyin:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Gördüğünüz gibi, listedeki nesnelere listenin ismi ve köşeli parantez içindeki nesnenin indeksini kullanarak ulaşabilirsin.
+
+Listenizden bir şeyler silmek için, yukarıda öğrendiğimiz gibi **indeksleri** ve `pop()` metodunu kullanmamız gerekecektir. Bir örnekle öğrendiklerimizi pekiştirelim; listeden ilk numarayı sileceğiz.
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Kusursuz çalıştı!
+
+Daha fazla eğlence için diğer indeksleri de deneyin: 6, 7, 1000, -1, -6 veya -1000. Denemeden önce komutların sonuçlarını tahmin etmeye çalışın. Sonuçlar mantıklı mıydı?
+
+Bütün liste fonksiyonlarını Python dökümantasyonunun bu bölümünde bulabilirsin: https://docs.python.org/3/tutorial/datastructures.html
+
+## Sözlükler (Dictionaries)
+
+> Evdeki okuyucular için: Bu kısım [Python Temelleri: Sözlükler](https://www.youtube.com/watch?v=ZX1CVvZLE6c) videosunda işlenmiştir.
+
+Sözlük listeye benzerdir ancak sözlük değerlerine indeks yerine anahtar ile ulaşılır. Anahtar metin veya numara olabilir. Boş bir sözlük oluşturmak için kullanılan söz dizimi şudur:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Bu boş bir sözlük oluşturduğunuzu gösterir. Yaşasın!
+
+Şimdi, bu komutu yazmayı deneyin (kendi bilgilerinizle değiştirmeyi deneyin):
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ayşe', 'country': 'Türkiye', 'favorite_numbers': [7, 42, 92]}
+```
+
+Bu komutla, üç anahtar-değer çifti ile `participant` (katılımcı) isminde bir değişken oluşturdunuz:
+
+- Anahtar `name` `'Ayşe'` (`string` nesnesi) değerine işaret eder,
+- `country` `Türkiye` (bir diğer `string`) değerine),
+- ve `favorite_numbers` `[7, 42, 92]` (3 numaralı bir `list`) değerine işaret eder.
+
+Bu söz dizimi ile tek bir anahtarın içeriğini kontrol edebilirsin:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ayşe
+```
+
+Gördünüz mü, bu listeye benzer. Fakat indeksi hatırlamanıza gerek yok - sadece ismini hatırlayın.
+
+Python'a olmayan bir anahtarın değerini sorarsak ne olur? Tahmin edebiliyor musun? Hadi deneyip görelim!
+
+{% filename %}{{ warning_icon }} komut satırı{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Bir başka hata! **KeyError** hatası. Python yardımseverdir ve sana `'age'` anahtarının sözlükte bulunmadığını söyler.
+
+Ne zaman sözlük veya liste kullanmalısın? Düşünmek için güzel bir nokta. Sonraki satıra bakmadan önce cevap üzerinde bir düşünün.
+
+- Sıralı elemanlara mı ihtiyacın var? Liste ile devam et.
+- İleride hızlıca (anahtarlar ile) değerlere ulaşmak istediğin için anahtarlar ile ilişkilendirilmiş değerlere mi ihtiyacın var? Sözlük kullan.
+
+Sözlükler de listeler gibi değişebilirdir (*mutable*), yani oluşturulduktan sonra değiştirilebilirler. Oluşturulduktan sonra sözlüklere anahtar/değer çifti ekleyebilirsiniz, aşağıdaki gibi:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Umarım şu ana kadar mantıklı gelmiştir :) Sözlüklerle biraz daha eğlenceye hazır mısın? İlginç şeyler için sonraki satıra atla.
+
+Sözlükten bir maddeyi silmek için `pop()` metodunu kullanabilirsin. Mesela, `'favorite_numbers'` anahtarına karşılık gelen elemanı silmek istersen, şu komutu yaz:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> del participant['favorite_numbers']
+>>> participant
+{'country': 'Türkiye', 'favorite_language': 'Python', 'name': 'Ayşe'}
+```
+
+Çıktıdan görebildiğin gibi, 'favorite_numbers' anahtarına karşılık gelen anahtar-değer çifti silindi.
+
+Bunun yanı sıra, sözlükteki daha önce oluşturulmuş anahtarın değerini değiştirebilirsiniz. Şunu yazın:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> participant['country'] = 'Almanya'
+>>> participant
+{'country': 'Almanya', 'favorite_language': 'Python', 'name': 'Ayşe'}
+```
+
+Gördüğün gibi, `'country'` anahtarının değeri `'Türkiye'`den `'Almanya`'ya çevrildi. :) Heyecan verici değil mi? Yaşasın! Bir başka harika şey öğrendin.
+
+### Özet
+
+Harika! Şu an programlama hakkında birçok şey biliyorsun. Bu kısımda, şunları öğrendin:
+
+- **errors** - eğer Python yazdığın komutu anlamazsa çıkan hataları nasıl okuyacağını ve anlayacağını artık biliyorsun
+- **değişkenler** - daha kolay kod yazmanı sağlayan ve kodunu daha okunabilir yapan nesnelerin isimleri
+- **listeler** - belirli bir sırada tutulan nesnelerin listesi
+- **sözlükler** - anahtar-değer çifti olarak tutulan nesneler
+
+Bir sonraki bölüm için heyecanlı mısınız? :)
+
+## Karşılaştırma
+
+> Evden okuyanlar için: Bu kısım [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) videosunda anlatılıyor.
+
+Programlamanın büyük kısmı karşılaştırma içerir. Karşılaştırması en kolay olan şey nedir? Tabi ki sayılar. Bakalım nasıl çalışıyor:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+Python'a karşılaştırmak için bazı sayılar verdik. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Güzel, ha?
+
+İki sayının eşit olup olmadığını öğrenmek için neden iki tane eşittir işraretini `==` yan yana koyduk? Değişkenlere içerik verirken, tek `=` işaretini kullanıyoruz. Her zaman ama **her zaman** ikisini birden koyman gerekir – `==` – eğer birbirlerine eşit olup olmadıklarını kontrol etmek isterseniz. Sayıların birbirine eşit olmaması durumunu da kontrol edebiliriz. Bunun için, yukarıdaki örnekteki gibi `!=` sembolünü kullanıyoruz. 
+
+Python' a iki görev daha verin:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+`>`‘ı ve `<`‘ı gördük, ama `>=` ve `<=` ne anlama geliyor? Onları böyle okuyabilirsin:
+
+- x `>` y : x büyüktür y
+- x `<` y : x küçüktür y
+- x `<=` y : x küçük eşittir y
+- x `>=` y : x büyük eşittir y
+
+Harika! Birkaç denemeye daha ne dersiniz? Şunu deneyin:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Python'a istediğiniz kadar sayıyı karşılaştırmak için verebilirsiniz, ve size hepsinin cevabını verecek. Çok akıllı değil mi?
+
+- **and** - Mantıkta kullandığımız "ve" anlamına geliyor, yani iki taraf da True, yani doğruysa, cevap da True olacak
+- **or** - Bu da "veya" anlamına geliyor, karşılaştırılan iki taraftan tek bir tanesi bile True ise bize True cevabını verecek
+
+Portakallarla elmaları karşılaştılaştırabilir miyiz? Bunun Python'daki eşdeğerini deneyelim: 
+
+{% filename %}{{ warning_icon }} komut satırı{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Geri görüş (en son çağrı):
+  Dosya "<stdin>", satır 1, <module>‘in içinde
+HataTürü: ‘>’ 'int' ve 'str' örnekleri arasında desteklenmiyor
+```
+
+Gördüğünüz gibi Python tam sayılar(`int`) ve kelimeleri(yani stringleri, `str`) karşılaştıramıyor. Onun yerine, **TypeError** göstererek iki farklı tipteki değişkenin karşılaştırılamayacağını söylüyor.
+
+## Boolean (Mantıksal)
+
+Bu arada, python'da yeni bir nesne türü öğrendin. Buna **Boolean** denir.
+
+Yalnızca iki Boolean nesnesi vardır:
+
+- True
+- False
+
+Python'un bunu anlaması için her zaman "True" (ilk harf büyük, geri kalanları küçük) yazmanız gerekiyor. **true, TRUE, tRUE işe yaramaz -- sadece True doğru.** (Aynısı "False" için de geçerli.)
+
+Boolean'lar değişken de olabiliyor! Bakınız:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Ayrıca bu şekilde de yapabilirsiniz:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Boolean'lar ile aşağıdaki komutları deneyerek biraz oynayın:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Tebrikler! Boolean'lar programlamadaki en havalı özelliklerden, ve az önce onları nasıl kullanmanız gerektiğini öğrendiniz!
+
+# Kaydet!
+
+> Evdeki okuyucular için: Bu kısım [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) videosunda işlenmiştir.
+
+Şimdiye kadar kodumuzu bizi sadece tek satır yazmaya limitleyen yorumlayıcı üzerinde yazdık. Normal programlar dosyalar içine kaydedilir ve programlama dilimizin **yorumlayıcısıyla** veya **derleyicisiyle** çalıştırılır. Şimdiye kadar programlarımızı Python **yorumlayıcısında** teker satır teker satır çalıştırdık. Bundan sonraki görevlerde, birden fazla satıra ihtiyacımız olacak, bu yüzden şunlara ihtiyacımız olacak:
+
+- Python yorumlayıcısından çıkın
+- Seçtiğiniz kod düzenleyicisini açın
+- Yeni Python dosyasına kod kaydedin
+- Çalıştırın!
+
+Kullandığımız Python yorumlayıcısından çıkmak için `
+exit() ` fonksiyonunu yazın
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Bu sizi komut satırına geri yönlendirecektir.
+
+Biraz önce [kod editörü](../code_editor/README.md) bölümünden bir kod editörü seçmiştik. Şimdi o editörü açıp ve yeni bir dosya içine kod yazmalıyız (eğer Chromebook kullanıyorsanız, Cloud IDE'de yeni bir dosya oluşturun ve dahil edilen kod editöründe dosyayı açın):
+
+{% filename %}editör{% endfilename %}
+
+```python
+print('Merhaba, Django girls!')
+```
+
+Açıkça, artık oldukça deneyimli Python programcısısın, bu yüzden bugün öğrendiğin kodları yazmaktan çekinme.
+
+Şimdi dosyayı tanımlayıcı bir isimle kaydetmemiz gerekir. Dosyanın ismine **python_intro.py** diyelim ve masaüstüne kaydedelim. Dosyaya istediğimiz ismi verebiliriz, burada önemli olan kısım dosyanın **.py** uzantısı ile bitmesidir. **.py** uzantısı işletim sistemimize bu dosyanın bir **python çalıştırılabilir dosyası** olduğunu ve Python'un bu dosyayı çalıştırabileceğini belirtiyor.
+
+> **Not** Kod editörleriyle ilgili en harika şeylerden birine dikkat etmelisiniz: renkler! Python konsolunda herşey aynı renkteydi; şimdi bakın `print` fonksiyonu dizeden farklı renkte. Bunun ismi "söz dizimi vurgulama" ve kod yazarken gerçekten yararlı bir özellik. Koddaki renkler ipucu verir, kapanmamış dizeler gibi ya da aşağıda göreceğimiz (`def` fonksiyonu gibi imla hatası içeren anahtar kelimeler olabilir). Bu kod düzenleyicisi kullanma nedenlerimizden biri. :)
+
+Dosyayı kaydettiğimize göre artık çalıştırabiliriz! Konsoldan **klasör değiştirme ** yaparak masaüstüne ulaşın, komut satırı bölümünde öğrendiklerinizi hatırlayın.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Mac'de bu komut şunun gibi görünecektir:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Linux'ta bunun gibi görünecektir:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+("Desktop" kelimesinin yerel dilinize çevrilebileceğini unutmayın.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+Windows Komut İstemi’nde bunun gibi olacak:
+
+{% filename %}komut satırı{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+Ve Windows Powershell’de bunun gibi olacak:
+
+{% filename %}komut satırı{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Takılırsanız, yardım isteyin. Eğitmenler bunun için var!
+
+Şimdi dosyadaki komutları çalıştırmak için Python'u kulllanın:
+
+{% filename %}komut satırı{% endfilename %}
+
+    $ python3 python_intro.py
+    Merhaba, Django girls!
+    
+
+Not: Windows'ta 'python3' bir komut olarak kullanılmaz. Onun yerine, dosyayı çalıştırmak için 'python'ı kullanın:
+
+{% filename %}komut satırı{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Tamamdır! Bir dosyaya kaydedilen ilk Python programınızı çalıştırdınız. Harika hissediyor musunuz?
+
+Şimdi programlamanın olmazsa olmaz bir aracını öğrenme zamanı:
+
+## If … elif … else
+
+Kodunuzdaki bir çok şey yalnızca belirli koşullar yerine getirildiğinde çalışmalıdır. İşte tam da bu yüzden Python'da **if deyimi** isminde bir yapı bulunuyor.
+
+**python_intro.py** dosyasındaki kodunuzu şununla değiştirin:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Eğer bunu kaydetmiş ve çalıştırmış olsaydık, bunun gibi bir hata görecektik:
+
+{% filename %}{{ warning_icon }} komut satırı{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python bizden `3 > 2` durumu (veya `True`) sağlandığında kendisine neyi çalıştıracağını söylememizi bekliyor. Python'a "Çalışıyor!" yazmasını söyleyelim. **python_intro.py** dosyanızdaki kodu şununla değiştirin:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('Çalışıyor!')
+```
+
+Sonraki kod satırında 4 tane boşluk karakteri bıraktığımıza dikkat ettiniz mi? Böylece if ifadesine yazılan durum doğru olduğunda neyi çalıştırması gerektiğini Python'a söylemiş oluyoruz. Aslında tek bir boşlukla da yapabilirsiniz, ama hemen hemen bütün Python programcıları kodlarının temiz görünmesi için 4 boşluk bırakıyor. Metin düzenleyiciniz ayarlıysa bir tab karakteri de 4 boşluk karakteri olarak sayılacaktır. Seçiminizi yaptıktan sonra değiştirmeyin! Eğer girintilerde 4 boşluk kullandıysanız, gelecek girintilerde de 4 boşluk kullanmaya devam edin - aksi halde sorunlarla karşılaşabilirsiniz.
+
+Kaydedip çalıştırmayı deneyelim:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+Çalışıyor!
+```
+
+Not: Windows'ta 'python3' komutunun geçerli olmadığını unutmayın. Bundan sonra dosyayı çalıştırmak için 'python3' komutunu yerine 'python' komutu kullanın.
+
+### Ya bir koşul True (Doğru) değilse?
+
+Önceki örneklerde kod sadece koşullar True (doğru) olduğunda çalışıyordu. Ama Python ayrıca `elif` ve `else` ifadelerine de sahip:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:    
+    print("5 gerçekten de 2'den büyüktür") 
+else:     
+    print("5  2'den büyük değildir")
+```
+
+Bu kod çalıştığında aşağıdaki çıktıyı verecektir:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 gerçekten de 2'den büyüktür
+    
+
+Eğer 2 5'ten büyük bir sayı olsaydı, ikinci komut çalıştırılmış olacaktı. Bakalım `elif` nasıl çalışıyor:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Zeynep'
+if name == 'Ayşe':
+    print('Selam Ayşe!')
+elif name == 'Zeynep':
+    print('Selam Zeynep!')
+else:
+    print('Selam yabancı!')
+```
+
+ve çalıştırılınca:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Selam Zeynep!
+    
+
+Gördünüz mü? Eğer önceki if koşulları başarısız olursa kontrol edilmek üzere `elif` ifadeleri ekleyebilirsiniz.
+
+`if` ifadesinden sonra istediğiniz kadar `elif` ifadesi ekleyebilirsiniz. Örneğin:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("Çok sessiz.")
+elif 20 <= volume < 40:
+    print("Güzel bir fon müziği")
+elif 40 <= volume < 60:
+    print("Harika, her notayı duyabiliyorum")
+elif 60 <= volume < 80:
+    print("Parti başlasın")
+elif 80 <= volume < 100:
+    print("Biraz gürültülü!")
+else:
+    print("Kulaklarım ağrıyor! :(")
+```
+
+Python sırayla her sorguyu çalıştırır ve sonucu ona göre yazar:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Harika, her notayı duyabiliyorum
+    
+
+## Yorumlar
+
+Yorumlar `#` ile başlayan satırlardır. İstediğiniz her şeyi `#` den sonra yazabilirsiniz ve Python onu gözardı edecektir. Yorumlar diğer insanların kodunuzu anlamasını kolaylaştırabilir.
+
+Bakalım nasıl gözüküyor:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Çok yüksek ya da çok düşük olduğunda ses seviyesini değiştirme
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+Kodun her satırı için bir açıklama yazmaya ihtiyacınız yoktur, ama kodunuzun niçin bir şey yaptığını açıklamak ya da kompleks bir şey yaptığınızda bir özet sunmak için yorumlar faydalıdırlar.
+
+### Özet
+
+En son yaptığınız alıştırmalarda öğrendikleriniz:
+
+- **kıyaslama yapmak** - Python'da `>`, `>=`, `==`, `<=`, `<` ve `ve`, `veya` operatörlerini kullanarak kıyaslama yapabilirsiniz
+- **Boolean** - İki farklı değer alabilen bir nesne tipidir: Ya `True` (doğru) olur ya da `False` (yanlış)
+- **Dosya kaydetmek** – kodlarımızı dosyalara kaydederek daha büyük programları çalıştırabiliriz.
+- **if ... elif ... else** - ifadelerini sadece belirli durumlar sağlandığında çalıştırmak istediğimiz komutlar için kullanabiliriz.
+- **yorumlar** - kodunuzu belgelemenize izin verecek şekilde Python’un çalışmayacağı satırlar
+
+Bu bölümün son kısmının zamanı geldi!
+
+## Kendi fonksiyonlarınız!
+
+> Evdeki okuyucular için: Bu kısım [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) videosunda işlenmiştir.
+
+Python'da çalıştırabileceğin `len()` gibi fonksiyonları hatırlıyor musun? Güzel, iyi haber - Şimdi kendi fonksiyonlarını nasıl yazacağını öğreneceksin!
+
+Fonksiyon Python tarafından işlenmesi gereken yönergeler dizisidir. Python'da her fonksiyon `def` anahtar kelimesi ile başlar, bir isim verilir ve bazı parameterleri olabilir. Hadi başlayalım. **python_intro.py** içindeki kodu aşağıdaki ile değiştirelim:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+python
+def hi():
+    print('Merhaba!')
+    print('Nasılsın?')
+
+hi()
+```
+
+Tamam, ilk fonksiyonumuz hazır!
+
+Fonksiyon adını neden dosyanın en altına yazdığımızı merak edebilirsiniz. `def hi():` ve ardından gelen girintili satırları yazdığımızda, bu, `hi()` işlevinin ne yapması gerektiğine ilişkin talimatlar yazıyoruz. Python bu talimatları okuyacak ve hatırlayacak, ancak henüz işlevi çalıştırmayacak. Python'a fonksiyonu çalıştırmak istediğimizi söylemek için, fonksiyonu `hi()` ile çağırmalıyız. Python dosyayı okur ve yukarıdan aşağıya doğru yürütür, bu yüzden onu çağırmadan önce dosyadaki işlevi tanımlamamız gerekir.
+
+Haydi şimdi bunu çalıştıralım ve neler olacağını görelim:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Merhaba!
+    Nasılsın?
+    
+
+Not: Eğer çalışmadıysa panik yapmayın! Çıktı hatanın neden olduğu hakkında bir fikir verir:
+
+- Eğer bir `NameError` alırsanız, muhtemelen yanlış bir şey yazdığınız anlamına gelir, bu nedenle `def hi():` lı fonksiyonu oluştururken ve `hi()` lıyı çağırırken aynı adı kullanıp kullanmadığınızı kontrol etmelisiniz.
+- Eğer bir `IndentationError` alırsanız,`print` dizelerinin her ikisinin de satır başında aynı boşluğa sahip olduğunu kontrol et: python fonksiyonun içindeki tüm kodların düzenli bir şekilde hizalanmasını ister.
+- Eğer tamamında da çıktı yoksa, son `hi()` *isn't* girintiliğini kontrol et - eğer öyleyse, bu dize fonksiyonunda bir parçası haline gelecek ve hiçbir zaman çalışmayacak.
+
+İlk fonksiyonumuzu parametrelerle birlikte oluşturalım. Önceki örneği - fonksiyonu çalıştıran kişiye merhaba diyen bir fonksiyon - bir isimle kullanacağız:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+Gördüğünüz gibi, fonksiyonumuza `name` (isim) adında bir parametre ekledik:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ayşe':
+        print("Merhaba Ayşe!')
+    elif name == 'Zeynep':
+        print('Merhaba Zeynep!')
+    else:
+        print('Merhaba yabancı!')
+
+hi()
+```
+
+Unutmayın: `if` durumu içerisindeki `print` fonksiyonundan önce dört tane boşluk var. Bunun sebebi sadece durum sağlandığında çalışmasını istememiz. Bakalım nasıl çalışıyor:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Üzgünüz, bir hata. Neyse ki, Python bize oldukça yararlı bir hata mesajı veriyor. `hi()` fonksiyonun (yukarıda tanımladığımız) bir değişken kullanımını gerektirdiğini (`name` isimli) ve bizim o değişkeni fonksiyonu çağırırken iletmeyi unuttuğumuzu söylüyor. Dosyanın alt kısmında hatayı düzeltelim:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ayşe")
+```
+
+Ve tekrar çalıştıralım:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Selam Ayşe!
+    
+
+Eğer ismi değiştirirsek ne olur?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Zeynep")
+```
+
+Ve çalıştırın:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Selam Zeynep!
+    
+
+Peki Ayşe veya Zeynep dışında başka bir isim yazdığımızda ne olacağını tahmin edebiliyor musunuz? Deneyin ve tahmininizin doğru olup olmadığını görün. Şunun gibi bir şey yazmalı:
+
+{% filename %}command-line{% endfilename %}
+
+    Selam yabancı!
+    
+
+Müthiş değil mi? Böylece fonksiyona göndereceğiniz isim değiştiğinde aynı kodu tekrar tekrar yazmanıza gerek kalmayacak. İşte fonksiyonlara tam da bu yüzden ihtiyacımız var - aynı kodu tekrar yazmayı istemeyiz!
+
+Hadi daha zekice bir şey yapalım - İkiden fazla isim var ve her biri için bir şart yazmak zor olur değil mi? Dosyanın içeriğini aşağıdakiyle değiştirin:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Merhaba ' + name + '!')
+
+hi("Seda")
+```
+
+Şimdi kodu çağıralım:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Merhaba Seda!
+    
+
+Tebrikler! Az önce fonksiyonları nasıl yazacağınızı öğrendiniz! :)
+
+## Döngüler
+
+> Evdeki okuyucular için: Bu kısım [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) videosunda işlenmiştir.
+
+Bu da zaten son kısım. Hızlı oldu, değil mi? :)
+
+Programcılar kendilerini tekrar etmeyi sevmezler. Programlama tamamen işleri otomatize etmedir, bu yüzden her insanı ismiyle selamlamak istemeyiz, değil mi? İşte burası döngülerin devreye girdiği yerdir.
+
+Hala listeleri hatırlıyoruz değil mi? Haydi bir kızlar listesi yapalım:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+kızlar = ['Seda', 'Gül', 'Pınar', 'Ayşe', 'Sen']
+```
+
+Diyelim ki hepsine merhaba demek istiyoruz. Az önce yazdığımız `hi` fonksiyonunu döngü içinde kullanabiliriz:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+`for` durumu `if` durumuna benzer şekilde çalışır; aşağıdaki kodda her iki satır dört boşluk ile girintili olmalıdır.
+
+Dosyada yer alacak tam kod aşağıdadır:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Merhaba ' + name + '!')
+
+girls = ['Seda', 'Gül', 'Pınar', 'Ayşe', 'Sen']
+for name in girls:
+    hi(name)
+    print('Sıradaki kız')
+```
+
+Ve onu çalıştırdığımız zaman:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Selam Seda!
+    Sıradaki kız
+    Selam Gül!
+    Sıradaki kız
+    Selam Pınar!
+    Sıradaki kız
+    Selam Ayşe!
+    Sıradaki kız
+    Selam Sen!
+    Sıradaki kız
+    
+
+Gördüğünüz gibi, `for` cümlesinin içine boşluk karakteri ile koyduğunuz her şey `girls` listesinin her elemanı için tekrarlanıyor.
+
+Ayrıca `for`'u `range` fonksiyonuyla beraber sayılar üzerinde de kullanabilirsiniz:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Çalıştırırsak:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` fonksiyonu birbirini takip eden sayılardan bir liste oluşturur (bu sayıları da siz parametre olarak yazarsınız).
+
+Sizin verdiğiniz ikinci parametrenin listede olmadığına dikkat edin (yani `range(1, 6)` 1'den 5'e kadar sayar, 6'yı dahil etmez). Çünkü “aralık” yarı açıktır, ve yani ilk değeri içerir ama son değeri içermez.
+
+## Özet
+
+İşte bu. **Harikasın, süpersin!** Bu bölüm biraz zordu, kendinle gurur duymalısın. Biz buraya kadar geldiğin için seninle gurur duyuyoruz!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+Sonraki bölüme geçmeden önce başka bir şey yapmak isteyebilirsin. -gerin, biraz etrafta gezin, gözlerini dinlendir- :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/tr-TR/template_extending/README.md b/tr-TR/template_extending/README.md
new file mode 100644
index 00000000000..5e61a2b1768
--- /dev/null
+++ b/tr-TR/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template genişletmek
+
+Django'nun size sunduğu başka bir güzellik de **template genişletmek**tir. O da ne demek? Şu demek, HTML dosyanızın bazı bölümlerini birden fazla sayfanızda kullanabilirsiniz.
+
+Templatelar aynı bilgiyi ya da yerleştirmeyi (layout) birden fazla yerde kullanmak istediğinizde yardım ederler. Yaptığınızı her dosya için tekrar etmek zorunda kalmazsınız. Ve bir şey değiştirmek isterseniz, tüm templatelarda değil sadece bir tanesinde değiştirirsiniz!
+
+## Bir Temel Template Oluştur
+
+Temel template web sitenizin bütün sayfalarında genişletebileceğiniz en temel template'inizdir.
+
+Şimdi `blog/templates/blog/` klasörü içinde `base.html` adlı bir dosya oluşturalım:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Sonra bunu açalım ve `post_list.html` dosyasındaki her şeyi aşağıdaki gibi `base.html`'ye kopyalayalım:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Sonra, `base.html` dosyasındaki `<body>`'nizi (`<body>` ve `</body>` arasında kalan her şeyi) şununla değiştirin:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}Her şeyin bununla değiştirildiğini fark edebilirsiniz`{% for post in posts %}`dan`{% endfor %}`bununla:{% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Ama neden? Bir `blok` oluşturdunuz! `{% block %}` içinde HTML ekleyecek alan yapmak için şablon etiketi kullandınız. HTML başka bir şablondan gelecek (`base.html`) bu şablonu genişletir. Bunun nasıl yapıldığını da hemen göstereceğiz.
+
+Şimdi `base.html`'i kaydedelim ve `blog/templates/blog/post_list.html` dosyamızı tekrar açalım. {% raw %} `{% for post in posts %}`'ın üzerindeki ve `{% endfor %}`'ın altındaki her şeyi kaldıracaksınız. İşiniz bittiğinde dosya şu şekilde görünecektir:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Bunu, bütün içerik blokları için şablonumuzun bir parçası olarak kullanmak istiyoruz. Şimdi bu dosyaya blok etiketleri ekleme zamanı!
+
+{% raw %}Blok etiketinizin `base.html` dosyanızdaki etikete uymasını istiyorsunuz. Ayrıca içerik bloklarınına ait bütün kodu da dahil etmek istiyorsun. Bunu yapmak için, her şeyi `{% block content %}`ve`{% endblock %}`'un arasına yerleştir. Şunun gibi:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Geriye tek bir şey kaldı. Bu iki şablonu birbirine bağlamamız gerekiyor. Genişleyen şablonlar tam da bununla ilgili! Bunu dosyanın başlangıcına genişleyebilir etiketler ekleyerek yapacağız. Bunun gibi:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+İşte bu! Dosyayı kaydedip sitenizin hala düzgün çalışıp çalışmadığını kontrol edin. :)
+
+> Eğer `TemplateDoesNotExist` hatasını alıyorsanız, bunun anlamı `blog/base.html` dosyası yok ve konsolda `runserver`'ı çalıştırıyorsunuz demektir. Konsolda durdurmayı deneyin (Ctrl+C -Control ve C tuşlarına birlikte basarak) ve `python manage.py runserver` komutunu çalıştırarak yeniden başlatın.
\ No newline at end of file
diff --git a/tr-TR/whats_next/README.md b/tr-TR/whats_next/README.md
new file mode 100644
index 00000000000..3032a9880c8
--- /dev/null
+++ b/tr-TR/whats_next/README.md
@@ -0,0 +1,43 @@
+# Sırada ne var?
+
+Kendini tebrik et! **Kesinlikle harikasın**. Seninle gurur duyuyoruz! <3
+
+### Şimdi ne yapmak gerek?
+
+Bir ara ver ve rahatla. Gerçekten çok büyük bir şey yaptın.
+
+Sonra, güncel kalmak için Django Girls'ü [Facebook](http://facebook.com/djangogirls) ya da [Twitter](https://twitter.com/djangogirls) da takip ettiğinizden emin olun.
+
+### Daha geniş kapsamlı kaynaklar önerebilir misiniz?
+
+Evet! Her türlü programlama becerisini öğrenmek için çevrimiçi *bir çok* kaynak var. Bir sonraki adıma geçmek biraz göz korkutucu olabilir, ama biz sizin için inceledik. Django Girls'e gelmeden önce ilgi alanlarınız ve eğitim boyunca geliştirdiğiniz ilgi alanları ne olursa olsun, işte istediğiniz yere ulaşmanız için kullanabileceğiniz bazı ücretsiz kaynaklar (veya büyük ücretsiz bileşenlere sahip kaynaklar).
+
+#### Django
+
+- Diğer kitabımız, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Resmi Django kılavuzu](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Django Video Dersleriyle Başlangıç](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy web geliştirme kursu](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Code Academy Python kursu](https://www.codecademy.com/learn/learn-python)
+- [Google Python kursu](https://developers.google.com/edu/python/)
+- [Python dilini The Hard Way(Zor Yol) kitabı ile öğren. ](http://learnpythonthehardway.org/book/) İçindeki egzersizler ücretsiz 
+- [Yeni Kodlayıcı öğreticileri](http://newcoder.io/tutorials/) - bu, Python'u nasıl kullanabileceğinize dair çeşitli pratik örneklerdir
+- [edX](https://www.edx.org/course?search_query=python) – Bir çok kursu ücretsiz olarak alabilirsiniz, ancak yükseköğretim yeterliliği için bir sertifika veya kredi almak ücretli olabilir
+- [Coursera Python Uzmanlığı](https://www.coursera.org/specializations/python) - bazı video dersleri ücretsiz olarak izlenebilir ve bu kursları alarak bir Coursera Sertifikası kazanabilirsiniz
+- [Herkes için Python](https://www.py4e.com/)- Coursera Herkes için Python uzmanlık kursunun ücretsiz ve açık versiyonu
+
+#### Veril ile çalışma
+
+- [Codecademy veri bilimi kursu](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – Bir çok kursu ücretsiz olarak alabilirsiniz, ancak yükseköğretim yeterliliği için bir sertifika veya kredi almak ücretli olabilir
+- [Dataquest](https://www.dataquest.io/) – ilk 30 "görev" ücretsizdir
+
+Bundan sonra ne geliştireceğini görmek için sabırsızlanıyoruz!
\ No newline at end of file
diff --git a/tr/GLOSSARY.md b/tr/GLOSSARY.md
index b295b284780..1e503fa6881 100755
--- a/tr/GLOSSARY.md
+++ b/tr/GLOSSARY.md
@@ -1,3 +1,3 @@
 # kod editörü
 
-Kod editörü, kodunuza sonradan geri dönebilmeniz için kodu kaydeden bir uygulamadır. Nereden edinebileceğinizi [Kod editörü bölümü](./code_editor/README.md)nde bulabilirsiniz
+Kod editörü, kodunuza sonradan geri dönebilmeniz için kodu kaydeden bir uygulamadır. Nereden edinebileceğinizi [Kod editörü bölümü](./code_editor/README.md)nde bulabilirsiniz
\ No newline at end of file
diff --git a/tr/README.md b/tr/README.md
index e4c6a64ada9..e7eaf14e1aa 100755
--- a/tr/README.md
+++ b/tr/README.md
@@ -1,16 +1,18 @@
 # Django Girls Eğitimi
 
-[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
 
-> Bu çalışma Creative Commons Attribution-ShareAlike 4.0 International License altında lisanslanmıştır. Lisansın bir kopyasını görmek için http://creativecommons.org/licenses/by-sa/4.0/ adresini ziyaret edin.
+> Bu eser Creative Commons Attribution-ShareAlike 4.0 International License ile lisanslıdır. Bu lisansın bir örneğini görmek için https://creativecommons.org/licenses/by-sa/4.0/ adresine gidebilirsiniz.
 
-## Çeviri
+## Hoşgeldiniz
 
-Bu döküman İngilizce'den Türkçe'ye 28 kişiden oluşan tamamen gönüllü bir ekip tarafından çevrildi: Elif T. Kuş, Şirin Saygılı, Suzan Üsküdarlı, Oğuzcan Küçükbayrak, Mehmet Ragıp Altuncu, Şahin B., Kıvanç Yazan, Adil Öztaşer, olasitarska, Oğuz Erdoğmuş, ophelia, Tuğçe Şirin, Fazilet Çilli, Özge Barbaros, Evin Pınar Örnek, Yiğit Bekir Baya, Berna Erden, Akın Toksan, Çağıl, Berat Doğan, Taha Yusuf, Helin Ece Akgül, Müge Kurtipek, Nezihe Pehlivan, Can Güler, Wert Yuio, Barış Arda Yılmaz ve Aybüke Özdemir! Emeği geçen herkese sonsuz teşekkürler! Ellerinize sağlık!
+Django Girls Eğitimi'ne hoşgeldin! Seni burada görmekten mutluyuz :) Bu eğitimde, seni web teknolojileri dünyasında bir yolculuğa çıkaracak, internetin bildiğimiz haliyle çalışması için bir araya gelmesi gereken tüm parçalara bir göz atacağız.
+
+Bilinmeyen şeylerde hep olduğu gibi, bu bir macera olacak. Ama hiç endişelenme, buraya gelme azmini gösterdiğine göre devamı da iyi gidecek :)
 
 ## Giriş
 
-Hiç dünyanın her geçen gün daha fazla teknoloji ile alakalı olduğunu ve bir şekilde geride kaldığınızı hissettiniz mi ? Hiç web sayfalarının nasıl yapıldığını merak edip başlamak için gereken motivasyona sahip olmadığınız oldu mu? Yazılım dünyasının sizin için, kendi başınıza bir şeyler yapmayı denemek için bile, çok karmaşık olduğunu düşündünüz mü?
+Hiç senin (henüz) yakın ilişki kuramadığın teknolojinin dünyayı giderek daha fazla kapladığını hissettiğin oldu mu? Hiç web sayfalarının nasıl yapıldığını merak edip başlamak için gereken motivasyona sahip olmadığınız oldu mu? Yazılım dünyasının sizin için, kendi başınıza bir şeyler yapmayı denemek için bile, çok karmaşık olduğunu düşündünüz mü?
 
 Öyleyse, sizin için iyi haberlerimiz var! Programlama göründüğü kadar zor değil ve size ne kadar keyifli olabileceğini göstermek istiyoruz.
 
@@ -20,33 +22,30 @@ Bu eğitim sihirli bir şekilde sizi bir programcıya dönüştürmeyecek. Eğer
 
 ## Bu eğitim ile ne öğreneceksiniz?
 
-Eğitimi bitirdiğinizde, basit fakat çalışan bir web uygulamasına sahip olacaksınız: kendi blog uygulamanız. Size blogunuzu nasıl canlıya alabileceğinizi de göstereceğiz ki başkaları da çalışmanızı görebilsin!
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
 
 Aşağı yukarı şu şekilde gözükecek:
 
-![Şekil 0.1][2]
+![Şekil 0.1](images/application.png)
 
- [2]: images/application.png
+> Eğer eğitimi kendi başınıza takip ediyorsanız ve bir problem yaşadığınızda size yardım edebilecek bir mentörünüz yoksa, size yardım edebileceğimiz bir sohbet sistemimiz var:[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Daha önce katılmış olan kişilerden ve eğitmenlerimizden zaman zaman chat odasında bulunmalarını ve eğitimi takip eden kişilere yardımcı olmalarını istedik! Chat odasında sorularınızı sormaktan çekinmeyin!
 
-> Eğer eğitimi kendi başınıza takip ediyorsanız ve bir problem yaşadığınızda yardım edebilecek bir eğitmeniniz yoksa, sizin için bir chat odamız var:[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge). Daha önce katılmış olan kişilerden ve eğitmenlerimizden zaman zaman chat odasında bulunmalarını ve eğitimi takip eden kişilere yardımcı olmalarını istedik! Chat odasında sorularınızı sormaktan çekinmeyin!
+Tamam, [hadi en baştan başlayalım...](./how_the_internet_works/README.md)
 
-Tamam, [hadi en baştan başlayalım...][3]
+## Eğitimi evden takip etmek
 
- [3]: ./how_the_internet_works/README.md
+Bir Django Girls atölyesine katılmak harika, ama katılmanın her zaman mümkün olmayabileceğinin farkındayız. Bu nedenle, bu eğitimi evde takip etmeyi denemenizi tavsiye ediyoruz. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. Bu hala devam eden bir çalışma, ancak yakında [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) Youtube kanalında (İngilizce) giderek daha da fazla konu ele alınacak.
 
-## Hakkında ve katkıda bulunma
+Ele alınmış olan her bölümde, ilgili videoya ait bir bağlantı var.
 
-Bu eğitim [DjangoGirls][4] tarafından sürdürülmektedir. Eğer hatalar bulursanız ve eğitimi güncellemek isterseniz lütfen [katkıda bulunma kılavuzunu takip edin][5].
+## Hakkında ve katkıda bulunma
 
- [4]: http://djangogirls.org/
- [5]: https://github.com/DjangoGirls/tutorial/blob/master/README.md
+Bu eğitim [DjangoGirls](https://djangogirls.org/) tarafından sürdürülmektedir. Eğer hatalar bulursanız ve eğitimi güncellemek isterseniz lütfen [katkıda bulunma kılavuzunu takip edin](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
 
-## Bu eğitimi başka dillere çevirmemize yardımcı olmak ister misiniz?
+## Would you like to help us translate the tutorial into other languages?
 
-Hali hazırda, çeviriler crowdin.com platformunda tutuluyor:
+Şuan çeviriler crowdin.com platformunda tutuluyor:
 
 https://crowdin.com/project/django-girls-tutorial
 
-Eğer diliniz crowdin'de listelenmemiş ise, lütfen GitHub'da dilinizle alakalı bilgi veren bir [konu açın][6] böylece dilinizi ekleyebilelim.
-
- [6]: https://github.com/DjangoGirls/tutorial/issues/new
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/tr/SUMMARY.md b/tr/SUMMARY.md
index 612133adbb6..238c6432ef8 100755
--- a/tr/SUMMARY.md
+++ b/tr/SUMMARY.md
@@ -2,6 +2,7 @@
 
 * [Giriş](README.md)
 * [Kurulum](installation/README.md)
+* [Kurulum (chromebook)](chromebook_setup/README.md)
 * [İnternet nasıl çalışır](how_the_internet_works/README.md)
 * [Komut satırına giriş](intro_to_command_line/README.md)
 * [Python kurulumu](python_installation/README.md)
@@ -17,10 +18,10 @@
 * [Django views - yaratma zamanı geldi!](django_views/README.md)
 * [HTML'ye giriş](html/README.md)
 * [Django ORM ve QuerySets (Sorgu Setleri)](django_orm/README.md)
-* [Template içerisinde dinamik veri](dynamic_data_in_templates/README.md)
-* [Django template](django_templates/README.md)
-* [CSS - sayfanı güzelleştir](css/README.md)
+* [Template içinde dinamik veri](dynamic_data_in_templates/README.md)
+* [Django templateleri](django_templates/README.md)
+* [CSS - Güzelleştirin](css/README.md)
 * [Template genişletmek](template_extending/README.md)
 * [Uygulamanı genişlet](extend_your_application/README.md)
-* [Django formları](django_forms/README.md)
-* [Sırada ne var?](whats_next/README.md)
+* [Django Forms](django_forms/README.md)
+* [Sırada ne var?](whats_next/README.md)
\ No newline at end of file
diff --git a/tr/chromebook_setup/README.md b/tr/chromebook_setup/README.md
new file mode 100644
index 00000000000..217cbaaa596
--- /dev/null
+++ b/tr/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook kurulumu
+
+> **Not** Zaten yükleme adımlarını uyguladıysanız, bunu tekrar yapmanıza gerek yok- direk [Python'a Giriş](../python_introduction/README.md)'e atlayabilirsiniz.
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/tr/chromebook_setup/instructions.md b/tr/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..5c9efd9f39d
--- /dev/null
+++ b/tr/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+Chromebook kullanmıyorsanız, [bu bölümü atlayabilirsiniz](http://django-blog-tutorial.kadinyazilimci.com/en/installation/#install-python). Chromebook kullanıyorsanız kurulum deneyiminiz biraz farklı olacaktır. Diğer yükleme yönergelerini göz ardı edebilirsiniz.
+
+### Cloud 9
+
+Cloud 9, size İnternette yazılımı yükleyebileceğiniz, yazabileceğiniz ve çalıştırabileceğiniz bir kod düzenleyicisi ve çalışan bir bilgisayara erişim sağlayan bir araçtır. Eğitim boyunca, Cloud 9 sizin *yerel makinanız* olma görevini alacaktır. OS X, Ubuntu veya Windows'daki sınıf arkadaşlarınız gibi terminal arayüzünde komut çalıştırmaya devam edeceksiniz, ancak terminaliniz Cloud 9'un sizin yerinize kuracağı başka bir bilgisayara bağlanacaktır.
+
+1. Cloud 9'u [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp) üzerinden yükleyin
+2. [C9.io](https://c9.io) adresine gidin
+3. Kaydolun
+4. *Yeni çalışma alanı oluştur* ' u tıklayın
+5. *django-girls* olarak isimlendirin
+6. *Boş*'u seçin (en altta sağdan ikinci turuncu logolu olan)
+
+Şimdi bir kenar çubuğu, bazı metinlerin olduğu büyük bir ana pencere ve en altta da buna benzer küçük penceresi olan bir arayüz görmelisiniz:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    isminiz:~/calismaalani $
+    
+
+Bu alt alan * terminalinizdir </ 0>, Cloud 9'un sizin için hazırladığı talimatlarınızı yazacağınız yer. Biraz daha büyük yapmak için bu pencereyi yeniden boyutlandırabilirsiniz</p> 
+
+### Sanal ortam (Virtual environment)
+
+Bir sanal ortam(virtualenv diye de bilinir), üzerinde çalıştığımız proje için kullanışlı kodlarımızı yazabileceğimiz özel bir kutudur. Bunları çeşitli projelerimizi ayrı tutmak için kullanırız, böylece farklı projeler arasında işler karışmaz.
+
+Cloud 9 arayüzünün altındaki terminalinizde şunu çalıştırın:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+Eğer hala çalışmıyorsa eğitmeninizden yardım isteyin.
+
+Sonra, çalıştır:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls 
+    cd djangogirls 
+    python3.6 -mvenv myvenv 
+    source myvenv/bin/activate 
+    pip install django~=1.11.0
+    
+
+(son satırda bir tılde ve eşitlik işareti kullandığımıza dikkat edin: ~=).
+
+### Github
+
+Bir [Github](https://github.com) hesabı açın.
+
+### PythonAnywhere
+
+Django Girls eğitimi, yeni web uygulamanızı güçlendiren ve onu herkesin görebileceği şekilde herkes tarafından erişilebilen bir bilgisayara (sunucu olarak adlandırılır) taşıyan bir kod olan Deployment (Dağıtım) adlı bir bölümü içerir.
+
+Kılavuzu Chromebook üzerinden kullanırken bu bölüm biraz garip oluyor; zaten internet üzerindeki bir bilgisayar kullanılıyor (laptop dışında). Bununla birlikte, Cloud 9'u çalışma alanımız olarak veya "devam etmekte" olan işlerimizin bulunduğu bir yer olarak düşünebiliriz Python Anywhere de işlerimizi daha eksiksiz hale getirmek için gösterebileceğimiz bir yer olarak düşünebildiğimizden hala kullanışlıdır.
+
+Bu nedenle, yeni bir Python Anywhere hesabı açmak için [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/tr/code_editor/README.md b/tr/code_editor/README.md
index e3b494bdc7b..f9ccff465bf 100755
--- a/tr/code_editor/README.md
+++ b/tr/code_editor/README.md
@@ -1,7 +1,11 @@
 # Kod editörü
 
+> Evden takip edenler için: Bu bölüm [Pythonu kurma & Kod Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) videosunda işlenmiştir.
+
 İlk kod satırınızı yazmak üzeresiniz, bu yüzden önce bir kod editörü edinme zamanı!
 
-> **Not**: Bunu daha önceki Kurulum bölümünde yaptıysanız, doğrudan bir sonraki bölüme geçebilirsiniz!
+> **Note** Eğer Chromebook kullanıyorsanız bu bölümü atlayın ve [Chromebook Kurulum](../chromebook_setup/README.md) u takip edin.
+> 
+> **Note** Bunları Kurulum bölümünde yapmış olabilirsin, öyle ise hemen bir sonraki bölüme atlayabilirsin!
 
-{% include "/code_editor/instructions.md" %}
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/tr/code_editor/instructions.md b/tr/code_editor/instructions.md
index da81c69e2d7..f9a1d7a9cf3 100755
--- a/tr/code_editor/instructions.md
+++ b/tr/code_editor/instructions.md
@@ -1,6 +1,6 @@
 Birçok farklı kod editörü var, hangi editörü kullanacağınız kişisel tercihinize bağlı. Çoğu Python programcısı PyCharm gibi karmaşık fakat son derece güçlü IDE'leri (Integrated Development Environments-Entegre Geliştirme Ortamları) kullanır. Başlangıç seviyesi için bunlar muhtemelen pek uygun olmayacaktır. Bizim önerdiklerimiz aynı derecede güçlü fakat çok daha basit editörler olacak.
 
-Bizim önerilerimizi aşağıda bulabilirsiniz, fakat eğitmenlerinize onların tercihlerini sormaktan çekinmeyin - onlardan yardım almak daha kolay olacaktır.
+Bizim tavsiyelerimiz aşağıdakiler, ama mentörünüz danışmak isteyebilirsiniz.
 
 ## Gedit
 
@@ -8,15 +8,15 @@ Gedit açık kaynaklı, ücretsiz bir editördür. Tüm işletim sistemlerinde k
 
 [Buradan indirin](https://wiki.gnome.org/Apps/Gedit#Download)
 
-## Sublime Text 2
+## Sublime Text 3
 
-Sublime Text ücretsiz deneme sürümüne sahip oldukça popüler bir editördür. Kurulumu ve kullanımı basittir, tüm işletim sistemlerinde kullanılabilir. 
+Sublime Text, ücretsiz deneme süresi olan çok popüler bir editördür ve tüm işletim sistemleri için mevcuttur.
 
-[Buradan indirin](http://www.sublimetext.com/2)
+[Buradan indirin](https://www.sublimetext.com/3)
 
 ## Atom
 
-Atom [GitHub](http://github.com/) tarafından geliştirilen oldukça yeni bir editör. Atom ücretsiz, açık kaynak kodlu, kurulumu ve kullanımı basit bir editördür. Windows, OSX ve Linux işletim sistemlerinde kullanılabilir.
+Atom, [GitHub](https://github.com/) tarafından oluşturulan son derece yeni bir kod editörüdür. Ücretsiz, açık kaynak ve Windows, OS X ve Linux için kullanılabilir.
 
 [Buradan indirin](https://atom.io/)
 
@@ -24,8 +24,8 @@ Atom [GitHub](http://github.com/) tarafından geliştirilen oldukça yeni bir ed
 
 Neden Word ya da Notepad kullanmak yerine, özel bir kod editörü yazılımı kurduğumuzu merak ediyor olabilirsiniz.
 
-Birinci nedeni, kodun **düz metin** olması gerekliliği. Word ve TextEdit gibi programlar [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format) gibi özel formatları kullanarak düz metin yerine zengin metin (fontlu ve formatlı metin) üretiyorlar.
+Birinci nedeni yazdığımız kodun **sade yazı** olması gerektiği içindir ki Word gibi programlar sade yazı üretmezler (font ve şekillendirme desteklerler) ve [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format) gibi özel formatlar kullanılar.
 
-İkinci neden, kod editörleri kod düzenlemek için özelleşmişlerdir, dolayısıyla kodu anlamına göre renklerle öne çıkarma (highlighting) veya tırnakları otomatik kapama gibi yararlı özellikler sağlar.
+İkinci sebep ise kod editörlerinin kod düzenlemeye destek vermek - örnegin özel kelimeleri reklendirme ve otomatik parantez kapatma gibi - için özelleşmiş olmasıdır.
 
-Bütün bunları ileride uygulama içerisinde göreceğiz. Yakında güvenilir ihtiyar kod editörünü favori araçlarınız arasında görmeye başlayacaksınız :)
+Bütün bunları birazdan deneyimleyeceğiz. Yakında kod editörünüz güvenlir eski dostunuz gibi olacaktır :)
\ No newline at end of file
diff --git a/tr/css/README.md b/tr/css/README.md
index 6967653c6db..7d239d8eb06 100644
--- a/tr/css/README.md
+++ b/tr/css/README.md
@@ -1,114 +1,113 @@
-# CSS - güzelleştir!
+# CSS – sayfanı güzelleştir!
 
 Blogumuz hala epey çirkin gözüküyor, değil mi? Güzelleştirme zamanı! Bunun için CSS kullanacağız.
 
 ## CSS Nedir?
 
-Basamaklı Stil Sayfaları (Cascading Style Sheets - CSS) bir websayfasının görünüm ve biçimlendirmelerini tanımlamak için kullanılan bir işaretleme (markup) dilidir (HTML gibi). CSS'i websayfanızın makyajı olarak görebilirsiniz ;).
+Cascading Style Sheets (yani stil şablonu, kısaca CSS) bir işaretleme dili (örneğin HTML) ile yazılmış bir web sitesinin görünüm ve biçimini tanımlamakta kullanılan bir dildir. Bunu, web sayfamızın bir tür makyajı gibi düşünün ;)
 
-Fakat tekrar en baştan başlamak istemiyoruz, değil mi? Bir kez daha, programcılar tarafından önceden hazırlanmış ve internette ücretsiz olarak yayınlanmış bir şeyi kullanacağız. Bilirsiniz tekerleği yeniden icat etmek eğlenceli değildir.
+Fakat tekrar sıfırdan başlamak istemiyoruz, değil mi? Bir kez daha, programcıların internette ücretsiz sundukları bir şeyi kullanacağız. Bilirsiniz, tekerleği yeniden icat etmek pek eğlenceli değil.
 
-## Hadi Bootstrap kullanalım!
+## Haydi Bootstrap kullanalım!
 
-Bootstrap güzel websayfaları geliştirmek için kullanılan en popüler HTML ve CSS çerçevesidir(framework) : http://getbootstrap.com/
+Bootstrap HTML and CSS tabanlı çok güzel websiteleri geliştirmek için en yaygın olarak kullanılan çözümlerden biridir https://getbootstrap.com/
 
-Twitter yazılımcıları tarafından geliştirilmeye başlanmış ve şu anda dünyanın her yerinden gönüllüler tarafından geliştirilmektedir.
+Twitter yazılımcıları tarafından geliştirilmeye başlanmış ve şu anda dünyanın her yerinden gönüllüler tarafından geliştirilmektedir!
 
 ## Bootstrap kurulumu
 
-Bootstrap kurmak için `.html` dosyanızda `<head>` kısmına şunları eklemeniz gerekli (`blog/templates/blog/post_list.html`):
+Bootstrap'ı kurmak için alttakileri `.html` dosyasının `<head>` kısmına eklemelisiniz:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-    <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
-    <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css"> <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
 ```
-    
 
-Bu, projemize hiçbir yeni dosya eklemez. Yalnızca internet üzerinde var olan dosyalara işaret eder. Şimdi websitenizi açın ve sayfayı yenileyin. İşte oldu!
+Bu satırlar projeye yeni dosya eklemez. Ancak İnternet'te var olan dosyalara işaret eder. Haydi, tekrar websiteni tekrar aç ve yenile. İşte budur!
 
-![Şekil 14.1][1]
-
- [1]: images/bootstrap1.png
+![Şekil 14.1](images/bootstrap1.png)
 
 Şimdiden daha güzel gözüküyor!
 
 ## Django'da statik dosyalar
 
-Son olarak **statik dosyalar** diye bahsettiğimiz şeylere daha yakından bakalım. Statik dosyalar, CSS ve resimlerindir -- dinamik olmayan, bu nedenle içerikleri istek bağlamından bağımsız ve her kullanıcı için aynı dosyalar.
+Son olarak **statik dosyalar** diye bahsettiğimiz şeylere daha yakından bakalım. Statik dosyalar, tüm CSS dosyaları ve resimlerindir. İçerikleri istek bağlamından (request context) bağımsızdır ve her kullanıcı için aynıdır.
 
 ### Django'da statik dosyaları nereye koymalı
 
-Sunucuda `collectstatic` komutunu çalıştırdığımız zaman gördüğün gibi, Django dahili "admin" uygulaması için statik dosyaların nerede olduğunu biliyor. Şimdi de bizim kendi `blog` uygulamamız için bazı statik dosyalar eklememiz gerekiyor.
+Django dahili "admin" uygulaması için statik dosyaları nerede bulacağını biliyor. Şimdi sadece kendi `blog` uygulamamız için bazı statik dosyalar eklememiz gerekiyor.
 
-Bunu blog uygulamamızın içerisinde `static` isimli bir klasör oluşturarak yapacağız:
+Bunu blog uygulamamızın içine `static` isimli bir klasör oluşturarak yapacağız:
 
-```
-djangogirls
-├── blog
-│   ├── migrations
-│   └── static
-└── mysite
-```    
+    djangogirls 
+    ├── blog 
+    │ ├── geçişler
+    │ ├── statik 
+    │ └── şablonlar 
+    └── benimsitem
+    
 
-Django uygulama klasörlerinizin altındaki "static" isimli tüm klasörleri otomatik olarak bulacak ve içindekileri statik dosya olarak kullanabilecektir.
+Django otomatik olarak uygulama klasörlerinizdeki "static" adlı klasörleri bulur. Böylece bunların içerikleri statik dosya olarak kullanabilir.
 
 ## İlk CSS dosyanız!
 
-Şimdi web sayfamıza kendi stilimizi eklemek için bir CSS dosyası oluşturalım. `static` klasörü içinde `css` adlı yeni bir klasör oluşturalım. Şimdi de `css` klasörü içinde `blog.css` adlı yeni bir dosya oluşturalım. Hazır mısınız?
+Simdi web sayfana kendi stilini eklemen için bir CSS dosyası oluşturalım. `static` klasörü içinde `css` adlı yeni bir klasör oluştur. Şimdi de `css` klasörü içinde `blog.css` adlı yeni bir dosya oluşturalım. Hazır mısınız?
 
-```
-djangogirls
-└─── blog
-     └─── static
-          └─── css
-               └─── blog.css
-```    
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
 
 Şimdi CSS yazma zamanı! `blog/static/css/blog.css` dosyasını kod editöründe açın.
 
-Biz burada özelleştirme ve CSS'in detaylarına çok fazla girmeyeceğiz, çünkü gerçekten kolay ve workshop'tan sonra kendinizi bu konuda geliştirebilirsiniz. Web sitelerini CSS'le güzelleştirmek hakkında bilmen gerekenleri öğrenmek için, [Codeacademy HTML & CSS kursu][2]nu özellikle öneriyoruz.
+Burada CSS'yi özelleştirme ve öğrenmeyle ilgili çok derinlemesine gidemeyeceğiz. Daha fazla bilgi edinmek isterseniz, bu sayfanın sonunda ücretsiz CSS kursu için bir tavsiye var.
 
- [2]: http://www.codecademy.com/tracks/web
-
-Ancak az da olsa yapalım. Acaba başlığımızın rengini mi değiştirsek? Bilgisayarlar renkleri anlamak için özel kodlar kullanır. Bu kodlar `#` ile başlar ve arkasından 6 harf (A-F) ve numaralarda (0-9) gelir. Renk kodlarını örneğin burada bulabilirsin: http://www.colorpicker.com/. Ayrıca [önceden tanımlanmış renkler][3]i de kullanabilirsin, `red` (kırmızı) ve `green` (yeşil) gibi.
-
- [3]: http://www.w3schools.com/cssref/css_colornames.asp
+Ama, biraz da yapalım. Acaba başlığımızın rengini mi değiştirsek? Bilgisayarlar renkleri anlamak için özel kodlar kullanır. Bu kodlar `#` ile başlar ve 6 harf(A-F) ve sayıyla(0-9) devam eder. Örneğin, mavinin renk kodu `#0000FF` dur. Birçok renk için renk kodlarını buradan bulabilirsiniz: http://www.colorpicker.com/. Ayrıca [tanımlı renkler](http://www.w3schools.com/colors/colors_names.asp)i de kullanabilirsin, `red` (kırmızı) ve `green` (yeşil) gibi.
 
 `blog/static/css/blog.css` dosyanıza şu kodu eklemelisiniz:
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 h1 a {
     color: #FCA205;
 }
-```    
+```
 
-`h1 a` bir CSS Seçicisidir (Selector). Bu demek oluyor ki biz stilimizi, bir `h1` öğesi içerisinde olan tüm `a` öğelerine (örneğin kodumuzun içerisinde `<h1><a href="">link</a></h1>` gibi bir şey olduğunda) uyguluyoruz. Bu durumda, rengi `#FCA205` yani turuncu yapmasını söylüyoruz. Elbette, buraya kendi arzu ettiğin rengi koyabilirsin!
+`h1 a` bir CSS seçicisidir (selector). Bu, stillerimizi `h1` öğesi içerisindeki `a` öğelerine uyguladığımız anlamına geliyor. Yani `<h1><a href="">bağlantı</a></h1>` gibi bir öğemiz olduğunda, ona `h1 a` stilimiz uygulanıyor. Bu durumda, rengi `#FCA205` yani turuncu yapmasını söylüyoruz. Elbette, buraya kendi arzu ettiğin rengi koyabilirsin!
 
-Bir CSS dosyasında, HTML dosyasındaki öğeler için stil belirleriz. Öğeler, öğenin ismi (örn. `a`, `h1`, `body`), `sınıf` özniteliği (attribute) ya da `id` özniteliği ile tanımlanırlar. Sınıf ve id (kimlik), bir elemente senin tarafından verilen isimlerdir. Sınıflar bir öğe grubunu tanımlar, id'ler ise belirli bir öğeye işaret ederler. Örneğin şu aşağıdaki etiket CSS tarafından, `a` etiket adı, `external_link` sınıfı ya da `link_to_wiki_page` id'si kullanılarak tanımlanabilir:
+Bir CSS dosyasında, HTML dosyasındaki öğeler için stil belirleriz. Öğeleri tanımlamanın ilk yolu öğe adıdır. Bunları HTML bölümünden etiket olarak hatırlıyor olabilirsiniz. Bunların hepsi öğe adına örnektir: `a`, `h1` ve `body`. Öğeleri aynı zamanda `class` ve `id` öznitelikleri ile tanımlarız. Sınıf ve id (kimlik), bir elemente senin tarafından verilen isimlerdir. Sınıflar bir öğe grubunu tanımlar, id'ler ise belirli bir öğeye işaret ederler. Örneğin şu aşağıdaki etiket CSS tarafından, `a` etiket adı, `external_link` class'ı ya da `link_to_wiki_page` id'si kullanılarak tanımlanabilir:
 
 ```html
-<a href="http://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
-``` 
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
 
-Daha fazla bilgi için [w3schools'da CSS seçicileri][4]ni okuyabilirsin.
+CSS hakkında daha fazla bilgi edinmek için [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp) u okuyabilirsin.
 
- [4]: http://www.w3schools.com/cssref/css_selectors.asp
+Bir de HTML şablonuna projemize CSS eklediğimizi bildirmemiz gerekiyor. `blog/templates/blog/post_list.html` dosyasını açıp en başına bunlar ekleyelim:
 
-Sonrasında, ayrıca HTML şablonumuza (template) bir takım CSS eklemeleri yaptığımızı bildirmemiz gerekiyor. `blog/templates/blog/post_list.html` dosyasını açın ve en başına şu satırı ekleyin:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
-```    
+```
 
-Burada yaptığımız yalnızca statik dosyaları yüklemek. :) Sonrasında, `<head>` ve `</head>`, tagları arasına, Bootstrap CSS dosyalarına yönelik bağlantılardan sonra (web tarayıcımız dosyaları yazıldıkları sırasıyla okuduğundan, bizim dosyamızdaki kodlar Bootstrap dosyasının içerisindekileri geçersiz kılabilir), şu satırı ekleyin:
+Burada sadece statik dosya ekliyoruz :) `<head>` ve `</head>` etiketleri arasına, bootstrap linklerinde sonra, şu satırı ekleyelim:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <link rel="stylesheet" href="{% static 'css/blog.css' %}">
-```    
+```
 
-Az evvel şablonumuza (template) CSS dosyamızın nerede olduğunu söylemiş olduk.
+Tarayıcı, dosyaları verilen sırada okuyor. O yüzden doğru yerde olduğundan emin olmalıyız. Aksi takdirde dosyadaki kod, Bootstrap dosyası tarafından üzerine yazılabilir. Az evvel şablonumuza (template) CSS dosyamızın nerede olduğunu söylemiş olduk.
 
-Dosyanız şu şekilde gözüküyor olmalı:
+Şimdi dosyanız şöyle olmalı:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
@@ -126,81 +125,86 @@ Dosyanız şu şekilde gözüküyor olmalı:
 
         {% for post in posts %}
             <div>
-                <p>yayınlanma tarihi: {{ post.yayinlanma_tarihi }}</p>
-                <h1><a href="">{{ post.baslik }}</a></h1>
-                <p>{{ post.yazi|linebreaks }}</p>
+                <p>Yayın tarihi: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
             </div>
         {% endfor %}
     </body>
 </html>
-```    
+```
 
 Tamamdır, dosyayı kaydedip sayfayı yenileyebilirsiniz.
 
-![Şekil 14.2][5]
+![Şekil 14.2](images/color2.png)
 
- [5]: images/color2.png
+Güzel! Şimdi de sitemizi biraz rahatlatıp sol kenar boşluğunu arttırsak mı? Hadi deneyelim!
 
-Güzel! Şimdi de sitemizi biraz rahatlatıp sol kenar boşluğunu (margin'i) arttırsak mı? Hadi deneyelim!
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 body {
     padding-left: 15px;
 }
 ```
-    
-
-Bunu CSS dosyanıza ekleyin, dosyayı kaydedin ve nasıl çalıştığını görelim!
 
-![Şekil 14.3][6]
+Bunu CSS ekleyip kaydet ve bak bakalım! Nasıl da oldu!
 
- [6]: images/margin2.png
+![Şekil 14.3](images/margin2.png)
 
 Belki de başlığımızın yazı tipini özelleştirebiliriz? Aşağıdaki satırı `blog/templates/blog/post_list.html` dosyasının içinde `<head>` bölümüne yapıştırın:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
-<link href="http://fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
-```   
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Daha önce yaptığımız gibi, sıralamayı ve yerini kontrol edelim `blog/static/css/blog.css` den önce olmalı. Bu satır Google Fonts'tan *Lobster* adlı bir font yükler (https://www.google.com/fonts).
 
-Bu satır *Lobster* adlı bir fontu Google Fonts (https://www.google.com/fonts) sitesinden sayfamıza aktarır.
+`blog/static/css/blog.css` CSS dosyasında `h1 isimli ` tanımlama bölümünü bulalım ( `{` ve `}` sembolleri arasındaki kod). `font-family: 'Lobster';` satırını parantezler arasına kopyalayıp sayfayı yenileyelim:
 
-Şimdi `blog/static/css/blog.css` dosyamızdaki `h1 a` deklarasyon bloğunun içine (`{` ve `}` kodları arasına) `font-family: 'Lobster';` satırını ekleyip sayfayı yenileyin:
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 h1 a {
     color: #FCA205;
     font-family: 'Lobster';
 }
-```   
-
-![Şekil 14.3][7]
+```
 
- [7]: images/font.png
+![Şekil 14.3](images/font.png)
 
 Harika!
 
-Yukarıda bahsettiğimiz üzere, CSS'te class (sınıf) diye bir kavram var. Class'lar, temel olarak HTML kodunuzun bir parçasına isim vermenize yarar ve yalnızca o parçanın stilini değiştirirken diğer parçaların etkilenmemesini sağlar. İki div'iniz var diyelim; fakat çok farklı şeyler yapıyorlarsa (örneğin biri başlık diğeri gönderinin metni) ve bu nedenle de aynı şekilde gözükmelerini istemiyorsanız, sınıflar müthiş yararlıdır.
+Yukarıda bahsettiğimiz üzere, CSS'te class (sınıf) diye bir kavram var. Class'lar, temel olarak HTML kodunuzun bir kısmına isim vermenize yarar ve diğer kısımları stiline değiştirmeden yalnızca o kısmın stilini değiştirmenizi sağlar. Bu süper yararlı olabilir! Çok farklı şeyler yapan iki div'iniz var diyelim (örneğin biri başlık diğeri gönderinin metni). Class, farklı görünmelerini sağlamana yardımcı olur.
 
 Devam edelim ve HTML kodumuzun bir kısmına isim verelim. Başlığı içeren `div`'e `page-header` isimli bir class ekleyelim:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="page-header">
     <h1><a href="/">Django Girls Blog</a></h1>
 </div>
-```    
+```
 
 Şimdi de gönderi metnini içeren `div`'e `post` isimli bir sınıf ekleyelim.
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="post">
-    <p>yayınlanma tarihi: {{ post.yayinlanma_tarihi }}</p>
-    <h1><a href="">{{ post.baslik }}</a></h1>
-    <p>{{ post.yazi|linebreaks }}</p>
+    <p>Yayın tarihi: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
 </div>
-```    
+```
 
 Şimdi farklı seçicilere (selectors) bildirim (deklarasyon) blokları ekleyeceğiz. `.` ile başlayan seçiciler sınıflara işaret eder. Web'de, aşağıdaki kodu anlamanıza yardımcı olacak pek çok güzel CSS öğreticisi ve açıklama mevcut. Şimdilik sadece bu kodu kopyalayıp `blog/static/css/blog.css` dosyamıza yapıştıralım:
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 .page-header {
     background-color: #ff9400;
@@ -208,65 +212,66 @@ Devam edelim ve HTML kodumuzun bir kısmına isim verelim. Başlığı içeren `
     padding: 20px 20px 20px 40px;
 }
 
-    
 .page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
     color: #ffffff;
     font-size: 36pt;
     text-decoration: none;
 }
-    
+
 .content {
     margin-left: 40px;
 }
-    
+
 h1, h2, h3, h4 {
     font-family: 'Lobster', cursive;
 }
-    
+
 .date {
-   float: right;
     color: #828282;
 }
-    
+
 .save {
     float: right;
 }
-    
+
 .post-form textarea, .post-form input {
     width: 100%;
 }
-    
+
 .top-menu, .top-menu:hover, .top-menu:visited {
     color: #ffffff;
     float: right;
     font-size: 26pt;
     margin-right: 20px;
 }
-    
+
 .post {
     margin-bottom: 70px;
 }
-    
+
 .post h1 a, .post h1 a:visited {
     color: #000000;
 }
 ```
-    
 
-Sonrasında blog postlarımızı gösteren HTML kodunun etrafını class deklarasyonları ile saralım. Aşağıdaki kodları değiştirin:
+Sonra, blog gönderilerini gösteren HTML kodunu, class bildirimleri içine alın. <0>blog/templates/blog/post_list.html</0> içindeki şu kısmı,
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
     <div class="post">
-        <p>yayınlanma tarihi: {{ post.yayinlanma_tarihi }}</p>
-        <h1><a href="">{{ post.baslik }}</a></h1>
-        <p>{{ post.yazi|linebreaks }}</p>
+        <p>Yayın tarihi: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
     </div>
 {% endfor %}
-```    
+```
 
 bununla değiştirelim:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="content container">
     <div class="row">
@@ -274,27 +279,25 @@ bununla değiştirelim:
             {% for post in posts %}
                 <div class="post">
                     <div class="date">
-                        {{ post.yayinlanma_tarihi }}
+                        <p>Yayın tarihi: {{ post.published_date }}</p>
                     </div>
-                    <h1><a href="">{{ post.baslik }}</a></h1>
-                    <p>{{ post.yazi|linebreaks }}</p>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
                 </div>
             {% endfor %}
         </div>
     </div>
 </div>
-```    
+```
 
 Bu dosyaları kaydedin ve web sayfanızı yenileyin.
 
-![Şekil 14.4][8]
-
- [8]: images/final.png
+![Şekil 14.4](images/final.png)
 
-Heyo! Harika görünüyor, değil mi? Yapıştırdığımız bu kodları anlamak pek de zor değil. Büyük bir kısmını sırf okuyarak anlayabilirsiniz.
+Yaşasın! Harika görünüyor değil mi? Şimdi yapıştırdığımız koda bakıp CSS tarafından kullanılan ve HTML eklenmiş olan nesneleri bulalım. Tarihi turkuaz rengine çevirmek için nereyi değiştirmen gerekir?
 
-CSS ile biraz oynamaktan korkmayın ve bazı şeyleri değiştirmeyi deneyin. Bir şeyi bozarsanız tasalanmayın, yaptığınızı her zaman geri alabilirsiniz!
+CSS ile biraz oynamaktan çekinme ve bir kaç şeyi değiştirmeye calış. CSS ile oynamak neyin neyi etkilediğini anlamak için çok faydalı. Bir şeyleri bozarsan dert etme, her zaman geri alabilirsin!
 
-Her durumda atölye sonrası ödevi olarak ücretsiz [Codeacademy HTML & CSS Kursu][2]'nu, websayfanızı CSS ile güzelleştirmeyi öğrenmek için almanızı tavsiye ediyoruz.
+Ücretsiz [Codeacademy HTML & CSS kursu](https://www.codecademy.com/tracks/web)nu izlemeni gerçekten öneririz. Web sitelerini CSS'le güzelleştirmeyi iyice öğrenmene yardımcı olabilir.
 
-Sonraki bölüm için hazır mısınız? :)
+Sonraki bölüm için hazır mısın?! :)
\ No newline at end of file
diff --git a/tr/deploy/README.md b/tr/deploy/README.md
index 8910546ab5f..023a6878c98 100755
--- a/tr/deploy/README.md
+++ b/tr/deploy/README.md
@@ -2,297 +2,232 @@
 
 > **Not** Bir sonraki bölüm ara ara zor gelebilir. Dayanın ve bölümü bitirin; yayına alma, website geliştirme sürecinin önemli bir parçasıdır. Biraz daha uğraşmalı olan websitesini canlıya alma işine eğitmeninizin yardım edebilmesi için bu bölümü tutorial'ın ortasına yerleştirdik. Böylece eğer zaman yetmezse tutorial'ı kendi başınıza bitirebilirsiniz.
 
-Şimdiye kadar websiteniz sadece kendi makinanızda idi, şimdi yayına nasıl alacağınızı öğreneceksiniz! Yayına alma uygulamanızı internette yayınlama sürecidir, böylelikle insanlar sonunda gidip uygulamanızı görebilirler :).
+Şimdiye kadar web sitenize sadece kendi bilgisayarınızdan girilebiliyordu. Şimdi onu nasıl canlıya alacağınızı öğreneceksiniz! Yayına alma uygulamanızı internette yayınlama sürecidir, böylelikle insanlar sonunda gidip uygulamanızı görebilirler. :)
 
-Öğrendiğimiz üzere, bir websitesi bir sunucunun üstünde olmalıdır. Internette birçok sunucu sağlayıcı bulunuyor. Görece kolay bir yayına alma süreci olanlardan birini kullanacağız: [PythonAnywhere][1]. PythonAnymwhere çok fazla ziyaretçisi olmayan ufak uygulamalar için ücretsiz yani sizin için kesinlikle yeterli olacaktır.
+Öğrendiğimiz üzere, bir websitesi bir sunucunun üstünde olmalıdır. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
- [1]: http://pythonanywhere.com/
+Dışarıdan kullanacağımız diğer servis bir kod barındırma hizmeti olan [Github](https://www.github.com). Başkaları da var, ama nerdeyse her programcının bir Github hesabı var, sizin de olacak!
 
-Dışarıdan kullanacağımız diğer servis bir kod barındırma hizmeti olan [Github][2]. Başkaları da var, ama nerdeyse her programcının bir Github hesabı var, sizin de olacak!
-
- [2]: http://www.github.com
-
-Github'ı kodumuzu PythonAnywhere'e taşımak için bir atlama tahtası olarak kullanacağız.
+Bu üç yer sizin için önemli olacak. Lokal bilgisayarınız geliştirme ve test yaptığınız yer olacak. Değişikliklerden memnun olduğunuzda programınızın bir kopyasını Github'a koyacaksınız. Web siteniz PythonAnywhere üzerinde olacak ve onu kodunuzun bir kopyasını Github'dan alarak günceleyeceksiniz.
 
 # Git
 
-Git, birçok programcı tarafından kullanılan bir "sürüm kontrol sistemi"dir. Bu yazılım dosyaların zaman içindeki değişimlerini izler, böylelikle sonradan eski sürümlere ulaşabilirsiniz. Biraz Microsoft Word'deki "değişiklikleri izle" özelliği gibi, ama çok daha güçlü.
-
-## Git'i kurmak
-
-> **Not** Kurulum adımlarını halihazırda yaptıysanız, bunu tekrar yapmanıza gerek yok - bir sonraki alt bölüme geçip Git reponuzu oluşturabilirsiniz.
+> **Not** Eğer kurulum adımlarını zaten yaptıysanız, bunu tekrar yapmanıza gerek yok - bir sonraki bölüme geçip Git reponuzu oluşturabilirsiniz.
 
 {% include "/deploy/install_git.md" %}
 
 ## Git repomuzu oluşturmak
 
-Git, kod reposu (veya "repository") denen belli dosyaların değişikliklerini izler. Projemiz için bir tane oluşturalım. Konsolunuzu açın ve `djangogirls` klasöründe aşağıdaki komutları çalıştırın:
-
-> **Not** Reponuzu başlatmadan önce, `pwd` (OS/Linux) veya `cd` (Windows) komutu ile bulunduğunuz dizini kontrol edin. `djangogirls` dizininde olmanız gerekiyor.
-
-Hatırlatma: Kullanıcı adı seçerken özel Türkçe karakter kullanmayın.
-```
-$ git init
-Initialized empty Git repository in ~/djangogirls/.git/
-$ git config --global user.name "Adınız"
-$ git config --global user.email you@example.com
-```    
-
-Git reposunu başlatma işi, proje başına bir kere yapmamız gereken birşey (ayrıca kullanıcı adı ve eposta adresini tekrar girmenize gerek olmayacak).
-
-Git bu dizindeki tüm dizin ve dosyalardaki değişiklikleri kaydedecek, ama takip etmemesini istediğimiz bazı dosyalar var. Bunu dizinin dibinde `.gitignore` adında bir dosya oluşturarak yapıyoruz. Editörünüzü açın ve aşağıdaki içeriklerle yeni bir dosya yaratın:
-
-
-```    
-*.pyc
-__pycache__
-myvenv
-db.sqlite3
-.DS_Store
-```    
+Git, bir kod deposu (repository veya kısaca "repo") olarak adlandırılan belirli dosyalardaki değişiklikleri izler. Projemiz için bir tane oluşturalım. Konsolunuzu açın ve `djangogirls` klasöründe aşağıdaki komutları çalıştırın:
 
-Ve "djangogirls" dizinin en üst seviyesine `.gitignore` olarak kaydedin.
+> **Not** Reponuzu oluşturmadan önce `pwd` (Mac OS X/Linux) ya da `cd` (Windows) komutu ile şu an çalışmakta olan dizininizi kontrol edin. `djangogirls` dizininde olmanız gerekiyor.
 
-> **Not** Dosya adının başındaki nokta önemli! Eğer dosyayı oluştururken zorlanırsanız (örneğin Mac'ler Finder ile nokta ile başlayan dosya yaratmanızdan hoşlanmıyor), editörünüzdeki "Farklı Kaydet" özelliğini kullanın, kesin çalışır.
+{% filename %}komut-satırı{% endfilename %}
 
-`git add` kullanmadan önce veya nelerin değiştiğinden emin değilseniz, `git status` komutunu kullanmakta yarar var. Bu, yanlış dosyaların eklenmesi ve gönderilmesi gibi istenmeyen sürprizlerin engelenmesine yardımcı olacak. `git status` komutu, takip edilmeyen/değişen/gönderilecek dosyalar (staged), dal durumu (branch status) gibi bilgiler verir. Çıktının aşağıdaki gibi olması gerekiyor:
+    Hatırlatma: Kullanıcı adı seçerken Türkçe karakter kullanmayın.
+    $ git init 
+    Initialized empty Git repository in ~/djangogirls/.git/ 
+    $ git config --global user.name "Adınız" 
+    $ git config --global user.email you@example.com
+    
 
-```    
-$ git status
-On branch master
+Git reposunu başlatmak proje başına sadece bir kere yapmamız gereken bir şeydir (ve kullanıcı adınız ve mailinizi tekrar girmeniz gerekmeyecek).
 
-Initial commit
-
-Untracked files:
-    (use "git add <dosya>..." to include in what will be committed)
-
-         .gitignore
-         blog/
-         manage.py
-         mysite/
+Git bu dizindeki tüm dizin ve dosyalardaki değişiklikleri kaydedecek, ama takip etmemesini istediğimiz bazı dosyalar var. Bunu dizinin dibinde `.gitignore` adında bir dosya oluşturarak yapıyoruz. Editörünüzü açın ve aşağıdaki içeriklerle yeni bir dosya yaratın:
 
-nothing added to commit but untracked files present (use "git add" to track)
-```     
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+Ve onu `.gitignore` ismi ile "djangogirls" dizinine kaydedin.
+
+> **Not** Dosya adının başındaki nokta önemli! Eğer dosyayı oluştururken zorluk yaşarsanız (örneğin Mac'ler Finder'dan nokta ile başlayan bir dosya oluşturmanızdan hoşlanmazlar), editörünüzdeki "Farklı Kaydet" özelliğini kullanın böylece çalışacaktır.
+> 
+> **Not** `.gittignore` dosyasında belirttiğiniz dosyalardan biri `db.sqlite3` dosyası. Bu dosya tüm gönderilerinizin saklandığı yerel veritabanınızdır. Bunu reponuza eklemek istemiyoruz çünkü PythonAnywhere'deki web siteniz farklı bir veritabanı kullanacak. Bu veritabanı geliştirme makinenizdeki gibi SQLite olabilir ama genelde sitenizdeki çok daha fazla ziyaretçiyi kaldırabilecek MySQL adı verilen bir veritabanı kullanacaksınız. Her iki durumda da, GitHub kopyası için SQLite veritabanınızı yok saymanız, şu ana kadar oluşturduğunuz tüm gönderilerin lokalinizde kalması ve yalnızca lokal olarak kullanılabilmeniz anlamına geliyor. Canlıda onlara ulaşabilmeniz için yeniden eklemek zorundasınız. Lokal veritabanınızı farklı şeyleri test edebileceğiniz ve blogunuzdaki gerçek gönderilerinizi silmekten korkmayacağınız iyi bir oyun alanı olarak düşünmelisiniz.
+
+`git add` kullanmadan önce veya nelerin değiştiğinden emin değilseniz, `git status` komutunu kullanmakta yarar var. Bu, yanlış dosyaların eklenmesi ve gönderilmesi gibi istenmeyen sürprizlerin engelenmesine yardımcı olacak. `git status` komutu, takip edilmeyen/değişen/gönderilecek dosyalar (staged), dal durumu (branch status) gibi bilgiler verir. Çıktıda aşağıdakine benzer olmalıdır:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git status 
+    On branch master 
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <dosya>..." to include in what will be committed)
+    
+             .gitignore
+             blog/
+             manage.py
+             mysite/ 
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
 
 Ve son olarak değişikliklerimizi kaydediyoruz. Komut satırına gidin ve aşağıdaki komutları çalıştırın:
 
-```     
-$ git add -A
-$ git commit -m "Django Girls uygulamam, ilk commit"
-  [...]
-  13 files changed, 200 insertions (+)
-  create mode 100644 .gitignore
-  [...]
-  create mode 100644 mysite/wsgi.py
-```     
-
-## Kodunuzu Github'a gönderme
-
-[GitHub.com>][2] adresine gidin ve kendinize yeni bedava bir kullanıcı hesabı açın. (Bunu atölye hazırlıklarında zaten yaptıysanız, harika!)
-
-Arkasından "ilk-blogum" (veya "my-first-blog") isminde yeni bir repo oluşturun. "Initialize with a README" kutucuğunu işaretlemeden bırakın, .gitignore opsiyonunu boş bırakın (onu elle yaptık) ve 'License'ı 'None' olarak bırakın.
-
-![][3]
-
- [3]: images/new_github_repo.png
-
-> **Not** `ilk-blogum` ismi önemli -- başka birşey de seçebilirsiniz, ama aşağıdaki yönergelerde çok geçiyor, her seferinde değiştirmeniz gerekir. En kolayı `ilk-blogum` ismi ile devam etmek.
-
-Bir sonraki ekranda, repo'yu klonlamak için gereken URL'yi göreceksiniz. "HTTPS"li versiyonunu seçin, kopyalayın. Birazdan onu komut penceresine yapıştıracağız:
-
-![][4]
-
- [4]: images/github_get_repo_url_screenshot.png
-
-Şimdi bilgisayarınızdaki Git reposunu Github'daki repo ile ilişkilendirmemiz gerekiyor.
-
-Aşağıdakini komut satırına yazın (`<github-kullanıcı-adınız>` kısmını Github hesabını yarattığınız sırada kullandığınız kullanıcı adı ile değiştirin, büyüktür küçüktür işaretlini eklemeyin):
-
-```
-$ git remote add origin https://github.com/<github-kullanıcı-adınız>/ilk-blogum.git
-$ git push -u origin master
-```     
-
-Github kullanıcı adı ve şifrenizi girin, arkasından aşağıdakine benzer bir şey görmeniz gerekiyor:
-
-```
-Username for 'https://github.com': zeynep
-Password for 'https://zeynep@github.com':
-Counting objects: 6, done.
-Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
-Total 3 (delta 0), reused 0 (delta 0)
-To https://github.com/zeynep/ilk-blogum.git
-  * [new branch] master -> master
-Branch master set up to track remote branch master from origin.
-```    
-
-<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extention -->
-
-Kodunuz artık Github'da. Siteye girin ve kontrol edin! İyi bir çevrede olduğunu göreceksiniz - [Django][5], the [Django Girls Tutorial][6], ve daha birçok harika açık kaynak yazılım projesi de kodlarını Github'da tutuyor :)
-
- [5]: https://github.com/django/django
- [6]: https://github.com/DjangoGirls/tutorial
-
-# Blogumuzun PythonAnywhere üzerinde kurulumu
-
-> **Not** En baştaki kurulum adımlarında PythonAnywhere hesabını açmış olabilirsiniz - öyleyse bu kısmı tekrar yapmanıza gerek yok.
-
-{% include "/deploy/signup_pythonanywhere.md" %}
-
-## Kodunuzu PythonAnywhere üzerine çekmek
-
-PythonAnywhere'de hesap açtığınızda, 'dashboard' (gösterge paneli) sayfanıza veya "Consoles" sayfasına yönlendirileceksiniz. "Bash" konsolu başlatma seçeneğini seçin -- bu bilgisayarınızdaki konsolun PythonAnywhere versiyonu.
-
-> **Not** PythonAnywhere Linux tabanlı, o yüzden kendi makinanız Windows ise konsol biraz farklı gözükecektir.
-
-Reponuzun bir klonunu yaratarak kodumuzu Github'dan PythonAnywhere üzerine çekelim. Aşağıdakileri PythonAnywhere konsoluna yazın (`<github-kullanıcı-adınız>` yerine kendi Github kullanıcı adınızı yazmayı unutmayın):
-
-```
-$ git clone https://github.com/<github-kullanıcı-adınız>/ilk-blogum.git
-```    
-
-Bu kodunuzun bir kopyasını PythonAnywhere üzerine indirecektir. `tree ilk-blogum` yazarak kontrol edin:
-
-```
-$ tree ilk-blogum
-ilk-blogum/
-├── blog
-│   ├── __init__.py
-│   ├── admin.py
-│   ├── migrations
-│   │   ├── 0001_initial.py
-│   │   └── __init__.py
-│   ├── models.py
-│   ├── tests.py
-│   └── views.py
-├── manage.py
-└── mysite
-├── __init__.py
-├── settings.py
-├── urls.py
-└── wsgi.py
-```
-
-
-### PythonAnywhere üzerine bir virtualenv (sanal ortam) oluşturmak
-
-Bilgisayarınızda nasıl bir virtualenv (sanal ortam) oluşturduysanız, aynı şekilde PythonAnywhere üzerinde de oluşturabilirsiniz. Bash konsoluna, aşağıdakileri yazın:
-
-```
-$ cd ilk-blogum
-
-$ virtualenv --python=python3.4 myvenv
-Running virtualenv with interpreter /usr/bin/python3.4
-[...]
-Installing setuptools, pip...done.
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "Django Girls uygulamasında ilk commit'im"
+     [...]
+     13 dosya değiştirildi, 200 eklenen (+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Kodunu GitHub'a ekle
+    [GitHub.com](https://www.github.com) adresine gidip yeni ve ücretsiz bir hesap için kaydol. (Workshop prep(atölye hazırlığı) aşamasında yaptım zaten ben bunu diyorsanız, bu harika!)
+    
+    Sonra yeni bir repository oluşturup "my-first-blog" ismini verin. "BENİOKU dosyası ile başlat" onay kutusunu işaretlemeyin, .gitignore seçeneğini boş bırakın (biz manual olarak yaptık) ve Lisans'ı Hiçbiri(None) olarak ayarlayın.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Not**`my-first-blog` ismi önemlidir – başka bir isim seçebilirsiniz, ancak aşağıdaki talimatlarda bu isim bir çok kez geçecektir ve bu bölümlerde her seferinde seçtiğiniz ismi kullanmanız gerekir. `my-first-blog` ismini kullanırsanız muhtemelen daha kolay olacaktır.
+    
+    Sonraki ekranda repo'nun klon URL'sini göreceksiniz. "HTTPS" ile başlayanı seçin, kopyalayın ve şunu terminale yapıştırın:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Şimdi Git repository'i bilgisayarınızdaki bir GitHub'a bağlamamız gerekiyor.
+    
+    Aşağıdakileri konsol ekranına geçirin (`<your-github-username>` kısmını köşeli parantez olamadan GitHub kullanıcı adınızla değiştirin):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />GitHub kullanıcı adınızı ve şifrenize girdikten sonra böyle bir şey görmelisiniz:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': zeynep Password for 'https://zeynep@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. https://github.com/hjwp/my-first-blog.git için toplam 3 (delta 0), yeniden 0 (delta 0)
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Siteye girin ve kontrol edin!  İleride kendini iyi bir şirkette bulacaksın – [Django](https://github.com/django/django), [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial) 'li ve bir çok büyük açık kaynak projesi kodlarını GitHub'da barındırır. :)
+    
+    
+    # PythonAnywhere'de blog açma
+    
+    &gt; **Not** Siz zaten bir PythonAnywhere hesabına sahip olabilirsiniz – Eğer öyleyse tekrar açmanız gerekmez.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## PythonAnywhere'den kodumuzu çekiyoruz
+    
+    PythonAnywhere'e kaydolduğunuzda, gösterge tablonuza veya "Konsollar" sayfasına yönlendirilirsiniz. "Bash" konsolunu başlat seçeneğini seçin - bu, bilgisayarınızdaki konsolun bir PythonAnywhere versiyonudur.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Not** PythonAnywhere Linux tabanlıdır, yani Windows kullanıyorsanız bu konsol bilgisayarınızdakinden biraz daha farklı görünecektir.
+    
+    Reponuzun bir klonunu yaratarak kodumuzu Github'dan PythonAnywhere üzerine çekelim. Aşağıdakileri PythonAnywhere konsoluna geçirin (`&lt;your-github-username&gt;` yerine GitHub kullanıcı adınızın geleceğini unutmayın):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />Bu işlem kodunuzun bir kopyasını PythonAnywhere'a çekecektir. Konsola `tree my-first-blog` yazarak kontrol edebilirsiniz:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### PythonAnywhere üzerinde bir virtualenv oluşturuyoruz
+    
+    Tam olarak kendi bilgisayarınızda yaptığınız gibi PythonAnywhere üzerinde bir virtualenv oluşturabilirsiniz. Bash konsolunda şunu yazın:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
 
 $ source myvenv/bin/activate
 
-(myvenv) $  pip install django whitenoise
-Collecting django
-[...]
-Successfully installed django-1.11 whitenoise-2.0
-```    
-
-> **Not** `pip install` birkaç dakika sürebilir. Sabır, sabır! Ama 5 dakikadan uzun sürüyorsa, birşeyler yanlış olmuştur. Eğitmeninize sorun.
-
-<!--TODO: think about using requirements.txt instead of pip install.-->
-
-### Statik dosyaların toplanması.
-
-"whitenoise"un ne olduğunu merak ettiniz mi? "Statik dosyalar" için kullanılan bir araç. Statik dosyalar, HTML veya CSS dosyaları gibi düzenli olarak değişmeyen veya kod çalıştırmayan dosyalardır. Bu dosyalar sunucularda bilgisayarımızdakinden farklı çalışırlar. Bu yüzden onları sunucudan yayınlamak için "whitenoise" gibi bir araca ihtiyacımız var.
-
-Tutorial'ın ilerleyen kısımlarında sitemizin CSS'ini düzenlerken statik dosyalar konusuna biraz daha fazla gireceğiz.
-
-Şimdilik sadece sunucuda `collectstatic` diye ek bir komut çalıştıracağız. Bu komut, Django'ya sunucdaki bütün statik dosyaları toparlamasını söyler. An itibariyle bunlar çoğunlukla admin sitesini güzelleştiren dosyalar.
-
-```
-(myvenv) $ python manage.py collectstatic
-
-You have requested to collect static files at the destination
-location as specified in your settings:
-
-  /home/zeynep/ilk-blogum/static
-
-This will overwrite existing files! (Bu işlem halihazırdaki dosyalarınız üzerinde değişiklik yapar!)
-Are you sure you want to do this? (Bu işlemi yapmak istediğinizden emin misiniz?)
-
-Type 'yes' to continue, or 'no' to cancel: yes (Onaylıyorsanız 'yes', vazgeçtiyseniz 'no' yazın)
-```    
-
-"yes" yazın ve işte başladı! Bilgisayarlara sayfa sayfa yazı yazdırmayı sevmiyor musunuz? Ben hep beraberinde küçük küçük sesler çıkarırım. Trr, trr, trr...
-
-```
-Copying '/home/zeynep/ilk-blogum/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/actions.min.js'
-Copying '/home/zeynep/ilk-blogum/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/inlines.min.js'
-[...]
-Copying '/home/zeynep/ilk-blogum/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/changelists.css'
-Copying '/home/zeynep/ilk-blogum/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/base.css'
-62 static files copied to '/home/zeynep/ilk-blogum/static'.
-```    
-
-### PythonAnywhere üzerinde veritabanının oluşturulması
-
-Bilgisayarınız ve sunucu arasında farklı olan bir başka şey daha: farklı bir veritabanı kullanıyor. Dolayısıyla bilgisayarınızdaki ve sunucudaki kullanıcı hesapları ve blog yazıları farklı olabilir.
-
-Sunucudaki veritabanına aynen bilgisayardaki gibi `migrate` (taşımak) ve `createsuperuser` (yetkili bir kullanıcı oluşturmak) komutlarıyla oluşturup ilk örnek verilerle ile doldurabiliriz:
-
-```    
-(myvenv) $ python manage.py migrate
-Operations to perform:
-[...]
-Applying sessions.0001_initial... OK
-(myvenv) $ python manage.py createsuperuser
-```    
-
-## Blog'umuzu web uygulaması olarak yayınlama
-
-Artık kodumuz PythonAnywhere üzerinde, virtualenv'imiz hazır, statik dosyalar toplandı, ve veritabanı hazırlandı. Blogumuzu bir web uygulaması olarak yayınlamaya hazırız!
-
-PythonAnywhere logosuna tıklayarak 'dashboard'a geri gidin, burda **Web** sekmesine tıklayın. En son **Add a new web app** (yeni bir web uygulaması yaratın) linkine tıklayın.
-
-Açılan pencerede alan adınızı kontrol edin, **manual configuration** (elle konfigürasyon)'ı seçin ("Django" opsiyonunu *değil*). Arkasından **Python 3.4**'ü seçin ve işlemi bitirmek için 'Next'e basın.
-
-> **Not** "Manual configuration" seçeneğini seçtiğinizden emin olun, "Django" seçeneğini değil. Hazır PythonAnywhere Django kurulumunu seçmek için fazla havalıyız ;-)
-
-### virtualenv'in (sanal ortamın) ayarlanması
-
-Son bahsettiğimiz adım sizi web uygulamanızın PythonAnywhere ayar ekranına getirecek. Sunucudaki uygulamanızda değişiklik yapmak istediğinizde bu ekranı kullanmanız gerekiyor.
-
-![][7]
-
- [7]: images/pythonanywhere_web_tab_virtualenv.png
-
-"Virtualenv" bölümünde "Enter the path to a virtualenv" (virtualenv için dizin yolu girin) linkini tıklayın ve şunu yazın: `/home/<kullanıcı-adınız>/ilk-blogum/myvenv`. Devam etmeden önce, dizin yolunu kaydetmek için tik işareti olan mavi kutuyu tıklayın.
-
-> **Not** İlgili yeri kendi kullanıcı adınızı yazın. Eğer hata yaparsanız, PythonAnywhere size bir uyarı gösterecektir.
-
-### WSGI dosyasının ayarlanması
-
-Django, "WSGI protokolü"nü kullanarak çalışır. WSGI, PythonAnywhere'in de desteklediği Python kullanan websitelerinin servis edilmesi için kullanılan bir standart. PythonAnywhere'in Django blogumuzu anlaması için WSGI ayar dosyasını düzenleyiyoruz.
-
-"WSGI Configuration file" (WSGI ayar dosyası) linkine tıklayın ("Code" denen kısımda, sayfanın üst tarafında -- adı `/var/www/<kullanıcı-adınız>_pythonanywhere_com_wsgi.py`'a benzer birşey olacak). Burdan bir edöitöre yönlendirileceksiniz.
-
-Tüm içeriği silin ve onların yerine aşağıdakileri yazın:
-
-```python
-import os
-import sys
-
-path = '/home/<kullanıcı-adınız>/ilk-blogum'  # burada kendi kullanıcı adınızı yazın
-if path not in sys.path:
-    sys.path.append(path)
-
-os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
-
-from django.core.wsgi import get_wsgi_application
-from whitenoise.django import DjangoWhiteNoise
-application = DjangoWhiteNoise(get_wsgi_application())
-```    
-
-> **Not** `<kullanıcı-adınız>` diye geçen kısıma kendi kullanıcı adınızı yazmayı unutmayın
-
-Bu dosyanın işi, PythonAnywhere'e web uygulamamızın nerde yaşadığını ve Django ayar dosyasının adının ne olduğunu söylemek. Aynı zamanda "whitenoise" statik dosya aracını ayarlıyor.
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Not** `pip install`(pip kurulumu) adımı bir kaç dakika sürebilir.  Sabır, sabır!  Ama beş dakikadan daha uzun sürüyorsa bir sorun var demektir.  Koçuna sor.
+    
+    &lt;!--TODO: pip kurulumu yerine requirements.txt kullanmayı düşünün.--&gt;
+    
+    ### PythonAnywhere' veritabanı kurulumu
+    
+    İşte kendi bilgisayarınızla sunucu arasındaki başka bir fark daha: farklı bir veri tabanı kullanıyor. Dolayısıyla, kullanıcı hesapları ve gönderiler sunucuda ve bilgisayarınızda farklı olabilir.
+    
+    Tıpkı kendi bilgisayarınızda yaptığımız gibi, sunucudaki veritabanını `migrate` ve` createsuperuser` ile başlatmak için aşağıdaki kodları kullanalım:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Blogumuzu bir web uygulaması olarak yayınlama
+    
+    Şimdi kodumuz PythonAnywhere'a geçirildi, virtualenv'ımız hazır ve veritabanı başlatıldı. Bir web uygulaması olarak yayına hazırız!
+    
+    Site logosuna tıklayarak PythonAnywhere gösterge tablosuna geri dönün ve ** Web** sekmesini tıklayın. Son olarak, **Add a new web app** kısmına tıklayarak web uygulaması ekleyin.
+    
+    Alan adınızı onayladıktan sonra, iletişim kutusundaki **manual configuration** (N.B. - *değil* "Django" seçeneği) seçeneğini işaretleyin. Sonrasında **Python 3.6** 'yı seçin ve sihirbazı bitirmek için İleri butonuna tıklayın.
+    
+    &gt; **Not** "Manual configuration" seçeneğini seçtiğinize emin olun, "Django" olanı değil. Varsayılan PythonAnywhere Django kurlumu için çok iyiyiz. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    "Virtualenv" bölümünde, "Virtualenv yolunu girin" diyen kırmızı metne tıklayın ve `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/` dosya yolunu girin. Taşımadan önce dizin yolunu kaydetmek için onay işareti olan mavi kutuyu tıklayın.
+    
+    &gt; **Not** Gereken yerlere kendi PythonAnywhere kullanıcı adınızı girin. Eğer bir hata yaparsanız PythonAnywhere size küçük bir uyarı kutusunda gösterecektir.
+    
+    
+    Django, PythonAnywhere'in desteklediği Python'u kullanarak, web sitelerini sunmak için bir standart olan "WSGI" protokolüyle çalışır. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    "WSGI yapılandırma dosyası" bağlantısını tıkladıktan sonra (sayfanın üst kısmına yakın "kod" bölümünde `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py` gibi bir adlandırmaya sahip olacak) bir editöre yönlendirileceksin.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+Bu dosyanın işi, PythonAnywere'e uygulamanızın nerde yaşadığını ve Django settings dosyasının adının ne olduğunu söylemek.
+
+`StaticFilesHandler` CSS'ler için var. Lokaldeki geliştirmenizde bu `runserver` komutu ile otomatik halloluyor. Tutorial'ın ilerleyen kısımlarında sitemizin CSS'ini düzenlerken statik dosyalar konusuna biraz daha fazla gireceğiz.
 
 **Save** (kaydet)'e basın. Arkasından **Web** sekmesine geri gidin.
 
@@ -300,26 +235,24 @@ Hazırız! Yeşil ve büyük **Reload** (Yeniden yükle) butonuna tıklayın. Uy
 
 ## Hata ayıklama önerileri
 
-Eğer sitenize girdiğinizde bir hata görürseniz, hata ayıklama bilgileri için ilk bakacağınız yer, **error log**'unuz (hata kayıtlarınız). Buraya olan linki PythonAnywhere'deki [Web sekme][8]sinde bulabilirsiniz. Burda hata mesajları olup olmadığına bakın; en yeni mesajlar en altta. Sık karşılaşılan problemler şunlar:
-
- [8]: https://www.pythonanywhere.com/web_app_setup/
+Eğer sitenize girdiğinizde bir hata görürseniz, hata ayıklama bilgileri için ilk bakacağınız yer, **error log**'unuz (hata kayıtlarınız). Buraya olan linki PythonAnywhere'deki [Web sekme](https://www.pythonanywhere.com/web_app_setup/)sinde bulabilirsiniz. Burda hata mesajları olup olmadığına bakın; en yeni mesajlar en altta. Sık karşılaşılan problemler şunlar:
 
-*   Konsolda yaptığımız adımlardan birinin unutulması: virtualenv'in oluşturulması, çalışır hale getirilmesi, içine Django'nun kurulumu, collectstatic'in çalıştırılması, veritabanının taşınması (migrate ettirilmesi).
+- Konsolda yaptığımız adımlardan birinin unutulması: virtualenv'in oluşturulması, çalışır hale getirilmesi, içine Django'nun kurulumu, veritabanının taşınması (migrate ettirilmesi).
 
-*   Web sekmesinde virtualenv dizin yolunda bir hata yapılması -- eğer problem varsa, ilgili yerde küçük kırmızı bir hata mesajı olur.
+- Web sekmesinde virtualenv dizin yolunda bir hata yapılması durumunda - genellikle kırmızı hata mesajı problem olduğunda oradadır.
 
-*   WSGI ayar dosyasına bir hata yapmak -- ilk-blogum dizinine olan yolu doğru yazdığınızdan emin misiniz?
+- WSGI ayar dosyasında hata yapıldı - my-first-blog dosyasının yolunun doğruluğundan emin misniz?
 
-*   Virtualenv'ınız için seçtiğiniz Python versiyonu web uygulamanız için seçtiğiniz Python versiyonu ile aynı mı? İkisinin de 3.4 olması gerekiyor.
+- Virtualenv'ınız için seçtiğiniz Python versiyonu web uygulamanız için seçtiğiniz Python versiyonu ile aynı mı? İkisinin de 3.6 olması gerekiyor.
 
-*   [Python Anywhere vikisinde (bilgi sayfalarında) genel hata ayıklama önerileri][9] bulunuyor.
-
- [9]: https://www.pythonanywhere.com/wiki/DebuggingImportError
+PythonAnywhere wiki</a> üzerinde bazı general hata giderme tüyoları mevcuttur.</p> 
 
 Ve eğitmeniniz size yardıma hazır, unutmayın!
 
 # Siteniz canlıda!
 
-Sitenizin varsayılan sayfası "Welcome to Django" diyor olmalı, aynen bilgisayarınızda olduğu gibi. URL'nin sonuna `/admin/` yazın, 'giriş' tuşuna bastığınızda admin sitesi açılacak. Kullanıcı adı ve şifrenizle giriş yapın, sunucuda yeni blog yazıları girebildiğinizi göreceksiniz.
+Siteniz için bulunan varsayılan sayfa ''İşe yaradı!'' demelidir. Tıpkı yerel bilgisayarınızda olduğu gibi. URL'nin sonuna `/admin/` yazın, 'giriş' tuşuna bastığınızda admin sitesi açılacak. Kullanıcı adı ve şifrenizle giriş yapın, sunucuda yeni blog yazıları girebildiğinizi göreceksiniz.
+
+Birkaç gönderi oluşturduktan sonra, lokalinize (PythonAnywhere'e değil) geri dönebilirsiniz. Değişiklikleri burda lokalinizde yapacaksınız. Bu web geliştirmekte yaygın bir akışıdır - değişiklikleri yerel olarak yapınız, bu değişiklikleri GitHub'a gönderin, değişikliklerinizi canlı Web sunucusuna çekin. Bu canlı web sitenizi bozmadan çalışmanızı ve yeni şeyler denemenizi sağlar. Bayağı havalı, di mi?
 
-Kendinize *KOCAMAN* bir aferin diyin! Yayına alma web geliştirme işinin en uğraştırmalı kısımlarından biridir ve genelde çalışana kadar insanların birkaç gününü alır. Ama işte siteniz canlıda, gerçek internette!
+Kendinize *KOCAMAN* bir aferin diyin! Yayına alma web geliştirme işinin en uğraştırmalı kısımlarından biridir ve genelde çalışana kadar insanların birkaç gününü alır. Ama işte siteniz canlıda, gerçek internette!
\ No newline at end of file
diff --git a/tr/deploy/install_git.md b/tr/deploy/install_git.md
index af163ac1ac3..84417d178ca 100755
--- a/tr/deploy/install_git.md
+++ b/tr/deploy/install_git.md
@@ -1,17 +1,52 @@
-### Windows
+Git, birçok programcı tarafından kullanılan bir "sürüm kontrol sistemi"dir. Bu yazılım dosyaların zaman içindeki değişimlerini izler, böylelikle sonradan eski sürümlere ulaşabilirsiniz. Biraz Microsoft Word'deki "değişiklikleri izle" özelliği gibi, ama çok daha güçlü.
 
-Git'i [git-scm.com](http://git-scm.com/) adresinden indirebilirsiniz. 5. adıma kadar "next"e basarak geçebilirsiniz. 5. adımda "Adjusting your PATH environment" dediği yerde, "Run Git and associated Unix tools from the Windows command-line" (en alttaki opsiyonu) seçin. Onun dışında, varsayılanlar iyi. Kodu çekerken Windows-stili, kodu gönderirken Unix-stili satır sonları iyidir.
+## Git'i kurmak
 
-### MacOS
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
 
-Git'i [git-scm.com](http://git-scm.com/)'den indirin ve yönergeleri izleyin.
+Git'i [git-scm.com](https://git-scm.com/) adresinden indirebilirsiniz. 5. adıma kadar "next"e basarak geçebilirsiniz. 5. adımda "Adjusting your PATH environment" dediği yerde, "Run Git and associated Unix tools from the Windows command-line" (en alttaki opsiyonu) seçin. Onun dışında, varsayılanlar iyi. Kodu çekerken Windows-stili, kodu gönderirken Unix-stili satır sonları iyidir.
 
-### GNU/Linux
+Kurulum başarı ile tamamlandıktan sonra komut ıstemini veya powershelli yeniden başlatmayı unutmayın.<!--endsec-->
 
-Halihazırda yüklü değilse, git'i paket yöneticinizle indirebilirsiniz. Şunlardan birini deneyin:
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
 
+Git'i [git-scm.com](https://git-scm.com/)'den indirin ve yönergeleri izleyin.
+
+> **Not** Eğer OS X 10.6, 10.7 ya da 10.8 kullanıyorsanız, giti buradan indirmeniz gerekmektedir: [OS X Snow Leopard için Git Kurulumu](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+```bash
+$ sudo apt-get install git
 ```
-sudo apt-get install git
-# veya
-sudo yum install git
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+```bash
+$ sudo dnf install git
 ```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/tr/deploy/signup_pythonanywhere.md b/tr/deploy/signup_pythonanywhere.md
index 86ec0f9f316..2f88ae2c9b9 100755
--- a/tr/deploy/signup_pythonanywhere.md
+++ b/tr/deploy/signup_pythonanywhere.md
@@ -1,5 +1,5 @@
-Sırada PythonAnywhere sitesinde bedava bir "Beginner" ( yeni başlayan) hesabı açma işi var.
+Sırada, PythonAnywhere'de ücretsiz "Yeni" bir hesaba kaydolma işi var.
 
-  * [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
 
-> **Not** Burada kullanıcı isminizi seçerken bilin ki blogunuzun URL'si `kullanıcıadınız.pythonanywhere.com` şeklinde olacak. O yüzden ya kendi rumuzunuzu(nickname) seçin ya da blogunuzun konusu ile ilgili bir isim seçin.
+> **Not** Burada kullanıcı adınızı seçerken, blogunuzun URL'sinin `yourusername.pythonanywhere.com`, şeklini alacağını unutmayın, bu nedenle blogunuzun neyle ilgili olduğu için kendi takma adınızı veya bir adınızı seçin.
\ No newline at end of file
diff --git a/tr/django/README.md b/tr/django/README.md
index ec57420a187..64a35089e24 100755
--- a/tr/django/README.md
+++ b/tr/django/README.md
@@ -1,27 +1,27 @@
 # Django nedir?
 
-Django (*/ˈdʒæŋɡoʊ/ jang-goh*) Python ile yazılmış ücretsiz ve açık kaynak bir web uygulama iskeletidir (framework). Bir web iskeleti, websitesi geliştirmeyi hızlandıran ve kolaylaştıran bir grup bileşendir.
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) Python ile yazılmış özgür ve açık kaynak bir web uygulama iskeletidir (framework). Bir web iskeleti, websitesi geliştirmeyi hızlandıran ve kolaylaştıran bir grup bileşendir.
 
-Bir websitesi geliştirdiğinizde benzer türde bileşenlere her zaman ihtiyacınız olur: kullanıcılar için kimlik denetimi (üye olma, üye girişi, üye çıkışı), websiteniz için bir yönetim paneli, formlar, dosyaları yüklemek için bir yol, vs.
+Bir web sitesi geliştirdiğinizde benzer türde bileşenlere her zaman ihtiyacınız olur: kullanıcılar için kimlik denetimi (üye olma, üye girişi, üye çıkışı), websiteniz için bir yönetim paneli, formlar, dosyaları yüklemek için bir yol, vs.
 
-Şansınıza çok önceden başka insanlar yeni bir site oluştururken web geliştiricilerinin benzer problemlerle karşı karşıya kaldığını fark etti ve bir araya gelip iskeletler (Django bunlardan biri) oluşturdular. Bu iskeletler size kullanabileceğiniz hazır bileşenler verir.
+Şanslısınız ki, uzun zaman önce başkaları web geliştiricilerinin yeni bir site yaratırken benzer problemlerle karşı karşıya geldiğini farkettiler ve takım kurup, kullanmanız için hazır bileşenleri olan iskeletler (ki Django bunlardan bir tanesi) oluşturdular.
 
-İskeletler sizi tekerleği yeniden icat etmekten kurtarır ve websitesi geliştirirken yükünüzün bir kısmını hafifletmekte yardımcı olur.
+Frameworkler, siz yeni bir site oluştururken yükünüzü hafifletmek için tekerleği yeniden icat etmek zorunda.
 
 ## Neden bir iskelete ihtiyacınız var?
 
-Django'nun tam olarak ne işe yaradığını anlamak için sunucular konusuna daha çok girmemiz gerekiyor. İlk bilmeniz gereken şey, sunucunuzun ondan bir web sayfası sunmasını istediğinizi bilmesi gerektiği.
+Django aslında ne işe yaradığını anlamak için, sunuculara daha yakından bakmamız gerekiyor. İlk olarak sunucunun, onun size bir web sitesi sunmasını istediğinizi bilmesi gerekiyor.
 
-Bir posta kutusunun (port) gelen mektuplar (requests) için izlendiğini düşünün. Bu bir web sunucusu tarafından yapılıyor. Sunucu mektubu okuyor ve bir web sayfası göndererek cevap veriyor. Ama bir şey gönderecekseniz, içeriğe ihtiyacınız var. Django içeriği oluşturmanıza yardımcı olan bir şeydir.
+Bir posta kutusunun (port) gelen mektuplar (requests) için izlendiğini düşünün. Bu bir web sunucusu tarafından yapılıyor. Web sunucusu mektubu okur ve ardından bir web sayfası ile cevap verir. Ama bir şey gönderecekseniz, içeriğe ihtiyacınız var. Django içeriği oluşturmanıza yardımcı olan bir şeydir.
 
 ## Birisi sunucunuzdan bir web sitesi istediğinde ne olur?
 
-Web sunucusuna bir istek geldiğinde tam olarak ne istendiğini çıkarmak için Django'ya geçirilir. O da önce web sayfasının adresini alır ve ne yapması gerektiğini çıkarmaya çalışır. Bu kısım Django'nun **url çözücüsü** (urlresolver) tarafından yapılıyor (websitesi adresine URL - Uniform Resource Locator - deniyor, dolayısıyla *url çözücü* ismi mantıklı oluyor). Çok akıllı değil - bir kalıp listesi alıyor ve URL'yi bunlarla eşleştirmeye çalışıyor. Django kalıpları yukarıdan aşağı kontrol ediyor ve eşleşen bir şey varsa isteği (request'i) ilişkilendirilmiş işleve (fonksiyona) geçiriyor. Bu işlev bir *view*'a karşılık geliyor. View kelimesi Türkçe'de görünüm anlamına gelir. Django'da özel bir terim olduğu için, biz sadece <1>view</1> kelimesini kullanacağız.).
+Bir istek bir web sunucusuna geldiğinde, Django'ya aktarılır aslında ve Django da istenin ne olduğunu anlamaya çalışır. O da önce bir web sayfası adresi alır ve ne yapacağını anlamaya çalışır. Bu bölüm Django'nun **urlresolver** tarafından yapılır (unutmayın bir web sitesi adresi URL – Uniform Resource Locator – olarak adlandırılır – böylece *urlresolver* anlamlı hale gelir). Çok akıllı değildir - kalıpların bir listesini alır ve URL'yi eşleştirmeye çalışır. Django kalıpları üstten alta doğru denetler ve eşleşen bir şey varsa isteği ilgili işleve( *view* olarak adlandırlan) aktarır.
 
 Mektup dağıtan bir postacı düşünün. Sokak boyunca yürüyor ve her evin numarasını mektubun üstündeki numara ile karşılaştırıyor. Eğer eşleşirse, mektubu oraya koyuyor. Url çözücü işte böyle çalışır!
 
-*view* işlevinde her türlü ilginç şey yapılıyor: Bir bilgi için veritabanına bakabiliriz. Belki de kullanıcı veride bir şeyin değişmesini istemiştir? "Lütfen iş tanımımı değiştirin" diyen bir mektup gibi. *view* buna yapmaya izniniz olup olmadığını kontrol edebilir, sonra da sizin için iş tanımınızı güncelleyip geriye "Yapıldı!" diye bir ileti gönderir. Arkasından *view* bir cevap üretir ve Django bunu kullanıcının web tarayıcısına gönderebilir.
+Tüm ilginç şeyler *view (görünüm)* fonksiyonunda yapılır: bir bilgi için veritabanına bakabiliriz. Belki de kullanıcı veride bir şeyin değişmesini istemiştir? "Lütfen iş tanımımı değiştirin." diyen bir mektup gibi. *View* bunu yapmaya izninizin olup olmadığını kontrol eder, iş tanımınızı sizin için günceller ve geri "Tamamdır!" mesajı yollar. Sonra *view*bir yanıt üretir ve Django bunu kullanıcının web tarayıcısına gönderebilir.
 
 Tabi ki yukardaki biraz basitleştirilmiş bir açıklama, ama şimdilik bütün teknik ayrıntıyı bilmene gerek yok. Genel bir fikrin olması yeterli.
 
-Doğrudan çok fazla detaya girmek yerine, Django ile birşeyler oluşturacağız ve önemli kısımları yolda öğreneceğiz!
+Doğrudan çok fazla detaya girmek yerine, Django ile birşeyler oluşturacağız ve önemli kısımları yolda öğreneceğiz!
\ No newline at end of file
diff --git a/tr/django_admin/README.md b/tr/django_admin/README.md
index d0bd0d1ab5b..2fc5c7511ec 100755
--- a/tr/django_admin/README.md
+++ b/tr/django_admin/README.md
@@ -1,49 +1,57 @@
 # Django admin
 
-Modelini hazırladığımız yazıları eklemek, düzenlemek ve silmek için Django admin'i kullanacağız.
+Az önce modellediğimiz gönderilere ekleleme, düzenleme yada silme işlemi yapmak için Django admini kullanacağız.
 
-Hadi `blog/admin.py` dosyasını açalım ve içeriğini şununla değiştirelim:
+Şimdi `blog/admin.py` dosyasını açarak İçeriği bununla değiştirelim:
+
+{% filename %}blog/admin.py{% endfilename %}
 
 ```python
 from django.contrib import admin
 from .models import Post
 
 admin.site.register(Post)
-```    
+```
 
-Gördüğünüz gibi, bir önceki bölümde tanımladığımız Post modelini admin.py dosyamıza dahil (import) ettik. Modelimizi admin sayfasında görünür yapmak için modeli `admin.site.register(Post)` ile belirtmemiz gerekir..
+Gördüğünüz gibi, bir önceki bölümde tanımladığımız gönderi modelini admin. py dosyamıza dahil (import) ettik. Admin sayfasında modelimizi görünür kılabilmek için, Modeli `admin.site.register(Post)` ile kaydetmemiz gerekiyor.
 
-Tamam, artık admin sayfasında Post modelimize göz atabiliriz. Web sunucusunu çalıştırmak için komut satırında `python manage.py runserver` komutunu çalıştırmayı unutmayın. Tarayıcınızda http://127.0.0.1:8000/admin/ adresini adres çubuğuna yazın. Aşağıdaki gibi bir giriş sayfası göreceksiniz:
+Tamam, artık admin sayfasında gönderi modelimize göz atabiliriz. Web sunucusunu çalıştırmak için komut satırında `python manage.py runserver` komutunu çalıştırmayı unutmayın. Tarayacınıza gidin ve adresi yazın http://127.0.0.1:8000/admin/. Bunun gibi bir giriş ekranı göreceksiniz:
 
-![Giriş sayfası][1]
+![Giriş sayfası](images/login_page2.png)
 
- [1]: images/login_page2.png
+Giriş yapabilmek için, sitedeki her şey üzerinde kontrolü olan *superuser* - bir kullanıcı hesabı oluşturmanız gerekiyor. Komut satırana geri giderek `python manage.py createsuperuser` yazın ve enter'a basın.
 
-Giriş yapmak için, sitede her şeyin üzerinde kontrolü olan bir kullanıcı, yani bir *superuser* oluşturmanız gerekiyor. Komut satırında `python manage.py createsuperuser` yazın ve enter tuşuna basın. Giriş satırı geldiğinde, kullanıcı adınızı (küçük harfler ile ve boşluksuz), email adresinizi ve parolanızı girin. Parolayı yazarken ekranda bir şey çıkmayacaktır. Sadece yazın ve `enter` tuşuna basıp devam edin. Çıktısı aşağıdaki formatta olacaktır (kullanıcı adı ve email sizinki olacak):
+> Unutmayın, ağ sunucusu açıkken yeni komut yazmak için, yeni bir terminal penceresi açın ve virtualenv'nizi aktif edin. **Web sunucusu başlatma** bölümünde, **Sizin ilk Django projeniz!** kısmında yeni komutların nasıl yazılacağını gözden geçirdik.
 
-```
-(myvenv) ~/djangogirls$ python manage.py createsuperuser
-Username: admin
-Email address: admin@admin.com
-Password:
-Password (again):
-Superuser created successfully.
-```    
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
 
-Tarayıcınıza dönün. Oluşturduğunuz superuser'ın bilgileri ile giriş yaptığınızda Django'nun admin panelini göreceksiniz.
+İstendiğinde, kullanıcı adınızı (küçük harf, boşluksuz), e-posta adresinizi ve şifrenizi yazın. **Yazdığınız şifreyi göremezseniz endişelenmeyin - olması gerekenler burada var.** Devam etmek için şifreyi yazıp `enter` 'e bas. Çıktı şu şekilde olmalıdır (kullanıcı adı ve e-postanın sizin tarafınızdan olması gerekir):
 
-![Django admin][2]
+    Kullanıcı adı: admin
+    E-posta adresi: admin@admin.com
+    Şifre:
+    Şifre (tekrar):
+    Süper kullanıcı başarıyla oluşturuldu.
+    
 
- [2]: images/django_admin3.png
+Tarayıcınıza dönün. Seçtiğiniz süper kullanıcının kimlik bilgileri ile oturum açın; Django admin gösterge panelini göreceksiniz.
 
-Posts'a tıklayın ve biraz kurcalayın. Mesela üç beş tane blog yazısı ekleyin ve ne yazacağım diye düşünmeyin - zaman kazanmak için bu tutorial'dan kopyalayıp yapıştırabilirsiniz. :)
+![Django admin](images/django_admin3.png)
 
-En azından iki ya da üç yazıya (ama hepsinin değil) yayınlama tarihi girdiğinizden emin olun. Bunu ileriki adımlarda kullanacağız.
+Mesajlara gidin ve onunla biraz deneme yapın. Beş veya altı blog yazısı ekleyin. İçerik hakkında endişelenmeyin - zamandan kazanmak için bu öğreticiden bazı metinleri kopyalayıp yapıştırın. :)
 
-![Django admin][3]
+En az iki veya üç yazının (ama hepsinin değil) yayınlanma tarihinin ayarlanmış olduğundan emin olun. Bu size daha sonra yardımcı olacak.
 
- [3]: images/edit_post3.png
+![Django admin](images/edit_post3.png)
 
-Eğer Django admin ile ilgili daha fazla şey öğrenmek istiyorsanız Django'nun belgelerine göz atabilirsiniz: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+Django admin hakkında daha fazla bilgi edinmek isterseniz, Django'nun belgelerini kontrol etmelisiniz: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
 
-Şimdi enerjinizi toplamak için kendinize bir çay veya kahve alabilirsiniz. Ne de olsa ilk Django modelinizi oluşturdunuz - biraz molayı hak ediyorsunuz. :)
+Bu, muhtemelen kendinize yeniden enerji vermek için bir kahve (veya çay) veya başka şeyler yemek için iyi bir an. İlk Django modelinizi yarattınız - küçük bir molayı hak ettiniz!
\ No newline at end of file
diff --git a/tr/django_forms/README.md b/tr/django_forms/README.md
index 0244e7bae99..28f2f5504e7 100755
--- a/tr/django_forms/README.md
+++ b/tr/django_forms/README.md
@@ -1,6 +1,6 @@
 # Django Forms
 
-Günlüğümüzde son olarak yapmak istediğimiz şey, günlük yazılarını eklemek ve düzenlemek için güzel bir yapı oluşturmak. Django'nun `admin` arayüzü çok havalı, ama özelleştirilmesi ve güzelleştirilmesi oldukça zor. Bunu `forms` (formlar) kullanarak kendi arayüzümüz üstünde mutlak bir güce sahip olacağız - neredeyse hayal ettiğimiz her şeyi yapabiliriz!
+Blogumuzda yapmak istediğimiz son şey blog yazılarını eklemek ve düzenlemek için güzel bir yapı oluşturmak. Django'nun `admin` arayüzü çok havalı, ama özelleştirilmesi ve güzel hale getirilmesi oldukça zor. `forms` ile mutlak güce sahip olacağız – biz hayal edebileceğiniz hemen hemen her şeyi yapabilirsiniz!
 
 Django formlarının güzel yanı, hem sıfırdan bir form tanımlayabilmemiz hem de sonuçları modele kaydedecek bir `ModelForm` oluşturabilmemizdir.
 
@@ -10,12 +10,13 @@ Django'nun diğer önemli parçaları gibi, formların da kendi dosyası var: `f
 
 `blog` dizinimizde bu isimde bir dosya oluşturmalıyız.
 
-```
-blog
-└── forms.py
-```    
+    blog
+       └── forms.py
+    
+
+Tamam, şimdi dosyayı açalım ve altta ki kodu yazalım:
 
-Tamam, hadi dosyayı açalım ve aşağıdaki kodu yazalım:
+{% filename %}blog/forms.py{% endfilename %}
 
 ```python
 from django import forms
@@ -26,37 +27,41 @@ class PostForm(forms.ModelForm):
 
     class Meta:
         model = Post
-        fields = ('baslik', 'yazi',)
-```    
+        fields = ('title', 'text',)
+```
 
 Önce Django formları (`from django import forms`) ve tabii ki `Post` modelimizi içe aktarmalıyız (`from .models import Post`).
 
-`PostForm`, tahmin etmiş olabileceğiniz gibi, formumuzun ismi. Django'ya bu formun bir `ModelForm` olduğunu belirtmeliyiz. Bunu `forms.ModelForm` sayesinde Django bizim için yapacaktır.
+`PostForm`, tahmin etmiş olabileceğiniz gibi, formumuzun ismi. Django'ya bu formun `ModelForm` olduğunu söylemeliyiz ( dolayısı ile Django bizim için biraz büyü yapacak) - `forms.ModelForm` bunun için sorumludur.
 
 Sırada Django'ya bu formu (`model = Post`) oluşturmak için hangi modelin kullanılması gerektiğini anlattığımız `class Meta` var).
 
-Son olarak, formumuzda hangi alan(lar)ın bulunması gerektiğini söyleyebiliriz. Bu senaryoda sadece `baslik` ve `yazi` alanlarının gösterilmesini istiyoruz - `yazar` şu anda giriş yapmış olması gereken kişidir (yani siz!) ve biz ne zaman yeni bir yazı oluşturursak `yaratilma_tarihi` otomatik olarak (örn. kod içinde) ayarlanmalıdır, değil mi?
+Son olarak, formumuzda hangi alan(lar)ın bulunması gerektiğini söyleyebiliriz. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
 
 Ve hepsi bu kadar! Şimdi tek yapmamız gereken formu bir *view* içinde kullanıp, template (şablon) içinde göstermek.
 
-Bir kez daha: sayfaya bir bağlantı, bir URL, bir view ve bir template üreteceğiz.
+Bir kere daha sayfaya bir bağlantı, bir url, bir görünüm ve şablon oluşturacağız.
 
 ## Formun bulunduğu sayfaya bağlantı oluşturma
 
 Şimdi `blog/templates/blog/base.html` şablonunu açma zamanı. Öncelikle `page-header` adlı `div` öğesinin içine bir bağlantı ekleyeceğiz:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
-```    
+```
 
-Yeni view'i `post_new` olarak isimlendirdik.
+Yeni view'umuzun (görünümüzümün) adını `post_new` koymak istiyoruz. `"glyphicon glyphicon-plus"` class'ı kullandığımız bootstrap teması tarafından sağlanıyor ve bizim için bir artı işareti gösterecek.
 
-Yukarıdaki satırı ekledikten sonra html dosyanız böyle görünmeli:
+Satırı ekledikten sonra, HTML dosyanız bu şekilde görünmelidir:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
 <html>
-   <head>
+    <head>
         <title>Django Girls blog</title>
         <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
         <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
@@ -78,7 +83,7 @@ Yukarıdaki satırı ekledikten sonra html dosyanız böyle görünmeli:
         </div>
     </body>
 </html>
-```    
+```
 
 Dokümanı kaydedip http://127.0.0.1:8000 sayfasını yeniledikten sonra, siz de tanıdık `NoReverseMatch` hatasını görüyor olmalısınız, değil mi?
 
@@ -86,138 +91,158 @@ Dokümanı kaydedip http://127.0.0.1:8000 sayfasını yeniledikten sonra, siz de
 
 `blog/urls.py` dosyasını açalım ve yeni bir satır ekleyelim:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-    url(r'^post/new/$', views.post_new, name='post_new'),
-```    
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
 
 Ve kodun son hali şu şekilde görünecektir:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import url
 from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
     url(r'^post/new/$', views.post_new, name='post_new'),
 ]
-```    
+```
 
-Sayfayı yeniledikten sonra, `AttributeError` şeklinde bir hata görürüz, bunun sebebi de henüz `post_new` view'ını (görünümünü) kodlamamış olmamız. Şimdi bu dosyayı da ekleyelim.
+Siteyi yeniledikten sonra, bir `AttributeError` görürüz, çünkü uygulanan `post_new` görünümüne sahip değiliz. Hemen şimdi ekleyelim.
 
 ## post_new view
 
 Şimdi `blog/views.py` dosyasını açıp aşağıdaki satırları diğer `from` satırlarının olduğu yere ekleyelim:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from .forms import PostForm
-```    
+```
 
-ve bizim *view*'ımız:
+Ve sonra bizim *view*'imiz:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
     form = PostForm()
     return render(request, 'blog/post_edit.html', {'form': form})
-```    
+```
 
-Yeni bir `Post` formu oluşturmak için `PostForm()`u çağırmak ve template'e iletmek gerekir. Bu *view*'a geri döneceğiz, fakat öncesinde form için hızlıca bir şablon oluşturalım.
+Yeni bir `Post` formu oluşturmak için `PostForm()` fonksiyonunu çağırmak ve template'e iletmek gerekir. *view* kısmına geri döneceğiz, ancak şimdilik form için bir şablon oluşturalım.
 
 ## Template
 
 Öncelikle `blog/templates/blog` dizininde `post_edit.html` isimli bir dosya oluşturmalıyız. Bir formu çalışır hale getirmek için birkaç şeye ihtiyacımız var:
 
-*   form'u görüntülemeliyiz. Bunu basitçe bu şekilde yapabiliriz: `{% raw %}{{ form.as_p }}{% endraw %}`.
-*   yukarıdaki örnek satır HTML form etiketi içine alınmalı: `<form method="POST">...</form>`
-*   bir `Kaydet` butonuna ihtiyacımız var. Bunu bir HTML butonu ile yapıyoruz: `<button type="submit">Kaydet</button>`
-*   son olarak, hemen `<form ...>` etiketinden sonra `{% raw %}{% csrf_token %}{% endraw %}` satırını eklememiz lazım. Formlarımızın güvenliğini sağladığı için bu çok önemlidir! Bunu koymayı unutup formu kaydedersek Django hata verecektir:
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* Yukarıdaki örnek satır HTML form etiketi içine alınmalı: `<form method="POST">...</form>`.
+* Bir `Kaydet` butonuna ihtiyacımız var. Bunu Bir HTML butonu ile yapıyoruz: `<button type="submit">Kaydet</button>`.
+* Ve son olarak, açılıştan hemen sonra `<form ...>` etiketini eklememiz gerekiyor {% raw %}`{% csrf_token %}`{% endraw %}. Formlarımızın güvenliğini sağladığı için bu çok önemlidir! Eğer bu kısmı unutursan, formu kaydetmeye çalıştığınızda Django şikayet edecektir:
 
-![CSFR Korumalı sayfa][1]
+![CSFR Korumalı sayfa](images/csrf2.png)
 
- [1]: images/csrf2.png
+Tamam,hadi `post_edit.html` deki HTML'ye nasıl bakılacağını görelim:
 
-Peki, şimdi de `post_edit.html` in içindeki HTML kodunun nasıl görünmesi gerektiğine bakalım:
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
 
 {% block content %}
-    <h1>Yeni gönderi</h1>
+    <h1>New post</h1>
     <form method="POST" class="post-form">{% csrf_token %}
         {{ form.as_p }}
-        <button type="submit" class="save btn btn-default">Kaydet</button>
+        <button type="submit" class="save btn btn-default">Save</button>
     </form>
 {% endblock %}
-```    
+```
 
 Yenileme zamanı! Hey! Formun görüntülendi!
 
-![Yeni form][2]
-
- [2]: images/new_form2.png
+![Yeni form](images/new_form2.png)
 
-Ama, bir dakika! `baslik` ve `yazi` alanlarına bir şey yazıp kaydettiğimizde ne olacak?
+Ama, bekle bir dakika! `başlık` ve `başlık` alanlarına bir şey yazdığında ve kaydetmeye çalıştığında, ne olacak?
 
-Hiçbir şey! Yine aynı sayfaya döndük ve bütün yazdıklarımız kayboldu... ve yeni bir gönderi de eklenmemiş. Yanlış giden ne?
+Hiçbirşey! Bir kere daha aynı sayfadayız, metnimiz gitmiş ve yeni gönderi eklenmemiş. Peki ne yanlış gitti?
 
 Yanıt: hiçbir şey. Sadece *view*'ımızda biraz daha iş yapmamız gerekiyor.
 
 ## Formu kaydetme
 
-Tekrar `blog/views.py` dosyasını açalım. Şuan `post_new` view'ı içinde sadece bunlar var:
+Bir kez daha `blog/views.py` yi açın.Halihazırda `post_new` görüntüsündeki elimizdeki bütün şey şunlardır:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
     form = PostForm()
     return render(request, 'blog/post_edit.html', {'form': form})
-```    
+```
+
+Formu teslim ettiğinizde, aynı görüşe yönlendirileceğiz, bu sefer `request` içinde daha fazla bilgi olacak, özellikle `request.POST` içinde ( isimlendirmenin blog gönderisiyle bir bağlantısı yoktur; daha fazla veri göndermemizle ilgilidir). HTML dosyasının `<form>` açıklamasının `method="POST"` değişken varlığını hatırlıyormusunuz? Formdan gelen tüm alanlar şimdi `request.POST`'un içerisinde. `POST`'un ismini değiştirmememiz lazım (`method` için geçerli diğer değer sadece `GET`'dir, ama şimdi ikisi arasındaki farkın ne olduğunu anlatacak kadar vaktimiz yok).
 
-Formu kaydettiğimizde tekrar aynı view'a yönlendirileceğiz, ama bu sefer `request` nesnesinde, daha doğrusu `request.POST` (isimlendirmesinin, bizim blog uygulamasının "post" modeli ile alakası yok, gerçekte veri gönderdiğimiz (İngilizcede "post" işlemi) için isimlendirme bu şekilde) içerisinde, daha fazla verimiz olacak. HTML dosyasında `<form>` tanımımızdaki `method="POST"` değişkenini hatırlıyor musun? Formdan gelen tüm alanlar şimdi `request.POST`'un içerisinde. `POST`'un ismini değiştirmememiz lazım (`method` için geçerli diğer değer sadece `GET`'dir, ama şimdi ikisi arasındaki farkın ne olduğunu anlatacak kadar vaktimiz yok).
+*view* içinde halletmemiz gereken iki ayrı durum vardır: öncelikle, sayfaya ilk kez eriştiğimizde ve boş bir form isteğimizde, ikincide *view* girdiğimiz form verisiyle geri gideriz. Yani bir koşul eklememiz gerekiyor (bunun için `if` kullanacağız):
 
-Oluşturduğumuz *view*'da iki ayrı durumu halletmemiz gerek. Birincisi: sayfaya ilk eriştiğimiz ve boş bir form istediğimiz zaman. İkincisi: henüz yazdığımız tüm form verileriyle *view*'a geri döndüğümüz zaman. Yani bir koşul eklememiz gerekiyor (bunun için `if` kullanacağız).
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 if request.method == "POST":
     [...]
 else:
     form = PostForm()
-```    
+```
+
+Noktaları doldurma zamanı `[...]`. Eğer `method` `POST` ise `PostForm` formdaki veriyle oluşturmalıyız, değil mi? Bunu şu şekilde yapacağız:
 
-Şimdi boşluğu `[...]` doldurma zamanı geldi. `method`, `POST` ise o zaman `PostForm`u verilerle oluşturmamız lazım, değil mi? Bunu yapmak için:
+{% filename %}blog/views.py{% endfilename %}
 
-``` python
+```python
 form = PostForm(request.POST)
 ```
 
-Çok kolay! Şimdi de formu (yani tüm gerekli alanların doldurulduğu ve hatalı değerlerin kaydedilmeyeceğini) kontrol etmemiz lazım. Bunu da `form.is_valid()` ile yapıyoruz.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
 
 Formun doğruluğunu kontrol ediyoruz ve doğru ise kaydedebiliriz!
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 if form.is_valid():
     post = form.save(commit=False)
-    post.yazar = request.user
-    post.yayinlanma_tarihi = timezone.now()
+    post.author = request.user
+    post.published_date = timezone.now()
     post.save()
-```    
+```
+
+Temel olarak, burada iki şey yaptık: formu `form.save` ile kaydettik ve bir yazar ekledik (`PostForm`'da bir `yazar` tanımlı olmadığı ve bu zorunlu bir alan olduğu için). `commit=False`; e `Post` modelini kaydetmek istemiyoruz demektir - öncelikle yazarı eklemeliyiz. Çoğu zaman `form.save()` kullanırken, `commit=False` kullanılmayacaktır, bu durumda desteklemeliyiz. `post.save()` değişiklikleri saklar (yazar ekleme) ve yeni blog yazısı oluşturulur!
 
-Temel olarak, burada iki şey yaptık: formu `form.save` ile kaydettik ve bir yazar ekledik (`PostForm`'da bir `yazar` tanımlı olmadığı ve bu zorunlu bir alan olduğu için!). `commit=False`, `Post` modelini henüz kaydetmek istemediğimizi belirtir - ilk önce yazarı eklemek istiyoruz. Genellikle `form.save()`, `commit=False` olmadan kullanacaksınız, ama bu durumda, bunu kullanmamız gerekiyor. `post.save()` değişiklikleri (yazarı ekleme) koruyacaktır ve yeni bir blog gönderisi oluşturulur!
+Son olarak hızlı bir şekilde yeni oluşturulmuş blog gönderimiz için `post_detail` gidebilirsek harika olurdu değil mi? Bunu yapmak için bir tane daha içe yapmamız gerekli:
 
-Hemen `post_detail` sayfasına gidip yeni yaratmış olduğumuz blog postunu görsek harika olur, degil mi? Bunu yapabilmek için önemli bir şey daha lazım:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import redirect
-```    
+```
+
+Dosyanızın başlangıcına ekleyin. Şimdi "yeni oluşturulmuş gönderi için `post_detail` gidin" diyebiliriz:
 
-Bunu dosyanın en başına ekleyelim. Şimdi yeni yarattığımız blog postu için `post_detail` sayfasına gidebiliriz.
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-    return redirect('post_detail', pk=post.pk)
+return redirect('post_detail', pk=post.pk)
 ```
 
-`post_detail` gitmek istediğimiz görünümün ismidir. Unutmayalım ki bu *view* için bir `pk` değişkeni lazım. Bu değeri görünümlere aktarmak için `pk=post.pk` yazarız. Burada `post` yeni yarattığımız blog postudur!
+`post_detail`, gitmek istediğimiz view'un (görünümün) adı. Unutmayalım ki bu *view* için bir `pk` değişkeni lazım. Bu görüntülere geçmek için `pk=post.pk` kullanırız,burada `post` yeni oluşturulan blog yazısıdır!
+
+Tamam, çok fazla konuştuk, ama muhtemelen bütün *görüntü* neye benziyor görmek istiyoruz değil mi?
 
-Çok şey söyledik ama herhalde *view* u tümüyle bir görmek isteriz artık, değil mi?
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -225,8 +250,8 @@ def post_new(request):
         form = PostForm(request.POST)
         if form.is_valid():
             post = form.save(commit=False)
-            post.yazar = request.user
-            post.yayinlanma_tarihi = timezone.now()
+            post.author = request.user
+            post.published_date = timezone.now()
             post.save()
             return redirect('post_detail', pk=post.pk)
     else:
@@ -234,68 +259,72 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Bakalım çalışacak mı? http://127.0.0.1:8000/post/new/ sayfasına gidip bir `baslik` ve `yazi` ekleyelim, sonra da kaydedelim... ve işte! Yeni blog postu eklenmiş ve `post_detail` sayfasına yönlendirildik!
+Bakalım çalışacak mı? Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! Yeni blog gönderisi eklenmiştir ve `post_detail` sayfasına yönlendirildik!
 
-Postu kaydetmeden önce yayin tarihine değer atandığını fark etmiş olabilrsin. Daha sonra *yayınla butonu* nu **Django Girls Tutorial: Ek konular** da anlatacağız.
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
 
 Süper!
 
-## Form doğrulama
-
-Şimdi de Django formlarının ne kadar havalı olduğunu görelim. Bir blog postunun `baslik` ve `yazi` alanları olmalı. `Post` modelimizde bu alanlar mecburi değil demedik ( `yayinlanma_tarihi` demiş olduğumuz gibi), dolayısı ile Django bu alanlara değer atanması gerektiğini varsayar.
+> Son zamanlarda Django yönetici ara yüzünü kullandığımız için sistem halihazırda hala giriş yaptığımızı düşünüyor. Oturumu kapatmamıza yol açabilen birkaç durum vardır(tarayıcıyı kapama, DB'yi yeniden başlatma ve benzeri). Eğer,bir post oluştururken,oturum açan bir kullanıcının yoksunluğuna istinaden hatalar aldığınıza rastlıyorsanız yönetici sayfasına http://127.0.0.1:8000/admin yönelin ve tekrardan giriş yapın. Bu durumu geçici de olsa da halleder. Kalıcı çözüm, ana tutorialdan sonra **Ödev: Web sitene güvenlik ekleme!** bölümünde anlatılacak.
 
-`baslik` veya `yazi` olmadan formu kaydetmeye çalışın. Ne olacak, tahmin et!
+![Oturum hatası](images/post_create_error.png)
 
-![Form doğrulama][3]
-
- [3]: images/form_validation2.png
+## Form doğrulama
 
-Django tüm alanlara doğru tür değerlerin atandığını bizim için kontrol ediyor. Ne güzel, değil mi?
+Şimdi de Django formlarının ne kadar havalı olduğunu görelim. Bir blog postunun `baslik` ve `yazi` alanları olmalı. `Post` modelimizde bu alanların( `published_date` e karşı olarak) gerekli olmadığını söylemedik, bu yüzden Django varsayılan olarak hazır olmasını bekler.
 
-> Yakın zamanda Django'nun admin arayüzünü kullandığımız için, sistem bizi hala oturumda varsayıyor. Bazı durumlar bizim oturumdan çıkmamıza neden olabilir (web tarayıcısını kapatmak, veritabanını tekrar başlatmak, vb). Eğer oturumda olan kullanıcı olmadığı için post yaratmada hata alırsak admin sayfası olan http://127.0.0.1:8000/admin gidip tekrar bir oturum açmalıyız. Bu durumu geçici de olsa da halleder. Kalıcı çözüm, ana tutorialdan sonra **Ödev: Web sitene güvenlik ekleme!** bölümünde anlatılacak.
+Formu `başlık` ve `metin` olmadan kaydetmeyi deneyin. Tahmin edin ne olacak!
 
-![Oturum hatası][4]
+![Form doğrulama](images/form_validation2.png)
 
- [4]: images/post_create_error.png
+Django formumuzdaki tüm alanların doğru olduğunu onaylamaya dikkat ediyor. Müthiş değil mi?
 
 ## Form düzenleme
 
-Artık yeni bir form oluşturmayı biliyoruz. Peki, mevcut bir formu güncellemek için ne yapmalı? Demin yaptığımıza çok benziyor. Şimdi, hızlıca bir kaç şey yaratalım (anlamadığın bir şey olduğu zaman, mentöre veya önceki bölümlere danışabilirsin, çünkü bu adımları daha önce yaptık).
+Artık yeni bir form oluşturmayı biliyoruz. Peki, mevcut bir formu güncellemek için ne yapmalı? Bu az önce yaptığımız şeyle çok benzer. Hızlıca bazı önemli şeyleri oluşturalım. (Eğer birşeyi anlamazsan, çalıştırıcına sormalısın veya önceki bölümlere bakmalısın, çünkü bütün bu adımları daha önce bitirdik.)
 
-`blog/templates/blog/post_detail.html` dosyasını açıp şu satırı ekleyelim:
+`blog/templates/blog/post_detail.html` açın ve satırı ekleyin
 
-```python
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
-```    
+```
+
+böylece şablon bunun gibi görünecektir:
 
-ki template buna benzesin:
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
 
 {% block content %}
     <div class="post">
-        {% if post.yayinlanma_tarihi %}
+        {% if post.published_date %}
             <div class="date">
-                {{ post.yayinlanma_tarihi }}
+                {{ post.published_date }}
             </div>
         {% endif %}
         <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
-        <h1>{{ post.baslik }}</h1>
-        <p>{{ post.yazi|linebreaks }}</p>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
     </div>
 {% endblock %}
-```    
+```
 
 `blog/urls.py` dosyasına şu satırı ekleyelim:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-url(r'^post/(?P<pk>[0-9]+)/edit/$', views.post_edit, name='post_edit'),
-```    
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
 
 Daha önce kullandığımız `blog/templates/blog/post_edit.html` template'i tekrar kullanacağız, tek eksik bir *view*.
 
-Şimdi `blog/views.py` dosyasını açıp en sonuna şu satırı ekleyelim:
+`blog/views.py` açın ve dosyanın en sonuna bunu ekleyin:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_edit(request, pk):
@@ -304,96 +333,115 @@ def post_edit(request, pk):
         form = PostForm(request.POST, instance=post)
         if form.is_valid():
             post = form.save(commit=False)
-            post.yazar = request.user
-            post.yayinlanma_tarihi = timezone.now()
+            post.author = request.user
+            post.published_date = timezone.now()
             post.save()
             return redirect('post_detail', pk=post.pk)
     else:
         form = PostForm(instance=post)
     return render(request, 'blog/post_edit.html', {'form': form})
-```  
+```
+
+Bu nerdeyse bizim `post_new` view'e benziyor, değil mi? Ama, tam da değil. Özellikle url'lerden ekstra bir `pk` parametresi geçiriyoruz. Sonra,`get_object_or_404(Post, pk=pk)` düzenlemek istediğimiz `Post` modelini alıyoruz ve daha sonra bir form oluşturduğumzda bu yazıyı `instance` olarak geçiriyoruz, formu kaydettiğimizde de…
 
-Bu nerdeyse bizim `post_new` view'e benziyor, değil mi? Ama, tam da değil. İlk önce: Url'den ekstra bir `pk` parameteresi yolladık. Sonra: güncellemek istediğimiz `Post` modelini `get_object_or_404(Post, pk=pk)` ile alıp, bir form yarattığımızda bu postu bir `örnek kopya` (instance) olarak hem formu kaydettiğmizde yolluyoruz:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST, instance=post)
-```    
+```
+
+…ve düzenlemek için bu post ile ilgili bir form açtığımızda:
 
-hem de güncellemek istediğimiz postu görmek için form açtığımız zaman yolluyoruz:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(instance=post)
 ```
 
-Haydi, deneyelim. Bakalım çalışacak mı? `post_detail` sayfasına gidelim. Sağ üst köşede bir edit (güncelleme) butonu olmalı:
-
-![Düzenle butonu][5]
+Tamam, çalışıp çalışmadığını test edelim! `post_detail` sayfasına gidelim. Sağ üst köşede bir düzenleme butonu olmalıdır:
 
- [5]: images/edit_button2.png
+![Düzenle butonu](images/edit_button2.png)
 
 Butona tıklarsak blog postunu görmemiz lazım:
 
-![Formu düzenle][6]
+![Form düzenleme](images/edit_form2.png)
 
- [6]: images/edit_form2.png
-
-İstediğimiz gibi başlık ve yazıyı değiştirebilir ve sonra da kaydedebilriz!
+Başlık ya da metni değiştirmekten ve değişiklikleri kaydetmekten çekinmeyin!
 
 Tebrikler! Uygulaman gittikçe tamamlanıyor!
 
-Django formları hakkında daha fazla bilgi bulmak için https://docs.djangoproject.com/en/1.11/topics/forms/ adresindeki dokümanlara bakabilirsin
+Eğer Django formlarıyla ilgili daha çok bilgiye ihtiyacın varsa,belgelendirmeyi okumalısın: https://docs.djangoproject.com/en/1.11/topics/forms/
 
 ## Güvenlik
 
-Bir bağlantıya (link) tıklayarak yeni bir blog oluşturabilmek harika! Ancak, şu haliyle siteye gelen herkes bir blog yaratıp kaydedebilir. Bu da istenen bir durum değil. Butonun sadece sana görünmesini sağlayalım.
+Bir bağlantıya (link) tıklayarak yeni bir blog oluşturabilmek harika! Ama şu anda sizin sitenizi ziyaret eden herkes yeni bir blog post yapabilecek ve bu muhtemelen isteyeceğiniz bir şey değil. Butonun sadece sana görünmesini sağlayalım.
 
 `blog/templates/blog/base.html` dosyasında yarattığımız `page-header` `div` ve anchor etiketlerini (tags) bulalım. Şuna benziyor olmalı:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
-```    
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! `<a>` etiketini şöyle değiştirelim:
 
-Şimdi bir `{% if %}` etiketi daha ekleyeceğiz ki link sadece admin olarak oturum açmış kişilere görünsün. Şimdilik, bu kişi sadece sensin! `<a>` etiketini şöyle değiştirelim:
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% if user.is_authenticated %}
     <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 {% endif %}
-```    
+```
+
+Bu `{% if %}` bağlantının sadece eğer sayfayı talep eden kullanıcı oturum açtıysa tarayıcıya gönderilmesine sebep olacak. Bu yeni post yaratılmasını kesin olarak engellemese de iyi bir başlangıç. Güvenlik konusu ek derslerde daha çok ele alınacak.
 
-Bu `{% if %}` linkin tarayıcıya ancak kullanıcı oturum açmış ise gönderilmesini sağlar. Bu yeni post yaratılmasını kesin olarak engellemese de iyi bir başlangıç. Güvenlik konusu ek derslerde daha çok ele alınacak.
+Az evvel detay sayfamıza eklediğimiz düzenle ikonunu hatırladınız mı? Aynı değişikliği oraya da eklemek istiyoruz. Böylelikle başka insanlar var olan gönderileri düzenleyemeyecekler.
 
-Oturum içi olduğumuz için, şimdi sayfayı yenilersek, farklı bir şey görmeyeceğiz. Sayfayı farklı bir tarayıcıda veya incognito bir pencerede yükleyelim. O zaman bu link görünmeyecek!
+`blog/templates/blog/post_detail.html` açın ve bu satırı bulun:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Buna çevirin:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Yüksek olasılıkla login yapmış olduğunuz için sayfayı yenilediğinizde farklı bir şey göremeyeceksiniz. Sayfayı farklı bir tarayıcı veya görünmez pencere ile yükleyin(Windows Edge üzerinde "InPrivate" olarak adlandırılan), yinede göreceksiniz ki bağlantı ve ikon gözükmeyecektir!
 
 ## Bir şey daha: deployment (yayına alma) zamanı!
 
 Bakalım PythonAnywhere'de calışacak mı? Tekrar yayına alalım!
 
-*   İlk önce kodumuzu commit edelim, sonra Github'a push edelim
+* İlk önce kodumuzu commit edelim, sonra Github'a push edelim:
 
-```
-$ git status
-$ git add -A .
-$ git status
-$ git commit -m "Web sitesine güncelleme ve yaratma için view eklendi."
-$ git push
-```    
+{% filename %}komut-satırı{% endfilename %}
 
-*   Sonra bir [PythonAnywhere Bash konsol][7] una gidip:
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Sitede gönderi oluşturmak ve düzenlemek için view'ler eklendi."
+    $ git push
+    
 
- [7]: https://www.pythonanywhere.com/consoles/
+* Sonra bir [PythonAnywhere Bash konsol](https://www.pythonanywhere.com/consoles/) una gidip:
 
-```
-$ cd ilk-blogum
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```
+{% filename %}komut-satırı{% endfilename %}
 
-*   Nihayet, [Web tab][8] ına gidip **Reload** edelim.
+    $ cd ilk-blogum
+    $ git pull
+    [...]
+    
 
- [8]: https://www.pythonanywhere.com/web_app_setup/
+* Nihayet, [Web tab](https://www.pythonanywhere.com/web_app_setup/) ına gidip **Reload** edelim.
 
-O kadar! Tebrikler :)
+O kadar! Tebrikler :)
\ No newline at end of file
diff --git a/tr/django_installation/README.md b/tr/django_installation/README.md
index b51a96fe065..09ae9bf4360 100755
--- a/tr/django_installation/README.md
+++ b/tr/django_installation/README.md
@@ -1,5 +1,7 @@
 # Django kurulumu
 
-> **Not** Eğer kurulum adımlarını zaten yaptıysanız sonraki bölüme geçebilirsiniz!
+> **Not** Eğer Chromebook kullanıyorsanız, bu bölümü atlayın ve [Chromebook Kurulumu](../chromebook_setup/README.md)'ndaki talimatları takip ettiğinizden emin olun.
+> 
+> **Not** Eğer Kurulum aşamalarını zaten başarıyla tamamladıysanız, Django kurulumunu zaten tamamlamışsınızdır - direkt olarak diğer aşamaya geçebilirsiniz!
 
-{% include "/django_installation/instructions.md" %}
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/tr/django_installation/instructions.md b/tr/django_installation/instructions.md
index 5dea022ff2c..9db51d674e4 100644
--- a/tr/django_installation/instructions.md
+++ b/tr/django_installation/instructions.md
@@ -1,99 +1,150 @@
-> Bu bölümün bir kısmı Geek Girls Carrots tarafından hazırlanmış eğitimlere dayanılarak hazırlanmıştır (http://django.carrots.pl/).
->
-> Bu bölümün bir parçası Creative Commons Attribution-ShareAlike 4.0 International License ile lisanslı [django-marcador tutorial](http://django-marcador.keimlink.de/)'a dayanılarak hazırlanmıştır. Django-marcador tutorial'ının hakları Markus Zapke-Gründemann'e aittir.
+> Bu bölümün bir kısmı Geek Girls Carrots tarafından hazırlanmış eğitimlere dayanılarak hazırlanmıştır (https://github.com/ggcarrots/django-carrots).
+> 
+> Bölümün bu kısmı [django-marcador tutorial](http://django-marcador.keimlink.de/) e dayandırılmış ve Creative Commons Attribution-ShareAlike 4.0 International License koruması altında lisansı alınmıştır. Django-marcador tutorial'ının hakları Markus Zapke-Gründemann'e aittir.
 
-## Virtual environment (Sanal ortam)
+## Sanal ortam (Virtual environment)
 
 Django'yu yüklemeden önce kod ortamınızı düzenli tutmak için son derece yararlı bir araç yükleyeceğiz. Bu adımı atlayabilirsiniz, fakat atlamamanızı tavsiye ederiz. En iyi olası kurulum ile başlamanız sizi gelecekteki bir sürü sorundan koruyacaktır!
 
 Öyleyse bir **virtual environment**(diğer adıyla *virtualenv*) kuralım. Virtualenv Python/Django kurulumunuzu her proje için ayrı tutup izole eder. Bu, bir websitesine yapacağınız değişikliklerin diğer geliştirdiklerinize yansımayacağı anlamına gelir. Muazzam, değil mi?
 
-Yapmanız gereken tek şey `virtualenv` oluşturmak için bir dizin bulmak; örneğin giriş dizininiz. Windows'da bu `C:\Users\isim` olabilir (`isim` kısmı kullanıcı adınız olacak şekilde).
+Yapmanız gereken tek şey `virtualenv` oluşturmak için bir dizin bulmak; örneğin giriş dizininiz. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
 
 Bu eğitim için giriş dizininizde yeni açtığımız `djangogirls` adlı bir klasör kullanacağız:
 
-```
-mkdir djangogirls
-cd djangogirls
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
 
 `myvenv` adında bir virtualenv oluşturacağız. Genel komut aşağıdaki şekilde olacak:
 
-```
-python3 -m venv myvenv
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
 
-### Windows
+Yeni bir `virtualenv` yaratmak için,prompt komutunu açmanız ve `python -m venv myvenv`'u çalıştırmanız gerekir.Böyle görünecektir; 
 
-Yeni bir `virtualenv` oluşturmak için konsolu açıp (nasıl yapıldığını birkaç adım önce anlatmıştık - hatırlıyorsunuz değil mi?) `C:\Python34\python -m venv myvenv` komutunu çalıştırın. Şöyle görünmeli:
+{% filename %}komut-satırı{% endfilename %}
 
-```
-C:\Users\isim\djangogirls> C:\Python34\python -m venv myvenv
-```    
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
 
-`C:\Python34\python` dizini önceden Python'u kurduğunuz dizin ve `myvenv` ise `virtualenv`'inizin ismi olacaktır. İstediğiniz herhangi bir ismi kullanabilirsiniz, ama küçük harfle yazılmasına ve boşluk, aksan karakterleri (örn: å) ve özel karakterleri kullanmamaya dikkat edin. Ayrıca ismi kısa tutmak iyi bir fikir olabilir, zira bu ismi çok kullanıyor olacaksınız!
+Burada `myvenv`, `virtualenv`'inizin ismidir. İstediğiniz herhangi bir ismi kullanabilirsiniz, ama küçük harfle yazılmasına ve boşluk, aksan karakterleri (örn: å) ve özel karakterleri kullanmamaya dikkat edin. Ayrıca ismi kısa tutmak işinize yarayacaktır zira bu ismi çokca kullanıyor olacaksınız!
 
-### GNU/Linux ve OS X
+<!--endsec-->
 
-Linux ve OS X işletim sistemlerinde `virtualenv` oluşturmak için `python3 -m venv myvenv` komutunu çalıştırmak yeter. Komut şu şekilde görünecektir:
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
 
-```
-~/djangogirls$ python3 -m venv myvenv
-```    
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
 
-Burada `myvenv` sizin `virtualenv`'inizin ismi. Dilerseniz istediğiniz herhangi bir isim kullanabilirsiniz, ama büyük harf ve boşluk kullanmamaya dikkat edin. İsmi çok fazla kullanacağınız için kısa tutmak da işinize yarayacaktır.
+{% filename %}komut-satırı{% endfilename %}
 
-> **NOT:** Ubuntu 14.04 işletim sisteminde sanal ortam yaratmaya çalışırken şu hatayla karşılaşabilirsiniz:
->
+    $ python3 -m venv myvenv
+    
+
+Burada `myvenv` sizin `virtualenv`'inizin ismi. Dilerseniz istediğiniz herhangi bir isim kullanabilirsiniz, ama büyük harf ve boşluk kullanmamaya dikkat edin. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOT:** Debian/Ubuntu'nun bazı sürümlerinde aşağıdaki hatayı alabilirsiniz:
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  Debian/Ubuntu sistemlerinde, python3-venv paketini aşağıdaki komutu kullanarak yüklemeniz gerekiyor.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> Bu durumda,yukarıdaki yönergeleri izleyin ve `python3-venv` paketini yükleyin:
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> Bu Şekilde Debian/Ubuntu ' nun bazı sürümlerinde sanal ortamı başlatırken o anda aşağıdaki hatayı alabilirsiniz : 
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
 >     Error: Command '['/home/zeynep/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
 >     
->
+> 
 > Bu sorunu çözmek için `virtualenv` komutunu kullanabilirsiniz.
->
->     ~/djangogirls$ sudo apt-get install python-virtualenv
->     ~/djangogirls$ virtualenv --python=python3.4 myvenv
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOT:** Eğer aşağıdaki gibi bir hata alırsanız
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> o zaman yerine bunu çalıştırın:
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
 >     
 
+<!--endsec-->
+
 ## Virtualenv ile çalışmak
 
 Yukarıdaki komutlar `myvenv` (veya seçtiğiniz isimde) bir klasör oluşturacaktır. Bu klasörde birçok dosya ve klasör bulunur.
 
-#### Windows
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
 
 Şu komutu çalıştırarak virtualenv'i başlatın:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
     C:\Users\Name\djangogirls> myvenv\Scripts\activate
-```
+    
+
+> **NOT:** Windows 10'da , Windows PowerShell tarafından `bu senaryoların uygulanması bu sistemde devre dışıdır` diyen bir hata alabilirsiniz. Bu durumda,başka bir Windows PowerShell'i,"Yönetici Olarak Çalıştır" seçeneğini kullanarak çalıştırın. Daha sonra Sanal ortamınızı başlatmadan önce sırada ki komutları yazmayı deneyin:
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
 
-#### GNU/Linux ve OS X
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
 
 Şu komutu çalıştırarak virtualenv'i başlatın:
 
-```
-    ~/djangogirls$ source myvenv/bin/activate
-```
+{% filename %}komut-satırı{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
 
 `myvenv` yerine kendi seçtiğiniz `virtualenv` ismini koymayı unutmayın!
 
 > **NOT:** bazen `source` komutu kullanılamıyor durumda olabilir. Böyle durumlarda onun yerine aşağıdaki komutu da kullanabilirsiniz:
->
->     ~/djangogirls$ . myvenv/bin/activate
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
 >     
 
-Konsolunuzda şuna benzer bir şey gördüğünüzde `virtualenv`'in başladığını anlayabilirsiniz:
+<!--endsec-->
 
-```
-(myvenv) C:\Users\Name\djangogirls>
-```    
-
-ya da:
-
-```
-(myvenv) ~/djangogirls$
-```    
-
-En başta beliren `(myvenv)`'e dikkat edin!
+Konsolunuzda komut isteminizin başında `(myvenv)` gördüğünüzde `virtualenv`'in çalıştığını anlayabilirsiniz.
 
 Virtualenv ile çalışırken `python` otomatik olarak doğru sürümü çalıştıracaktır. Yani `python3` yerine `python` yazabilirsiniz.
 
@@ -101,22 +152,50 @@ Artık bütün gerekli uygulamaları bir araya getirdiğimize göre sonunda Djan
 
 ## Django'yu yüklemek
 
-`virtualenv`'i başlattığınız için artık Django'yu `pip` kullanarak yükleyebiliriz. Konsola `pip install django==1.11` komutunu yazın. (İki tane eşittir işareti kullandık: `==`).
+`virtualenv`'i çalıştırdığınıza göre,şimdi Django'yu yükleyebilirsiniz.
+
+Bunu yapmadan önce,bilgisayarımızın,Django yüklemek için kullanacağımız yazılım olan `pip`'in en son versiyonuna sahip olduğundan emin olmalıyız
+
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Sonra `pip install django~=1.11.0` (eşittir işaretinden önce tilde işareti kullandığımızı not edin: `~=`) çalıştırarak Django 'yu yükleyin.
 
-```
-(myvenv) ~$ pip install django==1.11
-Downloading/unpacking django==1.11
-Installing collected packages: django
-Successfully installed django
-Cleaning up...
-```    
+{% filename %}komut-satırı{% endfilename %}
 
-Windows'ta
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
 
-> Eğer Windows işletim sisteminde pip komutunu kullanırken bir hatayla karşılaştıysanız proje adresinizin boşluk, aksan veya özel karakter içerip içermediğini (`C:\Users\User Name\djangogirls` gibi) kontrol edin. Eğer durum buysa projenizi boşluk veya özel karakter içermeyen bir adrese taşıyın; önerimiz `C:\djangogirls` olacaktır. Taşıma işleminden sonra yukarıdaki komutu tekrar deneyin.
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
 
-Linux'ta
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Yeni dizinde yeni bir virtualenv oluşturun, arkasından eskisini silin ve yukarıdaki komutu yeniden deneyin. (virtualenv dizinini taşımak işe yaramayacaktır çünkü virtualenv mutlak yollar kullanır.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Django kurmaya çalışırken komut satırınız donabilir. Bu durumda, yukarıdaki komut yerine şu komutu kullanın:
+> 
+> {% filename %}komut-satırı{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
 
 > Eğer Ubuntu 12.04 işletim sisteminde pip komutunu çağırırken bir hata iletisiyle karşılaştıysanız `python -m pip install -U --force-reinstall pip` komutunu çalıştırarak pip kurulumunu onarmayı deneyin.
 
-İşte bu kadar! Sonunda Django uygulamanızı oluşturmaya hazırsınız!
+<!--endsec-->
+
+İşte bu kadar! Sonunda Django uygulamanızı oluşturmaya hazırsınız!
\ No newline at end of file
diff --git a/tr/django_models/README.md b/tr/django_models/README.md
index c2c5d0d523a..cb03a5467ce 100755
--- a/tr/django_models/README.md
+++ b/tr/django_models/README.md
@@ -1,50 +1,49 @@
 # Django modelleri
 
-Şimdi blogumuzdaki bütün yazıları kaydedebileceğimiz bir şey oluşturmak istiyoruz. Ama bunu yapabilmek için önce `nesneler` denen şeylerden bahsetmemiz gerekiyor.
+Şimdi blogumuzdaki bütün yazıları kaydedebileceğimiz bir şey oluşturmak istiyoruz. Ama bunu yapabilmek için önce `nesne` dediğimiz şeylerden (objects) bahsetmemiz gerekiyor.
 
-## Nesneler
+## Nesneler (Objects)
 
-Programlamada `Nesneye yönelik programlama` denen bir kavram bulunuyor. Buradaki ana fikir her şeyi sıkıcı bir düzende programlama komutları ile yazmak yerine şeyleri modelleyip birbirleri ile nasıl etkileşime geçeceklerini tanımlayabileceğimiz.
+Programlamada `nesneye yönelik programlama` denen bir kavram bulunuyor. Buradaki ana fikir her şeyi sıkıcı program komutları dizisi şeklinde yazmak yerine, konseptleri modelleyip birbirleri ile nasıl etkileşime geçeceklerini tanımlamak.
 
-Peki bir nesne nedir? Özelliklerin ve hareketlerin bir bütünüdür. Kulağa garip geliyor olabilir ama bir örnekle açıklayacağız.
+Peki bir nesne nedir? Nesne bir özellikler ve hareketler bütünüdür. Kulağa garip geliyor olabilir, bir örnekle açıklayalım.
 
-Eğer bir kediyi modellemek istiyorsak `Kedi` nesnesini oluştururuz ve bu nesne şöyle özelliklere sahip olur:`renk`, `yas`, `ruh_hali` (örneğin; iyi, kötü, uykulu ;)) ve `sahibi` (ki bu da bir `İnsan` nesnesi olur ya da eğer sokak kedisi ise bu özellik boş olabilir).
+Eğer bir kediyi modellemek istiyorsak, `Kedi` nesnesini oluştururuz ve bu nesne şöyle özelliklere sahip olur: `renk`, `yas`, `ruh_hali` (örneğin; iyi, kötü, uykulu ;)) ve `sahibi` (ki bu da bir `insan` nesnesi olur ya da eğer sokak kedisi ise bu özellik boş olabilir).
 
-`Kedi` bazı hareketlere sahiptir: `miyavla`, `tirmala` ya da `beslen` (bu durumda kediye biraz `KediMamasi` vermemiz gerekir ki o da kendine ait özellikleri olan başka bir nesne olur. Özelliklere örnek olarak `tat` verilebilir).
+Ayrıca `Kedi` bazı hareketlere sahiptir: `miyavla`, `tirmala` ya da `beslen` (bu durumda kediye biraz `KediMamasi` vermemiz gerekir ki o da kendine ait özellikleri olan başka bir nesne olarak tanımlanabilir, bu durumda onun özellikleri arasında da `tat` yer alabilir).
 
-```
-Kedi
---------
-renk
-yas
-ruh_hali
-sahibi
-miyavla()
-tirmala()
-beslen(kedi_mamasi)
+    Kedi
+    --------
+    renk 
+    yas 
+    ruh_hali 
+    sahibi 
+    miyavla() 
+    tirmala() 
+    beslen(kedi_mamasi)
+    
 
-KediMamasi
---------
-tat
-```   
+    KediMamasi
+    -------- 
+    tat
+    
 
-Yani aslında ana fikir, gerçek nesneleri kod içinde özellikleriyle (`nesne özellikleri`) ve hareketleriyle (`metodlar`) tanımlamak.).
+Yani aslında ana fikir, gerçek nesneleri kod içinde özellikleri (`nesne özellikleri`) ve hareketleri (`metodlar`) ile tanımlamak.
 
-Öyleyse blog gönderilerini nasıl modelleyeceğiz? Bir blog tasarlamak istiyoruz degil mi?
+Öyleyse blog gönderilerini nasıl modelleyeceğiz? Bir blog tasarlamak istiyoruz, degil mi?
 
-Cevaplamamız gereken soru: Blog gönderisi nedir? Özellikleri ne olmalıdır?
+Cevaplamamız gereken soru: Bir blog gönderisi nedir? Özellikleri ne olmalıdır?
 
-Tabii ki blog gönderimizin içeriği için yazı ve bir de başlık lazım, değil mi? Kimin yazdığını da bilsek iyi olur - dolayısı ile bir yazara da ihtiyacımız var. Son olarak, gönderinin ne zaman yaratıldığını ve yayınlandığını bilmek isteriz.
+Tabii ki blog gönderimizin içeriği için yazı ve bir de başlık lazım, değil mi? Kimin yazdığını da bilsek iyi olur - dolayısı ile bir de yazara ihtiyacımız var. Son olarak, gönderinin ne zaman yaratıldığını ve yayınlandığını da bilmek isteyebiliriz.
 
-```
-Post
-------
-baslik
-yazi
-yazar
-yaratilma_tarihi
-yayinlanma_tarihi
-```
+    Post
+    ------
+    baslik
+    yazi
+    yazar
+    yaratilma_tarihi
+    yayinlanma_tarihi
+    
 
 Bir blog gönderisi ile ne tür şeyler yapılabilir? Gönderiyi yayınlayan bir `method` olması güzel olurdu, değil mi?
 
@@ -56,42 +55,51 @@ Ne elde etmek istediğimizi bildiğimize göre, haydi bunu Django'da modellemeye
 
 Nesnenin ne olduğunu bildiğimize göre, blog gönderimiz için bir Django modeli oluşturabiliriz.
 
-Django'da bir model özel bir çeşit nesnedir - `veritabanı`'na kaydedilir. Veritabanı veri topluluğuna verilen isimdir. Burası, kullanıcıları, blog gönderileri gibi bilgileri saklayacağımız yerdir. Verilerimizi depolamak için SQLite veritabanını kullanacağız. Bu varsayılan Django veritabanı adaptörüdür - şimdilik bizim için yeterli olacaktır.
+Django'da modeller özel bir çeşit nesnedir - `veritabanı`'na kaydedilir. Veritabanı ise veri topluluğuna verdiğimiz isim. Veritabanında, kullanıcılar, blog gönderileri, vs. ile ilgili bilgileri saklarız. Verilerimizi depolamak için SQLite veritabanını kullanacağız. Bu varsayılan Django veritabanı adaptörü - şimdilik bizim için yeterli olacaktır.
 
-Veritabanındaki bir modeli sütunları (alan adı) ve satırları (veri) olan bir hesap çizelgesi olarak düşünebiliriz.
+Veritabanındaki bir modeli, sütunları (alan adı) ve satırları (veri) olan bir hesap çizelgesi olarak düşünebilirsiniz.
 
 ### Uygulama oluşturma
 
 Her şeyi derli toplu tutmak için, projemizin içinde ayrı bir uygulama oluşturacağız. Her şeyin en başından düzenli olması çok iyidir. Bir uygulama oluşturmak için aşağıdaki komutu konsolda çalıştırmamız gerekiyor ( `djangogirls` dizininden `manage.py` dosyasının bulunduğu yer):
 
-```
-(myvenv) ~/djangogirls$ python manage.py startapp blog
-```
+{% filename %}Mac OS X ve Linux:{% endfilename %}
 
-İçinde birkaç dosya olan yeni bir `blog` klasörü fark edeceksiniz. Projemizdeki klasörler ve dosyalar şöyle olmalı:
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
 
-```
-djangogirls
-├── mysite
-|       __init__.py
-|       settings.py
-|       urls.py
-|       wsgi.py
-├── manage.py
-└── blog
-├── migrations
-|       __init__.py
-├── __init__.py
-├── admin.py
-├── models.py
-├── tests.py
-└── views.py
-```
+{% filename %}Windows:{% endfilename %}
 
-Uygulamamızı oluşturduktan sonra, Django'ya bunu kullanmasını da söylememiz lazım. Bunu `mysite/settings.py` dosyası ile yapıyoruz. `INSTALLED_APPS` dosyasını bulup `'blog'` u tam `)` karakterinin üzerine yazmamız lazım. Sonunda dosya şuna benzemelidir:
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
 
-```
-INSTALLED_APPS = (
+Şimdi oluşturulmuş yeni bir `blog` dizinini göreceksiniz ve bu, dizinlerin bir numarasını içerir. Bizim projemizdeki dizinler ve dosyalar bunun gibi görünmeli:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+Bir uygulamayı oluşturduktan sonra, Django’ya da onu kullanmasını söylememiz lazım. Bunu `mysite/settings.py` dosyasında yapıyoruz. `INSTALLED_APPS`‘ı bulmalı ve `]`’ın tam üzerine `'blog',`‘ı içeren bir satır eklemeliyiz. Sonunda ürün bunun gibi görünmeli:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
     'django.contrib.admin',
     'django.contrib.auth',
     'django.contrib.contenttypes',
@@ -99,14 +107,16 @@ INSTALLED_APPS = (
     'django.contrib.messages',
     'django.contrib.staticfiles',
     'blog',
-)
-```    
+]
+```
 
 ### Post (Blog gönderisi) modeli oluşturma
 
-`blog/models.py` dosyasında `Models` deki tüm nesneler tanımlanır - burası bizim blog postunu tanımlayacağımız yerdir.
+`blog/models.py` dosyasında `Models` denilen bütün nesneleri tanımlıyoruz - bu blog postumuzu tanımlayacağımız bir yerdir.
+
+`blog/models.py`‘ı açalım, burdaki herşeyi sil, ve kodu bunun gibi yaz:
 
-Şimdi `blog/models.py` dosyasını açalım ve içindeki her şeyi silip şu kodu yazalım:
+{% filename %}blog/models.py{% endfilename %}
 
 ```python
 from django.db import models
@@ -114,69 +124,76 @@ from django.utils import timezone
 
 
 class Post(models.Model):
-    yazar = models.ForeignKey('auth.User')
-    baslik = models.CharField(max_length=200)
-    yazi = models.TextField()
-    yaratilma_tarihi = models.DateTimeField(
-           default=timezone.now)
-    yayinlanma_tarihi = models.DateTimeField(
-           blank=True, null=True)
-
-    def yayinla(self):
-        self.yayinlanma_tarihi = timezone.now()
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
         self.save()
 
     def __str__(self):
-        return self.baslik
-```    
+        return self.title
+```
+
+> `str`'nin her iki tarafında da 2 tane alt çizgi (`_`) kullandığınızdan emin olun. İki alt çizgi Python dilinde sık kullanılır, bazen "dunder" olarak da anılır ("double-underscore"un kısaltması).
 
-> `str` nin her iki tarafında 2 tane alt çizgi (`_`) kullandığınızı kontrol edin. İki alt çizgi Python dilinde sık kullanılır.
+Korkutucu, değil mi? Fakat endişelenmeyin - Bu satırların ne anlama geldiğini açıklayacağız!
 
-Biraz korkunç görünüyor, değil mi? Ama merak etmeyin, her şeyin ne demek olduğunu tek tek anlatacağız!
+Bütün satırlar `from`‘la başlar veya `imprt` diğer dosyalardan bazı bitlerin eklendiği satırlardır. Yani her dosyada aynı şeyleri kopyalayıp yapıştırmak yerine, `‘la bazı bölümleri de ekleyebiliriz... import ...`.
 
-`from` veya `import` ile başlayan tüm satırlar başka yerlerden bir şeyleri projemize dahil eder. Yani, başka yerlerde tanımlanmış kodları dosyalarımıza kopyalamak yerine, bu kodların bir kısmını `from ... import ...` ile projemize dahil edebiliriz.
+`class Post(models.Model):` - bu satır modelimizi tanımlar (bu bir `nesne`‘dir).
 
-`class Post(models.Model):` - bu satır modelimizi tanımlar (bir `nesne` dir).
+- `class` bir nesne tanımladığımızı belirten bir anahtar kelimedir.
+- `Post` modelimizin ismi. Başka bir isim de verebilirdik (yeter ki özel karakterler ve boşluk kullanmayalım). Class isimleri her zaman büyük harf ile başlamalıdır.
+- `models.Model` Post'un bir Django Modeli olduğunu belirtir, bu şekilde Django onu veritabanında tutması gerektiğini bilir.
 
-*   `class` bir nesne tanımladığımızı belirten bir anahtar kelimedir.
-*   `Post` modelimizin ismidir. Başka bir isim de verebilirdik (yeter ki özel karakterler ve boşluk kullanmayalım). Class isimleri her zaman büyük harf ile başlamalıdır.
-*   `models.Model` Post'un bir Django Modeli olduğunu belirtir, bu şekilde Django onu veritabanında tutması gerektiğini bilir.
+Şimdi daha önce bahsettiğimiz özellikleri tanımlayabiliriz: `title`, `text`, `created_date`, `published_date` ve `author`. Bunun için her alanın türünü tanımlamamız gerekir (Bu metin mi? Bir numara mı? Bir tarih mi? Bir kullanıcı gibi, başka bir nesne ile bağlantılı mı?)
 
-Şimdi daha önce bahsettiğimiz özellikleri tanımlayabiliriz: `baslik`, `yazi`, `yaratilma_tarihi`, `yayinlanma_tarihi` ve `yazar` (Türkçe karakterleri kullanamadığımızı unutmayalım). Bunun için her alanın tipini belirtmemiz lazım (metin mi? Sayı mı? Tarih mi? Başka bir nesneye referans mı, ör. Kullanıcı?).
+- `models.CharField` - belirli bir uzunluktaki metinleri tanımlamak için kullanılır.
+- `models.TextField` - bu da uzun metinleri tanımlar. Blog gönderileri için biçilmiş kaftan, değil mi?
+- `models.DateTimeField` - bu da gün ve saati tanımlamada kullanılır.
+- `models.ForeignKey` - başka bir modele referans tanımlar.
 
-*   `models.CharField` - kısıtlı uzunlukta metin tanımlamak için kullanılır.
-*   `models.TextField` - bu da uzun metinleri tanımlar. Blog gönderileri için biçilmiş kaftan, değil mi?
-*   `models.DateTimeField` -bu da gün ve saati tanımlamada kullanılır.
-*   `models.ForeignKey` - başka bir model ile bağlantı içerir.
+Çok zaman aldığından burada her bit kodunu açıklamayacağız. Model dosyalarından daha çok bilgi almak ve yukarıdaki açıklamalardan farklı tanımlamaları öğrenmek istiyorsanız Django'nun belgelerine daha çok bakmalısınız (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
 
-Burada her detayı anlatmıyoruz, çünkü çok fazla vakit alır. Eğer detayları merak ederseniz veya farklı tür alanlar tanımlamak isterseniz Django'nun dokümantasyonlarına bakabilirsiniz (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+What about `def publish(self):`? Bu, daha önce bahsettiğimiz tam olarak `publish` yöntemidir. `def` means that this is a function/method and `publish` is the name of the method. Eğer isterseniz metodun adını değiştirebilirsiniz. Adlandırma kuralı boşluk yerine küçük harf ve alt çizgi kullanmamızdır. Örneğin ortalama fiyatı hesaplayan bir yöntem çağrılabilir `calculate_average_price`.
 
-Peki `def yayinla(self):` nedir? Daha önce bahsettiğimiz `yayinla` methodudur. `def` bir fonksiyon/method olduğunu belirtir, `yayinla` ise bu methodun adıdır. İstersen methodun ismini değiştirebilirsin. Methodlara isim verirken küçük harf kullanmaya ve boşluk yerine alt çizgi kullanmaya dikkat etmemiz gerekiyor. Örneğin ortalama fiyatı hesaplayan bir methoda `ortalama_fiyati_hesapla` ismi verilebilir.
+Yöntemler çoğu kez bir şeylere `return`. `__str__` yönteminde bunun bir örneği vardır. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
 
-Genellikle methodlar bir şey geri döndürür (`return` anahtar kelimesi döndür anlamına gelir). `__str__` methodunda bunun örneğini görebiliriz. Bu durumda `__str__()` methodunu çağırdığımızda Post başlığının yazısını (**string**) elde ederiz.
+Aynı zamanda hem `def publish(self):` satırının, hem de `def __str__(self):` satırının sınıfımızın içinde girintili bir şekilde yazıldığına dikkat edin. Çünkü Python boşlukta duyarlıdır, yöntemlerimizi sınıfın içine sokmalıyız. Aksi takdirde, yöntemler sınıfın üyesi olmaz, ve bazı beklenmedik davranışlar elde edebilirsiniz.
 
-Buraya kadar model hakkında anlamadığın bir şeyler varsa mentörüne sormaktan çekinme! Bu konuların biraz karmaşık olduğunun farkındayız. Özellikle hem nesneleri hem de fonksiyonları aynı anda öğrenmek kolay değil. Umarız gizemi biraz azalmaya başlamıştır!
+Hala modeller hakkında bir şeyler belli değil ise, koçuna sormaktan çekinme! Özellikle hem nesneleri hem de fonksiyonları aynı anda öğrenmenin karmaşık olduğunu biliyoruz. Ama şimdi umarız ki senin için biraz daha az sihirli görünüyor!
 
 ### Modeller için veritabanında tablo oluşturma
 
-Son adımımız yeni modelimizin veritabanına eklenmesini sağlamak. İlk önce Django'ya modelde bir takım değişiklikler yaptığımızı haber vermemiz gerekiyor (modeli yeni oluşturduk!). `python manage.py makemigrations blog` yazın. Şöyle görünmeli:
+Buradaki son adım, yeni modelimizi veritabanımıza eklemek. İlk olarak, modelimizdeki bazı değişikliklerden Django’yu haberdar etmeliyiz. (Daha yeni oluşturduk!) konsol pencerenize gidin ve `python manage.py makemigrations blog` yazın. Bunun gibi görünecek:
 
-```
-(myvenv) ~/djangogirls$ python manage.py makemigrations blog
-Migrations for 'blog':
-0001_initial.py:
-  - Create model Post
-```
+{% filename %}komut-satır{% endfilename %}
 
-Django bize veritabanımıza uygulayabileceğimiz bir taşıma (migrasyon) dosyası oluşturdu. `python manage.py migrate blog` yazdığın zaman şunu görmelisin:
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
 
-```
-(myvenv) ~/djangogirls$ python manage.py migrate blog
-Operations to perform:
-  Apply all migrations: blog
-Running migrations:
-  Rendering model states... DONE
-  Applying blog.0001_initial... OK
-```  
-
-Yaşasın! Post modelimiz artık veritabanımızda! Görsek ne güzel olur, değil mi? Gelecek bölümde Post'un nasıl göründügünü göreceğiz!
+**Not:** Düzenlediğiniz dosyaları kaydetmeyi unutmayın. Aksi takdirde, bilgisayarınız beklenmedik hata mesajlarını verebilecek önceki sürümü çalıştıracaktır.
+
+Django bize veritabanımıza uygulayabileceğimiz bir taşıma dosyası oluşturdu. `python manage.py migrate blog` yaz ve çıktı aşağıdaki gibi olmalıdır:
+
+{% filename %}komut-satır{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Yaşasın! Model yazımız şimdi veritabanımızda! Onu görmek güzel olur, değil mi? Yazınızın neye benzediğini görmek için bir sonraki bölüme geçin!
\ No newline at end of file
diff --git a/tr/django_orm/README.md b/tr/django_orm/README.md
index da56365191a..f0d21e16b92 100755
--- a/tr/django_orm/README.md
+++ b/tr/django_orm/README.md
@@ -4,175 +4,215 @@ Bu bölümde Django'nun veritabanına nasıl bağlandığını ve veriyi nasıl
 
 ## QuerySet (SorguSeti) Nedir?
 
-QuerySet (SorguSeti), esas olarak, verilen bir modelin nesnelerinin listesidir. QuerySet veritabanından veri okumamıza, veriyi filtrelememize ve sıralamamıza imkan sağlar.
+QuerySet(SorguSeti), temel olarak, verilmiş olan bir Modelin nesnelerinin bir listesini oluşturmaktadır. QuerySet(SorguSeti) veritabanından verileri okumanızı, bu verileri filtrelemenizi ve düzenlemenizi sağlar.
 
 En kolayı örnekle öğrenmektir. Hadi deneyelim, olur mu?
 
 ## Django shell (kabuk)
 
 Yerel konsolumuzu açalım (PythonAnywhere'dekini değil) ve şu komutu yazalım:
-```
-(myvenv) ~/djangogirls$ python manage.py shell
-```    
+
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
 
 Etkisi aşağıdaki gibi olmalı:
-```
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 (InteractiveConsole)
 >>>
-```    
+```
 
-Şu an Django'nun etkileşimli konsolundayız. Python istemine benziyor, ama biraz Django büyüsü eklenmiş :) Kuşkusuz burada da Python komutlarının tümünü kullanabiliriz.
+Şu anda Django interaktif konsoldasınız. Python komut istemi gibi fakat biraz Django büyüsü katılmış hali. :) Tabii ki, bütün python komutlarını buradada kullanabilirsiniz.
 
 ### Tüm nesneler
 
 Önce tüm gönderilerimizi görüntülemeyi deneyelim. Bunu aşağıdaki komut ile yapabiliriz:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> Post.objects.all()
 Traceback (most recent call last):
-  File "<console>", line 1, in <module>
+      File "<console>", line 1, in <module>
 NameError: name 'Post' is not defined
-```    
+```
 
-Aman! Bir hata meydana geldi. Bize bir gönderi olmadığını söylüyor. Doğru - önce gönderiyi almayı unuttuk!
+Ahh! Bir hata meydana geldi. Bize hiç gönderi olmadığını söylüyor. Bu doğru, önce gönderiyi içeriye aktarmayı unuttuk!
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> from blog.models import Post
-```    
+```
 
-`Post` modelini `blog.models` model havuzundan kolayca kodumuza dahil ettik. Şimdi bütün gönderileri tekrar göstermeyi deneyelim:
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> Post.objects.all()
-<QuerySet [<Post: Gönderi 1>, <Post: Gönderi 2>]>
-```    
+<SorguSeti [<Gönderi: Gönderi başlığım>, <Gönderi: Diğer ir gönderi başlığı>]>
+```
 
-Daha önce yarattığımız gönderilerin listesi! Bu gönderileri Django yönetici arayüzü kullanarak yaratmıştık. Şimdi ise Python kullanarak yeni gönderiler yaratmak istiyoruz, bunu nasıl yapabiliriz?
+Bu daha önce oluşturduğumuz gönderilerin listesi! Bu gönderileri Django admin arayüzü ile oluşturduk. Fakat şimdi python'u kullanarak yeni gönderiler oluşturmak istiyoruz, peki bunu nasıl yaparız?
 
 ### Nesne oluşturma
 
 Veritabanına yeni bir gönderi eklemek için:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> Post.objects.create(yazar=ben, baslik='Harika bir gönderi', yazi='Ne desem bilemedim')
-```    
+```
 
-Ancak bir eksiğimiz var: `ben`. Gönderinin yazar özelliğine `User` modelinden türetilen bir nesneyi parametre olarak vermemiz gerekiyor. Nasıl verebiliriz?
+Fakat burada bir eksik maddemiz var: `ben`. Bir yazar olarak `Kullanıcı` modelinin bir örneğini göstermemiz gerekiyor. Bunu nasıl yaparız?
 
 Öncelikle kullanıcı modelini dahil edelim:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> from django.contrib.auth.models import User
-``` 
+```
 
 Veritabanımızda hangi kullanıcılar var? Şu şekilde görebiliriz:
 
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>>User.objects.all()
+<SorguSetleri [<Kullanıcı: ola>]>
 ```
->>> User.objects.all()
-<QuerySet [<User: zeynep>]>
-```    
 
-Daha önce yarattığımız ayrıcalıklı kullanıcı! Şimdi veritabanından kullanıcı nesnesi alalım:
+Bu daha önce oluşturduğumuz yetkili kullanıcı! Şimdi kullanıcının örneğini alalım:
+
+{% filename %}komut-satırı{% endfilename %}
 
+```python
+>>> ben = User.objects.get(kullanıcı adı='ola')
 ```
-ben = User.objects.get(username='zeynep')
-```    
 
-Gördüğünüz gibi, `username` özelliği 'zeynep' olan `User` nesnesini `get` ile aldık. Müthiş! Tabiki, kullanıcı adını kendi kullanıcı adınıza göre ayarlamalısınız.
+Gördüğünüz gibi, 'ola' `kullanıcı adı`'yla aynı olan bir `kullanıcı` `aldık`. Muntazam! Tabiki, kendi kullanıcı adınızı kullanmak için bu satırı ayarlarınızı yapmanız gerekmektedir.
 
 Gönderimizi artık kaydedebiliriz:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> Post.objects.create(yazar=ben, baslik='Harika bir gönderi', yazi='Ne desem bilemedim')
-```    
+```
 
 Yaşasın! Çalışıp çalışmadığını kontrol etmek ister misin?
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> Post.objects.all()
-<QuerySet [<Post: Gönderi 1>, <Post: Gönderi 2>, <Post: Harika bir gönderi>]>
-```    
+<SorguSetleri [<Gönderi: gönderi başlığım>, <Gönderi: Diğer bir gönderi başlığı>, <Gönderi: Örnek başlık>]>
+```
 
 İşte bu kadar, listede bir gönderi daha!
 
 ### Daha fazla gönderi ekle
 
-Şimdi biraz eğlenenebiliriz ve nasıl çalıştığını görmek için daha fazla gönderi ekleyebiliriz. 2-3 tane daha ekleyin ve bir sonraki kısma devam edin.
+Şimdi daha fazla gönderi ekleyerek biraz eğlenebilir ve nasıl çalıştığını görebilirsin. İki veya üç tane daha ekle ve sıradaki bölüme geç.
 
 ### Nesneleri filtrelemek
 
-QuerySets in büyük bir parçası nesneleri filtreleyebilme kabiliyetidir. Diyelim ki, Zeynep tarafından yazılmış tüm gönderileri bulmak istiyoruz. `Post.objects.all()` içindeki `all` yerine `filter` kullanacağız. Parantez içine istediğimiz blog gönderilerinin sağlaması gereken şartları belirteceğiz. Örneğimizde, `yazar` `ben`'e eşitti. Django'da bu filtre şöyle yazılır: `yazar=ben`. Şu an kod parçacığımız şöyle görünüyor:
+QuerySet'lerin büyük bir bölümü onları filtreleme yeteneğidir. Diyelim ki ola yazarına ait tüm gönderileri bulmak istiyoruz. `Post.objects.all()` içindeki `all` yerine `filter` kullanacağız. Parantez içine istediğimiz blog gönderilerinin sorgusetimize girmesi için sağlaması gereken şart(lar) ı belirteceğiz. Bizim örneğimizde, `yazar`'ın `bana` eşit olma koşulu vardır. Django'da bu şu şekilde yazılır: `yazar=ben`. Şu an kod parçacığımız şöyle görünüyor:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> Post.objects.filter(yazar=ben)
 [<Post: Gönderi 1>, <Post: Gönderi 2>, <Post: Harika bir gönderi>, <Post: Nefis bir gönderi>]
-```    
+```
 
-Ya da belki `baslik` alanında içinde 'Nefis' kelimesini içeren tüm gönderileri görmek istiyoruz?
+Yada belkide içinde 'Başlık' kelimesi olan bütün gönderileri `başlık`alanında görmek istiyoruzdur?
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> Post.objects.filter(baslik__contains='Nefis')
 [<Post: Nefis bir gönderi>]
-```    
+```
 
-> **Not** `baslik` ve `contains` arasında iki tane alt çizgi (`_`) var. Django'nun ORM'i bu söz dizimini, özelliği ("baslik") ve operasyon veya filtreyi ("contains") ayırmak için kullanır. Sadece tek alt çizgi kullanırsanız, "FieldError: Cannot resolve keyword baslik_contains" hatası alırsınız.
+> **Not** `baslik` ve `contains` arasında iki tane alt çizgi (`_`) var. Django'nun ORM'i bu söz dizimini, özelliği ("title") ve operasyon veya filtreyi ("contains") ayırmak için kullanır. Eğer sadece tek bir alt çizgi kullanırsanız, "FieldError: Cannot resolve keyword title_contains" şeklinde bir hata alacaksınız.
 
-Ayrıca yayınlanmış tüm gönderilerin bir listesini alabiliriz. Bunu geçmişte `yayinlanma_tarihi` alanı belirtilmiş tüm gönderileri filtreleyerek yapıyoruz:
+Ayrıca yayınlananmış olan tüm gönderilerin bir listesini de alabilirsiniz. Bunu, yayınlanmış olan postlar içerisinde `yayınlanma_tarihi` şeklinde filtreleyerek yapıyoruz:
 
-```
->>> from django.utils import timezone
->>> Post.objects.filter(yayinlanma_tarihi__lte=timezone.now())
->>> <QuerySet []>
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> django.utils'ten zaman dilimlerini içe aktar
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
 ```
 
-Maalesef, Python konsolundan eklediğimiz gönderi henüz yayınlanmadı. Bunu değiştirebiliriz! İlk olarak yayınlamak istediğimiz gönderinin bir örneğini alalım:
+Maalesef python konsolundan eklediğimiz gönderi henüz yayınlanmadı. Fakat bunu değiştirebiliriz! Önce yayınlamak istediğimiz bir gönderinin örneğini bulalım:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> post = Post.objects.get(baslik="Harika bir gönderi")
-```    
+```
 
-Ardından `yayinla` methodu ile gönderiyi yayınlayalım!
+Ardından `yayinla` methodu ile gönderiyi yayınlayalım:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> post.yayinla()
-```    
+```
 
-Şimdi yayınlanmış gönderileri tekrar almaya çalışalım (3 kez yukarı yön ve ardından `enter` tuşuna basın):
+Şimdi tekrar yayınlanmış gönderilerin listesini edinin.(Üç kere yukarı ok tuşuna basın ve `enter`)'a basın:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> Post.objects.filter(yayinlanma_tarihi__lte=timezone.now())
 [<Post: Harika bir gönderi>]
-```  
+```
 
 ### Nesneleri Sıralama
 
 QuerySets ayrıca nesne listesini sıralamanızı da sağlar. Nesneleri `yaratilma_tarihi` özelliğine göre sıralamayı deneyelim:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> Post.objects.order_by('yaratilma_tarihi')
 [<Post: Gönderi 1>, <Post: Gönderi 2>, <Post: Harika bir gönderi>, <Post: Nefis bir gönderi>]
-```    
+```
 
 Başına `-` ekleyerek sıralamayı tersine de çevirebiliriz:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> Post.objects.order_by('-yaratilma_tarihi')
 [<Post: Nefis bir gönderi>, <Post: Harika bir gönderi>, <Post: Gönderi 2>, <Post: Gönderi 1>]
-```    
+```
 
 ### Sorgu Setlerini Zincirlemek
 
 Sorgu setlerini **zincirleyerek** beraber kullanabilirsiniz:
 
-```
->>> Post.objects.filter(yayinlanma_tarihi__lte=timezone.now()).order_by('yayinlanma_tarihi')
-```    
+    >>> Post.objects.filter(yayinlanma_tarihi__lte=timezone.now()).order_by('yayinlanma_tarihi')
+    
 
 Zincirleme gerçekten çok güçlüdür ve oldukça karmaşık sorgular yazmanıza imkan sağlar.
 
 Güzel! Şimdi bir sonraki bölüm için hazırız. Kabuğu kapatmak için, şunu yazalım:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> exit()
 $
-```
+```
\ No newline at end of file
diff --git a/tr/django_start_project/README.md b/tr/django_start_project/README.md
index 19febaad4f6..a2f90d527b2 100755
--- a/tr/django_start_project/README.md
+++ b/tr/django_start_project/README.md
@@ -1,48 +1,61 @@
 # İlk Django projen!
 
-> Bu bölümün kaynağı Geek Girls Carrots (http://django.carrots.pl/) eğitim materyalidir.
+> Bu bölümün bir kısmı Geek Girls Carrots tarafından hazırlanmış eğitimlere dayanılarak hazırlanmıştır (https://github.com/ggcarrots/django-carrots).
 > 
-> Bölümün parçaları Creative Commons Attribution-ShareAlike 4.0 International License ile lisanslı [django-marcador tutorial][1]'a dayanılarak hazırlanmıştır. Django-marcador tutorial'ının hakları Markus Zapke-Gründemann'e aittir.
+> Bu bölümün [django-marcador tutorial](http://django-marcador.keimlink.de/)'a dayanan bazı kısımları Creative Commons Attribution-ShareAlike International License altında lisanslanmıştır. Django-marcador tutorial'ının hakları Markus Zapke-Gründemann'e aittir.
 
- [1]: http://django-marcador.keimlink.de/
-
-Basit bir blog oluşturacağız!
+We're going to create a small blog!
 
 İlk adım yeni bir Django projesi başlatmaktır. Aslında, bizim için bir Django projesinin iskeletini yaratacak Django tarafından sağlanan bazı komut dosyaları çalıştıracağız. Bu sadece daha sonra kullanacağımız dosyalar ve dizinler grubudur.
 
 Bazı dosya ve dizinlerin isimleri Django için çok önemlidir. Oluşturmak üzere olduğumuz dosyaları yeniden adlandırmamalısınız. Onları başka bir yere taşımak da iyi bir fikir değil. Django'nun önemli şeyleri bulabilmesi için belirli yapısını koruması gerekir.
 
-> virtualenv içindeki her şeyi çalıştırmayı unutmayın. Eğer konsolunuzda bir önek `(myvenv)` görmüyorsanız virtualenv'nizi çalışır hale getirmelisiniz. **Django yükleme** bölümünün **virtualenv ile Çalışma** kısmında nasıl yapılacağını açıkladık. Windows'da ` myvenv\Scripts\activate` ya da Mac OS / Linux'ta `source myvenv/bin/activate` yazmak sizin için bunu yapacaktır.
+> virtualenv içindeki her şeyi çalıştırmayı unutmayın. Eğer konsolunuzda `(myenv)` öneki görmüyorsanız, virtualenv'inizi aktive etmeniz gerekir. **Django yükleme** bölümünün **virtualenv ile Çalışma** kısmında nasıl yapılacağını açıkladık. Windows'ta `myvenv\Scripts\activate` ya da, Mac OS ya da Linux'ta `source myvenv/bin/activate` yazmak bunu sizin için yapacaktır.
 
-MacOS veya Linux konsolunuzda aşağıdaki komutu çalıştırmalısınız; **sonuna nokta `(.)` koymayı unutmayın**:
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
 
-```
-(myvenv) ~/djangogirls$ django-admin startproject mysite .
-```    
+Mac OS X or Linux konsolunuzda, devam eden şu komutu çalıştırmalısınız. **Periyot eklemeyi unutmayın (yada nokta)`.`sonunda!**
 
-Windows'ta; ** sonunda nokta `(.)` koymayı unutmayın**:
+{% filename %}komut-satırı{% endfilename %}
 
-```
-(myvenv) C:\Users\Name\djangogirls > django-admin startproject mysite .
-```    
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Nokta `.` bu durumda çok önemlidir çünkü; koda, Django'yu şu an bulunduğunuz dizine kurmasını söyler. (nokta `.` şu anki dizine bir kısayoldur).
+> 
+> **Not** Yukarıdaki komutu yazarken, sadece `django-admin` ile başlayan kısmı yazmanız gerektiğini unutmayın. Burada gösterilen `(myvenv) ~/djangogirls$` kısmı, sadece komut satırında girdinizi davet eden komut istemi örneğidir.
+
+<!--endsec-->
 
-> Nokta `.` bu durumda çok önemlidir çünkü; koda, Django'yu şu an bulunduğunuz dizine kurmasını söyler. (nokta `.` şu anki dizine bir kısayoldur)
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Windows'ta aşağıdaki kumutu çalıştırmalısınız. **(Sonuna nokta `.` koymayı unutmayın)**:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Nokta `.` bu durumda çok önemlidir çünkü; koda, Django'yu şu an bulunduğunuz dizine kurmasını söyler. (nokta `.` şu anki dizine bir kısayoldur).
 > 
-> **Not** Yukarıdaki komutları yazarken sadece `django-admin` veya `django-admin.py` ile başlayan bölümü yazmayı unutmayın. Burada gösterilen `(myvenv) ~/djangogirls$` ve `(myvenv) C:\Users\Name\djangogirls>` kısımları, sadece, komut satırınızdaki girdilerinizi çağıracak olan komut isteği örnekleridir.
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
 
 `django-admin.py` sizin için dosya ve dizinler oluşturacak bir komut dosyasıdır. Şimdi aşağıdaki gibi görünen bir dizin yapınız olmalı:
 
-```
-djangogirls
-├───manage.py
-└───mysite
-    settings.py
-    urls.py
-    wsgi.py
-    __init__.py
-``` 
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
 
-`manage.py` site yönetimine yardımcı olan bir komut dosyasıdır. Bu dosya sayesinde, başka herhangi bir şey kurmadan bilgisayarımızda bir web sunucusunu başlatabileceğiz.
+> **Not**: Dizin yapınızda, daha önceden oluşturduğumuz `venv` dizinini de göreceksiniz.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
 
 `settings.py` dosyası, web sitesinizin ayarlarını içerir.
 
@@ -54,31 +67,57 @@ Bir mektubu nereye götüreceğini kontrol eden postacının hakkında konuştu
 
 Hadi `mysite/settings.py` dosyasında bazı değişiklikler yapalım. Daha önceden kurduğunuz kod düzenleyicinizi kullanarak dosyayı açın.
 
-Web sitemizin doğru bir saate sahip olması güzel olurdu. [wikipedia timezones list][2] 'e gidin ve ilgili saat diliminizi (TZ -time zone-) kopyalayın. (örn. `Europe/Istanbul` )
+**Not**: Bunu aklınızda tutun, `settings.py` dosyası da diğerleri gibi düzenli bir dosyadır. Bunu kod düzenleyicisi içerisinde "dosya -> aç" menü eylemini kullanarak açabilirsiniz. Bu, size `settings.py` dosyanıza gidebileceğiniz ve bu dosyayı seçebileceğiniz her zamanki klasik pencereyi alacaktır. Alternatif olarak, bu dosyayı masaüstünüzdeki djangogirls klasörüne gidip sağ tıklayarak açabilirsiniz. Sonra, listeden kod düzenleyicinizi seçiniz. Dosyayı açabilen ancak düzenlemenize izin vermeyecek diğer programların yüklü olabilmesi nedeniyle kod düzenleyicinin seçilmesi önem arz etmektedir.
+
+Web sitemizin doğru bir saate sahip olması güzel olurdu. [Wikipedia'nın zaman dilimleri listesine](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) gidin ve ve ilgili saat dilimini kopyalayın (ZD) (Ör. `Europe/Berlin`).
 
- [2]: http://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+`settings.py`'de, `TIME_ZONE` içeren satırı bulun ve kendi zaman diliminizi seçmek için değiştirin. Örnek olarak:
 
-`settings.py` dosyasında <0>TIME_ZONE</0> ifadesini içeren satırı bulun ve kendi seçtiğiniz zaman dilimine göre uyarlayın:
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 TIME_ZONE = 'Europe/Istanbul'
-```    
+```
 
-"Europe/Istanbul" uygun şekilde değiştirildi
+Bir dil kodu dilden oluşmaktadır, ör. `en` ingilizce için veya `de` almanca için, ve ülke kodu da, ör. `de` almanya için veya `ch`isviçre için. Django'daki varsayılan butonların ve bildirimlerin sizin dilinizde olmasını istiyorsanız bunu eklemek isteyeceksiniz. Böylece "İptal" butonu burada tanımladığınız dile çevrilmiş olacaktır. [Django hazırlanmış olan bir çok çeviri ile birlikte gelmektedir](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
 
-Sabit dosyalar için de bir tane yol eklememiz gerekecek (Daha sonra eğitimde sabit dosyalar ve CSS hakkındaki her şeyi öğreneceğiz). Dosyanın *sonuna* en aşağıya `STATIC_URL` girdisinin altına gidin ve `STATIC_ROOT` adında yeni bir girdi ekleyin:
+Aşağıdaki satırı değiştirerek dil kodunu değiştiriniz:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+Ayrıca statik dosyalar için bir yol eklememiz gerekmektedir. (Eğitici ders içerisinde statik dosyalar ve CSS hakkında ayrıntılı bilgi bulabilirsiniz.) Dosyanın *son*'una gidin, hemen altında sadece `STATIC_URL` girişi yapın, `STATIC_ROOT` adında yeni birim ekleyin:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 STATIC_URL = '/static/'
 STATIC_ROOT = os.path.join(BASE_DIR, 'static')
-```    
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. Bu, uygulamamızı dağıttıktan sonra, PythonAnywhere'deki anamakine adıyla eşleşmeyecek ve böylece aşağıdaki ayarları değiştireceğiz:
 
-## Veritabanı Kurulumu
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Not**: Eğer Chromebook kullanıyorsanız bu satırı settings.py dosyanızın en altına ekleyiniz: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Bir veritabanı kur
 
 Web uygulamalarınız için farklı birçok veritabanı yazılımı vardır. Biz varsayılanı kullanacağız, `sqlite3`.
 
 Sqlite varsayılan olduğu için zaten `mysite/settings.py` dosyamızda kurulu:
 
+{% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 DATABASES = {
     'default': {
@@ -86,59 +125,78 @@ DATABASES = {
         'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
     }
 }
-```    
+```
 
 Blogumuzun veritabanını oluşturmak için konsolda şu komutu çalıştırın:`python manage.py migrate` (`manage.py` dosyasını içeren `djangogirls` klasöründe olmalıyız). İşler iyi giderse şöyle bir şey görmelisiniz:
 
-```
-(myvenv) ~/djangogirls$ python manage.py migrate
-Operations to perform:
-Synchronize unmigrated apps: messages, staticfiles
-  Apply all migrations: contenttypes, sessions, admin, auth
-Synchronizing apps without migrations:
-   Creating tables...
-      Running deferred SQL...
-   Installing custom SQL...
-   Running migrations:
-   Rendering model states... DONE
-   Applying contenttypes.0001_initial... OK
-    Applying auth.0001_initial... OK
-    Applying admin.0001_initial... OK
-    Applying contenttypes.0002_remove_content_type_name... OK
-    Applying auth.0002_alter_permission_name_max_length... OK
-    Applying auth.0003_alter_user_email_max_length... OK
-    Applying auth.0004_alter_user_username_opts... OK
-    Applying auth.0005_alter_user_last_login_null... OK
-    Applying auth.0006_require_contenttypes_0002... OK
-    Applying sessions.0001_initial... OK
-```  
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
 
 Hepsi bu kadar! Web sunucusunu (web server) çalıştırma ve websitemizin çalıştığını görme zamanı!
 
+## Web sunucusunu başlatmak
+
 `manage.py` dosyasının bulunduğu dizinde olmalıyız (`djangogirls` klasörü). Konsol üzerinden `python manage.py runserver` komutunu çalıştırarak web sunucusunu başlatabilirsiniz:
 
-```  
-(myvenv) ~/djangogirls$ python manage.py runserver
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Eğer Chromebook üzerindeyseniz, bunun yerine şu komutu kullanın:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
 
 Eğer Windows'taysanız ve `UnicodeDecodeError` hatası varsa, bu komutu kullanın:
 
-```
-(myvenv) ~/djangogirls$ python manage.py runserver 0:8000
-```    
+{% filename %}komut-satırı{% endfilename %}
 
-Şimdi tek yapmanız gereken, sitenizin çalışıp çalışmadığını kontrol etmek. Tarayıcınızı (Firefox, Chrome, Safari, Internet Explorer ya da ne kullanıyorsanız) açın ve şu adresi girin:
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
 
-```
-http://127.0.0.1:8000/
-```    
+Şimdi tek yapmanız gereken sitenizin çalışıp çalışmadığına bakmak. Tarayıcınızı açın (Firefox, Chrome, Safari, Internet Explorer veya ne tercih ediyorsanız) ve bu adresi girin:
+
+{% filename %}tarayıcı{% endfilename %}
 
-Web sunucusu, siz durdurana kadar komut sistemini tutacaktır yani başka komut yazamayacaksınız. Sunucu çalışıyorken daha fazla komut girebilmek için yeni bir terminal penceresi açın ve virtualenv'inizi aktive edin. Web sunucusunu durdurmak için çalıştığı pencereye tekrar gelin ve CTRL+C ye -Control ve C butonlarına birlikte - basın (Windows için Ctrl+Break'e basmanız gerekiyor olabilir).
+    http://127.0.0.1:8000/
+    
+
+Eğer Chromebook kullanıyorsanız, her seferinde test sunucusunu ziyaret edeceksiniz ve erişeceksiniz:
+
+{% filename %}tarayıcı{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
 
 Tebrikler! ilk web siteni oluşturdun ve web sunucusu kullanarak çalıştırdın! Harika, değil mi?
 
-![İşte çalışıyor!][3]
+![İşte çalışıyor!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. Bunun nedeni web sunucusunun duraklamadan gelen talepleri algılamasıdır.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
 
- [3]: images/it_worked2.png
+Ağ sunucusu açıkken yeni komut yazmak için, yeni bir terminal penceresi açıp virtualenv aktive etmeniz gerekmektedir. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
 
-Sonraki adım için hazır mısın? İçerikleri oluşturma zamanı!
+Sonraki adım için hazır mısın? İçerikleri oluşturma zamanı!
\ No newline at end of file
diff --git a/tr/django_templates/README.md b/tr/django_templates/README.md
index b6d828687b8..9eeab8fc13d 100755
--- a/tr/django_templates/README.md
+++ b/tr/django_templates/README.md
@@ -1,12 +1,12 @@
-# Django template
+# Django templateleri
 
 Bazı verileri gösterme zamanı! Django bunun için bize faydalı bazı yerleşik **template etiketleri** sunuyor.
 
 ## Template etiketleri nedir?
 
-Görüyoruz ki aslında, HTML'de Python kodu yazamayız, çünkü tarayıcılar bunu anlamaz. Tarayıcılar yalnızca HTML'den anlar. Biliyoruz ki Python daha dinamik bir dil iken, HTML oldukça statiktir.
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
 
-**Django template etiketleri** Python benzeri yapıların HTML'ye aktarılmasını sağlar, böylece dinamik web sitelerini daha kolay ve hızlı oluşturabiliriz!
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
 ## Gönderi listesi template'ini göster
 
@@ -14,95 +14,93 @@ Bir önceki bölümde, template'e `posts` değişkeni içinde gönderiler listes
 
 Django şablonunda bir değişken yazdırmak için, değişken adını çift kıvrımlı parantez içinde şu şekilde kullanırız:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {{ posts }}
-```    
+```
 
 Bunu `blog/templates/blog/post_list.html` şablonunda deneyelim. İkinci `<div>`'den üçüncü `</div>`'e kadar olan her şeyi `{{ posts }}` ile değiştirelim. Ne olduğunu görmek için dosyayı kaydedip sayfayı yenileyelim:
 
-![Şekil 13.1][1]
-
- [1]: images/step1.png
+![Şekil 13.1](images/step1.png)
 
 Gördüğümüz sadece bu:
 
-```  
-<QuerySet [<Post: Gönderi 2>, <Post: Gönderi 1>]>
-```    
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
 
 Yani Django bunu bir nesneler listesi olarak algılıyor. **Python'a giriş**'ten listelerin nasıl gösterildiğini hatırlıyor musun? Evet, döngülerle! Bir Django template ile bunu şöyle yaparsın:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% for post in posts %}
     {{ post }}
 {% endfor %}
-```    
+```
 
 Bunu kendi template'imizle deneyelim.
 
-![Şekil 13.2][2]
-
- [2]: images/step2.png
+![Şekil 13.2](images/step2.png)
 
 İşe yarıyor! Fakat bunların daha önce **HTML'ye giriş** bölümünde oluşturduğumuz statik gönderiler gibi görünmesini istiyoruz. HTML ve template etiketlerini karıştırabiliriz. `body` şöyle görünecektir:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div>
-     <h1><a href="/">Django Girls Blog</a></h1>
+    <h1><a href="/">Django Girls Blog</a></h1>
 </div>
-   
+
 {% for post in posts %}
     <div>
-        <p>published: {{ post.yayinlanma_tarihi }}</p>
-        <h1><a href="">{{ post.baslik }}</a></h1>
-        <p>{{ post.yazi|linebreaks }}</p>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
     </div>
 {% endfor %}
-```   
+```
 
 {% raw %}`{% for %}` ve `{% endfor %}` arasına koyduğunuz her şey listedeki her nesne için tekrarlanır. Sayfanı yenile:{% endraw %}
 
-![Şekil 13.3][3]
+![Şekil 13.3](images/step3.png)
 
- [3]: images/step3.png
-
-`{{ post.baslik }}` ya da `{{ post.yazi }}` için biraz farklı bir yazım kullandığımızı farkettin mi? Böylece `Post` modelinde tanımlanan alanlardaki verilere ulaşıyoruz. Ayrıca `|linebreaks` (satırsonu), gönderilerin metnini, satır sonlarını paragraflara çeviren bir filtreden geçiriyor.
+Bu sefer biraz daha farklı bir notasyon kullandığımızın farkında mısınız (`{{ post.title }}` or `{{ post.text }})`? Böylece `Post` modelinde tanımlanan alanlardaki verilere ulaşıyoruz. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
 
 ## Bir şey daha
 
-Web sitemizin İnternet'te hâlâ çalıştığını görmek iyi olacak, değil mi? PythonAnywhere yükleyelim yine. Adımları hatırlayalım...
-
-*   İlk önce kodumuzu Github'a push komutu ile yükleyelim
+Websitenizi internette çalışır halde görmek iyi olur değilmi? PythonAnywhere tekrar çalıştıralım. Adımları hatırlayalım…
 
-```
-$ git status
-[...]
-$ git add -A .
-$ git status
-[...]
-$ git commit -m "Veritabanındaki postları görebilmek için template'i değiştirdim."
-[...]
-$ git push
-```    
+* İlk önce kodumuzu Github'a push komutu ile yükleyelim
 
-*   [PythonAnywhere][4]'e bağlanalım ve **Bash konsolu**'na gidelim (veya yeni bir konsol açalım) ve şunu çalıştıralım:
+{% filename %}komut-satırı{% endfilename %}
 
- [4]: https://www.pythonanywhere.com/consoles/
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Veritabanından gönderileri göstermek için template'ler değiştirildi."
+    [...]
+    $ git push
+    
 
-```
-$ cd ilk-blogum
-$ git pull
-[...]
-```    
+* [PythonAnywhere](https://www.pythonanywhere.com/consoles/)'e bağlanalım ve **Bash konsolu**'na gidelim (veya yeni bir konsol açalım) ve şunu çalıştıralım:
 
-*   Ve son olarak da [Web tab][5] sekmesine gidip web uygulamamızdaki **Reload**'a basalım. Şimdi güncellememiz yayında olmalı!
+{% filename %}PythonAnywhere komut-satırı{% endfilename %}
 
- [5]: https://www.pythonanywhere.com/web_app_setup/
+    $ cd ilk-blogum
+    $ git pull
+    [...]
+    
 
-Tebrikler! Şimdi devam edelim ve Django admininde yeni bir gönderi eklemeyi deneyelim (yayinlanma_tarihi eklemeyi unutmayalım!), sonrasında gönderinin görünüp görünmediğini görmek için sayfayı yenileyelim.
+* Ve son olarak da [Web tab](https://www.pythonanywhere.com/web_app_setup/) sekmesine gidip web uygulamamızdaki **Reload**'a basalım. Şimdi güncellememiz yayında olmalı! Eğer PythonAnywhere sitesindeki gönderilerin içeriği ile lokal sunucunuzda bulunan gönderilerin içeriği aynı değilse sorun değil. Lokal bilgisayarınızdaki veritabanı ile Python Anywhere'deki veritabanı, diğer dosyalarınız gibi eşitlenmiyor.
 
-Şiir gibi çalışıyor, değil mi? Gurur duyabiliriz! Şimdi bilgisayar başından bir süre kalkalım, çünkü bir molayı hak ettik. :)
+Tebrikler! Django admin üzerinden yeni bir gönderi ekleyin (yayinlama_tarihi eklemeyi unutmayın!) PythonAnywhere sitenizinin Django admin'inde olduğunuzdan emin olun, https://yourname.pythonanywhere.com/admin. Arkasından gönderileri görebilmek için ordaki sayfanızı yenileyin.
 
-![Şekil 13.4][6]
+Şiir gibi çalışıyor değil mi? Gurur duyuyoruz! Bi süre bilgisayarınızdan uzaklaşın - molayı hak ettiniz. :)
 
- [6]: images/donut.png
+![Şekil 13.4](images/donut.png)
\ No newline at end of file
diff --git a/tr/django_urls/README.md b/tr/django_urls/README.md
index 9549102c7cb..cf88511e565 100755
--- a/tr/django_urls/README.md
+++ b/tr/django_urls/README.md
@@ -1,46 +1,47 @@
-# Django url'leri
+# Django URL'leri
 
-İlk web sayfamızı yapmak üzereyiz: blogunuzun anasayfası! Ama önce, biraz Django url'lerini öğrenmeye başlayalım.
+İlk web sayfamızı kurmak üzereyiz: bloğun için bir ana sayfa! Ama öncelike, Django URL'leri hakkında biraz bilgi edinelim.
 
 ## URL nedir?
 
-URL basitçe bir web adresidir. Bir web sayfasını her ziyaret ettiğinizde tarayıcınızın adres barında bir URL görürsünüz (evet! `127.0.0.1:8000` bir URL'dir! Ve `https://djangogirls.com` da bir URL'dir):
+URL basitçe bir web adresidir. Her defasında bir web sitesini ziyaret ettiğinde bir URL görürsün. Tarayıcının adres çubuğunda görünmektedir. (Evet! `127.0.0.1:8000` bir URL'dir! Ve`https://djangogirls.org`'da bir URL'dir)
 
-![Url][1]
+![Url](images/url.png)
 
- [1]: images/url.png
-
-Internetteki her sayfanın kendi URL'inin olması gerekir. Böylelikle bir URL açıldığında uygulama ne göstermesi gerektiğini bilir. Django'da `URLconf` (URL konfigürasyonu) denilen bir şey kullanıyoruz. URLconf, Django'ya gelen URL için doğru view'un bulunmasını sağlar.
+Internetteki her sayfanın kendi URL'si olması gerekir. Bu yolla uygulama URl'yi açan kullanıcaya ne göstemesi gerektiğini bilir. Django'da `URLconf` (URL konfigürasyonu) denilen bir şey kullanıyoruz. URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
 
 ## URL'ler Django'da nasıl çalışır?
 
 Kod editörümüzde `mysite/urls.py` dosyasını açalım ve neye benzediğine bakalım:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
-    # Examples:
-    # url(r'^$', 'mysite.views.home', name='home'),
-    # url(r'^blog/', include('blog.urls')),
-
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
 ]
 ```
 
+Gördüğünüz gibi, Django çoktan bizim için buraya bir şey yerleştirmiş.
 
-Gördüğünüz gibi Django bizim için bir şeyler koymuş bile.
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. Python bunları çalıştırmaz.
 
-`#` ile başlayan satırlar yorum satırlarıdır - bu satırlar Python tarafından çalıştırılmayacak manasına gelir. Çok pratik, değil mi?
+Önce ki bölümde ziyaret ettğiniz yönetici URL'si şimdiden burada:
 
-Geçen bölümde gittiğimiz admin URL şimdiden burda:
+{% filename %}mysite/urls.py{% endfilename %}
 
 ```python
-    url(r'^admin/', include(admin.site.urls)),
-```  
+    url(r'^admin/', admin.site.urls),
+```
 
-`admin` ile başlayan her URL için Django ona denk gelen bir *view* bulur manasına gelir. Bu şekilde bir sürü admin URLlerini ekliyoruz böylece hepsi bu küçük dosyanın içinde sıkıştırılmış bir şekilde durmuyor -- bu hali daha okunabilir ve düzenli.
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
 
 ## Regex (Kurallı İfade)
 
@@ -48,82 +49,81 @@ Django'nun URL'leri view'larla nasıl eşleştirdiğini merak ediyor musunuz? Bu
 
 Gene de kalıpları nasıl oluşturduğumuzu anlamak isterseniz, aşağıdaki bir örnek var - aradığımız kalıbı oluşturmak için kuralların sadece bir kısmına ihtiyacımız olacak, şöyle:
 
-```
-^ metnin başlangıcı için
-$ metnin sonu için
-\d rakamlar için
-+ bir önceki karakterin en az bir kere bulunması gerektiğini belirtmek için
-() kalıbın belli bir kısmını yakalamak için
-```    
+* `^` metnin başlangıcı için
+* metnin sonu için `$`
+* `\d` for a digit
+* `+` belirlemek için bi önceki öğenin en az bir kez tekrarlanması lazım
+* `()` to capture part of the pattern
 
-Url tanımındaki diğer herşey birebir eşlenecek.
+Anything else in the URL definition will be taken literally.
 
-Şimdi `http://www.mysite.com/post/12345/` adresinde bir websitemiz olduğunu düşünelim. `12345` da gönderimizin numarası.
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
 
-Her gönderi için ayrı bir view yazmak gerçekten can sıkıcı olurdu. Düzenli ifadelerle (regexlerle) url ile eşlecek bir kalıp oluşturup gönderi numarasını çıkartabiliriz: `^post/(\d+)/$`. Parçalara bölüp ne yaptığımıza bakalım:
+Her gönderi için ayrı bir view yazmak gerçekten can sıkıcı olurdu. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Şimdi bunu, burada ne yaptığımızı görebilmek için parçalarına ayıralım:
 
-*   **^post/** Django'ya `post/` ile başlayan her şeyi almasını söylüyor ( `^`)
-*   **(\d+)** ise bir sayı (birden fazla rakam) olduğunu ve bu sayıyı yakalamak ve çıkarmak istediğimizi belirtiyor
-*   **/** ise Django'ya arkasından bir `/` karakteri gelmesi gerektiğini söylüyor
-*   **$** ise URL'nin sonuna işaret ediyor, yani sadece sonu `/` ile biten string'ler bu kalıpla eşleşecek
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** ise bir sayı (birden fazla rakam) olduğunu ve bu sayıyı yakalamak ve çıkarmak istediğimizi belirtiyor
+* **/** ise Django'ya arkasından bir `/` karakteri gelmesi gerektiğini söylüyor
+* **$** ise URL'nin sonuna işaret ediyor, yani sadece sonu `/` ile biten string'ler bu kalıpla eşleşecek
 
-## İlk Django url'niz!
+## İlk Django URL'niz!
 
-İlk URL'imizi oluşturma zamanı! 'http://127.0.0.1:8000/'ın blogumuzun ana sayfası olmasını istiyoruz ve bize bir gönderi listesi göstermesini istiyoruz.
+İlk URL'mizi oluşturma zamanı.'http://127.0.0.1:8000/' adresinin bloğumuzun anasayfası olmasını ve gönderilerin bir listesini görüntülemesini istiyoruz.
 
-Aynı zamanda `mysite/urls.py` dosyasını basit tutmak istiyoruz, bunun için ana `mysite/urls.py` dosyasına `blog` uygulamamızdan url'leri import edeceğiz (içeri alacağız).
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
 
-Yorum satırlarını silin (`#` ile başlayan satırları) ve ana url'ye `blog.urls` satırlarını import edecek (içeri alacak) bir satır ekleyin (`''`).
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
 
 `mysite/urls.py` dosyanız şöyle olmalıdır:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import include
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
     url(r'', include('blog.urls')),
 ]
 ```
 
-
 Django artık 'http://127.0.0.1:8000/'ye gelen her şeyi `blog.urls`'ya yönlendirecek ve ordaki yönergelere bakacak.
 
-Python'da düzenli ifadeler her zaman string'in başına `r` ekleyerek yapılır. Bu Python için string'in özel karakterler içerdiğini, doğrudan Python için değil düzenli ifadeler için bir string olduğu konusunda ipucu verir.
+Writing regular expressions in Python is always done with `r` in front of the string. Bu Python için string'in özel karakterler içerdiğini, doğrudan Python için değil düzenli ifadeler için bir string olduğu konusunda ipucu verir.
 
 ## blog.urls
 
-`blog/urls.py` adında yeni boş bir dosya oluşturun. Harika! Şu iki satırı ekleyin:
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
 from . import views
-```    
+```
 
-Burada sadece Django'nun methodlarını ve `blog` uygulamasındaki tüm `view`leri içeri aktarıyoruz (uygulamamız henüz yok, ama birazdan o kısma da geçeceğiz!)
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
 
 Bundan sonra ilk URL kalıbımızı ekleyebiliriz:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
 ]
 ```
 
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. Bu doğru çünkü Django URL çözücülerinde 'http://127.0.0.1:8000/' URL'nin parçası değildir. Bu kalıp, Django'ya eğer siteye biri 'http://127.0.0.1:8000/' adresinden gelirse gitmesi gereken yerin `views.post_list` olduğunu söylüyor.
 
-Gördüğünüz üzere, `^$` URL'sine `post_list` adında bir `view` atıyoruz. Bu düzenli ifade `^` (başlangıç) ve `$` (bitiş)'e uyan stringlerle eşleşir - yani sadece boş string'lerle eşleşir. Bu doğru çünkü Django URL çözücülerinde 'http://127.0.0.1:8000/' URL'nin parçası değildir. Bu kalıp, Django'ya eğer siteye biri 'http://127.0.0.1:8000/' adresinden gelirse gitmesi gereken yerin `views.post_list` olduğunu söylüyor.
-
-Son kısım olan `name='post_list'` view'u tanımlamak için kullanılan URL'nin adı. Bu view'un adı ile aynı olabilir ama tamamen farklı bir şey de olabilir. Named URL'leri (isimlendirilmiş URL'leri) projenin ilerleyen kısımlarında kullanacağız, o yüzden uygulamadaki her URL'yi isimlendirmemiz önemli. Aynı zamanda URL isimlerini tekil ve kolay hatırlanabilir yapmamız gerekir.
-
-Her şey tamam mı? Tarayıcınızda http://127.0.0.1:8000/'ye gidin ve sonuçları görün.
-
-![Hata][2]
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. Bu view'un adı ile aynı olabilir ama tamamen farklı bir şey de olabilir. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
 
- [2]: images/error1.png
+Eğer şimdi http://127.0.0.1:8000/'ine gitmeyi denerseniz, 'sayfanıza ulaşılamıyor' tarzında bir mesaj görürsünüz. Bunun nedeni sunucu (`runserver` yazdığınızı hatırlıyor musunuz?) artık çalışmıyor olacaktır. Sebebini bulmak için sunucunuzdaki komut penceresine bakın.
 
-Artık "It works" demiyor, di mi? Meraklanmayın, sadece bir hata sayfası, korkacak birşey yok! Aslında çok kullanışlılar:
+![Hata](images/error1.png)
 
-Sayfada gördüğünüz şey: **no attribute 'post_list'**. *post_list* size bir şey hatırlatıyor mu? Bu view'un ismi! Bu her şey yerli yerinde sadece henüz *view* yok manasına geliyor. Hiç merak etmeyin, oraya geleceğiz.
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. Bu Django'nun bulup kullanmaya çalıştığı *view*'un adı. Ama onu henüz oluşturmedık. At this stage your `/admin/` will also not work. Endişeye gerek yok - o noktaya ulaşacağız.
 
-> Django URLconfs ile ilgili daha fazla bilgi edinmek istiyorsanız resmi dokümantasyona bakabilirsiniz: https://docs.djangoproject.com/en/1.11/topics/http/urls/
+> Django URLconfs ile ilgili daha fazla bilgi edinmek istiyorsanız resmi dokümantasyona bakabilirsiniz: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/tr/django_views/README.md b/tr/django_views/README.md
index 7c98f077cf2..a5f7f339ef7 100755
--- a/tr/django_views/README.md
+++ b/tr/django_views/README.md
@@ -1,38 +1,44 @@
 # Django views - yaratma zamanı geldi!
 
-Evvelki bölümde yaptığımız hatayı yok edelim :)
+Bir önceki bölümde ortaya çıkan hatayı ortadan kaldırma vakti geldi! :)
 
-*view*, "uygulama mantığının" ifade edildiği yerdir. Daha önce oluşturulan `model` den bilgi alıp `template`'e iletir. Gelecek bölümde bir template oluşturacağız. View'ler bildiğiniz Python methodlarıdır. Ancak, **Python'a Giriş** bölümünde yazdığımız methodlardan biraz daha karmaşıktır.
+*view*, uygulamamızın "mantığının" ifade edildiği yerdir. Daha önce oluşturduğumuz `model` den bilgi alarak `template`'e iletir. "template"i ise gelecek bölümde oluşturacağız. View'ler bildiğiniz Python fonksiyonlarıdır. Ancak, **Python'a Giriş** bölümünde yazdığımız fonksiyonlardan biraz daha karmaşıktır.
 
-View'ler `views.py` doyasına yazılır. Şimdi, `blog/views.py` dosyasına *view* ekleyelim.
+View'ler `views.py` dosyasında yer alır. Şimdi, *view*'larımızı `blog/views.py` dosyasına ekleyelim.
 
 ## blog/views.py
 
-Dosyayı açıp inceleyelim:
+Tamam, şimdi bu dosyayı açalım ve içinde ne olduğuna bakalım:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
 
-# View'lar buraya yazılacak.
-```    
+# Create your views here.
+```
+
+Henüz fazla bir şey yok.
+
+`#` ile başlayan satırların yorumlar olduğunu unutmayın - bu # ile başlayan satırların Python tarafından çalıştırılmayacağı anlamına geliyor.
 
-Henüz fazla bir şey görünmüyor. En basitinden *view* şöyle olabilir.
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
-def post_list(request):     
+def post_list(request):
     return render(request, 'blog/post_list.html', {})
-```    
-
-Burada, `request (istek)` i alıp template `blog/post_list.html` ile görüntüleyen `render` methodunu `döndüren` `post_list` isimli bir method yarattık.
+```
 
-Dosyamızı kaydedelim ve http://127.0.0.1:8000/ e gidip bakalım.
+Burada `post_list` isimli bir fonksiyon (`def`) yarattık, bu fonksiyon girdi olarak `request` (isteği) alıp, `blog/post_list.html` template'ini işleyecek olan `render` fonksiyonunu `döndürüyor`.
 
-Yine hata! Okuyup anlamaya çalışalım:
+Dosyamızı kaydedelim ve http://127.0.0.1:8000/ adresine gidip bakalım.
 
-![Hata][1]
+Bir başka hata! Okuyup neler olduğunu anlamaya çalışalım:
 
- [1]: images/error.png
+![Hata](images/error.png)
 
-Bu hatayı düzeltmek kolay: *TemplateDoesNotExist* (Template bulunamadı). Bu hatayı template oluşturarak gelecek bölümde düzeltelim!
+İyi tarafından bakarsak bu hata en azından sunucumuzun yeniden çalıştığını gösteriyor, ama hala bir şeyler yanlış, değil mi? Dert etmeyin, sadece bir hata sayfası, korkacak bir şey yok! Komut satırındaki hata mesajları gibi bunlar da aslında oldukça yararlılar. *TemplateDoesNotExist* hatası alıyoruz, yani Template bulunamadı. Gelecek bölümde bu hatayı template oluşturarak düzeltelim!
 
-> Django view hakkında daha fazla bilgi edinmek için dokümantasyonları okuyun: https://docs.djangoproject.com/en/1.11/topics/http/views/
+> Django view'ları hakkında daha fazla bilgi edinmek için resmi dokümantasyonları okuyabilirsiniz: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/tr/dynamic_data_in_templates/README.md b/tr/dynamic_data_in_templates/README.md
index 548b3acdb9a..472ace04cff 100755
--- a/tr/dynamic_data_in_templates/README.md
+++ b/tr/dynamic_data_in_templates/README.md
@@ -1,44 +1,50 @@
-# Template içerisinde dinamik veri
+# Template içinde dinamik veri
 
-Birkaç parçayı yerine oturttuk: `Post` (gönderi) modelini `models.py`'de tanımladık, `views.py`'de `post_list` (gönderi listesi) var ve template ekledik. Ama gönderilerimizi HTML'de görünür kıldık mı? Çünkü bu yapmak istediğimiz şey: içeriği (veritabanında kayıtlı modellerimiz) al ve güzelcene template içerisinde göster, değil mi?
+Birkaç parçayı yerine oturttuk: `Post` (gönderi) modelini `models.py`'de tanımladık, `views.py`'de `post_list` (gönderi listesi) var ve template ekledik. Ama gönderilerimizi HTML'de görünür kıldık mı? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
 
-Bu tam olarak *view*'lerin yapmasını beklediğimiz şey: modelleri ve template'leri bağlamak. `post_list` *view*'de göstermek istediğimiz modelleri alıp template'e iletmemiz gerekecek. Yani temelde bir *view*de template içinde neyin (hangi modelin) gösterileceğine karar veriyoruz.
+Bu tam olarak *view*'lerin yapmasını beklediğimiz şey: modelleri ve template'leri bağlamak. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. *view* ile şablon içinde neyin (hangi modelin) gösterileceğine karar veriyoruz.
 
-Peki, bunu nasıl yapacağız?
+Tamam, peki nasıl yapacağız?
 
 `blog/views.py`'ı açacağız. Şu anda `post_list` *view*ü şöyle:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
 def post_list(request):
     return render(request, 'blog/post_list.html', {})
-```    
+```
+
+Kodları farklı dosyalara eklemekten bahsettiğimizi hatırlıyor musunuz? Şu an `models.py` içinde yazdığımız modeli kullanma zamanı. We will add the line `from .models import Post` like this:
 
-Kodları farklı dosyalara eklemekten bahsettiğimizi hatırlıyor musunuz? Şimdi `models.py`'de yazdığımız modeli ekleme zamanı. `from .models import Post` satırını şu şekilde ekleyeceğiz:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
 from .models import Post
-```    
+```
 
-`from`'dan sonraki nokta, *mevcut dizin* veya *mevcut uygulama* anlamına geliyor. `views.py` ve `models.py` aynı dizinde oldukları için sadece `.` ve dosyanın adı (`.py` olmadan) kullanabiliyoruz. Arkasından modelin adını (`Post`)'u dahil ediyoruz).
+`models`'dan önceki nokta, *mevcut dizin* veya *mevcut uygulama* anlamına geliyor. Hem `views.py` hem de `models.py` aynı dizindedir. Bu şu anlama geliyor: `.` ve dosya ismini (`.py` olmadan) kullanabiliriz. Arkasından modelin adını (`Post`)'u dahil ediyoruz (import ediyoruz).
 
-Sırada ne var? `Post` modelinden gönderileri almamız için `QuerySet` dediğimiz bir şeye ihtiyacımız var.
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
 
 ## QuerySet (Sorgu Seti)
 
-QuerySet'in nasıl çalıştığı konusunda bir fikriniz oluşmuştur. [Django ORM (QuerySets) bölümü][1]nde konuşmuştuk.
+QuerySets çalışma şeklinde bir fikir sahibi olmuşsunuzdur. [Django ORM (QuerySets) chapter](../django_orm/README.md) içinde bu konudan bahsetmiştik.
 
- [1]: ../django_orm/README.md
+Şimdi yayınlanmış ve `published_date`'e (yayınlanma tarihine) göre sıralanmış bir gönderi listesi istiyoruz, değil mi? Bunu QuerySets bölümünde yapmıştık zaten!
 
-Şimdi yayınlanmış ve `yayinlanma_tarihi`'ne göre sıralanmış bir gönderi listesi istiyoruz, değil mi? Bunu QuerySets bölümünde yapmıştık zaten!
+{% filename %}blog/views.py{% endfilename %}
 
+```python
+Post.objects.filter(yayinlanma_tarihi__lte=timezone.now()).order_by('yayinlanma_tarihi')
 ```
-    Post.objects.filter(yayinlanma_tarihi__lte=timezone.now()).order_by('yayinlanma_tarihi')
-```    
 
-Şimdi bu kodu `blog/views.py` dosyasında `def post_list(request)` fonksiyonuna ekleyelim:
+Şimdi `blog/views.py` dosyası içindeki bu kodu `def post_list(request)` fonksiyonu ekleyin ama öncelikle `from django.utils import timezone` eklemeyi unutmayın:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
@@ -46,30 +52,30 @@ from django.utils import timezone
 from .models import Post
 
 def post_list(request):
-    posts = Post.objects.filter(yayinlanma_tarihi__lte=timezone.now()).order_by('yayinlanma_tarihi')
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
     return render(request, 'blog/post_list.html', {})
-```    
-
-QuerySet'imiz için bir *değişken* yarattığımıza dikkat edin: `posts`. Bu QuerySet'in ismi. Bundan sonra ondan ismi ile bahsedebiliriz.
+```
 
-Bu kod `timezone.now()` fonksiyonunu kullanıyor, dolayısıyla `timezone` için bir 'import' eklememiz gerekiyor.
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
 
-Son eksik kalan kısım `posts` QuerySet'ini template'e iletmek (nasıl göstereceğimizi bir sonraki bölümde işleyeceğiz).
+QuerySet'imiz için bir *değişken* yarattığımıza dikkat edin: `posts`. Bu QuerySet'in ismi. Bundan sonra ondan ismi ile bahsedebiliriz.
 
-`render` fonksiyonunda halihazırda `request` diye bir parametremiz var (dolayısıyla Internet üzerinden kullanıcı ile ilgili aldığımız her şey) ve bir de template dosyamız `'blog/post_list.html'` var. `{}` şeklindeki son parametremiz, template içinde kullanılmak üzere bir şeyler ekleyebileceğimiz bir değişken. Bunlara isimler vermemiz gerekiyor (`'posts'` ismini kullanmaya devam edeceğiz şimdilik :)). Şöyle olması lazım: `{'posts': posts}`. `:`'dan önceki kısmın bir string olduğuna dikkat edin; etrafına tek tırnak koymanız gerekiyor `''`.
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. Bunlara isimler vermemiz gerekiyor (`'posts'` ismini kullanmaya devam edeceğiz şimdilik). :) Şöyle olması lazım: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
 
 Nihayetinde `blog/views.py` şu şekle gelmiş olmalı:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from django.utils import timezone
 from .models import Post
 
 def post_list(request):
-    posts = Post.objects.filter(yayinlanma_tarihi__lte=timezone.now()).order_by('yayinlanma_tarihi')
-     return render(request, 'blog/post_list.html', {'posts': posts})
-```    
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
 
 İşte bu kadar! Template'e geri gidip QuerySet'leri görünür hale getirme zamanı!
 
-Django'da QuerySet'lerle ilgili daha fazla bilgi istiyorsanız şuraya bakabilirsiniz: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/tr/extend_your_application/README.md b/tr/extend_your_application/README.md
index 1af1415c4d1..513ac2fd9b2 100644
--- a/tr/extend_your_application/README.md
+++ b/tr/extend_your_application/README.md
@@ -10,7 +10,7 @@ Halihazırda bir `Post` modelimiz var, dolayısıyla `models.py` dosyasına bir
 
 ## Bir gönderinin detayı için bir şablon linki oluşturun
 
-`blog/templates/blog/post_list.html` dosyasına bir link (bağlantı) ekleyerek başlayacağız. Şu ana kadar yaptıklarımızın şöyle gözüküyor olması lazım:
+`blog/templates/blog/post_list.html` dosyasının içine bir bağlantı ekleyerek başlayacağız.Şimdiye kadar bunun gibi görünmesi gerek: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -19,31 +19,32 @@ Halihazırda bir `Post` modelimiz var, dolayısıyla `models.py` dosyasına bir
     {% for post in posts %}
         <div class="post">
             <div class="date">
-                {{ post.yayinlanma_tarihi }}
+                {{ post.published_date }}
             </div>
-            <h1><a href="">{{ post.baslik }}</a></h1>
-            <p>{{ post.yazi|linebreaks }}</p>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
         </div>
     {% endfor %}
 {% endblock %}
-```    
-    
+```
+
+{% raw %}Gönderi listesindeki bir gönderinin başlığından bir gönderinin detay sayfasına bir link (bağlantı) olsun istiyoruz. `<h1><a href="">{{ post.baslik }}</a></h1>`'i gönderinin detay sayfasına link verecek şekilde değiştirelim:{% endraw %}
 
-{% raw %}Gönderi listesindeki bir gönderinin başlığından bir gönderinin detay sayfasına bir link (bağlantı) olsun istiyoruz. `<h1><a href="">{{ post.baslik }}</a></h1>`'i gönderinin detay sayfasına link verecek şekilde değiştirelimi:{% endraw %}
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.baslik }}</a></h1>
-```    
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
 
 {% raw %}Gizemli `{% url 'post_detail' pk=post.pk %}` satırını anlatma zamanı. Şüphelendiğiniz üzere, `{% %}` notasyonu, Django template tags (şablon etiketleri) kullandığımız manasına geliyor. Bu sefer bizim için URL oluşturacak bir template etiketi kullanacağız!{% endraw %}
 
-`blog.views.post_detail`, oluşturmak istediğimiz `post_detail` *view*'una bir yol. Lütfen dikkat: `blog` uygulamamızın adı (`blog` dizini); `views`, `views.py` dosyasının adından geliyor ve son kısım - `post_detail` - *view*'ün adından geliyor.
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
 
-Şimdi http://127.0.0.1:8000/'ye gittiğimizde bir hata alacağız (beklediğimiz bir şey, çünkü URL'miz veya `post_detail` için bir *view*'ümüz yok). Şöyle görünecektir:
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. Ana anahtara `post.pk` yazarak erişiriz, diğer alanlar içinde aynısı geçerlidir (`title`, `author`, vb.) `Post` objesi!
 
-![NoReverseMatch error (Tersi yok hatası)][1]
+Şimdi http://127.0.0.1:8000/ adresine gittiğimizde bir hata ile karşılaşacağızURL yada `içerik detayları`için bir*görüntü*'müz olmadığı için hatayı almamız normal)hata böyle görünecektir:
 
- [1]: images/no_reverse_match2.png
+![NoReverseMatch error (Tersi yok hatası)](images/no_reverse_match2.png)
 
 ## Bir gönderinin detayı için URL oluşturun
 
@@ -51,110 +52,121 @@ Halihazırda bir `Post` modelimiz var, dolayısıyla `models.py` dosyasına bir
 
 İlk gönderimizin detayının şu **URL**'de gösterilmesini istiyoruz: http://127.0.0.1:8000/post/1/
 
-`blog/urls.py` dosyasında `post_detail` adında bir Django *view*'una işaret eden bir URL yapalım. Bu <1>view</1> bir gönderinin tümünü gösterecek. `blog/urls.py` dosyasına `url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),` satırını ekleyin. Dosyanın şu hale gelmiş olması gerekiyor:
+`blog/urls.py` dosyasında `post_detail` adında bir Django *view*'una işaret eden bir URL yapalım. Bu <1>view</1> bir gönderinin tümünü gösterecek. `blog/urls.py` dosyasına şu satırı ekleyin `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),`. Dosyanın şu hale gelmiş olması gerekiyor:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import url
 from . import views
-    
+
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
 ]
-```    
-
-Şu kısım `^post/(?P<pk>[0-9]+)/$` korkutucu gözüküyor, ama endişelenmeyin, açıklayacağız: 
-- Gene `^` ile başlıyor - "başlangıç'. 
-- `post/` sadece URL'nin başlangıçtan sonra __post__ ve __/.__ ifadelerinin geçmesi gerektiği anlamına geliyor. Şimdilik iyi gidiyor. 
-- `(?P<pk>[0-9]+)` - bu kısım biraz daha karışık. Buranın anlamı şu: Django bu alana yerleştirdiğimiz her şeyi alacak ve onu `pk` adında bir değişken olarak view'e aktaracak. `[0-9]` bize eşleşenlerin sadece rakam (yani harf olamaz) olabileceğini söylüyor (0 ile 9 arasındaki her şey). `+` en az bir veya daha fazla rakam olması gerektiğini ifade ediyor. Yani `http://127.0.0.1:8000/post//` eşleşmez ama `http://127.0.0.1:8000/post/1234567890/` eşleşir! 
-- `/` - gene bir __/__'e ihtiyacımız var 
-- `$` - "son"!
- 
-Bu şu demek, eğer tarayıcınıza `http://127.0.0.1:8000/post/5/` yazarsanız, Django `post_detail` adında bir *view* aradığınızı anlar ve `pk` eşittir `5` bilgisini *view*'e aktarır.
+```
 
-`pk`, `primary key`'in (tekil anahtarın) kısaltılmış hali. Bu isim sıklıkla Django projelerinde kullanılır. Değişkeninize istediğiniz ismi verebilirsiniz (hatırlayın: küçük harfler ve boşluk yerine `_`!). Örneğin `(?P<pk>[0-9]+)` yerine `post_id` değişkenini kullanabilirdik. O zaman şöyle olurdu: `(?P<post_id>[0-9]+)`.
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
 
-Tamam, `blog/urls.py` dosyasına yeni bir URL kalıbı ekledik! Sayfayı tazeleyelim: http://127.0.0.1:8000/ Bam! Yeni bir hata daha! Beklenildiği üzere!
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. Buranın anlamı şu: Django bu alana yerleştirdiğimiz her şeyi alacak ve onu `pk` adında bir değişken olarak view'e aktaracak. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` en az bir veya daha fazla rakam olması gerektiğini ifade ediyor. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
 
-![AttributeError (Özellik hatası)][2]
+Bu şu demek, eğer tarayıcınıza `http://127.0.0.1:8000/post/5/` yazarsanız, Django `post_detail` adında bir *view* aradığınızı anlar ve `pk` eşittir `5` bilgisini *view*'e aktarır.
+
+Tamamdır.`blog/urls.py`!'e yeni bir URL kalıbı ekledik! Http://127.0.0.1:8000/ sayfasını yenileyelim.Boom! Sunucu çalıştırmayı tekrar durdurdu. Konsola göz at, beklendiği gibi bir hata daha var!
+
+![AttributeError (Özellik hatası)](images/attribute_error2.png)
 
-Bir sonraki adımın ne olduğunu hatırlıyor musunuz? Tabi ki: view'ü eklemek!
+Bir sonraki adımın ne olduğunu hatırlıyor musunuz? Tabi ki: görünüm'ü eklemek!
 
 ## Gönderi detayı için bir view ekleyin
 
-Bu sefer *view*'ümüze `pk` adında bir parametre ekleyeceğiz. *view*'ümüzün onu yakalaması gerekiyor, değil mi? Fonksiyonumuzu `def post_detail(request, pk):` olarak tanımlayacağız. Dikkat edin, url'lerde kullandığımız ismin birebir aynısını kullanmamız gerekiyor (`pk`). Bu değişkeni kullanmamak yanlıştır ve hataya sebep olacaktır!
+This time our *view* is given an extra parameter, `pk`. *view*'ümüzün onu yakalaması gerekiyor, değil mi? Fonksiyonumuzu `def post_detail(request, pk):` olarak tanımlayacağız. Dikkat edin, url'lerde kullandığımız ismin birebir aynısını kullanmamız gerekiyor (`pk`). Bu değişkeni kullanmamak yanlıştır ve hataya sebep olacaktır!
 
-Şimdi sadece ve sadece bir blog gönderisini almak istiyoruz. Bunu yapmak için querysets'i şu şekilde kullanabiliriz:
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
 
-```
+{% filename %}blog/views.py{% endfilename %}
+
+```python
 Post.objects.get(pk=pk)
-``` 
+```
 
-Ama bu kodun bir problemi var. Eğer gelen `primary key` (`pk` - tekil anahtar) ile bir `Post` (gönderi) yoksa, çok çirkin bir hatamız olacak!
+Ama bu kodda bir hata var. Eğer `birincil anahtar<code>verilmiş herhangi bir <code>gönderi`(<0>pk</code>) yoksa, Çok çirkin bir hata elde etmiş olacağız!
 
-![DoesNotExist error (Yok hatası)][3]
+![DoesNotExist error (Yok hatası)](images/does_not_exist2.png)
 
-Bunu istemiyoruz! Ama tabi Django'da bunu ele alan bir şey var: `get_object_or404`. Eğer verilen `pk` ile bir `Post` bulunamazsa, çok daha güzel bir sayfa gösterilecek (`Sayfa bulunamadı 404` sayfası).
+Bunu istemeyiz! Ama tabi Django'da bunu ele alan bir şey var: `get_object_or404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
 
-![Page not found (Sayfa bulunamadı)][4]
+![Page not found (Sayfa bulunamadı)](images/404_2.png)
 
 İyi haber şu, kendi `Sayfa bulunamadı` sayfasını yapabilir ve istediğiniz kadar güzelleştirebilirsiniz. Ama şu anda çok önemli değil, o yüzden bu kısmı atlayacağız.
 
-Evet, `views.py` dosyamıza bir *view* ekleme zamanı!
+OK, time to add a *view* to our `views.py` file!
 
-`blog/views.py` dosyasını açıp aşağıdaki kodu ekleyelim:
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
 
-```
-from django.shortcuts import render, get_object_or_404
-``` 
+We should open `blog/views.py` and add the following code near the other `from` lines:
 
-Bunu diğer `from` satırlarının yakınına eklememiz gerekiyor. Dosyanın sonuna *view*'ümüzü ekleyeceğiz:
+{% filename %}blog/views.py{% endfilename %}
 
+```python
+from django.shortcuts import render, get_object_or_404
 ```
+
+Ve dosyanın sonuna kendi *görünüm*'ümüzü ekliyeceğiz:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
 def post_detail(request, pk):
     post = get_object_or_404(Post, pk=pk)
     return render(request, 'blog/post_detail.html', {'post': post})
-```    
+```
 
 Evet. http://127.0.0.1:8000/ sayfasını tazeleme zamanı
 
-![Post list view (Gönderi listesi görünümü)][5]
+![Post list view (Gönderi listesi görünümü)](images/post_list2.png)
 
 Çalıştı! Fakat blog gönderisi başlığındaki bir bağlantıya tıkladığınızda ne oluyor?
 
-![TemplateDoesNotExist error (Template yok hatası)][6]
+![TemplateDoesNotExist error (Template yok hatası)](images/template_does_not_exist2.png)
 
 Of hayır! Başka bir hata! Ama onu nasıl halledeceğimizi biliyoruz, di mi? Bir template eklememiz gerekiyor!
 
-## Gönderi detayı için bir template oluşturun
+## Gönderi detayları için bir şablon oluştur
 
 `blog/templates/blog` dizininde `post_detail.html` adında bir dosya oluşturacağız.
 
 Şöyle görünmeli:
 
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
-    
+
 {% block content %}
     <div class="post">
-        {% if post.yayinlanma_tarihi %}
+        {% if post.published_date %}
             <div class="date">
-                {{ post.yayinlanma_tarihi }}
+                {{ post.published_date }}
             </div>
         {% endif %}
-        <h1>{{ post.baslik }}</h1>
-        <p>{{ post.yazi|linebreaks }}</p>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
     </div>
 {% endblock %}
-```    
+```
 
 Bir kere daha `base.html` dosyasını genişleteceğiz. `content` bloğunda bir gönderinin varsa yayınlama tarihini , başlığını ve metnini göstermek istiyoruz. Ama daha önemli şeyleri konuşmalıyız, değil mi?
 
-{% raw %}`{% if ... %} ... {% endif %}` bir şeyi kontrol etmek istediğimizde kullanabileceğimiz bir template etiketidir ( **Python'a giriş** bölümünden <1>if ... else ..</code> 'i hatırladınız mı?). Bu senaryoda gönderinin `yayinlanma_tarihi`'nin boş olup olmadığına bakmak istiyoruz.{% endraw %}
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
 
-Tamam, sayfamızı tazeleyip `Sayfa bulunamadı` hatasının gidip gitmediğine bakabiliriz.
+Tamam, şimdi sayfamızı yenileyerek `Şablonyok` kaybolmuşmu görebiliriz.
 
-![Post detail page (Gönderi detay sayfası)][7]
+![Post detail page (Gönderi detay sayfası)](images/post_detail2.png)
 
 Heyo! Çalışıyor!
 
@@ -162,34 +174,24 @@ Heyo! Çalışıyor!
 
 Sitenizin hala PythonAnywhere'de çalışıp çalışmadığına bakmakta fayda var, değil mi? Yeniden taşımayı deneyelim.
 
-```
-$ git status
-$ git add -A .
-$ git status
-$ git commit -m "Detaylı blog gönderileri için CSS'e ilaveten view ve template eklendi."
-$ git push
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
 
-*   Sonra bir [PythonAnywhere Bash konsol][8] una gidip:
+Sonra bir [PythonAnywhere Bash konsol](https://www.pythonanywhere.com/consoles/) una gidip:
 
-```
-$ cd ilk-blogum
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```
+{% filename %}komut-satırı{% endfilename %}
 
-*   Nihayet, [Web tab][9] ına gidip **Reload** edelim.
+    $ cd ilk-blogum
+    $ git pull
+    [...]
+    
 
-O kadar! Tebrikler :)
+Nihayet, [Web tab](https://www.pythonanywhere.com/web_app_setup/) ına gidip **Reload** edelim.
 
- [2]: images/attribute_error2.png
- [3]: images/does_not_exist2.png
- [4]: images/404_2.png
- [5]: images/post_list2.png
- [6]: images/template_does_not_exist2.png
- [7]: images/post_detail2.png
- [8]: https://www.pythonanywhere.com/consoles/
- [9]: https://www.pythonanywhere.com/web_app_setup/
+O kadar! Tebrikler :)
\ No newline at end of file
diff --git a/tr/how_the_internet_works/README.md b/tr/how_the_internet_works/README.md
index 86e97e28e04..62914807b52 100644
--- a/tr/how_the_internet_works/README.md
+++ b/tr/how_the_internet_works/README.md
@@ -1,53 +1,47 @@
-# İnternet nasıl çalışır
+# İnternet Nasıl Çalışır
 
-> Bu bölüm Jessica McKellar'ın "How the Internet works" yani "İnternet nasıl çalışır" adlı bir konuşmasından esinlenerek oluşturuldu. (http://web.mit.edu/jesstess/www/).
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
 
-Bahse varız ki İnternet'i her gün kullanıyorsunuz. Fakat tarayıcınıza http://djangogirls.org gibi bir adres girip `enter` tuşuna bastığınızda neler olduğunu biliyor musunuz?
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
 
 Öncelikle bir web sitesinin bir sabit diske kaydedilmiş bir grup dosya olduğunu anlamanız gerekir. Tıpkı filmleriniz, müzikleriniz ya da resimleriniz gibi. Ancak, web sitelerine özel şöyle bir durum var: HTML adı verilen bir bilgisayar kodu içerirler. 
 
 Eğer programlamaya aşina değilseniz HTML'yi kavramak başlangıçta zor olabilir, ama web tarayıcılarınız (Chrome, Safari, Firefox, vs.) ona bayılıyor. Web tarayıcılarınız bu kodu anlamak, komutlarını yerine getirmek ve size bu websitesini oluşturan dosyaları sunmak için tasarlanmıştır, tam da olmasını istediğiniz gibi.
 
-Her dosya gibi, bu HTML dosyalarını da sabit diskte bir yerde saklamamız gerekir. Internet için, *sunucu* denilen özel ve güçlü bilgisayarlar kullanıyoruz. Bir ekranları, fareleri ya da klavyeleri yok çünkü esas amaçları veriyi saklamak ve sunmak. Bu yüzden onlara *sunucu* diyoruz -- çünkü size veri *sunuyorlar*.
+Her dosya gibi, bu HTML dosyalarını da sabit diskte bir yerde saklamamız gerekir. Internet için, *sunucu* denilen özel ve güçlü bilgisayarlar kullanıyoruz. Bir ekranları, fareleri ya da klavyeleri yok çünkü esas amaçları veriyi saklamak ve sunmak. That's why they're called *servers* – because they *serve* you data.
 
-Peki, fakat İnternet'in nasıl göründüğünü bilmek istiyorsunuz. Değil mi?
+Tamam ama yinede Internetin nasıl gözüktğünü görmek istersiniz değil mi?
 
 Size bir resmini çizdik, İnternet işte buna benzer:
 
-![Şekil 1.1][1]
+![Şekil 1.1](images/internet_1.png)
 
- [1]: images/internet_1.png
+Çok karışık, değil mi? Aslında birbirine bağlanmış bir makina ağıdır (yukarıda bahsedilen *servers*). Yüz binlerce makine! Dünyanın dört bir yanını saran yüz binlerce kilometrelik kablolar! İnternet'in ne kadar karışık olduğunu görmek için denizaltı kablo haritası web sitesine(http://submarinecablemap.com) göz atabilirsiniz. İşte web sitesinden bir ekran görüntüsü:
 
-Çok karışık, değil mi? Aslında bu birbirine bağlı makinelerin(yukarıda bahsi geçen *sunucu*lar) birbirine bağlandığı bir ağ. Yüz binlerce makine! Dünyanın dört bir yanını saran yüz binlerce kilometrelik kablolar! İnternet'in ne kadar karışık olduğunu görmek için denizaltı kablo haritası web sitesine(http://submarinecablemap.com) göz atabilirsiniz. İşte web sitesinden bir ekran görüntüsü:
+![Şekil 1.2](images/internet_3.png)
 
-![Şekil 1.2][2]
-
- [2]: images/internet_3.png
-
-Büyüleyici, değil mi? Ama açıkça belli ki, İnternet'e bağlanan tüm makineler arasında kablolar olması mümkün değil. Yani, bir makineye ulaşmak için( örneğin http://djangogirls.org web sitesinin kayıtlı olduğu) bir çok farklı makineden istek geçmesi gerekli.
+Büyüleyici, değil mi? Ama açıkça belli ki, İnternet'e bağlanan tüm makineler arasında kablolar olması mümkün değil. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
 
 Şöyle gözükmekte:
 
-![Şekil 1.3][3]
+![Şekil 1.3](images/internet_2.png)
 
- [3]: images/internet_2.png
-
-Tarayıcınıza http://djangogirls.org yazdığınızda, "Sevgili Django Girls, ben djangogirls.org web sitesini görmek istiyorum. Lütfen bana gönderin!" diyen bir mektup gönderdiğinizi düşünün.
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
 
 Mektubunuz size en yakın postaneye gider. Daha sonra sizden biraz daha uzak bir postaneye gider, daha sonra biraz daha uzaktakine, daha uzağa ve en son gitmesi gereken yere. Tek farklı olan, aynı yere bir çok mektup(*veri paketi*) gönderirseniz, tamamen farklı postanelerden(*yönlendirici*) geçebilir. Bu, her bir postanede nasıl dağıtım yapıldığına bağlıdır.
 
-![Şekil 1.4][4]
-
- [4]: images/internet_4.png
+![Şekil 1.4](images/internet_4.png)
 
-Evet, bu kadar basit. Bir mektup yollarsınız ve cevap beklersin. Tabii ki, kağıt kalem yerine bayt biriminde veri kullanırsınız, fakat fikir aynı!
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
 
-Sokak adı, şehir, alan kodu ve ülke adı yerine, biz IP adreslerini kullanırız. Bilgisayarınız ilk olarak DNS'den (Domain Name System - Alan Adı Sistemi) djangogirls.org adresini bir IP adresine çevirmesini ister. Bu biraz ulaşmak istediğiniz kişinin adına bakarak telefon numarası ve adresini bulabildiğiniz eski telefon rehberleri gibi çalışır.
+Sokak adı, şehir, alan kodu ve ülke adı yerine, biz IP adreslerini kullanırız. Bilgisayarınız ilk olarak DNS'den (Domain Name System - Alan Adı Sistemi) djangogirls.org adresini bir IP adresine çevirmesini ister. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
 
-Bir mektup gönderdiğinizde, bazı özelliklerin doğru teslim edilmesi gerekecektir: bir adres, pul vs. Ayrıca alıcının anlayacağı bir dil kullanıyorsunuz, değil mi? Aynısı bir web sitesini görmek için gönderdiğiniz *veri paketleri* için de geçerli. HTTP(Hypertext Transfer Protocol - HiperMetin transfer protokolü) adı verilen bir protokol kullanırız.
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Ayrıca alıcının anlayacağı bir dil kullanıyorsunuz, değil mi? Aynısı bir web sitesini görmek için gönderdiğiniz *veri paketleri* için de geçerli. HTTP(Hypertext Transfer Protocol - HiperMetin transfer protokolü) adı verilen bir protokol kullanırız.
 
 Basit olarak, bir web siteniz olduğunuzda, içinde yaşayacağı bir *sunucu* makineniz olması gerekli. *Sunucu* (bir mektupla gelen) bir *istek* aldığında, (başka bir mektupla) size web sitenizi gönderir.
 
-Bu bir Django eğitimi olduğu için, Django'nun ne yaptığını soracaksınız. Bir yanıt gönderirken, herkese her zaman aynı şeyi göndermek istemezsiniz. Mektupları özellikle size yazan kişi için kişiselleştirmek çok daha iyi, değil mi? Django bu kişiselleştirilmiş, ilginç mektupları yazmanıza yardımcı olur :).
+Since this is a Django tutorial, you might ask what Django does. Bir yanıt gönderirken, herkese her zaman aynı şeyi göndermek istemezsiniz. Mektupları özellikle size yazan kişi için kişiselleştirmek çok daha iyi, değil mi? Django bu kişiselleştirilmiş, ilginç mektupları yazmanıza yardımcı olur. :)
 
-Bu kadar konuşma yeter, bir şeyler yaratma vakti!
+Yeterince konuştuk - Yaratma zamanı!
\ No newline at end of file
diff --git a/tr/html/README.md b/tr/html/README.md
index 6ee55824559..91bacad60ac 100755
--- a/tr/html/README.md
+++ b/tr/html/README.md
@@ -2,13 +2,13 @@
 
 Template nedir diye sorabilirsiniz.
 
-Template, farklı bilgileri hep aynı biçimde sunmak için tekrar tekrar kullanabileceğimiz bir dosyadır - örneğin, mektup yazmanıza yardımcı olan bir template kullanabilirsiniz çünkü yazacağınız tüm mektuplar farklı mesajlar içerse ve farklı kişilere gönderilse de aynı sayfa düzenine sahip olacaktır.
+Şablon farklı bilgileri tutarlı bir formatta vermek için tekrar kullanabildiğimiz bir dosyadır - örnek olarak, bir harf yazmanıza yardım etmesi için bir şablon kullanabilirsiniz, çünkü her harfin başka bir mesaj içerebilmesi ve başka bir kişiye gönderilebilmesine rağmen aynı formatı paylaşacaklar.
 
-Bir Django template düzeni HTML adını verdiğimiz bir dilde tanımlanır (**İnternet nasıl çalışır** adlı ilk bölümde bahsettiğimiz HTML).
+Django şablonunun formatı HTML diye adlandırılan bir dilde tanımlıdır(ilk bölümde bahsettiğimiz HTML, **İnternet nasıl çalışır**).
 
 ## HTML nedir?
 
-HTML Chrome, Firefox veya Safari gibi web tarayıcılar tarafından bir web sayfasını kullanıcıya görüntülemek için yorumlanan basit bir koddur.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
 HTML "HyperText Markup Language" (HiperMetin İşaretleme Dili) anlamına gelir. **HyperText (HiperMetin)** sayfalar arası bağlantıları destekleyen türden bir metin demektir. **Markup (İşaretleme)**, bir belgeyi alıp onu kodlarla işaretleyerek, nasıl yorumlanacağını (tarayıcıya) söyledik demektir. HTML kodu **etiketler** ile oluşturulur, etiketlerin her biri `<` ile başlar ve `>` ile biter. Bu etiketler biçimlendirme **öğelerini** temsil eder.
 
@@ -18,76 +18,72 @@ Bir template oluşturmak bir template dosyası oluşturmak demektir. Her şey bi
 
 Template'lar `blog/templates/blog` dizininde saklanır. Öyleyse blog klasörü altında `templates` adlı bir klasör oluşturalım. Sonra da templates klasörü altında yine `blog` adlı bir klasör oluşturalım:
 
-```
-blog
-└───templates
-    └───blog
-```    
+    blog
+    └───templates
+        └───blog
+    
 
-(Neden iki tane `blog` adlı klasöre gerek olduğunu merak etmiş olabilirsin. Daha sonra da anlaşılacağı gibi, sitemiz karmaşıklaştıkça bu şekilde isimlendirme tarzı işimizi oldukça kolaylaştırır.)
+(`blog` diye adlandırılan iki dizine niye ihtiyacımız olduğunu merak edebilirsiniz - daha sonra anlayacağınız üzere, basitçe durum karmaşıklaşmaya başladığında hayatınızı kolaylaştıracak bir adlandırma uzlaşımıdır.)
 
 Şimdi de `blog/templates/blog` dizini içine `post_list.html` adlı bir dosya oluşturalım (şimdilik içini boş bırakalım).
 
 Web sitemizin nasıl göründüğüne bir bakalım: http://127.0.0.1:8000/
 
-> Eğer `TemplateDoesNotExists` hatası alırsanız sunucuyu yeniden başlatmayı deneyin. Komut satırına gidip, Ctrl+C (Control ve C tuşlarına eş zamanlı basarak) yaptıktan sonra sunucuyu tekrar başlatmak için `python manage.py runserver` komutunu çalıştırın.
-
-![Şekil 11.1][1]
+> Eğer hala `TemplateDoesNotExist` hatası alıyorsanız, sunucunuzu yeniden başlatmayı deneyin. Komut satırına girin, Ctrl+C (Kontrol ve C tuşlarına beraber) basarak sunucuyu durdurun ve bir `python manage.py runserver` komutunu çalıştırarak yeniden başlatın.
 
- [1]: images/step1.png
+![Şekil 11.1](images/step1.png)
 
 Artık hata kalmadı! Tebrikler :) Ama, web sitemiz aslında boş bir sayfadan başka bir şey yayınlamıyor, çünkü template boş. Bunu düzeltelim.
 
 Template dosyamıza şunları ekleyelim:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
-    <p>Merhaba!</p>
-    <p>Çalışıyor!</p>
+    <p>Hi there!</p>
+    <p>It works!</p>
 </html>
-```    
-
-Web siteniz şimdi nasıl görünüyor? Öğrenmek için tıklayın: http://127.0.0.1:8000 /
+```
 
-![Şekil 11.2][2]
+Web siteniz şu anda nasıl görünüyor?Öğrenmek için ziyaret edin: http://127.0.0.1:8000/
 
- [2]: images/step3.png
+![Şekil 11.2](images/step3.png)
 
 Çalıştı! Tebrikler :)
 
-*   Tüm web sayfaları en temel etiket olan`<html>` etiketi ile başlar ve her zaman `</html>` ile biter. Gördüğünüz gibi, web sitesinin tüm içeriği `<html>` başlangıç etiketi ve `</html>` bitiş etiketinin arasında yer alır
-*   `<p>` paragraf öğelerini belirten etikettir; her paragrafın bitişinde de `</p>` olacaktır
+* En temel etiket, `<html>`, daima herhangi bir web sayfasının başlangıcıdır ve `</html>` daima bitişidir. Gördüğünüz gibi, web sitesinin tüm içeriği `<html>` başlangıç etiketi ve `</html>` bitiş etiketinin arasında yer alır
+* `<p>` paragraf öğelerini belirten etikettir; her paragrafın bitişinde de `</p>` olacaktır
 
-## Head ve body (Başlık ve gövde)
+## Kafa ve vücut
 
 Aynı zamanda tüm HTML sayfaları **head** ve **body** olmak üzere iki öğeye ayrılır.
 
-*   **head** belge hakkında ekranda görüntülenmeyen bilgiler içeren öğedir.
+* **head** belge hakkında ekranda görüntülenmeyen bilgiler içeren öğedir.
 
-*   **body** ise ekranda gösterilen tüm öğeleri içeren öğedir.
+* **body** ise ekranda gösterilen tüm öğeleri içeren öğedir.
 
 `<head>` öğesini tarayıcıya sayfanın yapılandırmasını anlatmak için, `<body>` öğesini ise sayfada aslında ne olduğunu anlatmak için kullanırız.
 
-Örneğin, web sayfasının (title) başlık elemanını `<head>` 'in içine böyle koyabilirsiniz:
+Örnek olarak, bir web sayfası başlık ögesini `<head>` içine koyabilirsiniz, bunun gibi:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
     <head>
-        <title>Zeynep'in blogu</title>
+        <title>Ola's blog</title>
     </head>
     <body>
-        <p>Merhaba!</p>
-        <p>Çalışıyor!</p>
+        <p>Hi there!</p>
+        <p>It works!</p>
     </body>
 </html>
 ```
-    
 
 Dosyayı kaydedin ve sayfanızı yenileyin.
 
-![Şekil 11.3][3]
-
- [3]: images/step4.png
+![Şekil 11.3](images/step4.png)
 
 Tarayıcınızın "Zeynep'in blogu" başlığını nasıl anladığını fark ettiniz mi? `<title>Zeynep'in blogu</title>` kısmını başlık olarak yorumlayarak yazıyı tarayıcının başlık kısmına yerleştirdi. (Bu yazı yer işaretleri gibi yerlerde de kullanılır).
 
@@ -95,23 +91,26 @@ Her açılan etiketin benzer bir *kapatan etiket*, `/` ile başlayan, ile kapat
 
 Bir şeyleri kutulara yerleştirmek gibi. Büyük bir kutuda `<html></html>` olsun; onun içinde `<body></body>` kutusu olsun, onun da içinde daha küçük kutular olsun: `<p></p>`.
 
-Etiketleri düzgün *kapatma* ve *iç içe * yerleştirme kurallarına uymak çok önemli. Aksi takdirde tarayıcı belgenizi doğru yorumlayamaz ve gösteremez.
+Bu *kapatma* etiketleri ve *yuvalama* ögeleri kurallarını takip etmeye ihtiyacınız vardır - eğer yapmazsanız tarayıcı onları gerektiği gibi açıklayamayabilir ve sayfanız hatalı olarak görüntülenecektir.
 
 ## Template özelleştirme
 
 Şimdi artık biraz eğlenip template'inizi özelleştirmeyi deneyebilirsiniz! İşte bunun için faydalı birkaç etiket:
 
-*   `<h1>Bir başlık</h1>` - ana başlığınız için
-*   `<h2>Bir alt başlık</h2>` - bir sonraki seviyedeki bir başlık için
-*   `<h3>Bir alt alt başlık</h3>` ... ve böyle `<h6>` ya kadar iner
-*   `<em>metin</em>` metni vurgular
-*   `<strong>metin</strong>` metni iyice vurgular
-*   `<br />` - alt satıra gider (br etiketi içine bir şey konulmaz)
-*   `<a href = "http://djangogirls.org">bağlantı</a>` bir bağlantı oluşturur
-*   `<ul><li>ilk madde</li><li>ikinci madde</li></ul>` - tıpkı bunun gibi bir liste yapar!
-*   `<div></div>` - sayfanın bir bölümünü tanımlar
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>Bir alt başlık</h2>` - bir sonraki seviyedeki bir başlık için
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>metin</em>` metni vurgular
+* `<strong>metin</strong>` metni iyice vurgular
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>ilk madde</li><li>ikinci madde</li></ul>` - tıpkı bunun gibi bir liste yapar!
+* `<div></div>` - sayfanın bir bölümünü tanımlar
 
-Şimdi de tam bir template örneği:
+İşte komple bir şablon örneği,kopyalayın ve `blog/templates/blog/post_list.html` içine yapıştırın:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -120,15 +119,15 @@ Etiketleri düzgün *kapatma* ve *iç içe * yerleştirme kurallarına uymak ço
     </head>
     <body>
         <div>
-            <h1><a href="">Django Girls Blog</a></h1>
+            <h1><a href="/">Django Girls Blog</a></h1>
         </div>
-    
+
         <div>
             <p>published: 14.06.2014, 12:14</p>
-            <h2><a href="">İlk Blogum</a></h2>
-            <p>Çok heyecanlıyım! Bu benim ilk blogum. Ne kadar zevkli bir işmiş bilgisayarlarla uğraşmak. Artık bilgisayar başından kalkmam. </p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Ne kadar zevkli bir işmiş bilgisayarlarla uğraşmak. Artık bilgisayar başından kalkmam. </p>
         </div>
-  
+
         <div>
             <p>published: 14.06.2014, 12:20</p>
             <h2><a href="">İkinci gönderim</a></h2>
@@ -136,22 +135,20 @@ Etiketleri düzgün *kapatma* ve *iç içe * yerleştirme kurallarına uymak ço
         </div>
     </body>
 </html>
-```    
+```
 
 Burada üç tane `div` bölümü oluşturduk.
 
-*   İlk `div` öğesi blogumuzun başlığını içeriyor - bir başlık ve bir bağlantıdan oluşuyor
-*   Sonraki iki `div` öğesi blog gönderilerimizi içeriyor; bunlarda bir yayın tarihi, tıklanabilir bir `h2` başlığı ve biri tarih diğeri gönderi metnimiz için olmak üzere, iki tane `p` (paragraf) var.
+* İlk `div` ögesi blogumuzun başlığını içerir - bu bir baş kısımdır ve bir bağlantıdır
+* Sonraki iki `div` öğesi blog gönderilerimizi içeriyor; bunlarda bir yayın tarihi, tıklanabilir bir `h2` başlığı ve biri tarih diğeri gönderi metnimiz için olmak üzere, iki tane `p` (paragraf) var.
 
 Bize yaşattığı duygu:
 
-![Şekil 11.4][4]
-
- [4]: images/step6.png
+![Şekil 11.4](images/step6.png)
 
-Yaşasın! Şimdiye dek, template tam olarak sadece **aynı bilgiyi ** görüntüledi - öncesinde ise template'in **farklı** bilgileri **aynı formatta** görüntülememize izin verdiğinden bahsetmiştik.
+Yaşasın! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
 
-Gerçekten yapmak istediğimiz ise Django adminde ekli gerçek gönderileri göstermek - ve bir sonraki adımımız da bu.
+Aslında yapmak istediğimiz Django yöneticimize eklenen gerçek postaları açmak - bundan sonra oraya gidiyoruz.
 
 ## Birşey daha: dağıtım!
 
@@ -161,57 +158,56 @@ Bunları İnternet'te canlı olarak görmek çok güzel olur, değil mi:
 
 İlk önce son deployment dan sonra hangi dosyaların değiştiğine bakalım. Bu komutları lokal bilgisayarımızda çalıştıralım, PythonAnywhere'de değil:
 
-```
-$ git status
-```
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git status
+    
 
 `djangogirls` dizininde olduğumuzdan emin olalım ve `git` 'e bu dizinde yapılan tüm değişiklikleri dahil etmesini söyleyelim:
 
-```
-$ git add -A .
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git add --all .
+    
 
-> **Not:** `-A` (hepsi için bir kısaltma - İngilizce'de "all" hepsi demek) `git`'in silinmiş dosyaları tanır (normalde sadece yeni/güncellenmiş dosyaları tanır). Hatırlatma: `.` içinde olduğumuz klasör anlamına gelir (3. Bölüm).
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Hatırlatma: `.` içinde olduğumuz klasör anlamına gelir (3. Bölüm).
 
 Dosyalarımızı yüklemeden önce `git`'in hangilerini yükleyeceğine (`git`'in yükleyeceği dosyalar yeşil gösterilir) bakalım:
 
-```
-$ git status
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git status
+    
 
 Neredeyse bitirdik, şimdi bu değişikliği tarihçesine kaydetmesini söyleyelim. Commit için değişiklikleri açıklayan bir mesaj yazalım. Bu aşamada istediğimizi yazabiliriz, fakat tanımlayıcı yazılar gelecekte neler yapmış olduğumuzu hatırlatması açısından faydalı olacaktır.
 
-```
-$ git commit -m "Site için HTML dosyasını değiştirdim."
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git commit -m "Site için HTML dosyasını değiştirdim."
+    
 
 > **Not** Tamamlama mesajını çift tırnak içerisinde kullandığımızdan emin olalım.
 
-Bunu tamamladıktan sonra, değişiklikleri Github'a push komutunu kullanarak yükleyelim:
+Bunu bir kez yapıp, değişikliklerimizi GitHub'a yükledik (ittik):
 
-```
- $ git push
-```  
+{% filename %}komut-satırı{% endfilename %}
+
+    $ git push
+    
 
 ### Pull ile yeni kodu PythonAnywhere e alıp web uygulamasını tekrar yükleyelim
 
-*   [PythonAnywhere consoles page][5]sayfasını ve **Bash console** u açalım (ya da yeni bir tane açalım). Sonra da çalıştıralım:
+* [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/)sayfasını ve **Bash console** u açalım (ya da yeni bir tane açalım). Sonra da çalıştıralım:
 
- [5]: https://www.pythonanywhere.com/consoles/
+{% filename %}komut-satırı{% endfilename %}
 
-```
-$ cd ~/ilk-blogum
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```    
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
 
 Kodumuzun indirilmesini izleyelim. Kodun geldiğini kontrol etmek istersek **Files (dosyalar) sekme**sini açıp PythonAnywhere'de kodumuzu görebiliriz.
 
-*   Son olarak, [Web sekmesi][6]ne gidip uygulamanızın **Yenile** butonuna basın.
-
- [6]: https://www.pythonanywhere.com/web_app_setup/
+* Son olarak, [Web sekmesi](https://www.pythonanywhere.com/web_app_setup/)ne gidip uygulamanızın **Yenile** butonuna basın.
 
-Güncelleme hazır olmalı! Devam edelim ve tarayıcıda web sitesini yenileyelim. Değişiklikler görünüyor olmalı :)
+Güncelleme hazır olmalı! Devam edelim ve tarayıcıda web sitesini yenileyelim. Değişiklikler görünüyor olmalı. :)
\ No newline at end of file
diff --git a/tr/install_git.md b/tr/install_git.md
new file mode 100644
index 00000000000..c40bd1986d1
--- /dev/null
+++ b/tr/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/tr/installation/README.md b/tr/installation/README.md
index ad2b0e63288..02943101253 100755
--- a/tr/installation/README.md
+++ b/tr/installation/README.md
@@ -1,10 +1,10 @@
 # Eğer tutorial'ı evde yapıyorsanız
 
-Eğer tutorial'ı [Django Girls etkinlikleri](http://djangogirls.org/events/)nin birinde değil de evde yapıyorsanız, bu bölümü atlayabilirsiniz ve doğrudan [İnternet nasıl çalışır](../how_the_internet_works/README.md) bölümüne gidebilirsiniz.
+Eğer tutorial'ı [Django Girls etkinliklerinden](https://djangogirls.org/events/) birinde değil de evde yapıyorsanız, bu bölümü şimdi tamamen atlayabilirsiniz ve direkt [İnternet nasıl çalışıyor](../how_the_internet_works/README.md) bölümüne geçebilirsiniz.
 
-Çünkü burada anlatılanları tutorial boyunca zaten işliyoruz, bu kısım kurulum talimatlarının tek yerde toparlandığı ek bir sayfa sadece. Django Girls etkinlikleri, tutorial sırasında uğraşmamak için herşeyi kurduğumuz bir "kurulum akşamı"nı içeriyor. Bu sayfayı onun için kullanıyoruz.
+Çünkü burada anlatılanları tutorial boyunca zaten işliyoruz, bu kısım kurulum talimatlarının tek yerde toparlandığı ek bir sayfa sadece. Django Girls etkinliği, çalıştay boyunca tekrar kurulumla uğraşmamak adına her şeyi yüklediğimiz bir "Kurulum akşamı" içeriyor.
 
-Eğer yararlı olduğunu düşünüyorsanız, bu bölümü okuyabilirsiniz. Ama bilgisayarınıza bir şeyler kurmadan önce bir kaç şey öğrenmeye başlamak istiyorsanız, bu bölümü atlayın. Size kurulum işlerini sonra anlatacağız.
+If you find it useful, you can follow this chapter too. Ama eğer bilgisayarınıza birkaç şey yüklemeden önce bir şeyler öğrenmeye başlamak istiyorsanız, bu bölümü atlayın. Daha sonra kurulum kısmını size açıklayacağız. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
 
 İyi şanslar!
 
@@ -12,6 +12,11 @@ Eğer yararlı olduğunu düşünüyorsanız, bu bölümü okuyabilirsiniz. Ama
 
 Atölyede bir blog geliştireceksiniz, eğitim günü kodlamaya hazır olmanız için önceden ayarlamakta fayda olan birkaç kurulum var.
 
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
 # Python Yükleyin
 
 {% include "/python_installation/instructions.md" %}
@@ -30,7 +35,7 @@ Atölyede bir blog geliştireceksiniz, eğitim günü kodlamaya hazır olmanız
 
 # GitHub hesabı oluşturun
 
-[GitHub.com](http://www.github.com)'a gidin ve ücretsiz yeni bir kullanıcı hesabı oluşturun.
+[GitHub.com](https://www.github.com)'a gidin ve ücretsiz yeni bir kullanıcı hesabı oluşturun.
 
 # PythonAnywhere hesabı oluşturun
 
@@ -38,12 +43,16 @@ Atölyede bir blog geliştireceksiniz, eğitim günü kodlamaya hazır olmanız
 
 # Okumaya başlayın
 
-Tebrikler, ayarlarınız tamam ve hazırsınız! Eğer atölyeden önce hala vaktiniz var ise, başlangıç bölümlerinden bazılarını okumanız yararlı olacaktır:
+Tebrikler, kurulumunuz tamamen bitti ve başlamaya hazırsınız! Eğer çalıştaydan önce hala biraz vaktiniz varsa, başlangıç bölümlerinden birkaç tanesini okumaya başlamanız faydalı olacaktır:
+
+* [İnternet nasıl çalışır](../how_the_internet_works/README.md)
+
+* [Komut satırına giriş](../intro_to_command_line/README.md)
 
-  * [İnternet nasıl çalışır](../how_the_internet_works/README.md)
+* [Python'a giriş](../python_introduction/README.md)
 
-  * [Komut satırına giriş](../intro_to_command_line/README.md)
+* [Django nedir?](../django/README.md)
 
-  * [Python'a giriş](../python_introduction/README.md)
+# Çalışmanın tadına varın!
 
-  * [Django nedir?](../django/README.md)
+İşe başladığınızda direk [Your first Django project!](../django_start_project/README.md) gidebilirsiniz çünkü çoktan önceki bölümlerde bu konuları çözdük.
\ No newline at end of file
diff --git a/tr/instructions.md b/tr/instructions.md
new file mode 100644
index 00000000000..d042926b29a
--- /dev/null
+++ b/tr/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for you instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/tr/intro_to_command_line/README.md b/tr/intro_to_command_line/README.md
index 6b13c10398e..3feb4820528 100644
--- a/tr/intro_to_command_line/README.md
+++ b/tr/intro_to_command_line/README.md
@@ -1,76 +1,109 @@
 # Komut satırı arayüzüne giriş
 
-Ha, heyecan verici, değil mi?! İlk kodunuzu birkaç dakika içinde yazacaksınız :)
+> Evden okuyanlar için: Bu bölüm [ içinde anlatıldı. Yeni arkadaşınız: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+Heyecanlı değil mi?! Birkaç dakika içinde ilk kod satırını yazacaksın! :)
 
 **Sizi yeni arkadaşınızla tanıştıralım: komut satırı!**
 
 Gelecek aşamalar size tüm "hacker"ların kullandığı siyah pencerenin nasıl kullanıldığını gösterecek. Başta biraz korkutucu görünebilir fakat bu sadece sizden komut bekleyen bir pencere.
 
-> **Not** Lütfen bu kitap boyunca 'dizin' veya 'klasör' terimlerini birbirinin yerine kullandığımızı ve aynı anlama geldiklerini unutmayınız.
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
 
 ## Komut satırı nedir?
 
-Genellikle **komut satırı** veya **komut satırı arabirimi** adı verilen pencere, bilgisayarınızdaki dosyaları görmek, düzenlemek ve yönetmek için kullanılan metin tabanlı bir uygulamadır. Tıpkı Windows Gezgini veya Mac'deki Finder gibi, fakat grafik arayüzü olmadan. Komut satırının diğer adları: *cmd*, *CLI*, *komut istemcisi*, *konsol* veya *terminal (uçbirim)*dir.
+Genellikle **komut satırı** veya **komut satırı arabirimi** adı verilen pencere, bilgisayarınızdaki dosyaları görmek, düzenlemek ve yönetmek için kullanılan metin tabanlı bir uygulamadır. Bu tıpkı windows gezgini yada mac'teki finder gibi fakat grafiksel arayüzü olmadan. Komut satırının diğer adları: *cmd*, *CLI*, *komut istemcisi*, *konsol* veya *terminal (uçbirim)*dir.
 
 ## Komut satırı arabirimini açın
 
 Birkaç deneme yapmak için önce komut satırı arabirimini açmamız gerekir.
 
-### Windows
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Başlat'a gidin → windows sistemi → Komut istemcisi.
+
+> Daha eski bir windows sistemi için, Başlat menüsü →Tüm programlar → aksesuarlar → Komut istemcisi.
 
-Başlat menüsü → Tüm Programlar → Donatılar → Komut Satırı.
+<!--endsec-->
 
-### Mac OS X
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
 
-Uygulamalar → Araçlar → Terminal.
+Uygulamalar → Araçlar →Terminal.
 
-### GNU/Linux
+<!--endsec-->
 
-Muhtemelen Uygulamalar → Donatılar → Terminal altında olmalı, fakat sistemler arası farklılık gösterebilir. Eğer orada değilse İnternet'te arayın :)
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Muhtemelen Uygulamalar → Donatılar → Terminal altında olmalı, fakat sistemler arası farklılık gösterebilir. Eğer orada değilse İnternet'te arayın. :)
+
+<!--endsec-->
 
 ## İstemci
 
 Şu anda yüksek ihtimalle sizden komut bekleyen siyah ya da beyaz bir ekran görüyor olmalısınız.
 
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
 Eğer Mac veya GNU/Linux kullanıyorsanız, yüksek ihtimalle `$` işareti göreceksiniz, tıpkı bunun gibi:
 
-```
-$
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
 
 Windows'da ise `>` işareti göreceksiniz, bunun gibi:
 
-```
->
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
 
-Tüm komutlar bu işaret ve bir boşluktan sonra gelir fakat bunu yazmak zorunda değilsiniz. Bilgisayarınız bunu sizin için yapacaktır :)
+Tüm komutlar bu işaret ve bir boşluktan sonra gelir fakat bunu yazmak zorunda değilsiniz. Bilgisayarınız bunu sizin için yapacaktır. :)
 
-> Ufak bir not: sizin durumunuzda bu `C:\Users\ola>` veya `Olas-MacBook-Air:~ ola$` ve benzeri bir şekilde olabilir ve bu kesinlikle doğru. Bu eğitimde bunu sade ve basit bir şekilde anlatacağız.
+> Küçük bir not: sizin durumunuzda `C:\Users\ola>` veya `Olas-MacBook-Air:~ ola$` benzeri bir durumda olabilir ve kesinlikle tamamdır.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+Bu kılavuzda bir komut girmeniz istendiğinde, biz `$` veya `>` ekleyeceğiz, genellikle sola doğru. Sol tarafı göz ardı edeiblirsiniz ve işlemi başlatan komutu gireiblirsiniz.
 
 ## İlk komutunuz (Yaşasın!)
 
-Basit bir şeyle başlayalım. Aşağıdaki komutu yazın:
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ whoami
+    
 
-```
-$ whoami
-```    
+<!--endsec-->
 
-ya da
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
 
-```
-> whoami
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
 
 Ve ardından `enter` tuşuna basın. Sonucumuz bu:
 
-```
-$ whoami zeynep
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ whoami zeynep
+    
 
-Gördüğünüz gibi, bilgisayar az önce kullanıcı adınızı yazdı. Harika, değil mi? :)
+Gördüğünüz gibi bilgisayar kullanıcı adınızı yazdı. Şahane, değil mi ? :)
 
-> Her komutu yazmaya çalışın, kopyala-yapıştır yapmayın. Bu şekilde daha akılda kalıcı olur!
+> Her komutu yazmaya çalışın; kopyala - yapıştır yapmayın. Böylece daha akılda kalıcı olur!
 
 ## Temeller
 
@@ -80,47 +113,65 @@ Tüm işletim sistemleri komut satırı için birbirinden biraz farklı komutlar
 
 Nerede olduğumuzu bilmek güzel olurdu, değil mi? Bakalım. Bu komutu yazın ve `enter` tuşuna basın:
 
-```
-$ pwd
-/Users/zeynep
-```    
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
 
-Windows'ta iseniz:
+{% filename %}komut-satırı{% endfilename %}
 
-```
-> cd
-C:\Users\zeynep
-```    
-
-Muhtemelen makinenizde benzeri bir yazı göreceksiniz. Komut satırını açtığınızda genellikle kullanıcınızın ev dizininde başlarsınız.
+    $ pwd
+    /Users/zeynep
+    
 
 > Not: 'pwd'nin anlamı "print working directory" yani "çalışma dizinini yazdır"dır.
 
----
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+    > cd
+    C:\Users\zeynep
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+Muhtemelen makinenizde benzeri bir yazı göreceksiniz. Komut satırını açtığınızda genellikle kullanıcınızın ev dizininde başlarsınız.
+
+* * *
 
 ### Dosya ve dizinleri listele
 
 Yani içeride ne var? Bilmek harika olurdu. Haydi bakalım:
 
-```
-$ ls
-Uygulamalar
-Masaüstü
-İndirilenler
-Müzik
-...
-```    
-
-Windows:
-
-```
-> dir  Directory of C:\Users\zeynep 
-05/08/2014 07:28 PM <DIR> Uygulamalar 
-05/08/2014 07:28 PM <DIR> Masaüstü 
-05/08/2014 07:28 PM <DIR> İndirilenler 
-05/08/2014 07:28 PM <DIR> Müzik 
-...
-```    
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ ls
+    Uygulamalar
+    Masaüstü
+    İndirilenler
+    Müzik
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+    > dir  Directory of C:\Users\zeynep 
+    05/08/2014 07:28 PM <DIR> Uygulamalar 
+    05/08/2014 07:28 PM <DIR> Masaüstü 
+    05/08/2014 07:28 PM <DIR> İndirilenler 
+    05/08/2014 07:28 PM <DIR> Müzik 
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
 
 * * *
 
@@ -128,32 +179,49 @@ Windows:
 
 Şimdi, haydi Masaüstü dizinimize gidelim:
 
-```
-$ cd Masaüstü
-```    
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ cd Masaüstü
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
 
-Windows:
+    > cd Masaüstü
+    
 
-```
-> cd Masaüstü
-```
+<!--endsec-->
 
 Gerçekten değişmiş mi bir bakalım:
 
-```
-$ pwd
-C:\Users\zeynep\Masaüstü
-```    
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
 
-Windows:
-```
-> cd 
-C:\Users\zeynep\Masaüstü
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ pwd
+    C:\Users\zeynep\Masaüstü
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+    > cd 
+    C:\Users\zeynep\Masaüstü
+    
+
+<!--endsec-->
 
 İşte oldu!
 
-> Profesyonel ipucu: eğer `cd D` yazarsanız ve `tab` tuşuna basarsanız, komut satırı ismin kalanını otomatik tamamlar ve gitmek istediğiniz yere daha hızlı gidersiniz. Eğer "D" ile başlayan birden çok klasör var ise, seçeneklerin listesi için `tab` tuşuna iki kez basın.
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
 
 * * *
 
@@ -161,17 +229,25 @@ C:\Users\zeynep\Masaüstü
 
 Uygulamalı yapmak için masaüstünüzde bir dizin oluşturmaya ne dersiniz? Bu şekilde yapabilirsiniz:
 
-```
-$ mkdir uygulama
-```    
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ mkdir uygulama
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}komut-satırı{% endfilename %}
 
-Windows:
+    > mkdir uygulama
+    
 
-```
-> mkdir uygulama
-```    
+<!--endsec-->
 
-Bu küçük komut masaüstünüzde `uygulama` isimli bir klasör oluşturacaktır. Orada olup olmadığını kontrol etmek için `ls` veya `dir` komutlarını kullanabilirsiniz! Deneyin :)
+Bu küçük komut masaüstünüzde `uygulama` isimli bir klasör oluşturacaktır. Orada olup olmadığını kontrol etmek için `ls` veya `dir` komutlarını kullanabilirsiniz! Deneyin. :)
 
 > Profesyonel ipucu: Eğer aynı komutları tekrar tekrar yazmak istemiyorsanız, `yukarı ok` ve `aşağı ok` tuşlarına basarak yazdığınız komutlar arasında geçiş yapabilirsiniz.
 
@@ -179,25 +255,33 @@ Bu küçük komut masaüstünüzde `uygulama` isimli bir klasör oluşturacaktı
 
 ### Alıştırma!
 
-Sizin için ufak bir alıştırma: yeni oluşturduğunuz `uygulama` dizininde `test` adında bir dizin oluşturun.`cd` ve `mkdir` komutlarını kullanın.
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
 
 #### Çözüm:
 
-```
-$ cd uygulama
-$ mkdir test
-$ ls
-test
-```    
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
 
-Windows:
+{% filename %}komut-satırı{% endfilename %}
 
-```
-> cd uygulama
-> mkdir test
-> dir
-05/08/2014 07:28 PM <DIR>      test
-```
+    $ cd uygulama
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd uygulama
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
 
 Tebrikler! :)
 
@@ -209,95 +293,135 @@ Ortalığı dağınık bırakmak istemeyiz, haydi yaptığımız her şeyi silel
 
 İlk önce masaüstüne geri dönmemiz gerek:
 
-```
-$ cd ..
-``` 
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    > cd ..
+    
 
-```
-> cd ..
-```    
+<!--endsec-->
 
-`cd` komutu ile `..` kullanmak sizi bir üst dizine götürür (Bu sizin şuanki dizininizi tutan ana dizindir).
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
 
 Nerede olduğunuzu kontrol edin:
 
-```    
-$ pwd
-C:\Users\zeynep\Masaüstü
-```    
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
 
-Windows:
+{% filename %}command-line{% endfilename %}
 
-```
-> cd 
-C:\Users\zeynep\Masaüstü
-```    
+    $ pwd
+    C:\Users\zeynep\Masaüstü
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd 
+    C:\Users\zeynep\Masaüstü
+    
+
+<!--endsec-->
 
 Şimdi `uygulama` dizinini silme vakti:
 
-> **Dikkat**: Dosyaları `del`,`rmdir` veya `rm` ile silme işlemi geri alınamaz, bu *silinen dosyalar sonsuza dek yok olur* anlamına gelir! Yani, bu komutları kullanırken çok dikkatli olun.
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
 
-```
-$ rm -r uygulama
-```    
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ rm -r uygulama
+    
 
-```
-> rmdir /S uygulama
-uygulama, Emin misiniz <E/H>? E
-```    
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S uygulama
+    uygulama, Emin misiniz <E/H>? E
+    
+
+<!--endsec-->
 
 Bitti! Gerçekten silindiğinden emin olalım:
 
-```
-$ ls
-``` 
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ ls
+    
 
-```
-> dir
-```    
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
 
 ### Çıkış
 
-Şimdilik bu kadar! Şimdi komut satırını güvenle kapatabilirsiniz. Bunu "hacker" tarzında yapalım, tamam mı?:)
+Şimdilik bu kadar! Şimdi komut satırını güvenle kapatabilirsiniz. Bunu "hacker" tarzında yapalım, tamam mı? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
 
-```
-$ exit
-```    
+{% filename %}command-line{% endfilename %}
 
-Windows:
+    $ exit
+    
 
-```
-> exit
-```    
+<!--endsec-->
 
-Harika, değil mi?:)
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Harika, değil mi? :)
 
 ## Özet
 
 İşte bazı yararlı komutların özeti:
 
-| Komut (Windows) | Komut (Mac OS - GNU/Linux) | Açıklama                | Örnek                                             |
-| --------------- | -------------------------- | ----------------------- | ------------------------------------------------- |
-| exit            | exit                       | pencereyi kapatır       | **exit**                                          |
-| cd              | cd                         | dizin değiştir          | **cd test**                                       |
-| dir             | ls                         | dizin/dosyaları listele | **dir**                                           |
-| copy            | cp                         | dosya kopyala           | **copy c:\test\test.txt c:\windows\test.txt** |
-| move            | mv                         | dosya taşı              | **move c:\test\test.txt c:\windows\test.txt** |
-| mkdir           | mkdir                      | yeni bir dizin oluştur  | **mkdir testdizini**                              |
-| del             | rm                         | bir dosya/dizin sil     | **del c:\test\test.txt**                        |
+| Komut (Windows) | Komut (Mac OS - GNU/Linux) | Açıklama                   | Örnek                                             |
+| --------------- | -------------------------- | -------------------------- | ------------------------------------------------- |
+| çıkış           | çıkış                      | pencereyi kapatır          | **çıkış**                                         |
+| cd              | cd                         | dizin değiştir             | **cd test**                                       |
+| cd              | pwd                        | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir             | ls                         | dizin/dosyaları listele    | **dir**                                           |
+| copy            | cp                         | dosya kopyala              | **copy c:\test\test.txt c:\windows\test.txt** |
+| move            | mv                         | dosya taşı                 | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir           | mkdir                      | yeni bir dizin oluştur     | **mkdir testdizini**                              |
+| rmdir (or del)  | rm                         | dosyayı silin              | **del c:\test\test.txt**                        |
+| rmdir /S        | rm -r                      | klasörü siliniz            | **rm -r testdirectory**                           |
 
 Bu kullanabileceğiniz komutlardan sadece birkaçı, fakat bugün bundan daha fazlasını kullanmayacaksınız.
 
-Eğer merak ediyorsanız, [ss64.com][1] adresinden tüm işletim sistemleri için tüm komutların kullanımına ulaşabilirsiniz.
-
- [1]: http://ss64.com
+Eğer merak ediyorsanız, [ss64.com](http://ss64.com) adresinden tüm işletim sistemleri için tüm komutların kullanımına ulaşabilirsiniz.
 
 ## Hazır mısınız?
 
-Haydi Python'a giriş yapalım!
+Haydi Python'a giriş yapalım!
\ No newline at end of file
diff --git a/tr/python_installation/README.md b/tr/python_installation/README.md
index 506b8fb871d..ad5edc2e16f 100755
--- a/tr/python_installation/README.md
+++ b/tr/python_installation/README.md
@@ -4,10 +4,12 @@ Nihayet buradayız!
 
 Fakat önce, size Python'un ne olduğunu açıklayalım. Python web siteleri, oyunlar, bilimsel yazılımlar, grafikler ve çok daha fazlasını oluşturmak için kullanılan bir programlama dilidir.
 
-Python'un kökleri 1980'li yılların sonlarına dayanmaktadır ve ana hedefi sadece makineler değil insanlar tarafından da okunabilir olmaktır. Bu yüzden diğer programlama dillerine oranla çok daha basit görünmektedir. Öğrenmesi kolaydır ama merak etmeyin, Python gerçekten güçlüdür!
+Python'un kökleri 1980'li yılların sonlarına dayanmaktadır ve ana hedefi sadece makineler değil insanlar tarafından da okunabilir olmaktır. Bu nedenle öbür programlama dillerinden daha basit görünür, ama merak etmeyin - Python da hakikaten güçlü!
 
 # Python kurulumu
 
-> **Not** Eğer kurulum aşamalarını zaten tamamladıysanız, tekrar yapmanıza gerek yok - direkt olarak diğer aşamaya geçebilirsiniz!
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
 
-{% include "/python_installation/instructions.md" %}
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/tr/python_installation/instructions.md b/tr/python_installation/instructions.md
index 2fd53a4b2ae..78b44dde0eb 100755
--- a/tr/python_installation/instructions.md
+++ b/tr/python_installation/instructions.md
@@ -1,56 +1,106 @@
-> Bu bölüm Geek Girls Carrots tarafından yapılan bir eğitime dayanılarak hazırlanmıştır. (http://django.carrots.pl/)
+> Evdeki okuyucular için: bu bölüm [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) isimli videoda kapsanmıştır.
+> 
+> Bu bölüm Geek Girls Carrots (https://github.com/ggcarrots/django-carrots) tarafından hazırlanmış bir öğreticiye dayanmaktadır
 
-Django, Python ile yazılmıştır. Django ile bir şey yapmak için Python diline ihtiyacımız var. Hadi Python kurmaya başlayalım! Biz Python 3.4 kurmak istiyoruz, eğer daha düşük bir sürüme sahipseniz, güncellemelisiniz.
+Django, Python dilinde yazılmıştır. Django'da herhangi bir şey yapmak için Python'a ihtiyaç duyarız. Python'ın kurulumunu yaparak başlayalım! Sizden Python 3.6'nın kurulumunu yapmanızı istiyoruz. Yani, eğer daha önceki bir versiyonuna sahipseniz, güncellemeniz gerekecek.
 
-### Windows
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
 
-Windows için Python indirmek için resmi siteyi ziyaret edebilirsiniz: https://www.python.org/downloads/release/python-343/. ***.msi** dosyasını indirdikten sonra, dosyayı çalıştırın (çift tıklayın) ve yönergeleri izleyin. Python kurulumunu yaptığınız dizinin yolunu (dizini) unutmamanız önemli. Daha sonra lazım olacak!
+Öncelikle Windows + Pause/Break tuş kombinasyonlarına basarak bilgisayarınızın Windows'un 32-bit versyionunu mu 64-bit versiyonu mu çalıştırdığını kontrol edin. Bu size Sistem bilgisini açacak. Açılan bu pencerede "Sistem tipi" satırına bakın. Windows için Python'ı şu web sitesinden indirebilirsinizhttps://www.python.org/downloads/windows/. "Son Python 3 Sürümü - Python x.x.x" bağlantısına tıklayın. Eğer bilgisayarınız **64-bit** versiyon Windows çalıştırıyorsa, **Windows x86-64 çalıştırılabilir yükleyici**'yi indirin. Değilse, **Windows x86 çalıştırılabilir yükleyici**'yi indirin. Yükleyiciyi indirdikten sonra, çalıştırmalısınız (üzerine çift tıklayarak) ve oradaki talimatları takip etmelisiniz.
 
-Dikkat: Özelleştir (Customize) olarak seçilmiş kurulum sihirbazının ikinci ekranında seçenekleri aşağıya kaydırın ve "Add python.exe to the Path" (python.exe yolunu ekle) seçeneğinin üzerine gelip "Will be installed on local hard drive" (Lokal hard diske kurulacak) seçeneğini seçin:
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
 
-![Python'u arama yoluna eklemeyi unutmayın](../python_installation/images/add_python_to_windows_path.png)
+![Python'u arama yoluna eklemeyi unutmayın](../python_installation/images/python-installation-options.png)
 
-### Linux
+Önümüzdeki adımlarda, Windows Komut Satırını kullanıyor olacaksınız (ki ayrıca bahsedeceğiz). Şimdilik, eğer kimi komutlar yazmanız gerekirse, Başlat menüsü → Windows Sistemi → Komut Satırı'na gidin. Ayrıca "Çalıştır" penceresi ekrana gelene kadar Windows tuşuna basılı tutarken "R"-tuşuna basabilirsiniz. Komut Satırı'nı açmak için, "cmd" yazın ve "Çalıştır" penceresinde enter'a basın. (Windows'un yeni versiyonlarında, bazen saklı olduğundan "Komut Satırı"nı aratmak zorunda kalabilirsiniz.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Not: eğer Windows'un eski bir versiyonunu (7, Vista ya da herhangi bir eski versiyon) kullanıyorsanız ve Python 3.6.x yükleyicisi hata veriyorsa, aşağıdakilerden birini deneyebilirsiniz:
+
+1. bütün Windows Güncellemeleri'ni yükleyin ve Python 3.6'yı tekrar yüklemeyi deneyin; ya da
+2. [eski bir Python versiyonu](https://www.python.org/downloads/windows/), örneğin [3.4.6](https://www.python.org/downloads/release/python-346/) yükleyin.
+
+Eğer Python'ın eski bir versiyonunu yüklerseniz, yükleme ekranı yukarıda gösterilenden biraz farklı görünebilir. "python.exe'yi Path'e ekle" görene dek aşağı kaydırdığınızdan emin olun, daha sonra soldaki butona tıklayın ve "Yerel sabit sürücüye yüklenecek"'i seçin:
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Not** Python'ı OS X'te yüklemeden önce, Mac ayarlarınızın App Store'dan olmayan paketleri yüklemeye izin verdiğinden emin olmalısınız. Sistem Tercihleri'ne (Uygulamalar klasöründe) gidin, önce "Güvenlik & Gizlilik"'e ve daha sonra da "Genel" sekmesine tıklayın. Eğer sizin "Şuradan yüklenen uygulamalara izin ver:" ayarınız "Mac App Store"'a ayarlıysa, onu "Mac App Store and kimliği bilinen geliştirici."lere çevirin
+
+Python kurulum dosyasını indirmek için resmi siteye gitmelisiniz: https://www.python.org/downloads/release/python-361/
+
+* *Mac OS X 64-bit/32-bit yükleyici* dosyasını indirin,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
 
 Muhtemelen sisteminizde Python zaten yüklüdür. Yüklü olup olmadığını (ya da hangi versiyon olduğunu) kontrol etmek için komut satırını açın ve aşağıdaki komutları girin: 
 
-```
-$ python3 --version
-Python 3.4.3
-```    
+{% filename %}command-line{% endfilename %}
 
-Python yüklü değilse ya da farklı bir versiyon edinmek istiyorsanız aşağıdaki adımları takip edin:
+    $ python3 --version
+    Python 3.6.1
+    
 
-#### Debian veya Ubuntu
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. Python yüklü değilse ya da farklı bir versiyon edinmek istiyorsanız aşağıdaki adımları takip edin:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
 
 Terminale bu komutu girin:
 
-```
-$ sudo apt-get install python3.4
-```    
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Terminalde kullanmanız gereken komut:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
 
-#### Fedora
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
 
 Terminalde kullanmanız gereken komut:
 
-```
-$ sudo dnf install python3.4
-```    
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
 
-### OS X
+<!--endsec-->
 
-Python kurulum dosyasını indirmek için resmi siteye gitmelisiniz: https://www.python.org/downloads/release/python-342/:
+Verify the installation was successful by opening a command prompt and running the `python3` command:
 
-  * *Mac OS X 64-bit/32-bit yükleyici* dosyasını indirin,
-  * *python-3.4.3-macosx10.6.pkg* dosyasına çift tıklayarak yükleyiciyi çalıştırın.
+{% filename %}command-line{% endfilename %}
 
-Kurulumun başarılı olup olmadığını kontrol etmek için *Terminal* uygulamasını açın ve aşağıdaki `python3` komutunu çalıştırın:
+    $ python3 --version
+    Python 3.6.1
+    
 
-```
-$ python3 --version
-Python 3.4.3
-```    
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
 
 * * *
 
-Herhangi bir şüpheniz varsa, kurulumda bir şeyler ters gittiyse ya da sonrasında ne yapacağınızı bilmiyorsanız eğitmene sorabilirsiniz! Bazen işler düzgün gitmiyor, bu durumda daha fazla deneyime sahip birinden yardım istemelisiniz.
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Bazen işler düzgün gitmiyor, bu durumda daha fazla deneyime sahip birinden yardım istemelisiniz.
\ No newline at end of file
diff --git a/tr/python_introduction/README.md b/tr/python_introduction/README.md
index dd0c0812758..508c4725fa3 100644
--- a/tr/python_introduction/README.md
+++ b/tr/python_introduction/README.md
@@ -1,101 +1,129 @@
-# Python'a Giriş
+# Python'a giriş
 
-> Bu bölümün bazı kısımları Geek Girls Carrots (http://django.carrots.pl/) öğreticisinden alınmıştır.
+> Bu bölümün bir kısmı Geek Girls Carrots tarafından hazırlanmış eğitimlere dayanılarak hazırlanmıştır (https://github.com/ggcarrots/django-carrots).
 
 Biraz kod yazalım!
 
 ## Python komut istemi (prompt)
 
-Python'la oynamaya başlamadan önce bilgisayarımızda bir *komut satırı* açmamız gerekiyor. Bunu nasıl yapacağınızı artık biliyorsunuz, [Komut satırına giriş][1] bölümünde öğrenmiştiniz.
+> Evdeki okuyucular için: Bu kısım [Python Temelleri: Tamsayılar, Dizeler, Listeler, Değişkenler ve Hatalar](https://www.youtube.com/watch?v=MO63L4s-20U) videosunda bulunabilir.
 
- [1]: ../intro_to_command_line/README.md
+Python'la oynamaya başlamadan önce bilgisayarımızda bir *komut satırı* açmamız gerekiyor. Bunu zaten nasıl yapacağınızı artık biliyorsunuz, [Komut satırına giriş](../intro_to_command_line/README.md) bölümünde öğrenmiştiniz.
 
 Hazır olduğunuzda, aşağıdaki talimatları takip edin.
 
 Bir Python konsolu açmak istiyoruz; öyleyse Windows'ta `python`, Mac OS/Linux'ta `python3` yazıp, `enter`'a basın.
 
-```
-$ python3
-Python 3.4.3 (...)
-Type "help", "copyright", "credits" or "license" for more information.
->>>
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Daha fazla bilgi için "yardım", "telif hakkı", "krediler" veya "lisans" yazın
+    >>>
+    
 
 ## İlk Python komutunuz!
 
-Python komutunu çalıştırdıktan sonra, komut istemi `>>>` şeklinde değişti. Bizim için bu, şimdi yalnızca Python dilinde komutlar kullanabileceğimiz anlamına geliyor. `>>>` yazmanıza gerek yok, Python sizin için bunu yapıyor.
+Python komutunu çalıştırdıktan sonra, komut istemi `>>>` şeklinde değişti. Bizim için bu, şimdi yalnızca Python dilinde komutlar kullanabileceğimiz anlamına geliyor. `>>>` yazmanıza gerek yok - Python bunu sizin için yapacak.
 
 Eğer herhangi bir zamanda Python komut satırından çıkmak isterseniz, yalnızca `exit()` yazmanız ya da Windows için `Ctrl + Z`, Mac/Linux için `Ctrl + D` kısa yolunu kullanmanız yeterli. Bunu yaptığınız taktirde artık `>>>` yazısını görmeyeceksiniz.
 
-Şu an için Python komut satırından çıkmak istemiyoruz. Bu konuda daha fazlasını öğrenmek istiyoruz. Gerçekten basit bir şeyle başlayalım. Örneğin, biraz matematik yapmayı deneyip `2 + 3` gibi bir şey yazın ve `enter`'a basın.
+Şimdilik, Python konsolundan çıkmak istemiyoruz. Bu konuda daha fazla bilgi edinmek istiyoruz. ` girmek ` 'e basarak ` 2 + 3 ` gibi biraz matematik yazarak başlayalım.
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> 2 + 3
 5
-```    
+```
+
+Güzel! Cevap nasıl da çıktı görüyor musun? Python matematik biliyor! Sen de diğer komutları şöyle deneyebilirsin:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Üstel hesaplama uygulamak, 2 üzeri 3 deyin, Biz yazalım: {% filename %}komut-satırı{% endfilename %}
 
-Harika! Cevabın komut satırına geldiğini gördün değil mi? Python matematik biliyor! Şu gibi komutları da deneyebilirsiniz: - `4 * 5` - `5 - 1` - `40 / 2`
+```python
+>>> 2 ** 3
+8
+```
 
-Bunları biraz kurcalayıp eğlen, sonra tekrar burada buluşalım :).
+Bunları biraz kurcalayıp eğlen, sonra tekrar burada buluşalım. :)
 
-Gördüğün üzere Python çok iyi bir hesap makinesi. Eğer başka neler yapabileceğini merak ediyorsan...
+Gördüğünüz gibi Python mükemmel bir hesap makinesidir. Eğer başka neler yapabileceğinizi merak ediyorsanız…
 
 ## String'ler (dizeler)
 
 Mesela ismin? İsmini tırnak işaretleri içerisinde şu şekilde yaz:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> "Zeynep"
 'Zeynep'
-``` 
+```
 
 İlk string'ini oluşturdun! String (katar), bilgisayar tarafından işlenebilen ve karakterlerden oluşan dizilerin genel adıdır. Bir string her zaman aynı özel karakterle başlamalı ve aynı özel karakterle bitmelidir. Tek tırnak (`'`) veya çift tırnak (`"`) olabilir (aralarında herhangi bir fark yok!). Tırnak işaretleri Python'da içlerinde olan şeyin bir string olduğunu ifade eder.
 
 Stringler birbirlerine eklenebilir. Şunu dene:
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> "Merhaba " + "Zeynep"
 'Merhaba Zeynep'
-```    
+```
 
 Ayrıca stringleri bir sayı ile çarpabilirsin:
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> "Zeynep" * 3
 'ZeynepZeynepZeynep'
-```    
+```
 
 Eğer stringinin içerisine bir tırnak işareti koymak istiyorsan, bunun için iki seçeneğin var.
 
 Çift tırnak kullanarak:
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> "Turgut Uyar'ın dizeleriyiz"
 "Turgut Uyar'ın dizeleriyiz"
-```    
+```
 
 veya sola eğik çizgi (` \ `) kullanarak:
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> 'Turgut Uyar\'ın dizeleriyiz'
 "Turgut Uyar'ın dizeleriyiz"
-```    
+```
 
 Hoş değil mi? İsminin tamamını büyük harf yapmak için, sadece şunu yazman yeterli:
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> "Zeynep".upper()
 'ZEYNEP'
-```    
+```
 
-Stringin üzerinde `upper` **fonksiyon**unu kullandın! Bir fonksiyon (`upper()` gibi) , çağırıldığında(calling) Python'un bir obje (`"Zeynep"`) üzerinde gerçekleştirmesi gereken bir dizi işleme denilir.
+String'in üzerinde `upper` **fonksiyon**unu kullandın! Bir fonksiyon (`upper()` gibi), çağırıldığında (calling) Python'un girdi olarak verilen bir obje (`"Zeynep"`) üzerinde gerçekleştirmesi gereken bir dizi işleme denilir.
 
-Eğer ismindeki harflerin sayısını öğrenmek istiyorsan bunun için de bir fonksiyon var!
+Eğer ismindeki harflerin sayısını öğrenmek istiyorsan bunun için de bir **fonksiyon** var!
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> len("Zeynep")
 6
-```    
+```
 
 Fonksiyonları neden bazen stringin sonunda bir `.` ile (`"Zeynep".upper()` gibi) ve bazen de önce fonksiyonu çağırıp sonra parantez içerisine stringi yazarak kullandığımızı merak ediyor musun? Pekala, bazı durumlarda, fonksiyonlar bir takım nesnelere aittirler, mesela `upper()`, yalnızca stringler üzerinde kullanılabilir. Böyle durumlarda, bu tarz fonksiyonlara biz **method** ismini veriyoruz. Diğer durumlarda, bir fonksiyon özel olarak bir nesneye ait olmayıp, farklı çeşitlerde nesneler üzerinde de kullanılabilir, aynı `len()` gibi. İşte bu nedenle `"Zeynep"` stringini `len` fonksiyonuna bir parametre olarak veriyoruz.
 
@@ -103,10 +131,10 @@ Fonksiyonları neden bazen stringin sonunda bir `.` ile (`"Zeynep".upper()` gibi
 
 Tamam, stringlerden yeterince bahsettik. Şu ana kadar şu konuları öğrendin:
 
-*   **konsol-komut istemcisi** - Python komut satırına komut(kod) yazdığında Python cevap veriyor
-*   **sayılar ve strings(karakter dizinleri)** - Python'da sayılar matematik ve stringler metin nesneleri için kullanılıyor
-*   **operators(işleçler)** + ve * gibi, değerleri birleştirerek yeni bir değer oluştuyor
-*   **fonksiyonlar-işlevler** - upper() ve len() gibi, nesneler üzerinde eylemler gerçekleştiriyor.
+- **komut istemi** – komutları (kod) Python'un komut istemine yazdığınızda Python'da sonuçlandırarak yanıtlar üretir
+- **sayılar ve dizinler** – Python'da sayılar matematik için dizinler ise metin nesneleri için kullanılmaktadır
+- **operatörler** `+` ve `*` gibi, değerleri birleştirerek yeni bir değer üretmek için kullanılmaktadır
+- **fonksiyonlar** `upper()` ve `len()` gibi, nesneler üzerinde eylemler gerçekleştirmektedirler.
 
 Bunlar öğreneceğiniz her programlama dilinin temelleri. Biraz daha zor bir şey için hazır mısın? İddiaya gireriz öylesin!
 
@@ -114,26 +142,30 @@ Bunlar öğreneceğiniz her programlama dilinin temelleri. Biraz daha zor bir ş
 
 Şimdi yeni bir şey deneyelim. Bir sayının uzunluğunu, bir string'in uzunluğunu bulduğumuz gibi bulabilir miyiz? Bunu görmek için `len(304023)` yazıp `enter`a basalım:
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> len(304023)
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
 TypeError: object of type 'int' has no len()
-``` 
+```
 
 İlk hatamızı aldık! Nesne türü "int" (tam sayılar, tüm sayılar) in uzunluğu olmadığını söylüyor. Şimdi ne yapabiliriz? Belki de rakamı bir string olarak yazabiliriz? Stringlerin bir uzunluğu var, değil mi?
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> len(str(304023))
 6
-```    
+```
 
 İşe yaradı! `str` fonksiyonunu `len` fonksiyonunun içinde kullandık. `str` her şeyi string'e çeviriyor.
 
-*   `str` fonksiyonu, değişkenleri **stringe** çeviriyor
-*   `int` fonksiyonu değişkenleri **integera** çeviriyor
+- `str` fonksiyonu, değişkenleri **stringe** çeviriyor
+- `int` fonksiyonu değişkenleri **integera** çeviriyor
 
-> Önemli: Tamsayıları yazıya çevirebiliriz, fakat yazıları(text) sayılara çeviremeyiz - `int('selamlar')` bir anlam ifade etmiyor.
+> Önemli: Sayıları metin durumuna getirebiliriz ama metni sayılar durumuna tam olarak getiremeyebiliriz - yine de `int('hello')` olsa ne olurdu?
 
 ## Değişkenler
 
@@ -141,52 +173,64 @@ Programlamada en önemli konulardan biri değişkenlerdir. Değişken, daha sonr
 
 `name` adında bir değişken yaratmak istediğimizi varsayalım:
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> name = "Ayşe"
-```    
+```
 
-Gördünüz mü? Ne kadar kolay: name değişkeni "Ayşe" oldu.
+Tip adı eşittir Ola.
 
 Farkettiğiniz gibi, program daha öncekilerinin aksine bu kez hiçbir cevap vermedi. O zaman böyle bir değişkenin gerçekten tanımlı olduğunu nasıl bilebiliriz? Basitçe, `name` yazıp `enter` tuşuna basalım:
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> name
 'Ayşe'
-```    
+```
 
-İşte bu sizin ilk değişkeniniz! name değişkeninin işaret ettiği şeyi her zaman değiştirebilirsiniz:
+İşte bu sizin ilk değişkeniniz! :) Bu değişkeni işaret ettiği şeyi her zaman değiştirebilirsiniz:
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> name = "Suzan"
 >>> name
 'Suzan'
-```    
+```
 
 Bu değişkeni fonksiyonlar içinde de kullanabilirsiniz:
 
-```  
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> len(name)
 5
-```    
+```
 
-Harika değil mi? Tabii ki değişkenler, sayılar da dahil herhangi bir şey olabilir. Şunu deneyin: 
+Muhteşem değil mi? Tabikide değişkenler herhangi bir şey olabilir – sayılar da! Bunu deneyin:
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> a = 4
 >>> b = 6
 >>> a * b
 24
-```    
+```
 
 Peki ya değişkenin adını yanlış kullanırsak? Ne olacağını tahmin ediyor musunuz? Deneyelim! 
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> city = "Tokyo"
 >>> ctiy
 Traceback (most recent call last):
-   File "<stdin>", line 1, in <module>
+  File "<stdin>", line 1, in <module>
 NameError: name 'ctiy' is not defined
-```   
+```
 
 Bir hata! Gördüğünüz gibi, Python bir çok çeşit hata çeşidine sahip ve bu hatanın adı **NameError**, yani İsimlendirme Hatası. Tanımlamadığınız bir değişkenin adını kullanmaya çalışırsanız, Python size bu hatayı verir. Eğer bu hata ile daha sonra karşılaşırsanız, kodunuzdaki değişkenlerin adını doğru yazıp yazmadığınızı kontrol edin.
 
@@ -196,7 +240,9 @@ Bununla biraz oynayıp, neler yapabildiğinizi görün!
 
 Şunu deneyin:
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> name = 'Merve'
 >>> name
 'Merve'
@@ -210,81 +256,100 @@ Daha ileride göreceğimiz gibi `print()`, işlevlerin içindeyken bir şey yazd
 
 ## Listeler
 
-Python, string ve integerın yanı sıra, çok değişik türlerde nesnelere sahiptir. Şimdi, **liste** türünü tanıtacağız. Listeler tam da düşündüğünüz gibidir: diğer nesnelerin listesi olan nesne :)
+Python, string ve integerın yanı sıra, çok değişik türlerde nesnelere sahiptir. Şimdi, **liste** türünü tanıtacağız. Listeler tam da düşündüğünüz gibidir: diğer nesnelerin listesi olan nesne. :)
 
 Yeni bir liste yaratmakla devam edelim:
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> []
 []
-```    
+```
 
 Evet, liste boş. Çok kullanışlı sayılmaz, değil mi? Hadi loto numaralarıyla liste oluşturalım. Sürekli kendimizi tekrar etmek istemeyiz, o yüzden listeyi değişkene atayalım:
 
-```  
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> lottery = [3, 42, 12, 19, 30, 59]
-```    
+```
 
 Pekala, listeyi oluşturduk! Onunla ne yapabiliriz? Hadi listede kaç tane loto numarası olduğunu görelim. Hangi fonksiyonu kullanman gerektiği hakkında bir fikrin var mı? Zaten bildiğin bir fonksiyon!
 
-```  
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> len(lottery)
 6
 ```
 
 Evet! `len()` listedeki nesne sayısını verir. Kullanışlı, değil mi? Belki de şu an listeyi sıralarız:
 
-```
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> lottery.sort()
-```    
+```
 
 Bu hiçbir cevap vermez, sadece listedeki numaraların sırasını değiştirir. Şimdi listeyi yazdıralım ve ne olduğunu görelim:
 
-```  
+{% dosyaadı %}Komut-satırı{% sondosyaadı %}
+
+```python
 >>> print(lottery)
 [3, 12, 19, 30, 42, 59]
-```    
+```
 
 Gördüğünüz gibi, listedeki sayılar artık küçükten büyüğe sıralı. Tebrikler!
 
 Belki de sıralamayı ters çevirmek isteriz? Hadi yapalım!
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> lottery.reverse()
 >>> print(lottery)
 [59, 42, 30, 19, 12, 3]
-```    
+```
 
-Kolay, değil mi? Listeye yeni bir eleman eklemek isterseniz, bu komutu yazarak yapabilirsiniz:
+Listenize bir şeyler eklemek isterseniz, şu komutu yazarak yapabilirsiniz:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> lottery.append(199)
 >>> print(lottery)
 [59, 42, 30, 19, 12, 3, 199]
-```    
+```
 
 Sadece listedeki ilk elemanı göstermek isterseniz, **indexes** (indeksler) ile yapabilirsiniz. İndeks elemanın listede nerede olduğunu belirten numaradır. Programcılar sıfırdan başlamayı tercih ederler, bu yüzden listedeki ilk eleman listenin 0. indeksindedir, sonraki 1. indeksindedir ve böyle devam eder. Şunu deneyin:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> print(lottery[0])
 59
 >>> print(lottery[1])
 42
-```    
+```
 
 Gördüğünüz gibi, Listedeki nesnelere listenin ismi ve köşeli parantez içindeki nesnenin indeksini kullanarak ulaşabilirsin.
 
-Listeden eleman silmek için yukarıda öğrendiğimiz gibi **indeksleri** ve **del** komutunu kullanman gerekir (del silmenin(delete) kısaltmasıdır). Bir örnekle öğrendiklerimizi pekiştirelim; listeden ilk numarayı sileceğiz.
+Listenizde bir şeyler silmek için ve yukarıda öğrendiğimiz gibi **indeksleri** ve `pop()` metodunu kullanmanız gerekecektir. Bir örnek yapalım ve daha önce öğrendiklerimizi pekiştirelim; listemizden ilk numarayı sileceğiz.
+
+{% filename %}komut-satırı{% endfilename %}
 
-```  
+```python
 >>> print(lottery)
 [59, 42, 30, 19, 12, 3, 199]
 >>> print(lottery[0])
 59
->>> del lottery[0]
+>>> lottery.pop(0)
+59
 >>> print(lottery)
 [42, 30, 19, 12, 3, 199]
-```    
+```
 
 Kusursuz çalıştı!
 
@@ -294,104 +359,126 @@ Bütün liste fonksiyonlarını Python dökümantasyonunun bu bölümünde bulab
 
 ## Sözlükler (Dictionaries)
 
-Sözlük listeye benzerdir ancak sözlük değerlerine indeks yerine anahtar ile ulaşılır. Anahtar metin veya numara olabilir. Boş bir sözlük oluşturmak için kullanılan söz dizimi şudur:
+> Evdeki okuyucular için: Bu kısım [Python Temelleri: Sözlükler](https://www.youtube.com/watch?v=ZX1CVvZLE6c) videosunda işlenmiştir.
 
-```
+Sözlük listeye benzerdir fakat siz değerlere sayısal indeks yerine anahtar ile ulaşırsınız. Anahtar herhangi metin veya numara olabilir. Boş bir sözlük oluşturmak için kullanılan söz dizimi şöyledir:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> {}
 {}
-```    
+```
 
 Bu boş bir sözlük oluşturduğunuzu gösterir. Yaşasın!
 
-Şimdi, bu komutu yazmayı deneyin (kendi bilgilerinle değiştir):
+Şimdi, bu komutu yazmayı deneyin (kendi bilgilerinizi de değiştirmeyi deneyiniz):
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> participant = {'name': 'Ayşe', 'country': 'Türkiye', 'favorite_numbers': [7, 42, 92]}
-```    
+```
 
-Bu komut ile üç anahtar-değer çiftine sahip `participant` isminde bir değişken oluşturdun:
+Bu komutla, üç anahtar-değer çifti ile `katılımcı` isminde bir değişken oluşturdunuz:
 
-*   Anahtar `name` `'Ayşe'` (`string` nesnesi) değerine işaret eder,
-*   `country` `Türkiye` (bir diğer `string`) değerine,),
-*   ve `favorite_numbers` `[7, 42, 92]` (3 numaralı bir `list`) değerine işaret eder.
+- Anahtar `name` `'Ayşe'` (`string` nesnesi) değerine işaret eder,
+- `country` `Türkiye` (bir diğer `string`) değerine),
+- ve `favorite_numbers` `[7, 42, 92]` (3 numaralı bir `list`) değerine işaret eder.
 
 Bu söz dizimi ile tek bir anahtarın içeriğini kontrol edebilirsin:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> print(participant['name'])
 Ayşe
-``` 
+```
 
-Gördün mü, listeye benzer. Ancak indeksini hatırlamana gerek yok - sadece ismi.
+Gördünüz mü, bu listeye benzer. Fakat indeksi hatırlamanıza gerek yok - sadece ismini hatırlayın.
 
 Python'a olmayan bir anahtarın değerini sorarsak ne olur? Tahmin edebiliyor musun? Hadi deneyip görelim!
 
-```  
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> participant['age']
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
 KeyError: 'age'
-```    
+```
 
 Bir başka hata! **KeyError** hatası. Python yardımseverdir ve sana `'age'` anahtarının sözlükte bulunmadığını söyler.
 
 Ne zaman sözlük veya liste kullanmalısın? Düşünmek için güzel bir nokta. Sonraki satırdaki cevaba bakmadan önce kafanızda bir çözüm oluşturun.
 
-*   Sıralı elemanlara mı ihtiyacın var? Liste ile devam et.
-*   İleride hızlıca (anahtarlar ile) değerlere ulaşmak istediğin için anahtarlar ile ilişkilendirilmiş değerlere mi ihtiyacın var? Sözlük kullan.
+- Sıralı elemanlara mı ihtiyacın var? Liste ile devam et.
+- İleride hızlıca (anahtarlar ile) değerlere ulaşmak istediğin için anahtarlar ile ilişkilendirilmiş değerlere mi ihtiyacın var? Sözlük kullan.
 
-Sözlükler de listeler gibi değişebilirdir (*mutable*), yani oluşturulduktan sonra değiştirilebilirler. Oluşturulduktan sonra sözlüklere anahtar/değer çifti ekleyebilirsiniz, aşağıdaki gibi:
+Sözlükler de listeler gibi *değişken*'dir, yani oluşturulduktan sonra değiştirilebilir anlamına gelmektedir. Oluşturulduktan sonra sözlüklere yeni anahtar-değer çifti ekleyebilirsiniz, bunun gibi:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> participant['favorite_language'] = 'Python'
-```    
+```
 
-Listeler gibi, `len()` metodu sözlükteki anahtar-değer çiftlerinin sayısını bize verir. Devam edip şu komutu yazın:
+Listeler gibi,`len()` metodunu sözlüklerde kullanmak sözlükteki anahtar-değer çiftlerinin sayısını geri getirir. Devam et ve bu komutu yaz:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> len(participant)
 4
 ```
-    
 
-Umarım şu ana kadar mantıklı gelmiştir :) Sözlüklerle biraz daha eğlenceye hazır mısın? İlginç şeyler için sonraki satıra atla.
+Umarım şimdiye kadar mantıklı gelmiştir. :) Sözlüklerle biraz daha eğlenceye hazır mısınız? Hayret verici bazı şeyler okumaya devam edin.
 
-`del` komutunu sözlükten eleman silmek için kullanabilirsin. Mesela, `'favorite_numbers'` anahtarına karşılık gelen elemanı silmek istersen, sadece şu komutu yaz:
+Sözlükten bir maddeyi silmek için `pop()` metodunu kullanabilirsin. Mesela, `'favorite_numbers'` anahtarına karşılık gelen elemanı silmek istersen, sadece şu komutu yaz:
 
-```
->>> del participant['favorite_numbers']
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
 >>> participant
-{'country': 'Türkiye', 'favorite_language': 'Python', 'name': 'Ayşe'}
-```    
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
 
-Çıktıdan görebildiğin gibi, 'favorite_numbers' anahtarına karşılık gelen anahtar-değer çifti silindi.
+Çıktıdan görüldüğü gibi, ana değer eşleniği 'favorite_numbers' anahtarı silinmiştir.
 
-Bunun yanı sıra, sözlükteki daha önce oluşturulmuş anahtarın değerini değiştirebilirsiniz. Şunu yazın:
+Bunun yanı sıra, oluşturulmuş anahtar değerini değiştirebilirsiniz. Bunu yazın:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> participant['country'] = 'Almanya'
 >>> participant
 {'country': 'Almanya', 'favorite_language': 'Python', 'name': 'Ayşe'}
-```    
+```
 
-Gördüğün gibi, `'country'` anahtarının değeri `'Türkiye'`den `'Almanya`'ya çevrildi. :) Heyecan verici değil mi? Yaşasın! Bir başka harika şey öğrendin.
+Gördüğün gibi, `'country'` anahtarının değeri `'Poland'`‘den `'Germany’`'e çevrildi. :) Heyecan verici değil mi? Yaşasın! Bir başka harika şey öğrendin.
 
 ### Özet
 
 Harika! Şu an programlama hakkında birçok şey biliyorsun. Bu kısımda, şunları öğrendin:
 
-*   **hatalar** - eğer Python yazdığın komutu anlamazsa çıkan hataları nasıl okuyacağını ve anlayacağını artık biliyorsun
-*   **değişkenler** - daha kolay kod yazmanı sağlayan ve kodunu daha okunabilir yapan nesnelerin isimleri
-*   **listeler** - belirli bir sırada tutulan nesnelerin listesi
-*   **sözlükler** - anahtar-değer çifti olarak tutulan nesneler
+- **errors** - eğer Python yazdığın komutu anlamazsa çıkan hataları nasıl okuyacağını ve anlayacağını artık biliyorsun
+- **değişkenler** - daha kolay kod yazmanı sağlayan ve kodunu daha okunabilir yapan nesnelerin isimleri
+- **listeler** - belirli bir sırada tutulan nesnelerin listesi
+- **sözlükler** - anahtar-değer çifti olarak tutulan nesneler
 
 Bir sonraki part için heyecanlı mısınız? :)
 
 ## Karşılaştırma
 
-Programlamanın önemli bir bölümü bir şeyleri karşılaştırmayı içerir. Karşılaştırılabilecek en kolay şey nedir? Tabii ki sayılar. Nasıl çalıştığını görelim (True = "Doğru", False= "Yanlış" demek).
+> Evden okuyanlar için: Bu kısım [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) vidyosunda anlatılıyor.
 
-```
+Programlamanın büyük kısmı karşılaştırma içerir. Karşılaştırması en kolay olan şey nediir? Tabiki sayılar. Bakalım nasıl çalışıyor:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> 5 > 2
 True
 >>> 3 < 1
@@ -404,64 +491,75 @@ True
 True
 ```
 
-Python'a birkaç sayı karşılaştırmasını söyledik. Gördüğünüz gibi, sadece sayıları karşılaştırmakla kalmadı, aynı zamanda metodların sonuçlarını da karşılaştırdı. Güzel değil mi?
+Python karşılaştırma için numara verildi. Gördüğünüz gibi Python sadece numaraları karşılaştırmakla kalmıyor, aynı zamanda metod sonuçlarını karşılaştırabiliyor. Harika değil mi?
 
-İki sayının eşit olup olmadığını öğrenmek için neden iki tane eşittir işraretini `==` yan yana koyduk? Değişkenlere içerik verirken, tek `=` işaretini kullanıyoruz. İki sayının birbirine eşit olup olmadığını görmek için **her zaman** `==` işaretini kullanmak gerekiyor. Sayıların birbirine eşit olmaması durumunu da kontrol edebiliriz. Bunun için, yukarıdaki örnekteki gibi `!=` sembolünü kullanıyoruz. 
+İki sayının eşit olup olmadığını öğrenmek için neden iki tane eşittir işraretini `==` yan yana koyduk? Değişkenlere içerik verirken, tek `=` işaretini kullanıyoruz. Her zaman ama **her zaman** ikisini birden koyman gerekir – `==` – eğer birbirlerine eşit olup olmadıklarını kontrol etmek isterseniz. Sayıların birbirine eşit olmaması durumunu da kontrol edebiliriz. Bunun için, yukarıdaki örnekteki gibi `!=` sembolünü kullanıyoruz. 
 
 Python' a iki görev daha verin:
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> 6 >= 12 / 2
 True
 >>> 3 <= 2
 False
-```    
+```
 
-`>` ve `<` işaretleri kolay, fakat `>=` ve `<=` ne anlama geliyor?
+`>`‘ı ve `<`‘ı gördük, ama `>=` ve `<=` ne anlama geliyor? Onları böyle oku:
 
-*   x `>` y : x büyüktür y
-*   x `<` y : x küçüktür y
-*   x `<=` y : x küçük eşittir y
-*   x `>=` y : x büyük eşittir y
+- x `>` y : x büyüktür y
+- x `<` y : x küçüktür y
+- x `<=` y : x küçük eşittir y
+- x `>=` y : x büyük eşittir y
 
 Harika! Biraz daha ister misiniz? Şunu deneyin: 
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> 6 > 2 and 2 < 3
 True
 >>> 3 > 2 and 2 < 1
 False
 >>> 3 > 2 or 2 < 1
 True
-```    
+```
 
 Python'a istediğiniz kadar sayıyı karşılaştırmak için verebilirsiniz, ve size hepsinin cevabını verecek. Çok akıllı değil mi?
 
-*   **and** - Mantıkta kullandığımız "ve" anlamına geliyor, yani iki taraf da True, yani doğruysa, cevap da True olacak
-*   **or** - Bu da "veya" anlamına geliyor, karşılaştırılan iki taraftan tek bir tanesi bile True ise bize True cevabını verecek
+- **and** - Eğer `and` işlecini kullanırsan, bütün komutların doğru olması için her iki kıyaslama da doğru olmak zorundadır
+- **or** - eğer `or` işlecini kullanırsan, bütün komutların doğru olması için kıyaslamalardan yalnızca biri doğru olmak zorundadır
 
 Portakallarla elmaları karşılaştılaştırabilir miyiz? Bunun Python'daki eşdeğerini deneyelim: 
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> 1 > 'django'
-Traceback (most recent call last):
-  File "<stdin>", line 1, in <module>
-TypeError: unorderable types: int() > str()
-```    
+Geri görüş (en son çağrı):
+  Dosya "<stdin>", satır 1, <module>‘in içinde
+HataTürü: ‘>’ 'int' ve 'str' örnekleri arasında desteklenmiyor
+```
 
 Gördüğünüz gibi Python tam sayılar(`int`) ve kelimeleri(yani stringleri, `str`) karşılaştıramıyor. Onun yerine, **TypeError** göstererek iki farklı tipteki değişkenin karşılaştırılamayacağını söylüyor. 
 
 ## Boolean (Mantıksal)
 
-Laf arasında, yeni bir Python nesne tipi öğrendiniz. Adı **boolean** olan bu tip çok kolay. 
+Bu arada, python'da yeni bir nesne türü öğrendin. Buna **Boolean** denir.
 
-Sadece iki tane boolean nesnesi var: - True (Doğru) - False (Yanlış)
+Yalnızca iki Boolean nesnesi vardır:
 
-Python'un bunu anlaması için her zaman "True" (ilk harf büyük, geri kalanları küçük) yazmanız gerekiyor. **true, TRUE, tRUE işe yaramaz -- sadece True doğru.** (Aynısı "False" için de geçerli.) 
+- Doğru
+- Yalnış
+
+Ama Python un bunu algılaması için, her zaman 'True' (baş harf büyük karakter kalan küçük olacak şekilde). **true, TRUE, tRUE işe yaramaz -- sadece True doğru.** (Aynısı "False" için de geçerli.)
 
 Boolean'lar değişken de olabiliyor! Bakınız: 
 
-```
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> a = True
 >>> a
 True
@@ -469,209 +567,292 @@ True
 
 Ayrıca bu şekilde de yapabilirsiniz:
 
-```  
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 >>> a = 2 > 5
 >>> a
 False
-```    
+```
 
 Boolean'lar ile aşağıdaki komutları deneyerek biraz oynayın:
 
-*   `True and True`
-*   `False and True`
-*   `True or 1 == 1`
-*   `1 != 2`
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
 
 Tebrikler! Boolean'lar programlamadaki en havalı özelliklerden, ve az önce onları nasıl kullanmanız gerektiğini öğrendiniz! 
 
 # Kaydet!
 
+> Evdeki okuyucular için: Bu kısım [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) videosunda işlenmiştir.
+
 Şimdiye kadar kodumuzu bizi sadece tek satır yazmaya limitleyen yorumlayıcı üzerinde yazdık. Normal programlar dosyalar içine kaydedilir ve programlama dilimizin **yorumlayıcısıyla** veya **derleyicisiyle** çalıştırılır. Şimdiye kadar programlarımızı Python **yorumlayıcısında** teker satır teker satır çalıştırdık. Bundan sonraki görevlerde, birden fazla satıra ihtiyacımız olacak, bu yüzden şunlara ihtiyacımız olacak:
 
-*   Python yorumlayıcısından çıkın
-*   Seçtiğiniz kod düzenleyicisini açın
-*   Yeni Python dosyasına kod kaydedin
-*   Çalıştırın!
+- Python yorumlayıcısından çıkın
+- Seçtiğiniz kod düzenleyicisini açın
+- Yeni Python dosyasına kod kaydedin
+- Çalıştırın!
+
+Kullanmakta olduğumuz Python yorumlayıcısından çıkmak için, basitçe `exit()` fonksiyonunu yaz
 
-Kullandığımız Python yorumlayıcısından çıkmak için sadece ~~~ exit() ~~~ fonksiyonunu yazmanız yeterlidir:
+{% filename %}komut-satırı{% endfilename %}
 
-```"
+```python
 >>> exit()
 $
-```    
+```
 
 Bu sizi komut satırına geri yönlendirecektir.
 
-Biraz önce [kod editörü][2] bölümünden bir kod editörü seçmiştik. Şimdi o editörü açmalı ve yeni bir dosya içine kod yazmalıyız:
+Biraz önce [kod editörü](../code_editor/README.md) bölümünden bir kod editörü seçmiştik. Şimdi o editörü açmalı ve yeni bir dosya içine kod yazmalıyız:
 
- [2]: ../code_editor/README.md
+{% filename %}editör{% endfilename %}
 
 ```python
-print('Merhaba, Django girls!')
-```    
-
-> **Not** Kod editörlerinin en havalı özelliğini fark etmiş olmalısınız: renkler! Python konsolunda her şey aynı renkteydi, şimdi `print` fonksiyonunun stringden farklı bir renkte olduğunu görüyorsunuz. Bunun ismi "söz dizimi vurgulama" ve kod yazarken gerçekten yararlı bir özellik. Koddaki renkler sana ipucu verecektir, örneğin metin kullanım hatasında veya dildeki anahtar kelimenin yanlış yazımında (mesela fonksiyondaki `def`, aşağıda göreceğiz). Bu kod düzenleyicisi kullanma nedenlerimizden biri :)
+print(‘Merhaba, Django kızları!’)
+```
 
 Açıkça, artık oldukça deneyimli Python programcısısın, bu yüzden bugün öğrendiğin kodları yazmaktan çekinme.
 
-Şimdi dosyayı tanımlayıcı bir isimle kaydetmemiz gerekir. Dosyanın ismine **python_intro.py** diyelim ve masaüstüne kaydedelim. Dosyaya istediğimiz ismi verebiliriz, burada önemli olan kısım dosyanın **.py** uzantısı ile bitmesidir. **.py** uzantısı işletim sistemimize bu dosyanın bir **python çalıştırılabilir dosyası** olduğunu ve Python'un bu dosyayı çalıştırabileceğini belirtiyor.
+Şimdi dosyayı tanımlayıcı bir isimle kaydetmemiz gerekir. Dosyanın ismine **python_intro.py** diyelim ve masaüstüne kaydedelim. Dosyaya istediğimiz ismi verebiliriz, burada önemli olan kısım dosyanın **.py** uzantısı ile bitmesidir. **.py** uzantısı işletim sistemimize bu dosyanın bir **Python çalıştırılabilir dosyası** olduğunu ve Python'un bu dosyayı çalıştırabileceğini belirtiyor.
+
+> **Not** Kod editörleriyle ilgili en harika şeylerden birine dikkat etmelisiniz: renkler! Python konsolunda herşey aynı renkteydi; şimdi bakın `print` fonksiyonu dizeden farklı renkte. Bunun ismi "söz dizimi vurgulama" ve kod yazarken gerçekten yararlı bir özellik. Koddaki renkler ipucu verir, kapanmamış dizeler gibi yada aşağıda göreceğimiz (`def` fonksiyonu gibi imla hatası içeren anahtar kelimeler oalbilir). Bu kod düzenleyicisi kullanma nedenlerimizden biri. :)
 
 Dosyayı kaydettiğimize göre artık çalıştırabiliriz! Konsoldan **Klasör değiştirme** yaparak masaüstüne ulaşın, komut satırı bölümünde öğrendiklerinizi hatırlayın.
 
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
 Mac'de bu komut şunun gibi görünecektir:
 
-```
-$ cd /Users/<isminiz>/Desktop
-```
+{% filename %}komut-satırı{% endfilename %}
 
-Linux'ta ise bu şekilde ("Desktop" kelimesi "Masaüstü" olarak da görünebilir):
+    $ cd ~/Masaüstü
+    
 
-```
-$ cd /home/<isminiz>/Desktop
-```    
+<!--endsec-->
 
-Ve Windows'ta, bu şekilde olacak:
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
 
-```
-> cd C:\Users\<isminiz>\Desktop
-```
+Linux’ta bunun gibi olacak (“Desktop” kelimesi yerel dilinize çevrilebilir):
+
+{% filename %}komut-satırı{% endfilename %}
+
+    $ cd ~/Masaüstü
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+Windows Komut İstemi’nde, bunun gibi olacak:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    > cd %HomePath%\Masaüstü
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+Ve Windows Powershell’de, bunun gibi olacak:
+
+{% filename %}komut-satırı{% endfilename %}
+
+    > cd $Home\Masaüstü
+    
+
+<!--endsec-->
 
 Bir problem olursa yardım istemekten çekinmeyin.
 
 Şimdi dosyadaki komutları çalıştırmak için Python'u kulllanın:
 
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3 python_intro.py
+    Merhaba, Django girls!
+    
+
+Not: Windows'ta 'python3' bir komut olarak geçmez. Onun yerine, dosyayı çalıştırmak için 'python'ı kullanın:
+
+{% filename %}komut-satırı{% endfilename %}
+
+```python
+> python python_intro.py
 ```
-$ python3 python_intro.py
-Merhaba, Django girls!
-```    
 
 Tamam! Bir dosyaya kaydedilen ilk Python programınızı çalıştırdınız. Harika hissediyor musunuz?
 
 Şimdi programlamanın olmazsa olmaz bir aracını öğrenme zamanı:
 
-## If...elif...else (Koşullu Akış)
+## eğer…elif… yoksa
 
-Kodunuzdaki bir çok şeyi sadece belirli bir durum sağlanıyorsa çalıştırmayı isteyeceksiniz. İşte tam da bu yüzden Python'da **if deyimi** isminde bir yapı bulunuyor.
+Koddaki pek çok şey sadece karşılaşılan şartlar sağlandığında çalıştırılmalıdır. Python'da **eğer açıklamaları** olarak adlandırılan bir şey olmasının nedeni budur.
 
 **python_intro.py** dosyasındaki kodunuzu şununla değiştirin:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-if 3 > 2:
-```    
+eğer 3 > 2 ise:
+```
 
-Eğer bunu kaydedip çalıştırsaydık şu hatayla karşılaşacaktık:
+Eğer bunu kaydetmiş ve çalıştırmış olsaydık, bunun gibi bir hata görecektik:
 
-```
-$ python3 python_intro.py
-File "python_intro.py", line 2
-         ^
-SyntaxError: unexpected EOF while parsing
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
 
 Python bizden kendisine `3 > 2` durumu (veya `True`) sağlandığında neyi çalıştıracağını söylememizi bekliyor. Python'a "Çalışıyor!" yazmasını söyleyelim. **python_intro.py** dosyanızdaki kodu şununla değiştirin:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-if 3 > 2:
-    print('Çalışıyor!')
-```    
+eğer 3 > 2 ise:
+    print(‘Çalışıyor!’)
+```
 
 4 tane boşluk karakteri bıraktığımıza dikkat ettiniz mi? Bunu yaparak if cümlesine yazdığım durum doğru olduğunda neyi çalıştırması gerektiğini Python'a söylemiş oluyoruz. Aslında tek bir boşlukla da yapabilirsiniz, ama hemen hemen bütün Python programcıları kodlarının temiz görünmesi için 4 boşluk bırakıyor. Tek `tab` karakteri de 4 boşluk yerine geçecektir.
 
 Kaydedip çalıştırmayı deneyelim:
 
-```  
+{% filename %}komut-satırı{% endfilename %}
+
+```python
 $ python3 python_intro.py
 Çalışıyor!
-```    
+```
+
+Not: Windows'ta 'python3'ün komut olarak geçerli olmadığını unutmayın. Bundan böyle dosyayı çalıştırmak için 'python3'ü 'python'la değiştirin.
 
 ### Ya bir koşul True (Doğru) değilse?
 
 Önceki örneklerde kod sadece koşullar sadece True olduğunda çalışıyordu. Ama Python ayrıca `elif` ve `else` ifadelerine de sahip:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-if 5 > 2:    
-    print("5 gerçekten de 2'den büyüktür") 
-else:     
-    print("5  2'den büyük değildir")
-```    
+eğer 5 > 2 ise:
+    print(‘5 gerçekten 2’den büyüktür’)
+Değilse:
+    print(‘5 2’de büyük değildir’)
+```
 
 Bu kod çalıştığında aşağıdaki çıktıyı verecektir:
 
-```
-$ python3 python_intro.py
-5 gerçekten de 2'den büyüktür
-```    
+{% filename %}komut-satırı{% endfilename %}
 
-Eğer 2 5'ten büyük bir sayı olsaydı ikinci komut çalışacaktı. Kolay, değil mi? Şimdi `elif`'in nasıl çalıştığına bakalım:
+    $ python3 python_intro.py
+    5 gerçekten de 2'den büyüktür
+    
+
+Eğer 2 5'ten büyük bir sayı olsaydı, ikinci komut çalıştırılmış olacaktı. Bakalım `elif` nasıl çalışıyor:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
-name = 'Zeynep'
-if name == 'Ayşe':
-    print('Selam Ayşe!')
-elif name == 'Zeynep':
-    print('Selam Zeynep!')
-else:
-    print('Selam yabancı!')
-```    
+isim = ‘Sonja’
+eğer isim == ‘Ola’ ise:
+    print(‘Selam Ola!’)
+elif isim == ‘Sonja’ ise:
+    print(‘Selam Sonja!’)
+değilse:
+    print(‘Selam yabancı!’)
+```
 
 ve çalıştırılınca:
 
-```
-$ python3 python_intro.py
-Selam Zeynep!
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3 python_intro.py
+    Selam Zeynep!
+    
 
 Gördünüz mü? Eğer önceki if cümleleriniz doğru olmazsa kontrol edilmek üzere `elif` cümleleri ekleyebilirsiniz.
 
 `if` cümlenizden sonra istediğiniz kadar `elif` cümlesi ekleyebilirsiniz. Mesela:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-volume = 57
-if volume < 20:
-    print("Çok sessiz.")
-elif 20 <= volume < 40:
-    print("Güzel bir fon müziği")
-elif 40 <= volume < 60:
-    print("Harika, her notayı duyabiliyorum")
-elif 60 <= volume < 80:
-    print("Parti başlasın")
-elif 80 <= volume < 100:
-    print("Biraz gürültülü!")
-else:
-    print("Kulaklarım ağrıyor! :(")
-```   
+volüm = 57
+eğer volüm < 20 ise:
+    print(“Biraz sessiz.”)
+elif 20 <= volüm < 40 ise:
+    print(“Arka plan müziği için güzel“)
+elif 40 <= volüm < 60 ise:
+    print(“Mükemmel, tüm detayları duyabiliyorum“)
+elif 60 <= volüm < 80 ise:
+    print(“Partiler için güzel”)
+elif 80 <= volüm < 100 ise:
+    print(“Biraz gürültülü!”)
+değilse:
+    print(“Kulaklarım ağrıyor! :(")
+```
 
 Python sırayla her sorguyu çalıştırır ve sonucu ona göre yazar:
 
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3 python_intro.py
+    Harika, her notayı duyabiliyorum
+    
+
+## Yorumlar
+
+Yorumlar `#` ile başlayan satırlardır. İstediğiniz her neyse `#` den sonra yazabilirsiniz ve Python onu gözardı eder. Yorumlar kodunuzu diğer insanların anlamasını daha kolaylaştırabilir.
+
+Bakalım nasıl gözüküyor:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Çok yüksek veya çok düşük olduğunda volümü değiştirme
+Eğer volüm < 20 veya volüm > 80 ise:
+    volüm = 50
+    print(“Bu daha iyi!”)
 ```
-$ python3 python_intro.py
-Harika, her notayı duyabiliyorum
-```    
+
+Kodun her satırı için bir açıklama yazmaya ihtiyacınız yoktur, ama kodunuzun niçin birşey yaptığını açıklamak ya da kompleks bir şey yaptığında bir özet sunmak için faydalıdırlar.
 
 ### Özet
 
-Son üç alıştırmada öğrendikleriniz:
+En son yaptığınız alıştırmalarda öğrendikleriniz:
 
-*   **kıyaslama yapmak** - Python'da `>`, `>=`, `==`, `<=`, `<`, `and`, `or` operatörlerini kullanarak kıyaslama yapabiliriz
-*   **Boolean** - İki farklı değer alabilen bir nesne tipidir: Ya `True` (doğru) olur ya da `False` (yanlış)
-*   **Dosya kaydetmek** - kodlarımızı dosyalara kaydederek daha büyük programları çalıştırabiliriz.
-*   **if...elif...else** - cümlelerini sadece belirli durumlar sağlandığında çalıştırmak istediğimiz komutlar için kullanabiliriz.
+- **kıyaslama yapmak** - Python'da `>`, `>=`, `==`, `<=`, `<` ve `ve`, `veya` operatörlerini kullanarak kıyaslama yapabilirsiniz
+- **Boole** – yalnızca iki değerden birini olabilir nesnesi türü: `doğru` veya `yanlış`
+- **Dosya kaydetmek** – kodlarımızı dosyalara kaydederek daha büyük programları çalıştırabiliriz.
+- **if ... elif ... else** - cümlelerini sadece belirli durumlar sağlandığında çalıştırmak istediğimiz komutlar için kullanabiliriz.
+- **yorumlar** - kodunuzu belgelemenize izin verecek şekilde Python’un çalışmayacağı satırlar
 
 Bu bölümün son kısmının zamanı geldi!
 
 ## Kendi fonksiyonlarınız!
 
-Python'daki `len()` gibi fonksiyonları hatırlıyor musunuz? Haberler iyi - artık kendi fonksiyonlarınızı da yazabileceksiniz!
+> Evdeki okuyucular için: Bu kısım [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) videosunda işlenmiştir.
+
+Python'da çalıştırabileceğin `len()` gibi fonksiyonları hatırlıyor musun? Güzel, iyi haber - Şimdi kendi fonksiyonlarını nasıl yazacağını öğreneceksin!
+
+Fonksiyon Python tarafından işlenmesi gereken yönergeler dizisidir. Python'da her fonksiyon `def` anahtar kelimesi ile başlar, bir isim verilir ve bazı parameterleri olabilir. Hadi başlayalım. **python_intro.py** içindeki kodu aşağıdaki ile değiştirelim:
 
-Fonksiyon Python tarafından işlenmesi gereken yönergeler dizisidir. Python'da her fonksiyon `def` anahtar kelimesi ile başlar, bir isim verilir ve bazı parameterleri olabilir. Kolay bir tane ile başlayalım. **python_intro.py** içindeki kodu aşağıdaki ile değiştirelim:
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi():
-    print('Merhaba!')
-    print('Nasılsın?')
-  
+    print('Hi there!')
+    print('How are you?')
+
 hi()
-```    
+```
 
 Tamam, ilk fonksiyonumuz hazır!
 
@@ -679,171 +860,203 @@ Fonksiyon adını neden dosyanın en altına yazdığımızı merak edebilirsini
 
 Haydi şimdi bunu çalıştıralım ve neler olacağını görelim:
 
-```
-$ python3 python_intro.py
-Merhaba!
-Nasılsın?
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3 python_intro.py
+    Merhaba!
+    Nasılsın?
+    
+
+Not: Eğer çalışmadıysa panik yapmayın! Bilgi çıkışı neden olduğu hakkında bir fikir verir:
 
-Bu epey kolaydı! Şimdi parametreli bir fonksiyon yazalım. Bir önceki örneği kullanabiliriz - fonksiyonumuz yine 'merhaba' desin - ama bu sefer ismini de söylesin:
+- Eğer bir `NameError` alırsanız, muhtemelen yanlış bir şey yazdığınız anlamına gelir, bu nedenle `def hi():` lı fonksiyonu oluştururken ve `hi()` lıyı çağırırken aynı adı kullanıp kullanmadığınızı kontrol etmelisiniz.
+- Eğer bir `IndentationError` alırsanız,`print` dizelerinin her ikisinin de satır başında aynı boşluğa sahip olduğunu kontrol et: python fonksiyonun içindeki tüm kodların düzenli bir şekilde hizalanmasını ister.
+- Eğer tamamında da çıktı yoksa, son `hi()` *isn't* girintiliğini kontrol et - eğer öyleyse, bu dize fonksiyonunda bir parçası haline gelecek ve hiçbir zaman çalışmayacak.
+
+İlk fonksiyonumuzu parametrelerle birlikte oluşturalım. Önceki örneği - çalışmaktaki kişiye merhaba diyen bi fonksiyon - ismiyle kullanacağız:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi(name):
-```    
+```
 
 Gördüğünüz gibi, fonksiyonumuza `name` (isim) adında bir parametre ekledik:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
-    if name == 'Ayşe':
-        print('Selam Ayşe!')
-    elif name == 'Zeynep':
-        print('Selam Zeynep!')
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
     else:
-        print('Selam yabancı!')
-    
+        print('Hi anonymous!')
+
 hi()
-```    
+```
 
 Unutmayın: `if` içerisindeki `print` fonksiyonundan önce dört tane boşluk var. Bunun sebebi sadece durum sağlandığında çalışmasını istememiz. Bakalım nasıl çalışıyor:
 
-```
-$ python3 python_intro.py
-Traceback (most recent call last):
-File "python_intro.py", line 10, in <module>
-  hi()
-TypeError: hi() missing 1 required positional argument: 'name'
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
 
 Üzgünüz, bir hata. Neyse ki, Python bize oldukça yararlı bir hata mesajı veriyor. `hi()` fonksiyonun (yukarıda tanımladığımız) bir değişken kullanımını gerektirdiğini (`name` isimli) ve bizim o değişkeni fonksiyonu çağırırken iletmeyi unuttuğumuzu söylüyor. Dosyanın alt kısmında hatayı düzeltelim:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-hi("Ayşe")
-```    
+hi("Ola")
+```
 
 Ve tekrar çalıştıralım:
 
-```
-$ python3 python_intro.py
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3 python_intro.py
     Selam Ayşe!
-```    
+    
 
 Ve eğer ismi değiştirirsek ne olur?
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-hi("Zeynep")
-```    
+hi("Sonja")
+```
 
 Ve çalıştırın:
 
-```
-$ python3 python_intro.py
-Selam Zeynep!
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3 python_intro.py
+    Selam Zeynep!
+    
 
-Peki Ayşe veya Zeynep dışında başka bir isim yazdığımızda ne olacağını tahmin edebiliyor musunuz? Deneyin ve tahmininizin doğru olup olmadığını görün. Şunun gibi bir şey yazmalı:
+Şimdi, eğer oraya başka bir isim yazarsanız ne olacağını düşünüyorsunuz?(Ola veya Sonja değil.) Deneyin ve eğer doğruysa görün. Bunu yazdırması gerekir:
 
-```
-Selam yabancı!
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    Selam yabancı!
+    
+
+Süper değil mi? Böylece fonksiyona göndereceğiniz isim değiştiğinde aynı kodu tekrar tekrar yazmanıza gerek kalmayacak. Ve tam olarak bu nedenle fonksiyonlara ihtiyacımız var- kodunu hiçbir zaman tekrarlamak istemiyorsun!
 
-Süper değil mi? Böylece fonksiyona göndereceğiniz isim değiştiğinde aynı kodu tekrar tekrar yazmanıza gerek kalmayacak. İşte fonksiyonlara tam da bu yüzden ihtiyacımız var - aynı kodu tekrar yazmaya gerek yok!
+Hadi daha zekice bir şey yapalım - İkiden fazla isim var ve her biri için bir şart yazmak zor olur değil mi?
 
-Hadi daha akıllıca bir şeyler yapalım -- tabii ki ikiden fazla isim var ve her isim için bir kontrol yazmak zor olurdu, değil mi?
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi(name):
-    print('Selam ' + name + '!')
-    
-hi("Seda")
-```    
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
 
 Şimdi kodu çağıralım:
 
-```
-$ python3 python_intro.py
-Selam Seda!
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3 python_intro.py
+    Selam Seda!
+    
 
 Tebrikler! Az önce fonksiyonları nasıl yazacağınızı öğrendiniz! :)
 
 ## Döngüler
 
+> Evdeki okuyucular için: Bu kısım [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) videosunda işlenmiştir.
+
 Bu da zaten son parça. Hızlı oldu, değil mi? :)
 
 Programcılar kendilerini tekrar etmeyi sevmezler. Programlama tamamen işleri otomatize etmedir, bu yüzden her insanı ismiyle selam istemeyiz, değil mi? İşte burası döngülerin devreye girdiği yerdir.
 
 Hala listeleri hatırlıyoruz değil mi? Haydi bir kızlar listesi yapalım:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-girls = ['Seda', 'Gül', 'Pınar', 'Ayşe', 'Sen']
-```    
+kızlar = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'Sen']
+```
 
 Diyelim ki hepsine merhaba demek istiyoruz. Az önce yazdığımız `hi` fonksiyonunu döngü içinde kullanabiliriz:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
-for name in girls:
-```    
+kızlar içindeki isimler:
+```
 
-~~~ for~~~ cümlesi ~~~ if~~~ cümlesine benzer davranır; ikisi için de dört boşluk karakterine ihtiyacımız car.
+The ```için``` ifade şunlara benzer davranış gösteriyor ```eğer``` ifade: aşağıdaki kodların ikiside girintili ve dört boşluk olması lazım.
 
 Dosyada yer alacak tam kod aşağıdadır:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
-    print('Selam ' + name + '!')
-    
-girls = ['Seda', 'Gül', 'Pınar', 'Ayşe', 'Sen']
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
 for name in girls:
     hi(name)
-    print('Sıradaki')
-```    
+    print('Next girl')
+```
 
 Ve onu çalıştırdığımız zaman:
 
-```
-$ python3 python_intro.py
-Selam Seda!
-Sıradaki
-Selam Gül!
-Sıradaki
-Selam Pınar!
-Sıradaki
-Selam Ayşe!
-Sıradaki
-Selam Sen!
-Sıradaki
-```
+{% filename %}komut-satırı{% endfilename %}
+
+    $ python3 python_intro.py
+    Selam Seda!
+    Sıradaki
+    Selam Gül!
+    Sıradaki
+    Selam Pınar!
+    Sıradaki
+    Selam Ayşe!
+    Sıradaki
+    Selam Sen!
+    Sıradaki
+    
 
 Gördüğünüz gibi, `for` cümlesinin içine boşluk karakteri ile koyduğunuz her şey `girls` listesi için tekrarlanıyor.
 
 Ayrıca `for`'u `range` fonksiyonuyla beraber sayılar üzerinde de kullanabilirsiniz:
 
-```
+{% filename %}python_intro.py{% endfilename %}
+
+```python
 for i in range(1, 6):
     print(i)
-```    
+```
 
 Çalıştırırsak:
 
-```
-1
-2
-3
-4
-5
-```    
+{% filename %}komut-satırı{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
 
 `range` fonksiyonu birbirini takip eden sayılardan bir liste oluşturur (bu sayıları da siz parametre olarak yazarsınız).
 
-Sizin verdiğiniz ikinci parametrenin listede olmadığına dikkat edin. Yani `range(1, 6)` 1'den 5'e kadar sayıyor, 6 dahil edilmiyor. Çünkü "range" yarı-açık bir aralık ifade ediyor, yani ilk sayı dahil ediliyor ama sondaki sayı dahil edilmiyor.
+Sizin verdiğiniz ikinci parametrenin listede olmadığına dikkat edin. Yani `range(1, 6)` 1'den 5'e kadar sayıyor, 6 dahil edilmiyor. Yani çünkü “aralık” yarı açıktır, ve yani ilk değeri içerir, ama son değeri içermez.
 
 ## Özet
 
 İşte bu. **Harikasın, süpersin!** Bu bölüm biraz zordu, kendinle gurur duymalısın. Biz buraya kadar geldiğin için seninle gurur duyuyoruz!
 
-Bir sonraki bölüme geçmeden önce kısa bir süreliğine başka birşey yapmak isteyebilirsiniz - esneyin, biraz etrafı dolaşın, gözlerinizi dinlendirin :)
-
-![Kek][3]
+Kısa bir süreliğine başka bir şey yapmak isteyebilirsin - gerin, biraz etrafta dolan, gözlerini dinlendir - sonraki bölüme geçmeden önce. :)
 
- [3]: images/cupcake.png
+![Kek](images/cupcake.png)
\ No newline at end of file
diff --git a/tr/signup_pythonanywhere.md b/tr/signup_pythonanywhere.md
new file mode 100644
index 00000000000..76a51e9ffc5
--- /dev/null
+++ b/tr/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Sırada PythonAnywhere sitesinde bedava bir "Beginner" ( yeni başlayan) hesabı açma işi var.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/tr/template_extending/README.md b/tr/template_extending/README.md
index 9d799cafd28..82c3b50c056 100755
--- a/tr/template_extending/README.md
+++ b/tr/template_extending/README.md
@@ -2,29 +2,30 @@
 
 Django'nun size sunduğu başka bir güzellik de **template genişletmek**tir. O da ne demek? Şu demek, HTML dosyanızın bazı bölümlerini birden fazla sayfanızda kullanabilirsiniz.
 
-Böylece aynı bilgi/yerleştirmeyi kullanmak istediğinizde her dosyada kendinizi tekrar etmenize gerek kalmaz. Ve bir değişiklik yapmak istediğinizde bunu bütün template dosyalarında yapmanıza gerek kalmaz, bir kere değiştirmek yeterlidir!
+Templatelar aynı bilgiyi ya da yerleştirmeyi (layout) birden fazla yerde kullanmak istediğinizde yardım ederler. Yaptığınızı her dosya için tekrar etmek zorunda kalmazsınız. Ve bir şey değiştimek isterseniz, tüm templatelarda değil sadece bir tanesinde değiştirirsiniz!
 
-## Temel template oluşturun
+## Bir Temel Template Oluştur
 
 Temel template web sitenizin bütün sayfalarında genişletebileceğiniz en temel template'inizdir.
 
 Şimdi `blog/templates/blog/` klasörü içinde `base.html` adlı bir dosya oluşturalım:
 
-```
-blog
-└───templates
-    └───blog
-            base.html
-            post_list.html
-```    
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
 
 Sonra bunu açalım ve `post_list.html` dosyasındaki her şeyi aşağıdaki gibi bu `base.html`'ye kopyalayalım:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
     <head>
-        <title>Django Girls blog</title>
+        <title>Django Girls Blog</title>
         <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
         <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
         <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
@@ -34,28 +35,30 @@ Sonra bunu açalım ve `post_list.html` dosyasındaki her şeyi aşağıdaki gib
         <div class="page-header">
             <h1><a href="/">Django Girls Blog</a></h1>
         </div>
-  
+
         <div class="content container">
             <div class="row">
                 <div class="col-md-8">
                 {% for post in posts %}
                     <div class="post">
                         <div class="date">
-                            {{ post.yayinlanma_tarihi }}
+                            {{ post.published_date }}
                         </div>
-                        <h1><a href="">{{ post.baslik }}</a></h1>
-                        <p>{{ post.yazi|linebreaks }}</p>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
                     </div>
                 {% endfor %}
                 </div>
             </div>
         </div>
     </body>
- </html>
-```   
+</html>
+```
 
 Sonra, `base.html` dosyasındaki `<body>`'nizi (`<body>` ve `</body>` arasında kalan her şeyi) şununla değiştirin:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <body>
     <div class="page-header">
@@ -70,55 +73,75 @@ Sonra, `base.html` dosyasındaki `<body>`'nizi (`<body>` ve `</body>` arasında
         </div>
     </div>
 </body>
-```    
+```
 
-Aslında sadece `{% for post in posts %}{% endfor %}` arasındaki her şeyi şununla değiştirmiş olduk:
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% block content %}
 {% endblock %}
-```    
+```
 
-Peki bu ne anlama geliyor? Az önce bir template etiketi olan `block`'u kullanarak bir blok oluşturdunuz. Diğer template'leri bu bloğun içine HTML ekleyerek `base.html`'yi genişletebilirsiniz. Bunun nasıl yapıldığını da hemen göstereceğiz.
+Ama neden? Bir `blok` oluşturdunuz! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). Bunun nasıl yapıldığını da hemen göstereceğiz.
 
-Şimdi bunu kaydedin ve tekrar `blog/templates/blog/post_list.html` dosyanızı açın. Body içinde kalanlar hariç her şeyi silin. Ve ayrıca `<div class="page-header"></div>` bölümünü de silin. Dosyanız şöyle görünecektir:
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
     <div class="post">
         <div class="date">
-            {{ post.yayinlanma_tarihi }}
+            {{ post.published_date }}
         </div>
-        <h1><a href="">{{ post.baslik }}</a></h1>
-        <p>{{ post.yazi|linebreaks }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
     </div>
 {% endfor %}
-```    
+```
 
-Ve şimdi şu satırı sayfanın başına ekleyin:
+Bunu, bütün içerik blokları için şablonumuzun bir parçası olarak kullanmak istiyoruz. Şimdi bu dosyaya blok etiketleri ekleme zamanı!
 
-```  
-{% extends 'blog/base.html' %}
-```    
+{% raw %}You want your block tag to match the tag in your `base.html` file. Ayrıca içerik bloklarınına ait bütün koduda dahil etmek istiyorsun. Bunu yapmak için, herşeyi `{% block content %}`ve`{% endblock %}`'un arasına yerleştir. Şunun gibi:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Geriye tek birşey kaldı. Bu iki şablonu birbirine bağlamamız gerekiyor. Genişleyen şablonlar tam da bununla ilgili! Bunu dosyanın başlangıcına genişleyebilir etiketler ekleyerek yapacağız. Bunun gibi:
 
-{% raw %}Bu şu anlama geliyor: `post_list.html` dosyasında `base.html` template'i genişletiyoruz. Sadece bir şey kaldı: Her şeyi (en son eklediğimiz satır hariç) `{% block content %}` ve `{% endblock %}` arasına koyun. Şunun gibi:{% endraw %}
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
-    
+
 {% block content %}
     {% for post in posts %}
         <div class="post">
             <div class="date">
-                {{ post.yayinlanma_tarihi }}
+                {{ post.published_date }}
             </div>
-            <h1><a href="">{{ post.baslik }}</a></h1>
-            <p>{{ post.yazi|linebreaks }}</p>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
         </div>
     {% endfor %}
 {% endblock %}
-```    
+```
 
-İşte bu! Sitenizin hala düzgün çalışıp çalışmadığını kontrol edin :)
+İşte bu! Sitenizin hala düzgün çalışıp çalışmadığını kontrol edin. :)
 
-> `blog/base.html` dosyası olmadığını söyleyen bir `TemplateDoesNotExists` hatası alıyorsanız, ve `runserver` konsolda çalışmaya devam ediyorsa Ctrl ve C butonlarına aynı anda basarak durdurmaya çalışın. Ve `python manage.py runserver` komutu ile yeniden başlatmayı deneyin.
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/tr/whats_next/README.md b/tr/whats_next/README.md
index 28e3a6a3da4..2e6d07b2f3a 100755
--- a/tr/whats_next/README.md
+++ b/tr/whats_next/README.md
@@ -6,35 +6,20 @@ Kendini tebrik et! **Kesinlikle harikasın**. Seninle gurur duyuyoruz! <3
 
 Bir ara ver ve rahatla. Gerçekten çok büyük bir şey yaptın.
 
-Bundan sonra şunları yaptığına emin ol:
+Sonra, güncel kalmak için Django Girls'ü [Facebook](http://facebook.com/djangogirls) ya da [Twitter](https://twitter.com/djangogirls) da takip ettiğinizden emin olun.
 
-*   Güncel kalmak için Django Girls'ü [Facebook][1] ya da [Twitter][2] dan takip et
+### Daha geniş kapsamlı kaynaklar önerebilir misiniz?
 
- [1]: http://facebook.com/djangogirls
- [2]: http://twitter.com/djangogirls
+Evet! İlk olarak, devam et ve diğer kitabımız [Django Girls: Uzantılar](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/) kitabımızı dene.
 
-### Daha geniş kapsamlı kaynaklar önerebilir misiniz?
+Daha sonra, aşağıdaki listedeki kaynakları deneyebilirsin. Hepsi birden çok önerilir!
 
-Evet! Öncelikle [Django Girls Tutorial: Extensions][3] isimli diğer kitabımızı dene.
-
- [3]: https://tutorial-extensions.djangogirls.org
-
-Sonra ise aşağıda listelenen diğer kaynakları deneyebilirsin. Hepsini öneriyoruz!
-
-- [Django'nun resmi eğitimi][4]
-- [Kodlamaya Yeni Başlayan (New Coder) eğitimi][5]
-- [Code Academy Python kursu][6]
-- [Code Academy HTML & CSS kursu][7]
-- [Django Carrots eğitimi][8]
-- [Learn Python The Hard Way kitabı][9]
-- [Getting Started With Django görünütülü dersleri][10]
-- [Two Scoops of Django: Best Practices for Django 1.8 kitabı][11]
-
- [4]: https://docs.djangoproject.com/en/1.11/intro/tutorial01/
- [5]: http://newcoder.io/tutorials/
- [6]: http://www.codecademy.com/en/tracks/python
- [7]: http://www.codecademy.com/tracks/web
- [8]: http://django.carrots.pl/en/
- [9]: http://learnpythonthehardway.org/book/
- [10]: http://www.gettingstartedwithdjango.com/
- [11]: http://twoscoopspress.com/products/two-scoops-of-django-1-8
+- [Resmi Django eğitimi](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [Yeni başlayan eğitimleri](http://newcoder.io/tutorials/)
+- [Code Academy Python kursu](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS kursu](https://www.codecademy.com/tracks/web)
+- [Django Carrots eğitimi](https://github.com/ggcarrots/django-carrots)
+- [Django'yu Zor Yoldan Öğren kitabı](http://learnpythonthehardway.org/book/)
+- [Django Video Dersleriyle Başlangıç](http://www.gettingstartedwithdjango.com/)
+- [2 Kaşık Django 1.11: Django Web Framework'ün En İyi Uygulamaları Kitabı](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/uk-UA/GLOSSARY.md b/uk-UA/GLOSSARY.md
new file mode 100644
index 00000000000..a5c11c32bd2
--- /dev/null
+++ b/uk-UA/GLOSSARY.md
@@ -0,0 +1,3 @@
+# Редактор коду
+
+Редактор коду - це додаток, що дозволяє зберегти ваш код, так що можна повернутися до його редагування пізніше. Ви можете дізнатися, де його знайти у розділі [Редактор коду](./code_editor/README.md)
\ No newline at end of file
diff --git a/uk-UA/README.md b/uk-UA/README.md
new file mode 100644
index 00000000000..806676d959c
--- /dev/null
+++ b/uk-UA/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. Щоб переглянути копію цієї ліцензії, відвідайте https://creativecommons.org/licenses/by-sa/4.0/
+
+## Вітаємо
+
+Вітаємо у посібнику Django Girls! Ми раді вас тут бачити. :)  В цьому курсі ви побачите із середини, як працюють вебтехнології. Ми пропонуємо вам огляд усіх шматочків, які мають об'єднатись разом, щоб зробити мережу такою, як ми її знаємо.
+
+Як і з усім невідомим, це буде пригодою - але не хвилюйтесь, бо якщо у вас вистачило сміливості бути тут, ви впораєтесь. :)
+
+## Вступ
+
+Чи ви колись відчували, що світ крутиться все більше і більше навколо технологій, про які ви (поки) нічого не знаєте? Чи вас колись цікавило, як створити вебсайт, але ніколи не вистачало достатньої мотивації, щоб почати? Чи ви колись вважали, що світ програмування є занадто складним для вас, щоб навіть пробувати робити щось самостійно?
+
+Що ж, маємо гарні новини для вас! Програмування - це не так складно, як може здаватися, і ми хочемо вам показати, наскільки веселим може бути цей процес.
+
+Даний навчальний посібник не перетворить вас магічним чином на програмістку. Якщо ви хочете розбиратися у цьому, то вам потрібні місяці або навіть роки навчання та практики. Але, наша мета показати вам, що програмування або створення вебсайтів не таке складне, як здається. Ми будемо намагатись так добре пояснити різні уривки та частини, як тільки зможемо, тож технології вас не лякатимуть.
+
+Сподіваємось, що нам вдасться зробити так, щоб ви любили технологію як любимо її ми!
+
+## Що ви вивчите під час освоєння посібника?
+
+По завершенню даного посібника, ви будете мати простий, робочий вебдодаток: свій власний блог. Ми покажемо вам, як опублікувати його в інтернеті, тож інші також зможуть оцінити вашу роботу!
+
+Це буде (більшою чи меншою мірою) виглядати таким чином:
+
+![Figure 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 workshop, але ми розуміємо, що не завжди є можливість його відвідати. Тому ми за те, щоб ви намагались проходити цей посібник вдома. Для тих, хто навчається вдома, ми зараз готуємо відео, які можуть спростити використання посібника самостійно. Вони досі знаходяться в розробці, але з часом все більше цікавих речей можна буде знайти на каналі [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) в YouTube.
+
+У кожному розділі, що вже готовий, є посилання на відповідне відео.
+
+## Про проєкт та як долучитись
+
+Цей посібник підтримується спільнотою [DjangoGirls](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/), будь ласка, відкрийте нову тему</0>, що інформує про мову, таким чином ми зможемо додати її.</p>
\ No newline at end of file
diff --git a/uk-UA/SUMMARY.md b/uk-UA/SUMMARY.md
new file mode 100644
index 00000000000..a333ad851f4
--- /dev/null
+++ b/uk-UA/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-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Встановлення (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)
\ No newline at end of file
diff --git a/uk-UA/chromebook_setup/README.md b/uk-UA/chromebook_setup/README.md
new file mode 100644
index 00000000000..bb68184b1b7
--- /dev/null
+++ b/uk-UA/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Налаштування на Chromebook
+
+> **Примітка** Якщо Ви вже опрацювали [кроки інсталяції](../installation/README.md), то немає потреби повторювати ці дії – переходьте прямо до [Знайомство з Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/uk-UA/chromebook_setup/instructions.md b/uk-UA/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..bad033a7a51
--- /dev/null
+++ b/uk-UA/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Ви можете [перейти у цей розділ](http://tutorial.djangogirls.org/en/installation/#install-python), якщо ви не використовуєте Chromebook. Якщо ви використовуєте Chromebook, процес встановлення може відрізнятись. Ви можете ігнорувати інші інструкції з установки.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE це інструмент який надає вам редактор коду та доступ до комп'ютера в мережі Інтернет де ви можете встановлювати, писати та запускати програми. Протягом курсу, сloud IDE буде виконувати функцію вашого *локального ком'ютера*. Ви будете запускати команди в терміналі як і ваші одногрупники на OS X, Ubuntu або Windows, але ваш термінал буде керувати комп'ютером виділеним для вас Cloud IDE. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Ви можете обрати одне з cloud IDE і використовувати інструкції для нього.
+
+#### PaizaCloud Cloud IDE
+
+1. Перейдіть на [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Зареєструйтесь
+3. Клікніть «*New Server*» та виберіть «Django app»
+4. Натисніть на кнопку Terminal (в лівій частині вікна)
+
+Тепер ви маєте побачити інтерфейс з боковою панеллю так кнопками зліва. Натисніть кнопку Terminal щоб відкрити вікно терміналу з наступним виводом:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+Термінал на PaizaCloud IDE готовий до ваших інструкцій. Ви можете змінити розмір або максимізувати це вікно, щоб зробити його трохи більшим.
+
+#### AWS Cloud9
+
+В даний час Cloud 9 вимагає зареєструватися за допомогою AWS і ввести інформацію кредитної карти.
+
+1. Встановити Cloud 9 з [веб-магазину Chrome](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. У панелі Cloud9 натисніть *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 $
+    
+
+Ця нижня область є вашим терміналом. Ви можете використовувати термінал, щоб відправляти інструкції на віддалений комп'ютер Cloud9. Ви можете змінити розмір вікна, щоб зробити його трохи більшим.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Віртуальне середовище
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/uk-UA/code_editor/README.md b/uk-UA/code_editor/README.md
new file mode 100644
index 00000000000..38b3040be03
--- /dev/null
+++ b/uk-UA/code_editor/README.md
@@ -0,0 +1,11 @@
+# Редактор коду
+
+> Для читачів вдома: відеоверсія цього розділу (разом із попереднім) - [Встановлення Python та редактора коду](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) (англ.).
+
+Наближаємось до написання нашого першого рядка коду, отже настав час завантажити редактор коду!
+
+> **Примітка:** Якщо ви використовуєте хромбук, пропустіть цей розділ і переконайтеся, що ви слідуєте інструкції [ Встановлення (хромбук)](../chromebook_setup/README.md). Вибраний вами хмарний IDE (PaizaCloud Cloud IDE або AWS Cloud9) включає в себе редактор коду, і коли ви відкриваєте файл в IDE з меню Файл, ви автоматично запускаєте редактор.
+> 
+> **Примітка:** Ви могли вже зробити це у розділі "Встановлення" – якщо так, можете одразу перейти до наступного розділу!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/uk-UA/code_editor/instructions.md b/uk-UA/code_editor/instructions.md
new file mode 100644
index 00000000000..eef5bf5520d
--- /dev/null
+++ b/uk-UA/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Серед великого різноманіття редакторів вибір залежить від особистих вподобань. Більшість програмістів Python користуються комплексними і дуже потужними IDE (англ. Integrated Development Environments - Інтегровані середовища розробки), наприклад, PyCharm. Хоча новачкам, мабуть, вони не дуже підходять; ми рекомендуємо такі ж потужні, але значно простіші. 
+
+Нижче наведено наші пропозиції, але не соромтесь запитати вашого наставника якими є його вподобання - простіше буде отримувати допомогу від нього.
+
+## Visual Studio Code
+
+Visual Studio Code - це редактор для написання коду, який розробив Microsoft для Windows, Linux та macOS. Він включає підтримку налагодження, вбудоване керування Git, підсвітку синтаксису, інтелектуальне завершення коду, сніппети та рефакторинг коду.
+
+[Завантаження тут](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit - це безкоштовний редактор з відкритим кодом, що доступний для всіх операційних систем.
+
+[Завантаження тут](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text - це дуже популярний редактор із безкоштовним періодом оцінювання та є доступним для всіх операційних систем.
+
+[Завантаження тут](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom - ще один поширений редактор. Він безкоштовний, має відкритий вихідний код та доступний для Windows, OS X та Linux. Atom розробили в [GitHub](https://github.com/).
+
+[Завантаження тут](https://atom.io/)
+
+## Яка причина встановлення редактора коду?
+
+Ви, мабуть, дивуєтесь чому ми інсталюємо особливе ПЗ редактора коду, замість того щоб використовувати щось на зразок Word або Notepad.
+
+По-перше, код має бути **простим текстом**, а проблема програм як Word або Textedit в тому, що вони загалом не створюють простий текст, вони створюють форматований текст (що має шрифти та форматування), використовуючи нестандартні формати на зразок [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+По-друге, редактори коду мають спеціалізацію - редагування коду, вони забезпечують вас корисними функціями на зразок кольорової підсвітки коду відповідно його значення або автоматичного закриття дужок.
+
+Пізніше ми побачимо як це працює. Незабаром свій старий вірний редактор коду ви сприйматимете як один зі своїх улюблених інструментів. :)
\ No newline at end of file
diff --git a/uk-UA/css/README.md b/uk-UA/css/README.md
new file mode 100644
index 00000000000..56976c283fd
--- /dev/null
+++ b/uk-UA/css/README.md
@@ -0,0 +1,330 @@
+# CSS робить речі красивими!
+
+Наш блог все ще виглядає доволі жахливо, чи не так? Час зробити його гарним! Для цього будемо використовувати CSS.
+
+## Що таке CSS?
+
+Каскадні таблиці стилів (CSS) - це мова, яка використовується для опису вигляду та форматування веб-сайту, написаного на мові розмітки (наприклад, HTML). Розгляньте це як макіяж для нашої веб-сторінки. ;) 
+
+Але ми не хочемо починати з нуля, чи не так? Ще раз повторюємо: ми будемо використовувати те, що програмісти випускають в Інтернеті безкоштовно. Ви знаєте, що винаходити велосипед не весело.
+
+## Скористаємось Bootstrap!
+
+Bootstrap - це один з найпопулярніших HTML-і CSS-рамок для розробки гарних веб-сайтів: https://getbootstrap.com/
+
+Це було написано програмістами, які працювали у Twitter. Тепер вона розроблена для волонтерів з усього світу!
+
+## Встановлюємо Boostrap
+
+Для встановлення початкового завантаження, відкрийте файл `. HTML` файл у редакторі коду і додати його в розділі `<head>`»:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Це не додасть жодного файлу до вашого проекту. Натомість ці рядки просто вказують на файли опубліковані в інтернеті. Отже далі просто , відкрийте свій веб-сайт і оновіть сторінку. Ось так!
+
+![Рисунок 14.1](images/bootstrap1.png)
+
+Вже краще!
+
+## Статичні файли в Django
+
+Нарешті, ми детальніше розглянемо те, що ми називали **статичними файлами**. Статичні файли - це всі ваші CSS та зображення. Їх зміст не залежить від контексту запиту і буде однаковим для кожного користувача.
+
+### Де помістити статичні файли для Django
+
+Як ви бачили, коли ми запускали collectstatic на сервері, Django вже знає, де знайти статичні файли для вбудованого додатку "admin". Тепер нам просто потрібно додати деякі статичні файли для нашого власного додатку, `blog`.
+
+Створимо директорію з ім’ям `static` всередині додатку blog:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django автоматично знайде всі папки, які називаються "статичними", в папках з будь-якими вашими додатками, і він буде мати можливість використовувати їх вміст як статичні файли.
+
+## Ваш перший CSS файл!
+
+Let's create a CSS file now, to add your own style to your web page. Створіть нову папку з назвою `css` всередині вашої папки `static`. Потім всередині цієї папки`css` створіть новий файл з назвою `blog.css`. Готові?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Настав час написати CSS! Відкрийте файл `static/css/blog.css` в обраному редакторі коду.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+Але принаймні попрацюємо трохи. Maybe we could change the color of our headers? Щоб зрозуміти кольори, комп'ютери використовують спеціальні коди. Ці коди починаються з `#` та складаються з шести літер (A-F) та цифр (0-9). Наприклад, код синього це `#0000FF`. Ви можете знайти інші коди тут: http://www.colorpicker.com/. Також можете користуватися вже [визначеними кольорами ](http://www.w3schools.com/colors/colors_names.asp), такими як `red` та `green`.
+
+У вашому файлі `static/css/blog.css` потрібно додати наступний код:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` -- CSS селектор. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+В CSS файлі ми визначаємо стилі для елементів файлу HTML. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class і id -- імена, які ви присвоюєте елементам власноруч. Класи (сlasses) визначають групи елементів, а ідентифікатори (id), в свою чергу, вказують на специфічні елементи. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. Ми щойно повідомили наш шаблон де розташовані наші CSS файли.
+
+Тепер ваш файл має виглядати наступним чином:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, збережіть файл і перезавантажте сторінку!
+
+![Рисунок 14.2](images/color2.png)
+
+Чудова робота! Можливо, ми також хотіли б дати нашому веб-сайту трохи повітря і збільшити відступ зліва? Давайте спробуємо!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Рисунок 14.3](images/margin2.png)
+
+Можливо, ми могли б також налаштувати шрифт нашого заголовка? Вставте це всередину розділу `<head>` файлу `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Рисунок 14.3](images/font.png)
+
+Чудово!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+А тепер додамо визначення блоків для різних селекторів. Селектори, які починають із символу `.` стосуються класів. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Далі модифікуйте HTML код, що відображує пости. Замініть:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+в `blog/templates/blog/post_list.html` на:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Збережіть файли і перезавантажте свій сайт.
+
+![Рисунок 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Готові до наступного розділу?! :)
\ No newline at end of file
diff --git a/uk-UA/deploy/README.md b/uk-UA/deploy/README.md
new file mode 100644
index 00000000000..a999173e432
--- /dev/null
+++ b/uk-UA/deploy/README.md
@@ -0,0 +1,246 @@
+# Розгортання!
+
+> **Зауваження** Цей розділ інколи може бути дещо складним для освоєння. Наполегливо продовжуйте і дійдіть до кінця; розгортання -- важлива частина процесу розробки веб-сайту. Цей розділ розташований посередині посібника, щоб ваш наставник зміг допомогти із дещо хитрим процесом випуску веб-сайту в Інтернет. Це означає, що ви все ще можете завершити цей курс самостійно, якщо раптом не встигаєте. 
+
+До цього часу, ваш вебсайт бул лише на вашому комп’ютері. Тепер прийшов час навчитися як розгорнути його (задеплоїти)! Розгортання -- це процес публікації вашого додатку в Інтернеті таким чином, що люди можуть зрештою зайти і побачити його. :)
+
+Як ви вже знаєте, веб-сайт має бути розміщений на сервері. В Інтернеті є багато хостингів (server providers), ми ж будемо використовувати [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere безкоштовний для малих додатків, в яких не дуже багато користувачів, тож нам цього точно буде достатньо.
+
+Інший зовнішній інструмент, який ми будемо використовувати - це [GitHub](https://www.github.com), платформа для розміщення коду. У нього є альтернативи, але майже кожен програміст зараз має GitHub профіль, і скоро ви будете серед них!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Створення свого Git репозиторію
+
+Git відслідковує зміни певних файлів в репозиторії коду (коротко – "репо"). Давайте створимо "репо" для нашого проекту. Відкрийте вашу консоль та запустіть наступні команди в папці `djangogirls`:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. Ви маєте бути в папці `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git стежитиме за змінам у всіх файлах у цій директорії, але є певні файли які ми хочемо ігнорувати. Ми зробимо це шляхом створення файлу з назвою `.gitignore` в базової директорії. Відкрий свій редактор і створити новий файл з наступним змістом:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+І збережи його як `.gitignore` в базовій директорії "djangogirls".
+
+> **Примітка** Крапка на початку імені файлу важлива! У разі виникнення будь-яких труднощів при створенні (наприклад Mac не любить коли створюють файли, імена яких починаються з крапки через Finder), тоді використати "Зберегти як" у редакторі, це повинно спрацювати. І впевніться, що не додали `.txt`, `.py` або будь-які інші розширення до імені файлу. Для Git потрібно саме назва `.gitignore`, так він її розпізнає. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+Перед тим як виконати команду `git add` (також, коли ви просто не впевненні що змінилось) непоганою ідеєю буде виконати `git status`. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Зрештою, зберігаємо наші зміни. Перейдіть до консолі і виконайте наступні команди:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}командний рядок PythonAnywhere{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/uk-UA/deploy/install_git.md b/uk-UA/deploy/install_git.md
new file mode 100644
index 00000000000..acdc283691e
--- /dev/null
+++ b/uk-UA/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git - це "система контролю версій", яка використовується багатьма розробниками. Ця програма дозволяє відслідковувати зміни до файлів з часом так, що ви можете повернутись до певних версій пізніше. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Встановлення Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+Ви можете завантажити Git з [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Крім цього, стандартні налаштування добрі. Вимкніть закінчення рядків в стилі Windows, ввімкніть в стилі Unix, вони кращі.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/uk-UA/deploy/signup_pythonanywhere.md b/uk-UA/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/uk-UA/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/uk-UA/django/README.md b/uk-UA/django/README.md
new file mode 100644
index 00000000000..c0765552f2b
--- /dev/null
+++ b/uk-UA/django/README.md
@@ -0,0 +1,27 @@
+# Що таке Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. Веб фреймворк - набір компонентів, які допомагають розробляти веб-сайти швидше і простіше.
+
+При побудові веб-сайту, ви завжди потребуєте схожого набору компонентів: способу управління авторизацією користувача (створення акаунту, вхід, вихід), панелі управління, форм, способу завантажити файли, тощо.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Навіщо вам потрібен фреймворк?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Уявіть собі поштову скриньку (порт), котра моніториться на вхідні листи (запити). Це здійснюється веб сервером. The web server reads the letter and then sends a response with a webpage. Але коли ви бажаєте відправити дещо, вам потрібно мати деякий вміст. І Django є інструментом, котрий допомагає вам створити цей контент.
+
+## Що трапляється коли хтось надсилає запит на веб-сайт з вашого серверу?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Уявіть листоношу з листом. Вона йде по вулиці і звіряє номер кожного будинку з тим що вказаний в адресі отримувача. Якщо номер співпадає, вона кладе листа в скриньку. Аналогічним чином працює urlresolver!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Можливо, користувач може попросити зробити певні зміни даних? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/uk-UA/django_admin/README.md b/uk-UA/django_admin/README.md
new file mode 100644
index 00000000000..a08d952e40e
--- /dev/null
+++ b/uk-UA/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django адміністратор
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Як можна побачити, ми імпортуємо (включаємо) модель посту Post визначену у попередньому розділі. Щоб зробити нашу модель видимою на сторінці адміністратора, потрібно зареєструвати модель за допомогою `admin.site.register(Post)`.
+
+Гаразд, час поглянути на нашу модель Post. Не забудьте виконати в консолі команду `python manage.py runserver` для того щоб запустити сервер. Go to your browser and type the address http://127.0.0.1:8000/admin/. Ви побачите сторінку входу наступного зразку:
+
+![Сторінка авторизації](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/uk-UA/django_forms/README.md b/uk-UA/django_forms/README.md
new file mode 100644
index 00000000000..502ee09016c
--- /dev/null
+++ b/uk-UA/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django форми
+
+Остання річ, яку б ми хотіли зробити з нашим сайтом це створити зручний спосіб додавати і редагувати пости. Django адміністратор це звісно круто, але водночас він є досить складним для налаштування. За допомогою форм ми матимемо абсолютний контроль над нашим інтерфейсом - ми можемо робити майже все, що тільки можемо собі уявити!
+
+Що тішить стосовно Django форм так це те, що останні можна визначати як з нуля так і створювати засобами `ModelForm`, що зберігають результат форми всередині моделі.
+
+Це саме те, що нам потрібно: створимо форму для нашої моделі `Post`.
+
+Як і кожна важлива складова Django, форми мають свій власний файл: `forms.py`.
+
+Потрібно створити файл із заданим ім'ям в папці `blog`.
+
+    blog
+       └── forms.py
+    
+
+Гаразд, давайте відкриємо його в редакторі коду і наберемо такий код:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+Спочатку нам потрібно імпортувати форми Django (`from django import forms`) та нашу модель (`from .models import Post`).
+
+`PostForm`, як ви можливо зазначили, ім'я нашої форми. Нам потрібно сказати Django, що ця форма є `ModelForm` ( тому Django зробить для нас трішки магії ) – ` і рядок.ModelForm` відповідає за це.
+
+Далі, у нас є `class Meta`, де ми вказуємо для Django котра з моделей має бути використана для створення форми (`model = Post`).
+
+Зрештою, можемо зазначити якими полями має закінчуватись наша форма. У цьому сценарії ми хочемо опублікувати такі параметри як заголовок `title` і зміст `text`, дані про автора `author`, що автоматично встановлюються як дані особи, яка наразі увійшла в систему (тобто ви!), а також дата створення `created_date`, яка автоматично встановлюється при створенні публікації (тобто в коді), вірно ж?
+
+І це все! Все що нам потрібно тепер зробити це використати форму в блоці *view* і відобразити її в шаблоні.
+
+То ж ще раз ми створимо посилання на сторінку, URL- адресу, вид і шаблон.
+
+## Посилання на сторінку з формою
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+шлях('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Шаблон
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* Ми маємо відобразити форму. Можемо це зробити, наприклад, за допомогою {% raw %}`{{ form.as_p }}`{% endraw %}. 
+* Вказаний рядок має бути розміщений всередині тега форми HTML: `<form method="POST">...</form>`.
+* Нам знадобиться кнопка "Зберегти" - `Save`. Створимо її в HTML за допомогою виразу `<button type="submit">Save</button>`.
+* І нарешті зразу після відкриття тегу форми `<form ...>` потрібно додати {% raw %}`{% csrf_token %}`{% endraw %}. Це дуже важливо з міркувань безпеки вашої форми! Якщо ви раптом забудете про цю деталь, Django поскаржиться, коли будете намагатися зберегти форму:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Зберігання форми
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Безпека
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Ще одне: розгортання!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* Спочатку зафіксуйте свій новий код і зробіть його на GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Додано подання для створення / редагування публікації в блозі сайту."
+    $ git push
+    
+
+* Тоді, в [bash консолі PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Нарешті, перейти на сторінку ["Web"](https://www.pythonanywhere.com/web_app_setup/) ( використати кнопку меню у верхньому правому куті консолю ) та натисніть **Перезавантажити**. Оновіть свій https://subdomain.pythonanywhere.com блог, щоб почати зміни.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/uk-UA/django_installation/README.md b/uk-UA/django_installation/README.md
new file mode 100644
index 00000000000..f5cd8088183
--- /dev/null
+++ b/uk-UA/django_installation/README.md
@@ -0,0 +1,7 @@
+# Встановлення Django
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/uk-UA/django_installation/instructions.md b/uk-UA/django_installation/instructions.md
new file mode 100644
index 00000000000..1e35d8b0ea4
--- /dev/null
+++ b/uk-UA/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Авторське право на навчальні матеріали django-marcador tutorial належить Markus Zapke-Gründemann та ін.
+
+## Віртуальне середовище
+
+Перед тим як встановлювати Django, ми допоможемо вам встановити надзвичайно корисний інструмент, що допоможе підтримувати середовище розробки на вашому комп'ютері чистим. Цей крок можна пропустити, але дуже рекомендується його виконати. Починати найкращим можливим способом дозволить уникнути багатьох клопотів в майбутньому!
+
+Отже, створимо віртуальне середовище (англ. **virtual environment** або скорочено *virtualenv*). Virtualenv ізолюватиме ваше Python/Django середовище, для кожного проекту. Це означає, що будь-які зміни, внесені на одному сайті не вплинуть на будь-які інші, які ви також розробляєте. Гарно, правда ж?
+
+Все що вам необхідно зробити це знайти місце, де ви хочете створити віртуальне середовище `virtualenv`; наприклад, ваша домашня папка. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+В рамках цього навчального посібника будемо використовувати нову директорію `djangogirls` з вашої домашньої папки:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+Створимо віртуальне середовище з ім'ям `myvenv`. Загальна команда буде ось в такому форматі:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. Ви можете використовувати будь-яке ім’я, але старайтесь обмежитись маленькими буквами і не використовуйте пробілів, наголосів або спеціальних символів. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python -m venv myvenv
+    
+
+`myvenv` - ім'я вашого віртуального середовища `virtualenv`. Можете використовувати яке завгодно ім'я, але воно має містити лише маленькі літери і не містити пробілів. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Щоб обійти цю проблему, використовуйте натомість команду `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Робота з віртуальним середовищем
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Запустіть своє віртуальне середовище виконавши:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/uk-UA/django_models/README.md b/uk-UA/django_models/README.md
new file mode 100644
index 00000000000..6a1bb3ae662
--- /dev/null
+++ b/uk-UA/django_models/README.md
@@ -0,0 +1,201 @@
+# Django моделі
+
+Наразі ми б хотіли створити щось, що зберігатиме усі дописи в нашому блозі. Але щоб бути спроможними це зробити, нам необхідно трохи поговорити про таке поняття, як об'єкти `objects`.
+
+## Об'єкти
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+Отже, що ж таке об'єкт? Це набір властивостей та дій. Звучить дивно, але представимо приклад.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+Отже, основна ідея полягає в тому, щоб описати реальні речі в програмному коді з усіма їх властивостями (так званими властивостями об'єкта `object properties`) і діями (так званими методами `methods`).
+
+Як же ми тоді змоделюємо дописи у блозі? Ми ж хочемо створити блог, правда?
+
+Нам треба відповісти на питання: що таке допис у блозі? Які властивості він повинен мати?
+
+Однозначно наш допис повинен містити певний текст із змістом і заголовком, правда ж? It would be also nice to know who wrote it – so we need an author. Зрештою, ми б хотіли знати коли було створено і опубліковано цей допис.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Якого роду дії можна було б вчиняти з дописом у блозі? Було б непогано мати певний метод, що публікує допис, правда ж? 
+
+Отже, нам потрібен метод `publish`.
+
+Таким чином, знаючи нарешті, чого ми хочемо досягти, можемо почати моделювати це в Django!
+
+## Django модель
+
+Знаючи яким є наш об'єкт, можемо створити Django модель для допису у нашому блозі.
+
+A model in Django is a special kind of object – it is saved in the `database`. База даних є набором певних даних. Це є місце, де ви будете зберігати інформацію про користувачів, дописи у вашому блозі тощо. Надалі для зберігання наших даних будемо використовувати базу даних SQLite. This is the default Django database adapter – it'll be enough for us right now.
+
+Ви можете уявляти модель в базі даних як таблицю зі стовпчиками (полями) та рядками (дані). 
+
+### Створення додатку
+
+Щоб підтримувати все у порядку, створимо окремий додаток всередині нашого проекту. Дуже добре зберігати в усьому організованість з самого початку. Щоб створити додаток треба запустити наступну команду в консолі (з директорії `djangogirls`, де знаходиться файл `manage.py`):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Створення моделі допису у блозі
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. Ця домовленість часто використовується в Python й іноді ми називаємо її "dunder" (скорочення від англ. "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` - це спеціальне ключове слово, яке показує що ми визначаємо об'єкт.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` означає, що Post є Django моделлю, отже Django знає, що вона повинна бути збережена у базі даних.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Створення таблиць для моделей в базі даних
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/uk-UA/django_orm/README.md b/uk-UA/django_orm/README.md
new file mode 100644
index 00000000000..52140218887
--- /dev/null
+++ b/uk-UA/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM і QuerySets
+
+У цьому розділі ви дізнаєтесь як Django з'єднується із базою даних і зберігає в ній дані. Почнемо занурення!
+
+## Що таке QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+Найпростіше показати на прикладі. Давайте спробуємо?
+
+## Django shell
+
+Відкрийте свій локальний термінал (не PythonAnywhere) і наберіть цю команду:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Результат повинен бути наступним:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### Усі об'єкти
+
+Давайте спробуємо спочатку вивести усі наші пости. Можна це зробити за допомогою наступної команди:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Створення об'єкту
+
+Мова йдеться про те, як створити об'єкт Post в базі даних:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Спочатку імпортуємо модель User:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Які користувачі присутні в нашій базі даних? Спробуймо це:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Тепер ми нарешті можемо створити наш пост:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Ура! Бажаєте перевірити чи це працює?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Є, ще один допис в списку!
+
+### Додайте більше постів
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Фільтрування об'єктів
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. Будемо використовувати `filter` замість `all` в `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Тепер наш шматок коду виглядає так:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Зауваження** Тут використано два знаки підкреслювання (`_`) між `title` і `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+А далі опублікуємо його за допомогою нашого методу `publish`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Впорядкування об'єктів
+
+QuerySets також дозволяє впорядковувати список об'єктів. Давайте спробуємо впорядкувати їх за параметром поля `created_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Також можна здійснити впорядкування у зворотньому напрямку додавши `-` на початку:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Це дуже потужний механізм, що дозволяє вам писати дуже складні запити.
+
+Клас! Тепер ви готові до наступної частини! Щоб закрити командну оболонку, наберіть:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/uk-UA/django_start_project/README.md b/uk-UA/django_start_project/README.md
new file mode 100644
index 00000000000..943af6048e2
--- /dev/null
+++ b/uk-UA/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Ваш перший Django проект!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Авторське право на навчальні матеріали django-marcador tutorial належить Markus Zapke-Gründemann та ін.
+
+We're going to create a small blog!
+
+Перший крок - це почати новий проект Django. По суті, це означає що ми запустимо деякі скрипти, які надає Django, що створять для нас скелет Django проекту. Це просто кілька каталогів та файлів, якими ми користуватимемось пізніше.
+
+Імена деяких файлів і папок є дуже важливими для Django. Не можна перейменовувати файли, які ми зараз будемо створювати. Їх переміщення в різні місця також не є хорошою ідеєю. Для того щоб Django міг знаходити важливі речі, потрібно підтримувати задану архітектуру.
+
+> Пам'ятайте, що усе треба запускати у віртуальному середовищі. Якщо ви не бачите префікс `(myvenv)` в консолі, то потрібно активувати ваше віртуальне середовище. Ми пояснювали як це зробити у розділі **Встановлення Django** в частині **Робота з віртуальним середовищем**. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Крапка `.` має вирішальне значення, оскільки вона означає "встанови Django в поточний каталог" (символ крапки `.` використовується щоб не писати повний шлях).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Крапка `.` має вирішальне значення, оскільки вона означає "встанови Django в поточний каталог" (символ крапки `.` використовується щоб не писати повний шлях).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` - це скрипт, що створить для вас усі необхідні папки і файли. Наразі ви повинні мати структуру, котра виглядає наступним чином:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+Файл `settings.py` містить конфігурацію вашого веб сайту.
+
+Пам'ятаєте, коли ми розмовляли про листоношу, що перевіряє, куди треба доправити листа? Файл `urls.py` містить список шаблонів, що використовуються елементом `urlresolver`.
+
+Проігноруємо поки інші файли, адже ми не будемо їх змінювати. Єдина річ, яку варто пам'ятати - не видалити їх ненароком!
+
+## Зміна налаштувань
+
+Здійснимо деякі зміни в `mysite/settings.py`. Відкриємо файл в текстовому редакторі, який ви мали встановити раніше.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+Було б непогано мати коректний час на нашому сайті. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+Існує безліч різноманітних програмних продуктів, що працюють із базами даних і можуть зберігати дані для вашого сайту. Ми будемо користуватися таким, що вказаний за замовчуванням - `sqlite3`.
+
+Відповідні налаштування вже прописані у файлі `mysite/settings.py`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Щоб створити базу даних для нашого блогу, давайте запустимо наступне в консолі: `python manage.py migrate` (ми повинні знаходитися всередині директорії `djangogirls`, яка містить файл `manage.py`). Якщо все пройшло успішно, ви маєте побачити щось на кшталт:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+Ми це зробили! Час запустити веб сервер і перевірити чи працює наш сайт!
+
+## Starting the web server
+
+Ви повинні знаходитися в папці, що містить файл `manage.py` (папка `djangogirls`). В консолі ми можемо активувати веб сервер запустивши `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/uk-UA/django_templates/README.md b/uk-UA/django_templates/README.md
new file mode 100644
index 00000000000..2bedcb346c1
--- /dev/null
+++ b/uk-UA/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django шаблони
+
+Час вивести деякі дані! Django надає нам певні допоміжні, вбудовані **шаблонні теги** для цього.
+
+## Що таке шаблонні теги?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Шаблон для виведення списку постів
+
+В попередньому розділі ми надали нашому шаблону список постів у змінній `posts`. А тепер відобразимо це в HTML.
+
+Щоб надрукувати змінну в Django шаблоні, ми використовуємо подвійні фігурні дужки з іменем змінної всередині:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Спробуйте це в шаблоні `blog/templates/blog/post_list.html`. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Збережіть файл і оновіть сторінку, щоб побачити результат:
+
+![Figure 13.1](images/step1.png)
+
+Як можна побачити, все що ми отримали це:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Означає, що Django розуміє це як список об'єктів. Пам'ятаєте із розділу **Вступ до Python** як ми можемо виводити списки? Звичайно, за допомогою циклу **for**! У Django шаблонах ви можете створити їх наступним чином:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Спробуйте це у вашому шаблоні.
+
+![Figure 13.2](images/step2.png)
+
+Працює! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. Ви можете компонувати теги HTML і шаблонні теги. Наша частина `body` буде виглядати так:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+Все що ви напишете між `{% for %}` та `{% endfor %}` повторюватиметься для кожного об'єкта у списку. Оновіть сторінку:
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? Ми маємо доступ до даних, що містяться в кожному полі, визначеному в нашій моделі `Post`. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## Ще одне
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Потім, увійдіть назад до [PythonAnywhere](https://www.pythonanywhere.com/consoles/) та перейдіть до **Bash консолі** (або запустіть нову) і виконайте команди:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/uk-UA/django_urls/README.md b/uk-UA/django_urls/README.md
new file mode 100644
index 00000000000..f8dbffac465
--- /dev/null
+++ b/uk-UA/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## Що таке URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` - це URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Кожна сторінка в Інтернеті потребує свого власного URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## Як працює URL в Django?
+
+Давайте відкриємо файл `mysite/urls.py` в редакторі коду і подивимось, як він виглядає:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/uk-UA/django_views/README.md b/uk-UA/django_views/README.md
new file mode 100644
index 00000000000..fd26edb29a6
--- /dev/null
+++ b/uk-UA/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Час позбутися помилки, створеної в останньому розділі! :)
+
+Відображення - *view* -- це місце, в якому ми закладаємо "логіку" нашої програми. Воно запитує інформацію з `моделі`, яку ми створили раніше і передає його до `шаблону`. Ми створимо шаблон в наступному розділі. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Відображення розташовані у файлі `views.py`. Додамо наші відображення до файлу `blog/views.py`.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Інша помилка! Прочитайте у чому цього разу справа:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/uk-UA/dynamic_data_in_templates/README.md b/uk-UA/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..79b838c7591
--- /dev/null
+++ b/uk-UA/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Динамічні дані в шаблонах
+
+Маємо різні шматочки на своїх місцях: модель `Post` визначено в `models.py`, маємо `post_list` у `views.py`, а також відповідний шаблон. Однак, яким чином ми змусимо наші пости з'явитися в HTML шаблоні? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+Це саме те, що покликані робити відображення: з'єднаємо моделі і шаблони. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Пам'ятаєте як ми говорили про включення коду написаного в різних файлах? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Далі імпортуємо ім'я моделі (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Зазначте, будь ласка, що ми створюємо *змінну* для нашого QuerySet: `posts`. Сприймайте її як ім'я для QuerySet. З цього моменту ми можемо посилатися на неї через це ім'я.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. Ми повинні дати їм імена (ми обмежились ім'ям `'posts'` наразі). :) Це має виглядати як: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+Отже, врешті-решт наш файл `blog/views.py` матиме наступний вигляд:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+Це все! Час повернутись назад до нашого шаблону і вивести QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/uk-UA/extend_your_application/README.md b/uk-UA/extend_your_application/README.md
new file mode 100644
index 00000000000..947773e6c78
--- /dev/null
+++ b/uk-UA/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Розширте свою програму
+
+Ми вже завершили всі етапи необхідні для створення нашого сайту: ми знаємо як написати модель, адресу URL, вигляд та шаблон. Ми також знаємо як зробити сайт привабливим.
+
+Час попрактикуватись!
+
+Перша річ, яка має бути у нашому блозі - це, очевидно, сторінка, що відображує один пост, правильно?
+
+Ми вже маємо модель </code>посту`, тому не потрібно нічого додавати до <code>models.py`.
+
+## Створюємо в шаблоні посилання на сторінку посту
+
+Ми розпочнемо із додавання посилання всередині `blog/templates/blog/post_list.html` файлу. Відкрийте його в редакторі коду і поки що воно має виглядати так: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}Ми хочемо, щоб в списку постів в заголовку було посилання на сторінку детальної інформації про пост. Давайте змінимо `<h2><a href="">{{ post.title }}</a></h2>` так, щоб було посилання на сторінку з детальною інформацією про пост:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Час пояснити дивний запис `{% url 'post_detail' pk=post.pk %}`. Як і очікувалось, `{% %}` означає, що ми використовуємо шаблонні теги Django. На цей раз ми використаємо один, який створить адресу URL для нас! 
+
+`post_detail` частина означає, що Django буде очікувати адресу URL у `blog/urls.py` з назвою=post_detail
+
+А як щодо `pk=post.pk`? `pk` - це скорочення від первинного ключа, що є унікальним ідентифікатором для кожного запису в базі даних. Кожна модель Django має поле, яке виступає як первинний ключ і будь-яку іншу назву воно маже мати, це також може називатися "pk". Тому що ми не вказали основного ключа в моделі `поста`, Django створює одне для нас (за замовчуванням, поле з назвою "id", що збільшується на усі записи, наприклад 1,2,3) і додає це поле в кожну з наших записів. Ми маємо доступ до первинного ключа, записуючи `post.pk`, так само як ми отримуємо доступ до інших полів (`назва`,`автор` і т.д.) у нашому об'єкті `пост`!
+
+Тепер, коли ми переходимо до http://127.0.0.1:8000/, ми отримуємо помилку (як і оікувалось, оскільки у нас немає адреси URL або потрібного *вигляду* для `post_detail`. Це буде виглядати наступним чином:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Створюєм адресу URL для деталей запису
+
+Давайте створимо адресу URL на `urls.py` для нашого *вигляду* `post_detail`!
+
+Ми хочемо, щоб наш перший пост був доступний за такою адресою **URL**: http://127.0.0.1:8000/post/1/ 
+
+Давайте створимо адресу URL в файлі `blog/urls.py` і вкажемо Django на *вигляд* з назвою `post_detail`, який буде відображати пост цілком. Відкрийте файл `blog/urls.py` в редакторі коду і додайте рядок `path('post/<int:pk>/', views.post_detail, name='post_detail'),` так щоб файл виглядав так:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+Ця частина `post<int:pk>/` визначає шаблон адреси URL - ми пояснимо це вам:
+
+- `post` означає, що URL-адреса має починатися зі слова **post** з такою назвою ****. Все йде правильно.
+- `<int:pk>` - ця частина складніша. Це означає, що Django очікує ціле значенння і передасть його до вигляду як змінну `pk`.
+- `/` - тоді нам знадобиться **/** після завершення URL-адреси.
+
+Це означає, що якщо ви введете `http://127.0.0.1:8000/post/5/`, Django зрозуміє, що ви шукаєте відображення із назвою `post_detail` і передає цьому відображенню інформацію, що `pk` дорівнює `5`.
+
+Гаразд, ми додали новий шаблон URL-адрес до `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Додамо деталі відображення запису
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/uk-UA/how_the_internet_works/README.md b/uk-UA/how_the_internet_works/README.md
new file mode 100644
index 00000000000..4dc08264460
--- /dev/null
+++ b/uk-UA/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Як працює Інтернет
+
+> Для читачів вдома: відеоверсія цього розділу - [Як працює Інтернет](https://www.youtube.com/watch?v=oM9yAA09wdc) (англ.).
+> 
+> На створення цього розділу нас надихнув виступ Джесіки Маккеллар "Як працює інтернет" (http://web.mit.edu/jesstess/www/).
+
+Б'ємось об заклад, ви використовуєте Інтернет кожного дня. Однак, чи знаєте ви насправді, що трапляється, коли ви набираєте адресу на зразок https://djangogirls.org у вашому браузері та натискаєте `enter`?
+
+Перша річ, яку вам необхідно зрозуміти, - це те, що вебсайт є лише набором файлів на жорсткому диску. Просто як фільми, музика або зображення. Проте, є одна унікальна річ для вебсайтів: вони містять комп'ютерний код, що називається HTML.
+
+Якщо ви не знайомі із програмуванням, спочатку може бути складно вловити що таке HTML, але ваші веббраузери (такі як Chrome, Safari, Firefox тощо) люблять це. Веббраузери розроблені спеціально, щоб розуміти цей код, виконувати його інструкції та показувати файли, з яких складається ваш сайт, і саме так, як ви цього хочете.
+
+Як і звичайні файли, нам потрібно зберігати HTML-файли в певному місці на жорсткому диску. В інтернеті ми використовуємо спеціальні потужні комп'ютери, що називаються *серверами*. Вони не мають екрану, мишки чи клавіатури, тому що їхня основна ціль - зберігати і видавати дані. Саме тому ці комп'ютери назвали *серверами*: вони видають, можна навіть сказати «подають» (англ. to *serve* - подавати) ваші дані.
+
+Гаразд, але ж ви хочете дізнатися як виглядає інтернет, чи не так?
+
+Ми намалювали для вас картинку! Ось таку:
+
+![Figure 1.1](images/internet_1.png)
+
+Суцільний безлад, правильно? Фактично, це мережа з'єднаних машин (вище зазначених *серверів*). Сотень тисяч машин! Багато-багато кілометрів кабелю по усьому світу! Можете відвідати вебсайт Submarine Cable Map (http://submarinecablemap.com/), щоб побачити, наскільки складною є мережа. Тут наведено знімок з вебсайту:
+
+![Figure 1.2](images/internet_3.png)
+
+Вражаюче, чи не так? Але ж неможливо протягнути проводи між кожною парою машин, що під'єднані до інтернету. Отже, щоб досягти машини (наприклад тієї, на якій знаходиться https://djangogirls.org), ми повинні передати запит через багато-багато різних машин.
+
+Це виглядатиме так:
+
+![Figure 1.3](images/internet_2.png)
+
+Уявіть, що коли ви набираєте https://djangogirls.org, ви відправляєте листа, в якому пишете: "Шановні Django Girls, я хочу побачити вебсайт djangogirls.org. Відправте мені його, будь ласка!"
+
+Ваш лист надійде до найближчого поштового відділення. Далі він надійде до іншого відділення, що знаходиться трохи ближче до вашого адресата, далі до іншого і так далі, поки не буде досягнуто остаточного пункту призначення. Єдина відмінність в тому, що якщо ви відправите багато листів (*пакетів даних*) в одне місце, кожен з них може піти через абсолютно різні поштові відділення (*маршрутизатори*). Це залежить від того, як їх розподілили в кожному відділенні.
+
+![Figure 1.4](images/internet_4.png)
+
+Інтернет працює так само. Ви відправляєте повідомлення і очікуєте певної відповіді. Звісно, замість паперу і ручки ви використовуєте байти даних, але ідея та сама!
+
+Замість адрес із назвами вулиці, міста, індексом і назвою країни, ми використовуємо IP-адреси. Ваш комп'ютер спочатку запитує DNS-сервер (англ. Domain Name System - Система доменних імен) для "перекладу" імені djangogirls.org на IP-адресу. Це працює трохи подібно до старомодних телефонних довідників, де ви могли б знайти ім'я особи, з якою бажаєте зв'язатися, і отримати там номер її телефону та адресу.
+
+Коли ви відправляєте звичайного листа, це потребує наявності певних атрибутів для коректної доставки: адреса, штамп тощо. Також ви використовуєте мову, яку розуміє отримувач, правда ж? Те ж саме стосується і *пакетів даних*, які ви відправляєте, щоб побачити вебсайт. Ми використовуємо протокол, який називається HTTP (англ. HyperText Transfer Protocol - протокол передачі гіпертекстових документів).
+
+Отже, по суті, коли у вас є вебсайт, вам треба мати *сервер* (машину), де він житиме. Коли *сервер* отримує вхідний *запит* (у листі), він відправляє назад ваш вебсайт (в іншому листі).
+
+Оскільки це є навчальний посібник з Django, ви можете запитати, що ж саме робить Django. Коли ви відправляєте відповідь, то не завжди бажаєте відправляти одне й те саме кожному. Набагато краще, якщо ваші листи будуть персоналізованими, особливо для тих, хто вам щойно написав, правда ж? Django допомагає вам зі створенням цих персоналізованих, цікавих листів. :)
+
+Досить говорити - час творити!
\ No newline at end of file
diff --git a/uk-UA/html/README.md b/uk-UA/html/README.md
new file mode 100644
index 00000000000..cd1331e3c7f
--- /dev/null
+++ b/uk-UA/html/README.md
@@ -0,0 +1,227 @@
+# Вступ до HTML
+
+Ви можете запитати, що таке шаблон?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## Що таке HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML розшифровується як "Мова розмітки гіпертексту". **Гіпертекст** означає тип тексту, який підтримує гіперпосилання між сторінками. **Markup** (розмітка) означає, що ми отримали документ із розміченим кодом для того, щоб повідомити дещо (у даному випадку, браузер) як треба інтерпретувати сторінку. HTML код побудований за допомогою **тегів**, кожен з яких починається із `<` і закінчується `>`. Теги представляють **елементи розмітки**.
+
+## Ваш перший шаблон!
+
+Під створенням шаблону мається на увазі створення файлу шаблону. Будь-що є файлом, чи не так? Ви, напевно, це вже зауважили.
+
+Шаблони зберігаються в папці `blog/templates/blog`. Отже, спершу створіть папку із назвою `templates` всередині вашої папки blog. Далі створіть іншу папку із назвою `blog` всередині вашої папки templates:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+А тепер створіть файл `post_list.html` (просто залиште його поки що пустим) всередині папки `blog/templates/blog`.
+
+Погляньте як тепер виглядає ваш веб сайт: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Рисунок 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Рисунок 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Кожну сторінку HTML також можна поділити на два елементи: **head** - (голова) і **body** - (тіло.
+
+* **head** - елемент, що містить інформацію про документ, яка не відображається на екрані.
+
+* **body** - елемент, що містить усе інше, що відображається як частина веб сторінки.
+
+Ми використовуємо `<head>` щоб повідомити браузер про конфігурацію сторінки, а `<body>` щоб повідомити браузер, що у дійсності знаходиться на сторінці.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Збережіть файл і перезавантажте вашу сторінку.
+
+![Рисунок 11.3](images/step4.png)
+
+Зауважте як браузер зрозумів , що "Ola's blog" це заголовок вашої сторінки? Він інтерпретував `<title>Ola's blog</title>` і розмістив текст у рядку заголовка вашого браузера (він також буде використаний для закладок чи інших речей).
+
+Можливо, ви також зауважили, що кожен відкриваючий тег відповідає *закриваючому тегу*, із `/`, і ці елементи є *вкладеними* (тобто ви не можете закрити окремий тег поки усі теги, що містяться всередині не будуть також закриті).
+
+Це щось на кшталт як покласти речі всередину ящиків. У вас є один великий ящик, `<html></html>`; всередині цього ящика є `<body></body>`, що містить ще менші ящики: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Налаштуйте ваш шаблон
+
+А тепер можете трохи побавитися і спробувати налаштувати ваш шаблон! Тут наведено декілька корисних тегів для цього:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>Підзаголовок</h2>` для заголовків наступного рівня
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>текст</em>` робить акцент на вашому тексті
+* `<strong>текст</strong>` робить сильний акцент на вашому тексті
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` створює посилання
+* `<ul><li>перший елемент</li><li>другий елемент</li></ul>` створює список, такий як цей!
+* `<div></div>` визначає блок сторінки
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Отримуємо наступний ефект:
+
+![Рисунок 11.4](images/step6.png)
+
+Йой! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## Ще одна річ: розгортання!
+
+Було б добре побачити все це в Інтернеті, правда? Давайте зробимо ще одне розгортання на PythonAnywhere:
+
+### Commit, and push your code up to GitHub
+
+По-перше, давайте подивимося які файли були змінені після розгортання (виконайте ці команди локально, не на PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Перед тим як завантажити усі файли, давайте перевіримо що ж буде завантажувати `git` (усі файли, які буде завантажувати `git` повинні тепер з'явитися і бути позначеними зеленим кольором):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Майже на місці, а тепер час повідомити йому про те, що треба зберегти ці зміни в його історії. Ми збираємося задати "commit message" що ж ми змінили. На цьому етапі можна набрати будь-що, що вважатимете за потрібне, однак, має сенс надрукувати щось дійсно зрозуміле, щоб, таким чином, ви могли згадати що ви зробили у майбутньому.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Завантаження (pull) нового коду на PythonAnywhere і перезапуск веб-додатку
+
+* Відкрийте [сторінку з терміналами на PythonAnywhere](https://www.pythonanywhere.com/consoles/) і переключіться на вже запущений **Bash термінал** (або запустіть новий). Далі, наберіть команди:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/uk-UA/installation/README.md b/uk-UA/installation/README.md
new file mode 100644
index 00000000000..41c3f9af577
--- /dev/null
+++ b/uk-UA/installation/README.md
@@ -0,0 +1,68 @@
+# Якщо ви проходите цей підручник вдома
+
+Якщо ви проходите цей підручник вдома, а не на одному з [заходів Django Girls](https://djangogirls.org/events/), ви можете повністю пропустити цей розділ і перейти до розділу [Як працює Інтернет](../how_the_internet_works/README.md).
+
+Ця сторінка є лише додатковою - на ній ми зібрали інструкції зі встановлення всіх програм, які потрібні протягом курсу (така підбірка є корисною для деяких форматів семінару). Ви можете одразу встановити все, що є на цій сторінці. Але якщо бажаєте почати вчитися без встановлення купи речей на ваш комп'ютер, пропустіть цей розділ, а ми пояснимо, як ставити програми, пізніше.
+
+Успіхів!
+
+# Якщо ви плануєте відвідати семінар
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Встановлення
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Коротко про командний рядок {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Встановіть Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Встановіть редактор коду {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Налаштуйте віртуальне середовище та встановіть Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Встановіть Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Почніть читати
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Насолоджуйтесь воркшопом!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/uk-UA/intro_to_command_line/README.md b/uk-UA/intro_to_command_line/README.md
new file mode 100644
index 00000000000..6ec31e1c828
--- /dev/null
+++ b/uk-UA/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Вступ до інтерфейсу командного рядка
+
+> Для читачів вдома: відеоверсія цього розділу - [Ваш новий друг: командний рядок](https://www.youtube.com/watch?v=jvZLWhkzX-8) (англ.).
+
+Це захоплює, так?! Ви напишете свій перший рядок коду через декілька хвилин :)
+
+**Дозвольте нам представити вам нового друга: командний рядок!**
+
+Наступні кроки покажуть вам, як користуватися чорним вікном, яке є інструментом усіх хакерів. Спочатку це може видаватися трохи жахливим, однак насправді це лише запрошення, що очікує певних команд від вас.
+
+> **Примітка.** Зауважте, що в цій книзі ми використовуємо терміни "директорія", "каталог" та "папка" взаємозамінно, ці слова означають одне й те саме.
+
+## Що таке командний рядок?
+
+Вікно, яке зазвичай називають **командним рядком** або **інтерфейсом командного рядка**, є текстовою програмою для перегляду, редагування та інших операцій з файлами на вашому комп'ютері. Як Провідник на Windows чи Finder на Mac, але без графічного інтерфейсу. Інші назви командного рядка: *cmd*, *CLI*, *prompt*, *console* або *terminal*.
+
+## Відкриваємо інтерфейс командного рядка
+
+Щоб почати експериментувати, нам потрібно спочатку відкрити наш командний рядок.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Запрошення
+
+Має з'явитися біле або чорне вікно, що очікує на ваші команди.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Якщо ви працюєте на Mac або на Linux, ви напевно побачите `$`, на зразок:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+На Windows, це знак `>`, ось так:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Подивіться на секцію Linux трохи вище - ви побачите щось подібне, коли перейдете до PythonAnywhere пізніше у цьому посібнику.
+
+<!--endsec-->
+
+Кожній команді буде передувати символ `$` або `>` і після нього один пробіл, але ви не мусите набирати їх. Ваш комп'ютер робитиме це для вас сам :)
+
+> Маленьке зауваження: перед знаком командного рядка ви, скоріш за все, побачите щось на зразок `C:\Users\ola>` або `Olas-MacBook-Air:~ ola$`. Це є на 100% правильним.
+
+Весь цей текст включно зі знаком `$` або `>` називається *запрошенням командного рядка* або скорочено *запрошенням*. Він запрошує вас ввести туди щось.
+
+У посібнику, коли нам потрібно, щоб ви набрали щось у командному рядку, ми включатимемо `$` або `>`, а іноді й більше символів зліва. Ігноруйте ліву частину і набирайте лише команду, яка починається після знаку запрошення.
+
+## Ваша перша команда (ЙОЙ!)
+
+Почнемо з чогось простенького. Наберіть команду:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+Далі натисніть `Enter`. Це наш результат:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+Як бачимо, комп'ютер виводить ваше ім'я користувача. Файно, еге ж?:)
+
+> Спробуйте набирати кожну команду, а не копіювати і вставляти. Таким чином, ви більше запам'ятаєте!
+
+## Основи
+
+У кожної операційної системи є трохи відмінні набори команд для командного рядка, отже будьте певними, що виконуєте інструкції саме для вашої операційної системи. Давайте спробуємо?
+
+### Поточна директорія
+
+Було б приємно знати, де ми перебуваємо зараз, чи не так? Давайте подивимося. Введіть цю команду і натисніть `Enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Примітка: "pwd" розшифровується як "print working directory" (англ. "надрукувати робочу папку").
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Примітка: "cd" означає "'change directory". Проте у PowerShell ви можете використовувати pwd - так же само, як на Linux або Mac OS X.
+
+<!--endsec-->
+
+Можливо, ви побачите щось таке на вашій машині. Після того, як ви відкрили командний рядок, ви зазвичай починаєте зі своєї домашньої папки.
+
+* * *
+
+### Довідка для команд
+
+Багато команд, які можна вводити у командному рядку, мають вбудовану довідку, яку ви можете відобразити та прочитати! Наприклад, дізнайтесь більше про команду поточної директорії:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+ОС X та Linux мають команду `man` , що видає вам довідку по іншим командам. Спробуйте `man pwd` і подивіться, що вона видає, або помістіть `man` перед іншими командами, щоб побачити їхню довідку. Результат `man` зазвичай розбито на сторінки. Використовуйте пробіл, щоб перейти на наступну сторінку, і `q` , щоб вийти з перегляду довідки.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Додавання суфікса `/?` до більшості команд відобразить сторінку довідки. Можливо, доведеться прокрутити командне вікно, щоб побачити його повністю. Спробуйте `cd /?`.
+
+<!--endsec-->
+
+### Список файлів і папок
+
+Отже, що ж всередині? Було б круто з'ясувати. Давайте подивимось:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Примітка: у PowerShell ви можете використовувати 'ls', як у Linux або Mac OS X. <!--endsec-->
+
+* * *
+
+### Змінити поточну директорію
+
+Тепер давайте перейдемо до директорії Робочого столу:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Зверніть увагу, що назва каталогу "Desktop" може бути перекладена на мову вашого облікового запису Linux. У такому випадку вам треба замінити `Desktop` на назву перекладу; наприклад, `Робочий стіл` для української.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Перевірте, чи дійсно щось змінилось:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Так, ось воно!
+
+> ПРОФІ хитрощі: якщо ви наберете `cd D` і потім натиснете `Tab` на клавіатурі, командний рядок автоматично заповнить решту імені, таким чином можна набирати команди швидше. Якщо папок, що починаються з "D", більше однієї, натисніть клавішу `Tab` двічі, щоб отримати список варіантів.
+
+* * *
+
+### Створити директорію 
+
+Як щодо створення каталогу practice на вашому робочому столі? Ви можете зробити це таким чином:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+Ця коротка команда створить папку з іменем `practice` на вашому Робочому столі. Можете перевірити, чи з'явилась вона там, просто глянувши на свій Робочий стіл або запустивши команду `ls` або `dir`! Спробуйте :)
+
+> ПРОФІ хитрощі: Якщо ви не хочете кожного разу набирати одну й ту ж команду, спробуйте натиснути клавіші `Стрілка вгору` та `Стрілка вниз` на своїй клавіатурі, щоб повторити нещодавно використані команди.
+
+* * *
+
+### Вправа!
+
+Невеличке випробування для вас: у щойно створеній директорії `practice` створіть папку `test`. Використайте для цього команди `cd` та `mkdir`.
+
+#### Розв'язок:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Вітаємо! :)
+
+* * *
+
+### Прибираємо
+
+Ми не хочемо залишити безлад, тож давайте видалимо усе, що ми створили до цього моменту.
+
+Спочатку нам потрібно повернутися назад до директорії Робочий стіл:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Використання `cd` із `..` змінить вашу поточну директорію на батьківську (тобто папку, що містить вашу поточну папку).
+
+Перевірте, де ми:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Тепер час видалити директорію `practice`:
+
+> **Увага**: Видалення файлів за допомогою `del`, `rmdir` або `rm` є безповоротнім, тобто *файли будуть видалені назавжди*! Тож будьте конче обережними з цією командою.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Виконано! Щоб переконатися, що папку дійсно видалено, давайте перевіримо:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Вихід
+
+Це все наразі! Можна тепер спокійно закрити командний рядок. Давайте зробимо це хакерським методом, добре? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Круто, га? :)
+
+## Підсумок
+
+Для зручності ми зібрали основні команди у таблиці:
+
+| Команда (Windows) | Команда (Mac OS / Linux) | Опис                         | Приклад                                             |
+| ----------------- | ------------------------ | ---------------------------- | --------------------------------------------------- |
+| exit              | exit                     | закрити вікно                | **exit**                                            |
+| cd                | cd                       | змінити директорію           | **cd test**                                         |
+| cd                | pwd                      | показати поточну директорію  | **cd** (Windows) або **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | список директорій/файлів     | **dir**                                             |
+| copy              | cp                       | скопіювати файл              | **copy c:\test\test.txt c:\windows\test.txt**   |
+| move              | mv                       | перемістити файл             | **move c:\test\test.txt c:\windows\test.txt**   |
+| mkdir             | mkdir                    | створити нову директорію     | **mkdir testdirectory**                             |
+| del               | rm                       | видалити файл                | **del c:\test\test.txt**                          |
+| rmdir /s          | rm -r                    | видалити директорію          | **rm -r testdirectory**                             |
+| [CMD] /?          | man [CMD]                | показати довідку для команди | **cd /?** (Windows) або **man cd** (Mac OS / Linux) |
+
+Це лише невелика кількість команд, які можна запускати у вашому командному рядку, однак поки вам більше і не буде потрібно.
+
+Якщо вас цікавить, [ss64.com](http://ss64.com) містить опис усіх команд для усіх операційних систем.
+
+## Готові?
+
+Давайте зануримось у Python!
\ No newline at end of file
diff --git a/uk-UA/intro_to_command_line/open_instructions.md b/uk-UA/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..a3ab5b6c114
--- /dev/null
+++ b/uk-UA/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+В залежності від вашої версії Windows і клавіатури, ви можете відкрити командне вікно одним з наступних способів (можливо, доведеться трохи поекспериментувати, але ви не повинні пробувати всі варіанти):
+
+- Перейдіть до меню Пуск (або екрана Пуск), та введіть "Командний рядок" ("Command Prompt") у полі пошуку.
+- Перейдіть до меню Пуск → Система Windows → Командний рядок (Start menu → Windows System → Command Prompt).
+- Перейдіть до меню Пуск → Усі програми → Стандартні → Командний рядок (Start menu → All Programs → Accessories → Command Prompt).
+- Перейдіть до екрана Пуск, підведіть курсор миші до нижнього лівого кута екрану та натисніть стрілку вниз, яка з'явиться (на сенсорному екрані замість цього протягніть від нижнього краю екрану). Повинна відкритись сторінка додатків. Натисніть на "Командний рядок" ("Command Prompt") у розділі "Система Windows" ("Windows System").
+- Утримуючи спеціальну клавішу "Windows" на клавіатурі, натисніть клавішу "X". Виберіть "Командний рядок" ("Command Prompt") або "Оболонка Windows PowerShell" із меню, яке з'явиться.
+- Утримуючи клавішу "Windows", натисніть клавішу "R", щоб відкрити вікно "Виконати". Введіть "cmd" у текстовому полі та натисніть кнопку "OK".
+
+![Введіть "cmd" у вікні "Виконати"](../python_installation/images/windows-plus-r.png)
+
+Пізніше, в цьому посібнику вам знадобиться два командних вікна, відчинених одночасно. Однак, на деяких версіях Windows, якщо у вас вже є одне відчинене вікно і ви спробуєте відкрити друге за допомогою того ж методу, вас переадресує знову на те ж командне вікно, що вже відкрите. Спробуйте це зараз на своєму комп'ютері та подивіться, що станеться! Якщо ви отримуєте лише одне командне вікно, то спробуйте якийсь інший метод зі списку вище. Принаймні один з них повинен відкривати нове командне вікно.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Відкрийте Додатки → Утиліти → Термінал (Applications → Utilities → Terminal).
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Скоріш за все Додатки → Стандартні → Термінал (Applications → Accessories → Terminal), або Додатки → Система → Термінал (Applications → System → Terminal), але це може залежати від вашого дистрибутива. Якщо ж немає нічого подібного, спробуйте погуглити це. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/uk-UA/python_installation/README.md b/uk-UA/python_installation/README.md
new file mode 100644
index 00000000000..22ca3becc3c
--- /dev/null
+++ b/uk-UA/python_installation/README.md
@@ -0,0 +1,15 @@
+# Почнімо працювати з Python
+
+Нарешті ми тут!
+
+Але спершу дозвольте нам розповісти вам, що ж таке Python. Python – це дуже популярна мова програмування, що може використовуватися для створення вебсайтів, ігор, наукових програм, графіки та багато-багато іншого.
+
+Python бере свій початок з кінця 80-х, і його головною метою є бути читабельним для людей (а не тільки для машин!). Саме тому ця мова виглядає набагато простіше, ніж інші мови програмування. Але не турбуйтеся, Python водночас є дуже потужним!
+
+# Встановлення Python
+
+> **Примітка:** Якщо ви використовуєте хромбук, пропустіть цей розділ і переконайтеся, що ви слідуєте інструкції [ Встановлення (хромбук)](../chromebook_setup/README.md).
+> 
+> **Примітка:** Якщо ви вже пройшли [кроки встановлення](../installation/README.md), нема потреби робити це знову – можна пропустити це і перейти одразу до наступного розділу!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/uk-UA/python_installation/instructions.md b/uk-UA/python_installation/instructions.md
new file mode 100644
index 00000000000..f1a54cdc10a
--- /dev/null
+++ b/uk-UA/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Для читачів вдома: відеоверсія цього розділу (разом із наступним) - [Встановлення Python та редактора коду](https://www.youtube.com/watch?v=pVTaqzKZCdA) (англ.).
+> 
+> Цей розділ базується на навчальних матеріалах Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django написаний на Python. Нам потрібен Python, щоб робити на Django усе, що заманеться. Почнемо з його інсталяції! Ми хочемо, щоб ви встановили останню версію Python 3, отже якщо у вас встановлена більш рання версія, вам потрібно її оновити. Якщо у вас вже є версія {{ book.py_min_version }} або вище, то у вас має бути все гаразд.
+
+Будь ласка, встановіть звичайний Python, навіть якщо на вашому комп’ютері встановлена Анаконда.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Спочатку перевірте, яка версія Windows встановлена на вашому комп'ютері (64- чи 32-розрядна) у рядку "Тип системи" сторінки налаштувань "Система". Щоб відкрити цю сторінку, оберіть один з цих способів:
+
+* Натисніть на клавіатурі комбінацію клавіш Win + Pause/Break
+* Відкрийте панель керування у меню Windows, потім перейдіть до категорії "Системи й безпека", і звідти - до "Система"
+* Натисніть клавішу Windows, а потім перейдіть до Настройки > Система > Про систему
+* Знайдіть у меню "Пуск" розділ "Система". Для цього натисніть кнопку «Пуск» (або клавішу Windows), а потім почніть набирати `Система`. Посилання на сторінку "Система" з'явиться одразу, як тільки ви почнете набирати. І ви можете одразу обрати його.
+
+Python для Windows можна завантажити з сайту https://www.python.org/downloads/windows/. Натисніть на посилання "Latest Python 3 Release - Python 3.x.x". Якщо ваш комп'ютер працює з **64-розрядною** версією Windows, завантажте **Windows installer (64-bit)** (посилання шукайте у самому низу). Інакше завантажте **Windows installer (32-bit)**. Після завантаження інсталятора запустіть його (двічі клацніть на ньому) і виконайте усі подальші інструкції.
+
+Зверніть увагу на одну річ: під час встановлення з'явиться вікно з заголовком "Setup". Переконайтесь, що ви поставили галочку "Add Python {{ book.py_version }} to PATH" або "Add Python to your environment variables", і натисніть "Install Now", як показано тут (це може виглядати трохи інакше, якщо ви встановлюєте іншу версію):
+
+![Не забудьте додати Python до змінної Path](../python_installation/images/python-installation-options.png)
+
+Коли встановлення завершиться, ви можете побачити діалогове вікно з посиланням, щоб дізнатись більше про Python або про версію, яку ви встановили. Закрийте або скасуйте цей діалог: у цьому посібнику ви дізнаєтесь значно більше!
+
+Примітка: Якщо ви використовуєте стару версію Windows (7, Vista, або будь-яка стара версія) і встановлення Python {{ book.py_version }} зазнає помилки, то встановіть усі оновлення для Windows і спробуйте встановити Python знову. Якщо помилка залишилась, спробуйте встановити версію Python {{ book.py_min_release }} з [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} потребує Python {{ book.py_min_version }} або вище: ці версії не підтримують Windows XP або більш ранні версії Windows.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Зверніть увагу:** Перед встановленням Python на OS X, ви повинні впевнитись, що налаштування Mac дозволяють встановлювати пакети, які відсутні з App Store. Перейдіть до налаштувань системи (це у папці Applications), натисніть "Security & Privacy", а потім - вкладку "General". Якщо параметр "Allow apps downloaded from:" встановлено в "Mac App Store", змініть його на "Mac App Store and identified developers".
+
+Вам необхідно перейти на вебсайт https://www.python.org/downloads/mac-osx/ і завантажити найсвіжіший інсталятор Python:
+
+* завантажте файл *Mac OS X 64-bit/32-bit installer*,
+* двічі клацніть на *python-{{ book.py_release }}-macosx10.9.pkg*, щоб запустити інсталятор.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Цілком ймовірно, що у вас вже є Python, встановлений разом із системою. Щоб перевірити це (а заодно й версію), відкрийте консоль і наберіть таку команду:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+Якщо у вас встановлена інша версія Python, але не старіша за {{ book.py_min_version }} (напр. {{ book.py_min_release }}), то оновлювати не потрібно. Якщо ж у вас не встановлено Python, або якщо ви хочете оновити версію, спочатку перевірте, яку версію дистрибутиву Linux ви використовуєте за допомогою наступної команди:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Після цього, в залежності від результату, дотримуйтесь однієї з наступних інструкцій (див. нижче).
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Наберіть наступну команду в консолі:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Скористайтеся наступною командою в консолі:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+Якщо у вас стара версія Fedora, ви можете отримати помилку, що команда `dnf` не знайдена. У цьому випадку потрібно використати `yum`.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Скористайтеся наступною командою в консолі:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Перевірте, що встановлення пройшло успішно, відкривши командний рядок і запустивши команду `python3`:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+Версія може відрізнятися від {{ book.py_release }} -- вона має відповідати встановленій вами версії.
+
+**ПРИМІТКА:** Якщо ви у Windows і отримуєте повідомлення про помилку, що `python3` не знайдено, спробуйте використати `python` (без `3`) і перевірте, що версія Python не менше за {{ book.py_min_version }}. Якщо це не спрацювало, ви можете відкрити новий командний рядок і спробувати знову; подібне відбувається, якщо ви використовуєте командний рядок, що був відкритий ще до початку встановлення Python.
+
+* * *
+
+Якщо маєте певні сумніви, або щось пішло не так і ви без поняття, що робити далі - будь ласка, зверніться до свого тренера! Інколи не все йде гладко і краще звернутись по допомогу до когось, хто має більше досвіду.
\ No newline at end of file
diff --git a/uk-UA/python_introduction/README.md b/uk-UA/python_introduction/README.md
new file mode 100644
index 00000000000..4ff5c0140f0
--- /dev/null
+++ b/uk-UA/python_introduction/README.md
@@ -0,0 +1,1074 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Вступ до Python
+
+> Частина цього розділу базується на матеріалах Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Давайте напишемо якийсь код!
+
+## Консоль Python
+
+> Для читачів вдома: відеоверсія цього розділу - [Основи Python: числа, рядки, списки, змінні та помилки](https://www.youtube.com/watch?v=MO63L4s-20U) (англ.).
+
+Щоб розпочати роботу із Python, нам необхідно відкрити *командний рядок*. Ви вже повинні знати, як це зробити, адже ознайомились із цим у розділі [Вступ до командного рядка](../intro_to_command_line/README.md).
+
+Як тільки будете готові, виконайте у командному рядку такі дії.
+
+Ми хочемо відкрити консоль Python, тому введіть `python` на Windows або `python3` на Mac OS/Linux та натисніть `Enter`.
+
+{% filename %}командний рядок{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Ваша перша команда на Python!
+
+Після запуску консолі Python, як ми побачили, запрошення змінилось на `>>>`. Для нас це означає, що відтепер ми можемо користуватися лише командами мови Python (вони також називаються "інструкціями"). Вам не доведеться друкувати `>>>`, Python зробить це для вас сам.
+
+Якщо забажаєте вийти із консолі Python, наберіть `exit()` або використайте комбінацію клавіш `Ctrl + Z` для Windows і `Ctrl + D` для Mac/Linux. Після цього ви більше не побачите `>>>`.
+
+Але наразі ми не бажаємо виходити із консолі Python. Ми хочемо дізнатися про неї більше. Почнемо з чогось простенького. Наприклад, спробуйте набрати певний математичний вираз, на зразок `2 + 3`, та натисніть `Enter`.
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Чудово! Бачите, де з'явилась відповідь? Python знає математику! Можна спробувати інші команди, наприклад:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Для піднесення до степеня, наприклад 2 у степені 3, ми пишемо: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Поки що можете трохи побавитися із математикою, а далі повертайтесь назад :).
+
+Як бачите, Python є чудовим калькулятором. Мабуть вам цікаво, що ще можна робити?
+
+## Рядки
+
+Як щодо вашого імені? Наберіть ваше ім'я в лапках, як тут (можна писати кирилицею):
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+Щойно ви створили свій перший рядок (str)! Це послідовність символів, що може бути оброблена комп'ютером. Рядок має починатися і закінчуватися одним і тим же символом. Це може бути одинарна (`'`) або подвійна (`"`) лапка (немає ніякої різниці)! Лапки вказують Python, що всередині них рядок.
+
+Рядки можна об'єднувати. Спробуйте:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+Рядки можна не тільки додавати, але й множити на число:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Якщо вам раптом треба поставити апостроф всередині рядка, то існує два шляхи це зробити.
+
+Використавши подвійні лапки:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+або ж "екранувати" апостроф за допомогою оберненої скісної риски `\` (бекслеш, англ. backslash):
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Гарно, еге ж? Щоб побачити своє ім'я, написане великими літерами, наберіть:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+Ви щойно застосували до свого рядка **функцію** `upper`! Функція (така як `upper()`) - це набір інструкцій, які повинен виконувати Python над заданим об'єктом (`"Ola"`) після того, як ви її викликали.
+
+Якщо ви раптом забажаєте дізнатися число букв у вашому імені, то для цього також існує функція!
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Здивовані, чому іноді ви викликаєте функції із `.` наприкінці рядка (на зразок `"Ola".upper()`), а іноді ви спочатку викликаєте функцію, а рядок вказуєте після неї у дужках? Що ж, у деяких випадках функції належать об'єктам, як наприклад `upper()`, - це означає, що така функція може бути виконана лише над рядком. У цьому випадку ми називаємо функцію **методом**. В інших випадках функції не прив'язані до якогось конкретного об'єкта і можуть використовуватись над різними типами об'єктів, як наприклад `len()`. Саме тому ми використовуємо `"Ola"` у якості параметра для функції `len`.
+
+### Підсумок
+
+Гаразд, досить про рядки. Отже, ви вже ознайомилися із такими поняттями, як:
+
+- **консоль** – виконання команд (інструкцій коду) в консолі Python одразу показує їхній результат
+- **числа і рядки** – в Python числа використовуються для математичних виразів, а рядки – для текстових об'єктів
+- **оператори** – на зразок `+` та `*`, перетворюють одні значення на інші
+- **функції** – на зразок `upper()` та `len()`, виконують дії над об'єктами.
+
+Це є основи будь-якої мови програмування, яку ви вивчатимете. Готові приступити до чогось складнішого? Б'ємось об заклад, що так!
+
+## Помилки
+
+Спробуємо щось нове. Чи можемо ми отримати довжину числа тим же методом, як ми це робили для нашого імені? Наберіть `len(304023)` та натисніть `Enter`:
+
+{% filename %}{{ warning_icon }} командний рядок{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Ми отримали нашу першу помилку (error)! Іконка {{ warning_icon }} - це наш спосіб попередити вас, що код, який ви збираєтесь запустити, не буде працювати так, як очікувалося. Робити помилки (навіть навмисне) – важлива частина навчання!
+
+Отже, прочитаємо уважно текст помилки вище. У ньому йдеться про те, що це "помилка типу": об'єкт типу "int" (integers, цілі числа) не має довжини. І що ж нам тепер робити? Можливо, можна записати наше число у формі рядка? Рядки ж мають довжину, правда?
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Спрацювало! Ми використали функцію `str` всередині функції `len`. `str()` перетворює будь-що на рядок.
+
+- Функція `str` перетворює будь-який об'єкт на **рядок**
+- Функція `int` перетворює будь-який об'єкт на **ціле число** (якщо це можливо)
+
+> Важливо: ми можемо перетворити число на текст, однак не завжди можемо перетворити текст на число - чому б могло дорівнювати, наприклад, `int('hello')`?
+
+## Змінні
+
+Важливою концепцію в програмуванні є змінні. Змінна - це не більше, ніж ім'я для чогось, що можна буде використовувати пізніше. Програмісти використовують ці змінні для збереження даних, щоб зробити свій код більш читабельним, і в результаті їм не потрібно пам'ятати зайве.
+
+Скажімо, ми хочемо створити змінну і назвати її `name`:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+Бачите? Це просто! Просто: name дорівнює Ola.
+
+Як ви помітили, ваша програма не повернула нічого, на відміну від прикладів вище. Отже, як ми можемо бути певні, що змінна насправді існує? Просто введіть `name` і натисніть `Enter`:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Урра! Ваша перша змінна :)! Ви завжди можете змінити значення, на яке вона посилатиметься:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+Також можна використовувати її у функціях:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Файно, хіба ні? Звісно, змінні можуть представляти будь-що, наприклад числа! Спробуйте:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+А якщо ми використали неправильне ім'я? Як ви думаєте, що станеться? Спробуймо!
+
+{% filename %}{{ warning_icon }} командний рядок{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Помилка! Як бачите, Python має різні типи помилок, і дана помилка називається **NameError** ("помилка імені"). Python видасть цю помилку, якщо ви спробуєте використати досі не визначену змінну. Якщо ж ви зіткнетеся із цією помилкою пізніше, перевірте свій код, чи не зробили ви помилки в написанні імен змінних.
+
+Поекспериментуйте трохи із цим усім і подивіться, що тут можна робити!
+
+## Функція print
+
+Спробуйте таке:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Коли ви вводите просто `name`, інтерпретатор Python видає рядкове *представлення* змінної 'name', тобто набір літер M-a-r-i-a, взятий в одинарні лапки, ''. Коли ж ви пишете `print(name)`, Python "друкує" (англ. print) значення змінної на екран без лапок, що є більш елегантним.
+
+Як ми потім побачимо, `print()` є також корисним, коли ми хочемо надрукувати повідомлення зсередини функцій, або ж коли хочемо надрукувати щось у декілька рядків.
+
+## Списки
+
+Окрім рядків та чисел, Python має усі види різних типів об'єктів. Наразі ми збираємося представити вашій увазі один із них, він називається **список** (list). Списки є саме тим, про що ви й подумали: це об'єкти, які є списками інших об'єктів. :)
+
+Створимо список:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Так, цей список пустий. Не дуже корисно, так? Створимо список лотерейних номерів. Ми не бажаємо увесь час повторюватись, то ж покладемо усе до змінної:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+Гаразд, маємо список! Що ми можемо з ним робити? Давайте глянемо, скільки лотерейних номерів міститься у списку. Як ви думаєте, яку функцію для цього можна використати? Ви вже це знаєте!
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Так! Знайома вам функція `len()` може дати вам кількість об'єктів у списку. Зручно, правда ж? Тепер, можливо, ми захочемо відсортувати список:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Ця функція нічого не повертає, вона лише змінює порядок, в якому зберігаються числа у списку. Давайте надрукуємо список знову і подивимось, що ж сталося:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Як бачимо, числа у нашому списку тепер відсортовано, починаючи з найменшого і закінчуючи найбільшим значенням. Вітаємо!
+
+Можливо, ми хочемо відсортувати числа у зворотньому порядку? Давайте це зробимо!
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+Якщо ви забажаєте щось додати до свого списку, то можете це зробити за допомогою такої команди:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Якщо захочете показати лише перше число зі списку, то можете зробити це використавши **індекси**. Індекс - це порядковий номер, який повідомляє, з якої позиції у списку взято елемент. Програмісти люблять починати відлік з 0, отже перший об'єкт з вашого списку буде мати індекс 0, наступний - 1, і так далі. Спробуйте таке:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Як бачимо, ви можете отримати доступ до різних об'єктів списку, написавши індекс об'єкта всередині квадратних дужок після імені списку.
+
+Для того, щоб видалити що-небудь зі списку, вам потрібно використати **індекси**, які ви вже знаєте, і метод `pop()`. Давайте спробуємо на прикладі та згадаємо, що ми вивчили раніше; ми будемо видаляти перший елемент з нашого списку.
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Працює чудово!
+
+Для додаткового задоволення спробуйте різні індекси: 6, 7, 1000, -1, -6 або -1000. Подивіться, чи можете ви передбачити результат команди перед її застосуванням. Чи мають ці результати якийсь смисл?
+
+Список усіх доступних методів списку міститься у цьому розділі документації Python: https://docs.python.org/3/tutorial/datastructures.html
+
+## Словники
+
+> Для читачів вдома: відеоверсія цього розділу - [Основи Python: словники](https://www.youtube.com/watch?v=ZX1CVvZLE6c) (англ.).
+
+Словник (dict) є чимось подібним до списку (list), але доступ до значень отримується шляхом пошуку за ключем замість числового індексу. Ключ може являти собою будь-який рядок або число. Створити пустий словник можна так:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+Це показує, що ви щойно створили пустий словник. Урра!
+
+А тепер спробуйте набрати таку команду (можете підставити сюди вашу власну інформацію):
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+За допомогою вказаної команди ви щойно створили змінну-словник із назвою `participant` і трьома парами ключ-значення:
+
+- Ключ `name` (ім'я) вказує на значення `'Ola'` (об'єкт `рядок`),
+- `country` (країна) вказує на `'Poland'` (інший `рядок`),
+- нарешті, `favorite_number` (улюблені числа) вказує на `[7, 42, 92]` ( `список` з трьома числами всередині).
+
+Можна перевірити значення індивідуальних ключів, використовуючи такий синтаксис:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Бачите, усе подібно до списку. Але вам не треба пам'ятати індекс – треба знати лише ім'я.
+
+Що трапиться якщо запитати Python про значення ключа, який не існує? Не здогадуєтесь? Давайте спробуємо і подивимось!
+
+{% filename %}{{ warning_icon }} командний рядок{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Погляньте, інша помилка! Цього разу - **KeyError** ("помилка ключа"). Python допомагає і підказує вам, що ключа `'age'` (вік) не існує в даному словнику.
+
+Коли ж варто використовувати словник, а коли список? Що ж, гарне питання. Подумайте над ним перед тим, як подивитися відповідь у наступному рядку.
+
+- Вам необхідна лише впорядкована послідовність елементів? Користуйтеся списком.
+- Вам потрібні значення, асоційовані із ключами, так щоб ви могли легко їх знаходити (за допомогою ключа)? Користуйтеся словником.
+
+Словники, як і списки, є *змінюваними*, це означає що вони можуть бути змінені після того, як створені. Ви можете додати нові пари ключ-значення до словника після того, як він був створений, наприклад:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Як і для списків, функція `len()` для словників повертає кількість пар ключ-значення в словнику. Наберіть команду:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+Сподіваємося, це наразі має сенс. :) Готові до ще більшого задоволення від роботи зі словниками? Читайте далі, щоб побачити дещо дивовижне.
+
+Ви можете використовувати метод `pop()` для видалення елемента зі словника. Скажімо, якщо ви бажаєте видалити значення, що відповідає ключу `'favorite_numbers'`, наберіть таку команду:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Як бачимо з результатів, пару ключ-значення, що відповідає ключу 'favorite_numbers', було видалено.
+
+Також можна змінити значення, асоційоване з ключем, який вже існує у словнику. Наберіть:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+Як бачимо, значення ключа `'country'` було змінено із `'Poland'` на `'Germany'`. :) Вражаюче? Ура! Ви щойно освоїли ще одну дивовижну річ.
+
+### Підсумок
+
+Чудово! Тепер ви знаєте багато про програмування. У цій останній частині ви дізналися про такі поняття, як:
+
+- **помилки** – тепер ви знаєте, як читати та розуміти помилки, які з'являються, якщо Python не розуміє введеної команди;
+- **змінні** – імена для об'єктів, що дозволяють вам спростити процес написання коду і зробити його більш читабельним;
+- **списки** – послідовності об'єктів, впорядкованих певним чином;
+- **словники** – об'єкти, що містять пари ключ-значення.
+
+Не дочекаєтеся переходу до наступної частини? :)
+
+## Порівняння
+
+> Для читачів вдома: відеоверсія цього розділу - [Основи Python: порівняння](https://www.youtube.com/watch?v=7bzxqIKYgf4) (англ.).
+
+Велика частина програмування — це порівняння. Що є найпростішою річчю для порівняння? Звісно, числа. Давайте подивимось, як це працює:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+Ми надали Python деякі числа для порівняння та отримали результат: True (істина) або False (хиба). Як бачимо, Python порівнює не тільки числа, але може й порівнювати значення математичних виразів (на зразок `2 * 2`) або результати функцій, такі як `2` , що повертається функцією `len([4, 5])`. Гарно, еге ж?
+
+Цікаво, чому ми використали два однакові знаки `==`, щоб перевірити, чи є числа рівними? Ми використовуємо один знак `=` для присвоєння значень змінним. Тому **завжди** треба писати два знаки `==`, якщо ви бажаєте здійснити перевірку двох чисел на рівність одне одному. Ми також можемо перевіряти, чи є два об'єкти нерівними. Для цього ми використовуємо символи `!=`, як показано в прикладі вище.
+
+Задайте для Python ще дві задачі:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+Щодо `>` та `<` начебто зрозуміло, але що означають `>=` та `<=`? Читайте їх так:
+
+- x `>` y означає: x більше y
+- x `<` y означає: x менше y
+- x `<=` y означає: x менше або дорівнює y
+- x `>=` y означає: x більше або дорівнює y
+
+Чудово! Хочете ще? Спробуйте це:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+Ви можете давати Python стільки чисел для порівняння, скільки заманеться, і він дасть вам результат! Дуже розумно, чи не так?
+
+- **and** – якщо з'єднати дві умови оператором `and` ("та"), то результат буде істинним (True) лише у випадку, коли обидві умови істинні (True);
+- **or** – якщо з'єднати дві умови оператором `or` ("або"), то результат буде істинним (True), коли хоча б одна з умов – істинна (True).
+
+Чули колись вираз "порівнювати тепле з м'яким"? Давайте спробуємо щось подібне у Python:
+
+{% filename %}{{ warning_icon }} командний рядок{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Бачимо, що як і у тому жартівному виразі, Python не в змозі порівняти число (`int`) та рядок (`str`). Натомість виводиться **TypeError** ("помилка типу"), яка повідомляє нам про те, що ці два типи не можна порівнювати між собою.
+
+## Логічний тип даних
+
+Між іншим, ви щойно дізналися про новий тип даних в Python. Він називається **логічним типом** (або булевим, bool).
+
+Можливо, це найпростіший тип. Існує лише два значення логічного типу:
+
+- Істинне: True
+- Хибне: False
+
+Але для того, щоб Python міг це зрозуміти, треба завжди писати 'True' (перша літера – велика, а решта – маленькі). **true, TRUE, tRUE не працюють -- лише True є правильним** (Те ж саме стосується і 'False').
+
+Логічні значення також можуть бути змінними! Погляньте:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+Можна зробити теж саме і по-іншому:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Попрактикуйте з логічними виразами, спробувавши запустити такі команди:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Вітання! Логічні значення – одна із найкрутіших властивостей програмування, і ви щойно освоїли, як їх застосовувати!
+
+# Збережіть!
+
+> Для читачів вдома: відеоверсія цього розділу – [Основи Python: збереження файлів та інструкція "if"](https://www.youtube.com/watch?v=dOAg6QVAxyk) (англ.).
+
+Досі ми писали весь наш Python-код в інтерпретаторі, що обмежує нас написанням лише одного рядка за раз. Зазвичай програми зберігаються у файлах і виконуються **інтерпретатором** або **компілятором** нашої мови програмування. Досі ми запускали наші програми одним рядком в **інтерпретаторі** Python. Для наступних задач нам знадобиться більше, ніж один рядок коду, отже нам потрібно:
+
+- Закрити інтерпретатор Python
+- Відкрити редактор коду, який ми обрали
+- Зберегти певний код у Python-файлі
+- Запустити його!
+
+Щоб вийти з інтерпретатора Python, яким ми користувалися до цього, наберіть функцію `exit()`:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Ви повернетеся назад до командного рядка.
+
+Раніше ми вже обрали для себе редактор коду в розділі [Редактор коду](../code_editor/README.md). А тепер ми маємо відкрити цей редактор і написати якийсь код в новому файлі (якщо ви використовуєте хромбук, створіть новий файл у хмарному IDE і відкрийте цей файл там же у редакторі коду):
+
+{% filename %}редактор коду{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Очевидно, ви тепер є досить досвідченою Python-програмісткою, отже можете написати у ваш код усе, що ви до цього часу вивчили.
+
+А тепер треба зберегти файл і дати йому описове ім'я. Назвіть файл **python_intro.py** і збережіть його на вашому робочому столі. Ви можете назвати файл як завгодно, тільки важливо, щоб назва закінчувалась на **.py**. Закінчення **.py** говорить нашій операційної системи, що це **виконуваний файл Python** і Python може його запускати.
+
+> **Примітка:** Ви повинні помітити одну з найкрутіших фіч редакторів коду: кольори! У консолі Python все було одного кольору, тепер же ви бачите, що функція `print` має інший колір, ніж рядок, який вона друкує. Це називається "підсвічуванням синтаксису", і це справді корисна функція для програмістів. Різний колір слів дає вам підказку про незакриті лапки рядка чи орфографічну помилку в ключовому слові (згодом зверніть увагу на колір слова `def` в описі функції). Це одна з вагомих причин, чому ми використовуємо редактор коду. :)
+
+По тому, як файл успішно збережено, час запустити його! Згадуючи, чому ви навчились у розділі про командний рядок, скористайтеся терміналом, щоб **змінити директорію** на робочий стіл.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+Для Mac команда буде виглядати так:
+
+{% filename %}командний рядок{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+Для Linux команда буде на зразок
+
+{% filename %}командний рядок{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Пам'ятайте, що слово "Desktop" може бути перекладене вашою мовою.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+У командному рядку Windows це буде так:
+
+{% filename %}командний рядок{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+А у Windows Powershell команда буде такою:
+
+{% filename %}командний рядок{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Якщо ви застрягли, попросіть допомоги. Це як раз той випадок, коли треба турбувати тренера.
+
+Тепер ви можете виконати ваш код у файлі, викликаючи Python:
+
+{% filename %}командний рядок{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Примітка: у Windows команди 'python3' немає. Замість цього виконуйте файл командою 'python':
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Гаразд! Ви щойно запустили вашу першу Python-програму, яка була збережена у файлі. Чудові відчуття?
+
+Тепер ви можете переходити до важливого інструменту в програмуванні:
+
+## If … elif … else
+
+Часто певні дії у нашій програмі мають відбуватись лише тоді, коли виконуються задані умови. Саме тому Python має інструмент, який називається **інструкцією if (якщо)**.
+
+Замініть код у вашому файлі **python_intro.py** на такий:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+Якщо ми збережемо цей файл і запустимо його, то побачимо таку помилку:
+
+{% filename %}{{ warning_icon }} командний рядок{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+    (Помилка синтаксису: неочікуваний кінець файлу у рядку 2)
+    
+
+Python очікує від нас подальших інструкцій, які будуть виконані у разі, якщо умова `3 > 2` виявиться істинною (тобто `True`). Спробуємо змусити Python надрукувати “It works!” ("Воно працює!"). Змініть код у вашому файлі **python_intro.py** на такий:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Звернули увагу, що ми зробили відступ в 4 пробіли для наступного рядка коду? Це необхідно для того, щоб Python знав, який шматок коду запускати у разі, якщо умова істинна. Можна зробити відступ і в один пробіл, але майже усі Python-програмісти роблять відступ у 4 пробіли, щоб було акуратніше. Клавіша Tab також додає 4 пробіли (якщо ви не налаштували свій редактор інакше). Як зробите вибір, вже не змінюйте його! Якщо ви почали робити відступ з 4 пробілами, робіть такими ж і всі інші відступи у програмі – інакше ви можете зіткнутися з проблемами.
+
+Збережіть і запустіть знову:
+
+{% filename %}командний рядок{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Примітка: Пам'ятайте, що у Windows немає команди 'python3'. Тому, коли виконуєте файл, пишіть 'python' замість 'python3'.
+
+### А що, коли умова не істинна (тобто False)?
+
+У попередніх прикладах код виконувався, лише коли умови були істинними – True. Однак Python також має інструкції `elif` (інакше якщо) та `else` (інакше):
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 дійсно більше ніж 2')
+else:
+    print('5 не більше ніж 2')
+```
+
+Коли це все запустимо, то отримаємо на виході:
+
+{% filename %}командний рядок{% endfilename %}
+
+    $ python3 python_intro.py
+    5 дійсно більше ніж 2
+    
+
+Якщо б число 2 було більшим за 5, то тоді виконалась би друга команда замість першої. Просто, правда ж? Подивимося як працює `elif`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+і в результаті:
+
+{% filename %}командний рядок{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+Бачите, що тут відбувається? `elif` вказує додаткові умови для перевірки, якщо результат попередніх – невдалий.
+
+Ви можете додати стільки виразів `elif`, скільки вам до вподоби, одразу після виразу `if`. Наприклад (задамо гучність музики у змінній volume):
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("Якось тихо")
+elif 20 <= volume < 40:
+    print("Це добре для фонової музики")
+elif 40 <= volume < 60:
+    print("Чудово, я можу почути всі нотки")
+elif 60 <= volume < 80:
+    print("Добре для вечірки")
+elif 80 <= volume < 100:
+    print("Трохи гучно!")
+else:
+    print("Мої вуха болять! :(")
+```
+
+Python послідовно виконує всі перевірки та друкує:
+
+{% filename %}командний рядок{% endfilename %}
+
+    $ python3 python_intro.py
+    Чудово, я можу почути всі нотки
+    
+
+## Коментарі
+
+Коментарі – це рядки коду, які починаються з `#`. Ви можете написати будь-що після `#` і Python його проігнорує. Коментарі можуть спростити ваш код та допомогти іншим людям (да і вам самим) пізніше зрозуміти ваш код.
+
+Давайте подивимось, як це виглядає:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Відрегулюемо звук, якщо занадто гучно або занадто тихо
+if volume < 20 or volume > 80:
+    volume = 50
+    print("Так краще!")
+```
+
+Вам не потрібно писати коментар для кожного рядка коду, але коментарі є корисними для того, щоб пояснити, чому ваш код робить саме це, або ж надати короткий опис, коли робиться щось складне.
+
+### Підсумок
+
+В останніх трьох вправах ви освоїли такі поняття як:
+
+- **Порівняння** – в Python можна порівнювати елементи використовуючи `>`, `>=`, `==`, `<=`, `<` та оператори `and`, `or`;
+- **Логічний тип (Boolean)** – тип об'єкту, що може приймати лише одне з двох значень: `True` (істинне) або `False` (хибне);
+- **Збереження файлів** – зберігання коду в файлах дозволяє виконувати більші за розміром програми;
+- **if...elif...else** – інструкції, що дозволяють виконувати код, лише коли задовольняються певні умови.
+- **Коментарі** – рядки коду, які Python не запускає, але які дозволяють вам документувати код.
+
+Час для останньої частини цього розділу!
+
+## Ваші власні функції!
+
+> Для читачів вдома: відеоверсія цього розділу - [Основи Python: функції](https://www.youtube.com/watch?v=5owr-6suOl0) (англ.).
+
+Пам'ятаєте функції на зразок `len()`, що можна виконувати в Python? Що ж, гарні новини – зараз ви дізнаєтесь, як писати свої власні функції!
+
+Функція - це набір інструкцій, які Python повинен виконати. Кожна функція в Python починається із ключового слова `def`, має ім'я і може мати певні параметри (вони записуються у дужках). Почнемо з простого. Замініть код у вашому файлі **python_intro.py** на такий:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Окей, наша перша функція готова!
+
+Ви можете запитати, для чого ми вдруге написали ім'я функції наприкінці файлу. Коли ми пишемо `def hi():` та подальші рядки з відступом, це ми задаємо інструкції, які повинна робити функція `hi()`. Python прочитає та запам'ятає ці інструкції, але виконувати їх поки не буде. Щоб сказати Python, що ми хочемо запустити функцію, нам потрібно викликати функцію за допомогою команди `hi()`. Python читає файл і виконує його згори донизу, тому потрібно описати функцію раніше (тобто вище), ніж запустити її.
+
+А тепер запустимо і подивимось, що відбудеться:
+
+{% filename %}командний рядок{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Примітка: якщо це не спрацює, не хвилюйтеся! Прочитайте уважно повідомлення, що виведеться на екран. Воно допоможе Вам зрозуміти, що сталося:
+
+- Якщо ви отримаєте `NameError` (помилку імені), це, мабуть, означає, що ви ввели неправильне ім'я: тоді треба перевірити, що ви використовуєте одне й те ж ім'я під час створення функції через `def hi():` і коли викликаєте її за допомогою `hi()`.
+- Якщо у вас `IndentationError` (помилка відступу), перевірте, чи мають обидва рядки `print` однакову кількість пробілів на початку рядка: Python хоче, щоб весь код всередині функції був чітко вирівняний.
+- Якщо ж на екран взагалі нічого не вивелося, перевірте, що *немає* пробілів перед останнім `hi()`, – якщо вони є, цей рядок також стане частиною функції і ніколи не запуститься.
+
+А тепер побудуємо нашу першу функцію з параметрами. Скористаємося попереднім прикладом, але тепер нехай функція, що говорить 'hi', звертається на ім'я до особи, яка її запускає:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+Як бачимо, зараз ми задали для нашої функції параметр, який назвали `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Пам'ятайте: функція `print` відділена відступами від команди `if` на чотири пробіли. Це тому, що функція запускається, коли виконується умова. Давайте подивимося, як це працює зараз:
+
+{% filename %}{{ warning_icon }} командний рядок{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Ой, помилка. На щастя, Python надає нам дуже корисне повідомлення про помилку. Воно повідомляє нам про те, що функція `hi()` (та, яку ми визначили) має один обов'язковий аргумент (`name`) і що ми забули передати цей аргумент, коли здійснювали виклик функції. Виправимо це наприкінці файлу:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+І запустимо знову:
+
+{% filename %}командний рядок{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+А якщо ми змінимо ім'я?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+Запустимо:
+
+{% filename %}командний рядок{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+А як ви думаєте, що відбудеться, якщо ми вкажемо тут інше ім'я? (Не Ola і не Sonja.) Спробуємо і подивимося, чи ви маєте рацію. Маємо отримати на виході:
+
+{% filename %}командний рядок{% endfilename %}
+
+    Hi anonymous!
+    
+
+Чудово, чи не так? Таким чином, вам не потрібно повторюватись кожного разу, коли ви захочете змінити ім'я особи, з якою має вітатися ваша функція. І саме тому нам потрібні функції – ви ж бо ніколи не хочете повторювати свій код!
+
+Виконаємо дещо складніші маніпуляції – існує безліч імен, набагато більше, ніж два, і написати умови для кожного з них буде досить складно, правда ж? Змініть вміст вашого файлу на такий:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+А тепер виконаємо програму:
+
+{% filename %}командний рядок{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Вітаємо! Ви щойно розібралися з тим, як писати функції :)
+
+## Цикли
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Зміст
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/uk-UA/template_extending/README.md b/uk-UA/template_extending/README.md
new file mode 100644
index 00000000000..52adf547271
--- /dev/null
+++ b/uk-UA/template_extending/README.md
@@ -0,0 +1,151 @@
+# Розширення шаблону
+
+Інша хороша річ, яку має Django в своєму арсеналі це **шаблонне розширення**. Що це означає? А це означає, що ви можете використовувати одні й ті ж частини свого HTML коду для різних сторінок веб сайту.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+Базовий шаблон - це основний шаблон, який ви будете розширювати для кожної сторінки вашого веб сайту.
+
+Створимо файл `base.html` в `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Далі для `base.html`, перепишіть усю частину для `<body>` (усе між `<body>` і `</body>`) на наступне:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). Скоро ми покажемо вам як це зробити.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Наступним чином:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/uk-UA/whats_next/README.md b/uk-UA/whats_next/README.md
new file mode 100644
index 00000000000..ec2fef789f5
--- /dev/null
+++ b/uk-UA/whats_next/README.md
@@ -0,0 +1,43 @@
+# Що далі?
+
+Привітайте себе! **Ви абсолютно неймовірні**. Ми пишаємося вами! <3
+
+### Що тепер робити?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Чи можете ви порекомендувати інші джерела?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/uk/GLOSSARY.md b/uk/GLOSSARY.md
index 21fed491ffc..08b01aca215 100644
--- a/uk/GLOSSARY.md
+++ b/uk/GLOSSARY.md
@@ -1,2 +1,3 @@
 # Редактор коду
-Редактор коду - це програма, що дозволяє зберегти ваш код, так що можна повернутися до його редагування пізніше. Ви можете дізнатися, звідки його взяти з розділу [про текстовий редактор](./code_editor/README.md)
+
+Редактор коду - це додаток, що дозволяє зберегти ваш код, так що можна повернутися до його редагування пізніше. Ви можете дізнатися, звідки його взяти з [розділу про текстовий редактор](./code_editor/README.md)
\ No newline at end of file
diff --git a/uk/README.md b/uk/README.md
index 39af52cf8d7..82f1a431d7e 100644
--- a/uk/README.md
+++ b/uk/README.md
@@ -1,45 +1,51 @@
-# Навчальний посібник Django Girls
-[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+# Навчальний посібник - Django Girls Tutorial
 
-> Ця робота ліцензована міжнародною ліцензією Creative Commons Attribution-ShareAlike 4.0
-International License. Щоб переглянути копію цієї ліцензії, відвідайте
-https://creativecommons.org/licenses/by-sa/4.0/
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
 
-## Translation
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
 
-This tutorial has been translated from English by a group of awesome volunteers: [chupakabra](https://github.com/chupakabra), [Oleksandr Redko](https://github.com/alexandear), [Taras Bunyk](https://github.com/bunyk), [msihor](https://crowdin.com/profile/msihor), [Olesia Hrydzhuk](https://github.com/Zlira), [Andriy Kohut](https://github.com/andriykohut), [Artem Suchov](https://crowdin.com/profile/suchov), [Artem Godlevskyi](https://github.com/errno), [Alex Vykalyuk](https://crowdin.com/profile/alekzvik), [Kostyantyn Leschenko](https://crowdin.com/profile/kleschenko). Special thanks for all the free time they sacrificed to make that happen! <3
+## Welcome
 
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
 
 ## Вступ
 
-Чи ви коли-небудь відчували, що світ крутиться все більше і більше навколо технологій, а ви в певній мірі пасете задніх? Чи вас колись цікавило, як створити веб-сайт, однак, ніколи не вистачало достатньої мотивації, щоб почати? Чи ви колись вважали, що світ програмування є занадто складним для вас, щоб навіть пробувати робити щось самостійно?
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Чи вас колись цікавило як створити веб сайт, однак, ніколи не вистачало достатньої мотивації щоб почати? Чи ви колись вважали, що світ програмування є занадто складним для вас, щоб навіть пробувати робити щось самостійно?
 
-Що ж, маємо гарні новини для вас! Програмування - це не так складно, як може здатися, і ми хочемо вам показати, наскільки веселим цей процес може бути.
+Що ж, маємо гарні новини для вас! Програмування це не так складно як може здаватися і ми хочемо вам показати наскільки веселим цей процес може бути.
 
-Даний навчальний посібник не перетворить вас магічним чином на програміста. Якщо ви хочете розбиратися у цьому, то вам потрібні будуть для цього місяці або навіть роки теорії та практики. Однак ми хочемо показати вам, що програмування або створення веб сайтів не є настільки складним, як це здається. Спробуємо пояснити різні поняття настільки, наскільки зуміємо, то ж ви не будете почуватися заляканими технологіями.
+This tutorial will not magically turn you into a programmer. Якщо ви хочете розбиратися у цьому, то вам потрібні будуть для цього місяці або навіть роки теорії та практики. Однак, ми хочемо показати вам, що програмування або створення веб сайтів не є настільки складним, як це здається. Спробуємо пояснити різні поняття настільки, наскільки зуміємо, то ж ви не будете почуватися заляканими технологіями.
 
-Сподіваємось, ми зможемо навчити вас полюбити технології настільки, наскільки любимо їх ми самі!
+Сподіваємось, що що ми зможемо змусити вас полюбити технології настільки, наскільки любимо їх ми самі!
 
 ## Що ви вивчите під час освоєння посібника?
 
-По завершенню даного посібника, ви будете мати простий робочий веб-додаток - свій власний блог. Ми покажемо вам як опублікувати його в Інтернеті, тож інші також зможуть оцінити вашу роботу!
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
 
 Це буде (в більшій чи меншій мірі) виглядати наступним чином:
 
-![Рисунок 0.1](images/application.png)
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Ми попросили наших інструкторів і попередніх учасників бути там час від часу і допомагати іншим із освоєнням матеріалу! Не бійтеся задавати свої питання!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
 
-> Якщо ви працюєте над матеріалами самостійно і не маєте інструктора, що зміг би допомогти у разі певної проблеми, для вас існує чат: [![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/DjangoGirls/tutorial?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge). Ми попросили наших інструкторів і попередніх учасників бути там час від часу та допомагати іншим із освоєнням матеріалу! Не бійтеся задавати свої питання!
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
 
-Гаразд, [почнемо з самого початку...](./how_the_internet_works/README.md)
+In every chapter already covered, there is a link that points to the correct video.
 
 ## Коротка інформація та вклад
 
 Цей посібник підтримується спільнотою [DjangoGirls](https://djangogirls.org/). Якщо ви знайдете якісь помилки або захочете зробити певні оновлення, будь ласка, [виконуйте вказівки з частини про вклад](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
 
-## Чи не бажаєте допомогти нам із перекладом посібника на інші мови?
+## Would you like to help us translate the tutorial into other languages?
 
-На даний момент, переклади підтримуються на платформі crowdin.com:
+Currently, translations are being kept on crowdin.com platform at:
 
 https://crowdin.com/project/django-girls-tutorial
 
-Якщо ваша мова не перерахована на crowdin, будь ласка, [відкрийте нову тему](https://github.com/DjangoGirls/tutorial/issues/new), що інформує про мову, таким чином ми зможемо додати її.
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/uk/SUMMARY.md b/uk/SUMMARY.md
index ea34bf8e38d..a69c5d3fbcc 100644
--- a/uk/SUMMARY.md
+++ b/uk/SUMMARY.md
@@ -2,6 +2,7 @@
 
 * [Вступ](README.md)
 * [Встановлення](installation/README.md)
+* [Installation (chromebook)](chromebook_setup/README.md)
 * [Як працює Інтернет](how_the_internet_works/README.md)
 * [Вступ до командного рядку](intro_to_command_line/README.md)
 * [Встановлення Python](python_installation/README.md)
@@ -14,13 +15,13 @@
 * [Django адміністратор](django_admin/README.md)
 * [Розгортання!](deploy/README.md)
 * [Django urls](django_urls/README.md)
-* [Django відображення - час творити!](django_views/README.md)
+* [Django views – time to create!](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)
+* [CSS – make it pretty](css/README.md)
+* [Розширення шаблону](template_extending/README.md)
 * [Розширте свою програму](extend_your_application/README.md)
 * [Django форми](django_forms/README.md)
-* [Що далі?](whats_next/README.md)
+* [Що далі?](whats_next/README.md)
\ No newline at end of file
diff --git a/uk/chromebook_setup/README.md b/uk/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/uk/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/uk/chromebook_setup/instructions.md b/uk/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/uk/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/uk/code_editor/README.md b/uk/code_editor/README.md
index da85dfaae1c..1e6db4d8f7e 100644
--- a/uk/code_editor/README.md
+++ b/uk/code_editor/README.md
@@ -1,7 +1,11 @@
 # Редактор коду
 
-Наближаємось до написання нашого першого рядка коду, отже, настав час завантажити редактор коду!
+> Для тих, хто це читає вдома: ця глава присвячена [Інсталяції Python& Редактору коду](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
 
-> **Примітка** Ви могли зробити це раніше у розділі "Встановлення" - якщо вже завантажили редактор, то можете відразу перейти до наступного розділу!
+Наближаємось до написання нашого першого рядка коду, отже настав час завантажити редактор коду!
 
-{% include "/code_editor/instructions.md" %}
+> **Примітка** Якщо ви користуєтеся Chromebook, попустіть цей розділ і впевнено виконайте інструкції з [Установлення Chromebook](../chromebook_setup/README.md).
+> 
+> **Примітка** Ви могли вже зробити це у розділі "Встановлення" - якщо так, можете одразу перейти до наступного розділу!
+
+{% include "code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/uk/code_editor/instructions.md b/uk/code_editor/instructions.md
index 4f6cce57793..af6d94796a4 100644
--- a/uk/code_editor/instructions.md
+++ b/uk/code_editor/instructions.md
@@ -1,34 +1,31 @@
-Існує багато різноманітних редакторів і здебільшого все зводиться до персональних вподобань. Більшість Python програмістів використовують складні, але надзвичайно потужні IDE (англ. Integrated Development Environments - інтегровані середовища розробки), такі як PyCharm. Однак, вони менш доцільні для початківців; ми пропонуємо такі ж потужні, але більш простіші інструменти.
+Існує багато різноманітних редакторів і здебільшого все зводиться до персональних вподобань. Більшість Python програмістів використовують складні, але надзвичайно потужні IDE (англ. Integrated Development Environments - Інтегровані середовища розробки), такі як PyCharm. Однак, вони можливо менш доцільні для початківців; ми пропонуємо не менш потужні, але більш простіші. 
 
-Нижче наведено перелік наших вподобань, але ви також можете попросити поради в своїх тренерів - тоді буде простіше отримувати від них допомогу.
+Нижче наведено перелік наших вподобань, але спитайте наставників про їхню думку - і це полегшить отримання їхньої допомоги.
 
 ## Gedit
 
 Gedit є відкритим, безкоштовним редактором, доступним для усіх операційних систем.
 
-[Завантажте його можна тут](https://wiki.gnome.org/Apps/Gedit#Download)
+[Завантажте його тут](https://wiki.gnome.org/Apps/Gedit#Download)
 
 ## Sublime Text 3
 
-Sublime Text є дуже популярним редактором із безкоштовним пробним періодом. Він легко встановлюється та простий у використанні, а також доступний для усіх операційних систем.
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
 
-[Завантажити його можна тут](https://www.sublimetext.com/3)
+[Завантажте його тут](https://www.sublimetext.com/3)
 
 ## Atom
 
-Atom - це найновіший редактор коду, створений [GitHub](https://github.com/). Він є безкоштовним, відкритим, легко встановлюється та простий у користуванні. Доступний для Windows, OSX і Linux.
-
-[Завантажити його можна тут](https://atom.io/)
-
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
 
+[Завантажте його тут](https://atom.io/)
 
 ## Чому ми встановлюємо редактор коду?
 
-Ви напевне запитуєте себе, чому ми встановлюємо спеціальний редактор для коду, а не використовуємо щось на зразок Word чи Notepad.
-
-По-перше, код повинен зберігатись як **звичайний текст**, а проблемою таких програм як Word чи Textedit є те, що вони не створюють звичайний текст, вони продукують так званий "збагачений" текст (зі шрифтами та форматуванням), використовуючи спеціальні формати, такі як [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+Ви напевне запитуєте себе чому ми встановлюємо спеціальний редактор для коду, а не використовуємо щось на зразок Word чи Notepad.
 
-Другою причиною є те, що редактори коду спеціалізуються саме на редагуванні коду, тому вони можуть запропонувати корисні функції на зразок підсвітки коду залежно від його значення чи автоматичного закривання дужок.
+По перше, код повинен зберігатись як **звичайний текст**, а проблема з такими програмами як Word чи Textedit полягає в тому що вони не зберігають файли зі звичайним текстом, вони створюють "збагачений" текст (зі шрифтами та форматуванням), використовуючи спеціальні формати на зразок [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
 
-Ми побачимо все це в дії пізніше. Скоро ви вважатимете свого вірного редактора коду одним із найулюбленіших інструментів :)
+Другою причиною є те, що редактори коду спеціалізуються саме на редагуванні, тому вони можуть запропонувати корисні функції на зразок розфарбовування коду залежно від його значення чи автоматичного закривання дужок.
 
+Ми побачимо це все в дії пізніше. Скоро ви вважатимете свого вірного старого редактора коду одним зі своїх улюблених інструментів. :)
\ No newline at end of file
diff --git a/uk/css/README.md b/uk/css/README.md
index f84307689ea..11db1e6d11d 100755
--- a/uk/css/README.md
+++ b/uk/css/README.md
@@ -1,110 +1,115 @@
-# CSS - зроби це красиво!
+# CSS – make it pretty!
 
 Наш блог все ще виглядає доволі жахливо, чи не так? Час зробити його гарним! Для цього будемо використовувати CSS.
 
 ## Що таке CSS?
 
-Каскадні таблиці стилів (англ. Cascading Style Sheets, скорочено CSS) - спеціальна мова, що використовується для опису зовнішнього вигляду і форматування сайту написаного мовою розмітки (як HTML). Сприймайте це, як свого роду макіяж для нашої веб-сторінки;).
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
 
-Але ми ж не хочемо починати знову все з нуля, правда? А візьмемо знову щось, що вже було створене програмістами і опубліковано в Інтернеті для вільного користування. Ви ж знаєте, знову винаходити велосипед зовсім не весело.
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
 
 ## Скористаємось Bootstrap!
 
-Bootstrap - один з найбільш популярних HTML і CSS фреймворків для розробки прекрасних веб-сайтів: https://getbootstrap.com/
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
 
-Він був написаний програмістами, які працювали для Twitter'у і на сьогоднішній день удосконалюється волонтерами з усього світу.
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
 
-## Встановлення Boostrap
+## Встановлюємо Boostrap
 
-Для встановлення Bootstrap, вам потрібно додати наступні рядки у розділ `<head>` вашого `.html` файлу (`blog/templates/blog/post_list.html`):
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
 ```
 
-Це не додасть жодного файлу до вашого проекту. Натомість ці рядки просто вказують на файли опубліковані в інтернеті.
-Просто рухайтесь вперед, відкрийте ваш веб-сайт і оновіть сторінку. Ось так!
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
 
 ![Рисунок 14.1](images/bootstrap1.png)
 
 Вже краще!
 
-
 ## Статичні файли в Django
 
-Нарешті, ми детальніше розглянемо те, що ми називали __статичними файлами__. Статичні файли включають усі ваші CSS файли та картинки - файли, які не є динамічними, а отже, їхній вміст не залежить від змісту запиту і буде однаковим для усіх користувачів.
-
+Нарешті, ми детальніше розглянемо те, що ми називали **статичними файлами**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
 
 ### Де помістити статичні файли для Django
 
-Як ви бачили, коли ми запускали `collectstatic` на сервері, Django вже знає, де знайти статичні файли для вбудованого додатку "admin". Тепер нам просто потрібно додати деякі статичні файли для нашого власного додатку `blog`.
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
 
-Створимо директорію `static` всередині додатку blog:
+Створимо директорію з ім’ям `static` всередині додатку blog:
 
     djangogirls
     ├── blog
     │   ├── migrations
-    │   └── static
+    │   ├── static
+    │   └── templates
     └── mysite
+    
 
-Django автоматично знайде всі "статичні" папки всередині будь-якої з папок з вашими додатками, і він буде мати можливість використовувати їх як статичні файли.
-
-
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
 
 ## Ваш перший CSS файл!
 
-Що ж, тепер давайте створимо CSS файл для того, щоб додати ваш власний стиль до вашої веб-сторінки. Створіть нову папку з назвою `css` всередині вашої папки `static`. Потім всередині цієї папки`css` створіть новий файл `blog.css`. Готові?
+Let's create a CSS file now, to add your own style to your web page. Створіть нову папку з назвою `css` всередині вашої папки `static`. Потім всередині цієї папки`css` створіть новий файл з назвою `blog.css`. Готові?
 
     djangogirls
     └─── blog
          └─── static
               └─── css
                    └─── blog.css
+    
 
-Настав час написати CSS! Відкрийте файл `static/css/blog.css` в редакторі коду.
+Настав час написати CSS! Відкрийте файл `static/css/blog.css` в обраному редакторі коду.
 
-Не будемо тут занурюватись надто глибоко в процес налаштування і вивчення CSS, оскільки це так просто, що ви можете вивчити цей матеріал самостійно після завершення воркшопу. Ми наполегливо рекомендуємо пройти курс [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web) для того, щоб вивчити все, що вам потрібно знати про оформлення веб-сайтів за допомогою CSS.
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
 
-Але принаймні попрацюємо трохи. Може ми могли б змінити колір заголовка?
-Щоб зрозуміти кольори, комп'ютери використовують спеціальні коди. Вони починаються з `#` і далі слідують 6 літер (A-F), а також цифри (0-9). Ви можете знайти коди кольорів, наприклад, тут: http://www.colorpicker.com/. Також можете користуватися вже [визначеними кольорами](http://www.w3schools.com/colors/colors_names.asp), такими як `red` та `green`.
+Але принаймні попрацюємо трохи. Можливо, ми могли б змінити колір заголовка? Щоб зрозуміти кольори, комп'ютери використовують спеціальні коди. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. Також можете користуватися вже [визначеними кольорами ](http://www.w3schools.com/colors/colors_names.asp), такими як `red` та `green`.
 
 У вашому файлі `static/css/blog.css` потрібно додати наступний код:
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 h1 a {
     color: #FCA205;
 }
 ```
 
-`h1 a` - CSS селектор. Це означає, що ми застосовуємо наші стилі до кожного елементу `a` всередині елементу `h1` (наприклад, коли ми маємо в коді щось на зразок: `<h1><a href="">link</a></h1>`). У цьому випадку, ми повідомляємо про те, що треба змінити колір на `#FCA205`, тобто помаранчевий. Звичайно, ви можете визначити тут ваш власний колір!
+`h1 a` -- CSS селектор. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. У цьому випадку, ми повідомляємо про те, що треба змінити колір на `#FCA205`, тобто помаранчевий. Звичайно, ви можете визначити тут ваш власний колір!
 
-В CSS файлі ми визначаємо стилі для елементів файлу HTML. Елементи ідентифікуються іменами (тобто `a`, `h1`, `body`), атрибутом `class` або атрибутом `id`.
-Class і id - імена, які ви присвоюєте елементам власноруч. Класи (сlasses) визначають групи елементів, а ідентифікатори (id), в свою чергу, вказують на специфічні елементи. Наприклад, наступний тег може бути ідентифікований CSS з використанням тегового імені `a`, класу `external_link`, або ідентифікатора `link_to_wiki_page`:
+В CSS файлі ми визначаємо стилі для елементів файлу HTML. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class і id -- імена, які ви присвоюєте елементам власноруч. Класи (сlasses) визначають групи елементів, а ідентифікатори (id), в свою чергу, вказують на специфічні елементи. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
 
 ```html
 <a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
 ```
 
-Читайте про [CSS селектори на w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
 
-Далі, нам треба повідомити наш HTML-шаблон про те, що ми додали CSS. Відкрийте файл `blog/templates/blog/post_list.html` і додайте на початок цей рядок:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
 ```
 
-Тут лише завантажуються статичні файли :)
-Далі, між `<head>` і `</head>`, після посилань на CSS файли Bootstrap додайте цей рядок:
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <link rel="stylesheet" href="{% static 'css/blog.css' %}">
 ```
-Браузер читає файли в порядку їх слідування, тому ми повинні впевнитись, що код написаний в правильному місці. Інакше, код в нашому файлі може перекривати код із файлів Bootstrap.
-Ми щойно повідомили наш шаблон, де розташовані наші CSS файли.
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. Ми щойно повідомили наш шаблон де розташовані наші CSS файли.
 
 Тепер ваш файл має виглядати наступним чином:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -130,31 +135,37 @@ Class і id - імена, які ви присвоюєте елементам в
 </html>
 ```
 
-Добре, збережіть файл і перезавантажте сторінку!
+OK, збережіть файл і перезавантажте сторінку!
 
 ![Рисунок 14.2](images/color2.png)
 
 Чудова робота! Можливо, ми також хотіли б дати нашому веб-сайту трохи повітря і збільшити відступ зліва? Давайте спробуємо!
 
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
 ```css
 body {
     padding-left: 15px;
 }
 ```
 
-Додайте це до вашого CSS, збережіть файл і подивіться, як це працює!
+Add that to your CSS, save the file and see how it works!
 
 ![Рисунок 14.3](images/margin2.png)
 
-Може ми могли б також налаштувати шрифт нашого заголовка? Вставте це всередину розділу `<head>` файлу `blog/templates/blog/post_list.html`:
+Можливо, ми могли б також налаштувати шрифт нашого заголовка? Вставте це всередину розділу `<head>` файлу `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
-<link href="https://fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
 ```
 
-Цей рядок імпортує шрифт із назвою *Lobster* із колекції шрифтів Google (https://www.google.com/fonts).
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
 
-Знайдіть блок визначення стилю `h1 a` (код між фігурними дужками `{` і `}`) в CSS файлі `blog/static/css/blog.css`. Тепер додайте Тепер додайте рядок `font-family: 'Lobster';` між дужками і перезавантажте сторінку:
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 h1 a {
@@ -167,10 +178,11 @@ h1 a {
 
 Чудово!
 
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
 
-Як було зазначено вище, CSS має концепцію класів. Вона дозволяє вам іменувати частину HTML коду і застосовувати стилі лише до цієї частини без будь-якого ефекту на інші частини. Це буває надзвичайно корисним. Скажімо, у вас є два блоки div, але вони виконують зовсім різні функції (як ваш заголовок і пост). Клас дозволяє вам зробити їх вигляд різним.
+Дайте імена певним частинам HTML коду. Додайте клас із назвою `page-header` до блоку `div`, що містить ваш заголовок, як це зроблено тут:
 
-Дайте імена певним частинам HTML коду. Додайте клас `page-header` до блоку `div`, що містить ваш заголовок, як це зроблено тут:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <div class="page-header">
@@ -180,6 +192,8 @@ h1 a {
 
 А тепер додайте клас `post` до вашого блоку `div`, що містить сам допис.
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="post">
     <p>published: {{ post.published_date }}</p>
@@ -188,7 +202,9 @@ h1 a {
 </div>
 ```
 
-А тепер додамо визначення блоків для різних селекторів. Селектори, які починаються із символу `.` стосуються класів. Існує багато хороших посібників і пояснень CSS у Вебі, що можуть допомогти вам зрозуміти наступний код. Поки що, просто скопіюйте і вставте це у ваш файл `mysite/static/css/blog.css`:
+А тепер додамо визначення блоків для різних селекторів. Селектори, які починають із символу `.` стосуються класів. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. Поки що, просто скопіюйте і вставте це у ваш файл `mysite/static/css/blog.css`:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
 
 ```css
 .page-header {
@@ -212,7 +228,6 @@ h1, h2, h3, h4 {
 }
 
 .date {
-    float: right;
     color: #828282;
 }
 
@@ -240,7 +255,9 @@ h1, h2, h3, h4 {
 }
 ```
 
-Далі обгорніть HTML код, що відображає пости, визначеннями класів. Замініть це:
+Далі модифікуйте HTML код, що відображує пости. Замініть:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
@@ -254,6 +271,8 @@ h1, h2, h3, h4 {
 
 в `blog/templates/blog/post_list.html` на:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <div class="content container">
     <div class="row">
@@ -272,16 +291,14 @@ h1, h2, h3, h4 {
 </div>
 ```
 
-Збережіть ці файли і перезавантажте веб-сайт.
+Збережіть файли і перезавантажте свій сайт.
 
 ![Рисунок 14.4](images/final.png)
 
-Юхууу! Виглядає прекрасно, чи не так?
-Код, який ми щойно вставили, насправді не є складним для розуміння і ви в змозі зрозуміти більшу його частину після прочитання.
-
-Не бійтеся трохи повозитися з цим CSS файлом і спробуйте поміняти деякий код. Якщо щось зламається, не хвилюйтесь, ви завжди можете відмінити попередню дію!
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
 
-В будь-якому разі, дуже рекомендуємо пройти цей безкоштовний онлайн [Codeacademy HTML & CSS курс](https://www.codecademy.com/tracks/web). Він допоможе вам вивчити усе, що потрібно знати про оформлення веб-сайтів за допомогою CSS.
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
 
-Готові до наступного розділу?! :)
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
 
+Готові до наступного розділу?! :)
\ No newline at end of file
diff --git a/uk/deploy/README.md b/uk/deploy/README.md
index 99badc01230..55ac7a29ef2 100755
--- a/uk/deploy/README.md
+++ b/uk/deploy/README.md
@@ -1,22 +1,18 @@
 # Розгортання!
 
-> **Зауваження** Цей розділ може бути дещо складним для освоєння. Наполегливо продовжуйте і дійдіть до кінця; розгортання - важлива частина процесу розробки веб-сайту. Цей розділ розташований посередині посібника, щоб ваш наставник зміг допомогти із дещо хитрим процесом випуску веб-сайту в Інтернет. Це означає, що ви все ще можете завершити цей курс самостійно, якщо раптом не встигаєте.
+> **Зауваження** Цей розділ інколи може бути дещо складним для освоєння. Наполегливо продовжуйте і дійдіть до кінця; розгортання -- важлива частина процесу розробки веб-сайту. Цей розділ розташований посередині посібника, щоб ваш наставник зміг допомогти із дещо хитрим процесом випуску веб-сайту в Інтернет. Це означає, що ви все ще можете завершити цей курс самостійно, якщо раптом не встигаєте. 
 
-До цього часу ваш веб-сайт був доступний лише локально на вашому комп'ютері, тепер ви дізнаєтесь, як його розгорнути! Розгортання - це процес публікації вашого додатку в Інтернеті таким чином, що люди можуть зайти і побачити його :).
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Розгортання -- це процес публікації вашого додатку в Інтернеті таким чином, що люди можуть зрештою зайти і побачити його. :)
 
-Як ви вже знаєте, веб-сайт має бути розміщений на сервері. В Інтернеті є багато компаній які пропонують такі послуги. Ми будемо використовувати той, який має відносно простий розгортання процес: [PythonAnywhere](https://pythonanywhere.com/). PythonAnywhere безкоштовний для малих додатків, в яких не дуже багато користувачів, тож нам цього точно буде достатньо.
+Як ви вже знаєте, веб-сайт має бути розміщений на сервері. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
 
 Інший зовнішній інструмент, який ми будемо використовувати - це [GitHub](https://www.github.com), платформа для розміщення коду. У нього є альтернативи, але майже кожен програміст зараз має GitHub профіль, і скоро ви будете серед них!
 
-Ці три місця є дуже важливими для вас. Ваш локальний комп'ютер буде місцем, де ви розробляєте і тестуєте. Після того, як впевнитесь в змінах, ви перемістите копію програми на GitHub. Веб-сайт буде на PythonAnywhere і ви оновите його, роблячи нову копію коду з GitHub.
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
 
 # Git
 
-Git - це "система контролю версій", яка використовується багатьма розробниками. Ця програма дозволяє відслідковувати зміни у файлах з часом так, що ви можете повернутись до певних версій пізніше. Схоже на функцію "слідкувати за змінами" в Microsoft Word, але набагато потужніше.
-
-## Встановлення Git
-
-> **Примітка** Якщо ви вже виконали процес встановлення, немає потреби робити це ще раз, - можете перейти до наступного кроку і почати створення свого Git репозиторію.
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
 
 {% include "/deploy/install_git.md" %}
 
@@ -24,51 +20,61 @@ Git - це "система контролю версій", яка викорис
 
 Git відслідковує зміни певних файлів в репозиторії коду (коротко – "репо"). Давайте створимо "репо" для нашого проекту. Відкрийте вашу консоль та запустіть наступні команди в папці `djangogirls`:
 
-> **Примітка** Перевірте поточну директорію за допомогою команд `pwd` (OSX/Linux) або `cd` (Windows) перед стартом репозиторію. Ви маєте бути в папці `djangogirls`.
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. Ви маєте бути в папці `djangogirls`.
+
+{% filename %}command-line{% endfilename %}
 
     $ git init
     Initialized empty Git repository in ~/djangogirls/.git/
     $ git config --global user.name "Your Name"
     $ git config --global user.email you@example.com
+    
 
-Створення git-репозиторію відбувається тільки один раз на кожен проект (і тобі більше не потрібно буде заново вводити ім'я чи електронну пошту).
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
 
-Git стежитиме за змінам всіх файлів у цій директорії, але є певні файли, які ми хочемо ігнорувати. Ми зробимо це шляхом створення файлу з назвою `.gitignore` в базовій директорії. Відкрий свій редактор і створи новий файл з наступним змістом:
+Git стежитиме за змінам у всіх файлах у цій директорії, але є певні файли які ми хочемо ігнорувати. Ми зробимо це шляхом створення файлу з назвою `.gitignore` в базової директорії. Відкрий свій редактор і створити новий файл з наступним змістом:
 
-```
-*.pyc
-__pycache__
-myvenv
-db.sqlite3
-/static
-.DS_Store
-```
+{% filename %}.gitignore{% endfilename %}
 
-І збережи його як `.gitignore` в директорії "djangogirls".
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
 
-> **Примітка** Крапка на початку імені файлу важлива! У разі виникнення будь-яких труднощів при створенні (наприклад, Mac не любить, коли через Finder створюють файли, імена яких починаються з крапки), використовуйте "Зберегти як" у редакторі, це повинно спрацювати.
+And save it as `.gitignore` in the "djangogirls" folder.
 
-> **Примітка** Одним із файлів, вказаних в `.gitignore` є `db.sqlite3`. Цей файл є вашою локальною базою даних, де зберігаються пости. Ми не хочемо додавати його до нашого репозиторію, тому що веб-сайт на PythonAnywhere використовуватиме іншу базу. Ця база даних може бути SQLite, як на вашій локальній машині, але зазвичай, ми будемо використовувати базу MySQL, яка може обслуговувати набагато більше відвідувачів сайту, ніж SQLite. У всякому разі, ігнорування бази даних SQLite для копії коду на GitHub, означає, що всі створені вами пости залишаться і будуть доступні локально, але ви можете додати їх також і на продакшн. Ви повинні думати про локальну базу як про хороший майданчик, де можна тестувати різні речі і не боятися, що можна видалити реальні пости з блогу.
+> **Примітка** Крапка на початку імені файлу важлива! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
 
-Перед тим, як виконати команду `git add` (також, коли ви просто не впевненні що змінилось) непоганою ідеєю буде виконати `git status`. Це допоможе уникнути сюрпризів, наприклад, додавання чи коміту небажаного файлу. Команда `git status` повертає інформацію про файли у вашому репозиторії: untracked (не додані до репозиторію файли), modified (змінені файли), staged (файл додані до коміту), статус поточної гілки і багато іншого. Вивід повинен бути схожий на:
+Перед тим як виконати команду `git add` (також, коли ви просто не впевненні що змінилось) непоганою ідеєю буде виконати `git status`. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
 
     $ git status
     On branch master
-
+    
     Initial commit
-
+    
     Untracked files:
       (use "git add <file>..." to include in what will be committed)
-
+    
             .gitignore
             blog/
             manage.py
             mysite/
-
+    
     nothing added to commit but untracked files present (use "git add" to track)
+    
 
 Зрештою, зберігаємо наші зміни. Перейдіть до консолі і виконайте наступні команди:
 
+{% filename %}command-line{% endfilename %}
+
     $ git add --all .
     $ git commit -m "My Django Girls app, first commit"
      [...]
@@ -76,233 +82,179 @@ db.sqlite3
      create mode 100644 .gitignore
      [...]
      create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Ходімо перевіримо!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Давайте завантажимо наш код з GitHub у PythonAnywhere клонувавши наш репозиторій. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
 
-
-## Викладемо наш код на GitHub
-
-Відкриємо [GitHub.com](https://www.github.com) і створимо новий безкоштовний обліковий запис. (Ті хто зробили це ще на етапі підготовки - справжні молодці!)
-
-Створимо новий репозиторій з назвою "my-first-blog". Залишимо опцію "initialise with a README" не вибраною, .gitignore порожньою (пізніше ми додамо це вручну) і License також залишимо як None.
-
-<img src="images/new_github_repo.png" />
-
-> **Примітка** Ім'я `my-first-blog` важливе - ви можете вибрати щось інше, але воно буде використовуватись багато разів в інструкціях нижче, і потрібно буде замінити його кожного разу. Мабуть легше просто його залишити як `my-first-blog`.
-
-В наступному екрані ми побачимо посилання для клонування репозиторію - clone URL, скопіюємо його і вставимо у термінал:
-
-<img src="images/github_get_repo_url_screenshot.png" />
-
-Зараз нам потрібно під'єднати Git репозиторій на локальному комп'ютері до щойно створеного на GitHib.
-
-Введіть у вашій консолі (замінивши `<ваше-github-ім'я>` іменем користувача, вказаним під час створення облікового запису GitHub, але без кутових дужок):
-
-    $ git remote add origin https://github.com/<ваше-github-ім'я>/my-first-blog.git
-    $ git push -u origin master
-
-Введемо наше ім'я користувача та пароль від GitHub, і побачимо щось на зразок:
-
-    Username for 'https://github.com': hjwp
-    Password for 'https://hjwp@github.com':
-    Counting objects: 6, done.
-    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
-    Total 3 (delta 0), reused 0 (delta 0)
-    To https://github.com/hjwp/my-first-blog.git
-     * [new branch]      master -> master
-    Branch master set up to track remote branch master from origin.
-
-<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extention -->
-
-Ваш код тепер на GitHub. Ходімо перевіримо! Виявляється, він у хорошій компанії - [Django](https://github.com/django/django), [Цей посібник](https://github.com/DjangoGirls/tutorial) і багато інших чудових проектів з відкритим вихідним кодом також публікуються на GitHub :)
-
-
-# Налаштування нашого блогу на PythonAnywhere
-
-> **Примітка** Можливо, ви вже створили обліковий запис на PythonAnywhere під час підготовки - якщо це так, немає необхідності робити це знову.
-
-{% include "/deploy/signup_pythonanywhere.md" %}
-
-
-## Завантажимо наш код на PythonAnywhere
-
-Після входу до PythonAnywhere, ми опинимось на головній панелі або сторінці "Consoles". Виберемо опцію почати нову "bash" консоль (Start a new console - bash) - це PythonAnywhere версія консолі, схожа на ту, що на вашому комп'ютері.
-
-> **Примітка** PythonAnywhere побудований на основі Linux, тому, якщо ви на Windows, консоль буде трохи відрізнятись від тієї, що на вашому комп'ютері.
-
-Давайте завантажимо наш код з GitHub у PythonAnywhere, клонувавши наш репозиторій. Наберіть наступне у консолі PythonAnywhere (не забудьте використовувати ім'я користувача GitHub замість `< ваше-github-ім'я>`):
-
-    $ git clone https://github.com/<ваше-github-ім'я>/my-first-blog.git
-
-Ця команда завантажить копію вашого коду на PythonAnywhere. Давайте перевіримо, набравши `tree my-first-blog`:
-
-    $ tree my-first-blog
-    my-first-blog/
-    ├── blog
-    │   ├── __init__.py
-    │   ├── admin.py
-    │   ├── migrations
-    │   │   ├── 0001_initial.py
-    │   │   └── __init__.py
-    │   ├── models.py
-    │   ├── tests.py
-    │   └── views.py
-    ├── manage.py
-    └── mysite
-        ├── __init__.py
-        ├── settings.py
-        ├── urls.py
-        └── wsgi.py
-
-
-### Створення virtualenv на PythonAnywhere
-
-Так само як і на власному комп'ютері, створіть virtualenv на PythonAnywhere. У консолі Bash введіть:
-
-```
 $ cd my-first-blog
 
-$ virtualenv --python=python3.4 myvenv
-Running virtualenv with interpreter /usr/bin/python3.4
-[...]
-Installing setuptools, pip...done.
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
 
 $ source myvenv/bin/activate
 
-(mvenv) $  pip install django whitenoise
-Collecting django
-[...]
-Successfully installed django-1.8.2 whitenoise-2.0
-```
-
-
-> **Примітка** Крок `pip install` може зайняти кілька хвилин. Терпіння і ще раз терпіння! Але якщо він займає більш ніж 5 хвилин, щось пішло шкереберть. Попросіть допомоги у вашого тренера.
-
-<!--TODO: think about using requirements.txt instead of pip install.-->
-
-
-### Збирання статичних файлів.
-
-Можливо ви поцікавились, що за штука цей "whitenoise"? Це інструмент для обслуговування так званих "статичних файлів". Статичні файли - це файли, які зазвичай не змінюються і не виконують ніякого коду, наприклад, HTML чи CSS файли. На серверах вони працюють інакше, ніж на вашому локальному комп'ютері, щоб сервер міг їх віддавати, нам потрібен спеціальний інструмент, такий як "whitenoise".
-
-Пізніше, коли ми змінимо CSS для нашого сайту, ми дізнаємось трохи більше про статичні файли.
-
-Поки що нам просто потрібно виконати додаткову команду `collectstatic` на сервері. Ця команда каже Django про усі статичні файли на сервері, які йому потрібні. На даний момент це в основному файли, що допомагають зробити красивою сторінку адміністрування.
-
-    (mvenv) $ python manage.py collectstatic
-
-    You have requested to collect static files at the destination
-    location as specified in your settings:
-
-        /home/edith/my-first-blog/static
-
-    This will overwrite existing files!
-    Are you sure you want to do this?
-
-    Type 'yes' to continue, or 'no' to cancel: yes
-
-Введемо "yes" і помчали! Чи не прекрасно, коли ми можемо змусити комп'ютер друкувати незрозумілий текст сторінка за сторінкою? Кожного разу я додаю невеликий звуковий супровід: дир-дир-дир...
-
-    Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/actions.min.js'
-    Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/js/inlines.min.js'
-    [...]
-    Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/changelists.css'
-    Copying '/home/edith/my-first-blog/mvenv/lib/python3.4/site-packages/django/contrib/admin/static/admin/css/base.css'
-    62 static files copied to '/home/edith/my-first-blog/static'.
-
-
-### Створимо базу даних на PythonAnywhere
-
-Ось ще одна річ, яка відрізняється на локальному комп'ютері і на сервері: вони використовують різні бази даних. Так що облікові записи користувачів і статті блогу можуть відрізнятися на сервері і локальному комп'ютері.
-
-Ми можемо ініціалізувати базу даних на сервері таким самим чином, як і на локальному комп'ютері - з допомогою `migrate` і `createsuperuser`:
-
-
-    (mvenv) $ python manage.py migrate
-    Operations to perform:
-    [...]
-      Applying sessions.0001_initial... OK
-
-
-    (mvenv) $ python manage.py createsuperuser
-
-
-## Опублікуємо наш блог як веб-додаток
-
-Тепер наш код на PythonAnywhere, віртуальне середовище готове, статичні файли зібрані, база даних встановлена. Ми готові до публікації веб-додатку!
-
-Перейдемо до панелі керування PythonAnywhere, натиснувши на лого сайту і виберемо вкладку **Web**. Тепер натиснемо **Add a new web app**.
-
-Після підтвердження нашого доменного імені, виберемо ручне налаштування (**manual configuration**) у діалоговому вікні, зверніть увагу: варіант "Django" нам *не годиться*. Далі виберемо **Python 3.4** і натиснемо Next для завершення.
-
-> **Примітка** Пересвідчіться, що ви вибрали варіант "Manual configuration", а не "Django". Ми занадто круті для стандартних налаштувань PythonAnywhere для Django ;-)
-
-
-### Налаштуємо virtualenv
-
-Ми опинились на сторінці налаштувань веб-додатку на PythonAnywhere. Сюди слід переходити, якщо ви хочете зробити якісь зміни до додатку на сервері.
-
-
-<img src="images/pythonanywhere_web_tab_virtualenv.png" />
-
-У розділі "Vitrualenv" натиснемо на червоний текст "Enter the path to a virtualenv" (введіть шлях до virtualenv) і напишемо: `/home/<your-username>/my-first-blog/myvenv/`. Перед тим, як продовжити, натиснемо синю кнопку з галочкою, щоб зберегти шлях.
-
-> **Примітка** Замініть <your-username> на своє ім'я користувача. Якщо ви помилитесь, PythonAnywhere покаже вам невеличке попередження.
-
-
-### Сконфігуруємо WSGI файл
-
-Django використовує у роботі "WSGI протокол" - стандарт взаємодії веб-додатків на Python із веб-серверами. Він підтримується PythonAnywhere. Отже, поредагувавши конфігураційний файл WSGI, ми дозволимо PythonAnywhere розпізнати наш блог на Django.
-
-Перейдемо за посиланням напроти "WSGI configuration file" (у розділі "Code" близько до початку сторінки - посилання матиме якусь таку назву: `/var/www/<your-username>_pythonanywhere_com_wsgi.py`). Ми опинились на сторінці з редактором.
-
-Зітремо весь вміст файлу і замінимо його таким:
-
-```python
-import os
-import sys
-
-path = '/home/<your-username>/my-first-blog'  # use your own username here
-if path not in sys.path:
-    sys.path.append(path)
-
-os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
-
-from django.core.wsgi import get_wsgi_application
-from whitenoise.django import DjangoWhiteNoise
-application = DjangoWhiteNoise(get_wsgi_application())
-```
-
-> **Примітка** Не забудьте вказати своє ім'я користувача замість `<your-username>`
-> **Примітка** Третій рядок вказує PythonAnywhere, як знайти наш додаток. Дуже важливо, щоб цей шлях був коректним і щоб не було зайвих пробілів. Інакше ви побачите "ImportError" в логах помилок.
-
-Завдання цього файлу - розповісти PythonAnywhere, де живе наш веб-додаток і як знайти файл із налаштуванням Django. Також він налаштовує інструмент для статичних файлів "whitenoise".
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. Пізніше, коли ми змінимо CSS для нашого сайту, ми дізнаємось трохи більше про статичні файли.
 
 Натиснемо **Save** і перейдемо назад до вкладки **Web**.
 
 Готово! Натискаємо на велику зелену **Reload** кнопку і можемо глянути на свій веб-додаток. Посилання на нього вгорі сторінки.
 
+## Підказки для налагодження
 
-## Підказки для відлагодження (debug)
-
-Якщо відвідавши ваш сайт, побачили повідомлення про помилку, найперше, куди слід подивитись - це **лог помилок**. Перейти до нього можна із [вкладки Web](https://www.pythonanywhere.com/web_app_setup/) PythonAnywhere. Гляньте, чи є там повідомлення про помилки; найновіші будуть внизу файлу. Найчастіше трапляються такі проблеми:
-
-- Забули ввести одну із команд у консолі: створення віртуального середовища, його активацію, встановлення туди Django, збирання статичних файлів, міграцію бази даних.
+Якщо, спробувавши відвідати свій сайт, ви побачили повідомлення про помилку, перше місце, куди слід подивитись - це **лог помилок**. Перейти до нього можна із [вкладки Web](https://www.pythonanywhere.com/web_app_setup/) PythonAnywhere. Гляньте, чи там є повідомлення про невдачі; найнедавніші будуть внизу файлу. Найчастіше трапляються такі проблеми:
 
-- Зробили опечатку в шляху до virtualenv на вкладці Web - в такому разі, там можна буде побачити маленьке червоне повідомлення про помилку.
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
 
-- Помилились у конфігураційному файлі WSGI - перевірте шлях до своєї директорії my-first-blog.
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
 
-- Ви точно вибрали таку ж версію Python для віртуального середовища, як і для веб-додатку? Обидві повинні мати версію 3.4.
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
 
-- Ось деякі [загальні підказки для налагодження у PythonAnywhere вікі](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+- Ви точно вибрали таку ж версію Python для віртуального середовища як і для веб-додатку? Обидві повинні бути 3.6.
 
-Пам'ятайте, що ваш тренер може допомогти!
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
 
+Пам'ятайте, з вами тренер, щоб допомагати!
 
 # Ми вийшли у світ!
 
-На сторінці за замовчуванням нашого сайту має бути напис "Welcome to Django" так само, як і на вашому локальному комп'ютері. Спробуємо додати `admin` у кінці URL і опинимось у панелі адміністратора. Використаємо для входу логін і пароль та побачимо, що тут можна додавати нові пости на сервер.
-
-
-*ДОБРЯЧЕ* похваліть себе! Розгортання на сервер - один з найхитромудріших етапів веб-розробки. Зазвичай люди витрачають дні, щоб усе запрацювало. Але вам вдалось вийти у справжній інтернет, запросто!
+The default page for your site should say "It worked!", just like it does on your local computer. Спробуємо додати `admin` у кінці URL і опинимось на адміністративній панелі сайту. Використаємо для входу логін і пароль і побачимо, що тут можна додавати нові пости на сервер.
 
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
 
+*ДОБРЯЧЕ* поплескайте себе по спині! Розгортання на сервер -- один з найхитромудріших етапів веб-розробки. Зазвичай люди витрачають дні, щоб усе запрацювало. Але вам вдалось вийти у справжній інтернет, запросто!
\ No newline at end of file
diff --git a/uk/deploy/install_git.md b/uk/deploy/install_git.md
index 8420e591bee..83cecebca45 100644
--- a/uk/deploy/install_git.md
+++ b/uk/deploy/install_git.md
@@ -1,28 +1,52 @@
+Git - це "система контролю версій", яка використовується багатьма розробниками. Ця програма дозволяє відслідковувати зміни до файлів з часом так, що ви можете повернутись до певних версій пізніше. Схоже на функцію "слідкувати за змінами" в Microsoft Word, але набагато потужніше.
 
-### Windows
+## Встановлення Git
 
-Git можна завантажити з [git-scm.com](https://git-scm.com/). Ви можете натискати "next next next" на всіх кроках окрім одного. На п’ятому кроці, названому "Adjusting your PATH environment", виберіть "Run Git and associated Unix tools from the Windows command-line" (нижня опція). Крім цього, стандартні налаштування добрі. Вимкніть закінчення рядків в стилі Windows, ввімкніть в стилі Unix, вони кращі.
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
 
-### Mac OS
+Ви можете завантажити Git з [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Крім цього, стандартні налаштування добрі. Вимкніть закінчення рядків в стилі Windows, ввімкніть в стилі Unix, вони кращі.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
 
 Завантажте Git з [git-scm.com](https://git-scm.com/) і просто слідуйте вказівкам.
 
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
 
-### Linux
+{% filename %}command-line{% endfilename %}
 
-Якщо Git не встановлений, то він має бути доступний через менеджер пакетів, тому спробуйте:
+```bash
+$ sudo apt-get install git
+```
 
+<!--endsec-->
 
-#### Debian або Ubuntu
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
 
-    $ sudo apt-get install git
+{% filename %}command-line{% endfilename %}
 
+```bash
+$ sudo dnf install git
+```
 
-#### Fedora
+<!--endsec-->
 
-    $ sudo dnf install git
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
 
+{% filename %}command-line{% endfilename %}
 
-#### openSUSE
+```bash
+$ sudo zypper install git
+```
 
-    $ sudo zypper install git
+<!--endsec-->
\ No newline at end of file
diff --git a/uk/deploy/signup_pythonanywhere.md b/uk/deploy/signup_pythonanywhere.md
index 12ee7b6ca76..ca66bd0de69 100644
--- a/uk/deploy/signup_pythonanywhere.md
+++ b/uk/deploy/signup_pythonanywhere.md
@@ -1,8 +1,5 @@
-
-Тепер час для створення безкоштовного "Beginner" акаунту на PythonAnywhere.
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
 
 * [www.pythonanywhere.com](https://www.pythonanywhere.com/)
 
-
-> **Примітка** При виборі імені користувача, пам'ятайте, що URL-адреса блогу матиме вигляд `yourusername.pythonanywhere.com`, так що зупиніться або на вашому ніку, або на імені, пов'язаному з тематикою блогу.
-
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/uk/django/README.md b/uk/django/README.md
index 2c30e036c46..077e8654da4 100755
--- a/uk/django/README.md
+++ b/uk/django/README.md
@@ -1,27 +1,27 @@
 # Що таке Django?
 
-Django (_/ˈdʒæŋɡoʊ/ джанго_) - безкоштовний і відкритий фреймворк для створення веб додатків, написаний мовою програмування Python. Веб фреймворк - набір компонентів, які допомагають розробляти веб-сайти швидше і простіше.
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. Веб фреймворк - набір компонентів, які допомагають розробляти веб-сайти швидше і простіше.
 
-При побудові веб-сайту, ви завжди потребуєте схожого набору компонентів: спосіб управління авторизацією користувача (створення акаунту, вхід, вихід), панель управління, форми, спосіб завантажити файли, тощо.
+При побудові веб-сайту, ви завжди потребуєте схожого набору компонентів: способу управління авторизацією користувача (створення акаунту, вхід, вихід), панелі управління, форм, способу завантажити файли, тощо.
 
-На щастя для вас інші люди вже давно помітили, що веб розробники зіштовхуються з подібними проблемами під час розробки нового сайту, отже вони об'єднались в команду і створили фреймворки (Django є одним з таких), що дають вам вже готові до використання компоненти.
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
 
-Фреймворки існують для того, щоб вберегти вас від необхідності повторно винаходити велосипед і допомогти зменшити деякі накладні витрати під час розробки нового сайту. 
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
 
 ## Навіщо вам потрібен фреймворк?
 
-Щоб зрозуміти для чого насправді розроблений Django, потрібно ближче розглянути роботу серверу. Першочергово сервер повинен знати про те, що ви бажаєте щоб він обслуговував ваш сайт.
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
 
-Уявіть собі поштову скриньку (порт), котра моніториться на вхідні листи (запити). Це здійснюється веб сервером. Веб сервер читає листа і відсилає відповідь із веб-сторінкою. Але коли ви бажаєте відправити дещо, вам потрібно мати деякий вміст. І Django є інструментом, котрий допомагає вам створити цей контент.
+Уявіть собі поштову скриньку (порт), котра моніториться на вхідні листи (запити). Це здійснюється веб сервером. The web server reads the letter and then sends a response with a webpage. Але коли ви бажаєте відправити дещо, вам потрібно мати деякий вміст. І Django є інструментом, котрий допомагає вам створити цей контент.
 
 ## Що трапляється коли хтось надсилає запит на веб-сайт з вашого серверу?
 
-Коли на веб-сервер надходить запит, він перенаправляється на Django, котрий намагається з'ясувати на що конкретно був запит. Спочатку береться адреса веб-сторінки і Django намагається з'ясувати, що робити. Ця частина роботи здійснюється таким компонентом Django як __urlresolver__ (зауважте, що адреса веб-сайту називається URL - Uniform Resource Locator - отже ім'я *urlresolver* має сенс). Це не дуже складний елемент - вилучається список шаблонів і відбуваються спроби знайти підходящий URL. Django перевіряє шаблони у порядку слідування і якщо якийсь із них відповідає адресі веб-сторінки Django надсилає запит до асоційованої функції (котра має назву *view*).
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
 
-Уявіть собі листоношу з листом. Він йде по вулиці і звіряє номер кожного будинку з тим, що вказаний в адресі отримувача. Якщо номер співпадає, він кладе листа в скриньку. Аналогічним чином працює і urlresolver!
+Уявіть листоношу з листом. Вона йде по вулиці і звіряє номер кожного будинку з тим що вказаний в адресі отримувача. Якщо номер співпадає, вона кладе листа в скриньку. Аналогічним чином працює urlresolver!
 
-Всередині функції *view* відбуваються найцікавіші речі: щоб знайти деяку інформацію, ми можемо подивитися в базу даних. Можливо, користувач може попросити зробити певні зміни даних? На зразок листа, що говорить "Будь ласка, змініть опис моєї роботи." Елемент *view* може перевірити чи дозволено вам це зробити, потім оновлює опис роботи для вас і відправляє зворотнє повідомлення: "Виконано!". Далі блок *view* генерує відповідь і Django може відправити її до веб браузера користувача.
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Можливо, користувач може попросити зробити певні зміни даних? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
 
 Звичайно, вище наведені пояснення є трохи спрощеними, але вам не потрібно знати усіх технічних деталей поки що. Достатньо мати загальне уявлення.
 
-Отже замість того, щоб надто занурюватись у деталі, ми просто почнемо щось створювати із використанням Django і вивчимо усі важливі складові на цьому шляху!
+Отже замість того, щоб надто занурюватись у деталі, ми просто почнемо щось створювати із використанням Django і вивчимо усі важливі складові на цьому шляху!
\ No newline at end of file
diff --git a/uk/django_admin/README.md b/uk/django_admin/README.md
index de2e6babcf2..748382664e2 100755
--- a/uk/django_admin/README.md
+++ b/uk/django_admin/README.md
@@ -1,8 +1,10 @@
 # Django адміністратор
 
-Щоб додавати, редагувати і видаляти пости, які ми щойно змоделювали, використаємо Django адміністратор.
+To add, edit and delete the posts we've just modeled, we will use Django admin.
 
-Відкриймо файл `blog/admin.py` і замінимо його зміст на наступні рядки:
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
 
 ```python
 from django.contrib import admin
@@ -13,29 +15,43 @@ admin.site.register(Post)
 
 Як можна побачити, ми імпортуємо (включаємо) модель посту Post визначену у попередньому розділі. Щоб зробити нашу модель видимою на сторінці адміністратора, потрібно зареєструвати модель за допомогою `admin.site.register(Post)`.
 
-Гаразд, час поглянути на нашу модель Post. Не забудьте виконати в консолі команду `python manage.py runserver` для того щоб запустити сервер. Відкрийте браузер, введіть адресу http://127.0.0.1:8000/admin/ і ви побачите сторінку входу схожу на цю:
+Гаразд, час поглянути на нашу модель Post. Не забудьте виконати в консолі команду `python manage.py runserver` для того щоб запустити сервер. Go to your browser and type the address http://127.0.0.1:8000/admin/. Ви побачите сторінку входу наступного зразку:
 
 ![Сторінка авторизації](images/login_page2.png)
 
-Щоб ввійти, потрібно створити *суперкористувача (superuser)* - користувача, котрий може контролювати все на сайті. Поверніться до командного рядка, наберіть `python manage.py createsuperuser`, і натисніть клавішу Enter. Коли вас про це запитають, введіть логін користувача (маленькими буквами без пропусків), адресу email та пароль. Не хвилюйтеся, що ви не можете бачити пароль який вводите – так і повинно бути. Просто введіть його і натисніть `Enter` щоб продовжити. Вихідний результат має виглядати наступним чином (де ім'я користувача і email повинні містити ваші дані):
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
     Username: admin
     Email address: admin@admin.com
     Password:
     Password (again):
     Superuser created successfully.
+    
 
-Поверніться до вашого браузера і здійсніть вхід використовуючи логін та пароль щойно створеного суперкористувача; ви маєте побачити робочу панель адміністратора Django.
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
 
-![Django адміністратор](images/django_admin3.png)
+![Django admin](images/django_admin3.png)
 
-Перейдіть в Posts та поекспериментуйте з ними трошки. Додайте п’ять-шість постів. Не переживайте за вміст, можете просто скопіювати якийсь текст з цього підручника щоб зберегти час :).
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
 
-Переконайтесь у тому, що принаймні два або три поста (але не всі) мають встановлену дату публікації. Це стане у нагоді пізніше.
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
 
-![Django адміністратор](images/edit_post3.png)
+![Django admin](images/edit_post3.png)
 
-Якщо бажаєте дізнатися більше про Django admin, гляньте документацію Django: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
 
-Це напевне гарний час щоб налити кави (чи чаю) чи з’їсти щось щоб перезарядитися. Ви створили свою першу модель Django і заслуговуєте на короткий тайм-аут!
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/uk/django_forms/README.md b/uk/django_forms/README.md
index f4f2e0d2c79..4fe869d4802 100755
--- a/uk/django_forms/README.md
+++ b/uk/django_forms/README.md
@@ -1,8 +1,8 @@
 # Django форми
 
-Остання річ, яку б ми хотіли зробити з нашим сайтом, це створити зручний спосіб додавати і редагувати пости. Django адміністратор - це звісно круто, але водночас він є досить складним для налаштування. З формами ми будемо мати абсолютний контроль над нашим інтерфейсом - можемо робити майже усе, що заманеться!
+Остання річ, яку б ми хотіли зробити з нашим сайтом це створити зручний спосіб додавати і редагувати пости. Django адміністратор це звісно круто, але водночас він є досить складним для налаштування. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
 
-Що тішить стосовно Django форм, так це те, що останні можна визначати як з нуля, так і створювати засобами `ModelForm`, що зберігають результат форми всередині моделі.
+Що тішить стосовно Django форм так це те, що останні можна визначати як з нуля так і створювати засобами `ModelForm`, що зберігають результат форми всередині моделі.
 
 Це саме те, що нам потрібно: створимо форму для нашої моделі `Post`.
 
@@ -12,8 +12,11 @@
 
     blog
        └── forms.py
+    
 
-Добре, відкриємо цей файл і наберемо наступний код:
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
 
 ```python
 from django import forms
@@ -29,27 +32,31 @@ class PostForm(forms.ModelForm):
 
 Спершу потрібно імпортувати Django форми (`from django import forms`) і, очевидно, нашу модель `Post` (`from .models import Post`).
 
-`PostForm`, як ви можливо зазначили, це ім'я нашої форми. Ми маємо повідомити Django, що наша форма є `ModelForm` (таким чином Django здійснить для нас певні магічні маніпуляції) і рядок `forms.ModelForm` відповідає за це.
+`PostForm`, як ви можливо зазначили, ім'я нашої форми. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
 
 Далі, у нас є `class Meta`, де ми вказуємо для Django котра з моделей має бути використана для створення форми (`model = Post`).
 
-Зрештою, можемо зазначити, якими полями має закінчуватись наша форма. В даному сценарії ми би хотіли опублікувати такі параметри, як заголовок `title` і зміст `text`, дані про автора `author`, що автоматично встановлюються як дані користувача, який наразі залогінився (тобто ви!), а також дата створення `created_date`, яка автоматично встановлюється при створенні поста (тобто в коді), вірно ж?
+Зрештою, можемо зазначити якими полями має закінчуватись наша форма. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
 
 І це все! Все що нам потрібно тепер зробити це використати форму в блоці *view* і відобразити її в шаблоні.
 
-Отже, знову ми створимо: посилання на сторінку, адресу (URL), вид (view) і шаблон (template).
+So once again we will create a link to the page, a URL, a view and a template.
 
 ## Посилання на сторінку з формою
 
 Час відкрити `blog/templates/blog/base.html`. Додамо лінк всередині блоку `div` із ім'ям `page-header`:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Зауважте, що ми хочемо запустити наше нове відображення `post_new`. Клас `"glyphicon glyphicon-plus"` постачається bootstrap темою, яку ми використовуємо, і буде відображати знак плюса.
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
 
-Після додавання відповідного рядка, ваш html файл має виглядати наступним чином:
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% load staticfiles %}
@@ -84,34 +91,42 @@ class PostForm(forms.ModelForm):
 
 Відкриваємо `blog/urls.py` і додаємо рядок:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-    url(r'^post/new/$', views.post_new, name='post_new'),
+url(r'^post/new/$', views.post_new, name='post_new'),
 ```
 
 Остаточно код буде виглядати так:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 from django.conf.urls import url
 from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
     url(r'^post/new/$', views.post_new, name='post_new'),
 ]
 ```
 
-Після оновлення сайту бачимо помилку `AttributeError`, оскільки відображення `post_new` не реалізоване. Давайте додамо цей вид прямо зараз.
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
 
-## Відображення post_new
+## post_new view
 
 Час відкрити файл `blog/views.py` і додати наступні рядки:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from .forms import PostForm
 ```
 
-і функцію для потрібного *відображення*:
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -119,20 +134,22 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Щоб створити нову форму `Post`, нам потрібно викликати функцію `PostForm()` і передати її до шаблону. Повернемося пізніше до цього відображення, а зараз давайте створимо шаблон для форми.
+Щоб створити нову форму `Post`, нам потрібно викликати функцію `PostForm()` і передати її до шаблону. We will go back to this *view*, but for now, let's quickly create a template for the form.
 
 ## Шаблон
 
 Нам потрібно створити файл `post_edit.html` у папці `blog/templates/blog`. Щоб створити форму нам знадобиться декілька речей:
 
-- нам треба показати форму. Можна, наприклад, зробити це за допомогою простого `{% raw %}{{ form.as_p }}{% endraw %}`.
-- верхній рядок має бути розміщений всередині тега HTML для форми: `<form method="POST">...</form>`
-- нам знадобиться кнопка Зберегти - `Save`. Створимо її в HTML за допомогою: `<button type="submit">Save</button>`
-- і нарешті, одразу після відкриваючого тегу `<form ...>` ми маємо додати `{% raw %}{% csrf_token %}{% endraw %}`. Це дуже важливо з міркувань безпеки вашої форми! Django наголосить на цьому, якщо ви раптом забудете вказати згадану вказівку і будете намагатися зберегти форму:
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* Верхній рядок має бути розміщений всередині тега HTML для форми: `<form method="POST">...</form>`.
+* Нам знадобиться кнопка Зберегти - `Save`. Створимо її в HTML за допомогою: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. Це дуже важливо з міркувань безпеки вашої форми! If you forget about this bit, Django will complain when you try to save the form:
 
 ![CSFR Forbidden page](images/csrf2.png)
 
-Добре, отже, давайте подивимось як має виглядати HTML код в `post_edit.html`:
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -150,15 +167,17 @@ def post_new(request):
 
 ![New form](images/new_form2.png)
 
-Але, одну хвилиночку! Коли ви набираєте щось в полях `title` і `text`, та намагаєтесь зберегти зміни - що ж тоді станеться?
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
 
-А нічого! Ми знову опинимося на тій самій сторінці, і наш текст зникне... і жодного нового поста. Отже, що ж пішло не так?
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
 
 Відповідь: нічого. Мусимо проробити трохи більше роботи з нашим блоком *view*.
 
 ## Зберігання форми
 
-Відкрийте `blog/views.py` знову. Наразі все що ми маємо в `post_new` це:
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -166,9 +185,11 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Коли ми відправляємо форму, ми потрапляємо в той самий view, але цього разу маємо більше даних в `request`, а якщо точніше - в `request.POST` (ця назва не пов’язана з блогерським терміном "пост", вона пов’язана з тим що ми "постимо" дані). Пам'ятайте, що у файлі HTML наше визначення `<form>` містило атрибут `method="POST"`? Усі поля форми на даний момент знаходитимуться в `request.POST`. Ви не повинні перейменовувати `POST` на щось інше (лише єдине альтернативне прийнятне значення для атрибуту `method` це `GET`, але ми не маємо часу пояснювати в чому різниця).
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? Усі поля форми на даний момент знаходитимуться в `request.POST`. Ви не повинні перейменовувати `POST` на щось інше (лише єдине альтернативне прийнятне значення для атрибуту `method` це `GET`, але ми не маємо часу пояснювати в чому різниця).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. Таким чином, маємо додати умову (використаємо для цього `if`):
 
-Отже, ми маємо дві окремі ситуації, що потребують контролю для нашого блоку вид *view*. Перша: коли ми отримуємо доступ до сторінки вперше і хочемо отримати пусту форму. Друга: коли ми повертаємось назад до виду *view* із усіма нещодавно доданими даними форми. Таким чином, маємо додати умову (використаємо для цього `if`).
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 if request.method == "POST":
@@ -177,16 +198,20 @@ else:
     form = PostForm()
 ```
 
-Час заповнити порожнє місце `[...]`. Якщо метод `method` є методом `POST`, тоді ми захочемо створити `PostForm` з даними форми, вірно? Зробимо це за допомогою:
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST)
 ```
 
-Просто! Наступна річ - перевірити чи коректно заповнена форма (налаштовані усі необхідні поля і не відбулося зберігання жодного некоректного значення). Зробимо це за допомогою `form.is_valid()`.
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
 
 Ми перевіряємо чи є форма прийнятною і якщо це так, то можемо зберегти її!
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 if form.is_valid():
     post = form.save(commit=False)
@@ -195,24 +220,29 @@ if form.is_valid():
     post.save()
 ```
 
-В основі, маємо тут два моменти: зберігаємо форму за допомогою `form.save` і додаємо автора (оскільки поле автор `author` було відсутнє в `PostForm` і це поле є необхідним!). `commit=False` означає, що ми не хочемо поки що зберігати модель `Post` - ми хочемо спочатку додати ім'я автора. У більшості випадків ви будете користуватися `form.save()` без `commit=False`, але в даному випадку, ми маємо це зробити.
-`post.save()` захистить здійснені зміни (додавання автора) і створиться новий блог пост!
+В основі, маємо тут два моменти: зберігаємо форму за допомогою `form.save` і додаємо автора (оскільки поле автор `author` було відсутнє в `PostForm` і це поле є необхідним). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
 
-Зрештою, було б чудово, якби ми могли миттєво переходити на сторінку `post_detail` для щойно створеного допису у блозі, чи не так? Щоб зробити це, нам необхідно виконати ще один імпорт:
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import redirect
 ```
 
-Додайте це з самого початку вашого файлу. А тепер можемо сказати: перейти на сторінку `post_detail` для щойно створеного поста.
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 return redirect('post_detail', pk=post.pk)
 ```
 
-`post_detail` - ім'я виду, до якого ми хочемо перейти. Пам'ятаєте, що цей вид потребує змінної `pk`? Щоб здійснити передачу вище згаданої змінної, скористаємося `pk=post.pk`, де `post` є новим постом!
+`post_detail` is the name of the view we want to go to. Пам'ятаєте, що цей вид потребує змінної `pk`? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
 
-Але, щось дуже багато балачок, напевно ми хотіли б побачити, як відображується даний вид наразі в цілому, правда ж?
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_new(request):
@@ -229,39 +259,41 @@ def post_new(request):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Подивимося, чи усе працює. Зайдіть на сторінку http://127.0.0.1:8000/post/new/, додайте `title` та `text`, збережіть... і вуаля! Новий блог пост успішно додано і нас автоматично перенаправило на сторінку `post_detail`!
+Подивимося, чи усе працює. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
 
-Ви могли помітити, що ми встановлюємо дату публікації, перед збереженням поста. Пізніше, ми введемо *кнопку публікації* в **Django Girls Tutorial: Розширте ваш додаток**.
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
 
 Просто чудово!
 
-> Оскільки ми нещодавно мали справу з інтерфейсом Django адміністратора система наразі вважає, що ми залогінились. Є декілька ситуацій, які могли призвести до того, що ми вийшли з системи (закриття браузера, перезавантаження бази даних тощо). Якщо раптом виявиться, що при створенні поста з'явиться помилка, пов'язана із відсутністю залогіненого користувача, перейдіть на сторінку адміністратора http://127.0.0.1:8000/admin і залогіньтеся знову. Проблему тимчасово буде вирішено. Безповоротне розв'язання проблеми чекає на вас у розділі __Домашня робота: безпека вашого сайту!__ після освоєння головного посібника.
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. Проблему тимчасово буде вирішено. Безповоротне розв'язання проблеми чекає на вас у розділі **Домашня робота: безпека вашого сайту!** після освоєння головної програми.
 
 ![Logged in error](images/post_create_error.png)
 
+## Form validation
 
-## Перевірка форми
-
-А тепер ми покажемо вам, наскільки круто використовувати Django форми. Блог пост повинен мати такі поля як заголовок - `title` і зміст - `text`. В нашій моделі `Post` ми не вказали (на відміну від дати публікації - `published_date`), що ці поля не є необхідними, отже, Django, за замовчуванням, очікує що вони будуть заповнені.
+А тепер, ми покажемо вам наскільки круто використовувати Django форми. Блог пост повинен мати такі поля як заголовок - `title` і зміст - `text`. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
 
-Спробуйте зберегти форму без атрибутів `title` і `text`. Здогадуємось, що трапиться!
+Try to save the form without `title` and `text`. Guess what will happen!
 
-![Перевірка форми](images/form_validation2.png)
+![Form validation](images/form_validation2.png)
 
-Django турбується про те, щоб усі поля нашої форми були коректно заповнені. Хіба це не круто?
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
 
+## Edit form
 
-## Редагування форми
+Тепер ми знаємо як додати нову форму. Та якщо ми раптом захочемо відредагувати вже існуючу? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
 
-Тепер ми знаємо як додати нову форму. Та якщо ми раптом захочемо відредагувати вже існуючу? Це дуже схоже на те, що ми щойно проробили. Давайте швидко створимо певні важливі речі (якщо вам щось незрозуміло, ви маєте запитати вашого тренера або ще раз передивитись попередній параграф, оскільки ми вже пройшли усі ці речі).
+Open `blog/templates/blog/post_detail.html` and add the line
 
-Відкрийте `blog/templates/blog/post_detail.html` і додайте наступний рядок:
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
-```python
+```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
 
-таким чином, шаблон буде виглядати подібним чином:
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 {% extends 'blog/base.html' %}
@@ -282,13 +314,17 @@ Django турбується про те, щоб усі поля нашої фо
 
 В `blog/urls.py` додамо цей рядок:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
-    url(r'^post/(?P<pk>[0-9]+)/edit/$', views.post_edit, name='post_edit'),
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
 ```
 
-Повторно використаємо шаблон `blog/templates/blog/post_edit.html`, отже, остання річ, яка лишилась це відображення..
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
 
-Давайте відкриємо `blog/views.py` і додамо в самому кінці файлу:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_edit(request, pk):
@@ -306,43 +342,51 @@ def post_edit(request, pk):
     return render(request, 'blog/post_edit.html', {'form': form})
 ```
 
-Виглядає майже точно так, як і наш вид `post_new`, правда? Не зовсім. Перше: ми передаємо додатковий параметр `pk` з адресного рядку. Наступне: ми отримуємо модель `Post`, яку хотіли б відредагувати як `get_object_or_404(Post, pk=pk)` і потім, при створенні форми ми передаємо цей пост як екземпляр `instance`, коли зберігаємо форму:
+Виглядає майже точно так як і наш вид `post_new`, чи не так? Але не зовсім. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(request.POST, instance=post)
 ```
 
-а коли ми просто відкриваємо форму з цим постом для редагування:
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 form = PostForm(instance=post)
 ```
 
-Добре, давайте протестуємо, чи все працює! Перейдімо на сторінку `post_detail`. У верхньому правому кутку має з'явитися кнопка редагування:
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
 
-![Кнопка редагування](images/edit_button2.png)
+![Edit button](images/edit_button2.png)
 
 Коли ви натиснете на неї, то побачите форму з нашим блог постом:
 
-![Редагування форми](images/edit_form2.png)
+![Edit form](images/edit_form2.png)
 
-Можете вільно змінити заголовок або текст і зберегти зміни!
+Feel free to change the title or the text and save the changes!
 
-Вітаємо! Ваш додаток стає все більш і більш повним!
+Вітаємо! Ваш додаток стає все більше і більше завершеним!
 
-Якщо бажаєте дізнатись більше інформації про форми Django, ознайомтесь із документацією: https://docs.djangoproject.com/en/1.11/topics/forms/
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
 
 ## Безпека
 
-Створювати нові публікації просто клацаючи на посилання класно! Але зараз, будь-хто хто відвідує ваш сайт, буде здатним опублікувати пост, а ви цього напевне не хочете. Давайте зробимо так що кнопка показується для вас, але не показується для всіх інших.
+Створювати нові публікації просто клацаючи на посилання класно! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
 
 В `blog/templates/blog/base.html`, знайдіть наш `page-header` `div` і тег посилання який ви додали туди раніше. Вони повинні виглядати якось так:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
 ```
 
-Ми збираємось додати інший тег `{% if %}` який показуватиме посилання лише користувачам які ввійшли від імені адміністратора. На даний момент, це лише ви! Змініть тег `<a>` щоб він виглядав так:
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Змініть тег `<a>` щоб він виглядав так:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% if user.is_authenticated %}
@@ -350,52 +394,54 @@ form = PostForm(instance=post)
 {% endif %}
 ```
 
-Цей `{% if %}` зробить так, що посилання буде відправлятись браузеру лише коли користувач, що запитував сторінку, залогований. Це не захищає від створення нових публікацій анонімами повністю, але це непоганий перший крок. Ми розглянемо більше питань безпеки в розширених уроках.
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. Це не захищає від створення нових публікацій анонімами повністю, але це непоганий перший крок. Ми розглянемо більше питань безпеки в розширених уроках.
 
-Пам'ятаєте іконку редагування, що ми додали до нашої сторінки з деталями посту? Ми також хочемо додати цю ж зміну сюди, щоб інші люди не могли редагувати існуючі пости.
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
 
-Відкрийте `blog/templates/blog/post_detail.html` і знайдіть:
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 ```
 
-Замініть це на:
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
 
 ```html
 {% if user.is_authenticated %}
-	<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
 {% endif %}
 ```
 
-Оскільки ви ввійшли до системи, то якщо оновите сторінку, не побачите зміни. Відкрийте сторінку в новому браузері або в анонімному вікні, і тоді ви побачите, що посилання не показується!
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
 
 ## Ще одне: розгортання!
 
-Давайте поглянемо, чи це все працює на PythonAnywhere. Час для ще одного розгортання!
+Давайте поглянемо чи це все працює на PythonAnywhere. Час для ще одного деплою!
 
-*   Спершу, закомітьте новий код і зробіть push на GitHub
+* Спершу, закомітьте новий код і зробіть push на Github:
 
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added views to create/edit blog post inside the site."
-$ git push
-```
+{% filename %}command-line{% endfilename %}
 
-*   Тоді, в [bash консолі PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
 
-```
-$ cd my-first-blog
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```
+* Тоді, в [bash консолі PythonAnywhere](https://www.pythonanywhere.com/consoles/):
 
-* Нарешті, перейдіть на [вкладку Web](https://www.pythonanywhere.com/web_app_setup/) і натисніть **Reload**.
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
+* Ну й нарешті перестрибніть на [вкладку Web](https://www.pythonanywhere.com/web_app_setup/) і натисніть **Reload**.
 
-І це все! Вітання :)
+І це все! Вітання :)
\ No newline at end of file
diff --git a/uk/django_installation/README.md b/uk/django_installation/README.md
index 3d6a14afbfb..adc3dad63fa 100644
--- a/uk/django_installation/README.md
+++ b/uk/django_installation/README.md
@@ -1,6 +1,7 @@
 # Встановлення Django
 
-> **Зауваження:** Якщо ви вже проходили кроки інсталяції, значить все має бути зроблено - можете переходити зразу до наступного розділу!
-
-{% include "/django_installation/instructions.md" %}
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
 
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/uk/django_installation/instructions.md b/uk/django_installation/instructions.md
index c9ea92a53cc..65f1bd6581b 100644
--- a/uk/django_installation/instructions.md
+++ b/uk/django_installation/instructions.md
@@ -1,78 +1,150 @@
-> Частина цього розділу базується на матеріалах Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
-
-> Частина цього розділу базується на матеріалі [django-marcador tutorial]
-(http://django-marcador.keimlink.de/),
-який ліцензований Creative Commons Attribution-ShareAlike 4.0 International License.
-Авторське право на навчальні матеріали django-marcador tutorial належить Markus Zapke-Gründemann та ін.
-
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Авторське право на навчальні матеріали django-marcador tutorial належить Markus Zapke-Gründemann та ін.
 
 ## Віртуальне середовище
 
-Перед тим, як встановлювати Django, ми допоможемо вам встановити надзвичайно корисний інструмент, що допоможе підтримувати середовище розробки на вашому комп'ютері чистим. Цей крок можна пропустити, але дуже рекомендується його виконати. Починати найкращим можливим способом дозволить уникнути багатьох клопотів в майбутньому!
+Перед тим як встановлювати Django, ми допоможемо вам встановити надзвичайно корисний інструмент, що допоможе підтримувати середовище розробки на вашому комп'ютері чистим. Цей крок можна пропустити, але дуже рекомендується його виконати. Починати найкращим можливим способом дозволить уникнути багатьох клопотів в майбутньому!
 
-Отже, створимо віртуальне середовище (англ. **virtual environment**, скорочено *virtualenv*). Virtualenv ізолюватиме ваше Python/Django середовище, для кожного проекту. Це означає, що будь-які зміни, внесені на одному сайті не вплинуть на будь-які інші, які ви також розробляєте. Гарно, правда ж?
+Отже, створимо віртуальне середовище (англ. **virtual environment** або скорочено *virtualenv*). Virtualenv ізолюватиме ваше Python/Django середовище, для кожного проекту. Це означає, що будь-які зміни, внесені на одному сайті не вплинуть на будь-які інші, які ви також розробляєте. Гарно, правда ж?
 
-Все, що вам необхідно зробити - це знайти місце, де ви хочете створити віртуальне середовище `virtualenv`; наприклад, ваша домашня папка. На Windows це може виглядати як `C:\Users\Name` (де `Name` - ваш логін).
+Все що вам необхідно зробити це знайти місце, де ви хочете створити віртуальне середовище `virtualenv`; наприклад, ваша домашня папка. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
 
 В рамках цього навчального посібника будемо використовувати нову директорію `djangogirls` з вашої домашньої папки:
 
-    mkdir djangogirls
-    cd djangogirls
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
 
 Створимо віртуальне середовище з ім'ям `myvenv`. Загальна команда буде ось в такому форматі:
 
-    python3 -m venv myvenv
+{% filename %}command-line{% endfilename %}
 
-### Windows
+    $ python -m venv myvenv
+    
 
-Щоб створити нове віртуальне середовище `virtualenv`, вам потрібно відкрити консоль (ми вже розповідали вам про це в одному з попередніх розділів - пам'ятаєте?) і запустити `C:\Python34\python -m venv myvenv`. Це буде виглядати так:
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
 
-    C:\Users\Name\djangogirls> C:\Python34\python -m venv myvenv
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
 
-де `C:\Python34\python` - це папка, в якій ви перед цим встановили Python, а `myvenv` - ім'я вашого віртуального середовища `virtualenv`. Ви можете використовувати будь-яке ім’я, але старайтесь обмежитись маленькими буквами і не використовуйте пробілів, наголосів або спеціальних символів. Тримати ім’я коротким - також гарна ідея, оскільки ви будете часто посилатися на нього!
+{% filename %}command-line{% endfilename %}
 
-### Linux та OS X
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
 
-Створення віртуального середовища `virtualenv` як на Linux так і на OS X просто відбувається запуском `python3 -m venv myvenv`.
-Виглядає це так:
+Where `myvenv` is the name of your `virtualenv`. Ви можете використовувати будь-яке ім’я, але старайтесь обмежитись маленькими буквами і не використовуйте пробілів, наголосів або спеціальних символів. It is also good idea to keep the name short – you'll be referencing it a lot!
 
-    $ python3 -m venv myvenv
+<!--endsec-->
 
-`myvenv` - ім'я вашого віртуального середовища `virtualenv`. Можете використовувати яке завгодно ім'я, але воно має містити лише маленькі літери і не містити пробілів. Тримати ім’я коротким - також гарна ідея, оскільки ви будете часто посилатися на нього!
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
 
-> __ЗАУВАЖЕННЯ:__ Ініціалізація віртуального середовища на Ubuntu 14.04 і Debian 8 схожим методом наразі призводить до наступної помилки:
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
 
->     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+{% filename %}command-line{% endfilename %}
 
-> Щоб обійти цю проблему, використовуйте натомість команду `virtualenv`.
+    $ python -m venv myvenv
+    
 
->     $ sudo apt-get install python-virtualenv
->     $ virtualenv --python=python3.4 myvenv
+`myvenv` - ім'я вашого віртуального середовища `virtualenv`. Можете використовувати яке завгодно ім'я, але воно має містити лише маленькі літери і не містити пробілів. It is also a good idea to keep the name short as you'll be referencing it a lot!
 
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Щоб обійти цю проблему, використовуйте натомість команду `virtualenv`.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
 
 ## Робота з віртуальним середовищем
 
-Вище зазначена команда створить папку `myvenv` (або інше вибране вами ім'я), що міститиме наше віртуальне середовище (в основному, набір папок і файлів).
+Вищезазначена команда створить папку `myvenv` (або інше вибране вами ім'я), що міститиме наше віртуальне середовище (в основному, набір папок і файлів).
 
-#### Windows
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
 
-Запустіть своє віртуальне середовище, виконавши:
+Запустіть своє віртуальне середовище виконавши:
+
+{% filename %}command-line{% endfilename %}
 
     C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
 
-#### Linux та OS X
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
 
 Запустіть своє віртуальне середовище виконавши:
 
-    $ source myvenv/bin/activate
+{% filename %}command-line{% endfilename %}
 
-Не забудьте, що замість `myvenv` повинно бути вибране вами ім'я для віртуального середовища!
+    $ source myvenv/bin/activate
+    
 
-> __ЗАУВАЖЕННЯ:__ іноді використання `source` може бути недоступно. В цьому випадку спробуйте зробити наступне:
+Не забудьте замість `myvenv` повинно бути вибране вами ім'я для віртуального середовища!
 
+> **ЗАУВАЖЕННЯ:** іноді використання `source` може бути недоступно. В цьому випадку спробуйте зробити наступне: 
+> 
+> {% filename %}command-line{% endfilename %}
+> 
 >     $ . myvenv/bin/activate
+>     
 
-Про активацію віртуального середовища ви дізнаєтесь, коли побачите префікс `(myvenv)` в командному рядку консолі
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
 
 Під час роботи у віртуальному середовищі, `python` буде автоматичному посилатися на правильну версію, отже ви можете використовувати `python` замість `python3`.
 
@@ -80,23 +152,50 @@
 
 ## Встановлення Django
 
-Наразі, коли ваш `virtualenv` активований, можна встановлювати Django використавши `pip`. В консолі, запустіть `pip install django==1.11` (зазначте, що тут ми користуємося подвійним знаком рівності: `==`).
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
 
-    (myvenv) ~$ pip install django==1.11
-    Downloading/unpacking django==1.11
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
     Installing collected packages: django
-    Successfully installed django
-    Cleaning up...
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
 
-для Windows
-> Якщо ви отримуєте помилку коли викликаєте pip на Windows, будь ласка, перевірте чи шлях до вашого проекту не містить пробілів, наголосів чи спеціальних символів (наприклад `C:\Users\User Name\djangogirls`). Якщо містить - перемістіть його в місце шлях до якого не містить таких символів (пропонуємо: `C:\djangogirls`). Після переміщення спробуйте запустити вищевказану команду знову.
+<!--endsec-->
 
-для Windows 8 чи Windows 10
-> Ваш командний рядок може зависнути, після того як ви спробуєте встановити Django. Якщо це сталось, замість вище зазначеної команди використовуйте:
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
 
->     C:\Users\Name\djangogirls> python -m pip install django==1.11
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
 
-для Linux
 > Якщо виникла помилка під час запуску pip на Ubuntu 12.04, будь ласка, запустіть `python -m pip install -U --force-reinstall pip` щоб коректно перевстановити pip у віртуальному середовищі.
 
-Оце усе! Зараз ви (нарешті) готові створити додаток Django!
+<!--endsec-->
+
+Оце усе! Зараз ви (нарешті) готові створити додаток Django!
\ No newline at end of file
diff --git a/uk/django_models/README.md b/uk/django_models/README.md
index 1b798272c1f..58e8bed95a5 100755
--- a/uk/django_models/README.md
+++ b/uk/django_models/README.md
@@ -4,13 +4,13 @@
 
 ## Об'єкти
 
-Існує така концепція в програмуванні, яка називається `Об'єктно-орієнтовне програмування`. Ідея полягає в тому, що замість написання нудної послідовності програмних інструкцій ми можемо моделювати речі і визначати як вони будуть взаємодіяти одна з одною.
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
 
 Отже, що ж таке об'єкт? Це набір властивостей та дій. Звучить дивно, але представимо приклад.
 
-Якщо ми хочемо змоделювати кота, то створимо об'єкт `Cat`, що має деякі властивості, наприклад, колір, вік, настрій, власник - `color`, `age`, `mood` (хороший, поганий, сонний ;)), `owner` (це буде об'єкт `Person` або, можливо, у випадку бездомного кота, ця властивість буде пустою).
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
 
-Далі припустимо, що наш кіт `Cat` має певний набір дій, наприклад, муркотіти, шкрябатися, їсти - `purr`, `scratch`, `feed` (де ми будемо давати коту певний котячий корм `CatFood`, котрий міг би бути окремим об'єктом зі своїми властивостями, наприклад, смак - `taste`).
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
 
     Cat
     --------
@@ -21,11 +21,12 @@
     purr()
     scratch()
     feed(cat_food)
-
+    
 
     CatFood
     --------
     taste
+    
 
 Отже, основна ідея полягає в тому, щоб описати реальні речі в програмному коді з усіма їх властивостями (так званими властивостями об'єкта `object properties`) і діями (так званими методами `methods`).
 
@@ -33,7 +34,7 @@
 
 Нам треба відповісти на питання: що таке допис у блозі? Які властивості він повинен мати?
 
-Однозначно наш допис повинен містити певний текст із змістом і заголовком, правда ж? Було б також непогано знати хто його написав, отже нам потрібен автор. Зрештою, ми б хотіли знати коли було створено і опубліковано цей допис.
+Однозначно наш допис повинен містити певний текст із змістом і заголовком, правда ж? It would be also nice to know who wrote it – so we need an author. Зрештою, ми б хотіли знати коли було створено і опубліковано цей допис.
 
     Post
     --------
@@ -42,49 +43,63 @@
     author
     created_date
     published_date
+    
 
-Якого роду дії можна було б вчиняти з дописом у блозі? Було б непогано мати певний метод, що публікує допис, правда ж?
+Якого роду дії можна було б вчиняти з дописом у блозі? Було б непогано мати певний метод, що публікує допис, правда ж? 
 
 Отже, нам потрібен метод `publish`.
 
-Таким чином, знаючи, чого ми хочемо досягти, можемо почати моделювати це в Django!
+Таким чином, знаючи нарешті, чого ми хочемо досягти, можемо почати моделювати це в Django!
 
 ## Django модель
 
 Знаючи яким є наш об'єкт, можемо створити Django модель для допису у нашому блозі.
 
-Модель в Django - це спеціальний вид об'єкту, який зберігається в базі даних. База даних є набором певних даних. Це є місце, де ви будете зберігати інформацію про користувачів, дописи у вашому блозі тощо. Надалі для зберігання наших даних будемо використовувати базу даних SQLite. Це база даних, що встановлена в Django за замовчуванням і, цього буде наразі для нас достатньо.
+A model in Django is a special kind of object – it is saved in the `database`. База даних є набором певних даних. Це є місце, де ви будете зберігати інформацію про користувачів, дописи у вашому блозі тощо. Надалі для зберігання наших даних будемо використовувати базу даних SQLite. This is the default Django database adapter – it'll be enough for us right now.
 
-Ви можете уявляти модель в базі даних як таблицю зі стовпчиками (полями) та рядками (дані).
+Ви можете уявляти модель в базі даних як таблицю зі стовпчиками (полями) та рядками (дані). 
 
 ### Створення додатку
 
 Щоб підтримувати все у порядку, створимо окремий додаток всередині нашого проекту. Дуже добре зберігати в усьому організованість з самого початку. Щоб створити додаток треба запустити наступну команду в консолі (з директорії `djangogirls`, де знаходиться файл `manage.py`):
 
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
 
-Ви побачите, що створено нову директорію `blog`, яка містить певну кількість файлів. Директорії та файли в нашому проекті мають виглядати наступним чином:
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
 
     djangogirls
-    ├── mysite
-    |       __init__.py
-    |       settings.py
-    |       urls.py
-    |       wsgi.py
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
     ├── manage.py
-    └── blog
-        ├── migrations
-        |       __init__.py
+    └── mysite
         ├── __init__.py
-        ├── admin.py
-        ├── models.py
-        ├── tests.py
-        └── views.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
 
-Після створення ми також повинні повідомити Django, що він має використовувати цей додаток. Ми робимо це у файлі `mysite/settings.py`. Нам треба знайти `INSTALLED_APPS` та додати рядок `'blog',` зверху над `)`. Таким чином, остаточний результат повинен мати наступний вигляд:
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-INSTALLED_APPS = (
+INSTALLED_APPS = [
     'django.contrib.admin',
     'django.contrib.auth',
     'django.contrib.contenttypes',
@@ -92,14 +107,16 @@ INSTALLED_APPS = (
     'django.contrib.messages',
     'django.contrib.staticfiles',
     'blog',
-)
+]
 ```
 
 ### Створення моделі допису у блозі
 
-У файлі `blog/models.py` ми визначаємо всі об'єкти, що називаються моделі - `Models`. Це і є місце, де ми будемо визначати наш допис.
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
 
-Відкриємо `blog/models.py`, видалимо все звідси та запишемо наступний код:
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
 
 ```python
 from django.db import models
@@ -107,7 +124,7 @@ from django.utils import timezone
 
 
 class Post(models.Model):
-    author = models.ForeignKey('auth.User')
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
     created_date = models.DateTimeField(
@@ -123,43 +140,53 @@ class Post(models.Model):
         return self.title
 ```
 
-> Двічі перевірте, чи ви використали два знаки підкреслення (`_`) з кожної сторони `str`. Ця домовленість часто використовується в Python й іноді ми називаємо її "dunder" (скорочення від англ. "double-underscore").
+> Double-check that you use two underscore characters (`_`) on each side of `str`. Ця домовленість часто використовується в Python й іноді ми називаємо її "dunder" (скорочення від англ. "double-underscore").
 
-Страхіття якесь, правда ж? Але не хвилюйтесь, ми пояснимо, що означають ці рядки!
+It looks scary, right? But don't worry – we will explain what these lines mean!
 
-Усі лінії, що починаються з `from` або `import` - це лінії, які додають деякі біти з інших файлів. Отже замість того, щоб копіювати і вставляти одне й те ж в кожному файлі,ми можемо включити деякі частини з `from ... import ...`.
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
 
-`class Post(models.Model):` - цей рядок визначає нашу модель (це об'єкт `object`).
+`class Post(models.Model):` – this line defines our model (it is an `object`).
 
 - `class` - це спеціальне ключове слово, яке показує що ми визначаємо об'єкт.
-- `Post` - це ім'я нашої моделі. Ми можемо давати їй різні імена (але ми повинні уникати використання спеціальних символів та пробілів). Завжди починайте ім'я класу із великої літери.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
 - `models.Model` означає, що Post є Django моделлю, отже Django знає, що вона повинна бути збережена у базі даних.
 
-А зараз визначимо властивості, про які ми говорили перед цим: `title`, `text`, `created_date`, `published_date` і `author`. Щоб це зробити нам необхідно визначити тип поля (чи це текст? Число? Дата? Зв'язок із іншим об'єктом, наприклад, об'єкт користувач - User?).
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
 
-- `models.CharField` - для текстових полів з обмеженням кількісті символів.
-- `models.TextField` - великі блоки тексту без обмежень. Ідеально підходить для запису блогу, правильно?
-- `models.DateTimeField` - дата та час.
-- `models.ForeignKey` - зв'язок із іншою моделлю.
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
 
-Не будемо пояснювати кожне слово в коді, оскільки це може зайняти надто багато часу. Якщо хочете дізнатися більше про поля моделей, а також як визначати речі відмінні від вище описаних, то дивіться документацію Django (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
 
-А як щодо `def publish(self):`? Це і є наш метод `publish`, про який ми говорили раніше. `def` означає, що це функція/метод, а `publish` - ім'я методу. Ви можете змінити ім'я методу, якщо захочете. Правило іменування: треба використовувати рядкові букви, а пробіли замінювати підкресленнями. Наприклад, метод для розрахунку середньої ціни може бути названий `calculate_average_price`.
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
 
-Методи часто повертають (`return`) щось. Приклад цього можна побачити в методі `__str__`. У цьому сценарії, коли ми викликаємо `__str__()`, то отримуємо текст (**string**) із заголовком посту.
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
 
-Якщо вам щось незрозуміло з приводу моделей, не соромтеся запитувати у вашого тренера! Ми знаємо, що це дуже складно, особливо коли ви одночасно вивчаєте об'єкти і функції. Але сподіваємося наразі це виглядає трохи менш таємничим для вас!
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
 
 ### Створення таблиць для моделей в базі даних
 
-Останній крок - додати нашу нову модель до нашої бази даних. Спочатку потрібно повідомити Django, що змінилась наша модель (ми щойно створили її!). Наберіть `python manage.py makemigrations blog`. Це буде виглядати так:
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py makemigrations blog
     Migrations for 'blog':
-      0001_initial.py:
+      blog/migrations/0001_initial.py:
+    
       - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
 
-Django підготував для нас файл перенесення, який ми повинні тепер застосувати до нашої бази даних. Наберіть `python manage.py migrate blog`, на виході отримаємо:
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ python manage.py migrate blog
     Operations to perform:
@@ -167,5 +194,6 @@ Django підготував для нас файл перенесення, як
     Running migrations:
       Rendering model states... DONE
       Applying blog.0001_initial... OK
+    
 
-Ура! Наша модель допису Post тепер знаходиться у нашій базі даних. Було б добре побачити її, правда ж? Для цього перейдемо до наступного розділу!
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/uk/django_orm/README.md b/uk/django_orm/README.md
index 611ca099a54..8eee4134b09 100755
--- a/uk/django_orm/README.md
+++ b/uk/django_orm/README.md
@@ -1,145 +1,218 @@
 # Django ORM і QuerySets
 
-У цьому розділі ви дізнаєтесь, як Django з'єднується із базою даних і зберігає в ній дані. Почнемо занурення!
-
+У цьому розділі ви дізнаєтесь як Django з'єднується із базою даних і зберігає в ній дані. Почнемо занурення!
 
 ## Що таке QuerySet?
 
-A QuerySet є, по суті, списком об'єктів заданої моделі Model. QuerySet дозволяє вам считувати дані з бази даних, а також фільтрувати і впорядковувати їх.
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
 
 Найпростіше показати на прикладі. Давайте спробуємо?
 
-
 ## Django shell
 
 Відкрийте свій локальний термінал (не PythonAnywhere) і наберіть цю команду:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py shell
+    
 
-Результатом повинно бути:
+Результат повинен бути наступним:
 
-    (InteractiveConsole)
-    >>>
+{% filename %}command-line{% endfilename %}
 
-Ви опинетесь в інтерактивній консолі Django. Це щось подібне на командний рядок Python, але має додаткову магію Django :). Звичайно, тут ви також можете використовувати усі команди Python.
+```python
+(InteractiveConsole)
+>>>
+```
 
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
 
 ### Усі об'єкти
 
 Давайте спробуємо спочатку вивести усі наші пости. Можна це зробити за допомогою наступної команди:
 
-    >>> Post.objects.all()
-    Traceback (most recent call last):
-          File "<console>", line 1, in <module>
-    NameError: name 'Post' is not defined
+{% filename %}command-line{% endfilename %}
 
-Ой! З'явилась помилка. Вона повідомляє нам, що немає ніяких постів. І це правильно, адже ми забули спочатку імпортувати їх!
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
 
-    >>> from blog.models import Post
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
 
-Усе просто: імпортуємо модель `Post` з `blog.models`. Спробуємо вивести усі пости знову:
+{% filename %}command-line{% endfilename %}
 
-    >>> Post.objects.all()
-    <QuerySet [<Post: my post title>, <Post: another post title>]>
+```python
+>>> from blog.models import Post
+```
 
-Це список з дописів, з якими ми працювали раніше! Ми створили ці дописи через панель адміністратора Django. Проте, зараз ми хочемо створити нові дописи за допомогою Python, як ми цього доб'ємось?
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
 
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
 
 ### Створення об'єкту
 
 Мова йдеться про те, як створити об'єкт Post в базі даних:
 
-    >>> Post.objects.create(author=me, title='Sample title', text='Test')
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
 
-Однак, ми пропустили один елемент : `me`. Потрібно передати екземпляр моделі `User` у якості автора. Як це зробити?
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
 
 Спочатку імпортуємо модель User:
 
-    >>> from django.contrib.auth.models import User
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
 
 Які користувачі присутні в нашій базі даних? Спробуймо це:
 
-    >>> User.objects.all()
-    <QuerySet [<User: ola>]>
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
 
-Це суперкористувач, якого ми створили раніше! Нам потрібен його екземпляр:
+{% filename %}command-line{% endfilename %}
 
-    me = User.objects.get(username='ola')
+```python
+>>> me = User.objects.get(username='ola')
+```
 
-Як бачимо, ми отримали користувача із іменем, що дорівнює 'ola'. Чудово! Звісно, ви мали б використовувати ваше ім'я.
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
 
 Тепер ми нарешті можемо створити наш пост:
 
-    >>> Post.objects.create(author=me, title='Sample title', text='Test')
+{% filename %}command-line{% endfilename %}
 
-Ура! Бажаєте перевірити, чи це працює?
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
 
-    >>> Post.objects.all()
-    <QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+Ура! Бажаєте перевірити чи це працює?
 
-Є, ще один допис в списку!
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
 
-### Додайте більше постів
+Є, ще один допис в списку!
 
-А тепер можете трохи побавитися і пододавати більше постів, щоб побачити, як це працює. Додайте ще 2-3 поста і переходьте до наступної частини.
+### Додайте більше постів
 
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
 
 ### Фільтрування об'єктів
 
-Великою частиною QuerySets є можливість фільтрувати запити до бази даних. Скажімо, ми хочемо відшукати усі пости, що мають автора ola. Будемо використовувати `filter` замість `all` в `Post.objects.all()`. В дужках ми вказуємо яким умовам повинен відповідати пост, щоб завершити наш запит до бази даних. У нашому випадку це автор `author`, що дорівнює `me`. В Django цю умову можна виразити як: `author=me`. Тепер наш шматок коду виглядає так:
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. Будемо використовувати `filter` замість `all` в `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Тепер наш шматок коду виглядає так:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
 
-    >>> Post.objects.filter(author=me)
-    <QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+{% filename %}command-line{% endfilename %}
 
-Чи, можливо, ми хочемо побачити усі пости, що містять слово 'title' в полі `title`?
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
 
-    >>> Post.objects.filter(title__contains='title')
-    <QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+> **Зауваження** Тут використано два знаки підкреслювання (`_`) між `title` і `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
 
-> **Зауваження** Тут використано два знаки підкреслювання (`_`) між `title` і `contains`. Django ORM використовує цей синтаксис щоб відокремити імена полів ("title") і операції або фільтри ("contains"). Якщо ви раптом використаєте одне підкреслювання, то отримаєте помилку на кшталт "FieldError: Cannot resolve keyword title_contains".
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
 
-Ви також можете отримати список всіх опублікованих дописів. Ми робимо це шляхом фільтрації всіх дописів, які мають встановлене поле `published_date`:
-    >>> from django.utils import timezone
-    >>> Post.objects.filter(published_date__lte=timezone.now())
-    []
+{% filename %}command-line{% endfilename %}
 
-На жаль, доданий з Python консолі допис ще не опублікований. Ми можемо змінити це! Спершу отримаємо екземпляр допису, який хочемо опублікувати:
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
 
-    >>> post = Post.objects.get(title="Sample title")
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
 
-А далі опублікуємо його за допомогою нашого методу `publish`!
+{% filename %}command-line{% endfilename %}
 
-    >>> post.publish()
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
 
-Тепер спробуйте отримати список опублікованих дописів знову (натисніть стрілку вгору 3 рази, а потім `enter`):
+А далі опублікуємо його за допомогою нашого методу `publish`:
 
-    >>> Post.objects.filter(published_date__lte=timezone.now())
-    <QuerySet [<Post: Sample title>]>
+{% filename %}command-line{% endfilename %}
 
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
 
 ### Впорядкування об'єктів
 
 QuerySets також дозволяє впорядковувати список об'єктів. Давайте спробуємо впорядкувати їх за параметром поля `created_date`:
 
-    >>> Post.objects.order_by('created_date')
-    <QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+{% filename %}command-line{% endfilename %}
 
-Також можна здійснити впорядкування у зворотньому напрямку, додавши `-` на початку:
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
 
-    >>> Post.objects.order_by('-created_date')
-    <QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+Також можна здійснити впорядкування у зворотньому напрямку додавши `-` на початку:
 
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
 
 ### З'єднання QuerySets
 
 QuerySets можна поєднувати, створюючи **ланцюжки**:
 
     >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
 
 Це дуже потужний механізм, що дозволяє вам писати дуже складні запити.
 
 Клас! Тепер ви готові до наступної частини! Щоб закрити командну оболонку, наберіть:
 
-    >>> exit()
-    $
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/uk/django_start_project/README.md b/uk/django_start_project/README.md
index 8b121540a53..3a489a7698b 100755
--- a/uk/django_start_project/README.md
+++ b/uk/django_start_project/README.md
@@ -1,34 +1,46 @@
 # Ваш перший Django проект!
 
-> Частина цього розділу базується на матеріалах Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Авторське право на навчальні матеріали django-marcador tutorial належить Markus Zapke-Gründemann та ін.
 
-> Частина цього розділу базується на матеріалх [django-marcador tutorial](http://django-marcador.keimlink.de/)
-ліцензованих Creative Commons Attribution-ShareAlike 4.0 International License.
-Авторське право на навчальні матеріали django-marcador tutorial належить
-Markus Zapke-Gründemann та ін.
-
-Ми збираємося створити простий блог!
+We're going to create a small blog!
 
 Перший крок - це почати новий проект Django. По суті, це означає що ми запустимо деякі скрипти, які надає Django, що створять для нас скелет Django проекту. Це просто кілька каталогів та файлів, якими ми користуватимемось пізніше.
 
 Імена деяких файлів і папок є дуже важливими для Django. Не можна перейменовувати файли, які ми зараз будемо створювати. Їх переміщення в різні місця також не є хорошою ідеєю. Для того щоб Django міг знаходити важливі речі, потрібно підтримувати задану архітектуру.
 
-> Пам'ятайте, що усе треба запускати у віртуальному середовищі. Якщо ви не бачите префікс `(myvenv)` в консолі, то потрібно активувати ваше віртуальне середовище. Ми пояснювали як це зробити у розділі __Встановлення Django__ в частині __Робота з віртуальним середовищем__.
-Команда `myvenv\Scripts\activate` на Windows або `source myvenv/bin/activate` на Mac OS / Linux зробить це за вас.
+> Пам'ятайте, що усе треба запускати у віртуальному середовищі. Якщо ви не бачите префікс `(myvenv)` в консолі, то потрібно активувати ваше віртуальне середовище. Ми пояснювали як це зробити у розділі **Встановлення Django** в частині **Робота з віртуальним середовищем**. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
 
-В терміналі Mac OS або Linux слід запустити наступну команду; **не забудьте додати крапку `.` в кінці**:
+{% filename %}command-line{% endfilename %}
 
     (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Крапка `.` має вирішальне значення, оскільки вона означає "встанови Django в поточний каталог" (символ крапки `.` використовується щоб не писати повний шлях).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
 
-У Windows; **не забудьте додати крапку `.` в кінці**:
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
 
-    (myvenv) C:\Users\Name\djangogirls> django-admin startproject mysite .
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
 
-> Крапка `.` має ключове значення, оскільки вона означає "встанови Django в поточний каталог" (символ крапки `.` використовується, щоб не писати повний шлях)
+{% filename %}command-line{% endfilename %}
 
-> **Примітка** Коли набираете команду вище, пам'ятайте, що потрібно друкувати тільки ту частину, яка починається з `django-admin` або `django-admin.py`.
-Частини шляху `~/djangogirls$ (myvenv)` та `(myvenv) C:\Users\Name\djangogirls >`вказані тут лише
-як приклад запрошення командного рядка до введення команд.
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Крапка `.` має вирішальне значення, оскільки вона означає "встанови Django в поточний каталог" (символ крапки `.` використовується щоб не писати повний шлях).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
 
 `django-admin.py` - це скрипт, що створить для вас усі необхідні папки і файли. Наразі ви повинні мати структуру, котра виглядає наступним чином:
 
@@ -39,9 +51,11 @@ Markus Zapke-Gründemann та ін.
             urls.py
             wsgi.py
             __init__.py
+    
 
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
 
-`manage.py` - скрипт, що допомагає керувати сайтом. З його допомогою ми зможемо запускати веб сервер без встановлення чогось іще додатково, серед іншого.
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
 
 Файл `settings.py` містить конфігурацію вашого веб сайту.
 
@@ -49,36 +63,61 @@ Markus Zapke-Gründemann та ін.
 
 Проігноруємо поки інші файли, адже ми не будемо їх змінювати. Єдина річ, яку варто пам'ятати - не видалити їх ненароком!
 
-
 ## Зміна налаштувань
 
 Здійснимо деякі зміни в `mysite/settings.py`. Відкриємо файл в текстовому редакторі, який ви мали встановити раніше.
 
-Було б непогано мати коректний час на нашому сайті. Перейдіть до [списку часових поясів на Вікіпедії](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) та скопіюйте відповідний часовий пояс (TZ). (напр. `Europe/Kiev`)
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+Було б непогано мати коректний час на нашому сайті. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
 
-У файлі settings.py знайдіть рядок, що містить `TIME_ZONE` і замініть його на ваш часовий пояс:
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
-TIME_ZONE = 'Europe/Kiev'
+TIME_ZONE = 'Europe/Berlin'
 ```
 
-Попередній рядок показує як обрати часовий пояс "Europe/Kiev"
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
 
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
 
-Нам також необхідно додати шлях для статичних файлів (згодом із посібника ви дізнаетесь все про "статичні файли" та листи стилів (CSS)). Перейдіть *в кінець* файлу та додайте новий запис `STATIC_ROOT` одразу під словом `STATIC_URL`:
+{% filename %}mysite/settings.py{% endfilename %}
 
 ```python
 STATIC_URL = '/static/'
 STATIC_ROOT = os.path.join(BASE_DIR, 'static')
 ```
 
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
 
-## Налаштування бази даних
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
 
 Існує безліч різноманітних програмних продуктів, що працюють із базами даних і можуть зберігати дані для вашого сайту. Ми будемо користуватися таким, що вказаний за замовчуванням - `sqlite3`.
 
 Відповідні налаштування вже прописані у файлі `mysite/settings.py`:
 
+{% filename %}mysite/settings.py{% endfilename %}
+
 ```python
 DATABASES = {
     'default': {
@@ -90,46 +129,74 @@ DATABASES = {
 
 Щоб створити базу даних для нашого блогу, давайте запустимо наступне в консолі: `python manage.py migrate` (ми повинні знаходитися всередині директорії `djangogirls`, яка містить файл `manage.py`). Якщо все пройшло успішно, ви маєте побачити щось на кшталт:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py migrate
     Operations to perform:
-      Synchronize unmigrated apps: messages, staticfiles
-      Apply all migrations: contenttypes, sessions, admin, auth
-    Synchronizing apps without migrations:
-       Creating tables...
-          Running deferred SQL...
-       Installing custom SQL...
+      Apply all migrations: auth, admin, contenttypes, sessions
     Running migrations:
       Rendering model states... DONE
       Applying contenttypes.0001_initial... OK
       Applying auth.0001_initial... OK
       Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
       Applying contenttypes.0002_remove_content_type_name... OK
       Applying auth.0002_alter_permission_name_max_length... OK
       Applying auth.0003_alter_user_email_max_length... OK
       Applying auth.0004_alter_user_username_opts... OK
       Applying auth.0005_alter_user_last_login_null... OK
       Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
       Applying sessions.0001_initial... OK
+    
 
 Ми це зробили! Час запустити веб сервер і перевірити чи працює наш сайт!
 
+## Starting the web server
+
 Ви повинні знаходитися в папці, що містить файл `manage.py` (папка `djangogirls`). В консолі ми можемо активувати веб сервер запустивши `python manage.py runserver`:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
 
 Якщо ви використовуєте Windows і бачите помилку `UnicodeDecodeError` слід виконати наступну команду:
 
+{% filename %}command-line{% endfilename %}
+
     (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
 
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
 
-А зараз ви повинні перевірити, чи запущений ваш веб-сайт. Відкрийте браузер (Firefox, Chrome, Safari, Internet Explorer або будь-який інший) і введіть адресу:
+{% filename %}browser{% endfilename %}
 
     http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
 
-Веб-сервер забирає на себе керування командним рядком, доки ви його не зупините. Моб мати можливість виконувати нові команди, поки працює веб-сервер, відкрийте нове вікно командного рядка (терміналу) та активуйте ваш virtualenv. Щоб зупинити веб-сервер, переключіться назад до вікна, в якому він працює і використайте сполучення клавіш CTRL + C (натисніть клавіші разом) (на Windows, можливо, доведеться натиснути клавіші Ctrl + Break).
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
 
 Вітаємо! Ви щойно створили свій перший веб-сайт та запустили його на веб-сервері! Хіба ж це не круто?
 
-![Працює!](images/it_worked2.png)
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
 
-Готові до наступного кроку? Час додати трішки контенту!
+Готові до наступного кроку? Час створити певний контент!
\ No newline at end of file
diff --git a/uk/django_templates/README.md b/uk/django_templates/README.md
index 27f10841e47..6a699b5fcb6 100755
--- a/uk/django_templates/README.md
+++ b/uk/django_templates/README.md
@@ -1,12 +1,12 @@
 # Django шаблони
 
-Час вивести деякі дані! Django надає нам певні допоміжні, вбудовані __шаблонні теги__ для цього.
+Час вивести деякі дані! Django надає нам певні допоміжні, вбудовані **шаблонні теги** для цього.
 
 ## Що таке шаблонні теги?
 
-Як бачите, в HTML, ви не можете помістити Python код, тому що браузери не зрозуміють його. Вони знають лише HTML. Ми знаємо, що HTML більшою мірою є статичною, в той час як Python є більш динамічною мовою.
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
 
-__Шаблонні теги Django__ дозволяють нам передавати Python-подібні речі в HTML, таким чином можна розробляти динамічні веб-сайти швидше і простіше. Ой!
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
 
 ## Шаблон для виведення списку постів
 
@@ -14,19 +14,27 @@ __Шаблонні теги Django__ дозволяють нам передав
 
 Щоб надрукувати змінну в Django шаблоні, ми використовуємо подвійні фігурні дужки з іменем змінної всередині:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {{ posts }}
 ```
 
 Спробуйте це в шаблоні `blog/templates/blog/post_list.html`. Починаючи з другого `<div>` до третього `</div>` замініть все на `{{ posts }}`. Збережіть файл і оновіть сторінку, щоб побачити результат:
 
-![Рисунок 13.1](images/step1.png)
+![Figure 13.1](images/step1.png)
+
+Як можна побачити, все що ми отримали це:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
-Як можна побачити, все що ми отримали, це:
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
 
-    <QuerySet [<Post: My second post>, <Post: My first post>]>
+Означає, що Django розуміє це як список об'єктів. Пам'ятаєте із розділу **Вступ до Python** як ми можемо виводити списки? Звичайно, за допомогою циклу **for**! У Django шаблонах ви можете створити їх наступним чином:
 
-Означає, що Django розуміє це як список об'єктів. Пам'ятаєте із розділу __Вступ до Python__ як ми можемо виводити списки? Звичайно, за допомогою циклу __for__! У Django шаблонах ви можете створити їх наступним чином:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
@@ -36,9 +44,11 @@ __Шаблонні теги Django__ дозволяють нам передав
 
 Спробуйте це у вашому шаблоні.
 
-![Рисунок 13.2](images/step2.png)
+![Figure 13.2](images/step2.png)
+
+Працює! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. Ви можете компонувати теги HTML і шаблонні теги. Наша частина `body` буде виглядати так:
 
-Працює! Однак, бажано, щоб вони були виведені як статичні пости, які ми створили раніше у розділі __Вступ до HTML__. Ви можете компонувати теги HTML і шаблонні теги. Наша частина `body` буде виглядати так:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <div>
@@ -54,43 +64,43 @@ __Шаблонні теги Django__ дозволяють нам передав
 {% endfor %}
 ```
 
-{% raw %}Все, що ви напишете між `{% for %}` та `{% endfor %}` повторюватиметься для кожного об'єкта у списку. Оновіть сторінку:{% endraw %}
+Все що ви напишете між `{% for %}` та `{% endfor %}` повторюватиметься для кожного об'єкта у списку. Оновіть сторінку:
 
-![Рисунок 13.3](images/step3.png)
-
-Чи помітили ви, що цього разу ми використали трохи відмінні позначення `{{ post.title }}` або `{{ post.text }}`? Ми маємо доступ до даних, що містяться в кожному полі, визначеному в нашій моделі `Post`. Також `|linebreaksbr` перенаправляє текст посту через фільтр щоб конвертувати розриви ліній в абзаци.
+![Figure 13.3](images/step3.png)
 
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? Ми маємо доступ до даних, що містяться в кожному полі, визначеному в нашій моделі `Post`. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
 
 ## Ще одне
 
-Було б непогано побачити як ваш сайт буде працювати в інтернеті, так? Давайте спробуєм розгорнути його в PythonAnywhere знову. Ось наступні кроки...
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
 
-*   По-перше, залийте ваш код на Github
+* По-перше, проштовхніть ваш код на Github
 
-```
-$ git status
-[...]
-$ git add --all .
-$ git status
-[...]
-$ git commit -m "Modified templates to display posts from database."
-[...]
-$ git push
-```
+{% filename %}command-line{% endfilename %}
 
-*   Потім, увійдіть до [PythonAnywhere](https://www.pythonanywhere.com/consoles/) та перейдіть до **Bash консолі** (або запустіть нову) і виконайте команди:
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
 
-```
-$ cd my-first-blog
-$ git pull
-[...]
-```
+* Потім, увійдіть назад до [PythonAnywhere](https://www.pythonanywhere.com/consoles/) та перейдіть до **Bash консолі** (або запустіть нову) і виконайте команди:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
 
-* Нарешті, перейдіть на вкладку [Web](https://www.pythonanywhere.com/web_app_setup/) і натисніть **Reload** (перезавантажити) у веб-додатку.
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
+* Нарешті, перейдіть на вкладку [Web tab](https://www.pythonanywhere.com/web_app_setup/) і натисніть **перезавантажити** у веб-додатку. If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
 
-Вітаємо! А тепер спробуйте додати новий пост у вашому Django адміністраторі (не забудьте додати published_date!), потім перезавантажте сторінку, щоб переконатись, чи з'явився новий пост.
+Вітаємо! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
 
-Все працює, як годинник? Ми пишаємося! Відійдіть ненадовго від комп'ютера, ви заслуговуєте на перерву. :)
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
 
-![Рисунок 13.4](images/donut.png)
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/uk/django_urls/README.md b/uk/django_urls/README.md
index 9054f9e351b..d23cb0a0997 100755
--- a/uk/django_urls/README.md
+++ b/uk/django_urls/README.md
@@ -1,122 +1,129 @@
-# Django url
+# Django URLs
 
-Ми збираємося побудувати нашу першу веб-сторінку - домашню сторінку для вашого блогу! Але спочатку, давайте трохи дізнаємось про Django URL-адреси.
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
 
 ## Що таке URL?
 
-URL - це просто веб-адреса. Відображається URL кожен раз, коли ви відвідуєте веб-сайт - це видно в адресному рядку браузера (так! `127.0.0.1:8000` - це URL! І `https://djangogirls.org` також є URL):
+URL - це просто веб-адреса. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` - це URL! And `https://djangogirls.org` is also a URL.)
 
 ![Url](images/url.png)
 
-Кожна сторінка в Інтернеті потребує свого власного URL. Таким чином ваш додаток знає, що треба показувати користувачу, який відкриває URL. В Django використовується така річ, яка називається `URLconf` (URL конфігурація). URLconf являє собою набір шаблонів, які Django намагатиметься зіставити з отриманих URL, щоб знайти правильне відображення.
+Кожна сторінка в Інтернеті потребує свого власного URL. This way your application knows what it should show to a user who opens that URL. В Django використовується така річ, яка називається `URLconf` (URL конфігурація). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
 
 ## Як працює URL в Django?
 
 Давайте відкриємо файл `mysite/urls.py` в редакторі коду і подивимось, як він виглядає:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
-    # Examples:
-    # url(r'^$', 'mysite.views.home', name='home'),
-    # url(r'^blog/', include('blog.urls')),
-
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
 ]
 ```
 
-Як бачите, Django вже щось записав сюди для нас.
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
 
-Рядки, що починаються з `#` - це коментарі, тобто ці рядки не будуть запускатися Python. Досить зручно, чи не так?
+The admin URL, which you visited in previous chapter, is already here:
 
-URL панелі адміністратора, котрий ви відвідували у попередньому розділі вже є тут:
+{% filename %}mysite/urls.py{% endfilename %}
 
 ```python
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
 ```
 
-Це означає, що для кожного URL, що починається з `admin/` Django знаходитиме відповідне відображення - *view*. У даному випадку ми включаємо багато адміністраторських URL, отже не все запаковується в цей маленький файл, що є більш читабельним і акуратнішим.
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
 
 ## Regex
 
-Хіба вам не цікаво, яким чином Django створює відповідності між URL і відображеннями? Гаразд, ця частина досить хитра. Django використовує `regex`, що є скороченням від "regular expressions" (регулярні вирази). Regex має багато (багато!) правил, що формують шаблон пошуку. Оскільки регулярні вирази є продвинутою темою, ми не будемо вникати в деталі їх роботи.
+Хіба вам не цікаво яким чином Django створює відповідності між URL і відображеннями? Гаразд, ця частина досить хитра. Django використовує `regex`, що є скороченням від "regular expressions". Regex має багато (багато!) правил, що формують шаблон пошуку. Оскільки регулярні вирази є продвинутою темою, ми не будемо вникати в деталі їх роботи.
 
-Якщо ви все ще хочете зрозуміти, як ми створили шаблони, ось приклад процесу - нам потрібно буде тільки обмежена підмножина правил для того, щоб виразити потрібний шаблон, а саме:
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
 
-    ^ для початку тексту
-    $ для кінця тексту
-    \d для цифри
-    + щоб позначити, що попередній символ має бути повторений мінімум один раз
-    () для захоплення частини шаблону
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
 
-Все інше у визначенні url буде прийматися як є.
+Anything else in the URL definition will be taken literally.
 
-Тепер уявіть, що у вас є сайт з такою адресою: `http://www.mysite.com/post/12345/`, де `12345` - це номер вашого посту.
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
 
-Написання окремих відображень для усіх номерів постів було б дійсно нестерпним. За допомогою регулярних виразів ми можемо створити шаблон, який відповідає url і витягти номер для нас: `^post/(\d+)/$`. Давайте розберемо його по частинах, щоб побачити, що ми тут робимо:
+Написання окремих відображень для усіх номерів постів було б дійсно нестерпним. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
 
-* **^post/** говорить Django взяти що-небудь, що має `post/` на початку url (зразу після `^`)
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
 * **(\d+)** означає, що буде число (одне або декілька цифр), і ми хочемо, щоб число захопилось і вибралось
 * **/** вказує Django, що наступним символом має бути `/`
 * **$** далі позначає кінець URL-адреси, а це означає, що під шаблон підходять лише ті рядки, які закінчуються на `/`
 
+## Your first Django URL!
 
-## Ваш перший Django url!
-
-Час створити наш перший URL! Ми хочемо, щоб 'http://127.0.0.1:8000/' був домашньою сторінкою нашого блогу і виводив список постів.
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
 
-Також ми б хотіли підтримувати порядок у файлі `mysite/urls.py`, отже імпортуємо url з нашого додатку `blog` у файл `mysite/urls.py`.
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
 
-Вперед, видаліть закоментовані рядки (рядки, що починаються з `#`) та додайте рядок, що імпортує `blog.urls` до головного url (`''`).
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
 
 Ваш файл `mysite/urls.py` повинен наразі мати такий вигляд:
 
+{% filename %}mysite/urls.py{% endfilename %}
+
 ```python
-from django.conf.urls import include, url
+from django.conf.urls import include
+from django.conf.urls import url
 from django.contrib import admin
 
 urlpatterns = [
-    url(r'^admin/', include(admin.site.urls)),
+    url(r'^admin/', admin.site.urls),
     url(r'', include('blog.urls')),
 ]
 ```
 
 Django тепер перенаправлятиме усе, що надходить на 'http://127.0.0.1:8000/' до `blog.urls` і шукатиме там подальші інструкції.
 
-Для запису регулярних виразів у Python використовується символ `r` перед стрічкою. Це підказка для інтерпретатора, що рядок може містити спеціальні символи, які використовуються в регулярних виразах.
-
+Writing regular expressions in Python is always done with `r` in front of the string. Це підказка для інтерпретатора, що рядок може містити спеціальні символи, які використовуються в решулярних виразах.
 
 ## blog.urls
 
-Створіть новий порожній файл `blog/urls.py`. Добре! Додайте наступні перші два рядки:
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
 from . import views
 ```
 
-Тут ми лише імпортуємо методи Django і всі наші відображення з додатку `blog` (у нас ще немає жодного, але ми повернемося до цього через хвилину!)
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
 
 Після цього, ми можемо додати наш перший URL шаблон:
 
+{% filename %}blog/urls.py{% endfilename %}
+
 ```python
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
 ]
 ```
 
-Як бачите, ми присвоюємо відображення із назвою `post_list` значенню URL `^$`. Цей регулярний вираз буде перевіряти рядок на `^` (початок рядка) та `$` (кінець) - тому тільки порожній рядок буде відповідати цим вимогам. Це правильно, тому що в механізмі Django URL, вираз ' http://127.0.0.1:8000 /' не є частиною URL-адреси. Цей шаблон показуватиме для Django, що `views.post_list` є правильним місцем для переходу, якщо хтось введе ваш сайт за адресою 'http://127.0.0.1:8000/'.
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. Це правильно, тому що в механізмі Django URL, вираз ' http://127.0.0.1:8000 /' - не є частиною URL-адресу. Цей шаблон показуватиме для Django, що `views.post_list` є правильним місцем для переходу, якщо хтось введе ваш сайт за адресою 'http://127.0.0.1:8000/'.
 
-На останок, `name='post_list'` - це назва URL, який використовуватиметься для ідентифікації потрібного відображення (в'ю). Це може бути ім'ям потрібного нам відображення (в'ю), або взагалі чимось іншим. Ми буде використовувати іменовані URL-адреси, протягом всього проекту, тому важливо, давати ім'я кожному URL у застосунку. Ми також повинні намагатися давати URL-адресам якомога простіші та унікальні імена, і так, щоб їх було легко запам'ятати.
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. Це може бути ім'ям потрібного нам відображення (в'ю), або взагалі чимось іншим. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
 
-Усе гаразд? Відкрийте http://127.0.0.1:8000/ у браузері, щоб побачити результат.
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
 
 ![Error](images/error1.png)
 
-Що, тут більше немає повідомлення "It works"? Не хвилюйтесь, це просто сторінка із помилкою, нічого боятися! Вони є насправді дуже корисними:
-
-Можете прочитати тут: __no attribute 'post_list'__. Чи *post_list* не нагадує вам про щось? Це назва нашого відображення! Це означає, що все знаходиться на місці, але ми просто ще не створили наше *відображення*. Не переймайтесь, ми його отримаємо.
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
 
-> Якщо бажаєте дізнатися більше про Django URLconf, зверніться до офіційної документації: https://docs.djangoproject.com/en/1.11/topics/http/urls/
+> Якщо бажаєте дізнатися більше про Django URLconf, зверніться до офіційної документації: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/uk/django_views/README.md b/uk/django_views/README.md
index 6659604e69b..5842d7f1ec2 100755
--- a/uk/django_views/README.md
+++ b/uk/django_views/README.md
@@ -1,14 +1,16 @@
-# Django відображення - час творити!
+# Django views – time to create!
 
-Час позбутися помилки, створеної в попередньому розділі :)
+Час позбутися помилки, створеної в останньому розділі! :)
 
-Відображення - *view* - це місце, в якому ми закладаємо "логіку" нашої програми. Воно запитує інформацію з `моделі`, яку ми створили раніше і передає його до `шаблону`. Ми створимо шаблон в наступному розділі. Відображення - це просто методи Python, трохи складніші за ті, які ми робили у розділі __Вступ до Python__.
+Відображення - *view* -- це місце, в якому ми закладаємо "логіку" нашої програми. Воно запитує інформацію з `моделі`, яку ми створили раніше і передає його до `шаблону`. Ми створимо шаблон в наступному розділі. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
 
 Відображення розташовані у файлі `views.py`. Додамо наші відображення до файлу `blog/views.py`.
 
 ## blog/views.py
 
-OK, давайте відкриємо цей файл і подивимось що тут:
+OK, давайте відкриємо цей файл подивимось що тут:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
@@ -16,22 +18,27 @@ from django.shortcuts import render
 # Create your views here.
 ```
 
-Не так багато поки що. Найпростіший вид може бути таким.
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
 
-Як бачимо, ми створили метод (`def`) із назвою `post_list`, що приймає як аргумент запит - `request` і повертає метод `render`, що активує (компілює) наш шаблон `blog/post_list.html`.
-
-Збережіть файл, перейдіть до http://127.0.0.1:8000/ і подивіться, що ми отримали.
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
 
 Інша помилка! Прочитайте у чому цього разу справа:
 
 ![Error](images/error.png)
 
-Цього разу усе просто: *TemplateDoesNotExist*.Виправимо це і створимо шаблон в наступному розділі!
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
 
-> Дізнатися більше про Django відображення можна, звернувшись до офіційної документації: https://docs.djangoproject.com/en/1.11/topics/http/views/
+> Дізнатися більше про Django відображення можна звернувшись до офіційної документації: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/uk/dynamic_data_in_templates/README.md b/uk/dynamic_data_in_templates/README.md
index 8f0daf06845..347953afa3f 100755
--- a/uk/dynamic_data_in_templates/README.md
+++ b/uk/dynamic_data_in_templates/README.md
@@ -1,13 +1,15 @@
 # Динамічні дані в шаблонах
 
-Маємо різні шматочки на своїх місцях: модель `Post` визначено в `models.py`, маємо `post_list` у `views.py`, а також відповідний шаблон. Однак, яким чином ми змусимо наші пости з'явитися в HTML шаблоні? Оскільки це те, чого ми хочемо: взяти деякий контент (моделі збережені в базі даних) і вивести його в гарному вигляді на нашому шаблоні, правда ж?
+Маємо різні шматочки на своїх місцях: модель `Post` визначено в `models.py`, маємо `post_list` у `views.py`, а також відповідний шаблон. Однак, яким чином ми змусимо наші пости з'явитися в HTML шаблоні? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
 
-Це саме те, що покликані робити відображення: з'єднаємо моделі і шаблони. В нашому відображенні `post_list` нам потрібно взяти моделі, які ми хочемо зобразити, і передати їх до шаблону. Отже, в основному, у секції відображення - *view* ми вирішуємо що (модель) буде виведено в шаблоні.
+Це саме те, що покликані робити відображення: з'єднаємо моделі і шаблони. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
 
-Добре, отже як ми цього досягнемо?
+OK, so how will we achieve this?
 
 Нам треба відкрити наш `blog/views.py`. Таким чином, відображення `post_list` виглядає на кшталт:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 
@@ -15,26 +17,34 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Пам'ятаєте, як ми говорили про включення коду написаного в різних файлах? Тепер настав момент, коли ми повинні включити модель написану в `models.py`. Додаймо рядок `from .models import Post`:
+Пам'ятаєте як ми говорили про включення коду написаного в різних файлах? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
 from .models import Post
 ```
 
-Крапка після `from` означає *поточна директорія* або *поточний додаток*. Оскільки `views.py` і `models.py` розташовані в одній і тій же папці, можемо просто використовувати `.` і ім'я файлу (без `.py`). Далі імпортуємо ім'я моделі (`Post`).
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Далі імпортуємо ім'я моделі (`Post`).
 
-А що далі? Щоб вилучити реальні пости з моделі `Post`, нам потрібна певна річ, що називається `QuerySet`.
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
 
 ## QuerySet
 
-Ви маєте вже бути ознайомлені із роботою QuerySets. Ми говорили про це у розділі [Django ORM (QuerySets)](../django_orm/README.md).
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
 
-Отже, наразі ми зацікавлені у списку опублікованих і відсортованих за параметром `published_date` блог постів, чи не так? Ми вже робили це у розділі QuerySets!
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
 
-    Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
 
-А тепер вставимо цей шматок коду у файл `blog/views.py` додавши його до функції `def post_list(request)`:
+{% filename %}blog/views.py{% endfilename %}
 
 ```python
 from django.shortcuts import render
@@ -46,16 +56,16 @@ def post_list(request):
     return render(request, 'blog/post_list.html', {})
 ```
 
-Зазначте, будь ласка, що ми створюємо *змінну* для нашого QuerySet: `posts`. Сприймайте її як ім'я для QuerySet. З цього моменту ми можемо посилатися на неї через це ім'я.
-
-Крім того, код використовує функцію `timezone.now()`, а значить, ми повинні імпортувати `timezone`.
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
 
-Остання пропущена частина - передача QuerySet `posts` шаблону (розглянемо, як це вивести в наступному розділі).
+Зазначте, будь ласка, що ми створюємо *змінну* для нашого QuerySet: `posts`. Сприймайте її як ім'я для QuerySet. З цього моменту ми можемо посилатися на неї через це ім'я.
 
-У функції `render` ми вже маємо параметр `request` (тобто усе, що ми отримуємо від користувача через Інтернет) і файл шаблону `'blog/post_list.html'`. Останній параметр, котрий виглядає як: `{}` - це місце, в якому ми можемо додавати певні речі для використання у шаблоні. Ми повинні дати їм імена (ми обмежились ім'ям `'posts'` наразі :)). Це має виглядати як: `{'posts': posts}`. Прохання звернути увагу, що частина перед `:` є рядком; вам необхідно взяти це у лапки `''`.
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. Ми повинні дати їм імена (ми обмежились ім'ям `'posts'` наразі). :) Це має виглядати як: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
 
 Отже, врешті-решт наш файл `blog/views.py` матиме наступний вигляд:
 
+{% filename %}blog/views.py{% endfilename %}
+
 ```python
 from django.shortcuts import render
 from django.utils import timezone
@@ -68,4 +78,4 @@ def post_list(request):
 
 Це все! Час повернутись назад до нашого шаблону і вивести QuerySet!
 
-Якщо бажаєте дізнатись трохи більше про QuerySets в Django, зазирніть сюди: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/uk/extend_your_application/README.md b/uk/extend_your_application/README.md
index 189c257df11..03768ca92a4 100755
--- a/uk/extend_your_application/README.md
+++ b/uk/extend_your_application/README.md
@@ -1,16 +1,17 @@
 # Розширте свою програму
 
-Ми вже завершили усі кроки, необхідні для створення нашого сайту: знаємо як написати модель, url, відображення та шаблон. А також знаємо про те, як зробити наш сайт гарнішим.
+Ми вже завершили усі кроки необхідні для створення нашого сайту: знаємо як написати модель, url, відображення та шаблон. А також знаємо про те, як зробити наш сайт гарнішим.
 
 Час попрактикуватись!
 
 Перша потрібна для нашого блогу річ це, очевидно, сторінка для відображення одного посту, чи не так?
 
-У нас вже є модель `Post`, отже? не треба нічого додавати до `models.py`.
+У нас вже є модель `Post`, отже не треба нічого додавати до `models.py`.
 
 ## Створюємо в шаблоні посилання на сторінку посту
 
-Почнемо із додавання посилання в `blog/templates/blog/post_list.html`. Таким чином, матимемо:
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -25,20 +26,23 @@
         </div>
     {% endfor %}
 {% endblock %}
-
 ```
 
-{% raw %}Ми хочемо, щоб в списку постів заголовок посилався на сторінку детальної інформації про пост. Давайте змінимо `<h1><a href="">{{ post.title }}</a></h1>` так, щоб вийшло посилання на пост:{% endraw %}
+{% raw %}Ми хочемо, щоб в списку постів заголовок посилався на сторінку детальної інформації про пост. Давайте змінімо `< h1 >< href = "" > </a ><{{ post.title }} / h1 >` так, щоб вийшло посилання на пост:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
 ```
 
-{% raw %}Саме час пояснити цей дивний запис `{% url 'post_detail' pk=post.pk %}`. Як можна було очікувати, `{% %}` означає, що ми використовуємо шаблонні теги Django. Цього разу ми використаєм один з них, який створить URL для нас!{% endraw %}
+Саме час пояснити цей дивний запис `{% url 'post_detail' pk=post.pk %}`. Як можна було очікувати, `{% %}` означає, що ми використовуємо шаблонні теги Django. Цього разу ми використаєм один з них, який створить URL для нас!
 
-`blog.views.post_detail` - це шлях до відображення `post_detail`, яке ми бажаємо створити. Зауважте, будь ласка, що: `blog` - це ім'я нашого додатку (папка `blog`), `views` взято з імені файлу `views.py` і остання частина - `post_detail` - це ім'я відображення.
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
 
-Тепер, коли перейдемо на: http://127.0.0.1:8000/, отримаємо помилку (як і очікувалось, оскільки у нас немає URL або потрібного *вигляду* (в'ю) для `post_detail`). Він буде виглядати наступним чином:
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
 
 ![NoReverseMatch error](images/no_reverse_match2.png)
 
@@ -48,7 +52,9 @@
 
 Ми хочемо, щоб наш перший пост був доступний за такою **URL-адресою**: http://127.0.0.1:8000/post/1/
 
-У файлі `blog/urls.py` вкажемо Django, де взяти відображення для запису блогу, яке називається `post_detail`. Додамо рядок `url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),`у файл `blog/urls.py`. Це має виглядати якось так:
+У файлі `blog/urls.py`, давайте вкажемо Django, де взяти відображення для блогозапису, яке називається `post_detail`. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. Це має виглядати якось так:
+
+{% filename %}blog/urls.py{% endfilename %}
 
 ```python
 from django.conf.urls import url
@@ -56,73 +62,88 @@ from . import views
 
 urlpatterns = [
     url(r'^$', views.post_list, name='post_list'),
-    url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
 ]
 ```
 
-Ця частина `^post/(?P<pk>[0-9]+)/$` виглядає страшно, але не хвилюйтеся - зараз ми все пояснимо:
-- вона починається з `^` - цей символ означає "початок",
-- далі `post/` означає, що після початку, URL-адреса має містити слова **post** та **/**. Все йде добре.
-- `(?P<pk>[0-9]+)` - ця частина хитріша. Вона означає, що Django візьме усе, що ви тут розмістите і передасть це до відображення як змінну із ім'ям `pk`. `[0-9]` також повідомляє нам про те, що це може бути лише цифрою, а не літерою (будь-яке значення між 0 та 9). `+` означає, що тут має бути один або більше символів. Таким чином, щось на зразок `http://127.0.0.1:8000/post//` є неприйнятним, однак `http://127.0.0.1:8000/post/1234567890/` цілком!
-- `/` - далі нам потрібно знову __/__
-- `$` - "кінець"!
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
 
-Це означає, що якщо введете `http://127.0.0.1:8000/post/5/`, Django зрозуміє, що ви шукаєте відображення із назвою `post_detail` і передає цьому відображенню інформацію, що `pk` дорівнює `5`.
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. Це означає, що Django візьме усе, що ви тут розмістите і передасть це до відображення як змінну із ім'ям `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` означає, що тут має бути один або більше символів. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
 
-`pk` - скорочення для первинного ключа - `primary key`. Це ім'я часто використовується в Django проектах. Однак, можете назвати вашу змінну як вам до вподоби (пам'ятайте: маленькі літери і `_` замість пробілів!). Наприклад, замість `(?P<pk>[0-9]+)` можемо мати змінну `post_id`, і, таким чином, ця частина буде виглядати як: `(?P<post_id>[0-9]+)`.
+Це означає, що якщо ви введете `http://127.0.0.1:8000/post/5/`, Django зрозуміє, що ви шукаєте відображення із назвою `post_detail` і передає цьому відображенню інформацію, що `pk` дорівнює `5`.
 
-Добре, ми додали новий шаблон URL для `blog/urls.py`! Давайте перезавантажимо сторінку: http://127.0.0.1:8000/ Опаньки! Знову помилка! Як ми і очікували.
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
 
 ![AttributeError](images/attribute_error2.png)
 
-Пам'ятаєте наступний крок? Звісно: треба додати відображення!
+Пам'ятаєте яким є наступний крок? Звісно: треба додати відображення!
 
-## Додамо деталі для відображення запису
+## Додамо деталі відображення запису
 
-Цього разу наше відображення отримує додатковий параметр - `pk`. Наше відображення має вилучити його, правда ж? Отже, визначимо нашу функцію як `def post_detail(request, pk):`. Зауважте, що треба використовувати точно таке ж ім'я, як ми визначили в urls (`pk`). Неправильно нехтувати цією змінною, це призведе до помилки!
+This time our *view* is given an extra parameter, `pk`. Наше відображення має вилучити його, правда ж? Отже, визначимо нашу функцію як `def post_detail(request, pk):`. Зауважте, що треба використовувати точно таке ж ім'я як ми визначили в urls (`pk`). Неправильно нехтувати цією змінною, це призведе до помилки!
 
-А тепер, ми хотіли б додати один-єдиний пост. Щоб зробити, це можемо скористатися наступним запитом до бази даних:
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
 
-    Post.objects.get(pk=pk)
+{% filename %}blog/views.py{% endfilename %}
 
-Однак, цей код містить проблеми. Якщо немає жодного поста із заданим первинним ключем (`pk`), ми отримаємо мегажахливу помилку!
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
 
 ![DoesNotExist error](images/does_not_exist2.png)
 
-Ми цього не хочемо! Звичайно, Django надає деякі інструменти, що будуть обробляти це для нас: `get_object_or_404`. У випадку, якщо немає постів із заданим `pk`, виведеться більш приємна сторінка (так звана сторінка `Page Not Found 404`).
+Ми цього не хочемо! Але, звичайно, Django надає деякі інструменти, що будуть обробляти це для нас: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
 
 ![Page not found](images/404_2.png)
 
-Хороші новини полягають в тому, що можна створити свою власну сторінку `Page not found` і зробити її настільки гарною, наскільки ви захочете. Однак, це не є надто важливим на даний момент, тому пропустимо цей крок.
+Хороші новини полягають в тому, що можна створити свою власну сторінку `Page not found` і зробити її настільки гарною, наскільки ви захочете. Однак, це не є надто важливим на даний момент, отже, пропустимо цей крок.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
 
-Добре, час додати відображення у наш файл `views.py`!
+{% filename %}blog/views.py{% endfilename %}
 
-Нам треба відкрити `blog/views.py` і додати наступний код:
+```python
+from django.shortcuts import render, get_object_or_404
+```
 
-    from django.shortcuts import render, get_object_or_404
+And at the end of the file we will add our *view*:
 
-Поряд із іншими рядками `from`. А в кінці файлу додамо наше відображення:
+{% filename %}blog/views.py{% endfilename %}
 
-    def post_detail(request, pk):
-        post = get_object_or_404(Post, pk=pk)
-        return render(request, 'blog/post_detail.html', {'post': post})
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
 
 Так. Прийшла пора оновити сторінку: http://127.0.0.1:8000 /
 
 ![Post list view](images/post_list2.png)
 
-Спрацювало! Але що ж трапиться, коли ви натиснете на посилання в заголовку поста?
+Спрацювало! Але що ж трапиться коли ви клікните на посилання в заголовку поста?
 
 ![TemplateDoesNotExist error](images/template_does_not_exist2.png)
 
-О, ні! Інша помилка! Але ж ми вже знаємо, як із цим поводитись, чи не так? Потрібно додати шаблон!
+О ні! Інша помилка! Але ж ми вже знаємо як із цим поводитись, чи не так? Потрібно додати шаблон!
 
-## Створюємо шаблон для деталей запису
+## Create a template for the post details
 
 Створимо файл в `blog/templates/blog` і назвемо його `post_detail.html`.
 
 Це буде виглядати так:
 
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -139,11 +160,11 @@ urlpatterns = [
 {% endblock %}
 ```
 
-Знову розширюємо `base.html`. Всередині блоку `content` ми хотіли б відобразити такі параметри як: published_date (якщо існує), title і text. Але мусимо обговорити певні важливі речі, правда ж?
+Знову розширюємо `base.html`. Всередині блоку `content` ми хотіли б відобразити такі параметри як: published_date (якщо існує), title і text. Але, мусимо обговорити певні важливі речі, правда ж?
 
-{% raw %}`{% if ... %} ... {% endif %}` - це шаблонний тег, який можна використовувати, коли ми бажаємо перевірити дещо (пам'ятаєте `if ... else ..` з розділу __Вступ до Python__?). У цьому випадку ми хочемо перевірити, чи дата запису `published_date` не порожня.{% endraw %}
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
 
-Окей, можемо перезавантажити нашу сторінку і побачити, чи повідомлення `Page not found` тепер зникло.
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
 
 ![Post detail page](images/post_detail2.png)
 
@@ -153,25 +174,24 @@ urlpatterns = [
 
 Було б добре переконатись, що ваш сайт буде працювати на PythonAnywhere, вірно? Спробуймо зробити розгортання ще раз.
 
-```
-$ git status
-$ git add --all .
-$ git status
-$ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
-$ git push
-```
+{% filename %}command-line{% endfilename %}
 
-*   Тоді в [Bash консолі PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
 
-```
-$ cd my-first-blog
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```
+Тоді, в [bash консолі PythonAnywhere](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
 
-* Нарешті, перейдіть на [вкладку Web](https://www.pythonanywhere.com/web_app_setup/) і натисніть **Reload**.
+Ну й нарешті перестрибніть на [вкладку Web](https://www.pythonanywhere.com/web_app_setup/) і натисніть **Reload**.
 
-І це все! Вітання :)
+І це все! Вітання :)
\ No newline at end of file
diff --git a/uk/how_the_internet_works/README.md b/uk/how_the_internet_works/README.md
index 61cc68f8363..6ab3f765596 100644
--- a/uk/how_the_internet_works/README.md
+++ b/uk/how_the_internet_works/README.md
@@ -1,48 +1,47 @@
 # Як працює Інтернет
 
-> На створення цього розділу нас надихнула розмова "Як працює Інтернет" Джесіки Маккеллар (http://web.mit.edu/jesstess/www/).
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
 
-Б'ємось об заклад, ви використовуєте Інтернет кожного дня. Однак, чи знаєте ви насправді, що трапляється, коли ви набираєте адресу на зразок https://djangogirls.org у браузері та натискаєте `enter`?
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
 
-Перша річ, яку вам необхідно зрозуміти - це те, що веб-сайт є лише набором файлів на жорсткому диску. Просто як фільми, музика або зображення.
-Проте, є одна унікальна річ для веб-сайтів: вони містять комп'ютерний код, що називається HTML.
+Перша річ, яку вам необхідно зрозуміти це те, що веб сайт є лише набором файлів на жорсткому диску. Таких же як ваші фільми, музика і фотографії. Проте, є одна річ унікальна для веб сайтів: вони включають комп'ютерний код, що називається HTML.
 
-Якщо ви не знайомі із програмуванням, спочатку може бути складно зрозуміти, що таке HTML, але веб-браузери (такі як Chrome, Safari, Firefox тощо) його люблять.
-Веб-браузери розроблені спеціально, щоб розуміти цей код, виконувати його інструкції та показувати файли, з якого складається ваш сайт, саме так, як ви того забажаєте.
+Якщо ви не знайомі із програмуванням, спочатку може бути складно зрозуміти що таке HTML, але ваші веб-браузери (такі як Chrome, Safari, Firefox, тощо) його люблять. Веб-браузери пристосовані для того, щоб розуміти цей код, виконувати його інструкції та показувати файли, з яких складається ваш сайт, саме так як ви хочете.
 
-Як і звичайні файли, нам потрібно зберігати HTML-файли в певному місці на жорсткому диску. В Інтернеті ми використовуємо спеціальні потужні комп'ютери, що називаються *серверами*.
-Вони не мають екрану, мишки чи клавіатури, тому що їхня основна ціль - зберігати і обробляти дані. Саме тому ці комп'ютери назвали *серверами*, вони обробляють (англ. to *serve* - обробляти) ваші дані.
+Як і з кожним файлом, нам потрібно зберігати HTML файли в певному місці на жорсткому диску. В Інтернеті ми використовуємо спеціальні потужні комп'ютери, що називаються *серверами*. Вони не мають екрану, мишки чи клавіатури тому, що їхня основна ціль -- зберігати і обробляти дані. That's why they're called *servers* – because they *serve* you data.
 
-Гаразд, але ж ви хочете дізнатися як виглядає Інтернет, чи не так?
+OK, but you want to know how the Internet looks, right?
 
 Ми намалювали для вас картинку! Вона виглядає наступним чином:
 
-![Рисунок 1.1](images/internet_1.png)
+![Figure 1.1](images/internet_1.png)
 
-Суцільний безлад, правильно? Фактично, це мережа з'єднаних машин (вище зазначених *серверів*). Сотні тисяч машин! Багато-багато кілометрів кабелю по усьому світу! Можете відвідати веб-сайт Submarine Cable Map (http://submarinecablemap.com/), щоб побачити, наскільки складною є мережа. Тут наведено знімок з веб-сайту:
+Виглядає як суцільний безлад, чи не так? In fact it is a network of connected machines (the above-mentioned *servers*). Сотні тисяч машин! Багато-багато кілометрів кабелю по усьому світу! Можете відвідати веб сайт Submarine Cable Map (http://submarinecablemap.com/), щоб побачити, наскільки складною є мережа. Тут наведено скріншот з веб-сайту:
 
-![Рисунок 1.2](images/internet_3.png)
+![Figure 1.2](images/internet_3.png)
 
-Вражаюче, чи не так? Але однозначно, неможливо мати проводи між кожною машиною, підключеною до Інтернету. Отже, щоб досягти машини (наприклад, ту на якій збережено https://djangogirls.org), ми повинні передати запит через багато-багато різних машин.
+Вражаюче, чи не так? Але однозначно, неможливо мати проводи між кожною машиною підключеною до Інтернету. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
 
 Це виглядатиме так:
 
-![Рисунок 1.3](images/internet_2.png)
+![Figure 1.3](images/internet_2.png)
 
-Уявіть, що коли ви набираєте https://djangogirls.org, ви відправляєте листа, що говорить: "Шановні Django Girls, я хочу побачити веб-сайт djangogirls.org. Відправте мені його, будь ласка!"
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
 
 Ваш лист надійде до найближчого поштового віділення. Далі він надходить до іншого, що знаходиться трохи ближче до вашого адресата, далі до іншого і так далі, поки не буде досягнуто остаточного пункту призначення. Єдина відмінність в тому, що при відправці багатьох листів (*пакетів даних*) в однакове місце, кожен з них може піти через абсолютно різні поштові відділення (*маршрутизатори*). Це залежить від того, як їх розподілили в кожному відділенні.
 
-![Рисунок 1.4](images/internet_4.png)
+![Figure 1.4](images/internet_4.png)
 
-Так, це так само просто. Ви відправляєте повідомлення і очікуєте певної відповіді. Звісно, замість паперу і ручки ви використовуєте байти даних, але ідея та сама!
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
 
-Замість адрес із назвами вулиці, міста, індексом і назвою країни, ми використовуємо IP адреси. Ваш комп'ютер спочатку запитує про DNS (англ. Domain Name System - система доменних імен) для переводу djangogirls.org в IP-адресу. Це працює подібно до старомодних телефонних довідників, де ви могли б знайти ім'я особи, з якою бажаєте зв'язатися і знайти її номер телефону та адресу.
+Замість адрес із назвами вулиці, міста, індексом і назвою країни, ми використовуємо IP адреси. Ваш комп'ютер спочатку запитує про DNS (англ. Domain Name System - Система доменних імен) для переводу djangogirls.org в IP адресу. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
 
-Коли ви відправляєте листа, це потребує наявності певних речей для коректної доставки: адреса, штамп тощо. Також ви використовуєте мову, котру розуміє отримувач, правда ж? Те ж саме стосується і *пакетів даних*, які ви відправляєте, щоб побачити веб-сайт. Ми використовуємо протокол, який називається HTTP (англ. Hypertext Transfer Protocol, протокол передачі гіпер-текстових документів).
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. Також ви використовуєте мову, котру розуміє отримувач, правда ж? Те ж саме стосується і *пакетів даних*, які ви відправляєте, щоб побачити веб-сайт. Ми використовуємо протокол, який називається HTTP (англ. Hypertext Transfer Protocol, протокол передачі гіпер-текстових документів).
 
-Отже, по суті, коли у вас є веб-сайт, вам треба мати *сервер* (машину), де він житиме. Коли *сервер* отримує вхідний *запит* (в листі), він відправляє назад ваш веб-сайт (в іншому листі).
+Отже, по суті, коли у вас є веб сайт вам треба мати *сервер* (машину), де він житиме. Коли *сервер* отримує вхідний *запит* (в листі), він відправляє назад ваш веб-сайт (в іншому листі).
 
-Оскільки ви читаєте навчальний посібник з Django, ви запитаєте, що ж робить Django. Коли ви відправляєте відповідь, то не завжди бажаєте відправляти одне й те саме кожному. Набагато краще, якщо ваші листи є персоналізованими, особливо для осіб, які щойно вам написали, еге ж? Django допомагає вам зі створенням цих персоналізованих цікавих листів :).
+Since this is a Django tutorial, you might ask what Django does. Коли ви відправляєте відповідь, то не завжди бажаєте відправляти одне й те саме кожному. Набагато краще якщо ваші листи є персоналізованими, особливо для осіб, які щойно вам написали, правда ж? Django допомагає вам зі створенням цих персоналізованих, цікавих листів. :)
 
-Досить розмов, час творити!
+Enough talk – time to create!
\ No newline at end of file
diff --git a/uk/html/README.md b/uk/html/README.md
index ab871101e16..234fe6d6b49 100644
--- a/uk/html/README.md
+++ b/uk/html/README.md
@@ -2,15 +2,15 @@
 
 Ви можете запитати, що таке шаблон?
 
-Шаблон - це файл, який ми можемо повторно використовувати для представлення різноманітної інформації в послідовному форматі. Наприклад, ви можете використовувати шаблон для допомоги у написанні листа, бо, хоча кожен лист може містити різне повідомлення та бути адресованим різним особам, усі листи поширюватимуться у однаковому форматі.
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
 
-Формат Django шаблону описаний мовою, що називається HTML (це HTML, зазначений у першому розділі **Як працює Інтернет**).
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
 
 ## Що таке HTML?
 
-HTML - це простий код, що інтерпретується вашим веб браузером (таким як Chrome, Firefox чи Safari) для відображення веб сторінки для користувача.
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
 
-HTML розшифровується як "Мова розмітки гіпертексту". __Гіпертекст__ означає тип тексту, який підтримує гіперпосилання між сторінками. __Розмітка__ (англ. markup) означає, що ми отримали документ із розміченим кодом для того, щоб повідомити комусь (у даному випадку, браузеру) як треба інтерпретувати сторінку. HTML код побудований за допомогою __тегів__, кожен з яких починається із `<` і закінчується на `>`. Теги представляють __елементи розмітки__.
+HTML розшифровується як "Мова розмітки гіпертексту". **Гіпертекст** означає тип тексту, який підтримує гіперпосилання між сторінками. **Markup** (розмітка) означає, що ми отримали документ із розміченим кодом для того, щоб повідомити дещо (у даному випадку, браузер) як треба інтерпретувати сторінку. HTML код побудований за допомогою **тегів**, кожен з яких починається із `<` і закінчується `>`. Теги представляють **елементи розмітки**.
 
 ## Ваш перший шаблон!
 
@@ -21,14 +21,15 @@ HTML розшифровується як "Мова розмітки гіперт
     blog
     └───templates
         └───blog
+    
 
-(Вас може здивувати, для чого нам потрібно дві папки із однаковим ім'ям `blog` - як виявиться пізніше, це всього лише зручне узгодженість із найменування, котра спрощує життя, коли речі починають ускладнюватися.)
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
 
-А тепер створіть файл `post_list.html` (просто залиште його поки що порожнім) всередині папки `blog/templates/blog`.
+А тепер створіть файл `post_list.html` (просто залиште його поки що пустим) всередині папки `blog/templates/blog`.
 
-Погляньте, як тепер виглядає ваш веб сайт: http://127.0.0.1:8000/
+Погляньте як тепер виглядає ваш веб сайт: http://127.0.0.1:8000/
 
-> Якщо помилка `TemplateDoesNotExists` досі не зникла, спробуйте перезапустити ваш сервер. Перейдіть до командного рядка, зупиніть сервер, натиснувши Ctrl+C (клавіші Control і C разом) та активуйте його знову, запустивши команду `python manage.py runserver`.
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
 
 ![Рисунок 11.1](images/step1.png)
 
@@ -36,6 +37,8 @@ HTML розшифровується як "Мова розмітки гіперт
 
 Додайте наступне у ваш файл шаблону:
 
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 <html>
     <p>Hi there!</p>
@@ -43,26 +46,28 @@ HTML розшифровується як "Мова розмітки гіперт
 </html>
 ```
 
-То як тепер виглядає ваш веб-сайт? Натисніть, щоб з'ясувати: http://127.0.0.1:8000/
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
 
 ![Рисунок 11.2](images/step3.png)
 
 Спрацювало! Гарна робота :)
 
-- Базовий тег `<html>` завжди є початком будь-якої веб сторінки і `</html>` - завжди є кінцем. Як бачите, увесь контент сайту розміщений між початковим тегом `<html>` і закриваючим тегом `</html>`.
-- `<p>` - тег для елементів абзацу; `</p>` закриває кожен абзац.
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. Як бачите, увесь контент сайту розміщений між початковим тегом `<html>` і закриваючим тегом `</html>`
+* `<p>` - тег для елементів абзацу; `</p>` закриває кожен абзац
+
+## Head and body
 
-## Голова і тіло (Head & body)
+Кожну сторінку HTML також можна поділити на два елементи: **head** - (голова) і **body** - (тіло.
 
-Кожну сторінку HTML також можна поділити на два елементи: __head__ - (голова) і __body__ - (тіло).
+* **head** - елемент, що містить інформацію про документ, яка не відображається на екрані.
 
-- __head__ - елемент, що містить інформацію про документ, яка не відображається на екрані.
+* **body** - елемент, що містить усе інше, що відображається як частина веб сторінки.
 
-- __body__ - елемент, що містить усе інше, що відображається як частина веб сторінки.
+Ми використовуємо `<head>` щоб повідомити браузер про конфігурацію сторінки, а `<body>` щоб повідомити браузер, що у дійсності знаходиться на сторінці.
 
-Ми використовуємо `<head>` щоб повідомити браузер про конфігурацію сторінки, а `<body>`, щоб повідомити браузер, що у дійсності знаходиться на сторінці.
+For example, you can put a web page title element inside the `<head>`, like this:
 
-Наприклад, ви можете розмістити заголовок веб-сторінки всередині `<head>` наступним чином:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -80,29 +85,32 @@ HTML розшифровується як "Мова розмітки гіперт
 
 ![Рисунок 11.3](images/step4.png)
 
-Зауважте, як браузер зрозумів , що "Ola's blog" - це заголовок вашої сторінки? Він інтерпретував `<title>Ola's blog</title>` і розмістив текст у рядку заголовка вашого браузера (він також буде використаний для закладок чи інших речей).
+Зауважте як браузер зрозумів , що "Ola's blog" це заголовок вашої сторінки? Він інтерпретував `<title>Ola's blog</title>` і розмістив текст у рядку заголовка вашого браузера (він також буде використаний для закладок чи інших речей).
 
-Можливо, ви також звернули увагу, що кожен відкриваючий тег відповідає *закриваючому тегу*, із `/`, і ці елементи є *вкладеними* (тобто ви не можете закрити окремий тег поки усі теги, що містяться всередині не будуть також закриті).
+Можливо, ви також зауважили, що кожен відкриваючий тег відповідає *закриваючому тегу*, із `/`, і ці елементи є *вкладеними* (тобто ви не можете закрити окремий тег поки усі теги, що містяться всередині не будуть також закриті).
 
 Це щось на кшталт як покласти речі всередину ящиків. У вас є один великий ящик, `<html></html>`; всередині цього ящика є `<body></body>`, що містить ще менші ящики: `<p></p>`.
 
-Ви повинні керуватися цими правилами _закриваючих_ тегів, і _вкладених_ елементів - якщо ви цього не робитимите, браузер може бути не в змозі інтерпретувати їх правильно і ваша сторінка буде відображатись некоректно.
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
 
 ## Налаштуйте ваш шаблон
 
 А тепер можете трохи побавитися і спробувати налаштувати ваш шаблон! Тут наведено декілька корисних тегів для цього:
 
-- `<h1>Заголовок</h1>` - для найважливішого заголовка
-- `<h2>Підзаголовок</h2>` для заголовків наступного рівня
-- `<h3>Підпідзаголовок</h3>` ... і так далі, аж до `<h6>`
-- `<em>текст</em>` робить акцент на вашому тексті
-- `<strong>текст</strong>` робить сильний акцент на вашому тексті
-- `<br />` переходить на наступну лінію (ви не можете нічого розмістити всередині br)
-- `<a href="https://djangogirls.org">link</a>` створює посилання
-- `<ul><li>перший елемент</li><li>другий елемент</li></ul>` створює список, такий як цей!
-- `<div></div>` визначає блок сторінки
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>Підзаголовок</h2>` для заголовків наступного рівня
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>текст</em>` робить акцент на вашому тексті
+* `<strong>текст</strong>` робить сильний акцент на вашому тексті
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` створює посилання
+* `<ul><li>перший елемент</li><li>другий елемент</li></ul>` створює список, такий як цей!
+* `<div></div>` визначає блок сторінки
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
 
-Тут наведено повний приклад шаблону:
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 <html>
@@ -111,7 +119,7 @@ HTML розшифровується як "Мова розмітки гіперт
     </head>
     <body>
         <div>
-            <h1><a href="">Django Girls Blog</a></h1>
+            <h1><a href="/">Django Girls Blog</a></h1>
         </div>
 
         <div>
@@ -131,16 +139,16 @@ HTML розшифровується як "Мова розмітки гіперт
 
 Тут було створено три блоки `div`.
 
-- Перший `div` елемент містить заголовок нашого блогу - а точніше, заголовок і посилання
-- Два інших `div` елементи містять наші пости із датою публікації, `h2` із заголовком поста, який можна клікнути і два `p` (абзаци) тексту, один для дати, а інший для нашого блог посту.
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Два інших `div` елементи містять наші пости із датою публікації, `h2` із заголовком поста, який можна клікнути і два `p` (абзаци) тексту, один для дати, а інший для нашого блог посту.
 
 Отримуємо наступний ефект:
 
 ![Рисунок 11.4](images/step6.png)
 
-Йой! Але досі, наш шаблон лише незмінно відображає точно __таку ж інформацію__ - тоді як раніше йшлося про шаблони, що дозволяють нам відображувати __різну__ інформацію в __однаковому форматі__.
+Йой! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
 
-Що б ми дійсно хотіли зробити, так це відобразити реальні пости, додані в нашій панелі адміністратора Django - це те, до чого ми перейдемо далі.
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
 
 ## Ще одна річ: розгортання!
 
@@ -148,47 +156,58 @@ HTML розшифровується як "Мова розмітки гіперт
 
 ### Фіксування (commit) і завантаження (push) коду на GitHub
 
-По-перше, давайте подивимося, які файли були змінені після розгортання (виконайте ці команди локально, не на PythonAnywhere):
+По-перше, давайте подивимося які файли були змінені після розгортання (виконайте ці команди локально, не на PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
 
     $ git status
+    
 
 Переконайтеся, що ви перебуваєте в директорії `djangogirls`, далі давайте скажемо для `git` включити всі зміни в рамках цього каталогу:
 
+{% filename %}command-line{% endfilename %}
+
     $ git add --all .
+    
 
-> __Зауваження__ `-A` (коротко усі - "all") означає, що `git` також розпізнає якщо раптом ви видалили файли (за замовчуванням, він розпізнає лише нові/змінені файли). Також пам'ятайте (з розділу 3), що `.` означає поточну директорію.
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Також пам'ятайте (з розділу 3), що `.` означає поточну директорію.
 
 Перед тим як завантажити усі файли, давайте перевіримо що ж буде завантажувати `git` (усі файли, які буде завантажувати `git` повинні тепер з'явитися і бути позначеними зеленим кольором):
 
+{% filename %}command-line{% endfilename %}
+
     $ git status
+    
 
 Майже на місці, а тепер час повідомити йому про те, що треба зберегти ці зміни в його історії. Ми збираємося задати "commit message" що ж ми змінили. На цьому етапі можна набрати будь-що, що вважатимете за потрібне, однак, має сенс надрукувати щось дійсно зрозуміле, щоб, таким чином, ви могли згадати що ви зробили у майбутньому.
 
+{% filename %}command-line{% endfilename %}
+
     $ git commit -m "Changed the HTML for the site."
+    
 
-> __Зауваження__ Переконайтеся, що ви використали подвійні лапки навколо повідомлення про здійснену фіксацію.
+> **Зауваження** Переконайтеся, що ви використали подвійні лапки навколо повідомлення про здійснену фіксацію.
 
-Після того, як ми це зробили, завантажимо (push) наші зміни до GitHub:
+Once we've done that, we upload (push) our changes up to GitHub:
 
-    git push
+{% filename %}command-line{% endfilename %}
 
+    $ git push
+    
 
 ### Завантаження (pull) нового коду на PythonAnywhere і перезапуск веб-додатку
 
 * Відкрийте [сторінку з терміналами на PythonAnywhere](https://www.pythonanywhere.com/consoles/) і переключіться на вже запущений **Bash термінал** (або запустіть новий). Далі, наберіть команди:
 
-```
-$ cd ~/my-first-blog
-$ source myvenv/bin/activate
-(myvenv)$ git pull
-[...]
-(myvenv)$ python manage.py collectstatic
-[...]
-```
+{% filename %}command-line{% endfilename %}
 
-Подивіться, що ваш код почав завантажуватись. Якщо ви хочете перевірити успішність процедури, відкрийте вкладку **Files** і подивіться на свій код на PythonAnywhere.
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
 
+Подивіться, що ваш код почав завантажуватись. Якщо ви хочете перевірити успішність процедури, відкрийте вкладку **Files** і подивіться на свій код на PythonAnywhere.
 
-* Зрештою, переключіться на вкладку [Web](https://www.pythonanywhere.com/web_app_setup/) і натисніть **Reload**.
+* Під кінець, переключіться на вкладку [Web](https://www.pythonanywhere.com/web_app_setup/) і натисніть **Reload**.
 
-Оновлення повинні відобразитись на вашому веб-сайті! Переключись на нього і онови сторінку. Ви повинні побачити зміни :)
+Оновлення повинні відобразитись на вашому веб-сайті! Переключись на нього і онови сторінку. Ви повинні побачити зміни. :)
\ No newline at end of file
diff --git a/uk/install_git.md b/uk/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/uk/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/uk/installation/README.md b/uk/installation/README.md
index bff76bf0fef..dbf12b5c170 100644
--- a/uk/installation/README.md
+++ b/uk/installation/README.md
@@ -1,48 +1,58 @@
 # Якщо ви проходите цей підручник вдома
 
-Якщо ви проходите цей посібник вдома, а не на одному з [майстер-класів Django Girls](https://djangogirls.org/events/), ви можете повністю пропустити цей розділ і перейти до розділу [Як працює Інтернет](../how_the_internet_works/README.md).
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
 
-Справа в тому, що ми все одно розглядаємо ці речі в посібнику, а цей розділ - лише додаткова сторінка, де зібрані разом всі інструкції по встановленню. Зустріч Django Girls включає в себе "Вечір налаштувань", коли ми встановлюємо все потрібне, щоб не витрачати на це час під час воркшопу, це дуже зручно для нас.
+Справа в тому, що ми все одно розглядаємо ці речі в підручнику, а цей розділ - це лише додаткова сторінка, де зібрані разом всі інструкції по встановленню. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
 
-Якщо ви вважаєте це корисним, можете пройти цей розділ також. Але якщо бажаєте почати вчитися без встановлення купи речей на ваш комп'ютер, пропустіть цей розділ і ми пояснимо як ставити програми пізніше.
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
 
 Успіхів!
 
 # Встановлення
-На воркшопі ви будете створювати блог, і в посібнику є кілька підготовчих задач по встановленню, які було б добре виконати заздалегідь, так щоб на воркшопі ви були відразу готові програмувати.
+
+На воркшопі ви будете створювати блог, і в підручнику є кілька підготовчих задач по встановленню, які було б добре виконати заздалегідь, так щоб на воркшопі ви були відразу готові програмувати.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
 
 # Встановіть Python
+
 {% include "/python_installation/instructions.md" %}
 
 # Налаштуйте virtualenv та встановіть Django
+
 {% include "/django_installation/instructions.md" %}
 
 # Встановіть редактор коду
+
 {% include "/code_editor/instructions.md" %}
 
 # Встановіть Git
+
 {% include "/deploy/install_git.md" %}
 
 # Створіть аккаунт на GitHub
+
 Зайдіть на [GitHub.com](https://www.github.com) і зареєструйте новий безкоштовний аккаунт користувача.
 
 # Створіть аккаунт на PythonAnywhere
-{% include "/deploy/signup_pythonanywhere.md" %}
 
+{% include "/deploy/signup_pythonanywhere.md" %}
 
 # Почніть читати
 
-Вітання, ви все зробили і готові йти вперед! Якщо ви все ще маєте час перед воркшопом, буде корисно, якщо ви почнете читати кілька вступних розділів:
-
-  * [Як працює Інтернет](../how_the_internet_works/README.md)
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
 
-  * [Знайомство з командним рядком](../intro_to_command_line/README.md)
+* [Як працює Інтернет](../how_the_internet_works/README.md)
 
-  * [Вступ до Python](../python_introduction/README.md)
+* [Знайомство з командним рядком](../intro_to_command_line/README.md)
 
-  * [Що таке Django?](../django/README.md)
+* [Вступ до Python](../python_introduction/README.md)
 
+* [Що таке Django?](../django/README.md)
 
-# Насолоджуйтесь подією!
+# Enjoy the workshop!
 
-Після початку воркшопу, можете відразу перейти до [вашого першого Django проекту!](../django_start_project/README.md), тому що ви пройшли матеріал із попередніх розділів.
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/uk/instructions.md b/uk/instructions.md
new file mode 100644
index 00000000000..b5a0981698b
--- /dev/null
+++ b/uk/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period. It's easy to install and use, and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source, easy to install and easy to use. It's available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/uk/intro_to_command_line/README.md b/uk/intro_to_command_line/README.md
index 01859a6c4e5..dfa7dfa28b4 100644
--- a/uk/intro_to_command_line/README.md
+++ b/uk/intro_to_command_line/README.md
@@ -1,71 +1,110 @@
 # Вступ до інтерфейсу командного рядка
 
-Це захоплює, чи не так?! Ви напишете свій перший рядок коду через декілька хвилин :)
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
 
-__Дозвольте нам представити вас вашому новому другові: командний рядок!__
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
 
-Наступні кроки покажуть вам, як користуватися чорним вікном хакерів. Спочатку це може видаватися трохи жахливим, однак насправді - це лише командна підказка, що очікує від вас певних команд.
+**Дозвольте нам представити вас вашому новому другові: командний рядок!**
 
-> **Примітка.** Зауважте, що в цій книзі ми використовуємо терміни 'директорія', 'каталог' та 'папка' взаємозамінно, ці слова означають одне й те саме.
+Наступні кроки покажуть вам як користуватися чорним вікном, яким користуються усі хакери. Спочатку це може видаватися трохи жахливим, однак насправді це лише командна підказка, що очікує певних команд від вас.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
 
 ## Що таке командний рядок?
 
-Вікно, яке зазвичай називають __командним рядком__ або __інтерфейсом командного рядка__, є текстовою програмою для перегляду, обробки і управління файлами на вашому комп'ютері. Як Провідник на Windows чи Finder на Mac, але без графічного інтерфейсу. Інші назви командного рядка: *cmd*, *CLI*, *prompt*, *console* або *terminal*.
+Вікно, яке зазвичай називають **командним рядком** або **інтерфейсом командного рядка**, є текстовою програмою для перегляду, обробки і управління файлами на вашому комп'ютері. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Інші назви командного рядка: *cmd*, *CLI*, *prompt*, *console* або *terminal*.
 
 ## Відкриваємо інтерфейс командного рядка
 
 Щоб почати експериментувати, нам потрібно спочатку відкрити наш інтерфейс командного рядка.
 
-### Windows
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
 
-Перейдіть до меню Пуск → Усі програми → Стандартні → Командний рядок.
+<!--endsec-->
 
-### Mac OS X
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
 
-Додатки → Утиліти → Термінал.
+Go to Applications → Utilities → Terminal.
 
-### Linux
+<!--endsec-->
 
-Скоріш за все Додатки → Стандартні → Термінал, але це може залежати від вашої системної версії. Якщо тут його немає, просто загугліть :)
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Скоріш за все Додатки → Стандартні → Термінал, але це може залежати від вашої системної версії. Якщо тут його немає, просто загугліть. :)
+
+<!--endsec-->
 
 ## Командний рядок
 
 Має з'явитися біле або чорне вікно, що очікує на ваші команди.
 
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
 Якщо ви працюєте на Mac або на Linux, ви напевно побачите `$`, на зразок:
 
+{% filename %}command-line{% endfilename %}
+
     $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
 
 На Windows, це знак `>`:
 
+{% filename %}command-line{% endfilename %}
+
     >
+    
+
+<!--endsec-->
 
-Кожній команді буде передувати цей знак і один пробіл, але ви не мусите набирати їх. Ваш комп'ютер робитиме це для вас сам :)
+Кожній команді буде передувати цей знак і один пробіл, але ви не мусите набирати їх. Ваш комп'ютер робитиме це для вас сам. :)
 
-> Просто маленьке зауваження: у вашому випадку ви побачите щось на кшталт `C:\Users\ola>` або `Olas-MacBook-Air:~ ola$` перед знаком командного рядка і це на 100% є правильним.
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
 
-Частина до `$` або `>` включно називається *запрошенням командного рядка* або скорочено *командним рядком*. Вона запрошує вас ввести туди щось.
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
 
-У посібнику, коли нам потрібно, щоб ви набрали щось в командний рядок, ми включатимемо `$` або `>`, а іноді й більше символів зліва. Ви можете ігнорувати ліву частину і друкувати в командний рядок лише те, що починається після `$`.
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
 
 ## Ваша перша команда (ЙОЙ!)
 
-Почнемо з чогось простенького. Наберіть команду:
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ whoami
+    
+
+<!--endsec-->
 
-або
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > whoami
+    
+
+<!--endsec-->
 
-Далі натисніть `enter`. Це наш результат:
+А потім натисніть `enter`. Результатом буде:
+
+{% filename %}command-line{% endfilename %}
 
     $ whoami
     olasitarska
+    
 
-Як бачимо, комп'ютер лише виводить ваше ім'я користувача. Файно, еге ж?:)
+Як бачите, комп'ютер щойно надрукував ваше ім'я користувача. Акуратний, правда? :)
 
-> Спробуйте набирати кожну команду, а не копіювати і вставляти. Таким чином ви більше запам'ятаєте!
+> Try to type each command; do not copy-paste. You'll remember more this way!
 
 ## Основи
 
@@ -73,34 +112,57 @@ __Дозвольте нам представити вас вашому ново
 
 ### Поточна директорія
 
-Було б чудово знати, де ми перебуваємо зараз, чи не так? Давайте подивимося. Введіть цю команду і натисніть `enter`:
+Було б приємно знати, де ми перебуваємо зараз, чи не так? Давайте подивимося. Введіть цю команду і натисніть `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ pwd
     /Users/olasitarska
+    
+
+> Зауваження: 'pwd' відповідає 'print working directory' (англ. надрукувати робочу папку).
 
-Якщо ви працюєте на Windows:
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd
     C:\Users\olasitarska
+    
 
-Можливо, ви побачите щось схоже на вашій машині. Після того, як ви відкрили командний рядок, ви зазвичай починаєте зі своєї домашньої папки.
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
 
-> Зауваження: 'pwd' відповідає 'print working directory' (англ. надрукувати робочу папку).
+<!--endsec-->
+
+Можливо, ви побачите щось схоже на вашій машині. Після того, як ви відкрили командний рядок, ви зазвичай починаєте зі своєї домашньої папки.
 
----
+* * *
 
 ### Список файлів і папок
 
 Отже, що ж всередині? Було б круто з'ясувати. Давайте подивимось:
 
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ ls
     Applications
     Desktop
     Downloads
     Music
     ...
+    
+
+<!--endsec-->
 
-Windows:
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > dir
      Directory of C:\Users\olasitarska
@@ -109,146 +171,259 @@ Windows:
     05/08/2014 07:28 PM <DIR>      Downloads
     05/08/2014 07:28 PM <DIR>      Music
     ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
 
----
+* * *
 
 ### Змінити поточну директорію
 
 Тепер давайте перейдемо до директорії робочого столу:
 
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ cd Desktop
+    
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd Desktop
+    
+
+<!--endsec-->
+
+Перевірте чи дійсно щось змінилось:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
 
-Перевірте, чи дійсно щось змінилось:
+{% filename %}command-line{% endfilename %}
 
     $ pwd
     /Users/olasitarska/Desktop
+    
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd
     C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
 
 Ось!
 
-> ПРОФІ хитрощі: якщо ви наберете `cd D` і потім натиснете `tab` на клавіатурі, командний рядок автоматично заповнить решту імені, таким чином можна переходити швидше. Якщо папок, що починаються з "D" більше однієї, натисніть кнопку `tab` двічі для отримання списку варіантів.
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
 
 * * *
 
-### Створити директорію
+### Створити директорію 
+
+Як щодо створення каталогу practice на вашому робочому столі? Ви можете зробити це таким чином:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
 
-Як щодо створення каталогу `practice` на вашому робочому столі? Ви можете зробити це таким чином:
+{% filename %}command-line{% endfilename %}
 
     $ mkdir practice
+    
 
-Windows:
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > mkdir practice
+    
+
+<!--endsec-->
 
-Ця коротка команда створить папку з іменем `practice` на вашому робочому столі. Може перевірити чи є вона там, просто глянувши на свій Робочий стіл або запустивши команду `ls` або `dir`! Спробуйте :)
+Ця коротка команда створить папку з іменем `practice` на вашому робочому столі. Може перевірити чи є вона там, просто глянувши на свій Робочий стіл або запустивши команду `ls` або `dir`! Спробуйте. :)
 
 > ПРОФІ хитрощі: Якщо ви не хочете кожного разу набирати одну й ту ж команду, спробуйте натиснути кнопки `стрілка вгору` та `стрілка вниз` на своїй клавіатурі щоб повторити нещодавно використовувані команди.
 
----
+* * *
 
 ### Вправа!
 
-Невеличке випробування для вас: в щойно створеній директорії `practice` створіть папку `test`. Використайте команди `cd` та `mkdir`.
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
 
 #### Розв'язання:
 
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ cd practice
     $ mkdir test
     $ ls
     test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
 
-Windows:
+{% filename %}command-line{% endfilename %}
 
     > cd practice
     > mkdir test
     > dir
     05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
 
 Вітаємо! :)
 
----
+* * *
 
 ### Прибираємо
 
-Ми не хочемо залишити безлад, то ж давайте видалимо усе, що ми створили до цього моменту.
+Ми не хочемо залишити безлад, то ж давайте видалимо усе, що ми до цього моменту створили.
 
-Спочатку нам потрібно повернутися назад до директорії Робочий стіл:
+Спочатку, нам потрібно повернутися назад до директорії Робочий стіл:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ cd ..
+    
+
+<!--endsec-->
 
-Windows:
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd ..
+    
+
+<!--endsec-->
 
-Використання `cd` із `..` змінить вашу поточну директорію на батьківську (тобто папка, що містить вашу поточну папку).
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
 
 Перевірте де ми:
 
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ pwd
     /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
 
-Windows:
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > cd
     C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
 
 Тепер час видалити директорію `practice`:
 
-> __Увага__: Видалення файлів за допомогою `del`, `rmdir` або `rm` є безповоротнім, тобто *файли будуть видалені назавжди*! То ж, будьте конче обережними із цими командами.
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ rm -r practice
+    
+
+<!--endsec-->
 
-Windows:
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > rmdir /S practice
     practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
 
 Виконано! Щоб переконатися, що папку дійсно видалена, давайте перевіримо:
 
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
     $ ls
+    
+
+<!--endsec-->
 
-Windows:
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > dir
+    
+
+<!--endsec-->
 
 ### Вихід
 
-Це все наразі! Можна тепер спокійно закрити командний рядок. Давайте зробимо це хакерським методом, добре?:)
+Це все наразі! Можна тепер спокійно закрити командний рядок. Давайте зробимо це хакерським методом, добре? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     $ exit
+    
+
+<!--endsec-->
 
-Windows:
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
 
     > exit
+    
+
+<!--endsec-->
 
-Круто, га?:)
+Круто, га? :)
 
-## Підсумок
+## Зміст
 
 Тут наведено підсумок деяких корисних команд:
 
-| Команда (Windows) | Команда (Mac OS / Linux) | Опис                     | Приклад                                           |
-| ----------------- | ------------------------ | ------------------------ | ------------------------------------------------- |
-| exit              | exit                     | закрити вікно            | **exit**                                          |
-| cd                | cd                       | змінити директорію       | **cd test**                                       |
-| dir               | ls                       | список директорій/файлів | **dir**                                           |
-| copy              | cp                       | скопіювати файл          | **copy c:\test\test.txt c:\windows\test.txt** |
-| move              | mv                       | перемістити файл         | **move c:\test\test.txt c:\windows\test.txt** |
-| mkdir             | mkdir                    | створити нову директорію | **mkdir testdirectory**                           |
-| del               | rm                       | видалити директорію/файл | **del c:\test\test.txt**                        |
+| Команда (Windows) | Команда (Mac OS / Linux) | Опис                       | Приклад                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| вихід             | вихід                    | закрити вікно              | **вихід**                                         |
+| cd                | cd                       | змінити директорію         | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | список директорій/файлів   | **dir**                                           |
+| copy              | cp                       | скопіювати файл            | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | перемістити файл           | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | створити нову директорію   | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
 
-Тут наведено лише невелику кількість команд, котрі можна запускати у вашому командному рядку, однак, на даний момент ми не збираємося використовувати щось більше.
+Тут наведено лише невелика кількість команд, котрі можна запускати у вашому командному рядку, однак, на даний момент ми не збираємося використовувати щось більше.
 
 Якщо вас цікавить, [ss64.com](http://ss64.com) містить повний список посилань на команди для усіх операційних систем.
 
 ## Готові?
 
-Давайте зануримось у Python!
+Давайте зануримось у Python!
\ No newline at end of file
diff --git a/uk/python_installation/README.md b/uk/python_installation/README.md
index 48b6f8aabae..4c0696b0dda 100644
--- a/uk/python_installation/README.md
+++ b/uk/python_installation/README.md
@@ -2,13 +2,14 @@
 
 Нарешті ми тут!
 
-Але спершу, дозвольте нам розказати вам що ж таке Python. Python - це дуже популярна мова програмування, що може використовуватися для створення веб сайтів, ігор, наукових програм, графіки та багато-багато іншого.
+Але спершу, дозвольте нам розказати вам що ж таке Python. Python -- це дуже популярна мова програмування, що може використовуватися для створення веб сайтів, ігор, наукових програм, графіки та багато-багато іншого.
 
-Python розроблено наприкінці 80-х, і його головною ціллю є читабельність для людей (не тільки для машин!). Саме тому ця мова виглядає набагато простіше, ніж інші мови програмування. Це привносить простоту у процес вивчення, але не турбуйтеся, Python водночас є дуже потужним!
+Python бере свій початок з кінця 80-тих, і його головною ціллю є бути читабельним для людей (а не тільки для машин!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
 
 # Встановлення Python
 
-> **Примітка** Якщо ви вже прошли розділ установки, немає потреби робити це знову - можна пропустити і перейти відразу до наступного розділу!
-
-{% include "/python_installation/instructions.md" %}
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
 
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/uk/python_installation/instructions.md b/uk/python_installation/instructions.md
index 37ff8fbb794..3da67e09c25 100644
--- a/uk/python_installation/instructions.md
+++ b/uk/python_installation/instructions.md
@@ -1,60 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
 
-> Цей розділ базується на навчальних матеріалах Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
 
-Django написаний на Python. Нам потрібен Python, щоб робити усе, що заманеться на Django. Почнемо з його інсталяції! Ми хочемо встановити Python 3.4, отже якщо ви вже маєте якусь більш ранню версію, то необхідно її оновити.
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
 
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
 
-### Windows
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
 
-Python для Windows можна завантажити з сайту https://www.python.org/downloads/release/python-343/. Після завантаження файлу ***.msi**, ви повинні запустити його (натисніть по ньому двічі) і виконувати усі подальші інструкції. Важливо пам'ятати шлях (директорію), де ви встановили Python. Це знадобиться пізніше!
+![Не забудьте додати Python до змінної Path](../python_installation/images/python-installation-options.png)
 
-Зверніть увагу на другу сторінку "Customize" майстера установки, вам потрібно пролистати вниз і вибрати опцію "Add python.exe to the Path" (додати python.exe в системну змінну Path), як показано тут:
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
 
-![Не забудьте додати Python до змінної Path](../python_installation/images/add_python_to_windows_path.png)
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
 
-### Linux
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+Вам необхідно перейти на веб сайт https://www.python.org/downloads/release/python-361/ і завантажити Python інсталятор:
+
+* завантажте файл *Mac OS X 64-bit/32-bit installer*,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
 
 Цілком ймовірно, що у вас вже є Python встановлений разом із системою. Щоб перевірити це (а заодно й версію), відкрийте консоль і наберіть наступну команду:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 --version
-    Python 3.4.3
+    Python 3.6.1
+    
 
-Якщо Python не встановлено або ви бажаєте встановити іншу версію, то можете виконати встановлення наступним чином:
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. Якщо Python не встановлено або ви бажаєте встановити іншу версію, то можете виконати встановлення наступним чином:
 
+<!--endsec-->
 
-#### Debian або Ubuntu
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
 
 Наберіть наступну команду в консолі:
 
-    $ sudo apt-get install python3.4
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
 
+<!--endsec-->
 
-#### Fedora
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
 
 Скористайтеся наступною командою в консолі:
 
-    $ sudo dnf install python3.4
+{% filename %}command-line{% endfilename %}
 
+    $ sudo dnf install python3
+    
 
-#### openSUSE
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
 
-Скористайтеся наступною командою в консолі:
+<!--endsec-->
 
-    $ sudo zypper install python3
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
 
+Скористайтеся наступною командою в консолі:
 
-### OS X
+{% filename %}command-line{% endfilename %}
 
-Вам необхідно перейти на веб сайт https://www.python.org/downloads/release/python-343/ і завантажити Python інсталятор:
+    $ sudo zypper install python3
+    
 
-* завантажте файл *Mac OS X 64-bit/32-bit installer*,
-* Двічі клацніть на *python 3.4.3 macosx10.6.pkg*, щоб запустити інсталятор.
+<!--endsec-->
 
-Підтвердіть, що інсталяція пройшла успішно відкривши програму *Terminal* і запустивши команду `python3`:
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 --version
-    Python 3.4.3
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
 
-----
+* * *
 
-Якщо маєте певні сумніви, або щось пішло не так і ви без поняття, що робити далі - будь ласка, зверніться до свого тренера! Інколи не все йде гладко і краще звернутись по допомогу до когось, хто має більше досвіду.
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Інколи не все йде гладко і краще звернутись по допомогу до когось, хто має більше досвіду.
\ No newline at end of file
diff --git a/uk/python_introduction/README.md b/uk/python_introduction/README.md
index c9c23457c1a..4803454be83 100644
--- a/uk/python_introduction/README.md
+++ b/uk/python_introduction/README.md
@@ -1,118 +1,171 @@
 # Вступ до Python
 
-> Частина цього розділу базується на матеріалах Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
 
 Давайте напишемо якийсь код!
 
 ## Командний рядок Python
 
-Щоб розпочати роботу із Python, нам необхідно відкрити *командний рядок*. Ви вже повинні знати як це зробити, адже ознайомились із цим у розділі [Вступ до командного рядка](../intro_to_command_line/README.md).
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
 
-Як тільки будете готові, виконайте наведені нижче інструкції.
+Щоб розпочати роботу із Python нам необхідно відкрити *командний рядок*. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Так як ви готові, виконаємо наведені нижче інструкції.
 
 Ми хочемо відкрити консоль Python, тому введіть `python` на Windows або `python3` на Mac OS/Linux та натисніть `Enter`.
 
+{% filename %}command-line{% endfilename %}
+
     $ python3
-    Python 3.4.3 (...)
+    Python 3.6.1 (...)
     Type "help", "copyright", "credits" or "license" for more information.
     >>>
+    
 
 ## Ваша перша команда на Python!
 
-Після запуску команди Python командний рядок зміниться на `>>>`. Для нас це означає, що відтепер ми можемо користуватися лише командами мови Python. Вам не доведеться друкувати `>>>` - Python зробить це для вас сам.
+Після запуску команди Python командний рядок зміниться на `>>>`. Для нас це означає, що відтепер ми можемо користуватися лише командами мови Python. You don't have to type in `>>>` – Python will do that for you.
 
 Якщо забажаєте вийти із консолі Python, просто наберіть `exit()` або використайте комбінацію `Ctrl + Z` для Windows і `Ctrl + D` для Mac/Linux. Після того ви більше не побачите `>>>`.
 
-Але наразі, ми не бажаємо виходити із консолі Python. Ми хочемо дізнатися про неї більше. Почнемо з чогось простенького. Наприклад, спробуйте виконати певні алгебраїчні операції, на зразок `2 + 3` та натисніть `enter`.
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
 
-    >>> 2 + 3
-    5
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
 
-Чудово! Бачите, яким чином здійснено вивід відповіді? Python знає математику! Можна спробувати інші команди, наприклад:
 - `4 * 5`
 - `5 - 1`
 - `40 / 2`
 
-Поки що можете трохи побавитися із математикою, а далі повертайтесь назад :).
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
 
-Як бачите, Python є чудовим калькулятором. Хіба вас не цікавить, що ще можна робити...
+```python
+>>> 2 ** 3
+8
+```
+
+Поки що можете трохи побавитися із математикою, а далі повертайтесь назад. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
 
 ## Рядки
 
-Як щодо вашого імені? Наберіть ваше ім'я в лапках, як тут:
+Як щодо вашого імені? Наберіть ваше ім'я в лапках як тут:
+
+{% filename %}command-line{% endfilename %}
 
-    >>> "Ola"
-    'Ola'
+```python
+>>> "Ola"
+'Ola'
+```
 
-Щойно ви створили свій перший рядок! Це послідовність символів, що може бути оброблена комп'ютером. Рядок має постійно починатися і закінчуватися одним і тим же символом. Це може бути одинарна (`'`) або подвійна (`"`) лапка (немає ніякої різниці)! Лапки вказують Python, що всередині них рядок.
+Щойно ви створили свій перший рядок! Це послідовність символів, що може бути оброблена комп'ютером. Рядок має постійно починатися і закінчуватися одним і тим же символом. Це може бути одинарна (`'`) або подвійна (`"`) лапка (немає ніякої різниці)! Лапки вказують Python, що що всередині них рядок.
 
 Рядки можна об'єднувати. Спробуйте:
 
-    >>> "Hi there " + "Ola"
-    'Hi there Ola'
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
 
 Також можна множити рядки на число:
 
-    >>> "Ola" * 3
-    'OlaOlaOla'
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
 
 Якщо вам раптом треба поставити апостроф всередині рядка, то існує два шляхи це зробити.
 
 Використавши подвійні лапки:
 
-    >>> "Runnin' down the hill"
-    "Runnin' down the hill"
+{% filename %}command-line{% endfilename %}
 
-або ж екранувати апостроф за допомогою оберненої косої риски (англ. backslash `\`):
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
 
-    >>> 'Runnin\' down the hill'
-    "Runnin' down the hill"
+або ж екранувати апостроф за допомогою зворотнього слеша (бекслеша) (``):
 
-Гарно, еге ж? Щоб побачити своє ім'я, написане великими літерами, наберіть:
+{% filename %}command-line{% endfilename %}
 
-    >>> "Ola".upper()
-    'OLA'
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
 
-Ви щойно застосували до свого рядка `upper` __функцію__! Функція (така як `upper()`) - це набір інструкцій, які повинен виконувати Python над заданим об'єктом (`"Ola"`) з моменту її виклику.
+Гарно, еге ж? Щоб побачити своє ім'я написане великими літерами, просто наберіть:
 
-Якщо ви раптом забажаєте дізнатися про число літер, що містяться у вашому імені, то для цього також існує функція!
+{% filename %}command-line{% endfilename %}
 
-    >>> len("Ola")
-    3
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
 
-Здивовані, чому іноді ви викликаєте функції із `.` наприкінці рядка (на зразок `"Ola".upper()`), а іноді ви спочатку викликаєте функцію і вказуєте рядок у дужках? Що ж, в деяких випадках, функції належать об'єктам, як `upper()`, котра може бути виконана лише над рядком. У цьому випадку, ми називаємо функцію __методом__. Іншого разу, функції не належать до жодного об'єкту і можуть використовуватись стосовно різних типів об'єктів, як `len()`. Саме тому ви використовуємо `"Ola"` у якості параметра для функції `len`.
+Здивовані чому іноді ви викликаєте функції із `.` наприкінці рядка (на зразок `"Ola".upper()`), а іноді ви спочатку викликаєте функцію і вказуєте рядок у дужках? Що ж, в деяких випадках, функції належать об'єктам, як `upper()`, котра може бути виконана лише над рядком. У цьому випадку, ми називаємо функцію **методом**. Іншого разу, функції не належать до жодного об'єкту і можуть використовуватись стосовно різних типів об'єктів, як `len()`. Саме тому ви використовуємо `"Ola"` у якості параметра для функції `len`.
 
-### Підсумок
+### Зміст
 
 Гаразд, досить стосовно рядків. Отже, ви вже ознайомилися із такими поняттями як:
 
-- __командний рядок__ - набір команд (коду) в командному рядку Python дає результат у відповідях на Python
-- __числа і рядки__ - в Python числа використовуються для математичних розрахунків, а рядки - для текстових об'єктів
-- __оператори__ - на зразок + та \*, комбінують значення і продукують нове
-- __функції__ - на зразок upper() та len(), виконують дії над об'єктами.
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
 
 Це є основи кожної мови програмування, яку ви вивчатимете. Готові приступити до чогось складнішого? Б'ємось об заклад, що так!
 
 ## Помилки
 
-Спробуємо щось нове. Чи можемо ми отримати довжину числа тим же методом, як ми це робили для нашого імені? Наберіть `len(304023)` та натисніть `Enter`:
+Спробуємо щось нове. Чи можемо ми отримати довжину числа тим же методом як ми це робили для нашого імені? Наберіть `len(304023)` та натисніть `Enter`:
 
-    >>> len(304023)
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    TypeError: object of type 'int' has no len()
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+Ми отримали нашу першу помилку! Вона говорить про те, що об'єкт типу "int" (integers, цілі числа) не мають довжини. І що ж нам тепер робити? Можливо, можна записати наше число у формі рядка? Рядки ж мають довжину, правда?
 
-Ми отримали нашу першу помилку! Вона говорить про те, що об'єкт типу "int" (integers, цілі числа) не має довжини. І що ж нам тепер робити? Можливо, можна записати наше число у формі рядка? Рядки ж мають довжину, правда?
+{% filename %}command-line{% endfilename %}
 
-    >>> len(str(304023))
-    6
+```python
+>>> len(str(304023))
+6
+```
 
 Спрацювало! Ми використали функцію `str` всередині функції `len`. `str()` перетворює будь-що на рядки.
 
-- Функція `str` перетворює речі на __рядки__
-- Функція `int` перетворює речі на __цілі числа__
+- Функція `str` перетворює речі на **рядки**
+- Функція `int` перетворює речі на **цілі числа**
 
-> Важливо: ми можемо перетворювати числа на текст, однак, не можемо перетворити текст на числа - чому б дорівнювало `int('hello')`?
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
 
 ## Змінні
 
@@ -120,143 +173,214 @@
 
 Скажімо, ми хочемо створити змінну і назвати її `name`:
 
-    >>> name = "Ola"
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
 
-Бачите? Це просто! Просто: name дорівнює Ola.
+We type name equals Ola.
 
-Як ви зауважили, ваша програма не повернула нічого як вона це робила до того. Отже, як ми впевнимось, що змінна насправді існує? Просто введіть `name` і натисніть `enter`:
+Як ви зауважили, ваша програма не повернула нічого як вона це робила до того. Отже, як ми можемо бути певні, що змінна насправді існує? Просто введіть `name` і натисніть `Enter`:
 
-    >>> name
-    'Ola'
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
 
-Урра! Ваша перша змінна :)! Ви завжди можете змінити значення, на яке вона посилатиметься:
+Yippee! Your first variable! :) You can always change what it refers to:
 
-    >>> name = "Sonja"
-    >>> name
-    'Sonja'
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
 
 Також можна використовувати її у функціях:
 
-    >>> len(name)
-    5
+{% filename %}command-line{% endfilename %}
 
-Файно, хіба ні? Звісно, змінні можуть представляти будь-що, числа також! Спробуйте:
+```python
+>>> len(name)
+5
+```
 
-    >>> a = 4
-    >>> b = 6
-    >>> a * b
-    24
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
 
-А якщо ми використали неправильне ім'я? Чи можете ви передбачити, що станеться? Спробуймо!
+{% filename %}command-line{% endfilename %}
 
-    >>> city = "Tokyo"
-    >>> ctiy
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    NameError: name 'ctiy' is not defined
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Але що, якщо ми використали неправильне ім'я? Чи можете ви передбачити, що станеться? Спробуймо!
 
-Помилка! Як бачите, Python має різні типи помилок і дана помилка називається **NameError**. Python виведе для вас цю помилку, якщо ви спробуєте використати досі не визначену змінну. Якщо ж ви зіткнетеся із цією помилкою пізніше, перевірте свій код, чи не зробили ви помилки в написанні імен змінних.
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
 
-Поекспериментуйте із цим усім і подивіться, що можна робити!
+Помилка! Як бачите, Python має різні типи помилок і дана помилка називається **NameError**. Python виведе для вас цю помилку, якщо ви спробуєте використати досі не визначену змінну. Якщо ж ви зіткнетеся із цією помилкою пізніше, перевірте свій код щоб побачити чи не пропустили ви часом якоїсь змінної.
 
+Поекспериментуйте із цим усім поки що і подивіться що можна робити!
 
 ## Функція print
 
 Спробуйте наступне:
 
-    >>> name = 'Maria'
-    >>> name
-    'Maria'
-    >>> print(name)
-    Maria
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
 
 Коли ви просто набираєте `name`, Python інтерпретує відповіді за допомогою рядкового *представлення* змінної 'name', котра є набором літер M-a-r-i-a, взятим в одинарні лапки, ''. Коли ви повідомляєте `print(name)`, Python "надрукує" значення змінної на екран, без лапок, що є більш акуратним.
 
 Як ми потім побачимо, `print()` є також корисним коли ми хочемо надрукувати речі з внутрішніх функцій, або ж коли хочемо надрукувати речі в декілька рядків.
 
-
 ## Списки
 
-Окрім рядків та чисел, Python має усі види різних типів об'єктів. Наразі ми збираємося представити вашій увазі один із них, що називається __список__. Списки є саме тим, про що ви й подумали: це об'єкти, що є списками інших об'єктів :)
+Окрім рядків та чисел, Python має усі види різних типів об'єктів. Наразі ми збираємося представити вашій увазі один із них, що називається **список**. Списки є саме тим, про що ви й подумали: це є об'єкти, що є списками інших об'єктів. :)
 
 Створимо список:
 
-    >>> []
-    []
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Так, цей список пустий. Не дуже корисно, чи не так? Створимо список лотерейних чисел. Ми не бажаємо увесь час повторюватись, то ж покладемо усе до змінної, також:
 
-Так, цей список пустий. Не дуже корисно, чи не так? Створимо список лотерейних чисел. Ми не бажаємо увесь час повторюватись, тож покладемо усе до змінної:
+{% filename %}command-line{% endfilename %}
 
-    >>> lottery = [3, 42, 12, 19, 30, 59]
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
 
-Гаразд, маємо список! Що ми можемо із цим робити? Давайте глянемо скільки лотерейних номерів міститься у списку. Не маєте жодного уявлення, яку функцію для цього можна використати? Ви вже це знаєте!
+Гаразд, маємо список! Що ми можемо із цим робити? Давайте глянемо скільки лотерейних номерів міститься у списку. Не маєте жодного уявлення яку функцію для цього можна використати? Ви вже це знаєте!
 
-    >>> len(lottery)
-    6
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
 
 Так! `len()` може дати вам кількість об'єктів у списку. Зручно, правда ж? Може, тепер здійснимо сортування:
 
-    >>> lottery.sort()
+{% filename %}command-line{% endfilename %}
 
-Ця функція нічого не повертає, вона лише змінює порядок, в якому з'являються числа у списку. Давайте надрукуємо список знову і подивимось, що ж трапилося:
+```python
+>>> lottery.sort()
+```
+
+Ця функція нічого не повертає, вона лише змінює порядок, в якому з'являються числа у списку. Давайте надрукуємо список знову і подивимось що ж трапилося:
 
-    >>> print(lottery)
-    [3, 12, 19, 30, 42, 59]
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
 
 Як бачимо, числа у вашому списку тепер відсортовано починаючи з найменшого і закінчуючи найбільшим значенням. Вітаємо!
 
 Можливо, ми хочемо відсортувати числа у зворотньому порядку? Давайте це зробимо!
 
-    >>> lottery.reverse()
-    >>> print(lottery)
-    [59, 42, 30, 19, 12, 3]
+{% filename %}command-line{% endfilename %}
 
-Просто, чи не так? Якщо ви забажаєте щось додати до свого списку, то можете це зробити за допомогою наступної команди:
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
 
-    >>> lottery.append(199)
-    >>> print(lottery)
-    [59, 42, 30, 19, 12, 3, 199]
+If you want to add something to your list, you can do this by typing this command:
 
-Якщо захочете показати лише перше число, то можете зробити це використавши __індекси__. Індекс - це номер, що повідомляє про те, звідки у списку взято елемент. Програмісти вважають за краще рахувати з 0, таким чином, перший об'єкт у списку має індекс 0, наступний - 1 і так далі. Спробуйте наступне:
+{% filename %}command-line{% endfilename %}
 
-    >>> print(lottery[0])
-    59
-    >>> print(lottery[1])
-    42
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Якщо захочете показати лише перше число, то можете зробити це використавши **індекси**. Індекс - це номер, що повідомляє про те, звідки у списку взято елемент. Програмісти вважають за краще рахувати з 0, таким чином, перший об'єкт у списку має індекс 0, наступний — 1 і так далі. Спробуйте наступне:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
 
 Як бачимо, ви можете отримати доступ до різних об'єктів списку використавши ім'я списку та індекс об'єкта всередині квадратних дужок.
 
-Для того, щоб видалити що-небудь із списку, вам потрібно використовувати вище вивчені __індекси__ і команду `pop()`. Давайте спробуємо на прикладі та нагадаємо, що ми вивчили раніше; ми будемо видаляти перший елемент з нашого списку.
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
 
-    >>> print(lottery)
-    [59, 42, 30, 19, 12, 3, 199]
-    >>> print(lottery[0])
-    59
-    >>> lottery.pop(0)
-    >>> print(lottery)
-    [42, 30, 19, 12, 3, 199]
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
 
 Працює чудово!
 
-Для додаткового задоволення, спробуйте деякі індекси: 6, 7, 1000, -1, -6 або -1000. Подивіться, чи здатні ви передбачити результат команди перед її застосуванням. Чи мають ці результати якийсь смисл?
+Для додаткового задоволення, спробуйте деякі індекси: 6, 7, 1000, -1, -6 або -1000. Подивіться чи здатні ви передбачити результат команди перед її застосуванням. Чи мають ці результати якийсь смисл?
 
 Список усіх доступних методів для списку міститься у цьому розділі документації з Python: https://docs.python.org/3/tutorial/datastructures.html
 
 ## Словники
 
-Словник є чимось подібним до списку, але доступ до значень отримується шляхом пошуку за ключем замість індексу. Ключ може являти собою будь-який рядок або число. Синтаксис для визначення пустого словника:
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
 
-    >>> {}
-    {}
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
 
 Це показує, що ви просто створили пустий словник. Урра!
 
-А тепер спробуйте набрати наступну команду (спробуйте також замінити на вашу власну інформацію):
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
 
 ```python
 >>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
 ```
 
-За допомогою вказаної команди ви щойно створили змінну із назвою `participant` і трьома парами ключ-значення:
+With this command, you just created a variable named `participant` with three key–value pairs:
 
 - ключ `name` вказує на значення `'Ola'` (об'єкт `string` - рядок),
 - `country` вказує на `'Poland'` (інший об'єкт `string` - рядок),
@@ -264,17 +388,25 @@
 
 Можна перевірити значення індивідуальних ключів, використовуючи наступний синтаксис:
 
-    >>> print(participant['name'])
-    Ola
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
 
-Бачите, усе подібно до списку. Але вам не треба пам'ятати індекс - лише ім'я.
+Що трапиться якщо запитати Python про значення ключа, що не існує? Не здогадуєтесь? Давайте спробуємо і подивимось!
 
-Що трапиться, якщо запитати Python про значення ключа, якого не існує? Не здогадуєтесь? Давайте спробуємо і подивимось!
+{% filename %}command-line{% endfilename %}
 
-    >>> participant['age']
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    KeyError: 'age'
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
 
 Погляньте, інша помилка! Цього разу - **KeyError**. Python допомагає і підказує вам про те, що ключа `'age'` не існує в даному словнику.
 
@@ -283,122 +415,165 @@
 - Вам необхідна лише впорядкована послідовність елементів? Користуйтеся списком.
 - Вам потрібні значення асоційовані із ключами, так що ви можете ефективно переглядати їх (за допомогою ключа) пізніше? Користуйтеся словником.
 
-Словники, як і списки, є *змінюваними*, це означає, що вони можуть бути змінені після створення. Ви можете додати нові пари ключ/значення до словника після того, як він був створений, наприклад:
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
 
-    >>> participant['favorite_language'] = 'Python'
+```python
+>>> participant['favorite_language'] = 'Python'
+```
 
-Як і для списків, використання методу `len()` для словників, повертає значення пар ключ-значення в словнику. Наберіть команду:
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
 
-    >>> len(participant)
-    4
+{% filename %}command-line{% endfilename %}
 
-Сподіваюся, це наразі має сенс. :) Готові до ще більшого задоволення від роботи зі словниками? Перейдіть на наступний рядок, щоб побачити дещо дивовижне.
+```python
+>>> len(participant)
+4
+```
 
-Можна використовувати команду `pop()` для видалення елементів зі словника. Скажімо, якщо ви бажаєте видалити значення, що відповідає ключу `'favorite_numbers'`, просто наберіть наступну команду:
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
 
-    >>> participant.pop('favorite_numbers')
-    >>> participant
-    {'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+You can use the `pop()` method to delete an item in the dictionary. Скажімо, якщо ви бажаєте видалити значення, що відповідає ключу `'favorite_numbers'`, просто наберіть наступну команду:
 
-Як бачимо з результатів, пару ключ-значення, що відповідає ключу 'favorite_numbers' було видалено.
+{% filename %}command-line{% endfilename %}
 
-Аналогічно можна змінювати значення, асоційоване з уже існуючим ключем зі словника. Наберіть:
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
 
-    >>> participant['country'] = 'Germany'
-    >>> participant
-    {'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
 
-Як бачимо, значення ключа `'country'` було змінено із `'Poland'` на `'Germany'`. :) Вражаюче? Ура! Ви щойно освоїли іншу дивовижну річ.
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
 
-### Підсумок
+{% filename %}command-line{% endfilename %}
 
-Чудово! Тепер ви знаєте багато про програмування. У цій останній частині ви дізналися про такі поняття, як:
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
 
-- __помилки__ - тепер ви знаєте як читати та розуміти помилки, що з'являються якщо Python не розуміє отриманої команди
-- __змінні__ - імена для об'єктів, що дозволяють вам спростити процес написання коду і робить його більш читабельним
-- __списки__ - списки певним чином впорядкованих об'єктів
-- __словники__ - об'єкти, що зберігають пари ключ-значення
+### Зміст
+
+Чудово! Тепер ви знаєте багато про програмування. У цій останній частині ви дізналися про такі поняття як:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
 
 Не дочекаєтеся переходу до наступної частини? :)
 
 ## Порівняння
 
-Велика частина програмування включає речі, пов'язані із порівнянням. Що є найпростішою річчю для порівняння? Звісно, числа. Давайте подивимось як це працює:
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
 
-    >>> 5 > 2
-    True
-    >>> 3 < 1
-    False
-    >>> 5 > 2 * 2
-    True
-    >>> 1 == 1
-    True
-    >>> 5 != 2
-    True
+{% filename %}command-line{% endfilename %}
 
-Ми надали Python деякі числа для порівняння. Як бачимо, Python вміє порівнювати не лише числа, а й результати операцій. Гарно, еге ж?
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
 
-Цікаво, чому ми використали два однакові знаки `==`, щоб порівняти на рівність числа? Ми використовуємо `=` для присвоєння значень змінним. Завжди, __завжди__ треба писати `==`, якщо ви бажаєте здійснити перевірку двох чисел на рівність одне одному. Ми також можемо перевіряти, чи два об'єкти є нерівними. Для цього ми використовуємо символ `!=`, як показано в прикладі вище.
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Цікаво чому ми використали два однакові знаки `==` щоб порівняти чи є рівними числа? Ми використовуємо `=` для присвоєння значень змінним. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. Ми також можемо перевіряти чи два об'єкта є нерівними. Для цього ми використовуємо символ `!=`, як показано в прикладі вище.
 
 Задайте для Python ще дві задачі:
 
-    >>> 6 >= 12 / 2
-    True
-    >>> 3 <= 2
-    False
+{% filename %}command-line{% endfilename %}
 
-щодо `>` та `<` - усе просто, але що означають `>=` і `<=`? Читайте їх як:
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
 
 - x `>` y означає x більше ніж y
 - x `<` y означає x менше ніж y
-- x `<=` y означає x менше або дорівнює y
-- x `>=` y означає x більше або дорівнює y
+- x `<=` y означає x менше або рівне y
+- x `>=` y означає x більше або рівне y
 
 Чудово! Хочете ще? Спробуйте це:
 
-    >>> 6 > 2 and 2 < 3
-    True
-    >>> 3 > 2 and 2 < 1
-    False
-    >>> 3 > 2 or 2 < 1
-    True
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
 
 Ви можете задавати для Python стільки чисел для порівння скільки заманеться, і він дасть вам результат! Дуже розумно, чи не так?
 
-- __and__ - якщо ви використовуєте оператор `and`, обидва порівнюваних значення мають бути істинними - True для того, щоб і уся команда була істинною - True
-- __or__ - якщо ви використовуєте оператор `or`, лише одне із порівнюваних значень мають бути істинними - True для того, щоб і уся команда була істинною - True
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
 
 Чи чули ви про вираз "порівняння яблук і апельсинів"? Давайте спробуємо Python еквівалент:
 
-    >>> 1 > 'django'
-    Traceback (most recent call last):
-      File "<stdin>", line 1, in <module>
-    TypeError: unorderable types: int() > str()
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
 
-Бачимо тут, що як і у виразі, Python не в змозі порівняти число (`int`) та рядок (`str`).
-Натомість, виводиться **TypeError** і повідомляє нас про те, що ці два типи не можна порівнювати між собою.
+Бачимо тут, що як і у виразі, Python не в змозі порівняти число (`int`) та рядок (`str`). Натомість, виводиться **TypeError** і повідомляє нас про те, що ці два типи не можна порівнювати між собою.
 
 ## Логічні типи
 
-Між іншим, ви щойно дізналися про новий типу об'єкту в Python. Він називається логічним - __Boolean__ - і, можливо, це найпростіший тип.
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
 
-Існує лише два логічних об'єкти:
-- Істинне: True
-- Хибне: False
+There are only two Boolean objects:
 
-Але для того, щоб Python міг це зрозуміти, треба завжди писати 'True' (перша літера - велика, а решта - маленькі). __true, TRUE, tRUE не працюють - лише True є правильним.__ (Те ж саме стосується і 'False' також.)
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
 
 Логічні значення також можуть бути змінними! Погляньте:
 
-    >>> a = True
-    >>> a
-    True
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
 
-Можна також зробити теж саме по-іншому:
+Можна також зробити теж саме по іншому:
 
-    >>> a = 2 > 5
-    >>> a
-    False
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
 
 Практикуйте із логічними типами спробувавши запустити наступні команди:
 
@@ -407,25 +582,33 @@
 - `True or 1 == 1`
 - `1 != 2`
 
-Вітання! Логічними типи - одна із найкрутіших властивостей програмування, і ви щойно освоїли, як їх застосовувати!
+Вітання! Логічні типи одна із найкрутіших властивостей програмування, і ви щойно освоїли, як їх застосовувати!
 
 # Збережіть!
 
-Досі ми писали увесь наш Python код в інтерпретаторі, що обмежує нас написанням лише одного рядка за раз. Зазвичай програми зберігаються у файлах і виконуються __інтерпретатором__ або __компілятором__ нашої мови програмування. Досі ми запускали наші програми одним рядком в Python __інтерпретаторі__. Для наступних задач нам знадобиться більше, ніж один рядок коду, отже, нам потрібно:
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+Поки ми писали весь наш python код в інтерпритаторі, що обмежує нас написанням лише одного рядка за раз. Зазвичай програми зберігаються у файли і виконуються **інтерпритатором** або **компілятором** нашої мови програмування. Досі ми запускали наші програми одним рядком в Python **інтерпретаторі**. Для наступних задач нам знадобиться більше, ніж один рядок коду, отже нам потрібно:
 
 - Закрити Python інтепретатор
-- Відкрити наш вибраний текстовий редактор
+- Відкрити наш текстовий редактор на вибір
 - Зберегти певний код в python файлі
 - Запустити його!
 
-Щоб вийти з Python інтерпретатора, яким ми користувалися до цього, просто наберіть функцію ```exit()```:
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
 
-    >>> exit()
-    $
+```python
+>>> exit()
+$
+```
 
 Ви повернетеся назад до командного рядка.
 
-Раніше ми вже обрали для себе редактор коду в розділі [редактор коду](../code_editor/README.md). А тепер ми маємо відкрити цей редактор і написати якийсь код в новому файлі:
+Раніше, ми вже обрали для себе редактор коду, в секції [редактор коду](../code_editor/README.md). А тепер ми маємо відкрити цей редактор і написати якийсь код в новому файлі:
+
+{% filename %}editor{% endfilename %}
 
 ```python
 print('Hello, Django girls!')
@@ -433,70 +616,129 @@ print('Hello, Django girls!')
 
 Очевидно, ви тепер є досить досвідченим Python програмістом, отже, можете написати у ваш код усе, що ви до цього часу вивчили.
 
-А тепер треба зберегти файл і дати йому описове ім'я. Назвімо файл **python_intro.py** і збережемо його на вашому робочому столі. Ви можете називати файл як завгодно, тільки важливо, щоб назва закінчувалась на __.py__. Закінчення __.py__ говорить нашій операційній системі, що це **виконуваний файл Python** і Python може його запускати.
+А тепер треба зберегти файл і дати йому описове ім'я. Назвімо файл **python_intro.py** і збережемо його на вашому робочому столі. Ви можете називати файл як завгодно, тільки важливо щоб назва закінчувалась на **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
 
-> **Примітка** Ви повинні помітити одну з найкрутіших фіч редакторів коду: кольори! У консолі Python все було одного кольору, тепер ви повинні побачити, що функція `print` має інший колір, ніж рядок, який вона друкує. Це називається "підсвіткою синтаксису", і це справді корисна функція для програміста. Різний колір слів дає вам підказку щодо правильності набору тексту чи орфографічної помилки (згодом зверніть увагу на колір слова `def` в тілі функції). Це одна з вагомих причин, чому ми використовуємо редактор коду :)
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. Це називається "підсвіткою синтаксису", і це справді корисна для програміста функція. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). Це одна з вагомих причин, чому ми використовуємо редактор коду. :)
 
+По тому як файл успішно збережено, час запустити його! Використовуючи навики отримані під час освоєння розділу, що стосувався командного рядка, скористайтеся терміналом, щоб **змінити директорію** на робочий стіл.
 
-По тому, як файл успішно збережено, час запустити його! Використовуючи навики отримані під час освоєння розділу, що стосувався командного рядка, скористайтеся терміналом, щоб **змінити директорію** на робочий стіл.
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
 
 Для Mac, команда буде виглядати так:
 
+{% filename %}command-line{% endfilename %}
+
     $ cd ~/Desktop
+    
 
-Для Linux, вона буде на зразок (слово "Desktop" може бути перекладене вашою мовою):
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
 
     $ cd ~/Desktop
+    
+
+<!--endsec-->
 
-І для Windows, це буде так:
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
 
     > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
 
-Якщо ви застрягли, просто попросіть допомоги.
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+Якщо ви застрягли, просто попросіть допомогти.
 
 Використовуйте Python, щоб виконати код у файлі, таким чином:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
 
 Гаразд! Ви щойно запустили вашу першу Python програму, яка була збережена у файлі. Чудові відчуття?
 
 Тепер ви можете переходити до важливого інструменту у програмуванні:
 
-## If...elif...else
+## If … elif … else
 
-Багато речей в програмі мають бути виконані лише тоді, коли виконуються задані умови. Саме тому Python має інструмент, що називається __умовою if - якщо__.
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
 
 Замініть код вашого файлу **python_intro.py** на наступне:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
 ```
 
-Якщо ми збережемо зміни і запустимо цей файл, то побачимо наступну помилку:
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     File "python_intro.py", line 2
              ^
     SyntaxError: unexpected EOF while parsing
+    
 
 Python очікує від нас подальших інструкцій, які повинні бути виконані, якщо умова `3 > 2` виявляється істинною (тобто `True`). Спробуємо змусити Python надрукувати “It works!”. Змініть код у файлі **python_intro.py** на наступне:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 if 3 > 2:
     print('It works!')
 ```
 
-Зауважили, яким чином ми зробили відступ в 4 пробіли для наступного рядка коду? Це необхідно робити для того, щоб Python знав, який шматок коду запускати, якщо результати умови істинні. Можна зробити відступ і в один пробіл, але майже усі Python програмісти роблять відступ у 4 пробіли, щоб було акуратніше. Один `tab` також рахується як 4 пробіли.
+Зауважили яким чином ми зробили відступ в 4 пробіли для наступного рядка коду? Це необхідно робити для того, щоб Python знав, який шматок коду запускати, якщо результати умови істинні. Можна зробити відступ і в один пробіл, але майже усі Python програмісти роблять відступ у 4 пробіли, щоб було акуратніше. Один `tab` також рахується як 4 пробіли.
 
 Збережіть і запустіть знову:
 
-    $ python3 python_intro.py
-    It works!
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
 
-### Що ж, якщо ні?
+### А що, коли умова не істинна?
 
-У попередніх прикладах код виконувався лише, коли умови були істинними - True. Однак, Python також має умови `elif` та `else`:
+У попередніх прикладах, код виконувався лише коли умови були істинними - True. Однак, Python також має умови `elif` та `else`:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 if 5 > 2:
@@ -507,10 +749,15 @@ else:
 
 Коли запустимо це, буде виведено:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     5 is indeed greater than 2
+    
 
-Якщо 2 було числом більшим за 5, то далі буде виконуватися друга команда. Просто, правда ж? Подивимося як працює `elif`:
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 name = 'Sonja'
@@ -524,12 +771,17 @@ else:
 
 і в результаті:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hey Sonja!
+    
 
-Бачите, що тут відбуваеться? `Elif` вказує додаткові умови для перевірки, якщо результат попередніх умов є невдалим.
+Бачите що тут відбуваеться? `elif` вказує додаткові умови для перевірки, якщо результат попередніх невдалий.
 
-Ви можете додати стільки виразів `elif`, скільки вам до вподоби одразу після виразу `if`. Наприклад:
+Ви можете додати стільки виразів `elif`, скільки вам до вподоби, одразу після виразу `if`. Наприклад:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 volume = 57
@@ -549,25 +801,50 @@ else:
 
 Python послідовно виконує всі перевірки та друкує:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
 
-### Підсумок
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
 
-В останніх трьох вправах ви освоїли такі поняття, як:
+### Зміст
 
-- __порівняння__ - в Python можна порівнювати елементи використовуючи `>`, `>=`, `==`, `<=`, `<` та оператори `and`, `or`
-- __Логічний тип - Boolean__ - тип об'єкту, що може дорівнювати лише одному з двох значень: `True`- Істинне або `False` - Хибне
-- __Збереження файлів__ - зберігання коду в файлах дозволяє виконувати більші програми.
-- __if...elif...else__ - умови, що дозволяють виконувати код лише коли виконуються певні умови.
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
 
 Час для останньої частини цього параграфу!
 
 ## Ваші власні функції!
 
-Пам'ятаєте функції на зразок `len()`, що можна виконувати в Python? Що ж, гарні новини - зараз ви дізнаєтесь, як писати свої власні функції!
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
 
-Функція - це набір інструкцій, які Python повинен виконати. Кожна функція в Python починається із ключового слова `def`, отримує ім'я і може містити певні параметри. Почнемо з простого. Перепишемо код в **python_intro.py** наступним чином:
+Функція - це набір інструкцій, які Python повинен виконати. Кожна функція в Python починається із ключового слова `def`, отримує ім'я і може містити певні параметри. Let's give it a go. Перепишемо код в **python_intro.py** наступним чином:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi():
@@ -579,15 +856,26 @@ hi()
 
 Окей, наша перша функція готова!
 
-Ви можете запитати, для чого ми написали ім'я функції наприкінці файлу. Це тому, що Python зчитує файл і виконує його згори донизу. Отже, для того, щоб скористатися нашою функцією, ми повинні написати її знову унизу.
+Ви можете запитати для чого ми написали ім'я функції наприкінці файлу. Це тому, що Python зчитує файл і виконує його згори донизу. Отже, для того, щоб скористатися нашою функцією, ми повинні написати її знову унизу.
+
+А тепер запустимо і подивимось що станеться:
 
-А тепер запустимо і подивимось, що станеться:
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hi there!
     How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
 
-Це було просто! Побудуємо нашу першу функцію з параметрами. Скористаємося попереднім прикладом - функцією, що говорить 'hi' особі, що її запускає - з іменем:
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi(name):
@@ -595,6 +883,8 @@ def hi(name):
 
 Як бачимо, зараз ми задали для нашої функції параметр, який назвали `name`:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
     if name == 'Ola':
@@ -609,15 +899,18 @@ hi()
 
 Пам'ятайте: функція `print` відділена відступами від команди `if` на чотири пробіли. Це тому, що функція запускається, коли виконується умова. Давайте подивимося, як це відбувається зараз:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Traceback (most recent call last):
     File "python_intro.py", line 10, in <module>
       hi()
     TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Ой, помилка. На щастя, Python надає нам дуже корисне повідомлення про помилку. Воно повідомляє нас про те, що функція `hi()` (та, яку ми визначили) має один необхідний аргумент (`name`) і що ми забули передати його коли здійснювали виклик функції. Виправимо це наприкінці файлу:
 
-Ой, помилка. На щастя, Python надає нам дуже корисне повідомлення про помилку.
-Воно повідомляє нас про те, що функція `hi()` (та, яку ми визначили) має один необхідний аргумент (`name`) і що ми забули передати його, коли здійснювали виклик функції.
-Виправимо це наприкінці файлу:
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 hi("Ola")
@@ -625,27 +918,40 @@ hi("Ola")
 
 І запустимо знову:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hi Ola!
+    
 
 А якщо ми змінимо ім'я?
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 hi("Sonja")
 ```
 
-Запустимо:
+Запустіть:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hi Sonja!
+    
 
-А тепер що ви думаєте про те, що станеться, якщо ми вкажемо тут інше ім'я? (Не Ola і не Sonja) Спробуємо і подивимося, чи ви маєте рацію. Маємо отримати на виході:
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
 
     Hi anonymous!
+    
+
+Чудово, чи не так? Таким чином вам не потрібно повторюватись кожного разу, коли ви захочете змінити ім'я особи, з якою має вітатися наша функція. And that's exactly why we need functions – you never want to repeat your code!
 
-Чудово, чи не так? Таким чином вам не потрібно повторюватись кожного разу, коли ви захочете змінити ім'я особи, з якою має вітатися наша функція. І саме тому нам потрібні функції - ви ж бо ніколи не хочете повторювати свій код!
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
 
-Виконаємо дещо складніші маніпуляції - існує безліч імен, набагато більше, ніж лише два, і написати умови для кожного з них буде досить складно, правда ж?
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 def hi(name):
@@ -656,33 +962,44 @@ hi("Rachel")
 
 А тепер виконаємо програму:
 
+{% filename %}command-line{% endfilename %}
+
     $ python3 python_intro.py
     Hi Rachel!
+    
 
-Вітаємо! Ви щойно розібралися з тим, як писати функції :)
+Вітаємо! Ви щойно розібралися з тим як писати функції! :)
 
 ## Цикли
 
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
 Це вже остання частина. Усе було швидко, чи не так? :)
 
 Програмісти не люблять повторюватись. Програмування - це процес автоматизації всього, тому ми не хочемо вітати кожну людину по імені вручну, правильно? Тут пригодяться цикли.
 
 Ще пам'ятаєте про списки? Давайте створимо список дівчат:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
 ```
 
-Ми б хотіли привітатися із кожною з них персонально. Щоб це зробити, у нас є функція `hi`, отже, використаємо її в циклі:
+Ми б хотіли привітатися із кожною з них персонально. Щоб це зробити у нас є функція `hi`, отже, використаємо її в циклі:
+
+{% filename %}python_intro.py{% endfilename %}
 
 ```python
 for name in girls:
 ```
 
-Вираз ```for``` поводиться подібно до виразу ```if```, а код, наведений нижче повинен мати відступи в чотири пробіли.
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
 
 Тут наведено повну версію коду у файлі:
 
+{% filename %}python_intro.py{% endfilename %}
+
 ```python
 def hi(name):
     print('Hi ' + name + '!')
@@ -693,7 +1010,9 @@ for name in girls:
     print('Next girl')
 ```
 
-А коли ми запустимо усе це:
+А коли ми зАпустимо усе це:
+
+{% filename %}command-line{% endfilename %}
 
     $ python3 python_intro.py
     Hi Rachel!
@@ -706,30 +1025,38 @@ for name in girls:
     Next girl
     Hi You!
     Next girl
+    
 
 Як бачимо, все, що міститься всередині виразу `for` із відступом буде повторюватися для кожного елементу зі списку `girls`.
 
 Також можна використовувати `for` для чисел, використовуючи функцію `range`:
 
-    for i in range(1, 6):
-        print(i)
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
 
 Що виведе на екран:
 
+{% filename %}command-line{% endfilename %}
+
     1
     2
     3
     4
     5
+    
 
 `range` - це функція, що створює список чисел, що йдуть одне за одним ці числа задаються вами як параметри).
 
-Зауважте, що друге з цих двох чисел, не входить до списку, що виводиться на екран Python (тобто `range(1, 6)` рахує від 1 до 5, але не включає число 6). Це тому, що "діапазон" є напіввідкритим, і під цим ми розуміємо, що він включає перше значення, але не останнє.
+Зауважте, що друге з цих двох чисел, не входить до списку, що виводиться на екран Python (тобто `range(1, 6)` рахує від 1 до 5, але не включає число 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
 
-## Підсумок
+## Зміст
 
-Ось і все. __Ви молодці!__ Це був складнуватий розділ, тому ви можете пишатися собою. Ми ж безумовно пишаємося вами, адже ви вже багато чого досягли!
+Ось і все. **Ви дали перцю!** Це був складнуватий розділ, тому ви можете пишатися собою. Ми ж безумовно пишаємося вами, адже ви вже багато чого досягли!
 
-Ви можете зробити коротку перерву - можливо потрібний відпочинок для ваших очей, розминка, невелика прогулянка, перш ніж перейдете до наступного розділу. :)
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
 
-![Cupcake](images/cupcake.png)
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/uk/signup_pythonanywhere.md b/uk/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/uk/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/uk/template_extending/README.md b/uk/template_extending/README.md
index eba12cb4d04..64b4d567dce 100755
--- a/uk/template_extending/README.md
+++ b/uk/template_extending/README.md
@@ -1,12 +1,12 @@
 # Розширення шаблону
 
-Інша хороша річ, яку має Django в своєму арсеналі - це __розширення шаблону__. Що це означає? Це значить, що ви можете використовувати одні й ті ж частини свого HTML коду для різних сторінок веб-сайту.
+Інша хороша річ, яку має Django в своєму арсеналі це **шаблонне розширення**. Що це означає? А це означає, що ви можете використовувати одні й ті ж частини свого HTML коду для різних сторінок веб сайту.
 
-Шаблони допомогають у випадку, коли ви хочете використати однакову інформацію/схему. Вам не потрібно повторюватись в кожному файлі. І якщо ви захочете щось змінити, то не доведеться це робити в кожному шаблоні, а лише один раз!
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
 
-## Створення базового шаблону
+## Create a base template
 
-Базовий шаблон - це основний шаблон, який ви будете розширювати для кожної сторінки вашого веб-сайту.
+Базовий шаблон - це основний шаблон, який ви будете розширювати для кожної сторінки вашого веб сайту.
 
 Створимо файл `base.html` в `blog/templates/blog/`:
 
@@ -15,9 +15,12 @@
         └───blog
                 base.html
                 post_list.html
+    
 
 Відкрийте його і скопіюйте усе з `post_list.html` до файлу `base.html`, як тут:
 
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
 ```html
 {% load staticfiles %}
 <html>
@@ -52,7 +55,9 @@
 </html>
 ```
 
-Далі для `base.html`, замініть ціле тіло `<body>` (все між `<body>` і `</body>`) цим:
+Далі для `base.html`, перепишіть усю частину для `<body>` (усе між `<body>` і `</body>`) на наступне:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 <body>
@@ -70,16 +75,20 @@
 </body>
 ```
 
-{% raw %}Зауважте, це замінило все, починаючи від `{% for post in posts %}` до `{% endfor %}`, цим: {% endraw %}
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
 
 ```html
 {% block content %}
 {% endblock %}
 ```
-Що це означає? Ви щойно створили блок `block`! Використали шаблонний тег `{% block %}` для того, щоб створити місце, в яке буде вставлено HTML. Цей HTML міститиметься в інших шаблонах, які розширюють цей шаблон (`base.html`). Скоро ми покажемо вам, як це зробити.
 
-А тепер збережіть зміни і відкрийте знову свій `blog/templates/blog/post_list.html`.
-{% raw %}Видаліть усе, що вище `{% for post in posts %}` і нижче `{% endfor %}`. Коли ви закінчите, файл виглядатиме так:{% endraw %}
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). Скоро ми покажемо вам як це зробити.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
 ```html
 {% for post in posts %}
@@ -93,13 +102,13 @@
 {% endfor %}
 ```
 
-Ми хочемо використати це як частина нашого шаблону для всіх блоків контенту.
-Час додати теги блоків до цього файлу!
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
 
-{% raw %}Ви хочете, щоб ваший тег блоку підходив до тегу у файлі `base.html`. Ви такоже хочете, щоб він включав в себе весь код, що належить вашим блокам з контентом. Щоб зробити це, розмістіть все між `{% block content %}` і `{% endblock %}`. Як тут: {% endraw %}
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Наступним чином:{% endraw %}
 
-```html
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
 
+```html
 {% block content %}
     {% for post in posts %}
         <div class="post">
@@ -112,7 +121,11 @@
     {% endfor %}
 {% endblock %}
 ```
-Залишився один момент. Нам потрібно поєднати ці два шаблони разом. Це і є розширенням шаблонів. Ми зробимо це додаванням на початок файлу тегу розширення. Як тут:
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
 ```html
 {% extends 'blog/base.html' %}
 
@@ -129,6 +142,6 @@
 {% endblock %}
 ```
 
-Ось і все! Перевірте, чи ваш сайт все ще коректно працює :)
+Ось і все! Перевірте чи ваш сайт все ще працює коректно. :)
 
-> Якщо з'явилася помилка `TemplateDoesNotExists`, то це говорить про те, що файлу `blog/base.html` не існує і ви маєте в консолі запущений `runserver`, спробуйте зупинити його (натиснувши Ctrl+C - кнопки Control і C buttons разом) і перезавантажити командою `python manage.py runserver`.
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/uk/whats_next/README.md b/uk/whats_next/README.md
index 349f6dc0008..2e7959cacb9 100755
--- a/uk/whats_next/README.md
+++ b/uk/whats_next/README.md
@@ -1,26 +1,25 @@
 # Що далі?
 
-Привітайте себе! __Ви абсолютно неймовірні.__ Ми пишаємося вами! <3
+Привітайте себе! **Ви абсолютно неймовірні**. Ми пишаємося вами! <3
 
 ### Що тепер робити?
 
-Перепочиньте і розслабтеся. Ви щойно створили щось дійсно велике.
+Перепочиньте і розслабтеся. Ви щойно створили дещо дійсно велике.
 
-Після цього переконайтеся, що ви:
-
-- Підписалися на Django Girls у [Facebook](http://facebook.com/djangogirls) або в [Twitter](https://twitter.com/djangogirls), щоб бути в курсі усіх подій
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
 
 ### Чи можете ви порекомендувати інші джерела?
 
-Так! Спершу, спробуйте нашу іншу книгу [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org).
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
 
-Пізніше, ви можете спробувати джерела, перелічені нижче. Дуже рекомендуємо!
-- [Django's official tutorial](https://docs.djangoproject.com/en/1.8/intro/tutorial01/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
 - [New Coder tutorials](http://newcoder.io/tutorials/)
 - [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
 - [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
 - [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
 - [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
 - [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
-- [Two Scoops of Django: Best Practices for Django 1.8 book](https://twoscoopspress.com/products/two-scoops-of-django-1-8)
-- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/ur-IN/GLOSSARY.md b/ur-IN/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/ur-IN/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/ur-IN/README.md b/ur-IN/README.md
new file mode 100644
index 00000000000..121da8f55bf
--- /dev/null
+++ b/ur-IN/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/ur-IN/SUMMARY.md b/ur-IN/SUMMARY.md
new file mode 100644
index 00000000000..d9741b4f21c
--- /dev/null
+++ b/ur-IN/SUMMARY.md
@@ -0,0 +1,35 @@
+# Summary
+
+* [Introduction](README.md)
+* [Installation](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Installation (chromebook)](chromebook_setup/README.md)
+* [How the Internet works](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Introduction to Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Your first Django project!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/ur-IN/chromebook_setup/README.md b/ur-IN/chromebook_setup/README.md
new file mode 100644
index 00000000000..03249a84d41
--- /dev/null
+++ b/ur-IN/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/ur-IN/chromebook_setup/instructions.md b/ur-IN/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..2df2048e6ec
--- /dev/null
+++ b/ur-IN/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, cloud IDE will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). You can choose one of the cloud IDEs, and follow the instruction of the cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Go to [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Sign up for an account
+3. Click *New Server* and choose the Django app
+4. Click Terminal button(on the left side of the window)
+
+Now you should see an interface with a sidebar, buttons at the left. Click "Terminal" button to open terminal window with prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/ur-IN/code_editor/README.md b/ur-IN/code_editor/README.md
new file mode 100644
index 00000000000..0a401fb1f52
--- /dev/null
+++ b/ur-IN/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/ur-IN/code_editor/instructions.md b/ur-IN/code_editor/instructions.md
new file mode 100644
index 00000000000..82fbac15aad
--- /dev/null
+++ b/ur-IN/code_editor/instructions.md
@@ -0,0 +1,37 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Visual Studio Code
+
+Visual Studio Code is a source code editor developed by Microsoft for Windows, Linux and macOS. It includes support for debugging, embedded Git control, syntax highlighting, intelligent code completion, snippets, and code refactoring.
+
+[Download it here](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is another popular editor. It's free, open-source and available for Windows, OS X and Linux. Atom is developed by [GitHub](https://github.com/).
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/ur-IN/css/README.md b/ur-IN/css/README.md
new file mode 100644
index 00000000000..5f99728790d
--- /dev/null
+++ b/ur-IN/css/README.md
@@ -0,0 +1,330 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/ur-IN/deploy/README.md b/ur-IN/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/ur-IN/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/ur-IN/deploy/install_git.md b/ur-IN/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/ur-IN/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ur-IN/deploy/signup_pythonanywhere.md b/ur-IN/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/ur-IN/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/ur-IN/django/README.md b/ur-IN/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/ur-IN/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/ur-IN/django_admin/README.md b/ur-IN/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/ur-IN/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/ur-IN/django_forms/README.md b/ur-IN/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/ur-IN/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ur-IN/django_installation/README.md b/ur-IN/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/ur-IN/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ur-IN/django_installation/instructions.md b/ur-IN/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/ur-IN/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/ur-IN/django_models/README.md b/ur-IN/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/ur-IN/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/ur-IN/django_orm/README.md b/ur-IN/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/ur-IN/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/ur-IN/django_start_project/README.md b/ur-IN/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/ur-IN/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/ur-IN/django_templates/README.md b/ur-IN/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/ur-IN/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/ur-IN/django_urls/README.md b/ur-IN/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/ur-IN/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/ur-IN/django_views/README.md b/ur-IN/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/ur-IN/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/ur-IN/dynamic_data_in_templates/README.md b/ur-IN/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/ur-IN/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/ur-IN/extend_your_application/README.md b/ur-IN/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/ur-IN/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/ur-IN/how_the_internet_works/README.md b/ur-IN/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/ur-IN/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/ur-IN/html/README.md b/ur-IN/html/README.md
new file mode 100644
index 00000000000..27c81ea68be
--- /dev/null
+++ b/ur-IN/html/README.md
@@ -0,0 +1,227 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/ur-IN/installation/README.md b/ur-IN/installation/README.md
new file mode 100644
index 00000000000..b97592acbe8
--- /dev/null
+++ b/ur-IN/installation/README.md
@@ -0,0 +1,68 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/ur-IN/intro_to_command_line/README.md b/ur-IN/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/ur-IN/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/ur-IN/intro_to_command_line/open_instructions.md b/ur-IN/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/ur-IN/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/ur-IN/python_installation/README.md b/ur-IN/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/ur-IN/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/ur-IN/python_installation/instructions.md b/ur-IN/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/ur-IN/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/ur-IN/python_introduction/README.md b/ur-IN/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/ur-IN/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/ur-IN/template_extending/README.md b/ur-IN/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/ur-IN/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/ur-IN/whats_next/README.md b/ur-IN/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/ur-IN/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/vi-VN/GLOSSARY.md b/vi-VN/GLOSSARY.md
new file mode 100644
index 00000000000..d94b9f02946
--- /dev/null
+++ b/vi-VN/GLOSSARY.md
@@ -0,0 +1,3 @@
+# mã biên tập
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/vi-VN/README.md b/vi-VN/README.md
new file mode 100644
index 00000000000..a371ac88e5f
--- /dev/null
+++ b/vi-VN/README.md
@@ -0,0 +1,51 @@
+# Hướng dẫn sử dụng Django
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Dự án này được cấp phép dưới chứng chỉ quốc tế: Creative Commons Attribution-ShareAlike 4.0. Để xem bản sao của chứng chỉ này, vui lòng ghé thăm website https://creativecommons.org/licenses/by-sa/4.0/
+
+## Xin chào mừng
+
+Chào mừng bạn đã đến với Django Girls Tutorial! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Giới thiệu
+
+Bạn đã bao giờ từng cảm thấy rằng thế giới đang càng ngày càng phát triển về công nghệ, người ta nói rất nhiều về công nghệ, mà bạn thấy mình không thể (hoặc chưa) tham gia vào không? Bạn đã từng tò mò về cách để làm một website, nhưng bạn chưa bao giờ có đủ động lực để bắt đầu? Bạn đã từng cho rằng thế giới phần mềm quá phức tạp để bạn có thể thử làm điều gì đó cho riêng mình phải không?
+
+Chà, chúng tôi có tin tốt cho bạn đây! Lập trình thực ra không khó như người ta vẫn nghĩ, và chúng tôi sẽ chứng minh cho bạn thấy nó thú vị như thế nào.
+
+Bài hướng dẫn này không phải là ma thuật để biến bạn thành một lập trình viên thực thụ. Nếu bạn muốn giỏi lập trình, bạn cần học và thực hành trong nhiều tháng, thậm chí nhiều năm. Nhưng chúng tôi muốn chỉ cho bạn thấy rằng lập trình hoặc tạo website không phức tạp như nó được thấy. Chúng tôi sẽ cố gắng hết sức giải thích từng chút từng chúng một, để bạn không bị quá tải.
+
+Chúng tôi hi vọng rằng chúng tôi sẽ đem lại cho bạn niềm yêu thích với công nghệ như chúng tôi đã và đang làm!
+
+## Bạn sẽ học được gì trong suốt bài hướng dẫn này?
+
+Sau khi bạn kết thúc khoá học, bạn sẽ có một ứng dụng web nho nhỏ: blog của riêng bạn. Chúng tôi sẽ hướng dẫn bạn đưa nó lên trực tuyến, để những bạn bè, người thân hoặc đồng nghiệp có thể nhìn thấy sản phẩm của bạn!
+
+Nó sẽ giống (hơn hoặc ít hơn) thế này:
+
+![Figure 0.1](images/application.png)
+
+> Nếu bạn tự làm theo bài hướng dẫn mà không có cố vấn để giúp bạn khi gặp vấn đề, chúng tôi có hệ thống chat dành cho bạn: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Chúng tôi sẽ hỏi các cố vấn và những người tham gia học trước đó để giúp đỡ những người khác đang học! Đừng ngại đặt câu hỏi nhé!
+
+Nào, [Chúng ta cùng bắt đầu...](./how_the_internet_works/README.md)
+
+## Theo dõi khoá học tại nhà
+
+Thật tuyệt nếu như được tham gia hội thảo Django Girl, nhưng chúng tôi hiểu rằng không phải ai cũng có thể. Đó là lý do vì sao chúng tôi khuyến khích bạn làm theo bài hướng dẫn này tại nhà. Cho những bạn đọc tại nhà, hiện tại chúng tôi đang chuẩn bị các video để các bạn có thể tự mình làm theo. Dự án đang trong quá trình ghi hình, nhưng mọi thứ sẽ sớm được phát sóng hết lên kênh Youtube [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed).
+
+Trong mỗi chương đã có trong bài hướng dẫn, sẽ có 1 đường dẫn với video tương ứng.
+
+## Giới thiệu và đóng góp
+
+Khoá học này được duy trì bởi [DjangoGirls](https://djangogirls.org/). Nếu bạn thấy bất kỳ lỗi nào hoặc bạn muốn cập nhật bài hướng dẫn, vui lòng làm theo [hướng dẫn](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Bạn muốn giúp chúng tôi dịch khoá học này sang ngôn ngữ khác?
+
+Hiện tại, các bản dịch được lưu giữ tại website crowndin.com theo đường dẫn sau:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Nếu ngôn ngữ của bạn chưa được liệt kê tại [crowdin](https://crowdin.com/), vui lòng [mở một vấn đề](https://github.com/DjangoGirls/tutorial/issues/new) để thông báo cho chúng tôi về ngôn ngữ bạn mong muốn và chúng tôi sẽ thêm vào.
\ No newline at end of file
diff --git a/vi-VN/SUMMARY.md b/vi-VN/SUMMARY.md
new file mode 100644
index 00000000000..e8937648631
--- /dev/null
+++ b/vi-VN/SUMMARY.md
@@ -0,0 +1,35 @@
+# Tóm tắt
+
+* [Giới thiệu](README.md)
+* [Cài đặt](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Cài đặt (chromebook)](chromebook_setup/README.md)
+* [Cách thức hoạt động của Internet](how_the_internet_works/README.md)
+* [Giới thiệu về dòng lệnh](intro_to_command_line/README.md)
+* [Cài đặt Python](python_installation/README.md)
+* [Trình biên tập code](code_editor/README.md)
+* [Giới thiệu về Python](python_introduction/README.md)
+* [Django là gì?](django/README.md)
+* [Cài đặt Django](django_installation/README.md)
+* [Dự án Django đầu tiên của bạn!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Quản trị Django](django_admin/README.md)
+* [Xuất bản Website!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views - Đến lúc khởi tạo rồi!](django_views/README.md)
+* [Giới thiệu về HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dữ liệu động trong các bản mẫu](dynamic_data_in_templates/README.md)
+* [Các bản mẫu Django](django_templates/README.md)
+* [CSS - làm đẹp cho website](css/README.md)
+* [Mở rộng bản mẫu](template_extending/README.md)
+* [Mở rộng ứng dụng của bạn](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [Điều gì tiếp theo?](whats_next/README.md)
\ No newline at end of file
diff --git a/vi-VN/chromebook_setup/README.md b/vi-VN/chromebook_setup/README.md
new file mode 100644
index 00000000000..c7ea170b8ff
--- /dev/null
+++ b/vi-VN/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Cài đặt cho Chromebook
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/vi-VN/chromebook_setup/instructions.md b/vi-VN/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..6ef8a70485d
--- /dev/null
+++ b/vi-VN/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+Bạn có thể [bỏ qua phần này](http://tutorial.djangogirls.org/en/installation/#install-python) nếu bạn không sử dụng Chromebook. Nếu có thì việc cài đặt của bạn có thể có một chút khác biệt. Bạn có thể bỏ qua phần còn lại của hướng dẫn cài đặt này.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE là một công cụ hỗ trợ viết code và giúp bạn truy cập vào máy tính đang chạy trên Internet, nơi mà bạn có thể cài đặt, viết và chạy chương trình trên đó. Trong suốt bài hướng dẫn này, cloud IDE sẽ hoạt động như *local machine*. Bạn vẫn sẽ chạy lệnh trên terminal như trên OS X, Ubuntu, hay Windows, chỉ khác là terminal của bạn được kết nối với một máy tính đang nằm trên cloud của IDE và đã được cloud IDE sắp xếp cho bạn. running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that cloud IDE sets up for you. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Bạn có thể chọn 1 trong số các IDE này, hướng dẫn như sau.
+
+#### PaizaCloud Cloud IDE
+
+1. Nhấn [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Đăng ký một account
+3. Nhấn *New Server* và chọn ứng dụng Django
+4. Click vào nút Terminal ( nằm bên trái cửa sổ)
+
+Bây giờ bạn sẽ thấy giao diện với cây thư mục mà menu nút ở phía bên trái. Chọn "Terminal" để mở cửa sổ terminal
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+Terminal trên PaizaCloud Cloud IDE được chuẩn bị cho sự hướng dẫn của bạn. Bạn có thể thay đổi kích thước của sổ đó để làm nó to hơn.
+
+#### AWS Cloud9
+
+Hiện tại, Cloud 9 yêu cầu đăng ký với AWS và nhập thông tin thẻ tín dụng
+
+1. Cài đặt Cloud 9 từ [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Tới trang [c9.io](https://c9.io) và chọn *Get started with AWS Cloud9*
+3. Đăng ký 1 tài khoản AWS (Yêu cầu thông tin thẻ tín dụng, nhưng bạn có thể sử dụng miễn phí)
+4. Tại trang Dashboard của AWS, nhập *Cloud9* vào thanh tìm kiếm và chọn
+5. Tại trang dashboard của Cloud 9, chọn *Create environment*
+6. Đặt tên là *django-girls*
+7. Trong khi thiết lập cài đặt, chọn *Create a new instance for environment (EC2)* cho "Environment Type" và *t2.micro* cho "Instance type" (được mô tả là "Free-tier eligible."). Cost-saving setting và các phần khác có thể để mặc định
+8. Chọn *Next step*
+9. Chọn *Create environment*
+
+Bây giờ bạn sẽ thấy một giao diện với một sidebar, một cửa sổ chính lớn với một số văn bản, và một cửa sổ nhỏ ở phía dưới trông giống như thế này:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername: ~ / workspace $
+    
+
+Phần dưới là terminal của bạn. Bạn có thể sử dụng terminal để gửi chỉ dẫn tới máy tính remote Cloud 9. Bạn có thể thay đổi kích thước để làm nó lớn hơn.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Môi trường ảo (Virtual Environment)
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/vi-VN/code_editor/README.md b/vi-VN/code_editor/README.md
new file mode 100644
index 00000000000..3c92d6bc2b5
--- /dev/null
+++ b/vi-VN/code_editor/README.md
@@ -0,0 +1,11 @@
+# Trình biên tập code
+
+> Dành cho các bạn đọc ở nhà: Chương này sẽ được trình bày ở video về [ Cách cài đặt trình viết code ](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+Bạn sắp viết những dòng code đầu tiên rồi, vậy hãy dành thời gian để tải trình viết code về nào!
+
+> **Chú ý:** Nếu bạn đang sử dụng Chromebook, hãy bỏ qua phần này và đảm bảo rằng bạn làm theo hướng dẫn ở phần [Chromebook Setup](../chromebook_setup/README.md). IDE trên mây (PaizaCloud Cloud IDE hoặc AWS Cloud9) có bao gồm trình sửa code, khi bạn mở file trong IDE từ menu File, trình sửa code sẽ tự động được sử dụng.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/vi-VN/code_editor/instructions.md b/vi-VN/code_editor/instructions.md
new file mode 100644
index 00000000000..dedf40dd1cb
--- /dev/null
+++ b/vi-VN/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Có rất nhiều chương trình viết code khác nhau, phần lớn thì nó tuỳ thuộc vào sở thích của mỗi người. Hầu hết các nhà lập trình Python sử dụng IDEs (viết tắt của Integrated Development Environments - Môi trường phát triển tích hợp) phức tạp và mạnh mẽ như PyCharm. Tuy nhiên với những người mới bắt đầu thì các chương trình như vậy thực sự chưa cần thiết. Chúng tôi khuyến nghị các trình viết code khác cũng mạnh mẽ không kém và dễ sử dụng hơn.
+
+Dưới đây là gợi ý của chúng tôi, nhưng bạn cũng có thể tham khảo và nhờ tư vấn từ thầy/cô giáo của bạn để lựa chọn trình viết code phù hợp cho mình.
+
+## Visual Studio Code
+
+Visual Studio Codetrình viết code phát triển bởi Microsoft cho Windows, Linux vàmacOS. Nó hỗ trợ việc debugging, đính kèm việc điều khiển Git, đánh dấu cú pháp, hoàn thiệc code thông minh, snippets, và tái cấu trúc code.
+
+[Tải xuống tại đây](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit là trình viết code mã nguồn mở, miễn phí và có thể hoạt động được ở tất cả các hệ điều hành.
+
+[Tải ở đây](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text là một trình viết code khá phổ biến, bạn được dùng thử miễn phí một thời gian ngắn, và sau đó phải trả phí. Có thể chạy được trên mọi hệ điều hành.
+
+[Tải xuống tại đây](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom là một trình viết code mã nguồn mở phổ biến khác. Nó miễn phí và hoạt động trên Windows, OS X và Linux. Atom được phát triển bởi GitHub.
+
+[Tải xuống tại đây](https://atom.io/)
+
+## Vì sao chúng ta cài đặt trình viết code?
+
+Bạn có thể băn khoăn là tại sao chúng ta lại phải cài đặt những chương trình viết code kể trên, thay vì sử dụng Microsoft Word hay Notepad.
+
+Lý do đầu tiên là các đoạn code cần được viết dưới **dạng văn bản thuần tuý**, vấn đề với các chương trình như Word hay Textedit là chúng không thực sự xuất ra văn bản thuần tuý (plain text), thay vào đó là văn bản phong phú (với các phông chữ và định dạng khác nhau) ví dụ như [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format)..
+
+Lý do thứ hai là các trình viết code được thiết kế riêng cho việc viết code, vì thế chúng cung cấp các chức năng hữu ích như làm nổi bật code theo từng ý nghĩa bằng các màu sắc khác nhau, hoặc tự động đóng các dấu ngoặc cho bạn.
+
+Chúng ta sẽ thấy điều này khi bắt tay vào code. Sớm thôi, bạn sẽ nhận ra chúng hữu ích như thế nào. :)
\ No newline at end of file
diff --git a/vi-VN/css/README.md b/vi-VN/css/README.md
new file mode 100644
index 00000000000..b5d58325115
--- /dev/null
+++ b/vi-VN/css/README.md
@@ -0,0 +1,330 @@
+# CSS - Làm đẹp nào!
+
+Blog của chúng ta trông có vẻ chưa được đẹp lắm phải không? Chúng ta sẽ sử dụng CSS để làm cho nó đẹp và lộng lẫy hơn nhé.
+
+## CSS là gì?
+
+CSS viết tắt của Cascading Style Sheets, là một ngôn ngữ được sử dụng để mô tả và định dạng website của chúng ta sau khi viết bằng HTML trông sẽ như thế nào. Hãy coi nó như việc bạn đang make-up cho trang web của mình vậy
+
+Nhưng chúng ta không muốn viết lại từ đầu. Một lần nữa, chúng ta sẽ sử dụng những thứ mà các lập trình viên khác đã viết trên Internet và cho chúng ta dùng miễn phí. Bạn biết đấy, chẳng ai lại đi sáng chế lại chiếc bánh xe cho vui cả.
+
+## Sử dụng Bootstrap!
+
+Bootstrap là một trong những framework HTML và CSS phổ biến dành cho việc phát triển website nhanh và đẹp. Đây là website của bootstrap: https://getbootstrap.com/
+
+Thuở đầu, nó được viết bởi một lập trình viên làm việc tại Twitter. Ngày nay, nó được phát triển bởi các tình nguyện viên trên toàn thế giới!
+
+## Cài đặt Bootstrap
+
+Để cài đặt Bootstrap, mở file `.html` trong trình biên tập code và thêm những dòng sau vào `<head>` :
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Việc này không thêm file vào bộ code của bạn mà trỏ đến các file đang tồn tại trên internet. Nên cứ mạnh dạn thêm vào code của bạn và tải lại trang. Xem có gì nào!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Trông cũng được đấy chứ!
+
+## Các thành phần cố định (Static) trong Django
+
+Cuối cùng, chúng ta sẽ tiến lại gần hơn với những thứ chúng ta vừa gọi là **static files**. Static files là toàn bộ mã CSS của bạn và các hình ảnh. Nội dung của chúng không phụ thuộc vào ngữ cảnh của yêu cầu và sẽ trở nên giống nhau với mọi người dùng. 
+
+### Nơi đặt các các static files trong Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our headers? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/vi-VN/deploy/README.md b/vi-VN/deploy/README.md
new file mode 100644
index 00000000000..cc2d165200c
--- /dev/null
+++ b/vi-VN/deploy/README.md
@@ -0,0 +1,246 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/vi-VN/deploy/install_git.md b/vi-VN/deploy/install_git.md
new file mode 100644
index 00000000000..53fbe28d617
--- /dev/null
+++ b/vi-VN/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/vi-VN/deploy/signup_pythonanywhere.md b/vi-VN/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..555e36731dd
--- /dev/null
+++ b/vi-VN/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere is a service for running Python code on servers "in the cloud". We'll use it for hosting our site, live and on the Internet.
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## Creating a PythonAnywhere API token
+
+This is something you only need to do once. When you've signed up for PythonAnywhere, you'll be taken to your dashboard. Find the link near the top right to your "Account" page:
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/vi-VN/django/README.md b/vi-VN/django/README.md
new file mode 100644
index 00000000000..0f2c4ef30f6
--- /dev/null
+++ b/vi-VN/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/vi-VN/django_admin/README.md b/vi-VN/django_admin/README.md
new file mode 100644
index 00000000000..156eae05654
--- /dev/null
+++ b/vi-VN/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/vi-VN/django_forms/README.md b/vi-VN/django_forms/README.md
new file mode 100644
index 00000000000..68676f99fa5
--- /dev/null
+++ b/vi-VN/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it in the code editor and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Security
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/vi-VN/django_installation/README.md b/vi-VN/django_installation/README.md
new file mode 100644
index 00000000000..9b024008342
--- /dev/null
+++ b/vi-VN/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/vi-VN/django_installation/instructions.md b/vi-VN/django_installation/instructions.md
new file mode 100644
index 00000000000..fc965146844
--- /dev/null
+++ b/vi-VN/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/vi-VN/django_models/README.md b/vi-VN/django_models/README.md
new file mode 100644
index 00000000000..f2a68a8727f
--- /dev/null
+++ b/vi-VN/django_models/README.md
@@ -0,0 +1,201 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/vi-VN/django_orm/README.md b/vi-VN/django_orm/README.md
new file mode 100644
index 00000000000..ffe309bd81e
--- /dev/null
+++ b/vi-VN/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/vi-VN/django_start_project/README.md b/vi-VN/django_start_project/README.md
new file mode 100644
index 00000000000..3767c62e17f
--- /dev/null
+++ b/vi-VN/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/vi-VN/django_templates/README.md b/vi-VN/django_templates/README.md
new file mode 100644
index 00000000000..db2d20c4d4e
--- /dev/null
+++ b/vi-VN/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/vi-VN/django_urls/README.md b/vi-VN/django_urls/README.md
new file mode 100644
index 00000000000..d37a5e3c2fd
--- /dev/null
+++ b/vi-VN/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/vi-VN/django_views/README.md b/vi-VN/django_views/README.md
new file mode 100644
index 00000000000..ab271e0914f
--- /dev/null
+++ b/vi-VN/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/vi-VN/dynamic_data_in_templates/README.md b/vi-VN/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..5a6ef017adf
--- /dev/null
+++ b/vi-VN/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/vi-VN/extend_your_application/README.md b/vi-VN/extend_your_application/README.md
new file mode 100644
index 00000000000..c70a2db97ff
--- /dev/null
+++ b/vi-VN/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/vi-VN/how_the_internet_works/README.md b/vi-VN/how_the_internet_works/README.md
new file mode 100644
index 00000000000..7b2c014c292
--- /dev/null
+++ b/vi-VN/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/vi-VN/html/README.md b/vi-VN/html/README.md
new file mode 100644
index 00000000000..ceff6a8c6a8
--- /dev/null
+++ b/vi-VN/html/README.md
@@ -0,0 +1,227 @@
+# Giới thiệu về HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to GitHub
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/vi-VN/installation/README.md b/vi-VN/installation/README.md
new file mode 100644
index 00000000000..c2daa1e34ab
--- /dev/null
+++ b/vi-VN/installation/README.md
@@ -0,0 +1,68 @@
+# Nếu bạn làm theo hướng dẩn tại nhà
+
+Nếu bạn làm theo hướng dẩn tại nhà mà không phải ở [Sự kiện Django Girls](https://djangogirls.org/events/), bạn hoàn toàn có thể bỏ qua chương này và qua chương [Internet hoạt động như thế nào](../how_the_internet_works/README.md).
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/vi-VN/intro_to_command_line/README.md b/vi-VN/intro_to_command_line/README.md
new file mode 100644
index 00000000000..b95191c95c8
--- /dev/null
+++ b/vi-VN/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                            |
+| ----------------- | ------------------------ | -------------------------- | -------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                           |
+| cd                | cd                       | change directory           | **cd test**                                        |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir               | ls                       | list directories/files     | **dir**                                            |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                            |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?          | man [CMD]                | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/vi-VN/intro_to_command_line/open_instructions.md b/vi-VN/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/vi-VN/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/vi-VN/python_installation/README.md b/vi-VN/python_installation/README.md
new file mode 100644
index 00000000000..8470b71f1f4
--- /dev/null
+++ b/vi-VN/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/vi-VN/python_installation/instructions.md b/vi-VN/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/vi-VN/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/vi-VN/python_introduction/README.md b/vi-VN/python_introduction/README.md
new file mode 100644
index 00000000000..6b66f8b55c6
--- /dev/null
+++ b/vi-VN/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/vi-VN/template_extending/README.md b/vi-VN/template_extending/README.md
new file mode 100644
index 00000000000..7f3697b7fd4
--- /dev/null
+++ b/vi-VN/template_extending/README.md
@@ -0,0 +1,151 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/vi-VN/whats_next/README.md b/vi-VN/whats_next/README.md
new file mode 100644
index 00000000000..97c41870d93
--- /dev/null
+++ b/vi-VN/whats_next/README.md
@@ -0,0 +1,43 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/vi/GLOSSARY.md b/vi/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/vi/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/vi/README.md b/vi/README.md
new file mode 100644
index 00000000000..4d5d7a11b5f
--- /dev/null
+++ b/vi/README.md
@@ -0,0 +1,51 @@
+# Hướng dẫn sử dụng Django
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/vi/SUMMARY.md b/vi/SUMMARY.md
new file mode 100644
index 00000000000..e91c2ccaed6
--- /dev/null
+++ b/vi/SUMMARY.md
@@ -0,0 +1,27 @@
+# Tóm tắt
+
+* [Giới thiệu](README.md)
+* [Cài đặt](installation/README.md)
+* [Cài đặt (chromebook)](chromebook_setup/README.md)
+* [Cách thức hoạt động của Internet](how_the_internet_works/README.md)
+* [Giới thiệu về dòng lệnh](intro_to_command_line/README.md)
+* [Cài đặt Python](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Giới thiệu về Python](python_introduction/README.md)
+* [Django là gì?](django/README.md)
+* [Cài đặt Django](django_installation/README.md)
+* [Dự án Django đầu tiên của bạn!](django_start_project/README.md)
+* [Django models](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Giới thiệu về HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS – make it pretty](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [What's next?](whats_next/README.md)
\ No newline at end of file
diff --git a/vi/chromebook_setup/README.md b/vi/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/vi/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/vi/chromebook_setup/instructions.md b/vi/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/vi/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/vi/code_editor/README.md b/vi/code_editor/README.md
new file mode 100644
index 00000000000..404011f1b7d
--- /dev/null
+++ b/vi/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/vi/code_editor/instructions.md b/vi/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/vi/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/vi/css/README.md b/vi/css/README.md
new file mode 100644
index 00000000000..04d5996ae52
--- /dev/null
+++ b/vi/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/vi/deploy/README.md b/vi/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/vi/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/vi/deploy/install_git.md b/vi/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/vi/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/vi/deploy/signup_pythonanywhere.md b/vi/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/vi/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/vi/django/README.md b/vi/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/vi/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/vi/django_admin/README.md b/vi/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/vi/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/vi/django_forms/README.md b/vi/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/vi/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/vi/django_installation/README.md b/vi/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/vi/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/vi/django_installation/instructions.md b/vi/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/vi/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/vi/django_models/README.md b/vi/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/vi/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/vi/django_orm/README.md b/vi/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/vi/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/vi/django_start_project/README.md b/vi/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/vi/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/vi/django_templates/README.md b/vi/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/vi/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/vi/django_urls/README.md b/vi/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/vi/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/vi/django_views/README.md b/vi/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/vi/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/vi/dynamic_data_in_templates/README.md b/vi/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/vi/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/vi/extend_your_application/README.md b/vi/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/vi/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/vi/how_the_internet_works/README.md b/vi/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/vi/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/vi/html/README.md b/vi/html/README.md
new file mode 100644
index 00000000000..a80df50451a
--- /dev/null
+++ b/vi/html/README.md
@@ -0,0 +1,213 @@
+# Giới thiệu về HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/vi/install_git.md b/vi/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/vi/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/vi/installation/README.md b/vi/installation/README.md
new file mode 100644
index 00000000000..10792271521
--- /dev/null
+++ b/vi/installation/README.md
@@ -0,0 +1,58 @@
+# Nếu bạn làm theo hướng dẩn tại nhà
+
+Nếu bạn làm theo hướng dẩn tại nhà mà không phải ở [Sự kiện Django Girls](https://djangogirls.org/events/), bạn hoàn toàn có thể bỏ qua chương này và qua chương [Internet hoạt động như thế nào](../how_the_internet_works/README.md).
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/vi/instructions.md b/vi/instructions.md
new file mode 100644
index 00000000000..b5a0981698b
--- /dev/null
+++ b/vi/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period. It's easy to install and use, and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source, easy to install and easy to use. It's available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/vi/intro_to_command_line/README.md b/vi/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/vi/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/vi/python_installation/README.md b/vi/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/vi/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/vi/python_installation/instructions.md b/vi/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/vi/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/vi/python_introduction/README.md b/vi/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/vi/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/vi/signup_pythonanywhere.md b/vi/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/vi/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/vi/template_extending/README.md b/vi/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/vi/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/vi/whats_next/README.md b/vi/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/vi/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/yo-NG/GLOSSARY.md b/yo-NG/GLOSSARY.md
new file mode 100644
index 00000000000..d2cc295dcc8
--- /dev/null
+++ b/yo-NG/GLOSSARY.md
@@ -0,0 +1,3 @@
+# olóòtú kóòdù
+
+Olóòtú kóòdù jẹ́ ètò kan tí yíò fún ọ láyè láti tọ́jú kóòdù rẹ kí o baà lè padà síi tó bá yá. O lè kẹ́kọ̀ọ́ nípa ibi to ti le rí ẹyọkan gbà nínú [Àkòrí olóòtú kóòdù](./code_editor/README.md)
\ No newline at end of file
diff --git a/yo-NG/README.md b/yo-NG/README.md
new file mode 100644
index 00000000000..ac65dea0329
--- /dev/null
+++ b/yo-NG/README.md
@@ -0,0 +1,51 @@
+# Àlàyé Django Girls
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Iṣẹ́ yìí gba ìwé-àṣẹ lábẹ́ Creative Commons Attribution-ShareAlike 4.0 International License. Láti wo ẹ̀dà kan ti ìwé-àṣẹ yìí, ṣèbẹ̀wò https://creativecommons.org/licenses/by-sa/4.0/
+
+## Káàbọ̀
+
+Káàbọ̀ sí Àlàyé Django Girls náà! We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## Ìfihàn
+
+Ṣé ó ti ṣe ẹ́ rí bíi pé ayé kún púpọ̀ fún ìmọ̀ ẹ̀rọ èyí tí ìwọ kò (tíì) lè ṣiṣẹ́ pẹ̀lú? Ṣé o ti ronú nípa bí o ṣe lè ṣẹ̀dá ààyè ayélujára kan sùgbọ́n kò tíì ní ìwúrí tó pọ̀ tó láti bẹ̀rẹ̀? Ṣé o ti ronú rí wípé ayé ètò kọ̀mpútà ṣòro púpọ̀ fún ẹ kódà láti gbìyànjú ṣíṣe nnkan kan fúnra rẹ?
+
+Ó dáa, a ní ìròyìn rere fún ẹ! Kóòdù kíkọ kò nira tó bóo ṣe rò àti pé a fẹ́ fi hàn ọ́ bí ó ṣe lè dùn tó.
+
+Àlàyé yìí kò ní sọ ọ́ di onímọ̀ nípa kóòdù kan lẹ́sẹ̀kẹsẹ̀. Tí o bá fẹ́ mọ dáadáa, o nílò àwọn oṣù tàbí kódà àwọn ọdún fún kíkẹ́kọ̀ọ́ àti lílò rẹ̀. Ṣùgbọ́n a fẹ́ fi hàn ọ́ pé kóòdù kíkọ tàbí ṣíṣẹ̀dá àwọn ààyè ayélujára kò ṣòro tó bóo ṣe rò. A ó gbìyànjú láti ṣàlàyé oríṣiríṣi àwọn nnkan níwọ̀nba bí a bá ṣe lè ṣeé tó, kí o lè bà máa bẹ̀rù nípa ìmọ̀-ẹ̀rọ.
+
+A lérò pé a ó lè mú ẹ nífẹ̀ẹ́ sí ìmọ̀-ẹ̀rọ gẹ́gẹ́ bí a ṣe nífẹ̀ẹ́ si!
+
+## Kí lo máa rí kọ́ lásìkò àlàyé náà?
+
+Tó o bá ti parí àlàyé náà, ìwọ yóò ní ètò ayélujára kékeré kan tó n ṣiṣẹ́: blog tìẹ. A óò sì fi hàn ọ́ bí o ṣe lè gbe sórí íńtánẹ́ẹ̀tì, kí àwọn ẹlòmíràn lè rí iṣẹ́ rẹ!
+
+Yóò (fẹ́rẹ̀ẹ́) rí báyìí:
+
+![Figure 0.1](images/application.png)
+
+> Tí o bá ṣiṣẹ́ pẹ̀lú àlàyé náà fúnra rẹ láìní olùkọ́ kan tí yíò ràn ọ́ lọ́wọ́ lórí èyíkéyìí ìṣòro, a ní ètò ìfọ̀rọ̀wérọ̀ kan fún ẹ: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). A béèrè lọ́wọ́ àwọn olùkọ́ wa àti àwọn tó ti wá sí àpéjọ tẹ́lẹ̀ láti wà níbẹ̀ lẹ́ẹ̀kọ̀ọ̀kan àti ran àwọn ẹlòmíràn lọ́wọ́ pẹ̀lú àlàyé náà! Má bẹ̀rù láti béèrè ìbéèrè rẹ níbẹ̀!
+
+Ó dáa, [ẹ jẹ́ ká bẹ̀rẹ̀ láti ìbẹ̀rẹ̀ náà…](./how_the_internet_works/README.md)
+
+## Títẹ̀lé àlàyé náà nílé
+
+Ó má n dára láti kópa nínú àpérò Django Girls kan, ṣùgbọ́n a mọ̀ pé kò ṣeéṣe ní gbogbo ìgbà láti wá síbẹ̀. Ìdí nìyí tí a fi gbà ọ́ níyànjú láti gbìyànjú títẹ̀lé àlàyé yìí nílé. Fún àwọn tó ń ka nílé, a n ṣètò àwọn fídíò lọ́wọ́lọ́wọ́ tí yíò mu kí ó rọrùn láti tẹ̀lé àlàyé náà fúnra rẹ. Ó ṣì jẹ́ iṣẹ́ kan ti ń lọ lọ́wọ́, ṣùgbọ́n ọ̀pọ̀lọpọ̀ nnkan ni a ó máa ṣàlàyé láìpẹ́ ní ìkànnì [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) lórí YouTube.
+
+Nínú gbogbo àkòrí tí a ti ṣàlàyé tẹ́lẹ̀, atọ́ka kan wà tó n tọ́ka sí fídíò tó yẹ.
+
+## Nípa àti dídásí
+
+Àlàyé yìí ní àbójútó nípasẹ̀ [DjangoGirls](https://djangogirls.org/). Tí o bá rí àṣìṣe kankan tàbí fẹ́ ṣe ìmúdójúìwọ̀n àlàyé náà, jọ̀wọ́ [tẹ̀lé àwọn ìlànà dídásí náà](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Ṣó o fẹ́ ràn wá lọ́wọ́ láti túmọ̀ àlàyé náà sí àwọn èdè mìíràn?
+
+Lọ́wọ́lọ́wọ́, a ń fi àwọn ìtumọ̀ pamọ́ sórí ètò crowdin.com ní:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Tí èdè rẹ kò bá sí lórí [crowdin](https://crowdin.com/), jọ̀wọ́ [ṣí ìbéèrè tuntun kan](https://github.com/DjangoGirls/tutorial/issues/new) láti sọ fún wa nípa èdè naa kí a lè ṣàfikún rẹ̀.
\ No newline at end of file
diff --git a/yo-NG/SUMMARY.md b/yo-NG/SUMMARY.md
new file mode 100644
index 00000000000..34b77961b79
--- /dev/null
+++ b/yo-NG/SUMMARY.md
@@ -0,0 +1,35 @@
+# Kókó pàtàkì
+
+* [Ìfihàn](README.md)
+* [Ìṣàgbékalẹ̀](installation/README.md) 
+  * [Command Line](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Code Editor](installation/README.md#code-editor)
+  * [Virtual Environment](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [Ìṣàgbékalẹ̀ (chromebook)](chromebook_setup/README.md)
+* [Bí íńtánẹ́ẹ̀tì ṣé n ṣiṣẹ́](how_the_internet_works/README.md)
+* [Ìfihàn sí ìlà ìpàṣẹ (command line)](intro_to_command_line/README.md)
+* [Ìṣàgbékalẹ̀ Python](python_installation/README.md)
+* [Olóòtú kóòdù](code_editor/README.md)
+* [Ìfihàn sí Python](python_introduction/README.md)
+* [Kíni Django?](django/README.md)
+* [Ìṣàgbékalẹ̀ Django](django_installation/README.md)
+* [Iṣẹ́ Django àkọ́kọ́ rẹ!](django_start_project/README.md)
+* [Àwọn àwòṣe Django](django_models/README.md)
+* [Alábòójútó Django](django_admin/README.md)
+* [Ṣàgbékalẹ̀!](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Àwọn view ti Django – àkókò láti ṣẹ̀dá!](django_views/README.md)
+* [Ìfihàn sí HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Àwọn dátà tó n ṣiṣẹ́ nínú àwọn àwòṣe (template)](dynamic_data_in_templates/README.md)
+* [Àwọn àwòṣe (template) Django](django_templates/README.md)
+* [CSS – mú kí ó rẹwà](css/README.md)
+* [Mímú kí àwòṣe (template) gbòòrò síi](template_extending/README.md)
+* [Mú ètò rẹ gbòòrò síi](extend_your_application/README.md)
+* [Àwọn fọ́ọ̀mù Django](django_forms/README.md)
+* [Kí ló kàn?](whats_next/README.md)
\ No newline at end of file
diff --git a/yo-NG/chromebook_setup/README.md b/yo-NG/chromebook_setup/README.md
new file mode 100644
index 00000000000..dd694bbcf5f
--- /dev/null
+++ b/yo-NG/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Àgbékalẹ̀-ètò Chromebook
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/yo-NG/chromebook_setup/instructions.md b/yo-NG/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..c6ee72e5ea3
--- /dev/null
+++ b/yo-NG/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+O lè [fo abala yìí kọjá](http://tutorial.djangogirls.org/en/installation/#install-python) tí ìwọ kò bá lo Chromebook kan. Tí o bá n lo, ìrírí ìṣàgbékalẹ̀ rẹ yíò yàtọ̀ díẹ̀. O lè fojú fo àwọn ìtọ́sọ́nà ìṣàgbékalẹ̀ yòókù náà.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud IDE jẹ́ irinṣẹ́ kan èyí tí yíò fún ẹ ní olóòtú kóòdù kan àti anfààní sí kọ̀mpútà kan tó n ṣiṣẹ́ lórí íntánẹ́ẹ̀tì níbi tí o ti lè ṣàgbékalẹ̀, kọ, àti mú ètò náà ṣiṣẹ́. Fún àkókò ti àlàyé náà, cloud IDE yíò ṣiṣẹ́ gẹ́gẹ́ bí *kọ̀mpútà agbègbè* rẹ. Yóò ṣeéṣe fún ẹ láti ma ṣiṣẹ́ pẹ̀lú àwọn àṣẹ nínú atọ́kùn èbúté kan gẹ́gẹ́ bí àwọn ọmọ kíláàsì rẹ lórí OS X, Ubuntu, tàbí Windows, ṣùgbọ́n èbúté rẹ yíò gba ìsopọ̀ mọ́ kọ̀mpútà kan tó n ṣiṣẹ́ ní ibòmíràn tí cloud IDE gbé kalẹ̀ fún ẹ. Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). O lè yan ẹyọkan nínú àwọn cloud IDE náà, kí o sì tẹ̀lé ìtọ́sọ́nà ti cloud IDE náà.
+
+#### PaizaCloud Cloud IDE
+
+1. Lọ sí [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Forúkọ sílẹ̀ fún account kan
+3. Click *New Server* and choose the Django app
+4. Tẹ bọ́tìnnì Terminal (ní apá òsì ti fèrèsé náà)
+
+Ní báyìí ó yẹ ko rí atọ́kùn kan pẹ̀lú pẹpẹ-ẹ̀gbẹ́ kan, àwọn bọ́tìnnì ní apá òsì náà. Tẹ bọ́tìnnì "Terminal" láti ṣí fèrèsé èbúté pẹ̀lú ìṣítí bíi èyí:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+Èbúté náà lórí PaizaCloud Cloud IDE ti ṣetán fún àwọn àṣẹ rẹ. O lè ṣàtúnṣe ìwọ̀n fèrèsé yẹn láti mu kó tóbi díẹ̀ si.
+
+#### AWS Cloud9
+
+Currently Cloud 9 requires you to sign up with AWS and enter credit card information.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io) and click *Get started with AWS Cloud9*
+3. Sign up for an AWS account (requires credit card information, but you can use it for free)
+4. In the AWS Dashboard, enter *Cloud9* in the search bar and click it
+5. In the Cloud 9 dashboard, click *Create environment*
+6. Name it *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. Click *Next step*
+9. Click *Create environment*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### Àyíká Àìrí
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/yo-NG/code_editor/README.md b/yo-NG/code_editor/README.md
new file mode 100644
index 00000000000..a17b65f933a
--- /dev/null
+++ b/yo-NG/code_editor/README.md
@@ -0,0 +1,11 @@
+# Olóòtú kóòdù
+
+> Fún àwọn òǹkàwé ní ilé: a ti ṣàlàyé àkòrí yìí nínú fídíò [Ṣíṣe àgbékalẹ̀ Python & Olóòtú Kóòdù](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+O ti fẹ́ kọ ilà kóòdù àkọ́kọ́ rẹ, nítorí náà àkókò ti tó láti gba olóòtú kóòdù kan!
+
+> **Àkíyèsí** Tí o bá n lo Chromebook kan, fojú fo àkòrí yìí kí o sì rí dájú pé o tẹ̀lé àwọn ìtọ́sọ́nà [Àgbékalẹ̀-ètò Chromebook](../chromebook_setup/README.md) náà. Cloud IDE tí o bá yàn náà (PaizaCloud Cloud IDE tàbí AWS Cloud9) yíò ní olóòtú kóòdù kan, nígbà tí o bá ṣí fáìlì kan nínú IDE rẹ láti àkójọ àṣàyàn Fáìlì náà, olóòtú náà yíò ma jẹ́ lílò fún ẹ.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/yo-NG/code_editor/instructions.md b/yo-NG/code_editor/instructions.md
new file mode 100644
index 00000000000..7b4d871f07c
--- /dev/null
+++ b/yo-NG/code_editor/instructions.md
@@ -0,0 +1,37 @@
+Oríṣiríṣi àwọn olóòtú ló wà àti pe ó dá lórí èyí tó yàn láàyò. Ọ̀pọ̀lọpọ̀ àwọn onímọ̀ nípa kóòdù Python má n lo àwọn IDE (Integrated Development Environments - àwọn Àyíká Ìgbéjáde tó Papọ̀) tó ṣòro ṣùgbọ́n tó lágbára púpọ̀, gẹ́gẹ́ bíi PyCharm. Ṣùgbọ́n, gẹ́gẹ́ bí ṣẹ̀ṣẹ̀bẹ̀rẹ̀ kan, ó ṣeéṣe kó má ṣeé lò fún ẹ; àwọn àmọ̀ràn wa lágbára bákannáà, ṣùgbọ́n wọ́n rọrùn púpọ̀.
+
+Àwọn àbá wa wà nísàlẹ̀, ṣùgbọ́n má tijú láti béèrè lọ́wọ́ olùkọ́ rẹ nípa nnkan tí ààyò wọ́n jẹ́ - yóò rọrùn láti gba ìrànlọ́wọ́ láti lọ́dọ̀ wọn.
+
+## Visual Studio Code
+
+Visual Studio Code jẹ́ olóòtú kóòdù orísun kan tí Microsoft gbé jáde fún Windows, Linux àti MacOS. Ó ní àtìlẹ́yìn fún wíwá ojútùú ìṣòro, ìdarí Git tó wà nínú rẹ̀, ṣíṣe àgbéyọ syntax, píparí kóòdù pẹ̀lú làákàyè, àwọn abala kóòdù kékèké, àti ṣíṣe àtúnkọ kóòdù.
+
+[Gbà á níbí](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit jẹ́ olóòtú orísun gbangba kan tó wà lọ́fèé fún gbogbo àwọn ètò ìṣiṣẹ́ kọ̀mpútà.
+
+[Gbà á níbí](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text jẹ́ olóòtú kan tó gbajúmọ̀ gan-an pẹ̀lú àkókò àgbéyẹ̀wò ọ̀fẹ́ kan tí ó sì wà fún gbogbo àwọn ètò ìṣiṣẹ́ kọ̀mpútà.
+
+[Gbà á níbí](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom jẹ́ olóòtú tó gbajúmọ̀ mìíràn. Ọ̀fẹ́ ni, ó ní orísun gbangba àti pé ó wà fún Windows, OS X àti Linux. [GitHub](https://github.com/) ló gbé Atom jáde.
+
+[Gbà á níbí](https://atom.io/)
+
+## Kí nìdí tí a fí n ṣàgbékalẹ̀ olóòtú kóòdù kan?
+
+O lè máa ṣe kàyéfì pé kí nìdí tí a fí n ṣàgbékalẹ̀ àkànṣe ètò olóòtú kóòdù yìí, dípò lílo nnkan bíi Word tàbí Notepad.
+
+Ìdí àkọ́kọ́ náà ni pé kóòdù nílò láti jẹ́ **ọ̀rọ̀ lásán**, àti pé ìṣòro tó wà pẹ̀lú àwọn ètò bíi Word àti Textedit ni pé wọn kìí gbé ọ̀rọ̀ lásán jáde, wọ́n má n gbé ọ̀rọ̀ tó lẹ́wà jáde (pẹ̀lú àwọn ìrísí-lẹ́tà àti gbígbé kalẹ̀), pẹ̀lú lílo àwọn àkànṣe àgbékalẹ̀ bíi [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+Ìdí kejì náà ni pé àwọn olóòtú kóòdù jẹ́ àkànṣe fún títẹ̀jáde kóòdù, kí wọ́n ba lè pèsè àwọn ohun tó wúlò bíi ṣíṣe àgbéyọ kóòdù pẹ̀lú àwọ̀ ní ìbámu pẹ̀lú ìtumọ̀ rẹ̀, tàbí píparí àwọn àmì àyọlò fún ẹ fúnra wọn.
+
+A ma rí gbogbo èyí nínú iṣẹ́ tó bá yá. Láìpẹ́, ìwọ yóò wá ronú nípa olóòtú kóòdù àtijọ́ rẹ tó gbẹ́kẹ̀lẹ́ gẹ́gẹ́ bí ọ̀kan nínú àwọn irinṣẹ́ tó yàn láàyò. :)
\ No newline at end of file
diff --git a/yo-NG/css/README.md b/yo-NG/css/README.md
new file mode 100644
index 00000000000..84bc4b00f21
--- /dev/null
+++ b/yo-NG/css/README.md
@@ -0,0 +1,330 @@
+# CSS – mú kí ó rẹwà!
+
+Blog wa ṣì burẹ́wà ní wíwò, àbí bẹ́ẹ̀ kọ? Àkókò láti mú kí ó dára! A ma lo CSS fún yẹn.
+
+## Kíni CSS?
+
+Cascading Style Sheets (CSS) jẹ́ èdè kan tí a n lò fún ṣíṣe àpèjúwe ìrísí àti àgbékalẹ̀ ti ààyè ayélujára kan tí a kọ ní èdè ìṣàmìsí (markup) kan (bíi HTML). Wò ó gẹ́gẹ́ bí èròjà ìṣaralóge fún ojú-ìwé ayélujára wa. ;)
+
+Ṣùgbọ́n a kò fẹ́ bẹ̀rẹ̀ láti ìbẹ̀rẹ̀ padà, àbí bẹ́ẹ̀ kọ? Lẹ́ẹ̀kan síi, a ma lo nnkan kan tí àwọn onímọ̀ nípa kóòdù ti gbé jáde sórí íńtánẹ́ẹ̀tì lọ́fẹ̀ẹ́. Ṣíṣe nnkan tí ẹnìkan ti ṣe kalẹ̀ tẹ́lẹ̀ kìí ṣe ìgbádùn, o mọ̀.
+
+## Ẹ jẹ́ ká lo Bootstrap!
+
+Bootstrap jẹ́ ọ̀kan lára àwọn ètò HTML àti CSS tó gbajúmọ̀ púpọ̀ fún gbígbé àwọn ààyè ayélujára tó rẹwà jáde: https://getbootstrap.com/
+
+Ó gba kíkọ nípasẹ̀ àwọn onímọ̀ nípa kóòdù tó ṣiṣẹ́ fún Twitter. Ní báyìí ó ní àgbéjáde nípasẹ̀ àwọn tó yọ̀ǹda ara wọn káàkiri àgbáyé!
+
+## Ṣàgbékalẹ̀ Bootstrap
+
+Láti ṣàgbékalẹ̀ Bootstrap, ṣí fáìlì `.html` rẹ nínú olóòtú kóòdù náà kí o sì ṣàfikún èyí sí abala `<head>` náà:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+Èyí kò ní ṣàfikún fáìlì kankan sí iṣẹ́ rẹ. Yóò kàn tọ́ka sí àwọn fáìlì tó wà lórí Íńtánẹ́ẹ̀tì náà. Nítorí náà tẹ̀síwájú, ṣí ààyè ayélujára rẹ kí o sì ṣe ìmúdójúìwọ̀n ojú-ìwé náà. Òhun nìyí!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Ó tí n dára ní wíwò!
+
+## Àwọn fáìlì tó wà lójú kan nínú Django
+
+Nígbẹ̀yìn, a ó ṣàgbéyẹ̀wò àwọn ohun tí a tí n pè ní **àwọn fáìlì tó wà lójú kan**. Àwọn fáìlì tó wà lójú kan ni gbogbo CSS àti àwọn àwòrán rẹ. Àkóónú wọn kìí dá lórí bí ìbéèrè náà ṣe rí àti pé yíò jẹ́ bákannáà fún gbogbo aṣàmúlò.
+
+### Ibi tí a ó fi àwọn fáìlì tó wà lójú kan sí fún Django
+
+Django ti mọ ibi tó ti máa ṣàwárí àwọn fáìlì tó wà lójú kan fún ètò "alábòójútó" tó ba wá náà. Ní báyìí, a nílò láti ṣàfikún àwọn fáìlì tó wà lójú kan fún ètò tiwa, `blog`.
+
+A ma ṣe ìyẹn nípasẹ̀ ṣíṣẹ̀dá fódà kan tí a n pè ní `static` sínú ètò blog náà:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django yíò fúnra rẹ̀ ṣàwárí èyíkéyìí fódà tó n jẹ́ "static" nínú èyíkéyìí fódà ti àwọn ètò rẹ. Lẹ́yìn náà, yíò ní ààyè láti lo àwọn àkóónú wọn gẹ́gẹ́ bí àwọn fáìlì tó wà lójú kan.
+
+## Fáìlì CSS àkọ́kọ́ rẹ!
+
+Ẹ jẹ́ ká ṣẹ̀dá fáìlì CSS kan ní báyìí, láti ṣàfikún àrà tìẹ sí ojú-ìwé ayélujára rẹ. Ṣẹ̀dá àkójọpọ̀ fáìlì tuntun kan tí a n pè ní `css` sínú àkójọpọ̀ fáìlì `static` rẹ. Lẹ́yìn náà ṣẹ̀dá fáìlì tuntun kan tí a pè ní `blog.css` sínú àkójọpọ̀ fáìlì `css` yìí. Ṣé o ti ṣetán?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Àkókò láti kọ àwọn CSS! Ṣí fáìlì `blog/static/css/blog.css` náà nínú olóòtú kóòdù rẹ.
+
+A kò ní lọ jìnnà púpọ̀ sínú ṣíṣe bí o ṣe fẹ́ àti ìkẹ́kọ̀ọ́ nípa CSS níbí. Àmọ̀ràn kan wà fún ìdánilékọ̀ọ́ CSS ọ̀fẹ́ kan ní ìparí ojú-ìwé yìí tí o bá fẹ́ láti kẹ́kọ̀ọ́ síi.
+
+Ṣùgbọ́n jẹ́ kí a ṣe ó kéré tán díẹ̀ nínú rẹ̀. Bóyá a le ṣàyípadà àwọ̀ ti àwọn àkọsórí wa? Láti lóye nípa àwọn àwọ̀, àwọn kọ̀mpútà má n lo àwọn àkànṣe kóòdù. Àwọn kóòdù wọ̀nyí ma bẹ̀rẹ̀ pẹ̀lú `#` tí àwọn lẹ́tà 6 (A–F) àti àwọn nọ́mbà (0–9) sì tẹ̀le. Fún àpẹẹrẹ, kóòdù náà fún àwọ̀ búlúù jẹ́ `#0000FF`. O lè rí àwọn kóòdù àwọ̀ fún oríṣiríṣi àwọ̀ níbí: http://www.colorpicker.com/. O tún lè lo [àwọn àwọ̀ ìpìlẹ̀](http://www.w3schools.com/colors/colors_names.asp), bíi `red` àti `green`.
+
+Nínú fáìlì `blog/static/css/blog.css` rẹ ó yẹ kí o ṣàfikún kóòdù tó tẹ̀le yìí:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` jẹ́ Selector CSS kan. Èyí túmọ̀ sí pé a n lo àwọn àrà wa sí èyíkéyìí element `a` tó wà nínú element `h1` kan; selector `h2 a` náà yíò ṣiṣẹ́ bákannáà fún àwọn element `h2`. Nítorí náà, tí a bá ní nnkan kan bíi `<h1><a href="">link</a></h1>`, àrà `h1 a` náà yíò jẹ́ lílò. Ní irú ìṣẹ̀lẹ̀ yìí, a n sọ fún-un láti ṣàyípadà àwọ̀ rẹ̀ sí `#C25100`, èyí tó jẹ́ àwọ̀ omi ọsàn kíki kan. Tàbí o lè fi àwọ̀ tìẹ síbí, ṣùgbọ́n rí dájú pé ó hàn dáadáa lórí àgbétẹ́lẹ̀ funfun kan!
+
+Nínú fáìlì CSS kan, a máa pinnu àwọn àrà fún àwọn element nínú fáìlì HTML náà. Ọnà àkọ́kọ́ tí a lè fi mọ àwọn element ni pẹ̀lú orúkọ element náà. O lè rántí àwọn wọ̀nyí gẹ́gẹ́ bí àwọn àmì láti abala HTML náà. Àwọn nnkan bíi `a`, `h1`, àti `body` jẹ́ àpẹẹrẹ àwọn orúkọ element. A tún máa n dá àwọn element mọ̀ nípasẹ̀ àsopọ̀ `class` náà tàbí àsopọ̀ `id` náà. Class àti id jẹ́ àwọn orúkọ tí o fún element náà fúnra rẹ. Àwọn kíláàsì máa ṣàlàyé àwọn ẹgbẹ́ ti àwọn element, àti pé àwọn id máa tọ́ka sí àwọn element pàtó. For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+O lè kà síi nípa [Àwọn Selector CSS ní w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+A tún nílò láti sọ fún awoṣe (template) HTML wa wípé a ti ṣàfikún àwọn CSS kan. Ṣí fáìlì `blog/templates/blog/post_list.html` nínú olóòtú kóòdù náà kí o sì ṣàfikún ìlà yìí ní ìbẹ̀rẹ̀ pẹ̀pẹ̀ rẹ̀:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+A kàn n gbé àwọn fáìlì tó wà lójú kan níbí. :) Láàrín àwọn àmì `<head>` àti `</head>` náà, lẹ́yìn àwọn atọ́ka sí àwọn fáìlì CSS Bootstrap náà, ṣàfikún ìlà yìí:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+Aṣàwákiri náà yíò ka àwọn fáìlì náà bí a ṣe tò wọ́n síbẹ̀, nítorí náà, a nílò láti rí dájú pé èyí wà níbi tó yẹ. Bí bẹ́ẹ̀ kọ́, kóòdù tó wà nínú àwọn fáìlì Bootstrap lè borí kóòdù tó wà nínú fáìlì wa. A ṣẹ̀ṣẹ̀ sọ ibi tí fáìlì CSS wa wà fún àwòṣe (template) wa.
+
+Ó yẹ kí fáìlì rẹ rí báyìí:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+Ó dáa, tọ́jú fáìlì náà kí o sì ṣe ìmúdójúìwọ̀n ojú-ìwé ààyè ayélujára náà!
+
+![Figure 14.2](images/color2.png)
+
+Iṣẹ́ tó dára! Bóyá a tún lè fẹ́ fún ààyè ayélujára wa ní ìwọ̀nba àyè díẹ̀ àti ṣàfikún etí-ìwé náà ní apá òsì? Jẹ́ ká gbìyànjú èyí!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Ṣàfikún ìyẹn sí CSS rẹ, tọ́jú fáìlì náà kí o sì wo bó tí n ṣiṣẹ́!
+
+![Figure 14.3](images/margin2.png)
+
+Bóyá a lè ṣe ìrísí-lẹ́tà náà bí a ṣe fẹ́ nínú àkọsórí wa? Lẹ èyí sínú `<head>` rẹ nínú fáìlì `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+Bíi ti tẹ́lẹ̀, ṣàyẹ̀wò bí a ṣe tò wọ́n kí o sì fi síwájú atọ́ka sí `blog/static/css/blog.css` náà. Ìlà yìí yíò ṣàgbéwọlé ìrísí-lẹ́tà kan tí a n pè ní *Lobster* láti Google Fonts (https://www.google.com/fonts).
+
+Wá búlọ́ọ̀kù ìkéde `h1 a` náà (kóòdù tó wà láàrín àwọn àkámọ́ onídodo `{` àti `}`) nínú fáìlì CSS `blog/static/css/blog.css` náà. Ní báyìí, ṣàfikún ìlà `font-family: 'Lobster';` náà sí àárín àwọn àkámọ́ onídodo náà, kí o sì ṣe ìmúdójúìwọ̀n ojú-ìwé náà:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Ó dára!
+
+Gẹ́gẹ́ bí a ṣe sọ lókè, CSS ní ìpìlẹ̀ èròngbà kan ti àwọn kíláàsì. Àwọn wọ̀nyí yíò fún ọ láàyè láti sọ apá kan lára kóòdù HTML náà lórúkọ àti lo àwọn àrà sí apá yìí nìkan, láì nípa lórí àwọn apá yòókù. Èyí lè wúlò púpọ̀! Bóyá o ní àwọn div méjì tó n ṣe nnkan ọ̀tọ̀ọ̀tọ̀ (bíi àkọsórí rẹ àti àròkọ rẹ). Kíláàsì kan lè ràn ọ́ lọ́wọ́ láti mú wọn yàtọ̀ síra.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+A máa wá ṣàfikún àwọn búlọ́ọ̀kù ìkéde sí oríṣiríṣi selector. Àwọn selector tó n bẹ̀rẹ̀ pẹ̀lú `.` jẹ mọ́ àwọn kíláàsì. Ọ̀pọ̀lọpọ̀ àwọn àlàyé tó wúlò púpọ̀ nípa CSS ti wà lórí Ayélujára náà tó lè ràn ọ́ lọ́wọ́ láti mọ kóòdù tó tẹ̀le yìí. Ní báyìí, ṣàdàkọ rẹ̀ sínú fáìlì `blog/static/css/blog.css` rẹ:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+Lẹ́yìn náà, yí kóòdù HTML tó n ṣàfihàn àwọn àròkọ náà ká pẹ̀lú àwọn ìkéde ti àwọn kíláàsì. Rọ́pò èyí:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+nínú `blog/templates/blog/post_list.html` náà pẹ̀lú èyí:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+Tọ́jú àwọn fáìlì yẹn kí o sì ṣe ìmúdójúìwọ̀n ojú-ìwé ààyè ayélujára rẹ.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Ó dára ní wíwò, àbí bẹ́ẹ̀ kọ? Wo kóòdù tí a ṣẹ̀ṣẹ̀ lẹ̀ náà láti wá àwọn ibi tí a ti ṣàfikún àwọn kíláàsì nínú HTML náà tí a sì lò wọ́n nínú CSS náà. Ibo lo ti máa ṣàyípadà náà tí o bá fẹ́ kí ọjọ́ náà jẹ́ àwọ̀ turquoise (àdàlù àwọ̀ búlúù àti àwọ̀ ewé)?
+
+Má bẹ̀rù láti ṣàtúnṣe CSS yìí díẹ̀ kí o sì gbìyànjú láti ṣàyípadà àwọn nnkan kan. Fífi CSS náà ṣeré lè ràn ọ́ lọ́wọ́ láti mọ ohun tí àwọn nnkan ọ̀tọ̀ọ̀tọ̀ n ṣe. Tí o bá ṣe àṣìṣe kan, má dààmú – o lè ṣàtúnṣe rẹ̀ padà!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+Ṣé o ti ṣetán fún àkòrí tó kàn náà?! :)
\ No newline at end of file
diff --git a/yo-NG/deploy/README.md b/yo-NG/deploy/README.md
new file mode 100644
index 00000000000..6806b6190b5
--- /dev/null
+++ b/yo-NG/deploy/README.md
@@ -0,0 +1,246 @@
+# Ṣàgbékalẹ̀!
+
+> **Àkíyèsí** Àkòrí tó kàn yìí lè ṣòro díẹ̀ láti kọ́ yanjú nígbà mìíràn. Máa kọ́ ọ nìṣó kí o sì parí rẹ̀; ìṣàgbékalẹ̀ jẹ́ apá kan tó ṣe pàtàkì nínú ìlànà ìgbéjáde ààyè ayélujára náà. Àkòrí yìí wà ní àárín àlàyé náà kí atọ́nisọ́nà rẹ bá lè ràn ọ́ lọ́wọ́ pẹ̀lú ìlànà gbígbé ààyè ayélujára rẹ sórí íńtánẹ́ẹ̀tì tó bá ṣòro díẹ̀ náà. Èyí túmọ̀ sí pé o ṣì lè parí àlàyé náà fúnra rẹ tí kò bá sí àkókò mọ́.
+
+Títí di báyìí, ààyè ayélujára rẹ wà lórí kọ̀mpútà rẹ nìkan. Ní báyìí, o máa kọ́ bí o ṣe lè ṣàgbékalẹ̀ rẹ̀! Ṣíṣe àgbékalẹ̀ jẹ́ ìlànà ṣíṣe ìgbéjáde ètò rẹ sórí Íńtánẹ́ẹ̀tì kó lè ṣeéṣe fún àwọn èèyàn láti lọ wo ètò rẹ. :)
+
+Gẹ́gẹ́ bí o ṣe kẹ́kọ̀ọ́, ààyè ayélujára kan ní láti wà lórí server kan. Ọ̀pọ̀lọpọ̀ àwọn olùpèsè server ló wà lórí íńtánẹ́ẹ̀tì, a máa lo [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere wà lọ́fẹ̀ẹ́ fún àwọn ètò kékèké tí kò ní àwọn àlejò púpọ̀, nítorí náà yóò tó fún ọ ní báyìí.
+
+Ìpèsè ìta mìíràn tí a ó máa lò ni [GitHub](https://www.github.com), èyí tó jẹ́ ìpèsè kan fún pípèsè kóòdù. Àwọn mìíràn wà níbẹ̀, ṣùgbọ́n ó fẹ́rẹ̀ẹ́ jẹ́ gbogbo àwọn onímọ̀ nípa kóòdù ló ní account GitHub kan ní àkókò tá a wà yìí, ìwọ náà yíò ní báyìí!
+
+Àwọn ààyè mẹ́ta wọ̀nyí yíò ṣe pàtàkì sí ẹ. Kọ̀mpútà tìẹ yíò jẹ́ ààyè tí o ti máa ṣe ìgbéjáde àti ṣíṣe àyẹ̀wò. Nígbà tí inú rẹ bá dùn pẹ̀lú àwọn ìyípadà náà, ìwọ yíò fi ẹ̀dà ètò rẹ kan sórí GitHub. Ààyè ayélujára rẹ yíò wà lórí PythonAnywhere, ìwọ yíò máa ṣe ìmúdójúìwọ̀n rẹ̀ nípasẹ̀ gbígba ẹ̀dà tuntun kan ti kóòdù rẹ láti GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Bíbẹ̀rẹ̀ repository Git wa
+
+Git máa n ṣàmójútó àwọn ìyípadà sí àpapọ̀ àwọn fáìlì pàtó kan nínú ohun tí a n pè ní repository kóòdù kan (tàbí "repo" ní kúkúrú). Jẹ́ ká bẹ̀rẹ̀ ẹyọkan fún iṣẹ́ wa. Ṣí console rẹ kalẹ̀ kí o sì ṣe àwọn àṣẹ wọ̀nyí, nínú àkójọpọ̀ fáìlì `djangogirls` náà:
+
+> **Àkíyèsí** Ṣàyẹ̀wò àkójọpọ̀ fáìlì rẹ tó n ṣiṣẹ́ lọ́wọ́lọ́wọ́ pẹ̀lú àṣẹ `pwd` (Mac OS X/Linux) tàbí `cd` (Windows) ṣáájú bíbẹ̀rẹ̀ repository náà. Ó yẹ kí o wà nínú fódà `djangogirls` náà.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Bíbẹ̀rẹ̀ repository Git náà jẹ́ nnkan kan tí a nílò láti ṣe lẹ́ẹ̀kan ṣoṣo péré lórí iṣẹ́ kan (àti pé ìwọ kò ní láti tún tẹ orúkọ aṣàmúlò àti ímeèlì náà mọ́).
+
+Git yíò ṣàmójútó àwọn ìyípadà sí gbogbo àwọn fáìlì àti fódà tó wà nínú àkójọpọ̀ fáìlì yìí, ṣùgbọ́n àwọn fáìlì kan wà tí a fẹ́ kí ó fojú fò. A máa ṣe èyí nípasẹ̀ ṣíṣẹ̀dá fáìlì kan tí a n pè ní `.gitignore` sínú àkójọpọ̀ fáìlì ìpìlẹ̀ náà. Ṣí olóòtú rẹ kalẹ̀ kí o sì ṣẹ̀dá fáìlì tuntun kan pẹ̀lú àwọn àkóónú tó tẹ̀le yìí:
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+Tọ́jú rẹ̀ gẹ́gẹ́ bí `.gitignore` sínú fódà "djangogirls" náà.
+
+> **Àkíyèsí** Àmì tó-ín (dot) tó wà ní ìbẹ̀rẹ̀ orúkọ fáìlì náà ṣe pàtàkì! Tí o bá n kojú ìṣòro kankan pẹ̀lú ṣíṣẹ̀dá rẹ̀ (fún àpẹẹrẹ, MacOS kò nífẹ̀ẹ́ kí o ṣẹ̀dá àwọn fáìlì tó bẹ̀rẹ̀ pẹ̀lú àmì tó-ín kan nípasẹ̀ Finder náà), nígbà náà lo ẹ̀yà "Save As" tó wà nínú olóòtú rẹ, ó máa yanjú ìṣòro náà. Ri dájú pé ìwọ kò ṣàfikún `.txt`, `.py`, tàbí èyíkéyìí àfikún mìíràn sí orúkọ fáìlì náà -- Git yíò lè dá fáìlì náà mọ̀ tí orúkọ náà bá jẹ́ `.gitignore` nìkan. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Àkíyèsí** Ọ̀kan lára àwọn fáìlì tí o dárúkọ pàtó nínú fáìlì `.gitignore` rẹ jẹ́ `db.sqlite3`. Fáìlì yẹn jẹ́ àkójọpọ̀ dátà ti orí kọ̀mpútà rẹ, níbi tí gbogbo àwọn aṣàmúlò àti àwọn àròkọ rẹ gba títọ́jú sí. A ó tẹ̀lé ìlànà kíkọ kóòdù ayélujára, tó túmọ̀sí pé a ó lo àkójọpọ̀ dátà ọ̀tọ̀ọ̀tọ̀ fún ààyè ṣíṣe àyẹ̀wò lórí kọ̀mpútà rẹ àti ààyè ayélujára rẹ tó n ṣiṣẹ́ lórí PythonAnywhere. Àkójọpọ̀ dátà PythonAnywhere náà lè jẹ́ SQLite, bíi ẹ̀rọ ìgbéjáde rẹ, ṣùgbọ́n ìwọ yíò sábà máa lo ọ̀kan tí a n pè ní MySQL èyí tó lè kojú àwọn àlejò ààyè púpọ̀ ju SQLite lọ. Èyí tó wù kó jẹ́, nípasẹ̀ fífojú fo àkójọpọ̀ dátà SQLite rẹ fún ẹ̀dà GitHub náà, ó túmọ̀ sí pé gbogbo àwọn àròkọ àti alábòójútó tí o ti ṣẹ̀dá látẹ̀yìnwá máa wà lórí kọ̀mpútà rẹ nìkan, àti pé ìwọ yíò ní láti ṣẹ̀dá àwọn tuntun lásìkò iṣẹ́. Ó yẹ kí o ronú nípa àkójọpọ̀ dátà tó wà lórí kọ̀mpútà rẹ gẹ́gẹ́ bí ibi ìṣeré tó dára kan níbi tí o ti lè ṣàyẹ̀wò oríṣiríṣi nǹkan láìbẹ̀rù pé o máa yọ àwọn àròkọ gidi rẹ kúrò lórí blog rẹ.
+
+Ó jẹ́ èrò tó dára kan láti lo àṣẹ `git status` kan ṣáájú `git add` tàbí nígbàkígbà tí o bá rí pé o tí ń ṣiyèméjì nípa ohun tó ti yípadà. Èyí yíò ṣe ìrànlọ́wọ́ láti ṣèdíwọ́ fún èyíkéyìí ìyàlẹ́nu láti ṣẹlẹ̀, gẹ́gẹ́ bíi ṣíṣe àfikún tàbí commit àwọn fáìlì tí kò yẹ. Àṣẹ `git status` náà yíò dá ìròyìn padà nípa àwọn fáìlì ti kò ní àmójútó/tí a ṣàtúnṣe/tí a gbé kalẹ̀, ipò ẹ̀ka náà, àti bẹ́ẹ̀ bẹ́ẹ̀ lọ. Ó yẹ kí àbájáde náà jọ èyí tó tẹ̀le yìí:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+Ní ìparí, a máa tọ́jú àwọn ìyípadà wa. Lọ sí console rẹ kí o ṣe àwọn àṣẹ wọ̀nyí:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Títi kóòdù rẹ sí GitHub
+
+Lọ sí [GitHub.com](https://www.github.com) kí o sì forúkọ sílẹ̀ fún account aṣàmúlò ọ̀fẹ́ tuntun kan. (Tí o bá ti ṣe ìyẹn tẹ́lẹ̀ nínú ìmúrasílẹ̀ àpérò náà, ó dára!) Ri dájú láti rántí ọ̀rọ̀ aṣínà rẹ (ṣàfikún rẹ̀ sínú alákòóso ọ̀rọ̀ aṣínà rẹ, tí o bá lo ọ̀kan).
+
+Lẹ́yìn náà, ṣẹ̀dá repository tuntun kan, pẹ̀lú orúkọ "my-first-blog". Fi àpótí adarí yíyàn "initialize with a README" náà sílẹ̀ láì yàn, fi àṣàyàn .gitignore náà sílẹ̀ ní òfìfo (a ti ṣe ìyẹn fúnra wa) àti pé fi License náà sílẹ̀ gẹ́gẹ́ bí None.
+
+![](images/new_github_repo.png)
+
+> **Àkíyèsí** Orúkọ `my-first-blog` náà ṣe pàtàkì – o lè yan nǹkan mìíràn, ṣùgbọ́n yóò máa wáyé ní ọ̀pọ̀ ìgbà nínú àwọn ìtọ́sọ́nà tó wà nísàlẹ̀, ìwọ yíò sì ní láti máa rọ́pò rẹ̀ nígbà kọ̀ọ̀kan. Ó ṣeéṣe kó rọrùn láti faramọ́ orúkọ `my-first-blog` náà.
+
+Lórí ojú àwòrán tó kàn náà, ìwọ yíò rí URL ìfijọ ti repo rẹ, èyí tí o máa lò nínú àwọn kan lára àwọn àṣẹ tó tẹ̀le yìí:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Ní báyìí, a nílò láti ṣe ìsopọ̀ repository Git tó wà lórí kọ̀mpútà rẹ pẹ̀lú èyí tó wà lórí GitHub.
+
+Tẹ èyí tó tẹ̀le yìí sínú console rẹ (rọ́pò `<your-github-username>` pẹ̀lú orúkọ aṣàmúlò tí o tẹ̀ nígbà tí o ṣẹ̀dá account GitHub rẹ, ṣùgbọ́n láìsí àwọn àkámọ́ onígun náà -- ó yẹ kí URL náà dọ́gba pẹ̀lú URL ìfijọ tí o ṣẹ̀ṣẹ̀ rí):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+Nígbà tí o bá ti kóòdù rẹ sí GitHub, ìwọ yíò rí ìbéèrè fún orúkọ aṣàmúlò àti ọ̀rọ̀ aṣínà GitHub rẹ (bóyá nínú fèrèsé ìlà ìpàṣẹ náà tàbí nínú fèrèsé aṣẹ́yọsókè kan), àti pé lẹ́yìn títẹ àwọn ohun-ẹ̀rí, ó yẹ kí o rí nnkan kan báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Kóòdù rẹ ti wà lórí GitHub ní báyìí. Lọ síbẹ̀ kí o ṣàyẹ̀wò rẹ̀! Ìwọ yíò ri pé ó wà ní ibi tó dáa – [Django](https://github.com/django/django), [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial) náà, àti ọ̀pọ̀lọpọ̀ àwọn iṣẹ́ ńláńlá mìíràn tó jẹ́ ètò orísun gbangba máa n pèsè kóòdù wọn sórí GitHub. :)
+
+# Ṣíṣe àgbékalẹ̀ blog wa sórí PythonAnywhere
+
+## Forúkọ sílẹ̀ fún account PythonAnywhere kan
+
+> **Àkíyèsí** Ó ṣeéṣe kí o ti ṣẹ̀dá account PythonAnywhere kan tẹ́lẹ̀ lásìkò àwọn ìgbésẹ̀ ìṣàgbékalẹ̀ náà – tó bá rí bẹ́ẹ̀, kò sídìí láti tún ṣe é mọ́.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Ṣíṣe ètò ààyè wa lórí PythonAnywhere
+
+Padà sí [Pánẹ́ẹ̀lì ìdarí PythonAnywhere](https://www.pythonanywhere.com/) pàtàkì náà nípasẹ̀ títẹ orí àmì náà, kí o sì yan àṣàyàn láti bẹ̀rẹ̀ console "Bash" kan – ìyẹn ni ẹ̀yà ìlà ìpàṣẹ ti PythonAnywhere kan, gẹ́gẹ́ bíi èyí tó wà lórí kọ̀mpútà rẹ.
+
+![Abala 'New Console' náà lórí atọ́kùn ayélujára PythonAnywhere, pẹ̀lú bọ́tìnnì kan fún 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Àkíyèsí** PythonAnywhere dá lórí Linux, nítorí náà tí o bá wà lórí Windows, console náà yíò yàtọ̀ díẹ̀ sí èyí tó wà lórí kọ̀mpútà rẹ.
+
+Ṣíṣe àgbékalẹ̀ ètò ayélujára kan sórí PythonAnywhere ní láti ṣe pẹ̀lú fífa kóòdù rẹ láti GitHub, lẹ́yìn náà ṣíṣe ètò PythonAnywhere láti dá a mọ̀ àti bẹ̀rẹ̀ pípèsè rẹ̀ gẹ́gẹ́ bí ètò ayélujára kan. Àwọn ọ̀nà tí o lè gbà ṣé fúnra rẹ wà, ṣùgbọ́n PythonAnywhere pèsè irinṣẹ́ olùrànlọ́wọ́ kan tí yíò ṣe gbogbo rẹ̀ fún ẹ. Jẹ́ ká kọ́kọ́ ṣàgbékalẹ̀ rẹ̀:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+Ó yẹ kí ìyẹn ṣàtẹ̀jáde àwọn nnkan kan bíi `Collecting pythonanywhere`, kí o sì parí gbẹ̀yìn pẹ̀lú ìlà kan tó n sọ pé `Successfully installed (...) pythonanywhere- (...)`.
+
+Ní báyìí, a máa mú olùrànlọ́wọ́ náà ṣiṣẹ́ láti ṣètò ètò wa láti GitHub fúnra rẹ̀. Tẹ èyí tó tẹ̀le yìí sínú console náà lórí PythonAnywhere (má gbàgbé láti lo orúkọ aṣàmúlò GitHub rẹ dípò `<your-github-username>`, kí URL náà bàa lè dọ́gba pẹ̀lú URL ìfijọ láti GitHub náà):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+Bó o ṣe ń wo ìyẹn tó n ṣiṣẹ́, ìwọ yíò lè rí ohun tó ń ṣe:
+
+- Gbígba kóòdù rẹ láti GitHub
+- Ṣíṣẹ̀dá virtualenv kan lórí PythonAnywhere, gẹ́gẹ́ bí èyí tó wà lórí kọ̀mpútà tìẹ
+- Ṣíṣe ìmúdójúìwọ̀n fáìlì àwọn ìṣètò rẹ pẹ̀lú àwọn ìṣètò ìṣàgbékalẹ̀ kan
+- Ṣíṣe àgbékalẹ̀ àkójọpọ̀ dátà kan sórí PythonAnywhere pẹ̀lú lílo àṣẹ `manage.py migrate` náà
+- Ṣíṣe àgbékalẹ̀ àwọn fáìlì tó wà lójú kan rẹ (a ó kẹ́kọ̀ọ́ nípa àwọn wọ̀nyí tó bá yá)
+- Àti ṣíṣe ètò PythonAnywhere láti pèsè ètò ayélujára rẹ nípasẹ̀ API rẹ̀
+
+Lórí PythonAnywhere, gbogbo àwọn ìgbésẹ̀ wọ̀nyí máa jẹ́ ṣíṣe fúnra wọn, ṣùgbọ́n wọ́n jẹ́ àwọn ìgbésẹ̀ kannáà tí o ní láti gbà kọjá pẹ̀lú èyíkéyìí olùpèsè server mìíràn.
+
+Ohun pàtàkì láti ṣàkíyèsí ní báyìí ni pé àkójọpọ̀ dátà rẹ lórí PythonAnywhere yàtọ̀ pátápátá sí àkójọpọ̀ dátà rẹ lórí kọ̀mpútà tìẹ, nítorí náà ó lè ní àwọn àròkọ àti account alábòójútó ọ̀tọ̀ọ̀tọ̀. Nítorí èyí, gẹ́gẹ́ bí a ṣe ṣe lórí kọ̀mpútà tìẹ, a nílò láti bẹ̀rẹ̀ account alábòójútó náà pẹ̀lú `createsuperuser`. PythonAnywhere ti mú virtualenv rẹ ṣiṣẹ́ fún ẹ fúnra rẹ̀, nítorí náà gbogbo ohun tí o nílò láti ṣe ni:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Tẹ àwọn àlàyé fún aṣàmúlò alábòójútó rẹ. Ó dára jù láti lo àwọn ohun kannáà gẹ́gẹ́ bí o ṣé n lo lórí kọ̀mpútà tìẹ láti yẹra fún èyíkéyìí ìdààmú, àyàfi tí o bá fẹ́ mú ọ̀rọ̀ aṣínà lórí PythonAnywhere túbọ̀ láàbò síi.
+
+Ní báyìí, tí o bá fẹ́, o lè tún ṣàyẹ̀wò kóòdù rẹ lórí PythonAnywhere pẹ̀lú lílo `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+O tún lè lọ sí ojú-ìwé "Files" náà kí o sì lọ káàkiri pẹ̀lú lílo aṣàwákiri fáìlì ti PythonAnywhere. (Láti ojú-ìwé Console náà, o lè dé àwọn ojú-ìwé PythonAnywhere mìíràn láti bọ́tìnnì àkójọ àṣàyàn náà ní igun òkè lápá ọ̀tún. Tí o bá ti wà lórí ọ̀kan lára àwọn ojú-ìwé náà, àwọn atọ́ka sí àwọn yòókù náà yíò wà nítòsí òkè náà.)
+
+## O tí n ṣiṣẹ́ báyìí!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Àkíyèsí** Èyí jẹ́ àlàyé ti ṣẹ̀ṣẹ̀bẹ̀rẹ̀ kan, àti pé nínú ṣíṣe àgbékalẹ̀ ààyè yìí a ti gba àwọn àbùjá díẹ̀ kan èyí tí kò dára nípa ti ààbò. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Àwọn àbá wíwá ojútùú ìṣòro
+
+Tí o bá rí àṣìṣe kan nígbà tí ìlànà ìṣe `pa_autoconfigure_django.py` n ṣiṣẹ́, lára àwọn ohun tó sábà máa ń fà á nìyí:
+
+- Tí o bá gbàgbé láti ṣẹ̀dá token API PythonAnywhere rẹ.
+- Ṣíṣe àṣìṣe kan nínú URL GitHub rẹ
+- Tí o bá rí àṣìṣe kan tó n sọ pé *"Could not find your settings.py"*, ó ṣeéṣe kó jẹ́ nítorí pé ìwọ kò gbìyànjú láti ṣàfikún gbogbo àwọn fáìlì rẹ sí Git, àti/àbí ìwọ kò ti wọ́n sí GitHub pẹ̀lú àṣeyọrí. Tún ṣàyẹ̀wò abala Git tó wà lókè náà
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+Tí o bá rí àṣìṣe kan nígbà tí o bá gbìyànjú láti ṣàbẹ̀wò ààyè rẹ, ibi àkọ́kọ́ láti ṣàyẹ̀wò fún ìròyìn wíwá ojútùú ìṣòro ni inú **error log** rẹ. Ìwọ yíò rí atọ́ka kan sí èyí lórí [ojú-ìwé "Ayélujára"](https://www.pythonanywhere.com/web_app_setup/) PythonAnywhere náà. Ṣàyẹ̀wò tí àwọn ìròyìn àṣìṣe kankan bá wà níbẹ̀; àwọn ti àìpẹ́ yìí wà nísàlẹ̀.
+
+[Àwọn àbá wíwá ojútùú ìṣòro lórí ààyè ìrànlọ́wọ́ PythonAnywhere náà](http://help.pythonanywhere.com/pages/DebuggingImportError) tún wà.
+
+Rántí, olùkọ́ rẹ wà níbí láti ràn ọ́ lọ́wọ́!
+
+# Ṣàyẹ̀wò ààyè rẹ!
+
+Ó yẹ kí ojú-ìwé ìpìlẹ̀ fún ààyè rẹ sọ pé "Ó ṣiṣẹ́!", gẹ́gẹ́ bí ó ṣe máa n ṣe lórí kọ̀mpútà rẹ. Gbìyànjú ṣíṣe àfikún `/admin/` sí ìparí URL náà, ìwọ yíò sì lọ sí ààyè alábòójútó náà. Wọlé pẹ̀lú orúkọ aṣàmúlò àti ọ̀rọ̀ aṣínà náà, ìwọ yíò sì rí pé o lè ṣàfikún àwọn Àròkọ tuntun sórí server náà -- rántí, a kò fi àwọn àròkọ láti àkójọpọ̀ dátà orí kọ̀mpútà rẹ ránṣẹ́ sí blog rẹ tó n ṣiṣẹ́.
+
+Tí o bá ti ṣẹ̀dá àwọn àròkọ díẹ̀ kan, o lè padà sí àgbékalẹ̀-ètò kọ̀mpútà rẹ (kìí ṣe PythonAnywhere). Láti ibí, ó yẹ kí o ṣiṣẹ́ lórí àgbékalẹ̀-ètò kọ̀mpútà rẹ láti ṣe àwọn ìyípadà. Èyí jẹ́ ìtẹ̀síwájú iṣẹ́ kan tó wọ́pọ̀ nínú ìgbéjáde ayélujára – ṣe àwọn ìyípadà lórí kọ̀mpútà rẹ, ti àwọn ìyípadà yẹn sí GitHub, kí o sì fa àwọn ìyípadà rẹ sí server Ayélujára rẹ tó n ṣiṣẹ́. Èyí yíò fún ọ láàyè láti ṣiṣẹ́ àti ṣe ìdánrawò láì ṣe ohun tí kò tọ́ sórí ààyè Ayélujára rẹ tó n ṣiṣẹ́. Ó dára púpọ̀, àbí bẹ́ẹ̀ kọ?
+
+Kí ara rẹ *kú oríire!* Àwọn ìṣàgbékalẹ̀ server jẹ́ ọ̀kan lára àwọn apá ìgbéjáde ayélujára tó ṣòro jù, ó sábà máa ń gba àwọn èèyàn ní ọjọ́ bíi mélòó kan kí wọ́n tó mú wọn ṣiṣẹ́. Ṣùgbọ́n ìwọ ti mú ààyè rẹ ṣiṣẹ́, lórí Íńtánẹ́ẹ̀tì gidi náà!
\ No newline at end of file
diff --git a/yo-NG/deploy/install_git.md b/yo-NG/deploy/install_git.md
new file mode 100644
index 00000000000..fd60390889d
--- /dev/null
+++ b/yo-NG/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git jẹ́ "ètò ìdarí ẹ̀yà" kan tó jẹ́ lílò nípasẹ̀ ọ̀pọ̀lọpọ̀ àwọn onímọ̀ nípa kóòdù. Ètò yìí lè ṣàmójútó àwọn ìyípadà sí àwọn fáìlì bí àkókò ti ń lọ kí o ba lè rántí àwọn ẹ̀yà pàtó lẹ́yìn náà. Ó fẹ́ dàbí ẹ̀ka "ṣàmójútó àwọn ìyípadà" tó wà nínú àwọn ètò aṣaáyan ọ̀rọ̀ (bí àpẹẹrẹ, Microsoft Word tàbí LibreOffice Writer), ṣùgbọ́n ó lágbára jù bẹ́ẹ̀ lọ.
+
+## Ṣíṣe àgbékalẹ̀ Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+O lè gba Git láti [git-scm.com](https://git-scm.com/). O lè tẹ "next" lórí gbogbo àwọn ìgbésẹ̀ àyàfi méjì: ní ìgbésẹ̀ tí yíò ti béèrè láti yan olóòtú rẹ, ó yẹ kí o mú Nano, àti ní ìgbésẹ̀ tí àkọlé rẹ̀ jẹ́ "Adjusting your PATH environment", yan "Use Git and optional Unix tools from the Windows Command Prompt" (àṣàyàn ìsàlẹ̀ náà). Yàtọ̀ sí ìyẹn, àwọn ìpìlẹ̀ náà dára. Ní ìgbésẹ̀ "Configuring the line ending conversions", yíyan "Checkout Windows-style, commit Unix-style line endings" ti dára.
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Gba Git láti [git-scm.com](https://git-scm.com/) kí o sì tẹ̀lé àwọn ìtọ́sọ́nà náà.
+
+> **Àkíyèsí** Tí o bá n lo OS X 10.6, 10.7, tàbí 10.8, o ma nílò láti ṣàgbékalẹ̀ ẹ̀yà git náà láti ibí: [Ètò ìṣàgbékalẹ̀ Git fún OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/yo-NG/deploy/signup_pythonanywhere.md b/yo-NG/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..7c2e52edee9
--- /dev/null
+++ b/yo-NG/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere jẹ́ ìpèsè kan fún lílo kóòdù Python lórí àwọn server "nínú cloud náà". A máa lò ó fún ṣíṣe ìpèsè ààyè ayélujára wa, tààrà àti sórí íńtánẹ́ẹ̀tì náà.
+
+A ó máa ṣe ìpèsè blog tí a n kọ́ náà sórí PythonAnywhere. Forúkọ sílẹ̀ fún account "Beginner" kan lórí PythonAnywhere (ìpele ọ̀fẹ́ náà ti dára, o kò nílò káàdì arọ́pò owó kan).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![Ojú-ìwé ìforúkọsílẹ̀ PythonAnywhere tó n ṣàfihàn bọ́tìnnì láti ṣẹ̀dá account 'Beginner' ọ̀fẹ́ kan](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Àkíyèsí** Nígbà tí o bá n yan orúkọ aṣàmúlò rẹ níbí, fi sọ́kàn wípé URL ti blog rẹ yíò wáyé lọ́nà `yourusername.pythonanywhere.com`, nítorí náà yan bóyá orúkọ ìnagijẹ tìẹ tàbí orúkọ kan fún nnkan tí blog rẹ dá lé lórí. Àti pé, ri dájú láti rántí ọ̀rọ̀ aṣínà rẹ (ṣàfikún rẹ̀ sínú alákòóso ọ̀rọ̀ aṣínà rẹ, tí o bá lo ọ̀kan).
+
+## Ṣíṣẹ̀dá token API PythonAnywhere kan
+
+Èyí jẹ́ nnkan tí o nílò láti ṣe lẹ́ẹ̀kanṣoṣo. Nígbà tí o bá ti forúkọ sílẹ̀ fún PythonAnywhere, ìwọ yóò wọnú pánẹ́ẹ̀lì ìdarí rẹ. Wá atọ́ka náà nítòsí òke lápá ọtún sí ojú-ìwé "Account" rẹ:
+
+![Ìsopọ̀ account ní òkè lápá ọ̀tún lórí ojú-ìwé náà](../deploy/images/pythonanywhere_account.png)
+
+lẹ́yìn náà yan táàbù tó ń jẹ́ "API token", kí o tẹ bọ́tìnnì tó sọ pé "Create new API token".
+
+![Táàbù token API lórí ojú-ìwé Account náà](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/yo-NG/django/README.md b/yo-NG/django/README.md
new file mode 100644
index 00000000000..ee0f838f09e
--- /dev/null
+++ b/yo-NG/django/README.md
@@ -0,0 +1,27 @@
+# Kíni Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) jẹ́ àgbékalẹ̀ ètò ayélujára ọ̀fẹ́ kan tó ní orísun gbangba, tí a kọ ní Python. Àgbékalẹ̀ ayélujára kan jẹ́ àwọn èròjà tí yóò ràn ọ́ lọ́wọ́ láti gbé àwọn ààyè ayélujára jáde ní kíákíá àti nírọ̀rùn.
+
+Nígbà tí o bá n kọ́ ààyè ayélujára kan, o gbọ́dọ̀ máa nílò àwọn èròjà tó jọra kan: ọnà kan láti yanjú ìfàṣẹsí aṣàmúlò (ìforúkọsílẹ̀, wíwọlé, jíjáde), pánẹ́ẹ̀lì ìṣàkóso kan fún ààyè ayélujára rẹ, àwọn fọ́ọ̀mù, ọnà kan láti gbé àwọn fáìlì sórí ayélujára, àti bẹ́ẹ̀ bẹ́ẹ̀ lọ.
+
+Èyí tó jẹ́ oríre fún ẹ, àwọn èèyàn kan ti ṣàkíyèsí tipẹ́tipẹ́ wípé àwọn olùgbéjáde ayélujára má n kojú àwọn ìṣòro tó jọra nígbà kíkọ́ ààyè ayélujára tuntun kan, nítorí náà wọ́n pèrò pọ̀ láti ṣẹ̀dá àwọn àgbékalẹ̀ (Django jẹ́ ọ̀kan lára wọn) tó ma fún ẹ ní àwọn èròjà tó wà nílẹ̀ láti lò.
+
+Àwọn àgbékalẹ̀ wà láti gbà ọ́ sílẹ̀ lọ́wọ́ ṣíṣe nnkan tí ẹnìkan ti ṣe kalẹ̀ tẹ́lẹ̀ àti láti lè dín ìṣòro tí o lè kojú kù nígbà tí o bá n kọ́ ààyè ayélujára tuntun kan.
+
+## Kí nìdí tó o fi nílò àgbékalẹ̀ (framework) kan?
+
+Láti lóye nípa nnkan tí Django wà fún gan-an, a nílò láti ṣàgbéyẹ̀wò àwọn server náà. Nnkan àkọ́kọ́ ní pé server náà yíò nílò láti mọ̀ wípé o fẹ́ kí ó pèsè ojú-ìwé ayélujára kan fún ẹ.
+
+Wòye sí àpótì méèlì kan (port) èyí tí a n ṣàmójútó fún àwọn lẹ́tà tí ń bọ̀ (requests). Èyí jẹ́ ṣíṣe nípasẹ̀ server ayélujára kan. Server ayélujára náà yíò ka lẹ́tà náà àti lẹ́yìn náà yíò fi ìdáhùn kan ránṣẹ́ pẹ̀lú ojú-ìwé ayélujára kan. Ṣùgbọ́n nígbà tí o bá fẹ́ fi nnkan ránṣẹ́, o nílò láti ní àwọn àkóónú kan. Django jẹ́ nnkan kan tí yóò ràn ọ́ lọ́wọ́ láti ṣẹ̀dá àkóónú náà.
+
+## Kíni yíò ṣẹlẹ̀ nígbà tí ẹnìkan bá béèrè ààyè ayélujára kan láti server rẹ?
+
+Nígbà tí ìbéèrè kan bá wá sí server ayélujára kan, yóò kọjá sí Django tí yíò gbìyànjú láti mọ ohun tí a béèrè fún gan-an. Yíò kọ́kọ́ mú àdírẹ́ẹ̀sì ojú-ìwé ayélujára kan tí yíò sì gbìyànjú láti mọ ohun tó yẹ kó ṣe. Apá yìí jẹ́ ṣíṣe nípasẹ̀ **urlresolver** ti Django (ṣàkíyèsí pé àdírẹ́ẹ̀sì ààyè ayélujára kan ni a n pè ní URL – Uniform Resource Locator – nítorí náà orúkọ *urlresolver* náà bọ́gbọ́n mu). Kò já fáfá púpọ̀ – Ó máa n mú àkójọ àwọn àpẹẹrẹ kan tí yíò sì gbìyànjú láti bá URL náà mu. Django yíò ma ṣàyẹ̀wò àwọn àpẹẹrẹ láti òkè sí ìsàlẹ̀, tí nnkan kan bá sì báramu, Django yíò darí ìbéèrè náà sí iṣẹ́ tó sopọ̀ mọ náà (èyí tí a n pè ní *view*).
+
+Wòye sí òṣìṣẹ́ méèlì kan pẹ̀lú lẹ́tà kan. Ó n rìn lọ ní òpópónà náà tó sì n ṣàyẹ̀wò nọ́mbà ilé kọ̀ọ̀kan sí èyí tó wà lórí lẹ́tà náà. Tó bá báramu, yíò fi lẹ́tà náà síbẹ̀. Báyìí ni urlresolver náà ṣe n ṣiṣẹ́!
+
+Nínú iṣẹ́ *view* náà, gbogbo àwọn nnkan tó dára ma jẹ́ ṣíṣe: a lè wo àkójọpọ̀ dátà kan láti wá àwọn àlàyé díẹ̀. Bóyá aṣàmúlò náà béèrè láti ṣàyípadà nnkan kan nínú dátà náà? Bíi lẹ́tà kan tó n sọ pé, "Jọ̀wọ́ ṣàyípadà àpèjúwe iṣẹ́ mi." *View* náà lè ṣàyẹ̀wò tí o bá ní ìyọ̀nda láti ṣe bẹ́ẹ̀, ṣe ìmúdójúìwọ̀n àpèjúwe iṣẹ́ náà fún ẹ lẹ́yìn náà àti fi ìkéde kan ránṣẹ́ padà: "Ti gba ṣíṣe!" Lẹ́yìn náà *view* náà yíò pèsè ìdáhùn kan tí Django le fi ránṣẹ́ sí aṣàwákiri ayélujára ti aṣàmúlò náà.
+
+Àpèjúwe tó wà lókè náà jẹ́ èyí tí a mú rọrùn níwọ̀nba, ṣùgbọ́n ìwọ kò tíì nílò láti mọ gbogbo àwọn nnkan tó jẹ́ iṣẹ́ ẹ̀rọ náà. Níní òye àpapọ̀ kan ti tó.
+
+Nítorí náà dípò kí a ṣàlàyé lẹ́kùn-únrẹ́rẹ́, a ó bẹ̀rẹ̀ ṣíṣẹ̀dá nnkan pẹ̀lú Django tí a ó sì kẹ́kọ̀ọ́ nípa gbogbo àwọn apá tó ṣe pàtàkì náà bí a ṣe ń tẹ̀síwájú!
\ No newline at end of file
diff --git a/yo-NG/django_admin/README.md b/yo-NG/django_admin/README.md
new file mode 100644
index 00000000000..9d8abbcce0f
--- /dev/null
+++ b/yo-NG/django_admin/README.md
@@ -0,0 +1,57 @@
+# Alábòójútó Django
+
+Láti ṣàfikún, ṣàtúnṣe àti ṣe ìyọkúrò àwọn àròkọ tí a ṣẹ̀ṣẹ̀ ṣe àwòṣe rẹ̀, a máa lo alábòójútó Django.
+
+Jẹ́ ká ṣí fáìlì `blog/admin.py` náà nínú olóòtú kóòdù náà kí a sì rọ́pò àwọn àkóónú rẹ̀ pẹ̀lú èyí:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+Gẹ́gẹ́ bó o ṣe ríi, a ṣàgbéwọlé (ṣàfikún) àwòṣe Post tí a ṣàlàyé nínú àkòrí tó ṣáájú náà. Láti mú àwòṣe wa fojú hàn lórí ojú-ìwé alábòójútó náà, a nílò láti ṣe àkọsílẹ̀ àwòṣe náà pẹ̀lú `admin.site.register(Post)`.
+
+Ó dáa, àkókò láti ṣàyẹ̀wò àwòṣe Post wa. Rántí láti ṣe `python manage.py runserver` nínú console náà láti bẹ̀rẹ̀ server ayélujára náà. Lọ sí aṣàwákiri rẹ kí o tẹ àdírẹ́ẹ̀sì http://127.0.0.1:8000/admin/. Ìwọ yíò rí ojú-ìwé ìwọlé kan báyìí:
+
+![Ojú-ìwé ìwọlé](images/login_page2.png)
+
+Láti wọlé, o nílò láti ṣẹ̀dá *superuser* kan - account aṣàmúlò kan tó ní àkóso lórí gbogbo nnkan lórí ààyè náà. Padà sí ìlà ìpàṣẹ náà, tẹ `python manage.py createsuperuser`, kí o sì tẹ enter.
+
+> Rántí, láti kọ àwọn àṣẹ tuntun nígbà tí server ayélujára náà bá n ṣiṣẹ́, ṣí fèrèsé èbúté tuntun kan kí o sì mú virtualenv rẹ ṣiṣẹ́. A ti ṣàgbéyẹ̀wò bí a ṣe lè kọ àwọn àṣẹ tuntun nínú àkòrí **Iṣẹ́ Django àkọ́kọ́ rẹ!**, nínú abala **Bíbẹ̀rẹ̀ server ayélujára náà**.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+Nígbà tó bá rí ìbéèrè, tẹ orúkọ aṣàmúlò (lẹ́tà kékeré, láìsí àlàfo), àdírẹ́ẹ̀sì ímeèlì, àti ọ̀rọ̀ aṣínà rẹ. **Má dààmú pé ìwọ kò lè rí ọ̀rọ̀ aṣínà tí o n tẹ̀ wọlé náà – bó ṣe yẹ kí ó rí nìyẹn.** Tẹ̀ ẹ́ wọlé kí o sì tẹ `enter` láti tẹ̀síwájú. Ó yẹ kí èsì náà rí báyìí (níbi tí orúkọ aṣàmúlò àti ímeèlì yíò jẹ́ tìrẹ):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Padà sí aṣàwákiri rẹ. Wọlé pẹ̀lú àwọn ẹ̀rí superuser tí o yàn náà; ó yẹ kí o rí pánẹ́ẹ̀lì ìdarí alábòójútó Django náà.
+
+![Alábòójútó Django](images/django_admin3.png)
+
+Lọ sí Posts kí o sì ṣe ìdánrawò díẹ̀ pẹ̀lú rẹ̀. Ṣàfikún àwọn àròkọ blog márùn-ún tàbí mẹ́fà. Má dààmú nípa àkóónú náà – ó fojú hàn sí ìwọ nìkan lórí kọ̀mpútà rẹ -- o lè ṣàdàkọ àwọn ọ̀rọ̀ kan lára àlàyé yìí láti dín àkókò kù. :)
+
+Rí dájú pé ó kéré jù àwọn àròkọ méjì tàbí mẹ́ta (ṣùgbọ́n kìí ṣe gbogbo rẹ̀) ló ní ọjọ́ ìtẹ̀jáde náà. Yíò wúlò tó bá yá.
+
+![Alábòójútó Django](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+Èyí lè jẹ́ àkókò tó dára láti nawọ́ mú ife kọfí kan (tàbí tíì) tàbí oúnjẹ láti tún fún ara rẹ lókun. O ti ṣẹ̀dá àwòṣe Django àkọ́kọ́ rẹ – o tọ́ sí ìsinmi díẹ̀ kan!
\ No newline at end of file
diff --git a/yo-NG/django_forms/README.md b/yo-NG/django_forms/README.md
new file mode 100644
index 00000000000..21f2740f102
--- /dev/null
+++ b/yo-NG/django_forms/README.md
@@ -0,0 +1,479 @@
+# Àwọn fọ́ọ̀mù Django
+
+Ohun tó kẹ́yìn tí a fẹ́ ṣe lórí ààyè ayélujára wa ni láti ṣẹ̀dá ọ̀nà tó dára kan láti ṣàfikún àti ṣàtúnṣe àwọn àròkọ blog. `admin` ti Django dára, ṣùgbọ́n ó ṣòro láti ṣé bí o ṣe fẹ́ àti láti mú rẹwà. Pẹ̀lú `forms`, a máa ní gbogbo agbára lórí atọ́kùn wa – a lè fẹ́rẹ̀ẹ́ ṣe ohunkóhun tí a lè wòye sí!
+
+Ohun tó dára nípa àwọn fọ́ọ̀mù Django ni pé a lè ṣàlàyé ìkan láti ìbẹ̀rẹ̀ tàbí ṣẹ̀dá `ModelForm` kan èyí tí yíò tọ́jú èsì fọ́ọ̀mù náà sínú àwòṣe náà.
+
+Èyí jẹ́ ohun tí a fẹ́ ṣe gan-an: a ó ṣẹ̀dá fọ́ọ̀mù kan fún àwòṣe `Post` wa.
+
+Gẹ́gẹ́ bí gbogbo apá tó ṣe pàtàkì nínú Django, àwọn fọ́ọ̀mù ní fáìlì tiwọn: `forms.py`.
+
+A nílò láti ṣẹ̀dá fáìlì kan pẹ̀lú orúkọ yìí nínú àkójọpọ̀ fáìlì `blog` náà.
+
+    blog
+       └── forms.py
+    
+
+O dáa, jẹ́ ká ṣí i nínú olóòtú kóòdù náà kí a sì tẹ kóòdù tó tẹ̀le yìí:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+A nílò láti ṣàgbéwọlé àwọn fọ́ọ̀mù Django lákọ̀ọ́kọ́ (`from django import forms`) àti àwòṣe `Post` wa (`from .models import Post`).
+
+`PostForm`, bí o ṣe lérò, jẹ́ orúkọ fọ́ọ̀mù wa. A nílò láti sọ fún Django pé fọ́ọ̀mù yìí jẹ́ `ModelForm` kan (kí Django baà lè ṣe àwọn iṣẹ́ kan fún wa) – `forms.ModelForm` ló máa ṣe ìyẹn.
+
+Lẹ́yìn náà, a ní `class Meta`, níbi tí a ti máa sọ àwòṣe tó yẹ kí Django lò láti ṣẹ̀dá fọ́ọ̀mù yìí (`model = Post`).
+
+Ní ìparí, a lè sọ (àwọn) ààyè tó yẹ kó wà nínú fọ́ọ̀mù wa. Ní irú ìṣẹ̀lẹ̀ yìí, a fẹ́ kí `title` àti `text` nìkan hàn síta – ó yẹ kí `author` jẹ́ ẹni tó ti wọlé lọ́wọ́lọ́wọ́ (ìwọ!) àti pé ó yẹ kí `created_date` wà ní ètò fúnra rẹ̀ nígbà tí a bá ṣẹ̀dá àròkọ kan (ìyẹn ni pé, nínú kóòdù náà), àbí bẹ́ẹ̀ kọ?
+
+Òhun nìyẹn! Gbogbo ohun tí a nílò láti ṣe báyìí ni láti lo fọ́ọ̀mù náà nínú *view* kan kí a sì ṣàfihàn rẹ̀ nínú àwòṣe kan.
+
+Nítorí náà, a ó ṣẹ̀dá atọ́ka sí ojú-ìwé náà kan, URL kan, view kan àti àwòṣe kan lẹ́ẹ̀kan síi.
+
+## Atọ́ka sí ojú-ìwé kan pẹ̀lú fọ́ọ̀mù náà
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## view post_new
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Àwòṣe (template)
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* A ní láti ṣàfihàn fọ́ọ̀mù náà. A lè ṣe ìyẹn pẹ̀lú (fún àpẹẹrẹ) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* A nílò bọ́tìnnì `Save` kan. A lè ṣe ìyẹn pẹ̀lú bọ́tìnnì HTML kan: `<button type="submit">Save</button>`.
+* Ní ìparí, kété lẹ́yìn àmì `<form ...>` ṣíṣí náà, a nílò láti ṣàfikún {% raw %}`{% csrf_token %}`{% endraw %}. Èyí ṣe pàtàkì púpọ̀, nítorí pé yóò pèsè ààbò fún àwọn fọ́ọ̀mù rẹ! Tí o bá gbàgbé nípa apá yìí, Django yíò ṣàròyé nígbà tí o bá gbìyànjú láti tọ́jú fọ́ọ̀mù náà:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Títọ́jú fọ́ọ̀mù náà
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Fífìdí fọ́ọ̀mù múlẹ̀
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Fọ́ọ̀mù àtúnṣe
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## Ààbò
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## Ó ṣì ku nnkan kan: àkókò láti ṣàgbékalẹ̀!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* Lákọ̀ọ́kọ́, ṣàrídájú kóòdù tuntun rẹ, kí o sì tì í sí GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Lẹ́yìn náà, nínú [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/) kan:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Ní ìparí, lọ sí [ojú-ìwé "Ayélujára"](https://www.pythonanywhere.com/web_app_setup/) náà (lo bọ́tìnnì àkójọ àṣàyàn tó wà ní òkè lápá ọ̀tún console náà) kí o sì tẹ **Reload**. Ṣe ìmúdójúìwọ̀n blog https://subdomain.pythonanywhere.com rẹ láti rí àwọn ìyípadà náà.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/yo-NG/django_installation/README.md b/yo-NG/django_installation/README.md
new file mode 100644
index 00000000000..dc17dd94c80
--- /dev/null
+++ b/yo-NG/django_installation/README.md
@@ -0,0 +1,7 @@
+# Ìṣàgbékalẹ̀ Django
+
+> **Àkíyèsí** Tí o bá n lo Chromebook kan, fojú fo àkòrí yìí kí o sì rí dájú pé o tẹ̀lé àwọn ìtọ́sọ́nà [Àgbékalẹ̀-ètò Chromebook](../chromebook_setup/README.md) náà.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/yo-NG/django_installation/instructions.md b/yo-NG/django_installation/instructions.md
new file mode 100644
index 00000000000..9126eec6b76
--- /dev/null
+++ b/yo-NG/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Apá kan lára abala yìí dá lórí àwọn àlàyé ti Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Apá kan lára abala yìí dá lórí [àlàyé django-marcador](http://django-marcador.keimlink.de/) náà tó ní ìwé-àṣẹ lábẹ́ Creative Commons Attribution-ShareAlike 4.0 International License. Àlàyé django-marcador náà ni ẹ̀tọ́ rẹ̀ jẹ́ ti Markus Zapke-Gründemann et al.
+
+## Àyíká àìrí
+
+Ṣáájú kí a tó ṣàgbékalẹ̀ Django, a ó mú ọ ṣàgbékalẹ̀ irinṣẹ́ kan tó wúlò púpọ̀ láti ṣe ìrànlọ́wọ́ mímú kí àyíká kóòdù kíkọ rẹ wà létòlétò lórí kọ̀mpútà rẹ. Ó ṣeéṣe láti fo ìgbésẹ̀ yìí, ṣùgbọ́n òhun ló dáa jù. Bíbẹ̀rẹ̀ pẹ̀lú àgbékalẹ̀-ètò tó dára jù lọ yíò gbà ọ́ sílẹ̀ lọ́wọ́ ọ̀pọ̀lọpọ̀ wàhálà lọ́jọ́ iwájú!
+
+Nítorí náà, jẹ́ ká ṣẹ̀dá **àyíká àìrí** kan (tí a tún pè ní *virtualenv* kan). Virtualenv yíò ṣe ìpínyà àgbékalẹ̀-ètò Python/Django rẹ lọ́tọ̀ọ̀tọ̀ lórí ìpìlẹ̀ iṣẹ́ kọ̀ọ̀kan. Èyí túmọ̀ sí pé èyíkéyìí ìyípadà tí o bá ṣe sí ààyè ayélujára kan kò ní nípa lórí àwọn mìíràn tí o bá tún n gbé jáde. Ó dáa, àbí bẹ́ẹ̀ kọ?
+
+Gbogbo ohun tí o nílò láti ṣe ni láti wá àkójọpọ̀ fáìlì kan tí o ti fẹ́ ṣẹ̀dá `virtualenv` náà; àkójọpọ̀ fáìlì ìpìlẹ̀ rẹ, fún àpẹẹrẹ. Lórí Windows, ó lè rí bíi `C:\Users\Name` (níbi tí `Name` jẹ́ orúkọ ìwọlé rẹ).
+
+> **ÀKÍYÈSÍ:** Lórí Windows, ri dájú pé àkójọpọ̀ fáìlì yìí kò ní àmì ohùn tàbí àkànṣe ẹyọ ọ̀rọ̀; tí orúkọ aṣàmúlò rẹ bá ní àwọn àmì ohùn, lo àkójọpọ̀ fáìlì mìíràn, fún àpẹẹrẹ, `C:\djangogirls`.
+
+Fún àlàyé yìí, a ó máa lo àkójọpọ̀ fáìlì `djangogirls` tuntun kan láti àkójọpọ̀ fáìlì ìpìlẹ̀ rẹ:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+A ó ṣẹ̀dá virtualenv kan tí a n pè ní `myvenv`. Àṣẹ tí a sábà náà yíò rí báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+Láti ṣẹ̀dá `virtualenv` tuntun kan, o nílò láti ṣí command prompt náà kí o sì ṣe `python -m venv myvenv`. Yíò rí báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Níbi tí `myvenv` jẹ́ orúkọ `virtualenv` rẹ. O lè lo èyíkéyìí orúkọ mìíràn, ṣùgbọ́n dúró lórí lílo lẹ́tà kékeré láìsí àwọn àlàfo, àmì ohùn tàbí àkànṣe ẹyọ ọ̀rọ̀. It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+A lè ṣẹ̀dá `virtualenv` kan lórí Linux àti OS X nípasẹ̀ lílo `python3 -m venv myvenv`. Yíò rí báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` ni orúkọ `virtualenv` rẹ. O lè lo èyíkéyìí orúkọ mìíràn, ṣùgbọ́n dúró lórí lílo lẹ́tà kékeré láìsí àwọn àlàfo. Ó tún jẹ́ èrò tó dára kan láti mú kí orúkọ náà kéré nítorí pé ìwọ yíò ma tọ́ka rẹ̀ lọ́pọ̀ ìgbà!
+
+> **ÀKÍYÈSÍ:** Lórí àwọn ẹyà Debian/Ubuntu kan, o lè rí àṣìṣe tó tẹ̀lé yìí:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> Ní irú ìṣẹ̀lẹ̀ yìí, tẹ̀lé àwọn ìtọ́sọ́nà tó wà lókè kí o sì ṣàgbékalẹ̀ ètò `python3-venv` náà: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **ÀKÍYÈSÍ:** Lórí àwọn ẹyà Debian/Ubuntu kan, bíbẹ̀rẹ̀ àyíká àìrí náà báyìí yíò fúnni ní àṣìṣe tó tẹ̀lé yìí:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> Láti borí àṣìṣe yìí, lo àṣẹ `virtualenv` náà dípò.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **ÀKÍYÈSÍ:** Tí o bá rí àṣìṣe kan bíi
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> ṣe èyí dípò:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## Ìṣiṣẹ́ pẹ̀lú virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Bẹ̀rẹ̀ àyíká àìrí rẹ nípasẹ̀ ṣíṣe:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. Ní irú ìṣẹ̀lẹ̀ yìí, ṣí Windows PowerShell mìíràn pẹ̀lú àṣàyàn "Run as Administrator" (Ṣiṣẹ́ gẹ́gẹ́ bí Alákòóso) náà. Lẹ́yìn náà gbìyànjú títẹ àṣẹ tó tẹ̀le yìí ṣáájú kí o tó bẹ̀rẹ̀ àyíká àìrí rẹ:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Ṣíṣe àgbékalẹ̀ àwọn ètò pẹ̀lú àwọn ohun tí a béèrè fún (requirements)
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/yo-NG/django_models/README.md b/yo-NG/django_models/README.md
new file mode 100644
index 00000000000..c09493dd876
--- /dev/null
+++ b/yo-NG/django_models/README.md
@@ -0,0 +1,201 @@
+# Àwọn àwòṣe Django
+
+Ohun tí a fẹ́ ṣẹ̀dá ní báyìí jẹ́ nnkan kan tí yíò tọ́jú gbogbo àwọn àròkọ tó wà nínú blog wa. Ṣùgbọ́n láti lè ṣe ìyẹn, a nílò láti sọ̀rọ̀ díẹ̀ nípa àwọn nnkan tí a n pè ní `objects` (ohun-èlò).
+
+## Àwọn Ohun-èlò
+
+Ìlànà kan wà nínú kóòdù kíkọ tí a n pè ní `object-oriented programming` (kóòdù kíkọ tó dá lórí ohun-èlò). Èrò náà ni wípé dípò kíkọ gbogbo nnkan bíi ìtòtẹ̀léra àwọn kóòdù tó lè súni kan, a lè ṣe àwòṣe àwọn nnkan kí a sì ṣàlàyé bí wọ́n ṣe máa ṣiṣẹ́ pẹ̀lú ara wọn.
+
+Nítorí náà, kíni ohun-èlò kan? Ó jẹ́ àkójọ àwọn ohun ìdánimọ̀ àti àwọn iṣẹ́ kan. Ó ṣàjèjì, ṣùgbọ́n a ó fún ọ ní àpẹẹrẹ kan.
+
+Tí a bá fẹ́ ṣe àwòṣe ológbò kan, a óò ṣẹ̀dá ohun-èlò `Cat` (Ológbò) kan tó ní àwọn ohun ìdánimọ̀ bíi `color` (àwọ̀), `age` (ọjọ́ orí), `mood` (ìṣesí) (bíi ìdùnnú, ìbànújẹ́, tàbí oorun ;)), àti `owner` (oníǹkan) (èyí tí a lè yàn ohun-èlò `Person` (Ènìyàn) kan – tàbí bóyá, ní ti ológbò tó sọnù kan, ohun ìdánimọ̀ yìí lè jẹ́ òfìfo).
+
+Lẹ́yìn náà, `Cat` (Ológbò) náà ní àwọn iṣẹ́ kan: `purr` (kùn), `scratch` (èékánná híha), tàbí `feed` (oúnje) (ní èyí tí, a óò fún ológbò náà ní `CatFood` (Oúnjẹ Ológbò) kan, èyí tó lè jẹ́ ohun-èlò ọ̀tọ̀ kan pẹ̀lú àwọn ohun ìdánimọ̀, bíi `taste` (ìtọ́wò)).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+Ní pàtàkì, èrò náà ni láti ṣàpèjúwe àwọn nnkan gidi ní kóòdù pẹ̀lú àwọn ohun ìdánimọ̀ (tí a n pè ní `object properties` (àwọn ohun ìdánimọ̀ ohun-èlò)) àti àwọn iṣẹ́ (tí a n pè ní `methods` (ọ̀nà)).
+
+Báwo ni a ṣe máa ṣe àwòṣe àwọn àròkọ blog nígbà náà? A fẹ́ kọ́ blog kan, àbí bẹ́ẹ̀ kọ?
+
+A ní láti dáhùn ìbéèrè: Kíni àròkọ blog kan? Àwọn ohun ìdánimọ̀ wo ló yẹ kó ní?
+
+Ó dáa, ó dájú pé àròkọ blog wa nílò awọn ọ̀rọ̀ kan pẹ̀lú àkóónú rẹ̀ àti àkọlé kan, àbí bẹ́ẹ̀ kọ? Yíò tún dára láti mọ ẹni tó kọ ọ́ – nítorí náà a nílò olùdásílẹ̀ kan. Ní ìparí, a fẹ́ mọ ìgbà tí a ṣẹ̀dá àti ṣàtẹ̀jáde àròkọ náà.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+Kíni irú àwọn nnkan tí a lè ṣe pẹ̀lú àròkọ blog kan? Yíò dára láti ní `method` (ọ̀nà) kan tí yíò ṣàtẹ̀jáde àròkọ náà, àbí bẹ́ẹ̀ kọ?
+
+Nítorí náà a ó nílò ọ̀nà `publish` (tẹ̀jáde) kan.
+
+Nígbà tí a ti mọ ohun tí a fẹ́ ṣe, jẹ́ ká bẹ̀rẹ̀ ṣíṣe àwòṣe rẹ̀ ní Django!
+
+## Àwòṣe Django
+
+Pẹ̀lú mímọ ohun tí ohun-èlò (object) kan jẹ́, a lè ṣẹ̀dá àwòṣe Django kan fún àròkọ blog wa.
+
+Àwòṣe kan ní Django jẹ́ irú ohun-èlò àkànṣe kan – ó gba títọ́jú sínú `database` (àkójọpọ̀ dátà) náà. Àkójọpọ̀ dátà kan jẹ́ àkójọ dátà kan. Èyí jẹ́ ààyè kan tí o ti lè tọ́jú àwọn ìròyìn nípa àwọn aṣàmúlò, àwọn àròkọ blog rẹ, àti bẹ́ẹ̀ bẹ́ẹ̀ lọ. A ó máa lo àkójọpọ̀ dátà SQLite kan láti tọ́jú dátà wa. Èyí jẹ́ ètò àkójọpọ̀ dátà Django ìpìlẹ̀ – yóò tó fún wa ní báyìí.
+
+Ó lè ronú nípa àwòṣe kan nínú àkójọpọ̀ dátà náà gẹ́gẹ́ bíi pẹpẹ ìṣirò (spreadsheet) kan pẹ̀lú àwọn ìlà òòró (ààyè) àti àwọn ìlà ìbú (dátà).
+
+### Ṣíṣẹ̀dá ètò kan
+
+Láti mú kí gbogbo nnkan wà létòlétò, a ó ṣẹ̀dá ètò ọ̀tọ̀ kan sínú iṣẹ́ wa. Ó dára púpọ̀ láti ní gbogbo nnkan létòlétò láti ìbẹ̀rẹ̀pẹ̀pẹ̀. Láti ṣẹ̀dá ètò kan, a nílò láti ṣe àṣẹ tó tẹ̀lé yìí nínú console náà (láti àkójọpọ̀ fáìlì `djangogirls` níbi tí fáìlì `manage.py` wà):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+Ìwọ yíò ṣàkíyèsí pé a ti ṣẹ̀dá àkójọpọ̀ fáìlì `blog` tuntun kan àti pé ó ti ní àwọn fáìlì bíi mélòó kan. Ó yẹ kí àwọn àkójọpọ̀ fáìlì àti àwọn fáìlì inú iṣẹ́ wa rí báyìí:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+Lẹ́yìn ṣíṣẹ̀dá ètò kan, a tún nílò láti sọ fún Django pé ó yẹ kó lò ó. A máa ṣe ìyẹn nínú fáìlì `mysite/settings.py` náà -- ṣí i nínú olóòtú kóòdù rẹ. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. Nítorí náà, ó yẹ kí àbájáde náà rí báyìí:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### Ṣíṣẹ̀dá àwòṣe àròkọ blog kan
+
+Nínú fáìlì `blog/models.py` náà, a máa ṣàlàyé gbogbo àwọn ohun-èlò tí a n pè ní `Models` (Àwọn àwòṣe) – èyí jẹ́ ààyè kan tí a ó ti ṣàlàyé àròkọ blog wa.
+
+Jẹ́ ká ṣí `blog/models.py` nínú olóòtú kóòdù náà, yọ gbogbo nnkan kúrò nínú rẹ̀, kí a sì tẹ kóòdù báyìí:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Rí dájú pé o lo àmì-dáàṣì-ìsàlẹ̀ (`_`) méjì ní ẹ̀gbẹ́ kọ̀ọ̀kan `str`. Ìlànà yìí máa ń jẹ́ lílò lọ́pọ̀ ìgbà ní Python àti pé nígbà mìíràn a tún máa n pè wọ́n ní "dunder" (kékeré fún "double-underscore" (àmì-dáàṣì-ìsàlẹ̀ méjì)).
+
+Ó n dẹ́rù bà ọ́, àbí bẹ́ẹ̀ kọ? Ṣùgbọ́n má dààmú – a ó ṣàlàyé ohun tí àwọn ìlà wọ̀nyí túmọ̀ sí!
+
+Gbogbo àwọn ìlà tó n bẹ̀rẹ̀ pẹ̀lú `from` tàbí `import` jẹ́ àwọn ìlà tó n ṣàfikún àwọn nnkan kan láti àwọn fáìlì mìíràn. Nítorí náà, dípò ṣíṣe àdàkọ àwọn nnkan kannáà nínú gbogbo fáìlì, a lè ṣàfikún àwọn apá kan pẹ̀lú `from ... import ...`.
+
+`class Post(models.Model):` – ìlà yìí yíò ṣàlàyé àwòṣe wa (ó jẹ́ `object` (ohun-èlò) kan).
+
+- `class` jẹ́ àkànṣe ọ̀rọ̀ kan tó fi hàn pé a n ṣàlàyé ohun-èlò kan.
+- `Post` jẹ́ orúkọ àwòṣe wa. A lè fún ní orúkọ mìíràn (ṣùgbọ́n a gbọ́dọ̀ yẹra fún àwọn àkànṣe ẹyọ ọ̀rọ̀ àti lẹ́tà aláàyè). Máa bẹ̀rẹ̀ orúkọ kíláàsì kan pẹ̀lú lẹ́tà-ńlá kan ní gbogbo ìgbà.
+- `models.Model` túmọ̀ sí pé Post (Àròkọ) náà jẹ́ Àwòṣe Django kan, nítorí náà Django mọ̀ wípé ó yẹ kó gba títọ́jú sínú àkójọpọ̀ dátà náà.
+
+Ní báyìí, a ó ṣàlàyé àwọn ohun ìdánimọ̀ tí a tí n sọ̀rọ̀ nípa: `title` (àkọlé), `text` (ọ̀rọ̀), `created_date` (ọjọ́ ṣíṣẹ̀dá), `published_date` (ọjọ́ títẹ̀jáde) and `author` (olùdásílẹ̀). Láti ṣe ìyẹn, a ní láti ṣàlàyé irú ààyè kọ̀ọ̀kan (Ṣé ọ̀rọ̀ ni? Nọ́mbà kan? Ọjọ́ kan? Ìbáṣepọ̀ kan pẹ̀lú ohun-èlò mìíràn, bíi Aṣàmúlò kan?)
+
+- `models.CharField` – báyìí ní o ṣe máa ṣàlàyé ọ̀rọ̀ pẹ̀lú iye àwọn ẹyọ ọ̀rọ̀ tó ní ààlà kan.
+- `models.TextField` – èyí wà fún ọ̀rọ̀ gígùn láìsí ààlà kan. Yíò dára láti lò fún àkóónú àròkọ blog, àbí bẹ́ẹ̀ kọ?
+- `models.DateTimeField` – èyí jẹ́ ọjọ́ àti àkókò kan.
+- `models.ForeignKey` – èyí jẹ́ ìtọ́ka kan sí àwòṣe mìíràn.
+
+A kò ní ṣàlàyé gbogbo kóòdù níbí nítorí pé yíò gba àkókò púpọ̀. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+Kíni nípa `def publish(self):`? Èyí gan-an ni ọ̀nà `publish` (tẹ̀jáde) tí a n sọ̀rọ̀ nípa tẹ́lẹ̀. `def` túmọ̀ sí pé èyí jẹ́ iṣẹ́/ọ̀nà kan àti pé `publish` jẹ́ orúkọ ọ̀nà náà. O lè ṣàyípadà orúkọ ọ̀nà náà tí o bá fẹ́. Òfin orúkọ sísọ náà ní pé a máa lo lẹ́tà kékeré àti àwọn àmì-dáàṣì-ìsàlẹ̀ dípò àwọn àlàfo. Fún àpẹẹrẹ, a lè pe ọ̀nà kan tí yíò ṣe ìṣirò ìpíndọ́gba iye (average price) ní `calculate_average_price`.
+
+Àwọn ọ̀nà sábà máa ń dá nnkan kan padà (`return`). Àpẹẹrẹ bẹ́ẹ̀ wà nínú ọ̀nà `__str__` náà. Ní àpẹẹrẹ yìí, nígbà tí a bá pe `__str__()`, a ó gba ọ̀rọ̀ kan (**string**) pẹ̀lú àkọlé Àròkọ kan.
+
+Tún ṣàkíyèsí pé `def publish(self):` àti `def __str__(self):` ní ìtẹ̀wọnú sínú kíláàsì wa. Nítorí pé lẹ́tà aláàyè nípa nínú Python, a nílò láti ṣe ìtẹ̀wọnú àwọn ọ̀nà wa sínú kíláàsì náà. Bí bẹ́ẹ̀ kọ́, àwọn ọ̀nà náà kò ní jẹ́ ti kíláàsì náà, o sì lè rí àwọn ìhùwàsí àìròtẹ́lẹ̀.
+
+Tí nnkan kan kò bá tíì yé ọ nípa àwọn àwòṣe, má tijú láti béèrè lọ́wọ́ olùkọ́ rẹ! A mọ̀ pé ó ṣòro, pàápàá nígbà tí o bá n kẹ́kọ̀ọ́ nípa ohun tí àwọn ohun-èlò àti àwọn iṣẹ́ jẹ́ lásìkò kannáà. Ṣùgbọ́n a nírètí pé kò dàbí idán lójú ẹ mọ́ báyìí!
+
+### Ṣẹ̀dá àwọn tábìlì fún àwọn àwòṣe nínú àkójọpọ̀ dátà rẹ
+
+Ìgbésẹ̀ ìkẹyìn níbí ni láti ṣàfikún àwòṣe tuntun wa sínú àkójọpọ̀ dátà wa. Lákọ̀ọ́kọ́, a ní láti mú kí Django mọ wípé a ní àwọn ìyípadà kan nínú àwòṣe wa. (A ṣẹ̀ṣẹ̀ ṣẹ̀dá rẹ̀!) Lọ sí fèrèsé console rẹ kí o sì tẹ `python manage.py makemigrations blog`. Yóò rí báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Àkíyèsí:** Rántí láti tọ́jú àwọn fáìlì tí o ṣàtúnṣe náà. Bí bẹ́ẹ̀ kọ́, kọ̀mpútà rẹ yíò ṣiṣẹ́ lórí ẹyà ti tẹ́lẹ̀ náà èyí tó lè fún ọ ní àwọn ìròyìn àṣìṣe láìròtẹ́lẹ̀.
+
+Django ti ṣètò fáìlì migration (ìyípòpadà) kan fún wa tí a ní láti lò sí àkójọpọ̀ dátà wa. Tẹ `python manage.py migrate blog`, tó sì yẹ kí èsì náà rí báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Inú wa dùn! Àwòṣe Post (Àròkọ) wa ti wà nínú àkójọpọ̀ dátà wa! Yíò dára láti rí i, àbí bẹ́ẹ̀ kọ? Fò sí àkòrí tó kàn láti wo bí Post (Àròkọ) rẹ ṣe rí!
\ No newline at end of file
diff --git a/yo-NG/django_orm/README.md b/yo-NG/django_orm/README.md
new file mode 100644
index 00000000000..feeabe4496d
--- /dev/null
+++ b/yo-NG/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM àti QuerySets
+
+Nínú àkòrí yìí, ìwọ yíò kẹ́kọ̀ọ́ bí Django ṣe n sopọ̀ mọ́ àkójọpọ̀ dátà náà àti bí ó ṣe n tọ́jú dátà sínú rẹ̀. Jẹ́ ká bẹ̀rẹ̀!
+
+## Kíni QuerySet kan?
+
+QuerySet kan jẹ́, ní pàtàkì, àkójọ àwọn ohun èlò ti Àwòṣe pàtó kan. QuerySets fún ọ láàyè láti ka dátà tó wà nínú àkójọpọ̀ dátà náà, sẹ́ ẹ àti tò ó lẹ́sẹẹsẹ.
+
+Èyí tó rọrùn jù ní láti kẹ́kọ̀ọ́ pẹ̀lú àpẹẹrẹ. Jẹ́ ká gbìyànjú èyí, ṣé ká bẹ̀rẹ̀?
+
+## Django shell
+
+Ṣí console kọ̀mpútà rẹ kalẹ̀ (kìí ṣe lórí PythonAnywhere) kí o sì tẹ àṣẹ yìí:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+Ó yẹ kí àbájáde náà rí báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+O ti wà nínú console ìjọṣepọ̀ ti Django ní báyìí. Ó rí bíi prompt Python náà, ṣùgbọ́n pẹ̀lú àwọn iṣẹ́ Django mìíràn. :) O lè lo gbogbo àwọn àṣẹ Python náà níbí yìí.
+
+### Gbogbo àwọn ohun èlò
+
+Jẹ́ ká gbìyànjú láti kọ́kọ́ ṣàfihàn gbogbo àwọn àròkọ wa. O lè ṣe ìyẹn pẹ̀lú àṣẹ tó tẹ̀le yìí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! Àṣìṣe kan ló fojú hàn. Ó n sọ fún wa pé kò sí Post. Òtítọ́ ni – a ti gbàgbé láti kọ́kọ́ ṣàgbéwọlé rẹ̀!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+A ṣàgbéwọlé àwòṣe `Post` náà láti `blog.models`. Jẹ́ ká gbìyànjú ṣíṣe àfihàn gbogbo àwọn àròkọ lẹ́ẹ̀kan si:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+Èyí jẹ́ àkójọ àwọn àròkọ tí a ti ṣẹ̀dá ṣáájú! A ṣẹ̀dá àwọn àròkọ wọ̀nyí pẹ̀lú lílo atọ́kùn alábòójútó Django náà. Ṣùgbọ́n ní báyìí, a fẹ́ ṣẹ̀dá àwọn àròkọ tuntun pẹ̀lú lílo Python, nítorí náà báwo la ṣe máa ṣe ìyẹn?
+
+### Ṣẹ̀dá ohun èlò
+
+Báyìí ní o ṣe máa ṣẹ̀dá ohun èlò Post tuntun kan nínú àkójọpọ̀ dátà:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Ṣùgbọ́n a ṣì pàdánù èròjà kan níbí: `me`. A nílò láti darí àpẹẹrẹ kan ti àwòṣe `User` gẹ́gẹ́ bí olùdásílẹ̀ kan. Báwo la ṣe máa ṣe ìyẹn?
+
+Jẹ́ ká kọ́kọ́ ṣàgbéwọlé àwòṣe User:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+Àwọn aṣàmúlò wo la ní nínú àkójọpọ̀ dátà wa? Gbìyànjú èyí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+Èyí ni alábòójútó tí a ti ṣẹ̀dá ṣáájú! Jẹ́ ká gba àpẹẹrẹ kan ti aṣàmúlò náà ni báyìí (ṣàtúnṣe ìlà yìí láti lo orúkọ aṣàmúlò tìẹ):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+Gẹ́gẹ́ bó o ṣe ríi, a gba (`get`) `User` kan pẹ̀lú `username` tó dọ́gba pẹ̀lú 'ola'. Ó dára!
+
+Ní báyìí, a lè wá ṣẹ̀dá àròkọ wa:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+Inú wa dùn! Ṣé o fẹ́ ṣàyẹ̀wò bóyá ó ti ṣiṣẹ́?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Òhun nìyẹn, àròkọ kan síi nínú àkójọ náà!
+
+### Ṣàfikún àwọn àròkọ síi
+
+O lè wá ṣeré díẹ̀ báyìí kí o ṣàfikún àwọn àròkọ síi láti wo bó ṣe n ṣiṣẹ́. Ṣàfikún bíi méjì àbí mẹ́ta síi, lẹ́yìn náà tẹ̀síwájú sí apá tó kàn náà.
+
+### Sẹ́ àwọn ohun èlò
+
+Apá kan tó ṣe pàtàkì nínú QuerySets ni ìkápá láti sẹ́ wọn. Jẹ́ ká sọ pé a fẹ́ wá gbogbo àwọn àròkọ tí aṣàmúlò ola jẹ́ olùdásílẹ̀ fún. A ó lo `filter` dípò `all` nínú `Post.objects.all()`. Nínú àkámọ́, a sọ irú ipò (àwọn ipò) tí àròkọ blog kan gbọ́dọ̀ ní láti wà nínú queryset wa. Ní ìṣẹ̀lẹ̀ tiwa, ipò náà ni pé `author` ní láti dọ́gba pẹ̀lú `me`. Bí a ṣe máa kọ́ ní Django jẹ́ `author=me`. Ní báyìí, abala kóòdù wa yíò rí báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Tàbí bóyá a fẹ́ rí gbogbo àwọn àròkọ tó ní ọ̀rọ̀ 'title' nínú ààyè `title` náà?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **Ṣàkíyèsí** Àwọn àmì-dáàṣì-ìsàlẹ̀ (`_`) méjì ló wà láàrín `title` àti `contains`. ORM ti Django máa n lo òfin yìí láti fi ìyàtọ̀ sí àárín àwọn orúkọ ààyè ("title") àti àwọn iṣẹ́ tàbí asẹ́ ("contains"). Tí o bá lo àmì-dáàṣì-ìsàlẹ̀ kan ṣoṣo, ìwọ yíò rí àṣìṣe kan bíi "FieldError: Cannot resolve keyword title_contains".
+
+O tún lè gba àkójọ kan ti gbogbo àwọn àròkọ tí a ti ṣàtẹ̀jáde. A máa ṣe èyí nípasẹ̀ sísẹ́ gbogbo àwọn àròkọ tó bá ní ọjọ́ ìtẹ̀jáde, `published_date`, tẹ́lẹ̀tẹ́lẹ̀:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Ó bani nínú jẹ́ pé, a kò tíì ṣàtẹ̀jáde àròkọ tí a ṣàfikún láti console Python náà. Ṣùgbọ́n a lè yí ìyẹn padà! Kọ́kọ́ gba àpẹẹrẹ kan ti àròkọ tí a fẹ́ ṣàtẹ̀jáde kan:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+Lẹ́yìn náà, ṣàtẹ̀jáde rẹ̀ pẹ̀lú ọ̀nà `publish` wa:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Ní báyìí, gbìyànjú láti gba àkójọ àwọn àròkọ tí a ti ṣàtẹ̀jáde lẹ́ẹ̀kan síi (tẹ bọ́tìnnì ìtọ́ka òkè náà lẹ́ẹ̀mẹ́ta kí o sì tẹ `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### Títo àwọn ohun èlò lẹ́sẹẹsẹ
+
+QuerySets tún gbà ọ́ láàyè láti to àkójọ àwọn ohun èlò náà lẹ́sẹẹsẹ. Jẹ́ ká gbìyànjú láti tò wọ́n pẹ̀lú ààyè `created_date`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+A tún lè yí títò náà padà pẹ̀lú ṣíṣe àfikún `-` ní ìbẹ̀rẹ̀:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Àwọn ìbéèrè tó ṣòro nípasẹ̀ ṣíṣe ìsopọ̀ ọ̀nà
+
+Gẹ́gẹ́ bó ti rí i, àwọn ọ̀nà kan lórí `Post.objects` dá QuerySet kan padà. Àwọn ọ̀nà kannáà tún lè jẹ́ pípè lórí QuerySet kan, tí yíò sì dá QuerySet tuntun kan padà. Nítorí náà, o lè ṣàkópọ̀ àbájáde wọn nípasẹ̀ **ṣíṣe ìsopọ̀** wọn papọ̀:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+Èyí lágbára púpọ̀ àti pé yóò jẹ́ kí o kọ àwọn ìbéèrè tó ṣòro gan-an.
+
+Ó dára! O ti ṣetán báyìí fún apá tó kàn náà! Láti pa shell náà dé, tẹ èyí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/yo-NG/django_start_project/README.md b/yo-NG/django_start_project/README.md
new file mode 100644
index 00000000000..04fcd5de112
--- /dev/null
+++ b/yo-NG/django_start_project/README.md
@@ -0,0 +1,260 @@
+# Iṣẹ́ Django àkọ́kọ́ rẹ!
+
+> Apá kan lára àkòrí yìí dá lórí àwọn àlàyé ti Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Àwọn apá kan lára àkòrí yìí dá lórí [àlàyé django-marcador](http://django-marcador.keimlink.de/) náà tó ní ìwé-àṣẹ lábẹ́ Creative Commons Attribution-ShareAlike 4.0 International License. Àlàyé django-marcador náà ni ẹ̀tọ́ rẹ̀ jẹ́ ti Markus Zapke-Gründemann et al.
+
+A óò ṣẹ̀dá blog kékeré kan!
+
+Ìgbésẹ̀ àkọ́kọ́ ni láti bẹ̀rẹ̀ iṣẹ́ Django tuntun kan. Ní pàtàkì, èyí túmọ̀ sí pé a ó lo àwọn ìlànà ìṣe (script) kan tí Django pèsè tí yíò ṣẹ̀dá ìgbékalẹ̀ ti iṣé Django kan fún wa. Èyí wulẹ̀ jẹ́ àpapọ̀ àkójọpọ̀ fáìlì àti àwọn fáìlì kan tí a ó lò tó bá yá.
+
+Orúkọ àwọn fáìlì àti àkójọpọ̀ fáìlì kan ṣe pàtàkì gan-an fún Django. Ìwọ kò gbọ́dọ̀ ṣàtúnṣe orúkọ àwọn fáìlì tí a fẹ́ ṣẹ̀dá náà. Gbígbé wọn sí ibi tó yàtọ̀ kan kìí tún ṣe èrò tó dára kan. Django nílò láti máa ní ìgbékalẹ̀ pàtó kan láti lè rí àwọn nnkan pàtàkì.
+
+> Rántí láti ṣe gbogbo nnkan nínú virtualenv náà. Tí ìwọ kò bá rí `(myvenv)` níbẹ̀rẹ̀ nínú console rẹ, o nílò láti mú virtualenv rẹ ṣiṣẹ́. A ti ṣàlàyé bí o ṣe lè ṣe ìyẹn nínú àkòrí **Ìṣàgbékalẹ̀ Django** ní apá **Ìṣiṣẹ́ pẹ̀lú virtualenv** náà. Títẹ `myvenv\Scripts\activate` lórí Windows tàbí `source myvenv/bin/activate` lórí Mac OS X tàbí Linux yíò ṣe èyí fún ọ.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+Nínú console Mac OS X tàbí Linux rẹ, ó yẹ kí o ṣe àṣẹ tó tẹ̀le yìí. **Má gbàgbé láti ṣàfikún àmì tó-ín `.` náà ní ìparí!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> Àmì tó-ín `.` náà ṣe pàtàkì nítorí pé yíò sọ fún ìlànà ìṣe (script) náà láti ṣàgbékalẹ̀ Django sínú àkójọpọ̀ fáìlì tí o wà lọ́wọ́lọ́wọ́ (fún èyí tí àmì tó-ín `.` náà jẹ́ ìtọ́kasí tí a gé kúrú kan).
+> 
+> **Àkíyèsí** Nígbà tí o bá n tẹ àṣẹ tó wà lókè náà, rántí pé apá tó bẹ̀rẹ̀ pẹ̀lú `django-admin` nìkan ni o ma tẹ̀. Apá `(myvenv) ~/djangogirls$` náà tí a ṣàfihàn níbí wulẹ̀ jẹ́ àpẹẹrẹ prompt náà tí yíò ma dúró de ohun tí o fẹ́ tẹ̀ sórí ìlà ìpàṣẹ rẹ.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+Lórí Windows, ó yẹ kí o ṣe àṣẹ tó tẹ̀le yìí. **(Má gbàgbé láti ṣàfikún àmì tó-ín `.` náà ní ìparí)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> Àmì tó-ín `.` náà ṣe pàtàkì nítorí pé yíò sọ fún ìlànà ìṣe (script) náà láti ṣàgbékalẹ̀ Django sínú àkójọpọ̀ fáìlì tí o wà lọ́wọ́lọ́wọ́ (fún èyí tí àmì tó-ín `.` náà jẹ́ ìtọ́kasí tí a gé kúrú kan).
+> 
+> **Àkíyèsí** Nígbà tí o bá n tẹ àṣẹ tó wà lókè náà, rántí pé apá tó bẹ̀rẹ̀ pẹ̀lú `django-admin.exe` nìkan ni o ma tẹ. Apá `(myvenv) C:\Users\Name\djangogirls>` náà tí a ṣàfihàn níbí wulẹ̀ jẹ́ àpẹẹrẹ prompt náà tí yíò ma dúró de ohun tí o fẹ́ tẹ̀ sórí ìlà ìpàṣẹ rẹ.
+
+<!--endsec-->
+
+`django-admin.py` jẹ́ ìlànà ìṣe (script) kan tí yíò ṣẹ̀dá àwọn àkójọpọ̀ fáìlì àti àwọn fáìlì náà fún ọ. Ó yẹ kí o ní ìgbékalẹ̀ àkójọpọ̀ fáìlì kan tó rí báyìí:
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Àkíyèsí**: nínú ìgbékalẹ̀ àkójọpọ̀ fáìlì rẹ, ìwọ yíò tún rí àkójọpọ̀ fáìlì `venv` rẹ tí a ti ṣẹ̀dá ṣáájú.
+
+`manage.py` jẹ́ ìlànà ìṣe (script) kan tí yíò ṣe ìrànlọ́wọ́ pẹ̀lú ìṣàkóso ààyè náà. Pẹ̀lú rẹ̀, a ó lè (láàrín àwọn nnkan mìíràn) bẹ̀rẹ̀ server ayélujára kan lórí kọ̀mpútà wa láìsí ṣíṣe àgbékalẹ̀ ohunkóhun mìíràn.
+
+Fáìlì `settings.py` náà yíò ní ìṣètò ààyè ayélujára rẹ.
+
+Rántí ìgbà tí a sọ̀rọ̀ nípa òṣìṣẹ́ méèlì kan tó n ṣàyẹ̀wò ibi tí yíò fi lẹ́tà kan jíṣẹ́ sí? Fáìlì `urls.py` yíò ní àkójọ àwọn àpẹẹrẹ kan tó n jẹ́ lílò nípasẹ̀ `urlresolver`.
+
+Jẹ́ ká fojú fo àwọn fáìlì yòókù náà nítorí pé a kò ní ṣàyípadà wọn. Ohun kan ṣoṣo láti rántí ni kí o má ṣèèṣì yọ wọ́n kúrò!
+
+## Ṣíṣe ìyípadà àwọn ìṣètò
+
+Jẹ́ ká ṣe àwọn ìyípadà kan nínú `mysite/settings.py`. Ṣí fáìlì náà pẹ̀lú lílo olóòtú kóòdù tí o ti ṣàgbékalẹ̀ ṣáájú.
+
+**Àkíyèsí**: Fi sọ́kàn pé `settings.py` jẹ́ fáìlì déédéé kan, bíi èyíkéyìí mìíràn. O lè ṣí i láti inú olóòtú kóòdù náà, pẹ̀lú lílo àwọn iṣẹ́ àkójọ àṣàyàn "file -> open" (fáìlì -> ṣí) náà. Ó yẹ kí èyí ṣàfihàn fèrèsé tí o sábà náà tí o ti lè lọ sí fáìlì `settings.py` rẹ kí o sì yàn níbẹ̀. Lọ́nà mìíràn, o lè ṣí fáìlì náà nípasẹ̀ lílọ sí fódà djangogirls náà lórí desktop rẹ kí o sì tẹ bọ́tìnnì atọ́ka ọ̀tún lórí rẹ̀. Lẹ́yìn náà, yan olóòtú kóòdù rẹ lára àkójọ náà. Yíyan olóòtú náà ṣe pàtàkì nítorí pé o lè ní àwọn ètò mìíràn tó lè ṣí fáìlì náà ṣùgbọ́n tí kò ní jẹ́ kí o ṣàtúnṣe rẹ̀.
+
+Yíò dára láti ní àkókò tó tọ́ lórí ààyè ayélujára wa. Lọ sí [Àkọsílẹ̀ àwọn agbègbè àkókò ti Wikipedia](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) kí o sì ṣe àdàkọ agbègbè àkókò tó yẹ fún ọ (TZ) (fún àpẹẹrẹ `Africa/Lagos`).
+
+Nínú `settings.py`, wá ìlà tó ní `TIME_ZONE` kí o ṣàtúnṣe rẹ̀ láti yan agbègbè àkókò tìẹ. Fún àpẹẹrẹ:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Africa/Lagos'
+```
+
+Kóòdù èdè kan ma ní èdè náà, fún àpẹẹrẹ `en` fún Gẹ̀ẹ́sì tàbí `yo` fún Yorùbá, àti kóòdù orílẹ̀-èdè náà, fún àpẹẹrẹ `de` fún Jámánì tàbí `ng` fún Nàìjíríà. Tí Gẹ̀ẹ́sì kìí ba ṣe èdè abínibí rẹ, o lè ṣàfikún èyí láti ṣàyípadà àwọn bọ́tìnnì ìpìlẹ̀ àti àwọn ìpàkíyèsí láti Django kó wà ní èdè rẹ. Nítorí náà, ìwọ yíò ní bọ́tìnnì "Cancel" (Fagi lé) tí a túmọ̀ sí èdè tí o yàn níbí. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+Tí o bá fẹ́ èdè mìíràn kan, ṣàyípadà kóòdù èdè náà nípasẹ̀ ṣíṣe ìyípadà ìlà tó tẹ̀lé yìí:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+A ó tún nílò láti ṣàfikún atọ́nà kan fún àwọn fáìlì tó wà lójú kan (static files). (A ó ṣèwádìí gbogbo nnkan nípa àwọn fáìlì tó wà lójú kan (static files) àti CSS tó bá yá nínú àlàyé náà.) Lọ sí ìsàlẹ̀ ní *ìparí* fáìlì náà, lábẹ́ ìgbéwọlé `STATIC_URL` náà, ṣàfikún ìgbéwọlé tuntun kan tí a n pè ní `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+Nígbà tí `DEBUG` bá jẹ́ `True` tí `ALLOWED_HOSTS` sì jẹ́ òfìfo, olùpèsè náà ma ṣiṣẹ́ lórí `['localhost', '127.0.0.1', '[::1]']`. Èyí kò ní dọ́gba pẹ̀lú orúkọ olùpèsè (hostname) wa lórí PythonAnywhere nígbà tí a bá ṣàgbékalẹ̀ ètò wa, nítorí náà, a ó ṣàyípadà ìṣèto tó tẹ̀le yìí:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Àkíyèsí**: Tí o bá n lo Chromebook kan, ṣàfikún ìlà yìí nísàlẹ̀ fáìlì settings.py rẹ: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Tún ṣàfikún `.amazonaws.com` sí `ALLOWED_HOSTS` náà tí o bá n lo cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Ṣàgbékalẹ̀ àkójọpọ̀ dátà kan
+
+Oríṣiríṣi ètò àkójọpọ̀ dátà ló wà tó lè tọ́jú dátà fún ààyè rẹ. A ó lo ti ìpìlẹ̀ náà, `sqlite3`.
+
+Èyí ti wà ní àgbékalẹ̀ tẹ́lẹ̀ nínú apá yìí ti fáìlì `mysite/settings.py` rẹ:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+Láti ṣẹ̀dá àkójọpọ̀ dátà kan fún blog wa, jẹ́ ká ṣe èyí nínú console náà: `python manage.py migrate` (a nílò láti wà nínú àkójọpọ̀ fáìlì `djangogirls` tó kó fáìlì `manage.py` náà sínú). Tí ìyẹn bá ń lọ bí ó ti yẹ, ó yẹ kí o rí nnkan kan báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+Àti pé a ti parí! Àkókò láti bẹ̀rẹ̀ server ayélujára náà àti ṣàyẹ̀wò tí ààyè ayélujára wa bá n ṣiṣẹ́!
+
+## Bíbẹ̀rẹ̀ server ayélujára náà
+
+O nílò láti wà nínú àkójọpọ̀ fáìlì tó kó fáìlì `manage.py` náà sínú (àkójọpọ̀ fáìlì `djangogirls` náà). Nínú console náà, a lè bẹ̀rẹ̀ server ayélujára náà nípasẹ̀ ṣíṣe `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+Tí o bá wà lórí Chromebook kan, lo àṣẹ yìí dípò:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> A ti ṣàgbéyẹ̀wò bí àwọn server ayélujára ṣé n ṣiṣẹ́ nínú àkòrí **Bí Íńtánẹ́ẹ̀tì ṣé n ṣiṣẹ́** náà.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/yo-NG/django_templates/README.md b/yo-NG/django_templates/README.md
new file mode 100644
index 00000000000..4f7d3f6496e
--- /dev/null
+++ b/yo-NG/django_templates/README.md
@@ -0,0 +1,108 @@
+# Àwọn àwòṣe (template) Django
+
+Àkókò láti ṣàfihàn àwọn dátà kan! Django fún wa ní **àwọn àmì àwòṣe** (template tags) tó wúlò fún ìyẹn.
+
+## Kíni àwọn àmì àwòṣe?
+
+Wòó, nínú HTML, ìwọ kò lè kọ kóòdù Python, nítorí pé àwọn aṣàwákiri kò loye rẹ̀. Wọ́n mọ HTML nìkan. A sì mọ̀ pé HTML má n wà lójú kan, nígbà tí Python má n ṣiṣẹ́.
+
+**Àwọn àmì àwòṣe Django** fún wa láàyè láti gbé àwọn nnkan tó jẹ́ mọ́ Python sínú HTML, kó o bàa lè yára kọ́ àwọn ààyè ayélujára tó n ṣiṣẹ́. Ó dára!
+
+## Ṣàfihàn àwòṣe àkójọ àròkọ
+
+Nínú àkòrí tó ṣáájú náà, a fún àwòṣe wa ní àkójọ àwọn àròkọ kan nínú variable `posts` náà. Ní báyìí, a ó ṣàfihàn rẹ̀ nínú HTML.
+
+Láti ṣàtẹ̀jáde variable kan nínú àwọn àwòṣe Django, a ma lo àkámọ́ onídodo méjì pẹ̀lú orúkọ variable náà nínú rẹ̀, báyìí:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Gbìyànjú èyí nínú àwòṣe `blog/templates/blog/post_list.html` rẹ. Ṣí i sílẹ̀ nínú olóòtú kóòdù náà, kí o sì rọ́pò gbogbo nnkan láti `<div>` kejì sí `</div>` kẹta pẹ̀lú `{{ posts }}`. Tọ́jú fáìlì náà, kí o sì ṣe ìmúdójúìwọ̀n ojú-ìwé náà láti rí àbájáde náà:
+
+![Figure 13.1](images/step1.png)
+
+Gẹ́gẹ́ bó o ṣe ríi, gbogbo ohun tí a ní ni èyí:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+Èyí túmọ̀ sí pé Django lóye rẹ̀ gẹ́gẹ́ bí àkójọ àwọn ohun-èlò kan. Rántí láti **Ìfihàn sí Python** bí a ṣe lè ṣàfihàn àwọn àkójọ? Bẹ́ẹ̀ni, pẹ̀lú for loops! Nínú àwòṣe Django kan, wàá ṣe wọ́n báyìí:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Gbìyànjú èyí nínú àwòṣe rẹ.
+
+![Figure 13.2](images/step2.png)
+
+Ó n ṣiṣẹ́! Ṣùgbọ́n a fẹ́ kí àwọn àròkọ náà gba ìfihàn gẹ́gẹ́ bí àwọn àròkọ tó wà lójú kan tí a ti ṣẹ̀dá ṣáájú nínú àkòrí **Ìfihàn sí HTML** náà. O lè da HTML àti àwọn àmì àwòṣe papọ̀. `body` wa yíò rí báyìí:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %} Gbogbo nnkan tí o bá fi sí àárín `{% for %}` àti `{% endfor %}` yíò máa jẹ́ ṣíṣe fún ohun-èlò kọ̀ọ̀kan nínú àkójọ náà. Ṣe ìmúdójúìwọ̀n ojú-ìwé rẹ:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Ṣe o ti ṣàkíyèsí pé a lo àkọsílẹ̀ tó yàtọ̀ díẹ̀ lọ́tẹ̀ yìí (`{{ post.title }}` tàbí `{{ post.text }}`)? A ń lo dátà tó wà nínú ọ̀kọ̀ọ̀kan àwọn ààyè tí a ṣàlàyé nínú àwòṣe `Post` wa. Àti pé, `|linebreaksbr` náà n mú ọ̀rọ̀ àwọn àròkọ náà gba asẹ́ kan kọjá láti ṣàyípadà àwọn ìdá ìlà (line-breaks) sí ìpínrọ̀ (paragraphs).
+
+## Ó ṣì ku nnkan kan
+
+Yóò dára láti ṣàyẹ̀wò bóyá ààyè ayélujára rẹ ṣì máa ṣiṣẹ́ lórí Íńtánẹ́ẹ̀tì gbangba náà, àbí bẹ́ẹ̀ kọ? Jẹ́ ká gbìyànjú ṣíṣe àgbékalẹ̀ sí PythonAnywhere lẹ́ẹ̀kan si. Àwọn ìgbésẹ̀ náà ní ṣókí nìyí…
+
+* Lákọ̀ọ́kọ́, ti kóòdù rẹ sí GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Lẹ́yìn náà, wọlé padà sí [PythonAnywhere](https://www.pythonanywhere.com/consoles/) kí o lọ sí **Bash console** rẹ (tàbí bẹ̀rẹ̀ tuntun kan), àti ṣe:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Rántí láti rọ́pò `<your-pythonanywhere-domain>` pẹ̀lú subdomain PythonAnywhere rẹ, láìsí àwọn àkámọ́ onígun náà.)
+
+* Ní ìparí, lọ sí [ojú-ìwé "Ayélujára"](https://www.pythonanywhere.com/web_app_setup/) náà kí o sì tẹ **Reload** lórí ètò ayélujára rẹ. (Láti dé àwọn ojú-ìwé PythonAnywhere mìíràn láti console náà, lo bọ́tìnnì àkójọ àṣàyàn náà ní igun òkè lápá ọ̀tún.) Ó yẹ kí ìmúdójúìwọ̀n rẹ ti máa ṣiṣẹ́ lórí https://subdomain.pythonanywhere.com -- ṣàyẹ̀wò rẹ̀ nínú aṣàwákiri náà! Tí àwọn àròkọ blog lórí ààyè PythonAnywhere rẹ kò bá dọ́gba pẹ̀lú àwọn àròkọ tó wà lórí blog tí o pèsè lórí server kọ̀mpútà rẹ, kò sóhun tó burú níbẹ̀. Àwọn àkójọpọ̀ dátà tó wà lórí kọ̀mpútà tìẹ àti Python Anywhere kò ní ìbádọ́gba pẹ̀lú àwọn fáìlì rẹ yòókù.
+
+Kú oríire! Ní báyìí, tẹ̀síwájú kí o gbìyànjú ṣíṣe àfikún àròkọ tuntun kan sínú alábòójútó Django rẹ (rántí láti ṣàfikún published_date! (ọjọ́ ìtẹ̀jáde)) Rí dájú pé o wà nínú alábòójútó Django náà fún ààyè pythonanywhere rẹ, https://subdomain.pythonanywhere.com/admin. Lẹ́yìn náà, ṣe ìmúdójúìwọ̀n ojú-ìwé rẹ láti ṣàyẹ̀wò bóyá àròkọ náà máa hàn níbẹ̀.
+
+Ó n ṣiṣẹ́ bíi oògùn kan? Inú wa dùn! kúrò níbi kọ̀mpútà rẹ fún ìgbà díẹ̀ – o lè sinmi báyìí. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/yo-NG/django_urls/README.md b/yo-NG/django_urls/README.md
new file mode 100644
index 00000000000..91322659cb1
--- /dev/null
+++ b/yo-NG/django_urls/README.md
@@ -0,0 +1,103 @@
+# Àwọn URL Django
+
+A ti fẹ́ kọ́ ojú-ìwé ayélujára àkọ́kọ́ wa: ojú-ìwé ìbẹ̀rẹ̀ kan fún blog wa! Ṣùgbọ́n lákọ̀ọ́kọ́ ná, jẹ́ ká kẹ́kọ̀ọ́ díẹ̀ nípa àwọn URL Django.
+
+## Kíni URL kan?
+
+URL kan jẹ́ àdírẹ́ẹ̀sì ayélujára kan. O lè rí URL kan ní gbogbo ìgbà tí o bá ṣèbẹ̀wò ààyè ayélujára kan – ó fojú hàn nínú pẹpẹ àdírẹ́ẹ̀sì ti aṣàwákiri rẹ. (Bẹ́ẹ̀ ni! `127.0.0.1:8000` jẹ́ URL kan! Àti pé `https://djangogirls.org` tún jẹ́ URL kan.)
+
+![URL](images/url.png)
+
+Gbogbo ojú-ìwé lórí Íńtánẹ́ẹ̀tì náà ló nílò URL tirẹ̀. Lọ́nà yìí, ètò rẹ yíò mọ ohun tó yẹ kó gbé jáde fún aṣàmúlò kan tó bá ṣí URL yẹn. Ní Django, a máa n lo nnkan kan tí a n pè ní `URLconf` (URL configuration - ìṣètò URL). URLconf jẹ́ àpapọ̀ àwọn àpẹẹrẹ kan tí Django yíò gbìyànjú láti báramu pẹ̀lú URL tí a béèrè fún náà láti wá ohun tó tọ́ láti ṣàfihàn.
+
+## Báwo ni àwọn URL ṣé n ṣiṣẹ́ ní Django?
+
+Jẹ́ ká ṣí fáìlì `mysite/urls.py` náà sílẹ̀ nínú olóòtú kóòdù tó wù ẹ kí a wo bó ṣe rí:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+Gẹ́gẹ́ bó o ṣe ríi, Django ti gbé nnkan kan síbí fún wa tẹ́lẹ̀.
+
+Àwọn ìlà tó wà láàrín àwọn àmì àyọlò mẹ́ta (`'''` or `"""`) ní a n pè ní docstrings – o lè kọ wọ́n sókè fáìlì, kíláàsì tàbí ọ̀nà kan láti ṣàpèjúwe ohun tó n ṣe. Wọn kò ní jẹ́ ṣíṣe nípasẹ̀ Python.
+
+URL alábòójútó náà, èyí tí o ṣèbẹ̀wò sí nínú àkòrí tó ṣáájú náà, tí wà níbí:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+Ìlà yìí túmọ̀ sí pé fún gbogbo URL tó bá bẹ̀rẹ̀ pẹ̀lú `admin/`, Django yíò wá *view* tó bá á mu kan. Ní irú ìṣẹ̀lẹ̀ yìí, a n ṣàfikún ọ̀pọ̀lọpọ̀ àwọn URL alábòójútó kí a má bàa kó gbogbo rẹ̀ sínú fáìlì kékeré yìí – ó ṣeé kà dáadáa ó sì wà létòlétò.
+
+## URL Django àkọ́kọ́ rẹ!
+
+Àkókò láti ṣẹ̀dá URL àkọ́kọ́ wa! A fẹ́ kí 'http://127.0.0.1:8000/' jẹ́ ojú-ìwé ìbẹ̀rẹ̀ ti blog wa kó sì ṣàfihàn àkójọ àwọn àròkọ kan.
+
+A tún fẹ́ mú fáìlì `mysite/urls.py` náà wà létòlétò, nítorí náà a máa ṣàgbéwọlé àwọn URL láti ètò `blog` wa sí fáìlì `mysite/urls.py` gangan náà.
+
+Tẹ̀síwájú, ṣàfikún ìlà kan tí yíò ṣàgbéwọlé `blog.urls`. Ìwọ yíò tún nílò láti ṣàyípadà ìlà `from django.urls…` náà nítorí pé a n lo iṣẹ́ `include` náà níbí, nítorí náà ìwọ yíò nílò láti ṣàfikún àgbéwọlé yẹn sí ìlà náà.
+
+Ó yẹ kí fáìlì `mysite/urls.py` rẹ rí báyìí:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django yíò máa darí gbogbo nnkan tó bá wá sínú 'http://127.0.0.1:8000/' padà sí `blog.urls` tí yíò sì máa wá àwọn ìtọ́sọ́nà míì níbẹ̀.
+
+## blog.urls
+
+Ṣẹ̀dá fáìlì òfìfo tuntun kan tó ń jẹ́ `urls.py` nínú àkójọpọ̀ fáìlì `blog` náà, kí o sì ṣí nínú olóòtú kóòdù náà. Ó dáa! Ṣàfikún àwọn ìlà méjì àkọ́kọ́ wọ̀nyí:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Níbí yìí, a n ṣàgbéwọlé iṣẹ́ `path` ti Django àti gbogbo `views` wa láti ètò `blog` náà. (A kò tíì ní èyíkéyìí, ṣùgbọ́n a óò débẹ̀ láàárín ìṣẹ́jú kan!)
+
+Lẹ́yìn ìyẹn, a lè ṣàfikún àpẹẹrẹ URL àkọ́kọ́ wa:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+Gẹ́gẹ́ bó o ṣe ríi, a tí n yan `view` kan tí a n pè ní `post_list` sí URL ìpìlẹ̀ náà báyìí. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. Àpẹẹrẹ yìí yíò sọ fún Django pé `views.post_list` jẹ́ ààyè tó tọ́ láti lọ tí ẹnìkan bá wọ inú ààyè ayélujára rẹ láti àdírẹ́ẹ̀sì 'http://127.0.0.1:8000/' náà.
+
+Apá ìkẹhìn náà, `name='post_list'`, jẹ́ orúkọ URL náà tí yíò máa jẹ́ lílò láti dá view náà mọ̀. Èyí lè jẹ́ bákannáà pẹ̀lú orúkọ view náà ṣùgbọ́n ó tún lè jẹ́ nnkan kan tó yàtọ̀ pátápátá. A ó máa lo àwọn URL tí a fún lórúko tó bá yá nínú iṣé náà, nítorí náà ó ṣe pàtàkì láti fún URL kọ̀ọ̀kan tó wà nínú ètò náà lórúko. Ó yẹ ká tún gbìyànjú láti mú kí orúkọ àwọn URL náà jẹ́ àkànṣe kó sì rọrùn láti rántí.
+
+Tí o bá gbìyànjú láti ṣèbẹ̀wò http://127.0.0.1:8000/ ní báyìí, ìwọ yíò rí oríṣi àwọn ìròyìn 'ojú-ìwé ayélujára kò sí lárọ̀ọ́wọ́tó' kan. Èyí jẹ́ nítorí pé server náà (rántí títẹ `runserver`?) kò ṣiṣẹ́ mọ́. Ṣàyẹ̀wò fèrèsé console server rẹ láti ṣèwádìí ohun tó fà á.
+
+![Àṣìṣe](images/error1.png)
+
+Console rẹ n ṣàfihàn àṣìṣe kan, ṣùgbọ́n má dààmú – ó wúlò púpọ̀ gan-an: ó n sọ fún ọ pé **no attribute 'post_list'**. Ìyẹn jẹ́ orúkọ *view* tí Django n gbìyànjú láti ṣàwárí fún lílò, ṣùgbọ́n a kò tíì ṣẹ̀dá rẹ̀. Níbi tí a dé yìí, `/admin/` rẹ kò tún ní ṣiṣẹ́. Kò sí ìdààmú – a ó dé ibẹ̀. Tí o bá rí ìròyìn àṣìṣe tó yàtọ̀ kan, gbìyànjú láti tún server ayélujára rẹ bẹ̀rẹ̀. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/yo-NG/django_views/README.md b/yo-NG/django_views/README.md
new file mode 100644
index 00000000000..8f488455575
--- /dev/null
+++ b/yo-NG/django_views/README.md
@@ -0,0 +1,44 @@
+# Àwọn view ti Django – àkókò láti ṣẹ̀dá!
+
+Àkókò láti mú àṣìṣe tí a ṣẹ̀dá nínú àkòrí tó ṣáájú náà kúrò! :)
+
+*View* jẹ́ ààyè kan tí a fi "ọgbọ́n" ètò wa sí. Yóò béèrè àlàyé lọ́wọ́ `model` tí o ti ṣẹ̀dá tẹ́lẹ̀ àti pé yíò darí àlàyé náà sí `template` kan. A ó ṣẹ̀dá àwòṣe (template) kan nínú àkòrí tó kàn náà. Awon view wulẹ̀ jẹ́ àwọn iṣẹ́ Python tó ṣòro díẹ̀ ju àwọn tí a kọ nínú àkòrí **Ìfihàn sí Python** náà.
+
+Àwọn View máa ń wà nínú fáìlì `views.py`. A ó ṣàfikún àwọn *view* wa sínú fáìlì `blog/views.py` náà.
+
+## blog/views.py
+
+O dáa, jẹ́ ká ṣí fáìlì yìí nínú olóòtú kóòdù wa láti rí ohun tó wà níbẹ̀:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Kò tíì sí nnkan púpọ̀ níbí.
+
+Rántí pé àwọn ìlà tó n bẹ̀rẹ̀ pẹ̀lú `#` jẹ́ àwọn àlàyé – èyí túmọ̀ sí pé àwọn ìlà yẹn kò ní jẹ́ ṣíṣe nípasẹ̀ Python.
+
+Jẹ́ ká ṣẹ̀dá *view* kan bíi àlàyé náà ṣe sọ. Ṣàfikún ìwọnba view tó tẹ̀le yìí sí abẹ́ rẹ̀:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Gẹ́gẹ́ bó o ṣe ríi, a ti ṣẹ̀dá iṣẹ́ kan (`def`) tí a n pè ní `post_list` tó máa gba `request` tí yíò sì `return` ohun tó bá gba láti pípè iṣẹ́ mìíràn `render` tí yíò ṣàfihàn (ṣàkópọ̀) àwòṣe (template) wa `blog/post_list.html`.
+
+Tọ́jú fáìlì náà, lọ sí http://127.0.0.1:8000/ láti wo ohun tí a ti ní.
+
+Àṣìṣe mìíràn! Ka ohun tí ń ṣẹlẹ̀ lọ́wọ́:
+
+![Àṣìṣe](images/error.png)
+
+Èyí fi hàn pé server náà tí n ṣiṣẹ́ padà, ṣùgbọ́n kò tíì rí bó ti yẹ, àbí ó rí bẹ́ẹ̀ ni? Má dààmú, ó kàn jẹ́ ojú-ìwé àṣìṣe kan, kò sí ohun kan láti bẹrù! Gẹ́gẹ́ bí àwọn ìròyìn àṣìṣe tó wà nínú console náà, àwọn wọ̀nyí wúlò púpọ̀ gan-an. O lè kà pé *TemplateDoesNotExist*. Jẹ́ ká ṣàtúnṣe àṣìṣe yìí àti ṣẹ̀dá àwòṣe (template) kan nínú àkòrí tó kàn náà!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/yo-NG/dynamic_data_in_templates/README.md b/yo-NG/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..2cf2b88d5d6
--- /dev/null
+++ b/yo-NG/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# Àwọn dátà tó n ṣiṣẹ́ nínú àwọn àwòṣe (template)
+
+A ní àwọn ohun oríṣiríṣi ní ipò: a ti ṣàlàyé àwòṣe `Post` náà nínú `models.py`, a ní `post_list` nínú `views.py` àti àwòṣe (template) náà ní àfikún. Ṣùgbọ́n báwo ni a ó ṣe mú àwọn àròkọ wa hàn nínú àwòṣe HTML wa? Nítorí pé ohun tí a fẹ́ ṣe nìyẹn – a fẹ́ mú àkóónú kan (àwọn àwòṣe tí a tọ́jú sínú àkójọpọ̀ dátà náà) láti ṣàfihàn rẹ̀ lọ́nà tó dára nínú àwòṣe wa, àbí bẹ́ẹ̀ kọ?
+
+Èyí jẹ́ ohun tó yẹ kí àwọn *view* máa ṣe: ṣe ìsopọ̀ àwọn àwòṣe (models) àti àwọn àwòṣe (templates). Nínú *view* `post_list` wa, a máa nílò láti mú àwọn àwòṣe (model) tí a fẹ ṣàfihàn náà kí a sì darí wọn sí àwòṣe (template) náà. Nínú *view* kan, a máa pinnu ohun (àwòṣe - model) tí yíò hàn nínú àwòṣe (template) kan.
+
+Ó dáa, báwo wá ni a ṣe lè ṣe èyí?
+
+A nílò láti ṣí `blog/views.py` wa nínú olóòtú kóòdù wa. Títí di báyìí, *view* `post_list` rí báyìí:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Rántí ìgbà tí a sọ̀rọ̀ nípa ṣíṣe àfikún kóòdù tí a kọ ní àwọn fáìlì mìíràn? Àkókò ti tó báyìí tí a ní láti ṣàfikún àwòṣe tí a ti kọ nínú `models.py`. A máa ṣàfikún ìlà `from .models import Post` náà báyìí:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+Àmì tó-ín (dot) tó wà níwájú `models` túmọ̀ sí *àkójọpọ̀ fáìlì lọ́wọ́lọ́wọ́* tàbí *ètò lọ́wọ́lọ́wọ́*. `views.py` àti `models.py` wà nínú àkójọpọ̀ fáìlì kannáà. Èyí túmọ̀ sí pé a lè lo `.` àti orúkọ fáìlì náà (láìsí `.py`). Lẹ́yìn náà, a máa ṣàgbéwọlé orúkọ àwòṣe náà (`Post`).
+
+Ṣùgbọ́n kí ló kàn? Láti mú àwọn àròkọ blog láti àwòṣe `Post` náà, a nílò nnkan kan tí a n pé ní `QuerySet`.
+
+## QuerySet
+
+Ó yẹ kí o ti mọ̀ nípa bí QuerySets ṣé n ṣiṣẹ́. A ti sọ̀rọ̀ nípa wọn nínú [àkòrí Django ORM (QuerySets)](../django_orm/README.md).
+
+Ní báyìí, a fẹ́ ṣètò àwọn àròkọ blog tí a ṣàtẹ̀jáde nípasẹ̀ `published_date` (ọjọ́ títẹ̀jáde), àbí bẹ́ẹ̀ kọ? A ti ṣe ìyẹn tẹ́lẹ̀ nínú àkòrí QuerySets!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Nítorí náà, jẹ́ ká ṣí fáìlì `blog/views.py` nínú olóòtú kóòdù náà, kí a sì ṣàfikún abala kóòdù yìí sí iṣẹ́ `def post_list(request)` náà -- ṣùgbọ́n má gbàgbé láti kọ́kọ́ ṣàfikún `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+Jọ̀wọ́ ṣàkíyèsí pé a ṣẹ̀dá *variable* kan fún QuerySet wa: `posts`. Mú èyí gẹ́gẹ́ bí orúkọ QuerySet wa. Láti àkókò yíì lọ, a lè tọ́ka sí i nípasẹ̀ orúkọ yìí.
+
+Nínú iṣẹ́ `render` náà, a ní parameter `request` kan (gbogbo nnkan tí a gbà láti ọ̀dọ̀ aṣàmúlò náà nípasẹ̀ Íńtánẹ́ẹ̀tì) àti òmíràn tó n fúnni ní fáìlì àwòṣe (template) náà (`'blog/post_list.html'`). Parameter ìkẹyìn náà, `{}`, jẹ́ ààyè kan tí a ti lè ṣàfikún àwọn nnkan mìíràn fún àwòṣe (template) náà láti lò. A nílò láti fún wọn ní orúkọ (a óò fara mọ́ `'posts'` lọ́wọ́lọ́wọ́). :) Ó yẹ kó rí báyìí: `{'posts': posts}`. Jọ̀wọ́ ṣàkíyèsí pé apá tó wà níwájú `:` jẹ́ fọ́nrán (string) kan; o nílò láti wé e pẹ̀lú àwọn àmì àyọlò: `''`.
+
+Ní ìparí, ó yẹ kí fáìlì `blog/views.py` wa rí báyìí:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+Ó parí! Àkókò láti padà sí àwòṣe (template) wa àti ṣàfihàn QuerySet yìí!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/yo-NG/extend_your_application/README.md b/yo-NG/extend_your_application/README.md
new file mode 100644
index 00000000000..4297e737426
--- /dev/null
+++ b/yo-NG/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# Mú ètò rẹ gbòòrò síi
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Àkókò láti ṣe ìdánrawò!
+
+Dájúdájú, nnkan àkọ́kọ́ tí a nílò nínú blog wa ni ojú-ìwé kan láti ṣàfihàn àròkọ kan, àbí bẹ́ẹ̀ kọ?
+
+A ti ní àwòṣe `Post` kan tẹ́lẹ̀, nítorí náà a kò nílò láti ṣàfikún ohunkóhun sí `models.py`.
+
+## Ṣẹ̀dá atọ́ka àwòṣe kan sí àlàyé ti àròkọ kan
+
+A ó bẹ̀rẹ̀ pẹ̀lú ṣíṣe àfikún atọ́ka kan sínú fáìlì `blog/templates/blog/post_list.html`. Ṣí i nínú olóòtú kóòdù náà, ó sì yẹ kí o rí báyìí látẹ̀yìnwá: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}A fẹ́ ní atọ́ka kan láti àkọlé ti àròkọ kan nínú àkójọ àròkọ náà sí ojú-ìwé àlàyé ti àròkọ náà. Jẹ́ ká ṣàyípadà `<h2><a href="">{{ post.title }}</a></h2>`kí ó bàa lè tọ́ka sí ojú-ìwé àlàyé ti àròkọ náà:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %} Àkókò láti ṣàlàyé `{% url 'post_detail' pk=post.pk %}` tó ṣàjèjì náà. Gẹ́gẹ́ bí o ti lè lérò, àkọsílẹ̀ `{% %}` náà túmọ̀ sí pé a n lo àwọn àmì àwòṣe Django. Ní àkókò yìí, a ó lo ọ̀kan tí yíò ṣẹ̀dá URL kan fún wa!{% endraw %}
+
+Apá `post_detail` náà túmọ̀ sí pé Django yíò máa retí URL kan nínú `blog/urls.py` pẹ̀lú name=post_detail
+
+Àti pé `pk=post.pk` ńkọ́? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Ní báyìí, nígbà tí a bá lọ sí http://127.0.0.1:8000/ a ó ní àṣìṣe kan (gẹ́gẹ́ bí a ṣe retí, nítorí pé a kò tíì ní URL kan tàbí *view* kan fún `post_detail`). Yóò rí báyìí:
+
+![Àṣìṣe NoReverseMatch](images/no_reverse_match2.png)
+
+## Ṣẹ̀dá URL kan sí àlàyé ti àròkọ kan
+
+Jẹ́ ká ṣẹ̀dá URL kan sínú `urls.py` fún *view* `post_detail` wa!
+
+A tún fẹ́ kí àlàyé ti àròkọ àkọ́kọ́ wa fojú hàn ní **URL** yìí: http://127.0.0.1:8000/post/1/
+
+Jẹ́ ká ṣẹ̀dá URL kan sínú fáìlì `blog/urls.py` láti darí Django sí *view* kan tó n jẹ́ `post_detail`, tí yíò ṣàfihàn gbogbo àròkọ blog kan. Ṣí fáìlì `blog/urls.py` náà nínú olóòtú kóòdù náà, kí o sì ṣàfikún ìlà `path('post/<int:pk>/', views.post_detail, name='post_detail'),` kí fáìlì náà bàa lè rí báyìí:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+Apá `post/<int:pk>/` yìí tọ́ka àpẹẹrẹ URL kan – a ó ṣàlàyé rẹ̀ fún ọ:
+
+- `post/` túmọ̀ sí pé ó yẹ kí URL naa bẹ̀rẹ̀ pẹ̀lú ọ̀rọ̀ **post** náà tí **/** yíò sì tẹ̀lé e. Ìyẹn ṣì dára.
+- `<int:pk>` – apá yìí fẹ́ ṣòro díẹ̀. Ó túmọ̀ sí pé Django n retí iye nọ́mbà odidi kan àti pé yíò fi ránṣẹ́ sí view kan gẹ́gẹ́ bí variable kan tí a n pè ní `pk`.
+- `/` – lẹ́yìn náà a nílò **/** kan lẹ́ẹ̀kan si ṣáájú píparí URL náà.
+
+Ìyẹn túmọ̀ sí pé tí o bá tẹ `http://127.0.0.1:8000/post/5/` sínú aṣàwákiri rẹ, Django yíò mọ̀ pé o ń wá *view* kan tí a pè ní `post_detail` àti pé yíò fi ìròyìn náà ránṣẹ́ pé `pk` dọ́gba pẹ̀lú `5` sí *view* yẹn.
+
+Ó dáa, a ti ṣàfikún àpẹẹrẹ URL tuntun kan sí `blog/urls.py`! Jẹ́ ká ṣe ìmúdójúìwọ̀n ojú-ìwé náà: http://127.0.0.1:8000/ Boom! Server náà ti dáwọ́ iṣẹ́ dúró lẹ́ẹ̀kan si. Ṣàyẹ̀wò console náà – gẹ́gẹ́ bí a ṣe retí, àṣìṣe mìíràn tún wà!
+
+![AttributeError](images/attribute_error2.png)
+
+Ǹjẹ́ o rántí ohun tí ìgbésẹ̀ tó kàn jẹ́? Òhun ni ṣíṣe àfikún view kan!
+
+## Ṣàfikún view àlàyé ti àròkọ kan
+
+Ní àkókò yìí, a fún *view* wa ní àfikún parameter kan, `pk`. *view* wa nílò láti mú u, àbí bẹ́ẹ̀ kọ? Nítorí náà, a ó ṣàlàyé iṣẹ́ wa gẹ́gẹ́ bí `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Ní báyìí, a fẹ́ gba àròkọ blog ẹyọkan ṣoṣo. Láti ṣe èyí, a lè lo querysets, báyìí:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+Ṣùgbọ́n kóòdù yìí ní ìṣòro kan. Tí kò bá sí `Post` tí a fún ní `primary key` (`pk`) náà, a ó ní àṣìṣe tí kò dáa rárá kan!
+
+![Àṣìṣe DoesNotExist](images/does_not_exist2.png)
+
+A kò fẹ́ ìyẹn! Ṣùgbọ́n a dúpẹ́ pé Django wá pẹ̀lú nnkan kan tí yíò yanjú ìyẹn fún wa: `get_object_or_404`. Tó bá jẹ́ pé kò sí `Post` tí a fún ní `pk` náà, yóò ṣàfihàn ojú-ìwé tó dára, ojú-ìwé `Page Not Found 404` náà.
+
+![Ojú-ìwé kò sí](images/404_2.png)
+
+Ìròyìn rere náà ni pé o lè ṣẹ̀dá ojú-ìwé `Page not found` tìẹ kí o sì mú u rẹwà gẹ́gẹ́ bí o ṣe fẹ́. Ṣùgbọ́n kò ṣe pàtàkì ní báyìí, nítorí náà a ó fojú fò ó.
+
+Ó dáa, àkókò láti ṣàfikún *view* kan sí fáìlì `views.py` wa!
+
+Nínú `blog/urls.py`, a ti ṣẹ̀dá òfin URL kan tó n jẹ́ `post_detail` tó ń tọ́ka sí view kan tí a n pè ní `views.post_detail`. Èyí túmọ̀ sí pé Django yíò máa retí iṣẹ́ view kan tí a n pè ní `post_detail` nínú `blog/views.py`.
+
+Ó yẹ kí a ṣí `blog/views.py` nínú olóòtú kóòdù náà àti ṣàfikún kóòdù tó tẹ̀le yìí nítòsí àwọn ìlà `from` yòókù náà:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+Àti pé ní ìparí fáìlì náà, a ó ṣàfikún *view* wa:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Bẹ́ẹ̀ ni. Àkókò ti tó láti ṣe ìmúdójúìwọ̀n ojú-ìwé náà: http://127.0.0.1:8000/
+
+![View àkójọ àròkọ](images/post_list2.png)
+
+Ó ṣiṣẹ́! Ṣùgbọ́n kí ló máa ṣẹlẹ̀ nígbà tí o bá tẹ atọ́ka kan nínú àkọlé àròkọ blog?
+
+![Àṣìṣe TemplateDoesNotExist](images/template_does_not_exist2.png)
+
+Ó tì o! Àṣìṣe mìíràn! Ṣùgbọ́n a ti mọ bí a ṣe máa kojú rẹ̀, àbí bẹ́ẹ̀ kọ? A nílò láti ṣàfikún àwòṣe kan!
+
+## Ṣẹ̀dá àwòṣe kan fún àwọn àlàyé àròkọ náà
+
+A ó ṣẹ̀dá fáìlì kan nínú `blog/templates/blog` tí a n pè ní `post_detail.html`, tí a ó sì ṣí i nínú olóòtú kóòdù náà.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Lẹ́ẹ̀kan síi, a n mú `base.html` gbòòrò síi. Nínú búlọ́ọ̀kù `content` náà, a fẹ́ ṣàfihàn published_date (tó bá wà), àkọlé àti ọ̀rọ̀ ti àròkọ kan. Ṣùgbọ́n ó yẹ kí a ṣàlàyé àwọn nnkan pàtàkì kan, àbí bẹ́ẹ̀ kọ?
+
+{% raw %}`{% if ... %} ... {% endif %}` jẹ́ àmì àwòṣe kan tí a lè lò nígbà tí a bá fẹ́ ṣàyẹ̀wò nnkan kan. (Rántí `if ... else ...` láti àkòrí **Ìfihàn sí Python**?) Nínú ìṣẹ̀lẹ̀ yìí, a fẹ́ ṣàyẹ̀wò bóyá `published_date` ti àròkọ kan kìí ṣe òfìfo.{% endraw %}
+
+Ó dáa, a lè ṣe ìmúdójúìwọ̀n ojú-ìwé wa láti wo bóyá `TemplateDoesNotExist` kò sí mọ́ báyìí.
+
+![Ojú-ìwé àlàyé àròkọ](images/post_detail2.png)
+
+Yay! Ó n ṣiṣẹ́!
+
+# Àkókò láti ṣàgbékalẹ̀!
+
+Yóò dára láti ṣàyẹ̀wò bóyá ààyè ayélujára rẹ ṣì máa ṣiṣẹ́ lórí PythonAnywhere, àbí bẹ́ẹ̀ kọ? Jẹ́ ká gbìyànjú ṣíṣe àgbékalẹ̀ lẹ́ẹ̀kan si.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Lẹ́yìn náà, nínú [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/) kan:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Rántí láti rọ́pò `<your-pythonanywhere-domain>` pẹ̀lú subdomain PythonAnywhere rẹ, láìsí àwọn àkámọ́ onígun náà.)
+
+## Ṣíṣe ìmúdójúìwọ̀n àwọn fáìlì tó wà lójú kan lórí server náà
+
+Àwọn server bíi PythonAnywhere fẹ́ràn láti ṣiṣẹ́ lórí "àwọn fáìlì tó wà lójú kan" (bíi àwọn fáìlì CSS) lọ́nà tó yàtọ̀ sí àwọn fáìlì Python, nítorí pé wọ́n lè mú wọn ṣiṣẹ́ lọ́nà tó já fáfá láti jẹ́ gbígbé ní kíákíá. Nítorí èyí, nígbàkigbà tí a bá ṣe àwọn ìyípadà sí àwọn fáìlì CSS wa, a nílò láti lo àfikún àṣẹ kan lórí server náà láti sọ fún-un pé kí ó ṣe ìmúdójúìwọ̀n wọn. Àṣẹ náà ni a n pè ní `collectstatic`.
+
+Bẹ̀rẹ̀ pẹ̀lú mímú virtualenv rẹ ṣiṣẹ́ tí kò bá tíì ma ṣiṣẹ́ tẹ́lẹ̀ (PythonAnywhere máa n lo àṣẹ kan tí a n pè ní `workon` láti ṣe èyí, ó dà bí àṣẹ `source myenv/bin/activate` tí o máa n lò lórí kọ̀mpútà tìẹ):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+Àṣẹ `manage.py collectstatic` náà fẹ́ dà bíi `manage.py migrate`. A ṣe àwọn ìyípadà kan sí kóòdù wa, lẹ́yìn náà a sọ fún Django láti *lo* àwọn ìyípadà yẹn, bóyá sí àkójọpọ̀ àwọn fáìlì tó wà lójú kan ti server náà, tàbí sí àkójọpọ̀ dátà náà.
+
+Bó ti wù kó rí, a ti ṣetán báyìí láti lọ sí [ojú-ìwé "Ayélujára"](https://www.pythonanywhere.com/web_app_setup/) náà (láti bọ́tìnnì àkójọ àṣàyàn tó wà ní òkè lápá ọ̀tún console náà) kí o sì tẹ **Reload**, lẹ́yìn náà wo ojú-ìwé https://subdomain.pythonanywhere.com náà láti rí àbájáde náà.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/yo-NG/how_the_internet_works/README.md b/yo-NG/how_the_internet_works/README.md
new file mode 100644
index 00000000000..163bcf451f3
--- /dev/null
+++ b/yo-NG/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# Bí Íńtánẹ́ẹ̀tì ṣé n ṣiṣẹ́
+
+> Fún àwọn òǹkàwé ní ilé: a ti ṣàlàyé àkòrí yìí nínú fídíò [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc).
+> 
+> Ọ̀rọ̀ àsọyé "How the Internet works" ti Jessica McKellar (http://web.mit.edu/jesstess/www/) ló gbà wá níyànjú láti kọ àkòrí yìí.
+
+A lérò pé o n lo Íńtánẹ́ẹ̀tì náà lójoojúmọ́. Ṣùgbọ́n ṣé o mọ ohun tó ṣẹlẹ̀ nígbà tí o tẹ àdírẹ́ẹ̀sì kan bíi https://djangogirls.org sínú aṣàwákiri rẹ tí o sì tẹ `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. A ṣètò àwọn aṣàwákiri ayélujára láti lóye kóòdù yìí, tẹ̀lé àwọn ìtọ́sọ́nà rẹ̀, àti ṣàgbékalẹ̀ àwọn fáìlì wọ̀nyí tí ààyè ayélujára rẹ kó sínú, bí o ṣe fẹ́ kó rí gan-an.
+
+Gẹ́gẹ́ bí ó ti rí pẹ̀lú gbogbo fáìlì, a nílò láti tọ́jú àwọn fáìlì HTML sí ibìkan lórí ibi ìpamọ́ kan. Fún Íńtánẹ́ẹ̀tì náà, a má n lo àwọn àkànṣe kọ̀mpútà tó lágbára púpọ̀ tí a n pè ní àwọn *server*. Wọn kò ní ojú àwòrán kan, atọ́ka tàbí pẹpẹ bọ́tìnnì kan, nítorí pé ìdí pàtàkì wọn ní láti tọ́jú dátà àti pèsè rẹ̀. Ìdí nìyẹn tí a fí n pè wọ́n ní àwọn *server* – nítorí pé wọ́n *pèsè (serve)* dátà fún ẹ.
+
+Ó dáa, ṣùgbọ́n o fẹ́ mọ bí Íńtánẹ́ẹ̀tì náà ṣe rí, àbí bẹ́ẹ̀ kọ?
+
+A ya àwòrán kan fún ọ! Ó rí báyìí:
+
+![Figure 1.1](images/internet_1.png)
+
+Ó rí rádaràda, àbí bẹ́ẹ̀ kọ? Ní tòótọ́, ó jẹ́ ìkànnì àwọn ẹ̀rọ tí a sopọ̀ kan (*àwọn server* tí a dárúkọ lókè náà). Ẹgbẹẹgbẹ̀rún lọ́nà ọgọ́rọ̀ọ̀rún àwọn ẹ̀rọ! Ọ̀pọ̀lọpọ̀ kìlómítà àwọn wáyà káàkiri àgbáyé! O lè ṣèbẹ̀wò ààyè ayélujára Submarine Cable Map kan (http://submarinecablemap.com) láti rí bí íńtánẹ́ẹ̀tì náà ṣe lọ́jú pọ̀ tó. Àwòrán kan láti ààyè ayélujára náà nìyí:
+
+![Figure 1.2](images/internet_3.png)
+
+Ó fani mọ́ra, àbí kò rí bẹ́ẹ̀? Ṣùgbọ́n kò ṣeéṣe láti ní wáyà kan láàrin gbogbo ẹ̀rọ tó sopọ̀ mọ́ Íńtánẹ́ẹ̀tì náà. Nítorí náà, láti dé ẹ̀rọ kan (fún àpẹẹrẹ, èyí tí a tọ́jú https://djangogirls.org sí), a nílò láti darí ìbéèrè kan káàkiri oríṣiríṣi ẹ̀rọ.
+
+Ó rí báyìí:
+
+![Figure 1.3](images/internet_2.png)
+
+Wòye pé nígbà tí o bá tẹ https://djangogirls.org, o fi lẹ́tà kan ránṣẹ́ tó sọ wípé: "Django Girls Ọ̀wọ́n, Mo fẹ́ rí ààyè ayélujára djangogirls.org náà. Fi ránṣẹ́ sí mi, jọ̀wọ́!"
+
+Lẹ́tà rẹ yíò lọ sí ilé iṣẹ́ ìfìwéránṣẹ́ tó súnmọ́ ẹ jù. Lẹ́yìn náà yíò lọ sí òmíràn tó tún súnmọ́ díẹ̀ sí olùgbà lẹ́tà rẹ, lẹ́yìn náà sí òmíràn, àti òmíràn títí dìgbà tí yíò fi dé ibi tó n lọ. Nnkan àkànṣe kan ṣoṣo náà ni pé tí o bá fi ọ̀pọ̀lọpọ̀ àwọn lẹ́tà (*àwọn àkópapọ̀ dátà (data packets)*) ránṣẹ́ sí ibi kannáà, wọ́n lè gba àwọn ilé iṣẹ́ ìfìwéránṣẹ́ (*àwọn alànà (routers)*) tó yàtọ̀ síra pátápátá kọjá. Èyí dá lórí bí wọ́n ṣe gba pínpín ní ilé iṣé kọ̀ọ̀kan.
+
+![Figure 1.4](images/internet_4.png)
+
+Bí ó ṣé n ṣiṣẹ́ nìyẹn - o fi àwọn ìròyìn ránṣẹ́ àti pé o retí ìdáhùn kan. Dípò ìwé àti gègé o lo àwọn byte ti dátà, ṣùgbọ́n èrò kannáà ló jẹ́!
+
+Dípò àwọn àdírẹ́ẹ̀sì pẹ̀lú orúkọ òpópónà kan, ìlú, kóòdù ìpínlẹ́tà àti orúkọ orílẹ̀-èdè, a lo àwọn àdírẹ́ẹ̀sì IP. Kọ̀mpútà rẹ yíò kọ́kọ́ béèrè lọ́wọ́ DNS (Domain Name System, Ètò Orúkọ Agbègbè) náà láti túmọ̀ djangogirls.org sí àdírẹ́ẹ̀sì IP kan. Ó ń ṣiṣẹ́ bíi àwọn ìwé tẹlifóònù ti àtijọ́, níbi tí o ti lè wo orúkọ ẹni tí o fẹ́ pè náà tí o sì ma rí nọ́ḿbà fóònù àti àdírẹ́ẹ̀sì wọn.
+
+Nígbà tí o bá fi lẹ́tà kan ránṣẹ́, ó nílò láti ní àwọn ohun pàtó kan láti fi jíṣẹ́ bó ṣe yẹ: àdírẹ́ẹ̀sì kan, òǹtẹ̀ kan, àti bẹ́ẹ̀ bẹ́ẹ̀ lọ. O tún ma lo èdè kan tí olùgbà náà mọ̀, àbí bẹ́ẹ̀ kọ? Bákannáà ló ṣe rí fún *àwọn àkópapọ̀ dátà* tí o fi ránṣẹ́ láti rí ààyè ayélujára kan. A lo ìlànà kan tí a n pè ní HTTP (Hypertext Transfer Protocol, Ìlànà Ìfiránṣẹ́ Ọ̀rọ̀-atọ̀ka).
+
+Nítorí náà, pàtàkì jùlọ, nígbà tí o bá ní ààyè ayélujára kan, o nílò láti ní *server* (ẹ̀rọ) kan níbi tí yíò ma gbé. Nígbà tí *server* náà bá gba *ìbéèrè* tí ń bọ̀ kan (nínú lẹ́tà kan), yíò fi ààyè ayélujára rẹ ránṣẹ́ padà (nínú lẹ́tà mìíràn).
+
+Torí pé èyí jẹ́ àlàyé Django kan, o lè béèrè ohun tí Django n ṣe. Nígbà tí o bá fi ìdáhùn kan ránṣẹ́, ìwọ kò ní fẹ́ fi ohun kannáà ránṣẹ́ sí gbogbo èèyàn ní gbogbo ìgbà. Yíò dára púpọ̀ tí àwọn lẹ́tà rẹ bá jẹ́ àkànṣe, pàápàá jù lọ fún ẹni tó ṣẹ̀ṣẹ̀ kọ̀wé sí ọ, àbí bẹ́ẹ̀ kọ? Django yíò ràn ọ lọ́wọ́ pẹ̀lú ṣíṣẹ̀dá àwọn lẹ́tà àkànṣe tó dára wọ̀nyí. :)
+
+Ọ̀rọ̀ tí a sọ ti tó – àkọ́kọ́ láti ṣẹ̀dá!
\ No newline at end of file
diff --git a/yo-NG/html/README.md b/yo-NG/html/README.md
new file mode 100644
index 00000000000..e715c6ebc2c
--- /dev/null
+++ b/yo-NG/html/README.md
@@ -0,0 +1,227 @@
+# Ìfihàn sí HTML
+
+Kíni àwòṣe (template) kan, o lè béèrè?
+
+Àwòṣe kan jẹ́ fáìlì kan tí a lè tún lò láti ṣàfihàn ìròyìn ọ̀tọ̀ọ̀tọ̀ ni àgbékalẹ̀ tó báramu kan – fún àpẹẹrẹ, o lè lo àwòṣe kan láti ràn ọ́ lọ́wọ́ lórí kíkọ lẹ́tà kan nítorí bó tilẹ̀ jẹ́ pé lẹ́tà kọ̀ọ̀kan lè ní ìròyìn ọ̀tọ̀ọ̀tọ̀ àti pé wọ́n lè jẹ́ kíkọ sí èèyàn ọ̀tọ̀ọ̀tọ̀, wọ́n máa lo àgbékalẹ̀ kannáà.
+
+Àgbékalẹ̀ àwòṣe Django kan ni a ṣàpèjúwe ní èdè kan tí a n pè ní HTML (ìyẹn ni HTML tí a dárúkọ ní àkòrí àkọ́kọ́ náà, **Bí Íńtánẹ́ẹ̀tì ṣé n ṣiṣẹ́**).
+
+## Kíni HTML?
+
+HTML jẹ́ kóòdù kan tí aṣàwákiri ayélujára rẹ - bíi Chrome, Firefox àbí Safari - máa túmọ̀ láti ṣàfihàn ojú-ìwé ayélujára kan fún aṣàmúlò náà.
+
+HTML dúró fún "HyperText Markup Language". **HyperText** túmọ̀ sí pé ó jẹ́ irú ọ̀rọ̀ kan tó n ṣàtìlẹ́yìn fún àwọn ọ̀rọ̀-atọ̀ka láàrín àwọn ojú-ìwé. **Markup** túmọ̀ sí pé a ti mú àkọsílẹ kan tí a sì ṣàmì síi pẹ̀lú kóòdù láti sọ fún nnkan kan (ní irú ìṣẹ̀lẹ̀ yìí, aṣàwákiri kan) bí ó ṣe lè túmọ̀ ojú-ìwé náà. Kóòdù HTML gba kíkọ́ pẹ̀lú **àwọn àmì**, ọ̀kọ̀ọ̀kan n bẹ̀rẹ̀ pẹ̀lú `<` tó sì n parí pẹ̀lú `>`. Àwọn àmì wọ̀nyí dúró fún **àwọn element** ìṣàmìsí.
+
+## Àwòṣe àkọ́kọ́ rẹ!
+
+Ṣíṣẹ̀dá àwòṣe kan túmọ̀ sí ṣíṣẹ̀dá fáìlì àwòṣe kan. Gbogbo nnkan ni fáìlì kan, àbí bẹ́ẹ̀ kọ? Ó ṣeéṣe kí o ti ṣàkíyèsí èyí tẹ́lẹ̀.
+
+A máa n tọ́jú àwọn àwòṣe sínú àkójọpọ̀ fáìlì `blog/templates/blog`. Nítorí náà, kọ́kọ́ ṣẹ̀dá àkójọpọ̀ fáìlì kan tí a n pè ní `templates` sínú àkójọpọ̀ fáìlì blog rẹ. Lẹ́yìn náà, ṣẹ̀dá àkójọpọ̀ fáìlì mìíràn tí a n pè ní `blog` sínú àkójọpọ̀ fáìlì àwọn àwòṣe rẹ:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(O lè máa ronú pé kí nìdí tí a fi nílò àwọn àkójọpọ̀ fáìlì méjì tó n jẹ́ `blog` – bí o ṣe máa ṣàwárí tó bá yá, èyí jẹ́ ọ̀nà ìkọrúkọ tó wúlò kan tí yíò mú ayé rọrùn nígbà tí àwọn nnkan bá bẹ̀rẹ̀ sí ní ṣòro.)
+
+Ní báyìí, ṣẹ̀dá fáìlì `post_list.html` kan (fi sílẹ̀ ní òfìfo) sínú àkójọpọ̀ fáìlì `blog/templates/blog` náà.
+
+Wo bí ààyè ayélujára rẹ ṣe rí ní báyìí: http://127.0.0.1:8000/
+
+> Tí o bá ṣì ní àṣìṣe kan `TemplateDoesNotExist`, gbìyànjú láti tún server rẹ bẹ̀rẹ̀. Lọ sí ìlà ìpàṣẹ náà, dá server náà dúró nípasẹ̀ títẹ Ctrl+C (àwọn bọ́tìnnì Control àti C papọ̀) kí o sì bẹ̀rẹ̀ rẹ̀ padà nípasẹ̀ lílo àṣẹ `python manage.py runserver` kan.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Ṣí fáìlì tuntun náà nínú olóòtú kóòdù náà, kí o sì ṣàfikún èyí tó tẹ̀le yìí:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+Báwo wá ni ààyè ayélujára rẹ ṣe rí ní báyìí? Ṣàbẹ̀wò rẹ láti wádìí: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Orí àti ara
+
+Ojú-ìwé HTML kọ̀ọ̀kan tún gba pínpín sí àwọn element méjì: **head** àti **body**.
+
+* **head** jẹ́ element kan tó kó àlàyé nípa àkọsílẹ̀ náà tí kò ní hàn lórí ojú àwòrán náà sínú.
+
+* **body** jẹ́ element kan tó kó gbogbo nnkan yòókù tó fojú hàn gẹ́gẹ́ bí ara ojú-ìwé ayélujára náà sínú.
+
+A máa n lo `<head>` láti sọ fún aṣàwákiri náà nípa ìṣètò ojú-ìwé náà, àti `<body>` láti sọ ohun tó ma wà lórí ojú-ìwé náà gan-an.
+
+Fún àpẹẹrẹ, o lè fi element àkọlé ojú-ìwé ayélujára kan sínú `<head>` náà, báyìí:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Tọ́jú fáìlì náà kí o sì ṣe ìmúdójúìwọ̀n ojú-ìwé rẹ.
+
+![Figure 11.3](images/step4.png)
+
+Ṣàkíyèsí bí aṣàwákiri náà ṣe mọ̀ pé "Ola's blog" ni àkọlé ojú-ìwé rẹ? Ó ti túmọ̀ `<title>Ola's blog</title>` àti pé ó ti gbé e ọ̀rọ̀ náà sínú pẹpẹ àkọlé aṣàwákiri rẹ (yóò tún jẹ́ lílò fún àwọn àmì ìwé àti bẹ́ẹ̀ bẹ́ẹ̀ lọ).
+
+Ó ṣeéṣe kí o ti tún ṣàkíyèsí pé àmì ìbẹ̀rẹ̀ kọ̀ọ̀kan ló ní *àmì ìparí* kan, pẹ̀lú `/` kan, àti pé a n fi àwọn element bọ̀ inú ara wọn (ìyẹn ni pé, o kò lè parí àmì pàtó kan títí di ìgbà tí gbogbo àwọn tó wà nínú rẹ̀ bá ti parí).</p> 
+
+Ó dàbí fífi àwọn nǹkan sínú àwọn àpótí. O ní àpótí nlá kan, `<html></html>`; nínú rẹ̀ ni `<body></body>`wà, àti pé ìyẹn tún kó àwọn àpótí kékeré sínú: `<p></p>`.
+
+O nílò láti tẹ̀lé àwọn òfin ti àwọn àmì *ìparí*, àti ti fífi àwọn element bọ̀ inú ara wọn – tí ìwọ kò bá ṣe bẹ́ẹ̀, ó ṣeéṣe kí aṣàwákiri náà má lè túmọ̀ wọn dáadáa àti pé ojú-ìwé rẹ kò ní fojú hàn bó ṣe tọ́.
+
+## Ṣe àwòṣe rẹ bí o ṣe fẹ́
+
+O lè wá ṣeré díẹ̀ báyìí kí o gbìyànjú láti ṣe àwòṣe rẹ bí o ṣe fẹ́! Díẹ lára àwọn àmì tó wúlò fún ìyẹn nìyí:
+
+* `<h1>Àkọsórí kan</h1>` fún àkọsórí rẹ tó ṣe pàtàkì jù
+* `<h2>Ìsọ̀rí orí ọ̀rọ̀ kan</h2>` fún àkọsórí kan ní ìpele tó kàn
+* `<h3>Ìsọ̀rí lábẹ́ ìsọ̀rí orí ọ̀rọ̀ kan</h3>` …àti bẹ́ẹ̀ bẹ́ẹ̀ lọ, títí dé `<h6>`
+* `<p>Ìpínrọ̀ ọ̀rọ̀ kan</p>`
+* `<em>ọ̀rọ̀</em>` yíò ṣàgbéyọ ọ̀rọ̀ rẹ pẹ̀lú lẹ́tà tó dagun
+* `<strong>ọ̀rọ̀</strong>` yíò ṣàgbéyọ ọ̀rọ̀ rẹ pẹ̀lú lẹ́tà tó nípọn
+* `<br>` yíò lọ sí ìlà mìíràn (o kò lè fi nnkan kan sínú br àti pé kò sí àmì ìparí)
+* `<a href="https://djangogirls.org">atọ́ka</a>` yíò ṣẹ̀dá atọ́ka kan
+* `<ul><li>nǹkan àkọ́kọ́</li><li>nǹkan èkejì</li></ul>` yíò ṣe àkójọ kan, gẹ́gẹ́ bí eléyìí!
+* `<div></div>` yíò ṣàlàyé abala kan ti ojú-ìwé náà
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Àpẹẹrẹ àwòṣe kíkún kan nìyí, ṣàdàkọ rẹ̀ sínú `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+Yóò fún wa ní àbájáde yìí:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! Ṣùgbọ́n títí di báyìí, àwòṣe wa máa n ṣàfihàn **ìròyìn kannáà** nìkan – nígbà tó jẹ́ pé ní ìbẹ̀rẹ̀ a n sọ̀rọ̀ nípa àwọn àwòṣe bí wọ́n ṣe n gbà wa láàyè láti ṣàfihàn ìròyìn **ọ̀tọ̀ọ̀tọ̀** pẹ̀lú **àgbékalẹ̀ kannáà**.
+
+Ohun tí a fẹ́ ṣe gan-an ni láti ṣàfihàn àwọn àwòṣe gidi tí a ṣàfikún nínú alábòójútó Django wa – ibi tó kàn tí a n lọ nìyẹn.
+
+## Ó ṣì ku nnkan kan: ṣàgbékalẹ̀!
+
+Yóò dára láti rí pé gbogbo èyí n ṣiṣẹ́ lórí Íńtánẹ́ẹ̀tì náà, àbí bẹ́ẹ̀ kọ? Jẹ́ ká ṣe àgbékalẹ̀ sí PythonAnywhere mìíràn:
+
+### Commit, kí o sì ti kóòdù rẹ sí GitHub
+
+Lákọ̀ọ́kọ́, jẹ́ ká wo àwọn fáìlì tó ti yí padà láti ìgbà tí a ti ṣàgbékalẹ̀ kẹ́yìn (ṣe àwọn àṣẹ wọ̀nyí lórí kọ̀mpútà rẹ, kìí ṣe lórí PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Ri dájú pé o wà nínú àkójọpọ̀ fáìlì `djangogirls` náà kí a sì sọ fún `git` láti ṣàfikún gbogbo àwọn ìyípadà tó wà nínú àkójọpọ̀ fáìlì yìí:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+Ṣáájú kí a tó gbé gbogbo àwọn fáìlì náà jáde, jẹ́ ká ṣàyẹ̀wò nnkan tí `git` yíò máa gbé jáde (ó yẹ kí gbogbo àwọn fáìlì tí `git` máa gbé jáde ti fojú hàn ní àwọ̀ ewé):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+A ti fẹ́rẹ̀ẹ́ débẹ̀, àkókò ti tó báyìí láti sọ fún-un pé kí ó tọ́jú ìyípadà yìí sínú ìtàn rẹ̀. A máa fún-un ní "ìròyìn commit" kan níbi tí a ti máa ṣàpèjúwe ohun tí a ti yípadà. O lè tẹ ohunkóhun tí o bá fẹ́ lákòókò yìí, ṣùgbọ́n ó máa wúlò láti tẹ nnkan ìṣàpèjúwe kan kí o bá lè rántí ohun tí o ti ṣe ní ọjọ́ iwájú.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Tá a bá ti ṣe ìyẹn, a máa gbé (ti) àwọn ìyípadà wa jáde sí GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Fa kóòdù tuntun rẹ sí PythonAnywhere, kí o sì ṣe ìmúdójúìwọ̀n ètò ayélujára rẹ
+
+* Ṣí [ojú-ìwé àwọn console PythonAnywhere](https://www.pythonanywhere.com/consoles/) náà kálẹ̀ kí o lọ sí **Bash console** rẹ (tàbí bẹ̀rẹ̀ tuntun kan). Lẹ́yìn náà, ṣe:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+O máa nílò láti rọ́pò `<your-pythonanywhere-domain>` pẹ̀lú orúkọ subdomain PythonAnywhere rẹ gan-an, láìsí àwọn àkámọ́ onígun náà. Orúkọ subdomain rẹ máa n sábà jẹ́ orúkọ aṣàmúlò PythonAnywhere rẹ, ṣùgbọ́n nígbà mìíràn ó lè yàtọ̀ díè (irú bíi tí orúkọ aṣàmúlò rẹ bá ní àwọn lẹ́tà ńlá). Nítorí náà, tí àṣẹ yìí kò bá ṣiṣẹ́, lo àṣẹ `ls` (ṣàkọsílẹ̀ àwọn fáìlì) náà láti wá orúkọ subdomain/fódà rẹ gan-an, lẹ́yìn náà `cd` lọ síbẹ̀.
+
+Ní báyìí, wo bí kóòdù rẹ ṣe n gba gbígbà. Tí o bá fẹ́ ṣàyẹ̀wò bóyá ó ti dé, o lè lọ sí **ojú-ìwé "Àwọn fáìlì"** náà kí o sì wo kóòdù rẹ lórí PythonAnywhere (o lè dé àwọn ojú-ìwé PythonAnywhere mìíràn láti bọ́tìnnì àkójọ àṣàyàn lórí ojú-ìwé console náà).
+
+* Ní ìparí, lọ sí [ojú-ìwé "Ayélujára"](https://www.pythonanywhere.com/web_app_setup/) náà kí o sì tẹ **Reload** lórí ètò ayélujára rẹ.
+
+Ó yẹ kí ìmúdójúìwọ̀n rẹ ti máa ṣiṣẹ́! Tẹ̀síwájú láti ṣe ìmúdójúìwọ̀n ààyè ayélujára rẹ nínú aṣàwákiri náà. Ó yẹ kí àwọn ìyípadà ti fojú hàn. :)
\ No newline at end of file
diff --git a/yo-NG/installation/README.md b/yo-NG/installation/README.md
new file mode 100644
index 00000000000..4d943361cb8
--- /dev/null
+++ b/yo-NG/installation/README.md
@@ -0,0 +1,68 @@
+# Tí o bá n ṣe àlàyé náà nílé
+
+Tí o bá n ṣe àlàyé náà nílé, tí kìí ṣe ní ọ̀kan lára àwọn [àpérò Django Girls](https://djangogirls.org/events/) náà, o lè fojú fo àkòrí yìí pátápátá ní báyìí kí o lọ tààrà sí àkòrí [Bí Íńtánẹ́ẹ̀tì ṣé n ṣiṣẹ́](../how_the_internet_works/README.md) náà.
+
+Ìdí ni pé a sọ̀rọ̀ nípa ṣíṣe àgbékalẹ̀ àwọn nnkan bí a ṣe nílò wọn nínú àlàyé náà -- èyí wulẹ̀ jẹ́ ojú-ìwé àfikún kan tó ṣàkójọ gbogbo àwọn ìtọ́sọ́nà ìṣàgbékalẹ̀ náà sójú kan (èyí tó wúlò fún àwọn àgbékalẹ̀ àpérò kan). O lè yàn láti ṣàgbékalẹ̀ gbogbo ohun tó wà lórí ojú-ìwé yìí ní báyìí tí o bá fẹ́. Ṣùgbọ́n tí o bá fẹ́ bẹ̀rẹ̀ síí kẹ́kọ̀ọ́ nípa àwọn nnkan ṣáájú ṣíṣe àgbékalẹ̀ wọn sórí kọ̀mpútà rẹ, fojú fo àkòrí yìí, a ó sì sàlàyé àwọn apá ìṣàgbékalẹ̀ náà fún ọ tó bá yá, tí a bá ti nílò wọn.
+
+Oríire fún ọ!
+
+# Tí o bá n kópa nínú àpérò kan
+
+Tí o bá n kópa nínú ọ̀kan lára àwọn [àpérò Django Girls](https://djangogirls.org/events/) náà:
+
+* Àpérò rẹ lè ní "ìdánilékọ̀ọ́ ìṣàgbékalẹ̀" kan ṣáájú àpérò pàtàkì náà. Tí o bá wà ní ìdánilékọ̀ọ́ ìṣàgbékalẹ̀ kan, ojú-ìwé yìí wà fún ọ! Tẹ̀lé àwọn ìtọ́sọ́nà tó wà níbí láti ṣàgbékalẹ̀ gbogbo ohun tí o nílò fún àpérò náà, pẹ̀lú ìrànlọ́wọ́ àwọn olùkọ tí o bá nílò wọn. Ní àpérò pàtàkì náà, ìwọ yíò lè fojú fo àwọn ìtọ́sọ́nà ìṣàgbékalẹ̀ tí o ma bá pàdé nínú àlàyé pàtàkì náà nígbà tí o bá débẹ̀.
+* Àwọn olùdarí àpérò rẹ le ti sọ fún ẹ pé kó o gbìyànjú láti ṣàgbékalẹ̀ gbogbo nnkan sórí kọ̀mpútà rẹ nílé ṣáájú kí àpérò náà tó bẹ̀rẹ̀. Tí wọ́n bá ti sọ fún ẹ pé kó o ṣe ìyẹn, ojú-ìwé yìí wà fún ọ! Tẹ̀lé àwọn ìtọ́sọ́nà tó wà níbí, láti ṣe ohun tí o lè ṣe. Ní àpérò pàtàkì náà, nígbà tí o bá dé ìgbésẹ̀ ìṣàgbékalẹ̀ kan nínú àlàyé pàtàkì náà, tí kò sì ṣeéṣe fún ọ láti ṣàgbékalẹ̀ nnkan yẹn tẹ́lẹ̀, o lè béèrè fún ìrànlọ́wọ́ lọ́dọ̀ olùkọ rẹ.
+* Tí àpérò rẹ kò bá ní ìdánilékọ̀ọ́ ìṣàgbékalẹ̀ kan (tàbí ìwọ kò lè kópa níbẹ̀), àti tí àwọn olùdarí àpérò náà kò bá sọ fún ẹ pé kó o gbìyànjú láti ṣàgbékalẹ̀ gbogbo nnkan ṣáájú kí o tó dé, fojú fo ojú-ìwé yìí kí o lọ tààrà sí àkòrí [Bí Íńtánẹ́ẹ̀tì ṣé n ṣiṣẹ́](../how_the_internet_works/README.md) náà. Ìwọ yíò ma ṣàgbékalẹ̀ gbogbo ohun tí o nílò bí o ṣé n ṣiṣẹ́ nípasẹ̀ àlàyé náà.
+
+# Ìṣàgbékalẹ̀
+
+Nínú àlàyé yìí, ìwọ yíò ma kọ́ blog kan. Láti lè ṣe ìyẹn, bí o ṣé n ka àlàyé náà lọ, ìwọ yíò gba ìtọ́sọ́nà lórí bí o ṣe lè ṣàgbékalẹ̀ oríṣiríṣi ètò sórí kọ̀mpútà rẹ àti ṣètò àwọn account kan lórí íńtánẹ́ẹ̀tì bíi a bá ṣe nílò wọn. Ojú-ìwé yìí ṣàkójọ gbogbo àwọn ìtọ́sọ́nà ìṣàgbékalẹ̀ àti ìforúkọsílẹ̀ náà sójú kan (èyí tó wúlò fún àwọn àgbékalẹ̀ àpérò kan).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Ọ̀pọ̀lọpọ̀ àwọn ìgbésẹ̀ tó wà nísàlẹ̀ tọ́ka sí "console", "èbúté" (terminal), "fèrèsé ìpàṣẹ" (command window), tàbí "ìlà ìpàṣẹ" (command line) -- ohun kannáà ní gbogbo àwọn wọ̀nyí: fèrèsé kan lórí kọ̀mpútà rẹ níbi tí o lè tẹ àwọn àṣẹ sí. Nígbà tí o bá dé àlàyé pàtàkì náà, ìwọ yíò kẹ́kọ̀ọ́ síi nípa ìlà ìpàṣẹ náà. Ní báyìí, ohun pàtàkì tí o nílò láti mọ̀ ní bí o ṣe lè ṣí fèrèsé ìpàṣẹ kan àti bó ṣe rí: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Lọ sí [GitHub.com](https://www.github.com) kí o sì forúkọ sílẹ̀ fún account aṣàmúlò ọ̀fẹ́ tuntun kan. Ri dájú láti rántí ọ̀rọ̀ aṣínà rẹ (ṣàfikún rẹ̀ sínú alákòóso ọ̀rọ̀ aṣínà rẹ, tí o bá lo ọ̀kan).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Bẹ̀rẹ̀ kíkà
+
+Kú oríire, o ti ṣètò gbogbo rẹ̀ àti pé o ṣetán láti bẹ̀rẹ̀! Tí o bá ṣì ní àkókò díẹ̀ ṣáájú àpérò náà, yóò wúlò láti bẹ̀rẹ̀ kíka díẹ̀ lára àwọn àkòrí ìbẹ̀rẹ̀ náà:
+
+* [Bí íńtánẹ́ẹ̀tì ṣé n ṣiṣẹ́](../how_the_internet_works/README.md)
+
+* [Ìfihàn sí ìlà ìpàṣẹ náà](../intro_to_command_line/README.md)
+
+* [Ìfihàn sí Python](../python_introduction/README.md)
+
+* [Kíni Django?](../django/README.md)
+
+# Gbádùn àpérò náà!
+
+Nígbà tí o bá bẹ̀rẹ̀ àpérò náà, ìwọ yíò lè lọ tààrà sí [Iṣẹ́ Django àkọ́kọ́ rẹ!](../django_start_project/README.md) nítorí pé o ti mọ àlàyé tó wà nínú àwọn àkòrí ìṣáájú náà tẹ́lẹ̀.
\ No newline at end of file
diff --git a/yo-NG/intro_to_command_line/README.md b/yo-NG/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5bef7be5735
--- /dev/null
+++ b/yo-NG/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# Ìfihàn sí atọ́kùn ìlà ìpàṣẹ náà
+
+> Fún àwọn òǹkàwé ní ilé: a ti ṣàlàyé àkòrí yìí nínú fídíò [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8).
+
+Ó ń dùn mọ́ni, àbí bẹ́ẹ̀ kọ? Ìwọ yíò kọ ìlà kóòdù àkọ́kọ́ rẹ láàárín ìṣẹ́jú díẹ̀! :)
+
+**Jẹ́ kí a mú ọ mọ ọ̀rẹ́ tuntun àkọ́kọ́ rẹ: ìlà ìpàṣẹ náà!**
+
+Àwọn ìgbésẹ̀ wọ̀nyí yíò fihàn ọ́ bí o ṣe lè lo fèrèsé dúdú tí gbogbo àwọn hacker má n lò. Ó lè dẹ́rù bà ọ́ díẹ̀ lákọ̀ọ́kọ́ ṣùgbọ́n lóòótọ́ ó kàn jẹ́ ètò kan tó n dúró de àwọn àṣẹ láti ọ̀dọ̀ rẹ.
+
+> **Àkíyèsí** Jọ̀wọ́ ṣàkíyèsí pé káàkiri ìwé yìí, a lo àwọn ọ̀rọ̀ 'àkójọpọ̀ fáìlì' (directory) àti 'fódà' (folder) ní pàṣípààrọ̀ ṣùgbọ́n wọn jẹ́ ohun kannáà.
+
+## Kíni ìlà ìpàṣẹ náà?
+
+Fèrèsé náà, èyí tí a sábà má n pè ní **ìlà ìpàṣẹ** tàbí **atọ́kùn ìlà ìpàṣẹ**, jẹ́ ètò kan tó dá lórí ọ̀rọ̀ fún wíwo, bíbójútó, àti dídarí àwọn fáìlì lórí kọ̀mpútà rẹ. Ó dà bíi Windows Explorer tàbí Finder lórí Mac, ṣùgbọ́n láìsí atọ́kùn aláwòrán náà. Àwọn orúkọ mìíràn fún ìlà ìpàṣẹ náà jẹ́: *cmd*, *CLI*, *prompt*, *console* tàbí *terminal*.
+
+## Ṣí atọ́kùn ìlà ìpàṣẹ náà
+
+Láti bẹ̀rẹ̀ àwọn ìdánrawò kan, a nílò láti kọ́kọ́ ṣí atọ́kùn ìlà ìpàṣẹ wa.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## Prompt
+
+Ní báyìí, ó yẹ kí o rí fèrèsé funfun tàbí dúdú kan tó n dúró de àwọn àṣẹ rẹ.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+Tí o bá wà lórí Mac tàbí Linux, ó ṣeéṣe kí o rí `$` kan, báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+Lórí Windows, ó ṣeéṣe kí o rí `>` kan, báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Ṣàyẹ̀wò abala Linux tí a ṣẹ̀ṣẹ̀ kọjá sókè -- ìwọ yíò rí nnkan kan tó jọ bẹ́ẹ̀ nígbà tí o bá dé PythonAnywhere tó bá yá nínú àlàyé náà.
+
+<!--endsec-->
+
+Àṣẹ kọ̀ọ̀kan yíò bẹ̀rẹ̀ pẹ̀lú `$` tàbí `>` àti àlàfo kan, ṣùgbọ́n ìwọ kò gbọ́dọ̀ tẹ̀ ẹ́. Kọ̀mpútà rẹ yíò ṣe fún ọ. :)
+
+> Àkíyèsí kékeré kan: ó ṣeéṣe kí o rí nnkan kan bíi `C:\Users\ola>` tàbí `Olas-MacBook-Air:~ ola$` ṣáájú àmì prompt náà, èyí dára 100%.
+
+Apá náà títí dé àti pẹ̀lú `$` tàbí `>` náà ní a pè ní *command line prompt*, tàbí *prompt* ní kúkúrú. Yíò fún ọ ní ìṣítí láti tẹ nnkan kan síbẹ̀.
+
+Nínú àlàyé náà, nígbà tí a bá fẹ́ kí o tẹ àṣẹ kan, a ó ṣàfikún `$` tàbí `>` náà, àti àwọn nnkan mìíràn sí apá òsì lẹ́ẹ̀kọ̀ọ̀kan. Fojú fo apá òsì náà kí o sì tẹ àṣẹ náà nìkan, èyí tí yíò bẹ̀rẹ̀ lẹ́yìn prompt náà.
+
+## Àṣẹ àkọ́kọ́ rẹ (YAY!)
+
+Jẹ́ ká bẹ̀rẹ̀ nípasẹ̀ títẹ̀ àṣẹ yìí:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+Lẹ́yìn náà tẹ `enter`. Èyí ni èsì wa:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+Gẹ́gẹ́ bó o ṣe rí i, kọ̀mpútà náà ṣẹ̀ṣẹ̀ ṣàtẹ̀jáde orúkọ aṣàmúlò rẹ. Ó já fáfá, àbí bẹ́ẹ̀ kọ? :)
+
+> Gbìyànjú láti tẹ àṣẹ kọ̀ọ̀kan; má ṣàdàkọ rẹ̀. Ìwọ yíò rántí ní ìrọ̀rùn lọ́nà yìí!
+
+## Àwọn ìpìlẹ̀
+
+Ètò ìṣiṣẹ́ kọ̀mpútà kọ̀ọ̀kan ló ní ìlànà àwọn àṣẹ tó yàtọ̀ síra fún ìlà ìpàṣẹ náà, nítorí náà ri dájú láti tẹ̀lé àwọn ìtọ́sọ́nà fún ètò ìṣiṣẹ́ rẹ. Jẹ́ ká gbìyànjú èyí, ṣé ká bẹ̀rẹ̀?
+
+### Àkójọpọ̀ fáìlì lọ́wọ́lọ́wọ́
+
+Yíò dára láti mọ ibi tí a wà ní báyìí, àbí bẹ́ẹ̀ kọ? Jẹ́ ká ri. Tẹ àṣẹ yìí kí o sì tẹ `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Àkíyèsí: 'pwd' dúró fún 'print working directory' (ṣàtẹ̀jáde àkójọpọ̀ fáìlì tó n ṣiṣẹ́).
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+Ó ṣeéṣe kí o rí ohun tó jọ bẹ́ẹ̀ lórí ẹ̀rọ rẹ. Tó o bá ṣí ìlà ìpàṣẹ náà, o sábà máa ń bẹ̀rẹ̀ láti àkójọpọ̀ fáìlì ìpìlẹ̀ ti aṣàmúlò rẹ.
+
+* * *
+
+### Kẹ́kọ̀ọ́ sí i nípa àṣẹ kan
+
+Ọ̀pọ̀lọpọ̀ àwọn àṣẹ tí o lè tẹ̀ ní command prompt náà ní ìrànlọ́wọ́ tó ba wá tí o lè ṣàfihàn àti kà! Fún àpẹẹrẹ, láti kẹ́kọ̀ọ́ sí i nípa àṣẹ àkójọpọ̀ fáìlì lọ́wọ́lọ́wọ́ náà:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X àti Linux ní àṣẹ `man` kan, èyí tí yíò fún ọ ní ìrànlọ́wọ́ lórí àwọn àṣẹ. Gbìyànjú `man pwd` kí o sì rí ohun tí yíò sọ, tàbí tẹ `man` ṣáájú àwọn àṣẹ mìíràn láti rí ìrànlọ́wọ́ wọn. Èsì `man` náà má n sábà ní àwọn ojú-ìwé. Lo bọ́tìnnì àlàfo náà láti bọ́ sí ojú-ìwé tó kàn, àti `q` láti jáwọ́ nínú wíwo ìrànlọ́wọ́ náà.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Ṣíṣe àfikún `/?` kan sẹ́yìn ọ̀pọ̀lọpọ̀ àwọn àṣẹ yíò ṣàtẹ̀jáde ojú-ìwé ìrànlọ́wọ́ náà. O lè nílò láti sún fèrèsé ìpàṣẹ rẹ sókè láti rí gbogbo rẹ̀. Gbìyànjú `cd /?`.
+
+<!--endsec-->
+
+### Ṣe àkọsílẹ̀ àwọn fáìlì àti àwọn àkójọpọ̀ fáìlì
+
+Nítorí náà kí ló wà nínú rẹ̀? Yíò dára láti rí ìdáhùn sí i. Jẹ́ ká ri:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Ṣàyípadà àkójọpọ̀ fáìlì lọ́wọ́lọ́wọ́
+
+Ní báyìí, ẹ jẹ́ ká lọ sí àkójọpọ̀ fáìlì Desktop wa:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Ṣàkíyèsí pé ó ṣeéṣe kí a túmọ̀ orúkọ àkójọpọ̀ fáìlì "Desktop" náà sí èdè account Linux rẹ. Tó bá rí bẹ́ẹ̀, ìwọ yíò nílò láti rọ́pò `Desktop` pẹ̀lú orúkọ tí a túmọ̀ rẹ̀ sí; fún àpẹẹrẹ, `Schreibtisch` fún èdè Jẹ́mánì.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Ṣàyẹ̀wò bóyá ó ti yípadà lóòótọ́:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Òhun nìyí!
+
+> Àmọ̀ràn akọ́ṣẹ́mọṣẹ́: tí o bá tẹ `cd D` tí o tún wá tẹ `tab` lórí pẹpẹ bọ́tìnnì rẹ, ìlà ìpàṣẹ náà yíò parí ìyókù orúkọ náà fúnra rẹ̀ kí o lè yàrá ṣiṣẹ́. Tí fódà tó ju ẹyọkan lọ bá wà tó n bẹ̀rẹ̀ pẹ̀lú "D", tẹ bọ́tìnnì `tab` náà lẹ́ẹ̀mejì láti rí àkójọ àwọn àṣàyàn kan.
+
+* * *
+
+### Ṣẹ̀dá àkójọpọ̀ fáìlì
+
+Ṣíṣẹ̀dá àkójọpọ̀ fáìlì practice (ìdánrawò) kan lórí desktop rẹ ńkọ́? O lè ṣe é lọ́nà yìí:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+Àṣẹ kékeré yìí yíò ṣẹ̀dá fódà kan pẹ̀lú orúkọ `practice` náà sórí desktop rẹ. O lè ṣàyẹ̀wò bóyá ó wà níbẹ̀ nípasẹ̀ wíwo orí Desktop rẹ tàbí nípasẹ̀ lílo àṣẹ `ls` tàbí `dir` kan! Gbìyànjú rẹ̀. :)
+
+> Àmọ̀ràn akọ́ṣẹ́mọṣẹ́: Tí ìwọ kò bá fẹ́ tẹ àwọn àṣẹ kannáà léraléra, gbìyànjú títẹ `up arrow` àti `down arrow` lórí pẹpẹ bọ́tìnnì rẹ láti yípo àwọn àṣẹ tí o lò láìpẹ́.
+
+* * *
+
+### Ìdánrawò!
+
+Ìdánrawò kékeré kan fún ẹ: nínú àkójọpọ̀ fáìlì `practice` tí o ṣẹ̀ṣẹ̀ ṣẹ̀dá, ṣẹ̀dá àkójọpọ̀ fáìlì kan tí a pè ní `test`. (Lo àwọn àṣẹ `cd` àti `mkdir` náà.)
+
+#### Ojútùú:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Kú oríire! :)
+
+* * *
+
+### Ìpalẹ̀mọ́
+
+A kò fẹ́ fi gbogbo rẹ̀ sílẹ̀ rádaràda, nítorí náà jẹ́ ká yọ gbogbo ohun tí a ti ṣe títí dìgbà yẹn kúrò.
+
+Lákọ̀ọ́kọ́, a nílò láti padà sí Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Lílo `..` pẹ̀lú àṣẹ `cd` náà yíò ṣàyípadà àkójọpọ̀ fáìlì lọ́wọ́lọ́wọ́ rẹ sí àkójọpọ̀ fáìlì ìpìlẹ̀ (ìyẹn ni pé, àkójọpọ̀ fáìlì tó kó àkójọpọ̀ fáìlì lọ́wọ́lọ́wọ́ rẹ sínú).
+
+Ṣàyẹ̀wò ibi tí o wà:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Àkókò láti yọ àkójọpọ̀ fáìlì `practice` náà kúrò:
+
+> **Àkíyèsí**: Yíyọ àwọn fáìlì kúrò pẹ̀lú lílo `del`, `rmdir` tàbí `rm` kò sẹ́ rí gbà padà mọ́, tó túmọ̀sí pé *àwọn fáìlì tí o yọ kúrò náà máa di àwátì*! Nítorí náà, ṣọ́ra gidigidi pẹ̀lú àṣẹ yìí.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Ó ti gba ṣíṣe! Láti rí dájú pé ó ti gba yíyọ kúrò lóòótọ́, jẹ́ ká ṣàyẹ̀wò rẹ̀:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Jáde
+
+A ó dúró síbí lásìkò yìí! O lè pa ìlà ìpàṣẹ náà dé ní báyìí láìséwu. Jẹ́ ká ṣé lọ́nà àwọn hacker, ó dára? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Ó dára, àbí bẹ́ẹ̀ kọ? :)
+
+## Kókó pàtàkì
+
+Kókó pàtàkì kan ti àwọn àṣẹ tó wúlò nìyí:
+
+| Àṣẹ (Windows)  | Àṣẹ (Mac OS / Linux) | Àpèjúwe                                    | Àpẹẹrẹ                                               |
+| -------------- | -------------------- | ------------------------------------------ | ---------------------------------------------------- |
+| exit           | exit                 | pa fèrèsé náà dé                           | **exit**                                             |
+| cd             | cd                   | ṣàyípadà àkójọpọ̀ fáìlì                    | **cd test**                                          |
+| cd             | pwd                  | ṣàfihàn àkójọpọ̀ fáìlì lọ́wọ́lọ́wọ́ náà    | **cd** (Windows) tàbí **pwd** (Mac OS / Linux)       |
+| dir            | ls                   | ṣe àkọsílẹ̀ àwọn àkójọpọ̀ fáìlì/àwọn fáìlì | **dir**                                              |
+| copy           | cp                   | ṣe àdàkọ fáìlì                             | **copy c:\test\test.txt c:\windows\test.txt**    |
+| move           | mv                   | gbé fáìlì                                  | **move c:\test\test.txt c:\windows\test.txt**    |
+| mkdir          | mkdir                | ṣẹ̀dá àkójọpọ̀ fáìlì tuntun kan            | **mkdir testdirectory**                              |
+| rmdir (or del) | rm                   | yọ fáìlì kan kúrò                          | **del c:\test\test.txt**                           |
+| rmdir /S       | rm -r                | yọ àkójọpọ̀ fáìlì kan kúrò                 | **rm -r testdirectory**                              |
+| [CMD] /?       | man [CMD]            | gba ìrànlọ́wọ́ fún àṣẹ kan                 | **cd /?** (Windows) tàbí **man cd** (Mac OS / Linux) |
+
+Àwọn wọ̀nyí jẹ́ díẹ̀ lára àwọn àṣẹ tí o lè lò nínú ìlà ìpàṣẹ rẹ, ṣùgbọ́n ìwọ kò ní lo ju ìyẹn lọ lónìí.
+
+Tí o bá fẹ́ mọ síi, [ss64.com](http://ss64.com) ní ìtọ́kasí pípé kan tí àwọn àṣẹ fún gbogbo àwọn ètò ìṣiṣẹ́ kọ̀mpútà.
+
+## Ṣé o ti ṣetán?
+
+Jẹ́ ká wọ inú Python!
\ No newline at end of file
diff --git a/yo-NG/intro_to_command_line/open_instructions.md b/yo-NG/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..0257c3ca4d1
--- /dev/null
+++ b/yo-NG/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Ní èyí tó dá lórí ẹyà Windows rẹ àti pẹpẹ bọ́tìnnì rẹ, ó yẹ kí ọ̀kan lára àwọn wọ̀nyí ṣí fèrèsé àṣẹ kan (o lè nílò láti ṣe ìdánrawò díẹ̀, ṣùgbọ́n o ò ní láti gbìyànjú gbogbo àwọn àbá wọ̀nyí):
+
+- Lọ sí àkójọ àṣàyàn Start tàbí ojú àwòrán Start náà, kí o sì tẹ "Command Prompt" sínú ààyè ìṣàwárí náà.
+- Lọ sí àkójọ àṣàyàn Start → Windows System → Command Prompt.
+- Lọ sí àkójọ àṣàyàn Start → All Programs → Accessories → Command Prompt.
+- Lọ sí ojú àwòrán Start náà, gbé àmì-atọ́ka rẹ sí igun ìsàlẹ̀ lápá òsì ojú àwòrán náà, kí o tẹ àmì ìtọ́ka ìsàlẹ̀ tó bá farahàn (lórí ojú àwòrán aláfọwọ́kàn kan, wọ sókè láti ìsàlẹ̀ ojú àwòrán náà). Ó yẹ kí ojú-ìwé Apps náà ṣí. Tẹ Command Prompt nínú abala Windows System náà.
+- Tẹ bọ́tìnnì àkànṣe Windows náà mólẹ̀ lórí pẹpẹ bọ́tìnnì rẹ kí o sì tẹ bọ́tìnnì "X" náà. Yan "Command Prompt" láti àkójọ àṣàyàn aṣẹ́yọsókè náà.
+- Tẹ bọ́tìnnì Windows náà mólẹ̀ kí o sì tẹ bọ́tìnnì "R" náà láti rí fèrèsé "Rún" kan. Tẹ "cmd" sínú àpótí náà, kí o sì tẹ bọ́tìnnì OK náà.
+
+![Tẹ "cmd" sínú fèrèsé "Run" náà](../python_installation/images/windows-plus-r.png)
+
+Tó bá yá nínú àlàyé yìí, ìwọ yíò nílò láti ní fèrèsé ìpàṣẹ méjì ní ṣíṣí lásìkò kannáà. Àmọ́ o, lórí àwọn ẹyà Windows kan, tí o bá ti ṣí fèrèsé ìpàṣẹ kan tẹ́lẹ̀ tí o wá n gbìyànjú láti ṣí ẹlẹ́ẹ̀kejì pẹ̀lú lílo ọ̀nà kannáà, yóò ma tọ́ka rẹ sí fèrèsé ìpàṣẹ tí o ti ṣí kalẹ̀ tẹ́lẹ̀. Gbìyànjú rẹ̀ ní báyìí lórí kọ̀mpútà rẹ kí o rí ohun tí yíò ṣẹlẹ̀! Tí o bá rí fèrèsé ìpàṣẹ kan ṣoṣo, gbìyànjú ọ̀kan lára àwọn ọ̀nà mìíràn nínú àkójọ tó wà lókè náà. Ó kéré tán, ó yẹ kí ọ̀kan lára wọn yọrí sí ṣíṣí fèrèsé ìpàṣẹ tuntun kan.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Lọ sí Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+Ó ṣeéṣe kó wà lábẹ́ Applications → Accessories → Terminal, tàbí Applications → System → Terminal, ṣùgbọ́n ìyẹn lè kù sí ọwọ́ ètò ìṣiṣẹ́ rẹ. Tí kò bá sí níbẹ̀, o lè gbìyànjú láti ṣe ìwádìí lórí Google. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/yo-NG/python_installation/README.md b/yo-NG/python_installation/README.md
new file mode 100644
index 00000000000..f90dd3e1cc8
--- /dev/null
+++ b/yo-NG/python_installation/README.md
@@ -0,0 +1,15 @@
+# Jẹ́ ká bẹ̀rẹ̀ pẹ̀lú Python
+
+A ti dé ibí yìí nígbẹ̀yìn!
+
+Ṣùgbọ́n lákọ̀ọ́kọ́, jẹ́ kí a sọ ohun tí Python jẹ́ fún ọ. Python jẹ́ èdè kóòdù kíkọ kan tó gbajúmọ̀ púpọ̀ tí a lè lò fún ṣíṣẹ̀dá àwọn ààyè ayélujára, àwọn eré, àwọn ètò ìmọ̀ sáyẹ́ǹsì, àwọn àwòrán, àti bẹ́ẹ̀ bẹ́ẹ̀ lọ.
+
+Python pilẹ̀ṣẹ̀ ní apá ìparí àwọn ọdún 1980 àti pé àfojúsùn pàtàkì rẹ̀ ni láti rọrùn láti kà fún àwọn èèyàn (kìí ṣe àwọn ẹ̀rọ nìkan!). Ìdí nìyí tó fi dàbí pé ó rọrùn ju àwọn èdè kóòdù kíkọ mìíràn, sùgbọ́n má dààmú – Python lágbára púpọ̀ bákannáà!
+
+# Ìṣàgbékalẹ̀ Python
+
+> **Àkíyèsí** Tí o bá n lo Chromebook kan, fojú fo àkòrí yìí kí o sì rí dájú pé o tẹ̀lé àwọn ìtọ́sọ́nà [Àgbékalẹ̀-ètò Chromebook](../chromebook_setup/README.md) náà.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/yo-NG/python_installation/instructions.md b/yo-NG/python_installation/instructions.md
new file mode 100644
index 00000000000..d54844c92d2
--- /dev/null
+++ b/yo-NG/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> Fún àwọn òǹkàwé ní ilé: a ti ṣàlàyé àkòrí yìí nínú fídíò [Ṣíṣe àgbékalẹ̀ Python & Olóòtú Kóòdù](https://www.youtube.com/watch?v=pVTaqzKZCdA).
+> 
+> Abala yìí dá lórí àlàyé kan ti Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django gba kíkọ ní Python. A nílò Python láti ṣe ohunkóhun nínú Django. Ẹ jẹ́ ká bẹ̀rẹ̀ nípasẹ̀ ṣíṣe àgbékalẹ̀ rẹ̀! A fẹ́ kí o ṣàgbékalẹ̀ ẹyà tó jáde gbẹ̀yìn ti Python 3, nítorí náà tí o bá ní èyíkéyìí ẹyà tàtijọ́, ìwọ yíò nílò láti ṣe ìmúdójúìwọ̀n rẹ̀. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Jọ̀wọ́ ṣàgbékalẹ̀ ojúlówó Python báyìí, kódà nígbà tí o bá ti ṣàgbékalẹ̀ Anaconda tẹ́lẹ̀ sórí kọ̀mpútà rẹ.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+Kọ́kọ́ ṣàyẹ̀wò bóyá kọ̀mpútà rẹ n ṣiṣẹ́ pẹ̀lú ẹyà 32-bit kan tàbí ẹyà 64-bit kan ti Windows, lórí ìlà "System type" ti ojú-ìwé System Info náà. Láti dé ojú-ìwé yìí, gbìyànjú ọ̀kan lára àwọn ọ̀nà wọ̀nyí:
+
+* Tẹ bọ́tìnnì Windows àti bọ́tìnnì Pause/Break lẹ́ẹ̀kan náà
+* Ṣí Control Panel rẹ láti àkójọ àṣàyàn Windows náà, lẹ́yìn náà lọ sí System & Security, lẹ́yìn náà System
+* Tẹ bọ́tìnnì Windows náà, lẹ́yìn náà lọ sí Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+O lè gba Python fún Windows láti ààyè ayélujára náà https://www.python.org/downloads/windows/. Tẹ orí atọ́ka "Latest Python 3 Release - Python x.x.x" náà. Tí kọ̀mpútà rẹ bá n ṣiṣẹ́ pẹ̀lú ẹyà **64-bit** ti Windows kan, gba **Windows x86-64 executable installer** náà. Bí bẹ́ẹ̀ kọ́, gba **Windows x86 executable installer** náà. Lẹ́yìn tí o bá gba aṣàgbékalẹ̀ náà, ó yẹ kí o mú u ṣiṣẹ́ (ṣíra tẹ̀ẹ́ lẹ́ẹ̀mejì) àti tẹ̀lé àwọn ìtọ́sọ́nà tó wà níbẹ̀.
+
+Nnkan kan láti ṣọ́ra fún: Lásìkò ìṣàgbékalẹ̀ náà, ìwọ yíò ṣàkíyèsí fèrèsé kan pẹ̀lú àmì "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Má gbàgbé láti ṣàfikún Python sí Atọ́nà náà](../python_installation/images/python-installation-options.png)
+
+Nígbà tí ìṣàgbékalẹ̀ náà bá parí, o lè rí àpótí ìsọ̀rọ̀gbèsì kan pẹ̀lú atọ́ka kan tí o lè tẹ̀lé láti kẹ́kọ̀ọ́ síi nípa Python tàbí nípa ẹyà tí o ṣàgbékalẹ̀ náà. Pa àpótí ìsọ̀rọ̀gbèsì yẹn dé tàbí fagi lé -- ìwọ yíò ma kẹ́kọ̀ọ́ síi nínú àlàyé yìí!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Gba fáìlì *Mac OS X 64-bit/32-bit installer* náà,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/yo-NG/python_introduction/README.md b/yo-NG/python_introduction/README.md
new file mode 100644
index 00000000000..5eeac7cb922
--- /dev/null
+++ b/yo-NG/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Ìfihàn sí Python
+
+> Apá kan lára àkòrí yìí dá lórí àwọn àlàyé ti Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Jẹ́ ká kọ àwọn kóòdù kan!
+
+## Python prompt
+
+> Fún àwọn òǹkàwé ní ilé: a ti ṣàlàyé apá yìí nínú fídíò [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U).
+
+Láti bẹ̀rẹ̀ ṣíṣe eré pẹ̀lú Python, a nílò láti ṣí *ìlà ìpàṣẹ* kan kalẹ̀ lórí kọ̀mpútà rẹ. Ó yẹ kí o ti mọ bí o ṣe lè ṣe ìyẹn – o ti kọ́ ọ nínú àkòrí [Ìfihàn sí Ìlà Ìpàṣẹ](../intro_to_command_line/README.md) náà.
+
+Tí o bá ti ṣetán, tẹ̀lé àwọn ìtọ́sọ́nà tó wà nísàlẹ̀.
+
+A fẹ́ ṣí console Python kan, nítorí náà tẹ `python` lórí Windows tàbí `python3` lórí Mac OS/Linux kí o sì tẹ `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Àṣẹ Python àkọ́kọ́ rẹ!
+
+Lẹ́yìn ṣíṣe àṣẹ Python náà, prompt náà yípadà sí `>>>`. Fún wa, èyí túmọ̀ sí pé ní báyìí a lè lo àwọn àṣẹ ni èdè Python nìkan. Ìwọ kò ní láti tẹ `>>>` – Python yíò ṣe ìyẹn fún ẹ.
+
+Tí o bá fẹ́ jáde nínú console Python náà nígbàkigbà, tẹ `exit()` tàbí lo àbùjá `Ctrl + Z` fún Windows àti `Ctrl + D` fún Mac/Linux. Lẹ́yìn náà ìwọ kò ní rí `>>>` mọ́.
+
+Ní báyìí, a kò fẹ́ jáde nínú console Python náà. A fẹ́ kẹ́kọ̀ọ́ síi nípa rẹ̀. Jẹ́ ká bẹ̀rẹ̀ pẹ̀lú títẹ àwọn ìṣirò kan, bíi `2 + 3` àti títẹ `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Ó dára! Wo bí ìdáhùn náà ṣe yọ síta? Python mọ ìṣirò! O lè gbìyànjú àwọn àṣẹ mìíràn bíi:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+Láti ṣe ìṣirò lọ́nà ìlọ́po agbára, ká sọ pé 2 ní ìlọ́po agbára 3, a máa tẹ: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Ṣeré pẹ̀lú èyí fún ìgbà díẹ̀ kí o sì padà síbí lẹ́yìn náà. :)
+
+Gẹ́gẹ́ bó o ṣe ríi, Python jẹ́ ètò-ìṣèṣirò tó wúlò púpọ̀ kan. Tí o bá n ṣe kàyéfì nipa ohun mìíràn tí o lè ṣe…
+
+## Àwọn Fọ́nrán
+
+Orúkọ rẹ ńkọ́? Tẹ orúkọ àkọ́kọ́ rẹ nínú àwọn àmì àyọlò báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+O ti ṣẹ̀dá fọ́nrán àkọ́kọ́ rẹ báyìí! Ó jẹ́ ìtòtẹ̀léra àwọn ẹyọ ọ̀rọ̀ tí kọ̀mpútà kan lè ṣiṣẹ́ lórí. Fọ́nrán náà gbọ́dọ̀ bẹ̀rẹ̀ àti parí pẹ̀lú ẹyọ ọ̀rọ̀ kannáà. Èyí lè jẹ́ àwọn àmì àyọlò kan ṣoṣo (`'`) tàbí méjì (`"`) (kò sí ìyàtọ̀!) Àwọn àmì àyọlò náà n sọ fún Python pé ohunkóhun tó wà nínú wọn jẹ́ fọ́nrán kan.
+
+A lè so àwọn fọ́nrán papọ̀. Gbìyànjú èyí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+O tún lè ṣe ìlọ́po àwọn fọ́nrán pẹ̀lú nọ́mbà kan:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+Tí o bá nílò láti fi kọmá olókè kan sínú fọ́nrán rẹ, o ní ọ̀nà méjì láti gbà ṣe é.
+
+Lílo àmì àyọlò méjì:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+tàbí yẹra fún kọmá olókè náà pẹ̀lú àmì adagun sósì kan (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Ó dára, àbí bẹ́ẹ̀ kọ? Láti rí orúkọ rẹ ní àwọn lẹ́tà-ńlá, tẹ:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+O ṣẹ̀ṣẹ̀ lo **ọ̀nà** `upper` lórí fọ́nrán rẹ! Ọ̀nà kan (bíi `upper()`) jẹ́ ìtòtẹ̀léra àwọn ìtọ́sọ́nà tí Python ní láti ṣe lórí ohun èlò kan tí a fun (`"Ola"`) nígbà tí o bá pè é.
+
+Tí o bá fẹ́ mọ iye lẹ́tà tó wà nínú orúkọ rẹ, **iṣẹ́** kan wà fún ìyẹn náà!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+O lè máa ronú pé nígbà mìíràn o pe àwọn iṣẹ́ pẹ̀lú `.` kan ní ìparí fọ́nrán kan (bíi `"Ola".upper()`) àti pé nígbà mìíràn o kọ́kọ́ pe iṣẹ́ kan tí o sì fi fọ́nrán náà sínú àkámọ́? Ó dáa, ní àwọn ìṣẹ̀lẹ̀ kan, àwọn iṣẹ́ jẹ́ ti àwọn ohun èlò, bíi `upper()`, èyí tó lè gba ṣíṣe lórí àwọn fọ́nrán nìkan. Ní irú ìṣẹ̀lẹ̀ yìí, a pe iṣẹ́ náà ní **ọ̀nà** kan. Ní àwọn ìgbà mìíràn, àwọn iṣẹ́ kìí ṣe ti ohunkóhun pàtó àti pé ó lè jẹ́ lílò lórí oríṣiríṣi ohun èlò, gẹ́gẹ́ bí `len()`. Ìdí nìyẹn tí a ṣé n gbé `"Ola"` kalẹ̀ gẹ́gẹ́ bí parameter kan sí iṣẹ́ `len` náà.
+
+### Kókó pàtàkì
+
+O dáa, ó tó nípa àwọn fọ́nrán. Títí di báyìí, o ti kẹ́kọ̀ọ́ nípa:
+
+- **prompt náà** – títẹ àwọn àṣẹ (kóòdù) sínú prompt Python náà yíò yọrí sí àwọn ìdáhùn ní Python
+- **àwọn nọ́mbà àti àwọn fọ́nrán** – nínú Python, àwọn nọ́mbà jẹ́ lílò fún ìṣirò àti pé àwọn fọ́nrán fún àwọn ohun èlò ọ̀rọ̀
+- **operators** – bíi `+` àti `*`, máa pa àwọn iye pọ̀ láti gbé iye tuntun kan jáde
+- **àwọn iṣẹ́** – bíi `upper()` àti `len()`, máa ṣiṣẹ́ lórí àwọn ohun èlò.
+
+Àwọn wọ̀nyí jẹ́ àwọn ìpìlẹ̀ gbogbo èdè kóòdù kíkọ tí o bá kọ́. Ṣé o ti ṣetán fún nnkan tó túbọ̀ ṣòro? A retí pé o ti ṣetán!
+
+## Àwọn Àṣìṣe
+
+Jẹ́ ká gbìyànjú nnkan tuntun kan. Ṣe a lè gba gígùn nọ́mbà kan lọ́nà kannáà tí a gbà wádìí gígùn orúkọ wa? Tẹ `len(304023)` kí o sì tẹ `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+A rí àṣìṣe àkọ́kọ́ wa! Àwòrán aṣàmì {{ warning_icon }} náà jẹ́ ọ̀nà wa láti fún ọ ní ìkìlọ̀ pé kóòdù tí o fẹ́ ṣe kò ní ṣiṣẹ́ bí o ti retí. Ṣíṣe àṣìṣe (kódà àwọn tí o mọ̀ọ́mọ̀ ṣe) jẹ́ apá kan tó ṣe pàtàkì nínú ìkẹ́kọ̀ọ́!
+
+Ó sọ wípé àwọn ohun èlò tó jẹ́ irú "int" (integers, àwọn nọ́mbà odidi) kò ní gígùn. Nítorí náà, kí ní a lè ṣe báyìí? Bóyá a lè kọ nọ́mbà wa gẹ́gẹ́ bí fọ́nrán kan? Àwọn fọ́nrán ní gígùn kan, àbí bẹ́ẹ̀ kọ?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+Ó ṣiṣẹ́! A lo iṣẹ́ `str` nínú iṣẹ́ `len` náà. `str()` yíò yí gbogbo nnkan sí àwọn fọ́nrán.
+
+- Iṣẹ́ `str` náà yíò ṣàyípadà àwọn nnkan sí **fọ́nrán**
+- Iṣẹ́ `int` náà yíò ṣàyípadà àwọn nnkan sí **nọ́mbà odidi**
+
+> Ní pàtàkì: a lè ṣàyípadà àwọn nọ́mbà sí ọ̀rọ̀, ṣùgbọ́n a kò lè fi dandan ṣàyípadà ọ̀rọ̀ sí nọ́mbà – kíni `int('hello')` yíò jẹ́ gan-an?
+
+## Àwọn variable
+
+Ìlànà pàtàkì kan nínú kóòdù kíkọ ni àwọn variable. Variable kan kò jẹ́ nnkan kan ju orúkọ kan fún nnkan kan kí o bàa lè lò ó nígbà mìíràn. Àwọn onímọ̀ nípa kóòdù máa n lo àwọn variable wọ̀nyí láti tọ́jú dátà, mú kóòdù wọn rọrùn láti kà àti nítorí náà wọn kò ní láti máa rántí ohun tí àwọn nnkan jẹ́.
+
+Jẹ́ ká sọ pé a fẹ́ ṣẹ̀dá variable tuntun kan tí a n pè ní `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+A tẹ orúkọ dọ́gba pẹ̀lú Ola.
+
+Gẹ́gẹ́ bí o ti ṣàkíyèsí, ètò rẹ kò dá ohunkóhun padà bíi ó ti ṣe tẹ́lẹ̀. Nítorí náà, báwo ni a ṣe fẹ́ mọ pé variable náà wà lóòótọ́? Tẹ `name` kí o sì tẹ `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Variable àkọ́kọ́ rẹ! :) O lè tún ṣàyípadà ohun tó n tọ́ka sí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+O tún lè lò ó nínú àwọn iṣẹ́:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Ó dára, àbí bẹ́ẹ̀ kọ? Ní báyìí, àwọn variable lè jẹ́ ohunkóhun – àwọn nọ́mbà pẹ̀lú! Gbìyànjú èyí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+Ṣùgbọ́n tí a bá lo orúkọ tí kò tọ́ ńkọ́? Kí lo rò pé yíò ṣẹlẹ̀? Jẹ́ ká gbìyànjú!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+Àṣìṣe kan! Gẹ́gẹ́ bó o ṣe ríi, Python ní oríṣiríṣi àwọn àṣìṣe àti pé èyí ni a n pè ní **NameError**. Python yíò fún ọ ní àṣìṣe yìí tí o bá gbìyànjú láti po variable kan tí a kò tíì ṣàlàyé. Tí o bá pàdé àṣìṣe yìí tó bá yá, ṣàyẹ̀wò kóòdù rẹ láti wo bóyá o ti ṣe àṣìṣe títẹ àwọn orúkọ kankan.
+
+Ṣeré pẹ̀lú èyí fún ìgbà díẹ̀ kí o sì rí ohun tí o lè ṣe!
+
+## Iṣẹ́ print náà
+
+Gbìyànjú èyí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+Nígbà tí o bá tẹ `name`, ètò àgbékalẹ̀ Python náà yíò fèsì padà pẹ̀lú *àpẹẹrẹ* fọ́nrán ti variable 'name' náà, èyí tó jẹ́ àwọn lẹ́tà M-a-r-i-a, tí àwọn àmì àyọlò kan ṣoṣo yíká, ". Nígbà tí o sọ `print(name)`, Python yíò "ṣàtẹ̀jáde" àwọn àkóónú ti variable náà sí ojú àwòrán náà, láìsí àwọn àmì àyọlò náà, èyí tó túbọ̀ dára.
+
+Gẹ́gẹ́ bí a óò ṣe ri tó bá yá, `print()` tún wúlò nígbà tí a bá fẹ́ ṣàtẹ̀jáde àwọn nnkan láti inú àwọn iṣẹ́, tàbí nígbà tí a bá fẹ́ ṣàtẹ̀jáde àwọn nnkan lórí ọ̀pọ̀lọpọ̀ ìlà.
+
+## Àwọn àkójọ
+
+Yàtọ̀ sí àwọn fọ́nrán àti àwọn nọ́mbà odidi, Python ní gbogbo onírúurú àwọn ohun èlò ọ̀tọ̀ọ̀tọ̀. Ní báyìí, a ó ṣàfihàn ọ̀kan tí a n pè ní **àkójọ**. Àwọn àkójọ jẹ́ ohun tí o lérò pé wọ́n jẹ́ gan-an: àwọn ohun èlò èyí tó jẹ́ àwọn àkójọ àwọn ohun èlò mìíràn. :)
+
+Tẹ̀síwájú kí o ṣẹ̀dá àkójọ kan:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Bẹ́ẹ̀ ni, àkójọ yìí wà ní òfìfo. Kò fi bẹ́ẹ̀ wúlò, àbí bẹ́ẹ̀ kọ? Jẹ́ ká ṣẹ̀dá àkójọ àwọn nọ́mbà tẹ́tẹ́ lọ́tìrì kan. A kò fẹ́ pààrà ara wa ní gbogbo ìgbà, nítorí náà a ó fi sínú variable kan, pẹ̀lú:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+Kò burú, a ti ní àkójọ kan! Kíni a lè ṣe pẹ̀lú rẹ̀? Jẹ́ ká wo iye nọ́mbà tẹ́tẹ́ lọ́tìrì tó wà nínú àkójọ kan. Ṣé o ní àbá kankan nípa iṣẹ́ tó yẹ kí o lò fún ìyẹn? O ti mọ èyí tẹ́lẹ̀!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Bẹ́ẹ̀ ni! `len()` lè fún ọ ní iye àwọn ohun èlò tó wà nínú àkójọ kan. Ó wúlò, àbí bẹ́ẹ̀ kọ? Bóyá a ó ṣètò rẹ̀ ní báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+Èyí kò dá ohunkóhun padà, ó kàn ṣàyípadà ètò èyí tí àwọn nọ́mbà náà fi fojú hàn nínú àkójọ náà. Jẹ́ ká ṣàtẹ̀jáde rẹ̀ lẹ́ẹ̀kan síi kí a wo ohun tó ṣẹlẹ̀:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+Gẹ́gẹ́ bó o ṣe ríi, a ti ṣètò àwọn nọ́mbà tó wà nínú àkójọ rẹ láti iye tó kéré jù sí iye tó tóbi jù. Kú oríire!
+
+Bóyá a fẹ́ yí títò náà padà? Jẹ́ ká ṣe ìyẹn!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+Tí o bá fẹ́ ṣàfikún nnkan kan sí àkójọ rẹ, o lè ṣe èyí nípasẹ̀ títẹ àṣẹ yìí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+Tí o bá fẹ ṣàfihàn nọ́mbà àkọ́kọ́ nìkan, o lè ṣe èyí nípasẹ̀ lílo **àwọn atọ́kà**. Atọ́ka kan jẹ́ nọ́mbà kan tó n sọ ibi ti nnkan kan wà nínú àkójọ kan. Àwọn onímọ̀ nípa kóòdù fẹ́ràn láti bẹ̀rẹ̀ kíkà láti 0, nítorí náà ohun èlò àkọ́kọ́ nínú àkójọ rẹ wà ní atọ́ka 0, èyí tó kàn wà ní 1, àti bẹ́ẹ̀ bẹ́ẹ̀ lọ. Gbìyànjú èyí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+Gẹ́gẹ́ bó o ṣe ríi, o lè ní ànfààní sí oríṣiríṣi ohun èlò nínú àkójọ rẹ nípasẹ̀ lílo orúkọ àkójọ náà àti atọ́ka ohun èlò náà nínú àwọn àkámọ́ olópòó.
+
+Láti yọ nnkan kan kúrò nínú àkójọ rẹ, ìwọ yíò nílò láti lo **àwọn atọ́ka** gẹ́gẹ́ bí a ṣe kẹ́kọ̀ọ́ lókè àti ọ̀nà `pop()` náà. Jẹ́ ká gbìyànjú àpẹẹrẹ kan láti ṣàrídájú ohun tí a ti kọ́ tẹ́lẹ̀; a ó yọ nọ́mbà àkọ́kọ́ tó wà nínú àkójọ wa kúrò.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+Ìyẹn ṣiṣẹ́ dáadáa!
+
+Fún àfikún eré, gbìyànjú àwọn atọ́ka mìíràn: 6, 7, 1000, -1, -6 tàbí -1000. Wo bóyá o lè sọ àsọtẹ́lẹ̀ àbájáde náà ṣáájú kí o tó gbìyànjú àṣẹ náà. Ṣe àwọn àbájáde náà bọ́gbọ́n mu?
+
+O lè ṣàwárí àkọsílẹ̀ kan ti gbogbo àwọn ọ̀nà àkójọ tó wà nínú àkòrí yìí ti àkọsílẹ̀ àlàyé Python náà: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> Fún àwọn òǹkàwé ní ilé: a ti ṣàlàyé apá yìí nínú fídíò [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c).
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Ní báyìí, gbìyànjú kíkọ àṣẹ tó tẹ̀le yìí (gbìyànjú láti rọ́pò ìròyìn tìẹ, pẹ̀lú):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+Wo, ó rí bíi àkójọ kan. Ṣùgbọ́n ìwọ kò nílò láti rántí atọ́ka náà – orúkọ náà nìkan.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Kókó pàtàkì
+
+Ó dára! O mọ púpọ̀ nípa kóòdù kíkọ ní báyìí. Ní apá tó gbẹ̀yìn yìí, o ti kẹ́kọ̀ọ́ nípa:
+
+- **àwọn àṣìṣe** – o ti mọ bí o ṣe lè ka àti lóye àwọn àṣìṣe tó máa fojú hàn tí Python kò bá mọ àṣẹ kan tí o bá fún-un
+- **àwọn variable** – àwọn orúkọ fún àwọn ohun èlò tó máa fún ọ láàyè láti kọ kóòdù pẹ̀lú ìrọ̀rùn tí yíò sì mú kóòdù rẹ rọrùn láti kà
+- **àwọn àkójọ** – àwọn àkójọ àwọn ohun èlò tí a tọ́jú pẹ̀lú ètò pàtó kan
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Ṣe ìfiwéra àwọn nnkan
+
+> Fún àwọn òǹkàwé ní ilé: a ti ṣàlàyé apá yìí nínú fídíò [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4).
+
+Apá kan tó tóbi nínú kóòdù kíkọ ní láti ṣe pẹ̀lú ṣíṣe ìfiwéra àwọn nnkan. Kíni nnkan tó rọrùn jù láti fi wéra? Àwọn nọ́mbà! Jẹ́ ká wo bí ìyẹn ṣé n ṣiṣẹ́:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Fún Python ní àwọn iṣẹ́ méjì síi:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+A ti rí `>` àti `<`, ṣùgbọ́n kíni `>=` àti `<=` túmọ̀ sí? Kà wọ́n báyìí:
+
+- x `>` y túmọ̀ sí: x tóbi ju y
+- x `<` y túmọ̀ sí: x kéré sí y
+- x `<=` y túmọ̀ sí: x kéré sí tàbí dọ́gba pẹ̀lú y
+- x `>=` y túmọ̀ sí: x tóbi ju tàbí dọ́gba pẹ̀lú y
+
+O dára! Ṣé o fẹ́ ṣe ẹyọkan síi? Gbìyànjú èyí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+O lè fún Python ní ọ̀pọ̀lọpọ̀ nọ́mbà láti ṣe ìfiwéra bíi o ṣe fẹ́, àti pé yóò fún ọ ní ìdáhùn kan! Ó já fáfá púpọ̀, àbí bẹ́ẹ̀ kọ?
+
+- **and** – tí o bá lo operator `and` náà, àwọn àfiwé méjèèjì ní láti jẹ́ True kí gbogbo àṣẹ náà bàa lè jẹ́ True
+- **or** – tí o bá lo operator `or` náà, ẹyọkan ṣoṣo nínú àwọn àfiwé náà ní láti jẹ́ True kí gbogbo àṣẹ náà bàa lè jẹ́ True
+
+Ṣé o ti gbọ́ nípa gbólóhùn "ṣíṣe ìfiwéra èso ápù àti ọsàn"? Jẹ́ ká gbìyànjú irú rẹ̀ nínú Python:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+O ti ri níbí pé gẹ́gẹ́ bí inú gbólóhùn náà, Python kò lè ṣe ìfiwéra nọ́mbà kan (`int`) àti fọ́nrán kan (`str`). Dípò, ó ṣàfihàn **TypeError** kan àti pé ó sọ fún wa pé irú àwọn nnkan méjèèjì kò ṣeé fi wéra papọ̀.
+
+## Boolean
+
+Lọ́nà kan ṣáá, o ṣẹ̀ṣẹ̀ kẹ́kọ̀ọ́ nípa irú ohun èlò tuntun kan nínú Python. A ń pè é ní **Boolean**.
+
+Àwọn ohun èlò Boolean méjì nìkan ló wà:
+
+- True
+- False
+
+Ṣùgbọ́n fún Python láti mọ èyí, o nílò láti rí pé o kọ́ gẹ́gẹ́ bí 'True' (tí lẹ́tà àkọ́kọ́ máa jẹ́ lẹ́tà-ńlá, tí àwọn lẹ́tà yòókù máa jẹ́ lẹ́tà kékeré). **true, TRUE, àti tRUE kò ní ṣiṣẹ́ – True nìkan ló tọ́.** (Bẹ́ẹ̀ náà ló ṣe jẹ́ sí 'False' bákan náà.)
+
+Àwọn Boolean lè jẹ́ variable, pẹ̀lú! Wo ibí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+O tún lè ṣe é lọ́nà yìí:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Ṣe ìdánrawò kí o sì ṣeré pẹ̀lú àwọn Boolean nípasẹ̀ ìgbìyànjú láti ṣe àwọn àṣẹ tó tẹ̀le yìí:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Kú oríire! Àwọn Boolean jẹ́ ọ̀kan lára àwọn ẹyà tó dára jù nínú kóòdù kíkọ, àti pé o ṣẹ̀ṣẹ̀ kẹ́kọ̀ọ́ bí o ṣe lè lò wọ́n!
+
+# Tọ́jú rẹ̀!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Ṣí olóòtú kóòdù tí a yàn láàyò
+- Tọ́jú àwọn kóòdù kan sínú fáìlì python tuntun kan
+- Mú u ṣiṣẹ́!
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+Èyí yíò dá ọ padà sínú command prompt náà.
+
+Ní ìṣáájú, a ti mú olóòtú kóòdù kan láti abala [olóòtú kóòdù](../code_editor/README.md) náà. A ó nílò láti ṣí olóòtú náà ní báyìí àti kọ àwọn kóòdù kan sínú fáìlì tuntun kan (tàbí tí o bá n lo Chromebook kan, ṣẹ̀dá fáìlì tuntun kan sínú cloud IDE náà kí o sì ṣí fáìlì náà, èyí tí yíò jẹ́ nínú olóòtú kóòdù tó wà lára rẹ̀ náà):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Dájúdájú, o jẹ́ olùgbéjáde Python tó ti nírìírí púpọ̀ kan ní báyìí, nítorí náà má tijú láti kọ àwọn kóòdù tí o ti kọ́ lónìí.
+
+Ní báyìí, a nílò láti tọ́jú fáìlì náà àti fún-un lórúkọ aṣàpèjúwe kan. Jẹ́ ká pe fáìlì náà ní **python_intro.py** àti tọ́jú rẹ̀ sí desktop rẹ. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Rántí pé ọ̀rọ̀ "Desktop" náà lè ní ìtumọ̀ sí èdè abínibí rẹ.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+Lórí Windows Command Prompt, yóò rí báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+Àti lórí Windows Powershell, yóò rí báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Àkíyèsí: lórí Windows a kò dá 'python3' mọ̀ gẹ́gẹ́ bí àṣẹ kan. Dípò, lo 'python' láti ṣiṣẹ́ lórí fáìlì náà:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Rọ́pò kóòdù tó wà nínú fáìlì **python_intro.py** rẹ pẹ̀lú èyí:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **ṣíṣe ìfiwéra àwọn nnkan** – nínú Python, o lè ṣe ìfiwéra àwọn nnkan nípasẹ̀ lílo `>`, `>=`, `==`, `<=`, `<` àti àwọn operator `and`, `or` náà
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, àṣìṣe kan. Èyí tó jẹ́ oríre fún wa, Python n fún wa ní ìròyìn àṣìṣe tó wúlò púpọ̀ kan. Ó n sọ fún wa pé iṣẹ́ `hi()` náà (èyí tí a ṣàlàyé) ní argument kan tó nílò (tí a n pè ní `name`) àti pé a ti gbàgbé láti darí rẹ̀ nígbà tí a n pe iṣẹ́ náà. Jẹ́ ká ṣàtúnṣe rẹ̀ ní ìsàlẹ̀ fáìlì náà:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+Kí a sì mú u ṣiṣẹ́ léèkan si:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+Àti pé tí a bá ṣàyípadà orúkọ náà?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+Kí a sì mú u ṣiṣẹ́:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Ní báyìí, kíni o lérò pé yíò ṣẹlẹ̀ tí o bá kọ orúkọ mìíràn síbẹ̀? (Kìí ṣe Ola tàbí Sonja.) Gbìyànjú rẹ̀ wò kí o sì ri bóyá o gbà á. Ó yẹ kó ṣàtẹ̀jáde èyí:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+Èyí dára, àbí bẹ́ẹ̀ kọ? Lọ́nà yìí, ìwọ kò ní láti máa pààrà ara rẹ ní gbogbo ìgbà tí o bá fẹ́ ṣàyípadà orúkọ ẹni tó yẹ kí iṣẹ́ náà kí. Àti pé ìdí nìyẹn tí a fi nílò àwọn iṣẹ́ – ìwọ kò ní fẹ́ pààrà kóòdù rẹ!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Jẹ́ ká pe kóòdù náà ní báyìí:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Kú oríire! O ṣẹ̀ṣẹ̀ kẹ́kọ̀ọ́ nípa bí o ṣe lè kọ àwọn iṣẹ́! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Kóòdù kíkún tí yíò wà nínú fáìlì náà nìyí:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+Àti nígbà tí a bá mú u ṣiṣẹ́:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+Gẹ́gẹ́ bó o ṣe ríi, gbogbo nnkan tí o fi sínú gbólóhùn `for` kan pẹ̀lú ìtẹ̀wọnú kan yíò máa wáyé fún gbogbo element ti àkójọ `girls` náà.
+
+O tún lè lo `for` lórí àwọn nọ́mbà pẹ̀lú lílo iṣẹ́ `range` náà:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Èyí tí yíò ṣàtẹ̀jáde:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` jẹ́ iṣẹ́ kan tó máa ṣẹ̀dá àkójọ àwọn nọ́mbà kan tó n tẹ̀lé ara wọn níkọ̀ọ̀kan (àwọn nọ́mbà wọ̀nyí máa wà ní ìpèsè nípasẹ̀ rẹ gẹ́gẹ́ bí àwọn parameter).
+
+Ṣàkíyèsí pé ìkejì àwọn nọ́mbà méjèèjì wọ̀nyí kò sí nínú àkójọ tí Python gbé jáde (tó túmọ̀sí pé `range(1, 6)` bẹ̀rẹ̀ kíkà láti 1 sí 5, ṣùgbọ́n kò sí nọ́mbà 6 náà lára wọn). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Kókó pàtàkì
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/yo-NG/template_extending/README.md b/yo-NG/template_extending/README.md
new file mode 100644
index 00000000000..178bcc64957
--- /dev/null
+++ b/yo-NG/template_extending/README.md
@@ -0,0 +1,151 @@
+# Mímú kí àwòṣe (template) gbòòrò síi
+
+Nnkan tó dára mìíràn tí Django ní fún ẹ jẹ́ **mímú kí àwòṣe gbòòrò síi**. Kíni èyí túmọ̀sí? Ó túmọ̀ sí pé o lè lo àwọn apá kannáà ti HTML rẹ fún oríṣiríṣi ojú-ìwé ti ààyè ayélujára rẹ.
+
+Àwọn àwòṣe wúlò nígbà tí o bá fẹ́ lo àlàyé tàbí àgbékalẹ̀ kannáà lọ́nà tó ju ẹyọkan lọ. Ìwọ kò nílò láti pààrà ara rẹ nínú gbogbo fáìlì. Àti pé tí o bá fẹ́ ṣàyípadà nnkan kan, ìwọ kò nílò láti ṣeé nínú gbogbo àwòṣe, ẹyọkan ṣoṣo ti tó!
+
+## Ṣẹ̀dá àwòṣe ìpìlẹ̀ kan
+
+Àwòṣe ìpìlẹ̀ kan jẹ́ àwòṣe tó ṣe pàtàkì jù lọ tí o lè mú gbòòrò sórí gbogbo ojú-ìwé ààyè ayélujára rẹ.
+
+Ẹ jẹ́ ká ṣẹ̀dá fáìlì `base.html` kan sínú `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Lẹ́yìn náà ṣí sílẹ̀ nínú olóòtú kóòdù náà kí o sì ṣàdàkọ gbogbo rẹ̀ láti fáìlì `post_list.html` sí `base.html`, bíi èyí:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+Lẹ́yìn náà nínú `base.html`, rọ́pò gbogbo `<body>` rẹ (gbogbo nnkan tó wà láàrin `<body>` àti `</body>`) pẹ̀lú èyí:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}O lè ṣàkíyèsí pé èyí rọ́pò gbogbo nnkan láti `{% for post in posts %}` sí `{% endfor %}` pẹ̀lú: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+Ṣùgbọ́n kí nìdí? O ṣẹ̀ṣẹ̀ ṣẹ̀dá `block` kan! O ti lo àmì àwòṣe `{% block %}` náà láti ṣe agbègbè kan tí a ó fi HTML sínú rẹ̀. HTML yẹn yíò wá láti àwòṣe mìíràn tí yíò mú àwòṣe yìí gbòòrò (`base.html`). A ó fi hàn ọ́ bí o ṣe lè se èyí ní ìṣẹ́jú kan.
+
+Ní báyìí tọ́jú `base.html` kí o ṣí `blog/templates/blog/post_list.html` rẹ lẹ́ẹ̀kan síi nínú olóòtú kóòdù náà. {% raw %}Ìwọ yóò yọ gbogbo nnkan tó wà lókè `{% for post in posts %}` àti nísàlẹ̀ `{% endfor %}` kúrò. Nígbà tí o bá parí, fáìlì náà yíò rí báyìí:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+A fẹ́ lo èyí gẹ́gẹ́ bí ara àwòṣe wa fún gbogbo àwọn búlọ́ọ̀kù àkóónú náà. Àkókò láti ṣàfikún àwọn àmì búlọ́ọ̀kù sí fáìlì yìí!
+
+{% raw %}O fẹ́ kí àmì búlọ́ọ̀kù rẹ dọ́gba pẹ̀lú àmì tó wà nínú fáìlì `base.html` rẹ. O tún fẹ́ kí ó ní gbogbo kóòdù tó wà nínú àwọn búlọ́ọ̀kù àkóónú rẹ. Láti ṣe ìyẹn, kó gbogbo rẹ̀ sí àárín `{% block content %}` àti `{% endblock %}`. Báyìí:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Nnkan kan ṣoṣo ló kù. A nílò láti ṣe ìsopọ̀ àwọn àwòṣe méjèèjì wọ̀nyí papọ̀. Èyí ni ohun tí ṣíṣe ìmúgbòòrò àwọn àwòṣe dá lé lórí! A ó ṣe èyí nípasẹ̀ ṣíṣe àfikún àmì ìmúgbòòrò kan sí ìbẹ̀rẹ̀ fáìlì náà. Báyìí:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Ó parí! Tọ́jú fáìlì náà, kí o sì ṣàyẹ̀wò tí ààyè ayélujára rẹ bá sì n ṣiṣẹ́ dáadáa. :)
+
+> Tí o bá rí àṣìṣe `TemplateDoesNotExist`, ìyẹn túmọ̀ sí pé kò sí fáìlì `blog/base.html` àti pé o ní `runserver` tó n ṣiṣẹ́ nínú console náà. Gbìyànjú láti dá a dúró (nípasẹ̀ títẹ̀ Ctrl+C – àwọn bọ́tìnnì Control àti C papọ̀) kí o sì tun bẹ̀rẹ̀ nípasẹ̀ lílo àṣẹ `python manage.py runserver` kan.
\ No newline at end of file
diff --git a/yo-NG/whats_next/README.md b/yo-NG/whats_next/README.md
new file mode 100644
index 00000000000..aae57bee8cf
--- /dev/null
+++ b/yo-NG/whats_next/README.md
@@ -0,0 +1,43 @@
+# Kí ló kàn?
+
+Gbóríyìn fún ara rẹ! **O ṣiṣẹ́ tó dára gan-an**. Inú wa dùn! <3
+
+### Kíni ṣíṣe báyìí?
+
+Yọwọ́ kúrò nínú iṣé kí o sì sinmi! O ṣẹ̀ṣẹ̀ ṣe nnkan kan tó tóbi gan-an.
+
+Lẹ́yìn ìyẹn, ri dájú láti tẹ̀lé Django Girls lórí [Facebook](http://facebook.com/djangogirls) tàbí [Twitter](https://twitter.com/djangogirls) láti máa mọ ohun tó ń lọ.
+
+### Ṣé o lè dábàá èyíkéyìí àwọn ìrànlọ́wọ́ síwájú síi?
+
+Bẹ́ẹ̀ ni! *Ọ̀pọ̀lọpọ̀* àwọn ìrànlọ́wọ́ ló wà lórí íńtánẹ́ẹ̀tì fún ìkẹ́kọ̀ọ́ nípa oríṣiríṣi àwọn ìmọ̀ kóòdù kíkọ – ó lè ṣòro púpọ̀ láti mọ ibi tó kàn, ṣùgbọ́n a ó ràn ọ́ lọ́wọ́ lórí rẹ̀. Ohun yòówù kí o nífẹ̀ẹ́ sí ṣáájú kó o tó wá sí Django Girls, àti ìfẹ́ yòówù tí o ti ní lásìkò àlàyé náà, àwọn ìrànlọ́wọ́ ọ̀fẹ́ díẹ̀ nìyí (tàbí àwọn ìrànlọ́wọ́ pẹ̀lú àwọn èròjà ọ̀fẹ́ nlá) tí o lè lò láti dé ibi tí o fẹ́.
+
+#### Django
+
+- Ìwé wa mìíràn, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Àkànṣe àlàyé ti Django](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Àwọn ẹ̀kọ́ fídíò - Getting Started With Django](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS àti JavaScript
+
+- [Ìdánilẹ́kọ̀ọ́ ìgbéjáde ayélujára ti Codecademy](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Ìdánilẹ́kọ̀ọ́ Python ti Codecademy](https://www.codecademy.com/learn/learn-python)
+- [Ìdánilẹ́kọ̀ọ́ Python ti Google](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – ọ̀fẹ́ ni àwọn ìdánrawò àkọ́kọ́ náà
+- [New Coder tutorials](http://newcoder.io/tutorials/) – èyí jẹ́ onírúurú àwọn àpẹẹrẹ tó ṣeé mú lò ti bí o ṣe lè lo Python
+- [edX](https://www.edx.org/course?search_query=python) – o lè ṣàyẹ̀wò púpọ̀ lára àwọn ìdánilékọ̀ọ́ náà lófẹ̀ẹ́, ṣùgbọ́n tí o bá fẹ́ ìwé-ẹ̀rí kan tàbí àwọn ìyìn fún ẹ̀rí ilé ẹ̀kọ́ gíga, nígbà náà yíò ná ẹ lówó
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – o lè ṣàyẹ̀wò àwọn fídíò ìdánilékọ̀ọ́ kan lófẹ̀ẹ́ àti pé o lè gba Ìwé-ẹ̀rí Coursera kan nípasẹ̀ kíkópa nínú àwọn ìdánilékọ̀ọ́ wọ̀nyí
+- [Python for Everybody](https://www.py4e.com/) - ẹ̀yà ọ̀fẹ́ àti gbangba kan ti ẹ̀kà àyàsọ́tọ̀ Coursera Python for Everybody náà
+
+#### Ìṣiṣẹ́ pẹ̀lú dátà
+
+- [Ìdánilẹ́kọ̀ọ́ sáyẹ́nsì dátà ti Codecademy](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – o lè ṣàyẹ̀wò púpọ̀ lára àwọn ìdánilékọ̀ọ́ náà lófẹ̀ẹ́, ṣùgbọ́n tí o bá fẹ́ ìwé-ẹ̀rí kan tàbí àwọn ìyìn fún ẹ̀rí ilé ẹ̀kọ́ gíga kan, nígbà náà yíò ná ẹ lówó
+- [Dataquest](https://www.dataquest.io/) – ọ̀fẹ́ ni "àwọn iṣẹ́" 30 àkọ́kọ́ náà
+
+A ò lè dúró láti rí ohun tó kàn ní ṣíṣe fún ẹ!
\ No newline at end of file
diff --git a/yo/GLOSSARY.md b/yo/GLOSSARY.md
new file mode 100644
index 00000000000..2e928dda548
--- /dev/null
+++ b/yo/GLOSSARY.md
@@ -0,0 +1,3 @@
+# code editor
+
+Code editor is an application that allows you to save your code so you will be able to get back to it later. You can learn where to get one from the [Code editor chapter](./code_editor/README.md)
\ No newline at end of file
diff --git a/yo/README.md b/yo/README.md
new file mode 100644
index 00000000000..01736ae0502
--- /dev/null
+++ b/yo/README.md
@@ -0,0 +1,51 @@
+# Django Girls Tutorial
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## Welcome
+
+Welcome to the Django Girls Tutorial! We are happy to see you here :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine :)
+
+## Introduction
+
+Have you ever felt that the world is more and more about technology to which you cannot (yet) relate? Have you ever wondered how to create a website but have never had enough motivation to start? Have you ever thought that the software world is too complicated for you to even try doing something on your own?
+
+Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
+
+This tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems. We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
+
+We hope that we'll be able to make you love technology as much as we do!
+
+## What will you learn during the tutorial?
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+It will (more or less) look like this:
+
+![Figure 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). We asked our coaches and previous attendees to be there from time to time and help others with the tutorial! Don't be afraid to ask your question there!
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## About and contributing
+
+This tutorial is maintained by [DjangoGirls](https://djangogirls.org/). If you find any mistakes or want to update the tutorial please [follow the contributing guidelines](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Would you like to help us translate the tutorial into other languages?
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/yo/SUMMARY.md b/yo/SUMMARY.md
new file mode 100644
index 00000000000..4e5bec70696
--- /dev/null
+++ b/yo/SUMMARY.md
@@ -0,0 +1,27 @@
+# Summary
+
+* [Ifihan](README.md)
+* [Fifi sori](installation/README.md)
+* [Fifi sori (chromebook)](chromebook_setup/README.md)
+* [Bi Ayelujara n se ṣiṣẹ](how_the_internet_works/README.md)
+* [Introduction to command line](intro_to_command_line/README.md)
+* [Python installation](python_installation/README.md)
+* [Code editor](code_editor/README.md)
+* [Ifihan Python](python_introduction/README.md)
+* [What is Django?](django/README.md)
+* [Django installation](django_installation/README.md)
+* [Ise Django akọkọ rẹ!](django_start_project/README.md)
+* [Olootu koodu](django_models/README.md)
+* [Django admin](django_admin/README.md)
+* [Deploy!](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [Introduction to HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Dynamic data in templates](dynamic_data_in_templates/README.md)
+* [Django templates](django_templates/README.md)
+* [CSS - fun ni ewa](css/README.md)
+* [Template extending](template_extending/README.md)
+* [Extend your application](extend_your_application/README.md)
+* [Django Forms](django_forms/README.md)
+* [Kini ni atẹle?](whats_next/README.md)
\ No newline at end of file
diff --git a/yo/chromebook_setup/README.md b/yo/chromebook_setup/README.md
new file mode 100644
index 00000000000..a4843977603
--- /dev/null
+++ b/yo/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook setup
+
+> **Note** If you already worked through the Installation steps, no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/yo/chromebook_setup/instructions.md b/yo/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..809281456d3
--- /dev/null
+++ b/yo/chromebook_setup/instructions.md
@@ -0,0 +1,60 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) if you're not using a Chromebook. If you are, your installation experience will be a little different. You can ignore the rest of the installation instructions.
+
+### Cloud 9
+
+Cloud 9 is a tool that gives you a code editor and access to a computer running on the Internet where you can install, write, and run the software. For the duration of the tutorial, Cloud 9 will act as your *local machine*. You'll still be running commands in a terminal interface just like your classmates on OS X, Ubuntu, or Windows, but your terminal will be connected to a computer running somewhere else that Cloud 9 sets up for you.
+
+1. Install Cloud 9 from the [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Go to [c9.io](https://c9.io)
+3. Sign up for an account
+4. Click *Create a New Workspace*
+5. Name it *django-girls*
+6. Select the *Blank* (second from the right on the bottom row with orange logo)
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your *terminal*, where you will give the computer Cloud 9 has prepared for your instructions. You can resize that window to make it a bit bigger.
+
+### Virtual Environment
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+In your terminal at the bottom of the Cloud 9 interface, run the following:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    sudo apt update
+    sudo apt install python3.6-venv
+    
+
+If this still doesn't work, ask your coach for some help.
+
+Next, run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~=1.11.0
+    
+
+(note that on the last line we use a tilde followed by an equal sign: ~=).
+
+### Github
+
+Make a [Github](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place or our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/yo/code_editor/README.md b/yo/code_editor/README.md
new file mode 100644
index 00000000000..404011f1b7d
--- /dev/null
+++ b/yo/code_editor/README.md
@@ -0,0 +1,11 @@
+# Code editor
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+You're about to write your first line of code, so it's time to download a code editor!
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** You might have done this earlier in the Installation chapter – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/yo/code_editor/instructions.md b/yo/code_editor/instructions.md
new file mode 100644
index 00000000000..074cd86196e
--- /dev/null
+++ b/yo/code_editor/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source and available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/yo/css/README.md b/yo/css/README.md
new file mode 100644
index 00000000000..04d5996ae52
--- /dev/null
+++ b/yo/css/README.md
@@ -0,0 +1,304 @@
+# CSS – make it pretty!
+
+Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
+
+## What is CSS?
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## Let's use Bootstrap!
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## Install Bootstrap
+
+To install Bootstrap, you need to add this to your `<head>` in your `.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. Just go ahead, open your website and refresh the page. Here it is!
+
+![Figure 14.1](images/bootstrap1.png)
+
+Looking nicer already!
+
+## Static files in Django
+
+Finally we will take a closer look at these things we've been calling **static files**. Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Where to put static files for Django
+
+Django already knows where to find the static files for the built-in "admin" app. Now we just need to add some static files for our own app, `blog`.
+
+We do that by creating a folder called `static` inside the blog app:
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## Your first CSS file!
+
+Let's create a CSS file now, to add your own style to your web page. Create a new directory called `css` inside your `static` directory. Then create a new file called `blog.css` inside this `css` directory. Ready?
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+Time to write some CSS! Open up the `blog/static/css/blog.css` file in your code editor.
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special codes. These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. You may also use [predefined colors](http://www.w3schools.com/colors/colors_names.asp), such as `red` and `green`.
+
+In your `blog/static/css/blog.css` file you should add the following code:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+}
+```
+
+`h1 a` is a CSS Selector. This means we're applying our styles to any `a` element inside of an `h1` element. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#FCA205`, which is orange. Of course, you can put your own color here!
+
+In a CSS file we determine styles for elements in the HTML file. The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class and id are names you give the element by yourself. Classes define groups of elements, and ids point to specific elements. For example, you could identify the following tag by using the tag name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. We just told our template where our CSS file is located.
+
+Your file should now look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        {% for post in posts %}
+            <div>
+                <p>published: {{ post.published_date }}</p>
+                <h1><a href="">{{ post.title }}</a></h1>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </div>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, save the file and refresh the site!
+
+![Figure 14.2](images/color2.png)
+
+Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![Figure 14.3](images/margin2.png)
+
+Maybe we can customize the font in our header? Paste this into your `<head>` in `blog/templates/blog/post_list.html` file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![Figure 14.3](images/font.png)
+
+Great!
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Add a class called `page-header` to your `div` that contains your header, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="page-header">
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+```
+
+And now add a class `post` to your `div` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="post">
+    <p>published: {{ post.published_date }}</p>
+    <h1><a href="">{{ post.title }}</a></h1>
+    <p>{{ post.text|linebreaksbr }}</p>
+</div>
+```
+
+We will now add declaration blocks to different selectors. Selectors starting with `.` relate to classes. There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, just copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #ff9400;
+    margin-top: 0;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+.content {
+    margin-left: 40px;
+}
+
+h1, h2, h3, h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea, .post-form input {
+    width: 100%;
+}
+
+.top-menu, .top-menu:hover, .top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h1 a, .post h1 a:visited {
+    color: #000000;
+}
+```
+
+Then surround the HTML code which displays the posts with declarations of classes. Replace this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+in the `blog/templates/blog/post_list.html` with this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div class="content container">
+    <div class="row">
+        <div class="col-md-8">
+            {% for post in posts %}
+                <div class="post">
+                    <div class="date">
+                        <p>published: {{ post.published_date }}</p>
+                    </div>
+                    <h1><a href="">{{ post.title }}</a></h1>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+</div>
+```
+
+Save those files and refresh your website.
+
+![Figure 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking this free online [Codeacademy HTML & CSS course](https://www.codecademy.com/tracks/web). It can help you learn all about making your websites prettier with CSS.
+
+Ready for the next chapter?! :)
\ No newline at end of file
diff --git a/yo/deploy/README.md b/yo/deploy/README.md
new file mode 100644
index 00000000000..b44e2eaaf73
--- /dev/null
+++ b/yo/deploy/README.md
@@ -0,0 +1,260 @@
+# Deploy!
+
+> **Note** The following chapter can be sometimes a bit hard to get through. Persist and finish it; deployment is an important part of the website development process. This chapter is placed in the middle of the tutorial so that your mentor can help with the slightly trickier process of getting your website online. This means you can still finish the tutorial on your own if you run out of time.
+
+Until now, your website was only available on your computer. Now you will learn how to deploy it! Deploying is the process of publishing your application on the Internet so people can finally go and see your app. :)
+
+As you learned, a website has to be located on a server. There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+The other external service we'll be using is [GitHub](https://www.github.com), which is a code hosting service. There are others out there, but almost all programmers have a GitHub account these days, and now so will you!
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the Installation steps, there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## Starting our Git repository
+
+Git tracks changes to a particular set of files in what's called a code repository (or "repo" for short). Let's start one for our project. Open up your console and run these commands, in the `djangogirls` directory:
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. You should be in the `djangogirls` folder.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git will track changes to all the files and folders in this directory, but there are some files we want it to ignore. We do this by creating a file called `.gitignore` in the base directory. Open up your editor and create a new file with the following contents:
+
+{% filename %}.gitignore{% endfilename %}
+
+    *.pyc
+    *~
+    __pycache__
+    myvenv
+    db.sqlite3
+    /static
+    .DS_Store
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **Note** The dot at the beginning of the file name is important! If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your posts are stored. We don't want to add this to your repository because your website on PythonAnywhere is going to be using a different database. That database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts you created so far are going to stay and only be available locally, but you're going to have to add them again on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+It's a good idea to use a `git status` command before `git add` or whenever you find yourself unsure of what has changed. This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    Initial commit
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+And finally we save our changes. Go to your console and run these commands:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+     ```
+    
+    
+    ## Pushing your code to GitHub
+    
+    Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!)
+    
+    Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+    
+    <img src="images/new_github_repo.png" />
+    
+    > **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to just stick with the name `my-first-blog`.
+    
+    On the next screen, you'll be shown your repo's clone URL. Choose the "HTTPS" version, copy it, and we'll paste it into the terminal shortly:
+    
+    <img src="images/github_get_repo_url_screenshot.png" />
+    
+    Now we need to hook up the Git repository on your computer to the one up on GitHub.
+    
+    Type the following into your console (Replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets):
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+$ git remote add origin https://github.com/<your-github-username>/my-first-blog.git $ git push -u origin master
+
+    <br />Enter your GitHub username and password and you should see something like this:
+    
+    {% filename %}command-line{% endfilename %}
+    
+
+Username for 'https://github.com': hjwp Password for 'https://hjwp@github.com': Counting objects: 6, done. Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/hjwp/my-first-blog.git
+
+- [new branch] master -> master Branch master set up to track remote branch master from origin.
+
+    <br />&lt;!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension --&gt;
+    
+    Your code is now on GitHub. Go and check it out!  You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+    
+    
+    # Setting up our blog on PythonAnywhere
+    
+    &gt; **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+    
+    {% include "/deploy/signup_pythonanywhere.md" %}
+    
+    
+    ## Pulling our code down on PythonAnywhere
+    
+    When you've signed up for PythonAnywhere, you'll be taken to your dashboard or "Consoles" page. Choose the option to start a "Bash" console – that's the PythonAnywhere version of a console, just like the one on your computer.
+    
+    &lt;img src="images/pythonanywhere_bash_console.png" alt="pointing at Other: Bash in Start a new Console" /&gt;
+    
+    &gt; **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+    
+    Let's pull down our code from GitHub and onto PythonAnywhere by creating a "clone" of our repo. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `&lt;your-github-username&gt;`):
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ git clone https://github.com/<your-github-username>/my-first-blog.git
+
+    <br />This will pull down a copy of your code onto PythonAnywhere. Check it out by typing `tree my-first-blog`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ tree my-first-blog my-first-blog/ ├── blog │ ├── **init**.py │ ├── admin.py │ ├── migrations │ │ ├── 0001_initial.py │ │ └── **init**.py │ ├── models.py │ ├── tests.py │ └── views.py ├── manage.py └── mysite ├── **init**.py ├── settings.py ├── urls.py └── wsgi.py
+
+    <br /><br />### Creating a virtualenv on PythonAnywhere
+    
+    Just like you did on your own computer, you can create a virtualenv on PythonAnywhere. In the Bash console, type:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+$ cd my-first-blog
+
+$ virtualenv --python=python3.6 myvenv Running virtualenv with interpreter /usr/bin/python3.6 [...] Installing setuptools, pip...done.
+
+$ source myvenv/bin/activate
+
+(myvenv) $ pip install django~=1.11.0 Collecting django [...] Successfully installed django-1.11.3
+
+    <br /><br />&gt; **Note** The `pip install` step can take a couple of minutes.  Patience, patience!  But if it takes more than five minutes, something is wrong.  Ask your coach.
+    
+    &lt;!--TODO: think about using requirements.txt instead of pip install.--&gt;
+    
+    ### Creating the database on PythonAnywhere
+    
+    Here's another thing that's different between your own computer and the server: it uses a different database. So the user accounts and posts can be different on the server and on your computer.
+    
+    Just as we did on your own computer, we repeat the step to initialize the database on the server, with `migrate` and `createsuperuser`:
+    
+    {% filename %}PythonAnywhere command-line{% endfilename %}
+    
+
+(mvenv) $ python manage.py migrate Operations to perform: [...] Applying sessions.0001_initial... OK (mvenv) $ python manage.py createsuperuser
+
+    <br />## Publishing our blog as a web app
+    
+    Now our code is on PythonAnywhere, our virtualenv is ready, and the database is initialized. We're ready to publish it as a web app!
+    
+    Click back to the PythonAnywhere dashboard by clicking on its logo, and then click on the **Web** tab. Finally, hit **Add a new web app**.
+    
+    After confirming your domain name, choose **manual configuration** (N.B. – *not* the "Django" option) in the dialog. Next choose **Python 3.6**, and click Next to finish the wizard.
+    
+    &gt; **Note** Make sure you choose the "Manual configuration" option, not the "Django" one. We're too cool for the default PythonAnywhere Django setup. ;-)
+    
+    
+    ### Setting the virtualenv
+    
+    You'll be taken to the PythonAnywhere config screen for your webapp, which is where you'll need to go whenever you want to make changes to the app on the server.
+    
+    &lt;img src="images/pythonanywhere_web_tab_virtualenv.png" /&gt;
+    
+    In the "Virtualenv" section, click the red text that says "Enter the path to a virtualenv", and enter `/home/&lt;your-PythonAnywhere-username&gt;/my-first-blog/myvenv/`. Click the blue box with the checkmark to save the path before moving on.
+    
+    &gt; **Note** Substitute your own PythonAnywhere username as appropriate. If you make a mistake, PythonAnywhere will show you a little warning.
+    
+    
+    ### Configuring the WSGI file
+    
+    Django works using the "WSGI protocol", a standard for serving websites using Python, which PythonAnywhere supports. The way we configure PythonAnywhere to recognize our Django blog is by editing a WSGI configuration file.
+    
+    Click on the "WSGI configuration file" link (in the "Code" section near the top of the page – it'll be named something like `/var/www/&lt;your-PythonAnywhere-username&gt;_pythonanywhere_com_wsgi.py`), and you'll be taken to an editor.
+    
+    Delete all the contents and replace them with the following:
+    
+    {% filename %}&lt;your-username&gt;_pythonanywhere_com_wsgi.py{% endfilename %}
+    ```python
+    import os
+    import sys
+    
+    path = os.path.expanduser('~/my-first-blog')
+    if path not in sys.path:
+        sys.path.append(path)
+    
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
+    
+    from django.core.wsgi import get_wsgi_application
+    from django.contrib.staticfiles.handlers import StaticFilesHandler
+    application = StaticFilesHandler(get_wsgi_application())
+    
+
+This file's job is to tell PythonAnywhere where our web app lives and what the Django settings file's name is.
+
+The `StaticFilesHandler` is for dealing with our CSS. This is taken care of automatically for you during local development by the `runserver` command. We'll find out a bit more about static files later in the tutorial, when we edit the CSS for our site.
+
+Hit **Save** and then go back to the **Web** tab.
+
+We're all done! Hit the big green **Reload** button and you'll be able to go view your application. You'll find a link to it at the top of the page.
+
+## Debugging tips
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere [Web tab](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom. Common problems include:
+
+- Forgetting one of the steps we did in the console: creating the virtualenv, activating it, installing Django into it, migrating the database.
+
+- Making a mistake in the virtualenv path on the Web tab – there will usually be a little red error message on there, if there is a problem.
+
+- Making a mistake in the WSGI configuration file – did you get the path to your my-first-blog folder right?
+
+- Did you pick the same version of Python for your virtualenv as you did for your web app? Both should be 3.6.
+
+There are also some [general debugging tips on the PythonAnywhere wiki](https://www.pythonanywhere.com/wiki/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# You are live!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet, just like that!
\ No newline at end of file
diff --git a/yo/deploy/install_git.md b/yo/deploy/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/yo/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/yo/deploy/signup_pythonanywhere.md b/yo/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..ca66bd0de69
--- /dev/null
+++ b/yo/deploy/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next, it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about.
\ No newline at end of file
diff --git a/yo/django/README.md b/yo/django/README.md
new file mode 100644
index 00000000000..c62c145305b
--- /dev/null
+++ b/yo/django/README.md
@@ -0,0 +1,27 @@
+# What is Django?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) is a free and open source web application framework, written in Python. A web framework is a set of components that helps you to develop websites faster and easier.
+
+When you're building a website, you always need a similar set of components: a way to handle user authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files, etc.
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## Why do you need a framework?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server reads the letter and then sends a response with a webpage. But when you want to send something, you need to have some content. And Django is something that helps you create the content.
+
+## What happens when someone requests a website from your server?
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+Imagine a mail carrier with a letter. She is walking down the street and checks each house number against the one on the letter. If it matches, she puts the letter there. This is how the urlresolver works!
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. Maybe the user asked to change something in the data? Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will simply start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/yo/django_admin/README.md b/yo/django_admin/README.md
new file mode 100644
index 00000000000..46a5afbb500
--- /dev/null
+++ b/yo/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the admin page, we need to register the model with `admin.site.register(Post)`.
+
+OK, time to look at our Post model. Remember to run `python manage.py runserver` in the console to run the web server. Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![Login page](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Just type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: admin
+    Email address: admin@admin.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content – you can simply copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/1.11/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/yo/django_forms/README.md b/yo/django_forms/README.md
new file mode 100644
index 00000000000..1d9efebffe4
--- /dev/null
+++ b/yo/django_forms/README.md
@@ -0,0 +1,447 @@
+# Django Forms
+
+The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's `admin` is cool, but it is rather hard to customize and make pretty. With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+The nice thing about Django forms is that we can either define one from scratch or create a `ModelForm` which will save the result of the form to the model.
+
+This is exactly what we want to do: we will create a form for our `Post` model.
+
+Like every important part of Django, forms have their own file: `forms.py`.
+
+We need to create a file with this name in the `blog` directory.
+
+    blog
+       └── forms.py
+    
+
+OK, let's open it and type the following code:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and, obviously, our `Post` model (`from .models import Post`).
+
+`PostForm`, as you probably suspect, is the name of our form. We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+Next, we have `class Meta`, where we tell Django which model should be used to create this form (`model = Post`).
+
+Finally, we can say which field(s) should end up in our form. In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+And that's it! All we need to do now is use the form in a *view* and display it in a template.
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## Link to a page with the form
+
+It's time to open `blog/templates/blog/base.html`. We will add a link in `div` named `page-header`:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+Note that we want to call our new view `post_new`. The class `"glyphicon glyphicon-plus"` is provided by the bootstrap theme we are using, and will display a plus sign for us.
+
+After adding the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will obviously see a familiar `NoReverseMatch` error, right?
+
+## URL
+
+We open `blog/urls.py` and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+url(r'^post/new/$', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+    url(r'^post/new/$', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## Template
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form tag: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. This is very important, since it makes your forms secure! If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h1>New post</h1>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## Saving the form
+
+Open `blog/views.py` once again. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## Form validation
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## Edit form
+
+Now we know how to add a new form. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+Open `blog/templates/blog/post_detail.html` and add the line
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+In `blog/urls.py` we add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    url(r'^post/(?P<pk>\d+)/edit/$', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from urls. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/1.11/topics/forms/
+
+## Security
+
+Being able to create new posts just by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+In `blog/templates/blog/base.html`, find our `page-header` `div` and the anchor tag you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` tag to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## One more thing: deploy time!
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to Github:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/yo/django_installation/README.md b/yo/django_installation/README.md
new file mode 100644
index 00000000000..7834993e063
--- /dev/null
+++ b/yo/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/yo/django_installation/instructions.md b/yo/django_installation/instructions.md
new file mode 100644
index 00000000000..0bc080f7055
--- /dev/null
+++ b/yo/django_installation/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/yo/django_models/README.md b/yo/django_models/README.md
new file mode 100644
index 00000000000..7aa11d11732
--- /dev/null
+++ b/yo/django_models/README.md
@@ -0,0 +1,199 @@
+# Django models
+
+What we want to create now is something that will store all the posts in our blog. But to be able to do that we need to talk a little bit about things called `objects`.
+
+## Objects
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+So basically the idea is to describe real things in code with properties (called `object properties`) and actions (called `methods`).
+
+How will we model blog posts then? We want to build a blog, right?
+
+We need to answer the question: What is a blog post? What properties should it have?
+
+Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it – so we need an author. Finally, we want to know when the post was created and published.
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+What kind of things could be done with a blog post? It would be nice to have some `method` that publishes the post, right?
+
+So we will need a `publish` method.
+
+Since we already know what we want to achieve, let's start modeling it in Django!
+
+## Django model
+
+Knowing what an object is, we can create a Django model for our blog post.
+
+A model in Django is a special kind of object – it is saved in the `database`. A database is a collection of data. This is a place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store our data. This is the default Django database adapter – it'll be enough for us right now.
+
+You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
+
+### Creating an application
+
+To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything organized from the very beginning. To create an application we need to run the following command in the console (from `djangogirls` directory where `manage.py` file is):
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── __init__.py
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    └── mysite
+        ├── __init__.py
+        ├── settings.py
+        ├── urls.py
+        └── wsgi.py
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py`. We need to find `INSTALLED_APPS` and add a line containing `'blog',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog',
+]
+```
+
+### Creating a blog post model
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py`, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey('auth.User',on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(
+            default=timezone.now)
+    published_date = models.DateTimeField(
+            blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. This convention is used frequently in Python and sometimes we also call them "dunder" (short for "double-underscore").
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` is a special keyword that indicates that we are defining an object.
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` means that the Post is a Django Model, so Django knows that it should be saved in the database.
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### Create tables for models in your database
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Rendering model states... DONE
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/yo/django_orm/README.md b/yo/django_orm/README.md
new file mode 100644
index 00000000000..31c47f27764
--- /dev/null
+++ b/yo/django_orm/README.md
@@ -0,0 +1,218 @@
+# Django ORM and QuerySets
+
+In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
+
+## What is a QuerySet?
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+It's easiest to learn by example. Let's try this, shall we?
+
+## Django shell
+
+Open up your local console (not on PythonAnywhere) and type this command:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+The effect should be like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too, of course.
+
+### All objects
+
+Let's try to display all of our posts first. You can do that with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### Create object
+
+This is how you create a new Post object in database:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+Let's import User model first:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+What users do we have in our database? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat! Of course, you have to adjust this line to use your own username.
+
+Now we can finally create our post:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+Hurray! Wanna check if it worked?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+There it is, one more post in the list!
+
+### Add more posts
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### Filter objects
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. We will use `filter` instead of `all` in `Post.objects.all()`. In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. Now our piece of code looks like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+[<Post: Sample title>, <Post: 4th title of post>]
+```
+
+> **Note** There are two underscore characters (`_`) between `title` and `contains`. Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[]
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+And then publish it with our `publish` method:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+[<Post: Sample title>]
+```
+
+### Ordering objects
+
+QuerySets also allow you to order the list of objects. Let's try to order them by `created_date` field:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
+```
+
+We can also reverse the ordering by adding `-` at the beginning:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
+```
+
+### Chaining QuerySets
+
+You can also combine QuerySets by **chaining** them together:
+
+    >>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    
+
+This is really powerful and lets you write quite complex queries.
+
+Cool! You're now ready for the next part! To close the shell, type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/yo/django_start_project/README.md b/yo/django_start_project/README.md
new file mode 100644
index 00000000000..fe1abc7ca9a
--- /dev/null
+++ b/yo/django_start_project/README.md
@@ -0,0 +1,202 @@
+# Your first Django project!
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+We're going to create a small blog!
+
+The first step is to start a new Django project. Basically, this means that we'll run some scripts provided by Django that will create the skeleton of a Django project for us. This is just a bunch of directories and files that we will use later.
+
+The names of some files and directories are very important for Django. You should not rename the files that we are about to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure to be able to find important things.
+
+> Remember to run everything in the virtualenv. If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. We explained how to do that in the **Django installation** chapter in the **Working with virtualenv** part. Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> The period `.` is crucial because it tells the script to install Django in your current directory (for which the period `.` is a short-hand reference).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` is a script that will create the directories and files for you. You should now have a directory structure which looks like this:
+
+    djangogirls
+    ├───manage.py
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+The `settings.py` file contains the configuration of your website.
+
+Remember when we talked about a mail carrier checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore the other files for now as we won't change them. The only thing to remember is not to delete them by accident!
+
+## Changing settings
+
+Let's make some changes in `mysite/settings.py`. Open the file using the code editor you installed earlier.
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+It would be nice to have the correct time on our website. Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for english or `de` for german, and the country code, e.g. `de` for germany or `ch` for switzerland. You will want to add this if you want the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/1.11/ref/settings/#language-code).
+
+Change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.c9users.io` to the `ALLOWED_HOSTS` if you are using cloud9
+
+## Set up a database
+
+There's a lot of different database software that can store data for your site. We'll use the default one, `sqlite3`.
+
+This is already set up in this part of your `mysite/settings.py` file:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+To create a database for our blog, let's run the following in the console: `python manage.py migrate` (we need to be in the `djangogirls` directory that contains the `manage.py` file). If that goes well, you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying sessions.0001_initial... OK
+    
+
+And we're done! Time to start the web server and see if our website is working!
+
+## Starting the web server
+
+You need to be in the directory that contains the `manage.py` file (the `djangogirls` directory). In the console, we can start the web server by running `python manage.py runserver`:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now all you need to do is check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook, you'll always visit your test server by accessing:
+
+{% filename %}browser{% endfilename %}
+
+    https://django-girls-<your cloud9 username>.c9users.io
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![It worked!](images/it_worked2.png)
+
+While the web server is running, you won't see a new command-line prompt to enter additional commands. The terminal will accept new text but will not execute new commands. This is because the web server continuously runs in order to listen for incoming requests.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/yo/django_templates/README.md b/yo/django_templates/README.md
new file mode 100644
index 00000000000..263eb1fd835
--- /dev/null
+++ b/yo/django_templates/README.md
@@ -0,0 +1,106 @@
+# Django templates
+
+Time to display some data! Django gives us some helpful built-in **template tags** for that.
+
+## What are template tags?
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## Display post list template
+
+In the previous chapter we gave our template a list of posts in the `posts` variable. Now we will display it in HTML.
+
+To print a variable in Django templates, we use double curly brackets with the variable's name inside, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+Try this in your `blog/templates/blog/post_list.html` template. Replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. Save the file, and refresh the page to see the results:
+
+![Figure 13.1](images/step1.png)
+
+As you can see, all we've got is this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+This means that Django understands it as a list of objects. Remember from **Introduction to Python** how we can display lists? Yes, with for loops! In a Django template you do them like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+Try this in your template.
+
+![Figure 13.2](images/step2.png)
+
+It works! But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. You can mix HTML and template tags. Our `body` will look like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<div>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</div>
+
+{% for post in posts %}
+    <div>
+        <p>published: {{ post.published_date }}</p>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+{% raw %}Everything you put between `{% for %}` and `{% endfor %}` will be repeated for each object in the list. Refresh your page:{% endraw %}
+
+![Figure 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }})`? We are accessing data in each of the fields defined in our `Post` model. Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## One more thing
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to Github
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add --all .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* Then, log back in to [PythonAnywhere](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one), and run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. Your update should be live! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://yourname.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/yo/django_urls/README.md b/yo/django_urls/README.md
new file mode 100644
index 00000000000..c491b27de5c
--- /dev/null
+++ b/yo/django_urls/README.md
@@ -0,0 +1,129 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## What is a URL?
+
+A URL is simply a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` is a URL! And `https://djangogirls.org` is also a URL.)
+
+![Url](images/url.png)
+
+Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens that URL. In Django we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match with the requested URL to find the correct view.
+
+## How do URLs work in Django?
+
+Let's open up the `mysite/urls.py` file in your code editor of choice and see what it looks like:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    url(r'^admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Regex
+
+Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses `regex`, short for "regular expressions". Regex has a lot (a lot!) of rules that form a search pattern. Since regexes are an advanced topic, we will not go in detail over how they work.
+
+If you still wish to understand how we created the patterns, here is an example of the process – we will only need a limited subset of the rules to express the pattern we are looking for, namely:
+
+* `^` for the beginning of the text
+* `$` for the end of the text
+* `\d` for a digit
+* `+` to indicate that the previous item should be repeated at least once
+* `()` to capture part of the pattern
+
+Anything else in the URL definition will be taken literally.
+
+Now imagine you have a website with the address like `http://www.mysite.com/post/12345/`, where `12345` is the number of your post.
+
+Writing separate views for all the post numbers would be really annoying. With regular expressions, we can create a pattern that will match the URL and extract the number for us: `^post/(\d+)/$`. Let's break this down piece by piece to see what we are doing here:
+
+* **^post/** is telling Django to take anything that has `post/` at the beginning of the url (right after `^`)
+* **(\d+)** means that there will be a number (one or more digits) and that we want the number captured and extracted
+* **/** tells django that another `/` character should follow
+* **$** then indicates the end of the URL meaning that only strings ending with the `/` will match this pattern
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. Note that we are using the `include` function here so you will need to add that import.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import include
+from django.conf.urls import url
+from django.contrib import admin
+
+urlpatterns = [
+    url(r'^admin/', admin.site.urls),
+    url(r'', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and look for further instructions there.
+
+Writing regular expressions in Python is always done with `r` in front of the string. This is a helpful hint for Python that the string may contain special characters that are not meant for Python itself, but for the regular expression instead.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+```
+
+Here we're importing Django's function `url` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the `^$` URL. This regular expression will match `^` (a beginning) followed by `$` (an end) – so only an empty string will match. That's correct, because in Django URL resolvers, 'http://127.0.0.1:8000/' is not a part of the URL. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage your `/admin/` will also not work. No worries – we will get there.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/urls/
\ No newline at end of file
diff --git a/yo/django_views/README.md b/yo/django_views/README.md
new file mode 100644
index 00000000000..07afe091a52
--- /dev/null
+++ b/yo/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+Time to get rid of the bug we created in the last chapter! :)
+
+A *view* is a place where we put the "logic" of our application. It will request information from the `model` you created before and pass it to a `template`. We'll create a template in the next chapter. Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views are placed in the `views.py` file. We will add our *views* to the `blog/views.py` file.
+
+## blog/views.py
+
+OK, let's open up this file and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and `return` a function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+Another error! Read what's going on now:
+
+![Error](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/1.11/topics/http/views/
\ No newline at end of file
diff --git a/yo/dynamic_data_in_templates/README.md b/yo/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..807bb666ebc
--- /dev/null
+++ b/yo/dynamic_data_in_templates/README.md
@@ -0,0 +1,81 @@
+# Dynamic data in templates
+
+We have different pieces in place: the `Post` model is defined in `models.py`, we have `post_list` in `views.py` and the template added. But how will we actually make our posts appear in our HTML template? Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+This is exactly what *views* are supposed to do: connect models and templates. In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py`. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+Remember when we talked about including code written in different files? Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). Then we import the name of the model (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+Now we put this piece of code inside the `blog/views.py` file by adding it to the function `def post_list(request)`, but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+The last missing part is passing the `posts` QuerySet to the template context. Don't worry – we will cover how to display it in a later chapter.
+
+Please note that we create a *variable* for our QuerySet: `posts`. Treat this as the name of our QuerySet. From now on we can refer to it by this name.
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. We need to give them names (we will stick to `'posts'` right now). :) It should look like this: `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+So finally our `blog/views.py` file should look like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+That's it! Time to go back to our template and display this QuerySet!
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/1.11/ref/models/querysets/
\ No newline at end of file
diff --git a/yo/extend_your_application/README.md b/yo/extend_your_application/README.md
new file mode 100644
index 00000000000..0bae760be7c
--- /dev/null
+++ b/yo/extend_your_application/README.md
@@ -0,0 +1,197 @@
+# Extend your application
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, url, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## Create a template link to a post's detail
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. So far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h1><a href="">{{ post.title }}</a></h1>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h1><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique name for each record in a database. Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a number that increases by one for each record, i.e. 1, 2, 3) and adds it as a field named `pk` to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## Create a URL to a post's detail
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Add the line `url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),` to the `blog/urls.py` file. The file should look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.conf.urls import url
+from . import views
+
+urlpatterns = [
+    url(r'^$', views.post_list, name='post_list'),
+    url(r'^post/(?P<pk>\d+)/$', views.post_detail, name='post_detail'),
+]
+```
+
+This part `^post/(?P<pk>\d+)/$` looks scary, but no worries – we will explain it for you:
+
+- it starts with `^` again – "the beginning".
+- `post/` just means that after the beginning, the URL should contain the word **post** and a **/**. So far so good.
+- `(?P<pk>\d+)` – this part is trickier. It means that Django will take everything that you place here and transfer it to a view as a variable called `pk`. (Note that this matches the name we gave the primary key variable back in `blog/templates/blog/post_list.html`!) `\d` also tells us that it can only be a digit, not a letter (so everything between 0 and 9). `+` means that there needs to be one or more digits there. So something like `http://127.0.0.1:8000/post//` is not valid, but `http://127.0.0.1:8000/post/1234567890/` is perfectly OK!
+- `/` – then we need a **/** again.
+- `$` – "the end"!
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? Of course: adding a view!
+
+## Add a post's detail view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that we need to use exactly the same name as the one we specified in urls (`pk`). Omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But, of course, Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`.
+
+It will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <div class="post">
+        {% if post.published_date %}
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+        {% endif %}
+        <h1>{{ post.title }}</h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ..` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+## One more thing: deploy time!
+
+It'd be good to see if your website will still be working on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add --all .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd my-first-blog
+    $ git pull
+    [...]
+    
+
+Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload**.
+
+And that should be it! Congrats :)
\ No newline at end of file
diff --git a/yo/how_the_internet_works/README.md b/yo/how_the_internet_works/README.md
new file mode 100644
index 00000000000..efd95c3f4b2
--- /dev/null
+++ b/yo/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# How the Internet works
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions, and present these files that your website is made of, exactly the way you want.
+
+As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful computers called *servers*. They don't have a screen, mouse or a keyboard, because their main purpose is to store data and serve it. That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+We drew you a picture! It looks like this:
+
+![Figure 1.1](images/internet_1.png)
+
+Looks like a mess, right? In fact it is a network of connected machines (the above-mentioned *servers*). Hundreds of thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map website (http://submarinecablemap.com) to see how complicated the net is. Here is a screenshot from the website:
+
+![Figure 1.2](images/internet_3.png)
+
+It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+It looks like this:
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to another, and another until it is delivered at its destination. The only unique thing is that if you send many letters (*data packets*) to the same place, they could go through totally different post offices (*routers*). This depends on how they are distributed at each office.
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Of course, instead of paper and pen you use bytes of data, but the idea is the same!
+
+Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. You also use a language that the receiver understands, right? The same applies to the *data packets* you send to see a website. We use a protocol called HTTP (Hypertext Transfer Protocol).
+
+So, basically, when you have a website, you need to have a *server* (machine) where it lives. When the *server* receives an incoming *request* (in a letter), it sends back your website (in another letter).
+
+Since this is a Django tutorial, you might ask what Django does. When you send a response, you don't always want to send the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just written to you, right? Django helps you with creating these personalized, interesting letters. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/yo/html/README.md b/yo/html/README.md
new file mode 100644
index 00000000000..004985089c2
--- /dev/null
+++ b/yo/html/README.md
@@ -0,0 +1,213 @@
+# Introduction to HTML
+
+What's a template, you may ask?
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter, because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## What is HTML?
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML stands for "HyperText Markup Language". **HyperText** means it's a type of text that supports hyperlinks between pages. **Markup** means we have taken a document and marked it up with code to tell something (in this case, a browser) how to interpret the page. HTML code is built with **tags**, each one starting with `<` and ending with `>`. These tags represent markup **elements**.
+
+## Your first template!
+
+Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
+
+Templates are saved in `blog/templates/blog` directory. So first create a directory called `templates` inside your blog directory. Then create another directory called `blog` inside your templates directory:
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is simply a useful naming convention that makes life easier when things start to get more complicated.)
+
+And now create a `post_list.html` file (just leave it blank for now) inside the `blog/templates/blog` directory.
+
+See how your website looks now: http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go into command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![Figure 11.1](images/step1.png)
+
+No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Add the following to your template file:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![Figure 11.2](images/step3.png)
+
+It worked! Nice work there :)
+
+* The most basic tag, `<html>`, is always the beginning of any web page and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+Each HTML page is also divided into two elements: **head** and **body**.
+
+* **head** is an element that contains information about the document that is not displayed on the screen.
+
+* **body** is an element that contains everything else that is displayed as part of the web page.
+
+We use `<head>` to tell the browser about the configuration of the page, and `<body>` to tell it what's actually on the page.
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+Save the file and refresh your page.
+
+![Figure 11.3](images/step4.png)
+
+Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted `<title>Ola's blog</title>` and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
+
+Probably you have also noticed that each opening tag is matched by a *closing tag*, with a `/`, and that elements are *nested* (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
+
+It's like putting things into boxes. You have one big box, `<html></html>`; inside it there is `<body></body>`, and that contains still smaller boxes: `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## Customize your template
+
+You can now have a little fun and try to customize your template! Here are a few useful tags for that:
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` for a heading at the next level
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` emphasizes your text
+* `<strong>text</strong>` strongly emphasizes your text
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` creates a link
+* `<ul><li>first item</li><li>second item</li></ul>` makes a list, just like this one!
+* `<div></div>` defines a section of the page
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <div>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </div>
+
+        <div>
+            <p>published: 14.06.2014, 12:14</p>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </div>
+    </body>
+</html>
+```
+
+We've created three `div` sections here.
+
+* The first `div` element contains the title of our blog – it's a heading and a link
+* Another two `div` elements contain our blogposts with a published date, `h2` with a post title that is clickable and two `p`s (paragraph) of text, one for the date and one for our blogpost.
+
+It gives us this effect:
+
+![Figure 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## One more thing: deploy!
+
+It'd be good to see all this out and live on the Internet, right? Let's do another PythonAnywhere deploy:
+
+### Commit, and push your code up to Github
+
+First off, let's see what files have changed since we last deployed (run these commands locally, not on PythonAnywhere):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes within this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add --all .
+    
+
+> **Note** `--all` means that `git` will also recognize if you've deleted files (by default, it only recognizes new/modified files). Also remember (from chapter 3) that `.` means the current directory.
+
+Before we upload all the files, let's check what `git` will be uploading (all the files that `git` will upload should now appear in green):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message" where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something descriptive so that you can remember what you've done in the future.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull your new code down to PythonAnywhere, and reload your web app
+
+* Open up the [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) and go to your **Bash console** (or start a new one). Then, run:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/my-first-blog
+    $ git pull
+    [...]
+    
+
+And watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **Files tab** and view your code on PythonAnywhere.
+
+* Finally, hop on over to the [Web tab](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/yo/install_git.md b/yo/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/yo/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/yo/installation/README.md b/yo/installation/README.md
new file mode 100644
index 00000000000..a7c627136c8
--- /dev/null
+++ b/yo/installation/README.md
@@ -0,0 +1,58 @@
+# If you're doing the tutorial at home
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover these things in the whole tutorial anyway, and this is just an additional page that gathers all of the installation instructions in one place. The Django Girls event includes one "Installation evening" where we install everything so we don't need to bother with it during the workshop, so this is useful for us.
+
+If you find it useful, you can follow this chapter too. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation part to you later on.
+
+Good luck!
+
+# Installation
+
+In the workshop you will be building a blog, and there are a few setup tasks in the tutorial which would be good to work through beforehand so that you are ready to start coding on the day.
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Install Python
+
+{% include "/python_installation/instructions.md" %}
+
+# Set up virtualenv and install Django
+
+{% include "/django_installation/instructions.md" %}
+
+# Install a code editor
+
+{% include "/code_editor/instructions.md" %}
+
+# Install Git
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account.
+
+# Create a PythonAnywhere account
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/yo/instructions.md b/yo/instructions.md
new file mode 100644
index 00000000000..be0a284adad
--- /dev/null
+++ b/yo/instructions.md
@@ -0,0 +1,201 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Gründemann et al.
+
+## Virtual environment
+
+Before we install Django we will get you to install an extremely useful tool to help keep your coding environment tidy on your computer. It's possible to skip this step, but it's highly recommended. Starting with the best possible setup will save you a lot of trouble in the future!
+
+So, let's create a **virtual environment** (also called a *virtualenv*). Virtualenv will isolate your Python/Django setup on a per-project basis. This means that any changes you make to one website won't affect any others you're also developing. Neat, right?
+
+All you need to do is find a directory in which you want to create the `virtualenv`; your home directory, for example. On Windows it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example `C:\djangogirls`.
+
+For this tutorial we will be using a new directory `djangogirls` from your home directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+We will make a virtualenv called `myvenv`. The general command will be in the format:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces, accents or special characters. It is also good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+Creating a `virtualenv` on both Linux and OS X is as simple as running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` is the name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt-get install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> To get around this, use the `virtualenv` command instead.
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt-get install python-virtualenv
+>     $ virtualenv --python=python3.6 myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python3.6-venv
+>     
+
+<!--endsec-->
+
+## Working with virtualenv
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directory and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** on Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** sometimes `source` might not be available. In those cases try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install --upgrade pip
+    
+
+Then run `pip install django~=1.11.0` (note that we use a tilde followed by an equal sign: `~=`) to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install django~=1.11.0
+    Collecting django~=1.11.0
+      Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
+    Installing collected packages: django
+    Successfully installed django-1.11.3
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows platform, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze after when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install django~=1.11.0
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/yo/intro_to_command_line/README.md b/yo/intro_to_command_line/README.md
new file mode 100644
index 00000000000..5fb6d48dd1f
--- /dev/null
+++ b/yo/intro_to_command_line/README.md
@@ -0,0 +1,429 @@
+# Introduction to the command-line interface
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**Let us introduce you to your first new friend: the command line!**
+
+The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really it's just a prompt waiting for commands from you.
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## What is the command line?
+
+The window, which is usually called the **command line** or **command-line interface**, is a text-based application for viewing, handling, and manipulating files on your computer. It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. Other names for the command line are: *cmd*, *CLI*, *prompt*, *console* or *terminal*.
+
+## Open the command-line interface
+
+To start some experiments we need to open our command-line interface first.
+
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Go to Start menu → Windows System → Command Prompt.
+
+> On older versions of Windows, look in Start menu → All Programs → Accessories → Command Prompt.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, but that may depend on your system. If it's not there, just Google it. :)
+
+<!--endsec-->
+
+## Prompt
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see `$`, just like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, it's a `>` sign, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+<!--endsec-->
+
+Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. You can ignore the left part and just type in the command which starts after the prompt.
+
+## Your first command (YAY!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## Basics
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### Current directory
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With powershell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2014 07:28 PM <DIR>      Applications
+    05/08/2014 07:28 PM <DIR>      Desktop
+    05/08/2014 07:28 PM <DIR>      Downloads
+    05/08/2014 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In powershell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X and Linux" data-id="OSX_Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there just by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### Solution:
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2014 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## Summary
+
+Here is a summary of some useful commands:
+
+| Command (Windows) | Command (Mac OS / Linux) | Description                | Example                                           |
+| ----------------- | ------------------------ | -------------------------- | ------------------------------------------------- |
+| exit              | exit                     | close the window           | **exit**                                          |
+| cd                | cd                       | change directory           | **cd test**                                       |
+| cd                | pwd                      | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)      |
+| dir               | ls                       | list directories/files     | **dir**                                           |
+| copy              | cp                       | copy file                  | **copy c:\test\test.txt c:\windows\test.txt** |
+| move              | mv                       | move file                  | **move c:\test\test.txt c:\windows\test.txt** |
+| mkdir             | mkdir                    | create a new directory     | **mkdir testdirectory**                           |
+| rmdir (or del)    | rm                       | delete a file              | **del c:\test\test.txt**                        |
+| rmdir /S          | rm -r                    | delete a directory         | **rm -r testdirectory**                           |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## Ready?
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/yo/python_installation/README.md b/yo/python_installation/README.md
new file mode 100644
index 00000000000..93f81cb42d9
--- /dev/null
+++ b/yo/python_installation/README.md
@@ -0,0 +1,15 @@
+# Let’s start with Python
+
+We're finally here!
+
+But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating websites, games, scientific software, graphics, and much, much more.
+
+Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!). This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python installation
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the Installation steps, there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/yo/python_installation/instructions.md b/yo/python_installation/instructions.md
new file mode 100644
index 00000000000..31cde2d0baf
--- /dev/null
+++ b/yo/python_installation/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/yo/python_introduction/README.md b/yo/python_introduction/README.md
new file mode 100644
index 00000000000..c1642302532
--- /dev/null
+++ b/yo/python_introduction/README.md
@@ -0,0 +1,1062 @@
+# Introduction to Python
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python prompt
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python 3.6.1 (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## Your first Python command!
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, just type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## Strings
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, simply type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### Summary
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## Errors
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- The `str` function converts things into **strings**
+- The `int` function converts things into **integers**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## Variables
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Simply enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Of course, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## The print function
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## Lists
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## Dictionaries
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- The key `name` points to the value `'Ola'` (a `string` object),
+- `country` points to `'Poland'` (another `string`),
+- and `favorite_numbers` points to `[7, 42, 92]` (a `list` with three numbers in it).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Just have a solution in mind before looking at the answer in the next line.
+
+- Do you just need an ordered sequence of items? Go for a list.
+- Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` method on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, just type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### Summary
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## Compare things
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers, of course. Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare method results. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y means: x is greater than y
+- x `<` y means: x is less than y
+- x `<=` y means: x is less than or equal to y
+- x `>=` y means: x is greater than or equal to y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## Boolean
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well, of course.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# Save it!
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- Exit the Python interpreter
+- Open up our code editor of choice
+- Save some code into a new python file
+- Run it!
+
+To exit from the Python interpreter that we've been using, simply type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file:
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. This is called "syntax highlighting", and it's a really useful feature when coding. The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). This is one of the reasons we use a code editor. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this (the word "Desktop" might be translated to your local language):
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, just ask for help.
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single `tab` will also count as 4 spaces.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### What if a condition isn't True?
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### Summary
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## Your own functions!
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. This is because Python reads the file and executes it from top to bottom. So in order to use our function, we have to re-write it at the bottom.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will use the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## Loops
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The ```for``` statement behaves similarly to the ```if``` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## Summary
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/yo/signup_pythonanywhere.md b/yo/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/yo/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/yo/template_extending/README.md b/yo/template_extending/README.md
new file mode 100644
index 00000000000..35997f913d3
--- /dev/null
+++ b/yo/template_extending/README.md
@@ -0,0 +1,147 @@
+# Template extending
+
+Another nice thing Django has for you is **template extending**. What does this mean? It means that you can use the same parts of your HTML for different pages of your website.
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+A base template is the most basic template that you extend on every page of your website.
+
+Let's create a `base.html` file in `blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load staticfiles %}
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
+        <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <div class="page-header">
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </div>
+
+        <div class="content container">
+            <div class="row">
+                <div class="col-md-8">
+                {% for post in posts %}
+                    <div class="post">
+                        <div class="date">
+                            {{ post.published_date }}
+                        </div>
+                        <h1><a href="">{{ post.title }}</a></h1>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </div>
+                {% endfor %}
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
+```
+
+Then in `base.html`, replace your whole `<body>` (everything between `<body>` and `</body>`) with this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <div class="page-header">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+    <div class="content container">
+        <div class="row">
+            <div class="col-md-8">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </div>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). We will show you how to do this in a moment.
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <div class="post">
+        <div class="date">
+            {{ post.published_date }}
+        </div>
+        <h1><a href="">{{ post.title }}</a></h1>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </div>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. Like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <div class="post">
+            <div class="date">
+                {{ post.published_date }}
+            </div>
+            <h1><a href="">{{ post.title }}</a></h1>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </div>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/yo/whats_next/README.md b/yo/whats_next/README.md
new file mode 100644
index 00000000000..fbb1d2a7d6e
--- /dev/null
+++ b/yo/whats_next/README.md
@@ -0,0 +1,25 @@
+# What's next?
+
+Congratulate yourself! **You're totally awesome**. We're proud! <3
+
+### What to do now?
+
+Take a break and relax. You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### Can you recommend any further resources?
+
+Yes! First, go ahead and try our other book, called [Django Girls Tutorial: Extensions](https://djangogirls.gitbooks.io/django-girls-tutorial-extensions/content/).
+
+Later on, you can try the resources listed below. They're all very recommended!
+
+- [Django's official tutorial](https://docs.djangoproject.com/en/1.11/intro/tutorial01/)
+- [New Coder tutorials](http://newcoder.io/tutorials/)
+- [Code Academy Python course](https://www.codecademy.com/en/tracks/python)
+- [Code Academy HTML & CSS course](https://www.codecademy.com/tracks/web)
+- [Django Carrots tutorial](https://github.com/ggcarrots/django-carrots)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Two Scoops of Django 1.11: Best Practices for Django Web Framework book](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11)
+- [Hello Web App: Learn How to Build a Web App](https://hellowebapp.com/) - you can also request a free eBook licence by contacting the author Tracy Osborn at <tracy@limedaring.com>
\ No newline at end of file
diff --git a/zh-CN/GLOSSARY.md b/zh-CN/GLOSSARY.md
new file mode 100644
index 00000000000..17ceeab9b1e
--- /dev/null
+++ b/zh-CN/GLOSSARY.md
@@ -0,0 +1,3 @@
+# 代码编辑器
+
+代码编辑器是应用程序，允许您将保存您的代码，这样您可以稍后再打开它。 你可以从[代码编辑器](./code_editor/README.md)这一章节了解
\ No newline at end of file
diff --git a/zh-CN/README.md b/zh-CN/README.md
new file mode 100644
index 00000000000..b1f3907474f
--- /dev/null
+++ b/zh-CN/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教程！ We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## 介绍
+
+你有没有觉得这个世界的的科技化程度已经(几乎)越来越难以描述？ 你有没有想去做一个网站，但是却从未有过足够的动力去开始吗? 你有没有想过软件世界太过复杂，即使你想做一些属于自己的东西？
+
+好的，我们跟你讲一个好消息！编程没有看上去那么复杂，我们将给你展示它是多么的有趣。
+
+本教程没有让你秒变程序员的魔力。 如果你想变得擅长于此，你需要数月乃至数年的时间去学习和练习。 但是我们想展示给你编程和创建网站没有看起来那么复杂。 我们试着用深入浅出的方法解释，所以你不会觉得被技术吓到。
+
+我们希望我们可以让你变得更爱技术，像我们一样！
+
+## 在本教程里你会学到什么？
+
+一旦你完成此教程，你将会拥有一个小型的可用的网站应用：你的个人博客。我们将会向你展示如何推送到线上，以便人人都能看到你的网站。
+
+它将（或多或少）看起来像这个样子：
+
+![图0.1](images/application.png)
+
+> 如果你独自学习这个教程而苦于没有一位能帮你答疑解惑的的教练，我们给你提供交流的平台：[!( Chat. svg)![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)。 我们要求我们的教练以及之前的参与者时不时到那里去，帮助其他人参与本教程！ 不要担心什么，尽管大胆地提问吧！
+
+Ok,[那让我们从头开始吧...](./how_the_internet_works/README.md)
+
+## 在家学习本教程
+
+如果能参加Django Girls实习班将是非常美妙的事情，但不一定总是有机会能参加。 所以我们鼓励你尝试在家里学习此教程。 对于在家学习本教程的那些读者，我们正在制作一些视频，以方便你能更好的自学本教程。 这项工作正在进行中，但是越来越多的内容将会添加到 [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed)视频中，你可以通过YouTube频道观看。
+
+在已经涵盖的每一章中, 都有一个指向正确视频的链接。
+
+## 关于和贡献
+
+这个教程由[DjangoGirls](https://djangogirls.org/)维护。 如果你发现本网有任何错误或想更新教程，请按照 [贡献指导](https://github. com/DjangoGirls/tutorial/blob/master/Contributing. md)行动.
+
+## 你是否愿意帮助我们把本教程翻译成其他的语言呢？
+
+现在，翻译工作正在crowdin.com 平台上进行：
+
+https://crowdin.com/project/django-girls-tutorial
+
+如果你使用的语言没有列在 [crowdin](https://crowdin.com/)上，请[open a new issue](https://github.com/DjangoGirls/tutorial/issues/new)通知我们，我们将会添加此语言。
\ No newline at end of file
diff --git a/zh-CN/SUMMARY.md b/zh-CN/SUMMARY.md
new file mode 100644
index 00000000000..b1c371464b0
--- /dev/null
+++ b/zh-CN/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-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [安装（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 admin 管理后台](django_admin/README.md)
+* [部署！](deploy/README.md)
+* [Django urls](django_urls/README.md)
+* [Django 视野-快来创造吧！ ](django_views/README.md)
+* [HTML简介](html/README.md)
+* [Django ORM (查询集)](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)
\ No newline at end of file
diff --git a/zh-CN/chromebook_setup/README.md b/zh-CN/chromebook_setup/README.md
new file mode 100644
index 00000000000..8b7c5a7ee68
--- /dev/null
+++ b/zh-CN/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chrome 笔记本电脑的设置
+
+> **注意**如果你已经操作过 [安装步骤](../installation/README.md), 不需要再操作一次 – 你可以略过这步直接到 [Python 简介](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/zh-CN/chromebook_setup/instructions.md b/zh-CN/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..d7ca03c6ad7
--- /dev/null
+++ b/zh-CN/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+如果不使用 Chromebook, 则可以 [ 跳过本节 ](http://tutorial.djangogirls.org/en/installation/#install-python)。 如果您是使用 Chrome笔记本电脑, 您的安装体验将会有一点不同。 您可以忽略其余的安装说明。
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloude IDE (云集成开发环境）是为你提供代码编辑器，访问在Internet上运行的计算机，并且可以在期间安装、编写和运行程序的工具。 在此教程中， cloude IDE 将作为你的<本地计算机> 你仍将会在终端界面运行命令，就像你的同学使用OS X, Ubuntu, 或者Windows时一样，但是你的终端将会连接一台cloude IDE（云集成开发环境）为你设置的其他地方的计算机。 以下是cloude IDEs 的操作说明（PaizaCloud Cloud IDE, AWS Cloud9）. 你可以选择其中一个cloud IDE, 然后根据说明进行操作。
+
+#### PaizaCloud 云集成开发环境
+
+1. 前往 [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. 注册一个账户
+3. 点击*新服务器*，然后选择Django应用
+4. 点击“终端‘’按钮（在窗口的左侧）
+
+现在你可看见一个带有侧边栏、左边按钮的界面。 点击“Terminal”按钮打开终端窗口，如下所示：
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+    
+
+PaizaCloud Cloud IDE的终端是为你的指示准备的。 你可以调整窗口大小或者最大化窗口，令其显示更大。
+
+#### AWS Cloud9（AWS云开发9）
+
+目前，Cloud 9要求您使用AWS账号注册并且需要输入信用卡 信息。
+
+1. 从[Chrome网上商店](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)下载安装Cloud9.
+2. 转到 [c9.io](https://c9.io)并点击 *开始使用 AWS Cloud9*
+3. 注册一个 AWS 帐户 (需要信用卡信息，但您可以免费使用)
+4. 在 AWS 仪表盘中，在搜索栏输入 *Cloud9*并点击
+5. 在Cloud9 面板中，点击 *创建环境*
+6. 将其命名为*django-girls*
+7. 在配置设置时，选择 *创建一个新的环境实例 (EC2)* 用于 "环境类型" 和 *t2.micro*"实例类型" (这个VM类型是可以免费账户可以使用的） 缺省的设置是费用最好的，不需要修改缺省的设置。
+8. 点击*下一步*
+9. 点击 *创建环境*
+
+现在你应该看见一个拥有侧边栏，一个包含文本的主窗口，以及一个位于底部的小窗口-看起来像这样：
+
+{% filename %}bash{% endfilename %}
+
+    你的用户名：~工作区 $
+    
+
+底部的区域是你的终端。你可以用终端来向远程的Cloud9计算机发送指示。你可以调整该窗口使之更大。
+
+#### Glitch.com Cloud IDE
+
+1. 前往 [Glitch.com](https://glitch.com/)
+2. 注册一个帐户 (https://glitch.com/signup) 或使用您的 GitHub 帐户（如果您已有Github账户）。(参阅下面的 GitHub 说明)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}终端{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### 虚拟环境
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### Python无处不在
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/zh-CN/code_editor/README.md b/zh-CN/code_editor/README.md
new file mode 100644
index 00000000000..c6954930ec2
--- /dev/null
+++ b/zh-CN/code_editor/README.md
@@ -0,0 +1,11 @@
+# 代码编辑器
+
+> 对于家中的读者：本章将在[Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) 视频中介绍。
+
+你马上就要写下第一行代码，现在该下载一个代码编辑器了！
+
+> **注意** 如果你用的是Chromebook，请跳过本章，并确保你遵循 [Chromebook Setup](../chromebook_setup/README.md)的指示进行操作 你所选择的cloud IDE(PaizaCloud Cloud IDE or AWS Cloud9) 包含一个代码编辑器，当你在你的IDE的文件菜单中打开一个文件，你将自动使用此编辑器。
+> 
+> **注意**你可能在早前的[安装章节](../installation/README.md)中已完成了这一步-如果是的话，你可以跳过直接进入下一章节！
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/zh-CN/code_editor/instructions.md b/zh-CN/code_editor/instructions.md
new file mode 100644
index 00000000000..35bb130358a
--- /dev/null
+++ b/zh-CN/code_editor/instructions.md
@@ -0,0 +1,37 @@
+有很多不同的编辑器，通常根据个人偏好选择。 大部分 Python程序员使用像 PyCharm这样复杂但是功能强大的IDE (集成开发环境)。 然而，这可能不太适合初学者。我们建议使用同样强大但是更为简单的编辑器。
+
+下面是我们的建议，不过你可以随时询问你的教练有什么推荐 - 向他们寻求帮助会更简单些。
+
+## Visual Studio Code
+
+Visual Studio Code是有微软开发的面向Windows、Linux和macOS的一种开源代码编辑器。 它的功能包括支持调试、嵌入Git控制、语法高亮、智能代码完成、代码片断和代码重设。
+
+[在这里下载](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit 是开源、免费的编辑器，支持所有操作系统。
+
+[在这里下载](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text 是一个很受欢迎的、免费试用的编辑器，它很容易安装和使用，并且支持所有操作系统。
+
+[在这里下载](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom是另一个流行的免费，开源，并且支持Windows，OS X 和 Linux的由[GitHub](https://github.com/)开发的编辑器。
+
+[在这里下载](https://atom.io/)
+
+## 我们为什么要安装代码编辑器？
+
+你可能会疑惑为什么我们要安装代码编辑器软件，而不是使用如 Word 或记事本这样的软件。
+
+第一个原因是，代码需要是**纯文本**的，类似Word和Textedit的软件有个问题是，它们生成的不是纯文本，而是使用类似[RTF(Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format)的自定义格式产生富文本(含有不同字体和格式)。
+
+第二个原因是，代码编辑器是专门用来编辑代码的，因此它们会提供一些有用的功能，比如根据代码的含义高亮代码，或者帮你自动匹配引号。
+
+以上这些我们将会在后期的实践中体会。很快，你就会觉得你那似乎过时的老版本的编辑器正是你使用得最得心应手的工具。:)
\ No newline at end of file
diff --git a/zh-CN/css/README.md b/zh-CN/css/README.md
new file mode 100644
index 00000000000..c37e01f57b6
--- /dev/null
+++ b/zh-CN/css/README.md
@@ -0,0 +1,330 @@
+# CSS — 让网页更美观!
+
+我们的博客看起来仍然很丑吧？是时候来让它变得更好看了！为此，我们将引入CSS。
+
+## 什么是 CSS？
+
+层叠样式表 (Cascading Style Sheets) 是一种语言，用于描述使用标记语言 (如 HTML) 编写的网站的外观和格式。我们可以用它来给我们的网页“化妆” ;)。
+
+但我们不会想要再重头来编写css的代码吧？我们将继续使用一些网上已有的免费资源。毕竟重造轮子并不好玩。
+
+## 让我们用 Bootstrap 吧！
+
+Bootstrap是最受欢迎的前端框架之一，可以被用来开发美观的网站
+
+它最先是由 Twitter 的员工开发的。现在由来自世界各地的志愿者开发。
+
+## 安装 Boostrap
+
+要安装Bootstrap，请在代码编辑器中打开 `.html`文件并将其添加到 `<head>`部分：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+这不会将任何文件添加到你的项目中。它只是指向在互联网上已经存在的文件。接着，你只需要打开你的网站并刷新页面。你看！
+
+![图 14.1](images/bootstrap1.png)
+
+已经变得更好看了！
+
+## Django 中的静态文件
+
+最后我们来看看这些我们叫做**静态文件**的东西。 静态文件包含CSS和图像文件。 其内容并不取决于发出的请求而是每个用户都相同的
+
+### Django的静态文件放在哪儿呢？
+
+Django已经知道哪里去寻找内设的 "admin" 应用的静态文件。现在我们只需为我们的应用增加一些静态文件， `blog`.
+
+我们在blog应用的目录下创建一个名为`static`的文件夹，创建后目录结构如下：
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django会自动找出你项目文件夹中所有名为“static”的文件夹。它能够把里面的内容作为静态文件来使用。
+
+## 你的第一个 CSS 文件！
+
+为了给你的网页添加你自己的样式，我们先来创建一个CSS文件吧 创建一个新的目录称为 `css` 里面你 `static` 的目录。 然后在`css`文件夹里新建一个文件命名为`blog.css`。 准备好了吗？
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+是时候来写一些CSS了！首先用你的代码编辑器打开`blog/static/css/blog.css`。
+
+在这里，我们不会太深入的去学习CSS的相关知识。如果你想了解更多内容，可以参考本页末尾提供的CSS免费课程的建议。
+
+但我们至少还会涉及到一些CSS的代码。 让我们尝试改变网页标题的颜色？ 为了理解颜色，计算机使用了一些特殊的代码。 这些代码是由`#`开始，后面跟着六位A到F的字母或0到9的数字。 例如，蓝色的代码是`#0000FF`。 你可以在这个网站找到不同颜色的代码：http://www.colorpicker.com/。 你也可以使用一些[预定义颜色](http://www.w3schools.com/colors/colors_names.asp)，比如`red`和`green`.
+
+在你的`blog/static/css/blog.css`文件中添加下面的代码:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a`是CSS选择器。 这意味着我们要对`h1`中全部有`a`的元素使用这种风格，同理`h2`中全部有`a`的元素。 所以，如果我们有这样的代码`<h1><a href="">link</a></h1>`，通过`h1 a`描述的样式就将会生效。 在这种情况下，我们要告诉它将其颜色更改为 `#C25100`，这是一个暗的橙色。 或者您可以在这里放下你自己的颜色，但确保它与白色背景有良好的对比！
+
+在CSS文件中我们指明了HTML文件里各种元素的样式。 我们识别元素的第一种方法是使用元素的名称。 你可能还记得那些HTML部分中的标签。 诸如`a`，`h1`和`body`等都是元素的名称。 我们也可以用`class`属性和`id`属性来定义元素。 class和id是你自己给该元素定义的名称。 class定义一组元素，而id则指定特定的元素。 For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+你可以通过[w3schools的CSS选择器部分](http://www.w3schools.com/cssref/css_selectors.asp)了解更多内容。
+
+然后，我们需要让HTML文件知道我们增加了一些CSS样式。打开文件`blog/templates/blog/post_list.html`并把这行代码放在HTML文件的开头。
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+我们只是在这里加载静态文件。:) 接下来，我们在`<head>`和`</head>`之间，把下面这一行写到Bootstrap的文件链接之后。
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+浏览器按照给定的顺序读取文件，所以我们需要确保这行代码写在正确的位置。 否则，我们在CSS文件中代码可能被Bootstrap文件中的代码覆盖。 这样，HTML文件就知道我们的CSS文件的位置了。
+
+现在你的HTML文件应该看起来像这样：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK, 保存文件再刷新下网页吧！
+
+![图 14.2](images/color2.png)
+
+哎呦不错哦，也许我们还可以给我们的网页增加一点空白，比如增加一下左边的边距？来试试吧！
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+把它添加到你的CSS文件中，保存文件，然后看看你的网页发生了什么变化吧！
+
+![图 14.3](images/margin2.png)
+
+接着我们可以试试自定义标题中的字体。把这段代码粘贴到你 `blog/templates/blog/post_list.html`文件中的`<head>`部分：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+跟以前一样，我们需要确保代码的正确顺序。把这一行代码放在链接到`blog/static/css/blog.css`的代码之前。它会从 Google Fonts (https://www.google.com/fonts) 引入一个叫作 *Lobster* 的字体。
+
+在CSS文件`blog/static/css/blog.css`中找到`h1 a`所声明的代码块（即`{`和`}`之间的代码）。 然后在大括号之间加上`font-family: 'Lobster';`。然后刷新页面看看效果吧：
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a {
+    color: #FCA205;
+    font-family: 'Lobster';
+}
+```
+
+![图 14.3](images/font.png)
+
+太棒了！
+
+上文提到过，CSS能通过类(class) 来控制HTML页面的显示。 这样，你就可以给一部分HTML代码命名，然后为其增添样式。而且这并不会影响到其他部分的显示。 这功能超级有用！ 当你有两个不同的div代码块（例如：一个是标题，一个是文章）。 类(class) 的运用就能使这两个代码块拥有不同的样式。
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+现在，我们将把声明组代码放入不同的选择器中。 选择器以 `.` 开始，后面紧跟着类名。 网络上有很多很棒的CSS教程以及相关解释，帮助您理解下面的代码。 至于现在，就先把以下代码复制粘贴到你的 `blog/static/css/blog.css` 文件中吧。
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+然后将文章的HTML代码用类声明包裹起来。替换以下内容：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+在 `blog/templates/blog/post_list.html` 是这样的：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+保存这些文件并刷新您的网站。
+
+![图 14.4](images/final.png)
+
+瞧！ 看起来很棒吧？ 看看我们刚刚复制的代码，然后分别找到我们在HTML中添加的类，和这些类在CSS中的声明组。 如果你想要把日期(data) 的颜色改为青绿色(turquoise)，需要修改哪里的代码呢？
+
+不要害怕，试着去修改一点CSS代码吧。 编写CSS的代码会帮助你理解不同的事物都在做些什么。 如果你不小心破坏了一些东西，不要害怕，因为你总是可以撤销它的。
+
+我们真的建议在免费学习“基础HTML & HTML5”和“基础CSS”课程，在后者[免费CodeCamp](https://learn.freecodecamp.org/) 它可以帮助您了解所有CSS的知识，来使你的网页更加美观。
+
+准备好进入下一章了吗？:)
\ No newline at end of file
diff --git a/zh-CN/deploy/README.md b/zh-CN/deploy/README.md
new file mode 100644
index 00000000000..dea72984573
--- /dev/null
+++ b/zh-CN/deploy/README.md
@@ -0,0 +1,246 @@
+# 部署！
+
+> **注意** 以下章节有时可能难以完成。 坚持并完成它 ；部署是在网站开发过程的重要组成部分。 这一章放在本教程的中部，因此你的指导者可以帮助你在使网站上线中的一些小困难。 这意味着如果您花大量的时间，你仍然能独立完成这个教程。
+
+直到现在，您的网站只能在您的计算机上访问， 现在你要会学习如何部署它！ 部署是在互联网上发布你的应用程序的一系列过程，因此人们最终可以一起去看看你的应用程序. :)
+
+正如你所学习的，一个网站必须要放到一个服务器上。 互联网上有许多服务器供应商，我们将使用 [PythonAnywhere](https://www.pythonanywhere.com/)。 PythonAnywhere 对于一些没有太多访问者的小应用是免费的，所以它对你来说绝对是足够使用的。
+
+其它我们将使用到的外部服务是[GitHub](https://www.github.com)，它是一个代码托管服务。 还有其它的一些服务，但当今几乎所有的程序员都有 GitHub 帐户，并且现在你也会有的！
+
+这三个地方对于你来说很重要。 您的本地计算机将是您开发和测试的地方。 当您高兴地看到更改时，您将在GitHub上放置您的程序副本。 您的网站在PythonAnywhere上部署并通过从GitHub上获取新的代码副本来更新。
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## 开始我们自己的Git版本库
+
+Git跟踪一组特定的在代码仓库（或简称“仓库”）中文件的更改。 我们开始用git管理自己的项目吧。 打开你的终端，进入 `djangogirls` 文件夹运行以下的命令：
+
+> **注意** 在初始化仓库之前，请使用 `pwd`命令 (OSX/Linux) 或者 `cd` (Windows) 命令检查你当前的工作目录。 你应该是在 `djangogirls` 文件夹下运行命令。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+每个项目我们只需要初始化一次Git仓库（而且你从此不需要重新输入用户名和邮箱）。
+
+Git会追踪这个目录下所有文件和文件夹的更改，但是有一些文件我们希望Git忽略它。 为此，我们可以在系统根目录下创建一个命名为 `.gitignore` 的文件。 打开编辑器，创建新文件并写入以下内容：
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+然后在djangogirls项目根目录下将它保存为 `.gitignore`文件。
+
+> **注意** 在文件名最前面的"."很重要。 如果你在创建文件的时候有困难(例如，Macs不能通过Finder创建开头为"."的文件), 可以在编辑器里点击"另存为", 这个没问题的。 确定不添加<0 txt</code>,`><py`,或者文件名中的任何其他扩展名，只有在名称为 `gigistnow`的情况下，该扩展才能被Git 确认。 Linux 和 苹果 MacOS 系统中隐藏文件的文件名会以英文句点“`.`”作为第一个字符 (例如 `.gitignore`)。您无法通过普通`ls` 命令来显示这些文件。 您必须使用 `ls -a ` 来查看`.gitignore` 这样的隐藏文件。
+> 
+> **注意** 您在 `githnode`文件中指定的文件之一是 `db.sqlite3`。 此文件是你的本地数据库，用来存储所有用户和帖子。 我们将遵循标准的网络编程做法，这意味着我们将使用单独的数据库来用于本地测试网站和您的 PythonAnywhere 上的现场网站。 PythonAnywhere 数据库可以像您的开发机器一样使用SQLite，但通常使用一个叫MySQL的站点访问者比SQLite更多。 无论如何，无视您GitHub 复制的SQLite数据库意味着您迄今所创建的所有帖子和超级用户只能在当地使用，并且您必须在生产中创建新的版本。 你应该把本地数据库视为一个可以随意测试不同的事情而不担心你会从博客中删除您的真实帖子的地方。
+
+在执行git操作之前，最好使用 `git status` 命令查看一下当前的状态，尤其是在执行 `git add`或者在你不确定哪些文件被改动的情况下。 这有助于阻止各种意外发生，例如错误的文件被添加或提交。 `git status` 命令会返回所有未追踪/修改/暂存的文件，还有分支状态等信息。 输出将类似于以下内容：
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+最后保存我们的更改。转到你的控制台并运行这些命令：
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## 将您的代码推送至 GitHub
+
+转到 [GitHub.com](https://www.github.com) 并注册一个新的免费用户帐户。 (如果您已经做完了这步，那很棒) 请确认记住了您的密码(如果您使用密码，添加到您的密码管理器)。
+
+现在，创建一个新的仓库，命名为“my-first-blog”。 保持 "initialise with a README" 选框未选中状态，.gitignore 选项为无 (我们已经手动创建了) ，让License设置为无。
+
+![](images/new_github_repo.png)
+
+> **注意** `my-first-blog`这个名字很重要，你可以用其它的，但是这个名字会在教程中出现多次，你需要确保每次都替换掉它。 保持用 `my-first-blog` 这个名字可能更为简单.
+
+在下一个屏幕上，您将显示你的仓库克隆URL，您将会在下面的一些命令中使用：
+
+![](images/github_get_repo_url_screenshot.png)
+
+现在我们需要把你计算机上的Git仓库绑定到 GitHub 上。
+
+在你的终端里输入下面的内容（用你创建的GitHub账号的用户名替代`<your-github-username>`，但是不要带尖括号 -- URL就是你刚才看克隆的时候看到的URL）：
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+当你推送到GitHub时，你会被提示输入GitHub的用户名和密码（可能就是在那个命令行窗口，也可能在一个弹出窗口），输入认证信息后你会看到类似下面的东西：
+
+{% filename %}command-line{% endfilename %}
+
+    计数对象：6, 完成。
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+现在你的代码已经在GitHub上了。 快去确认一下吧！ 你会发现这是一个很好的平台-[Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial)，还有很多其他非常棒的开源软件项目也将他们的代码放在GitHub上。 :)
+
+# 在 PythonAnywhere 设置我们的博客
+
+## 注册一个 PythonAnywher 帐户
+
+> **Note**您可能已经在安装步骤的早期创建了 pythonanywhere 帐户-如果是的话, 则无需重复。
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## 在 pythonanywhere 配置我们的网站
+
+点击图标回到 [PythonAnywhere 主控制面板](https://www.pythonanywhere.com/) ，然后选着启动 "Bash" 控制台的选项-即PythonAnywhere版本的命令行，就像你的计算机的命令行一样。
+
+![在 PythonAnywher 网页界面上 '新建控制台' 部分，按钮为 'bash'](images/pythonanywhere_bash_console.png)
+
+> **注意** PythonAnywhere 基于 Linux系统，因此如果你使用 Windows系统，控制台将会和你本地电脑上的略有不同。
+
+在 pythonanywhere 上部署 web 应用程序涉及从 github 中提取代码, 然后配置 pythonanywhere 以识别它并开始将其作为 web 应用程序提供。 有许多手工操作方式，但是 PythonAnywhere已经提供了帮助工具为你代劳。 让我们先安装它：
+
+{% filename %}PythonAnywhere 命令行{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+这应该列印出一些内容，例如 `收集 pythonanywhere`，并最终以 `Successfully installed (...) pythonanywhere- (...)`结束.
+
+现在我们运行帮助来自动配置我们在GitHub的应用程序。 在 PythonAnywhere 控制台输入以下(不要忘记用你在GitHub用户名来代替 `<your-github-username>`, 以便URL 与GitHub克隆的URL匹配）：
+
+{% filename %}PythonAnywhere 命令行{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+当你看到其运行时，你会看到它所做的事情：
+
+- 从GitHub下载你的代码
+- 在 PythonAnywhere上创建一个virtualenv，就像你自己在你的电脑上的那个一样
+- 使用一些部署设置来更新您的设置文件。
+- 使用 `manage.py migrate` 命令来在 PythonAnywhere创建一个数据库
+- 是指你的静态文件（我们稍后会了解这些文件）
+- 配置PythonAnywhere，并通过其API来为你的网页程序提供服务
+
+在 PythonAnywhere上，所有的这些步骤都会自动的，但是他们和你在其他服务器提供的步骤是一样的。
+
+这里最需要注意的是，你在PythonAnywhere的数据库和你自己电脑里的数据库是完全独立开的，所以它可能会有不同的管理员账号和帖子。 因此，就像刚才在你自己电脑上做过的那样，我们需要用`createsuperuser`初始化管理员账号。 PythonAnywhere 已经自动帮你激活了virtualenv环境，所以你只需要执行：
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+输入管理员的详细信息。为了避免混乱，最好用跟你电脑上相同的信息，除非你想让PythonAnywhere上的密码更加安全。
+
+现在，如果你愿意，你还可以用`ls`查看你在PythonAnywhere的代码：
+
+{% filename %}PythonAnywhere 命令行{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+你也可以转到”文件“页面，用PythonAnywhere的内置文件浏览器导航查阅。 （在控制台页面的右上角，你可以通过菜单按钮转到PythonAnywhere的其他页面。 当你打开其中一个页面后，靠近顶部会出现其他页面的链接。）
+
+## 你现在上线了！
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **注意**这是一个初学者教程，我们在部署这个网站的时候走了一些捷径，但从安全的角度这是不推荐的。 等你决定在这个项目的基础上继续搭建，或者开始一个新项目，建议你去查看[Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/)，来获取一些关于站点安全的提示。
+
+## 调试技巧
+
+如果你在运行`pa_autoconfigure_django.py`脚本的时候遇到错误，通常可能是这些原因：
+
+- 忘记创建PythonAnywhere的API token。
+- 弄错了GitHub的URL
+- 如果你看到一个错误说*"Could not find your settings.py"*，很可能是你向Git添加文件的时候漏掉一些，或者你没有成功推送到GitHub。 再查看一下前面的Git部分
+- 如果你先前注册的 PythonAnywhere 帐户并且有一个错误，你可能有一个旧版本的 SQLite (eg 3)。 (2) 用于您的帐户。 在这种情况下，注册一个新帐户或者在上面的 PythonAnywhere 尝试命令行。
+
+如果你在访问你的网站时候看到一个错误，首先要去 **error log** 中找一些调试信息。 你可以在 PythonAnywhere [Web 选项卡](https://www.pythonanywhere.com/web_app_setup/) 中发现它的链接。 检查那里是否有任何错误信息，底部是最新的信息。
+
+有一些常见的调试小贴士在 [general debugging tips on the PythonAnywhere wiki](http://help.pythonanywhere.com/pages/DebuggingImportError) 里.
+
+记住，你的教练会在这里帮你！
+
+# 查看你的网站！
+
+你网站的默认页面说 “Welcome to Django”，如同你本地计算机上的一样。 试着添加 `/admin/`到URL的末尾，然后你会到达管理者的页面。 使用用户名和密码登录，您将看到您可以在服务器上添加新帖子——请记住， 您本地测试数据库中的帖子没有发送到您的直播博客。
+
+一旦您创建了几个帖子，您可以返回到您的本地设置(不是 PythonAnywhere)。 从这里开始，您应该进行本地设置以进行更改。 这是网页开发中常见的工作流——在本地进行更改 将这些更改推送到GitHub 并将您的更改拉到您的实时Web服务器。 这使得您可以在不打断您的现场网站的情况下工作和实验。 很厉害吧！
+
+给你自己一个*超大*的鼓励！ 服务器部署是web开发中最棘手的部分之一， 它通常要耗费人们几天时间才能搞定。 但你的网站已经上线，运转在真正的互联网上，就是这样！
\ No newline at end of file
diff --git a/zh-CN/deploy/install_git.md b/zh-CN/deploy/install_git.md
new file mode 100644
index 00000000000..3596a7913d7
--- /dev/null
+++ b/zh-CN/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git是一个被大量程序员使用的"版本控制系统"。 此软件可以跟踪任何时间文件的改变，这样你以后可以随时召回某个特定版本。 这有点像文本编辑器中的“文档历史”功能（比如 Microso Word 或 LibreOffice Writer），但更强大。
+
+## 安装Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+你可以从 [git-scm.com](https://git-scm.com/) 下载Git。 全程除了在选择编辑器这一步你需要选择Nano和在调整系统PATH环境选择在Windows Command Prompt中使用Git和其他Unix工具这两步，你可以一直点击next。 除此之外，默认值都没有问题。 签出时使用 Windows 风格的换行符，提交时使用 Unix 风格的换行符，这样比较好。
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+从[git-scm.com](https://git-scm.com/)下载Git,根据说明操作。
+
+> **注意** 如果您正在运行 OS X 10.6, 10.7 或 10.8, 您需要在这里安装 git 版本：[Git 安装操作系统 X Snon Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/zh-CN/deploy/signup_pythonanywhere.md b/zh-CN/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..2c38f922861
--- /dev/null
+++ b/zh-CN/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere 是在服务器上运行Python代码的服务"云端"。 我们将使用 来托管我们的网站，直播和在互联网。
+
+我们将在 PythonAnywhere 上创建我们的博客。 注册在 PythonAnywhere 上的 "初学者" 帐户(免费等级很好，您不需要信用卡)。
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![PythonAnywhere 注册页面显示按钮创建一个免费的“初学者”帐户](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **注意** 在这里选择您的用户名时，请记住您的博客URL将采取 “`您的用户名.ythonanywhere .com`”，因此最好选择你自己喜欢的昵称，或者与你的博客相符的名称。 此外，请务必记住您的密码（如果你使用密码管理软件，就用它记录你的密码吧）。
+
+## 创建一个 PythonAnywhere 的 API 令牌
+
+您不需要每次都重复创建令牌，您只需要做一次就够了。当您注册了 PythonAnywhere 后，您将被带到仪表板页面。找到右上角的“帐户（Account）”页面的链接：
+
+![页面右上方的帐户（Account）链接](../deploy/images/pythonanywhere_account.png)
+
+然后点击 "API 令牌（API token）" 的标签，然后点击表示"创建新的 API 令牌（Create new API token）"按钮。
+
+![帐户页面上的“API 令牌（API token）”标签](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/zh-CN/django/README.md b/zh-CN/django/README.md
new file mode 100644
index 00000000000..b3be4150c30
--- /dev/null
+++ b/zh-CN/django/README.md
@@ -0,0 +1,27 @@
+# Django 是什么？
+
+Django是一个由python编写的，免费和开放的开源网站框架。 web框架是一套组件，能帮助你更快、更容易地开发web站点。
+
+当你开始构建一个网站时，你总需要一些相似的组件：处理用户认证（注册、登录、登出）的组件、管理网页及页面构成的组件、实现上传文件的组件等等。
+
+幸运的是，其他人很早就注意到web开发人员会面临一些共同的问题。所以他们联手创建了 web 框架 (Django 是其中一个) 来让你使用。
+
+框架可以在你新建一个网站的时候帮你减轻一些相同组件带来的工作量，就像需要造一台车子的时候已经帮你发明好了车轮。
+
+## 你为什么需要一个框架？
+
+要理解什么是Django， 我们需要仔细理解一下服务器是如何工作的。 服务器需要知道的第一件事就是你希望它帮助你发布网页。
+
+想象一个用来监控接收邮件（请求）的邮箱（端口）。 这就是网站服务器做的事情。 网站服务器读到这封信，然后以网页的形式发送回复。 但是当你想发送一些东西的时候，你必须要有一些内容。 而Django就是可以帮助您创建内容的工具。
+
+## 当有人向您的服务器请求一个网站，会发生什么呢？
+
+当一个请求到达网站服务器，它会被传递到Django，试图找到实际上什么是被请求的。 它首先会拿到一个网页的地址，然后试图去弄清该做什么。 这个部分是由Django的**urlresolver**完成的（urlsolver又叫url解析器。一个网站的地址被叫做URL，统一资源定位器，url解析器会分析这个url，所以*url解析器*是有意义的）。 它并不十分聪明，他接受一个模式列表，然后试图去匹配 URL。 Django检查所有存在的模式，如果有匹配上的，那么Django会将请求传递给相关的函数（这个函数被称作*view*）。
+
+想象一个邮递员拿着一封信。 她沿着街区走下去，检查每一个房号与信件地址是否对应。 如果匹配上了，她就把信投在那里。 这也是url解析器的工作方式！
+
+在*view*函数里做了很多有趣的事情：我们能在数据库中寻找到一些信息。 如果用户要求修改数据呢？ 就像一封信说, "请更改我的工作描述。 * view * 可以检查是否允许这样做, 然后更新您的作业说明并发送回消息: "完成!“ 然后, * view * 生成一个响应, Django 可以将其发送到用户的 web 浏览器。
+
+当然，上面的描述是有点简化的，但是你不需要去知道所有的技术的东西， 有一个大概的想法就足够了。
+
+所以不要太过深入细节，我们将会用Django创建一些简单的东西，并在学习的过程中学到所有重要的部分！
\ No newline at end of file
diff --git a/zh-CN/django_admin/README.md b/zh-CN/django_admin/README.md
new file mode 100644
index 00000000000..ad8fe918948
--- /dev/null
+++ b/zh-CN/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django admin 管理后台
+
+我们将使用 Django admin 添加，编辑和删除我们刚刚创建的帖子。
+
+让我们在代码编辑器中打开`blog/admin.py`文件，并将其内容替换为此：
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+如你所见，我们导入（包括）了前一章定义的Post模型。 为了让我们的模型在admin页面上可见，我们需要使用`admin.site.register(Post)`来注册模型.
+
+OK, 现在来看看我们的 Post 模型。 记得先在控制台输入`python manage.py runserver`启动服务器。 转到您的浏览器并输入地址http://127.0.1:8000/admin/。 你将看到一个登陆页面，像这样：
+
+![登录页面](images/login_page2.png)
+
+为了登陆，您需要创建一个*超级用户* ——一个在站点里拥有控制一切的权利的用户。 返回到命令行, 输入 `python manage.py createsuperuser`, 然后按回车键。
+
+> 记住，如果想在网页服务器运行时写入新命令，那就打开一个新的终端窗口并激活virtualenv。 我们在**启动Web服务器**部分的**Your first Django project!**章节中回顾了如何编写新的命令。
+
+{% filename %}Mac OS X 或 Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/zh-CN/django_forms/README.md b/zh-CN/django_forms/README.md
new file mode 100644
index 00000000000..ee0524029bf
--- /dev/null
+++ b/zh-CN/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django表单
+
+我们最后一件关于我们的网站的事情就是创建一个漂亮的方式来增加和编辑博客文章。 Django的`管理`是很酷，但是它很难去自定义，变得更漂亮。 With `forms` we will have absolute power over our interface – we can do almost anything we can imagine!
+
+Django表单的一个好处就是我们既可以从零开始自定义，也可以创建`ModelForm`，它将表单的结果保存到模型里。
+
+这正是我们想做的：我们将为我们自己的`Post`模型创建一个表单。
+
+就像所有Django的重要部分一样，表单有他们自己的文件`forms.py`.
+
+我们需要创建一个文件，把它的名字放在`blog`目录下。
+
+    blog
+       └── forms.py
+    
+
+好的，让我们在代码编辑器中打开它，然后输入以下代码：
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`, 正如你所猜想的，是我们表单的名字。 We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+下面，我们有`class Meta`，在这里我们告诉Django哪个模型会被用来创建这个表单（`model=Post`).
+
+最后，我们可以说哪些字段会在我们的表单里出现。 In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+就是这样！现在我们所有要做的就是在*视图*里使用表单，然后展现在在模板里。
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## 指向页面表单的链接
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new视图
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## 模板
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. 这个非常重要，因为他会让你的表单变得更安全！ If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## 保存表单
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## 表单验证表单验证
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## 编辑表单
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## 安全性
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## 还有一件事：部署时刻！
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* 然后，在一个 [PythonAnywhere 的 Bash 终端](https://www.pythonanywhere.com/consoles/)里运行：
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/zh-CN/django_installation/README.md b/zh-CN/django_installation/README.md
new file mode 100644
index 00000000000..cb895a7fb8d
--- /dev/null
+++ b/zh-CN/django_installation/README.md
@@ -0,0 +1,7 @@
+# Django安装
+
+> 注意 如果您使用的是 Chromebook, 请跳过本章, 并确保遵循 Chromebook 安装指令。
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/zh-CN/django_installation/instructions.md b/zh-CN/django_installation/instructions.md
new file mode 100644
index 00000000000..a81e2d8a8f2
--- /dev/null
+++ b/zh-CN/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> Part of this section is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Django-marcador 教程的版权归 Markus Zapke-Gründemann 所有。
+
+## 虚拟环境
+
+在安装 Django 之前，我们会让你安装一个非常实用的工具，它可以让你计算机上的编码环境保持整洁。 这个步骤可以跳过，但我们强烈建议你跟着做。 从最佳实践设置开始将会在未来为你省去无数的烦恼！
+
+所以，让我们创建一个 **虚拟环境** （也称为 *virtualenv*）。 虚拟环境会以项目为单位将你的 Python/Django 安装隔离开。 这意味着对一个网站的修改不会影响到你同时在开发的其他任何一个网站。 优雅吧？
+
+你需要做的就是找到您想创建 `虚拟环境`的一个目录 ；比如您的主目录。 On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+在本教程中我们将使用您的 home 目录下的一个新目录 `djangogirls` ：
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+我们将虚拟环境称为 `myvenv`。一般的命令格式是：
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. 你可以使用其他任何名字，但请坚持使用小写，并不要使用空格、重音符号或特殊字符。 It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` 是您 `虚拟环境` 的名字。 您可以使用其他任何名称，但请始终使用小写以及不要有空格。 It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **NOTE:** On some versions of Debian/Ubuntu you may receive the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> 为了解决这个问题，请使用 `virtualenv` 命令。
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## 使用虚拟环境
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+运行如下命令进入你的虚拟环境：
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+首先请使用前面安装的代码编辑器在 `djangogirls/`文件夹内建立一个`requirements.txt` 文档。 为此，您可以在代码编辑器中打开一个新文件，然后将其保存为`requirements.txt` 在`djangogirls/` 中。 您的目录将如下所示：
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). 请在新目录中创建一个新的virtualenv，然后删除旧的，并再次尝试上面的命令。 (因为virtualenv使用绝对路径，移动虚拟目录将无法工作。)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> 如果你在Ubuntu 12.04中调用pip时出现错误，请运行 `python -m pip install -U --force-reinstall pip` 来修复虚拟版中的pip安装
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/zh-CN/django_models/README.md b/zh-CN/django_models/README.md
new file mode 100644
index 00000000000..ab1d244ed96
--- /dev/null
+++ b/zh-CN/django_models/README.md
@@ -0,0 +1,201 @@
+# Django模型
+
+我们现在将要创建的是一个能存储我们博客所有文章的东西。为了达到这个目的，我们将要讲解一下一个被称为`objects（对象）`的东西.
+
+## 对象
+
+在编程中有一个概念叫做 `面向对象编程` 。 它的思想是，与其用无聊的一连串的程序指令方式写程序，不如为事物建立模型，然后定义他们之间的交互方法。
+
+那什么是对象呢？它是一个属性和操作的集合。它听起来很奇怪，但我们会给你一个例子。
+
+如果我们想塑造一只猫的模型，我们会创建一个名为`Cat`的对象，它含有一些属性例如：`color`(颜色), `age`(年龄), `mood`(心情， 比如 good [好] , bad [不好], sleepy [困] ; ))，还有`owner` (主人) (那是一个`Person` (人) 对象, ——或者, 假若这只猫是流浪猫，这个属性可以为空)。
+
+然后这个`Cat`会有一些行为: `purr`(咕噜咕噜叫), `scratch`(抓挠), 或者`feed` (被喂食) (在这其中我们会给这只猫一些 `CatFood` (猫粮)，这个`CatFood`可以是单独的一个包含比如 <0>taste</0> (口味)属性的对象).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+所以基本思想就是用包含属性的代码来描述真实的东西（称为 `对象属性`）和操作 （称为 `方法`).
+
+我们将如何为博客帖子建立模型呢？我们想要建立一个博客，对吗？
+
+我们需要回答一个问题：什么是一篇博客文章？它应该含有什么样的属性？
+
+嗯，我们的博客文章一定需要一些文本，包括内容与标题，对吗？ 另一个很合理的需求是知道是谁写了这篇文章 — — 所以我们需要一个作者。 最后，我们想要知道什么时候该文章创建并发布。
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+一篇博客文章需要做什么样的事情？应该有一些正确的 `方法` 来发布文章，对吗？
+
+因此我们需要一个`publish`的方法
+
+既然我们已经知道什么是我们想要实现的，让我们开始在Django里面为它建模！
+
+## Django模型
+
+知道什么是对象，我们可以为我们的博客文章创建一个 Django 模型。
+
+Django 里的模型(model)是一种特殊的对象(object) — — 它保存在 `数据库` 中。 数据库是数据的集合。 这是您存储有关用户、 您的博客文章等信息的地方。 我们将使用SQLite 数据库来存储我们的数据。 这是默认的 Django 数据库适配器 — — 对于我们现在的需求而言, 它是足够的。
+
+您可以将数据库中的模型看作是电子表格中的列 （字段） 和行 （数据）。
+
+### 创建应用程序
+
+为了让一切保持整洁，我们将我们的项目内部创建单独的应用程序。 如果一开始就让每一件东西井然有序，那就太好了。 为了创建一个应用程序，我们需要在命令行中执行以下命令 (从`manage.py` 文件所在的`djangogirls` 目录)：
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+你会注意到一个新的 `blog` 目录被创建，并且它包含了一些文件。现在, 我们的项目中的目录和文件应该看起来像这样：
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+创建应用程序之后，我们还需要告知 Django , 以让 Django 使用该应用程序。 我们在文件 `mysite/settings.py` 中做 "告知 Django" 这件事——请在你的代码编辑器中打开这个文件。 我们需要找到 `INSTALLED_APPS` , 并在它的条目中添加一条`'blog.apps.BlogConfig'` . 所以最终的文件应该如下所示：
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### 创建一个博客文章模型
+
+在 `blog/models.py` 文件中，我们定义所有的 `Models` 对象— — 这个文件是我们定义 "博客文章" 的地方。
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. 这是Python编程里面的一种常见的约定写法，有时我们也叫这个做"dunder"("double-underscore"的缩写)。
+
+这看起来太吓人了，对吧？不过不用担心，我们会解释这几行是什么意思！
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` 是一个特殊的关键字，表明我们在定义一个对象。
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` 表明Post是一个Django模型，所以Django知道它应该被保存在数据库中。
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### 在你的数据库中为模型创建数据表
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/zh-CN/django_orm/README.md b/zh-CN/django_orm/README.md
new file mode 100644
index 00000000000..e2598ccfc4d
--- /dev/null
+++ b/zh-CN/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM 和 QuerySets（查询集）
+
+在这一章中，你将学习 Django 如何连接到数据库，并将数据存储在里面。一探究竟吧！
+
+## QuerySet 是什么呢？
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+用例子来学习最容易的了。让我们试试这个，好吗？
+
+## Django shell
+
+打开你本地的终端(不是在Python解析器里面) 然后输入这个命令:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+效果应该像这样：
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### 所有对象
+
+首先让我们尝试显示所有我们的文章。你可以用下面的命令：
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### 创建对象
+
+这就是你如何在数据库创建一个新的Post对象的方法:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+让我们首先导入用户模型：
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+我们在数据库中有哪些用户？试试这个：
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+现在我们终于可以创建我们的文章了:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+哈哈！要检查是否有效吗？
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+就是这样，又一个文章在列表里面！
+
+### 添加更多文章
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### 筛选对象
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. 我们将使用 `filter`，而不是 `all` 在 `Post.objects.all()`。 In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. 现在我们的代码段如下所示：
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **注**在`title` 与 `contains` 之间有两个下划线字符 (`_`)。 Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+然后将它与我们 `publish` 的方法一起发布:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### 对象排序
+
+Queryset 还允许您排序结果集对象的列表。让我们试着让它们按 `created_date` 字段排序：
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+我们也可以在开头添加 `-` 来反向排序：
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+这真是强而有力，而且可以让你写较复杂的的查询
+
+酷 ！现在，你准备下一个部分 ！若要关闭shell程序，请键入这：
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/zh-CN/django_start_project/README.md b/zh-CN/django_start_project/README.md
new file mode 100644
index 00000000000..4080f2cf211
--- /dev/null
+++ b/zh-CN/django_start_project/README.md
@@ -0,0 +1,260 @@
+# 你的第一个Django 项目 ！
+
+> 本章的部分内容基于 Geek Girls Carrots (https://github.com/ggcarrots/django-carrots/) 的教程。
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Django-marcador 教程的版权归 Markus Zapke-Gründemann 所有。
+
+我们将创建一个小博客！
+
+第一步是创建一个新的 Django 项目。 首先，我们需要运行一些由 Django 提供的脚本，为我们即将开始的项目建立主要骨架。 它会生成一系列的文件夹和文件，在后面的项目中我们会需要修改和使用到它们。
+
+某些名称的文件和目录在 Django 起着至关重要的作用。 你不应该重命名我们将要创建的文件。 将它们移动到一个不同的地方也不是一个好主意。 Django 需要固定的系统结构，以便 Django 能够找到重要的东西。
+
+> 记住在虚拟环境中运行的一切。 如果您没有在控制台中看到前缀 `（myvenv）`，您需要先激活您的虚拟环境。 我们在 **Django 安装**这一节内的 **在虚拟环境下工作** 部分中解释过该怎么做了。 Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+在苹果 OS X 或 Linux 系统下，你需要运行下面的命令,**记得不要漏掉命令后面的小点（.）**: (myvenv) ~/djangogirls$ django-admin startproject mysite .
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> 此时，符号"`.`"很重要，它将告诉脚本程序自动安装Django到你当前选择的目录中（所以这个“`.`”是告诉脚本执行时的一种参考点).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> 此时，符号"`.`"很重要，它将告诉脚本程序自动安装Django到你当前选择的目录中（所以这个“`.`”是告诉脚本执行时的一种参考点).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py`是一个脚本，将自动为您创建目录和文件。前面的命令正确的话，你现在就应该有一个目录结构，看起来像下面这样：
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **注意**：在目录结构中，您也会看到我们以前创建的`venv`文件夹。
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+`settings.py` 文件包含的您的网站的配置数据。
+
+还记得当我们谈到一名邮差在决定何处交付一封信时的例子吗？`urls.py` 文件包含`urlresolver`所需的模型的列表.
+
+现在让我们忽略其他文件, 现在我们不会改变它们。要记住的唯一一点是不要不小心删除他们！
+
+## 更改设置
+
+让我们在 `mysite/settings.py` 中进行一些更改。使用您前面安装了的代码编辑器打开文件。
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+在我们的站点上有正确的时间是非常不错的。 Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+有很多的不同的数据库软件，可以用来存储你的网站数据。我们将使用默认的那个， `sqlite3`.
+
+这已经在您的 `mysite/settings.py` 文件中设置了：
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+若要为我们的博客创建一个数据库，，让我们运行以下命令在控制台中： `python manage.py migrate` （我们需要`djangogirls` 目录中包含 `manage.py` 文件）。 如果一切顺利，您应该看到这样：
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+我们完成了 ！现在去启动网站服务器，看看是否我们的网站正在工作！
+
+## Starting the web server
+
+你必须要进入包含`manage.py` 文件的目录 （`djangogirls` 目录）。 在控制台中，我们可以通过运行 `python manage.py runserver` 开启 web 服务器：
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/zh-CN/django_templates/README.md b/zh-CN/django_templates/README.md
new file mode 100644
index 00000000000..e6c339709b9
--- /dev/null
+++ b/zh-CN/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django模板
+
+是时候把数据展示出来了！Django提供了一个非常有用的内置来实现\----**模板标签**
+
+## 什么是模板标签呢？
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## 展现文章列表模板
+
+在之前的章节，我们给我们的模板一系列文章在`post`变量里。现在我们将在HTML里展现它。
+
+为了用模板标签在HTML中显示变量， 我们会使用两个大括号， 并将变量包含在里面，正如这样
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+在你的 `blog/templates/blog/post_list.html` 文件中进行如下的操作。 Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. 并保存文件，刷新页面后去看看我们做的那些改变。
+
+![图 13.1](images/step1.png)
+
+如你所见，我们得到如下：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+这意味着Django视它为对象的列表。 还记得在 **Python入门介绍** 里我们怎么展现列表的吗？ 是的， 我们可以使用循环！ 在dajngo模板中使用循环去遍历它们。如下所示：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+在你的模板里试试这个。
+
+![图 13.2](images/step2.png)
+
+它工作了！ But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. 你可以混合HTML和模板标签。 我们的`body`将长得像这样：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}所有的在`{% for %}` 和 `{% endfor %}` 之间的内容将会被Django对象列表中的每个对象所代替。刷新页面去看看：{% endraw %}
+
+![图 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? 我们正在访问定义在`Post`模型中的每一个域。 Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## 还有一件事
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* 然后，重新登陆 [PythonAnywhere](https://www.pythonanywhere.com/consoles/) 并进入**Bash 控制台** (或重开一个)，并运行:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/zh-CN/django_urls/README.md b/zh-CN/django_urls/README.md
new file mode 100644
index 00000000000..70773b7ce85
--- /dev/null
+++ b/zh-CN/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django 的 URL！
+
+我们下面要来建立自己的第一个网页：你的博客主页！但是首先，我们要来了解一下Django的URL。
+
+## 什么是 URL？
+
+URL是一个网页地址。 每次你登录一个网页时，你都可以在浏览器地址栏上看到一个URL。 (对！ `127.0.0.1:8000` 是一个URL！ 同时 `https://djangogirls.org` 也是一个 URL。)
+
+![URL](images/url.png)
+
+每一个互联网的网页都需要自己的 URL。 这样当用户打开一个 URL 时，你的应用程序才知道应该展现什么内容。 在 Django 中，我们使用一种叫做 `URLconf` (URL 配置) 的机制 。 URLconf 是一套模式，Django 会用它来把用户请求的 URL 匹配成相对应的界面。
+
+## URL 在 Django 中如何工作？
+
+选一个编辑器打开 `mysite/urls.py` 就能看到它长什么样子了：
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+正如你所看到的，Django 已经为我们在里面放了一些东西。
+
+三重引号之间的语句 (` '''` 或 `''''''`) 称为文档字符串--你可以在文件、分类或算法的最上面写这些来描述它的作用。 Python不会运行它们。
+
+你在上一章节中学到的 admin URL 已经放在里面了：
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+这一行表示对于每一个以 `admin/` 开头的 URL，Django 都会找到一个相对应的 *界面*。 在这些代码中，我们写入了许多 admin URL ，所以这些 URL 不需要全被打包进这个小文件中。这使得代码更具可读性和简洁性。
+
+## 你的第一个 Django URL！
+
+是时候创建第一个 URL 了！我们想用 'http://127.0.0.1:8000/' 作为博客的首页，并展示一个帖子列表。
+
+我们也想保持 `mysite/urls.py` 文件整洁一些，所以我们要从 `博客` 应用把URL导出到主文件`mysite/urls.py`。
+
+下面继续, 添加一行代码来导入 `blog.urls` 。 你还需要更改 `from django.urls…`中的代码。因为我们现在要使用 `include`函数，所以你需要添加一行代码来导入。
+
+你的 `mysite/urls.py` 文件现在应该看起来像这样：
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+现在，Django 会把访问 'http://127.0.0.1:8000/' 的请求转到 `blog.urls`，并看看有没有进一步的指示。
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/zh-CN/django_views/README.md b/zh-CN/django_views/README.md
new file mode 100644
index 00000000000..d0828161017
--- /dev/null
+++ b/zh-CN/django_views/README.md
@@ -0,0 +1,44 @@
+# Django 视野-快来创造吧！
+
+是时候去解决我们在上一章所制造的Bug了! :)
+
+*view*是存放应用逻辑的地方。 它将从你之前创建的 `模型`中获取数据，并将它传递给 `模板`。 我们将在下一章创建 template 模板。 Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+视图都被置放在`views.py`文件中。我们将加入我们自己的*views*到`blog/views.py`文件。
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+保存文件，转到 http://127.0.0.1:8000/ 然后看看我们现在得到什么了。
+
+另一个错误！读读现在发生了什么：
+
+![错误](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/zh-CN/dynamic_data_in_templates/README.md b/zh-CN/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..db89e755f47
--- /dev/null
+++ b/zh-CN/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# 模板中的动态数据
+
+我们已有的几件： `Post` 模型定义在 `models.py` 中，我们有 `post_list` `views.py` 和添加的模板中。 但实际上我们如何使我们的帖子出现在我们的 HTML 模板上呢？ Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+这就是 *views* 应该做的： 连接模型和模板。 In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+还记得当我们谈论过导入在不同文件中编写的代码吗？ Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). 然后我们导入模型（`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## QuerySet 查询集
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+请注意我们为这里的 QuerySet查询集创建了一个 *变量*： `posts`。将此视为我们的 QuerySet 的名字。从现在开始我们可以通过这个名字引用它。
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. 我们需要给它们起名字 （我们暂且沿用 `'posts'`). :) 它应该看起来像这样： `{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+所以最后我们的 `blog/views.py` 文件应如下所示：
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+就是它 ！现在回到我们的模板并显示此QuerySet查询集！
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/zh-CN/extend_your_application/README.md b/zh-CN/extend_your_application/README.md
new file mode 100644
index 00000000000..fb45e37ad1b
--- /dev/null
+++ b/zh-CN/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# 扩展您的应用
+
+我们已经完成了所有创建网站的各项不同必须的步骤：我们知道如何写一个模型，url，视图和模板。我们同样知道如何让我们网站更漂亮。
+
+现在来练习吧！
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## 创建一个模板链接，跳转到博文的内容页
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## 创建文章详细页面的URL
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## 增加文章详细页面的视图
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/zh-CN/how_the_internet_works/README.md b/zh-CN/how_the_internet_works/README.md
new file mode 100644
index 00000000000..f983925afd3
--- /dev/null
+++ b/zh-CN/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# 互联网是如何工作的？
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. Web浏览器懂得这些代码，遵循它的指令并如你所想的那样展示这些文件。
+
+就像我们对待每个电脑文件一样，我们需要把HTML文件存储在硬盘的某个位置。 对于互联网，我们使用特定而功能强大的电脑，我们称之为*服务器*。 它们没有屏幕、鼠标或者键盘，因为它们的主要目的是存储数据，并用它来提供服务。 That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+我们给你画了一幅画！它看起来像这样：
+
+![图1.1](images/internet_1.png)
+
+看起来很糟糕，对吗？ In fact it is a network of connected machines (the above-mentioned *servers*). 数以十万计的机器！ 很多，很多数以公里长的电缆分布在全世界！ 你能访问一个海底电缆地图网站（http://submarinecablemap.com/）来看这个网络有多么复杂。 这是一个网站上的截屏：
+
+![图1.2](images/internet_3.png)
+
+它很迷人，对吧？ But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+它看起来像这样：
+
+![图1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+你的信件去了离你最近的邮局。 然后它去离你的收件人稍近一点的邮局，然后再去另一个，以此类推地到达它的目的地。 唯一的事情是，如果你将许多信件 (*数据包*) 发送到同一个地方，他们可以通过完全不同邮政局 (*路由器*)。 这取决于每个办公室的分布情况。
+
+![图1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+我们使用的地址叫做IP地址，这种地址却不包含街道、城市、邮编和城市。 你的电脑首先要求DNS（域名服务器）去解析djangogirls.org成为IP地址。 It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. 你使用一种接收者同样能够理解的语言，对吗？ 你送到网站的*数据包*也类似如此。 我们使用一个名为 HTTP (Hypertext Transfer Protocol：超文本传输协议) 的协议。
+
+所以，基本上，当你有一个网站你需要有一台*服务器*用于网站的托管。 当*服务器*接收到一个访问*请求*（一封信），它把网站内容发送回去（回信）。
+
+Since this is a Django tutorial, you might ask what Django does. 当你发送一个响应时，你通常不会发送同样的东西给每一个人。 如果你信件的内容是个性化的必然更好，尤其是对于那个刚刚给你写信的人，对吗？ Django帮助你创建这些个性化，有趣的信件. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/zh-CN/html/README.md b/zh-CN/html/README.md
new file mode 100644
index 00000000000..71d85a3770a
--- /dev/null
+++ b/zh-CN/html/README.md
@@ -0,0 +1,227 @@
+# HTML简介
+
+什么是模板，你可能会问？
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## HTML 是什么？
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML代表“HyperText Markup Language（超文本标记语言）”。 **超文本** 是指它是一种支持网页之间的超链接的文本。 **标记** 是指我们将一份文件用代码标记组织起来，然后告诉某个东西（在这种情况下，浏览器中） 如何解释网页。 HTML 代码是由 **标记**构成的，每一个都是由 `<` 开始，由结束 `>`. 这些标签表示标记 **元素**.
+
+## 你的第一个模板 ！
+
+创建一个模板是指创建一个模板文件。一切都是文件，对吧？你可能已经注意到这点了。
+
+模板保存在 `blog/templates/blog` 目录中。 因此，首先在您的 blog 目录内创建一个称为 `templates` 的目录。 然后创建另一个称为 `blog` 的目录到你的 templates 目录：
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+现在创建一个叫做 `post_list.html` 的文件 （现在是空的，别管它）到 `blog/templates/blog` 目录下。
+
+看看你的网站现在是什么样子： http://127.0.0.1:8000/ /
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![图 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![图 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+每个 HTML 页面也分为两个元素： **head** 和 **body**.
+
+* **head** 是一个包含有关文档且未显示在屏幕上的信息元素。
+
+* **body** 是包含 web 页中所有显示的元素。
+
+我们使用 `<head>` 告诉浏览器这个页面的配置，以及 `<body>` 来告诉它什么实际上是在页面上。
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+保存该文件并刷新您的网页。
+
+![图 11.3](images/step4.png)
+
+注意浏览器怎么理解"Ola's blog"是你的网页的标题的呢？ 它解释了 `<title> Ola's blog </title>` 并将其放置到您的浏览器 （它也用于书签，等等） 的标题栏中。
+
+可能你也注意到每个开始标记匹配的 *结束标记*，用 `/`） 和元素是 *嵌套* （即只有您不能关闭特定标记，直到在里面的所有标记都关闭了）。
+
+这就像把东西放进盒子里。 你有一个大箱子里，`<html></html>` ；在它里面还有 `<body></body>`，并包含更小盒： `<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## 自定义您的模板
+
+现在，你可以找点乐子，尝试自定义您的模板 ！为此这里有几个有用的标签：
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` 为下一层级的标题！
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` 强调您的文本
+* `<strong>text</strong>` 强烈强调您的文本
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` 创建一个链接
+* `<ul><li>first item</li><li>second item</li></ul>` 产生一个列表，就像这样！
+* `<div></div>` 定义页面上的一个段
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+它给了我们这种效果：
+
+![图 11.4](images/step6.png)
+
+耶！ But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## 还有一件事：部署！
+
+我们把这些成果放到网上一定很棒，对吧？让我们再来一次 PythonAnywhere 部署：
+
+### Commit, and push your code up to GitHub
+
+首先，让我们看看上次部署之后什么文件改变了（运行这些本地命令，不是在 PythonAnywhere 上）：
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+在我们上传的所有文件之前，让我们检查`git` 将上传什么（所有`git` 将上传的文件现在应以绿色显示）：
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+我们已经差不多完成了，现在是时候告诉它要在它的历史记录中保存此更改。 我们将要给它附上一条"提交消息"用来描述我们做了什么改动。 您可以在这个阶段键入任何您想要的东西，但写一些描述性的东西更有用，因为它能在将来使你记起你做了什么。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### Pull 把你的新代码拉到 PythonAnywhere，然后重新加载你的 web 应用程序
+
+* 打开 [PythonAnywhere consoles page](https://www.pythonanywhere.com/consoles/) 并转到你的 **Bash console**（或启动一个新的）。然后，运行：
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/zh-CN/install_git.md b/zh-CN/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/zh-CN/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/zh-CN/installation/README.md b/zh-CN/installation/README.md
new file mode 100644
index 00000000000..51a17e53193
--- /dev/null
+++ b/zh-CN/installation/README.md
@@ -0,0 +1,68 @@
+# 如果你在家做这个练习
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# If you're attending a workshop
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# Installation
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# Install Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# Install a code editor {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# Set up virtualenv and install Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# Install Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# Start reading
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/zh-CN/instructions.md b/zh-CN/instructions.md
new file mode 100644
index 00000000000..30bd493b11b
--- /dev/null
+++ b/zh-CN/instructions.md
@@ -0,0 +1,106 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install Python 3.6, so if you have any earlier version, you will need to upgrade it.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, by pressing the Windows key + Pause/Break key which will open your System info, and look at the "System type" line. You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation you will notice a window marked "Setup". Make sure you tick the "Add Python 3.6 to PATH" checkbox and click on "Install Now", as shown here:
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+In upcoming steps, you'll be using the Windows Command Line (which we'll also tell you about). For now, if you need to type in some commands, go to Start menu → Windows System → Command Prompt. You can also hold in the Windows key and press the "R"-key until the "Run" window pops up. To open the Command Line, type "cmd" and press enter in the "Run" window. (On newer versions of Windows, you might have to search for "Command Prompt" since it's sometimes hidden.)
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Note: if you are using an older version of Windows (7, Vista, or any older version) and the Python 3.6.x installer fails with an error, you can try either:
+
+1. install all Windows Updates and try to install Python 3.6 again; or
+2. install an [older version of Python](https://www.python.org/downloads/windows/), e.g., [3.4.6](https://www.python.org/downloads/release/python-346/).
+
+If you install an older version of Python, the installation screen may look a bit different than shown above. Make sure you scroll down to see "Add python.exe to Path", then click the button on the left and pick "Will be installed on local hard drive":
+
+![Add Python to the Path, older versions](../python_installation/images/add_python_to_windows_path.png)
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/release/python-361/ and download the Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-3.6.1-macosx10.6.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+If you have a different 'micro version' of Python installed, e.g. 3.6.0, then you don't have to upgrade. If you don't have Python installed, or if you want a different version, you can install it as follows:
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt-get install python3.6
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command dnf is not found. In that case you need to use yum instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python 3.6.1
+    
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python 3.6.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/zh-CN/intro_to_command_line/README.md b/zh-CN/intro_to_command_line/README.md
new file mode 100644
index 00000000000..084b373e86c
--- /dev/null
+++ b/zh-CN/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# 命令行界面简介
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**让我们把你介绍给你的第一个新朋友： 命令行 ！**
+
+以下步骤将显示你如何使用所有的黑客都使用的黑色窗口。它可能刚开始看上去有点吓人，但事实上它只是等待你的命令提示符。
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## 什么是命令行？
+
+这个窗口通常被称为 **命令行** 或 **命令行界面**，是一个基于文本的用来查看、 处理、 和操作您的计算机上的文件的应用程序。 It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. 命令行的其他名字是： *cmd*，*CLI*、 *提示符*、 *控制台* 或 *终端*.
+
+## 打开命令行界面
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## 提示符
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## 你的第一个命令 （耶 ！）
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## 基础知识
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### 当前目录: 
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### 解决方法
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## 摘要
+
+Here is a summary of some useful commands:
+
+| 命令 (Windows)   | 命令 （Mac OS / Linux） | 说明：                        | 示例：                                                |
+| -------------- | ------------------- | -------------------------- | -------------------------------------------------- |
+| exit           | exit                | 关闭窗口                       | **exit**                                           |
+| cd             | cd                  | 更改目录                       | **cd test**                                        |
+| cd             | pwd                 | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir            | ls                  | 列出的目录文件                    | **dir**                                            |
+| copy           | cp                  | 复制文件                       | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move           | mv                  | 移动文件                       | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir          | mkdir               | 创建一个新目录                    | **mkdir testdirectory**                            |
+| rmdir (or del) | rm                  | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S       | rm -r               | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?       | man [CMD]           | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## 准备好了吗？
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/zh-CN/intro_to_command_line/open_instructions.md b/zh-CN/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/zh-CN/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/zh-CN/python_installation/README.md b/zh-CN/python_installation/README.md
new file mode 100644
index 00000000000..39dd7b30479
--- /dev/null
+++ b/zh-CN/python_installation/README.md
@@ -0,0 +1,15 @@
+# 让我们从学习Python开始
+
+我们终于要开始了！
+
+但首先，让我们告诉你什么是 Python。Python 是一种非常流行的编程语言，可以用来创建网站、 游戏、 科学软件、 图形和很多很多其他的东西。
+
+Python 起源于 1980 年代后期，该语言的重要目标是源代码的人类可读性 (而不是机器!)。 This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python的安装
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/zh-CN/python_installation/instructions.md b/zh-CN/python_installation/instructions.md
new file mode 100644
index 00000000000..13a4a7021c4
--- /dev/null
+++ b/zh-CN/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> 写给家中的读者：本章被包含于[Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) 视频中。
+> 
+> 本节基于由Geek Girls Carrots (https://github.com/ggcarrots/django-carrots) 所制作的教程。
+
+Django由Python编写。 我们需要Python来完成Django中的一切。 让我们从安装开始 ！ 我们希望您能安装最新版本的 Python 3，所以如果您有任何旧版本，请将其更新。 If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+即使您已经在计算机上安装过Anaconda，也请安装以下的普通Python。
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+首先，请在系统信息页的”系统类型“中检查您的计算机拥有的是32位系统还是64位系统的Windows。您可以使用以下任意一种方式来进入这个页面：
+
+* 同时按Windows键和暂停/关闭键
+* 从Windows菜单打开您的控制面板，进入”系统&安全“，再进入”系统“。
+* 按下Windows按钮，然后寻找设置 > 系统 > 关于
+* 在Windows开始菜单搜索”系统信息“。 完成这点，需要按启动按钮或Windows键，然后输入`系统信息`。 It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/zh-CN/python_introduction/README.md b/zh-CN/python_introduction/README.md
new file mode 100644
index 00000000000..663b4cf0424
--- /dev/null
+++ b/zh-CN/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Python 简介
+
+> 本章的部分内容基于 Geek Girls Carrots (https://github.com/ggcarrots/django-carrots/) 的教程。
+
+让我们开始写代码吧！
+
+## Python 提示符
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## 第一条 Python 命令 ！
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## 字符串
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### 摘要
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## 错误
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- `str` 函数将对象转换成**字符串**
+- `int` 函数将对象转换为**整数**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## 变量
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## 打印功能
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## 列表
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## 字典
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- 键 `name` 指向 `'Ola'` (一个`字符串` 对象),
+- `country` 指向`'Poland'` (另一个 `字符串`),
+- 和`favorite_numbers` 指向`[7, 42, 92]` (一个有三个数字的 `列表` ).
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- 你需要一个有序的元素排列吗？使用列表。
+- 你需要将键值相关联，这样你可以在后面更有效的查找他们？使用字典。
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### 摘要
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## 比较事物
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y 表示: x 大于 y
+- x `<` y 表示：x 小于 y
+- x `< =` y 表示： x 小于或等于 y
+- x `>=` y 表示：x 大于或等于 y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## 布尔逻辑
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# 保存它！
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- 退出 Python 解释器
+- 打开我们选择的代码编辑器
+- 将一些代码保存到一个新的 python 文件
+- 运行它！
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. 这就所谓的"语法高亮"，在编写代码时是非常有用的功能。 The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). 这是我们使用代码编辑器的原因之一. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### 如果条件不为真呢？
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### 摘要
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## 你自己的函数！
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## 循环
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## 摘要
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/zh-CN/signup_pythonanywhere.md b/zh-CN/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/zh-CN/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/zh-CN/template_extending/README.md b/zh-CN/template_extending/README.md
new file mode 100644
index 00000000000..67dc4c741a8
--- /dev/null
+++ b/zh-CN/template_extending/README.md
@@ -0,0 +1,151 @@
+# 模板扩展
+
+另一个有趣的事情Django已经为你做好了就是**模板扩展**。这是什么意思呢？它意味着你可以使用你的HTML相同代码为你网站不同的网页共享。
+
+模板帮助你，当你想使用相同的信息或者展示在多余一个地方的时候。 你不需要重复在每个文件中 并且如果你想改变内容，你不需要在每个木板中修改，只需要一次
+
+## 创建一个基本模板
+
+一个基础模板是最重要的模板，你扩展到你网站的每一页。
+
+让我们创建一个`base.html`文件到`blog/templates/blog/`:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+然后在`base.html`中，替换你所有的 `<body>`(所有的在`<body>` 和 `</body>`之间的内容)像这样：
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? 你刚才创建了`block<0>  你使用template 标记<code>{% block %}` 来标记一个区域，这个区域是html格式 这个HTML将要从别的模板中扩展过来 (`base.html`). 我们一会儿将给你展示这个如何使用。
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}你需要一掉任何在 `{% for post in posts %}`之下和 `{% endfor %}`之上的内容. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+我们需要使用这个在你的模板中在所有的conent模块。 现在需要添加block 标记在文件中
+
+{% raw %}你希望你的block标记和你的 `base.html` 文件中的标记匹配. 你也希望include这个代码在你的内容block中。 为了做这个，把你需要的内容写入`{% block content %}` 和`{% endblock %}`中。 像这样:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+只留下一件事了，我们需要将这两个模板连接在一起。这就是扩展模板的全部内容！我们将通过在文件开头增加 extends 标记来实现此目的，就像这样：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+就是这样了！保存文件，检查你的网站是否仍在正常运行。:）
+
+> 如果你得到error `TemplateDoesNotExist`, 这个意味着这里没有`blog/base.html`文件，你需要运行`runserver` 在终端中。 Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/zh-CN/whats_next/README.md b/zh-CN/whats_next/README.md
new file mode 100644
index 00000000000..5eb19e0d800
--- /dev/null
+++ b/zh-CN/whats_next/README.md
@@ -0,0 +1,43 @@
+# 接下来呢？
+
+祝贺你！**你简直太棒了**。我们很自豪! <3
+
+### 现在要做什么？
+
+休息一下! 你刚刚做了一件大事。
+
+在 [Facebook](http://facebook.com/djangogirls) 或 [Twitter](https://twitter.com/djangogirls) 上关注 Django Girls来获取最新消息。
+
+### 你能推荐更进一步的资源吗？
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file
diff --git a/zh-TW/GLOSSARY.md b/zh-TW/GLOSSARY.md
new file mode 100644
index 00000000000..e87fb65ac21
--- /dev/null
+++ b/zh-TW/GLOSSARY.md
@@ -0,0 +1,3 @@
+# 程式編輯器 (Code editor)
+
+程式碼編輯器是一種應用程式，它允許你儲存你的程式碼，這樣你可以稍後再使用它。 你可以在 [程式編輯器 (Code editor) 章節](./code_editor/README.md) 知道從那裡下載一個。
\ No newline at end of file
diff --git a/zh-TW/README.md b/zh-TW/README.md
new file mode 100644
index 00000000000..0a948efd0b9
--- /dev/null
+++ b/zh-TW/README.md
@@ -0,0 +1,51 @@
+# Django Girls 教材
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/
+
+## 歡迎
+
+歡迎來到Django Girls的教學指引 We are happy to see you here. :) In this tutorial, we will take you on a journey under the hood of web technologies, offering you a glimpse of all the bits and pieces that need to come together to make the web work as we know it.
+
+As with all unknown things, this is going to be an adventure - but no worries, since you already worked up the courage to be here, you'll be just fine. :)
+
+## 簡介
+
+這世界與科技的關聯性越來越高，你有沒有曾經感到無法(或只是尚未)跟上時代？ 你有沒有想過如何建立一個網站，但從來沒有足夠的動力開始嗎？ 你有沒有想過軟體世界太複雜以致於你沒有自己嘗試做些東西？
+
+那麼，我們有好消息給你！程式設計並不是看起來那麼困難，而且我們想要告訴你它可以多麼有趣。
+
+這份教學指引沒有辦法奇蹟般的讓你變成一個工程師。 如果你想要擅長它，你需要幾個月甚至幾年的學習和練習。 但我們想要讓你知道程式設計或建立網站並不是看起來的那麼複雜。 我們將盡可能試著解釋不同細節，所以你將不會覺得被技術嚇倒。
+
+我們希望我們能使你像我們一樣熱愛科技 ！
+
+## 在這教材中你將會學到什麼？
+
+Once you've finished the tutorial, you will have a small working web application: your own blog. We will show you how to put it online, so others will see your work!
+
+它將（大致）會像這樣︰
+
+![圖 0.1](images/application.png)
+
+> If you work with the tutorial on your own and don't have a coach who will help you in case of any problem, we have a chat system for you: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). 我們要求我們的教練和以前的出席者不時到那裡，和幫助其他人使用這教材！ 在那裡不要害怕提出問題！
+
+OK, [let's start at the beginning…](./how_the_internet_works/README.md)
+
+## Following the tutorial at home
+
+It is amazing to take part in a Django Girls workshop, but we are aware that it is not always possible to attend one. This is why we encourage you to try following this tutorial at home. For readers at home, we are currently preparing videos that will make it easier to follow the tutorial on your own. It is still a work in progress, but more and more things will be covered soon at the [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube channel.
+
+In every chapter already covered, there is a link that points to the correct video.
+
+## 關於教材和投稿
+
+這教材是由 [DjangoGirls](https://djangogirls.org/) 維護。 如果你發現任何錯誤，或想要更新本教材，請[遵循投稿準則](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## 你想幫我們翻譯這教材至其他語言嗎？
+
+Currently, translations are being kept on crowdin.com platform at:
+
+https://crowdin.com/project/django-girls-tutorial
+
+If your language is not listed on [crowdin](https://crowdin.com/), please [open a new issue](https://github.com/DjangoGirls/tutorial/issues/new) informing us of the language so we can add it.
\ No newline at end of file
diff --git a/zh-TW/SUMMARY.md b/zh-TW/SUMMARY.md
new file mode 100644
index 00000000000..5b83d2bc025
--- /dev/null
+++ b/zh-TW/SUMMARY.md
@@ -0,0 +1,35 @@
+# 摘要
+
+* [簡介](README.md)
+* [安裝](installation/README.md) 
+  * [命令行(Command Line)](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-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
+* [安裝步驟 (Chromebook)](chromebook_setup/README.md)
+* [網際網路是如何運作的](how_the_internet_works/README.md)
+* [命令列簡介](intro_to_command_line/README.md)
+* [Python 安裝](python_installation/README.md)
+* [程式編輯器 (Code editor)](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)](django_models/README.md)
+* [Django 管理員 (Django admin)](django_admin/README.md)
+* [部署！ (Deploy!)](deploy/README.md)
+* [Django URLs](django_urls/README.md)
+* [Django views – time to create!](django_views/README.md)
+* [HTML 簡介](html/README.md)
+* [Django ORM （查詢集）](django_orm/README.md)
+* [在範本中的動態資料 (Dynamic data in templates)](dynamic_data_in_templates/README.md)
+* [Django 範本 (templates)](django_templates/README.md)
+* [CSS - 讓它變漂亮！](css/README.md)
+* [範本擴展 (Template extending)](template_extending/README.md)
+* [擴展你的應用程式 (Extend your application)](extend_your_application/README.md)
+* [Django 表單 (Forms)](django_forms/README.md)
+* [下一步是什麼?](whats_next/README.md)
\ No newline at end of file
diff --git a/zh-TW/chromebook_setup/README.md b/zh-TW/chromebook_setup/README.md
new file mode 100644
index 00000000000..c6794f2bc3a
--- /dev/null
+++ b/zh-TW/chromebook_setup/README.md
@@ -0,0 +1,5 @@
+# Chromebook 設定
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}
\ No newline at end of file
diff --git a/zh-TW/chromebook_setup/instructions.md b/zh-TW/chromebook_setup/instructions.md
new file mode 100644
index 00000000000..515ea978904
--- /dev/null
+++ b/zh-TW/chromebook_setup/instructions.md
@@ -0,0 +1,158 @@
+如果您不是使用 Chromebook 的話，您可以 [跳過這個章節](http://tutorial.djangogirls.org/en/installation/#install-python)。 如果是的話，您的安裝過程將會有些許的不同。 您可以忽略其餘的安裝說明。
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
+
+Cloud 9 這工具會提供一個程式碼編輯器(code editor)，並讓你存取一台位於網路上的電腦，使你可以透過它安裝、撰寫、以及執行軟體。 在這個教程指南中，Cloud 9 將能當作您的*本機電腦*來執行。 您仍將在終端機介面中執行指令，跟同學使用在 OS X、Ubuntu、或是 Windows 一樣，但是您的終端機是連接到一個由 Cloud 9 為您設定在其他地方的主機。 Here are the instructions for cloud IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). 您可以選擇其中一個cloud IDE，然後跟從它的指示操作。
+
+#### PaizaCloud Cloud IDE
+
+1. 到[PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. 建立帳戶
+3. 點擊*新伺服器*及選擇Django應用程式
+4. 點擊「終端機」按鈕（在視窗的左側）
+
+現在你應該可以看到一個有左方有sidebar和按鈕的介面。點選“Terminal“按鈕，開啟這樣的命令提示視窗：
+
+{% filename %}終端機{% endfilename %}
+
+    $
+    
+
+The terminal on the PaizaCloud Cloud IDE is prepared for your instructions. You can resize or maximize that window to make it a bit bigger.
+
+#### AWS Cloud9
+
+目前，Cloud 9 要求您使用 AWS 帳號註冊並輸入信用卡資料。
+
+1. 從 [Chrome 線上應用程式商店](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)安裝 Colud 9
+2. 到[c9.io](https://c9.io)點擊及瀏覽*開始使用 AWS Cloud9*
+3. 註冊一個 AWS 帳號（需要信用卡資料，但您可以免費使用）
+4. 在 AWS 儀表板上，搜尋 *Cloud 9* 並按下。
+5. 在 Cloud 9 儀表板上，按下*建立環境*
+6. 將它命名為 *django-girls*
+7. While configuring settings, select *Create a new instance for environment (EC2)* for "Environment Type" and the *t2.micro* "Instance type" (it should say "Free-tier eligible."). The default cost-saving setting is fine and you can keep the other defaults.
+8. 點擊 *下一步*
+9. 點擊 *建立環境*
+
+Now you should see an interface with a sidebar, a big main window with some text, and a small window at the bottom that looks something like this:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+    
+
+This bottom area is your terminal. You can use the terminal to send instructions to the remote Cloud 9 computer. You can resize that window to make it a bit bigger.
+
+#### Glitch.com Cloud IDE
+
+1. Go to [Glitch.com](https://glitch.com/)
+2. Sign up for an account (https://glitch.com/signup) or use your GitHub account if you have one. (See GitHub instructions below.)
+3. Click *New Project* and choose *hello-webpage*
+4. Click on the Tools dropdown list (at the bottom left side of the window), then on Terminal button to open terminal tab with a prompt like this:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-of-your-glitch-project:~
+    
+
+When using Glitch.com as your Cloud IDE, you don't have to create a virtual environment. Instead, create the following files manually:
+
+{% 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
+```
+
+Once these files are created, go to the Terminal and execute the following commands to create your first Django project:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+In order to see detailed error messages, you can activate Django debug logs for your Glitch application. Simply add the following at the end of the `mysite/settings.py` file.
+
+{% 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,
+        },
+    },
+}
+```
+
+This will create a `debug.log` file detailing Django operations and any error messages that might come up, making it much easier to fix if your website does not work.
+
+The initial restarting of the Glitch project should fail. (If you click on the top dropdown button `Show` then click on `In a New Window`, you will receive a `DisallowedHost` error message.) Do not worry about it at this stage, the tutorial will fix this as soon as you update the Django settings of your project in the `mysite/settings.py` file.
+
+### 虛擬環境 [Virtual Environment]
+
+A virtual environment (also called a virtualenv) is like a private box we can stuff useful computer code into for a project we're working on. We use them to keep the various bits of code we want for our various projects separate so things don't get mixed up between projects.
+
+Run:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3 -m venv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+    
+
+(note that on the last line we use a tilde followed by an equal sign: `~=`).
+
+### GitHub
+
+Make a [GitHub](https://github.com) account.
+
+### PythonAnywhere
+
+The Django Girls tutorial includes a section on what is called Deployment, which is the process of taking the code that powers your new web application and moving it to a publicly accessible computer (called a server) so other people can see your work.
+
+This part is a little odd when doing the tutorial on a Chromebook since we're already using a computer that is on the Internet (as opposed to, say, a laptop). However, it's still useful, as we can think of our Cloud 9 workspace as a place for our "in progress" work and Python Anywhere as a place to show off our stuff as it becomes more complete.
+
+Thus, sign up for a new Python Anywhere account at [www.pythonanywhere.com](https://www.pythonanywhere.com).
\ No newline at end of file
diff --git a/zh-TW/code_editor/README.md b/zh-TW/code_editor/README.md
new file mode 100644
index 00000000000..1ba8e45290a
--- /dev/null
+++ b/zh-TW/code_editor/README.md
@@ -0,0 +1,11 @@
+# 程式編輯器 (Code editor)
+
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s) video.
+
+你即將要寫第一行程式碼　所以應該下載程式編輯器了
+
+> **注意** 如果你使用 Chromebook, 請跳過這章，且確定你依照[Chromebook Setup](../chromebook_setup/README.md) 設定. The cloud IDE you chose (PaizaCloud Cloud IDE or AWS Cloud9) includes a code editor, and when you open a file in your IDE from the File menu, you will automatically be using the editor.
+> 
+> **Note** You might have done this earlier in the [Installation chapter](../installation/README.md) – if so, you can skip right ahead to the next chapter!
+
+{% include "/code_editor/instructions.md" %}
\ No newline at end of file
diff --git a/zh-TW/code_editor/instructions.md b/zh-TW/code_editor/instructions.md
new file mode 100644
index 00000000000..1013ba720cb
--- /dev/null
+++ b/zh-TW/code_editor/instructions.md
@@ -0,0 +1,37 @@
+市面上有很多不同的編輯器，一般根據個人喜好選擇， 大部份Python程式設計師使用複雜但功能強大的整合發展環境（IDEs, Integered Development Environments）例如：PyCharm。 然而，這可能不適合初學者，我們建議使用相同功效但較為簡單的編輯器。
+
+我們的建議如下，但是隨時去問其他熟人朋友他們的喜好是甚麼，比較能夠容易的從他們那邊得到幫助。
+
+## Visual Studio Code
+
+Visual Studio Code 是個微軟開發的編輯器，支援Windows、Linux、macOS。 它支援除錯(debugging), embedded Git control, syntax highlighting, intelligent code completion, snippets, 及 code refactoring
+
+[這裡下載](https://code.visualstudio.com/)
+
+## Gedit
+
+Gedit 是個開源的免費編輯器，且支援所有系統。
+
+[這裡下載](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text 是一個很受歡迎的編輯器，擁有免費試用期且支援所有系統。
+
+[這裡下載](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom也是一個很受歡迎的編輯器。他開源、免費且支援windows、OS x及Linux。它是由[GitHub](https://github.com/). 開發。
+
+[這裡下載](https://atom.io/)
+
+## 為什麼我們要安裝程式編輯器?
+
+你可能會疑惑為什麼我們要安裝這特別的程式編輯器軟體，而不使用 Word 或記事本 (Notepad) 。
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/zh-TW/css/README.md b/zh-TW/css/README.md
new file mode 100644
index 00000000000..4f683dae839
--- /dev/null
+++ b/zh-TW/css/README.md
@@ -0,0 +1,330 @@
+# CSS - 讓它變漂亮！
+
+我們的部落格看起來仍然很醜，對吧？時間使讓它變好啊！為此，我們將使用 CSS。
+
+## CSS 是什麼？
+
+Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in a markup language (like HTML). Treat it as make-up for our web page. ;)
+
+But we don't want to start from scratch again, right? Once more, we'll use something that programmers released on the Internet for free. Reinventing the wheel is no fun, you know.
+
+## 讓我們使用 Bootstrap！
+
+Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites: https://getbootstrap.com/
+
+It was written by programmers who worked for Twitter. Now it's developed by volunteers from all over the world!
+
+## 安裝 Bootstrap
+
+To install Bootstrap, open up your `.html` file in the code editor and add this to the `<head>` section:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+```
+
+This doesn't add any files to your project. It just points to files that exist on the Internet. So go ahead, open your website and refresh the page. Here it is!
+
+![圖 14.1](images/bootstrap1.png)
+
+它看起來更漂亮！
+
+## Django 中的靜態檔案 (Static files in Django)
+
+最後，我們將仔細看看這些我們稱為**靜態檔 (static files)** 的東西。 Static files are all your CSS and images. Their content doesn't depend on the request context and will be the same for every user.
+
+### Django的靜態檔放那裡
+
+Django already knows where to find the static files for the built-in "admin" app. Now we need to add some static files for our own app, `blog`.
+
+我們在部落格應用程式 (blog app) 裡建立一個名為 `static` 資料夾︰
+
+    djangogirls
+    ├── blog
+    │   ├── migrations
+    │   ├── static
+    │   └── templates
+    └── mysite
+    
+
+Django will automatically find any folders called "static" inside any of your apps' folders. Then it will be able to use their contents as static files.
+
+## 你的第一個 CSS 檔！
+
+Let's create a CSS file now, to add your own style to your web page. 在你的 `static` 目錄內，建立一個新的目錄，名稱為 `css` 。 然後，在這個 `css` 目錄裡，建立一個新的檔，稱為 `blog.css`。 準備好了嗎？
+
+    djangogirls
+    └─── blog
+         └─── static
+              └─── css
+                   └─── blog.css
+    
+
+是時候寫一些 CSS！在你的程式碼編輯器，打開你的 `blog/static/css/blog.css`檔案。
+
+We won't be going too deep into customizing and learning about CSS here. There is a recommendation for a free CSS course at the end of this page if you would like to learn more.
+
+但讓我們至少做一些事吧。 Maybe we could change the color of our headers? 為瞭解顏色，電腦使用特殊的代碼。 These codes start with `#` followed by 6 letters (A–F) and numbers (0–9). For example, the code for blue is `#0000FF`. You can find the color codes for many colors here: http://www.colorpicker.com/. 您也可以使用 [預定義的顏色 (predefined colors)](http://www.w3schools.com/colors/colors_names.asp)，如 `red` 和 `green`.
+
+在你的 `blog/static/css/blog.css` 檔中，你應該加入以下程式碼︰
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+}
+
+```
+
+`h1 a` 是一個 CSS 選取項 (Selector)。 This means we're applying our styles to any `a` element inside of an `h1` element; the `h2 a` selector does the same thing for `h2` elements. So when we have something like `<h1><a href="">link</a></h1>`, the `h1 a` style will apply. In this case, we're telling it to change its color to `#C25100`, which is a dark orange. Or you can put your own color here, but make sure it has good contrast against a white background!
+
+在 CSS 檔中，我們決定的 HTML 檔案中元素的樣式 (styles)。 The first way we identify elements is with the element name. You might remember these as tags from the HTML section. Things like `a`, `h1`, and `body` are all examples of element names. We also identify elements by the attribute `class` or the attribute `id`. Class 和 id 是你自己給元素的名稱。 Classes 定義一群組的元素，而 ids 指向特定的元素。 For example, you could identify the following element by using the element name `a`, the class `external_link`, or the id `link_to_wiki_page`:
+
+```html
+<a href="https://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
+```
+
+You can read more about [CSS Selectors at w3schools](http://www.w3schools.com/cssref/css_selectors.asp).
+
+We also need to tell our HTML template that we added some CSS. Open the `blog/templates/blog/post_list.html` file in the code editor and add this line at the very beginning of it:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+```
+
+We're just loading static files here. :) Between the `<head>` and `</head>` tags, after the links to the Bootstrap CSS files, add this line:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link rel="stylesheet" href="{% static 'css/blog.css' %}">
+```
+
+The browser reads the files in the order they're given, so we need to make sure this is in the right place. Otherwise the code in our file may be overriden by code in Bootstrap files. 我們只是告訴我們的範本我們 CSS 檔位於何處。
+
+現在，你的檔案應該像這樣︰
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        {% for post in posts %}
+            <article>
+                <time>published: {{ post.published_date }}</time>
+                <h2><a href="">{{ post.title }}</a></h2>
+                <p>{{ post.text|linebreaksbr }}</p>
+            </article>
+        {% endfor %}
+    </body>
+</html>
+```
+
+OK，存檔並更新網頁！
+
+![圖 14.2](images/color2.png)
+
+非常好！也許我們要給我們的網站一點空間，並增加左側邊距？讓我們試試這個！
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+body {
+    padding-left: 15px;
+}
+```
+
+Add that to your CSS, save the file and see how it works!
+
+![圖 14.3](images/margin2.png)
+
+也許我們可以自訂我們的 header 中的字體？把這個貼到你 `blog/templates/blog/post_list.html` 檔案的 `<head>` 中︰
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
+```
+
+As before, check the order and place before the link to `blog/static/css/blog.css`. This line will import a font called *Lobster* from Google Fonts (https://www.google.com/fonts).
+
+Find the `h1 a` declaration block (the code between braces `{` and `}`) in the CSS file `blog/static/css/blog.css`. Now add the line `font-family: 'Lobster';` between the braces, and refresh the page:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+h1 a, h2 a {
+    color: #C25100;
+    font-family: 'Lobster';
+}
+```
+
+![圖 14.3](images/font.png)
+
+太好了！
+
+As mentioned above, CSS has a concept of classes. These allow you to name a part of the HTML code and apply styles only to this part, without affecting other parts. This can be super helpful! Maybe you have two divs that are doing something different (like your header and your post). A class can help you make them look different.
+
+Go ahead and name some parts of the HTML code. Replace the `header` that contains your header with the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header class="page-header">
+    <div class="container">
+        <h1><a href="/">Django Girls Blog</a></h1>
+    </div>
+</header>
+```
+
+And now add a class `post` to your `article` containing a blog post.
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<article class="post">
+    <time>published: {{ post.published_date }}</time>
+    <h2><a href="">{{ post.title }}</a></h2>
+    <p>{{ post.text|linebreaksbr }}</p>
+</article>
+```
+
+我們現在將增加宣告區域到不同選項器。 以 `.` 開始的選項器是關於 classes 的。 There are many great tutorials and explanations about CSS on the Web that can help you understand the following code. For now, copy and paste it into your `blog/static/css/blog.css` file:
+
+{% filename %}blog/static/css/blog.css{% endfilename %}
+
+```css
+.page-header {
+    background-color: #C25100;
+    margin-top: 0;
+    margin-bottom: 40px;
+    padding: 20px 20px 20px 40px;
+}
+
+.page-header h1,
+.page-header h1 a,
+.page-header h1 a:visited,
+.page-header h1 a:active {
+    color: #ffffff;
+    font-size: 36pt;
+    text-decoration: none;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-family: 'Lobster', cursive;
+}
+
+.date {
+    color: #828282;
+}
+
+.save {
+    float: right;
+}
+
+.post-form textarea,
+.post-form input {
+    width: 100%;
+}
+
+.top-menu,
+.top-menu:hover,
+.top-menu:visited {
+    color: #ffffff;
+    float: right;
+    font-size: 26pt;
+    margin-right: 20px;
+}
+
+.post {
+    margin-bottom: 70px;
+}
+
+.post h2 a,
+.post h2 a:visited {
+    color: #000000;
+}
+
+.post > .date,
+.post > .actions {
+    float: right;
+}
+
+.btn-default,
+.btn-default:visited {
+    color: #C25100;
+    background: none;
+    border-color: #C25100;
+}
+
+.btn-default:hover {
+    color: #FFFFFF;
+    background-color: #C25100;
+}
+```
+
+然後將顯示文章的 HTML 程式碼用 classes宣告包圍起來。將以下內容︰
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+`blog/templates/blog/post_list.html`，更換為：
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<main class="container">
+    <div class="row">
+        <div class="col">
+            {% for post in posts %}
+                <article class="post">
+                    <time class="date">
+                        {{ post.published_date }}
+                    </time>
+                    <h2><a href="">{{ post.title }}</a></h2>
+                    <p>{{ post.text|linebreaksbr }}</p>
+                </article>
+            {% endfor %}
+        </div>
+    </div>
+</main>
+```
+
+存檔並更新你的網頁。
+
+![圖 14.4](images/final.png)
+
+Woohoo! Looks awesome, right? Look at the code we just pasted to find the places where we added classes in the HTML and used them in the CSS. Where would you make the change if you wanted the date to be turquoise?
+
+Don't be afraid to tinker with this CSS a little bit and try to change some things. Playing with the CSS can help you understand what the different things are doing. If you break something, don't worry – you can always undo it!
+
+We really recommend taking the free online courses "Basic HTML & HTML5" and "Basic CSS" on [freeCodeCamp](https://learn.freecodecamp.org/). They can help you learn all about making your websites prettier with HTML and CSS.
+
+準備好進到下一章了嗎？！:)
\ No newline at end of file
diff --git a/zh-TW/deploy/README.md b/zh-TW/deploy/README.md
new file mode 100644
index 00000000000..f915edd1493
--- /dev/null
+++ b/zh-TW/deploy/README.md
@@ -0,0 +1,246 @@
+# 部署！ (Deploy!)
+
+> **注意** 這一章節內容有時候比較不容易完成。 堅持下去並完成它；佈署是網站開發過程中的重要部份。 這一章節是放在這份教材的中間部份，所以你的教練可以幫助你將你的網站上線。 這意味著假如你無法跟上課堂進度，你仍然可以自己獨立完成這份教材。
+
+到目前為止，你的網站只存在於你的電腦裡。 現在，你將會學到如何部屬它! 部署是發佈你的應用程式 (application) 到網際網路的過程，所以大家終於可以看到你的應用程式 (application. :)
+
+就如你所學的，網站必須位於伺服器上。 There are a lot of server providers available on the internet, we're going to use [PythonAnywhere](https://www.pythonanywhere.com/). PythonAnywhere is free for small applications that don't have too many visitors so it'll definitely be enough for you now.
+
+其他外部服務我們將使用 [GitHub](https://www.github.com)，它是一個程式碼托管服務 (code hosting service)。 還有其他這項服務提供者，但當今幾乎所有程式設計師都有一個 GitHub 帳戶，現在你將有一個。
+
+These three places will be important to you. Your local computer will be the place where you do development and testing. When you're happy with the changes, you will place a copy of your program on GitHub. Your website will be on PythonAnywhere and you will update it by getting a new copy of your code from GitHub.
+
+# Git
+
+> **Note** If you already did the [installation steps](../installation/README.md), there's no need to do this again – you can skip to the next section and start creating your Git repository.
+
+{% include "/deploy/install_git.md" %}
+
+## 啟動我們的 Git 倉庫 (repository)
+
+Git 追蹤任何修改到一個放在程式碼倉庫 (code repository 或簡稱 "repo") 的特定檔案集合。 讓我們開始我們的專案。 打開你的主控台，並在 `djangogirls` 目錄下執行這些命令：
+
+> **Note** Check your current working directory with a `pwd` (Mac OS X/Linux) or `cd` (Windows) command before initializing the repository. 你應該在 `djangogirls` 目錄下。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git init
+    Initialized empty Git repository in ~/djangogirls/.git/
+    $ git config --global user.name "Your Name"
+    $ git config --global user.email you@example.com
+    
+
+Initializing the git repository is something we need to do only once per project (and you won't have to re-enter the username and email ever again).
+
+Git 將會追蹤這個目錄下所有檔案和資料夾的變更，但我們想要它忽略一些檔案。 為此，我們在這專案根目錄下新增一名為 `.gitignore` 的檔案。 打開你的編輯器，新增一個包含下列內容的檔案。
+
+{% filename %}.gitignore{% endfilename %}
+
+    # Python
+    *.pyc
+    *~
+    __pycache__
+    
+    # Env
+    .env
+    myvenv/
+    venv/
+    
+    # Database
+    db.sqlite3
+    
+    # Static folder at project root
+    /static/
+    
+    # macOS
+    ._*
+    .DS_Store
+    .fseventsd
+    .Spotlight-V100
+    
+    # Windows
+    Thumbs.db*
+    ehthumbs*.db
+    [Dd]esktop.ini
+    $RECYCLE.BIN/
+    
+    # Visual Studio
+    .vscode/
+    .history/
+    *.code-workspace
+    
+
+And save it as `.gitignore` in the "djangogirls" folder.
+
+> **注意**檔名開頭的小圓點 "." 是很重要的。 If you're having any difficulty creating it (Macs don't like you to create files that begin with a dot via the Finder, for example), then use the "Save As" feature in your editor; it's bulletproof. And be sure not to add `.txt`, `.py`, or any other extension to the file name -- it will only be recognized by Git if the name is just `.gitignore`. Linux and MacOS treat files with a name that starts with `.` (such as `.gitignore`) as hidden and the normal `ls` command won't show these files. Instead use `ls -a` to see the `.gitignore` file.
+> 
+> **Note** One of the files you specified in your `.gitignore` file is `db.sqlite3`. That file is your local database, where all of your users and posts are stored. We'll follow standard web programming practice, meaning that we'll use separate databases for your local testing site and your live website on PythonAnywhere. The PythonAnywhere database could be SQLite, like your development machine, but usually you will use one called MySQL which can deal with a lot more site visitors than SQLite. Either way, by ignoring your SQLite database for the GitHub copy, it means that all of the posts and superuser you created so far are going to only be available locally, and you'll have to create new ones on production. You should think of your local database as a good playground where you can test different things and not be afraid that you're going to delete your real posts from your blog.
+
+在執行 `git add` 之前，或當你發現你自己不確定那些文件已經被修改，先使用 `git status` 命令確認是一個好主意。 This will help prevent any surprises from happening, such as wrong files being added or committed. The `git status` command returns information about any untracked/modified/staged files, the branch status, and much more. The output should be similar to the following:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    On branch master
+    
+    No commits yet
+    
+    Untracked files:
+      (use "git add <file>..." to include in what will be committed)
+    
+            .gitignore
+            blog/
+            manage.py
+            mysite/
+            requirements.txt
+    
+    nothing added to commit but untracked files present (use "git add" to track)
+    
+
+最後儲存我們的修改；到你的主控台，並執行這些命令：
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    $ git commit -m "My Django Girls app, first commit"
+     [...]
+     13 files changed, 200 insertions(+)
+     create mode 100644 .gitignore
+     [...]
+     create mode 100644 mysite/wsgi.py
+    
+
+## Pushing your code to GitHub
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. (If you already did that in the workshop prep, that is great!) Be sure to remember your password (add it to your password manager, if you use one).
+
+Then, create a new repository, giving it the name "my-first-blog". Leave the "initialize with a README" checkbox unchecked, leave the .gitignore option blank (we've done that manually) and leave the License as None.
+
+![](images/new_github_repo.png)
+
+> **Note** The name `my-first-blog` is important – you could choose something else, but it's going to occur lots of times in the instructions below, and you'd have to substitute it each time. It's probably easier to stick with the name `my-first-blog`.
+
+On the next screen, you'll be shown your repo's clone URL, which you will use in some of the commands that follow:
+
+![](images/github_get_repo_url_screenshot.png)
+
+Now we need to hook up the Git repository on your computer to the one up on GitHub.
+
+Type the following into your console (replace `<your-github-username>` with the username you entered when you created your GitHub account, but without the angle-brackets -- the URL should match the clone URL you just saw):
+
+{% filename %}command-line{% endfilename %}
+
+    $ git remote add origin https://github.com/<your-github-username>/my-first-blog.git
+    $ git push -u origin master
+    
+
+When you push to GitHub, you'll be asked for your GitHub username and password (either right there in the command-line window or in a pop-up window), and after entering credentials you should see something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    Counting objects: 6, done.
+    Writing objects: 100% (6/6), 200 bytes | 0 bytes/s, done.
+    Total 3 (delta 0), reused 0 (delta 0)
+    To https://github.com/ola/my-first-blog.git
+    
+     * [new branch]      master -> master
+    Branch master set up to track remote branch master from origin.
+    
+
+<!--TODO: maybe do ssh keys installs in install party, and point ppl who dont have it to an extension -->
+
+Your code is now on GitHub. Go and check it out! You'll find it's in fine company – [Django](https://github.com/django/django), the [Django Girls Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)
+
+# Setting up our blog on PythonAnywhere
+
+## Sign up for a PythonAnywhere account
+
+> **Note** You might have already created a PythonAnywhere account earlier during the install steps – if so, no need to do it again.
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Configuring our site on PythonAnywhere
+
+Go back to the main [PythonAnywhere Dashboard](https://www.pythonanywhere.com/) by clicking on the logo, and choose the option to start a "Bash" console – that's the PythonAnywhere version of a command line, just like the one on your computer.
+
+![The 'New Console' section on the PythonAnywhere web interface, with a button for 'bash'](images/pythonanywhere_bash_console.png)
+
+> **Note** PythonAnywhere is based on Linux, so if you're on Windows, the console will look a little different from the one on your computer.
+
+Deploying a web app on PythonAnywhere involves pulling down your code from GitHub, and then configuring PythonAnywhere to recognise it and start serving it as a web application. There are manual ways of doing it, but PythonAnywhere provides a helper tool that will do it all for you. Let's install it first:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pip3.8 install --user pythonanywhere
+    
+
+That should print out some things like `Collecting pythonanywhere`, and eventually end with a line saying `Successfully installed (...) pythonanywhere- (...)`.
+
+Now we run the helper to automatically configure our app from GitHub. Type the following into the console on PythonAnywhere (don't forget to use your GitHub username in place of `<your-github-username>`, so that the URL matches the clone URL from GitHub):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ pa_autoconfigure_django.py --python=3.8 https://github.com/<your-github-username>/my-first-blog.git
+    
+
+As you watch that running, you'll be able to see what it's doing:
+
+- Downloading your code from GitHub
+- Creating a virtualenv on PythonAnywhere, just like the one on your own computer
+- Updating your settings file with some deployment settings
+- Setting up a database on PythonAnywhere using the `manage.py migrate` command
+- Setting up your static files (we'll learn about these later)
+- And configuring PythonAnywhere to serve your web app via its API
+
+On PythonAnywhere all those steps are automated, but they're the same steps you would have to go through with any other server provider.
+
+The main thing to notice right now is that your database on PythonAnywhere is actually totally separate from your database on your own computer, so it can have different posts and admin accounts. As a result, just as we did on your own computer, we need to initialize the admin account with `createsuperuser`. PythonAnywhere has automatically activated your virtualenv for you, so all you need to do is run:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ python manage.py createsuperuser
+    
+
+Type in the details for your admin user. Best to use the same ones as you're using on your own computer to avoid any confusion, unless you want to make the password on PythonAnywhere more secure.
+
+Now, if you like, you can also take a look at your code on PythonAnywhere using `ls`:
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    (ola.pythonanywhere.com) $ ls
+    blog  db.sqlite3  manage.py  mysite requirements.txt static
+    (ola.pythonanywhere.com) $ ls blog/
+    __init__.py  __pycache__  admin.py  apps.py  migrations  models.py
+    tests.py  views.py
+    
+
+You can also go to the "Files" page and navigate around using PythonAnywhere's built-in file browser. (From the Console page, you can get to other PythonAnywhere pages from the menu button in the upper right corner. Once you're on one of the pages, there are links to the other ones near the top.)
+
+## You are now live!
+
+Your site should now be live on the public Internet! Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
+
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view. If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/) for some tips on securing your site.
+
+## Debugging tips
+
+If you see an error while running the `pa_autoconfigure_django.py` script, here are a few common causes:
+
+- Forgetting to create your PythonAnywhere API token.
+- Making a mistake in your GitHub URL
+- If you see an error saying *"Could not find your settings.py"*, it's probably because you didn't manage to add all your files to Git, and/or you didn't push them up to GitHub successfully. Have another look at the Git section above
+- If you previously signed up for a PythonAnywhere account and had an error with collectstatic, you probably have an older version of SQLite (eg 3.8.2) for your account. In that case, sign up for a new account and try the commands in the PythonAnywhere section above.
+
+If you see an error when you try to visit your site, the first place to look for some debugging info is in your **error log**. You'll find a link to this on the PythonAnywhere ["Web" page](https://www.pythonanywhere.com/web_app_setup/). See if there are any error messages in there; the most recent ones are at the bottom.
+
+There are also some [general debugging tips on the PythonAnywhere help site](http://help.pythonanywhere.com/pages/DebuggingImportError).
+
+And remember, your coach is here to help!
+
+# Check out your site!
+
+The default page for your site should say "It worked!", just like it does on your local computer. Try adding `/admin/` to the end of the URL, and you'll be taken to the admin site. Log in with the username and password, and you'll see you can add new Posts on the server -- remember, the posts from your local test database were not sent to your live blog.
+
+Once you have a few posts created, you can go back to your local setup (not PythonAnywhere). From here you should work on your local setup to make changes. This is a common workflow in web development – make changes locally, push those changes to GitHub, and pull your changes down to your live Web server. This allows you to work and experiment without breaking your live Web site. Pretty cool, huh?
+
+Give yourself a *HUGE* pat on the back! Server deployments are one of the trickiest parts of web development and it often takes people several days before they get them working. But you've got your site live, on the real Internet!
\ No newline at end of file
diff --git a/zh-TW/deploy/install_git.md b/zh-TW/deploy/install_git.md
new file mode 100644
index 00000000000..9cae1047c47
--- /dev/null
+++ b/zh-TW/deploy/install_git.md
@@ -0,0 +1,52 @@
+Git 是一個被很多程式設計師使用的 ”版本控制系統"(version control system)。 這個軟體可以追蹤檔案在過去時間的變化，所以以後你可召回特定的版本。 A bit like the "track changes" feature in word processor programs (e.g., Microsoft Word or LibreOffice Writer), but much more powerful.
+
+## 安裝 Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+你可以從 [git scm.com](https://git-scm.com/) 下載 Git。 You can hit "next" on all steps except for two: in the step where it asks to choose your editor, you should pick Nano, and in the step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). 除此之外，預設值都是正確的。 點選 Windows-style, commit Unix-style line endings 選項。
+
+Do not forget to restart the command prompt or PowerShell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/zh-TW/deploy/signup_pythonanywhere.md b/zh-TW/deploy/signup_pythonanywhere.md
new file mode 100644
index 00000000000..2e07ba090f5
--- /dev/null
+++ b/zh-TW/deploy/signup_pythonanywhere.md
@@ -0,0 +1,19 @@
+PythonAnywhere 是一個讓 Python 程式碼運行在雲端伺服器的服務。我們將用他來放置我們的網站，讓他運行在網際網路中。
+
+We will be hosting the blog we're building on PythonAnywhere. Sign up for a "Beginner" account on PythonAnywhere (the free tier is fine, you don't need a credit card).
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+![The PythonAnywhere signup page showing button to create a free 'Beginner' account](../deploy/images/pythonanywhere_beginner_account_button.png)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname or a name for what your blog is all about. Also, be sure to remember your password (add it to your password manager, if you use one).
+
+## 建立一個 PythonAnywhere API token
+
+這是個你只需要要做一次的東西。當你註冊 PythonAnywhere 時，你會被帶往儀表板。找到在你“帳戶”頁面右上角的連結
+
+![Account link on the top right on the page](../deploy/images/pythonanywhere_account.png)
+
+then select the tab named "API token", and hit the button that says "Create new API token".
+
+![The API token tab on the Account page](../deploy/images/pythonanywhere_create_api_token.png)
\ No newline at end of file
diff --git a/zh-TW/django/README.md b/zh-TW/django/README.md
new file mode 100644
index 00000000000..d9af8e571f3
--- /dev/null
+++ b/zh-TW/django/README.md
@@ -0,0 +1,27 @@
+# Django 是什麼?
+
+Django (/ˈdʒæŋɡoʊ/ *jang-goh*) 是一個由Python 語言寫成的免費、開源網頁框架。 Web 框架是一組可以説明您制定網站更快和更容易的元件。
+
+當你建立一個網站時，你總是需要一套類似的組件: 一種方式來處理使用者身份驗證 (註冊、登入、登出)、管理小組為您的網站、 表格、 一種方式來上傳檔等。
+
+Luckily for you, other people long ago noticed that web developers face similar problems when building a new site, so they teamed up and created frameworks (Django being one of them) that give you ready-made components to use.
+
+Frameworks exist to save you from having to reinvent the wheel and to help alleviate some of the overhead when you’re building a new site.
+
+## 你為什麼需要一個框架?
+
+To understand what Django is actually for, we need to take a closer look at the servers. The first thing is that the server needs to know that you want it to serve you a web page.
+
+想像一個信箱(埠 port) 會偵測寄來的信的郵箱 (請求 request)。 web 伺服器就是在做這件事 。 The web server reads the letter and then sends a response with a webpage. 但是當你想要寄出某個東西，你需要一些內容 而 Django 就是在幫你產生相對應的內容。
+
+## 當某個人向你的伺服器請求的時候發生了什麼事？
+
+When a request comes to a web server, it's passed to Django which tries to figure out what is actually requested. It takes a web page address first and tries to figure out what to do. This part is done by Django's **urlresolver** (note that a website address is called a URL – Uniform Resource Locator – so the name *urlresolver* makes sense). It is not very smart – it takes a list of patterns and tries to match the URL. Django checks patterns from top to bottom and if something is matched, then Django passes the request to the associated function (which is called *view*).
+
+想像一個帶著信的郵差。 她在街上遊走，確認每家的地址把信送給他們。 如果地址對了，她就把信放進去。 這就是 urlresolver 在做的事情！
+
+In the *view* function, all the interesting things are done: we can look at a database to look for some information. 萬一使用者要求要更改某些資料呢？ Like a letter saying, "Please change the description of my job." The *view* can check if you are allowed to do that, then update the job description for you and send back a message: "Done!" Then the *view* generates a response and Django can send it to the user's web browser.
+
+The description above is a little bit simplified, but you don't need to know all the technical things yet. Having a general idea is enough.
+
+So instead of diving too much into details, we will start creating something with Django and we will learn all the important parts along the way!
\ No newline at end of file
diff --git a/zh-TW/django_admin/README.md b/zh-TW/django_admin/README.md
new file mode 100644
index 00000000000..e231ce1c914
--- /dev/null
+++ b/zh-TW/django_admin/README.md
@@ -0,0 +1,57 @@
+# Django 管理員 (Django admin)
+
+To add, edit and delete the posts we've just modeled, we will use Django admin.
+
+Let's open the `blog/admin.py` file in the code editor and replace its contents with this:
+
+{% filename %}blog/admin.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from .models import Post
+
+admin.site.register(Post)
+```
+
+如你所看到的，我們導入 （包括） 在前一章節€中定義的 Post 模型。 要使我們的模型在管理頁面上可以看見，我們需要以 `admin.site.register(Post)` 註冊模型.
+
+OK，現在來看看我們的 Post 模型。 記得在主控台上執行 `python manage.py runserver` 啟動網站伺服器。 Go to your browser and type the address http://127.0.0.1:8000/admin/. You will see a login page like this:
+
+![登入頁面](images/login_page2.png)
+
+To log in, you need to create a *superuser* - a user account that has control over everything on the site. Go back to the command line, type `python manage.py createsuperuser`, and press enter.
+
+> Remember, to write new commands while the web server is running, open a new terminal window and activate your virtualenv. We reviewed how to write new commands in the **Your first Django project!** chapter, in the **Starting the web server** section.
+
+{% filename %}Mac OS X or Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py createsuperuser
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py createsuperuser
+    
+
+When prompted, type your username (lowercase, no spaces), email address, and password. **Don't worry that you can't see the password you're typing in – that's how it's supposed to be.** Type it in and press `enter` to continue. The output should look like this (where the username and email should be your own ones):
+
+    Username: ola
+    Email address: ola@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    
+
+Return to your browser. Log in with the superuser's credentials you chose; you should see the Django admin dashboard.
+
+![Django admin](images/django_admin3.png)
+
+Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content –- it's only visible to you on your local computer -- you can copy-paste some text from this tutorial to save time. :)
+
+Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
+
+![Django admin](images/edit_post3.png)
+
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/2.2/ref/contrib/admin/
+
+This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
\ No newline at end of file
diff --git a/zh-TW/django_forms/README.md b/zh-TW/django_forms/README.md
new file mode 100644
index 00000000000..1761925f4ea
--- /dev/null
+++ b/zh-TW/django_forms/README.md
@@ -0,0 +1,479 @@
+# Django 表單 (Forms)
+
+我們想要在我們網站做最後一件事是建立一種友善的方式來新增和編輯部落格文章。 Django 的 `管理介面 (admin)` 是很酷，但它是很難自訂格式和美化。 有了 `表格`，我們將對我們的介面有絕對的控制能力 -- 我們幾乎可以做任何我們可以想像事情！
+
+Django 表單的好處是，我們可以從零開始定義一個或者建立一個 `ModelForm`，它將會儲存表單的結果到模型。
+
+這正是我們想要做的︰我們將為我們的 `Post` 模型建立表單。
+
+像所有 Django 的重要部份，表單有他們自己的檔案︰`forms.py`.
+
+我們需要在 `blog` 目錄中建立這個檔案。
+
+    blog
+       └── forms.py
+    
+
+讓我們開啟這個檔案，並輸入以下程式碼:
+
+{% filename %}blog/forms.py{% endfilename %}
+
+```python
+from django import forms
+
+from .models import Post
+
+class PostForm(forms.ModelForm):
+
+    class Meta:
+        model = Post
+        fields = ('title', 'text',)
+```
+
+We need to import Django forms first (`from django import forms`) and our `Post` model (`from .models import Post`).
+
+`PostForm`，正如你可能猜想的，是我們表單的名稱。 We need to tell Django that this form is a `ModelForm` (so Django will do some magic for us) – `forms.ModelForm` is responsible for that.
+
+接下來，我們有 `class Meta`，在這裡我們告訴 Django 應該用什麼模型來建立這個表單（`model = Post`).
+
+最後，我們可以說哪些欄位應該在我們的表單上。 In this scenario we want only `title` and `text` to be exposed – `author` should be the person who is currently logged in (you!) and `created_date` should be automatically set when we create a post (i.e. in the code), right?
+
+就是這些！現在所有我們需要做的是在 *view* 中使用這表單，並將它顯示在範本中。
+
+So once again we will create a link to the page, a URL, a view and a template.
+
+## 連結表單到網頁 (Link to a page with the form)
+
+Before we add the link, we need some icons to use as buttons for the link. For this tutorial, download [file-earmark-plus.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/file-earmark-plus.svg) and save it in the folder `blog/templates/blog/icons/`
+
+> Note: To download the SVG image, open the context menu on the link (usually by right-clicking on it) and select "Save link as". In the dialog asking you where to save the file, navigate to the `djangogirls` directory of your Django project, and within that to subdirectory `blog/templates/blog/icons/`, and save the file there.
+
+It's time to open `blog/templates/blog/base.html` in the code editor. Now we can use this icon file inside the base template as follows. In the `div` element inside `header` section, we will add a link before the `h1` element:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+Note that we want to call our new view `post_new`. The [SVG icon](https://icons.getbootstrap.com/icons/file-earmark-plus/) is provided by the [Bootstrap Icons](https://icons.getbootstrap.com/) and it will display a page icon with plus sign. We use a Django template directive called `include`. This will inject the file's content into the Django template. The web browser knows how to handle this type of content without any further processing.
+
+> You can download all the Bootstrap icons [here](https://github.com/twbs/icons/releases/download/v1.1.0/bootstrap-icons-1.1.0.zip). Unzip the file and copy all the SVG image files into a new folder inside `blog/templates/blog/` called `icons`. That way you can access an icon like `pencil-fill.svg` using the file path `blog/templates/blog/icons/pencil-fill.svg`
+
+After editing the line, your HTML file should now look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+            <div class="container">
+                <a href="{% url 'post_new' %}" class="top-menu">
+                    {% include './icons/file-earmark-plus.svg' %}
+                </a>
+                <h1><a href="/">Django Girls Blog</a></h1>
+            </div>
+        </header>
+        <main class="content container">
+            <div class="row">
+                <div class="col">
+                    {% block content %}
+                    {% endblock %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+After saving and refreshing the page http://127.0.0.1:8000 you will see a familiar `NoReverseMatch` error. Is that the case? Good!
+
+## URL
+
+We open `blog/urls.py` in the code editor and add a line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+path('post/new/', views.post_new, name='post_new'),
+```
+
+And the final code will look like this:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+    path('post/new/', views.post_new, name='post_new'),
+]
+```
+
+After refreshing the site, we see an `AttributeError`, since we don't have the `post_new` view implemented. Let's add it right now.
+
+## post_new view
+
+Time to open the `blog/views.py` file in the code editor and add the following lines with the rest of the `from` rows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from .forms import PostForm
+```
+
+And then our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+To create a new `Post` form, we need to call `PostForm()` and pass it to the template. We will go back to this *view*, but for now, let's quickly create a template for the form.
+
+## 範本 (Template)
+
+We need to create a file `post_edit.html` in the `blog/templates/blog` directory, and open it in the code editor. To make a form work we need several things:
+
+* We have to display the form. We can do that with (for example) {% raw %}`{{ form.as_p }}`{% endraw %}.
+* The line above needs to be wrapped with an HTML form element: `<form method="POST">...</form>`.
+* We need a `Save` button. We do that with an HTML button: `<button type="submit">Save</button>`.
+* And finally, just after the opening `<form ...>` tag we need to add {% raw %}`{% csrf_token %}`{% endraw %}. 這是非常重要的，因為它讓你的表單較安全！ If you forget about this bit, Django will complain when you try to save the form:
+
+![CSFR Forbidden page](images/csrf2.png)
+
+OK, so let's see how the HTML in `post_edit.html` should look:
+
+{% filename %}blog/templates/blog/post_edit.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <h2>New post</h2>
+    <form method="POST" class="post-form">{% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit" class="save btn btn-default">Save</button>
+    </form>
+{% endblock %}
+```
+
+Time to refresh! Yay! Your form is displayed!
+
+![New form](images/new_form2.png)
+
+But, wait a minute! When you type something in the `title` and `text` fields and try to save it, what will happen?
+
+Nothing! We are once again on the same page and our text is gone… and no new post is added. So what went wrong?
+
+The answer is: nothing. We need to do a little bit more work in our *view*.
+
+## 儲存表單 (Saving the form)
+
+Open `blog/views.py` once again in the code editor. Currently all we have in the `post_new` view is the following:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+When we submit the form, we are brought back to the same view, but this time we have some more data in `request`, more specifically in `request.POST` (the naming has nothing to do with a blog "post"; it's to do with the fact that we're "posting" data). Remember how in the HTML file, our `<form>` definition had the variable `method="POST"`? All the fields from the form are now in `request.POST`. You should not rename `POST` to anything else (the only other valid value for `method` is `GET`, but we have no time to explain what the difference is).
+
+So in our *view* we have two separate situations to handle: first, when we access the page for the first time and we want a blank form, and second, when we go back to the *view* with all form data we just typed. So we need to add a condition (we will use `if` for that):
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if request.method == "POST":
+    [...]
+else:
+    form = PostForm()
+```
+
+It's time to fill in the dots `[...]`. If `method` is `POST` then we want to construct the `PostForm` with data from the form, right? We will do that as follows:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST)
+```
+
+The next thing is to check if the form is correct (all required fields are set and no incorrect values have been submitted). We do that with `form.is_valid()`.
+
+We check if the form is valid and if so, we can save it!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+if form.is_valid():
+    post = form.save(commit=False)
+    post.author = request.user
+    post.published_date = timezone.now()
+    post.save()
+```
+
+Basically, we have two things here: we save the form with `form.save` and we add an author (since there was no `author` field in the `PostForm` and this field is required). `commit=False` means that we don't want to save the `Post` model yet – we want to add the author first. Most of the time you will use `form.save()` without `commit=False`, but in this case, we need to supply it. `post.save()` will preserve changes (adding the author) and a new blog post is created!
+
+Finally, it would be awesome if we could immediately go to the `post_detail` page for our newly created blog post, right? To do that we need one more import:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import redirect
+```
+
+Add it at the very beginning of your file. And now we can say, "go to the `post_detail` page for the newly created post":
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+return redirect('post_detail', pk=post.pk)
+```
+
+`post_detail` is the name of the view we want to go to. Remember that this *view* requires a `pk` variable? To pass it to the views, we use `pk=post.pk`, where `post` is the newly created blog post!
+
+OK, we've talked a lot, but we probably want to see what the whole *view* looks like now, right?
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_new(request):
+    if request.method == "POST":
+        form = PostForm(request.POST)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm()
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+Let's see if it works. Go to the page http://127.0.0.1:8000/post/new/, add a `title` and `text`, save it… and voilà! The new blog post is added and we are redirected to the `post_detail` page!
+
+You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a *publish button* in **Django Girls Tutorial: Extensions**.
+
+That is awesome!
+
+> As we have recently used the Django admin interface, the system currently thinks we are still logged in. There are a few situations that could lead to us being logged out (closing the browser, restarting the DB, etc.). If, when creating a post, you find that you are getting errors referring to the lack of a logged-in user, head to the admin page http://127.0.0.1:8000/admin and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you in the **Homework: add security to your website!** chapter after the main tutorial.
+
+![Logged in error](images/post_create_error.png)
+
+## 表單驗證 (Form validation)
+
+Now, we will show you how cool Django forms are. A blog post needs to have `title` and `text` fields. In our `Post` model we did not say that these fields (as opposed to `published_date`) are not required, so Django, by default, expects them to be set.
+
+Try to save the form without `title` and `text`. Guess what will happen!
+
+![Form validation](images/form_validation2.png)
+
+Django is taking care to validate that all the fields in our form are correct. Isn't it awesome?
+
+## 編輯表單 (Edit form)
+
+Now we know how to add a new post. But what if we want to edit an existing one? This is very similar to what we just did. Let's create some important things quickly. (If you don't understand something, you should ask your coach or look at the previous chapters, since we covered all these steps already.)
+
+First, let's save the icon which represents the edit button. Download [pencil-fill.svg](https://raw.githubusercontent.com/twbs/icons/main/icons/pencil-fill.svg) and save it to the location `blog/templates/blog/icons/`.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and add the following code inside `article` element:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<aside class="actions">
+    <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+      {% include './icons/pencil-fill.svg' %}
+    </a>
+</aside>
+```
+
+so that the template will look like this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        <aside class="actions">
+            <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+                {% include './icons/pencil-fill.svg' %}
+            </a>
+        </aside>
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Open `blog/urls.py` in the code editor, and add this line:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+    path('post/<int:pk>/edit/', views.post_edit, name='post_edit'),
+```
+
+We will reuse the template `blog/templates/blog/post_edit.html`, so the last missing thing is a *view*.
+
+Let's open `blog/views.py` in the code editor and add this at the very end of the file:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_edit(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    if request.method == "POST":
+        form = PostForm(request.POST, instance=post)
+        if form.is_valid():
+            post = form.save(commit=False)
+            post.author = request.user
+            post.published_date = timezone.now()
+            post.save()
+            return redirect('post_detail', pk=post.pk)
+    else:
+        form = PostForm(instance=post)
+    return render(request, 'blog/post_edit.html', {'form': form})
+```
+
+This looks almost exactly the same as our `post_new` view, right? But not entirely. For one, we pass an extra `pk` parameter from `urls`. Next, we get the `Post` model we want to edit with `get_object_or_404(Post, pk=pk)` and then, when we create a form, we pass this post as an `instance`, both when we save the form…
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(request.POST, instance=post)
+```
+
+…and when we've just opened a form with this post to edit:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+form = PostForm(instance=post)
+```
+
+OK, let's test if it works! Let's go to the `post_detail` page. There should be an edit button in the top-right corner:
+
+![Edit button](images/edit_button2.png)
+
+When you click it you will see the form with our blog post:
+
+![Edit form](images/edit_form2.png)
+
+Feel free to change the title or the text and save the changes!
+
+Congratulations! Your application is getting more and more complete!
+
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/2.2/topics/forms/
+
+## 安全性 (Security)
+
+Being able to create new posts by clicking a link is awesome! But right now, anyone who visits your site will be able to make a new blog post, and that's probably not something you want. Let's make it so the button shows up for you but not for anyone else.
+
+Open `blog/templates/blog/base.html` in the code editor, find our `div` inside `header` and the anchor element you put in there earlier. It should look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<a href="{% url 'post_new' %}" class="top-menu">
+    {% include './icons/file-earmark-plus.svg' %}
+</a>
+```
+
+We're going to add another `{% if %}` tag to this, which will make the link show up only for users who are logged into the admin. Right now, that's just you! Change the `<a>` element to look like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+    <a href="{% url 'post_new' %}" class="top-menu">
+        {% include './icons/file-earmark-plus.svg' %}
+    </a>
+{% endif %}
+```
+
+This `{% if %}` will cause the link to be sent to the browser only if the user requesting the page is logged in. This doesn't protect the creation of new posts completely, but it's a good first step. We'll cover more security in the extension lessons.
+
+Remember the edit icon we just added to our detail page? We also want to add the same change there, so other people won't be able to edit existing posts.
+
+Open `blog/templates/blog/post_detail.html` in the code editor and find this line:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+    {% include './icons/pencil-fill.svg' %}
+</a>
+```
+
+Change it to this:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% if user.is_authenticated %}
+     <a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}">
+        {% include './icons/pencil-fill.svg' %}
+     </a>
+{% endif %}
+```
+
+Since you're likely logged in, if you refresh the page, you won't see anything different. Load the page in a different browser or an incognito window (called "InPrivate" in Windows Edge), though, and you'll see that the link doesn't show up, and the icon doesn't display either!
+
+## 還有一件事：部署時間！ (One more thing: deploy time!)
+
+Let's see if all this works on PythonAnywhere. Time for another deploy!
+
+* First, commit your new code, and push it up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added views to create/edit blog post inside the site."
+    $ git push
+    
+
+* 然後，在 [PythonAnywhere Bash 主控台](https://www.pythonanywhere.com/consoles/)︰
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (use the menu button in the upper right of the console) and hit **Reload**. Refresh your https://subdomain.pythonanywhere.com blog to see the changes.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/zh-TW/django_installation/README.md b/zh-TW/django_installation/README.md
new file mode 100644
index 00000000000..0200b60227c
--- /dev/null
+++ b/zh-TW/django_installation/README.md
@@ -0,0 +1,7 @@
+# 安裝 Django
+
+> **注意** 如果你使用 Chromebook, 請跳過這章，且確定你依照[Chromebook Setup](../chromebook_setup/README.md) 設定.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md) then you've already done this – you can go straight to the next chapter!
+
+{% include "/django_installation/instructions.md" %}
\ No newline at end of file
diff --git a/zh-TW/django_installation/instructions.md b/zh-TW/django_installation/instructions.md
new file mode 100644
index 00000000000..e63bb3f29d5
--- /dev/null
+++ b/zh-TW/django_installation/instructions.md
@@ -0,0 +1,229 @@
+> 本章節的部份內容是源自Geek Girls Carrots的教材(https://github.com/ggcarrots/django-carrots/)。
+> 
+> Part of this section is based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Markus Zapke-Gründemann 等人擁有 django-marcador 教材的版權
+
+## 虛擬環境 (Virtual environment)
+
+在安裝 Django 之前，我們將讓你安裝一個非常有用的工具，這個工具可以幫助你保持電腦上編碼環境的整潔。 你可以跳過這個步驟，但我們強烈建議你完成這個部份。 以最佳的設定環境開始，將會在未來為省去很多麻煩。
+
+所以，讓我們來建立一個**虛擬環境** (也稱為*virtualenv*)。 虛擬環境將以專案單位 (per-project) 為基礎將你的 Python/Django 設定隔離開。 這意味你對一個網站做的修改將不會影響到任何你正在開發的網站。 很棒吧！對不對？
+
+你所必需做的是找一個你想建立 `virtualenv` 的目錄 (directory) ，例如：你的主目錄 (home directory) 。 On Windows, it might look like `C:\Users\Name` (where `Name` is the name of your login).
+
+> **NOTE:** On Windows, make sure that this directory does not contain accented or special characters; if your username contains accented characters, use a different directory, for example, `C:\djangogirls`.
+
+在這份教材中，我們將使用你主目錄 (home directory) 下的新目錄 `djangogirls`：
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir djangogirls
+    $ cd djangogirls
+    
+
+我們將稱這個虛擬環境 (virtualenv) 為 `myvenv` ，一般的命令 (command) 格式如下：
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+<!--sec data-title="Virtual environment: Windows" data-id="virtualenv_installation_windows"
+data-collapse=true ces-->
+
+To create a new `virtualenv`, you need to open the command prompt and run `python -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> python -m venv myvenv
+    
+
+Where `myvenv` is the name of your `virtualenv`. 你可以使用任何其他名字，但遵守使用小寫字母，及不使用空白、重音符號和特殊字元。 It is also a good idea to keep the name short – you'll be referencing it a lot!
+
+<!--endsec-->
+
+<!--sec data-title="Virtual environment: Linux and OS X" data-id="virtualenv_installation_linuxosx"
+data-collapse=true ces-->
+
+We can create a `virtualenv` on both Linux and OS X by running `python3 -m venv myvenv`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 -m venv myvenv
+    
+
+`myvenv` 是你`虛擬環境 (virtualenv)` 的名字。 你可以使用任何其他名字，但遵守使用小寫字母，及不使用空白。 It is also a good idea to keep the name short as you'll be referencing it a lot!
+
+> **注意:** 在一些Debian/Ubuntu版本中你也許會收到以下錯誤訊息:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
+>        apt install python3-venv
+>     You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.
+>     
+> 
+> In this case, follow the instructions above and install the `python3-venv` package: {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python3-venv
+>     
+> 
+> **NOTE:** On some versions of Debian/Ubuntu initiating the virtual environment like this currently gives the following error:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
+>     
+> 
+> 避開這個錯誤，請使用 `virtualenv` 指令 (command) 。
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ sudo apt install python-virtualenv
+>     $ virtualenv --python=python{{ book.py_version }} myvenv
+>     
+> 
+> **NOTE:** If you get an error like
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     E: Unable to locate package python3-venv
+>     
+> 
+> then instead run:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     sudo apt install python{{ book.py_version }}-venv
+>     
+
+<!--endsec-->
+
+## 使用虛擬環境 (virtualenv)
+
+The command above will create a directory called `myvenv` (or whatever name you chose) that contains our virtual environment (basically a bunch of directories and files).
+
+<!--sec data-title="Working with virtualenv: Windows" data-id="virtualenv_windows"
+data-collapse=true ces-->
+
+執行下列命令進入虛擬環境 (virtual environment) ：
+
+{% filename %}command-line{% endfilename %}
+
+    C:\Users\Name\djangogirls> myvenv\Scripts\activate
+    
+
+> **NOTE:** On Windows 10 you might get an error in the Windows PowerShell that says `execution of scripts is disabled on this system`. In this case, open another Windows PowerShell with the "Run as Administrator" option. Then try typing the following command before starting your virtual environment:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+>         Execution Policy Change
+>         The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
+>     
+
+<!-- (This comment separates the two blockquote blocks, so that GitBook and Crowdin don't merge them into a single block.) -->
+
+> **NOTE:** For users of the popular editor VS Code, which comes with an integrated terminal based off windows PowerShell, if you wish to stick with the integrated terminal, you may run the following command to activate your virtual environment:
+> 
+>     $ . myvenv\Scripts\activate.ps1
+>     
+> 
+> The advantage is that you don't have to switch between editor windows and command-line windows
+
+<!--endsec-->
+
+<!--sec data-title="Working with virtualenv: Linux and OS X" data-id="virtualenv_linuxosx"
+data-collapse=true ces-->
+
+Start your virtual environment by running:
+
+{% filename %}command-line{% endfilename %}
+
+    $ source myvenv/bin/activate
+    
+
+Remember to replace `myvenv` with your chosen `virtualenv` name!
+
+> **NOTE:** If the command `source` is not available, try doing this instead:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     $ . myvenv/bin/activate
+>     
+
+<!--endsec-->
+
+You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
+
+When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.
+
+OK, we have all important dependencies in place. We can finally install Django!
+
+## Installing Django {#django}
+
+Now that you have your `virtualenv` started, you can install Django.
+
+Before we do that, we should make sure we have the latest version of `pip`, the software that we use to install Django:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ python -m pip install --upgrade pip
+    
+
+### Installing packages with requirements
+
+A requirements file keeps a list of dependencies to be installed using `pip install`:
+
+First create a `requirements.txt` file inside of the `djangogirls/` folder, using the code editor that you installed earlier. You do this by opening a new file in the code editor and then saving it as `requirements.txt` in the `djangogirls/` folder. Your directory will look like this:
+
+    djangogirls
+    ├── myvenv
+    │   └── ...
+    └───requirements.txt
+    
+
+In your `djangogirls/requirements.txt` file you should add the following text:
+
+{% filename %}djangogirls/requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+Now, run `pip install -r requirements.txt` to install Django.
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~$ pip install -r requirements.txt
+    Collecting Django~={{ book.django_version }} (from -r requirements.txt (line 1))
+      Downloading Django-{{ book.django_version }}-py3-none-any.whl (7.1MB)
+    Installing collected packages: Django
+    Successfully installed Django-{{ book.django_version }}
+    
+
+<!--sec data-title="Installing Django: Windows" data-id="django_err_windows"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Windows, please check if your project pathname contains spaces, accents or special characters (for example, `C:\Users\User Name\djangogirls`). If it does, please consider using another place without spaces, accents or special characters (suggestion: `C:\djangogirls`). Create a new virtualenv in the new directory, then delete the old one and try the above command again. (Moving the virtualenv directory won't work since virtualenv uses absolute paths.)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Windows 8 and Windows 10" data-id="django_err_windows8and10"
+data-collapse=true ces-->
+
+> Your command line might freeze when you try to install Django. If this happens, instead of the above command use:
+> 
+> {% filename %}command-line{% endfilename %}
+> 
+>     C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
+>     
+
+<!--endsec-->
+
+<!--sec data-title="Installing Django: Linux" data-id="django_err_linux"
+data-collapse=true ces-->
+
+> If you get an error when calling pip on Ubuntu 12.04 please run `python -m pip install -U --force-reinstall pip` to fix the pip installation in the virtualenv.
+
+<!--endsec-->
+
+That's it! You're now (finally) ready to create a Django application!
\ No newline at end of file
diff --git a/zh-TW/django_models/README.md b/zh-TW/django_models/README.md
new file mode 100644
index 00000000000..d4e5d61c6dd
--- /dev/null
+++ b/zh-TW/django_models/README.md
@@ -0,0 +1,201 @@
+# Django 模型 (Django models)
+
+我們現在想要做的是將來能存儲我們部落格中的所有文章的東西。但為了能夠做我們需要，我們必須談一下`物件`這東西.
+
+## 物件 (Objects)
+
+There is a concept in programming called `object-oriented programming`. The idea is that instead of writing everything as a boring sequence of programming instructions, we can model things and define how they interact with each other.
+
+那麼什麼是物件？它是一個屬性 (properties) 和動作 (actions) 的集合。聽起來很奇怪吧，但是我們將會給你一個例子。
+
+If we want to model a cat, we will create an object `Cat` that has some properties such as `color`, `age`, `mood` (like good, bad, or sleepy ;)), and `owner` (which could be assigned a `Person` object – or maybe, in case of a stray cat, this property could be empty).
+
+Then the `Cat` has some actions: `purr`, `scratch`, or `feed` (in which case, we will give the cat some `CatFood`, which could be a separate object with properties, like `taste`).
+
+    Cat
+    --------
+    color
+    age
+    mood
+    owner
+    purr()
+    scratch()
+    feed(cat_food)
+    
+
+    CatFood
+    --------
+    taste
+    
+
+所以基本上，這概念是用包含屬性（稱為`object properties`）和方法（稱為`methods`）的程式碼來描寫真實的事物).
+
+那麼我們將如何建立我們的部落格文章 (blog posts) 的模型？我們想要建立一個部落格，對吧？
+
+我們需要回答這個問題：什麼是部落格文章 (blog post) ？它應該有什麼屬性？
+
+嗯，確定的是我們的博客文章 (blog post) 需要一些文字內容和標題，對嗎？ It would be also nice to know who wrote it – so we need an author. 最後，我們想要知道文章是什麼時候建立和公佈。
+
+    Post
+    --------
+    title
+    text
+    author
+    created_date
+    published_date
+    
+
+那些工作和部落格文章有關？有一些公佈文章的`方法 (method) `是不錯的，對吧
+
+所以我們將需要一個`公佈(publish)` 的方法。
+
+既然我們已經知道我們想要完成什麼，讓我們開始在 Django 上建立模型吧。
+
+## Django 模型 (Django model)
+
+知道什麼是物件 (object) 之後，我們可以為我們的部落格文章 (blog post) 建立一個 Django 模型。
+
+A model in Django is a special kind of object – it is saved in the `database`. 資料庫是資料的集合。 這是你將存儲有關使用者 (users) 和你的部落格文章 (blog posts) 等資訊的地方。 我們將使用一個 SQLite 資料庫來存儲我們的資料。 This is the default Django database adapter – it'll be enough for us right now.
+
+你可以把資料庫中的模型看作是有列（欄位）和行（資料）的試算表。
+
+### 建立應用程式 (Creating an application)
+
+為了讓一切保持整潔，我們將在我們的專案內建立一個別的應用程式。 一開始就讓一切井然有序是很好的。 我們需要在主控台上（從 `djangogirls` 檔所在目錄 `manage.py` ）執行以下命令來建立一個應用程式：
+
+{% filename %}Mac OS X and Linux:{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py startapp blog
+    
+
+{% filename %}Windows:{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> python manage.py startapp blog
+    
+
+You will notice that a new `blog` directory is created and it contains a number of files now. The directories and files in our project should look like this:
+
+    djangogirls
+    ├── blog
+    │   ├── admin.py
+    │   ├── apps.py
+    │   ├── __init__.py
+    │   ├── migrations
+    │   │   └── __init__.py
+    │   ├── models.py
+    │   ├── tests.py
+    │   └── views.py
+    ├── db.sqlite3
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+    
+
+After creating an application, we also need to tell Django that it should use it. We do that in the file `mysite/settings.py` -- open it in your code editor. We need to find `INSTALLED_APPS` and add a line containing `'blog.apps.BlogConfig',` just above `]`. So the final product should look like this:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'blog.apps.BlogConfig',
+]
+```
+
+### 建立一個部落格文章張貼模型 (Creating a blog post model)
+
+In the `blog/models.py` file we define all objects called `Models` – this is a place in which we will define our blog post.
+
+Let's open `blog/models.py` in the code editor, remove everything from it, and write code like this:
+
+{% filename %}blog/models.py{% endfilename %}
+
+```python
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+
+class Post(models.Model):
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    title = models.CharField(max_length=200)
+    text = models.TextField()
+    created_date = models.DateTimeField(default=timezone.now)
+    published_date = models.DateTimeField(blank=True, null=True)
+
+    def publish(self):
+        self.published_date = timezone.now()
+        self.save()
+
+    def __str__(self):
+        return self.title
+```
+
+> Double-check that you use two underscore characters (`_`) on each side of `str`. 這個規矩在 Python 中頻繁地使用，有時候我們也稱它為 "dunder" （是 "double-underscore" 的縮寫）。　
+
+It looks scary, right? But don't worry – we will explain what these lines mean!
+
+All lines starting with `from` or `import` are lines that add some bits from other files. So instead of copying and pasting the same things in every file, we can include some parts with `from ... import ...`.
+
+`class Post(models.Model):` – this line defines our model (it is an `object`).
+
+- `class` 是一個特殊的關鍵字，表示我們在定義一個物件 (object) 。
+- `Post` is the name of our model. We can give it a different name (but we must avoid special characters and whitespace). Always start a class name with an uppercase letter.
+- `models.Model` 意味 Post 是一個 Django 模型，所以 Django 知道這模型應該被儲存在資料庫。
+
+Now we define the properties we were talking about: `title`, `text`, `created_date`, `published_date` and `author`. To do that we need to define the type of each field (Is it text? A number? A date? A relation to another object, like a User?)
+
+- `models.CharField` – this is how you define text with a limited number of characters.
+- `models.TextField` – this is for long text without a limit. Sounds ideal for blog post content, right?
+- `models.DateTimeField` – this is a date and time.
+- `models.ForeignKey` – this is a link to another model.
+
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types).
+
+What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example, a method that calculates average price could be called `calculate_average_price`.
+
+Methods often `return` something. There is an example of that in the `__str__` method. In this scenario, when we call `__str__()` we will get a text (**string**) with a Post title.
+
+Also notice that both `def publish(self):` and `def __str__(self):` are indented inside our class. Because Python is sensitive to whitespace, we need to indent our methods inside the class. Otherwise, the methods won't belong to the class, and you can get some unexpected behavior.
+
+If something is still not clear about models, feel free to ask your coach! We know it is complicated, especially when you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
+
+### 為你資料庫中的模組建立表格 (Create tables for models in your database)
+
+The last step here is to add our new model to our database. First we have to make Django know that we have some changes in our model. (We have just created it!) Go to your console window and type `python manage.py makemigrations blog`. It will look like this:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py makemigrations blog
+    Migrations for 'blog':
+      blog/migrations/0001_initial.py:
+    
+      - Create model Post
+    
+
+**Note:** Remember to save the files you edit. Otherwise, your computer will execute the previous version which might give you unexpected error messages.
+
+Django prepared a migration file for us that we now have to apply to our database. Type `python manage.py migrate blog` and the output should be as follows:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate blog
+    Operations to perform:
+      Apply all migrations: blog
+    Running migrations:
+      Applying blog.0001_initial... OK
+    
+
+Hurray! Our Post model is now in our database! It would be nice to see it, right? Jump to the next chapter to see what your Post looks like!
\ No newline at end of file
diff --git a/zh-TW/django_orm/README.md b/zh-TW/django_orm/README.md
new file mode 100644
index 00000000000..11cdda328de
--- /dev/null
+++ b/zh-TW/django_orm/README.md
@@ -0,0 +1,221 @@
+# Django ORM 和查詢集 (QuerySets)
+
+在這一章中，您將學習 Django 如何連接到資料庫，並將資料存儲在裡面。一起去探究吧！
+
+## 查詢集 (QuerySet) 是什麼？
+
+A QuerySet is, in essence, a list of objects of a given Model. QuerySets allow you to read the data from the database, filter it and order it.
+
+從例子中學習是最容易的。讓我們試試，好嗎？
+
+## Django shell
+
+打開你的主控台（不是在 PythonAnywhere上），鍵入以下命令︰
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py shell
+    
+
+結果應該像這樣︰
+
+{% filename %}command-line{% endfilename %}
+
+```python
+(InteractiveConsole)
+>>>
+```
+
+You're now in Django's interactive console. It's just like the Python prompt, but with some additional Django magic. :) You can use all the Python commands here too.
+
+### 所有物件 (All objects)
+
+首先，讓我們試著顯示所有我們的文章。你可以用下面的命令︰
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+Traceback (most recent call last):
+      File "<console>", line 1, in <module>
+NameError: name 'Post' is not defined
+```
+
+Oops! An error showed up. It tells us that there is no Post. It's correct – we forgot to import it first!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from blog.models import Post
+```
+
+We import the model `Post` from `blog.models`. Let's try displaying all posts again:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>]>
+```
+
+This is a list of the posts we created earlier! We created these posts using the Django admin interface. But now we want to create new posts using Python, so how do we do that?
+
+### 建立物件 (Create object)
+
+這是你如何在資料庫中建立一個新的文章物件︰
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+```
+
+But we have one missing ingredient here: `me`. We need to pass an instance of `User` model as an author. How do we do that?
+
+讓我們首先導入 User 模型︰
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.contrib.auth.models import User
+```
+
+在我們的資料庫中我們有哪些使用者？試試這個︰
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> User.objects.all()
+<QuerySet [<User: ola>]>
+```
+
+This is the superuser we created earlier! Let's get an instance of the user now (adjust this line to use your own username):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> me = User.objects.get(username='ola')
+```
+
+As you can see, we now `get` a `User` with a `username` that equals 'ola'. Neat!
+
+現在我們終於可以建立我們的文章︰
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+<Post: Sample title>
+```
+
+萬歲！想要確認它是否成功？
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+在這裡，又多一個文章在清單中！
+
+### 新增更多文章 (Add more posts)
+
+You can now have a little fun and add more posts to see how it works. Add two or three more and then go ahead to the next part.
+
+### 篩選物件 (Filter objects)
+
+A big part of QuerySets is the ability to filter them. Let's say we want to find all posts that user ola authored. 我們將使用 `filter` 而不是在 `Post.objects.all()` 中的 `all`。 In parentheses we state what condition(s) a blog post needs to meet to end up in our queryset. In our case, the condition is that `author` should be equal to `me`. The way to write it in Django is `author=me`. 現在我們的程式碼部份看起來像這樣︰
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(author=me)
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+Or maybe we want to see all the posts that contain the word 'title' in the `title` field?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(title__contains='title')
+<QuerySet [<Post: Sample title>, <Post: 4th title of post>]>
+```
+
+> **注意**有兩個底線字元（`_`）在 `title` 和 `contains` 之間。 Django's ORM uses this rule to separate field names ("title") and operations or filters ("contains"). If you use only one underscore, you'll get an error like "FieldError: Cannot resolve keyword title_contains".
+
+You can also get a list of all published posts. We do this by filtering all the posts that have `published_date` set in the past:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> from django.utils import timezone
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet []>
+```
+
+Unfortunately, the post we added from the Python console is not published yet. But we can change that! First get an instance of a post we want to publish:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post = Post.objects.get(title="Sample title")
+```
+
+然後用我們的 `publish` 方法 (method) 將它發佈:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> post.publish()
+```
+
+Now try to get list of published posts again (press the up arrow key three times and hit `enter`):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now())
+<QuerySet [<Post: Sample title>]>
+```
+
+### 排序物件 (Ordering objects)
+
+QuerySets 還允許你排序清單的物件。讓我們試著按 `created_date` 欄位來排序︰
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('created_date')
+<QuerySet [<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]>
+```
+
+我們也可以在欄位開頭添加 `-`，做反向排序：
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> Post.objects.order_by('-created_date')
+<QuerySet [<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]>
+```
+
+### Complex queries through method-chaining
+
+As you saw, some methods on `Post.objects` return a QuerySet. The same methods can in turn also be called on a QuerySet, and will then return a new QuerySet. Thus, you can combine their effect by **chaining** them together:
+
+```python
+>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+<QuerySet [<Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>, <Post: Sample title>]>
+```
+
+這真是強而有力，並可讓你寫相當複雜的查詢 (queries)。
+
+酷！你現在已經可以到下一部分！若要關閉 shell，請鍵入這︰
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
\ No newline at end of file
diff --git a/zh-TW/django_start_project/README.md b/zh-TW/django_start_project/README.md
new file mode 100644
index 00000000000..c3f7467f0f6
--- /dev/null
+++ b/zh-TW/django_start_project/README.md
@@ -0,0 +1,260 @@
+# 你的第一個 Django 專案 ！
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+> 
+> Parts of this chapter are based on the [django-marcador tutorial](http://django-marcador.keimlink.de/) licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Markus Zapke-Gründemann 等人擁有 django-marcador 教材的版權
+
+We're going to create a small blog!
+
+第一個步驟是開始一個新的 Django 專案。 基本上，這意味著我們將執行一些 Django 提供的 scripts ，它將為我們建立一個 Django 專案的骨架。 這只是一些目錄和檔案，之後我們將用到。
+
+某些檔案和目錄的名稱對 Django 是非常重要的， 你不應該重新命名我們將要建立的檔案， 將它們移動到不同的地方也不是一個好主意， Django 需要維持一定的結構，以便能夠找到重要的事項。
+
+> 記得在虛擬環境 (virtualenv) 上執行每一個指令。 If you don't see a prefix `(myvenv)` in your console, you need to activate your virtualenv. 怎麼做，我們在 **Django 安裝 **章節中的**使用虛擬環境 (virtualenv) ** 部份說明過了。 Typing `myvenv\Scripts\activate` on Windows or `source myvenv/bin/activate` on Mac OS X or Linux will do this for you.
+
+<!--sec data-title="Create project: OS X or Linux" data-id="django_start_project_OSX_Linux" data-collapse=true ces-->
+
+In your Mac OS X or Linux console, you should run the following command. **Don't forget to add the period (or dot) `.` at the end!**
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ django-admin startproject mysite .
+    
+
+> 句點（`.`）是很重要的，因為它告訴 script 安裝 Django 在你目前的目錄（這個句點 （`.`）是速記參考記號).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin`. The `(myvenv) ~/djangogirls$` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+<!--sec data-title="Create project: Windows" data-id="django_start_project_windows" data-collapse=true ces-->
+
+On Windows you should run the following command. **(Don't forget to add the period (or dot) `.` at the end)**:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .
+    
+
+> 句點（`.`）是很重要的，因為它告訴 script 安裝 Django 在你目前的目錄（這個句點 （`.`）是速記參考記號).
+> 
+> **Note** When typing the command above, remember that you only type the part which starts by `django-admin.exe`. The `(myvenv) C:\Users\Name\djangogirls>` part shown here is just example of the prompt that will be inviting your input on your command line.
+
+<!--endsec-->
+
+`django-admin.py` 是一個將為你建立目錄和檔案的 script，現在你應該有一個看起來像這樣的目錄架構。
+
+    djangogirls
+    ├── manage.py
+    ├── mysite
+    │   ├── __init__.py
+    │   ├── settings.py
+    │   ├── urls.py
+    │   └── wsgi.py
+    ├── myvenv
+    │   └── ...
+    └── requirements.txt
+    
+
+> **Note**: in your directory structure, you will also see your `venv` directory that we created before.
+
+`manage.py` is a script that helps with management of the site. With it we will be able (amongst other things) to start a web server on our computer without installing anything else.
+
+`settings.py` 檔案包含了你網站的配置數據。
+
+還記得當我們談過郵遞員確認應該把信送到那裡嗎？`urls.py` 檔包含了`urlresolver`使用的形態列表.
+
+現在讓我們暫且忽略其他檔案，因為我們將不會改變他們。要記住的唯一一點是不要不小心刪除了他們！
+
+## 更改設定 (Changing settings)
+
+讓我們對 `mysite/settings.py` 做一些改變，用你之前安裝的程式編輯器打開這個檔案。
+
+**Note**: Keep in mind that `settings.py` is a regular file, like any other. You can open it from inside the code editor, using the "file -> open" menu actions. This should get you the usual window in which you can navigate to your `settings.py` file and select it. Alternatively, you can open the file by navigating to the djangogirls folder on your desktop and right-clicking on it. Then, select your code editor from the list. Selecting the editor is important as you might have other programs installed that can open the file but will not let you edit it.
+
+有正確的時間在我們的網站上是很不錯的。 Go to [Wikipedia's list of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) and copy your relevant time zone (TZ) (e.g. `Europe/Berlin`).
+
+In `settings.py`, find the line that contains `TIME_ZONE` and modify it to choose your own timezone. For example:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+TIME_ZONE = 'Europe/Berlin'
+```
+
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/2.2/ref/settings/#language-code).
+
+If you want a different language, change the language code by changing the following line:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LANGUAGE_CODE = 'de-ch'
+```
+
+We'll also need to add a path for static files. (We'll find out all about static files and CSS later in the tutorial.) Go down to the *end* of the file, and just underneath the `STATIC_URL` entry, add a new one called `STATIC_ROOT`:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+STATIC_URL = '/static/'
+STATIC_ROOT = os.path.join(BASE_DIR, 'static')
+```
+
+When `DEBUG` is `True` and `ALLOWED_HOSTS` is empty, the host is validated against `['localhost', '127.0.0.1', '[::1]']`. This won't match our hostname on PythonAnywhere once we deploy our application so we will change the following setting:
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']
+```
+
+> **Note**: If you're using a Chromebook, add this line at the bottom of your settings.py file: `MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'`
+> 
+> Also add `.amazonaws.com` to the `ALLOWED_HOSTS` if you are using cloud9
+> 
+> If you are hosting your project on `Glitch.com`, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):
+> 
+> - First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:
+>     
+>     {% filename %}command-line{% endfilename %}
+>     
+>     ```bash
+>     python -c 'from django.core.management.utils import get_random_secret_key; \
+>           print(get_random_secret_key())'
+>     ```
+>     
+>     This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a `.env` file that Glitch will only show you if you are the owner of the web site.
+> 
+> - Create a file `.env` at the root of your project and add the following property in it:
+>     
+>     {% filename %}.env{% endfilename %}
+>     
+>     ```bash
+>     # Here, inside the single quotes, you can cut and paste the random key generated above
+>     SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'
+>     ```
+> 
+> - Then update the Django settings file to inject this secret value and set the Django web site name:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     SECRET_KEY = os.getenv('SECRET')
+>     ```
+> 
+> - And a little further down in the same file, we inject the name of your new Glitch website:
+>     
+>     {% filename %}mysite/settings.py{% endfilename %}
+>     
+>     ```python
+>     ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]
+>     ```
+>     
+>     The `PROJECT_DOMAIN` value is automatically generated by Glitch. It will correspond to the name of your project.
+
+## Set up a database
+
+有很多的不同的資料庫軟體，可以存儲你網站的資料。我們將使用預設的 `sqlite3`.
+
+這已經在 `mysite/settings.py` 檔中設定了：
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+```
+
+為了建立我們部落格的資料庫，讓我們在主控台上執行下列命令：`python manage.py migrate`（我們需要在包含 `manage.py` 檔的 `djangogirls` 目錄中）。 如果一切進行順利，您應該看到這樣的東西：
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py migrate
+    Operations to perform:
+      Apply all migrations: auth, admin, contenttypes, sessions
+    Running migrations:
+      Rendering model states... DONE
+      Applying contenttypes.0001_initial... OK
+      Applying auth.0001_initial... OK
+      Applying admin.0001_initial... OK
+      Applying admin.0002_logentry_remove_auto_add... OK
+      Applying contenttypes.0002_remove_content_type_name... OK
+      Applying auth.0002_alter_permission_name_max_length... OK
+      Applying auth.0003_alter_user_email_max_length... OK
+      Applying auth.0004_alter_user_username_opts... OK
+      Applying auth.0005_alter_user_last_login_null... OK
+      Applying auth.0006_require_contenttypes_0002... OK
+      Applying auth.0007_alter_validators_add_error_messages... OK
+      Applying auth.0008_alter_user_username_max_length... OK
+      Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying sessions.0001_initial... OK
+    
+
+完成工作了，啟動網站伺服器 (web server) 看看我們的網站是否正常運作！
+
+## Starting the web server
+
+你需要在包含 `manage.py` 檔的目錄中（`djangogirls` 目錄）。 在主控台上，我們可以執行 `python manage.py runserver` 啟動網站伺服器 (web server) ：
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver
+    
+
+If you are on a Chromebook, use this command instead:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080
+    
+
+or this one if you are using Glitch:
+
+{% filename %}Glitch.com terminal{% endfilename %}
+
+    $ refresh
+    
+    
+
+If you are on Windows and this fails with `UnicodeDecodeError`, use this command instead:
+
+{% filename %}command-line{% endfilename %}
+
+    (myvenv) ~/djangogirls$ python manage.py runserver 0:8000
+    
+
+Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:
+
+{% filename %}browser{% endfilename %}
+
+    http://127.0.0.1:8000/
+    
+
+If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:
+
+{% filename %}browser{% endfilename %}
+
+    https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com
+    
+
+or on Glitch:
+
+    https://name-of-your-glitch-project.glitch.me
+    
+
+Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
+
+![Install worked!](images/install_worked.png)
+
+Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.
+
+> We reviewed how web servers work in the **How the Internet works** chapter.
+
+To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see [Introduction to the command line](../intro_to_command_line/README.md). To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).
+
+Ready for the next step? It's time to create some content!
\ No newline at end of file
diff --git a/zh-TW/django_templates/README.md b/zh-TW/django_templates/README.md
new file mode 100644
index 00000000000..e62f7fb4524
--- /dev/null
+++ b/zh-TW/django_templates/README.md
@@ -0,0 +1,108 @@
+# Django 範本 (templates)
+
+是時候顯示一些資料了！為此，Django 提供我們一些有用的內建**範本標籤 (template tags)**。
+
+## 範本標籤是什麼？
+
+You see, in HTML, you can't really write Python code, because browsers don't understand it. They know only HTML. We know that HTML is rather static, while Python is much more dynamic.
+
+**Django template tags** allow us to transfer Python-like things into HTML, so you can build dynamic websites faster. Cool!
+
+## 顯示文章清單範本
+
+在前一章中我們在 `posts` 變數中給我們的範本文章清單，現在我們將在 HTML 中顯示它。
+
+若要刊載 Django 範本中的變數，我們把變數放在兩個雙大括弧裡面，像這樣︰
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{{ posts }}
+```
+
+在你的 `blog/templates/blog/post_list.html` 範本中，試試這個。 Open it up in the code editor, and replace everything from the second `<div>` to the third `</div>` with `{{ posts }}`. 存檔，並更新網頁 (refresh) 以查看結果︰
+
+![圖 13.1](images/step1.png)
+
+如你所看到的，我們得到是這樣︰
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<QuerySet [<Post: My second post>, <Post: My first post>]>
+```
+
+這表示 Django 瞭解它是物件清單。 還記得在 **Python 簡介** 中我們可以如何顯示清單嗎？ 是的，用迴圈 (loop)！ 在 Django 範本中你這樣做︰
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    {{ post }}
+{% endfor %}
+```
+
+在你的範本中試試這些。
+
+![圖 13.2](images/step2.png)
+
+成功了！ But we want the posts to be displayed like the static posts we created earlier in the **Introduction to HTML** chapter. 你可以混合使用 HTML 和範本標籤。 我們的 `body` 將像這樣︰
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<header>
+    <h1><a href="/">Django Girls Blog</a></h1>
+</header>
+
+{% for post in posts %}
+    <article>
+        <time>published: {{ post.published_date }}</time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+{% raw %}你放在 `{% for %}` 和 `{% endfor %}` 之間的程式碼將重複清單中的每個物件。更新你的網頁︰{% endraw %}
+
+![圖 13.3](images/step3.png)
+
+Have you noticed that we used a slightly different notation this time (`{{ post.title }}` or `{{ post.text }}`)? 我們存取定義在我們 `Post` 模型中每個欄位的資料。 Also, the `|linebreaksbr` is piping the posts' text through a filter to convert line-breaks into paragraphs.
+
+## 還有一件事
+
+It'd be good to see if your website will still be working on the public Internet, right? Let's try deploying to PythonAnywhere again. Here's a recap of the steps…
+
+* First, push your code to GitHub
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    [...]
+    $ git add .
+    $ git status
+    [...]
+    $ git commit -m "Modified templates to display posts from database."
+    [...]
+    $ git push
+    
+
+* 然後，登錄 [PythonAnywhere](https://www.pythonanywhere.com/consoles/) 並到你的 **Bash 主控台**（或啟動一個新的），然後，執行︰
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd <your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app. (To reach other PythonAnywhere pages from the console, use the menu button in the upper right corner.) Your update should be live on https://subdomain.pythonanywhere.com -- check it out in the browser! If the blog posts on your PythonAnywhere site don't match the posts appearing on the blog hosted on your local server, that's OK. The databases on your local computer and Python Anywhere don't sync with the rest of your files.
+
+Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!) Make sure you are in the Django admin for your pythonanywhere site, https://subdomain.pythonanywhere.com/admin. Then refresh your page to see if the post appears there.
+
+Works like a charm? We're proud! Step away from your computer for a bit – you have earned a break. :)
+
+![Figure 13.4](images/donut.png)
\ No newline at end of file
diff --git a/zh-TW/django_urls/README.md b/zh-TW/django_urls/README.md
new file mode 100644
index 00000000000..b91595e2266
--- /dev/null
+++ b/zh-TW/django_urls/README.md
@@ -0,0 +1,103 @@
+# Django URLs
+
+We're about to build our first webpage: a homepage for your blog! But first, let's learn a little bit about Django URLs.
+
+## 什麼是 URL？
+
+A URL is a web address. You can see a URL every time you visit a website – it is visible in your browser's address bar. (Yes! `127.0.0.1:8000` 是‘一個 URL！ And `https://djangogirls.org` is also a URL.)
+
+![URL](images/url.png)
+
+在網際網路上每個網頁都需要有它自己的 URL。 This way your application knows what it should show to a user who opens that URL. In Django, we use something called `URLconf` (URL configuration). URLconf is a set of patterns that Django will try to match the requested URL to find the correct view.
+
+## 在 Django 上 URLs 如何運作？
+
+在你選擇的程式碼編輯器上，打開 `mysite/urls.py` 檔，看看它長什麼樣子：
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+"""mysite URL Configuration
+
+[...]
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]
+```
+
+As you can see, Django has already put something here for us.
+
+Lines between triple quotes (`'''` or `"""`) are called docstrings – you can write them at the top of a file, class or method to describe what it does. They won't be run by Python.
+
+The admin URL, which you visited in the previous chapter, is already here:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+    path('admin/', admin.site.urls),
+```
+
+This line means that for every URL that starts with `admin/`, Django will find a corresponding *view*. In this case, we're including a lot of admin URLs so it isn't all packed into this small file – it's more readable and cleaner.
+
+## Your first Django URL!
+
+Time to create our first URL! We want 'http://127.0.0.1:8000/' to be the home page of our blog and to display a list of posts.
+
+We also want to keep the `mysite/urls.py` file clean, so we will import URLs from our `blog` application to the main `mysite/urls.py` file.
+
+Go ahead, add a line that will import `blog.urls`. You will also need to change the `from django.urls…` line because we are using the `include` function here, so you will need to add that import to the line.
+
+Your `mysite/urls.py` file should now look like this:
+
+{% filename %}mysite/urls.py{% endfilename %}
+
+```python
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('blog.urls')),
+]
+```
+
+Django will now redirect everything that comes into 'http://127.0.0.1:8000/' to `blog.urls` and looks for further instructions there.
+
+## blog.urls
+
+Create a new empty file named `urls.py` in the `blog` directory, and open it in the code editor. All right! Add these first two lines:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+```
+
+Here we're importing Django's function `path` and all of our `views` from the `blog` application. (We don't have any yet, but we will get to that in a minute!)
+
+After that, we can add our first URL pattern:
+
+{% filename %}blog/urls.py{% endfilename %}
+
+```python
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+]
+```
+
+As you can see, we're now assigning a `view` called `post_list` to the root URL. This URL pattern will match an empty string and the Django URL resolver will ignore the domain name (i.e., http://127.0.0.1:8000/) that prefixes the full URL path. This pattern will tell Django that `views.post_list` is the right place to go if someone enters your website at the 'http://127.0.0.1:8000/' address.
+
+The last part, `name='post_list'`, is the name of the URL that will be used to identify the view. This can be the same as the name of the view but it can also be something completely different. We will be using the named URLs later in the project, so it is important to name each URL in the app. We should also try to keep the names of URLs unique and easy to remember.
+
+If you try to visit http://127.0.0.1:8000/ now, then you'll find some sort of 'web page not available' message. This is because the server (remember typing `runserver`?) is no longer running. Take a look at your server console window to find out why.
+
+![Error](images/error1.png)
+
+Your console is showing an error, but don't worry – it's actually pretty useful: It's telling you that there is **no attribute 'post_list'**. That's the name of the *view* that Django is trying to find and use, but we haven't created it yet. At this stage, your `/admin/` will also not work. No worries – we will get there. If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
+
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/urls/
\ No newline at end of file
diff --git a/zh-TW/django_views/README.md b/zh-TW/django_views/README.md
new file mode 100644
index 00000000000..ff70a9fb606
--- /dev/null
+++ b/zh-TW/django_views/README.md
@@ -0,0 +1,44 @@
+# Django views – time to create!
+
+是時候來排除我們在上一章節中造成的錯誤 (bug) 了! :)
+
+*view* 是我們放應用程式的 "邏輯" 的地方。 它將要求你之前建立的 `模型(model)` 提供資訊，並將它傳遞給 `範本(template)`。 在下一章，我們將建立一個範本。 Views are just Python functions that are a little bit more complicated than the ones we wrote in the **Introduction to Python** chapter.
+
+Views 都放在 `views.py` 檔中，我們將會新增我們 *views* 到 `blog/views.py` 檔。
+
+## blog/views.py
+
+OK, let's open up this file in our code editor and see what's in there:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+# Create your views here.
+```
+
+Not too much stuff here yet.
+
+Remember that lines starting with `#` are comments – this means that those lines won't be run by Python.
+
+Let's create a *view* as the comment suggests. Add the following minimal view below it:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+As you can see, we created a function (`def`) called `post_list` that takes `request` and will `return` the value it gets from calling another function `render` that will render (put together) our template `blog/post_list.html`.
+
+Save the file, go to http://127.0.0.1:8000/ and see what we've got.
+
+另一個錯誤！讀看看現在發生什麼：
+
+![錯誤 (Error)](images/error.png)
+
+This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
+
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/2.2/topics/http/views/
\ No newline at end of file
diff --git a/zh-TW/dynamic_data_in_templates/README.md b/zh-TW/dynamic_data_in_templates/README.md
new file mode 100644
index 00000000000..211fd49620a
--- /dev/null
+++ b/zh-TW/dynamic_data_in_templates/README.md
@@ -0,0 +1,84 @@
+# 在範本中的動態資料 (Dynamic data in templates)
+
+我們把不同的東西安排妥當了︰`Post` 模型定義在 `models.py`，我們定義 `post_list` 在 `views.py`，且新增範本 (template) 了。 但我們究竟將如何使我們的文章出現在我們的 HTML 範本 (template) 上？ Because that is what we want to do – take some content (models saved in the database) and display it nicely in our template, right?
+
+這就是 *views* 應該做的：連接模型 (models) 和範本 (templates)。 In our `post_list` *view* we will need to take the models we want to display and pass them to the template. In a *view* we decide what (model) will be displayed in a template.
+
+OK, so how will we achieve this?
+
+We need to open our `blog/views.py` in our code editor. So far `post_list` *view* looks like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+
+def post_list(request):
+    return render(request, 'blog/post_list.html', {})
+```
+
+還記得當我們談到導入 (including) 程式碼編寫在不同檔案中嗎？ Now is the moment when we have to include the model we have written in `models.py`. We will add the line `from .models import Post` like this:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from .models import Post
+```
+
+The dot before `models` means *current directory* or *current application*. Both `views.py` and `models.py` are in the same directory. This means we can use `.` and the name of the file (without `.py`). 然後，我們將導入 (import) 模型的名稱 (`Post`).
+
+But what's next? To take actual blog posts from the `Post` model we need something called `QuerySet`.
+
+## 查詢集 (QuerySet)
+
+You should already be familiar with how QuerySets work. We talked about them in [Django ORM (QuerySets) chapter](../django_orm/README.md).
+
+So now we want published blog posts sorted by `published_date`, right? We already did that in QuerySets chapter!
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+```
+
+So, let's open the `blog/views.py` file in the code editor, and add this piece of code to the function `def post_list(request)` -- but don't forget to first add `from django.utils import timezone`:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {})
+```
+
+To display our QuerySet on our blog's post list, we have two things left to do:
+
+1. Pass the `posts` QuerySet to the template context, by changing the `render` function call. We'll do this now.
+2. Modify the template to display the `posts` QuerySet. We'll cover this in a later chapter.
+
+請注意，我們為我們的 QuerySet 建立了一個*變數 (variable)*︰`posts`，並將它視為我們的 QuerySet 的名稱，從現在開始我們可以透過這個名字引用它。
+
+In the `render` function we have one parameter `request` (everything we receive from the user via the Internet) and another giving the template file (`'blog/post_list.html'`). The last parameter, `{}`, is a place in which we can add some things for the template to use. 我們需要給它們名字（現在我們將沿用 `'posts'`). :) 它應該看起來像這樣︰`{'posts': posts}`. Please note that the part before `:` is a string; you need to wrap it with quotes: `''`.
+
+所以，最後我們的 `blog/views.py` 檔應像這樣︰
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render
+from django.utils import timezone
+from .models import Post
+
+def post_list(request):
+    posts = Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')
+    return render(request, 'blog/post_list.html', {'posts': posts})
+```
+
+就這些！現在回到我們的範本並顯示這個 QuerySet！
+
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/2.2/ref/models/querysets/
\ No newline at end of file
diff --git a/zh-TW/extend_your_application/README.md b/zh-TW/extend_your_application/README.md
new file mode 100644
index 00000000000..43b3dbd758e
--- /dev/null
+++ b/zh-TW/extend_your_application/README.md
@@ -0,0 +1,214 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this code!" ></span>' %}
+
+# 擴展你的應用程式 (Extend your application)
+
+We've already completed all the different steps necessary for the creation of our website: we know how to write a model, URL, view and template. We also know how to make our website pretty.
+
+Time to practice!
+
+The first thing we need in our blog is, obviously, a page to display one post, right?
+
+We already have a `Post` model, so we don't need to add anything to `models.py`.
+
+## 建立一個範本連結到一篇文章內容 (Create a template link to a post's detail)
+
+We will start with adding a link inside `blog/templates/blog/post_list.html` file. Open it in the code editor, and so far it should look like this: {% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+{% raw %}We want to have a link from a post's title in the post list to the post's detail page. Let's change `<h2><a href="">{{ post.title }}</a></h2>` so that it links to the post's detail page:{% endraw %}
+
+{% filename %}{{ warning_icon }} blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2>
+```
+
+{% raw %}Time to explain the mysterious `{% url 'post_detail' pk=post.pk %}`. As you might suspect, the `{% %}` notation means that we are using Django template tags. This time we will use one that will create a URL for us!{% endraw %}
+
+The `post_detail` part means that Django will be expecting a URL in `blog/urls.py` with name=post_detail
+
+And how about `pk=post.pk`? `pk` is short for primary key, which is a unique identifier for each record in a database. Every Django model has a field which serves as its primary key, and whatever other name it has, it can also be referred to as "pk". Because we didn't specify a primary key in our `Post` model, Django creates one for us (by default, a field named "id" holding a number that increases for each record, i.e. 1, 2, 3) and adds it as a field to each of our posts. We access the primary key by writing `post.pk`, the same way we access other fields (`title`, `author`, etc.) in our `Post` object!
+
+Now when we go to http://127.0.0.1:8000/ we will have an error (as expected, since we do not yet have a URL or a *view* for `post_detail`). It will look like this:
+
+![NoReverseMatch error](images/no_reverse_match2.png)
+
+## 建立一個文章內容頁 URL (Create a URL to a post's detail)
+
+Let's create a URL in `urls.py` for our `post_detail` *view*!
+
+We want our first post's detail to be displayed at this **URL**: http://127.0.0.1:8000/post/1/
+
+Let's make a URL in the `blog/urls.py` file to point Django to a *view* named `post_detail`, that will show an entire blog post. Open the `blog/urls.py` file in the code editor, and add the line `path('post/<int:pk>/', views.post_detail, name='post_detail'),` so that the file looks like this:
+
+{% filename %}{{ warning_icon }} blog/urls.py{% endfilename %}
+
+```python
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.post_list, name='post_list'),
+    path('post/<int:pk>/', views.post_detail, name='post_detail'),
+]
+```
+
+This part `post/<int:pk>/` specifies a URL pattern – we will explain it for you:
+
+- `post/` means that the URL should begin with the word **post** followed by a **/**. So far so good.
+- `<int:pk>` – this part is trickier. It means that Django expects an integer value and will transfer it to a view as a variable called `pk`.
+- `/` – then we need a **/** again before finishing the URL.
+
+That means if you enter `http://127.0.0.1:8000/post/5/` into your browser, Django will understand that you are looking for a *view* called `post_detail` and transfer the information that `pk` equals `5` to that *view*.
+
+OK, we've added a new URL pattern to `blog/urls.py`! Let's refresh the page: http://127.0.0.1:8000/ Boom! The server has stopped running again. Have a look at the console – as expected, there's yet another error!
+
+![AttributeError](images/attribute_error2.png)
+
+Do you remember what the next step is? It's adding a view!
+
+## 增加一個文章的內容 view
+
+This time our *view* is given an extra parameter, `pk`. Our *view* needs to catch it, right? So we will define our function as `def post_detail(request, pk):`. Note that this parameter must have the exact same name as the one we specified in `urls` (`pk`). Also note that omitting this variable is incorrect and will result in an error!
+
+Now, we want to get one and only one blog post. To do this, we can use querysets, like this:
+
+{% filename %}{{ warning_icon }} blog/views.py{% endfilename %}
+
+```python
+Post.objects.get(pk=pk)
+```
+
+But this code has a problem. If there is no `Post` with the given `primary key` (`pk`) we will have a super ugly error!
+
+![DoesNotExist error](images/does_not_exist2.png)
+
+We don't want that! But luckily Django comes with something that will handle that for us: `get_object_or_404`. In case there is no `Post` with the given `pk`, it will display much nicer page, the `Page Not Found 404` page.
+
+![Page not found](images/404_2.png)
+
+The good news is that you can actually create your own `Page not found` page and make it as pretty as you want. But it's not super important right now, so we will skip it.
+
+OK, time to add a *view* to our `views.py` file!
+
+In `blog/urls.py` we created a URL rule named `post_detail` that refers to a view called `views.post_detail`. This means that Django will be expecting a view function called `post_detail` inside `blog/views.py`.
+
+We should open `blog/views.py` in the code editor and add the following code near the other `from` lines:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+from django.shortcuts import render, get_object_or_404
+```
+
+And at the end of the file we will add our *view*:
+
+{% filename %}blog/views.py{% endfilename %}
+
+```python
+def post_detail(request, pk):
+    post = get_object_or_404(Post, pk=pk)
+    return render(request, 'blog/post_detail.html', {'post': post})
+```
+
+Yes. It is time to refresh the page: http://127.0.0.1:8000/
+
+![Post list view](images/post_list2.png)
+
+It worked! But what happens when you click a link in blog post title?
+
+![TemplateDoesNotExist error](images/template_does_not_exist2.png)
+
+Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
+
+## Create a template for the post details
+
+We will create a file in `blog/templates/blog` called `post_detail.html`, and open it in the code editor.
+
+Enter the following code:
+
+{% filename %}blog/templates/blog/post_detail.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    <article class="post">
+        {% if post.published_date %}
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+        {% endif %}
+        <h2>{{ post.title }}</h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endblock %}
+```
+
+Once again we are extending `base.html`. In the `content` block we want to display a post's published_date (if it exists), title and text. But we should discuss some important things, right?
+
+{% raw %}`{% if ... %} ... {% endif %}` is a template tag we can use when we want to check something. (Remember `if ... else ...` from **Introduction to Python** chapter?) In this scenario we want to check if a post's `published_date` is not empty.{% endraw %}
+
+OK, we can refresh our page and see if `TemplateDoesNotExist` is gone now.
+
+![Post detail page](images/post_detail2.png)
+
+Yay! It works!
+
+# Deploy time!
+
+It'd be good to see if your website still works on PythonAnywhere, right? Let's try deploying again.
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    $ git add .
+    $ git status
+    $ git commit -m "Added view and template for detailed blog post as well as CSS for the site."
+    $ git push
+    
+
+Then, in a [PythonAnywhere Bash console](https://www.pythonanywhere.com/consoles/):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+(Remember to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain, without the angle-brackets.)
+
+## Updating the static files on the server
+
+Servers like PythonAnywhere like to treat "static files" (like CSS files) differently from Python files, because they can optimise for them to be loaded faster. As a result, whenever we make changes to our CSS files, we need to run an extra command on the server to tell it to update them. The command is called `collectstatic`.
+
+Start by activating your virtualenv if it's not still active from earlier (PythonAnywhere uses a command called `workon` to do this, it's just like the `source myenv/bin/activate` command you use on your own computer):
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ workon <your-pythonanywhere-domain>.pythonanywhere.com
+    (ola.pythonanywhere.com)$ python manage.py collectstatic
+    [...]
+    
+
+The `manage.py collectstatic` command is a bit like `manage.py migrate`. We make some changes to our code, and then we tell Django to *apply* those changes, either to the server's collection of static files, or to the database.
+
+In any case, we're now ready to hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) (from the menu button in the upper right of the console) and hit **Reload**, and then look at the https://subdomain.pythonanywhere.com page to see the result.
+
+And that should be it. Congrats! :)
\ No newline at end of file
diff --git a/zh-TW/how_the_internet_works/README.md b/zh-TW/how_the_internet_works/README.md
new file mode 100644
index 00000000000..bbcfb7309bc
--- /dev/null
+++ b/zh-TW/how_the_internet_works/README.md
@@ -0,0 +1,47 @@
+# 網際網路是如何運作的
+
+> For readers at home: this chapter is covered in the [How the Internet Works](https://www.youtube.com/watch?v=oM9yAA09wdc) video.
+> 
+> This chapter is inspired by the talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
+
+We bet you use the Internet every day. But do you actually know what happens when you type an address like https://djangogirls.org into your browser and press `enter`?
+
+The first thing you need to understand is that a website consists of a bunch of files saved on a hard disk -- just like your movies, music, or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
+
+If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari, Firefox, etc.) love it. 網站瀏覽器就是設計出來讀懂 Html 的，遵循它的架構及切切實實地展示你希望瀏覽器展示的所有檔案。
+
+我們需要將 HTML 檔案們，及其所包含的所有檔案存在硬碟的某處。 為了放上網際網路，我們使用了特別且強悍的電腦 -- 稱為 伺服器 *server* 。 這些伺服器不需要螢幕、滑鼠甚至是鍵盤，因為這些電腦的主要目的就是儲存這些資料並且提供服務。 That's why they're called *servers* – because they *serve* you data.
+
+OK, but you want to know how the Internet looks, right?
+
+我們為你畫了張示意圖，它看起來像是這樣:
+
+![Figure 1.1](images/internet_1.png)
+
+看起來真是一團亂吧？ In fact it is a network of connected machines (the above-mentioned *servers*). 成千上萬台的機器啊！ 非常、非常多公里長的電纜存在在這整個世界上！ 你可以訪問一個叫做 Submarine 纜線地圖 (http://submarinecablemap.com/) 的網站，去看看這個連結有多複雜。 這是網站中的一個截圖：
+
+![Figure 1.2](images/internet_3.png)
+
+這真是無法想像，對吧？ But it is not possible to have a wire between every machine connected to the Internet. So, to reach a machine (for example, the one where https://djangogirls.org is saved) we need to pass a request through many, many different machines.
+
+這件事看起來就像是這樣：
+
+![Figure 1.3](images/internet_2.png)
+
+Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the djangogirls.org website. Send it to me, please!"
+
+你的信會先送到最近的郵局。 然後再送到下一個離你的收件地址更近一點的，然後再下一個，直到這封信被傳遞到目的地為止。 唯一一件比較特別的事是如果你送了頻繁的信(*封包 data packets*) 到同一個地址，每一封信都會經由完全不同的郵局(*路由 routers*)。 這是依據他們如何被分散到各個郵局。
+
+![Figure 1.4](images/internet_4.png)
+
+That's how it works - you send messages and you expect some response. Instead of paper and pen you use bytes of data, but the idea is the same!
+
+除了有國家、郵遞區號、城市與街道名稱所組成的地址，我們也使用 IP 作為地址。 你的電腦會先要求網域系統 (DNS - Domain Name System) 將 djangogirls.org 這個網域轉換為 IP。 It works a little bit like old-fashioned phonebooks where you can look up the name of the person you want to contact and find their phone number and address.
+
+When you send a letter, it needs to have certain features to be delivered correctly: an address, a stamp, etc. 你也需要使用收件者可以理解的語言，對吧？ 這與你依順序送出的 *封包* 要求觀看一個網站其實是同一件事。 你使用一個被稱為 HTTP (超文本轉換協定) 的協定。
+
+所以呢，基本上，當你有了一個網站程式你也需要有一個 *伺服器* (機器) 讓你的網站活起來。 這個 *伺服器* 一直在等待來自各方的 *要求 request* (這個詞意思是要求伺服器傳回你的網站資料)，然後伺服器會就回應你你要求的網站 (response) 。
+
+Since this is a Django tutorial, you might ask what Django does. 當你需要回傳一個回應，你並不想總是對所有人回傳同一個回應。 你的信是更加個人化的、更加特別針對某個人只為你量身打造的，豈不是更好嗎？ Django 可以説明您創建這些個人化的、 有趣的信. :)
+
+Enough talk – time to create!
\ No newline at end of file
diff --git a/zh-TW/html/README.md b/zh-TW/html/README.md
new file mode 100644
index 00000000000..973d52c6d70
--- /dev/null
+++ b/zh-TW/html/README.md
@@ -0,0 +1,227 @@
+# HTML 簡介
+
+你可能會問什麼是範本 (template)？
+
+A template is a file that we can re-use to present different information in a consistent format – for example, you could use a template to help you write a letter because although each letter might contain a different message and be addressed to a different person, they will share the same format.
+
+A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter, **How the Internet works**).
+
+## 什麼是 HTML？
+
+HTML is a code that is interpreted by your web browser – such as Chrome, Firefox or Safari – to display a web page for the user.
+
+HTML 代表 "超文字標記語言 (HyperText Markup Language)"。 **超文字 (HyperText)** 是指它是一種支援網頁之間的超連結的文字。 **標記 (Markup)** 意味著我們接收文件並標示上程式碼來告訴某個東西（在這裡是指瀏覽器）如何解譯成網頁。 HTML 程式碼是由**標記 (tags)** 構成，每一程式碼以 `<` 開始，且以 `>` 結束。 這些標籤 (tags) 表示標記 (markup) **元素 (elements)**.
+
+## 你第一個範本 (template)！
+
+建立一個範本 (template) 是指建立一個範本檔 (template file)，一切都是一個檔，對吧？你可能已經注意到這點了。
+
+範本 (templates) 儲存在 `blog/templates/blog` 目錄中。 所以，先建立一個名稱為 `templates` 目錄 在你的 blog 目錄裡。 然後建立另一個稱為 `blog` 的目錄在你的 templates 目錄裡：
+
+    blog
+    └───templates
+        └───blog
+    
+
+(You might wonder why we need two directories both called `blog` – as you will discover later, this is a useful naming convention that makes life easier when things start to get more complicated.)
+
+現在，在 `blog/templates/blog` 目錄裡面，建立一個 `post_list.html` 檔（現在讓它保留空白） 。
+
+看看你的網站現在是什麼樣子：http://127.0.0.1:8000/
+
+> If you still have an error `TemplateDoesNotExist`, try to restart your server. Go to the command line, stop the server by pressing Ctrl+C (Control and C keys together) and start it again by running a `python manage.py runserver` command.
+
+![圖 11.1](images/step1.png)
+
+No error anymore! Congratulations! :) However, your website isn't actually publishing anything except an empty page, because your template is empty too. We need to fix that.
+
+Open the new file in the code editor, and add the following:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+<body>
+    <p>Hi there!</p>
+    <p>It works!</p>
+</body>
+</html>
+```
+
+So how does your website look now? Visit it to find out: http://127.0.0.1:8000/
+
+![圖 11.2](images/step3.png)
+
+It worked. Nice work there! :)
+
+* The line `<!DOCTYPE html>` is not a HTML tag. It only declares the document type. Here, it informs the browser that document type is [HTML5](https://html.spec.whatwg.org/#the-doctype). This is always the beginning of any HTML5 file.
+* The most basic tag, `<html>`, is always the beginning of html content and `</html>` is always the end. As you can see, the whole content of the website goes between the beginning tag `<html>` and closing tag `</html>`
+* `<p>` is a tag for paragraph elements; `</p>` closes each paragraph
+
+## Head and body
+
+每個 HTML 頁面也分為兩個元素︰**head** 和 **body**.
+
+* **head** 是一個元素，它包含不顯示在螢幕上的有關於文件的資訊。
+
+* **body** 是一個元素。它包含一切顯示在網頁的東西。
+
+我們使用 `<head>` 告訴瀏覽器有關網頁的設定，和 `<body>` 來告訴它網頁上究竟有什麼。
+
+For example, you can put a web page title element inside the `<head>`, like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Ola's blog</title>
+    </head>
+    <body>
+        <p>Hi there!</p>
+        <p>It works!</p>
+    </body>
+</html>
+```
+
+存檔並更新你的網頁。
+
+![圖 11.3](images/step4.png)
+
+注意瀏覽器如何瞭解 "Ola's blog" 是你的網頁的標題？ 它已經轉譯 `<title>Ola's blog</title>` 並把文字內容放在你的瀏覽器的標題列上（它將被用於書籤 (bookmarks)，.. 等等）。
+
+你可能也注意到每個開始標籤都搭配一個 `/` 和 *結束標籤 (closing tag)*，且元素是*嵌套的 (nested)*(即是你必需結束特定標籤內所有標籤後，才能結束這個特定標籤）。
+
+這就像把東西放進盒子裡。 你有一個大箱子 `<html></html>`，在它裡面有 `<body></body>`，並包含了更小的箱子：`<p></p>`.
+
+You need to follow these rules of *closing* tags, and of *nesting* elements – if you don't, the browser may not be able to interpret them properly and your page will display incorrectly.
+
+## 自訂您的範本 (template)
+
+現在，你可以有點樂趣和試著自訂您的範本！這裡是幾個有用的標籤︰
+
+* `<h1>A heading</h1>` for your most important heading
+* `<h2>A sub-heading</h2>` 為下一級標題。
+* `<h3>A sub-sub-heading</h3>` …and so on, up to `<h6>`
+* `<p>A paragraph of text</p>`
+* `<em>text</em>` 強調文字。
+* `<strong>text</strong>` 強烈強調你的文字。
+* `<br>` goes to another line (you can't put anything inside br and there's no closing tag)
+* `<a href="https://djangogirls.org">link</a>` 建一個連結。
+* `<ul><li>first item</li><li>second item</li></ul>` 製作一個清單，就像這個一樣。
+* `<div></div>` 定義網頁的一個區域。
+* `<nav></nav>` defines a set of navigation links
+* `<article></article>` specifies independent, self-contained content
+* `<section></section>` defines a section in a document
+* `<header></header>` specifies a header for a document or section
+* `<main></main>` specifies the main content of a document
+* `<aside></aside>` defines some content aside from the content it is placed in (like a sidebar)
+* `<footer></footer>` defines a footer for a document or section
+* `<time></time>` defines a specific time (or datetime)
+
+Here's an example of a full template, copy and paste it into `blog/templates/blog/post_list.html`:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+    </head>
+    <body>
+        <header>
+            <h1><a href="/">Django Girls Blog</a></h1>
+        </header>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My first post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</p>
+        </article>
+
+        <article>
+            <time>published: 14.06.2014, 12:14</time>
+            <h2><a href="">My second post</a></h2>
+            <p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut f.</p>
+        </article>
+    </body>
+</html>
+```
+
+We've created one `header` section and two `article` section here.
+
+* The `header` element contains the title of our blog – it's a heading and a link
+* The two `article` elements contain our blog posts with a published date in a `time` element, a `h2` element with a post title that is clickable and a `p` (paragraph) element for text of our blog post.
+
+它給了我們這樣的效果：
+
+![圖 11.4](images/step6.png)
+
+Yaaay! But so far, our template only ever displays exactly **the same information** – whereas earlier we were talking about templates as allowing us to display **different** information in the **same format**.
+
+What we really want to do is display real posts added in our Django admin – and that's where we're going next.
+
+## 還有一件事：部署！
+
+看到這一切在網際網路上是一件很美好的事，對吧？讓我們做另一個 PythonAnywhere 部署：
+
+### Commit, and push your code up to GitHub
+
+首先，讓我們看看自上次部署後我們修改了那些檔案（執行這些命令在你電腦上，不是在 PythonAnywhere）：
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+Make sure you're in the `djangogirls` directory and let's tell `git` to include all the changes in this directory:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git add .
+    
+
+在我們上傳的所有檔之前，讓我們檢查 `git` 將上傳那些檔案（所有 `git` 將上傳的檔案現在都應以綠色顯示）：
+
+{% filename %}command-line{% endfilename %}
+
+    $ git status
+    
+
+我們差不多完成工作了，現在是時候告訴它把這次改變儲存在它的歷史紀錄中。 我們將給它 "提交訊息"，在裡面我們描述我們已經做了什麼改變。 在這階段，你可以鍵入任何你想要的東西，但鍵入一些描述性的東西更有幫助的，如此，在將來你能想起你做了什麼。
+
+{% filename %}command-line{% endfilename %}
+
+    $ git commit -m "Changed the HTML for the site."
+    
+
+> **Note** Make sure you use double quotes around the commit message.
+
+Once we've done that, we upload (push) our changes up to GitHub:
+
+{% filename %}command-line{% endfilename %}
+
+    $ git push
+    
+
+### 拉取我們新的程式碼到 PythonAnywhere 上，並重新載入你的網站應用程式 (web app)
+
+* 打開 [PythonAnywhere 主控台頁面](https://www.pythonanywhere.com/consoles/)，並到你的 **Bash 主控台 (console)**（或者啟動一個新的）。然後，執行：
+
+{% filename %}PythonAnywhere command-line{% endfilename %}
+
+    $ cd ~/<your-pythonanywhere-domain>.pythonanywhere.com
+    $ git pull
+    [...]
+    
+
+You'll need to substitute `<your-pythonanywhere-domain>` with your actual PythonAnywhere subdomain name, without the angle-brackets. Your subdomain name is normally your PythonAnywhere user name, but in some cases it might be a bit different (such as if your user name contains capital letters). So if this command doesn't work, use the `ls` (list files) command to find your actual subdomain/folder name, and then `cd` to there.
+
+Now watch your code get downloaded. If you want to check that it's arrived, you can hop over to the **"Files" page** and view your code on PythonAnywhere (you can reach other PythonAnywhere pages from the menu button on the console page).
+
+* Finally, hop on over to the ["Web" page](https://www.pythonanywhere.com/web_app_setup/) and hit **Reload** on your web app.
+
+Your update should be live! Go ahead and refresh your website in the browser. Changes should be visible. :)
\ No newline at end of file
diff --git a/zh-TW/install_git.md b/zh-TW/install_git.md
new file mode 100644
index 00000000000..e7d88e0ffb4
--- /dev/null
+++ b/zh-TW/install_git.md
@@ -0,0 +1,52 @@
+Git is a "version control system" used by a lot of programmers. This software can track changes to files over time so that you can recall specific versions later. A bit like the "track changes" feature in Microsoft Word, but much more powerful.
+
+## Installing Git
+
+<!--sec data-title="Installing Git: Windows" data-id="git_install_windows"
+data-collapse=true ces-->
+
+You can download Git from [git-scm.com](https://git-scm.com/). You can hit "next" on all steps except for one; in the fifth step entitled "Adjusting your PATH environment", choose "Use Git and optional Unix tools from the Windows Command Prompt" (the bottom option). Other than that, the defaults are fine. Checkout Windows-style, commit Unix-style line endings is good.
+
+Do not forget to restart the command prompt or powershell after the installation finished successfully. <!--endsec-->
+
+<!--sec data-title="Installing Git: OS X" data-id="git_install_OSX"
+data-collapse=true ces-->
+
+Download Git from [git-scm.com](https://git-scm.com/) and just follow the instructions.
+
+> **Note** If you are running OS X 10.6, 10.7, or 10.8, you will need to install the version of git from here: [Git installer for OS X Snow Leopard](https://sourceforge.net/projects/git-osx-installer/files/git-2.3.5-intel-universal-snow-leopard.dmg/download)
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Debian or Ubuntu" data-id="git_install_debian_ubuntu"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo apt-get install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: Fedora" data-id="git_install_fedora"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo dnf install git
+```
+
+<!--endsec-->
+
+<!--sec data-title="Installing Git: openSUSE" data-id="git_install_openSUSE"
+data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+```bash
+$ sudo zypper install git
+```
+
+<!--endsec-->
\ No newline at end of file
diff --git a/zh-TW/installation/README.md b/zh-TW/installation/README.md
new file mode 100644
index 00000000000..f191185ddb4
--- /dev/null
+++ b/zh-TW/installation/README.md
@@ -0,0 +1,68 @@
+# 假如你是在家裡使用這份教材
+
+If you're doing the tutorial at home, not at one of the [Django Girls events](https://djangogirls.org/events/), you can completely skip this chapter now and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter.
+
+This is because we cover installing things as they are needed in the tutorial -- this is just an additional page that gathers all of the installation instructions in one place (which is useful for some workshop formats). You can choose to install everything that is on this page right now if you wish. But if you want to start learning things before installing a bunch of stuff on your computer, skip this chapter and we will explain the installation parts to you later on, as they are needed.
+
+Good luck!
+
+# 如果你正參加一個工作坊
+
+If you are attending one of the [Django Girls events](https://djangogirls.org/events/):
+
+* Your workshop may have an "installation party" before the main workshop. If you are at an installation party, this page is for you! Follow the instructions here to get everything you need for the workshop installed, with the help of the coaches if needed. Then at the main workshop, you'll be able to skip installation instructions you'll encounter in the main tutorial when you get to them.
+* The organizers of your workshop may have asked you to try at home to install everything on your computer before the workshop starts. If you have been asked to do that, this page is for you! Follow the instructions here, as best you can. Then at the main workshop, when you get to an installation step in the main tutorial, if you were not able to get that piece installed you can get help from your coach.
+* If your workshop does not have an installation party (or you couldn't attend), and if the organizers didn't ask you to try to install everything before you arrived, skip this page and go straight to the [How the Internet works](../how_the_internet_works/README.md) chapter. You'll be installing everything you need as you work through the tutorial.
+
+# 安裝
+
+In this tutorial you will be building a blog. In order to do that, as you go through the tutorial you'll be instructed on how to install various software on your computer and set up some online accounts as they are needed. This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+<!--sec data-title="Chromebook setup (if you're using one)"
+data-id="chromebook_setup" data-collapse=true ces--> {% include "/chromebook_setup/instructions.md" %} 
+
+<!--endsec-->
+
+# Brief intro to the command line {#command-line}
+
+Many of the steps below reference the "console", "terminal", "command window", or "command line" -- these all mean the same thing: a window on your computer where you can enter commands. When you get to the main tutorial, you'll learn more about the command line. For now, the main thing you need to know is how to open a command window and what it looks like: {% include "/intro_to_command_line/open_instructions.md" %}
+
+# 安裝 Python {#python}
+
+{% include "/python_installation/instructions.md" %}
+
+# 安裝一個程式編輯器 {#code-editor}
+
+{% include "/code_editor/instructions.md" %}
+
+# 建立虛擬環境 (Virtualenv) 和安裝 Django {#virtualenv}
+
+{% include "/django_installation/instructions.md" %}
+
+# 安裝 Git {#git}
+
+{% include "/deploy/install_git.md" %}
+
+# Create a GitHub account {#github-account}
+
+Go to [GitHub.com](https://www.github.com) and sign up for a new, free user account. Be sure to remember your password (add it to your password manager, if you use one).
+
+# Create a PythonAnywhere account {#pythonanywhere-account}
+
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+# 開始閱讀
+
+Congratulations, you are all set up and ready to go! If you still have some time before the workshop, it would be useful to start reading a few of the beginning chapters:
+
+* [How the internet works](../how_the_internet_works/README.md)
+
+* [Introduction to the command line](../intro_to_command_line/README.md)
+
+* [Introduction to Python](../python_introduction/README.md)
+
+* [What is Django?](../django/README.md)
+
+# Enjoy the workshop!
+
+When you begin the workshop, you'll be able to go straight to [Your first Django project!](../django_start_project/README.md) because you already covered the material in the earlier chapters.
\ No newline at end of file
diff --git a/zh-TW/instructions.md b/zh-TW/instructions.md
new file mode 100644
index 00000000000..b5a0981698b
--- /dev/null
+++ b/zh-TW/instructions.md
@@ -0,0 +1,31 @@
+There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner, however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
+
+Our suggestions are below, but feel free to ask your coach what their preferences are – it'll be easier to get help from them.
+
+## Gedit
+
+Gedit is an open-source, free editor, available for all operating systems.
+
+[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
+
+## Sublime Text 3
+
+Sublime Text is a very popular editor with a free evaluation period. It's easy to install and use, and it's available for all operating systems.
+
+[Download it here](https://www.sublimetext.com/3)
+
+## Atom
+
+Atom is an extremely new code editor created by [GitHub](https://github.com/). It's free, open-source, easy to install and easy to use. It's available for Windows, OS X and Linux.
+
+[Download it here](https://atom.io/)
+
+## Why are we installing a code editor?
+
+You might be wondering why we are installing this special code editor software, rather than using something like Word or Notepad.
+
+The first reason is that code needs to be **plain text**, and the problem with programs like Word and Textedit is that they don't actually produce plain text, they produce rich text (with fonts and formatting), using custom formats like [RTF (Rich Text Format)](https://en.wikipedia.org/wiki/Rich_Text_Format).
+
+The second reason is that code editors are specialized for editing code, so they can provide helpful features like highlighting code with color according to its meaning, or automatically closing quotes for you.
+
+We'll see all this in action later. Soon, you'll come to think of your trusty old code editor as one of your favorite tools. :)
\ No newline at end of file
diff --git a/zh-TW/intro_to_command_line/README.md b/zh-TW/intro_to_command_line/README.md
new file mode 100644
index 00000000000..f692bd42b78
--- /dev/null
+++ b/zh-TW/intro_to_command_line/README.md
@@ -0,0 +1,441 @@
+# 命令行介面簡介
+
+> For readers at home: this chapter is covered in the [Your new friend: Command Line](https://www.youtube.com/watch?v=jvZLWhkzX-8) video.
+
+It's exciting, right?! You'll write your first line of code in just a few minutes! :)
+
+**容我們為你介紹你的第一個新朋友：命令行！**
+
+接下來的步驟將會為你示範如何使用這個駭客們都一定要使用的黑畫面。這或許第一次看起來有點可怕，但其實不過就是一個閃爍的小游標在等著你下命令給它啦。
+
+> **Note** Please note that throughout this book we use the terms 'directory' and 'folder' interchangeably but they are one and the same thing.
+
+## 什麼是命令行？
+
+這個視窗，就是通常被稱為 **命令行** 或 **命令行介面** 的東西，這是一個以文字為主的應用程式，可以查看、處理並且控制你電腦裡的檔案們。 It's much like Windows Explorer or Finder on the Mac, but without the graphical interface. 還有其他稱呼像是 *cmd*, *CLT*, *prompt*, *console* 或是 *terminal*.
+
+## 打開命令行介面
+
+To start some experiments we need to open our command-line interface first.
+
+{% include "/intro_to_command_line/open_instructions.md" %}
+
+## 命令提示字元
+
+You now should see a white or black window that is waiting for your commands.
+
+<!--sec data-title="Prompt: OS X and Linux" data-id="OSX_Linux_prompt" data-collapse=true ces-->
+
+If you're on Mac or Linux, you probably see a `$`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $
+    
+
+<!--endsec-->
+
+<!--sec data-title="Prompt: Windows" data-id="windows_prompt2" data-collapse=true ces-->
+
+On Windows, you probably see a `>`, like this:
+
+{% filename %}command-line{% endfilename %}
+
+    >
+    
+
+Take a look at the Linux section just above now -- you'll see something more like that when you get to PythonAnywhere later in the tutorial.
+
+<!--endsec-->
+
+Each command will be prepended by a `$` or `>` and one space, but you should not type it. Your computer will do it for you. :)
+
+> Just a small note: in your case there may be something like `C:\Users\ola>` or `Olas-MacBook-Air:~ ola$` before the prompt sign, and this is 100% OK.
+
+The part up to and including the `$` or the `>` is called the *command line prompt*, or *prompt* for short. It prompts you to input something there.
+
+In the tutorial, when we want you to type in a command, we will include the `$` or `>`, and occasionally more to the left. Ignore the left part and only type in the command, which starts after the prompt.
+
+## 你的第一個命令 (耶!)
+
+Let's start by typing this command:
+
+<!--sec data-title="Your first command: OS X and Linux" data-id="OSX_Linux_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    
+
+<!--endsec-->
+
+<!--sec data-title="Your first command: Windows" data-id="windows_whoami" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > whoami
+    
+
+<!--endsec-->
+
+And then hit `enter`. This is our result:
+
+{% filename %}command-line{% endfilename %}
+
+    $ whoami
+    olasitarska
+    
+
+As you can see, the computer has just printed your username. Neat, huh? :)
+
+> Try to type each command; do not copy-paste. You'll remember more this way!
+
+## 基礎
+
+Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions for your operating system. Let's try this, shall we?
+
+### 目前路徑
+
+It'd be nice to know where are we now, right? Let's see. Type this command and hit `enter`:
+
+<!--sec data-title="Current directory: OS X and Linux" data-id="OSX_Linux_pwd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska
+    
+
+> Note: 'pwd' stands for 'print working directory'.
+
+<!--endsec-->
+
+<!--sec data-title="Current directory: Windows" data-id="windows_cd" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska
+    
+
+> Note: 'cd' stands for 'change directory'. With PowerShell you can use pwd just like on Linux or Mac OS X.
+
+<!--endsec-->
+
+You'll probably see something similar on your machine. Once you open the command line you usually start at your user's home directory.
+
+* * *
+
+### Learn more about a command
+
+Many commands you can type at the command prompt have built-in help that you can display and read! For example, to learn more about the current directory command:
+
+<!--sec data-title="Command help: OS X and Linux" data-id="OSX_Linux_man" data-collapse=true ces-->
+
+OS X and Linux have a `man` command, which gives you help on commands. Try `man pwd` and see what it says, or put `man` before other commands to see their help. The output of `man` is normally paged. Use the space bar to move to the next page, and `q` to quit looking at the help.
+
+<!--endsec-->
+
+<!--sec data-title="Command Help: Windows" data-id="windows_help" data-collapse=true ces-->
+
+Adding a `/?` suffix to most commands will print the help page. You may need to scroll your command window up to see it all. Try `cd /?`.
+
+<!--endsec-->
+
+### List files and directories
+
+So what's in it? It'd be cool to find out. Let's see:
+
+<!--sec data-title="List files and directories: OS X and Linux" data-id="OSX_Linux_ls" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    Applications
+    Desktop
+    Downloads
+    Music
+    ...
+    
+
+<!--endsec-->
+
+<!--sec data-title="List files and directories: Windows" data-id="windows_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+     Directory of C:\Users\olasitarska
+    05/08/2020 07:28 PM <DIR>      Applications
+    05/08/2020 07:28 PM <DIR>      Desktop
+    05/08/2020 07:28 PM <DIR>      Downloads
+    05/08/2020 07:28 PM <DIR>      Music
+    ...
+    
+
+> Note: In PowerShell you can also use 'ls' like on Linux and Mac OS X. <!--endsec-->
+
+* * *
+
+### Change current directory
+
+Now, let's go to our Desktop directory:
+
+<!--sec data-title="Change current directory: OS X" data-id="OSX_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Linux" data-id="Linux_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd Desktop
+    
+
+Note that the directory name "Desktop" might be translated to the language of your Linux account. If that's the case, you'll need to replace `Desktop` with the translated name; for example, `Schreibtisch` for German.
+
+<!--endsec-->
+
+<!--sec data-title="Change current directory: Windows" data-id="windows_move_to" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd Desktop
+    
+
+<!--endsec-->
+
+Check if it's really changed:
+
+<!--sec data-title="Check if changed: OS X and Linux" data-id="OSX_Linux_pwd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check if changed: Windows" data-id="windows_cd2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Here it is!
+
+> PRO tip: if you type `cd D` and then hit `tab` on your keyboard, the command line will automatically fill in the rest of the name so you can navigate faster. If there is more than one folder starting with "D", hit the `tab` key twice to get a list of options.
+
+* * *
+
+### Create directory
+
+How about creating a practice directory on your desktop? You can do it this way:
+
+<!--sec data-title="Create directory: OS X and Linux" data-id="OSX_Linux_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ mkdir practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Create directory: Windows" data-id="windows_mkdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > mkdir practice
+    
+
+<!--endsec-->
+
+This little command will create a folder with the name `practice` on your desktop. You can check if it's there by looking on your Desktop or by running a `ls` or `dir` command! Try it. :)
+
+> PRO tip: If you don't want to type the same commands over and over, try pressing the `up arrow` and `down arrow` on your keyboard to cycle through recently used commands.
+
+* * *
+
+### Exercise!
+
+A small challenge for you: in your newly created `practice` directory, create a directory called `test`. (Use the `cd` and `mkdir` commands.)
+
+#### 解答：
+
+<!--sec data-title="Exercise solution: OS X and Linux" data-id="OSX_Linux_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd practice
+    $ mkdir test
+    $ ls
+    test
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exercise solution: Windows" data-id="windows_test_dir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd practice
+    > mkdir test
+    > dir
+    05/08/2020 07:28 PM <DIR>      test
+    
+
+<!--endsec-->
+
+Congrats! :)
+
+* * *
+
+### Clean up
+
+We don't want to leave a mess, so let's remove everything we did until that point.
+
+First, we need to get back to Desktop:
+
+<!--sec data-title="Clean up: OS X and Linux" data-id="OSX_Linux_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ..
+    
+
+<!--endsec-->
+
+<!--sec data-title="Clean up: Windows" data-id="windows_back" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd ..
+    
+
+<!--endsec-->
+
+Using `..` with the `cd` command will change your current directory to the parent directory (that is, the directory that contains your current directory).
+
+Check where you are:
+
+<!--sec data-title="Check location: OS X and Linux" data-id="OSX_Linux_pwd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ pwd
+    /Users/olasitarska/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check location: Windows" data-id="windows_cd3" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > cd
+    C:\Users\olasitarska\Desktop
+    
+
+<!--endsec-->
+
+Now time to delete the `practice` directory:
+
+> **Attention**: Deleting files using `del`, `rmdir` or `rm` is irrecoverable, meaning *the deleted files will be gone forever*! So be very careful with this command.
+
+<!--sec data-title="Delete directory: Windows Powershell, OS X and Linux" data-id="OSX_Linux_rm" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ rm -r practice
+    
+
+<!--endsec-->
+
+<!--sec data-title="Delete directory: Windows Command Prompt" data-id="windows_rmdir" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > rmdir /S practice
+    practice, Are you sure <Y/N>? Y
+    
+
+<!--endsec-->
+
+Done! To be sure it's actually deleted, let's check it:
+
+<!--sec data-title="Check deletion: OS X and Linux" data-id="OSX_Linux_ls2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ ls
+    
+
+<!--endsec-->
+
+<!--sec data-title="Check deletion: Windows" data-id="windows_dir2" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > dir
+    
+
+<!--endsec-->
+
+### Exit
+
+That's it for now! You can safely close the command line now. Let's do it the hacker way, alright? :)
+
+<!--sec data-title="Exit: OS X and Linux" data-id="OSX_Linux_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    $ exit
+    
+
+<!--endsec-->
+
+<!--sec data-title="Exit: Windows" data-id="windows_exit" data-collapse=true ces-->
+
+{% filename %}command-line{% endfilename %}
+
+    > exit
+    
+
+<!--endsec-->
+
+Cool, huh? :)
+
+## 彙總
+
+Here is a summary of some useful commands:
+
+| 指令 (Windows)   | 指令 (Mac OS / Linux) | 描述                         | 例子                                                 |
+| -------------- | ------------------- | -------------------------- | -------------------------------------------------- |
+| exit           | exit                | 關閉視窗                       | **exit**                                           |
+| cd             | cd                  | 改變目錄                       | **cd test**                                        |
+| cd             | pwd                 | show the current directory | **cd** (Windows) or **pwd** (Mac OS / Linux)       |
+| dir            | ls                  | 列出目錄/檔案                    | **dir**                                            |
+| copy           | cp                  | 複製檔案                       | **copy c:\test\test.txt c:\windows\test.txt**  |
+| move           | mv                  | 移動檔案                       | **move c:\test\test.txt c:\windows\test.txt**  |
+| mkdir          | mkdir               | 創建新目錄                      | **mkdir testdirectory**                            |
+| rmdir (or del) | rm                  | delete a file              | **del c:\test\test.txt**                         |
+| rmdir /S       | rm -r               | delete a directory         | **rm -r testdirectory**                            |
+| [CMD] /?       | man [CMD]           | get help for a command     | **cd /?** (Windows) or **man cd** (Mac OS / Linux) |
+
+These are just a very few of the commands you can run in your command line, but you're not going to use anything more than that today.
+
+If you're curious, [ss64.com](http://ss64.com) contains a complete reference of commands for all operating systems.
+
+## 準備好了嗎？
+
+Let's dive into Python!
\ No newline at end of file
diff --git a/zh-TW/intro_to_command_line/open_instructions.md b/zh-TW/intro_to_command_line/open_instructions.md
new file mode 100644
index 00000000000..c4d21aa67e4
--- /dev/null
+++ b/zh-TW/intro_to_command_line/open_instructions.md
@@ -0,0 +1,28 @@
+<!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
+
+Depending on your version of Windows and your keyboard, one of the following should open a command window (you may have to experiment a bit, but you don't have to try all of these suggestions):
+
+- Go to the Start menu or screen, and enter "Command Prompt" in the search field.
+- Go to Start menu → Windows System → Command Prompt.
+- Go to Start menu → All Programs → Accessories → Command Prompt.
+- Go to the Start screen, hover your mouse in the lower-left corner of the screen, and click the down arrow that appears (on a touch screen, instead flick up from the bottom of the screen). The Apps page should open. Click on Command Prompt in the Windows System section.
+- Hold the special Windows key on your keyboard and press the "X" key. Choose "Command Prompt" from the pop-up menu.
+- Hold the Windows key and press the "R" key to get a "Run" window. Type "cmd" in the box, and click the OK key.
+
+![Type "cmd" in the "Run" window](../python_installation/images/windows-plus-r.png)
+
+Later in this tutorial, you will need to have two command windows open at the same time. However, on some versions of Windows, if you already have one command window open and you try to open a second one using the same method, it will instead point you to the command window you already have open. Try it now on your computer and see what happens! If you only get one command window, try one of the other methods in the list above. At least one of them should result in a new command window being opened.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: OS X" data-id="OSX_prompt" data-collapse=true ces-->
+
+Go to Applications → Utilities → Terminal.
+
+<!--endsec-->
+
+<!--sec data-title="Opening: Linux" data-id="linux_prompt" data-collapse=true ces-->
+
+It's probably under Applications → Accessories → Terminal, or Applications → System → Terminal, but that may depend on your system. If it's not there, you can try to Google it. :)
+
+<!--endsec-->
\ No newline at end of file
diff --git a/zh-TW/python_installation/README.md b/zh-TW/python_installation/README.md
new file mode 100644
index 00000000000..687f2336f4f
--- /dev/null
+++ b/zh-TW/python_installation/README.md
@@ -0,0 +1,15 @@
+# 讓我們從 Python 開始吧
+
+我們終於到了這裡！
+
+但是首先，讓我們告訴你什麼是 Python。Python 是一種非常流行的程式設計語言，可以用來創建網站、 遊戲、 科學軟體、 圖形和很多，更多。
+
+Python 起源于 1980 年代後期，其主要目標是針對人類的高可讀性 (不只是機器！)。 This is why it looks simpler than other programming languages, but don't worry – Python is also really powerful!
+
+# Python 安裝
+
+> **Note** If you're using a Chromebook, skip this chapter and make sure you follow the [Chromebook Setup](../chromebook_setup/README.md) instructions.
+> 
+> **Note** If you already worked through the [installation steps](../installation/README.md), there's no need to do this again – you can skip straight ahead to the next chapter!
+
+{% include "/python_installation/instructions.md" %}
\ No newline at end of file
diff --git a/zh-TW/python_installation/instructions.md b/zh-TW/python_installation/instructions.md
new file mode 100644
index 00000000000..592aafe0b5d
--- /dev/null
+++ b/zh-TW/python_installation/instructions.md
@@ -0,0 +1,117 @@
+> For readers at home: this chapter is covered in the [Installing Python & Code Editor](https://www.youtube.com/watch?v=pVTaqzKZCdA) video.
+> 
+> This section is based on a tutorial by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)
+
+Django is written in Python. We need Python to do anything in Django. Let's start by installing it! We want you to install the latest version of Python 3, so if you have any earlier version, you will need to upgrade it. If you already have version {{ book.py_min_version }} or higher you should be fine.
+
+Please install normal Python as follows, even when you have Anaconda installed on your computer.
+
+<!--sec data-title="Install Python: Windows" data-id="python_windows" data-collapse=true ces-->
+
+First check whether your computer is running a 32-bit version or a 64-bit version of Windows, on the "System type" line of the System Info page. To reach this page, try one of these methods:
+
+* Press the Windows key and Pause/Break key at the same time
+* Open your Control Panel from the Windows menu, then navigate to System & Security, then System
+* Press the Windows button, then navigate to Settings > System > About
+* Search the Windows Start menu for "System Information". To do that, click the Start button or press the Windows key, then begin to type `System Information`. It will start making suggestions as soon as you type. You can select the entry once it shows up.
+
+You can download Python for Windows from the website https://www.python.org/downloads/windows/. Click on the "Latest Python 3 Release - Python x.x.x" link. If your computer is running a **64-bit** version of Windows, download the **Windows x86-64 executable installer**. Otherwise, download the **Windows x86 executable installer**. After downloading the installer, you should run it (double-click on it) and follow the instructions there.
+
+One thing to watch out for: During the installation, you will notice a window marked "Setup". Make sure you tick the "Add Python {{ book.py_version }} to PATH" or 'Add Python to your environment variables" checkbox and click on "Install Now", as shown here (it may look a bit different if you are installing a different version):
+
+![Don't forget to add Python to the Path](../python_installation/images/python-installation-options.png)
+
+When the installation completes, you may see a dialog box with a link you can follow to learn more about Python or about the version you installed. Close or cancel that dialog -- you'll be learning more in this tutorial!
+
+Note: If you are using an older version of Windows (7, Vista, or any older version) and the Python {{ book.py_version }} installer fails with an error, then install all Windows Updates and try to install Python again. If you still have the error, try installing Python version {{ book.py_min_release }} from [Python.org](https://www.python.org/downloads/windows/).
+
+> Django {{ book.django_version }} needs Python {{ book.py_min_version }} or greater, which does not support Windows XP or earlier versions.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+> **Note** Before you install Python on OS X, you should ensure your Mac settings allow installing packages that aren't from the App Store. Go to System Preferences (it's in the Applications folder), click "Security & Privacy," and then the "General" tab. If your "Allow apps downloaded from:" is set to "Mac App Store," change it to "Mac App Store and identified developers."
+
+You need to go to the website https://www.python.org/downloads/mac-osx/ and download the latest Python installer:
+
+* Download the *Mac OS X 64-bit/32-bit installer* file,
+* Double click *python-{{ book.py_release }}-macosx10.9.pkg* to run the installer.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it is), open a console and type the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+If you have a different version of Python installed, at least {{ book.py_min_version }} (e.g. {{ book.py_min_release }}), then you don't have to upgrade. If you don't have Python installed, or if you want a different version, first check what Linux distribution you are using with the following command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ grep '^NAME=' /etc/os-release
+    
+
+Afterwards, depending on the result, follow one of the following installation guides below this section.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Debian or Ubuntu" data-id="python_debian" data-collapse=true ces-->
+
+Type this command into your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo apt install python3
+    
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: Fedora" data-id="python_fedora"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo dnf install python3
+    
+
+If you're on older Fedora versions you might get an error that the command `dnf` is not found. In that case, you need to use `yum` instead.
+
+<!--endsec-->
+
+<!--sec data-title="Install Python: openSUSE" data-id="python_openSUSE"
+data-collapse=true ces-->
+
+Use this command in your console:
+
+{% filename %}command-line{% endfilename %}
+
+    $ sudo zypper install python3
+    
+
+<!--endsec-->
+
+Verify the installation was successful by opening a command prompt and running the `python3` command:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 --version
+    Python {{ book.py_release }}
+    
+
+The version shown may be different from {{ book.py_release }} -- it should match the version you installed.
+
+**NOTE:** If you're on Windows and you get an error message that `python3` wasn't found, try using `python` (without the `3`) and check if it still might be a version of Python that is {{ book.py_min_version }} or higher. If that doesn't work either, you may open a new command prompt and try again; this happens if you use a command prompt left open from before the Python installation.
+
+* * *
+
+If you have any doubts, or if something went wrong and you have no idea what to do next, please ask your coach! Sometimes things don't go smoothly and it's better to ask for help from someone with more experience.
\ No newline at end of file
diff --git a/zh-TW/python_introduction/README.md b/zh-TW/python_introduction/README.md
new file mode 100644
index 00000000000..85d392c73d8
--- /dev/null
+++ b/zh-TW/python_introduction/README.md
@@ -0,0 +1,1072 @@
+{% set warning_icon = '<span class="glyphicon glyphicon-exclamation-sign" style="color: red;" aria-hidden="true" data-toggle="tooltip" title="An error is expected when you run this command!" ></span>' %}
+
+# Python 簡介
+
+> Part of this chapter is based on tutorials by Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
+
+Let's write some code!
+
+## Python 提示字元
+
+> For readers at home: this part is covered in the [Python Basics: Integers, Strings, Lists, Variables and Errors](https://www.youtube.com/watch?v=MO63L4s-20U) video.
+
+To start playing with Python, we need to open up a *command line* on your computer. You should already know how to do that – you learned it in the [Intro to Command Line](../intro_to_command_line/README.md) chapter.
+
+Once you're ready, follow the instructions below.
+
+We want to open up a Python console, so type in `python` on Windows or `python3` on Mac OS/Linux and hit `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3
+    Python {{ book.py_release }} (...)
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>>
+    
+
+## 你第一個的 Python 命令！
+
+After running the Python command, the prompt changed to `>>>`. For us this means that for now we may only use commands in the Python language. You don't have to type in `>>>` – Python will do that for you.
+
+If you want to exit the Python console at any point, type `exit()` or use the shortcut `Ctrl + Z` for Windows and `Ctrl + D` for Mac/Linux. Then you won't see `>>>` any longer.
+
+For now, we don't want to exit the Python console. We want to learn more about it. Let's start by typing some math, like `2 + 3` and hitting `enter`.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 + 3 
+5
+```
+
+Nice! See how the answer popped out? Python knows math! You could try other commands like:
+
+- `4 * 5`
+- `5 - 1`
+- `40 / 2`
+
+To perform exponential calculation, say 2 to the power 3, we type: {% filename %}command-line{% endfilename %}
+
+```python
+>>> 2 ** 3
+8
+```
+
+Have fun with this for a little while and then get back here. :)
+
+As you can see, Python is a great calculator. If you're wondering what else you can do…
+
+## 字串
+
+How about your name? Type your first name in quotes like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola"
+'Ola'
+```
+
+You've now created your first string! It's a sequence of characters that can be processed by a computer. The string must always begin and end with the same character. This may be single (`'`) or double (`"`) quotes (there is no difference!) The quotes tell Python that what's inside of them is a string.
+
+Strings can be strung together. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Hi there " + "Ola"
+'Hi there Ola'
+```
+
+You can also multiply strings with a number:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola" * 3
+'OlaOlaOla'
+```
+
+If you need to put an apostrophe inside your string, you have two ways to do it.
+
+Using double quotes:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Runnin' down the hill"
+"Runnin' down the hill"
+```
+
+or escaping the apostrophe with a backslash (``):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 'Runnin\' down the hill'
+"Runnin' down the hill"
+```
+
+Nice, huh? To see your name in uppercase letters, type:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> "Ola".upper()
+'OLA'
+```
+
+You just used the `upper` **method** on your string! A method (like `upper()`) is a sequence of instructions that Python has to perform on a given object (`"Ola"`) once you call it.
+
+If you want to know the number of letters contained in your name, there is a **function** for that too!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len("Ola")
+3
+```
+
+Wonder why sometimes you call functions with a `.` at the end of a string (like `"Ola".upper()`) and sometimes you first call a function and place the string in parentheses? Well, in some cases, functions belong to objects, like `upper()`, which can only be performed on strings. In this case, we call the function a **method**. Other times, functions don't belong to anything specific and can be used on different types of objects, just like `len()`. That's why we're giving `"Ola"` as a parameter to the `len` function.
+
+### 彙總
+
+OK, enough of strings. So far you've learned about:
+
+- **the prompt** – typing commands (code) into the Python prompt results in answers in Python
+- **numbers and strings** – in Python numbers are used for math and strings for text objects
+- **operators** – like `+` and `*`, combine values to produce a new one
+- **functions** – like `upper()` and `len()`, perform actions on objects.
+
+These are the basics of every programming language you learn. Ready for something harder? We bet you are!
+
+## 錯誤訊息
+
+Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type in `len(304023)` and hit `enter`:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> len(304023)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: object of type 'int' has no len()
+```
+
+We got our first error! The {{ warning_icon }} icon is our way of giving you a heads up that the code you are about to run won't work as expected. Making mistakes (even intentional ones) are an important part of learning!
+
+It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now? Maybe we can write our number as a string? Strings have a length, right?
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(str(304023))
+6
+```
+
+It worked! We used the `str` function inside of the `len` function. `str()` converts everything to strings.
+
+- `str` 函數可將物件轉為 **字串**
+- `int` 函數可將物件轉為 **整數**
+
+> Important: we can convert numbers into text, but we can't necessarily convert text into numbers – what would `int('hello')` be anyway?
+
+## 變數
+
+An important concept in programming is variables. A variable is nothing more than a name for something so you can use it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep remembering what things are.
+
+Let's say we want to create a new variable called `name`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Ola"
+```
+
+We type name equals Ola.
+
+As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually exists? Enter `name` and hit `enter`:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name
+'Ola'
+```
+
+Yippee! Your first variable! :) You can always change what it refers to:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = "Sonja"
+>>> name
+'Sonja'
+```
+
+You can use it in functions too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(name)
+5
+```
+
+Awesome, right? Now, variables can be anything – numbers too! Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 4
+>>> b = 6
+>>> a * b
+24
+```
+
+But what if we used the wrong name? Can you guess what would happen? Let's try!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> city = "Tokyo"
+>>> ctiy
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+NameError: name 'ctiy' is not defined
+```
+
+An error! As you can see, Python has different types of errors and this one is called a **NameError**. Python will give you this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if you've mistyped any names.
+
+Play with this for a while and see what you can do!
+
+## Print 函數
+
+Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> name = 'Maria'
+>>> name
+'Maria'
+>>> print(name)
+Maria
+```
+
+When you just type `name`, the Python interpreter responds with the string *representation* of the variable 'name', which is the letters M-a-r-i-a, surrounded by single quotes, ''. When you say `print(name)`, Python will "print" the contents of the variable to the screen, without the quotes, which is neater.
+
+As we'll see later, `print()` is also useful when we want to print things from inside functions, or when we want to print things on multiple lines.
+
+## 清單
+
+Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called **list**. Lists are exactly what you think they are: objects which are lists of other objects. :)
+
+Go ahead and create a list:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> []
+[]
+```
+
+Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the time, so we will put it in a variable, too:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery = [3, 42, 12, 19, 30, 59]
+```
+
+All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any idea which function you should use for that? You know this already!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(lottery)
+6
+```
+
+Yes! `len()` can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.sort()
+```
+
+This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and see what happened:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[3, 12, 19, 30, 42, 59]
+```
+
+As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
+
+Maybe we want to reverse that order? Let's do that!
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.reverse()
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3]
+```
+
+If you want to add something to your list, you can do this by typing this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> lottery.append(199)
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+```
+
+If you want to show only the first number, you can do this by using **indexes**. An index is the number that says where in a list an item occurs. Programmers prefer to start counting at 0, so the first object in your list is at index 0, the next one is at 1, and so on. Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery[0])
+59
+>>> print(lottery[1])
+42
+```
+
+As you can see, you can access different objects in your list by using the list's name and the object's index inside of square brackets.
+
+To delete something from your list you will need to use **indexes** as we learned above and the `pop()` method. Let's try an example and reinforce what we learned previously; we will be deleting the first number of our list.
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(lottery)
+[59, 42, 30, 19, 12, 3, 199]
+>>> print(lottery[0])
+59
+>>> lottery.pop(0)
+59
+>>> print(lottery)
+[42, 30, 19, 12, 3, 199]
+```
+
+That worked like a charm!
+
+For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the command. Do the results make sense?
+
+You can find a list of all available list methods in this chapter of the Python documentation: https://docs.python.org/3/tutorial/datastructures.html
+
+## 字典
+
+> For readers at home: this part is covered in the [Python Basics: Dictionaries](https://www.youtube.com/watch?v=ZX1CVvZLE6c) video.
+
+A dictionary is similar to a list, but you access values by looking up a key instead of a numeric index. A key can be any string or number. The syntax to define an empty dictionary is:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> {}
+{}
+```
+
+This shows that you just created an empty dictionary. Hurray!
+
+Now, try writing the following command (try substituting your own information, too):
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
+```
+
+With this command, you just created a variable named `participant` with three key–value pairs:
+
+- Name 這個 `key` 對應到 `'Ola'` 這個 value (一個 `字串` 物件),
+- `country` 對應到 `'Poland'` (另一個 `字串`),
+- 還有 `favorite_numbers` 對應到 `[7, 42, 92]` (一個包含了三個數字在內的 `清單`)。
+
+You can check the content of individual keys with this syntax:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> print(participant['name'])
+Ola
+```
+
+See, it's similar to a list. But you don't need to remember the index – just the name.
+
+What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> participant['age']
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+KeyError: 'age'
+```
+
+Look, another error! This one is a **KeyError**. Python is helpful and tells you that the key `'age'` doesn't exist in this dictionary.
+
+When should you use a dictionary or a list? Well, that's a good point to ponder. Think about the answer before looking at it in the next line.
+
+- 你是不是只是需要一個有序的序列呢？就使用 List 吧。
+- 你需要有 key 值的 value，好讓你可以更有效率地 (使用 key) 找到特定值嗎？那就使用 Dictionary 吧。
+
+Dictionaries, like lists, are *mutable*, meaning that they can be changed after they are created. You can add new key–value pairs to a dictionary after it is created, like this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['favorite_language'] = 'Python'
+```
+
+Like lists, using the `len()` function on the dictionaries returns the number of key–value pairs in the dictionary. Go ahead and type in this command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> len(participant)
+4
+```
+
+I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Read on for some amazing things.
+
+You can use the `pop()` method to delete an item in the dictionary. Say, if you want to delete the entry corresponding to the key `'favorite_numbers'`, type in the following command:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant.pop('favorite_numbers')
+[7, 42, 92]
+>>> participant
+{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see from the output, the key–value pair corresponding to the 'favorite_numbers' key has been deleted.
+
+As well as this, you can also change a value associated with an already-created key in the dictionary. Type this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> participant['country'] = 'Germany'
+>>> participant
+{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
+```
+
+As you can see, the value of the key `'country'` has been altered from `'Poland'` to `'Germany'`. :) Exciting? Hurrah! You just learned another amazing thing.
+
+### 彙總
+
+Awesome! You know a lot about programming now. In this last part you learned about:
+
+- **errors** – you now know how to read and understand errors that show up if Python doesn't understand a command you've given it
+- **variables** – names for objects that allow you to code more easily and to make your code more readable
+- **lists** – lists of objects stored in a particular order
+- **dictionaries** – objects stored as key–value pairs
+
+Excited for the next part? :)
+
+## 比較事物
+
+> For readers at home: this part is covered in the [Python Basics: Comparisons](https://www.youtube.com/watch?v=7bzxqIKYgf4) video.
+
+A big part of programming involves comparing things. What's the easiest thing to compare? Numbers! Let's see how that works:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 5 > 2
+True
+>>> 3 < 1
+False
+>>> 5 > 2 * 2
+True
+>>> 1 == 1
+True
+>>> 5 != 2
+True
+>>> len([1, 2, 3]) > len([4, 5])
+True
+```
+
+We gave Python some numbers to compare. As you can see, not only can Python compare numbers, but it can also compare values of mathematical expressions like `2 * 2` and function results like the `2` returned by `len([4, 5])`. Nice, huh?
+
+Do you wonder why we put two equal signs `==` next to each other to compare if numbers are equal? We use a single `=` for assigning values to variables. You always, **always** need to put two of them – `==` – if you want to check if things are equal to each other. We can also state that things are unequal to each other. For that, we use the symbol `!=`, as shown in the example above.
+
+Give Python two more tasks:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 >= 12 / 2
+True
+>>> 3 <= 2
+False
+```
+
+We've seen `>` and `<`, but what do `>=` and `<=` mean? Read them like this:
+
+- x `>` y 表示：x 大於 y
+- x `<` y 表示：x 小於 y
+- x `<=` y 表示：x 小於或等於 y
+- x `>=` y 表示：x 大於或等於 y
+
+Awesome! Wanna do one more? Try this:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> 6 > 2 and 2 < 3
+True
+>>> 3 > 2 and 2 < 1
+False
+>>> 3 > 2 or 2 < 1
+True
+```
+
+You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
+
+- **and** – if you use the `and` operator, both comparisons have to be True in order for the whole command to be True
+- **or** – if you use the `or` operator, only one of the comparisons has to be True in order for the whole command to be True
+
+Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+```python
+>>> 1 > 'django'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Here you see that just like in the expression, Python is not able to compare a number (`int`) and a string (`str`). Instead, it shows a **TypeError** and tells us the two types can't be compared together.
+
+## 布林值 (Boolean)
+
+Incidentally, you just learned about a new type of object in Python. It's called **Boolean**.
+
+There are only two Boolean objects:
+
+- True
+- False
+
+But for Python to understand this, you need to always write it as 'True' (first letter uppercase, with the rest of the letters lowercased). **true, TRUE, and tRUE won't work – only True is correct.** (The same applies to 'False' as well.)
+
+Booleans can be variables, too! See here:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = True
+>>> a
+True
+```
+
+You can also do it this way:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> a = 2 > 5
+>>> a
+False
+```
+
+Practice and have fun with Booleans by trying to run the following commands:
+
+- `True and True`
+- `False and True`
+- `True or 1 == 1`
+- `1 != 2`
+
+Congrats! Booleans are one of the coolest features in programming, and you just learned how to use them!
+
+# 儲存它！(Save it!)
+
+> For readers at home: this part is covered in the [Python Basics: Saving files and "If" statement](https://www.youtube.com/watch?v=dOAg6QVAxyk) video.
+
+So far we've been writing all our python code in the interpreter, which limits us to entering one line of code at a time. Normal programs are saved in files and executed by our programming language **interpreter** or **compiler**. So far we've been running our programs one line at a time in the Python **interpreter**. We're going to need more than one line of code for the next few tasks, so we'll quickly need to:
+
+- 離開 Python 解譯器
+- 打開我們選擇的程式碼編輯器
+- 儲存一些程式碼到一個新的 python 檔
+- 執行它！
+
+To exit from the Python interpreter that we've been using, type the `exit()` function
+
+{% filename %}command-line{% endfilename %}
+
+```python
+>>> exit()
+$
+```
+
+This will put you back into the command prompt.
+
+Earlier, we picked out a code editor from the [code editor](../code_editor/README.md) section. We'll need to open the editor now and write some code into a new file (or if you're using a Chromebook, create a new file in the cloud IDE and open the file, which will be in the included code editor):
+
+{% filename %}editor{% endfilename %}
+
+```python
+print('Hello, Django girls!')
+```
+
+Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
+
+Now we need to save the file and give it a descriptive name. Let's call the file **python_intro.py** and save it to your desktop. We can name the file anything we want, but the important part here is to make sure the file ends in **.py**. The **.py** extension tells our operating system that this is a **Python executable file** and Python can run it.
+
+> **Note** You should notice one of the coolest thing about code editors: colors! In the Python console, everything was the same color; now you should see that the `print` function is a different color from the string. 這就所謂的 ”語法強調”，在編寫程式碼時是非常有用的功能。 The color of things will give you hints, such as unclosed strings or a typo in a keyword name (like the `def` in a function, which we'll see below). 這是我們使用程式碼編輯器中的的原因之一. :)
+
+With the file saved, it's time to run it! Using the skills you've learned in the command line section, use the terminal to **change directories** to the desktop.
+
+<!--sec data-title="Change directory: OS X" data-id="python_OSX"
+data-collapse=true ces-->
+
+On a Mac, the command will look something like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Linux" data-id="python_linux"
+data-collapse=true ces-->
+
+On Linux, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ cd ~/Desktop
+    
+
+(Remember that the word "Desktop" might be translated to your local language.)
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Command Prompt" data-id="python_windows" data-collapse=true ces-->
+
+On Windows Command Prompt, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd %HomePath%\Desktop
+    
+
+<!--endsec-->
+
+<!--sec data-title="Change directory: Windows Powershell" data-id="python_windowsPSH" data-collapse=true ces-->
+
+And on Windows Powershell, it will be like this:
+
+{% filename %}command-line{% endfilename %}
+
+    > cd $Home\Desktop
+    
+
+<!--endsec-->
+
+If you get stuck, ask for help. That's exactly what the coaches are here for!
+
+Now use Python to execute the code in the file like this:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hello, Django girls!
+    
+
+Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+> python python_intro.py
+```
+
+Alright! You just ran your first Python program that was saved to a file. Feel awesome?
+
+You can now move on to an essential tool in programming:
+
+## If … elif … else
+
+Lots of things in code should be executed only when given conditions are met. That's why Python has something called **if statements**.
+
+Replace the code in your **python_intro.py** file with this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+```
+
+If we were to save and run this, we'd see an error like this:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    File "python_intro.py", line 2
+             ^
+    SyntaxError: unexpected EOF while parsing
+    
+
+Python expects us to give further instructions to it which are executed if the condition `3 > 2` turns out to be true (or `True` for that matter). Let’s try to make Python print “It works!”. Change your code in your **python_intro.py** file to this:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 3 > 2:
+    print('It works!')
+```
+
+Notice how we've indented the next line of code by 4 spaces? We need to do this so Python knows what code to run if the result is true. You can do one space, but nearly all Python programmers do 4 to make things look neat. A single Tab will also count as 4 spaces as long as your text editor is set to do so. When you made your choice, don't change it! If you already indented with 4 spaces, make any future indentation with 4 spaces, too - otherwise you may run into problems.
+
+Save it and give it another run:
+
+{% filename %}command-line{% endfilename %}
+
+```python
+$ python3 python_intro.py
+It works!
+```
+
+Note: Remember that on Windows, 'python3' is not recognized as a command. From now on, replace 'python3' with 'python' to execute the file.
+
+### 什麼情況下一個條件式不是真的？
+
+In previous examples, code was executed only when the conditions were True. But Python also has `elif` and `else` statements:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+if 5 > 2:
+    print('5 is indeed greater than 2')
+else:
+    print('5 is not greater than 2')
+```
+
+When this is run it will print out:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    5 is indeed greater than 2
+    
+
+If 2 were a greater number than 5, then the second command would be executed. Let's see how `elif` works:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+name = 'Sonja'
+if name == 'Ola':
+    print('Hey Ola!')
+elif name == 'Sonja':
+    print('Hey Sonja!')
+else:
+    print('Hey anonymous!')
+```
+
+and executed:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hey Sonja!
+    
+
+See what happened there? `elif` lets you add extra conditions that run if the previous conditions fail.
+
+You can add as many `elif` statements as you like after your initial `if` statement. For example:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+volume = 57
+if volume < 20:
+    print("It's kinda quiet.")
+elif 20 <= volume < 40:
+    print("It's nice for background music")
+elif 40 <= volume < 60:
+    print("Perfect, I can hear all the details")
+elif 60 <= volume < 80:
+    print("Nice for parties")
+elif 80 <= volume < 100:
+    print("A bit loud!")
+else:
+    print("My ears are hurting! :(")
+```
+
+Python runs through each test in sequence and prints:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Perfect, I can hear all the details
+    
+
+## Comments
+
+Comments are lines beginning with `#`. You can write whatever you want after the `#` and Python will ignore it. Comments can make your code easier for other people to understand.
+
+Let's see how that looks:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+# Change the volume if it's too loud or too quiet
+if volume < 20 or volume > 80:
+    volume = 50
+    print("That's better!")
+```
+
+You don't need to write a comment for every line of code, but they are useful for explaining why your code is doing something, or providing a summary when it's doing something complex.
+
+### 彙總
+
+In the last few exercises you learned about:
+
+- **comparing things** – in Python you can compare things by using `>`, `>=`, `==`, `<=`, `<` and the `and`, `or` operators
+- **Boolean** – a type of object that can only have one of two values: `True` or `False`
+- **Saving files** – storing code in files so you can execute larger programs.
+- **if … elif … else** – statements that allow you to execute code only when certain conditions are met.
+- **comments** - lines that Python won't run which let you document your code
+
+Time for the last part of this chapter!
+
+## 你自己的函數！(Your own functions!)
+
+> For readers at home: this part is covered in the [Python Basics: Functions](https://www.youtube.com/watch?v=5owr-6suOl0) video.
+
+Remember functions like `len()` that you can execute in Python? Well, good news – you will learn how to write your own functions now!
+
+A function is a sequence of instructions that Python should execute. Each function in Python starts with the keyword `def`, is given a name, and can have some parameters. Let's give it a go. Replace the code in **python_intro.py** with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi():
+    print('Hi there!')
+    print('How are you?')
+
+hi()
+```
+
+Okay, our first function is ready!
+
+You may wonder why we've written the name of the function at the bottom of the file. When we write `def hi():` and the indented lines following, this is us writing instructions for what the `hi()` function should do. Python will read and remember these instructions, but won't run the function yet. To tell Python we want to run the function, we have to call the function with `hi()`. Python reads the file and executes it from top to bottom, so we have to define the function in the file before we call it.
+
+Let's run this now and see what happens:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi there!
+    How are you?
+    
+
+Note: if it didn't work, don't panic! The output will help you to figure why:
+
+- If you get a `NameError`, that probably means you typed something wrong, so you should check that you used the same name when creating the function with `def hi():` and when calling it with `hi()`.
+- If you get an `IndentationError`, check that both of the `print` lines have the same whitespace at the start of a line: python wants all the code inside the function to be neatly aligned.
+- If there's no output at all, check that the last `hi()` *isn't* indented - if it is, that line will become part of the function too, and it will never get run.
+
+Let's build our first function with parameters. We will change the previous example – a function that says 'hi' to the person running it – with a name:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+```
+
+As you can see, we now gave our function a parameter that we called `name`:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    if name == 'Ola':
+        print('Hi Ola!')
+    elif name == 'Sonja':
+        print('Hi Sonja!')
+    else:
+        print('Hi anonymous!')
+
+hi()
+```
+
+Remember: The `print` function is indented four spaces within the `if` statement. This is because the function runs when the condition is met. Let's see how it works now:
+
+{% filename %}{{ warning_icon }} command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Traceback (most recent call last):
+    File "python_intro.py", line 10, in <module>
+      hi()
+    TypeError: hi() missing 1 required positional argument: 'name'
+    
+
+Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function `hi()` (the one we defined) has one required argument (called `name`) and that we forgot to pass it when calling the function. Let's fix it at the bottom of the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Ola")
+```
+
+And run it again:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Ola!
+    
+
+And if we change the name?
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+hi("Sonja")
+```
+
+And run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Sonja!
+    
+
+Now, what do you think will happen if you write another name in there? (Not Ola or Sonja.) Give it a try and see if you're right. It should print out this:
+
+{% filename %}command-line{% endfilename %}
+
+    Hi anonymous!
+    
+
+This is awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the function is supposed to greet. And that's exactly why we need functions – you never want to repeat your code!
+
+Let's do something smarter – there are more names than two, and writing a condition for each would be hard, right? Replace the content of your file with the following:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+hi("Rachel")
+```
+
+Let's call the code now:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    
+
+Congratulations! You just learned how to write functions! :)
+
+## 迴圈 (Loops)
+
+> For readers at home: this part is covered in the [Python Basics: For Loop](https://www.youtube.com/watch?v=aEA6Rc86HF0) video.
+
+This is the last part already. That was quick, right? :)
+
+Programmers don't like to repeat themselves. Programming is all about automating things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
+
+Still remember lists? Let's do a list of girls:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+```
+
+We want to greet all of them by their name. We have the `hi` function to do that, so let's use it in a loop:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for name in girls:
+```
+
+The `for` statement behaves similarly to the `if` statement; code below both of these need to be indented four spaces.
+
+Here is the full code that will be in the file:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+def hi(name):
+    print('Hi ' + name + '!')
+
+girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
+for name in girls:
+    hi(name)
+    print('Next girl')
+```
+
+And when we run it:
+
+{% filename %}command-line{% endfilename %}
+
+    $ python3 python_intro.py
+    Hi Rachel!
+    Next girl
+    Hi Monica!
+    Next girl
+    Hi Phoebe!
+    Next girl
+    Hi Ola!
+    Next girl
+    Hi You!
+    Next girl
+    
+
+As you can see, everything you put inside a `for` statement with an indent will be repeated for every element of the list `girls`.
+
+You can also use `for` on numbers using the `range` function:
+
+{% filename %}python_intro.py{% endfilename %}
+
+```python
+for i in range(1, 6):
+    print(i)
+```
+
+Which would print:
+
+{% filename %}command-line{% endfilename %}
+
+    1
+    2
+    3
+    4
+    5
+    
+
+`range` is a function that creates a list of numbers following one after the other (these numbers are provided by you as parameters).
+
+Note that the second of these two numbers is not included in the list that is output by Python (meaning `range(1, 6)` counts from 1 to 5, but does not include the number 6). That is because "range" is half-open, and by that we mean it includes the first value, but not the last.
+
+## 彙總
+
+That's it. **You totally rock!** This was a tricky chapter, so you should feel proud of yourself. We're definitely proud of you for making it this far!
+
+For official and full python tutorial visit https://docs.python.org/3/tutorial/. This will give you a more thorough and complete study of the language. Cheers! :)
+
+You might want to briefly do something else – stretch, walk around for a bit, rest your eyes – before going on to the next chapter. :)
+
+![Cupcake](images/cupcake.png)
\ No newline at end of file
diff --git a/zh-TW/signup_pythonanywhere.md b/zh-TW/signup_pythonanywhere.md
new file mode 100644
index 00000000000..66b0ffcac05
--- /dev/null
+++ b/zh-TW/signup_pythonanywhere.md
@@ -0,0 +1,5 @@
+Next it's time to sign up for a free "Beginner" account on PythonAnywhere.
+
+* [www.pythonanywhere.com](https://www.pythonanywhere.com/)
+
+> **Note** When choosing your username here, bear in mind that your blog's URL will take the form `yourusername.pythonanywhere.com`, so choose either your own nickname, or a name for what your blog is all about.
\ No newline at end of file
diff --git a/zh-TW/template_extending/README.md b/zh-TW/template_extending/README.md
new file mode 100644
index 00000000000..8389086c70d
--- /dev/null
+++ b/zh-TW/template_extending/README.md
@@ -0,0 +1,151 @@
+# 範本擴展 (Template extending)
+
+Django 提供給你的另一件不錯的事是 **範本擴展 (template extending)**。這是什麼意思？這意味著你可以將相同部分的 html 程式碼用在你網站的不同網頁上。
+
+Templates help when you want to use the same information or layout in more than one place. You don't have to repeat yourself in every file. And if you want to change something, you don't have to do it in every template, just one!
+
+## Create a base template
+
+基礎範本是最基本的範本，你擴展它到你網站的每一個網頁上。
+
+讓我們在 `blog/templates/blog/` 建立一個 `base.html `檔:
+
+    blog
+    └───templates
+        └───blog
+                base.html
+                post_list.html
+    
+
+Then open it up in the code editor and copy everything from `post_list.html` to `base.html` file, like this:
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% load static %}
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Django Girls blog</title>
+        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css" integrity="sha384-TX8t27EcRE3e/ihU7zmQxVncDAy5uIKz4rEkgIXeMed4M0jlfIDPvg6uqKI2xXr2" crossorigin="anonymous">
+        <link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
+        <link rel="stylesheet" href="{% static 'css/blog.css' %}">
+    </head>
+    <body>
+        <header class="page-header">
+          <div class="container">
+              <h1><a href="/">Django Girls Blog</a></h1>
+          </div>
+        </header>
+
+        <main class="container">
+            <div class="row">
+                <div class="col">
+                {% for post in posts %}
+                    <article class="post">
+                        <time class="date">
+                            {{ post.published_date }}
+                        </time>
+                        <h2><a href="">{{ post.title }}</a></h2>
+                        <p>{{ post.text|linebreaksbr }}</p>
+                    </article>
+                {% endfor %}
+                </div>
+            </div>
+        </main>
+    </body>
+</html>
+```
+
+然後在 `base.html`，把你整個 `<body>` 內容（任何在 `<body>` 和 `</body>` 之間的東西） 替換成這些︰
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+<body>
+    <header class="page-header">
+      <div class="container">
+          <h1><a href="/">Django Girls Blog</a></h1>
+      </div>
+    </header>
+    <main class="container">
+        <div class="row">
+            <div class="col">
+            {% block content %}
+            {% endblock %}
+            </div>
+        </div>
+    </main>
+</body>
+```
+
+{% raw %}You might notice this replaced everything from `{% for post in posts %}` to `{% endfor %}` with: {% endraw %}
+
+{% filename %}blog/templates/blog/base.html{% endfilename %}
+
+```html
+{% block content %}
+{% endblock %}
+```
+
+But why? You just created a `block`! You used the template tag `{% block %}` to make an area that will have HTML inserted in it. That HTML will come from another template that extends this template (`base.html`). 我們將立刻告訴你如何使用它。
+
+Now save `base.html` and open your `blog/templates/blog/post_list.html` again in the code editor. {% raw %}You're going to remove everything above `{% for post in posts %}` and below `{% endfor %}`. When you're done, the file will look like this:{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% for post in posts %}
+    <article class="post">
+        <time class="date">
+            {{ post.published_date }}
+        </time>
+        <h2><a href="">{{ post.title }}</a></h2>
+        <p>{{ post.text|linebreaksbr }}</p>
+    </article>
+{% endfor %}
+```
+
+We want to use this as part of our template for all the content blocks. Time to add block tags to this file!
+
+{% raw %}You want your block tag to match the tag in your `base.html` file. You also want it to include all the code that belongs in your content blocks. To do that, put everything between `{% block content %}` and `{% endblock %}`. 像這樣︰{% endraw %}
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+Only one thing left. We need to connect these two templates together. This is what extending templates is all about! We'll do this by adding an extends tag to the beginning of the file. Like this:
+
+{% filename %}blog/templates/blog/post_list.html{% endfilename %}
+
+```html
+{% extends 'blog/base.html' %}
+
+{% block content %}
+    {% for post in posts %}
+        <article class="post">
+            <time class="date">
+                {{ post.published_date }}
+            </time>
+            <h2><a href="">{{ post.title }}</a></h2>
+            <p>{{ post.text|linebreaksbr }}</p>
+        </article>
+    {% endfor %}
+{% endblock %}
+```
+
+That's it! Save the file, and check if your website is still working properly. :)
+
+> If you get the error `TemplateDoesNotExist`, that means that there is no `blog/base.html` file and you have `runserver` running in the console. Try to stop it (by pressing Ctrl+C – the Control and C keys together) and restart it by running a `python manage.py runserver` command.
\ No newline at end of file
diff --git a/zh-TW/whats_next/README.md b/zh-TW/whats_next/README.md
new file mode 100644
index 00000000000..b796d59b3d4
--- /dev/null
+++ b/zh-TW/whats_next/README.md
@@ -0,0 +1,43 @@
+# 下一步是什麼?
+
+恭喜你自己！**你太棒了**，我們很自豪! <3
+
+### 現在要做什麼？
+
+Take a break and relax! You have just done something really huge.
+
+After that, make sure to follow Django Girls on [Facebook](http://facebook.com/djangogirls) or [Twitter](https://twitter.com/djangogirls) to stay up to date.
+
+### 你能推薦任何進階的資源嗎？
+
+Yes! There are a *lot* of resources online for learning all kinds of programming skills – it can be pretty daunting to work out where to go next, but we've got you covered. Whatever your interests were before you came to Django Girls, and whatever interests you've developed throughout the tutorial, here are some free resources (or resources with large free components) you can use to get to where you want to be.
+
+#### Django
+
+- Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/2.2/intro/tutorial01/)
+- [Getting Started With Django video lessons](http://www.gettingstartedwithdjango.com/)
+- [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+
+#### HTML, CSS and JavaScript
+
+- [Codecademy's web development course](https://www.codecademy.com/learn/paths/web-development)
+- [freeCodeCamp](https://www.freecodecamp.org/)
+
+#### Python
+
+- [Codecademy's Python course](https://www.codecademy.com/learn/learn-python)
+- [Google's Python course](https://developers.google.com/edu/python/)
+- [Learn Python The Hard Way book](http://learnpythonthehardway.org/book/) – the initial exercises are free
+- [New Coder tutorials](http://newcoder.io/tutorials/) – this is a variety of practical examples of how you might use Python
+- [edX](https://www.edx.org/course?search_query=python) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Coursera's Python specialization](https://www.coursera.org/specializations/python) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
+- [Python for Everybody](https://www.py4e.com/) - a free and open version of the Coursera Python for Everybody specialization
+
+#### Working with data
+
+- [Codecademy's data science course](https://www.codecademy.com/learn/paths/data-science)
+- [edX](https://www.edx.org/course/?search_query=python&subject=Data%20Analysis%20%26%20Statistics) – you can audit most courses for free, but if you want a certificate or credits towards a higher education qualification then that will cost money
+- [Dataquest](https://www.dataquest.io/) – the first 30 "missions" are free
+
+We can't wait to see what you build next!
\ No newline at end of file